new sources

diff --git a/.bzr/README b/.bzr/README
new file mode 100644 (file)
index 0000000..4f8e767
--- /dev/null
+++ b/.bzr/README
@@ -0,0 +1,3 @@
+This is a Bazaar control directory.
+Do not change any files in this directory.
+See http://bazaar-vcs.org/ for more information about Bazaar.

diff --git a/.bzr/branch-format b/.bzr/branch-format
new file mode 100644 (file)
index 0000000..9eb09b7
--- /dev/null
+++ b/.bzr/branch-format
@@ -0,0 +1 @@
+Bazaar-NG meta directory, format 1

diff --git a/.bzr/branch/format b/.bzr/branch/format
new file mode 100644 (file)
index 0000000..b391ffd
--- /dev/null
+++ b/.bzr/branch/format
@@ -0,0 +1 @@
+Bazaar-NG Branch Reference Format 1

diff --git a/.bzr/branch/location b/.bzr/branch/location
new file mode 100644 (file)
index 0000000..08e8a1d
--- /dev/null
+++ b/.bzr/branch/location
@@ -0,0 +1 @@
+bzr://bzr.mozilla.org/bugzilla/4.4/
\ No newline at end of file

diff --git a/.bzr/checkout/conflicts b/.bzr/checkout/conflicts
new file mode 100644 (file)
index 0000000..0dc2d3a
--- /dev/null
+++ b/.bzr/checkout/conflicts
@@ -0,0 +1 @@
+BZR conflict list format 1

diff --git a/.bzr/checkout/dirstate b/.bzr/checkout/dirstate
new file mode 100644 (file)
index 0000000..083566e
Binary files /dev/null and b/.bzr/checkout/dirstate differ

diff --git a/.bzr/checkout/format b/.bzr/checkout/format
new file mode 100644 (file)
index 0000000..e0261c7
--- /dev/null
+++ b/.bzr/checkout/format
@@ -0,0 +1 @@
+Bazaar Working Tree Format 6 (bzr 1.14)

diff --git a/.bzr/checkout/views b/.bzr/checkout/views
new file mode 100644 (file)
index 0000000..e69de29

diff --git a/.bzrignore b/.bzrignore
new file mode 100644 (file)
index 0000000..7ab83e7
--- /dev/null
+++ b/.bzrignore
@@ -0,0 +1,32 @@
+.htaccess
+/lib/*
+/template/en/custom
+/docs/bugzilla.ent
+/docs/en/xml/bugzilla.ent
+/docs/en/txt
+/docs/en/html
+/docs/en/pdf
+/skins/custom
+/graphs
+/data
+/localconfig
+/index.html
+
+/skins/contrib/Dusk/IE-fixes.css
+/skins/contrib/Dusk/admin.css
+/skins/contrib/Dusk/attachment.css
+/skins/contrib/Dusk/create_attachment.css
+/skins/contrib/Dusk/dependency-tree.css
+/skins/contrib/Dusk/duplicates.css
+/skins/contrib/Dusk/editusers.css
+/skins/contrib/Dusk/enter_bug.css
+/skins/contrib/Dusk/help.css
+/skins/contrib/Dusk/panel.css
+/skins/contrib/Dusk/page.css
+/skins/contrib/Dusk/params.css
+/skins/contrib/Dusk/reports.css
+/skins/contrib/Dusk/show_bug.css
+/skins/contrib/Dusk/search_form.css
+/skins/contrib/Dusk/show_multiple.css
+/skins/contrib/Dusk/summarize-time.css
+.DS_Store

diff --git a/.htaccess b/.htaccess
new file mode 100644 (file)
index 0000000..3b464a4
--- /dev/null
+++ b/.htaccess
@@ -0,0 +1,28 @@
+# Don't allow people to retrieve non-cgi executable files or our private data
+<FilesMatch (\.pm|\.pl|\.tmpl|localconfig.*)$>
+  deny from all
+</FilesMatch>
+
+Options -Indexes
+
+<IfModule mod_expires.c>
+<IfModule mod_headers.c>
+<IfModule mod_env.c>
+  <FilesMatch (\.js|\.css)$>
+    ExpiresActive On
+    # According to RFC 2616, "1 year in the future" means "never expire".
+    # We change the name of the file's URL whenever its modification date
+    # changes, so browsers can cache any individual JS or CSS URL forever.
+    # However, since all JS and CSS URLs involve a ? in them (for the changing
+    # name) we have to explicitly set an Expires header or browsers won't
+    # *ever* cache them.
+    ExpiresDefault "now plus 1 years"
+    Header append Cache-Control "public"
+  </FilesMatch>
+
+  # This lets Bugzilla know that we are properly sending Cache-Control
+  # and Expires headers for CSS and JS files.
+  SetEnv BZ_CACHE_CONTROL 1
+</IfModule>
+</IfModule>
+</IfModule>

diff --git a/Bugzilla.pm b/Bugzilla.pm
new file mode 100644 (file)
index 0000000..9fffc35
--- /dev/null
+++ b/Bugzilla.pm
@@ -0,0 +1,977 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla;
+
+use strict;
+
+# We want any compile errors to get to the browser, if possible.
+BEGIN {
+    # This makes sure we're in a CGI.
+    if ($ENV{SERVER_SOFTWARE} && !$ENV{MOD_PERL}) {
+        require CGI::Carp;
+        CGI::Carp->import('fatalsToBrowser');
+    }
+}
+
+use Bugzilla::Config;
+use Bugzilla::Constants;
+use Bugzilla::Auth;
+use Bugzilla::Auth::Persist::Cookie;
+use Bugzilla::CGI;
+use Bugzilla::Extension;
+use Bugzilla::DB;
+use Bugzilla::Install::Localconfig qw(read_localconfig);
+use Bugzilla::Install::Requirements qw(OPTIONAL_MODULES);
+use Bugzilla::Install::Util qw(init_console include_languages);
+use Bugzilla::Template;
+use Bugzilla::User;
+use Bugzilla::Error;
+use Bugzilla::Util;
+use Bugzilla::Field;
+use Bugzilla::Flag;
+use Bugzilla::Token;
+
+use File::Basename;
+use File::Spec::Functions;
+use DateTime::TimeZone;
+use Date::Parse;
+use Safe;
+
+#####################################################################
+# Constants
+#####################################################################
+
+# Scripts that are not stopped by shutdownhtml being in effect.
+use constant SHUTDOWNHTML_EXEMPT => qw(
+    editparams.cgi
+    checksetup.pl
+    migrate.pl
+    recode.pl
+);
+
+# Non-cgi scripts that should silently exit.
+use constant SHUTDOWNHTML_EXIT_SILENTLY => qw(
+    whine.pl
+);
+
+# shutdownhtml pages are sent as an HTTP 503. After how many seconds
+# should search engines attempt to index the page again?
+use constant SHUTDOWNHTML_RETRY_AFTER => 3600;
+
+#####################################################################
+# Global Code
+#####################################################################
+
+# $::SIG{__DIE__} = i_am_cgi() ? \&CGI::Carp::confess : \&Carp::confess;
+
+# Note that this is a raw subroutine, not a method, so $class isn't available.
+sub init_page {
+    if (Bugzilla->usage_mode == USAGE_MODE_CMDLINE) {
+        init_console();
+    }
+    elsif (Bugzilla->params->{'utf8'}) {
+        binmode STDOUT, ':utf8';
+    }
+
+    if (${^TAINT}) {
+        # Some environment variables are not taint safe
+        delete @::ENV{'PATH', 'IFS', 'CDPATH', 'ENV', 'BASH_ENV'};
+        # Some modules throw undefined errors (notably File::Spec::Win32) if
+        # PATH is undefined.
+        $ENV{'PATH'} = '';
+    }
+
+    # Because this function is run live from perl "use" commands of
+    # other scripts, we're skipping the rest of this function if we get here
+    # during a perl syntax check (perl -c, like we do during the
+    # 001compile.t test).
+    return if $^C;
+
+    # IIS prints out warnings to the webpage, so ignore them, or log them
+    # to a file if the file exists.
+    if ($ENV{SERVER_SOFTWARE} && $ENV{SERVER_SOFTWARE} =~ /microsoft-iis/i) {
+        $SIG{__WARN__} = sub {
+            my ($msg) = @_;
+            my $datadir = bz_locations()->{'datadir'};
+            if (-w "$datadir/errorlog") {
+                my $warning_log = new IO::File(">>$datadir/errorlog");
+                print $warning_log $msg;
+                $warning_log->close();
+            }
+        };
+    }
+
+    my $script = basename($0);
+
+    # Because of attachment_base, attachment.cgi handles this itself.
+    if ($script ne 'attachment.cgi') {
+        do_ssl_redirect_if_required();
+    }
+
+    # If Bugzilla is shut down, do not allow anything to run, just display a
+    # message to the user about the downtime and log out.  Scripts listed in 
+    # SHUTDOWNHTML_EXEMPT are exempt from this message.
+    #
+    # This code must go here. It cannot go anywhere in Bugzilla::CGI, because
+    # it uses Template, and that causes various dependency loops.
+    if (Bugzilla->params->{"shutdownhtml"}
+        && !grep { $_ eq $script } SHUTDOWNHTML_EXEMPT)
+    {
+        # Allow non-cgi scripts to exit silently (without displaying any
+        # message), if desired. At this point, no DBI call has been made
+        # yet, and no error will be returned if the DB is inaccessible.
+        if (!i_am_cgi()
+            && grep { $_ eq $script } SHUTDOWNHTML_EXIT_SILENTLY)
+        {
+            exit;
+        }
+
+        # For security reasons, log out users when Bugzilla is down.
+        # Bugzilla->login() is required to catch the logincookie, if any.
+        my $user;
+        eval { $user = Bugzilla->login(LOGIN_OPTIONAL); };
+        if ($@) {
+            # The DB is not accessible. Use the default user object.
+            $user = Bugzilla->user;
+            $user->{settings} = {};
+        }
+        my $userid = $user->id;
+        Bugzilla->logout();
+
+        my $template = Bugzilla->template;
+        my $vars = {};
+        $vars->{'message'} = 'shutdown';
+        $vars->{'userid'} = $userid;
+        # Generate and return a message about the downtime, appropriately
+        # for if we're a command-line script or a CGI script.
+        my $extension;
+        if (i_am_cgi() && (!Bugzilla->cgi->param('ctype')
+                           || Bugzilla->cgi->param('ctype') eq 'html')) {
+            $extension = 'html';
+        }
+        else {
+            $extension = 'txt';
+        }
+        if (i_am_cgi()) {
+            # Set the HTTP status to 503 when Bugzilla is down to avoid pages
+            # being indexed by search engines.
+            print Bugzilla->cgi->header(-status => 503, 
+                -retry_after => SHUTDOWNHTML_RETRY_AFTER);
+        }
+        my $t_output;
+        $template->process("global/message.$extension.tmpl", $vars, \$t_output)
+            || ThrowTemplateError($template->error);
+        print $t_output . "\n";
+        exit;
+    }
+}
+
+#####################################################################
+# Subroutines and Methods
+#####################################################################
+
+sub template {
+    my $class = shift;
+    $class->request_cache->{template} ||= Bugzilla::Template->create();
+    return $class->request_cache->{template};
+}
+
+sub template_inner {
+    my ($class, $lang) = @_;
+    my $cache = $class->request_cache;
+    my $current_lang = $cache->{template_current_lang}->[0];
+    $lang ||= $current_lang || '';
+    $class->request_cache->{"template_inner_$lang"}
+        ||= Bugzilla::Template->create(language => $lang);
+    return $class->request_cache->{"template_inner_$lang"};
+}
+
+our $extension_packages;
+sub extensions {
+    my ($class) = @_;
+    my $cache = $class->request_cache;
+    if (!$cache->{extensions}) {
+        # Under mod_perl, mod_perl.pl populates $extension_packages for us.
+        if (!$extension_packages) {
+            $extension_packages = Bugzilla::Extension->load_all();
+        }
+        my @extensions;
+        foreach my $package (@$extension_packages) {
+            my $extension = $package->new();
+            if ($extension->enabled) {
+                push(@extensions, $extension);
+            }        
+        }
+        $cache->{extensions} = \@extensions;
+    }
+    return $cache->{extensions};
+}
+
+sub feature {
+    my ($class, $feature) = @_;
+    my $cache = $class->request_cache;
+    return $cache->{feature}->{$feature}
+        if exists $cache->{feature}->{$feature};
+
+    my $feature_map = $cache->{feature_map};
+    if (!$feature_map) {
+        foreach my $package (@{ OPTIONAL_MODULES() }) {
+            foreach my $f (@{ $package->{feature} }) {
+                $feature_map->{$f} ||= [];
+                push(@{ $feature_map->{$f} }, $package->{module});
+            }
+        }
+        $cache->{feature_map} = $feature_map;
+    }
+
+    if (!$feature_map->{$feature}) {
+        ThrowCodeError('invalid_feature', { feature => $feature });
+    }
+
+    my $success = 1;
+    foreach my $module (@{ $feature_map->{$feature} }) {
+        # We can't use a string eval and "use" here (it kills Template-Toolkit,
+        # see https://rt.cpan.org/Public/Bug/Display.html?id=47929), so we have
+        # to do a block eval.
+        $module =~ s{::}{/}g;
+        $module .= ".pm";
+        eval { require $module; 1; } or $success = 0;
+    }
+    $cache->{feature}->{$feature} = $success;
+    return $success;
+}
+
+sub cgi {
+    my $class = shift;
+    $class->request_cache->{cgi} ||= new Bugzilla::CGI();
+    return $class->request_cache->{cgi};
+}
+
+sub input_params {
+    my ($class, $params) = @_;
+    my $cache = $class->request_cache;
+    # This is how the WebService and other places set input_params.
+    if (defined $params) {
+        $cache->{input_params} = $params;
+    }
+    return $cache->{input_params} if defined $cache->{input_params};
+
+    # Making this scalar makes it a tied hash to the internals of $cgi,
+    # so if a variable is changed, then it actually changes the $cgi object
+    # as well.
+    $cache->{input_params} = $class->cgi->Vars;
+    return $cache->{input_params};
+}
+
+sub localconfig {
+    return $_[0]->process_cache->{localconfig} ||= read_localconfig();
+}
+
+sub params {
+    my $class = shift;
+    $class->request_cache->{params} ||= Bugzilla::Config::read_param_file();
+    return $class->request_cache->{params};
+}
+
+sub user {
+    my $class = shift;
+    $class->request_cache->{user} ||= new Bugzilla::User;
+    return $class->request_cache->{user};
+}
+
+sub set_user {
+    my ($class, $user) = @_;
+    $class->request_cache->{user} = $user;
+}
+
+sub sudoer {
+    my $class = shift;    
+    return $class->request_cache->{sudoer};
+}
+
+sub sudo_request {
+    my ($class, $new_user, $new_sudoer) = @_;
+    $class->request_cache->{user}   = $new_user;
+    $class->request_cache->{sudoer} = $new_sudoer;
+    # NOTE: If you want to log the start of an sudo session, do it here.
+}
+
+sub page_requires_login {
+    return $_[0]->request_cache->{page_requires_login};
+}
+
+sub login {
+    my ($class, $type) = @_;
+
+    return $class->user if $class->user->id;
+
+    my $authorizer = new Bugzilla::Auth();
+    $type = LOGIN_REQUIRED if $class->cgi->param('GoAheadAndLogIn');
+
+    if (!defined $type || $type == LOGIN_NORMAL) {
+        $type = $class->params->{'requirelogin'} ? LOGIN_REQUIRED : LOGIN_NORMAL;
+    }
+
+    # Allow templates to know that we're in a page that always requires
+    # login.
+    if ($type == LOGIN_REQUIRED) {
+        $class->request_cache->{page_requires_login} = 1;
+    }
+
+    my $authenticated_user = $authorizer->login($type);
+    
+    # At this point, we now know if a real person is logged in.
+    # We must now check to see if an sudo session is in progress.
+    # For a session to be in progress, the following must be true:
+    # 1: There must be a logged in user
+    # 2: That user must be in the 'bz_sudoer' group
+    # 3: There must be a valid value in the 'sudo' cookie
+    # 4: A Bugzilla::User object must exist for the given cookie value
+    # 5: That user must NOT be in the 'bz_sudo_protect' group
+    my $token = $class->cgi->cookie('sudo');
+    if (defined $authenticated_user && $token) {
+        my ($user_id, $date, $sudo_target_id) = Bugzilla::Token::GetTokenData($token);
+        if (!$user_id
+            || $user_id != $authenticated_user->id
+            || !detaint_natural($sudo_target_id)
+            || (time() - str2time($date) > MAX_SUDO_TOKEN_AGE))
+        {
+            $class->cgi->remove_cookie('sudo');
+            ThrowUserError('sudo_invalid_cookie');
+        }
+
+        my $sudo_target = new Bugzilla::User($sudo_target_id);
+        if ($authenticated_user->in_group('bz_sudoers')
+            && defined $sudo_target
+            && !$sudo_target->in_group('bz_sudo_protect'))
+        {
+            $class->set_user($sudo_target);
+            $class->request_cache->{sudoer} = $authenticated_user;
+            # And make sure that both users have the same Auth object,
+            # since we never call Auth::login for the sudo target.
+            $sudo_target->set_authorizer($authenticated_user->authorizer);
+
+            # NOTE: If you want to do any special logging, do it here.
+        }
+        else {
+            delete_token($token);
+            $class->cgi->remove_cookie('sudo');
+            ThrowUserError('sudo_illegal_action', { sudoer => $authenticated_user,
+                                                    target_user => $sudo_target });
+        }
+    }
+    else {
+        $class->set_user($authenticated_user);
+    }
+
+    if ($class->sudoer) {
+        $class->sudoer->update_last_seen_date();
+    } else {
+        $class->user->update_last_seen_date();
+    }
+
+    return $class->user;
+}
+
+sub logout {
+    my ($class, $option) = @_;
+
+    # If we're not logged in, go away
+    return unless $class->user->id;
+
+    $option = LOGOUT_CURRENT unless defined $option;
+    Bugzilla::Auth::Persist::Cookie->logout({type => $option});
+    $class->logout_request() unless $option eq LOGOUT_KEEP_CURRENT;
+}
+
+sub logout_user {
+    my ($class, $user) = @_;
+    # When we're logging out another user we leave cookies alone, and
+    # therefore avoid calling Bugzilla->logout() directly.
+    Bugzilla::Auth::Persist::Cookie->logout({user => $user});
+}
+
+# just a compatibility front-end to logout_user that gets a user by id
+sub logout_user_by_id {
+    my ($class, $id) = @_;
+    my $user = new Bugzilla::User($id);
+    $class->logout_user($user);
+}
+
+# hack that invalidates credentials for a single request
+sub logout_request {
+    my $class = shift;
+    delete $class->request_cache->{user};
+    delete $class->request_cache->{sudoer};
+    # We can't delete from $cgi->cookie, so logincookie data will remain
+    # there. Don't rely on it: use Bugzilla->user->login instead!
+}
+
+sub job_queue {
+    my $class = shift;
+    require Bugzilla::JobQueue;
+    $class->request_cache->{job_queue} ||= Bugzilla::JobQueue->new();
+    return $class->request_cache->{job_queue};
+}
+
+sub dbh {
+    my $class = shift;
+    # If we're not connected, then we must want the main db
+    $class->request_cache->{dbh} ||= $class->dbh_main;
+
+    return $class->request_cache->{dbh};
+}
+
+sub dbh_main {
+    my $class = shift;
+    $class->request_cache->{dbh_main} ||= Bugzilla::DB::connect_main();
+    return $class->request_cache->{dbh_main};
+}
+
+sub languages {
+    my $class = shift;
+    return Bugzilla::Install::Util::supported_languages();
+}
+
+sub current_language {
+    return $_[0]->request_cache->{current_language} ||= (include_languages())[0];
+}
+
+sub error_mode {
+    my ($class, $newval) = @_;
+    if (defined $newval) {
+        $class->request_cache->{error_mode} = $newval;
+    }
+
+    # XXX - Once we require Perl 5.10.1, this test can be replaced by //.
+    if (exists $class->request_cache->{error_mode}) {
+        return $class->request_cache->{error_mode};
+    }
+    else {
+        return (i_am_cgi() ? ERROR_MODE_WEBPAGE : ERROR_MODE_DIE);
+    }
+}
+
+# This is used only by Bugzilla::Error to throw errors.
+sub _json_server {
+    my ($class, $newval) = @_;
+    if (defined $newval) {
+        $class->request_cache->{_json_server} = $newval;
+    }
+    return $class->request_cache->{_json_server};
+}
+
+sub usage_mode {
+    my ($class, $newval) = @_;
+    if (defined $newval) {
+        if ($newval == USAGE_MODE_BROWSER) {
+            $class->error_mode(ERROR_MODE_WEBPAGE);
+        }
+        elsif ($newval == USAGE_MODE_CMDLINE) {
+            $class->error_mode(ERROR_MODE_DIE);
+        }
+        elsif ($newval == USAGE_MODE_XMLRPC) {
+            $class->error_mode(ERROR_MODE_DIE_SOAP_FAULT);
+        }
+        elsif ($newval == USAGE_MODE_JSON) {
+            $class->error_mode(ERROR_MODE_JSON_RPC);
+        }
+        elsif ($newval == USAGE_MODE_EMAIL) {
+            $class->error_mode(ERROR_MODE_DIE);
+        }
+        elsif ($newval == USAGE_MODE_TEST) {
+            $class->error_mode(ERROR_MODE_TEST);
+        }
+        else {
+            ThrowCodeError('usage_mode_invalid',
+                           {'invalid_usage_mode', $newval});
+        }
+        $class->request_cache->{usage_mode} = $newval;
+    }
+
+    # XXX - Once we require Perl 5.10.1, this test can be replaced by //.
+    if (exists $class->request_cache->{usage_mode}) {
+        return $class->request_cache->{usage_mode};
+    }
+    else {
+        return (i_am_cgi()? USAGE_MODE_BROWSER : USAGE_MODE_CMDLINE);
+    }
+}
+
+sub installation_mode {
+    my ($class, $newval) = @_;
+    ($class->request_cache->{installation_mode} = $newval) if defined $newval;
+    return $class->request_cache->{installation_mode}
+        || INSTALLATION_MODE_INTERACTIVE;
+}
+
+sub installation_answers {
+    my ($class, $filename) = @_;
+    if ($filename) {
+        my $s = new Safe;
+        $s->rdo($filename);
+
+        die "Error reading $filename: $!" if $!;
+        die "Error evaluating $filename: $@" if $@;
+
+        # Now read the param back out from the sandbox
+        $class->request_cache->{installation_answers} = $s->varglob('answer');
+    }
+    return $class->request_cache->{installation_answers} || {};
+}
+
+sub switch_to_shadow_db {
+    my $class = shift;
+
+    if (!$class->request_cache->{dbh_shadow}) {
+        if ($class->params->{'shadowdb'}) {
+            $class->request_cache->{dbh_shadow} = Bugzilla::DB::connect_shadow();
+        } else {
+            $class->request_cache->{dbh_shadow} = $class->dbh_main;
+        }
+    }
+
+    $class->request_cache->{dbh} = $class->request_cache->{dbh_shadow};
+    # we have to return $class->dbh instead of {dbh} as
+    # {dbh_shadow} may be undefined if no shadow DB is used
+    # and no connection to the main DB has been established yet.
+    return $class->dbh;
+}
+
+sub switch_to_main_db {
+    my $class = shift;
+
+    $class->request_cache->{dbh} = $class->dbh_main;
+    return $class->dbh_main;
+}
+
+sub fields {
+    my ($class, $criteria) = @_;
+    $criteria ||= {};
+    my $cache = $class->request_cache;
+
+    # We create an advanced cache for fields by type, so that we
+    # can avoid going back to the database for every fields() call.
+    # (And most of our fields() calls are for getting fields by type.)
+    #
+    # We also cache fields by name, because calling $field->name a few
+    # million times can be slow in calling code, but if we just do it
+    # once here, that makes things a lot faster for callers.
+    if (!defined $cache->{fields}) {
+        my @all_fields = Bugzilla::Field->get_all;
+        my (%by_name, %by_type);
+        foreach my $field (@all_fields) {
+            my $name = $field->name;
+            $by_type{$field->type}->{$name} = $field;
+            $by_name{$name} = $field;
+        }
+        $cache->{fields} = { by_type => \%by_type, by_name => \%by_name };
+    }
+
+    my $fields = $cache->{fields};
+    my %requested;
+    if (my $types = delete $criteria->{type}) {
+        $types = ref($types) ? $types : [$types];
+        %requested = map { %{ $fields->{by_type}->{$_} || {} } } @$types;
+    }
+    else {
+        %requested = %{ $fields->{by_name} };
+    }
+
+    my $do_by_name = delete $criteria->{by_name};
+
+    # Filtering before returning the fields based on
+    # the criterias.
+    foreach my $filter (keys %$criteria) {
+        foreach my $field (keys %requested) {
+            if ($requested{$field}->$filter != $criteria->{$filter}) {
+                delete $requested{$field};
+            }
+        }
+    }
+
+    return $do_by_name ? \%requested
+        : [sort { $a->sortkey <=> $b->sortkey || $a->name cmp $b->name } values %requested];
+}
+
+sub active_custom_fields {
+    my $class = shift;
+    if (!exists $class->request_cache->{active_custom_fields}) {
+        $class->request_cache->{active_custom_fields} =
+          Bugzilla::Field->match({ custom => 1, obsolete => 0 });
+    }
+    return @{$class->request_cache->{active_custom_fields}};
+}
+
+sub has_flags {
+    my $class = shift;
+
+    if (!defined $class->request_cache->{has_flags}) {
+        $class->request_cache->{has_flags} = Bugzilla::Flag->any_exist;
+    }
+    return $class->request_cache->{has_flags};
+}
+
+sub local_timezone {
+    my $class = shift;
+
+    if (!defined $class->process_cache->{local_timezone}) {
+        $class->process_cache->{local_timezone} =
+          DateTime::TimeZone->new(name => 'local');
+    }
+    return $class->process_cache->{local_timezone};
+}
+
+# This creates the request cache for non-mod_perl installations.
+# This is identical to Install::Util::_cache so that things loaded
+# into Install::Util::_cache during installation can be read out
+# of request_cache later in installation.
+our $_request_cache = $Bugzilla::Install::Util::_cache;
+
+sub request_cache {
+    if ($ENV{MOD_PERL}) {
+        require Apache2::RequestUtil;
+        # Sometimes (for example, during mod_perl.pl), the request
+        # object isn't available, and we should use $_request_cache instead.
+        my $request = eval { Apache2::RequestUtil->request };
+        return $_request_cache if !$request;
+        return $request->pnotes();
+    }
+    return $_request_cache;
+}
+
+sub clear_request_cache {
+    $_request_cache = {};
+    if ($ENV{MOD_PERL}) {
+        require Apache2::RequestUtil;
+        my $request = eval { Apache2::RequestUtil->request };
+        if ($request) {
+            my $pnotes = $request->pnotes;
+            delete @$pnotes{(keys %$pnotes)};
+        }
+    }
+}
+
+# This is a per-process cache.  Under mod_cgi it's identical to the
+# request_cache.  When using mod_perl, items in this cache live until the
+# worker process is terminated.
+our $_process_cache = {};
+
+sub process_cache {
+    return $_process_cache;
+}
+
+# Private methods
+
+# Per-process cleanup. Note that this is a plain subroutine, not a method,
+# so we don't have $class available.
+sub _cleanup {
+    my $main   = Bugzilla->request_cache->{dbh_main};
+    my $shadow = Bugzilla->request_cache->{dbh_shadow};
+    foreach my $dbh ($main, $shadow) {
+        next if !$dbh;
+        $dbh->bz_rollback_transaction() if $dbh->bz_in_transaction;
+        $dbh->disconnect;
+    }
+    clear_request_cache();
+
+    # These are both set by CGI.pm but need to be undone so that
+    # Apache can actually shut down its children if it needs to.
+    foreach my $signal (qw(TERM PIPE)) {
+        $SIG{$signal} = 'DEFAULT' if $SIG{$signal} && $SIG{$signal} eq 'IGNORE';
+    }
+}
+
+sub END {
+    # Bugzilla.pm cannot compile in mod_perl.pl if this runs.
+    _cleanup() unless $ENV{MOD_PERL};
+}
+
+init_page() if !$ENV{MOD_PERL};
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla - Semi-persistent collection of various objects used by scripts
+and modules
+
+=head1 SYNOPSIS
+
+  use Bugzilla;
+
+  sub someModulesSub {
+    Bugzilla->dbh->prepare(...);
+    Bugzilla->template->process(...);
+  }
+
+=head1 DESCRIPTION
+
+Several Bugzilla 'things' are used by a variety of modules and scripts. This
+includes database handles, template objects, and so on.
+
+This module is a singleton intended as a central place to store these objects.
+This approach has several advantages:
+
+=over 4
+
+=item *
+
+They're not global variables, so we don't have issues with them staying around
+with mod_perl
+
+=item *
+
+Everything is in one central place, so it's easy to access, modify, and maintain
+
+=item *
+
+Code in modules can get access to these objects without having to have them
+all passed from the caller, and the caller's caller, and....
+
+=item *
+
+We can reuse objects across requests using mod_perl where appropriate (eg
+templates), whilst destroying those which are only valid for a single request
+(such as the current user)
+
+=back
+
+Note that items accessible via this object are demand-loaded when requested.
+
+For something to be added to this object, it should either be able to benefit
+from persistence when run under mod_perl (such as the a C<template> object),
+or should be something which is globally required by a large ammount of code
+(such as the current C<user> object).
+
+=head1 METHODS
+
+Note that all C<Bugzilla> functionality is method based; use C<Bugzilla-E<gt>dbh>
+rather than C<Bugzilla::dbh>. Nothing cares about this now, but don't rely on
+that.
+
+=over 4
+
+=item C<template>
+
+The current C<Template> object, to be used for output
+
+=item C<template_inner>
+
+If you ever need a L<Bugzilla::Template> object while you're already
+processing a template, use this. Also use it if you want to specify
+the language to use. If no argument is passed, it uses the last
+language set. If the argument is "" (empty string), the language is
+reset to the current one (the one used by Bugzilla->template).
+
+=item C<cgi>
+
+The current C<cgi> object. Note that modules should B<not> be using this in
+general. Not all Bugzilla actions are cgi requests. Its useful as a convenience
+method for those scripts/templates which are only use via CGI, though.
+
+=item C<input_params>
+
+When running under the WebService, this is a hashref containing the arguments
+passed to the WebService method that was called. When running in a normal
+script, this is a hashref containing the contents of the CGI parameters.
+
+Modifying this hashref will modify the CGI parameters or the WebService
+arguments (depending on what C<input_params> currently represents).
+
+This should be used instead of L</cgi> in situations where your code
+could be being called by either a normal CGI script or a WebService method,
+such as during a code hook.
+
+B<Note:> When C<input_params> represents the CGI parameters, any
+parameter specified more than once (like C<foo=bar&foo=baz>) will appear
+as an arrayref in the hash, but any value specified only once will appear
+as a scalar. This means that even if a value I<can> appear multiple times,
+if it only I<does> appear once, then it will be a scalar in C<input_params>,
+not an arrayref.
+
+=item C<user>
+
+C<undef> if there is no currently logged in user or if the login code has not
+yet been run.  If an sudo session is in progress, the C<Bugzilla::User>
+corresponding to the person who is being impersonated.  If no session is in
+progress, the current C<Bugzilla::User>.
+
+=item C<set_user>
+
+Allows you to directly set what L</user> will return. You can use this
+if you want to bypass L</login> for some reason and directly "log in"
+a specific L<Bugzilla::User>. Be careful with it, though!
+
+=item C<sudoer>
+
+C<undef> if there is no currently logged in user, the currently logged in user
+is not in the I<sudoer> group, or there is no session in progress.  If an sudo
+session is in progress, returns the C<Bugzilla::User> object corresponding to
+the person who logged in and initiated the session.  If no session is in
+progress, returns the C<Bugzilla::User> object corresponding to the currently
+logged in user.
+
+=item C<sudo_request>
+This begins an sudo session for the current request.  It is meant to be 
+used when a session has just started.  For normal use, sudo access should 
+normally be set at login time.
+
+=item C<login>
+
+Logs in a user, returning a C<Bugzilla::User> object, or C<undef> if there is
+no logged in user. See L<Bugzilla::Auth|Bugzilla::Auth>, and
+L<Bugzilla::User|Bugzilla::User>.
+
+=item C<page_requires_login>
+
+If the current page always requires the user to log in (for example,
+C<enter_bug.cgi> or any page called with C<?GoAheadAndLogIn=1>) then
+this will return something true. Otherwise it will return false. (This is
+set when you call L</login>.)
+
+=item C<logout($option)>
+
+Logs out the current user, which involves invalidating user sessions and
+cookies. Three options are available from
+L<Bugzilla::Constants|Bugzilla::Constants>: LOGOUT_CURRENT (the
+default), LOGOUT_ALL or LOGOUT_KEEP_CURRENT.
+
+=item C<logout_user($user)>
+
+Logs out the specified user (invalidating all his sessions), taking a
+Bugzilla::User instance.
+
+=item C<logout_by_id($id)>
+
+Logs out the user with the id specified. This is a compatibility
+function to be used in callsites where there is only a userid and no
+Bugzilla::User instance.
+
+=item C<logout_request>
+
+Essentially, causes calls to C<Bugzilla-E<gt>user> to return C<undef>. This has the
+effect of logging out a user for the current request only; cookies and
+database sessions are left intact.
+
+=item C<fields>
+
+This is the standard way to get arrays or hashes of L<Bugzilla::Field>
+objects when you need them. It takes the following named arguments
+in a hashref:
+
+=over
+
+=item C<by_name>
+
+If false (or not specified), this method will return an arrayref of
+the requested fields.
+
+If true, this method will return a hashref of fields, where the keys
+are field names and the valules are L<Bugzilla::Field> objects.
+
+=item C<type>
+
+Either a single C<FIELD_TYPE_*> constant or an arrayref of them. If specified,
+the returned fields will be limited to the types in the list. If you don't
+specify this argument, all fields will be returned.
+
+=back
+
+=item C<error_mode>
+
+Call either C<Bugzilla->error_mode(Bugzilla::Constants::ERROR_MODE_DIE)>
+or C<Bugzilla->error_mode(Bugzilla::Constants::ERROR_MODE_DIE_SOAP_FAULT)> to
+change this flag's default of C<Bugzilla::Constants::ERROR_MODE_WEBPAGE> and to
+indicate that errors should be passed to error mode specific error handlers
+rather than being sent to a browser and finished with an exit().
+
+This is useful, for example, to keep C<eval> blocks from producing wild HTML
+on errors, making it easier for you to catch them.
+(Remember to reset the error mode to its previous value afterwards, though.)
+
+C<Bugzilla->error_mode> will return the current state of this flag.
+
+Note that C<Bugzilla->error_mode> is being called by C<Bugzilla->usage_mode> on
+usage mode changes.
+
+=item C<usage_mode>
+
+Call either C<Bugzilla->usage_mode(Bugzilla::Constants::USAGE_MODE_CMDLINE)>
+or C<Bugzilla->usage_mode(Bugzilla::Constants::USAGE_MODE_XMLRPC)> near the
+beginning of your script to change this flag's default of
+C<Bugzilla::Constants::USAGE_MODE_BROWSER> and to indicate that Bugzilla is
+being called in a non-interactive manner.
+
+This influences error handling because on usage mode changes, C<usage_mode>
+calls C<Bugzilla->error_mode> to set an error mode which makes sense for the
+usage mode.
+
+C<Bugzilla->usage_mode> will return the current state of this flag.
+
+=item C<installation_mode>
+
+Determines whether or not installation should be silent. See 
+L<Bugzilla::Constants> for the C<INSTALLATION_MODE> constants.
+
+=item C<installation_answers>
+
+Returns a hashref representing any "answers" file passed to F<checksetup.pl>,
+used to automatically answer or skip prompts.
+
+=item C<dbh>
+
+The current database handle. See L<DBI>.
+
+=item C<dbh_main>
+
+The main database handle. See L<DBI>.
+
+=item C<languages>
+
+Currently installed languages.
+Returns a reference to a list of RFC 1766 language tags of installed languages.
+
+=item C<current_language>
+
+The currently active language.
+
+=item C<switch_to_shadow_db>
+
+Switch from using the main database to using the shadow database.
+
+=item C<switch_to_main_db>
+
+Change the database object to refer to the main database.
+
+=item C<params>
+
+The current Parameters of Bugzilla, as a hashref. If C<data/params>
+does not exist, then we return an empty hashref. If C<data/params>
+is unreadable or is not valid perl, we C<die>.
+
+=item C<local_timezone>
+
+Returns the local timezone of the Bugzilla installation,
+as a DateTime::TimeZone object. This detection is very time
+consuming, so we cache this information for future references.
+
+=item C<job_queue>
+
+Returns a L<Bugzilla::JobQueue> that you can use for queueing jobs.
+Will throw an error if job queueing is not correctly configured on
+this Bugzilla installation.
+
+=item C<feature>
+
+Tells you whether or not a specific feature is enabled. For names
+of features, see C<OPTIONAL_MODULES> in C<Bugzilla::Install::Requirements>.
+
+=back

diff --git a/Bugzilla/Attachment.pm b/Bugzilla/Attachment.pm
new file mode 100644 (file)
index 0000000..380ef3d
--- /dev/null
+++ b/Bugzilla/Attachment.pm
@@ -0,0 +1,991 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+package Bugzilla::Attachment;
+
+=head1 NAME
+
+Bugzilla::Attachment - Bugzilla attachment class.
+
+=head1 SYNOPSIS
+
+  use Bugzilla::Attachment;
+
+  # Get the attachment with the given ID.
+  my $attachment = new Bugzilla::Attachment($attach_id);
+
+  # Get the attachments with the given IDs.
+  my $attachments = Bugzilla::Attachment->new_from_list($attach_ids);
+
+=head1 DESCRIPTION
+
+Attachment.pm represents an attachment object. It is an implementation
+of L<Bugzilla::Object>, and thus provides all methods that
+L<Bugzilla::Object> provides.
+
+The methods that are specific to C<Bugzilla::Attachment> are listed
+below.
+
+=cut
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Flag;
+use Bugzilla::User;
+use Bugzilla::Util;
+use Bugzilla::Field;
+use Bugzilla::Hook;
+
+use File::Copy;
+use List::Util qw(max);
+
+use base qw(Bugzilla::Object);
+
+###############################
+####    Initialization     ####
+###############################
+
+use constant DB_TABLE   => 'attachments';
+use constant ID_FIELD   => 'attach_id';
+use constant LIST_ORDER => ID_FIELD;
+# Attachments are tracked in bugs_activity.
+use constant AUDIT_CREATES => 0;
+use constant AUDIT_UPDATES => 0;
+
+sub DB_COLUMNS {
+    my $dbh = Bugzilla->dbh;
+
+    return qw(
+        attach_id
+        bug_id
+        description
+        filename
+        isobsolete
+        ispatch
+        isprivate
+        mimetype
+        modification_time
+        submitter_id),
+        $dbh->sql_date_format('attachments.creation_ts', '%Y.%m.%d %H:%i') . ' AS creation_ts';
+}
+
+use constant REQUIRED_FIELD_MAP => {
+    bug_id => 'bug',
+};
+use constant EXTRA_REQUIRED_FIELDS => qw(data);
+
+use constant UPDATE_COLUMNS => qw(
+    description
+    filename
+    isobsolete
+    ispatch
+    isprivate
+    mimetype
+);
+
+use constant VALIDATORS => {
+    bug           => \&_check_bug,
+    description   => \&_check_description,
+    filename      => \&_check_filename,
+    ispatch       => \&Bugzilla::Object::check_boolean,
+    isprivate     => \&_check_is_private,
+    mimetype      => \&_check_content_type,
+};
+
+use constant VALIDATOR_DEPENDENCIES => {
+    mimetype => ['ispatch'],
+};
+
+use constant UPDATE_VALIDATORS => {
+    isobsolete => \&Bugzilla::Object::check_boolean,
+};
+
+###############################
+####      Accessors      ######
+###############################
+
+=pod
+
+=head2 Instance Properties
+
+=over
+
+=item C<bug_id>
+
+the ID of the bug to which the attachment is attached
+
+=back
+
+=cut
+
+sub bug_id {
+    my $self = shift;
+    return $self->{bug_id};
+}
+
+=over
+
+=item C<bug>
+
+the bug object to which the attachment is attached
+
+=back
+
+=cut
+
+sub bug {
+    my $self = shift;
+
+    require Bugzilla::Bug;
+    $self->{bug} ||= Bugzilla::Bug->new($self->bug_id);
+    return $self->{bug};
+}
+
+=over
+
+=item C<description>
+
+user-provided text describing the attachment
+
+=back
+
+=cut
+
+sub description {
+    my $self = shift;
+    return $self->{description};
+}
+
+=over
+
+=item C<contenttype>
+
+the attachment's MIME media type
+
+=back
+
+=cut
+
+sub contenttype {
+    my $self = shift;
+    return $self->{mimetype};
+}
+
+=over
+
+=item C<attacher>
+
+the user who attached the attachment
+
+=back
+
+=cut
+
+sub attacher {
+    my $self = shift;
+    return $self->{attacher} if exists $self->{attacher};
+    $self->{attacher} = new Bugzilla::User($self->{submitter_id});
+    return $self->{attacher};
+}
+
+=over
+
+=item C<attached>
+
+the date and time on which the attacher attached the attachment
+
+=back
+
+=cut
+
+sub attached {
+    my $self = shift;
+    return $self->{creation_ts};
+}
+
+=over
+
+=item C<modification_time>
+
+the date and time on which the attachment was last modified.
+
+=back
+
+=cut
+
+sub modification_time {
+    my $self = shift;
+    return $self->{modification_time};
+}
+
+=over
+
+=item C<filename>
+
+the name of the file the attacher attached
+
+=back
+
+=cut
+
+sub filename {
+    my $self = shift;
+    return $self->{filename};
+}
+
+=over
+
+=item C<ispatch>
+
+whether or not the attachment is a patch
+
+=back
+
+=cut
+
+sub ispatch {
+    my $self = shift;
+    return $self->{ispatch};
+}
+
+=over
+
+=item C<isobsolete>
+
+whether or not the attachment is obsolete
+
+=back
+
+=cut
+
+sub isobsolete {
+    my $self = shift;
+    return $self->{isobsolete};
+}
+
+=over
+
+=item C<isprivate>
+
+whether or not the attachment is private
+
+=back
+
+=cut
+
+sub isprivate {
+    my $self = shift;
+    return $self->{isprivate};
+}
+
+=over
+
+=item C<is_viewable>
+
+Returns 1 if the attachment has a content-type viewable in this browser.
+Note that we don't use $cgi->Accept()'s ability to check if a content-type
+matches, because this will return a value even if it's matched by the generic
+*/* which most browsers add to the end of their Accept: headers.
+
+=back
+
+=cut
+
+sub is_viewable {
+    my $self = shift;
+    my $contenttype = $self->contenttype;
+    my $cgi = Bugzilla->cgi;
+
+    # We assume we can view all text and image types.
+    return 1 if ($contenttype =~ /^(text|image)\//);
+
+    # Mozilla can view XUL. Note the trailing slash on the Gecko detection to
+    # avoid sending XUL to Safari.
+    return 1 if (($contenttype =~ /^application\/vnd\.mozilla\./)
+                 && ($cgi->user_agent() =~ /Gecko\//));
+
+    # If it's not one of the above types, we check the Accept: header for any
+    # types mentioned explicitly.
+    my $accept = join(",", $cgi->Accept());
+    return 1 if ($accept =~ /^(.*,)?\Q$contenttype\E(,.*)?$/);
+
+    return 0;
+}
+
+=over
+
+=item C<data>
+
+the content of the attachment
+
+=back
+
+=cut
+
+sub data {
+    my $self = shift;
+    return $self->{data} if exists $self->{data};
+
+    # First try to get the attachment data from the database.
+    ($self->{data}) = Bugzilla->dbh->selectrow_array("SELECT thedata
+                                                      FROM attach_data
+                                                      WHERE id = ?",
+                                                     undef,
+                                                     $self->id);
+
+    # If there's no attachment data in the database, the attachment is stored
+    # in a local file, so retrieve it from there.
+    if (length($self->{data}) == 0) {
+        if (open(AH, $self->_get_local_filename())) {
+            local $/;
+            binmode AH;
+            $self->{data} = <AH>;
+            close(AH);
+        }
+    }
+
+    return $self->{data};
+}
+
+=over
+
+=item C<datasize>
+
+the length (in bytes) of the attachment content
+
+=back
+
+=cut
+
+# datasize is a property of the data itself, and it's unclear whether we should
+# expose it at all, since you can easily derive it from the data itself: in TT,
+# attachment.data.size; in Perl, length($attachment->{data}).  But perhaps
+# it makes sense for performance reasons, since accessing the data forces it
+# to get retrieved from the database/filesystem and loaded into memory,
+# while datasize avoids loading the attachment into memory, calling SQL's
+# LENGTH() function or stat()ing the file instead.  I've left it in for now.
+
+sub datasize {
+    my $self = shift;
+    return $self->{datasize} if exists $self->{datasize};
+
+    # If we have already retrieved the data, return its size.
+    return length($self->{data}) if exists $self->{data};
+
+    $self->{datasize} =
+        Bugzilla->dbh->selectrow_array("SELECT LENGTH(thedata)
+                                        FROM attach_data
+                                        WHERE id = ?",
+                                       undef, $self->id) || 0;
+
+    # If there's no attachment data in the database, either the attachment
+    # is stored in a local file, and so retrieve its size from the file,
+    # or the attachment has been deleted.
+    unless ($self->{datasize}) {
+        if (open(AH, $self->_get_local_filename())) {
+            binmode AH;
+            $self->{datasize} = (stat(AH))[7];
+            close(AH);
+        }
+    }
+
+    return $self->{datasize};
+}
+
+sub _get_local_filename {
+    my $self = shift;
+    my $hash = ($self->id % 100) + 100;
+    $hash =~ s/.*(\d\d)$/group.$1/;
+    return bz_locations()->{'attachdir'} . "/$hash/attachment." . $self->id;
+}
+
+=over
+
+=item C<flags>
+
+flags that have been set on the attachment
+
+=back
+
+=cut
+
+sub flags {
+    my $self = shift;
+
+    # Don't cache it as it must be in sync with ->flag_types.
+    $self->{flags} = [map { @{$_->{flags}} } @{$self->flag_types}];
+    return $self->{flags};
+}
+
+=over
+
+=item C<flag_types>
+
+Return all flag types available for this attachment as well as flags
+already set, grouped by flag type.
+
+=back
+
+=cut
+
+sub flag_types {
+    my $self = shift;
+    return $self->{flag_types} if exists $self->{flag_types};
+
+    my $vars = { target_type  => 'attachment',
+                 product_id   => $self->bug->product_id,
+                 component_id => $self->bug->component_id,
+                 attach_id    => $self->id };
+
+    $self->{flag_types} = Bugzilla::Flag->_flag_types($vars);
+    return $self->{flag_types};
+}
+
+###############################
+####      Validators     ######
+###############################
+
+sub set_content_type { $_[0]->set('mimetype', $_[1]); }
+sub set_description  { $_[0]->set('description', $_[1]); }
+sub set_filename     { $_[0]->set('filename', $_[1]); }
+sub set_is_patch     { $_[0]->set('ispatch', $_[1]); }
+sub set_is_private   { $_[0]->set('isprivate', $_[1]); }
+
+sub set_is_obsolete  {
+    my ($self, $obsolete) = @_;
+
+    my $old = $self->isobsolete;
+    $self->set('isobsolete', $obsolete);
+    my $new = $self->isobsolete;
+
+    # If the attachment is being marked as obsolete, cancel pending requests.
+    if ($new && $old != $new) {
+        my @requests = grep { $_->status eq '?' } @{$self->flags};
+        return unless scalar @requests;
+
+        my %flag_ids = map { $_->id => 1 } @requests;
+        foreach my $flagtype (@{$self->flag_types}) {
+            @{$flagtype->{flags}} = grep { !$flag_ids{$_->id} } @{$flagtype->{flags}};
+        }
+    }
+}
+
+sub set_flags {
+    my ($self, $flags, $new_flags) = @_;
+
+    Bugzilla::Flag->set_flag($self, $_) foreach (@$flags, @$new_flags);
+}
+
+sub _check_bug {
+    my ($invocant, $bug) = @_;
+    my $user = Bugzilla->user;
+
+    $bug = ref $invocant ? $invocant->bug : $bug;
+
+    $bug || ThrowCodeError('param_required', 
+                           { function => "$invocant->create", param => 'bug' });
+
+    ($user->can_see_bug($bug->id) && $user->can_edit_product($bug->product_id))
+      || ThrowUserError("illegal_attachment_edit_bug", { bug_id => $bug->id });
+
+    return $bug;
+}
+
+sub _check_content_type {
+    my ($invocant, $content_type, undef, $params) = @_;
+ 
+    my $is_patch = ref($invocant) ? $invocant->ispatch : $params->{ispatch};
+    $content_type = 'text/plain' if $is_patch;
+    $content_type = clean_text($content_type);
+    # The subsets below cover all existing MIME types and charsets registered by IANA.
+    # (MIME type: RFC 2045 section 5.1; charset: RFC 2278 section 3.3)
+    my $legal_types = join('|', LEGAL_CONTENT_TYPES);
+    if (!$content_type
+        || $content_type !~ /^($legal_types)\/[a-z0-9_\-\+\.]+(;\s*charset=[a-z0-9_\-\+]+)?$/i)
+    {
+        ThrowUserError("invalid_content_type", { contenttype => $content_type });
+    }
+    trick_taint($content_type);
+
+    # $ENV{HOME} must be defined when using File::MimeInfo::Magic,
+    # see https://rt.cpan.org/Public/Bug/Display.html?id=41744.
+    local $ENV{HOME} = $ENV{HOME} || File::Spec->rootdir();
+
+    # If we have autodetected application/octet-stream from the Content-Type
+    # header, let's have a better go using a sniffer if available.
+    if (defined Bugzilla->input_params->{contenttypemethod}
+        && Bugzilla->input_params->{contenttypemethod} eq 'autodetect'
+        && $content_type eq 'application/octet-stream'
+        && Bugzilla->feature('typesniffer'))
+    {
+        import File::MimeInfo::Magic qw(mimetype);
+        require IO::Scalar;
+
+        # data is either a filehandle, or the data itself.
+        my $fh = $params->{data};
+        if (!ref($fh)) {
+            $fh = new IO::Scalar \$fh;
+        }
+        elsif (!$fh->isa('IO::Handle')) {
+            # CGI.pm sends us an Fh that isn't actually an IO::Handle, but
+            # has a method for getting an actual handle out of it.
+            $fh = $fh->handle;
+            # ->handle returns an literal IO::Handle, even though the
+            # underlying object is a file. So we rebless it to be a proper
+            # IO::File object so that we can call ->seek on it and so on.
+            # Just in case CGI.pm fixes this some day, we check ->isa first.
+            if (!$fh->isa('IO::File')) {
+                bless $fh, 'IO::File';
+            }
+        }
+
+        my $mimetype = mimetype($fh);
+        $fh->seek(0, 0);
+        $content_type = $mimetype if $mimetype;
+    }
+
+    # Make sure patches are viewable in the browser
+    if (!ref($invocant)
+        && defined Bugzilla->input_params->{contenttypemethod}
+        && Bugzilla->input_params->{contenttypemethod} eq 'autodetect'
+        && $content_type =~ m{text/x-(?:diff|patch)})
+    {
+        $params->{ispatch} = 1;
+        $content_type = 'text/plain';
+    }
+
+    return $content_type;
+}
+
+sub _check_data {
+    my ($invocant, $params) = @_;
+
+    my $data = $params->{data};
+    $params->{filesize} = ref $data ? -s $data : length($data);
+
+    Bugzilla::Hook::process('attachment_process_data', { data       => \$data,
+                                                         attributes => $params });
+
+    $params->{filesize} || ThrowUserError('zero_length_file');
+    # Make sure the attachment does not exceed the maximum permitted size.
+    my $max_size = max(Bugzilla->params->{'maxlocalattachment'} * 1048576,
+                       Bugzilla->params->{'maxattachmentsize'} * 1024);
+
+    if ($params->{filesize} > $max_size) {
+        my $vars = { filesize => sprintf("%.0f", $params->{filesize}/1024) };
+        ThrowUserError('file_too_large', $vars);
+    }
+    return $data;
+}
+
+sub _check_description {
+    my ($invocant, $description) = @_;
+
+    $description = trim($description);
+    $description || ThrowUserError('missing_attachment_description');
+    return $description;
+}
+
+sub _check_filename {
+    my ($invocant, $filename) = @_;
+
+    $filename = clean_text($filename);
+    if (!$filename) {
+        if (ref $invocant) {
+            ThrowUserError('filename_not_specified');
+        }
+        else {
+            ThrowUserError('file_not_specified');
+        }
+    }
+
+    # Remove path info (if any) from the file name.  The browser should do this
+    # for us, but some are buggy.  This may not work on Mac file names and could
+    # mess up file names with slashes in them, but them's the breaks.  We only
+    # use this as a hint to users downloading attachments anyway, so it's not
+    # a big deal if it munges incorrectly occasionally.
+    $filename =~ s/^.*[\/\\]//;
+
+    # Truncate the filename to MAX_ATTACH_FILENAME_LENGTH characters, counting 
+    # from the end of the string to make sure we keep the filename extension.
+    $filename = substr($filename, 
+                       -&MAX_ATTACH_FILENAME_LENGTH, 
+                       MAX_ATTACH_FILENAME_LENGTH);
+    trick_taint($filename);
+
+    return $filename;
+}
+
+sub _check_is_private {
+    my ($invocant, $is_private) = @_;
+
+    $is_private = $is_private ? 1 : 0;
+    if (((!ref $invocant && $is_private)
+         || (ref $invocant && $invocant->isprivate != $is_private))
+        && !Bugzilla->user->is_insider) {
+        ThrowUserError('user_not_insider');
+    }
+    return $is_private;
+}
+
+=pod
+
+=head2 Class Methods
+
+=over
+
+=item C<get_attachments_by_bug($bug)>
+
+Description: retrieves and returns the attachments the currently logged in
+             user can view for the given bug.
+
+Params:     C<$bug> - Bugzilla::Bug object - the bug for which
+            to retrieve and return attachments.
+
+Returns:    a reference to an array of attachment objects.
+
+=cut
+
+sub get_attachments_by_bug {
+    my ($class, $bug, $vars) = @_;
+    my $user = Bugzilla->user;
+    my $dbh = Bugzilla->dbh;
+
+    # By default, private attachments are not accessible, unless the user
+    # is in the insider group or submitted the attachment.
+    my $and_restriction = '';
+    my @values = ($bug->id);
+
+    unless ($user->is_insider) {
+        $and_restriction = 'AND (isprivate = 0 OR submitter_id = ?)';
+        push(@values, $user->id);
+    }
+
+    my $attach_ids = $dbh->selectcol_arrayref("SELECT attach_id FROM attachments
+                                               WHERE bug_id = ? $and_restriction",
+                                               undef, @values);
+
+    my $attachments = Bugzilla::Attachment->new_from_list($attach_ids);
+    $_->{bug} = $bug foreach @$attachments;
+
+    # To avoid $attachment->flags to run SQL queries itself for each
+    # attachment listed here, we collect all the data at once and
+    # populate $attachment->{flags} ourselves.
+    # We also load all attachers at once for the same reason.
+    if ($vars->{preload}) {
+        # Preload flags.
+        $_->{flags} = [] foreach @$attachments;
+        my %att = map { $_->id => $_ } @$attachments;
+
+        my $flags = Bugzilla::Flag->match({ bug_id      => $bug->id,
+                                            target_type => 'attachment' });
+
+        # Exclude flags for private attachments you cannot see.
+        @$flags = grep {exists $att{$_->attach_id}} @$flags;
+
+        push(@{$att{$_->attach_id}->{flags}}, $_) foreach @$flags;
+        $attachments = [sort {$a->id <=> $b->id} values %att];
+
+        # Preload attachers.
+        my %user_ids = map { $_->{submitter_id} => 1 } @$attachments;
+        my $users = Bugzilla::User->new_from_list([keys %user_ids]);
+        my %user_map = map { $_->id => $_ } @$users;
+        foreach my $attachment (@$attachments) {
+            $attachment->{attacher} = $user_map{$attachment->{submitter_id}};
+        }
+    }
+    return $attachments;
+}
+
+=pod
+
+=item C<validate_can_edit($attachment, $product_id)>
+
+Description: validates if the user is allowed to view and edit the attachment.
+             Only the submitter or someone with editbugs privs can edit it.
+             Only the submitter and users in the insider group can view
+             private attachments.
+
+Params:      $attachment - the attachment object being edited.
+             $product_id - the product ID the attachment belongs to.
+
+Returns:     1 on success, 0 otherwise.
+
+=cut
+
+sub validate_can_edit {
+    my ($attachment, $product_id) = @_;
+    my $user = Bugzilla->user;
+
+    # The submitter can edit their attachments.
+    return ($attachment->attacher->id == $user->id
+            || ((!$attachment->isprivate || $user->is_insider)
+                 && $user->in_group('editbugs', $product_id))) ? 1 : 0;
+}
+
+=item C<validate_obsolete($bug, $attach_ids)>
+
+Description: validates if attachments the user wants to mark as obsolete
+             really belong to the given bug and are not already obsolete.
+             Moreover, a user cannot mark an attachment as obsolete if
+             he cannot view it (due to restrictions on it).
+
+Params:      $bug - The bug object obsolete attachments should belong to.
+             $attach_ids - The list of attachments to mark as obsolete.
+
+Returns:     The list of attachment objects to mark as obsolete.
+             Else an error is thrown.
+
+=cut
+
+sub validate_obsolete {
+    my ($class, $bug, $list) = @_;
+
+    # Make sure the attachment id is valid and the user has permissions to view
+    # the bug to which it is attached. Make sure also that the user can view
+    # the attachment itself.
+    my @obsolete_attachments;
+    foreach my $attachid (@$list) {
+        my $vars = {};
+        $vars->{'attach_id'} = $attachid;
+
+        detaint_natural($attachid)
+          || ThrowUserError('invalid_attach_id', $vars);
+
+        # Make sure the attachment exists in the database.
+        my $attachment = new Bugzilla::Attachment($attachid)
+          || ThrowUserError('invalid_attach_id', $vars);
+
+        # Check that the user can view and edit this attachment.
+        $attachment->validate_can_edit($bug->product_id)
+          || ThrowUserError('illegal_attachment_edit', { attach_id => $attachment->id });
+
+        if ($attachment->bug_id != $bug->bug_id) {
+            $vars->{'my_bug_id'} = $bug->bug_id;
+            ThrowUserError('mismatched_bug_ids_on_obsolete', $vars);
+        }
+
+        next if $attachment->isobsolete;
+
+        push(@obsolete_attachments, $attachment);
+    }
+    return @obsolete_attachments;
+}
+
+###############################
+####     Constructors     #####
+###############################
+
+=pod
+
+=item C<create>
+
+Description: inserts an attachment into the given bug.
+
+Params:     takes a hashref with the following keys:
+            C<bug> - Bugzilla::Bug object - the bug for which to insert
+            the attachment.
+            C<data> - Either a filehandle pointing to the content of the
+            attachment, or the content of the attachment itself.
+            C<description> - string - describe what the attachment is about.
+            C<filename> - string - the name of the attachment (used by the
+            browser when downloading it). If the attachment is a URL, this
+            parameter has no effect.
+            C<mimetype> - string - a valid MIME type.
+            C<creation_ts> - string (optional) - timestamp of the insert
+            as returned by SELECT LOCALTIMESTAMP(0).
+            C<ispatch> - boolean (optional, default false) - true if the
+            attachment is a patch.
+            C<isprivate> - boolean (optional, default false) - true if
+            the attachment is private.
+
+Returns:    The new attachment object.
+
+=cut
+
+sub create {
+    my $class = shift;
+    my $dbh = Bugzilla->dbh;
+
+    $class->check_required_create_fields(@_);
+    my $params = $class->run_create_validators(@_);
+
+    # Extract everything which is not a valid column name.
+    my $bug = delete $params->{bug};
+    $params->{bug_id} = $bug->id;
+    my $data = delete $params->{data};
+    my $size = delete $params->{filesize};
+
+    my $attachment = $class->insert_create_data($params);
+    my $attachid = $attachment->id;
+
+    # The file is too large to be stored in the DB, so we store it locally.
+    if ($size > Bugzilla->params->{'maxattachmentsize'} * 1024) {
+        my $attachdir = bz_locations()->{'attachdir'};
+        my $hash = ($attachid % 100) + 100;
+        $hash =~ s/.*(\d\d)$/group.$1/;
+        mkdir "$attachdir/$hash", 0770;
+        chmod 0770, "$attachdir/$hash";
+        if (ref $data) {
+            copy($data, "$attachdir/$hash/attachment.$attachid");
+            close $data;
+        }
+        else {
+            open(AH, '>', "$attachdir/$hash/attachment.$attachid");
+            binmode AH;
+            print AH $data;
+            close AH;
+        }
+        $data = ''; # Will be stored in the DB.
+    }
+    # If we have a filehandle, we need its content to store it in the DB.
+    elsif (ref $data) {
+        local $/;
+        # Store the content in a temp variable while we close the FH.
+        my $tmp = <$data>;
+        close $data;
+        $data = $tmp;
+    }
+
+    my $sth = $dbh->prepare("INSERT INTO attach_data
+                             (id, thedata) VALUES ($attachid, ?)");
+
+    trick_taint($data);
+    $sth->bind_param(1, $data, $dbh->BLOB_TYPE);
+    $sth->execute();
+
+    $attachment->{bug} = $bug;
+
+    # Return the new attachment object.
+    return $attachment;
+}
+
+sub run_create_validators {
+    my ($class, $params) = @_;
+
+    # Let's validate the attachment content first as it may
+    # alter some other attachment attributes.
+    $params->{data} = $class->_check_data($params);
+    $params = $class->SUPER::run_create_validators($params);
+
+    $params->{creation_ts} ||= Bugzilla->dbh->selectrow_array('SELECT LOCALTIMESTAMP(0)');
+    $params->{modification_time} = $params->{creation_ts};
+    $params->{submitter_id} = Bugzilla->user->id || ThrowUserError('invalid_user');
+
+    return $params;
+}
+
+sub update {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+    my $user = Bugzilla->user;
+    my $timestamp = shift || $dbh->selectrow_array('SELECT LOCALTIMESTAMP(0)');
+
+    my ($changes, $old_self) = $self->SUPER::update(@_);
+
+    my ($removed, $added) = Bugzilla::Flag->update_flags($self, $old_self, $timestamp);
+    if ($removed || $added) {
+        $changes->{'flagtypes.name'} = [$removed, $added];
+    }
+
+    # Record changes in the activity table.
+    my $sth = $dbh->prepare('INSERT INTO bugs_activity (bug_id, attach_id, who, bug_when,
+                                                        fieldid, removed, added)
+                             VALUES (?, ?, ?, ?, ?, ?, ?)');
+
+    foreach my $field (keys %$changes) {
+        my $change = $changes->{$field};
+        $field = "attachments.$field" unless $field eq "flagtypes.name";
+        my $fieldid = get_field_id($field);
+        $sth->execute($self->bug_id, $self->id, $user->id, $timestamp,
+                      $fieldid, $change->[0], $change->[1]);
+    }
+
+    if (scalar(keys %$changes)) {
+      $dbh->do('UPDATE attachments SET modification_time = ? WHERE attach_id = ?',
+               undef, ($timestamp, $self->id));
+      $dbh->do('UPDATE bugs SET delta_ts = ? WHERE bug_id = ?',
+               undef, ($timestamp, $self->bug_id));
+    }
+
+    return $changes;
+}
+
+=pod
+
+=item C<remove_from_db()>
+
+Description: removes an attachment from the DB.
+
+Params:     none
+
+Returns:    nothing
+
+=back
+
+=cut
+
+sub remove_from_db {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    $dbh->bz_start_transaction();
+    $dbh->do('DELETE FROM flags WHERE attach_id = ?', undef, $self->id);
+    $dbh->do('DELETE FROM attach_data WHERE id = ?', undef, $self->id);
+    $dbh->do('UPDATE attachments SET mimetype = ?, ispatch = ?, isobsolete = ?
+              WHERE attach_id = ?', undef, ('text/plain', 0, 1, $self->id));
+    $dbh->bz_commit_transaction();
+
+    my $filename = $self->_get_local_filename;
+    if (-e $filename) {
+        unlink $filename or warn "Couldn't unlink $filename: $!";
+    }
+}
+
+###############################
+####       Helpers        #####
+###############################
+
+# Extract the content type from the attachment form.
+sub get_content_type {
+    my $cgi = Bugzilla->cgi;
+
+    return 'text/plain' if ($cgi->param('ispatch') || $cgi->param('attach_text'));
+
+    my $content_type;
+    my $method = $cgi->param('contenttypemethod') || '';
+
+    if ($method eq 'list') {
+        # The user selected a content type from the list, so use their
+        # selection.
+        $content_type = $cgi->param('contenttypeselection');
+    }
+    elsif ($method eq 'manual') {
+        # The user entered a content type manually, so use their entry.
+        $content_type = $cgi->param('contenttypeentry');
+    }
+    else {
+        defined $cgi->upload('data') || ThrowUserError('file_not_specified');
+        # The user asked us to auto-detect the content type, so use the type
+        # specified in the HTTP request headers.
+        $content_type =
+            $cgi->uploadInfo($cgi->param('data'))->{'Content-Type'};
+        $content_type || ThrowUserError("missing_content_type");
+
+        # Internet Explorer sends image/x-png for PNG images,
+        # so convert that to image/png to match other browsers.
+        if ($content_type eq 'image/x-png') {
+            $content_type = 'image/png';
+        }
+    }
+    return $content_type;
+}
+
+
+1;

diff --git a/Bugzilla/Attachment/PatchReader.pm b/Bugzilla/Attachment/PatchReader.pm
new file mode 100644 (file)
index 0000000..e9cb189
--- /dev/null
+++ b/Bugzilla/Attachment/PatchReader.pm
@@ -0,0 +1,287 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+package Bugzilla::Attachment::PatchReader;
+
+use Bugzilla::Error;
+use Bugzilla::Attachment;
+use Bugzilla::Util;
+
+sub process_diff {
+    my ($attachment, $format, $context) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $cgi = Bugzilla->cgi;
+    my $lc  = Bugzilla->localconfig;
+    my $vars = {};
+
+    my ($reader, $last_reader) = setup_patch_readers(undef, $context);
+
+    if ($format eq 'raw') {
+        require PatchReader::DiffPrinter::raw;
+        $last_reader->sends_data_to(new PatchReader::DiffPrinter::raw());
+        # Actually print out the patch.
+        print $cgi->header(-type => 'text/plain',
+                           -expires => '+3M');
+        disable_utf8();
+        $reader->iterate_string('Attachment ' . $attachment->id, $attachment->data);
+    }
+    else {
+        my @other_patches = ();
+        if ($lc->{interdiffbin} && $lc->{diffpath}) {
+            # Get the list of attachments that the user can view in this bug.
+            my @attachments =
+                @{Bugzilla::Attachment->get_attachments_by_bug($attachment->bug)};
+            # Extract patches only.
+            @attachments = grep {$_->ispatch == 1} @attachments;
+            # We want them sorted from newer to older.
+            @attachments = sort { $b->id <=> $a->id } @attachments;
+
+            # Ignore the current patch, but select the one right before it
+            # chronologically.
+            my $select_next_patch = 0;
+            foreach my $attach (@attachments) {
+                if ($attach->id == $attachment->id) {
+                    $select_next_patch = 1;
+                }
+                else {
+                    push(@other_patches, { 'id'       => $attach->id,
+                                           'desc'     => $attach->description,
+                                           'selected' => $select_next_patch });
+                    $select_next_patch = 0;
+                }
+            }
+        }
+
+        $vars->{'bugid'} = $attachment->bug_id;
+        $vars->{'attachid'} = $attachment->id;
+        $vars->{'description'} = $attachment->description;
+        $vars->{'other_patches'} = \@other_patches;
+
+        setup_template_patch_reader($last_reader, $format, $context, $vars);
+        # The patch is going to be displayed in a HTML page and if the utf8
+        # param is enabled, we have to encode attachment data as utf8.
+        if (Bugzilla->params->{'utf8'}) {
+            $attachment->data; # Populate ->{data}
+            utf8::decode($attachment->{data});
+        }
+        $reader->iterate_string('Attachment ' . $attachment->id, $attachment->data);
+    }
+}
+
+sub process_interdiff {
+    my ($old_attachment, $new_attachment, $format, $context) = @_;
+    my $cgi = Bugzilla->cgi;
+    my $lc  = Bugzilla->localconfig;
+    my $vars = {};
+
+    # Encode attachment data as utf8 if it's going to be displayed in a HTML
+    # page using the UTF-8 encoding.
+    if ($format ne 'raw' && Bugzilla->params->{'utf8'}) {
+        $old_attachment->data; # Populate ->{data}
+        utf8::decode($old_attachment->{data});
+        $new_attachment->data; # Populate ->{data}
+        utf8::decode($new_attachment->{data});
+    }
+
+    # Get old patch data.
+    my ($old_filename, $old_file_list) = get_unified_diff($old_attachment, $format);
+    # Get new patch data.
+    my ($new_filename, $new_file_list) = get_unified_diff($new_attachment, $format);
+
+    my $warning = warn_if_interdiff_might_fail($old_file_list, $new_file_list);
+
+    # Send through interdiff, send output directly to template.
+    # Must hack path so that interdiff will work.
+    $ENV{'PATH'} = $lc->{diffpath};
+    open my $interdiff_fh, "$lc->{interdiffbin} $old_filename $new_filename|";
+    binmode $interdiff_fh;
+    my ($reader, $last_reader) = setup_patch_readers("", $context);
+
+    if ($format eq 'raw') {
+        require PatchReader::DiffPrinter::raw;
+        $last_reader->sends_data_to(new PatchReader::DiffPrinter::raw());
+        # Actually print out the patch.
+        print $cgi->header(-type => 'text/plain',
+                           -expires => '+3M');
+        disable_utf8();
+    }
+    else {
+        # In case the HTML page is displayed with the UTF-8 encoding.
+        binmode $interdiff_fh, ':utf8' if Bugzilla->params->{'utf8'};
+
+        $vars->{'warning'} = $warning if $warning;
+        $vars->{'bugid'} = $new_attachment->bug_id;
+        $vars->{'oldid'} = $old_attachment->id;
+        $vars->{'old_desc'} = $old_attachment->description;
+        $vars->{'newid'} = $new_attachment->id;
+        $vars->{'new_desc'} = $new_attachment->description;
+
+        setup_template_patch_reader($last_reader, $format, $context, $vars);
+    }
+    $reader->iterate_fh($interdiff_fh, 'interdiff #' . $old_attachment->id .
+                        ' #' . $new_attachment->id);
+    close $interdiff_fh;
+    $ENV{'PATH'} = '';
+
+    # Delete temporary files.
+    unlink($old_filename) or warn "Could not unlink $old_filename: $!";
+    unlink($new_filename) or warn "Could not unlink $new_filename: $!";
+}
+
+######################
+#  Internal routines
+######################
+
+sub get_unified_diff {
+    my ($attachment, $format) = @_;
+
+    # Bring in the modules we need.
+    require PatchReader::Raw;
+    require PatchReader::FixPatchRoot;
+    require PatchReader::DiffPrinter::raw;
+    require PatchReader::PatchInfoGrabber;
+    require File::Temp;
+
+    $attachment->ispatch
+      || ThrowCodeError('must_be_patch', { 'attach_id' => $attachment->id });
+
+    # Reads in the patch, converting to unified diff in a temp file.
+    my $reader = new PatchReader::Raw;
+    my $last_reader = $reader;
+
+    # Fixes patch root (makes canonical if possible).
+    if (Bugzilla->params->{'cvsroot'}) {
+        my $fix_patch_root =
+            new PatchReader::FixPatchRoot(Bugzilla->params->{'cvsroot'});
+        $last_reader->sends_data_to($fix_patch_root);
+        $last_reader = $fix_patch_root;
+    }
+
+    # Grabs the patch file info.
+    my $patch_info_grabber = new PatchReader::PatchInfoGrabber();
+    $last_reader->sends_data_to($patch_info_grabber);
+    $last_reader = $patch_info_grabber;
+
+    # Prints out to temporary file.
+    my ($fh, $filename) = File::Temp::tempfile();
+    if ($format ne 'raw' && Bugzilla->params->{'utf8'}) {
+        # The HTML page will be displayed with the UTF-8 encoding.
+        binmode $fh, ':utf8';
+    }
+    my $raw_printer = new PatchReader::DiffPrinter::raw($fh);
+    $last_reader->sends_data_to($raw_printer);
+    $last_reader = $raw_printer;
+
+    # Iterate!
+    $reader->iterate_string($attachment->id, $attachment->data);
+
+    return ($filename, $patch_info_grabber->patch_info()->{files});
+}
+
+sub warn_if_interdiff_might_fail {
+    my ($old_file_list, $new_file_list) = @_;
+
+    # Verify that the list of files diffed is the same.
+    my @old_files = sort keys %{$old_file_list};
+    my @new_files = sort keys %{$new_file_list};
+    if (@old_files != @new_files
+        || join(' ', @old_files) ne join(' ', @new_files))
+    {
+        return 'interdiff1';
+    }
+
+    # Verify that the revisions in the files are the same.
+    foreach my $file (keys %{$old_file_list}) {
+        if (exists $old_file_list->{$file}{old_revision}
+            && exists $new_file_list->{$file}{old_revision}
+            && $old_file_list->{$file}{old_revision} ne
+            $new_file_list->{$file}{old_revision})
+        {
+            return 'interdiff2';
+        }
+    }
+    return undef;
+}
+
+sub setup_patch_readers {
+    my ($diff_root, $context) = @_;
+
+    # Parameters:
+    # format=raw|html
+    # context=patch|file|0-n
+    # collapsed=0|1
+    # headers=0|1
+
+    # Define the patch readers.
+    # The reader that reads the patch in (whatever its format).
+    require PatchReader::Raw;
+    my $reader = new PatchReader::Raw;
+    my $last_reader = $reader;
+    # Fix the patch root if we have a cvs root.
+    if (Bugzilla->params->{'cvsroot'}) {
+        require PatchReader::FixPatchRoot;
+        $last_reader->sends_data_to(new PatchReader::FixPatchRoot(Bugzilla->params->{'cvsroot'}));
+        $last_reader->sends_data_to->diff_root($diff_root) if defined($diff_root);
+        $last_reader = $last_reader->sends_data_to;
+    }
+
+    # Add in cvs context if we have the necessary info to do it
+    if ($context ne 'patch' && Bugzilla->localconfig->{cvsbin} 
+        && Bugzilla->params->{'cvsroot_get'}) 
+    {
+        require PatchReader::AddCVSContext;
+        # We need to set $cvsbin as global, because PatchReader::CVSClient
+        # needs it in order to find 'cvs'.
+        $main::cvsbin = Bugzilla->localconfig->{cvsbin};
+        $last_reader->sends_data_to(
+          new PatchReader::AddCVSContext($context, Bugzilla->params->{'cvsroot_get'}));
+        $last_reader = $last_reader->sends_data_to;
+    }
+
+    return ($reader, $last_reader);
+}
+
+sub setup_template_patch_reader {
+    my ($last_reader, $format, $context, $vars) = @_;
+    my $cgi = Bugzilla->cgi;
+    my $template = Bugzilla->template;
+
+    require PatchReader::DiffPrinter::template;
+
+    # Define the vars for templates.
+    if (defined $cgi->param('headers')) {
+        $vars->{'headers'} = $cgi->param('headers');
+    }
+    else {
+        $vars->{'headers'} = 1;
+    }
+
+    $vars->{'collapsed'} = $cgi->param('collapsed');
+    $vars->{'context'} = $context;
+    $vars->{'do_context'} = Bugzilla->localconfig->{cvsbin} 
+                            && Bugzilla->params->{'cvsroot_get'} && !$vars->{'newid'};
+
+    # Print everything out.
+    print $cgi->header(-type => 'text/html',
+                       -expires => '+3M');
+
+    $last_reader->sends_data_to(new PatchReader::DiffPrinter::template($template,
+                                "attachment/diff-header.$format.tmpl",
+                                "attachment/diff-file.$format.tmpl",
+                                "attachment/diff-footer.$format.tmpl",
+                                { %{$vars},
+                                  bonsai_url => Bugzilla->params->{'bonsai_url'},
+                                  lxr_url => Bugzilla->params->{'lxr_url'},
+                                  lxr_root => Bugzilla->params->{'lxr_root'},
+                                }));
+}
+
+1;
+
+__END__

diff --git a/Bugzilla/Auth.pm b/Bugzilla/Auth.pm
new file mode 100644 (file)
index 0000000..477dbff
--- /dev/null
+++ b/Bugzilla/Auth.pm
@@ -0,0 +1,526 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Auth;
+
+use strict;
+use fields qw(
+    _info_getter
+    _verifier
+    _persister
+);
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Mailer;
+use Bugzilla::Util qw(datetime_from);
+use Bugzilla::User::Setting ();
+use Bugzilla::Auth::Login::Stack;
+use Bugzilla::Auth::Verify::Stack;
+use Bugzilla::Auth::Persist::Cookie;
+use Socket;
+
+sub new {
+    my ($class, $params) = @_;
+    my $self = fields::new($class);
+
+    $params            ||= {};
+    $params->{Login}   ||= Bugzilla->params->{'user_info_class'} . ',Cookie';
+    $params->{Verify}  ||= Bugzilla->params->{'user_verify_class'};
+
+    $self->{_info_getter} = new Bugzilla::Auth::Login::Stack($params->{Login});
+    $self->{_verifier} = new Bugzilla::Auth::Verify::Stack($params->{Verify});
+    # If we ever have any other login persistence methods besides cookies,
+    # this could become more configurable.
+    $self->{_persister} = new Bugzilla::Auth::Persist::Cookie();
+
+    return $self;
+}
+
+sub login {
+    my ($self, $type) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    # Get login info from the cookie, form, environment variables, etc.
+    my $login_info = $self->{_info_getter}->get_login_info();
+
+    if ($login_info->{failure}) {
+        return $self->_handle_login_result($login_info, $type);
+    }
+
+    # Now verify his username and password against the DB, LDAP, etc.
+    if ($self->{_info_getter}->{successful}->requires_verification) {
+        $login_info = $self->{_verifier}->check_credentials($login_info);
+        if ($login_info->{failure}) {
+            return $self->_handle_login_result($login_info, $type);
+        }
+        $login_info =
+          $self->{_verifier}->{successful}->create_or_update_user($login_info);
+    }
+    else {
+        $login_info = $self->{_verifier}->create_or_update_user($login_info);
+    }
+
+    if ($login_info->{failure}) {
+        return $self->_handle_login_result($login_info, $type);
+    }
+
+    # Make sure the user isn't disabled.
+    my $user = $login_info->{user};
+    if (!$user->is_enabled) {
+        return $self->_handle_login_result({ failure => AUTH_DISABLED,
+                                              user    => $user }, $type);
+    }
+    $user->set_authorizer($self);
+
+    return $self->_handle_login_result($login_info, $type);
+}
+
+sub can_change_password {
+    my ($self) = @_;
+    my $verifier = $self->{_verifier}->{successful};
+    $verifier  ||= $self->{_verifier};
+    my $getter   = $self->{_info_getter}->{successful};
+    $getter      = $self->{_info_getter} 
+        if (!$getter || $getter->isa('Bugzilla::Auth::Login::Cookie'));
+    return $verifier->can_change_password &&
+           $getter->user_can_create_account;
+}
+
+sub can_login {
+    my ($self) = @_;
+    my $getter = $self->{_info_getter}->{successful};
+    $getter    = $self->{_info_getter}
+        if (!$getter || $getter->isa('Bugzilla::Auth::Login::Cookie'));
+    return $getter->can_login;
+}
+
+sub can_logout {
+    my ($self) = @_;
+    my $getter = $self->{_info_getter}->{successful};
+    # If there's no successful getter, we're not logged in, so of
+    # course we can't log out!
+    return 0 unless $getter;
+    return $getter->can_logout;
+}
+
+sub user_can_create_account {
+    my ($self) = @_;
+    my $verifier = $self->{_verifier}->{successful};
+    $verifier  ||= $self->{_verifier};
+    my $getter   = $self->{_info_getter}->{successful};
+    $getter      = $self->{_info_getter}
+        if (!$getter || $getter->isa('Bugzilla::Auth::Login::Cookie'));
+    return $verifier->user_can_create_account
+           && $getter->user_can_create_account;
+}
+
+sub extern_id_used {
+    my ($self) = @_;
+    return $self->{_info_getter}->extern_id_used
+           ||  $self->{_verifier}->extern_id_used;
+}
+
+sub can_change_email {
+    return $_[0]->user_can_create_account;
+}
+
+sub _handle_login_result {
+    my ($self, $result, $login_type) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    my $user      = $result->{user};
+    my $fail_code = $result->{failure};
+
+    if (!$fail_code) {
+        # We don't persist logins over GET requests in the WebService,
+        # because the persistance information can't be re-used again.
+        # (See Bugzilla::WebService::Server::JSONRPC for more info.)
+        if ($self->{_info_getter}->{successful}->requires_persistence
+            and !Bugzilla->request_cache->{auth_no_automatic_login}) 
+        {
+            $self->{_persister}->persist_login($user);
+        }
+    }
+    elsif ($fail_code == AUTH_ERROR) {
+        if ($result->{user_error}) {
+            ThrowUserError($result->{user_error}, $result->{details});
+        }
+        else {
+            ThrowCodeError($result->{error}, $result->{details});
+        }
+    }
+    elsif ($fail_code == AUTH_NODATA) {
+        $self->{_info_getter}->fail_nodata($self) 
+            if $login_type == LOGIN_REQUIRED;
+
+        # If we're not LOGIN_REQUIRED, we just return the default user.
+        $user = Bugzilla->user;
+    }
+    # The username/password may be wrong
+    # Don't let the user know whether the username exists or whether
+    # the password was just wrong. (This makes it harder for a cracker
+    # to find account names by brute force)
+    elsif ($fail_code == AUTH_LOGINFAILED or $fail_code == AUTH_NO_SUCH_USER) {
+        my $remaining_attempts = MAX_LOGIN_ATTEMPTS 
+                                 - ($result->{failure_count} || 0);
+        ThrowUserError("invalid_username_or_password", 
+                       { remaining => $remaining_attempts });
+    }
+    # The account may be disabled
+    elsif ($fail_code == AUTH_DISABLED) {
+        $self->{_persister}->logout();
+        # XXX This is NOT a good way to do this, architecturally.
+        $self->{_persister}->clear_browser_cookies();
+        # and throw a user error
+        ThrowUserError("account_disabled",
+            {'disabled_reason' => $result->{user}->disabledtext});
+    }
+    elsif ($fail_code == AUTH_LOCKOUT) {
+        my $attempts = $user->account_ip_login_failures;
+
+        # We want to know when the account will be unlocked. This is 
+        # determined by the 5th-from-last login failure (or more/less than
+        # 5th, if MAX_LOGIN_ATTEMPTS is not 5).
+        my $determiner = $attempts->[scalar(@$attempts) - MAX_LOGIN_ATTEMPTS];
+        my $unlock_at = datetime_from($determiner->{login_time}, 
+                                      Bugzilla->local_timezone);
+        $unlock_at->add(minutes => LOGIN_LOCKOUT_INTERVAL);
+
+        # If we were *just* locked out, notify the maintainer about the
+        # lockout.
+        if ($result->{just_locked_out}) {
+            # We're sending to the maintainer, who may be not a Bugzilla 
+            # account, but just an email address. So we use the
+            # installation's default language for sending the email.
+            my $default_settings = Bugzilla::User::Setting::get_defaults();
+            my $template = Bugzilla->template_inner(
+                               $default_settings->{lang}->{default_value});
+            my $address = $attempts->[0]->{ip_addr};
+            # Note: inet_aton will only resolve IPv4 addresses.
+            # For IPv6 we'll need to use inet_pton which requires Perl 5.12.
+            my $n = inet_aton($address);
+            if ($n) {
+                $address = gethostbyaddr($n, AF_INET) . " ($address)"
+            }
+            my $vars = {
+                locked_user => $user,
+                attempts    => $attempts,
+                unlock_at   => $unlock_at,
+                address     => $address,
+            };
+            my $message;
+            $template->process('email/lockout.txt.tmpl', $vars, \$message)
+                || ThrowTemplateError($template->error);
+            MessageToMTA($message);
+        }
+
+        $unlock_at->set_time_zone($user->timezone);
+        ThrowUserError('account_locked', 
+            { ip_addr => $determiner->{ip_addr}, unlock_at => $unlock_at });
+    }
+    # If we get here, then we've run out of options, which shouldn't happen.
+    else {
+        ThrowCodeError("authres_unhandled", { value => $fail_code });
+    }
+
+    return $user;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Auth - An object that authenticates the login credentials for
+                 a user.
+
+=head1 DESCRIPTION
+
+Handles authentication for Bugzilla users.
+
+Authentication from Bugzilla involves two sets of modules. One set is
+used to obtain the username/password (from CGI, email, etc), and the 
+other set uses this data to authenticate against the datasource 
+(the Bugzilla DB, LDAP, PAM, etc.).
+
+Modules for obtaining the username/password are subclasses of 
+L<Bugzilla::Auth::Login>, and modules for authenticating are subclasses
+of L<Bugzilla::Auth::Verify>.
+
+=head1 AUTHENTICATION ERROR CODES
+
+Whenever a method in the C<Bugzilla::Auth> family fails in some way,
+it will return a hashref containing at least a single key called C<failure>.
+C<failure> will point to an integer error code, and depending on the error
+code the hashref may contain more data.
+
+The error codes are explained here below.
+
+=head2 C<AUTH_NODATA>
+
+Insufficient login data was provided by the user. This may happen in several
+cases, such as cookie authentication when the cookie is not present.
+
+=head2 C<AUTH_ERROR>
+
+An error occurred when trying to use the login mechanism.
+
+The hashref will also contain an C<error> element, which is the name
+of an error from C<template/en/default/global/code-error.html> --
+the same type of error that would be thrown by 
+L<Bugzilla::Error::ThrowCodeError>.
+
+The hashref *may* contain an element called C<details>, which is a hashref
+that should be passed to L<Bugzilla::Error::ThrowCodeError> as the 
+various fields to be used in the error message.
+
+=head2 C<AUTH_LOGINFAILED>
+
+An incorrect username or password was given.
+
+The hashref may also contain a C<failure_count> element, which specifies
+how many times the account has failed to log in within the lockout
+period (see L</AUTH_LOCKOUT>). This is used to warn the user when
+he is getting close to being locked out.
+
+=head2 C<AUTH_NO_SUCH_USER>
+
+This is an optional more-specific version of C<AUTH_LOGINFAILED>.
+Modules should throw this error when they discover that the
+requested user account actually does not exist, according to them.
+
+That is, for example, L<Bugzilla::Auth::Verify::LDAP> would throw
+this if the user didn't exist in LDAP.
+
+The difference between C<AUTH_NO_SUCH_USER> and C<AUTH_LOGINFAILED>
+should never be communicated to the user, for security reasons.
+
+=head2 C<AUTH_DISABLED>
+
+The user successfully logged in, but their account has been disabled.
+Usually this is throw only by C<Bugzilla::Auth::login>.
+
+=head2 C<AUTH_LOCKOUT>
+
+The user's account is locked out after having failed to log in too many
+times within a certain period of time (as specified by
+L<Bugzilla::Constants/LOGIN_LOCKOUT_INTERVAL>).
+
+The hashref will also contain a C<user> element, representing the
+L<Bugzilla::User> whose account is locked out.
+
+=head1 LOGIN TYPES
+
+The C<login> function (below) can do different types of login, depending
+on what constant you pass into it:
+
+=head2 C<LOGIN_OPTIONAL>
+
+A login is never required to access this data. Attempting to login is
+still useful, because this allows the page to be personalised. Note that
+an incorrect login will still trigger an error, even though the lack of
+a login will be OK.
+
+=head2 C<LOGIN_NORMAL>
+
+A login may or may not be required, depending on the setting of the
+I<requirelogin> parameter. This is the default if you don't specify a
+type.
+
+=head2 C<LOGIN_REQUIRED>
+
+A login is always required to access this data.
+
+=head1 METHODS
+
+These are methods that can be called on a C<Bugzilla::Auth> object 
+itself.
+
+=head2 Login
+
+=over 4
+
+=item C<login($type)>
+
+Description: Logs a user in. For more details on how this works
+             internally, see the section entitled "STRUCTURE."
+Params:      $type - One of the Login Types from above.
+Returns:     An authenticated C<Bugzilla::User>. Or, if the type was
+             not C<LOGIN_REQUIRED>, then we return an
+             empty C<Bugzilla::User> if no login data was passed in.
+
+=back
+
+=head2 Info Methods
+
+These are methods that give information about the Bugzilla::Auth object.
+
+=over 4
+
+=item C<can_change_password>
+
+Description: Tells you whether or not the current login system allows
+             changing passwords.
+Params:      None
+Returns:     C<true> if users and administrators should be allowed to
+             change passwords, C<false> otherwise.
+
+=item C<can_login>
+
+Description: Tells you whether or not the current login system allows
+             users to log in through the web interface.
+Params:      None
+Returns:     C<true> if users can log in through the web interface,
+             C<false> otherwise.
+
+=item C<can_logout>
+
+Description: Tells you whether or not the current login system allows
+             users to log themselves out.
+Params:      None
+Returns:     C<true> if users can log themselves out, C<false> otherwise.
+             If a user isn't logged in, we always return C<false>.
+
+=item C<user_can_create_account>
+
+Description: Tells you whether or not users are allowed to manually create
+             their own accounts, based on the current login system in use.
+             Note that this doesn't check the C<createemailregexp>
+             parameter--you have to do that by yourself in your code.
+Params:      None
+Returns:     C<true> if users are allowed to create new Bugzilla accounts,
+             C<false> otherwise.
+
+=item C<extern_id_used>
+
+Description: Whether or not current login system uses extern_id.
+
+=item C<can_change_email>
+
+Description: Whether or not the current login system allows users to
+             change their own email address.
+Params:      None
+Returns:     C<true> if users can change their own email address,
+             C<false> otherwise.
+
+=back
+
+=head1 STRUCTURE
+
+This section is mostly interesting to developers who want to implement
+a new authentication type. It describes the general structure of the
+Bugzilla::Auth family, and how the C<login> function works.
+
+A C<Bugzilla::Auth> object is essentially a collection of a few other
+objects: the "Info Getter," the "Verifier," and the "Persistence 
+Mechanism."
+
+They are used inside the C<login> function in the following order:
+
+=head2 The Info Getter
+
+This is a C<Bugzilla::Auth::Login> object. Basically, it gets the
+username and password from the user, somehow. Or, it just gets enough
+information to uniquely identify a user, and passes that on down the line.
+(For example, a C<user_id> is enough to uniquely identify a user,
+even without a username and password.)
+
+Some Info Getters don't require any verification. For example, if we got
+the C<user_id> from a Cookie, we don't need to check the username and 
+password.
+
+If an Info Getter returns only a C<user_id> and no username/password,
+then it MUST NOT require verification. If an Info Getter requires
+verfication, then it MUST return at least a C<username>.
+
+=head2 The Verifier
+
+This verifies that the username and password are valid.
+
+It's possible that some methods of verification don't require a password.
+
+=head2 The Persistence Mechanism
+
+This makes it so that the user doesn't have to log in on every page.
+Normally this object just sends a cookie to the user's web browser,
+as that's the most common method of "login persistence."
+
+=head2 Other Things We Do
+
+After we verify the username and password, sometimes we automatically
+create an account in the Bugzilla database, for certain authentication
+types. We use the "Account Source" to get data about the user, and
+create them in the database. (Or, if their data has changed since the
+last time they logged in, their data gets updated.)
+
+=head2 The C<$login_data> Hash
+
+All of the C<Bugzilla::Auth::Login> and C<Bugzilla::Auth::Verify>
+methods take an argument called C<$login_data>. This is basically
+a hash that becomes more and more populated as we go through the
+C<login> function.
+
+All C<Bugzilla::Auth::Login> and C<Bugzilla::Auth::Verify> methods
+also *return* the C<$login_data> structure, when they succeed. They
+may have added new data to it.
+
+For all C<Bugzilla::Auth::Login> and C<Bugzilla::Auth::Verify> methods,
+the rule is "you must return the same hashref you were passed in." You can
+modify the hashref all you want, but you can't create a new one. The only
+time you can return a new one is if you're returning some error code
+instead of the C<$login_data> structure.
+
+Each C<Bugzilla::Auth::Login> or C<Bugzilla::Auth::Verify> method
+explains in its documentation which C<$login_data> elements are
+required by it, and which are set by it.
+
+Here are all of the elements that *may* be in C<$login_data>:
+
+=over 4
+
+=item C<user_id>
+
+A Bugzilla C<user_id> that uniquely identifies a user.
+
+=item C<username>
+
+The username that was provided by the user.
+
+=item C<bz_username>
+
+The username of this user inside of Bugzilla. Sometimes this differs from
+C<username>.
+
+=item C<password>
+
+The password provided by the user.
+
+=item C<realname>
+
+The real name of the user.
+
+=item C<extern_id>
+
+Some string that uniquely identifies the user in an external account 
+source. If this C<extern_id> already exists in the database with
+a different username, the username will be *changed* to be the
+username specified in this C<$login_data>.
+
+That is, let's my extern_id is C<mkanat>. I already have an account
+in Bugzilla with the username of C<mkanat@foo.com>. But this time,
+when I log in, I have an extern_id of C<mkanat> and a C<username>
+of C<mkanat@bar.org>. So now, Bugzilla will automatically change my 
+username to C<mkanat@bar.org> instead of C<mkanat@foo.com>.
+
+=item C<user>
+
+A L<Bugzilla::User> object representing the authenticated user. 
+Note that C<Bugzilla::Auth::login> may modify this object at various points.
+
+=back

diff --git a/Bugzilla/Auth/Login.pm b/Bugzilla/Auth/Login.pm
new file mode 100644 (file)
index 0000000..290cb42
--- /dev/null
+++ b/Bugzilla/Auth/Login.pm
@@ -0,0 +1,134 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Auth::Login;
+
+use strict;
+use fields qw();
+
+# Determines whether or not a user can logout. It's really a subroutine,
+# but we implement it here as a constant. Override it in subclasses if
+# that particular type of login method cannot log out.
+use constant can_logout => 1;
+use constant can_login  => 1;
+use constant requires_persistence  => 1;
+use constant requires_verification => 1;
+use constant user_can_create_account => 0;
+use constant is_automatic => 0;
+use constant extern_id_used => 0; 
+
+sub new {
+    my ($class) = @_;
+    my $self = fields::new($class);
+    return $self;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Auth::Login - Gets username/password data from the user.
+
+=head1 DESCRIPTION
+
+Bugzilla::Auth::Login is used to get information that uniquely identifies
+a user and allows us to authorize their Bugzilla access.
+
+It is mostly an abstract class, requiring subclasses to implement
+most methods.
+
+Note that callers outside of the C<Bugzilla::Auth> package should never
+create this object directly. Just create a C<Bugzilla::Auth> object
+and call C<login> on it.
+
+=head1 LOGIN METHODS
+
+These are methods that have to do with getting the actual login data
+from the user or handling a login somehow.
+
+These methods are abstract -- they MUST be implemented by a subclass.
+
+=over 4
+
+=item C<get_login_info()>
+
+Description: Gets a username/password from the user, or some other
+             information that uniquely identifies them.
+Params:      None
+Returns:     A C<$login_data> hashref. (See L<Bugzilla::Auth> for details.)
+             The hashref MUST contain: C<user_id> *or* C<username>
+             If this is a login method that requires verification,
+             the hashref MUST contain C<password>.
+             The hashref MAY contain C<realname> and C<extern_id>.
+
+=item C<fail_nodata()>
+
+Description: This function is called when Bugzilla doesn't get
+             a username/password and the login type is C<LOGIN_REQUIRED>
+             (See L<Bugzilla::Auth> for a description of C<LOGIN_REQUIRED>).
+             That is, this handles C<AUTH_NODATA> in that situation.
+
+             This function MUST stop CGI execution when it is complete.
+             That is, it must call C<exit> or C<ThrowUserError> or some
+             such thing.
+Params:      None
+Returns:     Never Returns.
+
+=back
+
+=head1 INFO METHODS
+
+These are methods that describe the capabilities of this 
+C<Bugzilla::Auth::Login> object. These are all no-parameter
+methods that return either C<true> or C<false>.
+
+=over 4
+
+=item C<can_logout>
+
+Whether or not users can log out if they logged in using this
+object. Defaults to C<true>.
+
+=item C<can_login>
+
+Whether or not users can log in through the web interface using
+this object. Defaults to C<true>.
+
+=item C<requires_persistence>
+
+Whether or not we should send the user a cookie if they logged in with
+this method. Defaults to C<true>.
+
+=item C<requires_verification>
+
+Whether or not we should check the username/password that we
+got from this login method. Defaults to C<true>.
+
+=item C<user_can_create_account>
+
+Whether or not users can create accounts, if this login method is
+currently being used by the system. Defaults to C<false>.
+
+=item C<is_automatic>
+
+True if this login method requires no interaction from the user within
+Bugzilla. (For example, C<Env> auth is "automatic" because the webserver
+just passes us an environment variable on most page requests, and does not
+ask the user for authentication information directly in Bugzilla.) Defaults
+to C<false>.
+
+=item C<extern_id_used>
+
+Whether or not this login method uses the extern_id field. If
+used, users with editusers permission will be be allowed to
+edit the extern_id for all users.
+
+The default value is C<0>.
+
+=back

diff --git a/Bugzilla/Auth/Login/CGI.pm b/Bugzilla/Auth/Login/CGI.pm
new file mode 100644 (file)
index 0000000..47ec556
--- /dev/null
+++ b/Bugzilla/Auth/Login/CGI.pm
@@ -0,0 +1,48 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Auth::Login::CGI;
+use strict;
+use base qw(Bugzilla::Auth::Login);
+use constant user_can_create_account => 1;
+
+use Bugzilla::Constants;
+use Bugzilla::WebService::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+
+sub get_login_info {
+    my ($self) = @_;
+    my $params = Bugzilla->input_params;
+
+    my $username = trim(delete $params->{"Bugzilla_login"});
+    my $password = delete $params->{"Bugzilla_password"};
+
+    if (!defined $username || !defined $password) {
+        return { failure => AUTH_NODATA };
+    }
+
+    return { username => $username, password => $password };
+}
+
+sub fail_nodata {
+    my ($self) = @_;
+    my $cgi = Bugzilla->cgi;
+    my $template = Bugzilla->template;
+
+    if (Bugzilla->usage_mode != USAGE_MODE_BROWSER) {
+        ThrowUserError('login_required');
+    }
+
+    print $cgi->header();
+    $template->process("account/auth/login.html.tmpl",
+                       { 'target' => $cgi->url(-relative=>1) }) 
+        || ThrowTemplateError($template->error());
+    exit;
+}
+
+1;

diff --git a/Bugzilla/Auth/Login/Cookie.pm b/Bugzilla/Auth/Login/Cookie.pm
new file mode 100644 (file)
index 0000000..5d4c827
--- /dev/null
+++ b/Bugzilla/Auth/Login/Cookie.pm
@@ -0,0 +1,78 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Auth::Login::Cookie;
+use strict;
+use base qw(Bugzilla::Auth::Login);
+
+use Bugzilla::Constants;
+use Bugzilla::Util;
+
+use List::Util qw(first);
+
+use constant requires_persistence  => 0;
+use constant requires_verification => 0;
+use constant can_login => 0;
+use constant is_automatic => 1;
+
+# Note that Cookie never consults the Verifier, it always assumes
+# it has a valid DB account or it fails.
+sub get_login_info {
+    my ($self) = @_;
+    my $cgi = Bugzilla->cgi;
+    my $dbh = Bugzilla->dbh;
+
+    my $ip_addr      = remote_ip();
+    my $login_cookie = $cgi->cookie("Bugzilla_logincookie");
+    my $user_id      = $cgi->cookie("Bugzilla_login");
+
+    # If cookies cannot be found, this could mean that they haven't
+    # been made available yet. In this case, look at Bugzilla_cookie_list.
+    unless ($login_cookie) {
+        my $cookie = first {$_->name eq 'Bugzilla_logincookie'}
+                            @{$cgi->{'Bugzilla_cookie_list'}};
+        $login_cookie = $cookie->value if $cookie;
+    }
+    unless ($user_id) {
+        my $cookie = first {$_->name eq 'Bugzilla_login'}
+                            @{$cgi->{'Bugzilla_cookie_list'}};
+        $user_id = $cookie->value if $cookie;
+    }
+
+    if ($login_cookie && $user_id) {
+        # Anything goes for these params - they're just strings which
+        # we're going to verify against the db
+        trick_taint($ip_addr);
+        trick_taint($login_cookie);
+        detaint_natural($user_id);
+
+        my $is_valid =
+          $dbh->selectrow_array('SELECT 1
+                                   FROM logincookies
+                                  WHERE cookie = ?
+                                        AND userid = ?
+                                        AND (ipaddr = ? OR ipaddr IS NULL)',
+                                 undef, ($login_cookie, $user_id, $ip_addr));
+
+        # If the cookie is valid, return a valid username.
+        if ($is_valid) {
+            # If we logged in successfully, then update the lastused 
+            # time on the login cookie
+            $dbh->do("UPDATE logincookies SET lastused = NOW() 
+                       WHERE cookie = ?", undef, $login_cookie);
+            return { user_id => $user_id };
+        }
+    }
+
+    # Either the he cookie is invalid, or we got no cookie. We don't want 
+    # to ever return AUTH_LOGINFAILED, because we don't want Bugzilla to 
+    # actually throw an error when it gets a bad cookie. It should just 
+    # look like there was no cookie to begin with.
+    return { failure => AUTH_NODATA };
+}
+
+1;

diff --git a/Bugzilla/Auth/Login/Env.pm b/Bugzilla/Auth/Login/Env.pm
new file mode 100644 (file)
index 0000000..393ac60
--- /dev/null
+++ b/Bugzilla/Auth/Login/Env.pm
@@ -0,0 +1,40 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Auth::Login::Env;
+use strict;
+use base qw(Bugzilla::Auth::Login);
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+
+use constant can_logout => 0;
+use constant can_login  => 0;
+use constant requires_persistence  => 0;
+use constant requires_verification => 0;
+use constant is_automatic => 1;
+use constant extern_id_used => 1;
+
+sub get_login_info {
+    my ($self) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    my $env_id       = $ENV{Bugzilla->params->{"auth_env_id"}} || '';
+    my $env_email    = $ENV{Bugzilla->params->{"auth_env_email"}} || '';
+    my $env_realname = $ENV{Bugzilla->params->{"auth_env_realname"}} || '';
+
+    return { failure => AUTH_NODATA } if !$env_email;
+
+    return { username => $env_email, extern_id => $env_id, 
+             realname => $env_realname };
+}
+
+sub fail_nodata {
+    ThrowCodeError('env_no_email');
+}
+
+1;

diff --git a/Bugzilla/Auth/Login/Stack.pm b/Bugzilla/Auth/Login/Stack.pm
new file mode 100644 (file)
index 0000000..17a5855
--- /dev/null
+++ b/Bugzilla/Auth/Login/Stack.pm
@@ -0,0 +1,98 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Auth::Login::Stack;
+use strict;
+use base qw(Bugzilla::Auth::Login);
+use fields qw(
+    _stack
+    successful
+);
+use Hash::Util qw(lock_keys);
+use Bugzilla::Hook;
+use Bugzilla::Constants;
+use List::MoreUtils qw(any);
+
+sub new {
+    my $class = shift;
+    my $self = $class->SUPER::new(@_);
+    my $list = shift;
+    my %methods = map { $_ => "Bugzilla/Auth/Login/$_.pm" } split(',', $list);
+    lock_keys(%methods);
+    Bugzilla::Hook::process('auth_login_methods', { modules => \%methods });
+
+    $self->{_stack} = [];
+    foreach my $login_method (split(',', $list)) {
+        my $module = $methods{$login_method};
+        require $module;
+        $module =~ s|/|::|g;
+        $module =~ s/.pm$//;
+        push(@{$self->{_stack}}, $module->new(@_));
+    }
+    return $self;
+}
+
+sub get_login_info {
+    my $self = shift;
+    my $result;
+    foreach my $object (@{$self->{_stack}}) {
+        # See Bugzilla::WebService::Server::JSONRPC for where and why
+        # auth_no_automatic_login is used.
+        if (Bugzilla->request_cache->{auth_no_automatic_login}) {
+            next if $object->is_automatic;
+        }
+        $result = $object->get_login_info(@_);
+        $self->{successful} = $object;
+        
+        # We only carry on down the stack if this method denied all knowledge.
+        last unless ($result->{failure}
+                    && ($result->{failure} eq AUTH_NODATA 
+                       || $result->{failure} eq AUTH_NO_SUCH_USER));
+        
+        # If none of the methods succeed, it's undef.
+        $self->{successful} = undef;
+    }
+    return $result;
+}
+
+sub fail_nodata {
+    my $self = shift;
+    # We fail from the bottom of the stack.
+    my @reverse_stack = reverse @{$self->{_stack}};
+    foreach my $object (@reverse_stack) {
+        # We pick the first object that actually has the method
+        # implemented.
+        if ($object->can('fail_nodata')) {
+            $object->fail_nodata(@_);
+        }
+    }
+}
+
+sub can_login {
+    my ($self) = @_;
+    # We return true if any method can log in.
+    foreach my $object (@{$self->{_stack}}) {
+        return 1 if $object->can_login;
+    }
+    return 0;
+}
+
+sub user_can_create_account {
+    my ($self) = @_;
+    # We return true if any method allows users to create accounts.
+    foreach my $object (@{$self->{_stack}}) {
+        return 1 if $object->user_can_create_account;
+    }
+    return 0;
+}
+
+sub extern_id_used {
+    my ($self) = @_;
+    return any { $_->extern_id_used } @{ $self->{_stack} };
+}
+
+1;

diff --git a/Bugzilla/Auth/Persist/Cookie.pm b/Bugzilla/Auth/Persist/Cookie.pm
new file mode 100644 (file)
index 0000000..ec21208
--- /dev/null
+++ b/Bugzilla/Auth/Persist/Cookie.pm
@@ -0,0 +1,141 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Auth::Persist::Cookie;
+use strict;
+use fields qw();
+
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Token;
+
+use List::Util qw(first);
+
+sub new {
+    my ($class) = @_;
+    my $self = fields::new($class);
+    return $self;
+}
+
+sub persist_login {
+    my ($self, $user) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $cgi = Bugzilla->cgi;
+    my $input_params = Bugzilla->input_params;
+
+    my $ip_addr;
+    if ($input_params->{'Bugzilla_restrictlogin'}) {
+        $ip_addr = remote_ip();
+        # The IP address is valid, at least for comparing with itself in a
+        # subsequent login
+        trick_taint($ip_addr);
+    }
+
+    $dbh->bz_start_transaction();
+
+    my $login_cookie = 
+        Bugzilla::Token::GenerateUniqueToken('logincookies', 'cookie');
+
+    $dbh->do("INSERT INTO logincookies (cookie, userid, ipaddr, lastused)
+              VALUES (?, ?, ?, NOW())",
+              undef, $login_cookie, $user->id, $ip_addr);
+
+    # Issuing a new cookie is a good time to clean up the old
+    # cookies.
+    $dbh->do("DELETE FROM logincookies WHERE lastused < "
+             . $dbh->sql_date_math('LOCALTIMESTAMP(0)', '-',
+                                   MAX_LOGINCOOKIE_AGE, 'DAY'));
+
+    $dbh->bz_commit_transaction();
+
+    # Prevent JavaScript from accessing login cookies.
+    my %cookieargs = ('-httponly' => 1);
+
+    # Remember cookie only if admin has told so
+    # or admin didn't forbid it and user told to remember.
+    if ( Bugzilla->params->{'rememberlogin'} eq 'on' ||
+         (Bugzilla->params->{'rememberlogin'} ne 'off' &&
+          $input_params->{'Bugzilla_remember'} &&
+          $input_params->{'Bugzilla_remember'} eq 'on') ) 
+    {
+        # Not a session cookie, so set an infinite expiry
+        $cookieargs{'-expires'} = 'Fri, 01-Jan-2038 00:00:00 GMT';
+    }
+    if (Bugzilla->params->{'ssl_redirect'}) {
+        # Make these cookies only be sent to us by the browser during 
+        # HTTPS sessions, if we're using SSL.
+        $cookieargs{'-secure'} = 1;
+    }
+
+    $cgi->send_cookie(-name => 'Bugzilla_login',
+                      -value => $user->id,
+                      %cookieargs);
+    $cgi->send_cookie(-name => 'Bugzilla_logincookie',
+                      -value => $login_cookie,
+                      %cookieargs);
+}
+
+sub logout {
+    my ($self, $param) = @_;
+
+    my $dbh = Bugzilla->dbh;
+    my $cgi = Bugzilla->cgi;
+    $param = {} unless $param;
+    my $user = $param->{user} || Bugzilla->user;
+    my $type = $param->{type} || LOGOUT_ALL;
+
+    if ($type == LOGOUT_ALL) {
+        $dbh->do("DELETE FROM logincookies WHERE userid = ?",
+                 undef, $user->id);
+        return;
+    }
+
+    # The LOGOUT_*_CURRENT options require the current login cookie.
+    # If a new cookie has been issued during this run, that's the current one.
+    # If not, it's the one we've received.
+    my $cookie = first {$_->name eq 'Bugzilla_logincookie'}
+                       @{$cgi->{'Bugzilla_cookie_list'}};
+    my $login_cookie;
+    if ($cookie) {
+        $login_cookie = $cookie->value;
+    }
+    else {
+        $login_cookie = $cgi->cookie("Bugzilla_logincookie");
+    }
+    trick_taint($login_cookie);
+
+    # These queries use both the cookie ID and the user ID as keys. Even
+    # though we know the userid must match, we still check it in the SQL
+    # as a sanity check, since there is no locking here, and if the user
+    # logged out from two machines simultaneously, while someone else
+    # logged in and got the same cookie, we could be logging the other
+    # user out here. Yes, this is very very very unlikely, but why take
+    # chances? - bbaetz
+    if ($type == LOGOUT_KEEP_CURRENT) {
+        $dbh->do("DELETE FROM logincookies WHERE cookie != ? AND userid = ?",
+                 undef, $login_cookie, $user->id);
+    } elsif ($type == LOGOUT_CURRENT) {
+        $dbh->do("DELETE FROM logincookies WHERE cookie = ? AND userid = ?",
+                 undef, $login_cookie, $user->id);
+    } else {
+        die("Invalid type $type supplied to logout()");
+    }
+
+    if ($type != LOGOUT_KEEP_CURRENT) {
+        clear_browser_cookies();
+    }
+
+}
+
+sub clear_browser_cookies {
+    my $cgi = Bugzilla->cgi;
+    $cgi->remove_cookie('Bugzilla_login');
+    $cgi->remove_cookie('Bugzilla_logincookie');
+    $cgi->remove_cookie('sudo');
+}
+
+1;

diff --git a/Bugzilla/Auth/Verify.pm b/Bugzilla/Auth/Verify.pm
new file mode 100644 (file)
index 0000000..ae256dd
--- /dev/null
+++ b/Bugzilla/Auth/Verify.pm
@@ -0,0 +1,235 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Auth::Verify;
+
+use strict;
+use fields qw();
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::User;
+use Bugzilla::Util;
+
+use constant user_can_create_account => 1;
+use constant extern_id_used => 0;
+
+sub new {
+    my ($class, $login_type) = @_;
+    my $self = fields::new($class);
+    return $self;
+}
+
+sub can_change_password {
+    return $_[0]->can('change_password');
+}
+
+sub create_or_update_user {
+    my ($self, $params) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    my $extern_id = $params->{extern_id};
+    my $username  = $params->{bz_username} || $params->{username};
+    my $password  = $params->{password} || '*';
+    my $real_name = $params->{realname} || '';
+    my $user_id   = $params->{user_id};
+
+    # A passed-in user_id always overrides anything else, for determining
+    # what account we should return.
+    if (!$user_id) {
+        my $username_user_id = login_to_id($username || '');
+        my $extern_user_id;
+        if ($extern_id) {
+            trick_taint($extern_id);
+            $extern_user_id = $dbh->selectrow_array('SELECT userid
+                 FROM profiles WHERE extern_id = ?', undef, $extern_id);
+        }
+
+        # If we have both a valid extern_id and a valid username, and they are
+        # not the same id, then we have a conflict.
+        if ($username_user_id && $extern_user_id
+            && $username_user_id ne $extern_user_id)
+        {
+            my $extern_name = Bugzilla::User->new($extern_user_id)->login;
+            return { failure => AUTH_ERROR, error => "extern_id_conflict",
+                     details => {extern_id   => $extern_id,
+                                 extern_user => $extern_name,
+                                 username    => $username} };
+        }
+
+        # If we have a valid username, but no valid id,
+        # then we have to create the user. This happens when we're
+        # passed only a username, and that username doesn't exist already.
+        if ($username && !$username_user_id && !$extern_user_id) {
+            validate_email_syntax($username)
+              || return { failure => AUTH_ERROR, 
+                          error   => 'auth_invalid_email',
+                          details => {addr => $username} };
+            # Usually we'd call validate_password, but external authentication
+            # systems might follow different standards than ours. So in this
+            # place here, we call trick_taint without checks.
+            trick_taint($password);
+
+            # XXX Theoretically this could fail with an error, but the fix for
+            # that is too involved to be done right now.
+            my $user = Bugzilla::User->create({ 
+                login_name    => $username, 
+                cryptpassword => $password,
+                realname      => $real_name});
+            $username_user_id = $user->id;
+        }
+
+        # If we have a valid username id and an extern_id, but no valid
+        # extern_user_id, then we have to set the user's extern_id.
+        if ($extern_id && $username_user_id && !$extern_user_id) {
+            $dbh->do('UPDATE profiles SET extern_id = ? WHERE userid = ?',
+                     undef, $extern_id, $username_user_id);
+        }
+
+        # Finally, at this point, one of these will give us a valid user id.
+        $user_id = $extern_user_id || $username_user_id;
+    }
+
+    # If we still don't have a valid user_id, then we weren't passed
+    # enough information in $params, and we should die right here.
+    ThrowCodeError('bad_arg', {argument => 'params', function =>
+        'Bugzilla::Auth::Verify::create_or_update_user'})
+        unless $user_id;
+
+    my $user = new Bugzilla::User($user_id);
+
+    # Now that we have a valid User, we need to see if any data has to be
+    # updated.
+    if ($username && lc($user->login) ne lc($username)) {
+        validate_email_syntax($username)
+          || return { failure => AUTH_ERROR, error => 'auth_invalid_email',
+                      details => {addr => $username} };
+        $user->set_login($username);
+    }
+    if ($real_name && $user->name ne $real_name) {
+        # $real_name is more than likely tainted, but we only use it
+        # in a placeholder and we never use it after this.
+        trick_taint($real_name);
+        $user->set_name($real_name);
+    }
+    $user->update();
+
+    return { user => $user };
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Auth::Verify - An object that verifies usernames and passwords.
+
+=head1 DESCRIPTION
+
+Bugzilla::Auth::Verify provides the "Verifier" part of the Bugzilla 
+login process. (For details, see the "STRUCTURE" section of 
+L<Bugzilla::Auth>.)
+
+It is mostly an abstract class, requiring subclasses to implement
+most methods.
+
+Note that callers outside of the C<Bugzilla::Auth> package should never
+create this object directly. Just create a C<Bugzilla::Auth> object
+and call C<login> on it.
+
+=head1 VERIFICATION METHODS
+
+These are the methods that have to do with the actual verification.
+
+Subclasses MUST implement these methods.
+
+=over 4
+
+=item C<check_credentials($login_data)>
+
+Description: Checks whether or not a username is valid.
+Params:      $login_data - A C<$login_data> hashref, as described in
+                           L<Bugzilla::Auth>.
+                           This C<$login_data> hashref MUST contain
+                           C<username>, and SHOULD also contain
+                           C<password>.
+Returns:     A C<$login_data> hashref with C<bz_username> set. This
+             method may also set C<realname>. It must avoid changing
+             anything that is already set.
+
+=back
+
+=head1 MODIFICATION METHODS
+
+These are methods that change data in the actual authentication backend.
+
+These methods are optional, they do not have to be implemented by
+subclasses.
+
+=over 4
+
+=item C<create_or_update_user($login_data)>
+
+Description: Automatically creates a user account in the database
+             if it doesn't already exist, or updates the account
+             data if C<$login_data> contains newer information.
+
+Params:      $login_data - A C<$login_data> hashref, as described in
+                           L<Bugzilla::Auth>.
+                           This C<$login_data> hashref MUST contain
+                           either C<user_id>, C<bz_username>, or
+                           C<username>. If both C<username> and C<bz_username>
+                           are specified, C<bz_username> is used as the
+                           login name of the user to create in the database.
+                           It MAY also contain C<extern_id>, in which
+                           case it still MUST contain C<bz_username> or
+                           C<username>.
+                           It MAY contain C<password> and C<realname>.
+
+Returns:     A hashref with one element, C<user>, which is a
+             L<Bugzilla::User> object. May also return a login error
+             as described in L<Bugzilla::Auth>.
+
+Note:        This method is not abstract, it is actually implemented
+             and creates accounts in the Bugzilla database. Subclasses
+             should probably all call the C<Bugzilla::Auth::Verify>
+             version of this function at the end of their own
+             C<create_or_update_user>.
+
+=item C<change_password($user, $password)>
+
+Description: Modifies the user's password in the authentication backend.
+Params:      $user - A L<Bugzilla::User> object representing the user
+                     whose password we want to change.
+             $password - The user's new password.
+Returns:     Nothing.
+
+=back
+
+=head1 INFO METHODS
+
+These are methods that describe the capabilities of this object.
+These are all no-parameter methods that return either C<true> or 
+C<false>.
+
+=over 4
+
+=item C<user_can_create_account>
+
+Whether or not users can manually create accounts in this type of
+account source. Defaults to C<true>.
+
+=item C<extern_id_used>
+
+Whether or not this verifier method uses the extern_id field. If
+used, users with editusers permission will be be allowed to
+edit the extern_id for all users.
+
+The default value is C<false>.
+
+=back

diff --git a/Bugzilla/Auth/Verify/DB.pm b/Bugzilla/Auth/Verify/DB.pm
new file mode 100644 (file)
index 0000000..6ca04f2
--- /dev/null
+++ b/Bugzilla/Auth/Verify/DB.pm
@@ -0,0 +1,86 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Auth::Verify::DB;
+use strict;
+use base qw(Bugzilla::Auth::Verify);
+
+use Bugzilla::Constants;
+use Bugzilla::Token;
+use Bugzilla::Util;
+use Bugzilla::User;
+
+sub check_credentials {
+    my ($self, $login_data) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    my $username = $login_data->{username};
+    my $user = new Bugzilla::User({ name => $username });
+
+    return { failure => AUTH_NO_SUCH_USER } unless $user;
+
+    $login_data->{user} = $user;
+    $login_data->{bz_username} = $user->login;
+
+    if ($user->account_is_locked_out) {
+        return { failure => AUTH_LOCKOUT, user => $user };
+    }
+
+    my $password = $login_data->{password};
+    my $real_password_crypted = $user->cryptpassword;
+
+    # Using the internal crypted password as the salt,
+    # crypt the password the user entered.
+    my $entered_password_crypted = bz_crypt($password, $real_password_crypted);
+
+    if ($entered_password_crypted ne $real_password_crypted) {
+        # Record the login failure
+        $user->note_login_failure();
+
+        # Immediately check if we are locked out
+        if ($user->account_is_locked_out) {
+            return { failure => AUTH_LOCKOUT, user => $user,
+                     just_locked_out => 1 };
+        }
+
+        return { failure => AUTH_LOGINFAILED,
+                 failure_count => scalar(@{ $user->account_ip_login_failures }),
+               };
+    } 
+
+    # Force the user to type a longer password if it's too short.
+    if (length($password) < USER_PASSWORD_MIN_LENGTH) {
+        return { failure => AUTH_ERROR, user_error => 'password_current_too_short',
+                 details => { locked_user => $user } };
+    }
+
+    # The user's credentials are okay, so delete any outstanding
+    # password tokens or login failures they may have generated.
+    Bugzilla::Token::DeletePasswordTokens($user->id, "user_logged_in");
+    $user->clear_login_failures();
+
+    # If their old password was using crypt() or some different hash
+    # than we're using now, convert the stored password to using
+    # whatever hashing system we're using now.
+    my $current_algorithm = PASSWORD_DIGEST_ALGORITHM;
+    if ($real_password_crypted !~ /{\Q$current_algorithm\E}$/) {
+        $user->set_password($password);
+        $user->update();
+    }
+
+    return $login_data;
+}
+
+sub change_password {
+    my ($self, $user, $password) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $cryptpassword = bz_crypt($password);
+    $dbh->do("UPDATE profiles SET cryptpassword = ? WHERE userid = ?",
+             undef, $cryptpassword, $user->id);
+}
+
+1;

diff --git a/Bugzilla/Auth/Verify/LDAP.pm b/Bugzilla/Auth/Verify/LDAP.pm
new file mode 100644 (file)
index 0000000..5704c58
--- /dev/null
+++ b/Bugzilla/Auth/Verify/LDAP.pm
@@ -0,0 +1,178 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Auth::Verify::LDAP;
+use strict;
+use base qw(Bugzilla::Auth::Verify);
+use fields qw(
+    ldap
+);
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::User;
+use Bugzilla::Util;
+
+use Net::LDAP;
+use Net::LDAP::Util qw(escape_filter_value);
+
+use constant admin_can_create_account => 0;
+use constant user_can_create_account  => 0;
+
+sub check_credentials {
+    my ($self, $params) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    # We need to bind anonymously to the LDAP server.  This is
+    # because we need to get the Distinguished Name of the user trying
+    # to log in.  Some servers (such as iPlanet) allow you to have unique
+    # uids spread out over a subtree of an area (such as "People"), so
+    # just appending the Base DN to the uid isn't sufficient to get the
+    # user's DN.  For servers which don't work this way, there will still
+    # be no harm done.
+    $self->_bind_ldap_for_search();
+
+    # Now, we verify that the user exists, and get a LDAP Distinguished
+    # Name for the user.
+    my $username = $params->{username};
+    my $dn_result = $self->ldap->search(_bz_search_params($username),
+                                        attrs  => ['dn']);
+    return { failure => AUTH_ERROR, error => "ldap_search_error",
+             details => {errstr => $dn_result->error, username => $username}
+    } if $dn_result->code;
+
+    return { failure => AUTH_NO_SUCH_USER } if !$dn_result->count;
+
+    my $dn = $dn_result->shift_entry->dn;
+
+    # Check the password.   
+    my $pw_result = $self->ldap->bind($dn, password => $params->{password});
+    return { failure => AUTH_LOGINFAILED } if $pw_result->code;
+
+    # And now we fill in the user's details.
+
+    # First try the search as the (already bound) user in question.
+    my $user_entry;
+    my $error_string;
+    my $detail_result = $self->ldap->search(_bz_search_params($username));
+    if ($detail_result->code) {
+        # Stash away the original error, just in case
+        $error_string = $detail_result->error;
+    } else {
+        $user_entry = $detail_result->shift_entry;
+    }
+
+    # If that failed (either because the search failed, or returned no
+    # results) then try re-binding as the initial search user, but only
+    # if the LDAPbinddn parameter is set.
+    if (!$user_entry && Bugzilla->params->{"LDAPbinddn"}) {
+        $self->_bind_ldap_for_search();
+
+        $detail_result = $self->ldap->search(_bz_search_params($username));
+        if (!$detail_result->code) {
+            $user_entry = $detail_result->shift_entry;
+        }
+    }
+
+    # If we *still* don't have anything in $user_entry then give up.
+    return { failure => AUTH_ERROR, error => "ldap_search_error",
+             details => {errstr => $error_string, username => $username}
+    } if !$user_entry;
+
+
+    my $mail_attr = Bugzilla->params->{"LDAPmailattribute"};
+    if ($mail_attr) {
+        if (!$user_entry->exists($mail_attr)) {
+            return { failure => AUTH_ERROR,
+                     error   => "ldap_cannot_retreive_attr",
+                     details => {attr => $mail_attr} };
+        }
+
+        my @emails = $user_entry->get_value($mail_attr);
+
+        # Default to the first email address returned.
+        $params->{bz_username} = $emails[0];
+
+        if (@emails > 1) {
+            # Cycle through the adresses and check if they're Bugzilla logins.
+            # Use the first one that returns a valid id. 
+            foreach my $email (@emails) {
+                if ( login_to_id($email) ) {
+                    $params->{bz_username} = $email;
+                    last;
+                }
+            }
+        }
+
+    } else {
+        $params->{bz_username} = $username;
+    }
+
+    $params->{realname}  ||= $user_entry->get_value("displayName");
+    $params->{realname}  ||= $user_entry->get_value("cn");
+
+    $params->{extern_id} = $username;
+
+    return $params;
+}
+
+sub _bz_search_params {
+    my ($username) = @_;
+    $username = escape_filter_value($username);
+    return (base   => Bugzilla->params->{"LDAPBaseDN"},
+            scope  => "sub",
+            filter => '(&(' . Bugzilla->params->{"LDAPuidattribute"} 
+                      . "=$username)"
+                      . Bugzilla->params->{"LDAPfilter"} . ')');
+}
+
+sub _bind_ldap_for_search {
+    my ($self) = @_;
+    my $bind_result;
+    if (Bugzilla->params->{"LDAPbinddn"}) {
+        my ($LDAPbinddn,$LDAPbindpass) = 
+            split(":",Bugzilla->params->{"LDAPbinddn"});
+        $bind_result = 
+            $self->ldap->bind($LDAPbinddn, password => $LDAPbindpass);
+    }
+    else {
+        $bind_result = $self->ldap->bind();
+    }
+    ThrowCodeError("ldap_bind_failed", {errstr => $bind_result->error})
+        if $bind_result->code;
+}
+
+# We can't just do this in new(), because we're not allowed to throw any
+# error from anywhere under Bugzilla::Auth::new -- otherwise we
+# could create a situation where the admin couldn't get to editparams
+# to fix his mistake. (Because Bugzilla->login always calls 
+# Bugzilla::Auth->new, and almost every page calls Bugzilla->login.)
+sub ldap {
+    my ($self) = @_;
+    return $self->{ldap} if $self->{ldap};
+
+    my @servers = split(/[\s,]+/, Bugzilla->params->{"LDAPserver"});
+    ThrowCodeError("ldap_server_not_defined") unless @servers;
+
+    foreach (@servers) {
+        $self->{ldap} = new Net::LDAP(trim($_));
+        last if $self->{ldap};
+    }
+    ThrowCodeError("ldap_connect_failed", { server => join(", ", @servers) }) 
+        unless $self->{ldap};
+
+    # try to start TLS if needed
+    if (Bugzilla->params->{"LDAPstarttls"}) {
+        my $mesg = $self->{ldap}->start_tls();
+        ThrowCodeError("ldap_start_tls_failed", { error => $mesg->error() })
+            if $mesg->code();
+    }
+
+    return $self->{ldap};
+}
+
+1;

diff --git a/Bugzilla/Auth/Verify/RADIUS.pm b/Bugzilla/Auth/Verify/RADIUS.pm
new file mode 100644 (file)
index 0000000..d6c4db8
--- /dev/null
+++ b/Bugzilla/Auth/Verify/RADIUS.pm
@@ -0,0 +1,51 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Auth::Verify::RADIUS;
+use strict;
+use base qw(Bugzilla::Auth::Verify);
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Util;
+
+use Authen::Radius;
+
+use constant admin_can_create_account => 0;
+use constant user_can_create_account  => 0;
+
+sub check_credentials {
+    my ($self, $params) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $address_suffix = Bugzilla->params->{'RADIUS_email_suffix'};
+    my $username = $params->{username};
+
+    # If we're using RADIUS_email_suffix, we may need to cut it off from
+    # the login name.
+    if ($address_suffix) {
+        $username =~ s/\Q$address_suffix\E$//i;
+    }
+
+    # Create RADIUS object.
+    my $radius =
+        new Authen::Radius(Host   => Bugzilla->params->{'RADIUS_server'},
+                           Secret => Bugzilla->params->{'RADIUS_secret'})
+        || return { failure => AUTH_ERROR, error => 'radius_preparation_error',
+                    details => {errstr => Authen::Radius::strerror() } };
+
+    # Check the password.
+    $radius->check_pwd($username, $params->{password},
+                       Bugzilla->params->{'RADIUS_NAS_IP'} || undef)
+        || return { failure => AUTH_LOGINFAILED };
+
+    # Build the user account's e-mail address.
+    $params->{bz_username} = $username . $address_suffix;
+
+    return $params;
+}
+
+1;

diff --git a/Bugzilla/Auth/Verify/Stack.pm b/Bugzilla/Auth/Verify/Stack.pm
new file mode 100644 (file)
index 0000000..0930d57
--- /dev/null
+++ b/Bugzilla/Auth/Verify/Stack.pm
@@ -0,0 +1,88 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Auth::Verify::Stack;
+use strict;
+use base qw(Bugzilla::Auth::Verify);
+use fields qw(
+    _stack
+    successful
+);
+
+use Bugzilla::Hook;
+
+use Hash::Util qw(lock_keys);
+use List::MoreUtils qw(any);
+
+sub new {
+    my $class = shift;
+    my $list = shift;
+    my $self = $class->SUPER::new(@_);
+    my %methods = map { $_ => "Bugzilla/Auth/Verify/$_.pm" } split(',', $list);
+    lock_keys(%methods);
+    Bugzilla::Hook::process('auth_verify_methods', { modules => \%methods });
+
+    $self->{_stack} = [];
+    foreach my $verify_method (split(',', $list)) {
+        my $module = $methods{$verify_method};
+        require $module;
+        $module =~ s|/|::|g;
+        $module =~ s/.pm$//;
+        push(@{$self->{_stack}}, $module->new(@_));
+    }
+    return $self;
+}
+
+sub can_change_password {
+    my ($self) = @_;
+    # We return true if any method can change passwords.
+    foreach my $object (@{$self->{_stack}}) {
+        return 1 if $object->can_change_password;
+    }
+    return 0;
+}
+
+sub check_credentials {
+    my $self = shift;
+    my $result;
+    foreach my $object (@{$self->{_stack}}) {
+        $result = $object->check_credentials(@_);
+        $self->{successful} = $object;
+        last if !$result->{failure};
+        # So that if none of them succeed, it's undef.
+        $self->{successful} = undef;
+    }
+    # Returns the result at the bottom of the stack if they all fail.
+    return $result;
+}
+
+sub create_or_update_user {
+    my $self = shift;
+    my $result;
+    foreach my $object (@{$self->{_stack}}) {
+        $result = $object->create_or_update_user(@_);
+        last if !$result->{failure};
+    }
+    # Returns the result at the bottom of the stack if they all fail.
+    return $result;
+}
+
+sub user_can_create_account {
+    my ($self) = @_;
+    # We return true if any method allows the user to create an account.
+    foreach my $object (@{$self->{_stack}}) {
+        return 1 if $object->user_can_create_account;
+    }
+    return 0;
+}
+
+sub extern_id_used {
+    my ($self) = @_;
+    return any { $_->extern_id_used } @{ $self->{_stack} };
+}
+
+1;

diff --git a/Bugzilla/Bug.pm b/Bugzilla/Bug.pm
new file mode 100644 (file)
index 0000000..4d11813
--- /dev/null
+++ b/Bugzilla/Bug.pm
@@ -0,0 +1,4313 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Bug;
+
+use strict;
+
+use Bugzilla::Attachment;
+use Bugzilla::Constants;
+use Bugzilla::Field;
+use Bugzilla::Flag;
+use Bugzilla::FlagType;
+use Bugzilla::Hook;
+use Bugzilla::Keyword;
+use Bugzilla::Milestone;
+use Bugzilla::User;
+use Bugzilla::Util;
+use Bugzilla::Version;
+use Bugzilla::Error;
+use Bugzilla::Product;
+use Bugzilla::Component;
+use Bugzilla::Group;
+use Bugzilla::Status;
+use Bugzilla::Comment;
+use Bugzilla::BugUrl;
+
+use List::MoreUtils qw(firstidx uniq part);
+use List::Util qw(min max first);
+use Storable qw(dclone);
+use URI;
+use URI::QueryParam;
+use Scalar::Util qw(blessed);
+
+use base qw(Bugzilla::Object Exporter);
+@Bugzilla::Bug::EXPORT = qw(
+    bug_alias_to_id
+    LogActivityEntry
+    editable_bug_fields
+);
+
+#####################################################################
+# Constants
+#####################################################################
+
+use constant DB_TABLE   => 'bugs';
+use constant ID_FIELD   => 'bug_id';
+use constant NAME_FIELD => 'alias';
+use constant LIST_ORDER => ID_FIELD;
+# Bugs have their own auditing table, bugs_activity.
+use constant AUDIT_CREATES => 0;
+use constant AUDIT_UPDATES => 0;
+
+# This is a sub because it needs to call other subroutines.
+sub DB_COLUMNS {
+    my $dbh = Bugzilla->dbh;
+    my @custom = grep {$_->type != FIELD_TYPE_MULTI_SELECT}
+                      Bugzilla->active_custom_fields;
+    my @custom_names = map {$_->name} @custom;
+
+    my @columns = (qw(
+        alias
+        assigned_to
+        bug_file_loc
+        bug_id
+        bug_severity
+        bug_status
+        cclist_accessible
+        component_id
+        delta_ts
+        estimated_time
+        everconfirmed
+        lastdiffed
+        op_sys
+        priority
+        product_id
+        qa_contact
+        remaining_time
+        rep_platform
+        reporter_accessible
+        resolution
+        short_desc
+        status_whiteboard
+        target_milestone
+        version
+    ),
+    'reporter    AS reporter_id',
+    $dbh->sql_date_format('creation_ts', '%Y.%m.%d %H:%i') . ' AS creation_ts',
+    $dbh->sql_date_format('deadline', '%Y-%m-%d') . ' AS deadline',
+    @custom_names);
+    
+    Bugzilla::Hook::process("bug_columns", { columns => \@columns });
+    
+    return @columns;
+}
+
+sub VALIDATORS {
+
+    my $validators = {
+        alias          => \&_check_alias,
+        assigned_to    => \&_check_assigned_to,
+        blocked        => \&_check_dependencies,
+        bug_file_loc   => \&_check_bug_file_loc,
+        bug_severity   => \&_check_select_field,
+        bug_status     => \&_check_bug_status,
+        cc             => \&_check_cc,
+        comment        => \&_check_comment,
+        component      => \&_check_component,
+        creation_ts    => \&_check_creation_ts,
+        deadline       => \&_check_deadline,
+        dependson      => \&_check_dependencies,
+        dup_id         => \&_check_dup_id,
+        estimated_time => \&_check_time_field,
+        everconfirmed  => \&Bugzilla::Object::check_boolean,
+        groups         => \&_check_groups,
+        keywords       => \&_check_keywords,
+        op_sys         => \&_check_select_field,
+        priority       => \&_check_priority,
+        product        => \&_check_product,
+        qa_contact     => \&_check_qa_contact,
+        remaining_time => \&_check_time_field,
+        rep_platform   => \&_check_select_field,
+        resolution     => \&_check_resolution,
+        short_desc     => \&_check_short_desc,
+        status_whiteboard => \&_check_status_whiteboard,
+        target_milestone  => \&_check_target_milestone,
+        version           => \&_check_version,
+
+        cclist_accessible   => \&Bugzilla::Object::check_boolean,
+        reporter_accessible => \&Bugzilla::Object::check_boolean,
+    };
+
+    # Set up validators for custom fields.    
+    foreach my $field (Bugzilla->active_custom_fields) {
+        my $validator;
+        if ($field->type == FIELD_TYPE_SINGLE_SELECT) {
+            $validator = \&_check_select_field;
+        }
+        elsif ($field->type == FIELD_TYPE_MULTI_SELECT) {
+            $validator = \&_check_multi_select_field;
+        }
+        elsif ($field->type == FIELD_TYPE_DATETIME) {
+            $validator = \&_check_datetime_field;
+        }
+        elsif ($field->type == FIELD_TYPE_FREETEXT) {
+            $validator = \&_check_freetext_field;
+        }
+        elsif ($field->type == FIELD_TYPE_BUG_ID) {
+            $validator = \&_check_bugid_field;
+        }
+        elsif ($field->type == FIELD_TYPE_TEXTAREA) {
+            $validator = \&_check_textarea_field;
+        }
+        else {
+            $validator = \&_check_default_field;
+        }
+        $validators->{$field->name} = $validator;
+    }
+
+    return $validators;
+};
+
+sub VALIDATOR_DEPENDENCIES {
+    my $cache = Bugzilla->request_cache;
+    return $cache->{bug_validator_dependencies} 
+        if $cache->{bug_validator_dependencies};
+
+    my %deps = (
+        assigned_to      => ['component'],
+        blocked          => ['product'],
+        bug_status       => ['product', 'comment', 'target_milestone'],
+        cc               => ['component'],
+        comment          => ['creation_ts'],
+        component        => ['product'],
+        dependson        => ['product'],
+        dup_id           => ['bug_status', 'resolution'],
+        groups           => ['product'],
+        keywords         => ['product'],
+        resolution       => ['bug_status', 'dependson'],
+        qa_contact       => ['component'],
+        target_milestone => ['product'],
+        version          => ['product'],
+    );
+
+    foreach my $field (@{ Bugzilla->fields }) {
+        $deps{$field->name} = [ $field->visibility_field->name ]
+            if $field->{visibility_field_id};
+    }
+
+    $cache->{bug_validator_dependencies} = \%deps;
+    return \%deps;
+};
+
+sub UPDATE_COLUMNS {
+    my @custom = grep {$_->type != FIELD_TYPE_MULTI_SELECT}
+                      Bugzilla->active_custom_fields;
+    my @custom_names = map {$_->name} @custom;
+    my @columns = qw(
+        alias
+        assigned_to
+        bug_file_loc
+        bug_severity
+        bug_status
+        cclist_accessible
+        component_id
+        deadline
+        estimated_time
+        everconfirmed
+        op_sys
+        priority
+        product_id
+        qa_contact
+        remaining_time
+        rep_platform
+        reporter_accessible
+        resolution
+        short_desc
+        status_whiteboard
+        target_milestone
+        version
+    );
+    push(@columns, @custom_names);
+    return @columns;
+};
+
+use constant NUMERIC_COLUMNS => qw(
+    estimated_time
+    remaining_time
+);
+
+sub DATE_COLUMNS {
+    my @fields = @{ Bugzilla->fields({ type => FIELD_TYPE_DATETIME }) };
+    return map { $_->name } @fields;
+}
+
+# Used in LogActivityEntry(). Gives the max length of lines in the
+# activity table.
+use constant MAX_LINE_LENGTH => 254;
+
+# This maps the names of internal Bugzilla bug fields to things that would
+# make sense to somebody who's not intimately familiar with the inner workings
+# of Bugzilla. (These are the field names that the WebService and email_in.pl
+# use.)
+use constant FIELD_MAP => {
+    blocks           => 'blocked',
+    cc_accessible    => 'cclist_accessible',
+    commentprivacy   => 'comment_is_private',
+    creation_time    => 'creation_ts',
+    creator          => 'reporter',
+    description      => 'comment',
+    depends_on       => 'dependson',
+    dupe_of          => 'dup_id',
+    id               => 'bug_id',
+    is_confirmed     => 'everconfirmed',
+    is_cc_accessible => 'cclist_accessible',
+    is_creator_accessible => 'reporter_accessible',
+    last_change_time => 'delta_ts',
+    platform         => 'rep_platform',
+    severity         => 'bug_severity',
+    status           => 'bug_status',
+    summary          => 'short_desc',
+    url              => 'bug_file_loc',
+    whiteboard       => 'status_whiteboard',
+
+    # These are special values for the WebService Bug.search method.
+    limit            => 'LIMIT',
+    offset           => 'OFFSET',
+};
+
+use constant REQUIRED_FIELD_MAP => {
+    product_id   => 'product',
+    component_id => 'component',
+};
+
+# Creation timestamp is here because it needs to be validated
+# but it can be NULL in the database (see comments in create above)
+#
+# Target Milestone is here because it has a default that the validator
+# creates (product.defaultmilestone) that is different from the database
+# default.
+#
+# CC is here because it is a separate table, and has a validator-created
+# default of the component initialcc.
+#
+# QA Contact is allowed to be NULL in the database, so it wouldn't normally
+# be caught by _required_create_fields. However, it always has to be validated,
+# because it has a default of the component.defaultqacontact.
+#
+# Groups are in a separate table, but must always be validated so that
+# mandatory groups get set on bugs.
+use constant EXTRA_REQUIRED_FIELDS => qw(creation_ts target_milestone cc qa_contact groups);
+
+#####################################################################
+
+# This and "new" catch every single way of creating a bug, so that we
+# can call _create_cf_accessors.
+sub _do_list_select {
+    my $invocant = shift;
+    $invocant->_create_cf_accessors();
+    return $invocant->SUPER::_do_list_select(@_);
+}
+
+sub new {
+    my $invocant = shift;
+    my $class = ref($invocant) || $invocant;
+    my $param = shift;
+
+    $class->_create_cf_accessors();
+
+    # Remove leading "#" mark if we've just been passed an id.
+    if (!ref $param && $param =~ /^#(\d+)$/) {
+        $param = $1;
+    }
+
+    # If we get something that looks like a word (not a number),
+    # make it the "name" param.
+    if (!defined $param || (!ref($param) && $param !~ /^\d+$/)) {
+        if ($param) {
+            $param = { name => $param };
+        }
+        else {
+            # We got something that's not a number.
+            my $error_self = {};
+            bless $error_self, $class;
+            $error_self->{'bug_id'} = $param;
+            $error_self->{'error'}  = 'InvalidBugId';
+            return $error_self;
+        }
+    }
+
+    unshift @_, $param;
+    my $self = $class->SUPER::new(@_);
+
+    # Bugzilla::Bug->new always returns something, but sets $self->{error}
+    # if the bug wasn't found in the database.
+    if (!$self) {
+        my $error_self = {};
+        if (ref $param) {
+            $error_self->{bug_id} = $param->{name};
+            $error_self->{error}  = 'InvalidBugId';
+        }
+        else {
+            $error_self->{bug_id} = $param;
+            $error_self->{error}  = 'NotFound';
+        }
+        bless $error_self, $class;
+        return $error_self;
+    }
+
+    return $self;
+}
+
+sub check {
+    my $class = shift;
+    my ($id, $field) = @_;
+
+    ThrowUserError('improper_bug_id_field_value', { field => $field }) unless defined $id;
+
+    # Bugzilla::Bug throws lots of special errors, so we don't call
+    # SUPER::check, we just call our new and do our own checks.
+    $id = trim($id);
+    my $self = $class->new($id);
+
+    if ($self->{error}) {
+        # For error messages, use the id that was returned by new(), because
+        # it's cleaned up.
+        $id = $self->id;
+
+        if ($self->{error} eq 'NotFound') {
+             ThrowUserError("bug_id_does_not_exist", { bug_id => $id });
+        }
+        if ($self->{error} eq 'InvalidBugId') {
+            ThrowUserError("improper_bug_id_field_value",
+                              { bug_id => $id,
+                                field  => $field });
+        }
+    }
+
+    unless ($field && $field =~ /^(dependson|blocked|dup_id)$/) {
+        $self->check_is_visible($id);
+    }
+    return $self;
+}
+
+sub check_for_edit {
+    my $class = shift;
+    my $bug = $class->check(@_);
+
+    Bugzilla->user->can_edit_product($bug->product_id)
+        || ThrowUserError("product_edit_denied", { product => $bug->product });
+
+    return $bug;
+}
+
+sub check_is_visible {
+    my ($self, $input_id) = @_;
+    $input_id ||= $self->id;
+    my $user = Bugzilla->user;
+
+    if (!$user->can_see_bug($self->id)) {
+        # The error the user sees depends on whether or not they are
+        # logged in (i.e. $user->id contains the user's positive integer ID).
+        # If we are validating an alias, then use it in the error message
+        # instead of its corresponding bug ID, to not disclose it.
+        if ($user->id) {
+            ThrowUserError("bug_access_denied", { bug_id => $input_id });
+        } else {
+            ThrowUserError("bug_access_query", { bug_id => $input_id });
+        }
+    }
+}
+
+sub match {
+    my $class = shift;
+    my ($params) = @_;
+
+    # Allow matching certain fields by name (in addition to matching by ID).
+    my %translate_fields = (
+        assigned_to => 'Bugzilla::User',
+        qa_contact  => 'Bugzilla::User',
+        reporter    => 'Bugzilla::User',
+        product     => 'Bugzilla::Product',
+        component   => 'Bugzilla::Component',
+    );
+    my %translated;
+
+    foreach my $field (keys %translate_fields) {
+        my @ids;
+        # Convert names to ids. We use "exists" everywhere since people can
+        # legally specify "undef" to mean IS NULL (even though most of these
+        # fields can't be NULL, people can still specify it...).
+        if (exists $params->{$field}) {
+            my $names = $params->{$field};
+            my $type = $translate_fields{$field};
+            my $param = $type eq 'Bugzilla::User' ? 'login_name' : 'name';
+            # We call Bugzilla::Object::match directly to avoid the
+            # Bugzilla::User::match implementation which is different.
+            my $objects = Bugzilla::Object::match($type, { $param => $names });
+            push(@ids, map { $_->id } @$objects);
+        }
+        # You can also specify ids directly as arguments to this function,
+        # so include them in the list if they have been specified.
+        if (exists $params->{"${field}_id"}) {
+            my $current_ids = $params->{"${field}_id"};
+            my @id_array = ref $current_ids ? @$current_ids : ($current_ids);
+            push(@ids, @id_array);
+        }
+        # We do this "or" instead of a "scalar(@ids)" to handle the case
+        # when people passed only invalid object names. Otherwise we'd
+        # end up with a SUPER::match call with zero criteria (which dies).
+        if (exists $params->{$field} or exists $params->{"${field}_id"}) {
+            $translated{$field} = scalar(@ids) == 1 ? $ids[0] : \@ids;
+        }
+    }
+
+    # The user fields don't have an _id on the end of them in the database,
+    # but the product & component fields do, so we have to have separate
+    # code to deal with the different sets of fields here.
+    foreach my $field (qw(assigned_to qa_contact reporter)) {
+        delete $params->{"${field}_id"};
+        $params->{$field} = $translated{$field} 
+            if exists $translated{$field};
+    }
+    foreach my $field (qw(product component)) {
+        delete $params->{$field};
+        $params->{"${field}_id"} = $translated{$field} 
+            if exists $translated{$field};
+    }
+
+    return $class->SUPER::match(@_);
+}
+
+# Helps load up information for bugs for show_bug.cgi and other situations
+# that will need to access info on lots of bugs.
+sub preload {
+    my ($class, $bugs) = @_;
+    my $user = Bugzilla->user;
+
+    # It would be faster but MUCH more complicated to select all the
+    # deps for the entire list in one SQL statement. If we ever have
+    # a profile that proves that that's necessary, we can switch over
+    # to the more complex method.
+    my @all_dep_ids;
+    foreach my $bug (@$bugs) {
+        push(@all_dep_ids, @{ $bug->blocked }, @{ $bug->dependson });
+        push(@all_dep_ids, @{ $bug->duplicate_ids });
+    }
+    @all_dep_ids = uniq @all_dep_ids;
+    # If we don't do this, can_see_bug will do one call per bug in
+    # the dependency and duplicate lists, in Bugzilla::Template::get_bug_link.
+    $user->visible_bugs(\@all_dep_ids);
+}
+
+sub possible_duplicates {
+    my ($class, $params) = @_;
+    my $short_desc = $params->{summary};
+    my $products = $params->{products} || [];
+    my $limit = $params->{limit} || MAX_POSSIBLE_DUPLICATES;
+    $limit = MAX_POSSIBLE_DUPLICATES if $limit > MAX_POSSIBLE_DUPLICATES;
+    $products = [$products] if !ref($products) eq 'ARRAY';
+
+    my $orig_limit = $limit;
+    detaint_natural($limit) 
+        || ThrowCodeError('param_must_be_numeric', 
+                          { function => 'possible_duplicates',
+                            param    => $orig_limit });
+
+    my $dbh = Bugzilla->dbh;
+    my $user = Bugzilla->user;
+    my @words = split(/[\b\s]+/, $short_desc || '');
+    # Exclude punctuation from the array.
+    @words = map { /(\w+)/; $1 } @words;
+    # And make sure that each word is longer than 2 characters.
+    @words = grep { defined $_ and length($_) > 2 } @words;
+
+    return [] if !@words;
+
+    my ($where_sql, $relevance_sql);
+    if ($dbh->FULLTEXT_OR) {
+        my $joined_terms = join($dbh->FULLTEXT_OR, @words);
+        ($where_sql, $relevance_sql) = 
+            $dbh->sql_fulltext_search('bugs_fulltext.short_desc', $joined_terms);
+        $relevance_sql ||= $where_sql;
+    }
+    else {
+        my (@where, @relevance);
+        foreach my $word (@words) {
+            my ($term, $rel_term) = $dbh->sql_fulltext_search(
+                'bugs_fulltext.short_desc', $word);
+            push(@where, $term);
+            push(@relevance, $rel_term || $term);
+        }
+
+        $where_sql = join(' OR ', @where);
+        $relevance_sql = join(' + ', @relevance);
+    }
+
+    my $product_ids = join(',', map { $_->id } @$products);
+    my $product_sql = $product_ids ? "AND product_id IN ($product_ids)" : "";
+
+    # Because we collapse duplicates, we want to get slightly more bugs
+    # than were actually asked for.
+    my $sql_limit = $limit + 5;
+
+    my $possible_dupes = $dbh->selectall_arrayref(
+        "SELECT bugs.bug_id AS bug_id, bugs.resolution AS resolution,
+                ($relevance_sql) AS relevance
+           FROM bugs
+                INNER JOIN bugs_fulltext ON bugs.bug_id = bugs_fulltext.bug_id
+          WHERE ($where_sql) $product_sql
+       ORDER BY relevance DESC, bug_id DESC " .
+          $dbh->sql_limit($sql_limit), {Slice=>{}});
+
+    my @actual_dupe_ids;
+    # Resolve duplicates into their ultimate target duplicates.
+    foreach my $bug (@$possible_dupes) {
+        my $push_id = $bug->{bug_id};
+        if ($bug->{resolution} && $bug->{resolution} eq 'DUPLICATE') {
+            $push_id = _resolve_ultimate_dup_id($bug->{bug_id});
+        }
+        push(@actual_dupe_ids, $push_id);
+    }
+    @actual_dupe_ids = uniq @actual_dupe_ids;
+    if (scalar @actual_dupe_ids > $limit) {
+        @actual_dupe_ids = @actual_dupe_ids[0..($limit-1)];
+    }
+
+    my $visible = $user->visible_bugs(\@actual_dupe_ids);
+    return $class->new_from_list($visible);
+}
+
+# Docs for create() (there's no POD in this file yet, but we very
+# much need this documented right now):
+#
+# The same as Bugzilla::Object->create. Parameters are only required
+# if they say so below.
+#
+# Params:
+#
+# C<product>     - B<Required> The name of the product this bug is being
+#                  filed against.
+# C<component>   - B<Required> The name of the component this bug is being
+#                  filed against.
+#
+# C<bug_severity> - B<Required> The severity for the bug, a string.
+# C<creation_ts>  - B<Required> A SQL timestamp for when the bug was created.
+# C<short_desc>   - B<Required> A summary for the bug.
+# C<op_sys>       - B<Required> The OS the bug was found against.
+# C<priority>     - B<Required> The initial priority for the bug.
+# C<rep_platform> - B<Required> The platform the bug was found against.
+# C<version>      - B<Required> The version of the product the bug was found in.
+#
+# C<alias>        - An alias for this bug.
+# C<target_milestone> - When this bug is expected to be fixed.
+# C<status_whiteboard> - A string.
+# C<bug_status>   - The initial status of the bug, a string.
+# C<bug_file_loc> - The URL field.
+#
+# C<assigned_to> - The full login name of the user who the bug is
+#                  initially assigned to.
+# C<qa_contact>  - The full login name of the QA Contact for this bug. 
+#                  Will be ignored if C<useqacontact> is off.
+#
+# C<estimated_time> - For time-tracking. Will be ignored if 
+#                     C<timetrackinggroup> is not set, or if the current
+#                     user is not a member of the timetrackinggroup.
+# C<deadline>       - For time-tracking. Will be ignored for the same
+#                     reasons as C<estimated_time>.
+sub create {
+    my ($class, $params) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    $dbh->bz_start_transaction();
+
+    # These fields have default values which we can use if they are undefined.
+    $params->{bug_severity} = Bugzilla->params->{defaultseverity}
+      unless defined $params->{bug_severity};
+    $params->{priority} = Bugzilla->params->{defaultpriority}
+      unless defined $params->{priority};
+    $params->{op_sys} = Bugzilla->params->{defaultopsys}
+      unless defined $params->{op_sys};
+    $params->{rep_platform} = Bugzilla->params->{defaultplatform}
+      unless defined $params->{rep_platform};
+    # Make sure a comment is always defined.
+    $params->{comment} = '' unless defined $params->{comment};
+
+    $class->check_required_create_fields($params);
+    $params = $class->run_create_validators($params);
+
+    # These are not a fields in the bugs table, so we don't pass them to
+    # insert_create_data.
+    my $cc_ids           = delete $params->{cc};
+    my $groups           = delete $params->{groups};
+    my $depends_on       = delete $params->{dependson};
+    my $blocked          = delete $params->{blocked};
+    my $keywords         = delete $params->{keywords};
+    my $creation_comment = delete $params->{comment};
+
+    # We don't want the bug to appear in the system until it's correctly
+    # protected by groups.
+    my $timestamp = delete $params->{creation_ts}; 
+
+    my $ms_values = $class->_extract_multi_selects($params);
+    my $bug = $class->insert_create_data($params);
+
+    # Add the group restrictions
+    my $sth_group = $dbh->prepare(
+        'INSERT INTO bug_group_map (bug_id, group_id) VALUES (?, ?)');
+    foreach my $group (@$groups) {
+        $sth_group->execute($bug->bug_id, $group->id);
+    }
+
+    $dbh->do('UPDATE bugs SET creation_ts = ? WHERE bug_id = ?', undef,
+             $timestamp, $bug->bug_id);
+    # Update the bug instance as well
+    $bug->{creation_ts} = $timestamp;
+
+    # Add the CCs
+    my $sth_cc = $dbh->prepare('INSERT INTO cc (bug_id, who) VALUES (?,?)');
+    foreach my $user_id (@$cc_ids) {
+        $sth_cc->execute($bug->bug_id, $user_id);
+    }
+
+    # Add in keywords
+    my $sth_keyword = $dbh->prepare(
+        'INSERT INTO keywords (bug_id, keywordid) VALUES (?, ?)');
+    foreach my $keyword_id (map($_->id, @$keywords)) {
+        $sth_keyword->execute($bug->bug_id, $keyword_id);
+    }
+
+    # Set up dependencies (blocked/dependson)
+    my $sth_deps = $dbh->prepare(
+        'INSERT INTO dependencies (blocked, dependson) VALUES (?, ?)');
+    my $sth_bug_time = $dbh->prepare('UPDATE bugs SET delta_ts = ? WHERE bug_id = ?');
+
+    foreach my $depends_on_id (@$depends_on) {
+        $sth_deps->execute($bug->bug_id, $depends_on_id);
+        # Log the reverse action on the other bug.
+        LogActivityEntry($depends_on_id, 'blocked', '', $bug->bug_id,
+                         $bug->{reporter_id}, $timestamp);
+        $sth_bug_time->execute($timestamp, $depends_on_id);
+    }
+    foreach my $blocked_id (@$blocked) {
+        $sth_deps->execute($blocked_id, $bug->bug_id);
+        # Log the reverse action on the other bug.
+        LogActivityEntry($blocked_id, 'dependson', '', $bug->bug_id,
+                         $bug->{reporter_id}, $timestamp);
+        $sth_bug_time->execute($timestamp, $blocked_id);
+    }
+
+    # Insert the values into the multiselect value tables
+    foreach my $field (keys %$ms_values) {
+        $dbh->do("DELETE FROM bug_$field where bug_id = ?",
+                undef, $bug->bug_id);
+        foreach my $value ( @{$ms_values->{$field}} ) {
+            $dbh->do("INSERT INTO bug_$field (bug_id, value) VALUES (?,?)",
+                    undef, $bug->bug_id, $value);
+        }
+    }
+
+    # Comment #0 handling...
+
+    # We now have a bug id so we can fill this out
+    $creation_comment->{'bug_id'} = $bug->id;
+
+    # Insert the comment. We always insert a comment on bug creation,
+    # but sometimes it's blank.
+    Bugzilla::Comment->insert_create_data($creation_comment);
+
+    Bugzilla::Hook::process('bug_end_of_create', { bug => $bug,
+                                                   timestamp => $timestamp,
+                                                 });
+
+    $dbh->bz_commit_transaction();
+
+    # Because MySQL doesn't support transactions on the fulltext table,
+    # we do this after we've committed the transaction. That way we're
+    # sure we're inserting a good Bug ID.
+    $bug->_sync_fulltext( new_bug => 1 );
+
+    return $bug;
+}
+
+sub run_create_validators {
+    my $class  = shift;
+    my $params = $class->SUPER::run_create_validators(@_);
+
+    # Add classification for checking mandatory fields which depend on it
+    $params->{classification} = $params->{product}->classification->name;
+
+    my @mandatory_fields = @{ Bugzilla->fields({ is_mandatory => 1,
+                                                 enter_bug    => 1,
+                                                 obsolete     => 0 }) };
+    foreach my $field (@mandatory_fields) {
+        $class->_check_field_is_mandatory($params->{$field->name}, $field,
+                                          $params);
+    }
+
+    my $product = delete $params->{product};
+    $params->{product_id} = $product->id;
+    my $component = delete $params->{component};
+    $params->{component_id} = $component->id;
+
+    # Callers cannot set reporter, creation_ts, or delta_ts.
+    $params->{reporter} = $class->_check_reporter();
+    $params->{delta_ts} = $params->{creation_ts};
+
+    if ($params->{estimated_time}) {
+        $params->{remaining_time} = $params->{estimated_time};
+    }
+
+    $class->_check_strict_isolation($params->{cc}, $params->{assigned_to},
+                                    $params->{qa_contact}, $product);
+
+    # You can't set these fields.
+    delete $params->{lastdiffed};
+    delete $params->{bug_id};
+    delete $params->{classification};
+
+    Bugzilla::Hook::process('bug_end_of_create_validators',
+                            { params => $params });
+
+    # And this is not a valid DB field, it's just used as part of 
+    # _check_dependencies to avoid running it twice for both blocked 
+    # and dependson.
+    delete $params->{_dependencies_validated};
+
+    return $params;
+}
+
+sub update {
+    my $self = shift;
+
+    my $dbh = Bugzilla->dbh;
+    # XXX This is just a temporary hack until all updating happens
+    # inside this function.
+    my $delta_ts = shift || $dbh->selectrow_array('SELECT LOCALTIMESTAMP(0)');
+
+    $dbh->bz_start_transaction();
+
+    my ($changes, $old_bug) = $self->SUPER::update(@_);
+
+    Bugzilla::Hook::process('bug_start_of_update',
+        { timestamp => $delta_ts, bug => $self,
+           old_bug => $old_bug, changes => $changes });
+
+    # Certain items in $changes have to be fixed so that they hold
+    # a name instead of an ID.
+    foreach my $field (qw(product_id component_id)) {
+        my $change = delete $changes->{$field};
+        if ($change) {
+            my $new_field = $field;
+            $new_field =~ s/_id$//;
+            $changes->{$new_field} = 
+                [$self->{"_old_${new_field}_name"}, $self->$new_field];
+        }
+    }
+    foreach my $field (qw(qa_contact assigned_to)) {
+        if ($changes->{$field}) {
+            my ($from, $to) = @{ $changes->{$field} };
+            $from = $old_bug->$field->login if $from;
+            $to   = $self->$field->login    if $to;
+            $changes->{$field} = [$from, $to];
+        }
+    }
+
+    # CC
+    my @old_cc = map {$_->id} @{$old_bug->cc_users};
+    my @new_cc = map {$_->id} @{$self->cc_users};
+    my ($removed_cc, $added_cc) = diff_arrays(\@old_cc, \@new_cc);
+    
+    if (scalar @$removed_cc) {
+        $dbh->do('DELETE FROM cc WHERE bug_id = ? AND ' 
+                 . $dbh->sql_in('who', $removed_cc), undef, $self->id);
+    }
+    foreach my $user_id (@$added_cc) {
+        $dbh->do('INSERT INTO cc (bug_id, who) VALUES (?,?)',
+                 undef, $self->id, $user_id);
+    }
+    # If any changes were found, record it in the activity log
+    if (scalar @$removed_cc || scalar @$added_cc) {
+        my $removed_users = Bugzilla::User->new_from_list($removed_cc);
+        my $added_users   = Bugzilla::User->new_from_list($added_cc);
+        my $removed_names = join(', ', (map {$_->login} @$removed_users));
+        my $added_names   = join(', ', (map {$_->login} @$added_users));
+        $changes->{cc} = [$removed_names, $added_names];
+    }
+    
+    # Keywords
+    my @old_kw_ids = map { $_->id } @{$old_bug->keyword_objects};
+    my @new_kw_ids = map { $_->id } @{$self->keyword_objects};
+
+    my ($removed_kw, $added_kw) = diff_arrays(\@old_kw_ids, \@new_kw_ids);
+
+    if (scalar @$removed_kw) {
+        $dbh->do('DELETE FROM keywords WHERE bug_id = ? AND ' 
+                 . $dbh->sql_in('keywordid', $removed_kw), undef, $self->id);
+    }
+    foreach my $keyword_id (@$added_kw) {
+        $dbh->do('INSERT INTO keywords (bug_id, keywordid) VALUES (?,?)',
+                 undef, $self->id, $keyword_id);
+    }
+    # If any changes were found, record it in the activity log
+    if (scalar @$removed_kw || scalar @$added_kw) {
+        my $removed_keywords = Bugzilla::Keyword->new_from_list($removed_kw);
+        my $added_keywords   = Bugzilla::Keyword->new_from_list($added_kw);
+        my $removed_names = join(', ', (map {$_->name} @$removed_keywords));
+        my $added_names   = join(', ', (map {$_->name} @$added_keywords));
+        $changes->{keywords} = [$removed_names, $added_names];
+    }
+
+    # Dependencies
+    foreach my $pair ([qw(dependson blocked)], [qw(blocked dependson)]) {
+        my ($type, $other) = @$pair;
+        my $old = $old_bug->$type;
+        my $new = $self->$type;
+        
+        my ($removed, $added) = diff_arrays($old, $new);
+        foreach my $removed_id (@$removed) {
+            $dbh->do("DELETE FROM dependencies WHERE $type = ? AND $other = ?",
+                     undef, $removed_id, $self->id);
+            
+            # Add an activity entry for the other bug.
+            LogActivityEntry($removed_id, $other, $self->id, '',
+                             Bugzilla->user->id, $delta_ts);
+            # Update delta_ts on the other bug so that we trigger mid-airs.
+            $dbh->do('UPDATE bugs SET delta_ts = ? WHERE bug_id = ?',
+                     undef, $delta_ts, $removed_id);
+        }
+        foreach my $added_id (@$added) {
+            $dbh->do("INSERT INTO dependencies ($type, $other) VALUES (?,?)",
+                     undef, $added_id, $self->id);
+            
+            # Add an activity entry for the other bug.
+            LogActivityEntry($added_id, $other, '', $self->id,
+                             Bugzilla->user->id, $delta_ts);
+            # Update delta_ts on the other bug so that we trigger mid-airs.
+            $dbh->do('UPDATE bugs SET delta_ts = ? WHERE bug_id = ?',
+                     undef, $delta_ts, $added_id);
+        }
+        
+        if (scalar(@$removed) || scalar(@$added)) {
+            $changes->{$type} = [join(', ', @$removed), join(', ', @$added)];
+        }
+    }
+
+    # Groups
+    my %old_groups = map {$_->id => $_} @{$old_bug->groups_in};
+    my %new_groups = map {$_->id => $_} @{$self->groups_in};
+    my ($removed_gr, $added_gr) = diff_arrays([keys %old_groups],
+                                              [keys %new_groups]);
+    if (scalar @$removed_gr || scalar @$added_gr) {
+        if (@$removed_gr) {
+            my $qmarks = join(',', ('?') x @$removed_gr);
+            $dbh->do("DELETE FROM bug_group_map
+                       WHERE bug_id = ? AND group_id IN ($qmarks)", undef,
+                     $self->id, @$removed_gr);
+        }
+        my $sth_insert = $dbh->prepare(
+            'INSERT INTO bug_group_map (bug_id, group_id) VALUES (?,?)');
+        foreach my $gid (@$added_gr) {
+            $sth_insert->execute($self->id, $gid);
+        }
+        my @removed_names = map { $old_groups{$_}->name } @$removed_gr;
+        my @added_names   = map { $new_groups{$_}->name } @$added_gr;
+        $changes->{'bug_group'} = [join(', ', @removed_names),
+                                   join(', ', @added_names)];
+    }
+
+    # Flags
+    my ($removed, $added) = Bugzilla::Flag->update_flags($self, $old_bug, $delta_ts);
+    if ($removed || $added) {
+        $changes->{'flagtypes.name'} = [$removed, $added];
+    }
+
+    # Comments
+    foreach my $comment (@{$self->{added_comments} || []}) {
+        # Override the Comment's timestamp to be identical to the update
+        # timestamp.
+        $comment->{bug_when} = $delta_ts;
+        $comment = Bugzilla::Comment->insert_create_data($comment);
+        if ($comment->work_time) {
+            LogActivityEntry($self->id, "work_time", "", $comment->work_time,
+                Bugzilla->user->id, $delta_ts);
+        }
+    }
+
+    # Comment Privacy 
+    foreach my $comment (@{$self->{comment_isprivate} || []}) {
+        $comment->update();
+        
+        my ($from, $to) 
+            = $comment->is_private ? (0, 1) : (1, 0);
+        LogActivityEntry($self->id, "longdescs.isprivate", $from, $to, 
+                         Bugzilla->user->id, $delta_ts, $comment->id);
+    }
+
+    # Insert the values into the multiselect value tables
+    my @multi_selects = grep {$_->type == FIELD_TYPE_MULTI_SELECT}
+                             Bugzilla->active_custom_fields;
+    foreach my $field (@multi_selects) {
+        my $name = $field->name;
+        my ($removed, $added) = diff_arrays($old_bug->$name, $self->$name);
+        if (scalar @$removed || scalar @$added) {
+            $changes->{$name} = [join(', ', @$removed), join(', ', @$added)];
+
+            $dbh->do("DELETE FROM bug_$name where bug_id = ?",
+                     undef, $self->id);
+            foreach my $value (@{$self->$name}) {
+                $dbh->do("INSERT INTO bug_$name (bug_id, value) VALUES (?,?)",
+                         undef, $self->id, $value);
+            }
+        }
+    }
+
+    # See Also
+
+    my ($removed_see, $added_see) =
+        diff_arrays($old_bug->see_also, $self->see_also, 'name');
+
+    $_->remove_from_db foreach @$removed_see;
+    $_->insert_create_data($_) foreach @$added_see;
+
+    # If any changes were found, record it in the activity log
+    if (scalar @$removed_see || scalar @$added_see) {
+        $changes->{see_also} = [join(', ', map { $_->name } @$removed_see),
+                                join(', ', map { $_->name } @$added_see)];
+    }
+
+    $_->update foreach @{ $self->{_update_ref_bugs} || [] };
+    delete $self->{_update_ref_bugs};
+
+    # Log bugs_activity items
+    # XXX Eventually, when bugs_activity is able to track the dupe_id,
+    # this code should go below the duplicates-table-updating code below.
+    foreach my $field (keys %$changes) {
+        my $change = $changes->{$field};
+        my $from = defined $change->[0] ? $change->[0] : '';
+        my $to   = defined $change->[1] ? $change->[1] : '';
+        LogActivityEntry($self->id, $field, $from, $to, Bugzilla->user->id,
+                         $delta_ts);
+    }
+
+    # Check if we have to update the duplicates table and the other bug.
+    my ($old_dup, $cur_dup) = ($old_bug->dup_id || 0, $self->dup_id || 0);
+    if ($old_dup != $cur_dup) {
+        $dbh->do("DELETE FROM duplicates WHERE dupe = ?", undef, $self->id);
+        if ($cur_dup) {
+            $dbh->do('INSERT INTO duplicates (dupe, dupe_of) VALUES (?,?)',
+                     undef, $self->id, $cur_dup);
+            if (my $update_dup = delete $self->{_dup_for_update}) {
+                $update_dup->update();
+            }
+        }
+        
+        $changes->{'dup_id'} = [$old_dup || undef, $cur_dup || undef];
+    }
+
+    Bugzilla::Hook::process('bug_end_of_update', 
+        { bug => $self, timestamp => $delta_ts, changes => $changes,
+          old_bug => $old_bug });
+
+    # If any change occurred, refresh the timestamp of the bug.
+    if (scalar(keys %$changes) || $self->{added_comments}
+        || $self->{comment_isprivate})
+    {
+        $dbh->do('UPDATE bugs SET delta_ts = ? WHERE bug_id = ?',
+                 undef, ($delta_ts, $self->id));
+        $self->{delta_ts} = $delta_ts;
+    }
+
+    $dbh->bz_commit_transaction();
+
+    # The only problem with this here is that update() is often called
+    # in the middle of a transaction, and if that transaction is rolled
+    # back, this change will *not* be rolled back. As we expect rollbacks
+    # to be extremely rare, that is OK for us.
+    $self->_sync_fulltext(
+        update_short_desc => $changes->{short_desc},
+        update_comments   => $self->{added_comments} || $self->{comment_isprivate}
+    );
+
+    # Remove obsolete internal variables.
+    delete $self->{'_old_assigned_to'};
+    delete $self->{'_old_qa_contact'};
+
+    # Also flush the visible_bugs cache for this bug as the user's
+    # relationship with this bug may have changed.
+    delete Bugzilla->user->{_visible_bugs_cache}->{$self->id};
+
+    return $changes;
+}
+
+# Used by create().
+# We need to handle multi-select fields differently than normal fields,
+# because they're arrays and don't go into the bugs table.
+sub _extract_multi_selects {
+    my ($invocant, $params) = @_;
+
+    my @multi_selects = grep {$_->type == FIELD_TYPE_MULTI_SELECT}
+                             Bugzilla->active_custom_fields;
+    my %ms_values;
+    foreach my $field (@multi_selects) {
+        my $name = $field->name;
+        if (exists $params->{$name}) {
+            my $array = delete($params->{$name}) || [];
+            $ms_values{$name} = $array;
+        }
+    }
+    return \%ms_values;
+}
+
+# Should be called any time you update short_desc or change a comment.
+sub _sync_fulltext {
+    my ($self, %options) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    my($all_comments, $public_comments);
+    if ($options{new_bug} || $options{update_comments}) {
+        my $comments = $dbh->selectall_arrayref(
+            'SELECT thetext, isprivate FROM longdescs WHERE bug_id = ?',
+            undef, $self->id);
+        $all_comments = join("\n", map { $_->[0] } @$comments);
+        my @no_private = grep { !$_->[1] } @$comments;
+        $public_comments = join("\n", map { $_->[0] } @no_private);
+    }
+
+    if ($options{new_bug}) {
+        $dbh->do('INSERT INTO bugs_fulltext (bug_id, short_desc, comments,
+                                             comments_noprivate)
+                 VALUES (?, ?, ?, ?)',
+                 undef,
+                 $self->id, $self->short_desc, $all_comments, $public_comments);
+    } else {
+        my(@names, @values);
+        if ($options{update_short_desc}) {
+            push @names, 'short_desc';
+            push @values, $self->short_desc;
+        }
+        if ($options{update_comments}) {
+            push @names, ('comments', 'comments_noprivate');
+            push @values, ($all_comments, $public_comments);
+        }
+        if (@names) {
+            $dbh->do('UPDATE bugs_fulltext SET ' .
+                     join(', ', map { "$_ = ?" } @names) .
+                     ' WHERE bug_id = ?',
+                     undef,
+                     @values, $self->id);
+        }
+    }
+}
+
+sub remove_from_db {
+    my ($self) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    ThrowCodeError("bug_error", { bug => $self }) if $self->{'error'};
+
+    my $bug_id = $self->{'bug_id'};
+    $self->SUPER::remove_from_db();
+    # The bugs_fulltext table doesn't support foreign keys.
+    $dbh->do("DELETE FROM bugs_fulltext WHERE bug_id = ?", undef, $bug_id);
+}
+
+#####################################################################
+# Sending Email After Bug Update
+#####################################################################
+
+sub send_changes {
+    my ($self, $changes, $vars) = @_;
+
+    my $user = Bugzilla->user;
+
+    my $old_qa  = $changes->{'qa_contact'}  
+                  ? $changes->{'qa_contact'}->[0] : '';
+    my $old_own = $changes->{'assigned_to'} 
+                  ? $changes->{'assigned_to'}->[0] : '';
+    my $old_cc  = $changes->{cc}
+                  ? $changes->{cc}->[0] : '';
+
+    my %forced = (
+        cc        => [split(/[,;]+/, $old_cc)],
+        owner     => $old_own,
+        qacontact => $old_qa,
+        changer   => $user,
+    );
+
+    _send_bugmail({ id => $self->id, type => 'bug', forced => \%forced }, 
+                  $vars);
+
+    # If the bug was marked as a duplicate, we need to notify users on the
+    # other bug of any changes to that bug.
+    my $new_dup_id = $changes->{'dup_id'} ? $changes->{'dup_id'}->[1] : undef;
+    if ($new_dup_id) {
+        _send_bugmail({ forced => { changer => $user }, type => "dupe",
+                        id => $new_dup_id }, $vars);
+    }
+
+    # If there were changes in dependencies, we need to notify those
+    # dependencies.
+    if ($changes->{'bug_status'}) {
+        my ($old_status, $new_status) = @{ $changes->{'bug_status'} };
+
+        # If this bug has changed from opened to closed or vice-versa,
+        # then all of the bugs we block need to be notified.
+        if (is_open_state($old_status) ne is_open_state($new_status)) {
+            my $params = { forced   => { changer => $user },
+                           type     => 'dep',
+                           dep_only => 1,
+                           blocker  => $self,
+                           changes  => $changes };
+
+            foreach my $id (@{ $self->blocked }) {
+                $params->{id} = $id;
+                _send_bugmail($params, $vars);
+            }
+        }
+    }
+
+    # To get a list of all changed dependencies, convert the "changes" arrays
+    # into a long string, then collapse that string into unique numbers in
+    # a hash.
+    my $all_changed_deps = join(', ', @{ $changes->{'dependson'} || [] });
+    $all_changed_deps = join(', ', @{ $changes->{'blocked'} || [] },
+                                   $all_changed_deps);
+    my %changed_deps = map { $_ => 1 } split(', ', $all_changed_deps);
+    # When clearning one field (say, blocks) and filling in the other
+    # (say, dependson), an empty string can get into the hash and cause
+    # an error later.
+    delete $changed_deps{''};
+
+    foreach my $id (sort { $a <=> $b } (keys %changed_deps)) {
+        _send_bugmail({ forced => { changer => $user }, type => "dep",
+                         id => $id }, $vars);
+    }
+
+    # Sending emails for the referenced bugs.
+    foreach my $ref_bug_id (uniq @{ $self->{see_also_changes} || [] }) {
+        _send_bugmail({ forced => { changer => $user },
+                        id => $ref_bug_id }, $vars);
+    }
+}
+
+sub _send_bugmail {
+    my ($params, $vars) = @_;
+
+    require Bugzilla::BugMail;
+
+    my $results = 
+        Bugzilla::BugMail::Send($params->{'id'}, $params->{'forced'}, $params);
+
+    if (Bugzilla->usage_mode == USAGE_MODE_BROWSER) {
+        my $template = Bugzilla->template;
+        $vars->{$_} = $params->{$_} foreach keys %$params;
+        $vars->{'sent_bugmail'} = $results;
+        $template->process("bug/process/results.html.tmpl", $vars)
+            || ThrowTemplateError($template->error());
+        $vars->{'header_done'} = 1;
+    }
+}
+
+#####################################################################
+# Validators
+#####################################################################
+
+sub _check_alias {
+   my ($invocant, $alias) = @_;
+   $alias = trim($alias);
+   return undef if (!$alias);
+
+    # Make sure the alias isn't too long.
+    if (length($alias) > 20) {
+        ThrowUserError("alias_too_long");
+    }
+    # Make sure the alias isn't just a number.
+    if ($alias =~ /^\d+$/) {
+        ThrowUserError("alias_is_numeric", { alias => $alias });
+    }
+    # Make sure the alias has no commas or spaces.
+    if ($alias =~ /[, ]/) {
+        ThrowUserError("alias_has_comma_or_space", { alias => $alias });
+    }
+    # Make sure the alias is unique, or that it's already our alias.
+    my $other_bug = new Bugzilla::Bug($alias);
+    if (!$other_bug->{error}
+        && (!ref $invocant || $other_bug->id != $invocant->id))
+    {
+        ThrowUserError("alias_in_use", { alias => $alias,
+                                         bug_id => $other_bug->id });
+    }
+
+   return $alias;
+}
+
+sub _check_assigned_to {
+    my ($invocant, $assignee, undef, $params) = @_;
+    my $user = Bugzilla->user;
+    my $component = blessed($invocant) ? $invocant->component_obj
+                                       : $params->{component};
+
+    # Default assignee is the component owner.
+    my $id;
+    # If this is a new bug, you can only set the assignee if you have editbugs.
+    # If you didn't specify the assignee, we use the default assignee.
+    if (!ref $invocant
+        && (!$user->in_group('editbugs', $component->product_id) || !$assignee))
+    {
+        $id = $component->default_assignee->id;
+    } else {
+        if (!ref $assignee) {
+            $assignee = trim($assignee);
+            # When updating a bug, assigned_to can't be empty.
+            ThrowUserError("reassign_to_empty") if ref $invocant && !$assignee;
+            $assignee = Bugzilla::User->check($assignee);
+        }
+        $id = $assignee->id;
+        # create() checks this another way, so we don't have to run this
+        # check during create().
+        $invocant->_check_strict_isolation_for_user($assignee) if ref $invocant;
+    }
+    return $id;
+}
+
+sub _check_bug_file_loc {
+    my ($invocant, $url) = @_;
+    $url = '' if !defined($url);
+    $url = trim($url);
+    # On bug entry, if bug_file_loc is "http://", the default, use an 
+    # empty value instead. However, on bug editing people can set that
+    # back if they *really* want to.
+    if (!ref $invocant && $url eq 'http://') {
+        $url = '';
+    }
+    return $url;
+}
+
+sub _check_bug_status {
+    my ($invocant, $new_status, undef, $params) = @_;
+    my $user = Bugzilla->user;
+    my @valid_statuses;
+    my $old_status; # Note that this is undef for new bugs.
+
+    my ($product, $comment);
+    if (ref $invocant) {
+        @valid_statuses = @{$invocant->statuses_available};
+        $product = $invocant->product_obj;
+        $old_status = $invocant->status;
+        my $comments = $invocant->{added_comments} || [];
+        $comment = $comments->[-1];
+    }
+    else {
+        $product = $params->{product};
+        $comment = $params->{comment};
+        @valid_statuses = @{ Bugzilla::Bug->statuses_available($product) };
+    }
+
+    # Check permissions for users filing new bugs.
+    if (!ref $invocant) {
+        if ($user->in_group('editbugs', $product->id)
+            || $user->in_group('canconfirm', $product->id)) {
+            # If the user with privs hasn't selected another status,
+            # select the first one of the list.
+            unless ($new_status) {
+                if (scalar(@valid_statuses) == 1) {
+                    $new_status = $valid_statuses[0];
+                }
+                else {
+                    $new_status = ($valid_statuses[0]->name ne 'UNCONFIRMED') ?
+                                  $valid_statuses[0] : $valid_statuses[1];
+                }
+            }
+        }
+        else {
+            # A user with no privs cannot choose the initial status.
+            # If UNCONFIRMED is valid for this product, use it; else
+            # use the first bug status available.
+            if (grep {$_->name eq 'UNCONFIRMED'} @valid_statuses) {
+                $new_status = 'UNCONFIRMED';
+            }
+            else {
+                $new_status = $valid_statuses[0];
+            }
+        }
+    }
+
+    # Time to validate the bug status.
+    $new_status = Bugzilla::Status->check($new_status) unless ref($new_status);
+    # We skip this check if we are changing from a status to itself.
+    if ( (!$old_status || $old_status->id != $new_status->id)
+          && !grep {$_->name eq $new_status->name} @valid_statuses) 
+    {
+        ThrowUserError('illegal_bug_status_transition',
+                       { old => $old_status, new => $new_status });
+    }
+
+    # Check if a comment is required for this change.
+    if ($new_status->comment_required_on_change_from($old_status)
+        && !$comment->{'thetext'})
+    {
+        ThrowUserError('comment_required',
+          { old => $old_status ? $old_status->name : undef,
+            new => $new_status->name, field => 'bug_status' });
+    }
+    
+    if (ref $invocant 
+        && ($new_status->name eq 'IN_PROGRESS'
+            # Backwards-compat for the old default workflow.
+            or $new_status->name eq 'ASSIGNED')
+        && Bugzilla->params->{"usetargetmilestone"}
+        && Bugzilla->params->{"musthavemilestoneonaccept"}
+        # musthavemilestoneonaccept applies only if at least two
+        # target milestones are defined for the product.
+        && scalar(@{ $product->milestones }) > 1
+        && $invocant->target_milestone eq $product->default_milestone)
+    {
+        ThrowUserError("milestone_required", { bug => $invocant });
+    }
+
+    if (!blessed $invocant) {
+        $params->{everconfirmed} = $new_status->name eq 'UNCONFIRMED' ? 0 : 1;
+    }
+
+    return $new_status->name;
+}
+
+sub _check_cc {
+    my ($invocant, $ccs, undef, $params) = @_;
+    my $component = blessed($invocant) ? $invocant->component_obj
+                                       : $params->{component};
+    return [map {$_->id} @{$component->initial_cc}] unless $ccs;
+
+    # Allow comma-separated input as well as arrayrefs.
+    $ccs = [split(/[,;]+/, $ccs)] if !ref $ccs;
+
+    my %cc_ids;
+    foreach my $person (@$ccs) {
+        $person = trim($person);
+        next unless $person;
+        my $id = login_to_id($person, THROW_ERROR);
+        $cc_ids{$id} = 1;
+    }
+
+    # Enforce Default CC
+    $cc_ids{$_->id} = 1 foreach (@{$component->initial_cc});
+
+    return [keys %cc_ids];
+}
+
+sub _check_comment {
+    my ($invocant, $comment_txt, undef, $params) = @_;
+
+    # Comment can be empty. We should force it to be empty if the text is undef
+    if (!defined $comment_txt) {
+        $comment_txt = '';
+    }
+
+    # Load up some data
+    my $isprivate = delete $params->{comment_is_private};
+    my $timestamp = $params->{creation_ts};
+
+    # Create the new comment so we can check it
+    my $comment = {
+        thetext  => $comment_txt,
+        bug_when => $timestamp,
+    };
+
+    # We don't include the "isprivate" column unless it was specified. 
+    # This allows it to fall back to its database default.
+    if (defined $isprivate) {
+        $comment->{isprivate} = $isprivate;
+    }
+
+    # Validate comment. We have to do this special as a comment normally
+    # requires a bug to be already created. For a new bug, the first comment
+    # obviously can't get the bug if the bug is created after this
+    # (see bug 590334)
+    Bugzilla::Comment->check_required_create_fields($comment);
+    $comment = Bugzilla::Comment->run_create_validators($comment,
+                                                        { skip => ['bug_id'] }
+    );
+
+    return $comment; 
+}
+
+sub _check_commenton {
+    my ($invocant, $new_value, $field, $params) = @_;
+
+    my $has_comment =
+        ref($invocant) ? $invocant->{added_comments}
+                       : (defined $params->{comment}
+                          and $params->{comment}->{thetext} ne '');
+
+    my $is_changing = ref($invocant) ? $invocant->$field ne $new_value
+                                     : $new_value ne '';
+
+    if ($is_changing && !$has_comment) {
+        my $old_value = ref($invocant) ? $invocant->$field : undef;
+        ThrowUserError('comment_required',
+            { field => $field, old => $old_value, new => $new_value });
+    }
+}
+
+sub _check_component {
+    my ($invocant, $name, undef, $params) = @_;
+    $name = trim($name);
+    $name || ThrowUserError("require_component");
+    my $product = blessed($invocant) ? $invocant->product_obj 
+                                     : $params->{product};
+    my $old_comp = blessed($invocant) ? $invocant->component : '';
+    my $object = Bugzilla::Component->check({ product => $product, name => $name });
+    if ($object->name ne $old_comp && !$object->is_active) {
+        ThrowUserError('value_inactive', { class => ref($object), value => $name });
+    }
+    return $object;
+}
+
+sub _check_creation_ts {
+    return Bugzilla->dbh->selectrow_array('SELECT LOCALTIMESTAMP(0)');
+}
+
+sub _check_deadline {
+    my ($invocant, $date) = @_;
+
+    # When filing bugs, we're forgiving and just return undef if
+    # the user isn't a timetracker. When updating bugs, check_can_change_field
+    # controls permissions, so we don't want to check them here.
+    if (!ref $invocant and !Bugzilla->user->is_timetracker) {
+        return undef;
+    }
+
+    # Validate entered deadline
+    $date = trim($date);
+    return undef if !$date;
+    validate_date($date)
+        || ThrowUserError('illegal_date', { date   => $date,
+                                            format => 'YYYY-MM-DD' });
+    return $date;
+}
+
+# Takes two comma/space-separated strings and returns arrayrefs
+# of valid bug IDs.
+sub _check_dependencies {
+    my ($invocant, $value, $field, $params) = @_;
+
+    return $value if $params->{_dependencies_validated};
+
+    if (!ref $invocant) {
+        # Only editbugs users can set dependencies on bug entry.
+        return ([], []) unless Bugzilla->user->in_group(
+            'editbugs', $params->{product}->id);
+    }
+
+    # This is done this way so that dependson and blocked can be in
+    # VALIDATORS, meaning that they can be in VALIDATOR_DEPENDENCIES,
+    # which means that they can be checked in the right order during
+    # bug creation.
+    my $opposite = $field eq 'dependson' ? 'blocked' : 'dependson';
+    my %deps_in = ($field => $value || '',
+                   $opposite => $params->{$opposite} || '');
+
+    foreach my $type (qw(dependson blocked)) {
+        my @bug_ids = ref($deps_in{$type}) 
+            ? @{$deps_in{$type}} 
+            : split(/[\s,]+/, $deps_in{$type});
+        # Eliminate nulls.
+        @bug_ids = grep {$_} @bug_ids;
+
+        my @check_access = @bug_ids;
+        # When we're updating a bug, only added or removed bug_ids are 
+        # checked for whether or not we can see/edit those bugs.
+        if (ref $invocant) {
+            my $old = $invocant->$type;
+            my ($removed, $added) = diff_arrays($old, \@bug_ids);
+            @check_access = (@$added, @$removed);
+            
+            # Check field permissions if we've changed anything.
+            if (@check_access) {
+                my $privs;
+                if (!$invocant->check_can_change_field($type, 0, 1, \$privs)) {
+                    ThrowUserError('illegal_change', { field => $type,
+                                                       privs => $privs });
+                }
+            }
+        }
+
+        my $user = Bugzilla->user;
+        foreach my $modified_id (@check_access) {
+            my $delta_bug = $invocant->check($modified_id);
+            # Under strict isolation, you can't modify a bug if you can't
+            # edit it, even if you can see it.
+            if (Bugzilla->params->{"strict_isolation"}) {
+                if (!$user->can_edit_product($delta_bug->{'product_id'})) {
+                    ThrowUserError("illegal_change_deps", {field => $type});
+                }
+            }
+        }
+        # Replace all aliases by their corresponding bug ID.
+        @bug_ids = map { $_ =~ /^(\d+)$/ ? $1 : $invocant->check($_, $type)->id } @bug_ids;
+        $deps_in{$type} = \@bug_ids;
+    }
+
+    # And finally, check for dependency loops.
+    my $bug_id = ref($invocant) ? $invocant->id : 0;
+    my %deps = ValidateDependencies($deps_in{dependson}, $deps_in{blocked},
+                                    $bug_id);
+
+    $params->{$opposite} = $deps{$opposite};
+    $params->{_dependencies_validated} = 1;
+    return $deps{$field};
+}
+
+sub _check_dup_id {
+    my ($self, $dupe_of) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    # Store the bug ID/alias passed by the user for visibility checks.
+    my $orig_dupe_of = $dupe_of = trim($dupe_of);
+    $dupe_of || ThrowCodeError('undefined_field', { field => 'dup_id' });
+    # Validate the bug ID. The second argument will force check() to only
+    # make sure that the bug exists, and convert the alias to the bug ID
+    # if a string is passed. Group restrictions are checked below.
+    my $dupe_of_bug = $self->check($dupe_of, 'dup_id');
+    $dupe_of = $dupe_of_bug->id;
+
+    # If the dupe is unchanged, we have nothing more to check.
+    return $dupe_of if ($self->dup_id && $self->dup_id == $dupe_of);
+
+    # If we come here, then the duplicate is new. We have to make sure
+    # that we can view/change it (issue A on bug 96085).
+    $dupe_of_bug->check_is_visible($orig_dupe_of);
+
+    # Make sure a loop isn't created when marking this bug
+    # as duplicate.
+   _resolve_ultimate_dup_id($self->id, $dupe_of, 1);
+
+    my $cur_dup = $self->dup_id || 0;
+    if ($cur_dup != $dupe_of && Bugzilla->params->{'commentonduplicate'}
+        && !$self->{added_comments})
+    {
+        ThrowUserError('comment_required');
+    }
+
+    # Should we add the reporter to the CC list of the new bug?
+    # If he can see the bug...
+    if ($self->reporter->can_see_bug($dupe_of)) {
+        # We only add him if he's not the reporter of the other bug.
+        $self->{_add_dup_cc} = 1
+            if $dupe_of_bug->reporter->id != $self->reporter->id;
+    }
+    # What if the reporter currently can't see the new bug? In the browser 
+    # interface, we prompt the user. In other interfaces, we default to 
+    # not adding the user, as the safest option.
+    elsif (Bugzilla->usage_mode == USAGE_MODE_BROWSER) {
+        # If we've already confirmed whether the user should be added...
+        my $cgi = Bugzilla->cgi;
+        my $add_confirmed = $cgi->param('confirm_add_duplicate');
+        if (defined $add_confirmed) {
+            $self->{_add_dup_cc} = $add_confirmed;
+        }
+        else {
+            # Note that here we don't check if he user is already the reporter
+            # of the dupe_of bug, since we already checked if he can *see*
+            # the bug, above. People might have reporter_accessible turned
+            # off, but cclist_accessible turned on, so they might want to
+            # add the reporter even though he's already the reporter of the
+            # dup_of bug.
+            my $vars = {};
+            my $template = Bugzilla->template;
+            # Ask the user what they want to do about the reporter.
+            $vars->{'cclist_accessible'} = $dupe_of_bug->cclist_accessible;
+            $vars->{'original_bug_id'} = $dupe_of;
+            $vars->{'duplicate_bug_id'} = $self->id;
+            print $cgi->header();
+            $template->process("bug/process/confirm-duplicate.html.tmpl", $vars)
+              || ThrowTemplateError($template->error());
+            exit;
+        }
+    }
+
+    return $dupe_of;
+}
+
+sub _check_groups {
+    my ($invocant, $group_names, undef, $params) = @_;
+
+    my $bug_id = blessed($invocant) ? $invocant->id : undef;
+    my $product = blessed($invocant) ? $invocant->product_obj 
+                                     : $params->{product};
+    my %add_groups;
+
+    # In email or WebServices, when the "groups" item actually 
+    # isn't specified, then just add the default groups.
+    if (!defined $group_names) {
+        my $available = $product->groups_available;
+        foreach my $group (@$available) {
+            $add_groups{$group->id} = $group if $group->{is_default};
+        }
+    }
+    else {
+        # Allow a comma-separated list, for email_in.pl.
+        $group_names = [map { trim($_) } split(',', $group_names)]
+            if !ref $group_names;
+
+        # First check all the groups they chose to set.
+        my %args = ( product => $product->name, bug_id => $bug_id, action => 'add' );
+        foreach my $name (@$group_names) {
+            my $group = Bugzilla::Group->check_no_disclose({ %args, name => $name });
+
+            if (!$product->group_is_settable($group)) {
+                ThrowUserError('group_restriction_not_allowed', { %args, name => $name });
+            }
+            $add_groups{$group->id} = $group;
+        }
+    }
+
+    # Now enforce mandatory groups.
+    $add_groups{$_->id} = $_ foreach @{ $product->groups_mandatory };
+
+    my @add_groups = values %add_groups;
+    return \@add_groups;
+}
+
+sub _check_keywords {
+    my ($invocant, $keywords_in, undef, $params) = @_;
+
+    return [] if !defined $keywords_in;
+
+    my $keyword_array = $keywords_in;
+    if (!ref $keyword_array) {
+        $keywords_in = trim($keywords_in);
+        $keyword_array = [split(/[\s,]+/, $keywords_in)];
+    }
+    
+    # On creation, only editbugs users can set keywords.
+    if (!ref $invocant) {
+        my $product = $params->{product};
+        return [] if !Bugzilla->user->in_group('editbugs', $product->id);
+    }
+    
+    my %keywords;
+    foreach my $keyword (@$keyword_array) {
+        next unless $keyword;
+        my $obj = Bugzilla::Keyword->check($keyword);
+        $keywords{$obj->id} = $obj;
+    }
+    return [values %keywords];
+}
+
+sub _check_product {
+    my ($invocant, $name) = @_;
+    $name = trim($name);
+    # If we're updating the bug and they haven't changed the product,
+    # always allow it.
+    if (ref $invocant && lc($invocant->product_obj->name) eq lc($name)) {
+        return $invocant->product_obj;
+    }
+    # Check that the product exists and that the user
+    # is allowed to enter bugs into this product.
+    my $product = Bugzilla->user->can_enter_product($name, THROW_ERROR);
+    return $product;
+}
+
+sub _check_priority {
+    my ($invocant, $priority) = @_;
+    if (!ref $invocant && !Bugzilla->params->{'letsubmitterchoosepriority'}) {
+        $priority = Bugzilla->params->{'defaultpriority'};
+    }
+    return $invocant->_check_select_field($priority, 'priority');
+}
+
+sub _check_qa_contact {
+    my ($invocant, $qa_contact, undef, $params) = @_;
+    $qa_contact = trim($qa_contact) if !ref $qa_contact;
+    my $component = blessed($invocant) ? $invocant->component_obj
+                                       : $params->{component};
+    if (!ref $invocant) {
+        # Bugs get no QA Contact on creation if useqacontact is off.
+        return undef if !Bugzilla->params->{useqacontact};
+        # Set the default QA Contact if one isn't specified or if the
+        # user doesn't have editbugs.
+        if (!Bugzilla->user->in_group('editbugs', $component->product_id)
+            || !$qa_contact)
+        {
+            return $component->default_qa_contact ? $component->default_qa_contact->id : undef;
+        }
+    }
+
+    # If a QA Contact was specified or if we're updating, check
+    # the QA Contact for validity.
+    my $id;
+    if ($qa_contact) {
+        $qa_contact = Bugzilla::User->check($qa_contact) if !ref $qa_contact;
+        $id = $qa_contact->id;
+        # create() checks this another way, so we don't have to run this
+        # check during create().
+        # If there is no QA contact, this check is not required.
+        $invocant->_check_strict_isolation_for_user($qa_contact)
+            if (ref $invocant && $id);
+    }
+
+    # "0" always means "undef", for QA Contact.
+    return $id || undef;
+}
+
+sub _check_reporter {
+    my $invocant = shift;
+    my $reporter;
+    if (ref $invocant) {
+        # You cannot change the reporter of a bug.
+        $reporter = $invocant->reporter->id;
+    }
+    else {
+        # On bug creation, the reporter is the logged in user
+        # (meaning that he must be logged in first!).
+        Bugzilla->login(LOGIN_REQUIRED);
+        $reporter = Bugzilla->user->id;
+    }
+    return $reporter;
+}
+
+sub _check_resolution {
+    my ($invocant, $resolution, undef, $params) = @_;
+    $resolution = trim($resolution);
+    my $status = ref($invocant) ? $invocant->status->name 
+                                : $params->{bug_status};
+    my $is_open = ref($invocant) ? $invocant->status->is_open 
+                                 : is_open_state($status);
+    
+    # Throw a special error for resolving bugs without a resolution
+    # (or trying to change the resolution to '' on a closed bug without
+    # using clear_resolution).
+    ThrowUserError('missing_resolution', { status => $status })
+        if !$resolution && !$is_open;
+    
+    # Make sure this is a valid resolution.
+    $resolution = $invocant->_check_select_field($resolution, 'resolution');
+
+    # Don't allow open bugs to have resolutions.
+    ThrowUserError('resolution_not_allowed') if $is_open;
+    
+    # Check noresolveonopenblockers.
+    my $dependson = ref($invocant) ? $invocant->dependson
+                                   : ($params->{dependson} || []);
+    if (Bugzilla->params->{"noresolveonopenblockers"}
+        && $resolution eq 'FIXED'
+        && (!ref $invocant or !$invocant->resolution 
+            or $resolution ne $invocant->resolution)
+        && scalar @$dependson)
+    {
+        my $dep_bugs = Bugzilla::Bug->new_from_list($dependson);
+        my $count_open = grep { $_->isopened } @$dep_bugs;
+        if ($count_open) {
+            my $bug_id = ref($invocant) ? $invocant->id : undef;
+            ThrowUserError("still_unresolved_bugs",
+                           { bug_id => $bug_id, dep_count => $count_open });
+        }
+    }
+
+    # Check if they're changing the resolution and need to comment.
+    if (Bugzilla->params->{'commentonchange_resolution'}) {
+        $invocant->_check_commenton($resolution, 'resolution', $params);
+    }
+    
+    return $resolution;
+}
+
+sub _check_short_desc {
+    my ($invocant, $short_desc) = @_;
+    # Set the parameter to itself, but cleaned up
+    $short_desc = clean_text($short_desc) if $short_desc;
+
+    if (!defined $short_desc || $short_desc eq '') {
+        ThrowUserError("require_summary");
+    }
+    if (length($short_desc) > MAX_FREETEXT_LENGTH) {
+        ThrowUserError('freetext_too_long', 
+                       { field => 'short_desc', text => $short_desc });
+    }
+    return $short_desc;
+}
+
+sub _check_status_whiteboard { return defined $_[1] ? $_[1] : ''; }
+
+# Unlike other checkers, this one doesn't return anything.
+sub _check_strict_isolation {
+    my ($invocant, $ccs, $assignee, $qa_contact, $product) = @_;
+    return unless Bugzilla->params->{'strict_isolation'};
+
+    if (ref $invocant) {
+        my $original = $invocant->new($invocant->id);
+
+        # We only check people if they've been added. This way, if
+        # strict_isolation is turned on when there are invalid users
+        # on bugs, people can still add comments and so on.
+        my @old_cc = map { $_->id } @{$original->cc_users};
+        my @new_cc = map { $_->id } @{$invocant->cc_users};
+        my ($removed, $added) = diff_arrays(\@old_cc, \@new_cc);
+        $ccs = Bugzilla::User->new_from_list($added);
+
+        $assignee = $invocant->assigned_to
+            if $invocant->assigned_to->id != $original->assigned_to->id;
+        if ($invocant->qa_contact
+            && (!$original->qa_contact
+                || $invocant->qa_contact->id != $original->qa_contact->id))
+        {
+            $qa_contact = $invocant->qa_contact;
+        }
+        $product = $invocant->product_obj;
+    }
+
+    my @related_users = @$ccs;
+    push(@related_users, $assignee) if $assignee;
+
+    if (Bugzilla->params->{'useqacontact'} && $qa_contact) {
+        push(@related_users, $qa_contact);
+    }
+
+    @related_users = @{Bugzilla::User->new_from_list(\@related_users)}
+        if !ref $invocant;
+
+    # For each unique user in @related_users...(assignee and qa_contact
+    # could be duplicates of users in the CC list)
+    my %unique_users = map {$_->id => $_} @related_users;
+    my @blocked_users;
+    foreach my $id (keys %unique_users) {
+        my $related_user = $unique_users{$id};
+        if (!$related_user->can_edit_product($product->id) ||
+            !$related_user->can_see_product($product->name)) {
+            push (@blocked_users, $related_user->login);
+        }
+    }
+    if (scalar(@blocked_users)) {
+        my %vars = ( users   => \@blocked_users,
+                     product => $product->name );
+        if (ref $invocant) {
+            $vars{'bug_id'} = $invocant->id;
+        }
+        else {
+            $vars{'new'} = 1;
+        }
+        ThrowUserError("invalid_user_group", \%vars);
+    }
+}
+
+# This is used by various set_ checkers, to make their code simpler.
+sub _check_strict_isolation_for_user {
+    my ($self, $user) = @_;
+    return unless Bugzilla->params->{"strict_isolation"};
+    if (!$user->can_edit_product($self->{product_id})) {
+        ThrowUserError('invalid_user_group',
+                       { users   => $user->login,
+                         product => $self->product,
+                         bug_id  => $self->id });
+    }
+}
+
+sub _check_tag_name {
+    my ($invocant, $tag) = @_;
+
+    $tag = clean_text($tag);
+    $tag || ThrowUserError('no_tag_to_edit');
+    ThrowUserError('tag_name_too_long') if length($tag) > MAX_LEN_QUERY_NAME;
+    trick_taint($tag);
+    # Tags are all lowercase.
+    return lc($tag);
+}
+
+sub _check_target_milestone {
+    my ($invocant, $target, undef, $params) = @_;
+    my $product = blessed($invocant) ? $invocant->product_obj 
+                                     : $params->{product};
+    my $old_target = blessed($invocant) ? $invocant->target_milestone : '';
+    $target = trim($target);
+    $target = $product->default_milestone if !defined $target;
+    my $object = Bugzilla::Milestone->check(
+        { product => $product, name => $target });
+    if ($old_target && $object->name ne $old_target && !$object->is_active) {
+        ThrowUserError('value_inactive', { class => ref($object),  value => $target });
+    }
+    return $object->name;
+}
+
+sub _check_time_field {
+    my ($invocant, $value, $field, $params) = @_;
+
+    # When filing bugs, we're forgiving and just return 0 if
+    # the user isn't a timetracker. When updating bugs, check_can_change_field
+    # controls permissions, so we don't want to check them here.
+    if (!ref $invocant and !Bugzilla->user->is_timetracker) {
+        return 0;
+    }
+
+    # check_time is in Bugzilla::Object.
+    return $invocant->check_time($value, $field, $params);
+}
+
+sub _check_version {
+    my ($invocant, $version, undef, $params) = @_;
+    $version = trim($version);
+    my $product = blessed($invocant) ? $invocant->product_obj 
+                                     : $params->{product};
+    my $old_vers = blessed($invocant) ? $invocant->version : '';
+    my $object = Bugzilla::Version->check({ product => $product, name => $version });
+    if ($object->name ne $old_vers && !$object->is_active) {
+        ThrowUserError('value_inactive', { class => ref($object), value => $version });
+    }
+    return $object->name;
+}
+
+# Custom Field Validators
+
+sub _check_field_is_mandatory {
+    my ($invocant, $value, $field, $params) = @_;
+
+    if (!blessed($field)) {
+        $field = Bugzilla::Field->new({ name => $field });
+        return if !$field;
+    }
+
+    return if !$field->is_mandatory;
+
+    return if !$field->is_visible_on_bug($params || $invocant);
+
+    return if ($field->type == FIELD_TYPE_SINGLE_SELECT
+                 && scalar @{ get_legal_field_values($field->name) } == 1);
+
+    return if ($field->type == FIELD_TYPE_MULTI_SELECT
+                 && !scalar @{ get_legal_field_values($field->name) });
+
+    if (ref($value) eq 'ARRAY') {
+        $value = join('', @$value);
+    }
+
+    $value = trim($value);
+    if (!defined($value)
+        or $value eq ""
+        or ($value eq '---' and $field->type == FIELD_TYPE_SINGLE_SELECT)
+        or ($value =~ EMPTY_DATETIME_REGEX
+            and $field->type == FIELD_TYPE_DATETIME))
+    {
+        ThrowUserError('required_field', { field => $field });
+    }
+}
+
+sub _check_datetime_field {
+    my ($invocant, $date_time) = @_;
+
+    # Empty datetimes are empty strings or strings only containing
+    # 0's, whitespace, and punctuation.
+    if ($date_time =~ /^[\s0[:punct:]]*$/) {
+        return undef;
+    }
+
+    $date_time = trim($date_time);
+    my ($date, $time) = split(' ', $date_time);
+    if ($date && !validate_date($date)) {
+        ThrowUserError('illegal_date', { date   => $date,
+                                         format => 'YYYY-MM-DD' });
+    }
+    if ($time && !validate_time($time)) {
+        ThrowUserError('illegal_time', { 'time' => $time,
+                                         format => 'HH:MM:SS' });
+    }
+    return $date_time
+}
+
+sub _check_default_field { return defined $_[1] ? trim($_[1]) : ''; }
+
+sub _check_freetext_field {
+    my ($invocant, $text, $field) = @_;
+
+    $text = (defined $text) ? trim($text) : '';
+    if (length($text) > MAX_FREETEXT_LENGTH) {
+        ThrowUserError('freetext_too_long', 
+                       { field => $field, text => $text });
+    }
+    return $text;
+}
+
+sub _check_multi_select_field {
+    my ($invocant, $values, $field) = @_;
+
+    # Allow users (mostly email_in.pl) to specify multi-selects as
+    # comma-separated values.
+    if (defined $values and !ref $values) {
+        # We don't split on spaces because multi-select values can and often
+        # do have spaces in them. (Theoretically they can have commas in them
+        # too, but that's much less common and people should be able to work
+        # around it pretty cleanly, if they want to use email_in.pl.)
+        $values = [split(',', $values)];
+    }
+
+    return [] if !$values;
+    my @checked_values;
+    foreach my $value (@$values) {
+        push(@checked_values, $invocant->_check_select_field($value, $field));
+    }
+    return \@checked_values;
+}
+
+sub _check_select_field {
+    my ($invocant, $value, $field) = @_;
+    my $object = Bugzilla::Field::Choice->type($field)->check($value);
+    return $object->name;
+}
+
+sub _check_bugid_field {
+    my ($invocant, $value, $field) = @_;
+    return undef if !$value;
+    
+    # check that the value is a valid, visible bug id
+    my $checked_id = $invocant->check($value, $field)->id;
+    
+    # check for loop (can't have a loop if this is a new bug)
+    if (ref $invocant) {
+        _check_relationship_loop($field, $invocant->bug_id, $checked_id);
+    }
+
+    return $checked_id;
+}
+
+sub _check_textarea_field {
+    my ($invocant, $text, $field) = @_;
+
+    $text = (defined $text) ? trim($text) : '';
+
+    # Web browsers submit newlines as \r\n.
+    # Sanitize all input to match the web standard.
+    # XMLRPC input could be either \n or \r\n
+    $text =~ s/\r?\n/\r\n/g;
+
+    return $text;
+}
+
+sub _check_relationship_loop {
+    # Generates a dependency tree for a given bug.  Calls itself recursively
+    # to generate sub-trees for the bug's dependencies.
+    my ($field, $bug_id, $dep_id, $ids) = @_;
+
+    # Don't do anything if this bug doesn't have any dependencies.
+    return unless defined($dep_id);
+
+    # Check whether we have seen this bug yet
+    $ids = {} unless defined $ids;
+    $ids->{$bug_id} = 1;
+    if ($ids->{$dep_id}) {
+        ThrowUserError("relationship_loop_single", {
+            'bug_id' => $bug_id,
+            'dep_id' => $dep_id,
+            'field_name' => $field});
+    }
+    
+    # Get this dependency's record from the database
+    my $dbh = Bugzilla->dbh;
+    my $next_dep_id = $dbh->selectrow_array(
+        "SELECT $field FROM bugs WHERE bug_id = ?", undef, $dep_id);
+
+    _check_relationship_loop($field, $dep_id, $next_dep_id, $ids);
+}
+
+#####################################################################
+# Class Accessors
+#####################################################################
+
+sub fields {
+    my $class = shift;
+
+   my @fields =
+   (
+        # Standard Fields
+        # Keep this ordering in sync with bugzilla.dtd.
+        qw(bug_id alias creation_ts short_desc delta_ts
+           reporter_accessible cclist_accessible
+           classification_id classification
+           product component version rep_platform op_sys
+           bug_status resolution dup_id see_also
+           bug_file_loc status_whiteboard keywords
+           priority bug_severity target_milestone
+           dependson blocked everconfirmed
+           reporter assigned_to cc estimated_time
+           remaining_time actual_time deadline),
+
+        # Conditional Fields
+        Bugzilla->params->{'useqacontact'} ? "qa_contact" : (),
+        # Custom Fields
+        map { $_->name } Bugzilla->active_custom_fields
+    );
+    Bugzilla::Hook::process('bug_fields', {'fields' => \@fields} );
+    
+    return @fields;
+}
+
+#####################################################################
+# Mutators 
+#####################################################################
+
+# To run check_can_change_field.
+sub _set_global_validator {
+    my ($self, $value, $field) = @_;
+    my $current = $self->$field;
+    my $privs;
+
+    if (ref $current && ref($current) ne 'ARRAY'
+        && $current->isa('Bugzilla::Object')) {
+        $current = $current->id ;
+    }
+    if (ref $value && ref($value) ne 'ARRAY'
+        && $value->isa('Bugzilla::Object')) {
+        $value = $value->id ;
+    }
+    my $can = $self->check_can_change_field($field, $current, $value, \$privs);
+    if (!$can) {
+        if ($field eq 'assigned_to' || $field eq 'qa_contact') {
+            $value   = user_id_to_login($value);
+            $current = user_id_to_login($current);
+        }
+        ThrowUserError('illegal_change', { field    => $field,
+                                           oldvalue => $current,
+                                           newvalue => $value,
+                                           privs    => $privs });
+    }
+    $self->_check_field_is_mandatory($value, $field);
+}
+
+
+#################
+# "Set" Methods #
+#################
+
+# Note that if you are changing multiple bugs at once, you must pass
+# other_bugs to set_all in order for it to behave properly.
+sub set_all {
+    my $self = shift;
+    my ($input_params) = @_;
+    
+    # Clone the data as we are going to alter it, and this would affect
+    # subsequent bugs when calling set_all() again, as some fields would
+    # be modified or no longer defined.
+    my $params = {};
+    %$params = %$input_params;
+
+    # You cannot mark bugs as duplicate when changing several bugs at once
+    # (because currently there is no way to check for duplicate loops in that
+    # situation). You also cannot set the alias of several bugs at once.
+    if ($params->{other_bugs} and scalar @{ $params->{other_bugs} } > 1) {
+        ThrowUserError('dupe_not_allowed') if exists $params->{dup_id};
+        ThrowUserError('multiple_alias_not_allowed') 
+            if defined $params->{alias};
+    }
+
+    # For security purposes, and because lots of other checks depend on it,
+    # we set the product first before anything else.
+    my $product_changed; # Used only for strict_isolation checks.
+    if (exists $params->{'product'}) {
+        $product_changed = $self->_set_product($params->{'product'}, $params);
+    }
+
+    # strict_isolation checks mean that we should set the groups
+    # immediately after changing the product.
+    $self->_add_remove($params, 'groups');
+
+    if (exists $params->{'dependson'} or exists $params->{'blocked'}) {
+        my %set_deps;
+        foreach my $name (qw(dependson blocked)) {
+            my @dep_ids = @{ $self->$name };
+            # If only one of the two fields was passed in, then we need to
+            # retain the current value for the other one.
+            if (!exists $params->{$name}) {
+                $set_deps{$name} = \@dep_ids;
+                next;
+            }
+
+            # Explicitly setting them to a particular value overrides
+            # add/remove.
+            if (exists $params->{$name}->{set}) {
+                $set_deps{$name} = $params->{$name}->{set};
+                next;
+            }
+
+            foreach my $add (@{ $params->{$name}->{add} || [] }) {
+                push(@dep_ids, $add) if !grep($_ == $add, @dep_ids);
+            }
+            foreach my $remove (@{ $params->{$name}->{remove} || [] }) {
+                @dep_ids = grep($_ != $remove, @dep_ids);
+            }
+            $set_deps{$name} = \@dep_ids;
+        }
+
+        $self->set_dependencies($set_deps{'dependson'}, $set_deps{'blocked'});
+    }
+
+    if (exists $params->{'keywords'}) {
+        # Sorting makes the order "add, remove, set", just like for other
+        # fields.
+        foreach my $action (sort keys %{ $params->{'keywords'} }) {
+            $self->modify_keywords($params->{'keywords'}->{$action}, $action);
+        }
+    }
+
+    if (exists $params->{'comment'} or exists $params->{'work_time'}) {
+        # Add a comment as needed to each bug. This is done early because
+        # there are lots of things that want to check if we added a comment.
+        $self->add_comment($params->{'comment'}->{'body'},
+            { isprivate => $params->{'comment'}->{'is_private'},
+              work_time => $params->{'work_time'} });
+    }
+
+    my %normal_set_all;
+    foreach my $name (keys %$params) {
+        # These are handled separately below.
+        if ($self->can("set_$name")) {
+            $normal_set_all{$name} = $params->{$name};
+        }
+    }
+    $self->SUPER::set_all(\%normal_set_all);
+
+    $self->reset_assigned_to if $params->{'reset_assigned_to'};
+    $self->reset_qa_contact  if $params->{'reset_qa_contact'};
+
+    $self->_add_remove($params, 'see_also');
+
+    # And set custom fields.
+    my @custom_fields = Bugzilla->active_custom_fields;
+    foreach my $field (@custom_fields) {
+        my $fname = $field->name;
+        if (exists $params->{$fname}) {
+            $self->set_custom_field($field, $params->{$fname});
+        }
+    }
+
+    $self->_add_remove($params, 'cc');
+
+    # Theoretically you could move a product without ever specifying
+    # a new assignee or qa_contact, or adding/removing any CCs. So,
+    # we have to check that the current assignee, qa, and CCs are still
+    # valid if we've switched products, under strict_isolation. We can only
+    # do that here, because if they *did* change the assignee, qa, or CC,
+    # then we don't want to check the original ones, only the new ones. 
+    $self->_check_strict_isolation() if $product_changed;
+}
+
+# Helper for set_all that helps with fields that have an "add/remove"
+# pattern instead of a "set_" pattern.
+sub _add_remove {
+    my ($self, $params, $name) = @_;
+    my @add    = @{ $params->{$name}->{add}    || [] };
+    my @remove = @{ $params->{$name}->{remove} || [] };
+    $name =~ s/s$//;
+    my $add_method = "add_$name";
+    my $remove_method = "remove_$name";
+    $self->$add_method($_) foreach @add;
+    $self->$remove_method($_) foreach @remove;
+}
+
+sub set_alias { $_[0]->set('alias', $_[1]); }
+sub set_assigned_to {
+    my ($self, $value) = @_;
+    $self->set('assigned_to', $value);
+    # Store the old assignee. check_can_change_field() needs it.
+    $self->{'_old_assigned_to'} = $self->{'assigned_to_obj'}->id;
+    delete $self->{'assigned_to_obj'};
+}
+sub reset_assigned_to {
+    my $self = shift;
+    my $comp = $self->component_obj;
+    $self->set_assigned_to($comp->default_assignee);
+}
+sub set_cclist_accessible { $_[0]->set('cclist_accessible', $_[1]); }
+sub set_comment_is_private {
+    my ($self, $comment_id, $isprivate) = @_;
+
+    # We also allow people to pass in a hash of comment ids to update.
+    if (ref $comment_id) {
+        while (my ($id, $is) = each %$comment_id) {
+            $self->set_comment_is_private($id, $is);
+        }
+        return;
+    }
+
+    my ($comment) = grep($comment_id == $_->id, @{ $self->comments });
+    ThrowUserError('comment_invalid_isprivate', { id => $comment_id }) 
+        if !$comment;
+
+    $isprivate = $isprivate ? 1 : 0;
+    if ($isprivate != $comment->is_private) {
+        ThrowUserError('user_not_insider') if !Bugzilla->user->is_insider;
+        $self->{comment_isprivate} ||= [];
+        $comment->set_is_private($isprivate);
+        push @{$self->{comment_isprivate}}, $comment;
+    }
+}
+sub set_component  {
+    my ($self, $name) = @_;
+    my $old_comp  = $self->component_obj;
+    my $component = $self->_check_component($name);
+    if ($old_comp->id != $component->id) {
+        $self->{component_id}  = $component->id;
+        $self->{component}     = $component->name;
+        $self->{component_obj} = $component;
+        # For update()
+        $self->{_old_component_name} = $old_comp->name;
+        # Add in the Default CC of the new Component;
+        foreach my $cc (@{$component->initial_cc}) {
+            $self->add_cc($cc);
+        }
+    }
+}
+sub set_custom_field {
+    my ($self, $field, $value) = @_;
+
+    if (ref $value eq 'ARRAY' && $field->type != FIELD_TYPE_MULTI_SELECT) {
+        $value = $value->[0];
+    }
+    ThrowCodeError('field_not_custom', { field => $field }) if !$field->custom;
+    $self->set($field->name, $value);
+}
+sub set_deadline { $_[0]->set('deadline', $_[1]); }
+sub set_dependencies {
+    my ($self, $dependson, $blocked) = @_;
+    my %extra = ( blocked => $blocked );
+    $dependson = $self->_check_dependencies($dependson, 'dependson', \%extra);
+    $blocked = $extra{blocked};
+    # These may already be detainted, but all setters are supposed to
+    # detaint their input if they've run a validator (just as though
+    # we had used Bugzilla::Object::set), so we do that here.
+    detaint_natural($_) foreach (@$dependson, @$blocked);
+    $self->{'dependson'} = $dependson;
+    $self->{'blocked'}   = $blocked;
+    delete $self->{depends_on_obj};
+    delete $self->{blocks_obj};
+}
+sub _clear_dup_id { $_[0]->{dup_id} = undef; }
+sub set_dup_id {
+    my ($self, $dup_id) = @_;
+    my $old = $self->dup_id || 0;
+    $self->set('dup_id', $dup_id);
+    my $new = $self->dup_id;
+    return if $old == $new;
+
+    # Make sure that we have the DUPLICATE resolution. This is needed
+    # if somebody calls set_dup_id without calling set_bug_status or
+    # set_resolution.
+    if ($self->resolution ne 'DUPLICATE') {
+        # Even if the current status is VERIFIED, we change it back to
+        # RESOLVED (or whatever the duplicate_or_move_bug_status is) here,
+        # because that's the same thing the UI does when you click on the
+        # "Mark as Duplicate" link. If people really want to retain their
+        # current status, they can use set_bug_status and set the DUPLICATE
+        # resolution before getting here.
+        $self->set_bug_status(
+            Bugzilla->params->{'duplicate_or_move_bug_status'},
+            { resolution => 'DUPLICATE' });
+    }
+    
+    # Update the other bug.
+    my $dupe_of = new Bugzilla::Bug($self->dup_id);
+    if (delete $self->{_add_dup_cc}) {
+        $dupe_of->add_cc($self->reporter);
+    }
+    $dupe_of->add_comment("", { type       => CMT_HAS_DUPE,
+                                extra_data => $self->id });
+    $self->{_dup_for_update} = $dupe_of;
+    
+    # Now make sure that we add a duplicate comment on *this* bug.
+    # (Change an existing comment into a dup comment, if there is one,
+    # or add an empty dup comment.)
+    if ($self->{added_comments}) {
+        my @normal = grep { !defined $_->{type} || $_->{type} == CMT_NORMAL }
+                          @{ $self->{added_comments} };
+        # Turn the last one into a dup comment.
+        $normal[-1]->{type} = CMT_DUPE_OF;
+        $normal[-1]->{extra_data} = $self->dup_id;
+    }
+    else {
+        $self->add_comment('', { type       => CMT_DUPE_OF,
+                                 extra_data => $self->dup_id });
+    }
+}
+sub set_estimated_time { $_[0]->set('estimated_time', $_[1]); }
+sub _set_everconfirmed { $_[0]->set('everconfirmed', $_[1]); }
+sub set_flags {
+    my ($self, $flags, $new_flags) = @_;
+
+    Bugzilla::Flag->set_flag($self, $_) foreach (@$flags, @$new_flags);
+}
+sub set_op_sys         { $_[0]->set('op_sys',        $_[1]); }
+sub set_platform       { $_[0]->set('rep_platform',  $_[1]); }
+sub set_priority       { $_[0]->set('priority',      $_[1]); }
+# For security reasons, you have to use set_all to change the product.
+# See the strict_isolation check in set_all for an explanation.
+sub _set_product {
+    my ($self, $name, $params) = @_;
+    my $old_product = $self->product_obj;
+    my $product = $self->_check_product($name);
+    
+    my $product_changed = 0;
+    if ($old_product->id != $product->id) {
+        $self->{product_id}  = $product->id;
+        $self->{product}     = $product->name;
+        $self->{product_obj} = $product;
+        # For update()
+        $self->{_old_product_name} = $old_product->name;
+        # Delete fields that depend upon the old Product value.
+        delete $self->{choices};
+        $product_changed = 1;
+    }
+
+    $params ||= {};
+    # We delete these so that they're not set again later in set_all.
+    my $comp_name = delete $params->{component} || $self->component;
+    my $vers_name = delete $params->{version}   || $self->version;
+    my $tm_name   = delete $params->{target_milestone};
+    # This way, if usetargetmilestone is off and we've changed products,
+    # set_target_milestone will reset our target_milestone to
+    # $product->default_milestone. But if we haven't changed products,
+    # we don't reset anything.
+    if (!defined $tm_name
+        && (Bugzilla->params->{'usetargetmilestone'} || !$product_changed))
+    {
+        $tm_name = $self->target_milestone;
+    }
+
+    if ($product_changed && Bugzilla->usage_mode == USAGE_MODE_BROWSER) {
+        # Try to set each value with the new product.
+        # Have to set error_mode because Throw*Error calls exit() otherwise.
+        my $old_error_mode = Bugzilla->error_mode;
+        Bugzilla->error_mode(ERROR_MODE_DIE);
+        my $component_ok = eval { $self->set_component($comp_name);      1; };
+        my $version_ok   = eval { $self->set_version($vers_name);        1; };
+        my $milestone_ok = 1;
+        # Reporters can move bugs between products but not set the TM.
+        if ($self->check_can_change_field('target_milestone', 0, 1)) {
+            $milestone_ok = eval { $self->set_target_milestone($tm_name); 1; };
+        }
+        else {
+            # Have to set this directly to bypass the validators.
+            $self->{target_milestone} = $product->default_milestone;
+        }
+        # If there were any errors thrown, make sure we don't mess up any
+        # other part of Bugzilla that checks $@.
+        undef $@;
+        Bugzilla->error_mode($old_error_mode);
+        
+        my $verified = $params->{product_change_confirmed};
+        my %vars;
+        if (!$verified || !$component_ok || !$version_ok || !$milestone_ok) {
+            $vars{defaults} = {
+                # Note that because of the eval { set } above, these are
+                # already set correctly if they're valid, otherwise they're
+                # set to some invalid value which the template will ignore.
+                component => $self->component,
+                version   => $self->version,
+                milestone => $milestone_ok ? $self->target_milestone
+                                           : $product->default_milestone
+            };
+            $vars{components} = [map { $_->name } grep($_->is_active, @{$product->components})];
+            $vars{milestones} = [map { $_->name } grep($_->is_active, @{$product->milestones})];
+            $vars{versions}   = [map { $_->name } grep($_->is_active, @{$product->versions})];
+        }
+
+        if (!$verified) {
+            $vars{verify_bug_groups} = 1;
+            my $dbh = Bugzilla->dbh;
+            my @idlist = ($self->id);
+            push(@idlist, map {$_->id} @{ $params->{other_bugs} })
+                if $params->{other_bugs};
+            # Get the ID of groups which are no longer valid in the new product.
+            my $gids = $dbh->selectcol_arrayref(
+                'SELECT bgm.group_id
+                   FROM bug_group_map AS bgm
+                  WHERE bgm.bug_id IN (' . join(',', ('?') x @idlist) . ')
+                    AND bgm.group_id NOT IN
+                        (SELECT gcm.group_id
+                           FROM group_control_map AS gcm
+                           WHERE gcm.product_id = ?
+                                 AND ( (gcm.membercontrol != ?
+                                        AND gcm.group_id IN ('
+                                        . Bugzilla->user->groups_as_string . '))
+                                       OR gcm.othercontrol != ?) )',
+                undef, (@idlist, $product->id, CONTROLMAPNA, CONTROLMAPNA));
+            $vars{'old_groups'} = Bugzilla::Group->new_from_list($gids);            
+        }
+        
+        if (%vars) {
+            $vars{product} = $product;
+            $vars{bug} = $self;
+            my $template = Bugzilla->template;
+            $template->process("bug/process/verify-new-product.html.tmpl",
+                \%vars) || ThrowTemplateError($template->error());
+            exit;
+        }
+    }
+    else {
+        # When we're not in the browser (or we didn't change the product), we
+        # just die if any of these are invalid.
+        $self->set_component($comp_name);
+        $self->set_version($vers_name);
+        if ($product_changed 
+            and !$self->check_can_change_field('target_milestone', 0, 1)) 
+        {
+            # Have to set this directly to bypass the validators.
+            $self->{target_milestone} = $product->default_milestone;
+        }
+        else {
+            $self->set_target_milestone($tm_name);
+        }
+    }
+
+    if ($product_changed) {
+        # Remove groups that can't be set in the new product.
+        # We copy this array because the original array is modified while we're
+        # working, and that confuses "foreach".
+        my @current_groups = @{$self->groups_in};
+        foreach my $group (@current_groups) {
+            if (!$product->group_is_valid($group)) {
+                $self->remove_group($group);
+            }
+        }
+
+        # Make sure the bug is in all the mandatory groups for the new product.
+        foreach my $group (@{$product->groups_mandatory}) {
+            $self->add_group($group);
+        }
+    }
+    
+    return $product_changed;
+}
+
+sub set_qa_contact {
+    my ($self, $value) = @_;
+    $self->set('qa_contact', $value);
+    # Store the old QA contact. check_can_change_field() needs it.
+    if ($self->{'qa_contact_obj'}) {
+        $self->{'_old_qa_contact'} = $self->{'qa_contact_obj'}->id;
+    }
+    delete $self->{'qa_contact_obj'};
+}
+sub reset_qa_contact {
+    my $self = shift;
+    my $comp = $self->component_obj;
+    $self->set_qa_contact($comp->default_qa_contact);
+}
+sub set_remaining_time { $_[0]->set('remaining_time', $_[1]); }
+# Used only when closing a bug or moving between closed states.
+sub _zero_remaining_time { $_[0]->{'remaining_time'} = 0; }
+sub set_reporter_accessible { $_[0]->set('reporter_accessible', $_[1]); }
+sub set_resolution {
+    my ($self, $value, $params) = @_;
+    
+    my $old_res = $self->resolution;
+    $self->set('resolution', $value);
+    delete $self->{choices};
+    my $new_res = $self->resolution;
+
+    if ($new_res ne $old_res) {
+        # Clear the dup_id if we're leaving the dup resolution.
+        if ($old_res eq 'DUPLICATE') {
+            $self->_clear_dup_id();
+        }
+        # Duplicates should have no remaining time left.
+        elsif ($new_res eq 'DUPLICATE' && $self->remaining_time != 0) {
+            $self->_zero_remaining_time();
+        }
+    }
+    
+    # We don't check if we're entering or leaving the dup resolution here,
+    # because we could be moving from being a dup of one bug to being a dup
+    # of another, theoretically. Note that this code block will also run
+    # when going between different closed states.
+    if ($self->resolution eq 'DUPLICATE') {
+        if (my $dup_id = $params->{dup_id}) {
+            $self->set_dup_id($dup_id);
+        }
+        elsif (!$self->dup_id) {
+            ThrowUserError('dupe_id_required');
+        }
+    }
+
+    # This method has handled dup_id, so set_all doesn't have to worry
+    # about it now.
+    delete $params->{dup_id};
+}
+sub clear_resolution {
+    my $self = shift;
+    if (!$self->status->is_open) {
+        ThrowUserError('resolution_cant_clear', { bug_id => $self->id });
+    }
+    $self->{'resolution'} = ''; 
+    $self->_clear_dup_id; 
+}
+sub set_severity       { $_[0]->set('bug_severity',  $_[1]); }
+sub set_bug_status {
+    my ($self, $status, $params) = @_;
+    my $old_status = $self->status;
+    $self->set('bug_status', $status);
+    delete $self->{'status'};
+    delete $self->{'statuses_available'};
+    delete $self->{'choices'};
+    my $new_status = $self->status;
+   
+    if ($new_status->is_open) {
+        # Check for the everconfirmed transition
+        $self->_set_everconfirmed($new_status->name eq 'UNCONFIRMED' ? 0 : 1);
+        $self->clear_resolution();
+        # Calling clear_resolution handled the "resolution" and "dup_id"
+        # setting, so set_all doesn't have to worry about them.
+        delete $params->{resolution};
+        delete $params->{dup_id};
+    }
+    else {
+        # We do this here so that we can make sure closed statuses have
+        # resolutions.
+        my $resolution = $self->resolution;
+        # We need to check "defined" to prevent people from passing
+        # a blank resolution in the WebService, which would otherwise fail
+        # silently.
+        if (defined $params->{resolution}) {
+            $resolution = delete $params->{resolution};
+        }
+        $self->set_resolution($resolution, $params);
+
+        # Changing between closed statuses zeros the remaining time.
+        if ($new_status->id != $old_status->id && $self->remaining_time != 0) {
+            $self->_zero_remaining_time();
+        }
+    }
+}
+sub set_status_whiteboard { $_[0]->set('status_whiteboard', $_[1]); }
+sub set_summary           { $_[0]->set('short_desc',        $_[1]); }
+sub set_target_milestone  { $_[0]->set('target_milestone',  $_[1]); }
+sub set_url               { $_[0]->set('bug_file_loc',      $_[1]); }
+sub set_version           { $_[0]->set('version',           $_[1]); }
+
+########################
+# "Add/Remove" Methods #
+########################
+
+# These are in alphabetical order by field name.
+
+# Accepts a User object or a username. Adds the user only if they
+# don't already exist as a CC on the bug.
+sub add_cc {
+    my ($self, $user_or_name) = @_;
+    return if !$user_or_name;
+    my $user = ref $user_or_name ? $user_or_name
+                                 : Bugzilla::User->check($user_or_name);
+    $self->_check_strict_isolation_for_user($user);
+    my $cc_users = $self->cc_users;
+    push(@$cc_users, $user) if !grep($_->id == $user->id, @$cc_users);
+}
+
+# Accepts a User object or a username. Removes the User if they exist
+# in the list, but doesn't throw an error if they don't exist.
+sub remove_cc {
+    my ($self, $user_or_name) = @_;
+    my $user = ref $user_or_name ? $user_or_name
+                                 : Bugzilla::User->check($user_or_name);
+    my $currentUser = Bugzilla->user;
+    if (!$self->user->{'canedit'} && $user->id != $currentUser->id) {
+        ThrowUserError('cc_remove_denied');
+    }
+    my $cc_users = $self->cc_users;
+    @$cc_users = grep { $_->id != $user->id } @$cc_users;
+}
+
+# $bug->add_comment("comment", {isprivate => 1, work_time => 10.5,
+#                               type => CMT_NORMAL, extra_data => $data});
+sub add_comment {
+    my ($self, $comment, $params) = @_;
+
+    $params ||= {};
+
+    # Fill out info that doesn't change and callers may not pass in
+    $params->{'bug_id'}  = $self;
+    $params->{'thetext'} = defined($comment) ? $comment : '';
+
+    # Validate all the entered data
+    Bugzilla::Comment->check_required_create_fields($params);
+    $params = Bugzilla::Comment->run_create_validators($params);
+
+    # This makes it so we won't create new comments when there is nothing
+    # to add 
+    if ($params->{'thetext'} eq ''
+        && !($params->{type} || abs($params->{work_time} || 0)))
+    {
+        return;
+    }
+
+    # If the user has explicitly set remaining_time, this will be overridden
+    # later in set_all. But if they haven't, this keeps remaining_time
+    # up-to-date.
+    if ($params->{work_time}) {
+        $self->set_remaining_time(max($self->remaining_time - $params->{work_time}, 0));
+    }
+
+    $self->{added_comments} ||= [];
+
+    push(@{$self->{added_comments}}, $params);
+}
+
+# There was a lot of duplicate code when I wrote this as three separate
+# functions, so I just combined them all into one. This is also easier for
+# process_bug to use.
+sub modify_keywords {
+    my ($self, $keywords, $action) = @_;
+    
+    $action ||= 'set';
+    if (!grep($action eq $_, qw(add remove set))) {
+        $action = 'set';
+    }
+    
+    $keywords = $self->_check_keywords($keywords);
+
+    my (@result, $any_changes);
+    if ($action eq 'set') {
+        @result = @$keywords;
+        # Check if anything was added or removed.
+        my @old_ids = map { $_->id } @{$self->keyword_objects};
+        my @new_ids = map { $_->id } @result;
+        my ($removed, $added) = diff_arrays(\@old_ids, \@new_ids);
+        $any_changes = scalar @$removed || scalar @$added;
+    }
+    else {
+        # We're adding or deleting specific keywords.
+        my %keys = map {$_->id => $_} @{$self->keyword_objects};
+        if ($action eq 'add') {
+            $keys{$_->id} = $_ foreach @$keywords;
+        }
+        else {
+            delete $keys{$_->id} foreach @$keywords;
+        }
+        @result = values %keys;
+        $any_changes = scalar @$keywords;
+    }
+    # Make sure we retain the sort order.
+    @result = sort {lc($a->name) cmp lc($b->name)} @result;
+    
+    if ($any_changes) {
+        my $privs;
+        my $new = join(', ', (map {$_->name} @result));
+        my $check = $self->check_can_change_field('keywords', 0, 1, \$privs)
+            || ThrowUserError('illegal_change', { field    => 'keywords',
+                                                  oldvalue => $self->keywords,
+                                                  newvalue => $new,
+                                                  privs    => $privs });
+    }
+
+    $self->{'keyword_objects'} = \@result;
+}
+
+sub add_group {
+    my ($self, $group) = @_;
+
+    # If the user enters "FoO" but the DB has "Foo", $group->name would
+    # return "Foo" and thus revealing the existence of the group name.
+    # So we have to store and pass the name as entered by the user to
+    # the error message, if we have it.
+    my $group_name = blessed($group) ? $group->name : $group;
+    my $args = { name => $group_name, product => $self->product,
+                 bug_id => $self->id, action => 'add' };
+
+    $group = Bugzilla::Group->check_no_disclose($args) if !blessed $group;
+
+    # If the bug is already in this group, then there is nothing to do.
+    return if $self->in_group($group);
+
+
+    # Make sure that bugs in this product can actually be restricted
+    # to this group by the current user.
+    $self->product_obj->group_is_settable($group)
+         || ThrowUserError('group_restriction_not_allowed', $args);
+
+    # OtherControl people can add groups only during a product change,
+    # and only when the group is not NA for them.
+    if (!Bugzilla->user->in_group($group->name)) {
+        my $controls = $self->product_obj->group_controls->{$group->id};
+        if (!$self->{_old_product_name}
+            || $controls->{othercontrol} == CONTROLMAPNA)
+        {
+            ThrowUserError('group_restriction_not_allowed', $args);
+        }
+    }
+
+    my $current_groups = $self->groups_in;
+    push(@$current_groups, $group);
+}
+
+sub remove_group {
+    my ($self, $group) = @_;
+
+    # See add_group() for the reason why we store the user input.
+    my $group_name = blessed($group) ? $group->name : $group;
+    my $args = { name => $group_name, product => $self->product,
+                 bug_id => $self->id, action => 'remove' };
+
+    $group = Bugzilla::Group->check_no_disclose($args) if !blessed $group;
+
+    # If the bug isn't in this group, then either the name is misspelled,
+    # or the group really doesn't exist. Let the user know about this problem.
+    $self->in_group($group) || ThrowUserError('group_invalid_removal', $args);
+
+    # Check if this is a valid group for this product. You can *always*
+    # remove a group that is not valid for this product (set_product does this).
+    # This particularly happens when we're moving a bug to a new product.
+    # You still have to be a member of an inactive group to remove it.
+    if ($self->product_obj->group_is_valid($group)) {
+        my $controls = $self->product_obj->group_controls->{$group->id};
+
+        # Nobody can ever remove a Mandatory group, unless it became inactive.
+        if ($controls->{membercontrol} == CONTROLMAPMANDATORY && $group->is_active) {
+            ThrowUserError('group_invalid_removal', $args);
+        }
+
+        # OtherControl people can remove groups only during a product change,
+        # and only when they are non-Mandatory and non-NA.
+        if (!Bugzilla->user->in_group($group->name)) {
+            if (!$self->{_old_product_name}
+                || $controls->{othercontrol} == CONTROLMAPMANDATORY
+                || $controls->{othercontrol} == CONTROLMAPNA)
+            {
+                ThrowUserError('group_invalid_removal', $args);
+            }
+        }
+    }
+
+    my $current_groups = $self->groups_in;
+    @$current_groups = grep { $_->id != $group->id } @$current_groups;
+}
+
+sub add_see_also {
+    my ($self, $input, $skip_recursion) = @_;
+
+    # This is needed by xt/search.t.
+    $input = $input->name if blessed($input);
+
+    $input = trim($input);
+    return if !$input;
+
+    my ($class, $uri) = Bugzilla::BugUrl->class_for($input);
+
+    my $params = { value => $uri, bug_id => $self, class => $class };
+    $class->check_required_create_fields($params);
+
+    my $field_values = $class->run_create_validators($params);
+    my $value = $field_values->{value}->as_string;
+    trick_taint($value);
+    $field_values->{value} = $value;
+
+    # We only add the new URI if it hasn't been added yet. URIs are
+    # case-sensitive, but most of our DBs are case-insensitive, so we do
+    # this check case-insensitively.
+    if (!grep { lc($_->name) eq lc($value) } @{ $self->see_also }) {
+        my $privs;
+        my $can = $self->check_can_change_field('see_also', '', $value, \$privs);
+        if (!$can) {
+            ThrowUserError('illegal_change', { field    => 'see_also',
+                                               newvalue => $value,
+                                               privs    => $privs });
+        }
+        # If this is a link to a local bug then save the
+        # ref bug id for sending changes email.
+        my $ref_bug = delete $field_values->{ref_bug};
+        if ($class->isa('Bugzilla::BugUrl::Bugzilla::Local')
+            and !$skip_recursion
+            and $ref_bug->check_can_change_field('see_also', '', $self->id, \$privs))
+        {
+            $ref_bug->add_see_also($self->id, 'skip_recursion');
+            push @{ $self->{_update_ref_bugs} }, $ref_bug;
+            push @{ $self->{see_also_changes} }, $ref_bug->id;
+        }
+        push @{ $self->{see_also} }, bless ($field_values, $class);
+    }
+}
+
+sub remove_see_also {
+    my ($self, $url, $skip_recursion) = @_;
+    my $see_also = $self->see_also;
+
+    # This is needed by xt/search.t.
+    $url = $url->name if blessed($url);
+
+    my ($removed_bug_url, $new_see_also) =
+        part { lc($_->name) ne lc($url) } @$see_also;
+
+    my $privs;
+    my $can = $self->check_can_change_field('see_also', $see_also, $new_see_also, \$privs);
+    if (!$can) {
+        ThrowUserError('illegal_change', { field    => 'see_also',
+                                           oldvalue => $url,
+                                           privs    => $privs });
+    }
+
+    # Since we remove also the url from the referenced bug,
+    # we need to notify changes for that bug too.
+    $removed_bug_url = $removed_bug_url->[0];
+    if (!$skip_recursion and $removed_bug_url
+        and $removed_bug_url->isa('Bugzilla::BugUrl::Bugzilla::Local')
+        and $removed_bug_url->ref_bug_url)
+    {
+        my $ref_bug
+            = Bugzilla::Bug->check($removed_bug_url->ref_bug_url->bug_id);
+
+        if (Bugzilla->user->can_edit_product($ref_bug->product_id)
+            and $ref_bug->check_can_change_field('see_also', $self->id, '', \$privs))
+        {
+            my $self_url = $removed_bug_url->local_uri($self->id);
+            $ref_bug->remove_see_also($self_url, 'skip_recursion');
+            push @{ $self->{_update_ref_bugs} }, $ref_bug;
+            push @{ $self->{see_also_changes} }, $ref_bug->id;
+        }
+    }
+
+    $self->{see_also} = $new_see_also || [];
+}
+
+sub add_tag {
+    my ($self, $tag) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $user = Bugzilla->user;
+    $tag = $self->_check_tag_name($tag);
+
+    my $tag_id = $user->tags->{$tag}->{id};
+    # If this tag doesn't exist for this user yet, create it.
+    if (!$tag_id) {
+        $dbh->do('INSERT INTO tag (user_id, name) VALUES (?, ?)',
+                  undef, ($user->id, $tag));
+
+        $tag_id = $dbh->selectrow_array('SELECT id FROM tag
+                                         WHERE name = ? AND user_id = ?',
+                                         undef, ($tag, $user->id));
+        # The list has changed.
+        delete $user->{tags};
+    }
+    # Do nothing if this tag is already set for this bug.
+    return if grep { $_ eq $tag } @{$self->tags};
+
+    # Increment the counter. Do it before the SQL call below,
+    # to not count the tag twice.
+    $user->tags->{$tag}->{bug_count}++;
+
+    $dbh->do('INSERT INTO bug_tag (bug_id, tag_id) VALUES (?, ?)',
+              undef, ($self->id, $tag_id));
+
+    push(@{$self->{tags}}, $tag);
+}
+
+sub remove_tag {
+    my ($self, $tag) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $user = Bugzilla->user;
+    $tag = $self->_check_tag_name($tag);
+
+    my $tag_id = exists $user->tags->{$tag} ? $user->tags->{$tag}->{id} : undef;
+    # Do nothing if the user doesn't use this tag, or didn't set it for this bug.
+    return unless ($tag_id && grep { $_ eq $tag } @{$self->tags});
+
+    $dbh->do('DELETE FROM bug_tag WHERE bug_id = ? AND tag_id = ?',
+              undef, ($self->id, $tag_id));
+
+    $self->{tags} = [grep { $_ ne $tag } @{$self->tags}];
+
+    # Decrement the counter, and delete the tag if no bugs are using it anymore.
+    if (!--$user->tags->{$tag}->{bug_count}) {
+        $dbh->do('DELETE FROM tag WHERE name = ? AND user_id = ?',
+                  undef, ($tag, $user->id));
+
+        # The list has changed.
+        delete $user->{tags};
+    }
+}
+
+sub tags {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+    my $user = Bugzilla->user;
+
+    # This method doesn't support several users using the same bug object.
+    if (!exists $self->{tags}) {
+        $self->{tags} = $dbh->selectcol_arrayref(
+            'SELECT name FROM bug_tag
+             INNER JOIN tag ON tag.id = bug_tag.tag_id
+             WHERE bug_id = ? AND user_id = ?',
+             undef, ($self->id, $user->id));
+    }
+    return $self->{tags};
+}
+
+#####################################################################
+# Simple Accessors
+#####################################################################
+
+# These are accessors that don't need to access the database.
+# Keep them in alphabetical order.
+
+sub alias               { return $_[0]->{alias}               }
+sub bug_file_loc        { return $_[0]->{bug_file_loc}        }
+sub bug_id              { return $_[0]->{bug_id}              }
+sub bug_severity        { return $_[0]->{bug_severity}        }
+sub bug_status          { return $_[0]->{bug_status}          }
+sub cclist_accessible   { return $_[0]->{cclist_accessible}   }
+sub component_id        { return $_[0]->{component_id}        }
+sub creation_ts         { return $_[0]->{creation_ts}         }
+sub estimated_time      { return $_[0]->{estimated_time}      }
+sub deadline            { return $_[0]->{deadline}            }
+sub delta_ts            { return $_[0]->{delta_ts}            }
+sub error               { return $_[0]->{error}               }
+sub everconfirmed       { return $_[0]->{everconfirmed}       }
+sub lastdiffed          { return $_[0]->{lastdiffed}          }
+sub op_sys              { return $_[0]->{op_sys}              }
+sub priority            { return $_[0]->{priority}            }
+sub product_id          { return $_[0]->{product_id}          }
+sub remaining_time      { return $_[0]->{remaining_time}      }
+sub reporter_accessible { return $_[0]->{reporter_accessible} }
+sub rep_platform        { return $_[0]->{rep_platform}        }
+sub resolution          { return $_[0]->{resolution}          }
+sub short_desc          { return $_[0]->{short_desc}          }
+sub status_whiteboard   { return $_[0]->{status_whiteboard}   }
+sub target_milestone    { return $_[0]->{target_milestone}    }
+sub version             { return $_[0]->{version}             }
+
+#####################################################################
+# Complex Accessors
+#####################################################################
+
+# These are accessors that have to access the database for additional
+# information about a bug.
+
+# These subs are in alphabetical order, as much as possible.
+# If you add a new sub, please try to keep it in alphabetical order
+# with the other ones.
+
+# Note: If you add a new method, remember that you must check the error
+# state of the bug before returning any data. If $self->{error} is
+# defined, then return something empty. Otherwise you risk potential
+# security holes.
+
+sub dup_id {
+    my ($self) = @_;
+    return $self->{'dup_id'} if exists $self->{'dup_id'};
+
+    $self->{'dup_id'} = undef;
+    return if $self->{'error'};
+
+    if ($self->{'resolution'} eq 'DUPLICATE') { 
+        my $dbh = Bugzilla->dbh;
+        $self->{'dup_id'} =
+          $dbh->selectrow_array(q{SELECT dupe_of 
+                                  FROM duplicates
+                                  WHERE dupe = ?},
+                                undef,
+                                $self->{'bug_id'});
+    }
+    return $self->{'dup_id'};
+}
+
+sub _resolve_ultimate_dup_id {
+    my ($bug_id, $dupe_of, $loops_are_an_error) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $sth = $dbh->prepare('SELECT dupe_of FROM duplicates WHERE dupe = ?');
+
+    my $this_dup = $dupe_of || $dbh->selectrow_array($sth, undef, $bug_id);
+    my $last_dup = $bug_id;
+
+    my %dupes;
+    while ($this_dup) {
+        if ($this_dup == $bug_id) {
+            if ($loops_are_an_error) {
+                ThrowUserError('dupe_loop_detected', { bug_id  => $bug_id,
+                                                       dupe_of => $dupe_of });
+            }
+            else {
+                return $last_dup;
+            }
+        }
+        # If $dupes{$this_dup} is already set to 1, then a loop
+        # already exists which does not involve this bug.
+        # As the user is not responsible for this loop, do not
+        # prevent him from marking this bug as a duplicate.
+        return $last_dup if exists $dupes{$this_dup};
+        $dupes{$this_dup} = 1;
+        $last_dup = $this_dup;
+        $this_dup = $dbh->selectrow_array($sth, undef, $this_dup);
+    }
+
+    return $last_dup;
+}
+
+sub actual_time {
+    my ($self) = @_;
+    return $self->{'actual_time'} if exists $self->{'actual_time'};
+
+    if ( $self->{'error'} || !Bugzilla->user->is_timetracker ) {
+        $self->{'actual_time'} = undef;
+        return $self->{'actual_time'};
+    }
+
+    my $sth = Bugzilla->dbh->prepare("SELECT SUM(work_time)
+                                      FROM longdescs 
+                                      WHERE longdescs.bug_id=?");
+    $sth->execute($self->{bug_id});
+    $self->{'actual_time'} = $sth->fetchrow_array();
+    return $self->{'actual_time'};
+}
+
+sub any_flags_requesteeble {
+    my ($self) = @_;
+    return $self->{'any_flags_requesteeble'} 
+        if exists $self->{'any_flags_requesteeble'};
+    return 0 if $self->{'error'};
+
+    my $any_flags_requesteeble =
+      grep { $_->is_requestable && $_->is_requesteeble } @{$self->flag_types};
+    # Useful in case a flagtype is no longer requestable but a requestee
+    # has been set before we turned off that bit.
+    $any_flags_requesteeble ||= grep { $_->requestee_id } @{$self->flags};
+    $self->{'any_flags_requesteeble'} = $any_flags_requesteeble;
+
+    return $self->{'any_flags_requesteeble'};
+}
+
+sub attachments {
+    my ($self) = @_;
+    return $self->{'attachments'} if exists $self->{'attachments'};
+    return [] if $self->{'error'};
+
+    $self->{'attachments'} =
+        Bugzilla::Attachment->get_attachments_by_bug($self, {preload => 1});
+    return $self->{'attachments'};
+}
+
+sub assigned_to {
+    my ($self) = @_;
+    return $self->{'assigned_to_obj'} if exists $self->{'assigned_to_obj'};
+    $self->{'assigned_to'} = 0 if $self->{'error'};
+    $self->{'assigned_to_obj'} ||= new Bugzilla::User($self->{'assigned_to'});
+    return $self->{'assigned_to_obj'};
+}
+
+sub blocked {
+    my ($self) = @_;
+    return $self->{'blocked'} if exists $self->{'blocked'};
+    return [] if $self->{'error'};
+    $self->{'blocked'} = EmitDependList("dependson", "blocked", $self->bug_id);
+    return $self->{'blocked'};
+}
+
+sub blocks_obj {
+    my ($self) = @_;
+    $self->{blocks_obj} ||= $self->_bugs_in_order($self->blocked);
+    return $self->{blocks_obj};
+}
+
+sub bug_group {
+    my ($self) = @_;
+    return join(', ', (map { $_->name } @{$self->groups_in}));
+}
+
+sub related_bugs {
+    my ($self, $relationship) = @_;
+    return [] if $self->{'error'};
+
+    my $field_name = $relationship->name;
+    $self->{'related_bugs'}->{$field_name} ||= $self->match({$field_name => $self->id});
+    return $self->{'related_bugs'}->{$field_name}; 
+}
+
+sub cc {
+    my ($self) = @_;
+    return $self->{'cc'} if exists $self->{'cc'};
+    return [] if $self->{'error'};
+
+    my $dbh = Bugzilla->dbh;
+    $self->{'cc'} = $dbh->selectcol_arrayref(
+        q{SELECT profiles.login_name FROM cc, profiles
+           WHERE bug_id = ?
+             AND cc.who = profiles.userid
+        ORDER BY profiles.login_name},
+      undef, $self->bug_id);
+
+    return $self->{'cc'};
+}
+
+# XXX Eventually this will become the standard "cc" method used everywhere.
+sub cc_users {
+    my $self = shift;
+    return $self->{'cc_users'} if exists $self->{'cc_users'};
+    return [] if $self->{'error'};
+    
+    my $dbh = Bugzilla->dbh;
+    my $cc_ids = $dbh->selectcol_arrayref(
+        'SELECT who FROM cc WHERE bug_id = ?', undef, $self->id);
+    $self->{'cc_users'} = Bugzilla::User->new_from_list($cc_ids);
+    return $self->{'cc_users'};
+}
+
+sub component {
+    my ($self) = @_;
+    return $self->{component} if exists $self->{component};
+    return '' if $self->{error};
+    ($self->{component}) = Bugzilla->dbh->selectrow_array(
+        'SELECT name FROM components WHERE id = ?',
+        undef, $self->{component_id});
+    return $self->{component};
+}
+
+# XXX Eventually this will replace component()
+sub component_obj {
+    my ($self) = @_;
+    return $self->{component_obj} if defined $self->{component_obj};
+    return {} if $self->{error};
+    $self->{component_obj} = new Bugzilla::Component($self->{component_id});
+    return $self->{component_obj};
+}
+
+sub classification_id {
+    my ($self) = @_;
+    return $self->{classification_id} if exists $self->{classification_id};
+    return 0 if $self->{error};
+    ($self->{classification_id}) = Bugzilla->dbh->selectrow_array(
+        'SELECT classification_id FROM products WHERE id = ?',
+        undef, $self->{product_id});
+    return $self->{classification_id};
+}
+
+sub classification {
+    my ($self) = @_;
+    return $self->{classification} if exists $self->{classification};
+    return '' if $self->{error};
+    ($self->{classification}) = Bugzilla->dbh->selectrow_array(
+        'SELECT name FROM classifications WHERE id = ?',
+        undef, $self->classification_id);
+    return $self->{classification};
+}
+
+sub default_bug_status {
+    my $class = shift;
+    # XXX This should just call new_bug_statuses when the UI accepts closed
+    # bug statuses instead of accepting them as a parameter.
+    my @statuses = @_;
+
+    my $status;
+    if (scalar(@statuses) == 1) {
+        $status = $statuses[0]->name;
+    }
+    else {
+        $status = ($statuses[0]->name ne 'UNCONFIRMED')
+                  ? $statuses[0]->name : $statuses[1]->name;
+    }
+
+    return $status;
+}
+
+sub dependson {
+    my ($self) = @_;
+    return $self->{'dependson'} if exists $self->{'dependson'};
+    return [] if $self->{'error'};
+    $self->{'dependson'} = 
+        EmitDependList("blocked", "dependson", $self->bug_id);
+    return $self->{'dependson'};
+}
+
+sub depends_on_obj {
+    my ($self) = @_;
+    $self->{depends_on_obj} ||= $self->_bugs_in_order($self->dependson);
+    return $self->{depends_on_obj};
+}
+
+sub duplicates {
+    my $self = shift;
+    return $self->{duplicates} if exists $self->{duplicates};
+    return [] if $self->{error};
+    $self->{duplicates} = Bugzilla::Bug->new_from_list($self->duplicate_ids);
+    return $self->{duplicates};
+}
+
+sub duplicate_ids {
+    my $self = shift;
+    return $self->{duplicate_ids} if exists $self->{duplicate_ids};
+    return [] if $self->{error};
+
+    my $dbh = Bugzilla->dbh;
+    $self->{duplicate_ids} =
+      $dbh->selectcol_arrayref('SELECT dupe FROM duplicates WHERE dupe_of = ?',
+                               undef, $self->id);
+    return $self->{duplicate_ids};
+}
+
+sub flag_types {
+    my ($self) = @_;
+    return $self->{'flag_types'} if exists $self->{'flag_types'};
+    return [] if $self->{'error'};
+
+    my $vars = { target_type  => 'bug',
+                 product_id   => $self->{product_id},
+                 component_id => $self->{component_id},
+                 bug_id       => $self->bug_id };
+
+    $self->{'flag_types'} = Bugzilla::Flag->_flag_types($vars);
+    return $self->{'flag_types'};
+}
+
+sub flags {
+    my $self = shift;
+
+    # Don't cache it as it must be in sync with ->flag_types.
+    $self->{flags} = [map { @{$_->{flags}} } @{$self->flag_types}];
+    return $self->{flags};
+}
+
+sub isopened {
+    my $self = shift;
+    return is_open_state($self->{bug_status}) ? 1 : 0;
+}
+
+sub keywords {
+    my ($self) = @_;
+    return join(', ', (map { $_->name } @{$self->keyword_objects}));
+}
+
+# XXX At some point, this should probably replace the normal "keywords" sub.
+sub keyword_objects {
+    my $self = shift;
+    return $self->{'keyword_objects'} if defined $self->{'keyword_objects'};
+    return [] if $self->{'error'};
+
+    my $dbh = Bugzilla->dbh;
+    my $ids = $dbh->selectcol_arrayref(
+         "SELECT keywordid FROM keywords WHERE bug_id = ?", undef, $self->id);
+    $self->{'keyword_objects'} = Bugzilla::Keyword->new_from_list($ids);
+    return $self->{'keyword_objects'};
+}
+
+sub comments {
+    my ($self, $params) = @_;
+    return [] if $self->{'error'};
+    $params ||= {};
+
+    if (!defined $self->{'comments'}) {
+        $self->{'comments'} = Bugzilla::Comment->match({ bug_id => $self->id });
+        my $count = 0;
+        foreach my $comment (@{ $self->{'comments'} }) {
+            $comment->{count} = $count++;
+            $comment->{bug} = $self;
+        }
+        Bugzilla::Comment->preload($self->{'comments'});
+    }
+    my @comments = @{ $self->{'comments'} };
+
+    my $order = $params->{order} 
+        || Bugzilla->user->setting('comment_sort_order');
+    if ($order ne 'oldest_to_newest') {
+        @comments = reverse @comments;
+        if ($order eq 'newest_to_oldest_desc_first') {
+            unshift(@comments, pop @comments);
+        }
+    }
+
+    if ($params->{after}) {
+        my $from = datetime_from($params->{after});
+        @comments = grep { datetime_from($_->creation_ts) > $from } @comments;
+    }
+    if ($params->{to}) {
+        my $to = datetime_from($params->{to});
+        @comments = grep { datetime_from($_->creation_ts) <= $to } @comments;
+    }
+    return \@comments;
+}
+
+sub new_bug_statuses {
+    my ($class, $product) = @_;
+    my $user = Bugzilla->user;
+
+    # Construct the list of allowable statuses.
+    my @statuses = @{ Bugzilla::Bug->statuses_available($product) };
+
+    # If the user has no privs...
+    unless ($user->in_group('editbugs', $product->id)
+            || $user->in_group('canconfirm', $product->id))
+    {
+        # ... use UNCONFIRMED if available, else use the first status of the list.
+        my ($unconfirmed) = grep { $_->name eq 'UNCONFIRMED' } @statuses;
+    
+        # Because of an apparent Perl bug, "$unconfirmed || $statuses[0]" doesn't
+        # work, so we're using an "?:" operator. See bug 603314 for details.
+        @statuses = ($unconfirmed ? $unconfirmed : $statuses[0]);
+    }
+
+    return \@statuses;
+}
+
+# This is needed by xt/search.t.
+sub percentage_complete {
+    my $self = shift;
+    return undef if $self->{'error'} || !Bugzilla->user->is_timetracker;
+    my $remaining = $self->remaining_time;
+    my $actual    = $self->actual_time;
+    my $total = $remaining + $actual;
+    return undef if $total == 0;
+    # Search.pm truncates this value to an integer, so we want to as well,
+    # since this is mostly used in a test where its value needs to be
+    # identical to what the database will return.
+    return int(100 * ($actual / $total));
+}
+
+sub product {
+    my ($self) = @_;
+    return $self->{product} if exists $self->{product};
+    return '' if $self->{error};
+    ($self->{product}) = Bugzilla->dbh->selectrow_array(
+        'SELECT name FROM products WHERE id = ?',
+        undef, $self->{product_id});
+    return $self->{product};
+}
+
+# XXX This should eventually replace the "product" subroutine.
+sub product_obj {
+    my $self = shift;
+    return {} if $self->{error};
+    $self->{product_obj} ||= new Bugzilla::Product($self->{product_id});
+    return $self->{product_obj};
+}
+
+sub qa_contact {
+    my ($self) = @_;
+    return $self->{'qa_contact_obj'} if exists $self->{'qa_contact_obj'};
+    return undef if $self->{'error'};
+
+    if (Bugzilla->params->{'useqacontact'} && $self->{'qa_contact'}) {
+        $self->{'qa_contact_obj'} = new Bugzilla::User($self->{'qa_contact'});
+    } else {
+        $self->{'qa_contact_obj'} = undef;
+    }
+    return $self->{'qa_contact_obj'};
+}
+
+sub reporter {
+    my ($self) = @_;
+    return $self->{'reporter'} if exists $self->{'reporter'};
+    $self->{'reporter_id'} = 0 if $self->{'error'};
+    $self->{'reporter'} = new Bugzilla::User($self->{'reporter_id'});
+    return $self->{'reporter'};
+}
+
+sub see_also {
+    my ($self) = @_;
+    return [] if $self->{'error'};
+    if (!exists $self->{see_also}) {
+        my $ids = Bugzilla->dbh->selectcol_arrayref(
+            'SELECT id FROM bug_see_also WHERE bug_id = ?',
+            undef, $self->id);
+
+        my $bug_urls = Bugzilla::BugUrl->new_from_list($ids);
+
+        $self->{see_also} = $bug_urls;
+    }
+    return $self->{see_also};
+}
+
+sub status {
+    my $self = shift;
+    return undef if $self->{'error'};
+
+    $self->{'status'} ||= new Bugzilla::Status({name => $self->{'bug_status'}});
+    return $self->{'status'};
+}
+
+sub statuses_available {
+    my ($invocant, $product) = @_;
+
+    my @statuses;
+
+    if (ref $invocant) {
+      return [] if $invocant->{'error'};
+
+      return $invocant->{'statuses_available'}
+          if defined $invocant->{'statuses_available'};
+
+        @statuses = @{ $invocant->status->can_change_to };
+        $product = $invocant->product_obj;
+    } else {
+        @statuses = @{ Bugzilla::Status->can_change_to };
+    }
+
+    # UNCONFIRMED is only a valid status if it is enabled in this product.
+    if (!$product->allows_unconfirmed) {
+        @statuses = grep { $_->name ne 'UNCONFIRMED' } @statuses;
+    }
+
+    if (ref $invocant) {
+        my $available = $invocant->_refine_available_statuses(@statuses);
+        $invocant->{'statuses_available'} = $available;
+        return $available;
+    }
+
+    return \@statuses;
+}
+
+sub _refine_available_statuses {
+    my $self = shift;
+    my @statuses = @_;
+
+    my @available;
+    foreach my $status (@statuses) {
+        # Make sure this is a legal status transition
+        next if !$self->check_can_change_field(
+                     'bug_status', $self->status->name, $status->name);
+        push(@available, $status);
+    }
+
+    # If this bug has an inactive status set, it should still be in the list.
+    if (!grep($_->name eq $self->status->name, @available)) {
+        unshift(@available, $self->status);
+    }
+    
+    return \@available;
+}
+
+sub show_attachment_flags {
+    my ($self) = @_;
+    return $self->{'show_attachment_flags'} 
+        if exists $self->{'show_attachment_flags'};
+    return 0 if $self->{'error'};
+
+    # The number of types of flags that can be set on attachments to this bug
+    # and the number of flags on those attachments.  One of these counts must be
+    # greater than zero in order for the "flags" column to appear in the table
+    # of attachments.
+    my $num_attachment_flag_types = Bugzilla::FlagType::count(
+        { 'target_type'  => 'attachment',
+          'product_id'   => $self->{'product_id'},
+          'component_id' => $self->{'component_id'} });
+    my $num_attachment_flags = Bugzilla::Flag->count(
+        { 'target_type'  => 'attachment',
+          'bug_id'       => $self->bug_id });
+
+    $self->{'show_attachment_flags'} =
+        ($num_attachment_flag_types || $num_attachment_flags);
+
+    return $self->{'show_attachment_flags'};
+}
+
+sub groups {
+    my $self = shift;
+    return $self->{'groups'} if exists $self->{'groups'};
+    return [] if $self->{'error'};
+
+    my $dbh = Bugzilla->dbh;
+    my @groups;
+
+    # Some of this stuff needs to go into Bugzilla::User
+
+    # For every group, we need to know if there is ANY bug_group_map
+    # record putting the current bug in that group and if there is ANY
+    # user_group_map record putting the user in that group.
+    # The LEFT JOINs are checking for record existence.
+    #
+    my $grouplist = Bugzilla->user->groups_as_string;
+    my $sth = $dbh->prepare(
+             "SELECT DISTINCT groups.id, name, description," .
+             " CASE WHEN bug_group_map.group_id IS NOT NULL" .
+             " THEN 1 ELSE 0 END," .
+             " CASE WHEN groups.id IN($grouplist) THEN 1 ELSE 0 END," .
+             " isactive, membercontrol, othercontrol" .
+             " FROM groups" . 
+             " LEFT JOIN bug_group_map" .
+             " ON bug_group_map.group_id = groups.id" .
+             " AND bug_id = ?" .
+             " LEFT JOIN group_control_map" .
+             " ON group_control_map.group_id = groups.id" .
+             " AND group_control_map.product_id = ? " .
+             " WHERE isbuggroup = 1" .
+             " ORDER BY description");
+    $sth->execute($self->{'bug_id'},
+                  $self->{'product_id'});
+
+    while (my ($groupid, $name, $description, $ison, $ingroup, $isactive,
+            $membercontrol, $othercontrol) = $sth->fetchrow_array()) {
+
+        $membercontrol ||= 0;
+
+        # For product groups, we only want to use the group if either
+        # (1) The bit is set and not required, or
+        # (2) The group is Shown or Default for members and
+        #     the user is a member of the group.
+        if ($ison ||
+            ($isactive && $ingroup
+                       && (($membercontrol == CONTROLMAPDEFAULT)
+                           || ($membercontrol == CONTROLMAPSHOWN))
+            ))
+        {
+            my $ismandatory = $isactive
+              && ($membercontrol == CONTROLMAPMANDATORY);
+
+            push (@groups, { "bit" => $groupid,
+                             "name" => $name,
+                             "ison" => $ison,
+                             "ingroup" => $ingroup,
+                             "mandatory" => $ismandatory,
+                             "description" => $description });
+        }
+    }
+
+    $self->{'groups'} = \@groups;
+
+    return $self->{'groups'};
+}
+
+sub groups_in {
+    my $self = shift;
+    return $self->{'groups_in'} if exists $self->{'groups_in'};
+    return [] if $self->{'error'};
+    my $group_ids = Bugzilla->dbh->selectcol_arrayref(
+        'SELECT group_id FROM bug_group_map WHERE bug_id = ?',
+        undef, $self->id);
+    $self->{'groups_in'} = Bugzilla::Group->new_from_list($group_ids);
+    return $self->{'groups_in'};
+}
+
+sub in_group {
+    my ($self, $group) = @_;
+    return grep($_->id == $group->id, @{$self->groups_in}) ? 1 : 0;
+}
+
+sub user {
+    my $self = shift;
+    return $self->{'user'} if exists $self->{'user'};
+    return {} if $self->{'error'};
+
+    my $user = Bugzilla->user;
+    my $prod_id = $self->{'product_id'};
+
+    my $editbugs = $user->in_group('editbugs', $prod_id);
+    my $is_reporter = $user->id == $self->{reporter_id} ? 1 : 0;
+    my $is_assignee = $user->id == $self->{'assigned_to'} ? 1 : 0;
+    my $is_qa_contact = Bugzilla->params->{'useqacontact'}
+                        && $self->{'qa_contact'}
+                        && $user->id == $self->{'qa_contact'} ? 1 : 0;
+
+    my $canedit = $editbugs || $is_assignee || $is_qa_contact;
+    my $canconfirm = $editbugs || $user->in_group('canconfirm', $prod_id);
+    my $has_any_role = $is_reporter || $is_assignee || $is_qa_contact;
+
+    $self->{'user'} = {canconfirm => $canconfirm,
+                       canedit    => $canedit,
+                       isreporter => $is_reporter,
+                       has_any_role => $has_any_role};
+    return $self->{'user'};
+}
+
+# This is intended to get values that can be selected by the user in the
+# UI. It should not be used for security or validation purposes.
+sub choices {
+    my $self = shift;
+    return $self->{'choices'} if exists $self->{'choices'};
+    return {} if $self->{'error'};
+    my $user = Bugzilla->user;
+
+    my @products = @{ $user->get_enterable_products };
+    # The current product is part of the popup, even if new bugs are no longer
+    # allowed for that product
+    if (!grep($_->name eq $self->product_obj->name, @products)) {
+        unshift(@products, $self->product_obj);
+    }
+    my %class_ids = map { $_->classification_id => 1 } @products;
+    my $classifications = 
+        Bugzilla::Classification->new_from_list([keys %class_ids]);
+
+    my %choices = (
+        bug_status => $self->statuses_available,
+        classification => $classifications,
+        product    => \@products,
+        component  => $self->product_obj->components,
+        version    => $self->product_obj->versions,
+        target_milestone => $self->product_obj->milestones,
+    );
+
+    my $resolution_field = new Bugzilla::Field({ name => 'resolution' });
+    # Don't include the empty resolution in drop-downs.
+    my @resolutions = grep($_->name, @{ $resolution_field->legal_values });
+    $choices{'resolution'} = \@resolutions;
+
+    $self->{'choices'} = \%choices;
+    return $self->{'choices'};
+}
+
+# Convenience Function. If you need speed, use this. If you need
+# other Bug fields in addition to this, just create a new Bug with
+# the alias.
+# Queries the database for the bug with a given alias, and returns
+# the ID of the bug if it exists or the undefined value if it doesn't.
+sub bug_alias_to_id {
+    my ($alias) = @_;
+    my $dbh = Bugzilla->dbh;
+    trick_taint($alias);
+    return $dbh->selectrow_array(
+        "SELECT bug_id FROM bugs WHERE alias = ?", undef, $alias);
+}
+
+#####################################################################
+# Subroutines
+#####################################################################
+
+# Returns a list of currently active and editable bug fields,
+# including multi-select fields.
+sub editable_bug_fields {
+    my @fields = Bugzilla->dbh->bz_table_columns('bugs');
+    # Add multi-select fields
+    push(@fields, map { $_->name } @{Bugzilla->fields({obsolete => 0,
+                                                       type => FIELD_TYPE_MULTI_SELECT})});
+    # Obsolete custom fields are not editable.
+    my @obsolete_fields = @{ Bugzilla->fields({obsolete => 1, custom => 1}) };
+    @obsolete_fields = map { $_->name } @obsolete_fields;
+    foreach my $remove ("bug_id", "reporter", "creation_ts", "delta_ts", 
+                        "lastdiffed", @obsolete_fields) 
+    {
+        my $location = firstidx { $_ eq $remove } @fields;
+        # Ensure field exists before attempting to remove it.
+        splice(@fields, $location, 1) if ($location > -1);
+    }
+    # Sorted because the old @::log_columns variable, which this replaces,
+    # was sorted.
+    return sort(@fields);
+}
+
+# XXX - When Bug::update() will be implemented, we should make this routine
+#       a private method.
+# Join with bug_status and bugs tables to show bugs with open statuses first,
+# and then the others
+sub EmitDependList {
+    my ($myfield, $targetfield, $bug_id) = (@_);
+    my $dbh = Bugzilla->dbh;
+    my $list_ref = $dbh->selectcol_arrayref(
+          "SELECT $targetfield
+             FROM dependencies
+                  INNER JOIN bugs ON dependencies.$targetfield = bugs.bug_id
+                  INNER JOIN bug_status ON bugs.bug_status = bug_status.value
+            WHERE $myfield = ?
+            ORDER BY is_open DESC, $targetfield",
+            undef, $bug_id);
+    return $list_ref;
+}
+
+# Creates a lot of bug objects in the same order as the input array.
+sub _bugs_in_order {
+    my ($self, $bug_ids) = @_;
+    my $bugs = $self->new_from_list($bug_ids);
+    my %bug_map = map { $_->id => $_ } @$bugs;
+    my @result = map { $bug_map{$_} } @$bug_ids;
+    return \@result;
+}
+
+# Get the activity of a bug, starting from $starttime (if given).
+# This routine assumes Bugzilla::Bug->check has been previously called.
+sub get_activity {
+    my ($self, $attach_id, $starttime) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $user = Bugzilla->user;
+
+    # Arguments passed to the SQL query.
+    my @args = ($self->id);
+
+    # Only consider changes since $starttime, if given.
+    my $datepart = "";
+    if (defined $starttime) {
+        trick_taint($starttime);
+        push (@args, $starttime);
+        $datepart = "AND bugs_activity.bug_when > ?";
+    }
+
+    my $attachpart = "";
+    if ($attach_id) {
+        push(@args, $attach_id);
+        $attachpart = "AND bugs_activity.attach_id = ?";
+    }
+
+    # Only includes attachments the user is allowed to see.
+    my $suppjoins = "";
+    my $suppwhere = "";
+    if (!$user->is_insider) {
+        $suppjoins = "LEFT JOIN attachments 
+                   ON attachments.attach_id = bugs_activity.attach_id";
+        $suppwhere = "AND COALESCE(attachments.isprivate, 0) = 0";
+    }
+
+    my $query = "SELECT fielddefs.name, bugs_activity.attach_id, " .
+        $dbh->sql_date_format('bugs_activity.bug_when', '%Y.%m.%d %H:%i:%s') .
+            ", bugs_activity.removed, bugs_activity.added, profiles.login_name, 
+               bugs_activity.comment_id
+          FROM bugs_activity
+               $suppjoins
+    INNER JOIN fielddefs
+            ON bugs_activity.fieldid = fielddefs.id
+    INNER JOIN profiles
+            ON profiles.userid = bugs_activity.who
+         WHERE bugs_activity.bug_id = ?
+               $datepart
+               $attachpart
+               $suppwhere
+      ORDER BY bugs_activity.bug_when, bugs_activity.id";
+
+    my $list = $dbh->selectall_arrayref($query, undef, @args);
+
+    my @operations;
+    my $operation = {};
+    my $changes = [];
+    my $incomplete_data = 0;
+
+    foreach my $entry (@$list) {
+        my ($fieldname, $attachid, $when, $removed, $added, $who, $comment_id) = @$entry;
+        my %change;
+        my $activity_visible = 1;
+
+        # check if the user should see this field's activity
+        if (grep { $fieldname eq $_ } TIMETRACKING_FIELDS) {
+            $activity_visible = $user->is_timetracker;
+        }
+        elsif ($fieldname eq 'longdescs.isprivate'
+               && !$user->is_insider && $added)
+        { 
+            $activity_visible = 0;
+        } 
+        else {
+            $activity_visible = 1;
+        }
+
+        if ($activity_visible) {
+            # Check for the results of an old Bugzilla data corruption bug
+            if (($added eq '?' && $removed eq '?')
+                || ($added =~ /^\? / || $removed =~ /^\? /)) {
+                $incomplete_data = 1;
+            }
+
+            # An operation, done by 'who' at time 'when', has a number of
+            # 'changes' associated with it.
+            # If this is the start of a new operation, store the data from the
+            # previous one, and set up the new one.
+            if ($operation->{'who'}
+                && ($who ne $operation->{'who'}
+                    || $when ne $operation->{'when'}))
+            {
+                $operation->{'changes'} = $changes;
+                push (@operations, $operation);
+
+                # Create new empty anonymous data structures.
+                $operation = {};
+                $changes = [];
+            }
+
+            # If this is the same field as the previous item, then concatenate
+            # the data into the same change.
+            if ($operation->{'who'} && $who eq $operation->{'who'}
+                && $when eq $operation->{'when'}
+                && $fieldname eq $operation->{'fieldname'}
+                && ($attachid || 0) == ($operation->{'attachid'} || 0))
+            {
+                my $old_change = pop @$changes;
+                $removed = _join_activity_entries($fieldname, $old_change->{'removed'}, $removed);
+                $added = _join_activity_entries($fieldname, $old_change->{'added'}, $added);
+            }
+            $operation->{'who'} = $who;
+            $operation->{'when'} = $when;
+            $operation->{'fieldname'} = $change{'fieldname'} = $fieldname;
+            $operation->{'attachid'} = $change{'attachid'} = $attachid;
+            $change{'removed'} = $removed;
+            $change{'added'} = $added;
+
+            if ($comment_id) {
+                $change{'comment'} = Bugzilla::Comment->new($comment_id);
+            }
+
+            push (@$changes, \%change);
+        }
+    }
+
+    if ($operation->{'who'}) {
+        $operation->{'changes'} = $changes;
+        push (@operations, $operation);
+    }
+
+    return(\@operations, $incomplete_data);
+}
+
+sub _join_activity_entries {
+    my ($field, $current_change, $new_change) = @_;
+    # We need to insert characters as these were removed by old
+    # LogActivityEntry code.
+
+    return $new_change if $current_change eq '';
+
+    # Buglists and see_also need the comma restored
+    if ($field eq 'dependson' || $field eq 'blocked' || $field eq 'see_also') {
+        if (substr($new_change, 0, 1) eq ',' || substr($new_change, 0, 1) eq ' ') {
+            return $current_change . $new_change;
+        } else {
+            return $current_change . ', ' . $new_change;
+        }
+    }
+
+    # Assume bug_file_loc contain a single url, don't insert a delimiter
+    if ($field eq 'bug_file_loc') {
+        return $current_change . $new_change;
+    }
+
+    # All other fields get a space
+    if (substr($new_change, 0, 1) eq ' ') {
+        return $current_change . $new_change;
+    } else {
+        return $current_change . ' ' . $new_change;
+    }
+}
+
+# Update the bugs_activity table to reflect changes made in bugs.
+sub LogActivityEntry {
+    my ($i, $col, $removed, $added, $whoid, $timestamp, $comment_id) = @_;
+    my $dbh = Bugzilla->dbh;
+    # in the case of CCs, deps, and keywords, there's a possibility that someone
+    # might try to add or remove a lot of them at once, which might take more
+    # space than the activity table allows.  We'll solve this by splitting it
+    # into multiple entries if it's too long.
+    while ($removed || $added) {
+        my ($removestr, $addstr) = ($removed, $added);
+        if (length($removestr) > MAX_LINE_LENGTH) {
+            my $commaposition = find_wrap_point($removed, MAX_LINE_LENGTH);
+            $removestr = substr($removed, 0, $commaposition);
+            $removed = substr($removed, $commaposition);
+        } else {
+            $removed = ""; # no more entries
+        }
+        if (length($addstr) > MAX_LINE_LENGTH) {
+            my $commaposition = find_wrap_point($added, MAX_LINE_LENGTH);
+            $addstr = substr($added, 0, $commaposition);
+            $added = substr($added, $commaposition);
+        } else {
+            $added = ""; # no more entries
+        }
+        trick_taint($addstr);
+        trick_taint($removestr);
+        my $fieldid = get_field_id($col);
+        $dbh->do("INSERT INTO bugs_activity
+                  (bug_id, who, bug_when, fieldid, removed, added, comment_id)
+                  VALUES (?, ?, ?, ?, ?, ?, ?)",
+                  undef, ($i, $whoid, $timestamp, $fieldid, $removestr, $addstr, $comment_id));
+    }
+}
+
+# Convert WebService API and email_in.pl field names to internal DB field
+# names.
+sub map_fields {
+    my ($params, $except) = @_; 
+
+    my %field_values;
+    foreach my $field (keys %$params) {
+        # Don't allow setting private fields via email_in or the WebService.
+        next if $field =~ /^_/;
+        my $field_name;
+        if ($except->{$field}) {
+           $field_name = $field;
+        }
+        else {
+            $field_name = FIELD_MAP->{$field} || $field;
+        }
+        $field_values{$field_name} = $params->{$field};
+    }
+    return \%field_values;
+}
+
+################################################################################
+# check_can_change_field() defines what users are allowed to change. You
+# can add code here for site-specific policy changes, according to the
+# instructions given in the Bugzilla Guide and below. Note that you may also
+# have to update the Bugzilla::Bug::user() function to give people access to the
+# options that they are permitted to change.
+#
+# check_can_change_field() returns true if the user is allowed to change this
+# field, and false if they are not.
+#
+# The parameters to this method are as follows:
+# $field    - name of the field in the bugs table the user is trying to change
+# $oldvalue - what they are changing it from
+# $newvalue - what they are changing it to
+# $PrivilegesRequired - return the reason of the failure, if any
+################################################################################
+sub check_can_change_field {
+    my $self = shift;
+    my ($field, $oldvalue, $newvalue, $PrivilegesRequired) = (@_);
+    my $user = Bugzilla->user;
+
+    $oldvalue = defined($oldvalue) ? $oldvalue : '';
+    $newvalue = defined($newvalue) ? $newvalue : '';
+
+    # Return true if they haven't changed this field at all.
+    if ($oldvalue eq $newvalue) {
+        return 1;
+    } elsif (ref($newvalue) eq 'ARRAY' && ref($oldvalue) eq 'ARRAY') {
+        my ($removed, $added) = diff_arrays($oldvalue, $newvalue);
+        return 1 if !scalar(@$removed) && !scalar(@$added);
+    } elsif (trim($oldvalue) eq trim($newvalue)) {
+        return 1;
+    # numeric fields need to be compared using ==
+    } elsif (($field eq 'estimated_time' || $field eq 'remaining_time' 
+              || $field eq 'work_time')
+             && $oldvalue == $newvalue)
+    {
+        return 1;
+    }
+
+    my @priv_results;
+    Bugzilla::Hook::process('bug_check_can_change_field',
+        { bug => $self, field => $field, 
+          new_value => $newvalue, old_value => $oldvalue, 
+          priv_results => \@priv_results });
+    if (my $priv_required = first { $_ > 0 } @priv_results) {
+        $$PrivilegesRequired = $priv_required;
+        return 0;
+    }
+    my $allow_found = first { $_ == 0 } @priv_results;
+    if (defined $allow_found) {
+        return 1;
+    }
+
+    # Allow anyone to change comments, or set flags
+    if ($field =~ /^longdesc/ || $field eq 'flagtypes.name') {
+        return 1;
+    }
+
+    # If the user isn't allowed to change a field, we must tell him who can.
+    # We store the required permission set into the $PrivilegesRequired
+    # variable which gets passed to the error template.
+    #
+    # $PrivilegesRequired = PRIVILEGES_REQUIRED_NONE : no privileges required;
+    # $PrivilegesRequired = PRIVILEGES_REQUIRED_REPORTER : the reporter, assignee or an empowered user;
+    # $PrivilegesRequired = PRIVILEGES_REQUIRED_ASSIGNEE : the assignee or an empowered user;
+    # $PrivilegesRequired = PRIVILEGES_REQUIRED_EMPOWERED : an empowered user.
+    
+    # Only users in the time-tracking group can change time-tracking fields.
+    if ( grep($_ eq $field, TIMETRACKING_FIELDS) ) {
+        if (!$user->is_timetracker) {
+            $$PrivilegesRequired = PRIVILEGES_REQUIRED_EMPOWERED;
+            return 0;
+        }
+    }
+
+    # Allow anyone with (product-specific) "editbugs" privs to change anything.
+    if ($user->in_group('editbugs', $self->{'product_id'})) {
+        return 1;
+    }
+
+    # *Only* users with (product-specific) "canconfirm" privs can confirm bugs.
+    if ($self->_changes_everconfirmed($field, $oldvalue, $newvalue)) {
+        $$PrivilegesRequired = PRIVILEGES_REQUIRED_EMPOWERED;
+        return $user->in_group('canconfirm', $self->{'product_id'});
+    }
+
+    # Make sure that a valid bug ID has been given.
+    if (!$self->{'error'}) {
+        # Allow the assignee to change anything else.
+        if ($self->{'assigned_to'} == $user->id
+            || $self->{'_old_assigned_to'} && $self->{'_old_assigned_to'} == $user->id)
+        {
+            return 1;
+        }
+
+        # Allow the QA contact to change anything else.
+        if (Bugzilla->params->{'useqacontact'}
+            && (($self->{'qa_contact'} && $self->{'qa_contact'} == $user->id)
+                || ($self->{'_old_qa_contact'} && $self->{'_old_qa_contact'} == $user->id)))
+        {
+            return 1;
+        }
+    }
+
+    # At this point, the user is either the reporter or an
+    # unprivileged user. We first check for fields the reporter
+    # is not allowed to change.
+
+    # The reporter may not:
+    # - reassign bugs, unless the bugs are assigned to him;
+    #   in that case we will have already returned 1 above
+    #   when checking for the assignee of the bug.
+    if ($field eq 'assigned_to') {
+        $$PrivilegesRequired = PRIVILEGES_REQUIRED_ASSIGNEE;
+        return 0;
+    }
+    # - change the QA contact
+    if ($field eq 'qa_contact') {
+        $$PrivilegesRequired = PRIVILEGES_REQUIRED_ASSIGNEE;
+        return 0;
+    }
+    # - change the target milestone
+    if ($field eq 'target_milestone') {
+        $$PrivilegesRequired = PRIVILEGES_REQUIRED_ASSIGNEE;
+        return 0;
+    }
+    # - change the priority (unless he could have set it originally)
+    if ($field eq 'priority'
+        && !Bugzilla->params->{'letsubmitterchoosepriority'})
+    {
+        $$PrivilegesRequired = PRIVILEGES_REQUIRED_ASSIGNEE;
+        return 0;
+    }
+    # - unconfirm bugs (confirming them is handled above)
+    if ($field eq 'everconfirmed') {
+        $$PrivilegesRequired = PRIVILEGES_REQUIRED_ASSIGNEE;
+        return 0;
+    }
+    # - change the status from one open state to another
+    if ($field eq 'bug_status'
+        && is_open_state($oldvalue) && is_open_state($newvalue)) 
+    {
+       $$PrivilegesRequired = PRIVILEGES_REQUIRED_ASSIGNEE;
+       return 0;
+    }
+
+    # The reporter is allowed to change anything else.
+    if (!$self->{'error'} && $self->{'reporter_id'} == $user->id) {
+        return 1;
+    }
+
+    # If we haven't returned by this point, then the user doesn't
+    # have the necessary permissions to change this field.
+    $$PrivilegesRequired = PRIVILEGES_REQUIRED_REPORTER;
+    return 0;
+}
+
+# A helper for check_can_change_field
+sub _changes_everconfirmed {
+    my ($self, $field, $old, $new) = @_;
+    return 1 if $field eq 'everconfirmed';
+    if ($field eq 'bug_status') {
+        if ($self->everconfirmed) {
+            # Moving a confirmed bug to UNCONFIRMED will change everconfirmed.
+            return 1 if $new eq 'UNCONFIRMED';
+        }
+        else {
+            # Moving an unconfirmed bug to an open state that isn't 
+            # UNCONFIRMED will confirm the bug.
+            return 1 if (is_open_state($new) and $new ne 'UNCONFIRMED');
+        }
+    }
+    return 0;
+}
+
+#
+# Field Validation
+#
+
+# Validate and return a hash of dependencies
+sub ValidateDependencies {
+    my $fields = {};
+    # These can be arrayrefs or they can be strings.
+    $fields->{'dependson'} = shift;
+    $fields->{'blocked'} = shift;
+    my $id = shift || 0;
+
+    unless (defined($fields->{'dependson'})
+            || defined($fields->{'blocked'}))
+    {
+        return;
+    }
+
+    my $dbh = Bugzilla->dbh;
+    my %deps;
+    my %deptree;
+    foreach my $pair (["blocked", "dependson"], ["dependson", "blocked"]) {
+        my ($me, $target) = @{$pair};
+        $deptree{$target} = [];
+        $deps{$target} = [];
+        next unless $fields->{$target};
+
+        my %seen;
+        my $target_array = ref($fields->{$target}) ? $fields->{$target}
+                           : [split(/[\s,]+/, $fields->{$target})];
+        foreach my $i (@$target_array) {
+            if ($id == $i) {
+                ThrowUserError("dependency_loop_single");
+            }
+            if (!exists $seen{$i}) {
+                push(@{$deptree{$target}}, $i);
+                $seen{$i} = 1;
+            }
+        }
+        # populate $deps{$target} as first-level deps only.
+        # and find remainder of dependency tree in $deptree{$target}
+        @{$deps{$target}} = @{$deptree{$target}};
+        my @stack = @{$deps{$target}};
+        while (@stack) {
+            my $i = shift @stack;
+            my $dep_list =
+                $dbh->selectcol_arrayref("SELECT $target
+                                          FROM dependencies
+                                          WHERE $me = ?", undef, $i);
+            foreach my $t (@$dep_list) {
+                # ignore any _current_ dependencies involving this bug,
+                # as they will be overwritten with data from the form.
+                if ($t != $id && !exists $seen{$t}) {
+                    push(@{$deptree{$target}}, $t);
+                    push @stack, $t;
+                    $seen{$t} = 1;
+                }
+            }
+        }
+    }
+
+    my @deps   = @{$deptree{'dependson'}};
+    my @blocks = @{$deptree{'blocked'}};
+    my %union = ();
+    my %isect = ();
+    foreach my $b (@deps, @blocks) { $union{$b}++ && $isect{$b}++ }
+    my @isect = keys %isect;
+    if (scalar(@isect) > 0) {
+        ThrowUserError("dependency_loop_multi", {'deps' => \@isect});
+    }
+    return %deps;
+}
+
+
+#####################################################################
+# Custom Field Accessors
+#####################################################################
+
+sub _create_cf_accessors {
+    my ($invocant) = @_;
+    my $class = ref($invocant) || $invocant;
+    return if Bugzilla->request_cache->{"${class}_cf_accessors_created"};
+
+    my $fields = Bugzilla->fields({ custom => 1 });
+    foreach my $field (@$fields) {
+        my $accessor = $class->_accessor_for($field);
+        my $name = "${class}::" . $field->name;
+        {
+            no strict 'refs';
+            next if defined *{$name};
+            *{$name} = $accessor;
+        }
+    }
+
+    Bugzilla->request_cache->{"${class}_cf_accessors_created"} = 1;
+}
+
+sub _accessor_for {
+    my ($class, $field) = @_;
+    if ($field->type == FIELD_TYPE_MULTI_SELECT) {
+        return $class->_multi_select_accessor($field->name);
+    }
+    return $class->_cf_accessor($field->name);
+}
+
+sub _cf_accessor {
+    my ($class, $field) = @_;
+    my $accessor = sub {
+        my ($self) = @_;
+        return $self->{$field};
+    };
+    return $accessor;
+}
+
+sub _multi_select_accessor {
+    my ($class, $field) = @_;
+    my $accessor = sub {
+        my ($self) = @_;
+        $self->{$field} ||= Bugzilla->dbh->selectcol_arrayref(
+            "SELECT value FROM bug_$field WHERE bug_id = ? ORDER BY value",
+            undef, $self->id);
+        return $self->{$field};
+    };
+    return $accessor;
+}
+
+1;

diff --git a/Bugzilla/BugMail.pm b/Bugzilla/BugMail.pm
new file mode 100644 (file)
index 0000000..0fabce6
--- /dev/null
+++ b/Bugzilla/BugMail.pm
@@ -0,0 +1,484 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+package Bugzilla::BugMail;
+
+use Bugzilla::Error;
+use Bugzilla::User;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Bug;
+use Bugzilla::Comment;
+use Bugzilla::Mailer;
+use Bugzilla::Hook;
+
+use Date::Parse;
+use Date::Format;
+use Scalar::Util qw(blessed);
+use List::MoreUtils qw(uniq);
+
+use constant BIT_DIRECT    => 1;
+use constant BIT_WATCHING  => 2;
+
+sub relationships {
+    my $ref = RELATIONSHIPS;
+    # Clone it so that we don't modify the constant;
+    my %relationships = %$ref;
+    Bugzilla::Hook::process('bugmail_relationships', 
+                            { relationships => \%relationships });
+    return %relationships;
+}
+
+# This is a bit of a hack, basically keeping the old system()
+# cmd line interface. Should clean this up at some point.
+#
+# args: bug_id, and an optional hash ref which may have keys for:
+# changer, owner, qa, reporter, cc
+# Optional hash contains values of people which will be forced to those
+# roles when the email is sent.
+# All the names are email addresses, not userids
+# values are scalars, except for cc, which is a list
+sub Send {
+    my ($id, $forced, $params) = @_;
+    $params ||= {};
+
+    my $dbh = Bugzilla->dbh;
+    my $bug = new Bugzilla::Bug($id);
+
+    my $start = $bug->lastdiffed;
+    my $end   = $dbh->selectrow_array('SELECT LOCALTIMESTAMP(0)');
+
+    # Bugzilla::User objects of people in various roles. More than one person
+    # can 'have' a role, if the person in that role has changed, or people are
+    # watching.
+    my @assignees = ($bug->assigned_to);
+    my @qa_contacts = $bug->qa_contact || ();
+
+    my @ccs = @{ $bug->cc_users };
+    # Include the people passed in as being in particular roles.
+    # This can include people who used to hold those roles.
+    # At this point, we don't care if there are duplicates in these arrays.
+    my $changer = $forced->{'changer'};
+    if ($forced->{'owner'}) {
+        push (@assignees, Bugzilla::User->check($forced->{'owner'}));
+    }
+    
+    if ($forced->{'qacontact'}) {
+        push (@qa_contacts, Bugzilla::User->check($forced->{'qacontact'}));
+    }
+    
+    if ($forced->{'cc'}) {
+        foreach my $cc (@{$forced->{'cc'}}) {
+            push(@ccs, Bugzilla::User->check($cc));
+        }
+    }
+    my %user_cache = map { $_->id => $_ } (@assignees, @qa_contacts, @ccs);
+
+    my @diffs;
+    if (!$start) {
+        @diffs = _get_new_bugmail_fields($bug);
+    }
+
+    if ($params->{dep_only}) {
+        push(@diffs, { field_name => 'bug_status',
+                       old => $params->{changes}->{bug_status}->[0],
+                       new => $params->{changes}->{bug_status}->[1],
+                       login_name => $changer->login,
+                       blocker => $params->{blocker} },
+                     { field_name => 'resolution',
+                       old => $params->{changes}->{resolution}->[0],
+                       new => $params->{changes}->{resolution}->[1],
+                       login_name => $changer->login,
+                       blocker => $params->{blocker} });
+    }
+    else {
+        push(@diffs, _get_diffs($bug, $end, \%user_cache));
+    }
+
+    my $comments = $bug->comments({ after => $start, to => $end });
+    # Skip empty comments.
+    @$comments = grep { $_->type || $_->body =~ /\S/ } @$comments;
+
+    ###########################################################################
+    # Start of email filtering code
+    ###########################################################################
+    
+    # A user_id => roles hash to keep track of people.
+    my %recipients;
+    my %watching;
+    
+    # Now we work out all the people involved with this bug, and note all of
+    # the relationships in a hash. The keys are userids, the values are an
+    # array of role constants.
+    
+    # CCs
+    $recipients{$_->id}->{+REL_CC} = BIT_DIRECT foreach (@ccs);
+    
+    # Reporter (there's only ever one)
+    $recipients{$bug->reporter->id}->{+REL_REPORTER} = BIT_DIRECT;
+    
+    # QA Contact
+    if (Bugzilla->params->{'useqacontact'}) {
+        foreach (@qa_contacts) {
+            # QA Contact can be blank; ignore it if so.
+            $recipients{$_->id}->{+REL_QA} = BIT_DIRECT if $_;
+        }
+    }
+
+    # Assignee
+    $recipients{$_->id}->{+REL_ASSIGNEE} = BIT_DIRECT foreach (@assignees);
+
+    # The last relevant set of people are those who are being removed from 
+    # their roles in this change. We get their names out of the diffs.
+    foreach my $change (@diffs) {
+        if ($change->{old}) {
+            # You can't stop being the reporter, so we don't check that
+            # relationship here.
+            # Ignore people whose user account has been deleted or renamed.
+            if ($change->{field_name} eq 'cc') {
+                foreach my $cc_user (split(/[\s,]+/, $change->{old})) {
+                    my $uid = login_to_id($cc_user);
+                    $recipients{$uid}->{+REL_CC} = BIT_DIRECT if $uid;
+                }
+            }
+            elsif ($change->{field_name} eq 'qa_contact') {
+                my $uid = login_to_id($change->{old});
+                $recipients{$uid}->{+REL_QA} = BIT_DIRECT if $uid;
+            }
+            elsif ($change->{field_name} eq 'assigned_to') {
+                my $uid = login_to_id($change->{old});
+                $recipients{$uid}->{+REL_ASSIGNEE} = BIT_DIRECT if $uid;
+            }
+        }
+    }
+
+    # Make sure %user_cache has every user in it so far referenced
+    foreach my $user_id (keys %recipients) {
+        $user_cache{$user_id} ||= new Bugzilla::User($user_id);
+    }
+    
+    Bugzilla::Hook::process('bugmail_recipients',
+                            { bug => $bug, recipients => \%recipients,
+                              users => \%user_cache, diffs => \@diffs });
+
+    # Find all those user-watching anyone on the current list, who is not
+    # on it already themselves.
+    my $involved = join(",", keys %recipients);
+
+    my $userwatchers =
+        $dbh->selectall_arrayref("SELECT watcher, watched FROM watch
+                                  WHERE watched IN ($involved)");
+
+    # Mark these people as having the role of the person they are watching
+    foreach my $watch (@$userwatchers) {
+        while (my ($role, $bits) = each %{$recipients{$watch->[1]}}) {
+            $recipients{$watch->[0]}->{$role} |= BIT_WATCHING
+                if $bits & BIT_DIRECT;
+        }
+        push(@{$watching{$watch->[0]}}, $watch->[1]);
+    }
+
+    # Global watcher
+    my @watchers = split(/[,\s]+/, Bugzilla->params->{'globalwatchers'});
+    foreach (@watchers) {
+        my $watcher_id = login_to_id($_);
+        next unless $watcher_id;
+        $recipients{$watcher_id}->{+REL_GLOBAL_WATCHER} = BIT_DIRECT;
+    }
+
+    # We now have a complete set of all the users, and their relationships to
+    # the bug in question. However, we are not necessarily going to mail them
+    # all - there are preferences, permissions checks and all sorts to do yet.
+    my @sent;
+    my @excluded;
+
+    # The email client will display the Date: header in the desired timezone,
+    # so we can always use UTC here.
+    my $date = $params->{dep_only} ? $end : $bug->delta_ts;
+    $date = format_time($date, '%a, %d %b %Y %T %z', 'UTC');
+
+    foreach my $user_id (keys %recipients) {
+        my %rels_which_want;
+        my $sent_mail = 0;
+        $user_cache{$user_id} ||= new Bugzilla::User($user_id);
+        my $user = $user_cache{$user_id};
+        # Deleted users must be excluded.
+        next unless $user;
+
+        if ($user->can_see_bug($id)) {
+            # Go through each role the user has and see if they want mail in
+            # that role.
+            foreach my $relationship (keys %{$recipients{$user_id}}) {
+                if ($user->wants_bug_mail($bug,
+                                          $relationship, 
+                                          $start ? \@diffs : [],
+                                          $comments,
+                                          $params->{dep_only},
+                                          $changer))
+                {
+                    $rels_which_want{$relationship} = 
+                        $recipients{$user_id}->{$relationship};
+                }
+            }
+        }
+        
+        if (scalar(%rels_which_want)) {
+            # So the user exists, can see the bug, and wants mail in at least
+            # one role. But do we want to send it to them?
+
+            # We shouldn't send mail if this is a dependency mail and the
+            # depending bug is not visible to the user.
+            # This is to avoid leaking the summary of a confidential bug.
+            my $dep_ok = 1;
+            if ($params->{dep_only}) {
+                $dep_ok = $user->can_see_bug($params->{blocker}->id) ? 1 : 0;
+            }
+
+            # Make sure the user isn't in the nomail list, and the dep check passed.
+            if ($user->email_enabled && $dep_ok) {
+                # OK, OK, if we must. Email the user.
+                $sent_mail = sendMail(
+                    { to       => $user, 
+                      bug      => $bug,
+                      comments => $comments,
+                      date     => $date,
+                      changer  => $changer,
+                      watchers => exists $watching{$user_id} ?
+                                  $watching{$user_id} : undef,
+                      diffs    => \@diffs,
+                      rels_which_want => \%rels_which_want,
+                    });
+            }
+        }
+
+        if ($sent_mail) {
+            push(@sent, $user->login); 
+        } 
+        else {
+            push(@excluded, $user->login); 
+        } 
+    }
+
+    # When sending bugmail about a blocker being reopened or resolved,
+    # we say nothing about changes in the bug being blocked, so we must
+    # not update lastdiffed in this case.
+    if (!$params->{dep_only}) {
+        $dbh->do('UPDATE bugs SET lastdiffed = ? WHERE bug_id = ?',
+                 undef, ($end, $id));
+        $bug->{lastdiffed} = $end;
+    }
+
+    return {'sent' => \@sent, 'excluded' => \@excluded};
+}
+
+sub sendMail {
+    my $params = shift;
+    
+    my $user   = $params->{to};
+    my $bug    = $params->{bug};
+    my @send_comments = @{ $params->{comments} };
+    my $date = $params->{date};
+    my $changer = $params->{changer};
+    my $watchingRef = $params->{watchers};
+    my @diffs = @{ $params->{diffs} };
+    my $relRef      = $params->{rels_which_want};
+
+    # Only display changes the user is allowed see.
+    my @display_diffs;
+
+    foreach my $diff (@diffs) {
+        my $add_diff = 0;
+        
+        if (grep { $_ eq $diff->{field_name} } TIMETRACKING_FIELDS) {
+            $add_diff = 1 if $user->is_timetracker;
+        }
+        elsif (!$diff->{isprivate} || $user->is_insider) {
+            $add_diff = 1;
+        }
+        push(@display_diffs, $diff) if $add_diff;
+    }
+
+    if (!$user->is_insider) {
+        @send_comments = grep { !$_->is_private } @send_comments;
+    }
+
+    if (!scalar(@display_diffs) && !scalar(@send_comments)) {
+      # Whoops, no differences!
+      return 0;
+    }
+
+    my (@reasons, @reasons_watch);
+    while (my ($relationship, $bits) = each %{$relRef}) {
+        push(@reasons, $relationship) if ($bits & BIT_DIRECT);
+        push(@reasons_watch, $relationship) if ($bits & BIT_WATCHING);
+    }
+
+    my %relationships = relationships();
+    my @headerrel   = map { $relationships{$_} } @reasons;
+    my @watchingrel = map { $relationships{$_} } @reasons_watch;
+    push(@headerrel,   'None') unless @headerrel;
+    push(@watchingrel, 'None') unless @watchingrel;
+    push @watchingrel, map { user_id_to_login($_) } @$watchingRef;
+
+    my @changedfields = uniq map { $_->{field_name} } @display_diffs;
+    
+    # Add attachments.created to changedfields if one or more
+    # comments contain information about a new attachment
+    if (grep($_->type == CMT_ATTACHMENT_CREATED, @send_comments)) {
+        push(@changedfields, 'attachments.created');
+    }
+
+    my $vars = {
+        date => $date,
+        to_user => $user,
+        bug => $bug,
+        reasons => \@reasons,
+        reasons_watch => \@reasons_watch,
+        reasonsheader => join(" ", @headerrel),
+        reasonswatchheader => join(" ", @watchingrel),
+        changer => $changer,
+        diffs => \@display_diffs,
+        changedfields => \@changedfields, 
+        new_comments => \@send_comments,
+        threadingmarker => build_thread_marker($bug->id, $user->id, !$bug->lastdiffed),
+    };
+    my $msg =  _generate_bugmail($user, $vars);
+    MessageToMTA($msg);
+
+    return 1;
+}
+
+sub _generate_bugmail {
+    my ($user, $vars) = @_;
+    my $template = Bugzilla->template_inner($user->setting('lang'));
+    my ($msg_text, $msg_html, $msg_header);
+  
+    $template->process("email/bugmail-header.txt.tmpl", $vars, \$msg_header)
+        || ThrowTemplateError($template->error());
+    $template->process("email/bugmail.txt.tmpl", $vars, \$msg_text)
+        || ThrowTemplateError($template->error());
+
+    my @parts = (
+        Email::MIME->create(
+            attributes => {
+                content_type => "text/plain",
+            },
+            body => $msg_text,
+        )
+    );
+    if ($user->setting('email_format') eq 'html') {
+        $template->process("email/bugmail.html.tmpl", $vars, \$msg_html)
+            || ThrowTemplateError($template->error());
+        push @parts, Email::MIME->create(
+            attributes => {
+                content_type => "text/html",         
+            },
+            body => $msg_html,
+        );
+    }
+
+    # TT trims the trailing newline, and threadingmarker may be ignored.
+    my $email = new Email::MIME("$msg_header\n");
+    if (scalar(@parts) == 1) {
+        $email->content_type_set($parts[0]->content_type);
+    } else {
+        $email->content_type_set('multipart/alternative');
+        # Some mail clients need same encoding for each part, even empty ones.
+        $email->charset_set('UTF-8') if Bugzilla->params->{'utf8'};
+    }
+    $email->parts_set(\@parts);
+    return $email;
+}
+
+sub _get_diffs {
+    my ($bug, $end, $user_cache) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    my @args = ($bug->id);
+    # If lastdiffed is NULL, then we don't limit the search on time.
+    my $when_restriction = '';
+    if ($bug->lastdiffed) {
+        $when_restriction = ' AND bug_when > ? AND bug_when <= ?';
+        push @args, ($bug->lastdiffed, $end);
+    }
+
+    my $diffs = $dbh->selectall_arrayref(
+           "SELECT fielddefs.name AS field_name,
+                   bugs_activity.bug_when, bugs_activity.removed AS old,
+                   bugs_activity.added AS new, bugs_activity.attach_id,
+                   bugs_activity.comment_id, bugs_activity.who
+              FROM bugs_activity
+        INNER JOIN fielddefs
+                ON fielddefs.id = bugs_activity.fieldid
+             WHERE bugs_activity.bug_id = ?
+                   $when_restriction
+          ORDER BY bugs_activity.bug_when", {Slice=>{}}, @args);
+
+    foreach my $diff (@$diffs) {
+        $user_cache->{$diff->{who}} ||= new Bugzilla::User($diff->{who}); 
+        $diff->{who} =  $user_cache->{$diff->{who}};
+        if ($diff->{attach_id}) {
+            $diff->{isprivate} = $dbh->selectrow_array(
+                'SELECT isprivate FROM attachments WHERE attach_id = ?',
+                undef, $diff->{attach_id});
+         }
+         if ($diff->{field_name} eq 'longdescs.isprivate') {
+             my $comment = Bugzilla::Comment->new($diff->{comment_id});
+             $diff->{num} = $comment->count;
+             $diff->{isprivate} = $diff->{new};
+         }
+    }
+
+    return @$diffs;
+}
+
+sub _get_new_bugmail_fields {
+    my $bug = shift;
+    my @fields = @{ Bugzilla->fields({obsolete => 0, in_new_bugmail => 1}) };
+    my @diffs;
+    my $params = Bugzilla->params;
+
+    foreach my $field (@fields) {
+        my $name = $field->name;
+        my $value = $bug->$name;
+
+        next if !$field->is_visible_on_bug($bug)
+            || ($name eq 'classification' && !$params->{'useclassification'})
+            || ($name eq 'status_whiteboard' && !$params->{'usestatuswhiteboard'})
+            || ($name eq 'qa_contact' && !$params->{'useqacontact'})
+            || ($name eq 'target_milestone' && !$params->{'usetargetmilestone'});
+
+        if (ref $value eq 'ARRAY') {
+            $value = join(', ', @$value);
+        }
+        elsif (blessed($value) && $value->isa('Bugzilla::User')) {
+            $value = $value->login;
+        }
+        elsif (blessed($value) && $value->isa('Bugzilla::Object')) {
+            $value = $value->name;
+        }
+        elsif ($name eq 'estimated_time') {
+            # "0.00" (which is what we get from the DB) is true,
+            # so we explicitly do a numerical comparison with 0.
+            $value = 0 if $value == 0;
+        }
+        elsif ($name eq 'deadline') {
+            $value = time2str("%Y-%m-%d", str2time($value)) if $value;
+        }
+
+        # If there isn't anything to show, don't include this header.
+        next unless $value;
+
+        push(@diffs, {field_name => $name, new => $value});
+    }
+
+    return @diffs;
+}
+
+1;

diff --git a/Bugzilla/BugUrl.pm b/Bugzilla/BugUrl.pm
new file mode 100644 (file)
index 0000000..8689e8a
--- /dev/null
+++ b/Bugzilla/BugUrl.pm
@@ -0,0 +1,200 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::BugUrl;
+use strict;
+use base qw(Bugzilla::Object);
+
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Constants;
+use Bugzilla::Hook;
+
+use URI::QueryParam;
+
+###############################
+####    Initialization     ####
+###############################
+
+use constant DB_TABLE   => 'bug_see_also';
+use constant NAME_FIELD => 'value';
+use constant LIST_ORDER => 'id';
+# See Also is tracked in bugs_activity.
+use constant AUDIT_CREATES => 0;
+use constant AUDIT_UPDATES => 0;
+use constant AUDIT_REMOVES => 0;
+
+use constant DB_COLUMNS => qw(
+    id
+    bug_id
+    value
+    class
+);
+
+# This must be strings with the names of the validations,
+# instead of coderefs, because subclasses override these
+# validators with their own.
+use constant VALIDATORS => {
+    value  => '_check_value',
+    bug_id => '_check_bug_id',
+    class  => \&_check_class,
+};
+
+# This is the order we go through all of subclasses and
+# pick the first one that should handle the url. New
+# subclasses should be added at the end of the list.
+use constant SUB_CLASSES => qw(
+    Bugzilla::BugUrl::Bugzilla::Local
+    Bugzilla::BugUrl::Bugzilla
+    Bugzilla::BugUrl::Launchpad
+    Bugzilla::BugUrl::Google
+    Bugzilla::BugUrl::Debian
+    Bugzilla::BugUrl::JIRA
+    Bugzilla::BugUrl::Trac
+    Bugzilla::BugUrl::MantisBT
+    Bugzilla::BugUrl::SourceForge
+    Bugzilla::BugUrl::GitHub
+);
+
+###############################
+####      Accessors      ######
+###############################
+
+sub class  { return $_[0]->{class}  }
+sub bug_id { return $_[0]->{bug_id} }
+
+###############################
+####        Methods        ####
+###############################
+
+sub new {
+    my $class = shift;
+    my $param = shift;
+
+    if (ref $param) {
+        my $bug_id = $param->{bug_id};
+        my $name   = $param->{name} || $param->{value};
+        if (!defined $bug_id) {
+            ThrowCodeError('bad_arg',
+                { argument => 'bug_id',
+                  function => "${class}::new" });
+        }
+        if (!defined $name) {
+            ThrowCodeError('bad_arg',
+                { argument => 'name',
+                  function => "${class}::new" });
+        }
+
+        my $condition = 'bug_id = ? AND value = ?';
+        my @values = ($bug_id, $name);
+        $param = { condition => $condition, values => \@values };
+    }
+
+    unshift @_, $param;
+    return $class->SUPER::new(@_);
+}
+
+sub _do_list_select {
+    my $class = shift;
+    my $objects = $class->SUPER::_do_list_select(@_);
+
+    foreach my $object (@$objects) {
+        eval "use " . $object->class; die $@ if $@;
+        bless $object, $object->class;
+    }
+
+    return $objects
+}
+
+# This is an abstract method. It must be overridden
+# in every subclass.
+sub should_handle {
+    my ($class, $input) = @_;
+    ThrowCodeError('unknown_method',
+        { method => "${class}::should_handle" });
+}
+
+sub class_for {
+    my ($class, $value) = @_;
+
+    my @sub_classes = $class->SUB_CLASSES;
+    Bugzilla::Hook::process("bug_url_sub_classes",
+        { sub_classes => \@sub_classes });
+
+    my $uri = URI->new($value);
+    foreach my $subclass (@sub_classes) {
+        eval "use $subclass";
+        die $@ if $@;
+        return wantarray ? ($subclass, $uri) : $subclass
+            if $subclass->should_handle($uri);
+    }
+
+    ThrowUserError('bug_url_invalid', { url => $value });
+}
+
+sub _check_class {
+    my ($class, $subclass) = @_;
+    eval "use $subclass"; die $@ if $@;
+    return $subclass;
+}
+
+sub _check_bug_id {
+    my ($class, $bug_id) = @_;
+
+    my $bug;
+    if (blessed $bug_id) {
+        # We got a bug object passed in, use it
+        $bug = $bug_id;
+        $bug->check_is_visible;
+    }
+    else {
+        # We got a bug id passed in, check it and get the bug object
+        $bug = Bugzilla::Bug->check({ id => $bug_id });
+    }
+
+    return $bug->id;
+}
+
+sub _check_value {
+    my ($class, $uri) = @_;
+
+    my $value = $uri->as_string;
+
+    if (!$value) {
+        ThrowCodeError('param_required',
+                       { function => 'add_see_also', param => '$value' });
+    }
+
+    # We assume that the URL is an HTTP URL if there is no (something):// 
+    # in front.
+    if (!$uri->scheme) {
+        # This works better than setting $uri->scheme('http'), because
+        # that creates URLs like "http:domain.com" and doesn't properly
+        # differentiate the path from the domain.
+        $uri = new URI("http://$value");
+    }
+    elsif ($uri->scheme ne 'http' && $uri->scheme ne 'https') {
+        ThrowUserError('bug_url_invalid', { url => $value, reason => 'http' });
+    }
+
+    # This stops the following edge cases from being accepted:
+    # * show_bug.cgi?id=1
+    # * /show_bug.cgi?id=1
+    # * http:///show_bug.cgi?id=1
+    if (!$uri->authority or $uri->path !~ m{/}) {
+        ThrowUserError('bug_url_invalid',
+                       { url => $value, reason => 'path_only' });
+    }
+
+    if (length($uri->path) > MAX_BUG_URL_LENGTH) {
+        ThrowUserError('bug_url_too_long', { url => $uri->path });
+    }
+
+    return $uri;
+}
+
+1;

diff --git a/Bugzilla/BugUrl/Bugzilla.pm b/Bugzilla/BugUrl/Bugzilla.pm
new file mode 100644 (file)
index 0000000..4db37eb
--- /dev/null
+++ b/Bugzilla/BugUrl/Bugzilla.pm
@@ -0,0 +1,53 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::BugUrl::Bugzilla;
+use strict;
+use base qw(Bugzilla::BugUrl);
+
+use Bugzilla::Error;
+use Bugzilla::Util;
+
+###############################
+####        Methods        ####
+###############################
+
+sub should_handle {
+    my ($class, $uri) = @_;
+    return ($uri->path =~ /show_bug\.cgi$/) ? 1 : 0;
+}
+
+sub _check_value {
+    my ($class, $uri) = @_;
+
+    $uri = $class->SUPER::_check_value($uri);
+
+    my $bug_id = $uri->query_param('id');
+    # We don't currently allow aliases, because we can't check to see
+    # if somebody's putting both an alias link and a numeric ID link.
+    # When we start validating the URL by accessing the other Bugzilla,
+    # we can allow aliases.
+    detaint_natural($bug_id);
+    if (!$bug_id) {
+        my $value = $uri->as_string;
+        ThrowUserError('bug_url_invalid', { url => $value, reason => 'id' });
+    }
+
+    # Make sure that "id" is the only query parameter.
+    $uri->query("id=$bug_id");
+    # And remove any # part if there is one.
+    $uri->fragment(undef);
+
+    return $uri;
+}
+
+sub target_bug_id {
+    my ($self) = @_;
+    return new URI($self->name)->query_param('id');
+}
+
+1;

diff --git a/Bugzilla/BugUrl/Bugzilla/Local.pm b/Bugzilla/BugUrl/Bugzilla/Local.pm
new file mode 100644 (file)
index 0000000..9631716
--- /dev/null
+++ b/Bugzilla/BugUrl/Bugzilla/Local.pm
@@ -0,0 +1,92 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::BugUrl::Bugzilla::Local;
+use strict;
+use base qw(Bugzilla::BugUrl::Bugzilla);
+
+use Bugzilla::Error;
+use Bugzilla::Util;
+
+###############################
+####    Initialization     ####
+###############################
+
+use constant VALIDATOR_DEPENDENCIES => {
+    value => ['bug_id'],
+};
+
+###############################
+####        Methods        ####
+###############################
+
+sub ref_bug_url {
+    my $self = shift;
+
+    if (!exists $self->{ref_bug_url}) {
+        my $ref_bug_id = new URI($self->name)->query_param('id');
+        my $ref_bug = Bugzilla::Bug->check($ref_bug_id);
+        my $ref_value = $self->local_uri($self->bug_id);
+        $self->{ref_bug_url} =
+            new Bugzilla::BugUrl::Bugzilla::Local({ bug_id => $ref_bug->id,
+                                                    value => $ref_value });
+    }
+    return $self->{ref_bug_url};
+}
+
+sub should_handle {
+    my ($class, $uri) = @_;
+
+    # Check if it is either a bug id number or an alias.
+    return 1 if $uri->as_string =~ m/^\w+$/;
+
+    # Check if it is a local Bugzilla uri and call
+    # Bugzilla::BugUrl::Bugzilla to check if it's a valid Bugzilla
+    # see also url.
+    my $canonical_local = URI->new($class->local_uri)->canonical;
+    if ($canonical_local->authority eq $uri->canonical->authority
+        and $canonical_local->path eq $uri->canonical->path)
+    {
+        return $class->SUPER::should_handle($uri);
+    }
+
+    return 0;
+}
+
+sub _check_value {
+    my ($class, $uri, undef, $params) = @_;
+
+    # At this point we are going to treat any word as a
+    # bug id/alias to the local Bugzilla.
+    my $value = $uri->as_string;
+    if ($value =~ m/^\w+$/) {
+        $uri = new URI($class->local_uri($value));
+    } else {
+        # It's not a word, then we have to check
+        # if it's a valid Bugzilla url.
+        $uri = $class->SUPER::_check_value($uri);
+    }
+
+    my $ref_bug_id  = $uri->query_param('id');
+    my $ref_bug     = Bugzilla::Bug->check($ref_bug_id);
+    my $self_bug_id = $params->{bug_id};
+    $params->{ref_bug} = $ref_bug;
+
+    if ($ref_bug->id == $self_bug_id) {
+        ThrowUserError('see_also_self_reference');
+    }
+ 
+    return $uri;
+}
+
+sub local_uri {
+    my ($self, $bug_id) = @_;
+    $bug_id ||= '';
+    return correct_urlbase() . "show_bug.cgi?id=$bug_id";
+}
+
+1;

diff --git a/Bugzilla/BugUrl/Debian.pm b/Bugzilla/BugUrl/Debian.pm
new file mode 100644 (file)
index 0000000..cce4c25
--- /dev/null
+++ b/Bugzilla/BugUrl/Debian.pm
@@ -0,0 +1,41 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::BugUrl::Debian;
+use strict;
+use base qw(Bugzilla::BugUrl);
+
+###############################
+####        Methods        ####
+###############################
+
+sub should_handle {
+    my ($class, $uri) = @_;
+
+    # Debian BTS URLs can look like various things:
+    #   http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1234
+    #   http://bugs.debian.org/1234
+    return (lc($uri->authority) eq 'bugs.debian.org'
+            and (($uri->path =~ /bugreport\.cgi$/
+                  and $uri->query_param('bug') =~ m|^\d+$|)
+                 or $uri->path =~ m|^/\d+$|)) ? 1 : 0;
+}
+
+sub _check_value {
+    my $class = shift;
+
+    my $uri = $class->SUPER::_check_value(@_);
+
+    # This is the shortest standard URL form for Debian BTS URLs,
+    # and so we reduce all URLs to this.
+    $uri->path =~ m|^/(\d+)$| || $uri->query_param('bug') =~ m|^(\d+)$|;
+    $uri = new URI("http://bugs.debian.org/$1");
+
+    return $uri;
+}
+
+1;

diff --git a/Bugzilla/BugUrl/GitHub.pm b/Bugzilla/BugUrl/GitHub.pm
new file mode 100644 (file)
index 0000000..eeffa2e
--- /dev/null
+++ b/Bugzilla/BugUrl/GitHub.pm
@@ -0,0 +1,36 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::BugUrl::GitHub;
+use strict;
+use base qw(Bugzilla::BugUrl);
+
+###############################
+####        Methods        ####
+###############################
+
+sub should_handle {
+    my ($class, $uri) = @_;
+
+    # GitHub issue URLs have only one form:
+    #  https://github.com/USER_OR_TEAM_OR_ORGANIZATION_NAME/REPOSITORY_NAME/issues/111
+    return (lc($uri->authority) eq 'github.com'
+            and $uri->path =~ m|^/[^/]+/[^/]+/issues/\d+$|) ? 1 : 0;
+}
+
+sub _check_value {
+    my ($class, $uri) = @_;
+
+    $uri = $class->SUPER::_check_value($uri);
+
+    # GitHub HTTP URLs redirect to HTTPS, so just use the HTTPS scheme.
+    $uri->scheme('https');
+
+    return $uri;
+}
+
+1;

diff --git a/Bugzilla/BugUrl/Google.pm b/Bugzilla/BugUrl/Google.pm
new file mode 100644 (file)
index 0000000..9c49f0d
--- /dev/null
+++ b/Bugzilla/BugUrl/Google.pm
@@ -0,0 +1,40 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::BugUrl::Google;
+use strict;
+use base qw(Bugzilla::BugUrl);
+
+###############################
+####        Methods        ####
+###############################
+
+sub should_handle {
+    my ($class, $uri) = @_;
+
+    # Google Code URLs only have one form:
+    #   http(s)://code.google.com/p/PROJECT_NAME/issues/detail?id=1234
+    return (lc($uri->authority) eq 'code.google.com'
+            and $uri->path =~ m|^/p/[^/]+/issues/detail$|
+            and $uri->query_param('id') =~ /^\d+$/) ? 1 : 0;
+}
+
+sub _check_value {
+    my ($class, $uri) = @_;
+    
+    $uri = $class->SUPER::_check_value($uri);
+
+    # While Google Code URLs can be either HTTP or HTTPS,
+    # always go with the HTTP scheme, as that's the default.
+    if ($uri->scheme eq 'https') {
+        $uri->scheme('http');
+    }
+
+    return $uri;
+}
+
+1;

diff --git a/Bugzilla/BugUrl/JIRA.pm b/Bugzilla/BugUrl/JIRA.pm
new file mode 100644 (file)
index 0000000..f5f7ee5
--- /dev/null
+++ b/Bugzilla/BugUrl/JIRA.pm
@@ -0,0 +1,38 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::BugUrl::JIRA;
+use strict;
+use base qw(Bugzilla::BugUrl);
+
+###############################
+####        Methods        ####
+###############################
+
+sub should_handle {
+    my ($class, $uri) = @_;
+
+    # JIRA URLs have only one basic form (but the jira is optional):
+    #   https://issues.apache.org/jira/browse/KEY-1234
+    #   http://issues.example.com/browse/KEY-1234
+    return ($uri->path =~ m|/browse/[A-Z][A-Z]+-\d+$|) ? 1 : 0;
+}
+
+sub _check_value {
+    my $class = shift;
+
+    my $uri = $class->SUPER::_check_value(@_);
+
+    # Make sure there are no query parameters.
+    $uri->query(undef);
+    # And remove any # part if there is one.
+    $uri->fragment(undef);
+
+    return $uri;
+}
+
+1;

diff --git a/Bugzilla/BugUrl/Launchpad.pm b/Bugzilla/BugUrl/Launchpad.pm
new file mode 100644 (file)
index 0000000..2ae2c38
--- /dev/null
+++ b/Bugzilla/BugUrl/Launchpad.pm
@@ -0,0 +1,40 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::BugUrl::Launchpad;
+use strict;
+use base qw(Bugzilla::BugUrl);
+
+###############################
+####        Methods        ####
+###############################
+
+sub should_handle {
+    my ($class, $uri) = @_;
+
+    # Launchpad bug URLs can look like various things:
+    #   https://bugs.launchpad.net/ubuntu/+bug/1234
+    #   https://launchpad.net/bugs/1234
+    # All variations end with either "/bugs/1234" or "/+bug/1234"
+    return ($uri->authority =~ /launchpad\.net$/
+            and $uri->path =~ m|bugs?/\d+$|) ? 1 : 0;
+}
+
+sub _check_value {
+    my ($class, $uri) = @_;
+
+    $uri = $class->SUPER::_check_value($uri);
+
+    # This is the shortest standard URL form for Launchpad bugs,
+    # and so we reduce all URLs to this.
+    $uri->path =~ m|bugs?/(\d+)$|;
+    $uri = new URI("https://launchpad.net/bugs/$1");
+
+    return $uri;
+}
+
+1;

diff --git a/Bugzilla/BugUrl/MantisBT.pm b/Bugzilla/BugUrl/MantisBT.pm
new file mode 100644 (file)
index 0000000..3d49ede
--- /dev/null
+++ b/Bugzilla/BugUrl/MantisBT.pm
@@ -0,0 +1,35 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::BugUrl::MantisBT;
+use strict;
+use base qw(Bugzilla::BugUrl);
+
+###############################
+####        Methods        ####
+###############################
+
+sub should_handle {
+    my ($class, $uri) = @_;
+
+    # MantisBT URLs look like the following ('bugs' directory is optional):
+    #   http://www.mantisbt.org/bugs/view.php?id=1234
+    return ($uri->path_query =~ m|view\.php\?id=\d+$|) ? 1 : 0;
+}
+
+sub _check_value {
+    my $class = shift;
+
+    my $uri = $class->SUPER::_check_value(@_);
+
+    # Remove any # part if there is one.
+    $uri->fragment(undef);
+
+    return $uri;
+}
+
+1;

diff --git a/Bugzilla/BugUrl/SourceForge.pm b/Bugzilla/BugUrl/SourceForge.pm
new file mode 100644 (file)
index 0000000..fcc7200
--- /dev/null
+++ b/Bugzilla/BugUrl/SourceForge.pm
@@ -0,0 +1,40 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::BugUrl::SourceForge;
+use strict;
+use base qw(Bugzilla::BugUrl);
+
+###############################
+####        Methods        ####
+###############################
+
+sub should_handle {
+    my ($class, $uri) = @_;
+
+    # SourceForge tracker URLs have only one form:
+    #  http://sourceforge.net/tracker/?func=detail&aid=111&group_id=111&atid=111
+    return (lc($uri->authority) eq 'sourceforge.net'
+            and $uri->path =~ m|/tracker/|
+            and $uri->query_param('func') eq 'detail'
+            and $uri->query_param('aid')
+            and $uri->query_param('group_id')
+            and $uri->query_param('atid')) ? 1 : 0;
+}
+
+sub _check_value {
+    my $class = shift;
+
+    my $uri = $class->SUPER::_check_value(@_);
+
+    # Remove any # part if there is one.
+    $uri->fragment(undef);
+
+    return $uri;
+}
+
+1;

diff --git a/Bugzilla/BugUrl/Trac.pm b/Bugzilla/BugUrl/Trac.pm
new file mode 100644 (file)
index 0000000..8f6e9cd
--- /dev/null
+++ b/Bugzilla/BugUrl/Trac.pm
@@ -0,0 +1,38 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::BugUrl::Trac;
+use strict;
+use base qw(Bugzilla::BugUrl);
+
+###############################
+####        Methods        ####
+###############################
+
+sub should_handle {
+    my ($class, $uri) = @_;
+
+    # Trac URLs can look like various things:
+    #   http://dev.mutt.org/trac/ticket/1234
+    #   http://trac.roundcube.net/ticket/1484130
+    return ($uri->path =~ m|/ticket/\d+$|) ? 1 : 0;
+}
+
+sub _check_value {
+    my $class = shift;
+
+    my $uri = $class->SUPER::_check_value(@_);
+
+    # Make sure there are no query parameters.
+    $uri->query(undef);
+    # And remove any # part if there is one.
+    $uri->fragment(undef);
+
+    return $uri;
+}
+
+1;

diff --git a/Bugzilla/CGI.pm b/Bugzilla/CGI.pm
new file mode 100644 (file)
index 0000000..a68195f
--- /dev/null
+++ b/Bugzilla/CGI.pm
@@ -0,0 +1,639 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::CGI;
+use strict;
+use base qw(CGI);
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Util;
+use Bugzilla::Search::Recent;
+
+use File::Basename;
+
+sub _init_bz_cgi_globals {
+    my $invocant = shift;
+    # We need to disable output buffering - see bug 179174
+    $| = 1;
+
+    # Ignore SIGTERM and SIGPIPE - this prevents DB corruption. If the user closes
+    # their browser window while a script is running, the web server sends these
+    # signals, and we don't want to die half way through a write.
+    $SIG{TERM} = 'IGNORE';
+    $SIG{PIPE} = 'IGNORE';
+
+    # We don't precompile any functions here, that's done specially in
+    # mod_perl code.
+    $invocant->_setup_symbols(qw(:no_xhtml :oldstyle_urls :private_tempfiles
+                                 :unique_headers));
+}
+
+BEGIN { __PACKAGE__->_init_bz_cgi_globals() if i_am_cgi(); }
+
+sub new {
+    my ($invocant, @args) = @_;
+    my $class = ref($invocant) || $invocant;
+
+    # Under mod_perl, CGI's global variables get reset on each request,
+    # so we need to set them up again every time.
+    $class->_init_bz_cgi_globals() if $ENV{MOD_PERL};
+
+    my $self = $class->SUPER::new(@args);
+
+    # Make sure our outgoing cookie list is empty on each invocation
+    $self->{Bugzilla_cookie_list} = [];
+
+    # Path-Info is of no use for Bugzilla and interacts badly with IIS.
+    # Moreover, it causes unexpected behaviors, such as totally breaking
+    # the rendering of pages.
+    my $script = basename($0);
+    if (my $path_info = $self->path_info) {
+        my @whitelist;
+        Bugzilla::Hook::process('path_info_whitelist', { whitelist => \@whitelist });
+        if (!grep($_ eq $script, @whitelist)) {
+            # IIS includes the full path to the script in PATH_INFO,
+            # so we have to extract the real PATH_INFO from it,
+            # else we will be redirected outside Bugzilla.
+            my $script_name = $self->script_name;
+            $path_info =~ s/^\Q$script_name\E//;
+            if ($path_info) {
+                print $self->redirect($self->url(-path => 0, -query => 1));
+            }
+        }
+    }
+
+    # Send appropriate charset
+    $self->charset(Bugzilla->params->{'utf8'} ? 'UTF-8' : '');
+
+    # Redirect to urlbase/sslbase if we are not viewing an attachment.
+    if ($self->url_is_attachment_base and $script ne 'attachment.cgi') {
+        $self->redirect_to_urlbase();
+    }
+
+    # Check for errors
+    # All of the Bugzilla code wants to do this, so do it here instead of
+    # in each script
+
+    my $err = $self->cgi_error;
+
+    if ($err) {
+        # Note that this error block is only triggered by CGI.pm for malformed
+        # multipart requests, and so should never happen unless there is a
+        # browser bug.
+
+        print $self->header(-status => $err);
+
+        # ThrowCodeError wants to print the header, so it grabs Bugzilla->cgi
+        # which creates a new Bugzilla::CGI object, which fails again, which
+        # ends up here, and calls ThrowCodeError, and then recurses forever.
+        # So don't use it.
+        # In fact, we can't use templates at all, because we need a CGI object
+        # to determine the template lang as well as the current url (from the
+        # template)
+        # Since this is an internal error which indicates a severe browser bug,
+        # just die.
+        die "CGI parsing error: $err";
+    }
+
+    return $self;
+}
+
+# We want this sorted plus the ability to exclude certain params
+sub canonicalise_query {
+    my ($self, @exclude) = @_;
+
+    # Reconstruct the URL by concatenating the sorted param=value pairs
+    my @parameters;
+    foreach my $key (sort($self->param())) {
+        # Leave this key out if it's in the exclude list
+        next if grep { $_ eq $key } @exclude;
+
+        # Remove the Boolean Charts for standard query.cgi fields
+        # They are listed in the query URL already
+        next if $key =~ /^(field|type|value)(-\d+){3}$/;
+
+        my $esc_key = url_quote($key);
+
+        foreach my $value ($self->param($key)) {
+            if (defined($value)) {
+                my $esc_value = url_quote($value);
+
+                push(@parameters, "$esc_key=$esc_value");
+            }
+        }
+    }
+
+    return join("&", @parameters);
+}
+
+sub clean_search_url {
+    my $self = shift;
+    # Delete any empty URL parameter.
+    my @cgi_params = $self->param;
+
+    foreach my $param (@cgi_params) {
+        if (defined $self->param($param) && $self->param($param) eq '') {
+            $self->delete($param);
+            $self->delete("${param}_type");
+        }
+
+        # Custom Search stuff is empty if it's "noop". We also keep around
+        # the old Boolean Chart syntax for backwards-compatibility.
+        if (($param =~ /\d-\d-\d/ || $param =~ /^[[:alpha:]]\d+$/)
+            && defined $self->param($param) && $self->param($param) eq 'noop')
+        {
+            $self->delete($param);
+        }
+        
+        # Any "join" for custom search that's an AND can be removed, because
+        # that's the default.
+        if (($param =~ /^j\d+$/ || $param eq 'j_top')
+            && $self->param($param) eq 'AND')
+        {
+            $self->delete($param);
+        }
+    }
+
+    # Delete leftovers from the login form
+    $self->delete('Bugzilla_remember', 'GoAheadAndLogIn');
+
+    # Delete the token if we're not performing an action which needs it
+    unless ((defined $self->param('remtype')
+             && ($self->param('remtype') eq 'asdefault'
+                 || $self->param('remtype') eq 'asnamed'))
+            || (defined $self->param('remaction')
+                && $self->param('remaction') eq 'forget'))
+    {
+        $self->delete("token");
+    }
+
+    foreach my $num (1,2,3) {
+        # If there's no value in the email field, delete the related fields.
+        if (!$self->param("email$num")) {
+            foreach my $field (qw(type assigned_to reporter qa_contact cc longdesc)) {
+                $self->delete("email$field$num");
+            }
+        }
+    }
+
+    # chfieldto is set to "Now" by default in query.cgi. But if none
+    # of the other chfield parameters are set, it's meaningless.
+    if (!defined $self->param('chfieldfrom') && !$self->param('chfield')
+        && !defined $self->param('chfieldvalue') && $self->param('chfieldto')
+        && lc($self->param('chfieldto')) eq 'now')
+    {
+        $self->delete('chfieldto');
+    }
+
+    # cmdtype "doit" is the default from query.cgi, but it's only meaningful
+    # if there's a remtype parameter.
+    if (defined $self->param('cmdtype') && $self->param('cmdtype') eq 'doit'
+        && !defined $self->param('remtype'))
+    {
+        $self->delete('cmdtype');
+    }
+
+    # "Reuse same sort as last time" is actually the default, so we don't
+    # need it in the URL.
+    if ($self->param('order') 
+        && $self->param('order') eq 'Reuse same sort as last time')
+    {
+        $self->delete('order');
+    }
+
+    # list_id is added in buglist.cgi after calling clean_search_url,
+    # and doesn't need to be saved in saved searches.
+    $self->delete('list_id');
+
+    # no_redirect is used internally by redirect_search_url().
+    $self->delete('no_redirect');
+
+    # And now finally, if query_format is our only parameter, that
+    # really means we have no parameters, so we should delete query_format.
+    if ($self->param('query_format') && scalar($self->param()) == 1) {
+        $self->delete('query_format');
+    }
+}
+
+sub check_etag {
+    my ($self, $valid_etag) = @_;
+
+    # ETag support.
+    my $if_none_match = $self->http('If-None-Match');
+    return if !$if_none_match;
+
+    my @if_none = split(/[\s,]+/, $if_none_match);
+    foreach my $possible_etag (@if_none) {
+        # remove quotes from begin and end of the string
+        $possible_etag =~ s/^\"//g;
+        $possible_etag =~ s/\"$//g;
+        if ($possible_etag eq $valid_etag or $possible_etag eq '*') {
+            print $self->header(-ETag => $possible_etag,
+                                -status => '304 Not Modified');
+            exit;
+        }
+    }
+}
+
+# Have to add the cookies in.
+sub multipart_start {
+    my $self = shift;
+    
+    my %args = @_;
+
+    # CGI.pm::multipart_start doesn't honour its own charset information, so
+    # we do it ourselves here
+    if (defined $self->charset() && defined $args{-type}) {
+        # Remove any existing charset specifier
+        $args{-type} =~ s/;.*$//;
+        # and add the specified one
+        $args{-type} .= '; charset=' . $self->charset();
+    }
+        
+    my $headers = $self->SUPER::multipart_start(%args);
+    # Eliminate the one extra CRLF at the end.
+    $headers =~ s/$CGI::CRLF$//;
+    # Add the cookies. We have to do it this way instead of
+    # passing them to multpart_start, because CGI.pm's multipart_start
+    # doesn't understand a '-cookie' argument pointing to an arrayref.
+    foreach my $cookie (@{$self->{Bugzilla_cookie_list}}) {
+        $headers .= "Set-Cookie: ${cookie}${CGI::CRLF}";
+    }
+    $headers .= $CGI::CRLF;
+    return $headers;
+}
+
+# Override header so we can add the cookies in
+sub header {
+    my $self = shift;
+
+    # If there's only one parameter, then it's a Content-Type.
+    if (scalar(@_) == 1) {
+        # Since we're adding parameters below, we have to name it.
+        unshift(@_, '-type' => shift(@_));
+    }
+
+    # Add the cookies in if we have any
+    if (scalar(@{$self->{Bugzilla_cookie_list}})) {
+        unshift(@_, '-cookie' => $self->{Bugzilla_cookie_list});
+    }
+
+    # Add Strict-Transport-Security (STS) header if this response
+    # is over SSL and the strict_transport_security param is turned on.
+    if ($self->https && !$self->url_is_attachment_base
+        && Bugzilla->params->{'strict_transport_security'} ne 'off') 
+    {
+        my $sts_opts = 'max-age=' . MAX_STS_AGE;
+        if (Bugzilla->params->{'strict_transport_security'} 
+            eq 'include_subdomains')
+        {
+            $sts_opts .= '; includeSubDomains';
+        }
+        unshift(@_, '-strict_transport_security' => $sts_opts);
+    }
+
+    # Add X-Frame-Options header to prevent framing and subsequent
+    # possible clickjacking problems.
+    unless ($self->url_is_attachment_base) {
+        unshift(@_, '-x_frame_options' => 'SAMEORIGIN');
+    }
+
+    # Add X-XSS-Protection header to prevent simple XSS attacks
+    # and enforce the blocking (rather than the rewriting) mode.
+    unshift(@_, '-x_xss_protection' => '1; mode=block');
+
+    # Add X-Content-Type-Options header to prevent browsers sniffing
+    # the MIME type away from the declared Content-Type.
+    unshift(@_, '-x_content_type_options' => 'nosniff');
+
+    return $self->SUPER::header(@_) || "";
+}
+
+sub param {
+    my $self = shift;
+
+    # When we are just requesting the value of a parameter...
+    if (scalar(@_) == 1) {
+        my @result = $self->SUPER::param(@_); 
+
+        # Also look at the URL parameters, after we look at the POST 
+        # parameters. This is to allow things like login-form submissions
+        # with URL parameters in the form's "target" attribute.
+        if (!scalar(@result)
+            && $self->request_method && $self->request_method eq 'POST')
+        {
+            # Some servers fail to set the QUERY_STRING parameter, which
+            # causes undef issues
+            $ENV{'QUERY_STRING'} = '' unless exists $ENV{'QUERY_STRING'};
+            @result = $self->SUPER::url_param(@_);
+        }
+
+        # Fix UTF-8-ness of input parameters.
+        if (Bugzilla->params->{'utf8'}) {
+            @result = map { _fix_utf8($_) } @result;
+        }
+
+        return wantarray ? @result : $result[0];
+    }
+    # And for various other functions in CGI.pm, we need to correctly
+    # return the URL parameters in addition to the POST parameters when
+    # asked for the list of parameters.
+    elsif (!scalar(@_) && $self->request_method 
+           && $self->request_method eq 'POST') 
+    {
+        my @post_params = $self->SUPER::param;
+        my @url_params  = $self->url_param;
+        my %params = map { $_ => 1 } (@post_params, @url_params);
+        return keys %params;
+    }
+
+    return $self->SUPER::param(@_);
+}
+
+sub _fix_utf8 {
+    my $input = shift;
+    # The is_utf8 is here in case CGI gets smart about utf8 someday.
+    utf8::decode($input) if defined $input && !ref $input && !utf8::is_utf8($input);
+    return $input;
+}
+
+sub should_set {
+    my ($self, $param) = @_;
+    my $set = (defined $self->param($param) 
+               or defined $self->param("defined_$param"))
+              ? 1 : 0;
+    return $set;
+}
+
+# The various parts of Bugzilla which create cookies don't want to have to
+# pass them around to all of the callers. Instead, store them locally here,
+# and then output as required from |header|.
+sub send_cookie {
+    my $self = shift;
+
+    # Move the param list into a hash for easier handling.
+    my %paramhash;
+    my @paramlist;
+    my ($key, $value);
+    while ($key = shift) {
+        $value = shift;
+        $paramhash{$key} = $value;
+    }
+
+    # Complain if -value is not given or empty (bug 268146).
+    if (!exists($paramhash{'-value'}) || !$paramhash{'-value'}) {
+        ThrowCodeError('cookies_need_value');
+    }
+
+    # Add the default path and the domain in.
+    $paramhash{'-path'} = Bugzilla->params->{'cookiepath'};
+    $paramhash{'-domain'} = Bugzilla->params->{'cookiedomain'}
+        if Bugzilla->params->{'cookiedomain'};
+
+    # Move the param list back into an array for the call to cookie().
+    foreach (keys(%paramhash)) {
+        unshift(@paramlist, $_ => $paramhash{$_});
+    }
+
+    push(@{$self->{'Bugzilla_cookie_list'}}, $self->cookie(@paramlist));
+}
+
+# Cookies are removed by setting an expiry date in the past.
+# This method is a send_cookie wrapper doing exactly this.
+sub remove_cookie {
+    my $self = shift;
+    my ($cookiename) = (@_);
+
+    # Expire the cookie, giving a non-empty dummy value (bug 268146).
+    $self->send_cookie('-name'    => $cookiename,
+                       '-expires' => 'Tue, 15-Sep-1998 21:49:00 GMT',
+                       '-value'   => 'X');
+}
+
+# This helps implement Bugzilla::Search::Recent, and also shortens search
+# URLs that get POSTed to buglist.cgi.
+sub redirect_search_url {
+    my $self = shift;
+
+    # If there is no parameter, there is nothing to do.
+    return unless $self->param;
+
+    # If we're retreiving an old list, we never need to redirect or
+    # do anything related to Bugzilla::Search::Recent.
+    return if $self->param('regetlastlist');
+
+    my $user = Bugzilla->user;
+
+    if ($user->id) {
+        # There are two conditions that could happen here--we could get a URL
+        # with no list id, and we could get a URL with a list_id that isn't
+        # ours.
+        my $list_id = $self->param('list_id');
+        if ($list_id) {
+            # If we have a valid list_id, no need to redirect or clean.
+            return if Bugzilla::Search::Recent->check_quietly(
+                { id => $list_id });
+        }
+    }
+    elsif ($self->request_method ne 'POST') {
+        # Logged-out users who do a GET don't get a list_id, don't get
+        # their URLs cleaned, and don't get redirected.
+        return;
+    }
+
+    my $no_redirect = $self->param('no_redirect');
+    $self->clean_search_url();
+
+    # Make sure we still have params still after cleaning otherwise we 
+    # do not want to store a list_id for an empty search.
+    if ($user->id && $self->param) {
+        # Insert a placeholder Bugzilla::Search::Recent, so that we know what
+        # the id of the resulting search will be. This is then pulled out
+        # of the Referer header when viewing show_bug.cgi to know what
+        # bug list we came from.
+        my $recent_search = Bugzilla::Search::Recent->create_placeholder;
+        $self->param('list_id', $recent_search->id);
+    }
+
+    # Browsers which support history.replaceState do not need to be
+    # redirected. We can fix the URL on the fly.
+    return if $no_redirect;
+
+    # GET requests that lacked a list_id are always redirected. POST requests
+    # are only redirected if they're under the CGI_URI_LIMIT though.
+    my $uri_length = length($self->self_url());
+    if ($self->request_method() ne 'POST' or $uri_length < CGI_URI_LIMIT) {
+        print $self->redirect(-url => $self->self_url());
+        exit;
+    }
+}
+
+sub redirect_to_https {
+    my $self = shift;
+    my $sslbase = Bugzilla->params->{'sslbase'};
+    # If this is a POST, we don't want ?POSTDATA in the query string.
+    # We expect the client to re-POST, which may be a violation of
+    # the HTTP spec, but the only time we're expecting it often is
+    # in the WebService, and WebService clients usually handle this
+    # correctly.
+    $self->delete('POSTDATA');
+    my $url = $sslbase . $self->url('-path_info' => 1, '-query' => 1, 
+                                    '-relative' => 1);
+
+    # XML-RPC clients (SOAP::Lite at least) require a 301 to redirect properly
+    # and do not work with 302. Our redirect really is permanent anyhow, so
+    # it doesn't hurt to make it a 301.
+    print $self->redirect(-location => $url, -status => 301);
+
+    # When using XML-RPC with mod_perl, we need the headers sent immediately.
+    $self->r->rflush if $ENV{MOD_PERL};
+    exit;
+}
+
+# Redirect to the urlbase version of the current URL.
+sub redirect_to_urlbase {
+    my $self = shift;
+    my $path = $self->url('-path_info' => 1, '-query' => 1, '-relative' => 1);
+    print $self->redirect('-location' => correct_urlbase() . $path);
+    exit;
+}
+
+sub url_is_attachment_base {
+    my ($self, $id) = @_;
+    return 0 if !use_attachbase() or !i_am_cgi();
+    my $attach_base = Bugzilla->params->{'attachment_base'};
+    # If we're passed an id, we only want one specific attachment base
+    # for a particular bug. If we're not passed an ID, we just want to
+    # know if our current URL matches the attachment_base *pattern*.
+    my $regex;
+    if ($id) {
+        $attach_base =~ s/\%bugid\%/$id/;
+        $regex = quotemeta($attach_base);
+    }
+    else {
+        # In this circumstance we run quotemeta first because we need to
+        # insert an active regex meta-character afterward.
+        $regex = quotemeta($attach_base);
+        $regex =~ s/\\\%bugid\\\%/\\d+/;
+    }
+    $regex = "^$regex";
+    return ($self->self_url =~ $regex) ? 1 : 0;
+}
+
+##########################
+# Vars TIEHASH Interface #
+##########################
+
+# Fix the TIEHASH interface (scalar $cgi->Vars) to return and accept 
+# arrayrefs.
+sub STORE {
+    my $self = shift;
+    my ($param, $value) = @_;
+    if (defined $value and ref $value eq 'ARRAY') {
+        return $self->param(-name => $param, -value => $value);
+    }
+    return $self->SUPER::STORE(@_);
+}
+
+sub FETCH {
+    my ($self, $param) = @_;
+    return $self if $param eq 'CGI'; # CGI.pm did this, so we do too.
+    my @result = $self->param($param);
+    return undef if !scalar(@result);
+    return $result[0] if scalar(@result) == 1;
+    return \@result;
+}
+
+# For the Vars TIEHASH interface: the normal CGI.pm DELETE doesn't return 
+# the value deleted, but Perl's "delete" expects that value.
+sub DELETE {
+    my ($self, $param) = @_;
+    my $value = $self->FETCH($param);
+    $self->delete($param);
+    return $value;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::CGI - CGI handling for Bugzilla
+
+=head1 SYNOPSIS
+
+  use Bugzilla::CGI;
+
+  my $cgi = new Bugzilla::CGI();
+
+=head1 DESCRIPTION
+
+This package inherits from the standard CGI module, to provide additional
+Bugzilla-specific functionality. In general, see L<the CGI.pm docs|CGI> for
+documention.
+
+=head1 CHANGES FROM L<CGI.PM|CGI>
+
+Bugzilla::CGI has some differences from L<CGI.pm|CGI>.
+
+=over 4
+
+=item C<cgi_error> is automatically checked
+
+After creating the CGI object, C<Bugzilla::CGI> automatically checks
+I<cgi_error>, and throws a CodeError if a problem is detected.
+
+=back
+
+=head1 ADDITIONAL FUNCTIONS
+
+I<Bugzilla::CGI> also includes additional functions.
+
+=over 4
+
+=item C<canonicalise_query(@exclude)>
+
+This returns a sorted string of the parameters, suitable for use in a url.
+Values in C<@exclude> are not included in the result.
+
+=item C<send_cookie>
+
+This routine is identical to the cookie generation part of CGI.pm's C<cookie>
+routine, except that it knows about Bugzilla's cookie_path and cookie_domain
+parameters and takes them into account if necessary.
+This should be used by all Bugzilla code (instead of C<cookie> or the C<-cookie>
+argument to C<header>), so that under mod_perl the headers can be sent
+correctly, using C<print> or the mod_perl APIs as appropriate.
+
+To remove (expire) a cookie, use C<remove_cookie>.
+
+=item C<remove_cookie>
+
+This is a wrapper around send_cookie, setting an expiry date in the past,
+effectively removing the cookie.
+
+As its only argument, it takes the name of the cookie to expire.
+
+=item C<redirect_to_https>
+
+This routine redirects the client to the https version of the page that
+they're looking at, using the C<sslbase> parameter for the redirection.
+
+Generally you should use L<Bugzilla::Util/do_ssl_redirect_if_required>
+instead of calling this directly.
+
+=item C<redirect_to_urlbase>
+
+Redirects from the current URL to one prefixed by the urlbase parameter.
+
+=back
+
+=head1 SEE ALSO
+
+L<CGI|CGI>, L<CGI::Cookie|CGI::Cookie>

diff --git a/Bugzilla/Chart.pm b/Bugzilla/Chart.pm
new file mode 100644 (file)
index 0000000..0a65576
--- /dev/null
+++ b/Bugzilla/Chart.pm
@@ -0,0 +1,429 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+# This module represents a chart.
+#
+# Note that it is perfectly legal for the 'lines' member variable of this
+# class (which is an array of Bugzilla::Series objects) to have empty members
+# in it. If this is true, the 'labels' array will also have empty members at
+# the same points.
+package Bugzilla::Chart;
+
+use Bugzilla::Error;
+use Bugzilla::Util;
+use Bugzilla::Series;
+
+use Date::Format;
+use Date::Parse;
+use List::Util qw(max);
+
+sub new {
+    my $invocant = shift;
+    my $class = ref($invocant) || $invocant;
+  
+    # Create a ref to an empty hash and bless it
+    my $self = {};
+    bless($self, $class);
+
+    if ($#_ == 0) {
+        # Construct from a CGI object.
+        $self->init($_[0]);
+    } 
+    else {
+        die("CGI object not passed in - invalid number of args \($#_\)($_)");
+    }
+
+    return $self;
+}
+
+sub init {
+    my $self = shift;
+    my $cgi = shift;
+
+    # The data structure is a list of lists (lines) of Series objects. 
+    # There is a separate list for the labels.
+    #
+    # The URL encoding is:
+    # line0=67&line0=73&line1=81&line2=67...
+    # &label0=B+/+R+/+CONFIRMED&label1=...
+    # &select0=1&select3=1...    
+    # &cumulate=1&datefrom=2002-02-03&dateto=2002-04-04&ctype=html...
+    # &gt=1&labelgt=Grand+Total    
+    foreach my $param ($cgi->param()) {
+        # Store all the lines
+        if ($param =~ /^line(\d+)$/) {
+            foreach my $series_id ($cgi->param($param)) {
+                detaint_natural($series_id) 
+                                     || ThrowCodeError("invalid_series_id");
+                my $series = new Bugzilla::Series($series_id);
+                push(@{$self->{'lines'}[$1]}, $series) if $series;
+            }
+        }
+
+        # Store all the labels
+        if ($param =~ /^label(\d+)$/) {
+            $self->{'labels'}[$1] = $cgi->param($param);
+        }        
+    }
+    
+    # Store the miscellaneous metadata
+    $self->{'cumulate'} = $cgi->param('cumulate') ? 1 : 0;
+    $self->{'gt'}       = $cgi->param('gt') ? 1 : 0;
+    $self->{'labelgt'}  = $cgi->param('labelgt');
+    $self->{'datefrom'} = $cgi->param('datefrom');
+    $self->{'dateto'}   = $cgi->param('dateto');
+    
+    # If we are cumulating, a grand total makes no sense
+    $self->{'gt'} = 0 if $self->{'cumulate'};
+    
+    # Make sure the dates are ones we are able to interpret
+    foreach my $date ('datefrom', 'dateto') {
+        if ($self->{$date}) {
+            $self->{$date} = str2time($self->{$date}) 
+              || ThrowUserError("illegal_date", { date => $self->{$date}});
+        }
+    }
+
+    # datefrom can't be after dateto
+    if ($self->{'datefrom'} && $self->{'dateto'} && 
+        $self->{'datefrom'} > $self->{'dateto'}) 
+    {
+          ThrowUserError("misarranged_dates", 
+                                         {'datefrom' => $cgi->param('datefrom'),
+                                          'dateto' => $cgi->param('dateto')});
+    }    
+}
+
+# Alter Chart so that the selected series are added to it.
+sub add {
+    my $self = shift;
+    my @series_ids = @_;
+
+    # Get the current size of the series; required for adding Grand Total later
+    my $current_size = scalar($self->getSeriesIDs());
+    
+    # Count the number of added series
+    my $added = 0;
+    # Create new Series and push them on to the list of lines.
+    # Note that new lines have no label; the display template is responsible
+    # for inventing something sensible.
+    foreach my $series_id (@series_ids) {
+        my $series = new Bugzilla::Series($series_id);
+        if ($series) {
+            push(@{$self->{'lines'}}, [$series]);
+            push(@{$self->{'labels'}}, "");
+            $added++;
+        }
+    }
+    
+    # If we are going from < 2 to >= 2 series, add the Grand Total line.
+    if (!$self->{'gt'}) {
+        if ($current_size < 2 &&
+            $current_size + $added >= 2) 
+        {
+            $self->{'gt'} = 1;
+        }
+    }
+}
+
+# Alter Chart so that the selections are removed from it.
+sub remove {
+    my $self = shift;
+    my @line_ids = @_;
+    
+    foreach my $line_id (@line_ids) {
+        if ($line_id == 65536) {
+            # Magic value - delete Grand Total.
+            $self->{'gt'} = 0;
+        } 
+        else {
+            delete($self->{'lines'}->[$line_id]);
+            delete($self->{'labels'}->[$line_id]);
+        }
+    }
+}
+
+# Alter Chart so that the selections are summed.
+sub sum {
+    my $self = shift;
+    my @line_ids = @_;
+    
+    # We can't add the Grand Total to things.
+    @line_ids = grep(!/^65536$/, @line_ids);
+        
+    # We can't add less than two things.
+    return if scalar(@line_ids) < 2;
+    
+    my @series;
+    my $label = "";
+    my $biggestlength = 0;
+    
+    # We rescue the Series objects of all the series involved in the sum.
+    foreach my $line_id (@line_ids) {
+        my @line = @{$self->{'lines'}->[$line_id]};
+        
+        foreach my $series (@line) {
+            push(@series, $series);
+        }
+        
+        # We keep the label that labels the line with the most series.
+        if (scalar(@line) > $biggestlength) {
+            $biggestlength = scalar(@line);
+            $label = $self->{'labels'}->[$line_id];
+        }
+    }
+
+    $self->remove(@line_ids);
+
+    push(@{$self->{'lines'}}, \@series);
+    push(@{$self->{'labels'}}, $label);
+}
+
+sub data {
+    my $self = shift;
+    $self->{'_data'} ||= $self->readData();
+    return $self->{'_data'};
+}
+
+# Convert the Chart's data into a plottable form in $self->{'_data'}.
+sub readData {
+    my $self = shift;
+    my @data;
+    my @maxvals;
+
+    # Note: you get a bad image if getSeriesIDs returns nothing
+    # We need to handle errors better.
+    my $series_ids = join(",", $self->getSeriesIDs());
+
+    return [] unless $series_ids;
+
+    # Work out the date boundaries for our data.
+    my $dbh = Bugzilla->dbh;
+    
+    # The date used is the one given if it's in a sensible range; otherwise,
+    # it's the earliest or latest date in the database as appropriate.
+    my $datefrom = $dbh->selectrow_array("SELECT MIN(series_date) " . 
+                                         "FROM series_data " .
+                                         "WHERE series_id IN ($series_ids)");
+    $datefrom = str2time($datefrom);
+
+    if ($self->{'datefrom'} && $self->{'datefrom'} > $datefrom) {
+        $datefrom = $self->{'datefrom'};
+    }
+
+    my $dateto = $dbh->selectrow_array("SELECT MAX(series_date) " . 
+                                       "FROM series_data " .
+                                       "WHERE series_id IN ($series_ids)");
+    $dateto = str2time($dateto); 
+
+    if ($self->{'dateto'} && $self->{'dateto'} < $dateto) {
+        $dateto = $self->{'dateto'};
+    }
+
+    # Convert UNIX times back to a date format usable for SQL queries.
+    my $sql_from = time2str('%Y-%m-%d', $datefrom);
+    my $sql_to = time2str('%Y-%m-%d', $dateto);
+
+    # Prepare the query which retrieves the data for each series
+    my $query = "SELECT " . $dbh->sql_to_days('series_date') . " - " .
+                            $dbh->sql_to_days('?') . ", series_value " .
+                "FROM series_data " .
+                "WHERE series_id = ? " .
+                "AND series_date >= ?";
+    if ($dateto) {
+        $query .= " AND series_date <= ?";
+    }
+    
+    my $sth = $dbh->prepare($query);
+
+    my $gt_index = $self->{'gt'} ? scalar(@{$self->{'lines'}}) : undef;
+    my $line_index = 0;
+
+    $maxvals[$gt_index] = 0 if $gt_index;
+
+    my @datediff_total;
+
+    foreach my $line (@{$self->{'lines'}}) {        
+        # Even if we end up with no data, we need an empty arrayref to prevent
+        # errors in the PNG-generating code
+        $data[$line_index] = [];
+        $maxvals[$line_index] = 0;
+
+        foreach my $series (@$line) {
+
+            # Get the data for this series and add it on
+            if ($dateto) {
+                $sth->execute($sql_from, $series->{'series_id'}, $sql_from, $sql_to);
+            }
+            else {
+                $sth->execute($sql_from, $series->{'series_id'}, $sql_from);
+            }
+            my $points = $sth->fetchall_arrayref();
+
+            foreach my $point (@$points) {
+                my ($datediff, $value) = @$point;
+                $data[$line_index][$datediff] ||= 0;
+                $data[$line_index][$datediff] += $value;
+                if ($data[$line_index][$datediff] > $maxvals[$line_index]) {
+                    $maxvals[$line_index] = $data[$line_index][$datediff];
+                }
+
+                $datediff_total[$datediff] += $value;
+
+                # Add to the grand total, if we are doing that
+                if ($gt_index) {
+                    $data[$gt_index][$datediff] ||= 0;
+                    $data[$gt_index][$datediff] += $value;
+                    if ($data[$gt_index][$datediff] > $maxvals[$gt_index]) {
+                        $maxvals[$gt_index] = $data[$gt_index][$datediff];
+                    }
+                }
+            }
+        }
+
+        # We are done with the series making up this line, go to the next one
+        $line_index++;
+    }
+
+    # calculate maximum y value
+    if ($self->{'cumulate'}) {
+        # Make sure we do not try to take the max of an array with undef values
+        my @processed_datediff;
+        while (@datediff_total) {
+            my $datediff = shift @datediff_total;
+            push @processed_datediff, $datediff if defined($datediff);
+        }
+        $self->{'y_max_value'} = max(@processed_datediff);
+    }
+    else {
+        $self->{'y_max_value'} = max(@maxvals);
+    }
+    $self->{'y_max_value'} |= 1; # For log()
+
+    # Align the max y value:
+    #  For one- or two-digit numbers, increase y_max_value until divisible by 8
+    #  For larger numbers, see the comments below to figure out what's going on
+    if ($self->{'y_max_value'} < 100) {
+        do {
+            ++$self->{'y_max_value'};
+        } while ($self->{'y_max_value'} % 8 != 0);
+    }
+    else {
+        #  First, get the # of digits in the y_max_value
+        my $num_digits = 1+int(log($self->{'y_max_value'})/log(10));
+
+        # We want to zero out all but the top 2 digits
+        my $mask_length = $num_digits - 2;
+        $self->{'y_max_value'} /= 10**$mask_length;
+        $self->{'y_max_value'} = int($self->{'y_max_value'});
+        $self->{'y_max_value'} *= 10**$mask_length;
+
+        # Add 10^$mask_length to the max value
+        # Continue to increase until it's divisible by 8 * 10^($mask_length-1)
+        # (Throwing in the -1 keeps at least the smallest digit at zero)
+        do {
+            $self->{'y_max_value'} += 10**$mask_length;
+        } while ($self->{'y_max_value'} % (8*(10**($mask_length-1))) != 0);
+    }
+
+        
+    # Add the x-axis labels into the data structure
+    my $date_progression = generateDateProgression($datefrom, $dateto);
+    unshift(@data, $date_progression);
+
+    if ($self->{'gt'}) {
+        # Add Grand Total to label list
+        push(@{$self->{'labels'}}, $self->{'labelgt'});
+
+        $data[$gt_index] ||= [];
+    }
+
+    return \@data;
+}
+
+# Flatten the data structure into a list of series_ids
+sub getSeriesIDs {
+    my $self = shift;
+    my @series_ids;
+
+    foreach my $line (@{$self->{'lines'}}) {
+        foreach my $series (@$line) {
+            push(@series_ids, $series->{'series_id'});
+        }
+    }
+
+    return @series_ids;
+}
+
+# Class method to get the data necessary to populate the "select series"
+# widgets on various pages.
+sub getVisibleSeries {
+    my %cats;
+
+    my $grouplist = Bugzilla->user->groups_as_string;
+    
+    # Get all visible series
+    my $dbh = Bugzilla->dbh;
+    my $serieses = $dbh->selectall_arrayref("SELECT cc1.name, cc2.name, " .
+                        "series.name, series.series_id " .
+                        "FROM series " .
+                        "INNER JOIN series_categories AS cc1 " .
+                        "    ON series.category = cc1.id " .
+                        "INNER JOIN series_categories AS cc2 " .
+                        "    ON series.subcategory = cc2.id " .
+                        "LEFT JOIN category_group_map AS cgm " .
+                        "    ON series.category = cgm.category_id " .
+                        "    AND cgm.group_id NOT IN($grouplist) " .
+                        "WHERE creator = ? OR (is_public = 1 AND cgm.category_id IS NULL) " .
+                   $dbh->sql_group_by('series.series_id', 'cc1.name, cc2.name, ' .
+                                      'series.name'),
+                        undef, Bugzilla->user->id);
+    foreach my $series (@$serieses) {
+        my ($cat, $subcat, $name, $series_id) = @$series;
+        $cats{$cat}{$subcat}{$name} = $series_id;
+    }
+
+    return \%cats;
+}
+
+sub generateDateProgression {
+    my ($datefrom, $dateto) = @_;
+    my @progression;
+
+    $dateto = $dateto || time();
+    my $oneday = 60 * 60 * 24;
+
+    # When the from and to dates are converted by str2time(), you end up with
+    # a time figure representing midnight at the beginning of that day. We
+    # adjust the times by 1/3 and 2/3 of a day respectively to prevent
+    # edge conditions in time2str().
+    $datefrom += $oneday / 3;
+    $dateto += (2 * $oneday) / 3;
+
+    while ($datefrom < $dateto) {
+        push (@progression, time2str("%Y-%m-%d", $datefrom));
+        $datefrom += $oneday;
+    }
+
+    return \@progression;
+}
+
+sub dump {
+    my $self = shift;
+
+    # Make sure we've read in our data
+    my $data = $self->data;
+    
+    require Data::Dumper;
+    say "<pre>Bugzilla::Chart object:";
+    print html_quote(Data::Dumper::Dumper($self));
+    print "</pre>";
+}
+
+1;

diff --git a/Bugzilla/Classification.pm b/Bugzilla/Classification.pm
new file mode 100644 (file)
index 0000000..2b35a88
--- /dev/null
+++ b/Bugzilla/Classification.pm
@@ -0,0 +1,261 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+package Bugzilla::Classification;
+
+use Bugzilla::Constants;
+use Bugzilla::Field;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Product;
+
+use base qw(Bugzilla::Field::ChoiceInterface Bugzilla::Object Exporter);
+@Bugzilla::Classification::EXPORT = qw(sort_products_by_classification);
+
+###############################
+####    Initialization     ####
+###############################
+
+use constant DB_TABLE => 'classifications';
+use constant LIST_ORDER => 'sortkey, name';
+
+use constant DB_COLUMNS => qw(
+    id
+    name
+    description
+    sortkey
+);
+
+use constant UPDATE_COLUMNS => qw(
+    name
+    description
+    sortkey
+);
+
+use constant VALIDATORS => {
+    name        => \&_check_name,
+    description => \&_check_description,
+    sortkey     => \&_check_sortkey,
+};
+
+###############################
+####     Constructors     #####
+###############################
+sub remove_from_db {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    ThrowUserError("classification_not_deletable") if ($self->id == 1);
+
+    $dbh->bz_start_transaction();
+    # Reclassify products to the default classification, if needed.
+    $dbh->do("UPDATE products SET classification_id = 1
+              WHERE classification_id = ?", undef, $self->id);
+
+    $self->SUPER::remove_from_db();
+
+    $dbh->bz_commit_transaction();
+
+}
+
+###############################
+####      Validators       ####
+###############################
+
+sub _check_name {
+    my ($invocant, $name) = @_;
+
+    $name = trim($name);
+    $name || ThrowUserError('classification_not_specified');
+
+    if (length($name) > MAX_CLASSIFICATION_SIZE) {
+        ThrowUserError('classification_name_too_long', {'name' => $name});
+    }
+
+    my $classification = new Bugzilla::Classification({name => $name});
+    if ($classification && (!ref $invocant || $classification->id != $invocant->id)) {
+        ThrowUserError("classification_already_exists", { name => $classification->name });
+    }
+    return $name;
+}
+
+sub _check_description {
+    my ($invocant, $description) = @_;
+
+    $description  = trim($description || '');
+    return $description;
+}
+
+sub _check_sortkey {
+    my ($invocant, $sortkey) = @_;
+
+    $sortkey ||= 0;
+    my $stored_sortkey = $sortkey;
+    if (!detaint_natural($sortkey) || $sortkey > MAX_SMALLINT) {
+        ThrowUserError('classification_invalid_sortkey', { 'sortkey' => $stored_sortkey });
+    }
+    return $sortkey;
+}
+
+#####################################
+# Implement Bugzilla::Field::Choice #
+#####################################
+
+use constant FIELD_NAME => 'classification';
+use constant is_default => 0;
+use constant is_active => 1;
+
+###############################
+####       Methods         ####
+###############################
+
+sub set_name        { $_[0]->set('name', $_[1]); }
+sub set_description { $_[0]->set('description', $_[1]); }
+sub set_sortkey     { $_[0]->set('sortkey', $_[1]); }
+
+sub product_count {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    if (!defined $self->{'product_count'}) {
+        $self->{'product_count'} = $dbh->selectrow_array(q{
+            SELECT COUNT(*) FROM products
+            WHERE classification_id = ?}, undef, $self->id) || 0;
+    }
+    return $self->{'product_count'};
+}
+
+sub products {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    if (!$self->{'products'}) {
+        my $product_ids = $dbh->selectcol_arrayref(q{
+            SELECT id FROM products
+            WHERE classification_id = ?
+            ORDER BY name}, undef, $self->id);
+
+        $self->{'products'} = Bugzilla::Product->new_from_list($product_ids);
+    }
+    return $self->{'products'};
+}
+
+###############################
+####      Accessors        ####
+###############################
+
+sub description { return $_[0]->{'description'}; }
+sub sortkey     { return $_[0]->{'sortkey'};     }
+
+
+###############################
+####       Helpers         ####
+###############################
+
+# This function is a helper to sort products to be listed
+# in global/choose-product.html.tmpl.
+
+sub sort_products_by_classification {
+    my $products = shift;
+    my $list;
+
+    if (Bugzilla->params->{'useclassification'}) {
+        my $class = {};
+        # Get all classifications with at least one product.
+        foreach my $product (@$products) {
+            $class->{$product->classification_id}->{'object'} ||=
+                new Bugzilla::Classification($product->classification_id);
+            # Nice way to group products per classification, without querying
+            # the DB again.
+            push(@{$class->{$product->classification_id}->{'products'}}, $product);
+        }
+        $list = [sort {$a->{'object'}->sortkey <=> $b->{'object'}->sortkey
+                       || lc($a->{'object'}->name) cmp lc($b->{'object'}->name)}
+                      (values %$class)];
+    }
+    else {
+        $list = [{object => undef, products => $products}];
+    }
+    return $list;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Classification - Bugzilla classification class.
+
+=head1 SYNOPSIS
+
+    use Bugzilla::Classification;
+
+    my $classification = new Bugzilla::Classification(1);
+    my $classification = new Bugzilla::Classification({name => 'Acme'});
+
+    my $id = $classification->id;
+    my $name = $classification->name;
+    my $description = $classification->description;
+    my $sortkey = $classification->sortkey;
+    my $product_count = $classification->product_count;
+    my $products = $classification->products;
+
+=head1 DESCRIPTION
+
+Classification.pm represents a classification object. It is an
+implementation of L<Bugzilla::Object>, and thus provides all methods
+that L<Bugzilla::Object> provides.
+
+The methods that are specific to C<Bugzilla::Classification> are listed
+below.
+
+A Classification is a higher-level grouping of Products.
+
+=head1 METHODS
+
+=over
+
+=item C<product_count()>
+
+ Description: Returns the total number of products that belong to
+              the classification.
+
+ Params:      none.
+
+ Returns:     Integer - The total of products inside the classification.
+
+=item C<products>
+
+ Description: Returns all products of the classification.
+
+ Params:      none.
+
+ Returns:     A reference to an array of Bugzilla::Product objects.
+
+=back
+
+=head1 SUBROUTINES
+
+=over
+
+=item C<sort_products_by_classification>
+
+ Description: This is a helper which returns a list of products sorted
+              by classification in a form suitable to be passed to the
+              global/choose-product.html.tmpl template.
+
+ Params:      An arrayref of product objects.
+
+ Returns:     An arrayref of hashes suitable to be passed to
+              global/choose-product.html.tmpl.
+
+=back
+
+=cut

diff --git a/Bugzilla/Comment.pm b/Bugzilla/Comment.pm
new file mode 100644 (file)
index 0000000..30ec1cb
--- /dev/null
+++ b/Bugzilla/Comment.pm
@@ -0,0 +1,419 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+package Bugzilla::Comment;
+
+use base qw(Bugzilla::Object);
+
+use Bugzilla::Attachment;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::User;
+use Bugzilla::Util;
+
+use Scalar::Util qw(blessed);
+
+###############################
+####    Initialization     ####
+###############################
+
+# Creation and updating of comments are audited in longdescs
+# and bugs_activity respectively instead of audit_log.
+use constant AUDIT_CREATES => 0;
+use constant AUDIT_UPDATES => 0;
+
+use constant DB_COLUMNS => qw(
+    comment_id
+    bug_id
+    who
+    bug_when
+    work_time
+    thetext
+    isprivate
+    already_wrapped
+    type
+    extra_data
+);
+
+use constant UPDATE_COLUMNS => qw(
+    isprivate
+    type
+    extra_data
+);
+
+use constant DB_TABLE => 'longdescs';
+use constant ID_FIELD => 'comment_id';
+# In some rare cases, two comments can have identical timestamps. If
+# this happens, we want to be sure that the comment added later shows up
+# later in the sequence.
+use constant LIST_ORDER => 'bug_when, comment_id';
+
+use constant VALIDATORS => {
+    bug_id      => \&_check_bug_id,
+    who         => \&_check_who,
+    bug_when    => \&_check_bug_when,
+    work_time   => \&_check_work_time,
+    thetext     => \&_check_thetext,
+    isprivate   => \&_check_isprivate,
+    extra_data  => \&_check_extra_data,
+    type        => \&_check_type,
+};
+
+use constant VALIDATOR_DEPENDENCIES => {
+    extra_data => ['type'],
+    bug_id     => ['who'],
+    work_time  => ['who', 'bug_id'],
+    isprivate  => ['who'],
+};
+
+#########################
+# Database Manipulation #
+#########################
+
+sub update {
+    my $self = shift;
+    my $changes = $self->SUPER::update(@_);
+    $self->bug->_sync_fulltext( update_comments => 1);
+    return $changes;
+}
+
+# Speeds up displays of comment lists by loading all ->author objects
+# at once for a whole list.
+sub preload {
+    my ($class, $comments) = @_;
+    my %user_ids = map { $_->{who} => 1 } @$comments;
+    my $users = Bugzilla::User->new_from_list([keys %user_ids]);
+    my %user_map = map { $_->id => $_ } @$users;
+    foreach my $comment (@$comments) {
+        $comment->{author} = $user_map{$comment->{who}};
+    }
+}
+
+###############################
+####      Accessors      ######
+###############################
+
+sub already_wrapped { return $_[0]->{'already_wrapped'}; }
+sub body        { return $_[0]->{'thetext'};   }
+sub bug_id      { return $_[0]->{'bug_id'};    }
+sub creation_ts { return $_[0]->{'bug_when'};  }
+sub is_private  { return $_[0]->{'isprivate'}; }
+sub work_time   {
+    # Work time is returned as a string (see bug 607909)
+    return 0 if $_[0]->{'work_time'} + 0 == 0;
+    return $_[0]->{'work_time'};
+}
+sub type        { return $_[0]->{'type'};      }
+sub extra_data  { return $_[0]->{'extra_data'} }
+
+sub bug {
+    my $self = shift;
+    require Bugzilla::Bug;
+    $self->{bug} ||= new Bugzilla::Bug($self->bug_id);
+    return $self->{bug};
+}
+
+sub is_about_attachment {
+    my ($self) = @_;
+    return 1 if ($self->type == CMT_ATTACHMENT_CREATED
+                 or $self->type == CMT_ATTACHMENT_UPDATED);
+    return 0;
+}
+
+sub attachment {
+    my ($self) = @_;
+    return undef if not $self->is_about_attachment;
+    $self->{attachment} ||= new Bugzilla::Attachment($self->extra_data);
+    return $self->{attachment};
+}
+
+sub author { 
+    my $self = shift;
+    $self->{'author'} ||= new Bugzilla::User($self->{'who'});
+    return $self->{'author'};
+}
+
+sub body_full {
+    my ($self, $params) = @_;
+    $params ||= {};
+    my $template = Bugzilla->template_inner;
+    my $body;
+    if ($self->type) {
+        $template->process("bug/format_comment.txt.tmpl", 
+                           { comment => $self, %$params }, \$body)
+            || ThrowTemplateError($template->error());
+        $body =~ s/^X//;
+    }
+    else {
+        $body = $self->body;
+    }
+    if ($params->{wrap} and !$self->already_wrapped) {
+        $body = wrap_comment($body);
+    }
+    return $body;
+}
+
+############
+# Mutators #
+############
+
+sub set_is_private  { $_[0]->set('isprivate',  $_[1]); }
+sub set_type        { $_[0]->set('type',       $_[1]); }
+sub set_extra_data  { $_[0]->set('extra_data', $_[1]); }
+
+##############
+# Validators #
+##############
+
+sub run_create_validators {
+    my $self = shift;
+    my $params = $self->SUPER::run_create_validators(@_);
+    # Sometimes this run_create_validators is called with parameters that
+    # skip bug_id validation, so it might not exist in the resulting hash.
+    if (defined $params->{bug_id}) {
+        $params->{bug_id} = $params->{bug_id}->id;
+    }
+    return $params;
+}
+
+sub _check_extra_data {
+    my ($invocant, $extra_data, undef, $params) = @_;
+    my $type = blessed($invocant) ? $invocant->type : $params->{type};
+
+    if ($type == CMT_NORMAL) {
+        if (defined $extra_data) {
+            ThrowCodeError('comment_extra_data_not_allowed',
+                           { type => $type, extra_data => $extra_data });
+        }
+    }
+    else {
+        if (!defined $extra_data) {
+            ThrowCodeError('comment_extra_data_required', { type => $type });
+        }
+        elsif ($type == CMT_ATTACHMENT_CREATED 
+               or $type == CMT_ATTACHMENT_UPDATED) 
+        {
+             my $attachment = Bugzilla::Attachment->check({ 
+                 id => $extra_data });
+             $extra_data = $attachment->id;
+        }
+        else {
+            my $original = $extra_data;
+            detaint_natural($extra_data) 
+              or ThrowCodeError('comment_extra_data_not_numeric',
+                                { type => $type, extra_data => $original });
+        }
+    }
+
+    return $extra_data;
+}
+
+sub _check_type {
+    my ($invocant, $type) = @_;
+    $type ||= CMT_NORMAL;
+    my $original = $type;
+    detaint_natural($type)
+        or ThrowCodeError('comment_type_invalid', { type => $original });
+    return $type;
+}
+
+sub _check_bug_id {
+    my ($invocant, $bug_id) = @_;
+
+    ThrowCodeError('param_required', {function => 'Bugzilla::Comment->create',
+                                      param => 'bug_id'}) unless $bug_id;
+
+    my $bug;
+    if (blessed $bug_id) {
+        # We got a bug object passed in, use it
+        $bug = $bug_id;
+        $bug->check_is_visible;
+    }
+    else {
+        # We got a bug id passed in, check it and get the bug object
+        $bug = Bugzilla::Bug->check({ id => $bug_id });
+    }
+
+    # Make sure the user can edit the product
+    Bugzilla->user->can_edit_product($bug->{product_id});
+
+    # Make sure the user can comment
+    my $privs;
+    $bug->check_can_change_field('longdesc', 0, 1, \$privs)
+        || ThrowUserError('illegal_change', 
+                          { field => 'longdesc', privs => $privs });
+    return $bug;
+}
+
+sub _check_who {
+    my ($invocant, $who) = @_;
+    Bugzilla->login(LOGIN_REQUIRED);
+    return Bugzilla->user->id;
+}
+
+sub _check_bug_when {
+    my ($invocant, $when) = @_;
+
+    # Make sure the timestamp is defined, default to a timestamp from the db
+    if (!defined $when) {
+        $when = Bugzilla->dbh->selectrow_array('SELECT LOCALTIMESTAMP(0)');
+    }
+
+    # Make sure the timestamp parses
+    if (!datetime_from($when)) {
+        ThrowCodeError('invalid_timestamp', { timestamp => $when });
+    }
+
+    return $when;
+}
+
+sub _check_work_time {
+    my ($invocant, $value_in, $field, $params) = @_;
+
+    # Call down to Bugzilla::Object, letting it know negative
+    # values are ok
+    my $time = $invocant->check_time($value_in, $field, $params, 1);
+    my $privs;
+    $params->{bug_id}->check_can_change_field('work_time', 0, $time, \$privs)
+        || ThrowUserError('illegal_change',
+                          { field => 'work_time', privs => $privs });
+    return $time;
+}
+
+sub _check_thetext {
+    my ($invocant, $thetext) = @_;
+
+    ThrowCodeError('param_required',{function => 'Bugzilla::Comment->create',
+                                     param => 'thetext'}) unless defined $thetext;
+
+    # Remove any trailing whitespace. Leading whitespace could be
+    # a valid part of the comment.
+    $thetext =~ s/\s*$//s;
+    $thetext =~ s/\r\n?/\n/g; # Get rid of \r.
+
+    ThrowUserError('comment_too_long') if length($thetext) > MAX_COMMENT_LENGTH;
+    return $thetext;
+}
+
+sub _check_isprivate {
+    my ($invocant, $isprivate) = @_;
+    if ($isprivate && !Bugzilla->user->is_insider) {
+        ThrowUserError('user_not_insider');
+    }
+    return $isprivate ? 1 : 0;
+}
+
+sub count {
+    my ($self) = @_;
+
+    return $self->{'count'} if defined $self->{'count'};
+
+    my $dbh = Bugzilla->dbh;
+    ($self->{'count'}) = $dbh->selectrow_array(
+        "SELECT COUNT(*)
+           FROM longdescs 
+          WHERE bug_id = ? 
+                AND bug_when <= ?",
+        undef, $self->bug_id, $self->creation_ts);
+
+    return --$self->{'count'};
+}   
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Comment - A Comment for a given bug 
+
+=head1 SYNOPSIS
+
+ use Bugzilla::Comment;
+
+ my $comment = Bugzilla::Comment->new($comment_id);
+ my $comments = Bugzilla::Comment->new_from_list($comment_ids);
+
+=head1 DESCRIPTION
+
+Bugzilla::Comment represents a comment attached to a bug.
+
+This implements all standard C<Bugzilla::Object> methods. See 
+L<Bugzilla::Object> for more details.
+
+=head2 Accessors
+
+=over
+
+=item C<bug_id>
+
+C<int> The ID of the bug to which the comment belongs.
+
+=item C<creation_ts>
+
+C<string> The comment creation timestamp.
+
+=item C<body>
+
+C<string> The body without any special additional text.
+
+=item C<work_time>
+
+C<string> Time spent as related to this comment.
+
+=item C<is_private>
+
+C<boolean> Comment is marked as private
+
+=item C<already_wrapped>
+
+If this comment is stored in the database word-wrapped, this will be C<1>.
+C<0> otherwise.
+
+=item C<author>
+
+L<Bugzilla::User> who created the comment.
+
+=item C<count>
+
+C<int> The position this comment is located in the full list of comments for a bug starting from 0.
+
+=item C<body_full>
+
+=over
+
+=item B<Description>
+
+C<string> Body of the comment, including any special text (such as
+"this bug was marked as a duplicate of...").
+
+=item B<Params>
+
+=over
+
+=item C<is_bugmail>
+
+C<boolean>. C<1> if this comment should be formatted specifically for
+bugmail.
+
+=item C<wrap>
+
+C<boolean>. C<1> if the comment should be returned word-wrapped.
+
+=back
+
+=item B<Returns>
+
+A string, the full text of the comment as it would be displayed to an end-user.
+
+=back
+
+=back
+
+=cut

diff --git a/Bugzilla/Component.pm b/Bugzilla/Component.pm
new file mode 100644 (file)
index 0000000..eb8341d
--- /dev/null
+++ b/Bugzilla/Component.pm
@@ -0,0 +1,652 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Component;
+use strict;
+use base qw(Bugzilla::Field::ChoiceInterface Bugzilla::Object);
+
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::User;
+use Bugzilla::FlagType;
+use Bugzilla::Series;
+
+use Scalar::Util qw(blessed);
+
+###############################
+####    Initialization     ####
+###############################
+
+use constant DB_TABLE => 'components';
+# This is mostly for the editfields.cgi case where ->get_all is called.
+use constant LIST_ORDER => 'product_id, name';
+
+use constant DB_COLUMNS => qw(
+    id
+    name
+    product_id
+    initialowner
+    initialqacontact
+    description
+    isactive
+);
+
+use constant UPDATE_COLUMNS => qw(
+    name
+    initialowner
+    initialqacontact
+    description
+    isactive
+);
+
+use constant REQUIRED_FIELD_MAP => {
+    product_id => 'product',
+};
+
+use constant VALIDATORS => {
+    create_series    => \&Bugzilla::Object::check_boolean,
+    product          => \&_check_product,
+    initialowner     => \&_check_initialowner,
+    initialqacontact => \&_check_initialqacontact,
+    description      => \&_check_description,
+    initial_cc       => \&_check_cc_list,
+    name             => \&_check_name,
+    isactive         => \&Bugzilla::Object::check_boolean,
+};
+
+use constant VALIDATOR_DEPENDENCIES => {
+    name => ['product'],
+};
+
+###############################
+
+sub new {
+    my $class = shift;
+    my $param = shift;
+    my $dbh = Bugzilla->dbh;
+
+    my $product;
+    if (ref $param and !defined $param->{id}) {
+        $product = $param->{product};
+        my $name = $param->{name};
+        if (!defined $product) {
+            ThrowCodeError('bad_arg',
+                {argument => 'product',
+                 function => "${class}::new"});
+        }
+        if (!defined $name) {
+            ThrowCodeError('bad_arg',
+                {argument => 'name',
+                 function => "${class}::new"});
+        }
+
+        my $condition = 'product_id = ? AND name = ?';
+        my @values = ($product->id, $name);
+        $param = { condition => $condition, values => \@values };
+    }
+
+    unshift @_, $param;
+    my $component = $class->SUPER::new(@_);
+    # Add the product object as attribute only if the component exists.
+    $component->{product} = $product if ($component && $product);
+    return $component;
+}
+
+sub create {
+    my $class = shift;
+    my $dbh = Bugzilla->dbh;
+
+    $dbh->bz_start_transaction();
+
+    $class->check_required_create_fields(@_);
+    my $params = $class->run_create_validators(@_);
+    my $cc_list = delete $params->{initial_cc};
+    my $create_series = delete $params->{create_series};
+    my $product = delete $params->{product};
+    $params->{product_id} = $product->id;
+
+    my $component = $class->insert_create_data($params);
+    $component->{product} = $product;
+
+    # We still have to fill the component_cc table.
+    $component->_update_cc_list($cc_list) if $cc_list;
+
+    # Create series for the new component.
+    $component->_create_series() if $create_series;
+
+    $dbh->bz_commit_transaction();
+    return $component;
+}
+
+sub update {
+    my $self = shift;
+    my $changes = $self->SUPER::update(@_);
+
+    # Update the component_cc table if necessary.
+    if (defined $self->{cc_ids}) {
+        my $diff = $self->_update_cc_list($self->{cc_ids});
+        $changes->{cc_list} = $diff if defined $diff;
+    }
+    return $changes;
+}
+
+sub remove_from_db {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    $self->_check_if_controller(); # From ChoiceInterface
+
+    $dbh->bz_start_transaction();
+
+    # Products must have at least one component.
+    if (scalar(@{$self->product->components}) == 1) {
+        ThrowUserError('component_is_last', { comp => $self });
+    }
+
+    if ($self->bug_count) {
+        if (Bugzilla->params->{'allowbugdeletion'}) {
+            require Bugzilla::Bug;
+            foreach my $bug_id (@{$self->bug_ids}) {
+                # Note: We allow admins to delete bugs even if they can't
+                # see them, as long as they can see the product.
+                my $bug = new Bugzilla::Bug($bug_id);
+                $bug->remove_from_db();
+            }
+        } else {
+            ThrowUserError('component_has_bugs', {nb => $self->bug_count});
+        }
+    }
+    $self->SUPER::remove_from_db();
+
+    $dbh->bz_commit_transaction();
+}
+
+################################
+# Validators
+################################
+
+sub _check_name {
+    my ($invocant, $name, undef, $params) = @_;
+    my $product = blessed($invocant) ? $invocant->product : $params->{product};
+
+    $name = trim($name);
+    $name || ThrowUserError('component_blank_name');
+
+    if (length($name) > MAX_COMPONENT_SIZE) {
+        ThrowUserError('component_name_too_long', {'name' => $name});
+    }
+
+    my $component = new Bugzilla::Component({product => $product, name => $name});
+    if ($component && (!ref $invocant || $component->id != $invocant->id)) {
+        ThrowUserError('component_already_exists', { name    => $component->name,
+                                                     product => $product });
+    }
+    return $name;
+}
+
+sub _check_description {
+    my ($invocant, $description) = @_;
+
+    $description = trim($description);
+    $description || ThrowUserError('component_blank_description');
+    return $description;
+}
+
+sub _check_initialowner {
+    my ($invocant, $owner) = @_;
+
+    $owner || ThrowUserError('component_need_initialowner');
+    my $owner_id = Bugzilla::User->check($owner)->id;
+    return $owner_id;
+}
+
+sub _check_initialqacontact {
+    my ($invocant, $qa_contact) = @_;
+
+    my $qa_contact_id;
+    if (Bugzilla->params->{'useqacontact'}) {
+        $qa_contact_id = Bugzilla::User->check($qa_contact)->id if $qa_contact;
+    }
+    elsif (ref $invocant) {
+        $qa_contact_id = $invocant->{initialqacontact};
+    }
+    return $qa_contact_id;
+}
+
+sub _check_product {
+    my ($invocant, $product) = @_;
+    $product || ThrowCodeError('param_required', 
+                    { function => "$invocant->create", param => 'product' });
+    return Bugzilla->user->check_can_admin_product($product->name);
+}
+
+sub _check_cc_list {
+    my ($invocant, $cc_list) = @_;
+
+    my %cc_ids;
+    foreach my $cc (@$cc_list) {
+        my $id = login_to_id($cc, THROW_ERROR);
+        $cc_ids{$id} = 1;
+    }
+    return [keys %cc_ids];
+}
+
+###############################
+####       Methods         ####
+###############################
+
+sub _update_cc_list {
+    my ($self, $cc_list) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    my $old_cc_list =
+      $dbh->selectcol_arrayref('SELECT user_id FROM component_cc
+                                WHERE component_id = ?', undef, $self->id);
+
+    my ($removed, $added) = diff_arrays($old_cc_list, $cc_list);
+    my $diff;
+    if (scalar @$removed || scalar @$added) {
+        $diff = [join(', ', @$removed), join(', ', @$added)];
+    }
+
+    $dbh->do('DELETE FROM component_cc WHERE component_id = ?', undef, $self->id);
+
+    my $sth = $dbh->prepare('INSERT INTO component_cc
+                             (user_id, component_id) VALUES (?, ?)');
+    $sth->execute($_, $self->id) foreach (@$cc_list);
+
+    return $diff;
+}
+
+sub _create_series {
+    my $self = shift;
+
+    # Insert default charting queries for this product.
+    # If they aren't using charting, this won't do any harm.
+    my $prodcomp = "&product="   . url_quote($self->product->name) .
+                   "&component=" . url_quote($self->name);
+
+    my $open_query = 'field0-0-0=resolution&type0-0-0=notregexp&value0-0-0=.' .
+                     $prodcomp;
+    my $nonopen_query = 'field0-0-0=resolution&type0-0-0=regexp&value0-0-0=.' .
+                        $prodcomp;
+
+    my @series = ([get_text('series_all_open'), $open_query],
+                  [get_text('series_all_closed'), $nonopen_query]);
+
+    foreach my $sdata (@series) {
+        my $series = new Bugzilla::Series(undef, $self->product->name,
+                                          $self->name, $sdata->[0],
+                                          Bugzilla->user->id, 1, $sdata->[1], 1);
+        $series->writeToDatabase();
+    }
+}
+
+sub set_name { $_[0]->set('name', $_[1]); }
+sub set_description { $_[0]->set('description', $_[1]); }
+sub set_is_active { $_[0]->set('isactive', $_[1]); }
+sub set_default_assignee {
+    my ($self, $owner) = @_;
+
+    $self->set('initialowner', $owner);
+    # Reset the default owner object.
+    delete $self->{default_assignee};
+}
+sub set_default_qa_contact {
+    my ($self, $qa_contact) = @_;
+
+    $self->set('initialqacontact', $qa_contact);
+    # Reset the default QA contact object.
+    delete $self->{default_qa_contact};
+}
+sub set_cc_list {
+    my ($self, $cc_list) = @_;
+
+    $self->{cc_ids} = $self->_check_cc_list($cc_list);
+    # Reset the list of CC user objects.
+    delete $self->{initial_cc};
+}
+
+sub bug_count {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    if (!defined $self->{'bug_count'}) {
+        $self->{'bug_count'} = $dbh->selectrow_array(q{
+            SELECT COUNT(*) FROM bugs
+            WHERE component_id = ?}, undef, $self->id) || 0;
+    }
+    return $self->{'bug_count'};
+}
+
+sub bug_ids {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    if (!defined $self->{'bugs_ids'}) {
+        $self->{'bugs_ids'} = $dbh->selectcol_arrayref(q{
+            SELECT bug_id FROM bugs
+            WHERE component_id = ?}, undef, $self->id);
+    }
+    return $self->{'bugs_ids'};
+}
+
+sub default_assignee {
+    my $self = shift;
+
+    if (!defined $self->{'default_assignee'}) {
+        $self->{'default_assignee'} =
+            new Bugzilla::User($self->{'initialowner'});
+    }
+    return $self->{'default_assignee'};
+}
+
+sub default_qa_contact {
+    my $self = shift;
+
+    return if !$self->{'initialqacontact'};
+
+    if (!defined $self->{'default_qa_contact'}) {
+        $self->{'default_qa_contact'} =
+            new Bugzilla::User($self->{'initialqacontact'});
+    }
+    return $self->{'default_qa_contact'};
+}
+
+sub flag_types {
+    my $self = shift;
+
+    if (!defined $self->{'flag_types'}) {
+        my $flagtypes = Bugzilla::FlagType::match({ product_id   => $self->product_id,
+                                                    component_id => $self->id });
+
+        $self->{'flag_types'} = {};
+        $self->{'flag_types'}->{'bug'} =
+          [grep { $_->target_type eq 'bug' } @$flagtypes];
+        $self->{'flag_types'}->{'attachment'} =
+          [grep { $_->target_type eq 'attachment' } @$flagtypes];
+    }
+    return $self->{'flag_types'};
+}
+
+sub initial_cc {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    if (!defined $self->{'initial_cc'}) {
+        # If set_cc_list() has been called but data are not yet written
+        # into the DB, we want the new values defined by it.
+        my $cc_ids = $self->{cc_ids}
+                     || $dbh->selectcol_arrayref('SELECT user_id FROM component_cc
+                                                  WHERE component_id = ?',
+                                                  undef, $self->id);
+
+        $self->{'initial_cc'} = Bugzilla::User->new_from_list($cc_ids);
+    }
+    return $self->{'initial_cc'};
+}
+
+sub product {
+    my $self = shift;
+    if (!defined $self->{'product'}) {
+        require Bugzilla::Product; # We cannot |use| it.
+        $self->{'product'} = new Bugzilla::Product($self->product_id);
+    }
+    return $self->{'product'};
+}
+
+###############################
+####      Accessors        ####
+###############################
+
+sub description { return $_[0]->{'description'}; }
+sub product_id  { return $_[0]->{'product_id'};  }
+sub is_active   { return $_[0]->{'isactive'};    }
+
+##############################################
+# Implement Bugzilla::Field::ChoiceInterface #
+##############################################
+
+use constant FIELD_NAME => 'component';
+use constant is_default => 0;
+
+sub is_set_on_bug {
+    my ($self, $bug) = @_;
+    # We treat it like a hash always, so that we don't have to check if it's
+    # a hash or an object.
+    return 0 if !defined $bug->{component_id};
+    $bug->{component_id} == $self->id ? 1 : 0;
+}
+
+###############################
+####      Subroutines      ####
+###############################
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Component - Bugzilla product component class.
+
+=head1 SYNOPSIS
+
+    use Bugzilla::Component;
+
+    my $component = new Bugzilla::Component($comp_id);
+    my $component = new Bugzilla::Component({ product => $product, name => $name });
+
+    my $bug_count          = $component->bug_count();
+    my $bug_ids            = $component->bug_ids();
+    my $id                 = $component->id;
+    my $name               = $component->name;
+    my $description        = $component->description;
+    my $product_id         = $component->product_id;
+    my $default_assignee   = $component->default_assignee;
+    my $default_qa_contact = $component->default_qa_contact;
+    my $initial_cc         = $component->initial_cc;
+    my $product            = $component->product;
+    my $bug_flag_types     = $component->flag_types->{'bug'};
+    my $attach_flag_types  = $component->flag_types->{'attachment'};
+
+    my $component = Bugzilla::Component->check({ product => $product, name => $name });
+
+    my $component =
+      Bugzilla::Component->create({ name             => $name,
+                                    product          => $product,
+                                    initialowner     => $user_login1,
+                                    initialqacontact => $user_login2,
+                                    description      => $description});
+
+    $component->set_name($new_name);
+    $component->set_description($new_description);
+    $component->set_default_assignee($new_login_name);
+    $component->set_default_qa_contact($new_login_name);
+    $component->set_cc_list(\@new_login_names);
+    $component->update();
+
+    $component->remove_from_db;
+
+=head1 DESCRIPTION
+
+Component.pm represents a Product Component object.
+
+=head1 METHODS
+
+=over
+
+=item C<new($param)>
+
+ Description: The constructor is used to load an existing component
+              by passing a component ID or a hash with the product
+              object the component belongs to and the component name.
+
+ Params:      $param - If you pass an integer, the integer is the
+                       component ID from the database that we want to
+                       read in. 
+                       However, If you pass in a hash, it must contain
+                       two keys:
+                       name (string): the name of the component
+                       product (object): an object of Bugzilla::Product
+                       representing the product that the component belongs to.
+
+ Returns:     A Bugzilla::Component object.
+
+=item C<bug_count()>
+
+ Description: Returns the total of bugs that belong to the component.
+
+ Params:      none.
+
+ Returns:     Integer with the number of bugs.
+
+=item C<bugs_ids()>
+
+ Description: Returns all bug IDs that belong to the component.
+
+ Params:      none.
+
+ Returns:     A reference to an array of bug IDs.
+
+=item C<default_assignee()>
+
+ Description: Returns a user object that represents the default assignee for
+              the component.
+
+ Params:      none.
+
+ Returns:     A Bugzilla::User object.
+
+=item C<default_qa_contact()>
+
+ Description: Returns a user object that represents the default QA contact for
+              the component.
+
+ Params:      none.
+
+ Returns:     A Bugzilla::User object if the default QA contact is defined for
+              the component. Otherwise, returns undef.
+
+=item C<initial_cc>
+
+ Description: Returns a list of user objects representing users being
+              in the initial CC list.
+
+ Params:      none.
+
+ Returns:     An arrayref of L<Bugzilla::User> objects.
+
+=item C<flag_types()>
+
+ Description: Returns all bug and attachment flagtypes available for
+              the component.
+
+ Params:      none.
+
+ Returns:     Two references to an array of flagtype objects.
+
+=item C<product()>
+
+ Description: Returns the product the component belongs to.
+
+ Params:      none.
+
+ Returns:     A Bugzilla::Product object.
+
+=item C<set_name($new_name)>
+
+ Description: Changes the name of the component.
+
+ Params:      $new_name - new name of the component (string). This name
+                          must be unique within the product.
+
+ Returns:     Nothing.
+
+=item C<set_description($new_desc)>
+
+ Description: Changes the description of the component.
+
+ Params:      $new_desc - new description of the component (string).
+
+ Returns:     Nothing.
+
+=item C<set_default_assignee($new_assignee)>
+
+ Description: Changes the default assignee of the component.
+
+ Params:      $new_owner - login name of the new default assignee of
+                           the component (string). This user account
+                           must already exist.
+
+ Returns:     Nothing.
+
+=item C<set_default_qa_contact($new_qa_contact)>
+
+ Description: Changes the default QA contact of the component.
+
+ Params:      $new_qa_contact - login name of the new QA contact of
+                                the component (string). This user
+                                account must already exist.
+
+ Returns:     Nothing.
+
+=item C<set_cc_list(\@cc_list)>
+
+ Description: Changes the list of users being in the CC list by default.
+
+ Params:      \@cc_list - list of login names (string). All the user
+                          accounts must already exist.
+
+ Returns:     Nothing.
+
+=item C<update()>
+
+ Description: Write changes made to the component into the DB.
+
+ Params:      none.
+
+ Returns:     A hashref with changes made to the component object.
+
+=item C<remove_from_db()>
+
+ Description: Deletes the current component from the DB. The object itself
+              is not destroyed.
+
+ Params:      none.
+
+ Returns:     Nothing.
+
+=back
+
+=head1 CLASS METHODS
+
+=over
+
+=item C<create(\%params)>
+
+ Description: Create a new component for the given product.
+
+ Params:      The hashref must have the following keys:
+              name             - name of the new component (string). This name
+                                 must be unique within the product.
+              product          - a Bugzilla::Product object to which
+                                 the Component is being added.
+              description      - description of the new component (string).
+              initialowner     - login name of the default assignee (string).
+              The following keys are optional:
+              initialqacontact - login name of the default QA contact (string),
+                                 or an empty string to clear it.
+              initial_cc       - an arrayref of login names to add to the
+                                 CC list by default.
+
+ Returns:     A Bugzilla::Component object.
+
+=back
+
+=cut

diff --git a/Bugzilla/Config.pm b/Bugzilla/Config.pm
new file mode 100644 (file)
index 0000000..150996e
--- /dev/null
+++ b/Bugzilla/Config.pm
@@ -0,0 +1,385 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Config;
+
+use strict;
+
+use base qw(Exporter);
+use Bugzilla::Constants;
+use Bugzilla::Hook;
+use Bugzilla::Install::Filesystem qw(fix_file_permissions);
+use Data::Dumper;
+use File::Temp;
+
+# Don't export localvars by default - people should have to explicitly
+# ask for it, as a (probably futile) attempt to stop code using it
+# when it shouldn't
+%Bugzilla::Config::EXPORT_TAGS =
+  (
+   admin => [qw(update_params SetParam write_params)],
+  );
+Exporter::export_ok_tags('admin');
+
+# INITIALISATION CODE
+# Perl throws a warning if we use bz_locations() directly after do.
+our %params;
+# Load in the param definitions
+sub _load_params {
+    my $panels = param_panels();
+    my %hook_panels;
+    foreach my $panel (keys %$panels) {
+        my $module = $panels->{$panel};
+        eval("require $module") || die $@;
+        my @new_param_list = $module->get_param_list();
+        $hook_panels{lc($panel)} = { params => \@new_param_list };
+    }
+    # This hook is also called in editparams.cgi. This call here is required
+    # to make SetParam work.
+    Bugzilla::Hook::process('config_modify_panels', 
+                            { panels => \%hook_panels });
+
+    foreach my $panel (keys %hook_panels) {
+        foreach my $item (@{$hook_panels{$panel}->{params}}) {
+            $params{$item->{'name'}} = $item;
+        }
+    }
+}
+# END INIT CODE
+
+# Subroutines go here
+
+sub param_panels {
+    my $param_panels = {};
+    my $libpath = bz_locations()->{'libpath'};
+    foreach my $item ((glob "$libpath/Bugzilla/Config/*.pm")) {
+        $item =~ m#/([^/]+)\.pm$#;
+        my $module = $1;
+        $param_panels->{$module} = "Bugzilla::Config::$module" unless $module eq 'Common';
+    }
+    # Now check for any hooked params
+    Bugzilla::Hook::process('config_add_panels', 
+                            { panel_modules => $param_panels });
+    return $param_panels;
+}
+
+sub SetParam {
+    my ($name, $value) = @_;
+
+    _load_params unless %params;
+    die "Unknown param $name" unless (exists $params{$name});
+
+    my $entry = $params{$name};
+
+    # sanity check the value
+
+    # XXX - This runs the checks. Which would be good, except that
+    # check_shadowdb creates the database as a side effect, and so the
+    # checker fails the second time around...
+    if ($name ne 'shadowdb' && exists $entry->{'checker'}) {
+        my $err = $entry->{'checker'}->($value, $entry);
+        die "Param $name is not valid: $err" unless $err eq '';
+    }
+
+    Bugzilla->params->{$name} = $value;
+}
+
+sub update_params {
+    my ($params) = @_;
+    my $answer = Bugzilla->installation_answers;
+
+    my $param = read_param_file();
+    my %new_params;
+
+    # If we didn't return any param values, then this is a new installation.
+    my $new_install = !(keys %$param);
+
+    # --- UPDATE OLD PARAMS ---
+
+    # Change from usebrowserinfo to defaultplatform/defaultopsys combo
+    if (exists $param->{'usebrowserinfo'}) {
+        if (!$param->{'usebrowserinfo'}) {
+            if (!exists $param->{'defaultplatform'}) {
+                $new_params{'defaultplatform'} = 'Other';
+            }
+            if (!exists $param->{'defaultopsys'}) {
+                $new_params{'defaultopsys'} = 'Other';
+            }
+        }
+    }
+
+    # Change from a boolean for quips to multi-state
+    if (exists $param->{'usequip'} && !exists $param->{'enablequips'}) {
+        $new_params{'enablequips'} = $param->{'usequip'} ? 'on' : 'off';
+    }
+
+    # Change from old product groups to controls for group_control_map
+    # 2002-10-14 bug 147275 bugreport@peshkin.net
+    if (exists $param->{'usebuggroups'} && 
+        !exists $param->{'makeproductgroups'}) 
+    {
+        $new_params{'makeproductgroups'} = $param->{'usebuggroups'};
+    }
+
+    # Modularise auth code
+    if (exists $param->{'useLDAP'} && !exists $param->{'loginmethod'}) {
+        $new_params{'loginmethod'} = $param->{'useLDAP'} ? "LDAP" : "DB";
+    }
+
+    # set verify method to whatever loginmethod was
+    if (exists $param->{'loginmethod'} 
+        && !exists $param->{'user_verify_class'}) 
+    {
+        $new_params{'user_verify_class'} = $param->{'loginmethod'};
+    }
+
+    # Remove quip-display control from parameters
+    # and give it to users via User Settings (Bug 41972)
+    if ( exists $param->{'enablequips'} 
+         && !exists $param->{'quip_list_entry_control'}) 
+    {
+        my $new_value;
+        ($param->{'enablequips'} eq 'on')       && do {$new_value = 'open';};
+        ($param->{'enablequips'} eq 'approved') && do {$new_value = 'moderated';};
+        ($param->{'enablequips'} eq 'frozen')   && do {$new_value = 'closed';};
+        ($param->{'enablequips'} eq 'off')      && do {$new_value = 'closed';};
+        $new_params{'quip_list_entry_control'} = $new_value;
+    }
+
+    # Old mail_delivery_method choices contained no uppercase characters
+    if (exists $param->{'mail_delivery_method'}
+        && $param->{'mail_delivery_method'} !~ /[A-Z]/) {
+        my $method = $param->{'mail_delivery_method'};
+        my %translation = (
+            'sendmail' => 'Sendmail',
+            'smtp'     => 'SMTP',
+            'qmail'    => 'Qmail',
+            'testfile' => 'Test',
+            'none'     => 'None');
+        $param->{'mail_delivery_method'} = $translation{$method};
+    }
+
+    # Convert the old "ssl" parameter to the new "ssl_redirect" parameter.
+    # Both "authenticated sessions" and "always" turn on "ssl_redirect"
+    # when upgrading.
+    if (exists $param->{'ssl'} and $param->{'ssl'} ne 'never') {
+        $new_params{'ssl_redirect'} = 1;
+    }
+
+    # "specific_search_allow_empty_words" has been renamed to "search_allow_no_criteria".
+    if (exists $param->{'specific_search_allow_empty_words'}) {
+        $new_params{'search_allow_no_criteria'} = $param->{'specific_search_allow_empty_words'};
+    }
+
+    # --- DEFAULTS FOR NEW PARAMS ---
+
+    _load_params unless %params;
+    foreach my $name (keys %params) {
+        my $item = $params{$name};
+        unless (exists $param->{$name}) {
+            print "New parameter: $name\n" unless $new_install;
+            if (exists $new_params{$name}) {
+                $param->{$name} = $new_params{$name};
+            }
+            elsif (exists $answer->{$name}) {
+                $param->{$name} = $answer->{$name};
+            }
+            else {
+                $param->{$name} = $item->{'default'};
+            }
+        }
+    }
+
+    $param->{'utf8'} = 1 if $new_install;
+
+    # --- REMOVE OLD PARAMS ---
+
+    my %oldparams;
+    # Remove any old params
+    foreach my $item (keys %$param) {
+        if (!exists $params{$item}) {
+            $oldparams{$item} = delete $param->{$item};
+        }
+    }
+
+    # Write any old parameters to old-params.txt
+    my $datadir = bz_locations()->{'datadir'};
+    my $old_param_file = "$datadir/old-params.txt";
+    if (scalar(keys %oldparams)) {
+        my $op_file = new IO::File($old_param_file, '>>', 0600)
+          || die "Couldn't create $old_param_file: $!";
+
+        print "The following parameters are no longer used in Bugzilla,",
+              " and so have been\nmoved from your parameters file into",
+              " $old_param_file:\n";
+
+        local $Data::Dumper::Terse  = 1;
+        local $Data::Dumper::Indent = 0;
+
+        my $comma = "";
+        foreach my $item (keys %oldparams) {
+            print $op_file "\n\n$item:\n" . Data::Dumper->Dump([$oldparams{$item}]) . "\n";
+            print "${comma}$item";
+            $comma = ", ";
+        }
+        print "\n";
+        $op_file->close;
+    }
+
+    if (ON_WINDOWS && !-e SENDMAIL_EXE
+        && $param->{'mail_delivery_method'} eq 'Sendmail')
+    {
+        my $smtp = $answer->{'SMTP_SERVER'};
+        if (!$smtp) {
+            print "\nBugzilla requires an SMTP server to function on",
+                  " Windows.\nPlease enter your SMTP server's hostname: ";
+            $smtp = <STDIN>;
+            chomp $smtp;
+            if ($smtp) {
+                $param->{'smtpserver'} = $smtp;
+             }
+             else {
+                print "\nWarning: No SMTP Server provided, defaulting to",
+                      " localhost\n";
+            }
+        }
+
+        $param->{'mail_delivery_method'} = 'SMTP';
+    }
+
+    write_params($param);
+
+    # Return deleted params and values so that checksetup.pl has a chance
+    # to convert old params to new data.
+    return %oldparams;
+}
+
+sub write_params {
+    my ($param_data) = @_;
+    $param_data ||= Bugzilla->params;
+
+    my $datadir    = bz_locations()->{'datadir'};
+    my $param_file = "$datadir/params";
+
+    local $Data::Dumper::Sortkeys = 1;
+
+    my ($fh, $tmpname) = File::Temp::tempfile('params.XXXXX',
+                                              DIR => $datadir );
+
+    print $fh (Data::Dumper->Dump([$param_data], ['*param']))
+      || die "Can't write param file: $!";
+
+    close $fh;
+
+    rename $tmpname, $param_file
+      or die "Can't rename $tmpname to $param_file: $!";
+
+    fix_file_permissions($param_file);
+
+    # And now we have to reset the params cache so that Bugzilla will re-read
+    # them.
+    delete Bugzilla->request_cache->{params};
+}
+
+sub read_param_file {
+    my %params;
+    my $datadir = bz_locations()->{'datadir'};
+    if (-e "$datadir/params") {
+        # Note that checksetup.pl sets file permissions on '$datadir/params'
+
+        # Using Safe mode is _not_ a guarantee of safety if someone does
+        # manage to write to the file. However, it won't hurt...
+        # See bug 165144 for not needing to eval this at all
+        my $s = new Safe;
+
+        $s->rdo("$datadir/params");
+        die "Error reading $datadir/params: $!" if $!;
+        die "Error evaluating $datadir/params: $@" if $@;
+
+        # Now read the param back out from the sandbox
+        %params = %{$s->varglob('param')};
+    }
+    elsif ($ENV{'SERVER_SOFTWARE'}) {
+       # We're in a CGI, but the params file doesn't exist. We can't
+       # Template Toolkit, or even install_string, since checksetup
+       # might not have thrown an error. Bugzilla::CGI->new
+       # hasn't even been called yet, so we manually use CGI::Carp here
+       # so that the user sees the error.
+       require CGI::Carp;
+       CGI::Carp->import('fatalsToBrowser');
+       die "The $datadir/params file does not exist."
+           . ' You probably need to run checksetup.pl.',
+    }
+    return \%params;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Config - Configuration parameters for Bugzilla
+
+=head1 SYNOPSIS
+
+  # Administration functions
+  use Bugzilla::Config qw(:admin);
+
+  update_params();
+  SetParam($param, $value);
+  write_params();
+
+=head1 DESCRIPTION
+
+This package contains ways to access Bugzilla configuration parameters.
+
+=head1 FUNCTIONS
+
+=head2 Parameters
+
+Parameters can be set, retrieved, and updated.
+
+=over 4
+
+=item C<SetParam($name, $value)>
+
+Sets the param named $name to $value. Values are checked using the checker
+function for the given param if one exists.
+
+=item C<update_params()>
+
+Updates the parameters, by transitioning old params to new formats, setting
+defaults for new params, and removing obsolete ones. Used by F<checksetup.pl>
+in the process of an installation or upgrade.
+
+Prints out information about what it's doing, if it makes any changes.
+
+May prompt the user for input, if certain required parameters are not
+specified.
+
+=item C<write_params($params)>
+
+Description: Writes the parameters to disk.
+
+Params:      C<$params> (optional) - A hashref to write to the disk
+               instead of C<Bugzilla->params>. Used only by
+               C<update_params>.
+
+Returns:     nothing
+
+=item C<read_param_file()>
+
+Description: Most callers should never need this. This is used
+             by C<Bugzilla->params> to directly read C<$datadir/params>
+             and load it into memory. Use C<Bugzilla->params> instead.
+
+Params:      none
+
+Returns:     A hashref containing the current params in C<$datadir/params>.
+
+=back

diff --git a/Bugzilla/Config/Admin.pm b/Bugzilla/Config/Admin.pm
new file mode 100644 (file)
index 0000000..7be3e54
--- /dev/null
+++ b/Bugzilla/Config/Admin.pm
@@ -0,0 +1,39 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Config::Admin;
+
+use strict;
+
+use Bugzilla::Config::Common;
+
+our $sortkey = 200;
+
+sub get_param_list {
+  my $class = shift;
+  my @param_list = (
+  {
+   name => 'allowbugdeletion',
+   type => 'b',
+   default => 0
+  },
+
+  {
+   name => 'allowemailchange',
+   type => 'b',
+   default => 1
+  },
+
+  {
+   name => 'allowuserdeletion',
+   type => 'b',
+   default => 0
+  });
+  return @param_list;
+}
+
+1;

diff --git a/Bugzilla/Config/Advanced.pm b/Bugzilla/Config/Advanced.pm
new file mode 100644 (file)
index 0000000..fa5b7d2
--- /dev/null
+++ b/Bugzilla/Config/Advanced.pm
@@ -0,0 +1,44 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Config::Advanced;
+use strict;
+
+use Bugzilla::Config::Common;
+
+our $sortkey = 1700;
+
+use constant get_param_list => (
+  {
+   name => 'cookiedomain',
+   type => 't',
+   default => ''
+  },
+
+  {
+   name => 'inbound_proxies',
+   type => 't',
+   default => '',
+   checker => \&check_ip
+  },
+
+  {
+   name => 'proxy_url',
+   type => 't',
+   default => ''
+  },
+
+  {
+   name => 'strict_transport_security',
+   type => 's',
+   choices => ['off', 'this_domain_only', 'include_subdomains'],
+   default => 'off',
+   checker => \&check_multi
+  },
+);
+
+1;

diff --git a/Bugzilla/Config/Attachment.pm b/Bugzilla/Config/Attachment.pm
new file mode 100644 (file)
index 0000000..ba19f77
--- /dev/null
+++ b/Bugzilla/Config/Attachment.pm
@@ -0,0 +1,62 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Config::Attachment;
+
+use strict;
+
+use Bugzilla::Config::Common;
+
+our $sortkey = 400;
+
+sub get_param_list {
+  my $class = shift;
+  my @param_list = (
+  {
+   name => 'allow_attachment_display',
+   type => 'b',
+   default => 0
+  },
+
+  {
+   name => 'attachment_base',
+   type => 't',
+   default => '',
+   checker => \&check_urlbase
+  },
+
+  {
+  name => 'allow_attachment_deletion',
+  type => 'b',
+  default => 0
+  },
+
+  {
+   name => 'maxattachmentsize',
+   type => 't',
+   default => '1000',
+   checker => \&check_maxattachmentsize
+  },
+
+  # The maximum size (in bytes) for patches and non-patch attachments.
+  # The default limit is 1000KB, which is 24KB less than mysql's default
+  # maximum packet size (which determines how much data can be sent in a
+  # single mysql packet and thus how much data can be inserted into the
+  # database) to provide breathing space for the data in other fields of
+  # the attachment record as well as any mysql packet overhead (I don't
+  # know of any, but I suspect there may be some.)
+
+  {
+   name => 'maxlocalattachment',
+   type => 't',
+   default => '0',
+   checker => \&check_numeric
+  } );
+  return @param_list;
+}
+
+1;

diff --git a/Bugzilla/Config/Auth.pm b/Bugzilla/Config/Auth.pm
new file mode 100644 (file)
index 0000000..19ba59b
--- /dev/null
+++ b/Bugzilla/Config/Auth.pm
@@ -0,0 +1,113 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Config::Auth;
+
+use strict;
+
+use Bugzilla::Config::Common;
+
+our $sortkey = 300;
+
+sub get_param_list {
+  my $class = shift;
+  my @param_list = (
+  {
+   name => 'auth_env_id',
+   type    => 't',
+   default => '',
+  },
+
+  {
+   name    => 'auth_env_email',
+   type    => 't',
+   default => '',
+  },
+
+  {
+   name    => 'auth_env_realname',
+   type    => 't',
+   default => '',
+  },
+
+  # XXX in the future:
+  #
+  # user_verify_class and user_info_class should have choices gathered from
+  # whatever sits in their respective directories
+  #
+  # rather than comma-separated lists, these two should eventually become
+  # arrays, but that requires alterations to editparams first
+
+  {
+   name => 'user_info_class',
+   type => 's',
+   choices => [ 'CGI', 'Env', 'Env,CGI' ],
+   default => 'CGI',
+   checker => \&check_multi
+  },
+
+  {
+   name => 'user_verify_class',
+   type => 'o',
+   choices => [ 'DB', 'RADIUS', 'LDAP' ],
+   default => 'DB',
+   checker => \&check_user_verify_class
+  },
+
+  {
+   name => 'rememberlogin',
+   type => 's',
+   choices => ['on', 'defaulton', 'defaultoff', 'off'],
+   default => 'on',
+   checker => \&check_multi
+  },
+
+  {
+   name => 'requirelogin',
+   type => 'b',
+   default => '0'
+  },
+
+  {
+   name => 'emailregexp',
+   type => 't',
+   default => q:^[\\w\\.\\+\\-=]+@[\\w\\.\\-]+\\.[\\w\\-]+$:,
+   checker => \&check_regexp
+  },
+
+  {
+   name => 'emailregexpdesc',
+   type => 'l',
+   default => 'A legal address must contain exactly one \'@\', and at least ' .
+              'one \'.\' after the @.'
+  },
+
+  {
+   name => 'emailsuffix',
+   type => 't',
+   default => ''
+  },
+
+  {
+   name => 'createemailregexp',
+   type => 't',
+   default => q:.*:,
+   checker => \&check_regexp
+  },
+
+  {
+   name => 'password_complexity',
+   type => 's',
+   choices => [ 'no_constraints', 'mixed_letters', 'letters_numbers',
+                'letters_numbers_specialchars' ],
+   default => 'no_constraints',
+   checker => \&check_multi
+  } );
+  return @param_list;
+}
+
+1;

diff --git a/Bugzilla/Config/BugChange.pm b/Bugzilla/Config/BugChange.pm
new file mode 100644 (file)
index 0000000..68cfe56
--- /dev/null
+++ b/Bugzilla/Config/BugChange.pm
@@ -0,0 +1,79 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Config::BugChange;
+
+use strict;
+
+use Bugzilla::Config::Common;
+use Bugzilla::Status;
+
+our $sortkey = 500;
+
+sub get_param_list {
+  my $class = shift;
+
+  # Hardcoded bug statuses which existed before Bugzilla 3.1.
+  my @closed_bug_statuses = ('RESOLVED', 'VERIFIED', 'CLOSED');
+
+  # If we are upgrading from 3.0 or older, bug statuses are not customisable
+  # and bug_status.is_open is not yet defined (hence the eval), so we use
+  # the bug statuses above as they are still hardcoded.
+  eval {
+      my @current_closed_states = map {$_->name} closed_bug_statuses();
+      # If no closed state was found, use the default list above.
+      @closed_bug_statuses = @current_closed_states if scalar(@current_closed_states);
+  };
+
+  my @param_list = (
+  {
+   name => 'duplicate_or_move_bug_status',
+   type => 's',
+   choices => \@closed_bug_statuses,
+   default => $closed_bug_statuses[0],
+   checker => \&check_bug_status
+  },
+
+  {
+   name => 'letsubmitterchoosepriority',
+   type => 'b',
+   default => 1
+  },
+
+  {
+   name => 'letsubmitterchoosemilestone',
+   type => 'b',
+   default => 1
+  },
+
+  {
+   name => 'musthavemilestoneonaccept',
+   type => 'b',
+   default => 0
+  },
+
+  {
+   name => 'commentonchange_resolution',
+   type => 'b',
+   default => 0
+  },
+
+  {
+   name => 'commentonduplicate',
+   type => 'b',
+   default => 0
+  },
+
+  {
+   name    => 'noresolveonopenblockers',
+   type    => 'b',
+   default => 0,
+  } );
+  return @param_list;
+}
+
+1;

diff --git a/Bugzilla/Config/BugFields.pm b/Bugzilla/Config/BugFields.pm
new file mode 100644 (file)
index 0000000..7ae9ae3
--- /dev/null
+++ b/Bugzilla/Config/BugFields.pm
@@ -0,0 +1,90 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Config::BugFields;
+
+use strict;
+
+use Bugzilla::Config::Common;
+use Bugzilla::Field;
+
+our $sortkey = 600;
+
+sub get_param_list {
+  my $class = shift;
+
+  my @legal_priorities = @{get_legal_field_values('priority')};
+  my @legal_severities = @{get_legal_field_values('bug_severity')};
+  my @legal_platforms  = @{get_legal_field_values('rep_platform')};
+  my @legal_OS         = @{get_legal_field_values('op_sys')};
+
+  my @param_list = (
+  {
+   name => 'useclassification',
+   type => 'b',
+   default => 0
+  },
+
+  {
+   name => 'usetargetmilestone',
+   type => 'b',
+   default => 0
+  },
+
+  {
+   name => 'useqacontact',
+   type => 'b',
+   default => 0
+  },
+
+  {
+   name => 'usestatuswhiteboard',
+   type => 'b',
+   default => 0
+  },
+
+  {
+   name => 'use_see_also',
+   type => 'b',
+   default => 1
+  },
+
+  {
+   name => 'defaultpriority',
+   type => 's',
+   choices => \@legal_priorities,
+   default => $legal_priorities[-1],
+   checker => \&check_priority
+  },
+
+  {
+   name => 'defaultseverity',
+   type => 's',
+   choices => \@legal_severities,
+   default => $legal_severities[-1],
+   checker => \&check_severity
+  },
+
+  {
+   name => 'defaultplatform',
+   type => 's',
+   choices => ['', @legal_platforms],
+   default => '',
+   checker => \&check_platform
+  },
+
+  {
+   name => 'defaultopsys',
+   type => 's',
+   choices => ['', @legal_OS],
+   default => '',
+   checker => \&check_opsys
+  } );
+  return @param_list;
+}
+
+1;

diff --git a/Bugzilla/Config/Common.pm b/Bugzilla/Config/Common.pm
new file mode 100644 (file)
index 0000000..0e3551d
--- /dev/null
+++ b/Bugzilla/Config/Common.pm
@@ -0,0 +1,453 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Config::Common;
+
+use strict;
+
+use Email::Address;
+use Socket;
+
+use Bugzilla::Util;
+use Bugzilla::Constants;
+use Bugzilla::Field;
+use Bugzilla::Group;
+use Bugzilla::Status;
+
+use base qw(Exporter);
+@Bugzilla::Config::Common::EXPORT =
+    qw(check_multi check_numeric check_regexp check_url check_group
+       check_sslbase check_priority check_severity check_platform
+       check_opsys check_shadowdb check_urlbase check_webdotbase
+       check_user_verify_class check_ip
+       check_mail_delivery_method check_notification check_utf8
+       check_bug_status check_smtp_auth check_theschwartz_available
+       check_maxattachmentsize check_email check_smtp_ssl
+);
+
+# Checking functions for the various values
+
+sub check_multi {
+    my ($value, $param) = (@_);
+
+    if ($param->{'type'} eq "s") {
+        unless (scalar(grep {$_ eq $value} (@{$param->{'choices'}}))) {
+            return "Invalid choice '$value' for single-select list param '$param->{'name'}'";
+        }
+
+        return "";
+    }
+    elsif ($param->{'type'} eq 'm' || $param->{'type'} eq 'o') {
+        foreach my $chkParam (split(',', $value)) {
+            unless (scalar(grep {$_ eq $chkParam} (@{$param->{'choices'}}))) {
+                return "Invalid choice '$chkParam' for multi-select list param '$param->{'name'}'";
+            }
+        }
+
+        return "";
+    }
+    else {
+        return "Invalid param type '$param->{'type'}' for check_multi(); " .
+          "contact your Bugzilla administrator";
+    }
+}
+
+sub check_numeric {
+    my ($value) = (@_);
+    if ($value !~ /^[0-9]+$/) {
+        return "must be a numeric value";
+    }
+    return "";
+}
+
+sub check_regexp {
+    my ($value) = (@_);
+    eval { qr/$value/ };
+    return $@;
+}
+
+sub check_email {
+    my ($value) = @_;
+    if ($value !~ $Email::Address::mailbox) {
+        return "must be a valid email address.";
+    }
+    return "";
+}
+
+sub check_sslbase {
+    my $url = shift;
+    if ($url ne '') {
+        if ($url !~ m#^https://([^/]+).*/$#) {
+            return "must be a legal URL, that starts with https and ends with a slash.";
+        }
+        my $host = $1;
+        # Fall back to port 443 if for some reason getservbyname() fails.
+        my $port = getservbyname('https', 'tcp') || 443;
+        if ($host =~ /^(.+):(\d+)$/) {
+            $host = $1;
+            $port = $2;
+        }
+        local *SOCK;
+        my $proto = getprotobyname('tcp');
+        socket(SOCK, PF_INET, SOCK_STREAM, $proto);
+        my $iaddr = inet_aton($host) || return "The host $host cannot be resolved";
+        my $sin = sockaddr_in($port, $iaddr);
+        if (!connect(SOCK, $sin)) {
+            return "Failed to connect to $host:$port; unable to enable SSL";
+        }
+        close(SOCK);
+    }
+    return "";
+}
+
+sub check_ip {
+    my $inbound_proxies = shift;
+    my @proxies = split(/[\s,]+/, $inbound_proxies);
+    foreach my $proxy (@proxies) {
+        validate_ip($proxy) || return "$proxy is not a valid IPv4 or IPv6 address";
+    }
+    return "";
+}
+
+sub check_utf8 {
+    my $utf8 = shift;
+    # You cannot turn off the UTF-8 parameter if you've already converted
+    # your tables to utf-8.
+    my $dbh = Bugzilla->dbh;
+    if ($dbh->isa('Bugzilla::DB::Mysql') && $dbh->bz_db_is_utf8 && !$utf8) {
+        return "You cannot disable UTF-8 support, because your MySQL database"
+               . " is encoded in UTF-8";
+    }
+    return "";
+}
+
+sub check_priority {
+    my ($value) = (@_);
+    my $legal_priorities = get_legal_field_values('priority');
+    if (!grep($_ eq $value, @$legal_priorities)) {
+        return "Must be a legal priority value: one of " .
+            join(", ", @$legal_priorities);
+    }
+    return "";
+}
+
+sub check_severity {
+    my ($value) = (@_);
+    my $legal_severities = get_legal_field_values('bug_severity');
+    if (!grep($_ eq $value, @$legal_severities)) {
+        return "Must be a legal severity value: one of " .
+            join(", ", @$legal_severities);
+    }
+    return "";
+}
+
+sub check_platform {
+    my ($value) = (@_);
+    my $legal_platforms = get_legal_field_values('rep_platform');
+    if (!grep($_ eq $value, '', @$legal_platforms)) {
+        return "Must be empty or a legal platform value: one of " .
+            join(", ", @$legal_platforms);
+    }
+    return "";
+}
+
+sub check_opsys {
+    my ($value) = (@_);
+    my $legal_OS = get_legal_field_values('op_sys');
+    if (!grep($_ eq $value, '', @$legal_OS)) {
+        return "Must be empty or a legal operating system value: one of " .
+            join(", ", @$legal_OS);
+    }
+    return "";
+}
+
+sub check_bug_status {
+    my $bug_status = shift;
+    my @closed_bug_statuses = map {$_->name} closed_bug_statuses();
+    if (!grep($_ eq $bug_status, @closed_bug_statuses)) {
+        return "Must be a valid closed status: one of " . join(', ', @closed_bug_statuses);
+    }
+    return "";
+}
+
+sub check_group {
+    my $group_name = shift;
+    return "" unless $group_name;
+    my $group = new Bugzilla::Group({'name' => $group_name});
+    unless (defined $group) {
+        return "Must be an existing group name";
+    }
+    return "";
+}
+
+sub check_shadowdb {
+    my ($value) = (@_);
+    $value = trim($value);
+    if ($value eq "") {
+        return "";
+    }
+
+    if (!Bugzilla->params->{'shadowdbhost'}) {
+        return "You need to specify a host when using a shadow database";
+    }
+
+    # Can't test existence of this because ConnectToDatabase uses the param,
+    # but we can't set this before testing....
+    # This can really only be fixed after we can use the DBI more openly
+    return "";
+}
+
+sub check_urlbase {
+    my ($url) = (@_);
+    if ($url && $url !~ m:^http.*/$:) {
+        return "must be a legal URL, that starts with http and ends with a slash.";
+    }
+    return "";
+}
+
+sub check_url {
+    my ($url) = (@_);
+    return '' if $url eq ''; # Allow empty URLs
+    if ($url !~ m:/$:) {
+        return 'must be a legal URL, absolute or relative, ending with a slash.';
+    }
+    return '';
+}
+
+sub check_webdotbase {
+    my ($value) = (@_);
+    $value = trim($value);
+    if ($value eq "") {
+        return "";
+    }
+    if($value !~ /^https?:/) {
+        if(! -x $value) {
+            return "The file path \"$value\" is not a valid executable.  Please specify the complete file path to 'dot' if you intend to generate graphs locally.";
+        }
+        # Check .htaccess allows access to generated images
+        my $webdotdir = bz_locations()->{'webdotdir'};
+        if(-e "$webdotdir/.htaccess") {
+            open HTACCESS, "$webdotdir/.htaccess";
+            if(! grep(/ \\\.png\$/,<HTACCESS>)) {
+                return "Dependency graph images are not accessible.\nAssuming that you have not modified the file, delete $webdotdir/.htaccess and re-run checksetup.pl to rectify.\n";
+            }
+            close HTACCESS;
+        }
+    }
+    return "";
+}
+
+sub check_user_verify_class {
+    # doeditparams traverses the list of params, and for each one it checks,
+    # then updates. This means that if one param checker wants to look at 
+    # other params, it must be below that other one. So you can't have two 
+    # params mutually dependent on each other.
+    # This means that if someone clears the LDAP config params after setting
+    # the login method as LDAP, we won't notice, but all logins will fail.
+    # So don't do that.
+
+    my $params = Bugzilla->params;
+    my ($list, $entry) = @_;
+    $list || return 'You need to specify at least one authentication mechanism';
+    for my $class (split /,\s*/, $list) {
+        my $res = check_multi($class, $entry);
+        return $res if $res;
+        if ($class eq 'RADIUS') {
+            if (!Bugzilla->feature('auth_radius')) {
+                return "RADIUS support is not available. Run checksetup.pl"
+                       . " for more details";
+            }
+            return "RADIUS servername (RADIUS_server) is missing"
+                if !$params->{"RADIUS_server"};
+            return "RADIUS_secret is empty" if !$params->{"RADIUS_secret"};
+        }
+        elsif ($class eq 'LDAP') {
+            if (!Bugzilla->feature('auth_ldap')) {
+                return "LDAP support is not available. Run checksetup.pl"
+                       . " for more details";
+            }
+            return "LDAP servername (LDAPserver) is missing" 
+                if !$params->{"LDAPserver"};
+            return "LDAPBaseDN is empty" if !$params->{"LDAPBaseDN"};
+        }
+    }
+    return "";
+}
+
+sub check_mail_delivery_method {
+    my $check = check_multi(@_);
+    return $check if $check;
+    my $mailer = shift;
+    if ($mailer eq 'sendmail' and ON_WINDOWS) {
+        # look for sendmail.exe 
+        return "Failed to locate " . SENDMAIL_EXE
+            unless -e SENDMAIL_EXE;
+    }
+    return "";
+}
+
+sub check_maxattachmentsize {
+    my $check = check_numeric(@_);
+    return $check if $check;
+    my $size = shift;
+    my $dbh = Bugzilla->dbh;
+    if ($dbh->isa('Bugzilla::DB::Mysql')) {
+        my (undef, $max_packet) = $dbh->selectrow_array(
+            q{SHOW VARIABLES LIKE 'max\_allowed\_packet'});
+        my $byte_size = $size * 1024;
+        if ($max_packet < $byte_size) {
+            return "You asked for a maxattachmentsize of $byte_size bytes,"
+                   . " but the max_allowed_packet setting in MySQL currently"
+                   . " only allows packets up to $max_packet bytes";
+        }
+    }
+    return "";
+}
+
+sub check_notification {
+    my $option = shift;
+    my @current_version =
+        (BUGZILLA_VERSION =~ m/^(\d+)\.(\d+)(?:(rc|\.)(\d+))?\+?$/);
+    if ($current_version[1] % 2 && $option eq 'stable_branch_release') {
+        return "You are currently running a development snapshot, and so your " .
+               "installation is not based on a branch. If you want to be notified " .
+               "about the next stable release, you should select " .
+               "'latest_stable_release' instead";
+    }
+    if ($option ne 'disabled' && !Bugzilla->feature('updates')) {
+        return "Some Perl modules are missing to get notifications about " .
+               "new releases. See the output of checksetup.pl for more information";
+    }
+    return "";
+}
+
+sub check_smtp_auth {
+    my $username = shift;
+    if ($username and !Bugzilla->feature('smtp_auth')) {
+        return "SMTP Authentication is not available. Run checksetup.pl for"
+               . " more details";
+    }
+    return "";
+}
+
+sub check_smtp_ssl {
+    my $use_ssl = shift;
+    if ($use_ssl && !Bugzilla->feature('smtp_ssl')) {
+        return "SSL support is not available. Run checksetup.pl for more details";
+    }
+    return "";
+}
+
+sub check_theschwartz_available {
+    my $use_queue = shift;
+    if ($use_queue && !Bugzilla->feature('jobqueue')) {
+        return "Using the job queue requires that you have certain Perl"
+               . " modules installed. See the output of checksetup.pl"
+               . " for more information";
+    }
+    return "";
+}
+
+# OK, here are the parameter definitions themselves.
+#
+# Each definition is a hash with keys:
+#
+# name    - name of the param
+# desc    - description of the param (for editparams.cgi)
+# type    - see below
+# choices - (optional) see below
+# default - default value for the param
+# checker - (optional) checking function for validating parameter entry
+#           It is called with the value of the param as the first arg and a
+#           reference to the param's hash as the second argument
+#
+# The type value can be one of the following:
+#
+# t -- A short text entry field (suitable for a single line)
+# p -- A short text entry field (as with type = 't'), but the string is
+#      replaced by asterisks (appropriate for passwords)
+# l -- A long text field (suitable for many lines)
+# b -- A boolean value (either 1 or 0)
+# m -- A list of values, with many selectable (shows up as a select box)
+#      To specify the list of values, make the 'choices' key be an array
+#      reference of the valid choices. The 'default' key should be a string
+#      with a list of selected values (as a comma-separated list), i.e.:
+#       {
+#         name => 'multiselect',
+#         desc => 'A list of options, choose many',
+#         type => 'm',
+#         choices => [ 'a', 'b', 'c', 'd' ],
+#         default => [ 'a', 'd' ],
+#         checker => \&check_multi
+#       }
+#
+#      Here, 'a' and 'd' are the default options, and the user may pick any
+#      combination of a, b, c, and d as valid options.
+#
+#      &check_multi should always be used as the param verification function
+#      for list (single and multiple) parameter types.
+#
+# o -- A list of values, orderable, and with many selectable (shows up as a
+#      JavaScript-enhanced select box if JavaScript is enabled, and a text
+#      entry field if not)
+#      Set up in the same way as type m.
+#
+# s -- A list of values, with one selectable (shows up as a select box)
+#      To specify the list of values, make the 'choices' key be an array
+#      reference of the valid choices. The 'default' key should be one of
+#      those values, i.e.:
+#       {
+#         name => 'singleselect',
+#         desc => 'A list of options, choose one',
+#         type => 's',
+#         choices => [ 'a', 'b', 'c' ],
+#         default => 'b',
+#         checker => \&check_multi
+#       }
+#
+#      Here, 'b' is the default option, and 'a' and 'c' are other possible
+#      options, but only one at a time! 
+#
+#      &check_multi should always be used as the param verification function
+#      for list (single and multiple) parameter types.
+
+sub get_param_list {
+    return;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Config::Common - Parameter checking functions
+
+=head1 DESCRIPTION
+
+All parameter checking functions are called with two parameters: the value to 
+check, and a hash with the details of the param (type, default etc.) as defined
+in the relevant F<Bugzilla::Config::*> package.
+
+=head2 Functions
+
+=over
+
+=item C<check_multi>
+
+Checks that a multi-valued parameter (ie types C<s>, C<o> or C<m>) satisfies
+its contraints.
+
+=item C<check_numeric>
+
+Checks that the value is a valid number
+
+=item C<check_regexp>
+
+Checks that the value is a valid regexp
+
+=back

diff --git a/Bugzilla/Config/Core.pm b/Bugzilla/Config/Core.pm
new file mode 100644 (file)
index 0000000..f2510d2
--- /dev/null
+++ b/Bugzilla/Config/Core.pm
@@ -0,0 +1,44 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Config::Core;
+
+use strict;
+
+use Bugzilla::Config::Common;
+
+our $sortkey = 100;
+
+use constant get_param_list => (
+  {
+   name => 'urlbase',
+   type => 't',
+   default => '',
+   checker => \&check_urlbase
+  },
+
+  {
+   name => 'ssl_redirect',
+   type => 'b',
+   default => 0
+  },
+
+  {
+   name => 'sslbase',
+   type => 't',
+   default => '',
+   checker => \&check_sslbase
+  },
+
+  {
+   name => 'cookiepath',
+   type => 't',
+   default => '/'
+  },
+);
+
+1;

diff --git a/Bugzilla/Config/DependencyGraph.pm b/Bugzilla/Config/DependencyGraph.pm
new file mode 100644 (file)
index 0000000..cc61e35
--- /dev/null
+++ b/Bugzilla/Config/DependencyGraph.pm
@@ -0,0 +1,28 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Config::DependencyGraph;
+
+use strict;
+
+use Bugzilla::Config::Common;
+
+our $sortkey = 800;
+
+sub get_param_list {
+  my $class = shift;
+  my @param_list = (
+  {
+   name => 'webdotbase',
+   type => 't',
+   default => 'http://www.research.att.com/~north/cgi-bin/webdot.cgi/%urlbase%',
+   checker => \&check_webdotbase
+  } );
+  return @param_list;
+}
+
+1;

diff --git a/Bugzilla/Config/General.pm b/Bugzilla/Config/General.pm
new file mode 100644 (file)
index 0000000..6e00b20
--- /dev/null
+++ b/Bugzilla/Config/General.pm
@@ -0,0 +1,59 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Config::General;
+use strict;
+use Bugzilla::Config::Common;
+
+our $sortkey = 150;
+
+use constant get_param_list => (
+  {
+   name => 'maintainer',
+   type => 't',
+   no_reset => '1',
+   default => '',
+   checker => \&check_email
+  },
+
+  {
+   name => 'docs_urlbase',
+   type => 't',
+   default => 'docs/%lang%/html/',
+   checker => \&check_url
+  },
+
+  {
+   name => 'utf8',
+   type => 'b',
+   default => '0',
+   checker => \&check_utf8
+  },
+
+  {
+   name => 'shutdownhtml',
+   type => 'l',
+   default => ''
+  },
+
+  {
+   name => 'announcehtml',
+   type => 'l',
+   default => ''
+  },
+
+  {
+   name => 'upgrade_notification',
+   type => 's',
+   choices => ['development_snapshot', 'latest_stable_release',
+               'stable_branch_release', 'disabled'],
+   default => 'latest_stable_release',
+   checker => \&check_notification
+  },
+);
+
+1;

diff --git a/Bugzilla/Config/GroupSecurity.pm b/Bugzilla/Config/GroupSecurity.pm
new file mode 100644 (file)
index 0000000..f0b4ac8
--- /dev/null
+++ b/Bugzilla/Config/GroupSecurity.pm
@@ -0,0 +1,86 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Config::GroupSecurity;
+
+use strict;
+
+use Bugzilla::Config::Common;
+use Bugzilla::Group;
+
+our $sortkey = 900;
+
+sub get_param_list {
+  my $class = shift;
+
+  my @param_list = (
+  {
+   name => 'makeproductgroups',
+   type => 'b',
+   default => 0
+  },
+
+  {
+   name => 'chartgroup',
+   type => 's',
+   choices => \&_get_all_group_names,
+   default => 'editbugs',
+   checker => \&check_group
+  },
+
+  {
+   name => 'insidergroup',
+   type => 's',
+   choices => \&_get_all_group_names,
+   default => '',
+   checker => \&check_group
+  },
+
+  {
+   name => 'timetrackinggroup',
+   type => 's',
+   choices => \&_get_all_group_names,
+   default => 'editbugs',
+   checker => \&check_group
+  },
+
+  {
+   name => 'querysharegroup',
+   type => 's',
+   choices => \&_get_all_group_names,
+   default => 'editbugs',
+   checker => \&check_group
+  },
+  
+  {
+   name => 'debug_group',
+   type => 's',
+   choices => \&_get_all_group_names,
+   default => 'admin',
+   checker => \&check_group
+  },
+  
+  {
+   name => 'usevisibilitygroups',
+   type => 'b',
+   default => 0
+  }, 
+  
+  {
+   name => 'strict_isolation',
+   type => 'b',
+   default => 0
+  } );
+  return @param_list;
+}
+
+sub _get_all_group_names {
+    my @group_names = map {$_->name} Bugzilla::Group->get_all;
+    unshift(@group_names, '');
+    return \@group_names;
+}
+1;

diff --git a/Bugzilla/Config/LDAP.pm b/Bugzilla/Config/LDAP.pm
new file mode 100644 (file)
index 0000000..daa7f72
--- /dev/null
+++ b/Bugzilla/Config/LDAP.pm
@@ -0,0 +1,63 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Config::LDAP;
+
+use strict;
+
+use Bugzilla::Config::Common;
+
+our $sortkey = 1000;
+
+sub get_param_list {
+  my $class = shift;
+  my @param_list = (
+  {
+   name => 'LDAPserver',
+   type => 't',
+   default => ''
+  },
+
+  {
+   name => 'LDAPstarttls',
+   type => 'b',
+   default => 0
+  },
+
+  {
+   name => 'LDAPbinddn',
+   type => 't',
+   default => ''
+  },
+
+  {
+   name => 'LDAPBaseDN',
+   type => 't',
+   default => ''
+  },
+
+  {
+   name => 'LDAPuidattribute',
+   type => 't',
+   default => 'uid'
+  },
+
+  {
+   name => 'LDAPmailattribute',
+   type => 't',
+   default => 'mail'
+  },
+
+  {
+   name => 'LDAPfilter',
+   type => 't',
+   default => '',
+  } );
+  return @param_list;
+}
+
+1;

diff --git a/Bugzilla/Config/MTA.pm b/Bugzilla/Config/MTA.pm
new file mode 100644 (file)
index 0000000..8184b9f
--- /dev/null
+++ b/Bugzilla/Config/MTA.pm
@@ -0,0 +1,90 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Config::MTA;
+
+use strict;
+
+use Bugzilla::Config::Common;
+# Return::Value 1.666002 pollutes the error log with warnings about this
+# deprecated module. We have to set NO_CLUCK = 1 before loading Email::Send
+# to disable these warnings.
+BEGIN {
+    $Return::Value::NO_CLUCK = 1;
+}
+use Email::Send;
+
+our $sortkey = 1200;
+
+sub get_param_list {
+  my $class = shift;
+  my @param_list = (
+  {
+   name => 'mail_delivery_method',
+   type => 's',
+   # Bugzilla is not ready yet to send mails to newsgroups, and 'IO'
+   # is of no use for now as we already have our own 'Test' mode.
+   choices => [grep {$_ ne 'NNTP' && $_ ne 'IO'} Email::Send->new()->all_mailers(), 'None'],
+   default => 'Sendmail',
+   checker => \&check_mail_delivery_method
+  },
+
+  {
+   name => 'mailfrom',
+   type => 't',
+   default => 'bugzilla-daemon'
+  },
+
+  {
+   name => 'use_mailer_queue',
+   type => 'b',
+   default => 0,
+   checker => \&check_theschwartz_available,
+  },
+
+  {
+   name => 'smtpserver',
+   type => 't',
+   default => 'localhost'
+  },
+  {
+   name => 'smtp_username',
+   type => 't',
+   default => '',
+   checker => \&check_smtp_auth
+  },
+  {
+   name => 'smtp_password',
+   type => 'p',
+   default => ''
+  },
+  {
+   name => 'smtp_ssl',
+   type => 'b',
+   default => 0,
+   checker => \&check_smtp_ssl
+  },
+  {
+   name => 'smtp_debug',
+   type => 'b',
+   default => 0
+  },
+  {
+   name => 'whinedays',
+   type => 't',
+   default => 7,
+   checker => \&check_numeric
+  },
+  {
+   name => 'globalwatchers',
+   type => 't',
+   default => '',
+  }, );
+  return @param_list;
+}
+
+1;

diff --git a/Bugzilla/Config/PatchViewer.pm b/Bugzilla/Config/PatchViewer.pm
new file mode 100644 (file)
index 0000000..08e8028
--- /dev/null
+++ b/Bugzilla/Config/PatchViewer.pm
@@ -0,0 +1,51 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Config::PatchViewer;
+
+use strict;
+
+use Bugzilla::Config::Common;
+
+our $sortkey = 1300;
+
+sub get_param_list {
+  my $class = shift;
+  my @param_list = (
+  {
+   name    => 'cvsroot',
+   type    => 't',
+   default => '',
+  },
+
+  {
+   name    => 'cvsroot_get',
+   type    => 't',
+   default => '',
+  },
+
+  {
+   name    => 'bonsai_url',
+   type    => 't',
+   default => ''
+  },
+
+  {
+   name    => 'lxr_url',
+   type    => 't',
+   default => ''
+  },
+
+  {
+   name    => 'lxr_root',
+   type    => 't',
+   default => '',
+  } );
+  return @param_list;
+}
+
+1;

diff --git a/Bugzilla/Config/Query.pm b/Bugzilla/Config/Query.pm
new file mode 100644 (file)
index 0000000..fe54d67
--- /dev/null
+++ b/Bugzilla/Config/Query.pm
@@ -0,0 +1,69 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Config::Query;
+
+use strict;
+
+use Bugzilla::Config::Common;
+
+our $sortkey = 1400;
+
+sub get_param_list {
+  my $class = shift;
+  my @param_list = (
+  {
+   name => 'quip_list_entry_control',
+   type => 's',
+   choices => ['open', 'moderated', 'closed'],
+   default => 'open',
+   checker => \&check_multi
+  },
+
+  {
+   name => 'mostfreqthreshold',
+   type => 't',
+   default => '2',
+   checker => \&check_numeric
+  },
+
+  {
+   name => 'mybugstemplate',
+   type => 't',
+   default => 'buglist.cgi?resolution=---&emailassigned_to1=1&emailreporter1=1&emailtype1=exact&email1=%userid%'
+  },
+
+  {
+   name => 'defaultquery',
+   type => 't',
+   default => 'resolution=---&emailassigned_to1=1&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailqa_contact2=1&emaillongdesc3=1&order=Importance&long_desc_type=substring'
+  },
+
+  {
+   name => 'search_allow_no_criteria',
+   type => 'b',
+   default => 1
+  },
+
+  {
+    name => 'default_search_limit',
+    type => 't',
+    default => '500',
+    checker => \&check_numeric
+  },
+
+  {
+    name => 'max_search_results',
+    type => 't',
+    default => '10000',
+    checker => \&check_numeric
+  },
+  );
+  return @param_list;
+}
+
+1;

diff --git a/Bugzilla/Config/RADIUS.pm b/Bugzilla/Config/RADIUS.pm
new file mode 100644 (file)
index 0000000..312be1d
--- /dev/null
+++ b/Bugzilla/Config/RADIUS.pm
@@ -0,0 +1,46 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Config::RADIUS;
+
+use strict;
+
+use Bugzilla::Config::Common;
+
+our $sortkey = 1100;
+
+sub get_param_list {
+  my $class = shift;
+  my @param_list = (
+  {
+   name =>    'RADIUS_server',
+   type =>    't',
+   default => ''
+  },
+
+  {
+   name =>    'RADIUS_secret',
+   type =>    't',
+   default => ''
+  },
+
+  {
+   name =>    'RADIUS_NAS_IP',
+   type =>    't',
+   default => ''
+  },
+
+  {
+   name =>    'RADIUS_email_suffix',
+   type =>    't',
+   default => ''
+  },
+  );
+  return @param_list;
+}
+
+1;

diff --git a/Bugzilla/Config/ShadowDB.pm b/Bugzilla/Config/ShadowDB.pm
new file mode 100644 (file)
index 0000000..c0ff590
--- /dev/null
+++ b/Bugzilla/Config/ShadowDB.pm
@@ -0,0 +1,49 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Config::ShadowDB;
+
+use strict;
+
+use Bugzilla::Config::Common;
+
+our $sortkey = 1500;
+
+sub get_param_list {
+  my $class = shift;
+  my @param_list = (
+  {
+   name => 'shadowdbhost',
+   type => 't',
+   default => '',
+  },
+
+  {
+   name => 'shadowdbport',
+   type => 't',
+   default => '3306',
+   checker => \&check_numeric,
+  },
+
+  {
+   name => 'shadowdbsock',
+   type => 't',
+   default => '',
+  },
+
+  # This entry must be _after_ the shadowdb{host,port,sock} settings so that
+  # they can be used in the validation here
+  {
+   name => 'shadowdb',
+   type => 't',
+   default => '',
+   checker => \&check_shadowdb
+  } );
+  return @param_list;
+}
+
+1;

diff --git a/Bugzilla/Config/UserMatch.pm b/Bugzilla/Config/UserMatch.pm
new file mode 100644 (file)
index 0000000..5b98a25
--- /dev/null
+++ b/Bugzilla/Config/UserMatch.pm
@@ -0,0 +1,46 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Config::UserMatch;
+
+use strict;
+
+use Bugzilla::Config::Common;
+
+our $sortkey = 1600;
+
+sub get_param_list {
+  my $class = shift;
+  my @param_list = (
+  {
+   name => 'usemenuforusers',
+   type => 'b',
+   default => '0'
+  },
+
+  {
+   name    => 'ajax_user_autocompletion', 
+   type    => 'b', 
+   default => '1', 
+  },
+
+  {
+   name    => 'maxusermatches',
+   type    => 't',
+   default => '1000',
+   checker => \&check_numeric
+  },
+
+  {
+   name    => 'confirmuniqueusermatch',
+   type    => 'b',
+   default => 1,
+  } );
+  return @param_list;
+}
+
+1;

diff --git a/Bugzilla/Constants.pm b/Bugzilla/Constants.pm
new file mode 100644 (file)
index 0000000..f0bba06
--- /dev/null
+++ b/Bugzilla/Constants.pm
@@ -0,0 +1,653 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Constants;
+use strict;
+use base qw(Exporter);
+
+# For bz_locations
+use File::Basename;
+use Memoize;
+
+@Bugzilla::Constants::EXPORT = qw(
+    BUGZILLA_VERSION
+
+    REMOTE_FILE
+    LOCAL_FILE
+
+    bz_locations
+
+    IS_NULL
+    NOT_NULL
+
+    CONTROLMAPNA
+    CONTROLMAPSHOWN
+    CONTROLMAPDEFAULT
+    CONTROLMAPMANDATORY
+
+    AUTH_OK
+    AUTH_NODATA
+    AUTH_ERROR
+    AUTH_LOGINFAILED
+    AUTH_DISABLED
+    AUTH_NO_SUCH_USER
+    AUTH_LOCKOUT
+
+    USER_PASSWORD_MIN_LENGTH
+
+    LOGIN_OPTIONAL
+    LOGIN_NORMAL
+    LOGIN_REQUIRED
+
+    LOGOUT_ALL
+    LOGOUT_CURRENT
+    LOGOUT_KEEP_CURRENT
+
+    GRANT_DIRECT
+    GRANT_REGEXP
+
+    GROUP_MEMBERSHIP
+    GROUP_BLESS
+    GROUP_VISIBLE
+
+    MAILTO_USER
+    MAILTO_GROUP
+
+    DEFAULT_COLUMN_LIST
+    DEFAULT_QUERY_NAME
+    DEFAULT_MILESTONE
+
+    SAVE_NUM_SEARCHES
+
+    COMMENT_COLS
+    MAX_COMMENT_LENGTH
+
+    CMT_NORMAL
+    CMT_DUPE_OF
+    CMT_HAS_DUPE
+    CMT_ATTACHMENT_CREATED
+    CMT_ATTACHMENT_UPDATED
+
+    THROW_ERROR
+    
+    RELATIONSHIPS
+    REL_ASSIGNEE REL_QA REL_REPORTER REL_CC REL_GLOBAL_WATCHER
+    REL_ANY
+    
+    POS_EVENTS
+    EVT_OTHER EVT_ADDED_REMOVED EVT_COMMENT EVT_ATTACHMENT EVT_ATTACHMENT_DATA
+    EVT_PROJ_MANAGEMENT EVT_OPENED_CLOSED EVT_KEYWORD EVT_CC EVT_DEPEND_BLOCK
+    EVT_BUG_CREATED EVT_COMPONENT
+
+    NEG_EVENTS
+    EVT_UNCONFIRMED EVT_CHANGED_BY_ME 
+        
+    GLOBAL_EVENTS
+    EVT_FLAG_REQUESTED EVT_REQUESTED_FLAG
+
+    ADMIN_GROUP_NAME
+    PER_PRODUCT_PRIVILEGES
+
+    SENDMAIL_EXE
+    SENDMAIL_PATH
+
+    FIELD_TYPE_UNKNOWN
+    FIELD_TYPE_FREETEXT
+    FIELD_TYPE_SINGLE_SELECT
+    FIELD_TYPE_MULTI_SELECT
+    FIELD_TYPE_TEXTAREA
+    FIELD_TYPE_DATETIME
+    FIELD_TYPE_BUG_ID
+    FIELD_TYPE_BUG_URLS
+    FIELD_TYPE_KEYWORDS
+
+    EMPTY_DATETIME_REGEX
+
+    ABNORMAL_SELECTS
+
+    TIMETRACKING_FIELDS
+
+    USAGE_MODE_BROWSER
+    USAGE_MODE_CMDLINE
+    USAGE_MODE_XMLRPC
+    USAGE_MODE_EMAIL
+    USAGE_MODE_JSON
+    USAGE_MODE_TEST
+
+    ERROR_MODE_WEBPAGE
+    ERROR_MODE_DIE
+    ERROR_MODE_DIE_SOAP_FAULT
+    ERROR_MODE_JSON_RPC
+    ERROR_MODE_TEST
+
+    COLOR_ERROR
+    COLOR_SUCCESS
+
+    INSTALLATION_MODE_INTERACTIVE
+    INSTALLATION_MODE_NON_INTERACTIVE
+
+    DB_MODULE
+    ROOT_USER
+    ON_WINDOWS
+    ON_ACTIVESTATE
+
+    MAX_TOKEN_AGE
+    MAX_LOGINCOOKIE_AGE
+    MAX_SUDO_TOKEN_AGE
+    MAX_LOGIN_ATTEMPTS
+    LOGIN_LOCKOUT_INTERVAL
+    ACCOUNT_CHANGE_INTERVAL
+    MAX_STS_AGE
+
+    SAFE_PROTOCOLS
+    LEGAL_CONTENT_TYPES
+
+    MIN_SMALLINT
+    MAX_SMALLINT
+    MAX_INT_32
+
+    MAX_LEN_QUERY_NAME
+    MAX_CLASSIFICATION_SIZE
+    MAX_PRODUCT_SIZE
+    MAX_MILESTONE_SIZE
+    MAX_COMPONENT_SIZE
+    MAX_FIELD_VALUE_SIZE
+    MAX_FIELD_LONG_DESC_LENGTH
+    MAX_FREETEXT_LENGTH
+    MAX_BUG_URL_LENGTH
+    MAX_POSSIBLE_DUPLICATES
+    MAX_ATTACH_FILENAME_LENGTH
+    MAX_QUIP_LENGTH
+
+    PASSWORD_DIGEST_ALGORITHM
+    PASSWORD_SALT_LENGTH
+    
+    CGI_URI_LIMIT
+
+    PRIVILEGES_REQUIRED_NONE
+    PRIVILEGES_REQUIRED_REPORTER
+    PRIVILEGES_REQUIRED_ASSIGNEE
+    PRIVILEGES_REQUIRED_EMPOWERED
+
+    AUDIT_CREATE
+    AUDIT_REMOVE
+);
+
+@Bugzilla::Constants::EXPORT_OK = qw(contenttypes);
+
+# CONSTANTS
+#
+# Bugzilla version
+use constant BUGZILLA_VERSION => "4.4";
+
+# Location of the remote and local XML files to track new releases.
+use constant REMOTE_FILE => 'http://updates.bugzilla.org/bugzilla-update.xml';
+use constant LOCAL_FILE  => 'bugzilla-update.xml'; # Relative to datadir.
+
+# These are unique values that are unlikely to match a string or a number,
+# to be used in criteria for match() functions and other things. They start
+# and end with spaces because most Bugzilla stuff has trim() called on it,
+# so this is unlikely to match anything we get out of the DB.
+#
+# We can't use a reference, because Template Toolkit doesn't work with
+# them properly (constants.IS_NULL => {} just returns an empty string instead
+# of the reference).
+use constant IS_NULL  => '  __IS_NULL__  ';
+use constant NOT_NULL => '  __NOT_NULL__  ';
+
+#
+# ControlMap constants for group_control_map.
+# membercontol:othercontrol => meaning
+# Na:Na               => Bugs in this product may not be restricted to this 
+#                        group.
+# Shown:Na            => Members of the group may restrict bugs 
+#                        in this product to this group.
+# Shown:Shown         => Members of the group may restrict bugs
+#                        in this product to this group.
+#                        Anyone who can enter bugs in this product may initially
+#                        restrict bugs in this product to this group.
+# Shown:Mandatory     => Members of the group may restrict bugs
+#                        in this product to this group.
+#                        Non-members who can enter bug in this product
+#                        will be forced to restrict it.
+# Default:Na          => Members of the group may restrict bugs in this
+#                        product to this group and do so by default.
+# Default:Default     => Members of the group may restrict bugs in this
+#                        product to this group and do so by default and
+#                        nonmembers have this option on entry.
+# Default:Mandatory   => Members of the group may restrict bugs in this
+#                        product to this group and do so by default.
+#                        Non-members who can enter bug in this product
+#                        will be forced to restrict it.
+# Mandatory:Mandatory => Bug will be forced into this group regardless.
+# All other combinations are illegal.
+
+use constant CONTROLMAPNA => 0;
+use constant CONTROLMAPSHOWN => 1;
+use constant CONTROLMAPDEFAULT => 2;
+use constant CONTROLMAPMANDATORY => 3;
+
+# See Bugzilla::Auth for docs on AUTH_*, LOGIN_* and LOGOUT_*
+
+use constant AUTH_OK => 0;
+use constant AUTH_NODATA => 1;
+use constant AUTH_ERROR => 2;
+use constant AUTH_LOGINFAILED => 3;
+use constant AUTH_DISABLED => 4;
+use constant AUTH_NO_SUCH_USER  => 5;
+use constant AUTH_LOCKOUT => 6;
+
+# The minimum length a password must have.
+use constant USER_PASSWORD_MIN_LENGTH => 6;
+
+use constant LOGIN_OPTIONAL => 0;
+use constant LOGIN_NORMAL => 1;
+use constant LOGIN_REQUIRED => 2;
+
+use constant LOGOUT_ALL => 0;
+use constant LOGOUT_CURRENT => 1;
+use constant LOGOUT_KEEP_CURRENT => 2;
+
+use constant GRANT_DIRECT => 0;
+use constant GRANT_REGEXP => 2;
+
+use constant GROUP_MEMBERSHIP => 0;
+use constant GROUP_BLESS => 1;
+use constant GROUP_VISIBLE => 2;
+
+use constant MAILTO_USER => 0;
+use constant MAILTO_GROUP => 1;
+
+# The default list of columns for buglist.cgi
+use constant DEFAULT_COLUMN_LIST => (
+    "product", "component", "assigned_to",
+    "bug_status", "resolution", "short_desc", "changeddate"
+);
+
+# Used by query.cgi and buglist.cgi as the named-query name
+# for the default settings.
+use constant DEFAULT_QUERY_NAME => '(Default query)';
+
+# The default "defaultmilestone" created for products.
+use constant DEFAULT_MILESTONE => '---';
+
+# How many of the user's most recent searches to save.
+use constant SAVE_NUM_SEARCHES => 10;
+
+# The column width for comment textareas and comments in bugmails.
+use constant COMMENT_COLS => 80;
+# Used in _check_comment(). Gives the max length allowed for a comment.
+use constant MAX_COMMENT_LENGTH => 65535;
+
+# The type of bug comments.
+use constant CMT_NORMAL => 0;
+use constant CMT_DUPE_OF => 1;
+use constant CMT_HAS_DUPE => 2;
+# Type 3 was CMT_POPULAR_VOTES, which moved to the Voting extension.
+# Type 4 was CMT_MOVED_TO, which moved to the OldBugMove extension.
+use constant CMT_ATTACHMENT_CREATED => 5;
+use constant CMT_ATTACHMENT_UPDATED => 6;
+
+# Determine whether a validation routine should return 0 or throw
+# an error when the validation fails.
+use constant THROW_ERROR => 1;
+
+use constant REL_ASSIGNEE           => 0;
+use constant REL_QA                 => 1;
+use constant REL_REPORTER           => 2;
+use constant REL_CC                 => 3;
+# REL 4 was REL_VOTER, before it was moved ino an extension.
+use constant REL_GLOBAL_WATCHER     => 5;
+
+# We need these strings for the X-Bugzilla-Reasons header
+# Note: this hash uses "," rather than "=>" to avoid auto-quoting of the LHS.
+# This should be accessed through Bugzilla::BugMail::relationships() instead
+# of being accessed directly.
+use constant RELATIONSHIPS => {
+    REL_ASSIGNEE      , "AssignedTo",
+    REL_REPORTER      , "Reporter",
+    REL_QA            , "QAcontact",
+    REL_CC            , "CC",
+    REL_GLOBAL_WATCHER, "GlobalWatcher"
+};
+                              
+# Used for global events like EVT_FLAG_REQUESTED
+use constant REL_ANY                => 100;
+
+# There are two sorts of event - positive and negative. Positive events are
+# those for which the user says "I want mail if this happens." Negative events
+# are those for which the user says "I don't want mail if this happens."
+#
+# Exactly when each event fires is defined in wants_bug_mail() in User.pm; I'm
+# not commenting them here in case the comments and the code get out of sync.
+use constant EVT_OTHER              => 0;
+use constant EVT_ADDED_REMOVED      => 1;
+use constant EVT_COMMENT            => 2;
+use constant EVT_ATTACHMENT         => 3;
+use constant EVT_ATTACHMENT_DATA    => 4;
+use constant EVT_PROJ_MANAGEMENT    => 5;
+use constant EVT_OPENED_CLOSED      => 6;
+use constant EVT_KEYWORD            => 7;
+use constant EVT_CC                 => 8;
+use constant EVT_DEPEND_BLOCK       => 9;
+use constant EVT_BUG_CREATED        => 10;
+use constant EVT_COMPONENT          => 11;
+
+use constant POS_EVENTS => EVT_OTHER, EVT_ADDED_REMOVED, EVT_COMMENT, 
+                           EVT_ATTACHMENT, EVT_ATTACHMENT_DATA, 
+                           EVT_PROJ_MANAGEMENT, EVT_OPENED_CLOSED, EVT_KEYWORD,
+                           EVT_CC, EVT_DEPEND_BLOCK, EVT_BUG_CREATED,
+                           EVT_COMPONENT;
+
+use constant EVT_UNCONFIRMED        => 50;
+use constant EVT_CHANGED_BY_ME      => 51;
+
+use constant NEG_EVENTS => EVT_UNCONFIRMED, EVT_CHANGED_BY_ME;
+
+# These are the "global" flags, which aren't tied to a particular relationship.
+# and so use REL_ANY.
+use constant EVT_FLAG_REQUESTED     => 100; # Flag has been requested of me
+use constant EVT_REQUESTED_FLAG     => 101; # I have requested a flag
+
+use constant GLOBAL_EVENTS => EVT_FLAG_REQUESTED, EVT_REQUESTED_FLAG;
+
+# Default administration group name.
+use constant ADMIN_GROUP_NAME => 'admin';
+
+# Privileges which can be per-product.
+use constant PER_PRODUCT_PRIVILEGES => ('editcomponents', 'editbugs', 'canconfirm');
+
+# Path to sendmail.exe (Windows only)
+use constant SENDMAIL_EXE => '/usr/lib/sendmail.exe';
+# Paths to search for the sendmail binary (non-Windows)
+use constant SENDMAIL_PATH => '/usr/lib:/usr/sbin:/usr/ucblib';
+
+# Field types.  Match values in fielddefs.type column.  These are purposely
+# not named after database column types, since Bugzilla fields comprise not
+# only storage but also logic.  For example, we might add a "user" field type
+# whose values are stored in an integer column in the database but for which
+# we do more than we would do for a standard integer type (f.e. we might
+# display a user picker).
+
+use constant FIELD_TYPE_UNKNOWN   => 0;
+use constant FIELD_TYPE_FREETEXT  => 1;
+use constant FIELD_TYPE_SINGLE_SELECT => 2;
+use constant FIELD_TYPE_MULTI_SELECT => 3;
+use constant FIELD_TYPE_TEXTAREA  => 4;
+use constant FIELD_TYPE_DATETIME  => 5;
+use constant FIELD_TYPE_BUG_ID  => 6;
+use constant FIELD_TYPE_BUG_URLS => 7;
+use constant FIELD_TYPE_KEYWORDS => 8;
+
+use constant EMPTY_DATETIME_REGEX => qr/^[0\-:\sA-Za-z]+$/; 
+
+# See the POD for Bugzilla::Field/is_abnormal to see why these are listed
+# here.
+use constant ABNORMAL_SELECTS => {
+    classification => 1,
+    component      => 1,
+    product        => 1,
+};
+
+# The fields from fielddefs that are blocked from non-timetracking users.
+# work_time is sometimes called actual_time.
+use constant TIMETRACKING_FIELDS =>
+    qw(estimated_time remaining_time work_time actual_time
+       percentage_complete deadline);
+
+# The maximum number of days a token will remain valid.
+use constant MAX_TOKEN_AGE => 3;
+# How many days a logincookie will remain valid if not used.
+use constant MAX_LOGINCOOKIE_AGE => 30;
+# How many seconds (default is 6 hours) a sudo cookie remains valid.
+use constant MAX_SUDO_TOKEN_AGE => 21600;
+
+# Maximum failed logins to lock account for this IP
+use constant MAX_LOGIN_ATTEMPTS => 5;
+# If the maximum login attempts occur during this many minutes, the
+# account is locked.
+use constant LOGIN_LOCKOUT_INTERVAL => 30;
+
+# The time in minutes a user must wait before he can request another email to
+# create a new account or change his password.
+use constant ACCOUNT_CHANGE_INTERVAL => 10;
+
+# The maximum number of seconds the Strict-Transport-Security header
+# will remain valid. Default is one week.
+use constant MAX_STS_AGE => 604800;
+
+# Protocols which are considered as safe.
+use constant SAFE_PROTOCOLS => ('afs', 'cid', 'ftp', 'gopher', 'http', 'https',
+                                'irc', 'ircs', 'mid', 'news', 'nntp', 'prospero',
+                                'telnet', 'view-source', 'wais');
+
+# Valid MIME types for attachments.
+use constant LEGAL_CONTENT_TYPES => ('application', 'audio', 'image', 'message',
+                                     'model', 'multipart', 'text', 'video');
+
+use constant contenttypes =>
+  {
+   "html" => "text/html" ,
+   "rdf"  => "application/rdf+xml" ,
+   "atom" => "application/atom+xml" ,
+   "xml"  => "application/xml" ,
+   "dtd"  => "application/xml-dtd" , 
+   "js"   => "application/x-javascript" ,
+   "json" => "application/json" ,
+   "csv"  => "text/csv" ,
+   "png"  => "image/png" ,
+   "ics"  => "text/calendar" ,
+  };
+
+# Usage modes. Default USAGE_MODE_BROWSER. Use with Bugzilla->usage_mode.
+use constant USAGE_MODE_BROWSER    => 0;
+use constant USAGE_MODE_CMDLINE    => 1;
+use constant USAGE_MODE_XMLRPC     => 2;
+use constant USAGE_MODE_EMAIL      => 3;
+use constant USAGE_MODE_JSON       => 4;
+use constant USAGE_MODE_TEST       => 5;
+
+# Error modes. Default set by Bugzilla->usage_mode (so ERROR_MODE_WEBPAGE
+# usually). Use with Bugzilla->error_mode.
+use constant ERROR_MODE_WEBPAGE        => 0;
+use constant ERROR_MODE_DIE            => 1;
+use constant ERROR_MODE_DIE_SOAP_FAULT => 2;
+use constant ERROR_MODE_JSON_RPC       => 3;
+use constant ERROR_MODE_TEST           => 4;
+
+# The ANSI colors of messages that command-line scripts use
+use constant COLOR_ERROR => 'red';
+use constant COLOR_SUCCESS => 'green';
+
+# The various modes that checksetup.pl can run in.
+use constant INSTALLATION_MODE_INTERACTIVE => 0;
+use constant INSTALLATION_MODE_NON_INTERACTIVE => 1;
+
+# Data about what we require for different databases.
+use constant DB_MODULE => {
+    # MySQL 5.0.15 was the first production 5.0.x release.
+    'mysql' => {db => 'Bugzilla::DB::Mysql', db_version => '5.0.15',
+                dbd => { 
+                    package => 'DBD-mysql',
+                    module  => 'DBD::mysql',
+                    # Disallow development versions
+                    blacklist => ['_'],
+                    # For UTF-8 support. 4.001 makes sure that blobs aren't
+                    # marked as UTF-8.
+                    version => '4.001',
+                },
+                name => 'MySQL'},
+    # Also see Bugzilla::DB::Pg::bz_check_server_version, which has special
+    # code to require DBD::Pg 2.17.2 for PostgreSQL 9 and above.
+    'pg'    => {db => 'Bugzilla::DB::Pg', db_version => '8.03.0000',
+                dbd => {
+                    package => 'DBD-Pg',
+                    module  => 'DBD::Pg',
+                    # 2.7.0 fixes a problem with quoting strings
+                    # containing backslashes in them.
+                    version => '2.7.0',
+                },
+                name => 'PostgreSQL'},
+     'oracle'=> {db => 'Bugzilla::DB::Oracle', db_version => '10.02.0',
+                dbd => {
+                     package => 'DBD-Oracle',
+                     module  => 'DBD::Oracle',
+                     version => '1.19',
+                },
+                name => 'Oracle'},
+     # SQLite 3.6.22 fixes a WHERE clause problem that may affect us.
+    sqlite => {db => 'Bugzilla::DB::Sqlite', db_version => '3.6.22',
+               dbd => {
+                   package => 'DBD-SQLite',
+                   module  => 'DBD::SQLite',
+                   # 1.29 is the version that contains 3.6.22.
+                   version => '1.29',
+               },
+               name => 'SQLite'},
+};
+
+# True if we're on Win32.
+use constant ON_WINDOWS => ($^O =~ /MSWin32/i) ? 1 : 0;
+# True if we're using ActiveState Perl (as opposed to Strawberry) on Windows.
+use constant ON_ACTIVESTATE => eval { &Win32::BuildNumber };
+
+# The user who should be considered "root" when we're giving
+# instructions to Bugzilla administrators.
+use constant ROOT_USER => ON_WINDOWS ? 'Administrator' : 'root';
+
+use constant MIN_SMALLINT => -32768;
+use constant MAX_SMALLINT => 32767;
+use constant MAX_INT_32 => 2147483647;
+
+# The longest that a saved search name can be.
+use constant MAX_LEN_QUERY_NAME => 64;
+
+# The longest classification name allowed.
+use constant MAX_CLASSIFICATION_SIZE => 64;
+
+# The longest product name allowed.
+use constant MAX_PRODUCT_SIZE => 64;
+
+# The longest milestone name allowed.
+use constant MAX_MILESTONE_SIZE => 64;
+
+# The longest component name allowed.
+use constant MAX_COMPONENT_SIZE => 64;
+
+# The maximum length for values of <select> fields.
+use constant MAX_FIELD_VALUE_SIZE => 64;
+
+# The maximum length for the long description of fields.
+use constant MAX_FIELD_LONG_DESC_LENGTH => 255;
+
+# Maximum length allowed for free text fields.
+use constant MAX_FREETEXT_LENGTH => 255;
+
+# The longest a bug URL in a BUG_URLS field can be.
+use constant MAX_BUG_URL_LENGTH => 255;
+
+# The largest number of possible duplicates that Bug::possible_duplicates
+# will return.
+use constant MAX_POSSIBLE_DUPLICATES => 25;
+
+# Maximum length of filename stored in attachments table (longer ones will
+# be truncated to this value). Do not increase above 255 without making the
+# necessary schema changes to store longer names.
+use constant MAX_ATTACH_FILENAME_LENGTH => 255;
+
+# Maximum length of a quip.
+use constant MAX_QUIP_LENGTH => 512;
+
+# This is the name of the algorithm used to hash passwords before storing
+# them in the database. This can be any string that is valid to pass to
+# Perl's "Digest" module. Note that if you change this, it won't take
+# effect until a user changes his password.
+use constant PASSWORD_DIGEST_ALGORITHM => 'SHA-256';
+# How long of a salt should we use? Note that if you change this, none
+# of your users will be able to log in until they reset their passwords.
+use constant PASSWORD_SALT_LENGTH => 8;
+
+# Certain scripts redirect to GET even if the form was submitted originally
+# via POST such as buglist.cgi. This value determines whether the redirect
+# can be safely done or not based on the web server's URI length setting.
+# See http://support.microsoft.com/kb/208427 for why MSIE is different
+use constant CGI_URI_LIMIT => ($ENV{'HTTP_USER_AGENT'} || '') =~ /MSIE/ ? 2083 : 8000;
+
+# If the user isn't allowed to change a field, we must tell him who can.
+# We store the required permission set into the $PrivilegesRequired
+# variable which gets passed to the error template.
+
+use constant PRIVILEGES_REQUIRED_NONE      => 0;
+use constant PRIVILEGES_REQUIRED_REPORTER  => 1;
+use constant PRIVILEGES_REQUIRED_ASSIGNEE  => 2;
+use constant PRIVILEGES_REQUIRED_EMPOWERED => 3;
+
+# Special field values used in the audit_log table to mean either
+# "we just created this object" or "we just deleted this object".
+use constant AUDIT_CREATE => '__create__';
+use constant AUDIT_REMOVE => '__remove__';
+
+sub bz_locations {
+    # We know that Bugzilla/Constants.pm must be in %INC at this point.
+    # So the only question is, what's the name of the directory
+    # above it? This is the most reliable way to get our current working
+    # directory under both mod_cgi and mod_perl. We call dirname twice
+    # to get the name of the directory above the "Bugzilla/" directory.
+    #
+    # Calling dirname twice like that won't work on VMS or AmigaOS
+    # but I doubt anybody runs Bugzilla on those.
+    #
+    # On mod_cgi this will be a relative path. On mod_perl it will be an
+    # absolute path.
+    my $libpath = dirname(dirname($INC{'Bugzilla/Constants.pm'}));
+    # We have to detaint $libpath, but we can't use Bugzilla::Util here.
+    $libpath =~ /(.*)/;
+    $libpath = $1;
+
+    my ($project, $localconfig, $datadir);
+    if ($ENV{'PROJECT'} && $ENV{'PROJECT'} =~ /^(\w+)$/) {
+        $project = $1;
+        $localconfig = "localconfig.$project";
+        $datadir = "data/$project";
+    } else {
+        $localconfig = "localconfig";
+        $datadir = "data";
+    }
+
+    $datadir = "$libpath/$datadir";
+    # We have to return absolute paths for mod_perl. 
+    # That means that if you modify these paths, they must be absolute paths.
+    return {
+        'libpath'     => $libpath,
+        'ext_libpath' => "$libpath/lib",
+        # If you put the libraries in a different location than the CGIs,
+        # make sure this still points to the CGIs.
+        'cgi_path'    => $libpath,
+        'templatedir' => "$libpath/template",
+        'template_cache' => "$datadir/template",
+        'project'     => $project,
+        'localconfig' => "$libpath/$localconfig",
+        'datadir'     => $datadir,
+        'attachdir'   => "$datadir/attachments",
+        'skinsdir'    => "$libpath/skins",
+        'graphsdir'   => "$libpath/graphs",
+        # $webdotdir must be in the web server's tree somewhere. Even if you use a 
+        # local dot, we output images to there. Also, if $webdotdir is 
+        # not relative to the bugzilla root directory, you'll need to 
+        # change showdependencygraph.cgi to set image_url to the correct 
+        # location.
+        # The script should really generate these graphs directly...
+        'webdotdir'   => "$datadir/webdot",
+        'extensionsdir' => "$libpath/extensions",
+    };
+}
+
+# This makes us not re-compute all the bz_locations data every time it's
+# called.
+BEGIN { memoize('bz_locations') };
+
+1;

diff --git a/Bugzilla/DB.pm b/Bugzilla/DB.pm
new file mode 100644 (file)
index 0000000..cf828d7
--- /dev/null
+++ b/Bugzilla/DB.pm
@@ -0,0 +1,2684 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::DB;
+
+use strict;
+
+use DBI;
+
+# Inherit the DB class from DBI::db.
+use base qw(DBI::db);
+
+use Bugzilla::Constants;
+use Bugzilla::Install::Requirements;
+use Bugzilla::Install::Util qw(vers_cmp install_string);
+use Bugzilla::Install::Localconfig;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::DB::Schema;
+
+use List::Util qw(max);
+use Storable qw(dclone);
+
+#####################################################################
+# Constants
+#####################################################################
+
+use constant BLOB_TYPE => DBI::SQL_BLOB;
+use constant ISOLATION_LEVEL => 'REPEATABLE READ';
+
+# Set default values for what used to be the enum types.  These values
+# are no longer stored in localconfig.  If we are upgrading from a
+# Bugzilla with enums to a Bugzilla without enums, we use the
+# enum values.
+#
+# The values that you see here are ONLY DEFAULTS. They are only used
+# the FIRST time you run checksetup.pl, IF you are NOT upgrading from a
+# Bugzilla with enums. After that, they are either controlled through
+# the Bugzilla UI or through the DB.
+use constant ENUM_DEFAULTS => {
+    bug_severity  => ['blocker', 'critical', 'major', 'normal',
+                      'minor', 'trivial', 'enhancement'],
+    priority     => ["Highest", "High", "Normal", "Low", "Lowest", "---"],
+    op_sys       => ["All","Windows","Mac OS","Linux","Other"],
+    rep_platform => ["All","PC","Macintosh","Other"],
+    bug_status   => ["UNCONFIRMED","CONFIRMED","IN_PROGRESS","RESOLVED",
+                     "VERIFIED"],
+    resolution   => ["","FIXED","INVALID","WONTFIX", "DUPLICATE","WORKSFORME"],
+};
+
+# The character that means "OR" in a boolean fulltext search. If empty,
+# the database doesn't support OR searches in fulltext searches.
+# Used by Bugzilla::Bug::possible_duplicates.
+use constant FULLTEXT_OR => '';
+
+# These are used in regular expressions to mean "the start or end of a word".
+#
+# We don't use [[:<:]] and [[:>:]], even though they mean
+# "start and end of a word" and are supported by both MySQL and PostgreSQL,
+# because they don't work if your search starts or ends with a non-alphanumeric
+# character, and there's a fair chance somebody will want to use the "word"
+# search to search flags for something like "review+".
+#
+# We do use [:almum:] because it is supported by at least MySQL and
+# PostgreSQL, and hopefully will get us as much Unicode support as possible,
+# depending on how well the regexp engines of the various databases support
+# Unicode.
+use constant WORD_START => '(^|[^[:alnum:]])';
+use constant WORD_END   => '($|[^[:alnum:]])';
+
+# On most databases, in order to drop an index, you have to first drop
+# the foreign keys that use that index. However, on some databases,
+# dropping the FK immediately before dropping the index causes problems
+# and doesn't need to be done anyway, so those DBs set this to 0.
+use constant INDEX_DROPS_REQUIRE_FK_DROPS => 1;
+
+#####################################################################
+# Overridden Superclass Methods 
+#####################################################################
+
+sub quote {
+    my $self = shift;
+    my $retval = $self->SUPER::quote(@_);
+    trick_taint($retval) if defined $retval;
+    return $retval;
+}
+
+#####################################################################
+# Connection Methods
+#####################################################################
+
+sub connect_shadow {
+    my $params = Bugzilla->params;
+    die "Tried to connect to non-existent shadowdb" 
+        unless $params->{'shadowdb'};
+
+    # Instead of just passing in a new hashref, we locally modify the
+    # values of "localconfig", because some drivers access it while
+    # connecting.
+    my %connect_params = %{ Bugzilla->localconfig };
+    $connect_params{db_host} = $params->{'shadowdbhost'};
+    $connect_params{db_name} = $params->{'shadowdb'};
+    $connect_params{db_port} = $params->{'shadowdbport'};
+    $connect_params{db_sock} = $params->{'shadowdbsock'};
+
+    return _connect(\%connect_params);
+}
+
+sub connect_main {
+    my $lc = Bugzilla->localconfig;
+    return _connect(Bugzilla->localconfig); 
+}
+
+sub _connect {
+    my ($params) = @_;
+
+    my $driver = $params->{db_driver};
+    my $pkg_module = DB_MODULE->{lc($driver)}->{db};
+
+    # do the actual import
+    eval ("require $pkg_module")
+        || die ("'$driver' is not a valid choice for \$db_driver in "
+                . " localconfig: " . $@);
+
+    # instantiate the correct DB specific module
+    my $dbh = $pkg_module->new($params);
+
+    return $dbh;
+}
+
+sub _handle_error {
+    require Carp;
+
+    # Cut down the error string to a reasonable size
+    $_[0] = substr($_[0], 0, 2000) . ' ... ' . substr($_[0], -2000)
+        if length($_[0]) > 4000;
+    $_[0] = Carp::longmess($_[0]);
+    return 0; # Now let DBI handle raising the error
+}
+
+sub bz_check_requirements {
+    my ($output) = @_;
+
+    my $lc = Bugzilla->localconfig;
+    my $db = DB_MODULE->{lc($lc->{db_driver})};
+
+    # Only certain values are allowed for $db_driver.
+    if (!defined $db) {
+        die "$lc->{db_driver} is not a valid choice for \$db_driver in"
+            . bz_locations()->{'localconfig'};
+    }
+
+    # Check the existence and version of the DBD that we need.
+    my $dbd = $db->{dbd};
+    _bz_check_dbd($db, $output);
+
+    # We don't try to connect to the actual database if $db_check is
+    # disabled.
+    unless ($lc->{db_check}) {
+        print "\n" if $output;
+        return;
+    }
+
+    # And now check the version of the database server itself.
+    my $dbh = _get_no_db_connection();
+    $dbh->bz_check_server_version($db, $output);
+
+    print "\n" if $output;
+}
+
+sub _bz_check_dbd {
+    my ($db, $output) = @_;
+
+    my $dbd = $db->{dbd};
+    unless (have_vers($dbd, $output)) {
+        my $sql_server = $db->{name};
+        my $command = install_command($dbd);
+        my $root    = ROOT_USER;
+        my $dbd_mod = $dbd->{module};
+        my $dbd_ver = $dbd->{version};
+        die <<EOT;
+
+For $sql_server, Bugzilla requires that perl's $dbd_mod $dbd_ver or later be
+installed. To install this module, run the following command (as $root):
+
+    $command
+
+EOT
+    }
+}
+
+sub bz_check_server_version {
+    my ($self, $db, $output) = @_;
+
+    my $sql_vers = $self->bz_server_version;
+    $self->disconnect;
+
+    my $sql_want = $db->{db_version};
+    my $version_ok = vers_cmp($sql_vers, $sql_want) > -1 ? 1 : 0;
+
+    my $sql_server = $db->{name};
+    if ($output) {
+        Bugzilla::Install::Requirements::_checking_for({
+            package => $sql_server, wanted => $sql_want,
+            found   => $sql_vers, ok => $version_ok });
+    }
+
+    # Check what version of the database server is installed and let
+    # the user know if the version is too old to be used with Bugzilla.
+    if (!$version_ok) {
+        die <<EOT;
+
+Your $sql_server v$sql_vers is too old. Bugzilla requires version
+$sql_want or later of $sql_server. Please download and install a
+newer version.
+
+EOT
+    }
+
+    # This is used by subclasses.
+    return $sql_vers;
+}
+
+# Note that this function requires that localconfig exist and
+# be valid.
+sub bz_create_database {
+    my $dbh;
+    # See if we can connect to the actual Bugzilla database.
+    my $conn_success = eval { $dbh = connect_main() };
+    my $db_name = Bugzilla->localconfig->{db_name};
+
+    if (!$conn_success) {
+        $dbh = _get_no_db_connection();
+        say "Creating database $db_name...";
+
+        # Try to create the DB, and if we fail print a friendly error.
+        my $success  = eval {
+            my @sql = $dbh->_bz_schema->get_create_database_sql($db_name);
+            # This ends with 1 because this particular do doesn't always
+            # return something.
+            $dbh->do($_) foreach @sql; 1;
+        };
+        if (!$success) {
+            my $error = $dbh->errstr || $@;
+            chomp($error);
+            die "The '$db_name' database could not be created.",
+                " The error returned was:\n\n    $error\n\n",
+                _bz_connect_error_reasons();
+        }
+    }
+
+    $dbh->disconnect;
+}
+
+# A helper for bz_create_database and bz_check_requirements.
+sub _get_no_db_connection {
+    my ($sql_server) = @_;
+    my $dbh;
+    my %connect_params = %{ Bugzilla->localconfig };
+    $connect_params{db_name} = '';
+    my $conn_success = eval {
+        $dbh = _connect(\%connect_params);
+    };
+    if (!$conn_success) {
+        my $driver = $connect_params{db_driver};
+        my $sql_server = DB_MODULE->{lc($driver)}->{name};
+        # Can't use $dbh->errstr because $dbh is undef.
+        my $error = $DBI::errstr || $@;
+        chomp($error);
+        die "There was an error connecting to $sql_server:\n\n",
+            "    $error\n\n", _bz_connect_error_reasons(), "\n";
+    }
+    return $dbh;    
+}
+
+# Just a helper because we have to re-use this text.
+# We don't use this in db_new because it gives away the database
+# username, and db_new errors can show up on CGIs.
+sub _bz_connect_error_reasons {
+    my $lc_file = bz_locations()->{'localconfig'};
+    my $lc      = Bugzilla->localconfig;
+    my $db      = DB_MODULE->{lc($lc->{db_driver})};
+    my $server  = $db->{name};
+
+return <<EOT;
+This might have several reasons:
+
+* $server is not running.
+* $server is running, but there is a problem either in the
+  server configuration or the database access rights. Read the Bugzilla
+  Guide in the doc directory. The section about database configuration
+  should help.
+* Your password for the '$lc->{db_user}' user, specified in \$db_pass, is 
+  incorrect, in '$lc_file'.
+* There is a subtle problem with Perl, DBI, or $server. Make
+  sure all settings in '$lc_file' are correct. If all else fails, set
+  '\$db_check' to 0.
+
+EOT
+}
+
+# List of abstract methods we are checking the derived class implements
+our @_abstract_methods = qw(new sql_regexp sql_not_regexp sql_limit sql_to_days
+                            sql_date_format sql_date_math bz_explain
+                            sql_group_concat);
+
+# This overridden import method will check implementation of inherited classes
+# for missing implementation of abstract methods
+# See http://perlmonks.thepen.com/44265.html
+sub import {
+    my $pkg = shift;
+
+    # do not check this module
+    if ($pkg ne __PACKAGE__) {
+        # make sure all abstract methods are implemented
+        foreach my $meth (@_abstract_methods) {
+            $pkg->can($meth)
+                or die("Class $pkg does not define method $meth");
+        }
+    }
+
+    # Now we want to call our superclass implementation.
+    # If our superclass is Exporter, which is using caller() to find
+    # a namespace to populate, we need to adjust for this extra call.
+    # All this can go when we stop using deprecated functions.
+    my $is_exporter = $pkg->isa('Exporter');
+    $Exporter::ExportLevel++ if $is_exporter;
+    $pkg->SUPER::import(@_);
+    $Exporter::ExportLevel-- if $is_exporter;
+}
+
+sub sql_istrcmp {
+    my ($self, $left, $right, $op) = @_;
+    $op ||= "=";
+
+    return $self->sql_istring($left) . " $op " . $self->sql_istring($right);
+}
+
+sub sql_istring {
+    my ($self, $string) = @_;
+
+    return "LOWER($string)";
+}
+
+sub sql_iposition {
+    my ($self, $fragment, $text) = @_;
+    $fragment = $self->sql_istring($fragment);
+    $text = $self->sql_istring($text);
+    return $self->sql_position($fragment, $text);
+}
+
+sub sql_position {
+    my ($self, $fragment, $text) = @_;
+
+    return "POSITION($fragment IN $text)";
+}
+
+sub sql_group_by {
+    my ($self, $needed_columns, $optional_columns) = @_;
+
+    my $expression = "GROUP BY $needed_columns";
+    $expression .= ", " . $optional_columns if $optional_columns;
+    
+    return $expression;
+}
+
+sub sql_string_concat {
+    my ($self, @params) = @_;
+    
+    return '(' . join(' || ', @params) . ')';
+}
+
+sub sql_string_until {
+    my ($self, $string, $substring) = @_;
+
+    my $position = $self->sql_position($substring, $string);
+    return "CASE WHEN $position != 0"
+             . " THEN SUBSTR($string, 1, $position - 1)"
+             . " ELSE $string END";
+}
+
+sub sql_in {
+    my ($self, $column_name, $in_list_ref, $negate) = @_;
+    return " $column_name "
+             . ($negate ? "NOT " : "")
+             . "IN (" . join(',', @$in_list_ref) . ") ";
+}
+
+sub sql_fulltext_search {
+    my ($self, $column, $text) = @_;
+
+    # This is as close as we can get to doing full text search using
+    # standard ANSI SQL, without real full text search support. DB specific
+    # modules should override this, as this will be always much slower.
+
+    # make the string lowercase to do case insensitive search
+    my $lower_text = lc($text);
+
+    # split the text we're searching for into separate words. As a hack
+    # to allow quicksearch to work, if the field starts and ends with
+    # a double-quote, then we don't split it into words. We can't use
+    # Text::ParseWords here because it gets very confused by unbalanced
+    # quotes, which breaks searches like "don't try this" (because of the
+    # unbalanced single-quote in "don't").
+    my @words;
+    if ($lower_text =~ /^"/ and $lower_text =~ /"$/) {
+        $lower_text =~ s/^"//;
+        $lower_text =~ s/"$//;
+        @words = ($lower_text);
+    }
+    else {
+        @words = split(/\s+/, $lower_text);
+    }
+
+    # surround the words with wildcards and SQL quotes so we can use them
+    # in LIKE search clauses
+    @words = map($self->quote("\%$_\%"), @words);
+
+    # untaint words, since they are safe to use now that we've quoted them
+    trick_taint($_) foreach @words;
+
+    # turn the words into a set of LIKE search clauses
+    @words = map("LOWER($column) LIKE $_", @words);
+
+    # search for occurrences of all specified words in the column
+    return join (" AND ", @words), "CASE WHEN (" . join(" AND ", @words) . ") THEN 1 ELSE 0 END";
+}
+
+#####################################################################
+# General Info Methods
+#####################################################################
+
+# XXX - Needs to be documented.
+sub bz_server_version {
+    my ($self) = @_;
+    return $self->get_info(18); # SQL_DBMS_VER
+}
+
+sub bz_last_key {
+    my ($self, $table, $column) = @_;
+
+    return $self->last_insert_id(Bugzilla->localconfig->{db_name}, undef, 
+                                 $table, $column);
+}
+
+sub bz_check_regexp {
+    my ($self, $pattern) = @_;
+
+    eval { $self->do("SELECT " . $self->sql_regexp($self->quote("a"), $pattern, 1)) };
+
+    $@ && ThrowUserError('illegal_regexp', 
+        { value => $pattern, dberror => $self->errstr }); 
+}
+
+#####################################################################
+# Database Setup
+#####################################################################
+
+sub bz_setup_database {
+    my ($self) = @_;
+
+    # If we haven't ever stored a serialized schema,
+    # set up the bz_schema table and store it.
+    $self->_bz_init_schema_storage();
+   
+    # We don't use bz_table_list here, because that uses _bz_real_schema.
+    # We actually want the table list from the ABSTRACT_SCHEMA in
+    # Bugzilla::DB::Schema.
+    my @desired_tables = $self->_bz_schema->get_table_list();
+    my $bugs_exists = $self->bz_table_info('bugs');
+    if (!$bugs_exists) {
+        say install_string('db_table_setup');
+    }
+
+    foreach my $table_name (@desired_tables) {
+        $self->bz_add_table($table_name, { silently => !$bugs_exists });
+    }
+}
+
+# This really just exists to get overridden in Bugzilla::DB::Mysql.
+sub bz_enum_initial_values {
+    return ENUM_DEFAULTS;
+}
+
+sub bz_populate_enum_tables {
+    my ($self) = @_; 
+
+    my $any_severities = $self->selectrow_array(
+        'SELECT 1 FROM bug_severity ' . $self->sql_limit(1));
+    print install_string('db_enum_setup'), "\n  " if !$any_severities;
+
+    my $enum_values = $self->bz_enum_initial_values();
+    while (my ($table, $values) = each %$enum_values) {
+        $self->_bz_populate_enum_table($table, $values);
+    }
+
+    print "\n" if !$any_severities;
+}
+
+sub bz_setup_foreign_keys {
+    my ($self) = @_;
+
+    # profiles_activity was the first table to get foreign keys,
+    # so if it doesn't have them, then we're setting up FKs
+    # for the first time, and should be quieter about it.
+    my $activity_fk = $self->bz_fk_info('profiles_activity', 'userid');
+    my $any_fks = $activity_fk && $activity_fk->{created};
+    if (!$any_fks) {
+        say get_text('install_fk_setup');
+    }
+
+    my @tables = $self->bz_table_list();
+    foreach my $table (@tables) {
+        my @columns = $self->bz_table_columns($table);
+        my %add_fks;
+        foreach my $column (@columns) {
+            # First we check for any FKs that have created => 0,
+            # in the _bz_real_schema. This also picks up FKs with
+            # created => 1, but bz_add_fks will ignore those.
+            my $fk = $self->bz_fk_info($table, $column);
+            # Then we check the abstract schema to see if there
+            # should be an FK on this column, but one wasn't set in the
+            # _bz_real_schema for some reason. We do this to handle
+            # various problems caused by upgrading from versions
+            # prior to 4.2, and also to handle problems caused
+            # by enabling an extension pre-4.2, disabling it for
+            # the 4.2 upgrade, and then re-enabling it later.
+            unless ($fk && $fk->{created}) {
+                my $standard_def = 
+                    $self->_bz_schema->get_column_abstract($table, $column);
+                if (exists $standard_def->{REFERENCES}) {
+                    $fk = dclone($standard_def->{REFERENCES});
+                }
+            }
+
+            $add_fks{$column} = $fk if $fk;
+        }
+        $self->bz_add_fks($table, \%add_fks, { silently => !$any_fks });
+    }
+}
+
+# This is used by contrib/bzdbcopy.pl, mostly.
+sub bz_drop_foreign_keys {
+    my ($self) = @_;
+
+    my @tables = $self->bz_table_list();
+    foreach my $table (@tables) {
+        my @columns = $self->bz_table_columns($table);
+        foreach my $column (@columns) {
+            $self->bz_drop_fk($table, $column);
+        }
+    }
+}
+
+#####################################################################
+# Schema Modification Methods
+#####################################################################
+
+sub bz_add_column {
+    my ($self, $table, $name, $new_def, $init_value) = @_;
+
+    # You can't add a NOT NULL column to a table with
+    # no DEFAULT statement, unless you have an init_value.
+    # SERIAL types are an exception, though, because they can
+    # auto-populate.
+    if ( $new_def->{NOTNULL} && !exists $new_def->{DEFAULT} 
+         && !defined $init_value && $new_def->{TYPE} !~ /SERIAL/)
+    {
+        ThrowCodeError('column_not_null_without_default',
+                       { name => "$table.$name" });
+    }
+
+    my $current_def = $self->bz_column_info($table, $name);
+
+    if (!$current_def) {
+        my @statements = $self->_bz_real_schema->get_add_column_ddl(
+            $table, $name, $new_def, 
+            defined $init_value ? $self->quote($init_value) : undef);
+        print get_text('install_column_add',
+                       { column => $name, table => $table }) . "\n"
+            if Bugzilla->usage_mode == USAGE_MODE_CMDLINE;
+        foreach my $sql (@statements) {
+            $self->do($sql);
+        }
+
+        # To make things easier for callers, if they don't specify
+        # a REFERENCES item, we pull it from the _bz_schema if the
+        # column exists there and has a REFERENCES item.
+        # bz_setup_foreign_keys will then add this FK at the end of
+        # Install::DB.
+        my $col_abstract = 
+            $self->_bz_schema->get_column_abstract($table, $name);
+        if (exists $col_abstract->{REFERENCES}) {
+            my $new_fk = dclone($col_abstract->{REFERENCES});
+            $new_fk->{created} = 0;
+            $new_def->{REFERENCES} = $new_fk;
+        }
+        
+        $self->_bz_real_schema->set_column($table, $name, $new_def);
+        $self->_bz_store_real_schema;
+    }
+}
+
+sub bz_add_fk {
+    my ($self, $table, $column, $def) = @_;
+    $self->bz_add_fks($table, { $column => $def });
+}
+
+sub bz_add_fks {
+    my ($self, $table, $column_fks, $options) = @_;
+
+    my %add_these;
+    foreach my $column (keys %$column_fks) {
+        my $current_fk = $self->bz_fk_info($table, $column);
+        next if ($current_fk and $current_fk->{created});
+        my $new_fk = $column_fks->{$column};
+        $self->_check_references($table, $column, $new_fk);
+        $add_these{$column} = $new_fk;
+        if (Bugzilla->usage_mode == USAGE_MODE_CMDLINE 
+            and !$options->{silently}) 
+        {
+            print get_text('install_fk_add',
+                           { table => $table, column => $column, 
+                             fk    => $new_fk }), "\n";
+        }
+    }
+
+    return if !scalar(keys %add_these);
+
+    my @sql = $self->_bz_real_schema->get_add_fks_sql($table, \%add_these);
+    $self->do($_) foreach @sql;
+
+    foreach my $column (keys %add_these) {
+        my $fk_def = $add_these{$column};
+        $fk_def->{created} = 1;
+        $self->_bz_real_schema->set_fk($table, $column, $fk_def);
+    }
+
+    $self->_bz_store_real_schema();
+}
+
+sub bz_alter_column {
+    my ($self, $table, $name, $new_def, $set_nulls_to) = @_;
+
+    my $current_def = $self->bz_column_info($table, $name);
+
+    if (!$self->_bz_schema->columns_equal($current_def, $new_def)) {
+        # You can't change a column to be NOT NULL if you have no DEFAULT
+        # and no value for $set_nulls_to, if there are any NULL values 
+        # in that column.
+        if ($new_def->{NOTNULL} && 
+            !exists $new_def->{DEFAULT} && !defined $set_nulls_to)
+        {
+            # Check for NULLs
+            my $any_nulls = $self->selectrow_array(
+                "SELECT 1 FROM $table WHERE $name IS NULL");
+            ThrowCodeError('column_not_null_no_default_alter', 
+                           { name => "$table.$name" }) if ($any_nulls);
+        }
+        # Preserve foreign key definitions in the Schema object when altering
+        # types.
+        if (my $fk = $self->bz_fk_info($table, $name)) {
+            $new_def->{REFERENCES} = $fk;
+        }
+        $self->bz_alter_column_raw($table, $name, $new_def, $current_def,
+                                   $set_nulls_to);
+        $self->_bz_real_schema->set_column($table, $name, $new_def);
+        $self->_bz_store_real_schema;
+    }
+}
+
+
+# bz_alter_column_raw($table, $name, $new_def, $current_def)
+#
+# Description: A helper function for bz_alter_column.
+#              Alters a column in the database
+#              without updating any Schema object. Generally
+#              should only be called by bz_alter_column.
+#              Used when either: (1) You don't yet have a Schema
+#              object but you need to alter a column, for some reason.
+#              (2) You need to alter a column for some database-specific
+#              reason.
+# Params:      $table   - The name of the table the column is on.
+#              $name    - The name of the column you're changing.
+#              $new_def - The abstract definition that you are changing
+#                         this column to.
+#              $current_def - (optional) The current definition of the
+#                             column. Will be used in the output message,
+#                             if given.
+#              $set_nulls_to - The same as the param of the same name
+#                              from bz_alter_column.
+# Returns:     nothing
+#
+sub bz_alter_column_raw {
+    my ($self, $table, $name, $new_def, $current_def, $set_nulls_to) = @_;
+    my @statements = $self->_bz_real_schema->get_alter_column_ddl(
+        $table, $name, $new_def,
+        defined $set_nulls_to ? $self->quote($set_nulls_to) : undef);
+    my $new_ddl = $self->_bz_schema->get_type_ddl($new_def);
+    say "Updating column $name in table $table ...";
+    if (defined $current_def) {
+        my $old_ddl = $self->_bz_schema->get_type_ddl($current_def);
+        say "Old: $old_ddl";
+    }
+    say "New: $new_ddl";
+    $self->do($_) foreach (@statements);
+}
+
+sub bz_alter_fk {
+    my ($self, $table, $column, $fk_def) = @_;
+    my $current_fk = $self->bz_fk_info($table, $column);
+    ThrowCodeError('column_alter_nonexistent_fk',
+                   { table => $table, column => $column }) if !$current_fk;
+    $self->bz_drop_fk($table, $column);
+    $self->bz_add_fk($table, $column, $fk_def);
+}
+
+sub bz_add_index {
+    my ($self, $table, $name, $definition) = @_;
+
+    my $index_exists = $self->bz_index_info($table, $name);
+
+    if (!$index_exists) {
+        $self->bz_add_index_raw($table, $name, $definition);
+        $self->_bz_real_schema->set_index($table, $name, $definition);
+        $self->_bz_store_real_schema;
+    }
+}
+
+# bz_add_index_raw($table, $name, $silent)
+#
+# Description: A helper function for bz_add_index.
+#              Adds an index to the database
+#              without updating any Schema object. Generally
+#              should only be called by bz_add_index.
+#              Used when you don't yet have a Schema
+#              object but you need to add an index, for some reason.
+# Params:      $table  - The name of the table the index is on.
+#              $name   - The name of the index you're adding.
+#              $definition - The abstract index definition, in hashref
+#                            or arrayref format.
+#              $silent - (optional) If specified and true, don't output
+#                        any message about this change.
+# Returns:     nothing
+#
+sub bz_add_index_raw {
+    my ($self, $table, $name, $definition, $silent) = @_;
+    my @statements = $self->_bz_schema->get_add_index_ddl(
+        $table, $name, $definition);
+    print "Adding new index '$name' to the $table table ...\n" unless $silent;
+    $self->do($_) foreach (@statements);
+}
+
+sub bz_add_table {
+    my ($self, $name, $options) = @_;
+
+    my $table_exists = $self->bz_table_info($name);
+
+    if (!$table_exists) {
+        $self->_bz_add_table_raw($name, $options);
+        my $table_def = dclone($self->_bz_schema->get_table_abstract($name));
+
+        my %fields = @{$table_def->{FIELDS}};
+        foreach my $col (keys %fields) {
+            # Foreign Key references have to be added by Install::DB after
+            # initial table creation, because column names have changed
+            # over history and it's impossible to keep track of that info
+            # in ABSTRACT_SCHEMA.
+            next unless exists $fields{$col}->{REFERENCES};
+            $fields{$col}->{REFERENCES}->{created} =
+                $self->_bz_real_schema->FK_ON_CREATE;
+        }
+        
+        $self->_bz_real_schema->add_table($name, $table_def);
+        $self->_bz_store_real_schema;
+    }
+}
+
+# _bz_add_table_raw($name) - Private
+#
+# Description: A helper function for bz_add_table.
+#              Creates a table in the database without
+#              updating any Schema object. Generally
+#              should only be called by bz_add_table and by
+#              _bz_init_schema_storage. Used when you don't
+#              yet have a Schema object but you need to
+#              add a table, for some reason.
+# Params:      $name - The name of the table you're creating. 
+#                  The definition for the table is pulled from 
+#                  _bz_schema.
+# Returns:     nothing
+#
+sub _bz_add_table_raw {
+    my ($self, $name, $options) = @_;
+    my @statements = $self->_bz_schema->get_table_ddl($name);
+    if (Bugzilla->usage_mode == USAGE_MODE_CMDLINE
+        and !$options->{silently})
+    {
+        say install_string('db_table_new', { table => $name });
+    }
+    $self->do($_) foreach (@statements);
+}
+
+sub _bz_add_field_table {
+    my ($self, $name, $schema_ref) = @_;
+    # We do nothing if the table already exists.
+    return if $self->bz_table_info($name);
+
+    # Copy this so that we're not modifying the passed reference.
+    # (This avoids modifying a constant in Bugzilla::DB::Schema.)
+    my %table_schema = %$schema_ref;
+    my %indexes = @{ $table_schema{INDEXES} };
+    my %fixed_indexes;
+    foreach my $key (keys %indexes) {
+        $fixed_indexes{$name . "_" . $key} = $indexes{$key};
+    }
+    # INDEXES is supposed to be an arrayref, so we have to convert back.
+    my @indexes_array = %fixed_indexes;
+    $table_schema{INDEXES} = \@indexes_array;
+    # We add this to the abstract schema so that bz_add_table can find it.
+    $self->_bz_schema->add_table($name, \%table_schema);
+    $self->bz_add_table($name);
+}
+
+sub bz_add_field_tables {
+    my ($self, $field) = @_;
+    
+    $self->_bz_add_field_table($field->name,
+                               $self->_bz_schema->FIELD_TABLE_SCHEMA, $field->type);
+    if ($field->type == FIELD_TYPE_MULTI_SELECT) {
+        my $ms_table = "bug_" . $field->name;
+        $self->_bz_add_field_table($ms_table,
+            $self->_bz_schema->MULTI_SELECT_VALUE_TABLE);
+
+        $self->bz_add_fks($ms_table, 
+            { bug_id => {TABLE => 'bugs', COLUMN => 'bug_id',
+                         DELETE => 'CASCADE'},
+
+              value  => {TABLE  => $field->name, COLUMN => 'value'} });
+    }
+}
+
+sub bz_drop_field_tables {
+    my ($self, $field) = @_;
+    if ($field->type == FIELD_TYPE_MULTI_SELECT) {
+        $self->bz_drop_table('bug_' . $field->name);
+    }
+    $self->bz_drop_table($field->name);
+}
+
+sub bz_drop_column {
+    my ($self, $table, $column) = @_;
+
+    my $current_def = $self->bz_column_info($table, $column);
+
+    if ($current_def) {
+        my @statements = $self->_bz_real_schema->get_drop_column_ddl(
+            $table, $column);
+        print get_text('install_column_drop', 
+                       { table => $table, column => $column }) . "\n"
+            if Bugzilla->usage_mode == USAGE_MODE_CMDLINE;
+        foreach my $sql (@statements) {
+            # Because this is a deletion, we don't want to die hard if
+            # we fail because of some local customization. If something
+            # is already gone, that's fine with us!
+            eval { $self->do($sql); } or warn "Failed SQL: [$sql] Error: $@";
+        }
+        $self->_bz_real_schema->delete_column($table, $column);
+        $self->_bz_store_real_schema;
+    }
+}
+
+sub bz_drop_fk {
+    my ($self, $table, $column) = @_;
+
+    my $fk_def = $self->bz_fk_info($table, $column);
+    if ($fk_def and $fk_def->{created}) {
+        print get_text('install_fk_drop',
+                       { table => $table, column => $column, fk => $fk_def })
+            . "\n" if Bugzilla->usage_mode == USAGE_MODE_CMDLINE;
+        my @statements = 
+            $self->_bz_real_schema->get_drop_fk_sql($table, $column, $fk_def);
+        foreach my $sql (@statements) {
+            # Because this is a deletion, we don't want to die hard if
+            # we fail because of some local customization. If something
+            # is already gone, that's fine with us!
+            eval { $self->do($sql); } or warn "Failed SQL: [$sql] Error: $@";
+        }
+        # Under normal circumstances, we don't permanently drop the fk--
+        # we want checksetup to re-create it again later. The only
+        # time that FKs get permanently dropped is if the column gets
+        # dropped.
+        $fk_def->{created} = 0;
+        $self->_bz_real_schema->set_fk($table, $column, $fk_def);
+        $self->_bz_store_real_schema;
+    }
+
+}
+
+sub bz_get_related_fks {
+    my ($self, $table, $column) = @_;
+    my @tables = $self->_bz_real_schema->get_table_list();
+    my @related;
+    foreach my $check_table (@tables) {
+        my @columns = $self->bz_table_columns($check_table);
+        foreach my $check_column (@columns) {
+            my $fk = $self->bz_fk_info($check_table, $check_column);
+            if ($fk 
+                and (($fk->{TABLE} eq $table and $fk->{COLUMN} eq $column)
+                     or ($check_column eq $column and $check_table eq $table)))
+            {
+                push(@related, [$check_table, $check_column, $fk]);
+            }
+        } # foreach $column
+    } # foreach $table
+
+    return \@related;
+}
+
+sub bz_drop_related_fks {
+    my $self = shift;
+    my $related = $self->bz_get_related_fks(@_);
+    foreach my $item (@$related) {
+        my ($table, $column) = @$item;
+        $self->bz_drop_fk($table, $column);
+    }
+    return $related;
+}
+
+sub bz_drop_index {
+    my ($self, $table, $name) = @_;
+
+    my $index_exists = $self->bz_index_info($table, $name);
+
+    if ($index_exists) {
+        if ($self->INDEX_DROPS_REQUIRE_FK_DROPS) {
+            # We cannot delete an index used by a FK.
+            foreach my $column (@{$index_exists->{FIELDS}}) {
+                $self->bz_drop_related_fks($table, $column);
+            }
+        }
+        $self->bz_drop_index_raw($table, $name);
+        $self->_bz_real_schema->delete_index($table, $name);
+        $self->_bz_store_real_schema;        
+    }
+}
+
+# bz_drop_index_raw($table, $name, $silent)
+#
+# Description: A helper function for bz_drop_index.
+#              Drops an index from the database
+#              without updating any Schema object. Generally
+#              should only be called by bz_drop_index.
+#              Used when either: (1) You don't yet have a Schema 
+#              object but you need to drop an index, for some reason.
+#              (2) You need to drop an index that somehow got into the
+#              database but doesn't exist in Schema.
+# Params:      $table  - The name of the table the index is on.
+#              $name   - The name of the index you're dropping.
+#              $silent - (optional) If specified and true, don't output
+#                        any message about this change.
+# Returns:     nothing
+#
+sub bz_drop_index_raw {
+    my ($self, $table, $name, $silent) = @_;
+    my @statements = $self->_bz_schema->get_drop_index_ddl(
+        $table, $name);
+    print "Removing index '$name' from the $table table...\n" unless $silent;
+    foreach my $sql (@statements) {
+        # Because this is a deletion, we don't want to die hard if
+        # we fail because of some local customization. If something
+        # is already gone, that's fine with us!
+        eval { $self->do($sql) } or warn "Failed SQL: [$sql] Error: $@";
+    }
+}
+
+sub bz_drop_table {
+    my ($self, $name) = @_;
+
+    my $table_exists = $self->bz_table_info($name);
+
+    if ($table_exists) {
+        my @statements = $self->_bz_schema->get_drop_table_ddl($name);
+        print get_text('install_table_drop', { name => $name }) . "\n"
+            if Bugzilla->usage_mode == USAGE_MODE_CMDLINE;
+        foreach my $sql (@statements) {
+            # Because this is a deletion, we don't want to die hard if
+            # we fail because of some local customization. If something
+            # is already gone, that's fine with us!
+            eval { $self->do($sql); } or warn "Failed SQL: [$sql] Error: $@";
+        }
+        $self->_bz_real_schema->delete_table($name);
+        $self->_bz_store_real_schema;
+    }
+}
+
+sub bz_fk_info {
+    my ($self, $table, $column) = @_;
+    my $col_info = $self->bz_column_info($table, $column);
+    return undef if !$col_info;
+    my $fk = $col_info->{REFERENCES};
+    return $fk;
+}
+
+sub bz_rename_column {
+    my ($self, $table, $old_name, $new_name) = @_;
+
+    my $old_col_exists  = $self->bz_column_info($table, $old_name);
+
+    if ($old_col_exists) {
+        my $already_renamed = $self->bz_column_info($table, $new_name);
+            ThrowCodeError('db_rename_conflict',
+                           { old => "$table.$old_name", 
+                             new => "$table.$new_name" }) if $already_renamed;
+        my @statements = $self->_bz_real_schema->get_rename_column_ddl(
+            $table, $old_name, $new_name);
+
+        print get_text('install_column_rename', 
+                       { old => "$table.$old_name", new => "$table.$new_name" })
+               . "\n" if Bugzilla->usage_mode == USAGE_MODE_CMDLINE;
+
+        foreach my $sql (@statements) {
+            $self->do($sql);
+        }
+        $self->_bz_real_schema->rename_column($table, $old_name, $new_name);
+        $self->_bz_store_real_schema;
+    }
+}
+
+sub bz_rename_table {
+    my ($self, $old_name, $new_name) = @_;
+    my $old_table = $self->bz_table_info($old_name);
+    return if !$old_table;
+
+    my $new = $self->bz_table_info($new_name);
+    ThrowCodeError('db_rename_conflict', { old => $old_name,
+                                           new => $new_name }) if $new;
+
+    # FKs will all have the wrong names unless we drop and then let them
+    # be re-created later. Under normal circumstances, checksetup.pl will
+    # automatically re-create these dropped FKs at the end of its DB upgrade
+    # run, so we don't need to re-create them in this method.
+    my @columns = $self->bz_table_columns($old_name);
+    foreach my $column (@columns) {
+        # these just return silently if there's no FK to drop
+        $self->bz_drop_fk($old_name, $column);
+        $self->bz_drop_related_fks($old_name, $column);
+    }
+
+    my @sql = $self->_bz_real_schema->get_rename_table_sql($old_name, $new_name);
+    print get_text('install_table_rename', 
+                   { old => $old_name, new => $new_name }) . "\n"
+        if Bugzilla->usage_mode == USAGE_MODE_CMDLINE;
+    $self->do($_) foreach @sql;
+    $self->_bz_real_schema->rename_table($old_name, $new_name);
+    $self->_bz_store_real_schema;
+}
+
+sub bz_set_next_serial_value {
+    my ($self, $table, $column, $value) = @_;
+    if (!$value) {
+        $value = $self->selectrow_array("SELECT MAX($column) FROM $table") || 0;
+        $value++;
+    }
+    my @sql = $self->_bz_real_schema->get_set_serial_sql($table, $column, $value);
+    $self->do($_) foreach @sql;
+}
+
+#####################################################################
+# Schema Information Methods
+#####################################################################
+
+sub _bz_schema {
+    my ($self) = @_;
+    return $self->{private_bz_schema} if exists $self->{private_bz_schema};
+    my @module_parts = split('::', ref $self);
+    my $module_name  = pop @module_parts;
+    $self->{private_bz_schema} = Bugzilla::DB::Schema->new($module_name);
+    return $self->{private_bz_schema};
+}
+
+# _bz_get_initial_schema()
+#
+# Description: A protected method, intended for use only by Bugzilla::DB
+#              and subclasses. Used to get the initial Schema that will
+#              be written to disk for _bz_init_schema_storage. You probably
+#              want to use _bz_schema or _bz_real_schema instead of this
+#              method.
+# Params:      none
+# Returns:     A Schema object that can be serialized and written to disk
+#              for _bz_init_schema_storage.
+sub _bz_get_initial_schema {
+    my ($self) = @_;
+    return $self->_bz_schema->get_empty_schema();
+}
+
+sub bz_column_info {
+    my ($self, $table, $column) = @_;
+    my $def = $self->_bz_real_schema->get_column_abstract($table, $column);
+    # We dclone it so callers can't modify the Schema.
+    $def = dclone($def) if defined $def;
+    return $def;
+}
+
+sub bz_index_info {
+    my ($self, $table, $index) = @_;
+    my $index_def =
+        $self->_bz_real_schema->get_index_abstract($table, $index);
+    if (ref($index_def) eq 'ARRAY') {
+        $index_def = {FIELDS => $index_def, TYPE => ''};
+    }
+    return $index_def;
+}
+
+sub bz_table_info {
+    my ($self, $table) = @_;
+    return $self->_bz_real_schema->get_table_abstract($table);
+}
+
+
+sub bz_table_columns {
+    my ($self, $table) = @_;
+    return $self->_bz_real_schema->get_table_columns($table);
+}
+
+sub bz_table_indexes {
+    my ($self, $table) = @_;
+    my $indexes = $self->_bz_real_schema->get_table_indexes_abstract($table);
+    my %return_indexes;
+    # We do this so that they're always hashes.
+    foreach my $name (keys %$indexes) {
+        $return_indexes{$name} = $self->bz_index_info($table, $name);
+    }
+    return \%return_indexes;
+}
+
+sub bz_table_list {
+    my ($self) = @_;
+    return $self->_bz_real_schema->get_table_list();
+}
+
+#####################################################################
+# Protected "Real Database" Schema Information Methods
+#####################################################################
+
+# Only Bugzilla::DB and subclasses should use these methods.
+# If you need a method that does the same thing as one of these
+# methods, use the version without _real on the end.
+
+# bz_table_columns_real($table)
+#
+# Description: Returns a list of columns on a given table
+#              as the table actually is, on the disk.
+# Params:      $table - Name of the table.
+# Returns:     An array of column names.
+#
+sub bz_table_columns_real {
+    my ($self, $table) = @_;
+    my $sth = $self->column_info(undef, undef, $table, '%');
+    return @{ $self->selectcol_arrayref($sth, {Columns => [4]}) };
+}
+
+# bz_table_list_real()
+#
+# Description: Gets a list of tables in the current
+#              database, directly from the disk.
+# Params:      none
+# Returns:     An array containing table names.
+sub bz_table_list_real {
+    my ($self) = @_;
+    my $table_sth = $self->table_info(undef, undef, undef, "TABLE");
+    return @{$self->selectcol_arrayref($table_sth, { Columns => [3] })};
+}
+
+#####################################################################
+# Transaction Methods
+#####################################################################
+
+sub bz_in_transaction {
+    return $_[0]->{private_bz_transaction_count} ? 1 : 0;
+}
+
+sub bz_start_transaction {
+    my ($self) = @_;
+
+    if ($self->bz_in_transaction) {
+        $self->{private_bz_transaction_count}++;
+    } else {
+        # Turn AutoCommit off and start a new transaction
+        $self->begin_work();
+        # REPEATABLE READ means "We work on a snapshot of the DB that
+        # is created when we execute our first SQL statement." It's
+        # what we need in Bugzilla to be safe, for what we do.
+        # Different DBs have different defaults for their isolation
+        # level, so we just set it here manually.
+        if ($self->ISOLATION_LEVEL) {
+            $self->do('SET TRANSACTION ISOLATION LEVEL ' 
+                      . $self->ISOLATION_LEVEL);
+        }
+        $self->{private_bz_transaction_count} = 1;
+    }
+}
+
+sub bz_commit_transaction {
+    my ($self) = @_;
+    
+    if ($self->{private_bz_transaction_count} > 1) {
+        $self->{private_bz_transaction_count}--;
+    } elsif ($self->bz_in_transaction) {
+        $self->commit();
+        $self->{private_bz_transaction_count} = 0;
+    } else {
+       ThrowCodeError('not_in_transaction');
+    }
+}
+
+sub bz_rollback_transaction {
+    my ($self) = @_;
+
+    # Unlike start and commit, if we rollback at any point it happens
+    # instantly, even if we're in a nested transaction.
+    if (!$self->bz_in_transaction) {
+        ThrowCodeError("not_in_transaction");
+    } else {
+        $self->rollback();
+        $self->{private_bz_transaction_count} = 0;
+    }
+}
+
+#####################################################################
+# Subclass Helpers
+#####################################################################
+
+sub db_new {
+    my ($class, $params) = @_;
+    my ($dsn, $user, $pass, $override_attrs) = 
+        @$params{qw(dsn user pass attrs)};
+
+    # set up default attributes used to connect to the database
+    # (may be overridden by DB driver implementations)
+    my $attributes = { RaiseError => 0,
+                       AutoCommit => 1,
+                       PrintError => 0,
+                       ShowErrorStatement => 1,
+                       HandleError => \&_handle_error,
+                       TaintIn => 1,
+                       FetchHashKeyName => 'NAME',  
+                       # Note: NAME_lc causes crash on ActiveState Perl
+                       # 5.8.4 (see Bug 253696)
+                       # XXX - This will likely cause problems in DB
+                       # back ends that twiddle column case (Oracle?)
+                     };
+
+    if ($override_attrs) {
+        foreach my $key (keys %$override_attrs) {
+            $attributes->{$key} = $override_attrs->{$key};
+        }
+    }
+
+    # connect using our known info to the specified db
+    my $self = DBI->connect($dsn, $user, $pass, $attributes)
+        or die "\nCan't connect to the database.\nError: $DBI::errstr\n"
+        . "  Is your database installed and up and running?\n  Do you have"
+        . " the correct username and password selected in localconfig?\n\n";
+
+    # RaiseError was only set to 0 so that we could catch the 
+    # above "die" condition.
+    $self->{RaiseError} = 1;
+
+    bless ($self, $class);
+
+    return $self;
+}
+
+#####################################################################
+# Private Methods
+#####################################################################
+
+=begin private
+
+=head1 PRIVATE METHODS
+
+These methods really are private. Do not override them in subclasses.
+
+=over 4
+
+=item C<_init_bz_schema_storage>
+
+ Description: Initializes the bz_schema table if it contains nothing.
+ Params:      none
+ Returns:     nothing
+
+=cut
+
+sub _bz_init_schema_storage {
+    my ($self) = @_;
+
+    my $table_size;
+    eval {
+        $table_size = 
+            $self->selectrow_array("SELECT COUNT(*) FROM bz_schema");
+    };
+
+    if (!$table_size) {
+        my $init_schema = $self->_bz_get_initial_schema;
+        my $store_me = $init_schema->serialize_abstract();
+        my $schema_version = $init_schema->SCHEMA_VERSION;
+
+        # If table_size is not defined, then we hit an error reading the
+        # bz_schema table, which means it probably doesn't exist yet. So,
+        # we have to create it. If we failed above for some other reason,
+        # we'll see the failure here.
+        # However, we must create the table after we do get_initial_schema,
+        # because some versions of get_initial_schema read that the table
+        # exists and then add it to the Schema, where other versions don't.
+        if (!defined $table_size) {
+            $self->_bz_add_table_raw('bz_schema');
+        }
+
+        say install_string('db_schema_init');
+        my $sth = $self->prepare("INSERT INTO bz_schema "
+                                 ." (schema_data, version) VALUES (?,?)");
+        $sth->bind_param(1, $store_me, $self->BLOB_TYPE);
+        $sth->bind_param(2, $schema_version);
+        $sth->execute();
+
+        # And now we have to update the on-disk schema to hold the bz_schema
+        # table, if the bz_schema table didn't exist when we were called.
+        if (!defined $table_size) {
+            $self->_bz_real_schema->add_table('bz_schema',
+                $self->_bz_schema->get_table_abstract('bz_schema'));
+            $self->_bz_store_real_schema;
+        }
+    } 
+    # Sanity check
+    elsif ($table_size > 1) {
+        # We tell them to delete the newer one. Better to have checksetup
+        # run migration code too many times than to have it not run the
+        # correct migration code at all.
+        die "Attempted to initialize the schema but there are already "
+            . " $table_size copies of it stored.\nThis should never happen.\n"
+            . " Compare the rows of the bz_schema table and delete the "
+            . "newer one(s).";
+    }
+}
+
+=item C<_bz_real_schema()>
+
+ Description: Returns a Schema object representing the database
+              that is being used in the current installation.
+ Params:      none
+ Returns:     A C<Bugzilla::DB::Schema> object representing the database
+              as it exists on the disk.
+
+=cut
+
+sub _bz_real_schema {
+    my ($self) = @_;
+    return $self->{private_real_schema} if exists $self->{private_real_schema};
+
+    my ($data, $version) = $self->selectrow_array(
+        "SELECT schema_data, version FROM bz_schema");
+
+    (die "_bz_real_schema tried to read the bz_schema table but it's empty!")
+        if !$data;
+
+    $self->{private_real_schema} = 
+        $self->_bz_schema->deserialize_abstract($data, $version);
+
+    return $self->{private_real_schema};
+}
+
+=item C<_bz_store_real_schema()>
+
+ Description: Stores the _bz_real_schema structures in the database
+              for later recovery. Call this function whenever you make
+              a change to the _bz_real_schema.
+ Params:      none
+ Returns:     nothing
+
+ Precondition: $self->{_bz_real_schema} must exist.
+
+=back
+
+=end private
+
+=cut
+
+sub _bz_store_real_schema {
+    my ($self) = @_;
+
+    # Make sure that there's a schema to update
+    my $table_size = $self->selectrow_array("SELECT COUNT(*) FROM bz_schema");
+
+    die "Attempted to update the bz_schema table but there's nothing "
+        . "there to update. Run checksetup." unless $table_size;
+
+    # We want to store the current object, not one
+    # that we read from the database. So we use the actual hash
+    # member instead of the subroutine call. If the hash
+    # member is not defined, we will (and should) fail.
+    my $update_schema = $self->{private_real_schema};
+    my $store_me = $update_schema->serialize_abstract();
+    my $schema_version = $update_schema->SCHEMA_VERSION;
+    my $sth = $self->prepare("UPDATE bz_schema 
+                                 SET schema_data = ?, version = ?");
+    $sth->bind_param(1, $store_me, $self->BLOB_TYPE);
+    $sth->bind_param(2, $schema_version);
+    $sth->execute();
+}
+
+# For bz_populate_enum_tables
+sub _bz_populate_enum_table {
+    my ($self, $table, $valuelist) = @_;
+
+    my $sql_table = $self->quote_identifier($table);
+
+    # Check if there are any table entries
+    my $table_size = $self->selectrow_array("SELECT COUNT(*) FROM $sql_table");
+
+    # If the table is empty...
+    if (!$table_size) {
+        print " $table";
+        my $insert = $self->prepare(
+            "INSERT INTO $sql_table (value,sortkey) VALUES (?,?)");
+        my $sortorder = 0;
+        my $maxlen    = max(map(length($_), @$valuelist)) + 2;
+        foreach my $value (@$valuelist) {
+            $sortorder += 100;
+            $insert->execute($value, $sortorder);
+        }
+    }
+}
+
+# This is used before adding a foreign key to a column, to make sure
+# that the database won't fail adding the key.
+sub _check_references {
+    my ($self, $table, $column, $fk) = @_;
+    my $foreign_table = $fk->{TABLE};
+    my $foreign_column = $fk->{COLUMN};
+
+    # We use table aliases because sometimes we join a table to itself,
+    # and we can't use the same table name on both sides of the join.
+    # We also can't use the words "table" or "foreign" because those are
+    # reserved words.
+    my $bad_values = $self->selectcol_arrayref(
+        "SELECT DISTINCT tabl.$column 
+           FROM $table AS tabl LEFT JOIN $foreign_table AS forn
+                ON tabl.$column = forn.$foreign_column
+          WHERE forn.$foreign_column IS NULL
+                AND tabl.$column IS NOT NULL");
+
+    if (@$bad_values) {
+        my $delete_action = $fk->{DELETE} || '';
+        if ($delete_action eq 'CASCADE') {
+            $self->do("DELETE FROM $table WHERE $column IN (" 
+                      . join(',', ('?') x @$bad_values)  . ")",
+                      undef, @$bad_values);
+            if (Bugzilla->usage_mode == USAGE_MODE_CMDLINE) {
+                print "\n", get_text('install_fk_invalid_fixed',
+                    { table => $table, column => $column,
+                      foreign_table => $foreign_table,
+                      foreign_column => $foreign_column,
+                      'values' => $bad_values, action => 'delete' }), "\n";
+            }
+        }
+        elsif ($delete_action eq 'SET NULL') {
+            $self->do("UPDATE $table SET $column = NULL
+                        WHERE $column IN ("
+                      . join(',', ('?') x @$bad_values)  . ")",
+                      undef, @$bad_values);
+            if (Bugzilla->usage_mode == USAGE_MODE_CMDLINE) {
+                print "\n", get_text('install_fk_invalid_fixed',
+                    { table => $table, column => $column,
+                      foreign_table => $foreign_table, 
+                      foreign_column => $foreign_column,
+                      'values' => $bad_values, action => 'null' }), "\n";
+            }
+        }
+        else {
+            die "\n", get_text('install_fk_invalid',
+                { table => $table, column => $column,
+                  foreign_table => $foreign_table,
+                  foreign_column => $foreign_column,
+                 'values' => $bad_values }), "\n";
+        }
+    }
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::DB - Database access routines, using L<DBI>
+
+=head1 SYNOPSIS
+
+  # Obtain db handle
+  use Bugzilla::DB;
+  my $dbh = Bugzilla->dbh;
+
+  # prepare a query using DB methods
+  my $sth = $dbh->prepare("SELECT " .
+                          $dbh->sql_date_format("creation_ts", "%Y%m%d") .
+                          " FROM bugs WHERE bug_status != 'RESOLVED' " .
+                          $dbh->sql_limit(1));
+
+  # Execute the query
+  $sth->execute;
+
+  # Get the results
+  my @result = $sth->fetchrow_array;
+
+  # Schema Modification
+  $dbh->bz_add_column($table, $name, \%definition, $init_value);
+  $dbh->bz_add_index($table, $name, $definition);
+  $dbh->bz_add_table($name);
+  $dbh->bz_drop_index($table, $name);
+  $dbh->bz_drop_table($name);
+  $dbh->bz_alter_column($table, $name, \%new_def, $set_nulls_to);
+  $dbh->bz_drop_column($table, $column);
+  $dbh->bz_rename_column($table, $old_name, $new_name);
+
+  # Schema Information
+  my $column = $dbh->bz_column_info($table, $column);
+  my $index  = $dbh->bz_index_info($table, $index);
+
+=head1 DESCRIPTION
+
+Functions in this module allows creation of a database handle to connect
+to the Bugzilla database. This should never be done directly; all users
+should use the L<Bugzilla> module to access the current C<dbh> instead.
+
+This module also contains methods extending the returned handle with
+functionality which is different between databases allowing for easy
+customization for particular database via inheritance. These methods
+should be always preffered over hard-coding SQL commands.
+
+=head1 CONSTANTS
+
+Subclasses of Bugzilla::DB are required to define certain constants. These
+constants are required to be subroutines or "use constant" variables.
+
+=over
+
+=item C<BLOB_TYPE>
+
+The C<\%attr> argument that must be passed to bind_param in order to 
+correctly escape a C<LONGBLOB> type.
+
+=item C<ISOLATION_LEVEL>
+
+The argument that this database should send to 
+C<SET TRANSACTION ISOLATION LEVEL> when starting a transaction. If you
+override this in a subclass, the isolation level you choose should
+be as strict as or more strict than the default isolation level defined in
+L<Bugzilla::DB>.
+
+=back
+
+
+=head1 CONNECTION
+
+A new database handle to the required database can be created using this
+module. This is normally done by the L<Bugzilla> module, and so these routines
+should not be called from anywhere else.
+
+=head2 Functions
+
+=over
+
+=item C<connect_main>
+
+=over
+
+=item B<Description>
+
+Function to connect to the main database, returning a new database handle.
+
+=item B<Params>
+
+=over
+
+=item C<$no_db_name> (optional) - If true, connect to the database
+server, but don't connect to a specific database. This is only used 
+when creating a database. After you create the database, you should 
+re-create a new Bugzilla::DB object without using this parameter. 
+
+=back
+
+=item B<Returns>
+
+New instance of the DB class
+
+=back
+
+=item C<connect_shadow>
+
+=over
+
+=item B<Description>
+
+Function to connect to the shadow database, returning a new database handle.
+This routine C<die>s if no shadow database is configured.
+
+=item B<Params> (none)
+
+=item B<Returns>
+
+A new instance of the DB class
+
+=back
+
+=item C<bz_check_requirements>
+
+=over
+
+=item B<Description>
+
+Checks to make sure that you have the correct DBD and database version 
+installed for the database that Bugzilla will be using. Prints a message 
+and exits if you don't pass the requirements.
+
+If C<$db_check> is false (from F<localconfig>), we won't check the 
+database version.
+
+=item B<Params>
+
+=over
+
+=item C<$output> - C<true> if the function should display informational 
+output about what it's doing, such as versions found.
+
+=back
+
+=item B<Returns> (nothing)
+
+=back
+
+
+=item C<bz_create_database>
+
+=over
+
+=item B<Description>
+
+Creates an empty database with the name C<$db_name>, if that database 
+doesn't already exist. Prints an error message and exits if we can't 
+create the database.
+
+=item B<Params> (none)
+
+=item B<Returns> (nothing)
+
+=back
+
+=item C<_connect>
+
+=over
+
+=item B<Description>
+
+Internal function, creates and returns a new, connected instance of the 
+correct DB class.  This routine C<die>s if no driver is specified.
+
+=item B<Params>
+
+=over
+
+=item C<$driver> - name of the database driver to use
+
+=item C<$host> - host running the database we are connecting to
+
+=item C<$dbname> - name of the database to connect to
+
+=item C<$port> - port the database is listening on
+
+=item C<$sock> - socket the database is listening on
+
+=item C<$user> - username used to log in to the database
+
+=item C<$pass> - password used to log in to the database
+
+=back
+
+=item B<Returns>
+
+A new instance of the DB class
+
+=back
+
+=item C<_handle_error>
+
+Function passed to the DBI::connect call for error handling. It shortens the 
+error for printing.
+
+=item C<import>
+
+Overrides the standard import method to check that derived class
+implements all required abstract methods. Also calls original implementation 
+in its super class.
+
+=back
+
+=head1 ABSTRACT METHODS
+
+Note: Methods which can be implemented generically for all DBs are implemented in
+this module. If needed, they can be overridden with DB specific code.
+Methods which do not have standard implementation are abstract and must
+be implemented for all supported databases separately.
+To avoid confusion with standard DBI methods, all methods returning string with
+formatted SQL command have prefix C<sql_>. All other methods have prefix C<bz_>.
+
+=head2 Constructor
+
+=over
+
+=item C<new>
+
+=over
+
+=item B<Description>
+
+Constructor.  Abstract method, should be overridden by database specific 
+code.
+
+=item B<Params>
+
+=over 
+
+=item C<$user> - username used to log in to the database
+
+=item C<$pass> - password used to log in to the database
+
+=item C<$host> - host running the database we are connecting to
+
+=item C<$dbname> - name of the database to connect to
+
+=item C<$port> - port the database is listening on
+
+=item C<$sock> - socket the database is listening on
+
+=back
+
+=item B<Returns>
+
+A new instance of the DB class
+
+=item B<Note>
+
+The constructor should create a DSN from the parameters provided and
+then call C<db_new()> method of its super class to create a new
+class instance. See L<db_new> description in this module. As per
+DBI documentation, all class variables must be prefixed with
+"private_". See L<DBI>.
+
+=back
+
+=back
+
+=head2 SQL Generation
+
+=over
+
+=item C<sql_regexp>
+
+=over
+
+=item B<Description>
+
+Outputs SQL regular expression operator for POSIX regex
+searches (case insensitive) in format suitable for a given
+database.
+
+Abstract method, should be overridden by database specific code.
+
+=item B<Params>
+
+=over
+
+=item C<$expr> - SQL expression for the text to be searched (scalar)
+
+=item C<$pattern> - the regular expression to search for (scalar)
+
+=item C<$nocheck> - true if the pattern should not be tested; false otherwise (boolean)
+
+=item C<$real_pattern> - the real regular expression to search for.
+This argument is used when C<$pattern> is a placeholder ('?').
+
+=back
+
+=item B<Returns>
+
+Formatted SQL for regular expression search (e.g. REGEXP) (scalar)
+
+=back
+
+=item C<sql_not_regexp>
+
+=over
+
+=item B<Description>
+
+Outputs SQL regular expression operator for negative POSIX
+regex searches (case insensitive) in format suitable for a given
+database.
+
+Abstract method, should be overridden by database specific code.
+
+=item B<Params>
+
+Same as L</sql_regexp>.
+
+=item B<Returns>
+
+Formatted SQL for negative regular expression search (e.g. NOT REGEXP) 
+(scalar)
+
+=back
+
+=item C<sql_limit>
+
+=over
+
+=item B<Description>
+
+Returns SQL syntax for limiting results to some number of rows
+with optional offset if not starting from the begining.
+
+Abstract method, should be overridden by database specific code.
+
+=item B<Params>
+
+=over
+
+=item C<$limit> - number of rows to return from query (scalar)
+
+=item C<$offset> - number of rows to skip before counting (scalar)
+
+=back
+
+=item B<Returns>
+
+Formatted SQL for limiting number of rows returned from query
+with optional offset (e.g. LIMIT 1, 1) (scalar)
+
+=back
+
+=item C<sql_from_days>
+
+=over
+
+=item B<Description>
+
+Outputs SQL syntax for converting Julian days to date.
+
+Abstract method, should be overridden by database specific code.
+
+=item B<Params>
+
+=over
+
+=item C<$days> - days to convert to date
+
+=back
+
+=item B<Returns>
+
+Formatted SQL for returning Julian days in dates. (scalar)
+
+=back
+
+=item C<sql_to_days>
+
+=over
+
+=item B<Description>
+
+Outputs SQL syntax for converting date to Julian days.
+
+Abstract method, should be overridden by database specific code.
+
+=item B<Params>
+
+=over
+
+=item C<$date> - date to convert to days
+
+=back
+
+=item B<Returns>
+
+Formatted SQL for returning date fields in Julian days. (scalar)
+
+=back
+
+=item C<sql_date_format>
+
+=over
+
+=item B<Description>
+
+Outputs SQL syntax for formatting dates.
+
+Abstract method, should be overridden by database specific code.
+
+=item B<Params>
+
+=over
+
+=item C<$date> - date or name of date type column (scalar)
+
+=item C<$format> - format string for date output (scalar)
+(C<%Y> = year, four digits, C<%y> = year, two digits, C<%m> = month,
+C<%d> = day, C<%a> = weekday name, 3 letters, C<%H> = hour 00-23,
+C<%i> = minute, C<%s> = second)
+
+=back
+
+=item B<Returns>
+
+Formatted SQL for date formatting (scalar)
+
+=back
+
+=item C<sql_date_math>
+
+=over
+
+=item B<Description>
+
+Outputs proper SQL syntax for adding some amount of time to a date.
+
+Abstract method, should be overridden by database specific code.
+
+=item B<Params>
+
+=over
+
+=item C<$date>
+
+C<string> The date being added to or subtracted from.
+
+=item C<$operator>
+
+C<string> Either C<-> or C<+>, depending on whether you're subtracting
+or adding.
+
+=item C<$interval>
+
+C<integer> The time interval you're adding or subtracting (e.g. C<30>)
+
+=item C<$units> 
+
+C<string> the units the interval is in (e.g. 'MINUTE')
+
+=back
+
+=item B<Returns>
+
+Formatted SQL for adding or subtracting a date and some amount of time (scalar)
+
+=back
+
+=item C<sql_position>
+
+=over
+
+=item B<Description>
+
+Outputs proper SQL syntax determining position of a substring
+(fragment) withing a string (text). Note: if the substring or
+text are string constants, they must be properly quoted (e.g. "'pattern'").
+
+It searches for the string in a case-sensitive manner. If you want to do
+a case-insensitive search, use L</sql_iposition>.
+
+=item B<Params>
+
+=over
+
+=item C<$fragment> - the string fragment we are searching for (scalar)
+
+=item C<$text> - the text to search (scalar)
+
+=back
+
+=item B<Returns>
+
+Formatted SQL for substring search (scalar)
+
+=back
+
+=item C<sql_iposition>
+
+Just like L</sql_position>, but case-insensitive.
+
+=item C<sql_group_by>
+
+=over
+
+=item B<Description>
+
+Outputs proper SQL syntax for grouping the result of a query.
+
+For ANSI SQL databases, we need to group by all columns we are
+querying for (except for columns used in aggregate functions).
+Some databases require (or even allow) to specify only one
+or few columns if the result is uniquely defined. For those
+databases, the default implementation needs to be overloaded.
+
+=item B<Params>
+
+=over
+
+=item C<$needed_columns> - string with comma separated list of columns
+we need to group by to get expected result (scalar)
+
+=item C<$optional_columns> - string with comma separated list of all
+other columns we are querying for, but which are not in the required list.
+
+=back
+
+=item B<Returns>
+
+Formatted SQL for row grouping (scalar)
+
+=back
+
+=item C<sql_string_concat>
+
+=over
+
+=item B<Description>
+
+Returns SQL syntax for concatenating multiple strings (constants
+or values from table columns) together.
+
+=item B<Params>
+
+=over
+
+=item C<@params> - array of column names or strings to concatenate
+
+=back
+
+=item B<Returns>
+
+Formatted SQL for concatenating specified strings
+
+=back
+
+=item C<sql_string_until>
+
+=over
+
+=item B<Description>
+
+Returns SQL for truncating a string at the first occurrence of a certain
+substring.
+
+=item B<Params>
+
+Note that both parameters need to be sql-quoted.
+
+=item C<$string> The string we're truncating
+
+=item C<$substring> The substring we're truncating at.
+
+=back
+
+=item C<sql_fulltext_search>
+
+=over
+
+=item B<Description>
+
+Returns one or two SQL expressions for performing a full text search for
+specified text on a given column.
+
+If one value is returned, it is a numeric expression that indicates
+a match with a positive value and a non-match with zero. In this case,
+the DB must support casting numeric expresions to booleans.
+
+If two values are returned, then the first value is a boolean expression
+that indicates the presence of a match, and the second value is a numeric
+expression that can be used for ranking.
+
+There is a ANSI SQL version of this method implemented using LIKE operator,
+but it's not a real full text search. DB specific modules should override 
+this, as this generic implementation will be always much slower. This 
+generic implementation returns 'relevance' as 0 for no match, or 1 for a 
+match.
+
+=item B<Params>
+
+=over
+
+=item C<$column> - name of column to search (scalar)
+
+=item C<$text> - text to search for (scalar)
+
+=back
+
+=item B<Returns>
+
+Formatted SQL for full text search
+
+=back
+
+=item C<sql_istrcmp>
+
+=over
+
+=item B<Description>
+
+Returns SQL for a case-insensitive string comparison.
+
+=item B<Params>
+
+=over
+
+=item C<$left> - What should be on the left-hand-side of the operation.
+
+=item C<$right> - What should be on the right-hand-side of the operation.
+
+=item C<$op> (optional) - What the operation is. Should be a  valid ANSI 
+SQL comparison operator, such as C<=>, C<E<lt>>, C<LIKE>, etc. Defaults 
+to C<=> if not specified.
+
+=back
+
+=item B<Returns>
+
+A SQL statement that will run the comparison in a case-insensitive fashion.
+
+=item B<Note>
+
+Uses L</sql_istring>, so it has the same performance concerns.
+Try to avoid using this function unless absolutely necessary.
+
+Subclass Implementors: Override sql_istring instead of this
+function, most of the time (this function uses sql_istring).
+
+=back
+
+=item C<sql_istring>
+
+=over
+
+=item B<Description>
+
+Returns SQL syntax "preparing" a string or text column for case-insensitive 
+comparison.
+
+=item B<Params>
+
+=over
+
+=item C<$string> - string to convert (scalar)
+
+=back
+
+=item B<Returns>
+
+Formatted SQL making the string case insensitive.
+
+=item B<Note>
+
+The default implementation simply calls LOWER on the parameter.
+If this is used to search on a text column with index, the index
+will not be usually used unless it was created as LOWER(column).
+
+=back
+
+=item C<sql_in>
+
+=over
+
+=item B<Description>
+
+Returns SQL syntax for the C<IN ()> operator. 
+
+Only necessary where an C<IN> clause can have more than 1000 items.
+
+=item B<Params>
+
+=over
+
+=item C<$column_name> - Column name (e.g. C<bug_id>)
+
+=item C<$in_list_ref> - an arrayref containing values for C<IN ()>
+
+=back
+
+=item B<Returns>
+
+Formatted SQL for the C<IN> operator.
+
+=back
+
+=back
+
+
+=head1 IMPLEMENTED METHODS
+
+These methods are implemented in Bugzilla::DB, and only need
+to be implemented in subclasses if you need to override them for 
+database-compatibility reasons.
+
+=head2 General Information Methods
+
+These methods return information about data in the database.
+
+=over
+
+=item C<bz_last_key>
+
+=over
+
+=item B<Description>
+
+Returns the last serial number, usually from a previous INSERT.
+
+Must be executed directly following the relevant INSERT.
+This base implementation uses L<DBI/last_insert_id>. If the
+DBD supports it, it is the preffered way to obtain the last
+serial index. If it is not supported, the DB-specific code
+needs to override this function.
+
+=item B<Params>
+
+=over
+
+=item C<$table> - name of table containing serial column (scalar)
+
+=item C<$column> - name of column containing serial data type (scalar)
+
+=back
+
+=item B<Returns>
+
+Last inserted ID (scalar)
+
+=back
+
+=back
+
+=head2 Database Setup Methods
+
+These methods are used by the Bugzilla installation programs to set up
+the database.
+
+=over
+
+=item C<bz_populate_enum_tables>
+
+=over
+
+=item B<Description>
+
+For an upgrade or an initial installation, populates the tables that hold 
+the legal values for the old "enum" fields: C<bug_severity>, 
+C<resolution>, etc. Prints out information if it inserts anything into the
+DB.
+
+=item B<Params> (none)
+
+=item B<Returns> (nothing)
+
+=back
+
+=back
+
+
+=head2 Schema Modification Methods
+
+These methods modify the current Bugzilla Schema.
+
+Where a parameter says "Abstract index/column definition", it returns/takes
+information in the formats defined for indexes and columns in
+C<Bugzilla::DB::Schema::ABSTRACT_SCHEMA>.
+
+=over
+
+=item C<bz_add_column>
+
+=over
+
+=item B<Description>
+
+Adds a new column to a table in the database. Prints out a brief statement 
+that it did so, to stdout. Note that you cannot add a NOT NULL column that 
+has no default -- the database won't know what to set all the NULL
+values to.
+
+=item B<Params>
+
+=over
+
+=item C<$table> - the table where the column is being added
+
+=item C<$name> - the name of the new column
+
+=item C<\%definition> - Abstract column definition for the new column
+
+=item C<$init_value> (optional) - An initial value to set the column
+to. Required if your column is NOT NULL and has no DEFAULT set.
+
+=back
+
+=item B<Returns> (nothing)
+
+=back
+
+=item C<bz_add_index>
+
+=over
+
+=item B<Description>
+
+Adds a new index to a table in the database. Prints out a brief statement 
+that it did so, to stdout. If the index already exists, we will do nothing.
+
+=item B<Params>
+
+=over
+
+=item C<$table> - The table the new index is on.
+
+=item C<$name>  - A name for the new index.
+
+=item C<$definition> - An abstract index definition. Either a hashref 
+or an arrayref.
+
+=back
+
+=item B<Returns> (nothing)
+
+=back
+
+=item C<bz_add_table>
+
+=over
+
+=item B<Description>
+
+Creates a new table in the database, based on the definition for that 
+table in the abstract schema.
+
+Note that unlike the other 'add' functions, this does not take a 
+definition, but always creates the table as it exists in
+L<Bugzilla::DB::Schema/ABSTRACT_SCHEMA>.
+
+If a table with that name already exists, then this function returns 
+silently.
+
+=item B<Params>
+
+=over
+
+=item C<$name> - The name of the table you want to create.
+
+=back
+
+=item B<Returns> (nothing)
+
+=back
+
+=item C<bz_drop_index>
+
+=over
+
+=item B<Description>
+
+Removes an index from the database. Prints out a brief statement that it 
+did so, to stdout. If the index doesn't exist, we do nothing.
+
+=item B<Params>
+
+=over
+
+=item C<$table> - The table that the index is on.
+
+=item C<$name> - The name of the index that you want to drop.
+
+=back
+
+=item B<Returns> (nothing)
+
+=back
+
+=item C<bz_drop_table>
+
+=over
+
+=item B<Description>
+
+Drops a table from the database. If the table doesn't exist, we just 
+return silently.
+
+=item B<Params>
+
+=over
+
+=item C<$name> - The name of the table to drop.
+
+=back
+
+=item B<Returns> (nothing)
+
+=back
+
+=item C<bz_alter_column>
+
+=over
+
+=item B<Description>
+
+Changes the data type of a column in a table. Prints out the changes 
+being made to stdout. If the new type is the same as the old type, 
+the function returns without changing anything.
+
+=item B<Params>
+
+=over
+
+=item C<$table> - the table where the column is
+
+=item C<$name> - the name of the column you want to change
+
+=item C<\%new_def> - An abstract column definition for the new 
+data type of the columm
+
+=item C<$set_nulls_to> (Optional) - If you are changing the column
+to be NOT NULL, you probably also want to set any existing NULL columns 
+to a particular value. Specify that value here. B<NOTE>: The value should 
+not already be SQL-quoted.
+
+=back
+
+=item B<Returns> (nothing)
+
+=back
+
+=item C<bz_drop_column>
+
+=over
+
+=item B<Description>
+
+Removes a column from a database table. If the column doesn't exist, we 
+return without doing anything. If we do anything, we print a short 
+message to C<stdout> about the change.
+
+=item B<Params>
+
+=over
+
+=item C<$table> - The table where the column is
+
+=item C<$column> - The name of the column you want to drop
+
+=back
+
+=item B<Returns> (nothing)
+
+=back
+
+=item C<bz_rename_column>
+
+=over
+
+=item B<Description>
+
+Renames a column in a database table. If the C<$old_name> column 
+doesn't exist, we return without doing anything. If C<$old_name> 
+and C<$new_name> both already exist in the table specified, we fail.
+
+=item B<Params>
+
+=over
+
+=item C<$table> - The name of the table containing the column 
+that you want to rename
+
+=item C<$old_name> - The current name of the column that you want to rename
+
+=item C<$new_name> - The new name of the column
+
+=back
+
+=item B<Returns> (nothing)
+
+=back
+
+=item C<bz_rename_table>
+
+=over
+
+=item B<Description>
+
+Renames a table in the database. Does nothing if the table doesn't exist.
+
+Throws an error if the old table exists and there is already a table 
+with the new name.
+
+=item B<Params>
+
+=over
+
+=item C<$old_name> - The current name of the table.
+
+=item C<$new_name> - What you're renaming the table to.
+
+=back
+
+=item B<Returns> (nothing)
+
+=back
+
+=back
+
+=head2 Schema Information Methods
+
+These methods return information about the current Bugzilla database
+schema, as it currently exists on the disk. 
+
+Where a parameter says "Abstract index/column definition", it returns/takes
+information in the formats defined for indexes and columns for
+L<Bugzilla::DB::Schema/ABSTRACT_SCHEMA>.
+
+=over
+
+=item C<bz_column_info>
+
+=over
+
+=item B<Description>
+
+Get abstract column definition.
+
+=item B<Params>
+
+=over
+
+=item C<$table> - The name of the table the column is in.
+
+=item C<$column> - The name of the column.
+
+=back
+
+=item B<Returns>
+
+An abstract column definition for that column. If the table or column 
+does not exist, we return C<undef>.
+
+=back
+
+=item C<bz_index_info>
+
+=over
+
+=item B<Description>
+
+Get abstract index definition.
+
+=item B<Params>
+
+=over
+
+=item C<$table> - The table the index is on.
+
+=item C<$index> - The name of the index.
+
+=back
+
+=item B<Returns>
+
+An abstract index definition for that index, always in hashref format. 
+The hashref will always contain the C<TYPE> element, but it will
+be an empty string if it's just a normal index.
+
+If the index does not exist, we return C<undef>.
+
+=back
+
+=back
+
+
+=head2 Transaction Methods
+
+These methods deal with the starting and stopping of transactions 
+in the database.
+
+=over
+
+=item C<bz_in_transaction>
+
+Returns C<1> if we are currently in the middle of an uncommitted transaction,
+C<0> otherwise.
+
+=item C<bz_start_transaction>
+
+Starts a transaction.
+
+It is OK to call C<bz_start_transaction> when you are already inside of
+a transaction. However, you must call L</bz_commit_transaction> as many
+times as you called C<bz_start_transaction>, in order for your transaction
+to actually commit.
+
+Bugzilla uses C<REPEATABLE READ> transactions.
+
+Returns nothing and takes no parameters.
+
+=item C<bz_commit_transaction>
+
+Ends a transaction, commiting all changes. Returns nothing and takes
+no parameters.
+
+=item C<bz_rollback_transaction>
+
+Ends a transaction, rolling back all changes. Returns nothing and takes 
+no parameters.
+
+=back
+
+
+=head1 SUBCLASS HELPERS
+
+Methods in this class are intended to be used by subclasses to help them
+with their functions.
+
+=over
+
+=item C<db_new>
+
+=over
+
+=item B<Description>
+
+Constructor
+
+=item B<Params>
+
+=over
+
+=item C<$dsn> - database connection string
+
+=item C<$user> - username used to log in to the database
+
+=item C<$pass> - password used to log in to the database
+
+=item C<\%override_attrs> - set of attributes for DB connection (optional).
+You only have to set attributes that you want to be different from
+the default attributes set inside of C<db_new>.
+
+=back
+
+=item B<Returns>
+
+A new instance of the DB class
+
+=item B<Note>
+
+The name of this constructor is not C<new>, as that would make
+our check for implementation of C<new> by derived class useless.
+
+=back
+
+=back
+
+
+=head1 SEE ALSO
+
+L<DBI>
+
+L<Bugzilla::Constants/DB_MODULE>

diff --git a/Bugzilla/DB/Mysql.pm b/Bugzilla/DB/Mysql.pm
new file mode 100644 (file)
index 0000000..e9ed13b
--- /dev/null
+++ b/Bugzilla/DB/Mysql.pm
@@ -0,0 +1,1032 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+=head1 NAME
+
+Bugzilla::DB::Mysql - Bugzilla database compatibility layer for MySQL
+
+=head1 DESCRIPTION
+
+This module overrides methods of the Bugzilla::DB module with MySQL specific
+implementation. It is instantiated by the Bugzilla::DB module and should never
+be used directly.
+
+For interface details see L<Bugzilla::DB> and L<DBI>.
+
+=cut
+
+package Bugzilla::DB::Mysql;
+use strict;
+use base qw(Bugzilla::DB);
+
+use Bugzilla::Constants;
+use Bugzilla::Install::Util qw(install_string);
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::DB::Schema::Mysql;
+
+use List::Util qw(max);
+use Text::ParseWords;
+
+# This is how many comments of MAX_COMMENT_LENGTH we expect on a single bug.
+# In reality, you could have a LOT more comments than this, because 
+# MAX_COMMENT_LENGTH is big.
+use constant MAX_COMMENTS => 50;
+
+use constant FULLTEXT_OR => '|';
+
+sub new {
+    my ($class, $params) = @_;
+    my ($user, $pass, $host, $dbname, $port, $sock) =
+        @$params{qw(db_user db_pass db_host db_name db_port db_sock)};
+
+    # construct the DSN from the parameters we got
+    my $dsn = "dbi:mysql:host=$host;database=$dbname";
+    $dsn .= ";port=$port" if $port;
+    $dsn .= ";mysql_socket=$sock" if $sock;
+
+    my %attrs = (
+        mysql_enable_utf8 => Bugzilla->params->{'utf8'},
+        # Needs to be explicitly specified for command-line processes.
+        mysql_auto_reconnect => 1,
+    );
+    
+    my $self = $class->db_new({ dsn => $dsn, user => $user, 
+                                pass => $pass, attrs => \%attrs });
+
+    # This makes sure that if the tables are encoded as UTF-8, we
+    # return their data correctly.
+    $self->do("SET NAMES utf8") if Bugzilla->params->{'utf8'};
+
+    # all class local variables stored in DBI derived class needs to have
+    # a prefix 'private_'. See DBI documentation.
+    $self->{private_bz_tables_locked} = "";
+
+    # Needed by TheSchwartz
+    $self->{private_bz_dsn} = $dsn;
+
+    bless ($self, $class);
+    
+    # Bug 321645 - disable MySQL strict mode, if set
+    my ($var, $sql_mode) = $self->selectrow_array(
+        "SHOW VARIABLES LIKE 'sql\\_mode'");
+
+    if ($sql_mode) {
+        # STRICT_TRANS_TABLE or STRICT_ALL_TABLES enable MySQL strict mode,
+        # causing bug 321645. TRADITIONAL sets these modes (among others) as
+        # well, so it has to be stipped as well
+        my $new_sql_mode =
+            join(",", grep {$_ !~ /^STRICT_(?:TRANS|ALL)_TABLES|TRADITIONAL$/}
+                            split(/,/, $sql_mode));
+
+        if ($sql_mode ne $new_sql_mode) {
+            $self->do("SET SESSION sql_mode = ?", undef, $new_sql_mode);
+        }
+    }
+
+    # Allow large GROUP_CONCATs (largely for inserting comments 
+    # into bugs_fulltext).
+    $self->do('SET SESSION group_concat_max_len = 128000000');
+
+    return $self;
+}
+
+# when last_insert_id() is supported on MySQL by lowest DBI/DBD version
+# required by Bugzilla, this implementation can be removed.
+sub bz_last_key {
+    my ($self) = @_;
+
+    my ($last_insert_id) = $self->selectrow_array('SELECT LAST_INSERT_ID()');
+
+    return $last_insert_id;
+}
+
+sub sql_group_concat {
+    my ($self, $column, $separator, $sort) = @_;
+    $separator = $self->quote(', ') if !defined $separator;
+    $sort = 1 if !defined $sort;
+    if ($sort) {
+        my $sort_order = $column;
+        $sort_order =~ s/^DISTINCT\s+//i;
+        $column = "$column ORDER BY $sort_order";
+    }
+    return "GROUP_CONCAT($column SEPARATOR $separator)";
+}
+
+sub sql_regexp {
+    my ($self, $expr, $pattern, $nocheck, $real_pattern) = @_;
+    $real_pattern ||= $pattern;
+
+    $self->bz_check_regexp($real_pattern) if !$nocheck;
+
+    return "$expr REGEXP $pattern";
+}
+
+sub sql_not_regexp {
+    my ($self, $expr, $pattern, $nocheck, $real_pattern) = @_;
+    $real_pattern ||= $pattern;
+
+    $self->bz_check_regexp($real_pattern) if !$nocheck;
+
+    return "$expr NOT REGEXP $pattern";
+}
+
+sub sql_limit {
+    my ($self, $limit, $offset) = @_;
+
+    if (defined($offset)) {
+        return "LIMIT $offset, $limit";
+    } else {
+        return "LIMIT $limit";
+    }
+}
+
+sub sql_string_concat {
+    my ($self, @params) = @_;
+    
+    return 'CONCAT(' . join(', ', @params) . ')';
+}
+
+sub sql_fulltext_search {
+    my ($self, $column, $text) = @_;
+
+    # Add the boolean mode modifier if the search string contains
+    # boolean operators at the start or end of a word.
+    my $mode = '';
+    if ($text =~ /(?:^|\W)[+\-<>~"()]/ || $text =~ /[()"*](?:$|\W)/) {
+        $mode = 'IN BOOLEAN MODE';
+
+        # quote un-quoted compound words
+        my @words = quotewords('[\s()]+', 'delimiters', $text);
+        foreach my $word (@words) {
+            # match words that have non-word chars in the middle of them
+            if ($word =~ /\w\W+\w/ && $word !~ m/"/) {
+                $word = '"' . $word . '"';
+            }
+        }
+        $text = join('', @words);
+    }
+
+    # quote the text for use in the MATCH AGAINST expression
+    $text = $self->quote($text);
+
+    # untaint the text, since it's safe to use now that we've quoted it
+    trick_taint($text);
+
+    return "MATCH($column) AGAINST($text $mode)";
+}
+
+sub sql_istring {
+    my ($self, $string) = @_;
+    
+    return $string;
+}
+
+sub sql_from_days {
+    my ($self, $days) = @_;
+
+    return "FROM_DAYS($days)";
+}
+
+sub sql_to_days {
+    my ($self, $date) = @_;
+
+    return "TO_DAYS($date)";
+}
+
+sub sql_date_format {
+    my ($self, $date, $format) = @_;
+
+    $format = "%Y.%m.%d %H:%i:%s" if !$format;
+    
+    return "DATE_FORMAT($date, " . $self->quote($format) . ")";
+}
+
+sub sql_date_math {
+    my ($self, $date, $operator, $interval, $units) = @_;
+    
+    return "$date $operator INTERVAL $interval $units";
+}
+
+sub sql_iposition {
+    my ($self, $fragment, $text) = @_;
+    return "INSTR($text, $fragment)";
+}
+
+sub sql_position {
+    my ($self, $fragment, $text) = @_;
+
+    return "INSTR(CAST($text AS BINARY), CAST($fragment AS BINARY))";
+}
+
+sub sql_group_by {
+    my ($self, $needed_columns, $optional_columns) = @_;
+
+    # MySQL allows you to specify the minimal subset of columns to get
+    # a unique result. While it does allow specifying all columns as
+    # ANSI SQL requires, according to MySQL documentation, the fewer
+    # columns you specify, the faster the query runs.
+    return "GROUP BY $needed_columns";
+}
+
+sub bz_explain {
+    my ($self, $sql) = @_;
+    my $sth  = $self->prepare("EXPLAIN $sql");
+    $sth->execute();
+    my $columns = $sth->{'NAME'};
+    my $lengths = $sth->{'mysql_max_length'};
+    my $format_string = '|';
+    my $i = 0;
+    foreach my $column (@$columns) {
+        # Sometimes the column name is longer than the contents.
+        my $length = max($lengths->[$i], length($column));
+        $format_string .= ' %-' . $length . 's |';
+        $i++;
+    }
+
+    my $first_row = sprintf($format_string, @$columns);
+    my @explain_rows = ($first_row, '-' x length($first_row));
+    while (my $row = $sth->fetchrow_arrayref) {
+        my @fixed = map { defined $_ ? $_ : 'NULL' } @$row;
+        push(@explain_rows, sprintf($format_string, @fixed));
+    }
+
+    return join("\n", @explain_rows);
+}
+
+sub _bz_get_initial_schema {
+    my ($self) = @_;
+    return $self->_bz_build_schema_from_disk();
+}
+
+#####################################################################
+# Database Setup
+#####################################################################
+
+sub bz_check_server_version {
+    my $self = shift;
+
+    my $lc = Bugzilla->localconfig;
+    if (lc(Bugzilla->localconfig->{db_name}) eq 'mysql') {
+        die "It is not safe to run Bugzilla inside a database named 'mysql'.\n"
+            . " Please pick a different value for \$db_name in localconfig.\n";
+    }
+
+    $self->SUPER::bz_check_server_version(@_);
+}
+
+sub bz_setup_database {
+    my ($self) = @_;
+
+    # The "comments" field of the bugs_fulltext table could easily exceed
+    # MySQL's default max_allowed_packet. Also, MySQL should never have
+    # a max_allowed_packet smaller than our max_attachment_size. So, we
+    # warn the user here if max_allowed_packet is too small.
+    my $min_max_allowed = MAX_COMMENTS * MAX_COMMENT_LENGTH;
+    my (undef, $current_max_allowed) = $self->selectrow_array(
+        q{SHOW VARIABLES LIKE 'max\_allowed\_packet'});
+    # This parameter is not yet defined when the DB is being built for
+    # the very first time. The code below still works properly, however,
+    # because the default maxattachmentsize is smaller than $min_max_allowed.
+    my $max_attachment = (Bugzilla->params->{'maxattachmentsize'} || 0) * 1024;
+    my $needed_max_allowed = max($min_max_allowed, $max_attachment);
+    if ($current_max_allowed < $needed_max_allowed) {
+        warn install_string('max_allowed_packet',
+                            { current => $current_max_allowed,
+                              needed  => $needed_max_allowed }) . "\n";
+    }
+
+    # Make sure the installation has InnoDB turned on, or we're going to be
+    # doing silly things like making foreign keys on MyISAM tables, which is
+    # hard to fix later. We do this up here because none of the code below
+    # works if InnoDB is off. (Particularly if we've already converted the
+    # tables to InnoDB.)
+    my %engines = @{$self->selectcol_arrayref('SHOW ENGINES', {Columns => [1,2]})};
+    if (!$engines{InnoDB} || $engines{InnoDB} !~ /^(YES|DEFAULT)$/) {
+        die install_string('mysql_innodb_disabled');
+    }
+
+
+    my ($sd_index_deleted, $longdescs_index_deleted);
+    my @tables = $self->bz_table_list_real();
+    # We want to convert tables to InnoDB, but it's possible that they have 
+    # fulltext indexes on them, and conversion will fail unless we remove
+    # the indexes.
+    if (grep($_ eq 'bugs', @tables)
+        and !grep($_ eq 'bugs_fulltext', @tables))
+    {
+        if ($self->bz_index_info_real('bugs', 'short_desc')) {
+            $self->bz_drop_index_raw('bugs', 'short_desc');
+        }
+        if ($self->bz_index_info_real('bugs', 'bugs_short_desc_idx')) {
+            $self->bz_drop_index_raw('bugs', 'bugs_short_desc_idx');
+            $sd_index_deleted = 1; # Used for later schema cleanup.
+        }
+    }
+    if (grep($_ eq 'longdescs', @tables)
+        and !grep($_ eq 'bugs_fulltext', @tables))
+    {
+        if ($self->bz_index_info_real('longdescs', 'thetext')) {
+            $self->bz_drop_index_raw('longdescs', 'thetext');
+        }
+        if ($self->bz_index_info_real('longdescs', 'longdescs_thetext_idx')) {
+            $self->bz_drop_index_raw('longdescs', 'longdescs_thetext_idx');
+            $longdescs_index_deleted = 1; # For later schema cleanup.
+        }
+    }
+
+    # Upgrade tables from MyISAM to InnoDB
+    my $db_name = Bugzilla->localconfig->{db_name};
+    my $myisam_tables = $self->selectcol_arrayref(
+        'SELECT TABLE_NAME FROM information_schema.TABLES 
+          WHERE TABLE_SCHEMA = ? AND ENGINE = ?',
+        undef, $db_name, 'MyISAM');
+    foreach my $should_be_myisam (Bugzilla::DB::Schema::Mysql::MYISAM_TABLES) {
+        @$myisam_tables = grep { $_ ne $should_be_myisam } @$myisam_tables;
+    }
+
+    if (scalar @$myisam_tables) {
+        print "Bugzilla now uses the InnoDB storage engine in MySQL for",
+              " most tables.\nConverting tables to InnoDB:\n";
+        foreach my $table (@$myisam_tables) {
+            print "Converting table $table... ";
+            $self->do("ALTER TABLE $table ENGINE = InnoDB");
+            print "done.\n";
+        }
+    }
+    
+    # Versions of Bugzilla before the existence of Bugzilla::DB::Schema did 
+    # not provide explicit names for the table indexes. This means
+    # that our upgrades will not be reliable, because we look for the name
+    # of the index, not what fields it is on, when doing upgrades.
+    # (using the name is much better for cross-database compatibility 
+    # and general reliability). It's also very important that our
+    # Schema object be consistent with what is on the disk.
+    #
+    # While we're at it, we also fix some inconsistent index naming
+    # from the original checkin of Bugzilla::DB::Schema.
+
+    # We check for the existence of a particular "short name" index that
+    # has existed at least since Bugzilla 2.8, and probably earlier.
+    # For fixing the inconsistent naming of Schema indexes,
+    # we also check for one of those inconsistently-named indexes.
+    if (grep($_ eq 'bugs', @tables)
+        && ($self->bz_index_info_real('bugs', 'assigned_to')
+            || $self->bz_index_info_real('flags', 'flags_bidattid_idx')) )
+    {
+
+        # This is a check unrelated to the indexes, to see if people are
+        # upgrading from 2.18 or below, but somehow have a bz_schema table
+        # already. This only happens if they have done a mysqldump into
+        # a database without doing a DROP DATABASE first.
+        # We just do the check here since this check is a reliable way
+        # of telling that we are upgrading from a version pre-2.20.
+        if (grep($_ eq 'bz_schema', $self->bz_table_list_real())) {
+            die install_string('bz_schema_exists_before_220');
+        }
+
+        my $bug_count = $self->selectrow_array("SELECT COUNT(*) FROM bugs");
+        # We estimate one minute for each 3000 bugs, plus 3 minutes just
+        # to handle basic MySQL stuff.
+        my $rename_time = int($bug_count / 3000) + 3;
+        # And 45 minutes for every 15,000 attachments, per some experiments.
+        my ($attachment_count) = 
+            $self->selectrow_array("SELECT COUNT(*) FROM attachments");
+        $rename_time += int(($attachment_count * 45) / 15000);
+        # If we're going to take longer than 5 minutes, we let the user know
+        # and allow them to abort.
+        if ($rename_time > 5) {
+            print "\n", install_string('mysql_index_renaming',
+                                       { minutes => $rename_time });
+            # Wait 45 seconds for them to respond.
+            sleep(45) unless Bugzilla->installation_answers->{NO_PAUSE};
+        }
+        print "Renaming indexes...\n";
+
+        # We can't be interrupted, because of how the "if"
+        # works above.
+        local $SIG{INT}  = 'IGNORE';
+        local $SIG{TERM} = 'IGNORE';
+        local $SIG{PIPE} = 'IGNORE';
+
+        # Certain indexes had names in Schema that did not easily conform
+        # to a standard. We store those names here, so that they
+        # can be properly renamed.
+        # Also, sometimes an old mysqldump would incorrectly rename
+        # unique indexes to "PRIMARY", so we address that here, also.
+        my $bad_names = {
+            # 'when' is a possible leftover from Bugzillas before 2.8
+            bugs_activity => ['when', 'bugs_activity_bugid_idx',
+                'bugs_activity_bugwhen_idx'],
+            cc => ['PRIMARY'],
+            longdescs => ['longdescs_bugid_idx',
+               'longdescs_bugwhen_idx'],
+            flags => ['flags_bidattid_idx'],
+            flaginclusions => ['flaginclusions_tpcid_idx'],
+            flagexclusions => ['flagexclusions_tpc_id_idx'],
+            keywords => ['PRIMARY'],
+            milestones => ['PRIMARY'],
+            profiles_activity => ['profiles_activity_when_idx'],
+            group_control_map => ['group_control_map_gid_idx', 'PRIMARY'],
+            user_group_map => ['PRIMARY'],
+            group_group_map => ['PRIMARY'],
+            email_setting => ['PRIMARY'],
+            bug_group_map => ['PRIMARY'],
+            category_group_map => ['PRIMARY'],
+            watch => ['PRIMARY'],
+            namedqueries => ['PRIMARY'],
+            series_data => ['PRIMARY'],
+            # series_categories is dealt with below, not here.
+        };
+
+        # The series table is broken and needs to have one index
+        # dropped before we begin the renaming, because it had a
+        # useless index on it that would cause a naming conflict here.
+        if (grep($_ eq 'series', @tables)) {
+            my $dropname;
+            # This is what the bad index was called before Schema.
+            if ($self->bz_index_info_real('series', 'creator_2')) {
+                $dropname = 'creator_2';
+            }
+            # This is what the bad index is called in Schema.
+            elsif ($self->bz_index_info_real('series', 'series_creator_idx')) {
+                    $dropname = 'series_creator_idx';
+            }
+            $self->bz_drop_index_raw('series', $dropname) if $dropname;
+        }
+
+        # The email_setting table also had the same problem.
+        if( grep($_ eq 'email_setting', @tables) 
+            && $self->bz_index_info_real('email_setting', 
+                                         'email_settings_user_id_idx') ) 
+        {
+            $self->bz_drop_index_raw('email_setting', 
+                                     'email_settings_user_id_idx');
+        }
+
+        # Go through all the tables.
+        foreach my $table (@tables) {
+            # Will contain the names of old indexes as keys, and the 
+            # definition of the new indexes as a value. The values
+            # include an extra hash key, NAME, with the new name of 
+            # the index.
+            my %rename_indexes;
+            # And go through all the columns on each table.
+            my @columns = $self->bz_table_columns_real($table);
+
+            # We also want to fix the silly naming of unique indexes
+            # that happened when we first checked-in Bugzilla::DB::Schema.
+            if ($table eq 'series_categories') {
+                # The series_categories index had a nonstandard name.
+                push(@columns, 'series_cats_unique_idx');
+            } 
+            elsif ($table eq 'email_setting') { 
+                # The email_setting table had a similar problem.
+                push(@columns, 'email_settings_unique_idx');
+            }
+            else {
+                push(@columns, "${table}_unique_idx");
+            }
+            # And this is how we fix the other inconsistent Schema naming.
+            push(@columns, @{$bad_names->{$table}})
+                if (exists $bad_names->{$table});
+            foreach my $column (@columns) {
+                # If we have an index named after this column, it's an 
+                # old-style-name index.
+                if (my $index = $self->bz_index_info_real($table, $column)) {
+                    # Fix the name to fit in with the new naming scheme.
+                    $index->{NAME} = $table . "_" .
+                                     $index->{FIELDS}->[0] . "_idx";
+                    print "Renaming index $column to " 
+                          . $index->{NAME} . "...\n";
+                    $rename_indexes{$column} = $index;
+                } # if
+            } # foreach column
+
+            my @rename_sql = $self->_bz_schema->get_rename_indexes_ddl(
+                $table, %rename_indexes);
+            $self->do($_) foreach (@rename_sql);
+
+        } # foreach table
+    } # if old-name indexes
+
+    # If there are no tables, but the DB isn't utf8 and it should be,
+    # then we should alter the database to be utf8. We know it should be
+    # if the utf8 parameter is true or there are no params at all.
+    # This kind of situation happens when people create the database
+    # themselves, and if we don't do this they will get the big
+    # scary WARNING statement about conversion to UTF8.
+    if ( !$self->bz_db_is_utf8 && !@tables 
+         && (Bugzilla->params->{'utf8'} || !scalar keys %{Bugzilla->params}) )
+    {
+        $self->_alter_db_charset_to_utf8();
+    }
+
+    # And now we create the tables and the Schema object.
+    $self->SUPER::bz_setup_database();
+
+    if ($sd_index_deleted) {
+        $self->_bz_real_schema->delete_index('bugs', 'bugs_short_desc_idx');
+        $self->_bz_store_real_schema;
+    }
+    if ($longdescs_index_deleted) {
+        $self->_bz_real_schema->delete_index('longdescs', 
+                                             'longdescs_thetext_idx');
+        $self->_bz_store_real_schema;
+    }
+
+    # The old timestamp fields need to be adjusted here instead of in
+    # checksetup. Otherwise the UPDATE statements inside of bz_add_column
+    # will cause accidental timestamp updates.
+    # The code that does this was moved here from checksetup.
+
+    # 2002-08-14 - bbaetz@student.usyd.edu.au - bug 153578
+    # attachments creation time needs to be a datetime, not a timestamp
+    my $attach_creation = 
+        $self->bz_column_info("attachments", "creation_ts");
+    if ($attach_creation && $attach_creation->{TYPE} =~ /^TIMESTAMP/i) {
+        print "Fixing creation time on attachments...\n";
+
+        my $sth = $self->prepare("SELECT COUNT(attach_id) FROM attachments");
+        $sth->execute();
+        my ($attach_count) = $sth->fetchrow_array();
+
+        if ($attach_count > 1000) {
+            print "This may take a while...\n";
+        }
+        my $i = 0;
+
+        # This isn't just as simple as changing the field type, because
+        # the creation_ts was previously updated when an attachment was made
+        # obsolete from the attachment creation screen. So we have to go
+        # and recreate these times from the comments..
+        $sth = $self->prepare("SELECT bug_id, attach_id, submitter_id " .
+                               "FROM attachments");
+        $sth->execute();
+
+        # Restrict this as much as possible in order to avoid false 
+        # positives, and keep the db search time down
+        my $sth2 = $self->prepare("SELECT bug_when FROM longdescs 
+                                    WHERE bug_id=? AND who=? 
+                                          AND thetext LIKE ?
+                                 ORDER BY bug_when " . $self->sql_limit(1));
+        while (my ($bug_id, $attach_id, $submitter_id) 
+                  = $sth->fetchrow_array()) 
+        {
+            $sth2->execute($bug_id, $submitter_id, 
+                "Created an attachment (id=$attach_id)%");
+            my ($when) = $sth2->fetchrow_array();
+            if ($when) {
+                $self->do("UPDATE attachments " .
+                             "SET creation_ts='$when' " .
+                           "WHERE attach_id=$attach_id");
+            } else {
+                print "Warning - could not determine correct creation"
+                      . " time for attachment $attach_id on bug $bug_id\n";
+            }
+            ++$i;
+            print "Converted $i of $attach_count attachments\n" if !($i % 1000);
+        }
+        print "Done - converted $i attachments\n";
+
+        $self->bz_alter_column("attachments", "creation_ts", 
+                               {TYPE => 'DATETIME', NOTNULL => 1});
+    }
+
+    # 2004-08-29 - Tomas.Kopal@altap.cz, bug 257303
+    # Change logincookies.lastused type from timestamp to datetime
+    my $login_lastused = $self->bz_column_info("logincookies", "lastused");
+    if ($login_lastused && $login_lastused->{TYPE} =~ /^TIMESTAMP/i) {
+        $self->bz_alter_column('logincookies', 'lastused', 
+                               { TYPE => 'DATETIME',  NOTNULL => 1});
+    }
+
+    # 2005-01-17 - Tomas.Kopal@altap.cz, bug 257315
+    # Change bugs.delta_ts type from timestamp to datetime 
+    my $bugs_deltats = $self->bz_column_info("bugs", "delta_ts");
+    if ($bugs_deltats && $bugs_deltats->{TYPE} =~ /^TIMESTAMP/i) {
+        $self->bz_alter_column('bugs', 'delta_ts', 
+                               {TYPE => 'DATETIME', NOTNULL => 1});
+    }
+
+    # 2005-09-24 - bugreport@peshkin.net, bug 307602
+    # Make sure that default 4G table limit is overridden
+    my $attach_data_create = $self->selectrow_array(
+        'SELECT CREATE_OPTIONS FROM information_schema.TABLES 
+          WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ?',
+        undef, $db_name, 'attach_data');
+    if ($attach_data_create !~ /MAX_ROWS/i) {
+        print "Converting attach_data maximum size to 100G...\n";
+        $self->do("ALTER TABLE attach_data
+                   AVG_ROW_LENGTH=1000000,
+                   MAX_ROWS=100000");
+    }
+
+    # Convert the database to UTF-8 if the utf8 parameter is on.
+    # We check if any table isn't utf8, because lots of crazy
+    # partial-conversion situations can happen, and this handles anything
+    # that could come up (including having the DB charset be utf8 but not
+    # the table charsets.
+    #
+    # TABLE_COLLATION IS NOT NULL prevents us from trying to convert views.
+    my $non_utf8_tables = $self->selectrow_array(
+        "SELECT 1 FROM information_schema.TABLES 
+          WHERE TABLE_SCHEMA = ? AND TABLE_COLLATION IS NOT NULL 
+                AND TABLE_COLLATION NOT LIKE 'utf8%' 
+          LIMIT 1", undef, $db_name);
+    
+    if (Bugzilla->params->{'utf8'} && $non_utf8_tables) {
+        print "\n", install_string('mysql_utf8_conversion');
+
+        if (!Bugzilla->installation_answers->{NO_PAUSE}) {
+            if (Bugzilla->installation_mode == 
+                INSTALLATION_MODE_NON_INTERACTIVE) 
+            {
+                die install_string('continue_without_answers'), "\n";
+            }
+            else {
+                print "\n         " . install_string('enter_or_ctrl_c');
+                getc;
+            }
+        }
+
+        print "Converting table storage format to UTF-8. This may take a",
+              " while.\n";
+        foreach my $table ($self->bz_table_list_real) {
+            my $info_sth = $self->prepare("SHOW FULL COLUMNS FROM $table");
+            $info_sth->execute();
+            my (@binary_sql, @utf8_sql);
+            while (my $column = $info_sth->fetchrow_hashref) {
+                # Our conversion code doesn't work on enum fields, but they
+                # all go away later in checksetup anyway.
+                next if $column->{Type} =~ /enum/i;
+
+                # If this particular column isn't stored in utf-8
+                if ($column->{Collation}
+                    && $column->{Collation} ne 'NULL' 
+                    && $column->{Collation} !~ /utf8/) 
+                {
+                    my $name = $column->{Field};
+
+                    print "$table.$name needs to be converted to UTF-8...\n";
+
+                    # These will be automatically re-created at the end
+                    # of checksetup.
+                    $self->bz_drop_related_fks($table, $name);
+
+                    my $col_info =
+                        $self->bz_column_info_real($table, $name);
+                    # CHANGE COLUMN doesn't take PRIMARY KEY
+                    delete $col_info->{PRIMARYKEY};
+                    my $sql_def = $self->_bz_schema->get_type_ddl($col_info);
+                    # We don't want MySQL to actually try to *convert*
+                    # from our current charset to UTF-8, we just want to
+                    # transfer the bytes directly. This is how we do that.
+
+                    # The CHARACTER SET part of the definition has to come
+                    # right after the type, which will always come first.
+                    my ($binary, $utf8) = ($sql_def, $sql_def);
+                    my $type = $self->_bz_schema->convert_type($col_info->{TYPE});
+                    $binary =~ s/(\Q$type\E)/$1 CHARACTER SET binary/;
+                    $utf8   =~ s/(\Q$type\E)/$1 CHARACTER SET utf8/;
+                    push(@binary_sql, "MODIFY COLUMN $name $binary");
+                    push(@utf8_sql, "MODIFY COLUMN $name $utf8");
+                }
+            } # foreach column
+
+            if (@binary_sql) {
+                my %indexes = %{ $self->bz_table_indexes($table) };
+                foreach my $index_name (keys %indexes) {
+                    my $index = $indexes{$index_name};
+                    if ($index->{TYPE} and $index->{TYPE} eq 'FULLTEXT') {
+                        $self->bz_drop_index($table, $index_name);
+                    }
+                    else {
+                        delete $indexes{$index_name};
+                    }
+                }
+
+                print "Converting the $table table to UTF-8...\n";
+                my $bin = "ALTER TABLE $table " . join(', ', @binary_sql);
+                my $utf = "ALTER TABLE $table " . join(', ', @utf8_sql,
+                          'DEFAULT CHARACTER SET utf8');
+                $self->do($bin);
+                $self->do($utf);
+
+                # Re-add any removed FULLTEXT indexes.
+                foreach my $index (keys %indexes) {
+                    $self->bz_add_index($table, $index, $indexes{$index});
+                }
+            }
+            else {
+                $self->do("ALTER TABLE $table DEFAULT CHARACTER SET utf8");
+            }
+
+        } # foreach my $table (@tables)
+    }
+
+    # Sometimes you can have a situation where all the tables are utf8,
+    # but the database isn't. (This tends to happen when you've done
+    # a mysqldump.) So we have this change outside of the above block,
+    # so that it just happens silently if no actual *table* conversion
+    # needs to happen.
+    if (Bugzilla->params->{'utf8'} && !$self->bz_db_is_utf8) {
+        $self->_alter_db_charset_to_utf8();
+    }
+
+     $self->_fix_defaults();
+
+    # Bug 451735 highlighted a bug in bz_drop_index() which didn't
+    # check for FKs before trying to delete an index. Consequently,
+    # the series_creator_idx index was considered to be deleted
+    # despite it was still present in the DB. That's why we have to
+    # force the deletion, bypassing the DB schema.
+    if (!$self->bz_index_info('series', 'series_category_idx')) {
+        if (!$self->bz_index_info('series', 'series_creator_idx')
+            && $self->bz_index_info_real('series', 'series_creator_idx'))
+        {
+            foreach my $column (qw(creator category subcategory name)) {
+                $self->bz_drop_related_fks('series', $column);
+            }
+            $self->bz_drop_index_raw('series', 'series_creator_idx');
+        }
+    }
+}
+
+# When you import a MySQL 3/4 mysqldump into MySQL 5, columns that
+# aren't supposed to have defaults will have defaults. This is only
+# a minor issue, but it makes our tests fail, and it's good to keep
+# the DB actually consistent with what DB::Schema thinks the database
+# looks like. So we remove defaults from columns that aren't supposed
+# to have them
+sub _fix_defaults {
+    my $self = shift;
+    my $maj_version = substr($self->bz_server_version, 0, 1);
+    return if $maj_version < 5;
+
+    # The oldest column that could have this problem is bugs.assigned_to,
+    # so if it doesn't have the problem, we just skip doing this entirely.
+    my $assi_def = $self->_bz_raw_column_info('bugs', 'assigned_to');
+    my $assi_default = $assi_def->{COLUMN_DEF};
+    # This "ne ''" thing is necessary because _raw_column_info seems to
+    # return COLUMN_DEF as an empty string for columns that don't have
+    # a default.
+    return unless (defined $assi_default && $assi_default ne '');
+
+    my %fix_columns;
+    foreach my $table ($self->_bz_real_schema->get_table_list()) {
+        foreach my $column ($self->bz_table_columns($table)) {
+            my $abs_def = $self->bz_column_info($table, $column);
+            # BLOB/TEXT columns never have defaults
+            next if $abs_def->{TYPE} =~ /BLOB|TEXT/i;
+            if (!defined $abs_def->{DEFAULT}) {
+                # Get the exact default from the database without any
+                # "fixing" by bz_column_info_real.
+                my $raw_info = $self->_bz_raw_column_info($table, $column);
+                my $raw_default = $raw_info->{COLUMN_DEF};
+                if (defined $raw_default) {
+                    if ($raw_default eq '') {
+                        # Only (var)char columns can have empty strings as 
+                        # defaults, so if we got an empty string for some
+                        # other default type, then it's bogus.
+                        next unless $abs_def->{TYPE} =~ /char/i;
+                        $raw_default = "''";
+                    }
+                    $fix_columns{$table} ||= [];
+                    push(@{ $fix_columns{$table} }, $column);
+                    print "$table.$column has incorrect DB default: $raw_default\n";
+                }
+            }
+        } # foreach $column
+    } # foreach $table
+
+    print "Fixing defaults...\n";
+    foreach my $table (reverse sort keys %fix_columns) {
+        my @alters = map("ALTER COLUMN $_ DROP DEFAULT", 
+                         @{ $fix_columns{$table} });
+        my $sql = "ALTER TABLE $table " . join(',', @alters);
+        $self->do($sql);
+    }
+}
+
+sub _alter_db_charset_to_utf8 {
+    my $self = shift;
+    my $db_name = Bugzilla->localconfig->{db_name};
+    $self->do("ALTER DATABASE $db_name CHARACTER SET utf8"); 
+}
+
+sub bz_db_is_utf8 {
+    my $self = shift;
+    my $db_collation = $self->selectrow_arrayref(
+        "SHOW VARIABLES LIKE 'character_set_database'");
+    # First column holds the variable name, second column holds the value.
+    return $db_collation->[1] =~ /utf8/ ? 1 : 0;
+}
+
+
+sub bz_enum_initial_values {
+    my ($self) = @_;
+    my %enum_values = %{$self->ENUM_DEFAULTS};
+    # Get a complete description of the 'bugs' table; with DBD::MySQL
+    # there isn't a column-by-column way of doing this.  Could use
+    # $dbh->column_info, but it would go slower and we would have to
+    # use the undocumented mysql_type_name accessor to get the type
+    # of each row.
+    my $sth = $self->prepare("DESCRIBE bugs");
+    $sth->execute();
+    # Look for the particular columns we are interested in.
+    while (my ($thiscol, $thistype) = $sth->fetchrow_array()) {
+        if (defined $enum_values{$thiscol}) {
+            # this is a column of interest.
+            my @value_list;
+            if ($thistype and ($thistype =~ /^enum\(/)) {
+                # it has an enum type; get the set of values.
+                while ($thistype =~ /'([^']*)'(.*)/) {
+                    push(@value_list, $1);
+                    $thistype = $2;
+                }
+            }
+            if (@value_list) {
+                # record the enum values found.
+                $enum_values{$thiscol} = \@value_list;
+            }
+        }
+    }
+
+    return \%enum_values;
+}
+
+#####################################################################
+# MySQL-specific Database-Reading Methods
+#####################################################################
+
+=begin private
+
+=head1 MYSQL-SPECIFIC DATABASE-READING METHODS
+
+These methods read information about the database from the disk,
+instead of from a Schema object. They are only reliable for MySQL 
+(see bug 285111 for the reasons why not all DBs use/have functions
+like this), but that's OK because we only need them for 
+backwards-compatibility anyway, for versions of Bugzilla before 2.20.
+
+=over 4
+
+=item C<bz_column_info_real($table, $column)>
+
+ Description: Returns an abstract column definition for a column
+              as it actually exists on disk in the database.
+ Params:      $table - The name of the table the column is on.
+              $column - The name of the column you want info about.
+ Returns:     An abstract column definition.
+              If the column does not exist, returns undef.
+
+=cut
+
+sub bz_column_info_real {
+    my ($self, $table, $column) = @_;
+    my $col_data = $self->_bz_raw_column_info($table, $column);
+    return $self->_bz_schema->column_info_to_column($col_data);
+}
+
+sub _bz_raw_column_info {
+    my ($self, $table, $column) = @_;
+
+    # DBD::mysql does not support selecting a specific column,
+    # so we have to get all the columns on the table and find 
+    # the one we want.
+    my $info_sth = $self->column_info(undef, undef, $table, '%');
+
+    # Don't use fetchall_hashref as there's a Win32 DBI bug (292821)
+    my $col_data;
+    while ($col_data = $info_sth->fetchrow_hashref) {
+        last if $col_data->{'COLUMN_NAME'} eq $column;
+    }
+
+    if (!defined $col_data) {
+        return undef;
+    }
+    return $col_data;
+}
+
+=item C<bz_index_info_real($table, $index)>
+
+ Description: Returns information about an index on a table in the database.
+ Params:      $table = name of table containing the index
+              $index = name of an index
+ Returns:     An abstract index definition, always in hashref format.
+              If the index does not exist, the function returns undef.
+
+=cut
+
+sub bz_index_info_real {
+    my ($self, $table, $index) = @_;
+
+    my $sth = $self->prepare("SHOW INDEX FROM $table");
+    $sth->execute;
+
+    my @fields;
+    my $index_type;
+    # $raw_def will be an arrayref containing the following information:
+    # 0 = name of the table that the index is on
+    # 1 = 0 if unique, 1 if not unique
+    # 2 = name of the index
+    # 3 = seq_in_index (The order of the current field in the index).
+    # 4 = Name of ONE column that the index is on
+    # 5 = 'Collation' of the index. Usually 'A'.
+    # 6 = Cardinality. Either a number or undef.
+    # 7 = sub_part. Usually undef. Sometimes 1.
+    # 8 = "packed". Usually undef.
+    # 9 = Null. Sometimes undef, sometimes 'YES'.
+    # 10 = Index_type. The type of the index. Usually either 'BTREE' or 'FULLTEXT'
+    # 11 = 'Comment.' Usually undef.
+    while (my $raw_def = $sth->fetchrow_arrayref) {
+        if ($raw_def->[2] eq $index) {
+            push(@fields, $raw_def->[4]);
+            # No index can be both UNIQUE and FULLTEXT, that's why
+            # this is written this way.
+            $index_type = $raw_def->[1] ? '' : 'UNIQUE';
+            $index_type = $raw_def->[10] eq 'FULLTEXT'
+                ? 'FULLTEXT' : $index_type;
+        }
+    }
+
+    my $retval;
+    if (scalar(@fields)) {
+        $retval = {FIELDS => \@fields, TYPE => $index_type};
+    }
+    return $retval;
+}
+
+=item C<bz_index_list_real($table)>
+
+ Description: Returns a list of index names on a table in 
+              the database, as it actually exists on disk.
+ Params:      $table - The name of the table you want info about.
+ Returns:     An array of index names.
+
+=cut
+
+sub bz_index_list_real {
+    my ($self, $table) = @_;
+    my $sth = $self->prepare("SHOW INDEX FROM $table");
+    # Column 3 of a SHOW INDEX statement contains the name of the index.
+    return @{ $self->selectcol_arrayref($sth, {Columns => [3]}) };
+}
+
+#####################################################################
+# MySQL-Specific "Schema Builder"
+#####################################################################
+
+=back
+
+=head1 MYSQL-SPECIFIC "SCHEMA BUILDER"
+
+MySQL needs to be able to read in a legacy database (from before 
+Schema existed) and create a Schema object out of it. That's what
+this code does.
+
+=end private
+
+=cut
+
+# This sub itself is actually written generically, but the subroutines
+# that it depends on are database-specific. In particular, the
+# bz_column_info_real function would be very difficult to create
+# properly for any other DB besides MySQL.
+sub _bz_build_schema_from_disk {
+    my ($self) = @_;
+
+    my $schema = $self->_bz_schema->get_empty_schema();
+
+    my @tables = $self->bz_table_list_real();
+    if (@tables) {
+        print "Building Schema object from database...\n"; 
+    }
+    foreach my $table (@tables) {
+        $schema->add_table($table);
+        my @columns = $self->bz_table_columns_real($table);
+        foreach my $column (@columns) {
+            my $type_info = $self->bz_column_info_real($table, $column);
+            $schema->set_column($table, $column, $type_info);
+        }
+
+        my @indexes = $self->bz_index_list_real($table);
+        foreach my $index (@indexes) {
+            unless ($index eq 'PRIMARY') {
+                my $index_info = $self->bz_index_info_real($table, $index);
+                ($index_info = $index_info->{FIELDS}) 
+                    if (!$index_info->{TYPE});
+                $schema->set_index($table, $index, $index_info);
+            }
+        }
+    }
+
+    return $schema;
+}
+
+1;

diff --git a/Bugzilla/DB/Oracle.pm b/Bugzilla/DB/Oracle.pm
new file mode 100644 (file)
index 0000000..6511242
--- /dev/null
+++ b/Bugzilla/DB/Oracle.pm
@@ -0,0 +1,783 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+=head1 NAME
+
+Bugzilla::DB::Oracle - Bugzilla database compatibility layer for Oracle
+
+=head1 DESCRIPTION
+
+This module overrides methods of the Bugzilla::DB module with Oracle
+specific implementation. It is instantiated by the Bugzilla::DB module
+and should never be used directly.
+
+For interface details see L<Bugzilla::DB> and L<DBI>.
+
+=cut
+
+package Bugzilla::DB::Oracle;
+use strict;
+use base qw(Bugzilla::DB);
+
+use DBD::Oracle;
+use DBD::Oracle qw(:ora_types);
+use List::Util qw(max);
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Util;
+
+#####################################################################
+# Constants
+#####################################################################
+use constant EMPTY_STRING  => '__BZ_EMPTY_STR__';
+use constant ISOLATION_LEVEL => 'READ COMMITTED';
+use constant BLOB_TYPE => { ora_type => ORA_BLOB };
+# The max size allowed for LOB fields, in kilobytes.
+use constant MIN_LONG_READ_LEN => 32 * 1024;
+use constant FULLTEXT_OR => ' OR ';
+
+our $fulltext_label = 0;
+
+sub new {
+    my ($class, $params) = @_;
+    my ($user, $pass, $host, $dbname, $port) = 
+        @$params{qw(db_user db_pass db_host db_name db_port)};
+
+    # You can never connect to Oracle without a DB name,
+    # and there is no default DB.
+    $dbname ||= Bugzilla->localconfig->{db_name};
+
+    # Set the language enviroment
+    $ENV{'NLS_LANG'} = '.AL32UTF8' if Bugzilla->params->{'utf8'};
+
+    # construct the DSN from the parameters we got
+    my $dsn = "dbi:Oracle:host=$host;sid=$dbname";
+    $dsn .= ";port=$port" if $port;
+    my $attrs = { FetchHashKeyName => 'NAME_lc',  
+                  LongReadLen => max(Bugzilla->params->{'maxattachmentsize'} || 0,
+                                     MIN_LONG_READ_LEN) * 1024,
+                };
+    my $self = $class->db_new({ dsn => $dsn, user => $user, 
+                                pass => $pass, attrs => $attrs });
+    # Needed by TheSchwartz
+    $self->{private_bz_dsn} = $dsn;
+
+    bless ($self, $class);
+
+    # Set the session's default date format to match MySQL
+    $self->do("ALTER SESSION SET NLS_DATE_FORMAT='YYYY-MM-DD HH24:MI:SS'");
+    $self->do("ALTER SESSION SET NLS_TIMESTAMP_FORMAT='YYYY-MM-DD HH24:MI:SS'");
+    $self->do("ALTER SESSION SET NLS_LENGTH_SEMANTICS='CHAR'") 
+        if Bugzilla->params->{'utf8'};
+    # To allow case insensitive query.
+    $self->do("ALTER SESSION SET NLS_COMP='ANSI'");
+    $self->do("ALTER SESSION SET NLS_SORT='BINARY_AI'");
+    return $self;
+}
+
+sub bz_last_key {
+    my ($self, $table, $column) = @_;
+
+    my $seq = $table . "_" . $column . "_SEQ";
+    my ($last_insert_id) = $self->selectrow_array("SELECT $seq.CURRVAL "
+                                                  . " FROM DUAL");
+    return $last_insert_id;
+}
+
+sub bz_check_regexp {
+    my ($self, $pattern) = @_;
+
+    eval { $self->do("SELECT 1 FROM DUAL WHERE "
+          . $self->sql_regexp($self->quote("a"), $pattern, 1)) };
+
+    $@ && ThrowUserError('illegal_regexp',
+        { value => $pattern, dberror => $self->errstr });
+}
+
+sub bz_explain { 
+     my ($self, $sql) = @_; 
+     my $sth = $self->prepare("EXPLAIN PLAN FOR $sql"); 
+     $sth->execute();
+     my $explain = $self->selectcol_arrayref(
+         "SELECT PLAN_TABLE_OUTPUT FROM TABLE(DBMS_XPLAN.DISPLAY)");
+     return join("\n", @$explain); 
+} 
+
+sub sql_group_concat {
+    my ($self, $text, $separator) = @_;
+    $separator = $self->quote(', ') if !defined $separator;
+    my ($distinct, $rest) = $text =~/^(\s*DISTINCT\s|)(.+)$/i;
+    return "group_concat($distinct T_CLOB_DELIM(NVL($rest, ' '), $separator))";
+}
+
+sub sql_regexp {
+    my ($self, $expr, $pattern, $nocheck, $real_pattern) = @_;
+    $real_pattern ||= $pattern;
+
+    $self->bz_check_regexp($real_pattern) if !$nocheck;
+
+    return "REGEXP_LIKE($expr, $pattern)";
+}
+
+sub sql_not_regexp {
+    my ($self, $expr, $pattern, $nocheck, $real_pattern) = @_;
+    $real_pattern ||= $pattern;
+
+    $self->bz_check_regexp($real_pattern) if !$nocheck;
+
+    return "NOT REGEXP_LIKE($expr, $pattern)" 
+}
+
+sub sql_limit {
+    my ($self, $limit, $offset) = @_;
+
+    if(defined $offset) {
+        return  "/* LIMIT $limit $offset */";
+    }
+    return "/* LIMIT $limit */";
+}
+
+sub sql_string_concat {
+    my ($self, @params) = @_;
+
+    return 'CONCAT(' . join(', ', @params) . ')';
+}
+
+sub sql_to_days {
+    my ($self, $date) = @_;
+
+    return " TO_CHAR(TO_DATE($date),'J') ";
+}
+sub sql_from_days{
+    my ($self, $date) = @_;
+
+    return " TO_DATE($date,'J') ";
+}
+
+sub sql_fulltext_search {
+    my ($self, $column, $text) = @_;
+    $text = $self->quote($text);
+    trick_taint($text);
+    $fulltext_label++;
+    return "CONTAINS($column,$text,$fulltext_label) > 0", "SCORE($fulltext_label)";
+}
+
+sub sql_date_format {
+    my ($self, $date, $format) = @_;
+    
+    $format = "%Y.%m.%d %H:%i:%s" if !$format;
+
+    $format =~ s/\%Y/YYYY/g;
+    $format =~ s/\%y/YY/g;
+    $format =~ s/\%m/MM/g;
+    $format =~ s/\%d/DD/g;
+    $format =~ s/\%a/Dy/g;
+    $format =~ s/\%H/HH24/g;
+    $format =~ s/\%i/MI/g;
+    $format =~ s/\%s/SS/g;
+
+    return "TO_CHAR($date, " . $self->quote($format) . ")";
+}
+
+sub sql_date_math {
+    my ($self, $date, $operator, $interval, $units) = @_;
+    my $time_sql;
+    if ($units =~ /YEAR|MONTH/i) {
+        $time_sql = "NUMTOYMINTERVAL($interval,'$units')";
+    } else{
+        $time_sql = "NUMTODSINTERVAL($interval,'$units')";
+    }
+   return "$date $operator $time_sql";
+}
+
+sub sql_position {
+    my ($self, $fragment, $text) = @_;
+    return "INSTR($text, $fragment)";
+}
+
+sub sql_in {
+    my ($self, $column_name, $in_list_ref, $negate) = @_;
+    my @in_list = @$in_list_ref;
+    return $self->SUPER::sql_in($column_name, $in_list_ref, $negate) if $#in_list < 1000;
+    my @in_str;
+    while (@in_list) {
+        my $length = $#in_list + 1;
+        my $splice = $length > 1000 ? 1000 : $length;
+        my @sub_in_list = splice(@in_list, 0, $splice);
+        push(@in_str, 
+             $self->SUPER::sql_in($column_name, \@sub_in_list, $negate));
+    }
+    return "( " . join(" OR ", @in_str) . " )";
+}
+
+sub _bz_add_field_table {
+    my ($self, $name, $schema_ref, $type) = @_;
+    $self->SUPER::_bz_add_field_table($name, $schema_ref);
+    if (defined($type) && $type == FIELD_TYPE_MULTI_SELECT) {
+        my $uk_name = "UK_" . $self->_bz_schema->_hash_identifier($name . '_value');
+        $self->do("ALTER TABLE $name ADD CONSTRAINT $uk_name UNIQUE(value)");
+    }
+}
+
+sub bz_drop_table {
+     my ($self, $name) = @_;
+     my $table_exists = $self->bz_table_info($name);
+     if ($table_exists) {
+         $self->_bz_drop_fks($name);
+         $self->SUPER::bz_drop_table($name);
+     }
+}
+
+# Dropping all FKs for a specified table. 
+sub _bz_drop_fks {
+    my ($self, $table) = @_;
+    my @columns = $self->bz_table_columns($table);
+    foreach my $column (@columns) {
+        $self->bz_drop_fk($table, $column);
+    }
+}
+
+sub _fix_empty {
+    my ($string) = @_;
+    $string = '' if $string eq EMPTY_STRING;
+    return $string;
+}
+
+sub _fix_arrayref {
+    my ($row) = @_;
+    return undef if !defined $row;
+    foreach my $field (@$row) {
+        $field = _fix_empty($field) if defined $field;
+    }
+    return $row;
+}
+
+sub _fix_hashref {
+     my ($row) = @_;
+     return undef if !defined $row;
+     foreach my $value (values %$row) {
+       $value = _fix_empty($value) if defined $value;
+     }
+     return $row;
+}
+
+sub adjust_statement {
+    my ($sql) = @_;
+    
+    if ($sql =~ /^CREATE OR REPLACE.*/i){
+        return $sql;
+    } 
+
+    # We can't just assume any occurrence of "''" in $sql is an empty
+    # string, since "''" can occur inside a string literal as a way of
+    # escaping a single "'" in the literal.  Therefore we must be trickier...
+
+    # split the statement into parts by single-quotes.  The negative value
+    # at the end to the split operator from dropping trailing empty strings
+    # (e.g., when $sql ends in "''")
+    my @parts = split /'/, $sql, -1;
+
+    if( !(@parts % 2) ) {
+        # Either the string is empty or the quotes are mismatched
+        # Returning input unmodified.
+        return $sql;
+    }
+
+    # We already verified that we have an odd number of parts.  If we take
+    # the first part off now, we know we're entering the loop with an even
+    # number of parts
+    my @result;
+    my $part = shift @parts;
+    
+    # Oracle requires a FROM clause in all SELECT statements, so append
+    # "FROM dual" to queries without one (e.g., "SELECT NOW()")
+    my $is_select = ($part =~ m/^\s*SELECT\b/io);
+    my $has_from =  ($part =~ m/\bFROM\b/io) if $is_select;
+
+    # Oracle includes the time in CURRENT_DATE.
+    $part =~ s/\bCURRENT_DATE\b/TRUNC(CURRENT_DATE)/io;
+
+    # Oracle use SUBSTR instead of SUBSTRING
+    $part =~ s/\bSUBSTRING\b/SUBSTR/io;
+   
+    # Oracle need no 'AS'
+    $part =~ s/\bAS\b//ig;
+    
+    # Oracle doesn't have LIMIT, so if we find the LIMIT comment, wrap the
+    # query with "SELECT * FROM (...) WHERE rownum < $limit"
+    my ($limit,$offset) = ($part =~ m{/\* LIMIT (\d*) (\d*) \*/}o);
+    
+    push @result, $part;
+    while( @parts ) {
+        my $string = shift @parts;
+        my $nonstring = shift @parts;
+    
+        # if the non-string part is zero-length and there are more parts left,
+        # then this is an escaped quote inside a string literal   
+        while( !(length $nonstring) && @parts  ) {
+            # we know it's safe to remove two parts at a time, since we
+            # entered the loop with an even number of parts
+            $string .= "''" . shift @parts;
+            $nonstring = shift @parts;
+        }
+
+        # Look for a FROM if this is a SELECT and we haven't found one yet
+        $has_from = ($nonstring =~ m/\bFROM\b/io) 
+                    if ($is_select and !$has_from);
+
+        # Oracle includes the time in CURRENT_DATE.
+        $nonstring =~ s/\bCURRENT_DATE\b/TRUNC(CURRENT_DATE)/io;
+
+        # Oracle use SUBSTR instead of SUBSTRING
+        $nonstring =~ s/\bSUBSTRING\b/SUBSTR/io;
+
+        # Oracle need no 'AS'
+        $nonstring =~ s/\bAS\b//ig;
+
+        # Look for a LIMIT clause
+        ($limit) = ($nonstring =~ m(/\* LIMIT (\d*) \*/)o);
+
+        if(!length($string)){
+           push @result, EMPTY_STRING;
+           push @result, $nonstring;
+        } else {
+           push @result, $string;
+           push @result, $nonstring;
+        }
+    }
+
+    my $new_sql = join "'", @result;
+
+    # Append "FROM dual" if this is a SELECT without a FROM clause
+    $new_sql .= " FROM DUAL" if ($is_select and !$has_from);
+
+    # Wrap the query with a "WHERE rownum <= ..." if we found LIMIT
+    
+    if (defined($limit)) {
+        if ($new_sql !~ /\bWHERE\b/) {
+            $new_sql = $new_sql." WHERE 1=1";
+        }
+        my ($before_where, $after_where) = split(/\bWHERE\b/i, $new_sql, 2);
+        if (defined($offset)) {
+            my ($before_from, $after_from) = split(/\bFROM\b/i, $new_sql, 2);
+            $before_where = "$before_from FROM ($before_from,"
+                          . " ROW_NUMBER() OVER (ORDER BY 1) R "
+                          . " FROM $after_from ) "; 
+            $after_where = " R BETWEEN $offset+1 AND $limit+$offset";
+        } else {
+            $after_where = " rownum <=$limit AND ".$after_where;
+        }
+        $new_sql = $before_where." WHERE ".$after_where;
+    }
+    return $new_sql;
+}
+
+sub do {
+    my $self = shift;
+    my $sql  = shift;
+    $sql = adjust_statement($sql);
+    unshift @_, $sql;
+    return $self->SUPER::do(@_);
+}
+
+sub selectrow_array {
+    my $self = shift;
+    my $stmt = shift;
+    my $new_stmt = (ref $stmt) ? $stmt : adjust_statement($stmt);
+    unshift @_, $new_stmt;
+    if ( wantarray ) {
+        my @row = $self->SUPER::selectrow_array(@_);
+        _fix_arrayref(\@row);
+        return @row;
+    } else {
+        my $row = $self->SUPER::selectrow_array(@_);
+        $row = _fix_empty($row) if defined $row;
+        return $row;
+    }
+}
+
+sub selectrow_arrayref {
+    my $self = shift;
+    my $stmt = shift;
+    my $new_stmt = (ref $stmt) ? $stmt : adjust_statement($stmt);
+    unshift @_, $new_stmt;
+    my $ref = $self->SUPER::selectrow_arrayref(@_);
+    return undef if !defined $ref;
+
+    _fix_arrayref($ref);
+    return $ref;
+}
+
+sub selectrow_hashref {
+    my $self = shift;
+    my $stmt = shift;
+    my $new_stmt = (ref $stmt) ? $stmt : adjust_statement($stmt);
+    unshift @_, $new_stmt;
+    my $ref = $self->SUPER::selectrow_hashref(@_);
+    return undef if !defined $ref;
+
+    _fix_hashref($ref);
+    return $ref;
+}
+
+sub selectall_arrayref {
+    my $self = shift;
+    my $stmt = shift;
+    my $new_stmt = (ref $stmt) ? $stmt : adjust_statement($stmt);
+    unshift @_, $new_stmt;
+    my $ref = $self->SUPER::selectall_arrayref(@_);
+    return undef if !defined $ref;
+    
+    foreach my $row (@$ref) {
+       if (ref($row) eq 'ARRAY') {
+            _fix_arrayref($row);
+       }
+       elsif (ref($row) eq 'HASH') {
+            _fix_hashref($row);
+       }
+    }
+
+    return $ref;
+}
+
+sub selectall_hashref {
+    my $self = shift;
+    my $stmt = shift;
+    my $new_stmt = (ref $stmt) ? $stmt : adjust_statement($stmt);
+    unshift @_, $new_stmt;
+    my $rows = $self->SUPER::selectall_hashref(@_);
+    return undef if !defined $rows;
+    foreach my $row (values %$rows) { 
+          _fix_hashref($row);
+    }
+    return $rows;
+}
+
+sub selectcol_arrayref {
+    my $self = shift;
+    my $stmt = shift;
+    my $new_stmt = (ref $stmt) ? $stmt : adjust_statement($stmt);
+    unshift @_, $new_stmt;
+    my $ref = $self->SUPER::selectcol_arrayref(@_);
+    return undef if !defined $ref;
+    _fix_arrayref($ref);
+    return $ref;
+}
+
+sub prepare {
+    my $self = shift;
+    my $sql  = shift;
+    my $new_sql = adjust_statement($sql);
+    unshift @_, $new_sql;
+    return bless $self->SUPER::prepare(@_),
+                        'Bugzilla::DB::Oracle::st';
+}
+
+sub prepare_cached {
+    my $self = shift;
+    my $sql  = shift;
+    my $new_sql = adjust_statement($sql);
+    unshift @_, $new_sql;
+    return bless $self->SUPER::prepare_cached(@_),
+                      'Bugzilla::DB::Oracle::st';
+}
+
+sub quote_identifier {
+     my ($self,$id) = @_;
+     return $id;
+}
+
+#####################################################################
+# Protected "Real Database" Schema Information Methods
+#####################################################################
+
+sub bz_table_columns_real {
+    my ($self, $table) = @_;
+    $table = uc($table);
+    my $cols = $self->selectcol_arrayref(
+        "SELECT LOWER(COLUMN_NAME) FROM USER_TAB_COLUMNS WHERE 
+         TABLE_NAME = ?  ORDER BY COLUMN_NAME", undef, $table);
+    return @$cols;
+}
+
+sub bz_table_list_real {
+    my ($self) = @_;
+    my $tables = $self->selectcol_arrayref(
+        "SELECT LOWER(TABLE_NAME) FROM USER_TABLES WHERE 
+        TABLE_NAME NOT LIKE ?  ORDER BY TABLE_NAME", undef, 'DR$%');
+    return @$tables;
+}
+
+#####################################################################
+# Custom Database Setup
+#####################################################################
+
+sub bz_setup_database {
+    my $self = shift;
+    
+    # Create a function that returns SYSDATE to emulate MySQL's "NOW()".
+    # Function NOW() is used widely in Bugzilla SQLs, but Oracle does not 
+    # have that function, So we have to create one ourself. 
+    $self->do("CREATE OR REPLACE FUNCTION NOW "
+              . " RETURN DATE IS BEGIN RETURN SYSDATE; END;");
+    $self->do("CREATE OR REPLACE FUNCTION CHAR_LENGTH(COLUMN_NAME VARCHAR2)" 
+              . " RETURN NUMBER IS BEGIN RETURN LENGTH(COLUMN_NAME); END;");
+    
+    # Create types for group_concat
+    my $type_exists = $self->selectrow_array("SELECT 1 FROM user_types
+                                              WHERE type_name = 'T_GROUP_CONCAT'");
+    $self->do("DROP TYPE T_GROUP_CONCAT") if $type_exists;
+    $self->do("CREATE OR REPLACE TYPE T_CLOB_DELIM AS OBJECT "
+          . "( p_CONTENT CLOB, p_DELIMITER VARCHAR2(256)"
+          . ", MAP MEMBER FUNCTION T_CLOB_DELIM_ToVarchar return VARCHAR2"
+          . ");");
+    $self->do("CREATE OR REPLACE TYPE BODY T_CLOB_DELIM IS
+                  MAP MEMBER FUNCTION T_CLOB_DELIM_ToVarchar return VARCHAR2 is
+                  BEGIN
+                      RETURN p_CONTENT;
+                  END;
+              END;");
+
+    $self->do("CREATE OR REPLACE TYPE T_GROUP_CONCAT AS OBJECT 
+               (  CLOB_CONTENT CLOB,
+                  DELIMITER    VARCHAR2(256),
+                  STATIC FUNCTION ODCIAGGREGATEINITIALIZE(
+                      SCTX IN OUT NOCOPY T_GROUP_CONCAT)
+                  RETURN NUMBER,
+                  MEMBER FUNCTION ODCIAGGREGATEITERATE(
+                      SELF IN OUT NOCOPY T_GROUP_CONCAT,
+                      VALUE IN T_CLOB_DELIM) 
+                  RETURN NUMBER,
+                  MEMBER FUNCTION ODCIAGGREGATETERMINATE(
+                      SELF IN T_GROUP_CONCAT,
+                      RETURNVALUE OUT NOCOPY CLOB,
+                      FLAGS       IN NUMBER)
+                  RETURN NUMBER,
+                  MEMBER FUNCTION ODCIAGGREGATEMERGE(
+                      SELF IN OUT NOCOPY T_GROUP_CONCAT,
+                      CTX2 IN T_GROUP_CONCAT) 
+                  RETURN NUMBER);");
+
+    $self->do("CREATE OR REPLACE TYPE BODY T_GROUP_CONCAT IS
+                  STATIC FUNCTION ODCIAGGREGATEINITIALIZE(
+                  SCTX IN OUT NOCOPY T_GROUP_CONCAT)
+                  RETURN NUMBER IS
+                  BEGIN
+                      SCTX := T_GROUP_CONCAT(EMPTY_CLOB(), NULL);
+                      DBMS_LOB.CREATETEMPORARY(SCTX.CLOB_CONTENT, TRUE);
+                      RETURN ODCICONST.SUCCESS;
+                  END;
+                  MEMBER FUNCTION ODCIAGGREGATEITERATE(
+                      SELF IN OUT NOCOPY T_GROUP_CONCAT,
+                      VALUE IN T_CLOB_DELIM) 
+                  RETURN NUMBER IS
+                  BEGIN
+                      SELF.DELIMITER := VALUE.P_DELIMITER;
+                      DBMS_LOB.WRITEAPPEND(SELF.CLOB_CONTENT, 
+                                           LENGTH(SELF.DELIMITER),
+                                           SELF.DELIMITER);
+                      DBMS_LOB.APPEND(SELF.CLOB_CONTENT, VALUE.P_CONTENT);
+  
+                      RETURN ODCICONST.SUCCESS;
+                  END;
+                  MEMBER FUNCTION ODCIAGGREGATETERMINATE(
+                      SELF IN T_GROUP_CONCAT,
+                      RETURNVALUE OUT NOCOPY CLOB,
+                      FLAGS IN NUMBER) 
+                  RETURN NUMBER IS
+                  BEGIN
+                      RETURNVALUE := RTRIM(LTRIM(SELF.CLOB_CONTENT, 
+                                     SELF.DELIMITER), 
+                                     SELF.DELIMITER);
+                      RETURN ODCICONST.SUCCESS;
+                  END;
+                  MEMBER FUNCTION ODCIAGGREGATEMERGE(
+                      SELF IN OUT NOCOPY T_GROUP_CONCAT,
+                      CTX2 IN T_GROUP_CONCAT) 
+                  RETURN NUMBER IS
+                  BEGIN
+                      DBMS_LOB.WRITEAPPEND(SELF.CLOB_CONTENT, 
+                                           LENGTH(SELF.DELIMITER), 
+                                           SELF.DELIMITER);
+                      DBMS_LOB.APPEND(SELF.CLOB_CONTENT, CTX2.CLOB_CONTENT);
+                      RETURN ODCICONST.SUCCESS;
+                  END;
+               END;");
+
+    # Create user-defined aggregate function group_concat
+    $self->do("CREATE OR REPLACE FUNCTION GROUP_CONCAT(P_INPUT T_CLOB_DELIM) 
+               RETURN CLOB 
+               DETERMINISTIC PARALLEL_ENABLE AGGREGATE USING T_GROUP_CONCAT;");
+
+    # Create a WORLD_LEXER named BZ_LEX for multilingual fulltext search
+    my $lexer = $self->selectcol_arrayref(
+       "SELECT pre_name FROM CTXSYS.CTX_PREFERENCES WHERE pre_name = ? AND
+          pre_owner = ?",
+          undef,'BZ_LEX',uc(Bugzilla->localconfig->{db_user}));
+    if(!@$lexer) {
+       $self->do("BEGIN CTX_DDL.CREATE_PREFERENCE
+                        ('BZ_LEX', 'WORLD_LEXER'); END;");
+    }
+
+    $self->SUPER::bz_setup_database(@_);
+
+    my $sth = $self->prepare("SELECT OBJECT_NAME FROM USER_OBJECTS WHERE OBJECT_NAME = ?");
+    my @tables = $self->bz_table_list_real();
+
+    foreach my $table (@tables) {
+        my @columns = $self->bz_table_columns_real($table);
+        foreach my $column (@columns) {
+            my $def = $self->bz_column_info($table, $column);
+            # bz_add_column() before Bugzilla 4.2.3 didn't handle primary keys
+            # correctly (bug 731156). We have to add missing sequences and
+            # triggers ourselves.
+            if ($def->{TYPE} =~ /SERIAL/i) {
+                my $sequence = "${table}_${column}_SEQ";
+                my $exists = $self->selectrow_array($sth, undef, $sequence);
+                if (!$exists) {
+                    my @sql = $self->_get_create_seq_ddl($table, $column);
+                    $self->do($_) foreach @sql;
+                }
+            }
+
+            if ($def->{REFERENCES}) {
+                my $references = $def->{REFERENCES};
+                my $update = $references->{UPDATE} || 'CASCADE';
+                my $to_table  = $references->{TABLE};
+                my $to_column = $references->{COLUMN};
+                my $fk_name = $self->_bz_schema->_get_fk_name($table,
+                                                              $column,
+                                                              $references);
+                # bz_rename_table didn't rename the trigger correctly.
+                if ($table eq 'bug_tag' && $to_table eq 'tags') {
+                    $to_table = 'tag';
+                }
+                if ( $update =~ /CASCADE/i ){
+                    my $trigger_name = uc($fk_name . "_UC");
+                    my $exist_trigger = $self->selectcol_arrayref($sth, undef, $trigger_name);
+                    if(@$exist_trigger) {
+                        $self->do("DROP TRIGGER $trigger_name");
+                    }
+  
+                    my $tr_str = "CREATE OR REPLACE TRIGGER $trigger_name"
+                         . " AFTER UPDATE OF $to_column ON $to_table "
+                         . " REFERENCING "
+                         . " NEW AS NEW "
+                         . " OLD AS OLD "
+                         . " FOR EACH ROW "
+                         . " BEGIN "
+                         . "     UPDATE $table"
+                         . "        SET $column = :NEW.$to_column"
+                         . "      WHERE $column = :OLD.$to_column;"
+                         . " END $trigger_name;";
+                    $self->do($tr_str);
+                }
+            }
+        }
+    }
+
+   # Drop the trigger which causes bug 541553
+   my $trigger_name = "PRODUCTS_MILESTONEURL";
+   my $exist_trigger = $self->selectcol_arrayref($sth, undef, $trigger_name);
+   if(@$exist_trigger) {
+       $self->do("DROP TRIGGER $trigger_name");
+   }
+}
+
+# These two methods have been copied from Bugzilla::DB::Schema::Oracle.
+sub _get_create_seq_ddl {
+    my ($self, $table, $column) = @_;
+
+    my $seq_name = "${table}_${column}_SEQ";
+    my $seq_sql = "CREATE SEQUENCE $seq_name INCREMENT BY 1 START WITH 1 " .
+                  "NOMAXVALUE NOCYCLE NOCACHE";
+    my $trigger_sql = $self->_get_create_trigger_ddl($table, $column, $seq_name);
+    return ($seq_sql, $trigger_sql);
+}
+
+sub _get_create_trigger_ddl {
+    my ($self, $table, $column, $seq_name) = @_;
+
+    my $trigger_sql = "CREATE OR REPLACE TRIGGER ${table}_${column}_TR "
+                    . " BEFORE INSERT ON $table "
+                    . " FOR EACH ROW "
+                    . " BEGIN "
+                    . "   SELECT ${seq_name}.NEXTVAL "
+                    . "   INTO :NEW.$column FROM DUAL; "
+                    . " END;";
+    return $trigger_sql;
+}
+
+############################################################################
+
+package Bugzilla::DB::Oracle::st;
+use base qw(DBI::st);
+ 
+sub fetchrow_arrayref {
+    my $self = shift;
+    my $ref = $self->SUPER::fetchrow_arrayref(@_);
+    return undef if !defined $ref;
+    Bugzilla::DB::Oracle::_fix_arrayref($ref);
+    return $ref;
+}
+
+sub fetchrow_array {
+    my $self = shift;
+    if ( wantarray ) {
+        my @row = $self->SUPER::fetchrow_array(@_);
+        Bugzilla::DB::Oracle::_fix_arrayref(\@row);
+        return @row;
+    } else {
+        my $row = $self->SUPER::fetchrow_array(@_);
+        $row = Bugzilla::DB::Oracle::_fix_empty($row) if defined $row;
+        return $row;
+    }
+}
+
+sub fetchrow_hashref {
+    my $self = shift;
+    my $ref = $self->SUPER::fetchrow_hashref(@_);
+    return undef if !defined $ref;
+    Bugzilla::DB::Oracle::_fix_hashref($ref);
+    return $ref;
+}
+
+sub fetchall_arrayref {
+    my $self = shift;
+    my $ref = $self->SUPER::fetchall_arrayref(@_);
+    return undef if !defined $ref;
+    foreach my $row (@$ref) {
+        if (ref($row) eq 'ARRAY') {
+             Bugzilla::DB::Oracle::_fix_arrayref($row);
+        }
+        elsif (ref($row) eq 'HASH') {
+            Bugzilla::DB::Oracle::_fix_hashref($row);
+        }
+    }
+    return $ref;
+}
+
+sub fetchall_hashref {
+    my $self = shift;
+    my $ref = $self->SUPER::fetchall_hashref(@_);
+    return undef if !defined $ref;
+    foreach my $row (values %$ref) {
+         Bugzilla::DB::Oracle::_fix_hashref($row);
+    }
+     return $ref;
+}
+
+sub fetch {
+    my $self = shift;
+    my $row = $self->SUPER::fetch(@_);
+    if ($row) {
+      Bugzilla::DB::Oracle::_fix_arrayref($row);
+    }
+   return $row;
+}
+1;

diff --git a/Bugzilla/DB/Pg.pm b/Bugzilla/DB/Pg.pm
new file mode 100644 (file)
index 0000000..cd5fed5
--- /dev/null
+++ b/Bugzilla/DB/Pg.pm
@@ -0,0 +1,368 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+=head1 NAME
+
+Bugzilla::DB::Pg - Bugzilla database compatibility layer for PostgreSQL
+
+=head1 DESCRIPTION
+
+This module overrides methods of the Bugzilla::DB module with PostgreSQL
+specific implementation. It is instantiated by the Bugzilla::DB module
+and should never be used directly.
+
+For interface details see L<Bugzilla::DB> and L<DBI>.
+
+=cut
+
+package Bugzilla::DB::Pg;
+
+use strict;
+
+use Bugzilla::Error;
+use DBD::Pg;
+
+# This module extends the DB interface via inheritance
+use base qw(Bugzilla::DB);
+
+use constant BLOB_TYPE => { pg_type => DBD::Pg::PG_BYTEA };
+
+sub new {
+    my ($class, $params) = @_;
+    my ($user, $pass, $host, $dbname, $port) = 
+        @$params{qw(db_user db_pass db_host db_name db_port)};
+
+    # The default database name for PostgreSQL. We have
+    # to connect to SOME database, even if we have
+    # no $dbname parameter.
+    $dbname ||= 'template1';
+
+    # construct the DSN from the parameters we got
+    my $dsn = "dbi:Pg:dbname=$dbname";
+    $dsn .= ";host=$host" if $host;
+    $dsn .= ";port=$port" if $port;
+
+    # This stops Pg from printing out lots of "NOTICE" messages when
+    # creating tables.
+    $dsn .= ";options='-c client_min_messages=warning'";
+
+    my $attrs = { pg_enable_utf8 => Bugzilla->params->{'utf8'} };
+
+    my $self = $class->db_new({ dsn => $dsn, user => $user, 
+                                pass => $pass, attrs => $attrs });
+
+    # all class local variables stored in DBI derived class needs to have
+    # a prefix 'private_'. See DBI documentation.
+    $self->{private_bz_tables_locked} = "";
+    # Needed by TheSchwartz
+    $self->{private_bz_dsn} = $dsn;
+
+    bless ($self, $class);
+
+    return $self;
+}
+
+# if last_insert_id is supported on PostgreSQL by lowest DBI/DBD version
+# supported by Bugzilla, this implementation can be removed.
+sub bz_last_key {
+    my ($self, $table, $column) = @_;
+
+    my $seq = $table . "_" . $column . "_seq";
+    my ($last_insert_id) = $self->selectrow_array("SELECT CURRVAL('$seq')");
+
+    return $last_insert_id;
+}
+
+sub sql_group_concat {
+    my ($self, $text, $separator, $sort) = @_;
+    $sort = 1 if !defined $sort;
+    $separator = $self->quote(', ') if !defined $separator;
+    my $sql = "array_accum($text)";
+    if ($sort) {
+        $sql = "array_sort($sql)";
+    }
+    return "array_to_string($sql, $separator)";
+}
+
+sub sql_istring {
+    my ($self, $string) = @_;
+
+    return "LOWER(${string}::text)";
+}
+
+sub sql_position {
+    my ($self, $fragment, $text) = @_;
+
+    return "POSITION(${fragment}::text IN ${text}::text)";
+}
+
+sub sql_regexp {
+    my ($self, $expr, $pattern, $nocheck, $real_pattern) = @_;
+    $real_pattern ||= $pattern;
+
+    $self->bz_check_regexp($real_pattern) if !$nocheck;
+
+    return "${expr}::text ~* $pattern";
+}
+
+sub sql_not_regexp {
+    my ($self, $expr, $pattern, $nocheck, $real_pattern) = @_;
+    $real_pattern ||= $pattern;
+
+    $self->bz_check_regexp($real_pattern) if !$nocheck;
+
+    return "${expr}::text !~* $pattern" 
+}
+
+sub sql_limit {
+    my ($self, $limit, $offset) = @_;
+
+    if (defined($offset)) {
+        return "LIMIT $limit OFFSET $offset";
+    } else {
+        return "LIMIT $limit";
+    }
+}
+
+sub sql_from_days {
+    my ($self, $days) = @_;
+
+    return "TO_TIMESTAMP('$days', 'J')::date";
+}
+
+sub sql_to_days {
+    my ($self, $date) = @_;
+
+    return "TO_CHAR(${date}::date, 'J')::int";
+}
+
+sub sql_date_format {
+    my ($self, $date, $format) = @_;
+    
+    $format = "%Y.%m.%d %H:%i:%s" if !$format;
+
+    $format =~ s/\%Y/YYYY/g;
+    $format =~ s/\%y/YY/g;
+    $format =~ s/\%m/MM/g;
+    $format =~ s/\%d/DD/g;
+    $format =~ s/\%a/Dy/g;
+    $format =~ s/\%H/HH24/g;
+    $format =~ s/\%i/MI/g;
+    $format =~ s/\%s/SS/g;
+
+    return "TO_CHAR($date, " . $self->quote($format) . ")";
+}
+
+sub sql_date_math {
+    my ($self, $date, $operator, $interval, $units) = @_;
+    
+    return "$date $operator $interval * INTERVAL '1 $units'";
+}
+
+sub sql_string_concat {
+    my ($self, @params) = @_;
+    
+    # Postgres 7.3 does not support concatenating of different types, so we
+    # need to cast both parameters to text. Version 7.4 seems to handle this
+    # properly, so when we stop support 7.3, this can be removed.
+    return '(CAST(' . join(' AS text) || CAST(', @params) . ' AS text))';
+}
+
+# Tell us whether or not a particular sequence exists in the DB.
+sub bz_sequence_exists {
+    my ($self, $seq_name) = @_;
+    my $exists = $self->selectrow_array(
+        'SELECT 1 FROM pg_statio_user_sequences WHERE relname = ?',
+        undef, $seq_name);
+    return $exists || 0;
+}
+
+sub bz_explain {
+    my ($self, $sql) = @_;
+    my $explain = $self->selectcol_arrayref("EXPLAIN ANALYZE $sql");
+    return join("\n", @$explain);
+}
+
+#####################################################################
+# Custom Database Setup
+#####################################################################
+
+sub bz_check_server_version {
+    my $self = shift;
+    my ($db) = @_;
+    my $server_version = $self->SUPER::bz_check_server_version(@_);
+    my ($major_version, $minor_version) = $server_version =~ /^0*(\d+)\.0*(\d+)/;
+    # Pg 9.0 requires DBD::Pg 2.17.2 in order to properly read bytea values.
+    # Pg 9.2 requires DBD::Pg 2.19.3 as spclocation no longer exists.
+    if ($major_version >= 9) {
+        local $db->{dbd}->{version} = ($minor_version >= 2) ? '2.19.3' : '2.17.2';
+        local $db->{name} = $db->{name} . " ${major_version}.$minor_version";
+        Bugzilla::DB::_bz_check_dbd(@_);
+    }
+}
+
+sub bz_setup_database {
+    my $self = shift;
+    $self->SUPER::bz_setup_database(@_);
+
+    # Custom Functions
+    my $function = 'array_accum';
+    my $array_accum = $self->selectrow_array(
+        'SELECT 1 FROM pg_proc WHERE proname = ?', undef, $function);
+    if (!$array_accum) {
+        print "Creating function $function...\n";
+        $self->do("CREATE AGGREGATE array_accum (
+                       SFUNC = array_append,
+                       BASETYPE = anyelement,
+                       STYPE = anyarray,
+                       INITCOND = '{}' 
+                   )");
+    }
+
+   $self->do(<<'END');
+CREATE OR REPLACE FUNCTION array_sort(ANYARRAY)
+RETURNS ANYARRAY LANGUAGE SQL
+IMMUTABLE STRICT
+AS $$
+SELECT ARRAY(
+    SELECT $1[s.i] AS each_item
+    FROM
+        generate_series(array_lower($1,1), array_upper($1,1)) AS s(i)
+    ORDER BY each_item
+);
+$$;
+END
+
+    # PostgreSQL doesn't like having *any* index on the thetext
+    # field, because it can't have index data longer than 2770
+    # characters on that field.
+    $self->bz_drop_index('longdescs', 'longdescs_thetext_idx');
+    # Same for all the comments fields in the fulltext table.
+    $self->bz_drop_index('bugs_fulltext', 'bugs_fulltext_comments_idx');
+    $self->bz_drop_index('bugs_fulltext', 
+                         'bugs_fulltext_comments_noprivate_idx');
+
+    # PostgreSQL also wants an index for calling LOWER on
+    # login_name, which we do with sql_istrcmp all over the place.
+    $self->bz_add_index('profiles', 'profiles_login_name_lower_idx', 
+        {FIELDS => ['LOWER(login_name)'], TYPE => 'UNIQUE'});
+
+    # Now that Bugzilla::Object uses sql_istrcmp, other tables
+    # also need a LOWER() index.
+    _fix_case_differences('fielddefs', 'name');
+    $self->bz_add_index('fielddefs', 'fielddefs_name_lower_idx',
+        {FIELDS => ['LOWER(name)'], TYPE => 'UNIQUE'});
+    _fix_case_differences('keyworddefs', 'name');
+    $self->bz_add_index('keyworddefs', 'keyworddefs_name_lower_idx',
+        {FIELDS => ['LOWER(name)'], TYPE => 'UNIQUE'});
+    _fix_case_differences('products', 'name');
+    $self->bz_add_index('products', 'products_name_lower_idx',
+        {FIELDS => ['LOWER(name)'], TYPE => 'UNIQUE'});
+
+    # bz_rename_column and bz_rename_table didn't correctly rename
+    # the sequence.
+    $self->_fix_bad_sequence('fielddefs', 'id', 'fielddefs_fieldid_seq', 'fielddefs_id_seq');
+    # If the 'tags' table still exists, then bz_rename_table()
+    # will fix the sequence for us.
+    if (!$self->bz_table_info('tags')) {
+        my $res = $self->_fix_bad_sequence('tag', 'id', 'tags_id_seq', 'tag_id_seq');
+        # If $res is true, then the sequence has been renamed, meaning that
+        # the primary key must be renamed too.
+        if ($res) {
+            $self->do('ALTER INDEX tags_pkey RENAME TO tag_pkey');
+        }
+    }
+
+    # Certain sequences got upgraded before we required Pg 8.3, and
+    # so they were not properly associated with their columns.
+    my @tables = $self->bz_table_list_real;
+    foreach my $table (@tables) {
+        my @columns = $self->bz_table_columns_real($table);
+        foreach my $column (@columns) {
+            # All our SERIAL pks have "id" in their name at the end.
+            next unless $column =~ /id$/;
+            my $sequence = "${table}_${column}_seq";
+            if ($self->bz_sequence_exists($sequence)) {
+                my $is_associated = $self->selectrow_array(
+                    'SELECT pg_get_serial_sequence(?,?)',
+                    undef, $table, $column);
+                next if $is_associated;
+                print "Fixing $sequence to be associated"
+                      . " with $table.$column...\n";
+                $self->do("ALTER SEQUENCE $sequence OWNED BY $table.$column");
+                # In order to produce an exactly identical schema to what
+                # a brand-new checksetup.pl run would produce, we also need
+                # to re-set the default on this column.
+                $self->do("ALTER TABLE $table
+                          ALTER COLUMN $column
+                           SET DEFAULT nextval('$sequence')");
+            }
+        }
+    }
+}
+
+sub _fix_bad_sequence {
+    my ($self, $table, $column, $old_seq, $new_seq) = @_;
+    if ($self->bz_column_info($table, $column)
+        && $self->bz_sequence_exists($old_seq))
+    {
+        print "Fixing $old_seq sequence...\n";
+        $self->do("ALTER SEQUENCE $old_seq RENAME TO $new_seq");
+        $self->do("ALTER TABLE $table ALTER COLUMN $column
+                    SET DEFAULT NEXTVAL('$new_seq')");
+        return 1;
+    }
+    return 0;
+}
+
+# Renames things that differ only in case.
+sub _fix_case_differences {
+    my ($table, $field) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    my $duplicates = $dbh->selectcol_arrayref(
+          "SELECT DISTINCT LOWER($field) FROM $table 
+        GROUP BY LOWER($field) HAVING COUNT(LOWER($field)) > 1");
+
+    foreach my $name (@$duplicates) {
+        my $dups = $dbh->selectcol_arrayref(
+            "SELECT $field FROM $table WHERE LOWER($field) = ?",
+            undef, $name);
+        my $primary = shift @$dups;
+        foreach my $dup (@$dups) {
+            my $new_name = "${dup}_";
+            # Make sure the new name isn't *also* a duplicate.
+            while (1) {
+                last if (!$dbh->selectrow_array(
+                             "SELECT 1 FROM $table WHERE LOWER($field) = ?",
+                              undef, lc($new_name)));
+                $new_name .= "_";
+            }
+            print "$table '$primary' and '$dup' have names that differ",
+                  " only in case.\nRenaming '$dup' to '$new_name'...\n";
+            $dbh->do("UPDATE $table SET $field = ? WHERE $field = ?",
+                     undef, $new_name, $dup);
+        }
+    }
+}
+
+#####################################################################
+# Custom Schema Information Functions
+#####################################################################
+
+# Pg includes the PostgreSQL system tables in table_list_real, so 
+# we need to remove those.
+sub bz_table_list_real {
+    my $self = shift;
+
+    my @full_table_list = $self->SUPER::bz_table_list_real(@_);
+    # All PostgreSQL system tables start with "pg_" or "sql_"
+    my @table_list = grep(!/(^pg_)|(^sql_)/, @full_table_list);
+    return @table_list;
+}
+
+1;

diff --git a/Bugzilla/DB/Schema.pm b/Bugzilla/DB/Schema.pm
new file mode 100644 (file)
index 0000000..80c57a3
--- /dev/null
+++ b/Bugzilla/DB/Schema.pm
@@ -0,0 +1,3013 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::DB::Schema;
+
+###########################################################################
+#
+# Purpose: Object-oriented, DBMS-independent database schema for Bugzilla
+#
+# This is the base class implementing common methods and abstract schema.
+#
+###########################################################################
+
+use strict;
+use Bugzilla::Error;
+use Bugzilla::Hook;
+use Bugzilla::Util;
+use Bugzilla::Constants;
+
+use Carp qw(confess);
+use Digest::MD5 qw(md5_hex);
+use Hash::Util qw(lock_value unlock_hash lock_keys unlock_keys);
+use List::MoreUtils qw(firstidx natatime);
+use Safe;
+# Historical, needed for SCHEMA_VERSION = '1.00'
+use Storable qw(dclone freeze thaw);
+
+# New SCHEMA_VERSIONs (2+) use this
+use Data::Dumper;
+
+# Whether or not this database can safely create FKs when doing a
+# CREATE TABLE statement. This is false for most DBs, because they
+# prevent you from creating FKs on tables and columns that don't
+# yet exist. (However, in SQLite it's 1 because SQLite allows that.)
+use constant FK_ON_CREATE => 0;
+
+=head1 NAME
+
+Bugzilla::DB::Schema - Abstract database schema for Bugzilla
+
+=head1 SYNOPSIS
+
+  # Obtain MySQL database schema.
+  # Do not do this. Use Bugzilla::DB instead.
+  use Bugzilla::DB::Schema;
+  my $mysql_schema = new Bugzilla::DB::Schema('Mysql');
+
+  # Recommended way to obtain database schema.
+  use Bugzilla::DB;
+  my $dbh = Bugzilla->dbh;
+  my $schema = $dbh->_bz_schema();
+
+  # Get the list of tables in the Bugzilla database.
+  my @tables = $schema->get_table_list();
+
+  # Get the SQL statements need to create the bugs table.
+  my @statements = $schema->get_table_ddl('bugs');
+
+  # Get the database-specific SQL data type used to implement
+  # the abstract data type INT1.
+  my $db_specific_type = $schema->sql_type('INT1');
+
+=head1 DESCRIPTION
+
+This module implements an object-oriented, abstract database schema.
+It should be considered package-private to the Bugzilla::DB module.
+That means that CGI scripts should never call any function in this
+module directly, but should instead rely on methods provided by
+Bugzilla::DB.
+
+=head1 NEW TO SCHEMA.PM?
+
+If this is your first time looking at Schema.pm, especially if
+you are making changes to the database, please take a look at
+L<http://www.bugzilla.org/docs/developer.html#sql-schema> to learn
+more about how this integrates into the rest of Bugzilla.
+
+=cut
+
+#--------------------------------------------------------------------------
+# Define the Bugzilla abstract database schema and version as constants.
+
+=head1 CONSTANTS
+
+=over
+
+=item C<SCHEMA_VERSION>
+
+The 'version' of the internal schema structure. This version number
+is incremented every time the the fundamental structure of Schema
+internals changes.
+
+This is NOT changed every time a table or a column is added. This 
+number is incremented only if the internal structures of this 
+Schema would be incompatible with the internal structures of a 
+previous Schema version.
+
+In general, unless you are messing around with serialization
+and deserialization of the schema, you don't need to worry about
+this constant.
+
+=begin private
+
+An example of the use of the version number:
+
+Today, we store all individual columns like this:
+
+column_name => { TYPE => 'SOMETYPE', NOTNULL => 1 }
+
+Imagine that someday we decide that NOTNULL => 1 is bad, and we want
+to change it so that the schema instead uses NULL => 0.
+
+But we have a bunch of Bugzilla installations around the world with a
+serialized schema that has NOTNULL in it! When we deserialize that 
+structure, it just WILL NOT WORK properly inside of our new Schema object.
+So, immediately after deserializing, we need to go through the hash 
+and change all NOTNULLs to NULLs and so on.
+
+We know that we need to do that on deserializing because we know that
+version 1.00 used NOTNULL. Having made the change to NULL, we would now
+be version 1.01.
+
+=end private
+
+=item C<ABSTRACT_SCHEMA>
+
+The abstract database schema structure consists of a hash reference
+in which each key is the name of a table in the Bugzilla database.
+
+The value for each key is a hash reference containing the keys
+C<FIELDS> and C<INDEXES> which in turn point to array references
+containing information on the table's fields and indexes. 
+
+A field hash reference should must contain the key C<TYPE>. Optional field
+keys include C<PRIMARYKEY>, C<NOTNULL>, and C<DEFAULT>. 
+
+The C<INDEXES> array reference contains index names and information 
+regarding the index. If the index name points to an array reference,
+then the index is a regular index and the array contains the indexed
+columns. If the index name points to a hash reference, then the hash
+must contain the key C<FIELDS>. It may also contain the key C<TYPE>,
+which can be used to specify the type of index such as UNIQUE or FULLTEXT.
+
+=back
+
+=head2 Referential Integrity
+
+Bugzilla::DB::Schema supports "foreign keys", a way of saying
+that "Column X may only contain values from Column Y in Table Z".
+For example, in Bugzilla, bugs.resolution should only contain
+values from the resolution.values field.
+
+It does this by adding an additional item to a column, called C<REFERENCES>.
+This is a hash with the following members:
+
+=over
+
+=item C<TABLE>
+
+The table the foreign key points at
+
+=item C<COLUMN>
+
+The column pointed at in that table.
+
+=item C<DELETE>
+
+What to do if the row in the parent table is deleted. Choices are
+C<RESTRICT>, C<CASCADE>, or C<SET NULL>. 
+
+C<RESTRICT> means the deletion of the row in the parent table will 
+be forbidden by the database if there is a row in I<this> table that 
+still refers to it. This is the default, if you don't specify
+C<DELETE>.
+
+C<CASCADE> means that this row will be deleted along with that row.
+
+C<SET NULL> means that the column will be set to C<NULL> when the parent
+row is deleted. Note that this is only valid if the column can actually
+be set to C<NULL>. (That is, the column isn't C<NOT NULL>.)
+
+=item C<UPDATE>
+
+What to do if the value in the parent table is updated. You can set this
+to C<CASCADE> or C<RESTRICT>, which mean the same thing as they do for
+L</DELETE>. This variable defaults to C<CASCADE>, which means "also 
+update this column in this table."
+
+=back
+
+=cut
+
+use constant SCHEMA_VERSION  => 3;
+use constant ADD_COLUMN      => 'ADD COLUMN';
+# Multiple FKs can be added using ALTER TABLE ADD CONSTRAINT in one
+# SQL statement. This isn't true for all databases.
+use constant MULTIPLE_FKS_IN_ALTER => 1;
+# This is a reasonable default that's true for both PostgreSQL and MySQL.
+use constant MAX_IDENTIFIER_LEN => 63;
+
+use constant FIELD_TABLE_SCHEMA => {
+    FIELDS => [
+        id       => {TYPE => 'SMALLSERIAL', NOTNULL => 1,
+                     PRIMARYKEY => 1},
+        value    => {TYPE => 'varchar(64)', NOTNULL => 1},
+        sortkey  => {TYPE => 'INT2', NOTNULL => 1, DEFAULT => 0},
+        isactive => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                     DEFAULT => 'TRUE'},
+        visibility_value_id => {TYPE => 'INT2'},
+    ],
+    # Note that bz_add_field_table should prepend the table name
+    # to these index names.
+    INDEXES => [
+        value_idx   => {FIELDS => ['value'], TYPE => 'UNIQUE'},
+        sortkey_idx => ['sortkey', 'value'],
+        visibility_value_id_idx => ['visibility_value_id'],
+    ],
+};
+
+use constant ABSTRACT_SCHEMA => {
+
+    # BUG-RELATED TABLES
+    # ------------------
+
+    # General Bug Information
+    # -----------------------
+    bugs => {
+        FIELDS => [
+            bug_id              => {TYPE => 'MEDIUMSERIAL', NOTNULL => 1,
+                                    PRIMARYKEY => 1},
+            assigned_to         => {TYPE => 'INT3', NOTNULL => 1,
+                                    REFERENCES => {TABLE  => 'profiles',
+                                                   COLUMN => 'userid'}},
+            bug_file_loc        => {TYPE => 'MEDIUMTEXT', 
+                                    NOTNULL => 1, DEFAULT => "''"},
+            bug_severity        => {TYPE => 'varchar(64)', NOTNULL => 1},
+            bug_status          => {TYPE => 'varchar(64)', NOTNULL => 1},
+            creation_ts         => {TYPE => 'DATETIME'},
+            delta_ts            => {TYPE => 'DATETIME', NOTNULL => 1},
+            short_desc          => {TYPE => 'varchar(255)', NOTNULL => 1},
+            op_sys              => {TYPE => 'varchar(64)', NOTNULL => 1},
+            priority            => {TYPE => 'varchar(64)', NOTNULL => 1},
+            product_id          => {TYPE => 'INT2', NOTNULL => 1,
+                                    REFERENCES => {TABLE  => 'products',
+                                                   COLUMN => 'id'}},
+            rep_platform        => {TYPE => 'varchar(64)', NOTNULL => 1},
+            reporter            => {TYPE => 'INT3', NOTNULL => 1,
+                                    REFERENCES => {TABLE  => 'profiles',
+                                                   COLUMN => 'userid'}},
+            version             => {TYPE => 'varchar(64)', NOTNULL => 1},
+            component_id        => {TYPE => 'INT2', NOTNULL => 1,
+                                    REFERENCES => {TABLE  => 'components',
+                                                   COLUMN => 'id'}},
+            resolution          => {TYPE => 'varchar(64)',
+                                    NOTNULL => 1, DEFAULT => "''"},
+            target_milestone    => {TYPE => 'varchar(64)',
+                                    NOTNULL => 1, DEFAULT => "'---'"},
+            qa_contact          => {TYPE => 'INT3',
+                                    REFERENCES => {TABLE  => 'profiles',
+                                                   COLUMN => 'userid'}},
+            status_whiteboard   => {TYPE => 'MEDIUMTEXT', NOTNULL => 1,
+                                    DEFAULT => "''"},
+            lastdiffed          => {TYPE => 'DATETIME'},
+            everconfirmed       => {TYPE => 'BOOLEAN', NOTNULL => 1},
+            reporter_accessible => {TYPE => 'BOOLEAN',
+                                    NOTNULL => 1, DEFAULT => 'TRUE'},
+            cclist_accessible   => {TYPE => 'BOOLEAN',
+                                    NOTNULL => 1, DEFAULT => 'TRUE'},
+            estimated_time      => {TYPE => 'decimal(7,2)',
+                                    NOTNULL => 1, DEFAULT => '0'},
+            remaining_time      => {TYPE => 'decimal(7,2)',
+                                    NOTNULL => 1, DEFAULT => '0'},
+            deadline            => {TYPE => 'DATETIME'},
+            alias               => {TYPE => 'varchar(20)'},
+        ],
+        INDEXES => [
+            bugs_alias_idx            => {FIELDS => ['alias'],
+                                          TYPE => 'UNIQUE'},
+            bugs_assigned_to_idx      => ['assigned_to'],
+            bugs_creation_ts_idx      => ['creation_ts'],
+            bugs_delta_ts_idx         => ['delta_ts'],
+            bugs_bug_severity_idx     => ['bug_severity'],
+            bugs_bug_status_idx       => ['bug_status'],
+            bugs_op_sys_idx           => ['op_sys'],
+            bugs_priority_idx         => ['priority'],
+            bugs_product_id_idx       => ['product_id'],
+            bugs_reporter_idx         => ['reporter'],
+            bugs_version_idx          => ['version'],
+            bugs_component_id_idx     => ['component_id'],
+            bugs_resolution_idx       => ['resolution'],
+            bugs_target_milestone_idx => ['target_milestone'],
+            bugs_qa_contact_idx       => ['qa_contact'],
+        ],
+    },
+
+    bugs_fulltext => {
+        FIELDS => [
+            bug_id     => {TYPE => 'INT3', NOTNULL => 1, PRIMARYKEY => 1,
+                           REFERENCES => {TABLE  => 'bugs',
+                                          COLUMN => 'bug_id',
+                                          DELETE => 'CASCADE'}},
+            short_desc => {TYPE => 'varchar(255)', NOTNULL => 1},
+            # Comments are stored all together in one column for searching.
+            # This allows us to examine all comments together when deciding
+            # the relevance of a bug in fulltext search.
+            comments   => {TYPE => 'LONGTEXT'},
+            comments_noprivate => {TYPE => 'LONGTEXT'},
+        ],
+        INDEXES => [
+            bugs_fulltext_short_desc_idx => {FIELDS => ['short_desc'],
+                                               TYPE => 'FULLTEXT'},
+            bugs_fulltext_comments_idx   => {FIELDS => ['comments'],
+                                               TYPE => 'FULLTEXT'},
+            bugs_fulltext_comments_noprivate_idx => {
+                FIELDS => ['comments_noprivate'], TYPE => 'FULLTEXT'},
+        ],
+    },
+
+    bugs_activity => {
+        FIELDS => [
+            id        => {TYPE => 'INTSERIAL', NOTNULL => 1, 
+                          PRIMARYKEY => 1}, 
+            bug_id    => {TYPE => 'INT3', NOTNULL => 1,
+                          REFERENCES    =>  {TABLE  =>  'bugs',
+                                             COLUMN =>  'bug_id',
+                                             DELETE => 'CASCADE'}},
+            attach_id => {TYPE => 'INT3',
+                          REFERENCES    =>  {TABLE  =>  'attachments',
+                                            COLUMN  =>  'attach_id',
+                                            DELETE => 'CASCADE'}},
+            who       => {TYPE => 'INT3', NOTNULL => 1,
+                          REFERENCES => {TABLE  => 'profiles',
+                                         COLUMN => 'userid'}},
+            bug_when  => {TYPE => 'DATETIME', NOTNULL => 1},
+            fieldid   => {TYPE => 'INT3', NOTNULL => 1,
+                          REFERENCES    =>  {TABLE  =>  'fielddefs',
+                                             COLUMN =>  'id'}},
+            added     => {TYPE => 'varchar(255)'},
+            removed   => {TYPE => 'varchar(255)'},
+            comment_id => {TYPE => 'INT4', 
+                           REFERENCES => { TABLE  => 'longdescs',
+                                           COLUMN => 'comment_id',
+                                           DELETE => 'CASCADE'}},
+        ],
+        INDEXES => [
+            bugs_activity_bug_id_idx  => ['bug_id'],
+            bugs_activity_who_idx     => ['who'],
+            bugs_activity_bug_when_idx => ['bug_when'],
+            bugs_activity_fieldid_idx => ['fieldid'],
+            bugs_activity_added_idx   => ['added'],
+            bugs_activity_removed_idx => ['removed'], 
+        ],
+    },
+
+    cc => {
+        FIELDS => [
+            bug_id => {TYPE => 'INT3', NOTNULL => 1,
+                       REFERENCES => {TABLE  => 'bugs',
+                                      COLUMN => 'bug_id',
+                                      DELETE => 'CASCADE'}},
+            who    => {TYPE => 'INT3', NOTNULL => 1,
+                       REFERENCES => {TABLE  => 'profiles',
+                                      COLUMN => 'userid',
+                                      DELETE => 'CASCADE'}},
+        ],
+        INDEXES => [
+            cc_bug_id_idx => {FIELDS => [qw(bug_id who)],
+                              TYPE => 'UNIQUE'},
+            cc_who_idx    => ['who'],
+        ],
+    },
+
+    longdescs => {
+        FIELDS => [
+            comment_id      => {TYPE => 'INTSERIAL',  NOTNULL => 1,
+                                PRIMARYKEY => 1},
+            bug_id          => {TYPE => 'INT3',  NOTNULL => 1,
+                                REFERENCES => {TABLE => 'bugs',
+                                               COLUMN => 'bug_id',
+                                               DELETE => 'CASCADE'}},
+            who             => {TYPE => 'INT3', NOTNULL => 1,
+                                REFERENCES => {TABLE => 'profiles',
+                                               COLUMN => 'userid'}},
+            bug_when        => {TYPE => 'DATETIME', NOTNULL => 1},
+            work_time       => {TYPE => 'decimal(7,2)', NOTNULL => 1,
+                                DEFAULT => '0'},
+            thetext         => {TYPE => 'LONGTEXT', NOTNULL => 1},
+            isprivate       => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                                DEFAULT => 'FALSE'},
+            already_wrapped => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                                DEFAULT => 'FALSE'},
+            type            => {TYPE => 'INT2', NOTNULL => 1,
+                                DEFAULT => '0'},
+            extra_data      => {TYPE => 'varchar(255)'}
+        ],
+        INDEXES => [
+            longdescs_bug_id_idx   => [qw(bug_id work_time)],
+            longdescs_who_idx     => [qw(who bug_id)],
+            longdescs_bug_when_idx => ['bug_when'],
+        ],
+    },
+
+    dependencies => {
+        FIELDS => [
+            blocked   => {TYPE => 'INT3', NOTNULL => 1,
+                          REFERENCES    =>  {TABLE  =>   'bugs',
+                                            COLUMN  =>  'bug_id',
+                                            DELETE => 'CASCADE'}},
+            dependson => {TYPE => 'INT3', NOTNULL => 1,
+                          REFERENCES    =>  {TABLE  =>   'bugs',
+                                            COLUMN  =>  'bug_id',
+                                            DELETE => 'CASCADE'}},
+        ],
+        INDEXES => [
+            dependencies_blocked_idx => {FIELDS => [qw(blocked dependson)],
+                                         TYPE   => 'UNIQUE'},
+            dependencies_dependson_idx => ['dependson'],
+        ],
+    },
+
+    attachments => {
+        FIELDS => [
+            attach_id    => {TYPE => 'MEDIUMSERIAL', NOTNULL => 1,
+                             PRIMARYKEY => 1},
+            bug_id       => {TYPE => 'INT3', NOTNULL => 1,
+                             REFERENCES    =>  {TABLE  => 'bugs',
+                                                COLUMN => 'bug_id',
+                                                DELETE => 'CASCADE'}},
+            creation_ts  => {TYPE => 'DATETIME', NOTNULL => 1},
+            modification_time => {TYPE => 'DATETIME', NOTNULL => 1},
+            description  => {TYPE => 'TINYTEXT', NOTNULL => 1},
+            mimetype     => {TYPE => 'TINYTEXT', NOTNULL => 1},
+            ispatch      => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                             DEFAULT => 'FALSE'},
+            filename     => {TYPE => 'varchar(255)', NOTNULL => 1},
+            submitter_id => {TYPE => 'INT3', NOTNULL => 1,
+                             REFERENCES => {TABLE => 'profiles',
+                                            COLUMN => 'userid'}},
+            isobsolete   => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                             DEFAULT => 'FALSE'},
+            isprivate    => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                             DEFAULT => 'FALSE'},
+        ],
+        INDEXES => [
+            attachments_bug_id_idx => ['bug_id'],
+            attachments_creation_ts_idx => ['creation_ts'],
+            attachments_modification_time_idx => ['modification_time'],
+            attachments_submitter_id_idx => ['submitter_id', 'bug_id'],
+        ],
+    },
+    attach_data => {
+        FIELDS => [
+            id      => {TYPE => 'INT3', NOTNULL => 1,
+                        PRIMARYKEY => 1,
+                        REFERENCES  =>  {TABLE  => 'attachments',
+                                         COLUMN => 'attach_id',
+                                         DELETE => 'CASCADE'}},
+            thedata => {TYPE => 'LONGBLOB', NOTNULL => 1},
+        ],
+    },
+
+    duplicates => {
+        FIELDS => [
+            dupe_of => {TYPE => 'INT3', NOTNULL => 1,
+                        REFERENCES => {TABLE  =>  'bugs',
+                                       COLUMN =>  'bug_id',
+                                       DELETE =>  'CASCADE'}},
+            dupe    => {TYPE => 'INT3', NOTNULL => 1,
+                        PRIMARYKEY => 1,
+                        REFERENCES => {TABLE  =>  'bugs',
+                                       COLUMN =>  'bug_id',
+                                       DELETE =>  'CASCADE'}},
+        ],
+    },
+
+    bug_see_also => {
+        FIELDS => [
+            id     => {TYPE => 'MEDIUMSERIAL', NOTNULL => 1,
+                       PRIMARYKEY => 1},
+            bug_id => {TYPE => 'INT3', NOTNULL => 1,
+                       REFERENCES => {TABLE  => 'bugs',
+                                      COLUMN => 'bug_id',
+                                      DELETE => 'CASCADE'}},
+            value  => {TYPE => 'varchar(255)', NOTNULL => 1},
+            class  => {TYPE => 'varchar(255)', NOTNULL => 1, DEFAULT => "''"},
+        ],
+        INDEXES => [
+            bug_see_also_bug_id_idx => {FIELDS => [qw(bug_id value)], 
+                                        TYPE   => 'UNIQUE'},
+        ],
+    },
+
+    # Auditing
+    # --------
+
+    audit_log => {
+        FIELDS => [
+            user_id   => {TYPE => 'INT3',
+                          REFERENCES => {TABLE  => 'profiles',
+                                         COLUMN => 'userid',
+                                         DELETE => 'SET NULL'}},
+            class     => {TYPE => 'varchar(255)', NOTNULL => 1},
+            object_id => {TYPE => 'INT4', NOTNULL => 1},
+            field     => {TYPE => 'varchar(64)', NOTNULL => 1},
+            removed   => {TYPE => 'MEDIUMTEXT'},
+            added     => {TYPE => 'MEDIUMTEXT'},
+            at_time   => {TYPE => 'DATETIME', NOTNULL => 1},
+        ],
+        INDEXES => [
+                    audit_log_class_idx => ['class', 'at_time'],
+        ],
+    },
+
+    # Keywords
+    # --------
+
+    keyworddefs => {
+        FIELDS => [
+            id          => {TYPE => 'SMALLSERIAL', NOTNULL => 1,
+                            PRIMARYKEY => 1},
+            name        => {TYPE => 'varchar(64)', NOTNULL => 1},
+            description => {TYPE => 'MEDIUMTEXT', NOTNULL => 1},
+        ],
+        INDEXES => [
+            keyworddefs_name_idx   => {FIELDS => ['name'],
+                                       TYPE => 'UNIQUE'},
+        ],
+    },
+
+    keywords => {
+        FIELDS => [
+            bug_id    => {TYPE => 'INT3', NOTNULL => 1,
+                          REFERENCES => {TABLE  => 'bugs',
+                                         COLUMN => 'bug_id',
+                                         DELETE => 'CASCADE'}},
+            keywordid => {TYPE => 'INT2', NOTNULL => 1,
+                          REFERENCES => {TABLE  => 'keyworddefs',
+                                         COLUMN => 'id',
+                                         DELETE => 'CASCADE'}},
+
+        ],
+        INDEXES => [
+            keywords_bug_id_idx    => {FIELDS => [qw(bug_id keywordid)],
+                                       TYPE => 'UNIQUE'},
+            keywords_keywordid_idx => ['keywordid'],
+        ],
+    },
+
+    # Flags
+    # -----
+
+    # "flags" stores one record for each flag on each bug/attachment.
+    flags => {
+        FIELDS => [
+            id                => {TYPE => 'MEDIUMSERIAL', NOTNULL => 1,
+                                  PRIMARYKEY => 1},
+            type_id           => {TYPE => 'INT2', NOTNULL => 1,
+                                  REFERENCES => {TABLE  => 'flagtypes',
+                                                 COLUMN => 'id',
+                                                 DELETE => 'CASCADE'}},
+            status            => {TYPE => 'char(1)', NOTNULL => 1},
+            bug_id            => {TYPE => 'INT3', NOTNULL => 1,
+                                  REFERENCES => {TABLE  => 'bugs',
+                                                 COLUMN => 'bug_id',
+                                                 DELETE => 'CASCADE'}},
+            attach_id         => {TYPE => 'INT3',
+                                  REFERENCES => {TABLE  => 'attachments',
+                                                 COLUMN => 'attach_id',
+                                                 DELETE => 'CASCADE'}},
+            creation_date     => {TYPE => 'DATETIME', NOTNULL => 1},
+            modification_date => {TYPE => 'DATETIME'},
+            setter_id         => {TYPE => 'INT3', NOTNULL => 1,
+                                  REFERENCES => {TABLE  => 'profiles',
+                                                 COLUMN => 'userid'}},
+            requestee_id      => {TYPE => 'INT3',
+                                  REFERENCES => {TABLE  => 'profiles',
+                                                 COLUMN => 'userid'}},
+        ],
+        INDEXES => [
+            flags_bug_id_idx       => [qw(bug_id attach_id)],
+            flags_setter_id_idx    => ['setter_id'],
+            flags_requestee_id_idx => ['requestee_id'],
+            flags_type_id_idx      => ['type_id'],
+        ],
+    },
+
+    # "flagtypes" defines the types of flags that can be set.
+    flagtypes => {
+        FIELDS => [
+            id               => {TYPE => 'SMALLSERIAL', NOTNULL => 1,
+                                 PRIMARYKEY => 1},
+            name             => {TYPE => 'varchar(50)', NOTNULL => 1},
+            description      => {TYPE => 'MEDIUMTEXT', NOTNULL => 1},
+            cc_list          => {TYPE => 'varchar(200)'},
+            target_type      => {TYPE => 'char(1)', NOTNULL => 1,
+                                 DEFAULT => "'b'"},
+            is_active        => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                                 DEFAULT => 'TRUE'},
+            is_requestable   => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                                 DEFAULT => 'FALSE'},
+            is_requesteeble  => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                                 DEFAULT => 'FALSE'},
+            is_multiplicable => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                                 DEFAULT => 'FALSE'},
+            sortkey          => {TYPE => 'INT2', NOTNULL => 1,
+                                 DEFAULT => '0'},
+            grant_group_id   => {TYPE => 'INT3',
+                                 REFERENCES => {TABLE  => 'groups',
+                                                COLUMN => 'id',
+                                                DELETE => 'SET NULL'}},
+            request_group_id => {TYPE => 'INT3',
+                                 REFERENCES => {TABLE  => 'groups',
+                                                COLUMN => 'id',
+                                                DELETE => 'SET NULL'}},
+        ],
+    },
+
+    # "flaginclusions" and "flagexclusions" specify the products/components
+    #     a bug/attachment must belong to in order for flags of a given type
+    #     to be set for them.
+    flaginclusions => {
+        FIELDS => [
+            type_id      => {TYPE => 'INT2', NOTNULL => 1,
+                             REFERENCES => {TABLE  => 'flagtypes',
+                                            COLUMN => 'id',
+                                            DELETE => 'CASCADE'}},
+            product_id   => {TYPE => 'INT2',
+                             REFERENCES => {TABLE  => 'products',
+                                            COLUMN => 'id',
+                                            DELETE => 'CASCADE'}},
+            component_id => {TYPE => 'INT2',
+                             REFERENCES => {TABLE  => 'components',
+                                            COLUMN => 'id',
+                                            DELETE => 'CASCADE'}},
+        ],
+        INDEXES => [
+            flaginclusions_type_id_idx => { FIELDS => [qw(type_id product_id component_id)],
+                                            TYPE   => 'UNIQUE' },
+        ],
+    },
+
+    flagexclusions => {
+        FIELDS => [
+            type_id      => {TYPE => 'INT2', NOTNULL => 1,
+                             REFERENCES => {TABLE  => 'flagtypes',
+                                            COLUMN => 'id',
+                                            DELETE => 'CASCADE'}},
+            product_id   => {TYPE => 'INT2',
+                             REFERENCES => {TABLE  => 'products',
+                                            COLUMN => 'id',
+                                            DELETE => 'CASCADE'}},
+            component_id => {TYPE => 'INT2',
+                             REFERENCES => {TABLE  => 'components',
+                                            COLUMN => 'id',
+                                            DELETE => 'CASCADE'}},
+        ],
+        INDEXES => [
+            flagexclusions_type_id_idx => { FIELDS => [qw(type_id product_id component_id)],
+                                            TYPE   => 'UNIQUE' },
+        ],
+    },
+
+    # General Field Information
+    # -------------------------
+
+    fielddefs => {
+        FIELDS => [
+            id          => {TYPE => 'MEDIUMSERIAL', NOTNULL => 1,
+                            PRIMARYKEY => 1},
+            name        => {TYPE => 'varchar(64)', NOTNULL => 1},
+            type        => {TYPE => 'INT2', NOTNULL => 1,
+                            DEFAULT => FIELD_TYPE_UNKNOWN},
+            custom      => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                            DEFAULT => 'FALSE'},
+            description => {TYPE => 'TINYTEXT', NOTNULL => 1},
+            long_desc   => {TYPE => 'varchar(255)', NOTNULL => 1, DEFAULT => "''"},
+            mailhead    => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                            DEFAULT => 'FALSE'},
+            sortkey     => {TYPE => 'INT2', NOTNULL => 1},
+            obsolete    => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                            DEFAULT => 'FALSE'},
+            enter_bug   => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                            DEFAULT => 'FALSE'},
+            buglist     => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                            DEFAULT => 'FALSE'},
+            visibility_field_id => {TYPE => 'INT3', 
+                                    REFERENCES => {TABLE  => 'fielddefs',
+                                                   COLUMN => 'id'}},
+            value_field_id => {TYPE => 'INT3',
+                               REFERENCES => {TABLE  => 'fielddefs',
+                                              COLUMN => 'id'}},
+            reverse_desc => {TYPE => 'TINYTEXT'},
+            is_mandatory => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                             DEFAULT => 'FALSE'},
+            is_numeric    => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                             DEFAULT => 'FALSE'},
+        ],
+        INDEXES => [
+            fielddefs_name_idx    => {FIELDS => ['name'],
+                                      TYPE => 'UNIQUE'},
+            fielddefs_sortkey_idx => ['sortkey'],
+            fielddefs_value_field_id_idx => ['value_field_id'],
+            fielddefs_is_mandatory_idx => ['is_mandatory'],
+        ],
+    },
+
+    # Field Visibility Information
+    # -------------------------
+
+    field_visibility => {
+        FIELDS => [
+            field_id => {TYPE => 'INT3', 
+                         REFERENCES => {TABLE  => 'fielddefs',
+                                        COLUMN => 'id',
+                                        DELETE => 'CASCADE'}},
+            value_id => {TYPE => 'INT2', NOTNULL => 1}
+        ],
+        INDEXES => [
+            field_visibility_field_id_idx => {
+                FIELDS => [qw(field_id value_id)],
+                TYPE   => 'UNIQUE'
+            },
+        ],
+    },
+
+    # Per-product Field Values
+    # ------------------------
+
+    versions => {
+        FIELDS => [
+            id         =>  {TYPE => 'MEDIUMSERIAL', NOTNULL => 1,
+                            PRIMARYKEY => 1},
+            value      =>  {TYPE => 'varchar(64)', NOTNULL => 1},
+            product_id =>  {TYPE => 'INT2', NOTNULL => 1,
+                            REFERENCES => {TABLE  => 'products',
+                                           COLUMN => 'id',
+                                           DELETE => 'CASCADE'}},
+            isactive   =>  {TYPE => 'BOOLEAN', NOTNULL => 1, 
+                            DEFAULT => 'TRUE'},
+        ],
+        INDEXES => [
+            versions_product_id_idx => {FIELDS => [qw(product_id value)],
+                                        TYPE => 'UNIQUE'},
+        ],
+    },
+
+    milestones => {
+        FIELDS => [
+            id         => {TYPE => 'MEDIUMSERIAL', NOTNULL => 1, 
+                           PRIMARYKEY => 1},
+            product_id => {TYPE => 'INT2', NOTNULL => 1,
+                           REFERENCES => {TABLE  => 'products',
+                                          COLUMN => 'id',
+                                          DELETE => 'CASCADE'}},
+            value      => {TYPE => 'varchar(64)', NOTNULL => 1},
+            sortkey    => {TYPE => 'INT2', NOTNULL => 1,
+                           DEFAULT => 0},
+            isactive   => {TYPE => 'BOOLEAN', NOTNULL => 1, 
+                           DEFAULT => 'TRUE'},
+        ],
+        INDEXES => [
+            milestones_product_id_idx => {FIELDS => [qw(product_id value)],
+                                          TYPE => 'UNIQUE'},
+        ],
+    },
+
+    # Global Field Values
+    # -------------------
+
+    bug_status => {
+        FIELDS => [
+            @{ dclone(FIELD_TABLE_SCHEMA->{FIELDS}) },
+            is_open  => {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'TRUE'},
+
+        ],
+        INDEXES => [
+            bug_status_value_idx  => {FIELDS => ['value'],
+                                       TYPE => 'UNIQUE'},
+            bug_status_sortkey_idx => ['sortkey', 'value'],
+            bug_status_visibility_value_id_idx => ['visibility_value_id'],
+        ],
+    },
+
+    resolution => {
+        FIELDS => dclone(FIELD_TABLE_SCHEMA->{FIELDS}),
+        INDEXES => [
+            resolution_value_idx   => {FIELDS => ['value'],
+                                       TYPE => 'UNIQUE'},
+            resolution_sortkey_idx => ['sortkey', 'value'],
+            resolution_visibility_value_id_idx => ['visibility_value_id'],
+        ],
+    },
+
+    bug_severity => {
+        FIELDS => dclone(FIELD_TABLE_SCHEMA->{FIELDS}),
+        INDEXES => [
+            bug_severity_value_idx   => {FIELDS => ['value'],
+                                         TYPE => 'UNIQUE'},
+            bug_severity_sortkey_idx => ['sortkey', 'value'],
+            bug_severity_visibility_value_id_idx => ['visibility_value_id'],
+        ],
+    },
+
+    priority => {
+        FIELDS => dclone(FIELD_TABLE_SCHEMA->{FIELDS}),
+        INDEXES => [
+            priority_value_idx   => {FIELDS => ['value'],
+                                     TYPE => 'UNIQUE'},
+            priority_sortkey_idx => ['sortkey', 'value'],
+            priority_visibility_value_id_idx => ['visibility_value_id'],
+        ],
+    },
+
+    rep_platform => {
+        FIELDS => dclone(FIELD_TABLE_SCHEMA->{FIELDS}),
+        INDEXES => [
+            rep_platform_value_idx   => {FIELDS => ['value'],
+                                         TYPE => 'UNIQUE'},
+            rep_platform_sortkey_idx => ['sortkey', 'value'],
+            rep_platform_visibility_value_id_idx => ['visibility_value_id'],
+        ],
+    },
+
+    op_sys => {
+        FIELDS => dclone(FIELD_TABLE_SCHEMA->{FIELDS}),
+        INDEXES => [
+            op_sys_value_idx   => {FIELDS => ['value'],
+                                   TYPE => 'UNIQUE'},
+            op_sys_sortkey_idx => ['sortkey', 'value'],
+            op_sys_visibility_value_id_idx => ['visibility_value_id'],
+        ],
+    },
+
+    status_workflow => {
+        FIELDS => [
+            # On bug creation, there is no old value.
+            old_status      => {TYPE => 'INT2',
+                                REFERENCES => {TABLE  => 'bug_status', 
+                                               COLUMN => 'id',
+                                               DELETE => 'CASCADE'}},
+            new_status      => {TYPE => 'INT2', NOTNULL => 1,
+                                REFERENCES => {TABLE  => 'bug_status', 
+                                               COLUMN => 'id',
+                                               DELETE => 'CASCADE'}},
+            require_comment => {TYPE => 'INT1', NOTNULL => 1, DEFAULT => 0},
+        ],
+        INDEXES => [
+            status_workflow_idx  => {FIELDS => ['old_status', 'new_status'],
+                                     TYPE => 'UNIQUE'},
+        ],
+    },
+
+    # USER INFO
+    # ---------
+
+    # General User Information
+    # ------------------------
+
+    profiles => {
+        FIELDS => [
+            userid         => {TYPE => 'MEDIUMSERIAL', NOTNULL => 1,
+                               PRIMARYKEY => 1},
+            login_name     => {TYPE => 'varchar(255)', NOTNULL => 1},
+            cryptpassword  => {TYPE => 'varchar(128)'},
+            realname       => {TYPE => 'varchar(255)', NOTNULL => 1,
+                               DEFAULT => "''"},
+            disabledtext   => {TYPE => 'MEDIUMTEXT', NOTNULL => 1,
+                               DEFAULT => "''"},
+            disable_mail   => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                               DEFAULT => 'FALSE'},
+            mybugslink     => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                               DEFAULT => 'TRUE'},
+            extern_id      => {TYPE => 'varchar(64)'},
+            is_enabled     => {TYPE => 'BOOLEAN', NOTNULL => 1, 
+                               DEFAULT => 'TRUE'}, 
+            last_seen_date => {TYPE => 'DATETIME'},
+        ],
+        INDEXES => [
+            profiles_login_name_idx => {FIELDS => ['login_name'],
+                                        TYPE => 'UNIQUE'},
+            profiles_extern_id_idx => {FIELDS => ['extern_id'],
+                                       TYPE   => 'UNIQUE'}
+        ],
+    },
+
+    profile_search => {
+        FIELDS => [
+            id         => {TYPE => 'INTSERIAL', NOTNULL => 1, PRIMARYKEY => 1},
+            user_id    => {TYPE => 'INT3', NOTNULL => 1, 
+                           REFERENCES => {TABLE  => 'profiles', 
+                                          COLUMN => 'userid', 
+                                          DELETE => 'CASCADE'}},
+            bug_list   => {TYPE => 'MEDIUMTEXT', NOTNULL => 1},
+            list_order => {TYPE => 'MEDIUMTEXT'},
+        ],
+        INDEXES => [
+            profile_search_user_id_idx => [qw(user_id)],
+        ],
+    },
+
+    profiles_activity => {
+        FIELDS => [
+            id            => {TYPE => 'MEDIUMSERIAL', NOTNULL => 1, 
+                              PRIMARYKEY => 1}, 
+            userid        => {TYPE => 'INT3', NOTNULL => 1,
+                              REFERENCES => {TABLE  => 'profiles', 
+                                             COLUMN => 'userid',
+                                             DELETE => 'CASCADE'}},
+            who           => {TYPE => 'INT3', NOTNULL => 1,
+                              REFERENCES => {TABLE  => 'profiles',
+                                             COLUMN => 'userid'}},
+            profiles_when => {TYPE => 'DATETIME', NOTNULL => 1},
+            fieldid       => {TYPE => 'INT3', NOTNULL => 1,
+                              REFERENCES => {TABLE  => 'fielddefs',
+                                             COLUMN => 'id'}},
+            oldvalue      => {TYPE => 'TINYTEXT'},
+            newvalue      => {TYPE => 'TINYTEXT'},
+        ],
+        INDEXES => [
+            profiles_activity_userid_idx  => ['userid'],
+            profiles_activity_profiles_when_idx => ['profiles_when'],
+            profiles_activity_fieldid_idx => ['fieldid'],
+        ],
+    },
+
+    email_setting => {
+        FIELDS => [
+            user_id      => {TYPE => 'INT3', NOTNULL => 1,
+                             REFERENCES => {TABLE  => 'profiles',
+                                            COLUMN => 'userid',
+                                            DELETE => 'CASCADE'}},
+            relationship => {TYPE => 'INT1', NOTNULL => 1},
+            event        => {TYPE => 'INT1', NOTNULL => 1},
+        ],
+        INDEXES => [
+            email_setting_user_id_idx  =>
+                                    {FIELDS => [qw(user_id relationship event)],
+                                     TYPE => 'UNIQUE'},
+        ],
+    },
+
+    watch => {
+        FIELDS => [
+            watcher => {TYPE => 'INT3', NOTNULL => 1,
+                        REFERENCES => {TABLE  => 'profiles',
+                                       COLUMN => 'userid',
+                                       DELETE => 'CASCADE'}},
+            watched => {TYPE => 'INT3', NOTNULL => 1,
+                        REFERENCES => {TABLE  => 'profiles',
+                                       COLUMN => 'userid',
+                                       DELETE => 'CASCADE'}},
+        ],
+        INDEXES => [
+            watch_watcher_idx => {FIELDS => [qw(watcher watched)],
+                                  TYPE => 'UNIQUE'},
+            watch_watched_idx => ['watched'],
+        ],
+    },
+
+    namedqueries => {
+        FIELDS => [
+            id           => {TYPE => 'MEDIUMSERIAL', NOTNULL => 1,
+                             PRIMARYKEY => 1},
+            userid       => {TYPE => 'INT3', NOTNULL => 1,
+                             REFERENCES => {TABLE  => 'profiles',
+                                            COLUMN => 'userid',
+                                            DELETE => 'CASCADE'}},
+            name         => {TYPE => 'varchar(64)', NOTNULL => 1},
+            query        => {TYPE => 'LONGTEXT', NOTNULL => 1},
+        ],
+        INDEXES => [
+            namedqueries_userid_idx => {FIELDS => [qw(userid name)],
+                                        TYPE => 'UNIQUE'},
+        ],
+    },
+
+    namedqueries_link_in_footer => {
+        FIELDS => [
+            namedquery_id => {TYPE => 'INT3', NOTNULL => 1,
+                              REFERENCES => {TABLE  => 'namedqueries',
+                                             COLUMN => 'id',
+                                             DELETE => 'CASCADE'}},
+            user_id       => {TYPE => 'INT3', NOTNULL => 1,
+                              REFERENCES => {TABLE  => 'profiles',
+                                             COLUMN => 'userid',
+                                             DELETE => 'CASCADE'}},
+        ],
+        INDEXES => [
+            namedqueries_link_in_footer_id_idx => {FIELDS => [qw(namedquery_id user_id)],
+                                                   TYPE => 'UNIQUE'},
+            namedqueries_link_in_footer_userid_idx => ['user_id'],
+        ],
+    },
+
+    tag => {
+        FIELDS => [
+            id   => {TYPE => 'MEDIUMSERIAL', NOTNULL => 1, PRIMARYKEY => 1},
+            name => {TYPE => 'varchar(64)', NOTNULL => 1},
+            user_id  => {TYPE => 'INT3', NOTNULL => 1,
+                         REFERENCES => {TABLE  => 'profiles',
+                                        COLUMN => 'userid',
+                                        DELETE => 'CASCADE'}},
+        ],
+        INDEXES => [
+            tag_user_id_idx => {FIELDS => [qw(user_id name)], TYPE => 'UNIQUE'},
+        ],
+    },
+
+    bug_tag => {
+        FIELDS => [
+            bug_id => {TYPE => 'INT3', NOTNULL => 1,
+                       REFERENCES => {TABLE  => 'bugs',
+                                      COLUMN => 'bug_id',
+                                      DELETE => 'CASCADE'}},
+            tag_id => {TYPE => 'INT3', NOTNULL => 1,
+                       REFERENCES => {TABLE  => 'tag',
+                                      COLUMN => 'id',
+                                      DELETE => 'CASCADE'}},
+        ],
+        INDEXES => [
+            bug_tag_bug_id_idx => {FIELDS => [qw(bug_id tag_id)], TYPE => 'UNIQUE'},
+        ],
+    },
+
+    reports => {
+        FIELDS => [
+            id      => {TYPE => 'MEDIUMSERIAL', NOTNULL => 1,
+                        PRIMARYKEY => 1},
+            user_id => {TYPE => 'INT3', NOTNULL => 1,
+                        REFERENCES => {TABLE  => 'profiles',
+                                       COLUMN => 'userid',
+                                       DELETE => 'CASCADE'}},
+            name    => {TYPE => 'varchar(64)', NOTNULL => 1},
+            query   => {TYPE => 'LONGTEXT', NOTNULL => 1},
+        ],
+        INDEXES => [
+            reports_user_id_idx => {FIELDS => [qw(user_id name)],
+                                   TYPE => 'UNIQUE'},
+        ],
+    },
+
+    component_cc => {
+
+        FIELDS => [
+            user_id      => {TYPE => 'INT3', NOTNULL => 1,
+                             REFERENCES => {TABLE  => 'profiles',
+                                            COLUMN => 'userid',
+                                            DELETE => 'CASCADE'}},
+            component_id => {TYPE => 'INT2', NOTNULL => 1,
+                             REFERENCES => {TABLE  => 'components',
+                                            COLUMN => 'id',
+                                            DELETE => 'CASCADE'}},
+        ],
+        INDEXES => [
+            component_cc_user_id_idx => {FIELDS => [qw(component_id user_id)],
+                                         TYPE => 'UNIQUE'},
+        ],
+    },
+
+    # Authentication
+    # --------------
+
+    logincookies => {
+        FIELDS => [
+            cookie   => {TYPE => 'varchar(16)', NOTNULL => 1,
+                         PRIMARYKEY => 1},
+            userid   => {TYPE => 'INT3', NOTNULL => 1,
+                         REFERENCES => {TABLE  => 'profiles',
+                                        COLUMN => 'userid',
+                                        DELETE => 'CASCADE'}},
+            ipaddr   => {TYPE => 'varchar(40)'},
+            lastused => {TYPE => 'DATETIME', NOTNULL => 1},
+        ],
+        INDEXES => [
+            logincookies_lastused_idx => ['lastused'],
+        ],
+    },
+
+    login_failure => {
+        FIELDS => [
+            user_id    => {TYPE => 'INT3', NOTNULL => 1,
+                           REFERENCES => {TABLE  => 'profiles',
+                                          COLUMN => 'userid',
+                                          DELETE => 'CASCADE'}},
+            login_time => {TYPE => 'DATETIME', NOTNULL => 1},
+            ip_addr    => {TYPE => 'varchar(40)', NOTNULL => 1},
+        ],
+        INDEXES => [
+            # We do lookups by every item in the table simultaneously, but 
+            # having an index with all three items would be the same size as
+            # the table. So instead we have an index on just the smallest item, 
+            # to speed lookups.
+            login_failure_user_id_idx => ['user_id'],
+        ],
+    },
+
+
+    # "tokens" stores the tokens users receive when a password or email
+    #     change is requested.  Tokens provide an extra measure of security
+    #     for these changes.
+    tokens => {
+        FIELDS => [
+            userid    => {TYPE => 'INT3', REFERENCES => {TABLE  => 'profiles',
+                                                         COLUMN => 'userid',
+                                                         DELETE => 'CASCADE'}},
+            issuedate => {TYPE => 'DATETIME', NOTNULL => 1} ,
+            token     => {TYPE => 'varchar(16)', NOTNULL => 1,
+                          PRIMARYKEY => 1},
+            tokentype => {TYPE => 'varchar(8)', NOTNULL => 1} ,
+            eventdata => {TYPE => 'TINYTEXT'},
+        ],
+        INDEXES => [
+            tokens_userid_idx => ['userid'],
+        ],
+    },
+
+    # GROUPS
+    # ------
+
+    groups => {
+        FIELDS => [
+            id           => {TYPE => 'MEDIUMSERIAL', NOTNULL => 1,
+                             PRIMARYKEY => 1},
+            name         => {TYPE => 'varchar(255)', NOTNULL => 1},
+            description  => {TYPE => 'MEDIUMTEXT', NOTNULL => 1},
+            isbuggroup   => {TYPE => 'BOOLEAN', NOTNULL => 1},
+            userregexp   => {TYPE => 'TINYTEXT', NOTNULL => 1,
+                             DEFAULT => "''"},
+            isactive     => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                             DEFAULT => 'TRUE'},
+            icon_url     => {TYPE => 'TINYTEXT'},
+        ],
+        INDEXES => [
+            groups_name_idx => {FIELDS => ['name'], TYPE => 'UNIQUE'},
+        ],
+    },
+
+    group_control_map => {
+        FIELDS => [
+            group_id      => {TYPE => 'INT3', NOTNULL => 1,
+                              REFERENCES => {TABLE  => 'groups',
+                                             COLUMN => 'id',
+                                             DELETE => 'CASCADE'}},
+            product_id    => {TYPE => 'INT2', NOTNULL => 1,
+                              REFERENCES => {TABLE  =>  'products',
+                                             COLUMN =>  'id',
+                                             DELETE =>  'CASCADE'}},
+            entry         => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                              DEFAULT => 'FALSE'},
+            membercontrol => {TYPE => 'INT1', NOTNULL => 1,
+                              DEFAULT => CONTROLMAPNA},
+            othercontrol  => {TYPE => 'INT1', NOTNULL => 1,
+                              DEFAULT => CONTROLMAPNA},
+            canedit       => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                              DEFAULT => 'FALSE'},
+            editcomponents => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                               DEFAULT => 'FALSE'},
+            editbugs      => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                              DEFAULT => 'FALSE'},
+            canconfirm    => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                              DEFAULT => 'FALSE'},
+        ],
+        INDEXES => [
+            group_control_map_product_id_idx =>
+            {FIELDS => [qw(product_id group_id)], TYPE => 'UNIQUE'},
+            group_control_map_group_id_idx    => ['group_id'],
+        ],
+    },
+
+    # "user_group_map" determines the groups that a user belongs to
+    # directly or due to regexp and which groups can be blessed by a user.
+    #
+    # grant_type:
+    # if GRANT_DIRECT - record was explicitly granted
+    # if GRANT_DERIVED - record was derived from expanding a group hierarchy
+    # if GRANT_REGEXP - record was created by evaluating a regexp
+    user_group_map => {
+        FIELDS => [
+            user_id    => {TYPE => 'INT3', NOTNULL => 1,
+                           REFERENCES => {TABLE  => 'profiles',
+                                          COLUMN => 'userid',
+                                          DELETE => 'CASCADE'}},
+            group_id   => {TYPE => 'INT3', NOTNULL => 1,
+                           REFERENCES => {TABLE  => 'groups',
+                                          COLUMN => 'id',
+                                          DELETE => 'CASCADE'}},
+            isbless    => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                           DEFAULT => 'FALSE'},
+            grant_type => {TYPE => 'INT1', NOTNULL => 1,
+                           DEFAULT => GRANT_DIRECT},
+        ],
+        INDEXES => [
+            user_group_map_user_id_idx =>
+                {FIELDS => [qw(user_id group_id grant_type isbless)],
+                 TYPE => 'UNIQUE'},
+        ],
+    },
+
+    # This table determines which groups are made a member of another
+    # group, given the ability to bless another group, or given
+    # visibility to another groups existence and membership
+    # grant_type:
+    # if GROUP_MEMBERSHIP - member groups are made members of grantor
+    # if GROUP_BLESS - member groups may grant membership in grantor
+    # if GROUP_VISIBLE - member groups may see grantor group
+    group_group_map => {
+        FIELDS => [
+            member_id  => {TYPE => 'INT3', NOTNULL => 1,
+                           REFERENCES => {TABLE  => 'groups',
+                                          COLUMN => 'id',
+                                          DELETE => 'CASCADE'}},
+            grantor_id => {TYPE => 'INT3', NOTNULL => 1,
+                           REFERENCES => {TABLE  => 'groups',
+                                          COLUMN => 'id',
+                                          DELETE => 'CASCADE'}},
+            grant_type => {TYPE => 'INT1', NOTNULL => 1,
+                           DEFAULT => GROUP_MEMBERSHIP},
+        ],
+        INDEXES => [
+            group_group_map_member_id_idx =>
+                {FIELDS => [qw(member_id grantor_id grant_type)],
+                 TYPE => 'UNIQUE'},
+        ],
+    },
+
+    # This table determines which groups a user must be a member of
+    # in order to see a bug.
+    bug_group_map => {
+        FIELDS => [
+            bug_id   => {TYPE => 'INT3', NOTNULL => 1,
+                         REFERENCES => {TABLE  => 'bugs',
+                                        COLUMN => 'bug_id',
+                                        DELETE => 'CASCADE'}},
+            group_id => {TYPE => 'INT3', NOTNULL => 1,
+                         REFERENCES => {TABLE  => 'groups',
+                                        COLUMN => 'id',
+                                        DELETE => 'CASCADE'}},
+        ],
+        INDEXES => [
+            bug_group_map_bug_id_idx   =>
+                {FIELDS => [qw(bug_id group_id)], TYPE => 'UNIQUE'},
+            bug_group_map_group_id_idx => ['group_id'],
+        ],
+    },
+
+    # This table determines which groups a user must be a member of
+    # in order to see a named query somebody else shares.
+    namedquery_group_map => {
+        FIELDS => [
+            namedquery_id => {TYPE => 'INT3', NOTNULL => 1,
+                              REFERENCES => {TABLE  => 'namedqueries',
+                                             COLUMN => 'id',
+                                             DELETE => 'CASCADE'}},
+            group_id      => {TYPE => 'INT3', NOTNULL => 1,
+                              REFERENCES => {TABLE  => 'groups',
+                                             COLUMN => 'id',
+                                             DELETE => 'CASCADE'}},
+        ],
+        INDEXES => [
+            namedquery_group_map_namedquery_id_idx   =>
+                {FIELDS => [qw(namedquery_id)], TYPE => 'UNIQUE'},
+            namedquery_group_map_group_id_idx => ['group_id'],
+        ],
+    },
+
+    category_group_map => {
+        FIELDS => [
+            category_id => {TYPE => 'INT2', NOTNULL => 1,
+                            REFERENCES => {TABLE  => 'series_categories',
+                                           COLUMN =>  'id',
+                                           DELETE => 'CASCADE'}},
+            group_id    => {TYPE => 'INT3', NOTNULL => 1,
+                            REFERENCES => {TABLE  => 'groups',
+                                           COLUMN => 'id',
+                                           DELETE => 'CASCADE'}},
+        ],
+        INDEXES => [
+            category_group_map_category_id_idx =>
+                {FIELDS => [qw(category_id group_id)], TYPE => 'UNIQUE'},
+        ],
+    },
+
+
+    # PRODUCTS
+    # --------
+
+    classifications => {
+        FIELDS => [
+            id          => {TYPE => 'SMALLSERIAL', NOTNULL => 1,
+                            PRIMARYKEY => 1},
+            name        => {TYPE => 'varchar(64)', NOTNULL => 1},
+            description => {TYPE => 'MEDIUMTEXT'},
+            sortkey     => {TYPE => 'INT2', NOTNULL => 1, DEFAULT => '0'},
+        ],
+        INDEXES => [
+            classifications_name_idx => {FIELDS => ['name'],
+                                           TYPE => 'UNIQUE'},
+        ],
+    },
+
+    products => {
+        FIELDS => [
+            id                => {TYPE => 'SMALLSERIAL', NOTNULL => 1,
+                                  PRIMARYKEY => 1},
+            name              => {TYPE => 'varchar(64)', NOTNULL => 1},
+            classification_id => {TYPE => 'INT2', NOTNULL => 1,
+                                  DEFAULT => '1',
+                                  REFERENCES => {TABLE  => 'classifications',
+                                                 COLUMN => 'id',
+                                                 DELETE => 'CASCADE'}},
+            description       => {TYPE => 'MEDIUMTEXT', NOTNULL => 1},
+            isactive          => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                                  DEFAULT => 1},
+            defaultmilestone  => {TYPE => 'varchar(64)',
+                                  NOTNULL => 1, DEFAULT => "'---'"},
+            allows_unconfirmed => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                                   DEFAULT => 'TRUE'},
+        ],
+        INDEXES => [
+            products_name_idx   => {FIELDS => ['name'],
+                                    TYPE => 'UNIQUE'},
+        ],
+    },
+
+    components => {
+        FIELDS => [
+            id               => {TYPE => 'SMALLSERIAL', NOTNULL => 1,
+                                 PRIMARYKEY => 1},
+            name             => {TYPE => 'varchar(64)', NOTNULL => 1},
+            product_id       => {TYPE => 'INT2', NOTNULL => 1,
+                                 REFERENCES => {TABLE  => 'products',
+                                                COLUMN => 'id',
+                                                DELETE => 'CASCADE'}},
+            initialowner     => {TYPE => 'INT3', NOTNULL => 1,
+                                 REFERENCES => {TABLE  => 'profiles',
+                                                COLUMN => 'userid'}},
+            initialqacontact => {TYPE => 'INT3',
+                                 REFERENCES => {TABLE  => 'profiles',
+                                                COLUMN => 'userid',
+                                                DELETE => 'SET NULL'}},
+            description      => {TYPE => 'MEDIUMTEXT', NOTNULL => 1},
+            isactive         => {TYPE => 'BOOLEAN', NOTNULL => 1, 
+                                 DEFAULT => 'TRUE'},
+        ],
+        INDEXES => [
+            components_product_id_idx => {FIELDS => [qw(product_id name)],
+                                          TYPE => 'UNIQUE'},
+            components_name_idx   => ['name'],
+        ],
+    },
+
+    # CHARTS
+    # ------
+
+    series => {
+        FIELDS => [
+            series_id   => {TYPE => 'MEDIUMSERIAL', NOTNULL => 1,
+                            PRIMARYKEY => 1},
+            creator     => {TYPE => 'INT3',
+                            REFERENCES => {TABLE  => 'profiles',
+                                           COLUMN => 'userid',
+                                           DELETE => 'CASCADE'}},
+            category    => {TYPE => 'INT2', NOTNULL => 1,
+                            REFERENCES => {TABLE  => 'series_categories',
+                                           COLUMN => 'id',
+                                           DELETE => 'CASCADE'}},
+            subcategory => {TYPE => 'INT2', NOTNULL => 1,
+                            REFERENCES => {TABLE  => 'series_categories',
+                                           COLUMN => 'id',
+                                           DELETE => 'CASCADE'}},
+            name        => {TYPE => 'varchar(64)', NOTNULL => 1},
+            frequency   => {TYPE => 'INT2', NOTNULL => 1},
+            query       => {TYPE => 'MEDIUMTEXT', NOTNULL => 1},
+            is_public   => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                            DEFAULT => 'FALSE'},
+        ],
+        INDEXES => [
+            series_creator_idx  => ['creator'],
+            series_category_idx => {FIELDS => [qw(category subcategory name)],
+                                    TYPE => 'UNIQUE'},
+        ],
+    },
+
+    series_data => {
+        FIELDS => [
+            series_id    => {TYPE => 'INT3', NOTNULL => 1,
+                             REFERENCES => {TABLE  => 'series',
+                                            COLUMN => 'series_id',
+                                            DELETE => 'CASCADE'}},
+            series_date  => {TYPE => 'DATETIME', NOTNULL => 1},
+            series_value => {TYPE => 'INT3', NOTNULL => 1},
+        ],
+        INDEXES => [
+            series_data_series_id_idx =>
+                {FIELDS => [qw(series_id series_date)],
+                 TYPE => 'UNIQUE'},
+        ],
+    },
+
+    series_categories => {
+        FIELDS => [
+            id   => {TYPE => 'SMALLSERIAL', NOTNULL => 1,
+                     PRIMARYKEY => 1},
+            name => {TYPE => 'varchar(64)', NOTNULL => 1},
+        ],
+        INDEXES => [
+            series_categories_name_idx => {FIELDS => ['name'],
+                                           TYPE => 'UNIQUE'},
+        ],
+    },
+
+    # WHINE SYSTEM
+    # ------------
+
+    whine_queries => {
+        FIELDS => [
+            id            => {TYPE => 'MEDIUMSERIAL', PRIMARYKEY => 1,
+                              NOTNULL => 1},
+            eventid       => {TYPE => 'INT3', NOTNULL => 1,
+                              REFERENCES => {TABLE => 'whine_events',
+                                             COLUMN => 'id',
+                                             DELETE => 'CASCADE'}},
+            query_name    => {TYPE => 'varchar(64)', NOTNULL => 1,
+                              DEFAULT => "''"},
+            sortkey       => {TYPE => 'INT2', NOTNULL => 1,
+                              DEFAULT => '0'},
+            onemailperbug => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                              DEFAULT => 'FALSE'},
+            title         => {TYPE => 'varchar(128)', NOTNULL => 1,
+                              DEFAULT => "''"},
+        ],
+        INDEXES => [
+            whine_queries_eventid_idx => ['eventid'],
+        ],
+    },
+
+    whine_schedules => {
+        FIELDS => [
+            id          => {TYPE => 'MEDIUMSERIAL', PRIMARYKEY => 1,
+                            NOTNULL => 1},
+            eventid     => {TYPE => 'INT3', NOTNULL => 1,
+                            REFERENCES => {TABLE  => 'whine_events',
+                                           COLUMN => 'id',
+                                           DELETE => 'CASCADE'}},
+            run_day     => {TYPE => 'varchar(32)'},
+            run_time    => {TYPE => 'varchar(32)'},
+            run_next    => {TYPE => 'DATETIME'},
+            mailto      => {TYPE => 'INT3', NOTNULL => 1},
+            mailto_type => {TYPE => 'INT2', NOTNULL => 1, DEFAULT => '0'},
+        ],
+        INDEXES => [
+            whine_schedules_run_next_idx => ['run_next'],
+            whine_schedules_eventid_idx  => ['eventid'],
+        ],
+    },
+
+    whine_events => {
+        FIELDS => [
+            id           => {TYPE => 'MEDIUMSERIAL', PRIMARYKEY => 1,
+                             NOTNULL => 1},
+            owner_userid => {TYPE => 'INT3', NOTNULL => 1,
+                             REFERENCES => {TABLE  => 'profiles', 
+                                            COLUMN => 'userid',
+                                            DELETE => 'CASCADE'}},
+            subject      => {TYPE => 'varchar(128)'},
+            body         => {TYPE => 'MEDIUMTEXT'},
+            mailifnobugs => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                             DEFAULT => 'FALSE'},
+        ],
+    },
+
+    # QUIPS
+    # -----
+
+    quips => {
+        FIELDS => [
+            quipid   => {TYPE => 'MEDIUMSERIAL', NOTNULL => 1,
+                         PRIMARYKEY => 1},
+            userid   => {TYPE => 'INT3',
+                         REFERENCES => {TABLE  => 'profiles', 
+                                        COLUMN => 'userid',
+                                        DELETE => 'SET NULL'}},
+            quip     => {TYPE => 'varchar(512)', NOTNULL => 1},
+            approved => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                         DEFAULT => 'TRUE'},
+        ],
+    },
+
+    # SETTINGS
+    # --------
+    # setting          - each global setting will have exactly one entry
+    #                    in this table.
+    # setting_value    - stores the list of acceptable values for each
+    #                    setting, and a sort index that controls the order
+    #                    in which the values are displayed.
+    # profile_setting  - If a user has chosen to use a value other than the
+    #                    global default for a given setting, it will be
+    #                    stored in this table. Note: even if a setting is
+    #                    later changed so is_enabled = false, the stored
+    #                    value will remain in case it is ever enabled again.
+    #
+    setting => {
+        FIELDS => [
+            name          => {TYPE => 'varchar(32)', NOTNULL => 1,
+                              PRIMARYKEY => 1}, 
+            default_value => {TYPE => 'varchar(32)', NOTNULL => 1},
+            is_enabled    => {TYPE => 'BOOLEAN', NOTNULL => 1,
+                              DEFAULT => 'TRUE'},
+            subclass      => {TYPE => 'varchar(32)'},
+        ],
+    },
+
+    setting_value => {
+        FIELDS => [
+            name        => {TYPE => 'varchar(32)', NOTNULL => 1,
+                            REFERENCES => {TABLE  => 'setting', 
+                                           COLUMN => 'name',
+                                           DELETE => 'CASCADE'}},
+            value       => {TYPE => 'varchar(32)', NOTNULL => 1},
+            sortindex   => {TYPE => 'INT2', NOTNULL => 1},
+        ],
+        INDEXES => [
+            setting_value_nv_unique_idx  => {FIELDS => [qw(name value)],
+                                             TYPE => 'UNIQUE'},
+            setting_value_ns_unique_idx  => {FIELDS => [qw(name sortindex)],
+                                             TYPE => 'UNIQUE'},
+        ],
+     },
+
+    profile_setting => {
+        FIELDS => [
+            user_id       => {TYPE => 'INT3', NOTNULL => 1,
+                              REFERENCES => {TABLE  => 'profiles',
+                                             COLUMN => 'userid',
+                                             DELETE => 'CASCADE'}},
+            setting_name  => {TYPE => 'varchar(32)', NOTNULL => 1,
+                              REFERENCES => {TABLE  => 'setting',
+                                             COLUMN => 'name',
+                                             DELETE => 'CASCADE'}},
+            setting_value => {TYPE => 'varchar(32)', NOTNULL => 1},
+        ],
+        INDEXES => [
+            profile_setting_value_unique_idx  => {FIELDS => [qw(user_id setting_name)],
+                                                  TYPE => 'UNIQUE'},
+        ],
+     },
+
+    # THESCHWARTZ TABLES
+    # ------------------
+    # Note: In the standard TheSchwartz schema, most integers are unsigned,
+    # but we didn't implement unsigned ints for Bugzilla schemas, so we
+    # just create signed ints, which should be fine.
+
+    ts_funcmap => {
+        FIELDS => [
+            funcid   => {TYPE => 'INTSERIAL', PRIMARYKEY => 1, NOTNULL => 1},
+            funcname => {TYPE => 'varchar(255)', NOTNULL => 1},
+        ],
+        INDEXES => [
+            ts_funcmap_funcname_idx => {FIELDS => ['funcname'], 
+                                          TYPE => 'UNIQUE'},
+        ],
+    },
+
+    ts_job => {
+        FIELDS => [
+            # In a standard TheSchwartz schema, this is a BIGINT, but we
+            # don't have those and I didn't want to add them just for this.
+            jobid         => {TYPE => 'INTSERIAL', PRIMARYKEY => 1, 
+                              NOTNULL => 1},
+            funcid        => {TYPE => 'INT4', NOTNULL => 1},
+            # In standard TheSchwartz, this is a MEDIUMBLOB.
+            arg           => {TYPE => 'LONGBLOB'},
+            uniqkey       => {TYPE => 'varchar(255)'},
+            insert_time   => {TYPE => 'INT4'},
+            run_after     => {TYPE => 'INT4', NOTNULL => 1},
+            grabbed_until => {TYPE => 'INT4', NOTNULL => 1},
+            priority      => {TYPE => 'INT2'},
+            coalesce      => {TYPE => 'varchar(255)'},
+        ],
+        INDEXES => [
+            ts_job_funcid_idx => {FIELDS => [qw(funcid uniqkey)],
+                                  TYPE   => 'UNIQUE'},
+            # In a standard TheSchewartz schema, these both go in the other
+            # direction, but there's no reason to have three indexes that
+            # all start with the same column, and our naming scheme doesn't
+            # allow it anyhow.
+            ts_job_run_after_idx => [qw(run_after funcid)],
+            ts_job_coalesce_idx  => [qw(coalesce funcid)],
+        ],
+    },
+
+    ts_note => {
+        FIELDS => [
+            # This is a BIGINT in standard TheSchwartz schemas.
+            jobid   => {TYPE => 'INT4', NOTNULL => 1},
+            notekey => {TYPE => 'varchar(255)'},
+            value   => {TYPE => 'LONGBLOB'},
+        ],
+        INDEXES => [
+            ts_note_jobid_idx => {FIELDS => [qw(jobid notekey)], 
+                                    TYPE => 'UNIQUE'},
+        ],
+    },
+
+    ts_error => {
+        FIELDS => [
+            error_time => {TYPE => 'INT4', NOTNULL => 1},
+            jobid      => {TYPE => 'INT4', NOTNULL => 1},
+            message    => {TYPE => 'varchar(255)', NOTNULL => 1},
+            funcid     => {TYPE => 'INT4', NOTNULL => 1, DEFAULT => 0},
+        ],
+        INDEXES => [
+            ts_error_funcid_idx     => [qw(funcid error_time)],
+            ts_error_error_time_idx => ['error_time'],
+            ts_error_jobid_idx      => ['jobid'],
+        ],
+    },
+
+    ts_exitstatus => {
+        FIELDS => [
+            jobid           => {TYPE => 'INTSERIAL', PRIMARYKEY => 1,
+                                NOTNULL => 1},
+            funcid          => {TYPE => 'INT4', NOTNULL => 1, DEFAULT => 0},
+            status          => {TYPE => 'INT2'},
+            completion_time => {TYPE => 'INT4'},
+            delete_after    => {TYPE => 'INT4'},
+        ],
+        INDEXES => [
+            ts_exitstatus_funcid_idx       => ['funcid'],
+            ts_exitstatus_delete_after_idx => ['delete_after'],
+        ],
+    },
+
+    # SCHEMA STORAGE
+    # --------------
+
+    bz_schema => {
+        FIELDS => [
+            schema_data => {TYPE => 'LONGBLOB', NOTNULL => 1},
+            version     => {TYPE => 'decimal(3,2)', NOTNULL => 1},
+        ],
+    },
+
+};
+
+# Foreign Keys are added in Bugzilla::DB::bz_add_field_tables
+use constant MULTI_SELECT_VALUE_TABLE => {
+    FIELDS => [
+        bug_id => {TYPE => 'INT3', NOTNULL => 1},
+        value  => {TYPE => 'varchar(64)', NOTNULL => 1},
+    ],
+    INDEXES => [
+        bug_id_idx => {FIELDS => [qw( bug_id value)], TYPE => 'UNIQUE'},
+    ],
+};
+
+#--------------------------------------------------------------------------
+
+=head1 METHODS
+
+Note: Methods which can be implemented generically for all DBs are
+implemented in this module. If needed, they can be overridden with
+DB-specific code in a subclass. Methods which are prefixed with C<_>
+are considered protected. Subclasses may override these methods, but
+other modules should not invoke these methods directly.
+
+=cut
+
+#--------------------------------------------------------------------------
+sub new {
+
+=over
+
+=item C<new>
+
+ Description: Public constructor method used to instantiate objects of this
+              class. However, it also can be used as a factory method to
+              instantiate database-specific subclasses when an optional
+              driver argument is supplied.
+ Parameters:  $driver (optional) - Used to specify the type of database.
+              This routine C<die>s if no subclass is found for the specified
+              driver.
+              $schema (optional) - A reference to a hash. Callers external
+                  to this package should never use this parameter.
+ Returns:     new instance of the Schema class or a database-specific subclass
+
+=cut
+
+    my $this = shift;
+    my $class = ref($this) || $this;
+    my $driver = shift;
+
+    if ($driver) {
+        (my $subclass = $driver) =~ s/^(\S)/\U$1/;
+        $class .= '::' . $subclass;
+        eval "require $class;";
+        die "The $class class could not be found ($subclass " .
+            "not supported?): $@" if ($@);
+    }
+    die "$class is an abstract base class. Instantiate a subclass instead."
+      if ($class eq __PACKAGE__);
+
+    my $self = {};
+    bless $self, $class;
+    $self = $self->_initialize(@_);
+
+    return($self);
+
+} #eosub--new
+#--------------------------------------------------------------------------
+sub _initialize {
+
+=item C<_initialize>
+
+ Description: Protected method that initializes an object after
+              instantiation with the abstract schema. All subclasses should
+              override this method. The typical subclass implementation
+              should first call the C<_initialize> method of the superclass,
+              then do any database-specific initialization (especially
+              define the database-specific implementation of the all
+              abstract data types), and then call the C<_adjust_schema>
+              method.
+ Parameters:  $abstract_schema (optional) - A reference to a hash. If 
+                  provided, this hash will be used as the internal
+                  representation of the abstract schema instead of our
+                  default abstract schema. This is intended for internal 
+                  use only by deserialize_abstract.
+ Returns:     the instance of the Schema class
+
+=cut
+
+    my $self = shift;
+    my $abstract_schema = shift;
+
+    if (!$abstract_schema) {
+        # While ABSTRACT_SCHEMA cannot be modified, $abstract_schema can be.
+        # So, we dclone it to prevent anything from mucking with the constant.
+        $abstract_schema = dclone(ABSTRACT_SCHEMA);
+
+        # Let extensions add tables, but make sure they can't modify existing
+        # tables. If we don't lock/unlock keys, lock_value complains.
+        lock_keys(%$abstract_schema);
+        foreach my $table (keys %{ABSTRACT_SCHEMA()}) {
+            lock_value(%$abstract_schema, $table) 
+                if exists $abstract_schema->{$table};
+        }
+        unlock_keys(%$abstract_schema);
+        Bugzilla::Hook::process('db_schema_abstract_schema', 
+                                { schema => $abstract_schema });
+        unlock_hash(%$abstract_schema);
+    }
+
+    $self->{schema} = dclone($abstract_schema);
+    $self->{abstract_schema} = $abstract_schema;
+
+    return $self;
+
+} #eosub--_initialize
+#--------------------------------------------------------------------------
+sub _adjust_schema {
+
+=item C<_adjust_schema>
+
+ Description: Protected method that alters the abstract schema at
+              instantiation-time to be database-specific. It is a generic
+              enough routine that it can be defined here in the base class.
+              It takes the abstract schema and replaces the abstract data
+              types with database-specific data types.
+ Parameters:  none
+ Returns:     the instance of the Schema class
+
+=cut
+
+    my $self = shift;
+
+    # The _initialize method has already set up the db_specific hash with
+    # the information on how to implement the abstract data types for the
+    # instantiated DBMS-specific subclass.
+    my $db_specific = $self->{db_specific};
+
+    # Loop over each table in the abstract database schema.
+    foreach my $table (keys %{ $self->{schema} }) {
+        my %fields = (@{ $self->{schema}{$table}{FIELDS} });
+        # Loop over the field definitions in each table.
+        foreach my $field_def (values %fields) {
+            # If the field type is an abstract data type defined in the
+            # $db_specific hash, replace it with the DBMS-specific data type
+            # that implements it.
+            if (exists($db_specific->{$field_def->{TYPE}})) {
+                $field_def->{TYPE} = $db_specific->{$field_def->{TYPE}};
+            }
+            # Replace abstract default values (such as 'TRUE' and 'FALSE')
+            # with their database-specific implementations.
+            if (exists($field_def->{DEFAULT})
+                && exists($db_specific->{$field_def->{DEFAULT}})) {
+                $field_def->{DEFAULT} = $db_specific->{$field_def->{DEFAULT}};
+            }
+        }
+    }
+
+    return $self;
+
+} #eosub--_adjust_schema
+#--------------------------------------------------------------------------
+sub get_type_ddl {
+
+=item C<get_type_ddl>
+
+=over
+
+=item B<Description>
+
+Public method to convert abstract (database-generic) field specifiers to
+database-specific data types suitable for use in a C<CREATE TABLE> or 
+C<ALTER TABLE> SQL statment. If no database-specific field type has been
+defined for the given field type, then it will just return the same field type.
+
+=item B<Parameters>
+
+=over
+
+=item C<$def> - A reference to a hash of a field containing the following keys:
+C<TYPE> (required), C<NOTNULL> (optional), C<DEFAULT> (optional), 
+C<PRIMARYKEY> (optional), C<REFERENCES> (optional)
+
+=back
+
+=item B<Returns>
+
+A DDL string suitable for describing a field in a C<CREATE TABLE> or 
+C<ALTER TABLE> SQL statement
+
+=back
+
+=cut
+
+    my $self = shift;
+    my $finfo = (@_ == 1 && ref($_[0]) eq 'HASH') ? $_[0] : { @_ };
+    my $type = $finfo->{TYPE};
+    confess "A valid TYPE was not specified for this column (got " 
+            . Dumper($finfo) . ")" unless ($type);
+
+    my $default = $finfo->{DEFAULT};
+    # Replace any abstract default value (such as 'TRUE' or 'FALSE')
+    # with its database-specific implementation.
+    if ( defined $default && exists($self->{db_specific}->{$default}) ) {
+        $default = $self->{db_specific}->{$default};
+    }
+
+    my $type_ddl = $self->convert_type($type);
+    # DEFAULT attribute must appear before any column constraints
+    # (e.g., NOT NULL), for Oracle
+    $type_ddl .= " DEFAULT $default" if (defined($default));
+    # PRIMARY KEY must appear before NOT NULL for SQLite.
+    $type_ddl .= " PRIMARY KEY" if ($finfo->{PRIMARYKEY});
+    $type_ddl .= " NOT NULL" if ($finfo->{NOTNULL});
+
+    return($type_ddl);
+
+} #eosub--get_type_ddl
+
+
+sub get_fk_ddl {
+
+=item C<_get_fk_ddl>
+
+=over
+
+=item B<Description>
+
+Protected method. Translates the C<REFERENCES> item of a column into SQL.
+
+=item B<Params>
+
+=over
+
+=item C<$table>  - The name of the table the reference is from.
+
+=item C<$column> - The name of the column the reference is from
+
+=item C<$references> - The C<REFERENCES> hashref from a column.
+
+=back
+
+=item B<Returns>
+
+SQL for to define the foreign key, or an empty string if C<$references> 
+is undefined.
+
+=back
+
+=cut
+
+    my ($self, $table, $column, $references) = @_;
+    return "" if !$references;
+
+    my $update    = $references->{UPDATE} || 'CASCADE';
+    my $delete    = $references->{DELETE} || 'RESTRICT';
+    my $to_table  = $references->{TABLE}  || confess "No table in reference";
+    my $to_column = $references->{COLUMN} || confess "No column in reference";
+    my $fk_name   = $self->_get_fk_name($table, $column, $references);
+
+    return "\n     CONSTRAINT $fk_name FOREIGN KEY ($column)\n"
+         . "     REFERENCES $to_table($to_column)\n"
+         . "      ON UPDATE $update ON DELETE $delete";
+}
+
+# Generates a name for a Foreign Key. It's separate from get_fk_ddl
+# so that certain databases can override it (for shorter identifiers or
+# other reasons).
+sub _get_fk_name {
+    my ($self, $table, $column, $references) = @_;
+    my $to_table  = $references->{TABLE}; 
+    my $to_column = $references->{COLUMN};
+    my $name = "fk_${table}_${column}_${to_table}_${to_column}";
+
+    if (length($name) > $self->MAX_IDENTIFIER_LEN) {
+        $name = 'fk_' . $self->_hash_identifier($name);
+    }
+
+    return $name;
+}
+
+sub _hash_identifier {
+    my ($invocant, $value) = @_;
+    # We do -7 to allow prefixes like "idx_" or "fk_", or perhaps something
+    # longer in the future.
+    return substr(md5_hex($value), 0, $invocant->MAX_IDENTIFIER_LEN - 7);
+}
+
+
+sub get_add_fks_sql {
+    my ($self, $table, $column_fks) = @_;
+
+    my @add = $self->_column_fks_to_ddl($table, $column_fks);
+
+    my @sql;
+    if ($self->MULTIPLE_FKS_IN_ALTER) {
+        my $alter = "ALTER TABLE $table ADD " . join(', ADD ', @add);
+        push(@sql, $alter);
+    }
+    else {
+        foreach my $fk_string (@add) {
+            push(@sql, "ALTER TABLE $table ADD $fk_string");
+        }
+    }
+    return @sql;
+}
+
+sub _column_fks_to_ddl {
+    my ($self, $table, $column_fks) = @_;
+    my @ddl;
+    foreach my $column (keys %$column_fks) {
+        my $def = $column_fks->{$column};
+        my $fk_string = $self->get_fk_ddl($table, $column, $def);
+        push(@ddl, $fk_string);
+    }
+    return @ddl;
+}
+
+sub get_drop_fk_sql { 
+    my ($self, $table, $column, $references) = @_;
+    my $fk_name = $self->_get_fk_name($table, $column, $references);
+
+    return ("ALTER TABLE $table DROP CONSTRAINT $fk_name");
+}
+
+sub convert_type {
+
+=item C<convert_type>
+
+Converts a TYPE from the L</ABSTRACT_SCHEMA> format into the real SQL type.
+
+=cut
+
+    my ($self, $type) = @_;
+    return $self->{db_specific}->{$type} || $type;
+}
+
+sub get_column {
+
+=item C<get_column($table, $column)>
+
+ Description: Public method to get the abstract definition of a column.
+ Parameters:  $table - the table name
+              $column - a column in the table
+ Returns:     a hashref containing information about the column, including its
+              type (C<TYPE>), whether or not it can be null (C<NOTNULL>),
+              its default value if it has one (C<DEFAULT), etc.
+              Returns undef if the table or column does not exist.
+
+=cut
+
+    my($self, $table, $column) = @_;
+
+    # Prevent a possible dereferencing of an undef hash, if the
+    # table doesn't exist.
+    if (exists $self->{schema}->{$table}) {
+        my %fields = (@{ $self->{schema}{$table}{FIELDS} });
+        return $fields{$column};
+    }
+    return undef;
+} #eosub--get_column
+
+sub get_table_list {
+
+=item C<get_table_list>
+
+ Description: Public method for discovering what tables should exist in the
+              Bugzilla database.
+
+ Parameters:  none
+
+ Returns:     An array of table names, in alphabetical order.
+
+=cut
+
+    my $self = shift;
+    return sort keys %{$self->{schema}};   
+}
+
+sub get_table_columns {
+
+=item C<get_table_columns>
+
+ Description: Public method for discovering what columns are in a given
+              table in the Bugzilla database.
+ Parameters:  $table - the table name
+ Returns:     array of column names
+
+=cut
+
+    my($self, $table) = @_;
+    my @ddl = ();
+
+    my $thash = $self->{schema}{$table};
+    die "Table $table does not exist in the database schema."
+        unless (ref($thash));
+
+    my @columns = ();
+    my @fields = @{ $thash->{FIELDS} };
+    while (@fields) {
+        push(@columns, shift(@fields));
+        shift(@fields);
+    }
+
+    return @columns;
+
+} #eosub--get_table_columns
+
+sub get_table_indexes_abstract {
+    my ($self, $table) = @_;
+    my $table_def = $self->get_table_abstract($table);
+    my %indexes = @{$table_def->{INDEXES} || []};
+    return \%indexes;
+}
+
+sub get_create_database_sql {
+    my ($self, $name) = @_;
+    return ("CREATE DATABASE $name");
+}
+
+sub get_table_ddl {
+
+=item C<get_table_ddl>
+
+ Description: Public method to generate the SQL statements needed to create
+              the a given table and its indexes in the Bugzilla database.
+              Subclasses may override or extend this method, if needed, but
+              subclasses probably should override C<_get_create_table_ddl>
+              or C<_get_create_index_ddl> instead.
+ Parameters:  $table - the table name
+ Returns:     an array of strings containing SQL statements
+
+=cut
+
+    my($self, $table) = @_;
+    my @ddl = ();
+
+    die "Table $table does not exist in the database schema."
+        unless (ref($self->{schema}{$table}));
+
+    my $create_table = $self->_get_create_table_ddl($table);
+    push(@ddl, $create_table) if $create_table;
+
+    my @indexes = @{ $self->{schema}{$table}{INDEXES} || [] };
+    while (@indexes) {
+        my $index_name = shift(@indexes);
+        my $index_info = shift(@indexes);
+        my $index_sql  = $self->get_add_index_ddl($table, $index_name, 
+                                                  $index_info);
+        push(@ddl, $index_sql) if $index_sql;
+    }
+
+    push(@ddl, @{ $self->{schema}{$table}{DB_EXTRAS} })
+      if (ref($self->{schema}{$table}{DB_EXTRAS}));
+
+    return @ddl;
+
+} #eosub--get_table_ddl
+
+sub _get_create_table_ddl {
+
+=item C<_get_create_table_ddl>
+
+ Description: Protected method to generate the "create table" SQL statement
+              for a given table.
+ Parameters:  $table - the table name
+ Returns:     a string containing the DDL statement for the specified table
+
+=cut
+
+    my($self, $table) = @_;
+
+    my $thash = $self->{schema}{$table};
+    die "Table $table does not exist in the database schema."
+        unless ref $thash;
+
+    my (@col_lines, @fk_lines);
+    my @fields = @{ $thash->{FIELDS} };
+    while (@fields) {
+        my $field = shift(@fields);
+        my $finfo = shift(@fields);
+        push(@col_lines, "\t$field\t" . $self->get_type_ddl($finfo));
+        if ($self->FK_ON_CREATE and $finfo->{REFERENCES}) {
+            my $fk = $finfo->{REFERENCES};
+            my $fk_ddl = $self->get_fk_ddl($table, $field, $fk);
+            push(@fk_lines, $fk_ddl);
+        }
+    }
+    
+    my $sql = "CREATE TABLE $table (\n" . join(",\n", @col_lines, @fk_lines)
+              . "\n)";
+    return $sql
+
+} 
+
+sub _get_create_index_ddl {
+
+=item C<_get_create_index_ddl>
+
+ Description: Protected method to generate a "create index" SQL statement
+              for a given table and index.
+ Parameters:  $table_name - the name of the table
+              $index_name - the name of the index
+              $index_fields - a reference to an array of field names
+              $index_type (optional) - specify type of index (e.g., UNIQUE)
+ Returns:     a string containing the DDL statement
+
+=cut
+
+    my ($self, $table_name, $index_name, $index_fields, $index_type) = @_;
+
+    my $sql = "CREATE ";
+    $sql .= "$index_type " if ($index_type && $index_type eq 'UNIQUE');
+    $sql .= "INDEX $index_name ON $table_name \(" .
+      join(", ", @$index_fields) . "\)";
+
+    return($sql);
+
+} #eosub--_get_create_index_ddl
+#--------------------------------------------------------------------------
+
+sub get_add_column_ddl {
+
+=item C<get_add_column_ddl($table, $column, \%definition, $init_value)>
+
+ Description: Generate SQL to add a column to a table.
+ Params:      $table - The table containing the column.
+              $column - The name of the column being added.
+              \%definition - The new definition for the column,
+                  in standard C<ABSTRACT_SCHEMA> format.
+              $init_value - (optional) An initial value to set 
+                            the column to. Should already be SQL-quoted
+                            if necessary.
+ Returns:     An array of SQL statements.
+
+=cut
+
+    my ($self, $table, $column, $definition, $init_value) = @_;
+    my @statements;
+    push(@statements, "ALTER TABLE $table ". $self->ADD_COLUMN ." $column " .
+        $self->get_type_ddl($definition));
+
+    # XXX - Note that although this works for MySQL, most databases will fail
+    # before this point, if we haven't set a default.
+    (push(@statements, "UPDATE $table SET $column = $init_value"))
+        if defined $init_value;
+
+    if (defined $definition->{REFERENCES}) {
+        push(@statements, $self->get_add_fks_sql($table, { $column =>
+                                                           $definition->{REFERENCES} }));
+    }
+
+    return (@statements);
+}
+
+sub get_add_index_ddl {
+
+=item C<get_add_index_ddl>
+
+ Description: Gets SQL for creating an index.
+              NOTE: Subclasses should not override this function. Instead,
+              if they need to specify a custom CREATE INDEX statement, 
+              they should override C<_get_create_index_ddl>
+ Params:      $table - The name of the table the index will be on.
+              $name  - The name of the new index.
+              $definition - An index definition. Either a hashref 
+                            with FIELDS and TYPE or an arrayref 
+                            containing a list of columns.
+ Returns:     An array of SQL statements that will create the 
+              requested index.
+
+=cut
+
+    my ($self, $table, $name, $definition) = @_;
+
+    my ($index_fields, $index_type);
+    # Index defs can be arrays or hashes
+    if (ref($definition) eq 'HASH') {
+        $index_fields = $definition->{FIELDS};
+        $index_type = $definition->{TYPE};
+    } else {
+        $index_fields = $definition;
+        $index_type = '';
+    }
+    
+    return $self->_get_create_index_ddl($table, $name, $index_fields, 
+                                        $index_type);
+}
+
+sub get_alter_column_ddl {
+
+=item C<get_alter_column_ddl($table, $column, \%definition)>
+
+ Description: Generate SQL to alter a column in a table.
+              The column that you are altering must exist,
+              and the table that it lives in must exist.
+ Params:      $table - The table containing the column.
+              $column - The name of the column being changed.
+              \%definition - The new definition for the column,
+                  in standard C<ABSTRACT_SCHEMA> format.
+              $set_nulls_to - A value to set NULL values to, if
+                  your new definition is NOT NULL and contains
+                  no DEFAULT, and when there is a possibility
+                  that the column could contain NULLs. $set_nulls_to
+                  should be already SQL-quoted if necessary.
+ Returns:     An array of SQL statements.
+
+=cut
+
+    my $self = shift;
+    my ($table, $column, $new_def, $set_nulls_to) = @_;
+
+    my @statements;
+    my $old_def = $self->get_column_abstract($table, $column);
+    my $specific = $self->{db_specific};
+
+    # If the types have changed, we have to deal with that.
+    if (uc(trim($old_def->{TYPE})) ne uc(trim($new_def->{TYPE}))) {
+        push(@statements, $self->_get_alter_type_sql($table, $column, 
+                                                     $new_def, $old_def));
+    }
+
+    my $default = $new_def->{DEFAULT};
+    my $default_old = $old_def->{DEFAULT};
+
+    if (defined $default) {
+        $default = $specific->{$default} if exists $specific->{$default};
+    }
+    # This first condition prevents "uninitialized value" errors.
+    if (!defined $default && !defined $default_old) {
+        # Do Nothing
+    }
+    # If we went from having a default to not having one
+    elsif (!defined $default && defined $default_old) {
+        push(@statements, "ALTER TABLE $table ALTER COLUMN $column"
+                        . " DROP DEFAULT");
+    }
+    # If we went from no default to a default, or we changed the default.
+    elsif ( (defined $default && !defined $default_old) || 
+            ($default ne $default_old) ) 
+    {
+        push(@statements, "ALTER TABLE $table ALTER COLUMN $column "
+                         . " SET DEFAULT $default");
+    }
+
+    # If we went from NULL to NOT NULL.
+    if (!$old_def->{NOTNULL} && $new_def->{NOTNULL}) {
+        push(@statements, $self->_set_nulls_sql(@_));
+        push(@statements, "ALTER TABLE $table ALTER COLUMN $column"
+                        . " SET NOT NULL");
+    }
+    # If we went from NOT NULL to NULL
+    elsif ($old_def->{NOTNULL} && !$new_def->{NOTNULL}) {
+        push(@statements, "ALTER TABLE $table ALTER COLUMN $column"
+                        . " DROP NOT NULL");
+    }
+
+    # If we went from not being a PRIMARY KEY to being a PRIMARY KEY.
+    if (!$old_def->{PRIMARYKEY} && $new_def->{PRIMARYKEY}) {
+        push(@statements, "ALTER TABLE $table ADD PRIMARY KEY ($column)");
+    }
+    # If we went from being a PK to not being a PK
+    elsif ( $old_def->{PRIMARYKEY} && !$new_def->{PRIMARYKEY} ) {
+        push(@statements, "ALTER TABLE $table DROP PRIMARY KEY");
+    }
+
+    return @statements;
+}
+
+# Helps handle any fields that were NULL before, if we have a default,
+# when doing an ALTER COLUMN.
+sub _set_nulls_sql {
+    my ($self, $table, $column, $new_def, $set_nulls_to) = @_;
+    my $default = $new_def->{DEFAULT};
+    # If we have a set_nulls_to, that overrides the DEFAULT 
+    # (although nobody would usually specify both a default and 
+    # a set_nulls_to.)
+    $default = $set_nulls_to if defined $set_nulls_to;
+    if (defined $default) {
+         my $specific = $self->{db_specific};
+         $default = $specific->{$default} if exists $specific->{$default};
+    }
+    my @sql;
+    if (defined $default) {
+        push(@sql, "UPDATE $table SET $column = $default"
+                . "  WHERE $column IS NULL");
+    }
+    return @sql;
+}
+
+sub get_drop_index_ddl {
+
+=item C<get_drop_index_ddl($table, $name)>
+
+ Description: Generates SQL statements to drop an index.
+ Params:      $table - The table the index is on.
+              $name  - The name of the index being dropped.
+ Returns:     An array of SQL statements.
+
+=cut
+
+    my ($self, $table, $name) = @_;
+
+    # Although ANSI SQL-92 doesn't specify a method of dropping an index,
+    # many DBs support this syntax.
+    return ("DROP INDEX $name");
+}
+
+sub get_drop_column_ddl {
+
+=item C<get_drop_column_ddl($table, $column)>
+
+ Description: Generate SQL to drop a column from a table.
+ Params:      $table - The table containing the column.
+              $column - The name of the column being dropped.
+ Returns:     An array of SQL statements.
+
+=cut
+
+    my ($self, $table, $column) = @_;
+    return ("ALTER TABLE $table DROP COLUMN $column");
+}
+
+=item C<get_drop_table_ddl($table)>
+
+ Description: Generate SQL to drop a table from the database.
+ Params:      $table - The name of the table to drop.
+ Returns:     An array of SQL statements.
+
+=cut
+
+sub get_drop_table_ddl {
+    my ($self, $table) = @_;
+    return ("DROP TABLE $table");
+}
+
+sub get_rename_column_ddl {
+
+=item C<get_rename_column_ddl($table, $old_name, $new_name)>
+
+ Description: Generate SQL to change the name of a column in a table.
+              NOTE: ANSI SQL contains no simple way to rename a column,
+                    so this function is ABSTRACT and must be implemented
+                    by subclasses.
+ Params:      $table - The table containing the column to be renamed.
+              $old_name - The name of the column being renamed.
+              $new_name - The name the column is changing to.
+ Returns:     An array of SQL statements.
+
+=cut
+
+    die "ANSI SQL has no way to rename a column, and your database driver\n"
+        . " has not implemented a method.";
+}
+
+
+sub get_rename_table_sql {
+
+=item C<get_rename_table_sql>
+
+=over
+
+=item B<Description>
+
+Gets SQL to rename a table in the database.
+
+=item B<Params>
+
+=over
+
+=item C<$old_name> - The current name of the table.
+
+=item C<$new_name> - The new name of the table.
+
+=back
+
+=item B<Returns>: An array of SQL statements to rename a table.
+
+=back
+
+=cut
+
+    my ($self, $old_name, $new_name) = @_;
+    return ("ALTER TABLE $old_name RENAME TO $new_name");
+}
+
+=item C<delete_table($name)>
+
+ Description: Deletes a table from this Schema object.
+              Dies if you try to delete a table that doesn't exist.
+ Params:      $name - The name of the table to delete.
+ Returns:     nothing
+
+=cut
+
+sub delete_table {
+    my ($self, $name) = @_;
+
+    die "Attempted to delete nonexistent table '$name'." unless
+        $self->get_table_abstract($name);
+
+    delete $self->{abstract_schema}->{$name};
+    delete $self->{schema}->{$name};
+}
+
+sub get_column_abstract {
+
+=item C<get_column_abstract($table, $column)>
+
+ Description: A column definition from the abstract internal schema.
+              cross-database format.
+ Params:      $table - The name of the table
+              $column - The name of the column that you want
+ Returns:     A hash reference. For the format, see the docs for
+              C<ABSTRACT_SCHEMA>.
+              Returns undef if the column or table does not exist.
+
+=cut
+
+    my ($self, $table, $column) = @_;
+
+    # Prevent a possible dereferencing of an undef hash, if the
+    # table doesn't exist.
+    if ($self->get_table_abstract($table)) {
+        my %fields = (@{ $self->{abstract_schema}{$table}{FIELDS} });
+        return $fields{$column};
+    }
+    return undef;
+}
+
+=item C<get_indexes_on_column_abstract($table, $column)>
+
+ Description: Gets a list of indexes that are on a given column.
+ Params:      $table - The table the column is on.
+              $column - The name of the column.
+ Returns:     Indexes in the standard format of an INDEX
+              entry on a table. That is, key-value pairs
+              where the key is the index name and the value
+              is the index definition.
+              If there are no indexes on that column, we return
+              undef.
+
+=cut
+
+sub get_indexes_on_column_abstract {
+    my ($self, $table, $column) = @_;
+    my %ret_hash;
+
+    my $table_def = $self->get_table_abstract($table);
+    if ($table_def && exists $table_def->{INDEXES}) {
+        my %indexes = (@{ $table_def->{INDEXES} });
+        foreach my $index_name (keys %indexes) {
+            my $col_list;
+            # Get the column list, depending on whether the index
+            # is in hashref or arrayref format.
+            if (ref($indexes{$index_name}) eq 'HASH') {
+                $col_list = $indexes{$index_name}->{FIELDS};
+            } else {
+                $col_list = $indexes{$index_name};
+            }
+
+            if(grep($_ eq $column, @$col_list)) {
+                $ret_hash{$index_name} = dclone($indexes{$index_name});
+            }
+        }
+    }
+
+    return %ret_hash;
+}
+
+sub get_index_abstract {
+
+=item C<get_index_abstract($table, $index)>
+
+ Description: Returns an index definition from the internal abstract schema.
+ Params:      $table - The table the index is on.
+              $index - The name of the index.
+ Returns:     A hash reference representing an index definition.
+              See the C<ABSTRACT_SCHEMA> docs for details.
+              Returns undef if the index does not exist.
+
+=cut
+
+    my ($self, $table, $index) = @_;
+
+    # Prevent a possible dereferencing of an undef hash, if the
+    # table doesn't exist.
+    my $index_table = $self->get_table_abstract($table);
+    if ($index_table && exists $index_table->{INDEXES}) {
+        my %indexes = (@{ $index_table->{INDEXES} });
+        return $indexes{$index};
+    }
+    return undef;
+}
+
+=item C<get_table_abstract($table)>
+
+ Description: Gets the abstract definition for a table in this Schema
+              object.
+ Params:      $table - The name of the table you want a definition for.
+ Returns:     An abstract table definition, or undef if the table doesn't
+              exist.
+
+=cut
+
+sub get_table_abstract {
+    my ($self, $table) = @_;
+    return $self->{abstract_schema}->{$table};
+}
+
+=item C<add_table($name, \%definition)>
+
+ Description: Creates a new table in this Schema object.
+              If you do not specify a definition, we will
+              simply create an empty table.
+ Params:      $name - The name for the new table.
+              \%definition (optional) - An abstract definition for
+                  the new table.
+ Returns:     nothing
+
+=cut
+
+sub add_table {
+    my ($self, $name, $definition) = @_;
+    (die "Table already exists: $name")
+        if exists $self->{abstract_schema}->{$name};
+    if ($definition) {
+        $self->{abstract_schema}->{$name} = dclone($definition);
+        $self->{schema} = dclone($self->{abstract_schema});
+        $self->_adjust_schema();
+    }
+    else {
+        $self->{abstract_schema}->{$name} = {FIELDS => []};
+        $self->{schema}->{$name}          = {FIELDS => []};
+    }
+}
+
+
+
+sub rename_table {
+
+=item C<rename_table>
+
+Renames a table from C<$old_name> to C<$new_name> in this Schema object.
+
+=cut
+
+
+    my ($self, $old_name, $new_name) = @_;
+    my $table = $self->get_table_abstract($old_name);
+    $self->delete_table($old_name);
+    $self->add_table($new_name, $table);
+}
+
+sub delete_column {
+
+=item C<delete_column($table, $column)>
+
+ Description: Deletes a column from this Schema object.
+ Params:      $table - Name of the table that the column is in.
+                       The table must exist, or we will fail.
+              $column  - Name of the column to delete.
+ Returns:     nothing
+
+=cut
+
+    my ($self, $table, $column) = @_;
+
+    my $abstract_fields = $self->{abstract_schema}{$table}{FIELDS};
+    my $name_position = firstidx { $_ eq $column } @$abstract_fields;
+    die "Attempted to delete nonexistent column ${table}.${column}" 
+        if $name_position == -1;
+    # Delete the key/value pair from the array.
+    splice(@$abstract_fields, $name_position, 2);
+
+    $self->{schema} = dclone($self->{abstract_schema});
+    $self->_adjust_schema();
+}
+
+sub rename_column {
+
+=item C<rename_column($table, $old_name, $new_name)>
+
+ Description: Renames a column on a table in the Schema object.
+              The column that you are renaming must exist.
+ Params:      $table - The table the column is on.
+              $old_name - The current name of the column.
+              $new_name - The new name of hte column.
+ Returns:     nothing
+
+=cut
+
+    my ($self, $table, $old_name, $new_name) = @_;
+    my $def = $self->get_column_abstract($table, $old_name);
+    die "Renaming a column that doesn't exist" if !$def;
+    $self->delete_column($table, $old_name);
+    $self->set_column($table, $new_name, $def);
+}
+
+sub set_column {
+
+=item C<set_column($table, $column, \%new_def)>
+
+ Description: Changes the definition of a column in this Schema object.
+              If the column doesn't exist, it will be added.
+              The table that you specify must already exist in the Schema.
+              NOTE: This does not affect the database on the disk.
+              Use the C<Bugzilla::DB> "Schema Modification Methods"
+              if you want to do that.
+ Params:      $table - The name of the table that the column is on.
+              $column - The name of the column.
+              \%new_def - The new definition for the column, in 
+                  C<ABSTRACT_SCHEMA> format.
+ Returns:     nothing
+
+=cut
+
+    my ($self, $table, $column, $new_def) = @_;
+
+    my $fields = $self->{abstract_schema}{$table}{FIELDS};
+    $self->_set_object($table, $column, $new_def, $fields);
+}
+
+=item C<set_fk($table, $column \%fk_def)>
+
+Sets the C<REFERENCES> item on the specified column.
+
+=cut
+
+sub set_fk {
+    my ($self, $table, $column, $fk_def) = @_;
+    # Don't want to modify the source def before we explicitly set it below.
+    # This is just us being extra-cautious.
+    my $column_def = dclone($self->get_column_abstract($table, $column));
+    die "Tried to set an fk on $table.$column, but that column doesn't exist"
+        if !$column_def;
+    if ($fk_def) {
+        $column_def->{REFERENCES} = $fk_def;
+    }
+    else {
+        delete $column_def->{REFERENCES};
+    }
+    $self->set_column($table, $column, $column_def);
+}
+
+sub set_index {
+
+=item C<set_index($table, $name, $definition)>
+
+ Description: Changes the definition of an index in this Schema object.
+              If the index doesn't exist, it will be added.
+              The table that you specify must already exist in the Schema.
+              NOTE: This does not affect the database on the disk.
+              Use the C<Bugzilla::DB> "Schema Modification Methods"
+              if you want to do that.
+ Params:      $table      - The table the index is on.
+              $name       - The name of the index.
+              $definition - A hashref or an arrayref. An index 
+                            definition in C<ABSTRACT_SCHEMA> format.
+ Returns:     nothing
+
+=cut
+
+    my ($self, $table, $name, $definition) = @_;
+
+    if ( exists $self->{abstract_schema}{$table}
+         && !exists $self->{abstract_schema}{$table}{INDEXES} ) {
+        $self->{abstract_schema}{$table}{INDEXES} = [];
+    }
+
+    my $indexes = $self->{abstract_schema}{$table}{INDEXES};
+    $self->_set_object($table, $name, $definition, $indexes);
+}
+
+# A private helper for set_index and set_column.
+# This does the actual "work" of those two functions.
+# $array_to_change is an arrayref.
+sub _set_object {
+    my ($self, $table, $name, $definition, $array_to_change) = @_;
+
+    my $obj_position = (firstidx { $_ eq $name } @$array_to_change) + 1;
+    # If the object doesn't exist, then add it.
+    if (!$obj_position) {
+        push(@$array_to_change, $name);
+        push(@$array_to_change, $definition);
+    }
+    # We're modifying an existing object in the Schema.
+    else {
+        splice(@$array_to_change, $obj_position, 1, $definition);
+    }
+
+    $self->{schema} = dclone($self->{abstract_schema});
+    $self->_adjust_schema();
+}
+
+=item C<delete_index($table, $name)>
+
+ Description: Removes an index definition from this Schema object.
+              If the index doesn't exist, we will fail.
+              The table that you specify must exist in the Schema.
+              NOTE: This does not affect the database on the disk.
+              Use the C<Bugzilla::DB> "Schema Modification Methods"
+              if you want to do that.
+ Params:      $table - The table the index is on.
+              $name  - The name of the index that we're removing.
+ Returns:     nothing
+
+=cut
+
+sub delete_index {
+    my ($self, $table, $name) = @_;
+
+    my $indexes = $self->{abstract_schema}{$table}{INDEXES};
+    my $name_position = firstidx { $_ eq $name } @$indexes;
+    die "Attempted to delete nonexistent index $name on the $table table" 
+        if $name_position == -1;
+    # Delete the key/value pair from the array.
+    splice(@$indexes, $name_position, 2);
+    $self->{schema} = dclone($self->{abstract_schema});
+    $self->_adjust_schema();
+}
+
+sub columns_equal {
+
+=item C<columns_equal($col_one, $col_two)>
+
+ Description: Tells you if two columns have entirely identical definitions.
+              The TYPE field's value will be compared case-insensitive.
+              However, all other fields will be case-sensitive.
+ Params:      $col_one, $col_two - The columns to compare. Hash 
+                  references, in C<ABSTRACT_SCHEMA> format.
+ Returns:     C<1> if the columns are identical, C<0> if they are not.
+
+=back
+
+=cut
+
+    my $self = shift;
+    my $col_one = dclone(shift);
+    my $col_two = dclone(shift);
+
+    $col_one->{TYPE} = uc($col_one->{TYPE});
+    $col_two->{TYPE} = uc($col_two->{TYPE});
+
+    # We don't care about foreign keys when comparing column definitions.
+    delete $col_one->{REFERENCES};
+    delete $col_two->{REFERENCES};
+
+    my @col_one_array = %$col_one;
+    my @col_two_array = %$col_two;
+
+    my ($removed, $added) = diff_arrays(\@col_one_array, \@col_two_array);
+
+    # If there are no differences between the arrays, then they are equal.
+    return !scalar(@$removed) && !scalar(@$added) ? 1 : 0;
+}
+
+
+=head1 SERIALIZATION/DESERIALIZATION
+
+=over 4
+
+=item C<serialize_abstract()>
+
+ Description: Serializes the "abstract" schema into a format
+              that deserialize_abstract() can read in. This is
+              a method, called on a Schema instance.
+ Parameters:  none
+ Returns:     A scalar containing the serialized, abstract schema.
+              Do not attempt to manipulate this data directly,
+              as the format may change at any time in the future.
+              The only thing you should do with the returned value
+              is either store it somewhere (coupled with appropriate 
+              SCHEMA_VERSION) or deserialize it.
+
+=cut
+
+sub serialize_abstract {
+    my ($self) = @_;
+    
+    # Make it ok to eval
+    local $Data::Dumper::Purity = 1;
+    
+    # Avoid cross-refs
+    local $Data::Dumper::Deepcopy = 1;
+    
+    # Always sort keys to allow textual compare
+    local $Data::Dumper::Sortkeys = 1;
+    
+    return Dumper($self->{abstract_schema});
+}
+
+=item C<deserialize_abstract($serialized, $version)>
+
+ Description: Used for when you've read a serialized Schema off the disk,
+              and you want a Schema object that represents that data.
+ Params:      $serialized - scalar. The serialized data.
+              $version - A number. The "version"
+                  of the Schema that did the serialization.
+                  See the docs for C<SCHEMA_VERSION> for more details.
+ Returns:     A Schema object. It will have the methods of (and work 
+              in the same fashion as) the current version of Schema. 
+              However, it will represent the serialized data instead of
+              ABSTRACT_SCHEMA.
+
+=cut
+
+sub deserialize_abstract {
+    my ($class, $serialized, $version) = @_;
+
+    my $thawed_hash;
+    if ($version < 2) {
+        $thawed_hash = thaw($serialized);
+    }
+    else {
+        my $cpt = new Safe;
+        $cpt->reval($serialized) ||
+            die "Unable to restore cached schema: " . $@;
+        $thawed_hash = ${$cpt->varglob('VAR1')};
+    }
+
+    # Version 2 didn't have the "created" key for REFERENCES items.
+    if ($version < 3) {
+        my $standard = $class->new()->{abstract_schema};
+        foreach my $table_name (keys %$thawed_hash) {
+            my %standard_fields = 
+                @{ $standard->{$table_name}->{FIELDS} || [] };
+            my $table = $thawed_hash->{$table_name};
+            my %fields = @{ $table->{FIELDS} || [] };
+            while (my ($field, $def) = each %fields) {
+                if (exists $def->{REFERENCES}) {
+                    $def->{REFERENCES}->{created} = 1;
+                }
+            }
+        }
+    }
+
+    return $class->new(undef, $thawed_hash);
+}
+
+#####################################################################
+# Class Methods
+#####################################################################
+
+=back
+
+=head1 CLASS METHODS
+
+These methods are generally called on the class instead of on a specific
+object.
+
+=over
+
+=item C<get_empty_schema()>
+
+ Description: Returns a Schema that has no tables. In effect, this
+              Schema is totally "empty."
+ Params:      none
+ Returns:     A "empty" Schema object.
+
+=back
+
+=cut
+
+sub get_empty_schema {
+    my ($class) = @_;
+    return $class->deserialize_abstract(Dumper({}), SCHEMA_VERSION);
+}
+
+1;
+
+__END__
+
+=head1 ABSTRACT DATA TYPES
+
+The size and range data provided here is only
+intended as a guide.  See your database's Bugzilla
+module (in this directory) for the most up-to-date
+values for these data types.  The following
+abstract data types are used:
+
+=over 4
+
+=item C<BOOLEAN>
+
+Logical value 0 or 1 where 1 is true, 0 is false.
+
+=item C<INT1>
+
+Integer values (-128 - 127 or 0 - 255 unsigned).
+
+=item C<INT2>
+
+Integer values (-32,768 - 32767 or 0 - 65,535 unsigned).
+
+=item C<INT3>
+
+Integer values (-8,388,608 - 8,388,607 or 0 - 16,777,215 unsigned)
+
+=item C<INT4>
+
+Integer values (-2,147,483,648 - 2,147,483,647 or 0 - 4,294,967,295 
+unsigned)
+
+=item C<SMALLSERIAL>
+
+An auto-increment L</INT2>
+
+=item C<MEDIUMSERIAL>
+
+An auto-increment L</INT3>
+
+=item C<INTSERIAL>
+
+An auto-increment L</INT4>
+
+=item C<TINYTEXT>
+
+Variable length string of characters up to 255 (2^8 - 1) characters wide.
+
+=item C<MEDIUMTEXT>
+
+Variable length string of characters up to 4000 characters wide.
+May be longer on some databases.
+
+=item C<LONGTEXT>
+
+Variable length string of characters up to 16M (2^24 - 1) characters wide.
+
+=item C<LONGBLOB>
+
+Variable length string of binary data up to 4M (2^32 - 1) bytes wide
+
+=item C<DATETIME>
+
+DATETIME support varies from database to database, however, it's generally 
+safe to say that DATETIME entries support all date/time combinations greater
+than 1900-01-01 00:00:00.  Note that the format used is C<YYYY-MM-DD hh:mm:ss>
+to be safe, though it's possible that your database may not require
+leading zeros.  For greatest compatibility, however, please make sure dates 
+are formatted as above for queries to guarantee consistent results.
+
+=back
+
+Database-specific subclasses should define the implementation for these data
+types as a hash reference stored internally in the schema object as
+C<db_specific>. This is typically done in overridden L<_initialize> method.
+
+The following abstract boolean values should also be defined on a
+database-specific basis:
+
+=over 4
+
+=item C<TRUE>
+
+=item C<FALSE>
+
+=back
+
+=head1 SEE ALSO
+
+L<Bugzilla::DB>
+
+L<http://www.bugzilla.org/docs/developer.html#sql-schema>
+
+=cut

diff --git a/Bugzilla/DB/Schema/Mysql.pm b/Bugzilla/DB/Schema/Mysql.pm
new file mode 100644 (file)
index 0000000..020549a
--- /dev/null
+++ b/Bugzilla/DB/Schema/Mysql.pm
@@ -0,0 +1,383 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::DB::Schema::Mysql;
+
+###############################################################################
+#
+# DB::Schema implementation for MySQL
+#
+###############################################################################
+
+use strict;
+use Bugzilla::Error;
+
+use base qw(Bugzilla::DB::Schema);
+
+# This is for column_info_to_column, to know when a tinyint is a 
+# boolean and when it's really a tinyint. This only has to be accurate
+# up to and through 2.19.3, because that's the only time we need
+# column_info_to_column.
+#
+# This is basically a hash of tables/columns, with one entry for each column
+# that should be interpreted as a BOOLEAN instead of as an INT1 when
+# reading in the Schema from the disk. The values are discarded; I just
+# used "1" for simplicity.
+# 
+# THIS CONSTANT IS ONLY USED FOR UPGRADES FROM 2.18 OR EARLIER. DON'T
+# UPDATE IT TO MODERN COLUMN NAMES OR DEFINITIONS.
+use constant BOOLEAN_MAP => {
+    bugs           => {everconfirmed => 1, reporter_accessible => 1,
+                       cclist_accessible => 1, qacontact_accessible => 1,
+                       assignee_accessible => 1},
+    longdescs      => {isprivate => 1, already_wrapped => 1},
+    attachments    => {ispatch => 1, isobsolete => 1, isprivate => 1},
+    flags          => {is_active => 1},
+    flagtypes      => {is_active => 1, is_requestable => 1, 
+                       is_requesteeble => 1, is_multiplicable => 1},
+    fielddefs      => {mailhead => 1, obsolete => 1},
+    bug_status     => {isactive => 1},
+    resolution     => {isactive => 1},
+    bug_severity   => {isactive => 1},
+    priority       => {isactive => 1},
+    rep_platform   => {isactive => 1},
+    op_sys         => {isactive => 1},
+    profiles       => {mybugslink => 1, newemailtech => 1},
+    namedqueries   => {linkinfooter => 1, watchfordiffs => 1},
+    groups         => {isbuggroup => 1, isactive => 1},
+    group_control_map => {entry => 1, membercontrol => 1, othercontrol => 1,
+                          canedit => 1},
+    group_group_map => {isbless => 1},
+    user_group_map => {isbless => 1, isderived => 1},
+    products       => {disallownew => 1},
+    series         => {public => 1},
+    whine_queries  => {onemailperbug => 1},
+    quips          => {approved => 1},
+    setting        => {is_enabled => 1}
+};
+
+# Maps the db_specific hash backwards, for use in column_info_to_column.
+use constant REVERSE_MAPPING => {
+    # Boolean and the SERIAL fields are handled in column_info_to_column,
+    # and so don't have an entry here.
+    TINYINT   => 'INT1',
+    SMALLINT  => 'INT2',
+    MEDIUMINT => 'INT3',
+    INTEGER   => 'INT4',
+
+    # All the other types have the same name in their abstract version
+    # as in their db-specific version, so no reverse mapping is needed.
+};
+
+use constant MYISAM_TABLES => qw(bugs_fulltext);
+
+#------------------------------------------------------------------------------
+sub _initialize {
+
+    my $self = shift;
+
+    $self = $self->SUPER::_initialize(@_);
+
+    $self->{db_specific} = {
+
+        BOOLEAN =>      'tinyint',
+        FALSE =>        '0', 
+        TRUE =>         '1',
+
+        INT1 =>         'tinyint',
+        INT2 =>         'smallint',
+        INT3 =>         'mediumint',
+        INT4 =>         'integer',
+
+        SMALLSERIAL =>  'smallint auto_increment',
+        MEDIUMSERIAL => 'mediumint auto_increment',
+        INTSERIAL =>    'integer auto_increment',
+
+        TINYTEXT =>     'tinytext',
+        MEDIUMTEXT =>   'mediumtext',
+        LONGTEXT =>     'mediumtext',
+
+        LONGBLOB =>     'longblob',
+
+        DATETIME =>     'datetime',
+
+    };
+
+    $self->_adjust_schema;
+
+    return $self;
+
+} #eosub--_initialize
+#------------------------------------------------------------------------------
+sub _get_create_table_ddl {
+    # Extend superclass method to specify the MYISAM storage engine.
+    # Returns a "create table" SQL statement.
+
+    my($self, $table) = @_;
+
+    my $charset = Bugzilla->dbh->bz_db_is_utf8 ? "CHARACTER SET utf8" : '';
+    my $type    = grep($_ eq $table, MYISAM_TABLES) ? 'MYISAM' : 'InnoDB';
+    return($self->SUPER::_get_create_table_ddl($table) 
+           . " ENGINE = $type $charset");
+
+} #eosub--_get_create_table_ddl
+#------------------------------------------------------------------------------
+sub _get_create_index_ddl {
+    # Extend superclass method to create FULLTEXT indexes on text fields.
+    # Returns a "create index" SQL statement.
+
+    my($self, $table_name, $index_name, $index_fields, $index_type) = @_;
+
+    my $sql = "CREATE ";
+    $sql .= "$index_type " if ($index_type eq 'UNIQUE'
+                               || $index_type eq 'FULLTEXT');
+    $sql .= "INDEX \`$index_name\` ON $table_name \(" .
+      join(", ", @$index_fields) . "\)";
+
+    return($sql);
+
+} #eosub--_get_create_index_ddl
+#--------------------------------------------------------------------
+
+sub get_create_database_sql {
+    my ($self, $name) = @_;
+    # We only create as utf8 if we have no params (meaning we're doing
+    # a new installation) or if the utf8 param is on.
+    my $create_utf8 = Bugzilla->params->{'utf8'} 
+                      || !defined Bugzilla->params->{'utf8'};
+    my $charset = $create_utf8 ? "CHARACTER SET utf8" : '';
+    return ("CREATE DATABASE $name $charset");
+}
+
+# MySQL has a simpler ALTER TABLE syntax than ANSI.
+sub get_alter_column_ddl {
+    my ($self, $table, $column, $new_def, $set_nulls_to) = @_;
+    my $old_def = $self->get_column($table, $column);
+    my %new_def_copy = %$new_def;
+    if ($old_def->{PRIMARYKEY} && $new_def->{PRIMARYKEY}) {
+        # If a column stays a primary key do NOT specify PRIMARY KEY in the
+        # ALTER TABLE statement. This avoids a MySQL error that two primary
+        # keys are not allowed.
+        delete $new_def_copy{PRIMARYKEY};
+    }
+
+    my @statements;
+
+    push(@statements, "UPDATE $table SET $column = $set_nulls_to
+                        WHERE $column IS NULL") if defined $set_nulls_to;
+
+    # Calling SET DEFAULT or DROP DEFAULT is *way* faster than calling
+    # CHANGE COLUMN, so just do that if we're just changing the default.
+    my %old_defaultless = %$old_def;
+    my %new_defaultless = %$new_def;
+    delete $old_defaultless{DEFAULT};
+    delete $new_defaultless{DEFAULT};
+    if (!$self->columns_equal($old_def, $new_def)
+        && $self->columns_equal(\%new_defaultless, \%old_defaultless)) 
+    {
+        if (!defined $new_def->{DEFAULT}) {
+            push(@statements,
+                 "ALTER TABLE $table ALTER COLUMN $column DROP DEFAULT");
+        }
+        else {
+            push(@statements, "ALTER TABLE $table ALTER COLUMN $column
+                               SET DEFAULT " . $new_def->{DEFAULT});
+        }
+    }
+    else {
+        my $new_ddl = $self->get_type_ddl(\%new_def_copy);
+        push(@statements, "ALTER TABLE $table CHANGE COLUMN 
+                       $column $column $new_ddl");
+    }
+
+    if ($old_def->{PRIMARYKEY} && !$new_def->{PRIMARYKEY}) {
+        # Dropping a PRIMARY KEY needs an explicit DROP PRIMARY KEY
+        push(@statements, "ALTER TABLE $table DROP PRIMARY KEY");
+    }
+
+    return @statements;
+}
+
+sub get_drop_fk_sql {
+    my ($self, $table, $column, $references) = @_;
+    my $fk_name = $self->_get_fk_name($table, $column, $references);
+    my @sql = ("ALTER TABLE $table DROP FOREIGN KEY $fk_name");
+    my $dbh = Bugzilla->dbh;
+
+    # MySQL requires, and will create, an index on any column with
+    # an FK. It will name it after the fk, which we never do.
+    # So if there's an index named after the fk, we also have to delete it. 
+    if ($dbh->bz_index_info_real($table, $fk_name)) {
+        push(@sql, $self->get_drop_index_ddl($table, $fk_name));
+    }
+
+    return @sql;
+}
+
+sub get_drop_index_ddl {
+    my ($self, $table, $name) = @_;
+    return ("DROP INDEX \`$name\` ON $table");
+}
+
+# A special function for MySQL, for renaming a lot of indexes.
+# Index renames is a hash, where the key is a string - the 
+# old names of the index, and the value is a hash - the index
+# definition that we're renaming to, with an extra key of "NAME"
+# that contains the new index name.
+# The indexes in %indexes must be in hashref format.
+sub get_rename_indexes_ddl {
+    my ($self, $table, %indexes) = @_;
+    my @keys = keys %indexes or return ();
+
+    my $sql = "ALTER TABLE $table ";
+
+    foreach my $old_name (@keys) {
+        my $name = $indexes{$old_name}->{NAME};
+        my $type = $indexes{$old_name}->{TYPE};
+        $type ||= 'INDEX';
+        my $fields = join(',', @{$indexes{$old_name}->{FIELDS}});
+        # $old_name needs to be escaped, sometimes, because it was
+        # a reserved word.
+        $old_name = '`' . $old_name . '`';
+        $sql .= " ADD $type $name ($fields), DROP INDEX $old_name,";
+    }
+    # Remove the last comma.
+    chop($sql);
+    return ($sql);
+}
+
+sub get_set_serial_sql {
+    my ($self, $table, $column, $value) = @_;
+    return ("ALTER TABLE $table AUTO_INCREMENT = $value");
+}
+
+# Converts a DBI column_info output to an abstract column definition.
+# Expects to only be called by Bugzila::DB::Mysql::_bz_build_schema_from_disk,
+# although there's a chance that it will also work properly if called
+# elsewhere.
+sub column_info_to_column {
+    my ($self, $column_info) = @_;
+
+    # Unfortunately, we have to break Schema's normal "no database"
+    # barrier a few times in this function.
+    my $dbh = Bugzilla->dbh;
+
+    my $table = $column_info->{TABLE_NAME};
+    my $col_name = $column_info->{COLUMN_NAME};
+
+    my $column = {};
+
+    ($column->{NOTNULL} = 1) if $column_info->{NULLABLE} == 0;
+
+    if ($column_info->{mysql_is_pri_key}) {
+        # In MySQL, if a table has no PK, but it has a UNIQUE index,
+        # that index will show up as the PK. So we have to eliminate
+        # that possibility.
+        # Unfortunately, the only way to definitely solve this is
+        # to break Schema's standard of not touching the live database
+        # and check if the index called PRIMARY is on that field.
+        my $pri_index = $dbh->bz_index_info_real($table, 'PRIMARY');
+        if ( $pri_index && grep($_ eq $col_name, @{$pri_index->{FIELDS}}) ) {
+            $column->{PRIMARYKEY} = 1;
+        }
+    }
+
+    # MySQL frequently defines a default for a field even when we
+    # didn't explicitly set one. So we have to have some special
+    # hacks to determine whether or not we should actually put
+    # a default in the abstract schema for this field.
+    if (defined $column_info->{COLUMN_DEF}) {
+        # The defaults that MySQL inputs automatically are usually
+        # something that would be considered "false" by perl, either
+        # a 0 or an empty string. (Except for datetime and decimal
+        # fields, which have their own special auto-defaults.)
+        #
+        # Here's how we handle this: If it exists in the schema
+        # without a default, then we don't use the default. If it
+        # doesn't exist in the schema, then we're either going to
+        # be dropping it soon, or it's a custom end-user column, in which
+        # case having a bogus default won't harm anything.
+        my $schema_column = $self->get_column($table, $col_name);
+        unless ( (!$column_info->{COLUMN_DEF} 
+                  || $column_info->{COLUMN_DEF} eq '0000-00-00 00:00:00'
+                  || $column_info->{COLUMN_DEF} eq '0.00')
+                && $schema_column 
+                && !exists $schema_column->{DEFAULT}) {
+            
+            my $default = $column_info->{COLUMN_DEF};
+            # Schema uses '0' for the defaults for decimal fields. 
+            $default = 0 if $default =~ /^0\.0+$/;
+            # If we're not a number, we're a string and need to be
+            # quoted.
+            $default = $dbh->quote($default) if !($default =~ /^(-)?(\d+)(.\d+)?$/);
+            $column->{DEFAULT} = $default;
+        }
+    }
+
+    my $type = $column_info->{TYPE_NAME};
+
+    # Certain types of columns need the size/precision appended.
+    if ($type =~ /CHAR$/ || $type eq 'DECIMAL') {
+        # This is nicely lowercase and has the size/precision appended.
+        $type = $column_info->{mysql_type_name};
+    }
+
+    # If we're a tinyint, we could be either a BOOLEAN or an INT1.
+    # Only the BOOLEAN_MAP knows the difference.
+    elsif ($type eq 'TINYINT' && exists BOOLEAN_MAP->{$table}
+           && exists BOOLEAN_MAP->{$table}->{$col_name}) {
+        $type = 'BOOLEAN';
+        if (exists $column->{DEFAULT}) {
+            $column->{DEFAULT} = $column->{DEFAULT} ? 'TRUE' : 'FALSE';
+        }
+    }
+
+    # We also need to check if we're an auto_increment field.
+    elsif ($type =~ /INT/) {
+        # Unfortunately, the only way to do this in DBI is to query the
+        # database, so we have to break the rule here that Schema normally
+        # doesn't touch the live DB.
+        my $ref_sth = $dbh->prepare(
+            "SELECT $col_name FROM $table LIMIT 1");
+        $ref_sth->execute;
+        if ($ref_sth->{mysql_is_auto_increment}->[0]) {
+            if ($type eq 'MEDIUMINT') {
+                $type = 'MEDIUMSERIAL';
+            }
+            elsif ($type eq 'SMALLINT') {
+                $type = 'SMALLSERIAL';
+            } 
+            else {
+                $type = 'INTSERIAL';
+            }
+        }
+        $ref_sth->finish;
+
+    }
+
+    # For all other db-specific types, check if they exist in 
+    # REVERSE_MAPPING and use the type found there.
+    if (exists REVERSE_MAPPING->{$type}) {
+        $type = REVERSE_MAPPING->{$type};
+    }
+
+    $column->{TYPE} = $type;
+
+    #print "$table.$col_name: " . Data::Dumper->Dump([$column]) . "\n";
+
+    return $column;
+}
+
+sub get_rename_column_ddl {
+    my ($self, $table, $old_name, $new_name) = @_;
+    my $def = $self->get_type_ddl($self->get_column($table, $old_name));
+    # MySQL doesn't like having the PRIMARY KEY statement in a rename.
+    $def =~ s/PRIMARY KEY//i;
+    return ("ALTER TABLE $table CHANGE COLUMN $old_name $new_name $def");
+}
+
+1;

diff --git a/Bugzilla/DB/Schema/Oracle.pm b/Bugzilla/DB/Schema/Oracle.pm
new file mode 100644 (file)
index 0000000..381906d
--- /dev/null
+++ b/Bugzilla/DB/Schema/Oracle.pm
@@ -0,0 +1,501 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::DB::Schema::Oracle;
+
+###############################################################################
+#
+# DB::Schema implementation for Oracle
+#
+###############################################################################
+
+use strict;
+
+use base qw(Bugzilla::DB::Schema);
+use Carp qw(confess);
+use Bugzilla::Util;
+
+use constant ADD_COLUMN => 'ADD';
+use constant MULTIPLE_FKS_IN_ALTER => 0;
+# Whether this is true or not, this is what it needs to be in order for
+# hash_identifier to maintain backwards compatibility with versions before
+# 3.2rc2.
+use constant MAX_IDENTIFIER_LEN => 27;
+
+#------------------------------------------------------------------------------
+sub _initialize {
+
+    my $self = shift;
+
+    $self = $self->SUPER::_initialize(@_);
+
+    $self->{db_specific} = {
+
+        BOOLEAN =>      'integer',
+        FALSE =>        '0', 
+        TRUE =>         '1',
+
+        INT1 =>         'integer',
+        INT2 =>         'integer',
+        INT3 =>         'integer',
+        INT4 =>         'integer',
+
+        SMALLSERIAL  => 'integer',
+        MEDIUMSERIAL => 'integer',
+        INTSERIAL    => 'integer',
+
+        TINYTEXT   =>   'varchar(255)',
+        MEDIUMTEXT =>   'varchar(4000)',
+        LONGTEXT   =>   'clob',
+
+        LONGBLOB =>     'blob',
+
+        DATETIME =>     'date',
+
+    };
+
+    $self->_adjust_schema;
+
+    return $self;
+
+} #eosub--_initialize
+#--------------------------------------------------------------------
+
+sub get_table_ddl {
+    my $self = shift;
+    my $table = shift;
+    unshift @_, $table;
+    my @ddl = $self->SUPER::get_table_ddl(@_);
+
+    my @fields = @{ $self->{abstract_schema}{$table}{FIELDS} || [] };
+    while (@fields) {
+        my $field_name = shift @fields;
+        my $field_info = shift @fields;
+        # Create triggers to deal with empty string. 
+        if ( $field_info->{TYPE} =~ /varchar|TEXT/i 
+                && $field_info->{NOTNULL} ) {
+             push (@ddl, _get_notnull_trigger_ddl($table, $field_name));
+        }
+        # Create sequences and triggers to emulate SERIAL datatypes.
+        if ( $field_info->{TYPE} =~ /SERIAL/i ) {
+            push (@ddl, $self->_get_create_seq_ddl($table, $field_name));
+        }
+    }
+    return @ddl;
+
+} #eosub--get_table_ddl
+
+# Extend superclass method to create Oracle Text indexes if index type 
+# is FULLTEXT from schema. Returns a "create index" SQL statement.
+sub _get_create_index_ddl {
+
+    my ($self, $table_name, $index_name, $index_fields, $index_type) = @_;
+    $index_name = "idx_" . $self->_hash_identifier($index_name);
+    if ($index_type eq 'FULLTEXT') {
+        my $sql = "CREATE INDEX $index_name ON $table_name (" 
+                  . join(',',@$index_fields)
+                  . ") INDEXTYPE IS CTXSYS.CONTEXT "
+                  . " PARAMETERS('LEXER BZ_LEX SYNC(ON COMMIT)')" ;
+        return $sql;
+    }
+
+    return($self->SUPER::_get_create_index_ddl($table_name, $index_name, 
+                                               $index_fields, $index_type));
+
+}
+
+sub get_drop_index_ddl {
+    my $self = shift;
+    my ($table, $name) = @_;
+
+    $name = 'idx_' . $self->_hash_identifier($name);
+    return $self->SUPER::get_drop_index_ddl($table, $name);
+}
+
+# Oracle supports the use of FOREIGN KEY integrity constraints 
+# to define the referential integrity actions, including:
+# - Update and delete No Action (default)
+# - Delete CASCADE
+# - Delete SET NULL
+sub get_fk_ddl {
+    my $self = shift;
+    my $ddl = $self->SUPER::get_fk_ddl(@_);
+
+    # iThe Bugzilla Oracle driver implements UPDATE via a trigger.
+    $ddl =~ s/ON UPDATE \S+//i;
+    # RESTRICT is the default for DELETE on Oracle and may not be specified.
+    $ddl =~ s/ON DELETE RESTRICT//i;
+
+    return $ddl;
+}
+
+sub get_add_fks_sql {
+    my $self = shift;
+    my ($table, $column_fks) = @_;
+    my @sql = $self->SUPER::get_add_fks_sql(@_);
+
+    foreach my $column (keys %$column_fks) {
+        my $fk = $column_fks->{$column};
+        next if $fk->{UPDATE} && uc($fk->{UPDATE}) ne 'CASCADE';
+        my $fk_name   = $self->_get_fk_name($table, $column, $fk);
+        my $to_column = $fk->{COLUMN};
+        my $to_table  = $fk->{TABLE};
+
+        my $trigger = <<END;
+CREATE OR REPLACE TRIGGER ${fk_name}_UC
+          AFTER UPDATE OF $to_column ON $to_table
+              REFERENCING NEW AS NEW OLD AS OLD
+             FOR EACH ROW
+                    BEGIN
+                   UPDATE $table
+                      SET $column = :NEW.$to_column
+                    WHERE $column = :OLD.$to_column;
+                      END ${fk_name}_UC;
+END
+        push(@sql, $trigger);
+    }
+
+    return @sql;
+}
+
+sub get_drop_fk_sql {
+    my $self = shift;
+    my ($table, $column, $references) = @_;
+    my $fk_name = $self->_get_fk_name(@_);
+    my @sql;
+    if (!$references->{UPDATE} || $references->{UPDATE} =~ /CASCADE/i) {
+        push(@sql, "DROP TRIGGER ${fk_name}_uc");
+    }
+    push(@sql, $self->SUPER::get_drop_fk_sql(@_));
+    return @sql;
+}
+
+sub _get_fk_name {
+    my ($self, $table, $column, $references) = @_;
+    my $to_table  = $references->{TABLE};
+    my $to_column = $references->{COLUMN};
+    my $fk_name   = "${table}_${column}_${to_table}_${to_column}";
+    $fk_name      = "fk_" . $self->_hash_identifier($fk_name);
+    
+    return $fk_name;
+}
+
+sub get_add_column_ddl {
+    my $self = shift;
+    my ($table, $column, $definition, $init_value) = @_;
+    my @sql;
+
+    # Create sequences and triggers to emulate SERIAL datatypes.
+    if ($definition->{TYPE} =~ /SERIAL/i) {
+        # Clone the definition to not alter the original one.
+        my %def = %$definition;
+        # Oracle requires to define the column is several steps.
+        my $pk = delete $def{PRIMARYKEY};
+        my $notnull = delete $def{NOTNULL};
+        @sql = $self->SUPER::get_add_column_ddl($table, $column, \%def, $init_value);
+        push(@sql, $self->_get_create_seq_ddl($table, $column));
+        push(@sql, "UPDATE $table SET $column = ${table}_${column}_SEQ.NEXTVAL");
+        push(@sql, "ALTER TABLE $table MODIFY $column NOT NULL") if $notnull;
+        push(@sql, "ALTER TABLE $table ADD PRIMARY KEY ($column)") if $pk;
+    }
+    else {
+        @sql = $self->SUPER::get_add_column_ddl(@_);
+    }
+
+    return @sql;
+}
+
+sub get_alter_column_ddl {
+    my ($self, $table, $column, $new_def, $set_nulls_to) = @_;
+
+    my @statements;
+    my $old_def = $self->get_column_abstract($table, $column);
+    my $specific = $self->{db_specific};
+
+    # If the types have changed, we have to deal with that.
+    if (uc(trim($old_def->{TYPE})) ne uc(trim($new_def->{TYPE}))) {
+        push(@statements, $self->_get_alter_type_sql($table, $column, 
+                                                     $new_def, $old_def));
+    }
+
+    my $default = $new_def->{DEFAULT};
+    my $default_old = $old_def->{DEFAULT};
+
+    if (defined $default) {
+        $default = $specific->{$default} if exists $specific->{$default};
+    }
+    # This first condition prevents "uninitialized value" errors.
+    if (!defined $default && !defined $default_old) {
+        # Do Nothing
+    }
+    # If we went from having a default to not having one
+    elsif (!defined $default && defined $default_old) {
+        push(@statements, "ALTER TABLE $table MODIFY $column"
+                        . " DEFAULT NULL");
+    }
+    # If we went from no default to a default, or we changed the default.
+    elsif ( (defined $default && !defined $default_old) || 
+            ($default ne $default_old) ) 
+    {
+        push(@statements, "ALTER TABLE $table MODIFY $column "
+                         . " DEFAULT $default");
+    }
+
+    # If we went from NULL to NOT NULL.
+    if (!$old_def->{NOTNULL} && $new_def->{NOTNULL}) {
+        my $setdefault;
+        # Handle any fields that were NULL before, if we have a default,
+        $setdefault = $default if defined $default;
+        # But if we have a set_nulls_to, that overrides the DEFAULT 
+        # (although nobody would usually specify both a default and 
+        # a set_nulls_to.)
+        $setdefault = $set_nulls_to if defined $set_nulls_to;
+        if (defined $setdefault) {
+            push(@statements, "UPDATE $table SET $column = $setdefault"
+                            . "  WHERE $column IS NULL");
+        }
+        push(@statements, "ALTER TABLE $table MODIFY $column"
+                        . " NOT NULL");
+        push (@statements, _get_notnull_trigger_ddl($table, $column))
+                                   if $old_def->{TYPE} =~ /varchar|text/i
+                                     && $new_def->{TYPE} =~ /varchar|text/i;
+    }
+    # If we went from NOT NULL to NULL
+    elsif ($old_def->{NOTNULL} && !$new_def->{NOTNULL}) {
+        push(@statements, "ALTER TABLE $table MODIFY $column"
+                        . " NULL");
+        push(@statements, "DROP TRIGGER ${table}_${column}")
+                           if $new_def->{TYPE} =~ /varchar|text/i 
+                             && $old_def->{TYPE} =~ /varchar|text/i;
+    }
+
+    # If we went from not being a PRIMARY KEY to being a PRIMARY KEY.
+    if (!$old_def->{PRIMARYKEY} && $new_def->{PRIMARYKEY}) {
+        push(@statements, "ALTER TABLE $table ADD PRIMARY KEY ($column)");
+    }
+    # If we went from being a PK to not being a PK
+    elsif ( $old_def->{PRIMARYKEY} && !$new_def->{PRIMARYKEY} ) {
+        push(@statements, "ALTER TABLE $table DROP PRIMARY KEY");
+    }
+
+    return @statements;
+}
+
+sub _get_alter_type_sql {
+    my ($self, $table, $column, $new_def, $old_def) = @_;
+    my @statements;
+
+    my $type = $new_def->{TYPE};
+    $type = $self->{db_specific}->{$type} 
+        if exists $self->{db_specific}->{$type};
+
+    if ($type =~ /serial/i && $old_def->{TYPE} !~ /serial/i) {
+        die("You cannot specify a DEFAULT on a SERIAL-type column.") 
+            if $new_def->{DEFAULT};
+    }
+
+    if ( ($old_def->{TYPE} =~ /LONGTEXT/i && $new_def->{TYPE} !~ /LONGTEXT/i) 
+         || ($old_def->{TYPE} !~ /LONGTEXT/i && $new_def->{TYPE} =~ /LONGTEXT/i)
+       ) {
+        # LONG to VARCHAR or VARCHAR to LONG is not allowed in Oracle, 
+        # just a way to work around.
+        # Determine whether column_temp is already exist.
+        my $dbh=Bugzilla->dbh;
+        my $column_exist = $dbh->selectcol_arrayref(
+                          "SELECT CNAME FROM COL WHERE TNAME = UPPER(?) AND 
+                             CNAME = UPPER(?)", undef,$table,$column . "_temp");
+        if(!@$column_exist) {
+        push(@statements, 
+            "ALTER TABLE $table ADD ${column}_temp $type");  
+        }
+        push(@statements, "UPDATE $table SET ${column}_temp = $column");
+        push(@statements, "COMMIT");
+        push(@statements, "ALTER TABLE $table DROP COLUMN $column");
+        push(@statements, 
+            "ALTER TABLE $table RENAME COLUMN ${column}_temp TO $column");
+    } else {  
+        push(@statements, "ALTER TABLE $table MODIFY $column $type");
+    }
+
+    if ($new_def->{TYPE} =~ /serial/i && $old_def->{TYPE} !~ /serial/i) {
+         push(@statements, _get_create_seq_ddl($table, $column));
+    }
+
+    # If this column is no longer SERIAL, we need to drop the sequence
+    # that went along with it.
+    if ($old_def->{TYPE} =~ /serial/i && $new_def->{TYPE} !~ /serial/i) {
+        push(@statements, "DROP SEQUENCE ${table}_${column}_SEQ");
+        push(@statements, "DROP TRIGGER ${table}_${column}_TR");
+    }
+    
+    # If this column is changed to type TEXT/VARCHAR, we need to deal with
+    # empty string.
+    if ( $old_def->{TYPE} !~ /varchar|text/i 
+            && $new_def->{TYPE} =~ /varchar|text/i 
+            && $new_def->{NOTNULL} )
+    {
+             push (@statements, _get_notnull_trigger_ddl($table, $column));
+    } 
+    # If this column is no longer TEXT/VARCHAR, we need to drop the trigger
+    # that went along with it.
+    if ( $old_def->{TYPE} =~ /varchar|text/i
+            && $old_def->{NOTNULL}
+            && $new_def->{TYPE} !~ /varchar|text/i )
+    {
+        push(@statements, "DROP TRIGGER ${table}_${column}");
+    } 
+    return @statements;
+}
+
+sub get_rename_column_ddl {
+    my ($self, $table, $old_name, $new_name) = @_;
+    if (lc($old_name) eq lc($new_name)) {
+        # if the only change is a case change, return an empty list.
+        return ();
+    }
+    my @sql = ("ALTER TABLE $table RENAME COLUMN $old_name TO $new_name");
+    my $def = $self->get_column_abstract($table, $old_name);
+    if ($def->{TYPE} =~ /SERIAL/i) {
+        # We have to rename the series also, and fix the default of the series.
+        my $old_seq = "${table}_${old_name}_SEQ";
+        my $new_seq = "${table}_${new_name}_SEQ";
+        push(@sql, "RENAME $old_seq TO $new_seq");
+        push(@sql, $self->_get_create_trigger_ddl($table, $new_name, $new_seq));
+        push(@sql, "DROP TRIGGER ${table}_${old_name}_TR");
+    }
+    if ($def->{TYPE} =~ /varchar|text/i && $def->{NOTNULL} ) {
+        push(@sql, _get_notnull_trigger_ddl($table,$new_name));
+        push(@sql, "DROP TRIGGER ${table}_${old_name}");
+    }
+    return @sql;
+}
+
+sub get_drop_column_ddl {
+    my $self = shift;
+    my ($table, $column) = @_;
+    my @sql;
+    push(@sql, $self->SUPER::get_drop_column_ddl(@_));
+    my $dbh=Bugzilla->dbh;
+    my $trigger_name = uc($table . "_" . $column);
+    my $exist_trigger = $dbh->selectcol_arrayref(
+        "SELECT OBJECT_NAME FROM USER_OBJECTS
+         WHERE OBJECT_NAME = ?", undef, $trigger_name);
+    if(@$exist_trigger) {
+        push(@sql, "DROP TRIGGER $trigger_name");
+    }
+    # If this column is of type SERIAL, we need to drop the sequence
+    # and trigger that went along with it.
+    my $def = $self->get_column_abstract($table, $column);
+    if ($def->{TYPE} =~ /SERIAL/i) {
+        push(@sql, "DROP SEQUENCE ${table}_${column}_SEQ");
+        push(@sql, "DROP TRIGGER ${table}_${column}_TR");
+    }
+    return @sql;
+}
+
+sub get_rename_table_sql {
+    my ($self, $old_name, $new_name) = @_;
+    if (lc($old_name) eq lc($new_name)) {
+        # if the only change is a case change, return an empty list.
+        return ();
+    }
+
+    my @sql = ("ALTER TABLE $old_name RENAME TO $new_name");
+    my @columns = $self->get_table_columns($old_name);
+    foreach my $column (@columns) {
+        my $def = $self->get_column_abstract($old_name, $column);
+        if ($def->{TYPE} =~ /SERIAL/i) {
+            # If there's a SERIAL column on this table, we also need
+            # to rename the sequence.
+            my $old_seq = "${old_name}_${column}_SEQ";
+            my $new_seq = "${new_name}_${column}_SEQ";
+            push(@sql, "RENAME $old_seq TO $new_seq");
+            push(@sql, $self->_get_create_trigger_ddl($new_name, $column, $new_seq));
+            push(@sql, "DROP TRIGGER ${old_name}_${column}_TR");
+        }
+        if ($def->{TYPE} =~ /varchar|text/i && $def->{NOTNULL}) {
+            push(@sql, _get_notnull_trigger_ddl($new_name, $column));
+            push(@sql, "DROP TRIGGER ${old_name}_${column}");
+        }
+    }
+
+    return @sql;
+}
+
+sub get_drop_table_ddl {
+    my ($self, $name) = @_;
+    my @sql;
+
+    my @columns = $self->get_table_columns($name);
+    foreach my $column (@columns) {
+        my $def = $self->get_column_abstract($name, $column);
+        if ($def->{TYPE} =~ /SERIAL/i) {
+            # If there's a SERIAL column on this table, we also need
+            # to remove the sequence.
+            push(@sql, "DROP SEQUENCE ${name}_${column}_SEQ");
+        }
+    }
+    push(@sql, "DROP TABLE $name CASCADE CONSTRAINTS PURGE");
+
+    return @sql;
+}
+
+sub _get_notnull_trigger_ddl {
+      my ($table, $column) = @_;
+
+      my $notnull_sql = "CREATE OR REPLACE TRIGGER "
+                        . " ${table}_${column}"
+                        . " BEFORE INSERT OR UPDATE ON ". $table
+                        . " FOR EACH ROW"
+                        . " BEGIN "
+                        . " IF :NEW.". $column ." IS NULL THEN  "
+                        . " SELECT '" . Bugzilla::DB::Oracle->EMPTY_STRING
+                        . "' INTO :NEW.". $column ." FROM DUAL; "
+                        . " END IF; "
+                        . " END ".$table.";";
+     return $notnull_sql;
+}
+
+sub _get_create_seq_ddl {
+     my ($self, $table, $column, $start_with) = @_;
+     $start_with ||= 1;
+     my @ddl;
+     my $seq_name = "${table}_${column}_SEQ";
+     my $seq_sql = "CREATE SEQUENCE $seq_name "
+                   . " INCREMENT BY 1 "
+                   . " START WITH $start_with "
+                   . " NOMAXVALUE "
+                   . " NOCYCLE "
+                   . " NOCACHE";
+    push (@ddl, $seq_sql);
+    push(@ddl, $self->_get_create_trigger_ddl($table, $column, $seq_name));
+
+    return @ddl;
+}
+
+sub _get_create_trigger_ddl {
+    my ($self, $table, $column, $seq_name) = @_;
+    my $serial_sql = "CREATE OR REPLACE TRIGGER ${table}_${column}_TR "
+                   . " BEFORE INSERT ON $table "
+                   . " FOR EACH ROW "
+                   . " BEGIN "
+                   . "   SELECT ${seq_name}.NEXTVAL "
+                   . "   INTO :NEW.$column FROM DUAL; "
+                   . " END;";
+    return $serial_sql;
+}
+
+sub get_set_serial_sql { 
+    my ($self, $table, $column, $value) = @_; 
+    my @sql;
+    my $seq_name = "${table}_${column}_SEQ";
+    push(@sql, "DROP SEQUENCE ${seq_name}");
+    push(@sql, $self->_get_create_seq_ddl($table, $column, $value));       
+    return @sql;
+} 
+
+1;

diff --git a/Bugzilla/DB/Schema/Pg.pm b/Bugzilla/DB/Schema/Pg.pm
new file mode 100644 (file)
index 0000000..3dc0fe8
--- /dev/null
+++ b/Bugzilla/DB/Schema/Pg.pm
@@ -0,0 +1,188 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::DB::Schema::Pg;
+
+###############################################################################
+#
+# DB::Schema implementation for PostgreSQL
+#
+###############################################################################
+
+use strict;
+use base qw(Bugzilla::DB::Schema);
+use Storable qw(dclone);
+
+#------------------------------------------------------------------------------
+sub _initialize {
+
+    my $self = shift;
+
+    $self = $self->SUPER::_initialize(@_);
+
+    # Remove FULLTEXT index types from the schemas.
+    foreach my $table (keys %{ $self->{schema} }) {
+        if ($self->{schema}{$table}{INDEXES}) {
+            foreach my $index (@{ $self->{schema}{$table}{INDEXES} }) {
+                if (ref($index) eq 'HASH') {
+                    delete($index->{TYPE}) if (exists $index->{TYPE} 
+                        && $index->{TYPE} eq 'FULLTEXT');
+                }
+            }
+            foreach my $index (@{ $self->{abstract_schema}{$table}{INDEXES} }) {
+                if (ref($index) eq 'HASH') {
+                    delete($index->{TYPE}) if (exists $index->{TYPE} 
+                        && $index->{TYPE} eq 'FULLTEXT');
+                }
+            }
+        }
+    }
+
+    $self->{db_specific} = {
+
+        BOOLEAN =>      'smallint',
+        FALSE =>        '0', 
+        TRUE =>         '1',
+
+        INT1 =>         'integer',
+        INT2 =>         'integer',
+        INT3 =>         'integer',
+        INT4 =>         'integer',
+
+        SMALLSERIAL =>  'serial unique',
+        MEDIUMSERIAL => 'serial unique',
+        INTSERIAL =>    'serial unique',
+
+        TINYTEXT =>     'varchar(255)',
+        MEDIUMTEXT =>   'text',
+        LONGTEXT =>     'text',
+
+        LONGBLOB =>     'bytea',
+
+        DATETIME =>     'timestamp(0) without time zone',
+
+    };
+
+    $self->_adjust_schema;
+
+    return $self;
+
+} #eosub--_initialize
+#--------------------------------------------------------------------
+
+sub get_create_database_sql {
+    my ($self, $name) = @_;
+    # We only create as utf8 if we have no params (meaning we're doing
+    # a new installation) or if the utf8 param is on.
+    my $create_utf8 = Bugzilla->params->{'utf8'}
+                      || !defined Bugzilla->params->{'utf8'};
+    my $charset = $create_utf8 ? "ENCODING 'UTF8' TEMPLATE template0" : '';
+    return ("CREATE DATABASE $name $charset");
+}
+
+sub get_rename_column_ddl {
+    my ($self, $table, $old_name, $new_name) = @_;
+    if (lc($old_name) eq lc($new_name)) {
+        # if the only change is a case change, return an empty list, since Pg
+        # is case-insensitive and will return an error about a duplicate name
+        return ();
+    }
+    my @sql = ("ALTER TABLE $table RENAME COLUMN $old_name TO $new_name");
+    my $def = $self->get_column_abstract($table, $old_name);
+    if ($def->{TYPE} =~ /SERIAL/i) {
+        # We have to rename the series also.
+        push(@sql, "ALTER SEQUENCE ${table}_${old_name}_seq 
+                         RENAME TO ${table}_${new_name}_seq");
+    }
+    return @sql;
+}
+
+sub get_rename_table_sql {
+    my ($self, $old_name, $new_name) = @_;
+    if (lc($old_name) eq lc($new_name)) {
+        # if the only change is a case change, return an empty list, since Pg
+        # is case-insensitive and will return an error about a duplicate name
+        return ();
+    }
+
+    my @sql = ("ALTER TABLE $old_name RENAME TO $new_name");
+
+    # If there's a SERIAL column on this table, we also need to rename the
+    # sequence.
+    # If there is a PRIMARY KEY, we need to rename it too.
+    my @columns = $self->get_table_columns($old_name);
+    foreach my $column (@columns) {
+        my $def = $self->get_column_abstract($old_name, $column);
+        if ($def->{TYPE} =~ /SERIAL/i) {
+            my $old_seq = "${old_name}_${column}_seq";
+            my $new_seq = "${new_name}_${column}_seq";
+            push(@sql, "ALTER SEQUENCE $old_seq RENAME TO $new_seq");
+            push(@sql, "ALTER TABLE $new_name ALTER COLUMN $column
+                             SET DEFAULT NEXTVAL('$new_seq')");
+        }
+        if ($def->{PRIMARYKEY}) {
+            my $old_pk = "${old_name}_pkey";
+            my $new_pk = "${new_name}_pkey";
+            push(@sql, "ALTER INDEX $old_pk RENAME to $new_pk");
+        }
+    }
+
+    return @sql;
+}
+
+sub get_set_serial_sql {
+    my ($self, $table, $column, $value) = @_;
+    return ("SELECT setval('${table}_${column}_seq', $value, false)
+               FROM $table");
+}
+
+sub _get_alter_type_sql {
+    my ($self, $table, $column, $new_def, $old_def) = @_;
+    my @statements;
+
+    my $type = $new_def->{TYPE};
+    $type = $self->{db_specific}->{$type} 
+        if exists $self->{db_specific}->{$type};
+
+    if ($type =~ /serial/i && $old_def->{TYPE} !~ /serial/i) {
+        die("You cannot specify a DEFAULT on a SERIAL-type column.") 
+            if $new_def->{DEFAULT};
+    }
+
+    $type =~ s/\bserial\b/integer/i;
+
+    # On Pg, you don't need UNIQUE if you're a PK--it creates
+    # two identical indexes otherwise.
+    $type =~ s/unique//i if $new_def->{PRIMARYKEY};
+
+    push(@statements, "ALTER TABLE $table ALTER COLUMN $column
+                              TYPE $type");
+
+    if ($new_def->{TYPE} =~ /serial/i && $old_def->{TYPE} !~ /serial/i) {
+        push(@statements, "CREATE SEQUENCE ${table}_${column}_seq
+                                  OWNED BY $table.$column");
+        push(@statements, "SELECT setval('${table}_${column}_seq',
+                                         MAX($table.$column))
+                             FROM $table");
+        push(@statements, "ALTER TABLE $table ALTER COLUMN $column 
+                           SET DEFAULT nextval('${table}_${column}_seq')");
+    }
+
+    # If this column is no longer SERIAL, we need to drop the sequence
+    # that went along with it.
+    if ($old_def->{TYPE} =~ /serial/i && $new_def->{TYPE} !~ /serial/i) {
+        push(@statements, "ALTER TABLE $table ALTER COLUMN $column 
+                           DROP DEFAULT");
+        push(@statements, "ALTER SEQUENCE ${table}_${column}_seq 
+                           OWNED BY NONE");
+        push(@statements, "DROP SEQUENCE ${table}_${column}_seq");
+    }
+
+    return @statements;
+}
+
+1;

diff --git a/Bugzilla/DB/Schema/Sqlite.pm b/Bugzilla/DB/Schema/Sqlite.pm
new file mode 100644 (file)
index 0000000..4cfc2b0
--- /dev/null
+++ b/Bugzilla/DB/Schema/Sqlite.pm
@@ -0,0 +1,298 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+package Bugzilla::DB::Schema::Sqlite;
+use base qw(Bugzilla::DB::Schema);
+
+use Bugzilla::Error;
+use Bugzilla::Util qw(generate_random_password);
+
+use Storable qw(dclone);
+
+use constant FK_ON_CREATE => 1;
+
+sub _initialize {
+
+    my $self = shift;
+
+    $self = $self->SUPER::_initialize(@_);
+
+    $self->{db_specific} = {
+        BOOLEAN =>      'integer',
+        FALSE =>        '0', 
+        TRUE =>         '1',
+
+        INT1 =>         'integer',
+        INT2 =>         'integer',
+        INT3 =>         'integer',
+        INT4 =>         'integer',
+
+        SMALLSERIAL =>  'SERIAL',
+        MEDIUMSERIAL => 'SERIAL',
+        INTSERIAL =>    'SERIAL',
+
+        TINYTEXT =>     'text',
+        MEDIUMTEXT =>   'text',
+        LONGTEXT =>     'text',
+
+        LONGBLOB =>     'blob',
+
+        DATETIME =>     'DATETIME',
+    };
+
+    $self->_adjust_schema;
+
+    return $self;
+
+}
+
+#################################
+# General SQLite Schema Helpers #
+#################################
+
+sub _sqlite_create_table {
+    my ($self, $table) = @_;
+    return scalar Bugzilla->dbh->selectrow_array(
+        "SELECT sql FROM sqlite_master WHERE name = ? AND type = 'table'",
+        undef, $table);
+}
+
+sub _sqlite_table_lines {
+    my $self = shift;
+    my $table_sql = $self->_sqlite_create_table(@_);
+    $table_sql =~ s/\n*\)$//s;
+    # The $ makes this work even if people some day add crazy stuff to their
+    # schema like multi-column foreign keys.
+    return split(/,\s*$/m, $table_sql);
+}
+
+# This does most of the "heavy lifting" of the schema-altering functions.
+sub _sqlite_alter_schema {
+    my ($self, $table, $create_table, $options) = @_;
+    
+    # $create_table is sometimes an array in the form that _sqlite_table_lines
+    # returns.
+    if (ref $create_table) {
+        $create_table = join(',', @$create_table) . "\n)";
+    }
+    
+    my $dbh = Bugzilla->dbh;
+    
+    my $random = generate_random_password(5);
+    my $rename_to = "${table}_$random";
+
+    my @columns = $dbh->bz_table_columns_real($table);
+    push(@columns, $options->{extra_column}) if $options->{extra_column};
+    if (my $exclude = $options->{exclude_column}) {
+        @columns = grep { $_ ne $exclude } @columns;
+    }
+    my @insert_cols = @columns;
+    my @select_cols = @columns;
+    if (my $rename = $options->{rename}) {
+        foreach my $from (keys %$rename) {
+            my $to = $rename->{$from};
+            @insert_cols = map { $_ eq $from ? $to : $_ } @insert_cols;
+        }
+    }
+    
+    my $insert_str = join(',', @insert_cols);
+    my $select_str = join(',', @select_cols);
+    my $copy_sql = "INSERT INTO $table ($insert_str)"
+                   . " SELECT $select_str FROM $rename_to";
+                   
+    # We have to turn FKs off before doing this. Otherwise, when we rename
+    # the table, all of the FKs in the other tables will be automatically
+    # updated to point to the renamed table. Note that PRAGMA foreign_keys
+    # can only be set outside of a transaction--otherwise it is a no-op.
+    if ($dbh->bz_in_transaction) {
+        die "can't alter the schema inside of a transaction";
+    }
+    my @sql = (
+        'PRAGMA foreign_keys = OFF',
+        'BEGIN EXCLUSIVE TRANSACTION',
+        @{ $options->{pre_sql} || [] },
+        "ALTER TABLE $table RENAME TO $rename_to",
+        $create_table,
+        $copy_sql,
+        "DROP TABLE $rename_to",
+        'COMMIT TRANSACTION',
+        'PRAGMA foreign_keys = ON',
+    );    
+}
+
+# For finding a particular column's definition in a CREATE TABLE statement.
+sub _sqlite_column_regex {
+    my ($column) = @_;
+    # 1 = Comma at start
+    # 2 = Column name + Space
+    # 3 = Definition
+    # 4 = Ending comma
+    return qr/(^|,)(\s\Q$column\E\s+)(.*?)(,|$)/m;
+}
+
+#############################
+# Schema Setup & Alteration #
+#############################
+
+sub get_create_database_sql {
+    # If we get here, it means there was some error creating the
+    # database file during bz_create_database in Bugzilla::DB,
+    # and we just want to display that error instead of doing
+    # anything else.
+    Bugzilla->dbh;
+    die "Reached an unreachable point";
+}
+
+sub _get_create_table_ddl {
+    my $self = shift;
+    my ($table) = @_;
+    my $ddl = $self->SUPER::_get_create_table_ddl(@_);
+
+    # TheSchwartz uses its own driver to access its tables, meaning
+    # that it doesn't understand "COLLATE bugzilla" and in fact
+    # SQLite throws an error when TheSchwartz tries to access its
+    # own tables, if COLLATE bugzilla is on them. We don't have
+    # to fix this elsewhere currently, because we only create
+    # TheSchwartz's tables, we never modify them.
+    if ($table =~ /^ts_/) {
+        $ddl =~ s/ COLLATE bugzilla//g;
+    }
+    return $ddl;
+}
+
+sub get_type_ddl {
+    my $self = shift;
+    my $def = dclone($_[0]);
+    
+    my $ddl = $self->SUPER::get_type_ddl(@_);
+    if ($def->{PRIMARYKEY} and $def->{TYPE} =~ /SERIAL/i) {
+        $ddl =~ s/\bSERIAL\b/integer/;
+        $ddl =~ s/\bPRIMARY KEY\b/PRIMARY KEY AUTOINCREMENT/;
+    }
+    if ($def->{TYPE} =~ /text/i or $def->{TYPE} =~ /char/i) {
+        $ddl .= " COLLATE bugzilla";
+    }
+    # Don't collate DATETIME fields.
+    if ($def->{TYPE} eq 'DATETIME') {
+        $ddl =~ s/\bDATETIME\b/text COLLATE BINARY/;
+    }
+    return $ddl;
+}
+
+sub get_alter_column_ddl {
+    my $self = shift;
+    my ($table, $column, $new_def, $set_nulls_to) = @_;
+    my $dbh = Bugzilla->dbh;
+    
+    my $table_sql = $self->_sqlite_create_table($table);
+    my $new_ddl = $self->get_type_ddl($new_def);
+    # When we do ADD COLUMN, columns can show up all on one line separated
+    # by commas, so we have to account for that.
+    my $column_regex = _sqlite_column_regex($column);
+    $table_sql =~ s/$column_regex/$1$2$new_ddl$4/
+        || die "couldn't find $column in $table:\n$table_sql";
+    my @pre_sql = $self->_set_nulls_sql(@_);
+    return $self->_sqlite_alter_schema($table, $table_sql,
+                                       { pre_sql => \@pre_sql });
+}
+
+sub get_add_column_ddl {
+    my $self = shift;
+    my ($table, $column, $definition, $init_value) = @_;
+    # SQLite can use the normal ADD COLUMN when:
+    # * The column isn't a PK
+    if ($definition->{PRIMARYKEY}) {
+        if ($definition->{NOTNULL} and $definition->{TYPE} !~ /SERIAL/i) {
+            die "You can only add new SERIAL type PKs with SQLite";
+        }
+        my $table_sql = $self->_sqlite_new_column_sql(@_);
+        # This works because _sqlite_alter_schema will exclude the new column
+        # in its INSERT ... SELECT statement, meaning that when the "new"
+        # table is populated, it will have AUTOINCREMENT values generated
+        # for it.
+        return $self->_sqlite_alter_schema($table, $table_sql);
+    }
+    # * The column has a default one way or another. Either it
+    #   defaults to NULL (it lacks NOT NULL) or it has a DEFAULT
+    #   clause. Since we also require this when doing bz_add_column (in
+    #   the way of forcing an init_value for NOT NULL columns with no
+    #   default), we first set the init_value as the default and then
+    #   alter the column.
+    if ($definition->{NOTNULL} and !defined $definition->{DEFAULT}) {
+        my %with_default = %$definition;
+        $with_default{DEFAULT} = $init_value;
+        my @pre_sql =
+            $self->SUPER::get_add_column_ddl($table, $column, \%with_default);
+        my $table_sql = $self->_sqlite_new_column_sql(@_);
+        return $self->_sqlite_alter_schema($table, $table_sql,
+            { pre_sql => \@pre_sql, extra_column => $column });
+    }
+    
+    return $self->SUPER::get_add_column_ddl(@_);
+}
+
+sub _sqlite_new_column_sql {
+    my ($self, $table, $column, $def) = @_;
+    my $table_sql = $self->_sqlite_create_table($table);
+    my $new_ddl = $self->get_type_ddl($def);
+    my $new_line = "\t$column\t$new_ddl";
+    $table_sql =~ s/^(CREATE TABLE \w+ \()/$1\n$new_line,/s
+        || die "Can't find start of CREATE TABLE:\n$table_sql";
+    return $table_sql;
+}
+
+sub get_drop_column_ddl {
+    my ($self, $table, $column) = @_;
+    my $table_sql = $self->_sqlite_create_table($table);
+    my $column_regex = _sqlite_column_regex($column);
+    $table_sql =~ s/$column_regex/$1/
+        || die "Can't find column $column: $table_sql";
+    # Make sure we don't end up with a comma at the end of the definition.
+    $table_sql =~ s/,\s+\)$/\n)/s;
+    return $self->_sqlite_alter_schema($table, $table_sql,
+                                       { exclude_column => $column });
+}
+
+sub get_rename_column_ddl {
+    my ($self, $table, $old_name, $new_name) = @_;
+    my $table_sql = $self->_sqlite_create_table($table);
+    my $column_regex = _sqlite_column_regex($old_name);
+    $table_sql =~ s/$column_regex/$1\t$new_name\t$3$4/
+        || die "Can't find $old_name: $table_sql";
+    my %rename = ($old_name => $new_name);
+    return $self->_sqlite_alter_schema($table, $table_sql,
+                                       { rename => \%rename });
+}
+
+################
+# Foreign Keys #
+################
+
+sub get_add_fks_sql {
+    my ($self, $table, $column_fks) = @_;
+    my @clauses = $self->_sqlite_table_lines($table);
+    my @add = $self->_column_fks_to_ddl($table, $column_fks);
+    push(@clauses, @add);
+    return $self->_sqlite_alter_schema($table, \@clauses);
+}
+
+sub get_drop_fk_sql {
+    my ($self, $table, $column, $references) = @_;
+    my @clauses = $self->_sqlite_table_lines($table);
+    my $fk_name = $self->_get_fk_name($table, $column, $references);
+    
+    my $line_re = qr/^\s+CONSTRAINT $fk_name /s;
+    grep { $line_re } @clauses
+        or die "Can't find $fk_name: " . join(',', @clauses);
+    @clauses = grep { $_ !~ $line_re } @clauses;
+    
+    return $self->_sqlite_alter_schema($table, \@clauses);
+}
+
+
+1;

diff --git a/Bugzilla/DB/Sqlite.pm b/Bugzilla/DB/Sqlite.pm
new file mode 100644 (file)
index 0000000..e019740
--- /dev/null
+++ b/Bugzilla/DB/Sqlite.pm
@@ -0,0 +1,298 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+package Bugzilla::DB::Sqlite;
+use base qw(Bugzilla::DB);
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Install::Util qw(install_string);
+
+use DateTime;
+use POSIX ();
+
+# SQLite only supports the SERIALIZABLE and READ UNCOMMITTED isolation
+# levels. SERIALIZABLE is used by default and SET TRANSACTION ISOLATION
+# LEVEL is not implemented.
+use constant ISOLATION_LEVEL => undef;
+
+# Since we're literally using Perl's regexes, we can use something
+# simpler and more efficient than what Bugzilla::DB uses.
+use constant WORD_START => '(?:^|\W)';
+use constant WORD_END   => '(?:$|\W)';
+
+# For some reason, dropping the related FKs causes the index to
+# disappear early, which causes all sorts of problems.
+use constant INDEX_DROPS_REQUIRE_FK_DROPS => 0;
+
+####################################
+# Functions Added To SQLite Itself #
+####################################
+
+# A case-insensitive, Unicode collation for SQLite. This allows us to
+# make all comparisons and sorts case-insensitive (though unfortunately
+# not accent-insensitive).
+sub _sqlite_collate_ci { lc($_[0]) cmp lc($_[1]) }
+
+sub _sqlite_mod { $_[0] % $_[1] }
+
+sub _sqlite_now {
+    my $now = DateTime->now(time_zone => Bugzilla->local_timezone);
+    return $now->ymd . ' ' . $now->hms;
+}
+
+# SQL's POSITION starts its values from 1 instead of 0 (so we add 1).
+sub _sqlite_position {
+    my ($text, $fragment) = @_;
+    if (!defined $text or !defined $fragment) {
+        return undef;
+    }
+    my $pos = index $text, $fragment;
+    return $pos + 1;
+}
+
+sub _sqlite_position_ci {
+    my ($text, $fragment) = @_;
+    return _sqlite_position(lc($text), lc($fragment));
+}
+
+###############
+# Constructor #
+###############
+
+sub new {
+    my ($class, $params) = @_;
+    my $db_name = $params->{db_name};
+    
+    # Let people specify paths intead of data/ for the DB.
+    if ($db_name and $db_name !~ m{[\\/]}) {
+        # When the DB is first created, there's a chance that the
+        # data directory doesn't exist at all, because the Install::Filesystem
+        # code happens after DB creation. So we create the directory ourselves
+        # if it doesn't exist.
+        my $datadir = bz_locations()->{datadir};
+        if (!-d $datadir) {
+            mkdir $datadir or warn "$datadir: $!";
+        }
+        if (!-d "$datadir/db/") {
+            mkdir "$datadir/db/" or warn "$datadir/db: $!";
+        }
+        $db_name = bz_locations()->{datadir} . "/db/$db_name";
+    }
+
+    # construct the DSN from the parameters we got
+    my $dsn = "dbi:SQLite:dbname=$db_name";
+
+    my $attrs = {
+        # XXX Should we just enforce this to be always on?
+        sqlite_unicode => Bugzilla->params->{'utf8'},
+    };
+
+    my $self = $class->db_new({ dsn => $dsn, user => '', 
+                                pass => '', attrs => $attrs });
+    # Needed by TheSchwartz
+    $self->{private_bz_dsn} = $dsn;
+    
+    my %pragmas = (
+        # Make sure that the sqlite file doesn't grow without bound.
+        auto_vacuum => 1,
+        encoding => "'UTF-8'",
+        foreign_keys => 'ON',
+        # We want the latest file format.
+        legacy_file_format => 'OFF',
+        # This guarantees that we get column names like "foo"
+        # instead of "table.foo" in selectrow_hashref.
+        short_column_names => 'ON',
+        # The write-ahead log mode in SQLite 3.7 gets us better concurrency,
+        # but breaks backwards-compatibility with older versions of
+        # SQLite. (Which is important because people may also want to use
+        # command-line clients to access and back up their DB.) If you need
+        # better concurrency and don't need 3.6 compatibility, then you can
+        # uncomment this line.
+        #journal_mode => "'WAL'",
+    );
+    
+    while (my ($name, $value) = each %pragmas) {
+        $self->do("PRAGMA $name = $value");
+    }
+    
+    $self->sqlite_create_collation('bugzilla', \&_sqlite_collate_ci);
+    $self->sqlite_create_function('position', 2, \&_sqlite_position);
+    $self->sqlite_create_function('iposition', 2, \&_sqlite_position_ci);
+    # SQLite has a "substr" function, but other DBs call it "SUBSTRING"
+    # so that's what we use, and I don't know of any way in SQLite to
+    # alias the SQL "substr" function to be called "SUBSTRING".
+    $self->sqlite_create_function('substring', 3, \&CORE::substr);
+    $self->sqlite_create_function('char_length', 1, sub { length($_[0]) });
+    $self->sqlite_create_function('mod', 2, \&_sqlite_mod);
+    $self->sqlite_create_function('now', 0, \&_sqlite_now);
+    $self->sqlite_create_function('localtimestamp', 1, \&_sqlite_now);
+    $self->sqlite_create_function('floor', 1, \&POSIX::floor);
+
+    bless ($self, $class);
+    return $self;
+}
+
+###############
+# SQL Methods #
+###############
+
+sub sql_position {
+    my ($self, $fragment, $text) = @_;
+    return "POSITION($text, $fragment)";
+}
+
+sub sql_iposition {
+    my ($self, $fragment, $text) = @_;
+    return "IPOSITION($text, $fragment)";
+}
+
+# SQLite does not have to GROUP BY the optional columns.
+sub sql_group_by {
+    my ($self, $needed_columns, $optional_columns) = @_;
+    my $expression = "GROUP BY $needed_columns";
+    return $expression;
+}
+
+# XXX SQLite does not support sorting a GROUP_CONCAT, so $sort is unimplemented.
+sub sql_group_concat {
+    my ($self, $column, $separator, $sort) = @_;
+    $separator = $self->quote(', ') if !defined $separator;
+    # In SQLite, a GROUP_CONCAT call with a DISTINCT argument can't
+    # specify its separator, and has to accept the default of ",".
+    if ($column =~ /^DISTINCT/) {
+        return "GROUP_CONCAT($column)";
+    }
+    return "GROUP_CONCAT($column, $separator)";
+}
+
+sub sql_istring {
+    my ($self, $string) = @_;
+    return $string;
+}
+
+sub sql_regexp {
+    my ($self, $expr, $pattern, $nocheck, $real_pattern) = @_;
+    $real_pattern ||= $pattern;
+
+    $self->bz_check_regexp($real_pattern) if !$nocheck;
+
+    return "$expr REGEXP $pattern";
+}
+
+sub sql_not_regexp {
+    my $self = shift;
+    my $re_expression = $self->sql_regexp(@_);
+    return "NOT($re_expression)";
+}
+
+sub sql_limit {
+    my ($self, $limit, $offset) = @_;
+
+    if (defined($offset)) {
+        return "LIMIT $limit OFFSET $offset";
+    } else {
+        return "LIMIT $limit";
+    }
+}
+
+sub sql_from_days {
+    my ($self, $days) = @_;
+    return "DATETIME($days)";
+}
+
+sub sql_to_days {
+    my ($self, $date) = @_;
+    return "JULIANDAY($date)";
+}
+
+sub sql_date_format {
+    my ($self, $date, $format) = @_;
+    $format = "%Y.%m.%d %H:%M:%s" if !$format;
+    $format =~ s/\%i/\%M/g;
+    return "STRFTIME(" . $self->quote($format) . ", $date)";
+}
+
+sub sql_date_math {
+    my ($self, $date, $operator, $interval, $units) = @_;
+    # We do the || thing (concatenation) so that placeholders work properly.
+    return "DATETIME($date, '$operator' || $interval || ' $units')";
+}
+
+###############
+# bz_ methods #
+###############
+
+sub bz_setup_database {
+    my $self = shift;
+    $self->SUPER::bz_setup_database(@_);
+
+    # If we created TheSchwartz tables with COLLATE bugzilla (during the
+    # 4.1.x development series) re-create them without it.
+    my @tables = $self->bz_table_list();
+    my @ts_tables = grep { /^ts_/ } @tables;
+    my $drop_ok;
+    foreach my $table (@ts_tables) {
+        my $create_table =
+            $self->_bz_real_schema->_sqlite_create_table($table);
+        if ($create_table =~ /COLLATE bugzilla/) {
+            if (!$drop_ok) {
+                _sqlite_jobqueue_drop_message();
+                $drop_ok = 1;
+            }
+            $self->bz_drop_table($table);
+            $self->bz_add_table($table);
+        }
+    }
+}
+
+sub _sqlite_jobqueue_drop_message {
+    # This is not translated because this situation will only happen if
+    # you are updating from a 4.1.x development version of Bugzilla using
+    # SQLite, and we don't want to maintain this string in strings.txt.pl
+    # forever for just this one uncommon circumstance.
+    print <<END;
+WARNING: We have to re-create all the database tables used by jobqueue.pl.
+If there are any pending jobs in the database (that is, emails that
+haven't been sent), they will be deleted.
+
+END
+    unless (Bugzilla->installation_answers->{NO_PAUSE}) {
+        print install_string('enter_or_ctrl_c');
+        getc;
+    }
+}
+
+# XXX This needs to be implemented.
+sub bz_explain { }
+
+sub bz_table_list_real {
+    my $self = shift;
+    my @tables = $self->SUPER::bz_table_list_real(@_);
+    # SQLite includes a sqlite_sequence table in every database that isn't
+    # one of our real tables. We exclude any table that starts with sqlite_,
+    # just to be safe.
+    @tables = grep { $_ !~ /^sqlite_/ } @tables;
+    return @tables;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::DB::Sqlite - Bugzilla database compatibility layer for SQLite
+
+=head1 DESCRIPTION
+
+This module overrides methods of the Bugzilla::DB module with a
+SQLite-specific implementation. It is instantiated by the Bugzilla::DB module
+and should never be used directly.
+
+For interface details see L<Bugzilla::DB> and L<DBI>.

diff --git a/Bugzilla/Error.pm b/Bugzilla/Error.pm
new file mode 100644 (file)
index 0000000..e1df5dd
--- /dev/null
+++ b/Bugzilla/Error.pm
@@ -0,0 +1,265 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Error;
+
+use strict;
+use base qw(Exporter);
+
+@Bugzilla::Error::EXPORT = qw(ThrowCodeError ThrowTemplateError ThrowUserError);
+
+use Bugzilla::Constants;
+use Bugzilla::WebService::Constants;
+use Bugzilla::Hook;
+
+use Carp;
+use Data::Dumper;
+use Date::Format;
+
+# We cannot use $^S to detect if we are in an eval(), because mod_perl
+# already eval'uates everything, so $^S = 1 in all cases under mod_perl!
+sub _in_eval {
+    my $in_eval = 0;
+    for (my $stack = 1; my $sub = (caller($stack))[3]; $stack++) {
+        last if $sub =~ /^ModPerl/;
+        $in_eval = 1 if $sub =~ /^\(eval\)/;
+    }
+    return $in_eval;
+}
+
+sub _throw_error {
+    my ($name, $error, $vars) = @_;
+    my $dbh = Bugzilla->dbh;
+    $vars ||= {};
+
+    $vars->{error} = $error;
+
+    # Make sure any transaction is rolled back (if supported).
+    # If we are within an eval(), do not roll back transactions as we are
+    # eval'uating some test on purpose.
+    $dbh->bz_rollback_transaction() if ($dbh->bz_in_transaction() && !_in_eval());
+
+    my $datadir = bz_locations()->{'datadir'};
+    # If a writable $datadir/errorlog exists, log error details there.
+    if (-w "$datadir/errorlog") {
+        require Bugzilla::Util;
+        require Data::Dumper;
+        my $mesg = "";
+        for (1..75) { $mesg .= "-"; };
+        $mesg .= "\n[$$] " . time2str("%D %H:%M:%S ", time());
+        $mesg .= "$name $error ";
+        $mesg .= Bugzilla::Util::remote_ip();
+        $mesg .= Bugzilla->user->login;
+        $mesg .= (' actually ' . Bugzilla->sudoer->login) if Bugzilla->sudoer;
+        $mesg .= "\n";
+        my %params = Bugzilla->cgi->Vars;
+        $Data::Dumper::Useqq = 1;
+        for my $param (sort keys %params) {
+            my $val = $params{$param};
+            # obscure passwords
+            $val = "*****" if $param =~ /password/i;
+            # limit line length
+            $val =~ s/^(.{512}).*$/$1\[CHOP\]/;
+            $mesg .= "[$$] " . Data::Dumper->Dump([$val],["param($param)"]);
+        }
+        for my $var (sort keys %ENV) {
+            my $val = $ENV{$var};
+            $val = "*****" if $val =~ /password|http_pass/i;
+            $mesg .= "[$$] " . Data::Dumper->Dump([$val],["env($var)"]);
+        }
+        open(ERRORLOGFID, ">>$datadir/errorlog");
+        print ERRORLOGFID "$mesg\n";
+        close ERRORLOGFID;
+    }
+
+    my $template = Bugzilla->template;
+    my $message;
+    # There are some tests that throw and catch a lot of errors,
+    # and calling $template->process over and over for those errors
+    # is too slow. So instead, we just "die" with a dump of the arguments.
+    if (Bugzilla->error_mode != ERROR_MODE_TEST) {
+        $template->process($name, $vars, \$message)
+          || ThrowTemplateError($template->error());
+    }
+
+    # Let's call the hook first, so that extensions can override
+    # or extend the default behavior, or add their own error codes.
+    Bugzilla::Hook::process('error_catch', { error => $error, vars => $vars,
+                                             message => \$message });
+
+    if (Bugzilla->error_mode == ERROR_MODE_WEBPAGE) {
+        print Bugzilla->cgi->header();
+        print $message;
+    }
+    elsif (Bugzilla->error_mode == ERROR_MODE_TEST) {
+        die Dumper($vars);
+    }
+    elsif (Bugzilla->error_mode == ERROR_MODE_DIE) {
+        die("$message\n");
+    }
+    elsif (Bugzilla->error_mode == ERROR_MODE_DIE_SOAP_FAULT
+           || Bugzilla->error_mode == ERROR_MODE_JSON_RPC)
+    {
+        # Clone the hash so we aren't modifying the constant.
+        my %error_map = %{ WS_ERROR_CODE() };
+        Bugzilla::Hook::process('webservice_error_codes',
+                                { error_map => \%error_map });
+        my $code = $error_map{$error};
+        if (!$code) {
+            $code = ERROR_UNKNOWN_FATAL if $name =~ /code/i;
+            $code = ERROR_UNKNOWN_TRANSIENT if $name =~ /user/i;
+        }
+
+        if (Bugzilla->error_mode == ERROR_MODE_DIE_SOAP_FAULT) {
+            die SOAP::Fault->faultcode($code)->faultstring($message);
+        }
+        else {
+            my $server = Bugzilla->_json_server;
+            # Technically JSON-RPC isn't allowed to have error numbers
+            # higher than 999, but we do this to avoid conflicts with
+            # the internal JSON::RPC error codes.
+            $server->raise_error(code    => 100000 + $code,
+                                 message => $message,
+                                 id      => $server->{_bz_request_id},
+                                 version => $server->version);
+            # Most JSON-RPC Throw*Error calls happen within an eval inside
+            # of JSON::RPC. So, in that circumstance, instead of exiting,
+            # we die with no message. JSON::RPC checks raise_error before
+            # it checks $@, so it returns the proper error.
+            die if _in_eval();
+            $server->response($server->error_response_header);
+        }
+    }
+    exit;
+}
+
+sub ThrowUserError {
+    _throw_error("global/user-error.html.tmpl", @_);
+}
+
+sub ThrowCodeError {
+    my (undef, $vars) = @_;
+
+    # Don't show function arguments, in case they contain
+    # confidential data.
+    local $Carp::MaxArgNums = -1;
+    # Don't show the error as coming from Bugzilla::Error, show it
+    # as coming from the caller.
+    local $Carp::CarpInternal{'Bugzilla::Error'} = 1;
+    $vars->{traceback} = Carp::longmess();
+
+    _throw_error("global/code-error.html.tmpl", @_);
+}
+
+sub ThrowTemplateError {
+    my ($template_err) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    # Make sure the transaction is rolled back (if supported).
+    $dbh->bz_rollback_transaction() if $dbh->bz_in_transaction();
+
+    my $vars = {};
+    if (Bugzilla->error_mode == ERROR_MODE_DIE) {
+        die("error: template error: $template_err");
+    }
+
+    $vars->{'template_error_msg'} = $template_err;
+    $vars->{'error'} = "template_error";
+
+    my $template = Bugzilla->template;
+
+    # Try a template first; but if this one fails too, fall back
+    # on plain old print statements.
+    if (!$template->process("global/code-error.html.tmpl", $vars)) {
+        require Bugzilla::Util;
+        import Bugzilla::Util qw(html_quote);
+        my $maintainer = Bugzilla->params->{'maintainer'};
+        my $error = html_quote($vars->{'template_error_msg'});
+        my $error2 = html_quote($template->error());
+        print <<END;
+        <tt>
+          <p>
+            Bugzilla has suffered an internal error. Please save this page and 
+            send it to $maintainer with details of what you were doing at the 
+            time this message appeared.
+          </p>
+          <script type="text/javascript"> <!--
+          document.write("<p>URL: " + 
+                          document.location.href.replace(/&/g,"&amp;")
+                                                .replace(/</g,"&lt;")
+                                                .replace(/>/g,"&gt;") + "</p>");
+          // -->
+          </script>
+          <p>Template->process() failed twice.<br>
+          First error: $error<br>
+          Second error: $error2</p>
+        </tt>
+END
+    }
+    exit;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Error - Error handling utilities for Bugzilla
+
+=head1 SYNOPSIS
+
+  use Bugzilla::Error;
+
+  ThrowUserError("error_tag",
+                 { foo => 'bar' });
+
+=head1 DESCRIPTION
+
+Various places throughout the Bugzilla codebase need to report errors to the
+user. The C<Throw*Error> family of functions allow this to be done in a
+generic and localizable manner.
+
+These functions automatically unlock the database tables, if there were any
+locked. They will also roll back the transaction, if it is supported by
+the underlying DB.
+
+=head1 FUNCTIONS
+
+=over 4
+
+=item C<ThrowUserError>
+
+This function takes an error tag as the first argument, and an optional hashref
+of variables as a second argument. These are used by the
+I<global/user-error.html.tmpl> template to format the error, using the passed
+in variables as required.
+
+=item C<ThrowCodeError>
+
+This function is used when an internal check detects an error of some sort.
+This usually indicates a bug in Bugzilla, although it can occur if the user
+manually constructs urls without correct parameters.
+
+This function's behaviour is similar to C<ThrowUserError>, except that the
+template used to display errors is I<global/code-error.html.tmpl>. In addition
+if the hashref used as the optional second argument contains a key I<variables>
+then the contents of the hashref (which is expected to be another hashref) will
+be displayed after the error message, as a debugging aid.
+
+=item C<ThrowTemplateError>
+
+This function should only be called if a C<template-<gt>process()> fails.
+It tries another template first, because often one template being
+broken or missing doesn't mean that they all are. But it falls back to
+a print statement as a last-ditch error.
+
+=back
+
+=head1 SEE ALSO
+
+L<Bugzilla|Bugzilla>

diff --git a/Bugzilla/Extension.pm b/Bugzilla/Extension.pm
new file mode 100644 (file)
index 0000000..49422ec
--- /dev/null
+++ b/Bugzilla/Extension.pm
@@ -0,0 +1,809 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension;
+use strict;
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Install::Util qw(
+    extension_code_files extension_template_directory 
+    extension_package_directory extension_web_directory);
+
+use File::Basename;
+use File::Spec;
+
+####################
+# Subclass Methods #
+####################
+
+sub new {
+    my ($class, $params) = @_;
+    $params ||= {};
+    bless $params, $class;
+    return $params;
+}
+
+#######################################
+# Class (Bugzilla::Extension) Methods #
+#######################################
+
+sub load {
+    my ($class, $extension_file, $config_file) = @_;
+    my $package;
+
+    # This is needed during checksetup.pl, because Extension packages can 
+    # only be loaded once (they return "1" the second time they're loaded,
+    # instead of their name). During checksetup.pl, extensions are loaded
+    # once by Bugzilla::Install::Requirements, and then later again via
+    # Bugzilla->extensions (because of hooks).
+    my $map = Bugzilla->request_cache->{extension_requirement_package_map};
+
+    if ($config_file) {
+        if ($map and defined $map->{$config_file}) {
+            $package = $map->{$config_file};
+        }
+        else {
+            my $name = require $config_file;
+            if ($name =~ /^\d+$/) {
+                ThrowCodeError('extension_must_return_name',
+                               { extension => $config_file, 
+                                 returned  => $name });
+            }
+            $package = "${class}::$name";
+        }
+
+        __do_call($package, 'modify_inc', $config_file);
+    }
+
+    if ($map and defined $map->{$extension_file}) {
+        $package = $map->{$extension_file};
+        $package->modify_inc($extension_file) if !$config_file;
+    }
+    else {
+        my $name = require $extension_file;
+        if ($name =~ /^\d+$/) {
+            ThrowCodeError('extension_must_return_name', 
+                           { extension => $extension_file, returned => $name });
+        }
+        $package = "${class}::$name";
+        $package->modify_inc($extension_file) if !$config_file;
+    }
+
+    $class->_validate_package($package, $extension_file);
+    return $package;
+}
+
+sub _validate_package {
+    my ($class, $package, $extension_file) = @_;
+
+    # For extensions from data/extensions/additional, we don't have a file
+    # name, so we fake it.
+    if (!$extension_file) {
+        $extension_file = $package;
+        $extension_file =~ s/::/\//g;
+        $extension_file .= '.pm';
+    }
+
+    if (!eval { $package->NAME }) {
+        ThrowCodeError('extension_no_name', 
+                       { filename => $extension_file, package => $package });
+    }
+
+    if (!$package->isa($class)) {
+        ThrowCodeError('extension_must_be_subclass',
+                       { filename => $extension_file,
+                         package  => $package,
+                         class    => $class });
+    }
+}
+
+sub load_all {
+    my $class = shift;
+    my ($file_sets, $extra_packages) = extension_code_files();
+    my @packages;
+    foreach my $file_set (@$file_sets) {
+        my $package = $class->load(@$file_set);
+        push(@packages, $package);
+    }
+
+    # Extensions from data/extensions/additional
+    foreach my $package (@$extra_packages) {
+        # Don't load an "additional" extension if we already have an extension
+        # loaded with that name.
+        next if grep($_ eq $package, @packages);
+        # Untaint the package name
+        $package =~ /([\w:]+)/;
+        $package = $1;
+        eval("require $package") || die $@;
+        $package->_validate_package($package);
+        push(@packages, $package);
+    }
+
+    return \@packages;
+}
+
+# Modifies @INC so that extensions can use modules like
+# "use Bugzilla::Extension::Foo::Bar", when Bar.pm is in the lib/
+# directory of the extension.
+sub modify_inc {
+    my ($class, $file) = @_;
+
+    # Note that this package_dir call is necessary to set things up
+    # for my_inc, even if we didn't take its return value.
+    my $package_dir = __do_call($class, 'package_dir', $file);
+    # Don't modify @INC for extensions that are just files in the extensions/
+    # directory. We don't want Bugzilla's base lib/CGI.pm being loaded as 
+    # Bugzilla::Extension::Foo::CGI or any other confusing thing like that.
+    return if $package_dir eq bz_locations->{'extensionsdir'};
+    unshift(@INC, sub { __do_call($class, 'my_inc', @_) });
+}
+
+# This is what gets put into @INC by modify_inc.
+sub my_inc {
+    my ($class, undef, $file) = @_;
+    
+    # This avoids infinite recursion in case anything inside of this function
+    # does a "require". (I know for sure that File::Spec->case_tolerant does
+    # a "require" on Windows, for example.)
+    return if $file !~ /^Bugzilla/;
+
+    my $lib_dir = __do_call($class, 'lib_dir');
+    my @class_parts = split('::', $class);
+    my ($vol, $dir, $file_name) = File::Spec->splitpath($file);
+    my @dir_parts = File::Spec->splitdir($dir);
+    # File::Spec::Win32 (any maybe other OSes) add an empty directory at the
+    # end of @dir_parts.
+    @dir_parts = grep { $_ ne '' } @dir_parts;
+    # Validate that this is a sub-package of Bugzilla::Extension::Foo ($class).
+    for (my $i = 0; $i < scalar(@class_parts); $i++) {
+        return if !@dir_parts;
+        if (File::Spec->case_tolerant) {
+            return if lc($class_parts[$i]) ne lc($dir_parts[0]);
+        }
+        else {
+            return if $class_parts[$i] ne $dir_parts[0];
+        }
+        shift(@dir_parts);
+    }
+    # For Bugzilla::Extension::Foo::Bar, this would look something like
+    # extensions/Example/lib/Bar.pm
+    my $resolved_path = File::Spec->catfile($lib_dir, @dir_parts, $file_name);
+    open(my $fh, '<', $resolved_path);
+    return $fh;
+}
+
+####################
+# Instance Methods #
+####################
+
+use constant enabled => 1;
+
+sub lib_dir {
+    my $invocant = shift;
+    my $package_dir = __do_call($invocant, 'package_dir');
+    # For extensions that are just files in the extensions/ directory,
+    # use the base lib/ dir as our "lib_dir". Note that Bugzilla never
+    # uses lib_dir in this case, though, because modify_inc is prevented
+    # from modifying @INC when we're just a file in the extensions/ directory.
+    # So this particular code block exists just to make lib_dir return
+    # something right in case an extension needs it for some odd reason.
+    if ($package_dir eq bz_locations()->{'extensionsdir'}) {
+        return bz_locations->{'ext_libpath'};
+    }
+    return File::Spec->catdir($package_dir, 'lib');
+}
+
+sub template_dir { return extension_template_directory(@_); }
+sub package_dir  { return extension_package_directory(@_);  }
+sub web_dir      { return extension_web_directory(@_);      }
+
+######################
+# Helper Subroutines #
+######################
+
+# In order to not conflict with extensions' private subroutines, any helpers
+# here should start with a double underscore.
+
+# This is for methods that can optionally be overridden in Config.pm.
+# It falls back to the local implementation if $class cannot do
+# the method. This is necessary because Config.pm is not a subclass of
+# Bugzilla::Extension.
+sub __do_call {
+    my ($class, $method, @args) = @_;
+    if ($class->can($method)) {
+        return $class->$method(@args);
+    }
+    my $function_ref;
+    { no strict 'refs'; $function_ref = \&{$method}; }
+    return $function_ref->($class, @args);
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Extension - Base class for Bugzilla Extensions.
+
+=head1 SYNOPSIS
+
+The following would be in F<extensions/Foo/Extension.pm> or 
+F<extensions/Foo.pm>:
+
+ package Bugzilla::Extension::Foo
+ use strict;
+ use base qw(Bugzilla::Extension);
+
+ our $VERSION = '0.02';
+ use constant NAME => 'Foo';
+
+ sub some_hook_name { ... }
+
+ __PACKAGE__->NAME;
+
+Custom templates would go into F<extensions/Foo/template/en/default/>.
+L<Template hooks|/Template Hooks> would go into 
+F<extensions/Foo/template/en/default/hook/>.
+
+=head1 DESCRIPTION
+
+This is the base class for all Bugzilla extensions.
+
+=head1 WRITING EXTENSIONS
+
+The L</SYNOPSIS> above gives a pretty good overview of what's basically
+required to write an extension. This section gives more information
+on exactly how extensions work and how you write them. There is also a 
+L<wiki page|https://wiki.mozilla.org/Bugzilla:Extension_Notes> with additional HOWTOs, tips and tricks.
+
+=head2 Using F<extensions/create.pl>
+
+There is a script, L<extensions::create>, that will set up the framework
+of a new extension for you. To use it, pick a name for your extension
+and, in the base bugzilla directory, do:
+
+C<extensions/create.pl NAME>
+
+But replace C<NAME> with the name you picked for your extension. That
+will create a new directory in the F<extensions/> directory with the name
+of your extension. The directory will contain a full framework for
+a new extension, with helpful comments in each file describing things
+about them.
+
+=head2 Example Extension
+
+There is a sample extension in F<extensions/Example/> that demonstrates
+most of the things described in this document, so if you find the
+documentation confusing, try just reading the code instead.
+
+=head2 Where Extension Code Goes
+
+Extension code lives under the F<extensions/> directory in Bugzilla.
+
+There are two ways to write extensions:
+
+=over
+
+=item 1
+
+If your extension will have only code and no templates or other files,
+you can create a simple C<.pm> file in the F<extensions/> directory. 
+
+For example, if you wanted to create an extension called "Foo" using this
+method, you would put your code into a file called F<extensions/Foo.pm>.
+
+=item 2
+
+If you plan for your extension to have templates and other files, you
+can create a whole directory for your extension, and the main extension
+code would go into a file called F<Extension.pm> in that directory.
+
+For example, if you wanted to create an extension called "Foo" using this
+method, you would put your code into a file called
+F<extensions/Foo/Extension.pm>.
+
+=back
+
+=head2 The Extension C<NAME>.
+
+The "name" of an extension shows up in several places:
+
+=over
+
+=item 1
+
+The name of the package:
+
+C<package Bugzilla::Extension::Foo;>
+
+=item 2
+
+In a C<NAME> constant that B<must> be defined for every extension:
+
+C<< use constant NAME => 'Foo'; >>
+
+=item 3
+
+At the very end of the file:
+
+C<< __PACKAGE__->NAME; >>
+
+You'll notice that though most Perl packages end with C<1;>, Bugzilla
+Extensions must B<always> end with C<< __PACKAGE__->NAME; >>.
+
+=back
+
+The name must be identical in all of those locations.
+
+=head2 Hooks
+
+In L<Bugzilla::Hook>, there is a L<list of hooks|Bugzilla::Hook/HOOKS>.
+These are the various areas of Bugzilla that an extension can "hook" into,
+which allow your extension to perform code during that point in Bugzilla's
+execution.
+
+If your extension wants to implement a hook, all you have to do is
+write a subroutine in your hook package that has the same name as
+the hook. The subroutine will be called as a method on your extension,
+and it will get the arguments specified in the hook's documentation as
+named parameters in a hashref.
+
+For example, here's an implementation of a hook named C<foo_start>
+that gets an argument named C<bar>:
+
+ sub foo_start {
+     my ($self, $args) = @_;
+     my $bar = $args->{bar};
+     print "I got $bar!\n";
+ }
+
+And that would go into your extension's code file--the file that was
+described in the L</Where Extension Code Goes> section above.
+
+During your subroutine, you may want to know what values were passed
+as CGI arguments  to the current script, or what arguments were passed to
+the current WebService method. You can get that data via 
+L<Bugzilla/input_params>.
+
+=head3 Adding New Hooks To Bugzilla
+
+If you need a new hook for your extension and you want that hook to be
+added to Bugzilla itself, see our development process at 
+L<http://wiki.mozilla.org/Bugzilla:Developers>.
+
+In order for a new hook to be accepted into Bugzilla, it has to work,
+it must have documentation in L<Bugzilla::Hook>, and it must have example
+code in F<extensions/Example/Extension.pm>.
+
+One question that is often asked about new hooks is, "Is this the most
+flexible way to implement this hook?" That is, the more power extension
+authors get from a hook, the more likely it is to be accepted into Bugzilla.
+Hooks that only hook a very specific part of Bugzilla will not be accepted
+if their functionality can be accomplished equally well with a more generic
+hook.
+
+=head2 If Your Extension Requires Certain Perl Modules
+
+If there are certain Perl modules that your extension requires in order
+to run, there is a way you can tell Bugzilla this, and then L<checksetup>
+will make sure that those modules are installed, when you run L<checksetup>.
+
+To do this, you need to specify a constant called C<REQUIRED_MODULES>
+in your extension. This constant has the same format as
+L<Bugzilla::Install::Requirements/REQUIRED_MODULES>.
+
+If there are optional modules that add additional functionality to your
+application, you can specify them in a constant called OPTIONAL_MODULES,
+which has the same format as 
+L<Bugzilla::Install::Requirements/OPTIONAL_MODULES>.
+
+=head3 If Your Extension Needs Certain Modules In Order To Compile
+
+If your extension needs a particular Perl module in order to
+I<compile>, then you have a "chicken and egg" problem--in order to
+read C<REQUIRED_MODULES>, we have to compile your extension. In order
+to compile your extension, we need to already have the modules in
+C<REQUIRED_MODULES>!
+
+To get around this problem, Bugzilla allows you to have an additional
+file, besides F<Extension.pm>, called F<Config.pm>, that contains
+just C<REQUIRED_MODULES>. If you have a F<Config.pm>, it must also
+contain the C<NAME> constant, instead of your main F<Extension.pm>
+containing the C<NAME> constant.
+
+The contents of the file would look something like this for an extension
+named C<Foo>:
+
+  package Bugzilla::Extension::Foo;
+  use strict;
+  use constant NAME => 'Foo';
+  use constant REQUIRED_MODULES => [
+    {
+      package => 'Some-Package',
+      module  => 'Some::Module',
+      version => 0,
+    }
+  ];
+  __PACKAGE__->NAME;
+
+Note that it is I<not> a subclass of C<Bugzilla::Extension>, because
+at the time that module requirements are being checked in L<checksetup>,
+C<Bugzilla::Extension> cannot be loaded. Also, just like F<Extension.pm>,
+it ends with C<< __PACKAGE__->NAME; >>. Note also that it has the 
+B<exact same> C<package> name as F<Extension.pm>.
+
+This file may not use any Perl modules other than L<Bugzilla::Constants>,
+L<Bugzilla::Install::Util>, L<Bugzilla::Install::Requirements>, and 
+modules that ship with Perl itself.
+
+If you want to define both C<REQUIRED_MODULES> and C<OPTIONAL_MODULES>,
+they must both be in F<Config.pm> or both in F<Extension.pm>.
+
+Every time your extension is loaded by Bugzilla, F<Config.pm> will be
+read and then F<Extension.pm> will be read, so your methods in F<Extension.pm>
+will have access to everything in F<Config.pm>. Don't define anything
+with an identical name in both files, or Perl may throw a warning that
+you are redefining things.
+
+This method of setting C<REQUIRED_MODULES> is of course not available if 
+your extension is a single file named C<Foo.pm>.
+
+If any of this is confusing, just look at the code of the Example extension.
+It uses this method to specify requirements.
+
+=head2 Libraries
+
+Extensions often want to have their own Perl modules. Your extension
+can load any Perl module in its F<lib/> directory. (So, if your extension is 
+F<extensions/Foo/>, then your Perl modules go into F<extensions/Foo/lib/>.)
+
+However, the C<package> name of your libraries will not work quite
+like normal Perl modules do. F<extensions/Foo/lib/Bar.pm> is
+loaded as C<Bugzilla::Extension::Foo::Bar>. Or, to say it another way,
+C<use Bugzilla::Extension::Foo::Bar;> loads F<extensions/Foo/lib/Bar.pm>,
+which should have C<package Bugzilla::Extension::Foo::Bar;> as its package
+name.
+
+This allows any place in Bugzilla to load your modules, which is important
+for some hooks. It even allows other extensions to load your modules, and 
+allows you to install your modules into the global Perl install
+as F<Bugzilla/Extension/Foo/Bar.pm>, if you'd like, which helps allow CPAN
+distribution of Bugzilla extensions.
+
+B<Note:> If you want to C<use> or C<require> a module that's in 
+F<extensions/Foo/lib/> at the top level of your F<Extension.pm>,
+you must have a F<Config.pm> (see above) with at least the C<NAME>
+constant defined in it.
+
+=head2 Templates
+
+Extensions store templates in a C<template> subdirectory of the extension.
+(Obviously, this isn't available for extensions that aren't a directory.)
+
+The format of this directory is exactly like the normal layout of Bugzilla's
+C<template> directory--in fact, your extension's C<template> directory
+becomes part of Bugzilla's template "search path" as described in
+L<Bugzilla::Install::Util/template_include_path>.
+
+You can actually include templates in your extension without having any
+C<.pm> files in your extension at all, if you want. (That is, it's entirely
+valid to have an extension that's just template files and no code files.)
+
+Bugzilla's templates are written in a language called Template Toolkit.
+You can find out more about Template Toolkit at L<http://template-toolkit.org>.
+
+There are two ways to extend or modify Bugzilla's templates: you can use
+template hooks (described below) or you can override existing templates
+entirely (described further down).
+
+=head2 Template Hooks
+
+Templates can be extended using a system of "hooks" that add new UI elements
+to a particular area of Bugzilla without modifying the code of the existing
+templates. This is the recommended way for extensions to modify the user
+interface of Bugzilla.
+
+=head3 Which Templates Can Be Hooked
+
+There is no list of template hooks like there is for standard code hooks.
+To find what places in the user interface can be hooked, search for the 
+string C<Hook.process> in Bugzilla's templates (in the 
+F<template/en/default/> directory). That will also give you the name of 
+the hooks--the first argument to C<Hook.process> is the name of the hook.
+(A later section in this document explains how to use that name).
+
+For example, if you see C<Hook.process("additional_header")>, that means 
+the name of the hook is C<additional_header>.
+
+=head3 Where Template Hooks Go
+
+To extend templates in your extension using template hooks, you put files into
+the F<template/en/default/hook> directory of your extension. So, if you had an
+extension called "Foo", your template extensions would go into
+F<extensions/Foo/template/en/default/hook/>.
+
+(Note that the base F<template/en/default/hook> directory in Bugzilla itself
+also works, although you would never use that for an extension that you
+intended to distribute.)
+
+The files that go into this directory have a certain name, based on the
+name of the template that is being hooked, and the name of the hook.
+For example, let's imagine that you have an extension named "Foo",
+and you want to use the C<additional_header> hook in 
+F<template/en/default/global/header.html.tmpl>. Your code would go into
+F<extensions/Foo/template/en/default/hook/global/header-additional_header.html.tmpl>. Any code you put into that file will happen at the point that 
+C<Hook.process("additional_header")> is called in 
+F<template/en/default/global/header.html.tmpl>.
+
+As you can see, template extension file names follow a pattern. The
+pattern looks like:
+
+ <templates>/hook/<template path>/<template name>-<hook name>.<template type>.tmpl
+
+=over
+
+=item <templates>
+
+This is the full path to the template directory, like 
+F<extensions/Foo/template/en/default>. This works much like normal templates
+do, in the sense that template extensions in C<custom> override template
+extensions in C<default> for your extension, templates for different languages
+can be supplied, etc. Template extensions are searched for and run in the
+order described in L<Bugzilla::Install::Util/template_include_path>.
+
+The difference between normal templates and template hooks is that hooks
+will be run for I<every> extension, whereas for normal templates, Bugzilla
+just takes the first one it finds and stops searching. So while a template
+extension in the C<custom> directory may override the same-named template
+extension in the  C<default> directory I<within your Bugzilla extension>,
+it will not override the same-named template extension in the C<default> 
+directory of another Bugzilla extension.
+
+=item <template path>
+
+This is the part of the path (excluding the filename) that comes after 
+F<template/en/default/> in a template's path. So, for 
+F<template/en/default/global/header.html.tmpl>, this would simply be
+C<global>.
+
+=item <template name>
+
+This is the file name of the template, before the C<.html.tmpl> part.
+So, for F<template/en/default/global/header.html.tmpl>, this would be
+C<header>.
+
+=item <hook name>
+
+This is the name of the hook--what you saw in C<Hook.process> inside
+of the template you want to hook. In our example, this is 
+C<additional_header>.
+
+=item <template type>
+
+This is what comes after the template name but before C<.tmpl> in the
+template's path. In most cases this is C<html>, but sometimes it's
+C<none>, C<txt>, C<js>, or various other formats, indicating what
+type of output the template has.
+
+=back
+
+=head3 Adding New Template Hooks to Bugzilla
+
+Adding new template hooks is just like adding code hooks (see 
+L</Adding New Hooks To Bugzilla>) except that you don't have to
+document them, and including example code is optional.
+
+=head2 Overriding Existing Templates
+
+Sometimes you don't want to extend a template, you just want to replace
+it entirely with your extension's template, or you want to add an entirely
+new template to Bugzilla for your extension to use.
+
+To replace the F<template/en/default/global/banner.html.tmpl> template
+in an extension named "Foo", create a file called 
+F<extensions/Foo/template/en/default/global/banner.html.tmpl>. Note that this
+is very similar to the path for a template hook, except that it excludes
+F<hook/>, and the template is named I<exactly> like the standard Bugzilla
+template. 
+
+You can also use this method to add entirely new templates. If you have
+an extension named "Foo", and you add a file named
+F<extensions/Foo/template/en/default/foo/bar.html.tmpl>, you can load
+that in your code using C<< $template->process('foo/bar.html.tmpl') >>.
+
+=head3 A Warning About Extensions That You Want To Distribute
+
+You should never override an existing Bugzilla template in an
+extension that you plan to distribute to others, because only one extension
+can override any given template, and which extension will "win" that war
+if there are multiple extensions installed is totally undefined.
+
+However, adding new templates in an extension that you want to distribute
+is fine, though you have to be careful about how you name them, because
+any templates with an identical path and name (say, both called
+F<global/stuff.html.tmpl>) will conflict. The usual way to work around
+this is to put all your custom templates into a template path that's
+named after your extension (since the name of your extension has to be
+unique anyway). So if your extension was named Foo, your custom templates
+would go into F<extensions/Foo/template/en/default/foo/>. The only
+time that doesn't work is with the C<page_before_template> extension, in which
+case your templates should probably be in a directory like
+F<extensions/Foo/template/en/default/page/foo/> so as not to conflict with
+other pages that other extensions might add.
+
+=head2 CSS, JavaScript, and Images
+
+If you include CSS, JavaScript, and images in your extension that are
+served directly to the user (that is, they're not read by a script and
+then printed--they're just linked directly in your HTML), they should go
+into the F<web/> subdirectory of your extension. 
+
+So, for example, if you had a CSS file called F<style.css> and your
+extension was called F<Foo>, your file would go into 
+F<extensions/Foo/web/style.css>.
+
+=head2 Disabling Your Extension
+
+If you want your extension to be totally ignored by Bugzilla (it will
+not be compiled or seen to exist at all), then create a file called
+C<disabled> in your extension's directory. (If your extension is just
+a file, like F<extensions/Foo.pm>, you cannot use this method to disable
+your extension, and will just have to remove it from the directory if you
+want to totally disable it.) Note that if you are running under mod_perl,
+you may have to restart your web server for this to take effect.
+
+If you want your extension to be compiled and have L<checksetup> check
+for its module pre-requisites, but you don't want the module to be used
+by Bugzilla, then you should make your extension's L</enabled> method
+return C<0> or some false value.
+
+=head1 DISTRIBUTING EXTENSIONS
+
+If you've made an extension and you want to publish it, the first
+thing you'll want to do is package up your extension's code and
+then put a link to it in the appropriate section of 
+L<http://wiki.mozilla.org/Bugzilla:Addons>.
+
+=head2 Distributing on CPAN
+
+If you want a centralized distribution point that makes it easy
+for Bugzilla users to install your extension, it is possible to 
+distribute your Bugzilla Extension through CPAN.
+
+The details of making a standard CPAN module are too much to
+go into here, but a lot of it is covered in L<perlmodlib>
+and on L<http://www.cpan.org/> among other places.
+
+When you distribute your extension via CPAN, your F<Extension.pm>
+should simply install itself as F<Bugzilla/Extension/Foo.pm>, 
+where C<Foo> is the name of your module. You do not need a separate
+F<Config.pm> file, because CPAN itself will handle installing
+the prerequisites of your module, so Bugzilla doesn't have to
+worry about it.
+
+=head3 Templates in extensions distributed on CPAN
+
+If your extension is F</usr/lib/perl5/Bugzilla/Extension/Foo.pm>,
+then Bugzilla will look for templates in the directory
+F</usr/lib/perl5/Bugzilla/Extension/Foo/template/>.
+
+You can change this behavior by overriding the L</template_dir>
+or L</package_dir> methods described lower down in this document.
+
+=head3 Using an extension distributed on CPAN
+
+There is a file named F<data/extensions/additional> in Bugzilla.
+This is a plain-text file. Each line is the name of a module,
+like C<Bugzilla::Extension::Foo>. In addition to the extensions
+in the F<extensions/> directory, each module listed in this file
+will be loaded as a Bugzilla Extension whenever Bugzilla loads or
+uses extensions.
+
+=head1 GETTING HELP WITH WRITING EXTENSIONS
+
+If you are an extension author and you'd like some assistance from other
+extension authors or the Bugzilla development team, you can use the
+normal support channels described at L<http://www.bugzilla.org/support/>.
+
+=head1 ADDITIONAL CONSTANTS
+
+In addition to C<NAME>, there are some other constants you might
+want to define:
+
+=head2 C<$VERSION>
+
+This should be a string that describes what version of your extension
+this is. Something like C<1.0>, C<1.3.4> or a similar string.
+
+There are no particular restrictions on the format of version numbers,
+but you should probably keep them to just numbers and periods, in the
+interest of other software that parses version numbers.
+
+By default, this will be C<undef> if you don't define it.
+
+=head1 SUBCLASS METHODS
+
+In addition to hooks, there are a few methods that your extension can
+define to modify its behavior, if you want:
+
+=head2 Class Methods
+
+These methods are called on your extension's class. (Like
+C<< Bugzilla::Extension::Foo->some_method >>).
+
+=head3 C<new>
+
+Once every request, this method is called on your extension in order
+to create an "instance" of it. (Extensions are treated like objects--they
+are instantiated once per request in Bugzilla, and then methods are
+called on the object.)
+
+=head2 Instance Methods
+
+These are called on an instantiated Extension object.
+
+=head3 C<enabled>
+
+This should return C<1> if this extension's hook code should be run
+by Bugzilla, and C<0> otherwise.
+
+=head3 C<package_dir>
+
+This returns the directory that your extension is located in. 
+
+If this is an extension that was installed via CPAN, the directory will 
+be the path to F<Bugzilla/Extension/Foo/>, if C<Foo.pm> is the name of your
+extension.
+
+If you want to override this method, and you have a F<Config.pm>, you must
+override this method in F<Config.pm>.
+
+=head3 C<template_dir>
+
+The directory that your package's templates are in.
+
+This defaults to the C<template> subdirectory of the L</package_dir>.
+
+If you want to override this method, and you have a F<Config.pm>, you must
+override this method in F<Config.pm>.
+
+=head3 C<web_dir>
+
+The directory that your package's web related files are in, such as css and javascript.
+
+This defaults to the C<web> subdirectory of the L</package_dir>.
+
+If you want to override this method, and you have a F<Config.pm>, you must
+override this method in F<Config.pm>.
+
+=head3 C<lib_dir>
+
+The directory where your extension's libraries are.
+
+This defaults to the C<lib> subdirectory of the L</package_dir>.
+
+If you want to override this method, and you have a F<Config.pm>, you must
+override this method in F<Config.pm>.
+
+=head1 BUGZILLA::EXTENSION CLASS METHODS
+
+These are used internally by Bugzilla to load and set up extensions.
+If you are an extension author, you don't need to care about these.
+
+=head2 C<load>
+
+Takes two arguments, the path to F<Extension.pm> and the path to F<Config.pm>,
+for an extension. Loads the extension's code packages into memory using
+C<require>, does some sanity-checking on the extension, and returns the
+package name of the loaded extension.
+
+=head2 C<load_all>
+
+Calls L</load> for every enabled extension installed into Bugzilla,
+and returns an arrayref of all the package names that were loaded.

diff --git a/Bugzilla/Field.pm b/Bugzilla/Field.pm
new file mode 100644 (file)
index 0000000..c4d687a
--- /dev/null
+++ b/Bugzilla/Field.pm
@@ -0,0 +1,1347 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+=head1 NAME
+
+Bugzilla::Field - a particular piece of information about bugs
+                  and useful routines for form field manipulation
+
+=head1 SYNOPSIS
+
+  use Bugzilla;
+  use Data::Dumper;
+
+  # Display information about all fields.
+  print Dumper(Bugzilla->fields());
+
+  # Display information about non-obsolete custom fields.
+  print Dumper(Bugzilla->active_custom_fields);
+
+  use Bugzilla::Field;
+
+  # Display information about non-obsolete custom fields.
+  # Bugzilla->fields() is a wrapper around Bugzilla::Field->get_all(),
+  # with arguments which filter the fields before returning them.
+  print Dumper(Bugzilla->fields({ obsolete => 0, custom => 1 }));
+
+  # Create or update a custom field or field definition.
+  my $field = Bugzilla::Field->create(
+    {name => 'cf_silly', description => 'Silly', custom => 1});
+
+  # Instantiate a Field object for an existing field.
+  my $field = new Bugzilla::Field({name => 'qacontact_accessible'});
+  if ($field->obsolete) {
+      say $field->description . " is obsolete";
+  }
+
+  # Validation Routines
+  check_field($name, $value, \@legal_values, $no_warn);
+  $fieldid = get_field_id($fieldname);
+
+=head1 DESCRIPTION
+
+Field.pm defines field objects, which represent the particular pieces
+of information that Bugzilla stores about bugs.
+
+This package also provides functions for dealing with CGI form fields.
+
+C<Bugzilla::Field> is an implementation of L<Bugzilla::Object>, and
+so provides all of the methods available in L<Bugzilla::Object>,
+in addition to what is documented here.
+
+=cut
+
+package Bugzilla::Field;
+
+use strict;
+
+use base qw(Exporter Bugzilla::Object);
+@Bugzilla::Field::EXPORT = qw(check_field get_field_id get_legal_field_values);
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Util;
+use List::MoreUtils qw(any);
+
+use Scalar::Util qw(blessed);
+
+###############################
+####    Initialization     ####
+###############################
+
+use constant DB_TABLE   => 'fielddefs';
+use constant LIST_ORDER => 'sortkey, name';
+
+use constant DB_COLUMNS => qw(
+    id
+    name
+    description
+    long_desc
+    type
+    custom
+    mailhead
+    sortkey
+    obsolete
+    enter_bug
+    buglist
+    visibility_field_id
+    value_field_id
+    reverse_desc
+    is_mandatory
+    is_numeric
+);
+
+use constant VALIDATORS => {
+    custom       => \&_check_custom,
+    description  => \&_check_description,
+    long_desc    => \&_check_long_desc,
+    enter_bug    => \&_check_enter_bug,
+    buglist      => \&Bugzilla::Object::check_boolean,
+    mailhead     => \&_check_mailhead,
+    name         => \&_check_name,
+    obsolete     => \&_check_obsolete,
+    reverse_desc => \&_check_reverse_desc,
+    sortkey      => \&_check_sortkey,
+    type         => \&_check_type,
+    value_field_id      => \&_check_value_field_id,
+    visibility_field_id => \&_check_visibility_field_id,
+    visibility_values => \&_check_visibility_values,
+    is_mandatory => \&Bugzilla::Object::check_boolean,
+    is_numeric   => \&_check_is_numeric,
+};
+
+use constant VALIDATOR_DEPENDENCIES => {
+    is_numeric => ['type'],
+    name => ['custom'],
+    type => ['custom'],
+    reverse_desc => ['type'],
+    value_field_id => ['type'],
+    visibility_values => ['visibility_field_id'],
+};
+
+use constant UPDATE_COLUMNS => qw(
+    description
+    long_desc
+    mailhead
+    sortkey
+    obsolete
+    enter_bug
+    buglist
+    visibility_field_id
+    value_field_id
+    reverse_desc
+    is_mandatory
+    is_numeric
+    type
+);
+
+# How various field types translate into SQL data definitions.
+use constant SQL_DEFINITIONS => {
+    # Using commas because these are constants and they shouldn't
+    # be auto-quoted by the "=>" operator.
+    FIELD_TYPE_FREETEXT,      { TYPE => 'varchar(255)', 
+                                NOTNULL => 1, DEFAULT => "''"},
+    FIELD_TYPE_SINGLE_SELECT, { TYPE => 'varchar(64)', NOTNULL => 1,
+                                DEFAULT => "'---'" },
+    FIELD_TYPE_TEXTAREA,      { TYPE => 'MEDIUMTEXT', 
+                                NOTNULL => 1, DEFAULT => "''"},
+    FIELD_TYPE_DATETIME,      { TYPE => 'DATETIME'   },
+    FIELD_TYPE_BUG_ID,        { TYPE => 'INT3'       },
+};
+
+# Field definitions for the fields that ship with Bugzilla.
+# These are used by populate_field_definitions to populate
+# the fielddefs table.
+# 'days_elapsed' is set in populate_field_definitions() itself.
+use constant DEFAULT_FIELDS => (
+    {name => 'bug_id',       desc => 'Bug #',      in_new_bugmail => 1,
+     buglist => 1, is_numeric => 1},
+    {name => 'short_desc',   desc => 'Summary',    in_new_bugmail => 1,
+     is_mandatory => 1, buglist => 1},
+    {name => 'classification', desc => 'Classification', in_new_bugmail => 1,
+     type => FIELD_TYPE_SINGLE_SELECT, buglist => 1},
+    {name => 'product',      desc => 'Product',    in_new_bugmail => 1,
+     is_mandatory => 1,
+     type => FIELD_TYPE_SINGLE_SELECT, buglist => 1},
+    {name => 'version',      desc => 'Version',    in_new_bugmail => 1,
+     is_mandatory => 1, buglist => 1},
+    {name => 'rep_platform', desc => 'Platform',   in_new_bugmail => 1,
+     type => FIELD_TYPE_SINGLE_SELECT, buglist => 1},
+    {name => 'bug_file_loc', desc => 'URL',        in_new_bugmail => 1,
+     buglist => 1},
+    {name => 'op_sys',       desc => 'OS/Version', in_new_bugmail => 1,
+     type => FIELD_TYPE_SINGLE_SELECT, buglist => 1},
+    {name => 'bug_status',   desc => 'Status',     in_new_bugmail => 1,
+     type => FIELD_TYPE_SINGLE_SELECT, buglist => 1},
+    {name => 'status_whiteboard', desc => 'Status Whiteboard',
+     in_new_bugmail => 1, buglist => 1},
+    {name => 'keywords',     desc => 'Keywords',   in_new_bugmail => 1,
+     type => FIELD_TYPE_KEYWORDS, buglist => 1},
+    {name => 'resolution',   desc => 'Resolution',
+     type => FIELD_TYPE_SINGLE_SELECT, buglist => 1},
+    {name => 'bug_severity', desc => 'Severity',   in_new_bugmail => 1,
+     type => FIELD_TYPE_SINGLE_SELECT, buglist => 1},
+    {name => 'priority',     desc => 'Priority',   in_new_bugmail => 1,
+     type => FIELD_TYPE_SINGLE_SELECT, buglist => 1},
+    {name => 'component',    desc => 'Component',  in_new_bugmail => 1,
+     is_mandatory => 1,
+     type => FIELD_TYPE_SINGLE_SELECT, buglist => 1},
+    {name => 'assigned_to',  desc => 'AssignedTo', in_new_bugmail => 1,
+     buglist => 1},
+    {name => 'reporter',     desc => 'ReportedBy', in_new_bugmail => 1,
+     buglist => 1},
+    {name => 'qa_contact',   desc => 'QAContact',  in_new_bugmail => 1,
+     buglist => 1},
+    {name => 'cc',           desc => 'CC',         in_new_bugmail => 1},
+    {name => 'dependson',    desc => 'Depends on', in_new_bugmail => 1,
+     is_numeric => 1},
+    {name => 'blocked',      desc => 'Blocks',     in_new_bugmail => 1,
+     is_numeric => 1},
+
+    {name => 'attachments.description', desc => 'Attachment description'},
+    {name => 'attachments.filename',    desc => 'Attachment filename'},
+    {name => 'attachments.mimetype',    desc => 'Attachment mime type'},
+    {name => 'attachments.ispatch',     desc => 'Attachment is patch',
+     is_numeric => 1},
+    {name => 'attachments.isobsolete',  desc => 'Attachment is obsolete',
+     is_numeric => 1},
+    {name => 'attachments.isprivate',   desc => 'Attachment is private',
+     is_numeric => 1},
+    {name => 'attachments.submitter',   desc => 'Attachment creator'},
+
+    {name => 'target_milestone',      desc => 'Target Milestone',
+     buglist => 1},
+    {name => 'creation_ts',           desc => 'Creation date',
+     buglist => 1},
+    {name => 'delta_ts',              desc => 'Last changed date',
+     buglist => 1},
+    {name => 'longdesc',              desc => 'Comment'},
+    {name => 'longdescs.isprivate',   desc => 'Comment is private',
+     is_numeric => 1},
+    {name => 'longdescs.count',       desc => 'Number of Comments',
+     buglist => 1, is_numeric => 1},
+    {name => 'alias',                 desc => 'Alias', buglist => 1},
+    {name => 'everconfirmed',         desc => 'Ever Confirmed',
+     is_numeric => 1},
+    {name => 'reporter_accessible',   desc => 'Reporter Accessible',
+     is_numeric => 1},
+    {name => 'cclist_accessible',     desc => 'CC Accessible',
+     is_numeric => 1},
+    {name => 'bug_group',             desc => 'Group', in_new_bugmail => 1},
+    {name => 'estimated_time',        desc => 'Estimated Hours',
+     in_new_bugmail => 1, buglist => 1, is_numeric => 1},
+    {name => 'remaining_time',        desc => 'Remaining Hours', buglist => 1,
+     is_numeric => 1},
+    {name => 'deadline',              desc => 'Deadline',
+     type => FIELD_TYPE_DATETIME, in_new_bugmail => 1, buglist => 1},
+    {name => 'commenter',             desc => 'Commenter'},
+    {name => 'flagtypes.name',        desc => 'Flags', buglist => 1},
+    {name => 'requestees.login_name', desc => 'Flag Requestee'},
+    {name => 'setters.login_name',    desc => 'Flag Setter'},
+    {name => 'work_time',             desc => 'Hours Worked', buglist => 1,
+     is_numeric => 1},
+    {name => 'percentage_complete',   desc => 'Percentage Complete',
+     buglist => 1, is_numeric => 1},
+    {name => 'content',               desc => 'Content'},
+    {name => 'attach_data.thedata',   desc => 'Attachment data'},
+    {name => "owner_idle_time",       desc => "Time Since Assignee Touched"},
+    {name => 'see_also',              desc => "See Also",
+     type => FIELD_TYPE_BUG_URLS},
+    {name => 'tag',                   desc => 'Tags', buglist => 1,
+     type => FIELD_TYPE_KEYWORDS},
+);
+
+################
+# Constructors #
+################
+
+# Override match to add is_select.
+sub match {
+    my $self = shift;
+    my ($params) = @_;
+    if (delete $params->{is_select}) {
+        $params->{type} = [FIELD_TYPE_SINGLE_SELECT, FIELD_TYPE_MULTI_SELECT];
+    }
+    return $self->SUPER::match(@_);
+}
+
+##############
+# Validators #
+##############
+
+sub _check_custom { return $_[1] ? 1 : 0; }
+
+sub _check_description {
+    my ($invocant, $desc) = @_;
+    $desc = clean_text($desc);
+    $desc || ThrowUserError('field_missing_description');
+    return $desc;
+}
+
+sub _check_long_desc {
+    my ($invocant, $long_desc) = @_;
+    $long_desc = clean_text($long_desc || '');
+    if (length($long_desc) > MAX_FIELD_LONG_DESC_LENGTH) {
+        ThrowUserError('field_long_desc_too_long');
+    }
+    return $long_desc;
+}
+
+sub _check_enter_bug { return $_[1] ? 1 : 0; }
+
+sub _check_is_numeric {
+    my ($invocant, $value, undef, $params) = @_;
+    my $type = blessed($invocant) ? $invocant->type : $params->{type};
+    return 1 if $type == FIELD_TYPE_BUG_ID;
+    return $value ? 1 : 0;
+}
+
+sub _check_mailhead { return $_[1] ? 1 : 0; }
+
+sub _check_name {
+    my ($class, $name, undef, $params) = @_;
+    $name = lc(clean_text($name));
+    $name || ThrowUserError('field_missing_name');
+
+    # Don't want to allow a name that might mess up SQL.
+    my $name_regex = qr/^[\w\.]+$/;
+    # Custom fields have more restrictive name requirements than
+    # standard fields.
+    $name_regex = qr/^[a-zA-Z0-9_]+$/ if $params->{custom};
+    # Custom fields can't be named just "cf_", and there is no normal
+    # field named just "cf_".
+    ($name =~ $name_regex && $name ne "cf_")
+         || ThrowUserError('field_invalid_name', { name => $name });
+
+    # If it's custom, prepend cf_ to the custom field name to distinguish 
+    # it from standard fields.
+    if ($name !~ /^cf_/ && $params->{custom}) {
+        $name = 'cf_' . $name;
+    }
+
+    # Assure the name is unique. Names can't be changed, so we don't have
+    # to worry about what to do on updates.
+    my $field = new Bugzilla::Field({ name => $name });
+    ThrowUserError('field_already_exists', {'field' => $field }) if $field;
+
+    return $name;
+}
+
+sub _check_obsolete { return $_[1] ? 1 : 0; }
+
+sub _check_sortkey {
+    my ($invocant, $sortkey) = @_;
+    my $skey = $sortkey;
+    if (!defined $skey || $skey eq '') {
+        ($sortkey) = Bugzilla->dbh->selectrow_array(
+            'SELECT MAX(sortkey) + 100 FROM fielddefs') || 100;
+    }
+    detaint_natural($sortkey)
+        || ThrowUserError('field_invalid_sortkey', { sortkey => $skey });
+    return $sortkey;
+}
+
+sub _check_type {
+    my ($invocant, $type, undef, $params) = @_;
+    my $saved_type = $type;
+    # The constant here should be updated every time a new,
+    # higher field type is added.
+    (detaint_natural($type) && $type <= FIELD_TYPE_KEYWORDS)
+      || ThrowCodeError('invalid_customfield_type', { type => $saved_type });
+
+    my $custom = blessed($invocant) ? $invocant->custom : $params->{custom};
+    if ($custom && !$type) {
+        ThrowCodeError('field_type_not_specified');
+    }
+
+    return $type;
+}
+
+sub _check_value_field_id {
+    my ($invocant, $field_id, undef, $params) = @_;
+    my $is_select = $invocant->is_select($params);
+    if ($field_id && !$is_select) {
+        ThrowUserError('field_value_control_select_only');
+    }
+    return $invocant->_check_visibility_field_id($field_id);
+}
+
+sub _check_visibility_field_id {
+    my ($invocant, $field_id) = @_;
+    $field_id = trim($field_id);
+    return undef if !$field_id;
+    my $field = Bugzilla::Field->check({ id => $field_id });
+    if (blessed($invocant) && $field->id == $invocant->id) {
+        ThrowUserError('field_cant_control_self', { field => $field });
+    }
+    if (!$field->is_select) {
+        ThrowUserError('field_control_must_be_select',
+                       { field => $field });
+    }
+    return $field->id;
+}
+
+sub _check_visibility_values {
+    my ($invocant, $values, undef, $params) = @_;
+    my $field;
+    if (blessed $invocant) {
+        $field = $invocant->visibility_field;
+    }
+    elsif ($params->{visibility_field_id}) {
+        $field = $invocant->new($params->{visibility_field_id});
+    }
+    # When no field is set, no values are set.
+    return [] if !$field;
+
+    if (!scalar @$values) {
+        ThrowUserError('field_visibility_values_must_be_selected',
+                       { field => $field });
+    }
+
+    my @visibility_values;
+    my $choice = Bugzilla::Field::Choice->type($field);
+    foreach my $value (@$values) {
+        if (!blessed $value) {
+            $value = $choice->check({ id => $value });
+        }
+        push(@visibility_values, $value);
+    }
+
+    return \@visibility_values;
+}
+
+sub _check_reverse_desc {
+    my ($invocant, $reverse_desc, undef, $params) = @_;
+    my $type = blessed($invocant) ? $invocant->type : $params->{type};
+    if ($type != FIELD_TYPE_BUG_ID) {
+        return undef; # store NULL for non-reversible field types
+    }
+    
+    $reverse_desc = clean_text($reverse_desc);
+    return $reverse_desc;
+}
+
+sub _check_is_mandatory { return $_[1] ? 1 : 0; }
+
+=pod
+
+=head2 Instance Properties
+
+=over
+
+=item C<name>
+
+the name of the field in the database; begins with "cf_" if field
+is a custom field, but test the value of the boolean "custom" property
+to determine if a given field is a custom field;
+
+=item C<description>
+
+a short string describing the field; displayed to Bugzilla users
+in several places within Bugzilla's UI, f.e. as the form field label
+on the "show bug" page;
+
+=back
+
+=cut
+
+sub description { return $_[0]->{description} }
+
+=over
+
+=item C<long_desc>
+
+A string providing detailed info about the field;
+
+=back
+
+=cut
+
+sub long_desc { return $_[0]->{long_desc} }
+
+=over
+
+=item C<type>
+
+an integer specifying the kind of field this is; values correspond to
+the FIELD_TYPE_* constants in Constants.pm
+
+=back
+
+=cut
+
+sub type { return $_[0]->{type} }
+
+=over
+
+=item C<custom>
+
+a boolean specifying whether or not the field is a custom field;
+if true, field name should start "cf_", but use this property to determine
+which fields are custom fields;
+
+=back
+
+=cut
+
+sub custom { return $_[0]->{custom} }
+
+=over
+
+=item C<in_new_bugmail>
+
+a boolean specifying whether or not the field is displayed in bugmail
+for newly-created bugs;
+
+=back
+
+=cut
+
+sub in_new_bugmail { return $_[0]->{mailhead} }
+
+=over
+
+=item C<sortkey>
+
+an integer specifying the sortkey of the field.
+
+=back
+
+=cut
+
+sub sortkey { return $_[0]->{sortkey} }
+
+=over
+
+=item C<obsolete>
+
+a boolean specifying whether or not the field is obsolete;
+
+=back
+
+=cut
+
+sub obsolete { return $_[0]->{obsolete} }
+
+=over
+
+=item C<enter_bug>
+
+A boolean specifying whether or not this field should appear on 
+enter_bug.cgi
+
+=back
+
+=cut
+
+sub enter_bug { return $_[0]->{enter_bug} }
+
+=over
+
+=item C<buglist>
+
+A boolean specifying whether or not this field is selectable
+as a display or order column in buglist.cgi
+
+=back
+
+=cut
+
+sub buglist { return $_[0]->{buglist} }
+
+=over
+
+=item C<is_select>
+
+True if this is a C<FIELD_TYPE_SINGLE_SELECT> or C<FIELD_TYPE_MULTI_SELECT>
+field. It is only safe to call L</legal_values> if this is true.
+
+=item C<legal_values>
+
+Valid values for this field, as an array of L<Bugzilla::Field::Choice>
+objects.
+
+=back
+
+=cut
+
+sub is_select {
+    my ($invocant, $params) = @_;
+    # This allows this method to be called by create() validators.
+    my $type = blessed($invocant) ? $invocant->type : $params->{type}; 
+    return ($type == FIELD_TYPE_SINGLE_SELECT 
+            || $type == FIELD_TYPE_MULTI_SELECT) ? 1 : 0 
+}
+
+=over
+
+=item C<is_abnormal>
+
+Most fields that have a C<SELECT> L</type> have a certain schema for
+the table that stores their values, the table has the same name as the field,
+and the field's legal values can be edited via F<editvalues.cgi>.
+
+However, some fields do not follow that pattern. Those fields are
+considered "abnormal".
+
+This method returns C<1> if the field is "abnormal", C<0> otherwise.
+
+=back
+
+=cut
+
+sub is_abnormal {
+    my $self = shift;
+    return ABNORMAL_SELECTS->{$self->name} ? 1 : 0;
+}
+
+sub legal_values {
+    my $self = shift;
+
+    if (!defined $self->{'legal_values'}) {
+        require Bugzilla::Field::Choice;
+        my @values = Bugzilla::Field::Choice->type($self)->get_all();
+        $self->{'legal_values'} = \@values;
+    }
+    return $self->{'legal_values'};
+}
+
+=pod
+
+=over
+
+=item C<is_timetracking>
+
+True if this is a time-tracking field that should only be shown to users
+in the C<timetrackinggroup>.
+
+=back
+
+=cut
+
+sub is_timetracking {
+    my ($self) = @_;
+    return grep($_ eq $self->name, TIMETRACKING_FIELDS) ? 1 : 0;
+}
+
+=pod
+
+=over
+
+=item C<visibility_field>
+
+What field controls this field's visibility? Returns a C<Bugzilla::Field>
+object representing the field that controls this field's visibility.
+
+Returns undef if there is no field that controls this field's visibility.
+
+=back
+
+=cut
+
+sub visibility_field {
+    my $self = shift;
+    if ($self->{visibility_field_id}) {
+        $self->{visibility_field} ||= 
+            $self->new($self->{visibility_field_id});
+    }
+    return $self->{visibility_field};
+}
+
+=pod
+
+=over
+
+=item C<visibility_values>
+
+If we have a L</visibility_field>, then what values does that field have to
+be set to in order to show this field? Returns a L<Bugzilla::Field::Choice>
+or undef if there is no C<visibility_field> set.
+
+=back
+
+=cut
+
+sub visibility_values {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+    
+    return [] if !$self->{visibility_field_id};
+
+    if (!defined $self->{visibility_values}) {
+        my $visibility_value_ids =
+            $dbh->selectcol_arrayref("SELECT value_id FROM field_visibility
+                                      WHERE field_id = ?", undef, $self->id);
+
+        $self->{visibility_values} =
+            Bugzilla::Field::Choice->type($self->visibility_field)
+            ->new_from_list($visibility_value_ids);
+    }
+
+    return $self->{visibility_values};
+}
+
+=pod
+
+=over
+
+=item C<controls_visibility_of>
+
+An arrayref of C<Bugzilla::Field> objects, representing fields that this
+field controls the visibility of.
+
+=back
+
+=cut
+
+sub controls_visibility_of {
+    my $self = shift;
+    $self->{controls_visibility_of} ||= 
+        Bugzilla::Field->match({ visibility_field_id => $self->id });
+    return $self->{controls_visibility_of};
+}
+
+=pod
+
+=over
+
+=item C<value_field>
+
+The Bugzilla::Field that controls the list of values for this field.
+
+Returns undef if there is no field that controls this field's visibility.
+
+=back
+
+=cut
+
+sub value_field {
+    my $self = shift;
+    if ($self->{value_field_id}) {
+        $self->{value_field} ||= $self->new($self->{value_field_id});
+    }
+    return $self->{value_field};
+}
+
+=pod
+
+=over
+
+=item C<controls_values_of>
+
+An arrayref of C<Bugzilla::Field> objects, representing fields that this
+field controls the values of.
+
+=back
+
+=cut
+
+sub controls_values_of {
+    my $self = shift;
+    $self->{controls_values_of} ||=
+        Bugzilla::Field->match({ value_field_id => $self->id });
+    return $self->{controls_values_of};
+}
+
+=over
+
+=item C<is_visible_on_bug>
+
+See L<Bugzilla::Field::ChoiceInterface>.
+
+=back
+
+=cut
+
+sub is_visible_on_bug {
+    my ($self, $bug) = @_;
+
+    # Always return visible, if this field is not
+    # visibility controlled.
+    return 1 if !$self->{visibility_field_id};
+
+    my $visibility_values = $self->visibility_values;
+
+    return (any { $_->is_set_on_bug($bug) } @$visibility_values) ? 1 : 0;
+}
+
+=over
+
+=item C<is_relationship>
+
+Applies only to fields of type FIELD_TYPE_BUG_ID.
+Checks to see if a reverse relationship description has been set.
+This is the canonical condition to enable reverse link display,
+dependency tree display, and similar functionality.
+
+=back
+
+=cut
+
+sub is_relationship  {     
+    my $self = shift;
+    my $desc = $self->reverse_desc;
+    if (defined $desc && $desc ne "") {
+        return 1;
+    }
+    return 0;
+}
+
+=over
+
+=item C<reverse_desc>
+
+Applies only to fields of type FIELD_TYPE_BUG_ID.
+Describes the reverse relationship of this field.
+For example, if a BUG_ID field is called "Is a duplicate of",
+the reverse description would be "Duplicates of this bug".
+
+=back
+
+=cut
+
+sub reverse_desc { return $_[0]->{reverse_desc} }
+
+=over
+
+=item C<is_mandatory>
+
+a boolean specifying whether or not the field is mandatory;
+
+=back
+
+=cut
+
+sub is_mandatory { return $_[0]->{is_mandatory} }
+
+=over
+
+=item C<is_numeric>
+
+A boolean specifying whether or not this field logically contains
+numeric (integer, decimal, or boolean) values. By "logically contains" we
+mean that the user inputs numbers into the value of the field in the UI.
+This is mostly used by L<Bugzilla::Search>.
+
+=back
+
+=cut
+
+sub is_numeric { return $_[0]->{is_numeric} }
+
+
+=pod
+
+=head2 Instance Mutators
+
+These set the particular field that they are named after.
+
+They take a single value--the new value for that field.
+
+They will throw an error if you try to set the values to something invalid.
+
+=over
+
+=item C<set_description>
+
+=item C<set_long_desc>
+
+=item C<set_enter_bug>
+
+=item C<set_obsolete>
+
+=item C<set_sortkey>
+
+=item C<set_in_new_bugmail>
+
+=item C<set_buglist>
+
+=item C<set_reverse_desc>
+
+=item C<set_visibility_field>
+
+=item C<set_visibility_values>
+
+=item C<set_value_field>
+
+=item C<set_is_mandatory>
+
+
+=back
+
+=cut
+
+sub set_description    { $_[0]->set('description', $_[1]); }
+sub set_long_desc      { $_[0]->set('long_desc',   $_[1]); }
+sub set_enter_bug      { $_[0]->set('enter_bug',   $_[1]); }
+sub set_is_numeric     { $_[0]->set('is_numeric',  $_[1]); }
+sub set_obsolete       { $_[0]->set('obsolete',    $_[1]); }
+sub set_sortkey        { $_[0]->set('sortkey',     $_[1]); }
+sub set_in_new_bugmail { $_[0]->set('mailhead',    $_[1]); }
+sub set_buglist        { $_[0]->set('buglist',     $_[1]); }
+sub set_reverse_desc    { $_[0]->set('reverse_desc', $_[1]); }
+sub set_visibility_field {
+    my ($self, $value) = @_;
+    $self->set('visibility_field_id', $value);
+    delete $self->{visibility_field};
+    delete $self->{visibility_values};
+}
+sub set_visibility_values {
+    my ($self, $value_ids) = @_;
+    $self->set('visibility_values', $value_ids);
+}
+sub set_value_field {
+    my ($self, $value) = @_;
+    $self->set('value_field_id', $value);
+    delete $self->{value_field};
+}
+sub set_is_mandatory { $_[0]->set('is_mandatory', $_[1]); }
+
+# This is only used internally by upgrade code in Bugzilla::Field.
+sub _set_type { $_[0]->set('type', $_[1]); }
+
+=pod
+
+=head2 Instance Method
+
+=over
+
+=item C<remove_from_db>
+
+Attempts to remove the passed in field from the database.
+Deleting a field is only successful if the field is obsolete and
+there are no values specified (or EVER specified) for the field.
+
+=back
+
+=cut
+
+sub remove_from_db {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    my $name = $self->name;
+
+    if (!$self->custom) {
+        ThrowCodeError('field_not_custom', {'name' => $name });
+    }
+
+    if (!$self->obsolete) {
+        ThrowUserError('customfield_not_obsolete', {'name' => $self->name });
+    }
+
+    $dbh->bz_start_transaction();
+
+    # Check to see if bug activity table has records (should be fast with index)
+    my $has_activity = $dbh->selectrow_array("SELECT COUNT(*) FROM bugs_activity
+                                      WHERE fieldid = ?", undef, $self->id);
+    if ($has_activity) {
+        ThrowUserError('customfield_has_activity', {'name' => $name });
+    }
+
+    # Check to see if bugs table has records (slow)
+    my $bugs_query = "";
+
+    if ($self->type == FIELD_TYPE_MULTI_SELECT) {
+        $bugs_query = "SELECT COUNT(*) FROM bug_$name";
+    }
+    else {
+        $bugs_query = "SELECT COUNT(*) FROM bugs WHERE $name IS NOT NULL";
+        if ($self->type != FIELD_TYPE_BUG_ID && $self->type != FIELD_TYPE_DATETIME) {
+            $bugs_query .= " AND $name != ''";
+        }
+        # Ignore the default single select value
+        if ($self->type == FIELD_TYPE_SINGLE_SELECT) {
+            $bugs_query .= " AND $name != '---'";
+        }
+    }
+
+    my $has_bugs = $dbh->selectrow_array($bugs_query);
+    if ($has_bugs) {
+        ThrowUserError('customfield_has_contents', {'name' => $name });
+    }
+
+    # Once we reach here, we should be OK to delete.
+    $self->SUPER::remove_from_db();
+
+    my $type = $self->type;
+
+    # the values for multi-select are stored in a seperate table
+    if ($type != FIELD_TYPE_MULTI_SELECT) {
+        $dbh->bz_drop_column('bugs', $name);
+    }
+
+    if ($self->is_select) {
+        # Delete the table that holds the legal values for this field.
+        $dbh->bz_drop_field_tables($self);
+    }
+
+    $dbh->bz_commit_transaction()
+}
+
+=pod
+
+=head2 Class Methods
+
+=over
+
+=item C<create>
+
+Just like L<Bugzilla::Object/create>. Takes the following parameters:
+
+=over
+
+=item C<name> B<Required> - The name of the field.
+
+=item C<description> B<Required> - The field label to display in the UI.
+
+=item C<long_desc> - A longer description of the field.
+
+=item C<mailhead> - boolean - Whether this field appears at the
+top of the bugmail for a newly-filed bug. Defaults to 0.
+
+=item C<custom> - boolean - True if this is a Custom Field. The field
+will be added to the C<bugs> table if it does not exist. Defaults to 0.
+
+=item C<sortkey> - integer - The sortkey of the field. Defaults to 0.
+
+=item C<enter_bug> - boolean - Whether this field is
+editable on the bug creation form. Defaults to 0.
+
+=item C<buglist> - boolean - Whether this field is
+selectable as a display or order column in bug lists. Defaults to 0.
+
+C<obsolete> - boolean - Whether this field is obsolete. Defaults to 0.
+
+C<is_mandatory> - boolean - Whether this field is mandatory. Defaults to 0.
+
+=back
+
+=back
+
+=cut
+
+sub create {
+    my $class = shift;
+    my ($params) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    # This makes sure the "sortkey" validator runs, even if
+    # the parameter isn't sent to create().
+    $params->{sortkey} = undef if !exists $params->{sortkey};
+    $params->{type} ||= 0;
+    # We mark the custom field as obsolete till it has been fully created,
+    # to avoid race conditions when viewing bugs at the same time.
+    my $is_obsolete = $params->{obsolete};
+    $params->{obsolete} = 1 if $params->{custom};
+
+    $dbh->bz_start_transaction();
+    $class->check_required_create_fields(@_);
+    my $field_values      = $class->run_create_validators($params);
+    my $visibility_values = delete $field_values->{visibility_values};
+    my $field             = $class->insert_create_data($field_values);
+    
+    $field->set_visibility_values($visibility_values);
+    $field->_update_visibility_values();
+
+    $dbh->bz_commit_transaction();
+
+    if ($field->custom) {
+        my $name = $field->name;
+        my $type = $field->type;
+        if (SQL_DEFINITIONS->{$type}) {
+            # Create the database column that stores the data for this field.
+            $dbh->bz_add_column('bugs', $name, SQL_DEFINITIONS->{$type});
+        }
+
+        if ($field->is_select) {
+            # Create the table that holds the legal values for this field.
+            $dbh->bz_add_field_tables($field);
+        }
+
+        if ($type == FIELD_TYPE_SINGLE_SELECT) {
+            # Insert a default value of "---" into the legal values table.
+            $dbh->do("INSERT INTO $name (value) VALUES ('---')");
+        }
+
+        # Restore the original obsolete state of the custom field.
+        $dbh->do('UPDATE fielddefs SET obsolete = 0 WHERE id = ?', undef, $field->id)
+          unless $is_obsolete;
+    }
+
+    return $field;
+}
+
+sub update {
+    my $self = shift;
+    my $changes = $self->SUPER::update(@_);
+    my $dbh = Bugzilla->dbh;
+    if ($changes->{value_field_id} && $self->is_select) {
+        $dbh->do("UPDATE " . $self->name . " SET visibility_value_id = NULL");
+    }
+    $self->_update_visibility_values();
+    return $changes;
+}
+
+sub _update_visibility_values {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    my @visibility_value_ids = map($_->id, @{$self->visibility_values});
+    $self->_delete_visibility_values();
+    for my $value_id (@visibility_value_ids) {
+        $dbh->do("INSERT INTO field_visibility (field_id, value_id)
+                  VALUES (?, ?)", undef, $self->id, $value_id);
+    }
+}
+
+sub _delete_visibility_values {
+    my ($self) = @_;
+    my $dbh = Bugzilla->dbh;
+    $dbh->do("DELETE FROM field_visibility WHERE field_id = ?",
+        undef, $self->id);
+    delete $self->{visibility_values};
+}
+
+=pod
+
+=over
+
+=item C<get_legal_field_values($field)>
+
+Description: returns all the legal values for a field that has a
+             list of legal values, like rep_platform or resolution.
+             The table where these values are stored must at least have
+             the following columns: value, isactive, sortkey.
+
+Params:    C<$field> - Name of the table where valid values are.
+
+Returns:   a reference to a list of valid values.
+
+=back
+
+=cut
+
+sub get_legal_field_values {
+    my ($field) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $result_ref = $dbh->selectcol_arrayref(
+         "SELECT value FROM $field
+           WHERE isactive = ?
+        ORDER BY sortkey, value", undef, (1));
+    return $result_ref;
+}
+
+=over
+
+=item C<populate_field_definitions()>
+
+Description: Populates the fielddefs table during an installation
+             or upgrade.
+
+Params:      none
+
+Returns:     nothing
+
+=back
+
+=cut
+
+sub populate_field_definitions {
+    my $dbh = Bugzilla->dbh;
+
+    # ADD and UPDATE field definitions
+    foreach my $def (DEFAULT_FIELDS) {
+        my $field = new Bugzilla::Field({ name => $def->{name} });
+        if ($field) {
+            $field->set_description($def->{desc});
+            $field->set_in_new_bugmail($def->{in_new_bugmail});
+            $field->set_buglist($def->{buglist});
+            $field->_set_type($def->{type}) if $def->{type};
+            $field->set_is_mandatory($def->{is_mandatory});
+            $field->set_is_numeric($def->{is_numeric});
+            $field->update();
+        }
+        else {
+            if (exists $def->{in_new_bugmail}) {
+                $def->{mailhead} = $def->{in_new_bugmail};
+                delete $def->{in_new_bugmail};
+            }
+            $def->{description} = delete $def->{desc};
+            Bugzilla::Field->create($def);
+        }
+    }
+
+    # DELETE fields which were added only accidentally, or which
+    # were never tracked in bugs_activity. Note that you can never
+    # delete fields which are used by bugs_activity.
+
+    # Oops. Bug 163299
+    $dbh->do("DELETE FROM fielddefs WHERE name='cc_accessible'");
+    # Oops. Bug 215319
+    $dbh->do("DELETE FROM fielddefs WHERE name='requesters.login_name'");
+    # This field was never tracked in bugs_activity, so it's safe to delete.
+    $dbh->do("DELETE FROM fielddefs WHERE name='attachments.thedata'");
+
+    # MODIFY old field definitions
+
+    # 2005-11-13 LpSolit@gmail.com - Bug 302599
+    # One of the field names was a fragment of SQL code, which is DB dependent.
+    # We have to rename it to a real name, which is DB independent.
+    my $new_field_name = 'days_elapsed';
+    my $field_description = 'Days since bug changed';
+
+    my ($old_field_id, $old_field_name) =
+        $dbh->selectrow_array('SELECT id, name FROM fielddefs
+                                WHERE description = ?',
+                              undef, $field_description);
+
+    if ($old_field_id && ($old_field_name ne $new_field_name)) {
+        say "SQL fragment found in the 'fielddefs' table...";
+        say "Old field name: $old_field_name";
+        # We have to fix saved searches first. Queries have been escaped
+        # before being saved. We have to do the same here to find them.
+        $old_field_name = url_quote($old_field_name);
+        my $broken_named_queries =
+            $dbh->selectall_arrayref('SELECT userid, name, query
+                                        FROM namedqueries WHERE ' .
+                                      $dbh->sql_istrcmp('query', '?', 'LIKE'),
+                                      undef, "%=$old_field_name%");
+
+        my $sth_UpdateQueries = $dbh->prepare('UPDATE namedqueries SET query = ?
+                                                WHERE userid = ? AND name = ?');
+
+        print "Fixing saved searches...\n" if scalar(@$broken_named_queries);
+        foreach my $named_query (@$broken_named_queries) {
+            my ($userid, $name, $query) = @$named_query;
+            $query =~ s/=\Q$old_field_name\E(&|$)/=$new_field_name$1/gi;
+            $sth_UpdateQueries->execute($query, $userid, $name);
+        }
+
+        # We now do the same with saved chart series.
+        my $broken_series =
+            $dbh->selectall_arrayref('SELECT series_id, query
+                                        FROM series WHERE ' .
+                                      $dbh->sql_istrcmp('query', '?', 'LIKE'),
+                                      undef, "%=$old_field_name%");
+
+        my $sth_UpdateSeries = $dbh->prepare('UPDATE series SET query = ?
+                                               WHERE series_id = ?');
+
+        print "Fixing saved chart series...\n" if scalar(@$broken_series);
+        foreach my $series (@$broken_series) {
+            my ($series_id, $query) = @$series;
+            $query =~ s/=\Q$old_field_name\E(&|$)/=$new_field_name$1/gi;
+            $sth_UpdateSeries->execute($query, $series_id);
+        }
+        # Now that saved searches have been fixed, we can fix the field name.
+        say "Fixing the 'fielddefs' table...";
+        say "New field name: $new_field_name";
+        $dbh->do('UPDATE fielddefs SET name = ? WHERE id = ?',
+                  undef, ($new_field_name, $old_field_id));
+    }
+
+    # This field has to be created separately, or the above upgrade code
+    # might not run properly.
+    Bugzilla::Field->create({ name => $new_field_name, 
+                              description => $field_description })
+        unless new Bugzilla::Field({ name => $new_field_name });
+
+}
+
+
+
+=head2 Data Validation
+
+=over
+
+=item C<check_field($name, $value, \@legal_values, $no_warn)>
+
+Description: Makes sure the field $name is defined and its $value
+             is non empty. If @legal_values is defined, this routine
+             checks whether its value is one of the legal values
+             associated with this field, else it checks against
+             the default valid values for this field obtained by
+             C<get_legal_field_values($name)>. If the test is successful,
+             the function returns 1. If the test fails, an error
+             is thrown (by default), unless $no_warn is true, in which
+             case the function returns 0.
+
+Params:      $name         - the field name
+             $value        - the field value
+             @legal_values - (optional) list of legal values
+             $no_warn      - (optional) do not throw an error if true
+
+Returns:     1 on success; 0 on failure if $no_warn is true (else an
+             error is thrown).
+
+=back
+
+=cut
+
+sub check_field {
+    my ($name, $value, $legalsRef, $no_warn) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    # If $legalsRef is undefined, we use the default valid values.
+    # Valid values for this check are all possible values. 
+    # Using get_legal_values would only return active values, but since
+    # some bugs may have inactive values set, we want to check them too. 
+    unless (defined $legalsRef) {
+        $legalsRef = Bugzilla::Field->new({name => $name})->legal_values;
+        my @values = map($_->name, @$legalsRef);
+        $legalsRef = \@values;
+
+    }
+
+    if (!defined($value)
+        or trim($value) eq ""
+        or !grep { $_ eq $value } @$legalsRef)
+    {
+        return 0 if $no_warn; # We don't want an error to be thrown; return.
+        trick_taint($name);
+
+        my $field = new Bugzilla::Field({ name => $name });
+        my $field_desc = $field ? $field->description : $name;
+        ThrowCodeError('illegal_field', { field => $field_desc });
+    }
+    return 1;
+}
+
+=pod
+
+=over
+
+=item C<get_field_id($fieldname)>
+
+Description: Returns the ID of the specified field name and throws
+             an error if this field does not exist.
+
+Params:      $name - a field name
+
+Returns:     the corresponding field ID or an error if the field name
+             does not exist.
+
+=back
+
+=cut
+
+sub get_field_id {
+    my ($name) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    trick_taint($name);
+    my $id = $dbh->selectrow_array('SELECT id FROM fielddefs
+                                    WHERE name = ?', undef, $name);
+
+    ThrowCodeError('invalid_field_name', {field => $name}) unless $id;
+    return $id
+}
+
+1;
+
+__END__

diff --git a/Bugzilla/Field/Choice.pm b/Bugzilla/Field/Choice.pm
new file mode 100644 (file)
index 0000000..a292185
--- /dev/null
+++ b/Bugzilla/Field/Choice.pm
@@ -0,0 +1,335 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+package Bugzilla::Field::Choice;
+
+use base qw(Bugzilla::Field::ChoiceInterface Bugzilla::Object);
+
+use Bugzilla::Config qw(SetParam write_params);
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Field;
+use Bugzilla::Util qw(trim detaint_natural);
+
+use Scalar::Util qw(blessed);
+
+##################
+# Initialization #
+##################
+
+use constant DB_COLUMNS => qw(
+    id
+    value
+    sortkey
+    isactive
+    visibility_value_id
+);
+
+use constant UPDATE_COLUMNS => qw(
+    value
+    sortkey
+    isactive
+    visibility_value_id
+);
+
+use constant NAME_FIELD => 'value';
+use constant LIST_ORDER => 'sortkey, value';
+
+use constant VALIDATORS => {
+    value   => \&_check_value,
+    sortkey => \&_check_sortkey,
+    visibility_value_id => \&_check_visibility_value_id,
+    isactive => \&_check_isactive,
+};
+
+use constant CLASS_MAP => {
+    bug_status => 'Bugzilla::Status',
+    classification => 'Bugzilla::Classification',
+    component  => 'Bugzilla::Component',
+    product    => 'Bugzilla::Product',
+};
+
+use constant DEFAULT_MAP => {
+    op_sys       => 'defaultopsys',
+    rep_platform => 'defaultplatform',
+    priority     => 'defaultpriority',
+    bug_severity => 'defaultseverity',
+};
+
+#################
+# Class Factory #
+#################
+
+# Bugzilla::Field::Choice is actually an abstract base class. Every field
+# type has its own dynamically-generated class for its values. This allows
+# certain fields to have special types, like how bug_status's values
+# are Bugzilla::Status objects.
+
+sub type {
+    my ($class, $field) = @_;
+    my $field_obj = blessed $field ? $field : Bugzilla::Field->check($field);
+    my $field_name = $field_obj->name;
+
+    if (my $package = $class->CLASS_MAP->{$field_name}) {
+        # Callers expect the module to be already loaded.
+        eval "require $package";
+        return $package;
+    }
+
+    # For generic classes, we use a lowercase class name, so as
+    # not to interfere with any real subclasses we might make some day.
+    my $package = "Bugzilla::Field::Choice::$field_name";
+    Bugzilla->request_cache->{"field_$package"} = $field_obj;
+
+    # This package only needs to be created once. We check if the DB_TABLE
+    # glob for this package already exists, which tells us whether or not
+    # we need to create the package (this works even under mod_perl, where
+    # this package definition will persist across requests)).
+    if (!defined *{"${package}::DB_TABLE"}) {
+        eval <<EOC;
+            package $package;
+            use base qw(Bugzilla::Field::Choice);
+            use constant DB_TABLE => '$field_name';
+EOC
+    }
+
+    return $package;
+}
+
+################
+# Constructors #
+################
+
+# We just make new() enforce this, which should give developers 
+# the understanding that you can't use Bugzilla::Field::Choice
+# without calling type().
+sub new {
+    my $class = shift;
+    if ($class eq 'Bugzilla::Field::Choice') {
+        ThrowCodeError('field_choice_must_use_type');
+    }
+    $class->SUPER::new(@_);
+}
+
+#########################
+# Database Manipulation #
+#########################
+
+# Our subclasses can take more arguments than we normally accept.
+# So, we override create() to remove arguments that aren't valid
+# columns. (Normally Bugzilla::Object dies if you pass arguments
+# that aren't valid columns.)
+sub create {
+    my $class = shift;
+    my ($params) = @_;
+    foreach my $key (keys %$params) {
+        if (!grep {$_ eq $key} $class->_get_db_columns) {
+            delete $params->{$key};
+        }
+    }
+    return $class->SUPER::create(@_);
+}
+
+sub update {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+    my $fname = $self->field->name;
+
+    $dbh->bz_start_transaction();
+
+    my ($changes, $old_self) = $self->SUPER::update(@_);
+    if (exists $changes->{value}) {
+        my ($old, $new) = @{ $changes->{value} };
+        if ($self->field->type == FIELD_TYPE_MULTI_SELECT) {
+            $dbh->do("UPDATE bug_$fname SET value = ? WHERE value = ?",
+                     undef, $new, $old);
+        }
+        else {
+            $dbh->do("UPDATE bugs SET $fname = ? WHERE $fname = ?",
+                     undef, $new, $old);
+        }
+
+        if ($old_self->is_default) {
+            my $param = $self->DEFAULT_MAP->{$self->field->name};
+            SetParam($param, $self->name);
+            write_params();
+        }
+    }
+
+    $dbh->bz_commit_transaction();
+    return wantarray ? ($changes, $old_self) : $changes;
+}
+
+sub remove_from_db {
+    my $self = shift;
+    if ($self->is_default) {
+        ThrowUserError('fieldvalue_is_default',
+                       { field => $self->field, value => $self,
+                         param_name => $self->DEFAULT_MAP->{$self->field->name},
+                       });
+    }
+    if ($self->is_static) {
+        ThrowUserError('fieldvalue_not_deletable', 
+                       { field => $self->field, value => $self });
+    }
+    if ($self->bug_count) {
+        ThrowUserError("fieldvalue_still_has_bugs",
+                       { field => $self->field, value => $self });
+    }
+    $self->_check_if_controller(); # From ChoiceInterface.
+    $self->SUPER::remove_from_db();
+}
+
+############
+# Mutators #
+############
+
+sub set_is_active { $_[0]->set('isactive', $_[1]); }
+sub set_name      { $_[0]->set('value', $_[1]);    }
+sub set_sortkey   { $_[0]->set('sortkey', $_[1]);  }
+sub set_visibility_value {
+    my ($self, $value) = @_;
+    $self->set('visibility_value_id', $value);
+    delete $self->{visibility_value};
+}
+
+##############
+# Validators #
+##############
+
+sub _check_isactive {
+    my ($invocant, $value) = @_;
+    $value = Bugzilla::Object::check_boolean($invocant, $value);
+    if (!$value and ref $invocant) {
+        if ($invocant->is_default) {
+            my $field = $invocant->field;
+            ThrowUserError('fieldvalue_is_default', 
+                           { value => $invocant, field => $field,
+                             param_name => $invocant->DEFAULT_MAP->{$field->name}
+                           });
+        }
+        if ($invocant->is_static) {
+            ThrowUserError('fieldvalue_not_deletable',
+                           { value => $invocant, field => $invocant->field });
+        }
+    }
+    return $value;
+}
+
+sub _check_value {
+    my ($invocant, $value) = @_;
+
+    my $field = $invocant->field;
+
+    $value = trim($value);
+
+    # Make sure people don't rename static values
+    if (blessed($invocant) && $value ne $invocant->name 
+        && $invocant->is_static) 
+    {
+        ThrowUserError('fieldvalue_not_editable',
+                       { field => $field, old_value => $invocant });
+    }
+
+    ThrowUserError('fieldvalue_undefined') if !defined $value || $value eq "";
+    ThrowUserError('fieldvalue_name_too_long', { value => $value })
+        if length($value) > MAX_FIELD_VALUE_SIZE;
+
+    my $exists = $invocant->type($field)->new({ name => $value });
+    if ($exists && (!blessed($invocant) || $invocant->id != $exists->id)) {
+        ThrowUserError('fieldvalue_already_exists', 
+                       { field => $field, value => $exists });
+    }
+
+    return $value;
+}
+
+sub _check_sortkey {
+    my ($invocant, $value) = @_;
+    $value = trim($value);
+    return 0 if !$value;
+    # Store for the error message in case detaint_natural clears it.
+    my $orig_value = $value;
+    (detaint_natural($value) && $value <= MAX_SMALLINT)
+        || ThrowUserError('fieldvalue_sortkey_invalid',
+                          { sortkey => $orig_value,
+                            field   => $invocant->field });
+    return $value;
+}
+
+sub _check_visibility_value_id {
+    my ($invocant, $value_id) = @_;
+    $value_id = trim($value_id);
+    my $field = $invocant->field->value_field;
+    return undef if !$field || !$value_id;
+    my $value_obj = Bugzilla::Field::Choice->type($field)
+                    ->check({ id => $value_id });
+    return $value_obj->id;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Field::Choice - A legal value for a <select>-type field.
+
+=head1 SYNOPSIS
+
+ my $field = new Bugzilla::Field({name => 'bug_status'});
+
+ my $choice = new Bugzilla::Field::Choice->type($field)->new(1);
+
+ my $choices = Bugzilla::Field::Choice->type($field)->new_from_list([1,2,3]);
+ my $choices = Bugzilla::Field::Choice->type($field)->get_all();
+ my $choices = Bugzilla::Field::Choice->type($field->match({ sortkey => 10 }); 
+
+=head1 DESCRIPTION
+
+This is an implementation of L<Bugzilla::Object>, but with a twist.
+You can't call any class methods (such as C<new>, C<create>, etc.) 
+directly on C<Bugzilla::Field::Choice> itself. Instead, you have to
+call C<Bugzilla::Field::Choice-E<gt>type($field)> to get the class
+you're going to instantiate, and then you call the methods on that.
+
+We do that because each field has its own database table for its values, so
+each value type needs its own class.
+
+See the L</SYNOPSIS> for examples of how this works.
+
+This class implements L<Bugzilla::Field::ChoiceInterface>, and so all
+methods of that class are also available here.
+
+=head1 METHODS
+
+=head2 Class Factory
+
+In object-oriented design, a "class factory" is a method that picks
+and returns the right class for you, based on an argument that you pass.
+
+=over
+
+=item C<type>
+
+Takes a single argument, which is either the name of a field from the
+C<fielddefs> table, or a L<Bugzilla::Field> object representing a field.
+
+Returns an appropriate subclass of C<Bugzilla::Field::Choice> that you
+can now call class methods on (like C<new>, C<create>, C<match>, etc.)
+
+B<NOTE>: YOU CANNOT CALL CLASS METHODS ON C<Bugzilla::Field::Choice>. You
+must call C<type> to get a class you can call methods on.
+
+=back
+
+=head2 Mutators
+
+This class implements mutators for all of the settable accessors in
+L<Bugzilla::Field::ChoiceInterface>.

diff --git a/Bugzilla/Field/ChoiceInterface.pm b/Bugzilla/Field/ChoiceInterface.pm
new file mode 100644 (file)
index 0000000..b2f1bff
--- /dev/null
+++ b/Bugzilla/Field/ChoiceInterface.pm
@@ -0,0 +1,271 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Field::ChoiceInterface;
+use strict;
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Field;
+
+use Scalar::Util qw(blessed);
+
+# Helps implement the "field" accessor without subclasses having to
+# write code.
+sub FIELD_NAME { return $_[0]->DB_TABLE; }
+
+####################
+# Subclass Helpers #
+####################
+
+sub _check_if_controller {
+    my $self = shift;
+    my $vis_fields = $self->controls_visibility_of_fields;
+    my $values = $self->controlled_values_array;
+    if (@$vis_fields || @$values) {
+        ThrowUserError('fieldvalue_is_controller',
+            { value => $self, fields => [map($_->name, @$vis_fields)],
+              vals => $self->controlled_values });
+    }
+}
+
+
+#############
+# Accessors #
+#############
+
+sub is_active { return $_[0]->{'isactive'}; }
+sub sortkey   { return $_[0]->{'sortkey'};  }
+
+sub bug_count {
+    my $self = shift;
+    return $self->{bug_count} if defined $self->{bug_count};
+    my $dbh = Bugzilla->dbh;
+    my $fname = $self->field->name;
+    my $count;
+    if ($self->field->type == FIELD_TYPE_MULTI_SELECT) {
+        $count = $dbh->selectrow_array("SELECT COUNT(*) FROM bug_$fname
+                                         WHERE value = ?", undef, $self->name);
+    }
+    else {
+        $count = $dbh->selectrow_array("SELECT COUNT(*) FROM bugs 
+                                         WHERE $fname = ?",
+                                       undef, $self->name);
+    }
+    $self->{bug_count} = $count;
+    return $count;
+}
+
+sub field {
+    my $invocant = shift;
+    my $class = ref $invocant || $invocant;
+    my $cache = Bugzilla->request_cache;
+    # This is just to make life easier for subclasses. Our auto-generated
+    # subclasses from Bugzilla::Field::Choice->type() already have this set.
+    $cache->{"field_$class"} ||=  
+        new Bugzilla::Field({ name => $class->FIELD_NAME });
+    return $cache->{"field_$class"};
+}
+
+sub is_default {
+    my $self = shift;
+    my $name = $self->DEFAULT_MAP->{$self->field->name};
+    # If it doesn't exist in DEFAULT_MAP, then there is no parameter
+    # related to this field.
+    return 0 unless $name;
+    return ($self->name eq Bugzilla->params->{$name}) ? 1 : 0;
+}
+
+sub is_static {
+    my $self = shift;
+    # If we need to special-case Resolution for *anything* else, it should
+    # get its own subclass.
+    if ($self->field->name eq 'resolution') {
+        return grep($_ eq $self->name, ('', 'FIXED', 'DUPLICATE'))
+               ? 1 : 0;
+    }
+    elsif ($self->field->custom) {
+        return $self->name eq '---' ? 1 : 0;
+    }
+    return 0;
+}
+
+sub controls_visibility_of_fields {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    if (!$self->{controls_visibility_of_fields}) {
+        my $ids = $dbh->selectcol_arrayref(
+            "SELECT id FROM fielddefs
+               INNER JOIN field_visibility
+                 ON fielddefs.id = field_visibility.field_id
+             WHERE value_id = ? AND visibility_field_id = ?", undef,
+            $self->id, $self->field->id);
+
+        $self->{controls_visibility_of_fields} =
+            Bugzilla::Field->new_from_list($ids);
+   }
+
+   return $self->{controls_visibility_of_fields};
+}
+
+sub visibility_value {
+    my $self = shift;
+    if ($self->{visibility_value_id}) {
+        require Bugzilla::Field::Choice;
+        $self->{visibility_value} ||=
+            Bugzilla::Field::Choice->type($self->field->value_field)->new(
+                $self->{visibility_value_id});
+    }
+    return $self->{visibility_value};
+}
+
+sub controlled_values {
+    my $self = shift;
+    return $self->{controlled_values} if defined $self->{controlled_values};
+    my $fields = $self->field->controls_values_of;
+    my %controlled_values;
+    require Bugzilla::Field::Choice;
+    foreach my $field (@$fields) {
+        $controlled_values{$field->name} = 
+            Bugzilla::Field::Choice->type($field)
+            ->match({ visibility_value_id => $self->id });
+    }
+    $self->{controlled_values} = \%controlled_values;
+    return $self->{controlled_values};
+}
+
+sub controlled_values_array {
+    my ($self) = @_;
+    my $values = $self->controlled_values;
+    return [map { @{ $values->{$_} } } keys %$values];
+}
+
+sub is_visible_on_bug {
+    my ($self, $bug) = @_;
+
+    # Values currently set on the bug are always shown.
+    return 1 if $self->is_set_on_bug($bug);
+
+    # Inactive values are, otherwise, never shown.
+    return 0 if !$self->is_active;
+
+    # Values without a visibility value are, otherwise, always shown.
+    my $visibility_value = $self->visibility_value;
+    return 1 if !$visibility_value;
+
+    # Values with a visibility value are only shown if the visibility
+    # value is set on the bug.
+    return $visibility_value->is_set_on_bug($bug); 
+}
+
+sub is_set_on_bug {
+    my ($self, $bug) = @_;
+    my $field_name = $self->FIELD_NAME;
+    # This allows bug/create/create.html.tmpl to pass in a hashref that 
+    # looks like a bug object.
+    my $value = blessed($bug) ? $bug->$field_name : $bug->{$field_name};
+    $value = $value->name if blessed($value);
+    return 0 if !defined $value;
+
+    if ($self->field->type == FIELD_TYPE_BUG_URLS
+        or $self->field->type == FIELD_TYPE_MULTI_SELECT)
+    {
+        return grep($_ eq $self->name, @$value) ? 1 : 0;
+    }
+    return $value eq $self->name ? 1 : 0;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Field::ChoiceInterface - Makes an object act like a
+Bugzilla::Field::Choice.
+
+=head1 DESCRIPTION
+
+This is an "interface", in the Java sense (sometimes called a "Role"
+or a "Mixin" in other languages). L<Bugzilla::Field::Choice> is the
+primary implementor of this interface, but other classes also implement
+it if they want to "act like" L<Bugzilla::Field::Choice>.
+
+=head1 METHODS
+
+=head2 Accessors
+
+These are in addition to the standard L<Bugzilla::Object> accessors.
+
+=over
+
+=item C<sortkey>
+
+The key that determines the sort order of this item.
+
+=item C<field>
+
+The L<Bugzilla::Field> object that this field value belongs to.
+
+=item C<is_active>
+
+Whether or not this value should appear as an option on bugs that do
+not already have it set as the current value.
+
+=item C<is_static>
+
+C<0> if this field value can be renamed or deleted, C<1> otherwise.
+
+=item C<is_default>
+
+C<1> if this is the default value for this field, C<0> otherwise.
+
+=item C<bug_count>
+
+An integer count of the number of bugs that have this value set.
+
+=item C<controls_visibility_of_fields>
+
+Returns an arrayref of L<Bugzilla::Field> objects, representing any
+fields whose visibility are controlled by this field value.
+
+=item C<controlled_values>
+
+Tells you which values in B<other> fields appear (become visible) when this
+value is set in its field.
+
+Returns a hashref of arrayrefs. The hash keys are the names of fields,
+and the values are arrays of objects that implement
+C<Bugzilla::Field::ChoiceInterface>, representing values that this value 
+controls the visibility of, for that field.
+
+=item C<visibility_value>
+
+Returns an object that implements C<Bugzilla::Field::ChoiceInterface>,
+which represents the value that needs to be set in order for this
+value to appear in the UI.
+
+=item C<is_visible_on_bug>
+
+Returns C<1> if, according to the settings of C<is_active> and 
+C<visibility_value>, this value should be displayed as an option
+when viewing a bug. Returns C<0> otherwise.
+
+Takes a single argument, a L<Bugzilla::Bug> object or a hash with
+similar fields to a L<Bugzilla::Bug> object.
+
+=item C<is_set_on_bug>
+
+Returns C<1> if this value is the current value set for its field on
+the passed-in L<Bugzilla::Bug> object (or a hash that looks like a
+L<Bugzilla::Bug>). For multi-valued fields, we return C<1> if
+I<any> of the currently selected values are this value.
+
+Returns C<0> otherwise.
+
+=back

diff --git a/Bugzilla/Flag.pm b/Bugzilla/Flag.pm
new file mode 100644 (file)
index 0000000..a1b8c2c
--- /dev/null
+++ b/Bugzilla/Flag.pm
@@ -0,0 +1,1066 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+package Bugzilla::Flag;
+
+=head1 NAME
+
+Bugzilla::Flag - A module to deal with Bugzilla flag values.
+
+=head1 SYNOPSIS
+
+Flag.pm provides an interface to flags as stored in Bugzilla.
+See below for more information.
+
+=head1 NOTES
+
+=over
+
+=item *
+
+Import relevant functions from that script.
+
+=item *
+
+Use of private functions / variables outside this module may lead to
+unexpected results after an upgrade.  Please avoid using private
+functions in other files/modules.  Private functions are functions
+whose names start with _ or a re specifically noted as being private.
+
+=back
+
+=cut
+
+use Scalar::Util qw(blessed);
+use Storable qw(dclone);
+
+use Bugzilla::FlagType;
+use Bugzilla::Hook;
+use Bugzilla::User;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Mailer;
+use Bugzilla::Constants;
+use Bugzilla::Field;
+
+use base qw(Bugzilla::Object Exporter);
+@Bugzilla::Flag::EXPORT = qw(SKIP_REQUESTEE_ON_ERROR);
+
+###############################
+####    Initialization     ####
+###############################
+
+use constant DB_TABLE => 'flags';
+use constant LIST_ORDER => 'id';
+# Flags are tracked in bugs_activity.
+use constant AUDIT_CREATES => 0;
+use constant AUDIT_UPDATES => 0;
+use constant AUDIT_REMOVES => 0;
+
+use constant SKIP_REQUESTEE_ON_ERROR => 1;
+
+sub DB_COLUMNS {
+    my $dbh = Bugzilla->dbh;
+    return qw(
+        id
+        type_id
+        bug_id
+        attach_id
+        requestee_id
+        setter_id
+        status), 
+        $dbh->sql_date_format('creation_date', '%Y.%m.%d %H:%i:%s') .
+                              ' AS creation_date', 
+        $dbh->sql_date_format('modification_date', '%Y.%m.%d %H:%i:%s') .
+                              ' AS modification_date';
+}
+
+use constant UPDATE_COLUMNS => qw(
+    requestee_id
+    setter_id
+    status
+    type_id
+);
+
+use constant VALIDATORS => {
+};
+
+use constant UPDATE_VALIDATORS => {
+    setter => \&_check_setter,
+    status => \&_check_status,
+};
+
+###############################
+####      Accessors      ######
+###############################
+
+=head2 METHODS
+
+=over
+
+=item C<id>
+
+Returns the ID of the flag.
+
+=item C<name>
+
+Returns the name of the flagtype the flag belongs to.
+
+=item C<bug_id>
+
+Returns the ID of the bug this flag belongs to.
+
+=item C<attach_id>
+
+Returns the ID of the attachment this flag belongs to, if any.
+
+=item C<status>
+
+Returns the status '+', '-', '?' of the flag.
+
+=item C<creation_date>
+
+Returns the timestamp when the flag was created.
+
+=item C<modification_date>
+
+Returns the timestamp when the flag was last modified.
+
+=back
+
+=cut
+
+sub id           { return $_[0]->{'id'};           }
+sub name         { return $_[0]->type->name;       }
+sub type_id      { return $_[0]->{'type_id'};      }
+sub bug_id       { return $_[0]->{'bug_id'};       }
+sub attach_id    { return $_[0]->{'attach_id'};    }
+sub status       { return $_[0]->{'status'};       }
+sub setter_id    { return $_[0]->{'setter_id'};    }
+sub requestee_id { return $_[0]->{'requestee_id'}; }
+sub creation_date     { return $_[0]->{'creation_date'};     }
+sub modification_date { return $_[0]->{'modification_date'}; }
+
+###############################
+####       Methods         ####
+###############################
+
+=pod
+
+=over
+
+=item C<type>
+
+Returns the type of the flag, as a Bugzilla::FlagType object.
+
+=item C<setter>
+
+Returns the user who set the flag, as a Bugzilla::User object.
+
+=item C<requestee>
+
+Returns the user who has been requested to set the flag, as a
+Bugzilla::User object.
+
+=item C<attachment>
+
+Returns the attachment object the flag belongs to if the flag
+is an attachment flag, else undefined.
+
+=back
+
+=cut
+
+sub type {
+    my $self = shift;
+
+    $self->{'type'} ||= new Bugzilla::FlagType($self->{'type_id'});
+    return $self->{'type'};
+}
+
+sub setter {
+    my $self = shift;
+
+    $self->{'setter'} ||= new Bugzilla::User($self->{'setter_id'});
+    return $self->{'setter'};
+}
+
+sub requestee {
+    my $self = shift;
+
+    if (!defined $self->{'requestee'} && $self->{'requestee_id'}) {
+        $self->{'requestee'} = new Bugzilla::User($self->{'requestee_id'});
+    }
+    return $self->{'requestee'};
+}
+
+sub attachment {
+    my $self = shift;
+    return undef unless $self->attach_id;
+
+    require Bugzilla::Attachment;
+    $self->{'attachment'} ||= new Bugzilla::Attachment($self->attach_id);
+    return $self->{'attachment'};
+}
+
+sub bug {
+    my $self = shift;
+
+    require Bugzilla::Bug;
+    $self->{'bug'} ||= new Bugzilla::Bug($self->bug_id);
+    return $self->{'bug'};
+}
+
+################################
+## Searching/Retrieving Flags ##
+################################
+
+=pod
+
+=over
+
+=item C<match($criteria)>
+
+Queries the database for flags matching the given criteria
+(specified as a hash of field names and their matching values)
+and returns an array of matching records.
+
+=back
+
+=cut
+
+sub match {
+    my $class = shift;
+    my ($criteria) = @_;
+
+    # If the caller specified only bug or attachment flags,
+    # limit the query to those kinds of flags.
+    if (my $type = delete $criteria->{'target_type'}) {
+        if ($type eq 'bug') {
+            $criteria->{'attach_id'} = IS_NULL;
+        }
+        elsif (!defined $criteria->{'attach_id'}) {
+            $criteria->{'attach_id'} = NOT_NULL;
+        }
+    }
+    # Flag->snapshot() calls Flag->match() with bug_id and attach_id
+    # as hash keys, even if attach_id is undefined.
+    if (exists $criteria->{'attach_id'} && !defined $criteria->{'attach_id'}) {
+        $criteria->{'attach_id'} = IS_NULL;
+    }
+
+    return $class->SUPER::match(@_);
+}
+
+=pod
+
+=over
+
+=item C<count($criteria)>
+
+Queries the database for flags matching the given criteria
+(specified as a hash of field names and their matching values)
+and returns an array of matching records.
+
+=back
+
+=cut
+
+sub count {
+    my $class = shift;
+    return scalar @{$class->match(@_)};
+}
+
+######################################################################
+# Creating and Modifying
+######################################################################
+
+sub set_flag {
+    my ($class, $obj, $params) = @_;
+
+    my ($bug, $attachment, $obj_flag, $requestee_changed);
+    if (blessed($obj) && $obj->isa('Bugzilla::Attachment')) {
+        $attachment = $obj;
+        $bug = $attachment->bug;
+    }
+    elsif (blessed($obj) && $obj->isa('Bugzilla::Bug')) {
+        $bug = $obj;
+    }
+    else {
+        ThrowCodeError('flag_unexpected_object', { 'caller' => ref $obj });
+    }
+
+    # Make sure the user can change flags
+    my $privs;
+    $bug->check_can_change_field('flagtypes.name', 0, 1, \$privs)
+        || ThrowUserError('illegal_change',
+                          { field => 'flagtypes.name', privs => $privs });
+
+    # Update (or delete) an existing flag.
+    if ($params->{id}) {
+        my $flag = $class->check({ id => $params->{id} });
+
+        # Security check: make sure the flag belongs to the bug/attachment.
+        # We don't check that the user editing the flag can see
+        # the bug/attachment. That's the job of the caller.
+        ($attachment && $flag->attach_id && $attachment->id == $flag->attach_id)
+          || (!$attachment && !$flag->attach_id && $bug->id == $flag->bug_id)
+          || ThrowCodeError('invalid_flag_association',
+                            { bug_id    => $bug->id,
+                              attach_id => $attachment ? $attachment->id : undef });
+
+        # Extract the current flag object from the object.
+        my ($obj_flagtype) = grep { $_->id == $flag->type_id } @{$obj->flag_types};
+        # If no flagtype can be found for this flag, this means the bug is being
+        # moved into a product/component where the flag is no longer valid.
+        # So either we can attach the flag to another flagtype having the same
+        # name, or we remove the flag.
+        if (!$obj_flagtype) {
+            my $success = $flag->retarget($obj);
+            return unless $success;
+
+            ($obj_flagtype) = grep { $_->id == $flag->type_id } @{$obj->flag_types};
+            push(@{$obj_flagtype->{flags}}, $flag);
+        }
+        ($obj_flag) = grep { $_->id == $flag->id } @{$obj_flagtype->{flags}};
+        # If the flag has the correct type but cannot be found above, this means
+        # the flag is going to be removed (e.g. because this is a pending request
+        # and the attachment is being marked as obsolete).
+        return unless $obj_flag;
+
+        ($obj_flag, $requestee_changed) =
+            $class->_validate($obj_flag, $obj_flagtype, $params, $bug, $attachment);
+    }
+    # Create a new flag.
+    elsif ($params->{type_id}) {
+        # Don't bother validating types the user didn't touch.
+        return if $params->{status} eq 'X';
+
+        my $flagtype = Bugzilla::FlagType->check({ id => $params->{type_id} });
+        # Security check: make sure the flag type belongs to the bug/attachment.
+        ($attachment && $flagtype->target_type eq 'attachment'
+          && scalar(grep { $_->id == $flagtype->id } @{$attachment->flag_types}))
+          || (!$attachment && $flagtype->target_type eq 'bug'
+                && scalar(grep { $_->id == $flagtype->id } @{$bug->flag_types}))
+          || ThrowCodeError('invalid_flag_association',
+                            { bug_id    => $bug->id,
+                              attach_id => $attachment ? $attachment->id : undef });
+
+        # Make sure the flag type is active.
+        $flagtype->is_active
+          || ThrowCodeError('flag_type_inactive', { type => $flagtype->name });
+
+        # Extract the current flagtype object from the object.
+        my ($obj_flagtype) = grep { $_->id == $flagtype->id } @{$obj->flag_types};
+
+        # We cannot create a new flag if there is already one and this
+        # flag type is not multiplicable.
+        if (!$flagtype->is_multiplicable) {
+            if (scalar @{$obj_flagtype->{flags}}) {
+                ThrowUserError('flag_type_not_multiplicable', { type => $flagtype });
+            }
+        }
+
+        ($obj_flag, $requestee_changed) =
+            $class->_validate(undef, $obj_flagtype, $params, $bug, $attachment);
+    }
+    else {
+        ThrowCodeError('param_required', { function => $class . '->set_flag',
+                                           param    => 'id/type_id' });
+    }
+
+    if ($obj_flag
+        && $requestee_changed
+        && $obj_flag->requestee_id
+        && $obj_flag->requestee->setting('requestee_cc') eq 'on')
+    {
+        $bug->add_cc($obj_flag->requestee);
+    }
+}
+
+sub _validate {
+    my ($class, $flag, $flag_type, $params, $bug, $attachment) = @_;
+
+    # If it's a new flag, let's create it now.
+    my $obj_flag = $flag || bless({ type_id   => $flag_type->id,
+                                    status    => '',
+                                    bug_id    => $bug->id,
+                                    attach_id => $attachment ?
+                                                   $attachment->id : undef},
+                                    $class);
+
+    my $old_status = $obj_flag->status;
+    my $old_requestee_id = $obj_flag->requestee_id;
+
+    $obj_flag->_set_status($params->{status});
+    $obj_flag->_set_requestee($params->{requestee}, $attachment, $params->{skip_roe});
+
+    # The requestee ID can be undefined.
+    my $requestee_changed = ($obj_flag->requestee_id || 0) != ($old_requestee_id || 0);
+
+    # The setter field MUST NOT be updated if neither the status
+    # nor the requestee fields changed.
+    if (($obj_flag->status ne $old_status) || $requestee_changed) {
+        $obj_flag->_set_setter($params->{setter});
+    }
+
+    # If the flag is deleted, remove it from the list.
+    if ($obj_flag->status eq 'X') {
+        @{$flag_type->{flags}} = grep { $_->id != $obj_flag->id } @{$flag_type->{flags}};
+        return;
+    }
+    # Add the newly created flag to the list.
+    elsif (!$obj_flag->id) {
+        push(@{$flag_type->{flags}}, $obj_flag);
+    }
+    return wantarray ? ($obj_flag, $requestee_changed) : $obj_flag;
+}
+
+=pod
+
+=over
+
+=item C<create($flag, $timestamp)>
+
+Creates a flag record in the database.
+
+=back
+
+=cut
+
+sub create {
+    my ($class, $flag, $timestamp) = @_;
+    $timestamp ||= Bugzilla->dbh->selectrow_array('SELECT LOCALTIMESTAMP(0)');
+
+    my $params = {};
+    my @columns = grep { $_ ne 'id' } $class->_get_db_columns;
+
+    # Some columns use date formatting so use alias instead
+    @columns = map { /\s+AS\s+(.*)$/ ? $1 : $_ } @columns;
+
+    $params->{$_} = $flag->{$_} foreach @columns;
+
+    $params->{creation_date} = $params->{modification_date} = $timestamp;
+
+    $flag = $class->SUPER::create($params);
+    return $flag;
+}
+
+sub update {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+    my $timestamp = shift || $dbh->selectrow_array('SELECT NOW()');
+
+    my $changes = $self->SUPER::update(@_);
+
+    if (scalar(keys %$changes)) {
+        $dbh->do('UPDATE flags SET modification_date = ? WHERE id = ?',
+                 undef, ($timestamp, $self->id));
+        $self->{'modification_date'} = format_time($timestamp, '%Y.%m.%d %T');
+    }
+    return $changes;
+}
+
+sub snapshot {
+    my ($class, $flags) = @_;
+
+    my @summaries;
+    foreach my $flag (@$flags) {
+        my $summary = $flag->setter->nick . ':' . $flag->type->name . $flag->status;
+        $summary .= "(" . $flag->requestee->login . ")" if $flag->requestee;
+        push(@summaries, $summary);
+    }
+    return @summaries;
+}
+
+sub update_activity {
+    my ($class, $old_summaries, $new_summaries) = @_;
+
+    my ($removed, $added) = diff_arrays($old_summaries, $new_summaries);
+    if (scalar @$removed || scalar @$added) {
+        # Remove flag requester/setter information
+        foreach (@$removed, @$added) { s/^[^:]+:// }
+
+        $removed = join(", ", @$removed);
+        $added = join(", ", @$added);
+        return ($removed, $added);
+    }
+    return ();
+}
+
+sub update_flags {
+    my ($class, $self, $old_self, $timestamp) = @_;
+
+    my @old_summaries = $class->snapshot($old_self->flags);
+    my %old_flags = map { $_->id => $_ } @{$old_self->flags};
+
+    foreach my $new_flag (@{$self->flags}) {
+        if (!$new_flag->id) {
+            # This is a new flag.
+            my $flag = $class->create($new_flag, $timestamp);
+            $new_flag->{id} = $flag->id;
+            $class->notify($new_flag, undef, $self, $timestamp);
+        }
+        else {
+            my $changes = $new_flag->update($timestamp);
+            if (scalar(keys %$changes)) {
+                $class->notify($new_flag, $old_flags{$new_flag->id}, $self, $timestamp);
+            }
+            delete $old_flags{$new_flag->id};
+        }
+    }
+    # These flags have been deleted.
+    foreach my $old_flag (values %old_flags) {
+        $class->notify(undef, $old_flag, $self, $timestamp);
+        $old_flag->remove_from_db();
+    }
+
+    # If the bug has been moved into another product or component,
+    # we must also take care of attachment flags which are no longer valid,
+    # as well as all bug flags which haven't been forgotten above.
+    if ($self->isa('Bugzilla::Bug')
+        && ($self->{_old_product_name} || $self->{_old_component_name}))
+    {
+        my @removed = $class->force_cleanup($self);
+        push(@old_summaries, @removed);
+    }
+
+    my @new_summaries = $class->snapshot($self->flags);
+    my @changes = $class->update_activity(\@old_summaries, \@new_summaries);
+
+    Bugzilla::Hook::process('flag_end_of_update', { object    => $self,
+                                                    timestamp => $timestamp,
+                                                    old_flags => \@old_summaries,
+                                                    new_flags => \@new_summaries,
+                                                  });
+    return @changes;
+}
+
+sub retarget {
+    my ($self, $obj) = @_;
+
+    my @flagtypes = grep { $_->name eq $self->type->name } @{$obj->flag_types};
+
+    my $success = 0;
+    foreach my $flagtype (@flagtypes) {
+        next if !$flagtype->is_active;
+        next if (!$flagtype->is_multiplicable && scalar @{$flagtype->{flags}});
+        next unless (($self->status eq '?' && $self->setter->can_request_flag($flagtype))
+                     || $self->setter->can_set_flag($flagtype));
+
+        $self->{type_id} = $flagtype->id;
+        delete $self->{type};
+        $success = 1;
+        last;
+    }
+    return $success;
+}
+
+# In case the bug's product/component has changed, clear flags that are
+# no longer valid.
+sub force_cleanup {
+    my ($class, $bug) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    my $flag_ids = $dbh->selectcol_arrayref(
+        'SELECT DISTINCT flags.id
+           FROM flags
+          INNER JOIN bugs
+                ON flags.bug_id = bugs.bug_id
+           LEFT JOIN flaginclusions AS i
+                ON flags.type_id = i.type_id
+                AND (bugs.product_id = i.product_id OR i.product_id IS NULL)
+                AND (bugs.component_id = i.component_id OR i.component_id IS NULL)
+          WHERE bugs.bug_id = ? AND i.type_id IS NULL',
+         undef, $bug->id);
+
+    my @removed = $class->force_retarget($flag_ids, $bug);
+
+    $flag_ids = $dbh->selectcol_arrayref(
+        'SELECT DISTINCT flags.id
+           FROM flags, bugs, flagexclusions e
+          WHERE bugs.bug_id = ?
+                AND flags.bug_id = bugs.bug_id
+                AND flags.type_id = e.type_id
+                AND (bugs.product_id = e.product_id OR e.product_id IS NULL)
+                AND (bugs.component_id = e.component_id OR e.component_id IS NULL)',
+         undef, $bug->id);
+
+    push(@removed , $class->force_retarget($flag_ids, $bug));
+    return @removed;
+}
+
+sub force_retarget {
+    my ($class, $flag_ids, $bug) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    my $flags = $class->new_from_list($flag_ids);
+    my @removed;
+    foreach my $flag (@$flags) {
+        # $bug is undefined when e.g. editing inclusion and exclusion lists.
+        my $obj = $flag->attachment || $bug || $flag->bug;
+        my $is_retargetted = $flag->retarget($obj);
+        if ($is_retargetted) {
+            $dbh->do('UPDATE flags SET type_id = ? WHERE id = ?',
+                     undef, ($flag->type_id, $flag->id));
+        }
+        else {
+            # Track deleted attachment flags.
+            push(@removed, $class->snapshot([$flag])) if $flag->attach_id;
+            $class->notify(undef, $flag, $bug || $flag->bug);
+            $flag->remove_from_db();
+        }
+    }
+    return @removed;
+}
+
+###############################
+####      Validators     ######
+###############################
+
+sub _set_requestee {
+    my ($self, $requestee, $attachment, $skip_requestee_on_error) = @_;
+
+    $self->{requestee} =
+      $self->_check_requestee($requestee, $attachment, $skip_requestee_on_error);
+
+    $self->{requestee_id} =
+      $self->{requestee} ? $self->{requestee}->id : undef;
+}
+
+sub _set_setter {
+    my ($self, $setter) = @_;
+
+    $self->set('setter', $setter);
+    $self->{setter_id} = $self->setter->id;
+}
+
+sub _set_status {
+    my ($self, $status) = @_;
+
+    # Store the old flag status. It's needed by _check_setter().
+    $self->{_old_status} = $self->status;
+    $self->set('status', $status);
+}
+
+sub _check_requestee {
+    my ($self, $requestee, $attachment, $skip_requestee_on_error) = @_;
+
+    # If the flag status is not "?", then no requestee can be defined.
+    return undef if ($self->status ne '?');
+
+    # Store this value before updating the flag object.
+    my $old_requestee = $self->requestee ? $self->requestee->login : '';
+
+    if ($self->status eq '?' && $requestee) {
+        $requestee = Bugzilla::User->check($requestee);
+    }
+    else {
+        undef $requestee;
+    }
+
+    if ($requestee && $requestee->login ne $old_requestee) {
+        # Make sure the user didn't specify a requestee unless the flag
+        # is specifically requestable. For existing flags, if the requestee
+        # was set before the flag became specifically unrequestable, the
+        # user can either remove him or leave him alone.
+        ThrowUserError('flag_requestee_disabled', { type => $self->type })
+          if !$self->type->is_requesteeble;
+
+        # Make sure the requestee can see the bug.
+        # Note that can_see_bug() will query the DB, so if the bug
+        # is being added/removed from some groups and these changes
+        # haven't been committed to the DB yet, they won't be taken
+        # into account here. In this case, old restrictions matters.
+        if (!$requestee->can_see_bug($self->bug_id)) {
+            if ($skip_requestee_on_error) {
+                undef $requestee;
+            }
+            else {
+                ThrowUserError('flag_requestee_unauthorized',
+                               { flag_type  => $self->type,
+                                 requestee  => $requestee,
+                                 bug_id     => $self->bug_id,
+                                 attach_id  => $self->attach_id });
+            }
+        }
+        # Make sure the requestee can see the private attachment.
+        elsif ($self->attach_id && $attachment->isprivate && !$requestee->is_insider) {
+            if ($skip_requestee_on_error) {
+                undef $requestee;
+            }
+            else {
+                ThrowUserError('flag_requestee_unauthorized_attachment',
+                               { flag_type  => $self->type,
+                                 requestee  => $requestee,
+                                 bug_id     => $self->bug_id,
+                                 attach_id  => $self->attach_id });
+            }
+        }
+        # Make sure the user is allowed to set the flag.
+        elsif (!$requestee->can_set_flag($self->type)) {
+            if ($skip_requestee_on_error) {
+                undef $requestee;
+            }
+            else {
+                ThrowUserError('flag_requestee_needs_privs',
+                               {'requestee' => $requestee,
+                                'flagtype'  => $self->type});
+            }
+        }
+    }
+    return $requestee;
+}
+
+sub _check_setter {
+    my ($self, $setter) = @_;
+
+    # By default, the currently logged in user is the setter.
+    $setter ||= Bugzilla->user;
+    (blessed($setter) && $setter->isa('Bugzilla::User') && $setter->id)
+      || ThrowUserError('invalid_user');
+
+    # set_status() has already been called. So this refers
+    # to the new flag status.
+    my $status = $self->status;
+
+    # Make sure the user is authorized to modify flags, see bug 180879:
+    # - The flag exists and is unchanged.
+    # - The flag setter can unset flag.
+    # - Users in the request_group can clear pending requests and set flags
+    #   and can rerequest set flags.
+    # - Users in the grant_group can set/clear flags, including "+" and "-".
+    unless (($status eq $self->{_old_status})
+            || ($status eq 'X' && $setter->id == Bugzilla->user->id)
+            || (($status eq 'X' || $status eq '?')
+                && $setter->can_request_flag($self->type))
+            || $setter->can_set_flag($self->type))
+    {
+        ThrowUserError('flag_update_denied',
+                        { name       => $self->type->name,
+                          status     => $status,
+                          old_status => $self->{_old_status} });
+    }
+
+    # If the request is being retargetted, we don't update
+    # the setter, so that the setter gets the notification.
+    if ($status eq '?' && $self->{_old_status} eq '?') {
+        return $self->setter;
+    }
+    return $setter;
+}
+
+sub _check_status {
+    my ($self, $status) = @_;
+
+    # - Make sure the status is valid.
+    # - Make sure the user didn't request the flag unless it's requestable.
+    #   If the flag existed and was requested before it became unrequestable,
+    #   leave it as is.
+    if (!grep($status eq $_ , qw(X + - ?))
+        || ($status eq '?' && $self->status ne '?' && !$self->type->is_requestable))
+    {
+        ThrowUserError('flag_status_invalid', { id     => $self->id,
+                                                status => $status });
+    }
+    return $status;
+}
+
+######################################################################
+# Utility Functions
+######################################################################
+
+=pod
+
+=over
+
+=item C<extract_flags_from_cgi($bug, $attachment, $hr_vars)>
+
+Checks whether or not there are new flags to create and returns an
+array of hashes. This array is then passed to Flag::create().
+
+=back
+
+=cut
+
+sub extract_flags_from_cgi {
+    my ($class, $bug, $attachment, $vars, $skip) = @_;
+    my $cgi = Bugzilla->cgi;
+
+    my $match_status = Bugzilla::User::match_field({
+        '^requestee(_type)?-(\d+)$' => { 'type' => 'multi' },
+    }, undef, $skip);
+
+    $vars->{'match_field'} = 'requestee';
+    if ($match_status == USER_MATCH_FAILED) {
+        $vars->{'message'} = 'user_match_failed';
+    }
+    elsif ($match_status == USER_MATCH_MULTIPLE) {
+        $vars->{'message'} = 'user_match_multiple';
+    }
+
+    # Extract a list of flag type IDs from field names.
+    my @flagtype_ids = map(/^flag_type-(\d+)$/ ? $1 : (), $cgi->param());
+    @flagtype_ids = grep($cgi->param("flag_type-$_") ne 'X', @flagtype_ids);
+
+    # Extract a list of existing flag IDs.
+    my @flag_ids = map(/^flag-(\d+)$/ ? $1 : (), $cgi->param());
+
+    return () if (!scalar(@flagtype_ids) && !scalar(@flag_ids));
+
+    my (@new_flags, @flags);
+    foreach my $flag_id (@flag_ids) {
+        my $flag = $class->new($flag_id);
+        # If the flag no longer exists, ignore it.
+        next unless $flag;
+
+        my $status = $cgi->param("flag-$flag_id");
+
+        # If the user entered more than one name into the requestee field
+        # (i.e. they want more than one person to set the flag) we can reuse
+        # the existing flag for the first person (who may well be the existing
+        # requestee), but we have to create new flags for each additional requestee.
+        my @requestees = $cgi->param("requestee-$flag_id");
+        my $requestee_email;
+        if ($status eq "?"
+            && scalar(@requestees) > 1
+            && $flag->type->is_multiplicable)
+        {
+            # The first person, for which we'll reuse the existing flag.
+            $requestee_email = shift(@requestees);
+
+            # Create new flags like the existing one for each additional person.
+            foreach my $login (@requestees) {
+                push(@new_flags, { type_id   => $flag->type_id,
+                                   status    => "?",
+                                   requestee => $login,
+                                   skip_roe  => $skip });
+            }
+        }
+        elsif ($status eq "?" && scalar(@requestees)) {
+            # If there are several requestees and the flag type is not multiplicable,
+            # this will fail. But that's the job of the validator to complain. All
+            # we do here is to extract and convert data from the CGI.
+            $requestee_email = trim($cgi->param("requestee-$flag_id") || '');
+        }
+
+        push(@flags, { id        => $flag_id,
+                       status    => $status,
+                       requestee => $requestee_email,
+                       skip_roe  => $skip });
+    }
+
+    # Get a list of active flag types available for this product/component.
+    my $flag_types = Bugzilla::FlagType::match(
+        { 'product_id'   => $bug->{'product_id'},
+          'component_id' => $bug->{'component_id'},
+          'is_active'    => 1 });
+
+    foreach my $flagtype_id (@flagtype_ids) {
+        # Checks if there are unexpected flags for the product/component.
+        if (!scalar(grep { $_->id == $flagtype_id } @$flag_types)) {
+            $vars->{'message'} = 'unexpected_flag_types';
+            last;
+        }
+    }
+
+    foreach my $flag_type (@$flag_types) {
+        my $type_id = $flag_type->id;
+
+        # Bug flags are only valid for bugs, and attachment flags are
+        # only valid for attachments. So don't mix both.
+        next unless ($flag_type->target_type eq 'bug' xor $attachment);
+
+        # We are only interested in flags the user tries to create.
+        next unless scalar(grep { $_ == $type_id } @flagtype_ids);
+
+        # Get the number of flags of this type already set for this target.
+        my $has_flags = $class->count(
+            { 'type_id'     => $type_id,
+              'target_type' => $attachment ? 'attachment' : 'bug',
+              'bug_id'      => $bug->bug_id,
+              'attach_id'   => $attachment ? $attachment->id : undef });
+
+        # Do not create a new flag of this type if this flag type is
+        # not multiplicable and already has a flag set.
+        next if (!$flag_type->is_multiplicable && $has_flags);
+
+        my $status = $cgi->param("flag_type-$type_id");
+        trick_taint($status);
+
+        my @logins = $cgi->param("requestee_type-$type_id");
+        if ($status eq "?" && scalar(@logins)) {
+            foreach my $login (@logins) {
+                push (@new_flags, { type_id   => $type_id,
+                                    status    => $status,
+                                    requestee => $login,
+                                    skip_roe  => $skip });
+                last unless $flag_type->is_multiplicable;
+            }
+        }
+        else {
+            push (@new_flags, { type_id => $type_id,
+                                status  => $status });
+        }
+    }
+
+    # Return the list of flags to update and/or to create.
+    return (\@flags, \@new_flags);
+}
+
+=pod
+
+=over
+
+=item C<notify($flag, $old_flag, $object, $timestamp)>
+
+Sends an email notification about a flag being created, fulfilled
+or deleted.
+
+=back
+
+=cut
+
+sub notify {
+    my ($class, $flag, $old_flag, $obj, $timestamp) = @_;
+
+    my ($bug, $attachment);
+    if (blessed($obj) && $obj->isa('Bugzilla::Attachment')) {
+        $attachment = $obj;
+        $bug = $attachment->bug;
+    }
+    elsif (blessed($obj) && $obj->isa('Bugzilla::Bug')) {
+        $bug = $obj;
+    }
+    else {
+        # Not a good time to throw an error.
+        return;
+    }
+
+    my $addressee;
+    # If the flag is set to '?', maybe the requestee wants a notification.
+    if ($flag && $flag->requestee_id
+        && (!$old_flag || ($old_flag->requestee_id || 0) != $flag->requestee_id))
+    {
+        if ($flag->requestee->wants_mail([EVT_FLAG_REQUESTED])) {
+            $addressee = $flag->requestee;
+        }
+    }
+    elsif ($old_flag && $old_flag->status eq '?'
+           && (!$flag || $flag->status ne '?'))
+    {
+        if ($old_flag->setter->wants_mail([EVT_REQUESTED_FLAG])) {
+            $addressee = $old_flag->setter;
+        }
+    }
+
+    my $cc_list = $flag ? $flag->type->cc_list : $old_flag->type->cc_list;
+    # Is there someone to notify?
+    return unless ($addressee || $cc_list);
+
+    # The email client will display the Date: header in the desired timezone,
+    # so we can always use UTC here.
+    $timestamp ||= Bugzilla->dbh->selectrow_array('SELECT LOCALTIMESTAMP(0)');
+    $timestamp = format_time($timestamp, '%a, %d %b %Y %T %z', 'UTC');
+
+    # If the target bug is restricted to one or more groups, then we need
+    # to make sure we don't send email about it to unauthorized users
+    # on the request type's CC: list, so we have to trawl the list for users
+    # not in those groups or email addresses that don't have an account.
+    my @bug_in_groups = grep {$_->{'ison'} || $_->{'mandatory'}} @{$bug->groups};
+    my $attachment_is_private = $attachment ? $attachment->isprivate : undef;
+
+    my %recipients;
+    foreach my $cc (split(/[, ]+/, $cc_list)) {
+        my $ccuser = new Bugzilla::User({ name => $cc });
+        next if (scalar(@bug_in_groups) && (!$ccuser || !$ccuser->can_see_bug($bug->bug_id)));
+        next if $attachment_is_private && (!$ccuser || !$ccuser->is_insider);
+        # Prevent duplicated entries due to case sensitivity.
+        $cc = $ccuser ? $ccuser->email : $cc;
+        $recipients{$cc} = $ccuser;
+    }
+
+    # Only notify if the addressee is allowed to receive the email.
+    if ($addressee && $addressee->email_enabled) {
+        $recipients{$addressee->email} = $addressee;
+    }
+    # Process and send notification for each recipient.
+    # If there are users in the CC list who don't have an account,
+    # use the default language for email notifications.
+    my $default_lang;
+    if (grep { !$_ } values %recipients) {
+        $default_lang = Bugzilla::User->new()->setting('lang');
+    }
+
+    foreach my $to (keys %recipients) {
+        # Add threadingmarker to allow flag notification emails to be the
+        # threaded similar to normal bug change emails.
+        my $thread_user_id = $recipients{$to} ? $recipients{$to}->id : 0;
+
+        my $vars = { 'flag'            => $flag,
+                     'old_flag'        => $old_flag,
+                     'to'              => $to,
+                     'date'            => $timestamp,
+                     'bug'             => $bug,
+                     'attachment'      => $attachment,
+                     'threadingmarker' => build_thread_marker($bug->id, $thread_user_id) };
+
+        my $lang = $recipients{$to} ?
+          $recipients{$to}->setting('lang') : $default_lang;
+
+        my $template = Bugzilla->template_inner($lang);
+        my $message;
+        $template->process("email/flagmail.txt.tmpl", $vars, \$message)
+          || ThrowTemplateError($template->error());
+
+        MessageToMTA($message);
+    }
+}
+
+# This is an internal function used by $bug->flag_types
+# and $attachment->flag_types to collect data about available
+# flag types and existing flags set on them. You should never
+# call this function directly.
+sub _flag_types {
+    my ($class, $vars) = @_;
+
+    my $target_type = $vars->{target_type};
+    my $flags;
+
+    # Retrieve all existing flags for this bug/attachment.
+    if ($target_type eq 'bug') {
+        my $bug_id = delete $vars->{bug_id};
+        $flags = $class->match({target_type => 'bug', bug_id => $bug_id});
+    }
+    elsif ($target_type eq 'attachment') {
+        my $attach_id = delete $vars->{attach_id};
+        $flags = $class->match({attach_id => $attach_id});
+    }
+    else {
+        ThrowCodeError('bad_arg', {argument => 'target_type',
+                                   function => $class . '->_flag_types'});
+    }
+
+    # Get all available flag types for the given product and component.
+    my $cache = Bugzilla->request_cache->{flag_types_per_component}->{$vars->{target_type}} ||= {};
+    my $flag_data = $cache->{$vars->{component_id}} ||= Bugzilla::FlagType::match($vars);
+    my $flag_types = dclone($flag_data);
+
+    $_->{flags} = [] foreach @$flag_types;
+    my %flagtypes = map { $_->id => $_ } @$flag_types;
+
+    # Group existing flags per type, and skip those becoming invalid
+    # (which can happen when a bug is being moved into a new product
+    # or component).
+    @$flags = grep { exists $flagtypes{$_->type_id} } @$flags;
+    push(@{$flagtypes{$_->type_id}->{flags}}, $_) foreach @$flags;
+    return $flag_types;
+}
+
+1;

diff --git a/Bugzilla/FlagType.pm b/Bugzilla/FlagType.pm
new file mode 100644 (file)
index 0000000..9c20293
--- /dev/null
+++ b/Bugzilla/FlagType.pm
@@ -0,0 +1,703 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+package Bugzilla::FlagType;
+
+=head1 NAME
+
+Bugzilla::FlagType - A module to deal with Bugzilla flag types.
+
+=head1 SYNOPSIS
+
+FlagType.pm provides an interface to flag types as stored in Bugzilla.
+See below for more information.
+
+=head1 NOTES
+
+=over
+
+=item *
+
+Use of private functions/variables outside this module may lead to
+unexpected results after an upgrade.  Please avoid using private
+functions in other files/modules.  Private functions are functions
+whose names start with _ or are specifically noted as being private.
+
+=back
+
+=cut
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Util;
+use Bugzilla::Group;
+
+use Email::Address;
+
+use base qw(Bugzilla::Object);
+
+###############################
+####    Initialization     ####
+###############################
+
+use constant DB_TABLE => 'flagtypes';
+use constant LIST_ORDER => 'sortkey, name';
+
+use constant DB_COLUMNS => qw(
+    id
+    name
+    description
+    cc_list
+    target_type
+    sortkey
+    is_active
+    is_requestable
+    is_requesteeble
+    is_multiplicable
+    grant_group_id
+    request_group_id
+);
+
+use constant UPDATE_COLUMNS => qw(
+    name
+    description
+    cc_list
+    sortkey
+    is_active
+    is_requestable
+    is_requesteeble
+    is_multiplicable
+    grant_group_id
+    request_group_id
+);
+
+use constant VALIDATORS => {
+    name             => \&_check_name,
+    description      => \&_check_description,
+    cc_list          => \&_check_cc_list,
+    target_type      => \&_check_target_type,
+    sortkey          => \&_check_sortkey,
+    is_active        => \&Bugzilla::Object::check_boolean,
+    is_requestable   => \&Bugzilla::Object::check_boolean,
+    is_requesteeble  => \&Bugzilla::Object::check_boolean,
+    is_multiplicable => \&Bugzilla::Object::check_boolean,
+    grant_group      => \&_check_group,
+    request_group    => \&_check_group,
+};
+
+use constant UPDATE_VALIDATORS => {
+    grant_group_id   => \&_check_group,
+    request_group_id => \&_check_group,
+};
+###############################
+
+sub create {
+    my $class = shift;
+    my $dbh = Bugzilla->dbh;
+
+    $dbh->bz_start_transaction();
+
+    $class->check_required_create_fields(@_);
+    my $params = $class->run_create_validators(@_);
+    # In the DB, only the first character of the target type is stored.
+    $params->{target_type} = substr($params->{target_type}, 0, 1);
+
+    # Extract everything which is not a valid column name.
+    $params->{grant_group_id} = delete $params->{grant_group};
+    $params->{request_group_id} = delete $params->{request_group};
+    my $inclusions = delete $params->{inclusions};
+    my $exclusions = delete $params->{exclusions};
+
+    my $flagtype = $class->insert_create_data($params);
+
+    $flagtype->set_clusions({ inclusions => $inclusions,
+                              exclusions => $exclusions });
+    $flagtype->update();
+
+    $dbh->bz_commit_transaction();
+    return $flagtype;
+}
+
+sub update {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+    my $flag_id = $self->id;
+
+    $dbh->bz_start_transaction();
+    my $changes = $self->SUPER::update(@_);
+
+    # Update the flaginclusions and flagexclusions tables.
+    foreach my $category ('inclusions', 'exclusions') {
+        next unless delete $self->{"_update_$category"};
+
+        $dbh->do("DELETE FROM flag$category WHERE type_id = ?", undef, $flag_id);
+
+        my $sth = $dbh->prepare("INSERT INTO flag$category
+                                (type_id, product_id, component_id) VALUES (?, ?, ?)");
+
+        foreach my $prod_comp (values %{$self->{$category}}) {
+            my ($prod_id, $comp_id) = split(':', $prod_comp);
+            $prod_id ||= undef;
+            $comp_id ||= undef;
+            $sth->execute($flag_id, $prod_id, $comp_id);
+        }
+        $changes->{$category} = [0, 1];
+    }
+
+    # Clear existing flags for bugs/attachments in categories no longer on
+    # the list of inclusions or that have been added to the list of exclusions.
+    my $flag_ids = $dbh->selectcol_arrayref('SELECT DISTINCT flags.id
+                                               FROM flags
+                                         INNER JOIN bugs
+                                                 ON flags.bug_id = bugs.bug_id
+                                          LEFT JOIN flaginclusions AS i
+                                                 ON (flags.type_id = i.type_id
+                                                     AND (bugs.product_id = i.product_id
+                                                          OR i.product_id IS NULL)
+                                                     AND (bugs.component_id = i.component_id
+                                                          OR i.component_id IS NULL))
+                                              WHERE flags.type_id = ?
+                                                AND i.type_id IS NULL',
+                                             undef, $self->id);
+    Bugzilla::Flag->force_retarget($flag_ids);
+
+    $flag_ids = $dbh->selectcol_arrayref('SELECT DISTINCT flags.id
+                                            FROM flags
+                                      INNER JOIN bugs
+                                              ON flags.bug_id = bugs.bug_id
+                                      INNER JOIN flagexclusions AS e
+                                              ON flags.type_id = e.type_id
+                                           WHERE flags.type_id = ?
+                                             AND (bugs.product_id = e.product_id
+                                                  OR e.product_id IS NULL)
+                                             AND (bugs.component_id = e.component_id
+                                                  OR e.component_id IS NULL)',
+                                          undef, $self->id);
+    Bugzilla::Flag->force_retarget($flag_ids);
+
+    # Silently remove requestees from flags which are no longer
+    # specifically requestable.
+    if (!$self->is_requesteeble) {
+        $dbh->do('UPDATE flags SET requestee_id = NULL WHERE type_id = ?',
+                  undef, $self->id);
+    }
+
+    $dbh->bz_commit_transaction();
+    return $changes;
+}
+
+###############################
+####      Accessors      ######
+###############################
+
+=head2 METHODS
+
+=over
+
+=item C<id>
+
+Returns the ID of the flagtype.
+
+=item C<name>
+
+Returns the name of the flagtype.
+
+=item C<description>
+
+Returns the description of the flagtype.
+
+=item C<cc_list>
+
+Returns the concatenated CC list for the flagtype, as a single string.
+
+=item C<target_type>
+
+Returns whether the flagtype applies to bugs or attachments.
+
+=item C<is_active>
+
+Returns whether the flagtype is active or disabled. Flags being
+in a disabled flagtype are not deleted. It only prevents you from
+adding new flags to it.
+
+=item C<is_requestable>
+
+Returns whether you can request for the given flagtype
+(i.e. whether the '?' flag is available or not).
+
+=item C<is_requesteeble>
+
+Returns whether you can ask someone specifically or not.
+
+=item C<is_multiplicable>
+
+Returns whether you can have more than one flag for the given
+flagtype in a given bug/attachment.
+
+=item C<sortkey>
+
+Returns the sortkey of the flagtype.
+
+=back
+
+=cut
+
+sub id               { return $_[0]->{'id'};               }
+sub name             { return $_[0]->{'name'};             }
+sub description      { return $_[0]->{'description'};      }
+sub cc_list          { return $_[0]->{'cc_list'};          }
+sub target_type      { return $_[0]->{'target_type'} eq 'b' ? 'bug' : 'attachment'; }
+sub is_active        { return $_[0]->{'is_active'};        }
+sub is_requestable   { return $_[0]->{'is_requestable'};   }
+sub is_requesteeble  { return $_[0]->{'is_requesteeble'};  }
+sub is_multiplicable { return $_[0]->{'is_multiplicable'}; }
+sub sortkey          { return $_[0]->{'sortkey'};          }
+sub request_group_id { return $_[0]->{'request_group_id'}; }
+sub grant_group_id   { return $_[0]->{'grant_group_id'};   }
+
+################################
+# Validators
+################################
+
+sub _check_name {
+    my ($invocant, $name) = @_;
+
+    $name = trim($name);
+    ($name && $name !~ /[\s,]/ && length($name) <= 50)
+      || ThrowUserError('flag_type_name_invalid', { name => $name });
+    return $name;
+}
+
+sub _check_description {
+    my ($invocant, $desc) = @_;
+
+    $desc = trim($desc);
+    $desc || ThrowUserError('flag_type_description_invalid');
+    return $desc;
+}
+
+sub _check_cc_list {
+    my ($invocant, $cc_list) = @_;
+
+    length($cc_list) <= 200
+      || ThrowUserError('flag_type_cc_list_invalid', { cc_list => $cc_list });
+
+    my @addresses = split(/[,\s]+/, $cc_list);
+    my $addr_spec = $Email::Address::addr_spec;
+    # We do not call check_email_syntax() because these addresses do not
+    # require to match 'emailregexp' and do not depend on 'emailsuffix'.
+    foreach my $address (@addresses) {
+        ($address !~ /\P{ASCII}/ && $address =~ /^$addr_spec$/)
+          || ThrowUserError('illegal_email_address',
+                            {addr => $address, default => 1});
+    }
+    return $cc_list;
+}
+
+sub _check_target_type {
+    my ($invocant, $target_type) = @_;
+
+    ($target_type eq 'bug' || $target_type eq 'attachment')
+      || ThrowCodeError('flag_type_target_type_invalid', { target_type => $target_type });
+    return $target_type;
+}
+
+sub _check_sortkey {
+    my ($invocant, $sortkey) = @_;
+
+    (detaint_natural($sortkey) && $sortkey <= MAX_SMALLINT)
+      || ThrowUserError('flag_type_sortkey_invalid', { sortkey => $sortkey });
+    return $sortkey;
+}
+
+sub _check_group {
+    my ($invocant, $group) = @_;
+    return unless $group;
+
+    trick_taint($group);
+    $group = Bugzilla::Group->check($group);
+    return $group->id;
+}
+
+###############################
+####       Methods         ####
+###############################
+
+sub set_name             { $_[0]->set('name', $_[1]); }
+sub set_description      { $_[0]->set('description', $_[1]); }
+sub set_cc_list          { $_[0]->set('cc_list', $_[1]); }
+sub set_sortkey          { $_[0]->set('sortkey', $_[1]); }
+sub set_is_active        { $_[0]->set('is_active', $_[1]); }
+sub set_is_requestable   { $_[0]->set('is_requestable', $_[1]); }
+sub set_is_specifically_requestable { $_[0]->set('is_requesteeble', $_[1]); }
+sub set_is_multiplicable { $_[0]->set('is_multiplicable', $_[1]); }
+sub set_grant_group      { $_[0]->set('grant_group_id', $_[1]); }
+sub set_request_group    { $_[0]->set('request_group_id', $_[1]); }
+
+sub set_clusions {
+    my ($self, $list) = @_;
+    my $user = Bugzilla->user;
+    my %products;
+    my $params = {};
+
+    # If the user has editcomponents privs, then we only need to make sure
+    # that the product exists.
+    if ($user->in_group('editcomponents')) {
+        $params->{allow_inaccessible} = 1;
+    }
+
+    foreach my $category (keys %$list) {
+        my %clusions;
+        my %clusions_as_hash;
+
+        foreach my $prod_comp (@{$list->{$category} || []}) {
+            my ($prod_id, $comp_id) = split(':', $prod_comp);
+            my $prod_name = '__Any__';
+            my $comp_name = '__Any__';
+            # Does the product exist?
+            if ($prod_id) {
+                detaint_natural($prod_id)
+                  || ThrowCodeError('param_must_be_numeric',
+                                    { function => 'Bugzilla::FlagType::set_clusions' });
+
+                if (!$products{$prod_id}) {
+                    $params->{id} = $prod_id;
+                    $products{$prod_id} = Bugzilla::Product->check($params);
+                    $user->in_group('editcomponents', $prod_id)
+                      || ThrowUserError('product_access_denied', $params);
+                }
+                $prod_name = $products{$prod_id}->name;
+
+                # Does the component belong to this product?
+                if ($comp_id) {
+                    detaint_natural($comp_id)
+                      || ThrowCodeError('param_must_be_numeric',
+                                        { function => 'Bugzilla::FlagType::set_clusions' });
+
+                    my ($component) = grep { $_->id == $comp_id } @{$products{$prod_id}->components}
+                                        or ThrowUserError('product_unknown_component',
+                                                          { product => $prod_name, comp_id => $comp_id });
+                    $comp_name = $component->name;
+                }
+                else {
+                    $comp_id = 0;
+                }
+            }
+            else {
+                $prod_id = 0;
+                $comp_id = 0;
+            }
+            $clusions{"$prod_name:$comp_name"} = "$prod_id:$comp_id";
+            $clusions_as_hash{$prod_id}->{$comp_id} = 1;
+        }
+        $self->{$category} = \%clusions;
+        $self->{"${category}_as_hash"} = \%clusions_as_hash;
+        $self->{"_update_$category"} = 1;
+    }
+}
+
+=pod
+
+=over
+
+=item C<grant_list>
+
+Returns a reference to an array of users who have permission to grant this flag type.
+The arrays are populated with hashrefs containing the login, identity and visibility of users.
+
+=item C<grant_group>
+
+Returns the group (as a Bugzilla::Group object) in which a user
+must be in order to grant or deny a request.
+
+=item C<request_group>
+
+Returns the group (as a Bugzilla::Group object) in which a user
+must be in order to request or clear a flag.
+
+=item C<flag_count>
+
+Returns the number of flags belonging to the flagtype.
+
+=item C<inclusions>
+
+Return a hash of product/component IDs and names
+explicitly associated with the flagtype.
+
+=item C<exclusions>
+
+Return a hash of product/component IDs and names
+explicitly excluded from the flagtype.
+
+=back
+
+=cut
+
+sub grant_list {
+    my $self = shift;
+    require Bugzilla::User;
+    my @custusers;
+    my @allusers = @{Bugzilla->user->get_userlist};
+    foreach my $user (@allusers) {
+        my $user_obj = new Bugzilla::User({name => $user->{login}});
+        push(@custusers, $user) if $user_obj->can_set_flag($self);
+    }
+    return \@custusers;
+}
+
+sub grant_group {
+    my $self = shift;
+
+    if (!defined $self->{'grant_group'} && $self->{'grant_group_id'}) {
+        $self->{'grant_group'} = new Bugzilla::Group($self->{'grant_group_id'});
+    }
+    return $self->{'grant_group'};
+}
+
+sub request_group {
+    my $self = shift;
+
+    if (!defined $self->{'request_group'} && $self->{'request_group_id'}) {
+        $self->{'request_group'} = new Bugzilla::Group($self->{'request_group_id'});
+    }
+    return $self->{'request_group'};
+}
+
+sub flag_count {
+    my $self = shift;
+
+    if (!defined $self->{'flag_count'}) {
+        $self->{'flag_count'} =
+            Bugzilla->dbh->selectrow_array('SELECT COUNT(*) FROM flags
+                                            WHERE type_id = ?', undef, $self->{'id'});
+    }
+    return $self->{'flag_count'};
+}
+
+sub inclusions {
+    my $self = shift;
+
+    if (!defined $self->{inclusions}) {
+        ($self->{inclusions}, $self->{inclusions_as_hash}) = get_clusions($self->id, 'in');
+    }
+    return $self->{inclusions};
+}
+
+sub inclusions_as_hash {
+    my $self = shift;
+
+    $self->inclusions unless defined $self->{inclusions_as_hash};
+    return $self->{inclusions_as_hash};
+}
+
+sub exclusions {
+    my $self = shift;
+
+    if (!defined $self->{exclusions}) {
+        ($self->{exclusions}, $self->{exclusions_as_hash}) = get_clusions($self->id, 'ex');
+    }
+    return $self->{exclusions};
+}
+
+sub exclusions_as_hash {
+    my $self = shift;
+
+    $self->exclusions unless defined $self->{exclusions_as_hash};
+    return $self->{exclusions_as_hash};
+}
+
+######################################################################
+# Public Functions
+######################################################################
+
+=pod
+
+=head1 PUBLIC FUNCTIONS/METHODS
+
+=over
+
+=item C<get_clusions($id, $type)>
+
+Return a hash of product/component IDs and names
+associated with the flagtype:
+$clusions{'product_name:component_name'} = "product_ID:component_ID"
+
+=back
+
+=cut
+
+sub get_clusions {
+    my ($id, $type) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    my $list =
+        $dbh->selectall_arrayref("SELECT products.id, products.name,
+                                         components.id, components.name
+                                    FROM flagtypes
+                              INNER JOIN flag${type}clusions
+                                      ON flag${type}clusions.type_id = flagtypes.id
+                               LEFT JOIN products
+                                      ON flag${type}clusions.product_id = products.id
+                               LEFT JOIN components
+                                      ON flag${type}clusions.component_id = components.id
+                                   WHERE flagtypes.id = ?",
+                                 undef, $id);
+    my (%clusions, %clusions_as_hash);
+    foreach my $data (@$list) {
+        my ($product_id, $product_name, $component_id, $component_name) = @$data;
+        $product_id ||= 0;
+        $product_name ||= "__Any__";
+        $component_id ||= 0;
+        $component_name ||= "__Any__";
+        $clusions{"$product_name:$component_name"} = "$product_id:$component_id";
+        $clusions_as_hash{$product_id}->{$component_id} = 1;
+    }
+    return (\%clusions, \%clusions_as_hash);
+}
+
+=pod
+
+=over
+
+=item C<match($criteria)>
+
+Queries the database for flag types matching the given criteria
+and returns a list of matching flagtype objects.
+
+=back
+
+=cut
+
+sub match {
+    my ($criteria) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    # Depending on the criteria, we may have to append additional tables.
+    my $tables = [DB_TABLE];
+    my @criteria = sqlify_criteria($criteria, $tables);
+    $tables = join(' ', @$tables);
+    $criteria = join(' AND ', @criteria);
+
+    my $flagtype_ids = $dbh->selectcol_arrayref("SELECT id FROM $tables WHERE $criteria");
+
+    return Bugzilla::FlagType->new_from_list($flagtype_ids);
+}
+
+=pod
+
+=over
+
+=item C<count($criteria)>
+
+Returns the total number of flag types matching the given criteria.
+
+=back
+
+=cut
+
+sub count {
+    my ($criteria) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    # Depending on the criteria, we may have to append additional tables.
+    my $tables = [DB_TABLE];
+    my @criteria = sqlify_criteria($criteria, $tables);
+    $tables = join(' ', @$tables);
+    $criteria = join(' AND ', @criteria);
+
+    my $count = $dbh->selectrow_array("SELECT COUNT(flagtypes.id)
+                                       FROM $tables WHERE $criteria");
+    return $count;
+}
+
+######################################################################
+# Private Functions
+######################################################################
+
+# Converts a hash of criteria into a list of SQL criteria.
+# $criteria is a reference to the criteria (field => value), 
+# $tables is a reference to an array of tables being accessed 
+# by the query.
+
+sub sqlify_criteria {
+    my ($criteria, $tables) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    # the generated list of SQL criteria; "1=1" is a clever way of making sure
+    # there's something in the list so calling code doesn't have to check list
+    # size before building a WHERE clause out of it
+    my @criteria = ("1=1");
+
+    if ($criteria->{name}) {
+        my $name = $dbh->quote($criteria->{name});
+        trick_taint($name); # Detaint data as we have quoted it.
+        push(@criteria, "flagtypes.name = $name");
+    }
+    if ($criteria->{target_type}) {
+        # The target type is stored in the database as a one-character string
+        # ("a" for attachment and "b" for bug), but this function takes complete
+        # names ("attachment" and "bug") for clarity, so we must convert them.
+        my $target_type = $criteria->{target_type} eq 'bug'? 'b' : 'a';
+        push(@criteria, "flagtypes.target_type = '$target_type'");
+    }
+    if (exists($criteria->{is_active})) {
+        my $is_active = $criteria->{is_active} ? "1" : "0";
+        push(@criteria, "flagtypes.is_active = $is_active");
+    }
+    if ($criteria->{product_id}) {
+        my $product_id = $criteria->{product_id};
+        detaint_natural($product_id)
+          || ThrowCodeError('bad_arg', { argument => 'product_id',
+                                         function => 'Bugzilla::FlagType::sqlify_criteria' });
+
+        # Add inclusions to the query, which simply involves joining the table
+        # by flag type ID and target product/component.
+        push(@$tables, "INNER JOIN flaginclusions AS i ON flagtypes.id = i.type_id");
+        push(@criteria, "(i.product_id = $product_id OR i.product_id IS NULL)");
+        
+        # Add exclusions to the query, which is more complicated.  First of all,
+        # we do a LEFT JOIN so we don't miss flag types with no exclusions.
+        # Then, as with inclusions, we join on flag type ID and target product/
+        # component.  However, since we want flag types that *aren't* on the
+        # exclusions list, we add a WHERE criteria to use only records with
+        # NULL exclusion type, i.e. without any exclusions.
+        my $join_clause = "flagtypes.id = e.type_id ";
+
+        my $addl_join_clause = "";
+        if ($criteria->{component_id}) {
+            my $component_id = $criteria->{component_id};
+            detaint_natural($component_id)
+              || ThrowCodeError('bad_arg', { argument => 'component_id',
+                                             function => 'Bugzilla::FlagType::sqlify_criteria' });
+
+            push(@criteria, "(i.component_id = $component_id OR i.component_id IS NULL)");
+            $join_clause .= "AND (e.component_id = $component_id OR e.component_id IS NULL) ";
+        }
+        else {
+            $addl_join_clause = "AND e.component_id IS NULL OR (i.component_id = e.component_id) ";
+        }
+        $join_clause .= "AND ((e.product_id = $product_id $addl_join_clause) OR e.product_id IS NULL)";
+
+        push(@$tables, "LEFT JOIN flagexclusions AS e ON ($join_clause)");
+        push(@criteria, "e.type_id IS NULL");
+    }
+    if ($criteria->{group}) {
+        my $gid = $criteria->{group};
+        detaint_natural($gid)
+          || ThrowCodeError('bad_arg', { argument => 'group',
+                                         function => 'Bugzilla::FlagType::sqlify_criteria' });
+
+        push(@criteria, "(flagtypes.grant_group_id = $gid " .
+                        " OR flagtypes.request_group_id = $gid)");
+    }
+    
+    return @criteria;
+}
+
+1;

diff --git a/Bugzilla/Group.pm b/Bugzilla/Group.pm
new file mode 100644 (file)
index 0000000..04c36f6
--- /dev/null
+++ b/Bugzilla/Group.pm
@@ -0,0 +1,649 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+package Bugzilla::Group;
+
+use base qw(Bugzilla::Object);
+
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Config qw(:admin);
+
+###############################
+##### Module Initialization ###
+###############################
+
+use constant DB_COLUMNS => qw(
+    groups.id
+    groups.name
+    groups.description
+    groups.isbuggroup
+    groups.userregexp
+    groups.isactive
+    groups.icon_url
+);
+
+use constant DB_TABLE => 'groups';
+
+use constant LIST_ORDER => 'isbuggroup, name';
+
+use constant VALIDATORS => {
+    name        => \&_check_name,
+    description => \&_check_description,
+    userregexp  => \&_check_user_regexp,
+    isactive    => \&_check_is_active,
+    isbuggroup  => \&_check_is_bug_group,
+    icon_url    => \&_check_icon_url,
+};
+
+use constant UPDATE_COLUMNS => qw(
+    name
+    description
+    userregexp
+    isactive
+    icon_url
+);
+
+# Parameters that are lists of groups.
+use constant GROUP_PARAMS => qw(chartgroup insidergroup timetrackinggroup
+                                querysharegroup);
+
+###############################
+####      Accessors      ######
+###############################
+
+sub description  { return $_[0]->{'description'};  }
+sub is_bug_group { return $_[0]->{'isbuggroup'};   }
+sub user_regexp  { return $_[0]->{'userregexp'};   }
+sub is_active    { return $_[0]->{'isactive'};     }
+sub icon_url     { return $_[0]->{'icon_url'};     }
+
+sub bugs {
+    my $self = shift;
+    return $self->{bugs} if exists $self->{bugs};
+    my $bug_ids = Bugzilla->dbh->selectcol_arrayref(
+        'SELECT bug_id FROM bug_group_map WHERE group_id = ?',
+        undef, $self->id);
+    require Bugzilla::Bug;
+    $self->{bugs} = Bugzilla::Bug->new_from_list($bug_ids);
+    return $self->{bugs};
+}
+
+sub members_direct {
+    my ($self) = @_;
+    $self->{members_direct} ||= $self->_get_members(GRANT_DIRECT);
+    return $self->{members_direct};
+}
+
+sub members_non_inherited {
+    my ($self) = @_;
+    $self->{members_non_inherited} ||= $self->_get_members();
+    return $self->{members_non_inherited};
+}
+
+# A helper for members_direct and members_non_inherited
+sub _get_members {
+    my ($self, $grant_type) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $grant_clause = $grant_type ? "AND grant_type = $grant_type" : "";
+    my $user_ids = $dbh->selectcol_arrayref(
+        "SELECT DISTINCT user_id
+           FROM user_group_map
+          WHERE isbless = 0 $grant_clause AND group_id = ?", undef, $self->id);
+    require Bugzilla::User;
+    return Bugzilla::User->new_from_list($user_ids);
+}
+
+sub flag_types {
+    my $self = shift;
+    require Bugzilla::FlagType;
+    $self->{flag_types} ||= Bugzilla::FlagType::match({ group => $self->id });
+    return $self->{flag_types};
+}
+
+sub grant_direct {
+    my ($self, $type) = @_;
+    $self->{grant_direct} ||= {};
+    return $self->{grant_direct}->{$type} 
+        if defined $self->{grant_direct}->{$type};
+    my $dbh = Bugzilla->dbh;
+
+    my $ids = $dbh->selectcol_arrayref(
+      "SELECT member_id FROM group_group_map
+        WHERE grantor_id = ? AND grant_type = $type", 
+      undef, $self->id) || [];
+
+    $self->{grant_direct}->{$type} = $self->new_from_list($ids);
+    return $self->{grant_direct}->{$type};
+}
+
+sub granted_by_direct {
+    my ($self, $type) = @_;
+    $self->{granted_by_direct} ||= {};
+    return $self->{granted_by_direct}->{$type}
+         if defined $self->{granted_by_direct}->{$type};
+    my $dbh = Bugzilla->dbh;
+
+    my $ids = $dbh->selectcol_arrayref(
+      "SELECT grantor_id FROM group_group_map
+        WHERE member_id = ? AND grant_type = $type",
+      undef, $self->id) || [];
+
+    $self->{granted_by_direct}->{$type} = $self->new_from_list($ids);
+    return $self->{granted_by_direct}->{$type};
+}
+
+sub products {
+    my $self = shift;
+    return $self->{products} if exists $self->{products};
+    my $product_data = Bugzilla->dbh->selectall_arrayref(
+        'SELECT product_id, entry, membercontrol, othercontrol,
+                canedit, editcomponents, editbugs, canconfirm
+          FROM  group_control_map WHERE group_id = ?', {Slice=>{}},
+        $self->id);
+    my @ids = map { $_->{product_id} } @$product_data;
+    require Bugzilla::Product;
+    my $products = Bugzilla::Product->new_from_list(\@ids); 
+    my %data_map = map { $_->{product_id} => $_ } @$product_data;
+    my @retval;
+    foreach my $product (@$products) {
+        # Data doesn't need to contain product_id--we already have
+        # the product object.
+        delete $data_map{$product->id}->{product_id};
+        push(@retval, { controls => $data_map{$product->id},
+                        product  => $product });
+    }
+    $self->{products} = \@retval;
+    return $self->{products};
+}
+
+###############################
+####        Methods        ####
+###############################
+
+sub check_members_are_visible {
+    my $self = shift;
+    my $user = Bugzilla->user;
+    return if !Bugzilla->params->{'usevisibilitygroups'};
+
+    my $group_id = $self->id;
+    my $is_visible = grep { $_ == $group_id } @{ $user->visible_groups_inherited };
+    if (!$is_visible) {
+        ThrowUserError('group_not_visible', { group => $self });
+    }
+}
+
+sub set_description { $_[0]->set('description', $_[1]); }
+sub set_is_active   { $_[0]->set('isactive', $_[1]);    }
+sub set_name        { $_[0]->set('name', $_[1]);        }
+sub set_user_regexp { $_[0]->set('userregexp', $_[1]);  }
+sub set_icon_url    { $_[0]->set('icon_url', $_[1]);    }
+
+sub update {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+    $dbh->bz_start_transaction();
+    my $changes = $self->SUPER::update(@_);
+
+    if (exists $changes->{name}) {
+        my ($old_name, $new_name) = @{$changes->{name}};
+        my $update_params;
+        foreach my $group (GROUP_PARAMS) {
+            if ($old_name eq Bugzilla->params->{$group}) {
+                SetParam($group, $new_name);
+                $update_params = 1;
+            }
+        }
+        write_params() if $update_params;
+    }
+
+    # If we've changed this group to be active, fix any Mandatory groups.
+    $self->_enforce_mandatory if (exists $changes->{isactive} 
+                                  && $changes->{isactive}->[1]);
+
+    $self->_rederive_regexp() if exists $changes->{userregexp};
+
+    Bugzilla::Hook::process('group_end_of_update', 
+                            { group => $self, changes => $changes });
+    $dbh->bz_commit_transaction();
+    return $changes;
+}
+
+sub check_remove {
+    my ($self, $params) = @_;
+
+    # System groups cannot be deleted!
+    if (!$self->is_bug_group) {
+        ThrowUserError("system_group_not_deletable", { name => $self->name });
+    }
+
+    # Groups having a special role cannot be deleted.
+    my @special_groups;
+    foreach my $special_group (GROUP_PARAMS) {
+        if ($self->name eq Bugzilla->params->{$special_group}) {
+            push(@special_groups, $special_group);
+        }
+    }
+    if (scalar(@special_groups)) {
+        ThrowUserError('group_has_special_role',
+                       { name   => $self->name,
+                         groups => \@special_groups });
+    }
+
+    return if $params->{'test_only'};
+
+    my $cantdelete = 0;
+
+    my $users = $self->members_non_inherited;
+    if (scalar(@$users) && !$params->{'remove_from_users'}) {
+        $cantdelete = 1;
+    }
+
+    my $bugs = $self->bugs;
+    if (scalar(@$bugs) && !$params->{'remove_from_bugs'}) {
+        $cantdelete = 1;
+    }
+    
+    my $products = $self->products;
+    if (scalar(@$products) && !$params->{'remove_from_products'}) {
+        $cantdelete = 1;
+    }
+
+    my $flag_types = $self->flag_types;
+    if (scalar(@$flag_types) && !$params->{'remove_from_flags'}) {
+        $cantdelete = 1;
+    }
+
+    ThrowUserError('group_cannot_delete', { group => $self }) if $cantdelete;
+}
+
+sub remove_from_db {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+    $self->check_remove(@_);
+    $dbh->bz_start_transaction();
+    Bugzilla::Hook::process('group_before_delete', { group => $self });
+    $dbh->do('DELETE FROM whine_schedules
+               WHERE mailto_type = ? AND mailto = ?',
+              undef, MAILTO_GROUP, $self->id);
+    # All the other tables will be handled by foreign keys when we
+    # drop the main "groups" row.
+    $self->SUPER::remove_from_db(@_);
+    $dbh->bz_commit_transaction();
+}
+
+# Add missing entries in bug_group_map for bugs created while
+# a mandatory group was disabled and which is now enabled again.
+sub _enforce_mandatory {
+    my ($self) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $gid = $self->id;
+
+    my $bug_ids =
+      $dbh->selectcol_arrayref('SELECT bugs.bug_id
+                                  FROM bugs
+                            INNER JOIN group_control_map
+                                    ON group_control_map.product_id = bugs.product_id
+                             LEFT JOIN bug_group_map
+                                    ON bug_group_map.bug_id = bugs.bug_id
+                                   AND bug_group_map.group_id = group_control_map.group_id
+                                 WHERE group_control_map.group_id = ?
+                                   AND group_control_map.membercontrol = ?
+                                   AND bug_group_map.group_id IS NULL',
+                                 undef, ($gid, CONTROLMAPMANDATORY));
+
+    my $sth = $dbh->prepare('INSERT INTO bug_group_map (bug_id, group_id) VALUES (?, ?)');
+    foreach my $bug_id (@$bug_ids) {
+        $sth->execute($bug_id, $gid);
+    }
+}
+
+sub is_active_bug_group {
+    my $self = shift;
+    return $self->is_active && $self->is_bug_group;
+}
+
+sub _rederive_regexp {
+    my ($self) = @_;
+
+    my $dbh = Bugzilla->dbh;
+    my $sth = $dbh->prepare("SELECT userid, login_name, group_id
+                               FROM profiles
+                          LEFT JOIN user_group_map
+                                 ON user_group_map.user_id = profiles.userid
+                                    AND group_id = ?
+                                    AND grant_type = ?
+                                    AND isbless = 0");
+    my $sthadd = $dbh->prepare("INSERT INTO user_group_map
+                                 (user_id, group_id, grant_type, isbless)
+                                 VALUES (?, ?, ?, 0)");
+    my $sthdel = $dbh->prepare("DELETE FROM user_group_map
+                                 WHERE user_id = ? AND group_id = ?
+                                 AND grant_type = ? and isbless = 0");
+    $sth->execute($self->id, GRANT_REGEXP);
+    my $regexp = $self->user_regexp;
+    while (my ($uid, $login, $present) = $sth->fetchrow_array) {
+        if ($regexp ne '' and $login =~ /$regexp/i) {
+            $sthadd->execute($uid, $self->id, GRANT_REGEXP) unless $present;
+        } else {
+            $sthdel->execute($uid, $self->id, GRANT_REGEXP) if $present;
+        }
+    }
+}
+
+sub flatten_group_membership {
+    my ($self, @groups) = @_;
+
+    my $dbh = Bugzilla->dbh;
+    my $sth;
+    my @groupidstocheck = @groups;
+    my %groupidschecked = ();
+    $sth = $dbh->prepare("SELECT member_id FROM group_group_map
+                             WHERE grantor_id = ? 
+                               AND grant_type = " . GROUP_MEMBERSHIP);
+    while (my $node = shift @groupidstocheck) {
+        $sth->execute($node);
+        my $member;
+        while (($member) = $sth->fetchrow_array) {
+            if (!$groupidschecked{$member}) {
+                $groupidschecked{$member} = 1;
+                push @groupidstocheck, $member;
+                push @groups, $member unless grep $_ == $member, @groups;
+            }
+        }
+    }
+    return \@groups;
+}
+
+
+
+
+################################
+#####  Module Subroutines    ###
+################################
+
+sub create {
+    my $class = shift;
+    my ($params) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    my $silently = delete $params->{silently};
+    if (Bugzilla->usage_mode == USAGE_MODE_CMDLINE and !$silently) {
+        print get_text('install_group_create', { name => $params->{name} }),
+              "\n";
+    }
+
+    $dbh->bz_start_transaction();
+
+    my $group = $class->SUPER::create(@_);
+
+    # Since we created a new group, give the "admin" group all privileges
+    # initially.
+    my $admin = new Bugzilla::Group({name => 'admin'});
+    # This function is also used to create the "admin" group itself,
+    # so there's a chance it won't exist yet.
+    if ($admin) {
+        my $sth = $dbh->prepare('INSERT INTO group_group_map
+                                 (member_id, grantor_id, grant_type)
+                                 VALUES (?, ?, ?)');
+        $sth->execute($admin->id, $group->id, GROUP_MEMBERSHIP);
+        $sth->execute($admin->id, $group->id, GROUP_BLESS);
+        $sth->execute($admin->id, $group->id, GROUP_VISIBLE);
+    }
+
+    $group->_rederive_regexp() if $group->user_regexp;
+
+    Bugzilla::Hook::process('group_end_of_create', { group => $group });
+    $dbh->bz_commit_transaction();
+    return $group;
+}
+
+sub ValidateGroupName {
+    my ($name, @users) = (@_);
+    my $dbh = Bugzilla->dbh;
+    my $query = "SELECT id FROM groups " .
+                "WHERE name = ?";
+    if (Bugzilla->params->{'usevisibilitygroups'}) {
+        my @visible = (-1);
+        foreach my $user (@users) {
+            $user && push @visible, @{$user->visible_groups_direct};
+        }
+        my $visible = join(', ', @visible);
+        $query .= " AND id IN($visible)";
+    }
+    my $sth = $dbh->prepare($query);
+    $sth->execute($name);
+    my ($ret) = $sth->fetchrow_array();
+    return $ret;
+}
+
+sub check_no_disclose {
+    my ($class, $params) = @_;
+    my $action = delete $params->{action};
+
+    $action =~ /^(?:add|remove)$/
+      or ThrowCodeError('bad_arg', { argument => $action,
+                                     function => "${class}::check_no_disclose" });
+
+    $params->{_error} = ($action eq 'add') ? 'group_restriction_not_allowed'
+                                           : 'group_invalid_removal';
+
+    my $group = $class->check($params);
+    return $group;
+}
+
+###############################
+###       Validators        ###
+###############################
+
+sub _check_name {
+    my ($invocant, $name) = @_;
+    $name = trim($name);
+    $name || ThrowUserError("empty_group_name");
+    # If we're creating a Group or changing the name...
+    if (!ref($invocant) || lc($invocant->name) ne lc($name)) {
+        my $exists = new Bugzilla::Group({name => $name });
+        ThrowUserError("group_exists", { name => $name }) if $exists;
+    }
+    return $name;
+}
+
+sub _check_description {
+    my ($invocant, $desc) = @_;
+    $desc = trim($desc);
+    $desc || ThrowUserError("empty_group_description");
+    return $desc;
+}
+
+sub _check_user_regexp {
+    my ($invocant, $regex) = @_;
+    $regex = trim($regex) || '';
+    ThrowUserError("invalid_regexp") unless (eval {qr/$regex/});
+    return $regex;
+}
+
+sub _check_is_active { return $_[1] ? 1 : 0; }
+sub _check_is_bug_group {
+    return $_[1] ? 1 : 0;
+}
+
+sub _check_icon_url { return $_[1] ? clean_text($_[1]) : undef; }
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Group - Bugzilla group class.
+
+=head1 SYNOPSIS
+
+    use Bugzilla::Group;
+
+    my $group = new Bugzilla::Group(1);
+    my $group = new Bugzilla::Group({name => 'AcmeGroup'});
+
+    my $id           = $group->id;
+    my $name         = $group->name;
+    my $description  = $group->description;
+    my $user_reg_exp = $group->user_reg_exp;
+    my $is_active    = $group->is_active;
+    my $icon_url     = $group->icon_url;
+    my $is_active_bug_group = $group->is_active_bug_group;
+
+    my $group_id = Bugzilla::Group::ValidateGroupName('admin', @users);
+    my @groups   = Bugzilla::Group->get_all;
+
+=head1 DESCRIPTION
+
+Group.pm represents a Bugzilla Group object. It is an implementation
+of L<Bugzilla::Object>, and thus has all the methods that L<Bugzilla::Object>
+provides, in addition to any methods documented below.
+
+=head1 SUBROUTINES
+
+=over
+
+=item C<create>
+
+Note that in addition to what L<Bugzilla::Object/create($params)>
+normally does, this function also makes the new group be inherited
+by the C<admin> group. That is, the C<admin> group will automatically
+be a member of this group.
+
+=item C<ValidateGroupName($name, @users)>
+
+Description: ValidateGroupName checks to see if ANY of the users
+             in the provided list of user objects can see the
+             named group.
+
+Params:      $name - String with the group name.
+             @users - An array with Bugzilla::User objects.
+
+Returns:     It returns the group id if successful
+             and undef otherwise.
+
+=back
+
+
+=head1 METHODS
+
+=over
+
+=item C<check_no_disclose>
+
+=over
+
+=item B<Description>
+
+Throws an error if the user cannot add or remove this group to/from a given
+bug, but doesn't specify if this is because the group doesn't exist, or the
+user is not allowed to edit this group restriction.
+
+=item B<Params>
+
+This method takes a single hashref as argument, with the following keys:
+
+=over
+
+=item C<name>
+
+C<string> The name of the group to add or remove.
+
+=item C<bug_id>
+
+C<integer> The ID of the bug to which the group change applies.
+
+=item C<product>
+
+C<string> The name of the product the bug belongs to.
+
+=item C<action>
+
+C<string> Must be either C<add> or C<remove>, depending on whether the group
+must be added or removed from the bug. Any other value will generate an error.
+
+=back
+
+=item C<Returns>
+
+A C<Bugzilla::Group> object on success, else an error is thrown.
+
+=back
+
+=item C<check_members_are_visible>
+
+Throws an error if this group is not visible (according to 
+visibility groups) to the currently-logged-in user.
+
+=item C<check_remove>
+
+=over
+
+=item B<Description>
+
+Determines whether it's OK to remove this group from the database, and
+throws an error if it's not OK.
+
+=item B<Params>
+
+=over
+
+=item C<test_only>
+
+C<boolean> If you want to only check if the group can be deleted I<at all>,
+under any circumstances, specify C<test_only> to just do the most basic tests
+(the other parameters will be ignored in this situation, as those tests won't
+be run).
+
+=item C<remove_from_users>
+
+C<boolean> True if it would be OK to remove all users who are in this group
+from this group.
+
+=item C<remove_from_bugs>
+
+C<boolean> True if it would be OK to remove all bugs that are in this group
+from this group.
+
+=item C<remove_from_flags>
+
+C<boolean> True if it would be OK to stop all flagtypes that reference
+this group from referencing this group (e.g., as their grantgroup or
+requestgroup).
+
+=item C<remove_from_products>
+
+C<boolean> True if it would be OK to remove this group from all group controls
+on products.
+
+=back
+
+=item B<Returns> (nothing)
+
+=back
+
+=item C<members_non_inherited>
+
+Returns an arrayref of L<Bugzilla::User> objects representing people who are
+"directly" in this group, meaning that they're in it because they match
+the group regular expression, or they have been actually added to the
+group manually.
+
+=item C<flatten_group_membership>
+
+Accepts a list of groups and returns a list of all the groups whose members 
+inherit membership in any group on the list.  So, we can determine if a user
+is in any of the groups input to flatten_group_membership by querying the
+user_group_map for any user with DIRECT or REGEXP membership IN() the list
+of groups returned.
+
+=back

diff --git a/Bugzilla/Hook.pm b/Bugzilla/Hook.pm
new file mode 100644 (file)
index 0000000..b75b329
--- /dev/null
+++ b/Bugzilla/Hook.pm
@@ -0,0 +1,1599 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Hook;
+use strict;
+
+sub process {
+    my ($name, $args) = @_;
+
+    _entering($name);
+
+    foreach my $extension (@{ Bugzilla->extensions }) {
+        if ($extension->can($name)) {
+            $extension->$name($args);
+        }
+    }
+
+    _leaving($name);
+}
+
+sub in {
+    my $hook_name = shift;
+    my $currently_in = Bugzilla->request_cache->{hook_stack}->[-1] || '';
+    return $hook_name eq $currently_in ? 1 : 0;
+}
+
+sub _entering {
+    my ($hook_name) = @_;
+    my $hook_stack = Bugzilla->request_cache->{hook_stack} ||= [];
+    push(@$hook_stack, $hook_name);
+}
+
+sub _leaving {
+    pop @{ Bugzilla->request_cache->{hook_stack} };
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Hook - Extendable extension hooks for Bugzilla code
+
+=head1 SYNOPSIS
+
+ use Bugzilla::Hook;
+
+ Bugzilla::Hook::process("hookname", { arg => $value, arg2 => $value2 });
+
+=head1 DESCRIPTION
+
+Bugzilla allows extension modules to drop in and add routines at 
+arbitrary points in Bugzilla code. These points are referred to as
+hooks. When a piece of standard Bugzilla code wants to allow an extension
+to perform additional functions, it uses Bugzilla::Hook's L</process>
+subroutine to invoke any extension code if installed. 
+
+The implementation of extensions is described in L<Bugzilla::Extension>.
+
+There is sample code for every hook in the Example extension, located in
+F<extensions/Example/Extension.pm>.
+
+=head2 How Hooks Work
+
+When a hook named C<HOOK_NAME> is run, Bugzilla looks through all
+enabled L<extensions|Bugzilla::Extension> for extensions that implement
+a subroutine named C<HOOK_NAME>.
+
+See L<Bugzilla::Extension> for more details about how an extension
+can run code during a hook.
+
+=head1 SUBROUTINES
+
+=over
+
+=item C<process>
+
+=over
+
+=item B<Description>
+
+Invoke any code hooks with a matching name from any installed extensions.
+
+See L<Bugzilla::Extension> for more information on Bugzilla's extension
+mechanism.
+
+=item B<Params>
+
+=over
+
+=item C<$name> - The name of the hook to invoke.
+
+=item C<$args> - A hashref. The named args to pass to the hook. 
+They will be passed as arguments to the hook method in the extension.
+
+=back
+
+=item B<Returns> (nothing)
+
+=back
+
+=back
+
+=head1 HOOKS
+
+This describes what hooks exist in Bugzilla currently. They are mostly
+in alphabetical order, but some related hooks are near each other instead
+of being alphabetical.
+
+=head2 admin_editusers_action
+
+This hook allows you to add additional actions to the admin Users page.
+
+Params:
+
+=over
+
+=item C<vars>
+
+You can add as many new key/value pairs as you want to this hashref.
+It will be passed to the template.
+
+=item C<action>
+
+A text which indicates the different behaviors that editusers.cgi will have.
+With this hook you can change the behavior of an action or add new actions.
+
+=item C<user>
+
+This is a Bugzilla::User object of the user.
+
+=back
+
+=head2 attachment_process_data
+
+This happens at the very beginning process of the attachment creation.
+You can edit the attachment content itself as well as all attributes
+of the attachment, before they are validated and inserted into the DB.
+
+Params:
+
+=over
+
+=item C<data> - A reference pointing either to the content of the file
+being uploaded or pointing to the filehandle associated with the file.
+
+=item C<attributes> - A hashref whose keys are the same as the input to
+L<Bugzilla::Attachment/create>. The data in this hashref hasn't been validated
+yet.
+
+=back
+
+=head2 auth_login_methods
+
+This allows you to add new login types to Bugzilla.
+(See L<Bugzilla::Auth::Login>.)
+
+Params:
+
+=over
+
+=item C<modules>
+
+This is a hash--a mapping from login-type "names" to the actual module on
+disk. The keys will be all the values that were passed to 
+L<Bugzilla::Auth/login> for the C<Login> parameter. The values are the
+actual path to the module on disk. (For example, if the key is C<DB>, the
+value is F<Bugzilla/Auth/Login/DB.pm>.)
+
+For your extension, the path will start with 
+F<Bugzilla/Extension/Foo/>, where "Foo" is the name of your Extension. 
+(See the code in the example extension.)
+
+If your login type is in the hash as a key, you should set that key to the
+right path to your module. That module's C<new> method will be called,
+probably with empty parameters. If your login type is I<not> in the hash,
+you should not set it.
+
+You will be prevented from adding new keys to the hash, so make sure your
+key is in there before you modify it. (In other words, you can't add in
+login methods that weren't passed to L<Bugzilla::Auth/login>.)
+
+=back
+
+=head2 auth_verify_methods
+
+This works just like L</auth_login_methods> except it's for
+login verification methods (See L<Bugzilla::Auth::Verify>.) It also
+takes a C<modules> parameter, just like L</auth_login_methods>.
+
+=head2 bug_columns
+
+B<DEPRECATED> Use L</object_columns> instead.
+
+This allows you to add new fields that will show up in every L<Bugzilla::Bug>
+object. Note that you will also need to use the L</bug_fields> hook in
+conjunction with this hook to make this work.
+
+Params:
+
+=over
+
+=item C<columns> - An arrayref containing an array of column names. Push
+your column name(s) onto the array.
+
+=back
+
+=head2 bug_end_of_create
+
+This happens at the end of L<Bugzilla::Bug/create>, after all other changes are
+made to the database. This occurs inside a database transaction.
+
+Params:
+
+=over
+
+=item C<bug> - The created bug object.
+
+=item C<timestamp> - The timestamp used for all updates in this transaction,
+as a SQL date string.
+
+=back
+
+=head2 bug_end_of_create_validators
+
+This happens during L<Bugzilla::Bug/create>, after all parameters have
+been validated, but before anything has been inserted into the database.
+
+Params:
+
+=over
+
+=item C<params>
+
+A hashref. The validated parameters passed to C<create>.
+
+=back
+
+=head2 bug_end_of_update
+
+This happens at the end of L<Bugzilla::Bug/update>, after all other changes are
+made to the database. This generally occurs inside a database transaction.
+
+Params:
+
+=over
+
+=item C<bug> 
+
+The changed bug object, with all fields set to their updated values.
+
+=item C<old_bug>
+
+A bug object pulled from the database before the fields were set to
+their updated values (so it has the old values available for each field).
+
+=item C<timestamp> 
+
+The timestamp used for all updates in this transaction, as a SQL date
+string.
+
+=item C<changes> 
+
+The hash of changed fields. C<< $changes->{field} = [old, new] >>
+
+=back
+
+=head2 bug_check_can_change_field
+
+This hook controls what fields users are allowed to change. You can add code
+here for site-specific policy changes and other customizations. 
+
+This hook is only executed if the field's new and old values differ. 
+
+Any denies take priority over any allows. So, if another extension denies
+a change but yours allows the change, the other extension's deny will
+override your extension's allow.
+
+Params:
+
+=over
+
+=item C<bug>
+
+L<Bugzilla::Bug> - The current bug object that this field is changing on.
+
+=item C<field>
+
+The name (from the C<fielddefs> table) of the field that we are checking.
+
+=item C<new_value>
+
+The new value that the field is being changed to.
+
+=item C<old_value>
+
+The old value that the field is being changed from.
+
+=item C<priv_results>
+
+C<array> - This is how you explicitly allow or deny a change. You should only
+push something into this array if you want to explicitly allow or explicitly
+deny the change, and thus skip all other permission checks that would otherwise
+happen after this hook is called. If you don't care about the field change,
+then don't push anything into the array.
+
+The pushed value should be a choice from the following constants:
+
+=over
+
+=item C<PRIVILEGES_REQUIRED_NONE>
+
+No privileges required. This explicitly B<allows> a change.
+
+=item C<PRIVILEGES_REQUIRED_REPORTER>
+
+User is not the reporter, assignee or an empowered user, so B<deny>.
+
+=item C<PRIVILEGES_REQUIRED_ASSIGNEE>
+
+User is not the assignee or an empowered user, so B<deny>.
+
+=item C<PRIVILEGES_REQUIRED_EMPOWERED>
+
+User is not a sufficiently empowered user, so B<deny>.
+
+=back
+
+=back
+
+=head2 bug_fields
+
+Allows the addition of database fields from the bugs table to the standard
+list of allowable fields in a L<Bugzilla::Bug> object, so that
+you can call the field as a method.
+
+Note: You should add here the names of any fields you added in L</bug_columns>.
+
+Params:
+
+=over
+
+=item C<columns> - A arrayref containing an array of column names. Push
+your column name(s) onto the array.
+
+=back
+
+=head2 bug_format_comment
+
+Allows you to do custom parsing on comments before they are displayed. You do
+this by returning two regular expressions: one that matches the section you
+want to replace, and then another that says what you want to replace that
+match with.
+
+The matching and replacement will be run with the C</g> switch on the regex.
+
+Params:
+
+=over
+
+=item C<regexes>
+
+An arrayref of hashrefs.
+
+You should push a hashref containing two keys (C<match> and C<replace>)
+in to this array. C<match> is the regular expression that matches the
+text you want to replace, C<replace> is what you want to replace that
+text with. (This gets passed into a regular expression like 
+C<s/$match/$replace/>.)
+
+Instead of specifying a regular expression for C<replace> you can also
+return a coderef (a reference to a subroutine). If you want to use
+backreferences (using C<$1>, C<$2>, etc. in your C<replace>), you have to use
+this method--it won't work if you specify C<$1>, C<$2> in a regular expression
+for C<replace>. Your subroutine will get a hashref as its only argument. This
+hashref contains a single key, C<matches>. C<matches> is an arrayref that
+contains C<$1>, C<$2>, C<$3>, etc. in order, up to C<$10>. Your subroutine
+should return what you want to replace the full C<match> with. (See the code
+example for this hook if you want to see how this actually all works in code.
+It's simpler than it sounds.)
+
+B<You are responsible for HTML-escaping your returned data.> Failing to
+do so could open a security hole in Bugzilla.
+
+=item C<text>
+
+A B<reference> to the exact text that you are parsing.
+
+Generally you should not modify this yourself. Instead you should be 
+returning regular expressions using the C<regexes> array.
+
+The text has not been parsed in any way. (So, for example, it is not
+HTML-escaped. You get "&", not "&amp;".)
+
+=item C<bug>
+
+The L<Bugzilla::Bug> object that this comment is on. Sometimes this is
+C<undef>, meaning that we are parsing text that is not on a bug.
+
+=item C<comment>
+
+A L<Bugzilla::Comment> object representing the comment you are about to
+parse.
+
+Sometimes this is C<undef>, meaning that we are parsing text that is
+not a bug comment (but could still be some other part of a bug, like
+the summary line).
+
+=item C<user>
+
+The L<Bugzilla::User> object representing the user who will see the text.
+This is useful to determine how much confidential information can be displayed
+to the user.
+
+=back
+
+=head2 bug_start_of_update
+
+This happens near the beginning of L<Bugzilla::Bug/update>, after L<Bugzilla::Object/update>
+is called, but before all other special changes are made to the database. Once use case is
+this allows for adding your own entries to the C<changes> hash which gets added to the
+bugs_activity table later keeping you from having to do it yourself. Also this is also helpful
+if your extension needs to add CC members, flags, keywords, groups, etc. This generally
+occurs inside a database transaction.
+
+Params:
+
+=over
+
+=item C<bug> 
+
+The changed bug object, with all fields set to their updated values.
+
+=item C<old_bug>
+
+A bug object pulled from the database before the fields were set to
+their updated values (so it has the old values available for each field).
+
+=item C<timestamp> 
+
+The timestamp used for all updates in this transaction, as a SQL date
+string.
+
+=item C<changes> 
+
+The hash of changed fields. C<< $changes->{field} = [old, new] >>
+
+=back
+
+=head2 bug_url_sub_classes
+
+Allows you to add more L<Bugzilla::BugUrl> sub-classes.
+
+See the C<MoreBugUrl> extension to see how things work.
+
+Params:
+
+=over
+
+=item C<sub_classes> - An arrayref of strings which represent L<Bugzilla::BugUrl>
+sub-classes.
+
+=back
+
+=head2 buglist_columns
+
+This happens in L<Bugzilla::Search/COLUMNS>, which determines legal bug
+list columns for F<buglist.cgi> and F<colchange.cgi>. It gives you the
+opportunity to add additional display columns.
+
+Params:
+
+=over
+
+=item C<columns> - A hashref, where the keys are unique string identifiers
+for the column being defined and the values are hashrefs with the
+following fields:
+
+=over
+
+=item C<name> - The name of the column in the database.
+
+=item C<title> - The title of the column as displayed to users.
+
+=back
+
+The definition is structured as:
+
+ $columns->{$id} = { name => $name, title => $title };
+
+=back
+
+=head2 buglist_column_joins
+
+This allows you to join additional tables to display additional columns
+in buglists. This hook is generally used in combination with the
+C<buglist_columns> hook.
+
+Params:
+
+=over
+
+=item C<column_joins> - A hashref containing data to return back to
+L<Bugzilla::Search>. This hashref contains names of the columns as keys and 
+a hashref about table to join as values. This hashref has the following keys:
+
+=over
+
+=item C<table> - The name of the additional table to join.
+
+=item C<as> - (optional) The alias used for the additional table. This alias
+must not conflict with an existing alias already used in the query.
+
+=item C<from> - (optional) The name of the column in the C<bugs> table which
+the additional table should be linked to. If omitted, C<bug_id> will be used.
+
+=item C<to> - (optional) The name of the column in the additional table which
+should be linked to the column in the C<bugs> table, see C<from> above.
+If omitted, C<bug_id> will be used.
+
+=item C<join> - (optional) Either INNER or LEFT. Determine how the additional
+table should be joined with the C<bugs> table. If omitted, LEFT is used.
+
+=back
+
+=back
+
+=head2 search_operator_field_override
+
+This allows you to modify L<Bugzilla::Search/OPERATOR_FIELD_OVERRIDE>,
+which determines the search functions for fields. It allows you to specify
+custom search functionality for certain fields. 
+
+See L<Bugzilla::Search/OPERATOR_FIELD_OVERRIDE> for reference and see
+the code in the example extension.
+
+Note that the interface to this hook is B<UNSTABLE> and it may change in the
+future.
+
+Params:
+
+=over
+
+=item C<operators> - See L<Bugzilla::Search/OPERATOR_FIELD_OVERRIDE> to get
+an idea of the structure.
+
+=item C<search> - The L<Bugzilla::Search> object.
+
+=back
+
+=head2 bugmail_recipients
+
+This allows you to modify the list of users who are going to be receiving
+a particular bugmail. It also allows you to specify why they are receiving
+the bugmail.
+
+Users' bugmail preferences will be applied to any users that you add
+to the list. (So, for example, if you add somebody as though they were
+a CC on the bug, and their preferences state that they don't get email
+when they are a CC, they won't get email.)
+
+This hook is called before watchers or globalwatchers are added to the
+recipient list.
+
+Params:
+
+=over
+
+=item C<bug>
+
+The L<Bugzilla::Bug> that bugmail is being sent about.
+
+=item C<recipients>
+
+This is a hashref. The keys are numeric user ids from the C<profiles>
+table in the database, for each user who should be receiving this bugmail.
+The values are hashrefs. The keys in I<these> hashrefs correspond to
+the "relationship" that the user has to the bug they're being emailed
+about, and the value should always be C<1>. The "relationships"
+are described by the various C<REL_> constants in L<Bugzilla::Constants>.
+
+Here's an example of adding userid C<123> to the recipient list
+as though he were on the CC list:
+
+ $recipients->{123}->{+REL_CC} = 1
+
+(We use C<+> in front of C<REL_CC> so that Perl interprets it as a constant
+instead of as a string.)
+
+=item C<users>
+
+This is a hash of L<Bugzilla::User> objects, keyed by id. This is so you can
+find out more information about any of the user ids in the C<recipients> hash.
+Every id in the incoming C<recipients> hash will have an object in here. 
+(But if you add additional recipients to the C<recipients> hash, you are 
+B<not> required to add them to this hash.)
+
+=item C<diffs>
+
+This is a list of hashes, each hash representing a change to the bug. Each 
+hash has the following members: C<field_name>, C<bug_when>, C<old>, C<new> 
+and C<who> (a L<Bugzilla::User>). If appropriate, there will also be 
+C<attach_id> or C<comment_id>; if either is present, there will be 
+C<isprivate>. See C<_get_diffs> in F<Bugzilla/BugMail.pm> to see exactly how 
+it is populated. Warning: the format and existence of the "diffs" parameter 
+is subject to change in future releases of Bugzilla.
+
+=back
+
+=head2 bugmail_relationships
+
+There are various sorts of "relationships" that a user can have to a bug,
+such as Assignee, CC, etc. If you want to add a new type of relationship,
+you should use this hook.
+
+Params:
+
+=over
+
+=item C<relationships>
+
+A hashref, where the keys are numbers and the values are strings.
+
+The keys represent a numeric identifier for the relationship. The
+numeric identifier should be a negative number between -1 and -127.
+The number must be unique across all extensions. (Negative numbers
+are used so as not to conflict with relationship identifiers in Bugzilla
+itself.)
+
+The value is the "name" of this relationship that will show up in email
+headers in bugmails. The "name" should be short and should contain no
+spaces.
+
+=back
+
+
+=head2 config_add_panels
+
+If you want to add new panels to the Parameters administrative interface,
+this is where you do it.
+
+Params:
+
+=over
+
+=item C<panel_modules>
+
+A hashref, where the keys are the "name" of the panel and the value
+is the Perl module representing that panel. For example, if
+the name is C<Auth>, the value would be C<Bugzilla::Config::Auth>.
+
+For your extension, the Perl module would start with 
+C<Bugzilla::Extension::Foo>, where "Foo" is the name of your Extension.
+(See the code in the example extension.)
+
+=back
+
+=head2 config_modify_panels
+
+This is how you modify already-existing panels in the Parameters
+administrative interface. For example, if you wanted to add a new
+Auth method (modifying Bugzilla::Config::Auth) this is how you'd
+do it.
+
+Params:
+
+=over
+
+=item C<panels>
+
+A hashref, where the keys are lower-case panel "names" (like C<auth>, 
+C<admin>, etc.) and the values are hashrefs. The hashref contains a
+single key, C<params>. C<params> is an arrayref--the return value from
+C<get_param_list> for that module. You can modify C<params> and
+your changes will be reflected in the interface.
+
+Adding new keys to C<panels> will have no effect. You should use
+L</config_add_panels> if you want to add new panels.
+
+=back
+
+=head2 email_in_before_parse
+
+This happens right after an inbound email is converted into an Email::MIME
+object, but before we start parsing the email to extract field data. This
+means the email has already been decoded for you. It gives you a chance
+to interact with the email itself before L<email_in> starts parsing its content.
+
+=over
+
+=item C<mail> - An Email::MIME object. The decoded incoming email.
+
+=item C<fields> - A hashref. The hash which will contain extracted data.
+
+=back
+
+=head2 email_in_after_parse
+
+This happens after all the data has been extracted from the email, but before
+the reporter is validated, during L<email_in>. This lets you do things after
+the normal parsing of the email, such as sanitizing field data, changing the
+user account being used to file a bug, etc.
+
+=over
+
+=item C<fields> - A hashref. The hash containing the extracted field data.
+
+=back
+
+=head2 enter_bug_entrydefaultvars
+
+B<DEPRECATED> - Use L</template_before_process> instead.
+
+This happens right before the template is loaded on enter_bug.cgi.
+
+Params:
+
+=over
+
+=item C<vars> - A hashref. The variables that will be passed into the template.
+
+=back
+
+=head2 error_catch
+
+This hook allows extensions to catch errors thrown by Bugzilla and
+take the appropriate actions.
+
+Params:
+
+=over
+
+=item C<error>
+
+A string representing the error code thrown by Bugzilla. This string
+matches the C<error> variable in C<global/user-error.html.tmpl> and
+C<global/code-error.html.tmpl>.
+
+=item C<message>
+
+If the error mode is set to C<ERROR_MODE_WEBPAGE>, you get a reference to
+the whole HTML page with the error message in it, including its header and
+footer. If you need to extract the error message itself, you can do it by
+looking at the content of the table cell whose ID is C<error_msg>.
+If the error mode is not set to C<ERROR_MODE_WEBPAGE>, you get a reference
+to the error message itself.
+
+=item C<vars>
+
+This hash contains all the data passed to the error template. Its content
+depends on the error thrown.
+
+=back
+
+=head2 flag_end_of_update
+
+This happens at the end of L<Bugzilla::Flag/update_flags>, after all other
+changes are made to the database and after emails are sent. It gives you a
+before/after snapshot of flags so you can react to specific flag changes.
+This generally occurs inside a database transaction.
+
+Note that the interface to this hook is B<UNSTABLE> and it may change in the
+future.
+
+Params:
+
+=over
+
+=item C<object> - The changed bug or attachment object.
+
+=item C<timestamp> - The timestamp used for all updates in this transaction,
+as a SQL date string.
+
+=item C<old_flags> - The snapshot of flag summaries from before the change.
+
+=item C<new_flags> - The snapshot of flag summaries after the change. Call
+C<my ($removed, $added) = diff_arrays(old_flags, new_flags)> to get the list of
+changed flags, and search for a specific condition like C<added eq 'review-'>.
+
+=back
+
+=head2 group_before_delete
+
+This happens in L<Bugzilla::Group/remove_from_db>, after we've confirmed
+that the group can be deleted, but before any rows have actually
+been removed from the database. This occurs inside a database
+transaction.
+
+Params:
+
+=over
+
+=item C<group> - The L<Bugzilla::Group> being deleted.
+
+=back
+
+=head2 group_end_of_create
+
+This happens at the end of L<Bugzilla::Group/create>, after all other
+changes are made to the database. This occurs inside a database transaction.
+
+Params:
+
+=over
+
+=item C<group> 
+
+The new L<Bugzilla::Group> object that was just created.
+
+=back
+
+=head2 group_end_of_update
+
+This happens at the end of L<Bugzilla::Group/update>, after all other 
+changes are made to the database. This occurs inside a database transaction.
+
+Params:
+
+=over
+
+=item C<group> - The changed L<Bugzilla::Group> object, with all fields set 
+to their updated values.
+
+=item C<changes> - The hash of changed fields. 
+C<< $changes->{$field} = [$old, $new] >>
+
+=back
+
+=head2 install_before_final_checks
+
+Allows execution of custom code before the final checks are done in 
+checksetup.pl.
+
+Params:
+
+=over
+
+=item C<silent>
+
+A flag that indicates whether or not checksetup is running in silent mode.
+If this is true, messages that are I<always> printed by checksetup.pl should be
+suppressed, but messages about any changes that are just being done this one
+time should be printed.
+
+=back
+
+=head2 install_filesystem
+
+Allows for additional files and directories to be added to the
+list of files and directories already managed by checksetup.pl.
+You will be able to also set permissions for the files and
+directories using this hook. You can also use this hook to create 
+appropriate .htaccess files for any directory to secure its contents.
+For examples see  L<FILESYSTEM> in L<Bugzilla::Install::Filesystem>.
+
+Params:
+
+=over
+
+=item C<files>
+
+Hash reference of files that are already present when your extension was
+installed but need to have specific permissions set. Each file key
+points to another hash reference containing the following settings.
+
+Params:
+
+=over
+
+=item C<perms> - Permissions to be set on the file.
+
+=back
+
+=item C<create_dirs>
+
+Hash reference containing the name of each directory that will be created,
+pointing at its default permissions.
+
+=item C<non_recurse_dirs>
+
+Hash reference containing directories that we want to set the perms on, but not
+recurse through. These are directories not created in checksetup.pl. Each directory
+key's value is the permissions to be set on the directory.
+
+=item C<recurse_dirs>
+
+Hash reference of directories that will have permissions set for each item inside 
+each of the directories, including the directory itself. Each directory key
+points to another hash reference containing the following settings.
+
+Params:
+
+=over
+
+=item C<files> - Permissions to be set on any files beneath the directory.
+
+=item C<dirs> - Permissions to be set on the directory itself and any directories
+beneath it.
+
+=back
+
+=item C<create_files>
+
+Hash reference of additional files to be created. Each file key points to another
+hash reference containing the following settings.
+
+Params:
+
+=over
+
+=item C<perms> - The permissions to be set on the file itself.
+
+=item C<contents> - The contents to be added to the file or leave blank for an
+empty file.
+
+=back
+
+=item C<htaccess>
+
+Hash reference containing htaccess files to be created. You can set the permissions
+for the htaccess as well as the contents of the file. Each file key points to another 
+hash reference containing the following settings.
+
+Params:
+
+=over
+
+=item C<perms> - Permissions to be set on the htaccess file.
+
+=item C<contents> - Contents of the htaccess file. It can be set manually or
+use L<HT_DEFAULT_DENY> defined in L<Bugzilla::Install::Filesystem> to deny all
+by default.
+
+=back
+
+=back
+
+=head2 install_update_db
+
+This happens at the very end of all the tables being updated
+during an installation or upgrade. If you need to modify your custom
+schema or add new columns to existing tables, do it here. No params are
+passed.
+
+=head2 install_update_db_fielddefs
+
+This is used to update the schema of the fielddefs table before
+any other schema changes take place. No params are passed.
+
+This hook should only be used for updating the schema of the C<fielddefs>
+table. Do not modify any other table in this hook. To modify other tables, use
+the L</install_update_db> hook.
+
+=head2 db_schema_abstract_schema
+
+This allows you to add tables to Bugzilla. Note that we recommend that you 
+prefix the names of your tables with some word (preferably the name of
+your Extension), so that they don't conflict with any future Bugzilla tables.
+
+If you wish to add new I<columns> to existing Bugzilla tables, do that
+in L</install_update_db>.
+
+Params:
+
+=over
+
+=item C<schema> - A hashref, in the format of 
+L<Bugzilla::DB::Schema/ABSTRACT_SCHEMA>. Add new hash keys to make new table
+definitions. F<checksetup.pl> will automatically add these tables to the
+database when run.
+
+=back
+
+=head2 job_map
+
+Bugzilla has a system - L<Bugzilla::JobQueue> - for running jobs 
+asynchronously, if the administrator has set it up. This hook allows the 
+addition of mappings from job names to handler classes, so an extension can 
+fire off jobs.
+
+Params:
+
+=over
+
+=item C<job_map> - The job map hash. Key: the name of the job, as should be 
+passed to Bugzilla->job_queue->insert(). Value: the name of the Perl module 
+which implements the task (an instance of L<TheSchwartz::Worker>). 
+
+=back
+
+=head2 mailer_before_send
+
+Called right before L<Bugzilla::Mailer> sends a message to the MTA.
+
+Params:
+
+=over
+
+=item C<email> - The C<Email::MIME> object that's about to be sent.
+
+=item C<mailer_args> - An arrayref that's passed as C<mailer_args> to
+L<Email::Send/new>.
+
+=back
+
+=head2 object_before_create
+
+This happens at the beginning of L<Bugzilla::Object/create>.
+
+Params:
+
+=over
+
+=item C<class>
+
+The name of the class that C<create> was called on. You can check this 
+like C<< if ($class->isa('Some::Class')) >> in your code, to perform specific
+tasks before C<create> for only certain classes.
+
+=item C<params>
+
+A hashref. The set of named parameters passed to C<create>.
+
+=back
+
+
+=head2 object_before_delete
+
+This happens in L<Bugzilla::Object/remove_from_db>, after we've confirmed
+that the object can be deleted, but before any rows have actually
+been removed from the database. This sometimes occurs inside a database
+transaction.
+
+Params:
+
+=over
+
+=item C<object> - The L<Bugzilla::Object> being deleted. You will probably
+want to check its type like C<< $object->isa('Some::Class') >> before doing
+anything with it.
+
+=back
+
+
+=head2 object_before_set
+
+Called during L<Bugzilla::Object/set>, before any actual work is done.
+You can use this to perform actions before a value is changed for
+specific fields on certain types of objects.
+
+Params:
+
+=over
+
+=item C<object>
+
+The object that C<set> was called on. You will probably want to
+do something like C<< if ($object->isa('Some::Class')) >> in your code to
+limit your changes to only certain subclasses of Bugzilla::Object.
+
+=item C<field>
+
+The name of the field being updated in the object.
+
+=item C<value> 
+
+The value being set on the object.
+
+=back
+
+=head2 object_columns
+
+This hook allows you to add new "fields" to existing Bugzilla objects,
+that correspond to columns in their tables.
+
+For example, if you added an C<example> column to the "bugs" table, you
+would have to also add an C<example> field to the C<Bugzilla::Bug> object
+in order to access that data via Bug objects.
+
+Don't do anything slow inside this hook--it's called several times on
+every page of Bugzilla.
+
+Params:
+
+=over
+
+=item C<class>
+
+The name of the class that this hook is being called on. You can check this 
+like C<< if ($class->isa('Some::Class')) >> in your code, to add new
+fields only for certain classes.
+
+=item C<columns>
+
+An arrayref. Add the string names of columns to this array to add new
+values to objects. 
+
+For example, if you add an C<example> column to a particular table
+(using L</install_update_db>), and then push the string C<example> into 
+this array for the object that uses that table, then you can access the
+information in that column via C<< $object->{example} >> on all objects
+of that type.
+
+This arrayref does not contain the standard column names--you cannot modify
+or remove standard object columns using this hook.
+
+=back
+
+=head2 object_end_of_create
+
+Called at the end of L<Bugzilla::Object/create>, after all other changes are
+made to the database. This occurs inside a database transaction.
+
+Params:
+
+=over
+
+=item C<class>
+
+The name of the class that C<create> was called on. You can check this 
+like C<< if ($class->isa('Some::Class')) >> in your code, to perform specific
+tasks for only certain classes.
+
+=item C<object>
+
+The created object.
+
+=back
+
+=head2 object_end_of_create_validators
+
+Called at the end of L<Bugzilla::Object/run_create_validators>. You can
+use this to run additional validation when creating an object.
+
+If a subclass has overridden C<run_create_validators>, then this usually
+happens I<before> the subclass does its custom validation.
+
+Params:
+
+=over
+
+=item C<class>
+
+The name of the class that C<create> was called on. You can check this 
+like C<< if ($class->isa('Some::Class')) >> in your code, to perform specific
+tasks for only certain classes.
+
+=item C<params>
+
+A hashref. The set of named parameters passed to C<create>, modified and
+validated by the C<VALIDATORS> specified for the object.
+
+=back
+
+
+=head2 object_end_of_set
+
+Called during L<Bugzilla::Object/set>, after all the code of the function
+has completed (so the value has been validated and the field has been set
+to the new value). You can use this to perform actions after a value is
+changed for specific fields on certain types of objects.
+
+The new value is not specifically passed to this hook because you can
+get it as C<< $object->{$field} >>.
+
+Params:
+
+=over
+
+=item C<object>
+
+The object that C<set> was called on. You will probably want to
+do something like C<< if ($object->isa('Some::Class')) >> in your code to
+limit your changes to only certain subclasses of Bugzilla::Object.
+
+=item C<field>
+
+The name of the field that was updated in the object.
+
+=back
+
+
+=head2 object_end_of_set_all
+
+This happens at the end of L<Bugzilla::Object/set_all>. This is a
+good place to call custom set_ functions on objects, or to make changes
+to an object before C<update()> is called.
+
+Params:
+
+=over
+
+=item C<object>
+
+The L<Bugzilla::Object> which is being updated. You will probably want to
+do something like C<< if ($object->isa('Some::Class')) >> in your code to
+limit your changes to only certain subclasses of Bugzilla::Object.
+
+=item C<params>
+
+A hashref. The set of named parameters passed to C<set_all>.
+
+=back
+
+=head2 object_end_of_update
+
+Called during L<Bugzilla::Object/update>, after changes are made
+to the database, but while still inside a transaction.
+
+Params:
+
+=over
+
+=item C<object>
+
+The object that C<update> was called on. You will probably want to
+do something like C<< if ($object->isa('Some::Class')) >> in your code to
+limit your changes to only certain subclasses of Bugzilla::Object.
+
+=item C<old_object>
+
+The object as it was before it was updated.
+
+=item C<changes>
+
+The fields that have been changed, in the same format that
+L<Bugzilla::Object/update> returns.
+
+=back
+
+=head2 object_update_columns
+
+If you've added fields to bugs via L</object_columns>, then this
+hook allows you to say which of those columns should be updated in the
+database when L<Bugzilla::Object/update> is called on the object.
+
+If you don't use this hook, then your custom columns won't be modified in
+the database by Bugzilla.
+
+Params:
+
+=over
+
+=item C<object>
+
+The object that is about to be updated. You should check this
+like C<< if ($object->isa('Some::Class')) >> in your code, to modify
+the "update columns" only for certain classes.
+
+=item C<columns>
+
+An arrayref. Add the string names of columns to this array to allow
+that column to be updated when C<update()> is called on the object.
+
+This arrayref does not contain the standard column names--you cannot stop
+standard columns from being updated by using this hook.
+
+=back
+
+=head2 object_validators
+
+Allows you to add new items to L<Bugzilla::Object/VALIDATORS> for
+particular classes.
+
+Params:
+
+=over
+
+=item C<class>
+
+The name of the class that C<VALIDATORS> was called on. You can check this 
+like C<< if ($class->isa('Some::Class')) >> in your code, to add
+validators only for certain classes.
+
+=item C<validators>
+
+A hashref, where the keys are database columns and the values are subroutine
+references. You can add new validators or modify existing ones. If you modify
+an existing one, you should remember to call the original validator
+inside of your modified validator. (This way, several extensions can all
+modify the same validator.)
+
+=back
+
+
+=head2 page_before_template
+
+This is a simple way to add your own pages to Bugzilla. This hooks C<page.cgi>,
+which loads templates from F<template/en/default/pages>. For example,
+C<page.cgi?id=fields.html> loads F<template/en/default/pages/fields.html.tmpl>.
+
+This hook is called right before the template is loaded, so that you can
+pass your own variables to your own pages.
+
+You can also use this to implement complex custom pages, by doing your own
+output and then calling  C<exit> at the end of the hook, thus preventing
+the normal C<page.cgi> behavior from occurring.
+
+Params:
+
+=over
+
+=item C<page_id>
+
+This is the name of the page being loaded, like C<fields.html>.
+
+Note that if two extensions use the same name, it is uncertain which will
+override the others, so you should be careful with how you name your pages.
+Usually extensions prefix their pages with a directory named after their
+extension, so for an extension named "Foo", page ids usually look like
+C<foo/mypage.html>.
+
+=item C<vars>
+
+This is a hashref--put variables into here if you want them passed to
+your template.
+
+=back
+
+=head2 path_info_whitelist
+
+By default, Bugzilla removes the Path-Info information from URLs before
+passing data to CGI scripts. If this information is needed for your
+customizations, you can enumerate the pages you want to whitelist here.
+
+Params:
+
+=over
+
+=item C<whitelist>
+
+An array of script names that will not have their Path-Info automatically
+removed.
+
+=back
+
+=head2 post_bug_after_creation
+
+B<DEPRECATED> (Use L</bug_end_of_create> instead.)
+
+This happens after a bug is created and before bug mail is sent
+during C<post_bug.cgi>. Note that this only happens during C<post_bug.cgi>,
+it doesn't happen during any of the other methods of creating a bug.
+
+Params:
+
+=over
+
+=item C<vars> - The template vars hashref.
+
+=back
+
+
+=head2 product_confirm_delete
+
+B<DEPRECATED> - Use L</template_before_process> instead.
+
+Called before displaying the confirmation message when deleting a product.
+
+Params:
+
+=over
+
+=item C<vars> - The template vars hashref.
+
+=back
+
+=head2 product_end_of_create
+
+Called right after a new product has been created, allowing additional
+changes to be made to the new product's attributes. This occurs inside of
+a database transaction, so if the hook throws an error, all previous
+changes will be rolled back, including the creation of the new product.
+(However, note that such rollbacks should not normally be used, as
+some databases that Bugzilla supports have very bad rollback performance.
+If you want to validate input and throw errors before the Product is created,
+use L</object_end_of_create_validators> instead, or add a validator 
+using L</object_validators>.)
+
+Params:
+
+=over
+
+=item C<product> - The new L<Bugzilla::Product> object that was just created.
+
+=back
+
+=head2 quicksearch_map
+
+This hook allows you to alter the Quicksearch syntax to include e.g. special 
+searches for custom fields you have.
+
+Params:
+
+=over
+
+=item C<map> - a hash where the key is the name you want to use in 
+Quicksearch, and the value is the name from the C<fielddefs> table that you 
+want it to map to. You can modify existing mappings or add new ones.
+
+=back
+
+=head2 sanitycheck_check
+
+This hook allows for extra sanity checks to be added, for use by
+F<sanitycheck.cgi>.
+
+Params:
+
+=over
+
+=item C<status> - a CODEREF that allows status messages to be displayed
+to the user. (F<sanitycheck.cgi>'s C<Status>)
+
+=back
+
+=head2 sanitycheck_repair
+
+This hook allows for extra sanity check repairs to be made, for use by
+F<sanitycheck.cgi>.
+
+Params:
+
+=over
+
+=item C<status> - a CODEREF that allows status messages to be displayed
+to the user. (F<sanitycheck.cgi>'s C<Status>)
+
+=back
+
+=head2 template_before_create
+
+This hook allows you to modify the configuration of L<Bugzilla::Template>
+objects before they are created. For example, you could add a new
+global template variable this way.
+
+Params:
+
+=over
+
+=item C<config>
+
+A hashref--the configuration that will be passed to L<Template/new>.
+See L<http://template-toolkit.org/docs/modules/Template.html#section_CONFIGURATION_SUMMARY>
+for information on how this configuration variable is structured (or just
+look at the code for C<create> in L<Bugzilla::Template>.)
+
+=back
+
+=head2 template_before_process
+
+This hook is called any time Bugzilla processes a template file, including
+calls to C<< $template->process >>, C<PROCESS> statements in templates,
+and C<INCLUDE> statements in templates. It is not called when templates
+process a C<BLOCK>, only when they process a file.
+
+This hook allows you to define additional variables that will be available to
+the template being processed, or to modify the variables that are currently
+in the template. It works exactly as though you inserted code to modify
+template variables at the top of a template.
+
+You probably want to restrict this hook to operating only if a certain 
+file is being processed (which is why you get a C<file> argument
+below). Otherwise, modifying the C<vars> argument will affect every single
+template in Bugzilla.
+
+B<Note:> This hook is not called if you are already in this hook.
+(That is, it won't call itself recursively.) This prevents infinite
+recursion in situations where this hook needs to process a template
+(such as if this hook throws an error).
+
+Params:
+
+=over
+
+=item C<vars>
+
+This is the entire set of variables that the current template can see.
+Technically, this is a L<Template::Stash> object, but you can just
+use it like a hashref if you want.
+
+=item C<file>
+
+The name of the template file being processed. This is relative to the
+main template directory for the language (i.e. for
+F<template/en/default/bug/show.html.tmpl>, this variable will contain
+C<bug/show.html.tmpl>).
+
+=item C<context>
+
+A L<Template::Context> object. Usually you will not have to use this, but
+if you need information about the template itself (other than just its
+name), you can get it from here.
+
+=back
+
+=head2 user_preferences
+
+This hook allows you to add additional panels to the User Preferences page,
+and validate data displayed and returned from these panels. It works in
+combination with the C<tabs> hook available in the
+F<template/en/default/account/prefs/prefs.html.tmpl> template. To make it
+work, you must define two templates in your extension:
+F<extensions/Foo/template/en/default/hook/account/prefs/prefs-tabs.html.tmpl>
+contains a list of additional panels to include.
+F<extensions/Foo/template/en/default/account/prefs/bar.html.tmpl> contains
+the content of the panel itself. See the C<Example> extension to see how
+things work.
+
+Params:
+
+=over
+
+=item C<current_tab>
+
+The name of the current panel being viewed by the user. You should always
+make sure that the name of the panel matches what you expect it to be.
+Else you could be interacting with the panel of another extension.
+
+=item C<save_changes>
+
+A boolean which is true when data should be validated and the DB updated
+accordingly. This means the user clicked the "Submit Changes" button.
+
+=item C<handled>
+
+This is a B<reference> to a scalar, not a scalar. (So you would set it like
+C<$$handled = 1>, not like C<$handled = 1>.) Set this to a true value to let
+Bugzilla know that the passed-in panel is valid and that you have handled it.
+(Otherwise, Bugzilla will throw an error that the panel is invalid.) Don't set
+this to true if you didn't handle the panel listed in C<current_tab>.
+
+=item C<vars>
+
+You can add as many new key/value pairs as you want to this hashref.
+It will be passed to the template.
+
+=back
+
+=head2 webservice
+
+This hook allows you to add your own modules to the WebService. (See
+L<Bugzilla::WebService>.)
+
+Params:
+
+=over
+
+=item C<dispatch>
+
+A hashref where you can specify the names of your modules and which Perl
+module handles the functions for that module. (This is actually sent to 
+L<SOAP::Lite/dispatch_with>. You can see how that's used in F<xmlrpc.cgi>.)
+
+The Perl module name will most likely start with C<Bugzilla::Extension::Foo::>
+(where "Foo" is the name of your extension).
+
+Example:
+
+  $dispatch->{'Example.Blah'} = "Bugzilla::Extension::Example::Webservice::Blah";
+
+And then you'd have a module F<extensions/Example/lib/Webservice/Blah.pm>,
+and could call methods from that module like C<Example.Blah.Foo()> using
+the WebServices interface.
+
+It's recommended that all the keys you put in C<dispatch> start with the
+name of your extension, so that you don't conflict with the standard Bugzilla
+WebService functions (and so that you also don't conflict with other
+plugins).
+
+=back
+
+=head2 webservice_error_codes
+
+If your webservice extension throws custom errors, you can set numeric
+codes for those errors here.
+
+Extensions should use error codes above 10000, unless they are re-using
+an already-existing error code.
+
+Params:
+
+=over
+
+=item C<error_map>
+
+A hash that maps the names of errors (like C<invalid_param>) to numbers.
+See L<Bugzilla::WebService::Constants/WS_ERROR_CODE> for an example.
+
+=back
+
+=head1 SEE ALSO
+
+L<Bugzilla::Extension>

diff --git a/Bugzilla/Install.pm b/Bugzilla/Install.pm
new file mode 100644 (file)
index 0000000..4954dbf
--- /dev/null
+++ b/Bugzilla/Install.pm
@@ -0,0 +1,494 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Install;
+
+# Functions in this this package can assume that the database 
+# has been set up, params are available, localconfig is
+# available, and any module can be used.
+#
+# If you want to write an installation function that can't
+# make those assumptions, then it should go into one of the
+# packages under the Bugzilla::Install namespace.
+
+use strict;
+
+use Bugzilla::Component;
+use Bugzilla::Config qw(:admin);
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Group;
+use Bugzilla::Product;
+use Bugzilla::User;
+use Bugzilla::User::Setting;
+use Bugzilla::Util qw(get_text say);
+use Bugzilla::Version;
+
+use constant STATUS_WORKFLOW => (
+    [undef, 'UNCONFIRMED'],
+    [undef, 'CONFIRMED'],
+    [undef, 'IN_PROGRESS'],
+    ['UNCONFIRMED', 'CONFIRMED'],
+    ['UNCONFIRMED', 'IN_PROGRESS'],
+    ['UNCONFIRMED', 'RESOLVED'],
+    ['CONFIRMED',   'IN_PROGRESS'],
+    ['CONFIRMED',   'RESOLVED'],
+    ['IN_PROGRESS', 'CONFIRMED'],
+    ['IN_PROGRESS', 'RESOLVED'],
+    ['RESOLVED',    'UNCONFIRMED'],
+    ['RESOLVED',    'CONFIRMED'],
+    ['RESOLVED',    'VERIFIED'],
+    ['VERIFIED',    'UNCONFIRMED'],
+    ['VERIFIED',    'CONFIRMED'],
+);
+
+sub SETTINGS {
+    return {
+    # 2005-03-03 travis@sedsystems.ca -- Bug 41972
+    display_quips      => { options => ["on", "off"], default => "on" },
+    # 2005-03-10 travis@sedsystems.ca -- Bug 199048
+    comment_sort_order => { options => ["oldest_to_newest", "newest_to_oldest",
+                                        "newest_to_oldest_desc_first"],
+                            default => "oldest_to_newest" },
+    # 2005-05-12 bugzilla@glob.com.au -- Bug 63536
+    post_bug_submit_action => { options => ["next_bug", "same_bug", "nothing"],
+                                default => "next_bug" },
+    # 2005-06-29 wurblzap@gmail.com -- Bug 257767
+    csv_colsepchar     => { options => [',',';'], default => ',' },
+    # 2005-10-26 wurblzap@gmail.com -- Bug 291459
+    zoom_textareas     => { options => ["on", "off"], default => "on" },
+    # 2006-05-01 olav@bkor.dhs.org -- Bug 7710
+    state_addselfcc    => { options => ['always', 'never',  'cc_unless_role'],
+                            default => 'cc_unless_role' },
+    # 2006-08-04 wurblzap@gmail.com -- Bug 322693
+    skin               => { subclass => 'Skin', default => 'Dusk' },
+    # 2006-12-10 LpSolit@gmail.com -- Bug 297186
+    lang               => { subclass => 'Lang',
+                            default => ${Bugzilla->languages}[0] },
+    # 2007-07-02 altlist@gmail.com -- Bug 225731
+    quote_replies      => { options => ['quoted_reply', 'simple_reply', 'off'],
+                            default => "quoted_reply" },
+    # 2009-02-01 mozilla@matt.mchenryfamily.org -- Bug 398473
+    comment_box_position => { options => ['before_comments', 'after_comments'],
+                              default => 'before_comments' },
+    # 2008-08-27 LpSolit@gmail.com -- Bug 182238
+    timezone           => { subclass => 'Timezone', default => 'local' },
+    # 2011-02-07 dkl@mozilla.com -- Bug 580490
+    quicksearch_fulltext => { options => ['on', 'off'], default => 'on' },
+    # 2011-06-21 glob@mozilla.com -- Bug 589128
+    email_format       => { options => ['html', 'text_only'],
+                            default => 'html' },
+    # 2011-10-11 glob@mozilla.com -- Bug 301656
+    requestee_cc       => { options => ['on', 'off'], default => 'on' },
+    # 2012-04-30 glob@mozilla.com -- Bug 663747
+    bugmail_new_prefix => { options => ['on', 'off'], default => 'on' },
+    }
+};
+
+use constant SYSTEM_GROUPS => (
+    {
+        name        => 'admin',
+        description => 'Administrators'
+    },
+    {
+        name        => 'tweakparams',
+        description => 'Can change Parameters'
+    },
+    {
+        name        => 'editusers',
+        description => 'Can edit or disable users'
+    },
+    {
+        name        => 'creategroups',
+        description => 'Can create and destroy groups'
+    },
+    {
+        name        => 'editclassifications',
+        description => 'Can create, destroy, and edit classifications'
+    },
+    {
+        name        => 'editcomponents',
+        description => 'Can create, destroy, and edit components'
+    },
+    {
+        name        => 'editkeywords',
+        description => 'Can create, destroy, and edit keywords'
+    },
+    {
+        name        => 'editbugs',
+        description => 'Can edit all bug fields',
+        userregexp  => '.*'
+    },
+    {
+        name        => 'canconfirm',
+        description => 'Can confirm a bug or mark it a duplicate'
+    },
+    {
+        name         => 'bz_canusewhineatothers',
+        description  => 'Can configure whine reports for other users',
+    },
+    {
+        name         => 'bz_canusewhines',
+        description  => 'User can configure whine reports for self',
+        # inherited_by means that users in the groups listed below are
+        # automatically members of bz_canusewhines.
+        inherited_by => ['editbugs', 'bz_canusewhineatothers'],
+    },
+    {
+        name        => 'bz_sudoers',
+        description => 'Can perform actions as other users',
+    },
+    {
+        name         => 'bz_sudo_protect',
+        description  => 'Can not be impersonated by other users',
+        inherited_by => ['bz_sudoers'],
+    },
+    {
+        name         => 'bz_quip_moderators',
+        description  => 'Can moderate quips',
+    },
+);
+
+use constant DEFAULT_CLASSIFICATION => {
+    name        => 'Unclassified',
+    description => 'Not assigned to any classification'
+};
+
+use constant DEFAULT_PRODUCT => {
+    name => 'TestProduct',
+    description => 'This is a test product.'
+        . ' This ought to be blown away and replaced with real stuff in a'
+        . ' finished installation of bugzilla.',
+    version => Bugzilla::Version::DEFAULT_VERSION,
+    classification => 'Unclassified',
+    defaultmilestone => DEFAULT_MILESTONE,
+};
+
+use constant DEFAULT_COMPONENT => {
+    name => 'TestComponent',
+    description => 'This is a test component in the test product database.'
+        . ' This ought to be blown away and replaced with real stuff in'
+        . ' a finished installation of Bugzilla.'
+};
+
+sub update_settings {
+    my $dbh = Bugzilla->dbh;
+    # If we're setting up settings for the first time, we want to be quieter.
+    my $any_settings = $dbh->selectrow_array(
+        'SELECT 1 FROM setting ' . $dbh->sql_limit(1));
+    if (!$any_settings) {
+        say get_text('install_setting_setup');
+    }
+
+    my %settings = %{SETTINGS()};
+    foreach my $setting (keys %settings) {
+        add_setting($setting,
+                    $settings{$setting}->{options}, 
+                    $settings{$setting}->{default},
+                    $settings{$setting}->{subclass}, undef,
+                    !$any_settings);
+    }
+
+    # Delete the obsolete 'per_bug_queries' user preference. Bug 616191.
+    $dbh->do('DELETE FROM setting WHERE name = ?', undef, 'per_bug_queries');
+}
+
+sub update_system_groups {
+    my $dbh = Bugzilla->dbh;
+
+    $dbh->bz_start_transaction();
+
+    # If there is no editbugs group, this is the first time we're
+    # adding groups.
+    my $editbugs_exists = new Bugzilla::Group({ name => 'editbugs' });
+    if (!$editbugs_exists) {
+        say get_text('install_groups_setup');
+    }
+
+    # Create most of the system groups
+    foreach my $definition (SYSTEM_GROUPS) {
+        my $exists = new Bugzilla::Group({ name => $definition->{name} });
+        if (!$exists) {
+            $definition->{isbuggroup} = 0;
+            $definition->{silently} = !$editbugs_exists;
+            my $inherited_by = delete $definition->{inherited_by};
+            my $created = Bugzilla::Group->create($definition);
+            # Each group in inherited_by is automatically a member of this
+            # group.
+            if ($inherited_by) {
+                foreach my $name (@$inherited_by) {
+                    my $member = Bugzilla::Group->check($name);
+                    $dbh->do('INSERT INTO group_group_map (grantor_id, 
+                                          member_id) VALUES (?,?)',
+                             undef, $created->id, $member->id);
+                }
+            }
+        }
+    }
+
+    $dbh->bz_commit_transaction();
+}
+
+sub create_default_classification {
+    my $dbh = Bugzilla->dbh;
+
+    # Make the default Classification if it doesn't already exist.
+    if (!$dbh->selectrow_array('SELECT 1 FROM classifications')) {
+        print get_text('install_default_classification',
+                       { name => DEFAULT_CLASSIFICATION->{name} }) . "\n";
+        Bugzilla::Classification->create(DEFAULT_CLASSIFICATION);
+    }
+}
+
+# This function should be called only after creating the admin user.
+sub create_default_product {
+    my $dbh = Bugzilla->dbh;
+
+    # And same for the default product/component.
+    if (!$dbh->selectrow_array('SELECT 1 FROM products')) {
+        print get_text('install_default_product', 
+                       { name => DEFAULT_PRODUCT->{name} }) . "\n";
+
+        my $product = Bugzilla::Product->create(DEFAULT_PRODUCT);
+
+        # Get the user who will be the owner of the Component.
+        # We pick the admin with the lowest id, which is probably the
+        # admin checksetup.pl just created.
+        my $admin_group = new Bugzilla::Group({name => 'admin'});
+        my ($admin_id)  = $dbh->selectrow_array(
+            'SELECT user_id FROM user_group_map WHERE group_id = ?
+           ORDER BY user_id ' . $dbh->sql_limit(1),
+            undef, $admin_group->id);
+        my $admin = Bugzilla::User->new($admin_id);
+
+        Bugzilla::Component->create({
+            %{ DEFAULT_COMPONENT() }, product => $product,
+            initialowner => $admin->login });
+    }
+
+}
+
+sub init_workflow {
+    my $dbh = Bugzilla->dbh;
+    my $has_workflow = $dbh->selectrow_array('SELECT 1 FROM status_workflow');
+    return if $has_workflow;
+
+    say get_text('install_workflow_init');
+
+    my %status_ids = @{ $dbh->selectcol_arrayref(
+        'SELECT value, id FROM bug_status', {Columns=>[1,2]}) };
+
+    foreach my $pair (STATUS_WORKFLOW) {
+        my $old_id = $pair->[0] ? $status_ids{$pair->[0]} : undef;
+        my $new_id = $status_ids{$pair->[1]};
+        $dbh->do('INSERT INTO status_workflow (old_status, new_status)
+                       VALUES (?,?)', undef, $old_id, $new_id);
+    }
+}
+
+sub create_admin {
+    my ($params) = @_;
+    my $dbh      = Bugzilla->dbh;
+    my $template = Bugzilla->template;
+
+    my $admin_group = new Bugzilla::Group({ name => 'admin' });
+    my $admin_inheritors = 
+        Bugzilla::Group->flatten_group_membership($admin_group->id);
+    my $admin_group_ids = join(',', @$admin_inheritors);
+
+    my ($admin_count) = $dbh->selectrow_array(
+        "SELECT COUNT(*) FROM user_group_map 
+          WHERE group_id IN ($admin_group_ids)");
+
+    return if $admin_count;
+
+    my %answer    = %{Bugzilla->installation_answers};
+    my $login     = $answer{'ADMIN_EMAIL'};
+    my $password  = $answer{'ADMIN_PASSWORD'};
+    my $full_name = $answer{'ADMIN_REALNAME'};
+
+    if (!$login || !$password || !$full_name) {
+        say "\n" . get_text('install_admin_setup') . "\n";
+    }
+
+    while (!$login) {
+        print get_text('install_admin_get_email') . ' ';
+        $login = <STDIN>;
+        chomp $login;
+        eval { Bugzilla::User->check_login_name($login); };
+        if ($@) {
+            say $@;
+            undef $login;
+        }
+    }
+
+    while (!defined $full_name) {
+        print get_text('install_admin_get_name') . ' ';
+        $full_name = <STDIN>;
+        chomp($full_name);
+    }
+
+    if (!$password) {
+        $password = _prompt_for_password(
+            get_text('install_admin_get_password'));
+    }
+
+    my $admin = Bugzilla::User->create({ login_name    => $login, 
+                                         realname      => $full_name,
+                                         cryptpassword => $password });
+    make_admin($admin);
+}
+
+sub make_admin {
+    my ($user) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    $user = ref($user) ? $user 
+            : new Bugzilla::User(login_to_id($user, THROW_ERROR));
+
+    my $group_insert = $dbh->prepare(
+        'INSERT INTO user_group_map (user_id, group_id, isbless, grant_type)
+              VALUES (?, ?, ?, ?)');
+
+    # Admins get explicit membership and bless capability for the admin group
+    my $admin_group = new Bugzilla::Group({ name => 'admin' });
+    # These are run in an eval so that we can ignore the error of somebody
+    # already being granted these things.
+    eval { 
+        $group_insert->execute($user->id, $admin_group->id, 0, GRANT_DIRECT); 
+    };
+    eval {
+        $group_insert->execute($user->id, $admin_group->id, 1, GRANT_DIRECT);
+    };
+
+    # Admins should also have editusers directly, even though they'll usually
+    # inherit it. People could have changed their inheritance structure.
+    my $editusers = new Bugzilla::Group({ name => 'editusers' });
+    eval { 
+        $group_insert->execute($user->id, $editusers->id, 0, GRANT_DIRECT); 
+    };
+
+    # If there is no maintainer set, make this user the maintainer.
+    if (!Bugzilla->params->{'maintainer'}) {
+        SetParam('maintainer', $user->email);
+        write_params();
+    }
+
+    # Make sure the new admin isn't disabled
+    if ($user->disabledtext) {
+        $user->set_disabledtext('');
+        $user->update();
+    }
+
+    if (Bugzilla->usage_mode == USAGE_MODE_CMDLINE) {
+        say "\n", get_text('install_admin_created', { user => $user });
+    }
+}
+
+sub _prompt_for_password {
+    my $prompt = shift;
+
+    my $password;
+    while (!$password) {
+        # trap a few interrupts so we can fix the echo if we get aborted.
+        local $SIG{HUP}  = \&_password_prompt_exit;
+        local $SIG{INT}  = \&_password_prompt_exit;
+        local $SIG{QUIT} = \&_password_prompt_exit;
+        local $SIG{TERM} = \&_password_prompt_exit;
+
+        system("stty","-echo") unless ON_WINDOWS;  # disable input echoing
+
+        print $prompt, ' ';
+        $password = <STDIN>;
+        chomp $password;
+        print "\n", get_text('install_confirm_password'), ' ';
+        my $pass2 = <STDIN>;
+        chomp $pass2;
+        eval { validate_password($password, $pass2); };
+        if ($@) {
+            say "\n$@";
+            undef $password;
+        }
+        system("stty","echo") unless ON_WINDOWS;
+    }
+    return $password;
+}
+
+# This is just in case we get interrupted while getting a password.
+sub _password_prompt_exit {
+    # re-enable input echoing
+    system("stty","echo") unless ON_WINDOWS;
+    exit 1;
+}
+
+sub reset_password {
+    my $login = shift;
+    my $user = Bugzilla::User->check($login);
+    my $prompt = "\n" . get_text('install_reset_password', { user => $user });
+    my $password = _prompt_for_password($prompt);
+    $user->set_password($password);
+    $user->update();
+    say "\n", get_text('install_reset_password_done');
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Install - Functions and variables having to do with
+  installation.
+
+=head1 SYNOPSIS
+
+ use Bugzilla::Install;
+ Bugzilla::Install::update_settings();
+
+=head1 DESCRIPTION
+
+This module is used primarily by L<checksetup.pl> during installation.
+This module contains functions that deal with general installation
+issues after the database is completely set up and configured.
+
+=head1 CONSTANTS
+
+=over
+
+=item C<SETTINGS>
+
+Contains information about Settings, used by L</update_settings()>.
+
+=back
+
+=head1 SUBROUTINES
+
+=over
+
+=item C<update_settings()>
+
+Description: Adds and updates Settings for users.
+
+Params:      none
+
+Returns:     nothing.
+
+=item C<create_default_classification>
+
+Creates the default "Unclassified" L<Classification|Bugzilla::Classification>
+if it doesn't already exist
+
+=item C<create_default_product()>
+
+Description: Creates the default product and component if
+             they don't exist.
+
+Params:      none
+
+Returns:     nothing
+
+=back

diff --git a/Bugzilla/Install/CPAN.pm b/Bugzilla/Install/CPAN.pm
new file mode 100644 (file)
index 0000000..92ab5a2
--- /dev/null
+++ b/Bugzilla/Install/CPAN.pm
@@ -0,0 +1,344 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Install::CPAN;
+use strict;
+use base qw(Exporter);
+our @EXPORT = qw(
+    BZ_LIB
+
+    check_cpan_requirements 
+    set_cpan_config
+    install_module 
+);
+
+use Bugzilla::Constants;
+use Bugzilla::Install::Requirements qw(have_vers);
+use Bugzilla::Install::Util qw(bin_loc install_string);
+
+use Config;
+use CPAN;
+use Cwd qw(abs_path);
+use File::Path qw(rmtree);
+use List::Util qw(shuffle);
+
+# These are required for install-module.pl to be able to install
+# all modules properly.
+use constant REQUIREMENTS => (
+    {
+        module  => 'CPAN',
+        package => 'CPAN',
+        version => '1.81',
+    },
+    {
+        # When Module::Build isn't installed, the YAML module allows
+        # CPAN to read META.yml to determine that Module::Build first
+        # needs to be installed to compile a module.
+        module  => 'YAML',
+        package => 'YAML',
+        version => 0,
+    },
+    {
+        # Many modules on CPAN are now built with Dist::Zilla, which
+        # unfortunately means they require this version of EU::MM to install.
+        module  => 'ExtUtils::MakeMaker',
+        package => 'ExtUtils-MakeMaker',
+        version => '6.31',
+    },
+);
+
+# We need the absolute path of ext_libpath, because CPAN chdirs around
+# and so we can't use a relative directory.
+#
+# We need it often enough (and at compile time, in install-module.pl) so 
+# we make it a constant.
+use constant BZ_LIB => abs_path(bz_locations()->{ext_libpath});
+
+# CPAN requires nearly all of its parameters to be set, or it will start
+# asking questions to the user. We want to avoid that, so we have
+# defaults here for most of the required parameters we know about, in case
+# any of them aren't set. The rest are handled by set_cpan_defaults().
+use constant CPAN_DEFAULTS => {
+    auto_commit => 0,
+    # We always force builds, so there's no reason to cache them.
+    build_cache => 0,
+    build_requires_install_policy => 'yes',
+    cache_metadata => 1,
+    colorize_output => 1,
+    colorize_print => 'bold',
+    index_expire => 1,
+    scan_cache => 'atstart',
+
+    inhibit_startup_message => 1,
+
+    bzip2 => bin_loc('bzip2'),
+    curl => bin_loc('curl'),
+    gzip => bin_loc('gzip'),
+    links => bin_loc('links'),
+    lynx => bin_loc('lynx'),
+    make => bin_loc('make'),
+    pager => bin_loc('less'),
+    tar => bin_loc('tar'),
+    unzip => bin_loc('unzip'),
+    wget => bin_loc('wget'),
+
+    urllist => [shuffle qw(
+        http://cpan.pair.com/
+        http://mirror.hiwaay.net/CPAN/
+        ftp://ftp.dc.aleron.net/pub/CPAN/
+        http://mirrors.kernel.org/cpan/
+        http://mirrors2.kernel.org/cpan/)],
+};
+
+sub check_cpan_requirements {
+    my ($original_dir, $original_args) = @_;
+
+    _require_compiler();
+
+    my @install;
+    foreach my $module (REQUIREMENTS) {
+        my $installed = have_vers($module, 1);
+        push(@install, $module) if !$installed;
+    }
+
+    return if !@install;
+
+    my $restart_required;
+    foreach my $module (@install) {
+        $restart_required = 1 if $module->{module} eq 'CPAN';
+        install_module($module->{module}, 1);
+    }
+
+    if ($restart_required) {
+        chdir $original_dir;
+        exec($^X, $0, @$original_args);
+    }
+}
+
+sub _require_compiler {
+    my @errors;
+
+    my $cc_name = $Config{cc};
+    my $cc_exists = bin_loc($cc_name);
+
+    if (!$cc_exists) {
+        push(@errors, install_string('install_no_compiler'));
+    }
+
+    my $make_name = $CPAN::Config->{make};
+    my $make_exists = bin_loc($make_name);
+
+    if (!$make_exists) {
+        push(@errors, install_string('install_no_make'));
+    }
+
+    die @errors if @errors;
+}
+
+sub install_module {
+    my ($name, $test) = @_;
+    my $bzlib = BZ_LIB;
+
+    # Make Module::AutoInstall install all dependencies and never prompt.
+    local $ENV{PERL_AUTOINSTALL} = '--alldeps';
+    # This makes Net::SSLeay not prompt the user, if it gets installed.
+    # It also makes any other MakeMaker prompts accept their defaults.
+    local $ENV{PERL_MM_USE_DEFAULT} = 1;
+
+    # Certain modules require special stuff in order to not prompt us.
+    my $original_makepl = $CPAN::Config->{makepl_arg};
+    # This one's a regex in case we're doing Template::Plugin::GD and it
+    # pulls in Template-Toolkit as a dependency.
+    if ($name =~ /^Template/) {
+        $CPAN::Config->{makepl_arg} .= " TT_ACCEPT=y TT_EXTRAS=n";
+    }
+    elsif ($name eq 'XML::Twig') {
+        $CPAN::Config->{makepl_arg} = "-n $original_makepl";
+    }
+    elsif ($name eq 'SOAP::Lite') {
+        $CPAN::Config->{makepl_arg} .= " --noprompt";
+    }
+
+    my $module = CPAN::Shell->expand('Module', $name);
+    if (!$module) {
+        die install_string('no_such_module', { module => $name }) . "\n";
+    }
+    my $version = $module->cpan_version;
+    my $module_name = $name;
+
+    if ($name eq 'LWP::UserAgent' && $^V lt v5.8.8) {
+        # LWP 6.x requires Perl 5.8.8 or newer.
+        # As PAUSE only indexes the very last version of each module,
+        # we have to specify the path to the tarball ourselves.
+        $name = 'GAAS/libwww-perl-5.837.tar.gz';
+        # This tarball contains LWP::UserAgent 5.835.
+        $version = '5.835';
+    }
+
+    print install_string('install_module', 
+              { module => $module_name, version => $version }) . "\n";
+
+    if ($test) {
+        CPAN::Shell->force('install', $name);
+    }
+    else {
+        CPAN::Shell->notest('install', $name);
+    }
+
+    # If it installed any binaries in the Bugzilla directory, delete them.
+    if (-d "$bzlib/bin") {
+        File::Path::rmtree("$bzlib/bin");
+    }
+
+    $CPAN::Config->{makepl_arg} = $original_makepl;
+}
+
+sub set_cpan_config {
+    my $do_global = shift;
+    my $bzlib = BZ_LIB;
+
+    # We set defaults before we do anything, otherwise CPAN will
+    # start asking us questions as soon as we load its configuration.
+    eval { require CPAN::Config; };
+    _set_cpan_defaults();
+
+    # Calling a senseless autoload that does nothing makes us
+    # automatically load any existing configuration.
+    # We want to avoid the "invalid command" message.
+    open(my $saveout, ">&STDOUT");
+    open(STDOUT, '>/dev/null');
+    eval { CPAN->ignore_this_error_message_from_bugzilla; };
+    undef $@;
+    close(STDOUT);
+    open(STDOUT, '>&', $saveout);
+
+    my $dir = $CPAN::Config->{cpan_home};
+    if (!defined $dir || !-w $dir) {
+        # If we can't use the standard CPAN build dir, we try to make one.
+        $dir = "$ENV{HOME}/.cpan";
+        mkdir $dir;
+
+        # If we can't make one, we finally try to use the Bugzilla directory.
+        if (!-w $dir) {
+            print STDERR install_string('cpan_bugzilla_home'), "\n";
+            $dir = "$bzlib/.cpan";
+        }
+    }
+    $CPAN::Config->{cpan_home} = $dir;
+    $CPAN::Config->{build_dir} = "$dir/build";
+    # We always force builds, so there's no reason to cache them.
+    $CPAN::Config->{keep_source_where} = "$dir/source";
+    # This is set both here and in defaults so that it's always true.
+    $CPAN::Config->{inhibit_startup_message} = 1;
+    # Automatically install dependencies.
+    $CPAN::Config->{prerequisites_policy} = 'follow';
+    
+    # Unless specified, we install the modules into the Bugzilla directory.
+    if (!$do_global) {
+        require Config;
+
+        $CPAN::Config->{makepl_arg} .= " LIB=\"$bzlib\""
+            . " INSTALLMAN1DIR=\"$bzlib/man/man1\""
+            . " INSTALLMAN3DIR=\"$bzlib/man/man3\""
+            # The bindirs are here because otherwise we'll try to write to
+            # the system binary dirs, and that will cause CPAN to die.
+            . " INSTALLBIN=\"$bzlib/bin\""
+            . " INSTALLSCRIPT=\"$bzlib/bin\""
+            # INSTALLDIRS=perl is set because that makes sure that MakeMaker
+            # always uses the directories we've specified here.
+            . " INSTALLDIRS=perl";
+        $CPAN::Config->{mbuild_arg} = " --install_base \"$bzlib\""
+            . " --install_path lib=\"$bzlib\""
+            . " --install_path arch=\"$bzlib/$Config::Config{archname}\"";
+        $CPAN::Config->{mbuild_install_arg} = $CPAN::Config->{mbuild_arg};
+
+        # When we're not root, sometimes newer versions of CPAN will
+        # try to read/modify things that belong to root, unless we set
+        # certain config variables.
+        $CPAN::Config->{histfile} = "$dir/histfile";
+        $CPAN::Config->{use_sqlite} = 0;
+        $CPAN::Config->{prefs_dir} = "$dir/prefs";
+
+        # Unless we actually set PERL5LIB, some modules can't install
+        # themselves, like DBD::mysql, DBD::Pg, and XML::Twig.
+        my $current_lib = $ENV{PERL5LIB} ? $ENV{PERL5LIB} . ':' : '';
+        $ENV{PERL5LIB} = $current_lib . $bzlib;
+    }
+}
+
+sub _set_cpan_defaults {
+    # If CPAN hasn't been configured, we try to use some reasonable defaults.
+    foreach my $key (keys %{CPAN_DEFAULTS()}) {
+        $CPAN::Config->{$key} = CPAN_DEFAULTS->{$key}
+            if !defined $CPAN::Config->{$key};
+    }
+
+    my @missing;
+    # In newer CPANs, this is in HandleConfig. In older CPANs, it's in
+    # Config.
+    if (eval { require CPAN::HandleConfig }) {
+        @missing = CPAN::HandleConfig->missing_config_data;
+    }
+    else {
+        @missing = CPAN::Config->missing_config_data;
+    }
+
+    foreach my $key (@missing) {
+        $CPAN::Config->{$key} = '';
+    }
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Install::CPAN - Routines to install Perl modules from CPAN.
+
+=head1 SYNOPSIS
+
+ use Bugzilla::Install::CPAN;
+
+ set_cpan_config();
+ install_module('Module::Name');
+
+=head1 DESCRIPTION
+
+This is primarily used by L<install-module> to do the "hard work" of
+installing CPAN modules.
+
+=head1 SUBROUTINES
+
+=over
+
+=item C<set_cpan_config>
+
+Sets up the configuration of CPAN for this session. Must be called
+before L</install_module>. Takes one boolean parameter. If true,
+L</install_module> will install modules globally instead of to the
+local F<lib/> directory. On most systems, you have to be root to do that.
+
+=item C<install_module>
+
+Installs a module from CPAN. Takes two arguments:
+
+=over
+
+=item C<$name> - The name of the module, just like you'd pass to the
+C<install> command in the CPAN shell.
+
+=item C<$test> - If true, we run tests on this module before installing,
+but we still force the install if the tests fail. This is only used
+when we internally install a newer CPAN module.
+
+=back
+
+Note that calling this function prints a B<lot> of information to
+STDOUT and STDERR.
+
+=back

diff --git a/Bugzilla/Install/DB.pm b/Bugzilla/Install/DB.pm
new file mode 100644 (file)
index 0000000..023ef75
--- /dev/null
+++ b/Bugzilla/Install/DB.pm
@@ -0,0 +1,3863 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Install::DB;
+
+# NOTE: This package may "use" any modules that it likes,
+# localconfig is available, and params are up to date. 
+
+use strict;
+
+use Bugzilla::Constants;
+use Bugzilla::Hook;
+use Bugzilla::Install ();
+use Bugzilla::Install::Util qw(indicate_progress install_string);
+use Bugzilla::Util;
+use Bugzilla::Series;
+use Bugzilla::BugUrl;
+use Bugzilla::Field;
+
+use Date::Parse;
+use Date::Format;
+use IO::File;
+use List::MoreUtils qw(uniq);
+use URI;
+use URI::QueryParam;
+
+# NOTE: This is NOT the function for general table updates. See
+# update_table_definitions for that. This is only for the fielddefs table.
+sub update_fielddefs_definition {
+    my $dbh = Bugzilla->dbh;
+
+    # 2005-02-21 - LpSolit@gmail.com - Bug 279910
+    # qacontact_accessible and assignee_accessible field names no longer exist
+    # in the 'bugs' table. Their corresponding entries in the 'bugs_activity'
+    # table should therefore be marked as obsolete, meaning that they cannot
+    # be used anymore when querying the database - they are not deleted in
+    # order to keep track of these fields in the activity table.
+    if (!$dbh->bz_column_info('fielddefs', 'obsolete')) {
+        $dbh->bz_add_column('fielddefs', 'obsolete',
+            {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE'});
+        print "Marking qacontact_accessible and assignee_accessible as",
+              " obsolete fields...\n";
+        $dbh->do("UPDATE fielddefs SET obsolete = 1
+                  WHERE name = 'qacontact_accessible'
+                        OR name = 'assignee_accessible'");
+    }
+
+    # 2005-08-10 Myk Melez <myk@mozilla.org> bug 287325
+    # Record each field's type and whether or not it's a custom field,
+    # in fielddefs.
+    $dbh->bz_add_column('fielddefs', 'type',
+                        {TYPE => 'INT2', NOTNULL => 1, DEFAULT => 0});
+    $dbh->bz_add_column('fielddefs', 'custom',
+        {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE'});
+
+    $dbh->bz_add_column('fielddefs', 'enter_bug',
+        {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE'});
+
+    # Change the name of the fieldid column to id, so that fielddefs
+    # can use Bugzilla::Object easily. We have to do this up here, because
+    # otherwise adding these field definitions will fail.
+    $dbh->bz_rename_column('fielddefs', 'fieldid', 'id');
+
+    # If the largest fielddefs sortkey is less than 100, then
+    # we're using the old sorting system, and we should convert
+    # it to the new one before adding any new definitions.
+    if (!$dbh->selectrow_arrayref(
+            'SELECT COUNT(id) FROM fielddefs WHERE sortkey >= 100'))
+    {
+        print "Updating the sortkeys for the fielddefs table...\n";
+        my $field_ids = $dbh->selectcol_arrayref(
+            'SELECT id FROM fielddefs ORDER BY sortkey');
+        my $sortkey = 100;
+        foreach my $field_id (@$field_ids) {
+            $dbh->do('UPDATE fielddefs SET sortkey = ? WHERE id = ?',
+                     undef, $sortkey, $field_id);
+            $sortkey += 100;
+        }
+    }
+
+    $dbh->bz_add_column('fielddefs', 'visibility_field_id', {TYPE => 'INT3'});
+    $dbh->bz_add_column('fielddefs', 'value_field_id', {TYPE => 'INT3'});
+    $dbh->bz_add_index('fielddefs', 'fielddefs_value_field_id_idx',
+                       ['value_field_id']);
+
+    # Bug 344878
+    if (!$dbh->bz_column_info('fielddefs', 'buglist')) {
+        $dbh->bz_add_column('fielddefs', 'buglist',
+            {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE'});
+        # Set non-multiselect custom fields as valid buglist fields
+        # Note that default fields will be handled in Field.pm
+        $dbh->do('UPDATE fielddefs SET buglist = 1 WHERE custom = 1 AND type != ' . FIELD_TYPE_MULTI_SELECT);
+    }
+
+    #2008-08-26 elliotte_martin@yahoo.com - Bug 251556
+    $dbh->bz_add_column('fielddefs', 'reverse_desc', {TYPE => 'TINYTEXT'});
+
+    $dbh->do('UPDATE fielddefs SET buglist = 1
+               WHERE custom = 1 AND type = ' . FIELD_TYPE_MULTI_SELECT);
+
+    $dbh->bz_add_column('fielddefs', 'is_mandatory',
+        {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE'});
+    $dbh->bz_add_index('fielddefs', 'fielddefs_is_mandatory_idx',
+                       ['is_mandatory']);
+
+    # 2010-04-05 dkl@redhat.com - Bug 479400
+    _migrate_field_visibility_value();
+
+    $dbh->bz_add_column('fielddefs', 'is_numeric',
+        {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE'});
+    $dbh->do('UPDATE fielddefs SET is_numeric = 1 WHERE type = '
+             . FIELD_TYPE_BUG_ID);
+
+    # 2012-04-12 aliustek@gmail.com - Bug 728138
+    $dbh->bz_add_column('fielddefs', 'long_desc',
+                        {TYPE => 'varchar(255)', NOTNULL => 1, DEFAULT => "''"}, '');
+
+    Bugzilla::Hook::process('install_update_db_fielddefs');
+
+    # Remember, this is not the function for adding general table changes.
+    # That is below. Add new changes to the fielddefs table above this
+    # comment.
+}
+
+# Small changes can be put directly into this function.
+# However, larger changes (more than three or four lines) should
+# go into their own private subroutine, and you should call that
+# subroutine from this function. That keeps this function readable.
+#
+# This function runs in historical order--from upgrades that older
+# installations need, to upgrades that newer installations need.
+# The order of items inside this function should only be changed if 
+# absolutely necessary.
+#
+# The subroutines should have long, descriptive names, so that you
+# can easily see what is being done, just by reading this function.
+#
+# This function is mostly self-documenting. If you're curious about
+# what each of the added/removed columns does, you should see the schema 
+# docs at:
+# http://www.ravenbrook.com/project/p4dti/tool/cgi/bugzilla-schema/
+#
+# When you add a change, you should only add a comment if you want
+# to describe why the change was made. You don't need to describe
+# the purpose of a column.
+#
+sub update_table_definitions {
+    my $old_params = shift;
+    my $dbh = Bugzilla->dbh;
+    _update_pre_checksetup_bugzillas();
+
+    $dbh->bz_add_column('attachments', 'submitter_id',
+                        {TYPE => 'INT3', NOTNULL => 1}, 0); 
+
+    $dbh->bz_rename_column('bugs_activity', 'when', 'bug_when');
+
+    _add_bug_vote_cache();
+    _update_product_name_definition();
+
+    $dbh->bz_add_column('profiles', 'disabledtext',
+                        {TYPE => 'MEDIUMTEXT', NOTNULL => 1}, '');
+
+    _populate_longdescs();
+    _update_bugs_activity_field_to_fieldid();
+
+    if (!$dbh->bz_column_info('bugs', 'lastdiffed')) {
+        $dbh->bz_add_column('bugs', 'lastdiffed', {TYPE =>'DATETIME'});
+        $dbh->do('UPDATE bugs SET lastdiffed = NOW()');
+    }
+
+    _add_unique_login_name_index_to_profiles();
+
+    $dbh->bz_add_column('profiles', 'mybugslink', 
+                        {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'TRUE'});
+
+    _update_component_user_fields_to_ids();
+
+    $dbh->bz_add_column('bugs', 'everconfirmed',
+                        {TYPE => 'BOOLEAN', NOTNULL => 1}, 1);
+
+    _populate_milestones_table();
+
+    _add_products_defaultmilestone();
+
+    # 2000-03-24 Added unique indexes into the cc and keyword tables.  This
+    # prevents certain database inconsistencies, and, moreover, is required for
+    # new generalized list code to work.
+    if (!$dbh->bz_index_info('cc', 'cc_bug_id_idx')
+        || !$dbh->bz_index_info('cc', 'cc_bug_id_idx')->{TYPE})
+    {
+        $dbh->bz_drop_index('cc', 'cc_bug_id_idx');
+        $dbh->bz_add_index('cc', 'cc_bug_id_idx',
+                           {TYPE => 'UNIQUE', FIELDS => [qw(bug_id who)]});
+    }
+    if (!$dbh->bz_index_info('keywords', 'keywords_bug_id_idx')
+        || !$dbh->bz_index_info('keywords', 'keywords_bug_id_idx')->{TYPE})
+    {
+        $dbh->bz_drop_index('keywords', 'keywords_bug_id_idx');
+        $dbh->bz_add_index('keywords', 'keywords_bug_id_idx',
+            {TYPE => 'UNIQUE', FIELDS => [qw(bug_id keywordid)]});
+    }
+
+    _copy_from_comments_to_longdescs();
+    _populate_duplicates_table();
+
+    if (!$dbh->bz_column_info('email_setting', 'user_id')) {
+        $dbh->bz_add_column('profiles', 'emailflags', {TYPE => 'MEDIUMTEXT'});
+    }
+
+    $dbh->bz_add_column('groups', 'isactive',
+                        {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'TRUE'});
+
+    $dbh->bz_add_column('attachments', 'isobsolete',
+                        {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE'});
+
+    $dbh->bz_drop_column("profiles", "emailnotification");
+    $dbh->bz_drop_column("profiles", "newemailtech");
+
+    # 2003-11-19; chicks@chicks.net; bug 225973: fix field size to accommodate
+    # wider algorithms such as Blowfish. Note that this needs to be run
+    # before recrypting passwords in the following block.
+    $dbh->bz_alter_column('profiles', 'cryptpassword',
+                          {TYPE => 'varchar(128)'});
+
+    _recrypt_plaintext_passwords();
+
+    # 2001-06-15 kiko@async.com.br - Change bug:version size to avoid
+    # truncates re http://bugzilla.mozilla.org/show_bug.cgi?id=9352
+    $dbh->bz_alter_column('bugs', 'version',
+                          {TYPE => 'varchar(64)', NOTNULL => 1});
+
+    _update_bugs_activity_to_only_record_changes();
+
+    # bug 90933: Make disabledtext NOT NULL
+    if (!$dbh->bz_column_info('profiles', 'disabledtext')->{NOTNULL}) {
+        $dbh->bz_alter_column("profiles", "disabledtext",
+                              {TYPE => 'MEDIUMTEXT', NOTNULL => 1}, '');
+    }
+
+    $dbh->bz_add_column("bugs", "reporter_accessible",
+                        {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'TRUE'});
+    $dbh->bz_add_column("bugs", "cclist_accessible",
+                        {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'TRUE'});
+
+    $dbh->bz_add_column("bugs_activity", "attach_id", {TYPE => 'INT3'});
+
+    _delete_logincookies_cryptpassword_and_handle_invalid_cookies();
+
+    # qacontact/assignee should always be able to see bugs: bug 97471
+    $dbh->bz_drop_column("bugs", "qacontact_accessible");
+    $dbh->bz_drop_column("bugs", "assignee_accessible");
+
+    # 2002-02-20 jeff.hedlund@matrixsi.com - bug 24789 time tracking
+    $dbh->bz_add_column("longdescs", "work_time",
+                        {TYPE => 'decimal(5,2)', NOTNULL => 1, DEFAULT => '0'});
+    $dbh->bz_add_column("bugs", "estimated_time",
+                        {TYPE => 'decimal(5,2)', NOTNULL => 1, DEFAULT => '0'});
+    $dbh->bz_add_column("bugs", "remaining_time",
+                        {TYPE => 'decimal(5,2)', NOTNULL => 1, DEFAULT => '0'});
+    $dbh->bz_add_column("bugs", "deadline", {TYPE => 'DATETIME'});
+
+    _use_ip_instead_of_hostname_in_logincookies();
+
+    $dbh->bz_add_column('longdescs', 'isprivate',
+                        {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE'});
+    $dbh->bz_add_column('attachments', 'isprivate',
+                        {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE'});
+
+    $dbh->bz_add_column("bugs", "alias", {TYPE => "varchar(20)"});
+    $dbh->bz_add_index('bugs', 'bugs_alias_idx',
+                       {TYPE => 'UNIQUE', FIELDS => [qw(alias)]});
+
+    _move_quips_into_db();
+
+    $dbh->bz_drop_column("namedqueries", "watchfordiffs");
+
+    _use_ids_for_products_and_components();
+    _convert_groups_system_from_groupset();
+    _convert_attachment_statuses_to_flags();
+    _remove_spaces_and_commas_from_flagtypes();
+    _setup_usebuggroups_backward_compatibility();
+    _remove_user_series_map();
+
+    # 2006-08-03 remi_zara@mac.com bug 346241, make series.creator nullable
+    # This must happen before calling _copy_old_charts_into_database().
+    if ($dbh->bz_column_info('series', 'creator')->{NOTNULL}) {
+        $dbh->bz_alter_column('series', 'creator', {TYPE => 'INT3'});
+        $dbh->do("UPDATE series SET creator = NULL WHERE creator = 0");
+    }
+
+    _copy_old_charts_into_database();
+
+    _add_user_group_map_grant_type();
+    _add_group_group_map_grant_type();
+
+    $dbh->bz_add_column("profiles", "extern_id", {TYPE => 'varchar(64)'});
+
+    $dbh->bz_add_column('flagtypes', 'grant_group_id', {TYPE => 'INT3'});
+    $dbh->bz_add_column('flagtypes', 'request_group_id', {TYPE => 'INT3'});
+
+    # mailto is no longer just userids
+    $dbh->bz_rename_column('whine_schedules', 'mailto_userid', 'mailto');
+    $dbh->bz_add_column('whine_schedules', 'mailto_type',
+        {TYPE => 'INT2', NOTNULL => 1, DEFAULT => '0'});
+
+    _add_longdescs_already_wrapped();
+
+    # Moved enum types to separate tables so we need change the old enum 
+    # types to standard varchars in the bugs table.
+    $dbh->bz_alter_column('bugs', 'bug_status',
+                          {TYPE => 'varchar(64)', NOTNULL => 1});
+    # 2005-03-23 Tomas.Kopal@altap.cz - add default value to resolution,
+    # bug 286695
+    $dbh->bz_alter_column('bugs', 'resolution',
+        {TYPE => 'varchar(64)', NOTNULL => 1, DEFAULT => "''"});
+    $dbh->bz_alter_column('bugs', 'priority',
+                          {TYPE => 'varchar(64)', NOTNULL => 1});
+    $dbh->bz_alter_column('bugs', 'bug_severity',
+                          {TYPE => 'varchar(64)', NOTNULL => 1});
+    $dbh->bz_alter_column('bugs', 'rep_platform',
+                          {TYPE => 'varchar(64)', NOTNULL => 1}, '');
+    $dbh->bz_alter_column('bugs', 'op_sys',
+                          {TYPE => 'varchar(64)', NOTNULL => 1});
+
+    # When migrating quips from the '$datadir/comments' file to the DB,
+    # the user ID should be NULL instead of 0 (which is an invalid user ID).
+    if ($dbh->bz_column_info('quips', 'userid')->{NOTNULL}) {
+        $dbh->bz_alter_column('quips', 'userid', {TYPE => 'INT3'});
+        print "Changing owner to NULL for quips where the owner is",
+              " unknown...\n";
+        $dbh->do('UPDATE quips SET userid = NULL WHERE userid = 0');
+    }
+
+    _convert_attachments_filename_from_mediumtext();
+
+    $dbh->bz_add_column('quips', 'approved',
+                        {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'TRUE'});
+
+    # 2002-12-20 Bug 180870 - remove manual shadowdb replication code
+    $dbh->bz_drop_table("shadowlog");
+
+    _rename_votes_count_and_force_group_refresh();
+
+    # 2004/02/15 - Summaries shouldn't be null - see bug 220232
+    if (!exists $dbh->bz_column_info('bugs', 'short_desc')->{NOTNULL}) {
+        $dbh->bz_alter_column('bugs', 'short_desc',
+                              {TYPE => 'MEDIUMTEXT', NOTNULL => 1}, '');
+    }
+
+    $dbh->bz_add_column('products', 'classification_id',
+                        {TYPE => 'INT2', NOTNULL => 1, DEFAULT => '1'});
+
+    _fix_group_with_empty_name();
+
+    $dbh->bz_add_index('bugs_activity', 'bugs_activity_who_idx', [qw(who)]);
+
+    # Add defaults for some fields that should have them but didn't.
+    $dbh->bz_alter_column('bugs', 'status_whiteboard',
+        {TYPE => 'MEDIUMTEXT', NOTNULL => 1, DEFAULT => "''"});
+    if ($dbh->bz_column_info('bugs', 'votes')) {
+        $dbh->bz_alter_column('bugs', 'votes',
+                              {TYPE => 'INT3', NOTNULL => 1, DEFAULT => '0'});
+    }
+
+    $dbh->bz_alter_column('bugs', 'lastdiffed', {TYPE => 'DATETIME'});
+
+    # 2005-03-09 qa_contact should be NULL instead of 0, bug 285534
+    if ($dbh->bz_column_info('bugs', 'qa_contact')->{NOTNULL}) {
+        $dbh->bz_alter_column('bugs', 'qa_contact', {TYPE => 'INT3'});
+        $dbh->do("UPDATE bugs SET qa_contact = NULL WHERE qa_contact = 0");
+    }
+
+    # 2005-03-27 initialqacontact should be NULL instead of 0, bug 287483
+    if ($dbh->bz_column_info('components', 'initialqacontact')->{NOTNULL}) {
+        $dbh->bz_alter_column('components', 'initialqacontact', 
+                              {TYPE => 'INT3'});
+    }
+    $dbh->do("UPDATE components SET initialqacontact = NULL " .
+              "WHERE initialqacontact = 0");
+
+    _migrate_email_prefs_to_new_table();
+    _initialize_new_email_prefs();
+    _change_all_mysql_booleans_to_tinyint();
+
+    # make classification_id field type be consistent with DB:Schema
+    $dbh->bz_alter_column('products', 'classification_id',
+                          {TYPE => 'INT2', NOTNULL => 1, DEFAULT => '1'});
+
+    # initialowner was accidentally NULL when we checked-in Schema,
+    # when it really should be NOT NULL.
+    $dbh->bz_alter_column('components', 'initialowner',
+                          {TYPE => 'INT3', NOTNULL => 1}, 0);
+
+    # 2005-03-28 - bug 238800 - index flags.type_id for editflagtypes.cgi
+    $dbh->bz_add_index('flags', 'flags_type_id_idx', [qw(type_id)]);
+
+    # For a short time, the flags_type_id_idx was misnamed in upgraded installs.
+    $dbh->bz_drop_index('flags', 'type_id');
+
+    # 2005-04-28 - LpSolit@gmail.com - Bug 7233: add an index to versions
+    $dbh->bz_alter_column('versions', 'value',
+                          {TYPE => 'varchar(64)', NOTNULL => 1});
+    _add_versions_product_id_index();
+
+    if (!exists $dbh->bz_column_info('milestones', 'sortkey')->{DEFAULT}) {
+        $dbh->bz_alter_column('milestones', 'sortkey',
+                              {TYPE => 'INT2', NOTNULL => 1, DEFAULT => 0});
+    }
+
+    # 2005-06-14 - LpSolit@gmail.com - Bug 292544
+    $dbh->bz_alter_column('bugs', 'creation_ts', {TYPE => 'DATETIME'});
+
+    _fix_whine_queries_title_and_op_sys_value();
+    _fix_attachments_submitter_id_idx();
+    _copy_attachments_thedata_to_attach_data();
+    _fix_broken_all_closed_series();
+    # 2005-08-14 bugreport@peshkin.net -- Bug 304583
+    # Get rid of leftover DERIVED group permissions
+    use constant GRANT_DERIVED => 1;
+    $dbh->do("DELETE FROM user_group_map WHERE grant_type = " . GRANT_DERIVED);
+
+    _rederive_regex_groups();
+
+    # PUBLIC is a reserved word in Oracle.
+    $dbh->bz_rename_column('series', 'public', 'is_public');
+
+    # 2005-11-04 LpSolit@gmail.com - Bug 305927
+    $dbh->bz_alter_column('groups', 'userregexp',
+                          {TYPE => 'TINYTEXT', NOTNULL => 1, DEFAULT => "''"});
+
+    # 2005-09-26 - olav@bkor.dhs.org - Bug 119524
+    $dbh->bz_alter_column('logincookies', 'cookie',
+        {TYPE => 'varchar(16)', PRIMARYKEY => 1, NOTNULL => 1}); 
+
+    _clean_control_characters_from_short_desc();
+    
+    # 2005-12-07 altlst@sonic.net -- Bug 225221
+    $dbh->bz_add_column('longdescs', 'comment_id',
+        {TYPE => 'INTSERIAL', NOTNULL => 1, PRIMARYKEY => 1});
+
+    _stop_storing_inactive_flags();
+    _change_short_desc_from_mediumtext_to_varchar();
+
+    # 2006-07-01 wurblzap@gmail.com -- Bug 69000
+    $dbh->bz_add_column('namedqueries', 'id',
+        {TYPE => 'MEDIUMSERIAL', NOTNULL => 1, PRIMARYKEY => 1});
+    _move_namedqueries_linkinfooter_to_its_own_table();
+
+    _add_classifications_sortkey();
+    _move_data_nomail_into_db();
+
+    # The products table lacked sensible defaults.
+    if ($dbh->bz_column_info('products', 'milestoneurl')) {
+        $dbh->bz_alter_column('products', 'milestoneurl',
+            {TYPE => 'TINYTEXT', NOTNULL => 1, DEFAULT => "''"});
+    }
+    if ($dbh->bz_column_info('products', 'disallownew')){
+        $dbh->bz_alter_column('products', 'disallownew',
+                              {TYPE => 'BOOLEAN', NOTNULL => 1,  DEFAULT => 0});
+    
+        if ($dbh->bz_column_info('products', 'votesperuser')) {
+            $dbh->bz_alter_column('products', 'votesperuser', 
+                {TYPE => 'INT2', NOTNULL => 1, DEFAULT => 0});
+            $dbh->bz_alter_column('products', 'votestoconfirm',
+                {TYPE => 'INT2', NOTNULL => 1, DEFAULT => 0});
+        }
+    }
+
+    # 2006-08-04 LpSolit@gmail.com - Bug 305941
+    $dbh->bz_drop_column('profiles', 'refreshed_when');
+    $dbh->bz_drop_column('groups', 'last_changed');
+
+    # 2006-08-06 LpSolit@gmail.com - Bug 347521
+    $dbh->bz_alter_column('flagtypes', 'id',
+          {TYPE => 'SMALLSERIAL', NOTNULL => 1, PRIMARYKEY => 1});
+
+    $dbh->bz_alter_column('keyworddefs', 'id',
+        {TYPE => 'SMALLSERIAL', NOTNULL => 1, PRIMARYKEY => 1});
+
+    # 2006-08-19 LpSolit@gmail.com - Bug 87795
+    $dbh->bz_alter_column('tokens', 'userid', {TYPE => 'INT3'});
+
+    $dbh->bz_drop_index('bugs', 'bugs_short_desc_idx');
+
+    # The profiles table was missing some defaults.
+    $dbh->bz_alter_column('profiles', 'disabledtext',
+        {TYPE => 'MEDIUMTEXT', NOTNULL => 1, DEFAULT => "''"});
+    $dbh->bz_alter_column('profiles', 'realname',
+        {TYPE => 'varchar(255)', NOTNULL => 1, DEFAULT => "''"});
+
+    _update_longdescs_who_index();
+
+    $dbh->bz_add_column('setting', 'subclass', {TYPE => 'varchar(32)'});
+
+    $dbh->bz_alter_column('longdescs', 'thetext', 
+        {TYPE => 'LONGTEXT', NOTNULL => 1}, '');
+
+    # 2006-10-20 LpSolit@gmail.com - Bug 189627
+    $dbh->bz_add_column('group_control_map', 'editcomponents',
+                        {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE'});
+    $dbh->bz_add_column('group_control_map', 'editbugs',
+                        {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE'});
+    $dbh->bz_add_column('group_control_map', 'canconfirm',
+                        {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE'});
+
+    # 2006-11-07 LpSolit@gmail.com - Bug 353656
+    $dbh->bz_add_column('longdescs', 'type',
+                        {TYPE => 'INT2', NOTNULL => 1, DEFAULT => '0'});
+    $dbh->bz_add_column('longdescs', 'extra_data', {TYPE => 'varchar(255)'});
+
+    $dbh->bz_add_column('versions', 'id', 
+        {TYPE => 'MEDIUMSERIAL', NOTNULL => 1, PRIMARYKEY => 1});
+    $dbh->bz_add_column('milestones', 'id',
+        {TYPE => 'MEDIUMSERIAL', NOTNULL => 1, PRIMARYKEY => 1});
+
+    _fix_uppercase_custom_field_names();
+    _fix_uppercase_index_names();
+
+    # 2007-05-17 LpSolit@gmail.com - Bug 344965
+    _initialize_workflow_for_upgrade($old_params);
+
+    # 2007-08-08 LpSolit@gmail.com - Bug 332149
+    $dbh->bz_add_column('groups', 'icon_url', {TYPE => 'TINYTEXT'});
+
+    # 2007-08-21 wurblzap@gmail.com - Bug 365378
+    _make_lang_setting_dynamic();
+    
+    # 2007-11-29 xiaoou.wu@oracle.com - Bug 153129
+    _change_text_types();
+
+    # 2007-09-09 LpSolit@gmail.com - Bug 99215
+    _fix_attachment_modification_date();
+
+    $dbh->bz_drop_index('longdescs', 'longdescs_thetext_idx');
+    _populate_bugs_fulltext();
+
+    # 2008-01-18 xiaoou.wu@oracle.com - Bug 414292
+    $dbh->bz_alter_column('series', 'query',
+        { TYPE => 'MEDIUMTEXT', NOTNULL => 1 });
+
+    # Add FK to multi select field tables
+    _add_foreign_keys_to_multiselects();
+
+    # 2008-07-28 tfu@redhat.com - Bug 431669
+    $dbh->bz_alter_column('group_control_map', 'product_id',
+        { TYPE => 'INT2', NOTNULL => 1 });
+
+    # 2008-09-07 LpSolit@gmail.com - Bug 452893
+    _fix_illegal_flag_modification_dates();
+
+    _add_visiblity_value_to_value_tables();
+
+    # 2009-03-02 arbingersys@gmail.com - Bug 423613
+    _add_extern_id_index();
+
+    # 2009-03-31 LpSolit@gmail.com - Bug 478972
+    $dbh->bz_alter_column('group_control_map', 'entry',
+                          {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE'});
+    $dbh->bz_alter_column('group_control_map', 'canedit',
+                          {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE'});
+
+    # 2009-01-16 oreomike@gmail.com - Bug 302420
+    $dbh->bz_add_column('whine_events', 'mailifnobugs',
+        { TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE'});
+        
+    _convert_disallownew_to_isactive();
+
+    $dbh->bz_alter_column('bugs_activity', 'added', 
+        { TYPE => 'varchar(255)' });
+    $dbh->bz_add_index('bugs_activity', 'bugs_activity_added_idx', ['added']);
+
+    # 2009-09-28 LpSolit@gmail.com - Bug 519032
+    $dbh->bz_drop_column('series', 'last_viewed');
+
+    # 2009-09-28 LpSolit@gmail.com - Bug 399073
+    _fix_logincookies_ipaddr();
+
+    # 2009-11-01 LpSolit@gmail.com - Bug 525025
+    _fix_invalid_custom_field_names();
+
+    _set_attachment_comment_types();
+
+    $dbh->bz_drop_column('products', 'milestoneurl');
+
+    _add_allows_unconfirmed_to_product_table();
+    _convert_flagtypes_fks_to_set_null();
+    _fix_decimal_types();
+    _fix_series_creator_fk();
+
+    # 2009-11-14 dkl@redhat.com - Bug 310450
+    $dbh->bz_add_column('bugs_activity', 'comment_id', {TYPE => 'INT4'});
+
+    # 2010-04-07 LpSolit@gmail.com - Bug 69621
+    $dbh->bz_drop_column('bugs', 'keywords');
+    
+    # 2010-05-07 ewong@pw-wspx.org - Bug 463945
+    $dbh->bz_alter_column('group_control_map', 'membercontrol',
+                          {TYPE => 'INT1', NOTNULL => 1, DEFAULT => CONTROLMAPNA});
+    $dbh->bz_alter_column('group_control_map', 'othercontrol',
+                          {TYPE => 'INT1', NOTNULL => 1, DEFAULT => CONTROLMAPNA});
+
+    # Add NOT NULL to some columns that need it, and DEFAULT to
+    # attachments.ispatch.
+    $dbh->bz_alter_column('attachments', 'ispatch', 
+        { TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE'});
+    $dbh->bz_alter_column('keyworddefs', 'description',
+                          { TYPE => 'MEDIUMTEXT', NOTNULL => 1 }, '');
+    $dbh->bz_alter_column('products', 'description',
+                          { TYPE => 'MEDIUMTEXT', NOTNULL => 1 }, '');
+
+    # Change the default of allows_unconfirmed to TRUE as part
+    # of the new workflow.
+    $dbh->bz_alter_column('products', 'allows_unconfirmed',
+        { TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'TRUE' });
+
+    # 2010-07-18 LpSolit@gmail.com - Bug 119703
+    _remove_attachment_isurl();
+
+    # 2009-05-07 ghendricks@novell.com - Bug 77193
+    _add_isactive_to_product_fields();
+
+    # 2010-10-09 LpSolit@gmail.com - Bug 505165
+    $dbh->bz_alter_column('flags', 'setter_id', {TYPE => 'INT3', NOTNULL => 1});
+
+    # 2010-10-09 LpSolit@gmail.com - Bug 451735
+    _fix_series_indexes();
+
+    $dbh->bz_add_column('bug_see_also', 'id',
+        {TYPE => 'MEDIUMSERIAL', NOTNULL => 1, PRIMARYKEY => 1});
+
+    _rename_tags_to_tag();
+
+    # 2011-01-29 LpSolit@gmail.com - Bug 616185
+    _migrate_user_tags();
+
+    _populate_bug_see_also_class();
+
+    # 2011-06-15 dkl@mozilla.com - Bug 658929
+    _migrate_disabledtext_boolean();
+
+    # 2011-11-01 glob@mozilla.com - Bug 240437
+    $dbh->bz_add_column('profiles', 'last_seen_date', {TYPE => 'DATETIME'});
+
+    # 2011-10-11 miketosh - Bug 690173
+    _on_delete_set_null_for_audit_log_userid();
+    
+    # 2011-11-23 gerv@gerv.net - Bug 705058 - make filenames longer
+    $dbh->bz_alter_column('attachments', 'filename', 
+                                    { TYPE => 'varchar(255)', NOTNULL => 1 });
+
+    # 2011-11-28 dkl@mozilla.com - Bug 685611
+    _fix_notnull_defaults();
+
+    # 2012-02-15 LpSolit@gmail.com - Bug 722113
+    if ($dbh->bz_index_info('profile_search', 'profile_search_user_id')) {
+        $dbh->bz_drop_index('profile_search', 'profile_search_user_id');
+        $dbh->bz_add_index('profile_search', 'profile_search_user_id_idx', [qw(user_id)]);
+    }
+
+    # 2012-03-23 LpSolit@gmail.com - Bug 448551
+    $dbh->bz_alter_column('bugs', 'target_milestone',
+                          {TYPE => 'varchar(64)', NOTNULL => 1, DEFAULT => "'---'"});
+
+    $dbh->bz_alter_column('milestones', 'value', {TYPE => 'varchar(64)', NOTNULL => 1});
+
+    $dbh->bz_alter_column('products', 'defaultmilestone',
+                          {TYPE => 'varchar(64)', NOTNULL => 1, DEFAULT => "'---'"});
+
+    # 2012-04-15 Frank@Frank-Becker.de - Bug 740536
+    $dbh->bz_add_index('audit_log', 'audit_log_class_idx', ['class', 'at_time']);
+
+    # 2012-06-06 dkl@mozilla.com - Bug 762288
+    $dbh->bz_alter_column('bugs_activity', 'removed', 
+                          { TYPE => 'varchar(255)' });
+    $dbh->bz_add_index('bugs_activity', 'bugs_activity_removed_idx', ['removed']);
+
+    # 2012-06-13 dkl@mozilla.com - Bug 764457
+    $dbh->bz_add_column('bugs_activity', 'id', 
+                        {TYPE => 'INTSERIAL', NOTNULL => 1, PRIMARYKEY => 1});
+
+    # 2012-06-13 dkl@mozilla.com - Bug 764466
+    $dbh->bz_add_column('profiles_activity', 'id', 
+                        {TYPE => 'MEDIUMSERIAL', NOTNULL => 1, PRIMARYKEY => 1});
+
+    # 2012-07-24 dkl@mozilla.com - Bug 776972
+    $dbh->bz_alter_column('bugs_activity', 'id', 
+                          {TYPE => 'INTSERIAL', NOTNULL => 1, PRIMARYKEY => 1});
+
+
+    # 2012-07-24 dkl@mozilla.com - Bug 776982
+    _fix_longdescs_primary_key();
+
+    # 2012-08-02 dkl@mozilla.com - Bug 756953
+    _fix_dependencies_dupes();
+
+    # 2012-08-01 koosha.khajeh@gmail.com - Bug 187753
+    _shorten_long_quips();
+
+    # 2012-12-23 LpSolit@gmail.com - Bug 824361
+    _fix_longdescs_indexes();
+
+    # 2013-02-04 dkl@mozilla.com - Bug 824346
+    _fix_flagclusions_indexes();
+
+    ################################################################
+    # New --TABLE-- changes should go *** A B O V E *** this point #
+    ################################################################
+
+    Bugzilla::Hook::process('install_update_db');
+
+    # We do this here because otherwise the foreign key from 
+    # products.classification_id to classifications.id will fail
+    # (because products.classification_id defaults to "1", so on upgraded
+    # installations it's already been set before the first Classification
+    # exists).
+    Bugzilla::Install::create_default_classification();
+
+    $dbh->bz_setup_foreign_keys();
+}
+
+# Subroutines should be ordered in the order that they are called.
+# Thus, newer subroutines should be at the bottom.
+
+sub _update_pre_checksetup_bugzillas {
+    my $dbh = Bugzilla->dbh;
+    # really old fields that were added before checksetup.pl existed
+    # but aren't in very old bugzilla's (like 2.1)
+    # Steve Stock (sstock@iconnect-inc.com)
+
+    $dbh->bz_add_column('bugs', 'target_milestone',
+        {TYPE => 'varchar(20)', NOTNULL => 1, DEFAULT => "'---'"});
+    $dbh->bz_add_column('bugs', 'qa_contact', {TYPE => 'INT3'});
+    $dbh->bz_add_column('bugs', 'status_whiteboard',
+                       {TYPE => 'MEDIUMTEXT', NOTNULL => 1, DEFAULT => "''"});
+    if (!$dbh->bz_column_info('products', 'isactive')){
+        $dbh->bz_add_column('products', 'disallownew',
+                            {TYPE => 'BOOLEAN', NOTNULL => 1}, 0);
+    }
+
+    $dbh->bz_add_column('components', 'initialqacontact',
+                        {TYPE => 'TINYTEXT'});
+    $dbh->bz_add_column('components', 'description',
+                        {TYPE => 'MEDIUMTEXT', NOTNULL => 1}, '');
+}
+
+sub _add_bug_vote_cache {
+    my $dbh = Bugzilla->dbh;
+    # 1999-10-11 Restructured voting database to add a cached value in each 
+    # bug recording how many total votes that bug has.  While I'm at it, 
+    # I removed the unused "area" field from the bugs database.  It is 
+    # distressing to realize that the bugs table has reached the maximum 
+    # number of indices allowed by MySQL (16), which may make future 
+    # enhancements awkward.
+    # (P.S. All is not lost; it appears that the latest betas of MySQL 
+    # support a new table format which will allow 32 indices.)
+
+    if ($dbh->bz_column_info('bugs', 'area')) {
+        $dbh->bz_drop_column('bugs', 'area');
+        $dbh->bz_add_column('bugs', 'votes', {TYPE => 'INT3', NOTNULL => 1,
+                                              DEFAULT => 0});
+        $dbh->bz_add_index('bugs', 'bugs_votes_idx', [qw(votes)]);
+        $dbh->bz_add_column('products', 'votesperuser',
+                            {TYPE => 'INT2', NOTNULL => 1}, 0);
+    }
+}
+
+sub _update_product_name_definition {
+    my $dbh = Bugzilla->dbh;
+    # The product name used to be very different in various tables.
+    #
+    # It was   varchar(16)   in bugs
+    #          tinytext      in components
+    #          tinytext      in products
+    #          tinytext      in versions
+    #
+    # tinytext is equivalent to varchar(255), which is quite huge, so I change
+    # them all to varchar(64).
+
+    # Only do this if these fields still exist - they're removed in
+    # a later change
+    if ($dbh->bz_column_info('products', 'product')) {
+        $dbh->bz_alter_column('bugs',       'product',
+                             {TYPE => 'varchar(64)', NOTNULL => 1});
+        $dbh->bz_alter_column('components', 'program', {TYPE => 'varchar(64)'});
+        $dbh->bz_alter_column('products',   'product', {TYPE => 'varchar(64)'});
+        $dbh->bz_alter_column('versions',   'program',
+                              {TYPE => 'varchar(64)', NOTNULL => 1});
+    }
+}
+
+# A helper for the function below.
+sub _write_one_longdesc {
+    my ($id, $who, $when, $buffer) = (@_);
+    my $dbh = Bugzilla->dbh;
+    $buffer = trim($buffer);
+    return if !$buffer;
+    $dbh->do("INSERT INTO longdescs (bug_id, who, bug_when, thetext)
+                   VALUES (?,?,?,?)", undef, $id, $who, 
+             time2str("%Y/%m/%d %H:%M:%S", $when), $buffer);
+}
+
+sub _populate_longdescs {
+    my $dbh = Bugzilla->dbh;
+    # 2000-01-20 Added a new "longdescs" table, which is supposed to have 
+    # all the long descriptions in it, replacing the old long_desc field 
+    # in the bugs table. The below hideous code populates this new table 
+    # with things from the old field, with ugly parsing and heuristics.
+
+    if ($dbh->bz_column_info('bugs', 'long_desc')) {
+        my ($total) = $dbh->selectrow_array("SELECT COUNT(*) FROM bugs");
+
+        print "Populating new long_desc table. This is slow. There are",
+              " $total\nbugs to process; a line of dots will be printed",
+              " for each 50.\n\n";
+        local $| = 1;
+
+        # On MySQL, longdescs doesn't benefit from transactions, but this
+        # doesn't hurt.
+        $dbh->bz_start_transaction();
+
+        $dbh->do('DELETE FROM longdescs');
+
+        my $sth = $dbh->prepare("SELECT bug_id, creation_ts, reporter,
+                                        long_desc FROM bugs ORDER BY bug_id");
+        $sth->execute();
+        my $count = 0;
+        while (my ($id, $createtime, $reporterid, $desc) = 
+                   $sth->fetchrow_array()) 
+        {
+            $count++;
+            indicate_progress({ total => $total, current => $count });
+            $desc =~ s/\r//g;
+            my $who = $reporterid;
+            my $when = str2time($createtime);
+            my $buffer = "";
+            foreach my $line (split(/\n/, $desc)) {
+                $line =~ s/\s+$//g; # Trim trailing whitespace.
+                if ($line =~ /^------- Additional Comments From ([^\s]+)\s+(\d.+\d)\s+-------$/) 
+                {
+                    my $name = $1;
+                    my $date = str2time($2);
+                    # Oy, what a hack.  The creation time is accurate to the
+                    # second. But the long text only contains things accurate
+                    # to the And so, if someone makes a comment within a 
+                    # minute of the original bug creation, then the comment can
+                    # come *before* the bug creation.  So, we add 59 seconds to
+                    # the time of all comments, so that they are always 
+                    # considered to have happened at the *end* of the given
+                    # minute, not the beginning.
+                    $date += 59;
+                    if ($date >= $when) {
+                        _write_one_longdesc($id, $who, $when, $buffer);
+                        $buffer = "";
+                        $when = $date;
+                        my $s2 = $dbh->prepare("SELECT userid FROM profiles " .
+                                                "WHERE login_name = ?");
+                        $s2->execute($name);
+                        ($who) = ($s2->fetchrow_array());
+
+                        if (!$who) {
+                            # This username doesn't exist.  Maybe someone
+                            # renamed him or something.  Invent a new profile
+                            # entry disabled, just to represent him.
+                            $dbh->do("INSERT INTO profiles (login_name, 
+                                      cryptpassword, disabledtext) 
+                                      VALUES (?,?,?)", undef, $name, '*',
+                                      "Account created only to maintain"
+                                      . " database integrity");
+                            $who = $dbh->bz_last_key('profiles', 'userid');
+                        }
+                        next;
+                    }
+                }
+                $buffer .= $line . "\n";
+            }
+            _write_one_longdesc($id, $who, $when, $buffer);
+        } # while loop
+
+        print "\n\n";
+        $dbh->bz_drop_column('bugs', 'long_desc');
+        $dbh->bz_commit_transaction();
+    } # main if
+}
+
+sub _update_bugs_activity_field_to_fieldid {
+    my $dbh = Bugzilla->dbh;
+
+    # 2000-01-18 Added a new table fielddefs that records information about the
+    # different fields we keep an activity log on.  The bugs_activity table
+    # now has a pointer into that table instead of recording the name directly.
+    if ($dbh->bz_column_info('bugs_activity', 'field')) {
+        $dbh->bz_add_column('bugs_activity', 'fieldid',
+                            {TYPE => 'INT3', NOTNULL => 1}, 0);
+
+        $dbh->bz_add_index('bugs_activity', 'bugs_activity_fieldid_idx',
+                           [qw(fieldid)]);
+        print "Populating new bugs_activity.fieldid field...\n";
+
+        $dbh->bz_start_transaction();
+
+        my $ids = $dbh->selectall_arrayref(
+            'SELECT DISTINCT fielddefs.id, bugs_activity.field
+               FROM bugs_activity LEFT JOIN fielddefs 
+                    ON bugs_activity.field = fielddefs.name', {Slice=>{}});
+
+        foreach my $item (@$ids) {
+            my $id    = $item->{id};
+            my $field = $item->{field};
+            # If the id is NULL
+            if (!$id) {
+                $dbh->do("INSERT INTO fielddefs (name, description) VALUES " .
+                         "(?, ?)", undef, $field, $field);
+                $id = $dbh->bz_last_key('fielddefs', 'id');
+            }
+            $dbh->do("UPDATE bugs_activity SET fieldid = ? WHERE field = ?",
+                     undef, $id, $field);
+        }
+        $dbh->bz_commit_transaction();
+
+        $dbh->bz_drop_column('bugs_activity', 'field');
+    }
+}
+
+sub _add_unique_login_name_index_to_profiles {
+    my $dbh = Bugzilla->dbh;
+
+    # 2000-01-22 The "login_name" field in the "profiles" table was not
+    # declared to be unique.  Sure enough, somehow, I got 22 duplicated entries
+    # in my database.  This code detects that, cleans up the duplicates, and
+    # then tweaks the table to declare the field to be unique.  What a pain.
+    if (!$dbh->bz_index_info('profiles', 'profiles_login_name_idx')
+        || !$dbh->bz_index_info('profiles', 'profiles_login_name_idx')->{TYPE})
+    {
+        print "Searching for duplicate entries in the profiles table...\n";
+        while (1) {
+            # This code is weird in that it loops around and keeps doing this
+            # select again.  That's because I'm paranoid about deleting entries
+            # out from under us in the profiles table.  Things get weird if
+            # there are *three* or more entries for the same user...
+            my $sth = $dbh->prepare("SELECT p1.userid, p2.userid, p1.login_name
+                                       FROM profiles AS p1, profiles AS p2
+                                      WHERE p1.userid < p2.userid
+                                            AND p1.login_name = p2.login_name
+                                   ORDER BY p1.login_name");
+            $sth->execute();
+            my ($u1, $u2, $n) = ($sth->fetchrow_array);
+            last if !$u1;
+
+            print "Both $u1 & $u2 are ids for $n!  Merging $u2 into $u1...\n";
+            foreach my $i (["bugs", "reporter"],
+                           ["bugs", "assigned_to"],
+                           ["bugs", "qa_contact"],
+                           ["attachments", "submitter_id"],
+                           ["bugs_activity", "who"],
+                           ["cc", "who"],
+                           ["votes", "who"],
+                           ["longdescs", "who"]) {
+                my ($table, $field) = (@$i);
+                if ($dbh->bz_table_info($table)) {
+                    print "   Updating $table.$field...\n";
+                    $dbh->do("UPDATE $table SET $field = $u1 " .
+                              "WHERE $field = $u2");
+                }
+            }
+            $dbh->do("DELETE FROM profiles WHERE userid = $u2");
+        }
+        print "OK, changing index type to prevent duplicates in the",
+              " future...\n";
+
+        $dbh->bz_drop_index('profiles', 'profiles_login_name_idx');
+        $dbh->bz_add_index('profiles', 'profiles_login_name_idx',
+                           {TYPE => 'UNIQUE', FIELDS => [qw(login_name)]});
+    }
+}
+
+sub _update_component_user_fields_to_ids {
+    my $dbh = Bugzilla->dbh;
+
+    # components.initialowner
+    my $comp_init_owner = $dbh->bz_column_info('components', 'initialowner');
+    if ($comp_init_owner && $comp_init_owner->{TYPE} eq 'TINYTEXT') {
+        my $sth = $dbh->prepare("SELECT program, value, initialowner
+                                   FROM components");
+        $sth->execute();
+        while (my ($program, $value, $initialowner) = $sth->fetchrow_array()) {
+            my ($id) = $dbh->selectrow_array(
+                "SELECT userid FROM profiles WHERE login_name = ?",
+                undef, $initialowner);
+
+            unless (defined $id) {
+                print "Warning: You have an invalid default assignee",
+                      " '$initialowner'\n in component '$value' of program",
+                      " '$program'!\n";
+                $id = 0;
+            }
+
+            $dbh->do("UPDATE components SET initialowner = ?
+                       WHERE program = ? AND value = ?", undef,
+                     $id, $program, $value);
+        }
+        $dbh->bz_alter_column('components','initialowner',{TYPE => 'INT3'});
+    }
+
+    # components.initialqacontact
+    my $comp_init_qa = $dbh->bz_column_info('components', 'initialqacontact');
+    if ($comp_init_qa && $comp_init_qa->{TYPE} eq 'TINYTEXT') {
+        my $sth = $dbh->prepare("SELECT program, value, initialqacontact
+                                   FROM components");
+        $sth->execute();
+        while (my ($program, $value, $initialqacontact) = 
+                   $sth->fetchrow_array()) 
+        {
+            my ($id) = $dbh->selectrow_array(
+                "SELECT userid FROM profiles WHERE login_name = ?",
+                undef, $initialqacontact);
+
+            unless (defined $id) {
+                if ($initialqacontact) {
+                    print "Warning: You have an invalid default QA contact",
+                          " $initialqacontact' in program '$program',",
+                          " component '$value'!\n";
+                }
+                $id = 0;
+            }
+
+            $dbh->do("UPDATE components SET initialqacontact = ?
+                       WHERE program = ? AND value = ?", undef,
+                     $id, $program, $value);
+        }
+
+        $dbh->bz_alter_column('components','initialqacontact',{TYPE => 'INT3'});
+    }
+}
+
+sub _populate_milestones_table {
+    my $dbh = Bugzilla->dbh;
+    # 2000-03-21 Adding a table for target milestones to
+    # database - matthew@zeroknowledge.com
+    # If the milestones table is empty, and we're still back in a Bugzilla
+    # that has a bugs.product field, that means that we just created
+    # the milestones table and it needs to be populated.
+    my $milestones_exist = $dbh->selectrow_array(
+        "SELECT DISTINCT 1 FROM milestones");
+    if (!$milestones_exist && $dbh->bz_column_info('bugs', 'product')) {
+        print "Replacing blank milestones...\n";
+
+        $dbh->do("UPDATE bugs
+                     SET target_milestone = '---'
+                   WHERE target_milestone = ' '");
+
+        # If we are upgrading from 2.8 or earlier, we will have *created*
+        # the milestones table with a product_id field, but Bugzilla expects
+        # it to have a "product" field. So we change the field backward so
+        # other code can run. The change will be reversed later in checksetup.
+        if ($dbh->bz_column_info('milestones', 'product_id')) {
+            # Dropping the column leaves us with a milestones_product_id_idx
+            # index that is only on the "value" column. We need to drop the
+            # whole index so that it can be correctly re-created later.
+            $dbh->bz_drop_index('milestones', 'milestones_product_id_idx');
+            $dbh->bz_drop_column('milestones', 'product_id');
+            $dbh->bz_add_column('milestones', 'product',
+                                {TYPE => 'varchar(64)', NOTNULL => 1}, '');
+        }
+
+        # Populate the milestone table with all existing values in the database
+        my $sth = $dbh->prepare("SELECT DISTINCT target_milestone, product 
+                                   FROM bugs");
+        $sth->execute();
+
+        print "Populating milestones table...\n";
+
+        while (my ($value, $product) = $sth->fetchrow_array()) {
+            # check if the value already exists
+            my $sortkey = substr($value, 1);
+            if ($sortkey !~ /^\d+$/) {
+                $sortkey = 0;
+            } else {
+                $sortkey *= 10;
+            }
+            my $ms_exists = $dbh->selectrow_array(
+                "SELECT value FROM milestones
+                  WHERE value = ? AND product = ?", undef, $value, $product);
+
+            if (!$ms_exists) {
+                $dbh->do("INSERT INTO milestones(value, product, sortkey) 
+                          VALUES (?,?,?)", undef, $value, $product, $sortkey);
+            }
+        }
+    }
+}
+
+sub _add_products_defaultmilestone {
+    my $dbh = Bugzilla->dbh;
+
+    # 2000-03-23 Added a defaultmilestone field to the products table, so that
+    # we know which milestone to initially assign bugs to.
+    if (!$dbh->bz_column_info('products', 'defaultmilestone')) {
+        $dbh->bz_add_column('products', 'defaultmilestone',
+                 {TYPE => 'varchar(20)', NOTNULL => 1, DEFAULT => "'---'"});
+        my $sth = $dbh->prepare(
+            "SELECT product, defaultmilestone FROM products");
+        $sth->execute();
+        while (my ($product, $default_ms) = $sth->fetchrow_array()) {
+            my $exists = $dbh->selectrow_array(
+                "SELECT value FROM milestones
+                  WHERE value = ? AND product = ?", 
+                undef, $default_ms, $product);
+            if (!$exists) {
+                $dbh->do("INSERT INTO milestones(value, product) " .
+                         "VALUES (?, ?)", undef, $default_ms, $product);
+            }
+        }
+    }
+}
+
+sub _copy_from_comments_to_longdescs {
+    my $dbh = Bugzilla->dbh;
+    # 2000-11-27 For Bugzilla 2.5 and later. Copy data from 'comments' to
+    # 'longdescs' - the new name of the comments table.
+    if ($dbh->bz_table_info('comments')) {
+        print "Copying data from 'comments' to 'longdescs'...\n";
+        my $quoted_when = $dbh->quote_identifier('when');
+        $dbh->do("INSERT INTO longdescs (bug_when, bug_id, who, thetext)
+                  SELECT $quoted_when, bug_id, who, comment
+                    FROM comments");
+        $dbh->bz_drop_table("comments");
+    }
+}
+
+sub _populate_duplicates_table {
+    my $dbh = Bugzilla->dbh;
+    # 2000-07-15 Added duplicates table so Bugzilla tracks duplicates in a
+    # better way than it used to. This code searches the comments to populate
+    # the table initially. It's executed if the table is empty; if it's 
+    # empty because there are no dupes (as opposed to having just created 
+    # the table) it won't have any effect anyway, so it doesn't matter.
+    my ($dups_exist) = $dbh->selectrow_array(
+        "SELECT DISTINCT 1 FROM duplicates");
+    # We also check against a schema change that happened later.
+    if (!$dups_exist && !$dbh->bz_column_info('groups', 'isactive')) {
+        # populate table
+        print "Populating duplicates table from comments...\n";
+
+        my $sth = $dbh->prepare(
+             "SELECT longdescs.bug_id, thetext
+                FROM longdescs LEFT JOIN bugs 
+                     ON longdescs.bug_id = bugs.bug_id
+               WHERE (" . $dbh->sql_regexp("thetext", 
+                          "'[.*.]{3} This bug has been marked as a duplicate"
+                          . " of [[:digit:]]+ [.*.]{3}'") 
+                  . ")
+                     AND resolution = 'DUPLICATE'
+            ORDER BY longdescs.bug_when");
+        $sth->execute();
+
+        my (%dupes, $key);
+        # Because of the way hashes work, this loop removes all but the 
+        # last dupe resolution found for a given bug.
+        while (my ($dupe, $dupe_of) = $sth->fetchrow_array()) {
+            $dupes{$dupe} = $dupe_of;
+        }
+
+        foreach $key (keys(%dupes)){
+            $dupes{$key} =~ /^.*\*\*\* This bug has been marked as a duplicate of (\d+) \*\*\*$/ms;
+            $dupes{$key} = $1;
+            $dbh->do("INSERT INTO duplicates VALUES(?, ?)", undef,
+                     $dupes{$key},  $key);
+            #        BugItsADupeOf  Dupe
+        }
+    }
+}
+
+sub _recrypt_plaintext_passwords {
+    my $dbh = Bugzilla->dbh;
+    # 2001-06-12; myk@mozilla.org; bugs 74032, 77473:
+    # Recrypt passwords using Perl &crypt instead of the mysql equivalent
+    # and delete plaintext passwords from the database.
+    if ($dbh->bz_column_info('profiles', 'password')) {
+
+        print <<ENDTEXT;
+Your current installation of Bugzilla stores passwords in plaintext
+in the database and uses mysql's encrypt function instead of Perl's
+crypt function to crypt passwords.  Passwords are now going to be
+re-crypted with the Perl function, and plaintext passwords will be
+deleted from the database.  This could take a while if your
+installation has many users.
+ENDTEXT
+
+        # Re-crypt everyone's password.
+        my $total = $dbh->selectrow_array('SELECT COUNT(*) FROM profiles');
+        my $sth = $dbh->prepare("SELECT userid, password FROM profiles");
+        $sth->execute();
+
+        my $i = 1;
+
+        print "Fixing passwords...\n";
+        while (my ($userid, $password) = $sth->fetchrow_array()) {
+            my $cryptpassword = $dbh->quote(bz_crypt($password));
+            $dbh->do("UPDATE profiles " .
+                        "SET cryptpassword = $cryptpassword " .
+                      "WHERE userid = $userid");
+            indicate_progress({ total => $total, current => $i, every => 10 });
+        }
+        print "\n";
+
+        # Drop the plaintext password field.
+        $dbh->bz_drop_column('profiles', 'password');
+    }
+}
+
+sub _update_bugs_activity_to_only_record_changes {
+    my $dbh = Bugzilla->dbh;
+    # 2001-07-20 jake@bugzilla.org - Change bugs_activity to only record changes
+    #  http://bugzilla.mozilla.org/show_bug.cgi?id=55161
+    if ($dbh->bz_column_info('bugs_activity', 'oldvalue')) {
+        $dbh->bz_add_column("bugs_activity", "removed", {TYPE => "TINYTEXT"});
+        $dbh->bz_add_column("bugs_activity", "added", {TYPE => "TINYTEXT"});
+
+        # Need to get field id's for the fields that have multiple values
+        my @multi;
+        foreach my $f ("cc", "dependson", "blocked", "keywords") {
+            my $sth = $dbh->prepare("SELECT id " .
+                                    "FROM fielddefs " .
+                                    "WHERE name = '$f'");
+            $sth->execute();
+            my ($fid) = $sth->fetchrow_array();
+            push (@multi, $fid);
+        }
+
+        # Now we need to process the bugs_activity table and reformat the data
+        print "Fixing activity log...\n";
+        my $total = $dbh->selectrow_array('SELECT COUNT(*) FROM bugs_activity');
+        my $sth = $dbh->prepare("SELECT bug_id, who, bug_when, fieldid,
+                                oldvalue, newvalue FROM bugs_activity");
+        $sth->execute;
+        my $i = 0;
+        while (my ($bug_id, $who, $bug_when, $fieldid, $oldvalue, $newvalue)
+                   = $sth->fetchrow_array()) 
+        {
+            $i++;
+            indicate_progress({ total => $total, current => $i, every => 10 });
+            # Make sure (old|new)value isn't null (to suppress warnings)
+            $oldvalue ||= "";
+            $newvalue ||= "";
+            my ($added, $removed) = "";
+            if (grep ($_ eq $fieldid, @multi)) {
+                $oldvalue =~ s/[\s,]+/ /g;
+                $newvalue =~ s/[\s,]+/ /g;
+                my @old = split(" ", $oldvalue);
+                my @new = split(" ", $newvalue);
+                my (@add, @remove) = ();
+                # Find values that were "added"
+                foreach my $value(@new) {
+                    if (! grep ($_ eq $value, @old)) {
+                        push (@add, $value);
+                    }
+                }
+                # Find values that were removed
+                foreach my $value(@old) {
+                    if (! grep ($_ eq $value, @new)) {
+                        push (@remove, $value);
+                    }
+                }
+                $added = join (", ", @add);
+                $removed = join (", ", @remove);
+                # If we can't determine what changed, put a ? in both fields
+                unless ($added || $removed) {
+                    $added = "?";
+                    $removed = "?";
+                }
+                # If the original field (old|new)value was full, then this
+                # could be incomplete data.
+                if (length($oldvalue) == 255 || length($newvalue) == 255) {
+                    $added = "? $added";
+                    $removed = "? $removed";
+                }
+            } else {
+                $removed = $oldvalue;
+                $added = $newvalue;
+            }
+            $added = $dbh->quote($added);
+            $removed = $dbh->quote($removed);
+            $dbh->do("UPDATE bugs_activity 
+                         SET removed = $removed, added = $added
+                       WHERE bug_id = $bug_id AND who = $who
+                             AND bug_when = '$bug_when' 
+                             AND fieldid = $fieldid");
+        }
+        print "\n";
+        $dbh->bz_drop_column("bugs_activity", "oldvalue");
+        $dbh->bz_drop_column("bugs_activity", "newvalue");
+    }
+}
+
+sub _delete_logincookies_cryptpassword_and_handle_invalid_cookies {
+    my $dbh = Bugzilla->dbh;
+    # 2002-02-04 bbaetz@student.usyd.edu.au bug 95732
+    # Remove logincookies.cryptpassword, and delete entries which become
+    # invalid
+    if ($dbh->bz_column_info("logincookies", "cryptpassword")) {
+        # We need to delete any cookies which are invalid before dropping the
+        # column
+        print "Removing invalid login cookies...\n";
+
+        # mysql doesn't support DELETE with multi-table queries, so we have
+        # to iterate
+        my $sth = $dbh->prepare("SELECT cookie FROM logincookies, profiles " .
+                                "WHERE logincookies.cryptpassword != " .
+                                "profiles.cryptpassword AND " .
+                                "logincookies.userid = profiles.userid");
+        $sth->execute();
+        while (my ($cookie) = $sth->fetchrow_array()) {
+            $dbh->do("DELETE FROM logincookies WHERE cookie = $cookie");
+        }
+
+        $dbh->bz_drop_column("logincookies", "cryptpassword");
+    }
+}
+
+sub _use_ip_instead_of_hostname_in_logincookies {
+    my $dbh = Bugzilla->dbh;
+
+    # 2002-03-15 bbaetz@student.usyd.edu.au - bug 129466
+    # 2002-05-13 preed@sigkill.com - bug 129446 patch backported to the
+    #  BUGZILLA-2_14_1-BRANCH as a security blocker for the 2.14.2 release
+    #
+    # Use the ip, not the hostname, in the logincookies table
+    if ($dbh->bz_column_info("logincookies", "hostname")) {
+        print "Clearing the logincookies table...\n";
+        # We've changed what we match against, so all entries are now invalid
+        $dbh->do("DELETE FROM logincookies");
+
+        # Now update the logincookies schema
+        $dbh->bz_drop_column("logincookies", "hostname");
+        $dbh->bz_add_column("logincookies", "ipaddr",
+                            {TYPE => 'varchar(40)'});
+    }
+}
+
+sub _move_quips_into_db {
+    my $dbh = Bugzilla->dbh;
+    my $datadir = bz_locations->{'datadir'};
+    # 2002-07-15 davef@tetsubo.com - bug 67950
+    # Move quips to the db.
+    if (-e "$datadir/comments") {
+        print "Populating quips table from $datadir/comments...\n";
+        my $comments = new IO::File("$datadir/comments", 'r')
+            || die "$datadir/comments: $!";
+        $comments->untaint;
+        while (<$comments>) {
+            chomp;
+            $dbh->do("INSERT INTO quips (quip) VALUES (?)", undef, $_);
+        }
+
+        print "\n", install_string('update_quips', { data => $datadir }), "\n";
+        $comments->close;
+        rename("$datadir/comments", "$datadir/comments.bak")
+            || warn "Failed to rename: $!";
+    }
+}
+
+sub _use_ids_for_products_and_components {
+    my $dbh = Bugzilla->dbh;
+    # 2002-08-12 jake@bugzilla.org/bbaetz@student.usyd.edu.au - bug 43600
+    # Use integer IDs for products and components.
+    if ($dbh->bz_column_info("products", "product")) {
+        print "Updating database to use product IDs.\n";
+
+        # First, we need to remove possible NULL entries
+        # NULLs may exist, but won't have been used, since all the uses of them
+        # are in NOT NULL fields in other tables
+        $dbh->do("DELETE FROM products WHERE product IS NULL");
+        $dbh->do("DELETE FROM components WHERE value IS NULL");
+
+        $dbh->bz_add_column("products", "id",
+            {TYPE => 'SMALLSERIAL', NOTNULL => 1, PRIMARYKEY => 1});
+        $dbh->bz_add_column("components", "product_id",
+            {TYPE => 'INT2', NOTNULL => 1}, 0);
+        $dbh->bz_add_column("versions", "product_id",
+            {TYPE => 'INT2', NOTNULL => 1}, 0);
+        $dbh->bz_add_column("milestones", "product_id",
+            {TYPE => 'INT2', NOTNULL => 1}, 0);
+        $dbh->bz_add_column("bugs", "product_id",
+            {TYPE => 'INT2', NOTNULL => 1}, 0);
+
+        # The attachstatusdefs table was added in version 2.15, but 
+        # removed again in early 2.17.  If it exists now, we still need 
+        # to perform this change with product_id because the code later on
+        # which converts the attachment statuses to flags depends on it.
+        # But we need to avoid this if the user is upgrading from 2.14
+        # or earlier (because it won't be there to convert).
+        if ($dbh->bz_table_info("attachstatusdefs")) {
+            $dbh->bz_add_column("attachstatusdefs", "product_id",
+                {TYPE => 'INT2', NOTNULL => 1}, 0);
+        }
+
+        my %products;
+        my $sth = $dbh->prepare("SELECT id, product FROM products");
+        $sth->execute;
+        while (my ($product_id, $product) = $sth->fetchrow_array()) {
+            if (exists $products{$product}) {
+                print "Ignoring duplicate product $product\n";
+                $dbh->do("DELETE FROM products WHERE id = $product_id");
+                next;
+            }
+            $products{$product} = 1;
+            $dbh->do("UPDATE components SET product_id = $product_id " .
+                     "WHERE program = " . $dbh->quote($product));
+            $dbh->do("UPDATE versions SET product_id = $product_id " .
+                     "WHERE program = " . $dbh->quote($product));
+            $dbh->do("UPDATE milestones SET product_id = $product_id " .
+                     "WHERE product = " . $dbh->quote($product));
+            $dbh->do("UPDATE bugs SET product_id = $product_id " .
+                     "WHERE product = " . $dbh->quote($product));
+            $dbh->do("UPDATE attachstatusdefs SET product_id = $product_id " .
+                     "WHERE product = " . $dbh->quote($product))
+                if $dbh->bz_table_info("attachstatusdefs");
+        }
+
+        print "Updating the database to use component IDs.\n";
+
+        $dbh->bz_add_column("components", "id",
+            {TYPE => 'SMALLSERIAL', NOTNULL => 1, PRIMARYKEY => 1});
+        $dbh->bz_add_column("bugs", "component_id",
+                            {TYPE => 'INT2', NOTNULL => 1}, 0);
+
+        my %components;
+        $sth = $dbh->prepare("SELECT id, value, product_id FROM components");
+        $sth->execute;
+        while (my ($component_id, $component, $product_id) 
+            = $sth->fetchrow_array()) 
+        {
+            if (exists $components{$component}) {
+                if (exists $components{$component}{$product_id}) {
+                    print "Ignoring duplicate component $component for",
+                          " product $product_id\n";
+                    $dbh->do("DELETE FROM components WHERE id = $component_id");
+                    next;
+                }
+            } else {
+                $components{$component} = {};
+            }
+            $components{$component}{$product_id} = 1;
+            $dbh->do("UPDATE bugs SET component_id = $component_id " .
+                      "WHERE component = " . $dbh->quote($component) .
+                       " AND product_id = $product_id");
+        }
+        print "Fixing Indexes and Uniqueness.\n";
+        $dbh->bz_drop_index('milestones', 'milestones_product_idx');
+
+        $dbh->bz_add_index('milestones', 'milestones_product_id_idx',
+            {TYPE => 'UNIQUE', FIELDS => [qw(product_id value)]});
+
+        $dbh->bz_drop_index('bugs', 'bugs_product_idx');
+        $dbh->bz_add_index('bugs', 'bugs_product_id_idx', [qw(product_id)]);
+        $dbh->bz_drop_index('bugs', 'bugs_component_idx');
+        $dbh->bz_add_index('bugs', 'bugs_component_id_idx', [qw(component_id)]);
+
+        print "Removing, renaming, and retyping old product and",
+              " component fields.\n";
+        $dbh->bz_drop_column("components", "program");
+        $dbh->bz_drop_column("versions", "program");
+        $dbh->bz_drop_column("milestones", "product");
+        $dbh->bz_drop_column("bugs", "product");
+        $dbh->bz_drop_column("bugs", "component");
+        $dbh->bz_drop_column("attachstatusdefs", "product")
+            if $dbh->bz_table_info("attachstatusdefs");
+        $dbh->bz_rename_column("products", "product", "name");
+        $dbh->bz_alter_column("products", "name",
+                              {TYPE => 'varchar(64)', NOTNULL => 1});
+        $dbh->bz_rename_column("components", "value", "name");
+        $dbh->bz_alter_column("components", "name",
+                              {TYPE => 'varchar(64)', NOTNULL => 1});
+
+        print "Adding indexes for products and components tables.\n";
+        $dbh->bz_add_index('products', 'products_name_idx',
+                           {TYPE => 'UNIQUE', FIELDS => [qw(name)]});
+        $dbh->bz_add_index('components', 'components_product_id_idx',
+            {TYPE => 'UNIQUE', FIELDS => [qw(product_id name)]});
+        $dbh->bz_add_index('components', 'components_name_idx', [qw(name)]);
+    }
+}
+
+# Helper for the below function.
+#
+# _list_bits(arg) returns a list of UNKNOWN<n> if the group
+# has been deleted for all bits set in arg. When the activity
+# records are converted from groupset numbers to lists of
+# group names, _list_bits is used to fill in a list of references
+# to groupset bits for groups that no longer exist.
+sub _list_bits {
+    my ($num) = @_;
+    my $dbh = Bugzilla->dbh;
+    my @res;
+    my $curr = 1;
+    while (1) {
+        # Convert a big integer to a list of bits
+        my $sth = $dbh->prepare("SELECT ($num & ~$curr) > 0,
+                                        ($num & $curr),
+                                        ($num & ~$curr),
+                                        $curr << 1");
+        $sth->execute;
+        my ($more, $thisbit, $remain, $nval) = $sth->fetchrow_array;
+        push @res,"UNKNOWN<$curr>" if ($thisbit);
+        $curr = $nval;
+        $num = $remain;
+        last if !$more;
+    }
+    return @res;
+}
+
+sub _convert_groups_system_from_groupset {
+    my $dbh = Bugzilla->dbh;
+    # 2002-09-22 - bugreport@peshkin.net - bug 157756
+    #
+    # If the whole groups system is new, but the installation isn't,
+    # convert all the old groupset groups, etc...
+    #
+    # This requires:
+    # 1) define groups ids in group table
+    # 2) populate user_group_map with grants from old groupsets 
+    #    and blessgroupsets
+    # 3) populate bug_group_map with data converted from old bug groupsets
+    # 4) convert activity logs to use group names instead of numbers
+    # 5) identify the admin from the old all-ones groupset
+
+    # The groups system needs to be converted if groupset exists
+    if ($dbh->bz_column_info("profiles", "groupset")) {
+        # Some mysql versions will promote any unique key to primary key
+        # so all unique keys are removed first and then added back in
+        $dbh->bz_drop_index('groups', 'groups_bit_idx');
+        $dbh->bz_drop_index('groups', 'groups_name_idx');
+        my @primary_key = $dbh->primary_key(undef, undef, 'groups');
+        if (@primary_key) {
+            $dbh->do("ALTER TABLE groups DROP PRIMARY KEY");
+        }
+
+        $dbh->bz_add_column('groups', 'id',
+            {TYPE => 'MEDIUMSERIAL', NOTNULL => 1, PRIMARYKEY => 1});
+
+        $dbh->bz_add_index('groups', 'groups_name_idx',
+                           {TYPE => 'UNIQUE', FIELDS => [qw(name)]});
+
+        # Convert all existing groupset records to map entries before removing
+        # groupset fields or removing "bit" from groups.
+        my $sth = $dbh->prepare("SELECT bit, id FROM groups WHERE bit > 0");
+        $sth->execute();
+        while (my ($bit, $gid) = $sth->fetchrow_array) {
+            # Create user_group_map membership grants for old groupsets.
+            # Get each user with the old groupset bit set
+            my $sth2 = $dbh->prepare("SELECT userid FROM profiles
+                                       WHERE (groupset & $bit) != 0");
+            $sth2->execute();
+            while (my ($uid) = $sth2->fetchrow_array) {
+                # Check to see if the user is already a member of the group
+                # and, if not, insert a new record.
+                my $query = "SELECT user_id FROM user_group_map
+                              WHERE group_id = $gid AND user_id = $uid
+                                    AND isbless = 0";
+                my $sth3 = $dbh->prepare($query);
+                $sth3->execute();
+                if ( !$sth3->fetchrow_array() ) {
+                    $dbh->do("INSERT INTO user_group_map
+                              (user_id, group_id, isbless, grant_type)
+                              VALUES ($uid, $gid, 0, " . GRANT_DIRECT . ")");
+                }
+            }
+            # Create user can bless group grants for old groupsets, but only
+            # if we're upgrading from a Bugzilla that had blessing.
+            if($dbh->bz_column_info('profiles', 'blessgroupset')) {
+                # Get each user with the old blessgroupset bit set
+                $sth2 = $dbh->prepare("SELECT userid FROM profiles
+                                        WHERE (blessgroupset & $bit) != 0");
+                $sth2->execute();
+                while (my ($uid) = $sth2->fetchrow_array) {
+                    $dbh->do("INSERT INTO user_group_map
+                              (user_id, group_id, isbless, grant_type)
+                              VALUES ($uid, $gid, 1, " . GRANT_DIRECT . ")");
+                }
+            }
+            # Create bug_group_map records for old groupsets.
+            # Get each bug with the old group bit set.
+            $sth2 = $dbh->prepare("SELECT bug_id FROM bugs
+                                    WHERE (groupset & $bit) != 0");
+            $sth2->execute();
+            while (my ($bug_id) = $sth2->fetchrow_array) {
+               # Insert the bug, group pair into the bug_group_map.
+                $dbh->do("INSERT INTO bug_group_map (bug_id, group_id)
+                          VALUES ($bug_id, $gid)");
+            }
+        }
+        # Replace old activity log groupset records with lists of names 
+        # of groups.
+        $sth = $dbh->prepare("SELECT id FROM fielddefs
+                               WHERE name = " . $dbh->quote('bug_group'));
+        $sth->execute();
+        my ($bgfid) = $sth->fetchrow_array;
+        # Get the field id for the old groupset field
+        $sth = $dbh->prepare("SELECT id FROM fielddefs
+                               WHERE name = " . $dbh->quote('groupset'));
+        $sth->execute();
+        my ($gsid) = $sth->fetchrow_array;
+        # Get all bugs_activity records from groupset changes
+        if ($gsid) {
+            $sth = $dbh->prepare("SELECT bug_id, bug_when, who, added, removed
+                                    FROM bugs_activity WHERE fieldid = $gsid");
+            $sth->execute();
+            while (my ($bug_id, $bug_when, $who, $added, $removed) = 
+                       $sth->fetchrow_array) 
+            {
+                $added ||= 0;
+                $removed ||= 0;
+                # Get names of groups added.
+                my $sth2 = $dbh->prepare("SELECT name FROM groups
+                                           WHERE (bit & $added) != 0
+                                                 AND (bit & $removed) = 0");
+                $sth2->execute();
+                my @logadd;
+                while (my ($n) = $sth2->fetchrow_array) {
+                    push @logadd, $n;
+                }
+                # Get names of groups removed.
+                $sth2 = $dbh->prepare("SELECT name FROM groups
+                                        WHERE (bit & $removed) != 0
+                                              AND (bit & $added) = 0");
+                $sth2->execute();
+                my @logrem;
+                while (my ($n) = $sth2->fetchrow_array) {
+                    push @logrem, $n;
+                }
+                # Get list of group bits added that correspond to 
+                # missing groups.
+                $sth2 = $dbh->prepare("SELECT ($added & ~BIT_OR(bit)) 
+                                         FROM groups");
+                $sth2->execute();
+                my ($miss) = $sth2->fetchrow_array;
+                if ($miss) {
+                    push @logadd, _list_bits($miss);
+                    print "\nWARNING - GROUPSET ACTIVITY ON BUG $bug_id",
+                          " CONTAINS DELETED GROUPS\n";
+                }
+                # Get list of group bits deleted that correspond to 
+                # missing groups.
+                $sth2 = $dbh->prepare("SELECT ($removed & ~BIT_OR(bit)) 
+                                         FROM groups");
+                $sth2->execute();
+                ($miss) = $sth2->fetchrow_array;
+                if ($miss) {
+                    push @logrem, _list_bits($miss);
+                    print "\nWARNING - GROUPSET ACTIVITY ON BUG $bug_id",
+                          " CONTAINS DELETED GROUPS\n";
+                }
+                my $logr = "";
+                my $loga = "";
+                $logr = join(", ", @logrem) . '?' if @logrem;
+                $loga = join(", ", @logadd) . '?' if @logadd;
+                # Replace to old activity record with the converted data.
+                $dbh->do("UPDATE bugs_activity SET fieldid = $bgfid, added = " .
+                          $dbh->quote($loga) . ", removed = " .
+                          $dbh->quote($logr) .
+                         " WHERE bug_id = $bug_id AND bug_when = " .
+                          $dbh->quote($bug_when) .
+                         " AND who = $who AND fieldid = $gsid");
+            }
+            # Replace groupset changes with group name changes in
+            # profiles_activity. Get profiles_activity records for groupset.
+            $sth = $dbh->prepare(
+                 "SELECT userid, profiles_when, who, newvalue, oldvalue " .
+                   "FROM profiles_activity " .
+                  "WHERE fieldid = $gsid");
+            $sth->execute();
+            while (my ($uid, $uwhen, $uwho, $added, $removed) = 
+                       $sth->fetchrow_array) 
+            {
+                $added ||= 0;
+                $removed ||= 0;
+                # Get names of groups added.
+                my $sth2 = $dbh->prepare("SELECT name FROM groups
+                                           WHERE (bit & $added) != 0
+                                                 AND (bit & $removed) = 0");
+                $sth2->execute();
+                my @logadd;
+                while (my ($n) = $sth2->fetchrow_array) {
+                    push @logadd, $n;
+                }
+                # Get names of groups removed.
+                $sth2 = $dbh->prepare("SELECT name FROM groups
+                                        WHERE (bit & $removed) != 0
+                                              AND (bit & $added) = 0");
+                $sth2->execute();
+                my @logrem;
+                while (my ($n) = $sth2->fetchrow_array) {
+                    push @logrem, $n;
+                }
+                my $ladd = "";
+                my $lrem = "";
+                $ladd = join(", ", @logadd) . '?' if @logadd;
+                $lrem = join(", ", @logrem) . '?' if @logrem;
+                # Replace profiles_activity record for groupset change
+                # with group list.
+                $dbh->do("UPDATE profiles_activity " .
+                            "SET fieldid = $bgfid, newvalue = " .
+                          $dbh->quote($ladd) . ", oldvalue = " .
+                          $dbh->quote($lrem) .
+                         " WHERE userid = $uid AND profiles_when = " .
+                          $dbh->quote($uwhen) .
+                               " AND who = $uwho AND fieldid = $gsid");
+            }
+        }
+
+        # Identify admin group.
+        my ($admin_gid) = $dbh->selectrow_array(
+            "SELECT id FROM groups WHERE name = 'admin'");
+        if (!$admin_gid) {
+            $dbh->do(q{INSERT INTO groups (name, description)
+                                   VALUES ('admin', 'Administrators')});
+            $admin_gid = $dbh->bz_last_key('groups', 'id');
+        }
+        # Find current admins
+        my @admins;
+        # Don't lose admins from DBs where Bug 157704 applies
+        $sth = $dbh->prepare(
+               "SELECT userid, (groupset & 65536), login_name " .
+                 "FROM profiles " .
+                "WHERE (groupset | 65536) = 9223372036854775807");
+        $sth->execute();
+        while ( my ($userid, $iscomplete, $login_name) 
+                    = $sth->fetchrow_array() ) 
+        {
+            # existing administrators are made members of group "admin"
+            print "\nWARNING - $login_name IS AN ADMIN IN SPITE OF BUG",
+                  " 157704\n\n" if (!$iscomplete);
+            push(@admins, $userid) unless grep($_ eq $userid, @admins);
+        }
+        # Now make all those users admins directly. They were already
+        # added to every other group, above, because of their groupset.
+        foreach my $admin_id (@admins) {
+            $dbh->do("INSERT INTO user_group_map
+                                  (user_id, group_id, isbless, grant_type)
+                           VALUES (?, ?, ?, ?)", 
+                      undef, $admin_id, $admin_gid, $_, GRANT_DIRECT)
+                foreach (0, 1);
+        }
+
+        $dbh->bz_drop_column('profiles','groupset');
+        $dbh->bz_drop_column('profiles','blessgroupset');
+        $dbh->bz_drop_column('bugs','groupset');
+        $dbh->bz_drop_column('groups','bit');
+        $dbh->do("DELETE FROM fielddefs WHERE name = " 
+            . $dbh->quote('groupset'));
+    }
+}
+
+sub _convert_attachment_statuses_to_flags {
+    my $dbh = Bugzilla->dbh;
+
+    # September 2002 myk@mozilla.org bug 98801
+    # Convert the attachment statuses tables into flags tables.
+    if ($dbh->bz_table_info("attachstatuses") 
+        && $dbh->bz_table_info("attachstatusdefs")) 
+    {
+        print "Converting attachment statuses to flags...\n";
+
+        # Get IDs for the old attachment status and new flag fields.
+        my ($old_field_id) = $dbh->selectrow_array(
+            "SELECT id FROM fielddefs WHERE name='attachstatusdefs.name'")
+            || 0;
+        my ($new_field_id) = $dbh->selectrow_array(
+            "SELECT id FROM fielddefs WHERE name = 'flagtypes.name'");
+
+        # Convert attachment status definitions to flag types.  If more than one
+        # status has the same name and description, it is merged into a single
+        # status with multiple inclusion records.     
+
+        my $sth = $dbh->prepare(
+            "SELECT id, name, description, sortkey, product_id  
+               FROM attachstatusdefs");
+
+        # status definition IDs indexed by name/description
+        my $def_ids = {};
+
+        # merged IDs and the IDs they were merged into.  The key is the old ID,
+        # the value is the new one.  This allows us to give statuses the right
+        # ID when we convert them over to flags.  This map includes IDs that
+        # weren't merged (in this case the old and new IDs are the same), since
+        # it makes the code simpler.
+        my $def_id_map = {};
+
+        $sth->execute();
+        while (my ($id, $name, $desc, $sortkey, $prod_id) = 
+                   $sth->fetchrow_array()) 
+        {
+            my $key = $name . $desc;
+            if (!$def_ids->{$key}) {
+                $def_ids->{$key} = $id;
+                my $quoted_name = $dbh->quote($name);
+                my $quoted_desc = $dbh->quote($desc);
+                $dbh->do("INSERT INTO flagtypes (id, name, description, 
+                                                 sortkey, target_type) 
+                          VALUES ($id, $quoted_name, $quoted_desc, 
+                                  $sortkey,'a')");
+            }
+            $def_id_map->{$id} = $def_ids->{$key};
+            $dbh->do("INSERT INTO flaginclusions (type_id, product_id)
+                      VALUES ($def_id_map->{$id}, $prod_id)");
+        }
+
+        # Note: even though we've converted status definitions, we still
+        # can't drop the table because we need it to convert the statuses 
+        # themselves.
+
+        # Convert attachment statuses to flags.  To do this we select 
+        # the statuses from the status table and then, for each one, 
+        # figure out who set it and when they set it from the bugs 
+        # activity table.
+        my $id = 0;
+        $sth = $dbh->prepare(
+            "SELECT attachstatuses.attach_id, attachstatusdefs.id,
+                    attachstatusdefs.name, attachments.bug_id
+               FROM attachstatuses, attachstatusdefs, attachments
+              WHERE attachstatuses.statusid = attachstatusdefs.id
+                    AND attachstatuses.attach_id = attachments.attach_id");
+
+        # a query to determine when the attachment status was set and who set it
+        my $sth2 = $dbh->prepare("SELECT added, who, bug_when
+                                    FROM bugs_activity
+                                   WHERE bug_id = ? AND attach_id = ?
+                                         AND fieldid = $old_field_id
+                                ORDER BY bug_when DESC");
+
+        $sth->execute();
+        while (my ($attach_id, $def_id, $status, $bug_id) = 
+                   $sth->fetchrow_array()) 
+        {
+            ++$id;
+
+            # Determine when the attachment status was set and who set it.
+            # We should always be able to find out this info from the bug
+            # activity, but we fall back to default values just in case.
+            $sth2->execute($bug_id, $attach_id);
+            my ($added, $who, $when);
+            while (($added, $who, $when) = $sth2->fetchrow_array()) {
+                last if $added =~ /(^|[, ]+)\Q$status\E([, ]+|$)/;
+            }
+            $who = $dbh->quote($who); # "NULL" by default if $who is undefined
+            $when = $when ? $dbh->quote($when) : "NOW()";
+
+
+            $dbh->do("INSERT INTO flags (id, type_id, status, bug_id, 
+                      attach_id, creation_date, modification_date, 
+                      requestee_id, setter_id)
+                      VALUES ($id, $def_id_map->{$def_id}, '+', $bug_id,
+                              $attach_id, $when, $when, NULL, $who)");
+        }
+
+        # Now that we've converted both tables we can drop them.
+        $dbh->bz_drop_table("attachstatuses");
+        $dbh->bz_drop_table("attachstatusdefs");
+
+        # Convert activity records for attachment statuses into records 
+        # for flags.
+        $sth = $dbh->prepare("SELECT attach_id, who, bug_when, added, 
+                                     removed 
+                                FROM bugs_activity 
+                               WHERE fieldid = $old_field_id");
+        $sth->execute();
+        while (my ($attach_id, $who, $when, $old_added, $old_removed) =
+                   $sth->fetchrow_array())
+        {
+            my @additions = split(/[, ]+/, $old_added);
+            @additions = map("$_+", @additions);
+            my $new_added = $dbh->quote(join(", ", @additions));
+
+            my @removals = split(/[, ]+/, $old_removed);
+            @removals = map("$_+", @removals);
+            my $new_removed = $dbh->quote(join(", ", @removals));
+
+            $old_added = $dbh->quote($old_added);
+            $old_removed = $dbh->quote($old_removed);
+            $who = $dbh->quote($who);
+            $when = $dbh->quote($when);
+
+            $dbh->do("UPDATE bugs_activity SET fieldid = $new_field_id, " .
+                     "added = $new_added, removed = $new_removed " .
+                     "WHERE attach_id = $attach_id AND who = $who " .
+                     "AND bug_when = $when AND fieldid = $old_field_id " .
+                     "AND added = $old_added AND removed = $old_removed");
+        }
+
+        # Remove the attachment status field from the field definitions.
+        $dbh->do("DELETE FROM fielddefs WHERE name='attachstatusdefs.name'");
+
+        print "done.\n";
+    }
+}
+
+sub _remove_spaces_and_commas_from_flagtypes {
+    my $dbh = Bugzilla->dbh;
+    # Get all names and IDs, to find broken ones and to
+    # check for collisions when renaming.
+    my $sth = $dbh->prepare("SELECT name, id FROM flagtypes");
+    $sth->execute();
+
+    my %flagtypes;
+    my @badflagnames; 
+    # find broken flagtype names, and populate a hash table
+    # to check for collisions.
+    while (my ($name, $id) = $sth->fetchrow_array()) {
+        $flagtypes{$name} = $id;
+        if ($name =~ /[ ,]/) {
+            push(@badflagnames, $name);
+        }
+    }
+    if (@badflagnames) {
+        print "Removing spaces and commas from flag names...\n";
+        my ($flagname, $tryflagname);
+        my $sth = $dbh->prepare("UPDATE flagtypes SET name = ? WHERE id = ?");
+        foreach $flagname (@badflagnames) {
+            print "  Bad flag type name \"$flagname\" ...\n";
+            # find a new name for this flagtype.
+            ($tryflagname = $flagname) =~ tr/ ,/__/;
+            # avoid collisions with existing flagtype names.
+            while (defined($flagtypes{$tryflagname})) {
+                print "  ... can't rename as \"$tryflagname\" ...\n";
+                $tryflagname .= "'";
+                if (length($tryflagname) > 50) {
+                    my $lastchanceflagname = (substr $tryflagname, 0, 47) . '...';
+                    if (defined($flagtypes{$lastchanceflagname})) {
+                        print "  ... last attempt as \"$lastchanceflagname\" still failed.'\n";
+                        die install_string('update_flags_bad_name',
+                                           { flag => $flagname }), "\n";
+                    }
+                    $tryflagname = $lastchanceflagname;
+                }
+            }
+            $sth->execute($tryflagname, $flagtypes{$flagname});
+            print "  renamed flag type \"$flagname\" as \"$tryflagname\"\n";
+            $flagtypes{$tryflagname} = $flagtypes{$flagname};
+            delete $flagtypes{$flagname};
+        }
+        print "... done.\n";
+    }
+}
+
+sub _setup_usebuggroups_backward_compatibility {
+    my $dbh = Bugzilla->dbh;
+
+    # Don't run this on newer Bugzillas. This is a reliable test because
+    # the longdescs table existed in 2.16 (which had usebuggroups)
+    # but not in 2.18, and this code happens between 2.16 and 2.18.
+    return if $dbh->bz_column_info('longdescs', 'already_wrapped');
+
+    # 2002-11-24 - bugreport@peshkin.net - bug 147275
+    #
+    # If group_control_map is empty, backward-compatibility
+    # usebuggroups-equivalent records should be created.
+    my ($maps_exist) = $dbh->selectrow_array(
+        "SELECT DISTINCT 1 FROM group_control_map");
+    if (!$maps_exist) {
+        print "Converting old usebuggroups controls...\n";
+        # Initially populate group_control_map.
+        # First, get all the existing products and their groups.
+        my $sth = $dbh->prepare("SELECT groups.id, products.id, groups.name,
+                                        products.name 
+                                  FROM groups, products
+                                 WHERE isbuggroup != 0");
+        $sth->execute();
+        while (my ($groupid, $productid, $groupname, $productname)
+                = $sth->fetchrow_array()) 
+        {
+            if ($groupname eq $productname) {
+                # Product and group have same name.
+                $dbh->do("INSERT INTO group_control_map " .
+                         "(group_id, product_id, membercontrol, othercontrol) " .
+                         "VALUES (?, ?, ?, ?)", undef,
+                         ($groupid, $productid, CONTROLMAPDEFAULT, CONTROLMAPNA));
+            } else {
+                # See if this group is a product group at all.
+                my $sth2 = $dbh->prepare("SELECT id FROM products 
+                    WHERE name = " .$dbh->quote($groupname));
+                $sth2->execute();
+                my ($id) = $sth2->fetchrow_array();
+                if (!$id) {
+                    # If there is no product with the same name as this
+                    # group, then it is permitted for all products.
+                    $dbh->do("INSERT INTO group_control_map " .
+                             "(group_id, product_id, membercontrol, othercontrol) " .
+                             "VALUES (?, ?, ?, ?)", undef,
+                             ($groupid, $productid, CONTROLMAPSHOWN, CONTROLMAPNA));
+                }
+            }
+        }
+    }
+}
+
+sub _remove_user_series_map {
+    my $dbh = Bugzilla->dbh;
+    # 2004-07-17 GRM - Remove "subscriptions" concept from charting, and add
+    # group-based security instead.
+    if ($dbh->bz_table_info("user_series_map")) {
+        # Oracle doesn't like "date" as a column name, and apparently some DBs
+        # don't like 'value' either. We use the changes to subscriptions as
+        # something to hang these renamings off.
+        $dbh->bz_rename_column('series_data', 'date', 'series_date');
+        $dbh->bz_rename_column('series_data', 'value', 'series_value');
+
+        # series_categories.category_id produces a too-long column name for the
+        # auto-incrementing sequence (Oracle again).
+        $dbh->bz_rename_column('series_categories', 'category_id', 'id');
+
+        $dbh->bz_add_column("series", "public",
+            {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE'});
+
+        # Migrate public-ness across from user_series_map to new field
+        my $sth = $dbh->prepare("SELECT series_id from user_series_map " .
+                                 "WHERE user_id = 0");
+        $sth->execute();
+        while (my ($public_series_id) = $sth->fetchrow_array()) {
+            $dbh->do("UPDATE series SET public = 1 " .
+                     "WHERE series_id = $public_series_id");
+        }
+
+        $dbh->bz_drop_table("user_series_map");
+    }
+}
+
+sub _copy_old_charts_into_database {
+    my $dbh = Bugzilla->dbh;
+    my $datadir = bz_locations()->{'datadir'};
+    # 2003-06-26 Copy the old charting data into the database, and create the
+    # queries that will keep it all running. When the old charting system goes
+    # away, if this code ever runs, it'll just find no files and do nothing.
+    my $series_exists = $dbh->selectrow_array("SELECT 1 FROM series " .
+                                              $dbh->sql_limit(1));
+    if (!$series_exists && -d "$datadir/mining" && -e "$datadir/mining/-All-") {
+        print "Migrating old chart data into database...\n";
+
+        # We prepare the handle to insert the series data
+        my $seriesdatasth = $dbh->prepare(
+            "INSERT INTO series_data (series_id, series_date, series_value)
+                  VALUES (?, ?, ?)");
+
+        my $deletesth = $dbh->prepare(
+            "DELETE FROM series_data WHERE series_id = ? AND series_date = ?");
+
+        my $groupmapsth = $dbh->prepare(
+            "INSERT INTO category_group_map (category_id, group_id)
+                  VALUES (?, ?)");
+
+        # Fields in the data file (matches the current collectstats.pl)
+        my @statuses =
+            qw(NEW ASSIGNED REOPENED UNCONFIRMED RESOLVED VERIFIED CLOSED);
+        my @resolutions =
+            qw(FIXED INVALID WONTFIX LATER REMIND DUPLICATE WORKSFORME MOVED);
+        my @fields = (@statuses, @resolutions);
+
+        # We have a localization problem here. Where do we get these values?
+        my $all_name = "-All-";
+        my $open_name = "All Open";
+
+        $dbh->bz_start_transaction();
+        my $products = $dbh->selectall_arrayref("SELECT name FROM products");
+
+        foreach my $product ((map { $_->[0] } @$products), "-All-") {
+            print "$product:\n";
+            # First, create the series
+            my %queries;
+            my %seriesids;
+
+            my $query_prod = "";
+            if ($product ne "-All-") {
+                $query_prod = "product=" . html_quote($product) . "&";
+            }
+
+            # The query for statuses is different to that for resolutions.
+            $queries{$_} = ($query_prod . "bug_status=$_") foreach (@statuses);
+            $queries{$_} = ($query_prod . "resolution=$_") 
+                foreach (@resolutions);
+
+            foreach my $field (@fields) {
+                # Create a Series for each field in this product.
+                my $series = new Bugzilla::Series(undef, $product, $all_name,
+                                                  $field, undef, 1,
+                                                  $queries{$field}, 1);
+                $series->writeToDatabase();
+                $seriesids{$field} = $series->{'series_id'};
+            }
+
+            # We also add a new query for "Open", so that migrated products get
+            # the same set as new products (see editproducts.cgi.)
+            my @openedstatuses = ("UNCONFIRMED", "NEW", "ASSIGNED", "REOPENED");
+            my $query = join("&", map { "bug_status=$_" } @openedstatuses);
+            my $series = new Bugzilla::Series(undef, $product, $all_name,
+                                              $open_name, undef, 1,
+                                              $query_prod . $query, 1);
+            $series->writeToDatabase();
+            $seriesids{$open_name} = $series->{'series_id'};
+
+            # Now, we attempt to read in historical data, if any
+            # Convert the name in the same way that collectstats.pl does
+            my $product_file = $product;
+            $product_file =~ s/\//-/gs;
+            $product_file = "$datadir/mining/$product_file";
+
+            # There are many reasons that this might fail (e.g. no stats 
+            # for this product), so we don't worry if it does.
+            my $in = new IO::File($product_file) or next;
+
+            # The data files should be in a standard format, even for old
+            # Bugzillas, because of the conversion code further up this file.
+            my %data;
+            my $last_date = "";
+
+            my @lines = <$in>;
+            while (my $line = shift @lines) {
+                if ($line =~ /^(\d+\|.*)/) {
+                    my @numbers = split(/\||\r/, $1);
+
+                    # Only take the first line for each date; it was possible to
+                    # run collectstats.pl more than once in a day.
+                    next if $numbers[0] eq $last_date;
+
+                    for my $i (0 .. $#fields) {
+                        # $numbers[0] is the date
+                        $data{$fields[$i]}{$numbers[0]} = $numbers[$i + 1];
+
+                        # Keep a total of the number of open bugs for this day
+                        if (grep { $_ eq $fields[$i] } @openedstatuses) {
+                            $data{$open_name}{$numbers[0]} += $numbers[$i + 1];
+                        }
+                    }
+
+                    $last_date = $numbers[0];
+                }
+            }
+
+            $in->close;
+
+            my $total_items = (scalar(@fields) + 1) 
+                              * scalar(keys %{ $data{'NEW'} });
+            my $count = 0;
+            foreach my $field (@fields, $open_name) {
+                # Insert values into series_data: series_id, date, value
+                my %fielddata = %{$data{$field}};
+                foreach my $date (keys %fielddata) {
+                    # We need to delete in case the text file had duplicate 
+                    # entries in it.
+                    $deletesth->execute($seriesids{$field}, $date);
+
+                    # We prepared this above
+                    $seriesdatasth->execute($seriesids{$field},
+                                            $date, $fielddata{$date} || 0);
+                    indicate_progress({ total => $total_items, 
+                                        current => ++$count, every => 100 });
+                }
+            }
+
+            # Create the groupsets for the category
+            my $category_id =
+                $dbh->selectrow_array("SELECT id FROM series_categories " .
+                                   "WHERE name = " . $dbh->quote($product));
+            my $product_id =
+                $dbh->selectrow_array("SELECT id FROM products " .
+                                   "WHERE name = " . $dbh->quote($product));
+
+            if (defined($category_id) && defined($product_id)) {
+
+                # Get all the mandatory groups for this product
+                my $group_ids =
+                    $dbh->selectcol_arrayref("SELECT group_id " .
+                         "FROM group_control_map " .
+                         "WHERE product_id = $product_id " .
+                         "AND (membercontrol = " . CONTROLMAPMANDATORY .
+                           " OR othercontrol = " . CONTROLMAPMANDATORY . ")");
+
+                foreach my $group_id (@$group_ids) {
+                    $groupmapsth->execute($category_id, $group_id);
+                }
+            }
+        }
+
+        $dbh->bz_commit_transaction();
+    }
+}
+
+sub _add_user_group_map_grant_type {
+    my $dbh = Bugzilla->dbh;
+    # 2004-04-12 - Keep regexp-based group permissions up-to-date - Bug 240325
+    if ($dbh->bz_column_info("user_group_map", "isderived")) {
+        $dbh->bz_add_column('user_group_map', 'grant_type',
+            {TYPE => 'INT1', NOTNULL => 1, DEFAULT => '0'});
+        $dbh->do("DELETE FROM user_group_map WHERE isderived != 0");
+        $dbh->do("UPDATE user_group_map SET grant_type = " . GRANT_DIRECT);
+        $dbh->bz_drop_column("user_group_map", "isderived");
+
+        $dbh->bz_drop_index('user_group_map', 'user_group_map_user_id_idx');
+        $dbh->bz_add_index('user_group_map', 'user_group_map_user_id_idx',
+            {TYPE => 'UNIQUE',
+             FIELDS => [qw(user_id group_id grant_type isbless)]});
+    }
+}
+
+sub _add_group_group_map_grant_type {
+    my $dbh = Bugzilla->dbh;
+    # 2004-07-16 - Make it possible to have group-group relationships other than
+    # membership and bless.
+    if ($dbh->bz_column_info("group_group_map", "isbless")) {
+        $dbh->bz_add_column('group_group_map', 'grant_type',
+            {TYPE => 'INT1', NOTNULL => 1, DEFAULT => '0'});
+        $dbh->do("UPDATE group_group_map SET grant_type = " .
+                 "IF(isbless, " . GROUP_BLESS . ", " .
+                  GROUP_MEMBERSHIP . ")");
+        $dbh->bz_drop_index('group_group_map', 'group_group_map_member_id_idx');
+        $dbh->bz_drop_column("group_group_map", "isbless");
+        $dbh->bz_add_index('group_group_map', 'group_group_map_member_id_idx',
+            {TYPE => 'UNIQUE', 
+             FIELDS => [qw(member_id grantor_id grant_type)]});
+    }
+}
+
+sub _add_longdescs_already_wrapped {
+    my $dbh = Bugzilla->dbh;
+    # 2005-01-29 - mkanat@bugzilla.org
+    if (!$dbh->bz_column_info('longdescs', 'already_wrapped')) {
+        # Old, pre-wrapped comments should not be auto-wrapped
+        $dbh->bz_add_column('longdescs', 'already_wrapped',
+            {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE'}, 1);
+        # If an old comment doesn't have a newline in the first 81 characters,
+        # (or doesn't contain a newline at all) and it contains a space,
+        # then it's probably a mis-wrapped comment and we should wrap it
+        # at display-time.
+        print "Fixing old, mis-wrapped comments...\n";
+        $dbh->do(q{UPDATE longdescs SET already_wrapped = 0
+                    WHERE (} . $dbh->sql_position(q{'\n'}, 'thetext') . q{ > 81
+                       OR } . $dbh->sql_position(q{'\n'}, 'thetext') . q{ = 0)
+                      AND SUBSTRING(thetext FROM 1 FOR 80) LIKE '% %'});
+    }
+}
+
+sub _convert_attachments_filename_from_mediumtext {
+    my $dbh = Bugzilla->dbh;
+    # 2002 November, myk@mozilla.org, bug 178841:
+    #
+    # Convert the "attachments.filename" column from a ridiculously large
+    # "mediumtext" to a much more sensible "varchar(100)".  Also takes
+    # the opportunity to remove paths from existing filenames, since they
+    # shouldn't be there for security.  Buggy browsers include them,
+    # and attachment.cgi now takes them out, but old ones need converting.
+    my $ref = $dbh->bz_column_info("attachments", "filename");
+    if ($ref->{TYPE} ne 'varchar(100)' && $ref->{TYPE} ne 'varchar(255)') {
+        print "Removing paths from filenames in attachments table...";
+
+        my $sth = $dbh->prepare("SELECT attach_id, filename FROM attachments " .
+            "WHERE " . $dbh->sql_position(q{'/'}, 'filename') . " > 0 OR " .
+            $dbh->sql_position(q{'\\\\'}, 'filename') . " > 0");
+        $sth->execute;
+
+        while (my ($attach_id, $filename) = $sth->fetchrow_array) {
+            $filename =~ s/^.*[\/\\]//;
+            my $quoted_filename = $dbh->quote($filename);
+            $dbh->do("UPDATE attachments SET filename = $quoted_filename " .
+                     "WHERE attach_id = $attach_id");
+        }
+
+        print "Done.\n";
+
+        $dbh->bz_alter_column("attachments", "filename",
+                              {TYPE => 'varchar(100)', NOTNULL => 1});
+    }
+}
+
+sub _rename_votes_count_and_force_group_refresh {
+    my $dbh = Bugzilla->dbh;
+    # 2003-04-27 - bugzilla@chimpychompy.org (GavinS)
+    #
+    # Bug 180086 (http://bugzilla.mozilla.org/show_bug.cgi?id=180086)
+    #
+    # Renaming the 'count' column in the votes table because Sybase doesn't
+    # like it
+    return if !$dbh->bz_table_info('votes');
+    return if $dbh->bz_column_info('votes', 'count');
+    $dbh->bz_rename_column('votes', 'count', 'vote_count');
+}
+
+sub _fix_group_with_empty_name {
+    my $dbh = Bugzilla->dbh;
+    # 2005-01-12 Nick Barnes <nb@ravenbrook.com> bug 278010
+    # Rename any group which has an empty name.
+    # Note that there can be at most one such group (because of
+    # the SQL index on the name column).
+    my ($emptygroupid) = $dbh->selectrow_array(
+        "SELECT id FROM groups where name = ''");
+    if ($emptygroupid) {
+        # There is a group with an empty name; find a name to rename it
+        # as.  Must avoid collisions with existing names.  Start with
+        # group_$gid and add _<n> if necessary.
+        my $trycount = 0;
+        my $trygroupname;
+        my $sth = $dbh->prepare("SELECT 1 FROM groups where name = ?");
+        my $name_exists = 1;
+
+        while ($name_exists) {
+            $trygroupname = "group_$emptygroupid";
+            if ($trycount > 0) {
+               $trygroupname .= "_$trycount";
+            }
+            $name_exists = $dbh->selectrow_array($sth, undef, $trygroupname);
+            $trycount++;
+        }
+        $dbh->do("UPDATE groups SET name = ? WHERE id = ?",
+                 undef, $trygroupname, $emptygroupid);
+        print "Group $emptygroupid had an empty name; renamed as",
+              " '$trygroupname'.\n";
+    }
+}
+
+# A helper for the emailprefs subs below
+sub _clone_email_event {
+    my ($source, $target) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    $dbh->do("INSERT INTO email_setting (user_id, relationship, event)
+                   SELECT user_id, relationship, $target FROM email_setting
+                    WHERE event = $source");
+}
+
+sub _migrate_email_prefs_to_new_table {
+    my $dbh = Bugzilla->dbh;
+    # 2005-03-29 - gerv@gerv.net - bug 73665.
+    # Migrate email preferences to new email prefs table.
+    if ($dbh->bz_column_info("profiles", "emailflags")) {
+        print "Migrating email preferences to new table...\n";
+
+        # These are the "roles" and "reasons" from the original code, mapped to
+        # the new terminology of relationships and events.
+        my %relationships = ("Owner"     => REL_ASSIGNEE,
+                             "Reporter"  => REL_REPORTER,
+                             "QAcontact" => REL_QA,
+                             "CClist"    => REL_CC,
+                             # REL_VOTER was "4" before it was moved to an
+                             #  extension.
+                             "Voter"     => 4);
+
+        my %events = ("Removeme"    => EVT_ADDED_REMOVED,
+                      "Comments"    => EVT_COMMENT,
+                      "Attachments" => EVT_ATTACHMENT,
+                      "Status"      => EVT_PROJ_MANAGEMENT,
+                      "Resolved"    => EVT_OPENED_CLOSED,
+                      "Keywords"    => EVT_KEYWORD,
+                      "CC"          => EVT_CC,
+                      "Other"       => EVT_OTHER,
+                      "Unconfirmed" => EVT_UNCONFIRMED);
+
+        # Request preferences
+        my %requestprefs = ("FlagRequestee" => EVT_FLAG_REQUESTED,
+                            "FlagRequester" => EVT_REQUESTED_FLAG);
+
+        # We run the below code in a transaction to speed things up.
+        $dbh->bz_start_transaction();
+
+        # Select all emailflags flag strings
+        my $total = $dbh->selectrow_array('SELECT COUNT(*) FROM profiles');
+        my $sth = $dbh->prepare("SELECT userid, emailflags FROM profiles");
+        $sth->execute();
+        my $i = 0;
+
+        while (my ($userid, $flagstring) = $sth->fetchrow_array()) {
+            $i++;
+            indicate_progress({ total => $total, current => $i, every => 10 });
+            # If the user has never logged in since emailprefs arrived, and the
+            # temporary code to give them a default string never ran, then
+            # $flagstring will be null. In this case, they just get all mail.
+            $flagstring ||= "";
+
+            # The 255 param is here, because without a third param, split will
+            # trim any trailing null fields, which causes Perl to eject lots of
+            # warnings. Any suitably large number would do.
+            my %emailflags = split(/~/, $flagstring, 255);
+
+            my $sth2 = $dbh->prepare("INSERT into email_setting " .
+                                     "(user_id, relationship, event) VALUES (" .
+                                     "$userid, ?, ?)");
+            foreach my $relationship (keys %relationships) {
+                foreach my $event (keys %events) {
+                    my $key = "email$relationship$event";
+                    if (!exists($emailflags{$key}) 
+                        || $emailflags{$key} eq 'on') 
+                    {
+                        $sth2->execute($relationships{$relationship},
+                                       $events{$event});
+                    }
+                }
+            }
+            # Note that in the old system, the value of "excludeself" is 
+            # assumed to be off if the preference does not exist in the 
+            # user's list, unlike other preferences whose value is 
+            # assumed to be on if they do not exist.
+            #
+            # This preference has changed from global to per-relationship.
+            if (!exists($emailflags{'ExcludeSelf'})
+                || $emailflags{'ExcludeSelf'} ne 'on')
+            {
+                foreach my $relationship (keys %relationships) {
+                    $dbh->do("INSERT into email_setting " .
+                             "(user_id, relationship, event) VALUES (" .
+                             $userid . ", " .
+                             $relationships{$relationship}. ", " .
+                             EVT_CHANGED_BY_ME . ")");
+                }
+            }
+
+            foreach my $key (keys %requestprefs) {
+                if (!exists($emailflags{$key}) || $emailflags{$key} eq 'on') {
+                  $dbh->do("INSERT into email_setting " .
+                           "(user_id, relationship, event) VALUES (" .
+                           $userid . ", " . REL_ANY . ", " .
+                           $requestprefs{$key} . ")");
+                }
+            }
+        }
+        print "\n";
+
+        # EVT_ATTACHMENT_DATA should initially have identical settings to
+        # EVT_ATTACHMENT.
+        _clone_email_event(EVT_ATTACHMENT, EVT_ATTACHMENT_DATA);
+
+        $dbh->bz_commit_transaction();
+        $dbh->bz_drop_column("profiles", "emailflags");
+    }
+}
+
+sub _initialize_new_email_prefs {
+    my $dbh = Bugzilla->dbh;
+    # Check for any "new" email settings that wouldn't have been ported over
+    # during the block above.  Since these settings would have otherwise
+    # fallen under EVT_OTHER, we'll just clone those settings.  That way if
+    # folks have already disabled all of that mail, there won't be any change.
+    my %events = (
+        "Dependency Tree Changes" => EVT_DEPEND_BLOCK,
+        "Product/Component Changes" => EVT_COMPONENT,
+    );
+
+    foreach my $desc (keys %events) {
+        my $event = $events{$desc};
+        my $have_events = $dbh->selectrow_array(
+            "SELECT 1 FROM email_setting WHERE event = $event "
+            . $dbh->sql_limit(1));
+
+        if (!$have_events) {
+            # No settings in the table yet, so we assume that this is the
+            # first time it's being set.
+            print "Initializing \"$desc\" email_setting ...\n";
+            _clone_email_event(EVT_OTHER, $event);
+        }
+    }
+}
+
+sub _change_all_mysql_booleans_to_tinyint {
+    my $dbh = Bugzilla->dbh;
+    # 2005-03-27: Standardize all boolean fields to plain "tinyint"
+    if ( $dbh->isa('Bugzilla::DB::Mysql') ) {
+        # This is a change to make things consistent with Schema, so we use
+        # direct-database access methods.
+        my $quip_info_sth = $dbh->column_info(undef, undef, 'quips', '%');
+        my $quips_cols    = $quip_info_sth->fetchall_hashref("COLUMN_NAME");
+        my $approved_col  = $quips_cols->{'approved'};
+        if ( $approved_col->{TYPE_NAME} eq 'TINYINT'
+             and $approved_col->{COLUMN_SIZE} == 1 )
+        {
+            # series.public could have been renamed to series.is_public,
+            # and so wouldn't need to be fixed manually.
+            if ($dbh->bz_column_info('series', 'public')) {
+                $dbh->bz_alter_column_raw('series', 'public',
+                    {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => '0'});
+            }
+            $dbh->bz_alter_column_raw('bug_status', 'isactive',
+                {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => '1'});
+            $dbh->bz_alter_column_raw('rep_platform', 'isactive',
+                {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => '1'});
+            $dbh->bz_alter_column_raw('resolution', 'isactive',
+                {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => '1'});
+            $dbh->bz_alter_column_raw('op_sys', 'isactive',
+                {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => '1'});
+            $dbh->bz_alter_column_raw('bug_severity', 'isactive',
+                {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => '1'});
+            $dbh->bz_alter_column_raw('priority', 'isactive',
+                {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => '1'});
+            $dbh->bz_alter_column_raw('quips', 'approved',
+                {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => '1'});
+        }
+   }
+}
+
+# A helper for the below function.
+sub _de_dup_version {
+    my ($product_id, $version) = @_;
+    my $dbh = Bugzilla->dbh;
+    print "Fixing duplicate version $version in product_id $product_id...\n";
+    $dbh->do('DELETE FROM versions WHERE product_id = ? AND value = ?',
+             undef, $product_id, $version);
+    $dbh->do('INSERT INTO versions (product_id, value) VALUES (?,?)',
+             undef, $product_id, $version);
+}
+
+sub _add_versions_product_id_index {
+    my $dbh = Bugzilla->dbh;
+    if (!$dbh->bz_index_info('versions', 'versions_product_id_idx')) {
+        my $dup_versions = $dbh->selectall_arrayref(
+            'SELECT product_id, value FROM versions
+           GROUP BY product_id, value HAVING COUNT(value) > 1', {Slice=>{}});
+        foreach my $dup_version (@$dup_versions) {
+            _de_dup_version($dup_version->{product_id}, $dup_version->{value});
+        }
+
+        $dbh->bz_add_index('versions', 'versions_product_id_idx',
+            {TYPE => 'UNIQUE', FIELDS => [qw(product_id value)]});
+    }
+}
+
+sub _fix_whine_queries_title_and_op_sys_value {
+    my $dbh = Bugzilla->dbh;
+    if (!exists $dbh->bz_column_info('whine_queries', 'title')->{DEFAULT}) {
+        # The below change actually has nothing to do with the whine_queries
+        # change, it just has to be contained within a schema change so that
+        # it doesn't run every time we run checksetup.
+
+        # Old Bugzillas have "other" as an OS choice, new ones have "Other"
+        # (capital O).
+        print "Setting any 'other' op_sys to 'Other'...\n";
+        $dbh->do('UPDATE op_sys SET value = ? WHERE value = ?',
+                 undef, "Other", "other");
+        $dbh->do('UPDATE bugs SET op_sys = ? WHERE op_sys = ?',
+                 undef, "Other", "other");
+        if (Bugzilla->params->{'defaultopsys'} eq 'other') {
+            # We can't actually fix the param here, because WriteParams() will
+            # make $datadir/params unwriteable to the webservergroup.
+            # It's too much of an ugly hack to copy the permission-fixing code
+            # down to here. (It would create more potential future bugs than
+            # it would solve problems.)
+            print "WARNING: Your 'defaultopsys' param is set to 'other', but"
+                . " Bugzilla now\n"
+                . "         uses 'Other' (capital O).\n";
+        }
+
+        # Add a DEFAULT to whine_queries stuff so that editwhines.cgi
+        # works on PostgreSQL.
+        $dbh->bz_alter_column('whine_queries', 'title', {TYPE => 'varchar(128)',
+                              NOTNULL => 1, DEFAULT => "''"});
+    }
+}
+
+sub _fix_attachments_submitter_id_idx {
+    my $dbh = Bugzilla->dbh;
+    # 2005-06-29 bugreport@peshkin.net, bug 299156
+    if ($dbh->bz_index_info('attachments', 'attachments_submitter_id_idx')
+        && (scalar(@{$dbh->bz_index_info('attachments',
+                                         'attachments_submitter_id_idx'
+                                        )->{FIELDS}}) < 2)) 
+    {
+        $dbh->bz_drop_index('attachments', 'attachments_submitter_id_idx');
+    }
+    $dbh->bz_add_index('attachments', 'attachments_submitter_id_idx',
+                       [qw(submitter_id bug_id)]);
+}
+
+sub _copy_attachments_thedata_to_attach_data {
+    my $dbh = Bugzilla->dbh;
+    # 2005-08-25 - bugreport@peshkin.net - Bug 305333
+    if ($dbh->bz_column_info("attachments", "thedata")) {
+        print "Migrating attachment data to its own table...\n";
+        print "(This may take a very long time)\n";
+        $dbh->do("INSERT INTO attach_data (id, thedata)
+                       SELECT attach_id, thedata FROM attachments");
+        $dbh->bz_drop_column("attachments", "thedata");
+    }
+}
+
+sub _fix_broken_all_closed_series {
+    my $dbh = Bugzilla->dbh;
+
+    # 2005-11-26 - wurblzap@gmail.com - Bug 300473
+    # Repair broken automatically generated series queries for non-open bugs.
+    my $broken_series_indicator =
+        'field0-0-0=resolution&type0-0-0=notequals&value0-0-0=---';
+    my $broken_nonopen_series =
+        $dbh->selectall_arrayref("SELECT series_id, query FROM series
+                                 WHERE query LIKE '$broken_series_indicator%'");
+    if (@$broken_nonopen_series) {
+        print 'Repairing broken series...';
+        my $sth_nuke =
+            $dbh->prepare('DELETE FROM series_data WHERE series_id = ?');
+        # This statement is used to repair a series by replacing the broken
+        # query with the correct one.
+        my $sth_repair =
+            $dbh->prepare('UPDATE series SET query = ? WHERE series_id = ?');
+        # The corresponding series for open bugs look like one of these two
+        # variations (bug 225687 changed the order of bug states).
+        # This depends on the set of bug states representing open bugs not
+        # to have changed since series creation.
+        my $open_bugs_query_base_old =
+            join("&", map { "bug_status=" . url_quote($_) }
+                          ('UNCONFIRMED', 'NEW', 'ASSIGNED', 'REOPENED'));
+        my $open_bugs_query_base_new =
+            join("&", map { "bug_status=" . url_quote($_) }
+                          ('NEW', 'REOPENED', 'ASSIGNED', 'UNCONFIRMED'));
+        my $sth_openbugs_series =
+            $dbh->prepare("SELECT series_id FROM series WHERE query IN (?, ?)");
+        # Statement to find the series which has collected the most data.
+        my $sth_data_collected =
+            $dbh->prepare('SELECT count(*) FROM series_data 
+                            WHERE series_id = ?');
+        # Statement to select a broken non-open bugs count data entry.
+        my $sth_select_broken_nonopen_data =
+            $dbh->prepare('SELECT series_date, series_value FROM series_data' .
+                          ' WHERE series_id = ?');
+        # Statement to select an open bugs count data entry.
+        my $sth_select_open_data =
+            $dbh->prepare('SELECT series_value FROM series_data' .
+                          ' WHERE series_id = ? AND series_date = ?');
+        # Statement to fix a broken non-open bugs count data entry.
+        my $sth_fix_broken_nonopen_data =
+            $dbh->prepare('UPDATE series_data SET series_value = ?' .
+                          ' WHERE series_id = ? AND series_date = ?');
+        # Statement to delete an unfixable broken non-open bugs count data 
+        # entry.
+        my $sth_delete_broken_nonopen_data =
+            $dbh->prepare('DELETE FROM series_data' .
+                          ' WHERE series_id = ? AND series_date = ?');
+        foreach (@$broken_nonopen_series) {
+            my ($broken_series_id, $nonopen_bugs_query) = @$_;
+
+            # Determine the product-and-component part of the query.
+            if ($nonopen_bugs_query =~ /^$broken_series_indicator(.*)$/) {
+                my $prodcomp = $1;
+
+                # If there is more than one series for the corresponding 
+                # open-bugs series, we pick the one with the most data,
+                # which should be the one which was generated on creation.
+                # It's a pity we can't do subselects.
+                $sth_openbugs_series->execute(
+                    $open_bugs_query_base_old . $prodcomp,
+                    $open_bugs_query_base_new . $prodcomp);
+
+                my ($found_open_series_id, $datacount) = (undef, -1);
+                foreach my $open_ser_id ($sth_openbugs_series->fetchrow_array) {
+                    $sth_data_collected->execute($open_ser_id);
+                    my ($this_datacount) = $sth_data_collected->fetchrow_array;
+                    if ($this_datacount > $datacount) {
+                        $datacount = $this_datacount;
+                        $found_open_series_id = $open_ser_id;
+                    }
+                }
+
+                if ($found_open_series_id) {
+                    # Move along corrupted series data and correct it. The
+                    # corruption consists of it being the number of all bugs
+                    # instead of the number of non-open bugs, so we calculate
+                    # the correct count by subtracting the number of open bugs.
+                    # If there is no corresponding open-bugs count for some
+                    # reason (shouldn't happen), we drop the data entry.
+                    print " $broken_series_id...";
+                    $sth_select_broken_nonopen_data->execute($broken_series_id);
+                    while (my $rowref =
+                           $sth_select_broken_nonopen_data->fetchrow_arrayref) 
+                    {
+                        my ($date, $broken_value) = @$rowref;
+                        my ($openbugs_value) =
+                            $dbh->selectrow_array($sth_select_open_data, undef,
+                                                  $found_open_series_id, $date);
+                        if (defined($openbugs_value)) {
+                            $sth_fix_broken_nonopen_data->execute
+                                ($broken_value - $openbugs_value,
+                                 $broken_series_id, $date);
+                        }
+                        else {
+                            print <<EOT;
+
+WARNING - During repairs of series $broken_series_id, the irreparable data
+entry for date $date was encountered and is being deleted.
+
+Continuing repairs...
+EOT
+                            $sth_delete_broken_nonopen_data->execute
+                                ($broken_series_id, $date);
+                        }
+                    }
+
+                    # Fix the broken query so that it collects correct data 
+                    # in the future.
+                    $nonopen_bugs_query =~
+                        s/^$broken_series_indicator/field0-0-0=resolution&type0-0-0=regexp&value0-0-0=./;
+                    $sth_repair->execute($nonopen_bugs_query, 
+                                         $broken_series_id);
+                }
+                else {
+                    print <<EOT;
+
+WARNING - Series $broken_series_id was meant to collect non-open bug 
+counts, but it has counted all bugs instead. It cannot be repaired
+automatically because no series that collected open bug counts was found.
+You'll probably want to delete or repair collected data for 
+series $broken_series_id manually
+
+Continuing repairs...
+EOT
+                } #  if ($found_open_series_id)
+            } #  if ($nonopen_bugs_query =~
+        } # foreach (@$broken_nonopen_series)
+        print " done.\n";
+    } # if (@$broken_nonopen_series)
+}
+
+# This needs to happen at two times: when we upgrade from 2.16 (thus creating 
+# user_group_map), and when we kill derived gruops in the DB.
+sub _rederive_regex_groups {
+    my $dbh = Bugzilla->dbh;
+
+    my $regex_groups_exist = $dbh->selectrow_array(
+        "SELECT 1 FROM groups WHERE userregexp = '' " . $dbh->sql_limit(1));
+    return if !$regex_groups_exist;
+
+    my $regex_derivations = $dbh->selectrow_array(
+        'SELECT 1 FROM user_group_map WHERE grant_type = ' . GRANT_REGEXP 
+        . ' ' . $dbh->sql_limit(1));
+    return if $regex_derivations;
+
+    print "Deriving regex group memberships...\n";
+
+    # Re-evaluate all regexps, to keep them up-to-date.
+    my $sth = $dbh->prepare(
+        "SELECT profiles.userid, profiles.login_name, groups.id, 
+                groups.userregexp, user_group_map.group_id
+           FROM (profiles CROSS JOIN groups)
+                LEFT JOIN user_group_map
+                       ON user_group_map.user_id = profiles.userid
+                          AND user_group_map.group_id = groups.id
+                          AND user_group_map.grant_type = ?
+          WHERE userregexp != '' OR user_group_map.group_id IS NOT NULL");
+
+    my $sth_add = $dbh->prepare(
+        "INSERT INTO user_group_map (user_id, group_id, isbless, grant_type)
+              VALUES (?, ?, 0, " . GRANT_REGEXP . ")");
+
+    my $sth_del = $dbh->prepare(
+        "DELETE FROM user_group_map
+          WHERE user_id  = ? AND group_id = ? AND isbless = 0 
+                AND grant_type = " . GRANT_REGEXP);
+
+    $sth->execute(GRANT_REGEXP);
+    while (my ($uid, $login, $gid, $rexp, $present) = 
+               $sth->fetchrow_array()) 
+    {
+        if ($login =~ m/$rexp/i) {
+            $sth_add->execute($uid, $gid) unless $present;
+        } else {
+            $sth_del->execute($uid, $gid) if $present;
+        }
+    }
+}
+
+sub _clean_control_characters_from_short_desc {
+    my $dbh = Bugzilla->dbh;
+
+    # Fixup for Bug 101380
+    # "Newlines, nulls, leading/trailing spaces are getting into summaries"
+
+    my $controlchar_bugs =
+        $dbh->selectall_arrayref("SELECT short_desc, bug_id FROM bugs WHERE " .
+            $dbh->sql_regexp('short_desc', "'[[:cntrl:]]'"));
+    if (scalar(@$controlchar_bugs)) {
+        my $msg = 'Cleaning control characters from bug summaries...';
+        my $found = 0;
+        foreach (@$controlchar_bugs) {
+            my ($short_desc, $bug_id) = @$_;
+            my $clean_short_desc = clean_text($short_desc);
+            if ($clean_short_desc ne $short_desc) {
+                print $msg if !$found;
+                $found = 1;
+                print " $bug_id...";
+                $dbh->do("UPDATE bugs SET short_desc = ? WHERE bug_id = ?",
+                          undef, $clean_short_desc, $bug_id);
+            }
+        }
+        print " done.\n" if $found;
+    }
+}
+
+sub _stop_storing_inactive_flags {
+    my $dbh = Bugzilla->dbh;
+    # 2006-03-02 LpSolit@gmail.com - Bug 322285
+    # Do not store inactive flags in the DB anymore.
+    if ($dbh->bz_column_info('flags', 'id')->{'TYPE'} eq 'INT3') {
+        # We first have to remove all existing inactive flags.
+        if ($dbh->bz_column_info('flags', 'is_active')) {
+            $dbh->do('DELETE FROM flags WHERE is_active = 0');
+        }
+
+       # Now we convert the id column to the auto_increment format.
+        $dbh->bz_alter_column('flags', 'id',
+           {TYPE => 'MEDIUMSERIAL', NOTNULL => 1, PRIMARYKEY => 1});
+
+        # And finally, we remove the is_active column.
+        $dbh->bz_drop_column('flags', 'is_active');
+    }
+}
+
+sub _change_short_desc_from_mediumtext_to_varchar {
+    my $dbh = Bugzilla->dbh;
+    # short_desc should not be a mediumtext, fix anything longer than 255 chars.
+    if($dbh->bz_column_info('bugs', 'short_desc')->{TYPE} eq 'MEDIUMTEXT') {
+        # Move extremely long summaries into a comment ("from" the Reporter),
+        # and then truncate the summary.
+        my $long_summary_bugs = $dbh->selectall_arrayref(
+            'SELECT bug_id, short_desc, reporter
+               FROM bugs WHERE CHAR_LENGTH(short_desc) > 255');
+
+        if (@$long_summary_bugs) {
+            print "\n", install_string('update_summary_truncated');
+            my $comment_sth = $dbh->prepare(
+                'INSERT INTO longdescs (bug_id, who, thetext, bug_when)
+                      VALUES (?, ?, ?, NOW())');
+            my $desc_sth = $dbh->prepare('UPDATE bugs SET short_desc = ?
+                                           WHERE bug_id = ?');
+            my @affected_bugs;
+            foreach my $bug (@$long_summary_bugs) {
+                my ($bug_id, $summary, $reporter_id) = @$bug;
+                my $summary_comment =
+                    install_string('update_summary_truncate_comment',
+                                   { summary => $summary });
+                $comment_sth->execute($bug_id, $reporter_id, $summary_comment);
+                my $short_summary = substr($summary, 0, 252) . "...";
+                $desc_sth->execute($short_summary, $bug_id);
+                push(@affected_bugs, $bug_id);
+            }
+            print join(', ', @affected_bugs) . "\n\n";
+        }
+
+        $dbh->bz_alter_column('bugs', 'short_desc', {TYPE => 'varchar(255)',
+                                                     NOTNULL => 1});
+    }
+}
+
+sub _move_namedqueries_linkinfooter_to_its_own_table {
+    my $dbh = Bugzilla->dbh;
+    if ($dbh->bz_column_info("namedqueries", "linkinfooter")) {
+        # Move link-in-footer information into a table of its own.
+        my $sth_read = $dbh->prepare('SELECT id, userid
+                                        FROM namedqueries
+                                       WHERE linkinfooter = 1');
+        my $sth_write = $dbh->prepare('INSERT INTO namedqueries_link_in_footer
+                                       (namedquery_id, user_id) VALUES (?, ?)');
+        $sth_read->execute();
+        while (my ($id, $userid) = $sth_read->fetchrow_array()) {
+            $sth_write->execute($id, $userid);
+        }
+        $dbh->bz_drop_column("namedqueries", "linkinfooter");
+    }
+}
+
+sub _add_classifications_sortkey {
+    my $dbh = Bugzilla->dbh;
+    # 2006-07-07 olav@bkor.dhs.org - Bug 277377
+    # Add a sortkey to the classifications
+    if (!$dbh->bz_column_info('classifications', 'sortkey')) {
+        $dbh->bz_add_column('classifications', 'sortkey',
+                            {TYPE => 'INT2', NOTNULL => 1, DEFAULT => 0});
+
+        my $class_ids = $dbh->selectcol_arrayref(
+            'SELECT id FROM classifications ORDER BY name');
+        my $sth = $dbh->prepare('UPDATE classifications SET sortkey = ? ' .
+                                 'WHERE id = ?');
+        my $sortkey = 0;
+        foreach my $class_id (@$class_ids) {
+            $sth->execute($sortkey, $class_id);
+            $sortkey += 100;
+        }
+    }
+}
+
+sub _move_data_nomail_into_db {
+    my $dbh = Bugzilla->dbh;
+    my $datadir = bz_locations()->{'datadir'};
+    # 2006-07-14 karl@kornel.name - Bug 100953
+    # If a nomail file exists, move its contents into the DB
+    $dbh->bz_add_column('profiles', 'disable_mail',
+        { TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE' });
+    if (-e "$datadir/nomail") {
+        # We have a data/nomail file, read it in and delete it
+        my %nomail;
+        print "Found a data/nomail file.  Moving nomail entries into DB...\n";
+        my $nomail_file = new IO::File("$datadir/nomail", 'r');
+        while (<$nomail_file>) {
+            $nomail{trim($_)} = 1;
+        }
+        $nomail_file->close;
+
+        # Go through each entry read.  If a user exists, set disable_mail.
+        my $query = $dbh->prepare('UPDATE profiles
+                                      SET disable_mail = 1
+                                    WHERE userid = ?');
+        foreach my $user_to_check (keys %nomail) {
+            my $uid = $dbh->selectrow_array(
+                'SELECT userid FROM profiles WHERE login_name = ?',
+                undef, $user_to_check);
+            next if !$uid;
+            print "\tDisabling email for user $user_to_check\n";
+            $query->execute($uid);
+            delete $nomail{$user_to_check};
+        }
+
+        # If there are any nomail entries remaining, move them to nomail.bad
+        # and say something to the user.
+        if (scalar(keys %nomail)) {
+            print "\n", install_string('update_nomail_bad',
+                                       { data => $datadir }), "\n";
+            my $nomail_bad = new IO::File("$datadir/nomail.bad", '>>');
+            foreach my $unknown_user (keys %nomail) {
+                print "\t$unknown_user\n";
+                print $nomail_bad "$unknown_user\n";
+                delete $nomail{$unknown_user};
+            }
+            $nomail_bad->close;
+            print "\n";
+        }
+
+        # Now that we don't need it, get rid of the nomail file.
+        unlink "$datadir/nomail";
+    }
+}
+
+sub _update_longdescs_who_index {
+    my $dbh = Bugzilla->dbh;
+    # When doing a search on who posted a comment, longdescs is joined
+    # against the bugs table. So we need an index on both of these,
+    # not just on "who".
+    my $who_index = $dbh->bz_index_info('longdescs', 'longdescs_who_idx');
+    if (!$who_index || scalar @{$who_index->{FIELDS}} == 1) {
+        # If the index doesn't exist, this will harmlessly do nothing.
+        $dbh->bz_drop_index('longdescs', 'longdescs_who_idx');
+        $dbh->bz_add_index('longdescs', 'longdescs_who_idx', [qw(who bug_id)]);
+    }
+}
+
+sub _fix_uppercase_custom_field_names {
+    # Before the final release of 3.0, custom fields could be
+    # created with mixed-case names.
+    my $dbh = Bugzilla->dbh;
+    my $fields = $dbh->selectall_arrayref(
+        'SELECT name, type FROM fielddefs WHERE custom = 1');
+    foreach my $row (@$fields) {
+        my ($name, $type) = @$row;
+        if ($name ne lc($name)) {
+            $dbh->bz_rename_column('bugs', $name, lc($name));
+            $dbh->bz_rename_table($name, lc($name))
+                if $type == FIELD_TYPE_SINGLE_SELECT;
+            $dbh->do('UPDATE fielddefs SET name = ? WHERE name = ?',
+                     undef, lc($name), $name);
+        }
+    }
+}
+
+sub _fix_uppercase_index_names {
+    # We forgot to fix indexes in the above code.
+    my $dbh = Bugzilla->dbh;
+    my $fields = $dbh->selectcol_arrayref(
+        'SELECT name FROM fielddefs WHERE type = ? AND custom = 1',
+        undef, FIELD_TYPE_SINGLE_SELECT);
+    foreach my $field (@$fields) {
+        my $indexes = $dbh->bz_table_indexes($field);
+        foreach my $name (keys %$indexes) {
+            next if $name eq lc($name);
+            my $index = $indexes->{$name};
+            # Lowercase the name and everything in the definition.
+            my $new_name   = lc($name);
+            my @new_fields = map {lc($_)} @{$index->{FIELDS}};
+            my $new_def = {FIELDS => \@new_fields, TYPE => $index->{TYPE}};
+            $new_def = \@new_fields if !$index->{TYPE};
+            $dbh->bz_drop_index($field, $name);
+            $dbh->bz_add_index($field, $new_name, $new_def);
+        }
+    }
+}
+
+sub _initialize_workflow_for_upgrade {
+    my $old_params = shift;
+    my $dbh = Bugzilla->dbh;
+
+    $dbh->bz_add_column('bug_status', 'is_open',
+                        {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'TRUE'});
+
+    # Till now, bug statuses were not customizable. Nevertheless, local
+    # changes are possible and so we will try to respect these changes.
+    # This means: get the status of bugs having a resolution different from ''
+    # and mark these statuses as 'closed', even if some of these statuses are
+    # expected to be open statuses. Bug statuses we have no information about
+    # are left as 'open'.
+    #
+    # We append the default list of closed statuses *unless* we detect at least
+    # one closed state in the DB (i.e. with is_open = 0). This would mean that
+    # the DB has already been updated at least once and maybe the admin decided
+    # that e.g. 'RESOLVED' is now an open state, in which case we don't want to
+    # override this attribute. At least one bug status has to be a closed state
+    # anyway (due to the 'duplicate_or_move_bug_status' parameter) so it's safe
+    # to use this criteria.
+    my $num_closed_states = $dbh->selectrow_array('SELECT COUNT(*) FROM bug_status
+                                                   WHERE is_open = 0');
+
+    if (!$num_closed_states) {
+        my @closed_statuses =
+            @{$dbh->selectcol_arrayref('SELECT DISTINCT bug_status FROM bugs
+                                         WHERE resolution != ?', undef, '')};
+        @closed_statuses =
+          map {$dbh->quote($_)} (@closed_statuses, qw(RESOLVED VERIFIED CLOSED));
+
+        print "Marking closed bug statuses as such...\n";
+        $dbh->do('UPDATE bug_status SET is_open = 0 WHERE value IN (' .
+                  join(', ', @closed_statuses) . ')');
+    }
+
+    # We only populate the workflow here if we're upgrading from a version
+    # before 4.0 (which is where init_workflow was added). This was the
+    # first schema change done for 4.0, so we check this.
+    return if $dbh->bz_column_info('bugs_activity', 'comment_id');
+
+    # Populate the status_workflow table. We do nothing if the table already
+    # has entries. If all bug status transitions have been deleted, the
+    # workflow will be restored to its default schema.
+    my $count = $dbh->selectrow_array('SELECT COUNT(*) FROM status_workflow');
+
+    if (!$count) {
+        # Make sure the variables below are defined as
+        # status_workflow.require_comment cannot be NULL.
+        my $create = $old_params->{'commentoncreate'} || 0;
+        my $confirm = $old_params->{'commentonconfirm'} || 0;
+        my $accept = $old_params->{'commentonaccept'} || 0;
+        my $resolve = $old_params->{'commentonresolve'} || 0;
+        my $verify = $old_params->{'commentonverify'} || 0;
+        my $close = $old_params->{'commentonclose'} || 0;
+        my $reopen = $old_params->{'commentonreopen'} || 0;
+        # This was till recently the only way to get back to NEW for
+        # confirmed bugs, so we use this parameter here.
+        my $reassign = $old_params->{'commentonreassign'} || 0;
+
+        # This is the default workflow for upgrading installations.
+        my @workflow = ([undef, 'UNCONFIRMED', $create],
+                        [undef, 'NEW', $create],
+                        [undef, 'ASSIGNED', $create],
+                        ['UNCONFIRMED', 'NEW', $confirm],
+                        ['UNCONFIRMED', 'ASSIGNED', $accept],
+                        ['UNCONFIRMED', 'RESOLVED', $resolve],
+                        ['NEW', 'ASSIGNED', $accept],
+                        ['NEW', 'RESOLVED', $resolve],
+                        ['ASSIGNED', 'NEW', $reassign],
+                        ['ASSIGNED', 'RESOLVED', $resolve],
+                        ['REOPENED', 'NEW', $reassign],
+                        ['REOPENED', 'ASSIGNED', $accept],
+                        ['REOPENED', 'RESOLVED', $resolve],
+                        ['RESOLVED', 'UNCONFIRMED', $reopen],
+                        ['RESOLVED', 'REOPENED', $reopen],
+                        ['RESOLVED', 'VERIFIED', $verify],
+                        ['RESOLVED', 'CLOSED', $close],
+                        ['VERIFIED', 'UNCONFIRMED', $reopen],
+                        ['VERIFIED', 'REOPENED', $reopen],
+                        ['VERIFIED', 'CLOSED', $close],
+                        ['CLOSED', 'UNCONFIRMED', $reopen],
+                        ['CLOSED', 'REOPENED', $reopen]);
+
+        print "Now filling the 'status_workflow' table with valid bug status transitions...\n";
+        my $sth_select = $dbh->prepare('SELECT id FROM bug_status WHERE value = ?');
+        my $sth = $dbh->prepare('INSERT INTO status_workflow (old_status, new_status,
+                                             require_comment) VALUES (?, ?, ?)');
+
+        foreach my $transition (@workflow) {
+            my ($from, $to);
+            # If it's an initial state, there is no "old" value.
+            $from = $dbh->selectrow_array($sth_select, undef, $transition->[0])
+              if $transition->[0];
+            $to = $dbh->selectrow_array($sth_select, undef, $transition->[1]);
+            # If one of the bug statuses doesn't exist, the transition is invalid.
+            next if (($transition->[0] && !$from) || !$to);
+
+            $sth->execute($from, $to, $transition->[2] ? 1 : 0);
+        }
+    }
+
+    # Make sure the bug status used by the 'duplicate_or_move_bug_status'
+    # parameter has all the required transitions set.
+    my $dup_status = Bugzilla->params->{'duplicate_or_move_bug_status'};
+    my $status_id = $dbh->selectrow_array(
+        'SELECT id FROM bug_status WHERE value = ?', undef, $dup_status);
+    # There's a minor chance that this status isn't in the DB.
+    $status_id || return;
+
+    my $missing_statuses = $dbh->selectcol_arrayref(
+        'SELECT id FROM bug_status
+                        LEFT JOIN status_workflow ON old_status = id
+                                                     AND new_status = ?
+          WHERE old_status IS NULL', undef, $status_id);
+
+    my $sth = $dbh->prepare('INSERT INTO status_workflow
+                             (old_status, new_status) VALUES (?, ?)');
+
+    foreach my $old_status_id (@$missing_statuses) {
+        next if ($old_status_id == $status_id);
+        $sth->execute($old_status_id, $status_id);
+    }
+}
+
+sub _make_lang_setting_dynamic {
+    my $dbh = Bugzilla->dbh;
+    my $count = $dbh->selectrow_array(q{SELECT 1 FROM setting
+                                         WHERE name = 'lang'
+                                           AND subclass IS NULL});
+    if ($count) {
+        $dbh->do(q{UPDATE setting SET subclass = 'Lang' WHERE name = 'lang'});
+        $dbh->do(q{DELETE FROM setting_value WHERE name = 'lang'});
+    }
+}
+
+sub _fix_attachment_modification_date {
+    my $dbh = Bugzilla->dbh;
+    if (!$dbh->bz_column_info('attachments', 'modification_time')) {
+        # Allow NULL values till the modification time has been set.
+        $dbh->bz_add_column('attachments', 'modification_time', {TYPE => 'DATETIME'});
+
+        print "Setting the modification time for attachments...\n";
+        $dbh->do('UPDATE attachments SET modification_time = creation_ts');
+
+        # Now force values to be always defined.
+        $dbh->bz_alter_column('attachments', 'modification_time',
+                              {TYPE => 'DATETIME', NOTNULL => 1});
+
+        # Update the modification time for attachments which have been modified.
+        my $attachments =
+          $dbh->selectall_arrayref('SELECT attach_id, MAX(bug_when) FROM bugs_activity
+                                    WHERE attach_id IS NOT NULL ' .
+                                    $dbh->sql_group_by('attach_id'));
+
+        my $sth = $dbh->prepare('UPDATE attachments SET modification_time = ?
+                                 WHERE attach_id = ?');
+        $sth->execute($_->[1], $_->[0]) foreach (@$attachments);
+    }
+    # We add this here to be sure to have the index being added, due to the original
+    # patch omitting it.
+    $dbh->bz_add_index('attachments', 'attachments_modification_time_idx',
+                       [qw(modification_time)]);
+}
+
+sub _change_text_types {
+    my $dbh = Bugzilla->dbh; 
+    return if 
+        $dbh->bz_column_info('namedqueries', 'query')->{TYPE} eq 'LONGTEXT';
+    _check_content_length('attachments', 'mimetype',    255, 'attach_id');
+    _check_content_length('fielddefs',   'description', 255, 'id');
+    _check_content_length('attachments', 'description', 255, 'attach_id');
+
+    $dbh->bz_alter_column('bugs', 'bug_file_loc',
+        { TYPE => 'MEDIUMTEXT'});
+    $dbh->bz_alter_column('longdescs', 'thetext',
+        { TYPE => 'LONGTEXT', NOTNULL => 1 });
+    $dbh->bz_alter_column('attachments', 'description',
+        { TYPE => 'TINYTEXT', NOTNULL => 1 });
+    $dbh->bz_alter_column('attachments', 'mimetype',
+        { TYPE => 'TINYTEXT', NOTNULL => 1 });
+    # This also changes NULL to NOT NULL.
+    $dbh->bz_alter_column('flagtypes', 'description',
+        { TYPE => 'MEDIUMTEXT', NOTNULL => 1 }, '');
+    $dbh->bz_alter_column('fielddefs', 'description',
+        { TYPE => 'TINYTEXT', NOTNULL => 1 });
+    $dbh->bz_alter_column('groups', 'description',
+        { TYPE => 'MEDIUMTEXT', NOTNULL => 1 });
+    $dbh->bz_alter_column('namedqueries', 'query',
+        { TYPE => 'LONGTEXT', NOTNULL => 1 });
+
+} 
+
+sub _check_content_length {
+    my ($table_name, $field_name, $max_length, $id_field) = @_;
+    my $dbh = Bugzilla->dbh;
+    my %contents = @{ $dbh->selectcol_arrayref(
+        "SELECT $id_field, $field_name FROM $table_name 
+          WHERE CHAR_LENGTH($field_name) > ?", {Columns=>[1,2]}, $max_length) };
+
+    if (scalar keys %contents) {
+        my $error = install_string('install_data_too_long',
+                                   { column     => $field_name,
+                                     id_column  => $id_field,
+                                     table      => $table_name,
+                                     max_length => $max_length });
+        foreach my $id (keys %contents) {
+            my $string = $contents{$id};
+            # Don't dump the whole string--it could be 16MB.
+            if (length($string) > 80) {
+                $string = substr($string, 0, 30) . "..." 
+                         . substr($string, -30) . "\n";
+            }
+            $error .= "$id: $string\n";
+        }
+        die $error;
+    }
+}
+
+sub _add_foreign_keys_to_multiselects {
+    my $dbh = Bugzilla->dbh;
+
+    my $names = $dbh->selectcol_arrayref(
+        'SELECT name 
+           FROM fielddefs 
+          WHERE type = ' . FIELD_TYPE_MULTI_SELECT);
+
+    foreach my $name (@$names) {
+        $dbh->bz_add_fk("bug_$name", "bug_id", 
+            {TABLE => 'bugs', COLUMN => 'bug_id', DELETE => 'CASCADE'});
+                                                
+        $dbh->bz_add_fk("bug_$name", "value",
+            {TABLE  => $name, COLUMN => 'value', DELETE => 'RESTRICT'});
+    }
+}
+
+# This subroutine is used in multiple places (for times when we update
+# the text of comments), so it takes an argument, $bug_ids, which causes
+# it to update bugs_fulltext for those bug_ids instead of populating the
+# whole table.
+sub _populate_bugs_fulltext {
+    my $bug_ids = shift;
+    my $dbh = Bugzilla->dbh;
+    my $fulltext = $dbh->selectrow_array('SELECT 1 FROM bugs_fulltext '
+                                         . $dbh->sql_limit(1));
+    # We only populate the table if it's empty or if we've been given a
+    # set of bug ids.
+    if ($bug_ids or !$fulltext) {
+        $bug_ids ||= $dbh->selectcol_arrayref('SELECT bug_id FROM bugs');
+        # If there are no bugs in the bugs table, there's nothing to populate.
+        return if !@$bug_ids;
+        my $num_bugs = scalar @$bug_ids;
+
+        my $command = "INSERT";
+        my $where = "";
+        if ($fulltext) {
+            print "Updating bugs_fulltext for $num_bugs bugs...\n";
+            $where = "WHERE " . $dbh->sql_in('bugs.bug_id', $bug_ids);
+            # It turns out that doing a REPLACE INTO is up to 10x faster
+            # than any other possible method of updating the table, in MySQL,
+            # which matters a LOT for large installations.
+            if ($dbh->isa('Bugzilla::DB::Mysql')) {
+                $command = "REPLACE";
+            }
+            else {
+                $dbh->do("DELETE FROM bugs_fulltext WHERE " 
+                         . $dbh->sql_in('bug_id', $bug_ids));
+            }
+        }
+        else {
+            print "Populating bugs_fulltext with $num_bugs entries...";
+            print " (this can take a long time.)\n";
+        }
+        my $newline = $dbh->quote("\n");
+        $dbh->do(
+         qq{$command INTO bugs_fulltext (bug_id, short_desc, comments, 
+                                         comments_noprivate)
+                   SELECT bugs.bug_id, bugs.short_desc, }
+                 . $dbh->sql_group_concat('longdescs.thetext', $newline, 0)
+          . ', ' . $dbh->sql_group_concat('nopriv.thetext',    $newline, 0) .
+                 qq{ FROM bugs 
+                          LEFT JOIN longdescs
+                                 ON bugs.bug_id = longdescs.bug_id
+                          LEFT JOIN longdescs AS nopriv
+                                 ON longdescs.comment_id = nopriv.comment_id
+                                    AND nopriv.isprivate = 0 
+                     $where }
+                 . $dbh->sql_group_by('bugs.bug_id', 'bugs.short_desc'));
+    }
+}
+
+sub _fix_illegal_flag_modification_dates {
+    my $dbh = Bugzilla->dbh;
+
+    my $rows = $dbh->do('UPDATE flags SET modification_date = creation_date
+                         WHERE modification_date < creation_date');
+    # If no rows are affected, $dbh->do returns 0E0 instead of 0.
+    print "$rows flags had an illegal modification date. Fixed!\n" if ($rows =~ /^\d+$/);
+}
+
+sub _add_visiblity_value_to_value_tables {
+    my $dbh = Bugzilla->dbh;
+    my @standard_fields = 
+        qw(bug_status resolution priority bug_severity op_sys rep_platform);
+    my $custom_fields = $dbh->selectcol_arrayref(
+        'SELECT name FROM fielddefs WHERE custom = 1 AND type IN(?,?)',
+        undef, FIELD_TYPE_SINGLE_SELECT, FIELD_TYPE_MULTI_SELECT);
+    foreach my $field (@standard_fields, @$custom_fields) {
+        $dbh->bz_add_column($field, 'visibility_value_id', {TYPE => 'INT2'});
+        $dbh->bz_add_index($field, "${field}_visibility_value_id_idx",
+                           ['visibility_value_id']);
+    }
+}
+
+sub _add_extern_id_index {
+    my $dbh = Bugzilla->dbh;
+    if (!$dbh->bz_index_info('profiles', 'profiles_extern_id_idx')) {
+        # Some Bugzillas have a multiple empty strings in extern_id,
+        # which need to be converted to NULLs before we add the index.
+        $dbh->do("UPDATE profiles SET extern_id = NULL WHERE extern_id = ''");
+        $dbh->bz_add_index('profiles', 'profiles_extern_id_idx',
+                           {TYPE => 'UNIQUE', FIELDS => [qw(extern_id)]});
+    }
+}
+
+sub _convert_disallownew_to_isactive {
+    my $dbh = Bugzilla->dbh;
+    if ($dbh->bz_column_info('products', 'disallownew')){
+        $dbh->bz_add_column('products', 'isactive', 
+                            { TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'TRUE'});
+        
+        # isactive is the boolean reverse of disallownew.
+        $dbh->do('UPDATE products SET isactive = 0 WHERE disallownew = 1');
+        $dbh->do('UPDATE products SET isactive = 1 WHERE disallownew = 0');
+        
+        $dbh->bz_drop_column('products','disallownew');
+    }
+}
+
+sub _fix_logincookies_ipaddr {
+    my $dbh = Bugzilla->dbh;
+    return if !$dbh->bz_column_info('logincookies', 'ipaddr')->{NOTNULL};
+
+    $dbh->bz_alter_column('logincookies', 'ipaddr', {TYPE => 'varchar(40)'});
+    $dbh->do('UPDATE logincookies SET ipaddr = NULL WHERE ipaddr = ?',
+             undef, '0.0.0.0');
+}
+
+sub _fix_invalid_custom_field_names {
+    my $fields = Bugzilla->fields({ custom => 1 });
+
+    foreach my $field (@$fields) {
+        next if $field->name =~ /^[a-zA-Z0-9_]+$/;
+        # The field name is illegal and can break the DB. Kill the field!
+        $field->set_obsolete(1);
+        print install_string('update_cf_invalid_name',
+                             { field => $field->name }), "\n";
+        eval { $field->remove_from_db(); };
+        warn $@ if $@;
+    }
+}
+
+sub _set_attachment_comment_type {
+    my ($type, $string) = @_;
+    my $dbh = Bugzilla->dbh;
+    # We check if there are any comments of this type already, first, 
+    # because this is faster than a full LIKE search on the comments,
+    # and currently this will run every time we run checksetup.
+    my $test = $dbh->selectrow_array(
+        "SELECT 1 FROM longdescs WHERE type = $type " . $dbh->sql_limit(1));
+    return [] if $test;
+    my %comments = @{ $dbh->selectcol_arrayref(
+        "SELECT comment_id, thetext FROM longdescs
+          WHERE thetext LIKE '$string%'", 
+        {Columns=>[1,2]}) };
+    my @comment_ids = keys %comments;
+    return [] if !scalar @comment_ids;
+    my $what = "update";
+    if ($type == CMT_ATTACHMENT_CREATED) {
+        $what = "creation";
+    }
+    print "Setting the type field on attachment $what comments...\n";
+    my $sth = $dbh->prepare(
+        'UPDATE longdescs SET thetext = ?, type = ?, extra_data = ?
+          WHERE comment_id = ?');
+    my $count = 0;
+    my $total = scalar @comment_ids;
+    foreach my $id (@comment_ids) {
+        $count++;
+        my $text = $comments{$id};
+        next if $text !~ /^\Q$string\E(\d+)/;
+        my $attachment_id = $1;
+        my @lines = split("\n", $text);
+        if ($type == CMT_ATTACHMENT_CREATED) {
+            # Now we have to remove the text up until we find a line that's
+            # just a single newline, because the old "Created an attachment"
+            # text included the attachment description underneath it, and in
+            # Bugzillas before 2.20, that could be wrapped into multiple lines,
+            # in the database.
+            while (1) {
+                my $line = shift @lines;
+                last if (!defined $line or trim($line) eq '');
+            }
+        }
+        else {
+            # However, the "From update of attachment" line is always just
+            # one line--the first line of the comment.
+            shift @lines;
+        }
+        $text = join("\n", @lines);
+        $sth->execute($text, $type, $attachment_id, $id);
+        indicate_progress({ total => $total, current => $count, 
+                            every => 25 });
+    }
+    return \@comment_ids;
+}
+
+sub _set_attachment_comment_types {
+    my $dbh = Bugzilla->dbh;
+    $dbh->bz_start_transaction();
+    my $created_ids = _set_attachment_comment_type(
+        CMT_ATTACHMENT_CREATED, 'Created an attachment (id=');
+    my $updated_ids = _set_attachment_comment_type(
+        CMT_ATTACHMENT_UPDATED, '(From update of attachment ');
+    $dbh->bz_commit_transaction();
+    return unless (@$created_ids or @$updated_ids);
+
+    my @comment_ids = (@$created_ids, @$updated_ids);
+
+    my $bug_ids = $dbh->selectcol_arrayref(
+        'SELECT DISTINCT bug_id FROM longdescs WHERE '
+        . $dbh->sql_in('comment_id', \@comment_ids));
+    _populate_bugs_fulltext($bug_ids);
+}
+
+sub _add_allows_unconfirmed_to_product_table {
+    my $dbh = Bugzilla->dbh;
+    if (!$dbh->bz_column_info('products', 'allows_unconfirmed')) {
+        $dbh->bz_add_column('products', 'allows_unconfirmed',
+            { TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'FALSE' });
+        if ($dbh->bz_column_info('products', 'votestoconfirm')) {
+            $dbh->do('UPDATE products SET allows_unconfirmed = 1 
+                       WHERE votestoconfirm > 0');
+        }
+    }
+}
+
+sub _convert_flagtypes_fks_to_set_null {
+    my $dbh = Bugzilla->dbh;
+    foreach my $column (qw(request_group_id grant_group_id)) {
+        my $fk = $dbh->bz_fk_info('flagtypes', $column);
+        if ($fk and !defined $fk->{DELETE}) {
+            $fk->{DELETE} = 'SET NULL';
+            $dbh->bz_alter_fk('flagtypes', $column, $fk);
+        }
+    }
+}
+
+sub _fix_decimal_types {
+    my $dbh = Bugzilla->dbh;
+    my $type = {TYPE => 'decimal(7,2)', NOTNULL => 1, DEFAULT => '0'};
+    $dbh->bz_alter_column('bugs', 'estimated_time', $type);
+    $dbh->bz_alter_column('bugs', 'remaining_time', $type);
+    $dbh->bz_alter_column('longdescs', 'work_time', $type);
+}
+
+sub _fix_series_creator_fk {
+    my $dbh = Bugzilla->dbh;
+    my $fk = $dbh->bz_fk_info('series', 'creator');
+    if ($fk and $fk->{DELETE} eq 'SET NULL') {
+        $fk->{DELETE} = 'CASCADE';
+        $dbh->bz_alter_fk('series', 'creator', $fk);
+    }
+}
+
+sub _remove_attachment_isurl {
+    my $dbh = Bugzilla->dbh;
+
+    if ($dbh->bz_column_info('attachments', 'isurl')) {
+        # Now all attachments must have a filename.
+        $dbh->do('UPDATE attachments SET filename = ? WHERE isurl = 1',
+                 undef, 'url.txt');
+        $dbh->bz_drop_column('attachments', 'isurl');
+        $dbh->do("DELETE FROM fielddefs WHERE name='attachments.isurl'");
+    }
+}
+
+sub _add_isactive_to_product_fields {
+    my $dbh = Bugzilla->dbh;
+
+    # If we add the isactive column all values should start off as active
+    if (!$dbh->bz_column_info('components', 'isactive')) {
+        $dbh->bz_add_column('components', 'isactive', 
+            {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'TRUE'});
+    }
+    
+    if (!$dbh->bz_column_info('versions', 'isactive')) {
+        $dbh->bz_add_column('versions', 'isactive', 
+            {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'TRUE'});
+    }
+
+    if (!$dbh->bz_column_info('milestones', 'isactive')) {
+        $dbh->bz_add_column('milestones', 'isactive', 
+            {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'TRUE'});
+    }
+}
+
+sub _migrate_field_visibility_value {
+    my $dbh = Bugzilla->dbh;
+
+    if ($dbh->bz_column_info('fielddefs', 'visibility_value_id')) {
+        print "Populating new field_visibility table...\n";
+
+        $dbh->bz_start_transaction();
+
+        my %results =
+            @{ $dbh->selectcol_arrayref(
+                "SELECT id, visibility_value_id FROM fielddefs
+                 WHERE visibility_value_id IS NOT NULL",
+               { Columns => [1,2] }) };
+
+        my $insert_sth =
+            $dbh->prepare("INSERT INTO field_visibility (field_id, value_id)
+                           VALUES (?, ?)");
+
+        foreach my $id (keys %results) {
+            $insert_sth->execute($id, $results{$id});
+        }
+
+        $dbh->bz_commit_transaction();
+        $dbh->bz_drop_column('fielddefs', 'visibility_value_id');
+    }
+}
+
+sub _fix_series_indexes {
+    my $dbh = Bugzilla->dbh;
+    return if $dbh->bz_index_info('series', 'series_category_idx');
+
+    $dbh->bz_drop_index('series', 'series_creator_idx');
+
+    # Fix duplicated names under the same category/subcategory before
+    # adding the more restrictive index.
+    my $duplicated_series = $dbh->selectall_arrayref(
+         'SELECT s1.series_id, s1.category, s1.subcategory, s1.name
+            FROM series AS s1
+      INNER JOIN series AS s2
+              ON s1.category = s2.category
+             AND s1.subcategory = s2.subcategory
+             AND s1.name = s2.name
+           WHERE s1.series_id != s2.series_id');
+    my $sth_series_update = $dbh->prepare('UPDATE series SET name = ? WHERE series_id = ?');
+    my $sth_series_query = $dbh->prepare('SELECT 1 FROM series WHERE name = ?
+                                          AND category = ? AND subcategory = ?');
+
+    my %renamed_series;
+    foreach my $series (@$duplicated_series) {
+        my ($series_id, $category, $subcategory, $name) = @$series;
+        # Leave the first series alone, then rename duplicated ones.
+        if ($renamed_series{"${category}_${subcategory}_${name}"}++) {
+            print "Renaming series ${category}/${subcategory}/${name}...\n";
+            my $c = 0;
+            my $exists = 1;
+            while ($exists) {
+                $sth_series_query->execute($name . ++$c, $category, $subcategory);
+                $exists = $sth_series_query->fetchrow_array;
+            }
+            $sth_series_update->execute($name . $c, $series_id);
+        }
+    }
+
+    $dbh->bz_add_index('series', 'series_creator_idx', ['creator']);
+    $dbh->bz_add_index('series', 'series_category_idx',
+        {FIELDS => [qw(category subcategory name)], TYPE => 'UNIQUE'});
+}
+
+sub _migrate_user_tags {
+    my $dbh = Bugzilla->dbh;
+    return unless $dbh->bz_column_info('namedqueries', 'query_type');
+
+    my $tags = $dbh->selectall_arrayref('SELECT id, userid, name, query
+                                           FROM namedqueries
+                                          WHERE query_type != 0');
+
+    my $sth_tags = $dbh->prepare(
+        'INSERT INTO tag (user_id, name) VALUES (?, ?)');
+    my $sth_tag_id = $dbh->prepare(
+        'SELECT id FROM tag WHERE user_id = ? AND name = ?');
+    my $sth_bug_tag = $dbh->prepare('INSERT INTO bug_tag (bug_id, tag_id)
+                                     VALUES (?, ?)');
+    my $sth_nq = $dbh->prepare('UPDATE namedqueries SET query = ?
+                                WHERE id = ?');
+
+    if (scalar @$tags) {
+        print install_string('update_queries_to_tags'), "\n";
+    }
+
+    my $total = scalar(@$tags);
+    my $current = 0;
+
+    $dbh->bz_start_transaction();
+    foreach my $tag (@$tags) {
+        my ($query_id, $user_id, $name, $query) = @$tag;
+        # Tags are all lowercase.
+        my $tag_name = lc($name);
+
+        $sth_tags->execute($user_id, $tag_name);
+
+        my $tag_id = $dbh->selectrow_array($sth_tag_id,
+            undef, $user_id, $tag_name);
+
+        indicate_progress({ current => ++$current, total => $total,
+                            every => 25 });
+
+        my $uri = URI->new("buglist.cgi?$query", 'http');
+        my $bug_id_list = $uri->query_param_delete('bug_id');
+        if (!$bug_id_list) {
+            warn "No bug_id param for tag $name from user $user_id: $query";
+            next;
+        }
+        my @bug_ids = split(/[\s,]+/, $bug_id_list);
+        # Make sure that things like "001" get converted to "1"
+        @bug_ids = map { int($_) } @bug_ids;
+        # And remove duplicates
+        @bug_ids = uniq @bug_ids;
+        foreach my $bug_id (@bug_ids) {
+            # If "int" above failed this might be undef. We also
+            # don't want to accept bug 0.
+            next if !$bug_id;
+            $sth_bug_tag->execute($bug_id, $tag_id);
+        }
+
+        # Existing tags may be used in whines, or shared with
+        # other users. So we convert them rather than delete them.
+        $uri->query_param('tag', $tag_name);
+        $sth_nq->execute($uri->query, $query_id);
+    }
+
+    $dbh->bz_commit_transaction();
+
+    $dbh->bz_drop_column('namedqueries', 'query_type');
+}
+
+sub _populate_bug_see_also_class {
+    my $dbh = Bugzilla->dbh;
+
+    if ($dbh->bz_column_info('bug_see_also', 'class')) {
+        # The length was incorrectly set to 64 instead of 255.
+        $dbh->bz_alter_column('bug_see_also', 'class',
+                {TYPE => 'varchar(255)', NOTNULL => 1, DEFAULT => "''"});
+        return;
+    }
+
+    $dbh->bz_add_column('bug_see_also', 'class',
+        {TYPE => 'varchar(255)', NOTNULL => 1, DEFAULT => "''"}, '');
+
+    my $result = $dbh->selectall_arrayref(
+        "SELECT id, value FROM bug_see_also");
+
+    my $update_sth =
+        $dbh->prepare("UPDATE bug_see_also SET class = ? WHERE id = ?");
+    
+    $dbh->bz_start_transaction();
+    foreach my $see_also (@$result) {
+        my ($id, $value) = @$see_also;
+        my $class = Bugzilla::BugUrl->class_for($value);
+        $update_sth->execute($class, $id);
+    }
+    $dbh->bz_commit_transaction();
+}
+
+sub _migrate_disabledtext_boolean {
+    my $dbh = Bugzilla->dbh;
+    if (!$dbh->bz_column_info('profiles', 'is_enabled')) {
+        $dbh->bz_add_column("profiles", 'is_enabled',
+                            {TYPE => 'BOOLEAN', NOTNULL => 1, DEFAULT => 'TRUE'});
+        $dbh->do("UPDATE profiles SET is_enabled = 0 
+                  WHERE disabledtext != ''");
+    }
+}
+
+sub _rename_tags_to_tag {
+    my $dbh = Bugzilla->dbh;
+    if ($dbh->bz_table_info('tags')) {
+        # If we get here, it's because the schema created "tag" as an empty
+        # table while "tags" still exists. We get rid of the empty
+        # tag table so we can do the rename over the top of it.
+        $dbh->bz_drop_table('tag');
+        $dbh->bz_drop_index('tags', 'tags_user_id_idx');
+        $dbh->bz_rename_table('tags','tag');
+        $dbh->bz_add_index('tag', 'tag_user_id_idx',
+                           {FIELDS => [qw(user_id name)], TYPE => 'UNIQUE'});
+    }
+    if (my $bug_tag_fk = $dbh->bz_fk_info('bug_tag', 'tag_id')) {
+        # bz_rename_table() didn't handle FKs correctly.
+        if ($bug_tag_fk->{TABLE} eq 'tags') {
+            $bug_tag_fk->{TABLE} = 'tag';
+            $dbh->bz_alter_fk('bug_tag', 'tag_id', $bug_tag_fk);
+        }
+    }
+}
+
+sub _on_delete_set_null_for_audit_log_userid {
+    my $dbh = Bugzilla->dbh;
+    my $fk = $dbh->bz_fk_info('audit_log', 'user_id');
+    if ($fk and !defined $fk->{DELETE}) {
+        $fk->{DELETE} = 'SET NULL';
+        $dbh->bz_alter_fk('audit_log', 'user_id', $fk);
+    }
+}
+
+sub _fix_notnull_defaults {
+    my $dbh = Bugzilla->dbh;
+
+    $dbh->bz_alter_column('bugs', 'bug_file_loc', 
+                          {TYPE => 'MEDIUMTEXT', NOTNULL => 1,  
+                           DEFAULT => "''"}, '');
+
+    my $custom_fields = Bugzilla::Field->match({ 
+        custom => 1, type => [ FIELD_TYPE_FREETEXT, FIELD_TYPE_TEXTAREA ] 
+    });
+
+    foreach my $field (@$custom_fields) {
+        if ($field->type == FIELD_TYPE_FREETEXT) {
+            $dbh->bz_alter_column('bugs', $field->name,
+                                  {TYPE => 'varchar(255)', NOTNULL => 1,
+                                   DEFAULT => "''"}, '');
+        }
+        if ($field->type == FIELD_TYPE_TEXTAREA) {
+            $dbh->bz_alter_column('bugs', $field->name,
+                                  {TYPE => 'MEDIUMTEXT', NOTNULL => 1,
+                                   DEFAULT => "''"}, '');
+        }
+    }
+}
+
+sub _fix_longdescs_primary_key {
+    my $dbh = Bugzilla->dbh;
+    if ($dbh->bz_column_info('longdescs', 'comment_id')->{TYPE} ne 'INTSERIAL') {
+        $dbh->bz_drop_related_fks('longdescs', 'comment_id');
+        $dbh->bz_alter_column('bugs_activity', 'comment_id', {TYPE => 'INT4'});
+        $dbh->bz_alter_column('longdescs', 'comment_id',
+                              {TYPE => 'INTSERIAL',  NOTNULL => 1,  PRIMARYKEY => 1});
+    }
+}
+
+sub _fix_longdescs_indexes {
+    my $dbh = Bugzilla->dbh;
+    my $bug_id_idx = $dbh->bz_index_info('longdescs', 'longdescs_bug_id_idx');
+    if ($bug_id_idx && scalar @{$bug_id_idx->{'FIELDS'}} < 2) {
+        $dbh->bz_drop_index('longdescs', 'longdescs_bug_id_idx');
+        $dbh->bz_add_index('longdescs', 'longdescs_bug_id_idx', [qw(bug_id work_time)]);
+    }
+}
+
+sub _fix_dependencies_dupes {
+    my $dbh = Bugzilla->dbh;
+    my $blocked_idx = $dbh->bz_index_info('dependencies', 'dependencies_blocked_idx');
+    if ($blocked_idx && scalar @{$blocked_idx->{'FIELDS'}} < 2) {
+        # Remove duplicated entries
+        my $dupes = $dbh->selectall_arrayref("
+            SELECT blocked, dependson, COUNT(*) AS count
+              FROM dependencies " .
+            $dbh->sql_group_by('blocked, dependson') . "
+            HAVING COUNT(*) > 1",
+            { Slice => {} });
+        print "Removing duplicated entries from the 'dependencies' table...\n" if @$dupes;
+        foreach my $dupe (@$dupes) {
+            $dbh->do("DELETE FROM dependencies
+                      WHERE blocked = ? AND dependson = ?",
+                     undef, $dupe->{blocked}, $dupe->{dependson});
+            $dbh->do("INSERT INTO dependencies (blocked, dependson) VALUES (?, ?)",
+                     undef, $dupe->{blocked}, $dupe->{dependson});
+        }
+        $dbh->bz_drop_index('dependencies', 'dependencies_blocked_idx');
+        $dbh->bz_add_index('dependencies', 'dependencies_blocked_idx',
+                           { FIELDS => [qw(blocked dependson)], TYPE => 'UNIQUE' });
+    }   
+}
+
+sub _shorten_long_quips {
+    my $dbh = Bugzilla->dbh;
+    my $quips = $dbh->selectall_arrayref("SELECT quipid, quip FROM quips
+                                          WHERE CHAR_LENGTH(quip) > 512");
+
+    if (@$quips) {
+        print "Shortening quips longer than 512 characters:";
+
+        my $query = $dbh->prepare("UPDATE quips SET quip = ? WHERE quipid = ?");
+
+        foreach my $quip (@$quips) {
+            my ($quipid, $quip_str) = @$quip;
+            $quip_str = substr($quip_str, 0, 509) . "...";
+            print " $quipid";
+            $query->execute($quip_str, $quipid);
+        }
+        print "\n";
+    }
+    $dbh->bz_alter_column('quips', 'quip', { TYPE => 'varchar(512)', NOTNULL => 1});
+}
+
+sub _fix_flagclusions_indexes {
+    my $dbh = Bugzilla->dbh;
+    foreach my $table ('flaginclusions', 'flagexclusions') {
+        my $index = $table . '_type_id_idx';
+        my $idx_info = $dbh->bz_index_info($table, $index);
+        if ($idx_info && $idx_info->{'TYPE'} ne 'UNIQUE') {
+            # Remove duplicated entries
+            my $dupes = $dbh->selectall_arrayref("
+                SELECT type_id, product_id, component_id, COUNT(*) AS count
+                  FROM $table " .
+                $dbh->sql_group_by('type_id, product_id, component_id') . "
+                HAVING COUNT(*) > 1",
+                { Slice => {} });
+            say "Removing duplicated entries from the '$table' table..." if @$dupes;
+            foreach my $dupe (@$dupes) {
+                $dbh->do("DELETE FROM $table 
+                          WHERE type_id = ? AND product_id = ? AND component_id = ?",
+                         undef, $dupe->{type_id}, $dupe->{product_id}, $dupe->{component_id});
+                $dbh->do("INSERT INTO $table (type_id, product_id, component_id) VALUES (?, ?, ?)",
+                         undef, $dupe->{type_id}, $dupe->{product_id}, $dupe->{component_id});
+            }
+            $dbh->bz_drop_index($table, $index);
+            $dbh->bz_add_index($table, $index,
+                { FIELDS => [qw(type_id product_id component_id)],
+                  TYPE   => 'UNIQUE' });
+        }
+    }
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Install::DB - Fix up the database during installation.
+
+=head1 SYNOPSIS
+
+ use Bugzilla::Install::DB qw(indicate_progress);
+ Bugzilla::Install::DB::update_table_definitions();
+
+ indicate_progress({ total => $total, current => $count, every => 10 });
+
+=head1 DESCRIPTION
+
+This module is used primarily by L<checksetup.pl> to modify the 
+database during upgrades.
+
+=head1 SUBROUTINES
+
+=over
+
+=item C<update_table_definitions()>
+
+Description: This is the primary code that updates table definitions
+             during upgrades. If you modify the schema in some 
+             way, you should add code to the end of this function to 
+             make sure that your modifications happen over all installations.
+
+Params:      none
+
+Returns:     nothing
+
+=item C<update_fielddefs_definition()>
+
+Description: L<checksetup.pl> depends on the fielddefs table having
+             its schema adjusted before the rest of the tables. So
+             these schema updates happen in a separate function from
+             L</update_table_definitions()>.
+
+Params:      none
+
+Returns:     nothing
+
+=back

diff --git a/Bugzilla/Install/Filesystem.pm b/Bugzilla/Install/Filesystem.pm
new file mode 100644 (file)
index 0000000..cf61a6e
--- /dev/null
+++ b/Bugzilla/Install/Filesystem.pm
@@ -0,0 +1,870 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Install::Filesystem;
+
+# NOTE: This package may "use" any modules that it likes,
+# and localconfig is available. However, all functions in this
+# package should assume that:
+#
+# * Templates are not available.
+# * Files do not have the correct permissions.
+# * The database does not exist.
+
+use strict;
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Install::Localconfig;
+use Bugzilla::Install::Util qw(install_string);
+use Bugzilla::Util;
+use Bugzilla::Hook;
+
+use File::Find;
+use File::Path;
+use File::Basename;
+use File::Copy qw(move);
+use IO::File;
+use POSIX ();
+
+use base qw(Exporter);
+our @EXPORT = qw(
+    update_filesystem
+    create_htaccess
+    fix_all_file_permissions
+    fix_dir_permissions
+    fix_file_permissions
+);
+
+use constant HT_DEFAULT_DENY => <<EOT;
+# nothing in this directory is retrievable unless overridden by an .htaccess
+# in a subdirectory
+deny from all
+EOT
+
+###############
+# Permissions #
+###############
+
+# Used by the permissions "constants" below.
+sub _suexec { Bugzilla->localconfig->{'use_suexec'}     };
+sub _group  { Bugzilla->localconfig->{'webservergroup'} };
+
+# Writeable by the owner only.
+use constant OWNER_WRITE => 0600;
+# Executable by the owner only.
+use constant OWNER_EXECUTE => 0700;
+# A directory which is only writeable by the owner.
+use constant DIR_OWNER_WRITE => 0700;
+
+# A cgi script that the webserver can execute.
+sub WS_EXECUTE { _group() ? 0750 : 0755 };
+# A file that is read by cgi scripts, but is not ever read
+# directly by the webserver.
+sub CGI_READ { _group() ? 0640 : 0644 };
+# A file that is written to by cgi scripts, but is not ever
+# read or written directly by the webserver.
+sub CGI_WRITE { _group() ? 0660 : 0666 };
+# A file that is served directly by the web server.
+sub WS_SERVE { (_group() and !_suexec()) ? 0640 : 0644 };
+
+# A directory whose contents can be read or served by the
+# webserver (so even directories containing cgi scripts
+# would have this permission).
+sub DIR_WS_SERVE { (_group() and !_suexec()) ? 0750 : 0755 };
+# A directory that is read by cgi scripts, but is never accessed
+# directly by the webserver
+sub DIR_CGI_READ { _group() ? 0750 : 0755 };
+# A directory that is written to by cgi scripts, but where the
+# scripts never needs to overwrite files created by other
+# users.
+sub DIR_CGI_WRITE { _group() ? 0770 : 01777 };
+# A directory that is written to by cgi scripts, where the
+# scripts need to overwrite files created by other users.
+sub DIR_CGI_OVERWRITE { _group() ? 0770 : 0777 };
+
+# This can be combined (using "|") with other permissions for 
+# directories that, in addition to their normal permissions (such
+# as DIR_CGI_WRITE) also have content served directly from them
+# (or their subdirectories) to the user, via the webserver.
+sub DIR_ALSO_WS_SERVE { _suexec() ? 0001 : 0 };
+
+# This looks like a constant because it effectively is, but
+# it has to call other subroutines and read the current filesystem,
+# so it's defined as a sub. This is not exported, so it doesn't have
+# a perldoc. However, look at the various hashes defined inside this 
+# function to understand what it returns. (There are comments throughout.)
+#
+# The rationale for the file permissions is that there is a group the
+# web server executes the scripts as, so the cgi scripts should not be writable
+# by this group. Otherwise someone may find it possible to change the cgis
+# when exploiting some security flaw somewhere (not necessarily in Bugzilla!)
+sub FILESYSTEM {
+    my $datadir       = bz_locations()->{'datadir'};
+    my $attachdir     = bz_locations()->{'attachdir'};
+    my $extensionsdir = bz_locations()->{'extensionsdir'};
+    my $webdotdir     = bz_locations()->{'webdotdir'};
+    my $templatedir   = bz_locations()->{'templatedir'};
+    my $libdir        = bz_locations()->{'libpath'};
+    my $extlib        = bz_locations()->{'ext_libpath'};
+    my $skinsdir      = bz_locations()->{'skinsdir'};
+    my $localconfig   = bz_locations()->{'localconfig'};
+    my $template_cache = bz_locations()->{'template_cache'};
+    my $graphsdir     = bz_locations()->{'graphsdir'};
+
+    # We want to set the permissions the same for all localconfig files
+    # across all PROJECTs, so we do something special with $localconfig,
+    # lower down in the permissions section.
+    if ($ENV{PROJECT}) {
+        $localconfig =~ s/\.\Q$ENV{PROJECT}\E$//;
+    }
+
+    # Note: When being processed by checksetup, these have their permissions
+    # set in this order: %all_dirs, %recurse_dirs, %all_files.
+    #
+    # Each is processed in alphabetical order of keys, so shorter keys
+    # will have their permissions set before longer keys (thus setting
+    # the permissions on parent directories before setting permissions
+    # on their children).
+
+    # --- FILE PERMISSIONS (Non-created files) --- #
+    my %files = (
+        '*'               => { perms => OWNER_WRITE },
+        # Some .pl files are WS_EXECUTE because we want
+        # users to be able to cron them or otherwise run
+        # them as a secure user, like the webserver owner.
+        '*.cgi'           => { perms => WS_EXECUTE },
+        'whineatnews.pl'  => { perms => WS_EXECUTE },
+        'collectstats.pl' => { perms => WS_EXECUTE },
+        'importxml.pl'    => { perms => WS_EXECUTE },
+        'testserver.pl'   => { perms => WS_EXECUTE },
+        'whine.pl'        => { perms => WS_EXECUTE },
+        'email_in.pl'     => { perms => WS_EXECUTE },
+        'sanitycheck.pl'  => { perms => WS_EXECUTE },
+        'checksetup.pl'   => { perms => OWNER_EXECUTE },
+        'runtests.pl'     => { perms => OWNER_EXECUTE },
+        'jobqueue.pl'     => { perms => OWNER_EXECUTE },
+        'migrate.pl'      => { perms => OWNER_EXECUTE },
+        'install-module.pl' => { perms => OWNER_EXECUTE },
+
+        'Bugzilla.pm'   => { perms => CGI_READ },
+        "$localconfig*" => { perms => CGI_READ },
+        'bugzilla.dtd'  => { perms => WS_SERVE },
+        'mod_perl.pl'   => { perms => WS_SERVE },
+        'robots.txt'    => { perms => WS_SERVE },
+        '.htaccess'     => { perms => WS_SERVE },
+
+        'contrib/README'       => { perms => OWNER_WRITE },
+        'contrib/*/README'     => { perms => OWNER_WRITE },
+        'contrib/Bugzilla.pm'  => { perms => OWNER_WRITE },
+        'docs/bugzilla.ent'    => { perms => OWNER_WRITE },
+        'docs/makedocs.pl'     => { perms => OWNER_EXECUTE },
+        'docs/style.css'       => { perms => WS_SERVE },
+        'docs/*/rel_notes.txt' => { perms => WS_SERVE },
+        'docs/*/README.docs'   => { perms => OWNER_WRITE },
+        "$datadir/params"      => { perms => CGI_WRITE },
+        "$datadir/old-params.txt"  => { perms => OWNER_WRITE },
+        "$extensionsdir/create.pl" => { perms => OWNER_EXECUTE },
+        "$extensionsdir/*/*.pl"    => { perms => WS_EXECUTE },
+    );
+
+    # Directories that we want to set the perms on, but not
+    # recurse through. These are directories we didn't create
+    # in checkesetup.pl.
+    my %non_recurse_dirs = (
+        '.'  => DIR_WS_SERVE,
+        docs => DIR_WS_SERVE,
+    );
+
+    # This sets the permissions for each item inside each of these 
+    # directories, including the directory itself. 
+    # 'CVS' directories are special, though, and are never readable by 
+    # the webserver.
+    my %recurse_dirs = (
+        # Writeable directories
+         $template_cache    => { files => CGI_READ,
+                                  dirs => DIR_CGI_OVERWRITE },
+         $attachdir         => { files => CGI_WRITE,
+                                  dirs => DIR_CGI_WRITE },
+         $webdotdir         => { files => WS_SERVE,
+                                  dirs => DIR_CGI_WRITE | DIR_ALSO_WS_SERVE },
+         $graphsdir         => { files => WS_SERVE,
+                                  dirs => DIR_CGI_WRITE | DIR_ALSO_WS_SERVE },
+         "$datadir/db"      => { files => CGI_WRITE,
+                                  dirs => DIR_CGI_WRITE },
+
+         # Readable directories
+         "$datadir/mining"     => { files => CGI_READ,
+                                     dirs => DIR_CGI_READ },
+         "$libdir/Bugzilla"    => { files => CGI_READ,
+                                     dirs => DIR_CGI_READ },
+         $extlib               => { files => CGI_READ,
+                                     dirs => DIR_CGI_READ },
+         $templatedir          => { files => CGI_READ,
+                                     dirs => DIR_CGI_READ },
+         # Directories in the extensions/ dir are WS_SERVE so that
+         # the web/ directories can be served by the web server.
+         # But, for extra security, we deny direct webserver access to
+         # the lib/ and template/ directories of extensions.
+         $extensionsdir        => { files => CGI_READ,
+                                     dirs => DIR_WS_SERVE },
+         "$extensionsdir/*/lib" => { files => CGI_READ,
+                                      dirs => DIR_CGI_READ },
+         "$extensionsdir/*/template" => { files => CGI_READ,
+                                           dirs => DIR_CGI_READ },
+
+         # Content served directly by the webserver
+         images                => { files => WS_SERVE,
+                                     dirs => DIR_WS_SERVE },
+         js                    => { files => WS_SERVE,
+                                     dirs => DIR_WS_SERVE },
+         $skinsdir             => { files => WS_SERVE,
+                                     dirs => DIR_WS_SERVE },
+         'docs/*/html'         => { files => WS_SERVE,
+                                     dirs => DIR_WS_SERVE },
+         'docs/*/pdf'          => { files => WS_SERVE,
+                                     dirs => DIR_WS_SERVE },
+         'docs/*/txt'          => { files => WS_SERVE,
+                                     dirs => DIR_WS_SERVE },
+         'docs/*/images'       => { files => WS_SERVE,
+                                     dirs => DIR_WS_SERVE },
+         "$extensionsdir/*/web" => { files => WS_SERVE,
+                                     dirs => DIR_WS_SERVE },
+
+         # Directories only for the owner, not for the webserver.
+         '.bzr'                => { files => OWNER_WRITE,
+                                    dirs  => DIR_OWNER_WRITE },
+         t                     => { files => OWNER_WRITE,
+                                     dirs => DIR_OWNER_WRITE },
+         xt                    => { files => OWNER_WRITE,
+                                     dirs => DIR_OWNER_WRITE },
+         'docs/lib'            => { files => OWNER_WRITE,
+                                     dirs => DIR_OWNER_WRITE },
+         'docs/*/xml'          => { files => OWNER_WRITE,
+                                     dirs => DIR_OWNER_WRITE },
+         'contrib'             => { files => OWNER_EXECUTE,
+                                     dirs => DIR_OWNER_WRITE, },
+    );
+
+    # --- FILES TO CREATE --- #
+
+    # The name of each directory that we should actually *create*,
+    # pointing at its default permissions.
+    my %create_dirs = (
+        # This is DIR_ALSO_WS_SERVE because it contains $webdotdir.
+        $datadir                => DIR_CGI_OVERWRITE | DIR_ALSO_WS_SERVE,
+        # Directories that are read-only for cgi scripts
+        "$datadir/mining"       => DIR_CGI_READ,
+        "$datadir/extensions"   => DIR_CGI_READ,
+        $extensionsdir          => DIR_CGI_READ,
+        # Directories that cgi scripts can write to.
+        "$datadir/db"           => DIR_CGI_WRITE,
+        $attachdir              => DIR_CGI_WRITE,
+        $graphsdir              => DIR_CGI_WRITE | DIR_ALSO_WS_SERVE,
+        $webdotdir              => DIR_CGI_WRITE | DIR_ALSO_WS_SERVE,
+        # Directories that contain content served directly by the web server.
+        "$skinsdir/custom"      => DIR_WS_SERVE,
+        "$skinsdir/contrib"     => DIR_WS_SERVE,
+    );
+
+    # The name of each file, pointing at its default permissions and
+    # default contents.
+    my %create_files = (
+        "$datadir/extensions/additional" => { perms    => CGI_READ, 
+                                              contents => '' },
+        # We create this file so that it always has the right owner
+        # and permissions. Otherwise, the webserver creates it as
+        # owned by itself, which can cause problems if jobqueue.pl
+        # or something else is not running as the webserver or root.
+        "$datadir/mailer.testfile" => { perms    => CGI_WRITE,
+                                        contents => '' },
+    );
+
+    # Because checksetup controls the creation of index.html separately
+    # from all other files, it gets its very own hash.
+    my %index_html = (
+        'index.html' => { perms => WS_SERVE, contents => <<EOT
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+  <meta http-equiv="Refresh" content="0; URL=index.cgi">
+</head>
+<body>
+  <h1>I think you are looking for <a href="index.cgi">index.cgi</a></h1>
+</body>
+</html>
+EOT
+        }
+    );
+
+    # Because checksetup controls the .htaccess creation separately
+    # by a localconfig variable, these go in a separate variable from
+    # %create_files.
+    #
+    # Note that these get WS_SERVE as their permission
+    # because they're *read* by the webserver, even though they're not
+    # actually, themselves, served.
+    my %htaccess = (
+        "$attachdir/.htaccess"       => { perms    => WS_SERVE,
+                                          contents => HT_DEFAULT_DENY },
+        "$libdir/Bugzilla/.htaccess" => { perms    => WS_SERVE,
+                                          contents => HT_DEFAULT_DENY },
+        "$extlib/.htaccess"          => { perms    => WS_SERVE,
+                                          contents => HT_DEFAULT_DENY },
+        "$templatedir/.htaccess"     => { perms    => WS_SERVE,
+                                          contents => HT_DEFAULT_DENY },
+        'contrib/.htaccess'          => { perms    => WS_SERVE,
+                                          contents => HT_DEFAULT_DENY },
+        't/.htaccess'                => { perms    => WS_SERVE,
+                                          contents => HT_DEFAULT_DENY },
+        'xt/.htaccess'               => { perms    => WS_SERVE,
+                                          contents => HT_DEFAULT_DENY },
+        "$datadir/.htaccess"         => { perms    => WS_SERVE,
+                                          contents => HT_DEFAULT_DENY },
+
+        "$graphsdir/.htaccess" => { perms => WS_SERVE, contents => <<EOT
+# Allow access to .png and .gif files.
+<FilesMatch (\\.gif|\\.png)\$>
+  Allow from all
+</FilesMatch>
+
+# And no directory listings, either.
+Deny from all
+EOT
+        },
+
+        "$webdotdir/.htaccess" => { perms => WS_SERVE, contents => <<EOT
+# Restrict access to .dot files to the public webdot server at research.att.com
+# if research.att.com ever changes their IP, or if you use a different
+# webdot server, you'll need to edit this
+<FilesMatch \\.dot\$>
+  Allow from 192.20.225.0/24
+  Deny from all
+</FilesMatch>
+
+# Allow access to .png files created by a local copy of 'dot'
+<FilesMatch \\.png\$>
+  Allow from all
+</FilesMatch>
+
+# And no directory listings, either.
+Deny from all
+EOT
+        },
+    );
+
+    Bugzilla::Hook::process('install_filesystem', {
+        files            => \%files,
+        create_dirs      => \%create_dirs,
+        non_recurse_dirs => \%non_recurse_dirs,
+        recurse_dirs     => \%recurse_dirs,
+        create_files     => \%create_files,
+        htaccess         => \%htaccess,
+    });
+
+    my %all_files = (%create_files, %htaccess, %index_html, %files);
+    my %all_dirs  = (%create_dirs, %non_recurse_dirs);
+
+    return {
+        create_dirs  => \%create_dirs,
+        recurse_dirs => \%recurse_dirs,
+        all_dirs     => \%all_dirs,
+
+        create_files => \%create_files,
+        htaccess     => \%htaccess,
+        index_html   => \%index_html,
+        all_files    => \%all_files,
+    };
+}
+
+sub update_filesystem {
+    my ($params) = @_;
+    my $fs = FILESYSTEM();
+    my %dirs  = %{$fs->{create_dirs}};
+    my %files = %{$fs->{create_files}};
+
+    my $datadir = bz_locations->{'datadir'};
+    my $graphsdir = bz_locations->{'graphsdir'};
+    # If the graphs/ directory doesn't exist, we're upgrading from
+    # a version old enough that we need to update the $datadir/mining 
+    # format.
+    if (-d "$datadir/mining" && !-d $graphsdir) {
+        _update_old_charts($datadir);
+    }
+
+    # By sorting the dirs, we assure that shorter-named directories
+    # (meaning parent directories) are always created before their
+    # child directories.
+    foreach my $dir (sort keys %dirs) {
+        unless (-d $dir) {
+            print "Creating $dir directory...\n";
+            mkdir $dir or die "mkdir $dir failed: $!";
+            # For some reason, passing in the permissions to "mkdir"
+            # doesn't work right, but doing a "chmod" does.
+            chmod $dirs{$dir}, $dir or warn "Cannot chmod $dir: $!";
+        }
+    }
+
+    # Move the testfile if we can't write to it, so that we can re-create
+    # it with the correct permissions below.
+    my $testfile = "$datadir/mailer.testfile";
+    if (-e $testfile and !-w $testfile) {
+        _rename_file($testfile, "$testfile.old");
+    }
+
+    # If old-params.txt exists in the root directory, move it to datadir.
+    my $oldparamsfile = "old_params.txt";
+    if (-e $oldparamsfile) {
+        _rename_file($oldparamsfile, "$datadir/$oldparamsfile");
+    }
+
+    _create_files(%files);
+    if ($params->{index_html}) {
+        _create_files(%{$fs->{index_html}});
+    }
+    elsif (-e 'index.html') {
+        my $templatedir = bz_locations()->{'templatedir'};
+        print <<EOT;
+
+*** It appears that you still have an old index.html hanging around.
+    Either the contents of this file should be moved into a template and 
+    placed in the '$templatedir/en/custom' directory, or you should delete 
+    the file.
+
+EOT
+    }
+
+    # Delete old files that no longer need to exist
+
+    # 2001-04-29 jake@bugzilla.org - Remove oldemailtech
+    #   http://bugzilla.mozilla.org/show_bugs.cgi?id=71552
+    if (-d 'shadow') {
+        print "Removing shadow directory...\n";
+        rmtree("shadow");
+    }
+
+    if (-e "$datadir/versioncache") {
+        print "Removing versioncache...\n";
+        unlink "$datadir/versioncache";
+    }
+
+    if (-e "$datadir/duplicates.rdf") {
+        print "Removing duplicates.rdf...\n";
+        unlink "$datadir/duplicates.rdf";
+        unlink "$datadir/duplicates-old.rdf";
+    }
+
+    if (-e "$datadir/duplicates") {
+        print "Removing duplicates directory...\n";
+        rmtree("$datadir/duplicates");
+    }
+
+    _remove_empty_css_files();
+    _convert_single_file_skins();
+}
+
+sub _remove_empty_css_files {
+    my $skinsdir = bz_locations()->{'skinsdir'};
+    foreach my $css_file (glob("$skinsdir/custom/*.css"),
+                          glob("$skinsdir/contrib/*/*.css"))
+    {
+        _remove_empty_css($css_file);
+    }
+}
+
+# A simple helper for the update code that removes "empty" CSS files.
+sub _remove_empty_css {
+    my ($file) = @_;
+    my $basename = basename($file);
+    my $empty_contents = <<EOT;
+/*
+ * Custom rules for $basename.
+ * The rules you put here override rules in that stylesheet.
+ */
+EOT
+    if (length($empty_contents) == -s $file) {
+        open(my $fh, '<', $file) or warn "$file: $!";
+        my $file_contents;
+        { local $/; $file_contents = <$fh>; }
+        if ($file_contents eq $empty_contents) {
+            print install_string('file_remove', { name => $file }), "\n";
+            unlink $file or warn "$file: $!";
+        }
+    };
+}
+
+# We used to allow a single css file in the skins/contrib/ directory
+# to be a whole skin.
+sub _convert_single_file_skins {
+    my $skinsdir = bz_locations()->{'skinsdir'};
+    foreach my $skin_file (glob "$skinsdir/contrib/*.css") {
+        my $dir_name = $skin_file;
+        $dir_name =~ s/\.css$//;
+        mkdir $dir_name or warn "$dir_name: $!";
+        _rename_file($skin_file, "$dir_name/global.css");
+    }
+}
+
+sub create_htaccess {
+    _create_files(%{FILESYSTEM()->{htaccess}});
+
+    # Repair old .htaccess files
+
+    my $webdot_dir = bz_locations()->{'webdotdir'};
+    # The public webdot IP address changed.
+    my $webdot = new IO::File("$webdot_dir/.htaccess", 'r')
+        || die "$webdot_dir/.htaccess: $!";
+    my $webdot_data;
+    { local $/; $webdot_data = <$webdot>; }
+    $webdot->close;
+    if ($webdot_data =~ /192\.20\.225\.10/) {
+        print "Repairing $webdot_dir/.htaccess...\n";
+        $webdot_data =~ s/192\.20\.225\.10/192.20.225.0\/24/g;
+        $webdot = new IO::File("$webdot_dir/.htaccess", 'w') || die $!;
+        print $webdot $webdot_data;
+        $webdot->close;
+    }
+}
+
+sub _rename_file {
+    my ($from, $to) = @_;
+    print install_string('file_rename', { from => $from, to => $to }), "\n";
+    if (-e $to) {
+        warn "$to already exists, not moving\n";
+    }
+    else {
+        move($from, $to) or warn $!;
+    }
+}
+
+# A helper for the above functions.
+sub _create_files {
+    my (%files) = @_;
+
+    # It's not necessary to sort these, but it does make the
+    # output of checksetup.pl look a bit nicer.
+    foreach my $file (sort keys %files) {
+        unless (-e $file) {
+            print "Creating $file...\n";
+            my $info = $files{$file};
+            my $fh = new IO::File($file, O_WRONLY | O_CREAT, $info->{perms})
+                || die $!;
+            print $fh $info->{contents} if $info->{contents};
+            $fh->close;
+        }
+    }
+}
+
+# If you ran a REALLY old version of Bugzilla, your chart files are in the
+# wrong format. This code is a little messy, because it's very old, and
+# when moving it into this module, I couldn't test it so I left it almost 
+# completely alone.
+sub _update_old_charts {
+    my ($datadir) = @_;
+    print "Updating old chart storage format...\n";
+    foreach my $in_file (glob("$datadir/mining/*")) {
+        # Don't try and upgrade image or db files!
+        next if (($in_file =~ /\.gif$/i) ||
+                 ($in_file =~ /\.png$/i) ||
+                 ($in_file =~ /\.db$/i) ||
+                 ($in_file =~ /\.orig$/i));
+
+        rename("$in_file", "$in_file.orig") or next;
+        open(IN, "$in_file.orig") or next;
+        open(OUT, '>', $in_file) or next;
+
+        # Fields in the header
+        my @declared_fields;
+
+        # Fields we changed to half way through by mistake
+        # This list comes from an old version of collectstats.pl
+        # This part is only for people who ran later versions of 2.11 (devel)
+        my @intermediate_fields = qw(DATE UNCONFIRMED NEW ASSIGNED REOPENED
+                                     RESOLVED VERIFIED CLOSED);
+
+        # Fields we actually want (matches the current collectstats.pl)
+        my @out_fields = qw(DATE NEW ASSIGNED REOPENED UNCONFIRMED RESOLVED
+                            VERIFIED CLOSED FIXED INVALID WONTFIX LATER REMIND
+                            DUPLICATE WORKSFORME MOVED);
+
+         while (<IN>) {
+            if (/^# fields?: (.*)\s$/) {
+                @declared_fields = map uc, (split /\||\r/, $1);
+                print OUT "# fields: ", join('|', @out_fields), "\n";
+            }
+            elsif (/^(\d+\|.*)/) {
+                my @data = split(/\||\r/, $1);
+                my %data;
+                if (@data == @declared_fields) {
+                    # old format
+                    for my $i (0 .. $#declared_fields) {
+                        $data{$declared_fields[$i]} = $data[$i];
+                    }
+                }
+                elsif (@data == @intermediate_fields) {
+                    # Must have changed over at this point
+                    for my $i (0 .. $#intermediate_fields) {
+                        $data{$intermediate_fields[$i]} = $data[$i];
+                    }
+                }
+                elsif (@data == @out_fields) {
+                    # This line's fine - it has the right number of entries
+                    for my $i (0 .. $#out_fields) {
+                        $data{$out_fields[$i]} = $data[$i];
+                    }
+                }
+                else {
+                    print "Oh dear, input line $. of $in_file had " .
+                          scalar(@data) . " fields\nThis was unexpected.",
+                          " You may want to check your data files.\n";
+                }
+
+                print OUT join('|', 
+                    map { defined ($data{$_}) ? ($data{$_}) : "" } @out_fields),
+                    "\n";
+            }
+            else {
+                print OUT;
+            }
+        }
+
+        close(IN);
+        close(OUT);
+    } 
+}
+
+sub fix_dir_permissions {
+    my ($dir) = @_;
+    return if ON_WINDOWS;
+    # Note that _get_owner_and_group is always silent here.
+    my ($owner_id, $group_id) = _get_owner_and_group();
+
+    my $perms;
+    my $fs = FILESYSTEM();
+    if ($perms = $fs->{recurse_dirs}->{$dir}) {
+        _fix_perms_recursively($dir, $owner_id, $group_id, $perms);
+    }
+    elsif ($perms = $fs->{all_dirs}->{$dir}) {
+        _fix_perms($dir, $owner_id, $group_id, $perms);
+    }
+    else {
+        # Do nothing. We know nothing about this directory.
+        warn "Unknown directory $dir";
+    }
+}
+
+sub fix_file_permissions {
+    my ($file) = @_;
+    return if ON_WINDOWS;
+    my $perms = FILESYSTEM()->{all_files}->{$file}->{perms};
+    # Note that _get_owner_and_group is always silent here.
+    my ($owner_id, $group_id) = _get_owner_and_group();
+    _fix_perms($file, $owner_id, $group_id, $perms);
+}
+
+sub fix_all_file_permissions {
+    my ($output) = @_;
+
+    # _get_owner_and_group also checks that the webservergroup is valid.
+    my ($owner_id, $group_id) = _get_owner_and_group($output);
+
+    return if ON_WINDOWS;
+
+    my $fs = FILESYSTEM();
+    my %files = %{$fs->{all_files}};
+    my %dirs  = %{$fs->{all_dirs}};
+    my %recurse_dirs = %{$fs->{recurse_dirs}};
+
+    print get_text('install_file_perms_fix') . "\n" if $output;
+
+    foreach my $dir (sort keys %dirs) {
+        next unless -d $dir;
+        _fix_perms($dir, $owner_id, $group_id, $dirs{$dir});
+    }
+
+    foreach my $pattern (sort keys %recurse_dirs) {
+        my $perms = $recurse_dirs{$pattern};
+        # %recurse_dirs supports globs
+        foreach my $dir (glob $pattern) {
+            next unless -d $dir;
+            _fix_perms_recursively($dir, $owner_id, $group_id, $perms);
+        }
+    }
+
+    foreach my $file (sort keys %files) {
+        # %files supports globs
+        foreach my $filename (glob $file) {
+            # Don't touch directories.
+            next if -d $filename || !-e $filename;
+            _fix_perms($filename, $owner_id, $group_id, 
+                       $files{$file}->{perms});
+        }
+    }
+
+    _fix_cvs_dirs($owner_id, '.');
+}
+
+sub _get_owner_and_group {
+    my ($output) = @_;
+    my $group_id = _check_web_server_group($output);
+    return () if ON_WINDOWS;
+
+    my $owner_id = POSIX::getuid();
+    $group_id = POSIX::getgid() unless defined $group_id;
+    return ($owner_id, $group_id);
+}
+
+# A helper for fix_all_file_permissions
+sub _fix_cvs_dirs {
+    my ($owner_id, $dir) = @_;
+    my $owner_gid = POSIX::getgid();
+    find({ no_chdir => 1, wanted => sub {
+        my $name = $File::Find::name;
+        if ($File::Find::dir =~ /\/CVS/ || $_ eq '.cvsignore'
+            || (-d $name && $_ =~ /CVS$/)) 
+        {
+            my $perms = 0600;
+            if (-d $name) {
+                $perms = 0700;
+            }
+            _fix_perms($name, $owner_id, $owner_gid, $perms);
+        }
+    }}, $dir);
+}
+
+sub _fix_perms {
+    my ($name, $owner, $group, $perms) = @_;
+    #printf ("Changing $name to %o\n", $perms);
+
+    # The webserver should never try to chown files.
+    if (Bugzilla->usage_mode == USAGE_MODE_CMDLINE) {
+        chown $owner, $group, $name
+            or warn install_string('chown_failed', { path => $name, 
+                                                     error => $! }) . "\n";
+    }
+    chmod $perms, $name
+        or warn install_string('chmod_failed', { path => $name, 
+                                                 error => $! }) . "\n";
+}
+
+sub _fix_perms_recursively {
+    my ($dir, $owner_id, $group_id, $perms) = @_;
+    # Set permissions on the directory itself.
+    _fix_perms($dir, $owner_id, $group_id, $perms->{dirs});
+    # Now recurse through the directory and set the correct permissions
+    # on subdirectories and files.
+    find({ no_chdir => 1, wanted => sub {
+        my $name = $File::Find::name;
+        if (-d $name) {
+            _fix_perms($name, $owner_id, $group_id, $perms->{dirs});
+        }
+        else {
+            _fix_perms($name, $owner_id, $group_id, $perms->{files});
+        }
+    }}, $dir);
+}
+
+sub _check_web_server_group {
+    my ($output) = @_;
+
+    my $group    = Bugzilla->localconfig->{'webservergroup'};
+    my $filename = bz_locations()->{'localconfig'};
+    my $group_id;
+
+    # If we are on Windows, webservergroup does nothing
+    if (ON_WINDOWS && $group && $output) {
+        print "\n\n" . get_text('install_webservergroup_windows') . "\n\n";
+    }
+
+    # If we're not on Windows, make sure that webservergroup isn't
+    # empty.
+    elsif (!ON_WINDOWS && !$group && $output) {
+        print "\n\n" . get_text('install_webservergroup_empty') . "\n\n";
+    }
+
+    # If we're not on Windows, make sure we are actually a member of
+    # the webservergroup.
+    elsif (!ON_WINDOWS && $group) {
+        $group_id = getgrnam($group);
+        ThrowCodeError('invalid_webservergroup', { group => $group }) 
+            unless defined $group_id;
+
+        # If on unix, see if we need to print a warning about a webservergroup
+        # that we can't chgrp to
+        if ($output && $< != 0 && !grep($_ eq $group_id, split(" ", $)))) {
+            print "\n\n" . get_text('install_webservergroup_not_in') . "\n\n";
+        }
+    }
+
+    return $group_id;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Install::Filesystem - Fix up the filesystem during
+  installation.
+
+=head1 DESCRIPTION
+
+This module is used primarily by L<checksetup.pl> to modify the 
+filesystem during installation, including creating the data/ directory.
+
+=head1 SUBROUTINES
+
+=over
+
+=item C<update_filesystem({ index_html => 0 })>
+
+Description: Creates all the directories and files that Bugzilla
+             needs to function but doesn't ship with. Also does
+             any updates to these files as necessary during an
+             upgrade.
+
+Params:      C<index_html> - Whether or not we should create
+               the F<index.html> file.
+
+Returns:     nothing
+
+=item C<create_htaccess()>
+
+Description: Creates all of the .htaccess files for Apache,
+             in the various Bugzilla directories. Also updates
+             the .htaccess files if they need updating.
+
+Params:      none
+
+Returns:     nothing
+
+=item C<fix_all_file_permissions($output)>
+
+Description: Sets all the file permissions on all of Bugzilla's files
+             to what they should be. Note that permissions are different
+             depending on whether or not C<$webservergroup> is set
+             in F<localconfig>.
+
+Params:      C<$output> - C<true> if you want this function to print
+                 out information about what it's doing.
+
+Returns:     nothing
+
+=item C<fix_dir_permissions>
+
+Given the name of a directory, its permissions will be fixed according to
+how they are supposed to be set in Bugzilla's current configuration.
+If it fails to set the permissions, a warning will be printed to STDERR.
+
+=item C<fix_file_permissions>
+
+Given the name of a file, its permissions will be fixed according to
+how they are supposed to be set in Bugzilla's current configuration.
+If it fails to set the permissions, a warning will be printed to STDERR.
+
+=back

diff --git a/Bugzilla/Install/Localconfig.pm b/Bugzilla/Install/Localconfig.pm
new file mode 100644 (file)
index 0000000..4f1579c
--- /dev/null
+++ b/Bugzilla/Install/Localconfig.pm
@@ -0,0 +1,371 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Install::Localconfig;
+
+# NOTE: This package may "use" any modules that it likes. However,
+# all functions in this package should assume that:
+#
+# * The data/ directory does not exist.
+# * Templates are not available.
+# * Files do not have the correct permissions
+# * The database is not up to date
+
+use strict;
+
+use Bugzilla::Constants;
+use Bugzilla::Install::Util qw(bin_loc install_string);
+use Bugzilla::Util qw(generate_random_password wrap_hard);
+
+use Data::Dumper;
+use File::Basename qw(dirname);
+use Safe;
+use Term::ANSIColor;
+
+use base qw(Exporter);
+
+our @EXPORT_OK = qw(
+    read_localconfig
+    update_localconfig
+);
+
+use constant LOCALCONFIG_VARS => (
+    {
+        name    => 'create_htaccess',
+        default => 1,
+    },
+    {
+        name    => 'webservergroup',
+        default => ON_WINDOWS ? '' : 'apache',
+    },
+    {
+        name    => 'use_suexec',
+        default => 0,
+    },
+    {
+        name    => 'db_driver',
+        default => 'mysql',
+    },
+    {
+        name    => 'db_host',
+        default => 'localhost',           
+    },
+    {
+        name    => 'db_name',
+        default => 'bugs',
+    },
+    {
+        name    => 'db_user',
+        default => 'bugs',
+    },
+    {
+        name    => 'db_pass',
+        default => '',
+    },
+    {
+        name    => 'db_port',
+        default => 0,
+    },
+    {
+        name    => 'db_sock',
+        default => '',
+    },
+    {
+        name    => 'db_check',
+        default => 1,
+    },
+    {
+        name    => 'index_html',
+        default => 0,
+    },
+    {
+        name    => 'cvsbin',
+        default => sub { bin_loc('cvs') },
+    },
+    {
+        name    => 'interdiffbin',
+        default => sub { bin_loc('interdiff') },
+    },
+    {
+        name    => 'diffpath',
+        default => sub { dirname(bin_loc('diff')) },
+    },
+    {
+        name    => 'site_wide_secret',
+        # 64 characters is roughly the equivalent of a 384-bit key, which
+        # is larger than anybody would ever be able to brute-force.
+        default => sub { generate_random_password(64) },
+    },
+);
+
+sub read_localconfig {
+    my ($include_deprecated) = @_;
+    my $filename = bz_locations()->{'localconfig'};
+
+    my %localconfig;
+    if (-e $filename) {
+        my $s = new Safe;
+        # Some people like to store their database password in another file.
+        $s->permit('dofile');
+
+        $s->rdo($filename);
+        if ($@ || $!) {
+            my $err_msg = $@ ? $@ : $!;
+            die install_string('error_localconfig_read',
+                    { error => $err_msg, localconfig => $filename }), "\n";
+        }
+
+        my @read_symbols;
+        if ($include_deprecated) {
+            # First we have to get the whole symbol table
+            my $safe_root = $s->root;
+            my %safe_package;
+            { no strict 'refs'; %safe_package = %{$safe_root . "::"}; }
+            # And now we read the contents of every var in the symbol table.
+            # However:
+            # * We only include symbols that start with an alphanumeric
+            #   character. This excludes symbols like "_<./localconfig"
+            #   that show up in some perls.
+            # * We ignore the INC symbol, which exists in every package.
+            # * Perl 5.10 imports a lot of random symbols that all
+            #   contain "::", and we want to ignore those.
+            @read_symbols = grep { /^[A-Za-z0-1]/ and !/^INC$/ and !/::/ }
+                                 (keys %safe_package);
+        }
+        else {
+            @read_symbols = map($_->{name}, LOCALCONFIG_VARS);
+        }
+        foreach my $var (@read_symbols) {
+            my $glob = $s->varglob($var);
+            # We can't get the type of a variable out of a Safe automatically.
+            # We can only get the glob itself. So we figure out its type this
+            # way, by trying first a scalar, then an array, then a hash.
+            #
+            # The interesting thing is that this converts all deprecated 
+            # array or hash vars into hashrefs or arrayrefs, but that's 
+            # fine since as I write this all modern localconfig vars are 
+            # actually scalars.
+            if (defined $$glob) {
+                $localconfig{$var} = $$glob;
+            }
+            elsif (@$glob) {
+                $localconfig{$var} = \@$glob;
+            }
+            elsif (%$glob) {
+                $localconfig{$var} = \%$glob;
+            }
+        }
+    }
+
+    return \%localconfig;
+}
+
+
+#
+# This is quite tricky. But fun!
+#
+# First we read the file 'localconfig'. Then we check if the variables we
+# need are defined. If not, we will append the new settings to
+# localconfig, instruct the user to check them, and stop.
+#
+# Why do it this way?
+#
+# Assume we will enhance Bugzilla and eventually more local configuration
+# stuff arises on the horizon.
+#
+# But the file 'localconfig' is not in the Bugzilla CVS or tarfile. You
+# know, we never want to overwrite your own version of 'localconfig', so
+# we can't put it into the CVS/tarfile, can we?
+#
+# Now, when we need a new variable, we simply add the necessary stuff to
+# LOCALCONFIG_VARS. When the user gets the new version of Bugzilla from CVS and
+# runs checksetup, it finds out "Oh, there is something new". Then it adds
+# some default value to the user's local setup and informs the user to
+# check that to see if it is what the user wants.
+#
+# Cute, ey?
+#
+sub update_localconfig {
+    my ($params) = @_;
+
+    my $output      = $params->{output} || 0;
+    my $answer      = Bugzilla->installation_answers;
+    my $localconfig = read_localconfig('include deprecated');
+
+    my @new_vars;
+    foreach my $var (LOCALCONFIG_VARS) {
+        my $name = $var->{name};
+        my $value = $localconfig->{$name};
+        # Regenerate site_wide_secret if it was made by our old, weak
+        # generate_random_password. Previously we used to generate
+        # a 256-character string for site_wide_secret.
+        $value = undef if ($name eq 'site_wide_secret' and defined $value
+                           and length($value) == 256);
+        
+        if (!defined $value) {
+            push(@new_vars, $name);
+            $var->{default} = &{$var->{default}} if ref($var->{default}) eq 'CODE';
+            if (exists $answer->{$name}) {
+                $localconfig->{$name} = $answer->{$name};
+            }
+            else {
+                $localconfig->{$name} = $var->{default};
+            }
+        }
+    }
+
+    if (!$localconfig->{'interdiffbin'} && $output) {
+        print "\n", install_string('patchutils_missing'), "\n";
+    }
+
+    my @old_vars;
+    foreach my $var (keys %$localconfig) {
+        push(@old_vars, $var) if !grep($_->{name} eq $var, LOCALCONFIG_VARS);
+    }
+
+    my $filename = bz_locations->{'localconfig'};
+
+    # Move any custom or old variables into a separate file.
+    if (scalar @old_vars) {
+        my $filename_old = "$filename.old";
+        open(my $old_file, ">>:utf8", $filename_old) 
+            or die "$filename_old: $!";
+        local $Data::Dumper::Purity = 1;
+        foreach my $var (@old_vars) {
+            print $old_file Data::Dumper->Dump([$localconfig->{$var}], 
+                                               ["*$var"]) . "\n\n";
+        }
+        close $old_file;
+        my $oldstuff = join(', ', @old_vars);
+        print install_string('lc_old_vars',
+            { localconfig => $filename, old_file => $filename_old,
+              vars => $oldstuff }), "\n";
+    }
+
+    # Re-write localconfig
+    open(my $fh, ">:utf8", $filename) or die "$filename: $!";
+    foreach my $var (LOCALCONFIG_VARS) {
+        my $name = $var->{name};
+        my $desc = install_string("localconfig_$name", { root => ROOT_USER });
+        chomp($desc);
+        # Make the description into a comment.
+        $desc =~ s/^/# /mg;
+        print $fh $desc, "\n",
+                  Data::Dumper->Dump([$localconfig->{$name}],
+                                     ["*$name"]), "\n";
+   }
+
+    if (@new_vars) {
+        my $newstuff = join(', ', @new_vars);
+        print "\n";
+        print colored(install_string('lc_new_vars', { localconfig => $filename,
+                                                      new_vars => wrap_hard($newstuff, 70) }),
+                      COLOR_ERROR), "\n";
+        exit;
+    }
+
+    # Reset the cache for Bugzilla->localconfig so that it will be re-read
+    delete Bugzilla->request_cache->{localconfig};
+
+    return { old_vars => \@old_vars, new_vars => \@new_vars };
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Install::Localconfig - Functions and variables dealing
+  with the manipulation and creation of the F<localconfig> file.
+
+=head1 SYNOPSIS
+
+ use Bugzilla::Install::Requirements qw(update_localconfig);
+ update_localconfig({ output => 1 });
+
+=head1 DESCRIPTION
+
+This module is used primarily by L<checksetup.pl> to create and
+modify the localconfig file. Most scripts should use L<Bugzilla/localconfig>
+to access localconfig variables.
+
+=head1 CONSTANTS
+
+=over
+
+=item C<LOCALCONFIG_VARS>
+
+An array of hashrefs. These hashrefs contain three keys:
+
+ name    - The name of the variable.
+ default - The default value for the variable. Should always be
+           something that can fit in a scalar.
+ desc    - Additional text to put in localconfig before the variable
+           definition. Must end in a newline. Each line should start
+           with "#" unless you have some REALLY good reason not
+           to do that.
+
+=item C<OLD_LOCALCONFIG_VARS>
+
+An array of names of variables. If C<update_localconfig> finds these
+variables defined in localconfig, it will print out a warning.
+
+=back
+
+=head1 SUBROUTINES
+
+=over
+
+=item C<read_localconfig>
+
+=over
+
+=item B<Description>
+
+Reads the localconfig file and returns all valid values in a hashref.
+
+=item B<Params>
+
+=over
+
+=item C<$include_deprecated> 
+
+C<true> if you want the returned hashref to include *any* variable
+currently defined in localconfig, even if it doesn't exist in 
+C<LOCALCONFIG_VARS>. Generally this is is only for use 
+by L</update_localconfig>.
+
+=back
+
+=item B<Returns>
+
+A hashref of the localconfig variables. If an array is defined in
+localconfig, it will be an arrayref in the returned hash. If a
+hash is defined, it will be a hashref in the returned hash.
+Only includes variables specified in C<LOCALCONFIG_VARS>, unless
+C<$include_deprecated> is true.
+
+=back
+
+
+=item C<update_localconfig>
+
+Description: Adds any new variables to localconfig that aren't
+             currently defined there. Also optionally prints out
+             a message about vars that *should* be there and aren't.
+             Exits the program if it adds any new vars.
+
+Params:      C<$output> - C<true> if the function should display informational
+                 output and warnings. It will always display errors or
+                 any message which would cause program execution to halt.
+
+Returns:     A hashref, with C<old_vals> being an array of names of variables
+             that were removed, and C<new_vals> being an array of names
+             of variables that were added to localconfig.
+
+=back

diff --git a/Bugzilla/Install/Requirements.pm b/Bugzilla/Install/Requirements.pm
new file mode 100644 (file)
index 0000000..c86c119
--- /dev/null
+++ b/Bugzilla/Install/Requirements.pm
@@ -0,0 +1,919 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Install::Requirements;
+
+# NOTE: This package MUST NOT "use" any Bugzilla modules other than
+# Bugzilla::Constants, anywhere. We may "use" standard perl modules.
+#
+# Subroutines may "require" and "import" from modules, but they
+# MUST NOT "use."
+
+use strict;
+
+use Bugzilla::Constants;
+use Bugzilla::Install::Util qw(vers_cmp install_string bin_loc 
+                               extension_requirement_packages);
+use List::Util qw(max);
+use Term::ANSIColor;
+
+# Return::Value 1.666002 pollutes the error log with warnings about this
+# deprecated module. We have to set NO_CLUCK = 1 before loading Email::Send
+# in have_vers() to disable these warnings.
+BEGIN {
+    $Return::Value::NO_CLUCK = 1;
+}
+
+use base qw(Exporter);
+our @EXPORT = qw(
+    REQUIRED_MODULES
+    OPTIONAL_MODULES
+    FEATURE_FILES
+
+    check_requirements
+    check_graphviz
+    have_vers
+    install_command
+    map_files_to_features
+);
+
+# This is how many *'s are in the top of each "box" message printed
+# by checksetup.pl.
+use constant TABLE_WIDTH => 71;
+
+# Optional Apache modules that have no Perl component to them.
+# If these are installed, Bugzilla has additional functionality.
+#
+# The keys are the names of the modules, the values are what the module
+# is called in the output of "apachectl -t -D DUMP_MODULES".
+use constant APACHE_MODULES => { 
+    mod_headers => 'headers_module',
+    mod_env     => 'env_module',
+    mod_expires => 'expires_module',
+};
+
+# These are all of the binaries that we could possibly use that can
+# give us info about which Apache modules are installed.
+# If we can't use "apachectl", the "httpd" binary itself takes the same
+# parameters. Note that on Debian and Gentoo, there is an "apache2ctl",
+# but it takes different parameters on each of those two distros, so we
+# don't use apache2ctl.
+use constant APACHE => qw(apachectl httpd apache2 apache);
+
+# If we don't find any of the above binaries in the normal PATH,
+# these are extra places we look.
+use constant APACHE_PATH => [qw(
+    /usr/sbin 
+    /usr/local/sbin
+    /usr/libexec
+    /usr/local/libexec
+)];
+
+# The below two constants are subroutines so that they can implement
+# a hook. Other than that they are actually constants.
+
+# "package" is the perl package we're checking for. "module" is the name
+# of the actual module we load with "require" to see if the package is
+# installed or not. "version" is the version we need, or 0 if we'll accept
+# any version.
+#
+# "blacklist" is an arrayref of regular expressions that describe versions that
+# are 'blacklisted'--that is, even if the version is high enough, Bugzilla
+# will refuse to say that it's OK to run with that version.
+sub REQUIRED_MODULES {
+    my $perl_ver = sprintf('%vd', $^V);
+    my @modules = (
+    {
+        package => 'CGI.pm',
+        module  => 'CGI',
+        # 3.51 fixes a security problem that affects Bugzilla.
+        # (bug 591165)
+        version => '3.51',
+    },
+    {
+        package => 'Digest-SHA',
+        module  => 'Digest::SHA',
+        version => 0
+    },
+    # 0.23 fixes incorrect handling of 1/2 & 3/4 timezones.
+    {
+        package => 'TimeDate',
+        module  => 'Date::Format',
+        version => '2.23'
+    },
+    # 0.28 fixed some important bugs in DateTime.
+    {
+        package => 'DateTime',
+        module  => 'DateTime',
+        version => '0.28'
+    },
+    # 0.79 is required to work on Windows Vista and Windows Server 2008.
+    # As correctly detecting the flavor of Windows is not easy,
+    # we require this version for all Windows installations.
+    # 0.71 fixes a major bug affecting all platforms.
+    {
+        package => 'DateTime-TimeZone',
+        module  => 'DateTime::TimeZone',
+        version => ON_WINDOWS ? '0.79' : '0.71'
+    },
+    # 1.54 is required for Perl 5.10+. It also makes DBD::Oracle happy.
+    {
+        package => 'DBI',
+        module  => 'DBI',
+        version => (vers_cmp($perl_ver, '5.13.3') > -1) ? '1.614' : '1.54'
+    },
+    # 2.22 fixes various problems related to UTF8 strings in hash keys,
+    # as well as line endings on Windows.
+    {
+        package => 'Template-Toolkit',
+        module  => 'Template',
+        version => '2.22'
+    },
+    # 2.04 implement the "Test" method (to write to data/mailer.testfile).
+    {
+        package => 'Email-Send',
+        module  => 'Email::Send',
+        version => ON_WINDOWS ? '2.16' : '2.04',
+        blacklist => ['^2\.196$']
+    },
+    {
+        package => 'Email-MIME',
+        module  => 'Email::MIME',
+        # This fixes a memory leak in walk_parts that affected jobqueue.pl.
+        version => '1.904'
+    },
+    {
+        package => 'URI',
+        module  => 'URI',
+        # This version properly handles a semicolon as the delimiter
+        # in a URL query string.
+        version => '1.37',
+    },
+    # 0.32 fixes several memory leaks in the XS version of some functions.
+    {
+        package => 'List-MoreUtils',
+        module  => 'List::MoreUtils',
+        version => 0.32,
+    },
+    {
+        package => 'Math-Random-ISAAC',
+        module  => 'Math::Random::ISAAC',
+        version => '1.0.1',
+    },
+    );
+
+    if (ON_WINDOWS) {
+        push(@modules, {
+            package => 'Win32',
+            module  => 'Win32',
+            # 0.35 fixes a memory leak in GetOSVersion, which we use.
+            version => 0.35,
+        }, 
+        {
+            package => 'Win32-API',
+            module  => 'Win32::API',
+            # 0.55 fixes a bug with char* that might affect Bugzilla::RNG.
+            version => '0.55',
+        });
+    }
+
+    my $extra_modules = _get_extension_requirements('REQUIRED_MODULES');
+    push(@modules, @$extra_modules);
+    return \@modules;
+};
+
+sub OPTIONAL_MODULES {
+    my $perl_ver = sprintf('%vd', $^V);
+    my @modules = (
+    {
+        package => 'GD',
+        module  => 'GD',
+        version => '1.20',
+        feature => [qw(graphical_reports new_charts old_charts)],
+    },
+    {
+        package => 'Chart',
+        module  => 'Chart::Lines',
+        # Versions below 2.1 cannot be detected accurately.
+        version => '2.1',
+        feature => [qw(new_charts old_charts)],
+    },
+    {
+        package => 'Template-GD',
+        # This module tells us whether or not Template-GD is installed
+        # on Template-Toolkits after 2.14, and still works with 2.14 and lower.
+        module  => 'Template::Plugin::GD::Image',
+        version => 0,
+        feature => ['graphical_reports'],
+    },
+    {
+        package => 'GDTextUtil',
+        module  => 'GD::Text',
+        version => 0,
+        feature => ['graphical_reports'],
+    },
+    {
+        package => 'GDGraph',
+        module  => 'GD::Graph',
+        version => 0,
+        feature => ['graphical_reports'],
+    },
+    {
+        package => 'MIME-tools',
+        # MIME::Parser is packaged as MIME::Tools on ActiveState Perl
+        module  => ON_WINDOWS ? 'MIME::Tools' : 'MIME::Parser',
+        version => '5.406',
+        feature => ['moving'],
+    },
+    {
+        package => 'libwww-perl',
+        module  => 'LWP::UserAgent',
+        version => 0,
+        feature => ['updates'],
+    },
+    {
+        package => 'XML-Twig',
+        module  => 'XML::Twig',
+        version => 0,
+        feature => ['moving', 'updates'],
+    },
+    {
+        package => 'PatchReader',
+        module  => 'PatchReader',
+        # 0.9.6 fixes two notable bugs and significantly improves the UX.
+        version => '0.9.6',
+        feature => ['patch_viewer'],
+    },
+    {
+        package => 'perl-ldap',
+        module  => 'Net::LDAP',
+        version => 0,
+        feature => ['auth_ldap'],
+    },
+    {
+        package => 'Authen-SASL',
+        module  => 'Authen::SASL',
+        version => 0,
+        feature => ['smtp_auth'],
+    },
+    {
+        package => 'Net-SMTP-SSL',
+        module  => 'Net::SMTP::SSL',
+        version => 1.01,
+        feature => ['smtp_ssl'],
+    },
+    {
+        package => 'RadiusPerl',
+        module  => 'Authen::Radius',
+        version => 0,
+        feature => ['auth_radius'],
+    },
+    {
+        package => 'SOAP-Lite',
+        module  => 'SOAP::Lite',
+        # Fixes various bugs, including 542931 and 552353 + stops
+        # throwing warnings with Perl 5.12.
+        version => '0.712',
+        feature => ['xmlrpc'],
+    },
+    {
+        package => 'JSON-RPC',
+        module  => 'JSON::RPC',
+        version => 0,
+        feature => ['jsonrpc'],
+    },
+    {
+        package => 'JSON-XS',
+        module  => 'JSON::XS',
+        # 2.0 is the first version that will work with JSON::RPC.
+        version => '2.0',
+        feature => ['jsonrpc_faster'],
+    },
+    {
+        package => 'Test-Taint',
+        module  => 'Test::Taint',
+        version => 0,
+        feature => ['jsonrpc', 'xmlrpc'],
+    },
+    {
+        # We need the 'utf8_mode' method of HTML::Parser, for HTML::Scrubber.
+        package => 'HTML-Parser',
+        module  => 'HTML::Parser',
+        version => (vers_cmp($perl_ver, '5.13.3') > -1) ? '3.67' : '3.40',
+        feature => ['html_desc'],
+    },
+    {
+        package => 'HTML-Scrubber',
+        module  => 'HTML::Scrubber',
+        version => 0,
+        feature => ['html_desc'],
+    },
+    {
+        # we need version 2.21 of Encode for mime_name
+        package => 'Encode',
+        module  => 'Encode',
+        version => 2.21,
+        feature => ['detect_charset'],
+    },
+    {
+        package => 'Encode-Detect',
+        module  => 'Encode::Detect',
+        version => 0,
+        feature => ['detect_charset'],
+    },
+
+    # Inbound Email
+    {
+        package => 'Email-Reply',
+        module  => 'Email::Reply',
+        version => 0,
+        feature => ['inbound_email'],
+    },
+    {
+        package => 'HTML-FormatText-WithLinks',
+        module  => 'HTML::FormatText::WithLinks',
+        # We need 0.13 to set the "bold" marker to "*".
+        version => '0.13',
+        feature => ['inbound_email'],
+    },
+
+    # Mail Queueing
+    {
+        package => 'TheSchwartz',
+        module  => 'TheSchwartz',
+        version => 0,
+        feature => ['jobqueue'],
+    },
+    {
+        package => 'Daemon-Generic',
+        module  => 'Daemon::Generic',
+        version => 0,
+        feature => ['jobqueue'],
+    },
+
+    # mod_perl
+    {
+        package => 'mod_perl',
+        module  => 'mod_perl2',
+        version => '1.999022',
+        feature => ['mod_perl'],
+    },
+    {
+        package => 'Apache-SizeLimit',
+        module  => 'Apache2::SizeLimit',
+        # 0.96 properly determines process size on Linux.
+        version => '0.96',
+        feature => ['mod_perl'],
+    },
+
+    # typesniffer
+    {
+        package => 'File-MimeInfo',
+        module  => 'File::MimeInfo::Magic',
+        version => '0',
+        feature => ['typesniffer'],
+    },
+    {
+        package => 'IO-stringy',
+        module  => 'IO::Scalar',
+        version => '0',
+        feature => ['typesniffer'],
+    },
+    );
+
+    my $extra_modules = _get_extension_requirements('OPTIONAL_MODULES');
+    push(@modules, @$extra_modules);
+    return \@modules;
+};
+
+# This maps features to the files that require that feature in order
+# to compile. It is used by t/001compile.t and mod_perl.pl.
+use constant FEATURE_FILES => (
+    jsonrpc       => ['Bugzilla/WebService/Server/JSONRPC.pm', 'jsonrpc.cgi'],
+    xmlrpc        => ['Bugzilla/WebService/Server/XMLRPC.pm', 'xmlrpc.cgi',
+                      'Bugzilla/WebService.pm', 'Bugzilla/WebService/*.pm'],
+    moving        => ['importxml.pl'],
+    auth_ldap     => ['Bugzilla/Auth/Verify/LDAP.pm'],
+    auth_radius   => ['Bugzilla/Auth/Verify/RADIUS.pm'],
+    inbound_email => ['email_in.pl'],
+    jobqueue      => ['Bugzilla/Job/*', 'Bugzilla/JobQueue.pm',
+                      'Bugzilla/JobQueue/*', 'jobqueue.pl'],
+    patch_viewer  => ['Bugzilla/Attachment/PatchReader.pm'],
+    updates       => ['Bugzilla/Update.pm'],
+);
+
+# This implements the REQUIRED_MODULES and OPTIONAL_MODULES stuff
+# described in in Bugzilla::Extension.
+sub _get_extension_requirements {
+    my ($function) = @_;
+
+    my $packages = extension_requirement_packages();
+    my @modules;
+    foreach my $package (@$packages) {
+        if ($package->can($function)) {
+            my $extra_modules = $package->$function;
+            push(@modules, @$extra_modules);
+        }
+    }
+    return \@modules;
+};
+
+sub check_requirements {
+    my ($output) = @_;
+
+    print "\n", install_string('checking_modules'), "\n" if $output;
+    my $root = ROOT_USER;
+    my $missing = _check_missing(REQUIRED_MODULES, $output);
+
+    print "\n", install_string('checking_dbd'), "\n" if $output;
+    my $have_one_dbd = 0;
+    my $db_modules = DB_MODULE;
+    foreach my $db (keys %$db_modules) {
+        my $dbd = $db_modules->{$db}->{dbd};
+        $have_one_dbd = 1 if have_vers($dbd, $output);
+    }
+
+    print "\n", install_string('checking_optional'), "\n" if $output;
+    my $missing_optional = _check_missing(OPTIONAL_MODULES, $output);
+
+    my $missing_apache = _missing_apache_modules(APACHE_MODULES, $output);
+
+    # If we're running on Windows, reset the input line terminator so that
+    # console input works properly - loading CGI tends to mess it up
+    $/ = "\015\012" if ON_WINDOWS;
+
+    my $pass = !scalar(@$missing) && $have_one_dbd;
+    return {
+        pass     => $pass,
+        one_dbd  => $have_one_dbd,
+        missing  => $missing,
+        optional => $missing_optional,
+        apache   => $missing_apache,
+        any_missing => !$pass || scalar(@$missing_optional),
+    };
+}
+
+# A helper for check_requirements
+sub _check_missing {
+    my ($modules, $output) = @_;
+
+    my @missing;
+    foreach my $module (@$modules) {
+        unless (have_vers($module, $output)) {
+            push(@missing, $module);
+        }
+    }
+
+    return \@missing;
+}
+
+sub _missing_apache_modules {
+    my ($modules, $output) = @_;
+    my $apachectl = _get_apachectl();
+    return [] if !$apachectl;
+    my $command = "$apachectl -t -D DUMP_MODULES";
+    my $cmd_info = `$command 2>&1`;
+    # If apachectl returned a value greater than 0, then there was an
+    # error parsing Apache's configuration, and we can't check modules.
+    my $retval = $?;
+    if ($retval > 0) {
+        print STDERR install_string('apachectl_failed', 
+            { command => $command, root => ROOT_USER }), "\n";
+        return [];
+    }
+    my @missing;
+    foreach my $module (keys %$modules) {
+        my $ok = _check_apache_module($module, $modules->{$module}, 
+                                      $cmd_info, $output);
+        push(@missing, $module) if !$ok;
+    }
+    return \@missing;
+}
+
+sub _get_apachectl {
+    foreach my $bin_name (APACHE) {
+        my $bin = bin_loc($bin_name);
+        return $bin if $bin;
+    }
+    # Try again with a possibly different path.
+    foreach my $bin_name (APACHE) {
+        my $bin = bin_loc($bin_name, APACHE_PATH);
+        return $bin if $bin;
+    }
+    return undef;
+}
+
+sub _check_apache_module {
+    my ($module, $config_name, $mod_info, $output) = @_;
+    my $ok;
+    if ($mod_info =~ /^\s+\Q$config_name\E\b/m) {
+        $ok = 1;
+    }
+    if ($output) {
+        _checking_for({ package => $module, ok => $ok });
+    }
+    return $ok;
+}
+
+sub print_module_instructions {
+    my ($check_results, $output) = @_;
+
+    # First we print the long explanatory messages.
+
+    if (scalar @{$check_results->{missing}}) {
+        print install_string('modules_message_required');
+    }
+
+    if (!$check_results->{one_dbd}) {
+        print install_string('modules_message_db');
+    }
+
+    if (my @missing = @{$check_results->{optional}} and $output) {
+        print install_string('modules_message_optional');
+        # Now we have to determine how large the table cols will be.
+        my $longest_name = max(map(length($_->{package}), @missing));
+
+        # The first column header is at least 11 characters long.
+        $longest_name = 11 if $longest_name < 11;
+
+        # The table is TABLE_WIDTH characters long. There are seven mandatory
+        # characters (* and space) in the string. So, we have a total
+        # of TABLE_WIDTH - 7 characters to work with.
+        my $remaining_space = (TABLE_WIDTH - 7) - $longest_name;
+        print '*' x TABLE_WIDTH . "\n";
+        printf "* \%${longest_name}s * %-${remaining_space}s *\n",
+               'MODULE NAME', 'ENABLES FEATURE(S)';
+        print '*' x TABLE_WIDTH . "\n";
+        foreach my $package (@missing) {
+            printf "* \%${longest_name}s * %-${remaining_space}s *\n",
+                   $package->{package}, 
+                   _translate_feature($package->{feature});
+        }
+    }
+
+    if (my @missing = @{ $check_results->{apache} }) {
+        print install_string('modules_message_apache');
+        my $missing_string = join(', ', @missing);
+        my $size = TABLE_WIDTH - 7;
+        printf "*    \%-${size}s *\n", $missing_string;
+        my $spaces = TABLE_WIDTH - 2;
+        print "*", (' ' x $spaces), "*\n";
+    }
+
+    my $need_module_instructions =  
+        ( (!$output and @{$check_results->{missing}})
+          or ($output and $check_results->{any_missing}) ) ? 1 : 0;
+
+    if ($need_module_instructions or @{ $check_results->{apache} }) {
+        # If any output was required, we want to close the "table"
+        print "*" x TABLE_WIDTH . "\n";
+    }
+
+    # And now we print the actual installation commands.
+
+    if (my @missing = @{$check_results->{optional}} and $output) {
+        print install_string('commands_optional') . "\n\n";
+        foreach my $module (@missing) {
+            my $command = install_command($module);
+            printf "%15s: $command\n", $module->{package};
+        }
+        print "\n";
+    }
+
+    if (!$check_results->{one_dbd}) {
+        print install_string('commands_dbd') . "\n";
+        my %db_modules = %{DB_MODULE()};
+        foreach my $db (keys %db_modules) {
+            my $command = install_command($db_modules{$db}->{dbd});
+            printf "%10s: \%s\n", $db_modules{$db}->{name}, $command;
+        }
+        print "\n";
+    }
+
+    if (my @missing = @{$check_results->{missing}}) {
+        print colored(install_string('commands_required'), COLOR_ERROR), "\n";
+        foreach my $package (@missing) {
+            my $command = install_command($package);
+            print "    $command\n";
+        }
+    }
+
+    if ($output && $check_results->{any_missing} && !ON_ACTIVESTATE
+        && !$check_results->{hide_all}) 
+    {
+        print install_string('install_all', { perl => $^X });
+    }
+    if (!$check_results->{pass}) {
+        print colored(install_string('installation_failed'), COLOR_ERROR),
+              "\n\n";
+    }
+}
+
+sub _translate_feature {
+    my $features = shift;
+    my @strings;
+    foreach my $feature (@$features) {
+        push(@strings, install_string("feature_$feature"));
+    }
+    return join(', ', @strings);
+}
+
+sub check_graphviz {
+    my ($output) = @_;
+
+    my $webdotbase = Bugzilla->params->{'webdotbase'};
+    return 1 if $webdotbase =~ /^https?:/;
+
+    my $return;
+    $return = 1 if -x $webdotbase;
+
+    if ($output) {
+        _checking_for({ package => 'GraphViz', ok => $return });
+    }
+
+    if (!$return) {
+        print install_string('bad_executable', { bin => $webdotbase }), "\n";
+    }
+
+    my $webdotdir = bz_locations()->{'webdotdir'};
+    # Check .htaccess allows access to generated images
+    if (-e "$webdotdir/.htaccess") {
+        my $htaccess = new IO::File("$webdotdir/.htaccess", 'r') 
+            || die "$webdotdir/.htaccess: " . $!;
+        if (!grep(/png/, $htaccess->getlines)) {
+            print STDERR install_string('webdot_bad_htaccess',
+                                        { dir => $webdotdir }), "\n";
+        }
+        $htaccess->close;
+    }
+
+    return $return;
+}
+
+# This was originally clipped from the libnet Makefile.PL, adapted here to
+# use the below vers_cmp routine for accurate version checking.
+sub have_vers {
+    my ($params, $output) = @_;
+    my $module  = $params->{module};
+    my $package = $params->{package};
+    if (!$package) {
+        $package = $module;
+        $package =~ s/::/-/g;
+    }
+    my $wanted  = $params->{version};
+
+    eval "require $module;";
+    # Don't let loading a module change the output-encoding of STDOUT
+    # or STDERR. (CGI.pm tries to set "binmode" on these file handles when
+    # it's loaded, and other modules may do the same in the future.)
+    Bugzilla::Install::Util::set_output_encoding();
+
+    # VERSION is provided by UNIVERSAL::, and can be called even if
+    # the module isn't loaded.
+    my $vnum = $module->VERSION || -1;
+
+    # CGI's versioning scheme went 2.75, 2.751, 2.752, 2.753, 2.76
+    # That breaks the standard version tests, so we need to manually correct
+    # the version
+    if ($module eq 'CGI' && $vnum =~ /(2\.7\d)(\d+)/) {
+        $vnum = $1 . "." . $2;
+    }
+    # CPAN did a similar thing, where it has versions like 1.9304.
+    if ($module eq 'CPAN' and $vnum =~ /^(\d\.\d{2})\d{2}$/) {
+        $vnum = $1;
+    }
+
+    my $vok = (vers_cmp($vnum,$wanted) > -1);
+    my $blacklisted;
+    if ($vok && $params->{blacklist}) {
+        $blacklisted = grep($vnum =~ /$_/, @{$params->{blacklist}});
+        $vok = 0 if $blacklisted;
+    }
+
+    if ($output) {
+        _checking_for({ 
+            package => $package, ok => $vok, wanted => $wanted,
+            found   => $vnum, blacklisted => $blacklisted
+        });
+    }
+    
+    return $vok ? 1 : 0;
+}
+
+sub _checking_for {
+    my ($params) = @_;
+    my ($package, $ok, $wanted, $blacklisted, $found) = 
+        @$params{qw(package ok wanted blacklisted found)};
+
+    my $ok_string = $ok ? install_string('module_ok') : '';
+
+    # If we're actually checking versions (like for Perl modules), then
+    # we have some rather complex logic to determine what we want to 
+    # show. If we're not checking versions (like for GraphViz) we just
+    # show "ok" or "not found".
+    if (exists $params->{found}) {
+        my $found_string;
+        # We do a string compare in case it's non-numeric. We make sure
+        # it's not a version object as negative versions are forbidden.
+        if ($found && !ref($found) && $found eq '-1') {
+            $found_string = install_string('module_not_found');
+        }
+        elsif ($found) {
+            $found_string = install_string('module_found', { ver => $found });
+        }
+        else {
+            $found_string = install_string('module_unknown_version');
+        }
+        $ok_string = $ok ? "$ok_string: $found_string" : $found_string;
+    }
+    elsif (!$ok) {
+        $ok_string = install_string('module_not_found');
+    }
+
+    my $black_string = $blacklisted ? install_string('blacklisted') : '';
+    my $want_string  = $wanted ? "v$wanted" : install_string('any');
+
+    my $str = sprintf "%s %20s %-11s $ok_string $black_string\n",
+                install_string('checking_for'), $package, "($want_string)";
+    print $ok ? $str : colored($str, COLOR_ERROR);
+}
+
+sub install_command {
+    my $module = shift;
+    my ($command, $package);
+
+    if (ON_ACTIVESTATE) {
+        $command = 'ppm install %s';
+        $package = $module->{package};
+    }
+    else {
+        $command = "$^X install-module.pl \%s";
+        # Non-Windows installations need to use module names, because
+        # CPAN doesn't understand package names.
+        $package = $module->{module};
+    }
+    return sprintf $command, $package;
+}
+
+# This does a reverse mapping for FEATURE_FILES.
+sub map_files_to_features {
+    my %features = FEATURE_FILES;
+    my %files;
+    foreach my $feature (keys %features) {
+        my @my_files = @{ $features{$feature} };
+        foreach my $pattern (@my_files) {
+            foreach my $file (glob $pattern) {
+                $files{$file} = $feature;
+            }
+        }
+    }
+    return \%files;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Install::Requirements - Functions and variables dealing
+  with Bugzilla's perl-module requirements.
+
+=head1 DESCRIPTION
+
+This module is used primarily by C<checksetup.pl> to determine whether
+or not all of Bugzilla's prerequisites are installed. (That is, all the
+perl modules it requires.)
+
+=head1 CONSTANTS
+
+=over
+
+=item C<REQUIRED_MODULES>
+
+An arrayref of hashrefs that describes the perl modules required by 
+Bugzilla. The hashes have three keys: 
+
+=over
+
+=item C<package> - The name of the Perl package that you'd find on
+CPAN for this requirement. 
+
+=item C<module> - The name of a module that can be passed to the
+C<install> command in C<CPAN.pm> to install this module.
+
+=item C<version> - The version of this module that we require, or C<0>
+if any version is acceptable.
+
+=back
+
+=item C<OPTIONAL_MODULES>
+
+An arrayref of hashrefs that describes the perl modules that add
+additional features to Bugzilla if installed. Its hashes have all
+the fields of L</REQUIRED_MODULES>, plus a C<feature> item--an arrayref
+of strings that describe what features require this module.
+
+=item C<FEATURE_FILES>
+
+A hashref that describes what files should only be compiled if a certain
+feature is enabled. The feature is the key, and the values are arrayrefs
+of file names (which are passed to C<glob>, so shell patterns work).
+
+=back
+
+
+=head1 SUBROUTINES
+
+=over 4
+
+=item C<check_requirements>
+
+=over
+
+=item B<Description>
+
+This checks what optional or required perl modules are installed, like
+C<checksetup.pl> does.
+
+=item B<Params>
+
+=over
+
+=item C<$output> - C<true> if you want the function to print out information
+about what it's doing, and the versions of everything installed.
+
+=back
+
+=item B<Returns>
+
+A hashref containing these values:
+
+=over
+
+=item C<pass> - Whether or not we have all the mandatory requirements.
+
+=item C<missing> - An arrayref containing any required modules that
+are not installed or that are not up-to-date. Each item in the array is
+a hashref in the format of items from L</REQUIRED_MODULES>.
+
+=item C<optional> - The same as C<missing>, but for optional modules.
+
+=item C<apache> - The name of each optional Apache module that is missing.
+
+=item C<have_one_dbd> - True if at least one C<DBD::> module is installed.
+
+=item C<any_missing> - True if there are any missing Perl modules, even
+optional modules.
+
+=back
+
+=back
+
+=item C<check_graphviz($output)>
+
+Description: Checks if the graphviz binary specified in the 
+  C<webdotbase> parameter is a valid binary, or a valid URL.
+
+Params:      C<$output> - C<$true> if you want the function to
+                 print out information about what it's doing.
+
+Returns:     C<1> if the check was successful, C<0> otherwise.
+
+=item C<have_vers($module, $output)>
+
+ Description: Tells you whether or not you have the appropriate
+              version of the module requested. It also prints
+              out a message to the user explaining the check
+              and the result.
+
+ Params:      C<$module> - A hashref, in the format of an item from 
+                           L</REQUIRED_MODULES>.
+              C<$output> - Set to true if you want this function to
+                           print information to STDOUT about what it's
+                           doing.
+
+ Returns:   C<1> if you have the module installed and you have the
+            appropriate version. C<0> otherwise.
+
+=item C<install_command($module)>
+
+ Description: Prints out the appropriate command to install the
+              module specified, depending on whether you're
+              on Windows or Linux.
+
+ Params:      C<$module> - A hashref, in the format of an item from
+                           L</REQUIRED_MODULES>.
+
+ Returns:     nothing
+
+=item C<map_files_to_features>
+
+Returns a hashref where file names are the keys and the value is the feature
+that must be enabled in order to compile that file.
+
+=back

diff --git a/Bugzilla/Install/Util.pm b/Bugzilla/Install/Util.pm
new file mode 100644 (file)
index 0000000..cbc41db
--- /dev/null
+++ b/Bugzilla/Install/Util.pm
@@ -0,0 +1,918 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Install::Util;
+
+# The difference between this module and Bugzilla::Util is that this
+# module may require *only* Bugzilla::Constants and built-in
+# perl modules.
+
+use strict;
+
+use Bugzilla::Constants;
+
+use Encode;
+use File::Basename;
+use File::Spec;
+use POSIX qw(setlocale LC_CTYPE);
+use Scalar::Util qw(tainted);
+use Term::ANSIColor qw(colored);
+use PerlIO;
+
+use base qw(Exporter);
+our @EXPORT_OK = qw(
+    bin_loc
+    get_version_and_os
+    extension_code_files
+    extension_package_directory
+    extension_requirement_packages
+    extension_template_directory
+    extension_web_directory
+    indicate_progress
+    install_string
+    include_languages
+    success
+    template_include_path
+    vers_cmp
+    init_console
+);
+
+sub bin_loc {
+    my ($bin, $path) = @_;
+    # This module is not needed most of the time and is a bit slow,
+    # so we only load it when calling bin_loc().
+    require ExtUtils::MM;
+
+    # If the binary is a full path...
+    if ($bin =~ m{[/\\]}) {
+        return MM->maybe_command($bin) || '';
+    }
+
+    # Otherwise we look for it in the path in a cross-platform way.
+    my @path = $path ? @$path : File::Spec->path;
+    foreach my $dir (@path) {
+        next if !-d $dir;
+        my $full_path = File::Spec->catfile($dir, $bin);
+        # MM is an alias for ExtUtils::MM. maybe_command is nice
+        # because it checks .com, .bat, .exe (etc.) on Windows.
+        my $command = MM->maybe_command($full_path);
+        return $command if $command;
+    }
+
+    return '';
+}
+
+sub get_version_and_os {
+    # Display version information
+    my @os_details = POSIX::uname;
+    # 0 is the name of the OS, 2 is the major version,
+    my $os_name = $os_details[0] . ' ' . $os_details[2];
+    if (ON_WINDOWS) {
+        require Win32;
+        $os_name = Win32::GetOSName();
+    }
+    # $os_details[3] is the minor version.
+    return { bz_ver   => BUGZILLA_VERSION,
+             perl_ver => sprintf('%vd', $^V),
+             os_name  => $os_name,
+             os_ver   => $os_details[3] };
+}
+
+sub _extension_paths {
+    my $dir = bz_locations()->{'extensionsdir'};
+    my @extension_items = glob("$dir/*");
+    my @paths;
+    foreach my $item (@extension_items) {
+        my $basename = basename($item);
+        # Skip CVS directories and any hidden files/dirs.
+        next if ($basename eq 'CVS' or $basename =~ /^\./);
+        if (-d $item) {
+            if (!-e "$item/disabled") {
+                push(@paths, $item);
+            }
+        }
+        elsif ($item =~ /\.pm$/i) {
+            push(@paths, $item);
+        }
+    }
+    return @paths;
+}
+
+sub extension_code_files {
+    my ($requirements_only) = @_;
+    my @files;
+    foreach my $path (_extension_paths()) {
+        my @load_files;
+        if (-d $path) {
+            my $extension_file = "$path/Extension.pm";
+            my $config_file    = "$path/Config.pm";
+            if (-e $extension_file) {
+                push(@load_files, $extension_file);
+            }
+            if (-e $config_file) {
+                push(@load_files, $config_file);
+            }
+
+            # Don't load Extension.pm if we just want Config.pm and
+            # we found both.
+            if ($requirements_only and scalar(@load_files) == 2) {
+                shift(@load_files);
+            }
+        }
+        else {
+            push(@load_files, $path);
+        }
+        next if !scalar(@load_files);
+        # We know that these paths are safe, because they came from
+        # extensionsdir and we checked them specifically for their format.
+        # Also, the only thing we ever do with them is pass them to "require".
+        trick_taint($_) foreach @load_files;
+        push(@files, \@load_files);
+    }
+
+    my @additional;
+    my $datadir = bz_locations()->{'datadir'};
+    my $addl_file = "$datadir/extensions/additional";
+    if (-e $addl_file) {
+        open(my $fh, '<', $addl_file) || die "$addl_file: $!";
+        @additional = map { trim($_) } <$fh>;
+        close($fh);
+    }
+    return (\@files, \@additional);
+}
+
+# Used by _get_extension_requirements in Bugzilla::Install::Requirements.
+sub extension_requirement_packages {
+    # If we're in a .cgi script or some time that's not the requirements phase,
+    # just use Bugzilla->extensions. This avoids running the below code during
+    # a normal Bugzilla page, which is important because the below code
+    # doesn't actually function right if it runs after 
+    # Bugzilla::Extension->load_all (because stuff has already been loaded).
+    # (This matters because almost every page calls Bugzilla->feature, which
+    # calls OPTIONAL_MODULES, which calls this method.)
+    #
+    # We check if Bugzilla.pm is already loaded, instead of doing a "require",
+    # because we *do* want the code lower down to run during the Requirements
+    # phase of checksetup.pl, instead of Bugzilla->extensions, and Bugzilla.pm
+    # actually *can* be loaded during the Requirements phase if all the
+    # requirements have already been installed.
+    if ($INC{'Bugzilla.pm'}) {
+        return Bugzilla->extensions;
+    }
+    my $packages = _cache()->{extension_requirement_packages};
+    return $packages if $packages;
+    $packages = [];
+    my %package_map;
+    
+    my ($file_sets, $extra_packages) = extension_code_files('requirements only');
+    foreach my $file_set (@$file_sets) {
+        my $file = shift @$file_set;
+        my $name = require $file;
+        if ($name =~ /^\d+$/) {
+            die install_string('extension_must_return_name',
+                               { file => $file, returned => $name });
+        }
+        my $package = "Bugzilla::Extension::$name";
+        if ($package->can('package_dir')) {
+            $package->package_dir($file);
+        }
+        else {
+            extension_package_directory($package, $file);
+        }
+        $package_map{$file} = $package;
+        push(@$packages, $package);
+    }
+    foreach my $package (@$extra_packages) {
+        eval("require $package") || die $@;
+        push(@$packages, $package);
+    }
+
+    _cache()->{extension_requirement_packages} = $packages;
+    # Used by Bugzilla::Extension->load if it's called after this method
+    # (which only happens during checksetup.pl, currently).
+    _cache()->{extension_requirement_package_map} = \%package_map;
+    return $packages;
+}
+
+# Used in this file and in Bugzilla::Extension.
+sub extension_template_directory {
+    my $extension = shift;
+    my $class = ref($extension) || $extension;
+    my $base_dir = extension_package_directory($class);
+    if ($base_dir eq bz_locations->{'extensionsdir'}) {
+        return bz_locations->{'templatedir'};
+    }
+    return "$base_dir/template";
+}
+
+# Used in this file and in Bugzilla::Extension.
+sub extension_web_directory {
+    my $extension = shift;
+    my $class = ref($extension) || $extension;
+    my $base_dir = extension_package_directory($class);
+    return "$base_dir/web";
+}
+
+# For extensions that are in the extensions/ dir, this both sets and fetches
+# the name of the directory that stores an extension's "stuff". We need this
+# when determining the template directory for extensions (or other things
+# that are relative to the extension's base directory).
+sub extension_package_directory {
+    my ($invocant, $file) = @_;
+    my $class = ref($invocant) || $invocant;
+
+    # $file is set on the first invocation, store the value in the extension's
+    # package for retrieval on subsequent calls
+    my $var;
+    {
+        no warnings 'once';
+        no strict 'refs';
+        $var = \${"${class}::EXTENSION_PACKAGE_DIR"};
+    }
+    if ($file) {
+        $$var = dirname($file);
+    }
+    my $value = $$var;
+
+    # This is for extensions loaded from data/extensions/additional.
+    if (!$value) {
+        my $short_path = $class;
+        $short_path =~ s/::/\//g;
+        $short_path .= ".pm";
+        my $long_path = $INC{$short_path};
+        die "$short_path is not in \%INC" if !$long_path;
+        $value = $long_path;
+        $value =~ s/\.pm//;
+    }
+    return $value;
+}
+
+sub indicate_progress {
+    my ($params) = @_;
+    my $current = $params->{current};
+    my $total   = $params->{total};
+    my $every   = $params->{every} || 1;
+
+    print "." if !($current % $every);
+    if ($current == $total || $current % ($every * 60) == 0) {
+        print "$current/$total (" . int($current * 100 / $total) . "%)\n";
+    }
+}
+
+sub install_string {
+    my ($string_id, $vars) = @_;
+    _cache()->{install_string_path} ||= template_include_path();
+    my $path = _cache()->{install_string_path};
+    
+    my $string_template;
+    # Find the first template that defines this string.
+    foreach my $dir (@$path) {
+        my $base = "$dir/setup/strings";
+        $string_template = _get_string_from_file($string_id, "$base.txt.pl")
+            if !defined $string_template;
+        last if defined $string_template;
+    }
+    
+    die "No language defines the string '$string_id'"
+        if !defined $string_template;
+
+    utf8::decode($string_template) if !utf8::is_utf8($string_template);
+
+    $vars ||= {};
+    my @replace_keys = keys %$vars;
+    foreach my $key (@replace_keys) {
+        my $replacement = $vars->{$key};
+        die "'$key' in '$string_id' is tainted: '$replacement'"
+            if tainted($replacement);
+        # We don't want people to start getting clever and inserting
+        # ##variable## into their values. So we check if any other
+        # key is listed in the *replacement* string, before doing
+        # the replacement. This is mostly to protect programmers from
+        # making mistakes.
+        if (grep($replacement =~ /##$key##/, @replace_keys)) {
+            die "Unsafe replacement for '$key' in '$string_id': '$replacement'";
+        }
+        $string_template =~ s/\Q##$key##\E/$replacement/g;
+    }
+
+    return $string_template;
+}
+
+sub _wanted_languages {
+    my ($requested, @wanted);
+
+    # Checking SERVER_SOFTWARE is the same as i_am_cgi() in Bugzilla::Util.
+    if (exists $ENV{'SERVER_SOFTWARE'}) {
+        my $cgi = eval { Bugzilla->cgi } || eval { require CGI; return CGI->new() };
+        $requested = $cgi->http('Accept-Language') || '';
+        my $lang = $cgi->cookie('LANG');
+        push(@wanted, $lang) if $lang;
+    }
+    else {
+        $requested = get_console_locale();
+    }
+
+    push(@wanted, _sort_accept_language($requested));
+    return \@wanted;
+}
+
+sub _wanted_to_actual_languages {
+    my ($wanted, $supported) = @_;
+
+    my @actual;
+    foreach my $lang (@$wanted) {
+        # If we support the language we want, or *any version* of
+        # the language we want, it gets pushed into @actual.
+        #
+        # Per RFC 1766 and RFC 2616, things like 'en' match 'en-us' and
+        # 'en-uk', but not the other way around. (This is unfortunately
+        # not very clearly stated in those RFC; see comment just over 14.5
+        # in http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.4)
+        my @found = grep(/^\Q$lang\E(-.+)?$/i, @$supported);
+        push(@actual, @found) if @found;
+    }
+
+    # We always include English at the bottom if it's not there, even if
+    # it wasn't selected by the user.
+    if (!grep($_ eq 'en', @actual)) {
+        push(@actual, 'en');
+    }
+
+    return \@actual;
+}
+
+sub supported_languages {
+    my $cache = _cache();
+    return $cache->{supported_languages} if $cache->{supported_languages};
+
+    my @dirs = glob(bz_locations()->{'templatedir'} . "/*");
+    my @languages;
+    foreach my $dir (@dirs) {
+        # It's a language directory only if it contains "default" or
+        # "custom". This auto-excludes CVS directories as well.
+        next if (!-d "$dir/default" and !-d "$dir/custom");
+        my $lang = basename($dir);
+        # Check for language tag format conforming to RFC 1766.
+        next unless $lang =~ /^[a-zA-Z]{1,8}(-[a-zA-Z]{1,8})?$/;
+        push(@languages, $lang);
+    }
+
+    $cache->{supported_languages} = \@languages;
+    return \@languages;
+}
+
+sub include_languages {
+    my ($params) = @_;
+
+    # Basically, the way this works is that we have a list of languages
+    # that we *want*, and a list of languages that Bugzilla actually
+    # supports. If there is only one language installed, we take it.
+    my $supported = supported_languages();
+    return @$supported if @$supported == 1;
+
+    my $wanted;
+    if ($params->{language}) {
+        # We can pass several languages at once as an arrayref
+        # or a single language.
+        $wanted = $params->{language};
+        $wanted = [$wanted] unless ref $wanted;
+    }
+    else {
+        $wanted = _wanted_languages();
+    }
+    my $actual    = _wanted_to_actual_languages($wanted, $supported);
+    return @$actual;
+}
+
+# Used by template_include_path
+sub _template_lang_directories {
+    my ($languages, $templatedir) = @_;
+    
+    my @add = qw(custom default);
+    my $project = bz_locations->{'project'};
+    unshift(@add, $project) if $project;
+
+    my @result;
+    foreach my $lang (@$languages) {
+        foreach my $dir (@add) {
+            my $full_dir = "$templatedir/$lang/$dir";
+            if (-d $full_dir) {
+                trick_taint($full_dir);
+                push(@result, $full_dir);
+            }
+        }
+    }
+    return @result;
+}
+
+# Used by template_include_path.
+sub _template_base_directories {
+    # First, we add extension template directories, because extension templates
+    # override standard templates. Extensions may be localized in the same way
+    # that Bugzilla templates are localized.
+    #
+    # We use extension_requirement_packages instead of Bugzilla->extensions
+    # because this fucntion is called during the requirements phase of 
+    # installation (so Bugzilla->extensions isn't available).
+    my $extensions = extension_requirement_packages();
+    my @template_dirs;
+    foreach my $extension (@$extensions) {
+        my $dir;
+        # If there's a template_dir method available in the extension
+        # package, then call it. Note that this has to be defined in
+        # Config.pm for extensions that have a Config.pm, to be effective
+        # during the Requirements phase of checksetup.pl.
+        if ($extension->can('template_dir')) {
+            $dir = $extension->template_dir;
+        }
+        else {
+            $dir = extension_template_directory($extension);
+        }
+        if (-d $dir) {
+            push(@template_dirs, $dir);
+        }
+    }
+
+    # Extensions may also contain *only* templates, in which case they
+    # won't show up in extension_requirement_packages.
+    foreach my $path (_extension_paths()) {
+        next if !-d $path;
+        if (!-e "$path/Extension.pm" and !-e "$path/Config.pm"
+            and -d "$path/template") 
+        {
+            push(@template_dirs, "$path/template");
+        }
+    }
+
+
+    push(@template_dirs, bz_locations()->{'templatedir'});
+    return \@template_dirs;
+}
+
+sub template_include_path {
+    my ($params) = @_;
+    my @used_languages = include_languages($params);
+    # Now, we add template directories in the order they will be searched:
+    my $template_dirs = _template_base_directories(); 
+
+    my @include_path;
+    foreach my $template_dir (@$template_dirs) {
+        my @lang_dirs = _template_lang_directories(\@used_languages, 
+                                                   $template_dir);
+        # Hooks get each set of extension directories separately.
+        if ($params->{hook}) {
+            push(@include_path, \@lang_dirs);
+        }
+        # Whereas everything else just gets a whole INCLUDE_PATH.
+        else {
+            push(@include_path, @lang_dirs);
+        }
+    }
+    return \@include_path;
+}
+
+# This is taken straight from Sort::Versions 1.5, which is not included
+# with perl by default.
+sub vers_cmp {
+    my ($a, $b) = @_;
+
+    # Remove leading zeroes - Bug 344661
+    $a =~ s/^0*(\d.+)/$1/;
+    $b =~ s/^0*(\d.+)/$1/;
+
+    my @A = ($a =~ /([-.]|\d+|[^-.\d]+)/g);
+    my @B = ($b =~ /([-.]|\d+|[^-.\d]+)/g);
+
+    my ($A, $B);
+    while (@A and @B) {
+        $A = shift @A;
+        $B = shift @B;
+        if ($A eq '-' and $B eq '-') {
+            next;
+        } elsif ( $A eq '-' ) {
+            return -1;
+        } elsif ( $B eq '-') {
+            return 1;
+        } elsif ($A eq '.' and $B eq '.') {
+            next;
+        } elsif ( $A eq '.' ) {
+            return -1;
+        } elsif ( $B eq '.' ) {
+            return 1;
+        } elsif ($A =~ /^\d+$/ and $B =~ /^\d+$/) {
+            if ($A =~ /^0/ || $B =~ /^0/) {
+                return $A cmp $B if $A cmp $B;
+            } else {
+                return $A <=> $B if $A <=> $B;
+            }
+        } else {
+            $A = uc $A;
+            $B = uc $B;
+            return $A cmp $B if $A cmp $B;
+        }
+    }
+    @A <=> @B;
+}
+
+sub no_checksetup_from_cgi {
+    print "Content-Type: text/html; charset=UTF-8\r\n\r\n";
+    print install_string('no_checksetup_from_cgi');
+    exit;
+}
+
+######################
+# Helper Subroutines #
+######################
+
+# Used by install_string
+sub _get_string_from_file {
+    my ($string_id, $file) = @_;
+    # If we already loaded the file, then use its copy from the cache.
+    if (my $strings = _cache()->{strings_from_file}->{$file}) {
+        return $strings->{$string_id};
+    }
+
+    # This module is only needed by checksetup.pl,
+    # so only load it when needed.
+    require Safe;
+
+    return undef if !-e $file;
+    my $safe = new Safe;
+    $safe->rdo($file);
+    my %strings = %{$safe->varglob('strings')};
+    _cache()->{strings_from_file}->{$file} = \%strings;
+    return $strings{$string_id};
+}
+
+# Make an ordered list out of a HTTP Accept-Language header (see RFC 2616, 14.4)
+# We ignore '*' and <language-range>;q=0
+# For languages with the same priority q the order remains unchanged.
+sub _sort_accept_language {
+    sub sortQvalue { $b->{'qvalue'} <=> $a->{'qvalue'} }
+    my $accept_language = $_[0];
+
+    # clean up string.
+    $accept_language =~ s/[^A-Za-z;q=0-9\.\-,]//g;
+    my @qlanguages;
+    my @languages;
+    foreach(split /,/, $accept_language) {
+        if (m/([A-Za-z\-]+)(?:;q=(\d(?:\.\d+)))?/) {
+            my $lang   = $1;
+            my $qvalue = $2;
+            $qvalue = 1 if not defined $qvalue;
+            next if $qvalue == 0;
+            $qvalue = 1 if $qvalue > 1;
+            push(@qlanguages, {'qvalue' => $qvalue, 'language' => $lang});
+        }
+    }
+
+    return map($_->{'language'}, (sort sortQvalue @qlanguages));
+}
+
+sub get_console_locale {
+    require Locale::Language;
+    my $locale = setlocale(LC_CTYPE);
+    my $language;
+    # Some distros set e.g. LC_CTYPE = fr_CH.UTF-8. We clean it up.
+    if ($locale =~ /^([^\.]+)/) {
+        $locale = $1;
+    }
+    $locale =~ s/_/-/;
+    # It's pretty sure that there is no language pack of the form fr-CH
+    # installed, so we also include fr as a wanted language.
+    if ($locale =~ /^(\S+)\-/) {
+        $language = $1;
+        $locale .= ",$language";
+    }
+    else {
+        $language = $locale;
+    }
+
+    # Some OSs or distributions may have setlocale return a string of the form
+    # German_Germany.1252 (this example taken from a Windows XP system), which
+    # is unsuitable for our needs because Bugzilla works on language codes.
+    # We try and convert them here.
+    if ($language = Locale::Language::language2code($language)) {
+        $locale .= ",$language";
+    }
+
+    return $locale;
+}
+
+sub set_output_encoding {
+    # If we've already set an encoding layer on STDOUT, don't
+    # add another one.
+    my @stdout_layers = PerlIO::get_layers(STDOUT);
+    return if grep(/^encoding/, @stdout_layers);
+
+    my $encoding;
+    if (ON_WINDOWS and eval { require Win32::Console }) {
+        # Although setlocale() works on Windows, it doesn't always return
+        # the current *console's* encoding. So we use OutputCP here instead,
+        # when we can.
+        $encoding = Win32::Console::OutputCP();
+    }
+    else {
+        my $locale = setlocale(LC_CTYPE);
+        if ($locale =~ /\.([^\.]+)$/) {
+            $encoding = $1;
+        }
+    }
+    $encoding = "cp$encoding" if ON_WINDOWS;
+
+    $encoding = Encode::resolve_alias($encoding) if $encoding;
+    if ($encoding and $encoding !~ /utf-8/i) {
+        binmode STDOUT, ":encoding($encoding)";
+        binmode STDERR, ":encoding($encoding)";
+    }
+    else {
+        binmode STDOUT, ':utf8';
+        binmode STDERR, ':utf8';
+    }
+}
+
+sub init_console {
+    eval { ON_WINDOWS && require Win32::Console::ANSI; };
+    $ENV{'ANSI_COLORS_DISABLED'} = 1 if ($@ || !-t *STDOUT);
+    $SIG{__DIE__} = \&_console_die;
+    prevent_windows_dialog_boxes();
+    set_output_encoding();
+}
+
+sub _console_die {
+    my ($message) = @_;
+    # $^S means "we are in an eval"
+    if ($^S) {
+        die $message;
+    }
+    # Remove newlines from the message before we color it, and then
+    # add them back in on display. Otherwise the ANSI escape code
+    # for resetting the color comes after the newline, and Perl thinks
+    # that it should put "at Bugzilla/Install.pm line 1234" after the
+    # message.
+    $message =~ s/\n+$//;
+    # We put quotes around the message to stringify any object exceptions,
+    # like Template::Exception.
+    die colored("$message", COLOR_ERROR) . "\n";
+}
+
+sub success {
+    my ($message) = @_;
+    print colored($message, COLOR_SUCCESS), "\n";
+}
+
+sub prevent_windows_dialog_boxes {
+    # This code comes from http://bugs.activestate.com/show_bug.cgi?id=82183
+    # and prevents Perl modules from popping up dialog boxes, particularly
+    # during checksetup (since loading DBD::Oracle during checksetup when
+    # Oracle isn't installed causes a scary popup and pauses checksetup).
+    #
+    # Win32::API ships with ActiveState by default, though there could 
+    # theoretically be a Windows installation without it, I suppose.
+    if (ON_WINDOWS and eval { require Win32::API }) {
+        # Call kernel32.SetErrorMode with arguments that mean:
+        # "The system does not display the critical-error-handler message box.
+        # Instead, the system sends the error to the calling process." and
+        # "A child process inherits the error mode of its parent process."
+        my $SetErrorMode = Win32::API->new('kernel32', 'SetErrorMode', 
+                                           'I', 'I');
+        my $SEM_FAILCRITICALERRORS = 0x0001;
+        my $SEM_NOGPFAULTERRORBOX  = 0x0002;
+        $SetErrorMode->Call($SEM_FAILCRITICALERRORS | $SEM_NOGPFAULTERRORBOX);
+    }
+}
+
+# This is like request_cache, but it's used only by installation code
+# for checksetup.pl and things like that.
+our $_cache = {};
+sub _cache {
+    # If the normal request_cache is available (which happens any time
+    # after the requirements phase) then we should use that.
+    if (eval { Bugzilla->request_cache; }) {
+        return Bugzilla->request_cache;
+    }
+    return $_cache;
+}
+
+###############################
+# Copied from Bugzilla::Util #
+##############################
+
+sub trick_taint {
+    require Carp;
+    Carp::confess("Undef to trick_taint") unless defined $_[0];
+    my $match = $_[0] =~ /^(.*)$/s;
+    $_[0] = $match ? $1 : undef;
+    return (defined($_[0]));
+}
+
+sub trim {
+    my ($str) = @_;
+    if ($str) {
+      $str =~ s/^\s+//g;
+      $str =~ s/\s+$//g;
+    }
+    return $str;
+}
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Install::Util - Utility functions that are useful both during
+installation and afterwards.
+
+=head1 DESCRIPTION
+
+This module contains various subroutines that are used primarily
+during installation. However, these subroutines can also be useful to
+non-installation code, so they have been split out into this module.
+
+The difference between this module and L<Bugzilla::Util> is that this
+module is safe to C<use> anywhere in Bugzilla, even during installation,
+because it depends only on L<Bugzilla::Constants> and built-in perl modules.
+
+None of the subroutines are exported by default--you must explicitly
+export them.
+
+=head1 SUBROUTINES
+
+=over
+
+=item C<bin_loc>
+
+On *nix systems, given the name of a binary, returns the path to that
+binary, if the binary is in the C<PATH>.
+
+=item C<get_version_and_os>
+
+Returns a hash containing information about what version of Bugzilla we're
+running, what perl version we're using, and what OS we're running on.
+
+=item C<get_console_locale>
+
+Returns the language to use based on the LC_CTYPE value returned by the OS.
+If LC_CTYPE is of the form fr-CH, then fr is appended to the list.
+
+=item C<init_console>
+
+Sets the C<ANSI_COLORS_DISABLED> and C<HTTP_ACCEPT_LANGUAGE> environment variables.
+
+=item C<indicate_progress>
+
+=over
+
+=item B<Description>
+
+This prints out lines of dots as a long update is going on, to let the user
+know where we are and that we're not frozen. A new line of dots will start
+every 60 dots.
+
+Sample usage: C<indicate_progress({ total =E<gt> $total, current =E<gt>
+$count, every =E<gt> 1 })>
+
+=item B<Sample Output>
+
+Here's some sample output with C<total = 1000> and C<every = 10>:
+
+ ............................................................600/1000 (60%)
+ ........................................
+
+=item B<Params>
+
+=over
+
+=item C<total> - The total number of items we're processing.
+
+=item C<current> - The number of the current item we're processing.
+
+=item C<every> - How often the function should print out a dot.
+For example, if this is 10, the function will print out a dot every
+ten items. Defaults to 1 if not specified.
+
+=back
+
+=item B<Returns>: nothing
+
+=back
+
+=item C<install_string>
+
+=over
+
+=item B<Description>
+
+This is a very simple method of templating strings for installation.
+It should only be used by code that has to run before the Template Toolkit
+can be used. (See the comments at the top of the various L<Bugzilla::Install>
+modules to find out when it's safe to use Template Toolkit.)
+
+It pulls strings out of the F<strings.txt.pl> "template" and replaces
+any variable surrounded by double-hashes (##) with a value you specify.
+
+This allows for localization of strings used during installation.
+
+=item B<Example>
+
+Let's say your template string looks like this:
+
+ The ##animal## jumped over the ##plant##.
+
+Let's say that string is called 'animal_jump_plant'. So you call the function
+like this:
+
+ install_string('animal_jump_plant', { animal => 'fox', plant => 'tree' });
+
+That will output this:
+
+ The fox jumped over the tree.
+
+=item B<Params>
+
+=over
+
+=item C<$string_id> - The name of the string from F<strings.txt.pl>.
+
+=item C<$vars> - A hashref containing the replacement values for variables
+inside of the string.
+
+=back
+
+=item B<Returns>: The appropriate string, with variables replaced.
+
+=back
+
+=item C<template_include_path>
+
+Used by L<Bugzilla::Template> and L</install_string> to determine the
+directories where templates are installed. Templates can be installed
+in many places. They're listed here in the basic order that they're
+searched:
+
+=over
+
+=item extensions/C<$extension>/template/C<$language>/C<$project>
+
+=item extensions/C<$extension>/template/C<$language>/custom
+
+=item extensions/C<$extension>/template/C<$language>/default
+
+=item template/C<$language>/C<$project>
+
+=item template/C<$language>/custom
+
+=item template/C<$language>/default
+
+=back
+
+C<$project> has to do with installations that are using the C<$ENV{PROJECT}>
+variable to have different "views" on a single Bugzilla.
+
+The F<default> directory includes templates shipped with Bugzilla.
+
+The F<custom> directory is a directory for local installations to override
+the F<default> templates. Any individual template in F<custom> will
+override a template of the same name and path in F<default>.
+
+C<$language> is a language code, C<en> being the default language shipped
+with Bugzilla. Localizers ship other languages.
+
+C<$extension> is the name of any directory in the F<extensions/> directory.
+Each extension has its own directory.
+
+Note that languages are sorted by the user's preference (as specified
+in their browser, usually), and extensions are sorted alphabetically.
+
+=item C<include_languages>
+
+Used by L<Bugzilla::Template> to determine the languages' list which 
+are compiled with the browser's I<Accept-Language> and the languages 
+of installed templates.
+
+=item C<vers_cmp>
+
+=over
+
+=item B<Description>
+
+This is a comparison function, like you would use in C<sort>, except that
+it compares two version numbers. So, for example, 2.10 would be greater
+than 2.2.
+
+It's based on versioncmp from L<Sort::Versions>, with some Bugzilla-specific
+fixes.
+
+=item B<Params>: C<$a> and C<$b> - The versions you want to compare.
+
+=item B<Returns>
+
+C<-1> if C<$a> is less than C<$b>, C<0> if they are equal, or C<1> if C<$a>
+is greater than C<$b>.
+
+=back
+
+=back

diff --git a/Bugzilla/Job/Mailer.pm b/Bugzilla/Job/Mailer.pm
new file mode 100644 (file)
index 0000000..958089e
--- /dev/null
+++ b/Bugzilla/Job/Mailer.pm
@@ -0,0 +1,42 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Job::Mailer;
+use strict;
+use Bugzilla::Mailer;
+BEGIN { eval "use base qw(TheSchwartz::Worker)"; }
+
+# The longest we expect a job to possibly take, in seconds.
+use constant grab_for => 300;
+# We don't want email to fail permanently very easily. Retry for 30 days.
+use constant max_retries => 725;
+
+# The first few retries happen quickly, but after that we wait an hour for
+# each retry.
+sub retry_delay {
+    my ($class, $num_retries) = @_;
+    if ($num_retries < 5) {
+        return (10, 30, 60, 300, 600)[$num_retries];
+    }
+    # One hour
+    return 60*60;
+}
+
+sub work {
+    my ($class, $job) = @_;
+    my $msg = $job->arg->{msg};
+    my $success = eval { MessageToMTA($msg, 1); 1; };
+    if (!$success) {
+        $job->failed($@);
+        undef $@;
+    } 
+    else {
+        $job->completed;
+    }
+}
+
+1;

diff --git a/Bugzilla/JobQueue.pm b/Bugzilla/JobQueue.pm
new file mode 100644 (file)
index 0000000..2c3d8a7
--- /dev/null
+++ b/Bugzilla/JobQueue.pm
@@ -0,0 +1,180 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::JobQueue;
+
+use strict;
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Install::Util qw(install_string);
+use File::Basename;
+use File::Slurp;
+use base qw(TheSchwartz);
+use fields qw(_worker_pidfile);
+
+# This maps job names for Bugzilla::JobQueue to the appropriate modules.
+# If you add new types of jobs, you should add a mapping here.
+use constant JOB_MAP => {
+    send_mail => 'Bugzilla::Job::Mailer',
+};
+
+# Without a driver cache TheSchwartz opens a new database connection
+# for each email it sends.  This cached connection doesn't persist
+# across requests.
+use constant DRIVER_CACHE_TIME => 300; # 5 minutes
+
+sub job_map {
+    if (!defined(Bugzilla->request_cache->{job_map})) {
+        my $job_map = JOB_MAP;
+        Bugzilla::Hook::process('job_map', { job_map => $job_map });
+        Bugzilla->request_cache->{job_map} = $job_map;
+    }
+    
+    return Bugzilla->request_cache->{job_map};
+}
+
+sub new {
+    my $class = shift;
+
+    if (!Bugzilla->feature('jobqueue')) {
+        ThrowUserError('feature_disabled', { feature => 'jobqueue' });
+    }
+
+    my $lc = Bugzilla->localconfig;
+    # We need to use the main DB as TheSchwartz module is going
+    # to write to it.
+    my $self = $class->SUPER::new(
+        databases => [{
+            dsn    => Bugzilla->dbh_main->{private_bz_dsn},
+            user   => $lc->{db_user},
+            pass   => $lc->{db_pass},
+            prefix => 'ts_',
+        }],
+        driver_cache_expiration => DRIVER_CACHE_TIME,
+        prioritize => 1,
+    );
+
+    return $self;
+}
+
+# A way to get access to the underlying databases directly.
+sub bz_databases {
+    my $self = shift;
+    my @hashes = keys %{ $self->{databases} };
+    return map { $self->driver_for($_) } @hashes;
+}
+
+# inserts a job into the queue to be processed and returns immediately
+sub insert {
+    my $self = shift;
+    my $job = shift;
+
+    if (!ref($job)) {
+        my $mapped_job = Bugzilla::JobQueue->job_map()->{$job};
+        ThrowCodeError('jobqueue_no_job_mapping', { job => $job })
+            if !$mapped_job;
+
+        $job = new TheSchwartz::Job(
+            funcname => $mapped_job,
+            arg      => $_[0],
+            priority => $_[1] || 5
+        );
+    }
+    
+    my $retval = $self->SUPER::insert($job);
+    # XXX Need to get an error message here if insert fails, but
+    # I don't see any way to do that in TheSchwartz.
+    ThrowCodeError('jobqueue_insert_failed', { job => $job, errmsg => $@ })
+        if !$retval;
+ 
+    return $retval;
+}
+
+# To avoid memory leaks/fragmentation which tends to happen for long running
+# perl processes; check for jobs, and spawn a new process to empty the queue.
+sub subprocess_worker {
+    my $self = shift;
+
+    my $command = "$0 -d -p '" . $self->{_worker_pidfile} . "' onepass";
+
+    while (1) {
+        my $time = (time);
+        my @jobs = $self->list_jobs({
+            funcname      => $self->{all_abilities},
+            run_after     => $time,
+            grabbed_until => $time,
+            limit         => 1,
+        });
+        if (@jobs) {
+            $self->debug("Spawning queue worker process");
+            # Run the worker as a daemon
+            system $command;
+            # And poll the PID to detect when the working has finished.
+            # We do this instead of system() to allow for the INT signal to
+            # interrup us and trigger kill_worker().
+            my $pid = read_file($self->{_worker_pidfile}, err_mode => 'quiet');
+            if ($pid) {
+                sleep(3) while(kill(0, $pid));
+            }
+            $self->debug("Queue worker process completed");
+        } else {
+            $self->debug("No jobs found");
+        }
+        sleep(5);
+    }
+}
+
+sub kill_worker {
+    my $self = Bugzilla->job_queue();
+    if ($self->{_worker_pidfile} && -e $self->{_worker_pidfile}) {
+        my $worker_pid = read_file($self->{_worker_pidfile});
+        if ($worker_pid && kill(0, $worker_pid)) {
+            $self->debug("Stopping worker process");
+            system "$0 -f -p '" . $self->{_worker_pidfile} . "' stop";
+        }
+    }
+}
+
+sub set_pidfile {
+    my ($self, $pidfile) = @_;
+    $self->{_worker_pidfile} = bz_locations->{'datadir'} .
+                               '/worker-' . basename($pidfile);
+}
+
+# Clear the request cache at the start of each run.
+sub work_once {
+    my $self = shift;
+    Bugzilla->clear_request_cache();
+    return $self->SUPER::work_once(@_);
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::JobQueue - Interface between Bugzilla and TheSchwartz.
+
+=head1 SYNOPSIS
+
+ use Bugzilla;
+
+ my $obj = Bugzilla->job_queue();
+ $obj->insert('send_mail', { msg => $message });
+
+=head1 DESCRIPTION
+
+Certain tasks should be done asyncronously.  The job queue system allows
+Bugzilla to use some sort of service to schedule jobs to happen asyncronously.
+
+=head2 Inserting a Job
+
+See the synopsis above for an easy to follow example on how to insert a
+job into the queue.  Give it a name and some arguments and the job will
+be sent away to be done later.

diff --git a/Bugzilla/JobQueue/Runner.pm b/Bugzilla/JobQueue/Runner.pm
new file mode 100644 (file)
index 0000000..8b5cf9b
--- /dev/null
+++ b/Bugzilla/JobQueue/Runner.pm
@@ -0,0 +1,237 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# XXX In order to support Windows, we have to make gd_redirect_output
+# use Log4Perl or something instead of calling "logger". We probably
+# also need to use Win32::Daemon or something like that to daemonize.
+
+package Bugzilla::JobQueue::Runner;
+
+use strict;
+use Cwd qw(abs_path);
+use File::Basename;
+use File::Copy;
+use Pod::Usage;
+
+use Bugzilla::Constants;
+use Bugzilla::JobQueue;
+use Bugzilla::Util qw(get_text);
+BEGIN { eval "use base qw(Daemon::Generic)"; }
+
+our $VERSION = BUGZILLA_VERSION;
+
+# Info we need to install/uninstall the daemon.
+our $chkconfig = "/sbin/chkconfig";
+our $initd = "/etc/init.d";
+our $initscript = "bugzilla-queue";
+
+# The Daemon::Generic docs say that it uses all sorts of
+# things from gd_preconfig, but in fact it does not. The
+# only thing it uses from gd_preconfig is the "pidfile"
+# config parameter.
+sub gd_preconfig {
+    my $self = shift;
+
+    $self->{_run_command} = 'subprocess_worker';
+    my $pidfile = $self->{gd_args}{pidfile};
+    if (!$pidfile) {
+        $pidfile = bz_locations()->{datadir} . '/' . $self->{gd_progname} 
+                   . ".pid";
+    }
+    return (pidfile => $pidfile);
+}
+
+# All config other than the pidfile has to be done in gd_getopt
+# in order for it to be set up early enough.
+sub gd_getopt {
+    my $self = shift;
+
+    $self->SUPER::gd_getopt();
+
+    if ($self->{gd_args}{progname}) {
+        $self->{gd_progname} = $self->{gd_args}{progname};
+    }
+    else {
+        $self->{gd_progname} = basename($0);
+    }
+
+    # There are places that Daemon Generic's new() uses $0 instead of
+    # gd_progname, which it really shouldn't, but this hack fixes it.
+    $self->{_original_zero} = $0;
+    $0 = $self->{gd_progname};
+}
+
+sub gd_postconfig {
+    my $self = shift;
+    # See the hack above in gd_getopt. This just reverses it
+    # in case anything else needs the accurate $0.
+    $0 = delete $self->{_original_zero};
+}
+
+sub gd_more_opt {
+    my $self = shift;
+    return (
+        'pidfile=s' => \$self->{gd_args}{pidfile},
+        'n=s'       => \$self->{gd_args}{progname},
+    );
+}
+
+sub gd_usage {
+    pod2usage({ -verbose => 0, -exitval => 'NOEXIT' });
+    return 0
+}
+
+sub gd_can_install {
+    my $self = shift;
+
+    my $source_file;
+    if ( -e "/etc/SuSE-release" ) {
+        $source_file = "contrib/$initscript.suse";
+    } else {
+        $source_file = "contrib/$initscript.rhel";
+    }
+    my $dest_file = "$initd/$initscript";
+    my $sysconfig = '/etc/sysconfig';
+    my $config_file = "$sysconfig/$initscript";
+
+    if (!-x $chkconfig  or !-d $initd) {
+        return $self->SUPER::gd_can_install(@_);
+    }
+
+    return sub {
+        if (!-w $initd) {
+            print "You must run the 'install' command as root.\n";
+            return;
+        }
+        if (-e $dest_file) {
+            print "$initscript already in $initd.\n";
+        }
+        else {
+            copy($source_file, $dest_file)
+                or die "Could not copy $source_file to $dest_file: $!";
+            chmod(0755, $dest_file)
+                or die "Could not change permissions on $dest_file: $!";
+        }
+
+        system($chkconfig, '--add', $initscript);
+        print "$initscript installed.",
+              " To start the daemon, do \"$dest_file start\" as root.\n";
+
+        if (-d $sysconfig and -w $sysconfig) {
+            if (-e $config_file) {
+                print "$config_file already exists.\n";
+                return;
+            }
+
+            open(my $config_fh, ">", $config_file)
+                or die "Could not write to $config_file: $!";
+            my $directory = abs_path(dirname($self->{_original_zero}));
+            my $owner_id = (stat $self->{_original_zero})[4];
+            my $owner = getpwuid($owner_id);
+            print $config_fh <<END;
+#!/bin/sh
+BUGZILLA="$directory"
+# This user must have write access to Bugzilla's data/ directory.
+USER=$owner
+END
+            close($config_fh);
+        }
+        else {
+            print "Please edit $dest_file to configure the daemon.\n";
+        }
+    }
+}
+
+sub gd_can_uninstall {
+    my $self = shift;
+
+    if (-x $chkconfig and -d $initd) {
+        return sub {
+            if (!-e "$initd/$initscript") {
+                print "$initscript not installed.\n";
+                return;
+            }
+            system($chkconfig, '--del', $initscript);
+            print "$initscript disabled.",
+                  " To stop it, run: $initd/$initscript stop\n";
+        }
+    }
+
+    return $self->SUPER::gd_can_install(@_);
+}
+
+sub gd_check {
+    my $self = shift;
+
+    # Get a count of all the jobs currently in the queue.
+    my $jq = Bugzilla->job_queue();
+    my @dbs = $jq->bz_databases();
+    my $count = 0;
+    foreach my $driver (@dbs) {
+        $count += $driver->select_one('SELECT COUNT(*) FROM ts_job', []);
+    }
+    print get_text('job_queue_depth', { count => $count }) . "\n";
+}
+
+sub gd_setup_signals {
+    my $self = shift;
+    $self->SUPER::gd_setup_signals();
+    $SIG{TERM} = sub { $self->gd_quit_event(); }
+}
+
+sub gd_quit_event {
+    Bugzilla->job_queue->kill_worker();
+    exit(1);
+}
+
+sub gd_other_cmd {
+    my ($self, $do, $locked) = @_;
+    if ($do eq "once") {
+        $self->{_run_command} = 'work_once';
+    } elsif ($do eq "onepass") {
+        $self->{_run_command} = 'work_until_done';
+    } else {
+        $self->SUPER::gd_other_cmd($do, $locked);
+    }
+}
+
+sub gd_run {
+    my $self = shift;
+    $self->_do_work($self->{_run_command});
+}
+
+sub _do_work {
+    my ($self, $fn) = @_;
+
+    my $jq = Bugzilla->job_queue();
+    $jq->set_verbose($self->{debug});
+    $jq->set_pidfile($self->{gd_pidfile});
+    foreach my $module (values %{ Bugzilla::JobQueue->job_map() }) {
+        eval "use $module";
+        $jq->can_do($module);
+    }
+    $jq->$fn;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::JobQueue::Runner - A class representing the daemon that runs the
+job queue.
+
+=head1 SYNOPSIS
+
+ use Bugzilla::JobQueue::Runner;
+ Bugzilla::JobQueue::Runner->new();
+
+=head1 DESCRIPTION
+
+This is a subclass of L<Daemon::Generic> that is used by L<jobqueue>
+to run the Bugzilla job queue.

diff --git a/Bugzilla/Keyword.pm b/Bugzilla/Keyword.pm
new file mode 100644 (file)
index 0000000..a6e0b6d
--- /dev/null
+++ b/Bugzilla/Keyword.pm
@@ -0,0 +1,167 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+package Bugzilla::Keyword;
+
+use base qw(Bugzilla::Object);
+
+use Bugzilla::Error;
+use Bugzilla::Util;
+
+###############################
+####    Initialization     ####
+###############################
+
+use constant DB_COLUMNS => qw(
+   keyworddefs.id
+   keyworddefs.name
+   keyworddefs.description
+);
+
+use constant DB_TABLE => 'keyworddefs';
+
+use constant VALIDATORS => {
+    name        => \&_check_name,
+    description => \&_check_description,
+};
+
+use constant UPDATE_COLUMNS => qw(
+    name
+    description
+);
+
+###############################
+####      Accessors      ######
+###############################
+
+sub description       { return $_[0]->{'description'}; }
+
+sub bug_count {
+    my ($self) = @_;
+    return $self->{'bug_count'} if defined $self->{'bug_count'};
+    ($self->{'bug_count'}) =
+      Bugzilla->dbh->selectrow_array(
+          'SELECT COUNT(*) FROM keywords WHERE keywordid = ?', 
+          undef, $self->id);
+    return $self->{'bug_count'};
+}
+
+###############################
+####       Mutators       #####
+###############################
+
+sub set_name        { $_[0]->set('name', $_[1]); }
+sub set_description { $_[0]->set('description', $_[1]); }
+
+###############################
+####      Subroutines    ######
+###############################
+
+sub get_all_with_bug_count {
+    my $class = shift;
+    my $dbh = Bugzilla->dbh;
+    my $keywords =
+      $dbh->selectall_arrayref('SELECT ' 
+                                      . join(', ', $class->_get_db_columns) . ',
+                                       COUNT(keywords.bug_id) AS bug_count
+                                  FROM keyworddefs
+                             LEFT JOIN keywords
+                                    ON keyworddefs.id = keywords.keywordid ' .
+                                  $dbh->sql_group_by('keyworddefs.id',
+                                                     'keyworddefs.name,
+                                                      keyworddefs.description') . '
+                                 ORDER BY keyworddefs.name', {'Slice' => {}});
+    if (!$keywords) {
+        return [];
+    }
+    
+    foreach my $keyword (@$keywords) {
+        bless($keyword, $class);
+    }
+    return $keywords;
+}
+
+###############################
+###       Validators        ###
+###############################
+
+sub _check_name {
+    my ($self, $name) = @_;
+
+    $name = trim($name);
+    if (!defined $name or $name eq "") {
+        ThrowUserError("keyword_blank_name");
+    }
+    if ($name =~ /[\s,]/) {
+        ThrowUserError("keyword_invalid_name");
+    }
+
+    # We only want to validate the non-existence of the name if
+    # we're creating a new Keyword or actually renaming the keyword.
+    if (!ref($self) || $self->name ne $name) {
+        my $keyword = new Bugzilla::Keyword({ name => $name });
+        ThrowUserError("keyword_already_exists", { name => $name }) if $keyword;
+    }
+
+    return $name;
+}
+
+sub _check_description {
+    my ($self, $desc) = @_;
+    $desc = trim($desc);
+    if (!defined $desc or $desc eq '') {
+        ThrowUserError("keyword_blank_description");
+    }
+    return $desc;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Keyword - A Keyword that can be added to a bug.
+
+=head1 SYNOPSIS
+
+ use Bugzilla::Keyword;
+
+ my $description = $keyword->description;
+
+ my $keywords = Bugzilla::Keyword->get_all_with_bug_count();
+
+=head1 DESCRIPTION
+
+Bugzilla::Keyword represents a keyword that can be added to a bug.
+
+This implements all standard C<Bugzilla::Object> methods. See 
+L<Bugzilla::Object> for more details.
+
+=head1 SUBROUTINES
+
+This is only a list of subroutines specific to C<Bugzilla::Keyword>.
+See L<Bugzilla::Object> for more subroutines that this object 
+implements.
+
+=over
+
+=item C<get_all_with_bug_count()> 
+
+ Description: Returns all defined keywords. This is an efficient way
+              to get the associated bug counts, as only one SQL query
+              is executed with this method, instead of one per keyword
+              when calling get_all and then bug_count.
+ Params:      none
+ Returns:     A reference to an array of Keyword objects, or an empty
+              arrayref if there are no keywords.
+
+=back
+
+=cut

diff --git a/Bugzilla/Mailer.pm b/Bugzilla/Mailer.pm
new file mode 100644 (file)
index 0000000..6464015
--- /dev/null
+++ b/Bugzilla/Mailer.pm
@@ -0,0 +1,208 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Mailer;
+
+use strict;
+
+use base qw(Exporter);
+@Bugzilla::Mailer::EXPORT = qw(MessageToMTA build_thread_marker);
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Hook;
+use Bugzilla::Util;
+
+use Date::Format qw(time2str);
+
+use Encode qw(encode);
+use Encode::MIME::Header;
+use Email::Address;
+use Email::MIME;
+# Return::Value 1.666002 pollutes the error log with warnings about this
+# deprecated module. We have to set NO_CLUCK = 1 before loading Email::Send
+# to disable these warnings.
+BEGIN {
+    $Return::Value::NO_CLUCK = 1;
+}
+use Email::Send;
+
+sub MessageToMTA {
+    my ($msg, $send_now) = (@_);
+    my $method = Bugzilla->params->{'mail_delivery_method'};
+    return if $method eq 'None';
+
+    if (Bugzilla->params->{'use_mailer_queue'} and !$send_now) {
+        Bugzilla->job_queue->insert('send_mail', { msg => $msg });
+        return;
+    }
+
+    my $email;
+    if (ref $msg) {
+        $email = $msg;
+    }
+    else {
+        # RFC 2822 requires us to have CRLF for our line endings and
+        # Email::MIME doesn't do this for us. We use \015 (CR) and \012 (LF)
+        # directly because Perl translates "\n" depending on what platform
+        # you're running on. See http://perldoc.perl.org/perlport.html#Newlines
+        # We check for multiple CRs because of this Template-Toolkit bug:
+        # https://rt.cpan.org/Ticket/Display.html?id=43345
+        $msg =~ s/(?:\015+)?\012/\015\012/msg;
+        $email = new Email::MIME($msg);
+    }
+
+    # We add this header to uniquely identify all email that we
+    # send as coming from this Bugzilla installation.
+    #
+    # We don't use correct_urlbase, because we want this URL to
+    # *always* be the same for this Bugzilla, in every email,
+    # even if the admin changes the "ssl_redirect" parameter some day.
+    $email->header_set('X-Bugzilla-URL', Bugzilla->params->{'urlbase'});
+    
+    # We add this header to mark the mail as "auto-generated" and
+    # thus to hopefully avoid auto replies.
+    $email->header_set('Auto-Submitted', 'auto-generated');
+
+    # MIME-Version must be set otherwise some mailsystems ignore the charset
+    $email->header_set('MIME-Version', '1.0') if !$email->header('MIME-Version');
+
+    # Encode the headers correctly in quoted-printable
+    foreach my $header ($email->header_names) {
+        my @values = $email->header($header);
+        # We don't recode headers that happen multiple times.
+        next if scalar(@values) > 1;
+        if (my $value = $values[0]) {
+            if (Bugzilla->params->{'utf8'} && !utf8::is_utf8($value)) {
+                utf8::decode($value);
+            }
+
+            # avoid excessive line wrapping done by Encode.
+            local $Encode::Encoding{'MIME-Q'}->{'bpl'} = 998;
+
+            my $encoded = encode('MIME-Q', $value);
+            $email->header_set($header, $encoded);
+        }
+    }
+
+    my $from = $email->header('From');
+
+    my ($hostname, @args);
+    my $mailer_class = $method;
+    if ($method eq "Sendmail") {
+        $mailer_class = 'Bugzilla::Send::Sendmail';
+        if (ON_WINDOWS) {
+            $Email::Send::Sendmail::SENDMAIL = SENDMAIL_EXE;
+        }
+        push @args, "-i";
+        # We want to make sure that we pass *only* an email address.
+        if ($from) {
+            my ($email_obj) = Email::Address->parse($from);
+            if ($email_obj) {
+                my $from_email = $email_obj->address;
+                push(@args, "-f$from_email") if $from_email;
+            }
+        }
+    }
+    else {
+        # Sendmail will automatically append our hostname to the From
+        # address, but other mailers won't.
+        my $urlbase = Bugzilla->params->{'urlbase'};
+        $urlbase =~ m|//([^:/]+)[:/]?|;
+        $hostname = $1;
+        $from .= "\@$hostname" if $from !~ /@/;
+        $email->header_set('From', $from);
+        
+        # Sendmail adds a Date: header also, but others may not.
+        if (!defined $email->header('Date')) {
+            $email->header_set('Date', time2str("%a, %d %b %Y %T %z", time()));
+        }
+    }
+
+    if ($method eq "SMTP") {
+        push @args, Host  => Bugzilla->params->{"smtpserver"},
+                    username => Bugzilla->params->{"smtp_username"},
+                    password => Bugzilla->params->{"smtp_password"},
+                    Hello => $hostname, 
+                    ssl => Bugzilla->params->{'smtp_ssl'},
+                    Debug => Bugzilla->params->{'smtp_debug'};
+    }
+
+    Bugzilla::Hook::process('mailer_before_send', 
+                            { email => $email, mailer_args => \@args });
+
+    $email->walk_parts(sub {
+        my ($part) = @_;
+        return if $part->parts > 1; # Top-level
+        my $content_type = $part->content_type || '';
+        $content_type =~ /charset=['"](.+)['"]/;
+        # If no charset is defined or is the default us-ascii,
+        # then we encode the email to UTF-8 if Bugzilla has utf8 enabled.
+        # XXX - This is a hack to workaround bug 723944.
+        if (!$1 || $1 eq 'us-ascii') {
+            my $body = $part->body;
+            if (Bugzilla->params->{'utf8'}) {
+                $part->charset_set('UTF-8');
+                # encoding_set works only with bytes, not with utf8 strings.
+                my $raw = $part->body_raw;
+                if (utf8::is_utf8($raw)) {
+                    utf8::encode($raw);
+                    $part->body_set($raw);
+                }
+            }
+            $part->encoding_set('quoted-printable') if !is_7bit_clean($body);
+        }
+    });
+
+    if ($method eq "Test") {
+        my $filename = bz_locations()->{'datadir'} . '/mailer.testfile';
+        open TESTFILE, '>>', $filename;
+        # From - <date> is required to be a valid mbox file.
+        print TESTFILE "\n\nFrom - " . $email->header('Date') . "\n" . $email->as_string;
+        close TESTFILE;
+    }
+    else {
+        # This is useful for both Sendmail and Qmail, so we put it out here.
+        local $ENV{PATH} = SENDMAIL_PATH;
+        my $mailer = Email::Send->new({ mailer => $mailer_class, 
+                                        mailer_args => \@args });
+        my $retval = $mailer->send($email);
+        ThrowCodeError('mail_send_error', { msg => $retval, mail => $email })
+            if !$retval;
+    }
+}
+
+# Builds header suitable for use as a threading marker in email notifications
+sub build_thread_marker {
+    my ($bug_id, $user_id, $is_new) = @_;
+
+    if (!defined $user_id) {
+        $user_id = Bugzilla->user->id;
+    }
+
+    my $sitespec = '@' . Bugzilla->params->{'urlbase'};
+    $sitespec =~ s/:\/\//\./; # Make the protocol look like part of the domain
+    $sitespec =~ s/^([^:\/]+):(\d+)/$1/; # Remove a port number, to relocate
+    if ($2) {
+        $sitespec = "-$2$sitespec"; # Put the port number back in, before the '@'
+    }
+
+    my $threadingmarker;
+    if ($is_new) {
+        $threadingmarker = "Message-ID: <bug-$bug_id-$user_id$sitespec>";
+    }
+    else {
+        my $rand_bits = generate_random_password(10);
+        $threadingmarker = "Message-ID: <bug-$bug_id-$user_id-$rand_bits$sitespec>" .
+                           "\nIn-Reply-To: <bug-$bug_id-$user_id$sitespec>" .
+                           "\nReferences: <bug-$bug_id-$user_id$sitespec>";
+    }
+
+    return $threadingmarker;
+}
+
+1;

diff --git a/Bugzilla/Migrate.pm b/Bugzilla/Migrate.pm
new file mode 100644 (file)
index 0000000..75552c2
--- /dev/null
+++ b/Bugzilla/Migrate.pm
@@ -0,0 +1,1160 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Migrate;
+use strict;
+
+use Bugzilla::Attachment;
+use Bugzilla::Bug qw(LogActivityEntry);
+use Bugzilla::Component;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Install::Requirements ();
+use Bugzilla::Install::Util qw(indicate_progress);
+use Bugzilla::Product;
+use Bugzilla::Util qw(get_text trim generate_random_password say);
+use Bugzilla::User ();
+use Bugzilla::Status ();
+use Bugzilla::Version;
+
+use Data::Dumper;
+use Date::Parse;
+use DateTime;
+use Fcntl qw(SEEK_SET);
+use File::Basename;
+use List::Util qw(first);
+use Safe;
+
+use constant CUSTOM_FIELDS      => {};
+use constant REQUIRED_MODULES   => [];
+use constant NON_COMMENT_FIELDS => ();
+
+use constant CONFIG_VARS => (
+    {
+        name    => 'translate_fields',
+        default => {},
+        desc    => <<'END',
+# This maps field names in your bug-tracker to Bugzilla field names. If a field
+# has the same name in your bug-tracker and Bugzilla (case-insensitively), it
+# doesn't need a mapping here. If a field isn't listed here and doesn't have
+# an equivalent field in Bugzilla, its data will be added to the initial
+# description of each bug migrated. If the right side is an empty string, it
+# means "just put the value of this field into the initial description of the
+# bug".
+#
+# Generally, you can keep the defaults, here.
+#
+# If you want to know the internal names of various Bugzilla fields
+# (as used on the right side here), see the fielddefs table in the Bugzilla
+# database.
+#
+# If you are mapping to any custom fields in Bugzilla, you have to create
+# the custom fields using Bugzilla Administration interface before you run
+# migrate.pl. However, if they are drop down or multi-select fields, you 
+# don't have to populate the list of values--migrate.pl will do that for you.
+# Some migrators create certain custom fields by default. If you see a
+# field name starting with "cf_" on the right side of this configuration
+# variable by default, then that field will be automatically created by
+# the migrator and you don't have to worry about it.
+END
+    },
+    {
+        name    => 'translate_values',
+        default => {},
+        desc    => <<'END',
+# This configuration variable allows you to say that a particular field
+# value in your current bug-tracker should be translated to a different
+# value when it's imported into Bugzilla.
+#
+# The value of this variable should look something like this:
+#
+# {
+#     bug_status => {
+#         # Translate "Handled" into "RESOLVED".
+#         "Handled"     => "RESOLVED",
+#         "In Progress" => "IN_PROGRESS",
+#     },
+#
+#     priority => {
+#         # Translate "Serious" into "Highest"
+#         "Serious" => "Highest",
+#     },
+# };
+#
+# Values are translated case-insensitively, so "foo" will match "Foo", "FOO",
+# and "foo".
+#
+# Note that the field names used are *Bugzilla* field names (from the fielddefs
+# table in the database), not the field names from your current bug-tracker.
+#
+# The special field name "user" will be used to translate any field that
+# can contain a user, including reporter, assigned_to, qa_contact, and cc.
+# You should use "user" instead of specifying reporter, assigned_to, etc.
+# manually.
+#
+# The special field "bug_status_resolution" can be used to give certain
+# statuses in your bug-tracker a resolution in Bugzilla. So, for example,
+# you could translate the "fixed" status in your Bugzilla to "RESOLVED"
+# in the "bug_status" field, and then put "fixed => 'FIXED'" in the
+# "bug_status_resolution" field to translated a "fixed" bug into
+# RESOLVED FIXED in Bugzilla.
+#
+# Values that don't get translated will be imported as-is.
+END
+    },
+    {
+        name    => 'starting_bug_id',
+        default => 0,
+        desc    => <<'END',
+# What bug ID do you want the first imported bug to get? If you set this to
+# 0, then the imported bug ids will just start right after the current
+# bug ids. If you use this configuration variable, you must make sure that
+# nobody else is using your Bugzilla while you run the migration, or a new
+# bug filed by a user might take this ID instead.
+END
+    },
+    {
+        name    => 'timezone',
+        default => 'local',
+        desc => <<'END',
+# If migrate.pl comes across any dates without timezones, while doing the
+# migration, what timezone should we assume those dates are in? 
+# The best format for this variable is something like "America/Los Angeles".
+# However, time zone abbreviations (like PST, PDT, etc.) are also acceptable,
+# but will result in a less-accurate conversion of times and dates.
+#
+# The special value "local" means "use the same timezone as the system I
+# am running this script on now".
+END
+    },
+);
+
+use constant USER_FIELDS => qw(user assigned_to qa_contact reporter cc);
+
+#########################
+# Main Migration Method #
+#########################
+
+sub do_migration {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+    # On MySQL, setting serial values implicitly commits a transaction,
+    # so we want to do it up here, outside of any transaction. This also
+    # has the advantage of loading the config before anything else is done.
+    if ($self->config('starting_bug_id')) {
+        $dbh->bz_set_next_serial_value('bugs', 'bug_id',
+                                       $self->config('starting_bug_id'));
+    }    
+    $dbh->bz_start_transaction();
+
+    # Read Other Database
+    my $users    = $self->users;
+    my $products = $self->products;
+    my $bugs     = $self->bugs;
+    $self->after_read();
+    
+    $self->translate_all_bugs($bugs);
+
+    Bugzilla->set_user(Bugzilla::User->super_user);
+    
+    # Insert into Bugzilla
+    $self->before_insert();
+    $self->insert_users($users);
+    $self->insert_products($products);
+    $self->create_custom_fields();
+    $self->create_legal_values($bugs);
+    $self->insert_bugs($bugs);
+    $self->after_insert();
+    if ($self->dry_run) {
+        $dbh->bz_rollback_transaction();
+        $self->reset_serial_values();
+    }
+    else {
+        $dbh->bz_commit_transaction();
+    }
+}
+
+################
+# Constructors #
+################
+
+sub new {
+    my ($class) = @_;
+    my $self = { };
+    bless $self, $class;
+    return $self;
+}
+
+sub load {
+    my ($class, $from) = @_;
+    my $libdir = bz_locations()->{libpath};
+    my @migration_modules = glob("$libdir/Bugzilla/Migrate/*");
+    my ($module) = grep { basename($_) =~ /^\Q$from\E\.pm$/i }
+                          @migration_modules;
+    if (!$module) {
+        ThrowUserError('migrate_from_invalid', { from => $from });
+    }
+    require $module;
+    my $canonical_name = _canonical_name($module);
+    return "Bugzilla::Migrate::$canonical_name"->new;
+}
+
+#############
+# Accessors #
+#############
+
+sub name {
+    my $self = shift;
+    return _canonical_name(ref $self);
+}
+
+sub dry_run {
+    my ($self, $value) = @_;
+    if (scalar(@_) > 1) {
+        $self->{dry_run} = $value;
+    }
+    return $self->{dry_run} || 0;
+}
+
+
+sub verbose {
+    my ($self, $value) = @_;
+    if (scalar(@_) > 1) {
+        $self->{verbose} = $value;
+    }
+    return $self->{verbose} || 0;
+}
+
+sub debug {
+    my ($self, $value, $level) = @_;
+    $level ||= 1;
+    if ($self->verbose >= $level) {
+        $value = Dumper($value) if ref $value;
+        print STDERR $value, "\n";
+    }
+}
+
+sub bug_fields {
+    my $self = shift;
+    $self->{bug_fields} ||= Bugzilla->fields({ by_name => 1 });
+    return $self->{bug_fields};
+}
+
+sub users {
+    my $self = shift;
+    if (!exists $self->{users}) {
+        say get_text('migrate_reading_users');
+        $self->{users} = $self->_read_users();
+    }
+    return $self->{users};
+}
+
+sub products {
+    my $self = shift;
+    if (!exists $self->{products}) {
+        say get_text('migrate_reading_products');
+        $self->{products} = $self->_read_products();
+    }
+    return $self->{products};
+}
+
+sub bugs {
+    my $self = shift;
+    if (!exists $self->{bugs}) {
+        say get_text('migrate_reading_bugs');
+        $self->{bugs} = $self->_read_bugs();
+    }
+    return $self->{bugs};
+}
+
+###########
+# Methods #
+###########
+
+sub check_requirements {
+    my $self = shift;
+    my $missing = Bugzilla::Install::Requirements::_check_missing(
+        $self->REQUIRED_MODULES, 1);
+    my %results = (
+        apache      => [],
+        pass        => @$missing ? 0 : 1,
+        missing     => $missing,
+        any_missing => @$missing ? 1 : 0,
+        hide_all    => 1,
+        # These are just for compatibility with print_module_instructions
+        one_dbd  => 1,
+        optional => [],
+    );
+    Bugzilla::Install::Requirements::print_module_instructions(
+        \%results, 1);
+    exit(1) if @$missing;
+}
+
+sub reset_serial_values {
+    my $self = shift;
+    return if $self->{serial_values_reset};
+    my $dbh = Bugzilla->dbh;
+    my %reset = (
+        'bugs'        => 'bug_id',
+        'attachments' => 'attach_id',
+        'profiles'    => 'userid',
+        'longdescs'   => 'comment_id',
+        'products'    => 'id',
+        'components'  => 'id',
+        'versions'    => 'id',
+        'milestones'  => 'id',
+    );
+    my @select_fields = grep { $_->is_select } (values %{ $self->bug_fields });
+    foreach my $field (@select_fields) {
+        next if $field->is_abnormal;
+        $reset{$field->name} = 'id';
+    }
+    
+    while (my ($table, $column) = each %reset) {
+        $dbh->bz_set_next_serial_value($table, $column);
+    }
+    
+    $self->{serial_values_reset} = 1;
+}
+
+###################
+# Bug Translation #
+###################
+
+sub translate_all_bugs {
+    my ($self, $bugs) = @_;
+    say get_text('migrate_translating_bugs');
+    # We modify the array in place so that $self->bugs will return the
+    # modified bugs, in case $self->before_insert wants them.
+    my $num_bugs = scalar(@$bugs);
+    for (my $i = 0; $i < $num_bugs; $i++) {
+        $bugs->[$i] = $self->translate_bug($bugs->[$i]);
+    }
+}
+
+sub translate_bug {
+    my ($self, $fields) = @_;
+    my (%bug, %other_fields);
+    my $original_status;
+    foreach my $field (keys %$fields) {
+        my $value = delete $fields->{$field};
+        my $bz_field = $self->translate_field($field);
+        if ($bz_field) {
+            $bug{$bz_field} = $self->translate_value($bz_field, $value);
+            if ($bz_field eq 'bug_status') {
+                $original_status = $value;
+            }
+        }
+        else {
+            $other_fields{$field} = $value;
+        }
+    }
+    
+    if (defined $original_status and !defined $bug{resolution}
+        and $self->map_value('bug_status_resolution', $original_status))
+    {
+        $bug{resolution} = $self->map_value('bug_status_resolution',
+                                            $original_status);
+    }
+    
+    $bug{comment} = $self->_generate_description(\%bug, \%other_fields);
+    
+    return wantarray ? (\%bug, \%other_fields) : \%bug;
+}
+
+sub _generate_description {
+    my ($self, $bug, $fields) = @_;
+    
+    my $description = "";
+    foreach my $field (sort keys %$fields) {
+        next if grep($_ eq $field, $self->NON_COMMENT_FIELDS);
+        my $value = delete $fields->{$field};
+        next if $value eq '';
+        $description .= "$field: $value\n";
+    }
+    $description .= "\n" if $description;
+
+    return $description . $bug->{comment};
+}
+
+sub translate_field {
+    my ($self, $field) = @_;
+    my $mapped = $self->config('translate_fields')->{$field};
+    return $mapped if defined $mapped;
+    ($mapped) = grep { lc($_) eq lc($field) } (keys %{ $self->bug_fields });
+    return $mapped;
+}
+
+sub parse_date {
+    my ($self, $date) = @_;
+    my @time = strptime($date);
+    # Handle times with timezones that strptime doesn't know about.
+    if (!scalar @time) {
+        $date =~ s/\s+\S+$//;
+        @time = strptime($date);
+    }
+    my $tz;
+    if ($time[6]) {
+        $tz = Bugzilla->local_timezone->offset_as_string($time[6]);
+    }
+    else {
+        $tz = $self->config('timezone');
+        $tz =~ s/\s/_/g;
+        if ($tz eq 'local') {
+            $tz = Bugzilla->local_timezone;
+        }
+    }
+    my $dt = DateTime->new({
+        year   => $time[5] + 1900,
+        month  => $time[4] + 1,
+        day    => $time[3],
+        hour   => $time[2],
+        minute => $time[1],
+        second => int($time[0]),
+        time_zone => $tz, 
+    });
+    $dt->set_time_zone(Bugzilla->local_timezone);
+    return $dt->iso8601;
+}
+
+sub translate_value {
+    my ($self, $field, $value) = @_;
+    
+    if (!defined $value) {
+        warn("Got undefined value for $field\n");
+        $value = '';
+    }
+    
+    if (ref($value) eq 'ARRAY') {
+        return [ map($self->translate_value($field, $_), @$value) ];
+    }
+
+    
+    if (defined $self->map_value($field, $value)) {
+        return $self->map_value($field, $value);
+    }
+    
+    if (grep($_ eq $field, USER_FIELDS)) {
+        if (defined $self->map_value('user', $value)) {
+            return $self->map_value('user', $value);
+        }
+    }
+
+    my $field_obj = $self->bug_fields->{$field};
+    if ($field eq 'creation_ts' or $field eq 'delta_ts'
+        or ($field_obj and $field_obj->type == FIELD_TYPE_DATETIME))
+    {
+        $value = trim($value);
+        return undef if !$value;
+        return $self->parse_date($value);
+    }
+    
+    return $value;
+}
+
+
+sub map_value {
+    my ($self, $field, $value) = @_;
+    return $self->_value_map->{$field}->{lc($value)};
+}
+
+sub _value_map {
+    my $self = shift;
+    if (!defined $self->{_value_map}) {
+        # Lowercase all values to make them case-insensitive.
+        my %map;
+        my $translation = $self->config('translate_values');
+        foreach my $field (keys %$translation) {
+            my $value_mapping = $translation->{$field};
+            foreach my $value (keys %$value_mapping) {
+                $map{$field}->{lc($value)} = $value_mapping->{$value};
+            }
+        }
+        $self->{_value_map} = \%map;
+    }
+    return $self->{_value_map};
+}
+
+#################
+# Configuration #
+#################
+
+sub config {
+    my ($self, $var) = @_;
+    if (!exists $self->{config}) {
+        $self->{config} = $self->read_config;
+    }
+    return $self->{config}->{$var};
+}
+
+sub config_file_name {
+    my $self = shift;
+    my $name = $self->name;
+    my $dir = bz_locations()->{datadir};
+    return "$dir/migrate-$name.cfg"
+}
+
+sub read_config {
+    my ($self) = @_;
+    my $file = $self->config_file_name;
+    if (!-e $file) {
+        $self->write_config();
+        ThrowUserError('migrate_config_created', { file => $file });
+    }
+    open(my $fh, "<", $file) || die "$file: $!";
+    my $safe = new Safe;
+    $safe->rdo($file);
+    my @read_symbols = map($_->{name}, $self->CONFIG_VARS);
+    my %config;
+    foreach my $var (@read_symbols) {
+        my $glob = $safe->varglob($var);
+        $config{$var} = $$glob;
+    }
+    return \%config;
+}
+
+sub write_config {
+    my ($self) = @_;
+    my $file = $self->config_file_name;
+    open(my $fh, ">", $file) || die "$file: $!";
+    # Fixed indentation
+    local $Data::Dumper::Indent = 1;
+    local $Data::Dumper::Quotekeys = 0;
+    local $Data::Dumper::Sortkeys = 1;
+    foreach my $var ($self->CONFIG_VARS) {
+        print $fh "\n", $var->{desc},
+        Data::Dumper->Dump([$var->{default}], [$var->{name}]);
+    }
+    close($fh);
+}
+
+####################################
+# Default Implementations of Hooks #
+####################################
+
+sub after_insert  {}
+sub before_insert {}
+sub after_read    {}
+
+#############
+# Inserters #
+#############
+
+sub insert_users {
+    my ($self, $users) = @_;
+    foreach my $user (@$users) {
+        next if new Bugzilla::User({ name => $user->{login_name} });
+        my $generated_password;
+        if (!defined $user->{cryptpassword}) {
+            $generated_password = lc(generate_random_password());
+            $user->{cryptpassword} = $generated_password;
+        }
+        my $created = Bugzilla::User->create($user);
+        print get_text('migrate_user_created',
+                       { created  => $created,
+                         password => $generated_password }), "\n";
+    }
+}
+
+# XXX This should also insert Classifications.
+sub insert_products {
+    my ($self, $products) = @_;
+    foreach my $product (@$products) {
+        my $components = delete $product->{components};
+        
+        my $created_prod = new Bugzilla::Product({ name => $product->{name} });
+        if (!$created_prod) {
+            $created_prod = Bugzilla::Product->create($product);
+            print get_text('migrate_product_created',
+                           { created => $created_prod }), "\n";
+        }
+        
+        foreach my $component (@$components) {
+            next if new Bugzilla::Component({ product => $created_prod,
+                                              name    => $component->{name} });
+            my $created_comp = Bugzilla::Component->create(
+                { %$component, product => $created_prod });
+            print '  ', get_text('migrate_component_created',
+                                 { comp => $created_comp,
+                                   product => $created_prod }), "\n";
+        }
+    }
+}
+
+sub create_custom_fields {
+    my $self = shift;
+    foreach my $field (keys %{ $self->CUSTOM_FIELDS }) {
+        next if new Bugzilla::Field({ name => $field });
+        my %values = %{ $self->CUSTOM_FIELDS->{$field} };
+        # We set these all here for the dry-run case.
+        my $created = { %values, name => $field, custom => 1 };
+        if (!$self->dry_run) {
+            $created = Bugzilla::Field->create($created);
+        }
+        say get_text('migrate_field_created', { field => $created });
+    }
+    delete $self->{bug_fields};
+}
+
+sub create_legal_values {
+    my ($self, $bugs) = @_;
+    my @select_fields = grep($_->is_select, values %{ $self->bug_fields });
+
+    # Get all the values in use on all the bugs we're importing.
+    my (%values, %product_values);
+    foreach my $bug (@$bugs) {
+        foreach my $field (@select_fields) {
+            my $name = $field->name;
+            next if !defined $bug->{$name};
+            $values{$name}->{$bug->{$name}} = 1;
+        }
+        foreach my $field (qw(version target_milestone)) {
+            # Fix per-product bug values here, because it's easier than
+            # doing it during _insert_bugs.
+            if (!defined $bug->{$field} or trim($bug->{$field}) eq '') {
+                my $accessor = $field;
+                $accessor =~ s/^target_//; $accessor .= "s";
+                my $product = Bugzilla::Product->check($bug->{product});
+                $bug->{$field} = $product->$accessor->[0]->name;
+                next;
+            }
+            $product_values{$bug->{product}}->{$field}->{$bug->{$field}} = 1;
+        }
+    }
+    
+    foreach my $field (@select_fields) {
+        next if $field->is_abnormal;
+        my $name = $field->name;
+        foreach my $value (keys %{ $values{$name} }) {
+            next if Bugzilla::Field::Choice->type($field)->new({ name => $value });
+            Bugzilla::Field::Choice->type($field)->create({ value => $value });
+            print get_text('migrate_value_created',
+                           { field => $field, value => $value }), "\n";
+        }
+    }
+    
+    foreach my $product (keys %product_values) {
+        my $prod_obj = Bugzilla::Product->check($product);
+        foreach my $version (keys %{ $product_values{$product}->{version} }) {
+            next if new Bugzilla::Version({ product => $prod_obj,
+                                            name    => $version });
+            my $created = Bugzilla::Version->create({ product => $prod_obj,
+                                                      value   => $version });
+            my $field = $self->bug_fields->{version};
+            print get_text('migrate_value_created', { product => $prod_obj,
+                                                      field   => $field,
+                                                      value   => $created->name }), "\n";
+        }
+        foreach my $milestone (keys %{ $product_values{$product}->{target_milestone} }) {
+            next if new Bugzilla::Milestone({ product => $prod_obj,
+                                              name    => $milestone });
+            my $created = Bugzilla::Milestone->create(
+                { product => $prod_obj, value => $milestone });
+            my $field = $self->bug_fields->{target_milestone};
+            print get_text('migrate_value_created', { product => $prod_obj,
+                                                      field   => $field,
+                                                      value   => $created->name }), "\n";
+            
+        }
+    }
+    
+}
+
+sub insert_bugs {
+    my ($self, $bugs) = @_;
+    my $dbh = Bugzilla->dbh;
+    say get_text('migrate_creating_bugs');
+
+    my $init_statuses = Bugzilla::Status->can_change_to();
+    my %allowed_statuses = map { lc($_->name) => 1 } @$init_statuses;
+    # Bypass the question of whether or not we can file UNCONFIRMED
+    # in any product by simply picking a non-UNCONFIRMED status as our
+    # default for bugs that don't have a status specified.
+    my $default_status = first { $_->name ne 'UNCONFIRMED' } @$init_statuses;
+    # Use the first resolution that's not blank.
+    my $default_resolution =
+        first { $_->name ne '' }
+              @{ $self->bug_fields->{resolution}->legal_values };
+
+    # Set the values of any required drop-down fields that aren't set.
+    my @standard_drop_downs = grep { !$_->custom and $_->is_select }
+                                   (values %{ $self->bug_fields });
+    # Make bug_status get set before resolution.
+    @standard_drop_downs = sort { $a->name cmp $b->name } @standard_drop_downs;
+    # Cache all statuses for setting the resolution.
+    my %statuses = map { lc($_->name) => $_ } Bugzilla::Status->get_all;
+
+    my $total = scalar @$bugs;
+    my $count = 1;
+    foreach my $bug (@$bugs) {
+        my $comments    = delete $bug->{comments};
+        my $history     = delete $bug->{history};
+        my $attachments = delete $bug->{attachments};
+
+        $self->debug($bug, 3);
+
+        foreach my $field (@standard_drop_downs) {
+            next if $field->is_abnormal;
+            my $field_name = $field->name;
+            if (!defined $bug->{$field_name}) {
+                # If there's a default value for this, then just let create()
+                # pick it.
+                next if grep($_->is_default, @{ $field->legal_values });
+                # Otherwise, pick the first valid value if this is a required
+                # field.
+                if ($field_name eq 'bug_status') {
+                    $bug->{bug_status} = $default_status;
+                }
+                elsif ($field_name eq 'resolution') {
+                    my $status = $statuses{lc($bug->{bug_status})};
+                    if (!$status->is_open) {
+                        $bug->{resolution} =  $default_resolution;
+                    }
+                }
+                else {
+                    $bug->{$field_name} = $field->legal_values->[0]->name;
+                }
+            }
+        }
+        
+        my $product = Bugzilla::Product->check($bug->{product});
+        
+        # If this isn't a legal starting status, or if the bug has a
+        # resolution, then those will have to be set after creating the bug.
+        # We make them into objects so that we can normalize their names.
+        my ($set_status, $set_resolution);
+        if (defined $bug->{resolution}) {
+            $set_resolution = Bugzilla::Field::Choice->type('resolution')
+                              ->new({ name => delete $bug->{resolution} });
+        }
+        if (!$allowed_statuses{lc($bug->{bug_status})}) {
+            $set_status = new Bugzilla::Status({ name => $bug->{bug_status} });
+            # Set the starting status to some status that Bugzilla will
+            # accept. We're going to overwrite it immediately afterward.
+            $bug->{bug_status} = $default_status;
+        }
+        
+        # If we're in dry-run mode, our custom fields haven't been created
+        # yet, so we shouldn't try to set them on creation.
+        if ($self->dry_run) {
+            foreach my $field (keys %{ $self->CUSTOM_FIELDS }) {
+                delete $bug->{$field};
+            }
+        }
+        
+        # File the bug as the reporter.
+        my $super_user = Bugzilla->user;
+        my $reporter = Bugzilla::User->check($bug->{reporter});
+        # Allow the user to file a bug in any product, no matter his current
+        # permissions.
+        $reporter->{groups} = $super_user->groups;
+        Bugzilla->set_user($reporter);
+        my $created = Bugzilla::Bug->create($bug);
+        $self->debug('Created bug ' . $created->id);
+        Bugzilla->set_user($super_user);
+
+        if (defined $bug->{creation_ts}) {
+            $dbh->do('UPDATE bugs SET creation_ts = ?, delta_ts = ? 
+                       WHERE bug_id = ?', undef, $bug->{creation_ts},
+                     $bug->{creation_ts}, $created->id);
+        }
+        if (defined $bug->{delta_ts}) {
+            $dbh->do('UPDATE bugs SET delta_ts = ? WHERE bug_id = ?',
+                     undef, $bug->{delta_ts}, $created->id);
+        }
+        # We don't need to send email for imported bugs.
+        $dbh->do('UPDATE bugs SET lastdiffed = delta_ts WHERE bug_id = ?',
+                 undef, $created->id);
+
+        # We don't use set_ and update() because that would create
+        # a bugs_activity entry that we don't want.
+        if ($set_status) {
+            $dbh->do('UPDATE bugs SET bug_status = ? WHERE bug_id = ?',
+                     undef, $set_status->name, $created->id);
+        }
+        if ($set_resolution) {
+            $dbh->do('UPDATE bugs SET resolution = ? WHERE bug_id = ?',
+                     undef, $set_resolution->name, $created->id);
+        }
+        
+        $self->_insert_comments($created, $comments);
+        $self->_insert_history($created, $history);
+        $self->_insert_attachments($created, $attachments);
+
+        # bugs_fulltext isn't transactional, so if we're in a dry-run we
+        # need to delete anything that we put in there.
+        if ($self->dry_run) {
+            $dbh->do('DELETE FROM bugs_fulltext WHERE bug_id = ?',
+                     undef, $created->id);
+        }
+
+        if (!$self->verbose) {
+            indicate_progress({ current => $count++, every => 5, total => $total });
+        }
+    }
+}
+
+sub _insert_comments {
+    my ($self, $bug, $comments) = @_;
+    return if !$comments;
+    $self->debug(' Inserting comments:', 2);
+    foreach my $comment (@$comments) {
+        $self->debug($comment, 3);
+        my %copy = %$comment;
+        # XXX In the future, if we have a Bugzilla::Comment->create, this
+        # should use it.
+        my $who = Bugzilla::User->check(delete $copy{who});
+        $copy{who} = $who->id;
+        $copy{bug_id} = $bug->id;
+        $self->_do_table_insert('longdescs', \%copy);
+        $self->debug("  Inserted comment from " . $who->login, 2);
+    }
+    $bug->_sync_fulltext( update_comments => 1 );
+}
+
+sub _insert_history {
+    my ($self, $bug, $history) = @_;
+    return if !$history;
+    $self->debug(' Inserting history:', 2);
+    foreach my $item (@$history) {
+        $self->debug($item, 3);
+        my $who = Bugzilla::User->check($item->{who});
+        LogActivityEntry($bug->id, $item->{field}, $item->{removed},
+                         $item->{added}, $who->id, $item->{bug_when});
+        $self->debug("  $item->{field} change from " . $who->login, 2);
+    }
+}
+
+sub _insert_attachments {
+    my ($self, $bug, $attachments) = @_;
+    return if !$attachments;
+    $self->debug(' Inserting attachments:', 2);
+    foreach my $attachment (@$attachments) {
+        $self->debug($attachment, 3);
+        # Make sure that our pointer is at the beginning of the file,
+        # because usually it will be at the end, having just been fully
+        # written to.
+        if (ref $attachment->{data}) {
+            $attachment->{data}->seek(0, SEEK_SET);
+        }
+
+        my $submitter = Bugzilla::User->check(delete $attachment->{submitter});
+        my $super_user = Bugzilla->user;
+        # Make sure the submitter can attach this attachment no matter what.
+        $submitter->{groups} = $super_user->groups;
+        Bugzilla->set_user($submitter);
+        my $created =
+            Bugzilla::Attachment->create({ %$attachment, bug => $bug });
+        $self->debug('  Attachment ' . $created->description . ' from '
+                     . $submitter->login, 2);
+        Bugzilla->set_user($super_user);
+    }
+}
+
+sub _do_table_insert {
+    my ($self, $table, $hash) = @_;
+    my @fields    = keys %$hash;
+    my @questions = ('?') x @fields;
+    my @values    = map { $hash->{$_} } @fields;
+    my $field_sql    = join(',', @fields);
+    my $question_sql = join(',', @questions);
+    Bugzilla->dbh->do("INSERT INTO $table ($field_sql) VALUES ($question_sql)",
+                      undef, @values);
+}
+
+######################
+# Helper Subroutines #
+######################
+
+sub _canonical_name {
+    my ($module) = @_;
+    $module =~ s{::}{/}g;
+    $module = basename($module);
+    $module =~ s/\.pm$//g;
+    return $module;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Migrate - Functions to migrate from other databases
+
+=head1 DESCRIPTION
+
+This module acts as a base class for the various modules that migrate
+from other bug-trackers.
+
+The documentation for this module exists mostly to assist people in
+creating new migrators for other bug-trackers than the ones currently
+supported.
+
+=head1 HOW MIGRATION WORKS
+
+Before writing anything to the Bugzilla database, the migrator will read
+everything from the other bug-tracker's database. Here's the exact order
+of what happens:
+
+=over
+
+=item 1
+
+Users are read from the other bug-tracker.
+
+=item 2
+
+Products are read from the other bug-tracker.
+
+=item 3
+
+Bugs are read from the other bug-tracker.
+
+=item 4
+
+The L</after_read> method is called.
+
+=item 5
+
+All bugs are translated from the other bug-tracker's fields/values
+into Bugzilla's fields values using L</translate_bug>.
+
+=item 6
+
+Users are inserted into Bugzilla.
+
+=item 7
+
+Products are inserted into Bugzilla.
+
+=item 8
+
+Some migrators need to create custom fields before migrating, and
+so that happens here.
+
+=item 9
+
+Any legal values that need to be created for any drop-down or
+multi-select fields are created. This is done by reading all the
+values on every bug that was read in and creating any values that
+don't already exist in Bugzilla for every drop-down or multi-select
+field on each bug. This includes creating any product versions and
+milestones that need to be created.
+
+=item 10
+
+Bugs are inserted into Bugzilla.
+
+=item 11
+
+The L</after_insert> method is called.
+
+=back
+
+Everything happens in one big transaction, so in general, if there are
+any errors during the process, nothing will be changed.
+
+The migrator never creates anything that already exists. So users, products,
+components, etc. that already exist will just be re-used by this script,
+not re-created.
+
+=head1 CONSTRUCTOR
+
+=head2 load
+
+Called like C<< Bugzilla::Migrate->load('Module') >>. Returns a new
+C<Bugzilla::Migrate> object that can be used to migrate from the
+requested bug-tracker.
+
+=head1 METHODS YOUR SUBCLASS CAN USE
+
+=head2 config
+
+Takes a single parameter, a string, and returns the value of the
+configuration variable with that name (always a scalar). The first time
+you call C<config>, if the configuration file hasn't been read, it will
+be read in.
+
+=head2 debug
+
+If the user hasn't specified C<--verbose> on the command line, this
+does nothing.
+
+Takes two arguments:
+
+The first argument is a string or reference to print to C<STDERR>.
+If it's a reference, L<Data::Dumper> will be used to print the
+data structure.
+
+The second argument is a number--the string will only be printed if the
+user specified C<--verbose> at least that many times on the command line.
+
+=head2 parse_date
+
+(Note: Usually you don't need to call this, because L</translate_bug>
+handles date translations for you, for bug data.)
+
+Parses a date string and returns a formatted date string that can be inserted
+into the database. If the input date is missing a timezone, the "timezone"
+configuration parameter will be used as the timezone of the date.
+
+=head2 translate_bug
+
+(Note: Normally you don't have to call this yourself, as 
+C<Bugzilla::Migrate> does it for you.)
+
+Uses the C<$translate_fields> and C<$translate_values> configuration variables
+to convert a hashref of "other bug-tracker" fields into Bugzilla fields.
+It takes one argument, the hashref to convert. Any unrecognized fields will
+have their value prepended to the C<comment> element in the returned
+hashref, unless they are listed in L</NON_COMMENT_FIELDS>.
+
+In scalar context, returns the translated bug. In array context,
+returns both the translated bug and a second hashref containing the values
+of any untranslated fields that were listed in C<NON_COMMENT_FIELDS>.
+
+B<Note:> To save memory, the hashref that you pass in will be destroyed
+(all keys will be deleted).
+
+=head2 translate_value
+
+(Note: Generally you only need to use this during L</_read_products>
+and L</_read_users> if necessary, because the data returned from
+L</_read_bugs> will be put through L</translate_bug>.)
+
+Uses the C<$translate_values> configuration variable to convert
+field values from your bug-tracker to Bugzilla. Takes two arguments,
+the first being a field name and the second being a value. If the value
+is an arrayref, C<translate_value> will be called recursively on all
+the array elements.
+
+Also, any date field will be converted into ISO 8601 format, for
+inserting into the database.
+
+=head2 translate_field
+
+(Note: Normally you don't need to use this, because L</translate_bug> 
+handles it for you.)
+
+Translates a field name in your bug-tracker to a field name in Bugzilla,
+using the rules described in the description of the C<$translate_fields>
+configuration variable.
+
+Takes a single argument--the name of a field to translate.
+
+Returns C<undef> if the field could not be translated.
+
+=head1 METHODS YOU MUST IMPLEMENT
+
+These are methods that subclasses must implement:
+
+=head2 _read_bugs
+
+Should return an arrayref of hashes. The hashes will be passed to
+L<Bugzilla::Bug/create> to create bugs in Bugzilla. In addition to
+the normal C<create> fields, the hashes can contain three additional
+items:
+
+=over
+
+=item comments
+
+An arrayref of hashes, representing comments to be added to the
+database. The keys should be the names of columns in the longdescs
+table that you want to set for each comment. C<who> must be a
+username instead of a user id, though.
+
+You don't need to specify a value for the C<bug_id> column.
+
+=item history
+
+An arrayref of hashes, representing the history of changes made
+to this bug. The keys should be the names of columns in the
+bugs_activity table to set for each change. C<who> must be a username
+instead of a user id, though, and C<field> (containing the name of some field)
+is taken instead of C<fieldid>.
+
+You don't need to specify a value for the C<bug_id> column.
+
+=item attachments
+
+An arrayref of hashes, representing values to pass to
+L<Bugzilla::Attachment/create>. (Remember that the C<data> argument
+must be a file handle--we recommend using L<IO::File/new_tmpfile> to create
+anonymous temporary files for this purpose.) You should specify a
+C<submitter> argument containing the username of the attachment's submitter.
+
+You don't need to specify a value for the the C<bug> argument.
+
+=back
+
+=head2 _read_products
+
+Should return an arrayref of hashes to pass to L<Bugzilla::Product/create>.
+In addition to the normal C<create> fields, this also accepts an additional
+argument, C<components>, which is an arrayref of hashes to pass to
+L<Bugzilla::Component/create> (though you do not need to specify the
+C<product> argument for L<Bugzilla::Component/create>).
+
+=head2 _read_users
+
+Should return an arrayref of hashes to be passed to
+L<Bugzilla::User/create>.
+
+=head1 METHODS YOU MIGHT WANT TO IMPLEMENT
+
+These are methods that you may want to override in your migrator.
+All of these methods are called on an instantiated L<Bugzilla::Migrate>
+object of your subclass by L<Bugzilla::Migrate> itself.
+
+=head2 REQUIRED_MODULES
+
+Returns an arrayref of Perl modules that must be installed in order
+for your migrator to run, in the same format as 
+L<Bugzilla::Install::Requirements/REQUIRED_MODULES>.
+
+=head2 CUSTOM_FIELDS
+
+Returns a hashref, where the keys are the names of custom fields
+to create in the database before inserting bugs. The values of the
+hashref are the arguments (other than "name") that should be passed
+to Bugzilla::Field->create() when creating the field. (C<< custom => 1 >>
+will be specified automatically for you, so you don't need to specify it.)
+
+=head2 CONFIG_VARS
+
+This should return an array (not an arrayref) in the same format as
+L<Bugzilla::Install::Localconfig/LOCALCONFIG_VARS>, describing
+configuration variables for migrating from your bug-tracker. You should
+always include the default C<CONFIG_VARS> (by calling
+$self->SUPER::CONFIG_VARS) as part of your return value, if you
+override this method.
+
+=head2 NON_COMMENT_FIELDS
+
+An array (not an arrayref). If there are fields that are not translated
+and yet shouldn't be added to the initial description of the bug when
+translating bugs, then they should be listed here. See L</translate_bug> for
+more detail.
+
+=head2 after_read
+
+This is run after all data is read from the other bug-tracker, but
+before the bug fields/values have been translated, and before any data
+is inserted into Bugzilla. The default implementation does nothing.
+
+=head2 before_insert
+
+This is called after all bugs are translated from their "other bug-tracker"
+values to Bugzilla values, but before any data is inserted into the database
+or any custom fields are created. The default implementation does nothing.
+
+=head2 after_insert
+
+This is run after all data is inserted into Bugzilla. The default
+implementation does nothing.

diff --git a/Bugzilla/Migrate/Gnats.pm b/Bugzilla/Migrate/Gnats.pm
new file mode 100644 (file)
index 0000000..05d3b37
--- /dev/null
+++ b/Bugzilla/Migrate/Gnats.pm
@@ -0,0 +1,698 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Migrate::Gnats;
+use strict;
+use base qw(Bugzilla::Migrate);
+
+use Bugzilla::Constants;
+use Bugzilla::Install::Util qw(indicate_progress);
+use Bugzilla::Util qw(format_time trim generate_random_password);
+
+use Email::Address;
+use Email::MIME;
+use File::Basename;
+use IO::File;
+use List::MoreUtils qw(firstidx);
+use List::Util qw(first);
+
+use constant REQUIRED_MODULES => [
+    {
+        package => 'Email-Simple-FromHandle',
+        module  => 'Email::Simple::FromHandle',
+        # This version added seekable handles.
+        version => 0.050,
+    },
+];
+
+use constant FIELD_MAP => {
+    'Number'         => 'bug_id',
+    'Category'       => 'product',
+    'Synopsis'       => 'short_desc',
+    'Responsible'    => 'assigned_to',
+    'State'          => 'bug_status',
+    'Class'          => 'cf_type',
+    'Classification' => '',
+    'Originator'     => 'reporter',
+    'Arrival-Date'   => 'creation_ts',
+    'Last-Modified'  => 'delta_ts',
+    'Release'        => 'version',
+    'Severity'       => 'bug_severity',
+    'Description'    => 'comment',
+};
+
+use constant VALUE_MAP => {
+    bug_severity => {
+        'serious'      => 'major',
+        'cosmetic'     => 'trivial',
+        'new-feature'  => 'enhancement',
+        'non-critical' => 'normal',
+    },
+    bug_status => {
+        'open'      => 'CONFIRMED',
+        'analyzed'  => 'IN_PROGRESS',
+        'suspended' => 'RESOLVED',
+        'feedback'  => 'RESOLVED',
+        'released'  => 'VERIFIED',
+    },
+    bug_status_resolution => {
+        'feedback'  => 'FIXED',
+        'released'  => 'FIXED',
+        'closed'    => 'FIXED',
+        'suspended' => 'LATER',
+    },
+    priority => {
+        'medium' => 'Normal',
+    },
+};
+
+use constant GNATS_CONFIG_VARS => (
+    {
+        name    => 'gnats_path',
+        default => '/var/lib/gnats',
+        desc    => <<END,
+# The path to the directory that contains the GNATS database.
+END
+    },
+    {
+        name    => 'default_email_domain',
+        default => 'example.com',
+        desc    => <<'END',
+# Some GNATS users do not have full email addresses, but Bugzilla requires
+# every user to have an email address. What domain should be appended to
+# usernames that don't have emails, to make them into email addresses?
+# (For example, if you leave this at the default, "unknown" would become
+# "unknown@example.com".)
+END
+    },
+    {
+        name    => 'component_name',
+        default => 'General',
+        desc    => <<'END',
+# GNATS has only "Category" to classify bugs. However, Bugzilla has a
+# multi-level system of Products that contain Components. When importing
+# GNATS categories, they become a Product with one Component. What should
+# the name of that Component be?
+END
+    },
+    {
+        name    => 'version_regex',
+        default => '',
+        desc    => <<'END',
+# In GNATS, the "version" field can contain almost anything. However, in
+# Bugzilla, it's a drop-down, so you don't want too many choices in there.
+# If you specify a regular expression here, versions will be tested against
+# this regular expression, and if they match, the first match (the first set
+# of parentheses in the regular expression, also called "$1") will be used
+# as the version value for the bug instead of the full version value specified
+# in GNATS.
+END
+    },
+    {
+        name    => 'default_originator',
+        default => 'gnats-admin',
+        desc    => <<'END',
+# Sometimes, a PR has no valid Originator, so we fall back to the From
+# header of the email. If the From header also isn't a valid username
+# (is just a name with spaces in it--we can't convert that to an email
+# address) then this username (which can either be a GNATS username or an
+# email address) will be considered to be the Originator of the PR.
+END
+    }
+);
+
+sub CONFIG_VARS {
+    my $self = shift;
+    my @vars = (GNATS_CONFIG_VARS, $self->SUPER::CONFIG_VARS);
+    my $field_map = first { $_->{name} eq 'translate_fields' } @vars;
+    $field_map->{default} = FIELD_MAP;
+    my $value_map = first { $_->{name} eq 'translate_values' } @vars;
+    $value_map->{default} = VALUE_MAP;
+    return @vars;
+}
+
+# Directories that aren't projects, or that we shouldn't be parsing
+use constant SKIP_DIRECTORIES => qw(
+    gnats-adm
+    gnats-queue
+    pending
+);
+
+use constant NON_COMMENT_FIELDS => qw(
+    Audit-Trail
+    Closed-Date
+    Confidential
+    Unformatted
+    attachments
+);
+
+# Certain fields can contain things that look like fields in them,
+# because they might contain quoted emails. To avoid mis-parsing,
+# we list out here the exact order of fields at the end of a PR
+# and wait for the next field to consider that we actually have
+# a field to parse.
+use constant END_FIELD_ORDER => qw(
+    Description
+    How-To-Repeat
+    Fix
+    Release-Note
+    Audit-Trail
+    Unformatted
+);
+
+use constant CUSTOM_FIELDS => {
+    cf_type => {
+        type        => FIELD_TYPE_SINGLE_SELECT,
+        description => 'Type',
+    },
+};
+
+use constant FIELD_REGEX => qr/^>(\S+):\s*(.*)$/;
+
+# Used for bugs that have no Synopsis.
+use constant NO_SUBJECT => "(no subject)";
+
+# This is the divider that GNATS uses between attachments in its database
+# files. It's missign two hyphens at the beginning because MIME Emails use
+# -- to start boundaries.
+use constant GNATS_BOUNDARY => '----gnatsweb-attachment----';
+
+use constant LONG_VERSION_LENGTH => 32;
+
+#########
+# Hooks #
+#########
+
+sub before_insert {
+    my $self = shift;
+
+    # gnats_id isn't a valid User::create field, and we don't need it
+    # anymore now.
+    delete $_->{gnats_id} foreach @{ $self->users };
+
+    # Grab a version out of a bug for each product, so that there is a
+    # valid "version" argument for Bugzilla::Product->create.
+    foreach my $product (@{ $self->products }) {
+        my $bug = first { $_->{product} eq $product->{name} and $_->{version} }
+                        @{ $self->bugs };
+        if (defined $bug) {
+            $product->{version} = $bug->{version};
+        }
+        else {
+            $product->{version} = 'unspecified';
+        }
+    }
+}
+
+#########
+# Users #
+#########
+
+sub _read_users {
+    my $self = shift;
+    my $path = $self->config('gnats_path');
+    my $file =  "$path/gnats-adm/responsible";
+    $self->debug("Reading users from $file");
+    my $default_domain = $self->config('default_email_domain');
+    open(my $users_fh, '<', $file) || die "$file: $!";
+    my @users;
+    foreach my $line (<$users_fh>) {
+        $line = trim($line);
+        next if $line =~ /^#/;
+        my ($id, $name, $email) = split(':', $line, 3);
+        $email ||= "$id\@$default_domain";
+        # We can't call our own translate_value, because that depends on
+        # the existence of user_map, which doesn't exist until after
+        # this method. However, we still want to translate any users found.
+        $email = $self->SUPER::translate_value('user', $email);
+        push(@users, { realname => $name, login_name => $email,
+                       gnats_id => $id });
+    }
+    close($users_fh);
+    return \@users;
+}
+
+sub user_map {
+    my $self = shift;
+    $self->{user_map} ||= { map { $_->{gnats_id} => $_->{login_name} }
+                                @{ $self->users } };
+    return $self->{user_map};
+}
+
+sub add_user {
+    my ($self, $id, $email) = @_;
+    return if defined $self->user_map->{$id};
+    $self->user_map->{$id} = $email;
+    push(@{ $self->users }, { login_name => $email, gnats_id => $id });
+}
+
+sub user_to_email {
+    my ($self, $value) = @_;
+    if (defined $self->user_map->{$value}) {
+        $value = $self->user_map->{$value};
+    }
+    elsif ($value !~ /@/) {
+        my $domain = $self->config('default_email_domain');
+        $value = "$value\@$domain";
+    }
+    return $value;
+}
+
+############
+# Products #
+############
+
+sub _read_products {
+    my $self = shift;
+    my $path = $self->config('gnats_path');
+    my $file =  "$path/gnats-adm/categories";
+    $self->debug("Reading categories from $file");
+
+    open(my $categories_fh, '<', $file) || die "$file: $!";    
+    my @products;
+    foreach my $line (<$categories_fh>) {
+        $line = trim($line);
+        next if $line =~ /^#/;
+        my ($name, $description, $assigned_to, $cc) = split(':', $line, 4);
+        my %product = ( name => $name, description => $description );
+        
+        my @initial_cc = split(',', $cc);
+        @initial_cc = @{ $self->translate_value('user', \@initial_cc) };
+        $assigned_to = $self->translate_value('user', $assigned_to);
+        my %component = ( name         => $self->config('component_name'),
+                          description  => $description,
+                          initialowner => $assigned_to,
+                          initial_cc   => \@initial_cc );
+        $product{components} = [\%component];
+        push(@products, \%product);
+    }
+    close($categories_fh);
+    return \@products;
+}
+
+################
+# Reading Bugs #
+################
+
+sub _read_bugs {
+    my $self = shift;
+    my $path = $self->config('gnats_path');
+    my @directories = glob("$path/*");
+    my @bugs;
+    foreach my $directory (@directories) {
+        next if !-d $directory;
+        my $name = basename($directory);
+        next if grep($_ eq $name, SKIP_DIRECTORIES);
+        push(@bugs, @{ $self->_parse_project($directory) });
+    }
+    @bugs = sort { $a->{Number} <=> $b->{Number} } @bugs;
+    return \@bugs;
+}
+
+sub _parse_project {
+    my ($self, $directory) = @_;
+    my @files = glob("$directory/*");
+
+    $self->debug("Reading Project: $directory");
+    # Sometimes other files get into gnats directories.
+    @files = grep { basename($_) =~ /^\d+$/ } @files;
+    my @bugs;
+    my $count = 1;
+    my $total = scalar @files;
+    print basename($directory) . ":\n";
+    foreach my $file (@files) {
+        push(@bugs, $self->_parse_bug_file($file));
+        if (!$self->verbose) {
+            indicate_progress({ current => $count++, every => 5,
+                                total => $total });
+        }
+    }
+    return \@bugs;
+}
+
+sub _parse_bug_file {
+    my ($self, $file) = @_;
+    $self->debug("Reading $file");
+    open(my $fh, "<", $file) || die "$file: $!";
+    my $email = Email::Simple::FromHandle->new($fh);
+    my $fields = $self->_get_gnats_field_data($email);
+    # We parse attachments here instead of during translate_bug,
+    # because otherwise we'd be taking up huge amounts of memory storing
+    # all the raw attachment data in memory.
+    $fields->{attachments} = $self->_parse_attachments($fields);
+    close($fh);
+    return $fields;
+}
+
+sub _get_gnats_field_data {
+    my ($self, $email) = @_;
+    my ($current_field, @value_lines, %fields);
+    $email->reset_handle();
+    my $handle = $email->handle;
+    foreach my $line (<$handle>) {
+        # If this line starts a field name
+        if ($line =~ FIELD_REGEX) {
+            my ($new_field, $rest_of_line) = ($1, $2);
+            
+            # If this is one of the last few PR fields, then make sure
+            # that we're getting our fields in the right order.
+            my $new_field_valid = 1;
+            my $search_for = $current_field || '';
+            my $current_field_pos = firstidx { $_ eq $search_for }
+                                             END_FIELD_ORDER;
+            if ($current_field_pos > -1) {
+                my $new_field_pos = firstidx { $_ eq $new_field } 
+                                             END_FIELD_ORDER;
+                # We accept any field, as long as it's later than this one.
+                $new_field_valid = $new_field_pos > $current_field_pos ? 1 : 0;
+            }
+            
+            if ($new_field_valid) {
+                if ($current_field) {
+                    $fields{$current_field} = _handle_lines(\@value_lines);
+                    @value_lines = ();
+                }
+                $current_field = $new_field;
+                $line = $rest_of_line;
+            }
+        }
+        push(@value_lines, $line) if defined $line;
+    }
+    $fields{$current_field} = _handle_lines(\@value_lines);
+    $fields{cc} = [$email->header('Cc')] if $email->header('Cc');
+    
+    # If the Originator is invalid and we don't have a translation for it,
+    # use the From header instead.
+    my $originator = $self->translate_value('reporter', $fields{Originator},
+                                            { check_only => 1 });
+    if ($originator !~ Bugzilla->params->{emailregexp}) {
+        # We use the raw header sometimes, because it looks like "From: user"
+        # which Email::Address won't parse but we can still use.
+        my $address = $email->header('From');
+        my ($parsed) = Email::Address->parse($address);
+        if ($parsed) {
+            $address = $parsed->address;
+        }
+        if ($address) {
+            $self->debug(
+                "PR $fields{Number} had an Originator that was not a valid"
+                . " user ($fields{Originator}). Using From ($address)"
+                . " instead.\n");
+            my $address_email = $self->translate_value('reporter', $address,
+                                                       { check_only => 1 });
+            if ($address_email !~ Bugzilla->params->{emailregexp}) {
+                $self->debug(" From was also invalid, using default_originator.\n");
+                $address = $self->config('default_originator');
+            }
+            $fields{Originator} = $address;
+        }
+    }
+
+    $self->debug(\%fields, 3);
+    return \%fields;
+}
+
+sub _handle_lines {
+    my ($lines) = @_;
+    my $value = join('', @$lines);
+    $value =~ s/\s+$//;
+    return $value;
+}
+
+####################
+# Translating Bugs #
+####################
+
+sub translate_bug {
+    my ($self, $fields) = @_;
+
+    my ($bug, $other_fields) = $self->SUPER::translate_bug($fields);
+
+    $bug->{attachments} = delete $other_fields->{attachments};
+
+    if (defined $other_fields->{_add_to_comment}) {
+        $bug->{comment} .= delete $other_fields->{_add_to_comment};
+    }
+
+    my ($changes, $extra_comment) =
+        $self->_parse_audit_trail($bug, $other_fields->{'Audit-Trail'});
+
+    my @comments;
+    foreach my $change (@$changes) {
+        if (exists $change->{comment}) {
+            push(@comments, {
+                thetext  => $change->{comment},
+                who      => $change->{who},
+                bug_when => $change->{bug_when} });
+            delete $change->{comment};
+        }
+    }
+    $bug->{history}  = $changes;
+
+    if (trim($extra_comment)) {
+        push(@comments, { thetext => $extra_comment, who => $bug->{reporter},
+                          bug_when => $bug->{delta_ts} || $bug->{creation_ts} });
+    }
+    $bug->{comments} = \@comments;
+    
+    $bug->{component} = $self->config('component_name');
+    if (!$bug->{short_desc}) {
+        $bug->{short_desc} = NO_SUBJECT;
+    }
+    
+    foreach my $attachment (@{ $bug->{attachments} || [] }) {
+        $attachment->{submitter} = $bug->{reporter};
+        $attachment->{creation_ts} = $bug->{creation_ts};
+    }
+
+    $self->debug($bug, 3);
+    return $bug;
+}
+
+sub _parse_audit_trail {
+    my ($self, $bug, $audit_trail) = @_;
+    return [] if !trim($audit_trail);
+    $self->debug(" Parsing audit trail...", 2);
+    
+    if ($audit_trail !~ /^\S+-Changed-\S+:/ms) {
+        # This is just a comment from the bug's creator.
+        $self->debug("  Audit trail is just a comment.", 2);
+        return ([], $audit_trail);
+    }
+    
+    my (@changes, %current_data, $current_column, $on_why);
+    my $extra_comment = '';
+    my $current_field;
+    my @all_lines = split("\n", $audit_trail);
+    foreach my $line (@all_lines) {
+        # GNATS history looks like:
+        # Status-Changed-From-To: open->closed
+        # Status-Changed-By: jack
+        # Status-Changed-When: Mon May 12 14:46:59 2003
+        # Status-Changed-Why:
+        #     This is some comment here about the change.
+        if ($line =~ /^(\S+)-Changed-(\S+):(.*)/) {
+            my ($field, $column, $value) = ($1, $2, $3);
+            my $bz_field = $self->translate_field($field);
+            # If it's not a field we're importing, we don't care about
+            # its history.
+            next if !$bz_field;
+            # GNATS doesn't track values for description changes,
+            # unfortunately, and that's the only information we'd be able to
+            # use in Bugzilla for the audit trail on that field.
+            next if $bz_field eq 'comment';
+            $current_field = $bz_field if !$current_field;
+            if ($bz_field ne $current_field) {
+                $self->_store_audit_change(
+                    \@changes, $current_field, \%current_data);
+                %current_data = ();
+                $current_field = $bz_field;
+            }
+            $value = trim($value);
+            $self->debug("  $bz_field $column: $value", 3);
+            if ($column eq 'From-To') {
+                my ($from, $to) = split('->', $value, 2);
+                # Sometimes there's just a - instead of a -> between the values.
+                if (!defined($to)) {
+                    ($from, $to) = split('-', $value, 2);
+                }
+                $current_data{added} = $to;
+                $current_data{removed} = $from;
+            }
+            elsif ($column eq 'By') {
+                my $email = $self->translate_value('user', $value);
+                # Sometimes we hit users in the audit trail that we haven't
+                # seen anywhere else.
+                $current_data{who} = $email;
+            }
+            elsif ($column eq 'When') {
+                $current_data{bug_when} = $self->parse_date($value);
+            }
+            if ($column eq 'Why') {
+                $value = '' if !defined $value;
+                $current_data{comment} = $value;
+                $on_why = 1;
+            }
+            else {
+                $on_why = 0;
+            }
+        }
+        elsif ($on_why) {
+            # "Why" lines are indented four characters.
+            $line =~ s/^\s{4}//;
+            $current_data{comment} .= "$line\n";
+        }
+        else {
+            $self->debug(
+                "Extra Audit-Trail line on $bug->{product} $bug->{bug_id}:"
+                 . " $line\n", 2);
+            $extra_comment .= "$line\n";
+        }
+    }
+    $self->_store_audit_change(\@changes, $current_field, \%current_data);
+    return (\@changes, $extra_comment);
+}
+
+sub _store_audit_change {
+    my ($self, $changes, $old_field, $current_data) = @_;
+
+    $current_data->{field} = $old_field;
+    $current_data->{removed} = 
+        $self->translate_value($old_field, $current_data->{removed});
+    $current_data->{added} =
+        $self->translate_value($old_field, $current_data->{added});
+    push(@$changes, { %$current_data });
+}
+
+sub _parse_attachments {
+    my ($self, $fields) = @_;
+    my $unformatted = delete $fields->{'Unformatted'};
+    my $gnats_boundary = GNATS_BOUNDARY;
+    # A sanity checker to make sure that we're parsing attachments right.
+    my $num_attachments = 0;
+    $num_attachments++ while ($unformatted =~ /\Q$gnats_boundary\E/g);
+    # Sometimes there's a GNATS_BOUNDARY that is on the same line as other data.
+    $unformatted =~ s/(\S\s*)\Q$gnats_boundary\E$/$1\n$gnats_boundary/mg;
+    # Often the "Unformatted" section starts with stuff before
+    # ----gnatsweb-attachment---- that isn't necessary.
+    $unformatted =~ s/^\s*From:.+?Reply-to:[^\n]+//s;
+    $unformatted = trim($unformatted);
+    return [] if !$unformatted;
+    $self->debug('Reading attachments...', 2);
+    my $boundary = generate_random_password(48);
+    $unformatted =~ s/\Q$gnats_boundary\E/--$boundary/g;
+    # Sometimes the whole Unformatted section is indented by exactly
+    # one space, and needs to be fixed.
+    if ($unformatted =~ /--\Q$boundary\E\n /) {
+        $unformatted =~ s/^ //mg;
+    }
+    $unformatted = <<END;
+From: nobody
+MIME-Version: 1.0
+Content-Type: multipart/mixed; boundary="$boundary"
+
+This is a multi-part message in MIME format.
+--$boundary
+Content-Type: text/plain; charset=UTF-8
+Content-Transfer-Encoding: 7bit
+
+$unformatted
+--$boundary--
+END
+    my $email = new Email::MIME(\$unformatted);
+    my @parts = $email->parts;
+    # Remove the fake body.
+    my $part1 = shift @parts;
+    if ($part1->body) {
+        $self->debug(" Additional Unformatted data found on "
+                     . $fields->{Category} . " bug " . $fields->{Number});
+        $self->debug($part1->body, 3);
+        $fields->{_add_comment} .= "\n\nUnformatted:\n" . $part1->body;
+    }
+
+    my @attachments;
+    foreach my $part (@parts) {
+        $self->debug('  Parsing attachment: ' . $part->filename);
+        my $temp_fh = IO::File->new_tmpfile or die ("Can't create tempfile: $!");
+        $temp_fh->binmode;
+        print $temp_fh $part->body;
+        my $content_type = $part->content_type;
+        $content_type =~ s/; name=.+$//;
+        my $attachment = { filename    => $part->filename,
+                           description => $part->filename,
+                           mimetype    => $content_type,
+                           data        => $temp_fh };
+        $self->debug($attachment, 3);
+        push(@attachments, $attachment);
+    }
+    
+    if (scalar(@attachments) ne $num_attachments) {
+        warn "WARNING: Expected $num_attachments attachments but got "
+             . scalar(@attachments) . "\n" ;
+        $self->debug($unformatted, 3);
+    }
+    return \@attachments;
+}
+
+sub translate_value {
+    my $self = shift;
+    my ($field, $value, $options) = @_;
+    my $original_value = $value;
+    $options ||= {};
+
+    if (!ref($value) and grep($_ eq $field, $self->USER_FIELDS)) {
+        if ($value =~ /(\S+\@\S+)/) {
+            $value = $1;
+            $value =~ s/^<//;
+            $value =~ s/>$//;
+        }
+        else {
+            # Sometimes names have extra stuff on the end like "(Somebody's Name)"
+            $value =~ s/\s+\(.+\)$//;
+            # Sometimes user fields look like "(user)" instead of just "user".
+            $value =~ s/^\((.+)\)$/$1/;
+            $value = trim($value);
+        }
+    }
+
+    if ($field eq 'version' and $value ne '') {
+        my $version_re = $self->config('version_regex');
+        if ($version_re and $value =~ $version_re) {
+            $value = $1;
+        }
+        # In the GNATS that I tested this with, there were many extremely long
+        # values for "version" that caused some import problems (they were
+        # longer than the max allowed version value). So if the version value
+        # is longer than 32 characters, pull out the first thing that looks
+        # like a version number.
+        elsif (length($value) > LONG_VERSION_LENGTH) {
+            $value =~ s/^.+?\b(\d[\w\.]+)\b.+$/$1/;
+        }
+    }
+    
+    my @args = @_;
+    $args[1] = $value;
+    
+    $value = $self->SUPER::translate_value(@args);
+    return $value if ref $value;
+    
+    if (grep($_ eq $field, $self->USER_FIELDS)) {
+        my $from_value = $value;
+        $value = $self->user_to_email($value);
+        $args[1] = $value;
+        # If we got something new from user_to_email, do any necessary
+        # translation of it.
+        $value = $self->SUPER::translate_value(@args);
+        if (!$options->{check_only}) {
+            $self->add_user($from_value, $value);
+        }
+    }
+    
+    return $value;
+}
+
+1;

diff --git a/Bugzilla/Milestone.pm b/Bugzilla/Milestone.pm
new file mode 100644 (file)
index 0000000..caa4afc
--- /dev/null
+++ b/Bugzilla/Milestone.pm
@@ -0,0 +1,371 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+package Bugzilla::Milestone;
+
+use base qw(Bugzilla::Object);
+
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+
+use Scalar::Util qw(blessed);
+
+################################
+#####    Initialization    #####
+################################
+
+use constant DEFAULT_SORTKEY => 0;
+
+use constant DB_TABLE => 'milestones';
+use constant NAME_FIELD => 'value';
+use constant LIST_ORDER => 'sortkey, value';
+
+use constant DB_COLUMNS => qw(
+    id
+    value
+    product_id
+    sortkey
+    isactive
+);
+
+use constant REQUIRED_FIELD_MAP => {
+    product_id => 'product',
+};
+
+use constant UPDATE_COLUMNS => qw(
+    value
+    sortkey
+    isactive
+);
+
+use constant VALIDATORS => {
+    product  => \&_check_product,
+    sortkey  => \&_check_sortkey,
+    value    => \&_check_value,
+    isactive => \&Bugzilla::Object::check_boolean,
+};
+
+use constant VALIDATOR_DEPENDENCIES => {
+    value => ['product'],
+};
+
+################################
+
+sub new {
+    my $class = shift;
+    my $param = shift;
+    my $dbh = Bugzilla->dbh;
+
+    my $product;
+    if (ref $param and !defined $param->{id}) {
+        $product = $param->{product};
+        my $name = $param->{name};
+        if (!defined $product) {
+            ThrowCodeError('bad_arg',
+                {argument => 'product',
+                 function => "${class}::new"});
+        }
+        if (!defined $name) {
+            ThrowCodeError('bad_arg',
+                {argument => 'name',
+                 function => "${class}::new"});
+        }
+
+        my $condition = 'product_id = ? AND value = ?';
+        my @values = ($product->id, $name);
+        $param = { condition => $condition, values => \@values };
+    }
+
+    unshift @_, $param;
+    return $class->SUPER::new(@_);
+}
+
+sub run_create_validators {
+    my $class = shift;
+    my $params = $class->SUPER::run_create_validators(@_);
+    my $product = delete $params->{product};
+    $params->{product_id} = $product->id;
+    return $params;
+}
+
+sub update {
+    my $self = shift;
+    my $changes = $self->SUPER::update(@_);
+
+    if (exists $changes->{value}) {
+        my $dbh = Bugzilla->dbh;
+        # The milestone value is stored in the bugs table instead of its ID.
+        $dbh->do('UPDATE bugs SET target_milestone = ?
+                  WHERE target_milestone = ? AND product_id = ?',
+                 undef, ($self->name, $changes->{value}->[0], $self->product_id));
+
+        # The default milestone also stores the value instead of the ID.
+        $dbh->do('UPDATE products SET defaultmilestone = ?
+                  WHERE id = ? AND defaultmilestone = ?',
+                 undef, ($self->name, $self->product_id, $changes->{value}->[0]));
+    }
+    return $changes;
+}
+
+sub remove_from_db {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    # The default milestone cannot be deleted.
+    if ($self->name eq $self->product->default_milestone) {
+        ThrowUserError('milestone_is_default', { milestone => $self });
+    }
+
+    if ($self->bug_count) {
+        # We don't want to delete bugs when deleting a milestone.
+        # Bugs concerned are reassigned to the default milestone.
+        my $bug_ids =
+          $dbh->selectcol_arrayref('SELECT bug_id FROM bugs
+                                    WHERE product_id = ? AND target_milestone = ?',
+                                    undef, ($self->product->id, $self->name));
+
+        my $timestamp = $dbh->selectrow_array('SELECT NOW()');
+
+        $dbh->do('UPDATE bugs SET target_milestone = ?, delta_ts = ?
+                   WHERE ' . $dbh->sql_in('bug_id', $bug_ids),
+                 undef, ($self->product->default_milestone, $timestamp));
+
+        require Bugzilla::Bug;
+        import Bugzilla::Bug qw(LogActivityEntry);
+        foreach my $bug_id (@$bug_ids) {
+            LogActivityEntry($bug_id, 'target_milestone',
+                             $self->name,
+                             $self->product->default_milestone,
+                             Bugzilla->user->id, $timestamp);
+        }
+    }
+
+    $self->SUPER::remove_from_db();
+}
+
+################################
+# Validators
+################################
+
+sub _check_value {
+    my ($invocant, $name, undef, $params) = @_;
+    my $product = blessed($invocant) ? $invocant->product : $params->{product};
+
+    $name = trim($name);
+    $name || ThrowUserError('milestone_blank_name');
+    if (length($name) > MAX_MILESTONE_SIZE) {
+        ThrowUserError('milestone_name_too_long', {name => $name});
+    }
+
+    my $milestone = new Bugzilla::Milestone({product => $product, name => $name});
+    if ($milestone && (!ref $invocant || $milestone->id != $invocant->id)) {
+        ThrowUserError('milestone_already_exists', { name    => $milestone->name,
+                                                     product => $product->name });
+    }
+    return $name;
+}
+
+sub _check_sortkey {
+    my ($invocant, $sortkey) = @_;
+
+    # Keep a copy in case detaint_signed() clears the sortkey
+    my $stored_sortkey = $sortkey;
+
+    if (!detaint_signed($sortkey) || $sortkey < MIN_SMALLINT || $sortkey > MAX_SMALLINT) {
+        ThrowUserError('milestone_sortkey_invalid', {sortkey => $stored_sortkey});
+    }
+    return $sortkey;
+}
+
+sub _check_product {
+    my ($invocant, $product) = @_;
+    $product || ThrowCodeError('param_required',
+                    { function => "$invocant->create", param => "product" });
+    return Bugzilla->user->check_can_admin_product($product->name);
+}
+
+################################
+# Methods
+################################
+
+sub set_name      { $_[0]->set('value', $_[1]);    }
+sub set_sortkey   { $_[0]->set('sortkey', $_[1]);  }
+sub set_is_active { $_[0]->set('isactive', $_[1]); }
+
+sub bug_count {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    if (!defined $self->{'bug_count'}) {
+        $self->{'bug_count'} = $dbh->selectrow_array(q{
+            SELECT COUNT(*) FROM bugs
+            WHERE product_id = ? AND target_milestone = ?},
+            undef, $self->product_id, $self->name) || 0;
+    }
+    return $self->{'bug_count'};
+}
+
+################################
+#####      Accessors      ######
+################################
+
+sub name       { return $_[0]->{'value'};      }
+sub product_id { return $_[0]->{'product_id'}; }
+sub sortkey    { return $_[0]->{'sortkey'};    }
+sub is_active  { return $_[0]->{'isactive'};   }
+
+sub product {
+    my $self = shift;
+
+    require Bugzilla::Product;
+    $self->{'product'} ||= new Bugzilla::Product($self->product_id);
+    return $self->{'product'};
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Milestone - Bugzilla product milestone class.
+
+=head1 SYNOPSIS
+
+    use Bugzilla::Milestone;
+
+    my $milestone = new Bugzilla::Milestone({ name => $name, product => $product_obj });
+    my $milestone = Bugzilla::Milestone->check({ name => $name, product => $product_obj });
+    my $milestone = Bugzilla::Milestone->check({ id => $id });
+
+    my $name       = $milestone->name;
+    my $product_id = $milestone->product_id;
+    my $product    = $milestone->product;
+    my $sortkey    = $milestone->sortkey;
+
+    my $milestone = Bugzilla::Milestone->create(
+        { value => $name, product => $product, sortkey => $sortkey });
+
+    $milestone->set_name($new_name);
+    $milestone->set_sortkey($new_sortkey);
+    $milestone->update();
+
+    $milestone->remove_from_db;
+
+=head1 DESCRIPTION
+
+Milestone.pm represents a Product Milestone object.
+
+=head1 METHODS
+
+=over
+
+=item C<< new({name => $name, product => $product}) >>
+
+ Description: The constructor is used to load an existing milestone
+              by passing a product object and a milestone name.
+
+ Params:      $product - a Bugzilla::Product object.
+              $name - the name of a milestone (string).
+
+ Returns:     A Bugzilla::Milestone object.
+
+=item C<name()>
+
+ Description: Name (value) of the milestone.
+
+ Params:      none.
+
+ Returns:     The name of the milestone.
+
+=item C<product_id()>
+
+ Description: ID of the product the milestone belongs to.
+
+ Params:      none.
+
+ Returns:     The ID of a product.
+
+=item C<product()>
+
+ Description: The product object of the product the milestone belongs to.
+
+ Params:      none.
+
+ Returns:     A Bugzilla::Product object.
+
+=item C<sortkey()>
+
+ Description: Sortkey of the milestone.
+
+ Params:      none.
+
+ Returns:     The sortkey of the milestone.
+
+=item C<bug_count()>
+
+ Description: Returns the total of bugs that belong to the milestone.
+
+ Params:      none.
+
+ Returns:     Integer with the number of bugs.
+
+=item C<set_name($new_name)>
+
+ Description: Changes the name of the milestone.
+
+ Params:      $new_name - new name of the milestone (string). This name
+                          must be unique within the product.
+
+ Returns:     Nothing.
+
+=item C<set_sortkey($new_sortkey)>
+
+ Description: Changes the sortkey of the milestone.
+
+ Params:      $new_sortkey - new sortkey of the milestone (signed integer).
+
+ Returns:     Nothing.
+
+=item C<update()>
+
+ Description: Writes the new name and/or the new sortkey into the DB.
+
+ Params:      none.
+
+ Returns:     A hashref with changes made to the milestone object.
+
+=item C<remove_from_db()>
+
+ Description: Deletes the current milestone from the DB. The object itself
+              is not destroyed.
+
+ Params:      none.
+
+ Returns:     Nothing.
+
+=back
+
+=head1 CLASS METHODS
+
+=over
+
+=item C<< create({value => $value, product => $product, sortkey => $sortkey}) >>
+
+ Description: Create a new milestone for the given product.
+
+ Params:      $value   - name of the new milestone (string). This name
+                         must be unique within the product.
+              $product - a Bugzilla::Product object.
+              $sortkey - the sortkey of the new milestone (signed integer)
+
+ Returns:     A Bugzilla::Milestone object.
+
+=back

diff --git a/Bugzilla/Object.pm b/Bugzilla/Object.pm
new file mode 100644 (file)
index 0000000..47b9356
--- /dev/null
+++ b/Bugzilla/Object.pm
@@ -0,0 +1,1287 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+package Bugzilla::Object;
+
+use Bugzilla::Constants;
+use Bugzilla::Hook;
+use Bugzilla::Util;
+use Bugzilla::Error;
+
+use Date::Parse;
+use List::MoreUtils qw(part);
+use Scalar::Util qw(blessed);
+
+use constant NAME_FIELD => 'name';
+use constant ID_FIELD   => 'id';
+use constant LIST_ORDER => NAME_FIELD;
+
+use constant UPDATE_VALIDATORS => {};
+use constant NUMERIC_COLUMNS   => ();
+use constant DATE_COLUMNS      => ();
+use constant VALIDATOR_DEPENDENCIES => {};
+# XXX At some point, this will be joined with FIELD_MAP.
+use constant REQUIRED_FIELD_MAP  => {};
+use constant EXTRA_REQUIRED_FIELDS => ();
+use constant AUDIT_CREATES => 1;
+use constant AUDIT_UPDATES => 1;
+use constant AUDIT_REMOVES => 1;
+
+# This allows the JSON-RPC interface to return Bugzilla::Object instances
+# as though they were hashes. In the future, this may be modified to return
+# less information.
+sub TO_JSON { return { %{ $_[0] } }; }
+
+###############################
+####    Initialization     ####
+###############################
+
+sub new {
+    my $invocant = shift;
+    my $class    = ref($invocant) || $invocant;
+    my $object   = $class->_init(@_);
+    bless($object, $class) if $object;
+    return $object;
+}
+
+
+# Note: Because this uses sql_istrcmp, if you make a new object use
+# Bugzilla::Object, make sure that you modify bz_setup_database
+# in Bugzilla::DB::Pg appropriately, to add the right LOWER
+# index. You can see examples already there.
+sub _init {
+    my $class = shift;
+    my ($param) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $columns = join(',', $class->_get_db_columns);
+    my $table   = $class->DB_TABLE;
+    my $name_field = $class->NAME_FIELD;
+    my $id_field   = $class->ID_FIELD;
+
+    my $id = $param;
+    if (ref $param eq 'HASH') {
+        $id = $param->{id};
+    }
+    my $object;
+
+    if (defined $id) {
+        # We special-case if somebody specifies an ID, so that we can
+        # validate it as numeric.
+        detaint_natural($id)
+          || ThrowCodeError('param_must_be_numeric',
+                            {function => $class . '::_init'});
+
+        # Too large integers make PostgreSQL crash.
+        return if $id > MAX_INT_32;
+
+        $object = $dbh->selectrow_hashref(qq{
+            SELECT $columns FROM $table
+             WHERE $id_field = ?}, undef, $id);
+    } else {
+        unless (defined $param->{name} || (defined $param->{'condition'} 
+                                           && defined $param->{'values'}))
+        {
+            ThrowCodeError('bad_arg', { argument => 'param',
+                                        function => $class . '::new' });
+        }
+
+        my ($condition, @values);
+        if (defined $param->{name}) {
+            $condition = $dbh->sql_istrcmp($name_field, '?');
+            push(@values, $param->{name});
+        }
+        elsif (defined $param->{'condition'} && defined $param->{'values'}) {
+            caller->isa('Bugzilla::Object')
+                || ThrowCodeError('protection_violation',
+                       { caller    => caller, 
+                         function  => $class . '::new',
+                         argument  => 'condition/values' });
+            $condition = $param->{'condition'};
+            push(@values, @{$param->{'values'}});
+        }
+
+        map { trick_taint($_) } @values;
+        $object = $dbh->selectrow_hashref(
+            "SELECT $columns FROM $table WHERE $condition", undef, @values);
+    }
+
+    return $object;
+}
+
+sub check {
+    my ($invocant, $param) = @_;
+    my $class = ref($invocant) || $invocant;
+    # If we were just passed a name, then just use the name.
+    if (!ref $param) {
+        $param = { name => $param };
+    }
+
+    # Don't allow empty names or ids.
+    my $check_param = exists $param->{id} ? 'id' : 'name';
+    $param->{$check_param} = trim($param->{$check_param});
+    # If somebody passes us "0", we want to throw an error like
+    # "there is no X with the name 0". This is true even for ids. So here,
+    # we only check if the parameter is undefined or empty.
+    if (!defined $param->{$check_param} or $param->{$check_param} eq '') {
+        ThrowUserError('object_not_specified', { class => $class });
+    }
+
+    my $obj = $class->new($param);
+    if (!$obj) {
+        # We don't want to override the normal template "user" object if
+        # "user" is one of the params.
+        delete $param->{user};
+        if (my $error = delete $param->{_error}) {
+            ThrowUserError($error, { %$param, class => $class });
+        }
+        else {
+            ThrowUserError('object_does_not_exist', { %$param, class => $class });
+        }
+    }
+    return $obj;
+}
+
+sub new_from_list {
+    my $invocant = shift;
+    my $class = ref($invocant) || $invocant;
+    my ($id_list) = @_;
+    my $id_field = $class->ID_FIELD;
+
+    my @detainted_ids;
+    foreach my $id (@$id_list) {
+        detaint_natural($id) ||
+            ThrowCodeError('param_must_be_numeric',
+                          {function => $class . '::new_from_list'});
+        # Too large integers make PostgreSQL crash.
+        next if $id > MAX_INT_32;
+        push(@detainted_ids, $id);
+    }
+    # We don't do $invocant->match because some classes have
+    # their own implementation of match which is not compatible
+    # with this one. However, match() still needs to have the right $invocant
+    # in order to do $class->DB_TABLE and so on.
+    return match($invocant, { $id_field => \@detainted_ids });
+}
+
+# Note: Future extensions to this could be:
+#  * Add a MATCH_JOIN constant so that we can join against
+#    certain other tables for the WHERE criteria.
+sub match {
+    my ($invocant, $criteria) = @_;
+    my $class = ref($invocant) || $invocant;
+    my $dbh   = Bugzilla->dbh;
+
+    return [$class->get_all] if !$criteria;
+
+    my (@terms, @values, $postamble);
+    foreach my $field (keys %$criteria) {
+        my $value = $criteria->{$field};
+        
+        # allow for LIMIT and OFFSET expressions via the criteria.
+        next if $field eq 'OFFSET';
+        if ( $field eq 'LIMIT' ) {
+            next unless defined $value;
+            detaint_natural($value)
+              or ThrowCodeError('param_must_be_numeric', 
+                                { param    => 'LIMIT', 
+                                  function => "${class}::match" });
+            my $offset;
+            if (defined $criteria->{OFFSET}) {
+                $offset = $criteria->{OFFSET};
+                detaint_signed($offset)
+                  or ThrowCodeError('param_must_be_numeric', 
+                                    { param    => 'OFFSET',
+                                      function => "${class}::match" });
+            }
+            $postamble = $dbh->sql_limit($value, $offset);
+            next;
+        }
+        elsif ( $field eq 'WHERE' ) {
+            # the WHERE value is a hashref where the keys are
+            # "column_name operator ?" and values are the placeholder's
+            # value (either a scalar or an array of values).
+            foreach my $k (keys %$value) {
+                push(@terms, $k);
+                my @this_value = ref($value->{$k}) ? @{ $value->{$k} } 
+                                                   : ($value->{$k});
+                push(@values, @this_value);
+            }            
+            next;
+        }
+
+        # It's always safe to use the field defined by classes as being
+        # their ID field. In particular, this means that new_from_list()
+        # is exempted from this check.
+        $class->_check_field($field, 'match') unless $field eq $class->ID_FIELD;
+
+        if (ref $value eq 'ARRAY') {
+            # IN () is invalid SQL, and if we have an empty list
+            # to match against, we're just returning an empty
+            # array anyhow.
+            return [] if !scalar @$value;
+
+            my @qmarks = ("?") x @$value;
+            push(@terms, $dbh->sql_in($field, \@qmarks));
+            push(@values, @$value);
+        }
+        elsif ($value eq NOT_NULL) {
+            push(@terms, "$field IS NOT NULL");
+        }
+        elsif ($value eq IS_NULL) {
+            push(@terms, "$field IS NULL");
+        }
+        else {
+            push(@terms, "$field = ?");
+            push(@values, $value);
+        }
+    }
+
+    my $where = join(' AND ', @terms) if scalar @terms;
+    return $class->_do_list_select($where, \@values, $postamble);
+}
+
+sub _do_list_select {
+    my ($class, $where, $values, $postamble) = @_;
+    my $table = $class->DB_TABLE;
+    my $cols  = join(',', $class->_get_db_columns);
+    my $order = $class->LIST_ORDER;
+
+    my $sql = "SELECT $cols FROM $table";
+    if (defined $where) {
+        $sql .= " WHERE $where ";
+    }
+    $sql .= " ORDER BY $order";
+    
+    $sql .= " $postamble" if $postamble;
+        
+    my $dbh = Bugzilla->dbh;
+    # Sometimes the values are tainted, but we don't want to untaint them
+    # for the caller. So we copy the array. It's safe to untaint because
+    # they're only used in placeholders here.
+    my @untainted = @{ $values || [] };
+    trick_taint($_) foreach @untainted;
+    my $objects = $dbh->selectall_arrayref($sql, {Slice=>{}}, @untainted);
+    bless ($_, $class) foreach @$objects;
+    return $objects
+}
+
+###############################
+####      Accessors      ######
+###############################
+
+sub id   { return $_[0]->{$_[0]->ID_FIELD};   }
+sub name { return $_[0]->{$_[0]->NAME_FIELD}; }
+
+###############################
+####        Methods        ####
+###############################
+
+sub set {
+    my ($self, $field, $value) = @_;
+
+    # This method is protected. It's used to help implement set_ functions.
+    my $caller = caller;
+    $caller->isa('Bugzilla::Object') || $caller->isa('Bugzilla::Extension')
+        || ThrowCodeError('protection_violation', 
+                          { caller     => caller,
+                            superclass => __PACKAGE__,
+                            function   => 'Bugzilla::Object->set' });
+
+    Bugzilla::Hook::process('object_before_set',
+                            { object => $self, field => $field,
+                              value => $value });
+
+    my %validators = (%{$self->_get_validators}, %{$self->UPDATE_VALIDATORS});
+    if (exists $validators{$field}) {
+        my $validator = $validators{$field};
+        $value = $self->$validator($value, $field);
+        trick_taint($value) if (defined $value && !ref($value));
+
+        if ($self->can('_set_global_validator')) {
+            $self->_set_global_validator($value, $field);
+        }
+    }
+
+    $self->{$field} = $value;
+
+    Bugzilla::Hook::process('object_end_of_set',
+                            { object => $self, field => $field });
+}
+
+sub set_all {
+    my ($self, $params) = @_;
+
+    # Don't let setters modify the values in $params for the caller.
+    my %field_values = %$params;
+
+    my @sorted_names = $self->_sort_by_dep(keys %field_values);
+
+    foreach my $key (@sorted_names) {
+        # It's possible for one set_ method to delete a key from $params
+        # for another set method, so if that's happened, we don't call the
+        # other set method.
+        next if !exists $field_values{$key};
+        my $method = "set_$key";
+        if (!$self->can($method)) {
+            my $class = ref($self) || $self;
+            ThrowCodeError("unknown_method", { method => "${class}::${method}" });
+        }
+        $self->$method($field_values{$key}, \%field_values);
+    }
+    Bugzilla::Hook::process('object_end_of_set_all', 
+                            { object => $self, params => \%field_values });
+}
+
+sub update {
+    my $self = shift;
+
+    my $dbh      = Bugzilla->dbh;
+    my $table    = $self->DB_TABLE;
+    my $id_field = $self->ID_FIELD;
+
+    $dbh->bz_start_transaction();
+
+    my $old_self = $self->new($self->id);
+   
+    my @all_columns = $self->UPDATE_COLUMNS;
+    my @hook_columns;
+    Bugzilla::Hook::process('object_update_columns',
+                            { object => $self, columns => \@hook_columns });
+    push(@all_columns, @hook_columns);
+
+    my %numeric = map { $_ => 1 } $self->NUMERIC_COLUMNS;
+    my %date    = map { $_ => 1 } $self->DATE_COLUMNS;
+    my (@update_columns, @values, %changes);
+    foreach my $column (@all_columns) {
+        my ($old, $new) = ($old_self->{$column}, $self->{$column});
+        # This has to be written this way in order to allow us to set a field
+        # from undef or to undef, and avoid warnings about comparing an undef
+        # with the "eq" operator.
+        if (!defined $new || !defined $old) {
+            next if !defined $new && !defined $old;
+        }
+        elsif ( ($numeric{$column} && $old == $new) 
+                || ($date{$column} && str2time($old) == str2time($new))
+                || $old eq $new ) {
+            next;
+        }
+
+        trick_taint($new) if defined $new;
+        push(@values, $new);
+        push(@update_columns, $column);
+        # We don't use $new because we don't want to detaint this for
+        # the caller.
+        $changes{$column} = [$old, $self->{$column}];
+    }
+
+    my $columns = join(', ', map {"$_ = ?"} @update_columns);
+
+    $dbh->do("UPDATE $table SET $columns WHERE $id_field = ?", undef, 
+             @values, $self->id) if @values;
+
+    Bugzilla::Hook::process('object_end_of_update',
+                            { object => $self, old_object => $old_self,
+                              changes => \%changes });
+
+    $self->audit_log(\%changes) if $self->AUDIT_UPDATES;
+
+    $dbh->bz_commit_transaction();
+
+    if (wantarray) {
+        return (\%changes, $old_self);
+    }
+
+    return \%changes;
+}
+
+sub remove_from_db {
+    my $self = shift;
+    Bugzilla::Hook::process('object_before_delete', { object => $self });
+    my $table = $self->DB_TABLE;
+    my $id_field = $self->ID_FIELD;
+    my $dbh = Bugzilla->dbh;
+    $dbh->bz_start_transaction();
+    $self->audit_log(AUDIT_REMOVE) if $self->AUDIT_REMOVES;
+    $dbh->do("DELETE FROM $table WHERE $id_field = ?", undef, $self->id);
+    $dbh->bz_commit_transaction();
+    undef $self;
+}
+
+sub audit_log {
+    my ($self, $changes) = @_;
+    my $class = ref $self;
+    my $dbh = Bugzilla->dbh;
+    my $user_id = Bugzilla->user->id || undef;
+    my $sth = $dbh->prepare(
+        'INSERT INTO audit_log (user_id, class, object_id, field,
+                                removed, added, at_time) 
+              VALUES (?,?,?,?,?,?,LOCALTIMESTAMP(0))');
+    # During creation or removal, $changes is actually just a string
+    # indicating whether we're creating or removing the object.
+    if ($changes eq AUDIT_CREATE or $changes eq AUDIT_REMOVE) {
+        # We put the object's name in the "added" or "removed" field.
+        # We do this thing with NAME_FIELD because $self->name returns
+        # the wrong thing for Bugzilla::User.
+        my $name = $self->{$self->NAME_FIELD};
+        my @added_removed = $changes eq AUDIT_CREATE ? (undef, $name) 
+                                                     : ($name, undef);
+        $sth->execute($user_id, $class, $self->id, $changes, @added_removed);
+        return;
+    }
+
+    # During update, it's the actual %changes hash produced by update().
+    foreach my $field (keys %$changes) {
+        # Skip private changes.
+        next if $field =~ /^_/;
+        my ($from, $to) = @{ $changes->{$field} };
+        $sth->execute($user_id, $class, $self->id, $field, $from, $to);
+    }
+}
+
+###############################
+####      Subroutines    ######
+###############################
+
+sub any_exist {
+    my $class = shift;
+    my $table = $class->DB_TABLE;
+    my $dbh = Bugzilla->dbh;
+    my $any_exist = $dbh->selectrow_array(
+        "SELECT 1 FROM $table " . $dbh->sql_limit(1));
+    return $any_exist ? 1 : 0;
+}
+
+sub create {
+    my ($class, $params) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    $dbh->bz_start_transaction();
+    $class->check_required_create_fields($params);
+    my $field_values = $class->run_create_validators($params);
+    my $object = $class->insert_create_data($field_values);
+    $dbh->bz_commit_transaction();
+
+    return $object;
+}
+
+# Used to validate that a field name is in fact a valid column in the
+# current table before inserting it into SQL.
+sub _check_field {
+    my ($invocant, $field, $function) = @_;
+    my $class = ref($invocant) || $invocant;
+    if (!Bugzilla->dbh->bz_column_info($class->DB_TABLE, $field)) {
+        ThrowCodeError('param_invalid', { param    => $field,
+                                          function => "${class}::$function" });
+    }
+}
+
+sub check_required_create_fields {
+    my ($class, $params) = @_;
+
+    # This hook happens here so that even subclasses that don't call
+    # SUPER::create are still affected by the hook.
+    Bugzilla::Hook::process('object_before_create', { class => $class,
+                                                      params => $params });
+
+    my @check_fields = $class->_required_create_fields();
+    foreach my $field (@check_fields) {
+        $params->{$field} = undef if !exists $params->{$field};
+    }
+}
+
+sub run_create_validators {
+    my ($class, $params, $options) = @_;
+
+    my $validators = $class->_get_validators;
+    my %field_values = %$params;
+
+    # Make a hash skiplist for easier searching later
+    my %skip_list = map { $_ => 1 } @{ $options->{skip} || [] };
+
+    # Get the sorted field names
+    my @sorted_names = $class->_sort_by_dep(keys %field_values);
+
+    # Remove the skipped names
+    my @unskipped = grep { !$skip_list{$_} } @sorted_names;
+
+    foreach my $field (@unskipped) {
+        my $value;
+        if (exists $validators->{$field}) {
+            my $validator = $validators->{$field};
+            $value = $class->$validator($field_values{$field}, $field,
+                                        \%field_values);
+        }
+        else {
+            $value = $field_values{$field};
+        }
+
+        # We want people to be able to explicitly set fields to NULL,
+        # and that means they can be set to undef.
+        trick_taint($value) if defined $value && !ref($value);
+        $field_values{$field} = $value;
+    }
+
+    Bugzilla::Hook::process('object_end_of_create_validators',
+                            { class => $class, params => \%field_values });
+
+    return \%field_values;
+}
+
+sub insert_create_data {
+    my ($class, $field_values) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    my (@field_names, @values);
+    while (my ($field, $value) = each %$field_values) {
+        $class->_check_field($field, 'create');
+        push(@field_names, $field);
+        push(@values, $value);
+    }
+
+    my $qmarks = '?,' x @field_names;
+    chop($qmarks);
+    my $table = $class->DB_TABLE;
+    $dbh->do("INSERT INTO $table (" . join(', ', @field_names)
+             . ") VALUES ($qmarks)", undef, @values);
+    my $id = $dbh->bz_last_key($table, $class->ID_FIELD);
+
+    my $object = $class->new($id);
+
+    Bugzilla::Hook::process('object_end_of_create', { class => $class,
+                                                      object => $object });
+    $object->audit_log(AUDIT_CREATE) if $object->AUDIT_CREATES;
+
+    return $object;
+}
+
+sub get_all {
+    my $class = shift;
+    return @{$class->_do_list_select()};
+}
+
+###############################
+####      Validators     ######
+###############################
+
+sub check_boolean { return $_[1] ? 1 : 0 }
+
+sub check_time {
+    my ($invocant, $value, $field, $params, $allow_negative) = @_;
+
+    # If we don't have a current value default to zero
+    my $current = blessed($invocant) ? $invocant->{$field}
+                                     : 0;
+    $current ||= 0;
+
+    # Get the new value or zero if it isn't defined
+    $value = trim($value) || 0;
+
+    # Make sure the new value is well formed
+    _validate_time($value, $field, $allow_negative);
+
+    return $value;
+}
+
+
+###################
+# General Helpers #
+###################
+
+sub _validate_time {
+    my ($time, $field, $allow_negative) = @_;
+
+    # regexp verifies one or more digits, optionally followed by a period and
+    # zero or more digits, OR we have a period followed by one or more digits
+    # (allow negatives, though, so people can back out errors in time reporting)
+    if ($time !~ /^-?(?:\d+(?:\.\d*)?|\.\d+)$/) {
+        ThrowUserError("number_not_numeric",
+                       {field => $field, num => "$time"});
+    }
+
+    # Callers can optionally allow negative times
+    if ( ($time < 0) && !$allow_negative ) {
+        ThrowUserError("number_too_small",
+                       {field => $field, num => "$time", min_num => "0"});
+    }
+
+    if ($time > 99999.99) {
+        ThrowUserError("number_too_large",
+                       {field => $field, num => "$time", max_num => "99999.99"});
+    }
+}
+
+# Sorts fields according to VALIDATOR_DEPENDENCIES. This is not a
+# traditional topological sort, because a "dependency" does not
+# *have* to be in the list--it just has to be earlier than its dependent
+# if it *is* in the list.
+sub _sort_by_dep {
+    my ($invocant, @fields) = @_;
+
+    my $dependencies = $invocant->VALIDATOR_DEPENDENCIES;
+    my ($has_deps, $no_deps) = part { $dependencies->{$_} ? 0 : 1 } @fields;
+
+    # For fields with no dependencies, we sort them alphabetically,
+    # so that validation always happens in a consistent order.
+    # Fields with no dependencies come at the start of the list.
+    my @result = sort @{ $no_deps || [] };
+
+    # Fields with dependencies all go at the end of the list, and if
+    # they have dependencies on *each other*, then they have to be
+    # sorted properly. We go through $has_deps in sorted order to be
+    # sure that fields always validate in a consistent order.
+    foreach my $field (sort @{ $has_deps || [] }) {
+        if (!grep { $_ eq $field } @result) {
+            _insert_dep_field($field, $has_deps, $dependencies, \@result);
+        }
+    }
+    return @result;
+}
+
+sub _insert_dep_field {
+    my ($field, $insert_me, $dependencies, $result, $loop_tracking) = @_;
+
+    if ($loop_tracking->{$field}) {
+        ThrowCodeError('object_dep_sort_loop', 
+                       { field => $field, 
+                         considered => [keys %$loop_tracking] });
+    }
+    $loop_tracking->{$field} = 1;
+
+    my $required_fields = $dependencies->{$field};
+    # Imagine Field A requires field B...
+    foreach my $required_field (@$required_fields) {
+        # If our dependency is already satisfied, we're good.
+        next if grep { $_ eq $required_field } @$result;
+
+        # If our dependency is not in the remaining fields to insert,
+        # then we're also OK.
+        next if !grep { $_ eq $required_field } @$insert_me;
+
+        # So, at this point, we know that Field B is in $insert_me.
+        # So let's put the required field into the result.
+        _insert_dep_field($required_field, $insert_me, $dependencies,
+                          $result, $loop_tracking);
+    }
+    push(@$result, $field);
+}
+
+####################
+# Constant Helpers #
+####################
+
+# For some classes, some constants take time to generate, so we cache them
+# and only access them through the below methods. This also allows certain
+# hooks to only run once per request instead of multiple times on each
+# page.
+
+sub _get_db_columns {
+    my $invocant = shift;
+    my $class = ref($invocant) || $invocant;
+    my $cache = Bugzilla->request_cache;
+    my $cache_key = "object_${class}_db_columns";
+    return @{ $cache->{$cache_key} } if $cache->{$cache_key};
+    # Currently you can only add new columns using object_columns, not
+    # remove or modify existing columns, because removing columns would
+    # almost certainly cause Bugzilla to function improperly.
+    my @add_columns;
+    Bugzilla::Hook::process('object_columns',
+                            { class => $class, columns => \@add_columns });
+    my @columns = ($invocant->DB_COLUMNS, @add_columns);
+    $cache->{$cache_key} = \@columns;
+    return @{ $cache->{$cache_key} };
+}
+
+# This method is private and should only be called by Bugzilla::Object.
+sub _get_validators {
+    my $invocant = shift;
+    my $class = ref($invocant) || $invocant;
+    my $cache = Bugzilla->request_cache;
+    my $cache_key = "object_${class}_validators";
+    return $cache->{$cache_key} if $cache->{$cache_key};
+    # We copy this into a hash so that the hook doesn't modify the constant.
+    # (That could be bad in mod_perl.)
+    my %validators = %{ $invocant->VALIDATORS };
+    Bugzilla::Hook::process('object_validators', 
+                            { class => $class, validators => \%validators });
+    $cache->{$cache_key} = \%validators;
+    return $cache->{$cache_key};
+}
+
+# These are all the fields that need to be checked, always, when
+# calling create(), because they have no DEFAULT and they are marked
+# NOT NULL.
+sub _required_create_fields {
+    my $class = shift;
+    my $dbh = Bugzilla->dbh;
+    my $table = $class->DB_TABLE;
+
+    my @columns = $dbh->bz_table_columns($table);
+    my @required;
+    foreach my $column (@columns) {
+        my $def = $dbh->bz_column_info($table, $column);
+        if ($def->{NOTNULL} and !defined $def->{DEFAULT}
+            # SERIAL fields effectively have a DEFAULT, but they're not
+            # listed as having a DEFAULT in DB::Schema.
+            and $def->{TYPE} !~ /serial/i) 
+        {
+            my $field = $class->REQUIRED_FIELD_MAP->{$column} || $column;
+            push(@required, $field);
+        }
+    }
+    push(@required, $class->EXTRA_REQUIRED_FIELDS);
+    return @required;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Object - A base class for objects in Bugzilla.
+
+=head1 SYNOPSIS
+
+ my $object = new Bugzilla::Object(1);
+ my $object = new Bugzilla::Object({name => 'TestProduct'});
+
+ my $id          = $object->id;
+ my $name        = $object->name;
+
+=head1 DESCRIPTION
+
+Bugzilla::Object is a base class for Bugzilla objects. You never actually
+create a Bugzilla::Object directly, you only make subclasses of it.
+
+Basically, Bugzilla::Object exists to allow developers to create objects
+more easily. All you have to do is define C<DB_TABLE>, C<DB_COLUMNS>,
+and sometimes C<LIST_ORDER> and you have a whole new object.
+
+You should also define accessors for any columns other than C<name>
+or C<id>.
+
+=head1 CONSTANTS
+
+Frequently, these will be the only things you have to define in your
+subclass in order to have a fully-functioning object. C<DB_TABLE>
+and C<DB_COLUMNS> are required.
+
+=over
+
+=item C<DB_TABLE>
+
+The name of the table that these objects are stored in. For example,
+for C<Bugzilla::Keyword> this would be C<keyworddefs>.
+
+=item C<DB_COLUMNS>
+
+The names of the columns that you want to read out of the database
+and into this object. This should be an array.
+
+I<Note>: Though normally you will never need to access this constant's data 
+directly in your subclass, if you do, you should access it by calling the
+C<_get_db_columns> method instead of accessing the constant directly. (The
+only exception to this rule is calling C<SUPER::DB_COLUMNS> from within
+your own C<DB_COLUMNS> subroutine in a subclass.)
+
+=item C<NAME_FIELD>
+
+The name of the column that should be considered to be the unique
+"name" of this object. The 'name' is a B<string> that uniquely identifies
+this Object in the database. Defaults to 'name'. When you specify 
+C<< {name => $name} >> to C<new()>, this is the column that will be 
+matched against in the DB.
+
+=item C<ID_FIELD>
+
+The name of the column that represents the unique B<integer> ID
+of this object in the database. Defaults to 'id'.
+
+=item C<LIST_ORDER>
+
+The order that C<new_from_list> and C<get_all> should return objects
+in. This should be the name of a database column. Defaults to
+L</NAME_FIELD>.
+
+=item C<VALIDATORS>
+
+A hashref that points to a function that will validate each param to
+L</create>. 
+
+Validators are called both by L</create> and L</set>. When
+they are called by L</create>, the first argument will be the name
+of the class (what we normally call C<$class>).
+
+When they are called by L</set>, the first argument will be
+a reference to the current object (what we normally call C<$self>).
+
+The second argument will be the value passed to L</create> or 
+L</set>for that field. 
+
+The third argument will be the name of the field being validated.
+This may be required by validators which validate several distinct fields.
+
+These functions should call L<Bugzilla::Error/ThrowUserError> if they fail.
+
+The validator must return the validated value.
+
+=item C<UPDATE_VALIDATORS>
+
+This is just like L</VALIDATORS>, but these validators are called only
+when updating an object, not when creating it. Any validator that appears
+here must not appear in L</VALIDATORS>.
+
+L<Bugzilla::Bug> has good examples in its code of when to use this.
+
+=item C<VALIDATOR_DEPENDENCIES>
+
+During L</create> and L</set_all>, validators are normally called in
+a somewhat-random order.  If you need one field to be validated and set
+before another field, this constant is how you do it, by saying that
+one field "depends" on the value of other fields.
+
+This is a hashref, where the keys are field names and the values are
+arrayrefs of field names. You specify what fields a field depends on using
+the arrayrefs. So, for example, to say that a C<component> field depends
+on the C<product> field being set, you would do:
+
+ component => ['product']
+
+=item C<UPDATE_COLUMNS>
+
+A list of columns to update when L</update> is called.
+If a field can't be changed, it shouldn't be listed here. (For example,
+the L</ID_FIELD> usually can't be updated.)
+
+=item C<REQUIRED_FIELD_MAP>
+
+This is a hashref that maps database column names to L</create> argument
+names. You only need to specify values for fields where the argument passed
+to L</create> has a different name in the database than it does in the
+L</create> arguments. (For example, L<Bugzilla::Bug/create> takes a
+C<product> argument, but the column name in the C<bugs> table is
+C<product_id>.)
+
+=item C<EXTRA_REQUIRED_FIELDS>
+
+Normally, Bugzilla::Object automatically figures out which fields
+are required for L</create>. It then I<always> runs those fields' validators,
+even if those fields weren't passed as arguments to L</create>. That way,
+any default values or required checks can be done for those fields by
+the validators.
+
+L</create> figures out which fields are required by looking for database
+columns in the L</DB_TABLE> that are NOT NULL and have no DEFAULT set.
+However, there are some fields that this check doesn't work for:
+
+=over
+
+=item *
+
+Fields that have database defaults (or are marked NULL in the database)
+but actually have different defaults specified by validators. (For example,
+the qa_contact field in the C<bugs> table can be NULL, so it won't be
+caught as being required. However, in reality it defaults to the
+component's initial_qa_contact.)
+
+=item * 
+
+Fields that have defaults that should be set by validators, but are
+actually stored in a table different from L</DB_TABLE> (like the "cc"
+field for bugs, which defaults to the "initialcc" of the Component, but won't
+be caught as a normal required field because it's in a separate table.) 
+
+=back
+
+Any field matching the above criteria needs to have its name listed in
+this constant. For an example of use, see the code of L<Bugzilla::Bug>.
+
+=item C<NUMERIC_COLUMNS>
+
+When L</update> is called, it compares each column in the object to its
+current value in the database. It only updates columns that have changed.
+
+Any column listed in NUMERIC_COLUMNS is treated as a number, not as a string,
+during these comparisons.
+
+=item C<DATE_COLUMNS>
+
+This is much like L</NUMERIC_COLUMNS>, except that it treats strings as
+dates when being compared. So, for example, C<2007-01-01> would be
+equal to C<2007-01-01 00:00:00>.
+
+=back
+
+=head1 METHODS
+
+=head2 Constructors
+
+=over
+
+=item C<new>
+
+=over
+
+=item B<Description>
+
+The constructor is used to load an existing object from the database,
+by id or by name.
+
+=item B<Params>
+
+If you pass an integer, the integer is the id of the object, 
+from the database, that we  want to read in. (id is defined
+as the value in the L</ID_FIELD> column).
+
+If you pass in a hashref, you can pass a C<name> key. The 
+value of the C<name> key is the case-insensitive name of the object 
+(from L</NAME_FIELD>) in the DB. You can also pass in an C<id> key
+which will be interpreted as the id of the object you want (overriding the 
+C<name> key).
+
+B<Additional Parameters Available for Subclasses>
+
+If you are a subclass of C<Bugzilla::Object>, you can pass
+C<condition> and C<values> as hash keys, instead of the above.
+
+C<condition> is a set of SQL conditions for the WHERE clause, which contain
+placeholders.
+
+C<values> is a reference to an array. The array contains the values
+for each placeholder in C<condition>, in order.
+
+This is to allow subclasses to have complex parameters, and then to
+translate those parameters into C<condition> and C<values> when they
+call C<< $self->SUPER::new >> (which is this function, usually).
+
+If you try to call C<new> outside of a subclass with the C<condition>
+and C<values> parameters, Bugzilla will throw an error. These parameters
+are intended B<only> for use by subclasses.
+
+=item B<Returns>
+
+A fully-initialized object, or C<undef> if there is no object in the
+database matching the parameters you passed in.
+
+=back
+
+=item C<check>
+
+=over
+
+=item B<Description>
+
+Checks if there is an object in the database with the specified name, and
+throws an error if you specified an empty name, or if there is no object
+in the database with that name.
+
+=item B<Params>
+
+The parameters are the same as for L</new>, except that if you don't pass
+a hashref, the single argument is the I<name> of the object, not the id.
+
+=item B<Returns>
+
+A fully initialized object, guaranteed.
+
+=item B<Notes For Implementors>
+
+If you implement this in your subclass, make sure that you also update
+the C<object_name> block at the bottom of the F<global/user-error.html.tmpl>
+template.
+
+=back
+
+=item C<new_from_list(\@id_list)>
+
+ Description: Creates an array of objects, given an array of ids.
+
+ Params:      \@id_list - A reference to an array of numbers, database ids.
+                          If any of these are not numeric, the function
+                          will throw an error. If any of these are not
+                          valid ids in the database, they will simply 
+                          be skipped.
+
+ Returns:     A reference to an array of objects.
+
+=item C<match>
+
+=over
+
+=item B<Description>
+
+Gets a list of objects from the database based on certain criteria.
+
+Basically, a simple way of doing a sort of "SELECT" statement (like SQL)
+to get objects.
+
+All criteria are joined by C<AND>, so adding more criteria will give you
+a smaller set of results, not a larger set.
+
+=item B<Params>
+
+A hashref, where the keys are column names of the table, pointing to the 
+value that you want to match against for that column. 
+
+There are two special values, the constants C<NULL> and C<NOT_NULL>,
+which means "give me objects where this field is NULL or NOT NULL,
+respectively."
+
+In addition to the column keys, there are a few special keys that
+can be used to rig the underlying database queries. These are 
+C<LIMIT>, C<OFFSET>, and C<WHERE>.
+
+The value for the C<LIMIT> key is expected to be an integer defining 
+the number of objects to return, while the value for C<OFFSET> defines
+the position, relative to the number of objects the query would normally 
+return, at which to begin the result set. If C<OFFSET> is defined without 
+a corresponding C<LIMIT> it is silently ignored.
+
+The C<WHERE> key provides a mechanism for adding arbitrary WHERE
+clauses to the underlying query. Its value is expected to a hash 
+reference whose keys are the columns, operators and placeholders, and the 
+values are the placeholders' bind value. For example:
+
+ WHERE => { 'some_column >= ?' => $some_value }
+
+would constrain the query to only those objects in the table whose
+'some_column' column has a value greater than or equal to $some_value.
+
+If you don't specify any criteria, calling this function is the same
+as doing C<[$class-E<gt>get_all]>.
+
+=item B<Returns>
+
+An arrayref of objects, or an empty arrayref if there are no matches.
+
+=back
+
+=back
+
+=head2 Database Manipulation
+
+=over
+
+=item C<create>
+
+Description: Creates a new item in the database.
+             Throws a User Error if any of the passed-in params
+             are invalid.
+
+Params:      C<$params> - hashref - A value to put in each database
+             field for this object.
+
+Returns:     The Object just created in the database.
+
+Notes:       In order for this function to work in your subclass,
+             your subclass's L</ID_FIELD> must be of C<SERIAL>
+             type in the database.
+
+Subclass Implementors:
+             This function basically just calls 
+             L</check_required_create_fields>, then
+             L</run_create_validators>, and then finally
+             L</insert_create_data>. So if you have a complex system that
+             you need to implement, you can do it by calling these
+             three functions instead of C<SUPER::create>.
+
+=item C<check_required_create_fields>
+
+=over
+
+=item B<Description>
+
+Part of L</create>. Modifies the incoming C<$params> argument so that
+any field that does not have a database default will be checked
+later by L</run_create_validators>, even if that field wasn't specified
+as an argument to L</create>.
+
+=item B<Params>
+
+=over
+
+=item C<$params> - The same as C<$params> from L</create>.
+
+=back
+
+=item B<Returns> (nothing)
+
+=back
+
+=item C<run_create_validators>
+
+Description: Runs the validation of input parameters for L</create>.
+             This subroutine exists so that it can be overridden
+             by subclasses who need to do special validations
+             of their input parameters. This method is B<only> called
+             by L</create>.
+
+Params:      C<$params> - hashref - A value to put in each database
+             field for this object.
+             C<$options> - hashref - Processing options. Currently
+             the only option supported is B<skip>, which can be
+             used to specify a list of fields to not validate.
+
+Returns:     A hash, in a similar format as C<$params>, except that
+             these are the values to be inserted into the database,
+             not the values that were input to L</create>.
+
+=item C<insert_create_data>
+
+Part of L</create>.
+
+Takes the return value from L</run_create_validators> and inserts the
+data into the database. Returns a newly created object. 
+
+=item C<update>
+
+=over
+
+=item B<Description>
+
+Saves the values currently in this object to the database.
+Only the fields specified in L</UPDATE_COLUMNS> will be
+updated, and they will only be updated if their values have changed.
+
+=item B<Params> (none)
+
+=item B<Returns>
+
+B<In scalar context:>
+
+A hashref showing what changed during the update. The keys are the column
+names from L</UPDATE_COLUMNS>. If a field was not changed, it will not be
+in the hash at all. If the field was changed, the key will point to an arrayref.
+The first item of the arrayref will be the old value, and the second item
+will be the new value.
+
+If there were no changes, we return a reference to an empty hash.
+
+B<In array context:>
+
+Returns a list, where the first item is the above hashref. The second item
+is the object as it was in the database before update() was called. (This
+is mostly useful to subclasses of C<Bugzilla::Object> that are implementing
+C<update>.)
+
+=back
+
+=item C<remove_from_db>
+
+Removes this object from the database. Will throw an error if you can't
+remove it for some reason. The object will then be destroyed, as it is
+not safe to use the object after it has been removed from the database.
+
+=back
+
+=head2 Mutators
+
+These are used for updating the values in objects, before calling
+C<update>.
+
+=over
+
+=item C<set>
+
+=over
+
+=item B<Description>
+
+Sets a certain hash member of this class to a certain value.
+Used for updating fields. Calls the validator for this field,
+if it exists. Subclasses should use this function
+to implement the various C<set_> mutators for their different
+fields.
+
+If your class defines a method called C<_set_global_validator>,
+C<set> will call it with C<($value, $field)> as arguments, after running
+the validator for this particular field. C<_set_global_validator> does not
+return anything.
+
+See L</VALIDATORS> for more information.
+
+B<NOTE>: This function is intended only for use by subclasses. If
+you call it from anywhere else, it will throw a C<CodeError>.
+
+=item B<Params>
+
+=over
+
+=item C<$field> - The name of the hash member to update. This should
+be the same as the name of the field in L</VALIDATORS>, if it exists there.
+
+=item C<$value> - The value that you're setting the field to.
+
+=back
+
+=item B<Returns> (nothing)
+
+=back
+
+
+=item C<set_all>
+
+=over
+
+=item B<Description>
+
+This is a convenience function which is simpler than calling many different
+C<set_> functions in a row. You pass a hashref of parameters and it calls
+C<set_$key($value)> for every item in the hashref.
+
+=item B<Params>
+
+Takes a hashref of the fields that need to be set, pointing to the value
+that should be passed to the C<set_> function that is called.
+
+=item B<Returns> (nothing)
+
+=back
+
+
+=back
+
+=head2 Simple Validators
+
+You can use these in your subclass L</VALIDATORS> or L</UPDATE_VALIDATORS>.
+Note that you have to reference them like C<\&Bugzilla::Object::check_boolean>,
+you can't just write C<\&check_boolean>.
+
+=over
+
+=item C<check_boolean>
+
+Returns C<1> if the passed-in value is true, C<0> otherwise.
+
+=back
+
+=head1 CLASS FUNCTIONS
+
+=over
+
+=item C<any_exist>
+
+Returns C<1> if there are any of these objects in the database,
+C<0> otherwise.
+
+=item C<get_all>
+
+ Description: Returns all objects in this table from the database.
+
+ Params:      none.
+
+ Returns:     A list of objects, or an empty list if there are none.
+
+ Notes:       Note that you must call this as $class->get_all. For 
+              example, Bugzilla::Keyword->get_all. 
+              Bugzilla::Keyword::get_all will not work.
+
+=back
+
+=cut

diff --git a/Bugzilla/Product.pm b/Bugzilla/Product.pm
new file mode 100644 (file)
index 0000000..fdebc6b
--- /dev/null
+++ b/Bugzilla/Product.pm
@@ -0,0 +1,1069 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Product;
+use strict;
+use base qw(Bugzilla::Field::ChoiceInterface Bugzilla::Object);
+
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Group;
+use Bugzilla::Version;
+use Bugzilla::Milestone;
+use Bugzilla::Field;
+use Bugzilla::Status;
+use Bugzilla::Install::Requirements;
+use Bugzilla::Mailer;
+use Bugzilla::Series;
+use Bugzilla::Hook;
+use Bugzilla::FlagType;
+
+use Scalar::Util qw(blessed);
+
+use constant DEFAULT_CLASSIFICATION_ID => 1;
+
+###############################
+####    Initialization     ####
+###############################
+
+use constant DB_TABLE => 'products';
+
+use constant DB_COLUMNS => qw(
+   id
+   name
+   classification_id
+   description
+   isactive
+   defaultmilestone
+   allows_unconfirmed
+);
+
+use constant UPDATE_COLUMNS => qw(
+    name
+    description
+    defaultmilestone
+    isactive
+    allows_unconfirmed
+);
+
+use constant VALIDATORS => {
+    allows_unconfirmed => \&Bugzilla::Object::check_boolean,
+    classification   => \&_check_classification,
+    name             => \&_check_name,
+    description      => \&_check_description,
+    version          => \&_check_version,
+    defaultmilestone => \&_check_default_milestone,
+    isactive         => \&Bugzilla::Object::check_boolean,
+    create_series    => \&Bugzilla::Object::check_boolean
+};
+
+###############################
+####     Constructors     #####
+###############################
+
+sub create {
+    my $class = shift;
+    my $dbh = Bugzilla->dbh;
+
+    $dbh->bz_start_transaction();
+
+    $class->check_required_create_fields(@_);
+
+    my $params = $class->run_create_validators(@_);
+    # Some fields do not exist in the DB as is.
+    if (defined $params->{classification}) {
+        $params->{classification_id} = delete $params->{classification}; 
+    }
+    my $version = delete $params->{version};
+    my $create_series = delete $params->{create_series};
+
+    my $product = $class->insert_create_data($params);
+    Bugzilla->user->clear_product_cache();
+
+    # Add the new version and milestone into the DB as valid values.
+    Bugzilla::Version->create({ value => $version, product => $product });
+    Bugzilla::Milestone->create({ value => $product->default_milestone, 
+                                  product => $product });
+
+    # Create groups and series for the new product, if requested.
+    $product->_create_bug_group() if Bugzilla->params->{'makeproductgroups'};
+    $product->_create_series() if $create_series;
+
+    Bugzilla::Hook::process('product_end_of_create', { product => $product });
+
+    $dbh->bz_commit_transaction();
+    return $product;
+}
+
+# This is considerably faster than calling new_from_list three times
+# for each product in the list, particularly with hundreds or thousands
+# of products.
+sub preload {
+    my ($products, $preload_flagtypes) = @_;
+    my %prods = map { $_->id => $_ } @$products;
+    my @prod_ids = keys %prods;
+    return unless @prod_ids;
+
+    # We cannot |use| it due to a dependency loop with Bugzilla::User.
+    require Bugzilla::Component;
+    foreach my $field (qw(component version milestone)) {
+        my $classname = "Bugzilla::" . ucfirst($field);
+        my $objects = $classname->match({ product_id => \@prod_ids });
+
+        # Now populate the products with this set of objects.
+        foreach my $obj (@$objects) {
+            my $product_id = $obj->product_id;
+            $prods{$product_id}->{"${field}s"} ||= [];
+            push(@{$prods{$product_id}->{"${field}s"}}, $obj);
+        }
+    }
+    if ($preload_flagtypes) {
+        $_->flag_types foreach @$products;
+    }
+}
+
+sub update {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    # Don't update the DB if something goes wrong below -> transaction.
+    $dbh->bz_start_transaction();
+    my ($changes, $old_self) = $self->SUPER::update(@_);
+
+    # Also update group settings.
+    if ($self->{check_group_controls}) {
+        require Bugzilla::Bug;
+        import Bugzilla::Bug qw(LogActivityEntry);
+
+        my $old_settings = $old_self->group_controls;
+        my $new_settings = $self->group_controls;
+        my $timestamp = $dbh->selectrow_array('SELECT NOW()');
+
+        foreach my $gid (keys %$new_settings) {
+            my $old_setting = $old_settings->{$gid} || {};
+            my $new_setting = $new_settings->{$gid};
+            # If all new settings are 0 for a given group, we delete the entry
+            # from group_control_map, so we have to track it here.
+            my $all_zero = 1;
+            my @fields;
+            my @values;
+
+            foreach my $field ('entry', 'membercontrol', 'othercontrol', 'canedit',
+                               'editcomponents', 'editbugs', 'canconfirm')
+            {
+                my $old_value = $old_setting->{$field};
+                my $new_value = $new_setting->{$field};
+                $all_zero = 0 if $new_value;
+                next if (defined $old_value && $old_value == $new_value);
+                push(@fields, $field);
+                # The value has already been validated.
+                detaint_natural($new_value);
+                push(@values, $new_value);
+            }
+            # Is there anything to update?
+            next unless scalar @fields;
+
+            if ($all_zero) {
+                $dbh->do('DELETE FROM group_control_map
+                          WHERE product_id = ? AND group_id = ?',
+                          undef, $self->id, $gid);
+            }
+            else {
+                if (exists $old_setting->{group}) {
+                    # There is already an entry in the DB.
+                    my $set_fields = join(', ', map {"$_ = ?"} @fields);
+                    $dbh->do("UPDATE group_control_map SET $set_fields
+                              WHERE product_id = ? AND group_id = ?",
+                              undef, (@values, $self->id, $gid));
+                }
+                else {
+                    # No entry yet.
+                    my $fields = join(', ', @fields);
+                    # +2 because of the product and group IDs.
+                    my $qmarks = join(',', ('?') x (scalar @fields + 2));
+                    $dbh->do("INSERT INTO group_control_map (product_id, group_id, $fields)
+                              VALUES ($qmarks)", undef, ($self->id, $gid, @values));
+                }
+            }
+
+            # If the group is mandatory, restrict all bugs to it.
+            if ($new_setting->{membercontrol} == CONTROLMAPMANDATORY) {
+                my $bug_ids =
+                  $dbh->selectcol_arrayref('SELECT bugs.bug_id
+                                              FROM bugs
+                                                   LEFT JOIN bug_group_map
+                                                   ON bug_group_map.bug_id = bugs.bug_id
+                                                   AND group_id = ?
+                                             WHERE product_id = ?
+                                                   AND bug_group_map.bug_id IS NULL',
+                                             undef, $gid, $self->id);
+
+                if (scalar @$bug_ids) {
+                    my $sth = $dbh->prepare('INSERT INTO bug_group_map (bug_id, group_id)
+                                             VALUES (?, ?)');
+
+                    foreach my $bug_id (@$bug_ids) {
+                        $sth->execute($bug_id, $gid);
+                        # Add this change to the bug history.
+                        LogActivityEntry($bug_id, 'bug_group', '',
+                                         $new_setting->{group}->name,
+                                         Bugzilla->user->id, $timestamp);
+                    }
+                    push(@{$changes->{'_group_controls'}->{'now_mandatory'}},
+                         {name      => $new_setting->{group}->name,
+                          bug_count => scalar @$bug_ids});
+                }
+            }
+            # If the group can no longer be used to restrict bugs, remove them.
+            elsif ($new_setting->{membercontrol} == CONTROLMAPNA) {
+                my $bug_ids =
+                  $dbh->selectcol_arrayref('SELECT bugs.bug_id
+                                              FROM bugs
+                                                   INNER JOIN bug_group_map
+                                                   ON bug_group_map.bug_id = bugs.bug_id
+                                             WHERE product_id = ? AND group_id = ?',
+                                             undef, $self->id, $gid);
+
+                if (scalar @$bug_ids) {
+                    $dbh->do('DELETE FROM bug_group_map WHERE group_id = ? AND ' .
+                              $dbh->sql_in('bug_id', $bug_ids), undef, $gid);
+
+                    # Add this change to the bug history.
+                    foreach my $bug_id (@$bug_ids) {
+                        LogActivityEntry($bug_id, 'bug_group',
+                                         $old_setting->{group}->name, '',
+                                         Bugzilla->user->id, $timestamp);
+                    }
+                    push(@{$changes->{'_group_controls'}->{'now_na'}},
+                         {name => $old_setting->{group}->name,
+                          bug_count => scalar @$bug_ids});
+                }
+            }
+        }
+
+        delete $self->{groups_available};
+        delete $self->{groups_mandatory};
+    }
+    $dbh->bz_commit_transaction();
+    # Changes have been committed.
+    delete $self->{check_group_controls};
+    Bugzilla->user->clear_product_cache();
+
+    return $changes;
+}
+
+sub remove_from_db {
+    my ($self, $params) = @_;
+    my $user = Bugzilla->user;
+    my $dbh = Bugzilla->dbh;
+
+    $dbh->bz_start_transaction();
+
+    $self->_check_if_controller();
+
+    if ($self->bug_count) {
+        if (Bugzilla->params->{'allowbugdeletion'}) {
+            require Bugzilla::Bug;
+            foreach my $bug_id (@{$self->bug_ids}) {
+                # Note that we allow the user to delete bugs he can't see,
+                # which is okay, because he's deleting the whole Product.
+                my $bug = new Bugzilla::Bug($bug_id);
+                $bug->remove_from_db();
+            }
+        }
+        else {
+            ThrowUserError('product_has_bugs', { nb => $self->bug_count });
+        }
+    }
+
+    if ($params->{delete_series}) {
+        my $series_ids =
+          $dbh->selectcol_arrayref('SELECT series_id
+                                      FROM series
+                                INNER JOIN series_categories
+                                        ON series_categories.id = series.category
+                                     WHERE series_categories.name = ?',
+                                    undef, $self->name);
+
+        if (scalar @$series_ids) {
+            $dbh->do('DELETE FROM series WHERE ' . $dbh->sql_in('series_id', $series_ids));
+        }
+
+        # If no subcategory uses this product name, completely purge it.
+        my $in_use =
+          $dbh->selectrow_array('SELECT 1
+                                   FROM series
+                             INNER JOIN series_categories
+                                     ON series_categories.id = series.subcategory
+                                  WHERE series_categories.name = ? ' .
+                                   $dbh->sql_limit(1),
+                                  undef, $self->name);
+        if (!$in_use) {
+            $dbh->do('DELETE FROM series_categories WHERE name = ?', undef, $self->name);
+        }
+    }
+
+    $self->SUPER::remove_from_db();
+
+    $dbh->bz_commit_transaction();
+
+    # We have to delete these internal variables, else we get
+    # the old lists of products and classifications again.
+    delete $user->{selectable_products};
+    delete $user->{selectable_classifications};
+
+}
+
+###############################
+####      Validators       ####
+###############################
+
+sub _check_classification {
+    my ($invocant, $classification_name) = @_;
+
+    my $classification_id = 1;
+    if (Bugzilla->params->{'useclassification'}) {
+        my $classification = Bugzilla::Classification->check($classification_name);
+        $classification_id = $classification->id;
+    }
+    return $classification_id;
+}
+
+sub _check_name {
+    my ($invocant, $name) = @_;
+
+    $name = trim($name);
+    $name || ThrowUserError('product_blank_name');
+
+    if (length($name) > MAX_PRODUCT_SIZE) {
+        ThrowUserError('product_name_too_long', {'name' => $name});
+    }
+
+    my $product = new Bugzilla::Product({name => $name});
+    if ($product && (!ref $invocant || $product->id != $invocant->id)) {
+        # Check for exact case sensitive match:
+        if ($product->name eq $name) {
+            ThrowUserError('product_name_already_in_use', {'product' => $product->name});
+        }
+        else {
+            ThrowUserError('product_name_diff_in_case', {'product'          => $name,
+                                                         'existing_product' => $product->name});
+        }
+    }
+    return $name;
+}
+
+sub _check_description {
+    my ($invocant, $description) = @_;
+
+    $description  = trim($description);
+    $description || ThrowUserError('product_must_have_description');
+    return $description;
+}
+
+sub _check_version {
+    my ($invocant, $version) = @_;
+
+    $version = trim($version);
+    $version || ThrowUserError('product_must_have_version');
+    # We will check the version length when Bugzilla::Version->create will do it.
+    return $version;
+}
+
+sub _check_default_milestone {
+    my ($invocant, $milestone) = @_;
+
+    # Do nothing if target milestones are not in use.
+    unless (Bugzilla->params->{'usetargetmilestone'}) {
+        return (ref $invocant) ? $invocant->default_milestone : '---';
+    }
+
+    $milestone = trim($milestone);
+
+    if (ref $invocant) {
+        # The default milestone must be one of the existing milestones.
+        my $mil_obj = new Bugzilla::Milestone({name => $milestone, product => $invocant});
+
+        $mil_obj || ThrowUserError('product_must_define_defaultmilestone',
+                                   {product   => $invocant->name,
+                                    milestone => $milestone});
+    }
+    else {
+        $milestone ||= '---';
+    }
+    return $milestone;
+}
+
+sub _check_milestone_url {
+    my ($invocant, $url) = @_;
+
+    # Do nothing if target milestones are not in use.
+    unless (Bugzilla->params->{'usetargetmilestone'}) {
+        return (ref $invocant) ? $invocant->milestone_url : '';
+    }
+
+    $url = trim($url || '');
+    return $url;
+}
+
+#####################################
+# Implement Bugzilla::Field::Choice #
+#####################################
+
+use constant FIELD_NAME => 'product';
+use constant is_default => 0;
+
+###############################
+####       Methods         ####
+###############################
+
+sub _create_bug_group {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    my $group_name = $self->name;
+    while (new Bugzilla::Group({name => $group_name})) {
+        $group_name .= '_';
+    }
+    my $group_description = get_text('bug_group_description', {product => $self});
+
+    my $group = Bugzilla::Group->create({name        => $group_name,
+                                         description => $group_description,
+                                         isbuggroup  => 1});
+
+    # Associate the new group and new product.
+    $dbh->do('INSERT INTO group_control_map
+              (group_id, product_id, membercontrol, othercontrol)
+              VALUES (?, ?, ?, ?)',
+              undef, ($group->id, $self->id, CONTROLMAPDEFAULT, CONTROLMAPNA));
+}
+
+sub _create_series {
+    my $self = shift;
+
+    my @series;
+    # We do every status, every resolution, and an "opened" one as well.
+    foreach my $bug_status (@{get_legal_field_values('bug_status')}) {
+        push(@series, [$bug_status, "bug_status=" . url_quote($bug_status)]);
+    }
+
+    foreach my $resolution (@{get_legal_field_values('resolution')}) {
+        next if !$resolution;
+        push(@series, [$resolution, "resolution=" . url_quote($resolution)]);
+    }
+
+    my @openedstatuses = BUG_STATE_OPEN;
+    my $query = join("&", map { "bug_status=" . url_quote($_) } @openedstatuses);
+    push(@series, [get_text('series_all_open'), $query]);
+
+    foreach my $sdata (@series) {
+        my $series = new Bugzilla::Series(undef, $self->name,
+                        get_text('series_subcategory'),
+                        $sdata->[0], Bugzilla->user->id, 1,
+                        $sdata->[1] . "&product=" . url_quote($self->name), 1);
+        $series->writeToDatabase();
+    }
+}
+
+sub set_name { $_[0]->set('name', $_[1]); }
+sub set_description { $_[0]->set('description', $_[1]); }
+sub set_default_milestone { $_[0]->set('defaultmilestone', $_[1]); }
+sub set_is_active { $_[0]->set('isactive', $_[1]); }
+sub set_allows_unconfirmed { $_[0]->set('allows_unconfirmed', $_[1]); }
+
+sub set_group_controls {
+    my ($self, $group, $settings) = @_;
+
+    $group->is_active_bug_group
+      || ThrowUserError('product_illegal_group', {group => $group});
+
+    scalar(keys %$settings)
+      || ThrowCodeError('product_empty_group_controls', {group => $group});
+
+    # We store current settings for this group.
+    my $gs = $self->group_controls->{$group->id};
+    # If there is no entry for this group yet, create a default hash.
+    unless (defined $gs) {
+        $gs = { entry          => 0,
+                membercontrol  => CONTROLMAPNA,
+                othercontrol   => CONTROLMAPNA,
+                canedit        => 0,
+                editcomponents => 0,
+                editbugs       => 0,
+                canconfirm     => 0,
+                group          => $group };
+    }
+
+    # Both settings must be defined, or none of them can be updated.
+    if (defined $settings->{membercontrol} && defined $settings->{othercontrol}) {
+        #  Legality of control combination is a function of
+        #  membercontrol\othercontrol
+        #                 NA SH DE MA
+        #              NA  +  -  -  -
+        #              SH  +  +  +  +
+        #              DE  +  -  +  +
+        #              MA  -  -  -  +
+        foreach my $field ('membercontrol', 'othercontrol') {
+            my ($is_legal) = grep { $settings->{$field} == $_ }
+              (CONTROLMAPNA, CONTROLMAPSHOWN, CONTROLMAPDEFAULT, CONTROLMAPMANDATORY);
+            defined $is_legal || ThrowCodeError('product_illegal_group_control',
+                                   { field => $field, value => $settings->{$field} });
+        }
+        unless ($settings->{membercontrol} == $settings->{othercontrol}
+                || $settings->{membercontrol} == CONTROLMAPSHOWN
+                || ($settings->{membercontrol} == CONTROLMAPDEFAULT
+                    && $settings->{othercontrol} != CONTROLMAPSHOWN))
+        {
+            ThrowUserError('illegal_group_control_combination', {groupname => $group->name});
+        }
+        $gs->{membercontrol} = $settings->{membercontrol};
+        $gs->{othercontrol} = $settings->{othercontrol};
+    }
+
+    foreach my $field ('entry', 'canedit', 'editcomponents', 'editbugs', 'canconfirm') {
+        next unless defined $settings->{$field};
+        $gs->{$field} = $settings->{$field} ? 1 : 0;
+    }
+    $self->{group_controls}->{$group->id} = $gs;
+    $self->{check_group_controls} = 1;
+}
+
+sub components {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    if (!defined $self->{components}) {
+        my $ids = $dbh->selectcol_arrayref(q{
+            SELECT id FROM components
+            WHERE product_id = ?
+            ORDER BY name}, undef, $self->id);
+
+        require Bugzilla::Component;
+        $self->{components} = Bugzilla::Component->new_from_list($ids);
+    }
+    return $self->{components};
+}
+
+sub group_controls {
+    my ($self, $full_data) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    # By default, we don't return groups which are not listed in
+    # group_control_map. If $full_data is true, then we also
+    # return groups whose settings could be set for the product.
+    my $where_or_and = 'WHERE';
+    my $and_or_where = 'AND';
+    if ($full_data) {
+        $where_or_and = 'AND';
+        $and_or_where = 'WHERE';
+    }
+
+    # If $full_data is true, we collect all the data in all cases,
+    # even if the cache is already populated.
+    # $full_data is never used except in the very special case where
+    # all configurable bug groups are displayed to administrators,
+    # so we don't care about collecting all the data again in this case.
+    if (!defined $self->{group_controls} || $full_data) {
+        # Include name to the list, to allow us sorting data more easily.
+        my $query = qq{SELECT id, name, entry, membercontrol, othercontrol,
+                              canedit, editcomponents, editbugs, canconfirm
+                         FROM groups
+                              LEFT JOIN group_control_map
+                              ON id = group_id 
+                $where_or_and product_id = ?
+                $and_or_where isbuggroup = 1};
+        $self->{group_controls} = 
+            $dbh->selectall_hashref($query, 'id', undef, $self->id);
+
+        # For each group ID listed above, create and store its group object.
+        my @gids = keys %{$self->{group_controls}};
+        my $groups = Bugzilla::Group->new_from_list(\@gids);
+        $self->{group_controls}->{$_->id}->{group} = $_ foreach @$groups;
+    }
+
+    # We never cache bug counts, for the same reason as above.
+    if ($full_data) {
+        my $counts =
+          $dbh->selectall_arrayref('SELECT group_id, COUNT(bugs.bug_id) AS bug_count
+                                      FROM bug_group_map
+                                INNER JOIN bugs
+                                        ON bugs.bug_id = bug_group_map.bug_id
+                                     WHERE bugs.product_id = ? ' .
+                                     $dbh->sql_group_by('group_id'),
+                          {'Slice' => {}}, $self->id);
+        foreach my $data (@$counts) {
+            $self->{group_controls}->{$data->{group_id}}->{bug_count} = $data->{bug_count};
+        }
+    }
+    return $self->{group_controls};
+}
+
+sub groups_available {
+    my ($self) = @_;
+    return $self->{groups_available} if defined $self->{groups_available};
+    my $dbh = Bugzilla->dbh;
+    my $shown = CONTROLMAPSHOWN;
+    my $default = CONTROLMAPDEFAULT;
+    my %member_groups = @{ $dbh->selectcol_arrayref(
+        "SELECT group_id, membercontrol
+           FROM group_control_map
+                INNER JOIN groups ON group_control_map.group_id = groups.id
+          WHERE isbuggroup = 1 AND isactive = 1 AND product_id = ?
+                AND (membercontrol = $shown OR membercontrol = $default)
+                AND " . Bugzilla->user->groups_in_sql(),
+        {Columns=>[1,2]}, $self->id) };
+    # We don't need to check the group membership here, because we only
+    # add these groups to the list below if the group isn't already listed
+    # for membercontrol.
+    my %other_groups = @{ $dbh->selectcol_arrayref(
+        "SELECT group_id, othercontrol
+           FROM group_control_map
+                INNER JOIN groups ON group_control_map.group_id = groups.id
+          WHERE isbuggroup = 1 AND isactive = 1 AND product_id = ?
+                AND (othercontrol = $shown OR othercontrol = $default)", 
+        {Columns=>[1,2]}, $self->id) };
+
+    # If the user is a member, then we use the membercontrol value.
+    # Otherwise, we use the othercontrol value.
+    my %all_groups = %member_groups;
+    foreach my $id (keys %other_groups) {
+        if (!defined $all_groups{$id}) {
+            $all_groups{$id} = $other_groups{$id};
+        }
+    }
+
+    my $available = Bugzilla::Group->new_from_list([keys %all_groups]);
+    foreach my $group (@$available) {
+        $group->{is_default} = 1 if $all_groups{$group->id} == $default;
+    }
+
+    $self->{groups_available} = $available;
+    return $self->{groups_available};
+}
+
+sub groups_mandatory {
+    my ($self) = @_;
+    return $self->{groups_mandatory} if $self->{groups_mandatory};
+    my $groups = Bugzilla->user->groups_as_string;
+    my $mandatory = CONTROLMAPMANDATORY;
+    # For membercontrol we don't check group_id IN, because if membercontrol
+    # is Mandatory, the group is Mandatory for everybody, regardless of their
+    # group membership.
+    my $ids = Bugzilla->dbh->selectcol_arrayref(
+        "SELECT group_id 
+           FROM group_control_map
+                INNER JOIN groups ON group_control_map.group_id = groups.id
+          WHERE product_id = ? AND isactive = 1
+                AND (membercontrol = $mandatory
+                     OR (othercontrol = $mandatory
+                         AND group_id NOT IN ($groups)))",
+        undef, $self->id);
+    $self->{groups_mandatory} = Bugzilla::Group->new_from_list($ids);
+    return $self->{groups_mandatory};
+}
+
+# We don't just check groups_valid, because we want to know specifically
+# if this group can be validly set by the currently-logged-in user.
+sub group_is_settable {
+    my ($self, $group) = @_;
+
+    return 0 unless ($group->is_active && $group->is_bug_group);
+
+    my $is_mandatory = grep { $group->id == $_->id }
+                            @{ $self->groups_mandatory };
+    my $is_available = grep { $group->id == $_->id }
+                            @{ $self->groups_available };
+    return ($is_mandatory or $is_available) ? 1 : 0;
+}
+
+sub group_is_valid {
+    my ($self, $group) = @_;
+    return grep($_->id == $group->id, @{ $self->groups_valid }) ? 1 : 0;
+}
+
+sub groups_valid {
+    my ($self) = @_;
+    return $self->{groups_valid} if defined $self->{groups_valid};
+    
+    # Note that we don't check OtherControl below, because there is no
+    # valid NA/* combination.
+    my $ids = Bugzilla->dbh->selectcol_arrayref(
+        "SELECT DISTINCT group_id
+          FROM group_control_map AS gcm
+               INNER JOIN groups ON gcm.group_id = groups.id
+         WHERE product_id = ? AND isbuggroup = 1
+               AND membercontrol != " . CONTROLMAPNA,  undef, $self->id);
+    $self->{groups_valid} = Bugzilla::Group->new_from_list($ids);
+    return $self->{groups_valid};
+}
+
+sub versions {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    if (!defined $self->{versions}) {
+        my $ids = $dbh->selectcol_arrayref(q{
+            SELECT id FROM versions
+            WHERE product_id = ?}, undef, $self->id);
+
+        $self->{versions} = Bugzilla::Version->new_from_list($ids);
+    }
+    return $self->{versions};
+}
+
+sub milestones {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    if (!defined $self->{milestones}) {
+        my $ids = $dbh->selectcol_arrayref(q{
+            SELECT id FROM milestones
+             WHERE product_id = ?}, undef, $self->id);
+ 
+        $self->{milestones} = Bugzilla::Milestone->new_from_list($ids);
+    }
+    return $self->{milestones};
+}
+
+sub bug_count {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    if (!defined $self->{'bug_count'}) {
+        $self->{'bug_count'} = $dbh->selectrow_array(qq{
+            SELECT COUNT(bug_id) FROM bugs
+            WHERE product_id = ?}, undef, $self->id);
+
+    }
+    return $self->{'bug_count'};
+}
+
+sub bug_ids {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    if (!defined $self->{'bug_ids'}) {
+        $self->{'bug_ids'} = 
+            $dbh->selectcol_arrayref(q{SELECT bug_id FROM bugs
+                                       WHERE product_id = ?},
+                                     undef, $self->id);
+    }
+    return $self->{'bug_ids'};
+}
+
+sub user_has_access {
+    my ($self, $user) = @_;
+
+    return Bugzilla->dbh->selectrow_array(
+        'SELECT CASE WHEN group_id IS NULL THEN 1 ELSE 0 END
+           FROM products LEFT JOIN group_control_map
+                ON group_control_map.product_id = products.id
+                   AND group_control_map.entry != 0
+                   AND group_id NOT IN (' . $user->groups_as_string . ')
+          WHERE products.id = ? ' . Bugzilla->dbh->sql_limit(1),
+          undef, $self->id);
+}
+
+sub flag_types {
+    my $self = shift;
+
+    return $self->{'flag_types'} if defined $self->{'flag_types'};
+
+    # We cache flag types to avoid useless calls to get_clusions().
+    my $cache = Bugzilla->request_cache->{flag_types_per_product} ||= {};
+    $self->{flag_types} = {};
+    my $prod_id = $self->id;
+    my $flagtypes = Bugzilla::FlagType::match({ product_id => $prod_id });
+
+    foreach my $type ('bug', 'attachment') {
+        my @flags = grep { $_->target_type eq $type } @$flagtypes;
+        $self->{flag_types}->{$type} = \@flags;
+
+        # Also populate component flag types, while we are here.
+        foreach my $comp (@{$self->components}) {
+            $comp->{flag_types} ||= {};
+            my $comp_id = $comp->id;
+
+            foreach my $flag (@flags) {
+                my $flag_id = $flag->id;
+                $cache->{$flag_id} ||= $flag;
+                my $i = $cache->{$flag_id}->inclusions_as_hash;
+                my $e = $cache->{$flag_id}->exclusions_as_hash;
+                my $included = $i->{0}->{0} || $i->{0}->{$comp_id}
+                               || $i->{$prod_id}->{0} || $i->{$prod_id}->{$comp_id};
+                my $excluded = $e->{0}->{0} || $e->{0}->{$comp_id}
+                               || $e->{$prod_id}->{0} || $e->{$prod_id}->{$comp_id};
+                push(@{$comp->{flag_types}->{$type}}, $flag) if ($included && !$excluded);
+            }
+        }
+    }
+    return $self->{'flag_types'};
+}
+
+sub classification {
+    my $self = shift;
+    $self->{'classification'} ||= 
+        new Bugzilla::Classification($self->classification_id);
+    return $self->{'classification'};
+}
+
+###############################
+####      Accessors      ######
+###############################
+
+sub allows_unconfirmed { return $_[0]->{'allows_unconfirmed'}; }
+sub description       { return $_[0]->{'description'};       }
+sub is_active         { return $_[0]->{'isactive'};       }
+sub default_milestone { return $_[0]->{'defaultmilestone'};  }
+sub classification_id { return $_[0]->{'classification_id'}; }
+
+###############################
+####      Subroutines    ######
+###############################
+
+sub check {
+    my ($class, $params) = @_;
+    $params = { name => $params } if !ref $params;
+    if (!$params->{allow_inaccessible}) {
+        $params->{_error} = 'product_access_denied';
+    }
+    my $product = $class->SUPER::check($params);
+
+    if (!$params->{allow_inaccessible}
+        && !Bugzilla->user->can_access_product($product))
+    {
+        ThrowUserError('product_access_denied', $params);
+    }
+    return $product;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Product - Bugzilla product class.
+
+=head1 SYNOPSIS
+
+    use Bugzilla::Product;
+
+    my $product = new Bugzilla::Product(1);
+    my $product = new Bugzilla::Product({ name => 'AcmeProduct' });
+
+    my @components      = $product->components();
+    my $groups_controls = $product->group_controls();
+    my @milestones      = $product->milestones();
+    my @versions        = $product->versions();
+    my $bugcount        = $product->bug_count();
+    my $bug_ids         = $product->bug_ids();
+    my $has_access      = $product->user_has_access($user);
+    my $flag_types      = $product->flag_types();
+    my $classification  = $product->classification();
+
+    my $id               = $product->id;
+    my $name             = $product->name;
+    my $description      = $product->description;
+    my isactive          = $product->is_active;
+    my $defaultmilestone = $product->default_milestone;
+    my $classificationid = $product->classification_id;
+    my $allows_unconfirmed = $product->allows_unconfirmed;
+
+=head1 DESCRIPTION
+
+Product.pm represents a product object. It is an implementation
+of L<Bugzilla::Object>, and thus provides all methods that
+L<Bugzilla::Object> provides.
+
+The methods that are specific to C<Bugzilla::Product> are listed 
+below.
+
+=head1 METHODS
+
+=over
+
+=item C<components>
+
+ Description: Returns an array of component objects belonging to
+              the product.
+
+ Params:      none.
+
+ Returns:     An array of Bugzilla::Component object.
+
+=item C<group_controls()>
+
+ Description: Returns a hash (group id as key) with all product
+              group controls.
+
+ Params:      $full_data (optional, false by default) - when true,
+              the number of bugs per group applicable to the product
+              is also returned. Moreover, bug groups which have no
+              special settings for the product are also returned.
+
+ Returns:     A hash with group id as key and hash containing 
+              a Bugzilla::Group object and the properties of group
+              relative to the product.
+
+=item C<groups_available>
+
+Tells you what groups are set to Default or Shown for the 
+currently-logged-in user (taking into account both OtherControl and
+MemberControl). Returns an arrayref of L<Bugzilla::Group> objects with
+an extra hash keys set, C<is_default>, which is true if the group
+is set to Default for the currently-logged-in user.
+
+=item C<groups_mandatory>
+
+Tells you what groups are mandatory for bugs in this product, for the
+currently-logged-in user. Returns an arrayref of C<Bugzilla::Group> objects.
+
+=item C<group_is_settable>
+
+=over
+
+=item B<Description>
+
+Tells you whether or not the currently-logged-in user can set a group
+on a bug (whether or not they match the MemberControl/OtherControl
+settings for a group in this product). Groups that are C<Mandatory> for
+the currently-loggeed-in user are also acceptable since from Bugzilla's
+perspective, there's no problem with "setting" a Mandatory group on
+a bug. (In fact, the user I<must> set the Mandatory group on the bug.)
+
+=item B<Params>
+
+=over
+
+=item C<$group> - A L<Bugzilla::Group> object.
+
+=back
+
+=item B<Returns>
+
+C<1> if the group is valid in this product, C<0> otherwise.
+
+=back
+
+
+=item C<groups_valid>
+
+=over
+
+=item B<Description>
+
+Returns an arrayref of L<Bugzilla::Group> objects, representing groups
+that bugs could validly be restricted to within this product. Used mostly
+when you need the list of all possible groups that could be set in a product
+by anybody, disregarding whether or not the groups are active or who the
+currently logged-in user is.
+
+B<Note>: This doesn't check whether or not the current user can add/remove
+bugs to/from these groups. It just tells you that bugs I<could be in> these
+groups, in this product.
+
+=item B<Params> (none)
+
+=item B<Returns> An arrayref of L<Bugzilla::Group> objects.
+
+=back
+
+=item C<group_is_valid>
+
+Returns C<1> if the passed-in L<Bugzilla::Group> or group id could be set
+on a bug by I<anybody>, in this product. Even inactive groups are considered
+valid. (This is a shortcut for searching L</groups_valid> to find out if
+a group is valid in a particular product.)
+
+=item C<versions>
+
+ Description: Returns all valid versions for that product.
+
+ Params:      none.
+
+ Returns:     An array of Bugzilla::Version objects.
+
+=item C<milestones>
+
+ Description: Returns all valid milestones for that product.
+
+ Params:      none.
+
+ Returns:     An array of Bugzilla::Milestone objects.
+
+=item C<bug_count()>
+
+ Description: Returns the total of bugs that belong to the product.
+
+ Params:      none.
+
+ Returns:     Integer with the number of bugs.
+
+=item C<bug_ids()>
+
+ Description: Returns the IDs of bugs that belong to the product.
+
+ Params:      none.
+
+ Returns:     An array of integer.
+
+=item C<user_has_access()>
+
+ Description: Tells you whether or not the user is allowed to enter
+              bugs into this product, based on the C<entry> group
+              control. To see whether or not a user can actually
+              enter a bug into a product, use C<$user-&gt;can_enter_product>.
+
+ Params:      C<$user> - A Bugzilla::User object.
+
+ Returns      C<1> If this user's groups allow him C<entry> access to
+              this Product, C<0> otherwise.
+
+=item C<flag_types()>
+
+ Description: Returns flag types available for at least one of
+              its components.
+
+ Params:      none.
+
+ Returns:     Two references to an array of flagtype objects.
+
+=item C<classification()>
+
+ Description: Returns the classification the product belongs to.
+
+ Params:      none.
+
+ Returns:     A Bugzilla::Classification object.
+
+=back
+
+=head1 SUBROUTINES
+
+=over
+
+=item C<preload>
+
+When passed an arrayref of C<Bugzilla::Product> objects, preloads their
+L</milestones>, L</components>, and L</versions>, which is much faster
+than calling those accessors on every item in the array individually.
+
+If the 2nd argument passed to C<preload> is true, flag types for these
+products and their components are also preloaded.
+
+This function is not exported, so must be called like 
+C<Bugzilla::Product::preload($products)>.
+
+=back
+
+=head1 SEE ALSO
+
+L<Bugzilla::Object>
+
+=cut

diff --git a/Bugzilla/RNG.pm b/Bugzilla/RNG.pm
new file mode 100644 (file)
index 0000000..457d2ca
--- /dev/null
+++ b/Bugzilla/RNG.pm
@@ -0,0 +1,218 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::RNG;
+use strict;
+use base qw(Exporter);
+use Bugzilla::Constants qw(ON_WINDOWS);
+
+use Math::Random::ISAAC;
+use if ON_WINDOWS, 'Win32::API';
+
+our $RNG;
+our @EXPORT_OK = qw(rand srand irand);
+
+# ISAAC, a 32-bit generator, should only be capable of generating numbers
+# between 0 and 2^32 - 1. We want _to_float to generate numbers possibly
+# including 0, but always less than 1.0. Dividing the integer produced
+# by irand() by this number should do that exactly.
+use constant DIVIDE_BY => 2**32;
+
+# How many bytes of seed to read.
+use constant SEED_SIZE => 16; # 128 bits.
+
+#################
+# Windows Stuff #
+#################
+
+# The type of cryptographic service provider we want to use.
+# This doesn't really matter for our purposes, so we just pick
+# PROV_RSA_FULL, which seems reasonable. For more info, see
+# http://msdn.microsoft.com/en-us/library/aa380244(v=VS.85).aspx
+use constant PROV_RSA_FULL => 1;
+
+# Flags for CryptGenRandom:
+# Don't ever display a UI to the user, just fail if one would be needed.
+use constant CRYPT_SILENT => 64;
+# Don't require existing public/private keypairs.
+use constant CRYPT_VERIFYCONTEXT => 0xF0000000;
+
+# For some reason, BOOLEAN doesn't work properly as a return type with 
+# Win32::API.
+use constant RTLGENRANDOM_PROTO => <<END;
+INT SystemFunction036(
+  PVOID RandomBuffer,
+  ULONG RandomBufferLength
+)
+END
+
+#################
+# RNG Functions #
+#################
+
+sub rand (;$) {
+    my ($limit) = @_;
+    my $int = irand();
+    return _to_float($int, $limit);
+}
+
+sub irand (;$) {
+    my ($limit) = @_;
+    Bugzilla::RNG::srand() if !defined $RNG;
+    my $int = $RNG->irand();
+    if (defined $limit) {
+        # We can't just use the mod operator because it will bias
+        # our output. Search for "modulo bias" on the Internet for
+        # details. This is slower than mod(), but does not have a bias,
+        # as demonstrated by Math::Random::Secure's uniform.t test.
+        return int(_to_float($int, $limit));
+    }
+    return $int;
+}
+
+sub srand (;$) {
+    my ($value) = @_;
+    # Remove any RNG that might already have been made.
+    $RNG = undef;
+    my %args;
+    if (defined $value) {
+        $args{seed} = $value;
+    }
+    $RNG = _create_rng(\%args);
+}
+
+sub _to_float {
+    my ($integer, $limit) = @_;
+    $limit ||= 1;
+    return ($integer / DIVIDE_BY) * $limit;
+}
+
+##########################
+# Seed and PRNG Creation #
+##########################
+
+sub _create_rng {
+    my ($params) = @_;
+
+    if (!defined $params->{seed}) {
+        $params->{seed} = _get_seed();
+    }
+
+    _check_seed($params->{seed});
+
+    my @seed_ints = unpack('L*', $params->{seed});
+
+    my $rng = Math::Random::ISAAC->new(@seed_ints);
+
+    # It's faster to skip the frontend interface of Math::Random::ISAAC
+    # and just use the backend directly. However, in case the internal
+    # code of Math::Random::ISAAC changes at some point, we do make sure
+    # that the {backend} element actually exists first.
+    return $rng->{backend} ? $rng->{backend} : $rng;
+}
+
+sub _check_seed {
+    my ($seed) = @_;
+    if (length($seed) < 8) {
+        warn "Your seed is less than 8 bytes (64 bits). It could be"
+             . " easy to crack";
+    }
+    # If it looks like we were seeded with a 32-bit integer, warn the
+    # user that they are making a dangerous, easily-crackable mistake.
+    elsif (length($seed) <= 10 and $seed =~ /^\d+$/) {
+        warn "RNG seeded with a 32-bit integer, this is easy to crack";
+    }
+}
+
+sub _get_seed {
+    return _windows_seed() if ON_WINDOWS;
+
+    if (-r '/dev/urandom') {
+        return _read_seed_from('/dev/urandom');
+    }
+
+    return _read_seed_from('/dev/random');
+}
+
+sub _read_seed_from {
+    my ($from) = @_;
+
+    open(my $fh, '<', $from) or die "$from: $!";
+    my $buffer;
+    read($fh, $buffer, SEED_SIZE);
+    if (length($buffer) < SEED_SIZE) {
+        die "Could not read enough seed bytes from $from, got only " 
+            . length($buffer);
+    }
+    close $fh;
+    return $buffer;
+}
+
+sub _windows_seed {
+    my ($major, $minor) = (Win32::GetOSVersion())[1,2];
+    if ($major < 5) {
+        die "Bugzilla does not support versions of Windows before"
+            . " Windows 2000";
+    }
+    # This means Windows 2000.
+    if ($major == 5 and $minor == 0) {
+        return _win2k_seed();
+    }
+
+    my $rtlgenrand = Win32::API->new('advapi32', RTLGENRANDOM_PROTO);
+    if (!defined $rtlgenrand) {
+        die "Could not import RtlGenRand: $^E";
+    }
+    my $buffer = chr(0) x SEED_SIZE;
+    my $result = $rtlgenrand->Call($buffer, SEED_SIZE);
+    if (!$result) {
+        die "RtlGenRand failed: $^E";
+    }
+    return $buffer;
+}
+
+sub _win2k_seed {
+    my $crypt_acquire = Win32::API->new(
+        "advapi32", 'CryptAcquireContext', 'PPPNN', 'I');
+    if (!defined $crypt_acquire) {
+        die "Could not import CryptAcquireContext: $^E";
+    }
+
+    my $crypt_release = Win32::API->new(
+        "advapi32", 'CryptReleaseContext', 'NN', 'I');
+    if (!defined $crypt_release) {
+        die "Could not import CryptReleaseContext: $^E";
+    }
+
+    my $crypt_gen_random = Win32::API->new(
+        "advapi32", 'CryptGenRandom', 'NNP', 'I');
+    if (!defined $crypt_gen_random) {
+        die "Could not import CryptGenRandom: $^E";
+    }
+
+    my $context = chr(0) x Win32::API::Type->sizeof('PULONG');
+    my $acquire_result = $crypt_acquire->Call(
+        $context, 0, 0, PROV_RSA_FULL, CRYPT_SILENT | CRYPT_VERIFYCONTEXT);
+    if (!defined $acquire_result) {
+        die "CryptAcquireContext failed: $^E";
+    }
+
+    my $pack_type = Win32::API::Type::packing('PULONG');
+    $context = unpack($pack_type, $context);
+
+    my $buffer = chr(0) x SEED_SIZE;
+    my $rand_result = $crypt_gen_random->Call($context, SEED_SIZE, $buffer);
+    my $rand_error = $^E;
+    # We don't check this if it fails, we don't care.
+    $crypt_release->Call($context, 0);
+    if (!defined $rand_result) {
+        die "CryptGenRandom failed: $rand_error";
+    }
+    return $buffer;
+}
+
+1;

diff --git a/Bugzilla/Report.pm b/Bugzilla/Report.pm
new file mode 100644 (file)
index 0000000..4c9f332
--- /dev/null
+++ b/Bugzilla/Report.pm
@@ -0,0 +1,134 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+package Bugzilla::Report;
+
+use base qw(Bugzilla::Object);
+
+use Bugzilla::CGI;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Util;
+
+use constant DB_TABLE => 'reports';
+
+# Do not track reports saved by users.
+use constant AUDIT_CREATES => 0;
+use constant AUDIT_UPDATES => 0;
+use constant AUDIT_REMOVES => 0;
+
+use constant DB_COLUMNS => qw(
+    id
+    user_id
+    name
+    query
+);
+
+use constant UPDATE_COLUMNS => qw(
+    name
+    query
+);
+
+use constant VALIDATORS => {
+    name    => \&_check_name,
+    query   => \&_check_query,
+};
+
+##############
+# Validators #
+##############
+
+sub _check_name {
+    my ($invocant, $name) = @_;
+    $name = clean_text($name);
+    $name || ThrowUserError("report_name_missing");
+    $name !~ /[<>&]/ || ThrowUserError("illegal_query_name");
+    if (length($name) > MAX_LEN_QUERY_NAME) {
+        ThrowUserError("query_name_too_long");
+    }
+    return $name;
+}
+
+sub _check_query {
+    my ($invocant, $query) = @_;
+    $query || ThrowUserError("buglist_parameters_required");
+    my $cgi = new Bugzilla::CGI($query);
+    $cgi->clean_search_url;
+    return $cgi->query_string;
+}
+
+#############
+# Accessors #
+#############
+
+sub query { return $_[0]->{'query'}; }
+
+sub set_name { $_[0]->set('name', $_[1]); }
+sub set_query { $_[0]->set('query', $_[1]); }
+
+###########
+# Methods #
+###########
+
+sub create {
+    my $class = shift;
+    my $param = shift;
+
+    Bugzilla->login(LOGIN_REQUIRED);
+    $param->{'user_id'} = Bugzilla->user->id;
+
+    unshift @_, $param;
+    my $self = $class->SUPER::create(@_);
+}
+
+sub check {
+    my $class = shift;
+    my $report = $class->SUPER::check(@_);
+    my $user = Bugzilla->user;
+    if ( grep($_->id eq $report->id, @{$user->reports})) {
+        return $report;
+    } else {
+        ThrowUserError('report_access_denied');
+    }
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Report - Bugzilla report class.
+
+=head1 SYNOPSIS
+
+    use Bugzilla::Report;
+
+    my $report = new Bugzilla::Report(1);
+
+    my $report = Bugzilla::Report->check({id => $id});
+
+    my $name = $report->name;
+    my $query = $report->query;
+
+    my $report = Bugzilla::Report->create({ name => $name, query => $query });
+
+    $report->set_name($new_name);
+    $report->set_query($new_query);
+    $report->update();
+
+    $report->remove_from_db;
+
+=head1 DESCRIPTION
+
+Report.pm represents a Report object. It is an implementation
+of L<Bugzilla::Object>, and thus provides all methods that
+L<Bugzilla::Object> provides.
+
+=cut

diff --git a/Bugzilla/Search.pm b/Bugzilla/Search.pm
new file mode 100644 (file)
index 0000000..795eb2a
--- /dev/null
+++ b/Bugzilla/Search.pm
@@ -0,0 +1,3201 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+package Bugzilla::Search;
+use base qw(Exporter);
+@Bugzilla::Search::EXPORT = qw(
+    IsValidQueryType
+    split_order_term
+);
+
+use Bugzilla::Error;
+use Bugzilla::Util;
+use Bugzilla::Constants;
+use Bugzilla::Group;
+use Bugzilla::User;
+use Bugzilla::Field;
+use Bugzilla::Search::Clause;
+use Bugzilla::Search::ClauseGroup;
+use Bugzilla::Search::Condition qw(condition);
+use Bugzilla::Status;
+use Bugzilla::Keyword;
+
+use Data::Dumper;
+use Date::Format;
+use Date::Parse;
+use Scalar::Util qw(blessed);
+use List::MoreUtils qw(all firstidx part uniq);
+use POSIX qw(INT_MAX);
+use Storable qw(dclone);
+use Time::HiRes qw(gettimeofday tv_interval);
+
+# Description Of Boolean Charts
+# -----------------------------
+#
+# A boolean chart is a way of representing the terms in a logical
+# expression.  Bugzilla builds SQL queries depending on how you enter
+# terms into the boolean chart. Boolean charts are represented in
+# urls as three-tuples of (chart id, row, column). The query form
+# (query.cgi) may contain an arbitrary number of boolean charts where
+# each chart represents a clause in a SQL query.
+#
+# The query form starts out with one boolean chart containing one
+# row and one column.  Extra rows can be created by pressing the
+# AND button at the bottom of the chart.  Extra columns are created
+# by pressing the OR button at the right end of the chart. Extra
+# charts are created by pressing "Add another boolean chart".
+#
+# Each chart consists of an arbitrary number of rows and columns.
+# The terms within a row are ORed together. The expressions represented
+# by each row are ANDed together. The expressions represented by each
+# chart are ANDed together.
+#
+#        ----------------------
+#        | col2 | col2 | col3 |
+# --------------|------|------|
+# | row1 |  a1  |  a2  |      |
+# |------|------|------|------|  => ((a1 OR a2) AND (b1 OR b2 OR b3) AND (c1))
+# | row2 |  b1  |  b2  |  b3  |
+# |------|------|------|------|
+# | row3 |  c1  |      |      |
+# -----------------------------
+#
+#        --------
+#        | col2 |
+# --------------|
+# | row1 |  d1  | => (d1)
+# ---------------
+#
+# Together, these two charts represent a SQL expression like this
+# SELECT blah FROM blah WHERE ( (a1 OR a2)AND(b1 OR b2 OR b3)AND(c1)) AND (d1)
+#
+# The terms within a single row of a boolean chart are all constraints
+# on a single piece of data.  If you're looking for a bug that has two
+# different people cc'd on it, then you need to use two boolean charts.
+# This will find bugs with one CC matching 'foo@blah.org' and and another
+# CC matching 'bar@blah.org'.
+#
+# --------------------------------------------------------------
+# CC    | equal to
+# foo@blah.org
+# --------------------------------------------------------------
+# CC    | equal to
+# bar@blah.org
+#
+# If you try to do this query by pressing the AND button in the
+# original boolean chart then what you'll get is an expression that
+# looks for a single CC where the login name is both "foo@blah.org",
+# and "bar@blah.org". This is impossible.
+#
+# --------------------------------------------------------------
+# CC    | equal to
+# foo@blah.org
+# AND
+# CC    | equal to
+# bar@blah.org
+# --------------------------------------------------------------
+
+#############
+# Constants #
+#############
+
+# When doing searches, NULL datetimes are treated as this date.
+use constant EMPTY_DATETIME => '1970-01-01 00:00:00';
+
+# This is the regex for real numbers from Regexp::Common, modified to be
+# more readable.
+use constant NUMBER_REGEX => qr/
+    ^[+-]?      # A sign, optionally.
+
+    (?=\d|\.)   # Then either a digit or "."
+    \d*         # Followed by many other digits
+    (?:
+        \.      # Followed possibly by some decimal places
+        (?:\d*)
+    )?
+ 
+    (?:         # Followed possibly by an exponent.
+        [Ee]
+        [+-]?
+        \d+
+    )?
+    $
+/x;
+
+# If you specify a search type in the boolean charts, this describes
+# which operator maps to which internal function here.
+use constant OPERATORS => {
+    equals         => \&_simple_operator,
+    notequals      => \&_simple_operator,
+    casesubstring  => \&_casesubstring,
+    substring      => \&_substring,
+    substr         => \&_substring,
+    notsubstring   => \&_notsubstring,
+    regexp         => \&_regexp,
+    notregexp      => \&_notregexp,
+    lessthan       => \&_simple_operator,
+    lessthaneq     => \&_simple_operator,
+    matches        => sub { ThrowUserError("search_content_without_matches"); },
+    notmatches     => sub { ThrowUserError("search_content_without_matches"); },
+    greaterthan    => \&_simple_operator,
+    greaterthaneq  => \&_simple_operator,
+    anyexact       => \&_anyexact,
+    anywordssubstr => \&_anywordsubstr,
+    allwordssubstr => \&_allwordssubstr,
+    nowordssubstr  => \&_nowordssubstr,
+    anywords       => \&_anywords,
+    allwords       => \&_allwords,
+    nowords        => \&_nowords,
+    changedbefore  => \&_changedbefore_changedafter,
+    changedafter   => \&_changedbefore_changedafter,
+    changedfrom    => \&_changedfrom_changedto,
+    changedto      => \&_changedfrom_changedto,
+    changedby      => \&_changedby,
+};
+
+# Some operators are really just standard SQL operators, and are
+# all implemented by the _simple_operator function, which uses this
+# constant.
+use constant SIMPLE_OPERATORS => {
+    equals        => '=',
+    notequals     => '!=',
+    greaterthan   => '>',
+    greaterthaneq => '>=',
+    lessthan      => '<',
+    lessthaneq    => "<=",
+};
+
+# Most operators just reverse by removing or adding "not" from/to them.
+# However, some operators reverse in a different way, so those are listed
+# here.
+use constant OPERATOR_REVERSE => {
+    nowords        => 'anywords',
+    nowordssubstr  => 'anywordssubstr',
+    anywords       => 'nowords',
+    anywordssubstr => 'nowordssubstr',
+    lessthan       => 'greaterthaneq',
+    lessthaneq     => 'greaterthan',
+    greaterthan    => 'lessthaneq',
+    greaterthaneq  => 'lessthan',
+    # The following don't currently have reversals:
+    # casesubstring, anyexact, allwords, allwordssubstr
+};
+
+# For these operators, even if a field is numeric (is_numeric returns true),
+# we won't treat the input like a number.
+use constant NON_NUMERIC_OPERATORS => qw(
+    changedafter
+    changedbefore
+    changedfrom
+    changedto
+    regexp
+    notregexp
+);
+
+use constant MULTI_SELECT_OVERRIDE => {
+    notequals      => \&_multiselect_negative,
+    notregexp      => \&_multiselect_negative,
+    notsubstring   => \&_multiselect_negative,
+    nowords        => \&_multiselect_negative,
+    nowordssubstr  => \&_multiselect_negative,
+    
+    allwords       => \&_multiselect_multiple,
+    allwordssubstr => \&_multiselect_multiple,
+    anyexact       => \&_multiselect_multiple,
+    anywords       => \&_multiselect_multiple,
+    anywordssubstr => \&_multiselect_multiple,
+    
+    _non_changed    => \&_multiselect_nonchanged,
+};
+
+use constant OPERATOR_FIELD_OVERRIDE => {
+    # User fields
+    'attachments.submitter' => {
+        _non_changed => \&_user_nonchanged,
+    },
+    assigned_to => {
+        _non_changed => \&_user_nonchanged,
+    },
+    cc => {
+        _non_changed => \&_user_nonchanged,
+    },
+    commenter => {
+        _non_changed => \&_user_nonchanged,
+    },
+    reporter => {
+        _non_changed => \&_user_nonchanged,
+    },
+    'requestees.login_name' => {
+        _non_changed => \&_user_nonchanged,
+    },
+    'setters.login_name' => {
+        _non_changed => \&_user_nonchanged,    
+    },
+    qa_contact => {
+        _non_changed => \&_user_nonchanged,
+    },
+    
+    # General Bug Fields
+    alias        => { _non_changed => \&_nullable },
+    'attach_data.thedata' => MULTI_SELECT_OVERRIDE,
+    # We check all attachment fields against this.
+    attachments  => MULTI_SELECT_OVERRIDE,
+    blocked      => MULTI_SELECT_OVERRIDE,
+    bug_file_loc => { _non_changed => \&_nullable },
+    bug_group    => MULTI_SELECT_OVERRIDE,
+    classification => {
+        _non_changed => \&_classification_nonchanged,
+    },
+    component => {
+        _non_changed => \&_component_nonchanged,
+    },
+    content => {
+        matches    => \&_content_matches,
+        notmatches => \&_content_matches,
+        _default   => sub { ThrowUserError("search_content_without_matches"); },
+    },
+    days_elapsed => {
+        _default => \&_days_elapsed,
+    },
+    dependson        => MULTI_SELECT_OVERRIDE,
+    keywords         => MULTI_SELECT_OVERRIDE,
+    'flagtypes.name' => {
+        _non_changed => \&_flagtypes_nonchanged,
+    },
+    longdesc => {
+        changedby     => \&_long_desc_changedby,
+        changedbefore => \&_long_desc_changedbefore_after,
+        changedafter  => \&_long_desc_changedbefore_after,
+        _non_changed  => \&_long_desc_nonchanged,
+    },
+    'longdescs.count' => {
+        changedby     => \&_long_desc_changedby,
+        changedbefore => \&_long_desc_changedbefore_after,
+        changedafter  => \&_long_desc_changedbefore_after,
+        changedfrom   => \&_invalid_combination,
+        changedto     => \&_invalid_combination,
+        _default      => \&_long_descs_count,
+    },
+    'longdescs.isprivate' => MULTI_SELECT_OVERRIDE,
+    owner_idle_time => {
+        greaterthan   => \&_owner_idle_time_greater_less,
+        greaterthaneq => \&_owner_idle_time_greater_less,
+        lessthan      => \&_owner_idle_time_greater_less,
+        lessthaneq    => \&_owner_idle_time_greater_less,
+        _default      => \&_invalid_combination,
+    },
+    product => {
+        _non_changed => \&_product_nonchanged,
+    },
+    tag => MULTI_SELECT_OVERRIDE,
+    
+    # Timetracking Fields
+    deadline => { _non_changed => \&_deadline },
+    percentage_complete => {
+        _non_changed => \&_percentage_complete,
+    },
+    work_time => {
+        changedby     => \&_work_time_changedby,
+        changedbefore => \&_work_time_changedbefore_after,
+        changedafter  => \&_work_time_changedbefore_after,
+        _default      => \&_work_time,
+    },
+    
+    # Custom Fields
+    FIELD_TYPE_FREETEXT, { _non_changed => \&_nullable },
+    FIELD_TYPE_BUG_ID,   { _non_changed => \&_nullable_int },
+    FIELD_TYPE_DATETIME, { _non_changed => \&_nullable_datetime },
+    FIELD_TYPE_TEXTAREA, { _non_changed => \&_nullable },
+    FIELD_TYPE_MULTI_SELECT, MULTI_SELECT_OVERRIDE,
+    FIELD_TYPE_BUG_URLS,     MULTI_SELECT_OVERRIDE,    
+};
+
+# These are fields where special action is taken depending on the
+# *value* passed in to the chart, sometimes.
+use constant SPECIAL_PARSING => {
+    # Pronoun Fields (Ones that can accept %user%, etc.)
+    assigned_to => \&_contact_pronoun,
+    cc          => \&_contact_pronoun,
+    commenter   => \&_contact_pronoun,
+    qa_contact  => \&_contact_pronoun,
+    reporter    => \&_contact_pronoun,
+    'setters.login_name' => \&_contact_pronoun,
+    'requestees.login_name' => \&_contact_pronoun,
+
+    # Date Fields that accept the 1d, 1w, 1m, 1y, etc. format.
+    creation_ts => \&_timestamp_translate,
+    deadline    => \&_timestamp_translate,
+    delta_ts    => \&_timestamp_translate,
+};
+
+# Information about fields that represent "users", used by _user_nonchanged.
+# There are other user fields than the ones listed here, but those use
+# defaults in _user_nonchanged.
+use constant USER_FIELDS => {
+    'attachments.submitter' => {
+        field    => 'submitter_id',
+        join     => { table => 'attachments' },
+        isprivate => 1,
+    },
+    cc => {
+        field => 'who',
+        join  => { table => 'cc' },
+    },
+    commenter => {
+        field => 'who',
+        join  => { table => 'longdescs', join => 'INNER' },
+        isprivate => 1,
+    },
+    qa_contact => {
+        nullable => 1,
+    },
+    'requestees.login_name' => {
+        nullable => 1,
+        field    => 'requestee_id',
+        join     => { table => 'flags' },
+    },
+    'setters.login_name' => {
+        field    => 'setter_id',
+        join     => { table => 'flags' },
+    },
+};
+
+# Backwards compatibility for times that we changed the names of fields
+# or URL parameters.
+use constant FIELD_MAP => {
+    'attachments.thedata' => 'attach_data.thedata',
+    bugidtype => 'bug_id_type',
+    changedin => 'days_elapsed',
+    long_desc => 'longdesc',
+};
+
+# Some fields are not sorted on themselves, but on other fields.
+# We need to have a list of these fields and what they map to.
+use constant SPECIAL_ORDER => {
+    'target_milestone' => {
+        order => ['map_target_milestone.sortkey','map_target_milestone.value'],
+        join  => {
+            table => 'milestones',
+            from  => 'target_milestone',
+            to    => 'value',
+            extra => ['bugs.product_id = map_target_milestone.product_id'],
+            join  => 'INNER',
+        }
+    },
+};
+
+# Certain columns require other columns to come before them
+# in _select_columns, and should be put there if they're not there.
+use constant COLUMN_DEPENDS => {
+    classification      => ['product'],
+    percentage_complete => ['actual_time', 'remaining_time'],
+};
+
+# This describes tables that must be joined when you want to display
+# certain columns in the buglist. For the most part, Search.pm uses
+# DB::Schema to figure out what needs to be joined, but for some
+# fields it needs a little help.
+sub COLUMN_JOINS {
+    my $invocant = shift;
+    my $user = blessed($invocant) ? $invocant->_user : Bugzilla->user;
+
+    my $joins = {
+        actual_time => {
+            table => '(SELECT bug_id, SUM(work_time) AS total'
+                     . ' FROM longdescs GROUP BY bug_id)',
+            join  => 'INNER',
+        },
+        assigned_to => {
+            from  => 'assigned_to',
+            to    => 'userid',
+            table => 'profiles',
+            join  => 'INNER',
+        },
+        reporter => {
+            from  => 'reporter',
+            to    => 'userid',
+            table => 'profiles',
+            join  => 'INNER',
+        },
+        qa_contact => {
+            from  => 'qa_contact',
+            to    => 'userid',
+            table => 'profiles',
+        },
+        component => {
+            from  => 'component_id',
+            to    => 'id',
+            table => 'components',
+            join  => 'INNER',
+        },
+        product => {
+            from  => 'product_id',
+            to    => 'id',
+            table => 'products',
+            join  => 'INNER',
+        },
+        classification => {
+            table => 'classifications',
+            from  => 'map_product.classification_id',
+            to    => 'id',
+            join  => 'INNER',
+        },
+        'flagtypes.name' => {
+            as    => 'map_flags',
+            table => 'flags',
+            extra => ['map_flags.attach_id IS NULL'],
+            then_to => {
+                as    => 'map_flagtypes',
+                table => 'flagtypes',
+                from  => 'map_flags.type_id',
+                to    => 'id',
+            },
+        },
+        keywords => {
+            table => 'keywords',
+            then_to => {
+                as    => 'map_keyworddefs',
+                table => 'keyworddefs',
+                from  => 'map_keywords.keywordid',
+                to    => 'id',
+            },
+        },
+        'longdescs.count' => {
+            table => 'longdescs',
+            join  => 'INNER',
+        },
+        tag => {
+            as => 'map_bug_tag',
+            table => 'bug_tag',
+            then_to => {
+                as => 'map_tag',
+                table => 'tag',
+                extra => ['map_tag.user_id = ' . $user->id],
+                from => 'map_bug_tag.tag_id',
+                to => 'id',
+            },
+        }
+    };
+    return $joins;
+};
+
+# This constant defines the columns that can be selected in a query 
+# and/or displayed in a bug list.  Column records include the following
+# fields:
+#
+# 1. id: a unique identifier by which the column is referred in code;
+#
+# 2. name: The name of the column in the database (may also be an expression
+#          that returns the value of the column);
+#
+# 3. title: The title of the column as displayed to users.
+# 
+# Note: There are a few hacks in the code that deviate from these definitions.
+#       In particular, the redundant short_desc column is removed when the
+#       client requests "all" columns.
+#
+# This is really a constant--that is, once it's been called once, the value
+# will always be the same unless somebody adds a new custom field. But
+# we have to do a lot of work inside the subroutine to get the data,
+# and we don't want it to happen at compile time, so we have it as a
+# subroutine.
+sub COLUMNS {
+    my $invocant = shift;
+    my $user = blessed($invocant) ? $invocant->_user : Bugzilla->user;
+    my $dbh = Bugzilla->dbh;
+    my $cache = Bugzilla->request_cache;
+
+    if (defined $cache->{search_columns}->{$user->id}) {
+        return $cache->{search_columns}->{$user->id};
+    }
+
+    # These are columns that don't exist in fielddefs, but are valid buglist
+    # columns. (Also see near the bottom of this function for the definition
+    # of short_short_desc.)
+    my %columns = (
+        relevance            => { title => 'Relevance'  },
+        assigned_to_realname => { title => 'Assignee'   },
+        reporter_realname    => { title => 'Reporter'   },
+        qa_contact_realname  => { title => 'QA Contact' },
+    );
+
+    # Next we define columns that have special SQL instead of just something
+    # like "bugs.bug_id".
+    my $total_time = "(map_actual_time.total + bugs.remaining_time)";
+    my %special_sql = (
+        deadline    => $dbh->sql_date_format('bugs.deadline', '%Y-%m-%d'),
+        actual_time => 'map_actual_time.total',
+
+        # "FLOOR" is in there to turn this into an integer, making searches
+        # totally predictable. Otherwise you get floating-point numbers that
+        # are rather hard to search reliably if you're asking for exact
+        # numbers.
+        percentage_complete =>
+            "(CASE WHEN $total_time = 0"
+               . " THEN 0"
+               . " ELSE FLOOR(100 * (map_actual_time.total / $total_time))"
+                . " END)",
+
+        'flagtypes.name' => $dbh->sql_group_concat('DISTINCT ' 
+            . $dbh->sql_string_concat('map_flagtypes.name', 'map_flags.status')),
+
+        'keywords' => $dbh->sql_group_concat('DISTINCT map_keyworddefs.name'),
+        
+        'longdescs.count' => 'COUNT(DISTINCT map_longdescs_count.comment_id)',
+
+        tag => $dbh->sql_group_concat('DISTINCT map_tag.name'),
+    );
+
+    # Backward-compatibility for old field names. Goes new_name => old_name.
+    # These are here and not in _translate_old_column because the rest of the
+    # code actually still uses the old names, while the fielddefs table uses
+    # the new names (which is not the case for the fields handled by
+    # _translate_old_column).
+    my %old_names = (
+        creation_ts => 'opendate',
+        delta_ts    => 'changeddate',
+        work_time   => 'actual_time',
+    );
+
+    # Fields that are email addresses
+    my @email_fields = qw(assigned_to reporter qa_contact);
+    # Other fields that are stored in the bugs table as an id, but
+    # should be displayed using their name.
+    my @id_fields = qw(product component classification);
+
+    foreach my $col (@email_fields) {
+        my $sql = "map_${col}.login_name";
+        if (!$user->id) {
+             $sql = $dbh->sql_string_until($sql, $dbh->quote('@'));
+        }
+        $special_sql{$col} = $sql;
+        $columns{"${col}_realname"}->{name} = "map_${col}.realname";
+    }
+
+    foreach my $col (@id_fields) {
+        $special_sql{$col} = "map_${col}.name";
+    }
+
+    # Do the actual column-getting from fielddefs, now.
+    my @fields = @{ Bugzilla->fields({ obsolete => 0, buglist => 1 }) };
+    foreach my $field (@fields) {
+        my $id = $field->name;
+        $id = $old_names{$id} if exists $old_names{$id};
+        my $sql;
+        if (exists $special_sql{$id}) {
+            $sql = $special_sql{$id};
+        }
+        elsif ($field->type == FIELD_TYPE_MULTI_SELECT) {
+            $sql = $dbh->sql_group_concat(
+                'DISTINCT map_' . $field->name . '.value');
+        }
+        else {
+            $sql = 'bugs.' . $field->name;
+        }
+        $columns{$id} = { name => $sql, title => $field->description };
+    }
+
+    # The short_short_desc column is identical to short_desc
+    $columns{'short_short_desc'} = $columns{'short_desc'};
+
+    Bugzilla::Hook::process('buglist_columns', { columns => \%columns });
+
+    $cache->{search_columns}->{$user->id} = \%columns;
+    return $cache->{search_columns}->{$user->id};
+}
+
+sub REPORT_COLUMNS {
+    my $invocant = shift;
+    my $user = blessed($invocant) ? $invocant->_user : Bugzilla->user;
+
+    my $columns = dclone(blessed($invocant) ? $invocant->COLUMNS : COLUMNS);
+    # There's no reason to support reporting on unique fields.
+    # Also, some other fields don't make very good reporting axises,
+    # or simply don't work with the current reporting system.
+    my @no_report_columns = 
+        qw(bug_id alias short_short_desc opendate changeddate
+           flagtypes.name keywords relevance);
+
+    # Multi-select fields are not currently supported.
+    my @multi_selects = @{Bugzilla->fields(
+        { obsolete => 0, type => FIELD_TYPE_MULTI_SELECT })};
+    push(@no_report_columns, map { $_->name } @multi_selects);
+
+    # If you're not a time-tracker, you can't use time-tracking
+    # columns.
+    if (!$user->is_timetracker) {
+        push(@no_report_columns, TIMETRACKING_FIELDS);
+    }
+
+    foreach my $name (@no_report_columns) {
+        delete $columns->{$name};
+    }
+    return $columns;
+}
+
+# These are fields that never go into the GROUP BY on any DB. bug_id
+# is here because it *always* goes into the GROUP BY as the first item,
+# so it should be skipped when determining extra GROUP BY columns.
+use constant GROUP_BY_SKIP => qw(
+    bug_id
+    flagtypes.name
+    keywords
+    longdescs.count
+    percentage_complete
+    tag
+);
+
+###############
+# Constructor #
+###############
+
+# Note that the params argument may be modified by Bugzilla::Search
+sub new {
+    my $invocant = shift;
+    my $class = ref($invocant) || $invocant;
+  
+    my $self = { @_ };
+    bless($self, $class);
+    $self->{'user'} ||= Bugzilla->user;
+    
+    # There are certain behaviors of the CGI "Vars" hash that we don't want.
+    # In particular, if you put a single-value arrayref into it, later you
+    # get back out a string, which breaks anyexact charts (because they
+    # need arrays even for individual items, or we will re-trigger bug 67036).
+    #
+    # We can't just untie the hash--that would give us a hash with no values.
+    # We have to manually copy the hash into a new one, and we have to always
+    # do it, because there's no way to know if we were passed a tied hash
+    # or not.
+    my $params_in = $self->_params;
+    my %params = map { $_ => $params_in->{$_} } keys %$params_in;
+    $self->{params} = \%params;
+
+    return $self;
+}
+
+
+####################
+# Public Accessors #
+####################
+
+sub data {
+    my $self = shift;
+    return $self->{data} if $self->{data};
+    my $dbh = Bugzilla->dbh;
+
+    # If all fields belong to the 'bugs' table, there is no need to split
+    # the original query into two pieces. Else we override the 'fields'
+    # argument to first get bug IDs based on the search criteria defined
+    # by the caller, and the desired fields are collected in the 2nd query.
+    my @orig_fields = $self->_input_columns;
+    my $all_in_bugs_table = 1;
+    foreach my $field (@orig_fields) {
+        next if $self->COLUMNS->{$field}->{name} =~ /^bugs\.\w+$/;
+        $self->{fields} = ['bug_id'];
+        $all_in_bugs_table = 0;
+        last;
+    }
+
+    my $start_time = [gettimeofday()];
+    my $sql = $self->_sql;
+    # Do we just want bug IDs to pass to the 2nd query or all the data immediately?
+    my $func = $all_in_bugs_table ? 'selectall_arrayref' : 'selectcol_arrayref';
+    my $bug_ids = $dbh->$func($sql);
+    my @extra_data = ({sql => $sql, time => tv_interval($start_time)});
+    # Restore the original 'fields' argument, just in case.
+    $self->{fields} = \@orig_fields unless $all_in_bugs_table;
+
+    # If there are no bugs found, or all fields are in the 'bugs' table,
+    # there is no need for another query.
+    if (!scalar @$bug_ids || $all_in_bugs_table) {
+        $self->{data} = $bug_ids;
+        return wantarray ? ($self->{data}, \@extra_data) : $self->{data};
+    }
+
+    # Make sure the bug_id will be returned. If not, append it to the list.
+    my $pos = firstidx { $_ eq 'bug_id' } @orig_fields;
+    if ($pos < 0) {
+        push(@orig_fields, 'bug_id');
+        $pos = $#orig_fields;
+    }
+
+    # Now create a query with the buglist above as the single criteria
+    # and the fields that the caller wants. No need to redo security checks;
+    # the list has already been validated above.
+    my $search = $self->new('fields' => \@orig_fields,
+                            'params' => {bug_id => $bug_ids, bug_id_type => 'anyexact'},
+                            'sharer' => $self->_sharer_id,
+                            'user'   => $self->_user,
+                            'allow_unlimited'    => 1,
+                            '_no_security_check' => 1);
+
+    $start_time = [gettimeofday()];
+    $sql = $search->_sql;
+    my $unsorted_data = $dbh->selectall_arrayref($sql);
+    push(@extra_data, {sql => $sql, time => tv_interval($start_time)});
+    # Let's sort the data. We didn't do it in the query itself because
+    # we already know in which order to sort bugs thanks to the first query,
+    # and this avoids additional table joins in the SQL query.
+    my %data = map { $_->[$pos] => $_ } @$unsorted_data;
+    $self->{data} = [map { $data{$_} } @$bug_ids];
+    return wantarray ? ($self->{data}, \@extra_data) : $self->{data};
+}
+
+sub _sql {
+    my ($self) = @_;
+    return $self->{sql} if $self->{sql};
+    my $dbh = Bugzilla->dbh;
+
+    my ($joins, $clause) = $self->_charts_to_conditions();
+
+    if (!$clause->as_string
+        && !Bugzilla->params->{'search_allow_no_criteria'}
+        && !$self->{allow_unlimited})
+    {
+        ThrowUserError('buglist_parameters_required');
+    }
+
+    my $select = join(', ', $self->_sql_select);
+    my $from = $self->_sql_from($joins);
+    my $where = $self->_sql_where($clause);
+    my $group_by = $dbh->sql_group_by($self->_sql_group_by);
+    my $order_by = $self->_sql_order_by
+                   ? "\nORDER BY " . join(', ', $self->_sql_order_by) : '';
+    my $limit = $self->_sql_limit;
+    $limit = "\n$limit" if $limit;
+    
+    my $query = <<END;
+SELECT $select
+  FROM $from
+ WHERE $where
+$group_by$order_by$limit
+END
+    $self->{sql} = $query;
+    return $self->{sql};
+}
+
+sub search_description {
+    my ($self, $params) = @_;
+    my $desc = $self->{'search_description'} ||= [];
+    if ($params) {
+        push(@$desc, $params);
+    }
+    # Make sure that the description has actually been generated if
+    # people are asking for the whole thing.
+    else {
+        $self->_sql;
+    }
+    return $self->{'search_description'};
+}
+
+sub boolean_charts_to_custom_search {
+    my ($self, $cgi_buffer) = @_;
+    my $boolean_charts = $self->_boolean_charts;
+    my @as_params = $boolean_charts ? $boolean_charts->as_params : ();
+
+    # We need to start our new ids after the last custom search "f" id.
+    # We can just pick the last id in the array because they are sorted
+    # numerically.
+    my $last_id = ($self->_field_ids)[-1];
+    my $count = defined($last_id) ? $last_id + 1 : 0;
+    foreach my $param_set (@as_params) {
+        foreach my $name (keys %$param_set) {
+            my $value = $param_set->{$name};
+            next if !defined $value;
+            $cgi_buffer->param($name . $count, $value);
+        }
+        $count++;
+    }
+}
+
+sub invalid_order_columns {
+   my ($self) = @_;
+   my @invalid_columns;
+   foreach my $order ($self->_input_order) {
+       next if defined $self->_validate_order_column($order);
+       push(@invalid_columns, $order);
+   }
+   return \@invalid_columns;
+}
+
+sub order {
+   my ($self) = @_;
+   return $self->_valid_order;
+}
+
+######################
+# Internal Accessors #
+######################
+
+# Fields that are legal for boolean charts of any kind.
+sub _chart_fields {
+    my ($self) = @_;
+
+    if (!$self->{chart_fields}) {
+        my $chart_fields = Bugzilla->fields({ by_name => 1 });
+
+        if (!$self->_user->is_timetracker) {
+            foreach my $tt_field (TIMETRACKING_FIELDS) {
+                delete $chart_fields->{$tt_field};
+            }
+        }
+        $self->{chart_fields} = $chart_fields;
+    }
+    return $self->{chart_fields};
+}
+
+# There are various places in Search.pm that we need to know the list of
+# valid multi-select fields--or really, fields that are stored like
+# multi-selects, which includes BUG_URLS fields.
+sub _multi_select_fields {
+    my ($self) = @_;
+    $self->{multi_select_fields} ||= Bugzilla->fields({
+        by_name => 1,
+        type    => [FIELD_TYPE_MULTI_SELECT, FIELD_TYPE_BUG_URLS]});
+    return $self->{multi_select_fields};
+}
+
+# $self->{params} contains values that could be undef, could be a string,
+# or could be an arrayref. Sometimes we want that value as an array,
+# always.
+sub _param_array {
+    my ($self, $name) = @_;
+    my $value = $self->_params->{$name};
+    if (!defined $value) {
+        return ();
+    }
+    if (ref($value) eq 'ARRAY') {
+        return @$value;
+    }
+    return ($value);
+}
+
+sub _params { $_[0]->{params} }
+sub _user { return $_[0]->{user} }
+sub _sharer_id { $_[0]->{sharer} }
+
+##############################
+# Internal Accessors: SELECT #
+##############################
+
+# These are the fields the user has chosen to display on the buglist,
+# exactly as they were passed to new().
+sub _input_columns { @{ $_[0]->{'fields'} || [] } }
+
+# These are columns that are also going to be in the SELECT for one reason
+# or another, but weren't actually requested by the caller.
+sub _extra_columns {
+    my ($self) = @_;
+    # Everything that's going to be in the ORDER BY must also be
+    # in the SELECT.
+    push(@{ $self->{extra_columns} }, $self->_valid_order_columns);
+    return @{ $self->{extra_columns} };
+}
+
+# For search functions to modify extra_columns. It doesn't matter if
+# people push the same column onto this array multiple times, because
+# _select_columns will call "uniq" on its final result.
+sub _add_extra_column {
+    my ($self, $column) = @_;
+    push(@{ $self->{extra_columns} }, $column);
+}
+
+# These are the columns that we're going to be actually SELECTing.
+sub _display_columns {
+    my ($self) = @_;
+    return @{ $self->{display_columns} } if $self->{display_columns};
+
+    # Do not alter the list from _input_columns at all, even if there are
+    # duplicated columns. Those are passed by the caller, and the caller
+    # expects to get them back in the exact same order.
+    my @columns = $self->_input_columns;
+
+    # Only add columns which are not already listed.
+    my %list = map { $_ => 1 } @columns;
+    foreach my $column ($self->_extra_columns) {
+        push(@columns, $column) unless $list{$column}++;
+    }
+    $self->{display_columns} = \@columns;
+    return @{ $self->{display_columns} };
+}
+
+# These are the columns that are involved in the query.
+sub _select_columns {
+    my ($self) = @_;
+    return @{ $self->{select_columns} } if $self->{select_columns};
+
+    my @select_columns;
+    foreach my $column ($self->_display_columns) {
+        if (my $add_first = COLUMN_DEPENDS->{$column}) {
+            push(@select_columns, @$add_first);
+        }
+        push(@select_columns, $column);
+    }
+    # Remove duplicated columns.
+    $self->{select_columns} = [uniq @select_columns];
+    return @{ $self->{select_columns} };
+}
+
+# This takes _display_columns and translates it into the actual SQL that
+# will go into the SELECT clause.
+sub _sql_select {
+    my ($self) = @_;
+    my @sql_fields;
+    foreach my $column ($self->_display_columns) {
+        my $alias = $column;
+        # Aliases cannot contain dots in them. We convert them to underscores.
+        $alias =~ s/\./_/g;
+        my $sql = $self->COLUMNS->{$column}->{name} . " AS $alias";
+        push(@sql_fields, $sql);
+    }
+    return @sql_fields;
+}
+
+################################
+# Internal Accessors: ORDER BY #
+################################
+
+# The "order" that was requested by the consumer, exactly as it was
+# requested.
+sub _input_order { @{ $_[0]->{'order'} || [] } }
+# Requested order with invalid values removed and old names translated
+sub _valid_order {
+    my ($self) = @_;
+    return map { ($self->_validate_order_column($_)) } $self->_input_order;
+}
+# The valid order with just the column names, and no ASC or DESC.
+sub _valid_order_columns {
+    my ($self) = @_;
+    return map { (split_order_term($_))[0] } $self->_valid_order;
+}
+
+sub _validate_order_column {
+    my ($self, $order_item) = @_;
+
+    # Translate old column names
+    my ($field, $direction) = split_order_term($order_item);
+    $field = $self->_translate_old_column($field);
+
+    # Only accept valid columns
+    return if (!exists $self->COLUMNS->{$field});
+
+    # Relevance column can be used only with one or more fulltext searches
+    return if ($field eq 'relevance' && !$self->COLUMNS->{$field}->{name});
+
+    $direction = " $direction" if $direction;
+    return "$field$direction";
+}
+
+# A hashref that describes all the special stuff that has to be done
+# for various fields if they go into the ORDER BY clause.
+sub _special_order {
+    my ($self) = @_;
+    return $self->{special_order} if $self->{special_order};
+    
+    my %special_order = %{ SPECIAL_ORDER() };
+    my $select_fields = Bugzilla->fields({ type => FIELD_TYPE_SINGLE_SELECT });
+    foreach my $field (@$select_fields) {
+        next if $field->is_abnormal;
+        my $name = $field->name;
+        $special_order{$name} = {
+            order => ["map_$name.sortkey", "map_$name.value"],
+            join  => {
+                table => $name,
+                from  => "bugs.$name",
+                to    => "value",
+                join  => 'INNER',
+            }
+        };
+    }
+    $self->{special_order} = \%special_order;
+    return $self->{special_order};
+}
+
+sub _sql_order_by {
+    my ($self) = @_;
+    if (!$self->{sql_order_by}) {
+        my @order_by = map { $self->_translate_order_by_column($_) }
+                           $self->_valid_order;
+        $self->{sql_order_by} = \@order_by;
+    }
+    return @{ $self->{sql_order_by} };
+}
+
+sub _translate_order_by_column {
+    my ($self, $order_by_item) = @_;
+
+    my ($field, $direction) = split_order_term($order_by_item);
+    
+    $direction = '' if lc($direction) eq 'asc';
+    my $special_order = $self->_special_order->{$field}->{order};
+    # Standard fields have underscores in their SELECT alias instead
+    # of a period (because aliases can't have periods).
+    $field =~ s/\./_/g;
+    my @items = $special_order ? @$special_order : $field;
+    if (lc($direction) eq 'desc') {
+        @items = map { "$_ DESC" } @items;
+    }
+    return @items;
+}
+
+#############################
+# Internal Accessors: LIMIT #
+#############################
+
+sub _sql_limit {
+    my ($self) = @_;
+    my $limit = $self->_params->{limit};
+    my $offset = $self->_params->{offset};
+    
+    my $max_results = Bugzilla->params->{'max_search_results'};
+    if (!$self->{allow_unlimited} && (!$limit || $limit > $max_results)) {
+        $limit = $max_results;
+    }
+    
+    if (defined($offset) && !$limit) {
+        $limit = INT_MAX;
+    }
+    if (defined $limit) {
+        detaint_natural($limit) 
+            || ThrowCodeError('param_must_be_numeric', 
+                              { function => 'Bugzilla::Search::new',
+                                param    => 'limit' });
+        if (defined $offset) {
+            detaint_natural($offset)
+                || ThrowCodeError('param_must_be_numeric',
+                                  { function => 'Bugzilla::Search::new',
+                                    param    => 'offset' });
+        }
+        return Bugzilla->dbh->sql_limit($limit, $offset);
+    }
+    return '';
+}
+
+############################
+# Internal Accessors: FROM #
+############################
+
+sub _column_join {
+    my ($self, $field) = @_;
+    # The _realname fields require the same join as the username fields.
+    $field =~ s/_realname$//;
+    my $column_joins = $self->_get_column_joins();
+    my $join_info = $column_joins->{$field};
+    if ($join_info) {
+        # Don't allow callers to modify the constant.
+        $join_info = dclone($join_info);
+    }
+    else {
+        if ($self->_multi_select_fields->{$field}) {
+            $join_info = { table => "bug_$field" };
+        }
+    }
+    if ($join_info and !$join_info->{as}) {
+        $join_info = dclone($join_info);
+        $join_info->{as} = "map_$field";
+    }
+    return $join_info ? $join_info : ();
+}
+
+# Sometimes we join the same table more than once. In this case, we
+# want to AND all the various critiera that were used in both joins.
+sub _combine_joins {
+    my ($self, $joins) = @_;
+    my @result;
+    while(my $join = shift @$joins) {
+        my $name = $join->{as};
+        my ($others_like_me, $the_rest) = part { $_->{as} eq $name ? 0 : 1 }
+                                               @$joins;
+        if ($others_like_me) {
+            my $from = $join->{from};
+            my $to   = $join->{to};
+            # Sanity check to make sure that we have the same from and to
+            # for all the same-named joins.
+            if ($from) {
+                all { $_->{from} eq $from } @$others_like_me
+                  or die "Not all same-named joins have identical 'from': "
+                         . Dumper($join, $others_like_me);
+            }
+            if ($to) {
+                all { $_->{to} eq $to } @$others_like_me
+                  or die "Not all same-named joins have identical 'to': "
+                         . Dumper($join, $others_like_me);
+            }
+            
+            # We don't need to call uniq here--translate_join will do that
+            # for us.
+            my @conditions = map { @{ $_->{extra} || [] } }
+                                 ($join, @$others_like_me);
+            $join->{extra} = \@conditions;
+            $joins = $the_rest;
+        }
+        push(@result, $join);
+    }
+    
+    return @result;
+}
+
+# Takes all the "then_to" items and just puts them as the next item in
+# the array. Right now this only does one level of "then_to", but we
+# could re-write this to handle then_to recursively if we need more levels.
+sub _extract_then_to {
+    my ($self, $joins) = @_;
+    my @result;
+    foreach my $join (@$joins) {
+        push(@result, $join);
+        if (my $then_to = $join->{then_to}) {
+            push(@result, $then_to);
+        }
+    }
+    return @result;
+}
+
+# JOIN statements for the SELECT and ORDER BY columns. This should not be
+# called until the moment it is needed, because _select_columns might be
+# modified by the charts.
+sub _select_order_joins {
+    my ($self) = @_;
+    my @joins;
+    foreach my $field ($self->_select_columns) {
+        my @column_join = $self->_column_join($field);
+        push(@joins, @column_join);
+    }
+    foreach my $field ($self->_valid_order_columns) {
+        my $join_info = $self->_special_order->{$field}->{join};
+        if ($join_info) {
+            # Don't let callers modify SPECIAL_ORDER.
+            $join_info = dclone($join_info);
+            if (!$join_info->{as}) {
+                $join_info->{as} = "map_$field";
+            }
+            push(@joins, $join_info);
+        }
+    }
+    return @joins;
+}
+
+# These are the joins that are *always* in the FROM clause.
+sub _standard_joins {
+    my ($self) = @_;
+    my $user = $self->_user;
+    my @joins;
+    return () if $self->{_no_security_check};
+
+    my $security_join = {
+        table => 'bug_group_map',
+        as    => 'security_map',
+    };
+    push(@joins, $security_join);
+
+    if ($user->id) {
+        $security_join->{extra} =
+            ["NOT (" . $user->groups_in_sql('security_map.group_id') . ")"];
+            
+        my $security_cc_join = {
+            table => 'cc',
+            as    => 'security_cc',
+            extra => ['security_cc.who = ' . $user->id],
+        };
+        push(@joins, $security_cc_join);
+    }
+    
+    return @joins;
+}
+
+sub _sql_from {
+    my ($self, $joins_input) = @_;
+    my @joins = ($self->_standard_joins, $self->_select_order_joins,
+                 @$joins_input);
+    @joins = $self->_extract_then_to(\@joins);
+    @joins = $self->_combine_joins(\@joins);
+    my @join_sql = map { $self->_translate_join($_) } @joins;
+    return "bugs\n" . join("\n", @join_sql);
+}
+
+# This takes a join data structure and turns it into actual JOIN SQL.
+sub _translate_join {
+    my ($self, $join_info) = @_;
+    
+    die "join with no table: " . Dumper($join_info) if !$join_info->{table};
+    die "join with no 'as': " . Dumper($join_info) if !$join_info->{as};
+
+    my $from_table = $join_info->{bugs_table} || "bugs";
+    my $from  = $join_info->{from} || "bug_id";
+    if ($from =~ /^(\w+)\.(\w+)$/) {
+        ($from_table, $from) = ($1, $2);
+    }
+    my $table = $join_info->{table};
+    my $name  = $join_info->{as};
+    my $to    = $join_info->{to}    || "bug_id";
+    my $join  = $join_info->{join}  || 'LEFT';
+    my @extra = @{ $join_info->{extra} || [] };
+    $name =~ s/\./_/g;
+    
+    # If a term contains ORs, we need to put parens around the condition.
+    # This is a pretty weak test, but it's actually OK to put parens
+    # around too many things.
+    @extra = map { $_ =~ /\bOR\b/i ? "($_)" : $_ } @extra;
+    my $extra_condition = join(' AND ', uniq @extra);
+    if ($extra_condition) {
+        $extra_condition = " AND $extra_condition";
+    }
+
+    my @join_sql = "$join JOIN $table AS $name"
+                        . " ON $from_table.$from = $name.$to$extra_condition";
+    return @join_sql;
+}
+
+#############################
+# Internal Accessors: WHERE #
+#############################
+
+# Note: There's also quite a bit of stuff that affects the WHERE clause
+# in the "Internal Accessors: Boolean Charts" section.
+
+# The terms that are always in the WHERE clause. These implement bug
+# group security.
+sub _standard_where {
+    my ($self) = @_;
+    return ('1=1') if $self->{_no_security_check};
+    # If replication lags badly between the shadow db and the main DB,
+    # it's possible for bugs to show up in searches before their group
+    # controls are properly set. To prevent this, when initially creating
+    # bugs we set their creation_ts to NULL, and don't give them a creation_ts
+    # until their group controls are set. So if a bug has a NULL creation_ts,
+    # it shouldn't show up in searches at all.
+    my @where = ('bugs.creation_ts IS NOT NULL');
+    
+    my $security_term = 'security_map.group_id IS NULL';
+
+    my $user = $self->_user;
+    if ($user->id) {
+        my $userid = $user->id;
+        # This indentation makes the resulting SQL more readable.
+        $security_term .= <<END;
+
+        OR (bugs.reporter_accessible = 1 AND bugs.reporter = $userid)
+        OR (bugs.cclist_accessible = 1 AND security_cc.who IS NOT NULL)
+        OR bugs.assigned_to = $userid
+END
+        if (Bugzilla->params->{'useqacontact'}) {
+            $security_term.= "        OR bugs.qa_contact = $userid";
+        }
+        $security_term = "($security_term)";
+    }
+
+    push(@where, $security_term);
+
+    return @where;
+}
+
+sub _sql_where {
+    my ($self, $main_clause) = @_;
+    # The newline and this particular spacing makes the resulting
+    # SQL a bit more readable for debugging.
+    my $where = join("\n   AND ", $self->_standard_where);
+    my $clause_sql = $main_clause->as_string;
+    $where .= "\n   AND " . $clause_sql if $clause_sql;
+    return $where;
+}
+
+################################
+# Internal Accessors: GROUP BY #
+################################
+
+# And these are the fields that we have to do GROUP BY for in DBs
+# that are more strict about putting everything into GROUP BY.
+sub _sql_group_by {
+    my ($self) = @_;
+
+    # Strict DBs require every element from the SELECT to be in the GROUP BY,
+    # unless that element is being used in an aggregate function.
+    my @extra_group_by;
+    foreach my $column ($self->_select_columns) {
+        next if $self->_skip_group_by->{$column};
+        my $sql = $self->COLUMNS->{$column}->{name};
+        push(@extra_group_by, $sql);
+    }
+
+    # And all items from ORDER BY must be in the GROUP BY. The above loop 
+    # doesn't catch items that were put into the ORDER BY from SPECIAL_ORDER.
+    foreach my $column ($self->_valid_order_columns) {
+        my $special_order = $self->_special_order->{$column}->{order};
+        next if !$special_order;
+        push(@extra_group_by, @$special_order);
+    }
+    
+    @extra_group_by = uniq @extra_group_by;
+    
+    # bug_id is the only field we actually group by.
+    return ('bugs.bug_id', join(',', @extra_group_by));
+}
+
+# A helper for _sql_group_by.
+sub _skip_group_by {
+    my ($self) = @_;
+    return $self->{skip_group_by} if $self->{skip_group_by};
+    my @skip_list = GROUP_BY_SKIP;
+    push(@skip_list, keys %{ $self->_multi_select_fields });
+    my %skip_hash = map { $_ => 1 } @skip_list;
+    $self->{skip_group_by} = \%skip_hash;
+    return $self->{skip_group_by};
+}
+
+##############################################
+# Internal Accessors: Special Params Parsing #
+##############################################
+
+# Backwards compatibility for old field names.
+sub _convert_old_params {
+    my ($self) = @_;
+    my $params = $self->_params;
+    
+    # bugidtype has different values in modern Search.pm.
+    if (defined $params->{'bugidtype'}) {
+        my $value = $params->{'bugidtype'};
+        $params->{'bugidtype'} = $value eq 'exclude' ? 'nowords' : 'anyexact';
+    }
+    
+    foreach my $old_name (keys %{ FIELD_MAP() }) {
+        if (defined $params->{$old_name}) {
+            my $new_name = FIELD_MAP->{$old_name};
+            $params->{$new_name} = delete $params->{$old_name};
+        }
+    }
+}
+
+# This parses all the standard search parameters except for the boolean
+# charts.
+sub _special_charts {
+    my ($self) = @_;
+    $self->_convert_old_params();
+    $self->_special_parse_bug_status();
+    $self->_special_parse_resolution();
+    my $clause = new Bugzilla::Search::Clause();
+    $clause->add( $self->_parse_basic_fields()     );
+    $clause->add( $self->_special_parse_email()    );
+    $clause->add( $self->_special_parse_chfield()  );
+    $clause->add( $self->_special_parse_deadline() );
+    return $clause;
+}
+
+sub _parse_basic_fields {
+    my ($self) = @_;
+    my $params = $self->_params;
+    my $chart_fields = $self->_chart_fields;
+    
+    my $clause = new Bugzilla::Search::Clause();
+    foreach my $field_name (keys %$chart_fields) {
+        # CGI params shouldn't have periods in them, so we only accept
+        # period-separated fields with underscores where the periods go.
+        my $param_name = $field_name;
+        $param_name =~ s/\./_/g;
+        my @values = $self->_param_array($param_name);
+        next if !@values;
+        my $default_op = $param_name eq 'content' ? 'matches' : 'anyexact';
+        my $operator = $params->{"${param_name}_type"} || $default_op;
+        # Fields that are displayed as multi-selects are passed as arrays,
+        # so that they can properly search values that contain commas.
+        # However, other fields are sent as strings, so that they are properly
+        # split on commas if required.
+        my $field = $chart_fields->{$field_name};
+        my $pass_value;
+        if ($field->is_select or $field->name eq 'version'
+            or $field->name eq 'target_milestone')
+        {
+            $pass_value = \@values;
+        }
+        else {
+            $pass_value = join(',', @values);
+        }
+        $clause->add($field_name, $operator, $pass_value);
+    }
+    return @{$clause->children} ? $clause : undef;
+}
+
+sub _special_parse_bug_status {
+    my ($self) = @_;
+    my $params = $self->_params;
+    return if !defined $params->{'bug_status'};
+    # We want to allow the bug_status_type parameter to work normally,
+    # meaning that this special code should only be activated if we are
+    # doing the normal "anyexact" search on bug_status.
+    return if (defined $params->{'bug_status_type'}
+               and $params->{'bug_status_type'} ne 'anyexact');
+
+    my @bug_status = $self->_param_array('bug_status');
+    # Also include inactive bug statuses, as you can query them.
+    my $legal_statuses = $self->_chart_fields->{'bug_status'}->legal_values;
+
+    # If the status contains __open__ or __closed__, translate those
+    # into their equivalent lists of open and closed statuses.
+    if (grep { $_ eq '__open__' } @bug_status) {
+        my @open = grep { $_->is_open } @$legal_statuses;
+        @open = map { $_->name } @open;
+        push(@bug_status, @open);
+    }
+    if (grep { $_ eq '__closed__' } @bug_status) {
+        my @closed = grep { not $_->is_open } @$legal_statuses;
+        @closed = map { $_->name } @closed;
+        push(@bug_status, @closed);
+    }
+
+    @bug_status = uniq @bug_status;
+    my $all = grep { $_ eq "__all__" } @bug_status;
+    # This will also handle removing __open__ and __closed__ for us
+    # (__all__ too, which is why we check for it above, first).
+    @bug_status = _valid_values(\@bug_status, $legal_statuses);
+
+    # If the user has selected every status, change to selecting none.
+    # This is functionally equivalent, but quite a lot faster.
+    if ($all or scalar(@bug_status) == scalar(@$legal_statuses)) {
+        delete $params->{'bug_status'};
+    }
+    else {
+        $params->{'bug_status'} = \@bug_status;
+    }
+}
+
+sub _special_parse_chfield {
+    my ($self) = @_;
+    my $params = $self->_params;
+    
+    my $date_from = trim(lc($params->{'chfieldfrom'} || ''));
+    my $date_to = trim(lc($params->{'chfieldto'} || ''));
+    $date_from = '' if $date_from eq 'now';
+    $date_to = '' if $date_to eq 'now';
+    my @fields = $self->_param_array('chfield');
+    my $value_to = $params->{'chfieldvalue'};
+    $value_to = '' if !defined $value_to;
+
+    @fields = map { $_ eq '[Bug creation]' ? 'creation_ts' : $_ } @fields;
+
+    my $clause = new Bugzilla::Search::Clause();
+
+    # It is always safe and useful to push delta_ts into the charts
+    # if there is a "from" date specified. It doesn't conflict with
+    # searching [Bug creation], because a bug's delta_ts is set to
+    # its creation_ts when it is created. So this just gives the
+    # database an additional index to possibly choose, on a table that
+    # is smaller than bugs_activity.
+    if ($date_from ne '') {
+        $clause->add('delta_ts', 'greaterthaneq', $date_from);
+    }
+    # It's not normally safe to do it for "to" dates, though--"chfieldto" means
+    # "a field that changed before this date", and delta_ts could be either
+    # later or earlier than that, if we're searching for the time that a field
+    # changed. However, chfieldto all by itself, without any chfieldvalue or
+    # chfield, means "just search delta_ts", and so we still want that to
+    # work.
+    if ($date_to ne '' and !@fields and $value_to eq '') {
+        $clause->add('delta_ts', 'lessthaneq', $date_to);
+    }
+
+    # Basically, we construct the chart like:
+    #
+    # (added_for_field1 = value OR added_for_field2 = value)
+    # AND (date_field1_changed >= date_from OR date_field2_changed >= date_from)
+    # AND (date_field1_changed <= date_to OR date_field2_changed <= date_to)
+    #
+    # Theoretically, all we *really* would need to do is look for the field id
+    # in the bugs_activity table, because we've already limited the search
+    # by delta_ts above, but there's no chart to do that, so we check the
+    # change date of the fields.
+    
+    if ($value_to ne '') {
+        my $value_clause = new Bugzilla::Search::Clause('OR');
+        foreach my $field (@fields) {
+            $value_clause->add($field, 'changedto', $value_to);
+        }
+        $clause->add($value_clause);
+    }
+
+    if ($date_from ne '') {
+        my $from_clause = new Bugzilla::Search::Clause('OR');
+        foreach my $field (@fields) {
+            $from_clause->add($field, 'changedafter', $date_from);
+        }
+        $clause->add($from_clause);
+    }
+    if ($date_to ne '') {
+        # chfieldto is supposed to be a relative date or a date of the form
+        # YYYY-MM-DD, i.e. without the time appended to it. We append the
+        # time ourselves so that the end date is correctly taken into account.
+        $date_to .= ' 23:59:59' if $date_to =~ /^\d{4}-\d{1,2}-\d{1,2}$/;
+
+        my $to_clause = new Bugzilla::Search::Clause('OR');
+        foreach my $field (@fields) {
+            $to_clause->add($field, 'changedbefore', $date_to);
+        }
+        $clause->add($to_clause);
+    }
+
+    return @{$clause->children} ? $clause : undef;
+}
+
+sub _special_parse_deadline {
+    my ($self) = @_;
+    return if !$self->_user->is_timetracker;
+    my $params = $self->_params;
+    
+    my $clause = new Bugzilla::Search::Clause();
+    if (my $from = $params->{'deadlinefrom'}) {
+        $clause->add('deadline', 'greaterthaneq', $from);
+    }
+    if (my $to = $params->{'deadlineto'}) {
+        $clause->add('deadline', 'lessthaneq', $to);
+    }
+
+    return @{$clause->children} ? $clause : undef;
+}
+
+sub _special_parse_email {
+    my ($self) = @_;
+    my $params = $self->_params;
+    
+    my @email_params = grep { $_ =~ /^email\d+$/ } keys %$params;
+    
+    my $clause = new Bugzilla::Search::Clause();
+    foreach my $param (@email_params) {
+        $param =~ /(\d+)$/;
+        my $id = $1;
+        my $email = trim($params->{"email$id"});
+        next if !$email;
+        my $type = $params->{"emailtype$id"} || 'anyexact';
+        $type = "anyexact" if $type eq "exact";
+
+        my $or_clause = new Bugzilla::Search::Clause('OR');
+        foreach my $field (qw(assigned_to reporter cc qa_contact)) {
+            if ($params->{"email$field$id"}) {
+                $or_clause->add($field, $type, $email);
+            }
+        }
+        if ($params->{"emaillongdesc$id"}) {
+            $or_clause->add("commenter", $type, $email);
+        }
+        
+        $clause->add($or_clause);
+    }
+
+    return @{$clause->children} ? $clause : undef;
+}
+
+sub _special_parse_resolution {
+    my ($self) = @_;
+    my $params = $self->_params;
+    return if !defined $params->{'resolution'};
+
+    my @resolution = $self->_param_array('resolution');
+    my $legal_resolutions = $self->_chart_fields->{resolution}->legal_values;
+    @resolution = _valid_values(\@resolution, $legal_resolutions, '---');
+    if (scalar(@resolution) == scalar(@$legal_resolutions)) {
+        delete $params->{'resolution'};
+    }
+}
+
+sub _valid_values {
+    my ($input, $valid, $extra_value) = @_;
+    my @result;
+    foreach my $item (@$input) {
+        $item = trim($item);
+        if (defined $extra_value and $item eq $extra_value) {
+            push(@result, $item);
+        }
+        elsif (grep { $_->name eq $item } @$valid) {
+            push(@result, $item);
+        }
+    }
+    return @result;
+}
+
+######################################
+# Internal Accessors: Boolean Charts #
+######################################
+
+sub _charts_to_conditions {
+    my ($self) = @_;
+    
+    my $clause = $self->_charts;
+    my @joins;
+    $clause->walk_conditions(sub {
+        my ($clause, $condition) = @_;
+        return if !$condition->translated;
+        push(@joins, @{ $condition->translated->{joins} });
+    });
+    return (\@joins, $clause);
+}
+
+sub _charts {
+    my ($self) = @_;
+    
+    my $clause = $self->_params_to_data_structure();
+    my $chart_id = 0;
+    $clause->walk_conditions(sub { $self->_handle_chart($chart_id++, @_) });
+    return $clause;
+}
+
+sub _params_to_data_structure {
+    my ($self) = @_;
+    
+    # First we get the "special" charts, representing all the normal
+    # fields on the search page. This may modify _params, so it needs to
+    # happen first.
+    my $clause = $self->_special_charts;
+
+    # Then we process the old Boolean Charts input format.
+    $clause->add( $self->_boolean_charts );
+    
+    # And then process the modern "custom search" format.
+    $clause->add( $self->_custom_search );
+    
+    return $clause;
+}
+
+sub _boolean_charts {
+    my ($self) = @_;
+    
+    my $params = $self->_params;
+    my @param_list = keys %$params;
+    
+    my @all_field_params = grep { /^field-?\d+/ } @param_list;
+    my @chart_ids = map { /^field(-?\d+)/; $1 } @all_field_params;
+    @chart_ids = sort { $a <=> $b } uniq @chart_ids;
+    
+    my $clause = new Bugzilla::Search::Clause();
+    foreach my $chart_id (@chart_ids) {
+        my @all_and = grep { /^field$chart_id-\d+/ } @param_list;
+        my @and_ids = map { /^field$chart_id-(\d+)/; $1 } @all_and;
+        @and_ids = sort { $a <=> $b } uniq @and_ids;
+        
+        my $and_clause = new Bugzilla::Search::Clause();
+        foreach my $and_id (@and_ids) {
+            my @all_or = grep { /^field$chart_id-$and_id-\d+/ } @param_list;
+            my @or_ids = map { /^field$chart_id-$and_id-(\d+)/; $1 } @all_or;
+            @or_ids = sort { $a <=> $b } uniq @or_ids;
+            
+            my $or_clause = new Bugzilla::Search::Clause('OR');
+            foreach my $or_id (@or_ids) {
+                my $identifier = "$chart_id-$and_id-$or_id";
+                my $field = $params->{"field$identifier"};
+                my $operator = $params->{"type$identifier"};
+                my $value = $params->{"value$identifier"};
+                $or_clause->add($field, $operator, $value);
+            }
+            $and_clause->add($or_clause);
+            $and_clause->negate(1) if $params->{"negate$chart_id"};
+        }
+        $clause->add($and_clause);
+    }
+
+    return @{$clause->children} ? $clause : undef;
+}
+
+sub _custom_search {
+    my ($self) = @_;
+    my $params = $self->_params;
+
+    my @field_ids = $self->_field_ids;
+    return unless scalar @field_ids;
+
+    my $joiner = $params->{j_top} || '';
+    my $current_clause = $joiner eq 'AND_G'
+        ? new Bugzilla::Search::ClauseGroup()
+        : new Bugzilla::Search::Clause($joiner);
+
+    my @clause_stack;
+    foreach my $id (@field_ids) {
+        my $field = $params->{"f$id"};
+        if ($field eq 'OP') {
+            my $joiner = $params->{"j$id"} || '';
+            my $new_clause = $joiner eq 'AND_G'
+                ? new Bugzilla::Search::ClauseGroup()
+                : new Bugzilla::Search::Clause($joiner);
+            $new_clause->negate($params->{"n$id"});
+            $current_clause->add($new_clause);
+            push(@clause_stack, $current_clause);
+            $current_clause = $new_clause;
+            next;
+        }
+        if ($field eq 'CP') {
+            $current_clause = pop @clause_stack;
+            ThrowCodeError('search_cp_without_op', { id => $id })
+                if !$current_clause;
+            next;
+        }
+        
+        my $operator = $params->{"o$id"};
+        my $value = $params->{"v$id"};
+        my $condition = condition($field, $operator, $value);
+        $condition->negate($params->{"n$id"});
+        $current_clause->add($condition);
+    }
+    
+    # We allow people to specify more OPs than CPs, so at the end of the
+    # loop our top clause may be still in the stack instead of being
+    # $current_clause.
+    return $clause_stack[0] || $current_clause;
+}
+
+sub _field_ids {
+    my ($self) = @_;
+    my $params = $self->_params;
+    my @param_list = keys %$params;
+    
+    my @field_params = grep { /^f\d+$/ } @param_list;
+    my @field_ids = map { /(\d+)/; $1 } @field_params;
+    @field_ids = sort { $a <=> $b } @field_ids;
+    return @field_ids;
+}
+
+sub _handle_chart {
+    my ($self, $chart_id, $clause, $condition) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $params = $self->_params;
+    my ($field, $operator, $value) = $condition->fov;
+    return if (!defined $field or !defined $operator or !defined $value);
+    $field = FIELD_MAP->{$field} || $field;
+    
+    my $string_value;
+    if (ref $value eq 'ARRAY') {
+        # Trim input and ignore blank values.
+        @$value = map { trim($_) } @$value;
+        @$value = grep { defined $_ and $_ ne '' } @$value;
+        return if !@$value;
+        $string_value = join(',', @$value);
+    }
+    else {
+        return if $value eq '';
+        $string_value = $value;
+    }
+    
+    $self->_chart_fields->{$field}
+        or ThrowCodeError("invalid_field_name", { field => $field });
+    trick_taint($field);
+    
+    # This is the field as you'd reference it in a SQL statement.
+    my $full_field = $field =~ /\./ ? $field : "bugs.$field";
+
+    # "value" and "quoted" are for search functions that always operate
+    # on a scalar string and never care if they were passed multiple
+    # parameters. If the user does pass multiple parameters, they will
+    # become a space-separated string for those search functions.
+    #
+    # all_values is for search functions that do operate
+    # on multiple values, like anyexact.
+    
+    my %search_args = (
+        chart_id     => $chart_id,
+        sequence     => $chart_id,
+        field        => $field,
+        full_field   => $full_field,
+        operator     => $operator,
+        value        => $string_value,
+        all_values   => $value,
+        joins        => [],
+        bugs_table   => 'bugs',
+        table_suffix => '',
+        condition    => $condition,
+    );
+    $clause->update_search_args(\%search_args);
+
+    $search_args{quoted} = $self->_quote_unless_numeric(\%search_args);
+    # This should add a "term" selement to %search_args.
+    $self->do_search_function(\%search_args);
+
+    # If term is left empty, then this means the criteria
+    # has no effect and can be ignored.
+    return unless $search_args{term};
+
+    # All the things here that don't get pulled out of
+    # %search_args are their original values before
+    # do_search_function modified them.   
+    $self->search_description({
+        field => $field, type => $operator,
+        value => $string_value, term => $search_args{term},
+    });
+
+    foreach my $join (@{ $search_args{joins} }) {
+        $join->{bugs_table}   = $search_args{bugs_table};
+        $join->{table_suffix} = $search_args{table_suffix};
+    }
+
+    $condition->translated(\%search_args);
+}
+
+##################################
+# do_search_function And Helpers #
+##################################
+
+# This takes information about the current boolean chart and translates
+# it into SQL, using the constants at the top of this file.
+sub do_search_function {
+    my ($self, $args) = @_;
+    my ($field, $operator) = @$args{qw(field operator)};
+    
+    if (my $parse_func = SPECIAL_PARSING->{$field}) {
+        $self->$parse_func($args);
+        # Some parsing functions set $term, though most do not.
+        # For the ones that set $term, we don't need to do any further
+        # parsing.
+        return if $args->{term};
+    }
+    
+    my $operator_field_override = $self->_get_operator_field_override();
+    my $override = $operator_field_override->{$field};
+    # Attachment fields get special handling, if they don't have a specific
+    # individual override.
+    if (!$override and $field =~ /^attachments\./) {
+        $override = $operator_field_override->{attachments};
+    }
+    # If there's still no override, check for an override on the field's type.
+    if (!$override) {
+        my $field_obj = $self->_chart_fields->{$field};
+        $override = $operator_field_override->{$field_obj->type};
+    }
+    
+    if ($override) {
+        my $search_func = $self->_pick_override_function($override, $operator);
+        $self->$search_func($args) if $search_func;
+    }
+
+    # Some search functions set $term, and some don't. For the ones that
+    # don't (or for fields that don't have overrides) we now call the
+    # direct operator function from OPERATORS.
+    if (!defined $args->{term}) {
+        $self->_do_operator_function($args);
+    }
+    
+    if (!defined $args->{term}) {
+        # This field and this type don't work together. Generally,
+        # this should never be reached, because it should be handled
+        # explicitly by OPERATOR_FIELD_OVERRIDE.
+        ThrowUserError("search_field_operator_invalid",
+                       { field => $field, operator => $operator });
+    }
+}
+
+# A helper for various search functions that need to run operator
+# functions directly.
+sub _do_operator_function {
+    my ($self, $func_args) = @_;
+    my $operator = $func_args->{operator};
+    my $operator_func = OPERATORS->{$operator}
+      || ThrowCodeError("search_field_operator_unsupported",
+                        { operator => $operator });
+    $self->$operator_func($func_args);
+}
+
+sub _reverse_operator {
+    my ($self, $operator) = @_;
+    my $reverse = OPERATOR_REVERSE->{$operator};
+    return $reverse if $reverse;
+    if ($operator =~ s/^not//) {
+        return $operator;
+    }
+    return "not$operator";
+}
+
+sub _pick_override_function {
+    my ($self, $override, $operator) = @_;
+    my $search_func = $override->{$operator};
+
+    if (!$search_func) {
+        # If we don't find an override for one specific operator,
+        # then there are some special override types:
+        # _non_changed: For any operator that doesn't have the word
+        #               "changed" in it
+        # _default: Overrides all operators that aren't explicitly specified.
+        if ($override->{_non_changed} and $operator !~ /changed/) {
+            $search_func = $override->{_non_changed};
+        }
+        elsif ($override->{_default}) {
+            $search_func = $override->{_default};
+        }
+    }
+
+    return $search_func;
+}
+
+sub _get_operator_field_override {
+    my $self = shift;
+    my $cache = Bugzilla->request_cache;
+
+    return $cache->{operator_field_override} 
+        if defined $cache->{operator_field_override};
+
+    my %operator_field_override = %{ OPERATOR_FIELD_OVERRIDE() };
+    Bugzilla::Hook::process('search_operator_field_override',
+                            { search => $self, 
+                              operators => \%operator_field_override });
+
+    $cache->{operator_field_override} = \%operator_field_override;
+    return $cache->{operator_field_override};
+}
+
+sub _get_column_joins {
+    my $self = shift;
+    my $cache = Bugzilla->request_cache;
+
+    return $cache->{column_joins} if defined $cache->{column_joins};
+
+    my %column_joins = %{ $self->COLUMN_JOINS() };
+    Bugzilla::Hook::process('buglist_column_joins',
+                            { column_joins => \%column_joins });
+
+    $cache->{column_joins} = \%column_joins;
+    return $cache->{column_joins};
+}
+
+###########################
+# Search Function Helpers #
+###########################
+
+# When we're doing a numeric search against a numeric column, we want to
+# just put a number into the SQL instead of a string. On most DBs, this
+# is just a performance optimization, but on SQLite it actually changes
+# the behavior of some searches.
+sub _quote_unless_numeric {
+    my ($self, $args, $value) = @_;
+    if (!defined $value) {
+        $value = $args->{value};
+    }
+    my ($field, $operator) = @$args{qw(field operator)};
+    
+    my $numeric_operator = !grep { $_ eq $operator } NON_NUMERIC_OPERATORS;
+    my $numeric_field = $self->_chart_fields->{$field}->is_numeric;
+    my $numeric_value = ($value =~ NUMBER_REGEX) ? 1 : 0;
+    my $is_numeric = $numeric_operator && $numeric_field && $numeric_value;
+    if ($is_numeric) {
+        my $quoted = $value;
+        trick_taint($quoted);
+        return $quoted;
+    }
+    return Bugzilla->dbh->quote($value);
+}
+
+sub build_subselect {
+    my ($outer, $inner, $table, $cond, $negate) = @_;
+    # Execute subselects immediately to avoid dependent subqueries, which are
+    # large performance hits on MySql
+    my $q = "SELECT DISTINCT $inner FROM $table WHERE $cond";
+    my $dbh = Bugzilla->dbh;
+    my $list = $dbh->selectcol_arrayref($q);
+    return $negate ? "1=1" : "1=2" unless @$list;
+    return $dbh->sql_in($outer, $list, $negate);
+}
+
+# Used by anyexact to get the list of input values. This allows us to
+# support values with commas inside of them in the standard charts, and
+# still accept string values for the boolean charts (and split them on
+# commas).
+sub _all_values {
+    my ($self, $args, $split_on) = @_;
+    $split_on ||= qr/[\s,]+/;
+    my $dbh = Bugzilla->dbh;
+    my $all_values = $args->{all_values};
+    
+    my @array;
+    if (ref $all_values eq 'ARRAY') {
+        @array = @$all_values;
+    }
+    else {
+        @array = split($split_on, $all_values);
+        @array = map { trim($_) } @array;
+        @array = grep { defined $_ and $_ ne '' } @array;
+    }
+    
+    if ($args->{field} eq 'resolution') {
+        @array = map { $_ eq '---' ? '' : $_ } @array;
+    }
+    
+    return @array;
+}
+
+# Support for "any/all/nowordssubstr" comparison type ("words as substrings")
+sub _substring_terms {
+    my ($self, $args) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    # We don't have to (or want to) use _all_values, because we'd just
+    # split each term on spaces and commas anyway.
+    my @words = split(/[\s,]+/, $args->{value});
+    @words = grep { defined $_ and $_ ne '' } @words;
+    @words = map { $dbh->quote($_) } @words;
+    my @terms = map { $dbh->sql_iposition($_, $args->{full_field}) . " > 0" }
+                    @words;
+    return @terms;
+}
+
+sub _word_terms {
+    my ($self, $args) = @_;
+    my $dbh = Bugzilla->dbh;
+    
+    my @values = split(/[\s,]+/, $args->{value});
+    @values = grep { defined $_ and $_ ne '' } @values;
+    my @substring_terms = $self->_substring_terms($args);
+    
+    my @terms;
+    my $start = $dbh->WORD_START;
+    my $end   = $dbh->WORD_END;
+    foreach my $word (@values) {
+        my $regex  = $start . quotemeta($word) . $end;
+        my $quoted = $dbh->quote($regex);
+        # We don't have to check the regexp, because we escaped it, so we're
+        # sure it's valid.
+        my $regex_term = $dbh->sql_regexp($args->{full_field}, $quoted,
+                                          'no check');
+        # Regular expressions are slow--substring searches are faster.
+        # If we're searching for a word, we're also certain that the
+        # substring will appear in the value. So we limit first by
+        # substring and then by a regex that will match just words.
+        my $substring_term = shift @substring_terms;
+        push(@terms, "$substring_term AND $regex_term");
+    }
+    
+    return @terms;
+}
+
+#####################################
+# "Special Parsing" Functions: Date #
+#####################################
+
+sub _timestamp_translate {
+    my ($self, $args) = @_;
+    my $value = $args->{value};
+    my $dbh = Bugzilla->dbh;
+
+    return if $value !~ /^(?:[\+\-]?\d+[hdwmy]s?|now)$/i;
+
+    # By default, the time is appended to the date, which we don't want
+    # for deadlines.
+    $value = SqlifyDate($value);
+    if ($args->{field} eq 'deadline') {
+        ($value) = split(/\s/, $value);
+    }
+    $args->{value} = $value;
+    $args->{quoted} = $dbh->quote($value);
+}
+
+sub SqlifyDate {
+    my ($str) = @_;
+    my $fmt = "%Y-%m-%d %H:%M:%S";
+    $str = "" if (!defined $str || lc($str) eq 'now');
+    if ($str eq "") {
+        my ($sec, $min, $hour, $mday, $month, $year, $wday) = localtime(time());
+        return sprintf("%4d-%02d-%02d 00:00:00", $year+1900, $month+1, $mday);
+    }
+
+    if ($str =~ /^(-|\+)?(\d+)([hdwmy])(s?)$/i) {   # relative date
+        my ($sign, $amount, $unit, $startof, $date) = ($1, $2, lc $3, lc $4, time);
+        my ($sec, $min, $hour, $mday, $month, $year, $wday)  = localtime($date);
+        if ($sign && $sign eq '+') { $amount = -$amount; }
+        $startof = 1 if $amount == 0;
+        if ($unit eq 'w') {                  # convert weeks to days
+            $amount = 7*$amount;
+            $amount += $wday if $startof;
+            $unit = 'd';
+        }
+        if ($unit eq 'd') {
+            if ($startof) {
+              $fmt = "%Y-%m-%d 00:00:00";
+              $date -= $sec + 60*$min + 3600*$hour;
+            }
+            $date -= 24*3600*$amount;
+            return time2str($fmt, $date);
+        }
+        elsif ($unit eq 'y') {
+            if ($startof) {
+                return sprintf("%4d-01-01 00:00:00", $year+1900-$amount);
+            } 
+            else {
+                return sprintf("%4d-%02d-%02d %02d:%02d:%02d", 
+                               $year+1900-$amount, $month+1, $mday, $hour, $min, $sec);
+            }
+        }
+        elsif ($unit eq 'm') {
+            $month -= $amount;
+            while ($month<0) { $year--; $month += 12; }
+            if ($startof) {
+                return sprintf("%4d-%02d-01 00:00:00", $year+1900, $month+1);
+            }
+            else {
+                return sprintf("%4d-%02d-%02d %02d:%02d:%02d", 
+                               $year+1900, $month+1, $mday, $hour, $min, $sec);
+            }
+        }
+        elsif ($unit eq 'h') {
+            # Special case for 'beginning of an hour'
+            if ($startof) {
+                $fmt = "%Y-%m-%d %H:00:00";
+            } 
+            $date -= 3600*$amount;
+            return time2str($fmt, $date);
+        }
+        return undef;                      # should not happen due to regexp at top
+    }
+    my $date = str2time($str);
+    if (!defined($date)) {
+        ThrowUserError("illegal_date", { date => $str });
+    }
+    return time2str($fmt, $date);
+}
+
+######################################
+# "Special Parsing" Functions: Users #
+######################################
+
+sub pronoun {
+    my ($noun, $user) = (@_);
+    if ($noun eq "%user%") {
+        if ($user->id) {
+            return $user->id;
+        } else {
+            ThrowUserError('login_required_for_pronoun');
+        }
+    }
+    if ($noun eq "%reporter%") {
+        return "bugs.reporter";
+    }
+    if ($noun eq "%assignee%") {
+        return "bugs.assigned_to";
+    }
+    if ($noun eq "%qacontact%") {
+        return "COALESCE(bugs.qa_contact,0)";
+    }
+    return 0;
+}
+
+sub _contact_pronoun {
+    my ($self, $args) = @_;
+    my $value = $args->{value};
+    my $user = $self->_user;
+
+    if ($value =~ /^\%group\.[^%]+%$/) {
+        $self->_contact_exact_group($args);
+    }
+    elsif ($value =~ /^(%\w+%)$/) {
+        $args->{value} = pronoun($1, $user);
+        $args->{quoted} = $args->{value};
+        $args->{value_is_id} = 1;
+    }
+}
+
+sub _contact_exact_group {
+    my ($self, $args) = @_;
+    my ($value, $operator, $field, $chart_id, $joins, $sequence) =
+        @$args{qw(value operator field chart_id joins sequence)};
+    my $dbh = Bugzilla->dbh;
+    my $user = $self->_user;
+
+    # We already know $value will match this regexp, else we wouldn't be here.
+    $value =~ /\%group\.([^%]+)%/;
+    my $group_name = $1;
+    my $group = Bugzilla::Group->check({ name => $group_name, _error => 'invalid_group_name' });
+    # Pass $group_name instead of $group->name to the error message
+    # to not leak the existence of the group.
+    $user->in_group($group)
+      || ThrowUserError('invalid_group_name', { name => $group_name });
+    # Now that we know the user belongs to this group, it's safe
+    # to disclose more information.
+    $group->check_members_are_visible();
+
+    my $group_ids = Bugzilla::Group->flatten_group_membership($group->id);
+
+    if ($field eq 'cc' && $chart_id eq '') {
+        # This is for the email1, email2, email3 fields from query.cgi.
+        $chart_id = "CC$$sequence";
+        $args->{sequence}++;
+    }
+
+    my $from = $field;
+    # These fields need an additional table.
+    if ($field =~ /^(commenter|cc)$/) {
+        my $join_table = $field;
+        $join_table = 'longdescs' if $field eq 'commenter';
+        my $join_table_alias = "${field}_$chart_id";
+        push(@$joins, { table => $join_table, as => $join_table_alias });
+        $from = "$join_table_alias.who";
+    }
+
+    my $table = "user_group_map_$chart_id";
+    my $join = {
+        table => 'user_group_map',
+        as    => $table,
+        from  => $from,
+        to    => 'user_id',
+        extra => [$dbh->sql_in("$table.group_id", $group_ids),
+                  "$table.isbless = 0"],
+    };
+    push(@$joins, $join);
+    if ($operator =~ /^not/) {
+        $args->{term} = "$table.group_id IS NULL";
+    }
+    else {
+        $args->{term} = "$table.group_id IS NOT NULL";
+    }
+}
+
+sub _get_user_id {
+    my ($self, $value) = @_;
+
+    if ($value =~ /^%\w+%$/) {
+        return pronoun($value, $self->_user);
+    }
+    return login_to_id($value, THROW_ERROR);
+}
+
+#####################################################################
+# Search Functions
+#####################################################################
+
+sub _invalid_combination {
+    my ($self, $args) = @_;
+    my ($field, $operator) = @$args{qw(field operator)};
+    ThrowUserError('search_field_operator_invalid',
+                   { field => $field, operator => $operator });
+}
+
+# For all the "user" fields--assigned_to, reporter, qa_contact,
+# cc, commenter, requestee, etc.
+sub _user_nonchanged {
+    my ($self, $args) = @_;
+    my ($field, $operator, $chart_id, $sequence, $joins) =
+        @$args{qw(field operator chart_id sequence joins)};
+
+    my $is_in_other_table;
+    if (my $join = USER_FIELDS->{$field}->{join}) {
+        $is_in_other_table = 1;
+        my $as = "${field}_$chart_id";
+        # Needed for setters.login_name and requestees.login_name.
+        # Otherwise when we try to join "profiles" below, we'd get
+        # something like "setters.login_name.login_name" in the "from".
+        $as =~ s/\./_/g;        
+        # This helps implement the email1, email2, etc. parameters.
+        if ($chart_id =~ /default/) {
+            $as .= "_$sequence";
+        }
+        my $isprivate = USER_FIELDS->{$field}->{isprivate};
+        my $extra = ($isprivate and !$self->_user->is_insider)
+                    ? ["$as.isprivate = 0"] : [];
+        # We want to copy $join so as not to modify USER_FIELDS.
+        push(@$joins, { %$join, as => $as, extra => $extra });
+        my $search_field = USER_FIELDS->{$field}->{field};
+        $args->{full_field} = "$as.$search_field";
+    }
+
+    my $is_nullable = USER_FIELDS->{$field}->{nullable};
+    my $null_alternate = "''";
+    # When using a pronoun, we use the userid, and we don't have to
+    # join the profiles table.
+    if ($args->{value_is_id}) {
+        $null_alternate = 0;
+    }
+    else {
+        my $as = "name_${field}_$chart_id";
+        # For fields with periods in their name.
+        $as =~ s/\./_/;
+        my $join = {
+            table => 'profiles',
+            as    => $as,
+            from  => $args->{full_field},
+            to    => 'userid',
+            join  => (!$is_in_other_table and !$is_nullable) ? 'INNER' : undef,
+        };
+        push(@$joins, $join);
+        $args->{full_field} = "$as.login_name";
+    }
+    
+    # We COALESCE fields that can be NULL, to make "not"-style operators
+    # continue to work properly. For example, "qa_contact is not equal to bob"
+    # should also show bugs where the qa_contact is NULL. With COALESCE,
+    # it does.
+    if ($is_nullable) {
+        $args->{full_field} = "COALESCE($args->{full_field}, $null_alternate)";
+    }
+    
+    # For fields whose values are stored in other tables, negation (NOT)
+    # only works properly if we put the condition into the JOIN instead
+    # of the WHERE.
+    if ($is_in_other_table) {
+        # Using the last join works properly whether we're searching based
+        # on userid or login_name.
+        my $last_join = $joins->[-1];
+        
+        # For negative operators, the system we're using here
+        # only works properly if we reverse the operator and check IS NULL
+        # in the WHERE.
+        my $is_negative = $operator =~ /^no/ ? 1 : 0;
+        if ($is_negative) {
+            $args->{operator} = $self->_reverse_operator($operator);
+        }
+        $self->_do_operator_function($args);
+        push(@{ $last_join->{extra} }, $args->{term});
+        
+        # For login_name searches, we only want a single join.
+        # So we create a subselect table out of our two joins. This makes
+        # negation (NOT) work properly for values that are in other
+        # tables.
+        if ($last_join->{table} eq 'profiles') {
+            pop @$joins;
+            $last_join->{join} = 'INNER';
+            my ($join_sql) = $self->_translate_join($last_join);
+            my $first_join = $joins->[-1];
+            my $as = $first_join->{as};            
+            my $table = $first_join->{table};
+            my $columns = "bug_id";
+            $columns .= ",isprivate" if @{ $first_join->{extra} };
+            my $new_table = "SELECT DISTINCT $columns FROM $table AS $as $join_sql";
+            $first_join->{table} = "($new_table)";
+            # We always want to LEFT JOIN the generated table.
+            delete $first_join->{join};
+            # To support OR charts, we need multiple tables.
+            my $new_as = $first_join->{as} . "_$sequence";
+            $_ =~ s/\Q$as\E/$new_as/ foreach @{ $first_join->{extra} };
+            $first_join->{as} = $new_as;
+            $last_join = $first_join;
+        }
+        
+        # If we're joining the first table (we're using a pronoun and
+        # searching by user id) then we need to check $other_table->{field}.
+        my $check_field = $last_join->{as} . '.bug_id';
+        if ($is_negative) {
+            $args->{term} = "$check_field IS NULL";
+        }
+        else {
+            $args->{term} = "$check_field IS NOT NULL";
+        }
+    }
+}
+
+# XXX This duplicates having Commenter as a search field.
+sub _long_desc_changedby {
+    my ($self, $args) = @_;
+    my ($chart_id, $joins, $value) = @$args{qw(chart_id joins value)};
+    
+    my $table = "longdescs_$chart_id";
+    push(@$joins, { table => 'longdescs', as => $table });
+    my $user_id = $self->_get_user_id($value);
+    $args->{term} = "$table.who = $user_id";
+}
+
+sub _long_desc_changedbefore_after {
+    my ($self, $args) = @_;
+    my ($chart_id, $operator, $value, $joins) =
+        @$args{qw(chart_id operator value joins)};
+    my $dbh = Bugzilla->dbh;
+    
+    my $sql_operator = ($operator =~ /before/) ? '<=' : '>=';
+    my $table = "longdescs_$chart_id";
+    my $sql_date = $dbh->quote(SqlifyDate($value));
+    my $join = {
+        table => 'longdescs',
+        as    => $table,
+        extra => ["$table.bug_when $sql_operator $sql_date"],
+    };
+    push(@$joins, $join);
+    $args->{term} = "$table.bug_when IS NOT NULL";
+
+    # If the user is not part of the insiders group, they cannot see
+    # private comments
+    if (!$self->_user->is_insider) {
+        $args->{term} .= " AND $table.isprivate = 0";
+    }
+}
+
+sub _long_desc_nonchanged {
+    my ($self, $args) = @_;
+    my ($chart_id, $operator, $value, $joins, $bugs_table) =
+        @$args{qw(chart_id operator value joins bugs_table)};
+    my $dbh = Bugzilla->dbh;
+
+    my $table = "longdescs_$chart_id";
+    my $join_args = {
+        chart_id   => $chart_id,
+        sequence   => $chart_id,
+        field      => 'longdesc',
+        full_field => "$table.thetext",
+        operator   => $operator,
+        value      => $value,
+        all_values => $value,
+        quoted     => $dbh->quote($value),
+        joins      => [],
+        bugs_table => $bugs_table,
+    };
+    $self->_do_operator_function($join_args);
+
+    # If the user is not part of the insiders group, they cannot see
+    # private comments
+    if (!$self->_user->is_insider) {
+        $join_args->{term} .= " AND $table.isprivate = 0";
+    }
+
+    my $join = {
+        table => 'longdescs',
+        as    => $table,
+        extra => [ $join_args->{term} ],
+    };
+    push(@$joins, $join);
+
+    $args->{term} =  "$table.comment_id IS NOT NULL";
+}
+
+sub _content_matches {
+    my ($self, $args) = @_;
+    my ($chart_id, $joins, $fields, $operator, $value) =
+        @$args{qw(chart_id joins fields operator value)};
+    my $dbh = Bugzilla->dbh;
+
+    # "content" is an alias for columns containing text for which we
+    # can search a full-text index and retrieve results by relevance,
+    # currently just bug comments (and summaries to some degree).
+    # There's only one way to search a full-text index, so we only
+    # accept the "matches" operator, which is specific to full-text
+    # index searches.
+
+    # Add the fulltext table to the query so we can search on it.
+    my $table = "bugs_fulltext_$chart_id";
+    my $comments_col = "comments";
+    $comments_col = "comments_noprivate" unless $self->_user->is_insider;
+    push(@$joins, { table => 'bugs_fulltext', as => $table });
+    
+    # Create search terms to add to the SELECT and WHERE clauses.
+    my ($term1, $rterm1) =
+        $dbh->sql_fulltext_search("$table.$comments_col", $value);
+    my ($term2, $rterm2) =
+        $dbh->sql_fulltext_search("$table.short_desc", $value);
+    $rterm1 = $term1 if !$rterm1;
+    $rterm2 = $term2 if !$rterm2;
+
+    # The term to use in the WHERE clause.
+    my $term = "$term1 OR $term2";
+    if ($operator =~ /not/i) {
+        $term = "NOT($term)";
+    }
+    $args->{term} = $term;
+    
+    # In order to sort by relevance (in case the user requests it),
+    # we SELECT the relevance value so we can add it to the ORDER BY
+    # clause. Every time a new fulltext chart isadded, this adds more 
+    # terms to the relevance sql.
+    #
+    # We build the relevance SQL by modifying the COLUMNS list directly,
+    # which is kind of a hack but works.
+    my $current = $self->COLUMNS->{'relevance'}->{name};
+    $current = $current ? "$current + " : '';
+    # For NOT searches, we just add 0 to the relevance.
+    my $select_term = $operator =~ /not/ ? 0 : "($current$rterm1 + $rterm2)";
+    $self->COLUMNS->{'relevance'}->{name} = $select_term;
+}
+
+sub _long_descs_count {
+    my ($self, $args) = @_;
+    my ($chart_id, $joins) = @$args{qw(chart_id joins)};
+    my $table = "longdescs_count_$chart_id";
+    my $extra =  $self->_user->is_insider ? "" : "WHERE isprivate = 0";
+    my $join = {
+        table => "(SELECT bug_id, COUNT(*) AS num"
+                 . " FROM longdescs $extra GROUP BY bug_id)",
+        as    => $table,
+    };
+    push(@$joins, $join);
+    $args->{full_field} = "${table}.num";
+}
+
+sub _work_time_changedby {
+    my ($self, $args) = @_;
+    my ($chart_id, $joins, $value) = @$args{qw(chart_id joins value)};
+    
+    my $table = "longdescs_$chart_id";
+    push(@$joins, { table => 'longdescs', as => $table });
+    my $user_id = $self->_get_user_id($value);
+    $args->{term} = "$table.who = $user_id AND $table.work_time != 0";
+}
+
+sub _work_time_changedbefore_after {
+    my ($self, $args) = @_;
+    my ($chart_id, $operator, $value, $joins) =
+        @$args{qw(chart_id operator value joins)};
+    my $dbh = Bugzilla->dbh;
+    
+    my $table = "longdescs_$chart_id";
+    my $sql_operator = ($operator =~ /before/) ? '<=' : '>=';
+    my $sql_date = $dbh->quote(SqlifyDate($value));
+    my $join = {
+        table => 'longdescs',
+        as    => $table,
+        extra => ["$table.work_time != 0",
+                  "$table.bug_when $sql_operator $sql_date"],
+    };
+    push(@$joins, $join);
+    
+    $args->{term} = "$table.bug_when IS NOT NULL";
+}
+
+sub _work_time {
+    my ($self, $args) = @_;
+    $self->_add_extra_column('actual_time');
+    $args->{full_field} = $self->COLUMNS->{actual_time}->{name};
+}
+
+sub _percentage_complete {
+    my ($self, $args) = @_;
+    
+    $args->{full_field} = $self->COLUMNS->{percentage_complete}->{name};
+
+    # We need actual_time in _select_columns, otherwise we can't use
+    # it in the expression for searching percentage_complete.
+    $self->_add_extra_column('actual_time');
+}
+
+sub _days_elapsed {
+    my ($self, $args) = @_;
+    my $dbh = Bugzilla->dbh;
+    
+    $args->{full_field} = "(" . $dbh->sql_to_days('NOW()') . " - " .
+                                $dbh->sql_to_days('bugs.delta_ts') . ")";
+}
+
+sub _component_nonchanged {
+    my ($self, $args) = @_;
+    
+    $args->{full_field} = "components.name";
+    $self->_do_operator_function($args);
+    my $term = $args->{term};
+    $args->{term} = build_subselect("bugs.component_id",
+        "components.id", "components", $args->{term});
+}
+
+sub _product_nonchanged {
+    my ($self, $args) = @_;
+    
+    # Generate the restriction condition
+    $args->{full_field} = "products.name";
+    $self->_do_operator_function($args);
+    my $term = $args->{term};
+    $args->{term} = build_subselect("bugs.product_id",
+        "products.id", "products", $term);
+}
+
+sub _classification_nonchanged {
+    my ($self, $args) = @_;
+    my $joins = $args->{joins};
+    
+    # This joins the right tables for us.
+    $self->_add_extra_column('product');
+    
+    # Generate the restriction condition    
+    $args->{full_field} = "classifications.name";
+    $self->_do_operator_function($args);
+    my $term = $args->{term};
+    $args->{term} = build_subselect("map_product.classification_id",
+        "classifications.id", "classifications", $term);
+}
+
+sub _nullable {
+    my ($self, $args) = @_;
+    my $field = $args->{full_field};
+    $args->{full_field} = "COALESCE($field, '')";
+}
+
+sub _nullable_int {
+    my ($self, $args) = @_;
+    my $field = $args->{full_field};
+    $args->{full_field} = "COALESCE($field, 0)";
+}
+
+sub _nullable_datetime {
+    my ($self, $args) = @_;
+    my $field = $args->{full_field};
+    my $empty = Bugzilla->dbh->quote(EMPTY_DATETIME);
+    $args->{full_field} = "COALESCE($field, $empty)";
+}
+
+sub _deadline {
+    my ($self, $args) = @_;
+    my $field = $args->{full_field};
+    # This makes "equals" searches work on all DBs (even on MySQL, which
+    # has a bug: http://bugs.mysql.com/bug.php?id=60324).
+    $args->{full_field} = Bugzilla->dbh->sql_date_format($field, '%Y-%m-%d');
+    $self->_nullable_datetime($args);
+}
+
+sub _owner_idle_time_greater_less {
+    my ($self, $args) = @_;
+    my ($chart_id, $joins, $value, $operator) =
+        @$args{qw(chart_id joins value operator)};
+    my $dbh = Bugzilla->dbh;
+    
+    my $table = "idle_$chart_id";
+    my $quoted = $dbh->quote(SqlifyDate($value));
+    
+    my $ld_table = "comment_$table";
+    my $act_table = "activity_$table";    
+    my $comments_join = {
+        table => 'longdescs',
+        as    => $ld_table,
+        from  => 'assigned_to',
+        to    => 'who',
+        extra => ["$ld_table.bug_when > $quoted"],
+    };
+    my $activity_join = {
+        table => 'bugs_activity',
+        as    => $act_table,
+        from  => 'assigned_to',
+        to    => 'who',
+        extra => ["$act_table.bug_when > $quoted"]
+    };
+    
+    push(@$joins, $comments_join, $activity_join);
+    
+    if ($operator =~ /greater/) {
+        $args->{term} =
+            "$ld_table.who IS NULL AND $act_table.who IS NULL";
+    } else {
+         $args->{term} =
+            "$ld_table.who IS NOT NULL OR $act_table.who IS NOT NULL";
+    }
+}
+
+sub _multiselect_negative {
+    my ($self, $args) = @_;
+    my ($field, $operator) = @$args{qw(field operator)};
+
+    $args->{operator} = $self->_reverse_operator($operator);
+    $args->{term} = $self->_multiselect_term($args, 1);
+}
+
+sub _multiselect_multiple {
+    my ($self, $args) = @_;
+    my ($chart_id, $field, $operator, $value)
+        = @$args{qw(chart_id field operator value)};
+    my $dbh = Bugzilla->dbh;
+    
+    # We want things like "cf_multi_select=two+words" to still be
+    # considered a search for two separate words, unless we're using
+    # anyexact. (_all_values would consider that to be one "word" with a
+    # space in it, because it's not in the Boolean Charts).
+    my @words = $operator eq 'anyexact' ? $self->_all_values($args)
+                                        : split(/[\s,]+/, $value);
+    
+    my @terms;
+    foreach my $word (@words) {
+        next if $word eq '';
+        $args->{value} = $word;
+        $args->{quoted} = $dbh->quote($word);
+        push(@terms, $self->_multiselect_term($args));
+    }
+    
+    # The spacing in the joins helps make the resulting SQL more readable.
+    if ($operator =~ /^any/) {
+        $args->{term} = join("\n        OR ", @terms);
+    }
+    else {
+        $args->{term} = join("\n        AND ", @terms);
+    }
+}
+
+sub _flagtypes_nonchanged {
+    my ($self, $args) = @_;
+    my ($chart_id, $operator, $value, $joins, $bugs_table, $condition) =
+        @$args{qw(chart_id operator value joins bugs_table condition)};
+    my $dbh = Bugzilla->dbh;
+
+    # For 'not' operators, we need to negate the whole term.
+    # If you search for "Flags" (does not contain) "approval+" we actually want
+    # to return *bugs* that don't contain an approval+ flag.  Without rewriting
+    # the negation we'll search for *flags* which don't contain approval+.
+    if ($operator =~ s/^not//) {
+        $args->{operator} = $operator;
+        $condition->operator($operator);
+        $condition->negate(1);
+    }
+
+    my $subselect_args = {
+        chart_id   => $chart_id,
+        sequence   => $chart_id,
+        field      => 'flagtypes.name',
+        full_field =>  $dbh->sql_string_concat("flagtypes_$chart_id.name", "flags_$chart_id.status"),
+        operator   => $operator,
+        value      => $value,
+        all_values => $value,
+        quoted     => $dbh->quote($value),
+        joins      => [],
+        bugs_table => "bugs_$chart_id",
+    };
+    $self->_do_operator_function($subselect_args);
+    my $subselect_term = $subselect_args->{term};
+
+    # don't call build_subselect as this must run as a true sub-select
+    $args->{term} = "EXISTS (
+        SELECT 1
+          FROM $bugs_table bugs_$chart_id
+          LEFT JOIN attachments AS attachments_$chart_id
+                    ON bugs_$chart_id.bug_id = attachments_$chart_id.bug_id
+          LEFT JOIN flags AS flags_$chart_id
+                    ON bugs_$chart_id.bug_id = flags_$chart_id.bug_id
+                       AND (flags_$chart_id.attach_id = attachments_$chart_id.attach_id
+                            OR flags_$chart_id.attach_id IS NULL)
+          LEFT JOIN flagtypes AS flagtypes_$chart_id
+                    ON flags_$chart_id.type_id = flagtypes_$chart_id.id
+     WHERE bugs_$chart_id.bug_id = $bugs_table.bug_id
+           AND $subselect_term
+    )";
+}
+
+sub _multiselect_nonchanged {
+    my ($self, $args) = @_;
+    my ($chart_id, $joins, $field, $operator) =
+        @$args{qw(chart_id joins field operator)};
+    $args->{term} = $self->_multiselect_term($args)
+}
+
+sub _multiselect_table {
+    my ($self, $args) = @_;
+    my ($field, $chart_id) = @$args{qw(field chart_id)};
+    my $dbh = Bugzilla->dbh;
+    
+    if ($field eq 'keywords') {
+        $args->{full_field} = 'keyworddefs.name';
+        return "keywords INNER JOIN keyworddefs".
+                               " ON keywords.keywordid = keyworddefs.id";
+    }
+    elsif ($field eq 'tag') {
+        $args->{full_field} = 'tag.name';
+        return "bug_tag INNER JOIN tag ON bug_tag.tag_id = tag.id AND user_id = "
+               . ($self->_sharer_id || $self->_user->id);
+    }
+    elsif ($field eq 'bug_group') {
+        $args->{full_field} = 'groups.name';
+        return "bug_group_map INNER JOIN groups
+                                      ON bug_group_map.group_id = groups.id";
+    }
+    elsif ($field eq 'blocked' or $field eq 'dependson') {
+        my $select = $field eq 'blocked' ? 'dependson' : 'blocked';
+        $args->{_select_field} = $select;
+        $args->{full_field} = $field;
+        return "dependencies";
+    }
+    elsif ($field eq 'longdesc') {
+        $args->{_extra_where} = " AND isprivate = 0"
+            if !$self->_user->is_insider;
+        $args->{full_field} = 'thetext';
+        return "longdescs";
+    }
+    elsif ($field eq 'longdescs.isprivate') {
+        ThrowUserError('auth_failure', { action => 'search',
+                                         object => 'bug_fields',
+                                         field => 'longdescs.isprivate' })
+            if !$self->_user->is_insider;
+        $args->{full_field} = 'isprivate';
+        return "longdescs";
+    }
+    elsif ($field =~ /^attachments/) {
+        $args->{_extra_where} = " AND isprivate = 0"
+            if !$self->_user->is_insider;
+        $field =~ /^attachments\.(.+)$/;
+        $args->{full_field} = $1;
+        return "attachments";
+    }
+    elsif ($field eq 'attach_data.thedata') {
+        $args->{_extra_where} = " AND attachments.isprivate = 0"
+            if !$self->_user->is_insider;
+        return "attachments INNER JOIN attach_data "
+               . " ON attachments.attach_id = attach_data.id"
+    }
+    elsif ($field eq 'flagtypes.name') {
+        $args->{full_field} = $dbh->sql_string_concat("flagtypes.name",
+                                                      "flags.status");
+        return "flags INNER JOIN flagtypes ON flags.type_id = flagtypes.id";
+    }
+    my $table = "bug_$field";
+    $args->{full_field} = "bug_$field.value";
+    return $table;
+}
+
+sub _multiselect_term {
+    my ($self, $args, $not) = @_;
+    my $table = $self->_multiselect_table($args);
+    $self->_do_operator_function($args);
+    my $term = $args->{term};
+    $term .= $args->{_extra_where} || '';
+    my $select = $args->{_select_field} || 'bug_id';
+    return build_subselect("$args->{bugs_table}.bug_id", $select, $table, $term, $not);
+}
+
+###############################
+# Standard Operator Functions #
+###############################
+
+sub _simple_operator {
+    my ($self, $args) = @_;
+    my ($full_field, $quoted, $operator) =
+        @$args{qw(full_field quoted operator)};
+    my $sql_operator = SIMPLE_OPERATORS->{$operator};
+    $args->{term} = "$full_field $sql_operator $quoted";
+}
+
+sub _casesubstring {
+    my ($self, $args) = @_;
+    my ($full_field, $quoted) = @$args{qw(full_field quoted)};
+    my $dbh = Bugzilla->dbh;
+    
+    $args->{term} = $dbh->sql_position($quoted, $full_field) . " > 0";
+}
+
+sub _substring {
+    my ($self, $args) = @_;
+    my ($full_field, $quoted) = @$args{qw(full_field quoted)};
+    my $dbh = Bugzilla->dbh;
+    
+    # XXX This should probably be changed to just use LIKE
+    $args->{term} = $dbh->sql_iposition($quoted, $full_field) . " > 0";
+}
+
+sub _notsubstring {
+    my ($self, $args) = @_;
+    my ($full_field, $quoted) = @$args{qw(full_field quoted)};
+    my $dbh = Bugzilla->dbh;
+    
+    # XXX This should probably be changed to just use NOT LIKE
+    $args->{term} = $dbh->sql_iposition($quoted, $full_field) . " = 0";
+}
+
+sub _regexp {
+    my ($self, $args) = @_;
+    my ($full_field, $quoted) = @$args{qw(full_field quoted)};
+    my $dbh = Bugzilla->dbh;
+    
+    $args->{term} = $dbh->sql_regexp($full_field, $quoted);
+}
+
+sub _notregexp {
+    my ($self, $args) = @_;
+    my ($full_field, $quoted) = @$args{qw(full_field quoted)};
+    my $dbh = Bugzilla->dbh;
+    
+    $args->{term} = $dbh->sql_not_regexp($full_field, $quoted);
+}
+
+sub _anyexact {
+    my ($self, $args) = @_;
+    my ($field, $full_field) = @$args{qw(field full_field)};
+    my $dbh = Bugzilla->dbh;
+    
+    my @list = $self->_all_values($args, ',');
+    @list = map { $self->_quote_unless_numeric($args, $_) } @list;
+    
+    if (@list) {
+        $args->{term} = $dbh->sql_in($full_field, \@list);
+    }
+    else {
+        $args->{term} = '';
+    }
+}
+
+sub _anywordsubstr {
+    my ($self, $args) = @_;
+
+    my @terms = $self->_substring_terms($args);
+    $args->{term} = join("\n\tOR ", @terms);
+}
+
+sub _allwordssubstr {
+    my ($self, $args) = @_;
+
+    my @terms = $self->_substring_terms($args);
+    $args->{term} = join("\n\tAND ", @terms);
+}
+
+sub _nowordssubstr {
+    my ($self, $args) = @_;
+    $self->_anywordsubstr($args);
+    my $term = $args->{term};
+    $args->{term} = "NOT($term)";
+}
+
+sub _anywords {
+    my ($self, $args) = @_;
+    
+    my @terms = $self->_word_terms($args);
+    # Because _word_terms uses AND, we need to parenthesize its terms
+    # if there are more than one.
+    @terms = map("($_)", @terms) if scalar(@terms) > 1;
+    $args->{term} = join("\n\tOR ", @terms);
+}
+
+sub _allwords {
+    my ($self, $args) = @_;
+    
+    my @terms = $self->_word_terms($args);
+    $args->{term} = join("\n\tAND ", @terms);
+}
+
+sub _nowords {
+    my ($self, $args) = @_;
+    $self->_anywords($args);
+    my $term = $args->{term};
+    $args->{term} = "NOT($term)";
+}
+
+sub _changedbefore_changedafter {
+    my ($self, $args) = @_;
+    my ($chart_id, $joins, $field, $operator, $value) =
+        @$args{qw(chart_id joins field operator value)};
+    my $dbh = Bugzilla->dbh;
+
+    my $field_object = $self->_chart_fields->{$field}
+        || ThrowCodeError("invalid_field_name", { field => $field });
+    
+    # Asking when creation_ts changed is just asking when the bug was created.
+    if ($field_object->name eq 'creation_ts') {
+        $args->{operator} =
+            $operator eq 'changedbefore' ? 'lessthaneq' : 'greaterthaneq';
+        return $self->_do_operator_function($args);
+    }
+    
+    my $sql_operator = ($operator =~ /before/) ? '<=' : '>=';
+    my $field_id = $field_object->id;
+    # Charts on changed* fields need to be field-specific. Otherwise,
+    # OR chart rows make no sense if they contain multiple fields.
+    my $table = "act_${field_id}_$chart_id";
+
+    my $sql_date = $dbh->quote(SqlifyDate($value));
+    my $join = {
+        table => 'bugs_activity',
+        as    => $table,
+        extra => ["$table.fieldid = $field_id",
+                  "$table.bug_when $sql_operator $sql_date"],
+    };
+
+    $args->{term} = "$table.bug_when IS NOT NULL";
+    $self->_changed_security_check($args, $join);
+    push(@$joins, $join);
+}
+
+sub _changedfrom_changedto {
+    my ($self, $args) = @_;
+    my ($chart_id, $joins, $field, $operator, $quoted) =
+        @$args{qw(chart_id joins field operator quoted)};
+    
+    my $column = ($operator =~ /from/) ? 'removed' : 'added';
+    my $field_object = $self->_chart_fields->{$field}
+        || ThrowCodeError("invalid_field_name", { field => $field });
+    my $field_id = $field_object->id;
+    my $table = "act_${field_id}_$chart_id";
+    my $join = {
+        table => 'bugs_activity',
+        as    => $table,
+        extra => ["$table.fieldid = $field_id",
+                  "$table.$column = $quoted"],
+    };
+
+    $args->{term} = "$table.bug_when IS NOT NULL";
+    $self->_changed_security_check($args, $join);
+    push(@$joins, $join);
+}
+
+sub _changedby {
+    my ($self, $args) = @_;
+    my ($chart_id, $joins, $field, $operator, $value) =
+        @$args{qw(chart_id joins field operator value)};
+    
+    my $field_object = $self->_chart_fields->{$field}
+        || ThrowCodeError("invalid_field_name", { field => $field });
+    my $field_id = $field_object->id;
+    my $table = "act_${field_id}_$chart_id";
+    my $user_id  = $self->_get_user_id($value);
+    my $join = {
+        table => 'bugs_activity',
+        as    => $table,
+        extra => ["$table.fieldid = $field_id",
+                  "$table.who = $user_id"],
+    };
+
+    $args->{term} = "$table.bug_when IS NOT NULL";
+    $self->_changed_security_check($args, $join);
+    push(@$joins, $join);
+}
+
+sub _changed_security_check {
+    my ($self, $args, $join) = @_;
+    my ($chart_id, $field) = @$args{qw(chart_id field)};
+
+    my $field_object = $self->_chart_fields->{$field}
+        || ThrowCodeError("invalid_field_name", { field => $field });
+    my $field_id = $field_object->id;
+
+    # If the user is not part of the insiders group, they cannot see
+    # changes to attachments (including attachment flags) that are private
+    if ($field =~ /^(?:flagtypes\.name$|attach)/ and !$self->_user->is_insider) {
+        $join->{then_to} = {
+            as    => "attach_${field_id}_$chart_id",
+            table => 'attachments',
+            from  => "act_${field_id}_$chart_id.attach_id",
+            to    => 'attach_id',
+        };
+
+        $args->{term} .= " AND COALESCE(attach_${field_id}_$chart_id.isprivate, 0) = 0";
+    }
+}
+
+######################
+# Public Subroutines #
+######################
+
+# Validate that the query type is one we can deal with
+sub IsValidQueryType
+{
+    my ($queryType) = @_;
+    if (grep { $_ eq $queryType } qw(specific advanced)) {
+        return 1;
+    }
+    return 0;
+}
+
+# Splits out "asc|desc" from a sort order item.
+sub split_order_term {
+    my $fragment = shift;
+    $fragment =~ /^(.+?)(?:\s+(ASC|DESC))?$/i;
+    my ($column_name, $direction) = (lc($1), uc($2 || ''));
+    return wantarray ? ($column_name, $direction) : $column_name;
+}
+
+# Used to translate old SQL fragments from buglist.cgi's "order" argument
+# into our modern field IDs.
+sub _translate_old_column {
+    my ($self, $column) = @_;
+    # All old SQL fragments have a period in them somewhere.
+    return $column if $column !~ /\./;
+
+    if ($column =~ /\bAS\s+(\w+)$/i) {
+        return $1;
+    }
+    # product, component, classification, assigned_to, qa_contact, reporter
+    elsif ($column =~ /map_(\w+?)s?\.(login_)?name/i) {
+        return $1;
+    }
+    
+    # If it doesn't match the regexps above, check to see if the old 
+    # SQL fragment matches the SQL of an existing column
+    foreach my $key (%{ $self->COLUMNS }) {
+        next unless exists $self->COLUMNS->{$key}->{name};
+        return $key if $self->COLUMNS->{$key}->{name} eq $column;
+    }
+
+    return $column;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Search - Provides methods to run queries against bugs.
+
+=head1 SYNOPSIS
+
+    use Bugzilla::Search;
+
+    my $search = new Bugzilla::Search({'fields' => \@fields,
+                                       'params' => \%search_criteria,
+                                       'sharer' => $sharer_id,
+                                       'user'   => $user_obj,
+                                       'allow_unlimited' => 1});
+
+    my $data = $search->data;
+    my ($data, $extra_data) = $search->data;
+
+=head1 DESCRIPTION
+
+Search.pm represents a search object. It's the single way to collect
+data about bugs in a secure way. The list of bugs matching criteria
+defined by the caller are filtered based on the user privileges.
+
+=head1 METHODS
+
+=head2 new
+
+=over
+
+=item B<Description>
+
+Create a Bugzilla::Search object.
+
+=item B<Params>
+
+=over
+
+=item C<fields>
+
+An arrayref representing the bug attributes for which data is desired.
+Legal attributes are listed in the fielddefs DB table. At least one field
+must be defined, typically the 'bug_id' field.
+
+=item C<params>
+
+A hashref representing search criteria. Each key => value pair represents
+a search criteria, where the key is the search field and the value is the
+value for this field. At least one search criteria must be defined if the
+'search_allow_no_criteria' parameter is turned off, else an error is thrown.
+
+=item C<sharer>
+
+When a saved search is shared by a user, this is his user ID.
+
+=item C<user>
+
+A L<Bugzilla::User> object representing the user to whom the data is addressed.
+All security checks are done based on this user object, so it's not safe
+to share results of the query with other users as not all users have the
+same privileges or have the same role for all bugs in the list. If this
+parameter is not defined, then the currently logged in user is taken into
+account. If no user is logged in, then only public bugs will be returned.
+
+=item C<allow_unlimited>
+
+If set to a true value, the number of bugs retrieved by the query is not
+limited.
+
+=back
+
+=item B<Returns>
+
+A L<Bugzilla::Search> object.
+
+=back
+
+=head2 data
+
+=over
+
+=item B<Description>
+
+Returns bugs matching search criteria passed to C<new()>.
+
+=item B<Params>
+
+None
+
+=item B<Returns>
+
+In scalar context, this method returns a reference to a list of bugs.
+Each item of the list represents a bug, which is itself a reference to
+a list where each item represents a bug attribute, in the same order as
+specified in the C<fields> parameter of C<new()>.
+
+In list context, this methods also returns a reference to a list containing
+references to hashes. For each hash, two keys are defined: C<sql> contains
+the SQL query which has been executed, and C<time> contains the time spent
+to execute the SQL query, in seconds. There can be either a single hash, or
+two hashes if two SQL queries have been executed sequentially to get all the
+required data.
+
+=back

diff --git a/Bugzilla/Search/Clause.pm b/Bugzilla/Search/Clause.pm
new file mode 100644 (file)
index 0000000..6214ab1
--- /dev/null
+++ b/Bugzilla/Search/Clause.pm
@@ -0,0 +1,133 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Search::Clause;
+use strict;
+
+use Bugzilla::Error;
+use Bugzilla::Search::Condition qw(condition);
+use Bugzilla::Util qw(trick_taint);
+
+sub new {
+    my ($class, $joiner) = @_;
+    if ($joiner and $joiner ne 'OR' and $joiner ne 'AND') {
+        ThrowCodeError('search_invalid_joiner', { joiner => $joiner });
+    }
+    # This will go into SQL directly so needs to be untainted.
+    trick_taint($joiner) if $joiner;
+    bless { joiner => $joiner || 'AND' }, $class;
+}
+
+sub children {
+    my ($self) = @_;
+    $self->{children} ||= [];
+    return $self->{children};
+}
+
+sub update_search_args {
+    my ($self, $search_args) = @_;
+    # abstract
+}
+
+sub joiner { return $_[0]->{joiner} }
+
+sub has_translated_conditions {
+    my ($self) = @_;
+    my $children = $self->children;
+    return 1 if grep { $_->isa('Bugzilla::Search::Condition')
+                       && $_->translated } @$children;
+    foreach my $child (@$children) {
+        next if $child->isa('Bugzilla::Search::Condition');
+        return 1 if $child->has_translated_conditions;
+    }
+    return 0;
+}
+
+sub add {
+    my $self = shift;
+    my $children = $self->children;
+    if (@_ == 3) {
+        push(@$children, condition(@_));
+        return;
+    }
+    
+    my ($child) = @_;
+    return if !defined $child;
+    $child->isa(__PACKAGE__) || $child->isa('Bugzilla::Search::Condition')
+        || die 'child not the right type: ' . $child;
+    push(@{ $self->children }, $child);
+}
+
+sub negate {
+    my ($self, $value) = @_;
+    if (@_ == 2) {
+        $self->{negate} = $value ? 1 : 0;
+    }
+    return $self->{negate};
+}
+
+sub walk_conditions {
+    my ($self, $callback) = @_;
+    foreach my $child (@{ $self->children }) {
+        if ($child->isa('Bugzilla::Search::Condition')) {
+            $callback->($self, $child);
+        }
+        else {
+            $child->walk_conditions($callback);
+        }
+    }
+}
+
+sub as_string {
+    my ($self) = @_;
+    if (!$self->{sql}) {
+        my @strings;
+        foreach my $child (@{ $self->children }) {
+            next if $child->isa(__PACKAGE__) && !$child->has_translated_conditions;
+            next if $child->isa('Bugzilla::Search::Condition')
+                    && !$child->translated;
+
+            my $string = $child->as_string;
+            next unless $string;
+            if ($self->joiner eq 'AND') {
+                $string = "( $string )" if $string =~ /OR/;
+            }
+            else {
+                $string = "( $string )" if $string =~ /AND/;
+            }
+            push(@strings, $string);
+        }
+
+        my $sql = join(' ' . $self->joiner . ' ', @strings);
+        $sql = "NOT( $sql )" if $sql && $self->negate;
+        $self->{sql} = $sql;
+    }
+    return $self->{sql};
+}
+
+# Search.pm converts URL parameters to Clause objects. This helps do the
+# reverse.
+sub as_params {
+    my ($self) = @_;
+    my @params;
+    foreach my $child (@{ $self->children }) {
+        if ($child->isa(__PACKAGE__)) {
+            my %open_paren = (f => 'OP', n => scalar $child->negate,
+                              j => $child->joiner);
+            push(@params, \%open_paren);
+            push(@params, $child->as_params);
+            my %close_paren =  (f => 'CP');
+            push(@params, \%close_paren);
+        }
+        else {
+            push(@params, $child->as_params);
+        }
+    }
+    return @params;
+}
+
+1;

diff --git a/Bugzilla/Search/ClauseGroup.pm b/Bugzilla/Search/ClauseGroup.pm
new file mode 100644 (file)
index 0000000..5b437af
--- /dev/null
+++ b/Bugzilla/Search/ClauseGroup.pm
@@ -0,0 +1,96 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Search::ClauseGroup;
+
+use strict;
+
+use base qw(Bugzilla::Search::Clause);
+
+use Bugzilla::Error;
+use Bugzilla::Search::Condition qw(condition);
+use Bugzilla::Util qw(trick_taint);
+use List::MoreUtils qw(uniq);
+
+use constant UNSUPPORTED_FIELDS => qw(
+    attach_data.thedata
+    classification
+    commenter
+    component
+    longdescs.count
+    product
+    owner_idle_time
+);
+
+sub new {
+    my ($class) = @_;
+    my $self = bless({ joiner => 'AND' }, $class);
+    # Add a join back to the bugs table which will be used to group conditions
+    # for this clause
+    my $condition = Bugzilla::Search::Condition->new({});
+    $condition->translated({
+        joins => [{
+            table => 'bugs',
+            as    => 'bugs_g0',
+            from  => 'bug_id',
+            to    => 'bug_id',
+            extra => [],
+        }],
+        term => '1 = 1',
+    });
+    $self->SUPER::add($condition);
+    $self->{group_condition} = $condition;
+    return $self;
+}
+
+sub add {
+    my ($self, @args) = @_;
+    my $field = scalar(@args) == 3 ? $args[0] : $args[0]->{field};
+
+    # We don't support nesting of conditions under this clause
+    if (scalar(@args) == 1 && !$args[0]->isa('Bugzilla::Search::Condition')) {
+        ThrowUserError('search_grouped_invalid_nesting');
+    }
+
+    # Ensure all conditions use the same field
+    if (!$self->{_field}) {
+        $self->{_field} = $field;
+    } elsif ($field ne $self->{_field}) {
+        ThrowUserError('search_grouped_field_mismatch');
+    }
+
+    # Unsupported fields
+    if (grep { $_ eq $field } UNSUPPORTED_FIELDS ) {
+        ThrowUserError('search_grouped_field_invalid', { field => $field });
+    }
+
+    $self->SUPER::add(@args);
+}
+
+sub update_search_args {
+    my ($self, $search_args) = @_;
+
+    # No need to change things if there's only one child condition
+    return unless scalar(@{ $self->children }) > 1;
+
+    # we want all the terms to use the same join table
+    if (!exists $self->{_first_chart_id}) {
+        $self->{_first_chart_id} = $search_args->{chart_id};
+    } else {
+        $search_args->{chart_id} = $self->{_first_chart_id};
+    }
+
+    my $suffix = '_g' . $self->{_first_chart_id};
+    $self->{group_condition}->{translated}->{joins}->[0]->{as} = "bugs$suffix";
+
+    $search_args->{full_field} =~ s/^bugs\./bugs$suffix\./;
+
+    $search_args->{table_suffix} = $suffix;
+    $search_args->{bugs_table} = "bugs$suffix";
+}
+
+1;

diff --git a/Bugzilla/Search/Condition.pm b/Bugzilla/Search/Condition.pm
new file mode 100644 (file)
index 0000000..fb899af
--- /dev/null
+++ b/Bugzilla/Search/Condition.pm
@@ -0,0 +1,75 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Search::Condition;
+use strict;
+use base qw(Exporter);
+our @EXPORT_OK = qw(condition);
+
+sub new {
+    my ($class, $params) = @_;
+    my %self = %$params;
+    bless \%self, $class;
+    return \%self;
+}
+
+sub field    { return $_[0]->{field}    }
+sub value    { return $_[0]->{value}    }
+
+sub operator {
+    my ($self, $value) = @_;
+    if (@_ == 2) {
+        $self->{operator} = $value;
+    }
+    return $self->{operator};
+}
+
+sub fov {
+    my ($self) = @_;
+    return ($self->field, $self->operator, $self->value);
+}
+
+sub translated {
+    my ($self, $params) = @_;
+    if (@_ == 2) {
+        $self->{translated} = $params;
+    }
+    return $self->{translated};
+}
+
+sub as_string {
+    my ($self) = @_;
+    my $term = $self->translated->{term};
+    $term = "NOT( $term )" if $term && $self->negate;
+    return $term;
+}
+
+sub as_params {
+    my ($self) = @_;
+    return { f => $self->field, o => $self->operator, v => $self->value,
+             n => scalar $self->negate };
+}
+
+sub negate {
+    my ($self, $value) = @_;
+    if (@_ == 2) {
+        $self->{negate} = $value ? 1 : 0;
+    }
+    return $self->{negate};
+}
+
+###########################
+# Convenience Subroutines #
+###########################
+
+sub condition {
+    my ($field, $operator, $value) = @_;
+    return __PACKAGE__->new({ field => $field, operator => $operator,
+                              value => $value });
+}
+
+1;

diff --git a/Bugzilla/Search/Quicksearch.pm b/Bugzilla/Search/Quicksearch.pm
new file mode 100644 (file)
index 0000000..e6d3d44
--- /dev/null
+++ b/Bugzilla/Search/Quicksearch.pm
@@ -0,0 +1,615 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Search::Quicksearch;
+
+# Make it harder for us to do dangerous things in Perl.
+use strict;
+
+use Bugzilla::Error;
+use Bugzilla::Constants;
+use Bugzilla::Keyword;
+use Bugzilla::Status;
+use Bugzilla::Field;
+use Bugzilla::Util;
+
+use List::Util qw(min max);
+use List::MoreUtils qw(firstidx);
+use Text::ParseWords qw(parse_line);
+
+use base qw(Exporter);
+@Bugzilla::Search::Quicksearch::EXPORT = qw(quicksearch);
+
+# Custom mappings for some fields.
+use constant MAPPINGS => {
+    # Status, Resolution, Platform, OS, Priority, Severity
+    "status"   => "bug_status",
+    "platform" => "rep_platform",
+    "os"       => "op_sys",
+    "severity" => "bug_severity",
+
+    # People: AssignedTo, Reporter, QA Contact, CC, etc.
+    "assignee" => "assigned_to",
+    "owner"    => "assigned_to",
+
+    # Product, Version, Component, Target Milestone
+    "milestone" => "target_milestone",
+
+    # Summary, Description, URL, Status whiteboard, Keywords
+    "summary"     => "short_desc",
+    "description" => "longdesc",
+    "comment"     => "longdesc",
+    "url"         => "bug_file_loc",
+    "whiteboard"  => "status_whiteboard",
+    "sw"          => "status_whiteboard",
+    "kw"          => "keywords",
+    "group"       => "bug_group",
+
+    # Flags
+    "flag"        => "flagtypes.name",
+    "requestee"   => "requestees.login_name",
+    "setter"      => "setters.login_name",
+
+    # Attachments
+    "attachment"     => "attachments.description",
+    "attachmentdesc" => "attachments.description",
+    "attachdesc"     => "attachments.description",
+    "attachmentdata" => "attach_data.thedata",
+    "attachdata"     => "attach_data.thedata",
+    "attachmentmimetype" => "attachments.mimetype",
+    "attachmimetype" => "attachments.mimetype"
+};
+
+sub FIELD_MAP {
+    my $cache = Bugzilla->request_cache;
+    return $cache->{quicksearch_fields} if $cache->{quicksearch_fields};
+
+    # Get all the fields whose names don't contain periods. (Fields that
+    # contain periods are always handled in MAPPINGS.) 
+    my @db_fields = grep { $_->name !~ /\./ } 
+                         @{ Bugzilla->fields({ obsolete => 0 }) };
+    my %full_map = (%{ MAPPINGS() }, map { $_->name => $_->name } @db_fields);
+
+    # Eliminate the fields that start with bug_ or rep_, because those are
+    # handled by the MAPPINGS instead, and we don't want too many names
+    # for them. (Also, otherwise "rep" doesn't match "reporter".)
+    #
+    # Remove "status_whiteboard" because we have "whiteboard" for it in
+    # the mappings, and otherwise "stat" can't match "status".
+    #
+    # Also, don't allow searching the _accessible stuff via quicksearch
+    # (both because it's unnecessary and because otherwise 
+    # "reporter_accessible" and "reporter" both match "rep".
+    delete @full_map{qw(rep_platform bug_status bug_file_loc bug_group
+                        bug_severity bug_status
+                        status_whiteboard
+                        cclist_accessible reporter_accessible)};
+
+    Bugzilla::Hook::process('quicksearch_map', {'map' => \%full_map} );
+
+    $cache->{quicksearch_fields} = \%full_map;
+
+    return $cache->{quicksearch_fields};
+}
+
+# Certain fields, when specified like "field:value" get an operator other
+# than "substring"
+use constant FIELD_OPERATOR => {
+    content         => 'matches',
+    owner_idle_time => 'greaterthan',
+};
+
+# We might want to put this into localconfig or somewhere
+use constant PRODUCT_EXCEPTIONS => (
+    'row',   # [Browser]
+             #   ^^^
+    'new',   # [MailNews]
+             #      ^^^
+);
+use constant COMPONENT_EXCEPTIONS => (
+    'hang'   # [Bugzilla: Component/Keyword Changes]
+             #                               ^^^^
+);
+
+# Quicksearch-wide globals for boolean charts.
+our ($chart, $and, $or, $fulltext, $bug_status_set);
+
+sub quicksearch {
+    my ($searchstring) = (@_);
+    my $cgi = Bugzilla->cgi;
+
+    $chart = 0;
+    $and   = 0;
+    $or    = 0;
+
+    # Remove leading and trailing commas and whitespace.
+    $searchstring =~ s/(^[\s,]+|[\s,]+$)//g;
+    ThrowUserError('buglist_parameters_required') unless ($searchstring);
+
+    if ($searchstring =~ m/^[0-9,\s]*$/) {
+        _bug_numbers_only($searchstring);
+    }
+    else {
+        _handle_alias($searchstring);
+
+        # Retain backslashes and quotes, to know which strings are quoted,
+        # and which ones are not.
+        my @words = parse_line('\s+', 1, $searchstring);
+        # If parse_line() returns no data, this means strings are badly quoted.
+        # Rather than trying to guess what the user wanted to do, we throw an error.
+        scalar(@words)
+          || ThrowUserError('quicksearch_unbalanced_quotes', {string => $searchstring});
+
+        # A query cannot start with AND or OR, nor can it end with AND, OR or NOT.
+        ThrowUserError('quicksearch_invalid_query')
+          if ($words[0] =~ /^(?:AND|OR)$/ || $words[$#words] =~ /^(?:AND|OR|NOT)$/);
+
+        my (@qswords, @or_group);
+        while (scalar @words) {
+            my $word = shift @words;
+            # AND is the default word separator, similar to a whitespace,
+            # but |a AND OR b| is not a valid combination.
+            if ($word eq 'AND') {
+                ThrowUserError('quicksearch_invalid_query', {operators => ['AND', 'OR']})
+                  if $words[0] eq 'OR';
+            }
+            # |a OR AND b| is not a valid combination.
+            # |a OR OR b| is equivalent to |a OR b| and so is harmless.
+            elsif ($word eq 'OR') {
+                ThrowUserError('quicksearch_invalid_query', {operators => ['OR', 'AND']})
+                  if $words[0] eq 'AND';
+            }
+            # NOT negates the following word.
+            # |NOT AND| and |NOT OR| are not valid combinations.
+            # |NOT NOT| is fine but has no effect as they cancel themselves.
+            elsif ($word eq 'NOT') {
+                $word = shift @words;
+                next if $word eq 'NOT';
+                if ($word eq 'AND' || $word eq 'OR') {
+                    ThrowUserError('quicksearch_invalid_query', {operators => ['NOT', $word]});
+                }
+                unshift(@words, "-$word");
+            }
+            else {
+                # OR groups words together, as OR has higher precedence than AND.
+                push(@or_group, $word);
+                # If the next word is not OR, then we are not in a OR group,
+                # or we are leaving it.
+                if (!defined $words[0] || $words[0] ne 'OR') {
+                    push(@qswords, join('|', @or_group));
+                    @or_group = ();
+                }
+            }
+        }
+
+        _handle_status_and_resolution($qswords[0]);
+        shift(@qswords) if $bug_status_set;
+
+        my (@unknownFields, %ambiguous_fields);
+        $fulltext = Bugzilla->user->setting('quicksearch_fulltext') eq 'on' ? 1 : 0;
+
+        # Loop over all main-level QuickSearch words.
+        foreach my $qsword (@qswords) {
+            my @or_operand = parse_line('\|', 1, $qsword);
+            foreach my $term (@or_operand) {
+                my $negate = substr($term, 0, 1) eq '-';
+                if ($negate) {
+                    $term = substr($term, 1);
+                }
+
+                next if _handle_special_first_chars($term, $negate);
+                next if _handle_field_names($term, $negate, \@unknownFields,
+                                            \%ambiguous_fields);
+
+                # Having ruled out the special cases, we may now split
+                # by comma, which is another legal boolean OR indicator.
+                # Remove quotes from quoted words, if any.
+                @words = parse_line(',', 0, $term);
+                foreach my $word (@words) {
+                    if (!_special_field_syntax($word, $negate)) {
+                        _default_quicksearch_word($word, $negate);
+                    }
+                    _handle_urls($word, $negate);
+                }
+            }
+            $chart++;
+            $and = 0;
+            $or = 0;
+        }
+
+        # If there is no mention of a bug status, we restrict the query
+        # to open bugs by default.
+        unless ($bug_status_set) {
+            $cgi->param('bug_status', BUG_STATE_OPEN);
+        }
+
+        # Inform user about any unknown fields
+        if (scalar(@unknownFields) || scalar(keys %ambiguous_fields)) {
+            ThrowUserError("quicksearch_unknown_field",
+                           { unknown   => \@unknownFields,
+                             ambiguous => \%ambiguous_fields });
+        }
+
+        # Make sure we have some query terms left
+        scalar($cgi->param())>0 || ThrowUserError("buglist_parameters_required");
+    }
+
+    # List of quicksearch-specific CGI parameters to get rid of.
+    my @params_to_strip = ('quicksearch', 'load', 'run');
+    my $modified_query_string = $cgi->canonicalise_query(@params_to_strip);
+
+    if ($cgi->param('load')) {
+        my $urlbase = correct_urlbase();
+        # Param 'load' asks us to display the query in the advanced search form.
+        print $cgi->redirect(-uri => "${urlbase}query.cgi?format=advanced&"
+                             . $modified_query_string);
+    }
+
+    # Otherwise, pass the modified query string to the caller.
+    # We modified $cgi->params, so the caller can choose to look at that, too,
+    # and disregard the return value.
+    $cgi->delete(@params_to_strip);
+    return $modified_query_string;
+}
+
+##########################
+# Parts of quicksearch() #
+##########################
+
+sub _bug_numbers_only {
+    my $searchstring = shift;
+    my $cgi = Bugzilla->cgi;
+    # Allow separation by comma or whitespace.
+    $searchstring =~ s/[,\s]+/,/g;
+
+    if ($searchstring !~ /,/) {
+        # Single bug number; shortcut to show_bug.cgi.
+        print $cgi->redirect(
+            -uri => correct_urlbase() . "show_bug.cgi?id=$searchstring");
+        exit;
+    }
+    else {
+        # List of bug numbers.
+        $cgi->param('bug_id', $searchstring);
+        $cgi->param('order', 'bugs.bug_id');
+        $cgi->param('bug_id_type', 'anyexact');
+    }
+}
+
+sub _handle_alias {
+    my $searchstring = shift;
+    if ($searchstring =~ /^([^,\s]+)$/) {
+        my $alias = $1;
+        # We use this direct SQL because we want quicksearch to be VERY fast.
+        my $bug_id = Bugzilla->dbh->selectrow_array(
+            q{SELECT bug_id FROM bugs WHERE alias = ?}, undef, $alias);
+        # If the user cannot see the bug, do not resolve its alias.
+        if ($bug_id && Bugzilla->user->can_see_bug($bug_id)) {
+            $alias = url_quote($alias);
+            print Bugzilla->cgi->redirect(
+                -uri => correct_urlbase() . "show_bug.cgi?id=$alias");
+            exit;
+        }
+    }
+}
+
+sub _handle_status_and_resolution {
+    my $word = shift;
+    my $legal_statuses = get_legal_field_values('bug_status');
+    my (%states, %resolutions);
+    $bug_status_set = 1;
+
+    if ($word eq 'OPEN') {
+        $states{$_} = 1 foreach BUG_STATE_OPEN;
+    }
+    # If we want all bugs, then there is nothing to do.
+    elsif ($word ne 'ALL'
+           && !matchPrefixes(\%states, \%resolutions, $word, $legal_statuses))
+    {
+        $bug_status_set = 0;
+    }
+
+    # If we have wanted resolutions, allow closed states
+    if (keys(%resolutions)) {
+        foreach my $status (@$legal_statuses) {
+            $states{$status} = 1 unless is_open_state($status);
+        }
+    }
+
+    Bugzilla->cgi->param('bug_status', keys(%states));
+    Bugzilla->cgi->param('resolution', keys(%resolutions));
+}
+
+
+sub _handle_special_first_chars {
+    my ($qsword, $negate) = @_;
+
+    my $firstChar = substr($qsword, 0, 1);
+    my $baseWord = substr($qsword, 1);
+    my @subWords = split(/,/, $baseWord);
+
+    if ($firstChar eq '#') {
+        addChart('short_desc', 'substring', $baseWord, $negate);
+        addChart('content', 'matches', _matches_phrase($baseWord), $negate) if $fulltext;
+        return 1;
+    }
+    if ($firstChar eq ':') {
+        foreach (@subWords) {
+            addChart('product', 'substring', $_, $negate);
+            addChart('component', 'substring', $_, $negate);
+        }
+        return 1;
+    }
+    if ($firstChar eq '@') {
+        addChart('assigned_to', 'substring', $_, $negate) foreach (@subWords);
+        return 1;
+    }
+    if ($firstChar eq '[') {
+        addChart('short_desc', 'substring', $baseWord, $negate);
+        addChart('status_whiteboard', 'substring', $baseWord, $negate);
+        return 1;
+    }
+    if ($firstChar eq '!') {
+        addChart('keywords', 'anywords', $baseWord, $negate);
+        return 1;
+    }
+    return 0;
+}
+
+sub _handle_field_names {
+    my ($or_operand, $negate, $unknownFields, $ambiguous_fields) = @_;
+
+    # Flag and requestee shortcut
+    if ($or_operand =~ /^(?:flag:)?([^\?]+\?)([^\?]*)$/) {
+        my ($flagtype, $requestee) = ($1, $2);
+        addChart('flagtypes.name', 'substring', $flagtype, $negate);
+        if ($requestee) {
+            # AND
+            $chart++;
+            $and = $or = 0;
+            addChart('requestees.login_name', 'substring', $requestee, $negate);
+        }
+        return 1;
+    }
+
+    # Generic field1,field2,field3:value1,value2 notation.
+    # We have to correctly ignore commas and colons in quotes.
+    my @field_values = parse_line(':', 1, $or_operand);
+    if (scalar @field_values == 2) {
+        my @fields = parse_line(',', 1, $field_values[0]);
+        my @values = parse_line(',', 1, $field_values[1]);
+        foreach my $field (@fields) {
+            my $translated = _translate_field_name($field);
+            # Skip and record any unknown fields
+            if (!defined $translated) {
+                push(@$unknownFields, $field);
+            }
+            # If we got back an array, that means the substring is
+            # ambiguous and could match more than field name
+            elsif (ref $translated) {
+                $ambiguous_fields->{$field} = $translated;
+            }
+            else {
+                if ($translated eq 'bug_status' || $translated eq 'resolution') {
+                    $bug_status_set = 1;
+                }
+                foreach my $value (@values) {
+                    my $operator = FIELD_OPERATOR->{$translated} || 'substring';
+                    # If the string was quoted to protect some special
+                    # characters such as commas and colons, we need
+                    # to remove quotes.
+                    if ($value =~ /^(["'])(.+)\1$/) {
+                        $value = $2;
+                        $value =~ s/\\(["'])/$1/g;
+                    }
+                    addChart($translated, $operator, $value, $negate);
+                }
+            }
+        }
+        return 1;
+    }
+    return 0;
+}
+
+sub _translate_field_name {
+    my $field = shift;
+    $field = lc($field);
+    my $field_map = FIELD_MAP;
+
+    # If the field exactly matches a mapping, just return right now.
+    return $field_map->{$field} if exists $field_map->{$field};
+
+    # Check if we match, as a starting substring, exactly one field.
+    my @field_names = keys %$field_map;
+    my @matches = grep { $_ =~ /^\Q$field\E/ } @field_names;
+    # Eliminate duplicates that are actually the same field
+    # (otherwise "assi" matches both "assignee" and "assigned_to", and
+    # the lines below fail when they shouldn't.)
+    my %match_unique = map { $field_map->{$_} => $_ } @matches;
+    @matches = values %match_unique;
+
+    if (scalar(@matches) == 1) {
+        return $field_map->{$matches[0]};
+    }
+    elsif (scalar(@matches) > 1) {
+        return \@matches;
+    }
+
+    # Check if we match exactly one custom field, ignoring the cf_ on the
+    # custom fields (to allow people to type things like "build" for 
+    # "cf_build").
+    my %cfless;
+    foreach my $name (@field_names) {
+        my $no_cf = $name;
+        if ($no_cf =~ s/^cf_//) {
+            if ($field eq $no_cf) {
+                return $field_map->{$name};
+            }
+            $cfless{$no_cf} = $name;
+        }
+    }
+
+    # See if we match exactly one substring of any of the cf_-less fields.
+    my @cfless_matches = grep { $_ =~ /^\Q$field\E/ } (keys %cfless);
+
+    if (scalar(@cfless_matches) == 1) {
+        my $match = $cfless_matches[0];
+        my $actual_field = $cfless{$match};
+        return $field_map->{$actual_field};
+    }
+    elsif (scalar(@matches) > 1) {
+        return \@matches;
+    }
+
+    return undef;
+}
+
+sub _special_field_syntax {
+    my ($word, $negate) = @_;
+    
+    # P1-5 Syntax
+    if ($word =~ m/^P(\d+)(?:-(\d+))?$/i) {
+        my ($p_start, $p_end) = ($1, $2);
+        my $legal_priorities = get_legal_field_values('priority');
+
+        # If Pn exists explicitly, use it.
+        my $start = firstidx { $_ eq "P$p_start" } @$legal_priorities;
+        my $end;
+        $end = firstidx { $_ eq "P$p_end" } @$legal_priorities if defined $p_end;
+
+        # If Pn doesn't exist explicitly, then we mean the nth priority.
+        if ($start == -1) {
+            $start = max(0, $p_start - 1);
+        }
+        my $prios = $legal_priorities->[$start];
+
+        if (defined $end) {
+            # If Pn doesn't exist explicitly, then we mean the nth priority.
+            if ($end == -1) {
+                $end = min(scalar(@$legal_priorities), $p_end) - 1;
+                $end = max(0, $end); # Just in case the user typed P0.
+            }
+            ($start, $end) = ($end, $start) if $end < $start;
+            $prios = join(',', @$legal_priorities[$start..$end])
+        }
+
+        addChart('priority', 'anyexact', $prios, $negate);
+        return 1;
+    }
+    return 0;    
+}
+
+sub _default_quicksearch_word {
+    my ($word, $negate) = @_;
+    
+    if (!grep { lc($word) eq $_ } PRODUCT_EXCEPTIONS and length($word) > 2) {
+        addChart('product', 'substring', $word, $negate);
+    }
+    
+    if (!grep { lc($word) eq $_ } COMPONENT_EXCEPTIONS and length($word) > 2) {
+        addChart('component', 'substring', $word, $negate);
+    }
+    
+    my @legal_keywords = map($_->name, Bugzilla::Keyword->get_all);
+    if (grep { lc($word) eq lc($_) } @legal_keywords) {
+        addChart('keywords', 'substring', $word, $negate);
+    }
+    
+    addChart('alias', 'substring', $word, $negate);
+    addChart('short_desc', 'substring', $word, $negate);
+    addChart('status_whiteboard', 'substring', $word, $negate);
+    addChart('content', 'matches', _matches_phrase($word), $negate) if $fulltext;
+}
+
+sub _handle_urls {
+    my ($word, $negate) = @_;
+    # URL field (for IP addrs, host.names,
+    # scheme://urls)
+    if ($word =~ m/[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+/
+        || $word =~ /^[A-Za-z]+(\.[A-Za-z]+)+/
+        || $word =~ /:[\\\/][\\\/]/
+        || $word =~ /localhost/
+        || $word =~ /mailto[:]?/)
+        # || $word =~ /[A-Za-z]+[:][0-9]+/ #host:port
+    {
+        addChart('bug_file_loc', 'substring', $word, $negate);
+    }
+}
+
+###########################################################################
+# Helpers
+###########################################################################
+
+# Quote and escape a phrase appropriately for a "content matches" search.
+sub _matches_phrase {
+    my ($phrase) = @_;
+    $phrase =~ s/"/\\"/g;
+    return "\"$phrase\"";
+}
+
+# Expand found prefixes to states or resolutions
+sub matchPrefixes {
+    my ($hr_states, $hr_resolutions, $word, $ar_check_states) = @_;
+    return unless $word =~ /^[A-Z_]+(,[A-Z_]+)*$/;
+
+    my @ar_prefixes = split(/,/, $word);
+    my $ar_check_resolutions = get_legal_field_values('resolution');
+    my $foundMatch = 0;
+
+    foreach my $prefix (@ar_prefixes) {
+        foreach (@$ar_check_states) {
+            if (/^$prefix/) {
+                $$hr_states{$_} = 1;
+                $foundMatch = 1;
+            }
+        }
+        foreach (@$ar_check_resolutions) {
+            if (/^$prefix/) {
+                $$hr_resolutions{$_} = 1;
+                $foundMatch = 1;
+            }
+        }
+    }
+    return $foundMatch;
+}
+
+# Negate comparison type
+sub negateComparisonType {
+    my $comparisonType = shift;
+
+    if ($comparisonType eq 'anywords') {
+        return 'nowords';
+    }
+    return "not$comparisonType";
+}
+
+# Add a boolean chart
+sub addChart {
+    my ($field, $comparisonType, $value, $negate) = @_;
+
+    $negate && ($comparisonType = negateComparisonType($comparisonType));
+    makeChart("$chart-$and-$or", $field, $comparisonType, $value);
+    if ($negate) {
+        $and++;
+        $or = 0;
+    }
+    else {
+        $or++;
+    }
+}
+
+# Create the CGI parameters for a boolean chart
+sub makeChart {
+    my ($expr, $field, $type, $value) = @_;
+
+    my $cgi = Bugzilla->cgi;
+    $cgi->param("field$expr", $field);
+    $cgi->param("type$expr",  $type);
+    $cgi->param("value$expr", $value);
+}
+
+1;

diff --git a/Bugzilla/Search/Recent.pm b/Bugzilla/Search/Recent.pm
new file mode 100644 (file)
index 0000000..1ff56c7
--- /dev/null
+++ b/Bugzilla/Search/Recent.pm
@@ -0,0 +1,159 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Search::Recent;
+use strict;
+use base qw(Bugzilla::Object);
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Util;
+
+#############
+# Constants #
+#############
+
+use constant DB_TABLE => 'profile_search';
+use constant LIST_ORDER => 'id DESC';
+# Do not track buglists viewed by users.
+use constant AUDIT_CREATES => 0;
+use constant AUDIT_UPDATES => 0;
+use constant AUDIT_REMOVES => 0;
+
+use constant DB_COLUMNS => qw(
+    id
+    user_id
+    bug_list
+    list_order
+);
+
+use constant VALIDATORS => {
+    user_id    => \&_check_user_id,
+    bug_list   => \&_check_bug_list,
+    list_order => \&_check_list_order,
+};
+
+use constant UPDATE_COLUMNS => qw(bug_list list_order);
+
+###################
+# DB Manipulation #
+###################
+
+sub create {
+    my $class = shift;
+    my $dbh = Bugzilla->dbh;
+    $dbh->bz_start_transaction();
+    my $search = $class->SUPER::create(@_);
+    my $user_id = $search->user_id;
+
+    # Enforce there only being SAVE_NUM_SEARCHES per user.
+    my @ids = @{ $dbh->selectcol_arrayref(
+        "SELECT id FROM profile_search WHERE user_id = ? ORDER BY id",
+        undef, $user_id) };
+    if (scalar(@ids) > SAVE_NUM_SEARCHES) {
+        splice(@ids, - SAVE_NUM_SEARCHES);
+        $dbh->do(
+            "DELETE FROM profile_search WHERE id IN (" . join(',', @ids) . ")");
+    }
+    $dbh->bz_commit_transaction();
+    return $search;
+}
+
+sub create_placeholder {
+    my $class = shift;
+    return $class->create({ user_id  => Bugzilla->user->id,
+                            bug_list => '' });
+}
+
+###############
+# Constructor #
+###############
+
+sub check {
+    my $class = shift;
+    my $search = $class->SUPER::check(@_);
+    my $user = Bugzilla->user;
+    if ($search->user_id != $user->id) {
+        ThrowUserError('object_does_not_exist', { id => $search->id });
+    }
+    return $search;
+}
+
+sub check_quietly {
+    my $class = shift;
+    my $error_mode = Bugzilla->error_mode;
+    Bugzilla->error_mode(ERROR_MODE_DIE);
+    my $search = eval { $class->check(@_) };
+    Bugzilla->error_mode($error_mode);
+    return $search;
+}
+
+sub new_from_cookie {
+    my ($invocant, $bug_ids) = @_;
+    my $class = ref($invocant) || $invocant;
+
+    my $search = { id       => 'cookie',
+                   user_id  => Bugzilla->user->id,
+                   bug_list => join(',', @$bug_ids) };
+
+    bless $search, $class;
+    return $search;
+}
+
+####################
+# Simple Accessors #
+####################
+
+sub bug_list   { return [split(',', $_[0]->{'bug_list'})]; }
+sub list_order { return $_[0]->{'list_order'}; }
+sub user_id    { return $_[0]->{'user_id'}; }
+
+############
+# Mutators #
+############
+
+sub set_bug_list   { $_[0]->set('bug_list',   $_[1]); }
+sub set_list_order { $_[0]->set('list_order', $_[1]); }
+
+##############
+# Validators #
+##############
+
+sub _check_user_id {
+    my ($invocant, $id) = @_;
+    require Bugzilla::User;
+    return Bugzilla::User->check({ id => $id })->id;
+}
+
+sub _check_bug_list {
+    my ($invocant, $list) = @_;
+
+    my @bug_ids = ref($list) ? @$list : split(',', $list || '');
+    detaint_natural($_) foreach @bug_ids;
+    return join(',', @bug_ids);
+}
+
+sub _check_list_order { defined $_[1] ? trim($_[1]) : '' }
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Search::Recent - A search recently run by a logged-in user.
+
+=head1 SYNOPSIS
+
+ use Bugzilla::Search::Recent;
+
+
+=head1 DESCRIPTION
+
+This is an implementation of L<Bugzilla::Object>, and so has all the
+same methods available as L<Bugzilla::Object>, in addition to what is
+documented below.

diff --git a/Bugzilla/Search/Saved.pm b/Bugzilla/Search/Saved.pm
new file mode 100644 (file)
index 0000000..c9885c9
--- /dev/null
+++ b/Bugzilla/Search/Saved.pm
@@ -0,0 +1,387 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+package Bugzilla::Search::Saved;
+
+use base qw(Bugzilla::Object);
+
+use Bugzilla::CGI;
+use Bugzilla::Constants;
+use Bugzilla::Group;
+use Bugzilla::Error;
+use Bugzilla::Search qw(IsValidQueryType);
+use Bugzilla::User;
+use Bugzilla::Util;
+
+use Scalar::Util qw(blessed);
+
+#############
+# Constants #
+#############
+
+use constant DB_TABLE => 'namedqueries';
+# Do not track buglists saved by users.
+use constant AUDIT_CREATES => 0;
+use constant AUDIT_UPDATES => 0;
+use constant AUDIT_REMOVES => 0;
+
+use constant DB_COLUMNS => qw(
+    id
+    userid
+    name
+    query
+);
+
+use constant VALIDATORS => {
+    name       => \&_check_name,
+    query      => \&_check_query,
+    link_in_footer => \&_check_link_in_footer,
+};
+
+use constant UPDATE_COLUMNS => qw(name query);
+
+###############
+# Constructor #
+###############
+
+sub new {
+    my $class = shift;
+    my $param = shift;
+    my $dbh = Bugzilla->dbh;
+
+    my $user;
+    if (ref $param) {
+        $user = $param->{user} || Bugzilla->user;
+        my $name = $param->{name};
+        if (!defined $name) {
+            ThrowCodeError('bad_arg',
+                {argument => 'name',
+                 function => "${class}::new"});
+        }
+        my $condition = 'userid = ? AND name = ?';
+        my $user_id = blessed $user ? $user->id : $user;
+        detaint_natural($user_id)
+          || ThrowCodeError('param_must_be_numeric',
+                            {function => $class . '::_init', param => 'user'});
+        my @values = ($user_id, $name);
+        $param = { condition => $condition, values => \@values };
+    }
+
+    unshift @_, $param;
+    my $self = $class->SUPER::new(@_);
+    if ($self) {
+        $self->{user} = $user if blessed $user;
+
+        # Some DBs (read: Oracle) incorrectly mark the query string as UTF-8
+        # when it's coming out of the database, even though it has no UTF-8
+        # characters in it, which prevents Bugzilla::CGI from later reading
+        # it correctly.
+        utf8::downgrade($self->{query}) if utf8::is_utf8($self->{query});
+    }
+    return $self;
+}
+
+sub check {
+    my $class = shift;
+    my $search = $class->SUPER::check(@_);
+    my $user = Bugzilla->user;
+    return $search if $search->user->id == $user->id;
+
+    if (!$search->shared_with_group
+        or !$user->in_group($search->shared_with_group)) 
+    {
+        ThrowUserError('missing_query', { name => $search->name,
+                                          sharer_id => $search->user->id });
+    }
+
+    return $search;
+}
+
+##############
+# Validators #
+##############
+
+sub _check_link_in_footer { return $_[1] ? 1 : 0; }
+
+sub _check_name {
+    my ($invocant, $name) = @_;
+    $name = trim($name);
+    $name || ThrowUserError("query_name_missing");
+    $name !~ /[<>&]/ || ThrowUserError("illegal_query_name");
+    if (length($name) > MAX_LEN_QUERY_NAME) {
+        ThrowUserError("query_name_too_long");
+    }
+    return $name;
+}
+
+sub _check_query {
+    my ($invocant, $query) = @_;
+    $query || ThrowUserError("buglist_parameters_required");
+    my $cgi = new Bugzilla::CGI($query);
+    $cgi->clean_search_url;
+    # Don't store the query name as a parameter.
+    $cgi->delete('known_name');
+    return $cgi->query_string;
+}
+
+#########################
+# Database Manipulation #
+#########################
+
+sub create {
+    my $class = shift;
+    Bugzilla->login(LOGIN_REQUIRED);
+    my $dbh = Bugzilla->dbh;
+    $class->check_required_create_fields(@_);
+    $dbh->bz_start_transaction();
+    my $params = $class->run_create_validators(@_);
+
+    # Right now you can only create a Saved Search for the current user.
+    $params->{userid} = Bugzilla->user->id;
+
+    my $lif = delete $params->{link_in_footer};
+    my $obj = $class->insert_create_data($params);
+    if ($lif) {
+        $dbh->do('INSERT INTO namedqueries_link_in_footer 
+                  (user_id, namedquery_id) VALUES (?,?)',
+                 undef, $params->{userid}, $obj->id);
+    }
+    $dbh->bz_commit_transaction();
+
+    return $obj;
+}
+
+sub rename_field_value {
+    my ($class, $field, $old_value, $new_value) = @_;
+
+    my $old = url_quote($old_value);
+    my $new = url_quote($new_value);
+    my $old_sql = $old;
+    $old_sql =~ s/([_\%])/\\$1/g;
+
+    my $table = $class->DB_TABLE;
+    my $id_field = $class->ID_FIELD;
+
+    my $dbh = Bugzilla->dbh;
+    $dbh->bz_start_transaction();
+
+    my %queries = @{ $dbh->selectcol_arrayref(
+        "SELECT $id_field, query FROM $table WHERE query LIKE ?",
+        {Columns=>[1,2]}, "\%$old_sql\%") };
+    foreach my $id (keys %queries) {
+        my $query = $queries{$id};
+        $query =~ s/\b$field=\Q$old\E\b/$field=$new/gi;
+        # Fix boolean charts.
+        while ($query =~ /\bfield(\d+-\d+-\d+)=\Q$field\E\b/gi) {
+            my $chart_id = $1;
+            # Note that this won't handle lists or substrings inside of
+            # boolean charts. Users will have to fix those themselves.
+            $query =~ s/\bvalue\Q$chart_id\E=\Q$old\E\b/value$chart_id=$new/i;
+        }
+        $dbh->do("UPDATE $table SET query = ? WHERE $id_field = ?",
+                 undef, $query, $id);
+    }
+
+    $dbh->bz_commit_transaction();
+}
+
+sub preload {
+    my ($searches) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    return unless scalar @$searches;
+
+    my @query_ids = map { $_->id } @$searches;
+    my $queries_in_footer = $dbh->selectcol_arrayref(
+        'SELECT namedquery_id
+           FROM namedqueries_link_in_footer
+          WHERE ' . $dbh->sql_in('namedquery_id', \@query_ids) . ' AND user_id = ?',
+          undef, Bugzilla->user->id);
+
+    my %links_in_footer = map { $_ => 1 } @$queries_in_footer;
+    foreach my $query (@$searches) {
+        $query->{link_in_footer} = ($links_in_footer{$query->id}) ? 1 : 0;
+    }
+}
+#####################
+# Complex Accessors #
+#####################
+
+sub edit_link {
+    my ($self) = @_;
+    return $self->{edit_link} if defined $self->{edit_link};
+    my $cgi = new Bugzilla::CGI($self->url);
+    if (!$cgi->param('query_type') 
+        || !IsValidQueryType($cgi->param('query_type')))
+    {
+        $cgi->param('query_type', 'advanced');
+    }
+    $self->{edit_link} = $cgi->canonicalise_query;
+    return $self->{edit_link};
+}
+
+sub used_in_whine {
+    my ($self) = @_;
+    return $self->{used_in_whine} if exists $self->{used_in_whine};
+    ($self->{used_in_whine}) = Bugzilla->dbh->selectrow_array(
+        'SELECT 1 FROM whine_events INNER JOIN whine_queries
+                       ON whine_events.id = whine_queries.eventid
+          WHERE whine_events.owner_userid = ? AND query_name = ?', undef, 
+          $self->{userid}, $self->name) || 0;
+    return $self->{used_in_whine};
+}
+
+sub link_in_footer {
+    my ($self, $user) = @_;
+    # We only cache link_in_footer for the current Bugzilla->user.
+    return $self->{link_in_footer} if exists $self->{link_in_footer} && !$user;
+    my $user_id = $user ? $user->id : Bugzilla->user->id;
+    my $link_in_footer = Bugzilla->dbh->selectrow_array(
+        'SELECT 1 FROM namedqueries_link_in_footer
+          WHERE namedquery_id = ? AND user_id = ?', 
+        undef, $self->id, $user_id) || 0;
+    $self->{link_in_footer} = $link_in_footer if !$user;
+    return $link_in_footer;
+}
+
+sub shared_with_group {
+    my ($self) = @_;
+    return $self->{shared_with_group} if exists $self->{shared_with_group};
+    # Bugzilla only currently supports sharing with one group, even
+    # though the database backend allows for an infinite number.
+    my ($group_id) = Bugzilla->dbh->selectrow_array(
+        'SELECT group_id FROM namedquery_group_map WHERE namedquery_id = ?',
+        undef, $self->id);
+    $self->{shared_with_group} = $group_id ? new Bugzilla::Group($group_id) 
+                                 : undef;
+    return $self->{shared_with_group};
+}
+
+sub shared_with_users {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    if (!exists $self->{shared_with_users}) {
+        $self->{shared_with_users} =
+          $dbh->selectrow_array('SELECT COUNT(*)
+                                   FROM namedqueries_link_in_footer
+                             INNER JOIN namedqueries
+                                     ON namedquery_id = id
+                                  WHERE namedquery_id = ?
+                                    AND user_id != userid',
+                                  undef, $self->id);
+    }
+    return $self->{shared_with_users};
+}
+
+####################
+# Simple Accessors #
+####################
+
+sub url  { return $_[0]->{'query'}; }
+
+sub user {
+    my ($self) = @_;
+    return $self->{user} if defined $self->{user};
+    $self->{user} = new Bugzilla::User($self->{userid});
+    return $self->{user};
+}
+
+############
+# Mutators #
+############
+
+sub set_name       { $_[0]->set('name',       $_[1]); }
+sub set_url        { $_[0]->set('query',      $_[1]); }
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Search::Saved - A saved search
+
+=head1 SYNOPSIS
+
+ use Bugzilla::Search::Saved;
+
+ my $query = new Bugzilla::Search::Saved($query_id);
+
+ my $edit_link  = $query->edit_link;
+ my $search_url = $query->url;
+ my $owner      = $query->user;
+ my $num_subscribers = $query->shared_with_users;
+
+=head1 DESCRIPTION
+
+This module exists to represent a L<Bugzilla::Search> that has been
+saved to the database.
+
+This is an implementation of L<Bugzilla::Object>, and so has all the
+same methods available as L<Bugzilla::Object>, in addition to what is
+documented below.
+
+=head1 METHODS
+
+=head2 Constructors and Database Manipulation
+
+=over
+
+=item C<new>
+
+Takes either an id, or the named parameters C<user> and C<name>.
+C<user> can be either a L<Bugzilla::User> object or a numeric user id.
+
+See also: L<Bugzilla::Object/new>.
+
+=item C<preload>
+
+Sets C<link_in_footer> for all given saved searches at once, for the
+currently logged in user. This is much faster than calling this method
+for each saved search individually.
+
+=back
+
+
+=head2 Accessors
+
+These return data about the object, without modifying the object.
+
+=over
+
+=item C<edit_link>
+
+A url with which you can edit the search.
+
+=item C<url>
+
+The CGI parameters for the search, as a string.
+
+=item C<link_in_footer>
+
+Whether or not this search should be displayed in the footer for the
+I<current user> (not the owner of the search, but the person actually
+using Bugzilla right now).
+
+=item C<type>
+
+The numeric id of the type of search this is (from L<Bugzilla::Constants>).
+
+=item C<shared_with_group>
+
+The L<Bugzilla::Group> that this search is shared with. C<undef> if
+this search isn't shared.
+
+=item C<shared_with_users>
+
+Returns how many users (besides the author of the saved search) are
+using the saved search, i.e. have it displayed in their footer.
+
+=back

diff --git a/Bugzilla/Send/Sendmail.pm b/Bugzilla/Send/Sendmail.pm
new file mode 100644 (file)
index 0000000..9513134
--- /dev/null
+++ b/Bugzilla/Send/Sendmail.pm
@@ -0,0 +1,95 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Send::Sendmail;
+
+use strict;
+
+use base qw(Email::Send::Sendmail);
+
+use Return::Value;
+use Symbol qw(gensym);
+
+sub send {
+    my ($class, $message, @args) = @_;
+    my $mailer = $class->_find_sendmail;
+
+    return failure "Couldn't find 'sendmail' executable in your PATH"
+        ." and Email::Send::Sendmail::SENDMAIL is not set"
+        unless $mailer;
+
+    return failure "Found $mailer but cannot execute it"
+        unless -x $mailer;
+    
+    local $SIG{'CHLD'} = 'DEFAULT';
+
+    my $pipe = gensym;
+
+    open($pipe, "| $mailer -t -oi @args")
+        || return failure "Error executing $mailer: $!";
+    print($pipe $message->as_string)
+        || return failure "Error printing via pipe to $mailer: $!";
+    unless (close $pipe) {
+        return failure "error when closing pipe to $mailer: $!" if $!;
+        my ($error_message, $is_transient) = _map_exitcode($? >> 8);
+        if (Bugzilla->params->{'use_mailer_queue'}) {
+            # Return success for errors which are fatal so Bugzilla knows to
+            # remove them from the queue
+            if ($is_transient) {
+                return failure "error when closing pipe to $mailer: $error_message";
+            } else {
+                warn "error when closing pipe to $mailer: $error_message\n";
+                return success;
+            }
+        } else {
+            return failure "error when closing pipe to $mailer: $error_message";
+        }
+    }
+    return success;
+}
+
+sub _map_exitcode {
+    # Returns (error message, is_transient)
+    # from the sendmail source (sendmail/sysexit.h)
+    my $code = shift;
+    if ($code == 64) {
+        return ("Command line usage error (EX_USAGE)", 1);
+    } elsif ($code == 65) {
+        return ("Data format error (EX_DATAERR)", 1);
+    } elsif ($code == 66) {
+        return ("Cannot open input (EX_NOINPUT)", 1);
+    } elsif ($code == 67) {
+        return ("Addressee unknown (EX_NOUSER)", 0);
+    } elsif ($code == 68) {
+        return ("Host name unknown (EX_NOHOST)", 0);
+    } elsif ($code == 69) {
+        return ("Service unavailable (EX_UNAVAILABLE)", 1);
+    } elsif ($code == 70) {
+        return ("Internal software error (EX_SOFTWARE)", 1);
+    } elsif ($code == 71) {
+        return ("System error (EX_OSERR)", 1);
+    } elsif ($code == 72) {
+        return ("Critical OS file missing (EX_OSFILE)", 1);
+    } elsif ($code == 73) {
+        return ("Can't create output file (EX_CANTCREAT)", 1);
+    } elsif ($code == 74) {
+        return ("Input/output error (EX_IOERR)", 1);
+    } elsif ($code == 75) {
+        return ("Temp failure (EX_TEMPFAIL)", 1);
+    } elsif ($code == 76) {
+        return ("Remote error in protocol (EX_PROTOCOL)", 1);
+    } elsif ($code == 77) {
+        return ("Permission denied (EX_NOPERM)", 1);
+    } elsif ($code == 78) {
+        return ("Configuration error (EX_CONFIG)", 1);
+    } else {
+        return ("Unknown Error ($code)", 1);
+    }
+}
+
+1;
+

diff --git a/Bugzilla/Series.pm b/Bugzilla/Series.pm
new file mode 100644 (file)
index 0000000..f2ed9a4
--- /dev/null
+++ b/Bugzilla/Series.pm
@@ -0,0 +1,271 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+# This module implements a series - a set of data to be plotted on a chart.
+#
+# This Series is in the database if and only if self->{'series_id'} is defined. 
+# Note that the series being in the database does not mean that the fields of 
+# this object are the same as the DB entries, as the object may have been 
+# altered.
+
+package Bugzilla::Series;
+
+use Bugzilla::Error;
+use Bugzilla::Util;
+
+# This is a hack so that we can re-use the rename_field_value
+# code from Bugzilla::Search::Saved.
+use constant DB_TABLE => 'series';
+use constant ID_FIELD => 'series_id';
+
+sub new {
+    my $invocant = shift;
+    my $class = ref($invocant) || $invocant;
+  
+    # Create a ref to an empty hash and bless it
+    my $self = {};
+    bless($self, $class);
+
+    my $arg_count = scalar(@_);
+    
+    # new() can return undef if you pass in a series_id and the user doesn't 
+    # have sufficient permissions. If you create a new series in this way,
+    # you need to check for an undef return, and act appropriately.
+    my $retval = $self;
+
+    # There are three ways of creating Series objects. Two (CGI and Parameters)
+    # are for use when creating a new series. One (Database) is for retrieving
+    # information on existing series.
+    if ($arg_count == 1) {
+        if (ref($_[0])) {
+            # We've been given a CGI object to create a new Series from.
+            # This series may already exist - external code needs to check
+            # before it calls writeToDatabase().
+            $self->initFromCGI($_[0]);
+        }
+        else {
+            # We've been given a series_id, which should represent an existing
+            # Series.
+            $retval = $self->initFromDatabase($_[0]);
+        }
+    }
+    elsif ($arg_count >= 6 && $arg_count <= 8) {
+        # We've been given a load of parameters to create a new Series from.
+        # Currently, undef is always passed as the first parameter; this allows
+        # you to call writeToDatabase() unconditionally.
+        # XXX - You cannot set category_id and subcategory_id from here.
+        $self->initFromParameters(@_);
+    }
+    else {
+        die("Bad parameters passed in - invalid number of args: $arg_count");
+    }
+
+    return $retval;
+}
+
+sub initFromDatabase {
+    my ($self, $series_id) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $user = Bugzilla->user;
+
+    detaint_natural($series_id) 
+      || ThrowCodeError("invalid_series_id", { 'series_id' => $series_id });
+
+    my $grouplist = $user->groups_as_string;
+
+    my @series = $dbh->selectrow_array("SELECT series.series_id, cc1.name, " .
+        "cc2.name, series.name, series.creator, series.frequency, " .
+        "series.query, series.is_public, series.category, series.subcategory " .
+        "FROM series " .
+        "INNER JOIN series_categories AS cc1 " .
+        "    ON series.category = cc1.id " .
+        "INNER JOIN series_categories AS cc2 " .
+        "    ON series.subcategory = cc2.id " .
+        "LEFT JOIN category_group_map AS cgm " .
+        "    ON series.category = cgm.category_id " .
+        "    AND cgm.group_id NOT IN($grouplist) " .
+        "WHERE series.series_id = ? " .
+        "    AND (creator = ? OR (is_public = 1 AND cgm.category_id IS NULL))",
+        undef, ($series_id, $user->id));
+
+    if (@series) {
+        $self->initFromParameters(@series);
+        return $self;
+    }
+    else {
+        return undef;
+    }
+}
+
+sub initFromParameters {
+    # Pass undef as the first parameter if you are creating a new series.
+    my $self = shift;
+
+    ($self->{'series_id'}, $self->{'category'},  $self->{'subcategory'},
+     $self->{'name'}, $self->{'creator_id'}, $self->{'frequency'},
+     $self->{'query'}, $self->{'public'}, $self->{'category_id'},
+     $self->{'subcategory_id'}) = @_;
+
+    # If the first parameter is undefined, check if this series already
+    # exists and update it series_id accordingly
+    $self->{'series_id'} ||= $self->existsInDatabase();
+}
+
+sub initFromCGI {
+    my $self = shift;
+    my $cgi = shift;
+
+    $self->{'series_id'} = $cgi->param('series_id') || undef;
+    if (defined($self->{'series_id'})) {
+        detaint_natural($self->{'series_id'})
+          || ThrowCodeError("invalid_series_id", 
+                               { 'series_id' => $self->{'series_id'} });
+    }
+    
+    $self->{'category'} = $cgi->param('category')
+      || $cgi->param('newcategory')
+      || ThrowUserError("missing_category");
+
+    $self->{'subcategory'} = $cgi->param('subcategory')
+      || $cgi->param('newsubcategory')
+      || ThrowUserError("missing_subcategory");
+
+    $self->{'name'} = $cgi->param('name')
+      || ThrowUserError("missing_name");
+
+    $self->{'creator_id'} = Bugzilla->user->id;
+
+    $self->{'frequency'} = $cgi->param('frequency');
+    detaint_natural($self->{'frequency'})
+      || ThrowUserError("missing_frequency");
+
+    $self->{'query'} = $cgi->canonicalise_query("format", "ctype", "action",
+                                        "category", "subcategory", "name",
+                                        "frequency", "public", "query_format");
+    trick_taint($self->{'query'});
+                                        
+    $self->{'public'} = $cgi->param('public') ? 1 : 0;
+    
+    # Change 'admin' here and in series.html.tmpl, or remove the check
+    # completely, if you want to change who can make series public.
+    $self->{'public'} = 0 unless Bugzilla->user->in_group('admin');
+}
+
+sub writeToDatabase {
+    my $self = shift;
+
+    my $dbh = Bugzilla->dbh;
+    $dbh->bz_start_transaction();
+
+    my $category_id = getCategoryID($self->{'category'});
+    my $subcategory_id = getCategoryID($self->{'subcategory'});
+
+    my $exists;
+    if ($self->{'series_id'}) { 
+        $exists = 
+            $dbh->selectrow_array("SELECT series_id FROM series
+                                   WHERE series_id = $self->{'series_id'}");
+    }
+    
+    # Is this already in the database?                              
+    if ($exists) {
+        # Update existing series
+        my $dbh = Bugzilla->dbh;
+        $dbh->do("UPDATE series SET " .
+                 "category = ?, subcategory = ?," .
+                 "name = ?, frequency = ?, is_public = ?  " .
+                 "WHERE series_id = ?", undef,
+                 $category_id, $subcategory_id, $self->{'name'},
+                 $self->{'frequency'}, $self->{'public'}, 
+                 $self->{'series_id'});
+    }
+    else {
+        # Insert the new series into the series table
+        $dbh->do("INSERT INTO series (creator, category, subcategory, " .
+                 "name, frequency, query, is_public) VALUES " . 
+                 "(?, ?, ?, ?, ?, ?, ?)", undef,
+                 $self->{'creator_id'}, $category_id, $subcategory_id, $self->{'name'},
+                 $self->{'frequency'}, $self->{'query'}, $self->{'public'});
+
+        # Retrieve series_id
+        $self->{'series_id'} = $dbh->selectrow_array("SELECT MAX(series_id) " .
+                                                     "FROM series");
+        $self->{'series_id'}
+          || ThrowCodeError("missing_series_id", { 'series' => $self });
+    }
+    
+    $dbh->bz_commit_transaction();
+}
+
+# Check whether a series with this name, category and subcategory exists in
+# the DB and, if so, returns its series_id.
+sub existsInDatabase {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    my $category_id = getCategoryID($self->{'category'});
+    my $subcategory_id = getCategoryID($self->{'subcategory'});
+    
+    trick_taint($self->{'name'});
+    my $series_id = $dbh->selectrow_array("SELECT series_id " .
+                              "FROM series WHERE category = $category_id " .
+                              "AND subcategory = $subcategory_id AND name = " .
+                              $dbh->quote($self->{'name'}));
+                              
+    return($series_id);
+}
+
+# Get a category or subcategory IDs, creating the category if it doesn't exist.
+sub getCategoryID {
+    my ($category) = @_;
+    my $category_id;
+    my $dbh = Bugzilla->dbh;
+
+    # This seems for the best idiom for "Do A. Then maybe do B and A again."
+    while (1) {
+        # We are quoting this to put it in the DB, so we can remove taint
+        trick_taint($category);
+
+        $category_id = $dbh->selectrow_array("SELECT id " .
+                                      "from series_categories " .
+                                      "WHERE name =" . $dbh->quote($category));
+
+        last if defined($category_id);
+
+        $dbh->do("INSERT INTO series_categories (name) " .
+                 "VALUES (" . $dbh->quote($category) . ")");
+    }
+
+    return $category_id;
+}
+
+##########
+# Methods
+##########
+sub id   { return $_[0]->{'series_id'}; }
+sub name { return $_[0]->{'name'}; }
+
+sub creator {
+    my $self = shift;
+
+    if (!$self->{creator} && $self->{creator_id}) {
+        require Bugzilla::User;
+        $self->{creator} = new Bugzilla::User($self->{creator_id});
+    }
+    return $self->{creator};
+}
+
+sub remove_from_db {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    $dbh->do('DELETE FROM series WHERE series_id = ?', undef, $self->id);
+}
+
+1;

diff --git a/Bugzilla/Status.pm b/Bugzilla/Status.pm
new file mode 100644 (file)
index 0000000..2821f7c
--- /dev/null
+++ b/Bugzilla/Status.pm
@@ -0,0 +1,297 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+package Bugzilla::Status;
+
+use Bugzilla::Error;
+# This subclasses Bugzilla::Field::Choice instead of implementing 
+# ChoiceInterface, because a bug status literally is a special type
+# of Field::Choice, not just an object that happens to have the same
+# methods.
+use base qw(Bugzilla::Field::Choice Exporter);
+@Bugzilla::Status::EXPORT = qw(
+    BUG_STATE_OPEN
+    SPECIAL_STATUS_WORKFLOW_ACTIONS
+
+    is_open_state 
+    closed_bug_statuses
+);
+
+################################
+#####   Initialization     #####
+################################
+
+use constant SPECIAL_STATUS_WORKFLOW_ACTIONS => qw(
+    none
+    duplicate
+    change_resolution
+    clearresolution
+);
+
+use constant DB_TABLE => 'bug_status';
+
+# This has all the standard Bugzilla::Field::Choice columns plus "is_open"
+sub DB_COLUMNS {
+    return ($_[0]->SUPER::DB_COLUMNS, 'is_open');
+}
+
+sub VALIDATORS {
+    my $invocant = shift;
+    my $validators = $invocant->SUPER::VALIDATORS;
+    $validators->{is_open} = \&Bugzilla::Object::check_boolean;
+    $validators->{value} = \&_check_value;
+    return $validators;
+}
+
+#########################
+# Database Manipulation #
+#########################
+
+sub create {
+    my $class = shift;
+    my $self = $class->SUPER::create(@_);
+    delete Bugzilla->request_cache->{status_bug_state_open};
+    add_missing_bug_status_transitions();
+    return $self;
+}
+
+sub remove_from_db {
+    my $self = shift;
+    $self->SUPER::remove_from_db();
+    delete Bugzilla->request_cache->{status_bug_state_open};
+}
+
+###############################
+#####     Accessors        ####
+###############################
+
+sub is_active { return $_[0]->{'isactive'}; }
+sub is_open   { return $_[0]->{'is_open'};  }
+
+sub is_static {
+    my $self = shift;
+    if ($self->name eq 'UNCONFIRMED'
+        || $self->name eq Bugzilla->params->{'duplicate_or_move_bug_status'}) 
+    {
+        return 1;
+    }
+    return 0;
+}
+
+##############
+# Validators #
+##############
+
+sub _check_value {
+    my $invocant = shift;
+    my $value = $invocant->SUPER::_check_value(@_);
+
+    if (grep { lc($value) eq lc($_) } SPECIAL_STATUS_WORKFLOW_ACTIONS) {
+        ThrowUserError('fieldvalue_reserved_word',
+                       { field => $invocant->field, value => $value });
+    }
+    return $value;
+}
+
+
+###############################
+#####       Methods        ####
+###############################
+
+sub BUG_STATE_OPEN {
+    my $dbh = Bugzilla->dbh;
+    my $cache = Bugzilla->request_cache;
+    $cache->{status_bug_state_open} ||=
+        $dbh->selectcol_arrayref('SELECT value FROM bug_status 
+                                   WHERE is_open = 1');
+    return @{ $cache->{status_bug_state_open} };
+}
+
+# Tells you whether or not the argument is a valid "open" state.
+sub is_open_state {
+    my ($state) = @_;
+    return (grep($_ eq $state, BUG_STATE_OPEN) ? 1 : 0);
+}
+
+sub closed_bug_statuses {
+    my @bug_statuses = Bugzilla::Status->get_all;
+    @bug_statuses = grep { !$_->is_open } @bug_statuses;
+    return @bug_statuses;
+}
+
+sub can_change_to {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    if (!ref($self) || !defined $self->{'can_change_to'}) {
+        my ($cond, @args, $self_exists);
+        if (ref($self)) {
+            $cond = '= ?';
+            push(@args, $self->id);
+            $self_exists = 1;
+        }
+        else {
+            $cond = 'IS NULL';
+            # Let's do it so that the code below works in all cases.
+            $self = {};
+        }
+
+        my $new_status_ids = $dbh->selectcol_arrayref("SELECT new_status
+                                                         FROM status_workflow
+                                                   INNER JOIN bug_status
+                                                           ON id = new_status
+                                                        WHERE isactive = 1
+                                                          AND old_status $cond
+                                                     ORDER BY sortkey",
+                                                        undef, @args);
+
+        # Allow the bug status to remain unchanged.
+        push(@$new_status_ids, $self->id) if $self_exists;
+        $self->{'can_change_to'} = Bugzilla::Status->new_from_list($new_status_ids);
+    }
+
+    return $self->{'can_change_to'};
+}
+
+sub comment_required_on_change_from {
+    my ($self, $old_status) = @_;
+    my ($cond, $values) = $self->_status_condition($old_status);
+    
+    my ($require_comment) = Bugzilla->dbh->selectrow_array(
+        "SELECT require_comment FROM status_workflow
+          WHERE $cond", undef, @$values);
+    return $require_comment;
+}
+
+# Used as a helper for various functions that have to deal with old_status
+# sometimes being NULL and sometimes having a value.
+sub _status_condition {
+    my ($self, $old_status) = @_;
+    my @values;
+    my $cond = 'old_status IS NULL';
+    # We may pass a fake status object to represent the initial unset state.
+    if ($old_status && $old_status->id)  {
+        $cond = 'old_status = ?';
+        push(@values, $old_status->id);
+    }
+    $cond .= " AND new_status = ?";
+    push(@values, $self->id);
+    return ($cond, \@values);
+}
+
+sub add_missing_bug_status_transitions {
+    my $bug_status = shift || Bugzilla->params->{'duplicate_or_move_bug_status'};
+    my $dbh = Bugzilla->dbh;
+    my $new_status = new Bugzilla::Status({name => $bug_status});
+    # Silently discard invalid bug statuses.
+    $new_status || return;
+
+    my $missing_statuses = $dbh->selectcol_arrayref('SELECT id
+                                                       FROM bug_status
+                                                  LEFT JOIN status_workflow
+                                                         ON old_status = id
+                                                        AND new_status = ?
+                                                      WHERE old_status IS NULL',
+                                                      undef, $new_status->id);
+
+    my $sth = $dbh->prepare('INSERT INTO status_workflow
+                             (old_status, new_status) VALUES (?, ?)');
+
+    foreach my $old_status_id (@$missing_statuses) {
+        next if ($old_status_id == $new_status->id);
+        $sth->execute($old_status_id, $new_status->id);
+    }
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Status - Bug status class.
+
+=head1 SYNOPSIS
+
+    use Bugzilla::Status;
+
+    my $bug_status = new Bugzilla::Status({ name => 'IN_PROGRESS' });
+    my $bug_status = new Bugzilla::Status(4);
+
+    my @closed_bug_statuses = closed_bug_statuses();
+
+    Bugzilla::Status::add_missing_bug_status_transitions($bug_status);
+
+=head1 DESCRIPTION
+
+Status.pm represents a bug status object. It is an implementation
+of L<Bugzilla::Object>, and thus provides all methods that
+L<Bugzilla::Object> provides.
+
+The methods that are specific to C<Bugzilla::Status> are listed
+below.
+
+=head1 METHODS
+
+=over
+
+=item C<closed_bug_statuses>
+
+ Description: Returns a list of C<Bugzilla::Status> objects which can have
+              a resolution associated with them ("closed" bug statuses).
+
+ Params:      none.
+
+ Returns:     A list of Bugzilla::Status objects.
+
+=item C<can_change_to>
+
+ Description: Returns the list of active statuses a bug can be changed to
+              given the current bug status. If this method is called as a
+              class method, then it returns all bug statuses available on
+              bug creation.
+
+ Params:      none.
+
+ Returns:     A list of Bugzilla::Status objects.
+
+=item C<comment_required_on_change_from>
+
+=over
+
+=item B<Description>
+
+Checks if a comment is required to change to this status from another
+status, according to the current settings in the workflow.
+
+Note that this doesn't implement the checks enforced by the various
+C<commenton> parameters--those are checked by internal checks in
+L<Bugzilla::Bug>.
+
+=item B<Params>
+
+C<$old_status> - The status you're changing from.
+
+=item B<Returns>
+
+C<1> if a comment is required on this change, C<0> if not.
+
+=back
+
+=item C<add_missing_bug_status_transitions>
+
+ Description: Insert all missing transitions to a given bug status.
+
+ Params:      $bug_status - The value (name) of a bug status.
+
+ Returns:     nothing.
+
+=back
+
+=cut

diff --git a/Bugzilla/Template.pm b/Bugzilla/Template.pm
new file mode 100644 (file)
index 0000000..c1f49a2
--- /dev/null
+++ b/Bugzilla/Template.pm
@@ -0,0 +1,1147 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+package Bugzilla::Template;
+
+use strict;
+
+use Bugzilla::Constants;
+use Bugzilla::WebService::Constants;
+use Bugzilla::Hook;
+use Bugzilla::Install::Requirements;
+use Bugzilla::Install::Util qw(install_string template_include_path 
+                               include_languages);
+use Bugzilla::Keyword;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Search;
+use Bugzilla::Token;
+
+use Cwd qw(abs_path);
+use MIME::Base64;
+use Date::Format ();
+use File::Basename qw(basename dirname);
+use File::Find;
+use File::Path qw(rmtree mkpath);
+use File::Spec;
+use IO::Dir;
+use List::MoreUtils qw(firstidx);
+use Scalar::Util qw(blessed);
+
+use base qw(Template);
+
+use constant FORMAT_TRIPLE => '%19s|%-28s|%-28s';
+use constant FORMAT_3_SIZE => [19,28,28];
+use constant FORMAT_DOUBLE => '%19s %-55s';
+use constant FORMAT_2_SIZE => [19,55];
+
+# Pseudo-constant.
+sub SAFE_URL_REGEXP {
+    my $safe_protocols = join('|', SAFE_PROTOCOLS);
+    return qr/($safe_protocols):[^:\s<>\"][^\s<>\"]+[\w\/]/i;
+}
+
+# Convert the constants in the Bugzilla::Constants and Bugzilla::WebService::Constants
+# modules into a hash we can pass to the template object for reflection into its "constants" 
+# namespace (which is like its "variables" namespace, but for constants). To do so, we
+# traverse the arrays of exported and exportable symbols and ignoring the rest
+# (which, if Constants.pm exports only constants, as it should, will be nothing else).
+sub _load_constants {
+    my %constants;
+    foreach my $constant (@Bugzilla::Constants::EXPORT,
+                          @Bugzilla::Constants::EXPORT_OK)
+    {
+        if (ref Bugzilla::Constants->$constant) {
+            $constants{$constant} = Bugzilla::Constants->$constant;
+        }
+        else {
+            my @list = (Bugzilla::Constants->$constant);
+            $constants{$constant} = (scalar(@list) == 1) ? $list[0] : \@list;
+        }
+    }
+
+    foreach my $constant (@Bugzilla::WebService::Constants::EXPORT, 
+                          @Bugzilla::WebService::Constants::EXPORT_OK)
+    {
+        if (ref Bugzilla::WebService::Constants->$constant) {
+            $constants{$constant} = Bugzilla::WebService::Constants->$constant;
+        }
+        else {
+            my @list = (Bugzilla::WebService::Constants->$constant);
+            $constants{$constant} = (scalar(@list) == 1) ? $list[0] : \@list;
+        }
+    }
+    return \%constants;
+}
+
+# Returns the path to the templates based on the Accept-Language
+# settings of the user and of the available languages
+# If no Accept-Language is present it uses the defined default
+# Templates may also be found in the extensions/ tree
+sub _include_path {
+    my $lang = shift || '';
+    my $cache = Bugzilla->request_cache;
+    $cache->{"template_include_path_$lang"} ||= 
+        template_include_path({ language => $lang });
+    return $cache->{"template_include_path_$lang"};
+}
+
+sub get_format {
+    my $self = shift;
+    my ($template, $format, $ctype) = @_;
+
+    $ctype ||= 'html';
+    $format ||= '';
+
+    # ctype and format can have letters and a hyphen only.
+    if ($ctype =~ /[^a-zA-Z\-]/ || $format =~ /[^a-zA-Z\-]/) {
+        ThrowUserError('format_not_found', {'format' => $format,
+                                            'ctype'  => $ctype,
+                                            'invalid' => 1});
+    }
+    trick_taint($ctype);
+    trick_taint($format);
+
+    $template .= ($format ? "-$format" : "");
+    $template .= ".$ctype.tmpl";
+
+    # Now check that the template actually exists. We only want to check
+    # if the template exists; any other errors (eg parse errors) will
+    # end up being detected later.
+    eval {
+        $self->context->template($template);
+    };
+    # This parsing may seem fragile, but it's OK:
+    # http://lists.template-toolkit.org/pipermail/templates/2003-March/004370.html
+    # Even if it is wrong, any sort of error is going to cause a failure
+    # eventually, so the only issue would be an incorrect error message
+    if ($@ && $@->info =~ /: not found$/) {
+        ThrowUserError('format_not_found', {'format' => $format,
+                                            'ctype'  => $ctype});
+    }
+
+    # Else, just return the info
+    return
+    {
+        'template'    => $template,
+        'format'      => $format,
+        'extension'   => $ctype,
+        'ctype'       => Bugzilla::Constants::contenttypes->{$ctype}
+    };
+}
+
+# This routine quoteUrls contains inspirations from the HTML::FromText CPAN
+# module by Gareth Rees <garethr@cre.canon.co.uk>.  It has been heavily hacked,
+# all that is really recognizable from the original is bits of the regular
+# expressions.
+# This has been rewritten to be faster, mainly by substituting 'as we go'.
+# If you want to modify this routine, read the comments carefully
+
+sub quoteUrls {
+    my ($text, $bug, $comment, $user) = @_;
+    return $text unless $text;
+    $user ||= Bugzilla->user;
+
+    # We use /g for speed, but uris can have other things inside them
+    # (http://foo/bug#3 for example). Filtering that out filters valid
+    # bug refs out, so we have to do replacements.
+    # mailto can't contain space or #, so we don't have to bother for that
+    # Do this by escaping \0 to \1\0, and replacing matches with \0\0$count\0\0
+    # \0 is used because it's unlikely to occur in the text, so the cost of
+    # doing this should be very small
+
+    # escape the 2nd escape char we're using
+    my $chr1 = chr(1);
+    $text =~ s/\0/$chr1\0/g;
+
+    # However, note that adding the title (for buglinks) can affect things
+    # In particular, attachment matches go before bug titles, so that titles
+    # with 'attachment 1' don't double match.
+    # Dupe checks go afterwards, because that uses ^ and \Z, which won't occur
+    # if it was substituted as a bug title (since that always involve leading
+    # and trailing text)
+
+    # Because of entities, it's easier (and quicker) to do this before escaping
+
+    my @things;
+    my $count = 0;
+    my $tmp;
+
+    my @hook_regexes;
+    Bugzilla::Hook::process('bug_format_comment',
+        { text => \$text, bug => $bug, regexes => \@hook_regexes,
+          comment => $comment, user => $user });
+
+    foreach my $re (@hook_regexes) {
+        my ($match, $replace) = @$re{qw(match replace)};
+        if (ref($replace) eq 'CODE') {
+            $text =~ s/$match/($things[$count++] = $replace->({matches => [
+                                                               $1, $2, $3, $4,
+                                                               $5, $6, $7, $8, 
+                                                               $9, $10]}))
+                               && ("\0\0" . ($count-1) . "\0\0")/egx;
+        }
+        else {
+            $text =~ s/$match/($things[$count++] = $replace) 
+                              && ("\0\0" . ($count-1) . "\0\0")/egx;
+        }
+    }
+
+    # Provide tooltips for full bug links (Bug 74355)
+    my $urlbase_re = '(' . join('|',
+        map { qr/$_/ } grep($_, Bugzilla->params->{'urlbase'}, 
+                            Bugzilla->params->{'sslbase'})) . ')';
+    $text =~ s~\b(${urlbase_re}\Qshow_bug.cgi?id=\E([0-9]+)(\#c([0-9]+))?)\b
+              ~($things[$count++] = get_bug_link($3, $1, { comment_num => $5, user => $user })) &&
+               ("\0\0" . ($count-1) . "\0\0")
+              ~egox;
+
+    # non-mailto protocols
+    my $safe_protocols = SAFE_URL_REGEXP();
+    $text =~ s~\b($safe_protocols)
+              ~($tmp = html_quote($1)) &&
+               ($things[$count++] = "<a href=\"$tmp\">$tmp</a>") &&
+               ("\0\0" . ($count-1) . "\0\0")
+              ~egox;
+
+    # We have to quote now, otherwise the html itself is escaped
+    # THIS MEANS THAT A LITERAL ", <, >, ' MUST BE ESCAPED FOR A MATCH
+
+    $text = html_quote($text);
+
+    # Color quoted text
+    $text =~ s~^(&gt;.+)$~<span class="quote">$1</span >~mg;
+    $text =~ s~</span >\n<span class="quote">~\n~g;
+
+    # mailto:
+    # Use |<nothing> so that $1 is defined regardless
+    # &#64; is the encoded '@' character.
+    $text =~ s~\b(mailto:|)?([\w\.\-\+\=]+&\#64;[\w\-]+(?:\.[\w\-]+)+)\b
+              ~<a href=\"mailto:$2\">$1$2</a>~igx;
+
+    # attachment links
+    $text =~ s~\b(attachment\s*\#?\s*(\d+)(?:\s+\[details\])?)
+              ~($things[$count++] = get_attachment_link($2, $1, $user)) &&
+               ("\0\0" . ($count-1) . "\0\0")
+              ~egmxi;
+
+    # Current bug ID this comment belongs to
+    my $current_bugurl = $bug ? ("show_bug.cgi?id=" . $bug->id) : "";
+
+    # This handles bug a, comment b type stuff. Because we're using /g
+    # we have to do this in one pattern, and so this is semi-messy.
+    # Also, we can't use $bug_re?$comment_re? because that will match the
+    # empty string
+    my $bug_word = template_var('terms')->{bug};
+    my $bug_re = qr/\Q$bug_word\E\s*\#?\s*(\d+)/i;
+    my $comment_re = qr/comment\s*\#?\s*(\d+)/i;
+    $text =~ s~\b($bug_re(?:\s*,?\s*$comment_re)?|$comment_re)
+              ~ # We have several choices. $1 here is the link, and $2-4 are set
+                # depending on which part matched
+               (defined($2) ? get_bug_link($2, $1, { comment_num => $3, user => $user }) :
+                              "<a href=\"$current_bugurl#c$4\">$1</a>")
+              ~egox;
+
+    # Old duplicate markers. These don't use $bug_word because they are old
+    # and were never customizable.
+    $text =~ s~(?<=^\*\*\*\ This\ bug\ has\ been\ marked\ as\ a\ duplicate\ of\ )
+               (\d+)
+               (?=\ \*\*\*\Z)
+              ~get_bug_link($1, $1, { user => $user })
+              ~egmx;
+
+    # Now remove the encoding hacks in reverse order
+    for (my $i = $#things; $i >= 0; $i--) {
+        $text =~ s/\0\0($i)\0\0/$things[$i]/eg;
+    }
+    $text =~ s/$chr1\0/\0/g;
+
+    return $text;
+}
+
+# Creates a link to an attachment, including its title.
+sub get_attachment_link {
+    my ($attachid, $link_text, $user) = @_;
+    my $dbh = Bugzilla->dbh;
+    $user ||= Bugzilla->user;
+
+    my $attachment = new Bugzilla::Attachment($attachid);
+
+    if ($attachment) {
+        my $title = "";
+        my $className = "";
+        if ($user->can_see_bug($attachment->bug_id)
+            && (!$attachment->isprivate || $user->is_insider))
+        {
+            $title = $attachment->description;
+        }
+        if ($attachment->isobsolete) {
+            $className = "bz_obsolete";
+        }
+        # Prevent code injection in the title.
+        $title = html_quote(clean_text($title));
+
+        $link_text =~ s/ \[details\]$//;
+        my $linkval = "attachment.cgi?id=$attachid";
+
+        # If the attachment is a patch, try to link to the diff rather
+        # than the text, by default.
+        my $patchlink = "";
+        if ($attachment->ispatch and Bugzilla->feature('patch_viewer')) {
+            $patchlink = '&amp;action=diff';
+        }
+
+        # Whitespace matters here because these links are in <pre> tags.
+        return qq|<span class="$className">|
+               . qq|<a href="${linkval}${patchlink}" name="attach_${attachid}" title="$title">$link_text</a>|
+               . qq| <a href="${linkval}&amp;action=edit" title="$title">[details]</a>|
+               . qq|</span>|;
+    }
+    else {
+        return qq{$link_text};
+    }
+}
+
+# Creates a link to a bug, including its title.
+# It takes either two or three parameters:
+#  - The bug number
+#  - The link text, to place between the <a>..</a>
+#  - An optional comment number, for linking to a particular
+#    comment in the bug
+
+sub get_bug_link {
+    my ($bug, $link_text, $options) = @_;
+    $options ||= {};
+    $options->{user} ||= Bugzilla->user;
+    my $dbh = Bugzilla->dbh;
+
+    if (defined $bug) {
+        if (!blessed($bug)) {
+            require Bugzilla::Bug;
+            $bug = new Bugzilla::Bug($bug);
+        }
+        return $link_text if $bug->{error};
+    }
+
+    my $template = Bugzilla->template_inner;
+    my $linkified;
+    $template->process('bug/link.html.tmpl', 
+        { bug => $bug, link_text => $link_text, %$options }, \$linkified);
+    return $linkified;
+}
+
+# We use this instead of format because format doesn't deal well with
+# multi-byte languages.
+sub multiline_sprintf {
+    my ($format, $args, $sizes) = @_;
+    my @parts;
+    my @my_sizes = @$sizes; # Copy this so we don't modify the input array.
+    foreach my $string (@$args) {
+        my $size = shift @my_sizes;
+        my @pieces = split("\n", wrap_hard($string, $size));
+        push(@parts, \@pieces);
+    }
+
+    my $formatted;
+    while (1) {
+        # Get the first item of each part.
+        my @line = map { shift @$_ } @parts;
+        # If they're all undef, we're done.
+        last if !grep { defined $_ } @line;
+        # Make any single undef item into ''
+        @line = map { defined $_ ? $_ : '' } @line;
+        # And append a formatted line
+        $formatted .= sprintf($format, @line);
+        # Remove trailing spaces, or they become lots of =20's in
+        # quoted-printable emails.
+        $formatted =~ s/\s+$//;
+        $formatted .= "\n";
+    }
+    return $formatted;
+}
+
+#####################
+# Header Generation #
+#####################
+
+# Returns the last modification time of a file, as an integer number of
+# seconds since the epoch.
+sub _mtime { return (stat($_[0]))[9] }
+
+sub mtime_filter {
+    my ($file_url, $mtime) = @_;
+    # This environment var is set in the .htaccess if we have mod_headers
+    # and mod_expires installed, to make sure that JS and CSS with "?"
+    # after them will still be cached by clients.
+    return $file_url if !$ENV{BZ_CACHE_CONTROL};
+    if (!$mtime) {
+        my $cgi_path = bz_locations()->{'cgi_path'};
+        my $file_path = "$cgi_path/$file_url";
+        $mtime = _mtime($file_path);
+    }
+    return "$file_url?$mtime";
+}
+
+# Set up the skin CSS cascade:
+#
+#  1. YUI CSS
+#  2. Standard Bugzilla stylesheet set (persistent)
+#  3. Third-party "skin" stylesheet set, per user prefs (persistent)
+#  4. Page-specific styles
+#  5. Custom Bugzilla stylesheet set (persistent)
+
+sub css_files {
+    my ($style_urls, $yui, $yui_css) = @_;
+    
+    # global.css goes on every page, and so does IE-fixes.css.
+    my @requested_css = ('skins/standard/global.css', @$style_urls,
+                         'skins/standard/IE-fixes.css');
+
+    my @yui_required_css;
+    foreach my $yui_name (@$yui) {
+        next if !$yui_css->{$yui_name};
+        push(@yui_required_css, "js/yui/assets/skins/sam/$yui_name.css");
+    }
+    unshift(@requested_css, @yui_required_css);
+    
+    my @css_sets = map { _css_link_set($_) } @requested_css;
+    
+    my %by_type = (standard => [], skin => [], custom => []);
+    foreach my $set (@css_sets) {
+        foreach my $key (keys %$set) {
+            push(@{ $by_type{$key} }, $set->{$key});
+        }
+    }
+    
+    return \%by_type;
+}
+
+sub _css_link_set {
+    my ($file_name) = @_;
+
+    my %set = (standard => mtime_filter($file_name));
+    
+    # We use (^|/) to allow Extensions to use the skins system if they
+    # want.
+    if ($file_name !~ m{(^|/)skins/standard/}) {
+        return \%set;
+    }
+
+    my $skin = Bugzilla->user->settings->{skin}->{value};
+    my $cgi_path = bz_locations()->{'cgi_path'};
+    my $skin_file_name = $file_name;
+    $skin_file_name =~ s{(^|/)skins/standard/}{skins/contrib/$skin/};
+    if (my $mtime = _mtime("$cgi_path/$skin_file_name")) {
+        $set{skin} = mtime_filter($skin_file_name, $mtime);
+    }
+
+    my $custom_file_name = $file_name;
+    $custom_file_name =~ s{(^|/)skins/standard/}{skins/custom/};
+    if (my $custom_mtime = _mtime("$cgi_path/$custom_file_name")) {
+        $set{custom} = mtime_filter($custom_file_name, $custom_mtime);
+    }
+    
+    return \%set;
+}
+
+# YUI dependency resolution
+sub yui_resolve_deps {
+    my ($yui, $yui_deps) = @_;
+    
+    my @yui_resolved;
+    foreach my $yui_name (@$yui) {
+        my $deps = $yui_deps->{$yui_name} || [];
+        foreach my $dep (reverse @$deps) {
+            push(@yui_resolved, $dep) if !grep { $_ eq $dep } @yui_resolved;
+        }
+        push(@yui_resolved, $yui_name) if !grep { $_ eq $yui_name } @yui_resolved;
+    }
+    return \@yui_resolved;
+}
+
+###############################################################################
+# Templatization Code
+
+# The Template Toolkit throws an error if a loop iterates >1000 times.
+# We want to raise that limit.
+# NOTE: If you change this number, you MUST RE-RUN checksetup.pl!!!
+# If you do not re-run checksetup.pl, the change you make will not apply
+$Template::Directive::WHILE_MAX = 1000000;
+
+# Use the Toolkit Template's Stash module to add utility pseudo-methods
+# to template variables.
+use Template::Stash;
+
+# Allow keys to start with an underscore or a dot.
+$Template::Stash::PRIVATE = undef;
+
+# Add "contains***" methods to list variables that search for one or more 
+# items in a list and return boolean values representing whether or not 
+# one/all/any item(s) were found.
+$Template::Stash::LIST_OPS->{ contains } =
+  sub {
+      my ($list, $item) = @_;
+      if (ref $item && $item->isa('Bugzilla::Object')) {
+          return grep($_->id == $item->id, @$list);
+      } else {
+          return grep($_ eq $item, @$list);
+      }
+  };
+
+$Template::Stash::LIST_OPS->{ containsany } =
+  sub {
+      my ($list, $items) = @_;
+      foreach my $item (@$items) { 
+          if (ref $item && $item->isa('Bugzilla::Object')) {
+              return 1 if grep($_->id == $item->id, @$list);
+          } else {
+              return 1 if grep($_ eq $item, @$list);
+          }
+      }
+      return 0;
+  };
+
+# Clone the array reference to leave the original one unaltered.
+$Template::Stash::LIST_OPS->{ clone } =
+  sub {
+      my $list = shift;
+      return [@$list];
+  };
+
+# Allow us to still get the scalar if we use the list operation ".0" on it,
+# as we often do for defaults in query.cgi and other places.
+$Template::Stash::SCALAR_OPS->{ 0 } = 
+  sub {
+      return $_[0];
+  };
+
+# Add a "truncate" method to the Template Toolkit's "scalar" object
+# that truncates a string to a certain length.
+$Template::Stash::SCALAR_OPS->{ truncate } = 
+  sub {
+      my ($string, $length, $ellipsis) = @_;
+      $ellipsis ||= "";
+      
+      return $string if !$length || length($string) <= $length;
+      
+      my $strlen = $length - length($ellipsis);
+      my $newstr = substr($string, 0, $strlen) . $ellipsis;
+      return $newstr;
+  };
+
+# Create the template object that processes templates and specify
+# configuration parameters that apply to all templates.
+
+###############################################################################
+
+sub process {
+    my $self = shift;
+    # All of this current_langs stuff allows template_inner to correctly
+    # determine what-language Template object it should instantiate.
+    my $current_langs = Bugzilla->request_cache->{template_current_lang} ||= [];
+    unshift(@$current_langs, $self->context->{bz_language});
+    my $retval = $self->SUPER::process(@_);
+    shift @$current_langs;
+    return $retval;
+}
+
+# Construct the Template object
+
+# Note that all of the failure cases here can't use templateable errors,
+# since we won't have a template to use...
+
+sub create {
+    my $class = shift;
+    my %opts = @_;
+
+    # IMPORTANT - If you make any FILTER changes here, make sure to
+    # make them in t/004.template.t also, if required.
+
+    my $config = {
+        # Colon-separated list of directories containing templates.
+        INCLUDE_PATH => $opts{'include_path'} 
+                        || _include_path($opts{'language'}),
+
+        # Remove white-space before template directives (PRE_CHOMP) and at the
+        # beginning and end of templates and template blocks (TRIM) for better
+        # looking, more compact content.  Use the plus sign at the beginning
+        # of directives to maintain white space (i.e. [%+ DIRECTIVE %]).
+        PRE_CHOMP => 1,
+        TRIM => 1,
+
+        # Bugzilla::Template::Plugin::Hook uses the absolute (in mod_perl)
+        # or relative (in mod_cgi) paths of hook files to explicitly compile
+        # a specific file. Also, these paths may be absolute at any time
+        # if a packager has modified bz_locations() to contain absolute
+        # paths.
+        ABSOLUTE => 1,
+        RELATIVE => $ENV{MOD_PERL} ? 0 : 1,
+
+        COMPILE_DIR => bz_locations()->{'template_cache'},
+
+        # Don't check for a template update until 1 hour has passed since the
+        # last check.
+        STAT_TTL    => 60 * 60,
+
+        # Initialize templates (f.e. by loading plugins like Hook).
+        PRE_PROCESS => ["global/variables.none.tmpl"],
+
+        ENCODING => Bugzilla->params->{'utf8'} ? 'UTF-8' : undef,
+
+        # Functions for processing text within templates in various ways.
+        # IMPORTANT!  When adding a filter here that does not override a
+        # built-in filter, please also add a stub filter to t/004template.t.
+        FILTERS => {
+
+            # Render text in required style.
+
+            inactive => [
+                sub {
+                    my($context, $isinactive) = @_;
+                    return sub {
+                        return $isinactive ? '<span class="bz_inactive">'.$_[0].'</span>' : $_[0];
+                    }
+                }, 1
+            ],
+
+            closed => [
+                sub {
+                    my($context, $isclosed) = @_;
+                    return sub {
+                        return $isclosed ? '<span class="bz_closed">'.$_[0].'</span>' : $_[0];
+                    }
+                }, 1
+            ],
+
+            obsolete => [
+                sub {
+                    my($context, $isobsolete) = @_;
+                    return sub {
+                        return $isobsolete ? '<span class="bz_obsolete">'.$_[0].'</span>' : $_[0];
+                    }
+                }, 1
+            ],
+
+            # Returns the text with backslashes, single/double quotes,
+            # and newlines/carriage returns escaped for use in JS strings.
+            js => sub {
+                my ($var) = @_;
+                $var =~ s/([\\\'\"\/])/\\$1/g;
+                $var =~ s/\n/\\n/g;
+                $var =~ s/\r/\\r/g;
+                $var =~ s/\@/\\x40/g; # anti-spam for email addresses
+                $var =~ s/</\\x3c/g;
+                $var =~ s/>/\\x3e/g;
+                return $var;
+            },
+            
+            # Converts data to base64
+            base64 => sub {
+                my ($data) = @_;
+                return encode_base64($data);
+            },
+            
+            # HTML collapses newlines in element attributes to a single space,
+            # so form elements which may have whitespace (ie comments) need
+            # to be encoded using &#013;
+            # See bugs 4928, 22983 and 32000 for more details
+            html_linebreak => sub {
+                my ($var) = @_;
+                $var = html_quote($var);
+                $var =~ s/\r\n/\&#013;/g;
+                $var =~ s/\n\r/\&#013;/g;
+                $var =~ s/\r/\&#013;/g;
+                $var =~ s/\n/\&#013;/g;
+                return $var;
+            },
+
+            # Prevents line break on hyphens and whitespaces.
+            no_break => sub {
+                my ($var) = @_;
+                $var =~ s/ /\&nbsp;/g;
+                $var =~ s/-/\&#8209;/g;
+                return $var;
+            },
+
+            xml => \&Bugzilla::Util::xml_quote ,
+
+            # This filter is similar to url_quote but used a \ instead of a %
+            # as prefix. In addition it replaces a ' ' by a '_'.
+            css_class_quote => \&Bugzilla::Util::css_class_quote ,
+
+            # Removes control characters and trims extra whitespace.
+            clean_text => \&Bugzilla::Util::clean_text ,
+
+            quoteUrls => [ sub {
+                               my ($context, $bug, $comment, $user) = @_;
+                               return sub {
+                                   my $text = shift;
+                                   return quoteUrls($text, $bug, $comment, $user);
+                               };
+                           },
+                           1
+                         ],
+
+            bug_link => [ sub {
+                              my ($context, $bug, $options) = @_;
+                              return sub {
+                                  my $text = shift;
+                                  return get_bug_link($bug, $text, $options);
+                              };
+                          },
+                          1
+                        ],
+
+            bug_list_link => sub {
+                my ($buglist, $options) = @_;
+                return join(", ", map(get_bug_link($_, $_, $options), split(/ *, */, $buglist)));
+            },
+
+            # In CSV, quotes are doubled, and any value containing a quote or a
+            # comma is enclosed in quotes.
+            csv => sub
+            {
+                my ($var) = @_;
+                $var =~ s/\"/\"\"/g;
+                if ($var !~ /^-?(\d+\.)?\d*$/) {
+                    $var = "\"$var\"";
+                }
+                return $var;
+            } ,
+
+            # Format a filesize in bytes to a human readable value
+            unitconvert => sub
+            {
+                my ($data) = @_;
+                my $retval = "";
+                my %units = (
+                    'KB' => 1024,
+                    'MB' => 1024 * 1024,
+                    'GB' => 1024 * 1024 * 1024,
+                );
+
+                if ($data < 1024) {
+                    return "$data bytes";
+                } 
+                else {
+                    my $u;
+                    foreach $u ('GB', 'MB', 'KB') {
+                        if ($data >= $units{$u}) {
+                            return sprintf("%.2f %s", $data/$units{$u}, $u);
+                        }
+                    }
+                }
+            },
+
+            # Format a time for display (more info in Bugzilla::Util)
+            time => [ sub {
+                          my ($context, $format, $timezone) = @_;
+                          return sub {
+                              my $time = shift;
+                              return format_time($time, $format, $timezone);
+                          };
+                      },
+                      1
+                    ],
+
+            html => \&Bugzilla::Util::html_quote,
+
+            html_light => \&Bugzilla::Util::html_light_quote,
+
+            email => \&Bugzilla::Util::email_filter,
+            
+            mtime => \&mtime_filter,
+
+            # iCalendar contentline filter
+            ics => [ sub {
+                         my ($context, @args) = @_;
+                         return sub {
+                             my ($var) = shift;
+                             my ($par) = shift @args;
+                             my ($output) = "";
+
+                             $var =~ s/[\r\n]/ /g;
+                             $var =~ s/([;\\\",])/\\$1/g;
+
+                             if ($par) {
+                                 $output = sprintf("%s:%s", $par, $var);
+                             } else {
+                                 $output = $var;
+                             }
+                             
+                             $output =~ s/(.{75,75})/$1\n /g;
+
+                             return $output;
+                         };
+                     },
+                     1
+                     ],
+
+            # Note that using this filter is even more dangerous than
+            # using "none," and you should only use it when you're SURE
+            # the output won't be displayed directly to a web browser.
+            txt => sub {
+                my ($var) = @_;
+                # Trivial HTML tag remover
+                $var =~ s/<[^>]*>//g;
+                # And this basically reverses the html filter.
+                $var =~ s/\&#64;/@/g;
+                $var =~ s/\&lt;/</g;
+                $var =~ s/\&gt;/>/g;
+                $var =~ s/\&quot;/\"/g;
+                $var =~ s/\&amp;/\&/g;
+                # Now remove extra whitespace...
+                my $collapse_filter = $Template::Filters::FILTERS->{collapse};
+                $var = $collapse_filter->($var);
+                # And if we're not in the WebService, wrap the message.
+                # (Wrapping the message in the WebService is unnecessary
+                # and causes awkward things like \n's appearing in error
+                # messages in JSON-RPC.)
+                unless (Bugzilla->usage_mode == USAGE_MODE_JSON
+                        or Bugzilla->usage_mode == USAGE_MODE_XMLRPC)
+                {
+                    $var = wrap_comment($var, 72);
+                }
+                $var =~ s/\&nbsp;/ /g;
+
+                return $var;
+            },
+
+            # Wrap a displayed comment to the appropriate length
+            wrap_comment => [
+                sub {
+                    my ($context, $cols) = @_;
+                    return sub { wrap_comment($_[0], $cols) }
+                }, 1],
+
+            # We force filtering of every variable in key security-critical
+            # places; we have a none filter for people to use when they 
+            # really, really don't want a variable to be changed.
+            none => sub { return $_[0]; } ,
+        },
+
+        PLUGIN_BASE => 'Bugzilla::Template::Plugin',
+
+        CONSTANTS => _load_constants(),
+
+        # Default variables for all templates
+        VARIABLES => {
+            # Function for retrieving global parameters.
+            'Param' => sub { return Bugzilla->params->{$_[0]}; },
+
+            # Function to create date strings
+            'time2str' => \&Date::Format::time2str,
+
+            # Fixed size column formatting for bugmail.
+            'format_columns' => sub {
+                my $cols = shift;
+                my $format = ($cols == 3) ? FORMAT_TRIPLE : FORMAT_DOUBLE;
+                my $col_size = ($cols == 3) ? FORMAT_3_SIZE : FORMAT_2_SIZE;
+                return multiline_sprintf($format, \@_, $col_size);
+            },
+
+            # Generic linear search function
+            'lsearch' => sub {
+                my ($array, $item) = @_;
+                return firstidx { $_ eq $item } @$array;
+            },
+
+            # Currently logged in user, if any
+            # If an sudo session is in progress, this is the user we're faking
+            'user' => sub { return Bugzilla->user; },
+
+            # Currenly active language
+            'current_language' => sub { return Bugzilla->current_language; },
+
+            # If an sudo session is in progress, this is the user who
+            # started the session.
+            'sudoer' => sub { return Bugzilla->sudoer; },
+
+            # Allow templates to access the "corect" URLBase value
+            'urlbase' => sub { return Bugzilla::Util::correct_urlbase(); },
+
+            # Allow templates to access docs url with users' preferred language
+            'docs_urlbase' => sub { 
+                my $language = Bugzilla->current_language;
+                my $docs_urlbase = Bugzilla->params->{'docs_urlbase'};
+                $docs_urlbase =~ s/\%lang\%/$language/;
+                return $docs_urlbase;
+            },
+
+            # Check whether the URL is safe.
+            'is_safe_url' => sub {
+                my $url = shift;
+                return 0 unless $url;
+
+                my $safe_url_regexp = SAFE_URL_REGEXP();
+                return 1 if $url =~ /^$safe_url_regexp$/;
+                # Pointing to a local file with no colon in its name is fine.
+                return 1 if $url =~ /^[^\s<>\":]+[\w\/]$/i;
+                # If we come here, then we cannot guarantee it's safe.
+                return 0;
+            },
+
+            # Allow templates to generate a token themselves.
+            'issue_hash_token' => \&Bugzilla::Token::issue_hash_token,
+
+            # A way for all templates to get at Field data, cached.
+            'bug_fields' => sub {
+                my $cache = Bugzilla->request_cache;
+                $cache->{template_bug_fields} ||=
+                    Bugzilla->fields({ by_name => 1 });
+                return $cache->{template_bug_fields};
+            },
+
+            # A general purpose cache to store rendered templates for reuse.
+            # Make sure to not mix language-specific data.
+            'template_cache' => sub {
+                my $cache = Bugzilla->request_cache->{template_cache} ||= {};
+                $cache->{users} ||= {};
+                return $cache;
+            },
+
+            'css_files' => \&css_files,
+            yui_resolve_deps => \&yui_resolve_deps,
+
+            # Whether or not keywords are enabled, in this Bugzilla.
+            'use_keywords' => sub { return Bugzilla::Keyword->any_exist; },
+
+            # All the keywords.
+            'all_keywords' => sub {
+                return [map { $_->name } Bugzilla::Keyword->get_all()];
+            },
+
+            'feature_enabled' => sub { return Bugzilla->feature(@_); },
+
+            # field_descs can be somewhat slow to generate, so we generate
+            # it only once per-language no matter how many times
+            # $template->process() is called.
+            'field_descs' => sub { return template_var('field_descs') },
+
+            # Calling bug/field-help.none.tmpl once per label is very
+            # expensive, so we generate it once per-language.
+            'help_html' => sub { return template_var('help_html') },
+
+            # This way we don't have to load field-descs.none.tmpl in
+            # many templates.
+            'display_value' => \&Bugzilla::Util::display_value,
+
+            'install_string' => \&Bugzilla::Install::Util::install_string,
+
+            'report_columns' => \&Bugzilla::Search::REPORT_COLUMNS,
+
+            # These don't work as normal constants.
+            DB_MODULE        => \&Bugzilla::Constants::DB_MODULE,
+            REQUIRED_MODULES => 
+                \&Bugzilla::Install::Requirements::REQUIRED_MODULES,
+            OPTIONAL_MODULES => sub {
+                my @optional = @{OPTIONAL_MODULES()};
+                foreach my $item (@optional) {
+                    my @features;
+                    foreach my $feat_id (@{ $item->{feature} }) {
+                        push(@features, install_string("feature_$feat_id"));
+                    }
+                    $item->{feature} = \@features;
+                }
+                return \@optional;
+            },
+            'default_authorizer' => sub { return Bugzilla::Auth->new() },
+        },
+    };
+    # Use a per-process provider to cache compiled templates in memory across
+    # requests.
+    my $provider_key = join(':', @{ $config->{INCLUDE_PATH} });
+    my $shared_providers = Bugzilla->process_cache->{shared_providers} ||= {};
+    $shared_providers->{$provider_key} ||= Template::Provider->new($config);
+    $config->{LOAD_TEMPLATES} = [ $shared_providers->{$provider_key} ];
+
+    local $Template::Config::CONTEXT = 'Bugzilla::Template::Context';
+
+    Bugzilla::Hook::process('template_before_create', { config => $config });
+    my $template = $class->new($config) 
+        || die("Template creation failed: " . $class->error());
+
+    # Pass on our current language to any template hooks or inner templates
+    # called by this Template object.
+    $template->context->{bz_language} = $opts{language} || '';
+
+    return $template;
+}
+
+# Used as part of the two subroutines below.
+our %_templates_to_precompile;
+sub precompile_templates {
+    my ($output) = @_;
+
+    # Remove the compiled templates.
+    my $cache_dir = bz_locations()->{'template_cache'};
+    my $datadir = bz_locations()->{'datadir'};
+    if (-e $cache_dir) {
+        print install_string('template_removing_dir') . "\n" if $output;
+
+        # This frequently fails if the webserver made the files, because
+        # then the webserver owns the directories.
+        rmtree($cache_dir);
+
+        # Check that the directory was really removed, and if not, move it
+        # into data/deleteme/.
+        if (-e $cache_dir) {
+            my $deleteme = "$datadir/deleteme";
+            
+            print STDERR "\n\n",
+                install_string('template_removal_failed', 
+                               { deleteme => $deleteme, 
+                                 template_cache => $cache_dir }), "\n\n";
+            mkpath($deleteme);
+            my $random = generate_random_password();
+            rename($cache_dir, "$deleteme/$random")
+              or die "move failed: $!";
+        }
+    }
+
+    print install_string('template_precompile') if $output;
+
+    # Pre-compile all available languages.
+    my $paths = template_include_path({ language => Bugzilla->languages });
+
+    foreach my $dir (@$paths) {
+        my $template = Bugzilla::Template->create(include_path => [$dir]);
+
+        %_templates_to_precompile = ();
+        # Traverse the template hierarchy.
+        find({ wanted => \&_precompile_push, no_chdir => 1 }, $dir);
+        # The sort isn't totally necessary, but it makes debugging easier
+        # by making the templates always be compiled in the same order.
+        foreach my $file (sort keys %_templates_to_precompile) {
+            $file =~ s{^\Q$dir\E/}{};
+            # Compile the template but throw away the result. This has the side-
+            # effect of writing the compiled version to disk.
+            $template->context->template($file);
+        }
+
+        # Clear out the cached Provider object
+        Bugzilla->process_cache->{shared_providers} = undef;
+    }
+
+    # Under mod_perl, we look for templates using the absolute path of the
+    # template directory, which causes Template Toolkit to look for their 
+    # *compiled* versions using the full absolute path under the data/template
+    # directory. (Like data/template/var/www/html/bugzilla/.) To avoid
+    # re-compiling templates under mod_perl, we symlink to the
+    # already-compiled templates. This doesn't work on Windows.
+    if (!ON_WINDOWS) {
+        # We do these separately in case they're in different locations.
+        _do_template_symlink(bz_locations()->{'templatedir'});
+        _do_template_symlink(bz_locations()->{'extensionsdir'});
+    }
+
+    # If anything created a Template object before now, clear it out.
+    delete Bugzilla->request_cache->{template};
+
+    print install_string('done') . "\n" if $output;
+}
+
+# Helper for precompile_templates
+sub _precompile_push {
+    my $name = $File::Find::name;
+    return if (-d $name);
+    return if ($name =~ /\/CVS\//);
+    return if ($name !~ /\.tmpl$/);
+    $_templates_to_precompile{$name} = 1;
+}
+
+# Helper for precompile_templates
+sub _do_template_symlink {
+    my $dir_to_symlink = shift;
+
+    my $abs_path = abs_path($dir_to_symlink);
+
+    # If $dir_to_symlink is already an absolute path (as might happen
+    # with packagers who set $libpath to an absolute path), then we don't
+    # need to do this symlink.
+    return if ($abs_path eq $dir_to_symlink);
+
+    my $abs_root  = dirname($abs_path);
+    my $dir_name  = basename($abs_path);
+    my $cache_dir   = bz_locations()->{'template_cache'};
+    my $container = "$cache_dir$abs_root";
+    mkpath($container);
+    my $target = "$cache_dir/$dir_name";
+    # Check if the directory exists, because if there are no extensions,
+    # there won't be an "data/template/extensions" directory to link to.
+    if (-d $target) {
+        # We use abs2rel so that the symlink will look like 
+        # "../../../../template" which works, while just 
+        # "data/template/template/" doesn't work.
+        my $relative_target = File::Spec->abs2rel($target, $container);
+
+        my $link_name = "$container/$dir_name";
+        symlink($relative_target, $link_name)
+          or warn "Could not make $link_name a symlink to $relative_target: $!";
+    }
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Template - Wrapper around the Template Toolkit C<Template> object
+
+=head1 SYNOPSIS
+
+  my $template = Bugzilla::Template->create;
+  my $format = $template->get_format("foo/bar",
+                                     scalar($cgi->param('format')),
+                                     scalar($cgi->param('ctype')));
+
+=head1 DESCRIPTION
+
+This is basically a wrapper so that the correct arguments get passed into
+the C<Template> constructor.
+
+It should not be used directly by scripts or modules - instead, use
+C<Bugzilla-E<gt>instance-E<gt>template> to get an already created module.
+
+=head1 SUBROUTINES
+
+=over
+
+=item C<precompile_templates($output)>
+
+Description: Compiles all of Bugzilla's templates in every language.
+             Used mostly by F<checksetup.pl>.
+
+Params:      C<$output> - C<true> if you want the function to print
+               out information about what it's doing.
+
+Returns:     nothing
+
+=back
+
+=head1 METHODS
+
+=over
+
+=item C<get_format($file, $format, $ctype)>
+
+ Description: Construct a format object from URL parameters.
+
+ Params:      $file   - Name of the template to display.
+              $format - When the template exists under several formats
+                        (e.g. table or graph), specify the one to choose.
+              $ctype  - Content type, see Bugzilla::Constants::contenttypes.
+
+ Returns:     A format object.
+
+=back
+
+=head1 SEE ALSO
+
+L<Bugzilla>, L<Template>

diff --git a/Bugzilla/Template/Context.pm b/Bugzilla/Template/Context.pm
new file mode 100644 (file)
index 0000000..9dc1f08
--- /dev/null
+++ b/Bugzilla/Template/Context.pm
@@ -0,0 +1,90 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# This exists to implement the template-before_process hook.
+package Bugzilla::Template::Context;
+use strict;
+use base qw(Template::Context);
+
+use Bugzilla::Hook;
+use Scalar::Util qw(blessed);
+
+sub process {
+    my $self = shift;
+    # We don't want to run the template_before_process hook for
+    # template hooks (but we do want it to run if a hook calls
+    # PROCESS inside itself). The problem is that the {component}->{name} of
+    # hooks is unreliable--sometimes it starts with ./ and it's the
+    # full path to the hook template, and sometimes it's just the relative
+    # name (like hook/global/field-descs-end.none.tmpl). Also, calling
+    # template_before_process for hook templates doesn't seem too useful,
+    # because that's already part of the extension and they should be able
+    # to modify their hook if they want (or just modify the variables in the
+    # calling template).
+    if (not delete $self->{bz_in_hook}) {
+        $self->{bz_in_process} = 1;
+    }
+    my $result = $self->SUPER::process(@_);
+    delete $self->{bz_in_process};
+    return $result;
+}
+
+# This method is called by Template-Toolkit exactly once per template or
+# block (look at a compiled template) so this is an ideal place for us to
+# modify the variables before a template or block runs.
+#
+# We don't do it during Context::process because at that time
+# our stash hasn't been set correctly--the parameters we were passed
+# in the PROCESS or INCLUDE directive haven't been set, and if we're
+# in an INCLUDE, the stash is not yet localized during process().
+sub stash {
+    my $self = shift;
+    my $stash = $self->SUPER::stash(@_);
+
+    my $name = $stash->{component}->{name};
+    my $pre_process = $self->config->{PRE_PROCESS};
+
+    # Checking bz_in_process tells us that we were indeed called as part of a
+    # Context::process, and not at some other point. 
+    #
+    # Checking $name makes sure that we're processing a file, and not just a
+    # block, by checking that the name has a period in it. We don't allow
+    # blocks because their names are too unreliable--an extension could have
+    # a block with the same name, or multiple files could have a same-named
+    # block, and then your extension would malfunction.
+    #
+    # We also make sure that we don't run, ever, during the PRE_PROCESS
+    # templates, because if somebody calls Throw*Error globally inside of
+    # template_before_process, that causes an infinite recursion into
+    # the PRE_PROCESS templates (because Bugzilla, while inside 
+    # global/intialize.none.tmpl, loads the template again to create the
+    # template object for Throw*Error).
+    #
+    # Checking Bugzilla::Hook::in prevents infinite recursion on this hook.
+    if ($self->{bz_in_process} and $name =~ /\./
+        and !grep($_ eq $name, @$pre_process)
+        and !Bugzilla::Hook::in('template_before_process'))
+    {
+        Bugzilla::Hook::process("template_before_process",
+                                { vars => $stash, context => $self,
+                                  file => $name });
+    }
+
+    # This prevents other calls to stash() that might somehow happen
+    # later in the file from also triggering the hook.
+    delete $self->{bz_in_process};
+
+    return $stash;
+}
+
+# We need a DESTROY sub for the same reason that Bugzilla::CGI does.
+sub DESTROY {
+    my $self = shift;
+    $self->SUPER::DESTROY(@_);
+};
+
+1;

diff --git a/Bugzilla/Template/Plugin/Bugzilla.pm b/Bugzilla/Template/Plugin/Bugzilla.pm
new file mode 100644 (file)
index 0000000..e2b59c7
--- /dev/null
+++ b/Bugzilla/Template/Plugin/Bugzilla.pm
@@ -0,0 +1,48 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Template::Plugin::Bugzilla;
+
+use strict;
+
+use base qw(Template::Plugin);
+
+use Bugzilla;
+
+sub new {
+    my ($class, $context) = @_;
+
+    return bless {}, $class;
+}
+
+sub AUTOLOAD {
+    my $class = shift;
+    our $AUTOLOAD;
+
+    $AUTOLOAD =~ s/^.*:://;
+
+    return if $AUTOLOAD eq 'DESTROY';
+
+    return Bugzilla->$AUTOLOAD(@_);
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Template::Plugin::Bugzilla
+
+=head1 DESCRIPTION
+
+Template Toolkit plugin to allow access to the persistent C<Bugzilla>
+object.
+
+=head1 SEE ALSO
+
+L<Bugzilla>, L<Template::Plugin>

diff --git a/Bugzilla/Template/Plugin/Hook.pm b/Bugzilla/Template/Plugin/Hook.pm
new file mode 100644 (file)
index 0000000..f1de7a6
--- /dev/null
+++ b/Bugzilla/Template/Plugin/Hook.pm
@@ -0,0 +1,148 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Template::Plugin::Hook;
+use strict;
+use base qw(Template::Plugin);
+
+use Bugzilla::Constants;
+use Bugzilla::Install::Util qw(template_include_path); 
+use Bugzilla::Util;
+use Bugzilla::Error;
+
+use File::Spec;
+
+sub new {
+    my ($class, $context) = @_;
+    return bless { _CONTEXT => $context }, $class;
+}
+
+sub _context { return $_[0]->{_CONTEXT} }
+
+sub process {
+    my ($self, $hook_name, $template) = @_;
+    my $context = $self->_context();
+    $template ||= $context->stash->{component}->{name};
+
+    # sanity check:
+    if (!$template =~ /[\w\.\/\-_\\]+/) {
+        ThrowCodeError('template_invalid', { name => $template });
+    }
+
+    my (undef, $path, $filename) = File::Spec->splitpath($template);
+    $path ||= '';
+    $filename =~ m/(.+)\.(.+)\.tmpl$/;
+    my $template_name = $1;
+    my $type = $2;
+
+    # Hooks are named like this:
+    my $extension_template = "$path$template_name-$hook_name.$type.tmpl";
+
+    # Get the hooks out of the cache if they exist. Otherwise, read them
+    # from the disk.
+    my $cache = Bugzilla->request_cache->{template_plugin_hook_cache} ||= {};
+    my $lang = $context->{bz_language} || '';
+    $cache->{"${lang}__$extension_template"} 
+        ||= $self->_get_hooks($extension_template);
+
+    # process() accepts an arrayref of templates, so we just pass the whole
+    # arrayref.
+    $context->{bz_in_hook} = 1; # See Bugzilla::Template::Context
+    return $context->process($cache->{"${lang}__$extension_template"});
+}
+
+sub _get_hooks {
+    my ($self, $extension_template) = @_;
+
+    my $template_sets = $self->_template_hook_include_path();
+    my @hooks;
+    foreach my $dir_set (@$template_sets) {
+        foreach my $template_dir (@$dir_set) {
+            my $file = "$template_dir/hook/$extension_template";
+            if (-e $file) {
+                my $template = $self->_context->template($file);
+                push(@hooks, $template);
+                # Don't run the hook for more than one language.
+                last;
+            }
+        }
+    }
+
+    return \@hooks;
+}
+
+sub _template_hook_include_path {
+    my $self = shift;
+    my $cache = Bugzilla->request_cache;
+    my $language = $self->_context->{bz_language} || '';
+    my $cache_key = "template_plugin_hook_include_path_$language";
+    $cache->{$cache_key} ||= template_include_path({
+        language => $language,
+        hook     => 1,
+    });
+    return $cache->{$cache_key};
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Template::Plugin::Hook
+
+=head1 DESCRIPTION
+
+Template Toolkit plugin to process hooks added into templates by extensions.
+
+=head1 METHODS
+
+=over
+
+=item B<process>
+
+=over
+
+=item B<Description>
+
+Processes hooks added into templates by extensions.
+
+=item B<Params>
+
+=over
+
+=item C<hook_name>
+
+The unique name of the template hook.
+
+=item C<template> (optional)
+
+The path of the calling template.
+This is used as a work around to a bug which causes the path to the hook
+to be incorrect when the hook is called from inside a block.
+
+Example: If the hook C<lastrow> is added to the template
+F<show-multiple.html.tmpl> and it is desired to force the correct template
+path, the template hook would be:
+
+ [% Hook.process("lastrow", "bug/show-multiple.html.tmpl") %]
+
+=back
+
+=item B<Returns> 
+
+Output from processing template extension.
+
+=back
+
+=back
+
+=head1 SEE ALSO
+
+L<Template::Plugin>
+
+L<http://wiki.mozilla.org/Bugzilla:Writing_Extensions>

diff --git a/Bugzilla/Token.pm b/Bugzilla/Token.pm
new file mode 100644 (file)
index 0000000..264a28d
--- /dev/null
+++ b/Bugzilla/Token.pm
@@ -0,0 +1,604 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+################################################################################
+# Module Initialization
+################################################################################
+
+# Make it harder for us to do dangerous things in Perl.
+use strict;
+
+# Bundle the functions in this file together into the "Bugzilla::Token" package.
+package Bugzilla::Token;
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Mailer;
+use Bugzilla::Util;
+use Bugzilla::User;
+
+use Date::Format;
+use Date::Parse;
+use File::Basename;
+use Digest::SHA qw(hmac_sha256_base64);
+
+use base qw(Exporter);
+
+@Bugzilla::Token::EXPORT = qw(issue_session_token check_token_data delete_token
+                              issue_hash_token check_hash_token);
+
+################################################################################
+# Public Functions
+################################################################################
+
+# Creates and sends a token to create a new user account.
+# It assumes that the login has the correct format and is not already in use.
+sub issue_new_user_account_token {
+    my $login_name = shift;
+    my $dbh = Bugzilla->dbh;
+    my $template = Bugzilla->template;
+    my $vars = {};
+
+    # Is there already a pending request for this login name? If yes, do not throw
+    # an error because the user may have lost his email with the token inside.
+    # But to prevent using this way to mailbomb an email address, make sure
+    # the last request is old enough before sending a new email (default: 10 minutes).
+
+    my $pending_requests = $dbh->selectrow_array(
+        'SELECT COUNT(*)
+           FROM tokens
+          WHERE tokentype = ?
+                AND ' . $dbh->sql_istrcmp('eventdata', '?') . '
+                AND issuedate > '
+                    . $dbh->sql_date_math('NOW()', '-', ACCOUNT_CHANGE_INTERVAL, 'MINUTE'),
+        undef, ('account', $login_name));
+
+    ThrowUserError('too_soon_for_new_token', {'type' => 'account'}) if $pending_requests;
+
+    my ($token, $token_ts) = _create_token(undef, 'account', $login_name);
+
+    $vars->{'email'} = $login_name . Bugzilla->params->{'emailsuffix'};
+    $vars->{'expiration_ts'} = ctime($token_ts + MAX_TOKEN_AGE * 86400);
+    $vars->{'token'} = $token;
+
+    my $message;
+    $template->process('account/email/request-new.txt.tmpl', $vars, \$message)
+      || ThrowTemplateError($template->error());
+
+    # In 99% of cases, the user getting the confirmation email is the same one
+    # who made the request, and so it is reasonable to send the email in the same
+    # language used to view the "Create a New Account" page (we cannot use his
+    # user prefs as the user has no account yet!).
+    MessageToMTA($message);
+}
+
+sub IssueEmailChangeToken {
+    my ($user, $new_email) = @_;
+    my $email_suffix = Bugzilla->params->{'emailsuffix'};
+    my $old_email = $user->login;
+
+    my ($token, $token_ts) = _create_token($user->id, 'emailold', $old_email . ":" . $new_email);
+
+    my $newtoken = _create_token($user->id, 'emailnew', $old_email . ":" . $new_email);
+
+    # Mail the user the token along with instructions for using it.
+
+    my $template = Bugzilla->template_inner($user->setting('lang'));
+    my $vars = {};
+
+    $vars->{'oldemailaddress'} = $old_email . $email_suffix;
+    $vars->{'newemailaddress'} = $new_email . $email_suffix;
+    $vars->{'expiration_ts'} = ctime($token_ts + MAX_TOKEN_AGE * 86400);
+    $vars->{'token'} = $token;
+    $vars->{'emailaddress'} = $old_email . $email_suffix;
+
+    my $message;
+    $template->process("account/email/change-old.txt.tmpl", $vars, \$message)
+      || ThrowTemplateError($template->error());
+
+    MessageToMTA($message);
+
+    $vars->{'token'} = $newtoken;
+    $vars->{'emailaddress'} = $new_email . $email_suffix;
+
+    $message = "";
+    $template->process("account/email/change-new.txt.tmpl", $vars, \$message)
+      || ThrowTemplateError($template->error());
+
+    MessageToMTA($message);
+}
+
+# Generates a random token, adds it to the tokens table, and sends it
+# to the user with instructions for using it to change their password.
+sub IssuePasswordToken {
+    my $user = shift;
+    my $dbh = Bugzilla->dbh;
+
+    my $too_soon = $dbh->selectrow_array(
+        'SELECT 1 FROM tokens
+          WHERE userid = ? AND tokentype = ?
+                AND issuedate > ' 
+                    . $dbh->sql_date_math('NOW()', '-', ACCOUNT_CHANGE_INTERVAL, 'MINUTE'),
+        undef, ($user->id, 'password'));
+
+    ThrowUserError('too_soon_for_new_token', {'type' => 'password'}) if $too_soon;
+
+    my ($token, $token_ts) = _create_token($user->id, 'password', remote_ip());
+
+    # Mail the user the token along with instructions for using it.
+    my $template = Bugzilla->template_inner($user->setting('lang'));
+    my $vars = {};
+
+    $vars->{'token'} = $token;
+    $vars->{'emailaddress'} = $user->email;
+    $vars->{'expiration_ts'} = ctime($token_ts + MAX_TOKEN_AGE * 86400);
+    # The user is not logged in (else he wouldn't request a new password).
+    # So we have to pass this information to the template.
+    $vars->{'timezone'} = $user->timezone;
+
+    my $message = "";
+    $template->process("account/password/forgotten-password.txt.tmpl", 
+                                                               $vars, \$message)
+      || ThrowTemplateError($template->error());
+
+    MessageToMTA($message);
+}
+
+sub issue_session_token {
+    # Generates a random token, adds it to the tokens table, and returns
+    # the token to the caller.
+
+    my $data = shift;
+    return _create_token(Bugzilla->user->id, 'session', $data);
+}
+
+sub issue_hash_token {
+    my ($data, $time) = @_;
+    $data ||= [];
+    $time ||= time();
+
+    # For the user ID, use the actual ID if the user is logged in.
+    # Otherwise, use the remote IP, in case this is for something
+    # such as creating an account or logging in.
+    my $user_id = Bugzilla->user->id || remote_ip();
+
+    # The concatenated string is of the form
+    # token creation time + user ID (either ID or remote IP) + data
+    my @args = ($time, $user_id, @$data);
+
+    my $token = join('*', @args);
+    $token = hmac_sha256_base64($token, Bugzilla->localconfig->{'site_wide_secret'});
+    $token =~ s/\+/-/g;
+    $token =~ s/\//_/g;
+
+    # Prepend the token creation time, unencrypted, so that the token
+    # lifetime can be validated.
+    return $time . '-' . $token;
+}
+
+sub check_hash_token {
+    my ($token, $data) = @_;
+    $data ||= [];
+    my ($time, $expected_token);
+
+    if ($token) {
+        ($time, undef) = split(/-/, $token);
+        # Regenerate the token based on the information we have.
+        $expected_token = issue_hash_token($data, $time);
+    }
+
+    if (!$token
+        || $expected_token ne $token
+        || time() - $time > MAX_TOKEN_AGE * 86400)
+    {
+        my $template = Bugzilla->template;
+        my $vars = {};
+        $vars->{'script_name'} = basename($0);
+        $vars->{'token'} = issue_hash_token($data);
+        $vars->{'reason'} = (!$token) ?                   'missing_token' :
+                            ($expected_token ne $token) ? 'invalid_token' :
+                                                          'expired_token';
+        print Bugzilla->cgi->header();
+        $template->process('global/confirm-action.html.tmpl', $vars)
+          || ThrowTemplateError($template->error());
+        exit;
+    }
+
+    # If we come here, then the token is valid and not too old.
+    return 1;
+}
+
+sub CleanTokenTable {
+    my $dbh = Bugzilla->dbh;
+    $dbh->do('DELETE FROM tokens
+              WHERE ' . $dbh->sql_to_days('NOW()') . ' - ' .
+                        $dbh->sql_to_days('issuedate') . ' >= ?',
+              undef, MAX_TOKEN_AGE);
+}
+
+sub GenerateUniqueToken {
+    # Generates a unique random token.  Uses generate_random_password 
+    # for the tokens themselves and checks uniqueness by searching for
+    # the token in the "tokens" table.  Gives up if it can't come up
+    # with a token after about one hundred tries.
+    my ($table, $column) = @_;
+
+    my $token;
+    my $duplicate = 1;
+    my $tries = 0;
+    $table ||= "tokens";
+    $column ||= "token";
+
+    my $dbh = Bugzilla->dbh;
+    my $sth = $dbh->prepare("SELECT 1 FROM $table WHERE $column = ?");
+
+    while ($duplicate) {
+        ++$tries;
+        if ($tries > 100) {
+            ThrowCodeError("token_generation_error");
+        }
+        $token = generate_random_password();
+        $sth->execute($token);
+        $duplicate = $sth->fetchrow_array;
+    }
+    return $token;
+}
+
+# Cancels a previously issued token and notifies the user.
+# This should only happen when the user accidentally makes a token request
+# or when a malicious hacker makes a token request on behalf of a user.
+sub Cancel {
+    my ($token, $cancelaction, $vars) = @_;
+    my $dbh = Bugzilla->dbh;
+    $vars ||= {};
+
+    # Get information about the token being canceled.
+    trick_taint($token);
+    my ($issuedate, $tokentype, $eventdata, $userid) =
+        $dbh->selectrow_array('SELECT ' . $dbh->sql_date_format('issuedate') . ',
+                                      tokentype, eventdata, userid
+                                 FROM tokens
+                                WHERE token = ?',
+                                undef, $token);
+
+    # If we are canceling the creation of a new user account, then there
+    # is no entry in the 'profiles' table.
+    my $user = new Bugzilla::User($userid);
+
+    $vars->{'emailaddress'} = $userid ? $user->email : $eventdata;
+    $vars->{'remoteaddress'} = remote_ip();
+    $vars->{'token'} = $token;
+    $vars->{'tokentype'} = $tokentype;
+    $vars->{'issuedate'} = $issuedate;
+    # The user is probably not logged in.
+    # So we have to pass this information to the template.
+    $vars->{'timezone'} = $user->timezone;
+    $vars->{'eventdata'} = $eventdata;
+    $vars->{'cancelaction'} = $cancelaction;
+
+    # Notify the user via email about the cancellation.
+    my $template = Bugzilla->template_inner($user->setting('lang'));
+
+    my $message;
+    $template->process("account/cancel-token.txt.tmpl", $vars, \$message)
+      || ThrowTemplateError($template->error());
+
+    MessageToMTA($message);
+
+    # Delete the token from the database.
+    delete_token($token);
+}
+
+sub DeletePasswordTokens {
+    my ($userid, $reason) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    detaint_natural($userid);
+    my $tokens = $dbh->selectcol_arrayref('SELECT token FROM tokens
+                                           WHERE userid = ? AND tokentype = ?',
+                                           undef, ($userid, 'password'));
+
+    foreach my $token (@$tokens) {
+        Bugzilla::Token::Cancel($token, $reason);
+    }
+}
+
+# Returns an email change token if the user has one. 
+sub HasEmailChangeToken {
+    my $userid = shift;
+    my $dbh = Bugzilla->dbh;
+
+    my $token = $dbh->selectrow_array('SELECT token FROM tokens
+                                       WHERE userid = ?
+                                       AND (tokentype = ? OR tokentype = ?) ' .
+                                       $dbh->sql_limit(1),
+                                       undef, ($userid, 'emailnew', 'emailold'));
+    return $token;
+}
+
+# Returns the userid, issuedate and eventdata for the specified token
+sub GetTokenData {
+    my ($token) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    return unless defined $token;
+    $token = clean_text($token);
+    trick_taint($token);
+
+    return $dbh->selectrow_array(
+        "SELECT userid, " . $dbh->sql_date_format('issuedate') . ", eventdata, tokentype
+         FROM   tokens 
+         WHERE  token = ?", undef, $token);
+}
+
+# Deletes specified token
+sub delete_token {
+    my ($token) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    return unless defined $token;
+    trick_taint($token);
+
+    $dbh->do("DELETE FROM tokens WHERE token = ?", undef, $token);
+}
+
+# Given a token, makes sure it comes from the currently logged in user
+# and match the expected event. Returns 1 on success, else displays a warning.
+sub check_token_data {
+    my ($token, $expected_action, $alternate_script) = @_;
+    my $user = Bugzilla->user;
+    my $template = Bugzilla->template;
+    my $cgi = Bugzilla->cgi;
+
+    my ($creator_id, $date, $token_action) = GetTokenData($token);
+    unless ($creator_id
+            && $creator_id == $user->id
+            && $token_action eq $expected_action)
+    {
+        # Something is going wrong. Ask confirmation before processing.
+        # It is possible that someone tried to trick an administrator.
+        # In this case, we want to know his name!
+        require Bugzilla::User;
+
+        my $vars = {};
+        $vars->{'abuser'} = Bugzilla::User->new($creator_id)->identity;
+        $vars->{'token_action'} = $token_action;
+        $vars->{'expected_action'} = $expected_action;
+        $vars->{'script_name'} = basename($0);
+        $vars->{'alternate_script'} = $alternate_script || basename($0);
+
+        # Now is a good time to remove old tokens from the DB.
+        CleanTokenTable();
+
+        # If no token was found, create a valid token for the given action.
+        unless ($creator_id) {
+            $token = issue_session_token($expected_action);
+            $cgi->param('token', $token);
+        }
+
+        print $cgi->header();
+
+        $template->process('admin/confirm-action.html.tmpl', $vars)
+          || ThrowTemplateError($template->error());
+        exit;
+    }
+    return 1;
+}
+
+################################################################################
+# Internal Functions
+################################################################################
+
+# Generates a unique token and inserts it into the database
+# Returns the token and the token timestamp
+sub _create_token {
+    my ($userid, $tokentype, $eventdata) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    detaint_natural($userid) if defined $userid;
+    trick_taint($tokentype);
+    trick_taint($eventdata);
+
+    $dbh->bz_start_transaction();
+
+    my $token = GenerateUniqueToken();
+
+    $dbh->do("INSERT INTO tokens (userid, issuedate, token, tokentype, eventdata)
+        VALUES (?, NOW(), ?, ?, ?)", undef, ($userid, $token, $tokentype, $eventdata));
+
+    $dbh->bz_commit_transaction();
+
+    if (wantarray) {
+        my (undef, $token_ts, undef) = GetTokenData($token);
+        $token_ts = str2time($token_ts);
+        return ($token, $token_ts);
+    } else {
+        return $token;
+    }
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Token - Provides different routines to manage tokens.
+
+=head1 SYNOPSIS
+
+    use Bugzilla::Token;
+
+    Bugzilla::Token::issue_new_user_account_token($login_name);
+    Bugzilla::Token::IssueEmailChangeToken($user, $new_email);
+    Bugzilla::Token::IssuePasswordToken($user);
+    Bugzilla::Token::DeletePasswordTokens($user_id, $reason);
+    Bugzilla::Token::Cancel($token, $cancelaction, $vars);
+
+    Bugzilla::Token::CleanTokenTable();
+
+    my $token = issue_session_token($event);
+    check_token_data($token, $event)
+    delete_token($token);
+
+    my $token = Bugzilla::Token::GenerateUniqueToken($table, $column);
+    my $token = Bugzilla::Token::HasEmailChangeToken($user_id);
+    my ($token, $date, $data, $type) = Bugzilla::Token::GetTokenData($token);
+
+=head1 SUBROUTINES
+
+=over
+
+=item C<issue_new_user_account_token($login_name)>
+
+ Description: Creates and sends a token per email to the email address
+              requesting a new user account. It doesn't check whether
+              the user account already exists. The user will have to
+              use this token to confirm the creation of his user account.
+
+ Params:      $login_name - The new login name requested by the user.
+
+ Returns:     Nothing. It throws an error if the same user made the same
+              request in the last few minutes.
+
+=item C<sub IssueEmailChangeToken($user, $new_email)>
+
+ Description: Sends two distinct tokens per email to the old and new email
+              addresses to confirm the email address change for the given
+              user. These tokens remain valid for the next MAX_TOKEN_AGE days.
+
+ Params:      $user      - User object of the user requesting a new
+                           email address.
+              $new_email - The new email address of the user.
+
+ Returns:     Nothing.
+
+=item C<IssuePasswordToken($user)>
+
+ Description: Sends a token per email to the given user. This token
+              can be used to change the password (e.g. in case the user
+              cannot remember his password and wishes to enter a new one).
+
+ Params:      $user - User object of the user requesting a new password.
+
+ Returns:     Nothing. It throws an error if the same user made the same
+              request in the last few minutes.
+
+=item C<CleanTokenTable()>
+
+ Description: Removes all tokens older than MAX_TOKEN_AGE days from the DB.
+              This means that these tokens will now be considered as invalid.
+
+ Params:      None.
+
+ Returns:     Nothing.
+
+=item C<GenerateUniqueToken($table, $column)>
+
+ Description: Generates and returns a unique token. This token is unique
+              in the $column of the $table. This token is NOT stored in the DB.
+
+ Params:      $table (optional): The table to look at (default: tokens).
+              $column (optional): The column to look at for uniqueness (default: token).
+
+ Returns:     A token which is unique in $column.
+
+=item C<Cancel($token, $cancelaction, $vars)>
+
+ Description: Invalidates an existing token, generally when the token is used
+              for an action which is not the one expected. An email is sent
+              to the user who originally requested this token to inform him
+              that this token has been invalidated (e.g. because an hacker
+              tried to use this token for some malicious action).
+
+ Params:      $token:        The token to invalidate.
+              $cancelaction: The reason why this token is invalidated.
+              $vars:         Some additional information about this action.
+
+ Returns:     Nothing.
+
+=item C<DeletePasswordTokens($user_id, $reason)>
+
+ Description: Cancels all password tokens for the given user. Emails are sent
+              to the user to inform him about this action.
+
+ Params:      $user_id: The user ID of the user account whose password tokens
+                        are canceled.
+              $reason:  The reason why these tokens are canceled.
+
+ Returns:     Nothing.
+
+=item C<HasEmailChangeToken($user_id)>
+
+ Description: Returns any existing token currently used for an email change
+              for the given user.
+
+ Params:      $user_id - A user ID.
+
+ Returns:     A token if it exists, else undef.
+
+=item C<GetTokenData($token)>
+
+ Description: Returns all stored data for the given token.
+
+ Params:      $token - A valid token.
+
+ Returns:     The user ID, the date and time when the token was created,
+              the (event)data stored with that token, and its type.
+
+=back
+
+=head2 Security related routines
+
+The following routines have been written to be used together as described below,
+although they can be used separately.
+
+=over
+
+=item C<issue_session_token($event)>
+
+ Description: Creates and returns a token used internally.
+
+ Params:      $event - The event which needs to be stored in the DB for future
+                       reference/checks.
+
+ Returns:     A unique token.
+
+=item C<check_token_data($token, $event)>
+
+ Description: Makes sure the $token has been created by the currently logged in
+              user and to be used for the given $event. If this token is used for
+              an unexpected action (i.e. $event doesn't match the information stored
+              with the token), a warning is displayed asking whether the user really
+              wants to continue. On success, it returns 1.
+              This is the routine to use for security checks, combined with
+              issue_session_token() and delete_token() as follows:
+
+              1. First, create a token for some coming action.
+              my $token = issue_session_token($action);
+              2. Some time later, it's time to make sure that the expected action
+                 is going to be executed, and by the expected user.
+              check_token_data($token, $action);
+              3. The check has been done and we no longer need this token.
+              delete_token($token);
+
+ Params:      $token - The token used for security checks.
+              $event - The expected event to be run.
+
+ Returns:     1 on success, else a warning is thrown.
+
+=item C<delete_token($token)>
+
+ Description: Deletes the specified token. No notification is sent.
+
+ Params:      $token - The token to delete.
+
+ Returns:     Nothing.
+
+=back
+
+=cut

diff --git a/Bugzilla/Update.pm b/Bugzilla/Update.pm
new file mode 100644 (file)
index 0000000..29133ec
--- /dev/null
+++ b/Bugzilla/Update.pm
@@ -0,0 +1,200 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Update;
+
+use strict;
+
+use Bugzilla::Constants;
+
+use constant TIME_INTERVAL => 86400; # Default is one day, in seconds.
+use constant TIMEOUT       => 5; # Number of seconds before timeout.
+
+# Look for new releases and notify logged in administrators about them.
+sub get_notifications {
+    return if !Bugzilla->feature('updates');
+    return if (Bugzilla->params->{'upgrade_notification'} eq 'disabled');
+
+    my $local_file = bz_locations()->{'datadir'} . '/' . LOCAL_FILE;
+    # Update the local XML file if this one doesn't exist or if
+    # the last modification time (stat[9]) is older than TIME_INTERVAL.
+    if (!-e $local_file || (time() - (stat($local_file))[9] > TIME_INTERVAL)) {
+        unlink $local_file; # Make sure the old copy is away.
+        return { 'error' => 'no_update' } if (-e $local_file);
+
+        my $error = _synchronize_data();
+        # If an error is returned, leave now.
+        return $error if $error;
+    }
+
+    # If we cannot access the local XML file, ignore it.
+    return { 'error' => 'no_access' } unless (-r $local_file);
+
+    my $twig = XML::Twig->new();
+    $twig->safe_parsefile($local_file);
+    # If the XML file is invalid, return.
+    return { 'error' => 'corrupted' } if $@;
+    my $root = $twig->root;
+
+    my @releases;
+    foreach my $branch ($root->children('branch')) {
+        my $release = {
+            'branch_ver' => $branch->{'att'}->{'id'},
+            'latest_ver' => $branch->{'att'}->{'vid'},
+            'status'     => $branch->{'att'}->{'status'},
+            'url'        => $branch->{'att'}->{'url'},
+            'date'       => $branch->{'att'}->{'date'}
+        };
+        push(@releases, $release);
+    }
+
+    # On which branch is the current installation running?
+    my @current_version =
+        (BUGZILLA_VERSION =~ m/^(\d+)\.(\d+)(?:(rc|\.)(\d+))?\+?$/);
+
+    my @release;
+    if (Bugzilla->params->{'upgrade_notification'} eq 'development_snapshot') {
+        @release = grep {$_->{'status'} eq 'development'} @releases;
+        # If there is no development snapshot available, then we are in the
+        # process of releasing a release candidate. That's the release we want.
+        unless (scalar(@release)) {
+            @release = grep {$_->{'status'} eq 'release-candidate'} @releases;
+        }
+    }
+    elsif (Bugzilla->params->{'upgrade_notification'} eq 'latest_stable_release') {
+        @release = grep {$_->{'status'} eq 'stable'} @releases;
+    }
+    elsif (Bugzilla->params->{'upgrade_notification'} eq 'stable_branch_release') {
+        # We want the latest stable version for the current branch.
+        # If we are running a development snapshot, we won't match anything.
+        my $branch_version = $current_version[0] . '.' . $current_version[1];
+
+        # We do a string comparison instead of a numerical one, because
+        # e.g. 2.2 == 2.20, but 2.2 ne 2.20 (and 2.2 is indeed much older).
+        @release = grep {$_->{'branch_ver'} eq $branch_version} @releases;
+
+        # If the branch is now closed, we should strongly suggest
+        # to upgrade to the latest stable release available.
+        if (scalar(@release) && $release[0]->{'status'} eq 'closed') {
+            @release = grep {$_->{'status'} eq 'stable'} @releases;
+            return {'data' => $release[0], 'deprecated' => $branch_version};
+        }
+    }
+    else {
+      # Unknown parameter.
+      return {'error' => 'unknown_parameter'};
+    }
+
+    # Return if no new release is available.
+    return unless scalar(@release);
+
+    # Only notify the administrator if the latest version available
+    # is newer than the current one.
+    my @new_version =
+        ($release[0]->{'latest_ver'} =~ m/^(\d+)\.(\d+)(?:(rc|\.)(\d+))?\+?$/);
+
+    # We convert release candidates 'rc' to integers (rc ? 0 : 1) in order
+    # to compare versions easily.
+    $current_version[2] = ($current_version[2] && $current_version[2] eq 'rc') ? 0 : 1;
+    $new_version[2] = ($new_version[2] && $new_version[2] eq 'rc') ? 0 : 1;
+
+    my $is_newer = _compare_versions(\@current_version, \@new_version);
+    return ($is_newer == 1) ? {'data' => $release[0]} : undef;
+}
+
+sub _synchronize_data {
+    my $local_file = bz_locations()->{'datadir'} . '/' . LOCAL_FILE;
+
+    my $ua = LWP::UserAgent->new();
+    $ua->timeout(TIMEOUT);
+    $ua->protocols_allowed(['http', 'https']);
+    # If the URL of the proxy is given, use it, else get this information
+    # from the environment variable.
+    my $proxy_url = Bugzilla->params->{'proxy_url'};
+    if ($proxy_url) {
+        $ua->proxy(['http', 'https'], $proxy_url);
+    }
+    else {
+        $ua->env_proxy;
+    }
+    my $response = eval { $ua->mirror(REMOTE_FILE, $local_file) };
+
+    # $ua->mirror() forces the modification time of the local XML file
+    # to match the modification time of the remote one.
+    # So we have to update it manually to reflect that a newer version
+    # of the file has effectively been requested. This will avoid
+    # any new download for the next TIME_INTERVAL.
+    if (-e $local_file) {
+        # Try to alter its last modification time.
+        my $can_alter = utime(undef, undef, $local_file);
+        # This error should never happen.
+        $can_alter || return { 'error' => 'no_update' };
+    }
+    elsif ($response && $response->is_error) {
+        # We have been unable to download the file.
+        return { 'error' => 'cannot_download', 'reason' => $response->status_line };
+    }
+    else {
+        return { 'error' => 'no_write', 'reason' => $@ };
+    }
+
+    # Everything went well.
+    return 0;
+}
+
+sub _compare_versions {
+    my ($old_ver, $new_ver) = @_;
+    while (scalar(@$old_ver) && scalar(@$new_ver)) {
+        my $old = shift(@$old_ver) || 0;
+        my $new = shift(@$new_ver) || 0;
+        return $new <=> $old if ($new <=> $old);
+    }
+    return scalar(@$new_ver) <=> scalar(@$old_ver);
+
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Update - Update routines for Bugzilla
+
+=head1 SYNOPSIS
+
+  use Bugzilla::Update;
+
+  # Get information about new releases
+  my $new_release = Bugzilla::Update::get_notifications();
+
+=head1 DESCRIPTION
+
+This module contains all required routines to notify you
+about new releases. It downloads an XML file from bugzilla.org
+and parses it, in order to display information based on your
+preferences. Absolutely no information about the Bugzilla version
+you are running is sent to bugzilla.org.
+
+=head1 FUNCTIONS
+
+=over
+
+=item C<get_notifications()>
+
+ Description: This function informs you about new releases, if any.
+
+ Params:      None.
+
+ Returns:     On success, a reference to a hash with data about
+              new releases, if any.
+              On failure, a reference to a hash with the reason
+              of the failure and the name of the unusable XML file.
+
+=back
+
+=cut

diff --git a/Bugzilla/User.pm b/Bugzilla/User.pm
new file mode 100644 (file)
index 0000000..c787e03
--- /dev/null
+++ b/Bugzilla/User.pm
@@ -0,0 +1,2736 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+################################################################################
+# Module Initialization
+################################################################################
+
+# Make it harder for us to do dangerous things in Perl.
+use strict;
+
+# This module implements utilities for dealing with Bugzilla users.
+package Bugzilla::User;
+
+use Bugzilla::Error;
+use Bugzilla::Util;
+use Bugzilla::Constants;
+use Bugzilla::Search::Recent;
+use Bugzilla::User::Setting;
+use Bugzilla::Product;
+use Bugzilla::Classification;
+use Bugzilla::Field;
+use Bugzilla::Group;
+
+use DateTime::TimeZone;
+use List::Util qw(max);
+use Scalar::Util qw(blessed);
+use Storable qw(dclone);
+use URI;
+use URI::QueryParam;
+
+use base qw(Bugzilla::Object Exporter);
+@Bugzilla::User::EXPORT = qw(is_available_username
+    login_to_id user_id_to_login validate_password
+    USER_MATCH_MULTIPLE USER_MATCH_FAILED USER_MATCH_SUCCESS
+    MATCH_SKIP_CONFIRM
+);
+
+#####################################################################
+# Constants
+#####################################################################
+
+use constant USER_MATCH_MULTIPLE => -1;
+use constant USER_MATCH_FAILED   => 0;
+use constant USER_MATCH_SUCCESS  => 1;
+
+use constant MATCH_SKIP_CONFIRM  => 1;
+
+use constant DEFAULT_USER => {
+    'userid'         => 0,
+    'realname'       => '',
+    'login_name'     => '',
+    'showmybugslink' => 0,
+    'disabledtext'   => '',
+    'disable_mail'   => 0,
+    'is_enabled'     => 1, 
+};
+
+use constant DB_TABLE => 'profiles';
+
+# XXX Note that Bugzilla::User->name does not return the same thing
+# that you passed in for "name" to new(). That's because historically
+# Bugzilla::User used "name" for the realname field. This should be
+# fixed one day.
+sub DB_COLUMNS {
+    my $dbh = Bugzilla->dbh;
+    return (
+        'profiles.userid',
+        'profiles.login_name',
+        'profiles.realname',
+        'profiles.mybugslink AS showmybugslink',
+        'profiles.disabledtext',
+        'profiles.disable_mail',
+        'profiles.extern_id',
+        'profiles.is_enabled',
+        $dbh->sql_date_format('last_seen_date', '%Y-%m-%d') . ' AS last_seen_date',
+    ),
+}
+
+use constant NAME_FIELD => 'login_name';
+use constant ID_FIELD   => 'userid';
+use constant LIST_ORDER => NAME_FIELD;
+
+use constant VALIDATORS => {
+    cryptpassword => \&_check_password,
+    disable_mail  => \&_check_disable_mail,
+    disabledtext  => \&_check_disabledtext,
+    login_name    => \&check_login_name,
+    realname      => \&_check_realname,
+    extern_id     => \&_check_extern_id,
+    is_enabled    => \&_check_is_enabled, 
+};
+
+sub UPDATE_COLUMNS {
+    my $self = shift;
+    my @cols = qw(
+        disable_mail
+        disabledtext
+        login_name
+        realname
+        extern_id
+        is_enabled
+    );
+    push(@cols, 'cryptpassword') if exists $self->{cryptpassword};
+    return @cols;
+};
+
+use constant VALIDATOR_DEPENDENCIES => {
+    is_enabled => ['disabledtext'], 
+};
+
+use constant EXTRA_REQUIRED_FIELDS => qw(is_enabled);
+
+################################################################################
+# Functions
+################################################################################
+
+sub new {
+    my $invocant = shift;
+    my $class = ref($invocant) || $invocant;
+    my ($param) = @_;
+
+    my $user = DEFAULT_USER;
+    bless ($user, $class);
+    return $user unless $param;
+
+    if (ref($param) eq 'HASH') {
+        if (defined $param->{extern_id}) {
+            $param = { condition => 'extern_id = ?' , values => [$param->{extern_id}] };
+            $_[0] = $param;
+        }
+    }
+    return $class->SUPER::new(@_);
+}
+
+sub super_user {
+    my $invocant = shift;
+    my $class = ref($invocant) || $invocant;
+    my ($param) = @_;
+
+    my $user = dclone(DEFAULT_USER);
+    $user->{groups} = [Bugzilla::Group->get_all];
+    $user->{bless_groups} = [Bugzilla::Group->get_all];
+    bless $user, $class;
+    return $user;
+}
+
+sub update {
+    my $self = shift;
+    my $options = shift;
+    
+    my $changes = $self->SUPER::update(@_);
+    my $dbh = Bugzilla->dbh;
+
+    if (exists $changes->{login_name}) {
+        # Delete all the tokens related to the userid
+        $dbh->do('DELETE FROM tokens WHERE userid = ?', undef, $self->id)
+          unless $options->{keep_tokens};
+        # And rederive regex groups
+        $self->derive_regexp_groups();
+    }
+
+    # Logout the user if necessary.
+    Bugzilla->logout_user($self) 
+        if (!$options->{keep_session}
+            && (exists $changes->{login_name}
+                || exists $changes->{disabledtext}
+                || exists $changes->{cryptpassword}));
+
+    # XXX Can update profiles_activity here as soon as it understands
+    #     field names like login_name.
+    
+    return $changes;
+}
+
+################################################################################
+# Validators
+################################################################################
+
+sub _check_disable_mail { return $_[1] ? 1 : 0; }
+sub _check_disabledtext { return trim($_[1]) || ''; }
+
+# Check whether the extern_id is unique.
+sub _check_extern_id {
+    my ($invocant, $extern_id) = @_;
+    $extern_id = trim($extern_id);
+    return undef unless defined($extern_id) && $extern_id ne "";
+    if (!ref($invocant) || $invocant->extern_id ne $extern_id) {
+        my $existing_login = $invocant->new({ extern_id => $extern_id });
+        if ($existing_login) {
+            ThrowUserError( 'extern_id_exists',
+                            { extern_id => $extern_id,
+                              existing_login_name => $existing_login->login });
+        }
+    }
+    return $extern_id;
+}
+
+# This is public since createaccount.cgi needs to use it before issuing
+# a token for account creation.
+sub check_login_name {
+    my ($invocant, $name) = @_;
+    $name = trim($name);
+    $name || ThrowUserError('user_login_required');
+    check_email_syntax($name);
+
+    # Check the name if it's a new user, or if we're changing the name.
+    if (!ref($invocant) || lc($invocant->login) ne lc($name)) {
+        my @params = ($name);
+        push(@params, $invocant->login) if ref($invocant);
+        is_available_username(@params)
+            || ThrowUserError('account_exists', { email => $name });
+    }
+
+    return $name;
+}
+
+sub _check_password {
+    my ($self, $pass) = @_;
+
+    # If the password is '*', do not encrypt it or validate it further--we 
+    # are creating a user who should not be able to log in using DB 
+    # authentication.
+    return $pass if $pass eq '*';
+
+    validate_password($pass);
+    my $cryptpassword = bz_crypt($pass);
+    return $cryptpassword;
+}
+
+sub _check_realname { return trim($_[1]) || ''; }
+
+sub _check_is_enabled {
+    my ($invocant, $is_enabled, undef, $params) = @_;
+    # is_enabled is set automatically on creation depending on whether 
+    # disabledtext is empty (enabled) or not empty (disabled).
+    # When updating the user, is_enabled is set by calling set_disabledtext().
+    # Any value passed into this validator is ignored.
+    my $disabledtext = ref($invocant) ? $invocant->disabledtext : $params->{disabledtext};
+    return $disabledtext ? 0 : 1;
+}
+
+################################################################################
+# Mutators
+################################################################################
+
+sub set_disable_mail { $_[0]->set('disable_mail', $_[1]); }
+sub set_extern_id    { $_[0]->set('extern_id', $_[1]); }
+
+sub set_login {
+    my ($self, $login) = @_;
+    $self->set('login_name', $login);
+    delete $self->{identity};
+    delete $self->{nick};
+}
+
+sub set_name {
+    my ($self, $name) = @_;
+    $self->set('realname', $name);
+    delete $self->{identity};
+}
+
+sub set_password { $_[0]->set('cryptpassword', $_[1]); }
+
+sub set_disabledtext {
+    $_[0]->set('disabledtext', $_[1]);
+    $_[0]->set('is_enabled', $_[1] ? 0 : 1);
+}
+
+sub update_last_seen_date {
+    my $self = shift;
+    return unless $self->id;
+    my $dbh = Bugzilla->dbh;
+    my $date = $dbh->selectrow_array(
+        'SELECT ' . $dbh->sql_date_format('NOW()', '%Y-%m-%d'));
+
+    if (!$self->last_seen_date or $date ne $self->last_seen_date) {
+        $self->{last_seen_date} = $date;
+        # We don't use the normal update() routine here as we only
+        # want to update the last_seen_date column, not any other
+        # pending changes
+        $dbh->do("UPDATE profiles SET last_seen_date = ? WHERE userid = ?",
+                 undef, $date, $self->id);
+    }
+}
+
+################################################################################
+# Methods
+################################################################################
+
+# Accessors for user attributes
+sub name  { $_[0]->{realname};   }
+sub login { $_[0]->{login_name}; }
+sub extern_id { $_[0]->{extern_id}; }
+sub email { $_[0]->login . Bugzilla->params->{'emailsuffix'}; }
+sub disabledtext { $_[0]->{'disabledtext'}; }
+sub is_enabled { $_[0]->{'is_enabled'} ? 1 : 0; }
+sub showmybugslink { $_[0]->{showmybugslink}; }
+sub email_disabled { $_[0]->{disable_mail}; }
+sub email_enabled { !($_[0]->{disable_mail}); }
+sub last_seen_date { $_[0]->{last_seen_date}; }
+sub cryptpassword {
+    my $self = shift;
+    # We don't store it because we never want it in the object (we
+    # don't want to accidentally dump even the hash somewhere).
+    my ($pw) = Bugzilla->dbh->selectrow_array(
+        'SELECT cryptpassword FROM profiles WHERE userid = ?',
+        undef, $self->id);
+    return $pw;
+}
+
+sub set_authorizer {
+    my ($self, $authorizer) = @_;
+    $self->{authorizer} = $authorizer;
+}
+sub authorizer {
+    my ($self) = @_;
+    if (!$self->{authorizer}) {
+        require Bugzilla::Auth;
+        $self->{authorizer} = new Bugzilla::Auth();
+    }
+    return $self->{authorizer};
+}
+
+# Generate a string to identify the user by name + login if the user
+# has a name or by login only if she doesn't.
+sub identity {
+    my $self = shift;
+
+    return "" unless $self->id;
+
+    if (!defined $self->{identity}) {
+        $self->{identity} = 
+          $self->name ? $self->name . " <" . $self->login. ">" : $self->login;
+    }
+
+    return $self->{identity};
+}
+
+sub nick {
+    my $self = shift;
+
+    return "" unless $self->id;
+
+    if (!defined $self->{nick}) {
+        $self->{nick} = (split(/@/, $self->login, 2))[0];
+    }
+
+    return $self->{nick};
+}
+
+sub queries {
+    my $self = shift;
+    return $self->{queries} if defined $self->{queries};
+    return [] unless $self->id;
+
+    my $dbh = Bugzilla->dbh;
+    my $query_ids = $dbh->selectcol_arrayref(
+        'SELECT id FROM namedqueries WHERE userid = ?', undef, $self->id);
+    require Bugzilla::Search::Saved;
+    $self->{queries} = Bugzilla::Search::Saved->new_from_list($query_ids);
+
+    # We preload link_in_footer from here as this information is always requested.
+    # This only works if the user object represents the current logged in user.
+    Bugzilla::Search::Saved::preload($self->{queries}) if $self->id == Bugzilla->user->id;
+
+    return $self->{queries};
+}
+
+sub queries_subscribed {
+    my $self = shift;
+    return $self->{queries_subscribed} if defined $self->{queries_subscribed};
+    return [] unless $self->id;
+
+    # Exclude the user's own queries.
+    my @my_query_ids = map($_->id, @{$self->queries});
+    my $query_id_string = join(',', @my_query_ids) || '-1';
+
+    # Only show subscriptions that we can still actually see. If a
+    # user changes the shared group of a query, our subscription
+    # will remain but we won't have access to the query anymore.
+    my $subscribed_query_ids = Bugzilla->dbh->selectcol_arrayref(
+        "SELECT lif.namedquery_id
+           FROM namedqueries_link_in_footer lif
+                INNER JOIN namedquery_group_map ngm
+                ON ngm.namedquery_id = lif.namedquery_id
+          WHERE lif.user_id = ? 
+                AND lif.namedquery_id NOT IN ($query_id_string)
+                AND " . $self->groups_in_sql,
+          undef, $self->id);
+    require Bugzilla::Search::Saved;
+    $self->{queries_subscribed} =
+        Bugzilla::Search::Saved->new_from_list($subscribed_query_ids);
+    return $self->{queries_subscribed};
+}
+
+sub queries_available {
+    my $self = shift;
+    return $self->{queries_available} if defined $self->{queries_available};
+    return [] unless $self->id;
+
+    # Exclude the user's own queries.
+    my @my_query_ids = map($_->id, @{$self->queries});
+    my $query_id_string = join(',', @my_query_ids) || '-1';
+
+    my $avail_query_ids = Bugzilla->dbh->selectcol_arrayref(
+        'SELECT namedquery_id FROM namedquery_group_map
+          WHERE '  . $self->groups_in_sql . "
+                AND namedquery_id NOT IN ($query_id_string)");
+    require Bugzilla::Search::Saved;
+    $self->{queries_available} =
+        Bugzilla::Search::Saved->new_from_list($avail_query_ids);
+    return $self->{queries_available};
+}
+
+sub tags {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    if (!defined $self->{tags}) {
+        # We must use LEFT JOIN instead of INNER JOIN as we may be
+        # in the process of inserting a new tag to some bugs,
+        # in which case there are no bugs with this tag yet.
+        $self->{tags} = $dbh->selectall_hashref(
+            'SELECT name, id, COUNT(bug_id) AS bug_count
+               FROM tag
+          LEFT JOIN bug_tag ON bug_tag.tag_id = tag.id
+              WHERE user_id = ? ' . $dbh->sql_group_by('id', 'name'),
+            'name', undef, $self->id);
+    }
+    return $self->{tags};
+}
+
+##########################
+# Saved Recent Bug Lists #
+##########################
+
+sub recent_searches {
+    my $self = shift;
+    $self->{recent_searches} ||= 
+        Bugzilla::Search::Recent->match({ user_id => $self->id });
+    return $self->{recent_searches};
+}
+
+sub recent_search_containing {
+    my ($self, $bug_id) = @_;
+    my $searches = $self->recent_searches;
+
+    foreach my $search (@$searches) {
+        return $search if grep($_ == $bug_id, @{ $search->bug_list });
+    }
+
+    return undef;
+}
+
+sub recent_search_for {
+    my ($self, $bug) = @_;
+    my $params = Bugzilla->input_params;
+    my $cgi = Bugzilla->cgi;
+
+    if ($self->id) {
+        # First see if there's a list_id parameter in the query string.
+        my $list_id = $params->{list_id};
+        if (!$list_id) {
+            # If not, check for "list_id" in the query string of the referer.
+            my $referer = $cgi->referer;
+            if ($referer) {
+                my $uri = URI->new($referer);
+                if ($uri->path =~ /buglist\.cgi$/) {
+                    $list_id = $uri->query_param('list_id')
+                               || $uri->query_param('regetlastlist');
+                }
+            }
+        }
+
+        if ($list_id && $list_id ne 'cookie') {
+            # If we got a bad list_id (either some other user's or an expired
+            # one) don't crash, just don't return that list.
+            my $search = Bugzilla::Search::Recent->check_quietly(
+                { id => $list_id });
+            return $search if $search;
+        }
+
+        # If there's no list_id, see if the current bug's id is contained
+        # in any of the user's saved lists.
+        my $search = $self->recent_search_containing($bug->id);
+        return $search if $search;
+    }
+
+    # Finally (or always, if we're logged out), if there's a BUGLIST cookie
+    # and the selected bug is in the list, then return the cookie as a fake
+    # Search::Recent object.
+    if (my $list = $cgi->cookie('BUGLIST')) {
+        # Also split on colons, which was used as a separator in old cookies.
+        my @bug_ids = split(/[:-]/, $list);
+        if (grep { $_ == $bug->id } @bug_ids) {
+            my $search = Bugzilla::Search::Recent->new_from_cookie(\@bug_ids);
+            return $search;
+        }
+    }
+
+    return undef;
+}
+
+sub save_last_search {
+    my ($self, $params) = @_;
+    my ($bug_ids, $order, $vars, $list_id) = 
+        @$params{qw(bugs order vars list_id)};
+
+    my $cgi = Bugzilla->cgi;
+    if ($order) {
+        $cgi->send_cookie(-name => 'LASTORDER',
+                          -value => $order,
+                          -expires => 'Fri, 01-Jan-2038 00:00:00 GMT');
+    }
+
+    return if !@$bug_ids;
+
+    my $search;
+    if ($self->id) {
+        on_main_db {
+            if ($list_id) {
+                $search = Bugzilla::Search::Recent->check_quietly({ id => $list_id });
+            }
+
+            if ($search) {
+                if (join(',', @{$search->bug_list}) ne join(',', @$bug_ids)) {
+                    $search->set_bug_list($bug_ids);
+                }
+                if (!$search->list_order || $order ne $search->list_order) {
+                    $search->set_list_order($order);
+                }
+                $search->update();
+            }
+            else {
+                # If we already have an existing search with a totally
+                # identical bug list, then don't create a new one. This
+                # prevents people from writing over their whole 
+                # recent-search list by just refreshing a saved search
+                # (which doesn't have list_id in the header) over and over.
+                my $list_string = join(',', @$bug_ids);
+                my $existing_search = Bugzilla::Search::Recent->match({
+                    user_id => $self->id, bug_list => $list_string });
+           
+                if (!scalar(@$existing_search)) {
+                    $search = Bugzilla::Search::Recent->create({
+                        user_id    => $self->id,
+                        bug_list   => $bug_ids,
+                        list_order => $order });
+                }
+                else {
+                    $search = $existing_search->[0];
+                }
+            }
+        };
+        delete $self->{recent_searches};
+    }
+    # Logged-out users use a cookie to store a single last search. We don't
+    # override that cookie with the logged-in user's latest search, because
+    # if they did one search while logged out and another while logged in,
+    # they may still want to navigate through the search they made while
+    # logged out.
+    else {
+        my $bug_list = join('-', @$bug_ids);
+        if (length($bug_list) < 4000) {
+            $cgi->send_cookie(-name => 'BUGLIST',
+                              -value => $bug_list,
+                              -expires => 'Fri, 01-Jan-2038 00:00:00 GMT');
+        }
+        else {
+            $cgi->remove_cookie('BUGLIST');
+            $vars->{'toolong'} = 1;
+        }
+    }
+    return $search;
+}
+
+sub reports {
+    my $self = shift;
+    return $self->{reports} if defined $self->{reports};
+    return [] unless $self->id;
+
+    my $dbh = Bugzilla->dbh;
+    my $report_ids = $dbh->selectcol_arrayref(
+        'SELECT id FROM reports WHERE user_id = ?', undef, $self->id);
+    require Bugzilla::Report;
+    $self->{reports} = Bugzilla::Report->new_from_list($report_ids);
+    return $self->{reports};
+}
+
+sub flush_reports_cache {
+    my $self = shift;
+
+    delete $self->{reports};
+}
+
+sub settings {
+    my ($self) = @_;
+
+    return $self->{'settings'} if (defined $self->{'settings'});
+
+    # IF the user is logged in
+    # THEN get the user's settings
+    # ELSE get default settings
+    if ($self->id) {
+        $self->{'settings'} = get_all_settings($self->id);
+    } else {
+        $self->{'settings'} = get_defaults();
+    }
+
+    return $self->{'settings'};
+}
+
+sub setting {
+    my ($self, $name) = @_;
+    return $self->settings->{$name}->{'value'};
+}
+
+sub timezone {
+    my $self = shift;
+
+    if (!defined $self->{timezone}) {
+        my $tz = $self->setting('timezone');
+        if ($tz eq 'local') {
+            # The user wants the local timezone of the server.
+            $self->{timezone} = Bugzilla->local_timezone;
+        }
+        else {
+            $self->{timezone} = DateTime::TimeZone->new(name => $tz);
+        }
+    }
+    return $self->{timezone};
+}
+
+sub flush_queries_cache {
+    my $self = shift;
+
+    delete $self->{queries};
+    delete $self->{queries_subscribed};
+    delete $self->{queries_available};
+}
+
+sub groups {
+    my $self = shift;
+
+    return $self->{groups} if defined $self->{groups};
+    return [] unless $self->id;
+
+    my $dbh = Bugzilla->dbh;
+    my $groups_to_check = $dbh->selectcol_arrayref(
+        q{SELECT DISTINCT group_id
+            FROM user_group_map
+           WHERE user_id = ? AND isbless = 0}, undef, $self->id);
+
+    my $rows = $dbh->selectall_arrayref(
+        "SELECT DISTINCT grantor_id, member_id
+           FROM group_group_map
+          WHERE grant_type = " . GROUP_MEMBERSHIP);
+
+    my %group_membership;
+    foreach my $row (@$rows) {
+        my ($grantor_id, $member_id) = @$row; 
+        push (@{ $group_membership{$member_id} }, $grantor_id);
+    }
+    
+    # Let's walk the groups hierarchy tree (using FIFO)
+    # On the first iteration it's pre-filled with direct groups 
+    # membership. Later on, each group can add its own members into the
+    # FIFO. Circular dependencies are eliminated by checking
+    # $checked_groups{$member_id} hash values.
+    # As a result, %groups will have all the groups we are the member of.
+    my %checked_groups;
+    my %groups;
+    while (scalar(@$groups_to_check) > 0) {
+        # Pop the head group from FIFO
+        my $member_id = shift @$groups_to_check;
+        
+        # Skip the group if we have already checked it
+        if (!$checked_groups{$member_id}) {
+            # Mark group as checked
+            $checked_groups{$member_id} = 1;
+            
+            # Add all its members to the FIFO check list
+            # %group_membership contains arrays of group members 
+            # for all groups. Accessible by group number.
+            my $members = $group_membership{$member_id};
+            my @new_to_check = grep(!$checked_groups{$_}, @$members);
+            push(@$groups_to_check, @new_to_check);
+
+            $groups{$member_id} = 1;
+        }
+    }
+
+    $self->{groups} = Bugzilla::Group->new_from_list([keys %groups]);
+
+    return $self->{groups};
+}
+
+# It turns out that calling ->id on objects a few hundred thousand
+# times is pretty slow. (It showed up as a significant time contributor
+# when profiling xt/search.t.) So we cache the group ids separately from
+# groups for functions that need the group ids.
+sub _group_ids {
+    my ($self) = @_;
+    $self->{group_ids} ||= [map { $_->id } @{ $self->groups }];
+    return $self->{group_ids};
+}
+
+sub groups_as_string {
+    my $self = shift;
+    my $ids = $self->_group_ids;
+    return scalar(@$ids) ? join(',', @$ids) : '-1';
+}
+
+sub groups_in_sql {
+    my ($self, $field) = @_;
+    $field ||= 'group_id';
+    my $ids = $self->_group_ids;
+    $ids = [-1] if !scalar @$ids;
+    return Bugzilla->dbh->sql_in($field, $ids);
+}
+
+sub bless_groups {
+    my $self = shift;
+
+    return $self->{'bless_groups'} if defined $self->{'bless_groups'};
+    return [] unless $self->id;
+
+    if ($self->in_group('editusers')) {
+        # Users having editusers permissions may bless all groups.
+        $self->{'bless_groups'} = [Bugzilla::Group->get_all];
+        return $self->{'bless_groups'};
+    }
+
+    my $dbh = Bugzilla->dbh;
+
+    # Get all groups for the user where:
+    #    + They have direct bless privileges
+    #    + They are a member of a group that inherits bless privs.
+    my @group_ids = map {$_->id} @{ $self->groups };
+    @group_ids = (-1) if !@group_ids;
+    my $query =
+        'SELECT DISTINCT groups.id
+           FROM groups, user_group_map, group_group_map AS ggm
+          WHERE user_group_map.user_id = ?
+                AND ( (user_group_map.isbless = 1
+                       AND groups.id=user_group_map.group_id)
+                     OR (groups.id = ggm.grantor_id
+                         AND ggm.grant_type = ' . GROUP_BLESS . '
+                         AND ' . $dbh->sql_in('ggm.member_id', \@group_ids)
+                     . ') )';
+
+    # If visibilitygroups are used, restrict the set of groups.
+    if (Bugzilla->params->{'usevisibilitygroups'}) {
+        return [] if !$self->visible_groups_as_string;
+        # Users need to see a group in order to bless it.
+        $query .= " AND "
+            . $dbh->sql_in('groups.id', $self->visible_groups_inherited);
+    }
+
+    my $ids = $dbh->selectcol_arrayref($query, undef, $self->id);
+    return $self->{'bless_groups'} = Bugzilla::Group->new_from_list($ids);
+}
+
+sub in_group {
+    my ($self, $group, $product_id) = @_;
+    $group = $group->name if blessed $group;
+    if (scalar grep($_->name eq $group, @{ $self->groups })) {
+        return 1;
+    }
+    elsif ($product_id && detaint_natural($product_id)) {
+        # Make sure $group exists on a per-product basis.
+        return 0 unless (grep {$_ eq $group} PER_PRODUCT_PRIVILEGES);
+
+        $self->{"product_$product_id"} = {} unless exists $self->{"product_$product_id"};
+        if (!defined $self->{"product_$product_id"}->{$group}) {
+            my $dbh = Bugzilla->dbh;
+            my $in_group = $dbh->selectrow_array(
+                           "SELECT 1
+                              FROM group_control_map
+                             WHERE product_id = ?
+                                   AND $group != 0
+                                   AND " . $self->groups_in_sql . ' ' .
+                              $dbh->sql_limit(1),
+                             undef, $product_id);
+
+            $self->{"product_$product_id"}->{$group} = $in_group ? 1 : 0;
+        }
+        return $self->{"product_$product_id"}->{$group};
+    }
+    # If we come here, then the user is not in the requested group.
+    return 0;
+}
+
+sub in_group_id {
+    my ($self, $id) = @_;
+    return grep($_->id == $id, @{ $self->groups }) ? 1 : 0;
+}
+
+# This is a helper to get all groups which have an icon to be displayed
+# besides the name of the commenter.
+sub groups_with_icon {
+    my $self = shift;
+
+    my @groups = grep { $_->icon_url } @{ $self->groups };
+    return \@groups;
+}
+
+sub get_products_by_permission {
+    my ($self, $group) = @_;
+    # Make sure $group exists on a per-product basis.
+    return [] unless (grep {$_ eq $group} PER_PRODUCT_PRIVILEGES);
+
+    my $product_ids = Bugzilla->dbh->selectcol_arrayref(
+                          "SELECT DISTINCT product_id
+                             FROM group_control_map
+                            WHERE $group != 0
+                              AND " . $self->groups_in_sql);
+
+    # No need to go further if the user has no "special" privs.
+    return [] unless scalar(@$product_ids);
+    my %product_map = map { $_ => 1 } @$product_ids;
+
+    # We will restrict the list to products the user can see.
+    my $selectable_products = $self->get_selectable_products;
+    my @products = grep { $product_map{$_->id} } @$selectable_products;
+    return \@products;
+}
+
+sub can_see_user {
+    my ($self, $otherUser) = @_;
+    my $query;
+
+    if (Bugzilla->params->{'usevisibilitygroups'}) {
+        # If the user can see no groups, then no users are visible either.
+        my $visibleGroups = $self->visible_groups_as_string() || return 0;
+        $query = qq{SELECT COUNT(DISTINCT userid)
+                    FROM profiles, user_group_map
+                    WHERE userid = ?
+                    AND user_id = userid
+                    AND isbless = 0
+                    AND group_id IN ($visibleGroups)
+                   };
+    } else {
+        $query = qq{SELECT COUNT(userid)
+                    FROM profiles
+                    WHERE userid = ?
+                   };
+    }
+    return Bugzilla->dbh->selectrow_array($query, undef, $otherUser->id);
+}
+
+sub can_edit_product {
+    my ($self, $prod_id) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    my $has_external_groups =
+      $dbh->selectrow_array('SELECT 1
+                               FROM group_control_map
+                              WHERE product_id = ?
+                                AND canedit != 0
+                                AND group_id NOT IN(' . $self->groups_as_string . ')',
+                             undef, $prod_id);
+
+    return !$has_external_groups;
+}
+
+sub can_see_bug {
+    my ($self, $bug_id) = @_;
+    return @{ $self->visible_bugs([$bug_id]) } ? 1 : 0;
+}
+
+sub visible_bugs {
+    my ($self, $bugs) = @_;
+    # Allow users to pass in Bug objects and bug ids both.
+    my @bug_ids = map { blessed $_ ? $_->id : $_ } @$bugs;
+
+    # We only check the visibility of bugs that we haven't
+    # checked yet.
+    # Bugzilla::Bug->update automatically removes updated bugs
+    # from the cache to force them to be checked again.
+    my $visible_cache = $self->{_visible_bugs_cache} ||= {};
+    my @check_ids = grep(!exists $visible_cache->{$_}, @bug_ids);
+
+    if (@check_ids) {
+        my $dbh = Bugzilla->dbh;
+        my $user_id = $self->id;
+
+        foreach my $id (@check_ids) {
+            my $orig_id = $id;
+            detaint_natural($id)
+              || ThrowCodeError('param_must_be_numeric', { param    => $orig_id,
+                                                           function => 'Bugzilla::User->visible_bugs'});
+        }
+
+        my $sth;
+        # Speed up the can_see_bug case.
+        if (scalar(@check_ids) == 1) {
+            $sth = $self->{_sth_one_visible_bug};
+        }
+        $sth ||= $dbh->prepare(
+            # This checks for groups that the bug is in that the user
+            # *isn't* in. Then, in the Perl code below, we check if
+            # the user can otherwise access the bug (for example, by being
+            # the assignee or QA Contact).
+            #
+            # The DISTINCT exists because the bug could be in *several*
+            # groups that the user isn't in, but they will all return the
+            # same result for bug_group_map.bug_id (so DISTINCT filters
+            # out duplicate rows).
+            "SELECT DISTINCT bugs.bug_id, reporter, assigned_to, qa_contact,
+                    reporter_accessible, cclist_accessible, cc.who,
+                    bug_group_map.bug_id
+               FROM bugs
+                    LEFT JOIN cc
+                              ON cc.bug_id = bugs.bug_id
+                                 AND cc.who = $user_id
+                    LEFT JOIN bug_group_map 
+                              ON bugs.bug_id = bug_group_map.bug_id
+                                 AND bug_group_map.group_id NOT IN ("
+                                     . $self->groups_as_string . ')
+              WHERE bugs.bug_id IN (' . join(',', ('?') x @check_ids) . ')
+                    AND creation_ts IS NOT NULL ');
+        if (scalar(@check_ids) == 1) {
+            $self->{_sth_one_visible_bug} = $sth;
+        }
+
+        $sth->execute(@check_ids);
+        my $use_qa_contact = Bugzilla->params->{'useqacontact'};
+        while (my $row = $sth->fetchrow_arrayref) {
+            my ($bug_id, $reporter, $owner, $qacontact, $reporter_access, 
+                $cclist_access, $isoncclist, $missinggroup) = @$row;
+            $visible_cache->{$bug_id} ||= 
+                ((($reporter == $user_id) && $reporter_access)
+                 || ($use_qa_contact
+                     && $qacontact && ($qacontact == $user_id))
+                 || ($owner == $user_id)
+                 || ($isoncclist && $cclist_access)
+                 || !$missinggroup) ? 1 : 0;
+        }
+    }
+
+    return [grep { $visible_cache->{blessed $_ ? $_->id : $_} } @$bugs];
+}
+
+sub clear_product_cache {
+    my $self = shift;
+    delete $self->{enterable_products};
+    delete $self->{selectable_products};
+    delete $self->{selectable_classifications};
+}
+
+sub can_see_product {
+    my ($self, $product_name) = @_;
+
+    return scalar(grep {$_->name eq $product_name} @{$self->get_selectable_products});
+}
+
+sub get_selectable_products {
+    my $self = shift;
+    my $class_id = shift;
+    my $class_restricted = Bugzilla->params->{'useclassification'} && $class_id;
+
+    if (!defined $self->{selectable_products}) {
+        my $query = "SELECT id " .
+                    "  FROM products " .
+                 "LEFT JOIN group_control_map " .
+                        "ON group_control_map.product_id = products.id " .
+                      " AND group_control_map.membercontrol = " . CONTROLMAPMANDATORY .
+                      " AND group_id NOT IN(" . $self->groups_as_string . ") " .
+                  "   WHERE group_id IS NULL " .
+                  "ORDER BY name";
+
+        my $prod_ids = Bugzilla->dbh->selectcol_arrayref($query);
+        $self->{selectable_products} = Bugzilla::Product->new_from_list($prod_ids);
+    }
+
+    # Restrict the list of products to those being in the classification, if any.
+    if ($class_restricted) {
+        return [grep {$_->classification_id == $class_id} @{$self->{selectable_products}}];
+    }
+    # If we come here, then we want all selectable products.
+    return $self->{selectable_products};
+}
+
+sub get_selectable_classifications {
+    my ($self) = @_;
+
+    if (!defined $self->{selectable_classifications}) {
+        my $products = $self->get_selectable_products;
+        my %class_ids = map { $_->classification_id => 1 } @$products;
+
+        $self->{selectable_classifications} = Bugzilla::Classification->new_from_list([keys %class_ids]);
+    }
+    return $self->{selectable_classifications};
+}
+
+sub can_enter_product {
+    my ($self, $input, $warn) = @_;
+    my $dbh = Bugzilla->dbh;
+    $warn ||= 0;
+
+    $input = trim($input) if !ref $input;
+    if (!defined $input or $input eq '') {
+        return unless $warn == THROW_ERROR;
+        ThrowUserError('object_not_specified',
+                       { class => 'Bugzilla::Product' });
+    }
+
+    if (!scalar @{ $self->get_enterable_products }) {
+        return unless $warn == THROW_ERROR;
+        ThrowUserError('no_products');
+    }
+
+    my $product = blessed($input) ? $input 
+                                  : new Bugzilla::Product({ name => $input });
+    my $can_enter =
+      $product && grep($_->name eq $product->name,
+                       @{ $self->get_enterable_products });
+
+    return $product if $can_enter;
+
+    return 0 unless $warn == THROW_ERROR;
+
+    # Check why access was denied. These checks are slow,
+    # but that's fine, because they only happen if we fail.
+
+    # We don't just use $product->name for error messages, because if it
+    # changes case from $input, then that's a clue that the product does
+    # exist but is hidden.
+    my $name = blessed($input) ? $input->name : $input;
+
+    # The product could not exist or you could be denied...
+    if (!$product || !$product->user_has_access($self)) {
+        ThrowUserError('entry_access_denied', { product => $name });
+    }
+    # It could be closed for bug entry...
+    elsif (!$product->is_active) {
+        ThrowUserError('product_disabled', { product => $product });
+    }
+    # It could have no components...
+    elsif (!@{$product->components}
+           || !grep { $_->is_active } @{$product->components})
+    {
+        ThrowUserError('missing_component', { product => $product });
+    }
+    # It could have no versions...
+    elsif (!@{$product->versions}
+           || !grep { $_->is_active } @{$product->versions})
+    {
+        ThrowUserError ('missing_version', { product => $product });
+    }
+
+    die "can_enter_product reached an unreachable location.";
+}
+
+sub get_enterable_products {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    if (defined $self->{enterable_products}) {
+        return $self->{enterable_products};
+    }
+
+     # All products which the user has "Entry" access to.
+     my $enterable_ids = $dbh->selectcol_arrayref(
+           'SELECT products.id FROM products
+         LEFT JOIN group_control_map
+                   ON group_control_map.product_id = products.id
+                      AND group_control_map.entry != 0
+                      AND group_id NOT IN (' . $self->groups_as_string . ')
+            WHERE group_id IS NULL
+                  AND products.isactive = 1');
+
+    if (scalar @$enterable_ids) {
+        # And all of these products must have at least one component
+        # and one version.
+        $enterable_ids = $dbh->selectcol_arrayref(
+            'SELECT DISTINCT products.id FROM products
+              WHERE ' . $dbh->sql_in('products.id', $enterable_ids) .
+              ' AND products.id IN (SELECT DISTINCT components.product_id
+                                      FROM components
+                                     WHERE components.isactive = 1)
+                AND products.id IN (SELECT DISTINCT versions.product_id
+                                      FROM versions
+                                     WHERE versions.isactive = 1)');
+    }
+
+    $self->{enterable_products} =
+         Bugzilla::Product->new_from_list($enterable_ids);
+    return $self->{enterable_products};
+}
+
+sub can_access_product {
+    my ($self, $product) = @_;
+    my $product_name = blessed($product) ? $product->name : $product;
+    return scalar(grep {$_->name eq $product_name} @{$self->get_accessible_products});
+}
+
+sub get_accessible_products {
+    my $self = shift;
+    
+    # Map the objects into a hash using the ids as keys
+    my %products = map { $_->id => $_ }
+                       @{$self->get_selectable_products},
+                       @{$self->get_enterable_products};
+    
+    return [ sort { $a->name cmp $b->name } values %products ];
+}
+
+sub check_can_admin_product {
+    my ($self, $product_name) = @_;
+
+    # First make sure the product name is valid.
+    my $product = Bugzilla::Product->check($product_name);
+
+    ($self->in_group('editcomponents', $product->id)
+       && $self->can_see_product($product->name))
+         || ThrowUserError('product_admin_denied', {product => $product->name});
+
+    # Return the validated product object.
+    return $product;
+}
+
+sub check_can_admin_flagtype {
+    my ($self, $flagtype_id) = @_;
+
+    my $flagtype = Bugzilla::FlagType->check({ id => $flagtype_id });
+    my $can_fully_edit = 1;
+
+    if (!$self->in_group('editcomponents')) {
+        my $products = $self->get_products_by_permission('editcomponents');
+        # You need editcomponents privs for at least one product to have
+        # a chance to edit the flagtype.
+        scalar(@$products)
+          || ThrowUserError('auth_failure', {group  => 'editcomponents',
+                                             action => 'edit',
+                                             object => 'flagtypes'});
+        my $can_admin = 0;
+        my $i = $flagtype->inclusions_as_hash;
+        my $e = $flagtype->exclusions_as_hash;
+
+        # If there is at least one product for which the user doesn't have
+        # editcomponents privs, then don't allow him to do everything with
+        # this flagtype, independently of whether this product is in the
+        # exclusion list or not.
+        my %product_ids;
+        map { $product_ids{$_->id} = 1 } @$products;
+        $can_fully_edit = 0 if grep { !$product_ids{$_} } keys %$i;
+
+        unless ($e->{0}->{0}) {
+            foreach my $product (@$products) {
+                my $id = $product->id;
+                next if $e->{$id}->{0};
+                # If we are here, the product has not been explicitly excluded.
+                # Check whether it's explicitly included, or at least one of
+                # its components.
+                $can_admin = ($i->{0}->{0} || $i->{$id}->{0}
+                              || scalar(grep { !$e->{$id}->{$_} } keys %{$i->{$id}}));
+                last if $can_admin;
+            }
+        }
+        $can_admin || ThrowUserError('flag_type_not_editable', { flagtype => $flagtype });
+    }
+    return wantarray ? ($flagtype, $can_fully_edit) : $flagtype;
+}
+
+sub can_request_flag {
+    my ($self, $flag_type) = @_;
+
+    return ($self->can_set_flag($flag_type)
+            || !$flag_type->request_group_id
+            || $self->in_group_id($flag_type->request_group_id)) ? 1 : 0;
+}
+
+sub can_set_flag {
+    my ($self, $flag_type) = @_;
+
+    return (!$flag_type->grant_group_id
+            || $self->in_group_id($flag_type->grant_group_id)) ? 1 : 0;
+}
+
+# visible_groups_inherited returns a reference to a list of all the groups
+# whose members are visible to this user.
+sub visible_groups_inherited {
+    my $self = shift;
+    return $self->{visible_groups_inherited} if defined $self->{visible_groups_inherited};
+    return [] unless $self->id;
+    my @visgroups = @{$self->visible_groups_direct};
+    @visgroups = @{Bugzilla::Group->flatten_group_membership(@visgroups)};
+    $self->{visible_groups_inherited} = \@visgroups;
+    return $self->{visible_groups_inherited};
+}
+
+# visible_groups_direct returns a reference to a list of all the groups that
+# are visible to this user.
+sub visible_groups_direct {
+    my $self = shift;
+    my @visgroups = ();
+    return $self->{visible_groups_direct} if defined $self->{visible_groups_direct};
+    return [] unless $self->id;
+
+    my $dbh = Bugzilla->dbh;
+    my $sth;
+   
+    if (Bugzilla->params->{'usevisibilitygroups'}) {
+        $sth = $dbh->prepare("SELECT DISTINCT grantor_id
+                                 FROM group_group_map
+                                WHERE " . $self->groups_in_sql('member_id') . "
+                                  AND grant_type=" . GROUP_VISIBLE);
+    }
+    else {
+        # All groups are visible if usevisibilitygroups is off.
+        $sth = $dbh->prepare('SELECT id FROM groups');
+    }
+    $sth->execute();
+
+    while (my ($row) = $sth->fetchrow_array) {
+        push @visgroups,$row;
+    }
+    $self->{visible_groups_direct} = \@visgroups;
+
+    return $self->{visible_groups_direct};
+}
+
+sub visible_groups_as_string {
+    my $self = shift;
+    return join(', ', @{$self->visible_groups_inherited()});
+}
+
+# This function defines the groups a user may share a query with.
+# More restrictive sites may want to build this reference to a list of group IDs
+# from bless_groups instead of mirroring visible_groups_inherited, perhaps.
+sub queryshare_groups {
+    my $self = shift;
+    my @queryshare_groups;
+
+    return $self->{queryshare_groups} if defined $self->{queryshare_groups};
+
+    if ($self->in_group(Bugzilla->params->{'querysharegroup'})) {
+        # We want to be allowed to share with groups we're in only.
+        # If usevisibilitygroups is on, then we need to restrict this to groups
+        # we may see.
+        if (Bugzilla->params->{'usevisibilitygroups'}) {
+            foreach(@{$self->visible_groups_inherited()}) {
+                next unless $self->in_group_id($_);
+                push(@queryshare_groups, $_);
+            }
+        }
+        else {
+            @queryshare_groups = @{ $self->_group_ids };
+        }
+    }
+
+    return $self->{queryshare_groups} = \@queryshare_groups;
+}
+
+sub queryshare_groups_as_string {
+    my $self = shift;
+    return join(', ', @{$self->queryshare_groups()});
+}
+
+sub derive_regexp_groups {
+    my ($self) = @_;
+
+    my $id = $self->id;
+    return unless $id;
+
+    my $dbh = Bugzilla->dbh;
+
+    my $sth;
+
+    # add derived records for any matching regexps
+
+    $sth = $dbh->prepare("SELECT id, userregexp, user_group_map.group_id
+                            FROM groups
+                       LEFT JOIN user_group_map
+                              ON groups.id = user_group_map.group_id
+                             AND user_group_map.user_id = ?
+                             AND user_group_map.grant_type = ?");
+    $sth->execute($id, GRANT_REGEXP);
+
+    my $group_insert = $dbh->prepare(q{INSERT INTO user_group_map
+                                       (user_id, group_id, isbless, grant_type)
+                                       VALUES (?, ?, 0, ?)});
+    my $group_delete = $dbh->prepare(q{DELETE FROM user_group_map
+                                       WHERE user_id = ?
+                                         AND group_id = ?
+                                         AND isbless = 0
+                                         AND grant_type = ?});
+    while (my ($group, $regexp, $present) = $sth->fetchrow_array()) {
+        if (($regexp ne '') && ($self->login =~ m/$regexp/i)) {
+            $group_insert->execute($id, $group, GRANT_REGEXP) unless $present;
+        } else {
+            $group_delete->execute($id, $group, GRANT_REGEXP) if $present;
+        }
+    }
+}
+
+sub product_responsibilities {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    return $self->{'product_resp'} if defined $self->{'product_resp'};
+    return [] unless $self->id;
+
+    my $list = $dbh->selectall_arrayref('SELECT components.product_id, components.id
+                                           FROM components
+                                           LEFT JOIN component_cc
+                                           ON components.id = component_cc.component_id
+                                          WHERE components.initialowner = ?
+                                             OR components.initialqacontact = ?
+                                             OR component_cc.user_id = ?',
+                                  {Slice => {}}, ($self->id, $self->id, $self->id));
+
+    unless ($list) {
+        $self->{'product_resp'} = [];
+        return $self->{'product_resp'};
+    }
+
+    my @prod_ids = map {$_->{'product_id'}} @$list;
+    my $products = Bugzilla::Product->new_from_list(\@prod_ids);
+    # We cannot |use| it, because Component.pm already |use|s User.pm.
+    require Bugzilla::Component;
+    my @comp_ids = map {$_->{'id'}} @$list;
+    my $components = Bugzilla::Component->new_from_list(\@comp_ids);
+
+    my @prod_list;
+    # @$products is already sorted alphabetically.
+    foreach my $prod (@$products) {
+        # We use @components instead of $prod->components because we only want
+        # components where the user is either the default assignee or QA contact.
+        push(@prod_list, {product    => $prod,
+                          components => [grep {$_->product_id == $prod->id} @$components]});
+    }
+    $self->{'product_resp'} = \@prod_list;
+    return $self->{'product_resp'};
+}
+
+sub can_bless {
+    my $self = shift;
+
+    if (!scalar(@_)) {
+        # If we're called without an argument, just return 
+        # whether or not we can bless at all.
+        return scalar(@{ $self->bless_groups }) ? 1 : 0;
+    }
+
+    # Otherwise, we're checking a specific group
+    my $group_id = shift;
+    return grep($_->id == $group_id, @{ $self->bless_groups }) ? 1 : 0;
+}
+
+sub match {
+    # Generates a list of users whose login name (email address) or real name
+    # matches a substring or wildcard.
+    # This is also called if matches are disabled (for error checking), but
+    # in this case only the exact match code will end up running.
+
+    # $str contains the string to match, while $limit contains the
+    # maximum number of records to retrieve.
+    my ($str, $limit, $exclude_disabled) = @_;
+    my $user = Bugzilla->user;
+    my $dbh = Bugzilla->dbh;
+
+    $str = trim($str);
+
+    my @users = ();
+    return \@users if $str =~ /^\s*$/;
+
+    # The search order is wildcards, then exact match, then substring search.
+    # Wildcard matching is skipped if there is no '*', and exact matches will
+    # not (?) have a '*' in them.  If any search comes up with something, the
+    # ones following it will not execute.
+
+    # first try wildcards
+    my $wildstr = $str;
+
+    # Do not do wildcards if there is no '*' in the string.
+    if ($wildstr =~ s/\*/\%/g && $user->id) {
+        # Build the query.
+        trick_taint($wildstr);
+        my $query  = "SELECT DISTINCT userid FROM profiles ";
+        if (Bugzilla->params->{'usevisibilitygroups'}) {
+            $query .= "INNER JOIN user_group_map
+                               ON user_group_map.user_id = profiles.userid ";
+        }
+        $query .= "WHERE ("
+            . $dbh->sql_istrcmp('login_name', '?', "LIKE") . " OR " .
+              $dbh->sql_istrcmp('realname', '?', "LIKE") . ") ";
+        if (Bugzilla->params->{'usevisibilitygroups'}) {
+            $query .= "AND isbless = 0 " .
+                      "AND group_id IN(" .
+                      join(', ', (-1, @{$user->visible_groups_inherited})) . ") ";
+        }
+        $query    .= " AND is_enabled = 1 " if $exclude_disabled;
+        $query    .= $dbh->sql_limit($limit) if $limit;
+
+        # Execute the query, retrieve the results, and make them into
+        # User objects.
+        my $user_ids = $dbh->selectcol_arrayref($query, undef, ($wildstr, $wildstr));
+        @users = @{Bugzilla::User->new_from_list($user_ids)};
+    }
+    else {    # try an exact match
+        # Exact matches don't care if a user is disabled.
+        trick_taint($str);
+        my $user_id = $dbh->selectrow_array('SELECT userid FROM profiles
+                                             WHERE ' . $dbh->sql_istrcmp('login_name', '?'),
+                                             undef, $str);
+
+        push(@users, new Bugzilla::User($user_id)) if $user_id;
+    }
+
+    # then try substring search
+    if (!scalar(@users) && length($str) >= 3 && $user->id) {
+        trick_taint($str);
+
+        my $query   = "SELECT DISTINCT userid FROM profiles ";
+        if (Bugzilla->params->{'usevisibilitygroups'}) {
+            $query .= "INNER JOIN user_group_map
+                               ON user_group_map.user_id = profiles.userid ";
+        }
+        $query     .= " WHERE (" .
+                $dbh->sql_iposition('?', 'login_name') . " > 0" . " OR " .
+                $dbh->sql_iposition('?', 'realname') . " > 0) ";
+        if (Bugzilla->params->{'usevisibilitygroups'}) {
+            $query .= " AND isbless = 0" .
+                      " AND group_id IN(" .
+                join(', ', (-1, @{$user->visible_groups_inherited})) . ") ";
+        }
+        $query     .= " AND is_enabled = 1 " if $exclude_disabled;
+        $query     .= $dbh->sql_limit($limit) if $limit;
+        my $user_ids = $dbh->selectcol_arrayref($query, undef, ($str, $str));
+        @users = @{Bugzilla::User->new_from_list($user_ids)};
+    }
+    return \@users;
+}
+
+sub match_field {
+    my $fields       = shift;   # arguments as a hash
+    my $data         = shift || Bugzilla->input_params; # hash to look up fields in
+    my $behavior     = shift || 0; # A constant that tells us how to act
+    my $matches      = {};      # the values sent to the template
+    my $matchsuccess = 1;       # did the match fail?
+    my $need_confirm = 0;       # whether to display confirmation screen
+    my $match_multiple = 0;     # whether we ever matched more than one user
+    my @non_conclusive_fields;  # fields which don't have a unique user.
+
+    my $params = Bugzilla->params;
+
+    # prepare default form values
+
+    # Fields can be regular expressions matching multiple form fields
+    # (f.e. "requestee-(\d+)"), so expand each non-literal field
+    # into the list of form fields it matches.
+    my $expanded_fields = {};
+    foreach my $field_pattern (keys %{$fields}) {
+        # Check if the field has any non-word characters.  Only those fields
+        # can be regular expressions, so don't expand the field if it doesn't
+        # have any of those characters.
+        if ($field_pattern =~ /^\w+$/) {
+            $expanded_fields->{$field_pattern} = $fields->{$field_pattern};
+        }
+        else {
+            my @field_names = grep(/$field_pattern/, keys %$data);
+
+            foreach my $field_name (@field_names) {
+                $expanded_fields->{$field_name} = 
+                  { type => $fields->{$field_pattern}->{'type'} };
+                
+                # The field is a requestee field; in order for its name 
+                # to show up correctly on the confirmation page, we need 
+                # to find out the name of its flag type.
+                if ($field_name =~ /^requestee(_type)?-(\d+)$/) {
+                    my $flag_type;
+                    if ($1) {
+                        require Bugzilla::FlagType;
+                        $flag_type = new Bugzilla::FlagType($2);
+                    }
+                    else {
+                        require Bugzilla::Flag;
+                        my $flag = new Bugzilla::Flag($2);
+                        $flag_type = $flag->type if $flag;
+                    }
+                    if ($flag_type) {
+                        $expanded_fields->{$field_name}->{'flag_type'} = $flag_type;
+                    }
+                    else {
+                        # No need to look for a valid requestee if the flag(type)
+                        # has been deleted (may occur in race conditions).
+                        delete $expanded_fields->{$field_name};
+                        delete $data->{$field_name};
+                    }
+                }
+            }
+        }
+    }
+    $fields = $expanded_fields;
+
+    foreach my $field (keys %{$fields}) {
+        next unless defined $data->{$field};
+
+        #Concatenate login names, so that we have a common way to handle them.
+        my $raw_field;
+        if (ref $data->{$field}) {
+            $raw_field = join(",", @{$data->{$field}});
+        }
+        else {
+            $raw_field = $data->{$field};
+        }
+        $raw_field = clean_text($raw_field || '');
+
+        # Now we either split $raw_field by spaces/commas and put the list
+        # into @queries, or in the case of fields which only accept single
+        # entries, we simply use the verbatim text.
+        my @queries;
+        if ($fields->{$field}->{'type'} eq 'single') {
+            @queries = ($raw_field);
+            # We will repopulate it later if a match is found, else it must
+            # be set to an empty string so that the field remains defined.
+            $data->{$field} = '';
+        }
+        elsif ($fields->{$field}->{'type'} eq 'multi') {
+            @queries =  split(/[,;]+/, $raw_field);
+            # We will repopulate it later if a match is found, else it must
+            # be undefined.
+            delete $data->{$field};
+        }
+        else {
+            # bad argument
+            ThrowCodeError('bad_arg',
+                           { argument => $fields->{$field}->{'type'},
+                             function =>  'Bugzilla::User::match_field',
+                           });
+        }
+
+        # Tolerate fields that do not exist (in case you specify
+        # e.g. the QA contact, and it's currently not in use).
+        next unless (defined $raw_field && $raw_field ne '');
+
+        my $limit = 0;
+        if ($params->{'maxusermatches'}) {
+            $limit = $params->{'maxusermatches'} + 1;
+        }
+
+        my @logins;
+        for my $query (@queries) {
+            $query = trim($query);
+            next if $query eq '';
+
+            my $users = match(
+                $query,   # match string
+                $limit,   # match limit
+                1         # exclude_disabled
+            );
+
+            # here is where it checks for multiple matches
+            if (scalar(@{$users}) == 1) { # exactly one match
+                push(@logins, @{$users}[0]->login);
+
+                # skip confirmation for exact matches
+                next if (lc(@{$users}[0]->login) eq lc($query));
+
+                $matches->{$field}->{$query}->{'status'} = 'success';
+                $need_confirm = 1 if $params->{'confirmuniqueusermatch'};
+
+            }
+            elsif ((scalar(@{$users}) > 1)
+                    && ($params->{'maxusermatches'} != 1)) {
+                $need_confirm = 1;
+                $match_multiple = 1;
+                push(@non_conclusive_fields, $field);
+
+                if (($params->{'maxusermatches'})
+                   && (scalar(@{$users}) > $params->{'maxusermatches'}))
+                {
+                    $matches->{$field}->{$query}->{'status'} = 'trunc';
+                    pop @{$users};  # take the last one out
+                }
+                else {
+                    $matches->{$field}->{$query}->{'status'} = 'success';
+                }
+
+            }
+            else {
+                # everything else fails
+                $matchsuccess = 0; # fail
+                push(@non_conclusive_fields, $field);
+                $matches->{$field}->{$query}->{'status'} = 'fail';
+                $need_confirm = 1;  # confirmation screen shows failures
+            }
+
+            $matches->{$field}->{$query}->{'users'}  = $users;
+        }
+
+        # If no match or more than one match has been found for a field
+        # expecting only one match (type eq "single"), we set it back to ''
+        # so that the caller of this function can still check whether this
+        # field was defined or not (and it was if we came here).
+        if ($fields->{$field}->{'type'} eq 'single') {
+            $data->{$field} = $logins[0] || '';
+        }
+        elsif (scalar @logins) {
+            $data->{$field} = \@logins;
+        }
+    }
+
+    my $retval;
+    if (!$matchsuccess) {
+        $retval = USER_MATCH_FAILED;
+    }
+    elsif ($match_multiple) {
+        $retval = USER_MATCH_MULTIPLE;
+    }
+    else {
+        $retval = USER_MATCH_SUCCESS;
+    }
+
+    # Skip confirmation if we were told to, or if we don't need to confirm.
+    if ($behavior == MATCH_SKIP_CONFIRM || !$need_confirm) {
+        return wantarray ? ($retval, \@non_conclusive_fields) : $retval;
+    }
+
+    my $template = Bugzilla->template;
+    my $cgi = Bugzilla->cgi;
+    my $vars = {};
+
+    $vars->{'script'}        = $cgi->url(-relative => 1); # for self-referencing URLs
+    $vars->{'fields'}        = $fields; # fields being matched
+    $vars->{'matches'}       = $matches; # matches that were made
+    $vars->{'matchsuccess'}  = $matchsuccess; # continue or fail
+    $vars->{'matchmultiple'} = $match_multiple;
+
+    print $cgi->header();
+
+    $template->process("global/confirm-user-match.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+
+}
+
+# Changes in some fields automatically trigger events. The field names are
+# from the fielddefs table.
+our %names_to_events = (
+    'resolution'              => EVT_OPENED_CLOSED,
+    'keywords'                => EVT_KEYWORD,
+    'cc'                      => EVT_CC,
+    'bug_severity'            => EVT_PROJ_MANAGEMENT,
+    'priority'                => EVT_PROJ_MANAGEMENT,
+    'bug_status'              => EVT_PROJ_MANAGEMENT,
+    'target_milestone'        => EVT_PROJ_MANAGEMENT,
+    'attachments.description' => EVT_ATTACHMENT_DATA,
+    'attachments.mimetype'    => EVT_ATTACHMENT_DATA,
+    'attachments.ispatch'     => EVT_ATTACHMENT_DATA,
+    'dependson'               => EVT_DEPEND_BLOCK,
+    'blocked'                 => EVT_DEPEND_BLOCK,
+    'product'                 => EVT_COMPONENT,
+    'component'               => EVT_COMPONENT);
+
+# Returns true if the user wants mail for a given bug change.
+# Note: the "+" signs before the constants suppress bareword quoting.
+sub wants_bug_mail {
+    my $self = shift;
+    my ($bug, $relationship, $fieldDiffs, $comments, $dep_mail, $changer) = @_;
+
+    # Make a list of the events which have happened during this bug change,
+    # from the point of view of this user.    
+    my %events;    
+    foreach my $change (@$fieldDiffs) {
+        my $fieldName = $change->{field_name};
+        # A change to any of the above fields sets the corresponding event
+        if (defined($names_to_events{$fieldName})) {
+            $events{$names_to_events{$fieldName}} = 1;
+        }
+        else {
+            # Catch-all for any change not caught by a more specific event
+            $events{+EVT_OTHER} = 1;
+        }
+
+        # If the user is in a particular role and the value of that role
+        # changed, we need the ADDED_REMOVED event.
+        if (($fieldName eq "assigned_to" && $relationship == REL_ASSIGNEE) ||
+            ($fieldName eq "qa_contact" && $relationship == REL_QA))
+        {
+            $events{+EVT_ADDED_REMOVED} = 1;
+        }
+        
+        if ($fieldName eq "cc") {
+            my $login = $self->login;
+            my $inold = ($change->{old} =~ /^(.*,\s*)?\Q$login\E(,.*)?$/);
+            my $innew = ($change->{new} =~ /^(.*,\s*)?\Q$login\E(,.*)?$/);
+            if ($inold != $innew)
+            {
+                $events{+EVT_ADDED_REMOVED} = 1;
+            }
+        }
+    }
+
+    if (!$bug->lastdiffed) {
+        # Notify about new bugs.
+        $events{+EVT_BUG_CREATED} = 1;
+
+        # You role is new if the bug itself is.
+        # Only makes sense for the assignee, QA contact and the CC list.
+        if ($relationship == REL_ASSIGNEE
+            || $relationship == REL_QA
+            || $relationship == REL_CC)
+        {
+            $events{+EVT_ADDED_REMOVED} = 1;
+        }
+    }
+
+    if (grep { $_->type == CMT_ATTACHMENT_CREATED } @$comments) {
+        $events{+EVT_ATTACHMENT} = 1;
+    }
+    elsif (defined($$comments[0])) {
+        $events{+EVT_COMMENT} = 1;
+    }
+    
+    # Dependent changed bugmails must have an event to ensure the bugmail is
+    # emailed.
+    if ($dep_mail) {
+        $events{+EVT_DEPEND_BLOCK} = 1;
+    }
+
+    my @event_list = keys %events;
+    
+    my $wants_mail = $self->wants_mail(\@event_list, $relationship);
+
+    # The negative events are handled separately - they can't be incorporated
+    # into the first wants_mail call, because they are of the opposite sense.
+    # 
+    # We do them separately because if _any_ of them are set, we don't want
+    # the mail.
+    if ($wants_mail && $changer && ($self->id == $changer->id)) {
+        $wants_mail &= $self->wants_mail([EVT_CHANGED_BY_ME], $relationship);
+    }    
+    
+    if ($wants_mail && $bug->bug_status eq 'UNCONFIRMED') {
+        $wants_mail &= $self->wants_mail([EVT_UNCONFIRMED], $relationship);
+    }
+    
+    return $wants_mail;
+}
+
+# Returns true if the user wants mail for a given set of events.
+sub wants_mail {
+    my $self = shift;
+    my ($events, $relationship) = @_;
+    
+    # Don't send any mail, ever, if account is disabled 
+    # XXX Temporary Compatibility Change 1 of 2:
+    # This code is disabled for the moment to make the behaviour like the old
+    # system, which sent bugmail to disabled accounts.
+    # return 0 if $self->{'disabledtext'};
+    
+    # No mail if there are no events
+    return 0 if !scalar(@$events);
+
+    # If a relationship isn't given, default to REL_ANY.
+    if (!defined($relationship)) {
+        $relationship = REL_ANY;
+    }
+
+    # Skip DB query if relationship is explicit
+    return 1 if $relationship == REL_GLOBAL_WATCHER;
+
+    my $wants_mail = grep { $self->mail_settings->{$relationship}{$_} } @$events;
+    return $wants_mail ? 1 : 0;
+}
+
+sub mail_settings {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    if (!defined $self->{'mail_settings'}) {
+        my $data =
+          $dbh->selectall_arrayref('SELECT relationship, event FROM email_setting
+                                    WHERE user_id = ?', undef, $self->id);
+        my %mail;
+        # The hash is of the form $mail{$relationship}{$event} = 1.
+        $mail{$_->[0]}{$_->[1]} = 1 foreach @$data;
+
+        $self->{'mail_settings'} = \%mail;
+    }
+    return $self->{'mail_settings'};
+}
+
+sub has_audit_entries {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    if (!exists $self->{'has_audit_entries'}) {
+        $self->{'has_audit_entries'} =
+            $dbh->selectrow_array('SELECT 1 FROM audit_log WHERE user_id = ? ' .
+                                   $dbh->sql_limit(1), undef, $self->id);
+    }
+    return $self->{'has_audit_entries'};
+}
+
+sub is_insider {
+    my $self = shift;
+
+    if (!defined $self->{'is_insider'}) {
+        my $insider_group = Bugzilla->params->{'insidergroup'};
+        $self->{'is_insider'} =
+            ($insider_group && $self->in_group($insider_group)) ? 1 : 0;
+    }
+    return $self->{'is_insider'};
+}
+
+sub is_global_watcher {
+    my $self = shift;
+
+    if (!defined $self->{'is_global_watcher'}) {
+        my @watchers = split(/[,;]+/, Bugzilla->params->{'globalwatchers'});
+        $self->{'is_global_watcher'} = scalar(grep { $_ eq $self->login } @watchers) ? 1 : 0;
+    }
+    return  $self->{'is_global_watcher'};
+}
+
+sub is_timetracker {
+    my $self = shift;
+
+    if (!defined $self->{'is_timetracker'}) {
+        my $tt_group = Bugzilla->params->{'timetrackinggroup'};
+        $self->{'is_timetracker'} =
+            ($tt_group && $self->in_group($tt_group)) ? 1 : 0;
+    }
+    return $self->{'is_timetracker'};
+}
+
+sub get_userlist {
+    my $self = shift;
+
+    return $self->{'userlist'} if defined $self->{'userlist'};
+
+    my $dbh = Bugzilla->dbh;
+    my $query  = "SELECT DISTINCT login_name, realname,";
+    if (Bugzilla->params->{'usevisibilitygroups'}) {
+        $query .= " COUNT(group_id) ";
+    } else {
+        $query .= " 1 ";
+    }
+    $query     .= "FROM profiles ";
+    if (Bugzilla->params->{'usevisibilitygroups'}) {
+        $query .= "LEFT JOIN user_group_map " .
+                  "ON user_group_map.user_id = userid AND isbless = 0 " .
+                  "AND group_id IN(" .
+                  join(', ', (-1, @{$self->visible_groups_inherited})) . ")";
+    }
+    $query    .= " WHERE is_enabled = 1 ";
+    $query    .= $dbh->sql_group_by('userid', 'login_name, realname');
+
+    my $sth = $dbh->prepare($query);
+    $sth->execute;
+
+    my @userlist;
+    while (my($login, $name, $visible) = $sth->fetchrow_array) {
+        push @userlist, {
+            login => $login,
+            identity => $name ? "$name <$login>" : $login,
+            visible => $visible,
+        };
+    }
+    @userlist = sort { lc $$a{'identity'} cmp lc $$b{'identity'} } @userlist;
+
+    $self->{'userlist'} = \@userlist;
+    return $self->{'userlist'};
+}
+
+sub create {
+    my $invocant = shift;
+    my $class = ref($invocant) || $invocant;
+    my $dbh = Bugzilla->dbh;
+
+    $dbh->bz_start_transaction();
+
+    my $user = $class->SUPER::create(@_);
+
+    # Turn on all email for the new user
+    require Bugzilla::BugMail;
+    my %relationships = Bugzilla::BugMail::relationships();
+    foreach my $rel (keys %relationships) {
+        foreach my $event (POS_EVENTS, NEG_EVENTS) {
+            # These "exceptions" define the default email preferences.
+            # 
+            # We enable mail unless the change was made by the user, or it's
+            # just a CC list addition and the user is not the reporter.
+            next if ($event == EVT_CHANGED_BY_ME);
+            next if (($event == EVT_CC) && ($rel != REL_REPORTER));
+
+            $dbh->do('INSERT INTO email_setting (user_id, relationship, event)
+                      VALUES (?, ?, ?)', undef, ($user->id, $rel, $event));
+        }
+    }
+
+    foreach my $event (GLOBAL_EVENTS) {
+        $dbh->do('INSERT INTO email_setting (user_id, relationship, event)
+                  VALUES (?, ?, ?)', undef, ($user->id, REL_ANY, $event));
+    }
+
+    $user->derive_regexp_groups();
+
+    # Add the creation date to the profiles_activity table.
+    # $who is the user who created the new user account, i.e. either an
+    # admin or the new user himself.
+    my $who = Bugzilla->user->id || $user->id;
+    my $creation_date_fieldid = get_field_id('creation_ts');
+
+    $dbh->do('INSERT INTO profiles_activity
+                          (userid, who, profiles_when, fieldid, newvalue)
+                   VALUES (?, ?, NOW(), ?, NOW())',
+                   undef, ($user->id, $who, $creation_date_fieldid));
+
+    $dbh->bz_commit_transaction();
+
+    # Return the newly created user account.
+    return $user;
+}
+
+###########################
+# Account Lockout Methods #
+###########################
+
+sub account_is_locked_out {
+    my $self = shift;
+    my $login_failures = scalar @{ $self->account_ip_login_failures };
+    return $login_failures >= MAX_LOGIN_ATTEMPTS ? 1 : 0;
+}
+
+sub note_login_failure {
+    my $self = shift;
+    my $ip_addr = remote_ip();
+    trick_taint($ip_addr);
+    Bugzilla->dbh->do("INSERT INTO login_failure (user_id, ip_addr, login_time)
+                       VALUES (?, ?, LOCALTIMESTAMP(0))",
+                      undef, $self->id, $ip_addr);
+    delete $self->{account_ip_login_failures};
+}
+
+sub clear_login_failures {
+    my $self = shift;
+    my $ip_addr = remote_ip();
+    trick_taint($ip_addr);
+    Bugzilla->dbh->do(
+        'DELETE FROM login_failure WHERE user_id = ? AND ip_addr = ?',
+        undef, $self->id, $ip_addr);
+    delete $self->{account_ip_login_failures};
+}
+
+sub account_ip_login_failures {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+    my $time = $dbh->sql_date_math('LOCALTIMESTAMP(0)', '-', 
+                                   LOGIN_LOCKOUT_INTERVAL, 'MINUTE');
+    my $ip_addr = remote_ip();
+    trick_taint($ip_addr);
+    $self->{account_ip_login_failures} ||= Bugzilla->dbh->selectall_arrayref(
+        "SELECT login_time, ip_addr, user_id FROM login_failure
+          WHERE user_id = ? AND login_time > $time
+                AND ip_addr = ?
+       ORDER BY login_time", {Slice => {}}, $self->id, $ip_addr);
+    return $self->{account_ip_login_failures};
+}
+
+###############
+# Subroutines #
+###############
+
+sub is_available_username {
+    my ($username, $old_username) = @_;
+
+    if(login_to_id($username) != 0) {
+        return 0;
+    }
+
+    my $dbh = Bugzilla->dbh;
+    # $username is safe because it is only used in SELECT placeholders.
+    trick_taint($username);
+    # Reject if the new login is part of an email change which is
+    # still in progress
+    #
+    # substring/locate stuff: bug 165221; this used to use regexes, but that
+    # was unsafe and required weird escaping; using substring to pull out
+    # the new/old email addresses and sql_position() to find the delimiter (':')
+    # is cleaner/safer
+    my ($tokentype, $eventdata) = $dbh->selectrow_array(
+        "SELECT tokentype, eventdata
+           FROM tokens
+          WHERE (tokentype = 'emailold'
+                AND SUBSTRING(eventdata, 1, (" .
+                    $dbh->sql_position(q{':'}, 'eventdata') . "-  1)) = ?)
+             OR (tokentype = 'emailnew'
+                AND SUBSTRING(eventdata, (" .
+                    $dbh->sql_position(q{':'}, 'eventdata') . "+ 1), LENGTH(eventdata)) = ?)",
+         undef, ($username, $username));
+
+    if ($eventdata) {
+        # Allow thru owner of token
+        if ($old_username
+            && (($tokentype eq 'emailnew' && $eventdata eq "$old_username:$username")
+                || ($tokentype eq 'emailold' && $eventdata eq "$username:$old_username")))
+        {
+            return 1;
+        }
+        return 0;
+    }
+
+    return 1;
+}
+
+sub check_account_creation_enabled {
+    my $self = shift;
+
+    # If we're using e.g. LDAP for login, then we can't create a new account.
+    $self->authorizer->user_can_create_account
+      || ThrowUserError('auth_cant_create_account');
+
+    Bugzilla->params->{'createemailregexp'}
+      || ThrowUserError('account_creation_disabled');
+}
+
+sub check_and_send_account_creation_confirmation {
+    my ($self, $login) = @_;
+
+    $login = $self->check_login_name($login);
+    my $creation_regexp = Bugzilla->params->{'createemailregexp'};
+
+    if ($login !~ /$creation_regexp/i) {
+        ThrowUserError('account_creation_restricted');
+    }
+
+    # Create and send a token for this new account.
+    require Bugzilla::Token;
+    Bugzilla::Token::issue_new_user_account_token($login);
+}
+
+# This is used in a few performance-critical areas where we don't want to
+# do check() and pull all the user data from the database.
+sub login_to_id {
+    my ($login, $throw_error) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $cache = Bugzilla->request_cache->{user_login_to_id} ||= {};
+
+    # We cache lookups because this function showed up as taking up a 
+    # significant amount of time in profiles of xt/search.t. However,
+    # for users that don't exist, we re-do the check every time, because
+    # otherwise we break is_available_username.
+    my $user_id;
+    if (defined $cache->{$login}) {
+        $user_id = $cache->{$login};
+    }
+    else {
+        # No need to validate $login -- it will be used by the following SELECT
+        # statement only, so it's safe to simply trick_taint.
+        trick_taint($login);
+        $user_id = $dbh->selectrow_array(
+            "SELECT userid FROM profiles 
+              WHERE " . $dbh->sql_istrcmp('login_name', '?'), undef, $login);
+        $cache->{$login} = $user_id;
+    }
+
+    if ($user_id) {
+        return $user_id;
+    } elsif ($throw_error) {
+        ThrowUserError('invalid_username', { name => $login });
+    } else {
+        return 0;
+    }
+}
+
+sub user_id_to_login {
+    my $user_id = shift;
+    my $dbh = Bugzilla->dbh;
+
+    return '' unless ($user_id && detaint_natural($user_id));
+
+    my $login = $dbh->selectrow_array('SELECT login_name FROM profiles
+                                       WHERE userid = ?', undef, $user_id);
+    return $login || '';
+}
+
+sub validate_password {
+    my ($password, $matchpassword) = @_;
+
+    if (length($password) < USER_PASSWORD_MIN_LENGTH) {
+        ThrowUserError('password_too_short');
+    } elsif ((defined $matchpassword) && ($password ne $matchpassword)) {
+        ThrowUserError('passwords_dont_match');
+    }
+    
+    my $complexity_level = Bugzilla->params->{password_complexity};
+    if ($complexity_level eq 'letters_numbers_specialchars') {
+        ThrowUserError('password_not_complex')
+          if ($password !~ /\w/ || $password !~ /\d/ || $password !~ /[[:punct:]]/);
+    } elsif ($complexity_level eq 'letters_numbers') {
+        ThrowUserError('password_not_complex')
+          if ($password !~ /[[:lower:]]/ || $password !~ /[[:upper:]]/ || $password !~ /\d/);
+    } elsif ($complexity_level eq 'mixed_letters') {
+        ThrowUserError('password_not_complex')
+          if ($password !~ /[[:lower:]]/ || $password !~ /[[:upper:]]/);
+    }
+
+    # Having done these checks makes us consider the password untainted.
+    trick_taint($_[0]);
+    return 1;
+}
+
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::User - Object for a Bugzilla user
+
+=head1 SYNOPSIS
+
+  use Bugzilla::User;
+
+  my $user = new Bugzilla::User($id);
+
+  my @get_selectable_classifications = 
+      $user->get_selectable_classifications;
+
+  # Class Functions
+  $user = Bugzilla::User->create({ 
+      login_name    => $username, 
+      realname      => $realname, 
+      cryptpassword => $plaintext_password, 
+      disabledtext  => $disabledtext,
+      disable_mail  => 0});
+
+=head1 DESCRIPTION
+
+This package handles Bugzilla users. Data obtained from here is read-only;
+there is currently no way to modify a user from this package.
+
+Note that the currently logged in user (if any) is available via
+L<Bugzilla-E<gt>user|Bugzilla/"user">.
+
+C<Bugzilla::User> is an implementation of L<Bugzilla::Object>, and thus
+provides all the methods of L<Bugzilla::Object> in addition to the
+methods listed below.
+
+=head1 CONSTANTS
+
+=over
+
+=item C<USER_MATCH_MULTIPLE>
+
+Returned by C<match_field()> when at least one field matched more than 
+one user, but no matches failed.
+
+=item C<USER_MATCH_FAILED>
+
+Returned by C<match_field()> when at least one field failed to match 
+anything.
+
+=item C<USER_MATCH_SUCCESS>
+
+Returned by C<match_field()> when all fields successfully matched only one
+user.
+
+=item C<MATCH_SKIP_CONFIRM>
+
+Passed in to match_field to tell match_field to never display a 
+confirmation screen.
+
+=back
+
+=head1 METHODS
+
+=head2 Constructors
+
+=over
+
+=item C<super_user>
+
+Returns a user who is in all groups, but who does not really exist in the
+database. Used for non-web scripts like L<checksetup> that need to make 
+database changes and so on.
+
+=back
+
+=head2 Saved and Shared Queries
+
+=over
+
+=item C<queries>
+
+Returns an arrayref of the user's own saved queries, sorted by name. The 
+array contains L<Bugzilla::Search::Saved> objects.
+
+=item C<queries_subscribed>
+
+Returns an arrayref of shared queries that the user has subscribed to.
+That is, these are shared queries that the user sees in their footer.
+This array contains L<Bugzilla::Search::Saved> objects.
+
+=item C<queries_available>
+
+Returns an arrayref of all queries to which the user could possibly
+subscribe. This includes the contents of L</queries_subscribed>.
+An array of L<Bugzilla::Search::Saved> objects.
+
+=item C<flush_queries_cache>
+
+Some code modifies the set of stored queries. Because C<Bugzilla::User> does
+not handle these modifications, but does cache the result of calling C<queries>
+internally, such code must call this method to flush the cached result.
+
+=item C<queryshare_groups>
+
+An arrayref of group ids. The user can share their own queries with these
+groups.
+
+=item C<tags>
+
+Returns a hashref with tag IDs as key, and a hashref with tag 'id',
+'name' and 'bug_count' as value.
+
+=back
+
+=head2 Saved Recent Bug Lists
+
+=over
+
+=item C<recent_searches>
+
+Returns an arrayref of L<Bugzilla::Search::Recent> objects
+containing the user's recent searches.
+
+=item C<recent_search_containing(bug_id)>
+
+Returns a L<Bugzilla::Search::Recent> object that contains the most recent
+search by the user for the specified bug id. Retuns undef if no match is found.
+
+=item C<recent_search_for(bug)>
+
+Returns a L<Bugzilla::Search::Recent> object that contains a search by the
+user. Uses the list_id of the current loaded page, or the referrer page, and
+the bug id if that fails. Finally it will check the BUGLIST cookie, and create
+an object based on that, or undef if it does not exist.
+
+=item C<save_last_search>
+
+Saves the users most recent search in the database if logged in, or in the
+BUGLIST cookie if not logged in. Parameters are bug_ids, order, vars and
+list_id.
+
+=back
+
+=head2 Account Lockout
+
+=over
+
+=item C<account_is_locked_out>
+
+Returns C<1> if the account has failed to log in too many times recently,
+and thus is locked out for a period of time. Returns C<0> otherwise.
+
+=item C<account_ip_login_failures>
+
+Returns an arrayref of hashrefs, that contains information about the recent
+times that this account has failed to log in from the current remote IP.
+The hashes contain C<ip_addr>, C<login_time>, and C<user_id>.
+
+=item C<note_login_failure>
+
+This notes that this account has failed to log in, and stores the fact
+in the database. The storing happens immediately, it does not wait for
+you to call C<update>.
+
+=back
+
+=head2 Other Methods
+
+=over
+
+=item C<id>
+
+Returns the userid for this user.
+
+=item C<login>
+
+Returns the login name for this user.
+
+=item C<email>
+
+Returns the user's email address. Currently this is the same value as the
+login.
+
+=item C<name>
+
+Returns the 'real' name for this user, if any.
+
+=item C<showmybugslink>
+
+Returns C<1> if the user has set his preference to show the 'My Bugs' link in
+the page footer, and C<0> otherwise.
+
+=item C<identity>
+
+Returns a string for the identity of the user. This will be of the form
+C<name E<lt>emailE<gt>> if the user has specified a name, and C<email>
+otherwise.
+
+=item C<nick>
+
+Returns a user "nickname" -- i.e. a shorter, not-necessarily-unique name by
+which to identify the user. Currently the part of the user's email address
+before the at sign (@), but that could change, especially if we implement
+usernames not dependent on email address.
+
+=item C<authorizer>
+
+This is the L<Bugzilla::Auth> object that the User logged in with.
+If the user hasn't logged in yet, a new, empty Bugzilla::Auth() object is
+returned.
+
+=item C<set_authorizer($authorizer)>
+
+Sets the L<Bugzilla::Auth> object to be returned by C<authorizer()>.
+Should only be called by C<Bugzilla::Auth::login>, for the most part.
+
+=item C<disabledtext>
+
+Returns the disable text of the user, if any.
+
+=item C<reports>
+
+Returns an arrayref of the user's own saved reports. The array contains 
+L<Bugzilla::Reports> objects.
+
+=item C<flush_reports_cache>
+
+Some code modifies the set of stored reports. Because C<Bugzilla::User> does
+not handle these modifications, but does cache the result of calling C<reports>
+internally, such code must call this method to flush the cached result.
+
+=item C<settings>
+
+Returns a hash of hashes which holds the user's settings. The first key is
+the name of the setting, as found in setting.name. The second key is one of:
+is_enabled     - true if the user is allowed to set the preference themselves;
+                 false to force the site defaults
+                 for themselves or must accept the global site default value
+default_value  - the global site default for this setting
+value          - the value of this setting for this user. Will be the same
+                 as the default_value if the user is not logged in, or if 
+                 is_default is true.
+is_default     - a boolean to indicate whether the user has chosen to make
+                 a preference for themself or use the site default.
+
+=item C<setting(name)>
+
+Returns the value for the specified setting.
+
+=item C<timezone>
+
+Returns the timezone used to display dates and times to the user,
+as a DateTime::TimeZone object.
+
+=item C<groups>
+
+Returns an arrayref of L<Bugzilla::Group> objects representing
+groups that this user is a member of.
+
+=item C<groups_as_string>
+
+Returns a string containing a comma-separated list of numeric group ids.  If
+the user is not a member of any groups, returns "-1". This is most often used
+within an SQL IN() function.
+
+=item C<groups_in_sql>
+
+This returns an C<IN> clause for SQL, containing either all of the groups
+the user is in, or C<-1> if the user is in no groups. This takes one
+argument--the name of the SQL field that should be on the left-hand-side
+of the C<IN> statement, which defaults to C<group_id> if not specified.
+
+=item C<in_group($group_name, $product_id)>
+
+Determines whether or not a user is in the given group by name.
+If $product_id is given, it also checks for local privileges for
+this product.
+
+=item C<in_group_id>
+
+Determines whether or not a user is in the given group by id. 
+
+=item C<bless_groups>
+
+Returns an arrayref of L<Bugzilla::Group> objects.
+
+The arrayref consists of the groups the user can bless, taking into account
+that having editusers permissions means that you can bless all groups, and
+that you need to be able to see a group in order to bless it.
+
+=item C<get_products_by_permission($group)>
+
+Returns a list of product objects for which the user has $group privileges
+and which he can access.
+$group must be one of the groups defined in PER_PRODUCT_PRIVILEGES.
+
+=item C<can_see_user(user)>
+
+Returns 1 if the specified user account exists and is visible to the user,
+0 otherwise.
+
+=item C<can_edit_product(prod_id)>
+
+Determines if, given a product id, the user can edit bugs in this product
+at all.
+
+=item C<can_see_bug(bug_id)>
+
+Determines if the user can see the specified bug.
+
+=item C<can_see_product(product_name)>
+
+Returns 1 if the user can access the specified product, and 0 if the user
+should not be aware of the existence of the product.
+
+=item C<derive_regexp_groups>
+
+Bugzilla allows for group inheritance. When data about the user (or any of the
+groups) changes, the database must be updated. Handling updated groups is taken
+care of by the constructor. However, when updating the email address, the
+user may be placed into different groups, based on a new email regexp. This
+method should be called in such a case to force reresolution of these groups.
+
+=item C<clear_product_cache>
+
+Clears the stored values for L</get_selectable_products>, 
+L</get_enterable_products>, etc. so that their data will be read from
+the database again. Used mostly by L<Bugzilla::Product>.
+
+=item C<get_selectable_products>
+
+ Description: Returns all products the user is allowed to access. This list
+              is restricted to some given classification if $classification_id
+              is given.
+
+ Params:      $classification_id - (optional) The ID of the classification
+                                   the products belong to.
+
+ Returns:     An array of product objects, sorted by the product name.
+
+=item C<get_selectable_classifications>
+
+ Description: Returns all classifications containing at least one product
+              the user is allowed to view.
+
+ Params:      none
+
+ Returns:     An array of Bugzilla::Classification objects, sorted by
+              the classification name.
+
+=item C<can_enter_product($product_name, $warn)>
+
+ Description: Returns a product object if the user can enter bugs into the
+              specified product.
+              If the user cannot enter bugs into the product, the behavior of
+              this method depends on the value of $warn:
+              - if $warn is false (or not given), a 'false' value is returned;
+              - if $warn is true, an error is thrown.
+
+ Params:      $product_name - a product name.
+              $warn         - optional parameter, indicating whether an error
+                              must be thrown if the user cannot enter bugs
+                              into the specified product.
+
+ Returns:     A product object if the user can enter bugs into the product,
+              0 if the user cannot enter bugs into the product and if $warn
+              is false (an error is thrown if $warn is true).
+
+=item C<get_enterable_products>
+
+ Description: Returns an array of product objects into which the user is
+              allowed to enter bugs.
+
+ Params:      none
+
+ Returns:     an array of product objects.
+
+=item C<can_access_product($product)>
+
+Returns 1 if the user can search or enter bugs into the specified product
+(either a L<Bugzilla::Product> or a product name), and 0 if the user should
+not be aware of the existence of the product.
+
+=item C<get_accessible_products>
+
+ Description: Returns an array of product objects the user can search
+              or enter bugs against.
+
+ Params:      none
+
+ Returns:     an array of product objects.
+
+=item C<check_can_admin_product($product_name)>
+
+ Description: Checks whether the user is allowed to administrate the product.
+
+ Params:      $product_name - a product name.
+
+ Returns:     On success, a product object. On failure, an error is thrown.
+
+=item C<check_can_admin_flagtype($flagtype_id)>
+
+ Description: Checks whether the user is allowed to edit properties of the flag type.
+              If the flag type is also used by some products for which the user
+              hasn't editcomponents privs, then the user is only allowed to edit
+              the inclusion and exclusion lists for products he can administrate.
+
+ Params:      $flagtype_id - a flag type ID.
+
+ Returns:     On success, a flag type object. On failure, an error is thrown.
+              In list context, a boolean indicating whether the user can edit
+              all properties of the flag type is also returned. The boolean
+              is false if the user can only edit the inclusion and exclusions
+              lists.
+
+=item C<can_request_flag($flag_type)>
+
+ Description: Checks whether the user can request flags of the given type.
+
+ Params:      $flag_type - a Bugzilla::FlagType object.
+
+ Returns:     1 if the user can request flags of the given type,
+              0 otherwise.
+
+=item C<can_set_flag($flag_type)>
+
+ Description: Checks whether the user can set flags of the given type.
+
+ Params:      $flag_type - a Bugzilla::FlagType object.
+
+ Returns:     1 if the user can set flags of the given type,
+              0 otherwise.
+
+=item C<get_userlist>
+
+Returns a reference to an array of users.  The array is populated with hashrefs
+containing the login, identity and visibility.  Users that are not visible to this
+user will have 'visible' set to zero.
+
+=item C<visible_groups_inherited>
+
+Returns a list of all groups whose members should be visible to this user.
+Since this list is flattened already, there is no need for all users to
+be have derived groups up-to-date to select the users meeting this criteria.
+
+=item C<visible_groups_direct>
+
+Returns a list of groups that the user is aware of.
+
+=item C<visible_groups_as_string>
+
+Returns the result of C<visible_groups_inherited> as a string (a comma-separated
+list).
+
+=item C<product_responsibilities>
+
+Retrieve user's product responsibilities as a list of component objects.
+Each object is a component the user has a responsibility for.
+
+=item C<can_bless>
+
+When called with no arguments:
+Returns C<1> if the user can bless at least one group, returns C<0> otherwise.
+
+When called with one argument:
+Returns C<1> if the user can bless the group with that id, returns
+C<0> otherwise.
+
+=item C<wants_bug_mail>
+
+Returns true if the user wants mail for a given bug change.
+
+=item C<wants_mail>
+
+Returns true if the user wants mail for a given set of events. This method is
+more general than C<wants_bug_mail>, allowing you to check e.g. permissions
+for flag mail.
+
+=item C<is_insider>
+
+Returns true if the user can access private comments and attachments,
+i.e. if the 'insidergroup' parameter is set and the user belongs to this group.
+
+=item C<is_global_watcher>
+
+Returns true if the user is a global watcher,
+i.e. if the 'globalwatchers' parameter contains the user.
+
+=back
+
+=head1 CLASS FUNCTIONS
+
+These are functions that are not called on a User object, but instead are
+called "statically," just like a normal procedural function.
+
+=over 4
+
+=item C<create>
+
+The same as L<Bugzilla::Object/create>.
+
+Params: login_name - B<Required> The login name for the new user.
+        realname - The full name for the new user.
+        cryptpassword  - B<Required> The password for the new user.
+            Even though the name says "crypt", you should just specify
+            a plain-text password. If you specify '*', the user will not
+            be able to log in using DB authentication.
+        disabledtext - The disable-text for the new user. If given, the user 
+            will be disabled, meaning he cannot log in. Defaults to an
+            empty string.
+        disable_mail - If 1, bug-related mail will not be  sent to this user; 
+            if 0, mail will be sent depending on the user's  email preferences.
+
+=item C<check>
+
+Takes a username as its only argument. Throws an error if there is no
+user with that username. Returns a C<Bugzilla::User> object.
+
+=item C<check_account_creation_enabled>
+
+Checks that users can create new user accounts, and throws an error
+if user creation is disabled.
+
+=item C<check_and_send_account_creation_confirmation($login)>
+
+If the user request for a new account passes validation checks, an email
+is sent to this user for confirmation. Otherwise an error is thrown
+indicating why the request has been rejected.
+
+=item C<is_available_username>
+
+Returns a boolean indicating whether or not the supplied username is
+already taken in Bugzilla.
+
+Params: $username (scalar, string) - The full login name of the username 
+            that you are checking.
+        $old_username (scalar, string) - If you are checking an email-change
+            token, insert the "old" username that the user is changing from,
+            here. Then, as long as it's the right user for that token, he 
+            can change his username to $username. (That is, this function
+            will return a boolean true value).
+
+=item C<login_to_id($login, $throw_error)>
+
+Takes a login name of a Bugzilla user and changes that into a numeric
+ID for that user. This ID can then be passed to Bugzilla::User::new to
+create a new user.
+
+If no valid user exists with that login name, then the function returns 0.
+However, if $throw_error is set, the function will throw a user error
+instead of returning.
+
+This function can also be used when you want to just find out the userid
+of a user, but you don't want the full weight of Bugzilla::User.
+
+However, consider using a Bugzilla::User object instead of this function
+if you need more information about the user than just their ID.
+
+=item C<user_id_to_login($user_id)>
+
+Returns the login name of the user account for the given user ID. If no
+valid user ID is given or the user has no entry in the profiles table,
+we return an empty string.
+
+=item C<validate_password($passwd1, $passwd2)>
+
+Returns true if a password is valid (i.e. meets Bugzilla's
+requirements for length and content), else returns false.
+Untaints C<$passwd1> if successful.
+
+If a second password is passed in, this function also verifies that
+the two passwords match.
+
+=item C<match_field($data, $fields, $behavior)>
+
+=over
+
+=item B<Description>
+
+Wrapper for the C<match()> function.
+
+=item B<Params>
+
+=over
+
+=item C<$fields> - A hashref with field names as keys and a hash as values.
+Each hash is of the form { 'type' => 'single|multi' }, which specifies
+whether the field can take a single login name only or several.
+
+=item C<$data> (optional) - A hashref with field names as keys and field values
+as values. If undefined, C<Bugzilla-E<gt>input_params> is used.
+
+=item C<$behavior> (optional) - If set to C<MATCH_SKIP_CONFIRM>, no confirmation
+screen is displayed. In that case, the fields which don't match a unique user
+are left undefined. If not set, a confirmation screen is displayed if at
+least one field doesn't match any login name or match more than one.
+
+=back
+
+=item B<Returns>
+
+If the third parameter is set to C<MATCH_SKIP_CONFIRM>, the function returns
+either C<USER_MATCH_SUCCESS> if all fields can be set unambiguously,
+C<USER_MATCH_FAILED> if at least one field doesn't match any user account,
+or C<USER_MATCH_MULTIPLE> if some fields match more than one user account.
+
+If the third parameter is not set, then if all fields could be set
+unambiguously, nothing is returned, else a confirmation page is displayed.
+
+=item B<Note>
+
+This function must be called early in a script, before anything external
+is done with the data.
+
+=back
+
+=back
+
+=head1 SEE ALSO
+
+L<Bugzilla|Bugzilla>

diff --git a/Bugzilla/User/Setting.pm b/Bugzilla/User/Setting.pm
new file mode 100644 (file)
index 0000000..6fadfb3
--- /dev/null
+++ b/Bugzilla/User/Setting.pm
@@ -0,0 +1,417 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+package Bugzilla::User::Setting;
+
+use strict;
+use base qw(Exporter);
+
+
+# Module stuff
+@Bugzilla::User::Setting::EXPORT = qw(get_all_settings get_defaults
+     add_setting);
+
+use Bugzilla::Error;
+use Bugzilla::Util qw(trick_taint get_text);
+
+###############################
+###  Module Initialization  ###
+###############################
+
+sub new {
+    my $invocant = shift;
+    my $setting_name = shift;
+    my $user_id = shift;
+
+    my $class = ref($invocant) || $invocant;
+    my $subclass = '';
+
+    # Create a ref to an empty hash and bless it
+    my $self = {};
+
+    my $dbh = Bugzilla->dbh;
+
+    # Confirm that the $setting_name is properly formed;
+    # if not, throw a code error. 
+    # 
+    # NOTE: due to the way that setting names are used in templates,
+    # they must conform to to the limitations set for HTML NAMEs and IDs.
+    #
+    if ( !($setting_name =~ /^[a-zA-Z][-.:\w]*$/) ) {
+      ThrowCodeError("setting_name_invalid", { name => $setting_name });
+    }
+
+    # If there were only two parameters passed in, then we need
+    # to retrieve the information for this setting ourselves.
+    if (scalar @_ == 0) {
+
+        my ($default, $is_enabled, $value);
+        ($default, $is_enabled, $value, $subclass) = 
+          $dbh->selectrow_array(
+             q{SELECT default_value, is_enabled, setting_value, subclass
+                 FROM setting
+            LEFT JOIN profile_setting
+                   ON setting.name = profile_setting.setting_name
+                WHERE name = ?
+                  AND profile_setting.user_id = ?},
+             undef, 
+             $setting_name, $user_id);
+
+        # if not defined, then grab the default value
+        if (! defined $value) {
+            ($default, $is_enabled, $subclass) =
+              $dbh->selectrow_array(
+                 q{SELECT default_value, is_enabled, subclass
+                   FROM setting
+                   WHERE name = ?},
+              undef,
+              $setting_name);
+        }
+
+        $self->{'is_enabled'} = $is_enabled;
+        $self->{'default_value'} = $default;
+
+        # IF the setting is enabled, AND the user has chosen a setting
+        # THEN return that value
+        # ELSE return the site default, and note that it is the default.
+        if ( ($is_enabled) && (defined $value) ) {
+            $self->{'value'} = $value;
+        } else {
+            $self->{'value'} = $default;
+            $self->{'isdefault'} = 1;
+        }
+    }
+    else {
+        # If the values were passed in, simply assign them and return.
+        $self->{'is_enabled'}    = shift;
+        $self->{'default_value'} = shift;
+        $self->{'value'}         = shift;
+        $self->{'is_default'}    = shift;
+        $subclass                = shift;
+    }
+    if ($subclass) {
+        eval('require ' . $class . '::' . $subclass);
+        $@ && ThrowCodeError('setting_subclass_invalid',
+                             {'subclass' => $subclass});
+        $class = $class . '::' . $subclass;
+    }
+    bless($self, $class);
+
+    $self->{'_setting_name'} = $setting_name;
+    $self->{'_user_id'}      = $user_id;
+
+    return $self;
+}
+
+###############################
+###  Subroutine Definitions ###
+###############################
+
+sub add_setting {
+    my ($name, $values, $default_value, $subclass, $force_check,
+        $silently) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    my $exists = _setting_exists($name);
+    return if ($exists && !$force_check);
+
+    ($name && $default_value)
+      ||  ThrowCodeError("setting_info_invalid");
+
+    if ($exists) {
+        # If this setting exists, we delete it and regenerate it.
+        $dbh->do('DELETE FROM setting_value WHERE name = ?', undef, $name);
+        $dbh->do('DELETE FROM setting WHERE name = ?', undef, $name);
+        # Remove obsolete user preferences for this setting.
+        if (defined $values && scalar(@$values)) {
+            my $list = join(', ', map {$dbh->quote($_)} @$values);
+            $dbh->do("DELETE FROM profile_setting
+                      WHERE setting_name = ? AND setting_value NOT IN ($list)",
+                      undef, $name);
+        }
+    }
+    elsif (!$silently) {
+        print get_text('install_setting_new', { name => $name }) . "\n";
+    }
+    $dbh->do(q{INSERT INTO setting (name, default_value, is_enabled, subclass)
+                    VALUES (?, ?, 1, ?)},
+             undef, ($name, $default_value, $subclass));
+
+    my $sth = $dbh->prepare(q{INSERT INTO setting_value (name, value, sortindex)
+                                    VALUES (?, ?, ?)});
+
+    my $sortindex = 5;
+    foreach my $key (@$values){
+        $sth->execute($name, $key, $sortindex);
+        $sortindex += 5;
+    }
+}
+
+sub get_all_settings {
+    my ($user_id) = @_;
+    my $settings = {};
+    my $dbh = Bugzilla->dbh;
+
+    my $rows = $dbh->selectall_arrayref(
+           q{SELECT name, default_value, is_enabled, setting_value, subclass
+               FROM setting
+          LEFT JOIN profile_setting
+                 ON setting.name = profile_setting.setting_name
+                AND profile_setting.user_id = ?}, undef, ($user_id));
+
+    foreach my $row (@$rows) {
+        my ($name, $default_value, $is_enabled, $value, $subclass) = @$row; 
+
+        my $is_default;
+
+        if ( ($is_enabled) && (defined $value) ) {
+            $is_default = 0;
+        } else {
+            $value = $default_value;
+            $is_default = 1;
+        }
+
+        $settings->{$name} = new Bugzilla::User::Setting(
+           $name, $user_id, $is_enabled, 
+           $default_value, $value, $is_default, $subclass);
+    }
+
+    return $settings;
+}
+
+sub get_defaults {
+    my ($user_id) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $default_settings = {};
+
+    $user_id ||= 0;
+
+    my $rows = $dbh->selectall_arrayref(q{SELECT name, default_value, is_enabled, subclass
+                                            FROM setting});
+
+    foreach my $row (@$rows) {
+        my ($name, $default_value, $is_enabled, $subclass) = @$row;
+
+        $default_settings->{$name} = new Bugzilla::User::Setting(
+            $name, $user_id, $is_enabled, $default_value, $default_value, 1,
+            $subclass);
+    }
+
+    return $default_settings;
+}
+
+sub set_default {
+    my ($setting_name, $default_value, $is_enabled) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    my $sth = $dbh->prepare(q{UPDATE setting
+                                 SET default_value = ?, is_enabled = ?
+                               WHERE name = ?});
+    $sth->execute($default_value, $is_enabled, $setting_name);
+}
+
+sub _setting_exists {
+    my ($setting_name) = @_;
+    my $dbh = Bugzilla->dbh;
+    return $dbh->selectrow_arrayref(
+        "SELECT 1 FROM setting WHERE name = ?", undef, $setting_name) || 0;
+}
+
+
+sub legal_values {
+    my ($self) = @_;
+
+    return $self->{'legal_values'} if defined $self->{'legal_values'};
+
+    my $dbh = Bugzilla->dbh;
+    $self->{'legal_values'} = $dbh->selectcol_arrayref(
+              q{SELECT value
+                  FROM setting_value
+                 WHERE name = ?
+              ORDER BY sortindex},
+        undef, $self->{'_setting_name'});
+
+    return $self->{'legal_values'};
+}
+
+sub validate_value {
+    my $self = shift;
+
+    if (grep(/^$_[0]$/, @{$self->legal_values()})) {
+        trick_taint($_[0]);
+    }
+    else {
+        ThrowCodeError('setting_value_invalid',
+                       {'name'  => $self->{'_setting_name'},
+                        'value' => $_[0]});
+    }
+}
+
+sub reset_to_default {
+    my ($self) = @_;
+
+    my $dbh = Bugzilla->dbh;
+    my $sth = $dbh->do(q{ DELETE
+                            FROM profile_setting
+                           WHERE setting_name = ?
+                             AND user_id = ?},
+                       undef, $self->{'_setting_name'}, $self->{'_user_id'});
+      $self->{'value'}       = $self->{'default_value'};
+      $self->{'is_default'}  = 1;
+}
+
+sub set {
+    my ($self, $value) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $query;
+
+    if ($self->{'is_default'}) {
+        $query = q{INSERT INTO profile_setting
+                   (setting_value, setting_name, user_id)
+                   VALUES (?,?,?)};
+    } else {
+        $query = q{UPDATE profile_setting
+                      SET setting_value = ?
+                    WHERE setting_name = ?
+                      AND user_id = ?};
+    }
+    $dbh->do($query, undef, $value, $self->{'_setting_name'}, $self->{'_user_id'});
+
+    $self->{'value'}       = $value;
+    $self->{'is_default'}  = 0;
+}
+
+
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::User::Setting - Object for a user preference setting
+
+=head1 SYNOPSIS
+
+Setting.pm creates a setting object, which is a hash containing the user
+preference information for a single preference for a single user. These 
+are usually accessed through the "settings" object of a user, and not 
+directly.
+
+=head1 DESCRIPTION
+
+use Bugzilla::User::Setting;
+my $settings;
+
+$settings->{$setting_name} = new Bugzilla::User::Setting(
+   $setting_name, $user_id);
+
+OR
+
+$settings->{$setting_name} = new Bugzilla::User::Setting(
+   $setting_name, $user_id, $is_enabled,
+   $default_value, $value, $is_default);
+
+=head1 CLASS FUNCTIONS
+
+=over 4
+
+=item C<add_setting($name, \@values, $default_value, $subclass, $force_check)>
+
+Description: Checks for the existence of a setting, and adds it 
+             to the database if it does not yet exist.
+
+Params:      C<$name> - string - the name of the new setting
+             C<$values> - arrayref - contains the new choices
+               for the new Setting.
+             C<$default_value> - string - the site default
+             C<$subclass> - string - name of the module returning
+               the list of valid values. This means legal values are
+               not stored in the DB.
+             C<$force_check> - boolean - when true, the existing setting
+               and all its values are deleted and replaced by new data.
+
+Returns:     a pointer to a hash of settings
+
+
+=item C<get_all_settings($user_id)>
+
+Description: Provides the user's choices for each setting in the 
+             system; if the user has made no choice, uses the site
+             default instead.
+Params:      C<$user_id> - integer - the user id.
+Returns:     a pointer to a hash of settings
+
+=item C<get_defaults($user_id)>
+
+Description: When a user is not logged in, they must use the site
+             defaults for every settings; this subroutine provides them.
+Params:      C<$user_id> (optional) - integer - the user id.  Note that
+             this optional parameter is mainly for internal use only.
+Returns:     A pointer to a hash of settings.  If $user_id was passed, set
+             the user_id value for each setting.
+
+=item C<set_default($setting_name, $default_value, $is_enabled)>
+
+Description: Sets the global default for a given setting. Also sets
+             whether users are allowed to choose their own value for
+             this setting, or if they must use the global default.
+Params:      C<$setting_name> - string - the name of the setting
+             C<$default_value> - string - the new default value for this setting
+             C<$is_enabled> - boolean - if false, all users must use the global default
+Returns:     nothing
+
+=begin private
+
+=item C<_setting_exists>
+
+Description: Determines if a given setting exists in the database.
+Params:      C<$setting_name> - string - the setting name
+Returns:     boolean - true if the setting already exists in the DB.
+
+=end private
+
+=back
+
+=head1 METHODS
+
+=over 4
+
+=item C<legal_values($setting_name)>
+
+Description: Returns all legal values for this setting
+Params:      none
+Returns:     A reference to an array containing all legal values
+
+=item C<validate_value>
+
+Description: Determines whether a value is valid for the setting
+             by checking against the list of legal values.
+             Untaints the parameter if the value is indeed valid,
+             and throws a setting_value_invalid code error if not.
+Params:      An lvalue containing a candidate for a setting value
+Returns:     nothing
+
+=item C<reset_to_default>
+
+Description: If a user chooses to use the global default for a given 
+             setting, their saved entry is removed from the database via 
+             this subroutine.
+Params:      none
+Returns:     nothing
+
+=item C<set($value)>
+
+Description: If a user chooses to use their own value rather than the 
+             global value for a given setting, OR changes their value for
+             a given setting, this subroutine is called to insert or 
+             update the database as appropriate.
+Params:      C<$value> - string - the new value for this setting for this user.
+Returns:     nothing
+
+=back

diff --git a/Bugzilla/User/Setting/Lang.pm b/Bugzilla/User/Setting/Lang.pm
new file mode 100644 (file)
index 0000000..71b01d6
--- /dev/null
+++ b/Bugzilla/User/Setting/Lang.pm
@@ -0,0 +1,47 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::User::Setting::Lang;
+
+use strict;
+
+use base qw(Bugzilla::User::Setting);
+
+use Bugzilla::Constants;
+
+sub legal_values {
+    my ($self) = @_;
+
+    return $self->{'legal_values'} if defined $self->{'legal_values'};
+
+    return $self->{'legal_values'} = Bugzilla->languages;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::User::Setting::Lang - Object for a user preference setting for preferred language
+
+=head1 DESCRIPTION
+
+Lang.pm extends Bugzilla::User::Setting and implements a class specialized for
+setting the preferred language.
+
+=head1 METHODS
+
+=over
+
+=item C<legal_values()>
+
+Description: Returns all legal languages
+Params:      none
+Returns:     A reference to an array containing the names of all legal languages
+
+=back

diff --git a/Bugzilla/User/Setting/Skin.pm b/Bugzilla/User/Setting/Skin.pm
new file mode 100644 (file)
index 0000000..c75ce75
--- /dev/null
+++ b/Bugzilla/User/Setting/Skin.pm
@@ -0,0 +1,65 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+package Bugzilla::User::Setting::Skin;
+
+use strict;
+
+use base qw(Bugzilla::User::Setting);
+
+use Bugzilla::Constants;
+use File::Spec::Functions;
+use File::Basename;
+
+use constant BUILTIN_SKIN_NAMES => ['standard'];
+
+sub legal_values {
+    my ($self) = @_;
+
+    return $self->{'legal_values'} if defined $self->{'legal_values'};
+
+    my $dirbase = bz_locations()->{'skinsdir'} . '/contrib';
+    # Avoid modification of the list BUILTIN_SKIN_NAMES points to by copying the
+    # list over instead of simply writing $legal_values = BUILTIN_SKIN_NAMES.
+    my @legal_values = @{(BUILTIN_SKIN_NAMES)};
+
+    foreach my $direntry (glob(catdir($dirbase, '*'))) {
+        if (-d $direntry) {
+            next if basename($direntry) =~ /^cvs$/i;
+            # Stylesheet set found
+            push(@legal_values, basename($direntry));
+        }
+    }
+
+    return $self->{'legal_values'} = \@legal_values;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::User::Setting::Skin - Object for a user preference setting for skins
+
+=head1 DESCRIPTION
+
+Skin.pm extends Bugzilla::User::Setting and implements a class specialized for
+skins settings.
+
+=head1 METHODS
+
+=over
+
+=item C<legal_values()>
+
+Description: Returns all legal skins
+Params:      none
+Returns:     A reference to an array containing the names of all legal skins
+
+=back

diff --git a/Bugzilla/User/Setting/Timezone.pm b/Bugzilla/User/Setting/Timezone.pm
new file mode 100644 (file)
index 0000000..91f9977
--- /dev/null
+++ b/Bugzilla/User/Setting/Timezone.pm
@@ -0,0 +1,59 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::User::Setting::Timezone;
+
+use strict;
+
+use DateTime::TimeZone;
+
+use base qw(Bugzilla::User::Setting);
+
+use Bugzilla::Constants;
+
+sub legal_values {
+    my ($self) = @_;
+
+    return $self->{'legal_values'} if defined $self->{'legal_values'};
+
+    my @timezones = DateTime::TimeZone->all_names;
+    # Remove old formats, such as CST6CDT, EST, EST5EDT.
+    @timezones = grep { $_ =~ m#.+/.+#} @timezones;
+    # Append 'local' to the list, which will use the timezone
+    # given by the server.
+    push(@timezones, 'local');
+    push(@timezones, 'UTC');
+
+    return $self->{'legal_values'} = \@timezones;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::User::Setting::Timezone - Object for a user preference setting for desired timezone
+
+=head1 DESCRIPTION
+
+Timezone.pm extends Bugzilla::User::Setting and implements a class specialized for
+setting the desired timezone.
+
+=head1 METHODS
+
+=over
+
+=item C<legal_values()>
+
+Description: Returns all legal timezones
+
+Params:      none
+
+Returns:     A reference to an array containing the names of all legal timezones
+
+=back

diff --git a/Bugzilla/UserAgent.pm b/Bugzilla/UserAgent.pm
new file mode 100644 (file)
index 0000000..b5d5521
--- /dev/null
+++ b/Bugzilla/UserAgent.pm
@@ -0,0 +1,230 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::UserAgent;
+
+use strict;
+use base qw(Exporter);
+our @EXPORT = qw(detect_platform detect_op_sys);
+
+use Bugzilla::Field;
+use List::MoreUtils qw(natatime);
+
+use constant DEFAULT_VALUE => 'Other';
+
+use constant PLATFORMS_MAP => (
+    # PowerPC
+    qr/\(.*PowerPC.*\)/i => ["PowerPC", "Macintosh"],
+    # AMD64, Intel x86_64
+    qr/\(.*[ix0-9]86 (?:on |\()x86_64.*\)/ => ["IA32", "x86", "PC"],
+    qr/\(.*amd64.*\)/ => ["AMD64", "x86_64", "PC"],
+    qr/\(.*x86_64.*\)/ => ["AMD64", "x86_64", "PC"],
+    # Intel IA64
+    qr/\(.*IA64.*\)/ => ["IA64", "PC"],
+    # Intel x86
+    qr/\(.*Intel.*\)/ => ["IA32", "x86", "PC"],
+    qr/\(.*[ix0-9]86.*\)/ => ["IA32", "x86", "PC"],
+    # Versions of Windows that only run on Intel x86
+    qr/\(.*Win(?:dows |)[39M].*\)/ => ["IA32", "x86", "PC"],
+    qr/\(.*Win(?:dows |)16.*\)/ => ["IA32", "x86", "PC"],
+    # Sparc
+    qr/\(.*sparc.*\)/ => ["Sparc", "Sun"],
+    qr/\(.*sun4.*\)/ => ["Sparc", "Sun"],
+    # Alpha
+    qr/\(.*AXP.*\)/i => ["Alpha", "DEC"],
+    qr/\(.*[ _]Alpha.\D/i => ["Alpha", "DEC"],
+    qr/\(.*[ _]Alpha\)/i => ["Alpha", "DEC"],
+    # MIPS
+    qr/\(.*IRIX.*\)/i => ["MIPS", "SGI"],
+    qr/\(.*MIPS.*\)/i => ["MIPS", "SGI"],
+    # 68k
+    qr/\(.*68K.*\)/ => ["68k", "Macintosh"],
+    qr/\(.*680[x0]0.*\)/ => ["68k", "Macintosh"],
+    # HP
+    qr/\(.*9000.*\)/ => ["PA-RISC", "HP"],
+    # ARM
+    qr/\(.*ARM.*\)/ => ["ARM", "PocketPC"],
+    # PocketPC intentionally before PowerPC
+    qr/\(.*Windows CE.*PPC.*\)/ => ["ARM", "PocketPC"],
+    # PowerPC
+    qr/\(.*PPC.*\)/ => ["PowerPC", "Macintosh"],
+    qr/\(.*AIX.*\)/ => ["PowerPC", "Macintosh"],
+    # Stereotypical and broken
+    qr/\(.*Windows CE.*\)/ => ["ARM", "PocketPC"],
+    qr/\(.*Macintosh.*\)/ => ["68k", "Macintosh"],
+    qr/\(.*Mac OS [89].*\)/ => ["68k", "Macintosh"],
+    qr/\(.*WOW64.*\)/ => ["x86_64"],
+    qr/\(.*Win64.*\)/ => ["IA64"],
+    qr/\(Win.*\)/ => ["IA32", "x86", "PC"],
+    qr/\(.*Win(?:dows[ -])NT.*\)/ => ["IA32", "x86", "PC"],
+    qr/\(.*OSF.*\)/ => ["Alpha", "DEC"],
+    qr/\(.*HP-?UX.*\)/i => ["PA-RISC", "HP"],
+    qr/\(.*IRIX.*\)/i => ["MIPS", "SGI"],
+    qr/\(.*(SunOS|Solaris).*\)/ => ["Sparc", "Sun"],
+    # Braindead old browsers who didn't follow convention:
+    qr/Amiga/ => ["68k", "Macintosh"],
+    qr/WinMosaic/ => ["IA32", "x86", "PC"],
+);
+
+use constant OS_MAP => (
+    # Sun
+    qr/\(.*Solaris.*\)/ => ["Solaris"],
+    qr/\(.*SunOS 5.11.*\)/ => [("OpenSolaris", "Opensolaris", "Solaris 11")],
+    qr/\(.*SunOS 5.10.*\)/ => ["Solaris 10"],
+    qr/\(.*SunOS 5.9.*\)/ => ["Solaris 9"],
+    qr/\(.*SunOS 5.8.*\)/ => ["Solaris 8"],
+    qr/\(.*SunOS 5.7.*\)/ => ["Solaris 7"],
+    qr/\(.*SunOS 5.6.*\)/ => ["Solaris 6"],
+    qr/\(.*SunOS 5.5.*\)/ => ["Solaris 5"],
+    qr/\(.*SunOS 5.*\)/ => ["Solaris"],
+    qr/\(.*SunOS.*sun4u.*\)/ => ["Solaris"],
+    qr/\(.*SunOS.*i86pc.*\)/ => ["Solaris"],
+    qr/\(.*SunOS.*\)/ => ["SunOS"],
+    # BSD
+    qr/\(.*BSD\/(?:OS|386).*\)/ => ["BSDI"],
+    qr/\(.*FreeBSD.*\)/ => ["FreeBSD"],
+    qr/\(.*OpenBSD.*\)/ => ["OpenBSD"],
+    qr/\(.*NetBSD.*\)/ => ["NetBSD"],
+    # Misc POSIX
+    qr/\(.*IRIX.*\)/ => ["IRIX"],
+    qr/\(.*OSF.*\)/ => ["OSF/1"],
+    qr/\(.*Linux.*\)/ => ["Linux"],
+    qr/\(.*BeOS.*\)/ => ["BeOS"],
+    qr/\(.*AIX.*\)/ => ["AIX"],
+    qr/\(.*OS\/2.*\)/ => ["OS/2"],
+    qr/\(.*QNX.*\)/ => ["Neutrino"],
+    qr/\(.*VMS.*\)/ => ["OpenVMS"],
+    qr/\(.*HP-?UX.*\)/ => ["HP-UX"],
+    qr/\(.*Android.*\)/ => ["Android"],
+    # Windows
+    qr/\(.*Windows XP.*\)/ => ["Windows XP"],
+    qr/\(.*Windows NT 6\.2.*\)/ => ["Windows 8"],
+    qr/\(.*Windows NT 6\.1.*\)/ => ["Windows 7"],
+    qr/\(.*Windows NT 6\.0.*\)/ => ["Windows Vista"],
+    qr/\(.*Windows NT 5\.2.*\)/ => ["Windows Server 2003"],
+    qr/\(.*Windows NT 5\.1.*\)/ => ["Windows XP"],
+    qr/\(.*Windows 2000.*\)/ => ["Windows 2000"],
+    qr/\(.*Windows NT 5.*\)/ => ["Windows 2000"],
+    qr/\(.*Win.*9[8x].*4\.9.*\)/ => ["Windows ME"],
+    qr/\(.*Win(?:dows |)M[Ee].*\)/ => ["Windows ME"],
+    qr/\(.*Win(?:dows |)98.*\)/ => ["Windows 98"],
+    qr/\(.*Win(?:dows |)95.*\)/ => ["Windows 95"],
+    qr/\(.*Win(?:dows |)16.*\)/ => ["Windows 3.1"],
+    qr/\(.*Win(?:dows[ -]|)NT.*\)/ => ["Windows NT"],
+    qr/\(.*Windows.*NT.*\)/ => ["Windows NT"],
+    # OS X
+    qr/\(.*Mac OS X (?:|Mach-O |\()10.8.*\)/ => ["Mac OS X 10.8"],
+    qr/\(.*Mac OS X (?:|Mach-O |\()10.7.*\)/ => ["Mac OS X 10.7"],
+    qr/\(.*Mac OS X (?:|Mach-O |\()10.6.*\)/ => ["Mac OS X 10.6"],
+    qr/\(.*Mac OS X (?:|Mach-O |\()10.5.*\)/ => ["Mac OS X 10.5"],
+    qr/\(.*Mac OS X (?:|Mach-O |\()10.4.*\)/ => ["Mac OS X 10.4"],
+    qr/\(.*Mac OS X (?:|Mach-O |\()10.3.*\)/ => ["Mac OS X 10.3"],
+    qr/\(.*Mac OS X (?:|Mach-O |\()10.2.*\)/ => ["Mac OS X 10.2"],
+    qr/\(.*Mac OS X (?:|Mach-O |\()10.1.*\)/ => ["Mac OS X 10.1"],
+    # Unfortunately, OS X 10.4 was the first to support Intel. This is fallback
+    # support because some browsers refused to include the OS Version.
+    qr/\(.*Intel.*Mac OS X.*\)/ => ["Mac OS X 10.4"],
+    # OS X 10.3 is the most likely default version of PowerPC Macs
+    # OS X 10.0 is more for configurations which didn't setup 10.x versions
+    qr/\(.*Mac OS X.*\)/ => [("Mac OS X 10.3", "Mac OS X 10.0", "Mac OS X")],
+    qr/\(.*Mac OS 9.*\)/ => [("Mac System 9.x", "Mac System 9.0")],
+    qr/\(.*Mac OS 8\.6.*\)/ => [("Mac System 8.6", "Mac System 8.5")],
+    qr/\(.*Mac OS 8\.5.*\)/ => ["Mac System 8.5"],
+    qr/\(.*Mac OS 8\.1.*\)/ => [("Mac System 8.1", "Mac System 8.0")],
+    qr/\(.*Mac OS 8\.0.*\)/ => ["Mac System 8.0"],
+    qr/\(.*Mac OS 8[^.].*\)/ => ["Mac System 8.0"],
+    qr/\(.*Mac OS 8.*\)/ => ["Mac System 8.6"],
+    qr/\(.*Darwin.*\)/ => [("Mac OS X 10.0", "Mac OS X")],
+    # Silly
+    qr/\(.*Mac.*PowerPC.*\)/ => ["Mac System 9.x"],
+    qr/\(.*Mac.*PPC.*\)/ => ["Mac System 9.x"],
+    qr/\(.*Mac.*68k.*\)/ => ["Mac System 8.0"],
+    # Evil
+    qr/Amiga/i => ["Other"],
+    qr/WinMosaic/ => ["Windows 95"],
+    qr/\(.*32bit.*\)/ => ["Windows 95"],
+    qr/\(.*16bit.*\)/ => ["Windows 3.1"],
+    qr/\(.*PowerPC.*\)/ => ["Mac System 9.x"],
+    qr/\(.*PPC.*\)/ => ["Mac System 9.x"],
+    qr/\(.*68K.*\)/ => ["Mac System 8.0"],
+);
+
+sub detect_platform {
+    my $userAgent = $ENV{'HTTP_USER_AGENT'};
+    my @detected;
+    my $iterator = natatime(2, PLATFORMS_MAP);
+    while (my($re, $ra) = $iterator->()) {
+        if ($userAgent =~ $re) {
+            push @detected, @$ra;
+        }
+    }
+    return _pick_valid_field_value('rep_platform', @detected);
+}
+
+sub detect_op_sys {
+    my $userAgent = $ENV{'HTTP_USER_AGENT'} || '';
+    my @detected;
+    my $iterator = natatime(2, OS_MAP);
+    while (my($re, $ra) = $iterator->()) {
+        if ($userAgent =~ $re) {
+            push @detected, @$ra;
+        }
+    }
+    push(@detected, "Windows") if grep(/^Windows /, @detected);
+    push(@detected, "Mac OS") if grep(/^Mac /, @detected);
+    return _pick_valid_field_value('op_sys', @detected);
+}
+
+# Takes the name of a field and a list of possible values for that field.
+# Returns the first value in the list that is actually a valid value for that
+# field.
+# Returns 'Other' if none of the values match.
+sub _pick_valid_field_value {
+    my ($field, @values) = @_;
+    foreach my $value (@values) {
+        return $value if check_field($field, $value, undef, 1);
+    }
+    return DEFAULT_VALUE;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::UserAgent - UserAgent utilities for Bugzilla
+
+=head1 SYNOPSIS
+
+  use Bugzilla::UserAgent;
+  printf "platform: %s op-sys: %s\n", detect_platform(), detect_op_sys();
+
+=head1 DESCRIPTION
+
+The functions exported by this module all return information derived from the
+remote client's user agent.
+
+=head1 FUNCTIONS
+
+=over 4
+
+=item C<detect_platform>
+
+This function attempts to detect the remote client's platform from the
+presented user-agent. If a suitable value on the I<platform> field is found,
+that field value will be returned.  If no suitable value is detected,
+C<detect_platform> returns I<Other>.
+
+=item C<detect_op_sys>
+
+This function attempts to detect the remote client's operating system from the
+presented user-agent. If a suitable value on the I<op_sys> field is found, that
+field value will be returned.  If no suitable value is detected,
+C<detect_op_sys> returns I<Other>.
+
+=back

diff --git a/Bugzilla/Util.pm b/Bugzilla/Util.pm
new file mode 100644 (file)
index 0000000..ee8674b
--- /dev/null
+++ b/Bugzilla/Util.pm
@@ -0,0 +1,1183 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Util;
+
+use strict;
+
+use base qw(Exporter);
+@Bugzilla::Util::EXPORT = qw(trick_taint detaint_natural detaint_signed
+                             html_quote url_quote xml_quote
+                             css_class_quote html_light_quote
+                             i_am_cgi correct_urlbase remote_ip validate_ip
+                             do_ssl_redirect_if_required use_attachbase
+                             diff_arrays on_main_db say
+                             trim wrap_hard wrap_comment find_wrap_point
+                             format_time validate_date validate_time datetime_from
+                             is_7bit_clean bz_crypt generate_random_password
+                             validate_email_syntax check_email_syntax clean_text
+                             get_text template_var disable_utf8
+                             detect_encoding);
+
+use Bugzilla::Constants;
+use Bugzilla::RNG qw(irand);
+use Bugzilla::Error;
+
+use Date::Parse;
+use Date::Format;
+use Digest;
+use Email::Address;
+use List::Util qw(first);
+use Scalar::Util qw(tainted blessed);
+use Template::Filters;
+use Text::Wrap;
+use Encode qw(encode decode resolve_alias);
+use Encode::Guess;
+
+sub trick_taint {
+    require Carp;
+    Carp::confess("Undef to trick_taint") unless defined $_[0];
+    my $match = $_[0] =~ /^(.*)$/s;
+    $_[0] = $match ? $1 : undef;
+    return (defined($_[0]));
+}
+
+sub detaint_natural {
+    my $match = $_[0] =~ /^(\d+)$/;
+    $_[0] = $match ? int($1) : undef;
+    return (defined($_[0]));
+}
+
+sub detaint_signed {
+    my $match = $_[0] =~ /^([-+]?\d+)$/;
+    # The "int()" call removes any leading plus sign.
+    $_[0] = $match ? int($1) : undef;
+    return (defined($_[0]));
+}
+
+# Bug 120030: Override html filter to obscure the '@' in user
+#             visible strings.
+# Bug 319331: Handle BiDi disruptions.
+sub html_quote {
+    my ($var) = Template::Filters::html_filter(@_);
+    # Obscure '@'.
+    $var =~ s/\@/\@/g;
+    if (Bugzilla->params->{'utf8'}) {
+        # Remove the following characters because they're
+        # influencing BiDi:
+        # --------------------------------------------------------
+        # |Code  |Name                      |UTF-8 representation|
+        # |------|--------------------------|--------------------|
+        # |U+202a|Left-To-Right Embedding   |0xe2 0x80 0xaa      |
+        # |U+202b|Right-To-Left Embedding   |0xe2 0x80 0xab      |
+        # |U+202c|Pop Directional Formatting|0xe2 0x80 0xac      |
+        # |U+202d|Left-To-Right Override    |0xe2 0x80 0xad      |
+        # |U+202e|Right-To-Left Override    |0xe2 0x80 0xae      |
+        # --------------------------------------------------------
+        #
+        # The following are characters influencing BiDi, too, but
+        # they can be spared from filtering because they don't
+        # influence more than one character right or left:
+        # --------------------------------------------------------
+        # |Code  |Name                      |UTF-8 representation|
+        # |------|--------------------------|--------------------|
+        # |U+200e|Left-To-Right Mark        |0xe2 0x80 0x8e      |
+        # |U+200f|Right-To-Left Mark        |0xe2 0x80 0x8f      |
+        # --------------------------------------------------------
+        $var =~ s/[\x{202a}-\x{202e}]//g;
+    }
+    return $var;
+}
+
+sub html_light_quote {
+    my ($text) = @_;
+    # admin/table.html.tmpl calls |FILTER html_light| many times.
+    # There is no need to recreate the HTML::Scrubber object again and again.
+    my $scrubber = Bugzilla->process_cache->{html_scrubber};
+
+    # List of allowed HTML elements having no attributes.
+    my @allow = qw(b strong em i u p br abbr acronym ins del cite code var
+                   dfn samp kbd big small sub sup tt dd dt dl ul li ol
+                   fieldset legend);
+
+    if (!Bugzilla->feature('html_desc')) {
+        my $safe = join('|', @allow);
+        my $chr = chr(1);
+
+        # First, escape safe elements.
+        $text =~ s#<($safe)>#$chr$1$chr#go;
+        $text =~ s#</($safe)>#$chr/$1$chr#go;
+        # Now filter < and >.
+        $text =~ s#<#&lt;#g;
+        $text =~ s#>#&gt;#g;
+        # Restore safe elements.
+        $text =~ s#$chr/($safe)$chr#</$1>#go;
+        $text =~ s#$chr($safe)$chr#<$1>#go;
+        return $text;
+    }
+    elsif (!$scrubber) {
+        # We can be less restrictive. We can accept elements with attributes.
+        push(@allow, qw(a blockquote q span));
+
+        # Allowed protocols.
+        my $safe_protocols = join('|', SAFE_PROTOCOLS);
+        my $protocol_regexp = qr{(^(?:$safe_protocols):|^[^:]+$)}i;
+
+        # Deny all elements and attributes unless explicitly authorized.
+        my @default = (0 => {
+                             id    => 1,
+                             name  => 1,
+                             class => 1,
+                             '*'   => 0, # Reject all other attributes.
+                            }
+                       );
+
+        # Specific rules for allowed elements. If no specific rule is set
+        # for a given element, then the default is used.
+        my @rules = (a => {
+                           href   => $protocol_regexp,
+                           target => qr{^(?:_blank|_parent|_self|_top)$}i,
+                           title  => 1,
+                           id     => 1,
+                           name   => 1,
+                           class  => 1,
+                           '*'    => 0, # Reject all other attributes.
+                          },
+                     blockquote => {
+                                    cite => $protocol_regexp,
+                                    id    => 1,
+                                    name  => 1,
+                                    class => 1,
+                                    '*'  => 0, # Reject all other attributes.
+                                   },
+                     'q' => {
+                             cite => $protocol_regexp,
+                             id    => 1,
+                             name  => 1,
+                             class => 1,
+                             '*'  => 0, # Reject all other attributes.
+                          },
+                    );
+
+        Bugzilla->process_cache->{html_scrubber} = $scrubber =
+          HTML::Scrubber->new(default => \@default,
+                              allow   => \@allow,
+                              rules   => \@rules,
+                              comment => 0,
+                              process => 0);
+    }
+    return $scrubber->scrub($text);
+}
+
+sub email_filter {
+    my ($toencode) = @_;
+    if (!Bugzilla->user->id) {
+        my @emails = Email::Address->parse($toencode);
+        if (scalar @emails) {
+            my @hosts = map { quotemeta($_->host) } @emails;
+            my $hosts_re = join('|', @hosts);
+            $toencode =~ s/\@(?:$hosts_re)//g;
+            return $toencode;
+        }
+    }
+    return $toencode;
+}
+
+# This originally came from CGI.pm, by Lincoln D. Stein
+sub url_quote {
+    my ($toencode) = (@_);
+    utf8::encode($toencode) # The below regex works only on bytes
+        if Bugzilla->params->{'utf8'} && utf8::is_utf8($toencode);
+    $toencode =~ s/([^a-zA-Z0-9_\-.])/uc sprintf("%%%02x",ord($1))/eg;
+    return $toencode;
+}
+
+sub css_class_quote {
+    my ($toencode) = (@_);
+    $toencode =~ s#[ /]#_#g;
+    $toencode =~ s/([^a-zA-Z0-9_\-.])/uc sprintf("&#x%x;",ord($1))/eg;
+    return $toencode;
+}
+
+sub xml_quote {
+    my ($var) = (@_);
+    $var =~ s/\&/\&amp;/g;
+    $var =~ s/</\&lt;/g;
+    $var =~ s/>/\&gt;/g;
+    $var =~ s/\"/\&quot;/g;
+    $var =~ s/\'/\&apos;/g;
+    
+    # the following nukes characters disallowed by the XML 1.0
+    # spec, Production 2.2. 1.0 declares that only the following 
+    # are valid:
+    # (#x9 | #xA | #xD | [#x20-#xD7FF] | [#xE000-#xFFFD] | [#x10000-#x10FFFF])
+    $var =~ s/([\x{0001}-\x{0008}]|
+               [\x{000B}-\x{000C}]|
+               [\x{000E}-\x{001F}]|
+               [\x{D800}-\x{DFFF}]|
+               [\x{FFFE}-\x{FFFF}])//gx;
+    return $var;
+}
+
+sub i_am_cgi {
+    # I use SERVER_SOFTWARE because it's required to be
+    # defined for all requests in the CGI spec.
+    return exists $ENV{'SERVER_SOFTWARE'} ? 1 : 0;
+}
+
+# This exists as a separate function from Bugzilla::CGI::redirect_to_https
+# because we don't want to create a CGI object during XML-RPC calls
+# (doing so can mess up XML-RPC).
+sub do_ssl_redirect_if_required {
+    return if !i_am_cgi();
+    return if !Bugzilla->params->{'ssl_redirect'};
+
+    my $sslbase = Bugzilla->params->{'sslbase'};
+    
+    # If we're already running under SSL, never redirect.
+    return if uc($ENV{HTTPS} || '') eq 'ON';
+    # Never redirect if there isn't an sslbase.
+    return if !$sslbase;
+    Bugzilla->cgi->redirect_to_https();
+}
+
+sub correct_urlbase {
+    my $ssl = Bugzilla->params->{'ssl_redirect'};
+    my $urlbase = Bugzilla->params->{'urlbase'};
+    my $sslbase = Bugzilla->params->{'sslbase'};
+
+    if (!$sslbase) {
+        return $urlbase;
+    }
+    elsif ($ssl) {
+        return $sslbase;
+    }
+    else {
+        # Return what the user currently uses.
+        return (uc($ENV{HTTPS} || '') eq 'ON') ? $sslbase : $urlbase;
+    }
+}
+
+sub remote_ip {
+    my $ip = $ENV{'REMOTE_ADDR'} || '127.0.0.1';
+    my @proxies = split(/[\s,]+/, Bugzilla->params->{'inbound_proxies'});
+
+    # If the IP address is one of our trusted proxies, then we look at
+    # the X-Forwarded-For header to determine the real remote IP address.
+    if ($ENV{'HTTP_X_FORWARDED_FOR'} && first { $_ eq $ip } @proxies) {
+        my @ips = split(/[\s,]+/, $ENV{'HTTP_X_FORWARDED_FOR'});
+        # This header can contain several IP addresses. We want the
+        # IP address of the machine which connected to our proxies as
+        # all other IP addresses may be fake or internal ones.
+        # Note that this may block a whole external proxy, but we have
+        # no way to determine if this proxy is malicious or trustable.
+        foreach my $remote_ip (reverse @ips) {
+            if (!first { $_ eq $remote_ip } @proxies) {
+                # Keep the original IP address if the remote IP is invalid.
+                $ip = validate_ip($remote_ip) || $ip;
+                last;
+            }
+        }
+    }
+    return $ip;
+}
+
+sub validate_ip {
+    my $ip = shift;
+    return is_ipv4($ip) || is_ipv6($ip);
+}
+
+# Copied from Data::Validate::IP::is_ipv4().
+sub is_ipv4 {
+    my $ip = shift;
+    return unless defined $ip;
+
+    my @octets = $ip =~ /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/;
+    return unless scalar(@octets) == 4;
+
+    foreach my $octet (@octets) {
+        return unless ($octet >= 0 && $octet <= 255 && $octet !~ /^0\d{1,2}$/);
+    }
+
+    # The IP address is valid and can now be detainted.
+    return join('.', @octets);
+}
+
+# Copied from Data::Validate::IP::is_ipv6().
+sub is_ipv6 {
+    my $ip = shift;
+    return unless defined $ip;
+
+    # If there is a :: then there must be only one :: and the length
+    # can be variable. Without it, the length must be 8 groups.
+    my @chunks = split(':', $ip);
+
+    # Need to check if the last chunk is an IPv4 address, if it is we
+    # pop it off and exempt it from the normal IPv6 checking and stick
+    # it back on at the end. If there is only one chunk and it's an IPv4
+    # address, then it isn't an IPv6 address.
+    my $ipv4;
+    my $expected_chunks = 8;
+    if (@chunks > 1 && is_ipv4($chunks[$#chunks])) {
+        $ipv4 = pop(@chunks);
+        $expected_chunks--;
+    }
+
+    my $empty = 0;
+    # Workaround to handle trailing :: being valid.
+    if ($ip =~ /[0-9a-f]{1,4}::$/) {
+        $empty++;
+    # Single trailing ':' is invalid.
+    } elsif ($ip =~ /:$/) {
+        return;
+    }
+
+    foreach my $chunk (@chunks) {
+        return unless $chunk =~ /^[0-9a-f]{0,4}$/i;
+        $empty++ if $chunk eq '';
+    }
+    # More than one :: block is bad, but if it starts with :: it will
+    # look like two, so we need an exception.
+    if ($empty == 2 && $ip =~ /^::/) {
+        # This is ok
+    } elsif ($empty > 1) {
+        return;
+    }
+
+    push(@chunks, $ipv4) if $ipv4;
+    # Need 8 chunks, or we need an empty section that could be filled
+    # to represent the missing '0' sections.
+    return unless (@chunks == $expected_chunks || @chunks < $expected_chunks && $empty);
+
+    my $ipv6 = join(':', @chunks);
+    # The IP address is valid and can now be detainted.
+    trick_taint($ipv6);
+
+    # Need to handle the exception of trailing :: being valid.
+    return "${ipv6}::" if $ip =~ /::$/;
+    return $ipv6;
+}
+
+sub use_attachbase {
+    my $attachbase = Bugzilla->params->{'attachment_base'};
+    return ($attachbase ne ''
+            && $attachbase ne Bugzilla->params->{'urlbase'}
+            && $attachbase ne Bugzilla->params->{'sslbase'}) ? 1 : 0;
+}
+
+sub diff_arrays {
+    my ($old_ref, $new_ref, $attrib) = @_;
+    $attrib ||= 'name';
+
+    my (%counts, %pos);
+    # We are going to alter the old array.
+    my @old = @$old_ref;
+    my $i = 0;
+
+    # $counts{foo}-- means old, $counts{foo}++ means new.
+    # If $counts{foo} becomes positive, then we are adding new items,
+    # else we simply cancel one old existing item. Remaining items
+    # in the old list have been removed.
+    foreach (@old) {
+        next unless defined $_;
+        my $value = blessed($_) ? $_->$attrib : $_;
+        $counts{$value}--;
+        push @{$pos{$value}}, $i++;
+    }
+    my @added;
+    foreach (@$new_ref) {
+        next unless defined $_;
+        my $value = blessed($_) ? $_->$attrib : $_;
+        if (++$counts{$value} > 0) {
+            # Ignore empty strings, but objects having an empty string
+            # as attribute are fine.
+            push(@added, $_) unless ($value eq '' && !blessed($_));
+        }
+        else {
+            my $old_pos = shift @{$pos{$value}};
+            $old[$old_pos] = undef;
+        }
+    }
+    # Ignore canceled items as well as empty strings.
+    my @removed = grep { defined $_ && $_ ne '' } @old;
+    return (\@removed, \@added);
+}
+
+# XXX - This is a temporary subroutine till we require Perl 5.10.1.
+# This will happen before Bugzilla 5.0rc1.
+sub say (@) {
+    print @_;
+    print "\n";
+}
+
+sub trim {
+    my ($str) = @_;
+    if ($str) {
+      $str =~ s/^\s+//g;
+      $str =~ s/\s+$//g;
+    }
+    return $str;
+}
+
+sub wrap_comment {
+    my ($comment, $cols) = @_;
+    my $wrappedcomment = "";
+
+    # Use 'local', as recommended by Text::Wrap's perldoc.
+    local $Text::Wrap::columns = $cols || COMMENT_COLS;
+    # Make words that are longer than COMMENT_COLS not wrap.
+    local $Text::Wrap::huge    = 'overflow';
+    # Don't mess with tabs.
+    local $Text::Wrap::unexpand = 0;
+
+    # If the line starts with ">", don't wrap it. Otherwise, wrap.
+    foreach my $line (split(/\r\n|\r|\n/, $comment)) {
+      if ($line =~ qr/^>/) {
+        $wrappedcomment .= ($line . "\n");
+      }
+      else {
+        # Due to a segfault in Text::Tabs::expand() when processing tabs with
+        # Unicode (see http://rt.perl.org/rt3/Public/Bug/Display.html?id=52104),
+        # we have to remove tabs before processing the comment. This restriction
+        # can go away when we require Perl 5.8.9 or newer.
+        $line =~ s/\t/    /g;
+        $wrappedcomment .= (wrap('', '', $line) . "\n");
+      }
+    }
+
+    chomp($wrappedcomment); # Text::Wrap adds an extra newline at the end.
+    return $wrappedcomment;
+}
+
+sub find_wrap_point {
+    my ($string, $maxpos) = @_;
+    if (!$string) { return 0 }
+    if (length($string) < $maxpos) { return length($string) }
+    my $wrappoint = rindex($string, ",", $maxpos); # look for comma
+    if ($wrappoint <= 0) {  # can't find comma
+        $wrappoint = rindex($string, " ", $maxpos); # look for space
+        if ($wrappoint <= 0) {  # can't find space
+            $wrappoint = rindex($string, "-", $maxpos); # look for hyphen
+            if ($wrappoint <= 0) {  # can't find hyphen
+                $wrappoint = $maxpos;  # just truncate it
+            } else {
+                $wrappoint++; # leave hyphen on the left side
+            }
+        }
+    }
+    return $wrappoint;
+}
+
+sub wrap_hard {
+    my ($string, $columns) = @_;
+    local $Text::Wrap::columns = $columns;
+    local $Text::Wrap::unexpand = 0;
+    local $Text::Wrap::huge = 'wrap';
+    
+    my $wrapped = wrap('', '', $string);
+    chomp($wrapped);
+    return $wrapped;
+}
+
+sub format_time {
+    my ($date, $format, $timezone) = @_;
+
+    # If $format is not set, try to guess the correct date format.
+    if (!$format) {
+        if (!ref $date
+            && $date =~ /^(\d{4})[-\.](\d{2})[-\.](\d{2}) (\d{2}):(\d{2})(:(\d{2}))?$/) 
+        {
+            my $sec = $7;
+            if (defined $sec) {
+                $format = "%Y-%m-%d %T %Z";
+            } else {
+                $format = "%Y-%m-%d %R %Z";
+            }
+        } else {
+            # Default date format. See DateTime for other formats available.
+            $format = "%Y-%m-%d %R %Z";
+        }
+    }
+
+    my $dt = ref $date ? $date : datetime_from($date, $timezone);
+    $date = defined $dt ? $dt->strftime($format) : '';
+    return trim($date);
+}
+
+sub datetime_from {
+    my ($date, $timezone) = @_;
+
+    # In the database, this is the "0" date.
+    return undef if $date =~ /^0000/;
+
+    # strptime($date) returns an empty array if $date has an invalid
+    # date format.
+    my @time = strptime($date);
+
+    unless (scalar @time) {
+        # If an unknown timezone is passed (such as MSK, for Moskow),
+        # strptime() is unable to parse the date. We try again, but we first
+        # remove the timezone.
+        $date =~ s/\s+\S+$//;
+        @time = strptime($date);
+    }
+
+    return undef if !@time;
+
+    # strptime() counts years from 1900, and months from 0 (January).
+    # We have to fix both values.
+    my %args = (
+        year   => $time[5] + 1900,
+        month  => $time[4] + 1,
+        day    => $time[3],
+        hour   => $time[2],
+        minute => $time[1],
+        # DateTime doesn't like fractional seconds.
+        # Also, sometimes seconds are undef.
+        second => defined($time[0]) ? int($time[0]) : undef,
+        # If a timezone was specified, use it. Otherwise, use the
+        # local timezone.
+        time_zone => Bugzilla->local_timezone->offset_as_string($time[6]) 
+                     || Bugzilla->local_timezone,
+    );
+
+    # If something wasn't specified in the date, it's best to just not
+    # pass it to DateTime at all. (This is important for doing datetime_from
+    # on the deadline field, which is usually just a date with no time.)
+    foreach my $arg (keys %args) {
+        delete $args{$arg} if !defined $args{$arg};
+    }
+
+    # This module takes time to load and is only used here, so we
+    # |require| it here rather than |use| it.
+    require DateTime;
+    my $dt = new DateTime(\%args);
+
+    # Now display the date using the given timezone,
+    # or the user's timezone if none is given.
+    $dt->set_time_zone($timezone || Bugzilla->user->timezone);
+    return $dt;
+}
+
+sub bz_crypt {
+    my ($password, $salt) = @_;
+
+    my $algorithm;
+    if (!defined $salt) {
+        # If you don't use a salt, then people can create tables of
+        # hashes that map to particular passwords, and then break your
+        # hashing very easily if they have a large-enough table of common
+        # (or even uncommon) passwords. So we generate a unique salt for
+        # each password in the database, and then just prepend it to
+        # the hash.
+        $salt = generate_random_password(PASSWORD_SALT_LENGTH);
+        $algorithm = PASSWORD_DIGEST_ALGORITHM;
+    }
+
+    # We append the algorithm used to the string. This is good because then
+    # we can change the algorithm being used, in the future, without 
+    # disrupting the validation of existing passwords. Also, this tells
+    # us if a password is using the old "crypt" method of hashing passwords,
+    # because the algorithm will be missing from the string.
+    if ($salt =~ /{([^}]+)}$/) {
+        $algorithm = $1;
+    }
+
+    my $crypted_password;
+    if (!$algorithm) {
+        # Wide characters cause crypt to die
+        if (Bugzilla->params->{'utf8'}) {
+            utf8::encode($password) if utf8::is_utf8($password);
+        }
+    
+        # Crypt the password.
+        $crypted_password = crypt($password, $salt);
+
+        # HACK: Perl has bug where returned crypted password is considered
+        # tainted. See http://rt.perl.org/rt3/Public/Bug/Display.html?id=59998
+        unless(tainted($password) || tainted($salt)) {
+            trick_taint($crypted_password);
+        } 
+    }
+    else {
+        my $hasher = Digest->new($algorithm);
+        # We only want to use the first characters of the salt, no
+        # matter how long of a salt we may have been passed.
+        $salt = substr($salt, 0, PASSWORD_SALT_LENGTH);
+        $hasher->add($password, $salt);
+        $crypted_password = $salt . $hasher->b64digest . "{$algorithm}";
+    }
+
+    # Return the crypted password.
+    return $crypted_password;
+}
+
+# If you want to understand the security of strings generated by this
+# function, here's a quick formula that will help you estimate:
+# We pick from 62 characters, which is close to 64, which is 2^6.
+# So 8 characters is (2^6)^8 == 2^48 combinations. Just multiply 6
+# by the number of characters you generate, and that gets you the equivalent
+# strength of the string in bits.
+sub generate_random_password {
+    my $size = shift || 10; # default to 10 chars if nothing specified
+    return join("", map{ ('0'..'9','a'..'z','A'..'Z')[irand 62] } (1..$size));
+}
+
+sub validate_email_syntax {
+    my ($addr) = @_;
+    my $match = Bugzilla->params->{'emailregexp'};
+    my $email = $addr . Bugzilla->params->{'emailsuffix'};
+    # This regexp follows RFC 2822 section 3.4.1.
+    my $addr_spec = $Email::Address::addr_spec;
+    # RFC 2822 section 2.1 specifies that email addresses must
+    # be made of US-ASCII characters only.
+    # Email::Address::addr_spec doesn't enforce this.
+    my $ret = ($addr =~ /$match/ && $email !~ /\P{ASCII}/ && $email =~ /^$addr_spec$/);
+    if ($ret) {
+        # We assume these checks to suffice to consider the address untainted.
+        trick_taint($_[0]);
+    }
+    return $ret ? 1 : 0;
+}
+
+sub check_email_syntax {
+    my ($addr) = @_;
+
+    unless (validate_email_syntax(@_)) {
+        my $email = $addr . Bugzilla->params->{'emailsuffix'};
+        ThrowUserError('illegal_email_address', { addr => $email });
+    }
+}
+
+sub validate_date {
+    my ($date) = @_;
+    my $date2;
+
+    # $ts is undefined if the parser fails.
+    my $ts = str2time($date);
+    if ($ts) {
+        $date2 = time2str("%Y-%m-%d", $ts);
+
+        $date =~ s/(\d+)-0*(\d+?)-0*(\d+?)/$1-$2-$3/; 
+        $date2 =~ s/(\d+)-0*(\d+?)-0*(\d+?)/$1-$2-$3/;
+    }
+    my $ret = ($ts && $date eq $date2);
+    return $ret ? 1 : 0;
+}
+
+sub validate_time {
+    my ($time) = @_;
+    my $time2;
+
+    # $ts is undefined if the parser fails.
+    my $ts = str2time($time);
+    if ($ts) {
+        $time2 = time2str("%H:%M:%S", $ts);
+        if ($time =~ /^(\d{1,2}):(\d\d)(?::(\d\d))?$/) {
+            $time = sprintf("%02d:%02d:%02d", $1, $2, $3 || 0);
+        }
+    }
+    my $ret = ($ts && $time eq $time2);
+    return $ret ? 1 : 0;
+}
+
+sub is_7bit_clean {
+    return $_[0] !~ /[^\x20-\x7E\x0A\x0D]/;
+}
+
+sub clean_text {
+    my $dtext = shift;
+    if ($dtext) {
+        # change control characters into a space
+        $dtext =~ s/[\x00-\x1F\x7F]+/ /g;
+    }
+    return trim($dtext);
+}
+
+sub on_main_db (&) {
+    my $code = shift;
+    my $original_dbh = Bugzilla->dbh;
+    Bugzilla->request_cache->{dbh} = Bugzilla->dbh_main;
+    $code->();
+    Bugzilla->request_cache->{dbh} = $original_dbh;
+}
+
+sub get_text {
+    my ($name, $vars) = @_;
+    my $template = Bugzilla->template_inner;
+    $vars ||= {};
+    $vars->{'message'} = $name;
+    my $message;
+    $template->process('global/message.txt.tmpl', $vars, \$message)
+      || ThrowTemplateError($template->error());
+
+    # Remove the indenting that exists in messages.html.tmpl.
+    $message =~ s/^    //gm;
+    return $message;
+}
+
+sub template_var {
+    my $name = shift;
+    my $cache = Bugzilla->request_cache->{util_template_var} ||= {};
+    my $template = Bugzilla->template_inner;
+    my $lang = $template->context->{bz_language};
+    return $cache->{$lang}->{$name} if defined $cache->{$lang};
+    my %vars;
+    # Note: If we suddenly start needing a lot of template_var variables,
+    # they should move into their own template, not field-descs.
+    $template->process('global/field-descs.none.tmpl',
+                       { vars => \%vars, in_template_var => 1 })
+      || ThrowTemplateError($template->error());
+
+    $cache->{$lang} = \%vars;
+    return $vars{$name};
+}
+
+sub display_value {
+    my ($field, $value) = @_;
+    my $value_descs = template_var('value_descs');
+    if (defined $value_descs->{$field}->{$value}) {
+        return $value_descs->{$field}->{$value};
+    }
+    return $value;
+}
+
+sub disable_utf8 {
+    if (Bugzilla->params->{'utf8'}) {
+        binmode STDOUT, ':bytes'; # Turn off UTF8 encoding.
+    }
+}
+
+use constant UTF8_ACCIDENTAL => qw(shiftjis big5-eten euc-kr euc-jp);
+
+sub detect_encoding {
+    my $data = shift;
+
+    Bugzilla->feature('detect_charset')
+      || ThrowUserError('feature_disabled', { feature => 'detect_charset' });
+
+    require Encode::Detect::Detector;
+    import Encode::Detect::Detector 'detect';
+
+    my $encoding = detect($data);
+    $encoding = resolve_alias($encoding) if $encoding;
+
+    # Encode::Detect is bad at detecting certain charsets, but Encode::Guess
+    # is better at them. Here's the details:
+
+    # shiftjis, big5-eten, euc-kr, and euc-jp: (Encode::Detect
+    # tends to accidentally mis-detect UTF-8 strings as being
+    # these encodings.)
+    if ($encoding && grep($_ eq $encoding, UTF8_ACCIDENTAL)) {
+        $encoding = undef;
+        my $decoder = guess_encoding($data, UTF8_ACCIDENTAL);
+        $encoding = $decoder->name if ref $decoder;
+    }
+
+    # Encode::Detect sometimes mis-detects various ISO encodings as iso-8859-8,
+    # or cp1255, but Encode::Guess can usually tell which one it is.
+    if ($encoding && ($encoding eq 'iso-8859-8' || $encoding eq 'cp1255')) {
+        my $decoded_as = _guess_iso($data, 'iso-8859-8', 
+            # These are ordered this way because it gives the most 
+            # accurate results.
+            qw(cp1252 iso-8859-7 iso-8859-2));
+        $encoding = $decoded_as if $decoded_as;
+    }
+
+    return $encoding;
+}
+
+# A helper for detect_encoding.
+sub _guess_iso {
+    my ($data, $versus, @isos) = (shift, shift, shift);
+
+    my $encoding;
+    foreach my $iso (@isos) {
+        my $decoder = guess_encoding($data, ($iso, $versus));
+        if (ref $decoder) {
+            $encoding = $decoder->name if ref $decoder;
+            last;
+        }
+    }
+    return $encoding;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Util - Generic utility functions for bugzilla
+
+=head1 SYNOPSIS
+
+  use Bugzilla::Util;
+
+  # Functions for dealing with variable tainting
+  trick_taint($var);
+  detaint_natural($var);
+  detaint_signed($var);
+
+  # Functions for quoting
+  html_quote($var);
+  url_quote($var);
+  xml_quote($var);
+  email_filter($var);
+
+  # Functions that tell you about your environment
+  my $is_cgi   = i_am_cgi();
+  my $urlbase  = correct_urlbase();
+
+  # Data manipulation
+  ($removed, $added) = diff_arrays(\@old, \@new);
+
+  # Functions for manipulating strings
+  $val = trim(" abc ");
+  $wrapped = wrap_comment($comment);
+
+  # Functions for formatting time
+  format_time($time);
+  datetime_from($time, $timezone);
+
+  # Cryptographic Functions
+  $crypted_password = bz_crypt($password);
+  $new_password = generate_random_password($password_length);
+
+  # Validation Functions
+  validate_email_syntax($email);
+  check_email_syntax($email);
+  validate_date($date);
+
+  # DB-related functions
+  on_main_db {
+     ... code here ...
+  };
+
+=head1 DESCRIPTION
+
+This package contains various utility functions which do not belong anywhere
+else.
+
+B<It is not intended as a general dumping group for something which
+people feel might be useful somewhere, someday>. Do not add methods to this
+package unless it is intended to be used for a significant number of files,
+and it does not belong anywhere else.
+
+=head1 FUNCTIONS
+
+This package provides several types of routines:
+
+=head2 Tainting
+
+Several functions are available to deal with tainted variables. B<Use these
+with care> to avoid security holes.
+
+=over 4
+
+=item C<trick_taint($val)>
+
+Tricks perl into untainting a particular variable.
+
+Use trick_taint() when you know that there is no way that the data
+in a scalar can be tainted, but taint mode still bails on it.
+
+B<WARNING!! Using this routine on data that really could be tainted defeats
+the purpose of taint mode.  It should only be used on variables that have been
+sanity checked in some way and have been determined to be OK.>
+
+=item C<detaint_natural($num)>
+
+This routine detaints a natural number. It returns a true value if the
+value passed in was a valid natural number, else it returns false. You
+B<MUST> check the result of this routine to avoid security holes.
+
+=item C<detaint_signed($num)>
+
+This routine detaints a signed integer. It returns a true value if the
+value passed in was a valid signed integer, else it returns false. You
+B<MUST> check the result of this routine to avoid security holes.
+
+=back
+
+=head2 Quoting
+
+Some values may need to be quoted from perl. However, this should in general
+be done in the template where possible.
+
+=over 4
+
+=item C<html_quote($val)>
+
+Returns a value quoted for use in HTML, with &, E<lt>, E<gt>, E<34> and @ being
+replaced with their appropriate HTML entities.  Also, Unicode BiDi controls are
+deleted.
+
+=item C<html_light_quote($val)>
+
+Returns a string where only explicitly allowed HTML elements and attributes
+are kept. All HTML elements and attributes not being in the whitelist are either
+escaped (if HTML::Scrubber is not installed) or removed.
+
+=item C<url_quote($val)>
+
+Quotes characters so that they may be included as part of a url.
+
+=item C<css_class_quote($val)>
+
+Quotes characters so that they may be used as CSS class names. Spaces
+and forward slashes are replaced by underscores.
+
+=item C<xml_quote($val)>
+
+This is similar to C<html_quote>, except that ' is escaped to &apos;. This
+is kept separate from html_quote partly for compatibility with previous code
+(for &apos;) and partly for future handling of non-ASCII characters.
+
+=item C<email_filter>
+
+Removes the hostname from email addresses in the string, if the user
+currently viewing Bugzilla is logged out. If the user is logged-in,
+this filter just returns the input string.
+
+=back
+
+=head2 Environment and Location
+
+Functions returning information about your environment or location.
+
+=over 4
+
+=item C<i_am_cgi()>
+
+Tells you whether or not you are being run as a CGI script in a web
+server. For example, it would return false if the caller is running
+in a command-line script.
+
+=item C<correct_urlbase()>
+
+Returns either the C<sslbase> or C<urlbase> parameter, depending on the
+current setting for the C<ssl_redirect> parameter.
+
+=item C<remote_ip()>
+
+Returns the IP address of the remote client. If Bugzilla is behind
+a trusted proxy, it will get the remote IP address by looking at the
+X-Forwarded-For header.
+
+=item C<validate_ip($ip)>
+
+Returns the sanitized IP address if it is a valid IPv4 or IPv6 address,
+else returns undef.
+
+=item C<use_attachbase()>
+
+Returns true if an alternate host is used to display attachments; false
+otherwise.
+
+=back
+
+=head2 Data Manipulation
+
+=over 4
+
+=item C<diff_arrays(\@old, \@new)>
+
+ Description: Takes two arrayrefs, and will tell you what it takes to 
+              get from @old to @new.
+ Params:      @old = array that you are changing from
+              @new = array that you are changing to
+ Returns:     A list of two arrayrefs. The first is a reference to an 
+              array containing items that were removed from @old. The
+              second is a reference to an array containing items
+              that were added to @old. If both returned arrays are 
+              empty, @old and @new contain the same values.
+
+=back
+
+=head2 String Manipulation
+
+=over 4
+
+=item C<trim($str)>
+
+Removes any leading or trailing whitespace from a string. This routine does not
+modify the existing string.
+
+=item C<wrap_hard($string, $size)>
+
+Wraps a string, so that a line is I<never> longer than C<$size>.
+Returns the string, wrapped.
+
+=item C<wrap_comment($comment)>
+
+Takes a bug comment, and wraps it to the appropriate length. The length is
+currently specified in C<Bugzilla::Constants::COMMENT_COLS>. Lines beginning
+with ">" are assumed to be quotes, and they will not be wrapped.
+
+The intended use of this function is to wrap comments that are about to be
+displayed or emailed. Generally, wrapped text should not be stored in the
+database.
+
+=item C<find_wrap_point($string, $maxpos)>
+
+Search for a comma, a whitespace or a hyphen to split $string, within the first
+$maxpos characters. If none of them is found, just split $string at $maxpos.
+The search starts at $maxpos and goes back to the beginning of the string.
+
+=item C<is_7bit_clean($str)>
+
+Returns true is the string contains only 7-bit characters (ASCII 32 through 126,
+ASCII 10 (LineFeed) and ASCII 13 (Carrage Return).
+
+=item C<disable_utf8()>
+
+Disable utf8 on STDOUT (and display raw data instead).
+
+=item C<detect_encoding($str)>
+
+Guesses what encoding a given data is encoded in, returning the canonical name
+of the detected encoding (which may be different from the MIME charset 
+specification).
+
+=item C<clean_text($str)>
+Returns the parameter "cleaned" by exchanging non-printable characters with spaces.
+Specifically characters (ASCII 0 through 31) and (ASCII 127) will become ASCII 32 (Space).
+
+=item C<get_text>
+
+=over
+
+=item B<Description>
+
+This is a method of getting localized strings within Bugzilla code.
+Use this when you don't want to display a whole template, you just
+want a particular string.
+
+It uses the F<global/message.txt.tmpl> template to return a string.
+
+=item B<Params>
+
+=over
+
+=item C<$message> - The identifier for the message.
+
+=item C<$vars> - A hashref. Any variables you want to pass to the template.
+
+=back
+
+=item B<Returns>
+
+A string.
+
+=back
+
+
+=item C<template_var>
+
+This is a method of getting the value of a variable from a template in
+Perl code. The available variables are in the C<global/field-descs.none.tmpl>
+template. Just pass in the name of the variable that you want the value of.
+
+
+=back
+
+=head2 Formatting Time
+
+=over 4
+
+=item C<format_time($time)>
+
+Takes a time and converts it to the desired format and timezone.
+If no format is given, the routine guesses the correct one and returns
+an empty array if it cannot. If no timezone is given, the user's timezone
+is used, as defined in his preferences.
+
+This routine is mainly called from templates to filter dates, see
+"FILTER time" in L<Bugzilla::Template>.
+
+=item C<datetime_from($time, $timezone)>
+
+Returns a DateTime object given a date string. If the string is not in some
+valid date format that C<strptime> understands, we return C<undef>.
+
+You can optionally specify a timezone for the returned date. If not
+specified, defaults to the currently-logged-in user's timezone, or
+the Bugzilla server's local timezone if there isn't a logged-in user.
+
+=back
+
+=head2 Cryptography
+
+=over 4
+
+=item C<bz_crypt($password, $salt)>
+
+Takes a string and returns a hashed (encrypted) value for it, using a
+random salt. An optional salt string may also be passed in.
+
+Please always use this function instead of the built-in perl C<crypt>
+function, when checking or setting a password. Bugzilla does not use
+C<crypt>.
+
+=begin undocumented
+
+Random salts are generated because the alternative is usually
+to use the first two characters of the password itself, and since
+the salt appears in plaintext at the beginning of the encrypted
+password string this has the effect of revealing the first two
+characters of the password to anyone who views the encrypted version.
+
+=end undocumented
+
+=item C<generate_random_password($password_length)>
+
+Returns an alphanumeric string with the specified length
+(10 characters by default). Use this function to generate passwords
+and tokens.
+
+=back
+
+=head2 Validation
+
+=over 4
+
+=item C<validate_email_syntax($email)>
+
+Do a syntax checking for a legal email address and returns 1 if
+the check is successful, else returns 0.
+Untaints C<$email> if successful.
+
+=item C<check_email_syntax($email)>
+
+Do a syntax checking for a legal email address and throws an error
+if the check fails.
+Untaints C<$email> if successful.
+
+=item C<validate_date($date)>
+
+Make sure the date has the correct format and returns 1 if
+the check is successful, else returns 0.
+
+=back
+
+=head2 Database
+
+=over
+
+=item C<on_main_db>
+
+Runs a block of code always on the main DB. Useful for when you're inside
+a subroutine and need to do some writes to the database, but don't know
+if Bugzilla is currently using the shadowdb or not. Used like:
+
+ on_main_db {
+     my $dbh = Bugzilla->dbh;
+     $dbh->do("INSERT ...");
+ }
+
+=back

diff --git a/Bugzilla/Version.pm b/Bugzilla/Version.pm
new file mode 100644 (file)
index 0000000..4a2c4a5
--- /dev/null
+++ b/Bugzilla/Version.pm
@@ -0,0 +1,249 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+package Bugzilla::Version;
+
+use base qw(Bugzilla::Object);
+
+use Bugzilla::Install::Util qw(vers_cmp);
+use Bugzilla::Util;
+use Bugzilla::Error;
+
+use Scalar::Util qw(blessed);
+
+################################
+#####   Initialization     #####
+################################
+
+use constant DEFAULT_VERSION => 'unspecified';
+
+use constant DB_TABLE => 'versions';
+use constant NAME_FIELD => 'value';
+# This is "id" because it has to be filled in and id is probably the fastest.
+# We do a custom sort in new_from_list below.
+use constant LIST_ORDER => 'id';
+
+use constant DB_COLUMNS => qw(
+    id
+    value
+    product_id
+    isactive
+);
+
+use constant REQUIRED_FIELD_MAP => {
+    product_id => 'product',
+};
+
+use constant UPDATE_COLUMNS => qw(
+    value
+    isactive
+);
+
+use constant VALIDATORS => {
+    product  => \&_check_product,
+    value    => \&_check_value,
+    isactive => \&Bugzilla::Object::check_boolean,
+};
+
+use constant VALIDATOR_DEPENDENCIES => {
+    value => ['product'],
+};
+
+################################
+# Methods
+################################
+
+sub new {
+    my $class = shift;
+    my $param = shift;
+    my $dbh = Bugzilla->dbh;
+
+    my $product;
+    if (ref $param and !defined $param->{id}) {
+        $product = $param->{product};
+        my $name = $param->{name};
+        if (!defined $product) {
+            ThrowCodeError('bad_arg',
+                {argument => 'product',
+                 function => "${class}::new"});
+        }
+        if (!defined $name) {
+            ThrowCodeError('bad_arg',
+                {argument => 'name',
+                 function => "${class}::new"});
+        }
+
+        my $condition = 'product_id = ? AND value = ?';
+        my @values = ($product->id, $name);
+        $param = { condition => $condition, values => \@values };
+    }
+
+    unshift @_, $param;
+    return $class->SUPER::new(@_);
+}
+
+sub new_from_list {
+    my $self = shift;
+    my $list = $self->SUPER::new_from_list(@_);
+    return [sort { vers_cmp(lc($a->name), lc($b->name)) } @$list];
+}
+
+sub run_create_validators {
+    my $class  = shift;
+    my $params = $class->SUPER::run_create_validators(@_);
+    my $product = delete $params->{product};
+    $params->{product_id} = $product->id;
+    return $params;
+}
+
+sub bug_count {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    if (!defined $self->{'bug_count'}) {
+        $self->{'bug_count'} = $dbh->selectrow_array(qq{
+            SELECT COUNT(*) FROM bugs
+            WHERE product_id = ? AND version = ?}, undef,
+            ($self->product_id, $self->name)) || 0;
+    }
+    return $self->{'bug_count'};
+}
+
+sub update {
+    my $self = shift;
+    my ($changes, $old_self) = $self->SUPER::update(@_);
+
+    if (exists $changes->{value}) {
+        my $dbh = Bugzilla->dbh;
+        $dbh->do('UPDATE bugs SET version = ?
+                  WHERE version = ? AND product_id = ?',
+                  undef, ($self->name, $old_self->name, $self->product_id));
+    }
+    return $changes;
+}
+
+sub remove_from_db {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    $dbh->bz_start_transaction();
+
+    # Products must have at least one version.
+    if (scalar(@{$self->product->versions}) == 1) {
+        ThrowUserError('version_is_last', { version => $self });
+    }
+
+    # The version cannot be removed if there are bugs
+    # associated with it.
+    if ($self->bug_count) {
+        ThrowUserError("version_has_bugs", { nb => $self->bug_count });
+    }
+    $self->SUPER::remove_from_db();
+
+    $dbh->bz_commit_transaction();
+}
+
+###############################
+#####     Accessors        ####
+###############################
+
+sub product_id { return $_[0]->{'product_id'}; }
+sub is_active  { return $_[0]->{'isactive'};   }
+
+sub product {
+    my $self = shift;
+
+    require Bugzilla::Product;
+    $self->{'product'} ||= new Bugzilla::Product($self->product_id);
+    return $self->{'product'};
+}
+
+################################
+# Validators
+################################
+
+sub set_name      { $_[0]->set('value', $_[1]);    }
+sub set_is_active { $_[0]->set('isactive', $_[1]); }
+
+sub _check_value {
+    my ($invocant, $name, undef, $params) = @_;
+    my $product = blessed($invocant) ? $invocant->product : $params->{product};
+
+    $name = trim($name);
+    $name || ThrowUserError('version_blank_name');
+    # Remove unprintable characters
+    $name = clean_text($name);
+
+    my $version = new Bugzilla::Version({ product => $product, name => $name });
+    if ($version && (!ref $invocant || $version->id != $invocant->id)) {
+        ThrowUserError('version_already_exists', { name    => $version->name,
+                                                   product => $product->name });
+    }
+    return $name;
+}
+
+sub _check_product {
+    my ($invocant, $product) = @_;
+    $product || ThrowCodeError('param_required',
+                    { function => "$invocant->create", param => 'product' });
+    return Bugzilla->user->check_can_admin_product($product->name);
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Version - Bugzilla product version class.
+
+=head1 SYNOPSIS
+
+    use Bugzilla::Version;
+
+    my $version = new Bugzilla::Version({ name => $name, product => $product_obj });
+    my $version = Bugzilla::Version->check({ name => $name, product => $product_obj });
+    my $version = Bugzilla::Version->check({ id => $id });
+
+    my $value = $version->name;
+    my $product_id = $version->product_id;
+    my $product = $version->product;
+
+    my $version = Bugzilla::Version->create(
+        { value => $name, product => $product_obj });
+
+    $version->set_name($new_name);
+    $version->update();
+
+    $version->remove_from_db;
+
+=head1 DESCRIPTION
+
+Version.pm represents a Product Version object. It is an implementation
+of L<Bugzilla::Object>, and thus provides all methods that
+L<Bugzilla::Object> provides.
+
+The methods that are specific to C<Bugzilla::Version> are listed
+below.
+
+=head1 METHODS
+
+=over
+
+=item C<bug_count()>
+
+ Description: Returns the total of bugs that belong to the version.
+
+ Params:      none.
+
+ Returns:     Integer with the number of bugs.
+
+=back
+
+=cut

diff --git a/Bugzilla/WebService.pm b/Bugzilla/WebService.pm
new file mode 100644 (file)
index 0000000..4d01877
--- /dev/null
+++ b/Bugzilla/WebService.pm
@@ -0,0 +1,320 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# This is the base class for $self in WebService method calls. For the 
+# actual RPC server, see Bugzilla::WebService::Server and its subclasses.
+package Bugzilla::WebService;
+use strict;
+use Bugzilla::WebService::Server;
+
+# Used by the JSON-RPC server to convert incoming date fields apprpriately.
+use constant DATE_FIELDS => {};
+# Used by the JSON-RPC server to convert incoming base64 fields appropriately.
+use constant BASE64_FIELDS => {};
+
+# For some methods, we shouldn't call Bugzilla->login before we call them
+use constant LOGIN_EXEMPT => { };
+
+# Used to allow methods to be called in the JSON-RPC WebService via GET.
+# Methods that can modify data MUST not be listed here.
+use constant READ_ONLY => ();
+
+sub login_exempt {
+    my ($class, $method) = @_;
+    return $class->LOGIN_EXEMPT->{$method};
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::WebService - The Web Service interface to Bugzilla
+
+=head1 DESCRIPTION
+
+This is the standard API for external programs that want to interact
+with Bugzilla. It provides various methods in various modules.
+
+You can interact with this API via
+L<XML-RPC|Bugzilla::WebService::Server::XMLRPC> or
+L<JSON-RPC|Bugzilla::WebService::Server::JSONRPC>.
+
+=head1 CALLING METHODS
+
+Methods are grouped into "packages", like C<Bug> for 
+L<Bugzilla::WebService::Bug>. So, for example,
+L<Bugzilla::WebService::Bug/get>, is called as C<Bug.get>.
+
+=head1 PARAMETERS
+
+The Bugzilla API takes the following various types of parameters:
+
+=over
+
+=item C<int>
+
+Integer. May be null.
+
+=item C<double>
+
+A floating-point number. May be null.
+
+=item C<string>
+
+A string. May be null.
+
+=item C<dateTime>
+
+A date/time. Represented differently in different interfaces to this API.
+May be null.
+
+=item C<boolean>
+
+True or false.
+
+=item C<base64>
+
+A base64-encoded string. This is the only way to transfer
+binary data via the WebService.
+
+=item C<array>
+
+An array. There may be mixed types in an array.
+
+In example code, you will see the characters C<[> and C<]> used to
+represent the beginning and end of arrays.
+
+In our example code in these API docs, an array that contains the numbers
+1, 2, and 3 would look like:
+
+ [1, 2, 3]
+
+=item C<struct>
+
+A mapping of keys to values. Called a "hash", "dict", or "map" in some
+other programming languages. We sometimes call this a "hash" in the API
+documentation.
+
+The keys are strings, and the values can be any type.
+
+In example code, you will see the characters C<{> and C<}> used to represent
+the beginning and end of structs.
+
+For example, a struct with an "fruit" key whose value is "oranges",
+and a "vegetable" key whose value is "lettuce" would look like:
+
+ { fruit => 'oranges', vegetable => 'lettuce' }
+
+=back
+
+=head2 How Bugzilla WebService Methods Take Parameters
+
+B<All> Bugzilla WebService functions use I<named> parameters.
+The individual C<Bugzilla::WebService::Server> modules explain
+how this is implemented for those frontends.
+
+=head1 LOGGING IN
+
+There are various ways to log in:
+
+=over
+
+=item C<User.login>
+
+You can use L<Bugzilla::WebService::User/login> to log in as a Bugzilla 
+user. This issues standard HTTP cookies that you must then use in future
+calls, so your client must be capable of receiving and transmitting
+cookies.
+
+=item C<Bugzilla_login> and C<Bugzilla_password>
+
+B<Added in Bugzilla 3.6>
+
+You can specify C<Bugzilla_login> and C<Bugzilla_password> as arguments
+to any WebService method, and you will be logged in as that user if your
+credentials are correct. Here are the arguments you can specify to any
+WebService method to perform a login:
+
+=over
+
+=item C<Bugzilla_login> (string) - A user's login name.
+
+=item C<Bugzilla_password> (string) - That user's password.
+
+=item C<Bugzilla_restrictlogin> (boolean) - Optional. If true,
+then your login will only be valid for your IP address.
+
+=item C<Bugzilla_rememberlogin> (boolean) - Optional. If true,
+then the cookie sent back to you with the method response will
+not expire.
+
+=back
+
+The C<Bugzilla_restrictlogin> and C<Bugzilla_rememberlogin> options
+are only used when you have also specified C<Bugzilla_login> and 
+C<Bugzilla_password>.
+
+Note that Bugzilla will return HTTP cookies along with the method
+response when you use these arguments (just like the C<User.login> method
+above).
+
+=back
+
+=head1 STABLE, EXPERIMENTAL, and UNSTABLE
+
+Methods are marked B<STABLE> if you can expect their parameters and
+return values not to change between versions of Bugzilla. You are 
+best off always using methods marked B<STABLE>. We may add parameters
+and additional items to the return values, but your old code will
+always continue to work with any new changes we make. If we ever break
+a B<STABLE> interface, we'll post a big notice in the Release Notes,
+and it will only happen during a major new release.
+
+Methods (or parts of methods) are marked B<EXPERIMENTAL> if 
+we I<believe> they will be stable, but there's a slight chance that 
+small parts will change in the future.
+
+Certain parts of a method's description may be marked as B<UNSTABLE>,
+in which case those parts are not guaranteed to stay the same between
+Bugzilla versions.
+
+=head1 ERRORS
+
+If a particular webservice call fails, it will throw an error in the
+appropriate format for the frontend that you are using. For all frontends,
+there is at least a numeric error code and descriptive text for the error.
+
+The various errors that functions can throw are specified by the
+documentation of those functions.
+
+Each error that Bugzilla can throw has a specific numeric code that will
+not change between versions of Bugzilla. If your code needs to know what
+error Bugzilla threw, use the numeric code. Don't try to parse the
+description, because that may change from version to version of Bugzilla.
+
+Note that if you display the error to the user in an HTML program, make
+sure that you properly escape the error, as it will not be HTML-escaped.
+
+=head2 Transient vs. Fatal Errors
+
+If the error code is a number greater than 0, the error is considered
+"transient," which means that it was an error made by the user, not
+some problem with Bugzilla itself.
+
+If the error code is a number less than 0, the error is "fatal," which
+means that it's some error in Bugzilla itself that probably requires
+administrative attention.
+
+Negative numbers and positive numbers don't overlap. That is, if there's
+an error 302, there won't be an error -302.
+
+=head2 Unknown Errors
+
+Sometimes a function will throw an error that doesn't have a specific
+error code. In this case, the code will be C<-32000> if it's a "fatal"
+error, and C<32000> if it's a "transient" error.
+
+=head1 COMMON PARAMETERS
+
+Many Webservice methods take similar arguments. Instead of re-writing
+the documentation for each method, we document the parameters here, once,
+and then refer back to this documentation from the individual methods
+where these parameters are used.
+
+=head2 Limiting What Fields Are Returned
+
+Many WebService methods return an array of structs with various
+fields in the structs. (For example, L<Bugzilla::WebService::Bug/get>
+returns a list of C<bugs> that have fields like C<id>, C<summary>, 
+C<creation_time>, etc.)
+
+These parameters allow you to limit what fields are present in
+the structs, to possibly improve performance or save some bandwidth.
+
+=over
+
+=item C<include_fields> 
+
+C<array> An array of strings, representing the (case-sensitive) names of
+fields in the return value. Only the fields specified in this hash will
+be returned, the rest will not be included.
+
+If you specify an empty array, then this function will return empty
+hashes.
+
+Invalid field names are ignored.
+
+Example:
+
+  User.get( ids => [1], include_fields => ['id', 'name'] )
+
+would return something like:
+
+  { users => [{ id => 1, name => 'user@domain.com' }] }
+
+=item C<exclude_fields>
+
+C<array> An array of strings, representing the (case-sensitive) names of
+fields in the return value. The fields specified will not be included in
+the returned hashes.
+
+If you specify all the fields, then this function will return empty
+hashes.
+
+Some RPC calls support specifying sub fields. If an RPC call states that
+it support sub field restrictions, you can restrict what information is
+returned within the first field. For example, if you call Products.get
+with an include_fields of components.name, then only the component name
+would be returned (and nothing else). You can include the main field,
+and exclude a sub field.
+
+Invalid field names are ignored.
+
+Specifying fields here overrides C<include_fields>, so if you specify a
+field in both, it will be excluded, not included.
+
+Example:
+
+  User.get( ids => [1], exclude_fields => ['name'] )
+
+would return something like:
+
+  { users => [{ id => 1, real_name => 'John Smith' }] }
+
+=back
+
+=head1 SEE ALSO
+
+=head2 Server Types
+
+=over
+
+=item L<Bugzilla::WebService::Server::XMLRPC>
+
+=item L<Bugzilla::WebService::Server::JSONRPC>
+
+=back
+
+=head2 WebService Modules
+
+=over
+
+=item L<Bugzilla::WebService::Bug>
+
+=item L<Bugzilla::WebService::Bugzilla>
+
+=item L<Bugzilla::WebService::Classification>
+
+=item L<Bugzilla::WebService::Group>
+
+=item L<Bugzilla::WebService::Product>
+
+=item L<Bugzilla::WebService::User>
+
+=back

diff --git a/Bugzilla/WebService/Bug.pm b/Bugzilla/WebService/Bug.pm
new file mode 100644 (file)
index 0000000..2c88232
--- /dev/null
+++ b/Bugzilla/WebService/Bug.pm
@@ -0,0 +1,3432 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::WebService::Bug;
+
+use strict;
+use base qw(Bugzilla::WebService);
+
+use Bugzilla::Comment;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Field;
+use Bugzilla::WebService::Constants;
+use Bugzilla::WebService::Util qw(filter filter_wants validate);
+use Bugzilla::Bug;
+use Bugzilla::BugMail;
+use Bugzilla::Util qw(trick_taint trim diff_arrays);
+use Bugzilla::Version;
+use Bugzilla::Milestone;
+use Bugzilla::Status;
+use Bugzilla::Token qw(issue_hash_token);
+
+#############
+# Constants #
+#############
+
+use constant PRODUCT_SPECIFIC_FIELDS => qw(version target_milestone component);
+
+use constant DATE_FIELDS => {
+    comments => ['new_since'],
+    search   => ['last_change_time', 'creation_time'],
+};
+
+use constant BASE64_FIELDS => {
+    add_attachment => ['data'],
+};
+
+use constant READ_ONLY => qw(
+    attachments
+    comments
+    fields
+    get
+    history
+    legal_values
+    search
+);
+
+######################################################
+# Add aliases here for old method name compatibility #
+######################################################
+
+BEGIN { 
+  # In 3.0, get was called get_bugs
+  *get_bugs = \&get;
+  # Before 3.4rc1, "history" was get_history.
+  *get_history = \&history;
+}
+
+###########
+# Methods #
+###########
+
+sub fields {
+    my ($self, $params) = validate(@_, 'ids', 'names');
+
+    Bugzilla->switch_to_shadow_db();
+
+    my @fields;
+    if (defined $params->{ids}) {
+        my $ids = $params->{ids};
+        foreach my $id (@$ids) {
+            my $loop_field = Bugzilla::Field->check({ id => $id });
+            push(@fields, $loop_field);
+        }
+    }
+
+    if (defined $params->{names}) {
+        my $names = $params->{names};
+        foreach my $field_name (@$names) {
+            my $loop_field = Bugzilla::Field->check($field_name);
+            # Don't push in duplicate fields if we also asked for this field
+            # in "ids".
+            if (!grep($_->id == $loop_field->id, @fields)) {
+                push(@fields, $loop_field);
+            }
+        }
+    }
+
+    if (!defined $params->{ids} and !defined $params->{names}) {
+        @fields = @{ Bugzilla->fields({ obsolete => 0 }) };
+    }
+
+    my @fields_out;
+    foreach my $field (@fields) {
+        my $visibility_field = $field->visibility_field
+                               ? $field->visibility_field->name : undef;
+        my $vis_values = $field->visibility_values;
+        my $value_field = $field->value_field
+                          ? $field->value_field->name : undef;
+
+        my (@values, $has_values);
+        if ( ($field->is_select and $field->name ne 'product')
+             or grep($_ eq $field->name, PRODUCT_SPECIFIC_FIELDS)
+             or $field->name eq 'keywords')
+        {
+             $has_values = 1;
+             @values = @{ $self->_legal_field_values({ field => $field }) };
+        } 
+
+        if (grep($_ eq $field->name, PRODUCT_SPECIFIC_FIELDS)) {
+             $value_field = 'product';
+        }
+
+        my %field_data = (
+           id                => $self->type('int', $field->id),
+           type              => $self->type('int', $field->type),
+           is_custom         => $self->type('boolean', $field->custom),
+           name              => $self->type('string', $field->name),
+           display_name      => $self->type('string', $field->description),
+           is_mandatory      => $self->type('boolean', $field->is_mandatory),
+           is_on_bug_entry   => $self->type('boolean', $field->enter_bug),
+           visibility_field  => $self->type('string', $visibility_field),
+           visibility_values =>
+              [ map { $self->type('string', $_->name) } @$vis_values ],
+        );
+        if ($has_values) {
+           $field_data{value_field} = $self->type('string', $value_field);
+           $field_data{values}      = \@values;
+        };
+        push(@fields_out, filter $params, \%field_data);
+    }
+
+    return { fields => \@fields_out };
+}
+
+sub _legal_field_values {
+    my ($self, $params) = @_;
+    my $field = $params->{field};
+    my $field_name = $field->name;
+    my $user = Bugzilla->user;
+
+    my @result;
+    if (grep($_ eq $field_name, PRODUCT_SPECIFIC_FIELDS)) {
+        my @list;
+        if ($field_name eq 'version') {
+            @list = Bugzilla::Version->get_all;
+        }
+        elsif ($field_name eq 'component') {
+            @list = Bugzilla::Component->get_all;
+        }
+        else {
+            @list = Bugzilla::Milestone->get_all;
+        }
+
+        foreach my $value (@list) {
+            my $sortkey = $field_name eq 'target_milestone'
+                          ? $value->sortkey : 0;
+            # XXX This is very slow for large numbers of values.
+            my $product_name = $value->product->name;
+            if ($user->can_see_product($product_name)) {
+                push(@result, {
+                    name     => $self->type('string', $value->name),
+                    sort_key => $self->type('int', $sortkey),
+                    sortkey  => $self->type('int', $sortkey), # deprecated
+                    visibility_values => [$self->type('string', $product_name)],
+                    is_active         => $self->type('boolean', $value->is_active),
+                });
+            }
+        }
+    }
+
+    elsif ($field_name eq 'bug_status') {
+        my @status_all = Bugzilla::Status->get_all;
+        my $initial_status = bless({ id => 0, name => '', is_open => 1, sortkey => 0,
+                                     can_change_to => Bugzilla::Status->can_change_to },
+                                   'Bugzilla::Status');
+        unshift(@status_all, $initial_status);
+
+        foreach my $status (@status_all) {
+            my @can_change_to;
+            foreach my $change_to (@{ $status->can_change_to }) {
+                # There's no need to note that a status can transition
+                # to itself.
+                next if $change_to->id == $status->id;
+                my %change_to_hash = (
+                    name => $self->type('string', $change_to->name),
+                    comment_required => $self->type('boolean', 
+                        $change_to->comment_required_on_change_from($status)),
+                );
+                push(@can_change_to, \%change_to_hash);
+            }
+
+            push (@result, {
+               name     => $self->type('string', $status->name),
+               is_open  => $self->type('boolean', $status->is_open),
+               sort_key => $self->type('int', $status->sortkey),
+               sortkey  => $self->type('int', $status->sortkey), # deprecated
+               can_change_to => \@can_change_to,
+               visibility_values => [],
+            });
+        }
+    }
+
+    elsif ($field_name eq 'keywords') {
+        my @legal_keywords = Bugzilla::Keyword->get_all;
+        foreach my $value (@legal_keywords) {
+            push (@result, {
+               name     => $self->type('string', $value->name),
+               description => $self->type('string', $value->description),
+            });
+        }
+    }
+    else {
+        my @values = Bugzilla::Field::Choice->type($field)->get_all();
+        foreach my $value (@values) {
+            my $vis_val = $value->visibility_value;
+            push(@result, {
+                name     => $self->type('string', $value->name),
+                sort_key => $self->type('int'   , $value->sortkey),
+                sortkey  => $self->type('int'   , $value->sortkey), # deprecated
+                visibility_values => [
+                    defined $vis_val ? $self->type('string', $vis_val->name) 
+                                     : ()
+                ],
+            });
+        }
+    }
+
+    return \@result;
+}
+
+sub comments {
+    my ($self, $params) = validate(@_, 'ids', 'comment_ids');
+
+    if (!(defined $params->{ids} || defined $params->{comment_ids})) {
+        ThrowCodeError('params_required',
+                       { function => 'Bug.comments',
+                         params   => ['ids', 'comment_ids'] });
+    }
+
+    my $bug_ids = $params->{ids} || [];
+    my $comment_ids = $params->{comment_ids} || [];
+
+    my $dbh  = Bugzilla->switch_to_shadow_db();
+    my $user = Bugzilla->user;
+
+    my %bugs;
+    foreach my $bug_id (@$bug_ids) {
+        my $bug = Bugzilla::Bug->check($bug_id);
+        # We want the API to always return comments in the same order.
+   
+        my $comments = $bug->comments({ order => 'oldest_to_newest',
+                                        after => $params->{new_since} });
+        my @result;
+        foreach my $comment (@$comments) {
+            next if $comment->is_private && !$user->is_insider;
+            push(@result, $self->_translate_comment($comment, $params));
+        }
+        $bugs{$bug->id}{'comments'} = \@result;
+    }
+
+    my %comments;
+    if (scalar @$comment_ids) {
+        my @ids = map { trim($_) } @$comment_ids;
+        my $comment_data = Bugzilla::Comment->new_from_list(\@ids);
+
+        # See if we were passed any invalid comment ids.
+        my %got_ids = map { $_->id => 1 } @$comment_data;
+        foreach my $comment_id (@ids) {
+            if (!$got_ids{$comment_id}) {
+                ThrowUserError('comment_id_invalid', { id => $comment_id });
+            }
+        }
+ 
+        # Now make sure that we can see all the associated bugs.
+        my %got_bug_ids = map { $_->bug_id => 1 } @$comment_data;
+        Bugzilla::Bug->check($_) foreach (keys %got_bug_ids);
+
+        foreach my $comment (@$comment_data) {
+            if ($comment->is_private && !$user->is_insider) {
+                ThrowUserError('comment_is_private', { id => $comment->id });
+            }
+            $comments{$comment->id} =
+                $self->_translate_comment($comment, $params);
+        }
+    }
+
+    return { bugs => \%bugs, comments => \%comments };
+}
+
+# Helper for Bug.comments
+sub _translate_comment {
+    my ($self, $comment, $filters) = @_;
+    my $attach_id = $comment->is_about_attachment ? $comment->extra_data
+                                                  : undef;
+    return filter $filters, {
+        id         => $self->type('int', $comment->id),
+        bug_id     => $self->type('int', $comment->bug_id),
+        creator    => $self->type('string', $comment->author->login),
+        author     => $self->type('string', $comment->author->login),
+        time       => $self->type('dateTime', $comment->creation_ts),
+        creation_time => $self->type('dateTime', $comment->creation_ts),
+        is_private => $self->type('boolean', $comment->is_private),
+        text       => $self->type('string', $comment->body_full),
+        attachment_id => $self->type('int', $attach_id),
+        count      => $self->type('int', $comment->count),
+    };
+}
+
+sub get {
+    my ($self, $params) = validate(@_, 'ids');
+
+    Bugzilla->switch_to_shadow_db();
+
+    my $ids = $params->{ids};
+    defined $ids || ThrowCodeError('param_required', { param => 'ids' });
+
+    my @bugs;
+    my @faults;
+    foreach my $bug_id (@$ids) {
+        my $bug;
+        if ($params->{permissive}) {
+            eval { $bug = Bugzilla::Bug->check($bug_id); };
+            if ($@) {
+                push(@faults, {id => $bug_id,
+                               faultString => $@->faultstring,
+                               faultCode => $@->faultcode,
+                              }
+                    );
+                undef $@;
+                next;
+            }
+        }
+        else {
+            $bug = Bugzilla::Bug->check($bug_id);
+        }
+        push(@bugs, $self->_bug_to_hash($bug, $params));
+    }
+
+    return { bugs => \@bugs, faults => \@faults };
+}
+
+# this is a function that gets bug activity for list of bug ids 
+# it can be called as the following:
+# $call = $rpc->call( 'Bug.history', { ids => [1,2] });
+sub history {
+    my ($self, $params) = validate(@_, 'ids');
+
+    Bugzilla->switch_to_shadow_db();
+
+    my $ids = $params->{ids};
+    defined $ids || ThrowCodeError('param_required', { param => 'ids' });
+
+    my %api_name = reverse %{ Bugzilla::Bug::FIELD_MAP() };
+    $api_name{'bug_group'} = 'groups';
+
+    my @return;
+    foreach my $bug_id (@$ids) {
+        my %item;
+        my $bug = Bugzilla::Bug->check($bug_id);
+        $bug_id = $bug->id;
+        $item{id} = $self->type('int', $bug_id);
+
+        my ($activity) = $bug->get_activity;
+
+        my @history;
+        foreach my $changeset (@$activity) {
+            my %bug_history;
+            $bug_history{when} = $self->type('dateTime', $changeset->{when});
+            $bug_history{who}  = $self->type('string', $changeset->{who});
+            $bug_history{changes} = [];
+            foreach my $change (@{ $changeset->{changes} }) {
+                my $api_field = $api_name{$change->{fieldname}} || $change->{fieldname};
+                my $attach_id = delete $change->{attachid};
+                if ($attach_id) {
+                    $change->{attachment_id} = $self->type('int', $attach_id);
+                }
+                $change->{removed} = $self->type('string', $change->{removed});
+                $change->{added}   = $self->type('string', $change->{added});
+                $change->{field_name} = $self->type('string', $api_field);
+                delete $change->{fieldname};
+                push (@{$bug_history{changes}}, $change);
+            }
+            
+            push (@history, \%bug_history);
+        }
+
+        $item{history} = \@history;
+
+        # alias is returned in case users passes a mixture of ids and aliases
+        # then they get to know which bug activity relates to which value  
+        # they passed
+        $item{alias} = $self->type('string', $bug->alias);
+
+        push(@return, \%item);
+    }
+
+    return { bugs => \@return };
+}
+
+sub search {
+    my ($self, $params) = @_;
+
+    Bugzilla->switch_to_shadow_db();
+
+    if ( defined($params->{offset}) and !defined($params->{limit}) ) {
+        ThrowCodeError('param_required', 
+                       { param => 'limit', function => 'Bug.search()' });
+    }
+
+    my $max_results = Bugzilla->params->{max_search_results};
+    unless (defined $params->{limit} && $params->{limit} == 0) {
+        if (!defined $params->{limit} || $params->{limit} > $max_results) {
+            $params->{limit} = $max_results;
+        }
+    }
+    else {
+        delete $params->{limit};
+        delete $params->{offset};
+    }
+
+    $params = Bugzilla::Bug::map_fields($params);
+    delete $params->{WHERE};
+
+    unless (Bugzilla->user->is_timetracker) {
+        delete $params->{$_} foreach qw(estimated_time remaining_time deadline);
+    }
+
+    # Do special search types for certain fields.
+    if ( my $bug_when = delete $params->{delta_ts} ) {
+        $params->{WHERE}->{'delta_ts >= ?'} = $bug_when;
+    }
+    if (my $when = delete $params->{creation_ts}) {
+        $params->{WHERE}->{'creation_ts >= ?'} = $when;
+    }
+    if (my $summary = delete $params->{short_desc}) {
+        my @strings = ref $summary ? @$summary : ($summary);
+        my @likes = ("short_desc LIKE ?") x @strings;
+        my $clause = join(' OR ', @likes);
+        $params->{WHERE}->{"($clause)"} = [map { "\%$_\%" } @strings];
+    }
+    if (my $whiteboard = delete $params->{status_whiteboard}) {
+        my @strings = ref $whiteboard ? @$whiteboard : ($whiteboard);
+        my @likes = ("status_whiteboard LIKE ?") x @strings;
+        my $clause = join(' OR ', @likes);
+        $params->{WHERE}->{"($clause)"} = [map { "\%$_\%" } @strings];
+    }
+
+    # If no other parameters have been passed other than limit and offset
+    # and a WHERE parameter was not created earlier, then we throw error
+    # if system is configured to do so.
+    if (!$params->{WHERE}
+        && !grep(!/(limit|offset)/i, keys %$params)
+        && !Bugzilla->params->{search_allow_no_criteria})
+    {
+        ThrowUserError('buglist_parameters_required');
+    }
+
+    # We want include_fields and exclude_fields to be passed to
+    # _bug_to_hash but not to Bugzilla::Bug->match so we copy the 
+    # params and delete those before passing to Bugzilla::Bug->match.
+    my %match_params = %{ $params };
+    delete $match_params{'include_fields'};
+    delete $match_params{'exclude_fields'};
+
+    my $bugs = Bugzilla::Bug->match(\%match_params);
+    my $visible = Bugzilla->user->visible_bugs($bugs);
+    my @hashes = map { $self->_bug_to_hash($_, $params) } @$visible;
+    return { bugs => \@hashes };
+}
+
+sub possible_duplicates {
+    my ($self, $params) = validate(@_, 'product');
+    my $user = Bugzilla->user;
+
+    Bugzilla->switch_to_shadow_db();
+
+    # Undo the array-ification that validate() does, for "summary".
+    $params->{summary} || ThrowCodeError('param_required',
+        { function => 'Bug.possible_duplicates', param => 'summary' });
+
+    my @products;
+    foreach my $name (@{ $params->{'product'} || [] }) {
+        my $object = $user->can_enter_product($name, THROW_ERROR);
+        push(@products, $object);
+    }
+
+    my $possible_dupes = Bugzilla::Bug->possible_duplicates(
+        { summary => $params->{summary}, products => \@products,
+          limit   => $params->{limit} });
+    my @hashes = map { $self->_bug_to_hash($_, $params) } @$possible_dupes;
+    return { bugs => \@hashes };
+}
+
+sub update {
+    my ($self, $params) = validate(@_, 'ids');
+
+    my $user = Bugzilla->login(LOGIN_REQUIRED);
+    my $dbh = Bugzilla->dbh;
+
+    # We skip certain fields because their set_ methods actually use
+    # the external names instead of the internal names.
+    $params = Bugzilla::Bug::map_fields($params, 
+        { summary => 1, platform => 1, severity => 1, url => 1 });
+
+    my $ids = delete $params->{ids};
+    defined $ids || ThrowCodeError('param_required', { param => 'ids' });
+
+    my @bugs = map { Bugzilla::Bug->check_for_edit($_) } @$ids;
+
+    my %values = %$params;
+    $values{other_bugs} = \@bugs;
+
+    if (exists $values{comment} and exists $values{comment}{comment}) {
+        $values{comment}{body} = delete $values{comment}{comment};
+    }
+
+    # Prevent bugs that could be triggered by specifying fields that
+    # have valid "set_" functions in Bugzilla::Bug, but shouldn't be
+    # called using those field names.
+    delete $values{dependencies};
+    delete $values{flags};
+
+    foreach my $bug (@bugs) {
+        $bug->set_all(\%values);
+    }
+
+    my %all_changes;
+    $dbh->bz_start_transaction();
+    foreach my $bug (@bugs) {
+        $all_changes{$bug->id} = $bug->update();
+    }
+    $dbh->bz_commit_transaction();
+    
+    foreach my $bug (@bugs) {
+        $bug->send_changes($all_changes{$bug->id});
+    }
+
+    my %api_name = reverse %{ Bugzilla::Bug::FIELD_MAP() };
+    # This doesn't normally belong in FIELD_MAP, but we do want to translate
+    # "bug_group" back into "groups".
+    $api_name{'bug_group'} = 'groups';
+
+    my @result;
+    foreach my $bug (@bugs) {
+        my %hash = (
+            id               => $self->type('int', $bug->id),
+            last_change_time => $self->type('dateTime', $bug->delta_ts),
+            changes          => {},
+        );
+
+        # alias is returned in case users pass a mixture of ids and aliases,
+        # so that they can know which set of changes relates to which value
+        # they passed.
+        $hash{alias} = $self->type('string', $bug->alias);
+
+        my %changes = %{ $all_changes{$bug->id} };
+        foreach my $field (keys %changes) {
+            my $change = $changes{$field};
+            my $api_field = $api_name{$field} || $field;
+            # We normalize undef to an empty string, so that the API
+            # stays consistent for things like Deadline that can become
+            # empty.
+            $change->[0] = '' if !defined $change->[0];
+            $change->[1] = '' if !defined $change->[1];
+            $hash{changes}->{$api_field} = {
+                removed => $self->type('string', $change->[0]),
+                added   => $self->type('string', $change->[1]) 
+            };
+        }
+
+        push(@result, \%hash);
+    }
+
+    return { bugs => \@result };
+}
+
+sub create {
+    my ($self, $params) = @_;
+    Bugzilla->login(LOGIN_REQUIRED);
+    $params = Bugzilla::Bug::map_fields($params);
+    my $bug = Bugzilla::Bug->create($params);
+    Bugzilla::BugMail::Send($bug->bug_id, { changer => $bug->reporter });
+    return { id => $self->type('int', $bug->bug_id) };
+}
+
+sub legal_values {
+    my ($self, $params) = @_;
+
+    Bugzilla->switch_to_shadow_db();
+
+    defined $params->{field} 
+        or ThrowCodeError('param_required', { param => 'field' });
+
+    my $field = Bugzilla::Bug::FIELD_MAP->{$params->{field}} 
+                || $params->{field};
+
+    my @global_selects =
+        @{ Bugzilla->fields({ is_select => 1, is_abnormal => 0 }) };
+
+    my $values;
+    if (grep($_->name eq $field, @global_selects)) {
+        # The field is a valid one.
+        trick_taint($field);
+        $values = get_legal_field_values($field);
+    }
+    elsif (grep($_ eq $field, PRODUCT_SPECIFIC_FIELDS)) {
+        my $id = $params->{product_id};
+        defined $id || ThrowCodeError('param_required',
+            { function => 'Bug.legal_values', param => 'product_id' });
+        grep($_->id eq $id, @{Bugzilla->user->get_accessible_products})
+            || ThrowUserError('product_access_denied', { id => $id });
+
+        my $product = new Bugzilla::Product($id);
+        my @objects;
+        if ($field eq 'version') {
+            @objects = @{$product->versions};
+        }
+        elsif ($field eq 'target_milestone') {
+            @objects = @{$product->milestones};
+        }
+        elsif ($field eq 'component') {
+            @objects = @{$product->components};
+        }
+
+        $values = [map { $_->name } @objects];
+    }
+    else {
+        ThrowCodeError('invalid_field_name', { field => $params->{field} });
+    }
+
+    my @result;
+    foreach my $val (@$values) {
+        push(@result, $self->type('string', $val));
+    }
+
+    return { values => \@result };
+}
+
+sub add_attachment {
+    my ($self, $params) = validate(@_, 'ids');
+    my $dbh = Bugzilla->dbh;
+
+    Bugzilla->login(LOGIN_REQUIRED);
+    defined $params->{ids}
+        || ThrowCodeError('param_required', { param => 'ids' });
+    defined $params->{data}
+        || ThrowCodeError('param_required', { param => 'data' });
+
+    my @bugs = map { Bugzilla::Bug->check_for_edit($_) } @{ $params->{ids} };
+
+    my @created;
+    $dbh->bz_start_transaction();
+    my $timestamp = $dbh->selectrow_array('SELECT LOCALTIMESTAMP(0)');
+
+    foreach my $bug (@bugs) {
+        my $attachment = Bugzilla::Attachment->create({
+            bug         => $bug,
+            creation_ts => $timestamp,
+            data        => $params->{data},
+            description => $params->{summary},
+            filename    => $params->{file_name},
+            mimetype    => $params->{content_type},
+            ispatch     => $params->{is_patch},
+            isprivate   => $params->{is_private},
+        });
+        my $comment = $params->{comment} || '';
+        $attachment->bug->add_comment($comment, 
+            { isprivate  => $attachment->isprivate,
+              type       => CMT_ATTACHMENT_CREATED,
+              extra_data => $attachment->id });
+        push(@created, $attachment);
+    }
+    $_->bug->update($timestamp) foreach @created;
+    $dbh->bz_commit_transaction();
+
+    $_->send_changes() foreach @bugs;
+
+    my @created_ids = map { $_->id } @created;
+
+    return { ids => \@created_ids };
+}
+
+sub add_comment {
+    my ($self, $params) = @_;
+
+    # The user must login in order add a comment
+    my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+    # Check parameters
+    defined $params->{id} 
+        || ThrowCodeError('param_required', { param => 'id' }); 
+    my $comment = $params->{comment}; 
+    (defined $comment && trim($comment) ne '')
+        || ThrowCodeError('param_required', { param => 'comment' });
+    
+    my $bug = Bugzilla::Bug->check_for_edit($params->{id});
+
+    # Backwards-compatibility for versions before 3.6    
+    if (defined $params->{private}) {
+        $params->{is_private} = delete $params->{private};
+    }
+    # Append comment
+    $bug->add_comment($comment, { isprivate => $params->{is_private},
+                                  work_time => $params->{work_time} });
+    
+    # Capture the call to bug->update (which creates the new comment) in 
+    # a transaction so we're sure to get the correct comment_id.
+    
+    my $dbh = Bugzilla->dbh;
+    $dbh->bz_start_transaction();
+    
+    $bug->update();
+    
+    my $new_comment_id = $dbh->bz_last_key('longdescs', 'comment_id');
+    
+    $dbh->bz_commit_transaction();
+    
+    # Send mail.
+    Bugzilla::BugMail::Send($bug->bug_id, { changer => $user });
+
+    return { id => $self->type('int', $new_comment_id) };
+}
+
+sub update_see_also {
+    my ($self, $params) = @_;
+
+    my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+    # Check parameters
+    $params->{ids}
+        || ThrowCodeError('param_required', { param => 'id' });
+    my ($add, $remove) = @$params{qw(add remove)};
+    ($add || $remove)
+        or ThrowCodeError('params_required', { params => ['add', 'remove'] });
+
+    my @bugs;
+    foreach my $id (@{ $params->{ids} }) {
+        my $bug = Bugzilla::Bug->check_for_edit($id);
+        push(@bugs, $bug);
+        if ($remove) {
+            $bug->remove_see_also($_) foreach @$remove;
+        }
+        if ($add) {
+            $bug->add_see_also($_) foreach @$add;
+        }
+    }
+    
+    my %changes;
+    foreach my $bug (@bugs) {
+        my $change = $bug->update();
+        if (my $see_also = $change->{see_also}) {
+            $changes{$bug->id}->{see_also} = {
+                removed => [split(', ', $see_also->[0])],
+                added   => [split(', ', $see_also->[1])],
+            };
+        }
+        else {
+            # We still want a changes entry, for API consistency.
+            $changes{$bug->id}->{see_also} = { added => [], removed => [] };
+        }
+
+        Bugzilla::BugMail::Send($bug->id, { changer => $user });
+    }
+
+    return { changes => \%changes };
+}
+
+sub attachments {
+    my ($self, $params) = validate(@_, 'ids', 'attachment_ids');
+
+    Bugzilla->switch_to_shadow_db();
+
+    if (!(defined $params->{ids}
+          or defined $params->{attachment_ids}))
+    {
+        ThrowCodeError('param_required',
+                       { function => 'Bug.attachments', 
+                         params   => ['ids', 'attachment_ids'] });
+    }
+
+    my $ids = $params->{ids} || [];
+    my $attach_ids = $params->{attachment_ids} || [];
+
+    my %bugs;
+    foreach my $bug_id (@$ids) {
+        my $bug = Bugzilla::Bug->check($bug_id);
+        $bugs{$bug->id} = [];
+        foreach my $attach (@{$bug->attachments}) {
+            push @{$bugs{$bug->id}},
+                $self->_attachment_to_hash($attach, $params);
+        }
+    }
+
+    my %attachments;
+    foreach my $attach (@{Bugzilla::Attachment->new_from_list($attach_ids)}) {
+        Bugzilla::Bug->check($attach->bug_id);
+        if ($attach->isprivate && !Bugzilla->user->is_insider) {
+            ThrowUserError('auth_failure', {action    => 'access',
+                                            object    => 'attachment',
+                                            attach_id => $attach->id});
+        }
+        $attachments{$attach->id} =
+            $self->_attachment_to_hash($attach, $params);
+    }
+
+    return { bugs => \%bugs, attachments => \%attachments };
+}
+
+sub update_tags {
+    my ($self, $params) = @_;
+
+    Bugzilla->login(LOGIN_REQUIRED);
+
+    my $ids  = $params->{ids};
+    my $tags = $params->{tags};
+
+    ThrowCodeError('param_required',
+                   { function => 'Bug.update_tags', 
+                     param    => 'ids' }) if !defined $ids;
+
+    ThrowCodeError('param_required',
+                   { function => 'Bug.update_tags', 
+                     param    => 'tags' }) if !defined $tags;
+
+    my %changes;
+    foreach my $bug_id (@$ids) {
+        my $bug = Bugzilla::Bug->check($bug_id);
+        my @old_tags = @{ $bug->tags };
+
+        $bug->remove_tag($_) foreach @{ $tags->{remove} || [] };
+        $bug->add_tag($_) foreach @{ $tags->{add} || [] };
+
+        my ($removed, $added) = diff_arrays(\@old_tags, $bug->tags);
+
+        my @removed = map { $self->type('string', $_) } @$removed;
+        my @added   = map { $self->type('string', $_) } @$added;
+
+        $changes{$bug->id}->{tags} = {
+            removed => \@removed,
+            added   => \@added
+        };
+    }
+
+    return { changes => \%changes };
+}
+
+##############################
+# Private Helper Subroutines #
+##############################
+
+# A helper for get() and search(). This is done in this fashion in order
+# to produce a stable API and to explicitly type return values.
+# The internals of Bugzilla::Bug are not stable enough to just
+# return them directly.
+
+sub _bug_to_hash {
+    my ($self, $bug, $params) = @_;
+
+    # All the basic bug attributes are here, in alphabetical order.
+    # A bug attribute is "basic" if it doesn't require an additional
+    # database call to get the info.
+    my %item = (
+        alias            => $self->type('string', $bug->alias),
+        classification   => $self->type('string', $bug->classification),
+        component        => $self->type('string', $bug->component),
+        creation_time    => $self->type('dateTime', $bug->creation_ts),
+        id               => $self->type('int', $bug->bug_id),
+        is_confirmed     => $self->type('boolean', $bug->everconfirmed),
+        last_change_time => $self->type('dateTime', $bug->delta_ts),
+        op_sys           => $self->type('string', $bug->op_sys),
+        platform         => $self->type('string', $bug->rep_platform),
+        priority         => $self->type('string', $bug->priority),
+        product          => $self->type('string', $bug->product),
+        resolution       => $self->type('string', $bug->resolution),
+        severity         => $self->type('string', $bug->bug_severity),
+        status           => $self->type('string', $bug->bug_status),
+        summary          => $self->type('string', $bug->short_desc),
+        target_milestone => $self->type('string', $bug->target_milestone),
+        url              => $self->type('string', $bug->bug_file_loc),
+        version          => $self->type('string', $bug->version),
+        whiteboard       => $self->type('string', $bug->status_whiteboard),
+    );
+
+
+    # First we handle any fields that require extra SQL calls.
+    # We don't do the SQL calls at all if the filter would just
+    # eliminate them anyway.
+    if (filter_wants $params, 'assigned_to') {
+        $item{'assigned_to'} = $self->type('string', $bug->assigned_to->login);
+    }
+    if (filter_wants $params, 'blocks') {
+        my @blocks = map { $self->type('int', $_) } @{ $bug->blocked };
+        $item{'blocks'} = \@blocks;
+    }
+    if (filter_wants $params, 'cc') {
+        my @cc = map { $self->type('string', $_) } @{ $bug->cc };
+        $item{'cc'} = \@cc;
+    }
+    if (filter_wants $params, 'creator') {
+        $item{'creator'} = $self->type('string', $bug->reporter->login);
+    }
+    if (filter_wants $params, 'depends_on') {
+        my @depends_on = map { $self->type('int', $_) } @{ $bug->dependson };
+        $item{'depends_on'} = \@depends_on;
+    }
+    if (filter_wants $params, 'dupe_of') {
+        $item{'dupe_of'} = $self->type('int', $bug->dup_id);
+    }
+    if (filter_wants $params, 'groups') {
+        my @groups = map { $self->type('string', $_->name) }
+                     @{ $bug->groups_in };
+        $item{'groups'} = \@groups;
+    }
+    if (filter_wants $params, 'is_open') {
+        $item{'is_open'} = $self->type('boolean', $bug->status->is_open);
+    }
+    if (filter_wants $params, 'keywords') {
+        my @keywords = map { $self->type('string', $_->name) }
+                       @{ $bug->keyword_objects };
+        $item{'keywords'} = \@keywords;
+    }
+    if (filter_wants $params, 'qa_contact') {
+        my $qa_login = $bug->qa_contact ? $bug->qa_contact->login : '';
+        $item{'qa_contact'} = $self->type('string', $qa_login);
+    }
+    if (filter_wants $params, 'see_also') {
+        my @see_also = map { $self->type('string', $_->name) }
+                       @{ $bug->see_also };
+        $item{'see_also'} = \@see_also;
+    }
+    if (filter_wants $params, 'flags') {
+        $item{'flags'} = [ map { $self->_flag_to_hash($_) } @{$bug->flags} ];
+    }
+
+    # And now custom fields
+    my @custom_fields = Bugzilla->active_custom_fields;
+    foreach my $field (@custom_fields) {
+        my $name = $field->name;
+        next if !filter_wants $params, $name;
+        if ($field->type == FIELD_TYPE_BUG_ID) {
+            $item{$name} = $self->type('int', $bug->$name);
+        }
+        elsif ($field->type == FIELD_TYPE_DATETIME) {
+            $item{$name} = $self->type('dateTime', $bug->$name);
+        }
+        elsif ($field->type == FIELD_TYPE_MULTI_SELECT) {
+            my @values = map { $self->type('string', $_) } @{ $bug->$name };
+            $item{$name} = \@values;
+        }
+        else {
+            $item{$name} = $self->type('string', $bug->$name);
+        }
+    }
+
+    # Timetracking fields are only sent if the user can see them.
+    if (Bugzilla->user->is_timetracker) {
+        $item{'estimated_time'} = $self->type('double', $bug->estimated_time);
+        $item{'remaining_time'} = $self->type('double', $bug->remaining_time);
+        # No need to format $bug->deadline specially, because Bugzilla::Bug
+        # already does it for us.
+        $item{'deadline'} = $self->type('string', $bug->deadline);
+        $item{'actual_time'} = $self->type('double', $bug->actual_time);
+    }
+
+    if (Bugzilla->user->id) {
+        my $token = issue_hash_token([$bug->id, $bug->delta_ts]);
+        $item{'update_token'} = $self->type('string', $token);
+    }
+
+    # The "accessible" bits go here because they have long names and it
+    # makes the code look nicer to separate them out.
+    $item{'is_cc_accessible'} = $self->type('boolean', 
+                                            $bug->cclist_accessible);
+    $item{'is_creator_accessible'} = $self->type('boolean',
+                                                 $bug->reporter_accessible);
+
+    return filter $params, \%item;
+}
+
+sub _attachment_to_hash {
+    my ($self, $attach, $filters) = @_;
+
+    my $item = filter $filters, {
+        creation_time    => $self->type('dateTime', $attach->attached),
+        last_change_time => $self->type('dateTime', $attach->modification_time),
+        id               => $self->type('int', $attach->id),
+        bug_id           => $self->type('int', $attach->bug_id),
+        file_name        => $self->type('string', $attach->filename),
+        summary          => $self->type('string', $attach->description),
+        description      => $self->type('string', $attach->description),
+        content_type     => $self->type('string', $attach->contenttype),
+        is_private       => $self->type('int', $attach->isprivate),
+        is_obsolete      => $self->type('int', $attach->isobsolete),
+        is_patch         => $self->type('int', $attach->ispatch),
+    };
+
+    # creator/attacher require an extra lookup, so we only send them if
+    # the filter wants them.
+    foreach my $field (qw(creator attacher)) {
+        if (filter_wants $filters, $field) {
+            $item->{$field} = $self->type('string', $attach->attacher->login);
+        }
+    }
+
+    if (filter_wants $filters, 'data') {
+        $item->{'data'} = $self->type('base64', $attach->data);
+    }
+
+    if (filter_wants $filters, 'size') {
+        $item->{'size'} = $self->type('int', $attach->datasize);
+    }
+
+    if (filter_wants $filters, 'flags') {
+        $item->{'flags'} = [ map { $self->_flag_to_hash($_) } @{$attach->flags} ];
+    }
+
+    return $item;
+}
+
+sub _flag_to_hash {
+    my ($self, $flag) = @_;
+
+    my $item = {
+        id                => $self->type('int', $flag->id),
+        name              => $self->type('string', $flag->name),
+        type_id           => $self->type('int', $flag->type_id),
+        creation_date     => $self->type('dateTime', $flag->creation_date), 
+        modification_date => $self->type('dateTime', $flag->modification_date), 
+        status            => $self->type('string', $flag->status)
+    };
+
+    foreach my $field (qw(setter requestee)) {
+        my $field_id = $field . "_id";
+        $item->{$field} = $self->type('string', $flag->$field->login)
+            if $flag->$field_id;
+    }
+
+    return $item;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Webservice::Bug - The API for creating, changing, and getting the
+details of bugs.
+
+=head1 DESCRIPTION
+
+This part of the Bugzilla API allows you to file a new bug in Bugzilla,
+or get information about bugs that have already been filed.
+
+=head1 METHODS
+
+See L<Bugzilla::WebService> for a description of how parameters are passed,
+and what B<STABLE>, B<UNSTABLE>, and B<EXPERIMENTAL> mean.
+
+=head1 Utility Functions
+
+=head2 fields
+
+B<UNSTABLE>
+
+=over
+
+=item B<Description>
+
+Get information about valid bug fields, including the lists of legal values
+for each field.
+
+=item B<Params>
+
+You can pass either field ids or field names.
+
+B<Note>: If neither C<ids> nor C<names> is specified, then all 
+non-obsolete fields will be returned.
+
+In addition to the parameters below, this method also accepts the
+standard L<include_fields|Bugzilla::WebService/include_fields> and
+L<exclude_fields|Bugzilla::WebService/exclude_fields> arguments.
+
+=over
+
+=item C<ids>   (array) - An array of integer field ids.
+
+=item C<names> (array) - An array of strings representing field names.
+
+=back
+
+=item B<Returns>
+
+A hash containing a single element, C<fields>. This is an array of hashes,
+containing the following keys:
+
+=over
+
+=item C<id>
+
+C<int> An integer id uniquely identifying this field in this installation only.
+
+=item C<type>
+
+C<int> The number of the fieldtype. The following values are defined:
+
+=over
+
+=item C<0> Unknown
+
+=item C<1> Free Text
+
+=item C<2> Drop Down
+
+=item C<3> Multiple-Selection Box
+
+=item C<4> Large Text Box
+
+=item C<5> Date/Time
+
+=item C<6> Bug Id
+
+=item C<7> Bug URLs ("See Also")
+
+=back
+
+=item C<is_custom>
+
+C<boolean> True when this is a custom field, false otherwise.
+
+=item C<name>
+
+C<string> The internal name of this field. This is a unique identifier for
+this field. If this is not a custom field, then this name will be the same
+across all Bugzilla installations.
+
+=item C<display_name>
+
+C<string> The name of the field, as it is shown in the user interface.
+
+=item C<is_mandatory>
+
+C<boolean> True if the field must have a value when filing new bugs.
+Also, mandatory fields cannot have their value cleared when updating
+bugs.
+
+=item C<is_on_bug_entry>
+
+C<boolean> For custom fields, this is true if the field is shown when you
+enter a new bug. For standard fields, this is currently always false,
+even if the field shows up when entering a bug. (To know whether or not
+a standard field is valid on bug entry, see L</create>.)
+
+=item C<visibility_field>
+
+C<string>  The name of a field that controls the visibility of this field
+in the user interface. This field only appears in the user interface when
+the named field is equal to one of the values in C<visibility_values>.
+Can be null.
+
+=item C<visibility_values>
+
+C<array> of C<string>s This field is only shown when C<visibility_field>
+matches one of these values. When C<visibility_field> is null,
+then this is an empty array.
+
+=item C<value_field>
+
+C<string>  The name of the field that controls whether or not particular
+values of the field are shown in the user interface. Can be null.
+
+=item C<values>
+
+This is an array of hashes, representing the legal values for
+select-type (drop-down and multiple-selection) fields. This is also
+populated for the C<component>, C<version>, C<target_milestone>, and C<keywords>
+fields, but not for the C<product> field (you must use
+L<Product.get_accessible_products|Bugzilla::WebService::Product/get_accessible_products>
+for that.
+
+For fields that aren't select-type fields, this will simply be an empty
+array.
+
+Each hash has the following keys:
+
+=over 
+
+=item C<name>
+
+C<string> The actual value--this is what you would specify for this
+field in L</create>, etc.
+
+=item C<sort_key>
+
+C<int> Values, when displayed in a list, are sorted first by this integer
+and then secondly by their name.
+
+=item C<sortkey>
+
+B<DEPRECATED> - Use C<sort_key> instead.
+
+=item C<visibility_values>
+
+If C<value_field> is defined for this field, then this value is only shown
+if the C<value_field> is set to one of the values listed in this array.
+Note that for per-product fields, C<value_field> is set to C<'product'>
+and C<visibility_values> will reflect which product(s) this value appears in.
+
+=item C<is_active>
+
+C<boolean> This value is defined only for certain product specific fields
+such as version, target_milestone or component. When true, the value is active,
+otherwise the value is not active.
+
+=item C<description>
+
+C<string> The description of the value. This item is only included for the
+C<keywords> field.
+
+=item C<is_open>
+
+C<boolean> For C<bug_status> values, determines whether this status
+specifies that the bug is "open" (true) or "closed" (false). This item
+is only included for the C<bug_status> field.
+
+=item C<can_change_to>
+
+For C<bug_status> values, this is an array of hashes that determines which
+statuses you can transition to from this status. (This item is only included
+for the C<bug_status> field.)
+
+Each hash contains the following items:
+
+=over
+
+=item C<name>
+
+the name of the new status
+
+=item C<comment_required>
+
+this C<boolean> True if a comment is required when you change a bug into
+this status using this transition.
+
+=back
+
+=back
+
+=back
+
+=item B<Errors>
+
+=over
+
+=item 51 (Invalid Field Name or Id)
+
+You specified an invalid field name or id.
+
+=back
+
+=item B<History>
+
+=over
+
+=item Added in Bugzilla B<3.6>.
+
+=item The C<is_mandatory> return value was added in Bugzilla B<4.0>.
+
+=item C<sortkey> was renamed to C<sort_key> in Bugzilla B<4.2>.
+
+=item C<is_active> return key for C<values> was added in Bugzilla B<4.4>.
+
+=back
+
+=back
+
+
+=head2 legal_values
+
+B<DEPRECATED> - Use L</fields> instead.
+
+=over
+
+=item B<Description>
+
+Tells you what values are allowed for a particular field.
+
+=item B<Params>
+
+=over
+
+=item C<field> - The name of the field you want information about.
+This should be the same as the name you would use in L</create>, below.
+
+=item C<product_id> - If you're picking a product-specific field, you have
+to specify the id of the product you want the values for.
+
+=back
+
+=item B<Returns> 
+
+C<values> - An array of strings: the legal values for this field.
+The values will be sorted as they normally would be in Bugzilla.
+
+=item B<Errors>
+
+=over
+
+=item 106 (Invalid Product)
+
+You were required to specify a product, and either you didn't, or you
+specified an invalid product (or a product that you can't access).
+
+=item 108 (Invalid Field Name)
+
+You specified a field that doesn't exist or isn't a drop-down field.
+
+=back
+
+=back
+
+=head1 Bug Information
+
+=head2 attachments
+
+B<EXPERIMENTAL>
+
+=over
+
+=item B<Description>
+
+It allows you to get data about attachments, given a list of bugs
+and/or attachment ids.
+
+B<Note>: Private attachments will only be returned if you are in the 
+insidergroup or if you are the submitter of the attachment.
+
+=item B<Params>
+
+B<Note>: At least one of C<ids> or C<attachment_ids> is required.
+
+=over
+
+=item C<ids>
+
+See the description of the C<ids> parameter in the L</get> method.
+
+=item C<attachment_ids>
+
+C<array> An array of integer attachment ids.
+
+=back
+
+Also accepts the L<include_fields|Bugzilla::WebService/include_fields>,
+and L<exclude_fields|Bugzilla::WebService/exclude_fields> arguments.
+
+=item B<Returns>
+
+A hash containing two elements: C<bugs> and C<attachments>. The return
+value looks like this:
+
+ {
+     bugs => {
+         1345 => [
+             { (attachment) },
+             { (attachment) }
+         ],
+         9874 => [
+             { (attachment) },
+             { (attachment) }
+         ],
+     },
+
+     attachments => {
+         234 => { (attachment) },
+         123 => { (attachment) },
+     }
+ }
+
+The attachments of any bugs that you specified in the C<ids> argument in
+input are returned in C<bugs> on output. C<bugs> is a hash that has integer
+bug IDs for keys and the values are arrayrefs that contain hashes as attachments.
+(Fields for attachments are described below.)
+
+For any attachments that you specified directly in C<attachment_ids>, they
+are returned in C<attachments> on output. This is a hash where the attachment
+ids point directly to hashes describing the individual attachment.
+
+The fields for each attachment (where it says C<(attachment)> in the
+diagram above) are:
+
+=over
+
+=item C<data>
+
+C<base64> The raw data of the attachment, encoded as Base64.
+
+=item C<size>
+
+C<int> The length (in bytes) of the attachment.
+
+=item C<creation_time>
+
+C<dateTime> The time the attachment was created.
+
+=item C<last_change_time>
+
+C<dateTime> The last time the attachment was modified.
+
+=item C<id>
+
+C<int> The numeric id of the attachment.
+
+=item C<bug_id>
+
+C<int> The numeric id of the bug that the attachment is attached to.
+
+=item C<file_name>
+
+C<string> The file name of the attachment.
+
+=item C<summary>
+
+C<string> A short string describing the attachment.
+
+Also returned as C<description>, for backwards-compatibility with older
+Bugzillas. (However, this backwards-compatibility will go away in Bugzilla
+5.0.)
+
+=item C<content_type>
+
+C<string> The MIME type of the attachment.
+
+=item C<is_private>
+
+C<boolean> True if the attachment is private (only visible to a certain
+group called the "insidergroup"), False otherwise.
+
+=item C<is_obsolete>
+
+C<boolean> True if the attachment is obsolete, False otherwise.
+
+=item C<is_patch>
+
+C<boolean> True if the attachment is a patch, False otherwise.
+
+=item C<creator>
+
+C<string> The login name of the user that created the attachment.
+
+Also returned as C<attacher>, for backwards-compatibility with older
+Bugzillas. (However, this backwards-compatibility will go away in Bugzilla
+5.0.)
+
+=item C<flags>
+
+An array of hashes containing the information about flags currently set
+for each attachment. Each flag hash contains the following items:
+
+=over
+
+=item C<id> 
+
+C<int> The id of the flag.
+
+=item C<name>
+
+C<string> The name of the flag.
+
+=item C<type_id>
+
+C<int> The type id of the flag.
+
+=item C<creation_date>
+
+C<dateTime> The timestamp when this flag was originally created.
+
+=item C<modification_date>
+
+C<dateTime> The timestamp when the flag was last modified.
+
+=item C<status>
+
+C<string> The current status of the flag.
+
+=item C<setter>
+
+C<string> The login name of the user who created or last modified the flag.
+
+=item C<requestee>
+
+C<string> The login name of the user this flag has been requested to be granted or denied.
+Note, this field is only returned if a requestee is set.
+
+=back
+
+=back
+
+=item B<Errors>
+
+This method can throw all the same errors as L</get>. In addition,
+it can also throw the following error:
+
+=over
+
+=item 304 (Auth Failure, Attachment is Private)
+
+You specified the id of a private attachment in the C<attachment_ids>
+argument, and you are not in the "insider group" that can see
+private attachments.
+
+=back
+
+=item B<History>
+
+=over
+
+=item Added in Bugzilla B<3.6>.
+
+=item In Bugzilla B<4.0>, the C<attacher> return value was renamed to
+C<creator>.
+
+=item In Bugzilla B<4.0>, the C<description> return value was renamed to
+C<summary>.
+
+=item The C<data> return value was added in Bugzilla B<4.0>.
+
+=item In Bugzilla B<4.2>, the C<is_url> return value was removed
+(this attribute no longer exists for attachments).
+
+=item The C<size> return value was added in Bugzilla B<4.4>.
+
+=item The C<flags> array was added in Bugzilla B<4.4>.
+
+=back
+
+=back
+
+
+=head2 comments
+
+B<STABLE>
+
+=over
+
+=item B<Description>
+
+This allows you to get data about comments, given a list of bugs 
+and/or comment ids.
+
+=item B<Params>
+
+B<Note>: At least one of C<ids> or C<comment_ids> is required.
+
+In addition to the parameters below, this method also accepts the
+standard L<include_fields|Bugzilla::WebService/include_fields> and
+L<exclude_fields|Bugzilla::WebService/exclude_fields> arguments.
+
+=over
+
+=item C<ids>
+
+C<array> An array that can contain both bug IDs and bug aliases.
+All of the comments (that are visible to you) will be returned for the
+specified bugs.
+
+=item C<comment_ids> 
+
+C<array> An array of integer comment_ids. These comments will be
+returned individually, separate from any other comments in their
+respective bugs.
+
+=item C<new_since>
+
+C<dateTime> If specified, the method will only return comments I<newer>
+than this time. This only affects comments returned from the C<ids>
+argument. You will always be returned all comments you request in the
+C<comment_ids> argument, even if they are older than this date.
+
+=back
+
+=item B<Returns>
+
+Two items are returned:
+
+=over
+
+=item C<bugs>
+
+This is used for bugs specified in C<ids>. This is a hash,
+where the keys are the numeric ids of the bugs, and the value is
+a hash with a single key, C<comments>, which is an array of comments.
+(The format of comments is described below.)
+
+Note that any individual bug will only be returned once, so if you
+specify an id multiple times in C<ids>, it will still only be
+returned once.
+
+=item C<comments>
+
+Each individual comment requested in C<comment_ids> is returned here,
+in a hash where the numeric comment id is the key, and the value
+is the comment. (The format of comments is described below.) 
+
+=back
+
+A "comment" as described above is a hash that contains the following
+keys:
+
+=over
+
+=item id
+
+C<int> The globally unique ID for the comment.
+
+=item bug_id
+
+C<int> The ID of the bug that this comment is on.
+
+=item attachment_id
+
+C<int> If the comment was made on an attachment, this will be the
+ID of that attachment. Otherwise it will be null.
+
+=item count
+
+C<int> The number of the comment local to the bug. The Description is 0,
+comments start with 1.
+
+=item text
+
+C<string> The actual text of the comment.
+
+=item creator
+
+C<string> The login name of the comment's author.
+
+Also returned as C<author>, for backwards-compatibility with older
+Bugzillas. (However, this backwards-compatibility will go away in Bugzilla
+5.0.)
+
+=item time
+
+C<dateTime> The time (in Bugzilla's timezone) that the comment was added.
+
+=item creation_time
+
+C<dateTime> This is exactly same as the C<time> key. Use this field instead of
+C<time> for consistency with other methods including L</get> and L</attachments>.
+For compatibility, C<time> is still usable. However, please note that C<time>
+may be deprecated and removed in a future release.
+
+=item is_private
+
+C<boolean> True if this comment is private (only visible to a certain
+group called the "insidergroup"), False otherwise.
+
+=back
+
+=item B<Errors>
+
+This method can throw all the same errors as L</get>. In addition,
+it can also throw the following errors:
+
+=over
+
+=item 110 (Comment Is Private)
+
+You specified the id of a private comment in the C<comment_ids>
+argument, and you are not in the "insider group" that can see
+private comments.
+
+=item 111 (Invalid Comment ID)
+
+You specified an id in the C<comment_ids> argument that is invalid--either
+you specified something that wasn't a number, or there is no comment with
+that id.
+
+=back
+
+=item B<History>
+
+=over
+
+=item Added in Bugzilla B<3.4>.
+
+=item C<attachment_id> was added to the return value in Bugzilla B<3.6>.
+
+=item In Bugzilla B<4.0>, the C<author> return value was renamed to
+C<creator>.
+
+=item C<count> was added to the return value in Bugzilla B<4.4>.
+
+=item C<creation_time> was added in Bugzilla B<4.4>.
+
+=back
+
+=back
+
+
+=head2 get
+
+B<STABLE>
+
+=over
+
+=item B<Description>
+
+Gets information about particular bugs in the database.
+
+Note: Can also be called as "get_bugs" for compatibilty with Bugzilla 3.0 API.
+
+=item B<Params>
+
+In addition to the parameters below, this method also accepts the
+standard L<include_fields|Bugzilla::WebService/include_fields> and
+L<exclude_fields|Bugzilla::WebService/exclude_fields> arguments.
+
+=over
+
+=item C<ids>
+
+An array of numbers and strings.
+
+If an element in the array is entirely numeric, it represents a bug_id
+from the Bugzilla database to fetch. If it contains any non-numeric 
+characters, it is considered to be a bug alias instead, and the bug with 
+that alias will be loaded. 
+
+=item C<permissive> B<EXPERIMENTAL>
+
+C<boolean> Normally, if you request any inaccessible or invalid bug ids,
+Bug.get will throw an error. If this parameter is True, instead of throwing an
+error we return an array of hashes with a C<id>, C<faultString> and C<faultCode> 
+for each bug that fails, and return normal information for the other bugs that 
+were accessible.
+
+=back
+
+=item B<Returns>
+
+Two items are returned:
+
+=over
+
+=item C<bugs>
+
+An array of hashes that contains information about the bugs with 
+the valid ids. Each hash contains the following items:
+
+=over
+
+=item C<actual_time>
+
+C<double> The total number of hours that this bug has taken (so far).
+
+If you are not in the time-tracking group, this field will not be included
+in the return value.
+
+=item C<alias>
+
+C<string> The unique alias of this bug.
+
+=item C<assigned_to>
+
+C<string> The login name of the user to whom the bug is assigned.
+
+=item C<blocks>
+
+C<array> of C<int>s. The ids of bugs that are "blocked" by this bug.
+
+=item C<cc>
+
+C<array> of C<string>s. The login names of users on the CC list of this
+bug.
+
+=item C<classification>
+
+C<string> The name of the current classification the bug is in.
+
+=item C<component>
+
+C<string> The name of the current component of this bug.
+
+=item C<creation_time>
+
+C<dateTime> When the bug was created.
+
+=item C<creator>
+
+C<string> The login name of the person who filed this bug (the reporter).
+
+=item C<deadline>
+
+C<string> The day that this bug is due to be completed, in the format
+C<YYYY-MM-DD>.
+
+If you are not in the time-tracking group, this field will not be included
+in the return value.
+
+=item C<depends_on>
+
+C<array> of C<int>s. The ids of bugs that this bug "depends on".
+
+=item C<dupe_of>
+
+C<int> The bug ID of the bug that this bug is a duplicate of. If this bug 
+isn't a duplicate of any bug, this will be null.
+
+=item C<estimated_time>
+
+C<double> The number of hours that it was estimated that this bug would
+take.
+
+If you are not in the time-tracking group, this field will not be included
+in the return value.
+
+=item C<flags>
+
+An array of hashes containing the information about flags currently set
+for the bug. Each flag hash contains the following items:
+
+=over
+
+=item C<id> 
+
+C<int> The id of the flag.
+
+=item C<name>
+
+C<string> The name of the flag.
+
+=item C<type_id>
+
+C<int> The type id of the flag.
+
+=item C<creation_date>
+
+C<dateTime> The timestamp when this flag was originally created.
+
+=item C<modification_date>
+
+C<dateTime> The timestamp when the flag was last modified.
+
+=item C<status>
+
+C<string> The current status of the flag.
+
+=item C<setter>
+
+C<string> The login name of the user who created or last modified the flag.
+
+=item C<requestee>
+
+C<string> The login name of the user this flag has been requested to be granted or denied.
+Note, this field is only returned if a requestee is set.
+
+=back
+
+=item C<groups>
+
+C<array> of C<string>s. The names of all the groups that this bug is in.
+
+=item C<id>
+
+C<int> The unique numeric id of this bug.
+
+=item C<is_cc_accessible>
+
+C<boolean> If true, this bug can be accessed by members of the CC list,
+even if they are not in the groups the bug is restricted to.
+
+=item C<is_confirmed>
+
+C<boolean> True if the bug has been confirmed. Usually this means that
+the bug has at some point been moved out of the C<UNCONFIRMED> status
+and into another open status.
+
+=item C<is_open>
+
+C<boolean> True if this bug is open, false if it is closed.
+
+=item C<is_creator_accessible>
+
+C<boolean> If true, this bug can be accessed by the creator (reporter)
+of the bug, even if he or she is not a member of the groups the bug
+is restricted to.
+
+=item C<keywords>
+
+C<array> of C<string>s. Each keyword that is on this bug.
+
+=item C<last_change_time>
+
+C<dateTime> When the bug was last changed.
+
+=item C<op_sys>
+
+C<string> The name of the operating system that the bug was filed against.
+
+=item C<platform>
+
+C<string> The name of the platform (hardware) that the bug was filed against.
+
+=item C<priority>
+
+C<string> The priority of the bug.
+
+=item C<product>
+
+C<string> The name of the product this bug is in.
+
+=item C<qa_contact>
+
+C<string> The login name of the current QA Contact on the bug.
+
+=item C<remaining_time>
+
+C<double> The number of hours of work remaining until work on this bug
+is complete.
+
+If you are not in the time-tracking group, this field will not be included
+in the return value.
+
+=item C<resolution>
+
+C<string> The current resolution of the bug, or an empty string if the bug
+is open.
+
+=item C<see_also>
+
+B<UNSTABLE>
+
+C<array> of C<string>s. The URLs in the See Also field on the bug.
+
+=item C<severity>
+
+C<string> The current severity of the bug.
+
+=item C<status>
+
+C<string> The current status of the bug.
+
+=item C<summary>
+
+C<string> The summary of this bug.
+
+=item C<target_milestone>
+
+C<string> The milestone that this bug is supposed to be fixed by, or for
+closed bugs, the milestone that it was fixed for.
+
+=item C<update_token>
+
+C<string> The token that you would have to pass to the F<process_bug.cgi>
+page in order to update this bug. This changes every time the bug is
+updated.
+
+This field is not returned to logged-out users.
+
+=item C<url>
+
+B<UNSTABLE>
+
+C<string> A URL that demonstrates the problem described in
+the bug, or is somehow related to the bug report.
+
+=item C<version>
+
+C<string> The version the bug was reported against.
+
+=item C<whiteboard>
+
+C<string> The value of the "status whiteboard" field on the bug.
+
+=item I<custom fields>
+
+Every custom field in this installation will also be included in the
+return value. Most fields are returned as C<string>s. However, some
+field types have different return values:
+
+=over
+
+=item Bug ID Fields - C<int>
+
+=item Multiple-Selection Fields - C<array> of C<string>s.
+
+=item Date/Time Fields - C<dateTime>
+
+=back 
+
+=back
+
+=item C<faults> B<EXPERIMENTAL>
+
+An array of hashes that contains invalid bug ids with error messages
+returned for them. Each hash contains the following items:
+
+=over
+
+=item id
+
+C<int> The numeric bug_id of this bug.
+
+=item faultString 
+
+C<string> This will only be returned for invalid bugs if the C<permissive>
+argument was set when calling Bug.get, and it is an error indicating that 
+the bug id was invalid.
+
+=item faultCode
+
+C<int> This will only be returned for invalid bugs if the C<permissive>
+argument was set when calling Bug.get, and it is the error code for the 
+invalid bug error.
+
+=back
+
+=back
+
+=item B<Errors>
+
+=over
+
+=item 100 (Invalid Bug Alias)
+
+If you specified an alias and there is no bug with that alias.
+
+=item 101 (Invalid Bug ID)
+
+The bug_id you specified doesn't exist in the database.
+
+=item 102 (Access Denied)
+
+You do not have access to the bug_id you specified.
+
+=back
+
+=item B<History>
+
+=over
+
+=item C<permissive> argument added to this method's params in Bugzilla B<3.4>. 
+
+=item The following properties were added to this method's return values
+in Bugzilla B<3.4>:
+
+=over
+
+=item For C<bugs>
+
+=over
+
+=item assigned_to
+
+=item component 
+
+=item dupe_of
+
+=item is_open
+
+=item priority
+
+=item product
+
+=item resolution
+
+=item severity
+
+=item status
+
+=back 
+
+=item C<faults>
+
+=back 
+
+=item In Bugzilla B<4.0>, the following items were added to the C<bugs>
+return value: C<blocks>, C<cc>, C<classification>, C<creator>,
+C<deadline>, C<depends_on>, C<estimated_time>, C<is_cc_accessible>, 
+C<is_confirmed>, C<is_creator_accessible>, C<groups>, C<keywords>,
+C<op_sys>, C<platform>, C<qa_contact>, C<remaining_time>, C<see_also>,
+C<target_milestone>, C<update_token>, C<url>, C<version>, C<whiteboard>,
+and all custom fields.
+
+=item The C<flags> array was added in Bugzilla B<4.4>.
+
+=item The C<actual_time> item was added to the C<bugs> return value
+in Bugzilla B<4.4>.
+
+=back
+
+=back
+
+=head2 history
+
+B<EXPERIMENTAL>
+
+=over
+
+=item B<Description>
+
+Gets the history of changes for particular bugs in the database.
+
+=item B<Params>
+
+=over
+
+=item C<ids>
+
+An array of numbers and strings.
+
+If an element in the array is entirely numeric, it represents a bug_id 
+from the Bugzilla database to fetch. If it contains any non-numeric 
+characters, it is considered to be a bug alias instead, and the data bug 
+with that alias will be loaded. 
+
+=back
+
+=item B<Returns>
+
+A hash containing a single element, C<bugs>. This is an array of hashes,
+containing the following keys:
+
+=over
+
+=item id
+
+C<int> The numeric id of the bug.
+
+=item alias
+
+C<string> The alias of this bug. If there is no alias, this will be undef.
+
+=item history
+
+C<array> An array of hashes, each hash having the following keys:
+
+=over
+
+=item when
+
+C<dateTime> The date the bug activity/change happened.
+
+=item who
+
+C<string> The login name of the user who performed the bug change.
+
+=item changes
+
+C<array> An array of hashes which contain all the changes that happened
+to the bug at this time (as specified by C<when>). Each hash contains 
+the following items:
+
+=over
+
+=item field_name
+
+C<string> The name of the bug field that has changed.
+
+=item removed
+
+C<string> The previous value of the bug field which has been deleted 
+by the change.
+
+=item added
+
+C<string> The new value of the bug field which has been added by the change.
+
+=item attachment_id
+
+C<int> The id of the attachment that was changed. This only appears if 
+the change was to an attachment, otherwise C<attachment_id> will not be
+present in this hash.
+
+=back
+
+=back
+
+=back
+
+=item B<Errors>
+
+The same as L</get>.
+
+=item B<History>
+
+=over
+
+=item Added in Bugzilla B<3.4>.
+
+=item Field names returned by the C<field_name> field changed to be
+consistent with other methods. Since Bugzilla B<4.4>, they now match
+names used by L<Bug.update|/"update"> for consistency.
+
+=back
+
+=back
+
+
+=head2 search
+
+B<UNSTABLE>
+
+=over
+
+=item B<Description>
+
+Allows you to search for bugs based on particular criteria.
+
+=item B<Params>
+
+Unless otherwise specified in the description of a parameter, bugs are
+returned if they match I<exactly> the criteria you specify in these 
+parameters. That is, we don't match against substrings--if a bug is in
+the "Widgets" product and you ask for bugs in the "Widg" product, you
+won't get anything.
+
+Criteria are joined in a logical AND. That is, you will be returned
+bugs that match I<all> of the criteria, not bugs that match I<any> of
+the criteria.
+
+Each parameter can be either the type it says, or an array of the types
+it says. If you pass an array, it means "Give me bugs with I<any> of
+these values." For example, if you wanted bugs that were in either
+the "Foo" or "Bar" products, you'd pass:
+
+ product => ['Foo', 'Bar']
+
+Some Bugzillas may treat your arguments case-sensitively, depending
+on what database system they are using. Most commonly, though, Bugzilla is 
+not case-sensitive with the arguments passed (because MySQL is the 
+most-common database to use with Bugzilla, and MySQL is not case sensitive).
+
+=over
+
+=item C<alias>
+
+C<string> The unique alias for this bug.
+
+=item C<assigned_to>
+
+C<string> The login name of a user that a bug is assigned to.
+
+=item C<component>
+
+C<string> The name of the Component that the bug is in. Note that
+if there are multiple Components with the same name, and you search
+for that name, bugs in I<all> those Components will be returned. If you
+don't want this, be sure to also specify the C<product> argument.
+
+=item C<creation_time>
+
+C<dateTime> Searches for bugs that were created at this time or later.
+May not be an array.
+
+=item C<creator>
+
+C<string> The login name of the user who created the bug.
+
+You can also pass this argument with the name C<reporter>, for
+backwards compatibility with older Bugzillas.
+
+=item C<id>
+
+C<int> The numeric id of the bug.
+
+=item C<last_change_time>
+
+C<dateTime> Searches for bugs that were modified at this time or later.
+May not be an array.
+
+=item C<limit>
+
+C<int> Limit the number of results returned to C<int> records. If the limit
+is more than zero and higher than the maximum limit set by the administrator,
+then the maximum limit will be used instead. If you set the limit equal to zero,
+then all matching results will be returned instead.
+
+=item C<offset>
+
+C<int> Used in conjunction with the C<limit> argument, C<offset> defines
+the starting position for the search. For example, given a search that
+would return 100 bugs, setting C<limit> to 10 and C<offset> to 10 would return
+bugs 11 through 20 from the set of 100.
+
+=item C<op_sys>
+
+C<string> The "Operating System" field of a bug.
+
+=item C<platform>
+
+C<string> The Platform (sometimes called "Hardware") field of a bug.
+
+=item C<priority>
+
+C<string> The Priority field on a bug.
+
+=item C<product>
+
+C<string> The name of the Product that the bug is in.
+
+=item C<resolution>
+
+C<string> The current resolution--only set if a bug is closed. You can
+find open bugs by searching for bugs with an empty resolution.
+
+=item C<severity>
+
+C<string> The Severity field on a bug.
+
+=item C<status>
+
+C<string> The current status of a bug (not including its resolution,
+if it has one, which is a separate field above).
+
+=item C<summary>
+
+C<string> Searches for substrings in the single-line Summary field on
+bugs. If you specify an array, then bugs whose summaries match I<any> of the
+passed substrings will be returned.
+
+Note that unlike searching in the Bugzilla UI, substrings are not split
+on spaces. So searching for C<foo bar> will match "This is a foo bar"
+but not "This foo is a bar". C<['foo', 'bar']>, would, however, match
+the second item.
+
+=item C<target_milestone>
+
+C<string> The Target Milestone field of a bug. Note that even if this
+Bugzilla does not have the Target Milestone field enabled, you can
+still search for bugs by Target Milestone. However, it is likely that
+in that case, most bugs will not have a Target Milestone set (it
+defaults to "---" when the field isn't enabled).
+
+=item C<qa_contact>
+
+C<string> The login name of the bug's QA Contact. Note that even if
+this Bugzilla does not have the QA Contact field enabled, you can
+still search for bugs by QA Contact (though it is likely that no bug
+will have a QA Contact set, if the field is disabled).
+
+=item C<url>
+
+C<string> The "URL" field of a bug.
+
+=item C<version>
+
+C<string> The Version field of a bug.
+
+=item C<whiteboard>
+
+C<string> Search the "Status Whiteboard" field on bugs for a substring.
+Works the same as the C<summary> field described above, but searches the
+Status Whiteboard field.
+
+=back
+
+=item B<Returns>
+
+The same as L</get>.
+
+Note that you will only be returned information about bugs that you
+can see. Bugs that you can't see will be entirely excluded from the
+results. So, if you want to see private bugs, you will have to first 
+log in and I<then> call this method.
+
+=item B<Errors>
+
+If you specify an invalid value for a particular field, you just won't
+get any results for that value.
+
+=over
+
+=item 1000 (Parameters Required)
+
+You may not search without any search terms.
+
+=back
+
+=item B<History>
+
+=over
+
+=item Added in Bugzilla B<3.4>.
+
+=item Searching by C<votes> was removed in Bugzilla B<4.0>.
+
+=item The C<reporter> input parameter was renamed to C<creator>
+in Bugzilla B<4.0>.
+
+=item In B<4.2.6> and newer, added the ability to return all results if
+C<limit> is set equal to zero. Otherwise maximum results returned are limited
+by system configuration.
+
+=back
+
+=back
+
+
+=head1 Bug Creation and Modification
+
+=head2 create
+
+B<STABLE>
+
+=over
+
+=item B<Description>
+
+This allows you to create a new bug in Bugzilla. If you specify any
+invalid fields, an error will be thrown stating which field is invalid.
+If you specify any fields you are not allowed to set, they will just be
+set to their defaults or ignored.
+
+You cannot currently set all the items here that you can set on enter_bug.cgi.
+
+The WebService interface may allow you to set things other than those listed
+here, but realize that anything undocumented is B<UNSTABLE> and will very
+likely change in the future.
+
+=item B<Params>
+
+Some params must be set, or an error will be thrown. These params are
+marked B<Required>. 
+
+Some parameters can have defaults set in Bugzilla, by the administrator.
+If these parameters have defaults set, you can omit them. These parameters
+are marked B<Defaulted>.
+
+Clients that want to be able to interact uniformly with multiple
+Bugzillas should always set both the params marked B<Required> and those 
+marked B<Defaulted>, because some Bugzillas may not have defaults set
+for B<Defaulted> parameters, and then this method will throw an error
+if you don't specify them.
+
+The descriptions of the parameters below are what they mean when Bugzilla is
+being used to track software bugs. They may have other meanings in some
+installations.
+
+=over
+
+=item C<product> (string) B<Required> - The name of the product the bug
+is being filed against.
+
+=item C<component> (string) B<Required> - The name of a component in the
+product above.
+
+=item C<summary> (string) B<Required> - A brief description of the bug being
+filed.
+
+=item C<version> (string) B<Required> - A version of the product above;
+the version the bug was found in.
+
+=item C<description> (string) B<Defaulted> - The initial description for 
+this bug. Some Bugzilla installations require this to not be blank.
+
+=item C<op_sys> (string) B<Defaulted> - The operating system the bug was
+discovered on.
+
+=item C<platform> (string) B<Defaulted> - What type of hardware the bug was
+experienced on.
+
+=item C<priority> (string) B<Defaulted> - What order the bug will be fixed
+in by the developer, compared to the developer's other bugs.
+
+=item C<severity> (string) B<Defaulted> - How severe the bug is.
+
+=item C<alias> (string) - A brief alias for the bug that can be used 
+instead of a bug number when accessing this bug. Must be unique in
+all of this Bugzilla.
+
+=item C<assigned_to> (username) - A user to assign this bug to, if you
+don't want it to be assigned to the component owner.
+
+=item C<cc> (array) - An array of usernames to CC on this bug.
+
+=item C<comment_is_private> (boolean) - If set to true, the description
+is private, otherwise it is assumed to be public.
+
+=item C<groups> (array) - An array of group names to put this
+bug into. You can see valid group names on the Permissions
+tab of the Preferences screen, or, if you are an administrator,
+in the Groups control panel.
+If you don't specify this argument, then the bug will be added into
+all the groups that are set as being "Default" for this product. (If
+you want to avoid that, you should specify C<groups> as an empty array.)
+
+=item C<qa_contact> (username) - If this installation has QA Contacts
+enabled, you can set the QA Contact here if you don't want to use
+the component's default QA Contact.
+
+=item C<status> (string) - The status that this bug should start out as.
+Note that only certain statuses can be set on bug creation.
+
+=item C<resolution> (string) - If you are filing a closed bug, then
+you will have to specify a resolution. You cannot currently specify
+a resolution of C<DUPLICATE> for new bugs, though. That must be done
+with L</update>.
+
+=item C<target_milestone> (string) - A valid target milestone for this
+product.
+
+=back
+
+In addition to the above parameters, if your installation has any custom
+fields, you can set them just by passing in the name of the field and
+its value as a string.
+
+=item B<Returns>
+
+A hash with one element, C<id>. This is the id of the newly-filed bug.
+
+=item B<Errors>
+
+=over
+
+=item 51 (Invalid Object)
+
+You specified a field value that is invalid. The error message will have
+more details.
+
+=item 103 (Invalid Alias)
+
+The alias you specified is invalid for some reason. See the error message
+for more details.
+
+=item 104 (Invalid Field)
+
+One of the drop-down fields has an invalid value, or a value entered in a
+text field is too long. The error message will have more detail.
+
+=item 105 (Invalid Component)
+
+You didn't specify a component.
+
+=item 106 (Invalid Product)
+
+Either you didn't specify a product, this product doesn't exist, or
+you don't have permission to enter bugs in this product.
+
+=item 107 (Invalid Summary)
+
+You didn't specify a summary for the bug.
+
+=item 116 (Dependency Loop)
+
+You specified values in the C<blocks> or C<depends_on> fields
+that would cause a circular dependency between bugs.
+
+=item 120 (Group Restriction Denied)
+
+You tried to restrict the bug to a group which does not exist, or which
+you cannot use with this product.
+
+=item 504 (Invalid User)
+
+Either the QA Contact, Assignee, or CC lists have some invalid user
+in them. The error message will have more details.
+
+=back
+
+=item B<History>
+
+=over
+
+=item Before B<3.0.4>, parameters marked as B<Defaulted> were actually
+B<Required>, due to a bug in Bugzilla.
+
+=item The C<groups> argument was added in Bugzilla B<4.0>. Before
+Bugzilla 4.0, bugs were only added into Mandatory groups by this
+method. Since Bugzilla B<4.0.2>, passing an illegal group name will
+throw an error. In Bugzilla 4.0 and 4.0.1, illegal group names were
+silently ignored.
+
+=item The C<comment_is_private> argument was added in Bugzilla B<4.0>.
+Before Bugzilla 4.0, you had to use the undocumented C<commentprivacy>
+argument.
+
+=item Error 116 was added in Bugzilla B<4.0>. Before that, dependency
+loop errors had a generic code of C<32000>.
+
+=item The ability to file new bugs with a C<resolution> was added in
+Bugzilla B<4.4>.
+
+=back
+
+=back
+
+
+=head2 add_attachment
+
+B<STABLE>
+
+=over
+
+=item B<Description>
+
+This allows you to add an attachment to a bug in Bugzilla.
+
+=item B<Params>
+
+=over
+
+=item C<ids>
+
+B<Required> C<array> An array of ints and/or strings--the ids
+or aliases of bugs that you want to add this attachment to.
+The same attachment and comment will be added to all
+these bugs.
+
+=item C<data>
+
+B<Required> C<base64> or C<string> The content of the attachment.
+If the content of the attachment is not ASCII text, you must encode
+it in base64 and declare it as the C<base64> type.
+
+=item C<file_name>
+
+B<Required> C<string> The "file name" that will be displayed
+in the UI for this attachment.
+
+=item C<summary>
+
+B<Required> C<string> A short string describing the
+attachment.
+
+=item C<content_type>
+
+B<Required> C<string> The MIME type of the attachment, like
+C<text/plain> or C<image/png>.
+
+=item C<comment>
+
+C<string> A comment to add along with this attachment.
+
+=item C<is_patch>
+
+C<boolean> True if Bugzilla should treat this attachment as a patch.
+If you specify this, you do not need to specify a C<content_type>.
+The C<content_type> of the attachment will be forced to C<text/plain>.
+
+Defaults to False if not specified.
+
+=item C<is_private>
+
+C<boolean> True if the attachment should be private (restricted
+to the "insidergroup"), False if the attachment should be public.
+
+Defaults to False if not specified.
+
+=back
+
+=item B<Returns>
+
+A single item C<ids>, which contains an array of the
+attachment id(s) created.
+
+=item B<Errors>
+
+This method can throw all the same errors as L</get>, plus:
+
+=over
+
+=item 600 (Attachment Too Large)
+
+You tried to attach a file that was larger than Bugzilla will accept.
+
+=item 601 (Invalid MIME Type)
+
+You specified a C<content_type> argument that was blank, not a valid
+MIME type, or not a MIME type that Bugzilla accepts for attachments.
+
+=item 603 (File Name Not Specified)
+
+You did not specify a valid for the C<file_name> argument.
+
+=item 604 (Summary Required)
+
+You did not specify a value for the C<summary> argument.
+
+=item 606 (Empty Data)
+
+You set the "data" field to an empty string.
+
+=back
+
+=item B<History>
+
+=over
+
+=item Added in Bugzilla B<4.0>.
+
+=item The C<is_url> parameter was removed in Bugzilla B<4.2>.
+
+=item The return value has changed in Bugzilla B<4.4>.
+
+=back
+
+=back
+
+
+=head2 add_comment
+
+B<STABLE>
+
+=over
+
+=item B<Description>
+
+This allows you to add a comment to a bug in Bugzilla.
+
+=item B<Params>
+
+=over
+
+=item C<id> (int or string) B<Required> - The id or alias of the bug to append a 
+comment to.
+
+=item C<comment> (string) B<Required> - The comment to append to the bug.
+If this is empty or all whitespace, an error will be thrown saying that
+you did not set the C<comment> parameter.
+
+=item C<is_private> (boolean) - If set to true, the comment is private, 
+otherwise it is assumed to be public.
+
+=item C<work_time> (double) - Adds this many hours to the "Hours Worked"
+on the bug. If you are not in the time tracking group, this value will
+be ignored.
+
+
+=back
+
+=item B<Returns>
+
+A hash with one element, C<id> whose value is the id of the newly-created comment.
+
+=item B<Errors>
+
+=over
+
+=item 54 (Hours Worked Too Large)
+
+You specified a C<work_time> larger than the maximum allowed value of
+C<99999.99>.
+
+=item 100 (Invalid Bug Alias) 
+
+If you specified an alias and there is no bug with that alias.
+
+=item 101 (Invalid Bug ID)
+
+The id you specified doesn't exist in the database.
+
+=item 109 (Bug Edit Denied)
+
+You did not have the necessary rights to edit the bug.
+
+=item 113 (Can't Make Private Comments)
+
+You tried to add a private comment, but don't have the necessary rights.
+
+=item 114 (Comment Too Long)
+
+You tried to add a comment longer than the maximum allowed length
+(65,535 characters).
+
+=back
+
+=item B<History>
+
+=over
+
+=item Added in Bugzilla B<3.2>.
+
+=item Modified to return the new comment's id in Bugzilla B<3.4>
+
+=item Modified to throw an error if you try to add a private comment
+but can't, in Bugzilla B<3.4>.
+
+=item Before Bugzilla B<3.6>, the C<is_private> argument was called
+C<private>, and you can still call it C<private> for backwards-compatibility
+purposes if you wish.
+
+=item Before Bugzilla B<3.6>, error 54 and error 114 had a generic error
+code of 32000.
+
+=back
+
+=back
+
+
+=head2 update
+
+B<UNSTABLE>
+
+=over
+
+=item B<Description>
+
+Allows you to update the fields of a bug. Automatically sends emails
+out about the changes.
+
+=item B<Params>
+
+=over
+
+=item C<ids>
+
+Array of C<int>s or C<string>s. The ids or aliases of the bugs that
+you want to modify.
+
+=back
+
+B<Note>: All following fields specify the values you want to set on the
+bugs you are updating.
+
+=over
+
+=item C<alias>
+
+(string) The alias of the bug. You can only set this if you are modifying 
+a single bug. If there is more than one bug specified in C<ids>, passing in
+a value for C<alias> will cause an error to be thrown.
+
+=item C<assigned_to>
+
+C<string> The full login name of the user this bug is assigned to.
+
+=item C<blocks>
+
+=item C<depends_on>
+
+C<hash> These specify the bugs that this bug blocks or depends on,
+respectively. To set these, you should pass a hash as the value. The hash
+may contain the following fields:
+
+=over
+
+=item C<add> An array of C<int>s. Bug ids to add to this field.
+
+=item C<remove> An array of C<int>s. Bug ids to remove from this field.
+If the bug ids are not already in the field, they will be ignored.
+
+=item C<set> An array of C<int>s. An exact set of bug ids to set this
+field to, overriding the current value. If you specify C<set>, then C<add>
+and  C<remove> will be ignored.
+
+=back
+
+=item C<cc>
+
+C<hash> The users on the cc list. To modify this field, pass a hash, which
+may have the following fields:
+
+=over
+
+=item C<add> Array of C<string>s. User names to add to the CC list.
+They must be full user names, and an error will be thrown if you pass
+in an invalid user name.
+
+=item C<remove> Array of C<string>s. User names to remove from the CC
+list. They must be full user names, and an error will be thrown if you
+pass in an invalid user name.
+
+=back
+
+=item C<is_cc_accessible>
+
+C<boolean> Whether or not users in the CC list are allowed to access
+the bug, even if they aren't in a group that can normally access the bug.
+
+=item C<comment>
+
+C<hash>. A comment on the change. The hash may contain the following fields:
+
+=over
+
+=item C<body> C<string> The actual text of the comment.
+B<Note>: For compatibility with the parameters to L</add_comment>,
+you can also call this field C<comment>, if you want.
+
+=item C<is_private> C<boolean> Whether the comment is private or not.
+If you try to make a comment private and you don't have the permission
+to, an error will be thrown.
+
+=back
+
+=item C<comment_is_private>
+
+C<hash> This is how you update the privacy of comments that are already
+on a bug. This is a hash, where the keys are the C<int> id of comments (not
+their count on a bug, like #1, #2, #3, but their globally-unique id,
+as returned by L</comments>) and the value is a C<boolean> which specifies
+whether that comment should become private (C<true>) or public (C<false>).
+
+The comment ids must be valid for the bug being updated. Thus, it is not
+practical to use this while updating multiple bugs at once, as a single
+comment id will never be valid on multiple bugs.
+
+=item C<component>
+
+C<string> The Component the bug is in.
+
+=item C<deadline>
+
+C<string> The Deadline field--a date specifying when the bug must
+be completed by, in the format C<YYYY-MM-DD>.
+
+=item C<dupe_of>
+
+C<int> The bug that this bug is a duplicate of. If you want to mark
+a bug as a duplicate, the safest thing to do is to set this value
+and I<not> set the C<status> or C<resolution> fields. They will
+automatically be set by Bugzilla to the appropriate values for
+duplicate bugs.
+
+=item C<estimated_time>
+
+C<double> The total estimate of time required to fix the bug, in hours.
+This is the I<total> estimate, not the amount of time remaining to fix it.
+
+=item C<groups>
+
+C<hash> The groups a bug is in. To modify this field, pass a hash, which
+may have the following fields:
+
+=over
+
+=item C<add> Array of C<string>s. The names of groups to add. Passing
+in an invalid group name or a group that you cannot add to this bug will
+cause an error to be thrown.
+
+=item C<remove> Array of C<string>s. The names of groups to remove. Passing
+in an invalid group name or a group that you cannot remove from this bug
+will cause an error to be thrown.
+
+=back
+
+=item C<keywords>
+
+C<hash> Keywords on the bug. To modify this field, pass a hash, which
+may have the following fields:
+
+=over
+
+=item C<add> An array of C<strings>s. The names of keywords to add to
+the field on the bug. Passing something that isn't a valid keyword name
+will cause an error to be thrown. 
+
+=item C<remove> An array of C<string>s. The names of keywords to remove
+from the field on the bug. Passing something that isn't a valid keyword
+name will cause an error to be thrown.
+
+=item C<set> An array of C<strings>s. An exact set of keywords to set the
+field to, on the bug. Passing something that isn't a valid keyword name
+will cause an error to be thrown. Specifying C<set> overrides C<add> and
+C<remove>.
+
+=back
+
+=item C<op_sys>
+
+C<string> The Operating System ("OS") field on the bug.
+
+=item C<platform>
+
+C<string> The Platform or "Hardware" field on the bug.
+
+=item C<priority>
+
+C<string> The Priority field on the bug.
+
+=item C<product>
+
+C<string> The name of the product that the bug is in. If you change
+this, you will probably also want to change C<target_milestone>,
+C<version>, and C<component>, since those have different legal
+values in every product. 
+
+If you cannot change the C<target_milestone> field, it will be reset to
+the default for the product, when you move a bug to a new product.
+
+You may also wish to add or remove groups, as which groups are
+valid on a bug depends on the product. Groups that are not valid
+in the new product will be automatically removed, and groups which
+are mandatory in the new product will be automaticaly added, but no
+other automatic group changes will be done.
+
+Note that users can only move a bug into a product if they would
+normally have permission to file new bugs in that product.
+
+=item C<qa_contact>
+
+C<string> The full login name of the bug's QA Contact.
+
+=item C<is_creator_accessible>
+
+C<boolean> Whether or not the bug's reporter is allowed to access
+the bug, even if he or she isn't in a group that can normally access
+the bug.
+
+=item C<remaining_time>
+
+C<double> How much work time is remaining to fix the bug, in hours.
+If you set C<work_time> but don't explicitly set C<remaining_time>,
+then the C<work_time> will be deducted from the bug's C<remaining_time>.
+
+=item C<reset_assigned_to>
+
+C<boolean> If true, the C<assigned_to> field will be reset to the
+default for the component that the bug is in. (If you have set the
+component at the same time as using this, then the component used
+will be the new component, not the old one.)
+
+=item C<reset_qa_contact>
+
+C<boolean> If true, the C<qa_contact> field will be reset  to the
+default for the component that the bug is in. (If you have set the
+component at the same time as using this, then the component used
+will be the new component, not the old one.)
+
+=item C<resolution>
+
+C<string> The current resolution. May only be set if you are closing
+a bug or if you are modifying an already-closed bug. Attempting to set
+the resolution to I<any> value (even an empty or null string) on an
+open bug will cause an error to be thrown.
+
+If you change the C<status> field to an open status, the resolution
+field will automatically be cleared, so you don't have to clear it
+manually.
+
+=item C<see_also>
+
+C<hash> The See Also field on a bug, specifying URLs to bugs in other
+bug trackers. To modify this field, pass a hash, which may have the
+following fields:
+
+=over
+
+=item C<add> An array of C<strings>s. URLs to add to the field.
+Each URL must be a valid URL to a bug-tracker, or an error will
+be thrown.
+
+=item C<remove> An array of C<string>s. URLs to remove from the field.
+Invalid URLs will be ignored.
+
+=back
+
+=item C<severity>
+
+C<string> The Severity field of a bug.
+
+=item C<status>
+
+C<string> The status you want to change the bug to. Note that if
+a bug is changing from open to closed, you should also specify
+a C<resolution>.
+
+=item C<summary>
+
+C<string> The Summary field of the bug.
+
+=item C<target_milestone>
+
+C<string> The bug's Target Milestone.
+
+=item C<url>
+
+C<string> The "URL" field of a bug.
+
+=item C<version>
+
+C<string> The bug's Version field.
+
+=item C<whiteboard>
+
+C<string> The Status Whiteboard field of a bug.
+
+=item C<work_time>
+
+C<double> The number of hours worked on this bug as part of this change.
+If you set C<work_time> but don't explicitly set C<remaining_time>,
+then the C<work_time> will be deducted from the bug's C<remaining_time>.
+
+=back
+
+You can also set the value of any custom field by passing its name as
+a parameter, and the value to set the field to. For multiple-selection
+fields, the value should be an array of strings.
+
+=item B<Returns>
+
+A C<hash> with a single field, "bugs". This points to an array of hashes
+with the following fields:
+
+=over
+
+=item C<id>
+
+C<int> The id of the bug that was updated.
+
+=item C<alias>
+
+C<string> The alias of the bug that was updated, if this bug has an alias.
+
+=item C<last_change_time>
+
+C<dateTime> The exact time that this update was done at, for this bug.
+If no update was done (that is, no fields had their values changed and
+no comment was added) then this will instead be the last time the bug
+was updated.
+
+=item C<changes>
+
+C<hash> The changes that were actually done on this bug. The keys are
+the names of the fields that were changed, and the values are a hash
+with two keys:
+
+=over
+
+=item C<added> (C<string>) The values that were added to this field,
+possibly a comma-and-space-separated list if multiple values were added.
+
+=item C<removed> (C<string>) The values that were removed from this
+field, possibly a comma-and-space-separated list if multiple values were
+removed.
+
+=back
+
+=back
+
+Here's an example of what a return value might look like:
+
+ { 
+   bugs => [
+     {
+       id    => 123,
+       alias => 'foo',
+       last_change_time => '2010-01-01T12:34:56',
+       changes => {
+         status => {
+           removed => 'NEW',
+           added   => 'ASSIGNED'
+         },
+         keywords => {
+           removed => 'bar',
+           added   => 'qux, quo, qui', 
+         }
+       },
+     }
+   ]
+ }
+
+Currently, some fields are not tracked in changes: C<comment>,
+C<comment_is_private>, and C<work_time>. This means that they will not
+show up in the return value even if they were successfully updated.
+This may change in a future version of Bugzilla.
+
+=item B<Errors>
+
+This function can throw all of the errors that L</get>, L</create>,
+and L</add_comment> can throw, plus:
+
+=over
+
+=item 50 (Empty Field)
+
+You tried to set some field to be empty, but that field cannot be empty.
+The error message will have more details.
+
+=item 52 (Input Not A Number)
+
+You tried to set a numeric field to a value that wasn't numeric.
+
+=item 54 (Number Too Large)
+
+You tried to set a numeric field to a value larger than that field can
+accept.
+
+=item 55 (Number Too Small)
+
+You tried to set a negative value in a numeric field that does not accept
+negative values.
+
+=item 56 (Bad Date/Time)
+
+You specified an invalid date or time in a date/time field (such as
+the C<deadline> field or a custom date/time field).
+
+=item 112 (See Also Invalid)
+
+You attempted to add an invalid value to the C<see_also> field.
+
+=item 115 (Permission Denied)
+
+You don't have permission to change a particular field to a particular value.
+The error message will have more detail.
+
+=item 116 (Dependency Loop)
+
+You specified a value in the C<blocks> or C<depends_on> fields that causes
+a dependency loop.
+
+=item 117 (Invalid Comment ID)
+
+You specified a comment id in C<comment_is_private> that isn't on this bug.
+
+=item 118 (Duplicate Loop)
+
+You specified a value for C<dupe_of> that causes an infinite loop of
+duplicates.
+
+=item 119 (dupe_of Required)
+
+You changed the resolution to C<DUPLICATE> but did not specify a value
+for the C<dupe_of> field.
+
+=item 120 (Group Add/Remove Denied)
+
+You tried to add or remove a group that you don't have permission to modify
+for this bug, or you tried to add a group that isn't valid in this product.
+
+=item 121 (Resolution Required)
+
+You tried to set the C<status> field to a closed status, but you didn't
+specify a resolution.
+
+=item 122 (Resolution On Open Status)
+
+This bug has an open status, but you specified a value for the C<resolution>
+field.
+
+=item 123 (Invalid Status Transition)
+
+You tried to change from one status to another, but the status workflow
+rules don't allow that change.
+
+=back
+
+=item B<History>
+
+=over
+
+=item Added in Bugzilla B<4.0>.
+
+=back
+
+=back
+
+
+=head2 update_see_also
+
+B<EXPERIMENTAL>
+
+=over
+
+=item B<Description>
+
+Adds or removes URLs for the "See Also" field on bugs. These URLs must
+point to some valid bug in some Bugzilla installation or in Launchpad.
+
+=item B<Params>
+
+=over
+
+=item C<ids>
+
+Array of C<int>s or C<string>s. The ids or aliases of bugs that you want
+to modify.
+
+=item C<add>
+
+Array of C<string>s. URLs to Bugzilla bugs. These URLs will be added to
+the See Also field. They must be valid URLs to C<show_bug.cgi> in a
+Bugzilla installation or to a bug filed at launchpad.net.
+
+If the URLs don't start with C<http://> or C<https://>, it will be assumed
+that C<http://> should be added to the beginning of the string.
+
+It is safe to specify URLs that are already in the "See Also" field on
+a bug--they will just be silently ignored.
+
+=item C<remove>
+
+Array of C<string>s. These URLs will be removed from the See Also field.
+You must specify the full URL that you want removed. However, matching
+is done case-insensitively, so you don't have to specify the URL in
+exact case, if you don't want to.
+
+If you specify a URL that is not in the See Also field of a particular bug,
+it will just be silently ignored. Invaild URLs are currently silently ignored,
+though this may change in some future version of Bugzilla.
+
+=back
+
+NOTE: If you specify the same URL in both C<add> and C<remove>, it will
+be I<added>. (That is, C<add> overrides C<remove>.)
+
+=item B<Returns>
+
+C<changes>, a hash where the keys are numeric bug ids and the contents
+are a hash with one key, C<see_also>. C<see_also> points to a hash, which
+contains two keys, C<added> and C<removed>. These are arrays of strings,
+representing the actual changes that were made to the bug.
+
+Here's a diagram of what the return value looks like for updating
+bug ids 1 and 2:
+
+ {
+   changes => {
+       1 => {
+           see_also => {
+               added   => (an array of bug URLs),
+               removed => (an array of bug URLs),
+           }
+       },
+       2 => {
+           see_also => {
+               added   => (an array of bug URLs),
+               removed => (an array of bug URLs),
+           }
+       }
+   }
+ }
+
+This return value allows you to tell what this method actually did. It is in
+this format to be compatible with the return value of a future C<Bug.update>
+method.
+
+=item B<Errors>
+
+This method can throw all of the errors that L</get> throws, plus:
+
+=over
+
+=item 109 (Bug Edit Denied)
+
+You did not have the necessary rights to edit the bug.
+
+=item 112 (Invalid Bug URL)
+
+One of the URLs you provided did not look like a valid bug URL.
+
+=item 115 (See Also Edit Denied)
+
+You did not have the necessary rights to edit the See Also field for
+this bug.
+
+=back
+
+=item B<History>
+
+=over
+
+=item Added in Bugzilla B<3.4>.
+
+=item Before Bugzilla B<3.6>, error 115 had a generic error code of 32000.
+
+=back
+
+=back
+
+
+=head2 update_tags
+
+B<UNSTABLE>
+
+=over
+
+=item B<Description>
+
+Adds or removes tags on bugs.
+
+=item B<Params>
+
+=over
+
+=item C<ids>
+
+B<Required> C<array> An array of ints and/or strings--the ids
+or aliases of bugs that you want to add or remove tags to. All the tags
+will be added or removed to all these bugs.
+
+=item C<tags>
+
+B<Required> C<hash> A hash representing tags to be added and/or removed.
+The hash has the following fields:
+
+=over
+
+=item C<add> An array of C<string>s representing tag names
+to be added to the bugs.
+
+It is safe to specify tags that are already associated with the 
+bugs--they will just be silently ignored.
+
+=item C<remove> An array of C<string>s representing tag names
+to be removed from the bugs.
+
+It is safe to specify tags that are not associated with any
+bugs--they will just be silently ignored.
+
+=back
+
+=back
+
+=item B<Returns>
+
+C<changes>, a hash containing bug IDs as keys and one single value
+name "tags" which is also a hash, with C<added> and C<removed> as keys.
+See L</update_see_also> for an example of how it looks like.
+
+=item B<Errors>
+
+This method can throw the same errors as L</get>.
+
+=item B<History>
+
+=over
+
+=item Added in Bugzilla B<4.4>.
+
+=back
+
+=back

diff --git a/Bugzilla/WebService/Bugzilla.pm b/Bugzilla/WebService/Bugzilla.pm
new file mode 100644 (file)
index 0000000..9513e41
--- /dev/null
+++ b/Bugzilla/WebService/Bugzilla.pm
@@ -0,0 +1,463 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::WebService::Bugzilla;
+
+use strict;
+use base qw(Bugzilla::WebService);
+use Bugzilla::Constants;
+use Bugzilla::Util qw(datetime_from);
+use Bugzilla::WebService::Util qw(validate filter_wants);
+use Bugzilla::Util qw(trick_taint);
+
+use DateTime;
+
+# Basic info that is needed before logins
+use constant LOGIN_EXEMPT => {
+    parameters => 1,
+    timezone => 1,
+    version => 1,
+};
+
+use constant READ_ONLY => qw(
+    extensions
+    parameters
+    timezone
+    time
+    version
+);
+
+# Logged-out users do not need to know more than that.
+use constant PARAMETERS_LOGGED_OUT => qw(
+    maintainer
+    requirelogin
+);
+
+# These parameters are guessable from the web UI when the user
+# is logged in. So it's safe to access them.
+use constant PARAMETERS_LOGGED_IN => qw(
+    allowemailchange
+    attachment_base
+    commentonchange_resolution
+    commentonduplicate
+    cookiepath
+    defaultopsys
+    defaultplatform
+    defaultpriority
+    defaultseverity
+    duplicate_or_move_bug_status
+    emailregexpdesc
+    emailsuffix
+    letsubmitterchoosemilestone
+    letsubmitterchoosepriority
+    mailfrom
+    maintainer
+    maxattachmentsize
+    maxlocalattachment
+    musthavemilestoneonaccept
+    noresolveonopenblockers
+    password_complexity
+    rememberlogin
+    requirelogin
+    search_allow_no_criteria
+    urlbase
+    use_see_also
+    useclassification
+    usemenuforusers
+    useqacontact
+    usestatuswhiteboard
+    usetargetmilestone
+);
+
+sub version {
+    my $self = shift;
+    return { version => $self->type('string', BUGZILLA_VERSION) };
+}
+
+sub extensions {
+    my $self = shift;
+
+    my %retval;
+    foreach my $extension (@{ Bugzilla->extensions }) {
+        my $version = $extension->VERSION || 0;
+        my $name    = $extension->NAME;
+        $retval{$name}->{version} = $self->type('string', $version);
+    }
+    return { extensions => \%retval };
+}
+
+sub timezone {
+    my $self = shift;
+    # All Webservices return times in UTC; Use UTC here for backwards compat.
+    return { timezone => $self->type('string', "+0000") };
+}
+
+sub time {
+    my ($self) = @_;
+    # All Webservices return times in UTC; Use UTC here for backwards compat.
+    # Hardcode values where appropriate
+    my $dbh = Bugzilla->dbh;
+
+    my $db_time = $dbh->selectrow_array('SELECT LOCALTIMESTAMP(0)');
+    $db_time = datetime_from($db_time, 'UTC');
+    my $now_utc = DateTime->now();
+
+    return {
+        db_time       => $self->type('dateTime', $db_time),
+        web_time      => $self->type('dateTime', $now_utc),
+        web_time_utc  => $self->type('dateTime', $now_utc),
+        tz_name       => $self->type('string', 'UTC'),
+        tz_offset     => $self->type('string', '+0000'),
+        tz_short_name => $self->type('string', 'UTC'),
+    };
+}
+
+sub last_audit_time {
+    my ($self, $params) = validate(@_, 'class');
+    my $dbh = Bugzilla->dbh;
+    
+    my $sql_statement = "SELECT MAX(at_time) FROM audit_log";
+    my $class_values =  $params->{class};
+    my @class_values_quoted;
+    foreach my $class_value (@$class_values) {
+        push (@class_values_quoted, $dbh->quote($class_value)) 
+            if $class_value =~ /^Bugzilla(::[a-zA-Z0-9_]+)*$/;
+    }
+
+    if (@class_values_quoted) {
+        $sql_statement .= " WHERE " . $dbh->sql_in('class', \@class_values_quoted);
+    }
+
+    my $last_audit_time = $dbh->selectrow_array("$sql_statement");
+ 
+    # All Webservices return times in UTC; Use UTC here for backwards compat.
+    # Hardcode values where appropriate
+    $last_audit_time = datetime_from($last_audit_time, 'UTC');
+    
+    return {
+        last_audit_time => $self->type('dateTime', $last_audit_time)
+    };
+}
+
+sub parameters {
+    my ($self, $args) = @_;
+    my $user = Bugzilla->login();
+    my $params = Bugzilla->params;
+    $args ||= {};
+
+    my @params_list = $user->in_group('tweakparams')
+                      ? keys(%$params)
+                      : $user->id ? PARAMETERS_LOGGED_IN : PARAMETERS_LOGGED_OUT;
+
+    my %parameters;
+    foreach my $param (@params_list) {
+        next unless filter_wants($args, $param);
+        $parameters{$param} = $self->type('string', $params->{$param});
+    }
+
+    return { parameters => \%parameters };
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::WebService::Bugzilla - Global functions for the webservice interface.
+
+=head1 DESCRIPTION
+
+This provides functions that tell you about Bugzilla in general.
+
+=head1 METHODS
+
+See L<Bugzilla::WebService> for a description of how parameters are passed,
+and what B<STABLE>, B<UNSTABLE>, and B<EXPERIMENTAL> mean.
+
+=head2 version
+
+B<STABLE>
+
+=over
+
+=item B<Description>
+
+Returns the current version of Bugzilla.
+
+=item B<Params> (none)
+
+=item B<Returns>
+
+A hash with a single item, C<version>, that is the version as a
+string.
+
+=item B<Errors> (none)
+
+=back
+
+=head2 extensions
+
+B<EXPERIMENTAL>
+
+=over
+
+=item B<Description>
+
+Gets information about the extensions that are currently installed and enabled
+in this Bugzilla.
+
+=item B<Params> (none)
+
+=item B<Returns>
+
+A hash with a single item, C<extensions>. This points to a hash. I<That> hash
+contains the names of extensions as keys, and the values are a hash.
+That hash contains a single key C<version>, which is the version of the
+extension, or C<0> if the extension hasn't defined a version.
+
+The return value looks something like this:
+
+ extensions => {
+     Example => {
+         version => '3.6',
+     },
+     BmpConvert => {
+         version => '1.0',
+     },
+ }
+
+=item B<History>
+
+=over
+
+=item Added in Bugzilla B<3.2>.
+
+=item As of Bugzilla B<3.6>, the names of extensions are canonical names
+that the extensions define themselves. Before 3.6, the names of the
+extensions depended on the directory they were in on the Bugzilla server.
+
+=back
+
+=back
+
+=head2 timezone
+
+B<DEPRECATED> This method may be removed in a future version of Bugzilla.
+Use L</time> instead.
+
+=over
+
+=item B<Description>
+
+Returns the timezone that Bugzilla expects dates and times in.
+
+=item B<Params> (none)
+
+=item B<Returns>
+
+A hash with a single item, C<timezone>, that is the timezone offset as a
+string in (+/-)XXXX (RFC 2822) format.
+
+=item B<History>
+
+=over
+
+=item As of Bugzilla B<3.6>, the timezone returned is always C<+0000>
+(the UTC timezone).
+
+=back
+
+=back
+
+
+=head2 time
+
+B<STABLE>
+
+=over
+
+=item B<Description>
+
+Gets information about what time the Bugzilla server thinks it is, and
+what timezone it's running in.
+
+=item B<Params> (none)
+
+=item B<Returns>
+
+A struct with the following items:
+
+=over
+
+=item C<db_time>
+
+C<dateTime> The current time in UTC, according to the Bugzilla 
+I<database server>.
+
+Note that Bugzilla assumes that the database and the webserver are running
+in the same time zone. However, if the web server and the database server
+aren't synchronized for some reason, I<this> is the time that you should
+rely on for doing searches and other input to the WebService.
+
+=item C<web_time>
+
+C<dateTime> This is the current time in UTC, according to Bugzilla's 
+I<web server>.
+
+This might be different by a second from C<db_time> since this comes from
+a different source. If it's any more different than a second, then there is
+likely some problem with this Bugzilla instance. In this case you should
+rely on the C<db_time>, not the C<web_time>.
+
+=item C<web_time_utc>
+
+Identical to C<web_time>. (Exists only for backwards-compatibility with
+versions of Bugzilla before 3.6.)
+
+=item C<tz_name>
+
+C<string> The literal string C<UTC>. (Exists only for backwards-compatibility
+with versions of Bugzilla before 3.6.) 
+
+=item C<tz_short_name>
+
+C<string> The literal string C<UTC>. (Exists only for backwards-compatibility
+with versions of Bugzilla before 3.6.)
+
+=item C<tz_offset>
+
+C<string> The literal string C<+0000>. (Exists only for backwards-compatibility
+with versions of Bugzilla before 3.6.)
+
+=back
+
+=item B<History>
+
+=over
+
+=item Added in Bugzilla B<3.4>.
+
+=item As of Bugzilla B<3.6>, this method returns all data as though the server
+were in the UTC timezone, instead of returning information in the server's
+local timezone.
+
+=back
+
+=back
+
+=head2 parameters
+
+B<UNSTABLE>
+
+=over
+
+=item B<Description>
+
+Returns parameter values currently used in this Bugzilla.
+
+=item B<Params> (none)
+
+=item B<Returns>
+
+A hash with a single item C<parameters> which contains a hash with
+the name of the parameters as keys and their value as values. All
+values are returned as strings.
+The list of parameters returned by this method depends on the user
+credentials:
+
+A logged-out user can only access the C<maintainer> and C<requirelogin> parameters.
+
+A logged-in user can access the following parameters (listed alphabetically):
+    C<allowemailchange>,
+    C<attachment_base>,
+    C<commentonchange_resolution>,
+    C<commentonduplicate>,
+    C<cookiepath>,
+    C<defaultopsys>,
+    C<defaultplatform>,
+    C<defaultpriority>,
+    C<defaultseverity>,
+    C<duplicate_or_move_bug_status>,
+    C<emailregexpdesc>,
+    C<emailsuffix>,
+    C<letsubmitterchoosemilestone>,
+    C<letsubmitterchoosepriority>,
+    C<mailfrom>,
+    C<maintainer>,
+    C<maxattachmentsize>,
+    C<maxlocalattachment>,
+    C<musthavemilestoneonaccept>,
+    C<noresolveonopenblockers>,
+    C<password_complexity>,
+    C<rememberlogin>,
+    C<requirelogin>,
+    C<search_allow_no_criteria>,
+    C<urlbase>,
+    C<use_see_also>,
+    C<useclassification>,
+    C<usemenuforusers>,
+    C<useqacontact>,
+    C<usestatuswhiteboard>,
+    C<usetargetmilestone>.
+
+A user in the tweakparams group can access all existing parameters.
+New parameters can appear or obsolete parameters can disappear depending
+on the version of Bugzilla and on extensions being installed.
+The list of parameters returned by this method is not stable and will
+never be stable.
+
+=item B<History>
+
+=over
+
+=item Added in Bugzilla B<4.4>.
+
+=back
+
+=back
+
+=head2 last_audit_time
+
+B<EXPERIMENTAL>
+
+=over
+
+=item B<Description>
+
+Gets the latest time of the audit_log table.
+
+=item B<Params>
+
+You can pass the optional parameter C<class> to get the maximum for only 
+the listed classes.
+
+=over
+
+=item C<class> (array) - An array of strings representing the class names.
+
+B<Note:> The class names are defined as "Bugzilla::<class_name>". For the product
+use Bugzilla:Product.
+
+=back
+
+=item B<Returns>
+
+A hash with a single item, C<last_audit_time>, that is the maximum of the
+at_time from the audit_log.
+
+=item B<Errors> (none)
+
+=item B<History>
+
+=over
+
+=item Added in Bugzilla B<4.4>.
+
+=back
+
+=back

diff --git a/Bugzilla/WebService/Classification.pm b/Bugzilla/WebService/Classification.pm
new file mode 100644 (file)
index 0000000..753b526
--- /dev/null
+++ b/Bugzilla/WebService/Classification.pm
@@ -0,0 +1,195 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::WebService::Classification;
+
+use strict;
+
+use base qw (Bugzilla::WebService);
+
+use Bugzilla::Classification;
+use Bugzilla::Error;
+use Bugzilla::WebService::Util qw(filter validate params_to_objects);
+
+use constant READ_ONLY => qw(
+    get
+);
+
+sub get {
+    my ($self, $params) = validate(@_, 'names', 'ids');
+
+    defined $params->{names} || defined $params->{ids}
+        || ThrowCodeError('params_required', { function => 'Classification.get',
+                                               params => ['names', 'ids'] });
+
+    my $user = Bugzilla->user;
+
+    Bugzilla->params->{'useclassification'}
+      || $user->in_group('editclassifications')
+      || ThrowUserError('auth_classification_not_enabled');
+
+    Bugzilla->switch_to_shadow_db;
+
+    my @classification_objs = @{ params_to_objects($params, 'Bugzilla::Classification') };
+    unless ($user->in_group('editclassifications')) {
+        my %selectable_class = map { $_->id => 1 } @{$user->get_selectable_classifications};
+        @classification_objs = grep { $selectable_class{$_->id} } @classification_objs;
+    }
+
+    my @classifications = map { filter($params, $self->_classification_to_hash($_)) } @classification_objs;
+
+    return { classifications => \@classifications };
+}
+
+sub _classification_to_hash {
+    my ($self, $classification) = @_;
+
+    my $user = Bugzilla->user;
+    return unless (Bugzilla->params->{'useclassification'} || $user->in_group('editclassifications'));
+
+    my $products = $user->in_group('editclassifications') ?
+                     $classification->products : $user->get_selectable_products($classification->id);
+    my %hash = (
+        id          => $self->type('int',    $classification->id),
+        name        => $self->type('string', $classification->name),
+        description => $self->type('string', $classification->description),
+        sort_key    => $self->type('int',    $classification->sortkey),
+        products    => [ map { $self->_product_to_hash($_) } @$products ],
+    );
+
+    return \%hash;
+}
+
+sub _product_to_hash {
+    my ($self, $product) = @_;
+    my %hash = (
+       id          => $self->type('int', $product->id),
+       name        => $self->type('string', $product->name),
+       description => $self->type('string', $product->description),
+   );
+
+   return \%hash;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Webservice::Classification - The Classification API
+
+=head1 DESCRIPTION
+
+This part of the Bugzilla API allows you to deal with the available Classifications. 
+You will be able to get information about them as well as manipulate them.
+
+=head1 METHODS
+
+See L<Bugzilla::WebService> for a description of how parameters are passed,
+and what B<STABLE>, B<UNSTABLE>, and B<EXPERIMENTAL> mean.
+
+=head1 Classification Retrieval
+
+=head2 get
+
+B<EXPERIMENTAL>
+
+=over
+
+=item B<Description>
+
+Returns a hash containing information about a set of classifications.
+
+=item B<Params>
+
+In addition to the parameters below, this method also accepts the
+standard L<include_fields|Bugzilla::WebService/include_fields> and
+L<exclude_fields|Bugzilla::WebService/exclude_fields> arguments.
+
+You could get classifications info by supplying their names and/or ids. 
+So, this method accepts the following parameters:
+
+=over
+
+=item C<ids>
+
+An array of classification ids.
+
+=item C<names>
+
+An array of classification names.
+
+=back
+
+=item B<Returns>    
+
+A hash with the key C<classifications> and an array of hashes as the corresponding value.
+Each element of the array represents a classification that the user is authorized to see 
+and has the following keys:
+
+=over
+
+=item C<id>
+
+C<int> The id of the classification.
+
+=item C<name>
+
+C<string> The name of the classification.
+
+=item C<description>
+
+C<string> The description of the classificaion.
+
+=item C<sort_key>
+
+C<int> The value which determines the order the classification is sorted.
+
+=item C<products>
+
+An array of hashes. The array contains the products the user is authorized to
+access within the classification. Each hash has the following keys:
+
+=over
+
+=item C<name>
+
+C<string> The name of the product.
+
+=item C<id>
+
+C<int> The id of the product.
+
+=item C<description>
+
+C<string> The description of the product.
+
+=back
+
+=back
+
+=item B<Errors>
+
+=over
+
+=item 900 (Classification not enabled)
+
+Classification is not enabled on this installation.
+
+=back
+
+=item B<History>
+
+=over
+
+=item Added in Bugzilla B<4.4>.
+
+=back
+
+=back
+

diff --git a/Bugzilla/WebService/Constants.pm b/Bugzilla/WebService/Constants.pm
new file mode 100644 (file)
index 0000000..f289cae
--- /dev/null
+++ b/Bugzilla/WebService/Constants.pm
@@ -0,0 +1,206 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::WebService::Constants;
+
+use strict;
+use base qw(Exporter);
+
+our @EXPORT = qw(
+    WS_ERROR_CODE
+    ERROR_UNKNOWN_FATAL
+    ERROR_UNKNOWN_TRANSIENT
+    XMLRPC_CONTENT_TYPE_WHITELIST
+
+    WS_DISPATCH
+);
+
+# This maps the error names in global/*-error.html.tmpl to numbers.
+# Generally, transient errors should have a number above 0, and
+# fatal errors should have a number below 0.
+#
+# This hash should generally contain any error that could be thrown
+# by the WebService interface. If it's extremely unlikely that the
+# error could be thrown (like some CodeErrors), it doesn't have to
+# be listed here.
+#
+# "Transient" means "If you resubmit that request with different data,
+# it may work."
+#
+# "Fatal" means, "There's something wrong with Bugzilla, probably
+# something an administrator would have to fix."
+#
+# NOTE: Numbers must never be recycled. If you remove a number, leave a
+# comment that it was retired. Also, if an error changes its name, you'll
+# have to fix it here.
+use constant WS_ERROR_CODE => {
+    # Generic errors (Bugzilla::Object and others) are 50-99.    
+    object_not_specified        => 50,
+    reassign_to_empty           => 50,
+    param_required              => 50,
+    params_required             => 50,
+    undefined_field             => 50,
+    object_does_not_exist       => 51,
+    param_must_be_numeric       => 52,
+    number_not_numeric          => 52,
+    param_invalid               => 53,
+    number_too_large            => 54,
+    number_too_small            => 55,
+    illegal_date                => 56,
+    # Bug errors usually occupy the 100-200 range.
+    improper_bug_id_field_value => 100,
+    bug_id_does_not_exist       => 101,
+    bug_access_denied           => 102,
+    bug_access_query            => 102,
+    # These all mean "invalid alias"
+    alias_too_long           => 103,
+    alias_in_use             => 103,
+    alias_is_numeric         => 103,
+    alias_has_comma_or_space => 103,
+    multiple_alias_not_allowed => 103,
+    # Misc. bug field errors
+    illegal_field => 104,
+    freetext_too_long => 104,
+    # Component errors
+    require_component       => 105,
+    component_name_too_long => 105,
+    # Invalid Product
+    no_products         => 106,
+    entry_access_denied => 106,
+    product_access_denied => 106,
+    product_disabled    => 106,
+    # Invalid Summary
+    require_summary => 107,
+    # Invalid field name
+    invalid_field_name => 108,
+    # Not authorized to edit the bug
+    product_edit_denied => 109,
+    # Comment-related errors
+    comment_is_private => 110,
+    comment_id_invalid => 111,
+    comment_too_long => 114,
+    comment_invalid_isprivate => 117, 
+    # See Also errors
+    bug_url_invalid => 112,
+    bug_url_too_long => 112,
+    # Insidergroup Errors
+    user_not_insider => 113,
+    # Note: 114 is above in the Comment-related section.
+    # Bug update errors
+    illegal_change => 115,
+    # Dependency errors
+    dependency_loop_single => 116,
+    dependency_loop_multi  => 116,
+    # Note: 117 is above in the Comment-related section.
+    # Dup errors
+    dupe_loop_detected => 118,
+    dupe_id_required => 119,
+    # Bug-related group errors
+    group_invalid_removal => 120,
+    group_restriction_not_allowed => 120,
+    # Status/Resolution errors
+    missing_resolution => 121,
+    resolution_not_allowed => 122,
+    illegal_bug_status_transition => 123,
+
+    # Authentication errors are usually 300-400.
+    invalid_username_or_password => 300,
+    account_disabled             => 301,
+    auth_invalid_email           => 302,
+    extern_id_conflict           => -303,
+    auth_failure                 => 304,
+    password_current_too_short   => 305,
+
+    # Except, historically, AUTH_NODATA, which is 410.
+    login_required               => 410,
+
+    # User errors are 500-600.
+    account_exists        => 500,
+    illegal_email_address => 501,
+    auth_cant_create_account    => 501,
+    account_creation_disabled   => 501,
+    account_creation_restricted => 501,
+    password_too_short    => 502,
+    # Error 503 password_too_long no longer exists.
+    invalid_username      => 504,
+    # This is from strict_isolation, but it also basically means 
+    # "invalid user."
+    invalid_user_group    => 504,
+    user_access_by_id_denied    => 505,
+    user_access_by_match_denied => 505,
+
+    # Attachment errors are 600-700.
+    file_too_large         => 600,
+    invalid_content_type   => 601,
+    # Error 602 attachment_illegal_url no longer exists.
+    file_not_specified     => 603,
+    missing_attachment_description => 604,
+    # Error 605 attachment_url_disabled no longer exists.
+    zero_length_file       => 606,
+
+    # Product erros are 700-800
+    product_blank_name => 700,
+    product_name_too_long => 701,
+    product_name_already_in_use => 702,
+    product_name_diff_in_case => 702,
+    product_must_have_description => 703,
+    product_must_have_version => 704,
+    product_must_define_defaultmilestone => 705,
+
+    # Group errors are 800-900
+    empty_group_name => 800,
+    group_exists => 801,
+    empty_group_description => 802,
+    invalid_regexp => 803,
+    invalid_group_name => 804,
+
+    # Classification errors are 900-1000
+    auth_classification_not_enabled => 900,
+
+    # Search errors are 1000-1100
+    buglist_parameters_required => 1000,
+
+    # Errors thrown by the WebService itself. The ones that are negative 
+    # conform to http://xmlrpc-epi.sourceforge.net/specs/rfc.fault_codes.php
+    xmlrpc_invalid_value => -32600,
+    unknown_method       => -32601,
+    json_rpc_post_only   => 32610,
+    json_rpc_invalid_callback => 32611,
+    xmlrpc_illegal_content_type   => 32612, 
+    json_rpc_illegal_content_type => 32613, 
+};
+
+# These are the fallback defaults for errors not in ERROR_CODE.
+use constant ERROR_UNKNOWN_FATAL     => -32000;
+use constant ERROR_UNKNOWN_TRANSIENT => 32000;
+
+use constant ERROR_GENERAL       => 999;
+
+use constant XMLRPC_CONTENT_TYPE_WHITELIST => qw(
+    text/xml
+    application/xml
+);
+
+sub WS_DISPATCH {
+    # We "require" here instead of "use" above to avoid a dependency loop.
+    require Bugzilla::Hook;
+    my %hook_dispatch;
+    Bugzilla::Hook::process('webservice', { dispatch => \%hook_dispatch });
+
+    my $dispatch = {
+        'Bugzilla'       => 'Bugzilla::WebService::Bugzilla',
+        'Bug'            => 'Bugzilla::WebService::Bug',
+        'Classification' => 'Bugzilla::WebService::Classification',
+        'Group'          => 'Bugzilla::WebService::Group',
+        'Product'        => 'Bugzilla::WebService::Product',
+        'User'           => 'Bugzilla::WebService::User',
+        %hook_dispatch
+    };
+    return $dispatch;
+};
+
+1;

diff --git a/Bugzilla/WebService/Group.pm b/Bugzilla/WebService/Group.pm
new file mode 100644 (file)
index 0000000..d7506aa
--- /dev/null
+++ b/Bugzilla/WebService/Group.pm
@@ -0,0 +1,281 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::WebService::Group;
+
+use strict;
+use base qw(Bugzilla::WebService);
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::WebService::Util qw(validate translate params_to_objects);
+
+use constant MAPPED_RETURNS => {
+    userregexp => 'user_regexp',
+    isactive => 'is_active'
+};
+
+sub create {
+    my ($self, $params) = @_;
+
+    Bugzilla->login(LOGIN_REQUIRED);
+    Bugzilla->user->in_group('creategroups') 
+        || ThrowUserError("auth_failure", { group  => "creategroups",
+                                            action => "add",
+                                            object => "group"});
+    # Create group
+    my $group = Bugzilla::Group->create({
+        name               => $params->{name},
+        description        => $params->{description},
+        userregexp         => $params->{user_regexp},
+        isactive           => $params->{is_active},
+        isbuggroup         => 1,
+        icon_url           => $params->{icon_url}
+    });
+    return { id => $self->type('int', $group->id) };
+}
+
+sub update {
+    my ($self, $params) = @_;
+
+    my $dbh = Bugzilla->dbh;
+
+    Bugzilla->login(LOGIN_REQUIRED);
+    Bugzilla->user->in_group('creategroups')
+        || ThrowUserError("auth_failure", { group  => "creategroups",
+                                            action => "edit",
+                                            object => "group" });
+
+    defined($params->{names}) || defined($params->{ids})
+        || ThrowCodeError('params_required',
+               { function => 'Group.update', params => ['ids', 'names'] });
+
+    my $group_objects = params_to_objects($params, 'Bugzilla::Group');
+
+    my %values = %$params;
+    
+    # We delete names and ids to keep only new values to set.
+    delete $values{names};
+    delete $values{ids};
+
+    $dbh->bz_start_transaction();
+    foreach my $group (@$group_objects) {
+        $group->set_all(\%values);
+    }
+
+    my %changes;
+    foreach my $group (@$group_objects) {
+        my $returned_changes = $group->update();
+        $changes{$group->id} = translate($returned_changes, MAPPED_RETURNS);
+    }
+    $dbh->bz_commit_transaction();
+
+    my @result;
+    foreach my $group (@$group_objects) {
+        my %hash = (
+            id      => $group->id,
+            changes => {},
+        );
+        foreach my $field (keys %{ $changes{$group->id} }) {
+            my $change = $changes{$group->id}->{$field};
+            $hash{changes}{$field} = {
+                removed => $self->type('string', $change->[0]),
+                added   => $self->type('string', $change->[1]) 
+            };
+        }
+       push(@result, \%hash);
+    }
+
+    return { groups => \@result };
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Webservice::Group - The API for creating, changing, and getting
+information about Groups.
+
+=head1 DESCRIPTION
+
+This part of the Bugzilla API allows you to create Groups and
+get information about them.
+
+=head1 METHODS
+
+See L<Bugzilla::WebService> for a description of how parameters are passed,
+and what B<STABLE>, B<UNSTABLE>, and B<EXPERIMENTAL> mean.
+
+=head1 Group Creation and Modification
+
+=head2 create
+
+B<UNSTABLE>
+
+=over
+
+=item B<Description>
+
+This allows you to create a new group in Bugzilla.
+
+=item B<Params> 
+
+Some params must be set, or an error will be thrown. These params are 
+marked B<Required>.
+
+=over
+
+=item C<name>
+
+B<Required> C<string> A short name for this group. Must be unique. This
+is not usually displayed in the user interface, except in a few places.
+
+=item C<description>
+
+B<Required> C<string> A human-readable name for this group. Should be
+relatively short. This is what will normally appear in the UI as the
+name of the group.
+
+=item C<user_regexp>
+
+C<string> A regular expression. Any user whose Bugzilla username matches
+this regular expression will automatically be granted membership in this group.
+
+=item C<is_active> 
+
+C<boolean> C<True> if new group can be used for bugs, C<False> if this
+is a group that will only contain users and no bugs will be restricted
+to it.
+
+=item C<icon_url>
+
+C<string> A URL pointing to a small icon used to identify the group.
+This icon will show up next to users' names in various parts of Bugzilla
+if they are in this group.
+
+=back
+
+=item B<Returns>    
+
+A hash with one element, C<id>. This is the id of the newly-created group.
+
+=item B<Errors>
+
+=over
+
+=item 800 (Empty Group Name)
+
+You must specify a value for the C<name> field.
+
+=item 801 (Group Exists)
+
+There is already another group with the same C<name>.
+
+=item 802 (Group Missing Description)
+
+You must specify a value for the C<description> field.
+
+=item 803 (Group Regexp Invalid)
+
+You specified an invalid regular expression in the C<user_regexp> field.
+
+=back
+
+=back 
+
+=head2 update
+
+B<UNSTABLE>
+
+=over
+
+=item B<Description>
+
+This allows you to update a group in Bugzilla.
+
+=item B<Params>
+
+At least C<ids> or C<names> must be set, or an error will be thrown.
+
+=over
+
+=item C<ids>
+
+B<Required> C<array> Contain ids of groups to update.
+
+=item C<names>
+
+B<Required> C<array> Contain names of groups to update.
+
+=item C<name>
+
+C<string> A new name for group.
+
+=item C<description>
+
+C<string> A new description for groups. This is what will appear in the UI
+as the name of the groups.
+
+=item C<user_regexp>
+
+C<string> A new regular expression for email. Will automatically grant
+membership to these groups to anyone with an email address that matches
+this perl regular expression.
+
+=item C<is_active>
+
+C<boolean> Set if groups are active and eligible to be used for bugs.
+True if bugs can be restricted to this group, false otherwise.
+
+=item C<icon_url>
+
+C<string> A URL pointing to an icon that will appear next to the name of
+users who are in this group.
+
+=back
+
+=item B<Returns>
+
+A C<hash> with a single field "groups". This points to an array of hashes
+with the following fields:
+
+=over
+
+=item C<id>
+
+C<int> The id of the group that was updated.
+
+=item C<changes>
+
+C<hash> The changes that were actually done on this group. The keys are
+the names of the fields that were changed, and the values are a hash
+with two keys:
+
+=over
+
+=item C<added>
+
+C<string> The values that were added to this field,
+possibly a comma-and-space-separated list if multiple values were added.
+
+=item C<removed>
+
+C<string> The values that were removed from this field, possibly a
+comma-and-space-separated list if multiple values were removed.
+
+=back
+
+=back
+
+=item B<Errors>
+
+The same as L</create>.
+
+=back
+
+=cut

diff --git a/Bugzilla/WebService/Product.pm b/Bugzilla/WebService/Product.pm
new file mode 100644 (file)
index 0000000..b3ba094
--- /dev/null
+++ b/Bugzilla/WebService/Product.pm
@@ -0,0 +1,862 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::WebService::Product;
+
+use strict;
+use base qw(Bugzilla::WebService);
+use Bugzilla::Product;
+use Bugzilla::User;
+use Bugzilla::Error;
+use Bugzilla::Constants;
+use Bugzilla::WebService::Constants;
+use Bugzilla::WebService::Util qw(validate filter filter_wants translate params_to_objects);
+
+use constant READ_ONLY => qw(
+    get
+    get_accessible_products
+    get_enterable_products
+    get_selectable_products
+);
+
+use constant MAPPED_FIELDS => {
+    has_unconfirmed => 'allows_unconfirmed',
+    is_open => 'is_active',
+};
+
+use constant MAPPED_RETURNS => {
+    allows_unconfirmed => 'has_unconfirmed',
+    defaultmilestone => 'default_milestone',
+    isactive => 'is_open',
+};
+
+use constant FIELD_MAP => {
+    has_unconfirmed => 'allows_unconfirmed',
+    is_open         => 'isactive',
+};
+
+##################################################
+# Add aliases here for method name compatibility #
+##################################################
+
+BEGIN { *get_products = \&get }
+
+# Get the ids of the products the user can search
+sub get_selectable_products {
+    Bugzilla->switch_to_shadow_db();
+    return {ids => [map {$_->id} @{Bugzilla->user->get_selectable_products}]}; 
+}
+
+# Get the ids of the products the user can enter bugs against
+sub get_enterable_products {
+    Bugzilla->switch_to_shadow_db();
+    return {ids => [map {$_->id} @{Bugzilla->user->get_enterable_products}]}; 
+}
+
+# Get the union of the products the user can search and enter bugs against.
+sub get_accessible_products {
+    Bugzilla->switch_to_shadow_db();
+    return {ids => [map {$_->id} @{Bugzilla->user->get_accessible_products}]}; 
+}
+
+# Get a list of actual products, based on list of ids or names
+sub get {
+    my ($self, $params) = validate(@_, 'ids', 'names');
+
+    defined $params->{ids} || defined $params->{names}
+        || ThrowCodeError("params_required", { function => "Product.get",
+                                               params => ['ids', 'names'] });
+    Bugzilla->switch_to_shadow_db();
+
+    # Only products that are in the users accessible products, 
+    # can be allowed to be returned
+    my $accessible_products = Bugzilla->user->get_accessible_products;
+
+    my @requested_accessible;
+
+    if (defined $params->{ids}) {
+        # Create a hash with the ids the user wants
+        my %ids = map { $_ => 1 } @{$params->{ids}};
+        
+        # Return the intersection of this, by grepping the ids from 
+        # accessible products.
+        push(@requested_accessible,
+            grep { $ids{$_->id} } @$accessible_products);
+    }
+
+    if (defined $params->{names}) {
+        # Create a hash with the names the user wants
+        my %names = map { lc($_) => 1 } @{$params->{names}};
+        
+        # Return the intersection of this, by grepping the names from 
+        # accessible products, union'ed with products found by ID to
+        # avoid duplicates
+        foreach my $product (grep { $names{lc $_->name} }
+                                  @$accessible_products) {
+            next if grep { $_->id == $product->id }
+                         @requested_accessible;
+            push @requested_accessible, $product;
+        }
+    }
+
+    # Now create a result entry for each.
+    my @products = map { $self->_product_to_hash($params, $_) }
+                       @requested_accessible;
+    return { products => \@products };
+}
+
+sub create {
+    my ($self, $params) = @_;
+
+    Bugzilla->login(LOGIN_REQUIRED);
+    Bugzilla->user->in_group('editcomponents') 
+        || ThrowUserError("auth_failure", { group  => "editcomponents",
+                                            action => "add",
+                                            object => "products"});
+    # Create product
+    my $args = {
+        name             => $params->{name},
+        description      => $params->{description},
+        version          => $params->{version},
+        defaultmilestone => $params->{default_milestone},
+        # create_series has no default value.
+        create_series    => defined $params->{create_series} ?
+                              $params->{create_series} : 1
+    };
+    foreach my $field (qw(has_unconfirmed is_open classification)) {
+        if (defined $params->{$field}) {
+            my $name = FIELD_MAP->{$field} || $field;
+            $args->{$name} = $params->{$field};
+        }
+    }
+    my $product = Bugzilla::Product->create($args);
+    return { id => $self->type('int', $product->id) };
+}
+
+sub update {
+    my ($self, $params) = @_;
+
+    my $dbh = Bugzilla->dbh;
+
+    Bugzilla->login(LOGIN_REQUIRED);
+    Bugzilla->user->in_group('editcomponents')
+        || ThrowUserError("auth_failure", { group  => "editcomponents",
+                                            action => "edit",
+                                            object => "products" });
+
+    defined($params->{names}) || defined($params->{ids})
+        || ThrowCodeError('params_required', 
+               { function => 'Product.update', params => ['ids', 'names'] });
+
+    my $product_objects = params_to_objects($params, 'Bugzilla::Product');
+
+    my $values = translate($params, MAPPED_FIELDS);
+
+    # We delete names and ids to keep only new values to set.
+    delete $values->{names};
+    delete $values->{ids};
+
+    $dbh->bz_start_transaction();
+    foreach my $product (@$product_objects) {
+        $product->set_all($values);
+    }
+
+    my %changes;
+    foreach my $product (@$product_objects) {
+        my $returned_changes = $product->update();
+        $changes{$product->id} = translate($returned_changes, MAPPED_RETURNS);    
+    }
+    $dbh->bz_commit_transaction();
+            
+    my @result;
+    foreach my $product (@$product_objects) {
+        my %hash = (
+            id      => $product->id,
+            changes => {},
+        );
+
+        foreach my $field (keys %{ $changes{$product->id} }) {
+            my $change = $changes{$product->id}->{$field};
+            $hash{changes}{$field} = {
+                removed => $self->type('string', $change->[0]),
+                added   => $self->type('string', $change->[1]) 
+            };
+        }
+
+        push(@result, \%hash);
+    }
+
+    return { products => \@result };
+}
+
+sub _product_to_hash {
+    my ($self, $params, $product) = @_;
+
+    my $field_data = {
+        id          => $self->type('int', $product->id),
+        name        => $self->type('string', $product->name),
+        description => $self->type('string', $product->description),
+        is_active   => $self->type('boolean', $product->is_active),
+        default_milestone => $self->type('string', $product->default_milestone),
+        has_unconfirmed   => $self->type('boolean', $product->allows_unconfirmed),
+        classification => $self->type('string', $product->classification->name),
+    };
+    if (filter_wants($params, 'components')) {
+        $field_data->{components} = [map {
+            $self->_component_to_hash($_, $params)
+        } @{$product->components}];
+    }
+    if (filter_wants($params, 'versions')) {
+        $field_data->{versions} = [map {
+            $self->_version_to_hash($_, $params)
+        } @{$product->versions}];
+    }
+    if (filter_wants($params, 'milestones')) {
+        $field_data->{milestones} = [map {
+            $self->_milestone_to_hash($_, $params)
+        } @{$product->milestones}];
+    }
+    return filter($params, $field_data);
+}
+
+sub _component_to_hash {
+    my ($self, $component, $params) = @_;
+    my $field_data = {
+        id =>
+            $self->type('int', $component->id),
+        name =>
+            $self->type('string', $component->name),
+        description =>
+            $self->type('string' , $component->description),
+        default_assigned_to =>
+            $self->type('string' , $component->default_assignee->login),
+        default_qa_contact => 
+            $self->type('string' , $component->default_qa_contact ?
+                                   $component->default_qa_contact->login : ''),
+        sort_key =>  # sort_key is returned to match Bug.fields
+            0,
+        is_active =>
+            $self->type('boolean', $component->is_active),
+    };
+
+    if (filter_wants($params, 'flag_types', 'components')) {
+        $field_data->{flag_types} = {
+            bug =>
+                [map {
+                    $self->_flag_type_to_hash($_)
+                } @{$component->flag_types->{'bug'}}],
+            attachment =>
+                [map {
+                    $self->_flag_type_to_hash($_)
+                } @{$component->flag_types->{'attachment'}}],
+        };
+    }
+    return filter($params, $field_data, 'components');
+}
+
+sub _flag_type_to_hash {
+    my ($self, $flag_type) = @_;
+    return {
+        id =>
+            $self->type('int', $flag_type->id),
+        name =>
+            $self->type('string', $flag_type->name),
+        description =>
+            $self->type('string', $flag_type->description),
+        cc_list =>
+            $self->type('string', $flag_type->cc_list),
+        sort_key =>
+            $self->type('int', $flag_type->sortkey),
+        is_active =>
+            $self->type('boolean', $flag_type->is_active),
+        is_requestable =>
+            $self->type('boolean', $flag_type->is_requestable),
+        is_requesteeble =>
+            $self->type('boolean', $flag_type->is_requesteeble),
+        is_multiplicable =>
+            $self->type('boolean', $flag_type->is_multiplicable),
+        grant_group =>
+            $self->type('int', $flag_type->grant_group_id),
+        request_group =>
+            $self->type('int', $flag_type->request_group_id),
+    };
+}
+
+sub _version_to_hash {
+    my ($self, $version, $params) = @_;
+    my $field_data = {
+        id =>
+            $self->type('int', $version->id),
+        name =>
+            $self->type('string', $version->name),
+        sort_key =>  # sort_key is returened to match Bug.fields
+            0,
+        is_active =>
+            $self->type('boolean', $version->is_active),
+    };
+    return filter($params, $field_data, 'versions');
+}
+
+sub _milestone_to_hash {
+    my ($self, $milestone, $params) = @_;
+    my $field_data = {
+        id =>
+            $self->type('int', $milestone->id),
+        name =>
+            $self->type('string', $milestone->name),
+        sort_key =>
+            $self->type('int', $milestone->sortkey),
+        is_active =>
+            $self->type('boolean', $milestone->is_active),
+    };
+    return filter($params, $field_data, 'milestones');
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Webservice::Product - The Product API
+
+=head1 DESCRIPTION
+
+This part of the Bugzilla API allows you to list the available Products and
+get information about them.
+
+=head1 METHODS
+
+See L<Bugzilla::WebService> for a description of how parameters are passed,
+and what B<STABLE>, B<UNSTABLE>, and B<EXPERIMENTAL> mean.
+
+=head1 List Products
+
+=head2 get_selectable_products
+
+B<EXPERIMENTAL>
+
+=over
+
+=item B<Description>
+
+Returns a list of the ids of the products the user can search on.
+
+=item B<Params> (none)
+
+=item B<Returns>    
+
+A hash containing one item, C<ids>, that contains an array of product
+ids.
+
+=item B<Errors> (none)
+
+=back
+
+=head2 get_enterable_products
+
+B<EXPERIMENTAL>
+
+=over
+
+=item B<Description>
+
+Returns a list of the ids of the products the user can enter bugs
+against.
+
+=item B<Params> (none)
+
+=item B<Returns>
+
+A hash containing one item, C<ids>, that contains an array of product
+ids.
+
+=item B<Errors> (none)
+
+=back
+
+=head2 get_accessible_products
+
+B<UNSTABLE>
+
+=over
+
+=item B<Description>
+
+Returns a list of the ids of the products the user can search or enter
+bugs against.
+
+=item B<Params> (none)
+
+=item B<Returns>
+
+A hash containing one item, C<ids>, that contains an array of product
+ids.
+
+=item B<Errors> (none)
+
+=back
+
+=head2 get
+
+B<EXPERIMENTAL>
+
+=over
+
+=item B<Description>
+
+Returns a list of information about the products passed to it.
+
+B<Note>: You must at least specify one of C<ids> or C<names>.
+
+B<Note>: Can also be called as "get_products" for compatibilty with Bugzilla 3.0 API.
+
+=item B<Params>
+
+In addition to the parameters below, this method also accepts the
+standard L<include_fields|Bugzilla::WebService/include_fields> and
+L<exclude_fields|Bugzilla::WebService/exclude_fields> arguments.
+
+This RPC call supports sub field restrictions.
+
+=over
+
+=item C<ids>
+
+An array of product ids
+
+=item C<names>
+
+An array of product names
+
+=back
+
+=item B<Returns> 
+
+A hash containing one item, C<products>, that is an array of
+hashes. Each hash describes a product, and has the following items:
+
+=over
+
+=item C<id>
+
+C<int> An integer id uniquely identifying the product in this installation only.
+
+=item C<name>
+
+C<string> The name of the product.  This is a unique identifier for the
+product.
+
+=item C<description>
+
+C<string> A description of the product, which may contain HTML.
+
+=item C<is_active>
+
+C<boolean> A boolean indicating if the product is active.
+
+=item C<default_milestone>
+
+C<string> The name of the default milestone for the product.
+
+=item C<has_unconfirmed>
+
+C<boolean> Indicates whether the UNCONFIRMED bug status is available
+for this product.
+
+=item C<classification>
+
+C<string> The classification name for the product.
+
+=item C<components>
+
+C<array> An array of hashes, where each hash describes a component, and has the
+following items:
+
+=over
+
+=item C<id>
+
+C<int> An integer id uniquely identifying the component in this installation
+only.
+
+=item C<name>
+
+C<string> The name of the component.  This is a unique identifier for this
+component.
+
+=item C<description>
+
+C<string> A description of the component, which may contain HTML.
+
+=item C<default_assigned_to>
+
+C<string> The login name of the user to whom new bugs will be assigned by
+default.
+
+=item C<default_qa_contact>
+
+C<string> The login name of the user who will be set as the QA Contact for
+new bugs by default. Empty string if the QA contact is not defined.
+
+=item C<sort_key>
+
+C<int> Components, when displayed in a list, are sorted first by this integer
+and then secondly by their name.
+
+=item C<is_active>
+
+C<boolean> A boolean indicating if the component is active.  Inactive
+components are not enabled for new bugs.
+
+=item C<flag_types>
+
+A hash containing the two items C<bug> and C<attachment> that each contains an 
+array of hashes, where each hash describes a flagtype, and has the
+following items:
+
+=over
+
+=item C<id>
+
+C<int> Returns the ID of the flagtype.
+
+=item C<name>
+
+C<string> Returns the name of the flagtype.
+
+=item C<description>
+
+C<string> Returns the description of the flagtype.
+
+=item C<cc_list>
+
+C<string> Returns the concatenated CC list for the flagtype, as a single string.
+
+=item C<sort_key>
+
+C<int> Returns the sortkey of the flagtype.
+
+=item C<is_active>
+
+C<boolean> Returns whether the flagtype is active or disabled. Flags being
+in a disabled flagtype are not deleted. It only prevents you from
+adding new flags to it.
+
+=item C<is_requestable>
+
+C<boolean> Returns whether you can request for the given flagtype
+(i.e. whether the '?' flag is available or not).
+
+=item C<is_requesteeble>
+
+C<boolean> Returns whether you can ask someone specifically or not.
+
+=item C<is_multiplicable>
+
+C<boolean> Returns whether you can have more than one flag for the given
+flagtype in a given bug/attachment.
+
+=item C<grant_group>
+
+C<int> the group id that is allowed to grant/deny flags of this type.
+If the item is not included all users are allowed to grant/deny this
+flagtype.
+
+=item C<request_group>
+
+C<int> the group id that is allowed to request the flag if the flag 
+is of the type requestable. If the item is not included all users 
+are allowed request this flagtype.
+
+=back
+
+=back
+
+=item C<versions>
+
+C<array> An array of hashes, where each hash describes a version, and has the
+following items: C<name>, C<sort_key> and C<is_active>.
+
+=item C<milestones>
+
+C<array> An array of hashes, where each hash describes a milestone, and has the
+following items: C<name>, C<sort_key> and C<is_active>.
+
+=back
+
+Note, that if the user tries to access a product that is not in the
+list of accessible products for the user, or a product that does not
+exist, that is silently ignored, and no information about that product
+is returned.
+
+=item B<Errors> (none)
+
+=item B<History>
+
+=over
+
+=item In Bugzilla B<4.2>, C<names> was added as an input parameter.
+
+=item In Bugzilla B<4.2>, C<classification>, C<components>, C<versions>,
+C<milestones>, C<default_milestone> and C<has_unconfirmed> were added to
+the fields returned by C<get> as a replacement for C<internals>, which has
+been removed.
+
+=item In Bugzilla B<4.4>, C<flag_types> was added to the fields returned
+by C<get>.
+
+=back
+
+=back
+
+=head1 Product Creation and Modification
+
+=head2 create
+
+B<EXPERIMENTAL>
+
+=over
+
+=item B<Description>
+
+This allows you to create a new product in Bugzilla.
+
+=item B<Params> 
+
+Some params must be set, or an error will be thrown. These params are 
+marked B<Required>.
+
+=over
+
+=item C<name>
+
+B<Required> C<string> The name of this product. Must be globally unique
+within Bugzilla.
+
+=item C<description>
+
+B<Required> C<string> A description for this product. Allows some simple HTML.
+
+=item C<version> 
+
+B<Required> C<string> The default version for this product.
+
+=item C<has_unconfirmed> 
+
+C<boolean> Allow the UNCONFIRMED status to be set on bugs in this product.
+Default: true.
+
+=item C<classification>
+
+C<string> The name of the Classification which contains this product.
+
+=item C<default_milestone> 
+
+C<string> The default milestone for this product. Default '---'.
+
+=item C<is_open> 
+
+C<boolean> True if the product is currently allowing bugs to be entered
+into it. Default: true.
+
+=item C<create_series>
+
+C<boolean> True if you want series for New Charts to be created for this
+new product. Default: true.
+
+=back
+
+=item B<Returns>    
+
+A hash with one element, id. This is the id of the newly-filed product.
+
+=item B<Errors>
+
+=over
+
+=item 51 (Classification does not exist)
+
+You must specify an existing classification name.
+
+=item 700 (Product blank name)
+
+You must specify a non-blank name for this product.
+
+=item 701 (Product name too long)
+
+The name specified for this product was longer than the maximum
+allowed length.
+
+=item 702 (Product name already exists)
+
+You specified the name of a product that already exists.
+(Product names must be globally unique in Bugzilla.)
+
+=item 703 (Product must have description)
+
+You must specify a description for this product.
+
+=item 704 (Product must have version)
+
+You must specify a version for this product.
+
+=back
+
+=back
+
+=head2 update
+
+B<EXPERIMENTAL>
+
+=over
+
+=item B<Description>
+
+This allows you to update a product in Bugzilla.
+
+=item B<Params>
+
+B<Note:> The following parameters specify which products you are updating.
+You must set one or both of these parameters.
+
+=over
+
+=item C<ids>
+
+C<array> of C<int>s. Numeric ids of the products that you wish to update.
+
+=item C<names>
+
+C<array> or C<string>s. Names of the products that you wish to update.
+
+=back
+
+B<Note:> The following parameters specify the new values you want to set for
+the products you are updating.
+
+=over
+
+=item C<name>
+
+C<string> A new name for this product. If you try to set this while updating more
+than one product, an error will occur, as product names must be unique.
+
+=item C<default_milestone>
+
+C<string> When a new bug is filed, what milestone does it get by default if the
+user does not choose one? Must represent a milestone that is valid for this product.
+
+=item C<description>
+
+C<string> Update the long description for these products to this value.
+
+=item C<has_unconfirmed>
+
+C<boolean> Allow the UNCONFIRMED status to be set on bugs in products.
+
+=item C<is_open>
+
+C<boolean> True if the product is currently allowing bugs to be entered
+into it, False otherwise.
+
+=back
+
+=item B<Returns>
+
+A C<hash> with a single field "products". This points to an array of hashes
+with the following fields:
+
+=over
+
+=item C<id>
+
+C<int> The id of the product that was updated.
+
+=item C<changes>
+
+C<hash> The changes that were actually done on this product. The keys are
+the names of the fields that were changed, and the values are a hash
+with two keys:
+
+=over
+
+=item C<added>
+
+C<string> The value that this field was changed to.
+
+=item C<removed>
+
+C<string> The value that was previously set in this field.
+
+=back
+
+Note that booleans will be represented with the strings '1' and '0'.
+
+Here's an example of what a return value might look like:
+
+ { 
+   products => [
+     {
+       id => 123,
+       changes => {
+         name => {
+           removed => 'FooName',
+           added   => 'BarName'
+         },
+         has_unconfirmed => {
+           removed => '1',
+           added   => '0',
+         }
+       }
+     }
+   ]
+ }
+
+=item B<Errors>
+
+=over
+
+=item 700 (Product blank name)
+
+You must specify a non-blank name for this product.
+
+=item 701 (Product name too long)
+
+The name specified for this product was longer than the maximum
+allowed length.
+
+=item 702 (Product name already exists)
+
+You specified the name of a product that already exists.
+(Product names must be globally unique in Bugzilla.)
+
+=item 703 (Product must have description)
+
+You must specify a description for this product.
+
+=item 704 (Product must have version)
+
+You must specify a version for this product.
+
+=item 705 (Product must define a default milestone)
+
+You must define a default milestone.
+
+=back
+
+=back
+
+=item B<History>
+
+=over
+
+=item Added in Bugzilla B<4.4>.
+
+=back
+
+=back

diff --git a/Bugzilla/WebService/README b/Bugzilla/WebService/README
new file mode 100644 (file)
index 0000000..bbe3209
--- /dev/null
+++ b/Bugzilla/WebService/README
@@ -0,0 +1,18 @@
+The class structure of these files is a little strange, and this README
+explains it.
+
+Our goal is to make JSON::RPC and XMLRPC::Lite both work with the same code.
+(That is, we want to have one WebService API, and have two frontends for it.)
+
+The problem is that these both pass different things for $self to WebService
+methods.
+
+When XMLRPC::Lite calls a method, $self is the name of the *class* the 
+method is in. For example, if we call Bugzilla.version(), the first argument
+is Bugzilla::WebService::Bugzilla. So in order to have $self
+(our first argument) act correctly in XML-RPC, we make all WebService
+classes use base qw(Bugzilla::WebService). 
+
+When JSON::RPC calls a method, $self is the JSON-RPC *server object*. In other
+words, it's an instance of Bugzilla::WebService::Server::JSONRPC. So we have
+Bugzilla::WebService::Server::JSONRPC inherit from Bugzilla::WebService.

diff --git a/Bugzilla/WebService/Server.pm b/Bugzilla/WebService/Server.pm
new file mode 100644 (file)
index 0000000..15bc4bc
--- /dev/null
+++ b/Bugzilla/WebService/Server.pm
@@ -0,0 +1,56 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::WebService::Server;
+use strict;
+
+use Bugzilla::Error;
+use Bugzilla::Util qw(datetime_from);
+
+use Scalar::Util qw(blessed);
+
+sub handle_login {
+    my ($self, $class, $method, $full_method) = @_;
+    # Throw error if the supplied class does not exist or the method is private
+    ThrowCodeError('unknown_method', {method => $full_method}) if (!$class or $method =~ /^_/);
+
+    eval "require $class";
+    ThrowCodeError('unknown_method', {method => $full_method}) if $@;
+    return if ($class->login_exempt($method) 
+               and !defined Bugzilla->input_params->{Bugzilla_login});
+    Bugzilla->login();
+}
+
+sub datetime_format_inbound {
+    my ($self, $time) = @_;
+    
+    my $converted = datetime_from($time, Bugzilla->local_timezone);
+    if (!defined $converted) {
+        ThrowUserError('illegal_date', { date => $time });
+    }
+    $time = $converted->ymd() . ' ' . $converted->hms();
+    return $time
+}
+
+sub datetime_format_outbound {
+    my ($self, $date) = @_;
+
+    return undef if (!defined $date or $date eq '');
+
+    my $time = $date;
+    if (blessed($date)) {
+        # We expect this to mean we were sent a datetime object
+        $time->set_time_zone('UTC');
+    } else {
+        # We always send our time in UTC, for consistency.
+        # passed in value is likely a string, create a datetime object
+        $time = datetime_from($date, 'UTC');
+    }
+    return $time->iso8601();
+}
+
+1;

diff --git a/Bugzilla/WebService/Server/JSONRPC.pm b/Bugzilla/WebService/Server/JSONRPC.pm
new file mode 100644 (file)
index 0000000..804d787
--- /dev/null
+++ b/Bugzilla/WebService/Server/JSONRPC.pm
@@ -0,0 +1,568 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::WebService::Server::JSONRPC;
+
+use strict;
+use Bugzilla::WebService::Server;
+BEGIN {
+    our @ISA = qw(Bugzilla::WebService::Server);
+
+    if (eval { require JSON::RPC::Server::CGI }) {
+        unshift(@ISA, 'JSON::RPC::Server::CGI');
+    }
+    else {
+        require JSON::RPC::Legacy::Server::CGI;
+        unshift(@ISA, 'JSON::RPC::Legacy::Server::CGI');
+    }
+}
+
+use Bugzilla::Error;
+use Bugzilla::WebService::Constants;
+use Bugzilla::WebService::Util qw(taint_data);
+use Bugzilla::Util qw(correct_urlbase trim disable_utf8);
+
+use HTTP::Message;
+use MIME::Base64 qw(decode_base64 encode_base64);
+
+#####################################
+# Public JSON::RPC Method Overrides #
+#####################################
+
+sub new {
+    my $class = shift;
+    my $self = $class->SUPER::new(@_);
+    Bugzilla->_json_server($self);
+    $self->dispatch(WS_DISPATCH);
+    $self->return_die_message(1);
+    return $self;
+}
+
+sub create_json_coder {
+    my $self = shift;
+    my $json = $self->SUPER::create_json_coder(@_);
+    $json->allow_blessed(1);
+    $json->convert_blessed(1);
+    # This may seem a little backwards, but what this really means is
+    # "don't convert our utf8 into byte strings, just leave it as a
+    # utf8 string."
+    $json->utf8(0) if Bugzilla->params->{'utf8'};
+    return $json;
+}
+
+# Override the JSON::RPC method to return our CGI object instead of theirs.
+sub cgi { return Bugzilla->cgi; }
+
+sub response_header {
+    my $self = shift;
+    # The HTTP body needs to be bytes (not a utf8 string) for recent
+    # versions of HTTP::Message, but JSON::RPC::Server doesn't handle this
+    # properly. $_[1] is the HTTP body content we're going to be sending.
+    if (utf8::is_utf8($_[1])) {
+        utf8::encode($_[1]);
+        # Since we're going to just be sending raw bytes, we need to
+        # set STDOUT to not expect utf8.
+        disable_utf8();
+    }
+    return $self->SUPER::response_header(@_);
+}
+
+sub response {
+    my ($self, $response) = @_;
+
+    # Implement JSONP.
+    if (my $callback = $self->_bz_callback) {
+        my $content = $response->content;
+        $response->content("$callback($content)");
+
+    }
+
+    # Use $cgi->header properly instead of just printing text directly.
+    # This fixes various problems, including sending Bugzilla's cookies
+    # properly.
+    my $headers = $response->headers;
+    my @header_args;
+    foreach my $name ($headers->header_field_names) {
+        my @values = $headers->header($name);
+        $name =~ s/-/_/g;
+        foreach my $value (@values) {
+            push(@header_args, "-$name", $value);
+        }
+    }
+    my $cgi = $self->cgi;
+    print $cgi->header(-status => $response->code, @header_args);
+    print $response->content;
+}
+
+# The JSON-RPC 1.1 GET specification is not so great--you can't specify
+# data structures as parameters. However, the JSON-RPC 2.0 "JSON-RPC over
+# HTTP" spec is excellent, so we are using that for GET requests, instead.
+# Spec: http://groups.google.com/group/json-rpc/web/json-rpc-over-http
+#
+# The one exception is that we don't require the "params" argument to be
+# Base64 encoded, because that is ridiculous and obnoxious for JavaScript
+# clients.
+sub retrieve_json_from_get {
+    my $self = shift;
+    my $cgi = $self->cgi;
+
+    my %input;
+
+    # Both version and id must be set before any errors are thrown.
+    if ($cgi->param('version')) {
+        $self->version(scalar $cgi->param('version'));
+        $input{version} = $cgi->param('version');
+    }
+    else {
+        $self->version('1.0');
+    }
+
+    # The JSON-RPC 2.0 spec says that any request that omits an id doesn't
+    # want a response. However, in an HTTP GET situation, it's stupid to
+    # expect all clients to specify some id parameter just to get a response,
+    # so we don't require it.
+    my $id;
+    if (defined $cgi->param('id')) {
+        $id = $cgi->param('id');
+    }
+    # However, JSON::RPC does require that an id exist in most cases, in
+    # order to throw proper errors. We use the installation's urlbase as
+    # the id, in this case.
+    else {
+        $id = correct_urlbase();
+    }
+    # Setting _bz_request_id here is required in case we throw errors early,
+    # before _handle.
+    $self->{_bz_request_id} = $input{id} = $id;
+
+    # _bz_callback can throw an error, so we have to set it here, after we're
+    # ready to throw errors.
+    $self->_bz_callback(scalar $cgi->param('callback'));
+
+    if (!$cgi->param('method')) {
+        ThrowUserError('json_rpc_get_method_required');
+    }
+    $input{method} = $cgi->param('method');
+
+    my $params;
+    if (defined $cgi->param('params')) {
+        local $@;
+        $params = eval { 
+            $self->json->decode(scalar $cgi->param('params')) 
+        };
+        if ($@) {
+            ThrowUserError('json_rpc_invalid_params',
+                           { params => scalar $cgi->param('params'),
+                             err_msg  => $@ });
+        }
+    }
+    elsif (!$self->version or $self->version ne '1.1') {
+        $params = [];
+    }
+    else {
+        $params = {};
+    }
+
+    $input{params} = $params;
+
+    my $json = $self->json->encode(\%input);
+    return $json;
+}
+
+#######################################
+# Bugzilla::WebService Implementation #
+#######################################
+
+sub type {
+    my ($self, $type, $value) = @_;
+    
+    # This is the only type that does something special with undef.
+    if ($type eq 'boolean') {
+        return $value ? JSON::true : JSON::false;
+    }
+    
+    return JSON::null if !defined $value;
+
+    my $retval = $value;
+
+    if ($type eq 'int') {
+        $retval = int($value);
+    }
+    if ($type eq 'double') {
+        $retval = 0.0 + $value;
+    }
+    elsif ($type eq 'string') {
+        # Forces string context, so that JSON will make it a string.
+        $retval = "$value";
+    }
+    elsif ($type eq 'dateTime') {
+        # ISO-8601 "YYYYMMDDTHH:MM:SS" with a literal T
+        $retval = $self->datetime_format_outbound($value);
+    }
+    elsif ($type eq 'base64') {
+        utf8::encode($value) if utf8::is_utf8($value);
+        $retval = encode_base64($value, '');
+    }
+
+    return $retval;
+}
+
+sub datetime_format_outbound {
+    my $self = shift;
+    # YUI expects ISO8601 in UTC time; including TZ specifier
+    return $self->SUPER::datetime_format_outbound(@_) . 'Z';
+}
+
+sub handle_login {
+    my $self = shift;
+
+    # If we're being called using GET, we don't allow cookie-based or Env
+    # login, because GET requests can be done cross-domain, and we don't
+    # want private data showing up on another site unless the user
+    # explicitly gives that site their username and password. (This is
+    # particularly important for JSONP, which would allow a remote site
+    # to use private data without the user's knowledge, unless we had this
+    # protection in place.)
+    if ($self->request->method ne 'POST') {
+        # XXX There's no particularly good way for us to get a parameter
+        # to Bugzilla->login at this point, so we pass this information
+        # around using request_cache, which is a bit of a hack. The
+        # implementation of it is in Bugzilla::Auth::Login::Stack.
+        Bugzilla->request_cache->{auth_no_automatic_login} = 1;
+    }
+
+    my $path = $self->path_info;
+    my $class = $self->{dispatch_path}->{$path};
+    my $full_method = $self->_bz_method_name;
+    $full_method =~ /^\S+\.(\S+)/;
+    my $method = $1;
+    $self->SUPER::handle_login($class, $method, $full_method);
+}
+
+######################################
+# Private JSON::RPC Method Overrides #
+######################################
+
+# Store the ID of the current call, because Bugzilla::Error will need it.
+sub _handle {
+    my $self = shift;
+    my ($obj) = @_;
+    $self->{_bz_request_id} = $obj->{id};
+    return $self->SUPER::_handle(@_);
+}
+
+# Make all error messages returned by JSON::RPC go into the 100000
+# range, and bring down all our errors into the normal range.
+sub _error {
+    my ($self, $id, $code) = (shift, shift, shift);
+    # All JSON::RPC errors are less than 1000.
+    if ($code < 1000) {
+        $code += 100000;
+    }
+    # Bugzilla::Error adds 100,000 to all *our* errors, so
+    # we know they came from us.
+    elsif ($code > 100000) {
+        $code -= 100000;
+    }
+
+    # We can't just set $_[1] because it's not always settable,
+    # in JSON::RPC::Server.
+    unshift(@_, $id, $code);
+    my $json = $self->SUPER::_error(@_);
+
+    # We want to always send the JSON-RPC 1.1 error format, although
+    # If we're not in JSON-RPC 1.1, we don't need the silly "name" parameter.
+    if (!$self->version or $self->version ne '1.1') {
+        my $object = $self->json->decode($json);
+        my $message = $object->{error};
+        # Just assure that future versions of JSON::RPC don't change the
+        # JSON-RPC 1.0 error format.
+        if (!ref $message) {
+            $object->{error} = {
+                code    => $code,
+                message => $message,
+            };
+            $json = $self->json->encode($object);
+        }
+    }
+    return $json;
+}
+
+# This handles dispatching our calls to the appropriate class based on
+# the name of the method.
+sub _find_procedure {
+    my $self = shift;
+
+    my $method = shift;
+    $self->{_bz_method_name} = $method;
+
+    # This tricks SUPER::_find_procedure into finding the right class.
+    $method =~ /^(\S+)\.(\S+)$/;
+    $self->path_info($1);
+    unshift(@_, $2);
+
+    return $self->SUPER::_find_procedure(@_);
+}
+
+# This is a hacky way to do something right before methods are called.
+# This is the last thing that JSON::RPC::Server::_handle calls right before
+# the method is actually called.
+sub _argument_type_check {
+    my $self = shift;
+    my $params = $self->SUPER::_argument_type_check(@_);
+
+    # JSON-RPC 1.0 requires all parameters to be passed as an array, so
+    # we just pull out the first item and assume it's an object.
+    my $params_is_array;
+    if (ref $params eq 'ARRAY') {
+        $params = $params->[0];
+        $params_is_array = 1;
+    }
+
+    taint_data($params);
+
+    # Now, convert dateTime fields on input.
+    $self->_bz_method_name =~ /^(\S+)\.(\S+)$/;
+    my ($class, $method) = ($1, $2);
+    my $pkg = $self->{dispatch_path}->{$class};
+    my @date_fields = @{ $pkg->DATE_FIELDS->{$method} || [] };
+    foreach my $field (@date_fields) {
+        if (defined $params->{$field}) {
+            my $value = $params->{$field};
+            if (ref $value eq 'ARRAY') {
+                $params->{$field} = 
+                    [ map { $self->datetime_format_inbound($_) } @$value ];
+            }
+            else {
+                $params->{$field} = $self->datetime_format_inbound($value);
+            }
+        }
+    }
+    my @base64_fields = @{ $pkg->BASE64_FIELDS->{$method} || [] };
+    foreach my $field (@base64_fields) {
+        if (defined $params->{$field}) {
+            $params->{$field} = decode_base64($params->{$field});
+        }
+    }
+
+    Bugzilla->input_params($params);
+
+    if ($self->request->method eq 'POST') {
+        # CSRF is possible via XMLHttpRequest when the Content-Type header
+        # is not application/json (for example: text/plain or
+        # application/x-www-form-urlencoded).
+        # application/json is the single official MIME type, per RFC 4627.
+        my $content_type = $self->cgi->content_type;
+        # The charset can be appended to the content type, so we use a regexp.
+        if ($content_type !~ m{^application/json(-rpc)?(;.*)?$}i) {
+            ThrowUserError('json_rpc_illegal_content_type',
+                            { content_type => $content_type });
+        }
+    }
+    else {
+        # When being called using GET, we don't allow calling
+        # methods that can change data. This protects us against cross-site
+        # request forgeries.
+        if (!grep($_ eq $method, $pkg->READ_ONLY)) {
+            ThrowUserError('json_rpc_post_only', 
+                           { method => $self->_bz_method_name });
+        }
+    }
+
+    # This is the best time to do login checks.
+    $self->handle_login();
+
+    # Bugzilla::WebService packages call internal methods like
+    # $self->_some_private_method. So we have to inherit from 
+    # that class as well as this Server class.
+    my $new_class = ref($self) . '::' . $pkg;
+    my $isa_string = 'our @ISA = qw(' . ref($self) . " $pkg)";
+    eval "package $new_class;$isa_string;";
+    bless $self, $new_class;
+
+    if ($params_is_array) {
+        $params = [$params];
+    }
+
+    return $params;
+}
+
+##########################
+# Private Custom Methods #
+##########################
+
+# _bz_method_name is stored by _find_procedure for later use.
+sub _bz_method_name {
+    return $_[0]->{_bz_method_name}; 
+}
+
+sub _bz_callback {
+    my ($self, $value) = @_;
+    if (defined $value) {
+        $value = trim($value);
+        # We don't use \w because we don't want to allow Unicode here.
+        if ($value !~ /^[A-Za-z0-9_\.\[\]]+$/) {
+            ThrowUserError('json_rpc_invalid_callback', { callback => $value });
+        }
+        $self->{_bz_callback} = $value;
+        # JSONP needs to be parsed by a JS parser, not by a JSON parser.
+        $self->content_type('text/javascript');
+    }
+    return $self->{_bz_callback};
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::WebService::Server::JSONRPC - The JSON-RPC Interface to Bugzilla
+
+=head1 DESCRIPTION
+
+This documentation describes things about the Bugzilla WebService that
+are specific to JSON-RPC. For a general overview of the Bugzilla WebServices,
+see L<Bugzilla::WebService>.
+
+Please note that I<everything> about this JSON-RPC interface is
+B<EXPERIMENTAL>. If you want a fully stable API, please use the
+C<Bugzilla::WebService::Server::XMLRPC|XML-RPC> interface.
+
+=head1 JSON-RPC
+
+Bugzilla supports both JSON-RPC 1.0 and 1.1. We recommend that you use
+JSON-RPC 1.0 instead of 1.1, though, because 1.1 is deprecated.
+
+At some point in the future, Bugzilla may also support JSON-RPC 2.0.
+
+The JSON-RPC standards are described at L<http://json-rpc.org/>.
+
+=head1 CONNECTING
+
+The endpoint for the JSON-RPC interface is the C<jsonrpc.cgi> script in
+your Bugzilla installation. For example, if your Bugzilla is at
+C<bugzilla.yourdomain.com>, then your JSON-RPC client would access the
+API via: C<http://bugzilla.yourdomain.com/jsonrpc.cgi>
+
+=head2 Connecting via GET
+
+The most powerful way to access the JSON-RPC interface is by HTTP POST.
+However, for convenience, you can also access certain methods by using GET
+(a normal webpage load). Methods that modify the database or cause some
+action to happen in Bugzilla cannot be called over GET. Only methods that
+simply return data can be used over GET.
+
+For security reasons, when you connect over GET, cookie authentication
+is not accepted. If you want to authenticate using GET, you have to
+use the C<Bugzilla_login> and C<Bugzilla_password> method described at
+L<Bugzilla::WebService/LOGGING IN>.
+
+To connect over GET, simply send the values that you'd normally send for
+each JSON-RPC argument as URL parameters, with the C<params> item being
+a JSON string. 
+
+The simplest example is a call to C<Bugzilla.time>:
+
+ jsonrpc.cgi?method=Bugzilla.time
+
+Here's a call to C<User.get>, with several parameters:
+
+ jsonrpc.cgi?method=User.get&params=[ { "ids": [1,2], "names": ["user@domain.com"] } ]
+
+Although in reality you would url-encode the C<params> argument, so it would
+look more like this:
+
+ jsonrpc.cgi?method=User.get&params=%5B+%7B+%22ids%22%3A+%5B1%2C2%5D%2C+%22names%22%3A+%5B%22user%40domain.com%22%5D+%7D+%5D
+
+You can also specify C<version> as a URL parameter, if you want to specify
+what version of the JSON-RPC protocol you're using, and C<id> as a URL
+parameter if you want there to be a specific C<id> value in the returned
+JSON-RPC response.
+
+=head2 JSONP
+
+When calling the JSON-RPC WebService over GET, you can use the "JSONP"
+method of doing cross-domain requests, if you want to access the WebService
+directly on a web page from another site. JSONP is described at
+L<http://bob.pythonmac.org/archives/2005/12/05/remote-json-jsonp/>.
+
+To use JSONP with Bugzilla's JSON-RPC WebService, simply specify a
+C<callback> parameter to jsonrpc.cgi when using it via GET as described above.
+For example, here's some HTML you could use to get the data from 
+C<Bugzilla.time> on a remote website, using JSONP:
+
+ <script type="text/javascript" 
+         src="http://bugzilla.example.com/jsonrpc.cgi?method=Bugzilla.time&amp;callback=foo">
+
+That would call the C<Bugzilla.time> method and pass its value to a function
+called C<foo> as the only argument. All the other URL parameters (such as
+C<params>, for passing in arguments to methods) that can be passed to
+C<jsonrpc.cgi> during GET requests are also available, of course. The above
+is just the simplest possible example.
+
+The values returned when using JSONP are identical to the values returned
+when not using JSONP, so you will also get error messages if there is an
+error.
+
+The C<callback> URL parameter may only contain letters, numbers, periods, and
+the underscore (C<_>) character. Including any other characters will cause
+Bugzilla to throw an error. (This error will be a normal JSON-RPC response,
+not JSONP.)
+
+=head1 PARAMETERS
+
+For JSON-RPC 1.0, the very first parameter should be an object containing
+the named parameters. For example, if you were passing two named parameters,
+one called C<foo> and the other called C<bar>, the C<params> element of
+your JSON-RPC call would look like:
+
+ "params": [{ "foo": 1, "bar": "something" }]
+
+For JSON-RPC 1.1, you can pass parameters either in the above fashion
+or using the standard named-parameters mechanism of JSON-RPC 1.1.
+
+C<dateTime> fields are strings in the standard ISO-8601 format:
+C<YYYY-MM-DDTHH:MM:SSZ>, where C<T> and C<Z> are a literal T and Z,
+respectively. The "Z" means that all times are in UTC timezone--times are
+always returned in UTC, and should be passed in as UTC. (Note: The JSON-RPC
+interface currently also accepts non-UTC times for any values passed in, if
+they include a time-zone specifier that follows the ISO-8601 standard, instead
+of "Z" at the end. This behavior is expected to continue into the future, but
+to be fully safe for forward-compatibility with all future versions of
+Bugzilla, it is safest to pass in all times as UTC with the "Z" timezone
+specifier.)
+
+C<base64> fields are strings that have been base64 encoded. Note that
+although normal base64 encoding includes newlines to break up the data,
+newlines within a string are not valid JSON, so you should not insert
+newlines into your base64-encoded string.
+
+All other types are standard JSON types.
+
+=head1 ERRORS
+
+JSON-RPC 1.0 and JSON-RPC 1.1 both return an C<error> element when they
+throw an error. In Bugzilla, the error contents look like:
+
+ { message: 'Some message here', code: 123 }
+
+So, for example, in JSON-RPC 1.0, an error response would look like:
+
+ { 
+   result: null, 
+   error: { message: 'Some message here', code: 123 }, 
+   id: 1
+ }
+
+Every error has a "code", as described in L<Bugzilla::WebService/ERRORS>.
+Errors with a numeric C<code> higher than 100000 are errors thrown by
+the JSON-RPC library that Bugzilla uses, not by Bugzilla.
+
+=head1 SEE ALSO
+
+L<Bugzilla::WebService>

diff --git a/Bugzilla/WebService/Server/XMLRPC.pm b/Bugzilla/WebService/Server/XMLRPC.pm
new file mode 100644 (file)
index 0000000..e8fb5de
--- /dev/null
+++ b/Bugzilla/WebService/Server/XMLRPC.pm
@@ -0,0 +1,363 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::WebService::Server::XMLRPC;
+
+use strict;
+use XMLRPC::Transport::HTTP;
+use Bugzilla::WebService::Server;
+if ($ENV{MOD_PERL}) {
+    our @ISA = qw(XMLRPC::Transport::HTTP::Apache Bugzilla::WebService::Server);
+} else {
+    our @ISA = qw(XMLRPC::Transport::HTTP::CGI Bugzilla::WebService::Server);
+}
+
+use Bugzilla::WebService::Constants;
+
+# Allow WebService methods to call XMLRPC::Lite's type method directly
+BEGIN {
+    *Bugzilla::WebService::type = sub {
+        my ($self, $type, $value) = @_;
+        if ($type eq 'dateTime') {
+            # This is the XML-RPC implementation,  see the README in Bugzilla/WebService/.
+            # Our "base" implementation is in Bugzilla::WebService::Server.
+            $value = Bugzilla::WebService::Server->datetime_format_outbound($value);
+            $value =~ s/-//g;
+        }
+        return XMLRPC::Data->type($type)->value($value);
+    };
+}
+
+sub initialize {
+    my $self = shift;
+    my %retval = $self->SUPER::initialize(@_);
+    $retval{'serializer'}   = Bugzilla::XMLRPC::Serializer->new;
+    $retval{'deserializer'} = Bugzilla::XMLRPC::Deserializer->new;
+    $retval{'dispatch_with'} = WS_DISPATCH;
+    return %retval;
+}
+
+sub make_response {
+    my $self = shift;
+
+    $self->SUPER::make_response(@_);
+
+    # XMLRPC::Transport::HTTP::CGI doesn't know about Bugzilla carrying around
+    # its cookies in Bugzilla::CGI, so we need to copy them over.
+    foreach (@{Bugzilla->cgi->{'Bugzilla_cookie_list'}}) {
+        $self->response->headers->push_header('Set-Cookie', $_);
+    }
+}
+
+sub handle_login {
+    my ($self, $classes, $action, $uri, $method) = @_;
+    my $class = $classes->{$uri};
+    my $full_method = $uri . "." . $method;
+    $self->SUPER::handle_login($class, $method, $full_method);
+    return;
+}
+
+1;
+
+# This exists to validate input parameters (which XMLRPC::Lite doesn't do)
+# and also, in some cases, to more-usefully decode them.
+package Bugzilla::XMLRPC::Deserializer;
+use strict;
+# We can't use "use base" because XMLRPC::Serializer doesn't return
+# a true value.
+use XMLRPC::Lite;
+our @ISA = qw(XMLRPC::Deserializer);
+
+use Bugzilla::Error;
+use Bugzilla::WebService::Constants qw(XMLRPC_CONTENT_TYPE_WHITELIST);
+use Scalar::Util qw(tainted);
+
+sub deserialize {
+    my $self = shift;
+
+    # Only allow certain content types to protect against CSRF attacks
+    my $content_type = lc($ENV{'CONTENT_TYPE'});
+    # Remove charset, etc, if provided
+    $content_type =~ s/^([^;]+);.*/$1/;
+    if (!grep($_ eq $content_type, XMLRPC_CONTENT_TYPE_WHITELIST)) {
+        ThrowUserError('xmlrpc_illegal_content_type',
+                       { content_type => $ENV{'CONTENT_TYPE'} });
+    }
+
+    my ($xml) = @_;
+    my $som = $self->SUPER::deserialize(@_);
+    if (tainted($xml)) {
+        $som->{_bz_do_taint} = 1;
+    }
+    bless $som, 'Bugzilla::XMLRPC::SOM';
+    my $params = $som->paramsin;
+    # This allows positional parameters for Testopia.
+    $params = {} if ref $params ne 'HASH';
+    Bugzilla->input_params($params);
+    return $som;
+}
+
+# Some method arguments need to be converted in some way, when they are input.
+sub decode_value {
+    my $self = shift;
+    my ($type) = @{ $_[0] };
+    my $value = $self->SUPER::decode_value(@_);
+    
+    # We only validate/convert certain types here.
+    return $value if $type !~ /^(?:int|i4|boolean|double|dateTime\.iso8601)$/;
+    
+    # Though the XML-RPC standard doesn't allow an empty <int>,
+    # <double>,or <dateTime.iso8601>,  we do, and we just say
+    # "that's undef".
+    if (grep($type eq $_, qw(int double dateTime))) {
+        return undef if $value eq '';
+    }
+    
+    my $validator = $self->_validation_subs->{$type};
+    if (!$validator->($value)) {
+        ThrowUserError('xmlrpc_invalid_value',
+                       { type => $type, value => $value });
+    }
+    
+    # We convert dateTimes to a DB-friendly date format.
+    if ($type eq 'dateTime.iso8601') {
+        if ($value !~ /T.*[\-+Z]/i) {
+           # The caller did not specify a timezone, so we assume UTC.
+           # pass 'Z' specifier to datetime_from to force it
+           $value = $value . 'Z';
+        }
+        $value = Bugzilla::WebService::Server::XMLRPC->datetime_format_inbound($value);
+    }
+
+    return $value;
+}
+
+sub _validation_subs {
+    my $self = shift;
+    return $self->{_validation_subs} if $self->{_validation_subs};
+    # The only place that XMLRPC::Lite stores any sort of validation
+    # regex is in XMLRPC::Serializer. We want to re-use those regexes here.
+    my $lookup = Bugzilla::XMLRPC::Serializer->new->typelookup;
+    
+    # $lookup is a hash whose values are arrayrefs, and whose keys are the
+    # names of types. The second item of each arrayref is a subroutine
+    # that will do our validation for us.
+    my %validators = map { $_ => $lookup->{$_}->[1] } (keys %$lookup);
+    # Add a boolean validator
+    $validators{'boolean'} = sub {$_[0] =~ /^[01]$/};
+    # Some types have multiple names, or have a different name in
+    # XMLRPC::Serializer than their standard XML-RPC name.
+    $validators{'dateTime.iso8601'} = $validators{'dateTime'};
+    $validators{'i4'} = $validators{'int'};
+    
+    $self->{_validation_subs} = \%validators;
+    return \%validators;
+}
+
+1;
+
+package Bugzilla::XMLRPC::SOM;
+use strict;
+use XMLRPC::Lite;
+our @ISA = qw(XMLRPC::SOM);
+use Bugzilla::WebService::Util qw(taint_data);
+
+sub paramsin {
+    my $self = shift;
+    if (!$self->{bz_params_in}) {
+        my @params = $self->SUPER::paramsin(@_); 
+        if ($self->{_bz_do_taint}) {
+            taint_data(@params);
+        }
+        $self->{bz_params_in} = \@params;
+    }
+    my $params = $self->{bz_params_in};
+    return wantarray ? @$params : $params->[0];
+}
+
+1;
+
+# This package exists to fix a UTF-8 bug in SOAP::Lite.
+# See http://rt.cpan.org/Public/Bug/Display.html?id=32952.
+package Bugzilla::XMLRPC::Serializer;
+use Scalar::Util qw(blessed);
+use strict;
+# We can't use "use base" because XMLRPC::Serializer doesn't return
+# a true value.
+use XMLRPC::Lite;
+our @ISA = qw(XMLRPC::Serializer);
+
+sub new {
+    my $class = shift;
+    my $self = $class->SUPER::new(@_);
+    # This fixes UTF-8.
+    $self->{'_typelookup'}->{'base64'} =
+        [10, sub { !utf8::is_utf8($_[0]) && $_[0] =~ /[^\x09\x0a\x0d\x20-\x7f]/},
+        'as_base64'];
+    # This makes arrays work right even though we're a subclass.
+    # (See http://rt.cpan.org//Ticket/Display.html?id=34514)
+    $self->{'_encodingStyle'} = '';
+    return $self;
+}
+
+# Here the XMLRPC::Serializer is extended to use the XMLRPC nil extension.
+sub encode_object {
+    my $self = shift;
+    my @encoded = $self->SUPER::encode_object(@_);
+
+    return $encoded[0]->[0] eq 'nil'
+        ? ['value', {}, [@encoded]]
+        : @encoded;
+}
+
+# Removes undefined values so they do not produce invalid XMLRPC.
+sub envelope {
+    my $self = shift;
+    my ($type, $method, $data) = @_;
+    # If the type isn't a successful response we don't want to change the values.
+    if ($type eq 'response'){
+        $data = _strip_undefs($data);
+    }
+    return $self->SUPER::envelope($type, $method, $data);
+}
+
+# In an XMLRPC response we have to handle hashes of arrays, hashes, scalars,
+# Bugzilla objects (reftype = 'HASH') and XMLRPC::Data objects.
+# The whole XMLRPC::Data object must be removed if its value key is undefined
+# so it cannot be recursed like the other hash type objects.
+sub _strip_undefs {
+    my ($initial) = @_;
+    if (ref $initial eq "HASH" || (blessed $initial && $initial->isa("HASH"))) {
+        while (my ($key, $value) = each(%$initial)) {
+            if ( !defined $value
+                 || (blessed $value && $value->isa('XMLRPC::Data') && !defined $value->value) )
+            {
+                # If the value is undefined remove it from the hash.
+                delete $initial->{$key};
+            }
+            else {
+                $initial->{$key} = _strip_undefs($value);
+            }
+        }
+    }
+    if (ref $initial eq "ARRAY" || (blessed $initial && $initial->isa("ARRAY"))) {
+        for (my $count = 0; $count < scalar @{$initial}; $count++) {
+            my $value = $initial->[$count];
+            if ( !defined $value
+                 || (blessed $value && $value->isa('XMLRPC::Data') && !defined $value->value) )
+            {
+                # If the value is undefined remove it from the array.
+                splice(@$initial, $count, 1);
+                $count--;
+            }
+            else {
+                $initial->[$count] = _strip_undefs($value);
+            }
+        }
+    }
+    return $initial;
+}
+
+sub BEGIN {
+    no strict 'refs';
+    for my $type (qw(double i4 int dateTime)) {
+        my $method = 'as_' . $type;
+        *$method = sub {
+            my ($self, $value) = @_;
+            if (!defined($value)) {
+                return as_nil();
+            }
+            else {
+                my $super_method = "SUPER::$method"; 
+                return $self->$super_method($value);
+            }
+        }
+    }
+}
+
+sub as_nil {
+    return ['nil', {}];
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::WebService::Server::XMLRPC - The XML-RPC Interface to Bugzilla
+
+=head1 DESCRIPTION
+
+This documentation describes things about the Bugzilla WebService that
+are specific to XML-RPC. For a general overview of the Bugzilla WebServices,
+see L<Bugzilla::WebService>.
+
+=head1 XML-RPC
+
+The XML-RPC standard is described here: L<http://www.xmlrpc.com/spec>
+
+=head1 CONNECTING
+
+The endpoint for the XML-RPC interface is the C<xmlrpc.cgi> script in
+your Bugzilla installation. For example, if your Bugzilla is at
+C<bugzilla.yourdomain.com>, then your XML-RPC client would access the
+API via: C<http://bugzilla.yourdomain.com/xmlrpc.cgi>
+
+=head1 PARAMETERS
+
+C<dateTime> fields are the standard C<dateTime.iso8601> XML-RPC field. They
+should be in C<YYYY-MM-DDTHH:MM:SS> format (where C<T> is a literal T). As
+of Bugzilla B<3.6>, Bugzilla always expects C<dateTime> fields to be in the
+UTC timezone, and all returned C<dateTime> values are in the UTC timezone.
+
+All other fields are standard XML-RPC types.
+
+=head2 How XML-RPC WebService Methods Take Parameters
+
+All functions take a single argument, a C<< <struct> >> that contains all parameters.
+The names of the parameters listed in the API docs for each function are the
+C<< <name> >> element for the struct C<< <member> >>s.
+
+=head1 EXTENSIONS TO THE XML-RPC STANDARD
+
+=head2 Undefined Values
+
+Normally, XML-RPC does not allow empty values for C<int>, C<double>, or
+C<dateTime.iso8601> fields. Bugzilla does--it treats empty values as
+C<undef> (called C<NULL> or C<None> in some programming languages).
+
+Bugzilla accepts a timezone specifier at the end of C<dateTime.iso8601>
+fields that are specified as method arguments. The format of the timezone
+specifier is specified in the ISO-8601 standard. If no timezone specifier
+is included, the passed-in time is assumed to be in the UTC timezone.
+Bugzilla will never output a timezone specifier on returned data, because
+doing so would violate the XML-RPC specification. All returned times are in
+the UTC timezone.
+
+Bugzilla also accepts an element called C<< <nil> >>, as specified by the
+XML-RPC extension here: L<http://ontosys.com/xml-rpc/extensions.php>, which
+is always considered to be C<undef>, no matter what it contains.
+
+Bugzilla does not use C<< <nil> >> values in returned data, because currently
+most clients do not support C<< <nil> >>. Instead, any fields with C<undef>
+values will be stripped from the response completely. Therefore
+B<the client must handle the fact that some expected fields may not be 
+returned>.
+
+=begin private
+
+nil is implemented by XMLRPC::Lite, in XMLRPC::Deserializer::decode_value
+in the CPAN SVN since 14th Dec 2008
+L<http://rt.cpan.org/Public/Bug/Display.html?id=20569> and in Fedora's
+perl-SOAP-Lite package in versions 0.68-1 and above.
+
+=end private
+
+=head1 SEE ALSO
+
+L<Bugzilla::WebService>

diff --git a/Bugzilla/WebService/User.pm b/Bugzilla/WebService/User.pm
new file mode 100644 (file)
index 0000000..ba94c0e
--- /dev/null
+++ b/Bugzilla/WebService/User.pm
@@ -0,0 +1,924 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::WebService::User;
+
+use strict;
+use base qw(Bugzilla::WebService);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Group;
+use Bugzilla::User;
+use Bugzilla::Util qw(trim);
+use Bugzilla::WebService::Util qw(filter validate translate params_to_objects);
+
+# Don't need auth to login
+use constant LOGIN_EXEMPT => {
+    login => 1,
+    offer_account_by_email => 1,
+};
+
+use constant READ_ONLY => qw(
+    get
+);
+
+use constant MAPPED_FIELDS => {
+    email => 'login',
+    full_name => 'name',
+    login_denied_text => 'disabledtext',
+    email_enabled => 'disable_mail'
+};
+
+use constant MAPPED_RETURNS => {
+    login_name => 'email',
+    realname => 'full_name',
+    disabledtext => 'login_denied_text',
+    disable_mail => 'email_enabled'
+};
+
+##############
+# User Login #
+##############
+
+sub login {
+    my ($self, $params) = @_;
+    my $remember = $params->{remember};
+
+    # Username and password params are required 
+    foreach my $param ("login", "password") {
+        defined $params->{$param} 
+            || ThrowCodeError('param_required', { param => $param });
+    }
+
+    # Convert $remember from a boolean 0/1 value to a CGI-compatible one.
+    if (defined($remember)) {
+        $remember = $remember? 'on': '';
+    }
+    else {
+        # Use Bugzilla's default if $remember is not supplied.
+        $remember =
+            Bugzilla->params->{'rememberlogin'} eq 'defaulton'? 'on': '';
+    }
+
+    # Make sure the CGI user info class works if necessary.
+    my $input_params = Bugzilla->input_params;
+    $input_params->{'Bugzilla_login'} =  $params->{login};
+    $input_params->{'Bugzilla_password'} = $params->{password};
+    $input_params->{'Bugzilla_remember'} = $remember;
+
+    Bugzilla->login();
+    return { id => $self->type('int', Bugzilla->user->id) };
+}
+
+sub logout {
+    my $self = shift;
+    Bugzilla->logout;
+    return undef;
+}
+
+#################
+# User Creation #
+#################
+
+sub offer_account_by_email {
+    my $self = shift;
+    my ($params) = @_;
+    my $email = trim($params->{email})
+        || ThrowCodeError('param_required', { param => 'email' });
+
+    Bugzilla->user->check_account_creation_enabled;
+    Bugzilla->user->check_and_send_account_creation_confirmation($email);
+    return undef;
+}
+
+sub create {
+    my $self = shift;
+    my ($params) = @_;
+
+    Bugzilla->user->in_group('editusers') 
+        || ThrowUserError("auth_failure", { group  => "editusers",
+                                            action => "add",
+                                            object => "users"});
+
+    my $email = trim($params->{email})
+        || ThrowCodeError('param_required', { param => 'email' });
+    my $realname = trim($params->{full_name});
+    my $password = trim($params->{password}) || '*';
+
+    my $user = Bugzilla::User->create({
+        login_name    => $email,
+        realname      => $realname,
+        cryptpassword => $password
+    });
+
+    return { id => $self->type('int', $user->id) };
+}
+
+
+# function to return user information by passing either user ids or 
+# login names or both together:
+# $call = $rpc->call( 'User.get', { ids => [1,2,3], 
+#         names => ['testusera@redhat.com', 'testuserb@redhat.com'] });
+sub get {
+    my ($self, $params) = validate(@_, 'names', 'ids');
+
+    Bugzilla->switch_to_shadow_db();
+
+    defined($params->{names}) || defined($params->{ids})
+        || defined($params->{match})
+        || ThrowCodeError('params_required', 
+               { function => 'User.get', params => ['ids', 'names', 'match'] });
+
+    my @user_objects;
+    @user_objects = map { Bugzilla::User->check($_) } @{ $params->{names} }
+                    if $params->{names};
+
+    # start filtering to remove duplicate user ids
+    my %unique_users = map { $_->id => $_ } @user_objects;
+    @user_objects = values %unique_users;
+      
+    my @users;
+
+    # If the user is not logged in: Return an error if they passed any user ids.
+    # Otherwise, return a limited amount of information based on login names.
+    if (!Bugzilla->user->id){
+        if ($params->{ids}){
+            ThrowUserError("user_access_by_id_denied");
+        }
+        if ($params->{match}) {
+            ThrowUserError('user_access_by_match_denied');
+        }
+        my $in_group = $self->_filter_users_by_group(
+            \@user_objects, $params);
+        @users = map {filter $params, {
+                     id        => $self->type('int', $_->id),
+                     real_name => $self->type('string', $_->name), 
+                     name      => $self->type('string', $_->login),
+                 }} @$in_group;
+
+        return { users => \@users };
+    }
+
+    my $obj_by_ids;
+    $obj_by_ids = Bugzilla::User->new_from_list($params->{ids}) if $params->{ids};
+
+    # obj_by_ids are only visible to the user if he can see 
+    # the otheruser, for non visible otheruser throw an error
+    foreach my $obj (@$obj_by_ids) {
+        if (Bugzilla->user->can_see_user($obj)){
+            if (!$unique_users{$obj->id}) {
+                push (@user_objects, $obj);
+                $unique_users{$obj->id} = $obj;
+            }
+        }
+        else {
+            ThrowUserError('auth_failure', {reason => "not_visible",
+                                            action => "access",
+                                            object => "user",
+                                            userid => $obj->id});
+        }
+    }
+    
+    # User Matching
+    my $limit;
+    if ($params->{'maxusermatches'}) {
+        $limit = $params->{'maxusermatches'} + 1;
+    }
+    my $exclude_disabled = $params->{'include_disabled'} ? 0 : 1;
+    foreach my $match_string (@{ $params->{'match'} || [] }) {
+        my $matched = Bugzilla::User::match($match_string, $limit, $exclude_disabled);
+        foreach my $user (@$matched) {
+            if (!$unique_users{$user->id}) {
+                push(@user_objects, $user);
+                $unique_users{$user->id} = $user;
+            }
+        }
+    }
+   
+    my $in_group = $self->_filter_users_by_group(
+        \@user_objects, $params);
+
+    foreach my $user (@$in_group) {
+        my $user_info = {
+            id        => $self->type('int', $user->id),
+            real_name => $self->type('string', $user->name),
+            name      => $self->type('string', $user->login),
+            email     => $self->type('string', $user->email),
+            can_login => $self->type('boolean', $user->is_enabled ? 1 : 0),
+        };
+
+        if (Bugzilla->user->in_group('editusers')) {
+            $user_info->{email_enabled}     = $self->type('boolean', $user->email_enabled);
+            $user_info->{login_denied_text} = $self->type('string', $user->disabledtext);
+        }
+
+        if (Bugzilla->user->id == $user->id) {
+            $user_info->{saved_searches} = [map { $self->_query_to_hash($_) } @{ $user->queries }];
+            $user_info->{saved_reports}  = [map { $self->_report_to_hash($_) } @{ $user->reports }];
+        }
+
+        if (Bugzilla->user->id == $user->id || Bugzilla->user->in_group('editusers')) {
+            $user_info->{groups} = [map {$self->_group_to_hash($_)} @{ $user->groups }];
+        }
+        else {
+            $user_info->{groups} = $self->_filter_bless_groups($user->groups);
+        }
+
+        push(@users, filter($params, $user_info));
+    }
+
+    return { users => \@users };
+}
+
+###############
+# User Update #
+###############
+
+sub update {
+    my ($self, $params) = @_;
+
+    my $dbh = Bugzilla->dbh;
+
+    my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+    # Reject access if there is no sense in continuing.
+    $user->in_group('editusers')
+        || ThrowUserError("auth_failure", {group  => "editusers",
+                                           action => "edit",
+                                           object => "users"});
+
+    defined($params->{names}) || defined($params->{ids})
+        || ThrowCodeError('params_required', 
+               { function => 'User.update', params => ['ids', 'names'] });
+
+    my $user_objects = params_to_objects($params, 'Bugzilla::User');
+
+    my $values = translate($params, MAPPED_FIELDS);
+
+    # We delete names and ids to keep only new values to set.
+    delete $values->{names};
+    delete $values->{ids};
+
+    $dbh->bz_start_transaction();
+    foreach my $user (@$user_objects){
+        $user->set_all($values);
+    }
+
+    my %changes;
+    foreach my $user (@$user_objects){
+        my $returned_changes = $user->update();
+        $changes{$user->id} = translate($returned_changes, MAPPED_RETURNS);    
+    }
+    $dbh->bz_commit_transaction();
+
+    my @result;
+    foreach my $user (@$user_objects) {
+        my %hash = (
+            id      => $user->id,
+            changes => {},
+        );
+
+        foreach my $field (keys %{ $changes{$user->id} }) {
+            my $change = $changes{$user->id}->{$field};
+            # We normalize undef to an empty string, so that the API
+            # stays consistent for things that can become empty.
+            $change->[0] = '' if !defined $change->[0];
+            $change->[1] = '' if !defined $change->[1];
+            $hash{changes}{$field} = {
+                removed => $self->type('string', $change->[0]),
+                added   => $self->type('string', $change->[1]) 
+            };
+        }
+
+        push(@result, \%hash);
+    }
+
+    return { users => \@result };
+}
+
+sub _filter_users_by_group {
+    my ($self, $users, $params) = @_;
+    my ($group_ids, $group_names) = @$params{qw(group_ids groups)};
+
+    # If no groups are specified, we return all users.
+    return $users if (!$group_ids and !$group_names);
+
+    my $user = Bugzilla->user;
+    my (@groups, %groups);
+
+    if ($group_ids) {
+        @groups = map { Bugzilla::Group->check({ id => $_ }) } @$group_ids;
+        $groups{$_->id} = $_ foreach @groups;
+    }
+    if ($group_names) {
+        foreach my $name (@$group_names) {
+            my $group = Bugzilla::Group->check({ name => $name, _error => 'invalid_group_name' });
+            $user->in_group($group) || ThrowUserError('invalid_group_name', { name => $name });
+            $groups{$group->id} = $group;
+        }
+    }
+    @groups = values %groups;
+
+    my @in_group = grep { $self->_user_in_any_group($_, \@groups) } @$users;
+    return \@in_group;
+}
+
+sub _user_in_any_group {
+    my ($self, $user, $groups) = @_;
+    foreach my $group (@$groups) {
+        return 1 if $user->in_group($group);
+    }
+    return 0;
+}
+
+sub _filter_bless_groups {
+    my ($self, $groups) = @_;
+    my $user = Bugzilla->user;
+
+    my @filtered_groups;
+    foreach my $group (@$groups) {
+        next unless $user->can_bless($group->id);
+        push(@filtered_groups, $self->_group_to_hash($group));
+    }
+
+    return \@filtered_groups;
+}
+
+sub _group_to_hash {
+    my ($self, $group) = @_;
+    my $item = {
+        id          => $self->type('int', $group->id), 
+        name        => $self->type('string', $group->name), 
+        description => $self->type('string', $group->description), 
+    };
+    return $item;
+}
+
+sub _query_to_hash {
+    my ($self, $query) = @_;
+    my $item = {
+        id    => $self->type('int', $query->id),
+        name  => $self->type('string', $query->name),
+        query => $self->type('string', $query->url),
+    };
+    return $item;
+}
+
+sub _report_to_hash {
+    my ($self, $report) = @_;
+    my $item = {
+        id    => $self->type('int', $report->id),
+        name  => $self->type('string', $report->name),
+        query => $self->type('string', $report->query),
+    };
+    return $item;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Webservice::User - The User Account and Login API
+
+=head1 DESCRIPTION
+
+This part of the Bugzilla API allows you to create User Accounts and
+log in/out using an existing account.
+
+=head1 METHODS
+
+See L<Bugzilla::WebService> for a description of how parameters are passed,
+and what B<STABLE>, B<UNSTABLE>, and B<EXPERIMENTAL> mean.
+
+=head1 Logging In and Out
+
+=head2 login
+
+B<STABLE>
+
+=over
+
+=item B<Description>
+
+Logging in, with a username and password, is required for many
+Bugzilla installations, in order to search for bugs, post new bugs,
+etc. This method logs in an user.
+
+=item B<Params>
+
+=over
+
+=item C<login> (string) - The user's login name. 
+
+=item C<password> (string) - The user's password.
+
+=item C<remember> (bool) B<Optional> - if the cookies returned by the
+call to login should expire with the session or not.  In order for
+this option to have effect the Bugzilla server must be configured to
+allow the user to set this option - the Bugzilla parameter
+I<rememberlogin> must be set to "defaulton" or
+"defaultoff". Addionally, the client application must implement
+management of cookies across sessions.
+
+=back
+
+=item B<Returns>
+
+On success, a hash containing one item, C<id>, the numeric id of the
+user that was logged in.  A set of http cookies is also sent with the
+response.  These cookies must be sent along with any future requests
+to the webservice, for the duration of the session.
+
+=item B<Errors>
+
+=over
+
+=item 300 (Invalid Username or Password)
+
+The username does not exist, or the password is wrong.
+
+=item 301 (Login Disabled)
+
+The ability to login with this account has been disabled.  A reason may be
+specified with the error.
+
+=item 305 (New Password Required)
+
+The current password is correct, but the user is asked to change
+his password.
+
+=item 50 (Param Required)
+
+A login or password parameter was not provided.
+
+=back
+
+=back
+
+=head2 logout
+
+B<STABLE>
+
+=over
+
+=item B<Description>
+
+Log out the user. Does nothing if there is no user logged in.
+
+=item B<Params> (none)
+
+=item B<Returns> (nothing)
+
+=item B<Errors> (none)
+
+=back
+
+=head1 Account Creation and Modification
+
+=head2 offer_account_by_email
+
+B<STABLE>
+
+=over
+
+=item B<Description>
+
+Sends an email to the user, offering to create an account.  The user
+will have to click on a URL in the email, and choose their password
+and real name.
+
+This is the recommended way to create a Bugzilla account.
+
+=item B<Param>
+
+=over
+
+=item C<email> (string) - the email to send the offer to.
+
+=back
+
+=item B<Returns> (nothing)
+
+=item B<Errors>
+
+=over
+
+=item 500 (Account Already Exists)
+
+An account with that email address already exists in Bugzilla.
+
+=item 501 (Illegal Email Address)
+
+This Bugzilla does not allow you to create accounts with the format of
+email address you specified. Account creation may be entirely disabled.
+
+=back
+
+=back
+
+=head2 create
+
+B<STABLE>
+
+=over
+
+=item B<Description>
+
+Creates a user account directly in Bugzilla, password and all.
+Instead of this, you should use L</offer_account_by_email> when
+possible, because that makes sure that the email address specified can
+actually receive an email. This function does not check that.
+
+You must be logged in and have the C<editusers> privilege in order to
+call this function.
+
+=item B<Params>
+
+=over
+
+=item C<email> (string) - The email address for the new user.
+
+=item C<full_name> (string) B<Optional> - The user's full name. Will
+be set to empty if not specified.
+
+=item C<password> (string) B<Optional> - The password for the new user
+account, in plain text.  It will be stripped of leading and trailing
+whitespace.  If blank or not specified, the newly created account will
+exist in Bugzilla, but will not be allowed to log in using DB
+authentication until a password is set either by the user (through
+resetting their password) or by the administrator.
+
+=back
+
+=item B<Returns>
+
+A hash containing one item, C<id>, the numeric id of the user that was
+created.
+
+=item B<Errors>
+
+The same as L</offer_account_by_email>. If a password is specified,
+the function may also throw:
+
+=over
+
+=item 502 (Password Too Short)
+
+The password specified is too short. (Usually, this means the
+password is under three characters.)
+
+=back
+
+=item B<History>
+
+=over
+
+=item Error 503 (Password Too Long) removed in Bugzilla B<3.6>.
+
+=back
+
+=back
+
+=head2 update 
+
+B<EXPERIMENTAL>
+
+=over
+
+=item B<Description>
+
+Updates user accounts in Bugzilla.
+
+=item B<Params>
+
+=over
+
+=item C<ids>
+
+C<array> Contains ids of user to update.
+
+=item C<names>
+
+C<array> Contains email/login of user to update.
+
+=item C<full_name>
+
+C<string> The new name of the user.
+
+=item C<email>
+
+C<string> The email of the user. Note that email used to login to bugzilla.
+Also note that you can only update one user at a time when changing the 
+login name / email. (An error will be thrown if you try to update this field 
+for multiple users at once.)
+
+=item C<password>
+
+C<string> The password of the user.
+
+=item C<email_enabled>
+
+C<boolean> A boolean value to enable/disable sending bug-related mail to the user.
+
+=item C<login_denied_text>
+
+C<string> A text field that holds the reason for disabling a user from logging
+into bugzilla, if empty then the user account is enabled otherwise it is
+disabled/closed.
+
+=back
+
+=item B<Returns>
+
+A C<hash> with a single field "users". This points to an array of hashes
+with the following fields:
+
+=over
+
+=item C<id>
+
+C<int> The id of the user that was updated.
+
+=item C<changes>
+
+C<hash> The changes that were actually done on this user. The keys are
+the names of the fields that were changed, and the values are a hash
+with two keys:
+
+=over
+
+=item C<added>
+
+C<string> The values that were added to this field,
+possibly a comma-and-space-separated list if multiple values were added.
+
+=item C<removed>
+
+C<string> The values that were removed from this field, possibly a 
+comma-and-space-separated list if multiple values were removed.
+
+=back
+
+=back
+
+=item B<Errors>
+
+=over
+
+=item 51 (Bad Login Name)
+
+You passed an invalid login name in the "names" array.
+
+=item 304 (Authorization Required)
+
+Logged-in users are not authorized to edit other users.
+
+=back
+
+=back
+
+=head1 User Info
+
+=head2 get
+
+B<STABLE>
+
+=over
+
+=item B<Description>
+
+Gets information about user accounts in Bugzilla.
+
+=item B<Params>
+
+B<Note>: At least one of C<ids>, C<names>, or C<match> must be specified.
+
+B<Note>: Users will not be returned more than once, so even if a user 
+is matched by more than one argument, only one user will be returned.
+
+In addition to the parameters below, this method also accepts the
+standard L<include_fields|Bugzilla::WebService/include_fields> and
+L<exclude_fields|Bugzilla::WebService/exclude_fields> arguments.
+
+=over
+
+=item C<ids> (array) 
+
+An array of integers, representing user ids.
+
+Logged-out users cannot pass this parameter to this function. If they try,
+they will get an error. Logged-in users will get an error if they specify
+the id of a user they cannot see.
+
+=item C<names> (array)
+
+An array of login names (strings).
+
+=item C<match> (array)
+
+An array of strings. This works just like "user matching" in
+Bugzilla itself. Users will be returned whose real name or login name
+contains any one of the specified strings. Users that you cannot see will
+not be included in the returned list.
+
+Some Bugzilla installations have user-matching turned off, in which
+case you will only be returned exact matches.
+
+Most installations have a limit on how many matches are returned for
+each string, which defaults to 1000 but can be changed by the Bugzilla
+administrator.
+
+Logged-out users cannot use this argument, and an error will be thrown
+if they try. (This is to make it harder for spammers to harvest email
+addresses from Bugzilla, and also to enforce the user visibility
+restrictions that are implemented on some Bugzillas.)
+
+=item C<group_ids> (array)
+
+=item C<groups> (array)
+
+C<group_ids> is an array of numeric ids for groups that a user can be in.
+C<groups> is an array of names of groups that a user can be in.
+If these are specified, they limit the return value to users who are
+in I<any> of the groups specified.
+
+=item C<include_disabled> (boolean)
+
+By default, when using the C<match> parameter, disabled users are excluded
+from the returned results unless their full username is identical to the
+match string. Setting C<include_disabled> to C<true> will include disabled
+users in the returned results even if their username doesn't fully match
+the input string.
+
+=back
+
+=item B<Returns> 
+
+A hash containing one item, C<users>, that is an array of
+hashes. Each hash describes a user, and has the following items:
+
+=over
+
+=item id
+
+C<int> The unique integer ID that Bugzilla uses to represent this user. 
+Even if the user's login name changes, this will not change.
+
+=item real_name
+
+C<string> The actual name of the user. May be blank.
+
+=item email
+
+C<string> The email address of the user.
+
+=item name
+
+C<string> The login name of the user. Note that in some situations this is 
+different than their email.
+
+=item can_login
+
+C<boolean> A boolean value to indicate if the user can login into bugzilla. 
+
+=item email_enabled
+
+C<boolean> A boolean value to indicate if bug-related mail will be sent
+to the user or not.
+
+=item login_denied_text
+
+C<string> A text field that holds the reason for disabling a user from logging
+into bugzilla, if empty then the user account is enabled. Otherwise it is 
+disabled/closed.
+
+=item groups
+
+C<array> An array of group hashes the user is a member of. If the currently
+logged in user is querying his own account or is a member of the 'editusers'
+group, the array will contain all the groups that the user is a
+member of. Otherwise, the array will only contain groups that the logged in
+user can bless. Each hash describes the group and contains the following items:
+
+=over
+
+=item id
+
+C<int> The group id
+
+=item name
+
+C<string> The name of the group
+
+=item description
+
+C<string> The description for the group
+
+=back
+
+=item saved_searches
+
+C<array> An array of hashes, each of which represents a user's saved search and has
+the following keys:
+
+=over
+
+=item id
+
+C<int> An integer id uniquely identifying the saved search.
+
+=item name
+
+C<string> The name of the saved search.
+
+=item query
+
+C<string> The CGI parameters for the saved search.
+
+=back
+
+=item saved_reports
+
+C<array> An array of hashes, each of which represents a user's saved report and has
+the following keys:
+
+=over
+
+=item id
+
+C<int> An integer id uniquely identifying the saved report.
+
+=item name
+
+C<string> The name of the saved report.
+
+=item query
+
+C<string> The CGI parameters for the saved report.
+
+=back
+
+B<Note>: If you are not logged in to Bugzilla when you call this function, you
+will only be returned the C<id>, C<name>, and C<real_name> items. If you are
+logged in and not in editusers group, you will only be returned the C<id>, C<name>, 
+C<real_name>, C<email>, C<can_login>, and C<groups> items. The groups returned are
+filtered based on your permission to bless each group.
+The C<saved_searches> and C<saved_reports> items are only returned if you are
+querying your own account, even if you are in the editusers group.
+
+=back
+
+=item B<Errors>
+
+=over
+
+=item 51 (Bad Login Name or Group ID)
+
+You passed an invalid login name in the "names" array or a bad
+group ID in the C<group_ids> argument.
+
+=item 304 (Authorization Required)
+
+You are logged in, but you are not authorized to see one of the users you
+wanted to get information about by user id.
+
+=item 505 (User Access By Id or User-Matching Denied)
+
+Logged-out users cannot use the "ids" or "match" arguments to this 
+function.
+
+=item 804 (Invalid Group Name)
+
+You passed a group name in the C<groups> argument which either does not
+exist or you do not belong to it.
+
+=back
+
+=item B<History>
+
+=over
+
+=item Added in Bugzilla B<3.4>.
+
+=item C<group_ids> and C<groups> were added in Bugzilla B<4.0>.
+
+=item C<include_disabled> was added in Bugzilla B<4.0>. Default
+behavior for C<match> was changed to only return enabled accounts.
+
+=item Error 804 has been added in Bugzilla 4.0.9 and 4.2.4. It's now
+illegal to pass a group name you don't belong to.
+
+=item C<groups>, C<saved_searches>, and C<saved_reports> were added
+in Bugzilla B<4.4>.
+
+=back
+
+=back

diff --git a/Bugzilla/WebService/Util.pm b/Bugzilla/WebService/Util.pm
new file mode 100644 (file)
index 0000000..12606fb
--- /dev/null
+++ b/Bugzilla/WebService/Util.pm
@@ -0,0 +1,197 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::WebService::Util;
+use strict;
+use base qw(Exporter);
+
+# We have to "require", not "use" this, because otherwise it tries to
+# use features of Test::More during import().
+require Test::Taint;
+
+our @EXPORT_OK = qw(
+    filter
+    filter_wants
+    taint_data
+    validate
+    translate
+    params_to_objects
+);
+
+sub filter ($$;$) {
+    my ($params, $hash, $prefix) = @_;
+    my %newhash = %$hash;
+
+    foreach my $key (keys %$hash) {
+        delete $newhash{$key} if !filter_wants($params, $key, $prefix);
+    }
+
+    return \%newhash;
+}
+
+sub filter_wants ($$;$) {
+    my ($params, $field, $prefix) = @_;
+    my %include = map { $_ => 1 } @{ $params->{'include_fields'} || [] };
+    my %exclude = map { $_ => 1 } @{ $params->{'exclude_fields'} || [] };
+
+    $field = "${prefix}.${field}" if $prefix;
+
+    if (defined $params->{exclude_fields} && $exclude{$field}) {
+        return 0;
+    }
+    if (defined $params->{include_fields} && !$include{$field}) {
+        if ($prefix) {
+            # Include the field if the parent is include (and this one is not excluded)
+            return 0 if !$include{$prefix};
+        }
+        else {
+            # We want to include this if one of the sub keys is included
+            my $key = $field . '.';
+            my $len = length($key);
+            return 0 if ! grep { substr($_, 0, $len) eq $key  } keys %include;
+        }
+    }
+
+    return 1;
+}
+
+sub taint_data {
+    my @params = @_;
+    return if !@params;
+    # Though this is a private function, it hasn't changed since 2004 and
+    # should be safe to use, and prevents us from having to write it ourselves
+    # or require another module to do it.
+    Test::Taint::_deeply_traverse(\&_delete_bad_keys, \@params);
+    Test::Taint::taint_deeply(\@params);
+}
+
+sub _delete_bad_keys {
+    foreach my $item (@_) {
+        next if ref $item ne 'HASH';
+        foreach my $key (keys %$item) {
+            # Making something a hash key always untaints it, in Perl.
+            # However, we need to validate our argument names in some way.
+            # We know that all hash keys passed in to the WebService will 
+            # match \w+, so we delete any key that doesn't match that.
+            if ($key !~ /^\w+$/) {
+                delete $item->{$key};
+            }
+        }
+    }
+    return @_;
+}
+
+sub validate  {
+    my ($self, $params, @keys) = @_;
+
+    # If $params is defined but not a reference, then we weren't
+    # sent any parameters at all, and we're getting @keys where
+    # $params should be.
+    return ($self, undef) if (defined $params and !ref $params);
+    
+    # If @keys is not empty then we convert any named 
+    # parameters that have scalar values to arrayrefs
+    # that match.
+    foreach my $key (@keys) {
+        if (exists $params->{$key}) {
+            $params->{$key} = ref $params->{$key} 
+                              ? $params->{$key} 
+                              : [ $params->{$key} ];
+        }
+    }
+
+    return ($self, $params);
+}
+
+sub translate {
+    my ($params, $mapped) = @_;
+    my %changes;
+    while (my ($key,$value) = each (%$params)) {
+        my $new_field = $mapped->{$key} || $key;
+        $changes{$new_field} = $value;
+    }
+    return \%changes;
+}
+
+sub params_to_objects {
+    my ($params, $class) = @_;
+    my (@objects, @objects_by_ids);
+
+    @objects = map { $class->check($_) } 
+        @{ $params->{names} } if $params->{names};
+
+    @objects_by_ids = map { $class->check({ id => $_ }) } 
+        @{ $params->{ids} } if $params->{ids};
+
+    push(@objects, @objects_by_ids);
+    my %seen;
+    @objects = grep { !$seen{$_->id}++ } @objects;
+    return \@objects;
+}
+
+__END__
+
+=head1 NAME
+
+Bugzilla::WebService::Util - Utility functions used inside of the WebService
+code. These are B<not> functions that can be called via the WebService.
+
+=head1 DESCRIPTION
+
+This is somewhat like L<Bugzilla::Util>, but these functions are only used
+internally in the WebService code.
+
+=head1 SYNOPSIS
+
+ filter({ include_fields => ['id', 'name'], 
+          exclude_fields => ['name'] }, $hash);
+ my $wants = filter_wants $params, 'field_name';
+ validate(@_, 'ids');
+
+=head1 METHODS
+
+=head2 filter
+
+This helps implement the C<include_fields> and C<exclude_fields> arguments
+of WebService methods. Given a hash (the second argument to this subroutine),
+this will remove any keys that are I<not> in C<include_fields> and then remove
+any keys that I<are> in C<exclude_fields>.
+
+An optional third option can be passed that prefixes the field name to allow
+filtering of data two or more levels deep.
+
+For example, if you want to filter out the C<id> key/value in components returned
+by Product.get, you would use the value C<component.id> in your C<exclude_fields>
+list.
+
+=head2 filter_wants
+
+Returns C<1> if a filter would preserve the specified field when passing
+a hash to L</filter>, C<0> otherwise.
+
+=head2 validate
+
+This helps in the validation of parameters passed into the WebService
+methods. Currently it converts listed parameters into an array reference
+if the client only passed a single scalar value. It modifies the parameters
+hash in place so other parameters should be unaltered.
+
+=head2 translate
+
+WebService methods frequently take parameters with different names than
+the ones that we use internally in Bugzilla. This function takes a hashref
+that has field names for keys and returns a hashref with those keys renamed
+according to the mapping passed in with the second parameter (which is also
+a hashref).
+
+=head2 params_to_objects
+
+Creates objects of the type passed in as the second parameter, using the
+parameters passed to a WebService method (the first parameter to this function).
+Helps make life simpler for WebService methods that internally create objects
+via both "ids" and "names" fields. Also de-duplicates objects that were loaded
+by both "ids" and "names". Returns an arrayref of objects.

diff --git a/Bugzilla/Whine.pm b/Bugzilla/Whine.pm
new file mode 100644 (file)
index 0000000..3796198
--- /dev/null
+++ b/Bugzilla/Whine.pm
@@ -0,0 +1,119 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+package Bugzilla::Whine;
+
+use base qw(Bugzilla::Object);
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::User;
+use Bugzilla::Util;
+use Bugzilla::Whine::Schedule;
+use Bugzilla::Whine::Query;
+
+#############
+# Constants #
+#############
+
+use constant DB_TABLE => 'whine_events';
+
+use constant DB_COLUMNS => qw(
+    id
+    owner_userid
+    subject
+    body
+    mailifnobugs
+);
+
+use constant LIST_ORDER => 'id';
+
+####################
+# Simple Accessors #
+####################
+sub subject         { return $_[0]->{'subject'};      }
+sub body            { return $_[0]->{'body'};         }
+sub mail_if_no_bugs { return $_[0]->{'mailifnobugs'}; }
+
+sub user {
+    my ($self) = @_;
+    return $self->{user} if defined $self->{user};
+    $self->{user} = new Bugzilla::User($self->{'owner_userid'});
+    return $self->{user};
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Whine - A Whine event
+
+=head1 SYNOPSIS
+
+ use Bugzilla::Whine;
+
+ my $event = new Bugzilla::Whine($event_id);
+
+ my $subject      = $event->subject;
+ my $body         = $event->body;
+ my $mailifnobugs = $event->mail_if_no_bugs;
+ my $user         = $event->user;
+
+=head1 DESCRIPTION
+
+This module exists to represent a whine event that has been
+saved to the database.
+
+This is an implementation of L<Bugzilla::Object>, and so has all the
+same methods available as L<Bugzilla::Object>, in addition to what is
+documented below.
+
+=head1 METHODS
+
+=head2 Constructors
+
+=over
+
+=item C<new>
+
+Does not accept a bare C<name> argument. Instead, accepts only an id.
+
+See also: L<Bugzilla::Object/new>.
+
+=back
+
+
+=head2 Accessors
+
+These return data about the object, without modifying the object.
+
+=over
+
+=item C<subject>
+
+Returns the subject of the whine event.
+
+=item C<body>
+
+Returns the body of the whine event.
+
+=item C<mail_if_no_bugs>
+
+Returns a numeric 1(C<true>) or 0(C<false>) to represent whether this
+whine event object is supposed to be mailed even if there are no bugs
+returned by the query.
+
+=item C<user>
+
+Returns the L<Bugzilla::User> object for the owner of the L<Bugzilla::Whine>
+event.
+
+=back

diff --git a/Bugzilla/Whine/Query.pm b/Bugzilla/Whine/Query.pm
new file mode 100644 (file)
index 0000000..e52cad6
--- /dev/null
+++ b/Bugzilla/Whine/Query.pm
@@ -0,0 +1,123 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Whine::Query;
+
+use strict;
+
+use base qw(Bugzilla::Object);
+
+use Bugzilla::Constants;
+use Bugzilla::Search::Saved;
+
+#############
+# Constants #
+#############
+
+use constant DB_TABLE => 'whine_queries';
+
+use constant DB_COLUMNS => qw(
+    id
+    eventid
+    query_name
+    sortkey
+    onemailperbug
+    title
+);
+
+use constant NAME_FIELD => 'id';
+use constant LIST_ORDER => 'sortkey';
+
+####################
+# Simple Accessors #
+####################
+sub eventid           { return $_[0]->{'eventid'};       }
+sub sortkey           { return $_[0]->{'sortkey'};       }
+sub one_email_per_bug { return $_[0]->{'onemailperbug'}; }
+sub title             { return $_[0]->{'title'};         }
+sub name              { return $_[0]->{'query_name'};    }
+
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Whine::Query - A query object used by L<Bugzilla::Whine>.
+
+=head1 SYNOPSIS
+
+ use Bugzilla::Whine::Query;
+
+ my $query = new Bugzilla::Whine::Query($id);
+
+ my $event_id          = $query->eventid;
+ my $id                = $query->id;
+ my $query_name        = $query->name;
+ my $sortkey           = $query->sortkey;
+ my $one_email_per_bug = $query->one_email_per_bug;
+ my $title             = $query->title;
+
+=head1 DESCRIPTION
+
+This module exists to represent a query for a L<Bugzilla::Whine::Event>.
+Each event, which are groups of schedules and queries based on how the 
+user configured the event, may have zero or more queries associated
+with it. Additionally, the queries are selected from the user's saved
+searches, or L<Bugzilla::Search::Saved> object with a matching C<name>
+attribute for the user. 
+
+This is an implementation of L<Bugzilla::Object>, and so has all the
+same methods available as L<Bugzilla::Object>, in addition to what is
+documented below.
+
+=head1 METHODS
+
+=head2 Constructors
+
+=over
+
+=item C<new>
+
+Does not accept a bare C<name> argument. Instead, accepts only an id.
+
+See also: L<Bugzilla::Object/new>.
+
+=back
+
+
+=head2 Accessors
+
+These return data about the object, without modifying the object.
+
+=over
+
+=item C<event_id>
+
+The L<Bugzilla::Whine::Event> object id for this object.
+
+=item C<name>
+
+The L<Bugzilla::Search::Saved> query object name for this object.
+
+=item C<sortkey>
+
+The relational sorting key as compared with other L<Bugzilla::Whine::Query>
+objects.
+
+=item C<one_email_per_bug>
+
+Returns a numeric 1(C<true>) or 0(C<false>) to represent whether this
+L<Bugzilla::Whine::Query> object is supposed to be mailed as a list of
+bugs or one email per bug.
+
+=item C<title>
+
+The title of this object as it appears in the user forms and emails.
+
+=back

diff --git a/Bugzilla/Whine/Schedule.pm b/Bugzilla/Whine/Schedule.pm
new file mode 100644 (file)
index 0000000..102b5d8
--- /dev/null
+++ b/Bugzilla/Whine/Schedule.pm
@@ -0,0 +1,157 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+package Bugzilla::Whine::Schedule;
+
+use base qw(Bugzilla::Object);
+
+use Bugzilla::Constants;
+
+#############
+# Constants #
+#############
+
+use constant DB_TABLE => 'whine_schedules';
+
+use constant DB_COLUMNS => qw(
+    id
+    eventid
+    run_day
+    run_time
+    run_next
+    mailto
+    mailto_type
+);
+
+use constant UPDATE_COLUMNS => qw(
+    eventid 
+    run_day 
+    run_time 
+    run_next 
+    mailto 
+    mailto_type
+);
+use constant NAME_FIELD => 'id';
+use constant LIST_ORDER => 'id';
+
+####################
+# Simple Accessors #
+####################
+sub eventid         { return $_[0]->{'eventid'};     }
+sub run_day         { return $_[0]->{'run_day'};     }
+sub run_time        { return $_[0]->{'run_time'};    }
+sub mailto_is_group { return $_[0]->{'mailto_type'}; }
+
+sub mailto {
+    my $self = shift;
+
+    return $self->{mailto_object} if exists $self->{mailto_object};
+    my $id = $self->{'mailto'};
+
+    if ($self->mailto_is_group) {
+        $self->{mailto_object} = Bugzilla::Group->new($id);
+    } else {
+        $self->{mailto_object} = Bugzilla::User->new($id);
+    }
+    return $self->{mailto_object};
+}
+
+sub mailto_users { 
+    my $self = shift;
+    return $self->{mailto_users} if exists $self->{mailto_users};
+    my $object = $self->mailto;
+
+    if ($self->mailto_is_group) {
+        $self->{mailto_users} = $object->members_non_inherited if $object->is_active;
+    } else {
+        $self->{mailto_users} = $object;
+    }
+    return $self->{mailto_users};
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Bugzilla::Whine::Schedule - A schedule object used by L<Bugzilla::Whine>.
+
+=head1 SYNOPSIS
+
+ use Bugzilla::Whine::Schedule;
+
+ my $schedule = new Bugzilla::Whine::Schedule($schedule_id);
+
+ my $event_id    = $schedule->eventid;
+ my $run_day     = $schedule->run_day;
+ my $run_time    = $schedule->run_time;
+ my $is_group    = $schedule->mailto_is_group;
+ my $object      = $schedule->mailto;
+ my $array_ref   = $schedule->mailto_users;
+
+=head1 DESCRIPTION
+
+This module exists to represent a L<Bugzilla::Whine> event schedule.
+
+This is an implementation of L<Bugzilla::Object>, and so has all the
+same methods available as L<Bugzilla::Object>, in addition to what is
+documented below.
+
+=head1 METHODS
+
+=head2 Constructors
+
+=over
+
+=item C<new>
+
+Does not accept a bare C<name> argument. Instead, accepts only an id.
+
+See also: L<Bugzilla::Object/new>.
+
+=back
+
+
+=head2 Accessors
+
+These return data about the object, without modifying the object.
+
+=over
+
+=item C<event_id>
+
+The L<Bugzilla::Whine> event object id for this object.
+
+=item C<run_day>
+
+The day or day pattern that a L<Bugzilla::Whine> event is scheduled to run.
+
+=item C<run_time>
+
+The time or time pattern that a L<Bugzilla::Whine> event is scheduled to run.
+
+=item C<mailto_is_group>
+
+Returns a numeric 1 (C<group>) or 0 (C<user>) to represent whether
+L</mailto> is a group or user.
+
+=item C<mailto>
+
+This is either a L<Bugzilla::User> or L<Bugzilla::Group> object to represent 
+the user or group this scheduled event is set to be mailed to. 
+
+=item C<mailto_users>
+
+Returns an array reference of L<Bugzilla::User>s. This is derived from the
+L<Bugzilla::Group> stored in L</mailto> if L</mailto_is_group> is true and
+the group is still active, otherwise it will contain a single array element
+for the L<Bugzilla::User> in L</mailto>.
+
+=back

diff --git a/README b/README
new file mode 100644 (file)
index 0000000..041aebc
--- /dev/null
+++ b/README
@@ -0,0 +1,92 @@
+What is Bugzilla?
+=================
+Bugzilla is a free bug-tracking system that is developed by an active
+community of volunteers in the Mozilla community. You can install and
+use it without having to pay any license fee.
+
+Minimum requirements
+====================
+It can be installed on Windows, Mac OS X, Linux and other Unix flavors.
+Bugzilla is written in Perl, meaning that Perl must be installed on your system.
+You will also need a web server as well as a DB server (see below).
+
+Installation & Upgrading
+========================
+The documentation to install, upgrade, configure and use Bugzilla can be found
+in different formats:
+* docs/en/html/Bugzilla-Guide.html (HTML version)
+* docs/en/txt/Bugzilla-Guide.txt (text version)
+* docs/en/pdf/Bugzilla-Guide.pdf (PDF version)
+
+If the documentation is missing, you can get it online by visiting
+http://www.bugzilla.org/docs/ from where you can select the documentation
+corresponding to the Bugzilla version you are installing.
+
+Bugzilla Quick Start Guide
+==========================
+(or, how to get Bugzilla up and running in 10 steps)
+Christian Reis <kiko@async.com.br>
+
+This express installation guide is for "normal" Bugzilla installations,
+which means a Linux or Unix system on which Apache, Perl, MySQL or PostgreSQL
+and a Sendmail compatible MTA are available. For other configurations, please
+see the "Installing Bugzilla" section of the Bugzilla Guide in the docs/ directory.
+
+1. Decide from which URL and directory under your webserver root you
+   will be serving the Bugzilla webpages.
+
+2. Unpack the distribution into the chosen directory (there is no copying or
+   installation involved).
+
+3. Run ./checksetup.pl, look for unsolved requirements, and install them.
+   You can run checksetup as many times as necessary to check if
+   everything required has been installed.
+
+   These will usually include assorted Perl modules, MySQL or PostgreSQL,
+   and a MTA.
+
+   After a successful dependency check, checksetup should complain that
+   localconfig needs to be edited.
+
+4. Edit the localconfig file, in particular the $webservergroup and
+   $db_* variables. In particular, $db_name and $db_user will define
+   your database setup in step 5.
+
+5. Create a user permission for the name supplied as $db_user with
+   read/write access to the database whose name is given by $db_name.
+
+   If you are not familiar with MySQL permissions, it's a good idea to
+   use the mysql_setpermission script that is installed with the MySQL
+   distribution, and be sure to read Bugzilla Security - MySQL section
+   in the Bugzilla Guide or PostgreSQL documentation.
+
+6. Run checksetup.pl once more; if all goes well, it should set up the
+   Bugzilla database for you. If not, return to step 5.
+
+   checksetup.pl should ask you, this time, for the administrator's
+   email address and password. These will be used for the initial
+   Bugzilla administrator account.
+
+7. Configure Apache (or install and configure, if you don't have it up
+   yet) to point to the Bugzilla directory. You can choose between
+   mod_cgi and mod_perl. The Bugzilla documentation has detailed information
+   for both modes.
+
+8. Visit the URL you chose for Bugzilla. Your browser should display the
+   default Bugzilla home page. You should then log in as the
+   administrator by following the "Log in" link and supplying the
+   account information you provided in step 6.
+
+9. Visit the "Parameters" page, as suggested by the page displayed to you.
+   Set up the relevant parameters for your local setup.
+
+10. That's it. If anything unexpected comes up:
+
+    - read the error message carefully,
+    - backtrack through the steps above,
+    - check the official installation guide.
+
+Support and installation questions should be directed to the
+support-bugzilla@lists.mozilla.org mailing list.
+
+Further support information is at http://www.bugzilla.org/support/

diff --git a/admin.cgi b/admin.cgi
new file mode 100755 (executable)
index 0000000..273ec8e
--- /dev/null
+++ b/admin.cgi
@@ -0,0 +1,36 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+print $cgi->header();
+
+$user->in_group('admin')
+  || $user->in_group('tweakparams')
+  || $user->in_group('editusers')
+  || $user->can_bless
+  || (Bugzilla->params->{'useclassification'} && $user->in_group('editclassifications'))
+  || $user->in_group('editcomponents')
+  || scalar(@{$user->get_products_by_permission('editcomponents')})
+  || $user->in_group('creategroups')
+  || $user->in_group('editkeywords')
+  || $user->in_group('bz_canusewhines')
+  || ThrowUserError('auth_failure', {action => 'access', object => 'administrative_pages'});
+
+$template->process('admin/admin.html.tmpl')
+  || ThrowTemplateError($template->error());

diff --git a/attachment.cgi b/attachment.cgi
new file mode 100755 (executable)
index 0000000..903fe5b
--- /dev/null
+++ b/attachment.cgi
@@ -0,0 +1,801 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+################################################################################
+# Script Initialization
+################################################################################
+
+# Make it harder for us to do dangerous things in Perl.
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::BugMail;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Flag; 
+use Bugzilla::FlagType; 
+use Bugzilla::User;
+use Bugzilla::Util;
+use Bugzilla::Bug;
+use Bugzilla::Field;
+use Bugzilla::Attachment;
+use Bugzilla::Attachment::PatchReader;
+use Bugzilla::Token;
+use Bugzilla::Keyword;
+
+use Encode qw(encode find_encoding);
+
+# For most scripts we don't make $cgi and $template global variables. But
+# when preparing Bugzilla for mod_perl, this script used these
+# variables in so many subroutines that it was easier to just
+# make them globals.
+local our $cgi = Bugzilla->cgi;
+local our $template = Bugzilla->template;
+local our $vars = {};
+
+################################################################################
+# Main Body Execution
+################################################################################
+
+# All calls to this script should contain an "action" variable whose
+# value determines what the user wants to do.  The code below checks
+# the value of that variable and runs the appropriate code. If none is
+# supplied, we default to 'view'.
+
+# Determine whether to use the action specified by the user or the default.
+my $action = $cgi->param('action') || 'view';
+my $format = $cgi->param('format') || '';
+
+# You must use the appropriate urlbase/sslbase param when doing anything
+# but viewing an attachment, or a raw diff.
+if ($action ne 'view'
+    && (($action !~ /^(?:interdiff|diff)$/) || $format ne 'raw'))
+{
+    do_ssl_redirect_if_required();
+    if ($cgi->url_is_attachment_base) {
+        $cgi->redirect_to_urlbase;
+    }
+    Bugzilla->login();
+}
+
+# When viewing an attachment, do not request credentials if we are on
+# the alternate host. Let view() decide when to call Bugzilla->login.
+if ($action eq "view")
+{
+    view();
+}
+elsif ($action eq "interdiff")
+{
+    interdiff();
+}
+elsif ($action eq "diff")
+{
+    diff();
+}
+elsif ($action eq "viewall") 
+{ 
+    viewall(); 
+}
+elsif ($action eq "enter") 
+{ 
+    Bugzilla->login(LOGIN_REQUIRED);
+    enter(); 
+}
+elsif ($action eq "insert")
+{
+    Bugzilla->login(LOGIN_REQUIRED);
+    insert();
+}
+elsif ($action eq "edit") 
+{ 
+    edit(); 
+}
+elsif ($action eq "update") 
+{ 
+    Bugzilla->login(LOGIN_REQUIRED);
+    update();
+}
+elsif ($action eq "delete") {
+    delete_attachment();
+}
+else 
+{ 
+  ThrowUserError('unknown_action', {action => $action});
+}
+
+exit;
+
+################################################################################
+# Data Validation / Security Authorization
+################################################################################
+
+# Validates an attachment ID. Optionally takes a parameter of a form
+# variable name that contains the ID to be validated. If not specified,
+# uses 'id'.
+# If the second parameter is true, the attachment ID will be validated,
+# however the current user's access to the attachment will not be checked.
+# Will throw an error if 1) attachment ID is not a valid number,
+# 2) attachment does not exist, or 3) user isn't allowed to access the
+# attachment.
+#
+# Returns an attachment object.
+
+sub validateID {
+    my($param, $dont_validate_access) = @_;
+    $param ||= 'id';
+
+    # If we're not doing interdiffs, check if id wasn't specified and
+    # prompt them with a page that allows them to choose an attachment.
+    # Happens when calling plain attachment.cgi from the urlbar directly
+    if ($param eq 'id' && !$cgi->param('id')) {
+        print $cgi->header();
+        $template->process("attachment/choose.html.tmpl", $vars) ||
+            ThrowTemplateError($template->error());
+        exit;
+    }
+    
+    my $attach_id = $cgi->param($param);
+
+    # Validate the specified attachment id. detaint kills $attach_id if
+    # non-natural, so use the original value from $cgi in our exception
+    # message here.
+    detaint_natural($attach_id)
+        || ThrowUserError("invalid_attach_id",
+                          { attach_id => scalar $cgi->param($param) });
+  
+    # Make sure the attachment exists in the database.
+    my $attachment = new Bugzilla::Attachment($attach_id)
+        || ThrowUserError("invalid_attach_id", { attach_id => $attach_id });
+
+    return $attachment if ($dont_validate_access || check_can_access($attachment));
+}
+
+# Make sure the current user has access to the specified attachment.
+sub check_can_access {
+    my $attachment = shift;
+    my $user = Bugzilla->user;
+
+    # Make sure the user is authorized to access this attachment's bug.
+    Bugzilla::Bug->check($attachment->bug_id);
+    if ($attachment->isprivate && $user->id != $attachment->attacher->id 
+        && !$user->is_insider) 
+    {
+        ThrowUserError('auth_failure', {action => 'access',
+                                        object => 'attachment',
+                                        attach_id => $attachment->id});
+    }
+    return 1;
+}
+
+# Determines if the attachment is public -- that is, if users who are
+# not logged in have access to the attachment
+sub attachmentIsPublic {
+    my $attachment = shift;
+
+    return 0 if Bugzilla->params->{'requirelogin'};
+    return 0 if $attachment->isprivate;
+
+    my $anon_user = new Bugzilla::User;
+    return $anon_user->can_see_bug($attachment->bug_id);
+}
+
+# Validates format of a diff/interdiff. Takes a list as an parameter, which
+# defines the valid format values. Will throw an error if the format is not
+# in the list. Returns either the user selected or default format.
+sub validateFormat {
+  # receives a list of legal formats; first item is a default
+  my $format = $cgi->param('format') || $_[0];
+  if (not grep($_ eq $format, @_)) {
+     ThrowUserError("invalid_format", { format  => $format, formats => \@_ });
+  }
+
+  return $format;
+}
+
+# Validates context of a diff/interdiff. Will throw an error if the context
+# is not number, "file" or "patch". Returns the validated, detainted context.
+sub validateContext
+{
+  my $context = $cgi->param('context') || "patch";
+  if ($context ne "file" && $context ne "patch") {
+    detaint_natural($context)
+      || ThrowUserError("invalid_context", { context => $cgi->param('context') });
+  }
+
+  return $context;
+}
+
+# Gets the attachment object(s) generated by validateID, while ensuring
+# attachbase and token authentication is used when required.
+sub get_attachment {
+    my @field_names = @_ ? @_ : qw(id);
+
+    my %attachments;
+
+    if (use_attachbase()) {
+        # Load each attachment, and ensure they are all from the same bug
+        my $bug_id = 0;
+        foreach my $field_name (@field_names) {
+            my $attachment = validateID($field_name, 1);
+            if (!$bug_id) {
+                $bug_id = $attachment->bug_id;
+            } elsif ($attachment->bug_id != $bug_id) {
+                ThrowUserError('attachment_bug_id_mismatch');
+            }
+            $attachments{$field_name} = $attachment;
+        }
+        my @args = map { $_ . '=' . $attachments{$_}->id } @field_names;
+        my $cgi_params = $cgi->canonicalise_query(@field_names, 't',
+            'Bugzilla_login', 'Bugzilla_password');
+        push(@args, $cgi_params) if $cgi_params;
+        my $path = 'attachment.cgi?' . join('&', @args);
+
+        # Make sure the attachment is served from the correct server.
+        if ($cgi->url_is_attachment_base($bug_id)) {
+            # No need to validate the token for public attachments. We cannot request
+            # credentials as we are on the alternate host.
+            if (!all_attachments_are_public(\%attachments)) {
+                my $token = $cgi->param('t');
+                my ($userid, undef, $token_data) = Bugzilla::Token::GetTokenData($token);
+                my %token_data = unpack_token_data($token_data);
+                my $valid_token = 1;
+                foreach my $field_name (@field_names) {
+                    my $token_id = $token_data{$field_name};
+                    if (!$token_id
+                        || !detaint_natural($token_id)
+                        || $attachments{$field_name}->id != $token_id)
+                    {
+                        $valid_token = 0;
+                        last;
+                    }
+                }
+                unless ($userid && $valid_token) {
+                    # Not a valid token.
+                    print $cgi->redirect('-location' => correct_urlbase() . $path);
+                    exit;
+                }
+                # Change current user without creating cookies.
+                Bugzilla->set_user(new Bugzilla::User($userid));
+                # Tokens are single use only, delete it.
+                delete_token($token);
+            }
+        }
+        elsif ($cgi->url_is_attachment_base) {
+            # If we come here, this means that each bug has its own host
+            # for attachments, and that we are trying to view one attachment
+            # using another bug's host. That's not desired.
+            $cgi->redirect_to_urlbase;
+        }
+        else {
+            # We couldn't call Bugzilla->login earlier as we first had to
+            # make sure we were not going to request credentials on the
+            # alternate host.
+            Bugzilla->login();
+            my $attachbase = Bugzilla->params->{'attachment_base'};
+            # Replace %bugid% by the ID of the bug the attachment 
+            # belongs to, if present.
+            $attachbase =~ s/\%bugid\%/$bug_id/;
+            if (all_attachments_are_public(\%attachments)) {
+                # No need for a token; redirect to attachment base.
+                print $cgi->redirect(-location => $attachbase . $path);
+                exit;
+            } else {
+                # Make sure the user can view the attachment.
+                foreach my $field_name (@field_names) {
+                    check_can_access($attachments{$field_name});
+                }
+                # Create a token and redirect.
+                my $token = url_quote(issue_session_token(pack_token_data(\%attachments)));
+                print $cgi->redirect(-location => $attachbase . "$path&t=$token");
+                exit;
+            }
+        }
+    } else {
+        do_ssl_redirect_if_required();
+        # No alternate host is used. Request credentials if required.
+        Bugzilla->login();
+        foreach my $field_name (@field_names) {
+            $attachments{$field_name} = validateID($field_name);
+        }
+    }
+
+    return wantarray
+        ? map { $attachments{$_} } @field_names
+        : $attachments{$field_names[0]};
+}
+
+sub all_attachments_are_public {
+    my $attachments = shift;
+    foreach my $field_name (keys %$attachments) {
+        if (!attachmentIsPublic($attachments->{$field_name})) {
+            return 0;
+        }
+    }
+    return 1;
+}
+
+sub pack_token_data {
+    my $attachments = shift;
+    return join(' ', map { $_ . '=' . $attachments->{$_}->id } keys %$attachments);
+}
+
+sub unpack_token_data {
+    my @token_data = split(/ /, shift || '');
+    my %data;
+    foreach my $token (@token_data) {
+        my ($field_name, $attach_id) = split('=', $token);
+        $data{$field_name} = $attach_id;
+    }
+    return %data;
+}
+
+################################################################################
+# Functions
+################################################################################
+
+# Display an attachment.
+sub view {
+    my $attachment = get_attachment();
+
+    # At this point, Bugzilla->login has been called if it had to.
+    my $contenttype = $attachment->contenttype;
+    my $filename = $attachment->filename;
+
+    # Bug 111522: allow overriding content-type manually in the posted form
+    # params.
+    if (defined $cgi->param('content_type')) {
+        $contenttype = $attachment->_check_content_type($cgi->param('content_type'));
+    }
+
+    # Return the appropriate HTTP response headers.
+    $attachment->datasize || ThrowUserError("attachment_removed");
+
+    $filename =~ s/^.*[\/\\]//;
+    # escape quotes and backslashes in the filename, per RFCs 2045/822
+    $filename =~ s/\\/\\\\/g; # escape backslashes
+    $filename =~ s/"/\\"/g; # escape quotes
+
+    # Avoid line wrapping done by Encode, which we don't need for HTTP
+    # headers. See discussion in bug 328628 for details.
+    local $Encode::Encoding{'MIME-Q'}->{'bpl'} = 10000;
+    $filename = encode('MIME-Q', $filename);
+
+    my $disposition = Bugzilla->params->{'allow_attachment_display'} ? 'inline' : 'attachment';
+
+    # Don't send a charset header with attachments--they might not be UTF-8.
+    # However, we do allow people to explicitly specify a charset if they
+    # want.
+    if ($contenttype !~ /\bcharset=/i) {
+        # In order to prevent Apache from adding a charset, we have to send a
+        # charset that's a single space.
+        $cgi->charset(' ');
+        if (Bugzilla->feature('detect_charset') && $contenttype =~ /^text\//) {
+            my $encoding = detect_encoding($attachment->data);
+            if ($encoding) {
+                $cgi->charset(find_encoding($encoding)->mime_name);
+            }
+        }
+    }
+    print $cgi->header(-type=>"$contenttype; name=\"$filename\"",
+                       -content_disposition=> "$disposition; filename=\"$filename\"",
+                       -content_length => $attachment->datasize);
+    disable_utf8();
+    print $attachment->data;
+}
+
+sub interdiff {
+    # Retrieve and validate parameters
+    my $format = validateFormat('html', 'raw');
+    my($old_attachment, $new_attachment);
+    if ($format eq 'raw') {
+        ($old_attachment, $new_attachment) = get_attachment('oldid', 'newid');
+    } else {
+        $old_attachment = validateID('oldid');
+        $new_attachment = validateID('newid');
+    }
+    my $context = validateContext();
+
+    Bugzilla::Attachment::PatchReader::process_interdiff(
+        $old_attachment, $new_attachment, $format, $context);
+}
+
+sub diff {
+    # Retrieve and validate parameters
+    my $format = validateFormat('html', 'raw');
+    my $attachment = $format eq 'raw' ? get_attachment() : validateID();
+    my $context = validateContext();
+
+    # If it is not a patch, view normally.
+    if (!$attachment->ispatch) {
+        view();
+        return;
+    }
+
+    Bugzilla::Attachment::PatchReader::process_diff($attachment, $format, $context);
+}
+
+# Display all attachments for a given bug in a series of IFRAMEs within one
+# HTML page.
+sub viewall {
+    # Retrieve and validate parameters
+    my $bug = Bugzilla::Bug->check(scalar $cgi->param('bugid'));
+
+    my $attachments = Bugzilla::Attachment->get_attachments_by_bug($bug);
+    # Ignore deleted attachments.
+    @$attachments = grep { $_->datasize } @$attachments;
+
+    if ($cgi->param('hide_obsolete')) {
+        @$attachments = grep { !$_->isobsolete } @$attachments;
+        $vars->{'hide_obsolete'} = 1;
+    }
+
+    # Define the variables and functions that will be passed to the UI template.
+    $vars->{'bug'} = $bug;
+    $vars->{'attachments'} = $attachments;
+
+    print $cgi->header();
+
+    # Generate and return the UI (HTML page) from the appropriate template.
+    $template->process("attachment/show-multiple.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+}
+
+# Display a form for entering a new attachment.
+sub enter {
+    # Retrieve and validate parameters
+    my $bug = Bugzilla::Bug->check(scalar $cgi->param('bugid'));
+    my $bugid = $bug->id;
+    Bugzilla::Attachment->_check_bug($bug);
+    my $dbh = Bugzilla->dbh;
+    my $user = Bugzilla->user;
+
+    # Retrieve the attachments the user can edit from the database and write
+    # them into an array of hashes where each hash represents one attachment.
+  
+    my ($can_edit, $not_private) = ('', '');
+    if (!$user->in_group('editbugs', $bug->product_id)) {
+        $can_edit = "AND submitter_id = " . $user->id;
+    }
+    if (!$user->is_insider) {
+        $not_private = "AND isprivate = 0";
+    }
+    my $attach_ids = $dbh->selectcol_arrayref(
+        "SELECT attach_id
+           FROM attachments
+          WHERE bug_id = ?
+                AND isobsolete = 0
+                $can_edit $not_private
+       ORDER BY attach_id",
+         undef, $bugid);
+
+    # Define the variables and functions that will be passed to the UI template.
+    $vars->{'bug'} = $bug;
+    $vars->{'attachments'} = Bugzilla::Attachment->new_from_list($attach_ids);
+
+    my $flag_types = Bugzilla::FlagType::match({
+        'target_type'  => 'attachment',
+        'product_id'   => $bug->product_id,
+        'component_id' => $bug->component_id
+    });
+    $vars->{'flag_types'} = $flag_types;
+    $vars->{'any_flags_requesteeble'} =
+        grep { $_->is_requestable && $_->is_requesteeble } @$flag_types;
+    $vars->{'token'} = issue_session_token('create_attachment');
+
+    print $cgi->header();
+
+    # Generate and return the UI (HTML page) from the appropriate template.
+    $template->process("attachment/create.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+}
+
+# Insert a new attachment into the database.
+sub insert {
+    my $dbh = Bugzilla->dbh;
+    my $user = Bugzilla->user;
+
+    $dbh->bz_start_transaction;
+
+    # Retrieve and validate parameters
+    my $bug = Bugzilla::Bug->check(scalar $cgi->param('bugid'));
+    my $bugid = $bug->id;
+    my ($timestamp) = $dbh->selectrow_array("SELECT NOW()");
+
+    # Detect if the user already used the same form to submit an attachment
+    my $token = trim($cgi->param('token'));
+    check_token_data($token, 'create_attachment', 'index.cgi');
+
+    # Check attachments the user tries to mark as obsolete.
+    my @obsolete_attachments;
+    if ($cgi->param('obsolete')) {
+        my @obsolete = $cgi->param('obsolete');
+        @obsolete_attachments = Bugzilla::Attachment->validate_obsolete($bug, \@obsolete);
+    }
+
+    # Must be called before create() as it may alter $cgi->param('ispatch').
+    my $content_type = Bugzilla::Attachment::get_content_type();
+
+    # Get the filehandle of the attachment.
+    my $data_fh = $cgi->upload('data');
+
+    my $attachment = Bugzilla::Attachment->create(
+        {bug           => $bug,
+         creation_ts   => $timestamp,
+         data          => scalar $cgi->param('attach_text') || $data_fh,
+         description   => scalar $cgi->param('description'),
+         filename      => $cgi->param('attach_text') ? "file_$bugid.txt" : scalar $cgi->upload('data'),
+         ispatch       => scalar $cgi->param('ispatch'),
+         isprivate     => scalar $cgi->param('isprivate'),
+         mimetype      => $content_type,
+         });
+
+    # Delete the token used to create this attachment.
+    delete_token($token);
+
+    foreach my $obsolete_attachment (@obsolete_attachments) {
+        $obsolete_attachment->set_is_obsolete(1);
+        $obsolete_attachment->update($timestamp);
+    }
+
+    my ($flags, $new_flags) = Bugzilla::Flag->extract_flags_from_cgi(
+                                  $bug, $attachment, $vars, SKIP_REQUESTEE_ON_ERROR);
+    $attachment->set_flags($flags, $new_flags);
+    $attachment->update($timestamp);
+
+    # Insert a comment about the new attachment into the database.
+    my $comment = $cgi->param('comment');
+    $comment = '' unless defined $comment;
+    $bug->add_comment($comment, { isprivate => $attachment->isprivate,
+                                  type => CMT_ATTACHMENT_CREATED,
+                                  extra_data => $attachment->id });
+
+  # Assign the bug to the user, if they are allowed to take it
+  my $owner = "";
+  if ($cgi->param('takebug') && $user->in_group('editbugs', $bug->product_id)) {
+      # When taking a bug, we have to follow the workflow.
+      my $bug_status = $cgi->param('bug_status') || '';
+      ($bug_status) = grep {$_->name eq $bug_status} @{$bug->status->can_change_to};
+
+      if ($bug_status && $bug_status->is_open
+          && ($bug_status->name ne 'UNCONFIRMED' 
+              || $bug->product_obj->allows_unconfirmed))
+      {
+          $bug->set_bug_status($bug_status->name);
+          $bug->clear_resolution();
+      }
+      # Make sure the person we are taking the bug from gets mail.
+      $owner = $bug->assigned_to->login;
+      $bug->set_assigned_to($user);
+  }
+
+  $bug->add_cc($user) if $cgi->param('addselfcc');
+  $bug->update($timestamp);
+
+  $dbh->bz_commit_transaction;
+
+  # Define the variables and functions that will be passed to the UI template.
+  $vars->{'attachment'} = $attachment;
+  # We cannot reuse the $bug object as delta_ts has eventually been updated
+  # since the object was created.
+  $vars->{'bugs'} = [new Bugzilla::Bug($bugid)];
+  $vars->{'header_done'} = 1;
+  $vars->{'contenttypemethod'} = $cgi->param('contenttypemethod');
+
+  my $recipients =  { 'changer' => $user, 'owner' => $owner };
+  $vars->{'sent_bugmail'} = Bugzilla::BugMail::Send($bugid, $recipients);
+
+  print $cgi->header();
+  # Generate and return the UI (HTML page) from the appropriate template.
+  $template->process("attachment/created.html.tmpl", $vars)
+    || ThrowTemplateError($template->error());
+}
+
+# Displays a form for editing attachment properties.
+# Any user is allowed to access this page, unless the attachment
+# is private and the user does not belong to the insider group.
+# Validations are done later when the user submits changes.
+sub edit {
+  my $attachment = validateID();
+
+  my $bugattachments =
+      Bugzilla::Attachment->get_attachments_by_bug($attachment->bug);
+
+  my $any_flags_requesteeble =
+    grep { $_->is_requestable && $_->is_requesteeble } @{$attachment->flag_types};
+  # Useful in case a flagtype is no longer requestable but a requestee
+  # has been set before we turned off that bit.
+  $any_flags_requesteeble ||= grep { $_->requestee_id } @{$attachment->flags};
+  $vars->{'any_flags_requesteeble'} = $any_flags_requesteeble;
+  $vars->{'attachment'} = $attachment;
+  $vars->{'attachments'} = $bugattachments;
+
+  print $cgi->header();
+
+  # Generate and return the UI (HTML page) from the appropriate template.
+  $template->process("attachment/edit.html.tmpl", $vars)
+    || ThrowTemplateError($template->error());
+}
+
+# Updates an attachment record. Only users with "editbugs" privileges,
+# (or the original attachment's submitter) can edit the attachment.
+# Users cannot edit the content of the attachment itself.
+sub update {
+    my $user = Bugzilla->user;
+    my $dbh = Bugzilla->dbh;
+
+    # Start a transaction in preparation for updating the attachment.
+    $dbh->bz_start_transaction();
+
+    # Retrieve and validate parameters
+    my $attachment = validateID();
+    my $bug = $attachment->bug;
+    $attachment->_check_bug;
+    my $can_edit = $attachment->validate_can_edit($bug->product_id);
+
+    if ($can_edit) {
+        $attachment->set_description(scalar $cgi->param('description'));
+        $attachment->set_is_patch(scalar $cgi->param('ispatch'));
+        $attachment->set_content_type(scalar $cgi->param('contenttypeentry'));
+        $attachment->set_is_obsolete(scalar $cgi->param('isobsolete'));
+        $attachment->set_is_private(scalar $cgi->param('isprivate'));
+        $attachment->set_filename(scalar $cgi->param('filename'));
+
+        # Now make sure the attachment has not been edited since we loaded the page.
+        if (defined $cgi->param('delta_ts')
+            && $cgi->param('delta_ts') ne $attachment->modification_time)
+        {
+            ($vars->{'operations'}) = $bug->get_activity($attachment->id, $cgi->param('delta_ts'));
+
+            # The token contains the old modification_time. We need a new one.
+            $cgi->param('token', issue_hash_token([$attachment->id, $attachment->modification_time]));
+
+            # If the modification date changed but there is no entry in
+            # the activity table, this means someone commented only.
+            # In this case, there is no reason to midair.
+            if (scalar(@{$vars->{'operations'}})) {
+                $cgi->param('delta_ts', $attachment->modification_time);
+                $vars->{'attachment'} = $attachment;
+
+                print $cgi->header();
+                # Warn the user about the mid-air collision and ask them what to do.
+                $template->process("attachment/midair.html.tmpl", $vars)
+                  || ThrowTemplateError($template->error());
+                exit;
+            }
+        }
+    }
+
+    # We couldn't do this check earlier as we first had to validate attachment ID
+    # and display the mid-air collision page if modification_time changed.
+    my $token = $cgi->param('token');
+    check_hash_token($token, [$attachment->id, $attachment->modification_time]);
+
+    # If the user submitted a comment while editing the attachment,
+    # add the comment to the bug. Do this after having validated isprivate!
+    my $comment = $cgi->param('comment');
+    if (defined $comment && trim($comment) ne '') {
+        $bug->add_comment($comment, { isprivate => $attachment->isprivate,
+                                      type => CMT_ATTACHMENT_UPDATED,
+                                      extra_data => $attachment->id });
+    }
+
+    $bug->add_cc($user) if $cgi->param('addselfcc');
+
+    if ($can_edit) {
+        my ($flags, $new_flags) =
+          Bugzilla::Flag->extract_flags_from_cgi($bug, $attachment, $vars);
+        $attachment->set_flags($flags, $new_flags);
+    }
+
+    # Figure out when the changes were made.
+    my $timestamp = $dbh->selectrow_array('SELECT LOCALTIMESTAMP(0)');
+
+    if ($can_edit) {
+        my $changes = $attachment->update($timestamp);
+        # If there are changes, we updated delta_ts in the DB. We have to
+        # reflect this change in the bug object.
+        $bug->{delta_ts} = $timestamp if scalar(keys %$changes);
+    }
+
+    # Commit the comment, if any.
+    $bug->update($timestamp);
+
+    # Commit the transaction now that we are finished updating the database.
+    $dbh->bz_commit_transaction();
+
+    # Define the variables and functions that will be passed to the UI template.
+    $vars->{'attachment'} = $attachment;
+    $vars->{'bugs'} = [$bug];
+    $vars->{'header_done'} = 1;
+    $vars->{'sent_bugmail'} = 
+        Bugzilla::BugMail::Send($bug->id, { 'changer' => $user });
+
+    print $cgi->header();
+
+    # Generate and return the UI (HTML page) from the appropriate template.
+    $template->process("attachment/updated.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+}
+
+# Only administrators can delete attachments.
+sub delete_attachment {
+    my $user = Bugzilla->login(LOGIN_REQUIRED);
+    my $dbh = Bugzilla->dbh;
+
+    print $cgi->header();
+
+    $user->in_group('admin')
+      || ThrowUserError('auth_failure', {group  => 'admin',
+                                         action => 'delete',
+                                         object => 'attachment'});
+
+    Bugzilla->params->{'allow_attachment_deletion'}
+      || ThrowUserError('attachment_deletion_disabled');
+
+    # Make sure the administrator is allowed to edit this attachment.
+    my $attachment = validateID();
+    Bugzilla::Attachment->_check_bug($attachment->bug);
+
+    $attachment->datasize || ThrowUserError('attachment_removed');
+
+    # We don't want to let a malicious URL accidentally delete an attachment.
+    my $token = trim($cgi->param('token'));
+    if ($token) {
+        my ($creator_id, $date, $event) = Bugzilla::Token::GetTokenData($token);
+        unless ($creator_id
+                  && ($creator_id == $user->id)
+                  && ($event eq 'delete_attachment' . $attachment->id))
+        {
+            # The token is invalid.
+            ThrowUserError('token_does_not_exist');
+        }
+
+        my $bug = new Bugzilla::Bug($attachment->bug_id);
+
+        # The token is valid. Delete the content of the attachment.
+        my $msg;
+        $vars->{'attachment'} = $attachment;
+        $vars->{'reason'} = clean_text($cgi->param('reason') || '');
+
+        $template->process("attachment/delete_reason.txt.tmpl", $vars, \$msg)
+          || ThrowTemplateError($template->error());
+
+        # Paste the reason provided by the admin into a comment.
+        $bug->add_comment($msg);
+
+        $attachment->remove_from_db();
+
+        # Now delete the token.
+        delete_token($token);
+
+        # Insert the comment.
+        $bug->update();
+
+        # Required to display the bug the deleted attachment belongs to.
+        $vars->{'bugs'} = [$bug];
+        $vars->{'header_done'} = 1;
+
+        $vars->{'sent_bugmail'} =
+            Bugzilla::BugMail::Send($bug->id, { 'changer' => $user });
+
+        $template->process("attachment/updated.html.tmpl", $vars)
+          || ThrowTemplateError($template->error());
+    }
+    else {
+        # Create a token.
+        $token = issue_session_token('delete_attachment' . $attachment->id);
+
+        $vars->{'a'} = $attachment;
+        $vars->{'token'} = $token;
+
+        $template->process("attachment/confirm-delete.html.tmpl", $vars)
+          || ThrowTemplateError($template->error());
+    }
+}

diff --git a/buglist.cgi b/buglist.cgi
new file mode 100755 (executable)
index 0000000..fbdbb85
--- /dev/null
+++ b/buglist.cgi
@@ -0,0 +1,1073 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+################################################################################
+# Script Initialization
+################################################################################
+
+# Make it harder for us to do dangerous things in Perl.
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Util;
+use Bugzilla::Search;
+use Bugzilla::Search::Quicksearch;
+use Bugzilla::Search::Recent;
+use Bugzilla::Search::Saved;
+use Bugzilla::Bug;
+use Bugzilla::Product;
+use Bugzilla::Field;
+use Bugzilla::Status;
+use Bugzilla::Token;
+
+use Date::Parse;
+
+my $cgi = Bugzilla->cgi;
+my $dbh = Bugzilla->dbh;
+my $template = Bugzilla->template;
+my $vars = {};
+
+# We have to check the login here to get the correct footer if an error is
+# thrown and to prevent a logged out user to use QuickSearch if 'requirelogin'
+# is turned 'on'.
+my $user = Bugzilla->login();
+
+$cgi->redirect_search_url();
+
+my $buffer = $cgi->query_string();
+if (length($buffer) == 0) {
+    ThrowUserError("buglist_parameters_required");
+}
+
+
+# Determine whether this is a quicksearch query.
+my $searchstring = $cgi->param('quicksearch');
+if (defined($searchstring)) {
+    $buffer = quicksearch($searchstring);
+    # Quicksearch may do a redirect, in which case it does not return.
+    # If it does return, it has modified $cgi->params so we can use them here
+    # as if this had been a normal query from the beginning.
+}
+
+# If configured to not allow empty words, reject empty searches from the
+# Find a Specific Bug search form, including words being a single or 
+# several consecutive whitespaces only.
+if (!Bugzilla->params->{'search_allow_no_criteria'}
+    && defined($cgi->param('content')) && $cgi->param('content') =~ /^\s*$/)
+{
+    ThrowUserError("buglist_parameters_required");
+}
+
+################################################################################
+# Data and Security Validation
+################################################################################
+
+# Whether or not the user wants to change multiple bugs.
+my $dotweak = $cgi->param('tweak') ? 1 : 0;
+
+# Log the user in
+if ($dotweak) {
+    Bugzilla->login(LOGIN_REQUIRED);
+}
+
+# Hack to support legacy applications that think the RDF ctype is at format=rdf.
+if (defined $cgi->param('format') && $cgi->param('format') eq "rdf"
+    && !defined $cgi->param('ctype')) {
+    $cgi->param('ctype', "rdf");
+    $cgi->delete('format');
+}
+
+# Treat requests for ctype=rss as requests for ctype=atom
+if (defined $cgi->param('ctype') && $cgi->param('ctype') eq "rss") {
+    $cgi->param('ctype', "atom");
+}
+
+# Determine the format in which the user would like to receive the output.
+# Uses the default format if the user did not specify an output format;
+# otherwise validates the user's choice against the list of available formats.
+my $format = $template->get_format("list/list", scalar $cgi->param('format'),
+                                   scalar $cgi->param('ctype'));
+
+# Use server push to display a "Please wait..." message for the user while
+# executing their query if their browser supports it and they are viewing
+# the bug list as HTML and they have not disabled it by adding &serverpush=0
+# to the URL.
+#
+# Server push is compatible with Gecko-based browsers and Opera, but not with
+# MSIE, Lynx or Safari (bug 441496).
+
+my $serverpush =
+  $format->{'extension'} eq "html"
+    && exists $ENV{'HTTP_USER_AGENT'} 
+      && $ENV{'HTTP_USER_AGENT'} =~ /(Mozilla.[3-9]|Opera)/
+        && $ENV{'HTTP_USER_AGENT'} !~ /compatible/i
+          && $ENV{'HTTP_USER_AGENT'} !~ /WebKit/
+            && !defined($cgi->param('serverpush'))
+              || $cgi->param('serverpush');
+
+my $order = $cgi->param('order') || "";
+
+# The params object to use for the actual query itself
+my $params;
+
+# If the user is retrieving the last bug list they looked at, hack the buffer
+# storing the query string so that it looks like a query retrieving those bugs.
+if (my $last_list = $cgi->param('regetlastlist')) {
+    my $bug_ids;
+
+    # Logged-out users use the old cookie method for storing the last search.
+    if (!$user->id or $last_list eq 'cookie') {
+        $bug_ids = $cgi->cookie('BUGLIST') or ThrowUserError("missing_cookie");
+        $bug_ids =~ s/[:-]/,/g;
+        $order ||= "reuse last sort";
+    }
+    # But logged in users store the last X searches in the DB so they can
+    # have multiple bug lists available.
+    else {
+        my $last_search = Bugzilla::Search::Recent->check(
+            { id => $last_list });
+        $bug_ids = join(',', @{ $last_search->bug_list });
+        $order ||= $last_search->list_order;
+    }
+    # set up the params for this new query
+    $params = new Bugzilla::CGI({ bug_id => $bug_ids, order => $order });
+    $params->param('list_id', $last_list);
+}
+
+# Figure out whether or not the user is doing a fulltext search.  If not,
+# we'll remove the relevance column from the lists of columns to display
+# and order by, since relevance only exists when doing a fulltext search.
+my $fulltext = 0;
+if ($cgi->param('content')) { $fulltext = 1 }
+my @charts = map(/^field(\d-\d-\d)$/ ? $1 : (), $cgi->param());
+foreach my $chart (@charts) {
+    if ($cgi->param("field$chart") eq 'content' && $cgi->param("value$chart")) {
+        $fulltext = 1;
+        last;
+    }
+}
+
+################################################################################
+# Utilities
+################################################################################
+
+sub DiffDate {
+    my ($datestr) = @_;
+    my $date = str2time($datestr);
+    my $age = time() - $date;
+
+    if( $age < 18*60*60 ) {
+        $date = format_time($datestr, '%H:%M:%S');
+    } elsif( $age < 6*24*60*60 ) {
+        $date = format_time($datestr, '%a %H:%M');
+    } else {
+        $date = format_time($datestr, '%Y-%m-%d');
+    }
+    return $date;
+}
+
+sub LookupNamedQuery {
+    my ($name, $sharer_id) = @_;
+
+    Bugzilla->login(LOGIN_REQUIRED);
+
+    my $query = Bugzilla::Search::Saved->check(
+        { user => $sharer_id, name => $name, _error => 'missing_query' });
+
+    $query->url
+       || ThrowUserError("buglist_parameters_required");
+
+    # Detaint $sharer_id.
+    $sharer_id = $query->user->id if $sharer_id;
+    return wantarray ? ($query->url, $query->id, $sharer_id) : $query->url;
+}
+
+# Inserts a Named Query (a "Saved Search") into the database, or
+# updates a Named Query that already exists..
+# Takes four arguments:
+# userid - The userid who the Named Query will belong to.
+# query_name - A string that names the new Named Query, or the name
+#              of an old Named Query to update. If this is blank, we
+#              will throw a UserError. Leading and trailing whitespace
+#              will be stripped from this value before it is inserted
+#              into the DB.
+# query - The query part of the buglist.cgi URL, unencoded. Must not be 
+#         empty, or we will throw a UserError.
+# link_in_footer (optional) - 1 if the Named Query should be 
+# displayed in the user's footer, 0 otherwise.
+#
+# All parameters are validated before passing them into the database.
+#
+# Returns: A boolean true value if the query existed in the database 
+# before, and we updated it. A boolean false value otherwise.
+sub InsertNamedQuery {
+    my ($query_name, $query, $link_in_footer) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    $query_name = trim($query_name);
+    my ($query_obj) = grep {lc($_->name) eq lc($query_name)} @{Bugzilla->user->queries};
+
+    if ($query_obj) {
+        $query_obj->set_name($query_name);
+        $query_obj->set_url($query);
+        $query_obj->update();
+    } else {
+        Bugzilla::Search::Saved->create({
+            name           => $query_name,
+            query          => $query,
+            link_in_footer => $link_in_footer
+        });
+    }
+
+    return $query_obj ? 1 : 0;
+}
+
+sub LookupSeries {
+    my ($series_id) = @_;
+    detaint_natural($series_id) || ThrowCodeError("invalid_series_id");
+    
+    my $dbh = Bugzilla->dbh;
+    my $result = $dbh->selectrow_array("SELECT query FROM series " .
+                                       "WHERE series_id = ?"
+                                       , undef, ($series_id));
+    $result
+           || ThrowCodeError("invalid_series_id", {'series_id' => $series_id});
+    return $result;
+}
+
+sub GetQuip {
+    my $dbh = Bugzilla->dbh;
+    # COUNT is quick because it is cached for MySQL. We may want to revisit
+    # this when we support other databases.
+    my $count = $dbh->selectrow_array("SELECT COUNT(quip)"
+                                    . " FROM quips WHERE approved = 1");
+    my $random = int(rand($count));
+    my $quip = 
+        $dbh->selectrow_array("SELECT quip FROM quips WHERE approved = 1 " . 
+                              $dbh->sql_limit(1, $random));
+    return $quip;
+}
+
+# Return groups available for at least one product of the buglist.
+sub GetGroups {
+    my $product_names = shift;
+    my $user = Bugzilla->user;
+    my %legal_groups;
+
+    foreach my $product_name (@$product_names) {
+        my $product = new Bugzilla::Product({name => $product_name});
+
+        foreach my $gid (keys %{$product->group_controls}) {
+            # The user can only edit groups he belongs to.
+            next unless $user->in_group_id($gid);
+
+            # The user has no control on groups marked as NA or MANDATORY.
+            my $group = $product->group_controls->{$gid};
+            next if ($group->{membercontrol} == CONTROLMAPMANDATORY
+                     || $group->{membercontrol} == CONTROLMAPNA);
+
+            # It's fine to include inactive groups. Those will be marked
+            # as "remove only" when editing several bugs at once.
+            $legal_groups{$gid} ||= $group->{group};
+        }
+    }
+    # Return a list of group objects.
+    return [values %legal_groups];
+}
+
+sub _close_standby_message {
+    my ($contenttype, $disposition, $serverpush) = @_;
+    my $cgi = Bugzilla->cgi;
+
+    # Close the "please wait" page, then open the buglist page
+    if ($serverpush) {
+        print $cgi->multipart_end();
+        print $cgi->multipart_start(-type                => $contenttype,
+                                    -content_disposition => $disposition);
+    }
+    else {
+        print $cgi->header(-type                => $contenttype,
+                           -content_disposition => $disposition);
+    }
+}
+
+
+################################################################################
+# Command Execution
+################################################################################
+
+my $cmdtype   = $cgi->param('cmdtype')   || '';
+my $remaction = $cgi->param('remaction') || '';
+my $sharer_id;
+
+# Backwards-compatibility - the old interface had cmdtype="runnamed" to run
+# a named command, and we can't break this because it's in bookmarks.
+if ($cmdtype eq "runnamed") {  
+    $cmdtype = "dorem";
+    $remaction = "run";
+}
+
+# Now we're going to be running, so ensure that the params object is set up,
+# using ||= so that we only do so if someone hasn't overridden this 
+# earlier, for example by setting up a named query search.
+
+# This will be modified, so make a copy.
+$params ||= new Bugzilla::CGI($cgi);
+
+# Generate a reasonable filename for the user agent to suggest to the user
+# when the user saves the bug list.  Uses the name of the remembered query
+# if available.  We have to do this now, even though we return HTTP headers 
+# at the end, because the fact that there is a remembered query gets 
+# forgotten in the process of retrieving it.
+my @time = localtime(time());
+my $date = sprintf "%04d-%02d-%02d", 1900+$time[5],$time[4]+1,$time[3];
+my $filename = "bugs-$date.$format->{extension}";
+if ($cmdtype eq "dorem" && $remaction =~ /^run/) {
+    $filename = $cgi->param('namedcmd') . "-$date.$format->{extension}";
+    # Remove white-space from the filename so the user cannot tamper
+    # with the HTTP headers.
+    $filename =~ s/\s/_/g;
+}
+$filename =~ s/\\/\\\\/g; # escape backslashes
+$filename =~ s/"/\\"/g; # escape quotes
+
+# Take appropriate action based on user's request.
+if ($cmdtype eq "dorem") {  
+    if ($remaction eq "run") {
+        my $query_id;
+        ($buffer, $query_id, $sharer_id) =
+          LookupNamedQuery(scalar $cgi->param("namedcmd"),
+                           scalar $cgi->param('sharer_id'));
+        # If this is the user's own query, remember information about it
+        # so that it can be modified easily.
+        $vars->{'searchname'} = $cgi->param('namedcmd');
+        if (!$cgi->param('sharer_id') ||
+            $cgi->param('sharer_id') == $user->id) {
+            $vars->{'searchtype'} = "saved";
+            $vars->{'search_id'} = $query_id;
+        }
+        $params = new Bugzilla::CGI($buffer);
+        $order = $params->param('order') || $order;
+
+    }
+    elsif ($remaction eq "runseries") {
+        $buffer = LookupSeries(scalar $cgi->param("series_id"));
+        $vars->{'searchname'} = $cgi->param('namedcmd');
+        $vars->{'searchtype'} = "series";
+        $params = new Bugzilla::CGI($buffer);
+        $order = $params->param('order') || $order;
+    }
+    elsif ($remaction eq "forget") {
+        $user = Bugzilla->login(LOGIN_REQUIRED);
+        # Copy the name into a variable, so that we can trick_taint it for
+        # the DB. We know it's safe, because we're using placeholders in 
+        # the SQL, and the SQL is only a DELETE.
+        my $qname = $cgi->param('namedcmd');
+        trick_taint($qname);
+
+        # Do not forget the saved search if it is being used in a whine
+        my $whines_in_use = 
+            $dbh->selectcol_arrayref('SELECT DISTINCT whine_events.subject
+                                                 FROM whine_events
+                                           INNER JOIN whine_queries
+                                                   ON whine_queries.eventid
+                                                      = whine_events.id
+                                                WHERE whine_events.owner_userid
+                                                      = ?
+                                                  AND whine_queries.query_name
+                                                      = ?
+                                      ', undef, $user->id, $qname);
+        if (scalar(@$whines_in_use)) {
+            ThrowUserError('saved_search_used_by_whines', 
+                           { subjects    => join(',', @$whines_in_use),
+                             search_name => $qname                      }
+            );
+        }
+
+        # If we are here, then we can safely remove the saved search
+        my $query_id;
+        ($buffer, $query_id) = LookupNamedQuery(scalar $cgi->param("namedcmd"),
+                                                $user->id);
+        if ($query_id) {
+            # Make sure the user really wants to delete his saved search.
+            my $token = $cgi->param('token');
+            check_hash_token($token, [$query_id, $qname]);
+
+            $dbh->do('DELETE FROM namedqueries
+                            WHERE id = ?',
+                     undef, $query_id);
+            $dbh->do('DELETE FROM namedqueries_link_in_footer
+                            WHERE namedquery_id = ?',
+                     undef, $query_id);
+            $dbh->do('DELETE FROM namedquery_group_map
+                            WHERE namedquery_id = ?',
+                     undef, $query_id);
+        }
+
+        # Now reset the cached queries
+        $user->flush_queries_cache();
+
+        print $cgi->header();
+        # Generate and return the UI (HTML page) from the appropriate template.
+        $vars->{'message'} = "buglist_query_gone";
+        $vars->{'namedcmd'} = $qname;
+        $vars->{'url'} = "buglist.cgi?newquery=" . url_quote($buffer)
+                         . "&cmdtype=doit&remtype=asnamed&newqueryname=" . url_quote($qname)
+                         . "&token=" . url_quote(issue_hash_token(['savedsearch']));
+        $template->process("global/message.html.tmpl", $vars)
+          || ThrowTemplateError($template->error());
+        exit;
+    }
+}
+elsif (($cmdtype eq "doit") && defined $cgi->param('remtype')) {
+    if ($cgi->param('remtype') eq "asdefault") {
+        $user = Bugzilla->login(LOGIN_REQUIRED);
+        my $token = $cgi->param('token');
+        check_hash_token($token, ['searchknob']);
+        $buffer = $params->canonicalise_query('cmdtype', 'remtype',
+                                              'query_based_on', 'token');
+        InsertNamedQuery(DEFAULT_QUERY_NAME, $buffer);
+        $vars->{'message'} = "buglist_new_default_query";
+    }
+    elsif ($cgi->param('remtype') eq "asnamed") {
+        $user = Bugzilla->login(LOGIN_REQUIRED);
+        my $query_name = $cgi->param('newqueryname');
+        my $new_query = $cgi->param('newquery');
+        my $token = $cgi->param('token');
+        check_hash_token($token, ['savedsearch']);
+        my $existed_before = InsertNamedQuery($query_name, $new_query, 1);
+        if ($existed_before) {
+            $vars->{'message'} = "buglist_updated_named_query";
+        }
+        else {
+            $vars->{'message'} = "buglist_new_named_query";
+        }
+        $vars->{'queryname'} = $query_name;
+
+        # Make sure to invalidate any cached query data, so that the footer is
+        # correctly displayed
+        $user->flush_queries_cache();
+
+        print $cgi->header();
+        $template->process("global/message.html.tmpl", $vars)
+          || ThrowTemplateError($template->error());
+        exit;
+    }
+}
+
+# backward compatibility hack: if the saved query doesn't say which
+# form was used to create it, assume it was on the advanced query
+# form - see bug 252295
+if (!$params->param('query_format')) {
+    $params->param('query_format', 'advanced');
+    $buffer = $params->query_string;
+}
+
+################################################################################
+# Column Definition
+################################################################################
+
+my $columns = Bugzilla::Search::COLUMNS;
+
+################################################################################
+# Display Column Determination
+################################################################################
+
+# Determine the columns that will be displayed in the bug list via the 
+# columnlist CGI parameter, the user's preferences, or the default.
+my @displaycolumns = ();
+if (defined $params->param('columnlist')) {
+    if ($params->param('columnlist') eq "all") {
+        # If the value of the CGI parameter is "all", display all columns,
+        # but remove the redundant "short_desc" column.
+        @displaycolumns = grep($_ ne 'short_desc', keys(%$columns));
+    }
+    else {
+        @displaycolumns = split(/[ ,]+/, $params->param('columnlist'));
+    }
+}
+elsif (defined $cgi->cookie('COLUMNLIST')) {
+    # 2002-10-31 Rename column names (see bug 176461)
+    my $columnlist = $cgi->cookie('COLUMNLIST');
+    $columnlist =~ s/\bowner\b/assigned_to/;
+    $columnlist =~ s/\bowner_realname\b/assigned_to_realname/;
+    $columnlist =~ s/\bplatform\b/rep_platform/;
+    $columnlist =~ s/\bseverity\b/bug_severity/;
+    $columnlist =~ s/\bstatus\b/bug_status/;
+    $columnlist =~ s/\bsummaryfull\b/short_desc/;
+    $columnlist =~ s/\bsummary\b/short_short_desc/;
+
+    # Use the columns listed in the user's preferences.
+    @displaycolumns = split(/ /, $columnlist);
+}
+else {
+    # Use the default list of columns.
+    @displaycolumns = DEFAULT_COLUMN_LIST;
+}
+
+# Weed out columns that don't actually exist to prevent the user 
+# from hacking their column list cookie to grab data to which they 
+# should not have access.  Detaint the data along the way.
+@displaycolumns = grep($columns->{$_} && trick_taint($_), @displaycolumns);
+
+# Remove the "ID" column from the list because bug IDs are always displayed
+# and are hard-coded into the display templates.
+@displaycolumns = grep($_ ne 'bug_id', @displaycolumns);
+
+# Remove the timetracking columns if they are not a part of the group
+# (happens if a user had access to time tracking and it was revoked/disabled)
+if (!$user->is_timetracker) {
+   @displaycolumns = grep($_ ne 'estimated_time', @displaycolumns);
+   @displaycolumns = grep($_ ne 'remaining_time', @displaycolumns);
+   @displaycolumns = grep($_ ne 'actual_time', @displaycolumns);
+   @displaycolumns = grep($_ ne 'percentage_complete', @displaycolumns);
+   @displaycolumns = grep($_ ne 'deadline', @displaycolumns);
+}
+
+# Remove the relevance column if the user is not doing a fulltext search.
+if (grep('relevance', @displaycolumns) && !$fulltext) {
+    @displaycolumns = grep($_ ne 'relevance', @displaycolumns);
+}
+
+
+################################################################################
+# Select Column Determination
+################################################################################
+
+# Generate the list of columns that will be selected in the SQL query.
+
+# The bug ID is always selected because bug IDs are always displayed.
+# Severity, priority, resolution and status are required for buglist
+# CSS classes.
+my @selectcolumns = ("bug_id", "bug_severity", "priority", "bug_status",
+                     "resolution", "product");
+
+# remaining and actual_time are required for percentage_complete calculation:
+if (grep { $_ eq "percentage_complete" } @displaycolumns) {
+    push (@selectcolumns, "remaining_time");
+    push (@selectcolumns, "actual_time");
+}
+
+# Make sure that the login_name version of a field is always also
+# requested if the realname version is requested, so that we can
+# display the login name when the realname is empty.
+my @realname_fields = grep(/_realname$/, @displaycolumns);
+foreach my $item (@realname_fields) {
+    my $login_field = $item;
+    $login_field =~ s/_realname$//;
+    if (!grep($_ eq $login_field, @selectcolumns)) {
+        push(@selectcolumns, $login_field);
+    }
+}
+
+# Display columns are selected because otherwise we could not display them.
+foreach my $col (@displaycolumns) {
+    push (@selectcolumns, $col) if !grep($_ eq $col, @selectcolumns);
+}
+
+# If the user is editing multiple bugs, we also make sure to select the 
+# status, because the values of that field determines what options the user
+# has for modifying the bugs.
+if ($dotweak) {
+    push(@selectcolumns, "bug_status") if !grep($_ eq 'bug_status', @selectcolumns);
+}
+
+if ($format->{'extension'} eq 'ics') {
+    push(@selectcolumns, "opendate") if !grep($_ eq 'opendate', @selectcolumns);
+}
+
+if ($format->{'extension'} eq 'atom') {
+    # The title of the Atom feed will be the same one as for the bug list.
+    $vars->{'title'} = $cgi->param('title');
+
+    # This is the list of fields that are needed by the Atom filter.
+    my @required_atom_columns = (
+      'short_desc',
+      'opendate',
+      'changeddate',
+      'reporter',
+      'reporter_realname',
+      'priority',
+      'bug_severity',
+      'assigned_to',
+      'assigned_to_realname',
+      'bug_status',
+      'product',
+      'component',
+      'resolution'
+    );
+    push(@required_atom_columns, 'target_milestone') if Bugzilla->params->{'usetargetmilestone'};
+
+    foreach my $required (@required_atom_columns) {
+        push(@selectcolumns, $required) if !grep($_ eq $required,@selectcolumns);
+    }
+}
+
+################################################################################
+# Sort Order Determination
+################################################################################
+
+# Add to the query some instructions for sorting the bug list.
+
+# First check if we'll want to reuse the last sorting order; that happens if
+# the order is not defined or its value is "reuse last sort"
+if (!$order || $order =~ /^reuse/i) {
+    if ($cgi->cookie('LASTORDER')) {
+        $order = $cgi->cookie('LASTORDER');
+       
+        # Cookies from early versions of Specific Search included this text,
+        # which is now invalid.
+        $order =~ s/ LIMIT 200//;
+    }
+    else {
+        $order = '';  # Remove possible "reuse" identifier as unnecessary
+    }
+}
+
+my @order_columns;
+if ($order) {
+    # Convert the value of the "order" form field into a list of columns
+    # by which to sort the results.
+    ORDER: for ($order) {
+        /^Bug Number$/ && do {
+            @order_columns = ("bug_id");
+            last ORDER;
+        };
+        /^Importance$/ && do {
+            @order_columns = ("priority", "bug_severity");
+            last ORDER;
+        };
+        /^Assignee$/ && do {
+            @order_columns = ("assigned_to", "bug_status", "priority",
+                              "bug_id");
+            last ORDER;
+        };
+        /^Last Changed$/ && do {
+            @order_columns = ("changeddate", "bug_status", "priority",
+                              "assigned_to", "bug_id");
+            last ORDER;
+        };
+        do {
+            # A custom list of columns. Bugzilla::Search will validate items.
+            @order_columns = split(/\s*,\s*/, $order);
+        };
+    }
+}
+
+if (!scalar @order_columns) {
+    # DEFAULT
+    @order_columns = ("bug_status", "priority", "assigned_to", "bug_id");
+}
+
+# In the HTML interface, by default, we limit the returned results,
+# which speeds up quite a few searches where people are really only looking
+# for the top results.
+if ($format->{'extension'} eq 'html' && !defined $params->param('limit')) {
+    $params->param('limit', Bugzilla->params->{'default_search_limit'});
+    $vars->{'default_limited'} = 1;
+}
+
+# Generate the basic SQL query that will be used to generate the bug list.
+my $search = new Bugzilla::Search('fields' => \@selectcolumns, 
+                                  'params' => scalar $params->Vars,
+                                  'order'  => \@order_columns,
+                                  'sharer' => $sharer_id);
+
+$order = join(',', $search->order);
+
+if (scalar @{$search->invalid_order_columns}) {
+    $vars->{'message'} = 'invalid_column_name';
+    $vars->{'invalid_fragments'} = $search->invalid_order_columns;
+}
+
+if ($fulltext and grep { /^relevance/ } $search->order) {
+    $vars->{'message'} = 'buglist_sorted_by_relevance'
+}
+
+# We don't want saved searches and other buglist things to save
+# our default limit.
+$params->delete('limit') if $vars->{'default_limited'};
+
+################################################################################
+# Query Execution
+################################################################################
+
+# Time to use server push to display an interim message to the user until
+# the query completes and we can display the bug list.
+if ($serverpush) {
+    print $cgi->multipart_init();
+    print $cgi->multipart_start(-type => 'text/html');
+
+    # Generate and return the UI (HTML page) from the appropriate template.
+    $template->process("list/server-push.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+
+    # Under mod_perl, flush stdout so that the page actually shows up.
+    if ($ENV{MOD_PERL}) {
+        require Apache2::RequestUtil;
+        Apache2::RequestUtil->request->rflush();
+    }
+
+    # Don't do multipart_end() until we're ready to display the replacement
+    # page, otherwise any errors that happen before then (like SQL errors)
+    # will result in a blank page being shown to the user instead of the error.
+}
+
+# Connect to the shadow database if this installation is using one to improve
+# query performance.
+$dbh = Bugzilla->switch_to_shadow_db();
+
+# Normally, we ignore SIGTERM and SIGPIPE, but we need to
+# respond to them here to prevent someone DOSing us by reloading a query
+# a large number of times.
+$::SIG{TERM} = 'DEFAULT';
+$::SIG{PIPE} = 'DEFAULT';
+
+# Execute the query.
+my ($data, $extra_data) = $search->data;
+$vars->{'search_description'} = $search->search_description;
+
+if ($cgi->param('debug')
+    && Bugzilla->params->{debug_group}
+    && $user->in_group(Bugzilla->params->{debug_group})
+) {
+    $vars->{'debug'} = 1;
+    $vars->{'queries'} = $extra_data;
+    my $query_time = 0;
+    $query_time += $_->{'time'} foreach @$extra_data;
+    $vars->{'query_time'} = $query_time;
+    # Explains are limited to admins because you could use them to figure
+    # out how many hidden bugs are in a particular product (by doing
+    # searches and looking at the number of rows the explain says it's
+    # examining).
+    if ($user->in_group('admin')) {
+        foreach my $query (@$extra_data) {
+            $query->{explain} = $dbh->bz_explain($query->{sql});
+        }
+    }
+}
+
+################################################################################
+# Results Retrieval
+################################################################################
+
+# Retrieve the query results one row at a time and write the data into a list
+# of Perl records.
+
+# If we're doing time tracking, then keep totals for all bugs.
+my $percentage_complete = grep($_ eq 'percentage_complete', @displaycolumns);
+my $estimated_time      = grep($_ eq 'estimated_time', @displaycolumns);
+my $remaining_time      = grep($_ eq 'remaining_time', @displaycolumns)
+                            || $percentage_complete;
+my $actual_time         = grep($_ eq 'actual_time', @displaycolumns)
+                            || $percentage_complete;
+
+my $time_info = { 'estimated_time' => 0,
+                  'remaining_time' => 0,
+                  'actual_time' => 0,
+                  'percentage_complete' => 0,
+                  'time_present' => ($estimated_time || $remaining_time ||
+                                     $actual_time || $percentage_complete),
+                };
+    
+my $bugowners = {};
+my $bugproducts = {};
+my $bugstatuses = {};
+my @bugidlist;
+
+my @bugs; # the list of records
+
+foreach my $row (@$data) {
+    my $bug = {}; # a record
+
+    # Slurp the row of data into the record.
+    # The second from last column in the record is the number of groups
+    # to which the bug is restricted.
+    foreach my $column (@selectcolumns) {
+        $bug->{$column} = shift @$row;
+    }
+
+    # Process certain values further (i.e. date format conversion).
+    if ($bug->{'changeddate'}) {
+        $bug->{'changeddate'} =~ 
+            s/^(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})$/$1-$2-$3 $4:$5:$6/;
+
+        $bug->{'changedtime'} = $bug->{'changeddate'}; # for iCalendar and Atom
+        $bug->{'changeddate'} = DiffDate($bug->{'changeddate'});
+    }
+
+    if ($bug->{'opendate'}) {
+        $bug->{'opentime'} = $bug->{'opendate'}; # for iCalendar
+        $bug->{'opendate'} = DiffDate($bug->{'opendate'});
+    }
+
+    # Record the assignee, product, and status in the big hashes of those things.
+    $bugowners->{$bug->{'assigned_to'}} = 1 if $bug->{'assigned_to'};
+    $bugproducts->{$bug->{'product'}} = 1 if $bug->{'product'};
+    $bugstatuses->{$bug->{'bug_status'}} = 1 if $bug->{'bug_status'};
+
+    $bug->{'secure_mode'} = undef;
+
+    # Add the record to the list.
+    push(@bugs, $bug);
+
+    # Add id to list for checking for bug privacy later
+    push(@bugidlist, $bug->{'bug_id'});
+
+    # Compute time tracking info.
+    $time_info->{'estimated_time'} += $bug->{'estimated_time'} if ($estimated_time);
+    $time_info->{'remaining_time'} += $bug->{'remaining_time'} if ($remaining_time);
+    $time_info->{'actual_time'}    += $bug->{'actual_time'}    if ($actual_time);
+}
+
+# Check for bug privacy and set $bug->{'secure_mode'} to 'implied' or 'manual'
+# based on whether the privacy is simply product implied (by mandatory groups)
+# or because of human choice
+my %min_membercontrol;
+if (@bugidlist) {
+    my $sth = $dbh->prepare(
+        "SELECT DISTINCT bugs.bug_id, MIN(group_control_map.membercontrol) " .
+          "FROM bugs " .
+    "INNER JOIN bug_group_map " .
+            "ON bugs.bug_id = bug_group_map.bug_id " .
+     "LEFT JOIN group_control_map " .
+            "ON group_control_map.product_id = bugs.product_id " .
+           "AND group_control_map.group_id = bug_group_map.group_id " .
+         "WHERE " . $dbh->sql_in('bugs.bug_id', \@bugidlist) . 
+            $dbh->sql_group_by('bugs.bug_id'));
+    $sth->execute();
+    while (my ($bug_id, $min_membercontrol) = $sth->fetchrow_array()) {
+        $min_membercontrol{$bug_id} = $min_membercontrol || CONTROLMAPNA;
+    }
+    foreach my $bug (@bugs) {
+        next unless defined($min_membercontrol{$bug->{'bug_id'}});
+        if ($min_membercontrol{$bug->{'bug_id'}} == CONTROLMAPMANDATORY) {
+            $bug->{'secure_mode'} = 'implied';
+        }
+        else {
+            $bug->{'secure_mode'} = 'manual';
+        }
+    }
+}
+
+# Compute percentage complete without rounding.
+my $sum = $time_info->{'actual_time'}+$time_info->{'remaining_time'};
+if ($sum > 0) {
+    $time_info->{'percentage_complete'} = 100*$time_info->{'actual_time'}/$sum;
+}
+else { # remaining_time <= 0 
+    $time_info->{'percentage_complete'} = 0
+}                             
+
+################################################################################
+# Template Variable Definition
+################################################################################
+
+# Define the variables and functions that will be passed to the UI template.
+
+$vars->{'bugs'} = \@bugs;
+$vars->{'buglist'} = \@bugidlist;
+$vars->{'buglist_joined'} = join(',', @bugidlist);
+$vars->{'columns'} = $columns;
+$vars->{'displaycolumns'} = \@displaycolumns;
+
+$vars->{'openstates'} = [BUG_STATE_OPEN];
+$vars->{'closedstates'} = [map {$_->name} closed_bug_statuses()];
+
+# The iCal file needs priorities ordered from 1 to 9 (highest to lowest)
+# If there are more than 9 values, just make all the lower ones 9
+if ($format->{'extension'} eq 'ics') {
+    my $n = 1;
+    $vars->{'ics_priorities'} = {};
+    my $priorities = get_legal_field_values('priority');
+    foreach my $p (@$priorities) {
+        $vars->{'ics_priorities'}->{$p} = ($n > 9) ? 9 : $n++;
+    }
+}
+
+$vars->{'order'} = $order;
+$vars->{'caneditbugs'} = 1;
+$vars->{'time_info'} = $time_info;
+
+if (!$user->in_group('editbugs')) {
+    foreach my $product (keys %$bugproducts) {
+        my $prod = new Bugzilla::Product({name => $product});
+        if (!$user->in_group('editbugs', $prod->id)) {
+            $vars->{'caneditbugs'} = 0;
+            last;
+        }
+    }
+}
+
+my @bugowners = keys %$bugowners;
+if (scalar(@bugowners) > 1 && $user->in_group('editbugs')) {
+    my $suffix = Bugzilla->params->{'emailsuffix'};
+    map(s/$/$suffix/, @bugowners) if $suffix;
+    my $bugowners = join(",", @bugowners);
+    $vars->{'bugowners'} = $bugowners;
+}
+
+# Whether or not to split the column titles across two rows to make
+# the list more compact.
+$vars->{'splitheader'} = $cgi->cookie('SPLITHEADER') ? 1 : 0;
+
+$vars->{'quip'} = GetQuip();
+$vars->{'currenttime'} = localtime(time());
+
+# See if there's only one product in all the results (or only one product
+# that we searched for), which allows us to provide more helpful links.
+my @products = keys %$bugproducts;
+my $one_product;
+if (scalar(@products) == 1) {
+    $one_product = new Bugzilla::Product({ name => $products[0] });
+}
+# This is used in the "Zarroo Boogs" case.
+elsif (my @product_input = $cgi->param('product')) {
+    if (scalar(@product_input) == 1 and $product_input[0] ne '') {
+        $one_product = new Bugzilla::Product({ name => $cgi->param('product') });
+    }
+}
+# We only want the template to use it if the user can actually 
+# enter bugs against it.
+if ($one_product && $user->can_enter_product($one_product)) {
+    $vars->{'one_product'} = $one_product;
+}
+
+# The following variables are used when the user is making changes to multiple bugs.
+if ($dotweak && scalar @bugs) {
+    if (!$vars->{'caneditbugs'}) {
+        _close_standby_message('text/html', 'inline', $serverpush);
+        ThrowUserError('auth_failure', {group  => 'editbugs',
+                                        action => 'modify',
+                                        object => 'multiple_bugs'});
+    }
+    $vars->{'dotweak'} = 1;
+  
+    # issue_session_token needs to write to the master DB.
+    Bugzilla->switch_to_main_db();
+    $vars->{'token'} = issue_session_token('buglist_mass_change');
+    Bugzilla->switch_to_shadow_db();
+
+    $vars->{'products'} = $user->get_enterable_products;
+    $vars->{'platforms'} = get_legal_field_values('rep_platform');
+    $vars->{'op_sys'} = get_legal_field_values('op_sys');
+    $vars->{'priorities'} = get_legal_field_values('priority');
+    $vars->{'severities'} = get_legal_field_values('bug_severity');
+    $vars->{'resolutions'} = get_legal_field_values('resolution');
+
+    # Convert bug statuses to their ID.
+    my @bug_statuses = map {$dbh->quote($_)} keys %$bugstatuses;
+    my $bug_status_ids =
+      $dbh->selectcol_arrayref('SELECT id FROM bug_status
+                               WHERE ' . $dbh->sql_in('value', \@bug_statuses));
+
+    # This query collects new statuses which are common to all current bug statuses.
+    # It also accepts transitions where the bug status doesn't change.
+    $bug_status_ids =
+      $dbh->selectcol_arrayref(
+            'SELECT DISTINCT sw1.new_status
+               FROM status_workflow sw1
+         INNER JOIN bug_status
+                 ON bug_status.id = sw1.new_status
+              WHERE bug_status.isactive = 1
+                AND NOT EXISTS 
+                   (SELECT * FROM status_workflow sw2
+                     WHERE sw2.old_status != sw1.new_status 
+                           AND '
+                         . $dbh->sql_in('sw2.old_status', $bug_status_ids)
+                         . ' AND NOT EXISTS 
+                           (SELECT * FROM status_workflow sw3
+                             WHERE sw3.new_status = sw1.new_status
+                                   AND sw3.old_status = sw2.old_status))');
+
+    $vars->{'current_bug_statuses'} = [keys %$bugstatuses];
+    $vars->{'new_bug_statuses'} = Bugzilla::Status->new_from_list($bug_status_ids);
+
+    # The groups the user belongs to and which are editable for the given buglist.
+    $vars->{'groups'} = GetGroups(\@products);
+
+    # If all bugs being changed are in the same product, the user can change
+    # their version and component, so generate a list of products, a list of
+    # versions for the product (if there is only one product on the list of
+    # products), and a list of components for the product.
+    if ($one_product) {
+        $vars->{'versions'} = [map($_->name, grep($_->is_active, @{ $one_product->versions }))];
+        $vars->{'components'} = [map($_->name, grep($_->is_active, @{ $one_product->components }))];
+        if (Bugzilla->params->{'usetargetmilestone'}) {
+            $vars->{'targetmilestones'} = [map($_->name, grep($_->is_active,  
+                                               @{ $one_product->milestones }))];
+        }
+    }
+}
+
+# If we're editing a stored query, use the existing query name as default for
+# the "Remember search as" field.
+$vars->{'defaultsavename'} = $cgi->param('query_based_on');
+
+# If we did a quick search then redisplay the previously entered search 
+# string in the text field.
+$vars->{'quicksearch'} = $searchstring;
+
+################################################################################
+# HTTP Header Generation
+################################################################################
+
+# Generate HTTP headers
+
+my $contenttype;
+my $disposition = "inline";
+
+if ($format->{'extension'} eq "html") {
+    my $list_id = $cgi->param('list_id') || $cgi->param('regetlastlist');
+    my $search = $user->save_last_search(
+        { bugs => \@bugidlist, order => $order, vars => $vars, list_id => $list_id });
+    $cgi->param('list_id', $search->id) if $search;
+    $contenttype = "text/html";
+}
+else {
+    $contenttype = $format->{'ctype'};
+}
+
+# Set 'urlquerypart' once the buglist ID is known.
+$vars->{'urlquerypart'} = $params->canonicalise_query('order', 'cmdtype',
+                                                      'query_based_on',
+                                                      'token');
+
+if ($format->{'extension'} eq "csv") {
+    # We set CSV files to be downloaded, as they are designed for importing
+    # into other programs.
+    $disposition = "attachment";
+
+    # If the user clicked the CSV link in the search results,
+    # They should get the Field Description, not the column name in the db
+    $vars->{'human'} = $cgi->param('human');
+}
+
+# Suggest a name for the bug list if the user wants to save it as a file.
+$disposition .= "; filename=\"$filename\"";
+
+_close_standby_message($contenttype, $disposition, $serverpush);
+
+################################################################################
+# Content Generation
+################################################################################
+
+# Generate and return the UI (HTML page) from the appropriate template.
+$template->process($format->{'template'}, $vars)
+  || ThrowTemplateError($template->error());
+
+
+################################################################################
+# Script Conclusion
+################################################################################
+
+print $cgi->multipart_final() if $serverpush;

diff --git a/chart.cgi b/chart.cgi
new file mode 100755 (executable)
index 0000000..7f21fd0
--- /dev/null
+++ b/chart.cgi
@@ -0,0 +1,355 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# Glossary:
+# series:   An individual, defined set of data plotted over time.
+# data set: What a series is called in the UI.
+# line:     A set of one or more series, to be summed and drawn as a single
+#           line when the series is plotted.
+# chart:    A set of lines
+#
+# So when you select rows in the UI, you are selecting one or more lines, not
+# series.
+
+# Generic Charting TODO:
+#
+# JS-less chart creation - hard.
+# Broken image on error or no data - need to do much better.
+# Centralise permission checking, so Bugzilla->user->in_group('editbugs')
+#   not scattered everywhere.
+# User documentation :-)
+#
+# Bonus:
+# Offer subscription when you get a "series already exists" error?
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::CGI;
+use Bugzilla::Error;
+use Bugzilla::Util;
+use Bugzilla::Chart;
+use Bugzilla::Series;
+use Bugzilla::User;
+use Bugzilla::Token;
+
+# For most scripts we don't make $cgi and $template global variables. But
+# when preparing Bugzilla for mod_perl, this script used these
+# variables in so many subroutines that it was easier to just
+# make them globals.
+local our $cgi = Bugzilla->cgi;
+local our $template = Bugzilla->template;
+local our $vars = {};
+my $dbh = Bugzilla->dbh;
+
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+if (!Bugzilla->feature('new_charts')) {
+    ThrowUserError('feature_disabled', { feature => 'new_charts' });
+}
+
+# Go back to query.cgi if we are adding a boolean chart parameter.
+if (grep(/^cmd-/, $cgi->param())) {
+    my $params = $cgi->canonicalise_query("format", "ctype", "action");
+    print $cgi->redirect("query.cgi?format=" . $cgi->param('query_format') .
+                                               ($params ? "&$params" : ""));
+    exit;
+}
+
+my $action = $cgi->param('action');
+my $series_id = $cgi->param('series_id');
+$vars->{'doc_section'} = 'reporting.html#charts';
+
+# Because some actions are chosen by buttons, we can't encode them as the value
+# of the action param, because that value is localization-dependent. So, we
+# encode it in the name, as "action-<action>". Some params even contain the
+# series_id they apply to (e.g. subscribe, unsubscribe).
+my @actions = grep(/^action-/, $cgi->param());
+if ($actions[0] && $actions[0] =~ /^action-([^\d]+)(\d*)$/) {
+    $action = $1;
+    $series_id = $2 if $2;
+}
+
+$action ||= "assemble";
+
+# Go to buglist.cgi if we are doing a search.
+if ($action eq "search") {
+    my $params = $cgi->canonicalise_query("format", "ctype", "action");
+    print $cgi->redirect("buglist.cgi" . ($params ? "?$params" : ""));
+    exit;
+}
+
+$user->in_group(Bugzilla->params->{"chartgroup"})
+  || ThrowUserError("auth_failure", {group  => Bugzilla->params->{"chartgroup"},
+                                     action => "use",
+                                     object => "charts"});
+
+# Only admins may create public queries
+$user->in_group('admin') || $cgi->delete('public');
+
+# All these actions relate to chart construction.
+if ($action =~ /^(assemble|add|remove|sum|subscribe|unsubscribe)$/) {
+    # These two need to be done before the creation of the Chart object, so
+    # that the changes they make will be reflected in it.
+    if ($action =~ /^subscribe|unsubscribe$/) {
+        detaint_natural($series_id) || ThrowCodeError("invalid_series_id");
+        my $series = new Bugzilla::Series($series_id);
+        $series->$action($user->id);
+    }
+
+    my $chart = new Bugzilla::Chart($cgi);
+
+    if ($action =~ /^remove|sum$/) {
+        $chart->$action(getSelectedLines());
+    }
+    elsif ($action eq "add") {
+        my @series_ids = getAndValidateSeriesIDs();
+        $chart->add(@series_ids);
+    }
+
+    view($chart);
+}
+elsif ($action eq "plot") {
+    plot();
+}
+elsif ($action eq "wrap") {
+    # For CSV "wrap", we go straight to "plot".
+    if ($cgi->param('ctype') && $cgi->param('ctype') eq "csv") {
+        plot();
+    }
+    else {
+        wrap();
+    }
+}
+elsif ($action eq "create") {
+    assertCanCreate($cgi);
+    my $token = $cgi->param('token');
+    check_hash_token($token, ['create-series']);
+    
+    my $series = new Bugzilla::Series($cgi);
+
+    ThrowUserError("series_already_exists", {'series' => $series})
+      if $series->existsInDatabase;
+
+    $series->writeToDatabase();
+    $vars->{'message'} = "series_created";
+    $vars->{'series'} = $series;
+
+    my $chart = new Bugzilla::Chart($cgi);
+    view($chart);
+}
+elsif ($action eq "edit") {
+    my $series = assertCanEdit($series_id);
+    edit($series);
+}
+elsif ($action eq "alter") {
+    my $series = assertCanEdit($series_id);
+    my $token = $cgi->param('token');
+    check_hash_token($token, [$series->id, $series->name]);
+    # XXX - This should be replaced by $series->set_foo() methods.
+    $series = new Bugzilla::Series($cgi);
+
+    # We need to check if there is _another_ series in the database with
+    # our (potentially new) name. So we call existsInDatabase() to see if
+    # the return value is us or some other series we need to avoid stomping
+    # on.
+    my $id_of_series_in_db = $series->existsInDatabase();
+    if (defined($id_of_series_in_db) && 
+        $id_of_series_in_db != $series->{'series_id'}) 
+    {
+        ThrowUserError("series_already_exists", {'series' => $series});
+    }
+    
+    $series->writeToDatabase();
+    $vars->{'changes_saved'} = 1;
+    
+    edit($series);
+}
+elsif ($action eq "confirm-delete") {
+    $vars->{'series'} = assertCanEdit($series_id);
+
+    print $cgi->header();
+    $template->process("reports/delete-series.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+}
+elsif ($action eq "delete") {
+    my $series = assertCanEdit($series_id);
+    my $token = $cgi->param('token');
+    check_hash_token($token, [$series->id, $series->name]);
+
+    $dbh->bz_start_transaction();
+
+    $series->remove_from_db();
+    # Remove (sub)categories which no longer have any series.
+    foreach my $cat (qw(category subcategory)) {
+        my $is_used = $dbh->selectrow_array("SELECT COUNT(*) FROM series WHERE $cat = ?",
+                                             undef, $series->{"${cat}_id"});
+        if (!$is_used) {
+            $dbh->do('DELETE FROM series_categories WHERE id = ?',
+                      undef, $series->{"${cat}_id"});
+        }
+    }
+    $dbh->bz_commit_transaction();
+
+    $vars->{'message'} = "series_deleted";
+    $vars->{'series'} = $series;
+    view();
+}
+elsif ($action eq "convert_search") {
+    my $saved_search = $cgi->param('series_from_search') || '';
+    my ($query) = grep { $_->name eq $saved_search } @{ $user->queries };
+    my $url = '';
+    if ($query) {
+        my $params = new Bugzilla::CGI($query->edit_link);
+        # These two parameters conflict with the one below.
+        $url = $params->canonicalise_query('format', 'query_format');
+        $url = '&amp;' . html_quote($url);
+    }
+    print $cgi->redirect(-location => correct_urlbase() . "query.cgi?format=create-series$url");
+}
+else {
+    ThrowUserError('unknown_action', {action => $action});
+}
+
+exit;
+
+# Find any selected series and return either the first or all of them.
+sub getAndValidateSeriesIDs {
+    my @series_ids = grep(/^\d+$/, $cgi->param("name"));
+
+    return wantarray ? @series_ids : $series_ids[0];
+}
+
+# Return a list of IDs of all the lines selected in the UI.
+sub getSelectedLines {
+    my @ids = map { /^select(\d+)$/ ? $1 : () } $cgi->param();
+
+    return @ids;
+}
+
+# Check if the user is the owner of series_id or is an admin. 
+sub assertCanEdit {
+    my $series_id = shift;
+    my $user = Bugzilla->user;
+
+    my $series = new Bugzilla::Series($series_id)
+      || ThrowCodeError('invalid_series_id');
+
+    if (!$user->in_group('admin') && $series->{creator_id} != $user->id) {
+        ThrowUserError('illegal_series_edit');
+    }
+
+    return $series;
+}
+
+# Check if the user is permitted to create this series with these parameters.
+sub assertCanCreate {
+    my ($cgi) = shift;
+    my $user = Bugzilla->user;
+
+    $user->in_group("editbugs") || ThrowUserError("illegal_series_creation");
+
+    # Check permission for frequency
+    my $min_freq = 7;
+    if ($cgi->param('frequency') < $min_freq && !$user->in_group("admin")) {
+        ThrowUserError("illegal_frequency", { 'minimum' => $min_freq });
+    }
+}
+
+sub validateWidthAndHeight {
+    $vars->{'width'} = $cgi->param('width');
+    $vars->{'height'} = $cgi->param('height');
+
+    if (defined($vars->{'width'})) {
+       (detaint_natural($vars->{'width'}) && $vars->{'width'} > 0)
+         || ThrowUserError("invalid_dimensions");
+    }
+
+    if (defined($vars->{'height'})) {
+       (detaint_natural($vars->{'height'}) && $vars->{'height'} > 0)
+         || ThrowUserError("invalid_dimensions");
+    }
+
+    # The equivalent of 2000 square seems like a very reasonable maximum size.
+    # This is merely meant to prevent accidental or deliberate DOS, and should
+    # have no effect in practice.
+    if ($vars->{'width'} && $vars->{'height'}) {
+       (($vars->{'width'} * $vars->{'height'}) <= 4000000)
+         || ThrowUserError("chart_too_large");
+    }
+}
+
+sub edit {
+    my $series = shift;
+
+    $vars->{'category'} = Bugzilla::Chart::getVisibleSeries();
+    $vars->{'default'} = $series;
+
+    print $cgi->header();
+    $template->process("reports/edit-series.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+}
+
+sub plot {
+    validateWidthAndHeight();
+    $vars->{'chart'} = new Bugzilla::Chart($cgi);
+
+    my $format = $template->get_format("reports/chart", "", scalar($cgi->param('ctype')));
+
+    # Debugging PNGs is a pain; we need to be able to see the error messages
+    if ($cgi->param('debug')) {
+        print $cgi->header();
+        $vars->{'chart'}->dump();
+    }
+
+    print $cgi->header($format->{'ctype'});
+    disable_utf8() if ($format->{'ctype'} =~ /^image\//);
+
+    $template->process($format->{'template'}, $vars)
+      || ThrowTemplateError($template->error());
+}
+
+sub wrap {
+    validateWidthAndHeight();
+    
+    # We create a Chart object so we can validate the parameters
+    my $chart = new Bugzilla::Chart($cgi);
+    
+    $vars->{'time'} = localtime(time());
+
+    $vars->{'imagebase'} = $cgi->canonicalise_query(
+                "action", "action-wrap", "ctype", "format", "width", "height");
+
+    print $cgi->header();
+    $template->process("reports/chart.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+}
+
+sub view {
+    my $chart = shift;
+
+    # Set defaults
+    foreach my $field ('category', 'subcategory', 'name', 'ctype') {
+        $vars->{'default'}{$field} = $cgi->param($field) || 0;
+    }
+
+    # Pass the state object to the display UI.
+    $vars->{'chart'} = $chart;
+    $vars->{'category'} = Bugzilla::Chart::getVisibleSeries();
+
+    print $cgi->header();
+
+    # If we have having problems with bad data, we can set debug=1 to dump
+    # the data structure.
+    $chart->dump() if $cgi->param('debug');
+
+    $template->process("reports/create-chart.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+}

diff --git a/checksetup.pl b/checksetup.pl
new file mode 100755 (executable)
index 0000000..bcc1ad8
--- /dev/null
+++ b/checksetup.pl
@@ -0,0 +1,495 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# This file has detailed POD docs, do "perldoc checksetup.pl" to see them.
+
+######################################################################
+# Initialization
+######################################################################
+
+use strict;
+use 5.008001;
+use File::Basename;
+use Getopt::Long qw(:config bundling);
+use Pod::Usage;
+use Safe;
+
+BEGIN { chdir dirname($0); }
+use lib qw(. lib);
+use Bugzilla::Constants;
+use Bugzilla::Install::Requirements;
+use Bugzilla::Install::Util qw(install_string get_version_and_os 
+                               init_console success);
+
+######################################################################
+# Live Code
+######################################################################
+
+# Do not run checksetup.pl from the web browser.
+Bugzilla::Install::Util::no_checksetup_from_cgi() if $ENV{'SERVER_SOFTWARE'};
+
+# When we're running at the command line, we need to pick the right
+# language before ever displaying any string.
+init_console();
+
+my %switch;
+GetOptions(\%switch, 'help|h|?', 'check-modules', 'no-templates|t',
+                     'verbose|v|no-silent', 'make-admin=s', 
+                     'reset-password=s', 'version|V');
+
+# Print the help message if that switch was selected.
+pod2usage({-verbose => 1, -exitval => 1}) if $switch{'help'};
+
+# Read in the "answers" file if it exists, for running in 
+# non-interactive mode.
+my $answers_file = $ARGV[0];
+my $silent = $answers_file && !$switch{'verbose'};
+
+print(install_string('header', get_version_and_os()) . "\n") unless $silent;
+exit if $switch{'version'};
+# Check required --MODULES--
+my $module_results = check_requirements(!$silent);
+Bugzilla::Install::Requirements::print_module_instructions(
+    $module_results, !$silent);
+exit if !$module_results->{pass};
+# Break out if checking the modules is all we have been asked to do.
+exit if $switch{'check-modules'};
+
+###########################################################################
+# Load Bugzilla Modules
+###########################################################################
+
+# It's never safe to "use" a Bugzilla module in checksetup. If a module
+# prerequisite is missing, and you "use" a module that requires it,
+# then instead of our nice normal checksetup message, the user would
+# get a cryptic perl error about the missing module.
+
+require Bugzilla;
+require Bugzilla::User;
+
+require Bugzilla::Util;
+import Bugzilla::Util qw(get_text);
+
+require Bugzilla::Config;
+import Bugzilla::Config qw(:admin);
+
+require Bugzilla::Install::Localconfig;
+import Bugzilla::Install::Localconfig qw(update_localconfig);
+
+require Bugzilla::Install::Filesystem;
+import Bugzilla::Install::Filesystem qw(update_filesystem create_htaccess
+                                        fix_all_file_permissions);
+require Bugzilla::Install::DB;
+require Bugzilla::DB;
+require Bugzilla::Template;
+require Bugzilla::Field;
+require Bugzilla::Install;
+
+Bugzilla->installation_mode(INSTALLATION_MODE_NON_INTERACTIVE) if $answers_file;
+Bugzilla->installation_answers($answers_file);
+
+###########################################################################
+# Check and update --LOCAL-- configuration
+###########################################################################
+
+print "Reading " .  bz_locations()->{'localconfig'} . "...\n" unless $silent;
+update_localconfig({ output => !$silent });
+my $lc_hash = Bugzilla->localconfig;
+
+###########################################################################
+# Check --DATABASE-- setup
+###########################################################################
+
+# At this point, localconfig is defined and is readable. So we know
+# everything we need to create the DB. We have to create it early,
+# because some data required to populate data/params is stored in the DB.
+
+Bugzilla::DB::bz_check_requirements(!$silent);
+Bugzilla::DB::bz_create_database() if $lc_hash->{'db_check'};
+
+# now get a handle to the database:
+my $dbh = Bugzilla->dbh;
+# Create the tables, and do any database-specific schema changes.
+$dbh->bz_setup_database();
+# Populate the tables that hold the values for the <select> fields.
+$dbh->bz_populate_enum_tables();
+
+###########################################################################
+# Check --DATA-- directory
+###########################################################################
+
+update_filesystem({ index_html => $lc_hash->{'index_html'} });
+create_htaccess() if $lc_hash->{'create_htaccess'};
+
+# Remove parameters from the params file that no longer exist in Bugzilla,
+# and set the defaults for new ones
+my %old_params = update_params();
+
+###########################################################################
+# Pre-compile --TEMPLATE-- code
+###########################################################################
+
+Bugzilla::Template::precompile_templates(!$silent)
+    unless $switch{'no-templates'};
+
+###########################################################################
+# Set proper rights (--CHMOD--)
+###########################################################################
+
+fix_all_file_permissions(!$silent);
+
+###########################################################################
+# Check GraphViz setup
+###########################################################################
+
+# If we are using a local 'dot' binary, verify the specified binary exists
+# and that the generated images are accessible.
+check_graphviz(!$silent) if Bugzilla->params->{'webdotbase'};
+
+###########################################################################
+# Changes to the fielddefs --TABLE--
+###########################################################################
+
+# Using Bugzilla::Field's create() or update() depends on the
+# fielddefs table having a modern definition. So, we have to make
+# these particular schema changes before we make any other schema changes.
+Bugzilla::Install::DB::update_fielddefs_definition();
+
+Bugzilla::Field::populate_field_definitions();
+
+###########################################################################
+# Update the tables to the current definition --TABLE--
+###########################################################################
+
+Bugzilla::Install::DB::update_table_definitions(\%old_params);
+Bugzilla::Install::init_workflow();
+
+###########################################################################
+# Bugzilla uses --GROUPS-- to assign various rights to its users.
+###########################################################################
+
+Bugzilla::Install::update_system_groups();
+
+# "Log In" as the fake superuser who can do everything.
+Bugzilla->set_user(Bugzilla::User->super_user);
+
+###########################################################################
+# Create --SETTINGS-- users can adjust
+###########################################################################
+
+Bugzilla::Install::update_settings();
+
+###########################################################################
+# Create Administrator  --ADMIN--
+###########################################################################
+
+Bugzilla::Install::make_admin($switch{'make-admin'}) if $switch{'make-admin'};
+Bugzilla::Install::create_admin();
+
+Bugzilla::Install::reset_password($switch{'reset-password'})
+    if $switch{'reset-password'};
+
+###########################################################################
+# Create default Product
+###########################################################################
+
+Bugzilla::Install::create_default_product();
+
+Bugzilla::Hook::process('install_before_final_checks', { silent => $silent });
+
+###########################################################################
+# Final checks
+###########################################################################
+
+# Check if the default parameter for urlbase is still set, and if so, give
+# notification that they should go and visit editparams.cgi 
+if (Bugzilla->params->{'urlbase'} eq '') {
+    print "\n" . get_text('install_urlbase_default') . "\n"
+        unless $silent;
+}
+if (!$silent) {
+    success(get_text('install_success'));
+}
+
+__END__
+
+=head1 NAME
+
+checksetup.pl - A do-it-all upgrade and installation script for Bugzilla.
+
+=head1 SYNOPSIS
+
+ ./checksetup.pl [--help|--check-modules|--version]
+ ./checksetup.pl [SCRIPT [--verbose]] [--no-templates|-t]
+                 [--make-admin=user@domain.com]
+                 [--reset-password=user@domain.com]
+
+=head1 OPTIONS
+
+=over
+
+=item F<SCRIPT>
+
+Name of script to drive non-interactive mode. This script should
+define an C<%answer> hash whose keys are variable names and the
+values answers to all the questions checksetup.pl asks. For details
+on the format of this script, do C<perldoc checksetup.pl> and look for
+the L</"RUNNING CHECKSETUP NON-INTERACTIVELY"> section.
+
+=item B<--help>
+
+Display this help text
+
+=item B<--check-modules>
+
+Only check for correct module dependencies and quit afterward.
+
+=item B<--make-admin>=username@domain.com
+
+Makes the specified user into a Bugzilla administrator. This is
+in case you accidentally lock yourself out of the Bugzilla administrative
+interface.
+
+=item B<--reset-password>=user@domain.com
+
+Resets the specified user's password. checksetup.pl will prompt you to 
+enter a new password for the user.
+
+=item B<--no-templates> (B<-t>)
+
+Don't compile the templates at all. Existing compiled templates will
+remain; missing compiled templates will not be created. (Used primarily
+by developers to speed up checksetup.) Use this switch at your own risk.
+
+=item B<--verbose>
+
+Output results of SCRIPT being processed.
+
+=item B<--version>
+
+Display the version of Bugzilla, Perl, and some info about the
+system that Bugzilla is being installed on, and then exit.
+
+=back
+
+=head1 DESCRIPTION
+
+Hey, what's this?
+
+F<checksetup.pl> is a script that is supposed to run during
+installation time and also after every upgrade.
+
+The goal of this script is to make the installation even easier.
+It does this by doing things for you as well as testing for problems
+in advance.
+
+You can run the script whenever you like. You MUST run it after
+you update Bugzilla, because it will then update your SQL table
+definitions to resync them with the code.
+
+You can see all the details of what the script does at
+L</How Checksetup Works>.
+
+=head1 MODIFYING CHECKSETUP
+
+There should be no need for Bugzilla Administrators to modify
+this script; all user-configurable stuff has been moved
+into a local configuration file called F<localconfig>. When that file
+in changed and F<checksetup.pl> is run, then the user's changes
+will be reflected back into the database.
+
+However, developers often need to modify the installation process.
+This section explains how F<checksetup.pl> works, so that you
+know the right part to modify.
+
+=head2 How Checksetup Works
+
+F<checksetup.pl> runs through several stages during installation:
+
+=over
+
+=item 1
+
+Checks if the required and optional perl modules are installed,
+using L<Bugzilla::Install::Requirements/check_requirements>.
+
+=item 2
+
+Creates or updates the F<localconfig> file, using
+L<Bugzilla::Install::Localconfig/update_localconfig>.
+
+=item 3
+
+Checks the DBD and database version, using
+L<Bugzilla::DB/bz_check_requirements>.
+
+=item 4
+
+Creates the Bugzilla database if it doesn't exist, using
+L<Bugzilla::DB/bz_create_database>.
+
+=item 5
+
+Creates all of the tables in the Bugzilla database, using
+L<Bugzilla::DB/bz_setup_database>.
+
+Note that all the table definitions are stored in
+L<Bugzilla::DB::Schema/ABSTRACT_SCHEMA>.
+
+=item 6
+
+Puts the values into the enum tables (like C<resolution>, C<bug_status>,
+etc.) using L<Bugzilla::DB/bz_populate_enum_tables>.
+
+=item 7
+
+Creates any files that Bugzilla needs but doesn't ship with, using
+L<Bugzilla::Install::Filesystem/update_filesystem>.
+
+=item 8
+
+Creates the F<.htaccess> files if you haven't specified not to
+in F<localconfig>. It does this with
+L<Bugzilla::Install::Filesystem/create_htaccess>.
+
+=item 9
+
+Updates the system parameters (stored in F<data/params>), using
+L<Bugzilla::Config/update_params>.
+
+=item 10
+
+Pre-compiles all templates, to improve the speed of Bugzilla.
+It uses L<Bugzilla::Template/precompile_templates> to do this.
+
+=item 11
+
+Fixes all file permissions to be secure. It does this differently depending
+on whether or not you've specified C<$webservergroup> in F<localconfig>.
+
+The function that does this is
+L<Bugzilla::Install::Filesystem/fix_all_file_permissions>.
+
+=item 12
+
+Populates the C<fielddefs> table, using
+L<Bugzilla::Field/populate_field_definitions>.
+
+=item 13
+
+This is the major part of checksetup--updating the table definitions
+from one version of Bugzilla to another.
+
+The code for this is in L<Bugzilla::Install::DB/update_table_definitions>.
+
+This includes creating the default Classification (using 
+L<Bugzilla::Install/create_default_classification>) and setting up all
+the foreign keys for all tables, using L<Bugzilla::DB/bz_setup_foreign_keys>.
+
+=item 14
+
+Creates the system groups--the ones like C<editbugs>, C<admin>, and so on.
+This is L<Bugzilla::Install/update_system_groups>.
+
+=item 15
+
+Creates all of the user-adjustable preferences that appear on the
+"General Preferences" screen. This is L<Bugzilla::Install/update_settings>.
+
+=item 16
+
+Creates an administrator, if one doesn't already exist, using
+L<Bugzilla::Install/create_admin>.
+
+We also can make somebody an admin at this step, if the user specified
+the C<--make-admin> switch.
+
+=item 17
+
+Creates the default Product and Component, using
+L<Bugzilla::Install/create_default_product>.
+
+=back
+
+=head2 Modifying the Database
+
+Sometimes you'll want to modify the database. In fact, that's mostly
+what checksetup does, is upgrade old Bugzilla databases to the modern
+format.
+
+If you'd like to know how to make changes to the datbase, see
+the information in the Bugzilla Developer's Guide, at:
+L<http://www.bugzilla.org/docs/developer.html#sql-schema>
+
+Also see L<Bugzilla::DB/"Schema Modification Methods"> and
+L<Bugzilla::DB/"Schema Information Methods">.
+
+=head1 RUNNING CHECKSETUP NON-INTERACTIVELY
+
+To operate checksetup non-interactively, run it with a single argument
+specifying a filename that contains the information usually obtained by
+prompting the user or by editing localconfig.
+
+The format of that file is as follows:
+
+ $answer{'db_host'}   = 'localhost';
+ $answer{'db_driver'} = 'mydbdriver';
+ $answer{'db_port'}   = 0;
+ $answer{'db_name'}   = 'mydbname';
+ $answer{'db_user'}   = 'mydbuser';
+ $answer{'db_pass'}   = 'mydbpass';
+
+ $answer{'urlbase'} = 'http://bugzilla.mydomain.com/';
+
+ (Any localconfig variable or parameter can be specified as above.)
+
+ $answer{'ADMIN_EMAIL'} = 'myadmin@mydomain.net';
+ $answer{'ADMIN_PASSWORD'} = 'fooey';
+ $answer{'ADMIN_REALNAME'} = 'Joel Peshkin';
+
+ $answer{'SMTP_SERVER'} = 'mail.mydomain.net';
+
+ $answer{'NO_PAUSE'} = 1
+
+C<NO_PAUSE> means "never stop and prompt the user to hit Enter to continue,
+just go ahead and do things, even if they are potentially dangerous." 
+Don't set this to 1 unless you know what you are doing.
+
+=head1 SEE ALSO
+
+=over
+
+=item *
+
+L<Bugzilla::Install::Requirements>
+
+=item *
+
+L<Bugzilla::Install::Localconfig>
+
+=item *
+
+L<Bugzilla::Install::Filesystem>
+
+=item *
+
+L<Bugzilla::Install::DB>
+
+=item *
+
+L<Bugzilla::Install>
+
+=item *
+
+L<Bugzilla::Config/update_params>
+
+=item *
+
+L<Bugzilla::DB/CONNECTION>
+
+=back

diff --git a/colchange.cgi b/colchange.cgi
new file mode 100755 (executable)
index 0000000..835a8ef
--- /dev/null
+++ b/colchange.cgi
@@ -0,0 +1,184 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::CGI;
+use Bugzilla::Search::Saved;
+use Bugzilla::Error;
+use Bugzilla::User;
+use Bugzilla::Token;
+
+use Storable qw(dclone);
+
+# Maps parameters that control columns to the names of columns.
+use constant COLUMN_PARAMS => {
+    'useclassification'   => ['classification'],
+    'usetargetmilestone'  => ['target_milestone'],
+    'useqacontact'        => ['qa_contact', 'qa_contact_realname'],
+    'usestatuswhiteboard' => ['status_whiteboard'],
+};
+
+# We only show these columns if an object of this type exists in the
+# database.
+use constant COLUMN_CLASSES => {
+    'Bugzilla::Flag'    => 'flagtypes.name',
+    'Bugzilla::Keyword' => 'keywords',
+};
+
+my $user = Bugzilla->login();
+
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $vars = {};
+
+my $columns = dclone(Bugzilla::Search::COLUMNS);
+
+# You can't manually select "relevance" as a column you want to see.
+delete $columns->{'relevance'};
+
+foreach my $param (keys %{ COLUMN_PARAMS() }) {
+    next if Bugzilla->params->{$param};
+    foreach my $column (@{ COLUMN_PARAMS->{$param} }) {
+        delete $columns->{$column};
+    }
+}
+
+foreach my $class (keys %{ COLUMN_CLASSES() }) {
+    eval("use $class; 1;") || die $@;
+    my $column = COLUMN_CLASSES->{$class};
+    delete $columns->{$column} if !$class->any_exist;
+}
+
+if (!$user->is_timetracker) {
+    foreach my $column (TIMETRACKING_FIELDS) {
+        delete $columns->{$column};
+    }
+}
+
+$vars->{'columns'} = $columns;
+
+my @collist;
+if (defined $cgi->param('rememberedquery')) {
+    my $search;
+    if (defined $cgi->param('saved_search')) {
+        $search = new Bugzilla::Search::Saved($cgi->param('saved_search'));
+    }
+
+    my $token = $cgi->param('token');
+    if ($search) {
+        check_hash_token($token, [$search->id, $search->name]);
+    }
+    else {
+        check_hash_token($token, ['default-list']);
+    }
+
+    my $splitheader = 0;
+    if (defined $cgi->param('resetit')) {
+        @collist = DEFAULT_COLUMN_LIST;
+    } else {
+        if (defined $cgi->param("selected_columns")) {
+            @collist = grep { exists $columns->{$_} } 
+                            $cgi->param("selected_columns");
+        }
+        if (defined $cgi->param('splitheader')) {
+            $splitheader = $cgi->param('splitheader')? 1: 0;
+        }
+    }
+    my $list = join(" ", @collist);
+
+    if ($list) {
+        # Only set the cookie if this is not a saved search.
+        # Saved searches have their own column list
+        if (!$cgi->param('save_columns_for_search')) {
+            $cgi->send_cookie(-name => 'COLUMNLIST',
+                              -value => $list,
+                              -expires => 'Fri, 01-Jan-2038 00:00:00 GMT');
+        }
+    }
+    else {
+        $cgi->remove_cookie('COLUMNLIST');
+    }
+    if ($splitheader) {
+        $cgi->send_cookie(-name => 'SPLITHEADER',
+                          -value => $splitheader,
+                          -expires => 'Fri, 01-Jan-2038 00:00:00 GMT');
+    }
+    else {
+        $cgi->remove_cookie('SPLITHEADER');
+    }
+
+    $vars->{'message'} = "change_columns";
+
+    if ($cgi->param('save_columns_for_search')
+        && defined $search && $search->user->id == $user->id)
+    {
+        my $params = new Bugzilla::CGI($search->url);
+        $params->param('columnlist', join(",", @collist));
+        $search->set_url($params->query_string());
+        $search->update();
+    }
+
+    my $params = new Bugzilla::CGI($cgi->param('rememberedquery'));
+    $params->param('columnlist', join(",", @collist));
+    $vars->{'redirect_url'} = "buglist.cgi?".$params->query_string();
+
+
+    # If we're running on Microsoft IIS, $cgi->redirect discards
+    # the Set-Cookie lines. In mod_perl, $cgi->redirect with cookies
+    # causes the page to be rendered as text/plain.
+    # Workaround is to use the old-fashioned  redirection mechanism. 
+    # See bug 214466 and bug 376044 for details.
+    if ($ENV{'MOD_PERL'} 
+        || $ENV{'SERVER_SOFTWARE'} =~ /Microsoft-IIS/
+        || $ENV{'SERVER_SOFTWARE'} =~ /Sun ONE Web/)
+    {
+      print $cgi->header(-type => "text/html",
+                         -refresh => "0; URL=$vars->{'redirect_url'}");
+    }
+    else {
+      print $cgi->redirect($vars->{'redirect_url'});
+      exit;
+    }
+    
+    $template->process("global/message.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+if (defined $cgi->param('columnlist')) {
+    @collist = split(/[ ,]+/, $cgi->param('columnlist'));
+} elsif (defined $cgi->cookie('COLUMNLIST')) {
+    @collist = split(/ /, $cgi->cookie('COLUMNLIST'));
+} else {
+    @collist = DEFAULT_COLUMN_LIST;
+}
+
+$vars->{'collist'} = \@collist;
+$vars->{'splitheader'} = $cgi->cookie('SPLITHEADER') ? 1 : 0;
+
+$vars->{'buffer'} = $cgi->query_string();
+
+my $search;
+if (defined $cgi->param('query_based_on')) {
+    my $searches = $user->queries;
+    my ($search) = grep($_->name eq $cgi->param('query_based_on'), @$searches);
+
+    if ($search) {
+        $vars->{'saved_search'} = $search;
+    }
+}
+
+# Generate and return the UI (HTML page) from the appropriate template.
+print $cgi->header();
+$template->process("list/change-columns.html.tmpl", $vars)
+  || ThrowTemplateError($template->error());

diff --git a/collectstats.pl b/collectstats.pl
new file mode 100755 (executable)
index 0000000..aa98ddf
--- /dev/null
+++ b/collectstats.pl
@@ -0,0 +1,536 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Getopt::Long qw(:config bundling);
+use Pod::Usage;
+use List::Util qw(first);
+use Cwd;
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Util;
+use Bugzilla::Search;
+use Bugzilla::User;
+use Bugzilla::Product;
+use Bugzilla::Field;
+use Bugzilla::Install::Filesystem qw(fix_dir_permissions);
+
+my %switch;
+GetOptions(\%switch, 'help|h', 'regenerate');
+
+# Print the help message if that switch was selected.
+pod2usage({-verbose => 1, -exitval => 1}) if $switch{'help'};
+
+# Turn off output buffering (probably needed when displaying output feedback
+# in the regenerate mode).
+$| = 1;
+
+my $datadir = bz_locations()->{'datadir'};
+my $graphsdir = bz_locations()->{'graphsdir'};
+
+# Tidy up after graphing module
+my $cwd = Cwd::getcwd();
+if (chdir($graphsdir)) {
+    unlink <./*.gif>;
+    unlink <./*.png>;
+    # chdir("..") doesn't work if graphs is a symlink, see bug 429378
+    chdir($cwd);
+}
+
+my $dbh = Bugzilla->switch_to_shadow_db();
+
+# As we can now customize statuses and resolutions, looking at the current list
+# of legal values only is not enough as some now removed statuses and resolutions
+# may have existed in the past, or have been renamed. We want them all.
+my $fields = {};
+foreach my $field ('bug_status', 'resolution') {
+    my $values = get_legal_field_values($field);
+    my $old_values = $dbh->selectcol_arrayref(
+                             "SELECT bugs_activity.added
+                                FROM bugs_activity
+                          INNER JOIN fielddefs
+                                  ON fielddefs.id = bugs_activity.fieldid
+                           LEFT JOIN $field
+                                  ON $field.value = bugs_activity.added
+                               WHERE fielddefs.name = ?
+                                 AND $field.id IS NULL
+
+                               UNION
+
+                              SELECT bugs_activity.removed
+                                FROM bugs_activity
+                          INNER JOIN fielddefs
+                                  ON fielddefs.id = bugs_activity.fieldid
+                           LEFT JOIN $field
+                                  ON $field.value = bugs_activity.removed
+                               WHERE fielddefs.name = ?
+                                 AND $field.id IS NULL",
+                               undef, ($field, $field));
+
+    push(@$values, @$old_values);
+    $fields->{$field} = $values;
+}
+
+my @statuses = @{$fields->{'bug_status'}};
+my @resolutions = @{$fields->{'resolution'}};
+# Exclude "" from the resolution list.
+@resolutions = grep {$_} @resolutions;
+
+# --regenerate was taking an enormous amount of time to query everything
+# per bug, per day. Instead, we now just get all the data out of the DB
+# at once and stuff it into some data structures.
+my (%bug_status, %bug_resolution, %removed);
+if ($switch{'regenerate'}) {
+    %bug_resolution = @{ $dbh->selectcol_arrayref(
+        'SELECT bug_id, resolution FROM bugs', {Columns=>[1,2]}) };
+    %bug_status = @{ $dbh->selectcol_arrayref(
+        'SELECT bug_id, bug_status FROM bugs', {Columns=>[1,2]}) };
+
+    my $removed_sth = $dbh->prepare(
+        q{SELECT bugs_activity.bug_id, bugs_activity.removed,}
+        . $dbh->sql_to_days('bugs_activity.bug_when')
+       . q{ FROM bugs_activity
+           WHERE bugs_activity.fieldid = ?
+        ORDER BY bugs_activity.bug_when});
+
+    %removed = (bug_status => {}, resolution => {});
+    foreach my $field (qw(bug_status resolution)) {
+        my $field_id = Bugzilla::Field->check($field)->id;
+        my $rows = $dbh->selectall_arrayref($removed_sth, undef, $field_id);
+        my $hash = $removed{$field};
+        foreach my $row (@$rows) {
+            my ($bug_id, $removed, $when) = @$row;
+            $hash->{$bug_id} ||= [];
+            push(@{ $hash->{$bug_id} }, { when    => int($when),
+                                          removed => $removed });
+        }
+    }
+}
+
+my $tstart = time;
+
+my @myproducts = Bugzilla::Product->get_all;
+unshift(@myproducts, "-All-");
+
+my $dir = "$datadir/mining";
+if (!-d $dir) {
+    mkdir $dir or die "mkdir $dir failed: $!";
+    fix_dir_permissions($dir);
+}
+
+foreach (@myproducts) {
+    if ($switch{'regenerate'}) {
+        regenerate_stats($dir, $_, \%bug_resolution, \%bug_status, \%removed);
+    } else {
+        &collect_stats($dir, $_);
+    }
+}
+# Fix permissions for all files in mining/.
+fix_dir_permissions($dir);
+
+my $tend = time;
+# Uncomment the following line for performance testing.
+#say "Total time taken " . delta_time($tstart, $tend);
+
+CollectSeriesData();
+
+sub collect_stats {
+    my $dir = shift;
+    my $product = shift;
+    my $when = localtime (time);
+    my $dbh = Bugzilla->dbh;
+    my $product_id;
+
+    if (ref $product) {
+        $product_id = $product->id;
+        $product = $product->name;
+    }
+
+    # NB: Need to mangle the product for the filename, but use the real
+    # product name in the query
+    my $file_product = $product;
+    $file_product =~ s/\//-/gs;
+    my $file = join '/', $dir, $file_product;
+    my $exists = -f $file;
+
+    # if the file exists, get the old status and resolution list for that product.
+    my @data;
+    @data = get_old_data($file) if $exists;
+
+    # If @data is not empty, then we have to recreate the data file.
+    if (scalar(@data)) {
+        open(DATA, '>', $file)
+          || ThrowCodeError('chart_file_open_fail', {'filename' => $file});
+    }
+    else {
+        open(DATA, '>>', $file)
+          || ThrowCodeError('chart_file_open_fail', {'filename' => $file});
+    }
+
+    if (Bugzilla->params->{'utf8'}) {
+        binmode DATA, ':utf8';
+    }
+
+    # Now collect current data.
+    my @row = (today());
+    my $status_sql = q{SELECT COUNT(*) FROM bugs WHERE bug_status = ?};
+    my $reso_sql   = q{SELECT COUNT(*) FROM bugs WHERE resolution = ?};
+
+    if ($product ne '-All-') {
+        $status_sql .= q{ AND product_id = ?};
+        $reso_sql   .= q{ AND product_id = ?};
+    }
+
+    my $sth_status = $dbh->prepare($status_sql);
+    my $sth_reso   = $dbh->prepare($reso_sql);
+
+    my @values ;
+    foreach my $status (@statuses) {
+        @values = ($status);
+        push (@values, $product_id) if ($product ne '-All-');
+        my $count = $dbh->selectrow_array($sth_status, undef, @values);
+        push(@row, $count);
+    }
+    foreach my $resolution (@resolutions) {
+        @values = ($resolution);
+        push (@values, $product_id) if ($product ne '-All-');
+        my $count = $dbh->selectrow_array($sth_reso, undef, @values);
+        push(@row, $count);
+    }
+
+    if (!$exists || scalar(@data)) {
+        my $fields = join('|', ('DATE', @statuses, @resolutions));
+        print DATA <<FIN;
+# Bugzilla Daily Bug Stats
+#
+# Do not edit me! This file is generated.
+#
+# fields: $fields
+# Product: $product
+# Created: $when
+FIN
+    }
+
+    # Add existing data, if needed. Note that no count is not treated
+    # the same way as a count with 0 bug.
+    foreach my $data (@data) {
+        print DATA join('|', map {defined $data->{$_} ? $data->{$_} : ''}
+                                 ('DATE', @statuses, @resolutions)) . "\n";
+    }
+    print DATA (join '|', @row) . "\n";
+    close DATA;
+}
+
+sub get_old_data {
+    my $file = shift;
+
+    open(DATA, '<', $file)
+      || ThrowCodeError('chart_file_open_fail', {'filename' => $file});
+
+    if (Bugzilla->params->{'utf8'}) {
+        binmode DATA, ':utf8';
+    }
+
+    my @data;
+    my @columns;
+    my $recreate = 0;
+    while (<DATA>) {
+        chomp;
+        next unless $_;
+        if (/^# fields?:\s*(.+)\s*$/) {
+            @columns = split(/\|/, $1);
+            # Compare this list with @statuses and @resolutions.
+            # If they are identical, then we can safely append new data
+            # to the end of the file; else we have to recreate it.
+            $recreate = 1;
+            my @new_cols = ($columns[0], @statuses, @resolutions);
+            if (scalar(@columns) == scalar(@new_cols)) {
+                my $identical = 1;
+                for (0 .. $#columns) {
+                    $identical = 0 if ($columns[$_] ne $new_cols[$_]);
+                }
+                last if $identical;
+            }
+        }
+        next unless $recreate;
+        next if (/^#/); # Ignore comments.
+        # If we have to recreate the file, we have to load all existing
+        # data first.
+        my @line = split /\|/;
+        my %data;
+        foreach my $column (@columns) {
+            $data{$column} = shift @line;
+        }
+        push(@data, \%data);
+    }
+    close(DATA);
+    return @data;
+}
+
+# This regenerates all statistics from the database.
+sub regenerate_stats {
+    my ($dir, $product, $bug_resolution, $bug_status, $removed) = @_;
+
+    my $dbh = Bugzilla->dbh;
+    my $when = localtime(time());
+    my $tstart = time();
+
+    # NB: Need to mangle the product for the filename, but use the real
+    # product name in the query
+    if (ref $product) {
+        $product = $product->name;
+    }
+    my $file_product = $product;
+    $file_product =~ s/\//-/gs;
+    my $file = join '/', $dir, $file_product;
+
+    my $and_product = "";
+    my $from_product = "";
+
+    my @values = ();
+    if ($product ne '-All-') {
+        $and_product = q{ AND products.name = ?};
+        $from_product = q{ INNER JOIN products 
+                          ON bugs.product_id = products.id};
+        push (@values, $product);
+    }
+
+    # Determine the start date from the date the first bug in the
+    # database was created, and the end date from the current day.
+    # If there were no bugs in the search, return early.
+    my $query = q{SELECT } .
+                $dbh->sql_to_days('creation_ts') . q{ AS start_day, } .
+                $dbh->sql_to_days('current_date') . q{ AS end_day, } . 
+                $dbh->sql_to_days("'1970-01-01'") . 
+                 qq{ FROM bugs $from_product 
+                   WHERE } . $dbh->sql_to_days('creation_ts') . 
+                         qq{ IS NOT NULL $and_product 
+                ORDER BY start_day } . $dbh->sql_limit(1);
+    my ($start, $end, $base) = $dbh->selectrow_array($query, undef, @values);
+
+    if (!defined $start) {
+        return;
+    }
+
+    if (open DATA, ">$file") {
+        my $fields = join('|', ('DATE', @statuses, @resolutions));
+        print DATA <<FIN;
+# Bugzilla Daily Bug Stats
+#
+# Do not edit me! This file is generated.
+#
+# fields: $fields
+# Product: $product
+# Created: $when
+FIN
+        # For each day, generate a line of statistics.
+        my $total_days = $end - $start;
+        my @bugs;
+        for (my $day = $start + 1; $day <= $end; $day++) {
+            # Some output feedback
+            my $percent_done = ($day - $start - 1) * 100 / $total_days;
+            printf "\rRegenerating $product \[\%.1f\%\%]", $percent_done;
+
+            # Get a list of bugs that were created the previous day, and
+            # add those bugs to the list of bugs for this product.
+            $query = qq{SELECT bug_id 
+                          FROM bugs $from_product 
+                         WHERE bugs.creation_ts < } . 
+                         $dbh->sql_from_days($day - 1) . 
+                         q{ AND bugs.creation_ts >= } . 
+                         $dbh->sql_from_days($day - 2) . 
+                        $and_product . q{ ORDER BY bug_id};
+
+            my $bug_ids = $dbh->selectcol_arrayref($query, undef, @values);
+            push(@bugs, @$bug_ids);
+
+            my %bugcount;
+            foreach (@statuses) { $bugcount{$_} = 0; }
+            foreach (@resolutions) { $bugcount{$_} = 0; }
+            # Get information on bug states and resolutions.
+            for my $bug (@bugs) {
+                my $status = _get_value(
+                    $removed->{'bug_status'}->{$bug},
+                    $bug_status,  $day, $bug);
+
+                if (defined $bugcount{$status}) {
+                    $bugcount{$status}++;
+                }
+
+                my $resolution = _get_value(
+                    $removed->{'resolution'}->{$bug},
+                    $bug_resolution, $day, $bug);
+
+                if (defined $bugcount{$resolution}) {
+                    $bugcount{$resolution}++;
+                }
+            }
+
+            # Generate a line of output containing the date and counts
+            # of bugs in each state.
+            my $date = sqlday($day, $base);
+            print DATA "$date";
+            foreach (@statuses) { print DATA "|$bugcount{$_}"; }
+            foreach (@resolutions) { print DATA "|$bugcount{$_}"; }
+            print DATA "\n";
+        }
+
+        # Finish up output feedback for this product.
+        my $tend = time;
+        say "\rRegenerating $product \[100.0\%] - " . delta_time($tstart, $tend);
+
+        close DATA;
+    }
+}
+
+# A helper for --regenerate.
+# For each bug that exists on a day, we determine its status/resolution
+# at the beginning of the day.  If there were no status/resolution
+# changes on or after that day, the status was the same as it
+# is today (the "current" value).  Otherwise, the status was equal to the
+# first "previous value" entry in the bugs_activity table for that 
+# bug made on or after that day.
+sub _get_value {
+    my ($removed, $current, $day, $bug) = @_;
+
+    # Get the first change that's on or after this day.
+    my $item = first { $_->{when} >= $day } @{ $removed || [] };
+
+    # If there's no change on or after this day, then we just return the
+    # current value.
+    return $item ? $item->{removed} : $current->{$bug};
+}
+
+sub today {
+    my ($dom, $mon, $year) = (localtime(time))[3, 4, 5];
+    return sprintf "%04d%02d%02d", 1900 + $year, ++$mon, $dom;
+}
+
+sub today_dash {
+    my ($dom, $mon, $year) = (localtime(time))[3, 4, 5];
+    return sprintf "%04d-%02d-%02d", 1900 + $year, ++$mon, $dom;
+}
+
+sub sqlday {
+    my ($day, $base) = @_;
+    $day = ($day - $base) * 86400;
+    my ($dom, $mon, $year) = (gmtime($day))[3, 4, 5];
+    return sprintf "%04d%02d%02d", 1900 + $year, ++$mon, $dom;
+}
+
+sub delta_time {
+    my $tstart = shift;
+    my $tend = shift;
+    my $delta = $tend - $tstart;
+    my $hours = int($delta/3600);
+    my $minutes = int($delta/60) - ($hours * 60);
+    my $seconds = $delta - ($minutes * 60) - ($hours * 3600);
+    return sprintf("%02d:%02d:%02d" , $hours, $minutes, $seconds);
+}
+
+sub CollectSeriesData {
+    # We need some way of randomising the distribution of series, such that
+    # all of the series which are to be run every 7 days don't run on the same
+    # day. This is because this might put the server under severe load if a
+    # particular frequency, such as once a week, is very common. We achieve
+    # this by only running queries when:
+    # (days_since_epoch + series_id) % frequency = 0. So they'll run every
+    # <frequency> days, but the start date depends on the series_id.
+    my $days_since_epoch = int(time() / (60 * 60 * 24));
+    my $today = today_dash();
+
+    # We save a copy of the main $dbh and then switch to the shadow and get
+    # that one too. Remember, these may be the same.
+    my $dbh = Bugzilla->switch_to_main_db();
+    my $shadow_dbh = Bugzilla->switch_to_shadow_db();
+    
+    my $serieses = $dbh->selectall_hashref("SELECT series_id, query, creator " .
+                      "FROM series " .
+                      "WHERE frequency != 0 AND " . 
+                      "MOD(($days_since_epoch + series_id), frequency) = 0",
+                      "series_id");
+
+    # We prepare the insertion into the data table, for efficiency.
+    my $sth = $dbh->prepare("INSERT INTO series_data " .
+                            "(series_id, series_date, series_value) " .
+                            "VALUES (?, " . $dbh->quote($today) . ", ?)");
+
+    # We delete from the table beforehand, to avoid SQL errors if people run
+    # collectstats.pl twice on the same day.
+    my $deletesth = $dbh->prepare("DELETE FROM series_data 
+                                   WHERE series_id = ? AND series_date = " .
+                                   $dbh->quote($today));
+                                     
+    foreach my $series_id (keys %$serieses) {
+        # We set up the user for Search.pm's permission checking - each series
+        # runs with the permissions of its creator.
+        my $user = new Bugzilla::User($serieses->{$series_id}->{'creator'});
+        my $cgi = new Bugzilla::CGI($serieses->{$series_id}->{'query'});
+        my $data;
+
+        # Do not die if Search->new() detects invalid data, such as an obsolete
+        # login name or a renamed product or component, etc.
+        eval {
+            my $search = new Bugzilla::Search('params' => scalar $cgi->Vars,
+                                              'fields' => ["bug_id"],
+                                              'allow_unlimited' => 1,
+                                              'user'   => $user);
+            $data = $search->data;
+        };
+
+        if (!$@) {
+            # We need to count the returned rows. Without subselects, we can't
+            # do this directly in the SQL for all queries. So we do it by hand.
+            my $count = scalar(@$data) || 0;
+
+            $deletesth->execute($series_id);
+            $sth->execute($series_id, $count);
+        }
+    }
+}
+
+__END__
+
+=head1 NAME
+
+collectstats.pl - Collect data about Bugzilla bugs.
+
+=head1 SYNOPSIS
+
+ ./collectstats.pl [--regenerate] [--help]
+
+Collects data about bugs to be used in Old and New Charts.
+
+=head1 OPTIONS
+
+=over
+
+=item B<--help>
+
+Print this help page.
+
+=item B<--regenerate>
+
+Recreate all the data about bugs, from day 1. This option is only relevant
+for Old Charts, and has no effect for New Charts.
+This option will overwrite all existing collected data and can take a huge
+amount of time. You normally don't need to use this option (do not use it
+in a cron job).
+
+=back
+
+=head1 DESCRIPTION
+
+This script collects data about all bugs for Old Charts, triaged by product
+and by bug status and resolution. It also collects data for New Charts, based
+on existing series. For New Charts, data is only collected once a series is
+defined; this script cannot recreate data prior to this date.

diff --git a/config.cgi b/config.cgi
new file mode 100755 (executable)
index 0000000..7dc2e3a
--- /dev/null
+++ b/config.cgi
@@ -0,0 +1,153 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+################################################################################
+# Script Initialization
+################################################################################
+
+# Make it harder for us to do dangerous things in Perl.
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Keyword;
+use Bugzilla::Product;
+use Bugzilla::Status;
+use Bugzilla::Field;
+
+use Digest::MD5 qw(md5_base64);
+
+my $user = Bugzilla->login(LOGIN_OPTIONAL);
+my $cgi  = Bugzilla->cgi;
+
+# Get data from the shadow DB as they don't change very often.
+Bugzilla->switch_to_shadow_db;
+
+# If the 'requirelogin' parameter is on and the user is not
+# authenticated, return empty fields.
+if (Bugzilla->params->{'requirelogin'} && !$user->id) {
+    display_data();
+    exit;
+}
+
+# Pass a bunch of Bugzilla configuration to the templates.
+my $vars = {};
+$vars->{'priority'}  = get_legal_field_values('priority');
+$vars->{'severity'}  = get_legal_field_values('bug_severity');
+$vars->{'platform'}  = get_legal_field_values('rep_platform');
+$vars->{'op_sys'}    = get_legal_field_values('op_sys');
+$vars->{'keywords'}  = [Bugzilla::Keyword->get_all];
+$vars->{'resolution'} = get_legal_field_values('resolution');
+$vars->{'status'}    = get_legal_field_values('bug_status');
+$vars->{'custom_fields'} =
+    [ grep {$_->is_select} Bugzilla->active_custom_fields ];
+
+# Include a list of product objects.
+if ($cgi->param('product')) {
+    my @products = $cgi->param('product');
+    foreach my $product_name (@products) {
+        # We don't use check() because config.cgi outputs mostly
+        # in XML and JS and we don't want to display an HTML error
+        # instead of that.
+        my $product = new Bugzilla::Product({ name => $product_name });
+        if ($product && $user->can_see_product($product->name)) {
+            push (@{$vars->{'products'}}, $product);
+        }
+    }
+} else {
+    $vars->{'products'} = $user->get_selectable_products;
+}
+
+# We set the 2nd argument to 1 to also preload flag types.
+Bugzilla::Product::preload($vars->{'products'}, 1);
+
+if (Bugzilla->params->{'useclassification'}) {
+    my $class = {};
+    # Get all classifications with at least one selectable product.
+    foreach my $product (@{$vars->{'products'}}) {
+        $class->{$product->classification_id} ||= $product->classification;
+    }
+    my @classifications = sort {$a->sortkey <=> $b->sortkey
+        || lc($a->name) cmp lc($b->name)} (values %$class);
+    $vars->{'class_names'} = $class;
+    $vars->{'classifications'} = \@classifications;
+}
+
+# Allow consumers to specify whether or not they want flag data.
+if (defined $cgi->param('flags')) {
+    $vars->{'show_flags'} = $cgi->param('flags');
+}
+else {
+    # We default to sending flag data.
+    $vars->{'show_flags'} = 1;
+}
+
+# Create separate lists of open versus resolved statuses.  This should really
+# be made part of the configuration.
+my @open_status;
+my @closed_status;
+foreach my $status (@{$vars->{'status'}}) {
+    is_open_state($status) ? push(@open_status, $status) 
+                           : push(@closed_status, $status);
+}
+$vars->{'open_status'} = \@open_status;
+$vars->{'closed_status'} = \@closed_status;
+
+# Generate a list of fields that can be queried.
+my @fields = @{Bugzilla::Field->match({obsolete => 0})};
+# Exclude fields the user cannot query.
+if (!$user->is_timetracker) {
+    @fields = grep { $_->name !~ /^(estimated_time|remaining_time|work_time|percentage_complete|deadline)$/ } @fields;
+}
+
+my %FIELD_PARAMS = (
+    classification    => 'useclassification',
+    target_milestone  => 'usetargetmilestone',
+    qa_contact        => 'useqacontact',
+    status_whiteboard => 'usestatuswhiteboard',
+    see_also          => 'use_see_also',
+);
+foreach my $field (@fields) {
+    my $param = $FIELD_PARAMS{$field->name};
+    $field->{is_active} =  Bugzilla->params->{$param} if $param;
+}
+$vars->{'field'} = \@fields;
+
+display_data($vars);
+
+
+sub display_data {
+    my $vars = shift;
+
+    my $cgi      = Bugzilla->cgi;
+    my $template = Bugzilla->template;
+
+    # Determine how the user would like to receive the output; 
+    # default is JavaScript.
+    my $format = $template->get_format("config", scalar($cgi->param('format')),
+                                       scalar($cgi->param('ctype')) || "js");
+
+    # Generate the configuration data.
+    my $output;
+    $template->process($format->{'template'}, $vars, \$output)
+      || ThrowTemplateError($template->error());
+
+    # Wide characters cause md5_base64() to die.
+    my $digest_data = $output;
+    utf8::encode($digest_data) if utf8::is_utf8($digest_data);
+    my $digest = md5_base64($digest_data);
+
+    $cgi->check_etag($digest);
+
+    print $cgi->header (-ETag => $digest,
+                        -type => $format->{'ctype'});
+    print $output;
+}

diff --git a/contrib/Bugzilla.pm b/contrib/Bugzilla.pm
new file mode 100644 (file)
index 0000000..6bfc07e
--- /dev/null
+++ b/contrib/Bugzilla.pm
@@ -0,0 +1,48 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+package Bugzilla;
+
+use strict;
+
+#######################################################################
+# The goal of this tiny module is to let Bugzilla packagers of        #
+# various Linux distributions easily specify the path to the Bugzilla #
+# modules without having to edit each *.cgi script manually to fix    #
+# the | use lib qw(. lib) | line.                                     #
+#                                                                     #
+# If the real Bugzilla.pm module and the Bugzilla/ directory are in   #
+# the same directory as *.cgi scripts (which is the default), then    #
+# this module is useless and has no effect.                           #
+# If the real Bugzilla.pm module and other Bugzilla/*.pm modules are  #
+# moved elsewhere, then the *.cgi scripts will call this module which #
+# will give them the location of the Bugzilla modules.                #
+#######################################################################
+#                                                                     #
+# IMPORTANT NOTE: This module must be in a place where Perl will find #
+# it by default, e.g. in /usr/lib/perl5/vendor_perl/5.x.y/.           #
+#                                                                     #
+#######################################################################
+#                                                                     #
+# Specify the path to the real Bugzilla.pm file in BZ_ROOT_DIR.       #
+# Some Linux distros may set it to '/usr/share/bugzilla/lib'.         #
+#                                                                     #
+# Specify the path to the Bugzilla lib/ directory in BZ_LIB_DIR.      #
+# If your Linux distro doesn't use it, make it point to BZ_ROOT_DIR.  #
+#                                                                     #
+#######################################################################
+
+use constant BZ_ROOT_DIR => '/usr/share/bugzilla/lib';
+use constant BZ_LIB_DIR => BZ_ROOT_DIR . '/lib';
+
+#######################################################################
+#   DO NOT EDIT THE CODE BELOW, UNLESS YOU KNOW WHAT YOU ARE DOING!!  #
+#######################################################################
+
+use lib (BZ_ROOT_DIR, BZ_LIB_DIR);
+
+# Now load the real Bugzilla.pm file.
+BEGIN { my $bugzilla = BZ_ROOT_DIR . '/Bugzilla.pm'; require $bugzilla; }
+
+1;

diff --git a/contrib/README b/contrib/README
new file mode 100644 (file)
index 0000000..f4e40e4
--- /dev/null
+++ b/contrib/README
@@ -0,0 +1,57 @@
+This directory contains contributed software related to Bugzilla.
+Things in here have not necessarily been tested or tried by anyone
+except the original contributor, so tread carefully.  But it may still
+be useful to you. Read the files themselves for detailed usage information
+on any specific script.
+
+This file is encoded in UTF8 for purposes of contributor names.
+
+This directory includes:
+
+    bugzilla-submit/ --  A standalone bug submission program.
+
+         bzdbcopy.pl --  A script to copy data from an installation running 
+                         on one DB platform to an installation running on 
+                         another DB platform.
+
+bz_webservice_demo.pl --  An example script that demonstrates how to talk to
+                         Bugzilla via XMLRPC.
+
+             cmdline/ -- Various commands for querying your Bugzilla 
+                         installation.
+
+       cvs-update.pl --  Script to keep a record of all CVS updates made 
+                         from a given directory. The log is useful when
+                         changes need to be backed out.
+
+            jb2bz.py --  Script to import bugs from JitterBug to Bugzilla.
+
+      merge-users.pl --  Script to merge two user accounts. The activities
+                         from one account are moved to the another. Specify
+                         both accounts on the command line. The new account
+                         must already exist. 
+
+   mysqld-watcher.pl --  This script can be installed as a frequent Cron 
+                         job to clean up stalled/dead queries.
+
+           recode.pl --  Script to convert a database from one encoding 
+                         (or multiple encodings)  to UTF-8.
+
+      sendbugmail.pl --  This script is a drop-in replacement for the
+                         'processmail' script which used to be shipped
+                         with Bugzilla, but was replaced by the
+                         Bugzilla/BugMail.pm Perl module. This script can 
+                         be used if 'processmail' was previously called
+                         from other scripts external to
+                         Bugzilla.  See the comments at the top of
+                         the file for usage information. Contributed
+                         by Nick Barnes of Ravenbrook Limited.
+
+sendunsentbugmail.pl --  Script to find bugs with un-sent mail and to
+                         send all unsent messages.
+
+         syncLDAP.pl --  Script that can be run via Cron that queries an LDAP
+                         server for users and e-mail addresses and adds
+                         missing users to Bugzilla. Can disable/update 
+                         non-existing/changed information. Contributed by
+                         Andreas Höfler <andreas.hoefler@bearingpoint.com>.

diff --git a/contrib/bugzilla-queue.rhel b/contrib/bugzilla-queue.rhel
new file mode 100755 (executable)
index 0000000..b7a39fe
--- /dev/null
+++ b/contrib/bugzilla-queue.rhel
@@ -0,0 +1,116 @@
+#!/bin/bash
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+# bugzilla-queue This starts, stops, and restarts the Bugzilla jobqueue.pl
+#               daemon, which manages sending queued mail and possibly
+#               other queued tasks in the future.
+#
+# chkconfig: 345 85 15
+# description: Bugzilla queue runner
+#
+### BEGIN INIT INFO
+# Provides: bugzilla-queue
+# Required-Start: $local_fs $syslog MTA mysqld
+# Required-Stop: $local_fs $syslog MTA mysqld
+# Default-Start: 3 5
+# Default-Stop: 0 1 2 6
+# Short-Description: Start and stop the Bugzilla queue runner.
+# Description: The Bugzilla queue runner (jobqueue.pl) sends any mail
+#      that Bugzilla has queued to be sent in the background. If you
+#      have enabled the use_mailer_queue parameter in Bugzilla, you
+#      must run this daemon.
+### END INIT INFO
+
+NAME=`basename $0`
+
+#################
+# Configuration #
+#################
+
+# This should be the path to your Bugzilla
+BUGZILLA=/var/www/html/bugzilla
+# Who owns the Bugzilla directory and files?
+USER=root
+
+# If you want to pass any options to the daemon (like -d for debugging)
+# specify it here.
+OPTIONS=""
+
+# You can also override the configuration by creating a 
+# /etc/sysconfig/bugzilla-queue file so that you don't
+# have to edit this script. 
+if [ -r /etc/sysconfig/$NAME ]; then
+  . /etc/sysconfig/$NAME
+fi
+
+##########
+# Script #
+##########
+
+RETVAL=0
+BIN=$BUGZILLA/jobqueue.pl
+PIDFILE=/var/run/$NAME.pid
+
+# Source function library.
+. /etc/rc.d/init.d/functions
+
+usage ()
+{
+    echo "Usage: service $NAME {start|stop|status|restart|condrestart}"
+    RETVAL=1
+}
+
+
+start ()
+{
+    if [ -f "$PIDFILE" ]; then
+       checkpid `cat $PIDFILE` && return 2
+    fi
+    echo -n "Starting $NAME: "
+    touch $PIDFILE
+    chown $USER $PIDFILE
+    daemon --user=$USER \
+        "$BIN ${OPTIONS} -p '$PIDFILE' -n $NAME start > /dev/null"
+    ret=$?
+    [ $ret -eq "0" ] && touch /var/lock/subsys/$NAME
+    echo
+    return $ret
+}
+
+stop ()
+{
+    [ -f /var/lock/subsys/$NAME ] || return 2
+    echo -n "Killing $NAME: "
+    killproc $NAME
+    echo
+    rm -f /var/lock/subsys/$NAME
+}
+
+restart ()
+{
+    stop
+    start
+}
+
+condrestart ()
+{
+    [ -e /var/lock/subsys/$NAME ] && restart || return 2
+}
+
+
+case "$1" in
+    start) start; RETVAL=$? ;;
+    stop) stop; RETVAL=$? ;;
+    status) $BIN -p $PIDFILE -n $NAME check; RETVAL=$?;;
+    restart) restart; RETVAL=$? ;;
+    condrestart) condrestart; RETVAL=$? ;;
+    *) usage ;;
+esac
+
+exit $RETVAL

diff --git a/contrib/bugzilla-queue.suse b/contrib/bugzilla-queue.suse
new file mode 100755 (executable)
index 0000000..7b5ffd5
--- /dev/null
+++ b/contrib/bugzilla-queue.suse
@@ -0,0 +1,181 @@
+#!/bin/bash
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+# bugzilla-queue This starts, stops, and restarts the Bugzilla jobqueue.pl
+#               daemon, which manages sending queued mail and possibly
+#               other queued tasks in the future.
+#
+# chkconfig: 345 85 15
+# description: Bugzilla queue runner
+#
+### BEGIN INIT INFO
+# Provides: bugzilla-queue
+# Required-Start: $local_fs $syslog
+# Required-Stop: $local_fs $syslog
+# Default-Start: 3 5
+# Default-Stop: 0 1 2 6
+# Short-Description: Start and stop the Bugzilla queue runner.
+# Description: The Bugzilla queue runner (jobqueue.pl) sends any mail
+#      that Bugzilla has queued to be sent in the background. If you
+#      have enabled the use_mailer_queue parameter in Bugzilla, you
+#      must run this daemon.
+### END INIT INFO
+
+NAME=`basename $0`
+
+#################
+# Configuration #
+#################
+
+# This should be the path to your Bugzilla
+BUGZILLA=/var/www/html/bugzilla
+# Who owns the Bugzilla directory and files?
+USER=root
+
+# If you want to pass any options to the daemon (like -d for debugging)
+# specify it here.
+OPTIONS=""
+
+# You can also override the configuration by creating a 
+# /etc/sysconfig/bugzilla-queue file so that you don't
+# have to edit this script. 
+if [ -r /etc/sysconfig/$NAME ]; then
+  . /etc/sysconfig/$NAME
+fi
+
+##########
+# Script #
+##########
+
+BIN=$BUGZILLA/jobqueue.pl
+if [ ! -x $BIN ]; then
+    echo "$BIN not installed"
+    if [ "$1" = "stop" ]; then
+        exit 0
+    else
+        exit 5
+    fi
+fi
+
+# Source LSB function library.
+. /lib/lsb/init-functions
+
+# Reset status of this service.
+rc_reset
+
+# Return values for all commands but status:
+# 0       - success
+# 1       - generic or unspecified error
+# 2       - invalid or excess argument(s)
+# 3       - unimplemented feature (e.g. "reload")
+# 4       - user had insufficient privileges
+# 5       - program is not installed
+# 6       - program is not configured
+# 7       - program is not running
+# 8--199  - reserved (8--99 LSB, 100--149 distrib, 150--199 appl)
+#
+# Note that starting an already running service, stopping
+# or restarting a not-running service as well as the restart
+# with force-reload (in case signaling is not supported) are
+# considered a success.
+
+case "$1" in
+    start)
+        echo -n "Starting $NAME "
+        # Start daemon with startproc(8).  If this fails the return value
+        # is set appropriately by startproc.
+        start_daemon -u $USER $BIN ${OPTIONS} start
+
+        # Remember status and be verbose
+        rc_status -v
+        ;;
+
+    stop)
+        echo -n "Shutting down $NAME "
+        # Stop daemon with killproc(8) and if this fails killproc sets the
+        # return value according to LSB.
+        killproc -TERM $BIN
+
+        # Remember status and be verbose
+        rc_status -v
+        ;;
+
+    status)
+        echo -n "Checking for service $NAME "
+        # Check status with checkproc(8), if process is running checkproc
+        # will return with exit status 0.
+
+        # Return value is slightly different for the status command:
+        # 0 - service up and running
+        # 1 - service dead, but /var/run/  pid  file exists
+        # 2 - service dead, but /var/lock/ lock file exists
+        # 3 - service not running (unused)
+        # 4 - service status unknown :-(
+        # 5--199 reserved (5--99 LSB, 100--149 distro, 150--199 appl.)
+
+        # NOTE: checkproc returns LSB compliant status values.
+        checkproc $BIN
+
+        # NOTE: rc_status knows that we called this init script with
+        # "status" option and adapts its messages accordingly.
+        rc_status -v
+
+        # Run jobqueue's own check function too.
+        $BIN check
+        ;;
+
+    restart)
+        # Stop the service and regardless of whether it was running or not,
+        # start it again.
+        $0 stop
+        $0 start
+
+        # Remember status and be quiet.
+        rc_status
+        ;;
+
+    try-restart|condrestart)
+        # Do a restart only if the service was active before.
+        # NOTE: try-restart is now part of LSB (as of 1.9). RH has a
+        # similar command named condrestart.
+        if [ "$1" = "condrestart" ]; then
+            echo "${attn} Use try-restart ${done}(LSB)${attn} rather than condrestart ${warn}(RH)${norm}"
+        fi
+        $0 status
+        if [ $? -eq 0 ]; then
+            $0 restart
+        else
+            rc_reset        # Not running is not a failure.
+        fi
+
+        # Remember status and be quiet
+        rc_status
+        ;;
+
+    force-reload)
+        # The jobqueue.pl daemon does not support SIGHUP for reload.  Just
+        # restart the service if it is running.
+        echo -n "Reload service $NAME "
+
+        $0 try-restart
+        rc_status
+        ;;
+
+    reload)
+        # The jobqueue.pl daemon does not support SIGHUP for reload.
+        rc_failed 3
+        rc_status -v
+        ;;
+
+    *)
+        echo "Usage: $0 {start|stop|status|try-restart|restart|force-reload|reload}"
+        exit 1
+esac
+
+rc_exit

diff --git a/contrib/bugzilla-submit/README b/contrib/bugzilla-submit/README
new file mode 100644 (file)
index 0000000..f9e74b9
--- /dev/null
+++ b/contrib/bugzilla-submit/README
@@ -0,0 +1,46 @@
+bugzilla-submit
+===============
+
+Authors: Christian Reis <kiko@async.com.br>
+         Eric Raymond <esr@thyrsus.com>
+
+bugzilla-submit is a simple Python program that creates bugs in a Bugzilla
+instance. It takes as input text resembling message headers (RFC-822
+formatted) via standard input, or optionally a number of commandline
+parameters. It communicates using HTTP, which allows it to work over a
+network.
+
+Requirements
+------------
+
+Its only requirement is Python 2.3 or higher; you should have the
+"python" executable in your path.
+
+Usage Notes
+-----------
+
+* Please constrain testing to your own installation of Bugzilla, or use
+* http://landfill.bugzilla.org/ for testing purposes -- opening test
+* bugs on production instances of Bugzilla is definitely not a good idea
+
+Run "bugzilla-submit --help" for a description of the possible options.
+
+An example input file, named bugdata.txt, is provided. You can pipe it
+in as standard input to bugzilla-submit, providing a Bugzilla URI through
+the command-line.
+
+Note that you must create a ~/.netrc entry to authenticate against the
+Bugzilla instance. The entry's machine field is a *quoted* Bugzilla URI,
+the login field is your ID on that host, and the password field is the
+your password password. An example entry follows:
+
+    machine "http://bugzilla.mozilla.org/"
+    login foo@bar.loo
+    password snarf
+
+Documentation
+-------------
+
+Documentation for bugzilla-submit is provided in Docbook format; see
+bugzilla-submit.xml.
+

diff --git a/contrib/bugzilla-submit/bugdata.txt b/contrib/bugzilla-submit/bugdata.txt
new file mode 100755 (executable)
index 0000000..fc88016
--- /dev/null
+++ b/contrib/bugzilla-submit/bugdata.txt
@@ -0,0 +1,13 @@
+Product: FoodReplicator
+Component: Salt
+Version: 1.0
+Priority: P2
+Hardware: PC
+OS: Linux
+Severity: critical
+Summary: Impending electron shortage
+Depends-on: 8
+URL: http://www.google.com/
+
+We need an emergency supply of electrons.
+

diff --git a/contrib/bugzilla-submit/bugzilla-submit b/contrib/bugzilla-submit/bugzilla-submit
new file mode 100755 (executable)
index 0000000..9cd3349
--- /dev/null
+++ b/contrib/bugzilla-submit/bugzilla-submit
@@ -0,0 +1,307 @@
+#!/usr/bin/env python
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+# bugzilla-submit: a command-line script to post bugs to a Bugzilla instance
+#
+# Authors: Christian Reis <kiko@async.com.br>
+#          Eric S. Raymond <esr@thyrsus.com>
+#
+# This is version 0.5.
+# 
+# For a usage hint run bugzilla-submit --help
+#
+# TODO: use RDF output to pick up valid options, as in
+#   http://www.async.com.br/~kiko/mybugzilla/config.cgi?ctype=rdf
+
+import sys, string
+
+def error(m):
+    sys.stderr.write("bugzilla-submit: %s\n" % m)
+    sys.stderr.flush()
+    sys.exit(1)
+
+version = string.split(string.split(sys.version)[0], ".")[:2]
+if map(int, version) < [2, 3]:
+    error("you must upgrade to Python 2.3 or higher to use this script.")
+
+import urllib, re, os, netrc, email.Parser, optparse
+
+class ErrorURLopener(urllib.URLopener):
+    """URLopener that handles HTTP 404s"""
+    def http_error_404(self, url, fp, errcode, errmsg, headers, *extra):
+        raise ValueError, errmsg # 'File Not Found'
+
+# Set up some aliases -- partly to hide the less friendly fieldnames
+# behind the names actually used for them in the stock web page presentation,
+# and partly to provide a place for mappings if the Bugzilla fieldnames
+# ever change.
+field_aliases = (('hardware', 'rep_platform'),
+                 ('os', 'op_sys'),
+                 ('summary', 'short_desc'),
+                 ('description', 'comment'),
+                 ('depends_on', 'dependson'),
+                 ('status', 'bug_status'),
+                 ('severity', 'bug_severity'),
+                 ('url', 'bug_file_loc'),)
+
+def header_to_field(hdr):
+    hdr = hdr.lower().replace("-", "_")
+    for (alias, name) in field_aliases:
+        if hdr == alias:
+            hdr = name
+            break
+    return hdr
+
+def field_to_header(hdr):
+    hdr = "-".join(map(lambda x: x.capitalize(), hdr.split("_")))
+    for (alias, name) in field_aliases:
+        if hdr == name:
+            hdr = alias
+            break
+    return hdr
+
+def setup_parser():
+    # Take override values from the command line
+    parser = optparse.OptionParser(usage="usage: %prog [options] bugzilla-url")
+    parser.add_option('-b', '--status', dest='bug_status',
+                      help='Set the Status field.')
+    parser.add_option('-u', '--url', dest='bug_file_loc',
+                      help='Set the URL field.')
+    parser.add_option('-p', '--product', dest='product',
+                      help='Set the Product field.')
+    parser.add_option('-v', '--version', dest='version',
+                      help='Set the Version field.')
+    parser.add_option('-c', '--component', dest='component',
+                      help='Set the Component field.')
+    parser.add_option('-s', '--summary', dest='short_desc',
+                      help='Set the Summary field.')
+    parser.add_option('-H', '--hardware', dest='rep_platform',
+                      help='Set the Hardware field.')
+    parser.add_option('-o', '--os', dest='op_sys',
+                      help='Set the Operating System field.')
+    parser.add_option('-r', '--priority', dest='priority',
+                      help='Set the Priority field.')
+    parser.add_option('-x', '--severity', dest='bug_severity',
+                      help='Set the Severity field.')
+    parser.add_option('-d', '--description', dest='comment',
+                      help='Set the Description field.')
+    parser.add_option('-a', '--assigned-to', dest='assigned_to',
+                      help='Set the Assigned-To field.')
+    parser.add_option('-C', '--cc', dest='cc',
+                      help='Set the Cc field.')
+    parser.add_option('-k', '--keywords', dest='keywords',
+                      help='Set the Keywords field.')
+    parser.add_option('-D', '--depends-on', dest='dependson',
+                      help='Set the Depends-On field.')
+    parser.add_option('-B', '--blocked', dest='blocked',
+                      help='Set the Blocked field.')
+    parser.add_option('-n', '--no-stdin', dest='read',
+                      default=True, action='store_false',
+                      help='Suppress reading fields from stdin.')
+    return parser
+
+# Fetch user's credential for access to this Bugzilla instance.
+def get_credentials(bugzilla):
+    # Work around a quirk in the Python implementation.
+    # The URL has to be quoted, otherwise the parser barfs on the colon.
+    # But the parser doesn't strip the quotes.
+    authenticate_on = '"' + bugzilla + '"'
+    try:
+        credentials = netrc.netrc()
+    except netrc.NetrcParseError, e:
+        error("ill-formed .netrc: %s:%s %s" % (e.filename, e.lineno, e.msg))
+    except IOError, e:
+        error("missing .netrc file %s" % str(e).split()[-1])
+    ret = credentials.authenticators(authenticate_on)
+    if not ret:
+        # Okay, the literal string passed in failed. Just to make sure,
+        # try adding/removing a slash after the address and looking
+        # again. We don't know what format was used in .netrc, which is
+        # why this rather hackish approach is necessary.
+        if bugzilla[-1] == "/":
+            authenticate_on = '"' + bugzilla[:-1] + '"'
+        else:
+            authenticate_on = '"' + bugzilla + '/"'
+        ret = credentials.authenticators(authenticate_on)
+    if not ret:
+        # Apparently, an invalid machine URL will cause credentials == None
+        error("no credentials for Bugzilla instance at %s" % bugzilla)
+    return ret
+
+def process_options(options):
+    data = {}
+    # Initialize bug report fields from message on standard input
+    if options.read:
+        message_parser = email.Parser.Parser()
+        message = message_parser.parse(sys.stdin)
+        for (key, value) in message.items():
+            data.update({header_to_field(key) : value})
+        if not 'comment' in data:
+            data['comment'] = message.get_payload() 
+
+    # Merge in options from the command line; they override what's on stdin.
+    for (key, value) in options.__dict__.items():
+        if key != 'read' and value != None:
+            data[key] = value
+    return data
+
+def ensure_defaults(data):
+    # Provide some defaults if the user did not supply them.
+    if 'op_sys' not in data:
+        if sys.platform.startswith('linux'):
+            data['op_sys'] = 'Linux'
+    if 'rep_platform' not in data:
+        data['rep_platform'] = 'PC'
+    if 'bug_status' not in data:
+        data['bug_status'] = 'CONFIRMED'
+    if 'bug_severity' not in data:
+        data['bug_severity'] = 'normal'
+    if 'bug_file_loc' not in data:
+        data['bug_file_loc'] = 'http://'        # Yes, Bugzilla needs this
+    if 'priority' not in data:
+        data['priority'] = 'Normal'
+
+def validate_fields(data):
+    # Fields for validation
+    required_fields = (
+        "bug_status", "bug_file_loc", "product", "version", "component",
+        "short_desc", "rep_platform", "op_sys", "priority", "bug_severity",
+        "comment",
+    )
+    legal_fields = required_fields + (
+        "assigned_to", "cc", "keywords", "dependson", "blocked",
+    )
+    my_fields = data.keys()
+    for field in my_fields:
+        if field not in legal_fields:
+            error("invalid field: %s" % field_to_header(field))
+    for field in required_fields:
+        if field not in my_fields:
+            error("required field missing: %s" % field_to_header(field))
+    
+    if not data['short_desc']:
+        error("summary for bug submission must not be empty")
+    
+    if not data['comment']:
+        error("comment for bug submission must not be empty")
+
+#
+# POST-specific functions
+#
+
+def submit_bug_POST(bugzilla, data):
+    # Move the request over the wire
+    postdata = urllib.urlencode(data)
+    try:
+        url = ErrorURLopener().open("%s/post_bug.cgi" % bugzilla, postdata)
+    except ValueError:
+        error("Bugzilla site at %s not found (HTTP returned 404)" % bugzilla)
+    ret = url.read()
+    check_result_POST(ret, data)
+
+def check_result_POST(ret, data):
+    # XXX We can move pre-validation out of here as soon as we pick up
+    # the valid options from config.cgi -- it will become a simple
+    # assertion and ID-grabbing step.
+    #
+    # XXX: We use get() here which may return None, but since the user
+    # might not have provided these options, we don't want to die on
+    # them.
+    version = data.get('version')
+    product = data.get('product')
+    component = data.get('component')
+    priority = data.get('priority')
+    severity = data.get('bug_severity')
+    status = data.get('bug_status')
+    assignee = data.get('assigned_to')
+    platform = data.get('rep_platform')
+    opsys = data.get('op_sys')
+    keywords = data.get('keywords')
+    deps = data.get('dependson', '') + " " + data.get('blocked', '') 
+    deps = deps.replace(" ", ", ")
+    # XXX: we should really not be using plain find() here, as it can
+    # match the bug content inadvertedly
+    if ret.find("A legal Version was not") != -1:
+        error("version %r does not exist for component %s:%s" % 
+                (version, product, component))
+    if ret.find("A legal Priority was not") != -1:
+        error("priority %r does not exist in "
+              "this Bugzilla instance" % priority)
+    if ret.find("A legal Severity was not") != -1:
+        error("severity %r does not exist in "
+              "this Bugzilla instance" % severity)
+    if ret.find("A legal Status was not") != -1:
+        error("status %r is not a valid creation status in "
+              "this Bugzilla instance" % status)
+    if ret.find("A legal Platform was not") != -1:
+        error("platform %r is not a valid platform in "
+              "this Bugzilla instance" % platform)
+    if ret.find("A legal OS/Version was not") != -1:
+        error("%r is not a valid OS in "
+              "this Bugzilla instance" % opsys)
+    if ret.find("Invalid Username") != -1:
+        error("invalid credentials submitted")
+    if ret.find("Component Needed") != -1:
+        error("the component %r does not exist in "
+              "this Bugzilla instance" % component)
+    if ret.find("Unknown Keyword") != -1:
+        error("keyword(s) %r not registered in "
+              "this Bugzilla instance" % keywords)
+    if ret.find("The product name") != -1:
+        error("product %r does not exist in this "
+              "Bugzilla instance" % product)
+    # XXX: this should be smarter
+    if ret.find("does not exist") != -1:
+        error("could not mark dependencies for bugs %s: one or "
+              "more bugs didn't exist in this Bugzilla instance" % deps)
+    if ret.find("Match Failed") != -1:
+        # XXX: invalid CC hits on this error too
+        error("the bug assignee %r isn't registered in " 
+              "this Bugzilla instance" % assignee)
+    # If all is well, return bug number posted
+    if ret.find("process_bug.cgi") == -1:
+        error("could not post bug to %s: are you sure this "
+              "is Bugzilla instance's top-level directory?" % bugzilla)
+    m = re.search("Bug ([0-9]+) Submitted", ret)
+    if not m:
+        print ret
+        error("Internal error: bug id not found; please report a bug")
+    id = m.group(1)
+    print "Bug %s posted." % id
+
+#
+#
+#
+
+if __name__ == "__main__":
+    parser = setup_parser()
+
+    # Parser will print help and exit here if we specified --help
+    (options, args) = parser.parse_args()
+
+    if len(args) != 1:
+        parser.error("missing Bugzilla host URL")
+
+    bugzilla = args[0]
+    data = process_options(options)
+
+    login, account, password = get_credentials(bugzilla)
+    if "@" not in login:   # no use even trying to submit
+        error("login %r is invalid (it should be an email address)" % login)
+
+    ensure_defaults(data)
+    validate_fields(data)
+
+    # Attach authentication information
+    data.update({'Bugzilla_login'    : login,
+                 'Bugzilla_password' : password,
+                 'GoAheadAndLogIn'   : 1,
+                 'form_name'         : 'enter_bug'})
+
+    submit_bug_POST(bugzilla, data)

diff --git a/contrib/bugzilla-submit/bugzilla-submit.xml b/contrib/bugzilla-submit/bugzilla-submit.xml
new file mode 100755 (executable)
index 0000000..2cfdc92
--- /dev/null
+++ b/contrib/bugzilla-submit/bugzilla-submit.xml
@@ -0,0 +1,227 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<!DOCTYPE refentry PUBLIC 
+   "-//OASIS//DTD DocBook XML V4.1.2//EN"
+   "docbook/docbookx.dtd">
+<refentry id='bugzilla-submit.1'>
+<refmeta>
+<refentrytitle>bugzilla-submit</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='date'>Oct 30, 2003</refmiscinfo>
+</refmeta>
+<refnamediv id='name'>
+<refname>bugzilla-submit</refname>
+<refpurpose>post bugs to a Bugzilla instance</refpurpose>
+</refnamediv>
+<refsynopsisdiv id='synopsis'>
+
+<cmdsynopsis>
+  <command>bugzilla-submit</command>
+  <arg choice='opt'>--status <replaceable>bug_status</replaceable></arg>
+  <arg choice='opt'>--url <replaceable>bug_file_loc</replaceable></arg>
+  <arg choice='opt'>--product <replaceable>product</replaceable></arg>
+  <arg choice='opt'>--version <replaceable>version</replaceable></arg>
+  <arg choice='opt'>--component <replaceable>component</replaceable></arg>
+  <arg choice='opt'>--summary <replaceable>short_desc</replaceable></arg>
+  <arg choice='opt'>--hardware <replaceable>rep_platform</replaceable></arg>
+  <arg choice='opt'>--os <replaceable>op_sys</replaceable></arg>
+  <arg choice='opt'>--priority <replaceable>priority</replaceable></arg>
+  <arg choice='opt'>--severity <replaceable>bug_severity</replaceable></arg>
+  <arg choice='opt'>--assigned-to <replaceable>assigned-to</replaceable></arg>
+  <arg choice='opt'>--cc <replaceable>cc</replaceable></arg>
+  <arg choice='opt'>--keywords <replaceable>keywords</replaceable></arg>
+  <arg choice='opt'>--depends-on <replaceable>dependson</replaceable></arg>
+  <arg choice='opt'>--blocked <replaceable>blocked</replaceable></arg>
+  <arg choice='opt'>--description <replaceable>comment</replaceable></arg>
+  <arg choice='opt'>--no-stdin </arg>
+  <arg choice='plain'><replaceable>bugzilla-url</replaceable></arg>
+</cmdsynopsis>
+
+</refsynopsisdiv>
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+
+<para><application>bugzilla-submit</application> is a command-line tool
+for posting bug reports to any instance of Bugzilla.  It accepts on
+standard input text resembling an RFC-822 message.  The headers of
+that message, and its body, are used to set error-report field values.
+More field values are merged in from command-line options. If required
+fields have not been set, <application>bugzilla-submit</application>
+tries to compute them.  Finally, the resulting error report is
+validated.  If all required fields are present, and there are no
+illegal fields or values, the report is shipped off to the Mozilla
+instance specified by the single positional argument.  Login/password
+credentials are read from the calling user's <filename>~/.netrc</filename> 
+file.</para>
+
+<para>bugzilla-submit accepts a single argument:
+<replaceable>bugzilla-url</replaceable>. Its value must match the
+relevant Bugzilla instance's base URL (technically, its
+<replaceable>urlbase</replaceable> param). The program also accepts the
+following options to set or override fields:</para>
+<variablelist>
+<varlistentry>
+<term>-b, --status</term>
+<listitem>
+<para>Set the bug_status field, overriding the Status header from
+standard input if present.  (The stock Bugzilla web presentation
+identifies this field as <quote>Status</quote>.)</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>-u, --url</term>
+<listitem>
+<para>Set the bug_file_loc field, overriding the URL header from
+standard input if present. (The stock Bugzilla web presentation
+identifies this field as <quote>URL</quote>.)</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>-p, --product</term>
+<listitem>
+<para>Set the product field, overriding the Product header from
+standard input if necessary.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>-v, --version</term>
+<listitem><para>Set the version field, overriding the Version header
+from standard input if necessary.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>-c, --component</term>
+<listitem><para>Set the component field, overriding the Component header
+from standard input if necessary.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>-s, --summary</term>
+<listitem><para>Set the short_desc field, overriding the Summary header
+from standard input if necessary. (The stock Bugzilla web presentation
+identifies this field as <quote>Summary</quote>.)</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>-H, --hardware</term>
+<listitem><para>Set the rep_platform field, overriding the Hardware header
+from standard input if necessary. (The stock Bugzilla web presentation
+identifies this field as <quote>Hardware</quote>.)</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>-o, --os</term>
+<listitem><para>Set the op_sys field, overriding the OS (Operating
+System) header from standard input if necessary. (The stock Bugzilla web
+presentation also identifies this field as
+<quote>OS</quote>.)</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>-r, --priority</term>
+<listitem><para>Set the priority field, overriding the Priority header
+from standard input if necessary.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>-x, --severity</term>
+<listitem><para>Set the severity field, overriding the Severity header
+from standard input if necessary.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>-d, --description</term>
+<listitem><para>Set the comment field, overriding the Description header
+from standard input if necessary. (The stock Bugzilla web presentation
+identifies this field as <quote>Description</quote>.)  If there is a
+message body and no Description field and this option is not
+specified, the message body is used as a description.
+</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>-a, --assigned-to</term>
+<listitem>
+<para>Set the optional assigned_to field, overriding the Assigned-To
+header from standard input if necessary.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>-C, --cc</term>
+<listitem>
+<para>Set the optional cc field, overriding the Cc
+header from standard input if necessary.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>-k, --keywords</term>
+<listitem>
+<para>Set the optional keywords field, overriding the Keywords
+header from standard input if necessary.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>-D, --depends-on</term>
+<listitem>
+<para>Set the optional dependson field, overriding the Depends-On
+header from standard input if necessary.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>-B, --assigned-to</term>
+<listitem>
+<para>Set the optional blocked field, overriding the Blocked
+header from standard input if necessary.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>-n, --no-stdin</term>
+<listitem><para>Suppress reading fields from standard input.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>-h, --help</term>
+<listitem><para>Print usage help and exit.</para></listitem>
+</varlistentry>
+</variablelist>
+
+<para>This program will try to deduce OS and Hardware if those are not
+specified.  If it fails, validation will fail before shipping the
+report.</para>
+
+<para>There is expected to be a single positional argument following
+any options. It should be the URL of the Bugzilla instance to which
+the bug is to be submitted.</para>
+
+</refsect1>
+<refsect1 id='files'><title>FILES</title> 
+<variablelist>
+<varlistentry>
+<term><filename>~/.netrc</filename></term>
+<listitem><para>Must contain an entry in which the machine field is
+the Bugzilla instance URL, the login field is your ID on that host, and the 
+password field is the right password.  The URL in the machine field
+must be enclosed in double quotes.</para>
+
+<para>For example, if your Bugzilla instance is at
+"http://landfill.bugzilla.org/bztest/", and your login and password
+there are "john@doe.com" and "foo", respectively, your
+<filename>.netrc</filename> entry should look something like:</para>
+
+<screen>
+    machine "http://landfill.bugzilla.org/bztest/"
+    login john@doe.com
+    password foo
+
+</screen>
+
+<para>Note that the machine entry should match exactly the instance URL
+specified to <application>bugzilla-submit</application>.</para>
+
+</listitem>
+</varlistentry>
+</variablelist>
+
+</refsect1>
+<refsect1 id='author'><title>AUTHORS</title> 
+<para>Christian Reis &lt;kiko@async.com.br&gt;, Eric S. Raymond
+&lt;esr@thyrsus.com&gt;.</para> 
+</refsect1> 
+</refentry>

diff --git a/contrib/bz_webservice_demo.pl b/contrib/bz_webservice_demo.pl
new file mode 100755 (executable)
index 0000000..3b87cf5
--- /dev/null
+++ b/contrib/bz_webservice_demo.pl
@@ -0,0 +1,434 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+=head1 NAME
+
+bz_webservice_demo.pl - Show how to talk to Bugzilla via XMLRPC
+
+=head1 SYNOPSIS
+
+C<bz_webservice_demo.pl [options]>
+
+C<bz_webservice_demo.pl --help> for detailed help
+
+=cut
+
+use strict;
+use lib qw(lib);
+use Getopt::Long;
+use Pod::Usage;
+use File::Basename qw(dirname);
+use File::Spec;
+use HTTP::Cookies;
+use XMLRPC::Lite;
+
+# If you want, say “use Bugzilla::WebService::Constants” here to get access
+# to Bugzilla's web service error code constants.
+# If you do this, remember to issue a “use lib” pointing to your Bugzilla
+# installation directory, too.
+
+my $help;
+my $Bugzilla_uri;
+my $Bugzilla_login;
+my $Bugzilla_password;
+my $Bugzilla_remember;
+my $bug_id;
+my $product_name;
+my $create_file_name;
+my $legal_field_values;
+my $add_comment;
+my $private;
+my $work_time;
+my $fetch_extension_info = 0;
+my $debug;
+
+GetOptions('help|h|?'       => \$help,
+           'uri=s'          => \$Bugzilla_uri,
+           'login:s'        => \$Bugzilla_login,
+           'password=s'     => \$Bugzilla_password,
+           'rememberlogin!' => \$Bugzilla_remember,
+           'bug_id:s'       => \$bug_id,
+           'product_name:s' => \$product_name,
+           'create:s'       => \$create_file_name,
+           'field:s'        => \$legal_field_values,
+           'comment:s'      => \$add_comment,
+           'private:i'      => \$private,
+           'worktime:f'     => \$work_time,
+           'extension_info' => \$fetch_extension_info,
+           'debug'          => \$debug
+          ) or pod2usage({'-verbose' => 0, '-exitval' => 1});
+
+=head1 OPTIONS
+
+=over
+
+=item --help, -h, -?
+
+Print a short help message and exit.
+
+=item --uri
+
+URI to Bugzilla's C<xmlrpc.cgi> script, along the lines of
+C<http://your.bugzilla.installation/path/to/bugzilla/xmlrpc.cgi>.
+
+=item --login
+
+Bugzilla login name. Specify this together with B<--password> in order to log in.
+
+Specify this without a value in order to log out.
+
+=item --password
+
+Bugzilla password. Specify this together with B<--login> in order to log in.
+
+=item --rememberlogin
+
+Gives access to Bugzilla's "Bugzilla_remember" option.
+Specify this option while logging in to do the same thing as ticking the
+C<Bugzilla_remember> box on Bugilla's log in form.
+Don't specify this option to do the same thing as unchecking the box.
+
+See Bugzilla's rememberlogin parameter for details.
+
+=item --bug_id
+
+Pass a bug ID to have C<bz_webservice_demo.pl> do some bug-related test calls.
+
+=item --product_name
+
+Pass a product name to have C<bz_webservice_demo.pl> do some product-related
+test calls.
+
+=item --create
+
+Specify a file that contains settings for the creating of a new bug.
+
+=item --field
+
+Pass a field name to get legal values for this field. It must be either a
+global select field (such as bug_status, resolution, rep_platform, op_sys,
+priority, bug_severity) or a custom select field.
+
+=item --comment
+
+A comment to add to a bug identified by B<--bug_id>. You must also pass a B<--login>
+and B<--password> to log in to Bugzilla.
+
+=item --private
+
+An optional non-zero value to specify B<--comment> as private.
+
+=item --worktime
+
+An optional double precision number specifying the work time for B<--comment>.
+
+=item --extension_info
+
+If specified on the command line, the script returns the information about the
+extensions that are installed.
+
+=item --debug
+
+Enable tracing at the debug level of XMLRPC requests and responses.
+
+=back
+
+=head1 DESCRIPTION
+
+=cut
+
+pod2usage({'-verbose' => 1, '-exitval' => 0}) if $help;
+_syntaxhelp('URI unspecified') unless $Bugzilla_uri;
+
+# We will use this variable for SOAP call results.
+my $soapresult;
+
+# We will use this variable for function call results.
+my $result;
+
+# Open our cookie jar. We save it into a file so that we may re-use cookies
+# to avoid the need of logging in every time. You're encouraged, but not
+# required, to do this in your applications, too.
+# Cookies are only saved if Bugzilla's rememberlogin parameter is set to one of
+#    - on
+#    - defaulton (and you didn't pass 0 as third parameter to User.login)
+#    - defaultoff (and you passed 1 as third parameter to User.login)
+my $cookie_jar =
+    new HTTP::Cookies('file' => File::Spec->catdir(dirname($0), 'cookies.txt'),
+                      'autosave' => 1);
+
+=head2 Initialization
+
+Using the XMLRPC::Lite class, you set up a proxy, as shown in this script.
+Bugzilla's XMLRPC URI ends in C<xmlrpc.cgi>, so your URI looks along the lines
+of C<http://your.bugzilla.installation/path/to/bugzilla/xmlrpc.cgi>.
+
+=cut
+
+my $proxy = XMLRPC::Lite->proxy($Bugzilla_uri,
+                                'cookie_jar' => $cookie_jar);
+
+=head2 Debugging
+
+Enable tracing at the debug level of XMLRPC requests and responses if requested.
+
+=cut
+
+if ($debug) {
+   $proxy->import(+trace => 'debug');
+}
+
+=head2 Checking Bugzilla's version
+
+To make sure the Bugzilla you're connecting to supports the methods you wish to
+call, you may want to compare the result of C<Bugzilla.version> to the
+minimum required version your application needs.
+
+=cut
+
+$soapresult = $proxy->call('Bugzilla.version');
+_die_on_fault($soapresult);
+print 'Connecting to a Bugzilla of version ' . $soapresult->result()->{version} . ".\n";
+
+=head2 Checking Bugzilla's timezone
+
+To make sure that you understand the dates and times that Bugzilla returns to you, you may want to call C<Bugzilla.timezone>.
+
+=cut
+
+$soapresult = $proxy->call('Bugzilla.timezone');
+_die_on_fault($soapresult);
+print 'Bugzilla\'s timezone is ' . $soapresult->result()->{timezone} . ".\n";
+
+=head2 Getting Extension Information
+
+Returns all the information any extensions have decided to provide to the webservice.
+
+=cut
+
+if ($fetch_extension_info) {
+    $soapresult = $proxy->call('Bugzilla.extensions');
+    _die_on_fault($soapresult);
+    my $extensions = $soapresult->result()->{extensions};
+    foreach my $extensionname (keys(%$extensions)) {
+        print "Extension '$extensionname' information\n";
+        my $extension = $extensions->{$extensionname};
+        foreach my $data (keys(%$extension)) {
+            print '  ' . $data . ' => ' . $extension->{$data} . "\n";
+        }
+    }
+}
+
+=head2 Logging In and Out
+
+=head3 Using Bugzilla's Environment Authentication
+
+Use a
+C<http://login:password@your.bugzilla.installation/path/to/bugzilla/xmlrpc.cgi>
+style URI.
+You don't log out if you're using this kind of authentication.
+
+=head3 Using Bugzilla's CGI Variable Authentication
+
+Use the C<User.login> and C<User.logout> calls to log in and out, as shown
+in this script.
+
+The C<Bugzilla_remember> parameter is optional.
+If omitted, Bugzilla's defaults apply (as specified by its C<rememberlogin>
+parameter).
+
+Bugzilla hands back cookies you'll need to pass along during your work calls.
+
+=cut
+
+if (defined($Bugzilla_login)) {
+    if ($Bugzilla_login ne '') {
+        # Log in.
+        $soapresult = $proxy->call('User.login',
+                                   { login => $Bugzilla_login, 
+                                     password => $Bugzilla_password,
+                                     remember => $Bugzilla_remember } );
+        _die_on_fault($soapresult);
+        print "Login successful.\n";
+    }
+    else {
+        # Log out.
+        $soapresult = $proxy->call('User.logout');
+        _die_on_fault($soapresult);
+        print "Logout successful.\n";
+    }
+}
+
+=head2 Retrieving Bug Information
+
+Call C<Bug.get> with the ID of the bug you want to know more of.
+The call will return a C<Bugzilla::Bug> object. 
+
+Note: You can also use "Bug.get_bugs" for compatibility with Bugzilla 3.0 API.
+
+=cut
+
+if ($bug_id) {
+    $soapresult = $proxy->call('Bug.get', { ids => [$bug_id] });
+    _die_on_fault($soapresult);
+    $result = $soapresult->result;
+    my $bug = $result->{bugs}->[0];
+    foreach my $field (keys(%$bug)) {
+        my $value = $bug->{$field};
+        if (ref($value) eq 'HASH') {
+            foreach (keys %$value) {
+                print "$_: " . $value->{$_} . "\n";
+            }
+        }
+        else {
+            print "$field: $value\n";
+        }
+    }
+}
+
+=head2 Retrieving Product Information
+
+Call C<Product.get> with the name of the product you want to know more of.
+The call will return a C<Bugzilla::Product> object.
+
+=cut
+
+if ($product_name) {
+    $soapresult = $proxy->call('Product.get', {'names' => [$product_name]});
+    _die_on_fault($soapresult);
+    $result = $soapresult->result()->{'products'}->[0];
+
+    # Iterate all entries, the values may be scalars or array refs with hash refs.
+    foreach my $key (sort(keys %$result)) {
+      my $value = $result->{$key};
+
+      if (ref($value)) {
+        my $counter = 0;
+        foreach my $hash (@$value) {
+          while (my ($innerKey, $innerValue) = each %$hash) {
+            print "$key.$counter.$innerKey: $innerValue\n";
+          }
+          ++$counter;
+        }
+      }
+      else {
+        print "$key: $value\n"
+      }
+    }
+}
+
+=head2 Creating A Bug
+
+Call C<Bug.create> with the settings read from the file indicated on
+the command line. The file must contain a valid anonymous hash to use 
+as argument for the call to C<Bug.create>.
+The call will return a hash with a bug id for the newly created bug.
+
+=cut
+
+if ($create_file_name) {
+    $soapresult = $proxy->call('Bug.create', do "$create_file_name" );
+    _die_on_fault($soapresult);
+    $result = $soapresult->result;
+
+    if (ref($result) eq 'HASH') {
+        foreach (keys(%$result)) {
+            print "$_: $$result{$_}\n";
+        }
+    }
+    else {
+        print "$result\n";
+    }
+
+}
+
+=head2 Getting Legal Field Values
+
+Call C<Bug.legal_values> with the name of the field (including custom
+select fields). The call will return a reference to an array with the
+list of legal values for this field.
+
+=cut
+
+if ($legal_field_values) {
+    $soapresult = $proxy->call('Bug.legal_values', {field => $legal_field_values} );
+    _die_on_fault($soapresult);
+    $result = $soapresult->result;
+
+    print join("\n", @{$result->{values}}) . "\n";
+}
+
+=head2 Adding a comment to a bug
+
+Call C<Bug.add_comment> with the bug id, the comment text, and optionally the number
+of hours you worked on the bug, and a boolean indicating if the comment is private
+or not.
+
+=cut
+
+if ($add_comment) {
+    if ($bug_id) {
+        $soapresult = $proxy->call('Bug.add_comment', {id => $bug_id,
+            comment => $add_comment, private => $private, work_time => $work_time});
+        _die_on_fault($soapresult);
+        print "Comment added.\n";
+    }
+    else {
+        print "A --bug_id must be supplied to add a comment.";
+    }
+}
+
+=head1 NOTES
+
+=head2 Character Set Encoding
+
+Make sure that your application either uses the same character set
+encoding as Bugzilla does, or that it converts correspondingly when using the
+web service API.
+By default, Bugzilla uses UTF-8 as its character set encoding.
+
+=head2 Format For Create File
+
+The create format file is a piece of Perl code, that should look something like
+this:
+
+    {
+        product     => "TestProduct", 
+        component   => "TestComponent",
+        summary     => "TestBug - created from bz_webservice_demo.pl",
+        version     => "unspecified",
+        description => "This is a description of the bug... hohoho",
+        op_sys      => "All",
+        platform    => "All",  
+        priority    => "P4",
+        severity    => "normal"
+    };
+
+=head1 SEE ALSO
+
+There are code comments in C<bz_webservice_demo.pl> which might be of further
+help to you.
+
+=cut
+
+sub _die_on_fault {
+    my $soapresult = shift;
+
+    if ($soapresult->fault) {
+        my ($package, $filename, $line) = caller;
+        die $soapresult->faultcode . ' ' . $soapresult->faultstring .
+            " in SOAP call near $filename line $line.\n";
+    }
+}
+
+sub _syntaxhelp {
+    my $msg = shift;
+
+    print "Error: $msg\n";
+    pod2usage({'-verbose' => 0, '-exitval' => 1});
+}

diff --git a/contrib/bzdbcopy.pl b/contrib/bzdbcopy.pl
new file mode 100755 (executable)
index 0000000..f50002e
--- /dev/null
+++ b/contrib/bzdbcopy.pl
@@ -0,0 +1,251 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::DB;
+use Bugzilla::Install::Util qw(indicate_progress);
+use Bugzilla::Util;
+
+#####################################################################
+# User-Configurable Settings
+#####################################################################
+
+# Settings for the 'Source' DB that you are copying from.
+use constant SOURCE_DB_TYPE => 'Mysql';
+use constant SOURCE_DB_NAME => 'bugs';
+use constant SOURCE_DB_USER => 'bugs';
+use constant SOURCE_DB_PASSWORD => '';
+use constant SOURCE_DB_HOST => 'localhost';
+
+# Settings for the 'Target' DB that you are copying to.
+use constant TARGET_DB_TYPE => 'Pg';
+use constant TARGET_DB_NAME => 'bugs';
+use constant TARGET_DB_USER => 'bugs';
+use constant TARGET_DB_PASSWORD => '';
+use constant TARGET_DB_HOST => 'localhost';
+
+#####################################################################
+# MAIN SCRIPT
+#####################################################################
+
+print "Connecting to the '" . SOURCE_DB_NAME . "' source database on " 
+      . SOURCE_DB_TYPE . "...\n";
+my $source_db = Bugzilla::DB::_connect({
+    db_driver => SOURCE_DB_TYPE, 
+    db_host   => SOURCE_DB_HOST, 
+    db_name   => SOURCE_DB_NAME, 
+    db_user   => SOURCE_DB_USER, 
+    db_pass   => SOURCE_DB_PASSWORD,
+});
+# Don't read entire tables into memory.
+if (SOURCE_DB_TYPE eq 'Mysql') {
+    $source_db->{'mysql_use_result'} = 1;
+
+    # MySQL cannot have two queries running at the same time. Ensure the schema
+    # is loaded from the database so bz_column_info will not execute a query
+    $source_db->_bz_real_schema;
+}
+
+print "Connecting to the '" . TARGET_DB_NAME . "' target database on "
+      . TARGET_DB_TYPE . "...\n";
+my $target_db = Bugzilla::DB::_connect({
+    db_driver => TARGET_DB_TYPE,
+    db_host   => TARGET_DB_HOST, 
+    db_name   => TARGET_DB_NAME, 
+    db_user   => TARGET_DB_USER,
+    db_pass   => TARGET_DB_PASSWORD,
+});
+my $ident_char = $target_db->get_info( 29 ); # SQL_IDENTIFIER_QUOTE_CHAR
+
+# We use the table list from the target DB, because if somebody
+# has customized their source DB, we still want the script to work,
+# and it may otherwise fail in that situation (that is, the tables
+# may not exist in the target DB).
+#
+# We don't want to copy over the bz_schema table's contents, though.
+my @table_list = grep { $_ ne 'bz_schema' } $target_db->bz_table_list_real();
+
+# Instead of figuring out some fancy algorithm to insert data in the right
+# order and not break FK integrity, we just drop them all.
+$target_db->bz_drop_foreign_keys();
+# We start a transaction on the target DB, which helps when we're doing
+# so many inserts.
+$target_db->bz_start_transaction();
+foreach my $table (@table_list) {
+    my @serial_cols;
+    print "Reading data from the source '$table' table on " 
+          . SOURCE_DB_TYPE . "...\n";
+    my @table_columns = $target_db->bz_table_columns_real($table);
+    # The column names could be quoted using the quote identifier char
+    # Remove these chars as different databases use different quote chars
+    @table_columns = map { s/^\Q$ident_char\E?(.*?)\Q$ident_char\E?$/$1/; $_ }
+                         @table_columns;
+
+    my ($total) = $source_db->selectrow_array("SELECT COUNT(*) FROM $table");
+    my $select_query = "SELECT " . join(',', @table_columns) . " FROM $table";
+    my $select_sth = $source_db->prepare($select_query);
+    $select_sth->execute();
+
+    my $insert_query = "INSERT INTO $table ( " . join(',', @table_columns) 
+                       . " ) VALUES (";
+    $insert_query .= '?,' foreach (@table_columns);
+    # Remove the last comma.
+    chop($insert_query);
+    $insert_query .= ")";
+    my $insert_sth = $target_db->prepare($insert_query);
+
+    print "Clearing out the target '$table' table on " 
+          . TARGET_DB_TYPE . "...\n";
+    $target_db->do("DELETE FROM $table");
+
+    # Oracle doesn't like us manually inserting into tables that have
+    # auto-increment PKs set, because of the way we made auto-increment
+    # fields work.
+    if ($target_db->isa('Bugzilla::DB::Oracle')) {
+        foreach my $column (@table_columns) {
+            my $col_info = $source_db->bz_column_info($table, $column);
+            if ($col_info && $col_info->{TYPE} =~ /SERIAL/i) {
+                print "Dropping the sequence + trigger on $table.$column...\n";
+                $target_db->do("DROP TRIGGER ${table}_${column}_TR");
+                $target_db->do("DROP SEQUENCE ${table}_${column}_SEQ");
+            }
+        }
+    }
+    
+    print "Writing data to the target '$table' table on " 
+          . TARGET_DB_TYPE . "...\n";
+    my $count = 0;
+    while (my $row = $select_sth->fetchrow_arrayref) {
+        # Each column needs to be bound separately, because
+        # many columns need to be dealt with specially.
+        my $colnum = 0;
+        foreach my $column (@table_columns) {
+            # bind_param args start at 1, but arrays start at 0.
+            my $param_num = $colnum + 1;
+            my $already_bound;
+
+            # Certain types of columns need special handling.
+            my $col_info = $source_db->bz_column_info($table, $column);
+            if ($col_info && $col_info->{TYPE} eq 'LONGBLOB') {
+                $insert_sth->bind_param($param_num, 
+                    $row->[$colnum], $target_db->BLOB_TYPE);
+                $already_bound = 1;
+            }
+            elsif ($col_info && $col_info->{TYPE} =~ /decimal/) {
+                # In MySQL, decimal cols can be too long.
+                my $col_type = $col_info->{TYPE};
+                $col_type =~ /decimal\((\d+),(\d+)\)/;
+                my ($precision, $decimals) = ($1, $2);
+                # If it's longer than precision + decimal point
+                if ( length($row->[$colnum]) > ($precision + 1) ) {
+                    # Truncate it to the highest allowed value.
+                    my $orig_value = $row->[$colnum];
+                    $row->[$colnum] = '';
+                    my $non_decimal = $precision - $decimals;
+                    $row->[$colnum] .= '9' while ($non_decimal--);
+                    $row->[$colnum] .= '.';
+                    $row->[$colnum] .= '9' while ($decimals--);
+                    print "Truncated value $orig_value to " . $row->[$colnum] 
+                         . " for $table.$column.\n";
+                }
+            }
+            elsif ($col_info && $col_info->{TYPE} =~ /DATETIME/i) {
+                my $date = $row->[$colnum];
+                # MySQL can have strange invalid values for Datetimes.
+                $row->[$colnum] = '1901-01-01 00:00:00'
+                    if $date && $date eq '0000-00-00 00:00:00';
+            }
+
+            $insert_sth->bind_param($param_num, $row->[$colnum])
+                unless $already_bound;
+            $colnum++;
+        }
+
+        $insert_sth->execute();
+        $count++;
+        indicate_progress({ current => $count, total => $total, every => 100 });
+    }
+
+    # For some DBs, we have to do clever things with auto-increment fields.
+    foreach my $column (@table_columns) {
+        next if $target_db->isa('Bugzilla::DB::Mysql');
+        my $col_info = $source_db->bz_column_info($table, $column);
+        if ($col_info && $col_info->{TYPE} =~ /SERIAL/i) {
+            my ($max_val) = $target_db->selectrow_array(
+                    "SELECT MAX($column) FROM $table");
+            # Set the sequence to the current max value + 1.
+            $max_val = 0 if !defined $max_val;
+            $max_val++;
+            print "\nSetting the next value for $table.$column to $max_val.";
+            if ($target_db->isa('Bugzilla::DB::Pg')) {
+                # PostgreSQL doesn't like it when you insert values into
+                # a serial field; it doesn't increment the counter 
+                # automatically.
+                $target_db->bz_set_next_serial_value($table, $column);
+            }
+            elsif ($target_db->isa('Bugzilla::DB::Oracle')) {
+                # Oracle increments the counter on every insert, and *always*
+                # sets the field, even if you gave it a value. So if there
+                # were already rows in the target DB (like the default rows
+                # created by checksetup), you'll get crazy values in your
+                # id columns. So we just dropped the sequences above and
+                # we re-create them here, starting with the right number.
+                my @sql = $target_db->_bz_real_schema->_get_create_seq_ddl(
+                    $table, $column, $max_val);
+                $target_db->do($_) foreach @sql;
+            }
+        }
+    }
+
+    print "\n\n";
+}
+
+print "Committing changes to the target database...\n";
+$target_db->bz_commit_transaction();
+$target_db->bz_setup_foreign_keys();
+
+print "All done! Make sure to run checksetup.pl on the new DB.\n";
+$source_db->disconnect;
+$target_db->disconnect;
+
+1;
+
+__END__
+
+=head1 NAME
+
+bzdbcopy.pl - Copies data from one Bugzilla database to another. 
+
+=head1 DESCRIPTION
+
+The intended use of this script is to copy data from an installation
+running on one DB platform to an installation running on another
+DB platform.
+
+It must be run from the directory containing your Bugzilla installation.
+That means if this script is in the contrib/ directory, you should
+be running it as: C<./contrib/bzdbcopy.pl>
+
+Note: Both schemas must already exist and be B<IDENTICAL>. (That is, 
+they must have both been created/updated by the same version of 
+checksetup.pl.) This script will B<DESTROY ALL CURRENT DATA> in the 
+target database.
+
+Both Schemas must be at least from Bugzilla 2.19.3, but if you're
+running a Bugzilla from before 2.20rc2, you'll need the patch at:
+L<http://bugzilla.mozilla.org/show_bug.cgi?id=300311> in order to
+be able to run this script.
+
+Before you using it, you have to correctly set all the variables
+in the "User-Configurable Settings" section at the top of the script. 
+The C<SOURCE> settings are for the database you're copying from, and 
+the C<TARGET> settings are for the database you're copying to. The 
+C<DB_TYPE> is the name of a DB driver from the F<Bugzilla/DB/> directory.

diff --git a/contrib/cmdline/bugcount b/contrib/cmdline/bugcount
new file mode 100755 (executable)
index 0000000..4d3b412
--- /dev/null
+++ b/contrib/cmdline/bugcount
@@ -0,0 +1,14 @@
+#!/bin/sh
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+thisdir=`dirname "$0"`
+bugids=`$thisdir/bugids "$@"`
+if test "$?" != "0"; then echo "$bugids" 1>&2; exit 1; fi
+
+echo "$bugids" | wc -w

diff --git a/contrib/cmdline/bugids b/contrib/cmdline/bugids
new file mode 100755 (executable)
index 0000000..7cac698
--- /dev/null
+++ b/contrib/cmdline/bugids
@@ -0,0 +1,19 @@
+#!/bin/sh
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+thisdir=`dirname "$0"`
+buglist="$thisdir/buglist"
+csvfile="$thisdir/buglist.csv"
+
+$thisdir/buglist "$@" 2>&1 1>${csvfile}
+if test "$?" != "0"; then cat "$csvfile" 1>&2; exit 1; fi
+
+# 1. use 'awk' to select the first column (bug_id)
+# 2. use 'grep -v' to remove the first line with the column headers
+# 3. use backquotes & 'echo' to get all values in one line, space separated
+echo `cat ${csvfile} | awk -F, '{printf $1 "\n"}' | grep -v bug_id`

diff --git a/contrib/cmdline/buglist b/contrib/cmdline/buglist
new file mode 100755 (executable)
index 0000000..e6eaa82
--- /dev/null
+++ b/contrib/cmdline/buglist
@@ -0,0 +1,18 @@
+#!/bin/sh
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+defaultcolumnlist="severity priority platform status resolution target_milestone status_whiteboard keywords summaryfull"
+
+thisdir=`dirname "$0"`
+query=`$thisdir/makequery "$@"` 
+if test "$?" != "0"; then exit 1; fi
+
+outputfile="/dev/stdout"
+#outputfile="buglist.html"
+#\rm -f ${outputfile}
+wget -q -O ${outputfile} --header="Cookie: COLUMNLIST=${COLUMNLIST-${defaultcolumnlist}}" "${query}"

diff --git a/contrib/cmdline/bugs b/contrib/cmdline/bugs
new file mode 100755 (executable)
index 0000000..a63fd19
--- /dev/null
+++ b/contrib/cmdline/bugs
@@ -0,0 +1,13 @@
+#!/bin/sh
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+thisdir=`dirname "$0"`
+bugids=`$thisdir/bugids "$@"` || echo "$bugids" 1>&2 && exit 1
+
+echo "$bugids" | sed -e 's/ /\,/g'

diff --git a/contrib/cmdline/bugslink b/contrib/cmdline/bugslink
new file mode 100755 (executable)
index 0000000..355d954
--- /dev/null
+++ b/contrib/cmdline/bugslink
@@ -0,0 +1,14 @@
+#!/bin/sh
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+thisdir=`dirname "$0"`
+bugids=`$thisdir/bugids "$@"` || echo "$bugids" 1>&2 && exit 1
+
+bugids=`echo "$bugids" | sed -e 's/ /\,/g'`
+echo "https://bugzilla.mozilla.org/buglist.cgi?ctype=html&bug_id=$bugids"

diff --git a/contrib/cmdline/makequery b/contrib/cmdline/makequery
new file mode 100755 (executable)
index 0000000..e2008c3
--- /dev/null
+++ b/contrib/cmdline/makequery
@@ -0,0 +1,95 @@
+#!/bin/sh
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+conf="`dirname $0`/query.conf"
+
+query="https://bugzilla.mozilla.org/buglist.cgi?ctype=csv"
+
+chart=0
+and=0
+while test "X$1" != "X"; do
+    arg="$1"
+    shift
+    if test 0 != `expr "X$arg" : 'X--[^=]*\$'`; then
+        # long option: --name val (without '=')
+        name=`expr "X$arg" : 'X--\(.*\)'`
+        val="$1"
+        shift
+    elif test 0 != `expr "X$arg" : 'X--[^=][^=]*='`; then
+        # long option: --name=val
+        name=`expr "X$arg" : 'X--\([^=]*\)'`
+        val=`expr "X$arg" : 'X--[^=]*=\(.*\)'`
+    elif test 0 != `expr "X$arg" : 'X-[a-zA-Z]\$'`; then
+        # short option like -X foo (with space in between)
+        name=`expr "X$arg" : 'X-\(.\)'`
+        val="$1"
+        shift
+    elif test 0 != `expr "X$arg" : 'X-[a-zA-Z]='`; then
+       # reject things like -X=foo
+        echo "Unrecognized option $arg" 1>&2
+        echo "Use -Xfoo or -X foo instead of -X=foo" 1>&2
+        exit 1
+    elif test 0 != `expr "X$arg" : 'X-[a-zA-Z]'`; then
+        # short option like -Xfoo (without space)
+        name=`expr "X$arg" : 'X-\(.\)'`
+        val=`expr "X$arg" : 'X-.\(.*\)'`
+    else
+        name="default"
+        val="$arg"
+        #echo "Unrecognized option $arg" 1>&2
+        #exit 1
+    fi
+
+    # plausibility check: val must not be empty, nor start with '-'
+    if test "X$val" = "X"; then
+        echo "No value found for '$name'!" 1>&2
+        exit 1
+    elif test 0 != `expr "X$val" : "X-"` && \
+         test 0 = `expr "X$val" : "X---"`; then
+        echo "Suspicious value for '$name': '$val' looks like an option!" 1>&2
+        exit 1
+    fi
+
+    # find field and comparison type for option ${name}
+    field=`grep "\"$name\"" "$conf" | awk '{printf $1}'`
+    type=`grep "\"$name\"" "$conf" | awk '{printf $2}'`
+    if test "X$field" = "X"  || test "X$type" = "X"; then
+        if test "X$name" = "Xdefault"; then
+            echo 1>&2 "Error: unexpected argument '$arg'"
+            cat 1>&2 <<EOF
+Use short options like -P1 or long options like  --priority=1 ,  
+or enable the 'default' behaviour in the 'query.conf' file.
+EOF
+        else
+            echo "Unknown field name '$name'." 1>&2
+        fi
+        exit 1
+    fi
+
+    # split val into comma-separated alternative values
+    or=0
+    while test "X$val" != "X"; do
+        # val1 gets everything before the first comma; val gets the rest
+        if test 0 != `expr "X$val" : 'X[^,]*,'`; then
+            val1=`expr "X$val" : 'X\([^,]*\),'`
+           val=`expr "X$val" : 'X[^,]*,\(.*\)'`
+        else
+            val1="$val"
+            val=""
+        fi
+        # append to query
+        query="${query}&field${chart}-${and}-${or}=${field}"
+        query="${query}&type${chart}-${and}-${or}=${type}"
+        query="${query}&value${chart}-${and}-${or}=${val1}"
+        #echo "----- ${name} : ${field} : ${type} : ${val1} -----" 1>&2
+        or=`expr ${or} + 1`
+    done
+    chart=`expr ${chart} + 1`
+done
+
+echo "${query}"

diff --git a/contrib/cmdline/query.conf b/contrib/cmdline/query.conf
new file mode 100755 (executable)
index 0000000..41585a3
--- /dev/null
+++ b/contrib/cmdline/query.conf
@@ -0,0 +1,36 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+#
+# This is `query.conf', the config file for `buglist'.
+#
+# Columns: 1: field_name, 2: comparison_type, 3: cmd-line options
+#
+bug_status              substring       "s","status"
+resolution              substring       "r","resolution"
+rep_platform            substring       "p","platform"
+op_sys                  substring       "o","os","opsys"
+priority                substring       "P","priority"
+bug_severity            substring       "S","severity"
+assigned_to             substring       "A","O","owner","assignedto"
+reporter                substring       "R","reporter"
+qa_contact              substring       "Q","qa","qacontact"
+cc                      substring       "C","cc"
+product                 substring       "product"
+version                 substring       "V","version"
+component               substring       "c","component"
+target_milestone        substring       "M","milestone"
+short_desc              substring       "summary","defaultREMOVEME"
+longdesc                substring       "d","description","longdesc"
+bug_file_loc            substring       "u","url"
+status_whiteboard       substring       "w","whiteboard"
+keywords                substring       "k","K","keywords"
+attachments.description substring       "attachdesc"
+attach_data.thedata     substring       "attachdata"
+attachments.mimetype    substring       "attachmime"
+dependson               substring       # bug 30823
+blocked                 substring       # bug 30823

diff --git a/contrib/console.pl b/contrib/console.pl
new file mode 100755 (executable)
index 0000000..dbd514e
--- /dev/null
+++ b/contrib/console.pl
@@ -0,0 +1,172 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use File::Basename;
+BEGIN { chdir dirname($0) . "/.."; }
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Bug;
+
+use Term::ReadLine;
+use Data::Dumper;
+$Data::Dumper::Sortkeys = 1;
+$Data::Dumper::Terse = 1;
+$Data::Dumper::Indent = 1;
+$Data::Dumper::Useqq = 1;
+$Data::Dumper::Maxdepth = 1;
+$Data::Dumper::Deparse = 0;
+
+my $sysname = get_text('term', {term => 'Bugzilla'});
+my $term = new Term::ReadLine "$sysname Console";
+read_history($term);
+END { write_history($term) }
+
+while ( defined (my $input = $term->readline("$sysname> ")) ) {
+    my @res = eval($input);
+    if ($@) {
+        warn $@;
+    }
+    else {
+        print Dumper(@res);
+    }
+}
+print STDERR "\n";
+exit 0;
+
+# d: full dump (normal behavior is limited to depth of 1)
+sub d {
+    local $Data::Dumper::Maxdepth = 0;
+    local $Data::Dumper::Deparse = 1;
+    print Dumper(@_);
+    return ();
+}
+
+# p: print as a single string (normal behavior puts list items on separate lines)
+sub p {
+    local $^W=0; # suppress possible undefined var message 
+    print(@_, "\n");
+    return ();
+}
+
+sub filter {
+    my $name = shift;
+    my $filter = Bugzilla->template->{SERVICE}->{CONTEXT}->{CONFIG}->{FILTERS}->{$name};
+    if (scalar @_) {
+        return $filter->(@_);
+    }
+    else {
+        return $filter;
+    }
+}
+
+sub b { get_object('Bugzilla::Bug', @_) }
+sub u { get_object('Bugzilla::User', @_) }
+sub f { get_object('Bugzilla::Field', @_) }
+
+sub get_object {
+    my $class = shift;
+    $_ = shift;
+    my @results = ();
+    
+    if (ref $_ eq 'HASH' && keys %$_) {
+        @results = @{$class->match($_)};
+    }
+    elsif (m/^\d+$/) {
+        @results = ($class->new($_));
+    }
+    elsif (m/\w/i && grep {$_ eq 'name'} ($class->_get_db_columns)) {
+        @results = @{$class->match({name => $_})};
+    }
+    else {
+        @results = ();
+    }
+    
+    if (wantarray) {
+        return @results;
+    }
+    else {
+        return shift @results;
+    }
+}
+
+sub read_history {
+    my ($term) = @_;
+    
+    if (open HIST, "<$ENV{HOME}/.bugzilla_console_history") {
+        foreach (<HIST>) {
+            chomp;
+            $term->addhistory($_);
+        }
+        close HIST;
+    }
+}
+
+sub write_history {
+    my ($term) = @_;
+
+    if ($term->can('GetHistory') && open HIST, ">$ENV{HOME}/.bugzilla_console_history") {
+        my %seen_hist = ();
+        my @hist = ();
+        foreach my $line (reverse $term->GetHistory()) {
+            next unless $line =~ m/\S/;
+            next if $seen_hist{$line};
+            $seen_hist{$line} = 1;
+            push @hist, $line;
+            last if (scalar @hist > 500);
+        }
+        foreach (reverse @hist) {
+            print HIST $_, "\n";
+        }
+        close HIST;
+    }
+}
+
+__END__
+
+=head1 NAME
+
+B<console.pl> - command-line interface to Bugzilla API
+
+=head1 SYNOPSIS
+
+$ B<contrib/console.pl>
+
+Bugzilla> B<b(5)-E<gt>short_desc>
+
+=over 8
+
+"Misplaced Widget"
+
+=back
+
+Bugzilla> B<$f = f "cf_subsystem"; scalar @{$f-E<gt>legal_values}>
+
+=over 8
+
+177
+
+=back
+
+Bugzilla> B<p filter html_light, "1 E<lt> 2 E<lt>bE<gt>3E<lt>/bE<gt>">
+
+=over 8
+
+1 &lt; 2 E<lt>bE<gt>3E<lt>/bE<gt>
+
+=back
+
+Bugzilla> B<$u = u 5; $u-E<gt>groups; d $u>
+
+=head1 DESCRIPTION
+
+Loads Bugzilla packages and prints expressions with Data::Dumper.
+Useful for checking results of Bugzilla API calls without opening
+a debug file from a cgi.

diff --git a/contrib/convert-workflow.pl b/contrib/convert-workflow.pl
new file mode 100755 (executable)
index 0000000..fdcab97
--- /dev/null
+++ b/contrib/convert-workflow.pl
@@ -0,0 +1,165 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Config qw(:admin);
+use Bugzilla::Search::Saved;
+use Bugzilla::Status;
+use Getopt::Long;
+
+my $confirmed   = new Bugzilla::Status({ name => 'CONFIRMED' });
+my $in_progress = new Bugzilla::Status({ name => 'IN_PROGRESS' });
+
+if ($confirmed and $in_progress) {
+    print "You are already using the new workflow.\n";
+    exit 1;
+}
+my $enable_unconfirmed  = 0;
+my $result = GetOptions("enable-unconfirmed" => \$enable_unconfirmed);
+
+print <<END;
+WARNING: This will convert the status of all bugs using the following
+system:
+
+  "NEW" will become "CONFIRMED"
+  "ASSIGNED" will become "IN_PROGRESS"
+  "REOPENED" will become "CONFIRMED" (and the "REOPENED" status will be removed)
+  "CLOSED" will become "VERIFIED" (and the "CLOSED" status will be removed)
+
+This change will be immediate. The history of each bug will also be changed
+so that it appears that these statuses were always in existence.
+
+Emails will not be sent for the change.
+
+END
+if ($enable_unconfirmed) {
+    print "UNCONFIRMED will be enabled in all products.\n";
+} else {
+    print <<END;
+If you also want to enable the UNCONFIRMED status in every product,
+restart this script with the --enable-unconfirmed option.
+END
+}
+print "\nTo continue, press any key, or press Ctrl-C to stop this program...";
+getc;
+
+my $dbh = Bugzilla->dbh;
+# This is an array instead of a hash so that we can be sure that
+# the translation happens in the right order. In particular, we
+# want NEW to be renamed to CONFIRMED, instead of having REOPENED
+# be the one that gets renamed.
+my @translation = (
+    [NEW      => 'CONFIRMED'],
+    [ASSIGNED => 'IN_PROGRESS'],
+    [REOPENED => 'CONFIRMED'],
+    [CLOSED   => 'VERIFIED'],
+);
+
+my $status_field = Bugzilla::Field->check('bug_status');
+$dbh->bz_start_transaction();
+foreach my $pair (@translation) {
+    my ($from, $to) = @$pair;
+    print "Converting $from to $to...\n";
+    # There is no FK on bugs.bug_status pointing to bug_status.value,
+    # so it's fine to update the bugs table first.
+    $dbh->do('UPDATE bugs SET bug_status = ? WHERE bug_status = ?',
+             undef, $to, $from);
+
+    if (Bugzilla->params->{'duplicate_or_move_bug_status'} eq $from) {
+        SetParam('duplicate_or_move_bug_status', $to);
+        write_params();
+    }
+
+    foreach my $what (qw(added removed)) {
+        $dbh->do("UPDATE bugs_activity SET $what = ?
+                   WHERE fieldid = ? AND $what = ?",
+                 undef, $to, $status_field->id, $from);
+    }
+
+    # Delete any transitions where it now appears that
+    # a bug moved from a status to itself.
+    $dbh->do('DELETE FROM bugs_activity WHERE fieldid = ? AND added = removed',
+             undef, $status_field->id);
+
+    # If the new status already exists, just delete the old one, but retain
+    # the workflow items from it.
+    my $new_status = new Bugzilla::Status({ name => $to });
+    my $old_status = new Bugzilla::Status({ name => $from });
+
+    if ($new_status && $old_status) {
+        my $to_id = $new_status->id;
+        my $from_id = $old_status->id;
+        # The subselect collects existing transitions from the target bug status.
+        # The main select collects existing transitions from the renamed bug status.
+        # The diff tells us which transitions are missing from the target bug status.
+        my $missing_transitions =
+          $dbh->selectcol_arrayref('SELECT sw1.new_status
+                                      FROM status_workflow sw1
+                                     WHERE sw1.old_status = ?
+                                       AND sw1.new_status NOT IN (SELECT sw2.new_status
+                                                                    FROM status_workflow sw2
+                                                                   WHERE sw2.old_status = ?)',
+                                     undef, ($from_id, $to_id));
+
+        $dbh->do('UPDATE status_workflow SET old_status = ? WHERE old_status = ? AND '
+                 . $dbh->sql_in('new_status', $missing_transitions),
+                 undef, ($to_id, $from_id)) if @$missing_transitions;
+
+        # The subselect collects existing transitions to the target bug status.
+        # The main select collects existing transitions to the renamed bug status.
+        # The diff tells us which transitions are missing to the target bug status.
+        # We have to explicitly exclude NULL from the subselect, because NOT IN
+        # doesn't know what to do with it (neither true nor false) and no data is returned.
+        $missing_transitions =
+          $dbh->selectcol_arrayref('SELECT sw1.old_status
+                                      FROM status_workflow sw1
+                                     WHERE sw1.new_status = ?
+                                       AND sw1.old_status NOT IN (SELECT sw2.old_status
+                                                                    FROM status_workflow sw2
+                                                                   WHERE sw2.new_status = ?
+                                                                     AND sw2.old_status IS NOT NULL)',
+                                     undef, ($from_id, $to_id));
+
+        $dbh->do('UPDATE status_workflow SET new_status = ? WHERE new_status = ? AND '
+                 . $dbh->sql_in('old_status', $missing_transitions),
+                 undef, ($to_id, $from_id)) if @$missing_transitions;
+
+        # Delete rows where old_status = new_status, and then the old status itself.
+        $dbh->do('DELETE FROM status_workflow WHERE old_status = new_status');
+        $dbh->do('DELETE FROM bug_status WHERE value = ?', undef, $from);
+    }
+    # Otherwise, rename the old status to the new one.
+    elsif ($old_status) {
+        $dbh->do('UPDATE bug_status SET value = ? WHERE value = ?',
+                 undef, $to, $from);
+    }
+
+    Bugzilla::Search::Saved->rename_field_value('bug_status', $from, $to);
+    Bugzilla::Series->Bugzilla::Search::Saved::rename_field_value('bug_status',
+        $from, $to);
+}
+if ($enable_unconfirmed) {
+    print "Enabling UNCONFIRMED in all products...\n";
+    $dbh->do('UPDATE products SET allows_unconfirmed = 1');
+}
+$dbh->bz_commit_transaction();
+
+print <<END;
+Done. There are some things you may want to fix, now:
+
+  * You may want to run ./collectstats.pl --regenerate to regenerate
+    data for the Old Charts system. 
+  * You may have to fix the Status Workflow using the Status Workflow
+    panel in "Administration".
+  * You will probably want to update the "mybugstemplate" and "defaultquery"
+    parameters using the Parameters panel in "Administration". (Just
+    resetting them to the default will work.)
+END

diff --git a/contrib/cvs-update.pl b/contrib/cvs-update.pl
new file mode 100755 (executable)
index 0000000..773019e
--- /dev/null
+++ b/contrib/cvs-update.pl
@@ -0,0 +1,35 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# Keep a record of all cvs updates made from a given directory.
+#
+# Later, if changes need to be backed out, look at the log file
+# and run the cvs command with the date that you want to back
+# out to. (Probably the second to last entry).
+
+# Because this script lives in contrib, you may want to
+#   ln -s contrib/cvs-update.pl cvs-update.pl
+# from your bugzilla install directory so you can run
+# the script easily from there (./cvs-update.pl)
+
+#DATE=`date +%e/%m/%Y\ %k:%M:%S\ %Z`
+
+my ($second, $minute, $hour, $day, $month, $year) = gmtime;
+my $date = sprintf("%04d-%02d-%02d %d:%02d:%02dZ",
+                   $year+1900, $month+1, $day, $hour, $minute, $second);
+my $cmd = "cvs -q update -dP";
+open LOG, ">>cvs-update.log" or die("Couldn't open cvs update log!");
+print LOG "$cmd -D \"$date\"\n";
+close LOG;
+system("$cmd -A");
+
+# sample log file
+#cvs update -P -D "11/04/2000 20:22:08 PDT"
+#cvs update -P -D "11/05/2000 20:22:22 PDT"
+#cvs update -P -D "11/07/2000 20:26:29 PDT"
+#cvs update -P -D "11/08/2000 20:27:10 PDT"

diff --git a/contrib/extension-convert.pl b/contrib/extension-convert.pl
new file mode 100755 (executable)
index 0000000..457f40f
--- /dev/null
+++ b/contrib/extension-convert.pl
@@ -0,0 +1,290 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use warnings;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util qw(trim);
+
+use File::Basename;
+use File::Copy qw(move);
+use File::Find;
+use File::Path qw(mkpath rmtree);
+
+my $from = $ARGV[0]
+  or die <<END;
+You must specify the name of the extension you are converting from,
+as the first argument.
+END
+my $extension_name = ucfirst($from);
+
+my $extdir = bz_locations()->{'extensionsdir'};
+
+my $from_dir = "$extdir/$from";
+if (!-d $from_dir) {
+    die "$from_dir does not exist.\n";
+}
+
+my $to_dir = "$extdir/$extension_name";
+if (-d $to_dir) {
+    die "$to_dir already exists, not converting.\n";
+}
+
+if (ON_WINDOWS) {
+    # There's no easy way to recursively copy a directory on Windows.
+    print "WARNING: This will modify the contents of $from_dir.\n",
+          "Press Ctrl-C to stop or any other key to continue...\n";
+    getc;
+    move($from_dir, $to_dir) 
+        || die "rename of $from_dir to $to_dir failed: $!";
+}
+else {
+    print "Copying $from_dir to $to_dir...\n";
+    system("cp", "-r", $from_dir, $to_dir);
+}
+
+# Make sure we don't accidentally modify the $from_dir anywhere else 
+# in this script.
+undef $from_dir;
+
+if (!-d $to_dir) {
+    die "$to_dir was not created.\n";
+}
+
+my $version = get_version($to_dir);
+move_template_hooks($to_dir);
+rename_module_packages($to_dir, $extension_name);
+my $install_requirements = get_install_requirements($to_dir);
+my ($modules, $subs) = code_files_to_subroutines($to_dir);
+
+my $config_pm = <<END;
+package Bugzilla::Extension::$extension_name;
+use strict;
+use constant NAME => '$extension_name';
+$install_requirements
+__PACKAGE__->NAME;
+END
+
+my $extension_pm = <<END;
+package Bugzilla::Extension::$extension_name;
+use strict;
+use base qw(Bugzilla::Extension);
+
+$modules
+
+our \$VERSION = '$version';
+
+$subs
+
+__PACKAGE__->NAME;
+END
+
+open(my $config_fh, '>', "$to_dir/Config.pm") || die "$to_dir/Config.pm: $!";
+print $config_fh $config_pm;
+close($config_fh);
+open(my $extension_fh, '>', "$to_dir/Extension.pm") 
+  || die "$to_dir/Extension.pm: $!";
+print $extension_fh $extension_pm;
+close($extension_fh);
+
+rmtree("$to_dir/code");
+unlink("$to_dir/info.pl");
+
+###############
+# Subroutines #
+###############
+
+sub rename_module_packages {
+    my ($dir, $name) = @_;
+    my $lib_dir = "$dir/lib";
+
+    # We don't want things like Bugzilla::Extension::Testopia::Testopia.
+    if (-d "$lib_dir/$name") {
+        print "Moving contents of $lib_dir/$name into $lib_dir...\n";
+        foreach my $file (glob("$lib_dir/$name/*")) {
+            my $dirname = dirname($file);
+            my $basename = basename($file);
+            rename($file, "$dirname/../$basename") || warn "$file: $!\n";
+        }
+    }
+
+    my @modules;
+    find({ wanted   => sub { $_ =~ /\.pm$/i and push(@modules, $_) }, 
+           no_chdir => 1 }, $lib_dir);
+    my %module_rename;
+    foreach my $file (@modules) {
+        open(my $fh, '<', $file) || die "$file: $!";
+        my $content = do { local $/ = undef; <$fh> };
+        close($fh);
+        if ($content =~ /^package (\S+);/m) {
+            my $package = $1;
+            my $new_name = $file;
+            $new_name =~ s/^$lib_dir\///;
+            $new_name =~ s/\.pm$//;
+            $new_name = join('::', File::Spec->splitdir($new_name));
+            $new_name = "Bugzilla::Extension::${name}::$new_name";
+            print "Renaming $package to $new_name...\n";
+            $content =~ s/^package \Q$package\E;/package \Q$new_name\E;/;
+            open(my $write_fh, '>', $file) || die "$file: $!";
+            print $write_fh $content;
+            close($write_fh);
+            $module_rename{$package} = $new_name;
+        }
+    }
+
+    print "Renaming module names inside of library and code files...\n";
+    my @code_files = glob("$dir/code/*.pl");
+    rename_modules_internally(\%module_rename, [@modules, @code_files]);
+}
+
+sub rename_modules_internally {
+    my ($rename, $files) = @_;
+
+    # We can't use \b because :: matches \b.
+    my $break = qr/^|[^\w:]|$/;
+    foreach my $file (@$files) {
+        open(my $fh, '<', $file) || die "$file: $!";
+        my $content = do { local $/ = undef; <$fh> };
+        close($fh);
+        foreach my $old_name (keys %$rename) {
+            my $new_name = $rename->{$old_name};
+            $content =~ s/($break)\Q$old_name\E($break)/$1$new_name$2/gms;
+        }
+        open(my $write_fh, '>', $file) || die "$file: $!";
+        print $write_fh $content;
+        close($write_fh);
+    }
+}
+
+sub get_version {
+    my ($dir) = @_;
+    print "Getting version info from info.pl...\n";
+    my $info;
+    {
+        local @INC = ("$dir/lib", @INC);
+        $info = do "$dir/info.pl"; die $@ if $@;
+    }
+    return $info->{version};
+}
+
+sub get_install_requirements {
+    my ($dir) = @_;
+    my $file = "$dir/code/install-requirements.pl";
+    return '' if !-f $file;
+
+    print "Moving install-requirements.pl code into Config.pm...\n";
+    my ($modules, $code) = process_code_file($file);
+    $modules = join('', @$modules);
+    $code = join('', @$code);
+    if ($modules) {
+        return "$modules\n\n$code";
+    }
+    return $code;
+}
+
+sub process_code_file {
+    my ($file) = @_;
+    open(my $fh, '<', $file) || die "$file: $!";
+    my $stuff_started;
+    my (@modules, @code);
+    foreach my $line (<$fh>) {
+        $stuff_started = 1 if $line !~ /^#/;
+        next if !$stuff_started;
+        next if $line =~ /^use (warnings|strict|lib|Bugzilla)[^\w:]/;
+        if ($line =~ /^(?:use|require)\b/) {
+            push(@modules, $line);
+        }
+        else {
+            push(@code, $line);
+        }
+    }
+    close $fh;
+    return (\@modules, \@code);
+}
+
+sub code_files_to_subroutines {
+    my ($dir) = @_;
+
+    my @dir_files = glob("$dir/code/*.pl");
+    my (@all_modules, @subroutines);
+    foreach my $file (@dir_files) {
+        next if $file =~ /install-requirements/;
+        print "Moving $file code into Extension.pm...\n";
+        my ($modules, $code) = process_code_file($file);
+        my @code_lines = map { "    $_" } @$code;
+        my $code_string = join('', @code_lines);
+        $code_string =~ s/Bugzilla->hook_args/\$args/g;
+        $code_string =~ s/my\s+\$args\s+=\s+\$args;//gs;
+        chomp($code_string);
+        push(@all_modules, @$modules);
+        my $name = basename($file);
+        $name =~ s/-/_/;
+        $name =~ s/\.pl$//;
+
+        my $subroutine = <<END;
+sub $name {
+    my (\$self, \$args) = \@_;
+$code_string
+}
+END
+        push(@subroutines, $subroutine);
+    }
+
+    my %seen_modules = map { trim($_) => 1 } @all_modules;
+    my $module_string = join("\n", sort keys %seen_modules);
+    my $subroutine_string = join("\n", @subroutines);
+    return ($module_string, $subroutine_string);
+}
+
+sub move_template_hooks {
+    my ($dir) = @_;
+    foreach my $lang (glob("$dir/template/*")) {
+        next if !_file_matters($lang);
+        my $hook_container = "$lang/default/hook";
+        mkpath($hook_container) || warn "$hook_container: $!";
+        # Hooks can be in all sorts of weird places, including
+        # template/default/hook.
+        foreach my $file (glob("$lang/*")) {
+            next if !_file_matters($file, 1);
+            my $dirname = basename($file);
+            print "Moving $file to $hook_container/$dirname...\n";
+            rename($file, "$hook_container/$dirname") || die "move failed: $!";
+        }
+    }
+}
+
+sub _file_matters {
+     my ($path, $tmpl) = @_;
+     my @ignore = qw(default custom CVS);
+     my $file = basename($path);
+     return 0 if grep(lc($_) eq lc($file), @ignore);
+      # Hidden files
+     return 0 if $file =~ /^\./;
+     if ($tmpl) {
+         return 1 if $file =~ /\.tmpl$/;
+     }
+     return 0 if !-d $path;
+     return 1;
+}
+
+__END__
+
+=head1 NAME
+
+extension-convert.pl - Convert extensions from the pre-3.6 format to the 
+3.6 format.
+
+=head1 SYNOPSIS
+
+ contrib/extension-convert.pl name
+
+ Converts an extension in the F<extensions/> directory into the new
+ extension layout for Bugzilla 3.6.

diff --git a/contrib/fixperms.pl b/contrib/fixperms.pl
new file mode 100755 (executable)
index 0000000..b9ac205
--- /dev/null
+++ b/contrib/fixperms.pl
@@ -0,0 +1,15 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use warnings;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Install::Filesystem qw(fix_all_file_permissions);
+fix_all_file_permissions(1);

diff --git a/contrib/jb2bz.py b/contrib/jb2bz.py
new file mode 100755 (executable)
index 0000000..55cb056
--- /dev/null
+++ b/contrib/jb2bz.py
@@ -0,0 +1,308 @@
+#!/usr/local/bin/python
+# -*- mode: python -*-
+
+"""
+jb2bz.py - a nonce script to import bugs from JitterBug to Bugzilla
+Written by Tom Emerson, tree@basistech.com
+
+This script is provided in the hopes that it will be useful.  No
+rights reserved. No guarantees expressed or implied. Use at your own
+risk. May be dangerous if swallowed. If it doesn't work for you, don't
+blame me. It did what I needed it to do.
+
+This code requires a recent version of Andy Dustman's MySQLdb interface,
+
+    http://sourceforge.net/projects/mysql-python
+
+Share and enjoy.
+"""
+
+import rfc822, mimetools, multifile, mimetypes
+import sys, re, glob, StringIO, os, stat, time
+import MySQLdb, getopt
+
+# mimetypes doesn't include everything we might encounter, yet.
+if not mimetypes.types_map.has_key('.doc'):
+    mimetypes.types_map['.doc'] = 'application/msword'
+
+if not mimetypes.encodings_map.has_key('.bz2'):
+    mimetypes.encodings_map['.bz2'] = "bzip2"
+
+bug_status='CONFIRMED'
+component="default"
+version=""
+product="" # this is required, the rest of these are defaulted as above
+
+"""
+Each bug in JitterBug is stored as a text file named by the bug number.
+Additions to the bug are indicated by suffixes to this:
+
+<bug>
+<bug>.followup.*
+<bug>.reply.*
+<bug>.notes
+
+The dates on the files represent the respective dates they were created/added.
+
+All <bug>s and <bug>.reply.*s include RFC 822 mail headers. These could include
+MIME file attachments as well that would need to be extracted.
+
+There are other additions to the file names, such as
+
+<bug>.notify
+
+which are ignored.
+
+Bugs in JitterBug are organized into directories. At Basis we used the following
+naming conventions:
+
+<product>-bugs         Open bugs
+<product>-requests     Open Feature Requests
+<product>-resolved     Bugs/Features marked fixed by engineering, but not verified
+<product>-verified     Resolved defects that have been verified by QA
+
+where <product> is either:
+
+<product-name>
+
+or
+
+<product-name>-<version>
+"""
+
+def process_notes_file(current, fname):
+    try:
+        new_note = {}
+        notes = open(fname, "r")
+        s = os.fstat(notes.fileno())
+
+        new_note['text']  = notes.read()
+        new_note['timestamp'] = time.gmtime(s[stat.ST_MTIME])
+
+        notes.close()
+
+        current['notes'].append(new_note)
+
+    except IOError:
+        pass
+
+def process_reply_file(current, fname):
+    new_note = {}
+    reply = open(fname, "r")
+    msg = rfc822.Message(reply)
+    new_note['text'] = "%s\n%s" % (msg['From'], msg.fp.read())
+    new_note['timestamp'] = rfc822.parsedate_tz(msg['Date'])
+    current["notes"].append(new_note)
+
+def add_notes(current):
+    """Add any notes that have been recorded for the current bug."""
+    process_notes_file(current, "%d.notes" % current['number'])
+
+    for f in glob.glob("%d.reply.*" % current['number']):
+        process_reply_file(current, f)
+
+    for f in glob.glob("%d.followup.*" % current['number']):
+        process_reply_file(current, f)
+
+def maybe_add_attachment(current, file, submsg):
+    """Adds the attachment to the current record"""
+    cd = submsg["Content-Disposition"]
+    m = re.search(r'filename="([^"]+)"', cd)
+    if m == None:
+        return
+    attachment_filename = m.group(1)
+    if (submsg.gettype() == 'application/octet-stream'):
+        # try get a more specific content-type for this attachment
+        type, encoding = mimetypes.guess_type(m.group(1))
+        if type == None:
+            type = submsg.gettype()
+    else:
+        type = submsg.gettype()
+
+    try:
+        data = StringIO.StringIO()
+        mimetools.decode(file, data, submsg.getencoding())
+    except:
+        return
+
+    current['attachments'].append( ( attachment_filename, type, data.getvalue() ) )
+
+def process_mime_body(current, file, submsg):
+    data = StringIO.StringIO()
+    mimetools.decode(file, data, submsg.getencoding())
+    current['description'] = data.getvalue()
+
+\f
+
+def process_text_plain(msg, current):
+    print "Processing: %d" % current['number']
+    current['description'] = msg.fp.read()
+
+def process_multi_part(file, msg, current):
+    print "Processing: %d" % current['number']
+    mf = multifile.MultiFile(file)
+    mf.push(msg.getparam("boundary"))
+    while mf.next():
+        submsg = mimetools.Message(file)
+        if submsg.has_key("Content-Disposition"):
+            maybe_add_attachment(current, mf, submsg)
+        else:
+            # This is the message body itself (always?), so process
+            # accordingly
+            process_mime_body(current, mf, submsg)
+
+def process_jitterbug(filename):
+    current = {}
+    current['number'] = int(filename)
+    current['notes'] = []
+    current['attachments'] = []
+    current['description'] = ''
+    current['date-reported'] = ()
+    current['short-description'] = ''
+    
+    file = open(filename, "r")
+    msg = mimetools.Message(file)
+
+    msgtype = msg.gettype()
+
+    add_notes(current)
+    current['date-reported'] = rfc822.parsedate_tz(msg['Date'])
+    current['short-description'] = msg['Subject']
+
+    if msgtype[:5] == 'text/':
+        process_text_plain(msg, current)
+    elif msgtype[:10] == "multipart/":
+        process_multi_part(file, msg, current)
+    else:
+        # Huh? This should never happen.
+        print "Unknown content-type: %s" % msgtype
+        sys.exit(1)
+
+    # At this point we have processed the message: we have all of the notes and
+    # attachments stored, so it's time to add things to the database.
+    # The schema for JitterBug 2.14 can be found at:
+    #
+    #    http://www.trilobyte.net/barnsons/html/dbschema.html
+    #
+    # The following fields need to be provided by the user:
+    #
+    # bug_status
+    # product
+    # version
+    # reporter
+    # component
+    # resolution
+
+    # change this to the user_id of the Bugzilla user who is blessed with the
+    # imported defects
+    reporter=6
+
+    # the resolution will need to be set manually
+    resolution=""
+
+    db = MySQLdb.connect(db='bugs',user='root',host='localhost')
+    cursor = db.cursor()
+
+    cursor.execute( "INSERT INTO bugs SET " \
+                    "bug_id=%s," \
+                    "bug_severity='normal',"  \
+                    "bug_status=%s," \
+                    "creation_ts=%s,"  \
+                    "delta_ts=%s,"  \
+                    "short_desc=%s," \
+                    "product=%s," \
+                    "rep_platform='All'," \
+                    "assigned_to=%s,"
+                    "reporter=%s," \
+                    "version=%s,"  \
+                    "component=%s,"  \
+                    "resolution=%s",
+                    [ current['number'],
+                      bug_status,
+                      time.strftime("%Y-%m-%d %H:%M:%S", current['date-reported'][:9]),
+                      time.strftime("%Y-%m-%d %H:%M:%S", current['date-reported'][:9]),
+                      current['short-description'],
+                      product,
+                      reporter,
+                      reporter,
+                      version,
+                      component,
+                      resolution] )
+
+    # This is the initial long description associated with the bug report
+    cursor.execute( "INSERT INTO longdescs VALUES (%s,%s,%s,%s)",
+                    [ current['number'],
+                      reporter,
+                      time.strftime("%Y-%m-%d %H:%M:%S", current['date-reported'][:9]),
+                      current['description'] ] )
+
+    # Add whatever notes are associated with this defect
+    for n in current['notes']:
+        cursor.execute( "INSERT INTO longdescs VALUES (%s,%s,%s,%s)",
+                        [current['number'],
+                         reporter,
+                         time.strftime("%Y-%m-%d %H:%M:%S", n['timestamp'][:9]),
+                         n['text']])
+
+    # add attachments associated with this defect
+    for a in current['attachments']:
+        cursor.execute( "INSERT INTO attachments SET " \
+                        "bug_id=%s, creation_ts=%s, description='', mimetype=%s," \
+                        "filename=%s, submitter_id=%s",
+                        [ current['number'],
+                          time.strftime("%Y-%m-%d %H:%M:%S", current['date-reported'][:9]),
+                          a[1], a[0], reporter ])
+        cursor.execute( "INSERT INTO attach_data SET " \
+                        "id=LAST_INSERT_ID(), thedata=%s",
+                        [ a[2] ])
+
+    cursor.close()
+    db.close()
+
+def usage():
+    print """Usage: jb2bz.py [OPTIONS] Product
+
+Where OPTIONS are one or more of the following:
+
+  -h                This help information.
+  -s STATUS         One of UNCONFIRMED, CONFIRMED, IN_PROGRESS, RESOLVED, VERIFIED
+                    (default is CONFIRMED)
+  -c COMPONENT      The component to attach to each bug as it is important. This should be
+                    valid component for the Product.
+  -v VERSION        Version to assign to these defects.
+
+Product is the Product to assign these defects to.
+
+All of the JitterBugs in the current directory are imported, including replies, notes,
+attachments, and similar noise.
+"""
+    sys.exit(1)
+
+
+def main():
+    global bug_status, component, version, product
+    opts, args = getopt.getopt(sys.argv[1:], "hs:c:v:")
+
+    for o,a in opts:
+        if o == "-s":
+            if a in ('UNCONFIRMED','CONFIRMED','IN_PROGRESS','RESOLVED','VERIFIED'):
+                bug_status = a
+        elif o == '-c':
+            component = a
+        elif o == '-v':
+            version = a
+        elif o == '-h':
+            usage()
+
+    if len(args) != 1:
+        sys.stderr.write("Must specify the Product.\n")
+        sys.exit(1)
+
+    product = args[0]
+
+    for bug in filter(lambda x: re.match(r"\d+$", x), glob.glob("*")):
+        process_jitterbug(bug)
+        
+
+if __name__ == "__main__":
+    main()

diff --git a/contrib/merge-users.pl b/contrib/merge-users.pl
new file mode 100755 (executable)
index 0000000..19cb8d4
--- /dev/null
+++ b/contrib/merge-users.pl
@@ -0,0 +1,225 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+=head1 NAME
+
+merge-users.pl - Merge two user accounts.
+
+=head1 SYNOPSIS
+
+ This script moves activity from one user account to another.
+ Specify the two accounts on the command line, e.g.:
+
+ ./merge-users.pl old_account@foo.com new_account@bar.com
+ or:
+ ./merge-users.pl id:old_userid id:new_userid
+ or:
+ ./merge-users.pl id:old_userid new_account@bar.com
+
+ Notes: - the new account must already exist.
+        - the id:old_userid syntax permits you to migrate
+          activity from a deleted account to an existing one.
+
+=cut
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::User;
+
+use Getopt::Long;
+use Pod::Usage;
+
+my $dbh = Bugzilla->dbh;
+
+# Display the help if called with --help or -?.
+my $help  = 0;
+my $result = GetOptions("help|?" => \$help);
+pod2usage(0) if $help;
+
+
+# Make sure accounts were specified on the command line and exist.
+my $old = $ARGV[0] || die "You must specify an old user account.\n";
+my $old_id;
+if ($old =~ /^id:(\d+)$/) {
+    # As the old user account may be a deleted one, we don't
+    # check whether this user ID is valid or not.
+    # If it never existed, no damage will be done.
+    $old_id = $1;
+}
+else {
+    trick_taint($old);
+    $old_id = $dbh->selectrow_array('SELECT userid FROM profiles
+                                      WHERE login_name = ?',
+                                      undef, $old);
+}
+if ($old_id) {
+    print "OK, old user account $old found; user ID: $old_id.\n";
+}
+else {
+    die "The old user account $old does not exist.\n";
+}
+
+my $new = $ARGV[1] || die "You must specify a new user account.\n";
+my $new_id;
+if ($new =~ /^id:(\d+)$/) {
+    $new_id = $1;
+    # Make sure this user ID exists.
+    $new_id = $dbh->selectrow_array('SELECT userid FROM profiles
+                                      WHERE userid = ?',
+                                      undef, $new_id);
+}
+else {
+    trick_taint($new);
+    $new_id = $dbh->selectrow_array('SELECT userid FROM profiles
+                                      WHERE login_name = ?',
+                                      undef, $new);
+}
+if ($new_id) {
+    print "OK, new user account $new found; user ID: $new_id.\n";
+}
+else {
+    die "The new user account $new does not exist.\n";
+}
+
+# Make sure the old and new accounts are different.
+if ($old_id == $new_id) {
+    die "\nBoth accounts are identical. There is nothing to migrate.\n";
+}
+
+
+# A list of tables and columns to be changed:
+# - keys of the hash are table names to be locked/altered;
+# - values of the hash contain column names to be updated
+#   as well as the columns they depend on:
+#   = each array is of the form:
+#     ['foo1 bar11 bar12 bar13', 'foo2 bar21 bar22', 'foo3 bar31 bar32']
+#     where fooN is the column to update, and barN1, barN2, ... are
+#     the columns to take into account to avoid duplicated entries.
+#     Note that the barNM columns are optional.
+#
+# We set the tables that require custom stuff (multiple columns to check)
+# here, but the simple stuff is all handled below by bz_get_related_fks.
+my %changes = (
+    cc              => ['who bug_id'],
+    # Tables affecting global behavior / other users.
+    component_cc    => ['user_id component_id'],
+    watch           => ['watcher watched', 'watched watcher'],
+    # Tables affecting the user directly.
+    namedqueries    => ['userid name'],
+    namedqueries_link_in_footer => ['user_id namedquery_id'],
+    user_group_map  => ['user_id group_id isbless grant_type'],
+    email_setting   => ['user_id relationship event'],
+    profile_setting => ['user_id setting_name'],
+
+    # Only do it if mailto_type = 0, i.e is pointing to a user account!
+    # This requires to be done separately due to this condition.
+    whine_schedules => [], # ['mailto'],
+);
+
+my $userid_fks = $dbh->bz_get_related_fks('profiles', 'userid');
+foreach my $item (@$userid_fks) {
+    my ($table, $column) = @$item;
+    $changes{$table} ||= [];
+    push(@{ $changes{$table} }, $column);
+}
+
+# Delete all old records for these tables; no migration.
+foreach my $table (qw(logincookies tokens profiles)) {
+    $changes{$table} = [];
+}
+
+# Start the transaction
+$dbh->bz_start_transaction();
+
+# Delete old records from logincookies and tokens tables.
+$dbh->do('DELETE FROM logincookies WHERE userid = ?', undef, $old_id);
+$dbh->do('DELETE FROM tokens WHERE userid = ?', undef, $old_id);
+
+# Migrate records from old user to new user.
+foreach my $table (keys %changes) {
+    foreach my $column_list (@{ $changes{$table} }) {
+        # Get all columns to consider. There is always at least
+        # one column given: the one to update.
+        my @columns = split(/[\s]+/, $column_list);
+        my $cols_to_check = join(' AND ', map {"$_ = ?"} @columns);
+        # The first column of the list is the one to update.
+        my $col_to_update = shift @columns;
+
+        # Will be used to migrate the old user account to the new one.
+        my $sth_update = $dbh->prepare("UPDATE $table
+                                           SET $col_to_update = ?
+                                         WHERE $cols_to_check");
+
+        # Do we have additional columns to take care of?
+        if (scalar(@columns)) {
+            my $cols_to_query = join(', ', @columns);
+
+            # Get existing entries for the old user account.
+            my $old_entries = 
+                $dbh->selectall_arrayref("SELECT $cols_to_query
+                                            FROM $table
+                                           WHERE $col_to_update = ?",
+                                          undef, $old_id);
+
+            # Will be used to check whether the same entry exists
+            # for the new user account.
+            my $sth_select = $dbh->prepare("SELECT COUNT(*)
+                                              FROM $table
+                                             WHERE $cols_to_check");
+
+            # Will be used to delete duplicated entries.
+            my $sth_delete = $dbh->prepare("DELETE FROM $table
+                                             WHERE $cols_to_check");
+
+            foreach my $entry (@$old_entries) {
+                my $exists = $dbh->selectrow_array($sth_select, undef,
+                                                   ($new_id, @$entry));
+
+                if ($exists) {
+                    $sth_delete->execute($old_id, @$entry);
+                }
+                else {
+                    $sth_update->execute($new_id, $old_id, @$entry);
+                }
+            }
+        }
+        # No check required. Update the column directly.
+        else {
+            $sth_update->execute($new_id, $old_id);
+        }
+        print "OK, records in the '$col_to_update' column of the '$table' table\n" .
+              "have been migrated to the new user account.\n";
+    }
+}
+
+# Only update 'whine_schedules' if mailto_type = 0.
+# (i.e. is pointing to a user ID).
+$dbh->do('UPDATE whine_schedules SET mailto = ?
+           WHERE mailto = ? AND mailto_type = ?',
+          undef, ($new_id, $old_id, 0));
+print "OK, records in the 'mailto' column of the 'whine_schedules' table\n" .
+      "have been migrated to the new user account.\n";
+
+# Delete the old record from the profiles table.
+$dbh->do('DELETE FROM profiles WHERE userid = ?', undef, $old_id);
+
+# rederive regexp-based group memberships, because we merged all memberships
+# from all of the accounts, and since the email address isn't the same on
+# them, some of them may no longer match the regexps.
+my $user = new Bugzilla::User($new_id);
+$user->derive_regexp_groups();
+
+# Commit the transaction
+$dbh->bz_commit_transaction();
+
+print "Done.\n";

diff --git a/contrib/mysqld-watcher.pl b/contrib/mysqld-watcher.pl
new file mode 100755 (executable)
index 0000000..08a87b5
--- /dev/null
+++ b/contrib/mysqld-watcher.pl
@@ -0,0 +1,102 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# mysqld-watcher.pl - a script that watches the running instance of
+# mysqld and kills off any long-running SELECTs against the shadow_db
+# 
+use strict;
+
+# some configurables: 
+
+# length of time before a thread is eligible to be killed, in seconds
+#
+my $long_query_time = 180;
+#
+# the From header for any messages sent out
+#
+my $mail_from = "root\@mothra.mozilla.org";
+#
+# the To header for any messages sent out
+#
+my $mail_to = "root";
+#
+# mail transfer agent.  this should probably really be converted to a Param().
+#
+my $mta_program = "/usr/lib/sendmail -t -ODeliveryMode=deferred";
+
+# The array of long-running queries
+#
+my $long = {};
+
+# Run mysqladmin processlist twice, the first time getting complete queries
+# and the second time getting just abbreviated queries.  We want complete
+# queries so we know which queries are taking too long to run, but complete
+# queries with line breaks get missed by this script, so we get abbreviated
+# queries as well to make sure we don't miss any.
+foreach my $command ("/opt/mysql/bin/mysqladmin --verbose processlist", 
+                     "/opt/mysql/bin/mysqladmin processlist")
+{
+    close(STDIN);
+    open(STDIN, "$command |");
+
+    # iterate through the running threads
+    #
+    while ( <STDIN> ) { 
+        my @F = split(/\|/);
+
+        # if this line is not the correct number of fields, or if the thread-id
+        # field contains Id, skip this line.  both these cases indicate that this
+        # line contains pretty-printing gunk and not thread info.
+        #
+        next if ( $#F != 9 || $F[1] =~ /Id/); 
+
+        if ( $F[4] =~ /shadow_bugs/             # shadowbugs database in use
+             && $F[5] =~ /Query/                # this is actually a query
+             && $F[6] > $long_query_time        # this query has taken too long
+             && $F[8] =~ /(select|SELECT)/      # only kill a select
+             && !defined($long->{$F[1]}) )      # haven't seen this one already
+        {
+           $long->{$F[1]} = \@F;
+            system("/opt/mysql/bin/mysqladmin", "kill", $F[1]);
+        }
+    }
+}
+
+# send an email message
+#
+# should perhaps be moved to somewhere more global for use in bugzilla as a 
+# whole; should also do more error-checking
+#
+sub sendEmail($$$$) {
+    ($#_ == 3) || die("sendEmail: invalid number of arguments");
+    my ($from, $to, $subject, $body) = @_;
+
+    open(MTA, "|$mta_program");
+    print MTA "From: $from\n";
+    print MTA "To: $to\n";
+    print MTA "Subject: $subject\n";
+    print MTA "\n";
+    print MTA $body;
+    print MTA "\n";
+    close(MTA);
+   
+}
+
+# if we found anything, kill the database thread and send mail about it
+#
+if (scalar(keys(%$long))) {
+    my $message = "";
+    foreach my $process_id (keys(%$long)) {
+        my $qry = $long->{$process_id};
+        $message .= join(" ", @$qry) . "\n\n";
+    }
+
+    # fire off an email telling the maintainer that we had to kill some threads
+    #
+    sendEmail($mail_from, $mail_to, "long running MySQL thread(s) killed", $message);
+}

diff --git a/contrib/new-yui.sh b/contrib/new-yui.sh
new file mode 100755 (executable)
index 0000000..2ea9531
--- /dev/null
+++ b/contrib/new-yui.sh
@@ -0,0 +1,24 @@
+#!/bin/sh
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+# Updates the version of YUI used by Bugzilla. Just pass the path to 
+# an unzipped yui release directory, like:
+#
+#  contrib/new-yui.sh /path/to/yui-2.8.1/
+#
+rsync -av --delete $1/build/ js/yui/
+cd js/yui
+rm -rf editor/ yuiloader-dom-event/
+find -name '*.js' -not -name '*-min.js' -not -name '*-dom-event.js' \
+     -exec rm -f {} \;
+find -name '*-skin.css' -exec rm -f {} \;
+find -depth -path '*/assets' -not -path './assets' -exec rm -rf {} \;
+rm assets/skins/sam/sprite.psd
+rm assets/skins/sam/skin.css
+rmdir utilities

diff --git a/contrib/recode.pl b/contrib/recode.pl
new file mode 100755 (executable)
index 0000000..de204f1
--- /dev/null
+++ b/contrib/recode.pl
@@ -0,0 +1,318 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util qw(detect_encoding);
+
+use Digest::MD5 qw(md5_base64);
+use Encode qw(encode decode resolve_alias is_utf8);
+use Getopt::Long;
+use Pod::Usage;
+
+#############
+# Constants #
+#############
+
+use constant IGNORE_ENCODINGS => qw(utf8 ascii iso-8859-1);
+
+use constant MAX_STRING_LEN => 25;
+
+# For certain tables, we can't automatically determine their Primary Key.
+# So, we specify it here as a string.
+use constant SPECIAL_KEYS => {
+    # bugs_activity since 4.4 has a unique primary key added
+    bugs_activity     => 'bug_id,bug_when,fieldid',
+    profile_setting   => 'user_id,setting_name',
+    # profiles_activity since 4.4 has a unique primary key added
+    profiles_activity => 'userid,profiles_when,fieldid',
+    setting_value     => 'name,value',
+    # longdescs didn't used to have a PK, before 2.20.
+    longdescs         => 'bug_id,bug_when',
+    # The 2.16 versions table lacked a PK
+    versions          => 'product_id,value',
+    # These are all for earlier versions of Bugzilla. On a modern
+    # version of Bugzilla, this script will ignore these (thanks to
+    # code further down).
+    components        => 'program,value',
+    products          => 'product',
+};
+
+###############
+# Subroutines #
+###############
+
+# "truncate" is a file operation in perl, so we can't use that name.
+sub trunc {
+    my ($str) = @_;
+    my $truncated = substr($str, 0, MAX_STRING_LEN);
+    if (length($truncated) ne length($str)) {
+        $truncated .= '...';
+    }
+    return $truncated;
+}
+
+sub is_valid_utf8 {
+    my ($str) = @_;
+    Encode::_utf8_on($str);
+    return is_utf8($str, 1);
+}
+
+###############
+# Main Script #
+###############
+
+my %switch;
+GetOptions(\%switch, 'dry-run', 'guess', 'charset=s', 'show-failures',
+                     'overrides=s', 'help|h');
+
+pod2usage({ -verbose => 1 }) if $switch{'help'};
+
+# You have to specify at least one of these switches.
+pod2usage({ -verbose => 0 }) if (!$switch{'charset'} && !$switch{'guess'});
+
+if (exists $switch{'charset'}) {
+    $switch{'charset'} = resolve_alias($switch{'charset'})
+        || die "'$switch{charset}' is not a valid charset.";
+}
+
+if ($switch{'guess'}) {
+    if (!eval { require Encode::Detect::Detector }) {
+        my $root = ROOT_USER;
+        print STDERR <<EOT;
+Using --guess requires that Encode::Detect be installed. To install
+Encode::Detect, run the following command:
+
+  $^X install-module.pl Encode::Detect
+
+EOT
+        exit;
+    }
+}
+
+my %overrides;
+if (exists $switch{'overrides'}) {
+    my $file = new IO::File($switch{'overrides'}, 'r') 
+        || die "$switch{overrides}: $!";
+    my @lines = $file->getlines();
+    $file->close();
+    foreach my $line (@lines) {
+        chomp($line);
+        my ($digest, $encoding) = split(' ', $line);
+        $overrides{$digest} = $encoding;
+    }
+}
+
+my $dbh = Bugzilla->dbh;
+
+if ($dbh->isa('Bugzilla::DB::Mysql')) {
+    # Get the actual current encoding of the DB.
+    my $collation_data = $dbh->selectrow_arrayref(
+        "SHOW VARIABLES LIKE 'character_set_database'");
+    my $db_charset = $collation_data->[1];
+    # Set our connection encoding to *that* encoding, so that MySQL
+    # correctly accepts our changes.
+    $dbh->do("SET NAMES $db_charset");
+    # Make the database give us raw bytes.
+    $dbh->do('SET character_set_results = NULL')
+}
+
+$dbh->begin_work;
+
+foreach my $table ($dbh->bz_table_list_real) {
+    my @columns = $dbh->bz_table_columns($table);
+
+    my $pk = SPECIAL_KEYS->{$table};
+    if ($pk) {
+        # Assure that we're on a version of Bugzilla where those keys
+        # actually exist.
+        foreach my $column (split ',', $pk) {
+            $pk = undef if !$dbh->bz_column_info($table, $column);
+        }
+    }
+
+    # Figure out the primary key.
+    foreach my $column (@columns) {
+        my $def = $dbh->bz_column_info($table, $column);
+        $pk = $column if $def->{PRIMARYKEY};
+    }
+    # If there's no PK, it's defined by a UNIQUE index.
+    if (!$pk) {
+        foreach my $column (@columns) {
+            my $index = $dbh->bz_index_info($table, "${table}_${column}_idx");
+            if ($index && ref($index) eq 'HASH') {
+                $pk = join(',', @{$index->{FIELDS}}) 
+                    if $index->{TYPE} eq 'UNIQUE';
+            }
+        }
+    }
+
+    foreach my $column (@columns) {
+        my $def = $dbh->bz_column_info($table, $column);
+        # If this is a text column, it may need work.
+        if ($def->{TYPE} =~ /text|char/i) {
+            # If there's still no PK, we're upgrading from 2.14 or earlier.
+            # We can't reliably determine the PK (or at least, I don't want to
+            # maintain code to record what the PK was at all points in history).
+            # So instead we just use the field itself.
+            $pk = $column if !$pk;
+
+            print "Converting $table.$column...\n";
+            my $sth = $dbh->prepare("SELECT $column, $pk FROM $table 
+                                      WHERE $column IS NOT NULL
+                                            AND $column != ''");
+
+            my @pk_array = map {"$_ = ?"} split(',', $pk);
+            my $pk_where = join(' AND ', @pk_array);
+            my $update_sth = $dbh->prepare(
+                "UPDATE $table SET $column = ? WHERE $pk_where");
+
+            $sth->execute();
+
+            while (my @result = $sth->fetchrow_array) {
+                my $data = shift @result;
+                # Wide characters cause md5_base64() to die.
+                my $digest_data = utf8::is_utf8($data) 
+                                  ? Encode::encode_utf8($data) : $data;
+                my $digest = md5_base64($digest_data);
+
+                my @primary_keys = reverse split(',', $pk);
+                # We copy the array so that we can pop things from it without
+                # affecting the original.
+                my @pk_data = @result;
+                my $pk_line = join (', ',
+                    map { "$_ = " . pop @pk_data } @primary_keys);
+
+                my $encoding;
+                if ($switch{'guess'}) {
+                    $encoding = detect_encoding($data);
+
+                    # We only show failures if they don't appear to be
+                    # ASCII.
+                    if ($switch{'show-failures'} && !$encoding
+                        && !is_valid_utf8($data)) 
+                    {
+                        my $truncated = trunc($data);
+                        print "Row: [$pk_line]\n",
+                              "Failed to guess: Key: $digest",
+                              " DATA: $truncated\n";
+                    }
+
+                    # If we fail a guess, and the data is valid UTF-8,
+                    # just assume we failed because it's UTF-8.
+                    next if is_valid_utf8($data);
+                }
+
+                # If we couldn't detect the charset (or were instructed
+                # not to try), we fall back to --charset. If there's no 
+                # fallback, we just do nothing.
+                if (!$encoding && $switch{'charset'}) {
+                    $encoding = $switch{'charset'};
+                }
+
+                $encoding = $overrides{$digest} if $overrides{$digest};
+
+                # We only fix it if it's not ASCII or UTF-8 already.
+                if ($encoding && !grep($_ eq $encoding, IGNORE_ENCODINGS)) {
+                    my $decoded = encode('utf8', decode($encoding, $data));
+                    if ($switch{'dry-run'} && $data ne $decoded) {
+                        print "Row:  [$pk_line]\n",
+                              "From: [" . trunc($data) . "] Key: $digest\n",
+                              "To:   [" . trunc($decoded) . "]",
+                              " Encoding : $encoding\n";
+                    }
+                    else {
+                        $update_sth->execute($decoded, @result);
+                    }
+                }
+            } # while (my @result = $sth->fetchrow_array)
+        } # if ($column->{TYPE} =~ /text|char/i)
+    } # foreach my $column (@columns)
+}
+
+$dbh->commit;
+
+__END__
+
+=head1 NAME
+
+recode.pl - Converts a database from one encoding (or multiple encodings) 
+to UTF-8.
+
+=head1 SYNOPSIS
+
+ contrib/recode.pl [--guess [--show-failures]] [--charset=iso-8859-2]
+                   [--overrides=file_name]
+
+  --dry-run        Don't modify the database.
+
+  --charset        Primary charset your data is currently in. This can be
+                   optionally omitted if you do --guess.
+
+  --guess          Try to guess the charset of the data.
+
+  --show-failures  If we fail to guess, show where we failed.
+
+  --overrides      Specify a file containing overrides. See --help
+                   for more info.
+
+  --help           Display detailed help.
+
+ If you aren't sure what to do, try:
+
+   contrib/recode.pl --guess --charset=cp1252
+
+=head1 OPTIONS
+
+=over
+
+=item --dry-run
+
+Don't modify the database, just print out what the conversions will be.
+
+recode.pl will print out a Key for each item. You can use this in the 
+overrides file, described below.
+
+=item --guess 
+
+If your database is in multiple different encodings, specify this switch 
+and recode.pl will do its best to determine the original charset of the data.
+The detection is usually very reliable.
+
+If recode.pl cannot guess the charset, it will leave the data alone, unless
+you've specified --charset.
+
+=item --charset=charset-name
+
+If you do not specify --guess, then your database is converted
+from this character set into the UTF-8.
+
+If you have specified --guess, recode.pl will use this charset as
+a fallback--when it cannot guess the charset of a particular piece
+of data, it will guess that the data is in this charset and convert
+it from this charset to UTF-8.
+
+charset-name must be a charset that is known to perl's Encode 
+module. To see a list of available charsets, do: 
+
+C<perl -MEncode -e 'print join("\n", Encode-E<gt>encodings(":all"))'>
+
+=item --show-failures
+
+If --guess fails to guess a charset, print out the data it failed on.
+
+=item --overrides=file_name
+
+This is a way of specifying certain encodings to override the encodings of 
+--guess. The file is a series of lines. The line should start with the Key 
+from --dry-run, and then a space, and then the encoding you'd like to use.
+
+=back

diff --git a/contrib/sendbugmail.pl b/contrib/sendbugmail.pl
new file mode 100755 (executable)
index 0000000..c015810
--- /dev/null
+++ b/contrib/sendbugmail.pl
@@ -0,0 +1,104 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Util;
+use Bugzilla::BugMail;
+use Bugzilla::User;
+
+my $dbh = Bugzilla->dbh;
+
+sub usage {
+    print STDERR "Usage: $0 bug_id user_email\n";
+    exit;
+}
+
+if (($#ARGV < 1) || ($#ARGV > 2)) {
+    usage();
+}
+
+# Get the arguments.
+my $bugnum = $ARGV[0];
+my $changer = $ARGV[1];
+
+# Validate the bug number.
+if (!($bugnum =~ /^(\d+)$/)) {
+  print STDERR "Bug number \"$bugnum\" not numeric.\n";
+  usage();
+}
+
+detaint_natural($bugnum);
+
+my ($id) = $dbh->selectrow_array("SELECT bug_id FROM bugs WHERE bug_id = ?", 
+                                 undef, $bugnum);
+
+if (!$id) {
+  print STDERR "Bug number $bugnum does not exist.\n";
+  usage();
+}
+
+# Validate the changer address.
+my $match = Bugzilla->params->{'emailregexp'};
+if ($changer !~ /$match/) {
+    print STDERR "Changer \"$changer\" doesn't match email regular expression.\n";
+    usage();
+}
+my $changer_user = new Bugzilla::User({ name => $changer });
+unless ($changer_user) {
+    print STDERR "\"$changer\" is not a valid user.\n";
+    usage();
+}
+
+# Send the email.
+my $outputref = Bugzilla::BugMail::Send($bugnum, {'changer' => $changer_user });
+
+# Report the results.
+my $sent = scalar(@{$outputref->{sent}});
+my $excluded = scalar(@{$outputref->{excluded}});
+
+if ($sent) {
+    print "email sent to $sent recipients:\n";
+} else {
+    print "No email sent.\n";
+}
+
+foreach my $sent (@{$outputref->{sent}}) {
+  print "  $sent\n";
+}
+
+if ($excluded) {
+    print "$excluded recipients excluded:\n";
+} else {
+    print "No recipients excluded.\n";
+}
+
+foreach my $excluded (@{$outputref->{excluded}}) {
+  print "  $excluded\n";
+}
+
+# This document is copyright (C) 2004 Perforce Software, Inc.  All rights
+# reserved.
+# 
+# Redistribution and use of this document in any form, with or without
+# modification, is permitted provided that redistributions of this
+# document retain the above copyright notice, this condition and the
+# following disclaimer.
+# 
+# THIS DOCUMENT IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+# IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+# PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# HOLDERS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+# TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+# PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# DOCUMENT, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

diff --git a/contrib/sendunsentbugmail.pl b/contrib/sendunsentbugmail.pl
new file mode 100755 (executable)
index 0000000..94ad25d
--- /dev/null
+++ b/contrib/sendunsentbugmail.pl
@@ -0,0 +1,52 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::BugMail;
+
+my $dbh = Bugzilla->dbh;
+
+my $list = $dbh->selectcol_arrayref(
+        'SELECT bug_id FROM bugs 
+          WHERE lastdiffed IS NULL
+             OR lastdiffed < delta_ts 
+            AND delta_ts < ' 
+                . $dbh->sql_date_math('NOW()', '-', 30, 'MINUTE') .
+     ' ORDER BY bug_id');
+
+if (scalar(@$list) > 0) {
+    print "OK, now attempting to send unsent mail\n";
+    print scalar(@$list) . " bugs found with possibly unsent mail.\n\n";
+    foreach my $bugid (@$list) {
+        my $start_time = time;
+        print "Sending mail for bug $bugid...\n";
+        my $outputref = Bugzilla::BugMail::Send($bugid);
+        if ($ARGV[0] && $ARGV[0] eq "--report") {
+          print "Mail sent to:\n";
+          foreach (sort @{$outputref->{sent}}) {
+              print $_ . "\n";
+          }
+          
+          print "Excluded:\n";
+          foreach (sort @{$outputref->{excluded}}) {
+              print $_ . "\n";
+          }
+        }
+        else {
+            my ($sent, $excluded) = (scalar(@{$outputref->{sent}}),scalar(@{$outputref->{excluded}}));
+            print "$sent mails sent, $excluded people excluded.\n";
+            print "Took " . (time - $start_time) . " seconds.\n\n";
+        }    
+    }
+    print "Unsent mail has been sent.\n";
+}

diff --git a/contrib/syncLDAP.pl b/contrib/syncLDAP.pl
new file mode 100755 (executable)
index 0000000..ec0839e
--- /dev/null
+++ b/contrib/syncLDAP.pl
@@ -0,0 +1,283 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+use lib qw(. lib);
+
+use Net::LDAP;
+use Bugzilla;
+use Bugzilla::User;
+
+my $cgi = Bugzilla->cgi;
+my $dbh = Bugzilla->dbh;
+
+my $readonly = 0;
+my $nodisable = 0;
+my $noupdate = 0;
+my $nocreate = 0;
+my $quiet    = 0;
+
+###
+# Do some preparations
+###
+foreach my $arg (@ARGV)
+{
+   if($arg eq '-r') {
+      $readonly = 1;
+   }
+   elsif($arg eq '-d') {
+      $nodisable = 1;
+   }
+   elsif($arg eq '-u') {
+      $noupdate = 1;
+   }
+   elsif($arg eq '-c') {
+      $nocreate = 1;
+   }
+   elsif($arg eq '-q') {
+      $quiet = 1;
+   }
+   else {
+         print "LDAP Sync Script\n";
+         print "Syncronizes the users table from the LDAP server with the Bugzilla users.\n";
+         print "Takes mail-attribute from preferences and description from 'cn' or,\n";
+         print "if not available, from the uid-attribute.\n\n";
+         print "usage:\n syncLDAP.pl [options]\n\n";
+         print "options:\n";
+         print " -r Readonly, do not make changes to Bugzilla tables\n";
+         print " -d No disable, don't disable login by users who are not in LDAP\n";
+         print " -u No update, don't update users, which have different description in LDAP\n";
+         print " -c No create, don't create users, which are in LDAP but not in Bugzilla\n";
+         print " -q Quiet mode, give less output\n";
+         print "\n";
+         exit;
+   }
+}
+
+my %ldap_users;
+
+###
+# Get current bugzilla users
+###
+my %bugzilla_users = %{ $dbh->selectall_hashref(
+    'SELECT login_name AS new_login_name, realname, disabledtext ' .
+    'FROM profiles', 'new_login_name') };
+
+foreach my $login_name (keys %bugzilla_users) {
+    # remove whitespaces
+    $bugzilla_users{$login_name}{'realname'} =~ s/^\s+|\s+$//g;
+}
+
+###
+# Get current LDAP users
+###
+my $LDAPserver = Bugzilla->params->{"LDAPserver"};
+if ($LDAPserver eq "") {
+   print "No LDAP server defined in bugzilla preferences.\n";
+   exit;
+}
+
+my $LDAPconn;
+if($LDAPserver =~ /:\/\//) {
+    # if the "LDAPserver" parameter is in uri scheme
+    $LDAPconn = Net::LDAP->new($LDAPserver, version => 3);
+} else {
+    my $LDAPport = "389";  # default LDAP port
+    if($LDAPserver =~ /:/) {
+        ($LDAPserver, $LDAPport) = split(":",$LDAPserver);
+    }
+    $LDAPconn = Net::LDAP->new($LDAPserver, port => $LDAPport, version => 3);
+}
+
+if(!$LDAPconn) {
+   print "Connecting to LDAP server failed. Check LDAPserver setting.\n";
+   exit;
+}
+my $mesg;
+if (Bugzilla->params->{"LDAPbinddn"}) {
+    my ($LDAPbinddn,$LDAPbindpass) = split(":",Bugzilla->params->{"LDAPbinddn"});
+    $mesg = $LDAPconn->bind($LDAPbinddn, password => $LDAPbindpass);
+}
+else {
+    $mesg = $LDAPconn->bind();
+}
+if($mesg->code) {
+   print "Binding to LDAP server failed: " . $mesg->error . "\nCheck LDAPbinddn setting.\n";
+   exit;
+}
+
+# We've got our anonymous bind;  let's look up the users.
+$mesg = $LDAPconn->search( base   => Bugzilla->params->{"LDAPBaseDN"},
+                           scope  => "sub",
+                           filter => '(&(' . Bugzilla->params->{"LDAPuidattribute"} . "=*)" . Bugzilla->params->{"LDAPfilter"} . ')',
+                         );
+                         
+
+if(! $mesg->count) {
+   print "LDAP lookup failure. Check LDAPBaseDN setting.\n";
+   exit;
+}
+   
+my %val = %{ $mesg->as_struct };
+
+while( my ($key, $value) = each(%val) ) {
+
+   my @login_name = @{ $value->{Bugzilla->params->{"LDAPmailattribute"}} };
+   my @realname  = @{ $value->{"cn"} };
+
+   # no mail entered? go to next
+   if(! @login_name) { 
+      print "$key has no valid mail address\n";
+      next; 
+   }
+
+   # no cn entered? use uid instead
+   if(! @realname) { 
+       @realname = @{ $value->{Bugzilla->params->{"LDAPuidattribute"}} };
+   }
+  
+   my $login = shift @login_name;
+   my $real = shift @realname;
+   $ldap_users{$login} = { realname => $real };
+}
+
+print "\n" unless $quiet;
+
+###
+# Sort the users into disable/update/create-Lists and display everything
+###
+my %disable_users;
+my %update_users;
+my %create_users;
+
+print "Bugzilla-Users: \n" unless $quiet;
+while( my ($key, $value) = each(%bugzilla_users) ) {
+  print " " . $key . " '" . $value->{'realname'} . "' " . $value->{'disabledtext'} ."\n" unless $quiet==1;
+  if(!exists $ldap_users{$key}){
+     if($value->{'disabledtext'} eq '') {
+       $disable_users{$key} = $value;
+     }
+  }
+}
+
+print "\nLDAP-Users: \n" unless $quiet;
+while( my ($key, $value) = each(%ldap_users) ) {
+  print " " . $key . " '" . $value->{'realname'} . "'\n" unless $quiet==1;
+  if(!defined $bugzilla_users{$key}){
+    $create_users{$key} = $value;
+  }
+  else { 
+    my $bugzilla_user_value = $bugzilla_users{$key};
+    if($bugzilla_user_value->{'realname'} ne $value->{'realname'}) {
+      $update_users{$key} = $value;
+    }
+  }
+}
+
+print "\nDetecting email changes: \n" unless $quiet;
+while( my ($create_key, $create_value) = each(%create_users) ) {
+  while( my ($disable_key, $disable_value) = each(%disable_users) ) {
+    if($create_value->{'realname'} eq $disable_value->{'realname'}) {
+       print " " . $disable_key . " => " . $create_key ."'\n" unless $quiet==1;
+       $update_users{$disable_key} = { realname => $create_value->{'realname'},
+                                       new_login_name => $create_key };
+       delete $create_users{$create_key};
+       delete $disable_users{$disable_key};
+    }
+  }
+}
+
+if($quiet == 0) {
+   print "\nUsers to disable login for: \n";
+   while( my ($key, $value) = each(%disable_users) ) {
+     print " " . $key . " '" . $value->{'realname'} . "'\n";
+   }
+   
+   print "\nUsers to update: \n";
+   while( my ($key, $value) = each(%update_users) ) {
+     print " " . $key . " '" . $value->{'realname'} . "' ";
+     if(defined $value->{'new_login_name'}) {
+       print "has changed email to " . $value->{'new_login_name'};
+     }
+     print "\n";
+   }
+   
+   print "\nUsers to create: \n";
+   while( my ($key, $value) = each(%create_users) ) {
+     print " " . $key . " '" . $value->{'realname'} . "'\n";
+   }
+   
+   print "\n\n";
+}
+
+
+###
+# now do the DB-Update
+###
+if($readonly == 0) {
+   print "Performing DB update:\nPhase 1: disabling login for users not in LDAP... " unless $quiet;
+
+   my $sth_disable = $dbh->prepare(
+       'UPDATE profiles
+           SET disabledtext = ?
+         WHERE ' . $dbh->sql_istrcmp('login_name', '?'));
+
+   if($nodisable == 0) {
+      while( my ($key, $value) = each(%disable_users) ) {
+        $sth_disable->execute('auto-disabled by ldap sync', $key);
+      }
+      print "done!\n" unless $quiet;
+   }
+   else {
+      print "disabled!\n" unless $quiet;
+   }
+   
+   print "Phase 2: updating existing users... " unless $quiet;
+
+   my $sth_update_login = $dbh->prepare(
+       'UPDATE profiles
+           SET login_name = ? 
+         WHERE ' . $dbh->sql_istrcmp('login_name', '?'));
+   my $sth_update_realname = $dbh->prepare(
+       'UPDATE profiles
+           SET realname = ? 
+         WHERE ' . $dbh->sql_istrcmp('login_name', '?'));
+
+   if($noupdate == 0) {
+      while( my ($key, $value) = each(%update_users) ) {
+        if(defined $value->{'new_login_name'}) {
+          $sth_update_login->execute($value->{'new_login_name'}, $key);
+        } else {
+          $sth_update_realname->execute($value->{'realname'}, $key);
+        }
+      }
+      print "done!\n" unless $quiet;
+   }
+   else {
+      print "disabled!\n" unless $quiet;
+   }
+   
+   print "Phase 3: creating new users... " unless $quiet;
+   if($nocreate == 0) {
+      while( my ($key, $value) = each(%create_users) ) {
+        Bugzilla::User->create({
+            login_name => $key, 
+            realname   => $value->{'realname'},
+            cryptpassword   => '*'});
+      }
+      print "done!\n" unless $quiet;
+   }
+   else {
+      print "disabled!\n" unless $quiet;
+   }
+}
+else
+{
+   print "No changes to DB because readonly mode\n" unless $quiet;
+}

diff --git a/createaccount.cgi b/createaccount.cgi
new file mode 100755 (executable)
index 0000000..e3b8320
--- /dev/null
+++ b/createaccount.cgi
@@ -0,0 +1,47 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Token;
+
+# Just in case someone already has an account, let them get the correct footer
+# on an error message. The user is logged out just after the account is
+# actually created.
+my $user = Bugzilla->login(LOGIN_OPTIONAL);
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $vars = { doc_section => 'myaccount.html' };
+
+print $cgi->header();
+
+$user->check_account_creation_enabled;
+my $login = $cgi->param('login');
+
+if (defined($login)) {
+    # Check the hash token to make sure this user actually submitted
+    # the create account form.
+    my $token = $cgi->param('token');
+    check_hash_token($token, ['create_account']);
+
+    $user->check_and_send_account_creation_confirmation($login);
+    $vars->{'login'} = $login;
+
+    $template->process("account/created.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+# Show the standard "would you like to create an account?" form.
+$template->process("account/create.html.tmpl", $vars)
+  || ThrowTemplateError($template->error());

diff --git a/describecomponents.cgi b/describecomponents.cgi
new file mode 100755 (executable)
index 0000000..3a70f29
--- /dev/null
+++ b/describecomponents.cgi
@@ -0,0 +1,73 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Classification;
+use Bugzilla::Product;
+
+my $user = Bugzilla->login();
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $vars = {};
+
+print $cgi->header();
+
+# This script does nothing but displaying mostly static data.
+Bugzilla->switch_to_shadow_db;
+
+my $product_name = trim($cgi->param('product') || '');
+my $product = new Bugzilla::Product({'name' => $product_name});
+
+unless ($product && $user->can_access_product($product->name)) {
+    # Products which the user is allowed to see.
+    my @products = @{$user->get_accessible_products};
+
+    if (scalar(@products) == 0) {
+        ThrowUserError("no_products");
+    }
+    # If there is only one product available but the user entered
+    # another product name, we display a list with this single
+    # product only, to not confuse the user with components of a
+    # product he didn't request.
+    elsif (scalar(@products) > 1 || $product_name) {
+        $vars->{'classifications'} = sort_products_by_classification(\@products);
+        $vars->{'target'} = "describecomponents.cgi";
+        # If an invalid product name is given, or the user is not
+        # allowed to access that product, a message is displayed
+        # with a list of the products the user can choose from.
+        if ($product_name) {
+            $vars->{'message'} = "product_invalid";
+            # Do not use $product->name here, else you could use
+            # this way to determine whether the product exists or not.
+            $vars->{'product'} = $product_name;
+        }
+
+        $template->process("global/choose-product.html.tmpl", $vars)
+          || ThrowTemplateError($template->error());
+        exit;
+    }
+
+    # If there is only one product available and the user didn't specify
+    # any product name, we show this product.
+    $product = $products[0];
+}
+
+######################################################################
+# End Data/Security Validation
+######################################################################
+
+$vars->{'product'} = $product;
+
+$template->process("reports/components.html.tmpl", $vars)
+  || ThrowTemplateError($template->error());

diff --git a/describekeywords.cgi b/describekeywords.cgi
new file mode 100755 (executable)
index 0000000..b67b9c3
--- /dev/null
+++ b/describekeywords.cgi
@@ -0,0 +1,31 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Error;
+use Bugzilla::User;
+use Bugzilla::Keyword;
+
+my $user = Bugzilla->login();
+
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $vars = {};
+
+# Run queries against the shadow DB.
+Bugzilla->switch_to_shadow_db;
+
+$vars->{'keywords'} = Bugzilla::Keyword->get_all_with_bug_count();
+$vars->{'caneditkeywords'} = $user->in_group("editkeywords");
+
+print $cgi->header();
+$template->process("reports/keywords.html.tmpl", $vars)
+  || ThrowTemplateError($template->error());

diff --git a/docs/bugzilla.ent b/docs/bugzilla.ent
new file mode 100644 (file)
index 0000000..0d141e8
--- /dev/null
+++ b/docs/bugzilla.ent
@@ -0,0 +1,60 @@
+<!ENTITY bz-ver "4.4">
+<!ENTITY bz-date "2013-05-22">
+<!ENTITY current-year "2013">
+
+<!ENTITY min-perl-ver "5.8.1">
+<!ENTITY landfillbase "http://landfill.bugzilla.org/bugzilla-tip/">
+<!ENTITY bzg-bugs "http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla;component=Documentation">
+
+<!-- Module Versions -->
+<!ENTITY min-cgi-ver "3.51">
+<!ENTITY min-digest-sha-ver "any">
+<!ENTITY min-date-format-ver "2.23">
+<!ENTITY min-datetime-ver "0.28">
+<!ENTITY min-datetime-timezone-ver "0.71">
+<!ENTITY min-dbi-ver "1.54">
+<!ENTITY min-template-ver "2.22">
+<!ENTITY min-email-send-ver "2.04">
+<!ENTITY min-email-mime-ver "1.904">
+<!ENTITY min-uri-ver "1.37">
+<!ENTITY min-list-moreutils-ver "0.32">
+<!ENTITY min-math-random-isaac-ver "1.0.1">
+<!ENTITY min-gd-ver "1.20">
+<!ENTITY min-chart-lines-ver "2.1">
+<!ENTITY min-template-plugin-gd-image-ver "any">
+<!ENTITY min-gd-text-ver "any">
+<!ENTITY min-gd-graph-ver "any">
+<!ENTITY min-mime-parser-ver "5.406">
+<!ENTITY min-lwp-useragent-ver "any">
+<!ENTITY min-xml-twig-ver "any">
+<!ENTITY min-patchreader-ver "0.9.6">
+<!ENTITY min-net-ldap-ver "any">
+<!ENTITY min-authen-sasl-ver "any">
+<!ENTITY min-net-smtp-ssl-ver "1.01">
+<!ENTITY min-authen-radius-ver "any">
+<!ENTITY min-soap-lite-ver "0.712">
+<!ENTITY min-json-rpc-ver "any">
+<!ENTITY min-json-xs-ver "2.0">
+<!ENTITY min-test-taint-ver "any">
+<!ENTITY min-html-parser-ver "3.40">
+<!ENTITY min-html-scrubber-ver "any">
+<!ENTITY min-encode-ver "2.21">
+<!ENTITY min-encode-detect-ver "any">
+<!ENTITY min-email-reply-ver "any">
+<!ENTITY min-html-formattext-withlinks-ver "0.13">
+<!ENTITY min-theschwartz-ver "any">
+<!ENTITY min-daemon-generic-ver "any">
+<!ENTITY min-mod_perl2-ver "1.999022">
+<!ENTITY min-apache2-sizelimit-ver "0.96">
+<!ENTITY min-file-mimeinfo-magic-ver "any">
+<!ENTITY min-io-scalar-ver "any">
+
+ <!-- Database Versions --> 
+<!ENTITY min-dbd-pg-ver "2.7.0">
+<!ENTITY min-pg-ver "8.03.0000">
+<!ENTITY min-dbd-mysql-ver "4.001">
+<!ENTITY min-mysql-ver "5.0.15">
+<!ENTITY min-dbd-sqlite-ver "1.29">
+<!ENTITY min-sqlite-ver "3.6.22">
+<!ENTITY min-dbd-oracle-ver "1.19">
+<!ENTITY min-oracle-ver "10.02.0">

diff --git a/docs/bugzilla.ent.tmpl b/docs/bugzilla.ent.tmpl
new file mode 100644 (file)
index 0000000..f404969
--- /dev/null
+++ b/docs/bugzilla.ent.tmpl
@@ -0,0 +1,7 @@
+<!ENTITY bz-ver "4.4">
+<!ENTITY bz-date "2013-05-22">
+<!ENTITY current-year "2013">
+
+<!ENTITY min-perl-ver "5.8.1">
+<!ENTITY landfillbase "http://landfill.bugzilla.org/bugzilla-tip/">
+<!ENTITY bzg-bugs "http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla;component=Documentation">

diff --git a/docs/en/README.docs b/docs/en/README.docs
new file mode 100644 (file)
index 0000000..f041ef0
--- /dev/null
+++ b/docs/en/README.docs
@@ -0,0 +1,42 @@
+Welcome to the Bugzilla documentation project!
+You'll find these directories and files here:
+
+README.docs    # This README file
+html/          # The compiled HTML docs from XML sources (do not edit)
+txt/           # The compiled text docs from XML sources (do not edit)
+pdf/           # The compiled PDF docs from XML sources (do not edit)
+xml/           # The original XML doc sources (edit these)
+
+A note about the XML:
+  The documentation is written in DocBook 4.2, and attempts to adhere
+to the LinuxDoc standards where applicable (http://www.tldp.org).
+If you need to edit the documentation, feel free to use any text editor
+to make the changes. XML is not rocket science -- simply make sure your
+text appears between appropriate tags (like <para>This is a paragraph</para>)
+and we'll be fine. If you are making more extensive changes, please ensure
+you at least validate your XML before checking it in by running makedocs.pl.
+
+  Thanks for taking the time to read these notes and consulting the
+documentation.  Please address comments and questions to the newsgroup:
+news://news.mozilla.org/mozilla.support.bugzilla.
+
+==========
+HOW TO SET UP YOUR OWN XML EDITING ENVIRONMENT:
+==========
+
+All you need to compile the documentation are the xmlto and dblatex
+scripts. All major Linux distributions have these packages and so
+it's very easy to install them. If these packages are correctly configured,
+all required dependencies such as xsltproc and pdftex will be installed
+at the same time, and so you don't have to worry about them.
+
+Once these applications are installed, all you need to do to compile
+the documentation is to run either:
+
+  makedocs.pl
+
+to compile the documentation in HTML and text formats only, or:
+
+  makedocs.pl --with-pdf
+
+to also compile the documentation in PDF format.

diff --git a/docs/en/html/Bugzilla-Guide.html b/docs/en/html/Bugzilla-Guide.html
new file mode 100644 (file)
index 0000000..49d58b5
--- /dev/null
+++ b/docs/en/html/Bugzilla-Guide.html
@@ -0,0 +1,5347 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>The Bugzilla Guide - 4.4 Release</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="description" content="This is the documentation for Bugzilla, a bug-tracking system from mozilla.org. Bugzilla is an enterprise-class piece of software that tracks millions of bugs and issues for hundreds of organizations around the world. The most current version of this document can always be found on the Bugzilla Documentation Page."><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="book" title="The Bugzilla Guide - 4.4 Release"><div class="titlepage"><div><div><h1 class="title"><a name="index"></a>The Bugzilla Guide - 4.4 
+    Release</h1></div><div><div class="authorgroup"><h3 class="corpauthor">The Bugzilla Team</h3></div></div><div><p class="pubdate">2013-05-22</p></div><div><div class="abstract" title="Abstract"><p class="title"><b>Abstract</b></p><p>
+             This is the documentation for Bugzilla, a 
+             bug-tracking system from mozilla.org.
+             Bugzilla is an enterprise-class piece of software
+             that tracks millions of bugs and issues for hundreds of
+             organizations around the world.
+      </p><p>
+        The most current version of this document can always be found on the
+        <a class="ulink" href="http://www.bugzilla.org/docs/" target="_top">Bugzilla 
+        Documentation Page</a>.
+      </p></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="chapter"><a href="#about">1. About This Guide</a></span></dt><dd><dl><dt><span class="section"><a href="#copyright">1.1. Copyright Information</a></span></dt><dt><span class="section"><a href="#disclaimer">1.2. Disclaimer</a></span></dt><dt><span class="section"><a href="#newversions">1.3. New Versions</a></span></dt><dt><span class="section"><a href="#credits">1.4. Credits</a></span></dt><dt><span class="section"><a href="#conventions">1.5. Document Conventions</a></span></dt></dl></dd><dt><span class="chapter"><a href="#installing-bugzilla">2. Installing Bugzilla</a></span></dt><dd><dl><dt><span class="section"><a href="#installation">2.1. Installation</a></span></dt><dd><dl><dt><span class="section"><a href="#install-perl">2.1.1. Perl</a></span></dt><dt><span class="section"><a href="#install-database">2.1.2. Database Engine</a></span></dt><dt><span class="section"><a href="#install-webserver">2.1.3. Web Server</a></span></dt><dt><span class="section"><a href="#install-bzfiles">2.1.4. Bugzilla</a></span></dt><dt><span class="section"><a href="#install-perlmodules">2.1.5. Perl Modules</a></span></dt><dt><span class="section"><a href="#install-MTA">2.1.6. Mail Transfer Agent (MTA)</a></span></dt><dt><span class="section"><a href="#using-mod_perl-with-bugzilla">2.1.7. Installing Bugzilla on mod_perl</a></span></dt></dl></dd><dt><span class="section"><a href="#configuration">2.2. Configuration</a></span></dt><dd><dl><dt><span class="section"><a href="#localconfig">2.2.1. localconfig</a></span></dt><dt><span class="section"><a href="#database-engine">2.2.2. Database Server</a></span></dt><dt><span class="section"><a href="#idp5421872">2.2.3. checksetup.pl</a></span></dt><dt><span class="section"><a href="#http">2.2.4. Web server</a></span></dt><dt><span class="section"><a href="#install-config-bugzilla">2.2.5. Bugzilla</a></span></dt></dl></dd><dt><span class="section"><a href="#extraconfig">2.3. Optional Additional Configuration</a></span></dt><dd><dl><dt><span class="section"><a href="#idp12391376">2.3.1. Bug Graphs</a></span></dt><dt><span class="section"><a href="#installation-whining-cron">2.3.2. The Whining Cron</a></span></dt><dt><span class="section"><a href="#installation-whining">2.3.3. Whining</a></span></dt><dt><span class="section"><a href="#apache-addtype">2.3.4. Serving Alternate Formats with the right MIME type</a></span></dt></dl></dd><dt><span class="section"><a href="#multiple-bz-dbs">2.4. Multiple Bugzilla databases with a single installation</a></span></dt><dt><span class="section"><a href="#os-specific">2.5. OS-Specific Installation Notes</a></span></dt><dd><dl><dt><span class="section"><a href="#os-win32">2.5.1. Microsoft Windows</a></span></dt><dt><span class="section"><a href="#os-macosx">2.5.2. <span class="productname">Mac OS X</span>™</a></span></dt><dt><span class="section"><a href="#os-linux">2.5.3. Linux Distributions</a></span></dt></dl></dd><dt><span class="section"><a href="#nonroot">2.6. UNIX (non-root) Installation Notes</a></span></dt><dd><dl><dt><span class="section"><a href="#idp12489024">2.6.1. Introduction</a></span></dt><dt><span class="section"><a href="#idp12491264">2.6.2. MySQL</a></span></dt><dt><span class="section"><a href="#idp12512944">2.6.3. Perl</a></span></dt><dt><span class="section"><a href="#install-perlmodules-nonroot">2.6.4. Perl Modules</a></span></dt><dt><span class="section"><a href="#idp12527776">2.6.5. HTTP Server</a></span></dt><dt><span class="section"><a href="#idp12534784">2.6.6. Bugzilla</a></span></dt></dl></dd><dt><span class="section"><a href="#upgrade">2.7. Upgrading to New Releases</a></span></dt><dd><dl><dt><span class="section"><a href="#upgrade-before">2.7.1. Before You Upgrade</a></span></dt><dt><span class="section"><a href="#upgrade-files">2.7.2. Getting The New Bugzilla</a></span></dt><dt><span class="section"><a href="#upgrade-completion">2.7.3. Completing Your Upgrade</a></span></dt><dt><span class="section"><a href="#upgrade-notifications">2.7.4. Automatic Notifications of New Releases</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="#administration">3. Administering Bugzilla</a></span></dt><dd><dl><dt><span class="section"><a href="#parameters">3.1. Bugzilla Configuration</a></span></dt><dd><dl><dt><span class="section"><a href="#param-requiredsettings">3.1.1. Required Settings</a></span></dt><dt><span class="section"><a href="#param-admin-policies">3.1.2. Administrative Policies</a></span></dt><dt><span class="section"><a href="#param-user-authentication">3.1.3. User Authentication</a></span></dt><dt><span class="section"><a href="#param-attachments">3.1.4. Attachments</a></span></dt><dt><span class="section"><a href="#param-bug-change-policies">3.1.5. Bug Change Policies</a></span></dt><dt><span class="section"><a href="#param-bugfields">3.1.6. Bug Fields</a></span></dt><dt><span class="section"><a href="#param-bugmoving">3.1.7. Bug Moving</a></span></dt><dt><span class="section"><a href="#param-dependency-graphs">3.1.8. Dependency Graphs</a></span></dt><dt><span class="section"><a href="#param-group-security">3.1.9. Group Security</a></span></dt><dt><span class="section"><a href="#bzldap">3.1.10. LDAP Authentication</a></span></dt><dt><span class="section"><a href="#bzradius">3.1.11. RADIUS Authentication</a></span></dt><dt><span class="section"><a href="#param-email">3.1.12. Email</a></span></dt><dt><span class="section"><a href="#param-patchviewer">3.1.13. Patch Viewer</a></span></dt><dt><span class="section"><a href="#param-querydefaults">3.1.14. Query Defaults</a></span></dt><dt><span class="section"><a href="#param-shadowdatabase">3.1.15. Shadow Database</a></span></dt><dt><span class="section"><a href="#admin-usermatching">3.1.16. User Matching</a></span></dt></dl></dd><dt><span class="section"><a href="#useradmin">3.2. User Administration</a></span></dt><dd><dl><dt><span class="section"><a href="#defaultuser">3.2.1. Creating the Default User</a></span></dt><dt><span class="section"><a href="#manageusers">3.2.2. Managing Other Users</a></span></dt></dl></dd><dt><span class="section"><a href="#classifications">3.3. Classifications</a></span></dt><dt><span class="section"><a href="#products">3.4. Products</a></span></dt><dd><dl><dt><span class="section"><a href="#create-product">3.4.1. Creating New Products</a></span></dt><dt><span class="section"><a href="#edit-products">3.4.2. Editing Products</a></span></dt><dt><span class="section"><a href="#comps-vers-miles-products">3.4.3. Adding or Editing Components, Versions and Target Milestones</a></span></dt><dt><span class="section"><a href="#product-group-controls">3.4.4. Assigning Group Controls to Products</a></span></dt></dl></dd><dt><span class="section"><a href="#components">3.5. Components</a></span></dt><dt><span class="section"><a href="#versions">3.6. Versions</a></span></dt><dt><span class="section"><a href="#milestones">3.7. Milestones</a></span></dt><dt><span class="section"><a href="#flags-overview">3.8. Flags</a></span></dt><dd><dl><dt><span class="section"><a href="#flags-simpleexample">3.8.1. A Simple Example</a></span></dt><dt><span class="section"><a href="#flags-about">3.8.2. About Flags</a></span></dt><dt><span class="section"><a href="#flag-askto">3.8.3. Using flag requests</a></span></dt><dt><span class="section"><a href="#flag-types">3.8.4. Two Types of Flags</a></span></dt><dt><span class="section"><a href="#flags-admin">3.8.5. Administering Flags</a></span></dt></dl></dd><dt><span class="section"><a href="#keywords">3.9. Keywords</a></span></dt><dt><span class="section"><a href="#custom-fields">3.10. Custom Fields</a></span></dt><dd><dl><dt><span class="section"><a href="#add-custom-fields">3.10.1. Adding Custom Fields</a></span></dt><dt><span class="section"><a href="#edit-custom-fields">3.10.2. Editing Custom Fields</a></span></dt><dt><span class="section"><a href="#delete-custom-fields">3.10.3. Deleting Custom Fields</a></span></dt></dl></dd><dt><span class="section"><a href="#edit-values">3.11. Legal Values</a></span></dt><dd><dl><dt><span class="section"><a href="#edit-values-list">3.11.1. Viewing/Editing legal values</a></span></dt><dt><span class="section"><a href="#edit-values-delete">3.11.2. Deleting legal values</a></span></dt></dl></dd><dt><span class="section"><a href="#bug_status_workflow">3.12. Bug Status Workflow</a></span></dt><dt><span class="section"><a href="#voting">3.13. Voting</a></span></dt><dt><span class="section"><a href="#quips">3.14. Quips</a></span></dt><dt><span class="section"><a href="#groups">3.15. Groups and Group Security</a></span></dt><dd><dl><dt><span class="section"><a href="#create-groups">3.15.1. Creating Groups</a></span></dt><dt><span class="section"><a href="#edit-groups">3.15.2. Editing Groups and Assigning Group Permissions</a></span></dt><dt><span class="section"><a href="#users-and-groups">3.15.3. Assigning Users to Groups</a></span></dt><dt><span class="section"><a href="#idp11180256">3.15.4. Assigning Group Controls to Products</a></span></dt></dl></dd><dt><span class="section"><a href="#sanitycheck">3.16. Checking and Maintaining Database Integrity</a></span></dt></dl></dd><dt><span class="chapter"><a href="#security">4. Bugzilla Security</a></span></dt><dd><dl><dt><span class="section"><a href="#security-os">4.1. Operating System</a></span></dt><dd><dl><dt><span class="section"><a href="#security-os-ports">4.1.1. TCP/IP Ports</a></span></dt><dt><span class="section"><a href="#security-os-accounts">4.1.2. System User Accounts</a></span></dt><dt><span class="section"><a href="#security-os-chroot">4.1.3. The <code class="filename">chroot</code> Jail</a></span></dt></dl></dd><dt><span class="section"><a href="#security-webserver">4.2. Web server</a></span></dt><dd><dl><dt><span class="section"><a href="#security-webserver-access">4.2.1. Disabling Remote Access to Bugzilla Configuration Files</a></span></dt></dl></dd><dt><span class="section"><a href="#security-bugzilla">4.3. Bugzilla</a></span></dt><dd><dl><dt><span class="section"><a href="#security-bugzilla-charset">4.3.1. Prevent users injecting malicious Javascript</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="#using">5. Using Bugzilla</a></span></dt><dd><dl><dt><span class="section"><a href="#using-intro">5.1. Introduction</a></span></dt><dt><span class="section"><a href="#myaccount">5.2. Create a Bugzilla Account</a></span></dt><dt><span class="section"><a href="#bug_page">5.3. Anatomy of a Bug</a></span></dt><dt><span class="section"><a href="#lifecycle">5.4. Life Cycle of a Bug</a></span></dt><dt><span class="section"><a href="#query">5.5. Searching for Bugs</a></span></dt><dd><dl><dt><span class="section"><a href="#boolean">5.5.1. Boolean Charts</a></span></dt><dt><span class="section"><a href="#quicksearch">5.5.2. Quicksearch</a></span></dt><dt><span class="section"><a href="#casesensitivity">5.5.3. Case Sensitivity in Searches</a></span></dt><dt><span class="section"><a href="#list">5.5.4. Bug Lists</a></span></dt><dt><span class="section"><a href="#individual-buglists">5.5.5. Adding/removing tags to/from bugs</a></span></dt></dl></dd><dt><span class="section"><a href="#bugreports">5.6. Filing Bugs</a></span></dt><dd><dl><dt><span class="section"><a href="#fillingbugs">5.6.1. Reporting a New Bug</a></span></dt><dt><span class="section"><a href="#cloningbugs">5.6.2. Clone an Existing Bug</a></span></dt></dl></dd><dt><span class="section"><a href="#attachments">5.7. Attachments</a></span></dt><dd><dl><dt><span class="section"><a href="#patchviewer">5.7.1. Patch Viewer</a></span></dt></dl></dd><dt><span class="section"><a href="#hintsandtips">5.8. Hints and Tips</a></span></dt><dd><dl><dt><span class="section"><a href="#idp11248736">5.8.1. Autolinkification</a></span></dt><dt><span class="section"><a href="#commenting">5.8.2. Comments</a></span></dt><dt><span class="section"><a href="#comment-wrapping">5.8.3. Server-Side Comment Wrapping</a></span></dt><dt><span class="section"><a href="#dependencytree">5.8.4. Dependency Tree</a></span></dt></dl></dd><dt><span class="section"><a href="#timetracking">5.9. Time Tracking Information</a></span></dt><dt><span class="section"><a href="#userpreferences">5.10. User Preferences</a></span></dt><dd><dl><dt><span class="section"><a href="#generalpreferences">5.10.1. General Preferences</a></span></dt><dt><span class="section"><a href="#emailpreferences">5.10.2. Email Preferences</a></span></dt><dt><span class="section"><a href="#savedsearches">5.10.3. Saved Searches</a></span></dt><dt><span class="section"><a href="#accountpreferences">5.10.4. Name and Password</a></span></dt><dt><span class="section"><a href="#permissionsettings">5.10.5. Permissions</a></span></dt></dl></dd><dt><span class="section"><a href="#reporting">5.11. Reports and Charts</a></span></dt><dd><dl><dt><span class="section"><a href="#reports">5.11.1. Reports</a></span></dt><dt><span class="section"><a href="#charts">5.11.2. Charts</a></span></dt></dl></dd><dt><span class="section"><a href="#flags">5.12. Flags</a></span></dt><dt><span class="section"><a href="#whining">5.13. Whining</a></span></dt><dd><dl><dt><span class="section"><a href="#whining-overview">5.13.1. The Event</a></span></dt><dt><span class="section"><a href="#whining-schedule">5.13.2. Whining Schedule</a></span></dt><dt><span class="section"><a href="#whining-query">5.13.3. Whining Searches</a></span></dt><dt><span class="section"><a href="#idp11397440">5.13.4. Saving Your Changes</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="#customization">6. Customizing Bugzilla</a></span></dt><dd><dl><dt><span class="section"><a href="#extensions">6.1. Bugzilla Extensions</a></span></dt><dt><span class="section"><a href="#cust-skins">6.2. Custom Skins</a></span></dt><dt><span class="section"><a href="#cust-templates">6.3. Template Customization</a></span></dt><dd><dl><dt><span class="section"><a href="#template-directory">6.3.1. Template Directory Structure</a></span></dt><dt><span class="section"><a href="#template-method">6.3.2. Choosing a Customization Method</a></span></dt><dt><span class="section"><a href="#template-edit">6.3.3. How To Edit Templates</a></span></dt><dt><span class="section"><a href="#template-formats">6.3.4. Template Formats and Types</a></span></dt><dt><span class="section"><a href="#template-specific">6.3.5. Particular Templates</a></span></dt><dt><span class="section"><a href="#template-http-accept">6.3.6. Configuring Bugzilla to Detect the User's Language</a></span></dt></dl></dd><dt><span class="section"><a href="#cust-change-permissions">6.4. Customizing Who Can Change What</a></span></dt><dt><span class="section"><a href="#integration">6.5. Integrating Bugzilla with Third-Party Tools</a></span></dt></dl></dd><dt><span class="appendix"><a href="#troubleshooting">A. Troubleshooting</a></span></dt><dd><dl><dt><span class="section"><a href="#general-advice">A.1. General Advice</a></span></dt><dt><span class="section"><a href="#trbl-testserver">A.2. The Apache web server is not serving Bugzilla pages</a></span></dt><dt><span class="section"><a href="#trbl-perlmodule">A.3. I installed a Perl module, but 
+      <code class="filename">checksetup.pl</code> claims it's not installed!</a></span></dt><dt><span class="section"><a href="#trbl-dbdSponge">A.4. DBD::Sponge::db prepare failed</a></span></dt><dt><span class="section"><a href="#paranoid-security">A.5. cannot chdir(/var/spool/mqueue)</a></span></dt><dt><span class="section"><a href="#trbl-relogin-everyone">A.6. Everybody is constantly being forced to relogin</a></span></dt><dt><span class="section"><a href="#trbl-index">A.7. <code class="filename">index.cgi</code> doesn't show up unless specified in the URL</a></span></dt><dt><span class="section"><a href="#trbl-passwd-encryption">A.8. 
+      checksetup.pl reports "Client does not support authentication protocol
+      requested by server..."
+    </a></span></dt></dl></dd><dt><span class="appendix"><a href="#patches">B. Contrib</a></span></dt><dd><dl><dt><span class="section"><a href="#cmdline">B.1. Command-line Search Interface</a></span></dt><dt><span class="section"><a href="#cmdline-bugmail">B.2. Command-line 'Send Unsent Bug-mail' tool</a></span></dt></dl></dd><dt><span class="appendix"><a href="#install-perlmodules-manual">C. Manual Installation of Perl Modules</a></span></dt><dd><dl><dt><span class="section"><a href="#modules-manual-instructions">C.1. Instructions</a></span></dt><dt><span class="section"><a href="#modules-manual-download">C.2. Download Locations</a></span></dt><dt><span class="section"><a href="#modules-manual-optional">C.3. Optional Modules</a></span></dt></dl></dd><dt><span class="appendix"><a href="#gfdl">D. GNU Free Documentation License</a></span></dt><dd><dl><dt><span class="section"><a href="#gfdl-0">D.0. Preamble</a></span></dt><dt><span class="section"><a href="#gfdl-1">D.1. Applicability and Definition</a></span></dt><dt><span class="section"><a href="#gfdl-2">D.2. Verbatim Copying</a></span></dt><dt><span class="section"><a href="#gfdl-3">D.3. Copying in Quantity</a></span></dt><dt><span class="section"><a href="#gfdl-4">D.4. Modifications</a></span></dt><dt><span class="section"><a href="#gfdl-5">D.5. Combining Documents</a></span></dt><dt><span class="section"><a href="#gfdl-6">D.6. Collections of Documents</a></span></dt><dt><span class="section"><a href="#gfdl-7">D.7. Aggregation with Independent Works</a></span></dt><dt><span class="section"><a href="#gfdl-8">D.8. Translation</a></span></dt><dt><span class="section"><a href="#gfdl-9">D.9. Termination</a></span></dt><dt><span class="section"><a href="#gfdl-10">D.10. Future Revisions of this License</a></span></dt><dt><span class="section"><a href="#gfdl-howto">D.. How to use this License for your documents</a></span></dt></dl></dd><dt><span class="glossary"><a href="#glossary">Glossary</a></span></dt></dl></div><div class="list-of-figures"><p><b>List of Figures</b></p><dl><dt>5.1. <a href="#lifecycle-image">Lifecycle of a Bugzilla Bug</a></dt></dl></div><div class="list-of-examples"><p><b>List of Examples</b></p><dl><dt>A.1. <a href="#trbl-relogin-everyone-share">Examples of urlbase/cookiepath pairs for sharing login cookies</a></dt><dt>A.2. <a href="#trbl-relogin-everyone-restrict">Examples of urlbase/cookiepath pairs to restrict the login cookie</a></dt></dl></div><div class="chapter" title="Chapter 1. About This Guide"><div class="titlepage"><div><div><h2 class="title"><a name="about"></a>Chapter 1. About This Guide</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#copyright">1.1. Copyright Information</a></span></dt><dt><span class="section"><a href="#disclaimer">1.2. Disclaimer</a></span></dt><dt><span class="section"><a href="#newversions">1.3. New Versions</a></span></dt><dt><span class="section"><a href="#credits">1.4. Credits</a></span></dt><dt><span class="section"><a href="#conventions">1.5. Document Conventions</a></span></dt></dl></div><div class="section" title="1.1. Copyright Information"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="copyright"></a>1.1. Copyright Information</h2></div></div></div><p>This document is copyright (c) 2000-2013 by the various
+    Bugzilla contributors who wrote it.</p><div class="blockquote"><blockquote class="blockquote"><p>
+       Permission is granted to copy, distribute and/or modify this
+       document under the terms of the GNU Free Documentation
+       License, Version 1.1 or any later version published by the
+       Free Software Foundation; with no Invariant Sections, no
+       Front-Cover Texts, and with no Back-Cover Texts. A copy of
+       the license is included in <a class="xref" href="#gfdl" title="Appendix D. GNU Free Documentation License">Appendix D, <i>GNU Free Documentation License</i></a>.
+      </p></blockquote></div><p>
+      If you have any questions regarding this document, its
+      copyright, or publishing this document in non-electronic form,
+      please contact the Bugzilla Team. 
+    </p></div><div class="section" title="1.2. Disclaimer"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="disclaimer"></a>1.2. Disclaimer</h2></div></div></div><p>
+      No liability for the contents of this document can be accepted.
+      Follow the instructions herein at your own risk.
+      This document may contain errors
+      and inaccuracies that may damage your system, cause your partner 
+      to leave you, your boss to fire you, your cats to
+      pee on your furniture and clothing, and global thermonuclear
+      war. Proceed with caution.
+    </p><p>
+      Naming of particular products or brands should not be seen as
+      endorsements, with the exception of the term "GNU/Linux". We
+      wholeheartedly endorse the use of GNU/Linux; it is an extremely 
+      versatile, stable,
+      and robust operating system that offers an ideal operating
+      environment for Bugzilla.
+    </p><p>
+      Although the Bugzilla development team has taken great care to
+      ensure that all exploitable bugs have been fixed, security holes surely 
+      exist in any piece of code. Great care should be taken both in 
+      the installation and usage of this software. The Bugzilla development
+      team members assume no liability for your use of Bugzilla. You have 
+      the source code, and are responsible for auditing it yourself to ensure
+      your security needs are met.
+    </p></div><div class="section" title="1.3. New Versions"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="newversions"></a>1.3. New Versions</h2></div></div></div><p>
+      This is the 4.4 version of The Bugzilla Guide. It is so named
+      to match the current version of Bugzilla.
+    </p><p>
+      The latest version of this guide can always be found at <a class="ulink" href="http://www.bugzilla.org/docs/" target="_top">http://www.bugzilla.org/docs/</a>. However, you should read
+      the version which came with the Bugzilla release you are using.
+    </p><p>  
+      In addition, there are Bugzilla template localization projects in
+      <a class="ulink" href="http://www.bugzilla.org/download/#localizations" target="_top">several languages</a>.
+      They may have translated documentation available. If you would like to
+      volunteer to translate the Guide into additional languages, please visit the
+      <a class="ulink" href="https://wiki.mozilla.org/Bugzilla:L10n" target="_top">Bugzilla L10n team</a>
+      page.
+    </p></div><div class="section" title="1.4. Credits"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="credits"></a>1.4. Credits</h2></div></div></div><p>
+      The people listed below have made enormous contributions to the
+      creation of this Guide, through their writing, dedicated hacking efforts,
+      numerous e-mail and IRC support sessions, and overall excellent
+      contribution to the Bugzilla community:
+    </p><div class="variablelist"><dl><dt><span class="term">Matthew P. Barnson <code class="email">&lt;<a class="email" href="mailto:mbarnson@sisna.com">mbarnson@sisna.com</a>&gt;</code></span></dt><dd><p>for the Herculean task of pulling together the Bugzilla Guide
+          and shepherding it to 2.14.
+          </p></dd><dt><span class="term">Terry Weissman <code class="email">&lt;<a class="email" href="mailto:terry@mozilla.org">terry@mozilla.org</a>&gt;</code></span></dt><dd><p>for initially writing Bugzilla and creating the README upon
+          which the UNIX installation documentation is largely based.
+          </p></dd><dt><span class="term">Tara Hernandez <code class="email">&lt;<a class="email" href="mailto:tara@tequilarists.org">tara@tequilarists.org</a>&gt;</code></span></dt><dd><p>for keeping Bugzilla development going strong after Terry left
+          mozilla.org and for running landfill.
+          </p></dd><dt><span class="term">Dave Lawrence <code class="email">&lt;<a class="email" href="mailto:dkl@redhat.com">dkl@redhat.com</a>&gt;</code></span></dt><dd><p>for providing insight into the key differences between Red
+          Hat's customized Bugzilla.
+          </p></dd><dt><span class="term">Dawn Endico <code class="email">&lt;<a class="email" href="mailto:endico@mozilla.org">endico@mozilla.org</a>&gt;</code></span></dt><dd><p>for being a hacker extraordinaire and putting up with Matthew's
+          incessant questions and arguments on irc.mozilla.org in #mozwebtools
+          </p></dd><dt><span class="term">Jacob Steenhagen <code class="email">&lt;<a class="email" href="mailto:jake@bugzilla.org">jake@bugzilla.org</a>&gt;</code></span></dt><dd><p>for taking over documentation during the 2.17 development
+          period.
+          </p></dd><dt><span class="term">Dave Miller <code class="email">&lt;<a class="email" href="mailto:justdave@bugzilla.org">justdave@bugzilla.org</a>&gt;</code></span></dt><dd><p>for taking over as project lead when Tara stepped down and
+         continually pushing for the documentation to be the best it can be.
+          </p></dd></dl></div><p>
+      Thanks also go to the following people for significant contributions 
+      to this documentation:
+      <span class="simplelist">Kevin Brannen, Vlad Dascalu, Ben FrantzDale, Eric Hanson, Zach Lipton, Gervase Markham, Andrew Pearson, Joe Robins, Spencer Smith, Ron Teitelbaum, Shane Travis, Martin Wulffeld</span>.
+    </p><p>
+      Also, thanks are due to the members of the 
+      <a class="ulink" href="news://news.mozilla.org/mozilla.support.bugzilla" target="_top">
+      mozilla.support.bugzilla</a>
+      newsgroup (and its predecessor, netscape.public.mozilla.webtools).
+      Without your discussions, insight, suggestions, and patches,
+      this could never have happened.
+    </p></div><div class="section" title="1.5. Document Conventions"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="conventions"></a>1.5. Document Conventions</h2></div></div></div><p>This document uses the following conventions:</p><div class="caution" title="Caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>This is a caution. Make sure to read this to not be in trouble!</p></td></tr></table></div><div class="tip" title="Tip" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../images/tip.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>This is a hint or tip, especially about some configuration tweaks.</p></td></tr></table></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>This is just a note, for your information.</p></td></tr></table></div><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>This is a warning, something you should take care of.</p></td></tr></table></div><p>
+    A filename or a path to a filename is displayed like this:
+    <code class="filename">/path/to/filename.ext</code>
+  </p><p>
+    A command to type in the shell is displayed like this:
+    <span class="command"><strong>command --arguments</strong></span>
+  </p><p>bash$ represents a normal user's prompt under bash shell</p><p>bash# represents a root user's prompt under bash shell</p><p>
+    A word which is in the glossary will appear like this:
+    <a class="glossterm" href="#gloss-bugzilla"><em class="glossterm">Bugzilla</em></a>
+  </p><p>
+    A sample of code is illustrated like this:
+    </p><pre class="programlisting">
+First Line of Code
+Second Line of Code
+...
+    </pre><p>
+  </p><p>
+    This documentation is maintained in DocBook 4.2 XML format.
+    Changes are best submitted as plain text or XML diffs, attached
+    to a bug filed in the <a class="ulink" href="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla;component=Documentation" target="_top">Bugzilla Documentation</a>
+    component.
+  </p></div></div><div class="chapter" title="Chapter 2. Installing Bugzilla"><div class="titlepage"><div><div><h2 class="title"><a name="installing-bugzilla"></a>Chapter 2. Installing Bugzilla</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#installation">2.1. Installation</a></span></dt><dd><dl><dt><span class="section"><a href="#install-perl">2.1.1. Perl</a></span></dt><dt><span class="section"><a href="#install-database">2.1.2. Database Engine</a></span></dt><dt><span class="section"><a href="#install-webserver">2.1.3. Web Server</a></span></dt><dt><span class="section"><a href="#install-bzfiles">2.1.4. Bugzilla</a></span></dt><dt><span class="section"><a href="#install-perlmodules">2.1.5. Perl Modules</a></span></dt><dt><span class="section"><a href="#install-MTA">2.1.6. Mail Transfer Agent (MTA)</a></span></dt><dt><span class="section"><a href="#using-mod_perl-with-bugzilla">2.1.7. Installing Bugzilla on mod_perl</a></span></dt></dl></dd><dt><span class="section"><a href="#configuration">2.2. Configuration</a></span></dt><dd><dl><dt><span class="section"><a href="#localconfig">2.2.1. localconfig</a></span></dt><dt><span class="section"><a href="#database-engine">2.2.2. Database Server</a></span></dt><dt><span class="section"><a href="#idp5421872">2.2.3. checksetup.pl</a></span></dt><dt><span class="section"><a href="#http">2.2.4. Web server</a></span></dt><dt><span class="section"><a href="#install-config-bugzilla">2.2.5. Bugzilla</a></span></dt></dl></dd><dt><span class="section"><a href="#extraconfig">2.3. Optional Additional Configuration</a></span></dt><dd><dl><dt><span class="section"><a href="#idp12391376">2.3.1. Bug Graphs</a></span></dt><dt><span class="section"><a href="#installation-whining-cron">2.3.2. The Whining Cron</a></span></dt><dt><span class="section"><a href="#installation-whining">2.3.3. Whining</a></span></dt><dt><span class="section"><a href="#apache-addtype">2.3.4. Serving Alternate Formats with the right MIME type</a></span></dt></dl></dd><dt><span class="section"><a href="#multiple-bz-dbs">2.4. Multiple Bugzilla databases with a single installation</a></span></dt><dt><span class="section"><a href="#os-specific">2.5. OS-Specific Installation Notes</a></span></dt><dd><dl><dt><span class="section"><a href="#os-win32">2.5.1. Microsoft Windows</a></span></dt><dt><span class="section"><a href="#os-macosx">2.5.2. <span class="productname">Mac OS X</span>™</a></span></dt><dt><span class="section"><a href="#os-linux">2.5.3. Linux Distributions</a></span></dt></dl></dd><dt><span class="section"><a href="#nonroot">2.6. UNIX (non-root) Installation Notes</a></span></dt><dd><dl><dt><span class="section"><a href="#idp12489024">2.6.1. Introduction</a></span></dt><dt><span class="section"><a href="#idp12491264">2.6.2. MySQL</a></span></dt><dt><span class="section"><a href="#idp12512944">2.6.3. Perl</a></span></dt><dt><span class="section"><a href="#install-perlmodules-nonroot">2.6.4. Perl Modules</a></span></dt><dt><span class="section"><a href="#idp12527776">2.6.5. HTTP Server</a></span></dt><dt><span class="section"><a href="#idp12534784">2.6.6. Bugzilla</a></span></dt></dl></dd><dt><span class="section"><a href="#upgrade">2.7. Upgrading to New Releases</a></span></dt><dd><dl><dt><span class="section"><a href="#upgrade-before">2.7.1. Before You Upgrade</a></span></dt><dt><span class="section"><a href="#upgrade-files">2.7.2. Getting The New Bugzilla</a></span></dt><dt><span class="section"><a href="#upgrade-completion">2.7.3. Completing Your Upgrade</a></span></dt><dt><span class="section"><a href="#upgrade-notifications">2.7.4. Automatic Notifications of New Releases</a></span></dt></dl></dd></dl></div><div class="section" title="2.1. Installation"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="installation"></a>2.1. Installation</h2></div></div></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>If you just want to <span class="emphasis"><em>use</em></span> Bugzilla, 
+      you do not need to install it. None of this chapter is relevant to
+      you. Ask your Bugzilla administrator for the URL to access it from
+      your web browser.
+      </p></td></tr></table></div><p>The Bugzilla server software is usually installed on Linux or 
+    Solaris. 
+    If you are installing on another OS, check <a class="xref" href="#os-specific" title="2.5. OS-Specific Installation Notes">Section 2.5, “OS-Specific Installation Notes”</a>
+    before you start your installation to see if there are any special
+    instructions.
+    </p><p>This guide assumes that you have administrative access to the
+    Bugzilla machine. It not possible to
+    install and run Bugzilla itself without administrative access except
+    in the very unlikely event that every single prerequisite is
+    already installed.
+    </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>The installation process may make your machine insecure for
+      short periods of time. Make sure there is a firewall between you
+      and the Internet.
+      </p></td></tr></table></div><p>
+    You are strongly recommended to make a backup of your system
+    before installing Bugzilla (and at regular intervals thereafter :-).
+    </p><p>In outline, the installation proceeds as follows:
+    </p><div class="procedure"><ol class="procedure" type="1"><li class="step" title="Step 1"><p><a class="link" href="#install-perl" title="2.1.1. Perl">Install Perl</a>
+        (5.8.1 or above)
+        </p></li><li class="step" title="Step 2"><p><a class="link" href="#install-database" title="2.1.2. Database Engine">Install a Database Engine</a>
+        </p></li><li class="step" title="Step 3"><p><a class="link" href="#install-webserver" title="2.1.3. Web Server">Install a Webserver</a>
+        </p></li><li class="step" title="Step 4"><p><a class="link" href="#install-bzfiles" title="2.1.4. Bugzilla">Install Bugzilla</a>
+        </p></li><li class="step" title="Step 5"><p><a class="link" href="#install-perlmodules" title="2.1.5. Perl Modules">Install Perl modules</a>
+        </p></li><li class="step" title="Step 6"><p>
+          <a class="link" href="#install-MTA" title="2.1.6. Mail Transfer Agent (MTA)">Install a Mail Transfer Agent</a>
+          (Sendmail 8.7 or above, or an MTA that is Sendmail-compatible with at least this version)
+        </p></li><li class="step" title="Step 7"><p>Configure all of the above.
+        </p></li></ol></div><div class="section" title="2.1.1. Perl"><div class="titlepage"><div><div><h3 class="title"><a name="install-perl"></a>2.1.1. Perl</h3></div></div></div><p>Installed Version Test: </p><pre class="programlisting">perl -v</pre><p>Any machine that doesn't have Perl on it is a sad machine indeed.
+      If you don't have it and your OS doesn't provide official packages, 
+      visit <a class="ulink" href="http://www.perl.org" target="_top">http://www.perl.org</a>.
+      Although Bugzilla runs with Perl 5.8.1,
+      it's a good idea to be using the latest stable version.
+      </p></div><div class="section" title="2.1.2. Database Engine"><div class="titlepage"><div><div><h3 class="title"><a name="install-database"></a>2.1.2. Database Engine</h3></div></div></div><p>
+        Bugzilla supports MySQL, PostgreSQL and Oracle as database servers.
+        You only require one of these systems to make use of Bugzilla.
+      </p><div class="section" title="2.1.2.1. MySQL"><div class="titlepage"><div><div><h4 class="title"><a name="install-mysql"></a>2.1.2.1. MySQL</h4></div></div></div><p>Installed Version Test: </p><pre class="programlisting">mysql -V</pre><p>
+          If you don't have it and your OS doesn't provide official packages, 
+          visit <a class="ulink" href="http://www.mysql.com" target="_top">http://www.mysql.com</a>. You need MySQL version
+          5.0.15 or higher.
+          </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p> Many of the binary
+            versions of MySQL store their data files in 
+            <code class="filename">/var</code>.
+            On some Unix systems, this is part of a smaller root partition,
+            and may not have room for your bug database. To change the data
+            directory, you have to build MySQL from source yourself, and
+            set it as an option to <code class="filename">configure</code>.</p></td></tr></table></div><p>If you install from something other than a packaging/installation
+          system, such as .rpm (RPM Package Manager), .deb (Debian Package), .exe
+          (Windows Executable), or .msi (Windows Installer), make sure the MySQL
+          server is started when the machine boots.
+          </p></div><div class="section" title="2.1.2.2. PostgreSQL"><div class="titlepage"><div><div><h4 class="title"><a name="install-pg"></a>2.1.2.2. PostgreSQL</h4></div></div></div><p>Installed Version Test: </p><pre class="programlisting">psql -V</pre><p>
+          If you don't have it and your OS doesn't provide official packages, 
+          visit <a class="ulink" href="http://www.postgresql.org/" target="_top">http://www.postgresql.org/</a>. You need PostgreSQL
+          version 8.03.0000 or higher.
+          </p><p>If you install from something other than a packaging/installation
+          system, such as .rpm (RPM Package Manager), .deb (Debian Package), .exe
+          (Windows Executable), or .msi (Windows Installer), make sure the
+          PostgreSQL server is started when the machine boots.
+          </p></div><div class="section" title="2.1.2.3. Oracle"><div class="titlepage"><div><div><h4 class="title"><a name="install-oracle"></a>2.1.2.3. Oracle</h4></div></div></div><p>
+          Installed Version Test: </p><pre class="programlisting">select * from v$version</pre><p>
+          (you first have to log in into your DB)
+        </p><p>
+          If you don't have it and your OS doesn't provide official packages,
+          visit <a class="ulink" href="http://www.oracle.com/" target="_top">http://www.oracle.com/</a>. You need Oracle
+          version 10.02.0 or higher.
+        </p><p>
+          If you install from something other than a packaging/installation
+          system, such as .rpm (RPM Package Manager), .deb (Debian Package), .exe
+          (Windows Executable), or .msi (Windows Installer), make sure the
+          Oracle server is started when the machine boots.
+        </p></div></div><div class="section" title="2.1.3. Web Server"><div class="titlepage"><div><div><h3 class="title"><a name="install-webserver"></a>2.1.3. Web Server</h3></div></div></div><p>Installed Version Test: view the default welcome page at
+      http://&lt;your-machine&gt;/</p><p>
+        You have freedom of choice here, pretty much any web server that
+        is capable of running <a class="glossterm" href="#gloss-cgi"><em class="glossterm">CGI</em></a>
+        scripts will work.
+        However, we strongly recommend using the Apache web server
+        (either 1.3.x or 2.x), and the installation instructions usually assume
+        you are using it. If you have got Bugzilla working using another web server,
+        please share your experiences with us by filing a bug in
+        <a class="ulink" href="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla;component=Documentation" target="_top">Bugzilla Documentation</a>.
+      </p><p>
+      If you don't have Apache and your OS doesn't provide official packages, 
+      visit <a class="ulink" href="http://httpd.apache.org/" target="_top">http://httpd.apache.org/</a>.
+      </p></div><div class="section" title="2.1.4. Bugzilla"><div class="titlepage"><div><div><h3 class="title"><a name="install-bzfiles"></a>2.1.4. Bugzilla</h3></div></div></div><p>
+        <a class="ulink" href="http://www.bugzilla.org/download/" target="_top">Download a Bugzilla tarball</a>
+        (or <a class="ulink" href="https://wiki.mozilla.org/Bugzilla:Bzr" target="_top">check it out from Bzr</a>)
+        and place it in a suitable directory, accessible by the default web server user
+        (probably <span class="quote">“<span class="quote">apache</span>”</span> or <span class="quote">“<span class="quote">www</span>”</span>). 
+        Good locations are either directly in the web server's document directories or
+        in <code class="filename">/usr/local</code> with a symbolic link to the web server's 
+        document directories or an alias in the web server's configuration.
+      </p><div class="caution" title="Caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>The default Bugzilla distribution is NOT designed to be placed
+        in a <code class="filename">cgi-bin</code> directory. This
+        includes any directory which is configured using the
+        <code class="option">ScriptAlias</code> directive of Apache.
+        </p></td></tr></table></div><p>Once all the files are in a web accessible directory, make that
+      directory writable by your web server's user. This is a temporary step
+      until you run the 
+      <code class="filename">checksetup.pl</code>
+      script, which locks down your installation.</p></div><div class="section" title="2.1.5. Perl Modules"><div class="titlepage"><div><div><h3 class="title"><a name="install-perlmodules"></a>2.1.5. Perl Modules</h3></div></div></div><p>Bugzilla's installation process is based
+      on a script called <code class="filename">checksetup.pl</code>. 
+      The first thing it checks is whether you have appropriate 
+      versions of all the required
+      Perl modules. The aim of this section is to pass this check. 
+      When it passes, proceed to <a class="xref" href="#configuration" title="2.2. Configuration">Section 2.2, “Configuration”</a>.
+      </p><p>
+      At this point, you need to <code class="filename">su</code> to root. You should
+      remain as root until the end of the install. To check you have the
+      required modules, run:
+      </p><pre class="screen"><code class="prompt">bash#</code> ./checksetup.pl --check-modules</pre><p>
+        <code class="filename">checksetup.pl</code> will print out a list of the
+        required and optional Perl modules, together with the versions
+        (if any) installed on your machine.
+        The list of required modules is reasonably long; however, you 
+        may already have several of them installed.
+      </p><p>
+        The preferred way to install missing Perl modules is to use the package
+        manager provided by your operating system (e.g <span class="quote">“<span class="quote">rpm</span>”</span> or
+        <span class="quote">“<span class="quote">yum</span>”</span> on Linux distros, or <span class="quote">“<span class="quote">ppm</span>”</span> on Windows
+        if using ActivePerl, see <a class="xref" href="#win32-perl-modules" title="2.5.1.2. Perl Modules on Win32">Section 2.5.1.2, “Perl Modules on Win32”</a>).
+        If some Perl modules are still missing or are too old, then we recommend
+        using the <code class="filename">install-module.pl</code> script (doesn't work
+        with ActivePerl on Windows). If for some reason you really need to
+        install the Perl modules manually, see
+        <a class="xref" href="#install-perlmodules-manual" title="Appendix C. Manual Installation of Perl Modules">Appendix C, <i>Manual Installation of Perl Modules</i></a>. For instance, on Unix,
+        you invoke <code class="filename">install-module.pl</code> as follows:
+      </p><pre class="screen"><code class="prompt">bash#</code> perl install-module.pl &lt;modulename&gt;</pre><div class="tip" title="Tip" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../images/tip.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Many people complain that Perl modules will not install for
+        them. Most times, the error messages complain that they are missing a
+        file in 
+        <span class="quote">“<span class="quote">@INC</span>”</span>.
+        Virtually every time, this error is due to permissions being set too
+        restrictively for you to compile Perl modules or not having the
+        necessary Perl development libraries installed on your system.
+        Consult your local UNIX systems administrator for help solving these
+        permissions issues; if you 
+        <span class="emphasis"><em>are</em></span>
+        the local UNIX sysadmin, please consult the newsgroup/mailing list
+        for further assistance or hire someone to help you out.</p></td></tr></table></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>If you are using a package-based system, and attempting to install the
+        Perl modules from CPAN, you may need to install the "development" packages for
+        MySQL and GD before attempting to install the related Perl modules. The names of
+        these packages will vary depending on the specific distribution you are using,
+        but are often called <code class="filename">&lt;packagename&gt;-devel</code>.</p></td></tr></table></div><p>
+        Here is a complete list of modules and their minimum versions.
+        Some modules have special installation notes, which follow.
+      </p><p>Required Perl modules:
+      </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+            CGI (3.51)
+          </p></li><li class="listitem"><p>
+            Date::Format (2.23)
+          </p></li><li class="listitem"><p>
+            DateTime (0.28)
+          </p></li><li class="listitem"><p>
+            DateTime::TimeZone (0.71)
+          </p></li><li class="listitem"><p>
+            DBI (1.54)
+          </p></li><li class="listitem"><p>
+            DBD::mysql (4.001) if using MySQL
+          </p></li><li class="listitem"><p>
+            DBD::Pg (2.7.0) if using PostgreSQL
+          </p></li><li class="listitem"><p>
+            DBD::Oracle (1.19) if using Oracle
+          </p></li><li class="listitem"><p>
+            Digest::SHA (any)
+          </p></li><li class="listitem"><p>
+            Email::Send (2.04)
+          </p></li><li class="listitem"><p>
+            Email::MIME (1.904)
+          </p></li><li class="listitem"><p>
+            Template (2.22)
+          </p></li><li class="listitem"><p>
+            URI (1.37)
+          </p></li></ol></div><p>
+
+      Optional Perl modules:
+      </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+            GD (1.20) for bug charting
+          </p></li><li class="listitem"><p>
+            Template::Plugin::GD::Image
+            (any) for Graphical Reports
+          </p></li><li class="listitem"><p>
+            Chart::Lines (2.1) for bug charting
+          </p></li><li class="listitem"><p>
+            GD::Graph (any) for bug charting
+          </p></li><li class="listitem"><p>
+            GD::Text (any) for bug charting
+          </p></li><li class="listitem"><p>
+            XML::Twig (any) for bug import/export
+          </p></li><li class="listitem"><p>
+            MIME::Parser (5.406) for bug import/export
+          </p></li><li class="listitem"><p>
+            LWP::UserAgent
+            (any) for Automatic Update Notifications
+          </p></li><li class="listitem"><p>
+            PatchReader (0.9.6) for pretty HTML view of patches
+          </p></li><li class="listitem"><p>
+            Net::LDAP
+            (any) for LDAP Authentication
+          </p></li><li class="listitem"><p>
+            Authen::SASL
+            (any) for SASL Authentication
+          </p></li><li class="listitem"><p>
+            Authen::Radius
+            (any) for RADIUS Authentication
+          </p></li><li class="listitem"><p>
+            SOAP::Lite (0.712) for the web service interface
+          </p></li><li class="listitem"><p>
+            JSON::RPC
+            (any) for the JSON-RPC interface
+          </p></li><li class="listitem"><p>
+            Test::Taint
+            (any) for the web service interface
+          </p></li><li class="listitem"><p>
+            HTML::Parser
+            (3.40) for More HTML in Product/Group Descriptions
+          </p></li><li class="listitem"><p>
+            HTML::Scrubber
+            (any) for More HTML in Product/Group Descriptions
+          </p></li><li class="listitem"><p>
+            Email::Reply
+            (any) for Inbound Email
+          </p></li><li class="listitem"><p>
+            TheSchwartz
+            (any) for Mail Queueing
+          </p></li><li class="listitem"><p>
+            Daemon::Generic
+            (any) for Mail Queueing
+          </p></li><li class="listitem"><p>
+            mod_perl2
+            (1.999022) for mod_perl
+          </p></li></ol></div><p>
+      </p></div><div class="section" title="2.1.6. Mail Transfer Agent (MTA)"><div class="titlepage"><div><div><h3 class="title"><a name="install-MTA"></a>2.1.6. Mail Transfer Agent (MTA)</h3></div></div></div><p>
+        Bugzilla is dependent on the availability of an e-mail system for its 
+        user authentication and for other tasks.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          This is not entirely true.  It is possible to completely disable 
+          email sending, or to have Bugzilla store email messages in a 
+          file instead of sending them.  However, this is mainly intended 
+          for testing, as disabling or diverting email on a production 
+          machine would mean that users could miss important events (such 
+          as bug changes or the creation of new accounts).
+        </p><p>
+          For more information, see the <span class="quote">“<span class="quote">mail_delivery_method</span>”</span> parameter
+          in <a class="xref" href="#parameters" title="3.1. Bugzilla Configuration">Section 3.1, “Bugzilla Configuration”</a>.
+        </p></td></tr></table></div><p>
+        On Linux, any Sendmail-compatible MTA (Mail Transfer Agent) will 
+        suffice.  Sendmail, Postfix, qmail and Exim are examples of common 
+        MTAs. Sendmail is the original Unix MTA, but the others are easier to 
+        configure, and therefore many people replace Sendmail with Postfix or 
+        Exim. They are drop-in replacements, so Bugzilla will not 
+        distinguish between them.
+      </p><p>
+        If you are using Sendmail, version 8.7 or higher is required.
+        If you are using a Sendmail-compatible MTA, it must be congruent with 
+        at least version 8.7 of Sendmail.
+      </p><p>
+        Consult the manual for the specific MTA you choose for detailed 
+        installation instructions. Each of these programs will have their own 
+        configuration files where you must configure certain parameters to 
+        ensure that the mail is delivered properly. They are implemented 
+        as services, and you should ensure that the MTA is in the auto-start 
+        list of services for the machine.
+      </p><p>
+        If a simple mail sent with the command-line 'mail' program 
+        succeeds, then Bugzilla should also be fine.
+      </p></div><div class="section" title="2.1.7. Installing Bugzilla on mod_perl"><div class="titlepage"><div><div><h3 class="title"><a name="using-mod_perl-with-bugzilla"></a>2.1.7. Installing Bugzilla on mod_perl</h3></div></div></div><p>It is now possible to run the Bugzilla software under <code class="literal">mod_perl</code> on
+      Apache. <code class="literal">mod_perl</code> has some additional requirements to that of running
+      Bugzilla under <code class="literal">mod_cgi</code> (the standard and previous way).</p><p>Bugzilla requires <code class="literal">mod_perl</code> to be installed, which can be
+      obtained from <a class="ulink" href="http://perl.apache.org" target="_top">http://perl.apache.org</a> - Bugzilla requires
+      version 1.999022 (AKA 2.0.0-RC5) to be installed.</p></div></div><div class="section" title="2.2. Configuration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="configuration"></a>2.2. Configuration</h2></div></div></div><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        Poorly-configured MySQL and Bugzilla installations have
+        given attackers full access to systems in the past. Please take the
+        security parts of these guidelines seriously, even for Bugzilla 
+        machines hidden away behind your firewall. Be certain to read
+        <a class="xref" href="#security" title="Chapter 4. Bugzilla Security">Chapter 4, <i>Bugzilla Security</i></a> for some important security tips.
+      </p></td></tr></table></div><div class="section" title="2.2.1. localconfig"><div class="titlepage"><div><div><h3 class="title"><a name="localconfig"></a>2.2.1. localconfig</h3></div></div></div><p>
+        You should now run <code class="filename">checksetup.pl</code> again, this time
+        without the <code class="literal">--check-modules</code> switch.
+      </p><pre class="screen"><code class="prompt">bash#</code> ./checksetup.pl</pre><p>
+        This time, <code class="filename">checksetup.pl</code> should tell you that all
+        the correct modules are installed and will display a message about, and
+        write out a  file called, <code class="filename">localconfig</code>. This file
+        contains the default settings for a number of Bugzilla parameters.
+      </p><p>
+        Load this file in your editor. The only two values you
+        <span class="emphasis"><em>need</em></span> to change are $db_driver and $db_pass,
+        respectively the type of the database and the password for
+        the user you will create for your database. Pick a strong
+        password (for simplicity, it should not contain single quote
+        characters) and put it here. $db_driver can be either 'mysql',
+        'Pg', 'Oracle' or 'Sqlite'.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          In Oracle, <code class="literal">$db_name</code> should actually be 
+          the SID name of your database (e.g. "XE" if you are using Oracle XE).
+        </p></td></tr></table></div><p>
+        You may need to change the value of 
+        <span class="emphasis"><em>webservergroup</em></span> if your web server does not 
+        run in the "apache" group.  On Debian, for example, Apache runs in 
+        the "www-data" group.  If you are going to run Bugzilla on a 
+        machine where you do not have root access (such as on a shared web 
+        hosting account), you will need to leave
+        <span class="emphasis"><em>webservergroup</em></span> empty, ignoring the warnings 
+        that <code class="filename">checksetup.pl</code> will subsequently display 
+        every time it is run.
+      </p><div class="caution" title="Caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          If you are using suexec, you should use your own primary group
+          for <span class="emphasis"><em>webservergroup</em></span> rather than leaving it
+          empty, and see the additional directions in the suexec section
+          <a class="xref" href="#suexec" title="2.6.6.1. suexec or shared hosting">Section 2.6.6.1, “suexec or shared hosting”</a>.
+        </p></td></tr></table></div><p>
+        The other options in the <code class="filename">localconfig</code> file
+        are documented by their accompanying comments. If you have a slightly
+        non-standard database setup, you may wish to change one or more of
+        the other "$db_*" parameters.
+      </p></div><div class="section" title="2.2.2. Database Server"><div class="titlepage"><div><div><h3 class="title"><a name="database-engine"></a>2.2.2. Database Server</h3></div></div></div><p>
+        This section deals with configuring your database server for use
+        with Bugzilla. Currently, MySQL (<a class="xref" href="#mysql" title="2.2.2.2. MySQL">Section 2.2.2.2, “MySQL”</a>),
+        PostgreSQL (<a class="xref" href="#postgresql" title="2.2.2.3. PostgreSQL">Section 2.2.2.3, “PostgreSQL”</a>), Oracle (<a class="xref" href="#oracle" title="2.2.2.4. Oracle">Section 2.2.2.4, “Oracle”</a>)
+        and SQLite (<a class="xref" href="#sqlite" title="2.2.2.5. SQLite">Section 2.2.2.5, “SQLite”</a>) are available.
+      </p><div class="section" title="2.2.2.1. Bugzilla Database Schema"><div class="titlepage"><div><div><h4 class="title"><a name="database-schema"></a>2.2.2.1. Bugzilla Database Schema</h4></div></div></div><p>
+          The Bugzilla database schema is available at
+          <a class="ulink" href="http://www.ravenbrook.com/project/p4dti/tool/cgi/bugzilla-schema/" target="_top">Ravenbrook</a>.
+          This very valuable tool can generate a written description of
+          the Bugzilla database schema for any version of Bugzilla. It
+          can also generate a diff between two versions to help someone
+          see what has changed.
+        </p></div><div class="section" title="2.2.2.2. MySQL"><div class="titlepage"><div><div><h4 class="title"><a name="mysql"></a>2.2.2.2. MySQL</h4></div></div></div><div class="caution" title="Caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            MySQL's default configuration is insecure.
+            We highly recommend to run <code class="filename">mysql_secure_installation</code>
+            on Linux or the MySQL installer on Windows, and follow the instructions.
+            Important points to note are:
+            </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Be sure that the root account has a secure password set.</p></li><li class="listitem"><p>Do not create an anonymous account, and if it exists, say "yes"
+                to remove it.</p></li><li class="listitem"><p>If your web server and MySQL server are on the same machine,
+                you should disable the network access.</p></li></ol></div><p>
+          </p></td></tr></table></div><div class="section" title="2.2.2.2.1. Allow large attachments and many comments"><div class="titlepage"><div><div><h5 class="title"><a name="mysql-max-allowed-packet"></a>2.2.2.2.1. Allow large attachments and many comments</h5></div></div></div><p>By default, MySQL will only allow you to insert things
+          into the database that are smaller than 1MB. Attachments
+          may be larger than this. Also, Bugzilla combines all comments
+          on a single bug into one field for full-text searching, and the
+          combination of all comments on a single bug could in some cases
+          be larger than 1MB.</p><p>To change MySQL's default, you need to edit your MySQL
+          configuration file, which is usually <code class="filename">/etc/my.cnf</code>
+          on Linux. We recommend that you allow at least 4MB packets by
+          adding the "max_allowed_packet" parameter to your MySQL 
+          configuration in the "[mysqld]" section, like this:</p><pre class="screen">[mysqld]
+# Allow packets up to 4MB
+max_allowed_packet=4M
+          </pre></div><div class="section" title="2.2.2.2.2. Allow small words in full-text indexes"><div class="titlepage"><div><div><h5 class="title"><a name="idp5357136"></a>2.2.2.2.2. Allow small words in full-text indexes</h5></div></div></div><p>By default, words must be at least four characters in length
+          in order to be indexed by MySQL's full-text indexes. This causes
+          a lot of Bugzilla specific words to be missed, including "cc",
+          "ftp" and "uri".</p><p>MySQL can be configured to index those words by setting the
+          ft_min_word_len param to the minimum size of the words to index.
+          This can be done by modifying the <code class="filename">/etc/my.cnf</code>
+          according to the example below:</p><pre class="screen">[mysqld]
+# Allow small words in full-text indexes
+ft_min_word_len=2</pre><p>Rebuilding the indexes can be done based on documentation found at
+          <a class="ulink" href="http://www.mysql.com/doc/en/Fulltext_Fine-tuning.html" target="_top">http://www.mysql.com/doc/en/Fulltext_Fine-tuning.html</a>.
+          </p></div><div class="section" title="2.2.2.2.3. Add a user to MySQL"><div class="titlepage"><div><div><h5 class="title"><a name="install-setupdatabase-adduser"></a>2.2.2.2.3. Add a user to MySQL</h5></div></div></div><p>
+            You need to add a new MySQL user for Bugzilla to use.
+            (It's not safe to have Bugzilla use the MySQL root account.)
+            The following instructions assume the defaults in
+            <code class="filename">localconfig</code>; if you changed those,
+            you need to modify the SQL command appropriately. You will
+            need the <em class="replaceable"><code>$db_pass</code></em> password you
+            set in <code class="filename">localconfig</code> in 
+            <a class="xref" href="#localconfig" title="2.2.1. localconfig">Section 2.2.1, “localconfig”</a>.
+          </p><p>
+            We use an SQL <span class="command"><strong>GRANT</strong></span> command to create
+            a <span class="quote">“<span class="quote">bugs</span>”</span> user. This also restricts the 
+            <span class="quote">“<span class="quote">bugs</span>”</span>user to operations within a database
+            called <span class="quote">“<span class="quote">bugs</span>”</span>, and only allows the account
+            to connect from <span class="quote">“<span class="quote">localhost</span>”</span>. Modify it to
+            reflect your setup if you will be connecting from another
+            machine or as a different user.
+          </p><p>
+            Run the <code class="filename">mysql</code> command-line client and enter:
+          </p><pre class="screen">
+<code class="prompt">mysql&gt;</code> GRANT SELECT, INSERT,
+       UPDATE, DELETE, INDEX, ALTER, CREATE, LOCK TABLES,
+       CREATE TEMPORARY TABLES, DROP, REFERENCES ON bugs.*
+       TO bugs@localhost IDENTIFIED BY '<em class="replaceable"><code>$db_pass</code></em>';
+<code class="prompt">mysql&gt;</code> FLUSH PRIVILEGES;
+          </pre></div><div class="section" title="2.2.2.2.4. Permit attachments table to grow beyond 4GB"><div class="titlepage"><div><div><h5 class="title"><a name="idp5373312"></a>2.2.2.2.4. Permit attachments table to grow beyond 4GB</h5></div></div></div><p>
+            By default, MySQL will limit the size of a table to 4GB.
+            This limit is present even if the underlying filesystem
+            has no such limit.  To set a higher limit, follow these
+            instructions.
+          </p><p>
+            After you have completed the rest of the installation (or at least the
+            database setup parts), you should run the <code class="filename">MySQL</code>
+            command-line client and enter the following, replacing <code class="literal">$bugs_db</code>
+            with your Bugzilla database name (<span class="emphasis"><em>bugs</em></span> by default):
+          </p><pre class="screen">
+<code class="prompt">mysql&gt;</code> use <em class="replaceable"><code>$bugs_db</code></em>
+<code class="prompt">mysql&gt;</code> ALTER TABLE attachments
+           AVG_ROW_LENGTH=1000000, MAX_ROWS=20000;
+          </pre><p>
+            The above command will change the limit to 20GB. Mysql will have 
+            to make a temporary copy of your entire table to do this. Ideally, 
+            you should do this when your attachments table is still small. 
+          </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+              This does not affect Big Files, attachments that are stored directly
+              on disk instead of in the database.
+            </p></td></tr></table></div></div></div><div class="section" title="2.2.2.3. PostgreSQL"><div class="titlepage"><div><div><h4 class="title"><a name="postgresql"></a>2.2.2.3. PostgreSQL</h4></div></div></div><div class="section" title="2.2.2.3.1. Add a User to PostgreSQL"><div class="titlepage"><div><div><h5 class="title"><a name="idp5382912"></a>2.2.2.3.1. Add a User to PostgreSQL</h5></div></div></div><p>You need to add a new user to PostgreSQL for the Bugzilla
+          application to use when accessing the database. The following instructions
+          assume the defaults in <code class="filename">localconfig</code>; if you
+          changed those, you need to modify the commands appropriately. You will
+          need the <em class="replaceable"><code>$db_pass</code></em> password you
+          set in <code class="filename">localconfig</code> in 
+          <a class="xref" href="#localconfig" title="2.2.1. localconfig">Section 2.2.1, “localconfig”</a>.</p><p>On most systems, to create the user in PostgreSQL, you will need to
+          login as the root user, and then</p><pre class="screen"><code class="prompt">bash#</code> su - postgres</pre><p>As the postgres user, you then need to create a new user: </p><pre class="screen"><code class="prompt">bash$</code> createuser -U postgres -dRSP bugs</pre><p>When asked for a password, provide the password which will be set as
+          <em class="replaceable"><code>$db_pass</code></em> in <code class="filename">localconfig</code>.
+          The created user will not be a superuser (-S) and will not be able to create
+          new users (-R). He will only have the ability to create databases (-d).</p></div><div class="section" title="2.2.2.3.2. Configure PostgreSQL"><div class="titlepage"><div><div><h5 class="title"><a name="idp5392464"></a>2.2.2.3.2. Configure PostgreSQL</h5></div></div></div><p>Now, you will need to edit <code class="filename">pg_hba.conf</code> which is
+          usually located in <code class="filename">/var/lib/pgsql/data/</code>. In this file,
+          you will need to add a new line to it as follows:</p><p>
+            <code class="computeroutput">host   all    bugs   127.0.0.1    255.255.255.255  md5</code>
+          </p><p>This means that for TCP/IP (host) connections, allow connections from
+          '127.0.0.1' to 'all' databases on this server from the 'bugs' user, and use
+          password authentication (md5) for that user.</p><p>Now, you will need to restart PostgreSQL, but you will need to fully
+          stop and start the server rather than just restarting due to the possibility
+          of a change to <code class="filename">postgresql.conf</code>. After the server has
+          restarted, you will need to edit <code class="filename">localconfig</code>, finding
+          the <code class="literal">$db_driver</code> variable and setting it to
+          <code class="literal">Pg</code> and changing the password in <code class="literal">$db_pass</code>
+          to the one you picked previously, while setting up the account.</p></div></div><div class="section" title="2.2.2.4. Oracle"><div class="titlepage"><div><div><h4 class="title"><a name="oracle"></a>2.2.2.4. Oracle</h4></div></div></div><div class="section" title="2.2.2.4.1. Create a New Tablespace"><div class="titlepage"><div><div><h5 class="title"><a name="idp5402688"></a>2.2.2.4.1. Create a New Tablespace</h5></div></div></div><p>
+            You can use the existing tablespace or create a new one for Bugzilla.
+            To create a new tablespace, run the following command:
+          </p><pre class="programlisting">
+CREATE TABLESPACE bugs
+DATAFILE '<em class="replaceable"><code>$path_to_datafile</code></em>' SIZE 500M
+AUTOEXTEND ON NEXT 30M MAXSIZE UNLIMITED
+          </pre><p>
+            Here, the name of the tablespace is 'bugs', but you can
+            choose another name. <em class="replaceable"><code>$path_to_datafile</code></em> is
+            the path to the file containing your database, for instance
+            <code class="filename">/u01/oradata/bugzilla.dbf</code>.
+            The initial size of the database file is set in this example to 500 Mb,
+            with an increment of 30 Mb everytime we reach the size limit of the file.
+          </p></div><div class="section" title="2.2.2.4.2. Add a User to Oracle"><div class="titlepage"><div><div><h5 class="title"><a name="idp5407360"></a>2.2.2.4.2. Add a User to Oracle</h5></div></div></div><p>
+            The user name and password must match what you set in
+            <code class="filename">localconfig</code> (<code class="literal">$db_user</code>
+            and <code class="literal">$db_pass</code>, respectively). Here, we assume that
+            the user name is 'bugs' and the tablespace name is the same
+            as above. 
+          </p><pre class="programlisting">
+CREATE USER bugs
+IDENTIFIED BY "<em class="replaceable"><code>$db_pass</code></em>"
+DEFAULT TABLESPACE bugs
+TEMPORARY TABLESPACE TEMP
+PROFILE DEFAULT;
+-- GRANT/REVOKE ROLE PRIVILEGES
+GRANT CONNECT TO bugs;
+GRANT RESOURCE TO bugs;
+-- GRANT/REVOKE SYSTEM PRIVILEGES
+GRANT UNLIMITED TABLESPACE TO bugs;
+GRANT EXECUTE ON CTXSYS.CTX_DDL TO bugs;
+          </pre></div><div class="section" title="2.2.2.4.3. Configure the Web Server"><div class="titlepage"><div><div><h5 class="title"><a name="idp5412496"></a>2.2.2.4.3. Configure the Web Server</h5></div></div></div><p>
+            If you use Apache, append these lines to <code class="filename">httpd.conf</code>
+            to set ORACLE_HOME and LD_LIBRARY_PATH. For instance:
+          </p><pre class="programlisting">
+SetEnv ORACLE_HOME /u01/app/oracle/product/10.2.0/
+SetEnv LD_LIBRARY_PATH /u01/app/oracle/product/10.2.0/lib/
+          </pre><p>
+            When this is done, restart your web server.
+          </p></div></div><div class="section" title="2.2.2.5. SQLite"><div class="titlepage"><div><div><h4 class="title"><a name="sqlite"></a>2.2.2.5. SQLite</h4></div></div></div><div class="caution" title="Caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            Due to SQLite's <a class="ulink" href="http://sqlite.org/faq.html#q5" target="_top">concurrency
+            limitations</a> we recommend SQLite only for small and development
+            Bugzilla installations.
+          </p></td></tr></table></div><p>
+          No special configuration is required to run Bugzilla on SQLite.
+          The database will be stored in <code class="filename">data/db/$db_name</code>,
+          where <code class="literal">$db_name</code> is the database name defined
+          in <code class="filename">localconfig</code>.
+        </p></div></div><div class="section" title="2.2.3. checksetup.pl"><div class="titlepage"><div><div><h3 class="title"><a name="idp5421872"></a>2.2.3. checksetup.pl</h3></div></div></div><p>
+        Next, rerun <code class="filename">checksetup.pl</code>. It reconfirms
+        that all the modules are present, and notices the altered 
+        localconfig file, which it assumes you have edited to your
+        satisfaction. It compiles the UI templates,
+        connects to the database using the 'bugs'
+        user you created and the password you defined, and creates the 
+        'bugs' database and the tables therein. 
+      </p><p>
+        After that, it asks for details of an administrator account. Bugzilla
+        can have multiple administrators - you can create more later - but
+        it needs one to start off with.
+        Enter the email address of an administrator, his or her full name, 
+        and a suitable Bugzilla password.
+      </p><p>
+        <code class="filename">checksetup.pl</code> will then finish. You may rerun
+        <code class="filename">checksetup.pl</code> at any time if you wish.
+      </p></div><div class="section" title="2.2.4. Web server"><div class="titlepage"><div><div><h3 class="title"><a name="http"></a>2.2.4. Web server</h3></div></div></div><p>
+        Configure your web server according to the instructions in the
+        appropriate section. (If it makes a difference in your choice,
+        the Bugzilla Team recommends Apache.) To check whether your web server
+       is correctly configured, try to access <code class="filename">testagent.cgi</code>
+       from your web server. If "OK" is displayed, then your configuration
+       is successful. Regardless of which web server
+        you are using, however, ensure that sensitive information is
+        not remotely available by properly applying the access controls in
+        <a class="xref" href="#security-webserver-access" title="4.2.1. Disabling Remote Access to Bugzilla Configuration Files">Section 4.2.1, “Disabling Remote Access to Bugzilla Configuration Files”</a>. You can run
+        <code class="filename">testserver.pl</code> to check if your web server serves
+        Bugzilla files as expected.
+      </p><div class="section" title="2.2.4.1. Bugzilla using Apache"><div class="titlepage"><div><div><h4 class="title"><a name="http-apache"></a>2.2.4.1. Bugzilla using Apache</h4></div></div></div><p>You have two options for running Bugzilla under Apache - 
+          <a class="link" href="#http-apache-mod_cgi" title="2.2.4.1.1. Apache httpd™ with mod_cgi">mod_cgi</a> (the default) and
+          <a class="link" href="#http-apache-mod_perl" title="2.2.4.1.2. Apache httpd™ with mod_perl">mod_perl</a> (new in Bugzilla
+          2.23)
+        </p><div class="section" title="2.2.4.1.1. Apache httpd™ with mod_cgi"><div class="titlepage"><div><div><h5 class="title"><a name="http-apache-mod_cgi"></a>2.2.4.1.1. Apache <span class="productname">httpd</span>™ with mod_cgi</h5></div></div></div><p>
+            To configure your Apache web server to work with Bugzilla while using
+            mod_cgi, do the following:
+            </p><div class="procedure"><ol class="procedure" type="1"><li class="step" title="Step 1"><p>
+                Load <code class="filename">httpd.conf</code> in your editor.
+                In Fedora and Red Hat Linux, this file is found in
+                <code class="filename">/etc/httpd/conf</code>.
+                </p></li><li class="step" title="Step 2"><p>
+                Apache uses <code class="computeroutput">&lt;Directory&gt;</code>
+                directives to permit fine-grained permission setting. Add the
+                following lines to a directive that applies to the location
+                of your Bugzilla installation. (If such a section does not
+                exist, you'll want to add one.) In this example, Bugzilla has
+                been installed at 
+                <code class="filename">/var/www/html/bugzilla</code>.
+                </p><pre class="programlisting">
+&lt;Directory /var/www/html/bugzilla&gt;
+AddHandler cgi-script .cgi
+Options +ExecCGI
+DirectoryIndex index.cgi index.html
+AllowOverride Limit FileInfo Indexes Options
+&lt;/Directory&gt;
+                </pre><p>
+                These instructions: allow apache to run .cgi files found
+                within the bugzilla directory; instructs the server to look
+                for a file called <code class="filename">index.cgi</code> or, if not
+                found, <code class="filename">index.html</code> if someone
+                only types the directory name into the browser; and allows
+                Bugzilla's <code class="filename">.htaccess</code> files to override
+                some global permissions.
+                </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+                    It is possible to make these changes globally, or to the
+                    directive controlling Bugzilla's parent directory (e.g.
+                    <code class="computeroutput">&lt;Directory /var/www/html/&gt;</code>).
+                    Such changes would also apply to the Bugzilla directory...
+                    but they would also apply to many other places where they
+                    may or may not be appropriate. In most cases, including
+                    this one, it is better to be as restrictive as possible
+                    when granting extra access.
+                </p></td></tr></table></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+                    On Windows, you may have to also add the
+                    <code class="computeroutput">ScriptInterpreterSource Registry-Strict</code>
+                    line, see <a class="link" href="#win32-http" title="2.5.1.3. Serving the web pages">Windows specific notes</a>.
+                </p></td></tr></table></div></li><li class="step" title="Step 3"><p>
+                <code class="filename">checksetup.pl</code> can set tighter permissions
+                on Bugzilla's files and directories if it knows what group the
+                web server runs as. Find the <code class="computeroutput">Group</code>
+                line in <code class="filename">httpd.conf</code>, place the value found
+                there in the <em class="replaceable"><code>$webservergroup</code></em> variable
+                in <code class="filename">localconfig</code>, then rerun
+                <code class="filename">checksetup.pl</code>.
+                </p></li><li class="step" title="Step 4"><p>
+                Optional: If Bugzilla does not actually reside in the webspace
+                directory, but instead has been symbolically linked there, you
+                will need to add the following to the
+                <code class="computeroutput">Options</code> line of the Bugzilla 
+                <code class="computeroutput">&lt;Directory&gt;</code> directive
+                (the same one as in the step above):
+                </p><pre class="programlisting">+FollowSymLinks</pre><p>
+                Without this directive, Apache will not follow symbolic links
+                to places outside its own directory structure, and you will be
+                unable to run Bugzilla.
+                </p></li></ol></div></div><div class="section" title="2.2.4.1.2. Apache httpd™ with mod_perl"><div class="titlepage"><div><div><h5 class="title"><a name="http-apache-mod_perl"></a>2.2.4.1.2. Apache <span class="productname">httpd</span>™ with mod_perl</h5></div></div></div><p>Some configuration is required to make Bugzilla work with Apache
+            and mod_perl</p><div class="procedure"><ol class="procedure" type="1"><li class="step" title="Step 1"><p>
+                Load <code class="filename">httpd.conf</code> in your editor.
+                In Fedora and Red Hat Linux, this file is found in
+                <code class="filename">/etc/httpd/conf</code>.
+                </p></li><li class="step" title="Step 2"><p>Add the following information to your httpd.conf file, substituting
+                where appropriate with your own local paths.</p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>This should be used instead of the &lt;Directory&gt; block
+                shown above. This should also be above any other <code class="literal">mod_perl</code>
+                directives within the <code class="filename">httpd.conf</code> and must be specified
+                in the order as below.</p></td></tr></table></div><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>You should also ensure that you have disabled <code class="literal">KeepAlive</code>
+                support in your Apache install when utilizing Bugzilla under mod_perl</p></td></tr></table></div><pre class="programlisting">
+PerlSwitches -w -T
+PerlConfigRequire /var/www/html/bugzilla/mod_perl.pl
+                </pre></li><li class="step" title="Step 3"><p>
+                                       <code class="filename">checksetup.pl</code> can set tighter permissions
+                                       on Bugzilla's files and directories if it knows what group the
+                                       web server runs as. Find the <code class="computeroutput">Group</code>
+                                       line in <code class="filename">httpd.conf</code>, place the value found
+                                       there in the <em class="replaceable"><code>$webservergroup</code></em> variable
+                                       in <code class="filename">localconfig</code>, then rerun
+                                       <code class="filename">checksetup.pl</code>.
+                               </p></li></ol></div><p>On restarting Apache, Bugzilla should now be running within the
+            mod_perl environment. Please ensure you have run checksetup.pl to set
+                   permissions before you restart Apache.</p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Please bear the following points in mind when looking at using 
+                Bugzilla under mod_perl: 
+            </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
+                    mod_perl support in Bugzilla can take up a HUGE amount of RAM. You could be
+                    looking at 30MB per httpd child, easily. Basically, you just need a lot of RAM.
+                    The more RAM you can get, the better. mod_perl is basically trading RAM for
+                    speed. At least 2GB total system RAM is recommended for running Bugzilla under
+                    mod_perl.
+                </p></li><li class="listitem"><p>
+                    Under mod_perl, you have to restart Apache if you make any manual change to
+                    any Bugzilla file. You can't just reload--you have to actually 
+                                       <span class="emphasis"><em>restart</em></span> the server (as in make sure it stops and starts 
+                                       again). You <span class="emphasis"><em>can</em></span> change localconfig and the params file 
+                                       manually, if you want, because those are re-read every time you load a page.
+                </p></li><li class="listitem"><p>
+                    You must run in Apache's Prefork MPM (this is the default). The Worker MPM
+                    may not work--we haven't tested Bugzilla's mod_perl support under threads.
+                                       (And, in fact, we're fairly sure it <span class="emphasis"><em>won't</em></span> work.)
+                </p></li><li class="listitem"><p>
+                    Bugzilla generally expects to be the only mod_perl application running on
+                    your entire server. It may or may not work if there are other applications also
+                    running under mod_perl. It does try its best to play nice with other mod_perl
+                    applications, but it still may have conflicts.
+                </p></li><li class="listitem"><p>
+                    It is recommended that you have one Bugzilla instance running under mod_perl
+                    on your server. Bugzilla has not been tested with more than one instance running.
+                </p></li></ul></div><p>
+            </p></td></tr></table></div></div></div><div class="section" title="2.2.4.2. Microsoft Internet Information Services™"><div class="titlepage"><div><div><h4 class="title"><a name="http-iis"></a>2.2.4.2. Microsoft <span class="productname">Internet Information Services</span>™</h4></div></div></div><p>
+          If you are running Bugzilla on Windows and choose to use
+          Microsoft's <span class="productname">Internet Information Services</span>™
+          or <span class="productname">Personal Web Server</span>™ you will need
+          to perform a number of other configuration steps as explained below.
+          You may also want to refer to the following Microsoft Knowledge
+          Base articles: 
+          <a class="ulink" href="http://support.microsoft.com/default.aspx?scid=kb;en-us;245225" target="_top">245225</a> 
+          <span class="quote">“<span class="quote">HOW TO: Configure and Test a PERL Script with IIS 4.0,
+          5.0, and 5.1</span>”</span> (for <span class="productname">Internet Information
+          Services</span>™) and 
+          <a class="ulink" href="http://support.microsoft.com/default.aspx?scid=kb;en-us;231998" target="_top">231998</a>          
+          <span class="quote">“<span class="quote">HOW TO: FP2000: How to Use Perl with Microsoft Personal Web
+          Server on Windows 95/98</span>”</span> (for <span class="productname">Personal Web
+          Server</span>™).
+        </p><p>
+          You will need to create a virtual directory for the Bugzilla
+          install.  Put the Bugzilla files in a directory that is named
+          something <span class="emphasis"><em>other</em></span> than what you want your
+          end-users accessing.  That is, if you want your users to access
+          your Bugzilla installation through 
+          <span class="quote">“<span class="quote">http://&lt;yourdomainname&gt;/Bugzilla</span>”</span>, then do
+          <span class="emphasis"><em>not</em></span> put your Bugzilla files in a directory
+          named <span class="quote">“<span class="quote">Bugzilla</span>”</span>.  Instead, place them in a different
+          location, and then use the IIS Administration tool to create a
+          Virtual Directory named "Bugzilla" that acts as an alias for the
+          actual location of the files.  When creating that virtual directory,
+          make sure you add the <span class="quote">“<span class="quote">Execute (such as ISAPI applications or
+          CGI)</span>”</span> access permission.
+        </p><p>
+          You will also need to tell IIS how to handle Bugzilla's
+          .cgi files. Using the IIS Administration tool again, open up
+          the properties for the new virtual directory and select the
+          Configuration option to access the Script Mappings. Create an
+          entry mapping .cgi to:
+        </p><pre class="programlisting">
+&lt;full path to perl.exe &gt;\perl.exe -x&lt;full path to Bugzilla&gt; -wT "%s" %s
+        </pre><p>
+          For example:
+        </p><pre class="programlisting">
+c:\perl\bin\perl.exe -xc:\bugzilla -wT "%s" %s
+        </pre><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            The ActiveState install may have already created an entry for
+            .pl files that is limited to <span class="quote">“<span class="quote">GET,HEAD,POST</span>”</span>. If
+            so, this mapping should be <span class="emphasis"><em>removed</em></span> as
+            Bugzilla's .pl files are not designed to be run via a web server.
+          </p></td></tr></table></div><p>
+          IIS will also need to know that the index.cgi should be treated
+          as a default document.  On the Documents tab page of the virtual
+          directory properties, you need to add index.cgi as a default
+          document type.  If you  wish, you may remove the other default
+          document types for this particular virtual directory, since Bugzilla 
+          doesn't use any of them.
+        </p><p>
+          Also, and this can't be stressed enough, make sure that files
+          such as <code class="filename">localconfig</code> and your
+          <code class="filename">data</code> directory are
+          secured as described in <a class="xref" href="#security-webserver-access" title="4.2.1. Disabling Remote Access to Bugzilla Configuration Files">Section 4.2.1, “Disabling Remote Access to Bugzilla Configuration Files”</a>.
+        </p></div></div><div class="section" title="2.2.5. Bugzilla"><div class="titlepage"><div><div><h3 class="title"><a name="install-config-bugzilla"></a>2.2.5. Bugzilla</h3></div></div></div><p>
+        Your Bugzilla should now be working. Access 
+        <code class="filename">http://&lt;your-bugzilla-server&gt;/</code> - 
+        you should see the Bugzilla
+        front page. If not, consult the Troubleshooting section,
+        <a class="xref" href="#troubleshooting" title="Appendix A. Troubleshooting">Appendix A, <i>Troubleshooting</i></a>.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          The URL above may be incorrect if you installed Bugzilla into a 
+          subdirectory or used a symbolic link from your web site root to 
+          the Bugzilla directory.
+        </p></td></tr></table></div><p>
+        Log in with the administrator account you defined in the last 
+        <code class="filename">checksetup.pl</code> run. You should go through 
+        the Parameters page and see if there are any you wish to change.
+        They key parameters are documented in <a class="xref" href="#parameters" title="3.1. Bugzilla Configuration">Section 3.1, “Bugzilla Configuration”</a>;
+        you should certainly alter 
+        <span class="command"><strong>maintainer</strong></span> and <span class="command"><strong>urlbase</strong></span>; 
+        you may also want to alter 
+        <span class="command"><strong>cookiepath</strong></span> or <span class="command"><strong>requirelogin</strong></span>.
+      </p><p>
+        Bugzilla has several optional features which require extra 
+        configuration. You can read about those in
+        <a class="xref" href="#extraconfig" title="2.3. Optional Additional Configuration">Section 2.3, “Optional Additional Configuration”</a>.
+      </p></div></div><div class="section" title="2.3. Optional Additional Configuration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="extraconfig"></a>2.3. Optional Additional Configuration</h2></div></div></div><p>
+      Bugzilla has a number of optional features. This section describes how
+      to configure or enable them.
+    </p><div class="section" title="2.3.1. Bug Graphs"><div class="titlepage"><div><div><h3 class="title"><a name="idp12391376"></a>2.3.1. Bug Graphs</h3></div></div></div><p>If you have installed the necessary Perl modules you
+      can start collecting statistics for the nifty Bugzilla 
+      graphs.</p><pre class="screen"><code class="prompt">bash#</code> <span class="command"><strong>crontab -e</strong></span></pre><p>
+        This should bring up the crontab file in your editor. 
+        Add a cron entry like this to run 
+        <code class="filename">collectstats.pl</code> 
+        daily at 5 after midnight:
+      </p><pre class="programlisting">5 0 * * * cd &lt;your-bugzilla-directory&gt; &amp;&amp; ./collectstats.pl</pre><p>
+        After two days have passed you'll be able to view bug graphs from
+        the Reports page.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Windows does not have 'cron', but it does have the Task
+          Scheduler, which performs the same duties. There are also
+          third-party tools that can be used to implement cron, such as
+          <a class="ulink" href="http://www.nncron.ru/" target="_top">nncron</a>.
+        </p></td></tr></table></div></div><div class="section" title="2.3.2. The Whining Cron"><div class="titlepage"><div><div><h3 class="title"><a name="installation-whining-cron"></a>2.3.2. The Whining Cron</h3></div></div></div><p>What good are
+      bugs if they're not annoying? To help make them more so you
+      can set up Bugzilla's automatic whining system to complain at engineers
+      which leave their bugs in the CONFIRMED state without triaging them.
+      </p><p>
+        This can be done by adding the following command as a daily
+        crontab entry, in the same manner as explained above for bug
+        graphs. This example runs it at 12.55am. 
+      </p><pre class="programlisting">55 0 * * * cd &lt;your-bugzilla-directory&gt; &amp;&amp; ./whineatnews.pl</pre><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Windows does not have 'cron', but it does have the Task
+          Scheduler, which performs the same duties. There are also
+          third-party tools that can be used to implement cron, such as
+          <a class="ulink" href="http://www.nncron.ru/" target="_top">nncron</a>.
+        </p></td></tr></table></div></div><div class="section" title="2.3.3. Whining"><div class="titlepage"><div><div><h3 class="title"><a name="installation-whining"></a>2.3.3. Whining</h3></div></div></div><p>
+        As of Bugzilla 2.20, users can configure Bugzilla to regularly annoy 
+        them at regular intervals, by having Bugzilla execute saved searches
+        at certain times and emailing the results to the user.  This is known
+        as "Whining".  The process of configuring Whining is described 
+        in <a class="xref" href="#whining" title="5.13. Whining">Section 5.13, “Whining”</a>, but for it to work a Perl script must be
+        executed at regular intervals.
+      </p><p>
+        This can be done by adding the following command as a daily
+        crontab entry, in the same manner as explained above for bug
+        graphs. This example runs it every 15 minutes. 
+      </p><pre class="programlisting">*/15 * * * * cd &lt;your-bugzilla-directory&gt; &amp;&amp; ./whine.pl</pre><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Whines can be executed as often as every 15 minutes, so if you specify
+          longer intervals between executions of whine.pl, some users may not 
+          be whined at as often as they would expect.  Depending on the person,
+          this can either be a very Good Thing or a very Bad Thing.
+        </p></td></tr></table></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Windows does not have 'cron', but it does have the Task
+          Scheduler, which performs the same duties. There are also
+          third-party tools that can be used to implement cron, such as
+          <a class="ulink" href="http://www.nncron.ru/" target="_top">nncron</a>.
+        </p></td></tr></table></div></div><div class="section" title="2.3.4. Serving Alternate Formats with the right MIME type"><div class="titlepage"><div><div><h3 class="title"><a name="apache-addtype"></a>2.3.4. Serving Alternate Formats with the right MIME type</h3></div></div></div><p>
+        Some Bugzilla pages have alternate formats, other than just plain
+        <acronym class="acronym">HTML</acronym>. In particular, a few Bugzilla pages can 
+        output their contents as either <acronym class="acronym">XUL</acronym> (a special 
+        Mozilla format, that looks like a program <acronym class="acronym">GUI</acronym>) 
+        or <acronym class="acronym">RDF</acronym> (a type of structured <acronym class="acronym">XML</acronym> 
+        that can be read by various programs).
+      </p><p>
+        In order for your users to see these pages correctly, Apache must 
+        send them with the right <acronym class="acronym">MIME</acronym> type. To do this, 
+        add the following lines to your Apache configuration, either in the 
+        <code class="computeroutput">&lt;VirtualHost&gt;</code> section for your
+        Bugzilla, or in the <code class="computeroutput">&lt;Directory&gt;</code>
+        section for your Bugzilla:
+      </p><p>
+        </p><pre class="screen">AddType application/vnd.mozilla.xul+xml .xul
+AddType application/rdf+xml .rdf</pre><p>
+      </p></div></div><div class="section" title="2.4. Multiple Bugzilla databases with a single installation"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="multiple-bz-dbs"></a>2.4. Multiple Bugzilla databases with a single installation</h2></div></div></div><p>The previous instructions referred to a standard installation, with
+      one unique Bugzilla database. However, you may want to host several
+      distinct installations, without having several copies of the code. This is
+      possible by using the PROJECT environment variable. When accessed,
+      Bugzilla checks for the existence of this variable, and if present, uses
+      its value to check for an alternative configuration file named
+      <code class="filename">localconfig.&lt;PROJECT&gt;</code> in the same location as
+      the default one (<code class="filename">localconfig</code>). It also checks for
+      customized templates in a directory named
+      <code class="filename">&lt;PROJECT&gt;</code> in the same location as the
+      default one (<code class="filename">template/&lt;langcode&gt;</code>). By default
+      this is <code class="filename">template/en/default</code> so PROJECT's templates
+      would be located at <code class="filename">template/en/PROJECT</code>.</p><p>To set up an alternate installation, just export PROJECT=foo before
+      running <span class="command"><strong>checksetup.pl</strong></span> for the first time. It will
+      result in a file called <code class="filename">localconfig.foo</code> instead of
+      <code class="filename">localconfig</code>. Edit this file as described above, with
+      reference to a new database, and re-run <span class="command"><strong>checksetup.pl</strong></span>
+      to populate it. That's all.</p><p>Now you have to configure the web server to pass this environment
+      variable when accessed via an alternate URL, such as virtual host for
+      instance. The following is an example of how you could do it in Apache,
+      other Webservers may differ.
+</p><pre class="programlisting">
+&lt;VirtualHost 212.85.153.228:80&gt;
+    ServerName foo.bar.baz
+    SetEnv PROJECT foo
+    Alias /bugzilla /var/www/bugzilla
+&lt;/VirtualHost&gt;
+</pre><p>
+    </p><p>Don't forget to also export this variable before accessing Bugzilla
+       by other means, such as cron tasks for instance.</p></div><div class="section" title="2.5. OS-Specific Installation Notes"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="os-specific"></a>2.5. OS-Specific Installation Notes</h2></div></div></div><p>Many aspects of the Bugzilla installation can be affected by the
+    operating system you choose to install it on. Sometimes it can be made
+    easier and others more difficult. This section will attempt to help you
+    understand both the difficulties of running on specific operating systems
+    and the utilities available to make it easier.
+    </p><p>If you have anything to add or notes for an operating system not covered,
+    please file a bug in <a class="ulink" href="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla;component=Documentation" target="_top">Bugzilla Documentation</a>.
+    </p><div class="section" title="2.5.1. Microsoft Windows"><div class="titlepage"><div><div><h3 class="title"><a name="os-win32"></a>2.5.1. Microsoft Windows</h3></div></div></div><p>
+        Making Bugzilla work on Windows is more difficult than making it
+        work on Unix.  For that reason, we still recommend doing so on a Unix 
+        based system such as GNU/Linux.  That said, if you do want to get
+        Bugzilla running on Windows, you will need to make the following
+        adjustments. A detailed step-by-step
+        <a class="ulink" href="https://wiki.mozilla.org/Bugzilla:Win32Install" target="_top">
+        installation guide for Windows</a> is also available
+        if you need more help with your installation.
+      </p><div class="section" title="2.5.1.1. Win32 Perl"><div class="titlepage"><div><div><h4 class="title"><a name="win32-perl"></a>2.5.1.1. Win32 Perl</h4></div></div></div><p>
+          Perl for Windows can be obtained from 
+          <a class="ulink" href="http://www.activestate.com/" target="_top">ActiveState</a>.
+           You should be able to find a compiled binary at <a class="ulink" href="http://aspn.activestate.com/ASPN/Downloads/ActivePerl/" target="_top">http://aspn.activestate.com/ASPN/Downloads/ActivePerl/</a>.
+           The following instructions assume that you are using version
+           5.8.1 of ActiveState.
+          </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+             These instructions are for 32-bit versions of Windows. If you are
+             using a 64-bit version of Windows, you will need to install 32-bit
+             Perl in order to install the 32-bit modules as described below.
+            </p></td></tr></table></div></div><div class="section" title="2.5.1.2. Perl Modules on Win32"><div class="titlepage"><div><div><h4 class="title"><a name="win32-perl-modules"></a>2.5.1.2. Perl Modules on Win32</h4></div></div></div><p>
+          Bugzilla on Windows requires the same perl modules found in
+          <a class="xref" href="#install-perlmodules" title="2.1.5. Perl Modules">Section 2.1.5, “Perl Modules”</a>. The main difference is that
+          windows uses <a class="glossterm" href="#gloss-ppm"><em class="glossterm">PPM</em></a> instead
+          of CPAN. ActiveState provides a GUI to manage Perl modules. We highly
+          recommend that you use it. If you prefer to use ppm from the
+          command-line, type:
+        </p><pre class="programlisting">
+C:\perl&gt; <span class="command"><strong>ppm install &lt;module name&gt;</strong></span>
+        </pre><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            The PPM repository stores modules in 'packages' that may have
+            a slightly different name than the module.  If retrieving these
+            modules from there, you will need to pay attention to the information
+            provided when you run <span class="command"><strong>checksetup.pl</strong></span> as it will
+            tell you what package you'll need to install.
+          </p></td></tr></table></div><div class="tip" title="Tip" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../images/tip.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            If you are behind a corporate firewall, you will need to let the
+            ActiveState PPM utility know how to get through it to access
+            the repositories by setting the HTTP_proxy system environmental
+            variable. For more information on setting that variable, see
+            the ActiveState documentation.
+          </p></td></tr></table></div></div><div class="section" title="2.5.1.3. Serving the web pages"><div class="titlepage"><div><div><h4 class="title"><a name="win32-http"></a>2.5.1.3. Serving the web pages</h4></div></div></div><p>
+          As is the case on Unix based systems, any web server should
+          be able to handle Bugzilla; however, the Bugzilla Team still
+          recommends Apache whenever asked. No matter what web server
+          you choose, be sure to pay attention to the security notes
+          in <a class="xref" href="#security-webserver-access" title="4.2.1. Disabling Remote Access to Bugzilla Configuration Files">Section 4.2.1, “Disabling Remote Access to Bugzilla Configuration Files”</a>. More
+          information on configuring specific web servers can be found
+          in <a class="xref" href="#http" title="2.2.4. Web server">Section 2.2.4, “Web server”</a>.
+        </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            The web server looks at <code class="filename">/usr/bin/perl</code> to
+            call Perl. If you are using Apache on windows, you can set the
+            <a class="ulink" href="http://httpd.apache.org/docs-2.0/mod/core.html#scriptinterpretersource" target="_top">ScriptInterpreterSource</a>
+            directive in your Apache config file to make it look at the
+            right place: insert the line
+            </p><pre class="programlisting">ScriptInterpreterSource Registry-Strict</pre><p>
+            into your <code class="filename">httpd.conf</code> file, and create the key
+            </p><pre class="programlisting">HKEY_CLASSES_ROOT\.cgi\Shell\ExecCGI\Command</pre><p>
+            with <code class="option">C:\Perl\bin\perl.exe -T</code> as value (adapt to your
+            path if needed) in the registry. When this is done, restart Apache.
+          </p></td></tr></table></div></div><div class="section" title="2.5.1.4. Sending Email"><div class="titlepage"><div><div><h4 class="title"><a name="win32-email"></a>2.5.1.4. Sending Email</h4></div></div></div><p>
+          To enable Bugzilla to send email on Windows, the server running the
+          Bugzilla code must be able to connect to, or act as, an SMTP server.
+        </p></div></div><div class="section" title="2.5.2. Mac OS X™"><div class="titlepage"><div><div><h3 class="title"><a name="os-macosx"></a>2.5.2. <span class="productname">Mac OS X</span>™</h3></div></div></div><p>Making Bugzilla work on Mac OS X requires the following 
+      adjustments.</p><div class="section" title="2.5.2.1. Sendmail"><div class="titlepage"><div><div><h4 class="title"><a name="macosx-sendmail"></a>2.5.2.1. Sendmail</h4></div></div></div><p>In Mac OS X 10.3 and later, 
+        <a class="ulink" href="http://www.postfix.org/" target="_top">Postfix</a> 
+        is used as the built-in email server.  Postfix provides an executable
+        that mimics sendmail enough to fool Bugzilla, as long as Bugzilla can 
+        find it. Bugzilla is able to find the fake sendmail executable without
+        any assistance.</p></div><div class="section" title="2.5.2.2. Libraries &amp; Perl Modules on Mac OS X"><div class="titlepage"><div><div><h4 class="title"><a name="macosx-libraries"></a>2.5.2.2. Libraries &amp; Perl Modules on Mac OS X</h4></div></div></div><p>Apple does not include the GD library with Mac OS X. Bugzilla
+        needs this for bug graphs.</p><p>You can use MacPorts (<a class="ulink" href="http://www.macports.org/" target="_top">http://www.macports.org/</a>)
+        or Fink (<a class="ulink" href="http://sourceforge.net/projects/fink/" target="_top">http://sourceforge.net/projects/fink/</a>), both
+        of which are similar in nature to the CPAN installer, but install
+        common unix programs.</p><p>Follow the instructions for setting up MacPorts or Fink.
+        Once you have one installed, you'll want to use it to install the
+        <code class="filename">gd2</code> package.
+        </p><p>Fink will prompt you for a number of dependencies, type 'y' and hit
+        enter to install all of the dependencies and then watch it work. You will
+        then be able to use <a class="glossterm" href="#gloss-cpan"><em class="glossterm">CPAN</em></a> to
+        install the GD Perl module.
+        </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>To prevent creating conflicts with the software that Apple
+          installs by default, Fink creates its own directory tree at 
+          <code class="filename">/sw</code> where it installs most of
+          the software that it installs. This means your libraries and headers
+          will be at <code class="filename">/sw/lib</code> and
+          <code class="filename">/sw/include</code> instead of
+          <code class="filename">/usr/lib</code> and
+          <code class="filename">/usr/include</code>. When the
+          Perl module config script asks where your <code class="filename">libgd</code>
+          is, be sure to tell it
+          <code class="filename">/sw/lib</code>.
+          </p></td></tr></table></div><p>Also available via MacPorts and Fink is
+        <code class="filename">expat</code>. After installing the expat package, you
+        will be able to install XML::Parser using CPAN. If you use fink, there
+        is one caveat. Unlike recent versions of
+        the GD module, XML::Parser doesn't prompt for the location of the
+        required libraries. When using CPAN, you will need to use the following
+        command sequence:
+        </p><pre class="screen">
+# perl -MCPAN -e'look XML::Parser'
+# perl Makefile.PL EXPATLIBPATH=/sw/lib EXPATINCPATH=/sw/include
+# make; make test; make install
+# exit
+        </pre><p>
+          The <span class="command"><strong>look</strong></span> command will download the module and spawn
+          a new shell with the extracted files as the current working directory.
+        </p><p>
+          You should watch the output from these <span class="command"><strong>make</strong></span> commands,
+          especially <span class="quote">“<span class="quote">make test</span>”</span> as errors may prevent
+          XML::Parser from functioning correctly with Bugzilla.
+        </p><p>
+          The <span class="command"><strong>exit</strong></span> command will return you to your original shell.
+        </p></div></div><div class="section" title="2.5.3. Linux Distributions"><div class="titlepage"><div><div><h3 class="title"><a name="os-linux"></a>2.5.3. Linux Distributions</h3></div></div></div><p>Many Linux distributions include Bugzilla and its 
+            dependencies in their native package management systems. 
+            Installing Bugzilla with root access on any Linux system 
+            should be as simple as finding the Bugzilla package in the 
+            package management application and installing it using the 
+            normal command syntax. Several distributions also perform 
+            the proper web server configuration automatically on installation.
+            </p><p>Please consult the documentation of your Linux 
+            distribution for instructions on how to install packages, 
+            or for specific instructions on installing Bugzilla with 
+            native package management tools. There is also a 
+            <a class="ulink" href="http://wiki.mozilla.org/Bugzilla:Linux_Distro_Installation" target="_top">
+            Bugzilla Wiki Page</a> for distro-specific installation
+            notes.
+            </p></div></div><div class="section" title="2.6. UNIX (non-root) Installation Notes"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="nonroot"></a>2.6. UNIX (non-root) Installation Notes</h2></div></div></div><div class="section" title="2.6.1. Introduction"><div class="titlepage"><div><div><h3 class="title"><a name="idp12489024"></a>2.6.1. Introduction</h3></div></div></div><p>If you are running a *NIX OS as non-root, either due
+      to lack of access (web hosts, for example) or for security
+      reasons, this will detail how to install Bugzilla on such
+      a setup. It is recommended that you read through the
+      <a class="xref" href="#installation" title="2.1. Installation">Section 2.1, “Installation”</a>
+      first to get an idea on the installation steps required.
+      (These notes will reference to steps in that guide.)</p></div><div class="section" title="2.6.2. MySQL"><div class="titlepage"><div><div><h3 class="title"><a name="idp12491264"></a>2.6.2. MySQL</h3></div></div></div><p>You may have MySQL installed as root. If you're
+      setting up an account with a web host, a MySQL account
+      needs to be set up for you. From there, you can create
+      the bugs account, or use the account given to you.</p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>You may have problems trying to set up
+        <span class="command"><strong>GRANT</strong></span> permissions to the database.
+        If you're using a web host, chances are that you have a
+        separate database which is already locked down (or one big
+        database with limited/no access to the other areas), but you
+        may want to ask your system administrator what the security
+        settings are set to, and/or run the <span class="command"><strong>GRANT</strong></span>
+        command for you.</p><p>Also, you will probably not be able to change the MySQL
+        root user password (for obvious reasons), so skip that
+        step.</p></td></tr></table></div><div class="section" title="2.6.2.1. Running MySQL as Non-Root"><div class="titlepage"><div><div><h4 class="title"><a name="idp12495856"></a>2.6.2.1. Running MySQL as Non-Root</h4></div></div></div><div class="section" title="2.6.2.1.1. The Custom Configuration Method"><div class="titlepage"><div><div><h5 class="title"><a name="idp12496608"></a>2.6.2.1.1. The Custom Configuration Method</h5></div></div></div><p>Create a file .my.cnf in your 
+              home directory (using /home/foo in this example)
+              as follows....</p><pre class="programlisting">
+[mysqld]
+datadir=/home/foo/mymysql
+socket=/home/foo/mymysql/thesock
+port=8081
+
+[mysql]
+socket=/home/foo/mymysql/thesock
+port=8081
+
+[mysql.server]
+user=mysql
+basedir=/var/lib
+
+[safe_mysqld]
+err-log=/home/foo/mymysql/the.log
+pid-file=/home/foo/mymysql/the.pid
+              </pre></div><div class="section" title="2.6.2.1.2. The Custom Built Method"><div class="titlepage"><div><div><h5 class="title"><a name="idp12499056"></a>2.6.2.1.2. The Custom Built Method</h5></div></div></div><p>You can install MySQL as a not-root, if you really need to.
+            Build it with PREFIX set to <code class="filename">/home/foo/mysql</code>,
+            or use pre-installed executables, specifying that you want
+            to put all of the data files in <code class="filename">/home/foo/mysql/data</code>.
+            If there is another MySQL server running on the system that you
+            do not own, use the -P option to specify a TCP port that is not
+            in use.</p></div><div class="section" title="2.6.2.1.3. Starting the Server"><div class="titlepage"><div><div><h5 class="title"><a name="idp12502720"></a>2.6.2.1.3. Starting the Server</h5></div></div></div><p>After your mysqld program is built and any .my.cnf file is 
+            in place, you must initialize the databases (ONCE).</p><pre class="screen">
+<code class="prompt">bash$</code> <span class="command"><strong>mysql_install_db</strong></span>
+            </pre><p>Then start the daemon with</p><pre class="screen">
+<code class="prompt">bash$</code> <span class="command"><strong>safe_mysql &amp;</strong></span>
+            </pre><p>After you start mysqld the first time, you then connect to
+            it as "root" and <span class="command"><strong>GRANT</strong></span> permissions to other
+            users. (Again, the MySQL root account has nothing to do with
+            the *NIX root account.)</p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>You will need to start the daemons yourself. You can either
+              ask your system administrator to add them to system startup files, or
+              add a crontab entry that runs a script to check on these daemons
+              and restart them if needed.</p></td></tr></table></div><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Do NOT run daemons or other services on a server without first
+              consulting your system administrator! Daemons use up system resources
+              and running one may be in violation of your terms of service for any
+              machine on which you are a user!</p></td></tr></table></div></div></div></div><div class="section" title="2.6.3. Perl"><div class="titlepage"><div><div><h3 class="title"><a name="idp12512944"></a>2.6.3. Perl</h3></div></div></div><p>
+      On the extremely rare chance that you don't have Perl on
+      the machine, you will have to build the sources
+      yourself. The following commands should get your system
+      installed with your own personal version of Perl:
+      </p><pre class="screen">
+<code class="prompt">bash$</code> <span class="command"><strong>wget http://perl.org/CPAN/src/stable.tar.gz</strong></span>
+<code class="prompt">bash$</code> <span class="command"><strong>tar zvxf stable.tar.gz</strong></span>
+<code class="prompt">bash$</code> <span class="command"><strong>cd perl-5.8.1</strong></span>
+<code class="prompt">bash$</code> <span class="command"><strong>sh Configure -de -Dprefix=/home/foo/perl</strong></span>
+<code class="prompt">bash$</code> <span class="command"><strong>make &amp;&amp; make test &amp;&amp; make install</strong></span>
+      </pre><p>
+      Once you have Perl installed into a directory (probably
+      in <code class="filename">~/perl/bin</code>), you will need to
+      install the Perl Modules, described below.
+      </p></div><div class="section" title="2.6.4. Perl Modules"><div class="titlepage"><div><div><h3 class="title"><a name="install-perlmodules-nonroot"></a>2.6.4. Perl Modules</h3></div></div></div><p>
+      Installing the Perl modules as a non-root user is accomplished by
+      running the <code class="filename">install-module.pl</code>
+      script. For more details on this script, see 
+      <a class="ulink" href="../html/api/install-module.html" target="_top"><code class="filename">install-module.pl</code>
+      documentation</a>
+      </p></div><div class="section" title="2.6.5. HTTP Server"><div class="titlepage"><div><div><h3 class="title"><a name="idp12527776"></a>2.6.5. HTTP Server</h3></div></div></div><p>Ideally, this also needs to be installed as root and
+      run under a special web server account. As long as
+      the web server will allow the running of *.cgi files outside of a
+      cgi-bin, and a way of denying web access to certain files (such as a
+      .htaccess file), you should be good in this department.</p><div class="section" title="2.6.5.1. Running Apache as Non-Root"><div class="titlepage"><div><div><h4 class="title"><a name="idp12529264"></a>2.6.5.1. Running Apache as Non-Root</h4></div></div></div><p>You can run Apache as a non-root user, but the port will need
+        to be set to one above 1024. If you type <span class="command"><strong>httpd -V</strong></span>,
+        you will get a list of the variables that your system copy of httpd
+        uses. One of those, namely HTTPD_ROOT, tells you where that
+        installation looks for its config information.</p><p>From there, you can copy the config files to your own home
+        directory to start editing. When you edit those and then use the -d
+        option to override the HTTPD_ROOT compiled into the web server, you
+        get control of your own customized web server.</p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>You will need to start the daemons yourself. You can either
+          ask your system administrator to add them to system startup files, or
+          add a crontab entry that runs a script to check on these daemons
+          and restart them if needed.</p></td></tr></table></div><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Do NOT run daemons or other services on a server without first
+          consulting your system administrator! Daemons use up system resources
+          and running one may be in violation of your terms of service for any
+          machine on which you are a user!</p></td></tr></table></div></div></div><div class="section" title="2.6.6. Bugzilla"><div class="titlepage"><div><div><h3 class="title"><a name="idp12534784"></a>2.6.6. Bugzilla</h3></div></div></div><p>
+      When you run <span class="command"><strong>./checksetup.pl</strong></span> to create
+      the <code class="filename">localconfig</code> file, it will list the Perl
+      modules it finds. If one is missing, go back and double-check the
+      module installation from <a class="xref" href="#install-perlmodules-nonroot" title="2.6.4. Perl Modules">Section 2.6.4, “Perl Modules”</a>, 
+      then delete the <code class="filename">localconfig</code> file and try again.
+      </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>One option in <code class="filename">localconfig</code> you
+        might have problems with is the web server group. If you can't
+        successfully browse to the <code class="filename">index.cgi</code> (like
+        a Forbidden error), you may have to relax your permissions,
+        and blank out the web server group. Of course, this may pose
+        as a security risk. Having a properly jailed shell and/or
+        limited access to shell accounts may lessen the security risk,
+        but use at your own risk.</p></td></tr></table></div><div class="section" title="2.6.6.1. suexec or shared hosting"><div class="titlepage"><div><div><h4 class="title"><a name="suexec"></a>2.6.6.1. suexec or shared hosting</h4></div></div></div><p>If you are running on a system that uses suexec (most shared
+        hosting environments do this), you will need to set the
+        <span class="emphasis"><em>webservergroup</em></span> value in <code class="filename">localconfig</code>
+        to match <span class="emphasis"><em>your</em></span> primary group, rather than the one
+        the web server runs under.  You will need to run the following
+        shell commands after running <span class="command"><strong>./checksetup.pl</strong></span>,
+        every time you run it (or modify <code class="filename">checksetup.pl</code>
+        to do them for you via the system() command).
+        </p><pre class="programlisting">
+for i in docs graphs images js skins; do find $i -type d -exec chmod o+rx {} \; ; done
+for i in jpg gif css js png html rdf xul; do find . -name \*.$i -exec chmod o+r {} \; ; done
+find . -name .htaccess -exec chmod o+r {} \;
+chmod o+x . data data/webdot
+        </pre><p>
+        Pay particular attention to the number of semicolons and dots.
+        They are all important.  A future version of Bugzilla will
+        hopefully be able to do this for you out of the box.</p></div></div></div><div class="section" title="2.7. Upgrading to New Releases"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="upgrade"></a>2.7. Upgrading to New Releases</h2></div></div></div><p>Upgrading to new Bugzilla releases is very simple. There is
+      a script named <code class="filename">checksetup.pl</code> included with
+      Bugzilla that will automatically do all of the database migration
+      for you.</p><p>The following sections explain how to upgrade from one
+      version of Bugzilla to another. Whether you are upgrading
+      from one bug-fix version to another (such as 4.2 to 4.2.1)
+      or from one major version to another (such as from 4.0 to 4.2),
+      the instructions are always the same.</p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        Any examples in the following sections are written as though the
+        user were updating to version 4.2.1, but the procedures are the
+        same no matter what version you're updating to. Also, in the
+        examples, the user's Bugzilla installation is found at
+        <code class="filename">/var/www/html/bugzilla</code>. If that is not the
+        same as the location of your Bugzilla installation, simply
+        substitute the proper paths where appropriate.
+      </p></td></tr></table></div><div class="section" title="2.7.1. Before You Upgrade"><div class="titlepage"><div><div><h3 class="title"><a name="upgrade-before"></a>2.7.1. Before You Upgrade</h3></div></div></div><p>Before you start your upgrade, there are a few important
+        steps to take:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+            Read the <a class="ulink" href="http://www.bugzilla.org/releases/" target="_top">Release
+            Notes</a> of the version you're upgrading to,
+            particularly the "Notes for Upgraders" section.
+          </p></li><li class="listitem"><p>
+            View the Sanity Check (<a class="xref" href="#sanitycheck" title="3.16. Checking and Maintaining Database Integrity">Section 3.16, “Checking and Maintaining Database Integrity”</a>) page
+            on your installation before upgrading. Attempt to fix all warnings
+            that the page produces before you go any further, or you may
+            experience problems  during your upgrade.
+          </p></li><li class="listitem"><p>
+            Shut down your Bugzilla installation by putting some HTML or
+            text in the shutdownhtml parameter
+            (see <a class="xref" href="#parameters" title="3.1. Bugzilla Configuration">Section 3.1, “Bugzilla Configuration”</a>).
+          </p></li><li class="listitem"><p>
+            Make a backup of the Bugzilla database.
+            <span class="emphasis"><em>THIS IS VERY IMPORTANT</em></span>. If
+            anything goes wrong during the upgrade, your installation
+            can be corrupted beyond recovery. Having a backup keeps you safe.
+          </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+              Upgrading is a one-way process. You cannot "downgrade" an
+              upgraded Bugzilla. If you wish to revert to the old Bugzilla
+              version for any reason, you will have to restore your database
+              from this backup.
+            </p></td></tr></table></div><p>Here are some sample commands you could use to backup
+            your database, depending on what database system you're
+            using. You may have to modify these commands for your
+            particular setup.</p><div class="variablelist"><dl><dt><span class="term">MySQL:</span></dt><dd><p>
+                  <span class="command"><strong>mysqldump --opt -u bugs -p bugs &gt; bugs.sql</strong></span>
+                </p></dd><dt><span class="term">PostgreSQL:</span></dt><dd><p>
+                  <span class="command"><strong>pg_dump --no-privileges --no-owner -h localhost -U bugs
+                    &gt; bugs.sql</strong></span>
+                </p></dd></dl></div></li></ol></div></div><div class="section" title="2.7.2. Getting The New Bugzilla"><div class="titlepage"><div><div><h3 class="title"><a name="upgrade-files"></a>2.7.2. Getting The New Bugzilla</h3></div></div></div><p>There are three ways to get the new version of Bugzilla.
+        We'll list them here briefly and then explain them
+        more later.</p><div class="variablelist"><dl><dt><span class="term">Bzr (<a class="xref" href="#upgrade-bzr" title="2.7.2.2. Upgrading using Bzr">Section 2.7.2.2, “Upgrading using Bzr”</a>)</span></dt><dd><p>
+              If you have <span class="command"><strong>bzr</strong></span> installed on your machine
+              and you have Internet access, this is the easiest way to
+              upgrade, particularly if you have made modifications
+              to the code or templates of Bugzilla.
+            </p></dd><dt><span class="term">Download the tarball (<a class="xref" href="#upgrade-tarball" title="2.7.2.3. Upgrading using the tarball">Section 2.7.2.3, “Upgrading using the tarball”</a>)</span></dt><dd><p>
+              This is a very simple way to upgrade, and good if you
+              haven't made many (or any) modifications to the code or
+              templates of your Bugzilla.
+            </p></dd><dt><span class="term">Patches (<a class="xref" href="#upgrade-patches" title="2.7.2.4. Upgrading using patches">Section 2.7.2.4, “Upgrading using patches”</a>)</span></dt><dd><p>
+              If you have made modifications to your Bugzilla, and
+              you don't have Internet access or you don't want to use
+              bzr, then this is the best way to upgrade.
+            </p><p>
+              You can only do minor upgrades (such as 4.2 to 4.2.1 or
+              4.2.1 to 4.2.2) with patches.
+            </p></dd></dl></div><div class="section" title="2.7.2.1. If you have modified your Bugzilla"><div class="titlepage"><div><div><h4 class="title"><a name="upgrade-modified"></a>2.7.2.1. If you have modified your Bugzilla</h4></div></div></div><p>
+          If you have modified the code or templates of your Bugzilla,
+          then upgrading requires a bit more thought and effort.
+          A discussion of the various methods of updating compared with
+          degree and methods of local customization can be found in
+          <a class="xref" href="#template-method" title="6.3.2. Choosing a Customization Method">Section 6.3.2, “Choosing a Customization Method”</a>.
+        </p><p>
+          The larger the jump you are trying to make, the more difficult it
+          is going to be to upgrade if you have made local customizations.
+          Upgrading from 4.2 to 4.2.1 should be fairly painless even if
+          you are heavily customized, but going from 2.18 to 4.2 is going
+          to mean a fair bit of work re-writing your local changes to use
+          the new files, logic, templates, etc. If you have done no local
+          changes at all, however, then upgrading should be approximately
+          the same amount of work regardless of how long it has been since
+          your version was released.
+        </p></div><div class="section" title="2.7.2.2. Upgrading using Bzr"><div class="titlepage"><div><div><h4 class="title"><a name="upgrade-bzr"></a>2.7.2.2. Upgrading using Bzr</h4></div></div></div><p>
+          This requires that you have bzr installed (most Unix machines do),
+          and requires that you are able to access
+          <a class="ulink" href="http://bzr.mozilla.org/bugzilla/" target="_top">bzr.mozilla.org</a>,
+          which may not be an option if you don't have Internet access.
+        </p><p>
+          The following shows the sequence of commands needed to update a
+          Bugzilla installation via Bzr, and a typical series of results.
+          These commands assume that you already have Bugzilla installed
+          using Bzr.
+        </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            If your installation is still using CVS, you must first convert
+            it to Bzr. A very detailed step by step documentation can be
+            found on <a class="ulink" href="https://wiki.mozilla.org/Bugzilla:Moving_From_CVS_To_Bazaar" target="_top">wiki.mozilla.org</a>.
+          </p></td></tr></table></div><pre class="programlisting">
+bash$ <span class="command"><strong>cd /var/www/html/bugzilla</strong></span>
+bash$ <span class="command"><strong>bzr switch 4.2</strong></span> (only run this command when not yet running 4.2)
+bash$ <span class="command"><strong>bzr up -r tag:bugzilla-4.2.1</strong></span>
++N  extensions/MoreBugUrl/
++N  extensions/MoreBugUrl/Config.pm
++N  extensions/MoreBugUrl/Extension.pm
+...
+ M  Bugzilla/Attachment.pm
+ M  Bugzilla/Attachment/PatchReader.pm
+ M  Bugzilla/Bug.pm
+...
+All changes applied successfully.
+        </pre><div class="caution" title="Caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            If a line in the output from <span class="command"><strong>bzr up</strong></span> mentions
+            a conflict, then that represents a file with local changes that
+            Bzr was unable to properly merge. You need to resolve these
+            conflicts manually before Bugzilla (or at least the portion using
+            that file) will be usable.
+          </p></td></tr></table></div></div><div class="section" title="2.7.2.3. Upgrading using the tarball"><div class="titlepage"><div><div><h4 class="title"><a name="upgrade-tarball"></a>2.7.2.3. Upgrading using the tarball</h4></div></div></div><p>
+          If you are unable (or unwilling) to use Bzr, another option that's
+          always available is to obtain the latest tarball from the <a class="ulink" href="http://www.bugzilla.org/download/" target="_top">Download Page</a> and 
+          create a new Bugzilla installation from that.
+        </p><p>
+          This sequence of commands shows how to get the tarball from the
+          command-line; it is also possible to download it from the site
+          directly in a web browser. If you go that route, save the file
+          to the <code class="filename">/var/www/html</code>
+          directory (or its equivalent, if you use something else) and 
+          omit the first three lines of the example.
+        </p><pre class="programlisting">
+bash$ <span class="command"><strong>cd /var/www/html</strong></span>
+bash$ <span class="command"><strong>wget http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-4.2.1.tar.gz</strong></span>
+<span class="emphasis"><em>(Output omitted)</em></span>
+bash$ <span class="command"><strong>tar xzvf bugzilla-4.2.1.tar.gz</strong></span>
+bugzilla-4.2.1/
+bugzilla-4.2.1/colchange.cgi
+<span class="emphasis"><em>(Output truncated)</em></span>
+bash$ <span class="command"><strong>cd bugzilla-4.2.1</strong></span>
+bash$ <span class="command"><strong>cp ../bugzilla/localconfig* .</strong></span>
+bash$ <span class="command"><strong>cp -r ../bugzilla/data .</strong></span>
+bash$ <span class="command"><strong>cd ..</strong></span>
+bash$ <span class="command"><strong>mv bugzilla bugzilla.old</strong></span>
+bash$ <span class="command"><strong>mv bugzilla-4.2.1 bugzilla</strong></span>
+        </pre><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            The <span class="command"><strong>cp</strong></span> commands both end with periods which
+            is a very important detail--it means that the destination
+            directory is the current working directory.
+          </p></td></tr></table></div><div class="caution" title="Caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            If you have some extensions installed, you will have to copy them
+            to the new bugzilla directory too. Extensions are located in
+            <code class="filename">bugzilla/extensions/</code>. Only copy those you
+            installed, not those managed by the Bugzilla team.
+          </p></td></tr></table></div><p>
+          This upgrade method will give you a clean install of Bugzilla.
+          That's fine if you don't have any local customizations that you
+          want to maintain. If you do have customizations, then you will 
+          need to reapply them by hand to the appropriate files.
+        </p></div><div class="section" title="2.7.2.4. Upgrading using patches"><div class="titlepage"><div><div><h4 class="title"><a name="upgrade-patches"></a>2.7.2.4. Upgrading using patches</h4></div></div></div><p>
+          A patch is a collection of all the bug fixes that have been made
+          since the last bug-fix release.
+        </p><p>
+          If you are doing a bug-fix upgrade—that is, one where only the 
+          last number of the revision changes, such as from 4.2 to
+          4.2.1—then you have the option of obtaining and applying a
+          patch file from the <a class="ulink" href="http://www.bugzilla.org/download/" target="_top">Download Page</a>.
+        </p><p>
+          As above, this example starts with obtaining the file via the 
+          command line. If you have already downloaded it, you can omit the
+          first two commands.
+        </p><pre class="programlisting">
+bash$ <span class="command"><strong>cd /var/www/html/bugzilla</strong></span>
+bash$ <span class="command"><strong>wget http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-4.2-to-4.2.1.diff.gz</strong></span>
+<span class="emphasis"><em>(Output omitted)</em></span>
+bash$ <span class="command"><strong>gunzip bugzilla-4.2-to-4.2.1.diff.gz</strong></span>
+bash$ <span class="command"><strong>patch -p1 &lt; bugzilla-4.2-to-4.2.1.diff</strong></span>
+patching file Bugzilla/Constants.pm
+patching file enter_bug.cgi
+<span class="emphasis"><em>(etc.)</em></span>
+        </pre><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            Be aware that upgrading from a patch file does not change the
+            entries in your <code class="filename">.bzr</code> directory.
+            This could make it more difficult to upgrade using Bzr
+            (<a class="xref" href="#upgrade-bzr" title="2.7.2.2. Upgrading using Bzr">Section 2.7.2.2, “Upgrading using Bzr”</a>) in the future.
+          </p></td></tr></table></div></div></div><div class="section" title="2.7.3. Completing Your Upgrade"><div class="titlepage"><div><div><h3 class="title"><a name="upgrade-completion"></a>2.7.3. Completing Your Upgrade</h3></div></div></div><p>
+        Now that you have the new Bugzilla code, there are a few final
+        steps to complete your upgrade.
+      </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+            If your new Bugzilla installation is in a different
+            directory or on a different machine than your old Bugzilla
+            installation, make sure that you have copied the
+            <code class="filename">data</code> directory and the
+            <code class="filename">localconfig</code> file from your old Bugzilla
+            installation. (If you followed the tarball instructions
+            above, this has already happened.)
+          </p></li><li class="listitem"><p>
+            If this is a major update, check that the configuration
+            (<a class="xref" href="#configuration" title="2.2. Configuration">Section 2.2, “Configuration”</a>) for your new Bugzilla is
+            up-to-date. Sometimes the configuration requirements change
+            between major versions.
+          </p></li><li class="listitem"><p>
+            If you didn't do it as part of the above configuration step,
+            now you need to run <span class="command"><strong>checksetup.pl</strong></span>, which
+            will do everything required to convert your existing database
+            and settings for the new version:
+          </p><pre class="programlisting">
+bash$ <span class="command"><strong>cd /var/www/html/bugzilla</strong></span>
+bash$ <span class="command"><strong>./checksetup.pl</strong></span>
+          </pre><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+              The period at the beginning of the command
+              <span class="command"><strong>./checksetup.pl</strong></span> is important and cannot
+              be omitted.
+            </p></td></tr></table></div><div class="caution" title="Caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+              If this is a major upgrade (say, 3.6 to 4.2 or similar),
+              running <span class="command"><strong>checksetup.pl</strong></span> on a large
+              installation (75,000 or more bugs) can take a long time,
+              possibly several hours.
+            </p></td></tr></table></div></li><li class="listitem"><p>
+            Clear any HTML or text that you put into the shutdownhtml
+            parameter, to re-activate Bugzilla.
+          </p></li><li class="listitem"><p>
+            View the Sanity Check (<a class="xref" href="#sanitycheck" title="3.16. Checking and Maintaining Database Integrity">Section 3.16, “Checking and Maintaining Database Integrity”</a>) page in your
+            upgraded Bugzilla.
+          </p><p>
+            It is recommended that, if possible, you fix any problems
+            you see, immediately. Failure to do this may mean that Bugzilla
+            will not work correctly. Be aware that if the sanity check page
+            contains more errors after an upgrade, it doesn't necessarily
+            mean there are more errors in your database than there were
+            before, as additional tests are added to the sanity check over
+            time, and it is possible that those errors weren't being
+            checked for in the old version.
+          </p></li></ol></div></div><div class="section" title="2.7.4. Automatic Notifications of New Releases"><div class="titlepage"><div><div><h3 class="title"><a name="upgrade-notifications"></a>2.7.4. Automatic Notifications of New Releases</h3></div></div></div><p>
+        Bugzilla 3.0 introduced the ability to automatically notify
+        administrators when new releases are available, based on the
+        <code class="literal">upgrade_notification</code> parameter, see
+        <a class="xref" href="#parameters" title="3.1. Bugzilla Configuration">Section 3.1, “Bugzilla Configuration”</a>. Administrators will see these
+        notifications when they access the <code class="filename">index.cgi</code>
+        page, i.e. generally when logging in. Bugzilla will check once per
+        day for new releases, unless the parameter is set to
+        <span class="quote">“<span class="quote">disabled</span>”</span>. If you are behind a proxy, you may have to set
+        the <code class="literal">proxy_url</code> parameter accordingly. If the proxy
+        requires authentication, use the
+        <code class="literal">http://user:pass@proxy_url/</code> syntax.
+      </p></div></div></div><div class="chapter" title="Chapter 3. Administering Bugzilla"><div class="titlepage"><div><div><h2 class="title"><a name="administration"></a>Chapter 3. Administering Bugzilla</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#parameters">3.1. Bugzilla Configuration</a></span></dt><dd><dl><dt><span class="section"><a href="#param-requiredsettings">3.1.1. Required Settings</a></span></dt><dt><span class="section"><a href="#param-admin-policies">3.1.2. Administrative Policies</a></span></dt><dt><span class="section"><a href="#param-user-authentication">3.1.3. User Authentication</a></span></dt><dt><span class="section"><a href="#param-attachments">3.1.4. Attachments</a></span></dt><dt><span class="section"><a href="#param-bug-change-policies">3.1.5. Bug Change Policies</a></span></dt><dt><span class="section"><a href="#param-bugfields">3.1.6. Bug Fields</a></span></dt><dt><span class="section"><a href="#param-bugmoving">3.1.7. Bug Moving</a></span></dt><dt><span class="section"><a href="#param-dependency-graphs">3.1.8. Dependency Graphs</a></span></dt><dt><span class="section"><a href="#param-group-security">3.1.9. Group Security</a></span></dt><dt><span class="section"><a href="#bzldap">3.1.10. LDAP Authentication</a></span></dt><dt><span class="section"><a href="#bzradius">3.1.11. RADIUS Authentication</a></span></dt><dt><span class="section"><a href="#param-email">3.1.12. Email</a></span></dt><dt><span class="section"><a href="#param-patchviewer">3.1.13. Patch Viewer</a></span></dt><dt><span class="section"><a href="#param-querydefaults">3.1.14. Query Defaults</a></span></dt><dt><span class="section"><a href="#param-shadowdatabase">3.1.15. Shadow Database</a></span></dt><dt><span class="section"><a href="#admin-usermatching">3.1.16. User Matching</a></span></dt></dl></dd><dt><span class="section"><a href="#useradmin">3.2. User Administration</a></span></dt><dd><dl><dt><span class="section"><a href="#defaultuser">3.2.1. Creating the Default User</a></span></dt><dt><span class="section"><a href="#manageusers">3.2.2. Managing Other Users</a></span></dt></dl></dd><dt><span class="section"><a href="#classifications">3.3. Classifications</a></span></dt><dt><span class="section"><a href="#products">3.4. Products</a></span></dt><dd><dl><dt><span class="section"><a href="#create-product">3.4.1. Creating New Products</a></span></dt><dt><span class="section"><a href="#edit-products">3.4.2. Editing Products</a></span></dt><dt><span class="section"><a href="#comps-vers-miles-products">3.4.3. Adding or Editing Components, Versions and Target Milestones</a></span></dt><dt><span class="section"><a href="#product-group-controls">3.4.4. Assigning Group Controls to Products</a></span></dt></dl></dd><dt><span class="section"><a href="#components">3.5. Components</a></span></dt><dt><span class="section"><a href="#versions">3.6. Versions</a></span></dt><dt><span class="section"><a href="#milestones">3.7. Milestones</a></span></dt><dt><span class="section"><a href="#flags-overview">3.8. Flags</a></span></dt><dd><dl><dt><span class="section"><a href="#flags-simpleexample">3.8.1. A Simple Example</a></span></dt><dt><span class="section"><a href="#flags-about">3.8.2. About Flags</a></span></dt><dt><span class="section"><a href="#flag-askto">3.8.3. Using flag requests</a></span></dt><dt><span class="section"><a href="#flag-types">3.8.4. Two Types of Flags</a></span></dt><dt><span class="section"><a href="#flags-admin">3.8.5. Administering Flags</a></span></dt></dl></dd><dt><span class="section"><a href="#keywords">3.9. Keywords</a></span></dt><dt><span class="section"><a href="#custom-fields">3.10. Custom Fields</a></span></dt><dd><dl><dt><span class="section"><a href="#add-custom-fields">3.10.1. Adding Custom Fields</a></span></dt><dt><span class="section"><a href="#edit-custom-fields">3.10.2. Editing Custom Fields</a></span></dt><dt><span class="section"><a href="#delete-custom-fields">3.10.3. Deleting Custom Fields</a></span></dt></dl></dd><dt><span class="section"><a href="#edit-values">3.11. Legal Values</a></span></dt><dd><dl><dt><span class="section"><a href="#edit-values-list">3.11.1. Viewing/Editing legal values</a></span></dt><dt><span class="section"><a href="#edit-values-delete">3.11.2. Deleting legal values</a></span></dt></dl></dd><dt><span class="section"><a href="#bug_status_workflow">3.12. Bug Status Workflow</a></span></dt><dt><span class="section"><a href="#voting">3.13. Voting</a></span></dt><dt><span class="section"><a href="#quips">3.14. Quips</a></span></dt><dt><span class="section"><a href="#groups">3.15. Groups and Group Security</a></span></dt><dd><dl><dt><span class="section"><a href="#create-groups">3.15.1. Creating Groups</a></span></dt><dt><span class="section"><a href="#edit-groups">3.15.2. Editing Groups and Assigning Group Permissions</a></span></dt><dt><span class="section"><a href="#users-and-groups">3.15.3. Assigning Users to Groups</a></span></dt><dt><span class="section"><a href="#idp11180256">3.15.4. Assigning Group Controls to Products</a></span></dt></dl></dd><dt><span class="section"><a href="#sanitycheck">3.16. Checking and Maintaining Database Integrity</a></span></dt></dl></div><div class="section" title="3.1. Bugzilla Configuration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="parameters"></a>3.1. Bugzilla Configuration</h2></div></div></div><p>
+      Bugzilla is configured by changing various parameters, accessed
+      from the "Parameters" link in the Administration page (the 
+      Administration page can be found by clicking the "Administration"
+      link in the footer). The parameters are divided into several categories,
+      accessed via the menu on the left. Following is a description of the 
+      different categories and important parameters within those categories. 
+    </p><div class="section" title="3.1.1. Required Settings"><div class="titlepage"><div><div><h3 class="title"><a name="param-requiredsettings"></a>3.1.1. Required Settings</h3></div></div></div><p>
+          The core required parameters for any Bugzilla installation are set
+          here. These parameters must be set before a new Bugzilla installation
+          can be used. Administrators should review this list before 
+          deploying a new Bugzilla installation.
+        </p><div class="variablelist"><dl><dt><span class="term">
+              maintainer
+            </span></dt><dd><p> 
+              Email address of the person 
+              responsible for maintaining this Bugzilla installation.
+              The address need not be that of a valid Bugzilla account.
+            </p></dd><dt><span class="term">
+              urlbase
+            </span></dt><dd><p>
+                Defines the fully qualified domain name and web 
+                server path to this Bugzilla installation.
+              </p><p>
+                For example, if the Bugzilla query page is
+                <code class="filename">http://www.foo.com/bugzilla/query.cgi</code>, 
+                the <span class="quote">“<span class="quote">urlbase</span>”</span> should be set
+                to <code class="filename">http://www.foo.com/bugzilla/</code>.
+              </p></dd><dt><span class="term">
+              docs_urlbase
+            </span></dt><dd><p>
+                Defines path to the Bugzilla documentation. This can be a fully
+                qualified domain name, or a path relative to "urlbase".
+              </p><p>
+                For example, if the "Bugzilla Configuration" page 
+                of the documentation is
+                <code class="filename">http://www.foo.com/bugzilla/docs/html/parameters.html</code>, 
+                set the <span class="quote">“<span class="quote">docs_urlbase</span>”</span>
+                to <code class="filename">http://www.foo.com/bugzilla/docs/html/</code>.
+              </p></dd><dt><span class="term">
+              sslbase
+            </span></dt><dd><p>
+                Defines the fully qualified domain name and web 
+                server path for HTTPS (SSL) connections to this Bugzilla installation.
+              </p><p>
+                For example, if the Bugzilla main page is
+                <code class="filename">https://www.foo.com/bugzilla/index.cgi</code>, 
+                the <span class="quote">“<span class="quote">sslbase</span>”</span> should be set
+                to <code class="filename">https://www.foo.com/bugzilla/</code>.
+              </p></dd><dt><span class="term">
+              ssl_redirect
+            </span></dt><dd><p>
+                If enabled, Bugzilla will force HTTPS (SSL) connections, by
+                automatically redirecting any users who try to use a non-SSL
+                connection.
+              </p></dd><dt><span class="term">
+              cookiedomain
+            </span></dt><dd><p>
+               Defines the domain for Bugzilla cookies. This is typically left blank.
+               If there are multiple hostnames that point to the same webserver, which
+               require the same cookie, then this parameter can be utilized. For
+               example, If your website is at 
+               <code class="filename">https://www.foo.com/</code>, setting this to 
+               <code class="filename">.foo.com/</code> will also allow 
+               <code class="filename">bar.foo.com/</code> to access Bugzilla cookies.
+              </p></dd><dt><span class="term">
+              cookiepath
+            </span></dt><dd><p>
+                Defines a path, relative to the web server root, that Bugzilla
+                cookies will be restricted to. For example, if the 
+                <span class="command"><strong>urlbase</strong></span> is set to
+                <code class="filename">http://www.foo.com/bugzilla/</code>, the 
+                <span class="command"><strong>cookiepath</strong></span> should be set to 
+                <code class="filename">/bugzilla/</code>. Setting it to "/" will allow all sites 
+                served by this web server or virtual host to read Bugzilla cookies.
+              </p></dd><dt><span class="term">
+              utf8
+            </span></dt><dd><p>
+               Determines whether to use UTF-8 (Unicode) encoding for all text in 
+               Bugzilla. New installations should set this to true to avoid character 
+               encoding problems. Existing databases should set this to true only 
+               after the data has been converted from existing legacy character 
+               encoding to UTF-8, using the 
+               <code class="filename">contrib/recode.pl</code> script.
+              </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+                  If you turn this parameter from "off" to "on", you must re-run 
+                  <code class="filename">checksetup.pl</code> immediately afterward.
+                </p></td></tr></table></div></dd><dt><span class="term">
+              shutdownhtml
+            </span></dt><dd><p>
+                If there is any text in this field, this Bugzilla installation will
+                be completely disabled and this text will appear instead of all
+                Bugzilla pages for all users, including Admins. Used in the event 
+                of site maintenance or outage situations. 
+              </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+                  Although regular log-in capability is disabled while 
+                  <span class="command"><strong>shutdownhtml</strong></span>
+                  is enabled, safeguards are in place to protect the unfortunate 
+                  admin who loses connection to Bugzilla. Should this happen to you,
+                  go directly to the <code class="filename">editparams.cgi</code> (by typing
+                  the URL in manually, if necessary). Doing this will prompt you to
+                  log in, and your name/password will be accepted here (but nowhere
+                  else). 
+                </p></td></tr></table></div></dd><dt><span class="term">
+              announcehtml
+            </span></dt><dd><p>
+                Any text in this field will be displayed at the top of every HTML
+                page in this Bugzilla installation. The text is not wrapped in any
+                tags. For best results, wrap the text in a <span class="quote">“<span class="quote">&lt;div&gt;</span>”</span>
+                tag. Any style attributes from the CSS can be applied. For example,
+                to make the text green inside of a red box, add <span class="quote">“<span class="quote">id=message</span>”</span>
+                to the <span class="quote">“<span class="quote">&lt;div&gt;</span>”</span> tag.
+              </p></dd><dt><span class="term">
+              proxy_url
+            </span></dt><dd><p>
+                If this Bugzilla installation is behind a proxy, enter the proxy 
+                information here to enable Bugzilla to access the Internet. Bugzilla
+                requires Internet access to utilize the 
+                <span class="command"><strong>upgrade_notification</strong></span> parameter (below). If the 
+                proxy requires authentication, use the syntax:
+                <code class="filename">http://user:pass@proxy_url/</code>.
+              </p></dd><dt><span class="term">
+              upgrade_notification
+            </span></dt><dd><p>
+                Enable or disable a notification on the homepage of this Bugzilla
+                installation when a newer version of Bugzilla is available. This
+                notification is only visible to administrators. Choose "disabled",
+                to turn off the notification. Otherwise, choose which version of
+                Bugzilla you want to be notified about: "development_snapshot" is the
+                latest release on the trunk; "latest_stable_release" is the most 
+                recent release available on the most recent stable branch; 
+                "stable_branch_release" the most recent release on the branch 
+                this installation is based on.
+              </p></dd></dl></div></div><div class="section" title="3.1.2. Administrative Policies"><div class="titlepage"><div><div><h3 class="title"><a name="param-admin-policies"></a>3.1.2. Administrative Policies</h3></div></div></div><p>
+            This page contains parameters for basic administrative functions.
+            Options include whether to allow the deletion of bugs and users,
+            and whether to allow users to change their email address.
+          </p></div><div class="section" title="3.1.3. User Authentication"><div class="titlepage"><div><div><h3 class="title"><a name="param-user-authentication"></a>3.1.3. User Authentication</h3></div></div></div><p>
+            This page contains the settings that control how this Bugzilla
+            installation will do its authentication. Choose what authentication
+            mechanism to use (the Bugzilla database, or an external source such
+            as LDAP), and set basic behavioral parameters. For example, choose
+            whether to require users to login to browse bugs, the management
+            of authentication cookies, and the regular expression used to
+            validate email addresses. Some parameters are highlighted below.
+          </p><div class="variablelist"><dl><dt><span class="term">
+              emailregexp
+            </span></dt><dd><p>
+                Defines the regular expression used to validate email addresses
+                used for login names. The default attempts to match fully
+                qualified email addresses (i.e. 'user@example.com') in a slightly
+                more restrictive way than what is allowed in RFC 2822.
+                Some Bugzilla installations allow only local user names (i.e 'user'
+                instead of 'user@example.com'). In that case, this parameter
+                should be used to define the email domain.
+              </p></dd><dt><span class="term">
+              emailsuffix
+            </span></dt><dd><p>
+                This string is appended to login names when actually sending 
+                email to a user. For example,
+                If <span class="command"><strong>emailregexp</strong></span> has been set to allow
+                local usernames,
+                then this parameter would contain the email domain for all users
+                (i.e. '@example.com').   
+              </p></dd></dl></div></div><div class="section" title="3.1.4. Attachments"><div class="titlepage"><div><div><h3 class="title"><a name="param-attachments"></a>3.1.4. Attachments</h3></div></div></div><p>
+            This page allows for setting restrictions and other parameters
+            regarding attachments to bugs. For example, control size limitations
+            and whether to allow pointing to external files via a URI.
+          </p></div><div class="section" title="3.1.5. Bug Change Policies"><div class="titlepage"><div><div><h3 class="title"><a name="param-bug-change-policies"></a>3.1.5. Bug Change Policies</h3></div></div></div><p>
+            Set policy on default behavior for bug change events. For example,
+            choose which status to set a bug to when it is marked as a duplicate,
+            and choose whether to allow bug reporters to set the priority or
+            target milestone. Also allows for configuration of what changes
+            should require the user to make a comment, described below.    
+          </p><div class="variablelist"><dl><dt><span class="term">
+              commenton*
+            </span></dt><dd><p>
+                All these fields allow you to dictate what changes can pass
+                without comment, and which must have a comment from the
+                person who changed them.  Often, administrators will allow
+                users to add themselves to the CC list, accept bugs, or
+                change the Status Whiteboard without adding a comment as to
+                their reasons for the change, yet require that most other
+                changes come with an explanation.
+              </p><p>
+                Set the "commenton" options according to your site policy. It
+                is a wise idea to require comments when users resolve, reassign, or
+                reopen bugs at the very least. 
+              </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+                  It is generally far better to require a developer comment
+                  when resolving bugs than not. Few things are more annoying to bug
+                  database users than having a developer mark a bug "fixed" without
+                  any comment as to what the fix was (or even that it was truly
+                  fixed!)
+                </p></td></tr></table></div></dd><dt><span class="term">
+              noresolveonopenblockers
+            </span></dt><dd><p>
+                This option will prevent users from resolving bugs as FIXED if
+                they have unresolved dependencies. Only the FIXED resolution
+                is affected. Users will be still able to resolve bugs to
+                resolutions other than FIXED if they have unresolved dependent
+                bugs.
+              </p></dd></dl></div></div><div class="section" title="3.1.6. Bug Fields"><div class="titlepage"><div><div><h3 class="title"><a name="param-bugfields"></a>3.1.6. Bug Fields</h3></div></div></div><p>
+            The parameters in this section determine the default settings of
+            several Bugzilla fields for new bugs, and also control whether
+            certain fields are used. For example, choose whether to use the
+            "target milestone" field or the "status whiteboard" field.
+          </p><div class="variablelist"><dl><dt><span class="term">
+              useqacontact
+            </span></dt><dd><p>
+                This allows you to define an email address for each component, 
+                in addition to that of the default assignee, who will be sent
+                carbon copies of incoming bugs.
+              </p></dd><dt><span class="term">
+              usestatuswhiteboard
+            </span></dt><dd><p>
+                This defines whether you wish to have a free-form, overwritable field
+                associated with each bug. The advantage of the Status Whiteboard is
+                that it can be deleted or modified with ease, and provides an
+                easily-searchable field for indexing some bugs that have some trait
+                in common.         
+              </p></dd></dl></div></div><div class="section" title="3.1.7. Bug Moving"><div class="titlepage"><div><div><h3 class="title"><a name="param-bugmoving"></a>3.1.7. Bug Moving</h3></div></div></div><p>
+            This page controls whether this Bugzilla installation allows certain
+            users to move bugs to an external database. If bug moving is enabled,
+            there are a number of parameters that control bug moving behaviors. 
+            For example, choose which users are allowed to move bugs, the location
+            of the external database, and the default product and component that
+            bugs moved <span class="emphasis"><em>from</em></span> other bug databases to this 
+            Bugzilla installation are assigned to. 
+          </p></div><div class="section" title="3.1.8. Dependency Graphs"><div class="titlepage"><div><div><h3 class="title"><a name="param-dependency-graphs"></a>3.1.8. Dependency Graphs</h3></div></div></div><p>
+            This page has one parameter that sets the location of a Web Dot
+            server, or of the Web Dot binary on the local system, that is used
+            to generate dependency graphs. Web Dot is a CGI program that creates
+            images from <code class="filename">.dot</code> graphic description files. If
+            no Web Dot server or binary is specified, then dependency graphs will
+            be disabled.
+          </p></div><div class="section" title="3.1.9. Group Security"><div class="titlepage"><div><div><h3 class="title"><a name="param-group-security"></a>3.1.9. Group Security</h3></div></div></div><p>
+              Bugzilla allows for the creation of different groups, with the
+              ability to restrict the visibility of bugs in a group to a set of 
+              specific users. Specific products can also be associated with
+              groups, and users restricted to only see products in their groups.
+              Several parameters are described in more detail below. Most of the
+              configuration of groups and their relationship to products is done
+              on the "Groups" and "Product" pages of the "Administration" area.
+              The options on this page control global default behavior. 
+              For more information on Groups and Group Security, see
+              <a class="xref" href="#groups" title="3.15. Groups and Group Security">Section 3.15, “Groups and Group Security”</a> 
+            </p><div class="variablelist"><dl><dt><span class="term">
+              makeproductgroups
+            </span></dt><dd><p>
+                Determines whether or not to automatically create groups
+                when new products are created. If this is on, the groups will be
+                used for querying bugs.
+              </p></dd><dt><span class="term">
+              usevisibilitygroups
+            </span></dt><dd><p>
+                If selected, user visibility will be restricted to members of
+                groups, as selected in the group configuration settings. 
+                Each user-defined group can be allowed to see members of selected
+                other groups. 
+                For details on configuring groups (including the visibility 
+                restrictions) see <a class="xref" href="#edit-groups" title="3.15.2. Editing Groups and Assigning Group Permissions">Section 3.15.2, “Editing Groups and Assigning Group Permissions”</a>. 
+              </p></dd><dt><span class="term">
+              querysharegroup
+            </span></dt><dd><p>
+                The name of the group of users who are allowed to share saved
+                searches with one another. For more information on using 
+                saved searches, see <a class="xref" href="#savedsearches" title="5.10.3. Saved Searches">Saved Searches</a>.
+              </p></dd></dl></div></div><div class="section" title="3.1.10. LDAP Authentication"><div class="titlepage"><div><div><h3 class="title"><a name="bzldap"></a>3.1.10. LDAP Authentication</h3></div></div></div><p>LDAP authentication is a module for Bugzilla's plugin 
+          authentication architecture. This page contains all the parameters
+          necessary to configure Bugzilla for use with LDAP authentication.
+          </p><p>
+          The existing authentication
+          scheme for Bugzilla uses email addresses as the primary user ID, and a
+          password to authenticate that user. All places within Bugzilla that
+          require a user ID (e.g assigning a bug) use the email
+          address. The LDAP authentication builds on top of this scheme, rather
+          than replacing it. The initial log-in is done with a username and
+          password for the LDAP directory. Bugzilla tries to bind to LDAP using
+          those credentials and, if successful, tries to map this account to a
+          Bugzilla account. If an LDAP mail attribute is defined, the value of this
+          attribute is used, otherwise the "emailsuffix" parameter is appended to LDAP
+          username to form a full email address. If an account for this address
+          already exists in the Bugzilla installation, it will log in to that account.
+          If no account for that email address exists, one is created at the time
+          of login. (In this case, Bugzilla will attempt to use the "displayName"
+          or "cn" attribute to determine the user's full name.) After
+          authentication, all other user-related tasks are still handled by email
+          address, not LDAP username. For example, bugs are still assigned by
+          email address and users are still queried by email address.
+          </p><div class="caution" title="Caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Because the Bugzilla account is not created until the first time
+            a user logs in, a user who has not yet logged is unknown to Bugzilla.
+            This means they cannot be used as an assignee or QA contact (default or
+            otherwise), added to any CC list, or any other such operation. One
+            possible workaround is the <code class="filename">bugzilla_ldapsync.rb</code>
+            script in the
+            <a class="glossterm" href="#gloss-contrib"><em class="glossterm">
+            <code class="filename">contrib</code></em></a> 
+            directory. Another possible solution is fixing
+            <a class="ulink" href="https://bugzilla.mozilla.org/show_bug.cgi?id=201069" target="_top">bug
+            201069</a>.
+            </p></td></tr></table></div><p>Parameters required to use LDAP Authentication:</p><div class="variablelist"><dl><dt><a name="param-user_verify_class_for_ldap"></a><span class="term">user_verify_class</span></dt><dd><p>If you want to list <span class="quote">“<span class="quote">LDAP</span>”</span> here,
+                make sure to have set up the other parameters listed below.
+                Unless you have other (working) authentication methods listed as
+                well, you may otherwise not be able to log back in to Bugzilla once
+                you log out.
+                If this happens to you, you will need to manually edit
+                <code class="filename">data/params</code> and set user_verify_class to
+                <span class="quote">“<span class="quote">DB</span>”</span>.
+                </p></dd><dt><a name="param-LDAPserver"></a><span class="term">LDAPserver</span></dt><dd><p>This parameter should be set to the name (and optionally the
+                port) of your LDAP server. If no port is specified, it assumes
+                the default LDAP port of 389.
+                </p><p>For example: <span class="quote">“<span class="quote">ldap.company.com</span>”</span>
+                 or <span class="quote">“<span class="quote">ldap.company.com:3268</span>”</span>
+                </p><p>You can also specify a LDAP URI, so as to use other
+                protocols, such as LDAPS or LDAPI. If port was not specified in
+                the URI, the default is either 389 or 636 for 'LDAP' and 'LDAPS'
+                schemes respectively.
+                </p><div class="tip" title="Tip" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../images/tip.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+                    In order to use SSL with LDAP, specify a URI with "ldaps://".
+                    This will force the use of SSL over port 636.
+                  </p></td></tr></table></div><p>For example, normal LDAP: 
+                <span class="quote">“<span class="quote">ldap://ldap.company.com</span>”</span>, LDAP over SSL:
+                <span class="quote">“<span class="quote">ldaps://ldap.company.com</span>”</span> or LDAP over a UNIX 
+                domain socket <span class="quote">“<span class="quote">ldapi://%2fvar%2flib%2fldap_sock</span>”</span>.
+                </p></dd><dt><a name="param-LDAPbinddn"></a><span class="term">LDAPbinddn [Optional]</span></dt><dd><p>Some LDAP servers will not allow an anonymous bind to search
+                 the directory. If this is the case with your configuration you
+                 should set the LDAPbinddn parameter to the user account Bugzilla
+                 should use instead of the anonymous bind.
+                 </p><p>Ex. <span class="quote">“<span class="quote">cn=default,cn=user:password</span>”</span></p></dd><dt><a name="param-LDAPBaseDN"></a><span class="term">LDAPBaseDN</span></dt><dd><p>The LDAPBaseDN parameter should be set to the location in
+                 your LDAP tree that you would like to search for email addresses.
+                 Your uids should be unique under the DN specified here.
+                 </p><p>Ex. <span class="quote">“<span class="quote">ou=People,o=Company</span>”</span></p></dd><dt><a name="param-LDAPuidattribute"></a><span class="term">LDAPuidattribute</span></dt><dd><p>The LDAPuidattribute parameter should be set to the attribute
+                 which contains the unique UID of your users. The value retrieved
+                 from this attribute will be used when attempting to bind as the
+                 user to confirm their password.
+                 </p><p>Ex. <span class="quote">“<span class="quote">uid</span>”</span></p></dd><dt><a name="param-LDAPmailattribute"></a><span class="term">LDAPmailattribute</span></dt><dd><p>The LDAPmailattribute parameter should be the name of the
+                 attribute which contains the email address your users will enter
+                 into the Bugzilla login boxes.
+                 </p><p>Ex. <span class="quote">“<span class="quote">mail</span>”</span></p></dd></dl></div></div><div class="section" title="3.1.11. RADIUS Authentication"><div class="titlepage"><div><div><h3 class="title"><a name="bzradius"></a>3.1.11. RADIUS Authentication</h3></div></div></div><p>
+          RADIUS authentication is a module for Bugzilla's plugin 
+          authentication architecture. This page contains all the parameters
+          necessary for configuring Bugzilla to use RADIUS authentication.
+          </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+              Most caveats that apply to LDAP authentication apply to RADIUS
+              authentication as well. See <a class="xref" href="#bzldap" title="3.1.10. LDAP Authentication">Section 3.1.10, “LDAP Authentication”</a> for details.
+            </p></td></tr></table></div><p>Parameters required to use RADIUS Authentication:</p><div class="variablelist"><dl><dt><a name="param-user_verify_class_for_radius"></a><span class="term">user_verify_class</span></dt><dd><p>If you want to list <span class="quote">“<span class="quote">RADIUS</span>”</span> here,
+                make sure to have set up the other parameters listed below.
+                Unless you have other (working) authentication methods listed as
+                well, you may otherwise not be able to log back in to Bugzilla once
+                you log out.
+                If this happens to you, you will need to manually edit
+                <code class="filename">data/params</code> and set user_verify_class to
+                <span class="quote">“<span class="quote">DB</span>”</span>.
+                </p></dd><dt><a name="param-RADIUS_server"></a><span class="term">RADIUS_server</span></dt><dd><p>This parameter should be set to the name (and optionally the
+                port) of your RADIUS server.
+                </p></dd><dt><a name="param-RADIUS_secret"></a><span class="term">RADIUS_secret</span></dt><dd><p>This parameter should be set to the RADIUS server's secret.
+                </p></dd><dt><a name="param-RADIUS_email_suffix"></a><span class="term">RADIUS_email_suffix</span></dt><dd><p>Bugzilla needs an e-mail address for each user account.
+                Therefore, it needs to determine the e-mail address corresponding
+                to a RADIUS user.
+                Bugzilla offers only a simple way to do this: it can concatenate
+                a suffix to the RADIUS user name to convert it into an e-mail
+                address.
+                You can specify this suffix in the RADIUS_email_suffix parameter.
+                </p><p>If this simple solution does not work for you, you'll
+                probably need to modify
+                <code class="filename">Bugzilla/Auth/Verify/RADIUS.pm</code> to match your
+                requirements.
+                </p></dd></dl></div></div><div class="section" title="3.1.12. Email"><div class="titlepage"><div><div><h3 class="title"><a name="param-email"></a>3.1.12. Email</h3></div></div></div><p>
+            This page contains all of the parameters for configuring how
+            Bugzilla deals with the email notifications it sends. See below
+            for a summary of important options. 
+          </p><div class="variablelist"><dl><dt><span class="term">
+              mail_delivery_method
+            </span></dt><dd><p>
+                This is used to specify how email is sent, or if it is sent at 
+                all.  There are several options included for different MTAs, 
+                along with two additional options that disable email sending.  
+                "Test" does not send mail, but instead saves it in 
+                <code class="filename">data/mailer.testfile</code> for later review.  
+                "None" disables email sending entirely.
+              </p></dd><dt><span class="term">
+              mailfrom
+            </span></dt><dd><p>
+                This is the email address that will appear in the "From" field
+                of all emails sent by this Bugzilla installation. Some email
+                servers require mail to be from a valid email address, therefore
+                it is recommended to choose a valid email address here.
+              </p></dd><dt><span class="term">
+              smtpserver
+            </span></dt><dd><p>
+                This is the SMTP server address, if the <span class="quote">“<span class="quote">mail_delivery_method</span>”</span>
+                parameter is set to SMTP.  Use "localhost" if you have a local MTA
+                running, otherwise use a remote SMTP server.  Append ":" and the port
+                number, if a non-default port is needed.
+              </p></dd><dt><span class="term">
+              smtp_username
+            </span></dt><dd><p>
+                Username to use for SASL authentication to the SMTP server.  Leave
+                this parameter empty if your server does not require authentication.
+              </p></dd><dt><span class="term">
+              smtp_password
+            </span></dt><dd><p>
+                Password to use for SASL authentication to the SMTP server. This
+                parameter will be ignored if the <span class="quote">“<span class="quote">smtp_username</span>”</span>
+                parameter is left empty.
+              </p></dd><dt><span class="term">
+              smtp_ssl
+            </span></dt><dd><p>
+                Enable SSL support for connection to the SMTP server.
+              </p></dd><dt><span class="term">
+              smtp_debug
+            </span></dt><dd><p>
+                This parameter allows you to enable detailed debugging output.
+                Log messages are printed the web server's error log.
+              </p></dd><dt><span class="term">
+              whinedays
+            </span></dt><dd><p>
+                Set this to the number of days you want to let bugs go
+                in the CONFIRMED state before notifying people they have
+                untouched new bugs. If you do not plan to use this feature, simply 
+                do not set up the whining cron job described in the installation
+                instructions, or set this value to "0" (never whine).
+              </p></dd><dt><span class="term">
+              globalwatcher
+            </span></dt><dd><p>
+                This allows you to define specific users who will
+                receive notification each time a new bug in entered, or when
+                an existing bug changes, according to the normal groupset
+                permissions. It may be useful for sending notifications to a
+                mailing-list, for instance.
+              </p></dd></dl></div></div><div class="section" title="3.1.13. Patch Viewer"><div class="titlepage"><div><div><h3 class="title"><a name="param-patchviewer"></a>3.1.13. Patch Viewer</h3></div></div></div><p>
+            This page contains configuration parameters for the CVS server, 
+            Bonsai server and LXR server that Bugzilla will use to enable the
+            features of the Patch Viewer. Bonsai is a tool that enables queries 
+            to a CVS tree. LXR is a tool that can cross reference and index source
+            code.
+          </p></div><div class="section" title="3.1.14. Query Defaults"><div class="titlepage"><div><div><h3 class="title"><a name="param-querydefaults"></a>3.1.14. Query Defaults</h3></div></div></div><p>
+            This page controls the default behavior of Bugzilla in regards to 
+            several aspects of querying bugs. Options include what the default
+            query options are, what the "My Bugs" page returns, whether users
+            can freely add bugs to the quip list, and how many duplicate bugs are 
+            needed to add a bug to the "most frequently reported" list.
+          </p></div><div class="section" title="3.1.15. Shadow Database"><div class="titlepage"><div><div><h3 class="title"><a name="param-shadowdatabase"></a>3.1.15. Shadow Database</h3></div></div></div><p>
+            This page controls whether a shadow database is used, and all the
+            parameters associated with the shadow database. Versions of Bugzilla
+            prior to 3.2 used the MyISAM table type, which supports
+            only table-level write locking. With MyISAM, any time someone is making a change to 
+            a bug, the entire table is locked until the write operation is complete.
+            Locking for write also blocks reads until the write is complete.
+          </p><p>
+            The <span class="quote">“<span class="quote">shadowdb</span>”</span> parameter was designed to get around
+            this limitation. While only a single user is allowed to write to
+            a table at a time, reads can continue unimpeded on a read-only
+            shadow copy of the database.
+          </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+              As of version 3.2, Bugzilla no longer uses the MyISAM table type.
+              Instead, InnoDB is used, which can do transaction-based locking.
+              Therefore, the limitations the Shadow Database feature was designed
+              to workaround no longer exist.
+            </p></td></tr></table></div></div><div class="section" title="3.1.16. User Matching"><div class="titlepage"><div><div><h3 class="title"><a name="admin-usermatching"></a>3.1.16. User Matching</h3></div></div></div><p>
+            The settings on this page control how users are selected and queried
+            when adding a user to a bug. For example, users need to be selected
+            when choosing who the bug is assigned to, adding to the CC list or 
+            selecting a QA contact. With the "usemenuforusers" parameter, it is 
+            possible to configure Bugzilla to 
+            display a list of users in the fields instead of an empty text field.
+            This should only be used in Bugzilla installations with a small number
+            of users. If users are selected via a text box, this page also
+            contains parameters for how user names can be queried and matched
+            when entered.
+          </p><p>
+            Another setting called 'ajax_user_autocompletion' enables certain
+            user fields to display a list of matched user names as a drop down after typing 
+            a few characters. Note that it is recommended to use mod_perl when
+            enabling 'ajax_user_autocompletion'.
+          </p></div></div><div class="section" title="3.2. User Administration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="useradmin"></a>3.2. User Administration</h2></div></div></div><div class="section" title="3.2.1. Creating the Default User"><div class="titlepage"><div><div><h3 class="title"><a name="defaultuser"></a>3.2.1. Creating the Default User</h3></div></div></div><p>When you first run checksetup.pl after installing Bugzilla, it
+      will prompt you for the administrative username (email address) and
+      password for this "super user". If for some reason you delete
+      the "super user" account, re-running checksetup.pl will again prompt
+      you for this username and password.</p><div class="tip" title="Tip" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../images/tip.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>If you wish to add more administrative users, add them to 
+        the "admin" group and, optionally, edit the tweakparams, editusers,
+        creategroups, editcomponents, and editkeywords groups to add the
+        entire admin group to those groups (which is the case by default).
+        </p></td></tr></table></div></div><div class="section" title="3.2.2. Managing Other Users"><div class="titlepage"><div><div><h3 class="title"><a name="manageusers"></a>3.2.2. Managing Other Users</h3></div></div></div><div class="section" title="3.2.2.1. Searching for existing users"><div class="titlepage"><div><div><h4 class="title"><a name="user-account-search"></a>3.2.2.1. Searching for existing users</h4></div></div></div><p>
+          If you have <span class="quote">“<span class="quote">editusers</span>”</span> privileges or if you are allowed
+          to grant privileges for some groups, the <span class="quote">“<span class="quote">Users</span>”</span> link
+          will appear in the Administration page.
+        </p><p>
+          The first screen is a search form to search for existing user
+          accounts. You can run searches based either on the user ID, real
+          name or login name (i.e. the email address, or just the first part
+          of the email address if the "emailsuffix" parameter is set).
+          The search can be conducted
+          in different ways using the listbox to the right of the text entry
+          box. You can match by case-insensitive substring (the default),
+          regular expression, a <span class="emphasis"><em>reverse</em></span> regular expression
+          match (which finds every user name which does NOT match the regular
+          expression), or the exact string if you know exactly who you are
+          looking for. The search can be restricted to users who are in a
+          specific group. By default, the restriction is turned off.
+        </p><p>
+          The search returns a list of
+          users matching your criteria. User properties can be edited by clicking
+          the login name. The Account History of a user can be viewed by clicking
+          the "View" link in the Account History column. The Account History
+          displays changes that have been made to the user account, the time of
+          the change and the user who made the change. For example, the Account
+          History page will display details of when a user was added or removed
+          from a group.
+        </p></div><div class="section" title="3.2.2.2. Creating new users"><div class="titlepage"><div><div><h4 class="title"><a name="createnewusers"></a>3.2.2.2. Creating new users</h4></div></div></div><div class="section" title="3.2.2.2.1. Self-registration"><div class="titlepage"><div><div><h5 class="title"><a name="self-registration"></a>3.2.2.2.1. Self-registration</h5></div></div></div><p>
+            By default, users can create their own user accounts by clicking the
+            <span class="quote">“<span class="quote">New Account</span>”</span> link at the bottom of each page (assuming
+            they aren't logged in as someone else already). If you want to disable
+            this self-registration, or if you want to restrict who can create his
+            own user account, you have to edit the <span class="quote">“<span class="quote">createemailregexp</span>”</span>
+            parameter in the <span class="quote">“<span class="quote">Configuration</span>”</span> page, see
+            <a class="xref" href="#parameters" title="3.1. Bugzilla Configuration">Section 3.1, “Bugzilla Configuration”</a>.
+          </p></div><div class="section" title="3.2.2.2.2. Accounts created by an administrator"><div class="titlepage"><div><div><h5 class="title"><a name="user-account-creation"></a>3.2.2.2.2. Accounts created by an administrator</h5></div></div></div><p>
+            Users with <span class="quote">“<span class="quote">editusers</span>”</span> privileges, such as administrators,
+            can create user accounts for other users:
+          </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>After logging in, click the "Users" link at the footer of
+              the query page, and then click "Add a new user".</p></li><li class="listitem"><p>Fill out the form presented. This page is self-explanatory.
+              When done, click "Submit".</p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Adding a user this way will <span class="emphasis"><em>not</em></span>
+                send an email informing them of their username and password.
+                While useful for creating dummy accounts (watchers which
+                shuttle mail to another system, for instance, or email
+                addresses which are a mailing list), in general it is
+                preferable to log out and use the <span class="quote">“<span class="quote">New Account</span>”</span>
+                button to create users, as it will pre-populate all the
+                required fields and also notify the user of her account name
+                and password.</p></td></tr></table></div></li></ol></div></div></div><div class="section" title="3.2.2.3. Modifying Users"><div class="titlepage"><div><div><h4 class="title"><a name="modifyusers"></a>3.2.2.3. Modifying Users</h4></div></div></div><p>Once you have found your user, you can change the following
+        fields:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
+            <span class="emphasis"><em>Login Name</em></span>: 
+            This is generally the user's full email address. However, if you
+            have are using the <span class="quote">“<span class="quote">emailsuffix</span>”</span> parameter, this may
+            just be the user's login name. Note that users can now change their
+            login names themselves (to any valid email address).
+            </p></li><li class="listitem"><p>
+            <span class="emphasis"><em>Real Name</em></span>: The user's real name. Note that
+            Bugzilla does not require this to create an account.</p></li><li class="listitem"><p>
+            <span class="emphasis"><em>Password</em></span>: 
+            You can change the user's password here. Users can automatically
+            request a new password, so you shouldn't need to do this often.
+            If you want to disable an account, see Disable Text below.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Bugmail Disabled</em></span>:
+              Mark this checkbox to disable bugmail and whinemail completely
+              for this account. This checkbox replaces the data/nomail file
+              which existed in older versions of Bugzilla.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Disable Text</em></span>: 
+              If you type anything in this box, including just a space, the
+              user is prevented from logging in, or making any changes to 
+              bugs via the web interface. 
+              The HTML you type in this box is presented to the user when
+              they attempt to perform these actions, and should explain
+              why the account was disabled.
+            </p><p>
+              Users with disabled accounts will continue to receive
+              mail from Bugzilla; furthermore, they will not be able
+              to log in themselves to change their own preferences and
+              stop it. If you want an account (disabled or active) to
+              stop receiving mail, simply check the
+              <span class="quote">“<span class="quote">Bugmail Disabled</span>”</span> checkbox above.
+            </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+                Even users whose accounts have been disabled can still
+                submit bugs via the e-mail gateway, if one exists.
+                The e-mail gateway should <span class="emphasis"><em>not</em></span> be
+                enabled for secure installations of Bugzilla.
+              </p></td></tr></table></div><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+                Don't disable all the administrator accounts!
+              </p></td></tr></table></div></li><li class="listitem"><p>
+            <span class="emphasis"><em>&lt;groupname&gt;</em></span>: 
+            If you have created some groups, e.g. "securitysensitive", then
+            checkboxes will appear here to allow you to add users to, or
+            remove them from, these groups. The first checkbox gives the
+            user the ability to add and remove other users as members of
+            this group. The second checkbox adds the user himself as a member
+            of the group.
+            </p></li><li class="listitem"><p>
+            <span class="emphasis"><em>canconfirm</em></span>: 
+            This field is only used if you have enabled the "unconfirmed"
+            status. If you enable this for a user,
+            that user can then move bugs from "Unconfirmed" to a "Confirmed"
+            status (e.g.: "New" status).</p></li><li class="listitem"><p>
+            <span class="emphasis"><em>creategroups</em></span>: 
+            This option will allow a user to create and destroy groups in
+            Bugzilla.</p></li><li class="listitem"><p>
+            <span class="emphasis"><em>editbugs</em></span>: 
+            Unless a user has this bit set, they can only edit those bugs
+            for which they are the assignee or the reporter. Even if this
+            option is unchecked, users can still add comments to bugs.
+            </p></li><li class="listitem"><p>
+            <span class="emphasis"><em>editcomponents</em></span>: 
+            This flag allows a user to create new products and components,
+            as well as modify and destroy those that have no bugs associated
+            with them. If a product or component has bugs associated with it,
+            those bugs must be moved to a different product or component
+            before Bugzilla will allow them to be destroyed.
+            </p></li><li class="listitem"><p>
+            <span class="emphasis"><em>editkeywords</em></span>: 
+            If you use Bugzilla's keyword functionality, enabling this
+            feature allows a user to create and destroy keywords. As always,
+            the keywords for existing bugs containing the keyword the user
+            wishes to destroy must be changed before Bugzilla will allow it
+            to die.</p></li><li class="listitem"><p>
+            <span class="emphasis"><em>editusers</em></span>: 
+            This flag allows a user to do what you're doing right now: edit
+            other users. This will allow those with the right to do so to
+            remove administrator privileges from other users or grant them to
+            themselves. Enable with care.</p></li><li class="listitem"><p>
+            <span class="emphasis"><em>tweakparams</em></span>: 
+            This flag allows a user to change Bugzilla's Params 
+            (using <code class="filename">editparams.cgi</code>.)</p></li><li class="listitem"><p> 
+            <span class="emphasis"><em>&lt;productname&gt;</em></span>:
+            This allows an administrator to specify the products 
+            in which a user can see bugs. If you turn on the 
+            <span class="quote">“<span class="quote">makeproductgroups</span>”</span> parameter in
+            the Group Security Panel in the Parameters page, 
+            then Bugzilla creates one group per product (at the time you create 
+            the product), and this group has exactly the same name as the 
+            product itself. Note that for products that already exist when
+            the parameter is turned on, the corresponding group will not be
+            created. The user must still have the <span class="quote">“<span class="quote">editbugs</span>”</span> 
+            privilege to edit bugs in these products.</p></li></ul></div></div><div class="section" title="3.2.2.4. Deleting Users"><div class="titlepage"><div><div><h4 class="title"><a name="user-account-deletion"></a>3.2.2.4. Deleting Users</h4></div></div></div><p>
+          If the <span class="quote">“<span class="quote">allowuserdeletion</span>”</span> parameter is turned on, see
+          <a class="xref" href="#parameters" title="3.1. Bugzilla Configuration">Section 3.1, “Bugzilla Configuration”</a>, then you can also delete user accounts.
+          Note that this is most of the time not the best thing to do. If only
+          a warning in a yellow box is displayed, then the deletion is safe.
+          If a warning is also displayed in a red box, then you should NOT try
+          to delete the user account, else you will get referential integrity
+          problems in your database, which can lead to unexpected behavior,
+          such as bugs not appearing in bug lists anymore, or data displaying
+          incorrectly. You have been warned!
+        </p></div><div class="section" title="3.2.2.5. Impersonating Users"><div class="titlepage"><div><div><h4 class="title"><a name="impersonatingusers"></a>3.2.2.5. Impersonating Users</h4></div></div></div><p>
+        There may be times when an administrator would like to do something as
+        another user.  The <span class="command"><strong>sudo</strong></span> feature may be used to do 
+        this.
+        </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          To use the sudo feature, you must be in the
+          <span class="emphasis"><em>bz_sudoers</em></span> group.  By default, all
+          administrators are in this group.</p></td></tr></table></div><p>
+        If you have access to this feature, you may start a session by
+        going to the Edit Users page, Searching for a user and clicking on 
+        their login.  You should see a link below their login name titled 
+        "Impersonate this user".  Click on the link.  This will take you 
+        to a page where you will see a description of the feature and 
+        instructions for using it.  After reading the text, simply 
+        enter the login of the user you would like to impersonate, provide 
+        a short message explaining why you are doing this, and press the 
+        button.</p><p>
+        As long as you are using this feature, everything you do will be done 
+        as if you were logged in as the user you are impersonating.</p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          The user you are impersonating will not be told about what you are 
+          doing.  If you do anything that results in mail being sent, that 
+          mail will appear to be from the user you are impersonating.  You 
+          should be extremely careful while using this feature.</p></td></tr></table></div></div></div></div><div class="section" title="3.3. Classifications"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="classifications"></a>3.3. Classifications</h2></div></div></div><p>Classifications tend to be used in order to group several related
+    products into one distinct entity.</p><p>The classifications layer is disabled by default; it can be turned
+    on or off using the useclassification parameter,
+    in the <span class="emphasis"><em>Bug Fields</em></span> section of the edit parameters screen.</p><p>Access to the administration of classifications is controlled using
+    the <span class="emphasis"><em>editclassifications</em></span> system group, which defines
+    a privilege for creating, destroying, and editing classifications.</p><p>When activated, classifications will introduce an additional
+    step when filling bugs (dedicated to classification selection), and they
+    will also appear in the advanced search form.</p></div><div class="section" title="3.4. Products"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="products"></a>3.4. Products</h2></div></div></div><p>
+    <a class="glossterm" href="#gloss-product"><em class="glossterm">
+    Products</em></a> typically represent real-world
+    shipping products. Products can be given 
+    <a class="xref" href="#classifications" title="3.3. Classifications">Classifications</a>. 
+    For example, if a company makes computer games, 
+    they could have a classification of "Games", and a separate
+    product for each game. This company might also have a 
+    <span class="quote">“<span class="quote">Common</span>”</span> product for units of technology used 
+    in multiple games, and perhaps a few special products that
+    represent items that are not actually shipping products 
+    (for example, "Website", or "Administration").
+    </p><p>
+    Many of Bugzilla's settings are configurable on a per-product
+    basis. The number of <span class="quote">“<span class="quote">votes</span>”</span> available to 
+    users is set per-product, as is the number of votes
+    required to move a bug automatically from the UNCONFIRMED 
+    status to the CONFIRMED status.
+    </p><p>
+    When creating or editing products the following options are
+    available: 
+    </p><div class="variablelist"><dl><dt><span class="term">
+          Product
+        </span></dt><dd><p> 
+            The name of the product
+          </p></dd><dt><span class="term">
+          Description
+        </span></dt><dd><p> 
+            A brief description of the product
+          </p></dd><dt><span class="term">
+          Default milestone
+        </span></dt><dd><p> 
+            Select the default milestone for this product.
+          </p></dd><dt><span class="term">
+          Closed for bug entry
+        </span></dt><dd><p> 
+            Select this box to prevent new bugs from being
+            entered against this product.
+          </p></dd><dt><span class="term">
+          Maximum votes per person
+        </span></dt><dd><p> 
+            Maximum votes a user is allowed to give for this 
+            product
+          </p></dd><dt><span class="term">
+          Maximum votes a person can put on a single bug
+        </span></dt><dd><p> 
+            Maximum votes a user is allowed to give for this 
+            product in a single bug
+          </p></dd><dt><span class="term">
+          Confirmation threshold
+        </span></dt><dd><p> 
+            Number of votes needed to automatically remove any
+            bug against this product from the UNCONFIRMED state
+          </p></dd><dt><span class="term">
+          Version
+        </span></dt><dd><p> 
+            Specify which version of the product bugs will be
+            entered against.
+          </p></dd><dt><span class="term">
+          Create chart datasets for this product
+        </span></dt><dd><p> 
+            Select to make chart datasets available for this product.
+          </p></dd></dl></div><p>
+    When editing a product there is also a link to edit Group Access Controls,
+    see <a class="xref" href="#product-group-controls" title="3.4.4. Assigning Group Controls to Products">Section 3.4.4, “Assigning Group Controls to Products”</a>.
+    </p><div class="section" title="3.4.1. Creating New Products"><div class="titlepage"><div><div><h3 class="title"><a name="create-product"></a>3.4.1. Creating New Products</h3></div></div></div><p>
+    To create a new product:
+    </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p> 
+        Select <span class="quote">“<span class="quote">Administration</span>”</span> from the footer and then
+        choose <span class="quote">“<span class="quote">Products</span>”</span> from the main administration page.
+        </p></li><li class="listitem"><p>
+        Select the <span class="quote">“<span class="quote">Add</span>”</span> link in the bottom right.
+        </p></li><li class="listitem"><p>
+        Enter the name of the product and a description. The
+        Description field may contain HTML.
+        </p></li><li class="listitem"><p>
+        When the product is created, Bugzilla will give a message
+        stating that a component must be created before any bugs can
+        be entered against the new product. Follow the link to create
+        a new component. See <a class="xref" href="#components" title="3.5. Components">Components</a> for more
+        information.
+        </p></li></ol></div></div><div class="section" title="3.4.2. Editing Products"><div class="titlepage"><div><div><h3 class="title"><a name="edit-products"></a>3.4.2. Editing Products</h3></div></div></div><p>
+      To edit an existing product, click the "Products" link from the 
+      "Administration" page. If the 'useclassification' parameter is
+      turned on, a table of existing classifications is displayed,
+      including an "Unclassified" category. The table indicates how many products
+      are in each classification. Click on the classification name to see its
+      products. If the 'useclassification' parameter is not in use, the table 
+      lists all products directly. The product table summarizes the information 
+      about the product defined
+      when the product was created. Click on the product name to edit these
+      properties, and to access links to other product attributes such as the
+      product's components, versions, milestones, and group access controls.
+      </p></div><div class="section" title="3.4.3. Adding or Editing Components, Versions and Target Milestones"><div class="titlepage"><div><div><h3 class="title"><a name="comps-vers-miles-products"></a>3.4.3. Adding or Editing Components, Versions and Target Milestones</h3></div></div></div><p>
+          To edit existing, or add new, Components, Versions or Target Milestones 
+          to a Product, select the "Edit Components", "Edit Versions" or "Edit
+          Milestones" links from the "Edit Product" page. A table of existing 
+          Components, Versions or Milestones is displayed. Click on a item name 
+          to edit the properties of that item. Below the table is a link to add 
+          a new Component, Version or Milestone. 
+        </p><p>
+          For more information on components, see <a class="xref" href="#components" title="3.5. Components">Components</a>.
+        </p><p>
+          For more information on versions, see <a class="xref" href="#versions" title="3.6. Versions">Section 3.6, “Versions”</a>.
+        </p><p>
+          For more information on milestones, see <a class="xref" href="#milestones" title="3.7. Milestones">Section 3.7, “Milestones”</a>.
+        </p></div><div class="section" title="3.4.4. Assigning Group Controls to Products"><div class="titlepage"><div><div><h3 class="title"><a name="product-group-controls"></a>3.4.4. Assigning Group Controls to Products</h3></div></div></div><p> 
+        On the <span class="quote">“<span class="quote">Edit Product</span>”</span> page, there is a link called 
+        <span class="quote">“<span class="quote">Edit Group Access Controls</span>”</span>. The settings on this page 
+        control the relationship of the groups to the product being edited.
+        </p><p>
+        Group Access Controls are an important aspect of using groups for 
+        isolating products and restricting access to bugs filed against those
+        products. For more information on groups, including how to create, edit
+        add users to, and alter permission of, see <a class="xref" href="#groups" title="3.15. Groups and Group Security">Section 3.15, “Groups and Group Security”</a>.
+        </p><p>
+        After selecting the "Edit Group Access Controls" link from the "Edit
+        Product" page, a table containing all user-defined groups for this 
+        Bugzilla installation is displayed. The system groups that are created
+        when Bugzilla is installed are not applicable to Group Access Controls.
+        Below is description of what each of these fields means.
+        </p><p>
+        Groups may be applicable (e.g bugs in this product can be associated
+        with this group) , default (e.g. bugs in this product are in this group
+        by default), and mandatory (e.g. bugs in this product must be associated
+        with this group) for each product. Groups can also control access 
+        to bugs for a given product, or be used to make bugs for a product 
+        totally read-only unless the group restrictions are met. The best way to
+        understand these relationships is by example. See 
+        <a class="xref" href="#group-control-examples" title="3.4.4.1. Common Applications of Group Controls">Section 3.4.4.1, “Common Applications of Group Controls”</a> for examples of 
+        product and group relationships.
+        </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            Products and Groups are not limited to a one-to-one relationship. 
+            Multiple groups can be associated with the same product, and groups
+            can be associated with more than one product. 
+          </p></td></tr></table></div><p>
+        If any group has <span class="emphasis"><em>Entry</em></span> selected, then the 
+        product will restrict bug entry to only those users 
+        who are members of <span class="emphasis"><em>all</em></span> the groups with 
+        <span class="emphasis"><em>Entry</em></span> selected.
+        </p><p>
+        If any group has <span class="emphasis"><em>Canedit</em></span> selected, 
+        then the product will be read-only for any users 
+        who are not members of <span class="emphasis"><em>all</em></span> of the groups with
+        <span class="emphasis"><em>Canedit</em></span> selected. <span class="emphasis"><em>Only</em></span> users who 
+        are members of all the <span class="emphasis"><em>Canedit</em></span> groups 
+        will be able to edit bugs for this product. This is an additional 
+        restriction that enables finer-grained control over products rather 
+        than just all-or-nothing access levels.
+        </p><p>
+        The following settings let you 
+        choose privileges on a <span class="emphasis"><em>per-product basis</em></span>.
+        This is a convenient way to give privileges to 
+        some users for some products only, without having 
+        to give them global privileges which would affect 
+        all products.
+        </p><p>
+        Any group having <span class="emphasis"><em>editcomponents</em></span> 
+        selected  allows users who are in this group to edit all 
+        aspects of this product, including components, milestones 
+        and versions.
+        </p><p>
+        Any group having <span class="emphasis"><em>canconfirm</em></span> selected 
+        allows users who are in this group to confirm bugs 
+        in this product.
+        </p><p>
+        Any group having <span class="emphasis"><em>editbugs</em></span> selected allows 
+        users who are in this group to edit all fields of 
+        bugs in this product.
+        </p><p>
+        The <span class="emphasis"><em>MemberControl</em></span> and 
+        <span class="emphasis"><em>OtherControl</em></span> are used in tandem to determine which 
+        bugs will be placed in this group. The only allowable combinations of
+        these two parameters are listed in a table on the "Edit Group Access Controls"
+        page. Consult this table for details on how these fields can be used.
+        Examples of different uses are described below.
+        </p><div class="section" title="3.4.4.1. Common Applications of Group Controls"><div class="titlepage"><div><div><h4 class="title"><a name="group-control-examples"></a>3.4.4.1. Common Applications of Group Controls</h4></div></div></div><p>
+        The use of groups is best explained by providing examples that illustrate
+        configurations for common use cases. The examples follow a common syntax:
+        <span class="emphasis"><em>Group: Entry, MemberControl, OtherControl, CanEdit,
+        EditComponents, CanConfirm, EditBugs</em></span>. Where "Group" is the name
+        of the group being edited for this product. The other fields all
+        correspond to the table on the "Edit Group Access Controls" page. If any
+        of these options are not listed, it means they are not checked.      
+      </p><p>
+            Basic Product/Group Restriction
+          </p><p>
+          Suppose there is a product called "Bar". The 
+          "Bar" product can only have bugs entered against it by users in the
+          group "Foo". Additionally, bugs filed against product "Bar" must stay
+          restricted to users to "Foo" at all times. Furthermore, only members
+          of group "Foo" can edit bugs filed against product "Bar", even if other
+          users could see the bug. This arrangement would achieved by the
+          following:
+        </p><pre class="programlisting">
+Product Bar: 
+foo: ENTRY, MANDATORY/MANDATORY, CANEDIT
+        </pre><p>
+          Perhaps such strict restrictions are not needed for product "Bar". A 
+          more lenient way to configure product "Bar" and group "Foo" would be:
+        </p><pre class="programlisting">
+Product Bar: 
+foo: ENTRY, SHOWN/SHOWN, EDITCOMPONENTS, CANCONFIRM, EDITBUGS
+        </pre><p>
+          The above indicates that for product "Bar", members of group "Foo" can
+          enter bugs. Any one with permission to edit a bug against product "Bar"
+          can put the bug
+          in group "Foo", even if they themselves are not in "Foo". Anyone in group
+          "Foo" can edit all aspects of the components of product "Bar", can confirm
+          bugs against product "Bar", and can edit all fields of any bug against
+          product "Bar".
+        </p><p>
+            General User Access With Security Group
+          </p><p>
+               To permit any user to file bugs against "Product A",
+               and to permit any user to submit those bugs into a
+               group called "Security":  
+            </p><pre class="programlisting"> 
+Product A:
+security: SHOWN/SHOWN
+      </pre><p>
+            General User Access With A Security Product
+          </p><p>
+            To permit any user to file bugs against product called "Security"
+            while keeping those bugs from becoming visible to anyone
+            outside the group "SecurityWorkers" (unless a member of the
+            "SecurityWorkers" group removes that restriction):
+          </p><pre class="programlisting"> 
+Product Security:
+securityworkers: DEFAULT/MANDATORY
+          </pre><p>
+            Product Isolation With a Common Group
+          </p><p>
+            To permit users of "Product A" to access the bugs for
+            "Product A", users of "Product B" to access the bugs for 
+            "Product B", and support staff, who are members of the "Support 
+            Group" to access both, three groups are needed:
+          </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Support Group: Contains members of the support staff.</p></li><li class="listitem"><p>AccessA Group: Contains users of product A and the Support group.</p></li><li class="listitem"><p>AccessB Group: Contains users of product B and the Support group.</p></li></ol></div><p>
+            Once these three groups are defined, the product group controls
+            can be set to:
+          </p><pre class="programlisting">
+Product A:
+AccessA: ENTRY, MANDATORY/MANDATORY
+Product B:
+AccessB: ENTRY, MANDATORY/MANDATORY
+        </pre><p>
+         Perhaps the "Support Group" wants more control. For example, 
+         the "Support Group"  could be permitted to make bugs inaccessible to 
+         users of both groups "AccessA" and "AccessB". 
+         Then, the "Support Group" could be permitted to publish
+         bugs relevant to all users in a third product (let's call it 
+         "Product Common") that is read-only
+         to anyone outside the "Support Group". In this way the "Support Group" 
+         could control bugs that should be seen by both groups. 
+         That configuration would be:
+        </p><pre class="programlisting">
+Product A:
+AccessA: ENTRY, MANDATORY/MANDATORY
+Support: SHOWN/NA
+Product B:
+AccessB: ENTRY, MANDATORY/MANDATORY
+Support: SHOWN/NA
+Product Common:
+Support: ENTRY, DEFAULT/MANDATORY, CANEDIT
+      </pre><p>
+            Make a Product Read Only
+          </p><p>
+            Sometimes a product is retired and should no longer have
+            new bugs filed against it (for example, an older version of a software
+            product that is no longer supported). A product can be made read-only
+            by creating a group called "readonly" and adding products to the
+            group as needed:
+          </p><pre class="programlisting">
+Product A:
+ReadOnly: ENTRY, NA/NA, CANEDIT
+         </pre><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            For more information on Groups outside of how they relate to products
+            see <a class="xref" href="#groups" title="3.15. Groups and Group Security">Section 3.15, “Groups and Group Security”</a>.
+          </p></td></tr></table></div></div></div></div><div class="section" title="3.5. Components"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="components"></a>3.5. Components</h2></div></div></div><p>Components are subsections of a Product. E.g. the computer game 
+    you are designing may have a "UI"
+    component, an "API" component, a "Sound System" component, and a
+    "Plugins" component, each overseen by a different programmer. It
+    often makes sense to divide Components in Bugzilla according to the
+    natural divisions of responsibility within your Product or
+    company.</p><p>
+    Each component has a default assignee and (if you turned it on in the parameters),
+    a QA Contact. The default assignee should be the primary person who fixes bugs in
+    that component. The QA Contact should be the person who will ensure
+    these bugs are completely fixed. The Assignee, QA Contact, and Reporter
+    will get email when new bugs are created in this Component and when
+    these bugs change. Default Assignee and Default QA Contact fields only
+    dictate the 
+    <span class="emphasis"><em>default assignments</em></span>; 
+    these can be changed on bug submission, or at any later point in
+    a bug's life.</p><p>To create a new Component:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Select the <span class="quote">“<span class="quote">Edit components</span>”</span> link 
+        from the <span class="quote">“<span class="quote">Edit product</span>”</span> page</p></li><li class="listitem"><p>Select the <span class="quote">“<span class="quote">Add</span>”</span> link in the bottom right.</p></li><li class="listitem"><p>Fill out the <span class="quote">“<span class="quote">Component</span>”</span> field, a 
+        short <span class="quote">“<span class="quote">Description</span>”</span>, the 
+        <span class="quote">“<span class="quote">Default Assignee</span>”</span>, <span class="quote">“<span class="quote">Default CC List</span>”</span> 
+        and <span class="quote">“<span class="quote">Default QA Contact</span>”</span> (if enabled). 
+        The <span class="quote">“<span class="quote">Component Description</span>”</span> field may contain a 
+        limited subset of HTML tags. The <span class="quote">“<span class="quote">Default Assignee</span>”</span> 
+        field must be a login name already existing in the Bugzilla database. 
+        </p></li></ol></div></div><div class="section" title="3.6. Versions"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="versions"></a>3.6. Versions</h2></div></div></div><p>Versions are the revisions of the product, such as "Flinders
+    3.1", "Flinders 95", and "Flinders 2000". Version is not a multi-select
+    field; the usual practice is to select the earliest version known to have
+    the bug.
+    </p><p>To create and edit Versions:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>From the "Edit product" screen, select "Edit Versions"</p></li><li class="listitem"><p>You will notice that the product already has the default
+        version "undefined". Click the "Add" link in the bottom right.</p></li><li class="listitem"><p>Enter the name of the Version. This field takes text only. 
+        Then click the "Add" button.</p></li></ol></div></div><div class="section" title="3.7. Milestones"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="milestones"></a>3.7. Milestones</h2></div></div></div><p>Milestones are "targets" that you plan to get a bug fixed by. For
+    example, you have a bug that you plan to fix for your 3.0 release, it
+    would be assigned the milestone of 3.0.</p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Milestone options will only appear for a Product if you turned
+      on the "usetargetmilestone" parameter in the "Bug Fields" tab of the
+      "Parameters" page.
+      </p></td></tr></table></div><p>To create new Milestones, and set Default Milestones:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Select "Edit milestones" from the "Edit product" page.</p></li><li class="listitem"><p>Select "Add" in the bottom right corner.</p></li><li class="listitem"><p>Enter the name of the Milestone in the "Milestone" field. You
+        can optionally set the "sortkey", which is a positive or negative
+        number (-32768 to 32767) that defines where in the list this particular
+        milestone appears. This is because milestones often do not 
+        occur in alphanumeric order For example, "Future" might be
+        after "Release 1.2". Select "Add".</p></li></ol></div></div><div class="section" title="3.8. Flags"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="flags-overview"></a>3.8. Flags</h2></div></div></div><p>
+     Flags are a way to attach a specific status to a bug or attachment, 
+     either <span class="quote">“<span class="quote">+</span>”</span> or <span class="quote">“<span class="quote">-</span>”</span>. The meaning of these symbols depends on the text
+     the flag itself, but contextually they could mean pass/fail, 
+     accept/reject, approved/denied, or even a simple yes/no. If your site
+     allows requestable flags, then users may set a flag to <span class="quote">“<span class="quote">?</span>”</span> as a 
+     request to another user that they look at the bug/attachment, and set
+     the flag to its correct status.
+   </p><div class="section" title="3.8.1. A Simple Example"><div class="titlepage"><div><div><h3 class="title"><a name="flags-simpleexample"></a>3.8.1. A Simple Example</h3></div></div></div><p>
+       A developer might want to ask their manager, 
+       <span class="quote">“<span class="quote">Should we fix this bug before we release version 2.0?</span>”</span> 
+       They might want to do this for a <span class="emphasis"><em>lot</em></span> of bugs,
+       so it would be nice to streamline the process...
+     </p><p>
+       In Bugzilla, it would work this way:
+       </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+             The Bugzilla administrator creates a flag type called 
+             <span class="quote">“<span class="quote">blocking2.0</span>”</span> that shows up on all bugs in 
+             your product.
+           </p><p>
+             It shows up on the <span class="quote">“<span class="quote">Show Bug</span>”</span> screen
+             as the text <span class="quote">“<span class="quote">blocking2.0</span>”</span> with a drop-down box next
+             to it. The drop-down box contains four values: an empty space,
+             <span class="quote">“<span class="quote">?</span>”</span>, <span class="quote">“<span class="quote">-</span>”</span>, and <span class="quote">“<span class="quote">+</span>”</span>.
+           </p></li><li class="listitem"><p>The developer sets the flag to <span class="quote">“<span class="quote">?</span>”</span>.</p></li><li class="listitem"><p>
+             The manager sees the <code class="computeroutput">blocking2.0</code>
+             flag with a <span class="quote">“<span class="quote">?</span>”</span> value.
+           </p></li><li class="listitem"><p>
+             If the manager thinks the feature should go into the product
+             before version 2.0 can be released, he sets the flag to 
+             <span class="quote">“<span class="quote">+</span>”</span>. Otherwise, he sets it to <span class="quote">“<span class="quote">-</span>”</span>.
+           </p></li><li class="listitem"><p>
+             Now, every Bugzilla user who looks at the bug knows whether or 
+             not the bug needs to be fixed before release of version 2.0.
+           </p></li></ol></div><p>
+     </p></div><div class="section" title="3.8.2. About Flags"><div class="titlepage"><div><div><h3 class="title"><a name="flags-about"></a>3.8.2. About Flags</h3></div></div></div><div class="section" title="3.8.2.1. Values"><div class="titlepage"><div><div><h4 class="title"><a name="flag-values"></a>3.8.2.1. Values</h4></div></div></div><p>
+         Flags can have three values:
+         </p><div class="variablelist"><dl><dt><span class="term"><code class="computeroutput">?</code></span></dt><dd>
+               A user is requesting that a status be set. (Think of it as 'A question is being asked'.)
+             </dd><dt><span class="term"><code class="computeroutput">-</code></span></dt><dd>
+               The status has been set negatively. (The question has been answered <span class="quote">“<span class="quote">no</span>”</span>.)
+             </dd><dt><span class="term"><code class="computeroutput">+</code></span></dt><dd>
+               The status has been set positively.
+               (The question has been answered <span class="quote">“<span class="quote">yes</span>”</span>.)
+             </dd></dl></div><p>
+       </p><p>
+         Actually, there's a fourth value a flag can have -- 
+         <span class="quote">“<span class="quote">unset</span>”</span> -- which shows up as a blank space. This 
+         just means that nobody has expressed an opinion (or asked
+         someone else to express an opinion) about this bug or attachment.
+       </p></div></div><div class="section" title="3.8.3. Using flag requests"><div class="titlepage"><div><div><h3 class="title"><a name="flag-askto"></a>3.8.3. Using flag requests</h3></div></div></div><p>
+       If a flag has been defined as 'requestable', and a user has enough privileges
+       to request it (see below), the user can set the flag's status to <span class="quote">“<span class="quote">?</span>”</span>.
+       This status indicates that someone (a.k.a. <span class="quote">“<span class="quote">the requester</span>”</span>) is asking
+       someone else to set the flag to either <span class="quote">“<span class="quote">+</span>”</span> or <span class="quote">“<span class="quote">-</span>”</span>.
+     </p><p>
+       If a flag has been defined as 'specifically requestable', 
+       a text box will appear next to the flag into which the requester may
+       enter a Bugzilla username. That named person (a.k.a. <span class="quote">“<span class="quote">the requestee</span>”</span>)
+       will receive an email notifying them of the request, and pointing them
+       to the bug/attachment in question.
+     </p><p>
+       If a flag has <span class="emphasis"><em>not</em></span> been defined as 'specifically requestable',
+       then no such text-box will appear. A request to set this flag cannot be made of
+       any specific individual, but must be asked <span class="quote">“<span class="quote">to the wind</span>”</span>.
+       A requester may <span class="quote">“<span class="quote">ask the wind</span>”</span> on any flag simply by leaving the text-box blank.
+     </p></div><div class="section" title="3.8.4. Two Types of Flags"><div class="titlepage"><div><div><h3 class="title"><a name="flag-types"></a>3.8.4. Two Types of Flags</h3></div></div></div><p>
+       Flags can go in two places: on an attachment, or on a bug.
+     </p><div class="section" title="3.8.4.1. Attachment Flags"><div class="titlepage"><div><div><h4 class="title"><a name="flag-type-attachment"></a>3.8.4.1. Attachment Flags</h4></div></div></div><p>
+         Attachment flags are used to ask a question about a specific 
+         attachment on a bug.
+       </p><p>
+         Many Bugzilla installations use this to 
+         request that one developer <span class="quote">“<span class="quote">review</span>”</span> another 
+         developer's code before they check it in. They attach the code to
+         a bug report, and then set a flag on that attachment called
+         <span class="quote">“<span class="quote">review</span>”</span> to 
+         <code class="computeroutput">review?boss@domain.com</code>.
+         boss@domain.com is then notified by email that
+         he has to check out that attachment and approve it or deny it.
+       </p><p>
+         For a Bugzilla user, attachment flags show up in three places:
+         </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+               On the list of attachments in the <span class="quote">“<span class="quote">Show Bug</span>”</span>
+               screen, you can see the current state of any flags that
+               have been set to ?, +, or -. You can see who asked about 
+               the flag (the requester), and who is being asked (the 
+               requestee).
+             </p></li><li class="listitem"><p>
+              When you <span class="quote">“<span class="quote">Edit</span>”</span> an attachment, you can 
+              see any settable flag, along with any flags that have 
+              already been set. This <span class="quote">“<span class="quote">Edit Attachment</span>”</span> 
+              screen is where you set flags to ?, -, +, or unset them.
+             </p></li><li class="listitem"><p>
+               Requests are listed in the <span class="quote">“<span class="quote">Request Queue</span>”</span>, which
+               is accessible from the <span class="quote">“<span class="quote">My Requests</span>”</span> link (if you are
+               logged in) or <span class="quote">“<span class="quote">Requests</span>”</span> link (if you are logged out)
+               visible in the footer of all pages.
+             </p></li></ol></div><p>
+       </p></div><div class="section" title="3.8.4.2. Bug Flags"><div class="titlepage"><div><div><h4 class="title"><a name="flag-type-bug"></a>3.8.4.2. Bug Flags</h4></div></div></div><p>
+         Bug flags are used to set a status on the bug itself. You can 
+         see Bug Flags in the <span class="quote">“<span class="quote">Show Bug</span>”</span> and <span class="quote">“<span class="quote">Requests</span>”</span>
+         screens, as described above.
+       </p><p>
+         Only users with enough privileges (see below) may set flags on bugs.
+         This doesn't necessarily include the assignee, reporter, or users with the
+         <code class="computeroutput">editbugs</code> permission.
+       </p></div></div><div class="section" title="3.8.5. Administering Flags"><div class="titlepage"><div><div><h3 class="title"><a name="flags-admin"></a>3.8.5. Administering Flags</h3></div></div></div><p>
+       If you have the <span class="quote">“<span class="quote">editcomponents</span>”</span> permission, you can
+       edit Flag Types from the main administration page. Clicking the
+       <span class="quote">“<span class="quote">Flags</span>”</span> link will bring you to the <span class="quote">“<span class="quote">Administer
+       Flag Types</span>”</span> page. Here, you can select whether you want 
+       to create (or edit) a Bug flag, or an Attachment flag.
+     </p><p>
+       No matter which you choose, the interface is the same, so we'll 
+       just go over it once.
+     </p><div class="section" title="3.8.5.1. Editing a Flag"><div class="titlepage"><div><div><h4 class="title"><a name="flags-edit"></a>3.8.5.1. Editing a Flag</h4></div></div></div><p>
+         To edit a flag's properties, just click the flag's name.
+         That will take you to the same
+         form as described below (<a class="xref" href="#flags-create" title="3.8.5.2. Creating a Flag">Section 3.8.5.2, “Creating a Flag”</a>).
+       </p></div><div class="section" title="3.8.5.2. Creating a Flag"><div class="titlepage"><div><div><h4 class="title"><a name="flags-create"></a>3.8.5.2. Creating a Flag</h4></div></div></div><p>
+          When you click on the <span class="quote">“<span class="quote">Create a Flag Type for...</span>”</span>
+          link, you will be presented with a form. Here is what the fields in 
+          the form mean:
+        </p><div class="section" title="3.8.5.2.1. Name"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-field-name"></a>3.8.5.2.1. Name</h5></div></div></div><p>
+            This is the name of the flag. This will be displayed 
+            to Bugzilla users who are looking at or setting the flag. 
+            The name may contain any valid Unicode characters except commas
+            and spaces.
+          </p></div><div class="section" title="3.8.5.2.2. Description"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-field-description"></a>3.8.5.2.2. Description</h5></div></div></div><p>
+            The description describes the flag in more detail. It is visible
+            in a tooltip when hovering over a flag either in the <span class="quote">“<span class="quote">Show Bug</span>”</span>
+            or <span class="quote">“<span class="quote">Edit Attachment</span>”</span> pages. This field can be as
+            long as you like, and can contain any character you want.
+          </p></div><div class="section" title="3.8.5.2.3. Category"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-field-category"></a>3.8.5.2.3. Category</h5></div></div></div><p>
+            Default behaviour for a newly-created flag is to appear on
+            products and all components, which is why <span class="quote">“<span class="quote">__Any__:__Any__</span>”</span>
+            is already entered in the <span class="quote">“<span class="quote">Inclusions</span>”</span> box.
+            If this is not your desired behaviour, you must either set some
+            exclusions (for products on which you don't want the flag to appear),
+            or you must remove <span class="quote">“<span class="quote">__Any__:__Any__</span>”</span> from the Inclusions box
+            and define products/components specifically for this flag.
+          </p><p>
+            To create an Inclusion, select a Product from the top drop-down box.
+            You may also select a specific component from the bottom drop-down box.
+            (Setting <span class="quote">“<span class="quote">__Any__</span>”</span> for Product translates to, 
+            <span class="quote">“<span class="quote">all the products in this Bugzilla</span>”</span>.
+            Selecting  <span class="quote">“<span class="quote">__Any__</span>”</span> in the Component field means
+            <span class="quote">“<span class="quote">all components in the selected product.</span>”</span>) 
+            Selections made, press <span class="quote">“<span class="quote">Include</span>”</span>, and your
+            Product/Component pairing will show up in the <span class="quote">“<span class="quote">Inclusions</span>”</span> box on the right.
+          </p><p>
+            To create an Exclusion, the process is the same; select a Product from the
+            top drop-down box, select a specific component if you want one, and press
+            <span class="quote">“<span class="quote">Exclude</span>”</span>. The Product/Component pairing will show up in the 
+            <span class="quote">“<span class="quote">Exclusions</span>”</span> box on the right.
+          </p><p>
+            This flag <span class="emphasis"><em>will</em></span> and <span class="emphasis"><em>can</em></span> be set for any
+            products/components that appearing in the <span class="quote">“<span class="quote">Inclusions</span>”</span> box 
+            (or which fall under the appropriate <span class="quote">“<span class="quote">__Any__</span>”</span>). 
+            This flag <span class="emphasis"><em>will not</em></span> appear (and therefore cannot be set) on
+            any products appearing in the <span class="quote">“<span class="quote">Exclusions</span>”</span> box.
+            <span class="emphasis"><em> IMPORTANT: Exclusions override inclusions.</em></span>
+          </p><p>
+            You may select a Product without selecting a specific Component,
+            but you can't select a Component without a Product, or to select a
+            Component that does not belong to the named Product. If you do so,
+            Bugzilla will display an error message, even if all your products
+            have a component by that name.
+          </p><p><span class="emphasis"><em>Example:</em></span> Let's say you have a product called 
+            <span class="quote">“<span class="quote">Jet Plane</span>”</span> that has thousands of components. You want
+            to be able to ask if a problem should be fixed in the next model of 
+            plane you release. We'll call the flag <span class="quote">“<span class="quote">fixInNext</span>”</span>.
+            But, there's one component in <span class="quote">“<span class="quote">Jet Plane,</span>”</span> 
+            called <span class="quote">“<span class="quote">Pilot.</span>”</span> It doesn't make sense to release a 
+            new pilot, so you don't want to have the flag show up in that component.
+            So, you include <span class="quote">“<span class="quote">Jet Plane:__Any__</span>”</span> and you exclude 
+            <span class="quote">“<span class="quote">Jet Plane:Pilot</span>”</span>.
+          </p></div><div class="section" title="3.8.5.2.4. Sort Key"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-field-sortkey"></a>3.8.5.2.4. Sort Key</h5></div></div></div><p>
+            Flags normally show up in alphabetical order. If you want them to 
+            show up in a different order, you can use this key set the order on each flag. 
+            Flags with a lower sort key will appear before flags with a higher
+            sort key. Flags that have the same sort key will be sorted alphabetically,
+            but they will still be after flags with a lower sort key, and before flags
+            with a higher sort key.
+          </p><p>
+            <span class="emphasis"><em>Example:</em></span> I have AFlag (Sort Key 100), BFlag (Sort Key 10), 
+            CFlag (Sort Key 10), and DFlag (Sort Key 1). These show up in
+            the order: DFlag, BFlag, CFlag, AFlag.
+          </p></div><div class="section" title="3.8.5.2.5. Active"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-field-active"></a>3.8.5.2.5. Active</h5></div></div></div><p>
+            Sometimes, you might want to keep old flag information in the 
+            Bugzilla database, but stop users from setting any new flags of this type.
+            To do this, uncheck <span class="quote">“<span class="quote">active</span>”</span>. Deactivated
+            flags will still show up in the UI if they are ?, +, or -, but they
+            may only be cleared (unset), and cannot be changed to a new value.
+            Once a deactivated flag is cleared, it will completely disappear from a 
+            bug/attachment, and cannot be set again.
+          </p></div><div class="section" title="3.8.5.2.6. Requestable"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-field-requestable"></a>3.8.5.2.6. Requestable</h5></div></div></div><p>
+            New flags are, by default, <span class="quote">“<span class="quote">requestable</span>”</span>, meaning that they
+            offer users the <span class="quote">“<span class="quote">?</span>”</span> option, as well as <span class="quote">“<span class="quote">+</span>”</span>
+            and <span class="quote">“<span class="quote">-</span>”</span>.
+            To remove the ? option, uncheck <span class="quote">“<span class="quote">requestable</span>”</span>.
+          </p></div><div class="section" title="3.8.5.2.7. Specifically Requestable"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-field-specific"></a>3.8.5.2.7. Specifically Requestable</h5></div></div></div><p>
+            By default this box is checked for new flags, meaning that users may make
+            flag requests of specific individuals. Unchecking this box will remove the
+            text box next to a flag; if it is still requestable, then requests may
+            only be made <span class="quote">“<span class="quote">to the wind.</span>”</span> Removing this after specific
+            requests have been made will not remove those requests; that data will
+            stay in the database (though it will no longer appear to the user).
+          </p></div><div class="section" title="3.8.5.2.8. Multiplicable"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-field-multiplicable"></a>3.8.5.2.8. Multiplicable</h5></div></div></div><p>
+            Any flag with <span class="quote">“<span class="quote">Multiplicable</span>”</span> set (default for new flags is 'on')
+            may be set more than once. After being set once, an unset flag
+            of the same type will appear below it with <span class="quote">“<span class="quote">addl.</span>”</span> (short for 
+            <span class="quote">“<span class="quote">additional</span>”</span>) before the name. There is no limit to the number of
+            times a Multiplicable flags may be set on the same bug/attachment.
+          </p></div><div class="section" title="3.8.5.2.9. CC List"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-field-cclist"></a>3.8.5.2.9. CC List</h5></div></div></div><p>
+            If you want certain users to be notified every time this flag is 
+            set to ?, -, +, or unset, add them here. This is a comma-separated 
+            list of email addresses that need not be restricted to Bugzilla usernames.
+          </p></div><div class="section" title="3.8.5.2.10. Grant Group"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-grant-group"></a>3.8.5.2.10. Grant Group</h5></div></div></div><p>
+            When this field is set to some given group, only users in the group
+            can set the flag to <span class="quote">“<span class="quote">+</span>”</span> and <span class="quote">“<span class="quote">-</span>”</span>. This
+            field does not affect who can request or cancel the flag. For that,
+            see the <span class="quote">“<span class="quote">Request Group</span>”</span> field below. If this field
+            is left blank, all users can set or delete this flag. This field is
+            useful for restricting which users can approve or reject requests.
+          </p></div><div class="section" title="3.8.5.2.11. Request Group"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-request-group"></a>3.8.5.2.11. Request Group</h5></div></div></div><p>
+            When this field is set to some given group, only users in the group
+            can request or cancel this flag. Note that this field has no effect
+            if the <span class="quote">“<span class="quote">grant group</span>”</span> field is empty. You can set the
+            value of this field to a different group, but both fields have to be
+            set to a group for this field to have an effect.
+          </p></div></div><div class="section" title="3.8.5.3. Deleting a Flag"><div class="titlepage"><div><div><h4 class="title"><a name="flags-delete"></a>3.8.5.3. Deleting a Flag</h4></div></div></div><p>
+          When you are at the <span class="quote">“<span class="quote">Administer Flag Types</span>”</span> screen,
+          you will be presented with a list of Bug flags and a list of Attachment
+          Flags.
+        </p><p>
+          To delete a flag, click on the <span class="quote">“<span class="quote">Delete</span>”</span> link next to
+          the flag description.
+        </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            Once you delete a flag, it is <span class="emphasis"><em>gone</em></span> from
+            your Bugzilla. All the data for that flag will be deleted.
+            Everywhere that flag was set, it will disappear,
+            and you cannot get that data back. If you want to keep flag data,
+            but don't want anybody to set any new flags or change current flags,
+            unset <span class="quote">“<span class="quote">active</span>”</span> in the flag Edit form.
+          </p></td></tr></table></div></div></div></div><div class="section" title="3.9. Keywords"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="keywords"></a>3.9. Keywords</h2></div></div></div><p>
+    The administrator can define keywords which can be used to tag and
+    categorise bugs. For example, the keyword "regression" is commonly used.
+    A company might have a policy stating all regressions
+    must be fixed by the next release - this keyword can make tracking those
+    bugs much easier.
+    </p><p>
+    Keywords are global, rather than per-product. If the administrator changes
+    a keyword currently applied to any bugs, the keyword cache must be rebuilt
+    using the <a class="xref" href="#sanitycheck" title="3.16. Checking and Maintaining Database Integrity">Section 3.16, “Checking and Maintaining Database Integrity”</a> script. Currently keywords cannot
+    be marked obsolete to prevent future usage.
+    </p><p>
+    Keywords can be created, edited or deleted by clicking the "Keywords"
+    link in the admin page. There are two fields for each keyword - the keyword
+    itself and a brief description. Once created, keywords can be selected
+    and applied to individual bugs in that bug's "Details" section.
+    </p></div><div class="section" title="3.10. Custom Fields"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="custom-fields"></a>3.10. Custom Fields</h2></div></div></div><p>
+      The release of Bugzilla 3.0 added the ability to create Custom Fields. 
+      Custom Fields are treated like any other field - they can be set in bugs
+      and used for search queries. Administrators should keep in mind that
+      adding too many fields can make the user interface more complicated and
+      harder to use. Custom Fields should be added only when necessary and with 
+      careful consideration.
+    </p><div class="tip" title="Tip" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../images/tip.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        Before adding a Custom Field, make sure that Bugzilla cannot already
+        do the desired behavior. Many Bugzilla options are not enabled by 
+        default, and many times Administrators find that simply enabling
+        certain options that already exist is sufficient. 
+      </p></td></tr></table></div><p>
+      Administrators can manage Custom Fields using the
+      <span class="quote">“<span class="quote">Custom Fields</span>”</span> link on the Administration page. The Custom
+      Fields administration page displays a list of Custom Fields, if any exist,
+      and a link to "Add a new custom field". 
+    </p><div class="section" title="3.10.1. Adding Custom Fields"><div class="titlepage"><div><div><h3 class="title"><a name="add-custom-fields"></a>3.10.1. Adding Custom Fields</h3></div></div></div><p>
+        To add a new Custom Field, click the "Add a new custom field" link. This
+        page displays several options for the new field, described below.
+      </p><p>
+        The following attributes must be set for each new custom field:
+        </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
+              <span class="emphasis"><em>Name:</em></span>
+              The name of the field in the database, used internally. This name 
+              MUST begin with <span class="quote">“<span class="quote">cf_</span>”</span> to prevent confusion with 
+              standard fields. If this string is omitted, it will
+              be automatically added to the name entered. 
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Description:</em></span>
+              A brief string which is used as the label for this Custom Field.
+              That is the string that users will see, and should be
+              short and explicit.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Type:</em></span>
+              The type of field to create. There are
+              several types available:
+              </p><div class="variablelist"><dl><dt><span class="term">Bug ID:</span></dt><dd><p>
+                      A field where you can enter the ID of another bug from
+                      the same Bugzilla installation. To point to a bug in a remote
+                      installation, use the See Also field instead.
+                    </p></dd><dt><span class="term">Large Text Box:</span></dt><dd><p>
+                      A multiple line box for entering free text.
+                    </p></dd><dt><span class="term">Free Text:</span></dt><dd><p>
+                      A single line box for entering free text.
+                    </p></dd><dt><span class="term">Multiple-Selection Box:</span></dt><dd><p>
+                      A list box where multiple options
+                      can be selected. After creating this field, it must be edited
+                      to add the selection options. See
+                      <a class="xref" href="#edit-values-list" title="3.11.1. Viewing/Editing legal values">Section 3.11.1, “Viewing/Editing legal values”</a> for information about
+                      editing legal values.
+                    </p></dd><dt><span class="term">Drop Down:</span></dt><dd><p>
+                      A list box where only one option can be selected.
+                      After creating this field, it must be edited to add the
+                      selection options. See
+                      <a class="xref" href="#edit-values-list" title="3.11.1. Viewing/Editing legal values">Section 3.11.1, “Viewing/Editing legal values”</a> for information about
+                      editing legal values.
+                    </p></dd><dt><span class="term">Date/Time:</span></dt><dd><p>
+                      A date field. This field appears with a
+                      calendar widget for choosing the date.
+                    </p></dd></dl></div><p>
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Sortkey:</em></span>
+              Integer that determines in which order Custom Fields are
+              displayed in the User Interface, especially when viewing a bug. 
+              Fields with lower values are displayed first.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Reverse Relationship Description:</em></span>
+              When the custom field is of type <span class="quote">“<span class="quote">Bug ID</span>”</span>, you can
+              enter text here which will be used as label in the referenced
+              bug to list bugs which point to it. This gives you the ability
+              to have a mutual relationship between two bugs.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Can be set on bug creation:</em></span>
+              Boolean that determines whether this field can be set on
+              bug creation. If not selected, then a bug must be created 
+              before this field can be set. See <a class="xref" href="#bugreports" title="5.6. Filing Bugs">Section 5.6, “Filing Bugs”</a> 
+              for information about filing bugs.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Displayed in bugmail for new bugs:</em></span>
+              Boolean that determines whether the value set on this field
+              should appear in bugmail when the bug is filed. This attribute
+              has no effect if the field cannot be set on bug creation.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Is obsolete:</em></span>
+              Boolean that determines whether this field should
+              be displayed at all. Obsolete Custom Fields are hidden.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Is mandatory:</em></span>
+              Boolean that determines whether this field must be set.
+              For single and multi-select fields, this means that a (non-default)
+              value must be selected, and for text and date fields, some text
+              must be entered.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Field only appears when:</em></span>
+              A custom field can be made visible when some criteria is met.
+              For instance, when the bug belongs to one or more products,
+              or when the bug is of some given severity. If left empty, then
+              the custom field will always be visible, in all bugs.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Field that controls the values that appear in this field:</em></span>
+              When the custom field is of type <span class="quote">“<span class="quote">Drop Down</span>”</span> or
+              <span class="quote">“<span class="quote">Multiple-Selection Box</span>”</span>, you can restrict the
+              availability of the values of the custom field based on the
+              value of another field. This criteria is independent of the
+              criteria used in the <span class="quote">“<span class="quote">Field only appears when</span>”</span>
+              setting. For instance, you may decide that some given value
+              <span class="quote">“<span class="quote">valueY</span>”</span> is only available when the bug status
+              is RESOLVED while the value <span class="quote">“<span class="quote">valueX</span>”</span> should
+              always be listed.
+              Once you have selected the field which should control the
+              availability of the values of this custom field, you can
+              edit values of this custom field to set the criteria, see
+              <a class="xref" href="#edit-values-list" title="3.11.1. Viewing/Editing legal values">Section 3.11.1, “Viewing/Editing legal values”</a>.
+            </p></li></ul></div><p>
+      </p></div><div class="section" title="3.10.2. Editing Custom Fields"><div class="titlepage"><div><div><h3 class="title"><a name="edit-custom-fields"></a>3.10.2. Editing Custom Fields</h3></div></div></div><p>
+        As soon as a Custom Field is created, its name and type cannot be
+        changed. If this field is a drop down menu, its legal values can
+        be set as described in <a class="xref" href="#edit-values-list" title="3.11.1. Viewing/Editing legal values">Section 3.11.1, “Viewing/Editing legal values”</a>. All
+        other attributes can be edited as described above.
+      </p></div><div class="section" title="3.10.3. Deleting Custom Fields"><div class="titlepage"><div><div><h3 class="title"><a name="delete-custom-fields"></a>3.10.3. Deleting Custom Fields</h3></div></div></div><p>
+        Only custom fields which are marked as obsolete, and which never
+        have been used, can be deleted completely (else the integrity
+        of the bug history would be compromised). For custom fields marked
+        as obsolete, a "Delete" link will appear in the <span class="quote">“<span class="quote">Action</span>”</span>
+        column. If the custom field has been used in the past, the deletion
+        will be rejected. But marking the field as obsolete is sufficient
+        to hide it from the user interface entirely.
+      </p></div></div><div class="section" title="3.11. Legal Values"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="edit-values"></a>3.11. Legal Values</h2></div></div></div><p>
+      Legal values for the operating system, platform, bug priority and
+      severity, custom fields of type <span class="quote">“<span class="quote">Drop Down</span>”</span> and
+      <span class="quote">“<span class="quote">Multiple-Selection Box</span>”</span> (see <a class="xref" href="#custom-fields" title="3.10. Custom Fields">Section 3.10, “Custom Fields”</a>),
+      as well as the list of valid bug statuses and resolutions can be
+      customized from the same interface. You can add, edit, disable and
+      remove values which can be used with these fields.
+    </p><div class="section" title="3.11.1. Viewing/Editing legal values"><div class="titlepage"><div><div><h3 class="title"><a name="edit-values-list"></a>3.11.1. Viewing/Editing legal values</h3></div></div></div><p>
+        Editing legal values requires <span class="quote">“<span class="quote">admin</span>”</span> privileges.
+        Select "Field Values" from the Administration page. A list of all
+        fields, both system fields and Custom Fields, for which legal values
+        can be edited appears. Click a field name to edit its legal values.
+      </p><p>
+        There is no limit to how many values a field can have, but each value 
+        must be unique to that field. The sortkey is important to display these
+        values in the desired order.
+      </p><p>
+        When the availability of the values of a custom field is controlled
+        by another field, you can select from here which value of the other field
+        must be set for the value of the custom field to appear.
+      </p></div><div class="section" title="3.11.2. Deleting legal values"><div class="titlepage"><div><div><h3 class="title"><a name="edit-values-delete"></a>3.11.2. Deleting legal values</h3></div></div></div><p>
+        Legal values from Custom Fields can be deleted, but only if the 
+        following two conditions are respected:
+      </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>The value is not used by default for the field.</p></li><li class="listitem"><p>No bug is currently using this value.</p></li></ol></div><p>
+        If any of these conditions is not respected, the value cannot be deleted.
+       The only way to delete these values is to reassign bugs to another value
+       and to set another value as default for the field.
+      </p></div></div><div class="section" title="3.12. Bug Status Workflow"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="bug_status_workflow"></a>3.12. Bug Status Workflow</h2></div></div></div><p>
+      The bug status workflow is no longer hardcoded but can be freely customized
+      from the web interface. Only one bug status cannot be renamed nor deleted,
+      UNCONFIRMED, but the workflow involving it is free. The configuration
+      page displays all existing bug statuses twice, first on the left for bug
+      statuses we come from and on the top for bug statuses we move to.
+      If the checkbox is checked, then the transition between the two bug statuses
+      is legal, else it's forbidden independently of your privileges. The bug status
+      used for the "duplicate_or_move_bug_status" parameter must be part of the
+      workflow as that is the bug status which will be used when duplicating or
+      moving a bug, so it must be available from each bug status.
+    </p><p>
+      When the workflow is set, the "View Current Triggers" link below the table
+      lets you set which transitions require a comment from the user.
+    </p></div><div class="section" title="3.13. Voting"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="voting"></a>3.13. Voting</h2></div></div></div><p>All of the code for voting in Bugzilla has been moved into an
+    extension, called "Voting", in the <code class="filename">extensions/Voting/</code>
+    directory. To enable it, you must remove the <code class="filename">disabled</code>
+    file from that directory, and run <code class="filename">checksetup.pl</code>.</p><p>Voting allows users to be given a pot of votes which they can allocate
+    to bugs, to indicate that they'd like them fixed. 
+    This allows developers to gauge
+    user need for a particular enhancement or bugfix. By allowing bugs with
+    a certain number of votes to automatically move from "UNCONFIRMED" to
+    "CONFIRMED", users of the bug system can help high-priority bugs garner
+    attention so they don't sit for a long time awaiting triage.</p><p>To modify Voting settings:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Navigate to the "Edit product" screen for the Product you
+        wish to modify</p></li><li class="listitem"><p><span class="emphasis"><em>Maximum Votes per person</em></span>:
+        Setting this field to "0" disables voting.</p></li><li class="listitem"><p><span class="emphasis"><em>Maximum Votes a person can put on a single
+         bug</em></span>: 
+         It should probably be some number lower than the
+        "Maximum votes per person". Don't set this field to "0" if
+        "Maximum votes per person" is non-zero; that doesn't make
+        any sense.</p></li><li class="listitem"><p><span class="emphasis"><em>Number of votes a bug in this product needs to
+        automatically get out of the UNCONFIRMED state</em></span>: 
+        Setting this field to "0" disables the automatic move of
+        bugs from UNCONFIRMED to CONFIRMED. 
+        </p></li><li class="listitem"><p>Once you have adjusted the values to your preference, click
+        "Update".</p></li></ol></div></div><div class="section" title="3.14. Quips"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="quips"></a>3.14. Quips</h2></div></div></div><p>
+      Quips are small text messages that can be configured to appear
+      next to search results. A Bugzilla installation can have its own specific
+      quips. Whenever a quip needs to be displayed, a random selection
+      is made from the pool of already existing quips.
+    </p><p>
+      Quip submission is controlled by the <span class="emphasis"><em>quip_list_entry_control</em></span>
+      parameter.  It has several possible values: open, moderated, or closed.
+      In order to enable quips approval you need to set this parameter to
+      "moderated". In this way, users are free to submit quips for addition
+      but an administrator must explicitly approve them before they are
+      actually used.
+    </p><p>
+      In order to see the user interface for the quips, it is enough to click
+      on a quip when it is displayed together with the search results. Or
+      it can be seen directly in the browser by visiting the quips.cgi URL
+      (prefixed with the usual web location of the Bugzilla installation).
+      Once the quip interface is displayed, it is enough to click the
+      "view and edit the whole quip list" in order to see the administration
+      page. A page with all the quips available in the database will
+      be displayed.
+    </p><p>
+      Next to each quip there is a checkbox, under the
+      "Approved" column. Quips who have this checkbox checked are
+      already approved and will appear next to the search results.
+      The ones that have it unchecked are still preserved in the
+      database but they will not appear on search results pages.
+      User submitted quips have initially the checkbox unchecked.
+    </p><p>
+      Also, there is a delete link next to each quip,
+      which can be used in order to permanently delete a quip.
+    </p><p>
+      Display of quips is controlled by the <span class="emphasis"><em>display_quips</em></span>
+      user preference.  Possible values are "on" and "off".
+    </p></div><div class="section" title="3.15. Groups and Group Security"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="groups"></a>3.15. Groups and Group Security</h2></div></div></div><p>
+    Groups allow for separating bugs into logical divisions.
+    Groups are typically used
+    to isolate bugs that should only be seen by certain people. For
+    example, a company might create a different group for each one of its customers
+    or partners. Group permissions could be set so that each partner or customer would
+    only have access to their own bugs. Or, groups might be used to create
+    variable access controls for different departments within an organization.
+    Another common use of groups is to associate groups with products,
+    creating isolation and access control on a per-product basis.
+    </p><p>
+    Groups and group behaviors are controlled in several places:
+    </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+             The group configuration page. To view or edit existing groups, or to
+             create new groups, access the "Groups" link from the "Administration"
+             page. This section of the manual deals primarily with the aspect of
+             group controls accessed on this page.  
+           </p></li><li class="listitem"><p>
+            Global configuration parameters. Bugzilla has several parameters 
+            that control the overall default group behavior and restriction
+            levels. For more information on the parameters that control 
+            group behavior globally, see <a class="xref" href="#param-group-security" title="3.1.9. Group Security">Section 3.1.9, “Group Security”</a>.
+          </p></li><li class="listitem"><p>
+            Product association with groups. Most of the functionality of groups
+            and group security is controlled at the product level. Some aspects
+            of group access controls for products are discussed in this section,
+            but for more detail see <a class="xref" href="#product-group-controls" title="3.4.4. Assigning Group Controls to Products">Section 3.4.4, “Assigning Group Controls to Products”</a>.
+          </p></li><li class="listitem"><p>
+            Group access for users. See <a class="xref" href="#users-and-groups" title="3.15.3. Assigning Users to Groups">Section 3.15.3, “Assigning Users to Groups”</a> for
+            details on how users are assigned group access.
+          </p></li></ol></div><p>
+      Group permissions are such that if a bug belongs to a group, only members
+      of that group can see the bug. If a bug is in more than one group, only
+      members of <span class="emphasis"><em>all</em></span> the groups that the bug is in can see
+      the bug. For information on granting read-only access to certain people and
+      full edit access to others, see <a class="xref" href="#product-group-controls" title="3.4.4. Assigning Group Controls to Products">Section 3.4.4, “Assigning Group Controls to Products”</a>.
+     </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        By default, bugs can also be seen by the Assignee, the Reporter, and 
+        by everyone on the CC List, regardless of whether or not the bug would 
+        typically be viewable by them. Visibility to the Reporter and CC List can 
+        be overridden (on a per-bug basis) by bringing up the bug, finding the 
+        section that starts with <span class="quote">“<span class="quote">Users in the roles selected below...</span>”</span>
+        and un-checking the box next to either 'Reporter' or 'CC List' (or both).
+      </p></td></tr></table></div><div class="section" title="3.15.1. Creating Groups"><div class="titlepage"><div><div><h3 class="title"><a name="create-groups"></a>3.15.1. Creating Groups</h3></div></div></div><p>
+        To create a new group, follow the steps below:
+      </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+            Select the <span class="quote">“<span class="quote">Administration</span>”</span> link in the page footer, 
+            and then select the <span class="quote">“<span class="quote">Groups</span>”</span> link from the 
+            Administration page.
+          </p></li><li class="listitem"><p>
+            A table of all the existing groups is displayed. Below the table is a
+            description of all the fields. To create a new group, select the 
+            <span class="quote">“<span class="quote">Add Group</span>”</span> link under the table of existing groups.
+          </p></li><li class="listitem"><p>
+            There are five fields to fill out. These fields are documented below
+            the form. Choose a name and description for the group. Decide whether
+            this group should be used for bugs (in all likelihood this should be
+            selected). Optionally, choose a regular expression that will
+            automatically add any matching users to the group, and choose an
+            icon that will help identify user comments for the group. The regular
+            expression can be useful, for example, to automatically put all users
+            from the same company into one group (if the group is for a specific
+            customer or partner). 
+          </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+               If <span class="quote">“<span class="quote">User RegExp</span>”</span> is filled out, users whose email 
+               addresses match the regular expression will automatically be 
+               members of the group as long as their email addresses continue 
+               to match the regular expression. If their email address changes
+               and no longer matches the regular expression, they will be removed
+               from the group. Versions 2.16 and older of Bugzilla did not automatically
+               remove users who's email addresses no longer matched the RegExp.
+             </p></td></tr></table></div><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+               If specifying a domain in the regular expression, end
+               the regexp with a "$". Otherwise, when granting access to 
+               "@mycompany\.com", access will also be granted to 
+               'badperson@mycompany.com.cracker.net'. Use the syntax,
+               '@mycompany\.com$' for the regular expression.
+             </p></td></tr></table></div></li><li class="listitem"><p>
+          After the new group is created, it can be edited for additional options. 
+          The "Edit Group" page allows for specifying other groups that should be included
+          in this group and which groups should be permitted to add and delete
+          users from this group. For more details, see <a class="xref" href="#edit-groups" title="3.15.2. Editing Groups and Assigning Group Permissions">Section 3.15.2, “Editing Groups and Assigning Group Permissions”</a>.
+          </p></li></ol></div></div><div class="section" title="3.15.2. Editing Groups and Assigning Group Permissions"><div class="titlepage"><div><div><h3 class="title"><a name="edit-groups"></a>3.15.2. Editing Groups and Assigning Group Permissions</h3></div></div></div><p>
+        To access the "Edit Groups" page, select the 
+        <span class="quote">“<span class="quote">Administration</span>”</span> link in the page footer, 
+        and then select the <span class="quote">“<span class="quote">Groups</span>”</span> link from the Administration page.
+        A table of all the existing groups is displayed. Click on a group name
+        you wish to edit or control permissions for.
+      </p><p>
+       The "Edit Groups" page contains the same five fields present when 
+       creating a new group. Below that are two additional sections, "Group
+       Permissions," and "Mass Remove". The "Mass Remove" option simply removes
+       all users from the group who match the regular expression entered. The
+       "Group Permissions" section requires further explanation.
+      </p><p>
+       The "Group Permissions" section on the "Edit Groups" page contains four sets
+       of permissions that control the relationship of this group to other
+       groups. If the 'usevisibilitygroups' parameter is in use (see
+       <a class="xref" href="#parameters" title="3.1. Bugzilla Configuration">Section 3.1, “Bugzilla Configuration”</a>) two additional sets of permissions are displayed. 
+       Each set consists of two select boxes. On the left, a select box
+       with a list of all existing groups. On the right, a select box listing
+       all groups currently selected for this permission setting (this box will
+       be empty for new groups). The way these controls allow groups to relate
+       to one another is called <span class="emphasis"><em>inheritance</em></span>. 
+       Each of the six permissions is described below.
+      </p><div class="variablelist"><dl><dt><span class="term">
+            <span class="emphasis"><em>Groups That Are a Member of This Group</em></span>
+          </span></dt><dd><p> 
+              Members of any groups selected here will automatically have 
+              membership in this group. In other words, members of any selected 
+              group will inherit membership in this group. 
+            </p></dd><dt><span class="term">
+            <span class="emphasis"><em>Groups That This Group Is a Member Of</em></span>
+          </span></dt><dd><p>
+              Members of this group will inherit membership to any group 
+              selected here. For example, suppose the group being edited is
+              an Admin group. If there are two products  (Product1 and Product2) 
+              and each product has its
+              own group (Group1 and Group2), and the Admin group 
+              should have access to both products, 
+              simply select both Group1 and Group2 here. 
+           </p></dd><dt><span class="term">
+            <span class="emphasis"><em>Groups That Can Grant Membership in This Group</em></span>
+          </span></dt><dd><p>
+             The members of any group selected here will be able add users
+             to this group, even if they themselves are not in this group.
+           </p></dd><dt><span class="term">
+            <span class="emphasis"><em>Groups That This Group Can Grant Membership In</em></span>
+          </span></dt><dd><p>
+             Members of this group can add users to any group selected here,
+             even if they themselves are not in the selected groups.  
+           </p></dd><dt><span class="term">
+            <span class="emphasis"><em>Groups That Can See This Group</em></span>
+          </span></dt><dd><p>
+             Members of any selected group can see the users in this group.
+             This setting is only visible if the 'usevisibilitygroups' parameter
+             is enabled on the Bugzilla Configuration page. See
+             <a class="xref" href="#parameters" title="3.1. Bugzilla Configuration">Section 3.1, “Bugzilla Configuration”</a> for information on configuring Bugzilla.
+           </p></dd><dt><span class="term">
+            <span class="emphasis"><em>Groups That This Group Can See</em></span>
+          </span></dt><dd><p>
+             Members of this group can see members in any of the selected groups.
+             This setting is only visible if the 'usevisibilitygroups' parameter
+             is enabled on the the Bugzilla Configuration page. See
+             <a class="xref" href="#parameters" title="3.1. Bugzilla Configuration">Section 3.1, “Bugzilla Configuration”</a> for information on configuring Bugzilla.               
+           </p></dd></dl></div></div><div class="section" title="3.15.3. Assigning Users to Groups"><div class="titlepage"><div><div><h3 class="title"><a name="users-and-groups"></a>3.15.3. Assigning Users to Groups</h3></div></div></div><p>
+        A User can become a member of a group in several ways:
+      </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+            The user can be explicitly placed in the group by editing
+            the user's profile. This can be done by accessing the "Users" page
+            from the "Administration" page. Use the search form to find the user
+            you want to edit group membership for, and click on their email
+            address in the search results to edit their profile. The profile
+            page lists all the groups, and indicates if the user is a member of
+            the group either directly or indirectly. More information on indirect
+            group membership is below. For more details on User administration,
+            see <a class="xref" href="#useradmin" title="3.2. User Administration">Section 3.2, “User Administration”</a>.
+          </p></li><li class="listitem"><p>
+           The group can include another group of which the user is
+           a member. This is indicated by square brackets around the checkbox  
+           next to the group name in the user's profile. 
+           See <a class="xref" href="#edit-groups" title="3.15.2. Editing Groups and Assigning Group Permissions">Section 3.15.2, “Editing Groups and Assigning Group Permissions”</a> for details on group inheritance.
+          </p></li><li class="listitem"><p>
+            The user's email address can match the regular expression
+            that has been specified to automatically grant membership to
+            the group. This is indicated by "*" around the check box by the
+            group name in the user's profile.
+            See <a class="xref" href="#create-groups" title="3.15.1. Creating Groups">Section 3.15.1, “Creating Groups”</a> for details on 
+            the regular expression option when creating groups.
+           </p></li></ol></div></div><div class="section" title="3.15.4. Assigning Group Controls to Products"><div class="titlepage"><div><div><h3 class="title"><a name="idp11180256"></a>3.15.4. Assigning Group Controls to Products</h3></div></div></div><p>
+     The primary functionality of groups is derived from the relationship of 
+     groups to products. The concepts around segregating access to bugs with
+     product group controls can be confusing. For details and examples on this
+     topic, see <a class="xref" href="#product-group-controls" title="3.4.4. Assigning Group Controls to Products">Section 3.4.4, “Assigning Group Controls to Products”</a>.
+     </p></div></div><div class="section" title="3.16. Checking and Maintaining Database Integrity"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sanitycheck"></a>3.16. Checking and Maintaining Database Integrity</h2></div></div></div><p>
+    Over time it is possible for the Bugzilla database to become corrupt
+    or to have anomalies.
+    This could happen through normal usage of Bugzilla, manual database
+    administration outside of the Bugzilla user interface, or from some
+    other unexpected event. Bugzilla includes a "Sanity Check" script that
+    can perform several basic database checks, and repair certain problems or
+    inconsistencies. 
+    </p><p>
+    To run the "Sanity Check" script, log in as an Administrator and click the
+    "Sanity Check" link in the admin page. Any problems that are found will be
+    displayed in red letters. If the script is capable of fixing a problem,
+    it will present a link to initiate the fix. If the script cannot
+    fix the problem it will require manual database administration or recovery.
+    </p><p>
+    The "Sanity Check" script can also be run from the command line via the perl
+    script <code class="filename">sanitycheck.pl</code>. The script can also be run as
+    a <span class="command"><strong>cron</strong></span> job. Results will be delivered by email.
+    </p><p>
+    The "Sanity Check" script should be run on a regular basis as a matter of
+    best practice.
+    </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+      The "Sanity Check" script is no substitute for a competent database
+      administrator. It is only designed to check and repair basic database
+      problems.
+      </p></td></tr></table></div></div></div><div class="chapter" title="Chapter 4. Bugzilla Security"><div class="titlepage"><div><div><h2 class="title"><a name="security"></a>Chapter 4. Bugzilla Security</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#security-os">4.1. Operating System</a></span></dt><dd><dl><dt><span class="section"><a href="#security-os-ports">4.1.1. TCP/IP Ports</a></span></dt><dt><span class="section"><a href="#security-os-accounts">4.1.2. System User Accounts</a></span></dt><dt><span class="section"><a href="#security-os-chroot">4.1.3. The <code class="filename">chroot</code> Jail</a></span></dt></dl></dd><dt><span class="section"><a href="#security-webserver">4.2. Web server</a></span></dt><dd><dl><dt><span class="section"><a href="#security-webserver-access">4.2.1. Disabling Remote Access to Bugzilla Configuration Files</a></span></dt></dl></dd><dt><span class="section"><a href="#security-bugzilla">4.3. Bugzilla</a></span></dt><dd><dl><dt><span class="section"><a href="#security-bugzilla-charset">4.3.1. Prevent users injecting malicious Javascript</a></span></dt></dl></dd></dl></div><p>While some of the items in this chapter are related to the operating
+  system Bugzilla is running on or some of the support software required to
+  run Bugzilla, it is all related to protecting your data. This is not
+  intended to be a comprehensive guide to securing Linux, Apache, MySQL, or
+  any other piece of software mentioned. There is no substitute for active
+  administration and monitoring of a machine. The key to good security is
+  actually right in the middle of the word: <span class="emphasis"><em>U R It</em></span>.
+  </p><p>While programmers in general always strive to write secure code,
+  accidents can and do happen. The best approach to security is to always
+  assume that the program you are working with isn't 100% secure and restrict
+  its access to other parts of your machine as much as possible.
+  </p><div class="section" title="4.1. Operating System"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="security-os"></a>4.1. Operating System</h2></div></div></div><div class="section" title="4.1.1. TCP/IP Ports"><div class="titlepage"><div><div><h3 class="title"><a name="security-os-ports"></a>4.1.1. TCP/IP Ports</h3></div></div></div><p>The TCP/IP standard defines more than 65,000 ports for sending
+      and receiving traffic. Of those, Bugzilla needs exactly one to operate
+      (different configurations and options may require up to 3). You should
+      audit your server and make sure that you aren't listening on any ports
+      you don't need to be. It's also highly recommended that the server
+      Bugzilla resides on, along with any other machines you administer, be
+      placed behind some kind of firewall.
+      </p></div><div class="section" title="4.1.2. System User Accounts"><div class="titlepage"><div><div><h3 class="title"><a name="security-os-accounts"></a>4.1.2. System User Accounts</h3></div></div></div><p>Many <a class="glossterm" href="#gloss-daemon"><em class="glossterm">daemons</em></a>, such
+      as Apache's <code class="filename">httpd</code> or MySQL's
+      <code class="filename">mysqld</code>, run as either <span class="quote">“<span class="quote">root</span>”</span> or
+      <span class="quote">“<span class="quote">nobody</span>”</span>. This is even worse on Windows machines where the
+      majority of <a class="glossterm" href="#gloss-service"><em class="glossterm">services</em></a>
+      run as <span class="quote">“<span class="quote">SYSTEM</span>”</span>. While running as <span class="quote">“<span class="quote">root</span>”</span> or
+      <span class="quote">“<span class="quote">SYSTEM</span>”</span> introduces obvious security concerns, the
+      problems introduced by running everything as <span class="quote">“<span class="quote">nobody</span>”</span> may
+      not be so obvious. Basically, if you run every daemon as
+      <span class="quote">“<span class="quote">nobody</span>”</span> and one of them gets compromised it can
+      compromise every other daemon running as <span class="quote">“<span class="quote">nobody</span>”</span> on your
+      machine. For this reason, it is recommended that you create a user
+      account for each daemon.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>You will need to set the <code class="option">webservergroup</code> option
+        in <code class="filename">localconfig</code> to the group your web server runs
+        as. This will allow <code class="filename">./checksetup.pl</code> to set file
+        permissions on Unix systems so that nothing is world-writable.
+        </p></td></tr></table></div></div><div class="section" title="4.1.3. The chroot Jail"><div class="titlepage"><div><div><h3 class="title"><a name="security-os-chroot"></a>4.1.3. The <code class="filename">chroot</code> Jail</h3></div></div></div><p>
+        If your system supports it, you may wish to consider running
+        Bugzilla inside of a <code class="filename">chroot</code> jail. This option
+        provides unprecedented security by restricting anything running
+        inside the jail from accessing any information outside of it. If you
+        wish to use this option, please consult the documentation that came
+        with your system.
+      </p></div></div><div class="section" title="4.2. Web server"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="security-webserver"></a>4.2. Web server</h2></div></div></div><div class="section" title="4.2.1. Disabling Remote Access to Bugzilla Configuration Files"><div class="titlepage"><div><div><h3 class="title"><a name="security-webserver-access"></a>4.2.1. Disabling Remote Access to Bugzilla Configuration Files</h3></div></div></div><p>
+        There are many files that are placed in the Bugzilla directory
+        area that should not be accessible from the web server. Because of the way
+        Bugzilla is currently layed out, the list of what should and should not
+        be accessible is rather complicated. A quick way is to run
+        <code class="filename">testserver.pl</code> to check if your web server serves
+        Bugzilla files as expected. If not, you may want to follow the few
+        steps below.
+      </p><div class="tip" title="Tip" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../images/tip.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Bugzilla ships with the ability to create
+        <a class="glossterm" href="#gloss-htaccess"><em class="glossterm"><code class="filename">.htaccess</code></em></a>
+        files that enforce these rules. Instructions for enabling these
+        directives in Apache can be found in <a class="xref" href="#http-apache" title="2.2.4.1. Bugzilla using Apache">Section 2.2.4.1, “Bugzilla using Apache”</a>
+        </p></td></tr></table></div><div class="itemizedlist"><ul class="itemizedlist" type="disc" compact><li class="listitem"><p>In the main Bugzilla directory, you should:</p><div class="itemizedlist"><ul class="itemizedlist" type="circle" compact><li class="listitem"><p>Block:
+              <span class="simplelist"><code class="filename">*.pl</code>, <code class="filename">*localconfig*</code></span>
+              </p></li></ul></div></li><li class="listitem"><p>In <code class="filename">data</code>:</p><div class="itemizedlist"><ul class="itemizedlist" type="circle" compact><li class="listitem"><p>Block everything</p></li></ul></div></li><li class="listitem"><p>In <code class="filename">data/webdot</code>:</p><div class="itemizedlist"><ul class="itemizedlist" type="circle" compact><li class="listitem"><p>If you use a remote webdot server:</p><div class="itemizedlist"><ul class="itemizedlist" type="square" compact><li class="listitem"><p>Block everything</p></li><li class="listitem"><p>But allow
+                  <span class="simplelist"><code class="filename">*.dot</code></span>
+                  only for the remote webdot server</p></li></ul></div></li><li class="listitem"><p>Otherwise, if you use a local GraphViz:</p><div class="itemizedlist"><ul class="itemizedlist" type="square" compact><li class="listitem"><p>Block everything</p></li><li class="listitem"><p>But allow:
+                  <span class="simplelist"><code class="filename">*.png</code>, <code class="filename">*.gif</code>, <code class="filename">*.jpg</code>, <code class="filename">*.map</code></span>
+                  </p></li></ul></div></li><li class="listitem"><p>And if you don't use any dot:</p><div class="itemizedlist"><ul class="itemizedlist" type="square" compact><li class="listitem"><p>Block everything</p></li></ul></div></li></ul></div></li><li class="listitem"><p>In <code class="filename">Bugzilla</code>:</p><div class="itemizedlist"><ul class="itemizedlist" type="circle" compact><li class="listitem"><p>Block everything</p></li></ul></div></li><li class="listitem"><p>In <code class="filename">template</code>:</p><div class="itemizedlist"><ul class="itemizedlist" type="circle" compact><li class="listitem"><p>Block everything</p></li></ul></div></li></ul></div><p>Be sure to test that data that should not be accessed remotely is
+      properly blocked. Of particular interest is the localconfig file which
+      contains your database password. Also, be aware that many editors
+      create temporary and backup files in the working directory and that
+      those should also not be accessible. For more information, see
+      <a class="ulink" href="http://bugzilla.mozilla.org/show_bug.cgi?id=186383" target="_top">bug 186383</a>
+      or
+      <a class="ulink" href="http://online.securityfocus.com/bid/6501" target="_top">Bugtraq ID 6501</a>.
+      To test, simply run <code class="filename">testserver.pl</code>, as said above.
+      </p><div class="tip" title="Tip" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../images/tip.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Be sure to check <a class="xref" href="#http" title="2.2.4. Web server">Section 2.2.4, “Web server”</a> for instructions
+        specific to the web server you use.
+        </p></td></tr></table></div></div></div><div class="section" title="4.3. Bugzilla"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="security-bugzilla"></a>4.3. Bugzilla</h2></div></div></div><div class="section" title="4.3.1. Prevent users injecting malicious Javascript"><div class="titlepage"><div><div><h3 class="title"><a name="security-bugzilla-charset"></a>4.3.1. Prevent users injecting malicious Javascript</h3></div></div></div><p>If you installed Bugzilla version 2.22 or later from scratch,
+      then the <span class="emphasis"><em>utf8</em></span> parameter is switched on by default.
+      This makes Bugzilla explicitly set the character encoding, following
+      <a class="ulink" href="http://www.cert.org/tech_tips/malicious_code_mitigation.html#3" target="_top">a
+      CERT advisory</a> recommending exactly this.
+      The following therefore does not apply to you; just keep
+      <span class="emphasis"><em>utf8</em></span> turned on.
+      </p><p>If you've upgraded from an older version, then it may be possible
+      for a Bugzilla user to take advantage of character set encoding
+      ambiguities to inject HTML into Bugzilla comments.
+      This could include malicious scripts. 
+      This is because due to internationalization concerns, we are unable to
+      turn the <span class="emphasis"><em>utf8</em></span> parameter on by default for upgraded
+      installations.
+      Turning it on manually will prevent this problem.
+      </p></div></div></div><div class="chapter" title="Chapter 5. Using Bugzilla"><div class="titlepage"><div><div><h2 class="title"><a name="using"></a>Chapter 5. Using Bugzilla</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#using-intro">5.1. Introduction</a></span></dt><dt><span class="section"><a href="#myaccount">5.2. Create a Bugzilla Account</a></span></dt><dt><span class="section"><a href="#bug_page">5.3. Anatomy of a Bug</a></span></dt><dt><span class="section"><a href="#lifecycle">5.4. Life Cycle of a Bug</a></span></dt><dt><span class="section"><a href="#query">5.5. Searching for Bugs</a></span></dt><dd><dl><dt><span class="section"><a href="#boolean">5.5.1. Boolean Charts</a></span></dt><dt><span class="section"><a href="#quicksearch">5.5.2. Quicksearch</a></span></dt><dt><span class="section"><a href="#casesensitivity">5.5.3. Case Sensitivity in Searches</a></span></dt><dt><span class="section"><a href="#list">5.5.4. Bug Lists</a></span></dt><dt><span class="section"><a href="#individual-buglists">5.5.5. Adding/removing tags to/from bugs</a></span></dt></dl></dd><dt><span class="section"><a href="#bugreports">5.6. Filing Bugs</a></span></dt><dd><dl><dt><span class="section"><a href="#fillingbugs">5.6.1. Reporting a New Bug</a></span></dt><dt><span class="section"><a href="#cloningbugs">5.6.2. Clone an Existing Bug</a></span></dt></dl></dd><dt><span class="section"><a href="#attachments">5.7. Attachments</a></span></dt><dd><dl><dt><span class="section"><a href="#patchviewer">5.7.1. Patch Viewer</a></span></dt></dl></dd><dt><span class="section"><a href="#hintsandtips">5.8. Hints and Tips</a></span></dt><dd><dl><dt><span class="section"><a href="#idp11248736">5.8.1. Autolinkification</a></span></dt><dt><span class="section"><a href="#commenting">5.8.2. Comments</a></span></dt><dt><span class="section"><a href="#comment-wrapping">5.8.3. Server-Side Comment Wrapping</a></span></dt><dt><span class="section"><a href="#dependencytree">5.8.4. Dependency Tree</a></span></dt></dl></dd><dt><span class="section"><a href="#timetracking">5.9. Time Tracking Information</a></span></dt><dt><span class="section"><a href="#userpreferences">5.10. User Preferences</a></span></dt><dd><dl><dt><span class="section"><a href="#generalpreferences">5.10.1. General Preferences</a></span></dt><dt><span class="section"><a href="#emailpreferences">5.10.2. Email Preferences</a></span></dt><dt><span class="section"><a href="#savedsearches">5.10.3. Saved Searches</a></span></dt><dt><span class="section"><a href="#accountpreferences">5.10.4. Name and Password</a></span></dt><dt><span class="section"><a href="#permissionsettings">5.10.5. Permissions</a></span></dt></dl></dd><dt><span class="section"><a href="#reporting">5.11. Reports and Charts</a></span></dt><dd><dl><dt><span class="section"><a href="#reports">5.11.1. Reports</a></span></dt><dt><span class="section"><a href="#charts">5.11.2. Charts</a></span></dt></dl></dd><dt><span class="section"><a href="#flags">5.12. Flags</a></span></dt><dt><span class="section"><a href="#whining">5.13. Whining</a></span></dt><dd><dl><dt><span class="section"><a href="#whining-overview">5.13.1. The Event</a></span></dt><dt><span class="section"><a href="#whining-schedule">5.13.2. Whining Schedule</a></span></dt><dt><span class="section"><a href="#whining-query">5.13.3. Whining Searches</a></span></dt><dt><span class="section"><a href="#idp11397440">5.13.4. Saving Your Changes</a></span></dt></dl></dd></dl></div><div class="section" title="5.1. Introduction"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="using-intro"></a>5.1. Introduction</h2></div></div></div><p>This section contains information for end-users of Bugzilla.  There
+    is a Bugzilla test installation, called
+    <a class="ulink" href="http://landfill.bugzilla.org/" target="_top">Landfill</a>, which you are
+    welcome to play with (if it's up). However, not all of the Bugzilla
+    installations there will necessarily have all Bugzilla features enabled,
+    and different installations run different versions, so some things may not
+    quite work as this document describes.</p><p>
+      Frequently Asked Questions (FAQ) are available and answered on
+      <a class="ulink" href="http://wiki.mozilla.org/Bugzilla:FAQ" target="_top">wiki.mozilla.org</a>.
+      They may cover some questions you have which are left unanswered.
+    </p></div><div class="section" title="5.2. Create a Bugzilla Account"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="myaccount"></a>5.2. Create a Bugzilla Account</h2></div></div></div><p>If you want to use Bugzilla, first you need to create an account.
+    Consult with the administrator responsible for your installation of
+    Bugzilla for the URL you should use to access it. If you're
+    test-driving Bugzilla, use this URL: 
+    <a class="ulink" href="http://landfill.bugzilla.org/bugzilla-tip/" target="_top">http://landfill.bugzilla.org/bugzilla-tip/</a>.
+    </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+          On the home page <code class="filename">index.cgi</code>, click the
+          <span class="quote">“<span class="quote">Open a new Bugzilla account</span>”</span> link, or the
+          <span class="quote">“<span class="quote">New Account</span>”</span> link available in the footer of pages.
+          Now enter your email address, then click the <span class="quote">“<span class="quote">Send</span>”</span>
+          button.
+        </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            If none of these links is available, this means that the
+            administrator of the installation has disabled self-registration.
+            This means that only an administrator can create accounts
+            for other users. One reason could be that this installation is
+            private.
+          </p></td></tr></table></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            Also, if only some users are allowed to create an account on
+            the installation, you may see these links but your registration
+            may fail if your email address doesn't match the ones accepted
+            by the installation. This is another way to restrict who can
+            access and edit bugs in this installation.
+          </p></td></tr></table></div></li><li class="listitem"><p>
+          Within moments, and if your registration is accepted, you should
+          receive an email to the address you provided, which contains your
+          login name (generally the same as the email address), and two URLs
+          with a token (a random string generated by the installation) to
+          confirm, respectively cancel, your registration. This is a way to
+          prevent users from abusing the generation of user accounts, for
+          instance by entering inexistent email addresses, or email addresses
+          which do not belong to them.
+        </p></li><li class="listitem"><p>
+          By default, you have 3 days to confirm your registration. Past this
+          timeframe, the token is invalidated and the registration is
+          automatically canceled. You can also cancel this registration sooner
+          by using the appropriate URL in the email you got.
+        </p></li><li class="listitem"><p>
+          If you confirm your registration, Bugzilla will ask you your real name
+          (optional, but recommended) and your password, which must be between
+          3 and 16 characters long.
+        </p></li><li class="listitem"><p>
+          Now all you need to do is to click the <span class="quote">“<span class="quote">Log In</span>”</span>
+          link in the footer at the bottom of the page in your browser,
+          enter your email address and password you just chose into the
+          login form, and click the <span class="quote">“<span class="quote">Log in</span>”</span> button.
+        </p></li></ol></div><p>
+      You are now logged in. Bugzilla uses cookies to remember you are
+      logged in so, unless you have cookies disabled or your IP address changes,
+      you should not have to log in again during your session.
+    </p></div><div class="section" title="5.3. Anatomy of a Bug"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="bug_page"></a>5.3. Anatomy of a Bug</h2></div></div></div><p>The core of Bugzilla is the screen which displays a particular
+    bug. It's a good place to explain some Bugzilla concepts. 
+    <a class="ulink" href="http://landfill.bugzilla.org/bugzilla-tip/show_bug.cgi?id=1" target="_top">
+    Bug 1 on Landfill</a>
+
+    is a good example. Note that the labels for most fields are hyperlinks;
+    clicking them will take you to context-sensitive help on that
+    particular field. Fields marked * may not be present on every
+    installation of Bugzilla.</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+          <span class="emphasis"><em>Product and Component</em></span>: 
+          Bugs are divided up by Product and Component, with a Product
+          having one or more Components in it. For example,
+          bugzilla.mozilla.org's "Bugzilla" Product is composed of several
+          Components:
+          </p><div class="variablelist"><dl><dt><span class="term">Administration:</span></dt><dd><p>
+                  Administration of a Bugzilla installation.
+                </p></dd><dt><span class="term">Bugzilla-General:</span></dt><dd><p>
+                  Anything that doesn't fit in the other components, or spans
+                  multiple components.
+                </p></dd><dt><span class="term">Creating/Changing Bugs:</span></dt><dd><p>
+                  Creating, changing, and viewing bugs.
+                </p></dd><dt><span class="term">Documentation:</span></dt><dd><p>
+                  The Bugzilla documentation, including The Bugzilla Guide.
+                </p></dd><dt><span class="term">Email:</span></dt><dd><p>
+                  Anything to do with email sent by Bugzilla.
+                </p></dd><dt><span class="term">Installation:</span></dt><dd><p>
+                  The installation process of Bugzilla.
+                </p></dd><dt><span class="term">Query/Buglist:</span></dt><dd><p>
+                  Anything to do with searching for bugs and viewing the
+                  buglists.
+                </p></dd><dt><span class="term">Reporting/Charting:</span></dt><dd><p>
+                  Getting reports from Bugzilla.
+                </p></dd><dt><span class="term">User Accounts:</span></dt><dd><p>
+                  Anything about managing a user account from the user's perspective.
+                  Saved queries, creating accounts, changing passwords, logging in,
+                  etc.
+                </p></dd><dt><span class="term">User Interface:</span></dt><dd><p>
+                  General issues having to do with the user interface cosmetics (not
+                  functionality) including cosmetic issues, HTML templates,
+                  etc.
+                </p></dd></dl></div><p>
+        </p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Status and Resolution:</em></span>
+
+        These define exactly what state the bug is in - from not even
+        being confirmed as a bug, through to being fixed and the fix
+        confirmed by Quality Assurance. The different possible values for
+        Status and Resolution on your installation should be documented in the
+        context-sensitive help for those items.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Assigned To:</em></span>
+        The person responsible for fixing the bug.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>*QA Contact:</em></span>
+        The person responsible for quality assurance on this bug.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>*URL:</em></span>
+        A URL associated with the bug, if any.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Summary:</em></span>
+        A one-sentence summary of the problem.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>*Status Whiteboard:</em></span>
+        (a.k.a. Whiteboard) A free-form text area for adding short notes
+        and tags to a bug.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>*Keywords:</em></span>
+        The administrator can define keywords which you can use to tag and
+        categorise bugs - e.g. The Mozilla Project has keywords like crash
+        and regression.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Platform and OS:</em></span>
+        These indicate the computing environment where the bug was
+        found.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Version:</em></span>
+        The "Version" field is usually used for versions of a product which
+        have been released, and is set to indicate which versions of a
+        Component have the particular problem the bug report is
+        about.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Priority:</em></span>
+        The bug assignee uses this field to prioritize his or her bugs.
+        It's a good idea not to change this on other people's bugs.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Severity:</em></span>
+        This indicates how severe the problem is - from blocker
+        ("application unusable") to trivial ("minor cosmetic issue"). You
+        can also use this field to indicate whether a bug is an enhancement
+        request.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>*Target:</em></span>
+        (a.k.a. Target Milestone) A future version by which the bug is to
+        be fixed. e.g. The Bugzilla Project's milestones for future
+        Bugzilla versions are 2.18, 2.20, 3.0, etc. Milestones are not
+        restricted to numbers, thought - you can use any text strings, such
+        as dates.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Reporter:</em></span>
+        The person who filed the bug.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>CC list:</em></span>
+        A list of people who get mail when the bug changes.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>*Time Tracking:</em></span>
+        This form can be used for time tracking.
+        To use this feature, you have to be blessed group membership
+        specified by the <span class="quote">“<span class="quote">timetrackinggroup</span>”</span> parameter.
+        </p><div class="variablelist"><dl><dt><span class="term">Orig. Est.:</span></dt><dd><p>
+                This field shows the original estimated time.
+              </p></dd><dt><span class="term">Current Est.:</span></dt><dd><p>
+                This field shows the current estimated time.
+                This number is calculated from <span class="quote">“<span class="quote">Hours Worked</span>”</span>
+                and <span class="quote">“<span class="quote">Hours Left</span>”</span>.
+              </p></dd><dt><span class="term">Hours Worked:</span></dt><dd><p>
+                This field shows the number of hours worked.
+              </p></dd><dt><span class="term">Hours Left:</span></dt><dd><p>
+                This field shows the <span class="quote">“<span class="quote">Current Est.</span>”</span> -
+                <span class="quote">“<span class="quote">Hours Worked</span>”</span>.
+                This value + <span class="quote">“<span class="quote">Hours Worked</span>”</span> will become the
+                new Current Est.
+              </p></dd><dt><span class="term">%Complete:</span></dt><dd><p>
+                This field shows what percentage of the task is complete.
+              </p></dd><dt><span class="term">Gain:</span></dt><dd><p>
+                This field shows the number of hours that the bug is ahead of the
+              <span class="quote">“<span class="quote">Orig. Est.</span>”</span>.
+              </p></dd><dt><span class="term">Deadline:</span></dt><dd><p>
+                This field shows the deadline for this bug.
+              </p></dd></dl></div><p>
+        </p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Attachments:</em></span>
+          You can attach files (e.g. testcases or patches) to bugs. If there
+          are any attachments, they are listed in this section.
+        </p></li><li class="listitem"><p>
+        <span class="emphasis"><em>*Dependencies:</em></span>
+        If this bug cannot be fixed unless other bugs are fixed (depends
+        on), or this bug stops other bugs being fixed (blocks), their
+        numbers are recorded here.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>*Votes:</em></span>
+        Whether this bug has any votes.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Additional Comments:</em></span>
+        You can add your two cents to the bug discussion here, if you have
+        something worthwhile to say.</p></li></ol></div></div><div class="section" title="5.4. Life Cycle of a Bug"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="lifecycle"></a>5.4. Life Cycle of a Bug</h2></div></div></div><p>
+      The life cycle of a bug, also known as workflow, is customizable to match
+      the needs of your organization, see <a class="xref" href="#bug_status_workflow" title="3.12. Bug Status Workflow">Section 3.12, “Bug Status Workflow”</a>.
+      <a class="xref" href="#lifecycle-image" title="Figure 5.1. Lifecycle of a Bugzilla Bug">Figure 5.1, “Lifecycle of a Bugzilla Bug”</a> contains a graphical representation of
+      the default workflow using the default bug statuses. If you wish to
+      customize this image for your site, the
+      <a class="ulink" href="../images/bzLifecycle.xml" target="_top">diagram file</a>
+      is available in <a class="ulink" href="http://www.gnome.org/projects/dia" target="_top">Dia's</a>
+      native XML format.
+    </p><div class="figure"><a name="lifecycle-image"></a><p class="title"><b>Figure 5.1. Lifecycle of a Bugzilla Bug</b></p><div class="figure-contents"><div class="mediaobject"><img src="../images/bzLifecycle.png" alt="Lifecycle of a Bugzilla Bug"></div></div></div><br class="figure-break"></div><div class="section" title="5.5. Searching for Bugs"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="query"></a>5.5. Searching for Bugs</h2></div></div></div><p>The Bugzilla Search page is the interface where you can find
+    any bug report, comment, or patch currently in the Bugzilla system. You
+    can play with it here: 
+    <a class="ulink" href="http://landfill.bugzilla.org/bugzilla-tip/query.cgi" target="_top">http://landfill.bugzilla.org/bugzilla-tip/query.cgi</a>.</p><p>The Search page has controls for selecting different possible
+    values for all of the fields in a bug, as described above. For some
+    fields, multiple values can be selected. In those cases, Bugzilla
+    returns bugs where the content of the field matches any one of the selected
+    values. If none is selected, then the field can take any value.</p><p>
+      After a search is run, you can save it as a Saved Search, which
+      will appear in the page footer. If you are in the group defined 
+      by the "querysharegroup" parameter, you may share your queries 
+      with other users, see <a class="xref" href="#savedsearches" title="5.10.3. Saved Searches">Saved Searches</a> for more details.
+    </p><div class="section" title="5.5.1. Boolean Charts"><div class="titlepage"><div><div><h3 class="title"><a name="boolean"></a>5.5.1. Boolean Charts</h3></div></div></div><p>
+        Highly advanced querying is done using Boolean Charts.
+      </p><p>
+        The boolean charts further restrict the set of results
+        returned by a query. It is possible to search for bugs
+        based on elaborate combinations of criteria.
+      </p><p>
+        The simplest boolean searches have only one term. These searches
+        permit the selected left <span class="emphasis"><em>field</em></span>
+        to be compared using a
+        selectable <span class="emphasis"><em>operator</em></span> to a
+        specified <span class="emphasis"><em>value.</em></span>
+        Using the "And," "Or," and "Add Another Boolean Chart" buttons, 
+        additional terms can be included in the query, further
+        altering the list of bugs returned by the query.
+      </p><p>
+        There are three fields in each row of a boolean search. 
+      </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
+            <span class="emphasis"><em>Field:</em></span>
+            the items being searched 
+          </p></li><li class="listitem"><p>
+            <span class="emphasis"><em>Operator:</em></span>
+            the comparison operator 
+          </p></li><li class="listitem"><p>
+            <span class="emphasis"><em>Value:</em></span>
+            the value to which the field is being compared
+          </p></li></ul></div><div class="section" title="5.5.1.1. Pronoun Substitution"><div class="titlepage"><div><div><h4 class="title"><a name="pronouns"></a>5.5.1.1. Pronoun Substitution</h4></div></div></div><p>
+          Sometimes, a query needs to compare a user-related field
+          (such as ReportedBy) with a role-specific user (such as the
+          user running the query or the user to whom each bug is assigned).
+          When the operator is either "equals" or "notequals", the value
+          can be "%reporter%", "%assignee%", "%qacontact%", or "%user%".
+          The user pronoun
+          refers to the user who is executing the query or, in the case
+          of whining reports, the user who will be the recipient
+          of the report. The reporter, assignee, and qacontact
+          pronouns refer to the corresponding fields in the bug.
+        </p><p>
+          Boolean charts also let you type a group name in any user-related
+          field if the operator is either "equals", "notequals" or "anyexact".
+          This will let you query for any member belonging (or not) to the
+          specified group. The group name must be entered following the
+          "%group.foo%" syntax, where "foo" is the group name.
+          So if you are looking for bugs reported by any user being in the
+          "editbugs" group, then you can type "%group.editbugs%".
+        </p></div><div class="section" title="5.5.1.2. Negation"><div class="titlepage"><div><div><h4 class="title"><a name="negation"></a>5.5.1.2. Negation</h4></div></div></div><p>
+          At first glance, negation seems redundant. Rather than
+          searching for
+          </p><div class="blockquote"><blockquote class="blockquote"><p>
+              NOT("summary" "contains the string" "foo"),
+            </p></blockquote></div><p>
+          one could search for 
+          </p><div class="blockquote"><blockquote class="blockquote"><p>
+              ("summary" "does not contain the string" "foo").
+            </p></blockquote></div><p>
+          However, the search 
+          </p><div class="blockquote"><blockquote class="blockquote"><p>
+              ("CC" "does not contain the string" "@mozilla.org")
+            </p></blockquote></div><p>
+          would find every bug where anyone on the CC list did not contain 
+          "@mozilla.org" while
+          </p><div class="blockquote"><blockquote class="blockquote"><p>
+              NOT("CC" "contains the string" "@mozilla.org")
+            </p></blockquote></div><p>
+          would find every bug where there was nobody on the CC list who
+          did contain the string. Similarly, the use of negation also permits
+          complex expressions to be built using terms OR'd together and then
+          negated. Negation permits queries such as
+          </p><div class="blockquote"><blockquote class="blockquote"><p>
+              NOT(("product" "equals" "update") OR 
+            ("component" "equals" "Documentation"))
+            </p></blockquote></div><p>
+          to find bugs that are neither 
+          in the update product or in the documentation component or
+          </p><div class="blockquote"><blockquote class="blockquote"><p>
+              NOT(("commenter" "equals" "%assignee%") OR 
+              ("component" "equals" "Documentation"))
+            </p></blockquote></div><p>
+          to find non-documentation
+          bugs on which the assignee has never commented.
+        </p></div><div class="section" title="5.5.1.3. Multiple Charts"><div class="titlepage"><div><div><h4 class="title"><a name="multiplecharts"></a>5.5.1.3. Multiple Charts</h4></div></div></div><p>
+          The terms within a single row of a boolean chart are all
+          constraints on a single piece of data. If you are looking for
+          a bug that has two different people cc'd on it, then you need 
+          to use two boolean charts. A search for
+          </p><div class="blockquote"><blockquote class="blockquote"><p>
+              ("cc" "contains the string" "foo@") AND
+              ("cc" "contains the string" "@mozilla.org")
+            </p></blockquote></div><p>
+          would return only bugs with "foo@mozilla.org" on the cc list.
+          If you wanted bugs where there is someone on the cc list
+          containing "foo@" and someone else containing "@mozilla.org",
+          then you would need two boolean charts.
+          </p><div class="blockquote"><blockquote class="blockquote"><p>
+              First chart: ("cc" "contains the string" "foo@")
+            </p><p>
+              Second chart: ("cc" "contains the string" "@mozilla.org")
+            </p></blockquote></div><p>
+          The bugs listed will be only the bugs where ALL the charts are true.
+        </p></div></div><div class="section" title="5.5.2. Quicksearch"><div class="titlepage"><div><div><h3 class="title"><a name="quicksearch"></a>5.5.2. Quicksearch</h3></div></div></div><p>
+        Quicksearch is a single-text-box query tool which uses
+        metacharacters to indicate what is to be searched. For example, typing
+        "<code class="literal">foo|bar</code>"
+        into Quicksearch would search for "foo" or "bar" in the
+        summary and status whiteboard of a bug; adding
+        "<code class="literal">:BazProduct</code>" would
+        search only in that product.
+        You can use it to find a bug by its number or its alias, too.
+      </p><p>
+        You'll find the Quicksearch box in Bugzilla's footer area.
+        On Bugzilla's front page, there is an additional
+        <a class="ulink" href="../../page.cgi?id=quicksearch.html" target="_top">Help</a>
+        link which details how to use it.
+      </p></div><div class="section" title="5.5.3. Case Sensitivity in Searches"><div class="titlepage"><div><div><h3 class="title"><a name="casesensitivity"></a>5.5.3. Case Sensitivity in Searches</h3></div></div></div><p>
+      Bugzilla queries are case-insensitive and accent-insensitive, when
+      used with either MySQL or Oracle databases. When using Bugzilla with
+      PostgreSQL, however, some queries are case-sensitive. This is due to
+      the way PostgreSQL handles case and accent sensitivity. 
+      </p></div><div class="section" title="5.5.4. Bug Lists"><div class="titlepage"><div><div><h3 class="title"><a name="list"></a>5.5.4. Bug Lists</h3></div></div></div><p>If you run a search, a list of matching bugs will be returned.
+      </p><p>The format of the list is configurable. For example, it can be
+      sorted by clicking the column headings. Other useful features can be
+      accessed using the links at the bottom of the list:
+        </p><div class="variablelist"><dl><dt><span class="term">Long Format:</span></dt><dd><p>
+                this gives you a large page with a non-editable summary of the fields
+                of each bug.
+              </p></dd><dt><span class="term">XML:</span></dt><dd><p>
+                get the buglist in the XML format.
+              </p></dd><dt><span class="term">CSV:</span></dt><dd><p>
+                get the buglist as comma-separated values, for import into e.g.
+                a spreadsheet.
+              </p></dd><dt><span class="term">Feed:</span></dt><dd><p>
+                get the buglist as an Atom feed.  Copy this link into your
+                favorite feed reader.  If you are using Firefox, you can also
+                save the list as a live bookmark by clicking the live bookmark
+                icon in the status bar.  To limit the number of bugs in the feed,
+                add a limit=n parameter to the URL.
+              </p></dd><dt><span class="term">iCalendar:</span></dt><dd><p>
+                Get the buglist as an iCalendar file. Each bug is represented as a
+                to-do item in the imported calendar.
+              </p></dd><dt><span class="term">Change Columns:</span></dt><dd><p>
+                change the bug attributes which appear in the list.
+              </p></dd><dt><span class="term">Change several bugs at once:</span></dt><dd><p>
+                If your account is sufficiently empowered, and more than one bug
+                appear in the bug list, this link is displayed which lets you make
+                the same change to all the bugs in the list - for example, changing
+                their assignee.
+              </p></dd><dt><span class="term">Send mail to bug assignees:</span></dt><dd><p>
+                If more than one bug appear in the bug list and there are at least
+                two distinct bug assignees, this links is displayed which lets you
+                easily send a mail to the assignees of all bugs on the list.
+              </p></dd><dt><span class="term">Edit Search:</span></dt><dd><p>
+                If you didn't get exactly the results you were looking for, you can
+                return to the Query page through this link and make small revisions
+                to the query you just made so you get more accurate results.
+              </p></dd><dt><span class="term">Remember Search As:</span></dt><dd><p>
+                You can give a search a name and remember it; a link will appear
+                in your page footer giving you quick access to run it again later.
+              </p></dd></dl></div><p>
+      </p></div><div class="section" title="5.5.5. Adding/removing tags to/from bugs"><div class="titlepage"><div><div><h3 class="title"><a name="individual-buglists"></a>5.5.5. Adding/removing tags to/from bugs</h3></div></div></div><p>
+        You can add and remove tags from individual bugs, which let you find and
+        manage bugs more easily. Tags are per-user and so are only visible and editable
+        by the user who created them. You can then run queries using tags as a criteria,
+        either by using the Advanced Search form, or simply by typing "tag:my_tag_name"
+        in the QuickSearch box at the top (or bottom) of the page. Tags can also be
+        displayed in buglists.
+      </p><p>
+        This feature is useful when you want to keep track of several bugs, but
+        for different reasons. Instead of adding yourself to the CC list of all
+        these bugs and mixing all these reasons, you can now store these bugs in
+        separate lists, e.g. <span class="quote">“<span class="quote">Keep in mind</span>”</span>, <span class="quote">“<span class="quote">Interesting bugs</span>”</span>,
+        or <span class="quote">“<span class="quote">Triage</span>”</span>. One big advantage of this way to manage bugs
+        is that you can easily add or remove tags from bugs one by one.
+      </p></div></div><div class="section" title="5.6. Filing Bugs"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="bugreports"></a>5.6. Filing Bugs</h2></div></div></div><div class="section" title="5.6.1. Reporting a New Bug"><div class="titlepage"><div><div><h3 class="title"><a name="fillingbugs"></a>5.6.1. Reporting a New Bug</h3></div></div></div><p>Years of bug writing experience has been distilled for your
+      reading pleasure into the 
+      <a class="ulink" href="http://landfill.bugzilla.org/bugzilla-tip/page.cgi?id=bug-writing.html" target="_top">
+      Bug Writing Guidelines</a>. 
+      While some of the advice is Mozilla-specific, the basic principles of
+      reporting Reproducible, Specific bugs, isolating the Product you are
+      using, the Version of the Product, the Component which failed, the
+      Hardware Platform, and Operating System you were using at the time of
+      the failure go a long way toward ensuring accurate, responsible fixes
+      for the bug that bit you.</p><p>The procedure for filing a bug is as follows:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+            Click the <span class="quote">“<span class="quote">New</span>”</span> link available in the footer
+            of pages, or the <span class="quote">“<span class="quote">Enter a new bug report</span>”</span> link
+            displayed on the home page of the Bugzilla installation.
+          </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+              If you want to file a test bug to see how Bugzilla works,
+              you can do it on one of our test installations on
+              <a class="ulink" href="http://landfill.bugzilla.org/bugzilla-tip/" target="_top">Landfill</a>.
+            </p></td></tr></table></div></li><li class="listitem"><p>
+            You first have to select the product in which you found a bug.
+          </p></li><li class="listitem"><p>
+            You now see a form where you can specify the component (part of
+            the product which is affected by the bug you discovered; if you have
+            no idea, just select <span class="quote">“<span class="quote">General</span>”</span> if such a component exists),
+            the version of the program you were using, the Operating System and
+            platform your program is running on and the severity of the bug (if the
+            bug you found crashes the program, it's probably a major or a critical
+            bug; if it's a typo somewhere, that's something pretty minor; if it's
+            something you would like to see implemented, then that's an enhancement).
+          </p></li><li class="listitem"><p>
+            You now have to give a short but descriptive summary of the bug you found.
+            <span class="quote">“<span class="quote">My program is crashing all the time</span>”</span> is a very poor summary
+            and doesn't help developers at all. Try something more meaningful or
+            your bug will probably be ignored due to a lack of precision.
+            The next step is to give a very detailed list of steps to reproduce
+            the problem you encountered. Try to limit these steps to a minimum set
+            required to reproduce the problem. This will make the life of
+            developers easier, and the probability that they consider your bug in
+            a reasonable timeframe will be much higher.
+          </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+              Try to make sure that everything in the summary is also in the first
+              comment. Summaries are often updated and this will ensure your original
+              information is easily accessible.
+            </p></td></tr></table></div></li><li class="listitem"><p>
+            As you file the bug, you can also attach a document (testcase, patch,
+            or screenshot of the problem).
+          </p></li><li class="listitem"><p>
+            Depending on the Bugzilla installation you are using and the product in
+            which you are filing the bug, you can also request developers to consider
+            your bug in different ways (such as requesting review for the patch you
+            just attached, requesting your bug to block the next release of the
+            product, and many other product specific requests).
+          </p></li><li class="listitem"><p>
+            Now is a good time to read your bug report again. Remove all misspellings,
+            otherwise your bug may not be found by developers running queries for some
+            specific words, and so your bug would not get any attention.
+            Also make sure you didn't forget any important information developers
+            should know in order to reproduce the problem, and make sure your
+            description of the problem is explicit and clear enough.
+            When you think your bug report is ready to go, the last step is to
+            click the <span class="quote">“<span class="quote">Commit</span>”</span> button to add your report into the database.
+          </p></li></ol></div><p>
+      You do not need to put "any" or similar strings in the URL field.
+      If there is no specific URL associated with the bug, leave this 
+      field blank.
+      </p><p>If you feel a bug you filed was incorrectly marked as a
+      DUPLICATE of another, please question it in your bug, not      
+      the bug it was duped to. Feel free to CC the person who duped it 
+      if they are not already CCed.
+      </p></div><div class="section" title="5.6.2. Clone an Existing Bug"><div class="titlepage"><div><div><h3 class="title"><a name="cloningbugs"></a>5.6.2. Clone an Existing Bug</h3></div></div></div><p>
+        Starting with version 2.20, Bugzilla has a feature that allows you
+        to clone an existing bug. The newly created bug will inherit
+        most settings from the old bug. This allows you to track more
+        easily similar concerns in a new bug. To use this, go to the bug
+        that you want to clone, then click the <span class="quote">“<span class="quote">Clone This Bug</span>”</span>
+        link on the bug page. This will take you to the <span class="quote">“<span class="quote">Enter Bug</span>”</span>
+        page that is filled with the values that the old bug has.
+        You can change those values and/or texts if needed.
+      </p></div></div><div class="section" title="5.7. Attachments"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="attachments"></a>5.7. Attachments</h2></div></div></div><p>
+      You should use attachments, rather than comments, for large chunks of ASCII
+      data, such as trace, debugging output files, or log files. That way, it
+      doesn't bloat the bug for everyone who wants to read it, and cause people to
+      receive fat, useless mails.
+    </p><p>You should make sure to trim screenshots. There's no need to show the
+      whole screen if you are pointing out a single-pixel problem.
+    </p><p>Bugzilla stores and uses a Content-Type for each attachment
+      (e.g. text/html). To download an attachment as a different
+      Content-Type (e.g. application/xhtml+xml), you can override this
+      using a 'content_type' parameter on the URL, e.g.
+      <code class="filename">&amp;content_type=text/plain</code>.
+    </p><p>
+      Also, you can enter the URL pointing to the attachment instead of
+      uploading the attachment itself. For example, this is useful if you want to
+      point to an external application, a website or a very large file. Note that
+      there is no guarantee that the source file will always be available, nor
+      that its content will remain unchanged.
+    </p><p>
+      Another way to attach data is to paste text directly in the text field,
+      and Bugzilla will convert it into an attachment. This is pretty useful
+      when you do copy and paste, and you don't want to put the text in a temporary
+      file first.
+    </p><div class="section" title="5.7.1. Patch Viewer"><div class="titlepage"><div><div><h3 class="title"><a name="patchviewer"></a>5.7.1. Patch Viewer</h3></div></div></div><p>Viewing and reviewing patches in Bugzilla is often difficult due to
+      lack of context, improper format and the inherent readability issues that
+      raw patches present.  Patch Viewer is an enhancement to Bugzilla designed
+      to fix that by offering increased context, linking to sections, and
+      integrating with Bonsai, LXR and CVS.</p><p>Patch viewer allows you to:</p><table border="0" summary="Simple list" class="simplelist"><tr><td>View patches in color, with side-by-side view rather than trying
+        to interpret the contents of the patch.</td></tr><tr><td>See the difference between two patches.</td></tr><tr><td>Get more context in a patch.</td></tr><tr><td>Collapse and expand sections of a patch for easy
+        reading.</td></tr><tr><td>Link to a particular section of a patch for discussion or
+        review</td></tr><tr><td>Go to Bonsai or LXR to see more context, blame, and
+        cross-references for the part of the patch you are looking at</td></tr><tr><td>Create a rawtext unified format diff out of any patch, no
+        matter what format it came from</td></tr></table><div class="section" title="5.7.1.1. Viewing Patches in Patch Viewer"><div class="titlepage"><div><div><h4 class="title"><a name="patchviewer_view"></a>5.7.1.1. Viewing Patches in Patch Viewer</h4></div></div></div><p>The main way to view a patch in patch viewer is to click on the
+        "Diff" link next to a patch in the Attachments list on a bug. You may
+        also do this within the edit window by clicking the "View Attachment As
+        Diff" button in the Edit Attachment screen.</p></div><div class="section" title="5.7.1.2. Seeing the Difference Between Two Patches"><div class="titlepage"><div><div><h4 class="title"><a name="patchviewer_diff"></a>5.7.1.2. Seeing the Difference Between Two Patches</h4></div></div></div><p>To see the difference between two patches, you must first view the
+        newer patch in Patch Viewer.  Then select the older patch from the
+        dropdown at the top of the page ("Differences between [dropdown] and
+        this patch") and click the "Diff" button. This will show you what
+        is new or changed in the newer patch.</p></div><div class="section" title="5.7.1.3. Getting More Context in a Patch"><div class="titlepage"><div><div><h4 class="title"><a name="patchviewer_context"></a>5.7.1.3. Getting More Context in a Patch</h4></div></div></div><p>To get more context in a patch, you put a number in the textbox at
+        the top of Patch Viewer ("Patch / File / [textbox]") and hit enter.
+        This will give you that many lines of context before and after each
+        change. Alternatively, you can click on the "File" link there and it
+        will show each change in the full context of the file. This feature only
+        works against files that were diffed using "cvs diff".</p></div><div class="section" title="5.7.1.4. Collapsing and Expanding Sections of a Patch"><div class="titlepage"><div><div><h4 class="title"><a name="patchviewer_collapse"></a>5.7.1.4. Collapsing and Expanding Sections of a Patch</h4></div></div></div><p>To view only a certain set of files in a patch (for example, if a
+        patch is absolutely huge and you want to only review part of it at a
+        time), you can click the "(+)" and "(-)" links next to each file (to
+        expand it or collapse it). If you want to collapse all files or expand
+        all files, you can click the "Collapse All" and "Expand All" links at the
+        top of the page.</p></div><div class="section" title="5.7.1.5. Linking to a Section of a Patch"><div class="titlepage"><div><div><h4 class="title"><a name="patchviewer_link"></a>5.7.1.5. Linking to a Section of a Patch</h4></div></div></div><p>To link to a section of a patch (for example, if you want to be
+        able to give someone a URL to show them which part you are talking
+        about) you simply click the "Link Here" link on the section header. The
+        resulting URL can be copied and used in discussion.</p></div><div class="section" title="5.7.1.6. Going to Bonsai and LXR"><div class="titlepage"><div><div><h4 class="title"><a name="patchviewer_bonsai_lxr"></a>5.7.1.6. Going to Bonsai and LXR</h4></div></div></div><p>To go to Bonsai to get blame for the lines you are interested in,
+        you can click the "Lines XX-YY" link on the section header you are
+        interested in. This works even if the patch is against an old
+        version of the file, since Bonsai stores all versions of the file.</p><p>To go to LXR, you click on the filename on the file header
+        (unfortunately, since LXR only does the most recent version, line
+        numbers are likely to rot).</p></div><div class="section" title="5.7.1.7. Creating a Unified Diff"><div class="titlepage"><div><div><h4 class="title"><a name="patchviewer_unified_diff"></a>5.7.1.7. Creating a Unified Diff</h4></div></div></div><p>If the patch is not in a format that you like, you can turn it
+        into a unified diff format by clicking the "Raw Unified" link at the top
+        of the page.</p></div></div></div><div class="section" title="5.8. Hints and Tips"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="hintsandtips"></a>5.8. Hints and Tips</h2></div></div></div><p>This section distills some Bugzilla tips and best practices
+    that have been developed.</p><div class="section" title="5.8.1. Autolinkification"><div class="titlepage"><div><div><h3 class="title"><a name="idp11248736"></a>5.8.1. Autolinkification</h3></div></div></div><p>Bugzilla comments are plain text - so typing &lt;U&gt; will
+      produce less-than, U, greater-than rather than underlined text.
+      However, Bugzilla will automatically make hyperlinks out of certain
+      sorts of text in comments. For example, the text 
+      "http://www.bugzilla.org" will be turned into a link:
+      <a class="ulink" href="http://www.bugzilla.org" target="_top">http://www.bugzilla.org</a>.
+      Other strings which get linkified in the obvious manner are:
+      </p><table border="0" summary="Simple list" class="simplelist"><tr><td>bug 12345</td></tr><tr><td>comment 7</td></tr><tr><td>bug 23456, comment 53</td></tr><tr><td>attachment 4321</td></tr><tr><td>mailto:george@example.com</td></tr><tr><td>george@example.com</td></tr><tr><td>ftp://ftp.mozilla.org</td></tr><tr><td>Most other sorts of URL</td></tr></table><p>
+      </p><p>A corollary here is that if you type a bug number in a comment,
+      you should put the word "bug" before it, so it gets autolinkified
+      for the convenience of others.
+      </p></div><div class="section" title="5.8.2. Comments"><div class="titlepage"><div><div><h3 class="title"><a name="commenting"></a>5.8.2. Comments</h3></div></div></div><p>If you are changing the fields on a bug, only comment if
+      either you have something pertinent to say, or Bugzilla requires it.
+      Otherwise, you may spam people unnecessarily with bug mail.
+      To take an example: a user can set up their account to filter out messages
+      where someone just adds themselves to the CC field of a bug
+      (which happens a lot.) If you come along, add yourself to the CC field,
+      and add a comment saying "Adding self to CC", then that person
+      gets a pointless piece of mail they would otherwise have avoided.
+      </p><p>
+      Don't use sigs in comments. Signing your name ("Bill") is acceptable,
+      if you do it out of habit, but full mail/news-style
+      four line ASCII art creations are not.
+      </p></div><div class="section" title="5.8.3. Server-Side Comment Wrapping"><div class="titlepage"><div><div><h3 class="title"><a name="comment-wrapping"></a>5.8.3. Server-Side Comment Wrapping</h3></div></div></div><p>
+      Bugzilla stores comments unwrapped and wraps them at display time. This
+      ensures proper wrapping in all browsers. Lines beginning with the "&gt;" 
+      character are assumed to be quotes, and are not wrapped.
+      </p></div><div class="section" title="5.8.4. Dependency Tree"><div class="titlepage"><div><div><h3 class="title"><a name="dependencytree"></a>5.8.4. Dependency Tree</h3></div></div></div><p>
+        On the <span class="quote">“<span class="quote">Dependency tree</span>”</span> page linked from each bug
+        page, you can see the dependency relationship from the bug as a
+        tree structure.
+      </p><p>
+        You can change how much depth to show, and you can hide resolved bugs
+        from this page. You can also collaps/expand dependencies for
+        each bug on the tree view, using the [-]/[+] buttons that appear
+        before its summary. This option is not available for terminal
+        bugs in the tree (that don't have further dependencies).
+      </p></div></div><div class="section" title="5.9. Time Tracking Information"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="timetracking"></a>5.9. Time Tracking Information</h2></div></div></div><p>
+      Users who belong to the group specified by the <span class="quote">“<span class="quote">timetrackinggroup</span>”</span>
+      parameter have access to time-related fields. Developers can see
+      deadlines and estimated times to fix bugs, and can provide time spent
+      on these bugs.
+    </p><p>
+      At any time, a summary of the time spent by developers on bugs is
+      accessible either from bug lists when clicking the <span class="quote">“<span class="quote">Time Summary</span>”</span>
+      button or from individual bugs when clicking the <span class="quote">“<span class="quote">Summarize time</span>”</span>
+      link in the time tracking table. The <code class="filename">summarize_time.cgi</code>
+      page lets you view this information either per developer or per bug,
+      and can be split on a month basis to have greater details on how time
+      is spent by developers.
+    </p><p>
+      As soon as a bug is marked as RESOLVED, the remaining time expected
+      to fix the bug is set to zero. This lets QA people set it again for
+      their own usage, and it will be set to zero again when the bug will
+      be marked as CLOSED.
+    </p></div><div class="section" title="5.10. User Preferences"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="userpreferences"></a>5.10. User Preferences</h2></div></div></div><p>
+    Once logged in, you can customize various aspects of
+    Bugzilla via the "Preferences" link in the page footer.
+    The preferences are split into five tabs:</p><div class="section" title="5.10.1. General Preferences"><div class="titlepage"><div><div><h3 class="title"><a name="generalpreferences"></a>5.10.1. General Preferences</h3></div></div></div><p>
+        This tab allows you to change several default settings of Bugzilla.
+      </p><div class="itemizedlist"><ul class="itemizedlist" type="disc" compact><li class="listitem"><p>
+            Bugzilla's general appearance (skin) - select which skin to use.
+            Bugzilla supports adding custom skins.
+          </p></li><li class="listitem"><p>
+            Quote the associated comment when you click on its reply link - sets
+            the behavior of the comment "Reply" link. Options include quoting the
+            full comment, just reference the comment number, or turn the link off.
+          </p></li><li class="listitem"><p>
+            Language used in email - select which language email will be sent in,
+            from the list of available languages.
+          </p></li><li class="listitem"><p>
+            After changing a bug - This controls what page is displayed after
+            changes to a bug are submitted. The options include to show the bug
+            just modified, to show the next bug in your list, or to do nothing.
+          </p></li><li class="listitem"><p>
+            Enable tags for bugs - turn bug tagging on or off.
+          </p></li><li class="listitem"><p>
+            Zoom textareas large when in use (requires JavaScript) - enable or
+            disable the automatic expanding of text areas when  text is being
+            entered into them. 
+          </p></li><li class="listitem"><p>
+            Field separator character for CSV files -
+            Select between a comma and semi-colon for exported CSV bug lists.
+          </p></li><li class="listitem"><p>
+            Automatically add me to the CC list of bugs I change - set default
+            behavior of CC list. Options include "Always", "Never", and "Only
+            if I have no role on them". 
+          </p></li><li class="listitem"><p>
+            When viewing a bug, show comments in this order -
+            controls the order of comments. Options include "Oldest
+            to Newest", "Newest to Oldest" and "Newest to Oldest, but keep the
+            bug description at the top".
+          </p></li><li class="listitem"><p>
+            Show a quip at the top of each bug list - controls
+            whether a quip will be shown on the Bug list page.
+          </p></li></ul></div></div><div class="section" title="5.10.2. Email Preferences"><div class="titlepage"><div><div><h3 class="title"><a name="emailpreferences"></a>5.10.2. Email Preferences</h3></div></div></div><p>
+        This tab allows you to enable or disable email notification on
+        specific events.
+      </p><p>
+        In general, users have almost complete control over how much (or
+        how little) email Bugzilla sends them. If you want to receive the
+        maximum amount of email possible, click the <span class="quote">“<span class="quote">Enable All 
+        Mail</span>”</span> button. If you don't want to receive any email from
+        Bugzilla at all, click the <span class="quote">“<span class="quote">Disable All Mail</span>”</span> button.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          A Bugzilla administrator can stop a user from receiving
+          bugmail by clicking the <span class="quote">“<span class="quote">Bugmail Disabled</span>”</span> checkbox
+          when editing the user account. This is a drastic step
+          best taken only for disabled accounts, as it overrides 
+          the user's individual mail preferences.
+        </p></td></tr></table></div><p>
+        There are two global options -- <span class="quote">“<span class="quote">Email me when someone
+        asks me to set a flag</span>”</span> and <span class="quote">“<span class="quote">Email me when someone
+        sets a flag I asked for</span>”</span>. These define how you want to
+        receive bugmail with regards to flags. Their use is quite
+        straightforward; enable the checkboxes if you want Bugzilla to
+        send you mail under either of the above conditions.
+      </p><p>
+        If you'd like to set your bugmail to something besides
+        'Completely ON' and 'Completely OFF', the
+        <span class="quote">“<span class="quote">Field/recipient specific options</span>”</span> table
+        allows you to do just that. The rows of the table
+        define events that can happen to a bug -- things like
+        attachments being added, new comments being made, the
+        priority changing, etc. The columns in the table define
+        your relationship with the bug:
+      </p><div class="itemizedlist"><ul class="itemizedlist" type="disc" compact><li class="listitem"><p>
+            Reporter - Where you are the person who initially
+            reported the bug. Your name/account appears in the
+            <span class="quote">“<span class="quote">Reporter:</span>”</span> field.
+          </p></li><li class="listitem"><p>
+            Assignee - Where you are the person who has been
+            designated as the one responsible for the bug. Your
+            name/account appears in the <span class="quote">“<span class="quote">Assigned To:</span>”</span>
+            field of the bug.
+          </p></li><li class="listitem"><p>
+            QA Contact - You are one of the designated
+            QA Contacts for the bug. Your account appears in the 
+            <span class="quote">“<span class="quote">QA Contact:</span>”</span> text-box of the bug.
+          </p></li><li class="listitem"><p>
+            CC - You are on the list CC List for the bug.
+            Your account appears in the <span class="quote">“<span class="quote">CC:</span>”</span> text box
+            of the bug.
+          </p></li><li class="listitem"><p>
+            Voter - You have placed one or more votes for the bug.
+            Your account appears only if someone clicks on the 
+            <span class="quote">“<span class="quote">Show votes for this bug</span>”</span> link on the bug.
+          </p></li></ul></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Some columns may not be visible for your installation, depending
+          on your site's configuration.
+        </p></td></tr></table></div><p>
+        To fine-tune your bugmail, decide the events for which you want
+        to receive bugmail; then decide if you want to receive it all
+        the time (enable the checkbox for every column), or only when
+        you have a certain relationship with a bug (enable the checkbox
+        only for those columns). For example: if you didn't want to
+        receive mail when someone added themselves to the CC list, you
+        could uncheck all the boxes in the <span class="quote">“<span class="quote">CC Field Changes</span>”</span>
+        line. As another example, if you never wanted to receive email
+        on bugs you reported unless the bug was resolved, you would
+        un-check all boxes in the <span class="quote">“<span class="quote">Reporter</span>”</span> column
+        except for the one on the <span class="quote">“<span class="quote">The bug is resolved or
+        verified</span>”</span> row.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Bugzilla adds the <span class="quote">“<span class="quote">X-Bugzilla-Reason</span>”</span> header to
+          all bugmail it sends, describing the recipient's relationship
+          (AssignedTo, Reporter, QAContact, CC, or Voter) to the bug.
+          This header can be used to do further client-side filtering.
+        </p></td></tr></table></div><p>
+        Bugzilla has a feature called <span class="quote">“<span class="quote">Users Watching</span>”</span>.
+        When you enter one or more comma-delineated user accounts (usually email
+        addresses) into the text entry box, you will receive a copy of all the
+        bugmail those users are sent (security settings permitting).
+        This powerful functionality enables seamless transitions as developers
+        change projects or users go on holiday.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          The ability to watch other users may not be available in all
+          Bugzilla installations. If you don't see this feature, and feel
+          that you need it, speak to your administrator.
+        </p></td></tr></table></div><p>
+        Each user listed in the <span class="quote">“<span class="quote">Users watching you</span>”</span> field
+        has you listed in their <span class="quote">“<span class="quote">Users to watch</span>”</span> list
+        and can get bugmail according to your relationship to the bug and
+        their <span class="quote">“<span class="quote">Field/recipient specific options</span>”</span> setting.
+      </p></div><div class="section" title="5.10.3. Saved Searches"><div class="titlepage"><div><div><h3 class="title"><a name="savedsearches"></a>5.10.3. Saved Searches</h3></div></div></div><p>
+      On this tab you can view and run any Saved Searches that you have
+      created, and also any Saved Searches that other members of the group
+      defined in the "querysharegroup" parameter have shared. 
+      Saved Searches can be added to the page footer from this screen. 
+      If somebody is sharing a Search with a group she or he is allowed to
+      <a class="link" href="#groups" title="3.15. Groups and Group Security">assign users to</a>, the sharer may opt to have
+      the Search show up in the footer of the group's direct members by default.
+      </p></div><div class="section" title="5.10.4. Name and Password"><div class="titlepage"><div><div><h3 class="title"><a name="accountpreferences"></a>5.10.4. Name and Password</h3></div></div></div><p>On this tab, you can change your basic account information,
+      including your password, email address and real name. For security
+      reasons, in order to change anything on this page you must type your
+      <span class="emphasis"><em>current</em></span> password into the <span class="quote">“<span class="quote">Password</span>”</span>
+      field at the top of the page.
+      If you attempt to change your email address, a confirmation
+      email is sent to both the old and new addresses, with a link to use to
+      confirm the change. This helps to prevent account hijacking.</p></div><div class="section" title="5.10.5. Permissions"><div class="titlepage"><div><div><h3 class="title"><a name="permissionsettings"></a>5.10.5. Permissions</h3></div></div></div><p>
+      This is a purely informative page which outlines your current
+      permissions on this installation of Bugzilla.
+      </p><p>
+      A complete list of permissions is below. Only users with 
+      <span class="emphasis"><em>editusers</em></span> privileges can change the permissions 
+      of other users.
+      </p><div class="variablelist"><dl><dt><span class="term">
+            admin
+          </span></dt><dd><p> 
+             Indicates user is an Administrator.
+            </p></dd><dt><span class="term">
+            bz_canusewhineatothers
+          </span></dt><dd><p> 
+             Indicates user can configure whine reports for other users.
+            </p></dd><dt><span class="term">
+             bz_canusewhines
+          </span></dt><dd><p> 
+             Indicates user can configure whine reports for self.
+            </p></dd><dt><span class="term">
+             bz_quip_moderators
+          </span></dt><dd><p>
+             Indicates user can moderate quips.
+            </p></dd><dt><span class="term">
+             bz_sudoers
+          </span></dt><dd><p> 
+             Indicates user can perform actions as other users.
+            </p></dd><dt><span class="term">
+             bz_sudo_protect
+          </span></dt><dd><p> 
+             Indicates user cannot be impersonated by other users.
+            </p></dd><dt><span class="term">
+             canconfirm
+          </span></dt><dd><p> 
+             Indicates user can confirm a bug or mark it a duplicate.
+            </p></dd><dt><span class="term">
+             creategroups
+          </span></dt><dd><p> 
+             Indicates user can create and destroy groups.
+            </p></dd><dt><span class="term">
+             editbugs
+          </span></dt><dd><p> 
+             Indicates user can edit all bug fields.
+            </p></dd><dt><span class="term">
+             editclassifications
+          </span></dt><dd><p> 
+             Indicates user can create, destroy, and edit classifications.
+            </p></dd><dt><span class="term">
+             editcomponents
+          </span></dt><dd><p> 
+             Indicates user can create, destroy, and edit components.
+            </p></dd><dt><span class="term">
+             editkeywords
+          </span></dt><dd><p> 
+             Indicates user can create, destroy, and edit keywords.
+            </p></dd><dt><span class="term">
+             editusers
+          </span></dt><dd><p> 
+             Indicates user can edit or disable users.
+            </p></dd><dt><span class="term">
+             tweakparams
+          </span></dt><dd><p> 
+             Indicates user can change Parameters.
+            </p></dd></dl></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        For more information on how permissions work in Bugzilla (i.e. who can
+        change what), see  <a class="xref" href="#cust-change-permissions" title="6.4. Customizing Who Can Change What">Section 6.4, “Customizing Who Can Change What”</a>. 
+        </p></td></tr></table></div></div></div><div class="section" title="5.11. Reports and Charts"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="reporting"></a>5.11. Reports and Charts</h2></div></div></div><p>As well as the standard buglist, Bugzilla has two more ways of
+    viewing sets of bugs. These are the reports (which give different
+    views of the current state of the database) and charts (which plot
+    the changes in particular sets of bugs over time.)</p><div class="section" title="5.11.1. Reports"><div class="titlepage"><div><div><h3 class="title"><a name="reports"></a>5.11.1. Reports</h3></div></div></div><p>
+        A report is a view of the current state of the bug database.
+      </p><p>
+        You can run either an HTML-table-based report, or a graphical
+        line/pie/bar-chart-based one. The two have different pages to
+        define them, but are close cousins - once you've defined and
+        viewed a report, you can switch between any of the different
+        views of the data at will.
+      </p><p>
+        Both report types are based on the idea of defining a set of bugs
+        using the standard search interface, and then choosing some
+        aspect of that set to plot on the horizontal and/or vertical axes.
+        You can also get a form of 3-dimensional report by choosing to have
+        multiple images or tables.
+      </p><p>
+        So, for example, you could use the search form to choose "all
+        bugs in the WorldControl product", and then plot their severity
+        against their component to see which component had had the largest
+        number of bad bugs reported against it. 
+      </p><p>
+        Once you've defined your parameters and hit "Generate Report",
+        you can switch between HTML, CSV, Bar, Line and Pie. (Note: Pie
+        is only available if you didn't define a vertical axis, as pie
+        charts don't have one.) The other controls are fairly self-explanatory;
+        you can change the size of the image if you find text is overwriting
+        other text, or the bars are too thin to see.
+      </p></div><div class="section" title="5.11.2. Charts"><div class="titlepage"><div><div><h3 class="title"><a name="charts"></a>5.11.2. Charts</h3></div></div></div><p>
+        A chart is a view of the state of the bug database over time.
+      </p><p>
+        Bugzilla currently has two charting systems - Old Charts and New 
+        Charts. Old Charts have been part of Bugzilla for a long time; they
+        chart each status and resolution for each product, and that's all.
+        They are deprecated, and going away soon - we won't say any more 
+        about them.
+        New Charts are the future - they allow you to chart anything you
+        can define as a search.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Both charting forms require the administrator to set up the
+          data-gathering script. If you can't see any charts, ask them whether
+          they have done so.
+        </p></td></tr></table></div><p>
+        An individual line on a chart is called a data set.
+        All data sets are organised into categories and subcategories. The 
+        data sets that Bugzilla defines automatically use the Product name 
+        as a Category and Component names as Subcategories, but there is no 
+        need for you to follow that naming scheme with your own charts if 
+        you don't want to.
+      </p><p>
+        Data sets may be public or private. Everyone sees public data sets in
+        the list, but only their creator sees private data sets. Only 
+        administrators can make data sets public.
+        No two data sets, even two private ones, can have the same set of 
+        category, subcategory and name. So if you are creating private data 
+        sets, one idea is to have the Category be your username.
+      </p><div class="section" title="5.11.2.1. Creating Charts"><div class="titlepage"><div><div><h4 class="title"><a name="idp11357856"></a>5.11.2.1. Creating Charts</h4></div></div></div><p>
+          You create a chart by selecting a number of data sets from the
+          list, and pressing Add To List for each. In the List Of Data Sets
+          To Plot, you can define the label that data set will have in the
+          chart's legend, and also ask Bugzilla to Sum a number of data sets 
+          (e.g. you could Sum data sets representing RESOLVED, VERIFIED and 
+          CLOSED in a particular product to get a data set representing all 
+          the resolved bugs in that product.)
+        </p><p>
+          If you've erroneously added a data set to the list, select it
+          using the checkbox and click Remove. Once you add more than one 
+          data set, a "Grand Total" line
+          automatically appears at the bottom of the list. If you don't want
+          this, simply remove it as you would remove any other line.
+        </p><p>
+          You may also choose to plot only over a certain date range, and
+          to cumulate the results - that is, to plot each one using the 
+          previous one as a baseline, so the top line gives a sum of all 
+          the data sets. It's easier to try than to explain :-)
+        </p><p>
+          Once a data set is in the list, one can also perform certain 
+          actions on it. For example, one can edit the
+          data set's parameters (name, frequency etc.) if it's one you
+          created or if you are an administrator.
+        </p><p>
+           Once you are happy, click Chart This List to see the chart.
+        </p></div><div class="section" title="5.11.2.2. Creating New Data Sets"><div class="titlepage"><div><div><h4 class="title"><a name="charts-new-series"></a>5.11.2.2. Creating New Data Sets</h4></div></div></div><p>
+          You may also create new data sets of your own. To do this,
+          click the "create a new data set" link on the Create Chart page.
+          This takes you to a search-like interface where you can define
+          the search that Bugzilla will plot. At the bottom of the page,
+          you choose the category, sub-category and name of your new
+          data set. 
+        </p><p>
+          If you have sufficient permissions, you can make the data set public,
+          and reduce the frequency of data collection to less than the default
+          seven days.
+        </p></div></div></div><div class="section" title="5.12. Flags"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="flags"></a>5.12. Flags</h2></div></div></div><p>
+      A flag is a kind of status that can be set on bugs or attachments
+      to indicate that the bugs/attachments are in a certain state.
+      Each installation can define its own set of flags that can be set
+      on bugs or attachments.
+    </p><p>
+      If your installation has defined a flag, you can set or unset that flag,
+      and if your administrator has enabled requesting of flags, you can submit
+      a request for another user to set the flag.
+    </p><p>
+      To set a flag, select either "+" or "-" from the drop-down menu next to
+      the name of the flag in the "Flags" list.  The meaning of these values are
+      flag-specific and thus cannot be described in this documentation,
+      but by way of example, setting a flag named "review" to "+" may indicate
+      that the bug/attachment has passed review, while setting it to "-"
+      may indicate that the bug/attachment has failed review.
+    </p><p>
+      To unset a flag, click its drop-down menu and select the blank value.
+      Note that marking an attachment as obsolete automatically cancels all
+      pending requests for the attachment.
+    </p><p>
+      If your administrator has enabled requests for a flag, request a flag
+      by selecting "?" from the drop-down menu and then entering the username
+      of the user you want to set the flag in the text field next to the menu.
+    </p><p>
+      A set flag appears in bug reports and on "edit attachment" pages with the
+      abbreviated username of the user who set the flag prepended to the
+      flag name. For example, if Jack sets a "review" flag to "+", it appears
+      as Jack: review [ + ]
+    </p><p>
+      A requested flag appears with the user who requested the flag prepended
+      to the flag name and the user who has been requested to set the flag
+      appended to the flag name within parentheses.  For example, if Jack
+      asks Jill for review, it appears as Jack: review [ ? ] (Jill).
+    </p><p>
+      You can browse through open requests made of you and by you by selecting
+      'My Requests' from the footer. You can also look at open requests limited
+      by other requesters, requestees, products, components, and flag names from
+      this page. Note that you can use '-' for requestee to specify flags with
+      'no requestee' set.
+    </p></div><div class="section" title="5.13. Whining"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="whining"></a>5.13. Whining</h2></div></div></div><p>
+      Whining is a feature in Bugzilla that can regularly annoy users at 
+      specified times.  Using this feature, users can execute saved searches 
+      at specific times (i.e. the 15th of the month at midnight) or at 
+      regular intervals (i.e. every 15 minutes on Sundays).  The results of the
+      searches are sent to the user, either as a single email or as one email 
+      per bug, along with some descriptive text.
+    </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        Throughout this section it will be assumed that all users are members 
+        of the bz_canusewhines group, membership in which is required in order 
+        to use the Whining system.  You can easily make all users members of 
+        the bz_canusewhines group by setting the User RegExp to ".*" (without 
+        the quotes).
+      </p><p>
+        Also worth noting is the bz_canusewhineatothers group.  Members of this
+        group can create whines for any user or group in Bugzilla using a 
+        extended form of the whining interface.  Features only available to 
+        members of the bz_canusewhineatothers group will be noted in the 
+        appropriate places.
+      </p></td></tr></table></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        For whining to work, a special Perl script must be executed at regular
+        intervals.  More information on this is available in 
+        <a class="xref" href="#installation-whining" title="2.3.3. Whining">Section 2.3.3, “Whining”</a>.
+      </p></td></tr></table></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        This section does not cover the whineatnews.pl script.  See
+        <a class="xref" href="#installation-whining-cron" title="2.3.2. The Whining Cron">Section 2.3.2, “The Whining Cron”</a> for more information on 
+        The Whining Cron.
+      </p></td></tr></table></div><div class="section" title="5.13.1. The Event"><div class="titlepage"><div><div><h3 class="title"><a name="whining-overview"></a>5.13.1. The Event</h3></div></div></div><p>
+        The whining system defines an "Event" as one or more queries being 
+        executed at regular intervals, with the results of said queries (if
+        there are any) being emailed to the user.  Events are created by 
+        clicking on the "Add new event" button.
+      </p><p>
+        Once a new event is created, the first thing to set is the "Email 
+        subject line".  The contents of this field will be used in the subject
+        line of every email generated by this event.  In addition to setting a 
+        subject, space is provided to enter some descriptive text that will be 
+        included at the top of each message (to help you in understanding why 
+        you received the email in the first place).
+      </p><p>
+        The next step is to specify when the Event is to be run (the Schedule) 
+        and what searches are to be performed (the Searches).
+      </p></div><div class="section" title="5.13.2. Whining Schedule"><div class="titlepage"><div><div><h3 class="title"><a name="whining-schedule"></a>5.13.2. Whining Schedule</h3></div></div></div><p>
+         Each whining event is associated with zero or more schedules.  A 
+         schedule is used to specify when the query (specified below) is to be
+         run.  A new event starts out with no schedules (which means it will 
+         never run, as it is not scheduled to run).  To add a schedule, press
+         the "Add a new schedule" button.
+      </p><p>
+         Each schedule includes an interval, which you use to tell Bugzilla 
+         when the event should be run.  An event can be run on certain days of
+         the week, certain days of the month, during weekdays (defined as 
+         Monday through Friday), or every day.
+      </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Be careful if you set your event to run on the 29th, 30th, or 31st of
+          the month, as your event may not run exactly when expected.  If you 
+          want your event to run on the last day of the month, select "Last day
+          of the month" as the interval.
+        </p></td></tr></table></div><p>
+        Once you have specified the day(s) on which the event is to be run, you
+        should now specify the time at which the event is to be run.  You can 
+        have the event run at a certain hour on the specified day(s), or 
+        every hour, half-hour, or quarter-hour on the specified day(s).
+      </p><p>
+        If a single schedule does not execute an event as many times as you 
+        would want, you can create another schedule for the same event.  For 
+        example, if you want to run an event on days whose numbers are
+        divisible by seven, you would need to add four schedules to the event,
+        setting the schedules to run on the 7th, 14th, 21st, and 28th (one day 
+        per schedule) at whatever time (or times) you choose.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          If you are a member of the bz_canusewhineatothers group, then you
+          will be presented with another option: "Mail to".  Using this you 
+          can control who will receive the emails generated by this event.  You
+          can choose to send the emails to a single user (identified by email 
+          address) or a single group (identified by group name).  To send to 
+          multiple users or groups, create a new schedule for each additional 
+          user/group.
+        </p></td></tr></table></div></div><div class="section" title="5.13.3. Whining Searches"><div class="titlepage"><div><div><h3 class="title"><a name="whining-query"></a>5.13.3. Whining Searches</h3></div></div></div><p>
+        Each whining event is associated with zero or more searches.  A search
+        is any saved search to be run as part of the specified schedule (see
+        above).  You start out without any searches associated with the event
+        (which means that the event will not run, as there will never be any
+        results to return).  To add a search, press the "Include search" button.
+      </p><p>
+        The first field to examine in your newly added search is the Sort field.
+        Searches are run, and results included, in the order specified by the
+        Sort field.  Searches with smaller Sort values will run before searches
+        with bigger Sort values.
+      </p><p>
+        The next field to examine is the Search field.  This is where you 
+        choose the actual search that is to be run.  Instead of defining search
+        parameters here, you are asked to choose from the list of saved 
+        searches (the same list that appears at the bottom of every Bugzilla 
+        page).  You are only allowed to choose from searches that you have 
+        saved yourself (the default saved search, "My Bugs", is not a valid 
+        choice).  If you do not have any saved searches, you can take this 
+        opportunity to create one (see <a class="xref" href="#list" title="5.5.4. Bug Lists">Section 5.5.4, “Bug Lists”</a>).
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          When running queries, the whining system acts as if you are the user
+          executing the query.  This means that the whining system will ignore
+          bugs that match your query, but that you cannot access.
+        </p></td></tr></table></div><p>
+        Once you have chosen the saved search to be executed, give the query a 
+        descriptive title.  This title will appear in the email, above the 
+        results of the query.  If you choose "One message per bug", the query 
+        title will appear at the top of each email that contains a bug matching
+        your query.
+      </p><p>
+        Finally, decide if the results of the query should be sent in a single
+        email, or if each bug should appear in its own email.
+      </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Think carefully before checking the "One message per bug" box.  If
+          you create a query that matches thousands of bugs, you will receive 
+          thousands of emails!
+        </p></td></tr></table></div></div><div class="section" title="5.13.4. Saving Your Changes"><div class="titlepage"><div><div><h3 class="title"><a name="idp11397440"></a>5.13.4. Saving Your Changes</h3></div></div></div><p>
+        Once you have defined at least one schedule, and created at least one 
+        query, go ahead and "Update/Commit".  This will save your Event and make
+        it available for immediate execution.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          If you ever feel like deleting your event, you may do so using the 
+          "Remove Event" button in the upper-right corner of each Event.  You 
+          can also modify an existing event, so long as you "Update/Commit" 
+          after completing your modifications.
+        </p></td></tr></table></div></div></div></div><div class="chapter" title="Chapter 6. Customizing Bugzilla"><div class="titlepage"><div><div><h2 class="title"><a name="customization"></a>Chapter 6. Customizing Bugzilla</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#extensions">6.1. Bugzilla Extensions</a></span></dt><dt><span class="section"><a href="#cust-skins">6.2. Custom Skins</a></span></dt><dt><span class="section"><a href="#cust-templates">6.3. Template Customization</a></span></dt><dd><dl><dt><span class="section"><a href="#template-directory">6.3.1. Template Directory Structure</a></span></dt><dt><span class="section"><a href="#template-method">6.3.2. Choosing a Customization Method</a></span></dt><dt><span class="section"><a href="#template-edit">6.3.3. How To Edit Templates</a></span></dt><dt><span class="section"><a href="#template-formats">6.3.4. Template Formats and Types</a></span></dt><dt><span class="section"><a href="#template-specific">6.3.5. Particular Templates</a></span></dt><dt><span class="section"><a href="#template-http-accept">6.3.6. Configuring Bugzilla to Detect the User's Language</a></span></dt></dl></dd><dt><span class="section"><a href="#cust-change-permissions">6.4. Customizing Who Can Change What</a></span></dt><dt><span class="section"><a href="#integration">6.5. Integrating Bugzilla with Third-Party Tools</a></span></dt></dl></div><div class="section" title="6.1. Bugzilla Extensions"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="extensions"></a>6.1. Bugzilla Extensions</h2></div></div></div><p>
+      One of the best ways to customize Bugzilla is by writing a Bugzilla
+      Extension. Bugzilla Extensions let you modify both the code and
+      UI of Bugzilla in a way that can be distributed to other Bugzilla
+      users and ported forward to future versions of Bugzilla with minimal
+      effort.
+    </p><p>
+         See the <a class="ulink" href="../html/api/Bugzilla/Extension.html" target="_top">Bugzilla Extension
+      documentation</a> for information on how to write an Extension.
+    </p></div><div class="section" title="6.2. Custom Skins"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="cust-skins"></a>6.2. Custom Skins</h2></div></div></div><p>
+      Bugzilla allows you to have multiple skins. These are custom CSS and possibly
+      also custom images for Bugzilla. To create a new custom skin, you have two
+      choices:
+      </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
+            Make a single CSS file, and put it in the 
+            <code class="filename">skins/contrib</code> directory.
+          </p></li><li class="listitem"><p>
+            Make a directory that contains all the same CSS file
+            names as <code class="filename">skins/standard/</code>, and put
+            your directory in <code class="filename">skins/contrib/</code>.
+          </p></li></ul></div><p>
+    </p><p>
+      After you put the file or the directory there, make sure to run checksetup.pl
+      so that it can reset the file permissions correctly.
+    </p><p>
+      After you have installed the new skin, it will show up as an option in the
+      user's General Preferences. If you would like to force a particular skin on all
+      users, just select it in the Default Preferences and then uncheck "Enabled" on
+      the preference.
+    </p></div><div class="section" title="6.3. Template Customization"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="cust-templates"></a>6.3. Template Customization</h2></div></div></div><p>
+      Administrators can configure the look and feel of Bugzilla without
+      having to edit Perl files or face the nightmare of massive merge
+      conflicts when they upgrade to a newer version in the future.
+    </p><p>
+      Templatization also makes localized versions of Bugzilla possible, 
+      for the first time. It's possible to have Bugzilla's UI language 
+      determined by the user's browser. More information is available in
+      <a class="xref" href="#template-http-accept" title="6.3.6. Configuring Bugzilla to Detect the User's Language">Section 6.3.6, “Configuring Bugzilla to Detect the User's Language”</a>.
+    </p><div class="section" title="6.3.1. Template Directory Structure"><div class="titlepage"><div><div><h3 class="title"><a name="template-directory"></a>6.3.1. Template Directory Structure</h3></div></div></div><p>
+        The template directory structure starts with top level directory 
+        named <code class="filename">template</code>, which contains a directory
+        for each installed localization. The next level defines the
+        language used in the templates. Bugzilla comes with English
+        templates, so the directory name is <code class="filename">en</code>,
+        and we will discuss <code class="filename">template/en</code> throughout
+        the documentation. Below <code class="filename">template/en</code> is the
+        <code class="filename">default</code> directory, which contains all the
+        standard templates shipped with Bugzilla.
+      </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          A directory <code class="filename">data/templates</code> also exists;
+          this is where Template Toolkit puts the compiled versions of
+          the templates from either the default or custom directories.
+          <span class="emphasis"><em>Do not</em></span> directly edit the files in this
+          directory, or all your changes will be lost the next time
+          Template Toolkit recompiles the templates.
+        </p></td></tr></table></div></div><div class="section" title="6.3.2. Choosing a Customization Method"><div class="titlepage"><div><div><h3 class="title"><a name="template-method"></a>6.3.2. Choosing a Customization Method</h3></div></div></div><p>
+        If you want to edit Bugzilla's templates, the first decision
+        you must make is how you want to go about doing so. There are two
+        choices, and which you use depends mainly on the scope of your 
+        modifications, and the method you plan to use to upgrade Bugzilla.
+      </p><p>
+        The first method of making customizations is to directly edit the
+        templates found in <code class="filename">template/en/default</code>.
+        This is probably the best way to go about it if you are going to
+        be upgrading Bugzilla through Bzr, because if you then execute
+        a <span class="command"><strong>bzr update</strong></span>, any changes you have made will
+        be merged automagically with the updated versions.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          If you use this method, and Bzr conflicts occur during an
+          update, the conflicted templates (and possibly other parts
+          of your installation) will not work until they are resolved.
+        </p></td></tr></table></div><p>
+        The second method is to copy the templates to be modified
+        into a mirrored directory structure under 
+        <code class="filename">template/en/custom</code>. Templates in this
+        directory structure automatically override any identically-named
+        and identically-located templates in the 
+        <code class="filename">default</code> directory. 
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          The <code class="filename">custom</code> directory does not exist
+          at first and must be created if you want to use it.
+        </p></td></tr></table></div><p>
+        The second method of customization should be used if you 
+        use the overwriting method of upgrade, because otherwise 
+        your changes will be lost.  This method may also be better if
+        you are using the Bzr method of upgrading and are going to make major
+        changes, because it is guaranteed that the contents of this directory
+        will not be touched during an upgrade, and you can then decide whether
+        to continue using your own templates, or make the effort to merge your
+        changes into the new versions by hand.
+      </p><p>
+        Using this method, your installation may break if incompatible
+        changes are made to the template interface.  Such changes should
+        be documented in the release notes, provided you are using a
+        stable release of Bugzilla.  If you use using unstable code, you will
+        need to deal with this one yourself, although if possible the changes
+        will be mentioned before they occur in the deprecations section of the
+        previous stable release's release notes.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Regardless of which method you choose, it is recommended that
+          you run <span class="command"><strong>./checksetup.pl</strong></span> after 
+          editing any templates in the <code class="filename">template/en/default</code>
+          directory, and after creating or editing any templates in the 
+          <code class="filename">custom</code> directory.
+        </p></td></tr></table></div><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          It is <span class="emphasis"><em>required</em></span> that you run 
+          <span class="command"><strong>./checksetup.pl</strong></span> after creating a new
+          template in the <code class="filename">custom</code> directory. Failure
+          to do so will raise an incomprehensible error message.
+        </p></td></tr></table></div></div><div class="section" title="6.3.3. How To Edit Templates"><div class="titlepage"><div><div><h3 class="title"><a name="template-edit"></a>6.3.3. How To Edit Templates</h3></div></div></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          If you are making template changes that you intend on submitting back
+          for inclusion in standard Bugzilla, you should read the relevant
+          sections of the 
+          <a class="ulink" href="http://www.bugzilla.org/docs/developer.html" target="_top">Developers'
+          Guide</a>.
+        </p></td></tr></table></div><p>
+        The syntax of the Template Toolkit language is beyond the scope of
+        this guide. It's reasonably easy to pick up by looking at the current 
+        templates; or, you can read the manual, available on the
+        <a class="ulink" href="http://www.template-toolkit.org" target="_top">Template Toolkit home
+        page</a>.
+      </p><p>
+        One thing you should take particular care about is the need
+        to properly HTML filter data that has been passed into the template.
+        This means that if the data can possibly contain special HTML characters
+        such as &lt;, and the data was not intended to be HTML, they need to be
+        converted to entity form, i.e. &amp;lt;.  You use the 'html' filter in the
+        Template Toolkit to do this (or the 'uri' filter to encode special
+        characters in URLs).  If you forget, you may open up your installation
+        to cross-site scripting attacks.
+      </p><p>
+        Editing templates is a good way of doing a <span class="quote">“<span class="quote">poor man's custom
+        fields</span>”</span>.
+        For example, if you don't use the Status Whiteboard, but want to have
+        a free-form text entry box for <span class="quote">“<span class="quote">Build Identifier</span>”</span>,
+        then you can just
+        edit the templates to change the field labels. It's still be called
+        status_whiteboard internally, but your users don't need to know that.
+      </p></div><div class="section" title="6.3.4. Template Formats and Types"><div class="titlepage"><div><div><h3 class="title"><a name="template-formats"></a>6.3.4. Template Formats and Types</h3></div></div></div><p>
+        Some CGI's have the ability to use more than one template. For example,
+        <code class="filename">buglist.cgi</code> can output itself as RDF, or as two 
+        formats of HTML (complex and simple). The mechanism that provides this 
+        feature is extensible.
+      </p><p>
+        Bugzilla can support different types of output, which again can have 
+        multiple formats. In order to request a certain type, you can append 
+        the &amp;ctype=&lt;contenttype&gt; (such as rdf or html) to the 
+        <code class="filename">&lt;cginame&gt;.cgi</code> URL. If you would like to 
+        retrieve a certain format, you can use the &amp;format=&lt;format&gt; 
+        (such as simple or complex) in the URL.
+      </p><p>
+        To see if a CGI supports multiple output formats and types, grep the
+        CGI for <span class="quote">“<span class="quote">get_format</span>”</span>. If it's not present, adding
+        multiple format/type support isn't too hard - see how it's done in
+        other CGIs, e.g. config.cgi.
+      </p><p>
+        To make a new format template for a CGI which supports this, 
+        open a current template for
+        that CGI and take note of the INTERFACE comment (if present.) This 
+        comment defines what variables are passed into this template. If 
+        there isn't one, I'm afraid you'll have to read the template and
+        the code to find out what information you get. 
+      </p><p>
+        Write your template in whatever markup or text style is appropriate.
+      </p><p>
+        You now need to decide what content type you want your template
+        served as. The content types are defined in the
+        <code class="filename">Bugzilla/Constants.pm</code> file in the 
+        <code class="filename">contenttypes</code>
+        constant. If your content type is not there, add it. Remember
+        the three- or four-letter tag assigned to your content type. 
+        This tag will be part of the template filename.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          After adding or changing a content type, it's suitable to edit
+          <code class="filename">Bugzilla/Constants.pm</code> in order to reflect
+          the changes. Also, the file should be kept up to date after an
+          upgrade if content types have been customized in the past. 
+        </p></td></tr></table></div><p>
+        Save the template as <code class="filename">&lt;stubname&gt;-&lt;formatname&gt;.&lt;contenttypetag&gt;.tmpl</code>. 
+        Try out the template by calling the CGI as 
+        <code class="filename">&lt;cginame&gt;.cgi?format=&lt;formatname&gt;&amp;ctype=&lt;type&gt;</code> .
+      </p></div><div class="section" title="6.3.5. Particular Templates"><div class="titlepage"><div><div><h3 class="title"><a name="template-specific"></a>6.3.5. Particular Templates</h3></div></div></div><p>
+        There are a few templates you may be particularly interested in
+        customizing for your installation.
+      </p><p>
+        <span class="command"><strong>index.html.tmpl</strong></span>:
+        This is the Bugzilla front page.
+      </p><p>
+        <span class="command"><strong>global/header.html.tmpl</strong></span>:
+        This defines the header that goes on all Bugzilla pages.
+        The header includes the banner, which is what appears to users
+        and is probably what you want to edit instead.  However the
+        header also includes the HTML HEAD section, so you could for
+        example add a stylesheet or META tag by editing the header.
+      </p><p>
+        <span class="command"><strong>global/banner.html.tmpl</strong></span>:
+        This contains the <span class="quote">“<span class="quote">banner</span>”</span>, the part of the header
+        that appears
+        at the top of all Bugzilla pages.  The default banner is reasonably
+        barren, so you'll probably want to customize this to give your
+        installation a distinctive look and feel.  It is recommended you
+        preserve the Bugzilla version number in some form so the version 
+        you are running can be determined, and users know what docs to read.
+      </p><p>
+        <span class="command"><strong>global/footer.html.tmpl</strong></span>:
+        This defines the footer that goes on all Bugzilla pages.  Editing
+        this is another way to quickly get a distinctive look and feel for
+        your Bugzilla installation.
+      </p><p>
+        <span class="command"><strong>global/variables.none.tmpl</strong></span>:
+        This defines a list of terms that may be changed in order to
+        <span class="quote">“<span class="quote">brand</span>”</span> the Bugzilla instance In this way, terms
+        like <span class="quote">“<span class="quote">bugs</span>”</span> can be replaced with <span class="quote">“<span class="quote">issues</span>”</span>
+        across the whole Bugzilla installation. The name
+        <span class="quote">“<span class="quote">Bugzilla</span>”</span> and other words can be customized as well.
+      </p><p>
+        <span class="command"><strong>list/table.html.tmpl</strong></span>:
+        This template controls the appearance of the bug lists created
+        by Bugzilla. Editing this template allows per-column control of 
+        the width and title of a column, the maximum display length of
+        each entry, and the wrap behaviour of long entries.
+        For long bug lists, Bugzilla inserts a 'break' every 100 bugs by
+        default; this behaviour is also controlled by this template, and
+        that value can be modified here.
+       </p><p>
+        <span class="command"><strong>bug/create/user-message.html.tmpl</strong></span>:
+        This is a message that appears near the top of the bug reporting page.
+        By modifying this, you can tell your users how they should report
+        bugs.
+      </p><p>
+        <span class="command"><strong>bug/process/midair.html.tmpl</strong></span>:
+        This is the page used if two people submit simultaneous changes to the
+        same bug.  The second person to submit their changes will get this page
+        to tell them what the first person did, and ask if they wish to
+        overwrite those changes or go back and revisit the bug.  The default
+        title and header on this page read "Mid-air collision detected!"  If
+        you work in the aviation industry, or other environment where this
+        might be found offensive (yes, we have true stories of this happening)
+        you'll want to change this to something more appropriate for your
+        environment.
+      </p><p>
+        <span class="command"><strong>bug/create/create.html.tmpl</strong></span> and
+        <span class="command"><strong>bug/create/comment.txt.tmpl</strong></span>:
+        You may not wish to go to the effort of creating custom fields in
+        Bugzilla, yet you want to make sure that each bug report contains
+        a number of pieces of important information for which there is not
+        a special field. The bug entry system has been designed in an
+        extensible fashion to enable you to add arbitrary HTML widgets,
+        such as drop-down lists or textboxes, to the bug entry page
+        and have their values appear formatted in the initial comment.
+        A hidden field that indicates the format should be added inside
+        the form in order to make the template functional. Its value should
+        be the suffix of the template filename. For example, if the file
+        is called <code class="filename">create-cust.html.tmpl</code>, then
+        </p><pre class="programlisting">&lt;input type="hidden" name="format" value="cust"&gt;</pre><p>
+        should be used inside the form.
+      </p><p>  
+        An example of this is the mozilla.org 
+        <a class="ulink" href="http://landfill.bugzilla.org/bugzilla-tip/enter_bug.cgi?product=WorldControl;format=guided" target="_top">guided
+        bug submission form</a>. The code for this comes with the Bugzilla
+        distribution as an example for you to copy. It can be found in the
+        files 
+        <code class="filename">create-guided.html.tmpl</code> and
+        <code class="filename">comment-guided.html.tmpl</code>.
+      </p><p>
+        So to use this feature, create a custom template for 
+        <code class="filename">enter_bug.cgi</code>. The default template, on which you
+        could base it, is 
+        <code class="filename">custom/bug/create/create.html.tmpl</code>.
+        Call it <code class="filename">create-&lt;formatname&gt;.html.tmpl</code>, and
+        in it, add widgets for each piece of information you'd like
+        collected - such as a build number, or set of steps to reproduce.
+      </p><p>
+        Then, create a template like 
+        <code class="filename">custom/bug/create/comment.txt.tmpl</code>, and call it 
+        <code class="filename">comment-&lt;formatname&gt;.txt.tmpl</code>. This 
+        template should reference the form fields you have created using
+        the syntax <code class="filename">[% form.&lt;fieldname&gt; %]</code>. When a 
+        bug report is
+        submitted, the initial comment attached to the bug report will be
+        formatted according to the layout of this template.
+      </p><p>
+        For example, if your custom enter_bug template had a field
+        </p><pre class="programlisting">&lt;input type="text" name="buildid" size="30"&gt;</pre><p>
+        and then your comment.txt.tmpl had
+        </p><pre class="programlisting">BuildID: [% form.buildid %]</pre><p>
+        then something like
+        </p><pre class="programlisting">BuildID: 20020303</pre><p>
+        would appear in the initial comment.
+      </p></div><div class="section" title="6.3.6. Configuring Bugzilla to Detect the User's Language"><div class="titlepage"><div><div><h3 class="title"><a name="template-http-accept"></a>6.3.6. Configuring Bugzilla to Detect the User's Language</h3></div></div></div><p>Bugzilla honours the user's Accept: HTTP header. You can install
+      templates in other languages, and Bugzilla will pick the most appropriate
+      according to a priority order defined by you. Many
+      language templates can be obtained from <a class="ulink" href="http://www.bugzilla.org/download.html#localizations" target="_top">http://www.bugzilla.org/download.html#localizations</a>. Instructions
+      for submitting new languages are also available from that location.
+      </p></div></div><div class="section" title="6.4. Customizing Who Can Change What"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="cust-change-permissions"></a>6.4. Customizing Who Can Change What</h2></div></div></div><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        This feature should be considered experimental; the Bugzilla code you
+        will be changing is not stable, and could change or move between 
+        versions. Be aware that if you make modifications as outlined here, 
+        you may have
+        to re-make them or port them if Bugzilla changes internally between
+        versions, and you upgrade.
+      </p></td></tr></table></div><p>
+      Companies often have rules about which employees, or classes of employees,
+      are allowed to change certain things in the bug system. For example, 
+      only the bug's designated QA Contact may be allowed to VERIFY the bug.
+      Bugzilla has been
+      designed to make it easy for you to write your own custom rules to define
+      who is allowed to make what sorts of value transition.
+    </p><p>
+     By default, assignees, QA owners and users
+     with <span class="emphasis"><em>editbugs</em></span> privileges can edit all fields of bugs, 
+     except group restrictions (unless they are members of the groups they 
+     are trying to change). Bug reporters also have the ability to edit some 
+     fields, but in a more restrictive manner. Other users, without 
+     <span class="emphasis"><em>editbugs</em></span> privileges, cannot edit 
+     bugs, except to comment and add themselves to the CC list.
+    </p><p>
+      For maximum flexibility, customizing this means editing Bugzilla's Perl 
+      code. This gives the administrator complete control over exactly who is
+      allowed to do what. The relevant method is called
+      <code class="filename">check_can_change_field()</code>,
+      and is found in <code class="filename">Bug.pm</code> in your
+      Bugzilla/ directory. If you open that file and search for
+      <span class="quote">“<span class="quote">sub check_can_change_field</span>”</span>, you'll find it.
+    </p><p>
+      This function has been carefully commented to allow you to see exactly
+      how it works, and give you an idea of how to make changes to it.
+      Certain marked sections should not be changed - these are
+      the <span class="quote">“<span class="quote">plumbing</span>”</span> which makes the rest of the function work.
+      In between those sections, you'll find snippets of code like:
+      </p><pre class="programlisting">    # Allow the assignee to change anything.
+    if ($ownerid eq $whoid) {
+        return 1;
+    }</pre><p>
+      It's fairly obvious what this piece of code does.
+    </p><p>
+      So, how does one go about changing this function? Well, simple changes
+      can be made just by removing pieces - for example, if you wanted to 
+      prevent any user adding a comment to a bug, just remove the lines marked
+      <span class="quote">“<span class="quote">Allow anyone to change comments.</span>”</span> If you don't want the
+      Reporter to have any special rights on bugs they have filed, just
+      remove the entire section that deals with the Reporter.
+    </p><p>
+      More complex customizations are not much harder. Basically, you add
+      a check in the right place in the function, i.e. after all the variables
+      you are using have been set up. So, don't look at $ownerid before 
+      $ownerid has been obtained from the database. You can either add a
+      positive check, which returns 1 (allow) if certain conditions are true,
+      or a negative check, which returns 0 (deny.) E.g.:
+      </p><pre class="programlisting">    if ($field eq "qacontact") {
+        if (Bugzilla-&gt;user-&gt;in_group("quality_assurance")) {
+            return 1;
+        } 
+        else {
+            return 0;
+        }
+    }</pre><p>
+      This says that only users in the group "quality_assurance" can change
+      the QA Contact field of a bug.
+    </p><p>
+      Getting more weird:
+      </p><pre class="programlisting">    if (($field eq "priority") &amp;&amp;
+        (Bugzilla-&gt;user-&gt;email =~ /.*\@example\.com$/))
+    {
+        if ($oldvalue eq "P1") {
+            return 1;
+        } 
+        else {
+            return 0;
+        }
+    }</pre><p>
+      This says that if the user is trying to change the priority field,
+      and their email address is @example.com, they can only do so if the
+      old value of the field was "P1". Not very useful, but illustrative.
+    </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        If you are modifying <code class="filename">process_bug.cgi</code> in any
+        way, do not change the code that is bounded by DO_NOT_CHANGE blocks.
+        Doing so could compromise security, or cause your installation to
+        stop working entirely.
+      </p></td></tr></table></div><p>
+      For a list of possible field names, look at the bugs table in the 
+      database. If you need help writing custom rules for your organization,
+      ask in the newsgroup.
+    </p></div><div class="section" title="6.5. Integrating Bugzilla with Third-Party Tools"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="integration"></a>6.5. Integrating Bugzilla with Third-Party Tools</h2></div></div></div><p>
+      Many utilities and applications can integrate with Bugzilla,
+      either on the client- or server-side. None of them are maintained
+      by the Bugzilla community, nor are they tested during our
+      QA tests, so use them at your own risk. They are listed at
+      <a class="ulink" href="https://wiki.mozilla.org/Bugzilla:Addons" target="_top">https://wiki.mozilla.org/Bugzilla:Addons</a>.
+    </p></div></div><div class="appendix" title="Appendix A. Troubleshooting"><div class="titlepage"><div><div><h2 class="title"><a name="troubleshooting"></a>Appendix A. Troubleshooting</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#general-advice">A.1. General Advice</a></span></dt><dt><span class="section"><a href="#trbl-testserver">A.2. The Apache web server is not serving Bugzilla pages</a></span></dt><dt><span class="section"><a href="#trbl-perlmodule">A.3. I installed a Perl module, but 
+      <code class="filename">checksetup.pl</code> claims it's not installed!</a></span></dt><dt><span class="section"><a href="#trbl-dbdSponge">A.4. DBD::Sponge::db prepare failed</a></span></dt><dt><span class="section"><a href="#paranoid-security">A.5. cannot chdir(/var/spool/mqueue)</a></span></dt><dt><span class="section"><a href="#trbl-relogin-everyone">A.6. Everybody is constantly being forced to relogin</a></span></dt><dt><span class="section"><a href="#trbl-index">A.7. <code class="filename">index.cgi</code> doesn't show up unless specified in the URL</a></span></dt><dt><span class="section"><a href="#trbl-passwd-encryption">A.8. 
+      checksetup.pl reports "Client does not support authentication protocol
+      requested by server..."
+    </a></span></dt></dl></div><p>This section gives solutions to common Bugzilla installation
+  problems. If none of the section headings seems to match your
+  problem, read the general advice.
+  </p><div class="section" title="A.1. General Advice"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="general-advice"></a>A.1. General Advice</h2></div></div></div><p>If you can't get <code class="filename">checksetup.pl</code> to run to 
+    completion, it normally explains what's wrong and how to fix it.
+    If you can't work it out, or if it's being uncommunicative, post 
+    the errors in the 
+    <a class="ulink" href="news://news.mozilla.org/mozilla.support.bugzilla" target="_top">mozilla.support.bugzilla</a>
+    newsgroup.
+    </p><p>If you have made it all the way through
+    <a class="xref" href="#installation" title="2.1. Installation">Section 2.1, “Installation”</a> (Installation) and
+    <a class="xref" href="#configuration" title="2.2. Configuration">Section 2.2, “Configuration”</a> (Configuration) but accessing the Bugzilla
+    URL doesn't work, the first thing to do is to check your web server error
+    log. For Apache, this is often located at
+    <code class="filename">/etc/logs/httpd/error_log</code>. The error messages
+    you see may be self-explanatory enough to enable you to diagnose and
+    fix the problem. If not, see below for some commonly-encountered 
+    errors. If that doesn't help, post the errors to the newsgroup.
+    </p><p>
+      Bugzilla can also log all user-based errors (and many code-based errors)
+      that occur, without polluting the web server's error log.  To enable
+      Bugzilla error logging, create a file that Bugzilla can write to, named
+      <code class="filename">errorlog</code>, in the Bugzilla <code class="filename">data</code>
+      directory.  Errors will be logged as they occur, and will include the type
+      of the error, the IP address and username (if available) of the user who
+      triggered the error, and the values of all environment variables; if a
+      form was being submitted, the data in the form will also be included.
+      To disable error logging, delete or rename the
+      <code class="filename">errorlog</code> file.
+    </p></div><div class="section" title="A.2. The Apache web server is not serving Bugzilla pages"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="trbl-testserver"></a>A.2. The Apache web server is not serving Bugzilla pages</h2></div></div></div><p>After you have run <span class="command"><strong>checksetup.pl</strong></span> twice,
+    run <span class="command"><strong>testserver.pl http://yoursite.yourdomain/yoururl</strong></span>
+    to confirm that your web server is configured properly for
+    Bugzilla.
+    </p><pre class="programlisting">
+<code class="prompt">bash$</code> ./testserver.pl http://landfill.bugzilla.org/bugzilla-tip
+TEST-OK Webserver is running under group id in $webservergroup.
+TEST-OK Got ant picture.
+TEST-OK Webserver is executing CGIs.
+TEST-OK Webserver is preventing fetch of http://landfill.bugzilla.org/bugzilla-tip/localconfig.
+</pre></div><div class="section" title="A.3. I installed a Perl module, but checksetup.pl claims it's not installed!"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="trbl-perlmodule"></a>A.3. I installed a Perl module, but 
+      <code class="filename">checksetup.pl</code> claims it's not installed!</h2></div></div></div><p>This could be caused by one of two things:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>You have two versions of Perl on your machine. You are installing
+        modules into one, and Bugzilla is using the other. Rerun the CPAN
+        commands (or manual compile) using the full path to Perl from the 
+        top of <code class="filename">checksetup.pl</code>. This will make sure you 
+        are installing the modules in the right place.
+        </p></li><li class="listitem"><p>The permissions on your library directories are set incorrectly.
+        They must, at the very least, be readable by the web server user or
+        group. It is recommended that they be world readable.
+        </p></li></ol></div></div><div class="section" title="A.4. DBD::Sponge::db prepare failed"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="trbl-dbdSponge"></a>A.4. DBD::Sponge::db prepare failed</h2></div></div></div><p>The following error message may appear due to a bug in DBD::mysql
+    (over which the Bugzilla team have no control):
+    </p><pre class="programlisting"> DBD::Sponge::db prepare failed: Cannot determine NUM_OF_FIELDS at D:/Perl/site/lib/DBD/mysql.pm line 248.
+  SV = NULL(0x0) at 0x20fc444
+  REFCNT = 1
+  FLAGS = (PADBUSY,PADMY)
+</pre><p>To fix this, go to 
+    <code class="filename">&lt;path-to-perl&gt;/lib/DBD/sponge.pm</code> 
+    in your Perl installation and replace
+    </p><pre class="programlisting"> my $numFields;
+ if ($attribs-&gt;{'NUM_OF_FIELDS'}) {
+     $numFields = $attribs-&gt;{'NUM_OF_FIELDS'};
+ } elsif ($attribs-&gt;{'NAME'}) {
+     $numFields = @{$attribs-&gt;{NAME}};
+</pre><p>with</p><pre class="programlisting"> my $numFields;
+ if ($attribs-&gt;{'NUM_OF_FIELDS'}) {
+     $numFields = $attribs-&gt;{'NUM_OF_FIELDS'};
+ } elsif ($attribs-&gt;{'NAMES'}) {
+     $numFields = @{$attribs-&gt;{NAMES}};
+</pre><p>(note the S added to NAME.)</p></div><div class="section" title="A.5. cannot chdir(/var/spool/mqueue)"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="paranoid-security"></a>A.5. cannot chdir(/var/spool/mqueue)</h2></div></div></div><p>If you are installing Bugzilla on SuSE Linux, or some other
+    distributions with <span class="quote">“<span class="quote">paranoid</span>”</span> security options, it is
+    possible that the checksetup.pl script may fail with the error: 
+</p><pre class="programlisting">cannot chdir(/var/spool/mqueue): Permission denied
+</pre><p>
+    </p><p>This is because your <code class="filename">/var/spool/mqueue</code>
+    directory has a mode of <code class="computeroutput">drwx------</code>.
+    Type <span class="command"><strong>chmod 755 <code class="filename">/var/spool/mqueue</code></strong></span>
+    as root to fix this problem. This will allow any process running on your
+    machine the ability to <span class="emphasis"><em>read</em></span> the
+    <code class="filename">/var/spool/mqueue</code> directory.
+    </p></div><div class="section" title="A.6. Everybody is constantly being forced to relogin"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="trbl-relogin-everyone"></a>A.6. Everybody is constantly being forced to relogin</h2></div></div></div><p>The most-likely cause is that the <span class="quote">“<span class="quote">cookiepath</span>”</span> parameter
+  is not set correctly in the Bugzilla configuration.  You can change this (if
+  you're a Bugzilla administrator) from the editparams.cgi page via the web interface.
+  </p><p>The value of the cookiepath parameter should be the actual directory
+  containing your Bugzilla installation, <span class="emphasis"><em>as seen by the end-user's
+  web browser</em></span>. Leading and trailing slashes are mandatory. You can
+  also set the cookiepath to any directory which is a parent of the Bugzilla
+  directory (such as '/', the root directory). But you can't put something
+  that isn't at least a partial match or it won't work. What you're actually
+  doing is restricting the end-user's browser to sending the cookies back only
+  to that directory.
+  </p><p>How do you know if you want your specific Bugzilla directory or the
+  whole site?
+  </p><p>If you have only one Bugzilla running on the server, and you don't
+  mind having other applications on the same server with it being able to see
+  the cookies (you might be doing this on purpose if you have other things on
+  your site that share authentication with Bugzilla), then you'll want to have
+  the cookiepath set to "/", or to a sufficiently-high enough directory that
+  all of the involved apps can see the cookies.
+  </p><div class="example"><a name="trbl-relogin-everyone-share"></a><p class="title"><b>Example A.1. Examples of urlbase/cookiepath pairs for sharing login cookies</b></p><div class="example-contents"><div class="blockquote"><blockquote class="blockquote"><div class="literallayout"><p><br>
+urlbase is http://bugzilla.mozilla.org/<br>
+cookiepath is /<br>
+<br>
+urlbase is http://tools.mysite.tld/bugzilla/<br>
+        but you have http://tools.mysite.tld/someotherapp/ which shares<br>
+        authentication with your Bugzilla<br>
+cookiepath is /<br>
+      </p></div></blockquote></div></div></div><br class="example-break"><p>On the other hand, if you have more than one Bugzilla running on the
+   server (some people do - we do on landfill) then you need to have the
+   cookiepath restricted enough so that the different Bugzillas don't
+   confuse their cookies with one another.
+   </p><div class="example"><a name="trbl-relogin-everyone-restrict"></a><p class="title"><b>Example A.2. Examples of urlbase/cookiepath pairs to restrict the login cookie</b></p><div class="example-contents"><div class="blockquote"><blockquote class="blockquote"><div class="literallayout"><p><br>
+urlbase is http://landfill.bugzilla.org/bugzilla-tip/<br>
+cookiepath is /bugzilla-tip/<br>
+<br>
+urlbase is http://landfill.bugzilla.org/bugzilla-4.0-branch/<br>
+cookiepath is /bugzilla-4.0-branch/<br>
+        </p></div></blockquote></div></div></div><br class="example-break"><p>If you had cookiepath set to <span class="quote">“<span class="quote">/</span>”</span> at any point in the
+    past and need to set it to something more restrictive
+    (i.e. <span class="quote">“<span class="quote">/bugzilla/</span>”</span>), you can safely do this without
+    requiring users to delete their Bugzilla-related cookies in their
+    browser (this is true starting with Bugzilla 2.18 and Bugzilla 2.16.5).
+    </p></div><div class="section" title="A.7. index.cgi doesn't show up unless specified in the URL"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="trbl-index"></a>A.7. <code class="filename">index.cgi</code> doesn't show up unless specified in the URL</h2></div></div></div><p>
+      You probably need to set up your web server in such a way that it
+      will serve the index.cgi page as an index page.
+    </p><p>
+      If you are using Apache, you can do this by adding 
+      <code class="filename">index.cgi</code> to the end of the 
+      <code class="computeroutput">DirectoryIndex</code> line
+      as mentioned in <a class="xref" href="#http-apache" title="2.2.4.1. Bugzilla using Apache">Section 2.2.4.1, “Bugzilla using Apache”</a>.
+    </p></div><div class="section" title='A.8.  checksetup.pl reports "Client does not support authentication protocol requested by server..."'><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="trbl-passwd-encryption"></a>A.8. 
+      checksetup.pl reports "Client does not support authentication protocol
+      requested by server..."
+    </h2></div></div></div><p>
+      This error is occurring because you are using the new password
+      encryption that comes with MySQL 4.1, while your
+      <code class="filename">DBD::mysql</code> module was compiled against an
+      older version of MySQL. If you recompile <code class="filename">DBD::mysql</code>
+      against the current MySQL libraries (or just obtain a newer version
+      of this module) then the error may go away.
+    </p><p>
+      If that does not fix the problem, or if you cannot recompile the
+      existing module (e.g. you're running Windows) and/or don't want to
+      replace it (e.g. you want to keep using a packaged version), then a
+      workaround is available from the MySQL docs:
+      <a class="ulink" href="http://dev.mysql.com/doc/mysql/en/Old_client.html" target="_top">http://dev.mysql.com/doc/mysql/en/Old_client.html</a>
+    </p></div></div><div class="appendix" title="Appendix B. Contrib"><div class="titlepage"><div><div><h2 class="title"><a name="patches"></a>Appendix B. Contrib</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#cmdline">B.1. Command-line Search Interface</a></span></dt><dt><span class="section"><a href="#cmdline-bugmail">B.2. Command-line 'Send Unsent Bug-mail' tool</a></span></dt></dl></div><p>
+    There are a number of unofficial Bugzilla add-ons in the 
+    <code class="filename">$BUGZILLA_ROOT/contrib/</code>
+    directory. This section documents them.
+  </p><div class="section" title="B.1. Command-line Search Interface"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="cmdline"></a>B.1. Command-line Search Interface</h2></div></div></div><p>
+      There are a suite of Unix utilities for searching Bugzilla from the 
+      command line. They live in the 
+      <code class="filename">contrib/cmdline</code> directory.
+      There are three files - <code class="filename">query.conf</code>,
+      <code class="filename">buglist</code> and <code class="filename">bugs</code>.
+    </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        These files pre-date the templatization work done as part of the
+        2.16 release, and have not been updated.
+      </p></td></tr></table></div><p>
+      <code class="filename">query.conf</code> contains the mapping from
+      options to field names and comparison types. Quoted option names
+      are <span class="quote">“<span class="quote">grepped</span>”</span> for, so it should be easy to edit this
+      file. Comments (#) have no effect; you must make sure these lines
+      do not contain any quoted <span class="quote">“<span class="quote">option</span>”</span>.
+    </p><p>
+      <code class="filename">buglist</code> is a shell script that submits a
+      Bugzilla query and writes the resulting HTML page to stdout.
+      It supports both short options, (such as <span class="quote">“<span class="quote">-Afoo</span>”</span>
+      or <span class="quote">“<span class="quote">-Rbar</span>”</span>) and long options (such
+      as <span class="quote">“<span class="quote">--assignedto=foo</span>”</span> or <span class="quote">“<span class="quote">--reporter=bar</span>”</span>).
+      If the first character of an option is not <span class="quote">“<span class="quote">-</span>”</span>, it is
+      treated as if it were prefixed with <span class="quote">“<span class="quote">--default=</span>”</span>.
+    </p><p>
+      The column list is taken from the COLUMNLIST environment variable.
+      This is equivalent to the <span class="quote">“<span class="quote">Change Columns</span>”</span> option
+      that is available when you list bugs in buglist.cgi. If you have
+      already used Bugzilla, grep for COLUMNLIST in your cookies file
+      to see your current COLUMNLIST setting.
+    </p><p>
+      <code class="filename">bugs</code> is a simple shell script which calls
+      <code class="filename">buglist</code> and extracts the
+      bug numbers from the output. Adding the prefix
+      <span class="quote">“<span class="quote">http://bugzilla.mozilla.org/buglist.cgi?bug_id=</span>”</span>
+      turns the bug list into a working link if any bugs are found.
+      Counting bugs is easy. Pipe the results through 
+      <span class="command"><strong>sed -e 's/,/ /g' | wc | awk '{printf $2 "\n"}'</strong></span>
+    </p><p>
+      Akkana Peck says she has good results piping 
+      <code class="filename">buglist</code> output through 
+      <span class="command"><strong>w3m -T text/html -dump</strong></span>
+    </p></div><div class="section" title="B.2. Command-line 'Send Unsent Bug-mail' tool"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="cmdline-bugmail"></a>B.2. Command-line 'Send Unsent Bug-mail' tool</h2></div></div></div><p>
+      Within the <code class="filename">contrib</code> directory
+      exists a utility with the descriptive (if compact) name
+      of <code class="filename">sendunsentbugmail.pl</code>. The purpose of this
+      script is, simply, to send out any bug-related mail that should
+      have been sent by now, but for one reason or another has not.
+    </p><p>
+      To accomplish this task, <code class="filename">sendunsentbugmail.pl</code> uses
+      the same mechanism as the <code class="filename">sanitycheck.cgi</code> script;
+      it scans through the entire database looking for bugs with changes that
+      were made more than 30 minutes ago, but where there is no record of
+      anyone related to that bug having been sent mail. Having compiled a list,
+      it then uses the standard rules to determine who gets mail, and sends it
+      out.
+    </p><p>
+      As the script runs, it indicates the bug for which it is currently
+      sending mail; when it has finished, it gives a numerical count of how
+      many mails were sent and how many people were excluded. (Individual
+      user names are not recorded or displayed.) If the script produces
+      no output, that means no unsent mail was detected.
+    </p><p>
+      <span class="emphasis"><em>Usage</em></span>: move the sendunsentbugmail.pl script
+      up into the main directory, ensure it has execute permission, and run it
+      from the command line (or from a cron job) with no parameters.
+    </p></div></div><div class="appendix" title="Appendix C. Manual Installation of Perl Modules"><div class="titlepage"><div><div><h2 class="title"><a name="install-perlmodules-manual"></a>Appendix C. Manual Installation of Perl Modules</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#modules-manual-instructions">C.1. Instructions</a></span></dt><dt><span class="section"><a href="#modules-manual-download">C.2. Download Locations</a></span></dt><dt><span class="section"><a href="#modules-manual-optional">C.3. Optional Modules</a></span></dt></dl></div><div class="section" title="C.1. Instructions"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="modules-manual-instructions"></a>C.1. Instructions</h2></div></div></div><p>
+      If you need to install Perl modules manually, here's how it's done.
+      Download the module using the link given in the next section, and then
+      apply this magic incantation, as root:
+    </p><p>  
+      </p><pre class="screen"><code class="prompt">bash#</code> tar -xzvf &lt;module&gt;.tar.gz
+<code class="prompt">bash#</code> cd &lt;module&gt;
+<code class="prompt">bash#</code> perl Makefile.PL
+<code class="prompt">bash#</code> make
+<code class="prompt">bash#</code> make test
+<code class="prompt">bash#</code> make install</pre><p>
+    </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        In order to compile source code under Windows you will need to obtain
+        a 'make' utility.  The <span class="command"><strong>nmake</strong></span> utility provided with
+        Microsoft Visual C++ may be used.  As an alternative, there is a
+        utility called <span class="command"><strong>dmake</strong></span> available from CPAN which is
+        written entirely in Perl.
+      </p><p>
+        As described in <a class="xref" href="#modules-manual-download" title="C.2. Download Locations">Section C.2, “Download Locations”</a>, however, most
+        packages already exist and are available from ActiveState or theory58S.
+        We highly recommend that you install them using the ppm GUI available with
+        ActiveState and to add the theory58S repository to your list of repositories.
+      </p></td></tr></table></div></div><div class="section" title="C.2. Download Locations"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="modules-manual-download"></a>C.2. Download Locations</h2></div></div></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        Running Bugzilla on Windows requires the use of ActiveState
+        Perl 5.8.1 or higher. Many modules already exist in the core
+        distribution of ActiveState Perl. If some modules are missing, upgrade
+        ActiveState Perl to at least 5.12; it has all the required modules.
+      </p></td></tr></table></div><p>
+      CGI:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/CGI.pm/" target="_top">http://search.cpan.org/dist/CGI.pm/</a><br>
+        Documentation: <a class="ulink" href="http://perldoc.perl.org/CGI.html" target="_top">http://perldoc.perl.org/CGI.html</a><br>
+      </p></div><p>
+    </p><p>
+      Data-Dumper:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/Data-Dumper/" target="_top">http://search.cpan.org/dist/Data-Dumper/</a><br>
+        Documentation: <a class="ulink" href="http://search.cpan.org/dist/Data-Dumper/Dumper.pm" target="_top">http://search.cpan.org/dist/Data-Dumper/Dumper.pm</a><br>
+      </p></div><p>
+    </p><p>
+      Date::Format (part of TimeDate):
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/TimeDate/" target="_top">http://search.cpan.org/dist/TimeDate/</a><br>
+        Documentation: <a class="ulink" href="http://search.cpan.org/dist/TimeDate/lib/Date/Format.pm" target="_top">http://search.cpan.org/dist/TimeDate/lib/Date/Format.pm</a><br>
+      </p></div><p>
+    </p><p>
+      DBI:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/DBI/" target="_top">http://search.cpan.org/dist/DBI/</a><br>
+        Documentation: <a class="ulink" href="http://dbi.perl.org/docs/" target="_top">http://dbi.perl.org/docs/</a><br>
+      </p></div><p>
+    </p><p>
+      DBD::mysql:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/DBD-mysql/" target="_top">http://search.cpan.org/dist/DBD-mysql/</a><br>
+        Documentation: <a class="ulink" href="http://search.cpan.org/dist/DBD-mysql/lib/DBD/mysql.pm" target="_top">http://search.cpan.org/dist/DBD-mysql/lib/DBD/mysql.pm</a><br>
+      </p></div><p>
+    </p><p>
+      DBD::Pg:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/DBD-Pg/" target="_top">http://search.cpan.org/dist/DBD-Pg/</a><br>
+        Documentation: <a class="ulink" href="http://search.cpan.org/dist/DBD-Pg/Pg.pm" target="_top">http://search.cpan.org/dist/DBD-Pg/Pg.pm</a><br>
+      </p></div><p>
+    </p><p>
+      Template-Toolkit:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/Template-Toolkit/" target="_top">http://search.cpan.org/dist/Template-Toolkit/</a><br>
+        Documentation: <a class="ulink" href="http://www.template-toolkit.org/docs.html" target="_top">http://www.template-toolkit.org/docs.html</a><br>
+      </p></div><p>
+    </p><p>
+      GD:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/GD/" target="_top">http://search.cpan.org/dist/GD/</a><br>
+        Documentation: <a class="ulink" href="http://search.cpan.org/dist/GD/GD.pm" target="_top">http://search.cpan.org/dist/GD/GD.pm</a><br>
+      </p></div><p>
+    </p><p>
+      Template::Plugin::GD:
+      </p><div class="literallayout"><p><br>
+       CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/Template-GD/" target="_top">http://search.cpan.org/dist/Template-GD/</a><br>
+       Documentation: <a class="ulink" href="http://www.template-toolkit.org/docs/aqua/Modules/index.html" target="_top">http://www.template-toolkit.org/docs/aqua/Modules/index.html</a><br>
+      </p></div><p>
+    </p><p>
+      MIME::Parser (part of MIME-tools):
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/MIME-tools/" target="_top">http://search.cpan.org/dist/MIME-tools/</a><br>
+        Documentation: <a class="ulink" href="http://search.cpan.org/dist/MIME-tools/lib/MIME/Parser.pm" target="_top">http://search.cpan.org/dist/MIME-tools/lib/MIME/Parser.pm</a><br>
+      </p></div><p>
+    </p></div><div class="section" title="C.3. Optional Modules"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="modules-manual-optional"></a>C.3. Optional Modules</h2></div></div></div><p>
+      Chart::Lines:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/Chart/" target="_top">http://search.cpan.org/dist/Chart/</a><br>
+        Documentation: <a class="ulink" href="http://search.cpan.org/dist/Chart/Chart.pod" target="_top">http://search.cpan.org/dist/Chart/Chart.pod</a><br>
+      </p></div><p>
+    </p><p>
+      GD::Graph:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/GDGraph/" target="_top">http://search.cpan.org/dist/GDGraph/</a><br>
+        Documentation: <a class="ulink" href="http://search.cpan.org/dist/GDGraph/Graph.pm" target="_top">http://search.cpan.org/dist/GDGraph/Graph.pm</a><br>
+      </p></div><p>
+    </p><p>
+      GD::Text::Align (part of GD::Text::Util):
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/GDTextUtil/" target="_top">http://search.cpan.org/dist/GDTextUtil/</a><br>
+        Documentation: <a class="ulink" href="http://search.cpan.org/dist/GDTextUtil/Text/Align.pm" target="_top">http://search.cpan.org/dist/GDTextUtil/Text/Align.pm</a><br>
+      </p></div><p>
+    </p><p>
+      XML::Twig:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/XML-Twig/" target="_top">http://search.cpan.org/dist/XML-Twig/</a><br>
+        Documentation: <a class="ulink" href="http://standards.ieee.org/resources/spasystem/twig/twig_stable.html" target="_top">http://standards.ieee.org/resources/spasystem/twig/twig_stable.html</a><br>
+      </p></div><p>
+    </p><p>
+      PatchReader:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/author/JKEISER/PatchReader/" target="_top">http://search.cpan.org/author/JKEISER/PatchReader/</a><br>
+        Documentation: <a class="ulink" href="http://www.johnkeiser.com/mozilla/Patch_Viewer.html" target="_top">http://www.johnkeiser.com/mozilla/Patch_Viewer.html</a><br>
+      </p></div><p>
+    </p></div></div><div class="appendix" title="Appendix D. GNU Free Documentation License"><div class="titlepage"><div><div><h2 class="title"><a name="gfdl"></a>Appendix D. GNU Free Documentation License</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#gfdl-0">D.0. Preamble</a></span></dt><dt><span class="section"><a href="#gfdl-1">D.1. Applicability and Definition</a></span></dt><dt><span class="section"><a href="#gfdl-2">D.2. Verbatim Copying</a></span></dt><dt><span class="section"><a href="#gfdl-3">D.3. Copying in Quantity</a></span></dt><dt><span class="section"><a href="#gfdl-4">D.4. Modifications</a></span></dt><dt><span class="section"><a href="#gfdl-5">D.5. Combining Documents</a></span></dt><dt><span class="section"><a href="#gfdl-6">D.6. Collections of Documents</a></span></dt><dt><span class="section"><a href="#gfdl-7">D.7. Aggregation with Independent Works</a></span></dt><dt><span class="section"><a href="#gfdl-8">D.8. Translation</a></span></dt><dt><span class="section"><a href="#gfdl-9">D.9. Termination</a></span></dt><dt><span class="section"><a href="#gfdl-10">D.10. Future Revisions of this License</a></span></dt><dt><span class="section"><a href="#gfdl-howto">D.. How to use this License for your documents</a></span></dt></dl></div><p>Version 1.1, March 2000</p><div class="blockquote"><blockquote class="blockquote"><p>Copyright (C) 2000 Free Software Foundation, Inc. 51 Franklin Street,
+    Fifth Floor, Boston, MA 02110-1301 USA Everyone is permitted to copy and
+    distribute verbatim copies of this license document, but changing it is
+    not allowed.</p></blockquote></div><div class="section" title="D.0. Preamble"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-0"></a>D.0. Preamble</h2></div></div></div><p>The purpose of this License is to make a manual, textbook, or other
+    written document "free" in the sense of freedom: to assure everyone the
+    effective freedom to copy and redistribute it, with or without modifying
+    it, either commercially or noncommercially. Secondarily, this License
+    preserves for the author and publisher a way to get credit for their
+    work, while not being considered responsible for modifications made by
+    others.</p><p>This License is a kind of "copyleft", which means that derivative
+    works of the document must themselves be free in the same sense. It
+    complements the GNU General Public License, which is a copyleft license
+    designed for free software.</p><p>We have designed this License in order to use it for manuals for
+    free software, because free software needs free documentation: a free
+    program should come with manuals providing the same freedoms that the
+    software does. But this License is not limited to software manuals; it
+    can be used for any textual work, regardless of subject matter or whether
+    it is published as a printed book. We recommend this License principally
+    for works whose purpose is instruction or reference.</p></div><div class="section" title="D.1. Applicability and Definition"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-1"></a>D.1. Applicability and Definition</h2></div></div></div><p>This License applies to any manual or other work that contains a
+    notice placed by the copyright holder saying it can be distributed under
+    the terms of this License. The "Document", below, refers to any such
+    manual or work. Any member of the public is a licensee, and is addressed
+    as "you".</p><p>A "Modified Version" of the Document means any work containing the
+    Document or a portion of it, either copied verbatim, or with
+    modifications and/or translated into another language.</p><p>A "Secondary Section" is a named appendix or a front-matter section
+    of the Document that deals exclusively with the relationship of the
+    publishers or authors of the Document to the Document's overall subject
+    (or to related matters) and contains nothing that could fall directly
+    within that overall subject. (For example, if the Document is in part a
+    textbook of mathematics, a Secondary Section may not explain any
+    mathematics.) The relationship could be a matter of historical connection
+    with the subject or with related matters, or of legal, commercial,
+    philosophical, ethical or political position regarding them.</p><p>The "Invariant Sections" are certain Secondary Sections whose
+    titles are designated, as being those of Invariant Sections, in the
+    notice that says that the Document is released under this License.</p><p>The "Cover Texts" are certain short passages of text that are
+    listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says
+    that the Document is released under this License.</p><p>A "Transparent" copy of the Document means a machine-readable copy,
+    represented in a format whose specification is available to the general
+    public, whose contents can be viewed and edited directly and
+    straightforwardly with generic text editors or (for images composed of
+    pixels) generic paint programs or (for drawings) some widely available
+    drawing editor, and that is suitable for input to text formatters or for
+    automatic translation to a variety of formats suitable for input to text
+    formatters. A copy made in an otherwise Transparent file format whose
+    markup has been designed to thwart or discourage subsequent modification
+    by readers is not Transparent. A copy that is not "Transparent" is called
+    "Opaque".</p><p>Examples of suitable formats for Transparent copies include plain
+    ASCII without markup, Texinfo input format, LaTeX input format, SGML or
+    XML using a publicly available DTD, and standard-conforming simple HTML
+    designed for human modification. Opaque formats include PostScript, PDF,
+    proprietary formats that can be read and edited only by proprietary word
+    processors, SGML or XML for which the DTD and/or processing tools are not
+    generally available, and the machine-generated HTML produced by some word
+    processors for output purposes only.</p><p>The "Title Page" means, for a printed book, the title page itself,
+    plus such following pages as are needed to hold, legibly, the material
+    this License requires to appear in the title page. For works in formats
+    which do not have any title page as such, "Title Page" means the text
+    near the most prominent appearance of the work's title, preceding the
+    beginning of the body of the text.</p></div><div class="section" title="D.2. Verbatim Copying"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-2"></a>D.2. Verbatim Copying</h2></div></div></div><p>You may copy and distribute the Document in any medium, either
+    commercially or noncommercially, provided that this License, the
+    copyright notices, and the license notice saying this License applies to
+    the Document are reproduced in all copies, and that you add no other
+    conditions whatsoever to those of this License. You may not use technical
+    measures to obstruct or control the reading or further copying of the
+    copies you make or distribute. However, you may accept compensation in
+    exchange for copies. If you distribute a large enough number of copies
+    you must also follow the conditions in section 3.</p><p>You may also lend copies, under the same conditions stated above,
+    and you may publicly display copies.</p></div><div class="section" title="D.3. Copying in Quantity"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-3"></a>D.3. Copying in Quantity</h2></div></div></div><p>If you publish printed copies of the Document numbering more than
+    100, and the Document's license notice requires Cover Texts, you must
+    enclose the copies in covers that carry, clearly and legibly, all these
+    Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts
+    on the back cover. Both covers must also clearly and legibly identify you
+    as the publisher of these copies. The front cover must present the full
+    title with all words of the title equally prominent and visible. You may
+    add other material on the covers in addition. Copying with changes
+    limited to the covers, as long as they preserve the title of the Document
+    and satisfy these conditions, can be treated as verbatim copying in other
+    respects.</p><p>If the required texts for either cover are too voluminous to fit
+    legibly, you should put the first ones listed (as many as fit reasonably)
+    on the actual cover, and continue the rest onto adjacent pages.</p><p>If you publish or distribute Opaque copies of the Document
+    numbering more than 100, you must either include a machine-readable
+    Transparent copy along with each Opaque copy, or state in or with each
+    Opaque copy a publicly-accessible computer-network location containing a
+    complete Transparent copy of the Document, free of added material, which
+    the general network-using public has access to download anonymously at no
+    charge using public-standard network protocols. If you use the latter
+    option, you must take reasonably prudent steps, when you begin
+    distribution of Opaque copies in quantity, to ensure that this
+    Transparent copy will remain thus accessible at the stated location until
+    at least one year after the last time you distribute an Opaque copy
+    (directly or through your agents or retailers) of that edition to the
+    public.</p><p>It is requested, but not required, that you contact the authors of
+    the Document well before redistributing any large number of copies, to
+    give them a chance to provide you with an updated version of the
+    Document.</p></div><div class="section" title="D.4. Modifications"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-4"></a>D.4. Modifications</h2></div></div></div><p>You may copy and distribute a Modified Version of the Document
+    under the conditions of sections 2 and 3 above, provided that you release
+    the Modified Version under precisely this License, with the Modified
+    Version filling the role of the Document, thus licensing distribution and
+    modification of the Modified Version to whoever possesses a copy of it.
+    In addition, you must do these things in the Modified Version:</p><div class="orderedlist"><ol class="orderedlist" type="A"><li class="listitem"><p>Use in the Title Page (and on the covers, if any) a title
+        distinct from that of the Document, and from those of previous
+        versions (which should, if there were any, be listed in the History
+        section of the Document). You may use the same title as a previous
+        version if the original publisher of that version gives
+        permission.</p></li><li class="listitem"><p>List on the Title Page, as authors, one or more persons or
+        entities responsible for authorship of the modifications in the
+        Modified Version, together with at least five of the principal
+        authors of the Document (all of its principal authors, if it has less
+        than five).</p></li><li class="listitem"><p>State on the Title page the name of the publisher of the
+        Modified Version, as the publisher.</p></li><li class="listitem"><p>Preserve all the copyright notices of the Document.</p></li><li class="listitem"><p>Add an appropriate copyright notice for your modifications
+        adjacent to the other copyright notices.</p></li><li class="listitem"><p>Include, immediately after the copyright notices, a license
+        notice giving the public permission to use the Modified Version under
+        the terms of this License, in the form shown in the Addendum
+        below.</p></li><li class="listitem"><p>Preserve in that license notice the full lists of Invariant
+        Sections and required Cover Texts given in the Document's license
+        notice.</p></li><li class="listitem"><p>Include an unaltered copy of this License.</p></li><li class="listitem"><p>Preserve the section entitled "History", and its title, and add
+        to it an item stating at least the title, year, new authors, and
+        publisher of the Modified Version as given on the Title Page. If
+        there is no section entitled "History" in the Document, create one
+        stating the title, year, authors, and publisher of the Document as
+        given on its Title Page, then add an item describing the Modified
+        Version as stated in the previous sentence.</p></li><li class="listitem"><p>Preserve the network location, if any, given in the Document
+        for public access to a Transparent copy of the Document, and likewise
+        the network locations given in the Document for previous versions it
+        was based on. These may be placed in the "History" section. You may
+        omit a network location for a work that was published at least four
+        years before the Document itself, or if the original publisher of the
+        version it refers to gives permission.</p></li><li class="listitem"><p>In any section entitled "Acknowledgements" or "Dedications",
+        preserve the section's title, and preserve in the section all the
+        substance and tone of each of the contributor acknowledgements and/or
+        dedications given therein.</p></li><li class="listitem"><p>Preserve all the Invariant Sections of the Document, unaltered
+        in their text and in their titles. Section numbers or the equivalent
+        are not considered part of the section titles.</p></li><li class="listitem"><p>Delete any section entitled "Endorsements". Such a section may
+        not be included in the Modified Version.</p></li><li class="listitem"><p>Do not retitle any existing section as "Endorsements" or to
+        conflict in title with any Invariant Section.</p></li></ol></div><p>If the Modified Version includes new front-matter sections or
+    appendices that qualify as Secondary Sections and contain no material
+    copied from the Document, you may at your option designate some or all of
+    these sections as invariant. To do this, add their titles to the list of
+    Invariant Sections in the Modified Version's license notice. These titles
+    must be distinct from any other section titles.</p><p>You may add a section entitled "Endorsements", provided it contains
+    nothing but endorsements of your Modified Version by various parties--for
+    example, statements of peer review or that the text has been approved by
+    an organization as the authoritative definition of a standard.</p><p>You may add a passage of up to five words as a Front-Cover Text,
+    and a passage of up to 25 words as a Back-Cover Text, to the end of the
+    list of Cover Texts in the Modified Version. Only one passage of
+    Front-Cover Text and one of Back-Cover Text may be added by (or through
+    arrangements made by) any one entity. If the Document already includes a
+    cover text for the same cover, previously added by you or by arrangement
+    made by the same entity you are acting on behalf of, you may not add
+    another; but you may replace the old one, on explicit permission from the
+    previous publisher that added the old one.</p><p>The author(s) and publisher(s) of the Document do not by this
+    License give permission to use their names for publicity for or to assert
+    or imply endorsement of any Modified Version.</p></div><div class="section" title="D.5. Combining Documents"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-5"></a>D.5. Combining Documents</h2></div></div></div><p>You may combine the Document with other documents released under
+    this License, under the terms defined in section 4 above for modified
+    versions, provided that you include in the combination all of the
+    Invariant Sections of all of the original documents, unmodified, and list
+    them all as Invariant Sections of your combined work in its license
+    notice.</p><p>The combined work need only contain one copy of this License, and
+    multiple identical Invariant Sections may be replaced with a single copy.
+    If there are multiple Invariant Sections with the same name but different
+    contents, make the title of each such section unique by adding at the end
+    of it, in parentheses, the name of the original author or publisher of
+    that section if known, or else a unique number. Make the same adjustment
+    to the section titles in the list of Invariant Sections in the license
+    notice of the combined work.</p><p>In the combination, you must combine any sections entitled
+    "History" in the various original documents, forming one section entitled
+    "History"; likewise combine any sections entitled "Acknowledgements", and
+    any sections entitled "Dedications". You must delete all sections
+    entitled "Endorsements."</p></div><div class="section" title="D.6. Collections of Documents"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-6"></a>D.6. Collections of Documents</h2></div></div></div><p>You may make a collection consisting of the Document and other
+    documents released under this License, and replace the individual copies
+    of this License in the various documents with a single copy that is
+    included in the collection, provided that you follow the rules of this
+    License for verbatim copying of each of the documents in all other
+    respects.</p><p>You may extract a single document from such a collection, and
+    distribute it individually under this License, provided you insert a copy
+    of this License into the extracted document, and follow this License in
+    all other respects regarding verbatim copying of that document.</p></div><div class="section" title="D.7. Aggregation with Independent Works"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-7"></a>D.7. Aggregation with Independent Works</h2></div></div></div><p>A compilation of the Document or its derivatives with other
+    separate and independent documents or works, in or on a volume of a
+    storage or distribution medium, does not as a whole count as a Modified
+    Version of the Document, provided no compilation copyright is claimed for
+    the compilation. Such a compilation is called an "aggregate", and this
+    License does not apply to the other self-contained works thus compiled
+    with the Document, on account of their being thus compiled, if they are
+    not themselves derivative works of the Document.</p><p>If the Cover Text requirement of section 3 is applicable to these
+    copies of the Document, then if the Document is less than one quarter of
+    the entire aggregate, the Document's Cover Texts may be placed on covers
+    that surround only the Document within the aggregate. Otherwise they must
+    appear on covers around the whole aggregate.</p></div><div class="section" title="D.8. Translation"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-8"></a>D.8. Translation</h2></div></div></div><p>Translation is considered a kind of modification, so you may
+    distribute translations of the Document under the terms of section 4.
+    Replacing Invariant Sections with translations requires special
+    permission from their copyright holders, but you may include translations
+    of some or all Invariant Sections in addition to the original versions of
+    these Invariant Sections. You may include a translation of this License
+    provided that you also include the original English version of this
+    License. In case of a disagreement between the translation and the
+    original English version of this License, the original English version
+    will prevail.</p></div><div class="section" title="D.9. Termination"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-9"></a>D.9. Termination</h2></div></div></div><p>You may not copy, modify, sublicense, or distribute the Document
+    except as expressly provided for under this License. Any other attempt to
+    copy, modify, sublicense or distribute the Document is void, and will
+    automatically terminate your rights under this License. However, parties
+    who have received copies, or rights, from you under this License will not
+    have their licenses terminated so long as such parties remain in full
+    compliance.</p></div><div class="section" title="D.10. Future Revisions of this License"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-10"></a>D.10. Future Revisions of this License</h2></div></div></div><p>The Free Software Foundation may publish new, revised versions of
+    the GNU Free Documentation License from time to time. Such new versions
+    will be similar in spirit to the present version, but may differ in
+    detail to address new problems or concerns. See 
+    <a class="ulink" href="http://www.gnu.org/copyleft/" target="_top">http://www.gnu.org/copyleft/</a>.</p><p>Each version of the License is given a distinguishing version
+    number. If the Document specifies that a particular numbered version of
+    this License "or any later version" applies to it, you have the option of
+    following the terms and conditions either of that specified version or of
+    any later version that has been published (not as a draft) by the Free
+    Software Foundation. If the Document does not specify a version number of
+    this License, you may choose any version ever published (not as a draft)
+    by the Free Software Foundation.</p></div><div class="section" title="D.. How to use this License for your documents"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-howto"></a>D.. How to use this License for your documents</h2></div></div></div><p>To use this License in a document you have written, include a copy
+    of the License in the document and put the following copyright and
+    license notices just after the title page:</p><div class="blockquote"><blockquote class="blockquote"><p>Copyright (c) YEAR YOUR NAME. Permission is granted to copy,
+      distribute and/or modify this document under the terms of the GNU Free
+      Documentation License, Version 1.1 or any later version published by
+      the Free Software Foundation; with the Invariant Sections being LIST
+      THEIR TITLES, with the Front-Cover Texts being LIST, and with the
+      Back-Cover Texts being LIST. A copy of the license is included in the
+      section entitled "GNU Free Documentation License".</p></blockquote></div><p>If you have no Invariant Sections, write "with no Invariant
+    Sections" instead of saying which ones are invariant. If you have no
+    Front-Cover Texts, write "no Front-Cover Texts" instead of "Front-Cover
+    Texts being LIST"; likewise for Back-Cover Texts.</p><p>If your document contains nontrivial examples of program code, we
+    recommend releasing these examples in parallel under your choice of free
+    software license, such as the GNU General Public License, to permit their
+    use in free software.</p></div></div><div class="glossary" title="Glossary"><div class="titlepage"><div><div><h2 class="title"><a name="glossary"></a>Glossary</h2></div></div></div><div class="glossdiv" title="0-9, high ascii"><h3 class="title">0-9, high ascii</h3><dl><dt><a name="gloss-htaccess"></a>.htaccess</dt><dd><p>Apache web server, and other NCSA-compliant web servers,
+        observe the convention of using files in directories called 
+        <code class="filename">.htaccess</code>
+
+        to restrict access to certain files. In Bugzilla, they are used
+        to keep secret files which would otherwise
+        compromise your installation - e.g. the 
+        <code class="filename">localconfig</code>
+        file contains the password to your database.
+        curious.</p></dd></dl></div><div class="glossdiv" title="A"><h3 class="title">A</h3><dl><dt><a name="gloss-apache"></a>Apache</dt><dd><p>In this context, Apache is the web server most commonly used
+        for serving up Bugzilla 
+        pages. Contrary to popular belief, the apache web server has nothing
+        to do with the ancient and noble Native American tribe, but instead
+        derived its name from the fact that it was 
+        <span class="quote">“<span class="quote">a patchy</span>”</span>
+        version of the original 
+        <acronym class="acronym">NCSA</acronym>
+        world-wide-web server.</p><div class="variablelist" title="Useful Directives when configuring Bugzilla"><p class="title"><b>Useful Directives when configuring Bugzilla</b></p><dl><dt><span class="term"><code class="computeroutput"><a class="ulink" href="http://httpd.apache.org/docs/2.0/mod/mod_mime.html#addhandler" target="_top">AddHandler</a></code></span></dt><dd><p>Tell Apache that it's OK to run CGI scripts.</p></dd><dt><span class="term"><code class="computeroutput"><a class="ulink" href="http://httpd.apache.org/docs-2.0/mod/core.html#allowoverride" target="_top">AllowOverride</a></code>, </span><span class="term"><code class="computeroutput"><a class="ulink" href="http://httpd.apache.org/docs-2.0/mod/core.html#options" target="_top">Options</a></code></span></dt><dd><p>These directives are used to tell Apache many things about
+              the directory they apply to. For Bugzilla's purposes, we need
+              them to allow script execution and <code class="filename">.htaccess</code>
+              overrides.
+              </p></dd><dt><span class="term"><code class="computeroutput"><a class="ulink" href="http://httpd.apache.org/docs-2.0/mod/mod_dir.html#directoryindex" target="_top">DirectoryIndex</a></code></span></dt><dd><p>Used to tell Apache what files are indexes. If you can
+              not add <code class="filename">index.cgi</code> to the list of valid files,
+              you'll need to set <code class="computeroutput">$index_html</code> to
+              1 in <code class="filename">localconfig</code> so
+              <span class="command"><strong>./checksetup.pl</strong></span> will create an
+              <code class="filename">index.html</code> that redirects to
+              <code class="filename">index.cgi</code>.
+              </p></dd><dt><span class="term"><code class="computeroutput"><a class="ulink" href="http://httpd.apache.org/docs-2.0/mod/core.html#scriptinterpretersource" target="_top">ScriptInterpreterSource</a></code></span></dt><dd><p>Used when running Apache on windows so the shebang line
+              doesn't have to be changed in every Bugzilla script.
+              </p></dd></dl></div><p>For more information about how to configure Apache for Bugzilla,
+        see <a class="xref" href="#http-apache" title="2.2.4.1. Bugzilla using Apache">Section 2.2.4.1, “Bugzilla using Apache”</a>.
+        </p></dd></dl></div><div class="glossdiv" title="B"><h3 class="title">B</h3><dl><dt>Bug</dt><dd><p>A 
+        <span class="quote">“<span class="quote">bug</span>”</span>
+
+        in Bugzilla refers to an issue entered into the database which has an
+        associated number, assignments, comments, etc. Some also refer to a 
+        <span class="quote">“<span class="quote">tickets</span>”</span>
+        or 
+        <span class="quote">“<span class="quote">issues</span>”</span>; 
+        in the context of Bugzilla, they are synonymous.</p></dd><dt>Bug Number</dt><dd><p>Each Bugzilla bug is assigned a number that uniquely identifies
+        that bug. The bug associated with a bug number can be pulled up via a
+        query, or easily from the very front page by typing the number in the
+        "Find" box.</p></dd><dt><a name="gloss-bugzilla"></a>Bugzilla</dt><dd><p>Bugzilla is the world-leading free software bug tracking system.
+        </p></dd></dl></div><div class="glossdiv" title="C"><h3 class="title">C</h3><dl><dt><a name="gloss-cgi"></a>Common Gateway Interface</dt><dd><p><acronym class="acronym">CGI</acronym> is an acronym for Common Gateway Interface. This is
+        a standard for interfacing an external application with a web server. Bugzilla
+        is an example of a <acronym class="acronym">CGI</acronym> application.
+        </p></dd><dt><a name="gloss-component"></a>Component</dt><dd><p>A Component is a subsection of a Product. It should be a narrow
+        category, tailored to your organization. All Products must contain at
+        least one Component (and, as a matter of fact, creating a Product
+        with no Components will create an error in Bugzilla).</p></dd><dt><a name="gloss-cpan"></a>Comprehensive Perl Archive Network</dt><dd><p>
+        <acronym class="acronym">CPAN</acronym>
+
+        stands for the 
+        <span class="quote">“<span class="quote">Comprehensive Perl Archive Network</span>”</span>. 
+        CPAN maintains a large number of extremely useful 
+        <em class="glossterm">Perl</em>
+        modules - encapsulated chunks of code for performing a
+        particular task.</p></dd><dt><a name="gloss-contrib"></a><code class="filename">contrib</code></dt><dd><p>The <code class="filename">contrib</code> directory is
+        a location to put scripts that have been contributed to Bugzilla but
+        are not a part of the official distribution. These scripts are written
+        by third parties and may be in languages other than perl. For those
+        that are in perl, there may be additional modules or other requirements
+        than those of the official distribution.
+        </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Scripts in the <code class="filename">contrib</code>
+          directory are not officially supported by the Bugzilla team and may
+          break in between versions.
+          </p></td></tr></table></div><p>
+        </p></dd></dl></div><div class="glossdiv" title="D"><h3 class="title">D</h3><dl><dt><a name="gloss-daemon"></a>daemon</dt><dd><p>A daemon is a computer program which runs in the background. In
+        general, most daemons are started at boot time via System V init
+        scripts, or through RC scripts on BSD-based systems. 
+        <em class="glossterm">mysqld</em>, 
+        the MySQL server, and 
+        <em class="glossterm">apache</em>, 
+        a web server, are generally run as daemons.</p></dd><dt><a name="gloss-dos"></a>DOS Attack</dt><dd><p>A DOS, or Denial of Service attack, is when a user attempts to
+        deny access to a web server by repeatedly accessing a page or sending
+        malformed requests to a webserver. A D-DOS, or
+        Distributed Denial of Service attack, is when these requests come
+        from multiple sources at the same time. Unfortunately, these are much
+        more difficult to defend against.
+        </p></dd></dl></div><div class="glossdiv" title="G"><h3 class="title">G</h3><dl><dt><a name="gloss-groups"></a>Groups</dt><dd><p>The word 
+        <span class="quote">“<span class="quote">Groups</span>”</span>
+
+        has a very special meaning to Bugzilla. Bugzilla's main security
+        mechanism comes by placing users in groups, and assigning those
+        groups certain privileges to view bugs in particular
+        <em class="glossterm">Products</em>
+        in the 
+        <em class="glossterm">Bugzilla</em>
+        database.</p></dd></dl></div><div class="glossdiv" title="J"><h3 class="title">J</h3><dl><dt><a name="gloss-javascript"></a>JavaScript</dt><dd><p>JavaScript is cool, we should talk about it.
+        </p></dd></dl></div><div class="glossdiv" title="M"><h3 class="title">M</h3><dl><dt><a name="gloss-mta"></a>Message Transport Agent</dt><dd><p>A Message Transport Agent is used to control the flow of email on a system.
+        The <a class="ulink" href="http://search.cpan.org/dist/Email-Send/lib/Email/Send.pm" target="_top">Email::Send</a>
+        Perl module, which Bugzilla uses to send email, can be configured to
+        use many different underlying implementations for actually sending the
+        mail using the <code class="option">mail_delivery_method</code> parameter.
+        </p></dd><dt><a name="gloss-mysql"></a>MySQL</dt><dd><p>MySQL is one of the supported
+        <a class="glossterm" href="#gloss-rdbms"><em class="glossterm">RDBMS</em></a> for Bugzilla. MySQL
+        can be downloaded from <a class="ulink" href="http://www.mysql.com" target="_top">http://www.mysql.com</a>. While you
+        should familiarize yourself with all of the documentation, some high
+        points are:
+        </p><div class="variablelist"><dl><dt><span class="term"><a class="ulink" href="http://www.mysql.com/doc/en/Backup.html" target="_top">Backup</a></span></dt><dd><p>Methods for backing up your Bugzilla database.
+              </p></dd><dt><span class="term"><a class="ulink" href="http://www.mysql.com/doc/en/Option_files.html" target="_top">Option Files</a></span></dt><dd><p>Information about how to configure MySQL using
+              <code class="filename">my.cnf</code>.
+              </p></dd><dt><span class="term"><a class="ulink" href="http://www.mysql.com/doc/en/Privilege_system.html" target="_top">Privilege System</a></span></dt><dd><p>Information about how to protect your MySQL server.
+              </p></dd></dl></div></dd></dl></div><div class="glossdiv" title="P"><h3 class="title">P</h3><dl><dt><a name="gloss-ppm"></a>Perl Package Manager</dt><dd><p><a class="ulink" href="http://aspn.activestate.com/ASPN/Downloads/ActivePerl/PPM/" target="_top">http://aspn.activestate.com/ASPN/Downloads/ActivePerl/PPM/</a>
+        </p></dd><dt>Product</dt><dd><p>A Product is a broad category of types of bugs, normally
+        representing a single piece of software or entity. In general,
+        there are several Components to a Product. A Product may define a
+        group (used for security) for all bugs entered into
+        its Components.</p></dd><dt>Perl</dt><dd><p>First written by Larry Wall, Perl is a remarkable program
+        language. It has the benefits of the flexibility of an interpreted
+        scripting language (such as shell script), combined with the speed
+        and power of a compiled language, such as C. 
+        <em class="glossterm">Bugzilla</em>
+
+        is maintained in Perl.</p></dd></dl></div><div class="glossdiv" title="Q"><h3 class="title">Q</h3><dl><dt>QA</dt><dd><p>
+        <span class="quote">“<span class="quote">QA</span>”</span>, 
+        <span class="quote">“<span class="quote">Q/A</span>”</span>, and 
+        <span class="quote">“<span class="quote">Q.A.</span>”</span>
+        are short for 
+        <span class="quote">“<span class="quote">Quality Assurance</span>”</span>. 
+        In most large software development organizations, there is a team
+        devoted to ensuring the product meets minimum standards before
+        shipping. This team will also generally want to track the progress of
+        bugs over their life cycle, thus the need for the 
+        <span class="quote">“<span class="quote">QA Contact</span>”</span>
+
+        field in a bug.</p></dd></dl></div><div class="glossdiv" title="R"><h3 class="title">R</h3><dl><dt><a name="gloss-rdbms"></a>Relational DataBase Management System</dt><dd><p>A relational database management system is a database system
+        that stores information in tables that are related to each other.
+        </p></dd><dt><a name="gloss-regexp"></a>Regular Expression</dt><dd><p>A regular expression is an expression used for pattern matching.
+              <a class="ulink" href="http://perldoc.com/perl5.6/pod/perlre.html#Regular-Expressions" target="_top">Documentation</a>
+        </p></dd></dl></div><div class="glossdiv" title="S"><h3 class="title">S</h3><dl><dt><a name="gloss-service"></a>Service</dt><dd><p>In Windows NT environment, a boot-time background application
+        is referred to as a service. These are generally managed through the
+        control panel while logged in as an account with
+        <span class="quote">“<span class="quote">Administrator</span>”</span> level capabilities. For more
+        information, consult your Windows manual or the MSKB.
+        </p></dd><dt>
+        <acronym class="acronym">SGML</acronym>
+      </dt><dd><p>
+        <acronym class="acronym">SGML</acronym>
+
+        stands for 
+        <span class="quote">“<span class="quote">Standard Generalized Markup Language</span>”</span>. 
+        Created in the 1980's to provide an extensible means to maintain
+        documentation based upon content instead of presentation, 
+        <acronym class="acronym">SGML</acronym>
+
+        has withstood the test of time as a robust, powerful language. 
+        <em class="glossterm">
+          <acronym class="acronym">XML</acronym>
+        </em>
+
+        is the 
+        <span class="quote">“<span class="quote">baby brother</span>”</span>
+
+        of SGML; any valid 
+        <acronym class="acronym">XML</acronym>
+
+        document it, by definition, a valid 
+        <acronym class="acronym">SGML</acronym>
+
+        document. The document you are reading is written and maintained in 
+        <acronym class="acronym">SGML</acronym>, 
+        and is also valid 
+        <acronym class="acronym">XML</acronym>
+
+        if you modify the Document Type Definition.</p></dd></dl></div><div class="glossdiv" title="T"><h3 class="title">T</h3><dl><dt><a name="gloss-target-milestone"></a>Target Milestone</dt><dd><p>Target Milestones are Product goals. They are configurable on a
+        per-Product basis. Most software development houses have a concept of
+        
+        <span class="quote">“<span class="quote">milestones</span>”</span>
+
+        where the people funding a project expect certain functionality on
+        certain dates. Bugzilla facilitates meeting these milestones by
+        giving you the ability to declare by which milestone a bug will be
+        fixed, or an enhancement will be implemented.</p></dd><dt><a name="gloss-tcl"></a>Tool Command Language</dt><dd><p>TCL is an open source scripting language available for Windows,
+        Macintosh, and Unix based systems. Bugzilla 1.0 was written in TCL but
+        never released. The first release of Bugzilla was 2.0, which was when
+        it was ported to perl.
+        </p></dd></dl></div><div class="glossdiv" title="Z"><h3 class="title">Z</h3><dl><dt><a name="gloss-zarro"></a>Zarro Boogs Found</dt><dd><p>This is just a goofy way of saying that there were no bugs
+        found matching your query. When asked to explain this message,
+        Terry had the following to say:
+        </p><div class="blockquote"><table border="0" width="100%" cellspacing="0" cellpadding="0" class="blockquote" summary="Block quote"><tr><td width="10%" valign="top"> </td><td width="80%" valign="top"><p>I've been asked to explain this ... way back when, when
+          Netscape released version 4.0 of its browser, we had a release
+          party.  Naturally, there had been a big push to try and fix every
+          known bug before the release. Naturally, that hadn't actually
+          happened.  (This is not unique to Netscape or to 4.0; the same thing
+          has happened with every software project I've ever seen.)  Anyway,
+          at the release party, T-shirts were handed out that said something
+          like "Netscape 4.0: Zarro Boogs". Just like the software, the
+          T-shirt had no known bugs.  Uh-huh.
+          </p><p>So, when you query for a list of bugs, and it gets no results,
+          you can think of this as a friendly reminder.  Of *course* there are
+          bugs matching your query, they just aren't in the bugsystem yet...
+          </p></td><td width="10%" valign="top"> </td></tr><tr><td width="10%" valign="top"> </td><td colspan="2" align="right" valign="top">--<span class="attribution">Terry Weissman</span></td></tr></table></div></dd></dl></div></div></div></body></html>

diff --git a/docs/en/html/about.html b/docs/en/html/about.html
new file mode 100644 (file)
index 0000000..f868722
--- /dev/null
+++ b/docs/en/html/about.html
@@ -0,0 +1,3 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 1. About This Guide</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="prev" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="next" href="copyright.html" title="1.1. Copyright Information"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 1. About This Guide</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="copyright.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 1. About This Guide"><div class="titlepage"><div><div><h2 class="title"><a name="about"></a>Chapter 1. About This Guide</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="copyright.html">1.1. Copyright Information</a></span></dt><dt><span class="section"><a href="disclaimer.html">1.2. Disclaimer</a></span></dt><dt><span class="section"><a href="newversions.html">1.3. New Versions</a></span></dt><dt><span class="section"><a href="credits.html">1.4. Credits</a></span></dt><dt><span class="section"><a href="conventions.html">1.5. Document Conventions</a></span></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="copyright.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">The Bugzilla Guide - 4.4 
+    Release </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 1.1. Copyright Information</td></tr></table></div></body></html>

diff --git a/docs/en/html/administration.html b/docs/en/html/administration.html
new file mode 100644 (file)
index 0000000..770a081
--- /dev/null
+++ b/docs/en/html/administration.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 3. Administering Bugzilla</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="prev" href="upgrade.html" title="2.7. Upgrading to New Releases"><link rel="next" href="parameters.html" title="3.1. Bugzilla Configuration"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 3. Administering Bugzilla</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="upgrade.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="parameters.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 3. Administering Bugzilla"><div class="titlepage"><div><div><h2 class="title"><a name="administration"></a>Chapter 3. Administering Bugzilla</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="parameters.html">3.1. Bugzilla Configuration</a></span></dt><dd><dl><dt><span class="section"><a href="parameters.html#param-requiredsettings">3.1.1. Required Settings</a></span></dt><dt><span class="section"><a href="parameters.html#param-admin-policies">3.1.2. Administrative Policies</a></span></dt><dt><span class="section"><a href="parameters.html#param-user-authentication">3.1.3. User Authentication</a></span></dt><dt><span class="section"><a href="parameters.html#param-attachments">3.1.4. Attachments</a></span></dt><dt><span class="section"><a href="parameters.html#param-bug-change-policies">3.1.5. Bug Change Policies</a></span></dt><dt><span class="section"><a href="parameters.html#param-bugfields">3.1.6. Bug Fields</a></span></dt><dt><span class="section"><a href="parameters.html#param-bugmoving">3.1.7. Bug Moving</a></span></dt><dt><span class="section"><a href="parameters.html#param-dependency-graphs">3.1.8. Dependency Graphs</a></span></dt><dt><span class="section"><a href="parameters.html#param-group-security">3.1.9. Group Security</a></span></dt><dt><span class="section"><a href="parameters.html#bzldap">3.1.10. LDAP Authentication</a></span></dt><dt><span class="section"><a href="parameters.html#bzradius">3.1.11. RADIUS Authentication</a></span></dt><dt><span class="section"><a href="parameters.html#param-email">3.1.12. Email</a></span></dt><dt><span class="section"><a href="parameters.html#param-patchviewer">3.1.13. Patch Viewer</a></span></dt><dt><span class="section"><a href="parameters.html#param-querydefaults">3.1.14. Query Defaults</a></span></dt><dt><span class="section"><a href="parameters.html#param-shadowdatabase">3.1.15. Shadow Database</a></span></dt><dt><span class="section"><a href="parameters.html#admin-usermatching">3.1.16. User Matching</a></span></dt></dl></dd><dt><span class="section"><a href="useradmin.html">3.2. User Administration</a></span></dt><dd><dl><dt><span class="section"><a href="useradmin.html#defaultuser">3.2.1. Creating the Default User</a></span></dt><dt><span class="section"><a href="useradmin.html#manageusers">3.2.2. Managing Other Users</a></span></dt></dl></dd><dt><span class="section"><a href="classifications.html">3.3. Classifications</a></span></dt><dt><span class="section"><a href="products.html">3.4. Products</a></span></dt><dd><dl><dt><span class="section"><a href="products.html#create-product">3.4.1. Creating New Products</a></span></dt><dt><span class="section"><a href="products.html#edit-products">3.4.2. Editing Products</a></span></dt><dt><span class="section"><a href="products.html#comps-vers-miles-products">3.4.3. Adding or Editing Components, Versions and Target Milestones</a></span></dt><dt><span class="section"><a href="products.html#product-group-controls">3.4.4. Assigning Group Controls to Products</a></span></dt></dl></dd><dt><span class="section"><a href="components.html">3.5. Components</a></span></dt><dt><span class="section"><a href="versions.html">3.6. Versions</a></span></dt><dt><span class="section"><a href="milestones.html">3.7. Milestones</a></span></dt><dt><span class="section"><a href="flags-overview.html">3.8. Flags</a></span></dt><dd><dl><dt><span class="section"><a href="flags-overview.html#flags-simpleexample">3.8.1. A Simple Example</a></span></dt><dt><span class="section"><a href="flags-overview.html#flags-about">3.8.2. About Flags</a></span></dt><dt><span class="section"><a href="flags-overview.html#flag-askto">3.8.3. Using flag requests</a></span></dt><dt><span class="section"><a href="flags-overview.html#flag-types">3.8.4. Two Types of Flags</a></span></dt><dt><span class="section"><a href="flags-overview.html#flags-admin">3.8.5. Administering Flags</a></span></dt></dl></dd><dt><span class="section"><a href="keywords.html">3.9. Keywords</a></span></dt><dt><span class="section"><a href="custom-fields.html">3.10. Custom Fields</a></span></dt><dd><dl><dt><span class="section"><a href="custom-fields.html#add-custom-fields">3.10.1. Adding Custom Fields</a></span></dt><dt><span class="section"><a href="custom-fields.html#edit-custom-fields">3.10.2. Editing Custom Fields</a></span></dt><dt><span class="section"><a href="custom-fields.html#delete-custom-fields">3.10.3. Deleting Custom Fields</a></span></dt></dl></dd><dt><span class="section"><a href="edit-values.html">3.11. Legal Values</a></span></dt><dd><dl><dt><span class="section"><a href="edit-values.html#edit-values-list">3.11.1. Viewing/Editing legal values</a></span></dt><dt><span class="section"><a href="edit-values.html#edit-values-delete">3.11.2. Deleting legal values</a></span></dt></dl></dd><dt><span class="section"><a href="bug_status_workflow.html">3.12. Bug Status Workflow</a></span></dt><dt><span class="section"><a href="voting.html">3.13. Voting</a></span></dt><dt><span class="section"><a href="quips.html">3.14. Quips</a></span></dt><dt><span class="section"><a href="groups.html">3.15. Groups and Group Security</a></span></dt><dd><dl><dt><span class="section"><a href="groups.html#create-groups">3.15.1. Creating Groups</a></span></dt><dt><span class="section"><a href="groups.html#edit-groups">3.15.2. Editing Groups and Assigning Group Permissions</a></span></dt><dt><span class="section"><a href="groups.html#users-and-groups">3.15.3. Assigning Users to Groups</a></span></dt><dt><span class="section"><a href="groups.html#idp14405664">3.15.4. Assigning Group Controls to Products</a></span></dt></dl></dd><dt><span class="section"><a href="sanitycheck.html">3.16. Checking and Maintaining Database Integrity</a></span></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="upgrade.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="parameters.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2.7. Upgrading to New Releases </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.1. Bugzilla Configuration</td></tr></table></div></body></html>

diff --git a/docs/en/html/api/Bugzilla.html b/docs/en/html/api/Bugzilla.html
new file mode 100644 (file)
index 0000000..aaf5b76
--- /dev/null
+++ b/docs/en/html/api/Bugzilla.html
@@ -0,0 +1,293 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="./../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla - Semi-persistent collection of various objects used by scripts and modules</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">  use Bugzilla;
+
+  sub someModulesSub {
+    Bugzilla-&#62;dbh-&#62;prepare(...);
+    Bugzilla-&#62;template-&#62;process(...);
+  }</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Several Bugzilla &#39;things&#39; are used by a variety of modules and scripts. This includes database handles, template objects, and so on.</p>
+
+<p>This module is a singleton intended as a central place to store these objects. This approach has several advantages:</p>
+
+<ul>
+<li>They&#39;re not global variables, so we don&#39;t have issues with them staying around with mod_perl</li>
+
+<li>Everything is in one central place, so it&#39;s easy to access, modify, and maintain</li>
+
+<li>Code in modules can get access to these objects without having to have them all passed from the caller, and the caller&#39;s caller, and....</li>
+
+<li>We can reuse objects across requests using mod_perl where appropriate (eg templates), whilst destroying those which are only valid for a single request (such as the current user)</li>
+</ul>
+
+<p>Note that items accessible via this object are demand-loaded when requested.</p>
+
+<p>For something to be added to this object, it should either be able to benefit from persistence when run under mod_perl (such as the a <code  class="code">template</code> object), or should be something which is globally required by a large ammount of code (such as the current <code  class="code">user</code> object).</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<p>Note that all <code  class="code">Bugzilla</code> functionality is method based; use <code  class="code">Bugzilla-&#62;dbh</code> rather than <code  class="code">Bugzilla::dbh</code>. Nothing cares about this now, but don&#39;t rely on that.</p>
+
+<dl>
+<dt><a name="template"
+><code  class="code">template</code></a></dt>
+
+<dd>
+<p>The current <code  class="code">Template</code> object, to be used for output</p>
+
+<dt><a name="template_inner"
+><code  class="code">template_inner</code></a></dt>
+
+<dd>
+<p>If you ever need a <a href="./Bugzilla/Template.html" class="podlinkpod"
+>Bugzilla::Template</a> object while you&#39;re already processing a template, use this. Also use it if you want to specify the language to use. If no argument is passed, it uses the last language set. If the argument is &#34;&#34; (empty string), the language is reset to the current one (the one used by Bugzilla-&#62;template).</p>
+
+<dt><a name="cgi"
+><code  class="code">cgi</code></a></dt>
+
+<dd>
+<p>The current <code  class="code">cgi</code> object. Note that modules should <b>not</b> be using this in general. Not all Bugzilla actions are cgi requests. Its useful as a convenience method for those scripts/templates which are only use via CGI, though.</p>
+
+<dt><a name="input_params"
+><code  class="code">input_params</code></a></dt>
+
+<dd>
+<p>When running under the WebService, this is a hashref containing the arguments passed to the WebService method that was called. When running in a normal script, this is a hashref containing the contents of the CGI parameters.</p>
+
+<p>Modifying this hashref will modify the CGI parameters or the WebService arguments (depending on what <code  class="code">input_params</code> currently represents).</p>
+
+<p>This should be used instead of <a href="#cgi" class="podlinkpod"
+>&#34;cgi&#34;</a> in situations where your code could be being called by either a normal CGI script or a WebService method, such as during a code hook.</p>
+
+<p><b>Note:</b> When <code  class="code">input_params</code> represents the CGI parameters, any parameter specified more than once (like <code  class="code">foo=bar&#38;foo=baz</code>) will appear as an arrayref in the hash, but any value specified only once will appear as a scalar. This means that even if a value <i>can</i> appear multiple times, if it only <i>does</i> appear once, then it will be a scalar in <code  class="code">input_params</code>, not an arrayref.</p>
+
+<dt><a name="user"
+><code  class="code">user</code></a></dt>
+
+<dd>
+<p><code  class="code">undef</code> if there is no currently logged in user or if the login code has not yet been run. If an sudo session is in progress, the <code  class="code">Bugzilla::User</code> corresponding to the person who is being impersonated. If no session is in progress, the current <code  class="code">Bugzilla::User</code>.</p>
+
+<dt><a name="set_user"
+><code  class="code">set_user</code></a></dt>
+
+<dd>
+<p>Allows you to directly set what <a href="#user" class="podlinkpod"
+>&#34;user&#34;</a> will return. You can use this if you want to bypass <a href="#login" class="podlinkpod"
+>&#34;login&#34;</a> for some reason and directly &#34;log in&#34; a specific <a href="./Bugzilla/User.html" class="podlinkpod"
+>Bugzilla::User</a>. Be careful with it, though!</p>
+
+<dt><a name="sudoer"
+><code  class="code">sudoer</code></a></dt>
+
+<dd>
+<p><code  class="code">undef</code> if there is no currently logged in user, the currently logged in user is not in the <i>sudoer</i> group, or there is no session in progress. If an sudo session is in progress, returns the <code  class="code">Bugzilla::User</code> object corresponding to the person who logged in and initiated the session. If no session is in progress, returns the <code  class="code">Bugzilla::User</code> object corresponding to the currently logged in user.</p>
+
+<dt><a 
+><code  class="code">sudo_request</code> This begins an sudo session for the current request. It is meant to be used when a session has just started. For normal use, sudo access should normally be set at login time.</a></dt>
+
+<dd>
+<dt><a name="login"
+><code  class="code">login</code></a></dt>
+
+<dd>
+<p>Logs in a user, returning a <code  class="code">Bugzilla::User</code> object, or <code  class="code">undef</code> if there is no logged in user. See <a href="./Bugzilla/Auth.html" class="podlinkpod"
+>Bugzilla::Auth</a>, and <a href="./Bugzilla/User.html" class="podlinkpod"
+>Bugzilla::User</a>.</p>
+
+<dt><a name="page_requires_login"
+><code  class="code">page_requires_login</code></a></dt>
+
+<dd>
+<p>If the current page always requires the user to log in (for example, <code  class="code">enter_bug.cgi</code> or any page called with <code  class="code">?GoAheadAndLogIn=1</code>) then this will return something true. Otherwise it will return false. (This is set when you call <a href="#login" class="podlinkpod"
+>&#34;login&#34;</a>.)</p>
+
+<dt><a name="logout($option)"
+><code  class="code">logout($option)</code></a></dt>
+
+<dd>
+<p>Logs out the current user, which involves invalidating user sessions and cookies. Three options are available from <a href="./Bugzilla/Constants.html" class="podlinkpod"
+>Bugzilla::Constants</a>: LOGOUT_CURRENT (the default), LOGOUT_ALL or LOGOUT_KEEP_CURRENT.</p>
+
+<dt><a name="logout_user($user)"
+><code  class="code">logout_user($user)</code></a></dt>
+
+<dd>
+<p>Logs out the specified user (invalidating all his sessions), taking a Bugzilla::User instance.</p>
+
+<dt><a name="logout_by_id($id)"
+><code  class="code">logout_by_id($id)</code></a></dt>
+
+<dd>
+<p>Logs out the user with the id specified. This is a compatibility function to be used in callsites where there is only a userid and no Bugzilla::User instance.</p>
+
+<dt><a name="logout_request"
+><code  class="code">logout_request</code></a></dt>
+
+<dd>
+<p>Essentially, causes calls to <code  class="code">Bugzilla-&#62;user</code> to return <code  class="code">undef</code>. This has the effect of logging out a user for the current request only; cookies and database sessions are left intact.</p>
+
+<dt><a name="fields"
+><code  class="code">fields</code></a></dt>
+
+<dd>
+<p>This is the standard way to get arrays or hashes of <a href="./Bugzilla/Field.html" class="podlinkpod"
+>Bugzilla::Field</a> objects when you need them. It takes the following named arguments in a hashref:</p>
+
+<dl>
+<dt><a name="by_name"
+><code  class="code">by_name</code></a></dt>
+
+<dd>
+<p>If false (or not specified), this method will return an arrayref of the requested fields.</p>
+
+<p>If true, this method will return a hashref of fields, where the keys are field names and the valules are <a href="./Bugzilla/Field.html" class="podlinkpod"
+>Bugzilla::Field</a> objects.</p>
+
+<dt><a name="type"
+><code  class="code">type</code></a></dt>
+
+<dd>
+<p>Either a single <code  class="code">FIELD_TYPE_*</code> constant or an arrayref of them. If specified, the returned fields will be limited to the types in the list. If you don&#39;t specify this argument, all fields will be returned.</p>
+</dd>
+</dl>
+
+<dt><a name="error_mode"
+><code  class="code">error_mode</code></a></dt>
+
+<dd>
+<p>Call either <code  class="code">Bugzilla-</code>error_mode(Bugzilla::Constants::ERROR_MODE_DIE)&#62; or <code  class="code">Bugzilla-</code>error_mode(Bugzilla::Constants::ERROR_MODE_DIE_SOAP_FAULT)&#62; to change this flag&#39;s default of <code  class="code">Bugzilla::Constants::ERROR_MODE_WEBPAGE</code> and to indicate that errors should be passed to error mode specific error handlers rather than being sent to a browser and finished with an exit().</p>
+
+<p>This is useful, for example, to keep <code  class="code">eval</code> blocks from producing wild HTML on errors, making it easier for you to catch them. (Remember to reset the error mode to its previous value afterwards, though.)</p>
+
+<p><code  class="code">Bugzilla-</code>error_mode&#62; will return the current state of this flag.</p>
+
+<p>Note that <code  class="code">Bugzilla-</code>error_mode&#62; is being called by <code  class="code">Bugzilla-</code>usage_mode&#62; on usage mode changes.</p>
+
+<dt><a name="usage_mode"
+><code  class="code">usage_mode</code></a></dt>
+
+<dd>
+<p>Call either <code  class="code">Bugzilla-</code>usage_mode(Bugzilla::Constants::USAGE_MODE_CMDLINE)&#62; or <code  class="code">Bugzilla-</code>usage_mode(Bugzilla::Constants::USAGE_MODE_XMLRPC)&#62; near the beginning of your script to change this flag&#39;s default of <code  class="code">Bugzilla::Constants::USAGE_MODE_BROWSER</code> and to indicate that Bugzilla is being called in a non-interactive manner.</p>
+
+<p>This influences error handling because on usage mode changes, <code  class="code">usage_mode</code> calls <code  class="code">Bugzilla-</code>error_mode&#62; to set an error mode which makes sense for the usage mode.</p>
+
+<p><code  class="code">Bugzilla-</code>usage_mode&#62; will return the current state of this flag.</p>
+
+<dt><a name="installation_mode"
+><code  class="code">installation_mode</code></a></dt>
+
+<dd>
+<p>Determines whether or not installation should be silent. See <a href="./Bugzilla/Constants.html" class="podlinkpod"
+>Bugzilla::Constants</a> for the <code  class="code">INSTALLATION_MODE</code> constants.</p>
+
+<dt><a name="installation_answers"
+><code  class="code">installation_answers</code></a></dt>
+
+<dd>
+<p>Returns a hashref representing any &#34;answers&#34; file passed to <em  class="code">checksetup.pl</em>, used to automatically answer or skip prompts.</p>
+
+<dt><a name="dbh"
+><code  class="code">dbh</code></a></dt>
+
+<dd>
+<p>The current database handle. See <a href="./DBI.html" class="podlinkpod"
+>DBI</a>.</p>
+
+<dt><a name="dbh_main"
+><code  class="code">dbh_main</code></a></dt>
+
+<dd>
+<p>The main database handle. See <a href="./DBI.html" class="podlinkpod"
+>DBI</a>.</p>
+
+<dt><a name="languages"
+><code  class="code">languages</code></a></dt>
+
+<dd>
+<p>Currently installed languages. Returns a reference to a list of RFC 1766 language tags of installed languages.</p>
+
+<dt><a name="current_language"
+><code  class="code">current_language</code></a></dt>
+
+<dd>
+<p>The currently active language.</p>
+
+<dt><a name="switch_to_shadow_db"
+><code  class="code">switch_to_shadow_db</code></a></dt>
+
+<dd>
+<p>Switch from using the main database to using the shadow database.</p>
+
+<dt><a name="switch_to_main_db"
+><code  class="code">switch_to_main_db</code></a></dt>
+
+<dd>
+<p>Change the database object to refer to the main database.</p>
+
+<dt><a name="params"
+><code  class="code">params</code></a></dt>
+
+<dd>
+<p>The current Parameters of Bugzilla, as a hashref. If <code  class="code">data/params</code> does not exist, then we return an empty hashref. If <code  class="code">data/params</code> is unreadable or is not valid perl, we <code  class="code">die</code>.</p>
+
+<dt><a name="local_timezone"
+><code  class="code">local_timezone</code></a></dt>
+
+<dd>
+<p>Returns the local timezone of the Bugzilla installation, as a DateTime::TimeZone object. This detection is very time consuming, so we cache this information for future references.</p>
+
+<dt><a name="job_queue"
+><code  class="code">job_queue</code></a></dt>
+
+<dd>
+<p>Returns a <a href="./Bugzilla/JobQueue.html" class="podlinkpod"
+>Bugzilla::JobQueue</a> that you can use for queueing jobs. Will throw an error if job queueing is not correctly configured on this Bugzilla installation.</p>
+
+<dt><a name="feature"
+><code  class="code">feature</code></a></dt>
+
+<dd>
+<p>Tells you whether or not a specific feature is enabled. For names of features, see <code  class="code">OPTIONAL_MODULES</code> in <code  class="code">Bugzilla::Install::Requirements</code>.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Attachment.html b/docs/en/html/api/Bugzilla/Attachment.html
new file mode 100644 (file)
index 0000000..d7e32f5
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Attachment.html
@@ -0,0 +1,261 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Attachment</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Attachment</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Instance_Properties'>Instance Properties</a>
+    <li class='indexItem indexItem2'><a href='#Class_Methods'>Class Methods</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Attachment - Bugzilla attachment class.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">  use Bugzilla::Attachment;
+
+  # Get the attachment with the given ID.
+  my $attachment = new Bugzilla::Attachment($attach_id);
+
+  # Get the attachments with the given IDs.
+  my $attachments = Bugzilla::Attachment-&#62;new_from_list($attach_ids);</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Attachment.pm represents an attachment object. It is an implementation of <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, and thus provides all methods that <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a> provides.</p>
+
+<p>The methods that are specific to <code  class="code">Bugzilla::Attachment</code> are listed below.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Instance_Properties"
+>Instance Properties</a></h2>
+
+<dl>
+<dt><a name="bug_id"
+><code  class="code">bug_id</code></a></dt>
+
+<dd>
+<p>the ID of the bug to which the attachment is attached</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="bug"
+><code  class="code">bug</code></a></dt>
+
+<dd>
+<p>the bug object to which the attachment is attached</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="description"
+><code  class="code">description</code></a></dt>
+
+<dd>
+<p>user-provided text describing the attachment</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="contenttype"
+><code  class="code">contenttype</code></a></dt>
+
+<dd>
+<p>the attachment&#39;s MIME media type</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="attacher"
+><code  class="code">attacher</code></a></dt>
+
+<dd>
+<p>the user who attached the attachment</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="attached"
+><code  class="code">attached</code></a></dt>
+
+<dd>
+<p>the date and time on which the attacher attached the attachment</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="modification_time"
+><code  class="code">modification_time</code></a></dt>
+
+<dd>
+<p>the date and time on which the attachment was last modified.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="filename"
+><code  class="code">filename</code></a></dt>
+
+<dd>
+<p>the name of the file the attacher attached</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="ispatch"
+><code  class="code">ispatch</code></a></dt>
+
+<dd>
+<p>whether or not the attachment is a patch</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="isobsolete"
+><code  class="code">isobsolete</code></a></dt>
+
+<dd>
+<p>whether or not the attachment is obsolete</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="isprivate"
+><code  class="code">isprivate</code></a></dt>
+
+<dd>
+<p>whether or not the attachment is private</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="is_viewable"
+><code  class="code">is_viewable</code></a></dt>
+
+<dd>
+<p>Returns 1 if the attachment has a content-type viewable in this browser. Note that we don&#39;t use $cgi-&#62;Accept()&#39;s ability to check if a content-type matches, because this will return a value even if it&#39;s matched by the generic */* which most browsers add to the end of their Accept: headers.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="data"
+><code  class="code">data</code></a></dt>
+
+<dd>
+<p>the content of the attachment</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="datasize"
+><code  class="code">datasize</code></a></dt>
+
+<dd>
+<p>the length (in bytes) of the attachment content</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="flags"
+><code  class="code">flags</code></a></dt>
+
+<dd>
+<p>flags that have been set on the attachment</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="flag_types"
+><code  class="code">flag_types</code></a></dt>
+
+<dd>
+<p>Return all flag types available for this attachment as well as flags already set, grouped by flag type.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Class_Methods"
+>Class Methods</a></h2>
+
+<dl>
+<dt><a name="get_attachments_by_bug($bug)"
+><code  class="code">get_attachments_by_bug($bug)</code></a></dt>
+
+<dd>
+<p>Description: retrieves and returns the attachments the currently logged in user can view for the given bug.</p>
+
+<p>Params: <code  class="code">$bug</code> - Bugzilla::Bug object - the bug for which to retrieve and return attachments.</p>
+
+<p>Returns: a reference to an array of attachment objects.</p>
+
+<dt><a name="validate_can_edit($attachment,_$product_id)"
+><code  class="code">validate_can_edit($attachment, $product_id)</code></a></dt>
+
+<dd>
+<p>Description: validates if the user is allowed to view and edit the attachment. Only the submitter or someone with editbugs privs can edit it. Only the submitter and users in the insider group can view private attachments.</p>
+
+<p>Params: $attachment - the attachment object being edited. $product_id - the product ID the attachment belongs to.</p>
+
+<p>Returns: 1 on success, 0 otherwise.</p>
+
+<dt><a name="validate_obsolete($bug,_$attach_ids)"
+><code  class="code">validate_obsolete($bug, $attach_ids)</code></a></dt>
+
+<dd>
+<p>Description: validates if attachments the user wants to mark as obsolete really belong to the given bug and are not already obsolete. Moreover, a user cannot mark an attachment as obsolete if he cannot view it (due to restrictions on it).</p>
+
+<p>Params: $bug - The bug object obsolete attachments should belong to. $attach_ids - The list of attachments to mark as obsolete.</p>
+
+<p>Returns: The list of attachment objects to mark as obsolete. Else an error is thrown.</p>
+
+<dt><a name="create"
+><code  class="code">create</code></a></dt>
+
+<dd>
+<p>Description: inserts an attachment into the given bug.</p>
+
+<p>Params: takes a hashref with the following keys: <code  class="code">bug</code> - Bugzilla::Bug object - the bug for which to insert the attachment. <code  class="code">data</code> - Either a filehandle pointing to the content of the attachment, or the content of the attachment itself. <code  class="code">description</code> - string - describe what the attachment is about. <code  class="code">filename</code> - string - the name of the attachment (used by the browser when downloading it). If the attachment is a URL, this parameter has no effect. <code  class="code">mimetype</code> - string - a valid MIME type. <code  class="code">creation_ts</code> - string (optional) - timestamp of the insert as returned by SELECT LOCALTIMESTAMP(0). <code  class="code">ispatch</code> - boolean (optional, default false) - true if the attachment is a patch. <code  class="code">isprivate</code> - boolean (optional, default false) - true if the attachment is private.</p>
+
+<p>Returns: The new attachment object.</p>
+
+<dt><a name="remove_from_db()"
+><code  class="code">remove_from_db()</code></a></dt>
+
+<dd>
+<p>Description: removes an attachment from the DB.</p>
+
+<p>Params: none</p>
+
+<p>Returns: nothing</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Auth.html b/docs/en/html/api/Bugzilla/Auth.html
new file mode 100644 (file)
index 0000000..b0db203
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Auth.html
@@ -0,0 +1,417 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Auth</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Auth</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#AUTHENTICATION_ERROR_CODES'>AUTHENTICATION ERROR CODES</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#AUTH_NODATA'>AUTH_NODATA</a>
+    <li class='indexItem indexItem2'><a href='#AUTH_ERROR'>AUTH_ERROR</a>
+    <li class='indexItem indexItem2'><a href='#AUTH_LOGINFAILED'>AUTH_LOGINFAILED</a>
+    <li class='indexItem indexItem2'><a href='#AUTH_NO_SUCH_USER'>AUTH_NO_SUCH_USER</a>
+    <li class='indexItem indexItem2'><a href='#AUTH_DISABLED'>AUTH_DISABLED</a>
+    <li class='indexItem indexItem2'><a href='#AUTH_LOCKOUT'>AUTH_LOCKOUT</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#LOGIN_TYPES'>LOGIN TYPES</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#LOGIN_OPTIONAL'>LOGIN_OPTIONAL</a>
+    <li class='indexItem indexItem2'><a href='#LOGIN_NORMAL'>LOGIN_NORMAL</a>
+    <li class='indexItem indexItem2'><a href='#LOGIN_REQUIRED'>LOGIN_REQUIRED</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Login'>Login</a>
+    <li class='indexItem indexItem2'><a href='#Info_Methods'>Info Methods</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#STRUCTURE'>STRUCTURE</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#The_Info_Getter'>The Info Getter</a>
+    <li class='indexItem indexItem2'><a href='#The_Verifier'>The Verifier</a>
+    <li class='indexItem indexItem2'><a href='#The_Persistence_Mechanism'>The Persistence Mechanism</a>
+    <li class='indexItem indexItem2'><a href='#Other_Things_We_Do'>Other Things We Do</a>
+    <li class='indexItem indexItem2'><a href='#The_%24login_data_Hash'>The $login_data Hash</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Auth - An object that authenticates the login credentials for a user.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Handles authentication for Bugzilla users.</p>
+
+<p>Authentication from Bugzilla involves two sets of modules.
+One set is used to obtain the username/password (from CGI,
+email,
+etc),
+and the other set uses this data to authenticate against the datasource (the Bugzilla DB,
+LDAP,
+PAM,
+etc.).</p>
+
+<p>Modules for obtaining the username/password are subclasses of <a href="../Bugzilla/Auth/Login.html" class="podlinkpod"
+>Bugzilla::Auth::Login</a>,
+and modules for authenticating are subclasses of <a href="../Bugzilla/Auth/Verify.html" class="podlinkpod"
+>Bugzilla::Auth::Verify</a>.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="AUTHENTICATION_ERROR_CODES"
+>AUTHENTICATION ERROR CODES</a></h1>
+
+<p>Whenever a method in the <code  class="code">Bugzilla::Auth</code> family fails in some way,
+it will return a hashref containing at least a single key called <code  class="code">failure</code>.
+<code  class="code">failure</code> will point to an integer error code,
+and depending on the error code the hashref may contain more data.</p>
+
+<p>The error codes are explained here below.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="AUTH_NODATA"
+><code  class="code">AUTH_NODATA</code></a></h2>
+
+<p>Insufficient login data was provided by the user.
+This may happen in several cases,
+such as cookie authentication when the cookie is not present.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="AUTH_ERROR"
+><code  class="code">AUTH_ERROR</code></a></h2>
+
+<p>An error occurred when trying to use the login mechanism.</p>
+
+<p>The hashref will also contain an <code  class="code">error</code> element,
+which is the name of an error from <code  class="code">template/en/default/global/code-error.html</code> -- the same type of error that would be thrown by <a href="../Bugzilla/Error/ThrowCodeError.html" class="podlinkpod"
+>Bugzilla::Error::ThrowCodeError</a>.</p>
+
+<p>The hashref *may* contain an element called <code  class="code">details</code>,
+which is a hashref that should be passed to <a href="../Bugzilla/Error/ThrowCodeError.html" class="podlinkpod"
+>Bugzilla::Error::ThrowCodeError</a> as the various fields to be used in the error message.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="AUTH_LOGINFAILED"
+><code  class="code">AUTH_LOGINFAILED</code></a></h2>
+
+<p>An incorrect username or password was given.</p>
+
+<p>The hashref may also contain a <code  class="code">failure_count</code> element,
+which specifies how many times the account has failed to log in within the lockout period (see <a href="#AUTH_LOCKOUT" class="podlinkpod"
+>&#34;AUTH_LOCKOUT&#34;</a>).
+This is used to warn the user when he is getting close to being locked out.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="AUTH_NO_SUCH_USER"
+><code  class="code">AUTH_NO_SUCH_USER</code></a></h2>
+
+<p>This is an optional more-specific version of <code  class="code">AUTH_LOGINFAILED</code>.
+Modules should throw this error when they discover that the requested user account actually does not exist,
+according to them.</p>
+
+<p>That is,
+for example,
+<a href="../Bugzilla/Auth/Verify/LDAP.html" class="podlinkpod"
+>Bugzilla::Auth::Verify::LDAP</a> would throw this if the user didn&#39;t exist in LDAP.</p>
+
+<p>The difference between <code  class="code">AUTH_NO_SUCH_USER</code> and <code  class="code">AUTH_LOGINFAILED</code> should never be communicated to the user,
+for security reasons.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="AUTH_DISABLED"
+><code  class="code">AUTH_DISABLED</code></a></h2>
+
+<p>The user successfully logged in,
+but their account has been disabled.
+Usually this is throw only by <code  class="code">Bugzilla::Auth::login</code>.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="AUTH_LOCKOUT"
+><code  class="code">AUTH_LOCKOUT</code></a></h2>
+
+<p>The user&#39;s account is locked out after having failed to log in too many times within a certain period of time (as specified by <a href="../Bugzilla/Constants.html#LOGIN_LOCKOUT_INTERVAL" class="podlinkpod"
+>&#34;LOGIN_LOCKOUT_INTERVAL&#34; in Bugzilla::Constants</a>).</p>
+
+<p>The hashref will also contain a <code  class="code">user</code> element,
+representing the <a href="../Bugzilla/User.html" class="podlinkpod"
+>Bugzilla::User</a> whose account is locked out.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="LOGIN_TYPES"
+>LOGIN TYPES</a></h1>
+
+<p>The <code  class="code">login</code> function (below) can do different types of login,
+depending on what constant you pass into it:</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="LOGIN_OPTIONAL"
+><code  class="code">LOGIN_OPTIONAL</code></a></h2>
+
+<p>A login is never required to access this data.
+Attempting to login is still useful,
+because this allows the page to be personalised.
+Note that an incorrect login will still trigger an error,
+even though the lack of a login will be OK.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="LOGIN_NORMAL"
+><code  class="code">LOGIN_NORMAL</code></a></h2>
+
+<p>A login may or may not be required,
+depending on the setting of the <i>requirelogin</i> parameter.
+This is the default if you don&#39;t specify a type.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="LOGIN_REQUIRED"
+><code  class="code">LOGIN_REQUIRED</code></a></h2>
+
+<p>A login is always required to access this data.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<p>These are methods that can be called on a <code  class="code">Bugzilla::Auth</code> object itself.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Login"
+>Login</a></h2>
+
+<dl>
+<dt><a name="login($type)"
+><code  class="code">login($type)</code></a></dt>
+
+<dd>
+<p>Description: Logs a user in.
+For more details on how this works internally,
+see the section entitled &#34;STRUCTURE.&#34; Params: $type - One of the Login Types from above.
+Returns: An authenticated <code  class="code">Bugzilla::User</code>.
+Or,
+if the type was not <code  class="code">LOGIN_REQUIRED</code>,
+then we return an empty <code  class="code">Bugzilla::User</code> if no login data was passed in.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Info_Methods"
+>Info Methods</a></h2>
+
+<p>These are methods that give information about the Bugzilla::Auth object.</p>
+
+<dl>
+<dt><a name="can_change_password"
+><code  class="code">can_change_password</code></a></dt>
+
+<dd>
+<p>Description: Tells you whether or not the current login system allows changing passwords.
+Params: None Returns: <code  class="code">true</code> if users and administrators should be allowed to change passwords,
+<code  class="code">false</code> otherwise.</p>
+
+<dt><a name="can_login"
+><code  class="code">can_login</code></a></dt>
+
+<dd>
+<p>Description: Tells you whether or not the current login system allows users to log in through the web interface.
+Params: None Returns: <code  class="code">true</code> if users can log in through the web interface,
+<code  class="code">false</code> otherwise.</p>
+
+<dt><a name="can_logout"
+><code  class="code">can_logout</code></a></dt>
+
+<dd>
+<p>Description: Tells you whether or not the current login system allows users to log themselves out.
+Params: None Returns: <code  class="code">true</code> if users can log themselves out,
+<code  class="code">false</code> otherwise.
+If a user isn&#39;t logged in,
+we always return <code  class="code">false</code>.</p>
+
+<dt><a name="user_can_create_account"
+><code  class="code">user_can_create_account</code></a></dt>
+
+<dd>
+<p>Description: Tells you whether or not users are allowed to manually create their own accounts,
+based on the current login system in use.
+Note that this doesn&#39;t check the <code  class="code">createemailregexp</code> parameter--you have to do that by yourself in your code.
+Params: None Returns: <code  class="code">true</code> if users are allowed to create new Bugzilla accounts,
+<code  class="code">false</code> otherwise.</p>
+
+<dt><a name="extern_id_used"
+><code  class="code">extern_id_used</code></a></dt>
+
+<dd>
+<p>Description: Whether or not current login system uses extern_id.</p>
+
+<dt><a name="can_change_email"
+><code  class="code">can_change_email</code></a></dt>
+
+<dd>
+<p>Description: Whether or not the current login system allows users to change their own email address.
+Params: None Returns: <code  class="code">true</code> if users can change their own email address,
+<code  class="code">false</code> otherwise.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="STRUCTURE"
+>STRUCTURE</a></h1>
+
+<p>This section is mostly interesting to developers who want to implement a new authentication type.
+It describes the general structure of the Bugzilla::Auth family,
+and how the <code  class="code">login</code> function works.</p>
+
+<p>A <code  class="code">Bugzilla::Auth</code> object is essentially a collection of a few other objects: the &#34;Info Getter,&#34; the &#34;Verifier,&#34; and the &#34;Persistence Mechanism.&#34;</p>
+
+<p>They are used inside the <code  class="code">login</code> function in the following order:</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="The_Info_Getter"
+>The Info Getter</a></h2>
+
+<p>This is a <code  class="code">Bugzilla::Auth::Login</code> object.
+Basically,
+it gets the username and password from the user,
+somehow.
+Or,
+it just gets enough information to uniquely identify a user,
+and passes that on down the line.
+(For example,
+a <code  class="code">user_id</code> is enough to uniquely identify a user,
+even without a username and password.)</p>
+
+<p>Some Info Getters don&#39;t require any verification.
+For example,
+if we got the <code  class="code">user_id</code> from a Cookie,
+we don&#39;t need to check the username and password.</p>
+
+<p>If an Info Getter returns only a <code  class="code">user_id</code> and no username/password,
+then it MUST NOT require verification.
+If an Info Getter requires verfication,
+then it MUST return at least a <code  class="code">username</code>.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="The_Verifier"
+>The Verifier</a></h2>
+
+<p>This verifies that the username and password are valid.</p>
+
+<p>It&#39;s possible that some methods of verification don&#39;t require a password.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="The_Persistence_Mechanism"
+>The Persistence Mechanism</a></h2>
+
+<p>This makes it so that the user doesn&#39;t have to log in on every page.
+Normally this object just sends a cookie to the user&#39;s web browser,
+as that&#39;s the most common method of &#34;login persistence.&#34;</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Other_Things_We_Do"
+>Other Things We Do</a></h2>
+
+<p>After we verify the username and password,
+sometimes we automatically create an account in the Bugzilla database,
+for certain authentication types.
+We use the &#34;Account Source&#34; to get data about the user,
+and create them in the database.
+(Or,
+if their data has changed since the last time they logged in,
+their data gets updated.)</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="The_$login_data_Hash"
+>The <code  class="code">$login_data</code> Hash</a></h2>
+
+<p>All of the <code  class="code">Bugzilla::Auth::Login</code> and <code  class="code">Bugzilla::Auth::Verify</code> methods take an argument called <code  class="code">$login_data</code>.
+This is basically a hash that becomes more and more populated as we go through the <code  class="code">login</code> function.</p>
+
+<p>All <code  class="code">Bugzilla::Auth::Login</code> and <code  class="code">Bugzilla::Auth::Verify</code> methods also *return* the <code  class="code">$login_data</code> structure,
+when they succeed.
+They may have added new data to it.</p>
+
+<p>For all <code  class="code">Bugzilla::Auth::Login</code> and <code  class="code">Bugzilla::Auth::Verify</code> methods,
+the rule is &#34;you must return the same hashref you were passed in.&#34; You can modify the hashref all you want,
+but you can&#39;t create a new one.
+The only time you can return a new one is if you&#39;re returning some error code instead of the <code  class="code">$login_data</code> structure.</p>
+
+<p>Each <code  class="code">Bugzilla::Auth::Login</code> or <code  class="code">Bugzilla::Auth::Verify</code> method explains in its documentation which <code  class="code">$login_data</code> elements are required by it,
+and which are set by it.</p>
+
+<p>Here are all of the elements that *may* be in <code  class="code">$login_data</code>:</p>
+
+<dl>
+<dt><a name="user_id"
+><code  class="code">user_id</code></a></dt>
+
+<dd>
+<p>A Bugzilla <code  class="code">user_id</code> that uniquely identifies a user.</p>
+
+<dt><a name="username"
+><code  class="code">username</code></a></dt>
+
+<dd>
+<p>The username that was provided by the user.</p>
+
+<dt><a name="bz_username"
+><code  class="code">bz_username</code></a></dt>
+
+<dd>
+<p>The username of this user inside of Bugzilla.
+Sometimes this differs from <code  class="code">username</code>.</p>
+
+<dt><a name="password"
+><code  class="code">password</code></a></dt>
+
+<dd>
+<p>The password provided by the user.</p>
+
+<dt><a name="realname"
+><code  class="code">realname</code></a></dt>
+
+<dd>
+<p>The real name of the user.</p>
+
+<dt><a name="extern_id"
+><code  class="code">extern_id</code></a></dt>
+
+<dd>
+<p>Some string that uniquely identifies the user in an external account source.
+If this <code  class="code">extern_id</code> already exists in the database with a different username,
+the username will be *changed* to be the username specified in this <code  class="code">$login_data</code>.</p>
+
+<p>That is,
+let&#39;s my extern_id is <code  class="code">mkanat</code>.
+I already have an account in Bugzilla with the username of <code  class="code">mkanat@foo.com</code>.
+But this time,
+when I log in,
+I have an extern_id of <code  class="code">mkanat</code> and a <code  class="code">username</code> of <code  class="code">mkanat@bar.org</code>.
+So now,
+Bugzilla will automatically change my username to <code  class="code">mkanat@bar.org</code> instead of <code  class="code">mkanat@foo.com</code>.</p>
+
+<dt><a name="user"
+><code  class="code">user</code></a></dt>
+
+<dd>
+<p>A <a href="../Bugzilla/User.html" class="podlinkpod"
+>Bugzilla::User</a> object representing the authenticated user.
+Note that <code  class="code">Bugzilla::Auth::login</code> may modify this object at various points.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Auth/Login.html b/docs/en/html/api/Bugzilla/Auth/Login.html
new file mode 100644 (file)
index 0000000..a7ab411
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Auth/Login.html
@@ -0,0 +1,134 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Auth::Login</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Auth::Login</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#LOGIN_METHODS'>LOGIN METHODS</a>
+  <li class='indexItem indexItem1'><a href='#INFO_METHODS'>INFO METHODS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Auth::Login - Gets username/password data from the user.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Bugzilla::Auth::Login is used to get information that uniquely identifies a user and allows us to authorize their Bugzilla access.</p>
+
+<p>It is mostly an abstract class,
+requiring subclasses to implement most methods.</p>
+
+<p>Note that callers outside of the <code  class="code">Bugzilla::Auth</code> package should never create this object directly.
+Just create a <code  class="code">Bugzilla::Auth</code> object and call <code  class="code">login</code> on it.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="LOGIN_METHODS"
+>LOGIN METHODS</a></h1>
+
+<p>These are methods that have to do with getting the actual login data from the user or handling a login somehow.</p>
+
+<p>These methods are abstract -- they MUST be implemented by a subclass.</p>
+
+<dl>
+<dt><a name="get_login_info()"
+><code  class="code">get_login_info()</code></a></dt>
+
+<dd>
+<p>Description: Gets a username/password from the user,
+or some other information that uniquely identifies them.
+Params: None Returns: A <code  class="code">$login_data</code> hashref.
+(See <a href="../../Bugzilla/Auth.html" class="podlinkpod"
+>Bugzilla::Auth</a> for details.) The hashref MUST contain: <code  class="code">user_id</code> *or* <code  class="code">username</code> If this is a login method that requires verification,
+the hashref MUST contain <code  class="code">password</code>.
+The hashref MAY contain <code  class="code">realname</code> and <code  class="code">extern_id</code>.</p>
+
+<dt><a name="fail_nodata()"
+><code  class="code">fail_nodata()</code></a></dt>
+
+<dd>
+<p>Description: This function is called when Bugzilla doesn&#39;t get a username/password and the login type is <code  class="code">LOGIN_REQUIRED</code> (See <a href="../../Bugzilla/Auth.html" class="podlinkpod"
+>Bugzilla::Auth</a> for a description of <code  class="code">LOGIN_REQUIRED</code>).
+That is,
+this handles <code  class="code">AUTH_NODATA</code> in that situation.</p>
+
+<pre  class="code">             This function MUST stop CGI execution when it is complete.
+             That is, it must call C&#60;exit&#62; or C&#60;ThrowUserError&#62; or some
+             such thing.
+Params:      None
+Returns:     Never Returns.</pre>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="INFO_METHODS"
+>INFO METHODS</a></h1>
+
+<p>These are methods that describe the capabilities of this <code  class="code">Bugzilla::Auth::Login</code> object. These are all no-parameter methods that return either <code  class="code">true</code> or <code  class="code">false</code>.</p>
+
+<dl>
+<dt><a name="can_logout"
+><code  class="code">can_logout</code></a></dt>
+
+<dd>
+<p>Whether or not users can log out if they logged in using this object. Defaults to <code  class="code">true</code>.</p>
+
+<dt><a name="can_login"
+><code  class="code">can_login</code></a></dt>
+
+<dd>
+<p>Whether or not users can log in through the web interface using this object. Defaults to <code  class="code">true</code>.</p>
+
+<dt><a name="requires_persistence"
+><code  class="code">requires_persistence</code></a></dt>
+
+<dd>
+<p>Whether or not we should send the user a cookie if they logged in with this method. Defaults to <code  class="code">true</code>.</p>
+
+<dt><a name="requires_verification"
+><code  class="code">requires_verification</code></a></dt>
+
+<dd>
+<p>Whether or not we should check the username/password that we got from this login method. Defaults to <code  class="code">true</code>.</p>
+
+<dt><a name="user_can_create_account"
+><code  class="code">user_can_create_account</code></a></dt>
+
+<dd>
+<p>Whether or not users can create accounts, if this login method is currently being used by the system. Defaults to <code  class="code">false</code>.</p>
+
+<dt><a name="is_automatic"
+><code  class="code">is_automatic</code></a></dt>
+
+<dd>
+<p>True if this login method requires no interaction from the user within Bugzilla. (For example, <code  class="code">Env</code> auth is &#34;automatic&#34; because the webserver just passes us an environment variable on most page requests, and does not ask the user for authentication information directly in Bugzilla.) Defaults to <code  class="code">false</code>.</p>
+
+<dt><a name="extern_id_used"
+><code  class="code">extern_id_used</code></a></dt>
+
+<dd>
+<p>Whether or not this login method uses the extern_id field. If used, users with editusers permission will be be allowed to edit the extern_id for all users.</p>
+
+<p>The default value is <code  class="code">0</code>.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Auth/Verify.html b/docs/en/html/api/Bugzilla/Auth/Verify.html
new file mode 100644 (file)
index 0000000..27fcab8
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Auth/Verify.html
@@ -0,0 +1,152 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Auth::Verify</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Auth::Verify</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#VERIFICATION_METHODS'>VERIFICATION METHODS</a>
+  <li class='indexItem indexItem1'><a href='#MODIFICATION_METHODS'>MODIFICATION METHODS</a>
+  <li class='indexItem indexItem1'><a href='#INFO_METHODS'>INFO METHODS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Auth::Verify - An object that verifies usernames and passwords.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Bugzilla::Auth::Verify provides the &#34;Verifier&#34; part of the Bugzilla login process.
+(For details,
+see the &#34;STRUCTURE&#34; section of <a href="../../Bugzilla/Auth.html" class="podlinkpod"
+>Bugzilla::Auth</a>.)</p>
+
+<p>It is mostly an abstract class,
+requiring subclasses to implement most methods.</p>
+
+<p>Note that callers outside of the <code  class="code">Bugzilla::Auth</code> package should never create this object directly.
+Just create a <code  class="code">Bugzilla::Auth</code> object and call <code  class="code">login</code> on it.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="VERIFICATION_METHODS"
+>VERIFICATION METHODS</a></h1>
+
+<p>These are the methods that have to do with the actual verification.</p>
+
+<p>Subclasses MUST implement these methods.</p>
+
+<dl>
+<dt><a name="check_credentials($login_data)"
+><code  class="code">check_credentials($login_data)</code></a></dt>
+
+<dd>
+<p>Description: Checks whether or not a username is valid.
+Params: $login_data - A <code  class="code">$login_data</code> hashref,
+as described in <a href="../../Bugzilla/Auth.html" class="podlinkpod"
+>Bugzilla::Auth</a>.
+This <code  class="code">$login_data</code> hashref MUST contain <code  class="code">username</code>,
+and SHOULD also contain <code  class="code">password</code>.
+Returns: A <code  class="code">$login_data</code> hashref with <code  class="code">bz_username</code> set.
+This method may also set <code  class="code">realname</code>.
+It must avoid changing anything that is already set.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="MODIFICATION_METHODS"
+>MODIFICATION METHODS</a></h1>
+
+<p>These are methods that change data in the actual authentication backend.</p>
+
+<p>These methods are optional,
+they do not have to be implemented by subclasses.</p>
+
+<dl>
+<dt><a name="create_or_update_user($login_data)"
+><code  class="code">create_or_update_user($login_data)</code></a></dt>
+
+<dd>
+<p>Description: Automatically creates a user account in the database if it doesn&#39;t already exist,
+or updates the account data if <code  class="code">$login_data</code> contains newer information.</p>
+
+<p>Params: $login_data - A <code  class="code">$login_data</code> hashref,
+as described in <a href="../../Bugzilla/Auth.html" class="podlinkpod"
+>Bugzilla::Auth</a>.
+This <code  class="code">$login_data</code> hashref MUST contain either <code  class="code">user_id</code>,
+<code  class="code">bz_username</code>,
+or <code  class="code">username</code>.
+If both <code  class="code">username</code> and <code  class="code">bz_username</code> are specified,
+<code  class="code">bz_username</code> is used as the login name of the user to create in the database.
+It MAY also contain <code  class="code">extern_id</code>,
+in which case it still MUST contain <code  class="code">bz_username</code> or <code  class="code">username</code>.
+It MAY contain <code  class="code">password</code> and <code  class="code">realname</code>.</p>
+
+<p>Returns: A hashref with one element,
+<code  class="code">user</code>,
+which is a <a href="../../Bugzilla/User.html" class="podlinkpod"
+>Bugzilla::User</a> object.
+May also return a login error as described in <a href="../../Bugzilla/Auth.html" class="podlinkpod"
+>Bugzilla::Auth</a>.</p>
+
+<p>Note: This method is not abstract,
+it is actually implemented and creates accounts in the Bugzilla database.
+Subclasses should probably all call the <code  class="code">Bugzilla::Auth::Verify</code> version of this function at the end of their own <code  class="code">create_or_update_user</code>.</p>
+
+<dt><a name="change_password($user,_$password)"
+><code  class="code">change_password($user,
+$password)</code></a></dt>
+
+<dd>
+<p>Description: Modifies the user&#39;s password in the authentication backend.
+Params: $user - A <a href="../../Bugzilla/User.html" class="podlinkpod"
+>Bugzilla::User</a> object representing the user whose password we want to change.
+$password - The user&#39;s new password.
+Returns: Nothing.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="INFO_METHODS"
+>INFO METHODS</a></h1>
+
+<p>These are methods that describe the capabilities of this object.
+These are all no-parameter methods that return either <code  class="code">true</code> or <code  class="code">false</code>.</p>
+
+<dl>
+<dt><a name="user_can_create_account"
+><code  class="code">user_can_create_account</code></a></dt>
+
+<dd>
+<p>Whether or not users can manually create accounts in this type of account source.
+Defaults to <code  class="code">true</code>.</p>
+
+<dt><a name="extern_id_used"
+><code  class="code">extern_id_used</code></a></dt>
+
+<dd>
+<p>Whether or not this verifier method uses the extern_id field.
+If used,
+users with editusers permission will be be allowed to edit the extern_id for all users.</p>
+
+<p>The default value is <code  class="code">false</code>.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/CGI.html b/docs/en/html/api/Bugzilla/CGI.html
new file mode 100644 (file)
index 0000000..7371280
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/CGI.html
@@ -0,0 +1,119 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::CGI</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::CGI</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#CHANGES_FROM_CGI.PM'>CHANGES FROM CGI.PM</a>
+  <li class='indexItem indexItem1'><a href='#ADDITIONAL_FUNCTIONS'>ADDITIONAL FUNCTIONS</a>
+  <li class='indexItem indexItem1'><a href='#SEE_ALSO'>SEE ALSO</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::CGI - CGI handling for Bugzilla</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">  use Bugzilla::CGI;
+
+  my $cgi = new Bugzilla::CGI();</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This package inherits from the standard CGI module, to provide additional Bugzilla-specific functionality. In general, see <a href="../CGI.html" class="podlinkpod"
+>the CGI.pm docs</a> for documention.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CHANGES_FROM_CGI.PM"
+>CHANGES FROM <a href="../CGI.html" class="podlinkpod"
+>CGI.PM</a></a></h1>
+
+<p>Bugzilla::CGI has some differences from <a href="../CGI.html" class="podlinkpod"
+>CGI.pm</a>.</p>
+
+<dl>
+<dt><a name="cgi_error_is_automatically_checked"
+><code  class="code">cgi_error</code> is automatically checked</a></dt>
+
+<dd>
+<p>After creating the CGI object, <code  class="code">Bugzilla::CGI</code> automatically checks <i>cgi_error</i>, and throws a CodeError if a problem is detected.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="ADDITIONAL_FUNCTIONS"
+>ADDITIONAL FUNCTIONS</a></h1>
+
+<p><i>Bugzilla::CGI</i> also includes additional functions.</p>
+
+<dl>
+<dt><a name="canonicalise_query(@exclude)"
+><code  class="code">canonicalise_query(@exclude)</code></a></dt>
+
+<dd>
+<p>This returns a sorted string of the parameters, suitable for use in a url. Values in <code  class="code">@exclude</code> are not included in the result.</p>
+
+<dt><a name="send_cookie"
+><code  class="code">send_cookie</code></a></dt>
+
+<dd>
+<p>This routine is identical to the cookie generation part of CGI.pm&#39;s <code  class="code">cookie</code> routine, except that it knows about Bugzilla&#39;s cookie_path and cookie_domain parameters and takes them into account if necessary. This should be used by all Bugzilla code (instead of <code  class="code">cookie</code> or the <code  class="code">-cookie</code> argument to <code  class="code">header</code>), so that under mod_perl the headers can be sent correctly, using <code  class="code">print</code> or the mod_perl APIs as appropriate.</p>
+
+<p>To remove (expire) a cookie, use <code  class="code">remove_cookie</code>.</p>
+
+<dt><a name="remove_cookie"
+><code  class="code">remove_cookie</code></a></dt>
+
+<dd>
+<p>This is a wrapper around send_cookie, setting an expiry date in the past, effectively removing the cookie.</p>
+
+<p>As its only argument, it takes the name of the cookie to expire.</p>
+
+<dt><a name="redirect_to_https"
+><code  class="code">redirect_to_https</code></a></dt>
+
+<dd>
+<p>This routine redirects the client to the https version of the page that they&#39;re looking at, using the <code  class="code">sslbase</code> parameter for the redirection.</p>
+
+<p>Generally you should use <a href="../Bugzilla/Util.html#do_ssl_redirect_if_required" class="podlinkpod"
+>&#34;do_ssl_redirect_if_required&#34; in Bugzilla::Util</a> instead of calling this directly.</p>
+
+<dt><a name="redirect_to_urlbase"
+><code  class="code">redirect_to_urlbase</code></a></dt>
+
+<dd>
+<p>Redirects from the current URL to one prefixed by the urlbase parameter.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SEE_ALSO"
+>SEE ALSO</a></h1>
+
+<p><a href="../CGI.html" class="podlinkpod"
+>CGI</a>, <a href="../CGI/Cookie.html" class="podlinkpod"
+>CGI::Cookie</a></p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Classification.html b/docs/en/html/api/Bugzilla/Classification.html
new file mode 100644 (file)
index 0000000..663543a
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Classification.html
@@ -0,0 +1,108 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Classification</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Classification</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <li class='indexItem indexItem1'><a href='#SUBROUTINES'>SUBROUTINES</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Classification - Bugzilla classification class.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">    use Bugzilla::Classification;
+
+    my $classification = new Bugzilla::Classification(1);
+    my $classification = new Bugzilla::Classification({name =&#62; &#39;Acme&#39;});
+
+    my $id = $classification-&#62;id;
+    my $name = $classification-&#62;name;
+    my $description = $classification-&#62;description;
+    my $sortkey = $classification-&#62;sortkey;
+    my $product_count = $classification-&#62;product_count;
+    my $products = $classification-&#62;products;</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Classification.pm represents a classification object. It is an implementation of <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, and thus provides all methods that <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a> provides.</p>
+
+<p>The methods that are specific to <code  class="code">Bugzilla::Classification</code> are listed below.</p>
+
+<p>A Classification is a higher-level grouping of Products.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<dl>
+<dt><a name="product_count()"
+><code  class="code">product_count()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns the total number of products that belong to
+              the classification.
+
+ Params:      none.
+
+ Returns:     Integer - The total of products inside the classification.</pre>
+
+<dt><a name="products"
+><code  class="code">products</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns all products of the classification.
+
+ Params:      none.
+
+ Returns:     A reference to an array of Bugzilla::Product objects.</pre>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SUBROUTINES"
+>SUBROUTINES</a></h1>
+
+<dl>
+<dt><a name="sort_products_by_classification"
+><code  class="code">sort_products_by_classification</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: This is a helper which returns a list of products sorted
+              by classification in a form suitable to be passed to the
+              global/choose-product.html.tmpl template.
+
+ Params:      An arrayref of product objects.
+
+ Returns:     An arrayref of hashes suitable to be passed to
+              global/choose-product.html.tmpl.</pre>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Comment.html b/docs/en/html/api/Bugzilla/Comment.html
new file mode 100644 (file)
index 0000000..51c289e
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Comment.html
@@ -0,0 +1,145 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Comment</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Comment</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Accessors'>Accessors</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Comment - A Comment for a given bug</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> use Bugzilla::Comment;
+
+ my $comment = Bugzilla::Comment-&#62;new($comment_id);
+ my $comments = Bugzilla::Comment-&#62;new_from_list($comment_ids);</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Bugzilla::Comment represents a comment attached to a bug.</p>
+
+<p>This implements all standard <code  class="code">Bugzilla::Object</code> methods. See <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a> for more details.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Accessors"
+>Accessors</a></h2>
+
+<dl>
+<dt><a name="bug_id"
+><code  class="code">bug_id</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The ID of the bug to which the comment belongs.</p>
+
+<dt><a name="creation_ts"
+><code  class="code">creation_ts</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The comment creation timestamp.</p>
+
+<dt><a name="body"
+><code  class="code">body</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The body without any special additional text.</p>
+
+<dt><a name="work_time"
+><code  class="code">work_time</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> Time spent as related to this comment.</p>
+
+<dt><a name="is_private"
+><code  class="code">is_private</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> Comment is marked as private</p>
+
+<dt><a name="already_wrapped"
+><code  class="code">already_wrapped</code></a></dt>
+
+<dd>
+<p>If this comment is stored in the database word-wrapped, this will be <code  class="code">1</code>. <code  class="code">0</code> otherwise.</p>
+
+<dt><a name="author"
+><code  class="code">author</code></a></dt>
+
+<dd>
+<p><a href="../Bugzilla/User.html" class="podlinkpod"
+>Bugzilla::User</a> who created the comment.</p>
+
+<dt><a name="count"
+><code  class="code">count</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The position this comment is located in the full list of comments for a bug starting from 0.</p>
+
+<dt><a name="body_full"
+><code  class="code">body_full</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p><code  class="code">string</code> Body of the comment, including any special text (such as &#34;this bug was marked as a duplicate of...&#34;).</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="is_bugmail"
+><code  class="code">is_bugmail</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code>. <code  class="code">1</code> if this comment should be formatted specifically for bugmail.</p>
+
+<dt><a name="wrap"
+><code  class="code">wrap</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code>. <code  class="code">1</code> if the comment should be returned word-wrapped.</p>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A string, the full text of the comment as it would be displayed to an end-user.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Component.html b/docs/en/html/api/Bugzilla/Component.html
new file mode 100644 (file)
index 0000000..46f9118
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Component.html
@@ -0,0 +1,284 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Component</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Component</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <li class='indexItem indexItem1'><a href='#CLASS_METHODS'>CLASS METHODS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Component - Bugzilla product component class.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">    use Bugzilla::Component;
+
+    my $component = new Bugzilla::Component($comp_id);
+    my $component = new Bugzilla::Component({ product =&#62; $product, name =&#62; $name });
+
+    my $bug_count          = $component-&#62;bug_count();
+    my $bug_ids            = $component-&#62;bug_ids();
+    my $id                 = $component-&#62;id;
+    my $name               = $component-&#62;name;
+    my $description        = $component-&#62;description;
+    my $product_id         = $component-&#62;product_id;
+    my $default_assignee   = $component-&#62;default_assignee;
+    my $default_qa_contact = $component-&#62;default_qa_contact;
+    my $initial_cc         = $component-&#62;initial_cc;
+    my $product            = $component-&#62;product;
+    my $bug_flag_types     = $component-&#62;flag_types-&#62;{&#39;bug&#39;};
+    my $attach_flag_types  = $component-&#62;flag_types-&#62;{&#39;attachment&#39;};
+
+    my $component = Bugzilla::Component-&#62;check({ product =&#62; $product, name =&#62; $name });
+
+    my $component =
+      Bugzilla::Component-&#62;create({ name             =&#62; $name,
+                                    product          =&#62; $product,
+                                    initialowner     =&#62; $user_login1,
+                                    initialqacontact =&#62; $user_login2,
+                                    description      =&#62; $description});
+
+    $component-&#62;set_name($new_name);
+    $component-&#62;set_description($new_description);
+    $component-&#62;set_default_assignee($new_login_name);
+    $component-&#62;set_default_qa_contact($new_login_name);
+    $component-&#62;set_cc_list(\@new_login_names);
+    $component-&#62;update();
+
+    $component-&#62;remove_from_db;</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Component.pm represents a Product Component object.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<dl>
+<dt><a name="new($param)"
+><code  class="code">new($param)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: The constructor is used to load an existing component
+              by passing a component ID or a hash with the product
+              object the component belongs to and the component name.
+
+ Params:      $param - If you pass an integer, the integer is the
+                       component ID from the database that we want to
+                       read in. 
+                       However, If you pass in a hash, it must contain
+                       two keys:
+                       name (string): the name of the component
+                       product (object): an object of Bugzilla::Product
+                       representing the product that the component belongs to.
+
+ Returns:     A Bugzilla::Component object.</pre>
+
+<dt><a name="bug_count()"
+><code  class="code">bug_count()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns the total of bugs that belong to the component.
+
+ Params:      none.
+
+ Returns:     Integer with the number of bugs.</pre>
+
+<dt><a name="bugs_ids()"
+><code  class="code">bugs_ids()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns all bug IDs that belong to the component.
+
+ Params:      none.
+
+ Returns:     A reference to an array of bug IDs.</pre>
+
+<dt><a name="default_assignee()"
+><code  class="code">default_assignee()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns a user object that represents the default assignee for
+              the component.
+
+ Params:      none.
+
+ Returns:     A Bugzilla::User object.</pre>
+
+<dt><a name="default_qa_contact()"
+><code  class="code">default_qa_contact()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns a user object that represents the default QA contact for
+              the component.
+
+ Params:      none.
+
+ Returns:     A Bugzilla::User object if the default QA contact is defined for
+              the component. Otherwise, returns undef.</pre>
+
+<dt><a name="initial_cc"
+><code  class="code">initial_cc</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns a list of user objects representing users being
+              in the initial CC list.
+
+ Params:      none.
+
+ Returns:     An arrayref of L&#60;Bugzilla::User&#62; objects.</pre>
+
+<dt><a name="flag_types()"
+><code  class="code">flag_types()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns all bug and attachment flagtypes available for
+              the component.
+
+ Params:      none.
+
+ Returns:     Two references to an array of flagtype objects.</pre>
+
+<dt><a name="product()"
+><code  class="code">product()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns the product the component belongs to.
+
+ Params:      none.
+
+ Returns:     A Bugzilla::Product object.</pre>
+
+<dt><a name="set_name($new_name)"
+><code  class="code">set_name($new_name)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Changes the name of the component.
+
+ Params:      $new_name - new name of the component (string). This name
+                          must be unique within the product.
+
+ Returns:     Nothing.</pre>
+
+<dt><a name="set_description($new_desc)"
+><code  class="code">set_description($new_desc)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Changes the description of the component.
+
+ Params:      $new_desc - new description of the component (string).
+
+ Returns:     Nothing.</pre>
+
+<dt><a name="set_default_assignee($new_assignee)"
+><code  class="code">set_default_assignee($new_assignee)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Changes the default assignee of the component.
+
+ Params:      $new_owner - login name of the new default assignee of
+                           the component (string). This user account
+                           must already exist.
+
+ Returns:     Nothing.</pre>
+
+<dt><a name="set_default_qa_contact($new_qa_contact)"
+><code  class="code">set_default_qa_contact($new_qa_contact)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Changes the default QA contact of the component.
+
+ Params:      $new_qa_contact - login name of the new QA contact of
+                                the component (string). This user
+                                account must already exist.
+
+ Returns:     Nothing.</pre>
+
+<dt><a name="set_cc_list(\@cc_list)"
+><code  class="code">set_cc_list(\@cc_list)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Changes the list of users being in the CC list by default.
+
+ Params:      \@cc_list - list of login names (string). All the user
+                          accounts must already exist.
+
+ Returns:     Nothing.</pre>
+
+<dt><a name="update()"
+><code  class="code">update()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Write changes made to the component into the DB.
+
+ Params:      none.
+
+ Returns:     A hashref with changes made to the component object.</pre>
+
+<dt><a name="remove_from_db()"
+><code  class="code">remove_from_db()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Deletes the current component from the DB. The object itself
+              is not destroyed.
+
+ Params:      none.
+
+ Returns:     Nothing.</pre>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CLASS_METHODS"
+>CLASS METHODS</a></h1>
+
+<dl>
+<dt><a name="create(\%params)"
+><code  class="code">create(\%params)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Create a new component for the given product.
+
+ Params:      The hashref must have the following keys:
+              name             - name of the new component (string). This name
+                                 must be unique within the product.
+              product          - a Bugzilla::Product object to which
+                                 the Component is being added.
+              description      - description of the new component (string).
+              initialowner     - login name of the default assignee (string).
+              The following keys are optional:
+              initialqacontact - login name of the default QA contact (string),
+                                 or an empty string to clear it.
+              initial_cc       - an arrayref of login names to add to the
+                                 CC list by default.
+
+ Returns:     A Bugzilla::Component object.</pre>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Config.html b/docs/en/html/api/Bugzilla/Config.html
new file mode 100644 (file)
index 0000000..0314b91
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Config.html
@@ -0,0 +1,100 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Config</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Config</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#FUNCTIONS'>FUNCTIONS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Parameters'>Parameters</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Config - Configuration parameters for Bugzilla</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">  # Administration functions
+  use Bugzilla::Config qw(:admin);
+
+  update_params();
+  SetParam($param, $value);
+  write_params();</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This package contains ways to access Bugzilla configuration parameters.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="FUNCTIONS"
+>FUNCTIONS</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Parameters"
+>Parameters</a></h2>
+
+<p>Parameters can be set, retrieved, and updated.</p>
+
+<dl>
+<dt><a name="SetParam($name,_$value)"
+><code  class="code">SetParam($name, $value)</code></a></dt>
+
+<dd>
+<p>Sets the param named $name to $value. Values are checked using the checker function for the given param if one exists.</p>
+
+<dt><a name="update_params()"
+><code  class="code">update_params()</code></a></dt>
+
+<dd>
+<p>Updates the parameters, by transitioning old params to new formats, setting defaults for new params, and removing obsolete ones. Used by <em  class="code">checksetup.pl</em> in the process of an installation or upgrade.</p>
+
+<p>Prints out information about what it&#39;s doing, if it makes any changes.</p>
+
+<p>May prompt the user for input, if certain required parameters are not specified.</p>
+
+<dt><a name="write_params($params)"
+><code  class="code">write_params($params)</code></a></dt>
+
+<dd>
+<p>Description: Writes the parameters to disk.</p>
+
+<p>Params: <code  class="code">$params</code> (optional) - A hashref to write to the disk instead of <code  class="code">Bugzilla-</code>params&#62;. Used only by <code  class="code">update_params</code>.</p>
+
+<p>Returns: nothing</p>
+
+<dt><a name="read_param_file()"
+><code  class="code">read_param_file()</code></a></dt>
+
+<dd>
+<p>Description: Most callers should never need this. This is used by <code  class="code">Bugzilla-</code>params&#62; to directly read <code  class="code">$datadir/params</code> and load it into memory. Use <code  class="code">Bugzilla-</code>params&#62; instead.</p>
+
+<p>Params: none</p>
+
+<p>Returns: A hashref containing the current params in <code  class="code">$datadir/params</code>.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Config/Common.html b/docs/en/html/api/Bugzilla/Config/Common.html
new file mode 100644 (file)
index 0000000..243299e
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Config/Common.html
@@ -0,0 +1,66 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Config::Common</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Config::Common</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Functions'>Functions</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Config::Common - Parameter checking functions</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>All parameter checking functions are called with two parameters: the value to check,
+and a hash with the details of the param (type,
+default etc.) as defined in the relevant <em  class="code">Bugzilla::Config::*</em> package.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Functions"
+>Functions</a></h2>
+
+<dl>
+<dt><a name="check_multi"
+><code  class="code">check_multi</code></a></dt>
+
+<dd>
+<p>Checks that a multi-valued parameter (ie types <code  class="code">s</code>,
+<code  class="code">o</code> or <code  class="code">m</code>) satisfies its contraints.</p>
+
+<dt><a name="check_numeric"
+><code  class="code">check_numeric</code></a></dt>
+
+<dd>
+<p>Checks that the value is a valid number</p>
+
+<dt><a name="check_regexp"
+><code  class="code">check_regexp</code></a></dt>
+
+<dd>
+<p>Checks that the value is a valid regexp</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/DB.html b/docs/en/html/api/Bugzilla/DB.html
new file mode 100644 (file)
index 0000000..633fb89
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/DB.html
@@ -0,0 +1,1444 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::DB</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::DB</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#CONSTANTS'>CONSTANTS</a>
+  <li class='indexItem indexItem1'><a href='#CONNECTION'>CONNECTION</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Functions'>Functions</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#ABSTRACT_METHODS'>ABSTRACT METHODS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Constructor'>Constructor</a>
+    <li class='indexItem indexItem2'><a href='#SQL_Generation'>SQL Generation</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#IMPLEMENTED_METHODS'>IMPLEMENTED METHODS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#General_Information_Methods'>General Information Methods</a>
+    <li class='indexItem indexItem2'><a href='#Database_Setup_Methods'>Database Setup Methods</a>
+    <li class='indexItem indexItem2'><a href='#Schema_Modification_Methods'>Schema Modification Methods</a>
+    <li class='indexItem indexItem2'><a href='#Schema_Information_Methods'>Schema Information Methods</a>
+    <li class='indexItem indexItem2'><a href='#Transaction_Methods'>Transaction Methods</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#SUBCLASS_HELPERS'>SUBCLASS HELPERS</a>
+  <li class='indexItem indexItem1'><a href='#SEE_ALSO'>SEE ALSO</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::DB - Database access routines,
+using <a href="../DBI.html" class="podlinkpod"
+>DBI</a></p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">  # Obtain db handle
+  use Bugzilla::DB;
+  my $dbh = Bugzilla-&#62;dbh;
+
+  # prepare a query using DB methods
+  my $sth = $dbh-&#62;prepare(&#34;SELECT &#34; .
+                          $dbh-&#62;sql_date_format(&#34;creation_ts&#34;, &#34;%Y%m%d&#34;) .
+                          &#34; FROM bugs WHERE bug_status != &#39;RESOLVED&#39; &#34; .
+                          $dbh-&#62;sql_limit(1));
+
+  # Execute the query
+  $sth-&#62;execute;
+
+  # Get the results
+  my @result = $sth-&#62;fetchrow_array;
+
+  # Schema Modification
+  $dbh-&#62;bz_add_column($table, $name, \%definition, $init_value);
+  $dbh-&#62;bz_add_index($table, $name, $definition);
+  $dbh-&#62;bz_add_table($name);
+  $dbh-&#62;bz_drop_index($table, $name);
+  $dbh-&#62;bz_drop_table($name);
+  $dbh-&#62;bz_alter_column($table, $name, \%new_def, $set_nulls_to);
+  $dbh-&#62;bz_drop_column($table, $column);
+  $dbh-&#62;bz_rename_column($table, $old_name, $new_name);
+
+  # Schema Information
+  my $column = $dbh-&#62;bz_column_info($table, $column);
+  my $index  = $dbh-&#62;bz_index_info($table, $index);</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Functions in this module allows creation of a database handle to connect to the Bugzilla database. This should never be done directly; all users should use the <a href="../Bugzilla.html" class="podlinkpod"
+>Bugzilla</a> module to access the current <code  class="code">dbh</code> instead.</p>
+
+<p>This module also contains methods extending the returned handle with functionality which is different between databases allowing for easy customization for particular database via inheritance. These methods should be always preffered over hard-coding SQL commands.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CONSTANTS"
+>CONSTANTS</a></h1>
+
+<p>Subclasses of Bugzilla::DB are required to define certain constants. These constants are required to be subroutines or &#34;use constant&#34; variables.</p>
+
+<dl>
+<dt><a name="BLOB_TYPE"
+><code  class="code">BLOB_TYPE</code></a></dt>
+
+<dd>
+<p>The <code  class="code">\%attr</code> argument that must be passed to bind_param in order to correctly escape a <code  class="code">LONGBLOB</code> type.</p>
+
+<dt><a name="ISOLATION_LEVEL"
+><code  class="code">ISOLATION_LEVEL</code></a></dt>
+
+<dd>
+<p>The argument that this database should send to <code  class="code">SET TRANSACTION ISOLATION LEVEL</code> when starting a transaction. If you override this in a subclass, the isolation level you choose should be as strict as or more strict than the default isolation level defined in <a href="../Bugzilla/DB.html" class="podlinkpod"
+>Bugzilla::DB</a>.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CONNECTION"
+>CONNECTION</a></h1>
+
+<p>A new database handle to the required database can be created using this module. This is normally done by the <a href="../Bugzilla.html" class="podlinkpod"
+>Bugzilla</a> module, and so these routines should not be called from anywhere else.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Functions"
+>Functions</a></h2>
+
+<dl>
+<dt><a name="connect_main"
+><code  class="code">connect_main</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Function to connect to the main database, returning a new database handle.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a 
+><code  class="code">$no_db_name</code> (optional) - If true, connect to the database server, but don&#39;t connect to a specific database. This is only used when creating a database. After you create the database, you should re-create a new Bugzilla::DB object without using this parameter.</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>New instance of the DB class</p>
+</dd>
+</dl>
+
+<dt><a name="connect_shadow"
+><code  class="code">connect_shadow</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Function to connect to the shadow database, returning a new database handle. This routine <code  class="code">die</code>s if no shadow database is configured.</p>
+
+<dt><a name="Params_(none)"
+><b>Params</b> (none)</a></dt>
+
+<dd>
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A new instance of the DB class</p>
+</dd>
+</dl>
+
+<dt><a name="bz_check_requirements"
+><code  class="code">bz_check_requirements</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Checks to make sure that you have the correct DBD and database version installed for the database that Bugzilla will be using. Prints a message and exits if you don&#39;t pass the requirements.</p>
+
+<p>If <code  class="code">$db_check</code> is false (from <em  class="code">localconfig</em>), we won&#39;t check the database version.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$output_-_true_if_the_function_should_display_informational_output_about_what_it&#39;s_doing,_such_as_versions_found."
+><code  class="code">$output</code> - <code  class="code">true</code> if the function should display informational output about what it&#39;s doing, such as versions found.</a></dt>
+</dl>
+
+<dt><a name="Returns_(nothing)"
+><b>Returns</b> (nothing)</a></dt>
+</dl>
+
+<dt><a name="bz_create_database"
+><code  class="code">bz_create_database</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Creates an empty database with the name <code  class="code">$db_name</code>, if that database doesn&#39;t already exist. Prints an error message and exits if we can&#39;t create the database.</p>
+
+<dt><a name="Params_(none)"
+><b>Params</b> (none)</a></dt>
+
+<dd>
+<dt><a name="Returns_(nothing)"
+><b>Returns</b> (nothing)</a></dt>
+</dl>
+
+<dt><a name="_connect"
+><code  class="code">_connect</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Internal function, creates and returns a new, connected instance of the correct DB class. This routine <code  class="code">die</code>s if no driver is specified.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$driver_-_name_of_the_database_driver_to_use"
+><code  class="code">$driver</code> - name of the database driver to use</a></dt>
+
+<dd>
+<dt><a name="$host_-_host_running_the_database_we_are_connecting_to"
+><code  class="code">$host</code> - host running the database we are connecting to</a></dt>
+
+<dd>
+<dt><a name="$dbname_-_name_of_the_database_to_connect_to"
+><code  class="code">$dbname</code> - name of the database to connect to</a></dt>
+
+<dd>
+<dt><a name="$port_-_port_the_database_is_listening_on"
+><code  class="code">$port</code> - port the database is listening on</a></dt>
+
+<dd>
+<dt><a name="$sock_-_socket_the_database_is_listening_on"
+><code  class="code">$sock</code> - socket the database is listening on</a></dt>
+
+<dd>
+<dt><a name="$user_-_username_used_to_log_in_to_the_database"
+><code  class="code">$user</code> - username used to log in to the database</a></dt>
+
+<dd>
+<dt><a name="$pass_-_password_used_to_log_in_to_the_database"
+><code  class="code">$pass</code> - password used to log in to the database</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A new instance of the DB class</p>
+</dd>
+</dl>
+
+<dt><a name="_handle_error"
+><code  class="code">_handle_error</code></a></dt>
+
+<dd>
+<p>Function passed to the DBI::connect call for error handling. It shortens the error for printing.</p>
+
+<dt><a name="import"
+><code  class="code">import</code></a></dt>
+
+<dd>
+<p>Overrides the standard import method to check that derived class implements all required abstract methods. Also calls original implementation in its super class.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="ABSTRACT_METHODS"
+>ABSTRACT METHODS</a></h1>
+
+<p>Note: Methods which can be implemented generically for all DBs are implemented in this module. If needed, they can be overridden with DB specific code. Methods which do not have standard implementation are abstract and must be implemented for all supported databases separately. To avoid confusion with standard DBI methods, all methods returning string with formatted SQL command have prefix <code  class="code">sql_</code>. All other methods have prefix <code  class="code">bz_</code>.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Constructor"
+>Constructor</a></h2>
+
+<dl>
+<dt><a name="new"
+><code  class="code">new</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Constructor. Abstract method, should be overridden by database specific code.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$user_-_username_used_to_log_in_to_the_database"
+><code  class="code">$user</code> - username used to log in to the database</a></dt>
+
+<dd>
+<dt><a name="$pass_-_password_used_to_log_in_to_the_database"
+><code  class="code">$pass</code> - password used to log in to the database</a></dt>
+
+<dd>
+<dt><a name="$host_-_host_running_the_database_we_are_connecting_to"
+><code  class="code">$host</code> - host running the database we are connecting to</a></dt>
+
+<dd>
+<dt><a name="$dbname_-_name_of_the_database_to_connect_to"
+><code  class="code">$dbname</code> - name of the database to connect to</a></dt>
+
+<dd>
+<dt><a name="$port_-_port_the_database_is_listening_on"
+><code  class="code">$port</code> - port the database is listening on</a></dt>
+
+<dd>
+<dt><a name="$sock_-_socket_the_database_is_listening_on"
+><code  class="code">$sock</code> - socket the database is listening on</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A new instance of the DB class</p>
+
+<dt><a name="Note"
+><b>Note</b></a></dt>
+
+<dd>
+<p>The constructor should create a DSN from the parameters provided and then call <code  class="code">db_new()</code> method of its super class to create a new class instance. See <a href="../db_new.html" class="podlinkpod"
+>db_new</a> description in this module. As per DBI documentation, all class variables must be prefixed with &#34;private_&#34;. See <a href="../DBI.html" class="podlinkpod"
+>DBI</a>.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="SQL_Generation"
+>SQL Generation</a></h2>
+
+<dl>
+<dt><a name="sql_regexp"
+><code  class="code">sql_regexp</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Outputs SQL regular expression operator for POSIX regex searches (case insensitive) in format suitable for a given database.</p>
+
+<p>Abstract method, should be overridden by database specific code.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$expr_-_SQL_expression_for_the_text_to_be_searched_(scalar)"
+><code  class="code">$expr</code> - SQL expression for the text to be searched (scalar)</a></dt>
+
+<dd>
+<dt><a name="$pattern_-_the_regular_expression_to_search_for_(scalar)"
+><code  class="code">$pattern</code> - the regular expression to search for (scalar)</a></dt>
+
+<dd>
+<dt><a name="$nocheck_-_true_if_the_pattern_should_not_be_tested;_false_otherwise_(boolean)"
+><code  class="code">$nocheck</code> - true if the pattern should not be tested; false otherwise (boolean)</a></dt>
+
+<dd>
+<dt><a name="$real_pattern_-_the_real_regular_expression_to_search_for._This_argument_is_used_when_$pattern_is_a_placeholder_(&#39;?&#39;)."
+><code  class="code">$real_pattern</code> - the real regular expression to search for. This argument is used when <code  class="code">$pattern</code> is a placeholder (&#39;?&#39;).</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>Formatted SQL for regular expression search (e.g. REGEXP) (scalar)</p>
+</dd>
+</dl>
+
+<dt><a name="sql_not_regexp"
+><code  class="code">sql_not_regexp</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Outputs SQL regular expression operator for negative POSIX regex searches (case insensitive) in format suitable for a given database.</p>
+
+<p>Abstract method, should be overridden by database specific code.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p>Same as <a href="#sql_regexp" class="podlinkpod"
+>&#34;sql_regexp&#34;</a>.</p>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>Formatted SQL for negative regular expression search (e.g. NOT REGEXP) (scalar)</p>
+</dd>
+</dl>
+
+<dt><a name="sql_limit"
+><code  class="code">sql_limit</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Returns SQL syntax for limiting results to some number of rows with optional offset if not starting from the begining.</p>
+
+<p>Abstract method, should be overridden by database specific code.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$limit_-_number_of_rows_to_return_from_query_(scalar)"
+><code  class="code">$limit</code> - number of rows to return from query (scalar)</a></dt>
+
+<dd>
+<dt><a name="$offset_-_number_of_rows_to_skip_before_counting_(scalar)"
+><code  class="code">$offset</code> - number of rows to skip before counting (scalar)</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>Formatted SQL for limiting number of rows returned from query with optional offset (e.g. LIMIT 1, 1) (scalar)</p>
+</dd>
+</dl>
+
+<dt><a name="sql_from_days"
+><code  class="code">sql_from_days</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Outputs SQL syntax for converting Julian days to date.</p>
+
+<p>Abstract method, should be overridden by database specific code.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$days_-_days_to_convert_to_date"
+><code  class="code">$days</code> - days to convert to date</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>Formatted SQL for returning Julian days in dates. (scalar)</p>
+</dd>
+</dl>
+
+<dt><a name="sql_to_days"
+><code  class="code">sql_to_days</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Outputs SQL syntax for converting date to Julian days.</p>
+
+<p>Abstract method, should be overridden by database specific code.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$date_-_date_to_convert_to_days"
+><code  class="code">$date</code> - date to convert to days</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>Formatted SQL for returning date fields in Julian days. (scalar)</p>
+</dd>
+</dl>
+
+<dt><a name="sql_date_format"
+><code  class="code">sql_date_format</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Outputs SQL syntax for formatting dates.</p>
+
+<p>Abstract method, should be overridden by database specific code.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$date_-_date_or_name_of_date_type_column_(scalar)"
+><code  class="code">$date</code> - date or name of date type column (scalar)</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">$format</code> - format string for date output (scalar) (<code  class="code">%Y</code> = year, four digits, <code  class="code">%y</code> = year, two digits, <code  class="code">%m</code> = month, <code  class="code">%d</code> = day, <code  class="code">%a</code> = weekday name, 3 letters, <code  class="code">%H</code> = hour 00-23, <code  class="code">%i</code> = minute, <code  class="code">%s</code> = second)</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>Formatted SQL for date formatting (scalar)</p>
+</dd>
+</dl>
+
+<dt><a name="sql_date_math"
+><code  class="code">sql_date_math</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Outputs proper SQL syntax for adding some amount of time to a date.</p>
+
+<p>Abstract method, should be overridden by database specific code.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$date"
+><code  class="code">$date</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The date being added to or subtracted from.</p>
+
+<dt><a name="$operator"
+><code  class="code">$operator</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> Either <code  class="code">-</code> or <code  class="code">+</code>, depending on whether you&#39;re subtracting or adding.</p>
+
+<dt><a name="$interval"
+><code  class="code">$interval</code></a></dt>
+
+<dd>
+<p><code  class="code">integer</code> The time interval you&#39;re adding or subtracting (e.g. <code  class="code">30</code>)</p>
+
+<dt><a name="$units"
+><code  class="code">$units</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> the units the interval is in (e.g. &#39;MINUTE&#39;)</p>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>Formatted SQL for adding or subtracting a date and some amount of time (scalar)</p>
+</dd>
+</dl>
+
+<dt><a name="sql_position"
+><code  class="code">sql_position</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Outputs proper SQL syntax determining position of a substring (fragment) withing a string (text). Note: if the substring or text are string constants, they must be properly quoted (e.g. &#34;&#39;pattern&#39;&#34;).</p>
+
+<p>It searches for the string in a case-sensitive manner. If you want to do a case-insensitive search, use <a href="#sql_iposition" class="podlinkpod"
+>&#34;sql_iposition&#34;</a>.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$fragment_-_the_string_fragment_we_are_searching_for_(scalar)"
+><code  class="code">$fragment</code> - the string fragment we are searching for (scalar)</a></dt>
+
+<dd>
+<dt><a name="$text_-_the_text_to_search_(scalar)"
+><code  class="code">$text</code> - the text to search (scalar)</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>Formatted SQL for substring search (scalar)</p>
+</dd>
+</dl>
+
+<dt><a name="sql_iposition"
+><code  class="code">sql_iposition</code></a></dt>
+
+<dd>
+<p>Just like <a href="#sql_position" class="podlinkpod"
+>&#34;sql_position&#34;</a>, but case-insensitive.</p>
+
+<dt><a name="sql_group_by"
+><code  class="code">sql_group_by</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Outputs proper SQL syntax for grouping the result of a query.</p>
+
+<p>For ANSI SQL databases, we need to group by all columns we are querying for (except for columns used in aggregate functions). Some databases require (or even allow) to specify only one or few columns if the result is uniquely defined. For those databases, the default implementation needs to be overloaded.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$needed_columns_-_string_with_comma_separated_list_of_columns_we_need_to_group_by_to_get_expected_result_(scalar)"
+><code  class="code">$needed_columns</code> - string with comma separated list of columns we need to group by to get expected result (scalar)</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">$optional_columns</code> - string with comma separated list of all other columns we are querying for, but which are not in the required list.</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>Formatted SQL for row grouping (scalar)</p>
+</dd>
+</dl>
+
+<dt><a name="sql_string_concat"
+><code  class="code">sql_string_concat</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Returns SQL syntax for concatenating multiple strings (constants or values from table columns) together.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="@params_-_array_of_column_names_or_strings_to_concatenate"
+><code  class="code">@params</code> - array of column names or strings to concatenate</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>Formatted SQL for concatenating specified strings</p>
+</dd>
+</dl>
+
+<dt><a name="sql_string_until"
+><code  class="code">sql_string_until</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Returns SQL for truncating a string at the first occurrence of a certain substring.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p>Note that both parameters need to be sql-quoted.</p>
+
+<dt><a name="$string_The_string_we&#39;re_truncating"
+><code  class="code">$string</code> The string we&#39;re truncating</a></dt>
+
+<dd>
+<dt><a name="$substring_The_substring_we&#39;re_truncating_at."
+><code  class="code">$substring</code> The substring we&#39;re truncating at.</a></dt>
+</dl>
+
+<dt><a name="sql_fulltext_search"
+><code  class="code">sql_fulltext_search</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Returns one or two SQL expressions for performing a full text search for specified text on a given column.</p>
+
+<p>If one value is returned, it is a numeric expression that indicates a match with a positive value and a non-match with zero. In this case, the DB must support casting numeric expresions to booleans.</p>
+
+<p>If two values are returned, then the first value is a boolean expression that indicates the presence of a match, and the second value is a numeric expression that can be used for ranking.</p>
+
+<p>There is a ANSI SQL version of this method implemented using LIKE operator, but it&#39;s not a real full text search. DB specific modules should override this, as this generic implementation will be always much slower. This generic implementation returns &#39;relevance&#39; as 0 for no match, or 1 for a match.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$column_-_name_of_column_to_search_(scalar)"
+><code  class="code">$column</code> - name of column to search (scalar)</a></dt>
+
+<dd>
+<dt><a name="$text_-_text_to_search_for_(scalar)"
+><code  class="code">$text</code> - text to search for (scalar)</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>Formatted SQL for full text search</p>
+</dd>
+</dl>
+
+<dt><a name="sql_istrcmp"
+><code  class="code">sql_istrcmp</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Returns SQL for a case-insensitive string comparison.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$left_-_What_should_be_on_the_left-hand-side_of_the_operation."
+><code  class="code">$left</code> - What should be on the left-hand-side of the operation.</a></dt>
+
+<dd>
+<dt><a name="$right_-_What_should_be_on_the_right-hand-side_of_the_operation."
+><code  class="code">$right</code> - What should be on the right-hand-side of the operation.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">$op</code> (optional) - What the operation is. Should be a valid ANSI SQL comparison operator, such as <code  class="code">=</code>, <code  class="code">&#60;</code>, <code  class="code">LIKE</code>, etc. Defaults to <code  class="code">=</code> if not specified.</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A SQL statement that will run the comparison in a case-insensitive fashion.</p>
+
+<dt><a name="Note"
+><b>Note</b></a></dt>
+
+<dd>
+<p>Uses <a href="#sql_istring" class="podlinkpod"
+>&#34;sql_istring&#34;</a>, so it has the same performance concerns. Try to avoid using this function unless absolutely necessary.</p>
+
+<p>Subclass Implementors: Override sql_istring instead of this function, most of the time (this function uses sql_istring).</p>
+</dd>
+</dl>
+
+<dt><a name="sql_istring"
+><code  class="code">sql_istring</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Returns SQL syntax &#34;preparing&#34; a string or text column for case-insensitive comparison.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$string_-_string_to_convert_(scalar)"
+><code  class="code">$string</code> - string to convert (scalar)</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>Formatted SQL making the string case insensitive.</p>
+
+<dt><a name="Note"
+><b>Note</b></a></dt>
+
+<dd>
+<p>The default implementation simply calls LOWER on the parameter. If this is used to search on a text column with index, the index will not be usually used unless it was created as LOWER(column).</p>
+</dd>
+</dl>
+
+<dt><a name="sql_in"
+><code  class="code">sql_in</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Returns SQL syntax for the <code  class="code">IN ()</code> operator.</p>
+
+<p>Only necessary where an <code  class="code">IN</code> clause can have more than 1000 items.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$column_name_-_Column_name_(e.g._bug_id)"
+><code  class="code">$column_name</code> - Column name (e.g. <code  class="code">bug_id</code>)</a></dt>
+
+<dd>
+<dt><a name="$in_list_ref_-_an_arrayref_containing_values_for_IN_()"
+><code  class="code">$in_list_ref</code> - an arrayref containing values for <code  class="code">IN ()</code></a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>Formatted SQL for the <code  class="code">IN</code> operator.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="IMPLEMENTED_METHODS"
+>IMPLEMENTED METHODS</a></h1>
+
+<p>These methods are implemented in Bugzilla::DB, and only need to be implemented in subclasses if you need to override them for database-compatibility reasons.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="General_Information_Methods"
+>General Information Methods</a></h2>
+
+<p>These methods return information about data in the database.</p>
+
+<dl>
+<dt><a name="bz_last_key"
+><code  class="code">bz_last_key</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Returns the last serial number, usually from a previous INSERT.</p>
+
+<p>Must be executed directly following the relevant INSERT. This base implementation uses <a href="../DBI.html#last_insert_id" class="podlinkpod"
+>&#34;last_insert_id&#34; in DBI</a>. If the DBD supports it, it is the preffered way to obtain the last serial index. If it is not supported, the DB-specific code needs to override this function.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$table_-_name_of_table_containing_serial_column_(scalar)"
+><code  class="code">$table</code> - name of table containing serial column (scalar)</a></dt>
+
+<dd>
+<dt><a name="$column_-_name_of_column_containing_serial_data_type_(scalar)"
+><code  class="code">$column</code> - name of column containing serial data type (scalar)</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>Last inserted ID (scalar)</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Database_Setup_Methods"
+>Database Setup Methods</a></h2>
+
+<p>These methods are used by the Bugzilla installation programs to set up the database.</p>
+
+<dl>
+<dt><a name="bz_populate_enum_tables"
+><code  class="code">bz_populate_enum_tables</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>For an upgrade or an initial installation, populates the tables that hold the legal values for the old &#34;enum&#34; fields: <code  class="code">bug_severity</code>, <code  class="code">resolution</code>, etc. Prints out information if it inserts anything into the DB.</p>
+
+<dt><a name="Params_(none)"
+><b>Params</b> (none)</a></dt>
+
+<dd>
+<dt><a name="Returns_(nothing)"
+><b>Returns</b> (nothing)</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Schema_Modification_Methods"
+>Schema Modification Methods</a></h2>
+
+<p>These methods modify the current Bugzilla Schema.</p>
+
+<p>Where a parameter says &#34;Abstract index/column definition&#34;, it returns/takes information in the formats defined for indexes and columns in <code  class="code">Bugzilla::DB::Schema::ABSTRACT_SCHEMA</code>.</p>
+
+<dl>
+<dt><a name="bz_add_column"
+><code  class="code">bz_add_column</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Adds a new column to a table in the database. Prints out a brief statement that it did so, to stdout. Note that you cannot add a NOT NULL column that has no default -- the database won&#39;t know what to set all the NULL values to.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$table_-_the_table_where_the_column_is_being_added"
+><code  class="code">$table</code> - the table where the column is being added</a></dt>
+
+<dd>
+<dt><a name="$name_-_the_name_of_the_new_column"
+><code  class="code">$name</code> - the name of the new column</a></dt>
+
+<dd>
+<dt><a name="\%definition_-_Abstract_column_definition_for_the_new_column"
+><code  class="code">\%definition</code> - Abstract column definition for the new column</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">$init_value</code> (optional) - An initial value to set the column to. Required if your column is NOT NULL and has no DEFAULT set.</a></dt>
+</dl>
+
+<dt><a name="Returns_(nothing)"
+><b>Returns</b> (nothing)</a></dt>
+</dl>
+
+<dt><a name="bz_add_index"
+><code  class="code">bz_add_index</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Adds a new index to a table in the database. Prints out a brief statement that it did so, to stdout. If the index already exists, we will do nothing.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$table_-_The_table_the_new_index_is_on."
+><code  class="code">$table</code> - The table the new index is on.</a></dt>
+
+<dd>
+<dt><a name="$name_-_A_name_for_the_new_index."
+><code  class="code">$name</code> - A name for the new index.</a></dt>
+
+<dd>
+<dt><a name="$definition_-_An_abstract_index_definition._Either_a_hashref_or_an_arrayref."
+><code  class="code">$definition</code> - An abstract index definition. Either a hashref or an arrayref.</a></dt>
+</dl>
+
+<dt><a name="Returns_(nothing)"
+><b>Returns</b> (nothing)</a></dt>
+</dl>
+
+<dt><a name="bz_add_table"
+><code  class="code">bz_add_table</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Creates a new table in the database, based on the definition for that table in the abstract schema.</p>
+
+<p>Note that unlike the other &#39;add&#39; functions, this does not take a definition, but always creates the table as it exists in <a href="../Bugzilla/DB/Schema.html#ABSTRACT_SCHEMA" class="podlinkpod"
+>&#34;ABSTRACT_SCHEMA&#34; in Bugzilla::DB::Schema</a>.</p>
+
+<p>If a table with that name already exists, then this function returns silently.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$name_-_The_name_of_the_table_you_want_to_create."
+><code  class="code">$name</code> - The name of the table you want to create.</a></dt>
+</dl>
+
+<dt><a name="Returns_(nothing)"
+><b>Returns</b> (nothing)</a></dt>
+</dl>
+
+<dt><a name="bz_drop_index"
+><code  class="code">bz_drop_index</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Removes an index from the database. Prints out a brief statement that it did so, to stdout. If the index doesn&#39;t exist, we do nothing.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$table_-_The_table_that_the_index_is_on."
+><code  class="code">$table</code> - The table that the index is on.</a></dt>
+
+<dd>
+<dt><a name="$name_-_The_name_of_the_index_that_you_want_to_drop."
+><code  class="code">$name</code> - The name of the index that you want to drop.</a></dt>
+</dl>
+
+<dt><a name="Returns_(nothing)"
+><b>Returns</b> (nothing)</a></dt>
+</dl>
+
+<dt><a name="bz_drop_table"
+><code  class="code">bz_drop_table</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Drops a table from the database. If the table doesn&#39;t exist, we just return silently.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$name_-_The_name_of_the_table_to_drop."
+><code  class="code">$name</code> - The name of the table to drop.</a></dt>
+</dl>
+
+<dt><a name="Returns_(nothing)"
+><b>Returns</b> (nothing)</a></dt>
+</dl>
+
+<dt><a name="bz_alter_column"
+><code  class="code">bz_alter_column</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Changes the data type of a column in a table. Prints out the changes being made to stdout. If the new type is the same as the old type, the function returns without changing anything.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$table_-_the_table_where_the_column_is"
+><code  class="code">$table</code> - the table where the column is</a></dt>
+
+<dd>
+<dt><a name="$name_-_the_name_of_the_column_you_want_to_change"
+><code  class="code">$name</code> - the name of the column you want to change</a></dt>
+
+<dd>
+<dt><a name="\%new_def_-_An_abstract_column_definition_for_the_new_data_type_of_the_columm"
+><code  class="code">\%new_def</code> - An abstract column definition for the new data type of the columm</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">$set_nulls_to</code> (Optional) - If you are changing the column to be NOT NULL, you probably also want to set any existing NULL columns to a particular value. Specify that value here. <b>NOTE</b>: The value should not already be SQL-quoted.</a></dt>
+</dl>
+
+<dt><a name="Returns_(nothing)"
+><b>Returns</b> (nothing)</a></dt>
+</dl>
+
+<dt><a name="bz_drop_column"
+><code  class="code">bz_drop_column</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Removes a column from a database table. If the column doesn&#39;t exist, we return without doing anything. If we do anything, we print a short message to <code  class="code">stdout</code> about the change.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$table_-_The_table_where_the_column_is"
+><code  class="code">$table</code> - The table where the column is</a></dt>
+
+<dd>
+<dt><a name="$column_-_The_name_of_the_column_you_want_to_drop"
+><code  class="code">$column</code> - The name of the column you want to drop</a></dt>
+</dl>
+
+<dt><a name="Returns_(nothing)"
+><b>Returns</b> (nothing)</a></dt>
+</dl>
+
+<dt><a name="bz_rename_column"
+><code  class="code">bz_rename_column</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Renames a column in a database table. If the <code  class="code">$old_name</code> column doesn&#39;t exist, we return without doing anything. If <code  class="code">$old_name</code> and <code  class="code">$new_name</code> both already exist in the table specified, we fail.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$table_-_The_name_of_the_table_containing_the_column_that_you_want_to_rename"
+><code  class="code">$table</code> - The name of the table containing the column that you want to rename</a></dt>
+
+<dd>
+<dt><a name="$old_name_-_The_current_name_of_the_column_that_you_want_to_rename"
+><code  class="code">$old_name</code> - The current name of the column that you want to rename</a></dt>
+
+<dd>
+<dt><a name="$new_name_-_The_new_name_of_the_column"
+><code  class="code">$new_name</code> - The new name of the column</a></dt>
+</dl>
+
+<dt><a name="Returns_(nothing)"
+><b>Returns</b> (nothing)</a></dt>
+</dl>
+
+<dt><a name="bz_rename_table"
+><code  class="code">bz_rename_table</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Renames a table in the database. Does nothing if the table doesn&#39;t exist.</p>
+
+<p>Throws an error if the old table exists and there is already a table with the new name.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$old_name_-_The_current_name_of_the_table."
+><code  class="code">$old_name</code> - The current name of the table.</a></dt>
+
+<dd>
+<dt><a name="$new_name_-_What_you&#39;re_renaming_the_table_to."
+><code  class="code">$new_name</code> - What you&#39;re renaming the table to.</a></dt>
+</dl>
+
+<dt><a name="Returns_(nothing)"
+><b>Returns</b> (nothing)</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Schema_Information_Methods"
+>Schema Information Methods</a></h2>
+
+<p>These methods return information about the current Bugzilla database schema, as it currently exists on the disk.</p>
+
+<p>Where a parameter says &#34;Abstract index/column definition&#34;, it returns/takes information in the formats defined for indexes and columns for <a href="../Bugzilla/DB/Schema.html#ABSTRACT_SCHEMA" class="podlinkpod"
+>&#34;ABSTRACT_SCHEMA&#34; in Bugzilla::DB::Schema</a>.</p>
+
+<dl>
+<dt><a name="bz_column_info"
+><code  class="code">bz_column_info</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Get abstract column definition.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$table_-_The_name_of_the_table_the_column_is_in."
+><code  class="code">$table</code> - The name of the table the column is in.</a></dt>
+
+<dd>
+<dt><a name="$column_-_The_name_of_the_column."
+><code  class="code">$column</code> - The name of the column.</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>An abstract column definition for that column. If the table or column does not exist, we return <code  class="code">undef</code>.</p>
+</dd>
+</dl>
+
+<dt><a name="bz_index_info"
+><code  class="code">bz_index_info</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Get abstract index definition.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$table_-_The_table_the_index_is_on."
+><code  class="code">$table</code> - The table the index is on.</a></dt>
+
+<dd>
+<dt><a name="$index_-_The_name_of_the_index."
+><code  class="code">$index</code> - The name of the index.</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>An abstract index definition for that index, always in hashref format. The hashref will always contain the <code  class="code">TYPE</code> element, but it will be an empty string if it&#39;s just a normal index.</p>
+
+<p>If the index does not exist, we return <code  class="code">undef</code>.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Transaction_Methods"
+>Transaction Methods</a></h2>
+
+<p>These methods deal with the starting and stopping of transactions in the database.</p>
+
+<dl>
+<dt><a name="bz_in_transaction"
+><code  class="code">bz_in_transaction</code></a></dt>
+
+<dd>
+<p>Returns <code  class="code">1</code> if we are currently in the middle of an uncommitted transaction, <code  class="code">0</code> otherwise.</p>
+
+<dt><a name="bz_start_transaction"
+><code  class="code">bz_start_transaction</code></a></dt>
+
+<dd>
+<p>Starts a transaction.</p>
+
+<p>It is OK to call <code  class="code">bz_start_transaction</code> when you are already inside of a transaction. However, you must call <a href="#bz_commit_transaction" class="podlinkpod"
+>&#34;bz_commit_transaction&#34;</a> as many times as you called <code  class="code">bz_start_transaction</code>, in order for your transaction to actually commit.</p>
+
+<p>Bugzilla uses <code  class="code">REPEATABLE READ</code> transactions.</p>
+
+<p>Returns nothing and takes no parameters.</p>
+
+<dt><a name="bz_commit_transaction"
+><code  class="code">bz_commit_transaction</code></a></dt>
+
+<dd>
+<p>Ends a transaction, commiting all changes. Returns nothing and takes no parameters.</p>
+
+<dt><a name="bz_rollback_transaction"
+><code  class="code">bz_rollback_transaction</code></a></dt>
+
+<dd>
+<p>Ends a transaction, rolling back all changes. Returns nothing and takes no parameters.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SUBCLASS_HELPERS"
+>SUBCLASS HELPERS</a></h1>
+
+<p>Methods in this class are intended to be used by subclasses to help them with their functions.</p>
+
+<dl>
+<dt><a name="db_new"
+><code  class="code">db_new</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Constructor</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$dsn_-_database_connection_string"
+><code  class="code">$dsn</code> - database connection string</a></dt>
+
+<dd>
+<dt><a name="$user_-_username_used_to_log_in_to_the_database"
+><code  class="code">$user</code> - username used to log in to the database</a></dt>
+
+<dd>
+<dt><a name="$pass_-_password_used_to_log_in_to_the_database"
+><code  class="code">$pass</code> - password used to log in to the database</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">\%override_attrs</code> - set of attributes for DB connection (optional). You only have to set attributes that you want to be different from the default attributes set inside of <code  class="code">db_new</code>.</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A new instance of the DB class</p>
+
+<dt><a name="Note"
+><b>Note</b></a></dt>
+
+<dd>
+<p>The name of this constructor is not <code  class="code">new</code>, as that would make our check for implementation of <code  class="code">new</code> by derived class useless.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SEE_ALSO"
+>SEE ALSO</a></h1>
+
+<p><a href="../DBI.html" class="podlinkpod"
+>DBI</a></p>
+
+<p><a href="../Bugzilla/Constants.html#DB_MODULE" class="podlinkpod"
+>&#34;DB_MODULE&#34; in Bugzilla::Constants</a></p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/DB/Mysql.html b/docs/en/html/api/Bugzilla/DB/Mysql.html
new file mode 100644 (file)
index 0000000..18b5127
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/DB/Mysql.html
@@ -0,0 +1,40 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::DB::Mysql</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::DB::Mysql</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::DB::Mysql - Bugzilla database compatibility layer for MySQL</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This module overrides methods of the Bugzilla::DB module with MySQL specific implementation.
+It is instantiated by the Bugzilla::DB module and should never be used directly.</p>
+
+<p>For interface details see <a href="../../Bugzilla/DB.html" class="podlinkpod"
+>Bugzilla::DB</a> and <a href="../../DBI.html" class="podlinkpod"
+>DBI</a>.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/DB/Oracle.html b/docs/en/html/api/Bugzilla/DB/Oracle.html
new file mode 100644 (file)
index 0000000..946a11a
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/DB/Oracle.html
@@ -0,0 +1,40 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::DB::Oracle</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::DB::Oracle</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::DB::Oracle - Bugzilla database compatibility layer for Oracle</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This module overrides methods of the Bugzilla::DB module with Oracle specific implementation.
+It is instantiated by the Bugzilla::DB module and should never be used directly.</p>
+
+<p>For interface details see <a href="../../Bugzilla/DB.html" class="podlinkpod"
+>Bugzilla::DB</a> and <a href="../../DBI.html" class="podlinkpod"
+>DBI</a>.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/DB/Pg.html b/docs/en/html/api/Bugzilla/DB/Pg.html
new file mode 100644 (file)
index 0000000..0b1d03e
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/DB/Pg.html
@@ -0,0 +1,40 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::DB::Pg</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::DB::Pg</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::DB::Pg - Bugzilla database compatibility layer for PostgreSQL</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This module overrides methods of the Bugzilla::DB module with PostgreSQL specific implementation.
+It is instantiated by the Bugzilla::DB module and should never be used directly.</p>
+
+<p>For interface details see <a href="../../Bugzilla/DB.html" class="podlinkpod"
+>Bugzilla::DB</a> and <a href="../../DBI.html" class="podlinkpod"
+>DBI</a>.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/DB/Schema.html b/docs/en/html/api/Bugzilla/DB/Schema.html
new file mode 100644 (file)
index 0000000..2db8877
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/DB/Schema.html
@@ -0,0 +1,781 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::DB::Schema</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::DB::Schema</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#NEW_TO_SCHEMA.PM%3F'>NEW TO SCHEMA.PM?</a>
+  <li class='indexItem indexItem1'><a href='#CONSTANTS'>CONSTANTS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Referential_Integrity'>Referential Integrity</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <li class='indexItem indexItem1'><a href='#SERIALIZATION%2FDESERIALIZATION'>SERIALIZATION/DESERIALIZATION</a>
+  <li class='indexItem indexItem1'><a href='#CLASS_METHODS'>CLASS METHODS</a>
+  <li class='indexItem indexItem1'><a href='#ABSTRACT_DATA_TYPES'>ABSTRACT DATA TYPES</a>
+  <li class='indexItem indexItem1'><a href='#SEE_ALSO'>SEE ALSO</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::DB::Schema - Abstract database schema for Bugzilla</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">  # Obtain MySQL database schema.
+  # Do not do this. Use Bugzilla::DB instead.
+  use Bugzilla::DB::Schema;
+  my $mysql_schema = new Bugzilla::DB::Schema(&#39;Mysql&#39;);
+
+  # Recommended way to obtain database schema.
+  use Bugzilla::DB;
+  my $dbh = Bugzilla-&#62;dbh;
+  my $schema = $dbh-&#62;_bz_schema();
+
+  # Get the list of tables in the Bugzilla database.
+  my @tables = $schema-&#62;get_table_list();
+
+  # Get the SQL statements need to create the bugs table.
+  my @statements = $schema-&#62;get_table_ddl(&#39;bugs&#39;);
+
+  # Get the database-specific SQL data type used to implement
+  # the abstract data type INT1.
+  my $db_specific_type = $schema-&#62;sql_type(&#39;INT1&#39;);</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This module implements an object-oriented, abstract database schema. It should be considered package-private to the Bugzilla::DB module. That means that CGI scripts should never call any function in this module directly, but should instead rely on methods provided by Bugzilla::DB.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NEW_TO_SCHEMA.PM?"
+>NEW TO SCHEMA.PM?</a></h1>
+
+<p>If this is your first time looking at Schema.pm, especially if you are making changes to the database, please take a look at <a href="http://www.bugzilla.org/docs/developer.html#sql-schema" class="podlinkurl"
+>http://www.bugzilla.org/docs/developer.html#sql-schema</a> to learn more about how this integrates into the rest of Bugzilla.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CONSTANTS"
+>CONSTANTS</a></h1>
+
+<dl>
+<dt><a name="SCHEMA_VERSION"
+><code  class="code">SCHEMA_VERSION</code></a></dt>
+
+<dd>
+<p>The &#39;version&#39; of the internal schema structure. This version number is incremented every time the the fundamental structure of Schema internals changes.</p>
+
+<p>This is NOT changed every time a table or a column is added. This number is incremented only if the internal structures of this Schema would be incompatible with the internal structures of a previous Schema version.</p>
+
+<p>In general, unless you are messing around with serialization and deserialization of the schema, you don&#39;t need to worry about this constant.</p>
+
+<dt><a name="ABSTRACT_SCHEMA"
+><code  class="code">ABSTRACT_SCHEMA</code></a></dt>
+
+<dd>
+<p>The abstract database schema structure consists of a hash reference in which each key is the name of a table in the Bugzilla database.</p>
+
+<p>The value for each key is a hash reference containing the keys <code  class="code">FIELDS</code> and <code  class="code">INDEXES</code> which in turn point to array references containing information on the table&#39;s fields and indexes.</p>
+
+<p>A field hash reference should must contain the key <code  class="code">TYPE</code>. Optional field keys include <code  class="code">PRIMARYKEY</code>, <code  class="code">NOTNULL</code>, and <code  class="code">DEFAULT</code>.</p>
+
+<p>The <code  class="code">INDEXES</code> array reference contains index names and information regarding the index. If the index name points to an array reference, then the index is a regular index and the array contains the indexed columns. If the index name points to a hash reference, then the hash must contain the key <code  class="code">FIELDS</code>. It may also contain the key <code  class="code">TYPE</code>, which can be used to specify the type of index such as UNIQUE or FULLTEXT.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Referential_Integrity"
+>Referential Integrity</a></h2>
+
+<p>Bugzilla::DB::Schema supports &#34;foreign keys&#34;, a way of saying that &#34;Column X may only contain values from Column Y in Table Z&#34;. For example, in Bugzilla, bugs.resolution should only contain values from the resolution.values field.</p>
+
+<p>It does this by adding an additional item to a column, called <code  class="code">REFERENCES</code>. This is a hash with the following members:</p>
+
+<dl>
+<dt><a name="TABLE"
+><code  class="code">TABLE</code></a></dt>
+
+<dd>
+<p>The table the foreign key points at</p>
+
+<dt><a name="COLUMN"
+><code  class="code">COLUMN</code></a></dt>
+
+<dd>
+<p>The column pointed at in that table.</p>
+
+<dt><a name="DELETE"
+><code  class="code">DELETE</code></a></dt>
+
+<dd>
+<p>What to do if the row in the parent table is deleted. Choices are <code  class="code">RESTRICT</code>, <code  class="code">CASCADE</code>, or <code  class="code">SET NULL</code>.</p>
+
+<p><code  class="code">RESTRICT</code> means the deletion of the row in the parent table will be forbidden by the database if there is a row in <i>this</i> table that still refers to it. This is the default, if you don&#39;t specify <code  class="code">DELETE</code>.</p>
+
+<p><code  class="code">CASCADE</code> means that this row will be deleted along with that row.</p>
+
+<p><code  class="code">SET NULL</code> means that the column will be set to <code  class="code">NULL</code> when the parent row is deleted. Note that this is only valid if the column can actually be set to <code  class="code">NULL</code>. (That is, the column isn&#39;t <code  class="code">NOT NULL</code>.)</p>
+
+<dt><a name="UPDATE"
+><code  class="code">UPDATE</code></a></dt>
+
+<dd>
+<p>What to do if the value in the parent table is updated. You can set this to <code  class="code">CASCADE</code> or <code  class="code">RESTRICT</code>, which mean the same thing as they do for <a href="#DELETE" class="podlinkpod"
+>&#34;DELETE&#34;</a>. This variable defaults to <code  class="code">CASCADE</code>, which means &#34;also update this column in this table.&#34;</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<p>Note: Methods which can be implemented generically for all DBs are implemented in this module. If needed, they can be overridden with DB-specific code in a subclass. Methods which are prefixed with <code  class="code">_</code> are considered protected. Subclasses may override these methods, but other modules should not invoke these methods directly.</p>
+
+<dl>
+<dt><a name="new"
+><code  class="code">new</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Public constructor method used to instantiate objects of this
+              class. However, it also can be used as a factory method to
+              instantiate database-specific subclasses when an optional
+              driver argument is supplied.
+ Parameters:  $driver (optional) - Used to specify the type of database.
+              This routine C&#60;die&#62;s if no subclass is found for the specified
+              driver.
+              $schema (optional) - A reference to a hash. Callers external
+                  to this package should never use this parameter.
+ Returns:     new instance of the Schema class or a database-specific subclass</pre>
+
+<dt><a name="_initialize"
+><code  class="code">_initialize</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Protected method that initializes an object after
+              instantiation with the abstract schema. All subclasses should
+              override this method. The typical subclass implementation
+              should first call the C&#60;_initialize&#62; method of the superclass,
+              then do any database-specific initialization (especially
+              define the database-specific implementation of the all
+              abstract data types), and then call the C&#60;_adjust_schema&#62;
+              method.
+ Parameters:  $abstract_schema (optional) - A reference to a hash. If 
+                  provided, this hash will be used as the internal
+                  representation of the abstract schema instead of our
+                  default abstract schema. This is intended for internal 
+                  use only by deserialize_abstract.
+ Returns:     the instance of the Schema class</pre>
+
+<dt><a name="_adjust_schema"
+><code  class="code">_adjust_schema</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Protected method that alters the abstract schema at
+              instantiation-time to be database-specific. It is a generic
+              enough routine that it can be defined here in the base class.
+              It takes the abstract schema and replaces the abstract data
+              types with database-specific data types.
+ Parameters:  none
+ Returns:     the instance of the Schema class</pre>
+
+<dt><a name="get_type_ddl"
+><code  class="code">get_type_ddl</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Public method to convert abstract (database-generic) field specifiers to database-specific data types suitable for use in a <code  class="code">CREATE TABLE</code> or <code  class="code">ALTER TABLE</code> SQL statment. If no database-specific field type has been defined for the given field type, then it will just return the same field type.</p>
+
+<dt><a name="Parameters"
+><b>Parameters</b></a></dt>
+
+<dd>
+<dl>
+<dt><a 
+><code  class="code">$def</code> - A reference to a hash of a field containing the following keys: <code  class="code">TYPE</code> (required), <code  class="code">NOTNULL</code> (optional), <code  class="code">DEFAULT</code> (optional), <code  class="code">PRIMARYKEY</code> (optional), <code  class="code">REFERENCES</code> (optional)</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A DDL string suitable for describing a field in a <code  class="code">CREATE TABLE</code> or <code  class="code">ALTER TABLE</code> SQL statement</p>
+</dd>
+</dl>
+
+<dt><a name="_get_fk_ddl"
+><code  class="code">_get_fk_ddl</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Protected method. Translates the <code  class="code">REFERENCES</code> item of a column into SQL.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$table_-_The_name_of_the_table_the_reference_is_from."
+><code  class="code">$table</code> - The name of the table the reference is from.</a></dt>
+
+<dd>
+<dt><a name="$column_-_The_name_of_the_column_the_reference_is_from"
+><code  class="code">$column</code> - The name of the column the reference is from</a></dt>
+
+<dd>
+<dt><a name="$references_-_The_REFERENCES_hashref_from_a_column."
+><code  class="code">$references</code> - The <code  class="code">REFERENCES</code> hashref from a column.</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>SQL for to define the foreign key, or an empty string if <code  class="code">$references</code> is undefined.</p>
+</dd>
+</dl>
+
+<dt><a name="convert_type"
+><code  class="code">convert_type</code></a></dt>
+
+<dd>
+<p>Converts a TYPE from the <a href="#ABSTRACT_SCHEMA" class="podlinkpod"
+>&#34;ABSTRACT_SCHEMA&#34;</a> format into the real SQL type.</p>
+
+<dt><a name="get_column($table,_$column)"
+><code  class="code">get_column($table, $column)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Public method to get the abstract definition of a column.
+ Parameters:  $table - the table name
+              $column - a column in the table
+ Returns:     a hashref containing information about the column, including its
+              type (C&#60;TYPE&#62;), whether or not it can be null (C&#60;NOTNULL&#62;),
+              its default value if it has one (C&#60;DEFAULT), etc.
+              Returns undef if the table or column does not exist.</pre>
+
+<dt><a name="get_table_list"
+><code  class="code">get_table_list</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Public method for discovering what tables should exist in the
+              Bugzilla database.
+
+ Parameters:  none
+
+ Returns:     An array of table names, in alphabetical order.</pre>
+
+<dt><a name="get_table_columns"
+><code  class="code">get_table_columns</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Public method for discovering what columns are in a given
+              table in the Bugzilla database.
+ Parameters:  $table - the table name
+ Returns:     array of column names</pre>
+
+<dt><a name="get_table_ddl"
+><code  class="code">get_table_ddl</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Public method to generate the SQL statements needed to create
+              the a given table and its indexes in the Bugzilla database.
+              Subclasses may override or extend this method, if needed, but
+              subclasses probably should override C&#60;_get_create_table_ddl&#62;
+              or C&#60;_get_create_index_ddl&#62; instead.
+ Parameters:  $table - the table name
+ Returns:     an array of strings containing SQL statements</pre>
+
+<dt><a name="_get_create_table_ddl"
+><code  class="code">_get_create_table_ddl</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Protected method to generate the &#34;create table&#34; SQL statement
+              for a given table.
+ Parameters:  $table - the table name
+ Returns:     a string containing the DDL statement for the specified table</pre>
+
+<dt><a name="_get_create_index_ddl"
+><code  class="code">_get_create_index_ddl</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Protected method to generate a &#34;create index&#34; SQL statement
+              for a given table and index.
+ Parameters:  $table_name - the name of the table
+              $index_name - the name of the index
+              $index_fields - a reference to an array of field names
+              $index_type (optional) - specify type of index (e.g., UNIQUE)
+ Returns:     a string containing the DDL statement</pre>
+
+<dt><a name="get_add_column_ddl($table,_$column,_\%definition,_$init_value)"
+><code  class="code">get_add_column_ddl($table, $column, \%definition, $init_value)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Generate SQL to add a column to a table.
+ Params:      $table - The table containing the column.
+              $column - The name of the column being added.
+              \%definition - The new definition for the column,
+                  in standard C&#60;ABSTRACT_SCHEMA&#62; format.
+              $init_value - (optional) An initial value to set 
+                            the column to. Should already be SQL-quoted
+                            if necessary.
+ Returns:     An array of SQL statements.</pre>
+
+<dt><a name="get_add_index_ddl"
+><code  class="code">get_add_index_ddl</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Gets SQL for creating an index.
+              NOTE: Subclasses should not override this function. Instead,
+              if they need to specify a custom CREATE INDEX statement, 
+              they should override C&#60;_get_create_index_ddl&#62;
+ Params:      $table - The name of the table the index will be on.
+              $name  - The name of the new index.
+              $definition - An index definition. Either a hashref 
+                            with FIELDS and TYPE or an arrayref 
+                            containing a list of columns.
+ Returns:     An array of SQL statements that will create the 
+              requested index.</pre>
+
+<dt><a name="get_alter_column_ddl($table,_$column,_\%definition)"
+><code  class="code">get_alter_column_ddl($table, $column, \%definition)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Generate SQL to alter a column in a table.
+              The column that you are altering must exist,
+              and the table that it lives in must exist.
+ Params:      $table - The table containing the column.
+              $column - The name of the column being changed.
+              \%definition - The new definition for the column,
+                  in standard C&#60;ABSTRACT_SCHEMA&#62; format.
+              $set_nulls_to - A value to set NULL values to, if
+                  your new definition is NOT NULL and contains
+                  no DEFAULT, and when there is a possibility
+                  that the column could contain NULLs. $set_nulls_to
+                  should be already SQL-quoted if necessary.
+ Returns:     An array of SQL statements.</pre>
+
+<dt><a name="get_drop_index_ddl($table,_$name)"
+><code  class="code">get_drop_index_ddl($table, $name)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Generates SQL statements to drop an index.
+ Params:      $table - The table the index is on.
+              $name  - The name of the index being dropped.
+ Returns:     An array of SQL statements.</pre>
+
+<dt><a name="get_drop_column_ddl($table,_$column)"
+><code  class="code">get_drop_column_ddl($table, $column)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Generate SQL to drop a column from a table.
+ Params:      $table - The table containing the column.
+              $column - The name of the column being dropped.
+ Returns:     An array of SQL statements.</pre>
+
+<dt><a name="get_drop_table_ddl($table)"
+><code  class="code">get_drop_table_ddl($table)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Generate SQL to drop a table from the database.
+ Params:      $table - The name of the table to drop.
+ Returns:     An array of SQL statements.</pre>
+
+<dt><a name="get_rename_column_ddl($table,_$old_name,_$new_name)"
+><code  class="code">get_rename_column_ddl($table, $old_name, $new_name)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Generate SQL to change the name of a column in a table.
+              NOTE: ANSI SQL contains no simple way to rename a column,
+                    so this function is ABSTRACT and must be implemented
+                    by subclasses.
+ Params:      $table - The table containing the column to be renamed.
+              $old_name - The name of the column being renamed.
+              $new_name - The name the column is changing to.
+ Returns:     An array of SQL statements.</pre>
+
+<dt><a name="get_rename_table_sql"
+><code  class="code">get_rename_table_sql</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Gets SQL to rename a table in the database.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$old_name_-_The_current_name_of_the_table."
+><code  class="code">$old_name</code> - The current name of the table.</a></dt>
+
+<dd>
+<dt><a name="$new_name_-_The_new_name_of_the_table."
+><code  class="code">$new_name</code> - The new name of the table.</a></dt>
+</dl>
+
+<dt><a name="Returns:_An_array_of_SQL_statements_to_rename_a_table."
+><b>Returns</b>: An array of SQL statements to rename a table.</a></dt>
+</dl>
+
+<dt><a name="delete_table($name)"
+><code  class="code">delete_table($name)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Deletes a table from this Schema object.
+              Dies if you try to delete a table that doesn&#39;t exist.
+ Params:      $name - The name of the table to delete.
+ Returns:     nothing</pre>
+
+<dt><a name="get_column_abstract($table,_$column)"
+><code  class="code">get_column_abstract($table, $column)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: A column definition from the abstract internal schema.
+              cross-database format.
+ Params:      $table - The name of the table
+              $column - The name of the column that you want
+ Returns:     A hash reference. For the format, see the docs for
+              C&#60;ABSTRACT_SCHEMA&#62;.
+              Returns undef if the column or table does not exist.</pre>
+
+<dt><a name="get_indexes_on_column_abstract($table,_$column)"
+><code  class="code">get_indexes_on_column_abstract($table, $column)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Gets a list of indexes that are on a given column.
+ Params:      $table - The table the column is on.
+              $column - The name of the column.
+ Returns:     Indexes in the standard format of an INDEX
+              entry on a table. That is, key-value pairs
+              where the key is the index name and the value
+              is the index definition.
+              If there are no indexes on that column, we return
+              undef.</pre>
+
+<dt><a name="get_index_abstract($table,_$index)"
+><code  class="code">get_index_abstract($table, $index)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns an index definition from the internal abstract schema.
+ Params:      $table - The table the index is on.
+              $index - The name of the index.
+ Returns:     A hash reference representing an index definition.
+              See the C&#60;ABSTRACT_SCHEMA&#62; docs for details.
+              Returns undef if the index does not exist.</pre>
+
+<dt><a name="get_table_abstract($table)"
+><code  class="code">get_table_abstract($table)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Gets the abstract definition for a table in this Schema
+              object.
+ Params:      $table - The name of the table you want a definition for.
+ Returns:     An abstract table definition, or undef if the table doesn&#39;t
+              exist.</pre>
+
+<dt><a name="add_table($name,_\%definition)"
+><code  class="code">add_table($name, \%definition)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Creates a new table in this Schema object.
+              If you do not specify a definition, we will
+              simply create an empty table.
+ Params:      $name - The name for the new table.
+              \%definition (optional) - An abstract definition for
+                  the new table.
+ Returns:     nothing</pre>
+
+<dt><a name="rename_table"
+><code  class="code">rename_table</code></a></dt>
+
+<dd>
+<p>Renames a table from <code  class="code">$old_name</code> to <code  class="code">$new_name</code> in this Schema object.</p>
+
+<dt><a name="delete_column($table,_$column)"
+><code  class="code">delete_column($table, $column)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Deletes a column from this Schema object.
+ Params:      $table - Name of the table that the column is in.
+                       The table must exist, or we will fail.
+              $column  - Name of the column to delete.
+ Returns:     nothing</pre>
+
+<dt><a name="rename_column($table,_$old_name,_$new_name)"
+><code  class="code">rename_column($table, $old_name, $new_name)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Renames a column on a table in the Schema object.
+              The column that you are renaming must exist.
+ Params:      $table - The table the column is on.
+              $old_name - The current name of the column.
+              $new_name - The new name of hte column.
+ Returns:     nothing</pre>
+
+<dt><a name="set_column($table,_$column,_\%new_def)"
+><code  class="code">set_column($table, $column, \%new_def)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Changes the definition of a column in this Schema object.
+              If the column doesn&#39;t exist, it will be added.
+              The table that you specify must already exist in the Schema.
+              NOTE: This does not affect the database on the disk.
+              Use the C&#60;Bugzilla::DB&#62; &#34;Schema Modification Methods&#34;
+              if you want to do that.
+ Params:      $table - The name of the table that the column is on.
+              $column - The name of the column.
+              \%new_def - The new definition for the column, in 
+                  C&#60;ABSTRACT_SCHEMA&#62; format.
+ Returns:     nothing</pre>
+
+<dt><a name="set_fk($table,_$column_\%fk_def)"
+><code  class="code">set_fk($table, $column \%fk_def)</code></a></dt>
+
+<dd>
+<p>Sets the <code  class="code">REFERENCES</code> item on the specified column.</p>
+
+<dt><a name="set_index($table,_$name,_$definition)"
+><code  class="code">set_index($table, $name, $definition)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Changes the definition of an index in this Schema object.
+              If the index doesn&#39;t exist, it will be added.
+              The table that you specify must already exist in the Schema.
+              NOTE: This does not affect the database on the disk.
+              Use the C&#60;Bugzilla::DB&#62; &#34;Schema Modification Methods&#34;
+              if you want to do that.
+ Params:      $table      - The table the index is on.
+              $name       - The name of the index.
+              $definition - A hashref or an arrayref. An index 
+                            definition in C&#60;ABSTRACT_SCHEMA&#62; format.
+ Returns:     nothing</pre>
+
+<dt><a name="delete_index($table,_$name)"
+><code  class="code">delete_index($table, $name)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Removes an index definition from this Schema object.
+              If the index doesn&#39;t exist, we will fail.
+              The table that you specify must exist in the Schema.
+              NOTE: This does not affect the database on the disk.
+              Use the C&#60;Bugzilla::DB&#62; &#34;Schema Modification Methods&#34;
+              if you want to do that.
+ Params:      $table - The table the index is on.
+              $name  - The name of the index that we&#39;re removing.
+ Returns:     nothing</pre>
+
+<dt><a name="columns_equal($col_one,_$col_two)"
+><code  class="code">columns_equal($col_one, $col_two)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Tells you if two columns have entirely identical definitions.
+              The TYPE field&#39;s value will be compared case-insensitive.
+              However, all other fields will be case-sensitive.
+ Params:      $col_one, $col_two - The columns to compare. Hash 
+                  references, in C&#60;ABSTRACT_SCHEMA&#62; format.
+ Returns:     C&#60;1&#62; if the columns are identical, C&#60;0&#62; if they are not.</pre>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SERIALIZATION/DESERIALIZATION"
+>SERIALIZATION/DESERIALIZATION</a></h1>
+
+<dl>
+<dt><a name="serialize_abstract()"
+><code  class="code">serialize_abstract()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Serializes the &#34;abstract&#34; schema into a format
+              that deserialize_abstract() can read in. This is
+              a method, called on a Schema instance.
+ Parameters:  none
+ Returns:     A scalar containing the serialized, abstract schema.
+              Do not attempt to manipulate this data directly,
+              as the format may change at any time in the future.
+              The only thing you should do with the returned value
+              is either store it somewhere (coupled with appropriate 
+              SCHEMA_VERSION) or deserialize it.</pre>
+
+<dt><a name="deserialize_abstract($serialized,_$version)"
+><code  class="code">deserialize_abstract($serialized, $version)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Used for when you&#39;ve read a serialized Schema off the disk,
+              and you want a Schema object that represents that data.
+ Params:      $serialized - scalar. The serialized data.
+              $version - A number. The &#34;version&#34;
+                  of the Schema that did the serialization.
+                  See the docs for C&#60;SCHEMA_VERSION&#62; for more details.
+ Returns:     A Schema object. It will have the methods of (and work 
+              in the same fashion as) the current version of Schema. 
+              However, it will represent the serialized data instead of
+              ABSTRACT_SCHEMA.</pre>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CLASS_METHODS"
+>CLASS METHODS</a></h1>
+
+<p>These methods are generally called on the class instead of on a specific object.</p>
+
+<dl>
+<dt><a name="get_empty_schema()"
+><code  class="code">get_empty_schema()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns a Schema that has no tables. In effect, this
+              Schema is totally &#34;empty.&#34;
+ Params:      none
+ Returns:     A &#34;empty&#34; Schema object.</pre>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="ABSTRACT_DATA_TYPES"
+>ABSTRACT DATA TYPES</a></h1>
+
+<p>The size and range data provided here is only intended as a guide. See your database&#39;s Bugzilla module (in this directory) for the most up-to-date values for these data types. The following abstract data types are used:</p>
+
+<dl>
+<dt><a name="BOOLEAN"
+><code  class="code">BOOLEAN</code></a></dt>
+
+<dd>
+<p>Logical value 0 or 1 where 1 is true, 0 is false.</p>
+
+<dt><a name="INT1"
+><code  class="code">INT1</code></a></dt>
+
+<dd>
+<p>Integer values (-128 - 127 or 0 - 255 unsigned).</p>
+
+<dt><a name="INT2"
+><code  class="code">INT2</code></a></dt>
+
+<dd>
+<p>Integer values (-32,768 - 32767 or 0 - 65,535 unsigned).</p>
+
+<dt><a name="INT3"
+><code  class="code">INT3</code></a></dt>
+
+<dd>
+<p>Integer values (-8,388,608 - 8,388,607 or 0 - 16,777,215 unsigned)</p>
+
+<dt><a name="INT4"
+><code  class="code">INT4</code></a></dt>
+
+<dd>
+<p>Integer values (-2,147,483,648 - 2,147,483,647 or 0 - 4,294,967,295 unsigned)</p>
+
+<dt><a name="SMALLSERIAL"
+><code  class="code">SMALLSERIAL</code></a></dt>
+
+<dd>
+<p>An auto-increment <a href="#INT2" class="podlinkpod"
+>&#34;INT2&#34;</a></p>
+
+<dt><a name="MEDIUMSERIAL"
+><code  class="code">MEDIUMSERIAL</code></a></dt>
+
+<dd>
+<p>An auto-increment <a href="#INT3" class="podlinkpod"
+>&#34;INT3&#34;</a></p>
+
+<dt><a name="INTSERIAL"
+><code  class="code">INTSERIAL</code></a></dt>
+
+<dd>
+<p>An auto-increment <a href="#INT4" class="podlinkpod"
+>&#34;INT4&#34;</a></p>
+
+<dt><a name="TINYTEXT"
+><code  class="code">TINYTEXT</code></a></dt>
+
+<dd>
+<p>Variable length string of characters up to 255 (2^8 - 1) characters wide.</p>
+
+<dt><a name="MEDIUMTEXT"
+><code  class="code">MEDIUMTEXT</code></a></dt>
+
+<dd>
+<p>Variable length string of characters up to 4000 characters wide. May be longer on some databases.</p>
+
+<dt><a name="LONGTEXT"
+><code  class="code">LONGTEXT</code></a></dt>
+
+<dd>
+<p>Variable length string of characters up to 16M (2^24 - 1) characters wide.</p>
+
+<dt><a name="LONGBLOB"
+><code  class="code">LONGBLOB</code></a></dt>
+
+<dd>
+<p>Variable length string of binary data up to 4M (2^32 - 1) bytes wide</p>
+
+<dt><a name="DATETIME"
+><code  class="code">DATETIME</code></a></dt>
+
+<dd>
+<p>DATETIME support varies from database to database, however, it&#39;s generally safe to say that DATETIME entries support all date/time combinations greater than 1900-01-01 00:00:00. Note that the format used is <code  class="code">YYYY-MM-DD hh:mm:ss</code> to be safe, though it&#39;s possible that your database may not require leading zeros. For greatest compatibility, however, please make sure dates are formatted as above for queries to guarantee consistent results.</p>
+</dd>
+</dl>
+
+<p>Database-specific subclasses should define the implementation for these data types as a hash reference stored internally in the schema object as <code  class="code">db_specific</code>. This is typically done in overridden <a href="../../_initialize.html" class="podlinkpod"
+>_initialize</a> method.</p>
+
+<p>The following abstract boolean values should also be defined on a database-specific basis:</p>
+
+<dl>
+<dt><a name="TRUE"
+><code  class="code">TRUE</code></a></dt>
+
+<dd>
+<dt><a name="FALSE"
+><code  class="code">FALSE</code></a></dt>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SEE_ALSO"
+>SEE ALSO</a></h1>
+
+<p><a href="../../Bugzilla/DB.html" class="podlinkpod"
+>Bugzilla::DB</a></p>
+
+<p><a href="http://www.bugzilla.org/docs/developer.html#sql-schema" class="podlinkurl"
+>http://www.bugzilla.org/docs/developer.html#sql-schema</a></p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/DB/Sqlite.html b/docs/en/html/api/Bugzilla/DB/Sqlite.html
new file mode 100644 (file)
index 0000000..3c749d4
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/DB/Sqlite.html
@@ -0,0 +1,40 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::DB::Sqlite</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::DB::Sqlite</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::DB::Sqlite - Bugzilla database compatibility layer for SQLite</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This module overrides methods of the Bugzilla::DB module with a SQLite-specific implementation.
+It is instantiated by the Bugzilla::DB module and should never be used directly.</p>
+
+<p>For interface details see <a href="../../Bugzilla/DB.html" class="podlinkpod"
+>Bugzilla::DB</a> and <a href="../../DBI.html" class="podlinkpod"
+>DBI</a>.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Error.html b/docs/en/html/api/Bugzilla/Error.html
new file mode 100644 (file)
index 0000000..162a289
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Error.html
@@ -0,0 +1,83 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Error</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Error</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#FUNCTIONS'>FUNCTIONS</a>
+  <li class='indexItem indexItem1'><a href='#SEE_ALSO'>SEE ALSO</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Error - Error handling utilities for Bugzilla</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">  use Bugzilla::Error;
+
+  ThrowUserError(&#34;error_tag&#34;,
+                 { foo =&#62; &#39;bar&#39; });</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Various places throughout the Bugzilla codebase need to report errors to the user. The <code  class="code">Throw*Error</code> family of functions allow this to be done in a generic and localizable manner.</p>
+
+<p>These functions automatically unlock the database tables, if there were any locked. They will also roll back the transaction, if it is supported by the underlying DB.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="FUNCTIONS"
+>FUNCTIONS</a></h1>
+
+<dl>
+<dt><a name="ThrowUserError"
+><code  class="code">ThrowUserError</code></a></dt>
+
+<dd>
+<p>This function takes an error tag as the first argument, and an optional hashref of variables as a second argument. These are used by the <i>global/user-error.html.tmpl</i> template to format the error, using the passed in variables as required.</p>
+
+<dt><a name="ThrowCodeError"
+><code  class="code">ThrowCodeError</code></a></dt>
+
+<dd>
+<p>This function is used when an internal check detects an error of some sort. This usually indicates a bug in Bugzilla, although it can occur if the user manually constructs urls without correct parameters.</p>
+
+<p>This function&#39;s behaviour is similar to <code  class="code">ThrowUserError</code>, except that the template used to display errors is <i>global/code-error.html.tmpl</i>. In addition if the hashref used as the optional second argument contains a key <i>variables</i> then the contents of the hashref (which is expected to be another hashref) will be displayed after the error message, as a debugging aid.</p>
+
+<dt><a name="ThrowTemplateError"
+><code  class="code">ThrowTemplateError</code></a></dt>
+
+<dd>
+<p>This function should only be called if a <code  class="code">template-&#60;gt</code>process()&#62; fails. It tries another template first, because often one template being broken or missing doesn&#39;t mean that they all are. But it falls back to a print statement as a last-ditch error.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SEE_ALSO"
+>SEE ALSO</a></h1>
+
+<p><a href="../Bugzilla.html" class="podlinkpod"
+>Bugzilla</a></p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Extension.html b/docs/en/html/api/Bugzilla/Extension.html
new file mode 100644 (file)
index 0000000..101f108
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Extension.html
@@ -0,0 +1,558 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Extension</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Extension</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#WRITING_EXTENSIONS'>WRITING EXTENSIONS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Using_extensions%2Fcreate.pl'>Using extensions/create.pl</a>
+    <li class='indexItem indexItem2'><a href='#Example_Extension'>Example Extension</a>
+    <li class='indexItem indexItem2'><a href='#Where_Extension_Code_Goes'>Where Extension Code Goes</a>
+    <li class='indexItem indexItem2'><a href='#The_Extension_NAME.'>The Extension NAME.</a>
+    <li class='indexItem indexItem2'><a href='#Hooks'>Hooks</a>
+    <ul   class='indexList indexList3'>
+      <li class='indexItem indexItem3'><a href='#Adding_New_Hooks_To_Bugzilla'>Adding New Hooks To Bugzilla</a>
+    </ul>
+    <li class='indexItem indexItem2'><a href='#If_Your_Extension_Requires_Certain_Perl_Modules'>If Your Extension Requires Certain Perl Modules</a>
+    <ul   class='indexList indexList3'>
+      <li class='indexItem indexItem3'><a href='#If_Your_Extension_Needs_Certain_Modules_In_Order_To_Compile'>If Your Extension Needs Certain Modules In Order To Compile</a>
+    </ul>
+    <li class='indexItem indexItem2'><a href='#Libraries'>Libraries</a>
+    <li class='indexItem indexItem2'><a href='#Templates'>Templates</a>
+    <li class='indexItem indexItem2'><a href='#Template_Hooks'>Template Hooks</a>
+    <ul   class='indexList indexList3'>
+      <li class='indexItem indexItem3'><a href='#Which_Templates_Can_Be_Hooked'>Which Templates Can Be Hooked</a>
+      <li class='indexItem indexItem3'><a href='#Where_Template_Hooks_Go'>Where Template Hooks Go</a>
+      <li class='indexItem indexItem3'><a href='#Adding_New_Template_Hooks_to_Bugzilla'>Adding New Template Hooks to Bugzilla</a>
+    </ul>
+    <li class='indexItem indexItem2'><a href='#Overriding_Existing_Templates'>Overriding Existing Templates</a>
+    <ul   class='indexList indexList3'>
+      <li class='indexItem indexItem3'><a href='#A_Warning_About_Extensions_That_You_Want_To_Distribute'>A Warning About Extensions That You Want To Distribute</a>
+    </ul>
+    <li class='indexItem indexItem2'><a href='#CSS%2C_JavaScript%2C_and_Images'>CSS, JavaScript, and Images</a>
+    <li class='indexItem indexItem2'><a href='#Disabling_Your_Extension'>Disabling Your Extension</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#DISTRIBUTING_EXTENSIONS'>DISTRIBUTING EXTENSIONS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Distributing_on_CPAN'>Distributing on CPAN</a>
+    <ul   class='indexList indexList3'>
+      <li class='indexItem indexItem3'><a href='#Templates_in_extensions_distributed_on_CPAN'>Templates in extensions distributed on CPAN</a>
+      <li class='indexItem indexItem3'><a href='#Using_an_extension_distributed_on_CPAN'>Using an extension distributed on CPAN</a>
+    </ul>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#GETTING_HELP_WITH_WRITING_EXTENSIONS'>GETTING HELP WITH WRITING EXTENSIONS</a>
+  <li class='indexItem indexItem1'><a href='#ADDITIONAL_CONSTANTS'>ADDITIONAL CONSTANTS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#%24VERSION'>$VERSION</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#SUBCLASS_METHODS'>SUBCLASS METHODS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Class_Methods'>Class Methods</a>
+    <ul   class='indexList indexList3'>
+      <li class='indexItem indexItem3'><a href='#new'>new</a>
+    </ul>
+    <li class='indexItem indexItem2'><a href='#Instance_Methods'>Instance Methods</a>
+    <ul   class='indexList indexList3'>
+      <li class='indexItem indexItem3'><a href='#enabled'>enabled</a>
+      <li class='indexItem indexItem3'><a href='#package_dir'>package_dir</a>
+      <li class='indexItem indexItem3'><a href='#template_dir'>template_dir</a>
+      <li class='indexItem indexItem3'><a href='#web_dir'>web_dir</a>
+      <li class='indexItem indexItem3'><a href='#lib_dir'>lib_dir</a>
+    </ul>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#BUGZILLA%3A%3AEXTENSION_CLASS_METHODS'>BUGZILLA::EXTENSION CLASS METHODS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#load'>load</a>
+    <li class='indexItem indexItem2'><a href='#load_all'>load_all</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Extension - Base class for Bugzilla Extensions.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<p>The following would be in <em  class="code">extensions/Foo/Extension.pm</em> or <em  class="code">extensions/Foo.pm</em>:</p>
+
+<pre  class="code"> package Bugzilla::Extension::Foo
+ use strict;
+ use base qw(Bugzilla::Extension);
+
+ our $VERSION = &#39;0.02&#39;;
+ use constant NAME =&#62; &#39;Foo&#39;;
+
+ sub some_hook_name { ... }
+
+ __PACKAGE__-&#62;NAME;</pre>
+
+<p>Custom templates would go into <em  class="code">extensions/Foo/template/en/default/</em>. <a href="#Template_Hooks" class="podlinkpod"
+>Template hooks</a> would go into <em  class="code">extensions/Foo/template/en/default/hook/</em>.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This is the base class for all Bugzilla extensions.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="WRITING_EXTENSIONS"
+>WRITING EXTENSIONS</a></h1>
+
+<p>The <a href="#SYNOPSIS" class="podlinkpod"
+>&#34;SYNOPSIS&#34;</a> above gives a pretty good overview of what&#39;s basically required to write an extension. This section gives more information on exactly how extensions work and how you write them. There is also a <a href="https://wiki.mozilla.org/Bugzilla:Extension_Notes" class="podlinkurl"
+>wiki page</a> with additional HOWTOs, tips and tricks.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Using_extensions/create.pl"
+>Using <em  class="code">extensions/create.pl</em></a></h2>
+
+<p>There is a script, <a href="../extensions/create.html" class="podlinkpod"
+>extensions::create</a>, that will set up the framework of a new extension for you. To use it, pick a name for your extension and, in the base bugzilla directory, do:</p>
+
+<p><code  class="code">extensions/create.pl NAME</code></p>
+
+<p>But replace <code  class="code">NAME</code> with the name you picked for your extension. That will create a new directory in the <em  class="code">extensions/</em> directory with the name of your extension. The directory will contain a full framework for a new extension, with helpful comments in each file describing things about them.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Example_Extension"
+>Example Extension</a></h2>
+
+<p>There is a sample extension in <em  class="code">extensions/Example/</em> that demonstrates most of the things described in this document, so if you find the documentation confusing, try just reading the code instead.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Where_Extension_Code_Goes"
+>Where Extension Code Goes</a></h2>
+
+<p>Extension code lives under the <em  class="code">extensions/</em> directory in Bugzilla.</p>
+
+<p>There are two ways to write extensions:</p>
+
+<ol>
+<li>If your extension will have only code and no templates or other files, you can create a simple <code  class="code">.pm</code> file in the <em  class="code">extensions/</em> directory.
+<p>For example, if you wanted to create an extension called &#34;Foo&#34; using this method, you would put your code into a file called <em  class="code">extensions/Foo.pm</em>.</p>
+</li>
+
+<li>If you plan for your extension to have templates and other files, you can create a whole directory for your extension, and the main extension code would go into a file called <em  class="code">Extension.pm</em> in that directory.
+<p>For example, if you wanted to create an extension called &#34;Foo&#34; using this method, you would put your code into a file called <em  class="code">extensions/Foo/Extension.pm</em>.</p>
+</li>
+</ol>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="The_Extension_NAME."
+>The Extension <code  class="code">NAME</code>.</a></h2>
+
+<p>The &#34;name&#34; of an extension shows up in several places:</p>
+
+<ol>
+<li>The name of the package:
+<p><code  class="code">package Bugzilla::Extension::Foo;</code></p>
+</li>
+
+<li>In a <code  class="code">NAME</code> constant that <b>must</b> be defined for every extension:
+<p><code  class="code">use constant NAME =&#62; &#39;Foo&#39;;</code></p>
+</li>
+
+<li>At the very end of the file:
+<p><code  class="code">__PACKAGE__-&#62;NAME;</code></p>
+
+<p>You&#39;ll notice that though most Perl packages end with <code  class="code">1;</code>, Bugzilla Extensions must <b>always</b> end with <code  class="code">__PACKAGE__-&#62;NAME;</code>.</p>
+</li>
+</ol>
+
+<p>The name must be identical in all of those locations.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Hooks"
+>Hooks</a></h2>
+
+<p>In <a href="../Bugzilla/Hook.html" class="podlinkpod"
+>Bugzilla::Hook</a>, there is a <a href="../Bugzilla/Hook.html#HOOKS" class="podlinkpod"
+>list of hooks</a>. These are the various areas of Bugzilla that an extension can &#34;hook&#34; into, which allow your extension to perform code during that point in Bugzilla&#39;s execution.</p>
+
+<p>If your extension wants to implement a hook, all you have to do is write a subroutine in your hook package that has the same name as the hook. The subroutine will be called as a method on your extension, and it will get the arguments specified in the hook&#39;s documentation as named parameters in a hashref.</p>
+
+<p>For example, here&#39;s an implementation of a hook named <code  class="code">foo_start</code> that gets an argument named <code  class="code">bar</code>:</p>
+
+<pre  class="code"> sub foo_start {
+     my ($self, $args) = @_;
+     my $bar = $args-&#62;{bar};
+     print &#34;I got $bar!\n&#34;;
+ }</pre>
+
+<p>And that would go into your extension&#39;s code file--the file that was described in the <a href="#Where_Extension_Code_Goes" class="podlinkpod"
+>&#34;Where Extension Code Goes&#34;</a> section above.</p>
+
+<p>During your subroutine, you may want to know what values were passed as CGI arguments to the current script, or what arguments were passed to the current WebService method. You can get that data via <a href="../Bugzilla.html#input_params" class="podlinkpod"
+>&#34;input_params&#34; in Bugzilla</a>.</p>
+
+<h3><a class='u' href='#___top' title='click to go to top of document'
+name="Adding_New_Hooks_To_Bugzilla"
+>Adding New Hooks To Bugzilla</a></h3>
+
+<p>If you need a new hook for your extension and you want that hook to be added to Bugzilla itself, see our development process at <a href="http://wiki.mozilla.org/Bugzilla:Developers" class="podlinkurl"
+>http://wiki.mozilla.org/Bugzilla:Developers</a>.</p>
+
+<p>In order for a new hook to be accepted into Bugzilla, it has to work, it must have documentation in <a href="../Bugzilla/Hook.html" class="podlinkpod"
+>Bugzilla::Hook</a>, and it must have example code in <em  class="code">extensions/Example/Extension.pm</em>.</p>
+
+<p>One question that is often asked about new hooks is, &#34;Is this the most flexible way to implement this hook?&#34; That is, the more power extension authors get from a hook, the more likely it is to be accepted into Bugzilla. Hooks that only hook a very specific part of Bugzilla will not be accepted if their functionality can be accomplished equally well with a more generic hook.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="If_Your_Extension_Requires_Certain_Perl_Modules"
+>If Your Extension Requires Certain Perl Modules</a></h2>
+
+<p>If there are certain Perl modules that your extension requires in order to run, there is a way you can tell Bugzilla this, and then <a href="../checksetup.html" class="podlinkpod"
+>checksetup</a> will make sure that those modules are installed, when you run <a href="../checksetup.html" class="podlinkpod"
+>checksetup</a>.</p>
+
+<p>To do this, you need to specify a constant called <code  class="code">REQUIRED_MODULES</code> in your extension. This constant has the same format as <a href="../Bugzilla/Install/Requirements.html#REQUIRED_MODULES" class="podlinkpod"
+>&#34;REQUIRED_MODULES&#34; in Bugzilla::Install::Requirements</a>.</p>
+
+<p>If there are optional modules that add additional functionality to your application, you can specify them in a constant called OPTIONAL_MODULES, which has the same format as <a href="../Bugzilla/Install/Requirements.html#OPTIONAL_MODULES" class="podlinkpod"
+>&#34;OPTIONAL_MODULES&#34; in Bugzilla::Install::Requirements</a>.</p>
+
+<h3><a class='u' href='#___top' title='click to go to top of document'
+name="If_Your_Extension_Needs_Certain_Modules_In_Order_To_Compile"
+>If Your Extension Needs Certain Modules In Order To Compile</a></h3>
+
+<p>If your extension needs a particular Perl module in order to <i>compile</i>, then you have a &#34;chicken and egg&#34; problem--in order to read <code  class="code">REQUIRED_MODULES</code>, we have to compile your extension. In order to compile your extension, we need to already have the modules in <code  class="code">REQUIRED_MODULES</code>!</p>
+
+<p>To get around this problem, Bugzilla allows you to have an additional file, besides <em  class="code">Extension.pm</em>, called <em  class="code">Config.pm</em>, that contains just <code  class="code">REQUIRED_MODULES</code>. If you have a <em  class="code">Config.pm</em>, it must also contain the <code  class="code">NAME</code> constant, instead of your main <em  class="code">Extension.pm</em> containing the <code  class="code">NAME</code> constant.</p>
+
+<p>The contents of the file would look something like this for an extension named <code  class="code">Foo</code>:</p>
+
+<pre  class="code">  package Bugzilla::Extension::Foo;
+  use strict;
+  use constant NAME =&#62; &#39;Foo&#39;;
+  use constant REQUIRED_MODULES =&#62; [
+    {
+      package =&#62; &#39;Some-Package&#39;,
+      module  =&#62; &#39;Some::Module&#39;,
+      version =&#62; 0,
+    }
+  ];
+  __PACKAGE__-&#62;NAME;</pre>
+
+<p>Note that it is <i>not</i> a subclass of <code  class="code">Bugzilla::Extension</code>, because at the time that module requirements are being checked in <a href="../checksetup.html" class="podlinkpod"
+>checksetup</a>, <code  class="code">Bugzilla::Extension</code> cannot be loaded. Also, just like <em  class="code">Extension.pm</em>, it ends with <code  class="code">__PACKAGE__-&#62;NAME;</code>. Note also that it has the <b>exact same</b> <code  class="code">package</code> name as <em  class="code">Extension.pm</em>.</p>
+
+<p>This file may not use any Perl modules other than <a href="../Bugzilla/Constants.html" class="podlinkpod"
+>Bugzilla::Constants</a>, <a href="../Bugzilla/Install/Util.html" class="podlinkpod"
+>Bugzilla::Install::Util</a>, <a href="../Bugzilla/Install/Requirements.html" class="podlinkpod"
+>Bugzilla::Install::Requirements</a>, and modules that ship with Perl itself.</p>
+
+<p>If you want to define both <code  class="code">REQUIRED_MODULES</code> and <code  class="code">OPTIONAL_MODULES</code>, they must both be in <em  class="code">Config.pm</em> or both in <em  class="code">Extension.pm</em>.</p>
+
+<p>Every time your extension is loaded by Bugzilla, <em  class="code">Config.pm</em> will be read and then <em  class="code">Extension.pm</em> will be read, so your methods in <em  class="code">Extension.pm</em> will have access to everything in <em  class="code">Config.pm</em>. Don&#39;t define anything with an identical name in both files, or Perl may throw a warning that you are redefining things.</p>
+
+<p>This method of setting <code  class="code">REQUIRED_MODULES</code> is of course not available if your extension is a single file named <code  class="code">Foo.pm</code>.</p>
+
+<p>If any of this is confusing, just look at the code of the Example extension. It uses this method to specify requirements.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Libraries"
+>Libraries</a></h2>
+
+<p>Extensions often want to have their own Perl modules. Your extension can load any Perl module in its <em  class="code">lib/</em> directory. (So, if your extension is <em  class="code">extensions/Foo/</em>, then your Perl modules go into <em  class="code">extensions/Foo/lib/</em>.)</p>
+
+<p>However, the <code  class="code">package</code> name of your libraries will not work quite like normal Perl modules do. <em  class="code">extensions/Foo/lib/Bar.pm</em> is loaded as <code  class="code">Bugzilla::Extension::Foo::Bar</code>. Or, to say it another way, <code  class="code">use Bugzilla::Extension::Foo::Bar;</code> loads <em  class="code">extensions/Foo/lib/Bar.pm</em>, which should have <code  class="code">package Bugzilla::Extension::Foo::Bar;</code> as its package name.</p>
+
+<p>This allows any place in Bugzilla to load your modules, which is important for some hooks. It even allows other extensions to load your modules, and allows you to install your modules into the global Perl install as <em  class="code">Bugzilla/Extension/Foo/Bar.pm</em>, if you&#39;d like, which helps allow CPAN distribution of Bugzilla extensions.</p>
+
+<p><b>Note:</b> If you want to <code  class="code">use</code> or <code  class="code">require</code> a module that&#39;s in <em  class="code">extensions/Foo/lib/</em> at the top level of your <em  class="code">Extension.pm</em>, you must have a <em  class="code">Config.pm</em> (see above) with at least the <code  class="code">NAME</code> constant defined in it.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Templates"
+>Templates</a></h2>
+
+<p>Extensions store templates in a <code  class="code">template</code> subdirectory of the extension. (Obviously, this isn&#39;t available for extensions that aren&#39;t a directory.)</p>
+
+<p>The format of this directory is exactly like the normal layout of Bugzilla&#39;s <code  class="code">template</code> directory--in fact, your extension&#39;s <code  class="code">template</code> directory becomes part of Bugzilla&#39;s template &#34;search path&#34; as described in <a href="../Bugzilla/Install/Util.html#template_include_path" class="podlinkpod"
+>&#34;template_include_path&#34; in Bugzilla::Install::Util</a>.</p>
+
+<p>You can actually include templates in your extension without having any <code  class="code">.pm</code> files in your extension at all, if you want. (That is, it&#39;s entirely valid to have an extension that&#39;s just template files and no code files.)</p>
+
+<p>Bugzilla&#39;s templates are written in a language called Template Toolkit. You can find out more about Template Toolkit at <a href="http://template-toolkit.org" class="podlinkurl"
+>http://template-toolkit.org</a>.</p>
+
+<p>There are two ways to extend or modify Bugzilla&#39;s templates: you can use template hooks (described below) or you can override existing templates entirely (described further down).</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Template_Hooks"
+>Template Hooks</a></h2>
+
+<p>Templates can be extended using a system of &#34;hooks&#34; that add new UI elements to a particular area of Bugzilla without modifying the code of the existing templates. This is the recommended way for extensions to modify the user interface of Bugzilla.</p>
+
+<h3><a class='u' href='#___top' title='click to go to top of document'
+name="Which_Templates_Can_Be_Hooked"
+>Which Templates Can Be Hooked</a></h3>
+
+<p>There is no list of template hooks like there is for standard code hooks. To find what places in the user interface can be hooked, search for the string <code  class="code">Hook.process</code> in Bugzilla&#39;s templates (in the <em  class="code">template/en/default/</em> directory). That will also give you the name of the hooks--the first argument to <code  class="code">Hook.process</code> is the name of the hook. (A later section in this document explains how to use that name).</p>
+
+<p>For example, if you see <code  class="code">Hook.process(&#34;additional_header&#34;)</code>, that means the name of the hook is <code  class="code">additional_header</code>.</p>
+
+<h3><a class='u' href='#___top' title='click to go to top of document'
+name="Where_Template_Hooks_Go"
+>Where Template Hooks Go</a></h3>
+
+<p>To extend templates in your extension using template hooks, you put files into the <em  class="code">template/en/default/hook</em> directory of your extension. So, if you had an extension called &#34;Foo&#34;, your template extensions would go into <em  class="code">extensions/Foo/template/en/default/hook/</em>.</p>
+
+<p>(Note that the base <em  class="code">template/en/default/hook</em> directory in Bugzilla itself also works, although you would never use that for an extension that you intended to distribute.)</p>
+
+<p>The files that go into this directory have a certain name, based on the name of the template that is being hooked, and the name of the hook. For example, let&#39;s imagine that you have an extension named &#34;Foo&#34;, and you want to use the <code  class="code">additional_header</code> hook in <em  class="code">template/en/default/global/header.html.tmpl</em>. Your code would go into <em  class="code">extensions/Foo/template/en/default/hook/global/header-additional_header.html.tmpl</em>. Any code you put into that file will happen at the point that <code  class="code">Hook.process(&#34;additional_header&#34;)</code> is called in <em  class="code">template/en/default/global/header.html.tmpl</em>.</p>
+
+<p>As you can see, template extension file names follow a pattern. The pattern looks like:</p>
+
+<pre  class="code"> &#60;templates&#62;/hook/&#60;template path&#62;/&#60;template name&#62;-&#60;hook name&#62;.&#60;template type&#62;.tmpl</pre>
+
+<dl>
+<dt><a name="&#60;templates&#62;"
+>&#60;templates&#62;</a></dt>
+
+<dd>
+<p>This is the full path to the template directory, like <em  class="code">extensions/Foo/template/en/default</em>. This works much like normal templates do, in the sense that template extensions in <code  class="code">custom</code> override template extensions in <code  class="code">default</code> for your extension, templates for different languages can be supplied, etc. Template extensions are searched for and run in the order described in <a href="../Bugzilla/Install/Util.html#template_include_path" class="podlinkpod"
+>&#34;template_include_path&#34; in Bugzilla::Install::Util</a>.</p>
+
+<p>The difference between normal templates and template hooks is that hooks will be run for <i>every</i> extension, whereas for normal templates, Bugzilla just takes the first one it finds and stops searching. So while a template extension in the <code  class="code">custom</code> directory may override the same-named template extension in the <code  class="code">default</code> directory <i>within your Bugzilla extension</i>, it will not override the same-named template extension in the <code  class="code">default</code> directory of another Bugzilla extension.</p>
+
+<dt><a name="&#60;template_path&#62;"
+>&#60;template path&#62;</a></dt>
+
+<dd>
+<p>This is the part of the path (excluding the filename) that comes after <em  class="code">template/en/default/</em> in a template&#39;s path. So, for <em  class="code">template/en/default/global/header.html.tmpl</em>, this would simply be <code  class="code">global</code>.</p>
+
+<dt><a name="&#60;template_name&#62;"
+>&#60;template name&#62;</a></dt>
+
+<dd>
+<p>This is the file name of the template, before the <code  class="code">.html.tmpl</code> part. So, for <em  class="code">template/en/default/global/header.html.tmpl</em>, this would be <code  class="code">header</code>.</p>
+
+<dt><a name="&#60;hook_name&#62;"
+>&#60;hook name&#62;</a></dt>
+
+<dd>
+<p>This is the name of the hook--what you saw in <code  class="code">Hook.process</code> inside of the template you want to hook. In our example, this is <code  class="code">additional_header</code>.</p>
+
+<dt><a name="&#60;template_type&#62;"
+>&#60;template type&#62;</a></dt>
+
+<dd>
+<p>This is what comes after the template name but before <code  class="code">.tmpl</code> in the template&#39;s path. In most cases this is <code  class="code">html</code>, but sometimes it&#39;s <code  class="code">none</code>, <code  class="code">txt</code>, <code  class="code">js</code>, or various other formats, indicating what type of output the template has.</p>
+</dd>
+</dl>
+
+<h3><a class='u' href='#___top' title='click to go to top of document'
+name="Adding_New_Template_Hooks_to_Bugzilla"
+>Adding New Template Hooks to Bugzilla</a></h3>
+
+<p>Adding new template hooks is just like adding code hooks (see <a href="#Adding_New_Hooks_To_Bugzilla" class="podlinkpod"
+>&#34;Adding New Hooks To Bugzilla&#34;</a>) except that you don&#39;t have to document them, and including example code is optional.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Overriding_Existing_Templates"
+>Overriding Existing Templates</a></h2>
+
+<p>Sometimes you don&#39;t want to extend a template, you just want to replace it entirely with your extension&#39;s template, or you want to add an entirely new template to Bugzilla for your extension to use.</p>
+
+<p>To replace the <em  class="code">template/en/default/global/banner.html.tmpl</em> template in an extension named &#34;Foo&#34;, create a file called <em  class="code">extensions/Foo/template/en/default/global/banner.html.tmpl</em>. Note that this is very similar to the path for a template hook, except that it excludes <em  class="code">hook/</em>, and the template is named <i>exactly</i> like the standard Bugzilla template.</p>
+
+<p>You can also use this method to add entirely new templates. If you have an extension named &#34;Foo&#34;, and you add a file named <em  class="code">extensions/Foo/template/en/default/foo/bar.html.tmpl</em>, you can load that in your code using <code  class="code">$template-&#62;process(&#39;foo/bar.html.tmpl&#39;)</code>.</p>
+
+<h3><a class='u' href='#___top' title='click to go to top of document'
+name="A_Warning_About_Extensions_That_You_Want_To_Distribute"
+>A Warning About Extensions That You Want To Distribute</a></h3>
+
+<p>You should never override an existing Bugzilla template in an extension that you plan to distribute to others, because only one extension can override any given template, and which extension will &#34;win&#34; that war if there are multiple extensions installed is totally undefined.</p>
+
+<p>However, adding new templates in an extension that you want to distribute is fine, though you have to be careful about how you name them, because any templates with an identical path and name (say, both called <em  class="code">global/stuff.html.tmpl</em>) will conflict. The usual way to work around this is to put all your custom templates into a template path that&#39;s named after your extension (since the name of your extension has to be unique anyway). So if your extension was named Foo, your custom templates would go into <em  class="code">extensions/Foo/template/en/default/foo/</em>. The only time that doesn&#39;t work is with the <code  class="code">page_before_template</code> extension, in which case your templates should probably be in a directory like <em  class="code">extensions/Foo/template/en/default/page/foo/</em> so as not to conflict with other pages that other extensions might add.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="CSS,_JavaScript,_and_Images"
+>CSS, JavaScript, and Images</a></h2>
+
+<p>If you include CSS, JavaScript, and images in your extension that are served directly to the user (that is, they&#39;re not read by a script and then printed--they&#39;re just linked directly in your HTML), they should go into the <em  class="code">web/</em> subdirectory of your extension.</p>
+
+<p>So, for example, if you had a CSS file called <em  class="code">style.css</em> and your extension was called <em  class="code">Foo</em>, your file would go into <em  class="code">extensions/Foo/web/style.css</em>.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Disabling_Your_Extension"
+>Disabling Your Extension</a></h2>
+
+<p>If you want your extension to be totally ignored by Bugzilla (it will not be compiled or seen to exist at all), then create a file called <code  class="code">disabled</code> in your extension&#39;s directory. (If your extension is just a file, like <em  class="code">extensions/Foo.pm</em>, you cannot use this method to disable your extension, and will just have to remove it from the directory if you want to totally disable it.) Note that if you are running under mod_perl, you may have to restart your web server for this to take effect.</p>
+
+<p>If you want your extension to be compiled and have <a href="../checksetup.html" class="podlinkpod"
+>checksetup</a> check for its module pre-requisites, but you don&#39;t want the module to be used by Bugzilla, then you should make your extension&#39;s <a href="#enabled" class="podlinkpod"
+>&#34;enabled&#34;</a> method return <code  class="code">0</code> or some false value.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DISTRIBUTING_EXTENSIONS"
+>DISTRIBUTING EXTENSIONS</a></h1>
+
+<p>If you&#39;ve made an extension and you want to publish it, the first thing you&#39;ll want to do is package up your extension&#39;s code and then put a link to it in the appropriate section of <a href="http://wiki.mozilla.org/Bugzilla:Addons" class="podlinkurl"
+>http://wiki.mozilla.org/Bugzilla:Addons</a>.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Distributing_on_CPAN"
+>Distributing on CPAN</a></h2>
+
+<p>If you want a centralized distribution point that makes it easy for Bugzilla users to install your extension, it is possible to distribute your Bugzilla Extension through CPAN.</p>
+
+<p>The details of making a standard CPAN module are too much to go into here, but a lot of it is covered in <a href="../perlmodlib.html" class="podlinkpod"
+>perlmodlib</a> and on <a href="http://www.cpan.org/" class="podlinkurl"
+>http://www.cpan.org/</a> among other places.</p>
+
+<p>When you distribute your extension via CPAN, your <em  class="code">Extension.pm</em> should simply install itself as <em  class="code">Bugzilla/Extension/Foo.pm</em>, where <code  class="code">Foo</code> is the name of your module. You do not need a separate <em  class="code">Config.pm</em> file, because CPAN itself will handle installing the prerequisites of your module, so Bugzilla doesn&#39;t have to worry about it.</p>
+
+<h3><a class='u' href='#___top' title='click to go to top of document'
+name="Templates_in_extensions_distributed_on_CPAN"
+>Templates in extensions distributed on CPAN</a></h3>
+
+<p>If your extension is <em  class="code">/usr/lib/perl5/Bugzilla/Extension/Foo.pm</em>, then Bugzilla will look for templates in the directory <em  class="code">/usr/lib/perl5/Bugzilla/Extension/Foo/template/</em>.</p>
+
+<p>You can change this behavior by overriding the <a href="#template_dir" class="podlinkpod"
+>&#34;template_dir&#34;</a> or <a href="#package_dir" class="podlinkpod"
+>&#34;package_dir&#34;</a> methods described lower down in this document.</p>
+
+<h3><a class='u' href='#___top' title='click to go to top of document'
+name="Using_an_extension_distributed_on_CPAN"
+>Using an extension distributed on CPAN</a></h3>
+
+<p>There is a file named <em  class="code">data/extensions/additional</em> in Bugzilla. This is a plain-text file. Each line is the name of a module, like <code  class="code">Bugzilla::Extension::Foo</code>. In addition to the extensions in the <em  class="code">extensions/</em> directory, each module listed in this file will be loaded as a Bugzilla Extension whenever Bugzilla loads or uses extensions.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="GETTING_HELP_WITH_WRITING_EXTENSIONS"
+>GETTING HELP WITH WRITING EXTENSIONS</a></h1>
+
+<p>If you are an extension author and you&#39;d like some assistance from other extension authors or the Bugzilla development team, you can use the normal support channels described at <a href="http://www.bugzilla.org/support/" class="podlinkurl"
+>http://www.bugzilla.org/support/</a>.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="ADDITIONAL_CONSTANTS"
+>ADDITIONAL CONSTANTS</a></h1>
+
+<p>In addition to <code  class="code">NAME</code>, there are some other constants you might want to define:</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="$VERSION"
+><code  class="code">$VERSION</code></a></h2>
+
+<p>This should be a string that describes what version of your extension this is. Something like <code  class="code">1.0</code>, <code  class="code">1.3.4</code> or a similar string.</p>
+
+<p>There are no particular restrictions on the format of version numbers, but you should probably keep them to just numbers and periods, in the interest of other software that parses version numbers.</p>
+
+<p>By default, this will be <code  class="code">undef</code> if you don&#39;t define it.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SUBCLASS_METHODS"
+>SUBCLASS METHODS</a></h1>
+
+<p>In addition to hooks, there are a few methods that your extension can define to modify its behavior, if you want:</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Class_Methods"
+>Class Methods</a></h2>
+
+<p>These methods are called on your extension&#39;s class. (Like <code  class="code">Bugzilla::Extension::Foo-&#62;some_method</code>).</p>
+
+<h3><a class='u' href='#___top' title='click to go to top of document'
+name="new"
+><code  class="code">new</code></a></h3>
+
+<p>Once every request, this method is called on your extension in order to create an &#34;instance&#34; of it. (Extensions are treated like objects--they are instantiated once per request in Bugzilla, and then methods are called on the object.)</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Instance_Methods"
+>Instance Methods</a></h2>
+
+<p>These are called on an instantiated Extension object.</p>
+
+<h3><a class='u' href='#___top' title='click to go to top of document'
+name="enabled"
+><code  class="code">enabled</code></a></h3>
+
+<p>This should return <code  class="code">1</code> if this extension&#39;s hook code should be run by Bugzilla, and <code  class="code">0</code> otherwise.</p>
+
+<h3><a class='u' href='#___top' title='click to go to top of document'
+name="package_dir"
+><code  class="code">package_dir</code></a></h3>
+
+<p>This returns the directory that your extension is located in.</p>
+
+<p>If this is an extension that was installed via CPAN, the directory will be the path to <em  class="code">Bugzilla/Extension/Foo/</em>, if <code  class="code">Foo.pm</code> is the name of your extension.</p>
+
+<p>If you want to override this method, and you have a <em  class="code">Config.pm</em>, you must override this method in <em  class="code">Config.pm</em>.</p>
+
+<h3><a class='u' href='#___top' title='click to go to top of document'
+name="template_dir"
+><code  class="code">template_dir</code></a></h3>
+
+<p>The directory that your package&#39;s templates are in.</p>
+
+<p>This defaults to the <code  class="code">template</code> subdirectory of the <a href="#package_dir" class="podlinkpod"
+>&#34;package_dir&#34;</a>.</p>
+
+<p>If you want to override this method, and you have a <em  class="code">Config.pm</em>, you must override this method in <em  class="code">Config.pm</em>.</p>
+
+<h3><a class='u' href='#___top' title='click to go to top of document'
+name="web_dir"
+><code  class="code">web_dir</code></a></h3>
+
+<p>The directory that your package&#39;s web related files are in, such as css and javascript.</p>
+
+<p>This defaults to the <code  class="code">web</code> subdirectory of the <a href="#package_dir" class="podlinkpod"
+>&#34;package_dir&#34;</a>.</p>
+
+<p>If you want to override this method, and you have a <em  class="code">Config.pm</em>, you must override this method in <em  class="code">Config.pm</em>.</p>
+
+<h3><a class='u' href='#___top' title='click to go to top of document'
+name="lib_dir"
+><code  class="code">lib_dir</code></a></h3>
+
+<p>The directory where your extension&#39;s libraries are.</p>
+
+<p>This defaults to the <code  class="code">lib</code> subdirectory of the <a href="#package_dir" class="podlinkpod"
+>&#34;package_dir&#34;</a>.</p>
+
+<p>If you want to override this method, and you have a <em  class="code">Config.pm</em>, you must override this method in <em  class="code">Config.pm</em>.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="BUGZILLA::EXTENSION_CLASS_METHODS"
+>BUGZILLA::EXTENSION CLASS METHODS</a></h1>
+
+<p>These are used internally by Bugzilla to load and set up extensions. If you are an extension author, you don&#39;t need to care about these.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="load"
+><code  class="code">load</code></a></h2>
+
+<p>Takes two arguments, the path to <em  class="code">Extension.pm</em> and the path to <em  class="code">Config.pm</em>, for an extension. Loads the extension&#39;s code packages into memory using <code  class="code">require</code>, does some sanity-checking on the extension, and returns the package name of the loaded extension.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="load_all"
+><code  class="code">load_all</code></a></h2>
+
+<p>Calls <a href="#load" class="podlinkpod"
+>&#34;load&#34;</a> for every enabled extension installed into Bugzilla, and returns an arrayref of all the package names that were loaded.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Field.html b/docs/en/html/api/Bugzilla/Field.html
new file mode 100644 (file)
index 0000000..9f7d296
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Field.html
@@ -0,0 +1,493 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Field</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Field</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Instance_Properties'>Instance Properties</a>
+    <li class='indexItem indexItem2'><a href='#Instance_Mutators'>Instance Mutators</a>
+    <li class='indexItem indexItem2'><a href='#Instance_Method'>Instance Method</a>
+    <li class='indexItem indexItem2'><a href='#Class_Methods'>Class Methods</a>
+    <li class='indexItem indexItem2'><a href='#Data_Validation'>Data Validation</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Field - a particular piece of information about bugs and useful routines for form field manipulation</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">  use Bugzilla;
+  use Data::Dumper;
+
+  # Display information about all fields.
+  print Dumper(Bugzilla-&#62;fields());
+
+  # Display information about non-obsolete custom fields.
+  print Dumper(Bugzilla-&#62;active_custom_fields);
+
+  use Bugzilla::Field;
+
+  # Display information about non-obsolete custom fields.
+  # Bugzilla-&#62;fields() is a wrapper around Bugzilla::Field-&#62;get_all(),
+  # with arguments which filter the fields before returning them.
+  print Dumper(Bugzilla-&#62;fields({ obsolete =&#62; 0, custom =&#62; 1 }));
+
+  # Create or update a custom field or field definition.
+  my $field = Bugzilla::Field-&#62;create(
+    {name =&#62; &#39;cf_silly&#39;, description =&#62; &#39;Silly&#39;, custom =&#62; 1});
+
+  # Instantiate a Field object for an existing field.
+  my $field = new Bugzilla::Field({name =&#62; &#39;qacontact_accessible&#39;});
+  if ($field-&#62;obsolete) {
+      say $field-&#62;description . &#34; is obsolete&#34;;
+  }
+
+  # Validation Routines
+  check_field($name, $value, \@legal_values, $no_warn);
+  $fieldid = get_field_id($fieldname);</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Field.pm defines field objects, which represent the particular pieces of information that Bugzilla stores about bugs.</p>
+
+<p>This package also provides functions for dealing with CGI form fields.</p>
+
+<p><code  class="code">Bugzilla::Field</code> is an implementation of <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, and so provides all of the methods available in <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, in addition to what is documented here.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Instance_Properties"
+>Instance Properties</a></h2>
+
+<dl>
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p>the name of the field in the database; begins with &#34;cf_&#34; if field is a custom field, but test the value of the boolean &#34;custom&#34; property to determine if a given field is a custom field;</p>
+
+<dt><a name="description"
+><code  class="code">description</code></a></dt>
+
+<dd>
+<p>a short string describing the field; displayed to Bugzilla users in several places within Bugzilla&#39;s UI, f.e. as the form field label on the &#34;show bug&#34; page;</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="long_desc"
+><code  class="code">long_desc</code></a></dt>
+
+<dd>
+<p>A string providing detailed info about the field;</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="type"
+><code  class="code">type</code></a></dt>
+
+<dd>
+<p>an integer specifying the kind of field this is; values correspond to the FIELD_TYPE_* constants in Constants.pm</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="custom"
+><code  class="code">custom</code></a></dt>
+
+<dd>
+<p>a boolean specifying whether or not the field is a custom field; if true, field name should start &#34;cf_&#34;, but use this property to determine which fields are custom fields;</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="in_new_bugmail"
+><code  class="code">in_new_bugmail</code></a></dt>
+
+<dd>
+<p>a boolean specifying whether or not the field is displayed in bugmail for newly-created bugs;</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="sortkey"
+><code  class="code">sortkey</code></a></dt>
+
+<dd>
+<p>an integer specifying the sortkey of the field.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="obsolete"
+><code  class="code">obsolete</code></a></dt>
+
+<dd>
+<p>a boolean specifying whether or not the field is obsolete;</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="enter_bug"
+><code  class="code">enter_bug</code></a></dt>
+
+<dd>
+<p>A boolean specifying whether or not this field should appear on enter_bug.cgi</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="buglist"
+><code  class="code">buglist</code></a></dt>
+
+<dd>
+<p>A boolean specifying whether or not this field is selectable as a display or order column in buglist.cgi</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="is_select"
+><code  class="code">is_select</code></a></dt>
+
+<dd>
+<p>True if this is a <code  class="code">FIELD_TYPE_SINGLE_SELECT</code> or <code  class="code">FIELD_TYPE_MULTI_SELECT</code> field. It is only safe to call <a href="#legal_values" class="podlinkpod"
+>&#34;legal_values&#34;</a> if this is true.</p>
+
+<dt><a name="legal_values"
+><code  class="code">legal_values</code></a></dt>
+
+<dd>
+<p>Valid values for this field, as an array of <a href="../Bugzilla/Field/Choice.html" class="podlinkpod"
+>Bugzilla::Field::Choice</a> objects.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="is_abnormal"
+><code  class="code">is_abnormal</code></a></dt>
+
+<dd>
+<p>Most fields that have a <code  class="code">SELECT</code> <a href="#type" class="podlinkpod"
+>&#34;type&#34;</a> have a certain schema for the table that stores their values, the table has the same name as the field, and the field&#39;s legal values can be edited via <em  class="code">editvalues.cgi</em>.</p>
+
+<p>However, some fields do not follow that pattern. Those fields are considered &#34;abnormal&#34;.</p>
+
+<p>This method returns <code  class="code">1</code> if the field is &#34;abnormal&#34;, <code  class="code">0</code> otherwise.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="is_timetracking"
+><code  class="code">is_timetracking</code></a></dt>
+
+<dd>
+<p>True if this is a time-tracking field that should only be shown to users in the <code  class="code">timetrackinggroup</code>.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="visibility_field"
+><code  class="code">visibility_field</code></a></dt>
+
+<dd>
+<p>What field controls this field&#39;s visibility? Returns a <code  class="code">Bugzilla::Field</code> object representing the field that controls this field&#39;s visibility.</p>
+
+<p>Returns undef if there is no field that controls this field&#39;s visibility.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="visibility_values"
+><code  class="code">visibility_values</code></a></dt>
+
+<dd>
+<p>If we have a <a href="#visibility_field" class="podlinkpod"
+>&#34;visibility_field&#34;</a>, then what values does that field have to be set to in order to show this field? Returns a <a href="../Bugzilla/Field/Choice.html" class="podlinkpod"
+>Bugzilla::Field::Choice</a> or undef if there is no <code  class="code">visibility_field</code> set.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="controls_visibility_of"
+><code  class="code">controls_visibility_of</code></a></dt>
+
+<dd>
+<p>An arrayref of <code  class="code">Bugzilla::Field</code> objects, representing fields that this field controls the visibility of.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="value_field"
+><code  class="code">value_field</code></a></dt>
+
+<dd>
+<p>The Bugzilla::Field that controls the list of values for this field.</p>
+
+<p>Returns undef if there is no field that controls this field&#39;s visibility.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="controls_values_of"
+><code  class="code">controls_values_of</code></a></dt>
+
+<dd>
+<p>An arrayref of <code  class="code">Bugzilla::Field</code> objects, representing fields that this field controls the values of.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="is_visible_on_bug"
+><code  class="code">is_visible_on_bug</code></a></dt>
+
+<dd>
+<p>See <a href="../Bugzilla/Field/ChoiceInterface.html" class="podlinkpod"
+>Bugzilla::Field::ChoiceInterface</a>.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="is_relationship"
+><code  class="code">is_relationship</code></a></dt>
+
+<dd>
+<p>Applies only to fields of type FIELD_TYPE_BUG_ID. Checks to see if a reverse relationship description has been set. This is the canonical condition to enable reverse link display, dependency tree display, and similar functionality.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="reverse_desc"
+><code  class="code">reverse_desc</code></a></dt>
+
+<dd>
+<p>Applies only to fields of type FIELD_TYPE_BUG_ID. Describes the reverse relationship of this field. For example, if a BUG_ID field is called &#34;Is a duplicate of&#34;, the reverse description would be &#34;Duplicates of this bug&#34;.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="is_mandatory"
+><code  class="code">is_mandatory</code></a></dt>
+
+<dd>
+<p>a boolean specifying whether or not the field is mandatory;</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="is_numeric"
+><code  class="code">is_numeric</code></a></dt>
+
+<dd>
+<p>A boolean specifying whether or not this field logically contains numeric (integer, decimal, or boolean) values. By &#34;logically contains&#34; we mean that the user inputs numbers into the value of the field in the UI. This is mostly used by <a href="../Bugzilla/Search.html" class="podlinkpod"
+>Bugzilla::Search</a>.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Instance_Mutators"
+>Instance Mutators</a></h2>
+
+<p>These set the particular field that they are named after.</p>
+
+<p>They take a single value--the new value for that field.</p>
+
+<p>They will throw an error if you try to set the values to something invalid.</p>
+
+<dl>
+<dt><a name="set_description"
+><code  class="code">set_description</code></a></dt>
+
+<dd>
+<dt><a name="set_long_desc"
+><code  class="code">set_long_desc</code></a></dt>
+
+<dd>
+<dt><a name="set_enter_bug"
+><code  class="code">set_enter_bug</code></a></dt>
+
+<dd>
+<dt><a name="set_obsolete"
+><code  class="code">set_obsolete</code></a></dt>
+
+<dd>
+<dt><a name="set_sortkey"
+><code  class="code">set_sortkey</code></a></dt>
+
+<dd>
+<dt><a name="set_in_new_bugmail"
+><code  class="code">set_in_new_bugmail</code></a></dt>
+
+<dd>
+<dt><a name="set_buglist"
+><code  class="code">set_buglist</code></a></dt>
+
+<dd>
+<dt><a name="set_reverse_desc"
+><code  class="code">set_reverse_desc</code></a></dt>
+
+<dd>
+<dt><a name="set_visibility_field"
+><code  class="code">set_visibility_field</code></a></dt>
+
+<dd>
+<dt><a name="set_visibility_values"
+><code  class="code">set_visibility_values</code></a></dt>
+
+<dd>
+<dt><a name="set_value_field"
+><code  class="code">set_value_field</code></a></dt>
+
+<dd>
+<dt><a name="set_is_mandatory"
+><code  class="code">set_is_mandatory</code></a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Instance_Method"
+>Instance Method</a></h2>
+
+<dl>
+<dt><a name="remove_from_db"
+><code  class="code">remove_from_db</code></a></dt>
+
+<dd>
+<p>Attempts to remove the passed in field from the database. Deleting a field is only successful if the field is obsolete and there are no values specified (or EVER specified) for the field.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Class_Methods"
+>Class Methods</a></h2>
+
+<dl>
+<dt><a name="create"
+><code  class="code">create</code></a></dt>
+
+<dd>
+<p>Just like <a href="../Bugzilla/Object.html#create" class="podlinkpod"
+>&#34;create&#34; in Bugzilla::Object</a>. Takes the following parameters:</p>
+
+<dl>
+<dt><a name="name_Required_-_The_name_of_the_field."
+><code  class="code">name</code> <b>Required</b> - The name of the field.</a></dt>
+
+<dd>
+<dt><a name="description_Required_-_The_field_label_to_display_in_the_UI."
+><code  class="code">description</code> <b>Required</b> - The field label to display in the UI.</a></dt>
+
+<dd>
+<dt><a name="long_desc_-_A_longer_description_of_the_field."
+><code  class="code">long_desc</code> - A longer description of the field.</a></dt>
+
+<dd>
+<dt><a name="mailhead_-_boolean_-_Whether_this_field_appears_at_the_top_of_the_bugmail_for_a_newly-filed_bug._Defaults_to_0."
+><code  class="code">mailhead</code> - boolean - Whether this field appears at the top of the bugmail for a newly-filed bug. Defaults to 0.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">custom</code> - boolean - True if this is a Custom Field. The field will be added to the <code  class="code">bugs</code> table if it does not exist. Defaults to 0.</a></dt>
+
+<dd>
+<dt><a name="sortkey_-_integer_-_The_sortkey_of_the_field._Defaults_to_0."
+><code  class="code">sortkey</code> - integer - The sortkey of the field. Defaults to 0.</a></dt>
+
+<dd>
+<dt><a name="enter_bug_-_boolean_-_Whether_this_field_is_editable_on_the_bug_creation_form._Defaults_to_0."
+><code  class="code">enter_bug</code> - boolean - Whether this field is editable on the bug creation form. Defaults to 0.</a></dt>
+
+<dd>
+<dt><a name="buglist_-_boolean_-_Whether_this_field_is_selectable_as_a_display_or_order_column_in_bug_lists._Defaults_to_0."
+><code  class="code">buglist</code> - boolean - Whether this field is selectable as a display or order column in bug lists. Defaults to 0.</a></dt>
+
+<dd>
+<p><code  class="code">obsolete</code> - boolean - Whether this field is obsolete. Defaults to 0.</p>
+
+<p><code  class="code">is_mandatory</code> - boolean - Whether this field is mandatory. Defaults to 0.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="get_legal_field_values($field)"
+><code  class="code">get_legal_field_values($field)</code></a></dt>
+
+<dd>
+<p>Description: returns all the legal values for a field that has a list of legal values, like rep_platform or resolution. The table where these values are stored must at least have the following columns: value, isactive, sortkey.</p>
+
+<p>Params: <code  class="code">$field</code> - Name of the table where valid values are.</p>
+
+<p>Returns: a reference to a list of valid values.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="populate_field_definitions()"
+><code  class="code">populate_field_definitions()</code></a></dt>
+
+<dd>
+<p>Description: Populates the fielddefs table during an installation or upgrade.</p>
+
+<p>Params: none</p>
+
+<p>Returns: nothing</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Data_Validation"
+>Data Validation</a></h2>
+
+<dl>
+<dt><a name="check_field($name,_$value,_\@legal_values,_$no_warn)"
+><code  class="code">check_field($name, $value, \@legal_values, $no_warn)</code></a></dt>
+
+<dd>
+<p>Description: Makes sure the field $name is defined and its $value is non empty. If @legal_values is defined, this routine checks whether its value is one of the legal values associated with this field, else it checks against the default valid values for this field obtained by <code  class="code">get_legal_field_values($name)</code>. If the test is successful, the function returns 1. If the test fails, an error is thrown (by default), unless $no_warn is true, in which case the function returns 0.</p>
+
+<p>Params: $name - the field name $value - the field value @legal_values - (optional) list of legal values $no_warn - (optional) do not throw an error if true</p>
+
+<p>Returns: 1 on success; 0 on failure if $no_warn is true (else an error is thrown).</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="get_field_id($fieldname)"
+><code  class="code">get_field_id($fieldname)</code></a></dt>
+
+<dd>
+<p>Description: Returns the ID of the specified field name and throws an error if this field does not exist.</p>
+
+<p>Params: $name - a field name</p>
+
+<p>Returns: the corresponding field ID or an error if the field name does not exist.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Field/Choice.html b/docs/en/html/api/Bugzilla/Field/Choice.html
new file mode 100644 (file)
index 0000000..2e69cb7
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Field/Choice.html
@@ -0,0 +1,93 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Field::Choice</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Field::Choice</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Class_Factory'>Class Factory</a>
+    <li class='indexItem indexItem2'><a href='#Mutators'>Mutators</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Field::Choice - A legal value for a &#60;select&#62;-type field.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> my $field = new Bugzilla::Field({name =&#62; &#39;bug_status&#39;});
+
+ my $choice = new Bugzilla::Field::Choice-&#62;type($field)-&#62;new(1);
+
+ my $choices = Bugzilla::Field::Choice-&#62;type($field)-&#62;new_from_list([1,2,3]);
+ my $choices = Bugzilla::Field::Choice-&#62;type($field)-&#62;get_all();
+ my $choices = Bugzilla::Field::Choice-&#62;type($field-&#62;match({ sortkey =&#62; 10 }); </pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This is an implementation of <a href="../../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, but with a twist. You can&#39;t call any class methods (such as <code  class="code">new</code>, <code  class="code">create</code>, etc.) directly on <code  class="code">Bugzilla::Field::Choice</code> itself. Instead, you have to call <code  class="code">Bugzilla::Field::Choice-&#62;type($field)</code> to get the class you&#39;re going to instantiate, and then you call the methods on that.</p>
+
+<p>We do that because each field has its own database table for its values, so each value type needs its own class.</p>
+
+<p>See the <a href="#SYNOPSIS" class="podlinkpod"
+>&#34;SYNOPSIS&#34;</a> for examples of how this works.</p>
+
+<p>This class implements <a href="../../Bugzilla/Field/ChoiceInterface.html" class="podlinkpod"
+>Bugzilla::Field::ChoiceInterface</a>, and so all methods of that class are also available here.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Class_Factory"
+>Class Factory</a></h2>
+
+<p>In object-oriented design, a &#34;class factory&#34; is a method that picks and returns the right class for you, based on an argument that you pass.</p>
+
+<dl>
+<dt><a name="type"
+><code  class="code">type</code></a></dt>
+
+<dd>
+<p>Takes a single argument, which is either the name of a field from the <code  class="code">fielddefs</code> table, or a <a href="../../Bugzilla/Field.html" class="podlinkpod"
+>Bugzilla::Field</a> object representing a field.</p>
+
+<p>Returns an appropriate subclass of <code  class="code">Bugzilla::Field::Choice</code> that you can now call class methods on (like <code  class="code">new</code>, <code  class="code">create</code>, <code  class="code">match</code>, etc.)</p>
+
+<p><b>NOTE</b>: YOU CANNOT CALL CLASS METHODS ON <code  class="code">Bugzilla::Field::Choice</code>. You must call <code  class="code">type</code> to get a class you can call methods on.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Mutators"
+>Mutators</a></h2>
+
+<p>This class implements mutators for all of the settable accessors in <a href="../../Bugzilla/Field/ChoiceInterface.html" class="podlinkpod"
+>Bugzilla::Field::ChoiceInterface</a>.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Field/ChoiceInterface.html b/docs/en/html/api/Bugzilla/Field/ChoiceInterface.html
new file mode 100644 (file)
index 0000000..8d738e0
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Field/ChoiceInterface.html
@@ -0,0 +1,150 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Field::ChoiceInterface</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Field::ChoiceInterface</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Accessors'>Accessors</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Field::ChoiceInterface - Makes an object act like a Bugzilla::Field::Choice.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This is an &#34;interface&#34;,
+in the Java sense (sometimes called a &#34;Role&#34; or a &#34;Mixin&#34; in other languages).
+<a href="../../Bugzilla/Field/Choice.html" class="podlinkpod"
+>Bugzilla::Field::Choice</a> is the primary implementor of this interface,
+but other classes also implement it if they want to &#34;act like&#34; <a href="../../Bugzilla/Field/Choice.html" class="podlinkpod"
+>Bugzilla::Field::Choice</a>.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Accessors"
+>Accessors</a></h2>
+
+<p>These are in addition to the standard <a href="../../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a> accessors.</p>
+
+<dl>
+<dt><a name="sortkey"
+><code  class="code">sortkey</code></a></dt>
+
+<dd>
+<p>The key that determines the sort order of this item.</p>
+
+<dt><a name="field"
+><code  class="code">field</code></a></dt>
+
+<dd>
+<p>The <a href="../../Bugzilla/Field.html" class="podlinkpod"
+>Bugzilla::Field</a> object that this field value belongs to.</p>
+
+<dt><a name="is_active"
+><code  class="code">is_active</code></a></dt>
+
+<dd>
+<p>Whether or not this value should appear as an option on bugs that do not already have it set as the current value.</p>
+
+<dt><a name="is_static"
+><code  class="code">is_static</code></a></dt>
+
+<dd>
+<p><code  class="code">0</code> if this field value can be renamed or deleted,
+<code  class="code">1</code> otherwise.</p>
+
+<dt><a name="is_default"
+><code  class="code">is_default</code></a></dt>
+
+<dd>
+<p><code  class="code">1</code> if this is the default value for this field,
+<code  class="code">0</code> otherwise.</p>
+
+<dt><a name="bug_count"
+><code  class="code">bug_count</code></a></dt>
+
+<dd>
+<p>An integer count of the number of bugs that have this value set.</p>
+
+<dt><a name="controls_visibility_of_fields"
+><code  class="code">controls_visibility_of_fields</code></a></dt>
+
+<dd>
+<p>Returns an arrayref of <a href="../../Bugzilla/Field.html" class="podlinkpod"
+>Bugzilla::Field</a> objects,
+representing any fields whose visibility are controlled by this field value.</p>
+
+<dt><a name="controlled_values"
+><code  class="code">controlled_values</code></a></dt>
+
+<dd>
+<p>Tells you which values in <b>other</b> fields appear (become visible) when this value is set in its field.</p>
+
+<p>Returns a hashref of arrayrefs.
+The hash keys are the names of fields,
+and the values are arrays of objects that implement <code  class="code">Bugzilla::Field::ChoiceInterface</code>,
+representing values that this value controls the visibility of,
+for that field.</p>
+
+<dt><a name="visibility_value"
+><code  class="code">visibility_value</code></a></dt>
+
+<dd>
+<p>Returns an object that implements <code  class="code">Bugzilla::Field::ChoiceInterface</code>,
+which represents the value that needs to be set in order for this value to appear in the UI.</p>
+
+<dt><a name="is_visible_on_bug"
+><code  class="code">is_visible_on_bug</code></a></dt>
+
+<dd>
+<p>Returns <code  class="code">1</code> if,
+according to the settings of <code  class="code">is_active</code> and <code  class="code">visibility_value</code>,
+this value should be displayed as an option when viewing a bug.
+Returns <code  class="code">0</code> otherwise.</p>
+
+<p>Takes a single argument,
+a <a href="../../Bugzilla/Bug.html" class="podlinkpod"
+>Bugzilla::Bug</a> object or a hash with similar fields to a <a href="../../Bugzilla/Bug.html" class="podlinkpod"
+>Bugzilla::Bug</a> object.</p>
+
+<dt><a name="is_set_on_bug"
+><code  class="code">is_set_on_bug</code></a></dt>
+
+<dd>
+<p>Returns <code  class="code">1</code> if this value is the current value set for its field on the passed-in <a href="../../Bugzilla/Bug.html" class="podlinkpod"
+>Bugzilla::Bug</a> object (or a hash that looks like a <a href="../../Bugzilla/Bug.html" class="podlinkpod"
+>Bugzilla::Bug</a>).
+For multi-valued fields,
+we return <code  class="code">1</code> if <i>any</i> of the currently selected values are this value.</p>
+
+<p>Returns <code  class="code">0</code> otherwise.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Flag.html b/docs/en/html/api/Bugzilla/Flag.html
new file mode 100644 (file)
index 0000000..f8092a3
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Flag.html
@@ -0,0 +1,188 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Flag</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Flag</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#NOTES'>NOTES</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#METHODS'>METHODS</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Flag - A module to deal with Bugzilla flag values.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<p>Flag.pm provides an interface to flags as stored in Bugzilla.
+See below for more information.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NOTES"
+>NOTES</a></h1>
+
+<ul>
+<li>Import relevant functions from that script.</li>
+
+<li>Use of private functions / variables outside this module may lead to unexpected results after an upgrade.
+Please avoid using private functions in other files/modules.
+Private functions are functions whose names start with _ or a re specifically noted as being private.</li>
+</ul>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h2>
+
+<dl>
+<dt><a name="id"
+><code  class="code">id</code></a></dt>
+
+<dd>
+<p>Returns the ID of the flag.</p>
+
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p>Returns the name of the flagtype the flag belongs to.</p>
+
+<dt><a name="bug_id"
+><code  class="code">bug_id</code></a></dt>
+
+<dd>
+<p>Returns the ID of the bug this flag belongs to.</p>
+
+<dt><a name="attach_id"
+><code  class="code">attach_id</code></a></dt>
+
+<dd>
+<p>Returns the ID of the attachment this flag belongs to,
+if any.</p>
+
+<dt><a name="status"
+><code  class="code">status</code></a></dt>
+
+<dd>
+<p>Returns the status &#39;+&#39;,
+&#39;-&#39;,
+&#39;?&#39; of the flag.</p>
+
+<dt><a name="creation_date"
+><code  class="code">creation_date</code></a></dt>
+
+<dd>
+<p>Returns the timestamp when the flag was created.</p>
+
+<dt><a name="modification_date"
+><code  class="code">modification_date</code></a></dt>
+
+<dd>
+<p>Returns the timestamp when the flag was last modified.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="type"
+><code  class="code">type</code></a></dt>
+
+<dd>
+<p>Returns the type of the flag,
+as a Bugzilla::FlagType object.</p>
+
+<dt><a name="setter"
+><code  class="code">setter</code></a></dt>
+
+<dd>
+<p>Returns the user who set the flag,
+as a Bugzilla::User object.</p>
+
+<dt><a name="requestee"
+><code  class="code">requestee</code></a></dt>
+
+<dd>
+<p>Returns the user who has been requested to set the flag,
+as a Bugzilla::User object.</p>
+
+<dt><a name="attachment"
+><code  class="code">attachment</code></a></dt>
+
+<dd>
+<p>Returns the attachment object the flag belongs to if the flag is an attachment flag,
+else undefined.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="match($criteria)"
+><code  class="code">match($criteria)</code></a></dt>
+
+<dd>
+<p>Queries the database for flags matching the given criteria (specified as a hash of field names and their matching values) and returns an array of matching records.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="count($criteria)"
+><code  class="code">count($criteria)</code></a></dt>
+
+<dd>
+<p>Queries the database for flags matching the given criteria (specified as a hash of field names and their matching values) and returns an array of matching records.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="create($flag,_$timestamp)"
+><code  class="code">create($flag,
+$timestamp)</code></a></dt>
+
+<dd>
+<p>Creates a flag record in the database.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="extract_flags_from_cgi($bug,_$attachment,_$hr_vars)"
+><code  class="code">extract_flags_from_cgi($bug,
+$attachment,
+$hr_vars)</code></a></dt>
+
+<dd>
+<p>Checks whether or not there are new flags to create and returns an array of hashes.
+This array is then passed to Flag::create().</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="notify($flag,_$old_flag,_$object,_$timestamp)"
+><code  class="code">notify($flag,
+$old_flag,
+$object,
+$timestamp)</code></a></dt>
+
+<dd>
+<p>Sends an email notification about a flag being created,
+fulfilled or deleted.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/FlagType.html b/docs/en/html/api/Bugzilla/FlagType.html
new file mode 100644 (file)
index 0000000..9c1c688
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/FlagType.html
@@ -0,0 +1,195 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::FlagType</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::FlagType</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#NOTES'>NOTES</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#METHODS'>METHODS</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#PUBLIC_FUNCTIONS%2FMETHODS'>PUBLIC FUNCTIONS/METHODS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::FlagType - A module to deal with Bugzilla flag types.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<p>FlagType.pm provides an interface to flag types as stored in Bugzilla.
+See below for more information.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NOTES"
+>NOTES</a></h1>
+
+<ul>
+<li>Use of private functions/variables outside this module may lead to unexpected results after an upgrade.
+Please avoid using private functions in other files/modules.
+Private functions are functions whose names start with _ or are specifically noted as being private.</li>
+</ul>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h2>
+
+<dl>
+<dt><a name="id"
+><code  class="code">id</code></a></dt>
+
+<dd>
+<p>Returns the ID of the flagtype.</p>
+
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p>Returns the name of the flagtype.</p>
+
+<dt><a name="description"
+><code  class="code">description</code></a></dt>
+
+<dd>
+<p>Returns the description of the flagtype.</p>
+
+<dt><a name="cc_list"
+><code  class="code">cc_list</code></a></dt>
+
+<dd>
+<p>Returns the concatenated CC list for the flagtype,
+as a single string.</p>
+
+<dt><a name="target_type"
+><code  class="code">target_type</code></a></dt>
+
+<dd>
+<p>Returns whether the flagtype applies to bugs or attachments.</p>
+
+<dt><a name="is_active"
+><code  class="code">is_active</code></a></dt>
+
+<dd>
+<p>Returns whether the flagtype is active or disabled.
+Flags being in a disabled flagtype are not deleted.
+It only prevents you from adding new flags to it.</p>
+
+<dt><a name="is_requestable"
+><code  class="code">is_requestable</code></a></dt>
+
+<dd>
+<p>Returns whether you can request for the given flagtype (i.e.
+whether the &#39;?&#39; flag is available or not).</p>
+
+<dt><a name="is_requesteeble"
+><code  class="code">is_requesteeble</code></a></dt>
+
+<dd>
+<p>Returns whether you can ask someone specifically or not.</p>
+
+<dt><a name="is_multiplicable"
+><code  class="code">is_multiplicable</code></a></dt>
+
+<dd>
+<p>Returns whether you can have more than one flag for the given flagtype in a given bug/attachment.</p>
+
+<dt><a name="sortkey"
+><code  class="code">sortkey</code></a></dt>
+
+<dd>
+<p>Returns the sortkey of the flagtype.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="grant_list"
+><code  class="code">grant_list</code></a></dt>
+
+<dd>
+<p>Returns a reference to an array of users who have permission to grant this flag type.
+The arrays are populated with hashrefs containing the login,
+identity and visibility of users.</p>
+
+<dt><a name="grant_group"
+><code  class="code">grant_group</code></a></dt>
+
+<dd>
+<p>Returns the group (as a Bugzilla::Group object) in which a user must be in order to grant or deny a request.</p>
+
+<dt><a name="request_group"
+><code  class="code">request_group</code></a></dt>
+
+<dd>
+<p>Returns the group (as a Bugzilla::Group object) in which a user must be in order to request or clear a flag.</p>
+
+<dt><a name="flag_count"
+><code  class="code">flag_count</code></a></dt>
+
+<dd>
+<p>Returns the number of flags belonging to the flagtype.</p>
+
+<dt><a name="inclusions"
+><code  class="code">inclusions</code></a></dt>
+
+<dd>
+<p>Return a hash of product/component IDs and names explicitly associated with the flagtype.</p>
+
+<dt><a name="exclusions"
+><code  class="code">exclusions</code></a></dt>
+
+<dd>
+<p>Return a hash of product/component IDs and names explicitly excluded from the flagtype.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="PUBLIC_FUNCTIONS/METHODS"
+>PUBLIC FUNCTIONS/METHODS</a></h1>
+
+<dl>
+<dt><a name="get_clusions($id,_$type)"
+><code  class="code">get_clusions($id,
+$type)</code></a></dt>
+
+<dd>
+<p>Return a hash of product/component IDs and names associated with the flagtype: $clusions{&#39;product_name:component_name&#39;} = &#34;product_ID:component_ID&#34;</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="match($criteria)"
+><code  class="code">match($criteria)</code></a></dt>
+
+<dd>
+<p>Queries the database for flag types matching the given criteria and returns a list of matching flagtype objects.</p>
+</dd>
+</dl>
+
+<dl>
+<dt><a name="count($criteria)"
+><code  class="code">count($criteria)</code></a></dt>
+
+<dd>
+<p>Returns the total number of flag types matching the given criteria.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Group.html b/docs/en/html/api/Bugzilla/Group.html
new file mode 100644 (file)
index 0000000..472bbdc
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Group.html
@@ -0,0 +1,214 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Group</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Group</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#SUBROUTINES'>SUBROUTINES</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Group - Bugzilla group class.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">    use Bugzilla::Group;
+
+    my $group = new Bugzilla::Group(1);
+    my $group = new Bugzilla::Group({name =&#62; &#39;AcmeGroup&#39;});
+
+    my $id           = $group-&#62;id;
+    my $name         = $group-&#62;name;
+    my $description  = $group-&#62;description;
+    my $user_reg_exp = $group-&#62;user_reg_exp;
+    my $is_active    = $group-&#62;is_active;
+    my $icon_url     = $group-&#62;icon_url;
+    my $is_active_bug_group = $group-&#62;is_active_bug_group;
+
+    my $group_id = Bugzilla::Group::ValidateGroupName(&#39;admin&#39;, @users);
+    my @groups   = Bugzilla::Group-&#62;get_all;</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Group.pm represents a Bugzilla Group object. It is an implementation of <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, and thus has all the methods that <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a> provides, in addition to any methods documented below.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SUBROUTINES"
+>SUBROUTINES</a></h1>
+
+<dl>
+<dt><a name="create"
+><code  class="code">create</code></a></dt>
+
+<dd>
+<p>Note that in addition to what <a href="../Bugzilla/Object.html#create(%24params)" class="podlinkpod"
+>&#34;create($params)&#34; in Bugzilla::Object</a> normally does, this function also makes the new group be inherited by the <code  class="code">admin</code> group. That is, the <code  class="code">admin</code> group will automatically be a member of this group.</p>
+
+<dt><a name="ValidateGroupName($name,_@users)"
+><code  class="code">ValidateGroupName($name, @users)</code></a></dt>
+
+<dd>
+<p>Description: ValidateGroupName checks to see if ANY of the users in the provided list of user objects can see the named group.</p>
+
+<p>Params: $name - String with the group name. @users - An array with Bugzilla::User objects.</p>
+
+<p>Returns: It returns the group id if successful and undef otherwise.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<dl>
+<dt><a name="check_no_disclose"
+><code  class="code">check_no_disclose</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Throws an error if the user cannot add or remove this group to/from a given bug, but doesn&#39;t specify if this is because the group doesn&#39;t exist, or the user is not allowed to edit this group restriction.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p>This method takes a single hashref as argument, with the following keys:</p>
+
+<dl>
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the group to add or remove.</p>
+
+<dt><a name="bug_id"
+><code  class="code">bug_id</code></a></dt>
+
+<dd>
+<p><code  class="code">integer</code> The ID of the bug to which the group change applies.</p>
+
+<dt><a name="product"
+><code  class="code">product</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the product the bug belongs to.</p>
+
+<dt><a name="action"
+><code  class="code">action</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> Must be either <code  class="code">add</code> or <code  class="code">remove</code>, depending on whether the group must be added or removed from the bug. Any other value will generate an error.</p>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><code  class="code">Returns</code></a></dt>
+
+<dd>
+<p>A <code  class="code">Bugzilla::Group</code> object on success, else an error is thrown.</p>
+</dd>
+</dl>
+
+<dt><a name="check_members_are_visible"
+><code  class="code">check_members_are_visible</code></a></dt>
+
+<dd>
+<p>Throws an error if this group is not visible (according to visibility groups) to the currently-logged-in user.</p>
+
+<dt><a name="check_remove"
+><code  class="code">check_remove</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Determines whether it&#39;s OK to remove this group from the database, and throws an error if it&#39;s not OK.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="test_only"
+><code  class="code">test_only</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> If you want to only check if the group can be deleted <i>at all</i>, under any circumstances, specify <code  class="code">test_only</code> to just do the most basic tests (the other parameters will be ignored in this situation, as those tests won&#39;t be run).</p>
+
+<dt><a name="remove_from_users"
+><code  class="code">remove_from_users</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> True if it would be OK to remove all users who are in this group from this group.</p>
+
+<dt><a name="remove_from_bugs"
+><code  class="code">remove_from_bugs</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> True if it would be OK to remove all bugs that are in this group from this group.</p>
+
+<dt><a name="remove_from_flags"
+><code  class="code">remove_from_flags</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> True if it would be OK to stop all flagtypes that reference this group from referencing this group (e.g., as their grantgroup or requestgroup).</p>
+
+<dt><a name="remove_from_products"
+><code  class="code">remove_from_products</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> True if it would be OK to remove this group from all group controls on products.</p>
+</dd>
+</dl>
+
+<dt><a name="Returns_(nothing)"
+><b>Returns</b> (nothing)</a></dt>
+</dl>
+
+<dt><a name="members_non_inherited"
+><code  class="code">members_non_inherited</code></a></dt>
+
+<dd>
+<p>Returns an arrayref of <a href="../Bugzilla/User.html" class="podlinkpod"
+>Bugzilla::User</a> objects representing people who are &#34;directly&#34; in this group, meaning that they&#39;re in it because they match the group regular expression, or they have been actually added to the group manually.</p>
+
+<dt><a name="flatten_group_membership"
+><code  class="code">flatten_group_membership</code></a></dt>
+
+<dd>
+<p>Accepts a list of groups and returns a list of all the groups whose members inherit membership in any group on the list. So, we can determine if a user is in any of the groups input to flatten_group_membership by querying the user_group_map for any user with DIRECT or REGEXP membership IN() the list of groups returned.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Hook.html b/docs/en/html/api/Bugzilla/Hook.html
new file mode 100644 (file)
index 0000000..42a713f
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Hook.html
@@ -0,0 +1,1643 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Hook</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Hook</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#How_Hooks_Work'>How Hooks Work</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#SUBROUTINES'>SUBROUTINES</a>
+  <li class='indexItem indexItem1'><a href='#HOOKS'>HOOKS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#admin_editusers_action'>admin_editusers_action</a>
+    <li class='indexItem indexItem2'><a href='#attachment_process_data'>attachment_process_data</a>
+    <li class='indexItem indexItem2'><a href='#auth_login_methods'>auth_login_methods</a>
+    <li class='indexItem indexItem2'><a href='#auth_verify_methods'>auth_verify_methods</a>
+    <li class='indexItem indexItem2'><a href='#bug_columns'>bug_columns</a>
+    <li class='indexItem indexItem2'><a href='#bug_end_of_create'>bug_end_of_create</a>
+    <li class='indexItem indexItem2'><a href='#bug_end_of_create_validators'>bug_end_of_create_validators</a>
+    <li class='indexItem indexItem2'><a href='#bug_end_of_update'>bug_end_of_update</a>
+    <li class='indexItem indexItem2'><a href='#bug_check_can_change_field'>bug_check_can_change_field</a>
+    <li class='indexItem indexItem2'><a href='#bug_fields'>bug_fields</a>
+    <li class='indexItem indexItem2'><a href='#bug_format_comment'>bug_format_comment</a>
+    <li class='indexItem indexItem2'><a href='#bug_start_of_update'>bug_start_of_update</a>
+    <li class='indexItem indexItem2'><a href='#bug_url_sub_classes'>bug_url_sub_classes</a>
+    <li class='indexItem indexItem2'><a href='#buglist_columns'>buglist_columns</a>
+    <li class='indexItem indexItem2'><a href='#buglist_column_joins'>buglist_column_joins</a>
+    <li class='indexItem indexItem2'><a href='#search_operator_field_override'>search_operator_field_override</a>
+    <li class='indexItem indexItem2'><a href='#bugmail_recipients'>bugmail_recipients</a>
+    <li class='indexItem indexItem2'><a href='#bugmail_relationships'>bugmail_relationships</a>
+    <li class='indexItem indexItem2'><a href='#config_add_panels'>config_add_panels</a>
+    <li class='indexItem indexItem2'><a href='#config_modify_panels'>config_modify_panels</a>
+    <li class='indexItem indexItem2'><a href='#email_in_before_parse'>email_in_before_parse</a>
+    <li class='indexItem indexItem2'><a href='#email_in_after_parse'>email_in_after_parse</a>
+    <li class='indexItem indexItem2'><a href='#enter_bug_entrydefaultvars'>enter_bug_entrydefaultvars</a>
+    <li class='indexItem indexItem2'><a href='#error_catch'>error_catch</a>
+    <li class='indexItem indexItem2'><a href='#flag_end_of_update'>flag_end_of_update</a>
+    <li class='indexItem indexItem2'><a href='#group_before_delete'>group_before_delete</a>
+    <li class='indexItem indexItem2'><a href='#group_end_of_create'>group_end_of_create</a>
+    <li class='indexItem indexItem2'><a href='#group_end_of_update'>group_end_of_update</a>
+    <li class='indexItem indexItem2'><a href='#install_before_final_checks'>install_before_final_checks</a>
+    <li class='indexItem indexItem2'><a href='#install_filesystem'>install_filesystem</a>
+    <li class='indexItem indexItem2'><a href='#install_update_db'>install_update_db</a>
+    <li class='indexItem indexItem2'><a href='#install_update_db_fielddefs'>install_update_db_fielddefs</a>
+    <li class='indexItem indexItem2'><a href='#db_schema_abstract_schema'>db_schema_abstract_schema</a>
+    <li class='indexItem indexItem2'><a href='#job_map'>job_map</a>
+    <li class='indexItem indexItem2'><a href='#mailer_before_send'>mailer_before_send</a>
+    <li class='indexItem indexItem2'><a href='#object_before_create'>object_before_create</a>
+    <li class='indexItem indexItem2'><a href='#object_before_delete'>object_before_delete</a>
+    <li class='indexItem indexItem2'><a href='#object_before_set'>object_before_set</a>
+    <li class='indexItem indexItem2'><a href='#object_columns'>object_columns</a>
+    <li class='indexItem indexItem2'><a href='#object_end_of_create'>object_end_of_create</a>
+    <li class='indexItem indexItem2'><a href='#object_end_of_create_validators'>object_end_of_create_validators</a>
+    <li class='indexItem indexItem2'><a href='#object_end_of_set'>object_end_of_set</a>
+    <li class='indexItem indexItem2'><a href='#object_end_of_set_all'>object_end_of_set_all</a>
+    <li class='indexItem indexItem2'><a href='#object_end_of_update'>object_end_of_update</a>
+    <li class='indexItem indexItem2'><a href='#object_update_columns'>object_update_columns</a>
+    <li class='indexItem indexItem2'><a href='#object_validators'>object_validators</a>
+    <li class='indexItem indexItem2'><a href='#page_before_template'>page_before_template</a>
+    <li class='indexItem indexItem2'><a href='#path_info_whitelist'>path_info_whitelist</a>
+    <li class='indexItem indexItem2'><a href='#post_bug_after_creation'>post_bug_after_creation</a>
+    <li class='indexItem indexItem2'><a href='#product_confirm_delete'>product_confirm_delete</a>
+    <li class='indexItem indexItem2'><a href='#product_end_of_create'>product_end_of_create</a>
+    <li class='indexItem indexItem2'><a href='#quicksearch_map'>quicksearch_map</a>
+    <li class='indexItem indexItem2'><a href='#sanitycheck_check'>sanitycheck_check</a>
+    <li class='indexItem indexItem2'><a href='#sanitycheck_repair'>sanitycheck_repair</a>
+    <li class='indexItem indexItem2'><a href='#template_before_create'>template_before_create</a>
+    <li class='indexItem indexItem2'><a href='#template_before_process'>template_before_process</a>
+    <li class='indexItem indexItem2'><a href='#user_preferences'>user_preferences</a>
+    <li class='indexItem indexItem2'><a href='#webservice'>webservice</a>
+    <li class='indexItem indexItem2'><a href='#webservice_error_codes'>webservice_error_codes</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#SEE_ALSO'>SEE ALSO</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Hook - Extendable extension hooks for Bugzilla code</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> use Bugzilla::Hook;
+
+ Bugzilla::Hook::process(&#34;hookname&#34;, { arg =&#62; $value, arg2 =&#62; $value2 });</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Bugzilla allows extension modules to drop in and add routines at arbitrary points in Bugzilla code. These points are referred to as hooks. When a piece of standard Bugzilla code wants to allow an extension to perform additional functions, it uses Bugzilla::Hook&#39;s <a href="#process" class="podlinkpod"
+>&#34;process&#34;</a> subroutine to invoke any extension code if installed.</p>
+
+<p>The implementation of extensions is described in <a href="../Bugzilla/Extension.html" class="podlinkpod"
+>Bugzilla::Extension</a>.</p>
+
+<p>There is sample code for every hook in the Example extension, located in <em  class="code">extensions/Example/Extension.pm</em>.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="How_Hooks_Work"
+>How Hooks Work</a></h2>
+
+<p>When a hook named <code  class="code">HOOK_NAME</code> is run, Bugzilla looks through all enabled <a href="../Bugzilla/Extension.html" class="podlinkpod"
+>extensions</a> for extensions that implement a subroutine named <code  class="code">HOOK_NAME</code>.</p>
+
+<p>See <a href="../Bugzilla/Extension.html" class="podlinkpod"
+>Bugzilla::Extension</a> for more details about how an extension can run code during a hook.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SUBROUTINES"
+>SUBROUTINES</a></h1>
+
+<dl>
+<dt><a name="process"
+><code  class="code">process</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Invoke any code hooks with a matching name from any installed extensions.</p>
+
+<p>See <a href="../Bugzilla/Extension.html" class="podlinkpod"
+>Bugzilla::Extension</a> for more information on Bugzilla&#39;s extension mechanism.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$name_-_The_name_of_the_hook_to_invoke."
+><code  class="code">$name</code> - The name of the hook to invoke.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">$args</code> - A hashref. The named args to pass to the hook. They will be passed as arguments to the hook method in the extension.</a></dt>
+</dl>
+
+<dt><a name="Returns_(nothing)"
+><b>Returns</b> (nothing)</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="HOOKS"
+>HOOKS</a></h1>
+
+<p>This describes what hooks exist in Bugzilla currently. They are mostly in alphabetical order, but some related hooks are near each other instead of being alphabetical.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="admin_editusers_action"
+>admin_editusers_action</a></h2>
+
+<p>This hook allows you to add additional actions to the admin Users page.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="vars"
+><code  class="code">vars</code></a></dt>
+
+<dd>
+<p>You can add as many new key/value pairs as you want to this hashref. It will be passed to the template.</p>
+
+<dt><a name="action"
+><code  class="code">action</code></a></dt>
+
+<dd>
+<p>A text which indicates the different behaviors that editusers.cgi will have. With this hook you can change the behavior of an action or add new actions.</p>
+
+<dt><a name="user"
+><code  class="code">user</code></a></dt>
+
+<dd>
+<p>This is a Bugzilla::User object of the user.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="attachment_process_data"
+>attachment_process_data</a></h2>
+
+<p>This happens at the very beginning process of the attachment creation. You can edit the attachment content itself as well as all attributes of the attachment, before they are validated and inserted into the DB.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a 
+><code  class="code">data</code> - A reference pointing either to the content of the file being uploaded or pointing to the filehandle associated with the file.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">attributes</code> - A hashref whose keys are the same as the input to <a href="../Bugzilla/Attachment.html#create" class="podlinkpod"
+>&#34;create&#34; in Bugzilla::Attachment</a>. The data in this hashref hasn&#39;t been validated yet.</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="auth_login_methods"
+>auth_login_methods</a></h2>
+
+<p>This allows you to add new login types to Bugzilla. (See <a href="../Bugzilla/Auth/Login.html" class="podlinkpod"
+>Bugzilla::Auth::Login</a>.)</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="modules"
+><code  class="code">modules</code></a></dt>
+
+<dd>
+<p>This is a hash--a mapping from login-type &#34;names&#34; to the actual module on disk. The keys will be all the values that were passed to <a href="../Bugzilla/Auth.html#login" class="podlinkpod"
+>&#34;login&#34; in Bugzilla::Auth</a> for the <code  class="code">Login</code> parameter. The values are the actual path to the module on disk. (For example, if the key is <code  class="code">DB</code>, the value is <em  class="code">Bugzilla/Auth/Login/DB.pm</em>.)</p>
+
+<p>For your extension, the path will start with <em  class="code">Bugzilla/Extension/Foo/</em>, where &#34;Foo&#34; is the name of your Extension. (See the code in the example extension.)</p>
+
+<p>If your login type is in the hash as a key, you should set that key to the right path to your module. That module&#39;s <code  class="code">new</code> method will be called, probably with empty parameters. If your login type is <i>not</i> in the hash, you should not set it.</p>
+
+<p>You will be prevented from adding new keys to the hash, so make sure your key is in there before you modify it. (In other words, you can&#39;t add in login methods that weren&#39;t passed to <a href="../Bugzilla/Auth.html#login" class="podlinkpod"
+>&#34;login&#34; in Bugzilla::Auth</a>.)</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="auth_verify_methods"
+>auth_verify_methods</a></h2>
+
+<p>This works just like <a href="#auth_login_methods" class="podlinkpod"
+>&#34;auth_login_methods&#34;</a> except it&#39;s for login verification methods (See <a href="../Bugzilla/Auth/Verify.html" class="podlinkpod"
+>Bugzilla::Auth::Verify</a>.) It also takes a <code  class="code">modules</code> parameter, just like <a href="#auth_login_methods" class="podlinkpod"
+>&#34;auth_login_methods&#34;</a>.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="bug_columns"
+>bug_columns</a></h2>
+
+<p><b>DEPRECATED</b> Use <a href="#object_columns" class="podlinkpod"
+>&#34;object_columns&#34;</a> instead.</p>
+
+<p>This allows you to add new fields that will show up in every <a href="../Bugzilla/Bug.html" class="podlinkpod"
+>Bugzilla::Bug</a> object. Note that you will also need to use the <a href="#bug_fields" class="podlinkpod"
+>&#34;bug_fields&#34;</a> hook in conjunction with this hook to make this work.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="columns_-_An_arrayref_containing_an_array_of_column_names._Push_your_column_name(s)_onto_the_array."
+><code  class="code">columns</code> - An arrayref containing an array of column names. Push your column name(s) onto the array.</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="bug_end_of_create"
+>bug_end_of_create</a></h2>
+
+<p>This happens at the end of <a href="../Bugzilla/Bug.html#create" class="podlinkpod"
+>&#34;create&#34; in Bugzilla::Bug</a>, after all other changes are made to the database. This occurs inside a database transaction.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="bug_-_The_created_bug_object."
+><code  class="code">bug</code> - The created bug object.</a></dt>
+
+<dd>
+<dt><a name="timestamp_-_The_timestamp_used_for_all_updates_in_this_transaction,_as_a_SQL_date_string."
+><code  class="code">timestamp</code> - The timestamp used for all updates in this transaction, as a SQL date string.</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="bug_end_of_create_validators"
+>bug_end_of_create_validators</a></h2>
+
+<p>This happens during <a href="../Bugzilla/Bug.html#create" class="podlinkpod"
+>&#34;create&#34; in Bugzilla::Bug</a>, after all parameters have been validated, but before anything has been inserted into the database.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="params"
+><code  class="code">params</code></a></dt>
+
+<dd>
+<p>A hashref. The validated parameters passed to <code  class="code">create</code>.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="bug_end_of_update"
+>bug_end_of_update</a></h2>
+
+<p>This happens at the end of <a href="../Bugzilla/Bug.html#update" class="podlinkpod"
+>&#34;update&#34; in Bugzilla::Bug</a>, after all other changes are made to the database. This generally occurs inside a database transaction.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="bug"
+><code  class="code">bug</code></a></dt>
+
+<dd>
+<p>The changed bug object, with all fields set to their updated values.</p>
+
+<dt><a name="old_bug"
+><code  class="code">old_bug</code></a></dt>
+
+<dd>
+<p>A bug object pulled from the database before the fields were set to their updated values (so it has the old values available for each field).</p>
+
+<dt><a name="timestamp"
+><code  class="code">timestamp</code></a></dt>
+
+<dd>
+<p>The timestamp used for all updates in this transaction, as a SQL date string.</p>
+
+<dt><a name="changes"
+><code  class="code">changes</code></a></dt>
+
+<dd>
+<p>The hash of changed fields. <code  class="code">$changes-&#62;{field} = [old, new]</code></p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="bug_check_can_change_field"
+>bug_check_can_change_field</a></h2>
+
+<p>This hook controls what fields users are allowed to change. You can add code here for site-specific policy changes and other customizations.</p>
+
+<p>This hook is only executed if the field&#39;s new and old values differ.</p>
+
+<p>Any denies take priority over any allows. So, if another extension denies a change but yours allows the change, the other extension&#39;s deny will override your extension&#39;s allow.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="bug"
+><code  class="code">bug</code></a></dt>
+
+<dd>
+<p><a href="../Bugzilla/Bug.html" class="podlinkpod"
+>Bugzilla::Bug</a> - The current bug object that this field is changing on.</p>
+
+<dt><a name="field"
+><code  class="code">field</code></a></dt>
+
+<dd>
+<p>The name (from the <code  class="code">fielddefs</code> table) of the field that we are checking.</p>
+
+<dt><a name="new_value"
+><code  class="code">new_value</code></a></dt>
+
+<dd>
+<p>The new value that the field is being changed to.</p>
+
+<dt><a name="old_value"
+><code  class="code">old_value</code></a></dt>
+
+<dd>
+<p>The old value that the field is being changed from.</p>
+
+<dt><a name="priv_results"
+><code  class="code">priv_results</code></a></dt>
+
+<dd>
+<p><code  class="code">array</code> - This is how you explicitly allow or deny a change. You should only push something into this array if you want to explicitly allow or explicitly deny the change, and thus skip all other permission checks that would otherwise happen after this hook is called. If you don&#39;t care about the field change, then don&#39;t push anything into the array.</p>
+
+<p>The pushed value should be a choice from the following constants:</p>
+
+<dl>
+<dt><a name="PRIVILEGES_REQUIRED_NONE"
+><code  class="code">PRIVILEGES_REQUIRED_NONE</code></a></dt>
+
+<dd>
+<p>No privileges required. This explicitly <b>allows</b> a change.</p>
+
+<dt><a name="PRIVILEGES_REQUIRED_REPORTER"
+><code  class="code">PRIVILEGES_REQUIRED_REPORTER</code></a></dt>
+
+<dd>
+<p>User is not the reporter, assignee or an empowered user, so <b>deny</b>.</p>
+
+<dt><a name="PRIVILEGES_REQUIRED_ASSIGNEE"
+><code  class="code">PRIVILEGES_REQUIRED_ASSIGNEE</code></a></dt>
+
+<dd>
+<p>User is not the assignee or an empowered user, so <b>deny</b>.</p>
+
+<dt><a name="PRIVILEGES_REQUIRED_EMPOWERED"
+><code  class="code">PRIVILEGES_REQUIRED_EMPOWERED</code></a></dt>
+
+<dd>
+<p>User is not a sufficiently empowered user, so <b>deny</b>.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="bug_fields"
+>bug_fields</a></h2>
+
+<p>Allows the addition of database fields from the bugs table to the standard list of allowable fields in a <a href="../Bugzilla/Bug.html" class="podlinkpod"
+>Bugzilla::Bug</a> object, so that you can call the field as a method.</p>
+
+<p>Note: You should add here the names of any fields you added in <a href="#bug_columns" class="podlinkpod"
+>&#34;bug_columns&#34;</a>.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="columns_-_A_arrayref_containing_an_array_of_column_names._Push_your_column_name(s)_onto_the_array."
+><code  class="code">columns</code> - A arrayref containing an array of column names. Push your column name(s) onto the array.</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="bug_format_comment"
+>bug_format_comment</a></h2>
+
+<p>Allows you to do custom parsing on comments before they are displayed. You do this by returning two regular expressions: one that matches the section you want to replace, and then another that says what you want to replace that match with.</p>
+
+<p>The matching and replacement will be run with the <code  class="code">/g</code> switch on the regex.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="regexes"
+><code  class="code">regexes</code></a></dt>
+
+<dd>
+<p>An arrayref of hashrefs.</p>
+
+<p>You should push a hashref containing two keys (<code  class="code">match</code> and <code  class="code">replace</code>) in to this array. <code  class="code">match</code> is the regular expression that matches the text you want to replace, <code  class="code">replace</code> is what you want to replace that text with. (This gets passed into a regular expression like <code  class="code">s/$match/$replace/</code>.)</p>
+
+<p>Instead of specifying a regular expression for <code  class="code">replace</code> you can also return a coderef (a reference to a subroutine). If you want to use backreferences (using <code  class="code">$1</code>, <code  class="code">$2</code>, etc. in your <code  class="code">replace</code>), you have to use this method--it won&#39;t work if you specify <code  class="code">$1</code>, <code  class="code">$2</code> in a regular expression for <code  class="code">replace</code>. Your subroutine will get a hashref as its only argument. This hashref contains a single key, <code  class="code">matches</code>. <code  class="code">matches</code> is an arrayref that contains <code  class="code">$1</code>, <code  class="code">$2</code>, <code  class="code">$3</code>, etc. in order, up to <code  class="code">$10</code>. Your subroutine should return what you want to replace the full <code  class="code">match</code> with. (See the code example for this hook if you want to see how this actually all works in code. It&#39;s simpler than it sounds.)</p>
+
+<p><b>You are responsible for HTML-escaping your returned data.</b> Failing to do so could open a security hole in Bugzilla.</p>
+
+<dt><a name="text"
+><code  class="code">text</code></a></dt>
+
+<dd>
+<p>A <b>reference</b> to the exact text that you are parsing.</p>
+
+<p>Generally you should not modify this yourself. Instead you should be returning regular expressions using the <code  class="code">regexes</code> array.</p>
+
+<p>The text has not been parsed in any way. (So, for example, it is not HTML-escaped. You get &#34;&#38;&#34;, not &#34;&#38;amp;&#34;.)</p>
+
+<dt><a name="bug"
+><code  class="code">bug</code></a></dt>
+
+<dd>
+<p>The <a href="../Bugzilla/Bug.html" class="podlinkpod"
+>Bugzilla::Bug</a> object that this comment is on. Sometimes this is <code  class="code">undef</code>, meaning that we are parsing text that is not on a bug.</p>
+
+<dt><a name="comment"
+><code  class="code">comment</code></a></dt>
+
+<dd>
+<p>A <a href="../Bugzilla/Comment.html" class="podlinkpod"
+>Bugzilla::Comment</a> object representing the comment you are about to parse.</p>
+
+<p>Sometimes this is <code  class="code">undef</code>, meaning that we are parsing text that is not a bug comment (but could still be some other part of a bug, like the summary line).</p>
+
+<dt><a name="user"
+><code  class="code">user</code></a></dt>
+
+<dd>
+<p>The <a href="../Bugzilla/User.html" class="podlinkpod"
+>Bugzilla::User</a> object representing the user who will see the text. This is useful to determine how much confidential information can be displayed to the user.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="bug_start_of_update"
+>bug_start_of_update</a></h2>
+
+<p>This happens near the beginning of <a href="../Bugzilla/Bug.html#update" class="podlinkpod"
+>&#34;update&#34; in Bugzilla::Bug</a>, after <a href="../Bugzilla/Object.html#update" class="podlinkpod"
+>&#34;update&#34; in Bugzilla::Object</a> is called, but before all other special changes are made to the database. Once use case is this allows for adding your own entries to the <code  class="code">changes</code> hash which gets added to the bugs_activity table later keeping you from having to do it yourself. Also this is also helpful if your extension needs to add CC members, flags, keywords, groups, etc. This generally occurs inside a database transaction.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="bug"
+><code  class="code">bug</code></a></dt>
+
+<dd>
+<p>The changed bug object, with all fields set to their updated values.</p>
+
+<dt><a name="old_bug"
+><code  class="code">old_bug</code></a></dt>
+
+<dd>
+<p>A bug object pulled from the database before the fields were set to their updated values (so it has the old values available for each field).</p>
+
+<dt><a name="timestamp"
+><code  class="code">timestamp</code></a></dt>
+
+<dd>
+<p>The timestamp used for all updates in this transaction, as a SQL date string.</p>
+
+<dt><a name="changes"
+><code  class="code">changes</code></a></dt>
+
+<dd>
+<p>The hash of changed fields. <code  class="code">$changes-&#62;{field} = [old, new]</code></p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="bug_url_sub_classes"
+>bug_url_sub_classes</a></h2>
+
+<p>Allows you to add more <a href="../Bugzilla/BugUrl.html" class="podlinkpod"
+>Bugzilla::BugUrl</a> sub-classes.</p>
+
+<p>See the <code  class="code">MoreBugUrl</code> extension to see how things work.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="sub_classes_-_An_arrayref_of_strings_which_represent_Bugzilla::BugUrl_sub-classes."
+><code  class="code">sub_classes</code> - An arrayref of strings which represent <a href="../Bugzilla/BugUrl.html" class="podlinkpod"
+>Bugzilla::BugUrl</a> sub-classes.</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="buglist_columns"
+>buglist_columns</a></h2>
+
+<p>This happens in <a href="../Bugzilla/Search.html#COLUMNS" class="podlinkpod"
+>&#34;COLUMNS&#34; in Bugzilla::Search</a>, which determines legal bug list columns for <em  class="code">buglist.cgi</em> and <em  class="code">colchange.cgi</em>. It gives you the opportunity to add additional display columns.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a 
+><code  class="code">columns</code> - A hashref, where the keys are unique string identifiers for the column being defined and the values are hashrefs with the following fields:</a></dt>
+
+<dd>
+<dl>
+<dt><a name="name_-_The_name_of_the_column_in_the_database."
+><code  class="code">name</code> - The name of the column in the database.</a></dt>
+
+<dd>
+<dt><a name="title_-_The_title_of_the_column_as_displayed_to_users."
+><code  class="code">title</code> - The title of the column as displayed to users.</a></dt>
+</dl>
+
+<p>The definition is structured as:</p>
+
+<pre  class="code"> $columns-&#62;{$id} = { name =&#62; $name, title =&#62; $title };</pre>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="buglist_column_joins"
+>buglist_column_joins</a></h2>
+
+<p>This allows you to join additional tables to display additional columns in buglists. This hook is generally used in combination with the <code  class="code">buglist_columns</code> hook.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a 
+><code  class="code">column_joins</code> - A hashref containing data to return back to <a href="../Bugzilla/Search.html" class="podlinkpod"
+>Bugzilla::Search</a>. This hashref contains names of the columns as keys and a hashref about table to join as values. This hashref has the following keys:</a></dt>
+
+<dd>
+<dl>
+<dt><a name="table_-_The_name_of_the_additional_table_to_join."
+><code  class="code">table</code> - The name of the additional table to join.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">as</code> - (optional) The alias used for the additional table. This alias must not conflict with an existing alias already used in the query.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">from</code> - (optional) The name of the column in the <code  class="code">bugs</code> table which the additional table should be linked to. If omitted, <code  class="code">bug_id</code> will be used.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">to</code> - (optional) The name of the column in the additional table which should be linked to the column in the <code  class="code">bugs</code> table, see <code  class="code">from</code> above. If omitted, <code  class="code">bug_id</code> will be used.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">join</code> - (optional) Either INNER or LEFT. Determine how the additional table should be joined with the <code  class="code">bugs</code> table. If omitted, LEFT is used.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="search_operator_field_override"
+>search_operator_field_override</a></h2>
+
+<p>This allows you to modify <a href="../Bugzilla/Search.html#OPERATOR_FIELD_OVERRIDE" class="podlinkpod"
+>&#34;OPERATOR_FIELD_OVERRIDE&#34; in Bugzilla::Search</a>, which determines the search functions for fields. It allows you to specify custom search functionality for certain fields.</p>
+
+<p>See <a href="../Bugzilla/Search.html#OPERATOR_FIELD_OVERRIDE" class="podlinkpod"
+>&#34;OPERATOR_FIELD_OVERRIDE&#34; in Bugzilla::Search</a> for reference and see the code in the example extension.</p>
+
+<p>Note that the interface to this hook is <b>UNSTABLE</b> and it may change in the future.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="operators_-_See_&#34;OPERATOR_FIELD_OVERRIDE&#34;_in_Bugzilla::Search_to_get_an_idea_of_the_structure."
+><code  class="code">operators</code> - See <a href="../Bugzilla/Search.html#OPERATOR_FIELD_OVERRIDE" class="podlinkpod"
+>&#34;OPERATOR_FIELD_OVERRIDE&#34; in Bugzilla::Search</a> to get an idea of the structure.</a></dt>
+
+<dd>
+<dt><a name="search_-_The_Bugzilla::Search_object."
+><code  class="code">search</code> - The <a href="../Bugzilla/Search.html" class="podlinkpod"
+>Bugzilla::Search</a> object.</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="bugmail_recipients"
+>bugmail_recipients</a></h2>
+
+<p>This allows you to modify the list of users who are going to be receiving a particular bugmail. It also allows you to specify why they are receiving the bugmail.</p>
+
+<p>Users&#39; bugmail preferences will be applied to any users that you add to the list. (So, for example, if you add somebody as though they were a CC on the bug, and their preferences state that they don&#39;t get email when they are a CC, they won&#39;t get email.)</p>
+
+<p>This hook is called before watchers or globalwatchers are added to the recipient list.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="bug"
+><code  class="code">bug</code></a></dt>
+
+<dd>
+<p>The <a href="../Bugzilla/Bug.html" class="podlinkpod"
+>Bugzilla::Bug</a> that bugmail is being sent about.</p>
+
+<dt><a name="recipients"
+><code  class="code">recipients</code></a></dt>
+
+<dd>
+<p>This is a hashref. The keys are numeric user ids from the <code  class="code">profiles</code> table in the database, for each user who should be receiving this bugmail. The values are hashrefs. The keys in <i>these</i> hashrefs correspond to the &#34;relationship&#34; that the user has to the bug they&#39;re being emailed about, and the value should always be <code  class="code">1</code>. The &#34;relationships&#34; are described by the various <code  class="code">REL_</code> constants in <a href="../Bugzilla/Constants.html" class="podlinkpod"
+>Bugzilla::Constants</a>.</p>
+
+<p>Here&#39;s an example of adding userid <code  class="code">123</code> to the recipient list as though he were on the CC list:</p>
+
+<pre  class="code"> $recipients-&#62;{123}-&#62;{+REL_CC} = 1</pre>
+
+<p>(We use <code  class="code">+</code> in front of <code  class="code">REL_CC</code> so that Perl interprets it as a constant instead of as a string.)</p>
+
+<dt><a name="users"
+><code  class="code">users</code></a></dt>
+
+<dd>
+<p>This is a hash of <a href="../Bugzilla/User.html" class="podlinkpod"
+>Bugzilla::User</a> objects, keyed by id. This is so you can find out more information about any of the user ids in the <code  class="code">recipients</code> hash. Every id in the incoming <code  class="code">recipients</code> hash will have an object in here. (But if you add additional recipients to the <code  class="code">recipients</code> hash, you are <b>not</b> required to add them to this hash.)</p>
+
+<dt><a name="diffs"
+><code  class="code">diffs</code></a></dt>
+
+<dd>
+<p>This is a list of hashes, each hash representing a change to the bug. Each hash has the following members: <code  class="code">field_name</code>, <code  class="code">bug_when</code>, <code  class="code">old</code>, <code  class="code">new</code> and <code  class="code">who</code> (a <a href="../Bugzilla/User.html" class="podlinkpod"
+>Bugzilla::User</a>). If appropriate, there will also be <code  class="code">attach_id</code> or <code  class="code">comment_id</code>; if either is present, there will be <code  class="code">isprivate</code>. See <code  class="code">_get_diffs</code> in <em  class="code">Bugzilla/BugMail.pm</em> to see exactly how it is populated. Warning: the format and existence of the &#34;diffs&#34; parameter is subject to change in future releases of Bugzilla.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="bugmail_relationships"
+>bugmail_relationships</a></h2>
+
+<p>There are various sorts of &#34;relationships&#34; that a user can have to a bug, such as Assignee, CC, etc. If you want to add a new type of relationship, you should use this hook.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="relationships"
+><code  class="code">relationships</code></a></dt>
+
+<dd>
+<p>A hashref, where the keys are numbers and the values are strings.</p>
+
+<p>The keys represent a numeric identifier for the relationship. The numeric identifier should be a negative number between -1 and -127. The number must be unique across all extensions. (Negative numbers are used so as not to conflict with relationship identifiers in Bugzilla itself.)</p>
+
+<p>The value is the &#34;name&#34; of this relationship that will show up in email headers in bugmails. The &#34;name&#34; should be short and should contain no spaces.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="config_add_panels"
+>config_add_panels</a></h2>
+
+<p>If you want to add new panels to the Parameters administrative interface, this is where you do it.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="panel_modules"
+><code  class="code">panel_modules</code></a></dt>
+
+<dd>
+<p>A hashref, where the keys are the &#34;name&#34; of the panel and the value is the Perl module representing that panel. For example, if the name is <code  class="code">Auth</code>, the value would be <code  class="code">Bugzilla::Config::Auth</code>.</p>
+
+<p>For your extension, the Perl module would start with <code  class="code">Bugzilla::Extension::Foo</code>, where &#34;Foo&#34; is the name of your Extension. (See the code in the example extension.)</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="config_modify_panels"
+>config_modify_panels</a></h2>
+
+<p>This is how you modify already-existing panels in the Parameters administrative interface. For example, if you wanted to add a new Auth method (modifying Bugzilla::Config::Auth) this is how you&#39;d do it.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="panels"
+><code  class="code">panels</code></a></dt>
+
+<dd>
+<p>A hashref, where the keys are lower-case panel &#34;names&#34; (like <code  class="code">auth</code>, <code  class="code">admin</code>, etc.) and the values are hashrefs. The hashref contains a single key, <code  class="code">params</code>. <code  class="code">params</code> is an arrayref--the return value from <code  class="code">get_param_list</code> for that module. You can modify <code  class="code">params</code> and your changes will be reflected in the interface.</p>
+
+<p>Adding new keys to <code  class="code">panels</code> will have no effect. You should use <a href="#config_add_panels" class="podlinkpod"
+>&#34;config_add_panels&#34;</a> if you want to add new panels.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="email_in_before_parse"
+>email_in_before_parse</a></h2>
+
+<p>This happens right after an inbound email is converted into an Email::MIME object, but before we start parsing the email to extract field data. This means the email has already been decoded for you. It gives you a chance to interact with the email itself before <a href="../email_in.html" class="podlinkpod"
+>email_in</a> starts parsing its content.</p>
+
+<dl>
+<dt><a name="mail_-_An_Email::MIME_object._The_decoded_incoming_email."
+><code  class="code">mail</code> - An Email::MIME object. The decoded incoming email.</a></dt>
+
+<dd>
+<dt><a name="fields_-_A_hashref._The_hash_which_will_contain_extracted_data."
+><code  class="code">fields</code> - A hashref. The hash which will contain extracted data.</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="email_in_after_parse"
+>email_in_after_parse</a></h2>
+
+<p>This happens after all the data has been extracted from the email, but before the reporter is validated, during <a href="../email_in.html" class="podlinkpod"
+>email_in</a>. This lets you do things after the normal parsing of the email, such as sanitizing field data, changing the user account being used to file a bug, etc.</p>
+
+<dl>
+<dt><a name="fields_-_A_hashref._The_hash_containing_the_extracted_field_data."
+><code  class="code">fields</code> - A hashref. The hash containing the extracted field data.</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="enter_bug_entrydefaultvars"
+>enter_bug_entrydefaultvars</a></h2>
+
+<p><b>DEPRECATED</b> - Use <a href="#template_before_process" class="podlinkpod"
+>&#34;template_before_process&#34;</a> instead.</p>
+
+<p>This happens right before the template is loaded on enter_bug.cgi.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="vars_-_A_hashref._The_variables_that_will_be_passed_into_the_template."
+><code  class="code">vars</code> - A hashref. The variables that will be passed into the template.</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="error_catch"
+>error_catch</a></h2>
+
+<p>This hook allows extensions to catch errors thrown by Bugzilla and take the appropriate actions.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="error"
+><code  class="code">error</code></a></dt>
+
+<dd>
+<p>A string representing the error code thrown by Bugzilla. This string matches the <code  class="code">error</code> variable in <code  class="code">global/user-error.html.tmpl</code> and <code  class="code">global/code-error.html.tmpl</code>.</p>
+
+<dt><a name="message"
+><code  class="code">message</code></a></dt>
+
+<dd>
+<p>If the error mode is set to <code  class="code">ERROR_MODE_WEBPAGE</code>, you get a reference to the whole HTML page with the error message in it, including its header and footer. If you need to extract the error message itself, you can do it by looking at the content of the table cell whose ID is <code  class="code">error_msg</code>. If the error mode is not set to <code  class="code">ERROR_MODE_WEBPAGE</code>, you get a reference to the error message itself.</p>
+
+<dt><a name="vars"
+><code  class="code">vars</code></a></dt>
+
+<dd>
+<p>This hash contains all the data passed to the error template. Its content depends on the error thrown.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="flag_end_of_update"
+>flag_end_of_update</a></h2>
+
+<p>This happens at the end of <a href="../Bugzilla/Flag.html#update_flags" class="podlinkpod"
+>&#34;update_flags&#34; in Bugzilla::Flag</a>, after all other changes are made to the database and after emails are sent. It gives you a before/after snapshot of flags so you can react to specific flag changes. This generally occurs inside a database transaction.</p>
+
+<p>Note that the interface to this hook is <b>UNSTABLE</b> and it may change in the future.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="object_-_The_changed_bug_or_attachment_object."
+><code  class="code">object</code> - The changed bug or attachment object.</a></dt>
+
+<dd>
+<dt><a name="timestamp_-_The_timestamp_used_for_all_updates_in_this_transaction,_as_a_SQL_date_string."
+><code  class="code">timestamp</code> - The timestamp used for all updates in this transaction, as a SQL date string.</a></dt>
+
+<dd>
+<dt><a name="old_flags_-_The_snapshot_of_flag_summaries_from_before_the_change."
+><code  class="code">old_flags</code> - The snapshot of flag summaries from before the change.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">new_flags</code> - The snapshot of flag summaries after the change. Call <code  class="code">my ($removed, $added) = diff_arrays(old_flags, new_flags)</code> to get the list of changed flags, and search for a specific condition like <code  class="code">added eq &#39;review-&#39;</code>.</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="group_before_delete"
+>group_before_delete</a></h2>
+
+<p>This happens in <a href="../Bugzilla/Group.html#remove_from_db" class="podlinkpod"
+>&#34;remove_from_db&#34; in Bugzilla::Group</a>, after we&#39;ve confirmed that the group can be deleted, but before any rows have actually been removed from the database. This occurs inside a database transaction.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="group_-_The_Bugzilla::Group_being_deleted."
+><code  class="code">group</code> - The <a href="../Bugzilla/Group.html" class="podlinkpod"
+>Bugzilla::Group</a> being deleted.</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="group_end_of_create"
+>group_end_of_create</a></h2>
+
+<p>This happens at the end of <a href="../Bugzilla/Group.html#create" class="podlinkpod"
+>&#34;create&#34; in Bugzilla::Group</a>, after all other changes are made to the database. This occurs inside a database transaction.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="group"
+><code  class="code">group</code></a></dt>
+
+<dd>
+<p>The new <a href="../Bugzilla/Group.html" class="podlinkpod"
+>Bugzilla::Group</a> object that was just created.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="group_end_of_update"
+>group_end_of_update</a></h2>
+
+<p>This happens at the end of <a href="../Bugzilla/Group.html#update" class="podlinkpod"
+>&#34;update&#34; in Bugzilla::Group</a>, after all other changes are made to the database. This occurs inside a database transaction.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="group_-_The_changed_Bugzilla::Group_object,_with_all_fields_set_to_their_updated_values."
+><code  class="code">group</code> - The changed <a href="../Bugzilla/Group.html" class="podlinkpod"
+>Bugzilla::Group</a> object, with all fields set to their updated values.</a></dt>
+
+<dd>
+<dt><a name="changes_-_The_hash_of_changed_fields._$changes-&#62;{$field}_=_[$old,_$new]"
+><code  class="code">changes</code> - The hash of changed fields. <code  class="code">$changes-&#62;{$field} = [$old, $new]</code></a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="install_before_final_checks"
+>install_before_final_checks</a></h2>
+
+<p>Allows execution of custom code before the final checks are done in checksetup.pl.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="silent"
+><code  class="code">silent</code></a></dt>
+
+<dd>
+<p>A flag that indicates whether or not checksetup is running in silent mode. If this is true, messages that are <i>always</i> printed by checksetup.pl should be suppressed, but messages about any changes that are just being done this one time should be printed.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="install_filesystem"
+>install_filesystem</a></h2>
+
+<p>Allows for additional files and directories to be added to the list of files and directories already managed by checksetup.pl. You will be able to also set permissions for the files and directories using this hook. You can also use this hook to create appropriate .htaccess files for any directory to secure its contents. For examples see <a href="../FILESYSTEM.html" class="podlinkpod"
+>FILESYSTEM</a> in <a href="../Bugzilla/Install/Filesystem.html" class="podlinkpod"
+>Bugzilla::Install::Filesystem</a>.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="files"
+><code  class="code">files</code></a></dt>
+
+<dd>
+<p>Hash reference of files that are already present when your extension was installed but need to have specific permissions set. Each file key points to another hash reference containing the following settings.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="perms_-_Permissions_to_be_set_on_the_file."
+><code  class="code">perms</code> - Permissions to be set on the file.</a></dt>
+</dl>
+
+<dt><a name="create_dirs"
+><code  class="code">create_dirs</code></a></dt>
+
+<dd>
+<p>Hash reference containing the name of each directory that will be created, pointing at its default permissions.</p>
+
+<dt><a name="non_recurse_dirs"
+><code  class="code">non_recurse_dirs</code></a></dt>
+
+<dd>
+<p>Hash reference containing directories that we want to set the perms on, but not recurse through. These are directories not created in checksetup.pl. Each directory key&#39;s value is the permissions to be set on the directory.</p>
+
+<dt><a name="recurse_dirs"
+><code  class="code">recurse_dirs</code></a></dt>
+
+<dd>
+<p>Hash reference of directories that will have permissions set for each item inside each of the directories, including the directory itself. Each directory key points to another hash reference containing the following settings.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="files_-_Permissions_to_be_set_on_any_files_beneath_the_directory."
+><code  class="code">files</code> - Permissions to be set on any files beneath the directory.</a></dt>
+
+<dd>
+<dt><a name="dirs_-_Permissions_to_be_set_on_the_directory_itself_and_any_directories_beneath_it."
+><code  class="code">dirs</code> - Permissions to be set on the directory itself and any directories beneath it.</a></dt>
+</dl>
+
+<dt><a name="create_files"
+><code  class="code">create_files</code></a></dt>
+
+<dd>
+<p>Hash reference of additional files to be created. Each file key points to another hash reference containing the following settings.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="perms_-_The_permissions_to_be_set_on_the_file_itself."
+><code  class="code">perms</code> - The permissions to be set on the file itself.</a></dt>
+
+<dd>
+<dt><a name="contents_-_The_contents_to_be_added_to_the_file_or_leave_blank_for_an_empty_file."
+><code  class="code">contents</code> - The contents to be added to the file or leave blank for an empty file.</a></dt>
+</dl>
+
+<dt><a name="htaccess"
+><code  class="code">htaccess</code></a></dt>
+
+<dd>
+<p>Hash reference containing htaccess files to be created. You can set the permissions for the htaccess as well as the contents of the file. Each file key points to another hash reference containing the following settings.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="perms_-_Permissions_to_be_set_on_the_htaccess_file."
+><code  class="code">perms</code> - Permissions to be set on the htaccess file.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">contents</code> - Contents of the htaccess file. It can be set manually or use <a href="../HT_DEFAULT_DENY.html" class="podlinkpod"
+>HT_DEFAULT_DENY</a> defined in <a href="../Bugzilla/Install/Filesystem.html" class="podlinkpod"
+>Bugzilla::Install::Filesystem</a> to deny all by default.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="install_update_db"
+>install_update_db</a></h2>
+
+<p>This happens at the very end of all the tables being updated during an installation or upgrade. If you need to modify your custom schema or add new columns to existing tables, do it here. No params are passed.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="install_update_db_fielddefs"
+>install_update_db_fielddefs</a></h2>
+
+<p>This is used to update the schema of the fielddefs table before any other schema changes take place. No params are passed.</p>
+
+<p>This hook should only be used for updating the schema of the <code  class="code">fielddefs</code> table. Do not modify any other table in this hook. To modify other tables, use the <a href="#install_update_db" class="podlinkpod"
+>&#34;install_update_db&#34;</a> hook.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="db_schema_abstract_schema"
+>db_schema_abstract_schema</a></h2>
+
+<p>This allows you to add tables to Bugzilla. Note that we recommend that you prefix the names of your tables with some word (preferably the name of your Extension), so that they don&#39;t conflict with any future Bugzilla tables.</p>
+
+<p>If you wish to add new <i>columns</i> to existing Bugzilla tables, do that in <a href="#install_update_db" class="podlinkpod"
+>&#34;install_update_db&#34;</a>.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a 
+><code  class="code">schema</code> - A hashref, in the format of <a href="../Bugzilla/DB/Schema.html#ABSTRACT_SCHEMA" class="podlinkpod"
+>&#34;ABSTRACT_SCHEMA&#34; in Bugzilla::DB::Schema</a>. Add new hash keys to make new table definitions. <em  class="code">checksetup.pl</em> will automatically add these tables to the database when run.</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="job_map"
+>job_map</a></h2>
+
+<p>Bugzilla has a system - <a href="../Bugzilla/JobQueue.html" class="podlinkpod"
+>Bugzilla::JobQueue</a> - for running jobs asynchronously, if the administrator has set it up. This hook allows the addition of mappings from job names to handler classes, so an extension can fire off jobs.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a 
+><code  class="code">job_map</code> - The job map hash. Key: the name of the job, as should be passed to Bugzilla-&#62;job_queue-&#62;insert(). Value: the name of the Perl module which implements the task (an instance of <a href="../TheSchwartz/Worker.html" class="podlinkpod"
+>TheSchwartz::Worker</a>).</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="mailer_before_send"
+>mailer_before_send</a></h2>
+
+<p>Called right before <a href="../Bugzilla/Mailer.html" class="podlinkpod"
+>Bugzilla::Mailer</a> sends a message to the MTA.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="email_-_The_Email::MIME_object_that&#39;s_about_to_be_sent."
+><code  class="code">email</code> - The <code  class="code">Email::MIME</code> object that&#39;s about to be sent.</a></dt>
+
+<dd>
+<dt><a name="mailer_args_-_An_arrayref_that&#39;s_passed_as_mailer_args_to_&#34;new&#34;_in_Email::Send."
+><code  class="code">mailer_args</code> - An arrayref that&#39;s passed as <code  class="code">mailer_args</code> to <a href="../Email/Send.html#new" class="podlinkpod"
+>&#34;new&#34; in Email::Send</a>.</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="object_before_create"
+>object_before_create</a></h2>
+
+<p>This happens at the beginning of <a href="../Bugzilla/Object.html#create" class="podlinkpod"
+>&#34;create&#34; in Bugzilla::Object</a>.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="class"
+><code  class="code">class</code></a></dt>
+
+<dd>
+<p>The name of the class that <code  class="code">create</code> was called on. You can check this like <code  class="code">if ($class-&#62;isa(&#39;Some::Class&#39;))</code> in your code, to perform specific tasks before <code  class="code">create</code> for only certain classes.</p>
+
+<dt><a name="params"
+><code  class="code">params</code></a></dt>
+
+<dd>
+<p>A hashref. The set of named parameters passed to <code  class="code">create</code>.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="object_before_delete"
+>object_before_delete</a></h2>
+
+<p>This happens in <a href="../Bugzilla/Object.html#remove_from_db" class="podlinkpod"
+>&#34;remove_from_db&#34; in Bugzilla::Object</a>, after we&#39;ve confirmed that the object can be deleted, but before any rows have actually been removed from the database. This sometimes occurs inside a database transaction.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a 
+><code  class="code">object</code> - The <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a> being deleted. You will probably want to check its type like <code  class="code">$object-&#62;isa(&#39;Some::Class&#39;)</code> before doing anything with it.</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="object_before_set"
+>object_before_set</a></h2>
+
+<p>Called during <a href="../Bugzilla/Object.html#set" class="podlinkpod"
+>&#34;set&#34; in Bugzilla::Object</a>, before any actual work is done. You can use this to perform actions before a value is changed for specific fields on certain types of objects.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="object"
+><code  class="code">object</code></a></dt>
+
+<dd>
+<p>The object that <code  class="code">set</code> was called on. You will probably want to do something like <code  class="code">if ($object-&#62;isa(&#39;Some::Class&#39;))</code> in your code to limit your changes to only certain subclasses of Bugzilla::Object.</p>
+
+<dt><a name="field"
+><code  class="code">field</code></a></dt>
+
+<dd>
+<p>The name of the field being updated in the object.</p>
+
+<dt><a name="value"
+><code  class="code">value</code></a></dt>
+
+<dd>
+<p>The value being set on the object.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="object_columns"
+>object_columns</a></h2>
+
+<p>This hook allows you to add new &#34;fields&#34; to existing Bugzilla objects, that correspond to columns in their tables.</p>
+
+<p>For example, if you added an <code  class="code">example</code> column to the &#34;bugs&#34; table, you would have to also add an <code  class="code">example</code> field to the <code  class="code">Bugzilla::Bug</code> object in order to access that data via Bug objects.</p>
+
+<p>Don&#39;t do anything slow inside this hook--it&#39;s called several times on every page of Bugzilla.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="class"
+><code  class="code">class</code></a></dt>
+
+<dd>
+<p>The name of the class that this hook is being called on. You can check this like <code  class="code">if ($class-&#62;isa(&#39;Some::Class&#39;))</code> in your code, to add new fields only for certain classes.</p>
+
+<dt><a name="columns"
+><code  class="code">columns</code></a></dt>
+
+<dd>
+<p>An arrayref. Add the string names of columns to this array to add new values to objects.</p>
+
+<p>For example, if you add an <code  class="code">example</code> column to a particular table (using <a href="#install_update_db" class="podlinkpod"
+>&#34;install_update_db&#34;</a>), and then push the string <code  class="code">example</code> into this array for the object that uses that table, then you can access the information in that column via <code  class="code">$object-&#62;{example}</code> on all objects of that type.</p>
+
+<p>This arrayref does not contain the standard column names--you cannot modify or remove standard object columns using this hook.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="object_end_of_create"
+>object_end_of_create</a></h2>
+
+<p>Called at the end of <a href="../Bugzilla/Object.html#create" class="podlinkpod"
+>&#34;create&#34; in Bugzilla::Object</a>, after all other changes are made to the database. This occurs inside a database transaction.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="class"
+><code  class="code">class</code></a></dt>
+
+<dd>
+<p>The name of the class that <code  class="code">create</code> was called on. You can check this like <code  class="code">if ($class-&#62;isa(&#39;Some::Class&#39;))</code> in your code, to perform specific tasks for only certain classes.</p>
+
+<dt><a name="object"
+><code  class="code">object</code></a></dt>
+
+<dd>
+<p>The created object.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="object_end_of_create_validators"
+>object_end_of_create_validators</a></h2>
+
+<p>Called at the end of <a href="../Bugzilla/Object.html#run_create_validators" class="podlinkpod"
+>&#34;run_create_validators&#34; in Bugzilla::Object</a>. You can use this to run additional validation when creating an object.</p>
+
+<p>If a subclass has overridden <code  class="code">run_create_validators</code>, then this usually happens <i>before</i> the subclass does its custom validation.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="class"
+><code  class="code">class</code></a></dt>
+
+<dd>
+<p>The name of the class that <code  class="code">create</code> was called on. You can check this like <code  class="code">if ($class-&#62;isa(&#39;Some::Class&#39;))</code> in your code, to perform specific tasks for only certain classes.</p>
+
+<dt><a name="params"
+><code  class="code">params</code></a></dt>
+
+<dd>
+<p>A hashref. The set of named parameters passed to <code  class="code">create</code>, modified and validated by the <code  class="code">VALIDATORS</code> specified for the object.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="object_end_of_set"
+>object_end_of_set</a></h2>
+
+<p>Called during <a href="../Bugzilla/Object.html#set" class="podlinkpod"
+>&#34;set&#34; in Bugzilla::Object</a>, after all the code of the function has completed (so the value has been validated and the field has been set to the new value). You can use this to perform actions after a value is changed for specific fields on certain types of objects.</p>
+
+<p>The new value is not specifically passed to this hook because you can get it as <code  class="code">$object-&#62;{$field}</code>.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="object"
+><code  class="code">object</code></a></dt>
+
+<dd>
+<p>The object that <code  class="code">set</code> was called on. You will probably want to do something like <code  class="code">if ($object-&#62;isa(&#39;Some::Class&#39;))</code> in your code to limit your changes to only certain subclasses of Bugzilla::Object.</p>
+
+<dt><a name="field"
+><code  class="code">field</code></a></dt>
+
+<dd>
+<p>The name of the field that was updated in the object.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="object_end_of_set_all"
+>object_end_of_set_all</a></h2>
+
+<p>This happens at the end of <a href="../Bugzilla/Object.html#set_all" class="podlinkpod"
+>&#34;set_all&#34; in Bugzilla::Object</a>. This is a good place to call custom set_ functions on objects, or to make changes to an object before <code  class="code">update()</code> is called.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="object"
+><code  class="code">object</code></a></dt>
+
+<dd>
+<p>The <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a> which is being updated. You will probably want to do something like <code  class="code">if ($object-&#62;isa(&#39;Some::Class&#39;))</code> in your code to limit your changes to only certain subclasses of Bugzilla::Object.</p>
+
+<dt><a name="params"
+><code  class="code">params</code></a></dt>
+
+<dd>
+<p>A hashref. The set of named parameters passed to <code  class="code">set_all</code>.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="object_end_of_update"
+>object_end_of_update</a></h2>
+
+<p>Called during <a href="../Bugzilla/Object.html#update" class="podlinkpod"
+>&#34;update&#34; in Bugzilla::Object</a>, after changes are made to the database, but while still inside a transaction.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="object"
+><code  class="code">object</code></a></dt>
+
+<dd>
+<p>The object that <code  class="code">update</code> was called on. You will probably want to do something like <code  class="code">if ($object-&#62;isa(&#39;Some::Class&#39;))</code> in your code to limit your changes to only certain subclasses of Bugzilla::Object.</p>
+
+<dt><a name="old_object"
+><code  class="code">old_object</code></a></dt>
+
+<dd>
+<p>The object as it was before it was updated.</p>
+
+<dt><a name="changes"
+><code  class="code">changes</code></a></dt>
+
+<dd>
+<p>The fields that have been changed, in the same format that <a href="../Bugzilla/Object.html#update" class="podlinkpod"
+>&#34;update&#34; in Bugzilla::Object</a> returns.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="object_update_columns"
+>object_update_columns</a></h2>
+
+<p>If you&#39;ve added fields to bugs via <a href="#object_columns" class="podlinkpod"
+>&#34;object_columns&#34;</a>, then this hook allows you to say which of those columns should be updated in the database when <a href="../Bugzilla/Object.html#update" class="podlinkpod"
+>&#34;update&#34; in Bugzilla::Object</a> is called on the object.</p>
+
+<p>If you don&#39;t use this hook, then your custom columns won&#39;t be modified in the database by Bugzilla.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="object"
+><code  class="code">object</code></a></dt>
+
+<dd>
+<p>The object that is about to be updated. You should check this like <code  class="code">if ($object-&#62;isa(&#39;Some::Class&#39;))</code> in your code, to modify the &#34;update columns&#34; only for certain classes.</p>
+
+<dt><a name="columns"
+><code  class="code">columns</code></a></dt>
+
+<dd>
+<p>An arrayref. Add the string names of columns to this array to allow that column to be updated when <code  class="code">update()</code> is called on the object.</p>
+
+<p>This arrayref does not contain the standard column names--you cannot stop standard columns from being updated by using this hook.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="object_validators"
+>object_validators</a></h2>
+
+<p>Allows you to add new items to <a href="../Bugzilla/Object.html#VALIDATORS" class="podlinkpod"
+>&#34;VALIDATORS&#34; in Bugzilla::Object</a> for particular classes.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="class"
+><code  class="code">class</code></a></dt>
+
+<dd>
+<p>The name of the class that <code  class="code">VALIDATORS</code> was called on. You can check this like <code  class="code">if ($class-&#62;isa(&#39;Some::Class&#39;))</code> in your code, to add validators only for certain classes.</p>
+
+<dt><a name="validators"
+><code  class="code">validators</code></a></dt>
+
+<dd>
+<p>A hashref, where the keys are database columns and the values are subroutine references. You can add new validators or modify existing ones. If you modify an existing one, you should remember to call the original validator inside of your modified validator. (This way, several extensions can all modify the same validator.)</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="page_before_template"
+>page_before_template</a></h2>
+
+<p>This is a simple way to add your own pages to Bugzilla. This hooks <code  class="code">page.cgi</code>, which loads templates from <em  class="code">template/en/default/pages</em>. For example, <code  class="code">page.cgi?id=fields.html</code> loads <em  class="code">template/en/default/pages/fields.html.tmpl</em>.</p>
+
+<p>This hook is called right before the template is loaded, so that you can pass your own variables to your own pages.</p>
+
+<p>You can also use this to implement complex custom pages, by doing your own output and then calling <code  class="code">exit</code> at the end of the hook, thus preventing the normal <code  class="code">page.cgi</code> behavior from occurring.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="page_id"
+><code  class="code">page_id</code></a></dt>
+
+<dd>
+<p>This is the name of the page being loaded, like <code  class="code">fields.html</code>.</p>
+
+<p>Note that if two extensions use the same name, it is uncertain which will override the others, so you should be careful with how you name your pages. Usually extensions prefix their pages with a directory named after their extension, so for an extension named &#34;Foo&#34;, page ids usually look like <code  class="code">foo/mypage.html</code>.</p>
+
+<dt><a name="vars"
+><code  class="code">vars</code></a></dt>
+
+<dd>
+<p>This is a hashref--put variables into here if you want them passed to your template.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="path_info_whitelist"
+>path_info_whitelist</a></h2>
+
+<p>By default, Bugzilla removes the Path-Info information from URLs before passing data to CGI scripts. If this information is needed for your customizations, you can enumerate the pages you want to whitelist here.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="whitelist"
+><code  class="code">whitelist</code></a></dt>
+
+<dd>
+<p>An array of script names that will not have their Path-Info automatically removed.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="post_bug_after_creation"
+>post_bug_after_creation</a></h2>
+
+<p><b>DEPRECATED</b> (Use <a href="#bug_end_of_create" class="podlinkpod"
+>&#34;bug_end_of_create&#34;</a> instead.)</p>
+
+<p>This happens after a bug is created and before bug mail is sent during <code  class="code">post_bug.cgi</code>. Note that this only happens during <code  class="code">post_bug.cgi</code>, it doesn&#39;t happen during any of the other methods of creating a bug.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="vars_-_The_template_vars_hashref."
+><code  class="code">vars</code> - The template vars hashref.</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="product_confirm_delete"
+>product_confirm_delete</a></h2>
+
+<p><b>DEPRECATED</b> - Use <a href="#template_before_process" class="podlinkpod"
+>&#34;template_before_process&#34;</a> instead.</p>
+
+<p>Called before displaying the confirmation message when deleting a product.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="vars_-_The_template_vars_hashref."
+><code  class="code">vars</code> - The template vars hashref.</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="product_end_of_create"
+>product_end_of_create</a></h2>
+
+<p>Called right after a new product has been created, allowing additional changes to be made to the new product&#39;s attributes. This occurs inside of a database transaction, so if the hook throws an error, all previous changes will be rolled back, including the creation of the new product. (However, note that such rollbacks should not normally be used, as some databases that Bugzilla supports have very bad rollback performance. If you want to validate input and throw errors before the Product is created, use <a href="#object_end_of_create_validators" class="podlinkpod"
+>&#34;object_end_of_create_validators&#34;</a> instead, or add a validator using <a href="#object_validators" class="podlinkpod"
+>&#34;object_validators&#34;</a>.)</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="product_-_The_new_Bugzilla::Product_object_that_was_just_created."
+><code  class="code">product</code> - The new <a href="../Bugzilla/Product.html" class="podlinkpod"
+>Bugzilla::Product</a> object that was just created.</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="quicksearch_map"
+>quicksearch_map</a></h2>
+
+<p>This hook allows you to alter the Quicksearch syntax to include e.g. special searches for custom fields you have.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a 
+><code  class="code">map</code> - a hash where the key is the name you want to use in Quicksearch, and the value is the name from the <code  class="code">fielddefs</code> table that you want it to map to. You can modify existing mappings or add new ones.</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="sanitycheck_check"
+>sanitycheck_check</a></h2>
+
+<p>This hook allows for extra sanity checks to be added, for use by <em  class="code">sanitycheck.cgi</em>.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="status_-_a_CODEREF_that_allows_status_messages_to_be_displayed_to_the_user._(sanitycheck.cgi&#39;s_Status)"
+><code  class="code">status</code> - a CODEREF that allows status messages to be displayed to the user. (<em  class="code">sanitycheck.cgi</em>&#39;s <code  class="code">Status</code>)</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="sanitycheck_repair"
+>sanitycheck_repair</a></h2>
+
+<p>This hook allows for extra sanity check repairs to be made, for use by <em  class="code">sanitycheck.cgi</em>.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="status_-_a_CODEREF_that_allows_status_messages_to_be_displayed_to_the_user._(sanitycheck.cgi&#39;s_Status)"
+><code  class="code">status</code> - a CODEREF that allows status messages to be displayed to the user. (<em  class="code">sanitycheck.cgi</em>&#39;s <code  class="code">Status</code>)</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="template_before_create"
+>template_before_create</a></h2>
+
+<p>This hook allows you to modify the configuration of <a href="../Bugzilla/Template.html" class="podlinkpod"
+>Bugzilla::Template</a> objects before they are created. For example, you could add a new global template variable this way.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="config"
+><code  class="code">config</code></a></dt>
+
+<dd>
+<p>A hashref--the configuration that will be passed to <a href="../Template.html#new" class="podlinkpod"
+>&#34;new&#34; in Template</a>. See <a href="http://template-toolkit.org/docs/modules/Template.html#section_CONFIGURATION_SUMMARY" class="podlinkurl"
+>http://template-toolkit.org/docs/modules/Template.html#section_CONFIGURATION_SUMMARY</a> for information on how this configuration variable is structured (or just look at the code for <code  class="code">create</code> in <a href="../Bugzilla/Template.html" class="podlinkpod"
+>Bugzilla::Template</a>.)</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="template_before_process"
+>template_before_process</a></h2>
+
+<p>This hook is called any time Bugzilla processes a template file, including calls to <code  class="code">$template-&#62;process</code>, <code  class="code">PROCESS</code> statements in templates, and <code  class="code">INCLUDE</code> statements in templates. It is not called when templates process a <code  class="code">BLOCK</code>, only when they process a file.</p>
+
+<p>This hook allows you to define additional variables that will be available to the template being processed, or to modify the variables that are currently in the template. It works exactly as though you inserted code to modify template variables at the top of a template.</p>
+
+<p>You probably want to restrict this hook to operating only if a certain file is being processed (which is why you get a <code  class="code">file</code> argument below). Otherwise, modifying the <code  class="code">vars</code> argument will affect every single template in Bugzilla.</p>
+
+<p><b>Note:</b> This hook is not called if you are already in this hook. (That is, it won&#39;t call itself recursively.) This prevents infinite recursion in situations where this hook needs to process a template (such as if this hook throws an error).</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="vars"
+><code  class="code">vars</code></a></dt>
+
+<dd>
+<p>This is the entire set of variables that the current template can see. Technically, this is a <a href="../Template/Stash.html" class="podlinkpod"
+>Template::Stash</a> object, but you can just use it like a hashref if you want.</p>
+
+<dt><a name="file"
+><code  class="code">file</code></a></dt>
+
+<dd>
+<p>The name of the template file being processed. This is relative to the main template directory for the language (i.e. for <em  class="code">template/en/default/bug/show.html.tmpl</em>, this variable will contain <code  class="code">bug/show.html.tmpl</code>).</p>
+
+<dt><a name="context"
+><code  class="code">context</code></a></dt>
+
+<dd>
+<p>A <a href="../Template/Context.html" class="podlinkpod"
+>Template::Context</a> object. Usually you will not have to use this, but if you need information about the template itself (other than just its name), you can get it from here.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="user_preferences"
+>user_preferences</a></h2>
+
+<p>This hook allows you to add additional panels to the User Preferences page, and validate data displayed and returned from these panels. It works in combination with the <code  class="code">tabs</code> hook available in the <em  class="code">template/en/default/account/prefs/prefs.html.tmpl</em> template. To make it work, you must define two templates in your extension: <em  class="code">extensions/Foo/template/en/default/hook/account/prefs/prefs-tabs.html.tmpl</em> contains a list of additional panels to include. <em  class="code">extensions/Foo/template/en/default/account/prefs/bar.html.tmpl</em> contains the content of the panel itself. See the <code  class="code">Example</code> extension to see how things work.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="current_tab"
+><code  class="code">current_tab</code></a></dt>
+
+<dd>
+<p>The name of the current panel being viewed by the user. You should always make sure that the name of the panel matches what you expect it to be. Else you could be interacting with the panel of another extension.</p>
+
+<dt><a name="save_changes"
+><code  class="code">save_changes</code></a></dt>
+
+<dd>
+<p>A boolean which is true when data should be validated and the DB updated accordingly. This means the user clicked the &#34;Submit Changes&#34; button.</p>
+
+<dt><a name="handled"
+><code  class="code">handled</code></a></dt>
+
+<dd>
+<p>This is a <b>reference</b> to a scalar, not a scalar. (So you would set it like <code  class="code">$$handled = 1</code>, not like <code  class="code">$handled = 1</code>.) Set this to a true value to let Bugzilla know that the passed-in panel is valid and that you have handled it. (Otherwise, Bugzilla will throw an error that the panel is invalid.) Don&#39;t set this to true if you didn&#39;t handle the panel listed in <code  class="code">current_tab</code>.</p>
+
+<dt><a name="vars"
+><code  class="code">vars</code></a></dt>
+
+<dd>
+<p>You can add as many new key/value pairs as you want to this hashref. It will be passed to the template.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="webservice"
+>webservice</a></h2>
+
+<p>This hook allows you to add your own modules to the WebService. (See <a href="../Bugzilla/WebService.html" class="podlinkpod"
+>Bugzilla::WebService</a>.)</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="dispatch"
+><code  class="code">dispatch</code></a></dt>
+
+<dd>
+<p>A hashref where you can specify the names of your modules and which Perl module handles the functions for that module. (This is actually sent to <a href="../SOAP/Lite.html#dispatch_with" class="podlinkpod"
+>&#34;dispatch_with&#34; in SOAP::Lite</a>. You can see how that&#39;s used in <em  class="code">xmlrpc.cgi</em>.)</p>
+
+<p>The Perl module name will most likely start with <code  class="code">Bugzilla::Extension::Foo::</code> (where &#34;Foo&#34; is the name of your extension).</p>
+
+<p>Example:</p>
+
+<pre  class="code">  $dispatch-&#62;{&#39;Example.Blah&#39;} = &#34;Bugzilla::Extension::Example::Webservice::Blah&#34;;</pre>
+
+<p>And then you&#39;d have a module <em  class="code">extensions/Example/lib/Webservice/Blah.pm</em>, and could call methods from that module like <code  class="code">Example.Blah.Foo()</code> using the WebServices interface.</p>
+
+<p>It&#39;s recommended that all the keys you put in <code  class="code">dispatch</code> start with the name of your extension, so that you don&#39;t conflict with the standard Bugzilla WebService functions (and so that you also don&#39;t conflict with other plugins).</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="webservice_error_codes"
+>webservice_error_codes</a></h2>
+
+<p>If your webservice extension throws custom errors, you can set numeric codes for those errors here.</p>
+
+<p>Extensions should use error codes above 10000, unless they are re-using an already-existing error code.</p>
+
+<p>Params:</p>
+
+<dl>
+<dt><a name="error_map"
+><code  class="code">error_map</code></a></dt>
+
+<dd>
+<p>A hash that maps the names of errors (like <code  class="code">invalid_param</code>) to numbers. See <a href="../Bugzilla/WebService/Constants.html#WS_ERROR_CODE" class="podlinkpod"
+>&#34;WS_ERROR_CODE&#34; in Bugzilla::WebService::Constants</a> for an example.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SEE_ALSO"
+>SEE ALSO</a></h1>
+
+<p><a href="../Bugzilla/Extension.html" class="podlinkpod"
+>Bugzilla::Extension</a></p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Install.html b/docs/en/html/api/Bugzilla/Install.html
new file mode 100644 (file)
index 0000000..0116fbf
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Install.html
@@ -0,0 +1,94 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Install</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Install</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#CONSTANTS'>CONSTANTS</a>
+  <li class='indexItem indexItem1'><a href='#SUBROUTINES'>SUBROUTINES</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Install - Functions and variables having to do with installation.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> use Bugzilla::Install;
+ Bugzilla::Install::update_settings();</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This module is used primarily by <a href="../checksetup.pl.html" class="podlinkpod"
+>checksetup.pl</a> during installation. This module contains functions that deal with general installation issues after the database is completely set up and configured.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CONSTANTS"
+>CONSTANTS</a></h1>
+
+<dl>
+<dt><a name="SETTINGS"
+><code  class="code">SETTINGS</code></a></dt>
+
+<dd>
+<p>Contains information about Settings, used by <a href="#update_settings()" class="podlinkpod"
+>&#34;update_settings()&#34;</a>.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SUBROUTINES"
+>SUBROUTINES</a></h1>
+
+<dl>
+<dt><a name="update_settings()"
+><code  class="code">update_settings()</code></a></dt>
+
+<dd>
+<p>Description: Adds and updates Settings for users.</p>
+
+<p>Params: none</p>
+
+<p>Returns: nothing.</p>
+
+<dt><a name="create_default_classification"
+><code  class="code">create_default_classification</code></a></dt>
+
+<dd>
+<p>Creates the default &#34;Unclassified&#34; <a href="../Bugzilla/Classification.html" class="podlinkpod"
+>Classification</a> if it doesn&#39;t already exist</p>
+
+<dt><a name="create_default_product()"
+><code  class="code">create_default_product()</code></a></dt>
+
+<dd>
+<p>Description: Creates the default product and component if they don&#39;t exist.</p>
+
+<p>Params: none</p>
+
+<p>Returns: nothing</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Install/CPAN.html b/docs/en/html/api/Bugzilla/Install/CPAN.html
new file mode 100644 (file)
index 0000000..26353d8
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Install/CPAN.html
@@ -0,0 +1,79 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Install::CPAN</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Install::CPAN</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#SUBROUTINES'>SUBROUTINES</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Install::CPAN - Routines to install Perl modules from CPAN.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> use Bugzilla::Install::CPAN;
+
+ set_cpan_config();
+ install_module(&#39;Module::Name&#39;);</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This is primarily used by <a href="../../install-module.html" class="podlinkpod"
+>install-module</a> to do the &#34;hard work&#34; of installing CPAN modules.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SUBROUTINES"
+>SUBROUTINES</a></h1>
+
+<dl>
+<dt><a name="set_cpan_config"
+><code  class="code">set_cpan_config</code></a></dt>
+
+<dd>
+<p>Sets up the configuration of CPAN for this session. Must be called before <a href="#install_module" class="podlinkpod"
+>&#34;install_module&#34;</a>. Takes one boolean parameter. If true, <a href="#install_module" class="podlinkpod"
+>&#34;install_module&#34;</a> will install modules globally instead of to the local <em  class="code">lib/</em> directory. On most systems, you have to be root to do that.</p>
+
+<dt><a name="install_module"
+><code  class="code">install_module</code></a></dt>
+
+<dd>
+<p>Installs a module from CPAN. Takes two arguments:</p>
+
+<dl>
+<dt><a name="$name_-_The_name_of_the_module,_just_like_you&#39;d_pass_to_the_install_command_in_the_CPAN_shell."
+><code  class="code">$name</code> - The name of the module, just like you&#39;d pass to the <code  class="code">install</code> command in the CPAN shell.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">$test</code> - If true, we run tests on this module before installing, but we still force the install if the tests fail. This is only used when we internally install a newer CPAN module.</a></dt>
+</dl>
+
+<p>Note that calling this function prints a <b>lot</b> of information to STDOUT and STDERR.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Install/DB.html b/docs/en/html/api/Bugzilla/Install/DB.html
new file mode 100644 (file)
index 0000000..069248c
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Install/DB.html
@@ -0,0 +1,76 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Install::DB</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Install::DB</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#SUBROUTINES'>SUBROUTINES</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Install::DB - Fix up the database during installation.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> use Bugzilla::Install::DB qw(indicate_progress);
+ Bugzilla::Install::DB::update_table_definitions();
+
+ indicate_progress({ total =&#62; $total, current =&#62; $count, every =&#62; 10 });</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This module is used primarily by <a href="../../checksetup.pl.html" class="podlinkpod"
+>checksetup.pl</a> to modify the database during upgrades.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SUBROUTINES"
+>SUBROUTINES</a></h1>
+
+<dl>
+<dt><a name="update_table_definitions()"
+><code  class="code">update_table_definitions()</code></a></dt>
+
+<dd>
+<p>Description: This is the primary code that updates table definitions during upgrades. If you modify the schema in some way, you should add code to the end of this function to make sure that your modifications happen over all installations.</p>
+
+<p>Params: none</p>
+
+<p>Returns: nothing</p>
+
+<dt><a name="update_fielddefs_definition()"
+><code  class="code">update_fielddefs_definition()</code></a></dt>
+
+<dd>
+<p>Description: <a href="../../checksetup.pl.html" class="podlinkpod"
+>checksetup.pl</a> depends on the fielddefs table having its schema adjusted before the rest of the tables. So these schema updates happen in a separate function from <a href="#update_table_definitions()" class="podlinkpod"
+>&#34;update_table_definitions()&#34;</a>.</p>
+
+<p>Params: none</p>
+
+<p>Returns: nothing</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Install/Filesystem.html b/docs/en/html/api/Bugzilla/Install/Filesystem.html
new file mode 100644 (file)
index 0000000..608596b
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Install/Filesystem.html
@@ -0,0 +1,97 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Install::Filesystem</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Install::Filesystem</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#SUBROUTINES'>SUBROUTINES</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Install::Filesystem - Fix up the filesystem during installation.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This module is used primarily by <a href="../../checksetup.pl.html" class="podlinkpod"
+>checksetup.pl</a> to modify the filesystem during installation,
+including creating the data/ directory.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SUBROUTINES"
+>SUBROUTINES</a></h1>
+
+<dl>
+<dt><a name="update_filesystem({_index_html_=_0_})&#62;"
+><code  class="code">update_filesystem({ index_html =</code> 0 })&#62;</a></dt>
+
+<dd>
+<p>Description: Creates all the directories and files that Bugzilla needs to function but doesn&#39;t ship with.
+Also does any updates to these files as necessary during an upgrade.</p>
+
+<p>Params: <code  class="code">index_html</code> - Whether or not we should create the <em  class="code">index.html</em> file.</p>
+
+<p>Returns: nothing</p>
+
+<dt><a name="create_htaccess()"
+><code  class="code">create_htaccess()</code></a></dt>
+
+<dd>
+<p>Description: Creates all of the .htaccess files for Apache,
+in the various Bugzilla directories.
+Also updates the .htaccess files if they need updating.</p>
+
+<p>Params: none</p>
+
+<p>Returns: nothing</p>
+
+<dt><a name="fix_all_file_permissions($output)"
+><code  class="code">fix_all_file_permissions($output)</code></a></dt>
+
+<dd>
+<p>Description: Sets all the file permissions on all of Bugzilla&#39;s files to what they should be.
+Note that permissions are different depending on whether or not <code  class="code">$webservergroup</code> is set in <em  class="code">localconfig</em>.</p>
+
+<p>Params: <code  class="code">$output</code> - <code  class="code">true</code> if you want this function to print out information about what it&#39;s doing.</p>
+
+<p>Returns: nothing</p>
+
+<dt><a name="fix_dir_permissions"
+><code  class="code">fix_dir_permissions</code></a></dt>
+
+<dd>
+<p>Given the name of a directory,
+its permissions will be fixed according to how they are supposed to be set in Bugzilla&#39;s current configuration.
+If it fails to set the permissions,
+a warning will be printed to STDERR.</p>
+
+<dt><a name="fix_file_permissions"
+><code  class="code">fix_file_permissions</code></a></dt>
+
+<dd>
+<p>Given the name of a file,
+its permissions will be fixed according to how they are supposed to be set in Bugzilla&#39;s current configuration.
+If it fails to set the permissions,
+a warning will be printed to STDERR.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Install/Localconfig.html b/docs/en/html/api/Bugzilla/Install/Localconfig.html
new file mode 100644 (file)
index 0000000..f8f61c8
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Install/Localconfig.html
@@ -0,0 +1,124 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Install::Localconfig</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1></h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#CONSTANTS'>CONSTANTS</a>
+  <li class='indexItem indexItem1'><a href='#SUBROUTINES'>SUBROUTINES</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Install::Localconfig - Functions and variables dealing with the manipulation and creation of the <em  class="code">localconfig</em> file.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> use Bugzilla::Install::Requirements qw(update_localconfig);
+ update_localconfig({ output =&#62; 1 });</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This module is used primarily by <a href="../../checksetup.pl.html" class="podlinkpod"
+>checksetup.pl</a> to create and modify the localconfig file. Most scripts should use <a href="../../Bugzilla.html#localconfig" class="podlinkpod"
+>&#34;localconfig&#34; in Bugzilla</a> to access localconfig variables.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CONSTANTS"
+>CONSTANTS</a></h1>
+
+<dl>
+<dt><a name="LOCALCONFIG_VARS"
+><code  class="code">LOCALCONFIG_VARS</code></a></dt>
+
+<dd>
+<p>An array of hashrefs. These hashrefs contain three keys:</p>
+
+<pre  class="code"> name    - The name of the variable.
+ default - The default value for the variable. Should always be
+           something that can fit in a scalar.
+ desc    - Additional text to put in localconfig before the variable
+           definition. Must end in a newline. Each line should start
+           with &#34;#&#34; unless you have some REALLY good reason not
+           to do that.</pre>
+
+<dt><a name="OLD_LOCALCONFIG_VARS"
+><code  class="code">OLD_LOCALCONFIG_VARS</code></a></dt>
+
+<dd>
+<p>An array of names of variables. If <code  class="code">update_localconfig</code> finds these variables defined in localconfig, it will print out a warning.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SUBROUTINES"
+>SUBROUTINES</a></h1>
+
+<dl>
+<dt><a name="read_localconfig"
+><code  class="code">read_localconfig</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Reads the localconfig file and returns all valid values in a hashref.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$include_deprecated"
+><code  class="code">$include_deprecated</code></a></dt>
+
+<dd>
+<p><code  class="code">true</code> if you want the returned hashref to include *any* variable currently defined in localconfig, even if it doesn&#39;t exist in <code  class="code">LOCALCONFIG_VARS</code>. Generally this is is only for use by <a href="#update_localconfig" class="podlinkpod"
+>&#34;update_localconfig&#34;</a>.</p>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hashref of the localconfig variables. If an array is defined in localconfig, it will be an arrayref in the returned hash. If a hash is defined, it will be a hashref in the returned hash. Only includes variables specified in <code  class="code">LOCALCONFIG_VARS</code>, unless <code  class="code">$include_deprecated</code> is true.</p>
+</dd>
+</dl>
+
+<dt><a name="update_localconfig"
+><code  class="code">update_localconfig</code></a></dt>
+
+<dd>
+<p>Description: Adds any new variables to localconfig that aren&#39;t currently defined there. Also optionally prints out a message about vars that *should* be there and aren&#39;t. Exits the program if it adds any new vars.</p>
+
+<p>Params: <code  class="code">$output</code> - <code  class="code">true</code> if the function should display informational output and warnings. It will always display errors or any message which would cause program execution to halt.</p>
+
+<p>Returns: A hashref, with <code  class="code">old_vals</code> being an array of names of variables that were removed, and <code  class="code">new_vals</code> being an array of names of variables that were added to localconfig.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Install/Requirements.html b/docs/en/html/api/Bugzilla/Install/Requirements.html
new file mode 100644 (file)
index 0000000..219ee2b
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Install/Requirements.html
@@ -0,0 +1,201 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Install::Requirements</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Install::Requirements</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#CONSTANTS'>CONSTANTS</a>
+  <li class='indexItem indexItem1'><a href='#SUBROUTINES'>SUBROUTINES</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Install::Requirements - Functions and variables dealing with Bugzilla&#39;s perl-module requirements.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This module is used primarily by <code  class="code">checksetup.pl</code> to determine whether or not all of Bugzilla&#39;s prerequisites are installed.
+(That is,
+all the perl modules it requires.)</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CONSTANTS"
+>CONSTANTS</a></h1>
+
+<dl>
+<dt><a name="REQUIRED_MODULES"
+><code  class="code">REQUIRED_MODULES</code></a></dt>
+
+<dd>
+<p>An arrayref of hashrefs that describes the perl modules required by Bugzilla.
+The hashes have three keys:</p>
+
+<dl>
+<dt><a name="package_-_The_name_of_the_Perl_package_that_you&#39;d_find_on_CPAN_for_this_requirement."
+><code  class="code">package</code> - The name of the Perl package that you&#39;d find on CPAN for this requirement.</a></dt>
+
+<dd>
+<dt><a name="module_-_The_name_of_a_module_that_can_be_passed_to_the_install_command_in_CPAN.pm_to_install_this_module."
+><code  class="code">module</code> - The name of a module that can be passed to the <code  class="code">install</code> command in <code  class="code">CPAN.pm</code> to install this module.</a></dt>
+
+<dd>
+<dt><a name="version_-_The_version_of_this_module_that_we_require,_or_0_if_any_version_is_acceptable."
+><code  class="code">version</code> - The version of this module that we require,
+or <code  class="code">0</code> if any version is acceptable.</a></dt>
+</dl>
+
+<dt><a name="OPTIONAL_MODULES"
+><code  class="code">OPTIONAL_MODULES</code></a></dt>
+
+<dd>
+<p>An arrayref of hashrefs that describes the perl modules that add additional features to Bugzilla if installed.
+Its hashes have all the fields of <a href="#REQUIRED_MODULES" class="podlinkpod"
+>&#34;REQUIRED_MODULES&#34;</a>,
+plus a <code  class="code">feature</code> item--an arrayref of strings that describe what features require this module.</p>
+
+<dt><a name="FEATURE_FILES"
+><code  class="code">FEATURE_FILES</code></a></dt>
+
+<dd>
+<p>A hashref that describes what files should only be compiled if a certain feature is enabled.
+The feature is the key,
+and the values are arrayrefs of file names (which are passed to <code  class="code">glob</code>,
+so shell patterns work).</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SUBROUTINES"
+>SUBROUTINES</a></h1>
+
+<dl>
+<dt><a name="check_requirements"
+><code  class="code">check_requirements</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>This checks what optional or required perl modules are installed,
+like <code  class="code">checksetup.pl</code> does.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a 
+><code  class="code">$output</code> - <code  class="code">true</code> if you want the function to print out information about what it&#39;s doing,
+and the versions of everything installed.</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hashref containing these values:</p>
+
+<dl>
+<dt><a name="pass_-_Whether_or_not_we_have_all_the_mandatory_requirements."
+><code  class="code">pass</code> - Whether or not we have all the mandatory requirements.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">missing</code> - An arrayref containing any required modules that are not installed or that are not up-to-date.
+Each item in the array is a hashref in the format of items from <a href="#REQUIRED_MODULES" class="podlinkpod"
+>&#34;REQUIRED_MODULES&#34;</a>.</a></dt>
+
+<dd>
+<dt><a name="optional_-_The_same_as_missing,_but_for_optional_modules."
+><code  class="code">optional</code> - The same as <code  class="code">missing</code>,
+but for optional modules.</a></dt>
+
+<dd>
+<dt><a name="apache_-_The_name_of_each_optional_Apache_module_that_is_missing."
+><code  class="code">apache</code> - The name of each optional Apache module that is missing.</a></dt>
+
+<dd>
+<dt><a name="have_one_dbd_-_True_if_at_least_one_DBD::_module_is_installed."
+><code  class="code">have_one_dbd</code> - True if at least one <code  class="code">DBD::</code> module is installed.</a></dt>
+
+<dd>
+<dt><a name="any_missing_-_True_if_there_are_any_missing_Perl_modules,_even_optional_modules."
+><code  class="code">any_missing</code> - True if there are any missing Perl modules,
+even optional modules.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<dt><a name="check_graphviz($output)"
+><code  class="code">check_graphviz($output)</code></a></dt>
+
+<dd>
+<p>Description: Checks if the graphviz binary specified in the <code  class="code">webdotbase</code> parameter is a valid binary,
+or a valid URL.</p>
+
+<p>Params: <code  class="code">$output</code> - <code  class="code">$true</code> if you want the function to print out information about what it&#39;s doing.</p>
+
+<p>Returns: <code  class="code">1</code> if the check was successful,
+<code  class="code">0</code> otherwise.</p>
+
+<dt><a name="have_vers($module,_$output)"
+><code  class="code">have_vers($module,
+$output)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Tells you whether or not you have the appropriate
+              version of the module requested. It also prints
+              out a message to the user explaining the check
+              and the result.
+
+ Params:      C&#60;$module&#62; - A hashref, in the format of an item from 
+                           L&#60;/REQUIRED_MODULES&#62;.
+              C&#60;$output&#62; - Set to true if you want this function to
+                           print information to STDOUT about what it&#39;s
+                           doing.
+
+ Returns:   C&#60;1&#62; if you have the module installed and you have the
+            appropriate version. C&#60;0&#62; otherwise.</pre>
+
+<dt><a name="install_command($module)"
+><code  class="code">install_command($module)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Prints out the appropriate command to install the
+              module specified, depending on whether you&#39;re
+              on Windows or Linux.
+
+ Params:      C&#60;$module&#62; - A hashref, in the format of an item from
+                           L&#60;/REQUIRED_MODULES&#62;.
+
+ Returns:     nothing</pre>
+
+<dt><a name="map_files_to_features"
+><code  class="code">map_files_to_features</code></a></dt>
+
+<dd>
+<p>Returns a hashref where file names are the keys and the value is the feature that must be enabled in order to compile that file.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Install/Util.html b/docs/en/html/api/Bugzilla/Install/Util.html
new file mode 100644 (file)
index 0000000..1b8afe3
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Install/Util.html
@@ -0,0 +1,259 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Install::Util</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Install::Util</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#SUBROUTINES'>SUBROUTINES</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Install::Util - Utility functions that are useful both during installation and afterwards.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This module contains various subroutines that are used primarily during installation.
+However,
+these subroutines can also be useful to non-installation code,
+so they have been split out into this module.</p>
+
+<p>The difference between this module and <a href="../../Bugzilla/Util.html" class="podlinkpod"
+>Bugzilla::Util</a> is that this module is safe to <code  class="code">use</code> anywhere in Bugzilla,
+even during installation,
+because it depends only on <a href="../../Bugzilla/Constants.html" class="podlinkpod"
+>Bugzilla::Constants</a> and built-in perl modules.</p>
+
+<p>None of the subroutines are exported by default--you must explicitly export them.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SUBROUTINES"
+>SUBROUTINES</a></h1>
+
+<dl>
+<dt><a name="bin_loc"
+><code  class="code">bin_loc</code></a></dt>
+
+<dd>
+<p>On *nix systems,
+given the name of a binary,
+returns the path to that binary,
+if the binary is in the <code  class="code">PATH</code>.</p>
+
+<dt><a name="get_version_and_os"
+><code  class="code">get_version_and_os</code></a></dt>
+
+<dd>
+<p>Returns a hash containing information about what version of Bugzilla we&#39;re running,
+what perl version we&#39;re using,
+and what OS we&#39;re running on.</p>
+
+<dt><a name="get_console_locale"
+><code  class="code">get_console_locale</code></a></dt>
+
+<dd>
+<p>Returns the language to use based on the LC_CTYPE value returned by the OS.
+If LC_CTYPE is of the form fr-CH,
+then fr is appended to the list.</p>
+
+<dt><a name="init_console"
+><code  class="code">init_console</code></a></dt>
+
+<dd>
+<p>Sets the <code  class="code">ANSI_COLORS_DISABLED</code> and <code  class="code">HTTP_ACCEPT_LANGUAGE</code> environment variables.</p>
+
+<dt><a name="indicate_progress"
+><code  class="code">indicate_progress</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>This prints out lines of dots as a long update is going on,
+to let the user know where we are and that we&#39;re not frozen.
+A new line of dots will start every 60 dots.</p>
+
+<p>Sample usage: <code  class="code">indicate_progress({ total =&#62; $total,
+current =&#62; $count,
+every =&#62; 1 })</code></p>
+
+<dt><a name="Sample_Output"
+><b>Sample Output</b></a></dt>
+
+<dd>
+<p>Here&#39;s some sample output with <code  class="code">total = 1000</code> and <code  class="code">every = 10</code>:</p>
+
+<pre  class="code"> ............................................................600/1000 (60%)
+ ........................................</pre>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="total_-_The_total_number_of_items_we&#39;re_processing."
+><code  class="code">total</code> - The total number of items we&#39;re processing.</a></dt>
+
+<dd>
+<dt><a name="current_-_The_number_of_the_current_item_we&#39;re_processing."
+><code  class="code">current</code> - The number of the current item we&#39;re processing.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">every</code> - How often the function should print out a dot. For example, if this is 10, the function will print out a dot every ten items. Defaults to 1 if not specified.</a></dt>
+</dl>
+
+<dt><a name="Returns:_nothing"
+><b>Returns</b>: nothing</a></dt>
+</dl>
+
+<dt><a name="install_string"
+><code  class="code">install_string</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>This is a very simple method of templating strings for installation. It should only be used by code that has to run before the Template Toolkit can be used. (See the comments at the top of the various <a href="../../Bugzilla/Install.html" class="podlinkpod"
+>Bugzilla::Install</a> modules to find out when it&#39;s safe to use Template Toolkit.)</p>
+
+<p>It pulls strings out of the <em  class="code">strings.txt.pl</em> &#34;template&#34; and replaces any variable surrounded by double-hashes (##) with a value you specify.</p>
+
+<p>This allows for localization of strings used during installation.</p>
+
+<dt><a name="Example"
+><b>Example</b></a></dt>
+
+<dd>
+<p>Let&#39;s say your template string looks like this:</p>
+
+<pre  class="code"> The ##animal## jumped over the ##plant##.</pre>
+
+<p>Let&#39;s say that string is called &#39;animal_jump_plant&#39;. So you call the function like this:</p>
+
+<pre  class="code"> install_string(&#39;animal_jump_plant&#39;, { animal =&#62; &#39;fox&#39;, plant =&#62; &#39;tree&#39; });</pre>
+
+<p>That will output this:</p>
+
+<pre  class="code"> The fox jumped over the tree.</pre>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$string_id_-_The_name_of_the_string_from_strings.txt.pl."
+><code  class="code">$string_id</code> - The name of the string from <em  class="code">strings.txt.pl</em>.</a></dt>
+
+<dd>
+<dt><a name="$vars_-_A_hashref_containing_the_replacement_values_for_variables_inside_of_the_string."
+><code  class="code">$vars</code> - A hashref containing the replacement values for variables inside of the string.</a></dt>
+</dl>
+
+<dt><a name="Returns:_The_appropriate_string,_with_variables_replaced."
+><b>Returns</b>: The appropriate string, with variables replaced.</a></dt>
+</dl>
+
+<dt><a name="template_include_path"
+><code  class="code">template_include_path</code></a></dt>
+
+<dd>
+<p>Used by <a href="../../Bugzilla/Template.html" class="podlinkpod"
+>Bugzilla::Template</a> and <a href="#install_string" class="podlinkpod"
+>&#34;install_string&#34;</a> to determine the directories where templates are installed. Templates can be installed in many places. They&#39;re listed here in the basic order that they&#39;re searched:</p>
+
+<dl>
+<dt><a name="extensions/$extension/template/$language/$project"
+>extensions/<code  class="code">$extension</code>/template/<code  class="code">$language</code>/<code  class="code">$project</code></a></dt>
+
+<dd>
+<dt><a name="extensions/$extension/template/$language/custom"
+>extensions/<code  class="code">$extension</code>/template/<code  class="code">$language</code>/custom</a></dt>
+
+<dd>
+<dt><a name="extensions/$extension/template/$language/default"
+>extensions/<code  class="code">$extension</code>/template/<code  class="code">$language</code>/default</a></dt>
+
+<dd>
+<dt><a name="template/$language/$project"
+>template/<code  class="code">$language</code>/<code  class="code">$project</code></a></dt>
+
+<dd>
+<dt><a name="template/$language/custom"
+>template/<code  class="code">$language</code>/custom</a></dt>
+
+<dd>
+<dt><a name="template/$language/default"
+>template/<code  class="code">$language</code>/default</a></dt>
+</dl>
+
+<p><code  class="code">$project</code> has to do with installations that are using the <code  class="code">$ENV{PROJECT}</code> variable to have different &#34;views&#34; on a single Bugzilla.</p>
+
+<p>The <em  class="code">default</em> directory includes templates shipped with Bugzilla.</p>
+
+<p>The <em  class="code">custom</em> directory is a directory for local installations to override the <em  class="code">default</em> templates. Any individual template in <em  class="code">custom</em> will override a template of the same name and path in <em  class="code">default</em>.</p>
+
+<p><code  class="code">$language</code> is a language code, <code  class="code">en</code> being the default language shipped with Bugzilla. Localizers ship other languages.</p>
+
+<p><code  class="code">$extension</code> is the name of any directory in the <em  class="code">extensions/</em> directory. Each extension has its own directory.</p>
+
+<p>Note that languages are sorted by the user&#39;s preference (as specified in their browser, usually), and extensions are sorted alphabetically.</p>
+
+<dt><a name="include_languages"
+><code  class="code">include_languages</code></a></dt>
+
+<dd>
+<p>Used by <a href="../../Bugzilla/Template.html" class="podlinkpod"
+>Bugzilla::Template</a> to determine the languages&#39; list which are compiled with the browser&#39;s <i>Accept-Language</i> and the languages of installed templates.</p>
+
+<dt><a name="vers_cmp"
+><code  class="code">vers_cmp</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>This is a comparison function, like you would use in <code  class="code">sort</code>, except that it compares two version numbers. So, for example, 2.10 would be greater than 2.2.</p>
+
+<p>It&#39;s based on versioncmp from <a href="../../Sort/Versions.html" class="podlinkpod"
+>Sort::Versions</a>, with some Bugzilla-specific fixes.</p>
+
+<dt><a name="Params:_$a_and_$b_-_The_versions_you_want_to_compare."
+><b>Params</b>: <code  class="code">$a</code> and <code  class="code">$b</code> - The versions you want to compare.</a></dt>
+
+<dd>
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p><code  class="code">-1</code> if <code  class="code">$a</code> is less than <code  class="code">$b</code>, <code  class="code">0</code> if they are equal, or <code  class="code">1</code> if <code  class="code">$a</code> is greater than <code  class="code">$b</code>.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/JobQueue.html b/docs/en/html/api/Bugzilla/JobQueue.html
new file mode 100644 (file)
index 0000000..1654d4f
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/JobQueue.html
@@ -0,0 +1,54 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::JobQueue</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::JobQueue</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Inserting_a_Job'>Inserting a Job</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::JobQueue - Interface between Bugzilla and TheSchwartz.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> use Bugzilla;
+
+ my $obj = Bugzilla-&#62;job_queue();
+ $obj-&#62;insert(&#39;send_mail&#39;, { msg =&#62; $message });</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Certain tasks should be done asyncronously. The job queue system allows Bugzilla to use some sort of service to schedule jobs to happen asyncronously.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Inserting_a_Job"
+>Inserting a Job</a></h2>
+
+<p>See the synopsis above for an easy to follow example on how to insert a job into the queue. Give it a name and some arguments and the job will be sent away to be done later.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/JobQueue/Runner.html b/docs/en/html/api/Bugzilla/JobQueue/Runner.html
new file mode 100644 (file)
index 0000000..4d5dfd2
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/JobQueue/Runner.html
@@ -0,0 +1,45 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::JobQueue::Runner</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::JobQueue::Runner</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::JobQueue::Runner - A class representing the daemon that runs the job queue.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> use Bugzilla::JobQueue::Runner;
+ Bugzilla::JobQueue::Runner-&#62;new();</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This is a subclass of <a href="../../Daemon/Generic.html" class="podlinkpod"
+>Daemon::Generic</a> that is used by <a href="../../jobqueue.html" class="podlinkpod"
+>jobqueue</a> to run the Bugzilla job queue.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Keyword.html b/docs/en/html/api/Bugzilla/Keyword.html
new file mode 100644 (file)
index 0000000..20e4e8a
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Keyword.html
@@ -0,0 +1,72 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Keyword</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Keyword</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#SUBROUTINES'>SUBROUTINES</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Keyword - A Keyword that can be added to a bug.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> use Bugzilla::Keyword;
+
+ my $description = $keyword-&#62;description;
+
+ my $keywords = Bugzilla::Keyword-&#62;get_all_with_bug_count();</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Bugzilla::Keyword represents a keyword that can be added to a bug.</p>
+
+<p>This implements all standard <code  class="code">Bugzilla::Object</code> methods. See <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a> for more details.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SUBROUTINES"
+>SUBROUTINES</a></h1>
+
+<p>This is only a list of subroutines specific to <code  class="code">Bugzilla::Keyword</code>. See <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a> for more subroutines that this object implements.</p>
+
+<dl>
+<dt><a name="get_all_with_bug_count()"
+><code  class="code">get_all_with_bug_count()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns all defined keywords. This is an efficient way
+              to get the associated bug counts, as only one SQL query
+              is executed with this method, instead of one per keyword
+              when calling get_all and then bug_count.
+ Params:      none
+ Returns:     A reference to an array of Keyword objects, or an empty
+              arrayref if there are no keywords.</pre>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Migrate.html b/docs/en/html/api/Bugzilla/Migrate.html
new file mode 100644 (file)
index 0000000..5c81eba
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Migrate.html
@@ -0,0 +1,378 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Migrate</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Migrate</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#HOW_MIGRATION_WORKS'>HOW MIGRATION WORKS</a>
+  <li class='indexItem indexItem1'><a href='#CONSTRUCTOR'>CONSTRUCTOR</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#load'>load</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#METHODS_YOUR_SUBCLASS_CAN_USE'>METHODS YOUR SUBCLASS CAN USE</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#config'>config</a>
+    <li class='indexItem indexItem2'><a href='#debug'>debug</a>
+    <li class='indexItem indexItem2'><a href='#parse_date'>parse_date</a>
+    <li class='indexItem indexItem2'><a href='#translate_bug'>translate_bug</a>
+    <li class='indexItem indexItem2'><a href='#translate_value'>translate_value</a>
+    <li class='indexItem indexItem2'><a href='#translate_field'>translate_field</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#METHODS_YOU_MUST_IMPLEMENT'>METHODS YOU MUST IMPLEMENT</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#_read_bugs'>_read_bugs</a>
+    <li class='indexItem indexItem2'><a href='#_read_products'>_read_products</a>
+    <li class='indexItem indexItem2'><a href='#_read_users'>_read_users</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#METHODS_YOU_MIGHT_WANT_TO_IMPLEMENT'>METHODS YOU MIGHT WANT TO IMPLEMENT</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#REQUIRED_MODULES'>REQUIRED_MODULES</a>
+    <li class='indexItem indexItem2'><a href='#CUSTOM_FIELDS'>CUSTOM_FIELDS</a>
+    <li class='indexItem indexItem2'><a href='#CONFIG_VARS'>CONFIG_VARS</a>
+    <li class='indexItem indexItem2'><a href='#NON_COMMENT_FIELDS'>NON_COMMENT_FIELDS</a>
+    <li class='indexItem indexItem2'><a href='#after_read'>after_read</a>
+    <li class='indexItem indexItem2'><a href='#before_insert'>before_insert</a>
+    <li class='indexItem indexItem2'><a href='#after_insert'>after_insert</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Migrate - Functions to migrate from other databases</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This module acts as a base class for the various modules that migrate from other bug-trackers.</p>
+
+<p>The documentation for this module exists mostly to assist people in creating new migrators for other bug-trackers than the ones currently supported.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="HOW_MIGRATION_WORKS"
+>HOW MIGRATION WORKS</a></h1>
+
+<p>Before writing anything to the Bugzilla database,
+the migrator will read everything from the other bug-tracker&#39;s database.
+Here&#39;s the exact order of what happens:</p>
+
+<ol>
+<li>Users are read from the other bug-tracker.</li>
+
+<li>Products are read from the other bug-tracker.</li>
+
+<li>Bugs are read from the other bug-tracker.</li>
+
+<li>The <a href="#after_read" class="podlinkpod"
+>&#34;after_read&#34;</a> method is called.</li>
+
+<li>All bugs are translated from the other bug-tracker&#39;s fields/values into Bugzilla&#39;s fields values using <a href="#translate_bug" class="podlinkpod"
+>&#34;translate_bug&#34;</a>.</li>
+
+<li>Users are inserted into Bugzilla.</li>
+
+<li>Products are inserted into Bugzilla.</li>
+
+<li>Some migrators need to create custom fields before migrating,
+and so that happens here.</li>
+
+<li>Any legal values that need to be created for any drop-down or multi-select fields are created.
+This is done by reading all the values on every bug that was read in and creating any values that don&#39;t already exist in Bugzilla for every drop-down or multi-select field on each bug.
+This includes creating any product versions and milestones that need to be created.</li>
+
+<li>Bugs are inserted into Bugzilla.</li>
+
+<li>The <a href="#after_insert" class="podlinkpod"
+>&#34;after_insert&#34;</a> method is called.</li>
+</ol>
+
+<p>Everything happens in one big transaction,
+so in general,
+if there are any errors during the process,
+nothing will be changed.</p>
+
+<p>The migrator never creates anything that already exists.
+So users,
+products,
+components,
+etc.
+that already exist will just be re-used by this script,
+not re-created.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CONSTRUCTOR"
+>CONSTRUCTOR</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="load"
+>load</a></h2>
+
+<p>Called like <code  class="code">Bugzilla::Migrate-&#62;load(&#39;Module&#39;)</code>.
+Returns a new <code  class="code">Bugzilla::Migrate</code> object that can be used to migrate from the requested bug-tracker.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS_YOUR_SUBCLASS_CAN_USE"
+>METHODS YOUR SUBCLASS CAN USE</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="config"
+>config</a></h2>
+
+<p>Takes a single parameter,
+a string,
+and returns the value of the configuration variable with that name (always a scalar).
+The first time you call <code  class="code">config</code>,
+if the configuration file hasn&#39;t been read,
+it will be read in.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="debug"
+>debug</a></h2>
+
+<p>If the user hasn&#39;t specified <code  class="code">--verbose</code> on the command line,
+this does nothing.</p>
+
+<p>Takes two arguments:</p>
+
+<p>The first argument is a string or reference to print to <code  class="code">STDERR</code>.
+If it&#39;s a reference,
+<a href="../Data/Dumper.html" class="podlinkpod"
+>Data::Dumper</a> will be used to print the data structure.</p>
+
+<p>The second argument is a number--the string will only be printed if the user specified <code  class="code">--verbose</code> at least that many times on the command line.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="parse_date"
+>parse_date</a></h2>
+
+<p>(Note: Usually you don&#39;t need to call this,
+because <a href="#translate_bug" class="podlinkpod"
+>&#34;translate_bug&#34;</a> handles date translations for you,
+for bug data.)</p>
+
+<p>Parses a date string and returns a formatted date string that can be inserted into the database.
+If the input date is missing a timezone,
+the &#34;timezone&#34; configuration parameter will be used as the timezone of the date.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="translate_bug"
+>translate_bug</a></h2>
+
+<p>(Note: Normally you don&#39;t have to call this yourself,
+as <code  class="code">Bugzilla::Migrate</code> does it for you.)</p>
+
+<p>Uses the <code  class="code">$translate_fields</code> and <code  class="code">$translate_values</code> configuration variables to convert a hashref of &#34;other bug-tracker&#34; fields into Bugzilla fields.
+It takes one argument,
+the hashref to convert.
+Any unrecognized fields will have their value prepended to the <code  class="code">comment</code> element in the returned hashref,
+unless they are listed in <a href="#NON_COMMENT_FIELDS" class="podlinkpod"
+>&#34;NON_COMMENT_FIELDS&#34;</a>.</p>
+
+<p>In scalar context,
+returns the translated bug.
+In array context,
+returns both the translated bug and a second hashref containing the values of any untranslated fields that were listed in <code  class="code">NON_COMMENT_FIELDS</code>.</p>
+
+<p><b>Note:</b> To save memory,
+the hashref that you pass in will be destroyed (all keys will be deleted).</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="translate_value"
+>translate_value</a></h2>
+
+<p>(Note: Generally you only need to use this during <a href="#_read_products" class="podlinkpod"
+>&#34;_read_products&#34;</a> and <a href="#_read_users" class="podlinkpod"
+>&#34;_read_users&#34;</a> if necessary,
+because the data returned from <a href="#_read_bugs" class="podlinkpod"
+>&#34;_read_bugs&#34;</a> will be put through <a href="#translate_bug" class="podlinkpod"
+>&#34;translate_bug&#34;</a>.)</p>
+
+<p>Uses the <code  class="code">$translate_values</code> configuration variable to convert field values from your bug-tracker to Bugzilla.
+Takes two arguments,
+the first being a field name and the second being a value.
+If the value is an arrayref,
+<code  class="code">translate_value</code> will be called recursively on all the array elements.</p>
+
+<p>Also,
+any date field will be converted into ISO 8601 format,
+for inserting into the database.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="translate_field"
+>translate_field</a></h2>
+
+<p>(Note: Normally you don&#39;t need to use this,
+because <a href="#translate_bug" class="podlinkpod"
+>&#34;translate_bug&#34;</a> handles it for you.)</p>
+
+<p>Translates a field name in your bug-tracker to a field name in Bugzilla,
+using the rules described in the description of the <code  class="code">$translate_fields</code> configuration variable.</p>
+
+<p>Takes a single argument--the name of a field to translate.</p>
+
+<p>Returns <code  class="code">undef</code> if the field could not be translated.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS_YOU_MUST_IMPLEMENT"
+>METHODS YOU MUST IMPLEMENT</a></h1>
+
+<p>These are methods that subclasses must implement:</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="_read_bugs"
+>_read_bugs</a></h2>
+
+<p>Should return an arrayref of hashes.
+The hashes will be passed to <a href="../Bugzilla/Bug.html#create" class="podlinkpod"
+>&#34;create&#34; in Bugzilla::Bug</a> to create bugs in Bugzilla.
+In addition to the normal <code  class="code">create</code> fields,
+the hashes can contain three additional items:</p>
+
+<dl>
+<dt><a name="comments"
+>comments</a></dt>
+
+<dd>
+<p>An arrayref of hashes,
+representing comments to be added to the database.
+The keys should be the names of columns in the longdescs table that you want to set for each comment.
+<code  class="code">who</code> must be a username instead of a user id,
+though.</p>
+
+<p>You don&#39;t need to specify a value for the <code  class="code">bug_id</code> column.</p>
+
+<dt><a name="history"
+>history</a></dt>
+
+<dd>
+<p>An arrayref of hashes,
+representing the history of changes made to this bug.
+The keys should be the names of columns in the bugs_activity table to set for each change.
+<code  class="code">who</code> must be a username instead of a user id,
+though,
+and <code  class="code">field</code> (containing the name of some field) is taken instead of <code  class="code">fieldid</code>.</p>
+
+<p>You don&#39;t need to specify a value for the <code  class="code">bug_id</code> column.</p>
+
+<dt><a name="attachments"
+>attachments</a></dt>
+
+<dd>
+<p>An arrayref of hashes,
+representing values to pass to <a href="../Bugzilla/Attachment.html#create" class="podlinkpod"
+>&#34;create&#34; in Bugzilla::Attachment</a>.
+(Remember that the <code  class="code">data</code> argument must be a file handle--we recommend using <a href="../IO/File.html#new_tmpfile" class="podlinkpod"
+>&#34;new_tmpfile&#34; in IO::File</a> to create anonymous temporary files for this purpose.) You should specify a <code  class="code">submitter</code> argument containing the username of the attachment&#39;s submitter.</p>
+
+<p>You don&#39;t need to specify a value for the the <code  class="code">bug</code> argument.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="_read_products"
+>_read_products</a></h2>
+
+<p>Should return an arrayref of hashes to pass to <a href="../Bugzilla/Product.html#create" class="podlinkpod"
+>&#34;create&#34; in Bugzilla::Product</a>.
+In addition to the normal <code  class="code">create</code> fields,
+this also accepts an additional argument,
+<code  class="code">components</code>,
+which is an arrayref of hashes to pass to <a href="../Bugzilla/Component.html#create" class="podlinkpod"
+>&#34;create&#34; in Bugzilla::Component</a> (though you do not need to specify the <code  class="code">product</code> argument for <a href="../Bugzilla/Component.html#create" class="podlinkpod"
+>&#34;create&#34; in Bugzilla::Component</a>).</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="_read_users"
+>_read_users</a></h2>
+
+<p>Should return an arrayref of hashes to be passed to <a href="../Bugzilla/User.html#create" class="podlinkpod"
+>&#34;create&#34; in Bugzilla::User</a>.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS_YOU_MIGHT_WANT_TO_IMPLEMENT"
+>METHODS YOU MIGHT WANT TO IMPLEMENT</a></h1>
+
+<p>These are methods that you may want to override in your migrator.
+All of these methods are called on an instantiated <a href="../Bugzilla/Migrate.html" class="podlinkpod"
+>Bugzilla::Migrate</a> object of your subclass by <a href="../Bugzilla/Migrate.html" class="podlinkpod"
+>Bugzilla::Migrate</a> itself.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="REQUIRED_MODULES"
+>REQUIRED_MODULES</a></h2>
+
+<p>Returns an arrayref of Perl modules that must be installed in order for your migrator to run,
+in the same format as <a href="../Bugzilla/Install/Requirements.html#REQUIRED_MODULES" class="podlinkpod"
+>&#34;REQUIRED_MODULES&#34; in Bugzilla::Install::Requirements</a>.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="CUSTOM_FIELDS"
+>CUSTOM_FIELDS</a></h2>
+
+<p>Returns a hashref,
+where the keys are the names of custom fields to create in the database before inserting bugs.
+The values of the hashref are the arguments (other than &#34;name&#34;) that should be passed to Bugzilla::Field-&#62;create() when creating the field.
+(<code  class="code">custom =&#62; 1</code> will be specified automatically for you,
+so you don&#39;t need to specify it.)</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="CONFIG_VARS"
+>CONFIG_VARS</a></h2>
+
+<p>This should return an array (not an arrayref) in the same format as <a href="../Bugzilla/Install/Localconfig.html#LOCALCONFIG_VARS" class="podlinkpod"
+>&#34;LOCALCONFIG_VARS&#34; in Bugzilla::Install::Localconfig</a>,
+describing configuration variables for migrating from your bug-tracker.
+You should always include the default <code  class="code">CONFIG_VARS</code> (by calling $self-&#62;SUPER::CONFIG_VARS) as part of your return value,
+if you override this method.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="NON_COMMENT_FIELDS"
+>NON_COMMENT_FIELDS</a></h2>
+
+<p>An array (not an arrayref).
+If there are fields that are not translated and yet shouldn&#39;t be added to the initial description of the bug when translating bugs,
+then they should be listed here.
+See <a href="#translate_bug" class="podlinkpod"
+>&#34;translate_bug&#34;</a> for more detail.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="after_read"
+>after_read</a></h2>
+
+<p>This is run after all data is read from the other bug-tracker,
+but before the bug fields/values have been translated,
+and before any data is inserted into Bugzilla.
+The default implementation does nothing.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="before_insert"
+>before_insert</a></h2>
+
+<p>This is called after all bugs are translated from their &#34;other bug-tracker&#34; values to Bugzilla values,
+but before any data is inserted into the database or any custom fields are created.
+The default implementation does nothing.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="after_insert"
+>after_insert</a></h2>
+
+<p>This is run after all data is inserted into Bugzilla.
+The default implementation does nothing.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Milestone.html b/docs/en/html/api/Bugzilla/Milestone.html
new file mode 100644 (file)
index 0000000..36d365e
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Milestone.html
@@ -0,0 +1,193 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Milestone</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Milestone</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <li class='indexItem indexItem1'><a href='#CLASS_METHODS'>CLASS METHODS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Milestone - Bugzilla product milestone class.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">    use Bugzilla::Milestone;
+
+    my $milestone = new Bugzilla::Milestone({ name =&#62; $name, product =&#62; $product_obj });
+    my $milestone = Bugzilla::Milestone-&#62;check({ name =&#62; $name, product =&#62; $product_obj });
+    my $milestone = Bugzilla::Milestone-&#62;check({ id =&#62; $id });
+
+    my $name       = $milestone-&#62;name;
+    my $product_id = $milestone-&#62;product_id;
+    my $product    = $milestone-&#62;product;
+    my $sortkey    = $milestone-&#62;sortkey;
+
+    my $milestone = Bugzilla::Milestone-&#62;create(
+        { value =&#62; $name, product =&#62; $product, sortkey =&#62; $sortkey });
+
+    $milestone-&#62;set_name($new_name);
+    $milestone-&#62;set_sortkey($new_sortkey);
+    $milestone-&#62;update();
+
+    $milestone-&#62;remove_from_db;</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Milestone.pm represents a Product Milestone object.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<dl>
+<dt><a name="new({name_=&#62;_$name,_product_=&#62;_$product})"
+><code  class="code">new({name =&#62; $name, product =&#62; $product})</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: The constructor is used to load an existing milestone
+              by passing a product object and a milestone name.
+
+ Params:      $product - a Bugzilla::Product object.
+              $name - the name of a milestone (string).
+
+ Returns:     A Bugzilla::Milestone object.</pre>
+
+<dt><a name="name()"
+><code  class="code">name()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Name (value) of the milestone.
+
+ Params:      none.
+
+ Returns:     The name of the milestone.</pre>
+
+<dt><a name="product_id()"
+><code  class="code">product_id()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: ID of the product the milestone belongs to.
+
+ Params:      none.
+
+ Returns:     The ID of a product.</pre>
+
+<dt><a name="product()"
+><code  class="code">product()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: The product object of the product the milestone belongs to.
+
+ Params:      none.
+
+ Returns:     A Bugzilla::Product object.</pre>
+
+<dt><a name="sortkey()"
+><code  class="code">sortkey()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Sortkey of the milestone.
+
+ Params:      none.
+
+ Returns:     The sortkey of the milestone.</pre>
+
+<dt><a name="bug_count()"
+><code  class="code">bug_count()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns the total of bugs that belong to the milestone.
+
+ Params:      none.
+
+ Returns:     Integer with the number of bugs.</pre>
+
+<dt><a name="set_name($new_name)"
+><code  class="code">set_name($new_name)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Changes the name of the milestone.
+
+ Params:      $new_name - new name of the milestone (string). This name
+                          must be unique within the product.
+
+ Returns:     Nothing.</pre>
+
+<dt><a name="set_sortkey($new_sortkey)"
+><code  class="code">set_sortkey($new_sortkey)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Changes the sortkey of the milestone.
+
+ Params:      $new_sortkey - new sortkey of the milestone (signed integer).
+
+ Returns:     Nothing.</pre>
+
+<dt><a name="update()"
+><code  class="code">update()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Writes the new name and/or the new sortkey into the DB.
+
+ Params:      none.
+
+ Returns:     A hashref with changes made to the milestone object.</pre>
+
+<dt><a name="remove_from_db()"
+><code  class="code">remove_from_db()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Deletes the current milestone from the DB. The object itself
+              is not destroyed.
+
+ Params:      none.
+
+ Returns:     Nothing.</pre>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CLASS_METHODS"
+>CLASS METHODS</a></h1>
+
+<dl>
+<dt><a name="create({value_=&#62;_$value,_product_=&#62;_$product,_sortkey_=&#62;_$sortkey})"
+><code  class="code">create({value =&#62; $value, product =&#62; $product, sortkey =&#62; $sortkey})</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Create a new milestone for the given product.
+
+ Params:      $value   - name of the new milestone (string). This name
+                         must be unique within the product.
+              $product - a Bugzilla::Product object.
+              $sortkey - the sortkey of the new milestone (signed integer)
+
+ Returns:     A Bugzilla::Milestone object.</pre>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Object.html b/docs/en/html/api/Bugzilla/Object.html
new file mode 100644 (file)
index 0000000..288562d
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Object.html
@@ -0,0 +1,572 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Object</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Object</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#CONSTANTS'>CONSTANTS</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Constructors'>Constructors</a>
+    <li class='indexItem indexItem2'><a href='#Database_Manipulation'>Database Manipulation</a>
+    <li class='indexItem indexItem2'><a href='#Mutators'>Mutators</a>
+    <li class='indexItem indexItem2'><a href='#Simple_Validators'>Simple Validators</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#CLASS_FUNCTIONS'>CLASS FUNCTIONS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Object - A base class for objects in Bugzilla.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> my $object = new Bugzilla::Object(1);
+ my $object = new Bugzilla::Object({name =&#62; &#39;TestProduct&#39;});
+
+ my $id          = $object-&#62;id;
+ my $name        = $object-&#62;name;</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Bugzilla::Object is a base class for Bugzilla objects. You never actually create a Bugzilla::Object directly, you only make subclasses of it.</p>
+
+<p>Basically, Bugzilla::Object exists to allow developers to create objects more easily. All you have to do is define <code  class="code">DB_TABLE</code>, <code  class="code">DB_COLUMNS</code>, and sometimes <code  class="code">LIST_ORDER</code> and you have a whole new object.</p>
+
+<p>You should also define accessors for any columns other than <code  class="code">name</code> or <code  class="code">id</code>.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CONSTANTS"
+>CONSTANTS</a></h1>
+
+<p>Frequently, these will be the only things you have to define in your subclass in order to have a fully-functioning object. <code  class="code">DB_TABLE</code> and <code  class="code">DB_COLUMNS</code> are required.</p>
+
+<dl>
+<dt><a name="DB_TABLE"
+><code  class="code">DB_TABLE</code></a></dt>
+
+<dd>
+<p>The name of the table that these objects are stored in. For example, for <code  class="code">Bugzilla::Keyword</code> this would be <code  class="code">keyworddefs</code>.</p>
+
+<dt><a name="DB_COLUMNS"
+><code  class="code">DB_COLUMNS</code></a></dt>
+
+<dd>
+<p>The names of the columns that you want to read out of the database and into this object. This should be an array.</p>
+
+<p><i>Note</i>: Though normally you will never need to access this constant&#39;s data directly in your subclass, if you do, you should access it by calling the <code  class="code">_get_db_columns</code> method instead of accessing the constant directly. (The only exception to this rule is calling <code  class="code">SUPER::DB_COLUMNS</code> from within your own <code  class="code">DB_COLUMNS</code> subroutine in a subclass.)</p>
+
+<dt><a name="NAME_FIELD"
+><code  class="code">NAME_FIELD</code></a></dt>
+
+<dd>
+<p>The name of the column that should be considered to be the unique &#34;name&#34; of this object. The &#39;name&#39; is a <b>string</b> that uniquely identifies this Object in the database. Defaults to &#39;name&#39;. When you specify <code  class="code">{name =&#62; $name}</code> to <code  class="code">new()</code>, this is the column that will be matched against in the DB.</p>
+
+<dt><a name="ID_FIELD"
+><code  class="code">ID_FIELD</code></a></dt>
+
+<dd>
+<p>The name of the column that represents the unique <b>integer</b> ID of this object in the database. Defaults to &#39;id&#39;.</p>
+
+<dt><a name="LIST_ORDER"
+><code  class="code">LIST_ORDER</code></a></dt>
+
+<dd>
+<p>The order that <code  class="code">new_from_list</code> and <code  class="code">get_all</code> should return objects in. This should be the name of a database column. Defaults to <a href="#NAME_FIELD" class="podlinkpod"
+>&#34;NAME_FIELD&#34;</a>.</p>
+
+<dt><a name="VALIDATORS"
+><code  class="code">VALIDATORS</code></a></dt>
+
+<dd>
+<p>A hashref that points to a function that will validate each param to <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a>.</p>
+
+<p>Validators are called both by <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a> and <a href="#set" class="podlinkpod"
+>&#34;set&#34;</a>. When they are called by <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a>, the first argument will be the name of the class (what we normally call <code  class="code">$class</code>).</p>
+
+<p>When they are called by <a href="#set" class="podlinkpod"
+>&#34;set&#34;</a>, the first argument will be a reference to the current object (what we normally call <code  class="code">$self</code>).</p>
+
+<p>The second argument will be the value passed to <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a> or <a href="#set" class="podlinkpod"
+>&#34;set&#34;</a>for that field.</p>
+
+<p>The third argument will be the name of the field being validated. This may be required by validators which validate several distinct fields.</p>
+
+<p>These functions should call <a href="../Bugzilla/Error.html#ThrowUserError" class="podlinkpod"
+>&#34;ThrowUserError&#34; in Bugzilla::Error</a> if they fail.</p>
+
+<p>The validator must return the validated value.</p>
+
+<dt><a name="UPDATE_VALIDATORS"
+><code  class="code">UPDATE_VALIDATORS</code></a></dt>
+
+<dd>
+<p>This is just like <a href="#VALIDATORS" class="podlinkpod"
+>&#34;VALIDATORS&#34;</a>, but these validators are called only when updating an object, not when creating it. Any validator that appears here must not appear in <a href="#VALIDATORS" class="podlinkpod"
+>&#34;VALIDATORS&#34;</a>.</p>
+
+<p><a href="../Bugzilla/Bug.html" class="podlinkpod"
+>Bugzilla::Bug</a> has good examples in its code of when to use this.</p>
+
+<dt><a name="VALIDATOR_DEPENDENCIES"
+><code  class="code">VALIDATOR_DEPENDENCIES</code></a></dt>
+
+<dd>
+<p>During <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a> and <a href="#set_all" class="podlinkpod"
+>&#34;set_all&#34;</a>, validators are normally called in a somewhat-random order. If you need one field to be validated and set before another field, this constant is how you do it, by saying that one field &#34;depends&#34; on the value of other fields.</p>
+
+<p>This is a hashref, where the keys are field names and the values are arrayrefs of field names. You specify what fields a field depends on using the arrayrefs. So, for example, to say that a <code  class="code">component</code> field depends on the <code  class="code">product</code> field being set, you would do:</p>
+
+<pre  class="code"> component =&#62; [&#39;product&#39;]</pre>
+
+<dt><a name="UPDATE_COLUMNS"
+><code  class="code">UPDATE_COLUMNS</code></a></dt>
+
+<dd>
+<p>A list of columns to update when <a href="#update" class="podlinkpod"
+>&#34;update&#34;</a> is called. If a field can&#39;t be changed, it shouldn&#39;t be listed here. (For example, the <a href="#ID_FIELD" class="podlinkpod"
+>&#34;ID_FIELD&#34;</a> usually can&#39;t be updated.)</p>
+
+<dt><a name="REQUIRED_FIELD_MAP"
+><code  class="code">REQUIRED_FIELD_MAP</code></a></dt>
+
+<dd>
+<p>This is a hashref that maps database column names to <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a> argument names. You only need to specify values for fields where the argument passed to <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a> has a different name in the database than it does in the <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a> arguments. (For example, <a href="../Bugzilla/Bug.html#create" class="podlinkpod"
+>&#34;create&#34; in Bugzilla::Bug</a> takes a <code  class="code">product</code> argument, but the column name in the <code  class="code">bugs</code> table is <code  class="code">product_id</code>.)</p>
+
+<dt><a name="EXTRA_REQUIRED_FIELDS"
+><code  class="code">EXTRA_REQUIRED_FIELDS</code></a></dt>
+
+<dd>
+<p>Normally, Bugzilla::Object automatically figures out which fields are required for <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a>. It then <i>always</i> runs those fields&#39; validators, even if those fields weren&#39;t passed as arguments to <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a>. That way, any default values or required checks can be done for those fields by the validators.</p>
+
+<p><a href="#create" class="podlinkpod"
+>&#34;create&#34;</a> figures out which fields are required by looking for database columns in the <a href="#DB_TABLE" class="podlinkpod"
+>&#34;DB_TABLE&#34;</a> that are NOT NULL and have no DEFAULT set. However, there are some fields that this check doesn&#39;t work for:</p>
+
+<ul>
+<li>Fields that have database defaults (or are marked NULL in the database) but actually have different defaults specified by validators. (For example, the qa_contact field in the <code  class="code">bugs</code> table can be NULL, so it won&#39;t be caught as being required. However, in reality it defaults to the component&#39;s initial_qa_contact.)</li>
+
+<li>Fields that have defaults that should be set by validators, but are actually stored in a table different from <a href="#DB_TABLE" class="podlinkpod"
+>&#34;DB_TABLE&#34;</a> (like the &#34;cc&#34; field for bugs, which defaults to the &#34;initialcc&#34; of the Component, but won&#39;t be caught as a normal required field because it&#39;s in a separate table.)</li>
+</ul>
+
+<p>Any field matching the above criteria needs to have its name listed in this constant. For an example of use, see the code of <a href="../Bugzilla/Bug.html" class="podlinkpod"
+>Bugzilla::Bug</a>.</p>
+
+<dt><a name="NUMERIC_COLUMNS"
+><code  class="code">NUMERIC_COLUMNS</code></a></dt>
+
+<dd>
+<p>When <a href="#update" class="podlinkpod"
+>&#34;update&#34;</a> is called, it compares each column in the object to its current value in the database. It only updates columns that have changed.</p>
+
+<p>Any column listed in NUMERIC_COLUMNS is treated as a number, not as a string, during these comparisons.</p>
+
+<dt><a name="DATE_COLUMNS"
+><code  class="code">DATE_COLUMNS</code></a></dt>
+
+<dd>
+<p>This is much like <a href="#NUMERIC_COLUMNS" class="podlinkpod"
+>&#34;NUMERIC_COLUMNS&#34;</a>, except that it treats strings as dates when being compared. So, for example, <code  class="code">2007-01-01</code> would be equal to <code  class="code">2007-01-01 00:00:00</code>.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Constructors"
+>Constructors</a></h2>
+
+<dl>
+<dt><a name="new"
+><code  class="code">new</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>The constructor is used to load an existing object from the database, by id or by name.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p>If you pass an integer, the integer is the id of the object, from the database, that we want to read in. (id is defined as the value in the <a href="#ID_FIELD" class="podlinkpod"
+>&#34;ID_FIELD&#34;</a> column).</p>
+
+<p>If you pass in a hashref, you can pass a <code  class="code">name</code> key. The value of the <code  class="code">name</code> key is the case-insensitive name of the object (from <a href="#NAME_FIELD" class="podlinkpod"
+>&#34;NAME_FIELD&#34;</a>) in the DB. You can also pass in an <code  class="code">id</code> key which will be interpreted as the id of the object you want (overriding the <code  class="code">name</code> key).</p>
+
+<p><b>Additional Parameters Available for Subclasses</b></p>
+
+<p>If you are a subclass of <code  class="code">Bugzilla::Object</code>, you can pass <code  class="code">condition</code> and <code  class="code">values</code> as hash keys, instead of the above.</p>
+
+<p><code  class="code">condition</code> is a set of SQL conditions for the WHERE clause, which contain placeholders.</p>
+
+<p><code  class="code">values</code> is a reference to an array. The array contains the values for each placeholder in <code  class="code">condition</code>, in order.</p>
+
+<p>This is to allow subclasses to have complex parameters, and then to translate those parameters into <code  class="code">condition</code> and <code  class="code">values</code> when they call <code  class="code">$self-&#62;SUPER::new</code> (which is this function, usually).</p>
+
+<p>If you try to call <code  class="code">new</code> outside of a subclass with the <code  class="code">condition</code> and <code  class="code">values</code> parameters, Bugzilla will throw an error. These parameters are intended <b>only</b> for use by subclasses.</p>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A fully-initialized object, or <code  class="code">undef</code> if there is no object in the database matching the parameters you passed in.</p>
+</dd>
+</dl>
+
+<dt><a name="check"
+><code  class="code">check</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Checks if there is an object in the database with the specified name, and throws an error if you specified an empty name, or if there is no object in the database with that name.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p>The parameters are the same as for <a href="#new" class="podlinkpod"
+>&#34;new&#34;</a>, except that if you don&#39;t pass a hashref, the single argument is the <i>name</i> of the object, not the id.</p>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A fully initialized object, guaranteed.</p>
+
+<dt><a name="Notes_For_Implementors"
+><b>Notes For Implementors</b></a></dt>
+
+<dd>
+<p>If you implement this in your subclass, make sure that you also update the <code  class="code">object_name</code> block at the bottom of the <em  class="code">global/user-error.html.tmpl</em> template.</p>
+</dd>
+</dl>
+
+<dt><a name="new_from_list(\@id_list)"
+><code  class="code">new_from_list(\@id_list)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Creates an array of objects, given an array of ids.
+
+ Params:      \@id_list - A reference to an array of numbers, database ids.
+                          If any of these are not numeric, the function
+                          will throw an error. If any of these are not
+                          valid ids in the database, they will simply 
+                          be skipped.
+
+ Returns:     A reference to an array of objects.</pre>
+
+<dt><a name="match"
+><code  class="code">match</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Gets a list of objects from the database based on certain criteria.</p>
+
+<p>Basically, a simple way of doing a sort of &#34;SELECT&#34; statement (like SQL) to get objects.</p>
+
+<p>All criteria are joined by <code  class="code">AND</code>, so adding more criteria will give you a smaller set of results, not a larger set.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p>A hashref, where the keys are column names of the table, pointing to the value that you want to match against for that column.</p>
+
+<p>There are two special values, the constants <code  class="code">NULL</code> and <code  class="code">NOT_NULL</code>, which means &#34;give me objects where this field is NULL or NOT NULL, respectively.&#34;</p>
+
+<p>In addition to the column keys, there are a few special keys that can be used to rig the underlying database queries. These are <code  class="code">LIMIT</code>, <code  class="code">OFFSET</code>, and <code  class="code">WHERE</code>.</p>
+
+<p>The value for the <code  class="code">LIMIT</code> key is expected to be an integer defining the number of objects to return, while the value for <code  class="code">OFFSET</code> defines the position, relative to the number of objects the query would normally return, at which to begin the result set. If <code  class="code">OFFSET</code> is defined without a corresponding <code  class="code">LIMIT</code> it is silently ignored.</p>
+
+<p>The <code  class="code">WHERE</code> key provides a mechanism for adding arbitrary WHERE clauses to the underlying query. Its value is expected to a hash reference whose keys are the columns, operators and placeholders, and the values are the placeholders&#39; bind value. For example:</p>
+
+<pre  class="code"> WHERE =&#62; { &#39;some_column &#62;= ?&#39; =&#62; $some_value }</pre>
+
+<p>would constrain the query to only those objects in the table whose &#39;some_column&#39; column has a value greater than or equal to $some_value.</p>
+
+<p>If you don&#39;t specify any criteria, calling this function is the same as doing <code  class="code">[$class-&#62;get_all]</code>.</p>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>An arrayref of objects, or an empty arrayref if there are no matches.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Database_Manipulation"
+>Database Manipulation</a></h2>
+
+<dl>
+<dt><a name="create"
+><code  class="code">create</code></a></dt>
+
+<dd>
+<p>Description: Creates a new item in the database. Throws a User Error if any of the passed-in params are invalid.</p>
+
+<p>Params: <code  class="code">$params</code> - hashref - A value to put in each database field for this object.</p>
+
+<p>Returns: The Object just created in the database.</p>
+
+<p>Notes: In order for this function to work in your subclass, your subclass&#39;s <a href="#ID_FIELD" class="podlinkpod"
+>&#34;ID_FIELD&#34;</a> must be of <code  class="code">SERIAL</code> type in the database.</p>
+
+<p>Subclass Implementors: This function basically just calls <a href="#check_required_create_fields" class="podlinkpod"
+>&#34;check_required_create_fields&#34;</a>, then <a href="#run_create_validators" class="podlinkpod"
+>&#34;run_create_validators&#34;</a>, and then finally <a href="#insert_create_data" class="podlinkpod"
+>&#34;insert_create_data&#34;</a>. So if you have a complex system that you need to implement, you can do it by calling these three functions instead of <code  class="code">SUPER::create</code>.</p>
+
+<dt><a name="check_required_create_fields"
+><code  class="code">check_required_create_fields</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Part of <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a>. Modifies the incoming <code  class="code">$params</code> argument so that any field that does not have a database default will be checked later by <a href="#run_create_validators" class="podlinkpod"
+>&#34;run_create_validators&#34;</a>, even if that field wasn&#39;t specified as an argument to <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a>.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$params_-_The_same_as_$params_from_&#34;create&#34;."
+><code  class="code">$params</code> - The same as <code  class="code">$params</code> from <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a>.</a></dt>
+</dl>
+
+<dt><a name="Returns_(nothing)"
+><b>Returns</b> (nothing)</a></dt>
+</dl>
+
+<dt><a name="run_create_validators"
+><code  class="code">run_create_validators</code></a></dt>
+
+<dd>
+<p>Description: Runs the validation of input parameters for <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a>. This subroutine exists so that it can be overridden by subclasses who need to do special validations of their input parameters. This method is <b>only</b> called by <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a>.</p>
+
+<p>Params: <code  class="code">$params</code> - hashref - A value to put in each database field for this object. <code  class="code">$options</code> - hashref - Processing options. Currently the only option supported is <b>skip</b>, which can be used to specify a list of fields to not validate.</p>
+
+<p>Returns: A hash, in a similar format as <code  class="code">$params</code>, except that these are the values to be inserted into the database, not the values that were input to <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a>.</p>
+
+<dt><a name="insert_create_data"
+><code  class="code">insert_create_data</code></a></dt>
+
+<dd>
+<p>Part of <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a>.</p>
+
+<p>Takes the return value from <a href="#run_create_validators" class="podlinkpod"
+>&#34;run_create_validators&#34;</a> and inserts the data into the database. Returns a newly created object.</p>
+
+<dt><a name="update"
+><code  class="code">update</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Saves the values currently in this object to the database. Only the fields specified in <a href="#UPDATE_COLUMNS" class="podlinkpod"
+>&#34;UPDATE_COLUMNS&#34;</a> will be updated, and they will only be updated if their values have changed.</p>
+
+<dt><a name="Params_(none)"
+><b>Params</b> (none)</a></dt>
+
+<dd>
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p><b>In scalar context:</b></p>
+
+<p>A hashref showing what changed during the update. The keys are the column names from <a href="#UPDATE_COLUMNS" class="podlinkpod"
+>&#34;UPDATE_COLUMNS&#34;</a>. If a field was not changed, it will not be in the hash at all. If the field was changed, the key will point to an arrayref. The first item of the arrayref will be the old value, and the second item will be the new value.</p>
+
+<p>If there were no changes, we return a reference to an empty hash.</p>
+
+<p><b>In array context:</b></p>
+
+<p>Returns a list, where the first item is the above hashref. The second item is the object as it was in the database before update() was called. (This is mostly useful to subclasses of <code  class="code">Bugzilla::Object</code> that are implementing <code  class="code">update</code>.)</p>
+</dd>
+</dl>
+
+<dt><a name="remove_from_db"
+><code  class="code">remove_from_db</code></a></dt>
+
+<dd>
+<p>Removes this object from the database. Will throw an error if you can&#39;t remove it for some reason. The object will then be destroyed, as it is not safe to use the object after it has been removed from the database.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Mutators"
+>Mutators</a></h2>
+
+<p>These are used for updating the values in objects, before calling <code  class="code">update</code>.</p>
+
+<dl>
+<dt><a name="set"
+><code  class="code">set</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Sets a certain hash member of this class to a certain value. Used for updating fields. Calls the validator for this field, if it exists. Subclasses should use this function to implement the various <code  class="code">set_</code> mutators for their different fields.</p>
+
+<p>If your class defines a method called <code  class="code">_set_global_validator</code>, <code  class="code">set</code> will call it with <code  class="code">($value, $field)</code> as arguments, after running the validator for this particular field. <code  class="code">_set_global_validator</code> does not return anything.</p>
+
+<p>See <a href="#VALIDATORS" class="podlinkpod"
+>&#34;VALIDATORS&#34;</a> for more information.</p>
+
+<p><b>NOTE</b>: This function is intended only for use by subclasses. If you call it from anywhere else, it will throw a <code  class="code">CodeError</code>.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a 
+><code  class="code">$field</code> - The name of the hash member to update. This should be the same as the name of the field in <a href="#VALIDATORS" class="podlinkpod"
+>&#34;VALIDATORS&#34;</a>, if it exists there.</a></dt>
+
+<dd>
+<dt><a name="$value_-_The_value_that_you&#39;re_setting_the_field_to."
+><code  class="code">$value</code> - The value that you&#39;re setting the field to.</a></dt>
+</dl>
+
+<dt><a name="Returns_(nothing)"
+><b>Returns</b> (nothing)</a></dt>
+</dl>
+
+<dt><a name="set_all"
+><code  class="code">set_all</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>This is a convenience function which is simpler than calling many different <code  class="code">set_</code> functions in a row. You pass a hashref of parameters and it calls <code  class="code">set_$key($value)</code> for every item in the hashref.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p>Takes a hashref of the fields that need to be set, pointing to the value that should be passed to the <code  class="code">set_</code> function that is called.</p>
+
+<dt><a name="Returns_(nothing)"
+><b>Returns</b> (nothing)</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Simple_Validators"
+>Simple Validators</a></h2>
+
+<p>You can use these in your subclass <a href="#VALIDATORS" class="podlinkpod"
+>&#34;VALIDATORS&#34;</a> or <a href="#UPDATE_VALIDATORS" class="podlinkpod"
+>&#34;UPDATE_VALIDATORS&#34;</a>. Note that you have to reference them like <code  class="code">\&#38;Bugzilla::Object::check_boolean</code>, you can&#39;t just write <code  class="code">\&#38;check_boolean</code>.</p>
+
+<dl>
+<dt><a name="check_boolean"
+><code  class="code">check_boolean</code></a></dt>
+
+<dd>
+<p>Returns <code  class="code">1</code> if the passed-in value is true, <code  class="code">0</code> otherwise.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CLASS_FUNCTIONS"
+>CLASS FUNCTIONS</a></h1>
+
+<dl>
+<dt><a name="any_exist"
+><code  class="code">any_exist</code></a></dt>
+
+<dd>
+<p>Returns <code  class="code">1</code> if there are any of these objects in the database, <code  class="code">0</code> otherwise.</p>
+
+<dt><a name="get_all"
+><code  class="code">get_all</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns all objects in this table from the database.
+
+ Params:      none.
+
+ Returns:     A list of objects, or an empty list if there are none.
+
+ Notes:       Note that you must call this as $class-&#62;get_all. For 
+              example, Bugzilla::Keyword-&#62;get_all. 
+              Bugzilla::Keyword::get_all will not work.</pre>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Product.html b/docs/en/html/api/Bugzilla/Product.html
new file mode 100644 (file)
index 0000000..9473859
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Product.html
@@ -0,0 +1,279 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Product</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Product</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <li class='indexItem indexItem1'><a href='#SUBROUTINES'>SUBROUTINES</a>
+  <li class='indexItem indexItem1'><a href='#SEE_ALSO'>SEE ALSO</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Product - Bugzilla product class.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">    use Bugzilla::Product;
+
+    my $product = new Bugzilla::Product(1);
+    my $product = new Bugzilla::Product({ name =&#62; &#39;AcmeProduct&#39; });
+
+    my @components      = $product-&#62;components();
+    my $groups_controls = $product-&#62;group_controls();
+    my @milestones      = $product-&#62;milestones();
+    my @versions        = $product-&#62;versions();
+    my $bugcount        = $product-&#62;bug_count();
+    my $bug_ids         = $product-&#62;bug_ids();
+    my $has_access      = $product-&#62;user_has_access($user);
+    my $flag_types      = $product-&#62;flag_types();
+    my $classification  = $product-&#62;classification();
+
+    my $id               = $product-&#62;id;
+    my $name             = $product-&#62;name;
+    my $description      = $product-&#62;description;
+    my isactive          = $product-&#62;is_active;
+    my $defaultmilestone = $product-&#62;default_milestone;
+    my $classificationid = $product-&#62;classification_id;
+    my $allows_unconfirmed = $product-&#62;allows_unconfirmed;</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Product.pm represents a product object. It is an implementation of <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, and thus provides all methods that <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a> provides.</p>
+
+<p>The methods that are specific to <code  class="code">Bugzilla::Product</code> are listed below.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<dl>
+<dt><a name="components"
+><code  class="code">components</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns an array of component objects belonging to
+              the product.
+
+ Params:      none.
+
+ Returns:     An array of Bugzilla::Component object.</pre>
+
+<dt><a name="group_controls()"
+><code  class="code">group_controls()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns a hash (group id as key) with all product
+              group controls.
+
+ Params:      $full_data (optional, false by default) - when true,
+              the number of bugs per group applicable to the product
+              is also returned. Moreover, bug groups which have no
+              special settings for the product are also returned.
+
+ Returns:     A hash with group id as key and hash containing 
+              a Bugzilla::Group object and the properties of group
+              relative to the product.</pre>
+
+<dt><a name="groups_available"
+><code  class="code">groups_available</code></a></dt>
+
+<dd>
+<p>Tells you what groups are set to Default or Shown for the currently-logged-in user (taking into account both OtherControl and MemberControl). Returns an arrayref of <a href="../Bugzilla/Group.html" class="podlinkpod"
+>Bugzilla::Group</a> objects with an extra hash keys set, <code  class="code">is_default</code>, which is true if the group is set to Default for the currently-logged-in user.</p>
+
+<dt><a name="groups_mandatory"
+><code  class="code">groups_mandatory</code></a></dt>
+
+<dd>
+<p>Tells you what groups are mandatory for bugs in this product, for the currently-logged-in user. Returns an arrayref of <code  class="code">Bugzilla::Group</code> objects.</p>
+
+<dt><a name="group_is_settable"
+><code  class="code">group_is_settable</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Tells you whether or not the currently-logged-in user can set a group on a bug (whether or not they match the MemberControl/OtherControl settings for a group in this product). Groups that are <code  class="code">Mandatory</code> for the currently-loggeed-in user are also acceptable since from Bugzilla&#39;s perspective, there&#39;s no problem with &#34;setting&#34; a Mandatory group on a bug. (In fact, the user <i>must</i> set the Mandatory group on the bug.)</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$group_-_A_Bugzilla::Group_object."
+><code  class="code">$group</code> - A <a href="../Bugzilla/Group.html" class="podlinkpod"
+>Bugzilla::Group</a> object.</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p><code  class="code">1</code> if the group is valid in this product, <code  class="code">0</code> otherwise.</p>
+</dd>
+</dl>
+
+<dt><a name="groups_valid"
+><code  class="code">groups_valid</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Returns an arrayref of <a href="../Bugzilla/Group.html" class="podlinkpod"
+>Bugzilla::Group</a> objects, representing groups that bugs could validly be restricted to within this product. Used mostly when you need the list of all possible groups that could be set in a product by anybody, disregarding whether or not the groups are active or who the currently logged-in user is.</p>
+
+<p><b>Note</b>: This doesn&#39;t check whether or not the current user can add/remove bugs to/from these groups. It just tells you that bugs <i>could be in</i> these groups, in this product.</p>
+
+<dt><a name="Params_(none)"
+><b>Params</b> (none)</a></dt>
+
+<dd>
+<dt><a name="Returns_An_arrayref_of_Bugzilla::Group_objects."
+><b>Returns</b> An arrayref of <a href="../Bugzilla/Group.html" class="podlinkpod"
+>Bugzilla::Group</a> objects.</a></dt>
+</dl>
+
+<dt><a name="group_is_valid"
+><code  class="code">group_is_valid</code></a></dt>
+
+<dd>
+<p>Returns <code  class="code">1</code> if the passed-in <a href="../Bugzilla/Group.html" class="podlinkpod"
+>Bugzilla::Group</a> or group id could be set on a bug by <i>anybody</i>, in this product. Even inactive groups are considered valid. (This is a shortcut for searching <a href="#groups_valid" class="podlinkpod"
+>&#34;groups_valid&#34;</a> to find out if a group is valid in a particular product.)</p>
+
+<dt><a name="versions"
+><code  class="code">versions</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns all valid versions for that product.
+
+ Params:      none.
+
+ Returns:     An array of Bugzilla::Version objects.</pre>
+
+<dt><a name="milestones"
+><code  class="code">milestones</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns all valid milestones for that product.
+
+ Params:      none.
+
+ Returns:     An array of Bugzilla::Milestone objects.</pre>
+
+<dt><a name="bug_count()"
+><code  class="code">bug_count()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns the total of bugs that belong to the product.
+
+ Params:      none.
+
+ Returns:     Integer with the number of bugs.</pre>
+
+<dt><a name="bug_ids()"
+><code  class="code">bug_ids()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns the IDs of bugs that belong to the product.
+
+ Params:      none.
+
+ Returns:     An array of integer.</pre>
+
+<dt><a name="user_has_access()"
+><code  class="code">user_has_access()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Tells you whether or not the user is allowed to enter
+              bugs into this product, based on the C&#60;entry&#62; group
+              control. To see whether or not a user can actually
+              enter a bug into a product, use C&#60;$user-&#38;gt;can_enter_product&#62;.
+
+ Params:      C&#60;$user&#62; - A Bugzilla::User object.
+
+ Returns      C&#60;1&#62; If this user&#39;s groups allow him C&#60;entry&#62; access to
+              this Product, C&#60;0&#62; otherwise.</pre>
+
+<dt><a name="flag_types()"
+><code  class="code">flag_types()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns flag types available for at least one of
+              its components.
+
+ Params:      none.
+
+ Returns:     Two references to an array of flagtype objects.</pre>
+
+<dt><a name="classification()"
+><code  class="code">classification()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns the classification the product belongs to.
+
+ Params:      none.
+
+ Returns:     A Bugzilla::Classification object.</pre>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SUBROUTINES"
+>SUBROUTINES</a></h1>
+
+<dl>
+<dt><a name="preload"
+><code  class="code">preload</code></a></dt>
+
+<dd>
+<p>When passed an arrayref of <code  class="code">Bugzilla::Product</code> objects, preloads their <a href="#milestones" class="podlinkpod"
+>&#34;milestones&#34;</a>, <a href="#components" class="podlinkpod"
+>&#34;components&#34;</a>, and <a href="#versions" class="podlinkpod"
+>&#34;versions&#34;</a>, which is much faster than calling those accessors on every item in the array individually.</p>
+
+<p>If the 2nd argument passed to <code  class="code">preload</code> is true, flag types for these products and their components are also preloaded.</p>
+
+<p>This function is not exported, so must be called like <code  class="code">Bugzilla::Product::preload($products)</code>.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SEE_ALSO"
+>SEE ALSO</a></h1>
+
+<p><a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a></p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Report.html b/docs/en/html/api/Bugzilla/Report.html
new file mode 100644 (file)
index 0000000..0a44836
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Report.html
@@ -0,0 +1,59 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Report</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Report</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Report - Bugzilla report class.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">    use Bugzilla::Report;
+
+    my $report = new Bugzilla::Report(1);
+
+    my $report = Bugzilla::Report-&#62;check({id =&#62; $id});
+
+    my $name = $report-&#62;name;
+    my $query = $report-&#62;query;
+
+    my $report = Bugzilla::Report-&#62;create({ name =&#62; $name, query =&#62; $query });
+
+    $report-&#62;set_name($new_name);
+    $report-&#62;set_query($new_query);
+    $report-&#62;update();
+
+    $report-&#62;remove_from_db;</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Report.pm represents a Report object. It is an implementation of <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, and thus provides all methods that <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a> provides.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Search.html b/docs/en/html/api/Bugzilla/Search.html
new file mode 100644 (file)
index 0000000..4f2b677
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Search.html
@@ -0,0 +1,145 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Search</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Search</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#new'>new</a>
+    <li class='indexItem indexItem2'><a href='#data'>data</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Search - Provides methods to run queries against bugs.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">    use Bugzilla::Search;
+
+    my $search = new Bugzilla::Search({&#39;fields&#39; =&#62; \@fields,
+                                       &#39;params&#39; =&#62; \%search_criteria,
+                                       &#39;sharer&#39; =&#62; $sharer_id,
+                                       &#39;user&#39;   =&#62; $user_obj,
+                                       &#39;allow_unlimited&#39; =&#62; 1});
+
+    my $data = $search-&#62;data;
+    my ($data, $extra_data) = $search-&#62;data;</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Search.pm represents a search object. It&#39;s the single way to collect data about bugs in a secure way. The list of bugs matching criteria defined by the caller are filtered based on the user privileges.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="new"
+>new</a></h2>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Create a Bugzilla::Search object.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="fields"
+><code  class="code">fields</code></a></dt>
+
+<dd>
+<p>An arrayref representing the bug attributes for which data is desired. Legal attributes are listed in the fielddefs DB table. At least one field must be defined, typically the &#39;bug_id&#39; field.</p>
+
+<dt><a name="params"
+><code  class="code">params</code></a></dt>
+
+<dd>
+<p>A hashref representing search criteria. Each key =&#62; value pair represents a search criteria, where the key is the search field and the value is the value for this field. At least one search criteria must be defined if the &#39;search_allow_no_criteria&#39; parameter is turned off, else an error is thrown.</p>
+
+<dt><a name="sharer"
+><code  class="code">sharer</code></a></dt>
+
+<dd>
+<p>When a saved search is shared by a user, this is his user ID.</p>
+
+<dt><a name="user"
+><code  class="code">user</code></a></dt>
+
+<dd>
+<p>A <a href="../Bugzilla/User.html" class="podlinkpod"
+>Bugzilla::User</a> object representing the user to whom the data is addressed. All security checks are done based on this user object, so it&#39;s not safe to share results of the query with other users as not all users have the same privileges or have the same role for all bugs in the list. If this parameter is not defined, then the currently logged in user is taken into account. If no user is logged in, then only public bugs will be returned.</p>
+
+<dt><a name="allow_unlimited"
+><code  class="code">allow_unlimited</code></a></dt>
+
+<dd>
+<p>If set to a true value, the number of bugs retrieved by the query is not limited.</p>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A <a href="../Bugzilla/Search.html" class="podlinkpod"
+>Bugzilla::Search</a> object.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="data"
+>data</a></h2>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Returns bugs matching search criteria passed to <code  class="code">new()</code>.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p>None</p>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>In scalar context, this method returns a reference to a list of bugs. Each item of the list represents a bug, which is itself a reference to a list where each item represents a bug attribute, in the same order as specified in the <code  class="code">fields</code> parameter of <code  class="code">new()</code>.</p>
+
+<p>In list context, this methods also returns a reference to a list containing references to hashes. For each hash, two keys are defined: <code  class="code">sql</code> contains the SQL query which has been executed, and <code  class="code">time</code> contains the time spent to execute the SQL query, in seconds. There can be either a single hash, or two hashes if two SQL queries have been executed sequentially to get all the required data.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Search/Recent.html b/docs/en/html/api/Bugzilla/Search/Recent.html
new file mode 100644 (file)
index 0000000..537238e
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Search/Recent.html
@@ -0,0 +1,44 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Search::Recent</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Search::Recent</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Search::Recent - A search recently run by a logged-in user.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> use Bugzilla::Search::Recent;</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This is an implementation of <a href="../../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, and so has all the same methods available as <a href="../../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, in addition to what is documented below.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Search/Saved.html b/docs/en/html/api/Bugzilla/Search/Saved.html
new file mode 100644 (file)
index 0000000..cc41a2a
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Search/Saved.html
@@ -0,0 +1,133 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Search::Saved</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Search::Saved</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Constructors_and_Database_Manipulation'>Constructors and Database Manipulation</a>
+    <li class='indexItem indexItem2'><a href='#Accessors'>Accessors</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Search::Saved - A saved search</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> use Bugzilla::Search::Saved;
+
+ my $query = new Bugzilla::Search::Saved($query_id);
+
+ my $edit_link  = $query-&#62;edit_link;
+ my $search_url = $query-&#62;url;
+ my $owner      = $query-&#62;user;
+ my $num_subscribers = $query-&#62;shared_with_users;</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This module exists to represent a <a href="../../Bugzilla/Search.html" class="podlinkpod"
+>Bugzilla::Search</a> that has been saved to the database.</p>
+
+<p>This is an implementation of <a href="../../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, and so has all the same methods available as <a href="../../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, in addition to what is documented below.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Constructors_and_Database_Manipulation"
+>Constructors and Database Manipulation</a></h2>
+
+<dl>
+<dt><a name="new"
+><code  class="code">new</code></a></dt>
+
+<dd>
+<p>Takes either an id, or the named parameters <code  class="code">user</code> and <code  class="code">name</code>. <code  class="code">user</code> can be either a <a href="../../Bugzilla/User.html" class="podlinkpod"
+>Bugzilla::User</a> object or a numeric user id.</p>
+
+<p>See also: <a href="../../Bugzilla/Object.html#new" class="podlinkpod"
+>&#34;new&#34; in Bugzilla::Object</a>.</p>
+
+<dt><a name="preload"
+><code  class="code">preload</code></a></dt>
+
+<dd>
+<p>Sets <code  class="code">link_in_footer</code> for all given saved searches at once, for the currently logged in user. This is much faster than calling this method for each saved search individually.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Accessors"
+>Accessors</a></h2>
+
+<p>These return data about the object, without modifying the object.</p>
+
+<dl>
+<dt><a name="edit_link"
+><code  class="code">edit_link</code></a></dt>
+
+<dd>
+<p>A url with which you can edit the search.</p>
+
+<dt><a name="url"
+><code  class="code">url</code></a></dt>
+
+<dd>
+<p>The CGI parameters for the search, as a string.</p>
+
+<dt><a name="link_in_footer"
+><code  class="code">link_in_footer</code></a></dt>
+
+<dd>
+<p>Whether or not this search should be displayed in the footer for the <i>current user</i> (not the owner of the search, but the person actually using Bugzilla right now).</p>
+
+<dt><a name="type"
+><code  class="code">type</code></a></dt>
+
+<dd>
+<p>The numeric id of the type of search this is (from <a href="../../Bugzilla/Constants.html" class="podlinkpod"
+>Bugzilla::Constants</a>).</p>
+
+<dt><a name="shared_with_group"
+><code  class="code">shared_with_group</code></a></dt>
+
+<dd>
+<p>The <a href="../../Bugzilla/Group.html" class="podlinkpod"
+>Bugzilla::Group</a> that this search is shared with. <code  class="code">undef</code> if this search isn&#39;t shared.</p>
+
+<dt><a name="shared_with_users"
+><code  class="code">shared_with_users</code></a></dt>
+
+<dd>
+<p>Returns how many users (besides the author of the saved search) are using the saved search, i.e. have it displayed in their footer.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Status.html b/docs/en/html/api/Bugzilla/Status.html
new file mode 100644 (file)
index 0000000..bee56c4
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Status.html
@@ -0,0 +1,123 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Status</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Status</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Status - Bug status class.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">    use Bugzilla::Status;
+
+    my $bug_status = new Bugzilla::Status({ name =&#62; &#39;IN_PROGRESS&#39; });
+    my $bug_status = new Bugzilla::Status(4);
+
+    my @closed_bug_statuses = closed_bug_statuses();
+
+    Bugzilla::Status::add_missing_bug_status_transitions($bug_status);</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Status.pm represents a bug status object. It is an implementation of <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, and thus provides all methods that <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a> provides.</p>
+
+<p>The methods that are specific to <code  class="code">Bugzilla::Status</code> are listed below.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<dl>
+<dt><a name="closed_bug_statuses"
+><code  class="code">closed_bug_statuses</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns a list of C&#60;Bugzilla::Status&#62; objects which can have
+              a resolution associated with them (&#34;closed&#34; bug statuses).
+
+ Params:      none.
+
+ Returns:     A list of Bugzilla::Status objects.</pre>
+
+<dt><a name="can_change_to"
+><code  class="code">can_change_to</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns the list of active statuses a bug can be changed to
+              given the current bug status. If this method is called as a
+              class method, then it returns all bug statuses available on
+              bug creation.
+
+ Params:      none.
+
+ Returns:     A list of Bugzilla::Status objects.</pre>
+
+<dt><a name="comment_required_on_change_from"
+><code  class="code">comment_required_on_change_from</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Checks if a comment is required to change to this status from another status, according to the current settings in the workflow.</p>
+
+<p>Note that this doesn&#39;t implement the checks enforced by the various <code  class="code">commenton</code> parameters--those are checked by internal checks in <a href="../Bugzilla/Bug.html" class="podlinkpod"
+>Bugzilla::Bug</a>.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p><code  class="code">$old_status</code> - The status you&#39;re changing from.</p>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p><code  class="code">1</code> if a comment is required on this change, <code  class="code">0</code> if not.</p>
+</dd>
+</dl>
+
+<dt><a name="add_missing_bug_status_transitions"
+><code  class="code">add_missing_bug_status_transitions</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Insert all missing transitions to a given bug status.
+
+ Params:      $bug_status - The value (name) of a bug status.
+
+ Returns:     nothing.</pre>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Template.html b/docs/en/html/api/Bugzilla/Template.html
new file mode 100644 (file)
index 0000000..f96243d
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Template.html
@@ -0,0 +1,95 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Template</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Template</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#SUBROUTINES'>SUBROUTINES</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <li class='indexItem indexItem1'><a href='#SEE_ALSO'>SEE ALSO</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Template - Wrapper around the Template Toolkit <code  class="code">Template</code> object</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">  my $template = Bugzilla::Template-&#62;create;
+  my $format = $template-&#62;get_format(&#34;foo/bar&#34;,
+                                     scalar($cgi-&#62;param(&#39;format&#39;)),
+                                     scalar($cgi-&#62;param(&#39;ctype&#39;)));</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This is basically a wrapper so that the correct arguments get passed into the <code  class="code">Template</code> constructor.</p>
+
+<p>It should not be used directly by scripts or modules - instead, use <code  class="code">Bugzilla-&#62;instance-&#62;template</code> to get an already created module.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SUBROUTINES"
+>SUBROUTINES</a></h1>
+
+<dl>
+<dt><a name="precompile_templates($output)"
+><code  class="code">precompile_templates($output)</code></a></dt>
+
+<dd>
+<p>Description: Compiles all of Bugzilla&#39;s templates in every language. Used mostly by <em  class="code">checksetup.pl</em>.</p>
+
+<p>Params: <code  class="code">$output</code> - <code  class="code">true</code> if you want the function to print out information about what it&#39;s doing.</p>
+
+<p>Returns: nothing</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<dl>
+<dt><a name="get_format($file,_$format,_$ctype)"
+><code  class="code">get_format($file, $format, $ctype)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Construct a format object from URL parameters.
+
+ Params:      $file   - Name of the template to display.
+              $format - When the template exists under several formats
+                        (e.g. table or graph), specify the one to choose.
+              $ctype  - Content type, see Bugzilla::Constants::contenttypes.
+
+ Returns:     A format object.</pre>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SEE_ALSO"
+>SEE ALSO</a></h1>
+
+<p><a href="../Bugzilla.html" class="podlinkpod"
+>Bugzilla</a>, <a href="../Template.html" class="podlinkpod"
+>Template</a></p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Template/Plugin/Bugzilla.html b/docs/en/html/api/Bugzilla/Template/Plugin/Bugzilla.html
new file mode 100644 (file)
index 0000000..bf888e9
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Template/Plugin/Bugzilla.html
@@ -0,0 +1,45 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Template::Plugin::Bugzilla</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Template::Plugin::Bugzilla</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#SEE_ALSO'>SEE ALSO</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Template::Plugin::Bugzilla</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Template Toolkit plugin to allow access to the persistent <code  class="code">Bugzilla</code> object.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SEE_ALSO"
+>SEE ALSO</a></h1>
+
+<p><a href="../../../Bugzilla.html" class="podlinkpod"
+>Bugzilla</a>,
+<a href="../../../Template/Plugin.html" class="podlinkpod"
+>Template::Plugin</a></p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Template/Plugin/Hook.html b/docs/en/html/api/Bugzilla/Template/Plugin/Hook.html
new file mode 100644 (file)
index 0000000..52c9f91
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Template/Plugin/Hook.html
@@ -0,0 +1,98 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Template::Plugin::Hook</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Template::Plugin::Hook</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <li class='indexItem indexItem1'><a href='#SEE_ALSO'>SEE ALSO</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Template::Plugin::Hook</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Template Toolkit plugin to process hooks added into templates by extensions.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<dl>
+<dt><a name="process"
+><b>process</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Processes hooks added into templates by extensions.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="hook_name"
+><code  class="code">hook_name</code></a></dt>
+
+<dd>
+<p>The unique name of the template hook.</p>
+
+<dt><a name="template_(optional)"
+><code  class="code">template</code> (optional)</a></dt>
+
+<dd>
+<p>The path of the calling template.
+This is used as a work around to a bug which causes the path to the hook to be incorrect when the hook is called from inside a block.</p>
+
+<p>Example: If the hook <code  class="code">lastrow</code> is added to the template <em  class="code">show-multiple.html.tmpl</em> and it is desired to force the correct template path,
+the template hook would be:</p>
+
+<pre  class="code"> [% Hook.process(&#34;lastrow&#34;, &#34;bug/show-multiple.html.tmpl&#34;) %]</pre>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>Output from processing template extension.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SEE_ALSO"
+>SEE ALSO</a></h1>
+
+<p><a href="../../../Template/Plugin.html" class="podlinkpod"
+>Template::Plugin</a></p>
+
+<p><a href="http://wiki.mozilla.org/Bugzilla:Writing_Extensions" class="podlinkurl"
+>http://wiki.mozilla.org/Bugzilla:Writing_Extensions</a></p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Token.html b/docs/en/html/api/Bugzilla/Token.html
new file mode 100644 (file)
index 0000000..dbe00fc
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Token.html
@@ -0,0 +1,232 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Token</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Token</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#SUBROUTINES'>SUBROUTINES</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Security_related_routines'>Security related routines</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Token - Provides different routines to manage tokens.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">    use Bugzilla::Token;
+
+    Bugzilla::Token::issue_new_user_account_token($login_name);
+    Bugzilla::Token::IssueEmailChangeToken($user, $new_email);
+    Bugzilla::Token::IssuePasswordToken($user);
+    Bugzilla::Token::DeletePasswordTokens($user_id, $reason);
+    Bugzilla::Token::Cancel($token, $cancelaction, $vars);
+
+    Bugzilla::Token::CleanTokenTable();
+
+    my $token = issue_session_token($event);
+    check_token_data($token, $event)
+    delete_token($token);
+
+    my $token = Bugzilla::Token::GenerateUniqueToken($table, $column);
+    my $token = Bugzilla::Token::HasEmailChangeToken($user_id);
+    my ($token, $date, $data, $type) = Bugzilla::Token::GetTokenData($token);</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SUBROUTINES"
+>SUBROUTINES</a></h1>
+
+<dl>
+<dt><a name="issue_new_user_account_token($login_name)"
+><code  class="code">issue_new_user_account_token($login_name)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Creates and sends a token per email to the email address
+              requesting a new user account. It doesn&#39;t check whether
+              the user account already exists. The user will have to
+              use this token to confirm the creation of his user account.
+
+ Params:      $login_name - The new login name requested by the user.
+
+ Returns:     Nothing. It throws an error if the same user made the same
+              request in the last few minutes.</pre>
+
+<dt><a name="sub_IssueEmailChangeToken($user,_$new_email)"
+><code  class="code">sub IssueEmailChangeToken($user, $new_email)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Sends two distinct tokens per email to the old and new email
+              addresses to confirm the email address change for the given
+              user. These tokens remain valid for the next MAX_TOKEN_AGE days.
+
+ Params:      $user      - User object of the user requesting a new
+                           email address.
+              $new_email - The new email address of the user.
+
+ Returns:     Nothing.</pre>
+
+<dt><a name="IssuePasswordToken($user)"
+><code  class="code">IssuePasswordToken($user)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Sends a token per email to the given user. This token
+              can be used to change the password (e.g. in case the user
+              cannot remember his password and wishes to enter a new one).
+
+ Params:      $user - User object of the user requesting a new password.
+
+ Returns:     Nothing. It throws an error if the same user made the same
+              request in the last few minutes.</pre>
+
+<dt><a name="CleanTokenTable()"
+><code  class="code">CleanTokenTable()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Removes all tokens older than MAX_TOKEN_AGE days from the DB.
+              This means that these tokens will now be considered as invalid.
+
+ Params:      None.
+
+ Returns:     Nothing.</pre>
+
+<dt><a name="GenerateUniqueToken($table,_$column)"
+><code  class="code">GenerateUniqueToken($table, $column)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Generates and returns a unique token. This token is unique
+              in the $column of the $table. This token is NOT stored in the DB.
+
+ Params:      $table (optional): The table to look at (default: tokens).
+              $column (optional): The column to look at for uniqueness (default: token).
+
+ Returns:     A token which is unique in $column.</pre>
+
+<dt><a name="Cancel($token,_$cancelaction,_$vars)"
+><code  class="code">Cancel($token, $cancelaction, $vars)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Invalidates an existing token, generally when the token is used
+              for an action which is not the one expected. An email is sent
+              to the user who originally requested this token to inform him
+              that this token has been invalidated (e.g. because an hacker
+              tried to use this token for some malicious action).
+
+ Params:      $token:        The token to invalidate.
+              $cancelaction: The reason why this token is invalidated.
+              $vars:         Some additional information about this action.
+
+ Returns:     Nothing.</pre>
+
+<dt><a name="DeletePasswordTokens($user_id,_$reason)"
+><code  class="code">DeletePasswordTokens($user_id, $reason)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Cancels all password tokens for the given user. Emails are sent
+              to the user to inform him about this action.
+
+ Params:      $user_id: The user ID of the user account whose password tokens
+                        are canceled.
+              $reason:  The reason why these tokens are canceled.
+
+ Returns:     Nothing.</pre>
+
+<dt><a name="HasEmailChangeToken($user_id)"
+><code  class="code">HasEmailChangeToken($user_id)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns any existing token currently used for an email change
+              for the given user.
+
+ Params:      $user_id - A user ID.
+
+ Returns:     A token if it exists, else undef.</pre>
+
+<dt><a name="GetTokenData($token)"
+><code  class="code">GetTokenData($token)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns all stored data for the given token.
+
+ Params:      $token - A valid token.
+
+ Returns:     The user ID, the date and time when the token was created,
+              the (event)data stored with that token, and its type.</pre>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Security_related_routines"
+>Security related routines</a></h2>
+
+<p>The following routines have been written to be used together as described below, although they can be used separately.</p>
+
+<dl>
+<dt><a name="issue_session_token($event)"
+><code  class="code">issue_session_token($event)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Creates and returns a token used internally.
+
+ Params:      $event - The event which needs to be stored in the DB for future
+                       reference/checks.
+
+ Returns:     A unique token.</pre>
+
+<dt><a name="check_token_data($token,_$event)"
+><code  class="code">check_token_data($token, $event)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Makes sure the $token has been created by the currently logged in
+              user and to be used for the given $event. If this token is used for
+              an unexpected action (i.e. $event doesn&#39;t match the information stored
+              with the token), a warning is displayed asking whether the user really
+              wants to continue. On success, it returns 1.
+              This is the routine to use for security checks, combined with
+              issue_session_token() and delete_token() as follows:
+
+              1. First, create a token for some coming action.
+              my $token = issue_session_token($action);
+              2. Some time later, it&#39;s time to make sure that the expected action
+                 is going to be executed, and by the expected user.
+              check_token_data($token, $action);
+              3. The check has been done and we no longer need this token.
+              delete_token($token);
+
+ Params:      $token - The token used for security checks.
+              $event - The expected event to be run.
+
+ Returns:     1 on success, else a warning is thrown.</pre>
+
+<dt><a name="delete_token($token)"
+><code  class="code">delete_token($token)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Deletes the specified token. No notification is sent.
+
+ Params:      $token - The token to delete.
+
+ Returns:     Nothing.</pre>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Update.html b/docs/en/html/api/Bugzilla/Update.html
new file mode 100644 (file)
index 0000000..8f4fef7
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Update.html
@@ -0,0 +1,66 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Update</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Update</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#FUNCTIONS'>FUNCTIONS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Update - Update routines for Bugzilla</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">  use Bugzilla::Update;
+
+  # Get information about new releases
+  my $new_release = Bugzilla::Update::get_notifications();</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This module contains all required routines to notify you about new releases. It downloads an XML file from bugzilla.org and parses it, in order to display information based on your preferences. Absolutely no information about the Bugzilla version you are running is sent to bugzilla.org.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="FUNCTIONS"
+>FUNCTIONS</a></h1>
+
+<dl>
+<dt><a name="get_notifications()"
+><code  class="code">get_notifications()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: This function informs you about new releases, if any.
+
+ Params:      None.
+
+ Returns:     On success, a reference to a hash with data about
+              new releases, if any.
+              On failure, a reference to a hash with the reason
+              of the failure and the name of the unusable XML file.</pre>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/User.html b/docs/en/html/api/Bugzilla/User.html
new file mode 100644 (file)
index 0000000..2e34991
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/User.html
@@ -0,0 +1,719 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::User</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::User</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#CONSTANTS'>CONSTANTS</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Constructors'>Constructors</a>
+    <li class='indexItem indexItem2'><a href='#Saved_and_Shared_Queries'>Saved and Shared Queries</a>
+    <li class='indexItem indexItem2'><a href='#Saved_Recent_Bug_Lists'>Saved Recent Bug Lists</a>
+    <li class='indexItem indexItem2'><a href='#Account_Lockout'>Account Lockout</a>
+    <li class='indexItem indexItem2'><a href='#Other_Methods'>Other Methods</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#CLASS_FUNCTIONS'>CLASS FUNCTIONS</a>
+  <li class='indexItem indexItem1'><a href='#SEE_ALSO'>SEE ALSO</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::User - Object for a Bugzilla user</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">  use Bugzilla::User;
+
+  my $user = new Bugzilla::User($id);
+
+  my @get_selectable_classifications = 
+      $user-&#62;get_selectable_classifications;
+
+  # Class Functions
+  $user = Bugzilla::User-&#62;create({ 
+      login_name    =&#62; $username, 
+      realname      =&#62; $realname, 
+      cryptpassword =&#62; $plaintext_password, 
+      disabledtext  =&#62; $disabledtext,
+      disable_mail  =&#62; 0});</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This package handles Bugzilla users. Data obtained from here is read-only; there is currently no way to modify a user from this package.</p>
+
+<p>Note that the currently logged in user (if any) is available via <a href="../Bugzilla.html#user" class="podlinkpod"
+>Bugzilla-&#62;user</a>.</p>
+
+<p><code  class="code">Bugzilla::User</code> is an implementation of <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, and thus provides all the methods of <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a> in addition to the methods listed below.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CONSTANTS"
+>CONSTANTS</a></h1>
+
+<dl>
+<dt><a name="USER_MATCH_MULTIPLE"
+><code  class="code">USER_MATCH_MULTIPLE</code></a></dt>
+
+<dd>
+<p>Returned by <code  class="code">match_field()</code> when at least one field matched more than one user, but no matches failed.</p>
+
+<dt><a name="USER_MATCH_FAILED"
+><code  class="code">USER_MATCH_FAILED</code></a></dt>
+
+<dd>
+<p>Returned by <code  class="code">match_field()</code> when at least one field failed to match anything.</p>
+
+<dt><a name="USER_MATCH_SUCCESS"
+><code  class="code">USER_MATCH_SUCCESS</code></a></dt>
+
+<dd>
+<p>Returned by <code  class="code">match_field()</code> when all fields successfully matched only one user.</p>
+
+<dt><a name="MATCH_SKIP_CONFIRM"
+><code  class="code">MATCH_SKIP_CONFIRM</code></a></dt>
+
+<dd>
+<p>Passed in to match_field to tell match_field to never display a confirmation screen.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Constructors"
+>Constructors</a></h2>
+
+<dl>
+<dt><a name="super_user"
+><code  class="code">super_user</code></a></dt>
+
+<dd>
+<p>Returns a user who is in all groups, but who does not really exist in the database. Used for non-web scripts like <a href="../checksetup.html" class="podlinkpod"
+>checksetup</a> that need to make database changes and so on.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Saved_and_Shared_Queries"
+>Saved and Shared Queries</a></h2>
+
+<dl>
+<dt><a name="queries"
+><code  class="code">queries</code></a></dt>
+
+<dd>
+<p>Returns an arrayref of the user&#39;s own saved queries, sorted by name. The array contains <a href="../Bugzilla/Search/Saved.html" class="podlinkpod"
+>Bugzilla::Search::Saved</a> objects.</p>
+
+<dt><a name="queries_subscribed"
+><code  class="code">queries_subscribed</code></a></dt>
+
+<dd>
+<p>Returns an arrayref of shared queries that the user has subscribed to. That is, these are shared queries that the user sees in their footer. This array contains <a href="../Bugzilla/Search/Saved.html" class="podlinkpod"
+>Bugzilla::Search::Saved</a> objects.</p>
+
+<dt><a name="queries_available"
+><code  class="code">queries_available</code></a></dt>
+
+<dd>
+<p>Returns an arrayref of all queries to which the user could possibly subscribe. This includes the contents of <a href="#queries_subscribed" class="podlinkpod"
+>&#34;queries_subscribed&#34;</a>. An array of <a href="../Bugzilla/Search/Saved.html" class="podlinkpod"
+>Bugzilla::Search::Saved</a> objects.</p>
+
+<dt><a name="flush_queries_cache"
+><code  class="code">flush_queries_cache</code></a></dt>
+
+<dd>
+<p>Some code modifies the set of stored queries. Because <code  class="code">Bugzilla::User</code> does not handle these modifications, but does cache the result of calling <code  class="code">queries</code> internally, such code must call this method to flush the cached result.</p>
+
+<dt><a name="queryshare_groups"
+><code  class="code">queryshare_groups</code></a></dt>
+
+<dd>
+<p>An arrayref of group ids. The user can share their own queries with these groups.</p>
+
+<dt><a name="tags"
+><code  class="code">tags</code></a></dt>
+
+<dd>
+<p>Returns a hashref with tag IDs as key, and a hashref with tag &#39;id&#39;, &#39;name&#39; and &#39;bug_count&#39; as value.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Saved_Recent_Bug_Lists"
+>Saved Recent Bug Lists</a></h2>
+
+<dl>
+<dt><a name="recent_searches"
+><code  class="code">recent_searches</code></a></dt>
+
+<dd>
+<p>Returns an arrayref of <a href="../Bugzilla/Search/Recent.html" class="podlinkpod"
+>Bugzilla::Search::Recent</a> objects containing the user&#39;s recent searches.</p>
+
+<dt><a name="recent_search_containing(bug_id)"
+><code  class="code">recent_search_containing(bug_id)</code></a></dt>
+
+<dd>
+<p>Returns a <a href="../Bugzilla/Search/Recent.html" class="podlinkpod"
+>Bugzilla::Search::Recent</a> object that contains the most recent search by the user for the specified bug id. Retuns undef if no match is found.</p>
+
+<dt><a name="recent_search_for(bug)"
+><code  class="code">recent_search_for(bug)</code></a></dt>
+
+<dd>
+<p>Returns a <a href="../Bugzilla/Search/Recent.html" class="podlinkpod"
+>Bugzilla::Search::Recent</a> object that contains a search by the user. Uses the list_id of the current loaded page, or the referrer page, and the bug id if that fails. Finally it will check the BUGLIST cookie, and create an object based on that, or undef if it does not exist.</p>
+
+<dt><a name="save_last_search"
+><code  class="code">save_last_search</code></a></dt>
+
+<dd>
+<p>Saves the users most recent search in the database if logged in, or in the BUGLIST cookie if not logged in. Parameters are bug_ids, order, vars and list_id.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Account_Lockout"
+>Account Lockout</a></h2>
+
+<dl>
+<dt><a name="account_is_locked_out"
+><code  class="code">account_is_locked_out</code></a></dt>
+
+<dd>
+<p>Returns <code  class="code">1</code> if the account has failed to log in too many times recently, and thus is locked out for a period of time. Returns <code  class="code">0</code> otherwise.</p>
+
+<dt><a name="account_ip_login_failures"
+><code  class="code">account_ip_login_failures</code></a></dt>
+
+<dd>
+<p>Returns an arrayref of hashrefs, that contains information about the recent times that this account has failed to log in from the current remote IP. The hashes contain <code  class="code">ip_addr</code>, <code  class="code">login_time</code>, and <code  class="code">user_id</code>.</p>
+
+<dt><a name="note_login_failure"
+><code  class="code">note_login_failure</code></a></dt>
+
+<dd>
+<p>This notes that this account has failed to log in, and stores the fact in the database. The storing happens immediately, it does not wait for you to call <code  class="code">update</code>.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Other_Methods"
+>Other Methods</a></h2>
+
+<dl>
+<dt><a name="id"
+><code  class="code">id</code></a></dt>
+
+<dd>
+<p>Returns the userid for this user.</p>
+
+<dt><a name="login"
+><code  class="code">login</code></a></dt>
+
+<dd>
+<p>Returns the login name for this user.</p>
+
+<dt><a name="email"
+><code  class="code">email</code></a></dt>
+
+<dd>
+<p>Returns the user&#39;s email address. Currently this is the same value as the login.</p>
+
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p>Returns the &#39;real&#39; name for this user, if any.</p>
+
+<dt><a name="showmybugslink"
+><code  class="code">showmybugslink</code></a></dt>
+
+<dd>
+<p>Returns <code  class="code">1</code> if the user has set his preference to show the &#39;My Bugs&#39; link in the page footer, and <code  class="code">0</code> otherwise.</p>
+
+<dt><a name="identity"
+><code  class="code">identity</code></a></dt>
+
+<dd>
+<p>Returns a string for the identity of the user. This will be of the form <code  class="code">name &#60;email&#62;</code> if the user has specified a name, and <code  class="code">email</code> otherwise.</p>
+
+<dt><a name="nick"
+><code  class="code">nick</code></a></dt>
+
+<dd>
+<p>Returns a user &#34;nickname&#34; -- i.e. a shorter, not-necessarily-unique name by which to identify the user. Currently the part of the user&#39;s email address before the at sign (@), but that could change, especially if we implement usernames not dependent on email address.</p>
+
+<dt><a name="authorizer"
+><code  class="code">authorizer</code></a></dt>
+
+<dd>
+<p>This is the <a href="../Bugzilla/Auth.html" class="podlinkpod"
+>Bugzilla::Auth</a> object that the User logged in with. If the user hasn&#39;t logged in yet, a new, empty Bugzilla::Auth() object is returned.</p>
+
+<dt><a name="set_authorizer($authorizer)"
+><code  class="code">set_authorizer($authorizer)</code></a></dt>
+
+<dd>
+<p>Sets the <a href="../Bugzilla/Auth.html" class="podlinkpod"
+>Bugzilla::Auth</a> object to be returned by <code  class="code">authorizer()</code>. Should only be called by <code  class="code">Bugzilla::Auth::login</code>, for the most part.</p>
+
+<dt><a name="disabledtext"
+><code  class="code">disabledtext</code></a></dt>
+
+<dd>
+<p>Returns the disable text of the user, if any.</p>
+
+<dt><a name="reports"
+><code  class="code">reports</code></a></dt>
+
+<dd>
+<p>Returns an arrayref of the user&#39;s own saved reports. The array contains <a href="../Bugzilla/Reports.html" class="podlinkpod"
+>Bugzilla::Reports</a> objects.</p>
+
+<dt><a name="flush_reports_cache"
+><code  class="code">flush_reports_cache</code></a></dt>
+
+<dd>
+<p>Some code modifies the set of stored reports. Because <code  class="code">Bugzilla::User</code> does not handle these modifications, but does cache the result of calling <code  class="code">reports</code> internally, such code must call this method to flush the cached result.</p>
+
+<dt><a name="settings"
+><code  class="code">settings</code></a></dt>
+
+<dd>
+<p>Returns a hash of hashes which holds the user&#39;s settings. The first key is the name of the setting, as found in setting.name. The second key is one of: is_enabled - true if the user is allowed to set the preference themselves; false to force the site defaults for themselves or must accept the global site default value default_value - the global site default for this setting value - the value of this setting for this user. Will be the same as the default_value if the user is not logged in, or if is_default is true. is_default - a boolean to indicate whether the user has chosen to make a preference for themself or use the site default.</p>
+
+<dt><a name="setting(name)"
+><code  class="code">setting(name)</code></a></dt>
+
+<dd>
+<p>Returns the value for the specified setting.</p>
+
+<dt><a name="timezone"
+><code  class="code">timezone</code></a></dt>
+
+<dd>
+<p>Returns the timezone used to display dates and times to the user, as a DateTime::TimeZone object.</p>
+
+<dt><a name="groups"
+><code  class="code">groups</code></a></dt>
+
+<dd>
+<p>Returns an arrayref of <a href="../Bugzilla/Group.html" class="podlinkpod"
+>Bugzilla::Group</a> objects representing groups that this user is a member of.</p>
+
+<dt><a name="groups_as_string"
+><code  class="code">groups_as_string</code></a></dt>
+
+<dd>
+<p>Returns a string containing a comma-separated list of numeric group ids. If the user is not a member of any groups, returns &#34;-1&#34;. This is most often used within an SQL IN() function.</p>
+
+<dt><a name="groups_in_sql"
+><code  class="code">groups_in_sql</code></a></dt>
+
+<dd>
+<p>This returns an <code  class="code">IN</code> clause for SQL, containing either all of the groups the user is in, or <code  class="code">-1</code> if the user is in no groups. This takes one argument--the name of the SQL field that should be on the left-hand-side of the <code  class="code">IN</code> statement, which defaults to <code  class="code">group_id</code> if not specified.</p>
+
+<dt><a name="in_group($group_name,_$product_id)"
+><code  class="code">in_group($group_name, $product_id)</code></a></dt>
+
+<dd>
+<p>Determines whether or not a user is in the given group by name. If $product_id is given, it also checks for local privileges for this product.</p>
+
+<dt><a name="in_group_id"
+><code  class="code">in_group_id</code></a></dt>
+
+<dd>
+<p>Determines whether or not a user is in the given group by id.</p>
+
+<dt><a name="bless_groups"
+><code  class="code">bless_groups</code></a></dt>
+
+<dd>
+<p>Returns an arrayref of <a href="../Bugzilla/Group.html" class="podlinkpod"
+>Bugzilla::Group</a> objects.</p>
+
+<p>The arrayref consists of the groups the user can bless, taking into account that having editusers permissions means that you can bless all groups, and that you need to be able to see a group in order to bless it.</p>
+
+<dt><a name="get_products_by_permission($group)"
+><code  class="code">get_products_by_permission($group)</code></a></dt>
+
+<dd>
+<p>Returns a list of product objects for which the user has $group privileges and which he can access. $group must be one of the groups defined in PER_PRODUCT_PRIVILEGES.</p>
+
+<dt><a name="can_see_user(user)"
+><code  class="code">can_see_user(user)</code></a></dt>
+
+<dd>
+<p>Returns 1 if the specified user account exists and is visible to the user, 0 otherwise.</p>
+
+<dt><a name="can_edit_product(prod_id)"
+><code  class="code">can_edit_product(prod_id)</code></a></dt>
+
+<dd>
+<p>Determines if, given a product id, the user can edit bugs in this product at all.</p>
+
+<dt><a name="can_see_bug(bug_id)"
+><code  class="code">can_see_bug(bug_id)</code></a></dt>
+
+<dd>
+<p>Determines if the user can see the specified bug.</p>
+
+<dt><a name="can_see_product(product_name)"
+><code  class="code">can_see_product(product_name)</code></a></dt>
+
+<dd>
+<p>Returns 1 if the user can access the specified product, and 0 if the user should not be aware of the existence of the product.</p>
+
+<dt><a name="derive_regexp_groups"
+><code  class="code">derive_regexp_groups</code></a></dt>
+
+<dd>
+<p>Bugzilla allows for group inheritance. When data about the user (or any of the groups) changes, the database must be updated. Handling updated groups is taken care of by the constructor. However, when updating the email address, the user may be placed into different groups, based on a new email regexp. This method should be called in such a case to force reresolution of these groups.</p>
+
+<dt><a name="clear_product_cache"
+><code  class="code">clear_product_cache</code></a></dt>
+
+<dd>
+<p>Clears the stored values for <a href="#get_selectable_products" class="podlinkpod"
+>&#34;get_selectable_products&#34;</a>, <a href="#get_enterable_products" class="podlinkpod"
+>&#34;get_enterable_products&#34;</a>, etc. so that their data will be read from the database again. Used mostly by <a href="../Bugzilla/Product.html" class="podlinkpod"
+>Bugzilla::Product</a>.</p>
+
+<dt><a name="get_selectable_products"
+><code  class="code">get_selectable_products</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns all products the user is allowed to access. This list
+              is restricted to some given classification if $classification_id
+              is given.
+
+ Params:      $classification_id - (optional) The ID of the classification
+                                   the products belong to.
+
+ Returns:     An array of product objects, sorted by the product name.</pre>
+
+<dt><a name="get_selectable_classifications"
+><code  class="code">get_selectable_classifications</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns all classifications containing at least one product
+              the user is allowed to view.
+
+ Params:      none
+
+ Returns:     An array of Bugzilla::Classification objects, sorted by
+              the classification name.</pre>
+
+<dt><a name="can_enter_product($product_name,_$warn)"
+><code  class="code">can_enter_product($product_name, $warn)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns a product object if the user can enter bugs into the
+              specified product.
+              If the user cannot enter bugs into the product, the behavior of
+              this method depends on the value of $warn:
+              - if $warn is false (or not given), a &#39;false&#39; value is returned;
+              - if $warn is true, an error is thrown.
+
+ Params:      $product_name - a product name.
+              $warn         - optional parameter, indicating whether an error
+                              must be thrown if the user cannot enter bugs
+                              into the specified product.
+
+ Returns:     A product object if the user can enter bugs into the product,
+              0 if the user cannot enter bugs into the product and if $warn
+              is false (an error is thrown if $warn is true).</pre>
+
+<dt><a name="get_enterable_products"
+><code  class="code">get_enterable_products</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns an array of product objects into which the user is
+              allowed to enter bugs.
+
+ Params:      none
+
+ Returns:     an array of product objects.</pre>
+
+<dt><a name="can_access_product($product)"
+><code  class="code">can_access_product($product)</code></a></dt>
+
+<dd>
+<p>Returns 1 if the user can search or enter bugs into the specified product (either a <a href="../Bugzilla/Product.html" class="podlinkpod"
+>Bugzilla::Product</a> or a product name), and 0 if the user should not be aware of the existence of the product.</p>
+
+<dt><a name="get_accessible_products"
+><code  class="code">get_accessible_products</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns an array of product objects the user can search
+              or enter bugs against.
+
+ Params:      none
+
+ Returns:     an array of product objects.</pre>
+
+<dt><a name="check_can_admin_product($product_name)"
+><code  class="code">check_can_admin_product($product_name)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Checks whether the user is allowed to administrate the product.
+
+ Params:      $product_name - a product name.
+
+ Returns:     On success, a product object. On failure, an error is thrown.</pre>
+
+<dt><a name="check_can_admin_flagtype($flagtype_id)"
+><code  class="code">check_can_admin_flagtype($flagtype_id)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Checks whether the user is allowed to edit properties of the flag type.
+              If the flag type is also used by some products for which the user
+              hasn&#39;t editcomponents privs, then the user is only allowed to edit
+              the inclusion and exclusion lists for products he can administrate.
+
+ Params:      $flagtype_id - a flag type ID.
+
+ Returns:     On success, a flag type object. On failure, an error is thrown.
+              In list context, a boolean indicating whether the user can edit
+              all properties of the flag type is also returned. The boolean
+              is false if the user can only edit the inclusion and exclusions
+              lists.</pre>
+
+<dt><a name="can_request_flag($flag_type)"
+><code  class="code">can_request_flag($flag_type)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Checks whether the user can request flags of the given type.
+
+ Params:      $flag_type - a Bugzilla::FlagType object.
+
+ Returns:     1 if the user can request flags of the given type,
+              0 otherwise.</pre>
+
+<dt><a name="can_set_flag($flag_type)"
+><code  class="code">can_set_flag($flag_type)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Checks whether the user can set flags of the given type.
+
+ Params:      $flag_type - a Bugzilla::FlagType object.
+
+ Returns:     1 if the user can set flags of the given type,
+              0 otherwise.</pre>
+
+<dt><a name="get_userlist"
+><code  class="code">get_userlist</code></a></dt>
+
+<dd>
+<p>Returns a reference to an array of users. The array is populated with hashrefs containing the login, identity and visibility. Users that are not visible to this user will have &#39;visible&#39; set to zero.</p>
+
+<dt><a name="visible_groups_inherited"
+><code  class="code">visible_groups_inherited</code></a></dt>
+
+<dd>
+<p>Returns a list of all groups whose members should be visible to this user. Since this list is flattened already, there is no need for all users to be have derived groups up-to-date to select the users meeting this criteria.</p>
+
+<dt><a name="visible_groups_direct"
+><code  class="code">visible_groups_direct</code></a></dt>
+
+<dd>
+<p>Returns a list of groups that the user is aware of.</p>
+
+<dt><a name="visible_groups_as_string"
+><code  class="code">visible_groups_as_string</code></a></dt>
+
+<dd>
+<p>Returns the result of <code  class="code">visible_groups_inherited</code> as a string (a comma-separated list).</p>
+
+<dt><a name="product_responsibilities"
+><code  class="code">product_responsibilities</code></a></dt>
+
+<dd>
+<p>Retrieve user&#39;s product responsibilities as a list of component objects. Each object is a component the user has a responsibility for.</p>
+
+<dt><a name="can_bless"
+><code  class="code">can_bless</code></a></dt>
+
+<dd>
+<p>When called with no arguments: Returns <code  class="code">1</code> if the user can bless at least one group, returns <code  class="code">0</code> otherwise.</p>
+
+<p>When called with one argument: Returns <code  class="code">1</code> if the user can bless the group with that id, returns <code  class="code">0</code> otherwise.</p>
+
+<dt><a name="wants_bug_mail"
+><code  class="code">wants_bug_mail</code></a></dt>
+
+<dd>
+<p>Returns true if the user wants mail for a given bug change.</p>
+
+<dt><a name="wants_mail"
+><code  class="code">wants_mail</code></a></dt>
+
+<dd>
+<p>Returns true if the user wants mail for a given set of events. This method is more general than <code  class="code">wants_bug_mail</code>, allowing you to check e.g. permissions for flag mail.</p>
+
+<dt><a name="is_insider"
+><code  class="code">is_insider</code></a></dt>
+
+<dd>
+<p>Returns true if the user can access private comments and attachments, i.e. if the &#39;insidergroup&#39; parameter is set and the user belongs to this group.</p>
+
+<dt><a name="is_global_watcher"
+><code  class="code">is_global_watcher</code></a></dt>
+
+<dd>
+<p>Returns true if the user is a global watcher, i.e. if the &#39;globalwatchers&#39; parameter contains the user.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CLASS_FUNCTIONS"
+>CLASS FUNCTIONS</a></h1>
+
+<p>These are functions that are not called on a User object, but instead are called &#34;statically,&#34; just like a normal procedural function.</p>
+
+<dl>
+<dt><a name="create"
+><code  class="code">create</code></a></dt>
+
+<dd>
+<p>The same as <a href="../Bugzilla/Object.html#create" class="podlinkpod"
+>&#34;create&#34; in Bugzilla::Object</a>.</p>
+
+<p>Params: login_name - <b>Required</b> The login name for the new user. realname - The full name for the new user. cryptpassword - <b>Required</b> The password for the new user. Even though the name says &#34;crypt&#34;, you should just specify a plain-text password. If you specify &#39;*&#39;, the user will not be able to log in using DB authentication. disabledtext - The disable-text for the new user. If given, the user will be disabled, meaning he cannot log in. Defaults to an empty string. disable_mail - If 1, bug-related mail will not be sent to this user; if 0, mail will be sent depending on the user&#39;s email preferences.</p>
+
+<dt><a name="check"
+><code  class="code">check</code></a></dt>
+
+<dd>
+<p>Takes a username as its only argument. Throws an error if there is no user with that username. Returns a <code  class="code">Bugzilla::User</code> object.</p>
+
+<dt><a name="check_account_creation_enabled"
+><code  class="code">check_account_creation_enabled</code></a></dt>
+
+<dd>
+<p>Checks that users can create new user accounts, and throws an error if user creation is disabled.</p>
+
+<dt><a name="check_and_send_account_creation_confirmation($login)"
+><code  class="code">check_and_send_account_creation_confirmation($login)</code></a></dt>
+
+<dd>
+<p>If the user request for a new account passes validation checks, an email is sent to this user for confirmation. Otherwise an error is thrown indicating why the request has been rejected.</p>
+
+<dt><a name="is_available_username"
+><code  class="code">is_available_username</code></a></dt>
+
+<dd>
+<p>Returns a boolean indicating whether or not the supplied username is already taken in Bugzilla.</p>
+
+<p>Params: $username (scalar, string) - The full login name of the username that you are checking. $old_username (scalar, string) - If you are checking an email-change token, insert the &#34;old&#34; username that the user is changing from, here. Then, as long as it&#39;s the right user for that token, he can change his username to $username. (That is, this function will return a boolean true value).</p>
+
+<dt><a name="login_to_id($login,_$throw_error)"
+><code  class="code">login_to_id($login, $throw_error)</code></a></dt>
+
+<dd>
+<p>Takes a login name of a Bugzilla user and changes that into a numeric ID for that user. This ID can then be passed to Bugzilla::User::new to create a new user.</p>
+
+<p>If no valid user exists with that login name, then the function returns 0. However, if $throw_error is set, the function will throw a user error instead of returning.</p>
+
+<p>This function can also be used when you want to just find out the userid of a user, but you don&#39;t want the full weight of Bugzilla::User.</p>
+
+<p>However, consider using a Bugzilla::User object instead of this function if you need more information about the user than just their ID.</p>
+
+<dt><a name="user_id_to_login($user_id)"
+><code  class="code">user_id_to_login($user_id)</code></a></dt>
+
+<dd>
+<p>Returns the login name of the user account for the given user ID. If no valid user ID is given or the user has no entry in the profiles table, we return an empty string.</p>
+
+<dt><a name="validate_password($passwd1,_$passwd2)"
+><code  class="code">validate_password($passwd1, $passwd2)</code></a></dt>
+
+<dd>
+<p>Returns true if a password is valid (i.e. meets Bugzilla&#39;s requirements for length and content), else returns false. Untaints <code  class="code">$passwd1</code> if successful.</p>
+
+<p>If a second password is passed in, this function also verifies that the two passwords match.</p>
+
+<dt><a name="match_field($data,_$fields,_$behavior)"
+><code  class="code">match_field($data, $fields, $behavior)</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Wrapper for the <code  class="code">match()</code> function.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a 
+><code  class="code">$fields</code> - A hashref with field names as keys and a hash as values. Each hash is of the form { &#39;type&#39; =&#62; &#39;single|multi&#39; }, which specifies whether the field can take a single login name only or several.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">$data</code> (optional) - A hashref with field names as keys and field values as values. If undefined, <code  class="code">Bugzilla-&#62;input_params</code> is used.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">$behavior</code> (optional) - If set to <code  class="code">MATCH_SKIP_CONFIRM</code>, no confirmation screen is displayed. In that case, the fields which don&#39;t match a unique user are left undefined. If not set, a confirmation screen is displayed if at least one field doesn&#39;t match any login name or match more than one.</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>If the third parameter is set to <code  class="code">MATCH_SKIP_CONFIRM</code>, the function returns either <code  class="code">USER_MATCH_SUCCESS</code> if all fields can be set unambiguously, <code  class="code">USER_MATCH_FAILED</code> if at least one field doesn&#39;t match any user account, or <code  class="code">USER_MATCH_MULTIPLE</code> if some fields match more than one user account.</p>
+
+<p>If the third parameter is not set, then if all fields could be set unambiguously, nothing is returned, else a confirmation page is displayed.</p>
+
+<dt><a name="Note"
+><b>Note</b></a></dt>
+
+<dd>
+<p>This function must be called early in a script, before anything external is done with the data.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SEE_ALSO"
+>SEE ALSO</a></h1>
+
+<p><a href="../Bugzilla.html" class="podlinkpod"
+>Bugzilla</a></p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/User/Setting.html b/docs/en/html/api/Bugzilla/User/Setting.html
new file mode 100644 (file)
index 0000000..21fc8fb
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/User/Setting.html
@@ -0,0 +1,158 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::User::Setting</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::User::Setting</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#CLASS_FUNCTIONS'>CLASS FUNCTIONS</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::User::Setting - Object for a user preference setting</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<p>Setting.pm creates a setting object,
+which is a hash containing the user preference information for a single preference for a single user.
+These are usually accessed through the &#34;settings&#34; object of a user,
+and not directly.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>use Bugzilla::User::Setting; my $settings;</p>
+
+<p>$settings-&#62;{$setting_name} = new Bugzilla::User::Setting( $setting_name,
+$user_id);</p>
+
+<p>OR</p>
+
+<p>$settings-&#62;{$setting_name} = new Bugzilla::User::Setting( $setting_name,
+$user_id,
+$is_enabled,
+$default_value,
+$value,
+$is_default);</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CLASS_FUNCTIONS"
+>CLASS FUNCTIONS</a></h1>
+
+<dl>
+<dt><a name="add_setting($name,_\@values,_$default_value,_$subclass,_$force_check)"
+><code  class="code">add_setting($name,
+\@values,
+$default_value,
+$subclass,
+$force_check)</code></a></dt>
+
+<dd>
+<p>Description: Checks for the existence of a setting,
+and adds it to the database if it does not yet exist.</p>
+
+<p>Params: <code  class="code">$name</code> - string - the name of the new setting <code  class="code">$values</code> - arrayref - contains the new choices for the new Setting.
+<code  class="code">$default_value</code> - string - the site default <code  class="code">$subclass</code> - string - name of the module returning the list of valid values.
+This means legal values are not stored in the DB.
+<code  class="code">$force_check</code> - boolean - when true,
+the existing setting and all its values are deleted and replaced by new data.</p>
+
+<p>Returns: a pointer to a hash of settings</p>
+
+<dt><a name="get_all_settings($user_id)"
+><code  class="code">get_all_settings($user_id)</code></a></dt>
+
+<dd>
+<p>Description: Provides the user&#39;s choices for each setting in the system; if the user has made no choice,
+uses the site default instead.
+Params: <code  class="code">$user_id</code> - integer - the user id.
+Returns: a pointer to a hash of settings</p>
+
+<dt><a name="get_defaults($user_id)"
+><code  class="code">get_defaults($user_id)</code></a></dt>
+
+<dd>
+<p>Description: When a user is not logged in,
+they must use the site defaults for every settings; this subroutine provides them.
+Params: <code  class="code">$user_id</code> (optional) - integer - the user id.
+Note that this optional parameter is mainly for internal use only.
+Returns: A pointer to a hash of settings.
+If $user_id was passed,
+set the user_id value for each setting.</p>
+
+<dt><a name="set_default($setting_name,_$default_value,_$is_enabled)"
+><code  class="code">set_default($setting_name,
+$default_value,
+$is_enabled)</code></a></dt>
+
+<dd>
+<p>Description: Sets the global default for a given setting.
+Also sets whether users are allowed to choose their own value for this setting,
+or if they must use the global default.
+Params: <code  class="code">$setting_name</code> - string - the name of the setting <code  class="code">$default_value</code> - string - the new default value for this setting <code  class="code">$is_enabled</code> - boolean - if false,
+all users must use the global default Returns: nothing</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<dl>
+<dt><a name="legal_values($setting_name)"
+><code  class="code">legal_values($setting_name)</code></a></dt>
+
+<dd>
+<p>Description: Returns all legal values for this setting Params: none Returns: A reference to an array containing all legal values</p>
+
+<dt><a name="validate_value"
+><code  class="code">validate_value</code></a></dt>
+
+<dd>
+<p>Description: Determines whether a value is valid for the setting by checking against the list of legal values.
+Untaints the parameter if the value is indeed valid,
+and throws a setting_value_invalid code error if not.
+Params: An lvalue containing a candidate for a setting value Returns: nothing</p>
+
+<dt><a name="reset_to_default"
+><code  class="code">reset_to_default</code></a></dt>
+
+<dd>
+<p>Description: If a user chooses to use the global default for a given setting,
+their saved entry is removed from the database via this subroutine.
+Params: none Returns: nothing</p>
+
+<dt><a name="set($value)"
+><code  class="code">set($value)</code></a></dt>
+
+<dd>
+<p>Description: If a user chooses to use their own value rather than the global value for a given setting,
+OR changes their value for a given setting,
+this subroutine is called to insert or update the database as appropriate.
+Params: <code  class="code">$value</code> - string - the new value for this setting for this user.
+Returns: nothing</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/User/Setting/Lang.html b/docs/en/html/api/Bugzilla/User/Setting/Lang.html
new file mode 100644 (file)
index 0000000..ea1d273
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/User/Setting/Lang.html
@@ -0,0 +1,49 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::User::Setting::Lang</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::User::Setting::Lang</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::User::Setting::Lang - Object for a user preference setting for preferred language</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Lang.pm extends Bugzilla::User::Setting and implements a class specialized for setting the preferred language.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<dl>
+<dt><a name="legal_values()"
+><code  class="code">legal_values()</code></a></dt>
+
+<dd>
+<p>Description: Returns all legal languages Params: none Returns: A reference to an array containing the names of all legal languages</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/User/Setting/Skin.html b/docs/en/html/api/Bugzilla/User/Setting/Skin.html
new file mode 100644 (file)
index 0000000..72d01f1
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/User/Setting/Skin.html
@@ -0,0 +1,49 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::User::Setting::Skin</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::User::Setting::Skin</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::User::Setting::Skin - Object for a user preference setting for skins</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Skin.pm extends Bugzilla::User::Setting and implements a class specialized for skins settings.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<dl>
+<dt><a name="legal_values()"
+><code  class="code">legal_values()</code></a></dt>
+
+<dd>
+<p>Description: Returns all legal skins Params: none Returns: A reference to an array containing the names of all legal skins</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/User/Setting/Timezone.html b/docs/en/html/api/Bugzilla/User/Setting/Timezone.html
new file mode 100644 (file)
index 0000000..6ca1a8b
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/User/Setting/Timezone.html
@@ -0,0 +1,53 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::User::Setting::Timezone</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::User::Setting::Timezone</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::User::Setting::Timezone - Object for a user preference setting for desired timezone</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Timezone.pm extends Bugzilla::User::Setting and implements a class specialized for setting the desired timezone.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<dl>
+<dt><a name="legal_values()"
+><code  class="code">legal_values()</code></a></dt>
+
+<dd>
+<p>Description: Returns all legal timezones</p>
+
+<p>Params: none</p>
+
+<p>Returns: A reference to an array containing the names of all legal timezones</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/UserAgent.html b/docs/en/html/api/Bugzilla/UserAgent.html
new file mode 100644 (file)
index 0000000..dc8588b
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/UserAgent.html
@@ -0,0 +1,63 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::UserAgent</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::UserAgent</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#FUNCTIONS'>FUNCTIONS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::UserAgent - UserAgent utilities for Bugzilla</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">  use Bugzilla::UserAgent;
+  printf &#34;platform: %s op-sys: %s\n&#34;, detect_platform(), detect_op_sys();</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>The functions exported by this module all return information derived from the remote client&#39;s user agent.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="FUNCTIONS"
+>FUNCTIONS</a></h1>
+
+<dl>
+<dt><a name="detect_platform"
+><code  class="code">detect_platform</code></a></dt>
+
+<dd>
+<p>This function attempts to detect the remote client&#39;s platform from the presented user-agent. If a suitable value on the <i>platform</i> field is found, that field value will be returned. If no suitable value is detected, <code  class="code">detect_platform</code> returns <i>Other</i>.</p>
+
+<dt><a name="detect_op_sys"
+><code  class="code">detect_op_sys</code></a></dt>
+
+<dd>
+<p>This function attempts to detect the remote client&#39;s operating system from the presented user-agent. If a suitable value on the <i>op_sys</i> field is found, that field value will be returned. If no suitable value is detected, <code  class="code">detect_op_sys</code> returns <i>Other</i>.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Util.html b/docs/en/html/api/Bugzilla/Util.html
new file mode 100644 (file)
index 0000000..33c6547
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Util.html
@@ -0,0 +1,421 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Util</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Util</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#FUNCTIONS'>FUNCTIONS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Tainting'>Tainting</a>
+    <li class='indexItem indexItem2'><a href='#Quoting'>Quoting</a>
+    <li class='indexItem indexItem2'><a href='#Environment_and_Location'>Environment and Location</a>
+    <li class='indexItem indexItem2'><a href='#Data_Manipulation'>Data Manipulation</a>
+    <li class='indexItem indexItem2'><a href='#String_Manipulation'>String Manipulation</a>
+    <li class='indexItem indexItem2'><a href='#Formatting_Time'>Formatting Time</a>
+    <li class='indexItem indexItem2'><a href='#Cryptography'>Cryptography</a>
+    <li class='indexItem indexItem2'><a href='#Validation'>Validation</a>
+    <li class='indexItem indexItem2'><a href='#Database'>Database</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Util - Generic utility functions for bugzilla</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">  use Bugzilla::Util;
+
+  # Functions for dealing with variable tainting
+  trick_taint($var);
+  detaint_natural($var);
+  detaint_signed($var);
+
+  # Functions for quoting
+  html_quote($var);
+  url_quote($var);
+  xml_quote($var);
+  email_filter($var);
+
+  # Functions that tell you about your environment
+  my $is_cgi   = i_am_cgi();
+  my $urlbase  = correct_urlbase();
+
+  # Data manipulation
+  ($removed, $added) = diff_arrays(\@old, \@new);
+
+  # Functions for manipulating strings
+  $val = trim(&#34; abc &#34;);
+  $wrapped = wrap_comment($comment);
+
+  # Functions for formatting time
+  format_time($time);
+  datetime_from($time, $timezone);
+
+  # Cryptographic Functions
+  $crypted_password = bz_crypt($password);
+  $new_password = generate_random_password($password_length);
+
+  # Validation Functions
+  validate_email_syntax($email);
+  check_email_syntax($email);
+  validate_date($date);
+
+  # DB-related functions
+  on_main_db {
+     ... code here ...
+  };</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This package contains various utility functions which do not belong anywhere else.</p>
+
+<p><b>It is not intended as a general dumping group for something which people feel might be useful somewhere, someday</b>. Do not add methods to this package unless it is intended to be used for a significant number of files, and it does not belong anywhere else.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="FUNCTIONS"
+>FUNCTIONS</a></h1>
+
+<p>This package provides several types of routines:</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Tainting"
+>Tainting</a></h2>
+
+<p>Several functions are available to deal with tainted variables. <b>Use these with care</b> to avoid security holes.</p>
+
+<dl>
+<dt><a name="trick_taint($val)"
+><code  class="code">trick_taint($val)</code></a></dt>
+
+<dd>
+<p>Tricks perl into untainting a particular variable.</p>
+
+<p>Use trick_taint() when you know that there is no way that the data in a scalar can be tainted, but taint mode still bails on it.</p>
+
+<p><b>WARNING!! Using this routine on data that really could be tainted defeats the purpose of taint mode. It should only be used on variables that have been sanity checked in some way and have been determined to be OK.</b></p>
+
+<dt><a name="detaint_natural($num)"
+><code  class="code">detaint_natural($num)</code></a></dt>
+
+<dd>
+<p>This routine detaints a natural number. It returns a true value if the value passed in was a valid natural number, else it returns false. You <b>MUST</b> check the result of this routine to avoid security holes.</p>
+
+<dt><a name="detaint_signed($num)"
+><code  class="code">detaint_signed($num)</code></a></dt>
+
+<dd>
+<p>This routine detaints a signed integer. It returns a true value if the value passed in was a valid signed integer, else it returns false. You <b>MUST</b> check the result of this routine to avoid security holes.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Quoting"
+>Quoting</a></h2>
+
+<p>Some values may need to be quoted from perl. However, this should in general be done in the template where possible.</p>
+
+<dl>
+<dt><a name="html_quote($val)"
+><code  class="code">html_quote($val)</code></a></dt>
+
+<dd>
+<p>Returns a value quoted for use in HTML, with &#38;, &#60;, &#62;, &#34; and @ being replaced with their appropriate HTML entities. Also, Unicode BiDi controls are deleted.</p>
+
+<dt><a name="html_light_quote($val)"
+><code  class="code">html_light_quote($val)</code></a></dt>
+
+<dd>
+<p>Returns a string where only explicitly allowed HTML elements and attributes are kept. All HTML elements and attributes not being in the whitelist are either escaped (if HTML::Scrubber is not installed) or removed.</p>
+
+<dt><a name="url_quote($val)"
+><code  class="code">url_quote($val)</code></a></dt>
+
+<dd>
+<p>Quotes characters so that they may be included as part of a url.</p>
+
+<dt><a name="css_class_quote($val)"
+><code  class="code">css_class_quote($val)</code></a></dt>
+
+<dd>
+<p>Quotes characters so that they may be used as CSS class names. Spaces and forward slashes are replaced by underscores.</p>
+
+<dt><a name="xml_quote($val)"
+><code  class="code">xml_quote($val)</code></a></dt>
+
+<dd>
+<p>This is similar to <code  class="code">html_quote</code>, except that &#39; is escaped to &#38;apos;. This is kept separate from html_quote partly for compatibility with previous code (for &#38;apos;) and partly for future handling of non-ASCII characters.</p>
+
+<dt><a name="email_filter"
+><code  class="code">email_filter</code></a></dt>
+
+<dd>
+<p>Removes the hostname from email addresses in the string, if the user currently viewing Bugzilla is logged out. If the user is logged-in, this filter just returns the input string.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Environment_and_Location"
+>Environment and Location</a></h2>
+
+<p>Functions returning information about your environment or location.</p>
+
+<dl>
+<dt><a name="i_am_cgi()"
+><code  class="code">i_am_cgi()</code></a></dt>
+
+<dd>
+<p>Tells you whether or not you are being run as a CGI script in a web server. For example, it would return false if the caller is running in a command-line script.</p>
+
+<dt><a name="correct_urlbase()"
+><code  class="code">correct_urlbase()</code></a></dt>
+
+<dd>
+<p>Returns either the <code  class="code">sslbase</code> or <code  class="code">urlbase</code> parameter, depending on the current setting for the <code  class="code">ssl_redirect</code> parameter.</p>
+
+<dt><a name="remote_ip()"
+><code  class="code">remote_ip()</code></a></dt>
+
+<dd>
+<p>Returns the IP address of the remote client. If Bugzilla is behind a trusted proxy, it will get the remote IP address by looking at the X-Forwarded-For header.</p>
+
+<dt><a name="validate_ip($ip)"
+><code  class="code">validate_ip($ip)</code></a></dt>
+
+<dd>
+<p>Returns the sanitized IP address if it is a valid IPv4 or IPv6 address, else returns undef.</p>
+
+<dt><a name="use_attachbase()"
+><code  class="code">use_attachbase()</code></a></dt>
+
+<dd>
+<p>Returns true if an alternate host is used to display attachments; false otherwise.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Data_Manipulation"
+>Data Manipulation</a></h2>
+
+<dl>
+<dt><a name="diff_arrays(\@old,_\@new)"
+><code  class="code">diff_arrays(\@old, \@new)</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Takes two arrayrefs, and will tell you what it takes to 
+              get from @old to @new.
+ Params:      @old = array that you are changing from
+              @new = array that you are changing to
+ Returns:     A list of two arrayrefs. The first is a reference to an 
+              array containing items that were removed from @old. The
+              second is a reference to an array containing items
+              that were added to @old. If both returned arrays are 
+              empty, @old and @new contain the same values.</pre>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="String_Manipulation"
+>String Manipulation</a></h2>
+
+<dl>
+<dt><a name="trim($str)"
+><code  class="code">trim($str)</code></a></dt>
+
+<dd>
+<p>Removes any leading or trailing whitespace from a string. This routine does not modify the existing string.</p>
+
+<dt><a name="wrap_hard($string,_$size)"
+><code  class="code">wrap_hard($string, $size)</code></a></dt>
+
+<dd>
+<p>Wraps a string, so that a line is <i>never</i> longer than <code  class="code">$size</code>. Returns the string, wrapped.</p>
+
+<dt><a name="wrap_comment($comment)"
+><code  class="code">wrap_comment($comment)</code></a></dt>
+
+<dd>
+<p>Takes a bug comment, and wraps it to the appropriate length. The length is currently specified in <code  class="code">Bugzilla::Constants::COMMENT_COLS</code>. Lines beginning with &#34;&#62;&#34; are assumed to be quotes, and they will not be wrapped.</p>
+
+<p>The intended use of this function is to wrap comments that are about to be displayed or emailed. Generally, wrapped text should not be stored in the database.</p>
+
+<dt><a name="find_wrap_point($string,_$maxpos)"
+><code  class="code">find_wrap_point($string, $maxpos)</code></a></dt>
+
+<dd>
+<p>Search for a comma, a whitespace or a hyphen to split $string, within the first $maxpos characters. If none of them is found, just split $string at $maxpos. The search starts at $maxpos and goes back to the beginning of the string.</p>
+
+<dt><a name="is_7bit_clean($str)"
+><code  class="code">is_7bit_clean($str)</code></a></dt>
+
+<dd>
+<p>Returns true is the string contains only 7-bit characters (ASCII 32 through 126, ASCII 10 (LineFeed) and ASCII 13 (Carrage Return).</p>
+
+<dt><a name="disable_utf8()"
+><code  class="code">disable_utf8()</code></a></dt>
+
+<dd>
+<p>Disable utf8 on STDOUT (and display raw data instead).</p>
+
+<dt><a name="detect_encoding($str)"
+><code  class="code">detect_encoding($str)</code></a></dt>
+
+<dd>
+<p>Guesses what encoding a given data is encoded in, returning the canonical name of the detected encoding (which may be different from the MIME charset specification).</p>
+
+<dt><a 
+><code  class="code">clean_text($str)</code> Returns the parameter &#34;cleaned&#34; by exchanging non-printable characters with spaces. Specifically characters (ASCII 0 through 31) and (ASCII 127) will become ASCII 32 (Space).</a></dt>
+
+<dd>
+<dt><a name="get_text"
+><code  class="code">get_text</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>This is a method of getting localized strings within Bugzilla code. Use this when you don&#39;t want to display a whole template, you just want a particular string.</p>
+
+<p>It uses the <em  class="code">global/message.txt.tmpl</em> template to return a string.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="$message_-_The_identifier_for_the_message."
+><code  class="code">$message</code> - The identifier for the message.</a></dt>
+
+<dd>
+<dt><a name="$vars_-_A_hashref._Any_variables_you_want_to_pass_to_the_template."
+><code  class="code">$vars</code> - A hashref. Any variables you want to pass to the template.</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A string.</p>
+</dd>
+</dl>
+
+<dt><a name="template_var"
+><code  class="code">template_var</code></a></dt>
+
+<dd>
+<p>This is a method of getting the value of a variable from a template in Perl code. The available variables are in the <code  class="code">global/field-descs.none.tmpl</code> template. Just pass in the name of the variable that you want the value of.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Formatting_Time"
+>Formatting Time</a></h2>
+
+<dl>
+<dt><a name="format_time($time)"
+><code  class="code">format_time($time)</code></a></dt>
+
+<dd>
+<p>Takes a time and converts it to the desired format and timezone. If no format is given, the routine guesses the correct one and returns an empty array if it cannot. If no timezone is given, the user&#39;s timezone is used, as defined in his preferences.</p>
+
+<p>This routine is mainly called from templates to filter dates, see &#34;FILTER time&#34; in <a href="../Bugzilla/Template.html" class="podlinkpod"
+>Bugzilla::Template</a>.</p>
+
+<dt><a name="datetime_from($time,_$timezone)"
+><code  class="code">datetime_from($time, $timezone)</code></a></dt>
+
+<dd>
+<p>Returns a DateTime object given a date string. If the string is not in some valid date format that <code  class="code">strptime</code> understands, we return <code  class="code">undef</code>.</p>
+
+<p>You can optionally specify a timezone for the returned date. If not specified, defaults to the currently-logged-in user&#39;s timezone, or the Bugzilla server&#39;s local timezone if there isn&#39;t a logged-in user.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Cryptography"
+>Cryptography</a></h2>
+
+<dl>
+<dt><a name="bz_crypt($password,_$salt)"
+><code  class="code">bz_crypt($password, $salt)</code></a></dt>
+
+<dd>
+<p>Takes a string and returns a hashed (encrypted) value for it, using a random salt. An optional salt string may also be passed in.</p>
+
+<p>Please always use this function instead of the built-in perl <code  class="code">crypt</code> function, when checking or setting a password. Bugzilla does not use <code  class="code">crypt</code>.</p>
+
+<dt><a name="generate_random_password($password_length)"
+><code  class="code">generate_random_password($password_length)</code></a></dt>
+
+<dd>
+<p>Returns an alphanumeric string with the specified length (10 characters by default). Use this function to generate passwords and tokens.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Validation"
+>Validation</a></h2>
+
+<dl>
+<dt><a name="validate_email_syntax($email)"
+><code  class="code">validate_email_syntax($email)</code></a></dt>
+
+<dd>
+<p>Do a syntax checking for a legal email address and returns 1 if the check is successful, else returns 0. Untaints <code  class="code">$email</code> if successful.</p>
+
+<dt><a name="check_email_syntax($email)"
+><code  class="code">check_email_syntax($email)</code></a></dt>
+
+<dd>
+<p>Do a syntax checking for a legal email address and throws an error if the check fails. Untaints <code  class="code">$email</code> if successful.</p>
+
+<dt><a name="validate_date($date)"
+><code  class="code">validate_date($date)</code></a></dt>
+
+<dd>
+<p>Make sure the date has the correct format and returns 1 if the check is successful, else returns 0.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Database"
+>Database</a></h2>
+
+<dl>
+<dt><a name="on_main_db"
+><code  class="code">on_main_db</code></a></dt>
+
+<dd>
+<p>Runs a block of code always on the main DB. Useful for when you&#39;re inside a subroutine and need to do some writes to the database, but don&#39;t know if Bugzilla is currently using the shadowdb or not. Used like:</p>
+
+<pre  class="code"> on_main_db {
+     my $dbh = Bugzilla-&#62;dbh;
+     $dbh-&#62;do(&#34;INSERT ...&#34;);
+ }</pre>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Version.html b/docs/en/html/api/Bugzilla/Version.html
new file mode 100644 (file)
index 0000000..0760cf2
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Version.html
@@ -0,0 +1,80 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Version</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Version</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Version - Bugzilla product version class.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">    use Bugzilla::Version;
+
+    my $version = new Bugzilla::Version({ name =&#62; $name, product =&#62; $product_obj });
+    my $version = Bugzilla::Version-&#62;check({ name =&#62; $name, product =&#62; $product_obj });
+    my $version = Bugzilla::Version-&#62;check({ id =&#62; $id });
+
+    my $value = $version-&#62;name;
+    my $product_id = $version-&#62;product_id;
+    my $product = $version-&#62;product;
+
+    my $version = Bugzilla::Version-&#62;create(
+        { value =&#62; $name, product =&#62; $product_obj });
+
+    $version-&#62;set_name($new_name);
+    $version-&#62;update();
+
+    $version-&#62;remove_from_db;</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Version.pm represents a Product Version object. It is an implementation of <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, and thus provides all methods that <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a> provides.</p>
+
+<p>The methods that are specific to <code  class="code">Bugzilla::Version</code> are listed below.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<dl>
+<dt><a name="bug_count()"
+><code  class="code">bug_count()</code></a></dt>
+
+<dd>
+<pre  class="code"> Description: Returns the total of bugs that belong to the version.
+
+ Params:      none.
+
+ Returns:     Integer with the number of bugs.</pre>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/WebService.html b/docs/en/html/api/Bugzilla/WebService.html
new file mode 100644 (file)
index 0000000..7d3448a
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/WebService.html
@@ -0,0 +1,357 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::WebService</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::WebService</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#CALLING_METHODS'>CALLING METHODS</a>
+  <li class='indexItem indexItem1'><a href='#PARAMETERS'>PARAMETERS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#How_Bugzilla_WebService_Methods_Take_Parameters'>How Bugzilla WebService Methods Take Parameters</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#LOGGING_IN'>LOGGING IN</a>
+  <li class='indexItem indexItem1'><a href='#STABLE%2C_EXPERIMENTAL%2C_and_UNSTABLE'>STABLE, EXPERIMENTAL, and UNSTABLE</a>
+  <li class='indexItem indexItem1'><a href='#ERRORS'>ERRORS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Transient_vs._Fatal_Errors'>Transient vs. Fatal Errors</a>
+    <li class='indexItem indexItem2'><a href='#Unknown_Errors'>Unknown Errors</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#COMMON_PARAMETERS'>COMMON PARAMETERS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Limiting_What_Fields_Are_Returned'>Limiting What Fields Are Returned</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#SEE_ALSO'>SEE ALSO</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Server_Types'>Server Types</a>
+    <li class='indexItem indexItem2'><a href='#WebService_Modules'>WebService Modules</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::WebService - The Web Service interface to Bugzilla</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This is the standard API for external programs that want to interact with Bugzilla.
+It provides various methods in various modules.</p>
+
+<p>You can interact with this API via <a href="../Bugzilla/WebService/Server/XMLRPC.html" class="podlinkpod"
+>XML-RPC</a> or <a href="../Bugzilla/WebService/Server/JSONRPC.html" class="podlinkpod"
+>JSON-RPC</a>.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CALLING_METHODS"
+>CALLING METHODS</a></h1>
+
+<p>Methods are grouped into &#34;packages&#34;,
+like <code  class="code">Bug</code> for <a href="../Bugzilla/WebService/Bug.html" class="podlinkpod"
+>Bugzilla::WebService::Bug</a>.
+So,
+for example,
+<a href="../Bugzilla/WebService/Bug.html#get" class="podlinkpod"
+>&#34;get&#34; in Bugzilla::WebService::Bug</a>,
+is called as <code  class="code">Bug.get</code>.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="PARAMETERS"
+>PARAMETERS</a></h1>
+
+<p>The Bugzilla API takes the following various types of parameters:</p>
+
+<dl>
+<dt><a name="int"
+><code  class="code">int</code></a></dt>
+
+<dd>
+<p>Integer.
+May be null.</p>
+
+<dt><a name="double"
+><code  class="code">double</code></a></dt>
+
+<dd>
+<p>A floating-point number.
+May be null.</p>
+
+<dt><a name="string"
+><code  class="code">string</code></a></dt>
+
+<dd>
+<p>A string.
+May be null.</p>
+
+<dt><a name="dateTime"
+><code  class="code">dateTime</code></a></dt>
+
+<dd>
+<p>A date/time.
+Represented differently in different interfaces to this API.
+May be null.</p>
+
+<dt><a name="boolean"
+><code  class="code">boolean</code></a></dt>
+
+<dd>
+<p>True or false.</p>
+
+<dt><a name="base64"
+><code  class="code">base64</code></a></dt>
+
+<dd>
+<p>A base64-encoded string.
+This is the only way to transfer binary data via the WebService.</p>
+
+<dt><a name="array"
+><code  class="code">array</code></a></dt>
+
+<dd>
+<p>An array.
+There may be mixed types in an array.</p>
+
+<p>In example code,
+you will see the characters <code  class="code">[</code> and <code  class="code">]</code> used to represent the beginning and end of arrays.</p>
+
+<p>In our example code in these API docs,
+an array that contains the numbers 1,
+2,
+and 3 would look like:</p>
+
+<pre  class="code"> [1, 2, 3]</pre>
+
+<dt><a name="struct"
+><code  class="code">struct</code></a></dt>
+
+<dd>
+<p>A mapping of keys to values. Called a &#34;hash&#34;, &#34;dict&#34;, or &#34;map&#34; in some other programming languages. We sometimes call this a &#34;hash&#34; in the API documentation.</p>
+
+<p>The keys are strings, and the values can be any type.</p>
+
+<p>In example code, you will see the characters <code  class="code">{</code> and <code  class="code">}</code> used to represent the beginning and end of structs.</p>
+
+<p>For example, a struct with an &#34;fruit&#34; key whose value is &#34;oranges&#34;, and a &#34;vegetable&#34; key whose value is &#34;lettuce&#34; would look like:</p>
+
+<pre  class="code"> { fruit =&#62; &#39;oranges&#39;, vegetable =&#62; &#39;lettuce&#39; }</pre>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="How_Bugzilla_WebService_Methods_Take_Parameters"
+>How Bugzilla WebService Methods Take Parameters</a></h2>
+
+<p><b>All</b> Bugzilla WebService functions use <i>named</i> parameters. The individual <code  class="code">Bugzilla::WebService::Server</code> modules explain how this is implemented for those frontends.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="LOGGING_IN"
+>LOGGING IN</a></h1>
+
+<p>There are various ways to log in:</p>
+
+<dl>
+<dt><a name="User.login"
+><code  class="code">User.login</code></a></dt>
+
+<dd>
+<p>You can use <a href="../Bugzilla/WebService/User.html#login" class="podlinkpod"
+>&#34;login&#34; in Bugzilla::WebService::User</a> to log in as a Bugzilla user. This issues standard HTTP cookies that you must then use in future calls, so your client must be capable of receiving and transmitting cookies.</p>
+
+<dt><a name="Bugzilla_login_and_Bugzilla_password"
+><code  class="code">Bugzilla_login</code> and <code  class="code">Bugzilla_password</code></a></dt>
+
+<dd>
+<p><b>Added in Bugzilla 3.6</b></p>
+
+<p>You can specify <code  class="code">Bugzilla_login</code> and <code  class="code">Bugzilla_password</code> as arguments to any WebService method, and you will be logged in as that user if your credentials are correct. Here are the arguments you can specify to any WebService method to perform a login:</p>
+
+<dl>
+<dt><a name="Bugzilla_login_(string)_-_A_user&#39;s_login_name."
+><code  class="code">Bugzilla_login</code> (string) - A user&#39;s login name.</a></dt>
+
+<dd>
+<dt><a name="Bugzilla_password_(string)_-_That_user&#39;s_password."
+><code  class="code">Bugzilla_password</code> (string) - That user&#39;s password.</a></dt>
+
+<dd>
+<dt><a name="Bugzilla_restrictlogin_(boolean)_-_Optional._If_true,_then_your_login_will_only_be_valid_for_your_IP_address."
+><code  class="code">Bugzilla_restrictlogin</code> (boolean) - Optional. If true, then your login will only be valid for your IP address.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">Bugzilla_rememberlogin</code> (boolean) - Optional. If true, then the cookie sent back to you with the method response will not expire.</a></dt>
+</dl>
+
+<p>The <code  class="code">Bugzilla_restrictlogin</code> and <code  class="code">Bugzilla_rememberlogin</code> options are only used when you have also specified <code  class="code">Bugzilla_login</code> and <code  class="code">Bugzilla_password</code>.</p>
+
+<p>Note that Bugzilla will return HTTP cookies along with the method response when you use these arguments (just like the <code  class="code">User.login</code> method above).</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="STABLE,_EXPERIMENTAL,_and_UNSTABLE"
+>STABLE, EXPERIMENTAL, and UNSTABLE</a></h1>
+
+<p>Methods are marked <b>STABLE</b> if you can expect their parameters and return values not to change between versions of Bugzilla. You are best off always using methods marked <b>STABLE</b>. We may add parameters and additional items to the return values, but your old code will always continue to work with any new changes we make. If we ever break a <b>STABLE</b> interface, we&#39;ll post a big notice in the Release Notes, and it will only happen during a major new release.</p>
+
+<p>Methods (or parts of methods) are marked <b>EXPERIMENTAL</b> if we <i>believe</i> they will be stable, but there&#39;s a slight chance that small parts will change in the future.</p>
+
+<p>Certain parts of a method&#39;s description may be marked as <b>UNSTABLE</b>, in which case those parts are not guaranteed to stay the same between Bugzilla versions.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="ERRORS"
+>ERRORS</a></h1>
+
+<p>If a particular webservice call fails, it will throw an error in the appropriate format for the frontend that you are using. For all frontends, there is at least a numeric error code and descriptive text for the error.</p>
+
+<p>The various errors that functions can throw are specified by the documentation of those functions.</p>
+
+<p>Each error that Bugzilla can throw has a specific numeric code that will not change between versions of Bugzilla. If your code needs to know what error Bugzilla threw, use the numeric code. Don&#39;t try to parse the description, because that may change from version to version of Bugzilla.</p>
+
+<p>Note that if you display the error to the user in an HTML program, make sure that you properly escape the error, as it will not be HTML-escaped.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Transient_vs._Fatal_Errors"
+>Transient vs. Fatal Errors</a></h2>
+
+<p>If the error code is a number greater than 0, the error is considered &#34;transient,&#34; which means that it was an error made by the user, not some problem with Bugzilla itself.</p>
+
+<p>If the error code is a number less than 0, the error is &#34;fatal,&#34; which means that it&#39;s some error in Bugzilla itself that probably requires administrative attention.</p>
+
+<p>Negative numbers and positive numbers don&#39;t overlap. That is, if there&#39;s an error 302, there won&#39;t be an error -302.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Unknown_Errors"
+>Unknown Errors</a></h2>
+
+<p>Sometimes a function will throw an error that doesn&#39;t have a specific error code. In this case, the code will be <code  class="code">-32000</code> if it&#39;s a &#34;fatal&#34; error, and <code  class="code">32000</code> if it&#39;s a &#34;transient&#34; error.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="COMMON_PARAMETERS"
+>COMMON PARAMETERS</a></h1>
+
+<p>Many Webservice methods take similar arguments. Instead of re-writing the documentation for each method, we document the parameters here, once, and then refer back to this documentation from the individual methods where these parameters are used.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Limiting_What_Fields_Are_Returned"
+>Limiting What Fields Are Returned</a></h2>
+
+<p>Many WebService methods return an array of structs with various fields in the structs. (For example, <a href="../Bugzilla/WebService/Bug.html#get" class="podlinkpod"
+>&#34;get&#34; in Bugzilla::WebService::Bug</a> returns a list of <code  class="code">bugs</code> that have fields like <code  class="code">id</code>, <code  class="code">summary</code>, <code  class="code">creation_time</code>, etc.)</p>
+
+<p>These parameters allow you to limit what fields are present in the structs, to possibly improve performance or save some bandwidth.</p>
+
+<dl>
+<dt><a name="include_fields"
+><code  class="code">include_fields</code></a></dt>
+
+<dd>
+<p><code  class="code">array</code> An array of strings, representing the (case-sensitive) names of fields in the return value. Only the fields specified in this hash will be returned, the rest will not be included.</p>
+
+<p>If you specify an empty array, then this function will return empty hashes.</p>
+
+<p>Invalid field names are ignored.</p>
+
+<p>Example:</p>
+
+<pre  class="code">  User.get( ids =&#62; [1], include_fields =&#62; [&#39;id&#39;, &#39;name&#39;] )</pre>
+
+<p>would return something like:</p>
+
+<pre  class="code">  { users =&#62; [{ id =&#62; 1, name =&#62; &#39;user@domain.com&#39; }] }</pre>
+
+<dt><a name="exclude_fields"
+><code  class="code">exclude_fields</code></a></dt>
+
+<dd>
+<p><code  class="code">array</code> An array of strings, representing the (case-sensitive) names of fields in the return value. The fields specified will not be included in the returned hashes.</p>
+
+<p>If you specify all the fields, then this function will return empty hashes.</p>
+
+<p>Some RPC calls support specifying sub fields. If an RPC call states that it support sub field restrictions, you can restrict what information is returned within the first field. For example, if you call Products.get with an include_fields of components.name, then only the component name would be returned (and nothing else). You can include the main field, and exclude a sub field.</p>
+
+<p>Invalid field names are ignored.</p>
+
+<p>Specifying fields here overrides <code  class="code">include_fields</code>, so if you specify a field in both, it will be excluded, not included.</p>
+
+<p>Example:</p>
+
+<pre  class="code">  User.get( ids =&#62; [1], exclude_fields =&#62; [&#39;name&#39;] )</pre>
+
+<p>would return something like:</p>
+
+<pre  class="code">  { users =&#62; [{ id =&#62; 1, real_name =&#62; &#39;John Smith&#39; }] }</pre>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SEE_ALSO"
+>SEE ALSO</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Server_Types"
+>Server Types</a></h2>
+
+<dl>
+<dt><a name="Bugzilla::WebService::Server::XMLRPC"
+><a href="../Bugzilla/WebService/Server/XMLRPC.html" class="podlinkpod"
+>Bugzilla::WebService::Server::XMLRPC</a></a></dt>
+
+<dd>
+<dt><a name="Bugzilla::WebService::Server::JSONRPC"
+><a href="../Bugzilla/WebService/Server/JSONRPC.html" class="podlinkpod"
+>Bugzilla::WebService::Server::JSONRPC</a></a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="WebService_Modules"
+>WebService Modules</a></h2>
+
+<dl>
+<dt><a name="Bugzilla::WebService::Bug"
+><a href="../Bugzilla/WebService/Bug.html" class="podlinkpod"
+>Bugzilla::WebService::Bug</a></a></dt>
+
+<dd>
+<dt><a name="Bugzilla::WebService::Bugzilla"
+><a href="../Bugzilla/WebService/Bugzilla.html" class="podlinkpod"
+>Bugzilla::WebService::Bugzilla</a></a></dt>
+
+<dd>
+<dt><a name="Bugzilla::WebService::Classification"
+><a href="../Bugzilla/WebService/Classification.html" class="podlinkpod"
+>Bugzilla::WebService::Classification</a></a></dt>
+
+<dd>
+<dt><a name="Bugzilla::WebService::Group"
+><a href="../Bugzilla/WebService/Group.html" class="podlinkpod"
+>Bugzilla::WebService::Group</a></a></dt>
+
+<dd>
+<dt><a name="Bugzilla::WebService::Product"
+><a href="../Bugzilla/WebService/Product.html" class="podlinkpod"
+>Bugzilla::WebService::Product</a></a></dt>
+
+<dd>
+<dt><a name="Bugzilla::WebService::User"
+><a href="../Bugzilla/WebService/User.html" class="podlinkpod"
+>Bugzilla::WebService::User</a></a></dt>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/WebService/Bug.html b/docs/en/html/api/Bugzilla/WebService/Bug.html
new file mode 100644 (file)
index 0000000..e06987e
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/WebService/Bug.html
@@ -0,0 +1,2840 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Webservice::Bug</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Webservice::Bug</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <li class='indexItem indexItem1'><a href='#Utility_Functions'>Utility Functions</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#fields'>fields</a>
+    <li class='indexItem indexItem2'><a href='#legal_values'>legal_values</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#Bug_Information'>Bug Information</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#attachments'>attachments</a>
+    <li class='indexItem indexItem2'><a href='#comments'>comments</a>
+    <li class='indexItem indexItem2'><a href='#get'>get</a>
+    <li class='indexItem indexItem2'><a href='#history'>history</a>
+    <li class='indexItem indexItem2'><a href='#search'>search</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#Bug_Creation_and_Modification'>Bug Creation and Modification</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#create'>create</a>
+    <li class='indexItem indexItem2'><a href='#add_attachment'>add_attachment</a>
+    <li class='indexItem indexItem2'><a href='#add_comment'>add_comment</a>
+    <li class='indexItem indexItem2'><a href='#update'>update</a>
+    <li class='indexItem indexItem2'><a href='#update_see_also'>update_see_also</a>
+    <li class='indexItem indexItem2'><a href='#update_tags'>update_tags</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Webservice::Bug - The API for creating,
+changing,
+and getting the details of bugs.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This part of the Bugzilla API allows you to file a new bug in Bugzilla,
+or get information about bugs that have already been filed.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<p>See <a href="../../Bugzilla/WebService.html" class="podlinkpod"
+>Bugzilla::WebService</a> for a description of how parameters are passed,
+and what <b>STABLE</b>,
+<b>UNSTABLE</b>,
+and <b>EXPERIMENTAL</b> mean.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="Utility_Functions"
+>Utility Functions</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="fields"
+>fields</a></h2>
+
+<p><b>UNSTABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Get information about valid bug fields,
+including the lists of legal values for each field.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p>You can pass either field ids or field names.</p>
+
+<p><b>Note</b>: If neither <code  class="code">ids</code> nor <code  class="code">names</code> is specified,
+then all non-obsolete fields will be returned.</p>
+
+<p>In addition to the parameters below,
+this method also accepts the standard <a href="../../Bugzilla/WebService.html#include_fields" class="podlinkpod"
+>include_fields</a> and <a href="../../Bugzilla/WebService.html#exclude_fields" class="podlinkpod"
+>exclude_fields</a> arguments.</p>
+
+<dl>
+<dt><a name="ids_(array)_-_An_array_of_integer_field_ids."
+><code  class="code">ids</code> (array) - An array of integer field ids.</a></dt>
+
+<dd>
+<dt><a name="names_(array)_-_An_array_of_strings_representing_field_names."
+><code  class="code">names</code> (array) - An array of strings representing field names.</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hash containing a single element,
+<code  class="code">fields</code>.
+This is an array of hashes,
+containing the following keys:</p>
+
+<dl>
+<dt><a name="id"
+><code  class="code">id</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> An integer id uniquely identifying this field in this installation only.</p>
+
+<dt><a name="type"
+><code  class="code">type</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The number of the fieldtype.
+The following values are defined:</p>
+
+<dl>
+<dt><a name="0_Unknown"
+><code  class="code">0</code> Unknown</a></dt>
+
+<dd>
+<dt><a name="1_Free_Text"
+><code  class="code">1</code> Free Text</a></dt>
+
+<dd>
+<dt><a name="2_Drop_Down"
+><code  class="code">2</code> Drop Down</a></dt>
+
+<dd>
+<dt><a name="3_Multiple-Selection_Box"
+><code  class="code">3</code> Multiple-Selection Box</a></dt>
+
+<dd>
+<dt><a name="4_Large_Text_Box"
+><code  class="code">4</code> Large Text Box</a></dt>
+
+<dd>
+<dt><a name="5_Date/Time"
+><code  class="code">5</code> Date/Time</a></dt>
+
+<dd>
+<dt><a name="6_Bug_Id"
+><code  class="code">6</code> Bug Id</a></dt>
+
+<dd>
+<dt><a name="7_Bug_URLs_(&#34;See_Also&#34;)"
+><code  class="code">7</code> Bug URLs (&#34;See Also&#34;)</a></dt>
+</dl>
+
+<dt><a name="is_custom"
+><code  class="code">is_custom</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> True when this is a custom field,
+false otherwise.</p>
+
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The internal name of this field.
+This is a unique identifier for this field.
+If this is not a custom field,
+then this name will be the same across all Bugzilla installations.</p>
+
+<dt><a name="display_name"
+><code  class="code">display_name</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the field,
+as it is shown in the user interface.</p>
+
+<dt><a name="is_mandatory"
+><code  class="code">is_mandatory</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> True if the field must have a value when filing new bugs.
+Also,
+mandatory fields cannot have their value cleared when updating bugs.</p>
+
+<dt><a name="is_on_bug_entry"
+><code  class="code">is_on_bug_entry</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> For custom fields,
+this is true if the field is shown when you enter a new bug.
+For standard fields,
+this is currently always false,
+even if the field shows up when entering a bug.
+(To know whether or not a standard field is valid on bug entry,
+see <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a>.)</p>
+
+<dt><a name="visibility_field"
+><code  class="code">visibility_field</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of a field that controls the visibility of this field in the user interface.
+This field only appears in the user interface when the named field is equal to one of the values in <code  class="code">visibility_values</code>.
+Can be null.</p>
+
+<dt><a name="visibility_values"
+><code  class="code">visibility_values</code></a></dt>
+
+<dd>
+<p><code  class="code">array</code> of <code  class="code">string</code>s This field is only shown when <code  class="code">visibility_field</code> matches one of these values.
+When <code  class="code">visibility_field</code> is null,
+then this is an empty array.</p>
+
+<dt><a name="value_field"
+><code  class="code">value_field</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the field that controls whether or not particular values of the field are shown in the user interface.
+Can be null.</p>
+
+<dt><a name="values"
+><code  class="code">values</code></a></dt>
+
+<dd>
+<p>This is an array of hashes,
+representing the legal values for select-type (drop-down and multiple-selection) fields.
+This is also populated for the <code  class="code">component</code>,
+<code  class="code">version</code>,
+<code  class="code">target_milestone</code>,
+and <code  class="code">keywords</code> fields,
+but not for the <code  class="code">product</code> field (you must use <a href="../../Bugzilla/WebService/Product.html#get_accessible_products" class="podlinkpod"
+>Product.get_accessible_products</a> for that.</p>
+
+<p>For fields that aren&#39;t select-type fields,
+this will simply be an empty array.</p>
+
+<p>Each hash has the following keys:</p>
+
+<dl>
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The actual value--this is what you would specify for this field in <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a>,
+etc.</p>
+
+<dt><a name="sort_key"
+><code  class="code">sort_key</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> Values,
+when displayed in a list,
+are sorted first by this integer and then secondly by their name.</p>
+
+<dt><a name="sortkey"
+><code  class="code">sortkey</code></a></dt>
+
+<dd>
+<p><b>DEPRECATED</b> - Use <code  class="code">sort_key</code> instead.</p>
+
+<dt><a name="visibility_values"
+><code  class="code">visibility_values</code></a></dt>
+
+<dd>
+<p>If <code  class="code">value_field</code> is defined for this field,
+then this value is only shown if the <code  class="code">value_field</code> is set to one of the values listed in this array.
+Note that for per-product fields,
+<code  class="code">value_field</code> is set to <code  class="code">&#39;product&#39;</code> and <code  class="code">visibility_values</code> will reflect which product(s) this value appears in.</p>
+
+<dt><a name="is_active"
+><code  class="code">is_active</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> This value is defined only for certain product specific fields such as version,
+target_milestone or component.
+When true,
+the value is active,
+otherwise the value is not active.</p>
+
+<dt><a name="description"
+><code  class="code">description</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The description of the value.
+This item is only included for the <code  class="code">keywords</code> field.</p>
+
+<dt><a name="is_open"
+><code  class="code">is_open</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> For <code  class="code">bug_status</code> values,
+determines whether this status specifies that the bug is &#34;open&#34; (true) or &#34;closed&#34; (false).
+This item is only included for the <code  class="code">bug_status</code> field.</p>
+
+<dt><a name="can_change_to"
+><code  class="code">can_change_to</code></a></dt>
+
+<dd>
+<p>For <code  class="code">bug_status</code> values,
+this is an array of hashes that determines which statuses you can transition to from this status.
+(This item is only included for the <code  class="code">bug_status</code> field.)</p>
+
+<p>Each hash contains the following items:</p>
+
+<dl>
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p>the name of the new status</p>
+
+<dt><a name="comment_required"
+><code  class="code">comment_required</code></a></dt>
+
+<dd>
+<p>this <code  class="code">boolean</code> True if a comment is required when you change a bug into this status using this transition.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="51_(Invalid_Field_Name_or_Id)"
+>51 (Invalid Field Name or Id)</a></dt>
+
+<dd>
+<p>You specified an invalid field name or id.</p>
+</dd>
+</dl>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Added_in_Bugzilla_3.6."
+>Added in Bugzilla <b>3.6</b>.</a></dt>
+
+<dd>
+<dt><a name="The_is_mandatory_return_value_was_added_in_Bugzilla_4.0."
+>The <code  class="code">is_mandatory</code> return value was added in Bugzilla <b>4.0</b>.</a></dt>
+
+<dd>
+<dt><a name="sortkey_was_renamed_to_sort_key_in_Bugzilla_4.2."
+><code  class="code">sortkey</code> was renamed to <code  class="code">sort_key</code> in Bugzilla <b>4.2</b>.</a></dt>
+
+<dd>
+<dt><a name="is_active_return_key_for_values_was_added_in_Bugzilla_4.4."
+><code  class="code">is_active</code> return key for <code  class="code">values</code> was added in Bugzilla <b>4.4</b>.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="legal_values"
+>legal_values</a></h2>
+
+<p><b>DEPRECATED</b> - Use <a href="#fields" class="podlinkpod"
+>&#34;fields&#34;</a> instead.</p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Tells you what values are allowed for a particular field.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a 
+><code  class="code">field</code> - The name of the field you want information about.
+This should be the same as the name you would use in <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a>,
+below.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">product_id</code> - If you&#39;re picking a product-specific field,
+you have to specify the id of the product you want the values for.</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p><code  class="code">values</code> - An array of strings: the legal values for this field.
+The values will be sorted as they normally would be in Bugzilla.</p>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="106_(Invalid_Product)"
+>106 (Invalid Product)</a></dt>
+
+<dd>
+<p>You were required to specify a product,
+and either you didn&#39;t,
+or you specified an invalid product (or a product that you can&#39;t access).</p>
+
+<dt><a name="108_(Invalid_Field_Name)"
+>108 (Invalid Field Name)</a></dt>
+
+<dd>
+<p>You specified a field that doesn&#39;t exist or isn&#39;t a drop-down field.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="Bug_Information"
+>Bug Information</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="attachments"
+>attachments</a></h2>
+
+<p><b>EXPERIMENTAL</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>It allows you to get data about attachments,
+given a list of bugs and/or attachment ids.</p>
+
+<p><b>Note</b>: Private attachments will only be returned if you are in the insidergroup or if you are the submitter of the attachment.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p><b>Note</b>: At least one of <code  class="code">ids</code> or <code  class="code">attachment_ids</code> is required.</p>
+
+<dl>
+<dt><a name="ids"
+><code  class="code">ids</code></a></dt>
+
+<dd>
+<p>See the description of the <code  class="code">ids</code> parameter in the <a href="#get" class="podlinkpod"
+>&#34;get&#34;</a> method.</p>
+
+<dt><a name="attachment_ids"
+><code  class="code">attachment_ids</code></a></dt>
+
+<dd>
+<p><code  class="code">array</code> An array of integer attachment ids.</p>
+</dd>
+</dl>
+
+<p>Also accepts the <a href="../../Bugzilla/WebService.html#include_fields" class="podlinkpod"
+>include_fields</a>,
+and <a href="../../Bugzilla/WebService.html#exclude_fields" class="podlinkpod"
+>exclude_fields</a> arguments.</p>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hash containing two elements: <code  class="code">bugs</code> and <code  class="code">attachments</code>.
+The return value looks like this:</p>
+
+<pre  class="code"> {
+     bugs =&#62; {
+         1345 =&#62; [
+             { (attachment) },
+             { (attachment) }
+         ],
+         9874 =&#62; [
+             { (attachment) },
+             { (attachment) }
+         ],
+     },
+
+     attachments =&#62; {
+         234 =&#62; { (attachment) },
+         123 =&#62; { (attachment) },
+     }
+ }</pre>
+
+<p>The attachments of any bugs that you specified in the <code  class="code">ids</code> argument in input are returned in <code  class="code">bugs</code> on output. <code  class="code">bugs</code> is a hash that has integer bug IDs for keys and the values are arrayrefs that contain hashes as attachments. (Fields for attachments are described below.)</p>
+
+<p>For any attachments that you specified directly in <code  class="code">attachment_ids</code>, they are returned in <code  class="code">attachments</code> on output. This is a hash where the attachment ids point directly to hashes describing the individual attachment.</p>
+
+<p>The fields for each attachment (where it says <code  class="code">(attachment)</code> in the diagram above) are:</p>
+
+<dl>
+<dt><a name="data"
+><code  class="code">data</code></a></dt>
+
+<dd>
+<p><code  class="code">base64</code> The raw data of the attachment, encoded as Base64.</p>
+
+<dt><a name="size"
+><code  class="code">size</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The length (in bytes) of the attachment.</p>
+
+<dt><a name="creation_time"
+><code  class="code">creation_time</code></a></dt>
+
+<dd>
+<p><code  class="code">dateTime</code> The time the attachment was created.</p>
+
+<dt><a name="last_change_time"
+><code  class="code">last_change_time</code></a></dt>
+
+<dd>
+<p><code  class="code">dateTime</code> The last time the attachment was modified.</p>
+
+<dt><a name="id"
+><code  class="code">id</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The numeric id of the attachment.</p>
+
+<dt><a name="bug_id"
+><code  class="code">bug_id</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The numeric id of the bug that the attachment is attached to.</p>
+
+<dt><a name="file_name"
+><code  class="code">file_name</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The file name of the attachment.</p>
+
+<dt><a name="summary"
+><code  class="code">summary</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> A short string describing the attachment.</p>
+
+<p>Also returned as <code  class="code">description</code>, for backwards-compatibility with older Bugzillas. (However, this backwards-compatibility will go away in Bugzilla 5.0.)</p>
+
+<dt><a name="content_type"
+><code  class="code">content_type</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The MIME type of the attachment.</p>
+
+<dt><a name="is_private"
+><code  class="code">is_private</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> True if the attachment is private (only visible to a certain group called the &#34;insidergroup&#34;), False otherwise.</p>
+
+<dt><a name="is_obsolete"
+><code  class="code">is_obsolete</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> True if the attachment is obsolete, False otherwise.</p>
+
+<dt><a name="is_patch"
+><code  class="code">is_patch</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> True if the attachment is a patch, False otherwise.</p>
+
+<dt><a name="creator"
+><code  class="code">creator</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The login name of the user that created the attachment.</p>
+
+<p>Also returned as <code  class="code">attacher</code>, for backwards-compatibility with older Bugzillas. (However, this backwards-compatibility will go away in Bugzilla 5.0.)</p>
+
+<dt><a name="flags"
+><code  class="code">flags</code></a></dt>
+
+<dd>
+<p>An array of hashes containing the information about flags currently set for each attachment. Each flag hash contains the following items:</p>
+
+<dl>
+<dt><a name="id"
+><code  class="code">id</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The id of the flag.</p>
+
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the flag.</p>
+
+<dt><a name="type_id"
+><code  class="code">type_id</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The type id of the flag.</p>
+
+<dt><a name="creation_date"
+><code  class="code">creation_date</code></a></dt>
+
+<dd>
+<p><code  class="code">dateTime</code> The timestamp when this flag was originally created.</p>
+
+<dt><a name="modification_date"
+><code  class="code">modification_date</code></a></dt>
+
+<dd>
+<p><code  class="code">dateTime</code> The timestamp when the flag was last modified.</p>
+
+<dt><a name="status"
+><code  class="code">status</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The current status of the flag.</p>
+
+<dt><a name="setter"
+><code  class="code">setter</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The login name of the user who created or last modified the flag.</p>
+
+<dt><a name="requestee"
+><code  class="code">requestee</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The login name of the user this flag has been requested to be granted or denied. Note, this field is only returned if a requestee is set.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<p>This method can throw all the same errors as <a href="#get" class="podlinkpod"
+>&#34;get&#34;</a>. In addition, it can also throw the following error:</p>
+
+<dl>
+<dt><a name="304_(Auth_Failure,_Attachment_is_Private)"
+>304 (Auth Failure, Attachment is Private)</a></dt>
+
+<dd>
+<p>You specified the id of a private attachment in the <code  class="code">attachment_ids</code> argument, and you are not in the &#34;insider group&#34; that can see private attachments.</p>
+</dd>
+</dl>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Added_in_Bugzilla_3.6."
+>Added in Bugzilla <b>3.6</b>.</a></dt>
+
+<dd>
+<dt><a name="In_Bugzilla_4.0,_the_attacher_return_value_was_renamed_to_creator."
+>In Bugzilla <b>4.0</b>, the <code  class="code">attacher</code> return value was renamed to <code  class="code">creator</code>.</a></dt>
+
+<dd>
+<dt><a name="In_Bugzilla_4.0,_the_description_return_value_was_renamed_to_summary."
+>In Bugzilla <b>4.0</b>, the <code  class="code">description</code> return value was renamed to <code  class="code">summary</code>.</a></dt>
+
+<dd>
+<dt><a name="The_data_return_value_was_added_in_Bugzilla_4.0."
+>The <code  class="code">data</code> return value was added in Bugzilla <b>4.0</b>.</a></dt>
+
+<dd>
+<dt><a name="In_Bugzilla_4.2,_the_is_url_return_value_was_removed_(this_attribute_no_longer_exists_for_attachments)."
+>In Bugzilla <b>4.2</b>, the <code  class="code">is_url</code> return value was removed (this attribute no longer exists for attachments).</a></dt>
+
+<dd>
+<dt><a name="The_size_return_value_was_added_in_Bugzilla_4.4."
+>The <code  class="code">size</code> return value was added in Bugzilla <b>4.4</b>.</a></dt>
+
+<dd>
+<dt><a name="The_flags_array_was_added_in_Bugzilla_4.4."
+>The <code  class="code">flags</code> array was added in Bugzilla <b>4.4</b>.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="comments"
+>comments</a></h2>
+
+<p><b>STABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>This allows you to get data about comments, given a list of bugs and/or comment ids.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p><b>Note</b>: At least one of <code  class="code">ids</code> or <code  class="code">comment_ids</code> is required.</p>
+
+<p>In addition to the parameters below, this method also accepts the standard <a href="../../Bugzilla/WebService.html#include_fields" class="podlinkpod"
+>include_fields</a> and <a href="../../Bugzilla/WebService.html#exclude_fields" class="podlinkpod"
+>exclude_fields</a> arguments.</p>
+
+<dl>
+<dt><a name="ids"
+><code  class="code">ids</code></a></dt>
+
+<dd>
+<p><code  class="code">array</code> An array that can contain both bug IDs and bug aliases. All of the comments (that are visible to you) will be returned for the specified bugs.</p>
+
+<dt><a name="comment_ids"
+><code  class="code">comment_ids</code></a></dt>
+
+<dd>
+<p><code  class="code">array</code> An array of integer comment_ids. These comments will be returned individually, separate from any other comments in their respective bugs.</p>
+
+<dt><a name="new_since"
+><code  class="code">new_since</code></a></dt>
+
+<dd>
+<p><code  class="code">dateTime</code> If specified, the method will only return comments <i>newer</i> than this time. This only affects comments returned from the <code  class="code">ids</code> argument. You will always be returned all comments you request in the <code  class="code">comment_ids</code> argument, even if they are older than this date.</p>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>Two items are returned:</p>
+
+<dl>
+<dt><a name="bugs"
+><code  class="code">bugs</code></a></dt>
+
+<dd>
+<p>This is used for bugs specified in <code  class="code">ids</code>. This is a hash, where the keys are the numeric ids of the bugs, and the value is a hash with a single key, <code  class="code">comments</code>, which is an array of comments. (The format of comments is described below.)</p>
+
+<p>Note that any individual bug will only be returned once, so if you specify an id multiple times in <code  class="code">ids</code>, it will still only be returned once.</p>
+
+<dt><a name="comments"
+><code  class="code">comments</code></a></dt>
+
+<dd>
+<p>Each individual comment requested in <code  class="code">comment_ids</code> is returned here, in a hash where the numeric comment id is the key, and the value is the comment. (The format of comments is described below.)</p>
+</dd>
+</dl>
+
+<p>A &#34;comment&#34; as described above is a hash that contains the following keys:</p>
+
+<dl>
+<dt><a name="id"
+>id</a></dt>
+
+<dd>
+<p><code  class="code">int</code> The globally unique ID for the comment.</p>
+
+<dt><a name="bug_id"
+>bug_id</a></dt>
+
+<dd>
+<p><code  class="code">int</code> The ID of the bug that this comment is on.</p>
+
+<dt><a name="attachment_id"
+>attachment_id</a></dt>
+
+<dd>
+<p><code  class="code">int</code> If the comment was made on an attachment, this will be the ID of that attachment. Otherwise it will be null.</p>
+
+<dt><a name="count"
+>count</a></dt>
+
+<dd>
+<p><code  class="code">int</code> The number of the comment local to the bug. The Description is 0, comments start with 1.</p>
+
+<dt><a name="text"
+>text</a></dt>
+
+<dd>
+<p><code  class="code">string</code> The actual text of the comment.</p>
+
+<dt><a name="creator"
+>creator</a></dt>
+
+<dd>
+<p><code  class="code">string</code> The login name of the comment&#39;s author.</p>
+
+<p>Also returned as <code  class="code">author</code>, for backwards-compatibility with older Bugzillas. (However, this backwards-compatibility will go away in Bugzilla 5.0.)</p>
+
+<dt><a name="time"
+>time</a></dt>
+
+<dd>
+<p><code  class="code">dateTime</code> The time (in Bugzilla&#39;s timezone) that the comment was added.</p>
+
+<dt><a name="creation_time"
+>creation_time</a></dt>
+
+<dd>
+<p><code  class="code">dateTime</code> This is exactly same as the <code  class="code">time</code> key. Use this field instead of <code  class="code">time</code> for consistency with other methods including <a href="#get" class="podlinkpod"
+>&#34;get&#34;</a> and <a href="#attachments" class="podlinkpod"
+>&#34;attachments&#34;</a>. For compatibility, <code  class="code">time</code> is still usable. However, please note that <code  class="code">time</code> may be deprecated and removed in a future release.</p>
+
+<dt><a name="is_private"
+>is_private</a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> True if this comment is private (only visible to a certain group called the &#34;insidergroup&#34;), False otherwise.</p>
+</dd>
+</dl>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<p>This method can throw all the same errors as <a href="#get" class="podlinkpod"
+>&#34;get&#34;</a>. In addition, it can also throw the following errors:</p>
+
+<dl>
+<dt><a name="110_(Comment_Is_Private)"
+>110 (Comment Is Private)</a></dt>
+
+<dd>
+<p>You specified the id of a private comment in the <code  class="code">comment_ids</code> argument, and you are not in the &#34;insider group&#34; that can see private comments.</p>
+
+<dt><a name="111_(Invalid_Comment_ID)"
+>111 (Invalid Comment ID)</a></dt>
+
+<dd>
+<p>You specified an id in the <code  class="code">comment_ids</code> argument that is invalid--either you specified something that wasn&#39;t a number, or there is no comment with that id.</p>
+</dd>
+</dl>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Added_in_Bugzilla_3.4."
+>Added in Bugzilla <b>3.4</b>.</a></dt>
+
+<dd>
+<dt><a name="attachment_id_was_added_to_the_return_value_in_Bugzilla_3.6."
+><code  class="code">attachment_id</code> was added to the return value in Bugzilla <b>3.6</b>.</a></dt>
+
+<dd>
+<dt><a name="In_Bugzilla_4.0,_the_author_return_value_was_renamed_to_creator."
+>In Bugzilla <b>4.0</b>, the <code  class="code">author</code> return value was renamed to <code  class="code">creator</code>.</a></dt>
+
+<dd>
+<dt><a name="count_was_added_to_the_return_value_in_Bugzilla_4.4."
+><code  class="code">count</code> was added to the return value in Bugzilla <b>4.4</b>.</a></dt>
+
+<dd>
+<dt><a name="creation_time_was_added_in_Bugzilla_4.4."
+><code  class="code">creation_time</code> was added in Bugzilla <b>4.4</b>.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="get"
+>get</a></h2>
+
+<p><b>STABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Gets information about particular bugs in the database.</p>
+
+<p>Note: Can also be called as &#34;get_bugs&#34; for compatibilty with Bugzilla 3.0 API.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p>In addition to the parameters below, this method also accepts the standard <a href="../../Bugzilla/WebService.html#include_fields" class="podlinkpod"
+>include_fields</a> and <a href="../../Bugzilla/WebService.html#exclude_fields" class="podlinkpod"
+>exclude_fields</a> arguments.</p>
+
+<dl>
+<dt><a name="ids"
+><code  class="code">ids</code></a></dt>
+
+<dd>
+<p>An array of numbers and strings.</p>
+
+<p>If an element in the array is entirely numeric, it represents a bug_id from the Bugzilla database to fetch. If it contains any non-numeric characters, it is considered to be a bug alias instead, and the bug with that alias will be loaded.</p>
+
+<dt><a name="permissive_EXPERIMENTAL"
+><code  class="code">permissive</code> <b>EXPERIMENTAL</b></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> Normally, if you request any inaccessible or invalid bug ids, Bug.get will throw an error. If this parameter is True, instead of throwing an error we return an array of hashes with a <code  class="code">id</code>, <code  class="code">faultString</code> and <code  class="code">faultCode</code> for each bug that fails, and return normal information for the other bugs that were accessible.</p>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>Two items are returned:</p>
+
+<dl>
+<dt><a name="bugs"
+><code  class="code">bugs</code></a></dt>
+
+<dd>
+<p>An array of hashes that contains information about the bugs with the valid ids. Each hash contains the following items:</p>
+
+<dl>
+<dt><a name="actual_time"
+><code  class="code">actual_time</code></a></dt>
+
+<dd>
+<p><code  class="code">double</code> The total number of hours that this bug has taken (so far).</p>
+
+<p>If you are not in the time-tracking group, this field will not be included in the return value.</p>
+
+<dt><a name="alias"
+><code  class="code">alias</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The unique alias of this bug.</p>
+
+<dt><a name="assigned_to"
+><code  class="code">assigned_to</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The login name of the user to whom the bug is assigned.</p>
+
+<dt><a name="blocks"
+><code  class="code">blocks</code></a></dt>
+
+<dd>
+<p><code  class="code">array</code> of <code  class="code">int</code>s. The ids of bugs that are &#34;blocked&#34; by this bug.</p>
+
+<dt><a name="cc"
+><code  class="code">cc</code></a></dt>
+
+<dd>
+<p><code  class="code">array</code> of <code  class="code">string</code>s. The login names of users on the CC list of this bug.</p>
+
+<dt><a name="classification"
+><code  class="code">classification</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the current classification the bug is in.</p>
+
+<dt><a name="component"
+><code  class="code">component</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the current component of this bug.</p>
+
+<dt><a name="creation_time"
+><code  class="code">creation_time</code></a></dt>
+
+<dd>
+<p><code  class="code">dateTime</code> When the bug was created.</p>
+
+<dt><a name="creator"
+><code  class="code">creator</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The login name of the person who filed this bug (the reporter).</p>
+
+<dt><a name="deadline"
+><code  class="code">deadline</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The day that this bug is due to be completed, in the format <code  class="code">YYYY-MM-DD</code>.</p>
+
+<p>If you are not in the time-tracking group, this field will not be included in the return value.</p>
+
+<dt><a name="depends_on"
+><code  class="code">depends_on</code></a></dt>
+
+<dd>
+<p><code  class="code">array</code> of <code  class="code">int</code>s. The ids of bugs that this bug &#34;depends on&#34;.</p>
+
+<dt><a name="dupe_of"
+><code  class="code">dupe_of</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The bug ID of the bug that this bug is a duplicate of. If this bug isn&#39;t a duplicate of any bug, this will be null.</p>
+
+<dt><a name="estimated_time"
+><code  class="code">estimated_time</code></a></dt>
+
+<dd>
+<p><code  class="code">double</code> The number of hours that it was estimated that this bug would take.</p>
+
+<p>If you are not in the time-tracking group, this field will not be included in the return value.</p>
+
+<dt><a name="flags"
+><code  class="code">flags</code></a></dt>
+
+<dd>
+<p>An array of hashes containing the information about flags currently set for the bug. Each flag hash contains the following items:</p>
+
+<dl>
+<dt><a name="id"
+><code  class="code">id</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The id of the flag.</p>
+
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the flag.</p>
+
+<dt><a name="type_id"
+><code  class="code">type_id</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The type id of the flag.</p>
+
+<dt><a name="creation_date"
+><code  class="code">creation_date</code></a></dt>
+
+<dd>
+<p><code  class="code">dateTime</code> The timestamp when this flag was originally created.</p>
+
+<dt><a name="modification_date"
+><code  class="code">modification_date</code></a></dt>
+
+<dd>
+<p><code  class="code">dateTime</code> The timestamp when the flag was last modified.</p>
+
+<dt><a name="status"
+><code  class="code">status</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The current status of the flag.</p>
+
+<dt><a name="setter"
+><code  class="code">setter</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The login name of the user who created or last modified the flag.</p>
+
+<dt><a name="requestee"
+><code  class="code">requestee</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The login name of the user this flag has been requested to be granted or denied. Note, this field is only returned if a requestee is set.</p>
+</dd>
+</dl>
+
+<dt><a name="groups"
+><code  class="code">groups</code></a></dt>
+
+<dd>
+<p><code  class="code">array</code> of <code  class="code">string</code>s. The names of all the groups that this bug is in.</p>
+
+<dt><a name="id"
+><code  class="code">id</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The unique numeric id of this bug.</p>
+
+<dt><a name="is_cc_accessible"
+><code  class="code">is_cc_accessible</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> If true, this bug can be accessed by members of the CC list, even if they are not in the groups the bug is restricted to.</p>
+
+<dt><a name="is_confirmed"
+><code  class="code">is_confirmed</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> True if the bug has been confirmed. Usually this means that the bug has at some point been moved out of the <code  class="code">UNCONFIRMED</code> status and into another open status.</p>
+
+<dt><a name="is_open"
+><code  class="code">is_open</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> True if this bug is open, false if it is closed.</p>
+
+<dt><a name="is_creator_accessible"
+><code  class="code">is_creator_accessible</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> If true, this bug can be accessed by the creator (reporter) of the bug, even if he or she is not a member of the groups the bug is restricted to.</p>
+
+<dt><a name="keywords"
+><code  class="code">keywords</code></a></dt>
+
+<dd>
+<p><code  class="code">array</code> of <code  class="code">string</code>s. Each keyword that is on this bug.</p>
+
+<dt><a name="last_change_time"
+><code  class="code">last_change_time</code></a></dt>
+
+<dd>
+<p><code  class="code">dateTime</code> When the bug was last changed.</p>
+
+<dt><a name="op_sys"
+><code  class="code">op_sys</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the operating system that the bug was filed against.</p>
+
+<dt><a name="platform"
+><code  class="code">platform</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the platform (hardware) that the bug was filed against.</p>
+
+<dt><a name="priority"
+><code  class="code">priority</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The priority of the bug.</p>
+
+<dt><a name="product"
+><code  class="code">product</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the product this bug is in.</p>
+
+<dt><a name="qa_contact"
+><code  class="code">qa_contact</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The login name of the current QA Contact on the bug.</p>
+
+<dt><a name="remaining_time"
+><code  class="code">remaining_time</code></a></dt>
+
+<dd>
+<p><code  class="code">double</code> The number of hours of work remaining until work on this bug is complete.</p>
+
+<p>If you are not in the time-tracking group, this field will not be included in the return value.</p>
+
+<dt><a name="resolution"
+><code  class="code">resolution</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The current resolution of the bug, or an empty string if the bug is open.</p>
+
+<dt><a name="see_also"
+><code  class="code">see_also</code></a></dt>
+
+<dd>
+<p><b>UNSTABLE</b></p>
+
+<p><code  class="code">array</code> of <code  class="code">string</code>s. The URLs in the See Also field on the bug.</p>
+
+<dt><a name="severity"
+><code  class="code">severity</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The current severity of the bug.</p>
+
+<dt><a name="status"
+><code  class="code">status</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The current status of the bug.</p>
+
+<dt><a name="summary"
+><code  class="code">summary</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The summary of this bug.</p>
+
+<dt><a name="target_milestone"
+><code  class="code">target_milestone</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The milestone that this bug is supposed to be fixed by, or for closed bugs, the milestone that it was fixed for.</p>
+
+<dt><a name="update_token"
+><code  class="code">update_token</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The token that you would have to pass to the <em  class="code">process_bug.cgi</em> page in order to update this bug. This changes every time the bug is updated.</p>
+
+<p>This field is not returned to logged-out users.</p>
+
+<dt><a name="url"
+><code  class="code">url</code></a></dt>
+
+<dd>
+<p><b>UNSTABLE</b></p>
+
+<p><code  class="code">string</code> A URL that demonstrates the problem described in the bug, or is somehow related to the bug report.</p>
+
+<dt><a name="version"
+><code  class="code">version</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The version the bug was reported against.</p>
+
+<dt><a name="whiteboard"
+><code  class="code">whiteboard</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The value of the &#34;status whiteboard&#34; field on the bug.</p>
+
+<dt><a name="custom_fields"
+><i>custom fields</i></a></dt>
+
+<dd>
+<p>Every custom field in this installation will also be included in the return value. Most fields are returned as <code  class="code">string</code>s. However, some field types have different return values:</p>
+
+<dl>
+<dt><a name="Bug_ID_Fields_-_int"
+>Bug ID Fields - <code  class="code">int</code></a></dt>
+
+<dd>
+<dt><a name="Multiple-Selection_Fields_-_array_of_strings."
+>Multiple-Selection Fields - <code  class="code">array</code> of <code  class="code">string</code>s.</a></dt>
+
+<dd>
+<dt><a name="Date/Time_Fields_-_dateTime"
+>Date/Time Fields - <code  class="code">dateTime</code></a></dt>
+</dl>
+</dd>
+</dl>
+
+<dt><a name="faults_EXPERIMENTAL"
+><code  class="code">faults</code> <b>EXPERIMENTAL</b></a></dt>
+
+<dd>
+<p>An array of hashes that contains invalid bug ids with error messages returned for them. Each hash contains the following items:</p>
+
+<dl>
+<dt><a name="id"
+>id</a></dt>
+
+<dd>
+<p><code  class="code">int</code> The numeric bug_id of this bug.</p>
+
+<dt><a name="faultString"
+>faultString</a></dt>
+
+<dd>
+<p><code  class="code">string</code> This will only be returned for invalid bugs if the <code  class="code">permissive</code> argument was set when calling Bug.get, and it is an error indicating that the bug id was invalid.</p>
+
+<dt><a name="faultCode"
+>faultCode</a></dt>
+
+<dd>
+<p><code  class="code">int</code> This will only be returned for invalid bugs if the <code  class="code">permissive</code> argument was set when calling Bug.get, and it is the error code for the invalid bug error.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="100_(Invalid_Bug_Alias)"
+>100 (Invalid Bug Alias)</a></dt>
+
+<dd>
+<p>If you specified an alias and there is no bug with that alias.</p>
+
+<dt><a name="101_(Invalid_Bug_ID)"
+>101 (Invalid Bug ID)</a></dt>
+
+<dd>
+<p>The bug_id you specified doesn&#39;t exist in the database.</p>
+
+<dt><a name="102_(Access_Denied)"
+>102 (Access Denied)</a></dt>
+
+<dd>
+<p>You do not have access to the bug_id you specified.</p>
+</dd>
+</dl>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="permissive_argument_added_to_this_method&#39;s_params_in_Bugzilla_3.4."
+><code  class="code">permissive</code> argument added to this method&#39;s params in Bugzilla <b>3.4</b>.</a></dt>
+
+<dd>
+<dt><a name="The_following_properties_were_added_to_this_method&#39;s_return_values_in_Bugzilla_3.4:"
+>The following properties were added to this method&#39;s return values in Bugzilla <b>3.4</b>:</a></dt>
+
+<dd>
+<dl>
+<dt><a name="For_bugs"
+>For <code  class="code">bugs</code></a></dt>
+
+<dd>
+<dl>
+<dt><a name="assigned_to"
+>assigned_to</a></dt>
+
+<dd>
+<dt><a name="component"
+>component</a></dt>
+
+<dd>
+<dt><a name="dupe_of"
+>dupe_of</a></dt>
+
+<dd>
+<dt><a name="is_open"
+>is_open</a></dt>
+
+<dd>
+<dt><a name="priority"
+>priority</a></dt>
+
+<dd>
+<dt><a name="product"
+>product</a></dt>
+
+<dd>
+<dt><a name="resolution"
+>resolution</a></dt>
+
+<dd>
+<dt><a name="severity"
+>severity</a></dt>
+
+<dd>
+<dt><a name="status"
+>status</a></dt>
+</dl>
+
+<dt><a name="faults"
+><code  class="code">faults</code></a></dt>
+</dl>
+
+<dt><a 
+>In Bugzilla <b>4.0</b>, the following items were added to the <code  class="code">bugs</code> return value: <code  class="code">blocks</code>, <code  class="code">cc</code>, <code  class="code">classification</code>, <code  class="code">creator</code>, <code  class="code">deadline</code>, <code  class="code">depends_on</code>, <code  class="code">estimated_time</code>, <code  class="code">is_cc_accessible</code>, <code  class="code">is_confirmed</code>, <code  class="code">is_creator_accessible</code>, <code  class="code">groups</code>, <code  class="code">keywords</code>, <code  class="code">op_sys</code>, <code  class="code">platform</code>, <code  class="code">qa_contact</code>, <code  class="code">remaining_time</code>, <code  class="code">see_also</code>, <code  class="code">target_milestone</code>, <code  class="code">update_token</code>, <code  class="code">url</code>, <code  class="code">version</code>, <code  class="code">whiteboard</code>, and all custom fields.</a></dt>
+
+<dd>
+<dt><a name="The_flags_array_was_added_in_Bugzilla_4.4."
+>The <code  class="code">flags</code> array was added in Bugzilla <b>4.4</b>.</a></dt>
+
+<dd>
+<dt><a name="The_actual_time_item_was_added_to_the_bugs_return_value_in_Bugzilla_4.4."
+>The <code  class="code">actual_time</code> item was added to the <code  class="code">bugs</code> return value in Bugzilla <b>4.4</b>.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="history"
+>history</a></h2>
+
+<p><b>EXPERIMENTAL</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Gets the history of changes for particular bugs in the database.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="ids"
+><code  class="code">ids</code></a></dt>
+
+<dd>
+<p>An array of numbers and strings.</p>
+
+<p>If an element in the array is entirely numeric, it represents a bug_id from the Bugzilla database to fetch. If it contains any non-numeric characters, it is considered to be a bug alias instead, and the data bug with that alias will be loaded.</p>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hash containing a single element, <code  class="code">bugs</code>. This is an array of hashes, containing the following keys:</p>
+
+<dl>
+<dt><a name="id"
+>id</a></dt>
+
+<dd>
+<p><code  class="code">int</code> The numeric id of the bug.</p>
+
+<dt><a name="alias"
+>alias</a></dt>
+
+<dd>
+<p><code  class="code">string</code> The alias of this bug. If there is no alias, this will be undef.</p>
+
+<dt><a name="history"
+>history</a></dt>
+
+<dd>
+<p><code  class="code">array</code> An array of hashes, each hash having the following keys:</p>
+
+<dl>
+<dt><a name="when"
+>when</a></dt>
+
+<dd>
+<p><code  class="code">dateTime</code> The date the bug activity/change happened.</p>
+
+<dt><a name="who"
+>who</a></dt>
+
+<dd>
+<p><code  class="code">string</code> The login name of the user who performed the bug change.</p>
+
+<dt><a name="changes"
+>changes</a></dt>
+
+<dd>
+<p><code  class="code">array</code> An array of hashes which contain all the changes that happened to the bug at this time (as specified by <code  class="code">when</code>). Each hash contains the following items:</p>
+
+<dl>
+<dt><a name="field_name"
+>field_name</a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the bug field that has changed.</p>
+
+<dt><a name="removed"
+>removed</a></dt>
+
+<dd>
+<p><code  class="code">string</code> The previous value of the bug field which has been deleted by the change.</p>
+
+<dt><a name="added"
+>added</a></dt>
+
+<dd>
+<p><code  class="code">string</code> The new value of the bug field which has been added by the change.</p>
+
+<dt><a name="attachment_id"
+>attachment_id</a></dt>
+
+<dd>
+<p><code  class="code">int</code> The id of the attachment that was changed. This only appears if the change was to an attachment, otherwise <code  class="code">attachment_id</code> will not be present in this hash.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<p>The same as <a href="#get" class="podlinkpod"
+>&#34;get&#34;</a>.</p>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Added_in_Bugzilla_3.4."
+>Added in Bugzilla <b>3.4</b>.</a></dt>
+
+<dd>
+<dt><a 
+>Field names returned by the <code  class="code">field_name</code> field changed to be consistent with other methods. Since Bugzilla <b>4.4</b>, they now match names used by <a href="#update" class="podlinkpod"
+>Bug.update</a> for consistency.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="search"
+>search</a></h2>
+
+<p><b>UNSTABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Allows you to search for bugs based on particular criteria.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p>Unless otherwise specified in the description of a parameter, bugs are returned if they match <i>exactly</i> the criteria you specify in these parameters. That is, we don&#39;t match against substrings--if a bug is in the &#34;Widgets&#34; product and you ask for bugs in the &#34;Widg&#34; product, you won&#39;t get anything.</p>
+
+<p>Criteria are joined in a logical AND. That is, you will be returned bugs that match <i>all</i> of the criteria, not bugs that match <i>any</i> of the criteria.</p>
+
+<p>Each parameter can be either the type it says, or an array of the types it says. If you pass an array, it means &#34;Give me bugs with <i>any</i> of these values.&#34; For example, if you wanted bugs that were in either the &#34;Foo&#34; or &#34;Bar&#34; products, you&#39;d pass:</p>
+
+<pre  class="code"> product =&#62; [&#39;Foo&#39;, &#39;Bar&#39;]</pre>
+
+<p>Some Bugzillas may treat your arguments case-sensitively, depending on what database system they are using. Most commonly, though, Bugzilla is not case-sensitive with the arguments passed (because MySQL is the most-common database to use with Bugzilla, and MySQL is not case sensitive).</p>
+
+<dl>
+<dt><a name="alias"
+><code  class="code">alias</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The unique alias for this bug.</p>
+
+<dt><a name="assigned_to"
+><code  class="code">assigned_to</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The login name of a user that a bug is assigned to.</p>
+
+<dt><a name="component"
+><code  class="code">component</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the Component that the bug is in. Note that if there are multiple Components with the same name, and you search for that name, bugs in <i>all</i> those Components will be returned. If you don&#39;t want this, be sure to also specify the <code  class="code">product</code> argument.</p>
+
+<dt><a name="creation_time"
+><code  class="code">creation_time</code></a></dt>
+
+<dd>
+<p><code  class="code">dateTime</code> Searches for bugs that were created at this time or later. May not be an array.</p>
+
+<dt><a name="creator"
+><code  class="code">creator</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The login name of the user who created the bug.</p>
+
+<p>You can also pass this argument with the name <code  class="code">reporter</code>, for backwards compatibility with older Bugzillas.</p>
+
+<dt><a name="id"
+><code  class="code">id</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The numeric id of the bug.</p>
+
+<dt><a name="last_change_time"
+><code  class="code">last_change_time</code></a></dt>
+
+<dd>
+<p><code  class="code">dateTime</code> Searches for bugs that were modified at this time or later. May not be an array.</p>
+
+<dt><a name="limit"
+><code  class="code">limit</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> Limit the number of results returned to <code  class="code">int</code> records. If the limit is more than zero and higher than the maximum limit set by the administrator, then the maximum limit will be used instead. If you set the limit equal to zero, then all matching results will be returned instead.</p>
+
+<dt><a name="offset"
+><code  class="code">offset</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> Used in conjunction with the <code  class="code">limit</code> argument, <code  class="code">offset</code> defines the starting position for the search. For example, given a search that would return 100 bugs, setting <code  class="code">limit</code> to 10 and <code  class="code">offset</code> to 10 would return bugs 11 through 20 from the set of 100.</p>
+
+<dt><a name="op_sys"
+><code  class="code">op_sys</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The &#34;Operating System&#34; field of a bug.</p>
+
+<dt><a name="platform"
+><code  class="code">platform</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The Platform (sometimes called &#34;Hardware&#34;) field of a bug.</p>
+
+<dt><a name="priority"
+><code  class="code">priority</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The Priority field on a bug.</p>
+
+<dt><a name="product"
+><code  class="code">product</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the Product that the bug is in.</p>
+
+<dt><a name="resolution"
+><code  class="code">resolution</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The current resolution--only set if a bug is closed. You can find open bugs by searching for bugs with an empty resolution.</p>
+
+<dt><a name="severity"
+><code  class="code">severity</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The Severity field on a bug.</p>
+
+<dt><a name="status"
+><code  class="code">status</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The current status of a bug (not including its resolution, if it has one, which is a separate field above).</p>
+
+<dt><a name="summary"
+><code  class="code">summary</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> Searches for substrings in the single-line Summary field on bugs. If you specify an array, then bugs whose summaries match <i>any</i> of the passed substrings will be returned.</p>
+
+<p>Note that unlike searching in the Bugzilla UI, substrings are not split on spaces. So searching for <code  class="code">foo bar</code> will match &#34;This is a foo bar&#34; but not &#34;This foo is a bar&#34;. <code  class="code">[&#39;foo&#39;, &#39;bar&#39;]</code>, would, however, match the second item.</p>
+
+<dt><a name="target_milestone"
+><code  class="code">target_milestone</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The Target Milestone field of a bug. Note that even if this Bugzilla does not have the Target Milestone field enabled, you can still search for bugs by Target Milestone. However, it is likely that in that case, most bugs will not have a Target Milestone set (it defaults to &#34;---&#34; when the field isn&#39;t enabled).</p>
+
+<dt><a name="qa_contact"
+><code  class="code">qa_contact</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The login name of the bug&#39;s QA Contact. Note that even if this Bugzilla does not have the QA Contact field enabled, you can still search for bugs by QA Contact (though it is likely that no bug will have a QA Contact set, if the field is disabled).</p>
+
+<dt><a name="url"
+><code  class="code">url</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The &#34;URL&#34; field of a bug.</p>
+
+<dt><a name="version"
+><code  class="code">version</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The Version field of a bug.</p>
+
+<dt><a name="whiteboard"
+><code  class="code">whiteboard</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> Search the &#34;Status Whiteboard&#34; field on bugs for a substring. Works the same as the <code  class="code">summary</code> field described above, but searches the Status Whiteboard field.</p>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>The same as <a href="#get" class="podlinkpod"
+>&#34;get&#34;</a>.</p>
+
+<p>Note that you will only be returned information about bugs that you can see. Bugs that you can&#39;t see will be entirely excluded from the results. So, if you want to see private bugs, you will have to first log in and <i>then</i> call this method.</p>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<p>If you specify an invalid value for a particular field, you just won&#39;t get any results for that value.</p>
+
+<dl>
+<dt><a name="1000_(Parameters_Required)"
+>1000 (Parameters Required)</a></dt>
+
+<dd>
+<p>You may not search without any search terms.</p>
+</dd>
+</dl>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Added_in_Bugzilla_3.4."
+>Added in Bugzilla <b>3.4</b>.</a></dt>
+
+<dd>
+<dt><a name="Searching_by_votes_was_removed_in_Bugzilla_4.0."
+>Searching by <code  class="code">votes</code> was removed in Bugzilla <b>4.0</b>.</a></dt>
+
+<dd>
+<dt><a name="The_reporter_input_parameter_was_renamed_to_creator_in_Bugzilla_4.0."
+>The <code  class="code">reporter</code> input parameter was renamed to <code  class="code">creator</code> in Bugzilla <b>4.0</b>.</a></dt>
+
+<dd>
+<dt><a 
+>In <b>4.2.6</b> and newer, added the ability to return all results if <code  class="code">limit</code> is set equal to zero. Otherwise maximum results returned are limited by system configuration.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="Bug_Creation_and_Modification"
+>Bug Creation and Modification</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="create"
+>create</a></h2>
+
+<p><b>STABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>This allows you to create a new bug in Bugzilla. If you specify any invalid fields, an error will be thrown stating which field is invalid. If you specify any fields you are not allowed to set, they will just be set to their defaults or ignored.</p>
+
+<p>You cannot currently set all the items here that you can set on enter_bug.cgi.</p>
+
+<p>The WebService interface may allow you to set things other than those listed here, but realize that anything undocumented is <b>UNSTABLE</b> and will very likely change in the future.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p>Some params must be set, or an error will be thrown. These params are marked <b>Required</b>.</p>
+
+<p>Some parameters can have defaults set in Bugzilla, by the administrator. If these parameters have defaults set, you can omit them. These parameters are marked <b>Defaulted</b>.</p>
+
+<p>Clients that want to be able to interact uniformly with multiple Bugzillas should always set both the params marked <b>Required</b> and those marked <b>Defaulted</b>, because some Bugzillas may not have defaults set for <b>Defaulted</b> parameters, and then this method will throw an error if you don&#39;t specify them.</p>
+
+<p>The descriptions of the parameters below are what they mean when Bugzilla is being used to track software bugs. They may have other meanings in some installations.</p>
+
+<dl>
+<dt><a name="product_(string)_Required_-_The_name_of_the_product_the_bug_is_being_filed_against."
+><code  class="code">product</code> (string) <b>Required</b> - The name of the product the bug is being filed against.</a></dt>
+
+<dd>
+<dt><a name="component_(string)_Required_-_The_name_of_a_component_in_the_product_above."
+><code  class="code">component</code> (string) <b>Required</b> - The name of a component in the product above.</a></dt>
+
+<dd>
+<dt><a name="summary_(string)_Required_-_A_brief_description_of_the_bug_being_filed."
+><code  class="code">summary</code> (string) <b>Required</b> - A brief description of the bug being filed.</a></dt>
+
+<dd>
+<dt><a name="version_(string)_Required_-_A_version_of_the_product_above;_the_version_the_bug_was_found_in."
+><code  class="code">version</code> (string) <b>Required</b> - A version of the product above; the version the bug was found in.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">description</code> (string) <b>Defaulted</b> - The initial description for this bug. Some Bugzilla installations require this to not be blank.</a></dt>
+
+<dd>
+<dt><a name="op_sys_(string)_Defaulted_-_The_operating_system_the_bug_was_discovered_on."
+><code  class="code">op_sys</code> (string) <b>Defaulted</b> - The operating system the bug was discovered on.</a></dt>
+
+<dd>
+<dt><a name="platform_(string)_Defaulted_-_What_type_of_hardware_the_bug_was_experienced_on."
+><code  class="code">platform</code> (string) <b>Defaulted</b> - What type of hardware the bug was experienced on.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">priority</code> (string) <b>Defaulted</b> - What order the bug will be fixed in by the developer, compared to the developer&#39;s other bugs.</a></dt>
+
+<dd>
+<dt><a name="severity_(string)_Defaulted_-_How_severe_the_bug_is."
+><code  class="code">severity</code> (string) <b>Defaulted</b> - How severe the bug is.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">alias</code> (string) - A brief alias for the bug that can be used instead of a bug number when accessing this bug. Must be unique in all of this Bugzilla.</a></dt>
+
+<dd>
+<dt><a name="assigned_to_(username)_-_A_user_to_assign_this_bug_to,_if_you_don&#39;t_want_it_to_be_assigned_to_the_component_owner."
+><code  class="code">assigned_to</code> (username) - A user to assign this bug to, if you don&#39;t want it to be assigned to the component owner.</a></dt>
+
+<dd>
+<dt><a name="cc_(array)_-_An_array_of_usernames_to_CC_on_this_bug."
+><code  class="code">cc</code> (array) - An array of usernames to CC on this bug.</a></dt>
+
+<dd>
+<dt><a name="comment_is_private_(boolean)_-_If_set_to_true,_the_description_is_private,_otherwise_it_is_assumed_to_be_public."
+><code  class="code">comment_is_private</code> (boolean) - If set to true, the description is private, otherwise it is assumed to be public.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">groups</code> (array) - An array of group names to put this bug into. You can see valid group names on the Permissions tab of the Preferences screen, or, if you are an administrator, in the Groups control panel. If you don&#39;t specify this argument, then the bug will be added into all the groups that are set as being &#34;Default&#34; for this product. (If you want to avoid that, you should specify <code  class="code">groups</code> as an empty array.)</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">qa_contact</code> (username) - If this installation has QA Contacts enabled, you can set the QA Contact here if you don&#39;t want to use the component&#39;s default QA Contact.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">status</code> (string) - The status that this bug should start out as. Note that only certain statuses can be set on bug creation.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">resolution</code> (string) - If you are filing a closed bug, then you will have to specify a resolution. You cannot currently specify a resolution of <code  class="code">DUPLICATE</code> for new bugs, though. That must be done with <a href="#update" class="podlinkpod"
+>&#34;update&#34;</a>.</a></dt>
+
+<dd>
+<dt><a name="target_milestone_(string)_-_A_valid_target_milestone_for_this_product."
+><code  class="code">target_milestone</code> (string) - A valid target milestone for this product.</a></dt>
+</dl>
+
+<p>In addition to the above parameters, if your installation has any custom fields, you can set them just by passing in the name of the field and its value as a string.</p>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hash with one element, <code  class="code">id</code>. This is the id of the newly-filed bug.</p>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="51_(Invalid_Object)"
+>51 (Invalid Object)</a></dt>
+
+<dd>
+<p>You specified a field value that is invalid. The error message will have more details.</p>
+
+<dt><a name="103_(Invalid_Alias)"
+>103 (Invalid Alias)</a></dt>
+
+<dd>
+<p>The alias you specified is invalid for some reason. See the error message for more details.</p>
+
+<dt><a name="104_(Invalid_Field)"
+>104 (Invalid Field)</a></dt>
+
+<dd>
+<p>One of the drop-down fields has an invalid value, or a value entered in a text field is too long. The error message will have more detail.</p>
+
+<dt><a name="105_(Invalid_Component)"
+>105 (Invalid Component)</a></dt>
+
+<dd>
+<p>You didn&#39;t specify a component.</p>
+
+<dt><a name="106_(Invalid_Product)"
+>106 (Invalid Product)</a></dt>
+
+<dd>
+<p>Either you didn&#39;t specify a product, this product doesn&#39;t exist, or you don&#39;t have permission to enter bugs in this product.</p>
+
+<dt><a name="107_(Invalid_Summary)"
+>107 (Invalid Summary)</a></dt>
+
+<dd>
+<p>You didn&#39;t specify a summary for the bug.</p>
+
+<dt><a name="116_(Dependency_Loop)"
+>116 (Dependency Loop)</a></dt>
+
+<dd>
+<p>You specified values in the <code  class="code">blocks</code> or <code  class="code">depends_on</code> fields that would cause a circular dependency between bugs.</p>
+
+<dt><a name="120_(Group_Restriction_Denied)"
+>120 (Group Restriction Denied)</a></dt>
+
+<dd>
+<p>You tried to restrict the bug to a group which does not exist, or which you cannot use with this product.</p>
+
+<dt><a name="504_(Invalid_User)"
+>504 (Invalid User)</a></dt>
+
+<dd>
+<p>Either the QA Contact, Assignee, or CC lists have some invalid user in them. The error message will have more details.</p>
+</dd>
+</dl>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Before_3.0.4,_parameters_marked_as_Defaulted_were_actually_Required,_due_to_a_bug_in_Bugzilla."
+>Before <b>3.0.4</b>, parameters marked as <b>Defaulted</b> were actually <b>Required</b>, due to a bug in Bugzilla.</a></dt>
+
+<dd>
+<dt><a 
+>The <code  class="code">groups</code> argument was added in Bugzilla <b>4.0</b>. Before Bugzilla 4.0, bugs were only added into Mandatory groups by this method. Since Bugzilla <b>4.0.2</b>, passing an illegal group name will throw an error. In Bugzilla 4.0 and 4.0.1, illegal group names were silently ignored.</a></dt>
+
+<dd>
+<dt><a 
+>The <code  class="code">comment_is_private</code> argument was added in Bugzilla <b>4.0</b>. Before Bugzilla 4.0, you had to use the undocumented <code  class="code">commentprivacy</code> argument.</a></dt>
+
+<dd>
+<dt><a name="Error_116_was_added_in_Bugzilla_4.0._Before_that,_dependency_loop_errors_had_a_generic_code_of_32000."
+>Error 116 was added in Bugzilla <b>4.0</b>. Before that, dependency loop errors had a generic code of <code  class="code">32000</code>.</a></dt>
+
+<dd>
+<dt><a name="The_ability_to_file_new_bugs_with_a_resolution_was_added_in_Bugzilla_4.4."
+>The ability to file new bugs with a <code  class="code">resolution</code> was added in Bugzilla <b>4.4</b>.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="add_attachment"
+>add_attachment</a></h2>
+
+<p><b>STABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>This allows you to add an attachment to a bug in Bugzilla.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="ids"
+><code  class="code">ids</code></a></dt>
+
+<dd>
+<p><b>Required</b> <code  class="code">array</code> An array of ints and/or strings--the ids or aliases of bugs that you want to add this attachment to. The same attachment and comment will be added to all these bugs.</p>
+
+<dt><a name="data"
+><code  class="code">data</code></a></dt>
+
+<dd>
+<p><b>Required</b> <code  class="code">base64</code> or <code  class="code">string</code> The content of the attachment. If the content of the attachment is not ASCII text, you must encode it in base64 and declare it as the <code  class="code">base64</code> type.</p>
+
+<dt><a name="file_name"
+><code  class="code">file_name</code></a></dt>
+
+<dd>
+<p><b>Required</b> <code  class="code">string</code> The &#34;file name&#34; that will be displayed in the UI for this attachment.</p>
+
+<dt><a name="summary"
+><code  class="code">summary</code></a></dt>
+
+<dd>
+<p><b>Required</b> <code  class="code">string</code> A short string describing the attachment.</p>
+
+<dt><a name="content_type"
+><code  class="code">content_type</code></a></dt>
+
+<dd>
+<p><b>Required</b> <code  class="code">string</code> The MIME type of the attachment, like <code  class="code">text/plain</code> or <code  class="code">image/png</code>.</p>
+
+<dt><a name="comment"
+><code  class="code">comment</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> A comment to add along with this attachment.</p>
+
+<dt><a name="is_patch"
+><code  class="code">is_patch</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> True if Bugzilla should treat this attachment as a patch. If you specify this, you do not need to specify a <code  class="code">content_type</code>. The <code  class="code">content_type</code> of the attachment will be forced to <code  class="code">text/plain</code>.</p>
+
+<p>Defaults to False if not specified.</p>
+
+<dt><a name="is_private"
+><code  class="code">is_private</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> True if the attachment should be private (restricted to the &#34;insidergroup&#34;), False if the attachment should be public.</p>
+
+<p>Defaults to False if not specified.</p>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A single item <code  class="code">ids</code>, which contains an array of the attachment id(s) created.</p>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<p>This method can throw all the same errors as <a href="#get" class="podlinkpod"
+>&#34;get&#34;</a>, plus:</p>
+
+<dl>
+<dt><a name="600_(Attachment_Too_Large)"
+>600 (Attachment Too Large)</a></dt>
+
+<dd>
+<p>You tried to attach a file that was larger than Bugzilla will accept.</p>
+
+<dt><a name="601_(Invalid_MIME_Type)"
+>601 (Invalid MIME Type)</a></dt>
+
+<dd>
+<p>You specified a <code  class="code">content_type</code> argument that was blank, not a valid MIME type, or not a MIME type that Bugzilla accepts for attachments.</p>
+
+<dt><a name="603_(File_Name_Not_Specified)"
+>603 (File Name Not Specified)</a></dt>
+
+<dd>
+<p>You did not specify a valid for the <code  class="code">file_name</code> argument.</p>
+
+<dt><a name="604_(Summary_Required)"
+>604 (Summary Required)</a></dt>
+
+<dd>
+<p>You did not specify a value for the <code  class="code">summary</code> argument.</p>
+
+<dt><a name="606_(Empty_Data)"
+>606 (Empty Data)</a></dt>
+
+<dd>
+<p>You set the &#34;data&#34; field to an empty string.</p>
+</dd>
+</dl>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Added_in_Bugzilla_4.0."
+>Added in Bugzilla <b>4.0</b>.</a></dt>
+
+<dd>
+<dt><a name="The_is_url_parameter_was_removed_in_Bugzilla_4.2."
+>The <code  class="code">is_url</code> parameter was removed in Bugzilla <b>4.2</b>.</a></dt>
+
+<dd>
+<dt><a name="The_return_value_has_changed_in_Bugzilla_4.4."
+>The return value has changed in Bugzilla <b>4.4</b>.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="add_comment"
+>add_comment</a></h2>
+
+<p><b>STABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>This allows you to add a comment to a bug in Bugzilla.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="id_(int_or_string)_Required_-_The_id_or_alias_of_the_bug_to_append_a_comment_to."
+><code  class="code">id</code> (int or string) <b>Required</b> - The id or alias of the bug to append a comment to.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">comment</code> (string) <b>Required</b> - The comment to append to the bug. If this is empty or all whitespace, an error will be thrown saying that you did not set the <code  class="code">comment</code> parameter.</a></dt>
+
+<dd>
+<dt><a name="is_private_(boolean)_-_If_set_to_true,_the_comment_is_private,_otherwise_it_is_assumed_to_be_public."
+><code  class="code">is_private</code> (boolean) - If set to true, the comment is private, otherwise it is assumed to be public.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">work_time</code> (double) - Adds this many hours to the &#34;Hours Worked&#34; on the bug. If you are not in the time tracking group, this value will be ignored.</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hash with one element, <code  class="code">id</code> whose value is the id of the newly-created comment.</p>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="54_(Hours_Worked_Too_Large)"
+>54 (Hours Worked Too Large)</a></dt>
+
+<dd>
+<p>You specified a <code  class="code">work_time</code> larger than the maximum allowed value of <code  class="code">99999.99</code>.</p>
+
+<dt><a name="100_(Invalid_Bug_Alias)"
+>100 (Invalid Bug Alias)</a></dt>
+
+<dd>
+<p>If you specified an alias and there is no bug with that alias.</p>
+
+<dt><a name="101_(Invalid_Bug_ID)"
+>101 (Invalid Bug ID)</a></dt>
+
+<dd>
+<p>The id you specified doesn&#39;t exist in the database.</p>
+
+<dt><a name="109_(Bug_Edit_Denied)"
+>109 (Bug Edit Denied)</a></dt>
+
+<dd>
+<p>You did not have the necessary rights to edit the bug.</p>
+
+<dt><a name="113_(Can&#39;t_Make_Private_Comments)"
+>113 (Can&#39;t Make Private Comments)</a></dt>
+
+<dd>
+<p>You tried to add a private comment, but don&#39;t have the necessary rights.</p>
+
+<dt><a name="114_(Comment_Too_Long)"
+>114 (Comment Too Long)</a></dt>
+
+<dd>
+<p>You tried to add a comment longer than the maximum allowed length (65,535 characters).</p>
+</dd>
+</dl>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Added_in_Bugzilla_3.2."
+>Added in Bugzilla <b>3.2</b>.</a></dt>
+
+<dd>
+<dt><a name="Modified_to_return_the_new_comment&#39;s_id_in_Bugzilla_3.4"
+>Modified to return the new comment&#39;s id in Bugzilla <b>3.4</b></a></dt>
+
+<dd>
+<dt><a name="Modified_to_throw_an_error_if_you_try_to_add_a_private_comment_but_can&#39;t,_in_Bugzilla_3.4."
+>Modified to throw an error if you try to add a private comment but can&#39;t, in Bugzilla <b>3.4</b>.</a></dt>
+
+<dd>
+<dt><a 
+>Before Bugzilla <b>3.6</b>, the <code  class="code">is_private</code> argument was called <code  class="code">private</code>, and you can still call it <code  class="code">private</code> for backwards-compatibility purposes if you wish.</a></dt>
+
+<dd>
+<dt><a name="Before_Bugzilla_3.6,_error_54_and_error_114_had_a_generic_error_code_of_32000."
+>Before Bugzilla <b>3.6</b>, error 54 and error 114 had a generic error code of 32000.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="update"
+>update</a></h2>
+
+<p><b>UNSTABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Allows you to update the fields of a bug. Automatically sends emails out about the changes.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="ids"
+><code  class="code">ids</code></a></dt>
+
+<dd>
+<p>Array of <code  class="code">int</code>s or <code  class="code">string</code>s. The ids or aliases of the bugs that you want to modify.</p>
+</dd>
+</dl>
+
+<p><b>Note</b>: All following fields specify the values you want to set on the bugs you are updating.</p>
+
+<dl>
+<dt><a name="alias"
+><code  class="code">alias</code></a></dt>
+
+<dd>
+<p>(string) The alias of the bug. You can only set this if you are modifying a single bug. If there is more than one bug specified in <code  class="code">ids</code>, passing in a value for <code  class="code">alias</code> will cause an error to be thrown.</p>
+
+<dt><a name="assigned_to"
+><code  class="code">assigned_to</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The full login name of the user this bug is assigned to.</p>
+
+<dt><a name="blocks"
+><code  class="code">blocks</code></a></dt>
+
+<dd>
+<dt><a name="depends_on"
+><code  class="code">depends_on</code></a></dt>
+
+<dd>
+<p><code  class="code">hash</code> These specify the bugs that this bug blocks or depends on, respectively. To set these, you should pass a hash as the value. The hash may contain the following fields:</p>
+
+<dl>
+<dt><a name="add_An_array_of_ints._Bug_ids_to_add_to_this_field."
+><code  class="code">add</code> An array of <code  class="code">int</code>s. Bug ids to add to this field.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">remove</code> An array of <code  class="code">int</code>s. Bug ids to remove from this field. If the bug ids are not already in the field, they will be ignored.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">set</code> An array of <code  class="code">int</code>s. An exact set of bug ids to set this field to, overriding the current value. If you specify <code  class="code">set</code>, then <code  class="code">add</code> and <code  class="code">remove</code> will be ignored.</a></dt>
+</dl>
+
+<dt><a name="cc"
+><code  class="code">cc</code></a></dt>
+
+<dd>
+<p><code  class="code">hash</code> The users on the cc list. To modify this field, pass a hash, which may have the following fields:</p>
+
+<dl>
+<dt><a 
+><code  class="code">add</code> Array of <code  class="code">string</code>s. User names to add to the CC list. They must be full user names, and an error will be thrown if you pass in an invalid user name.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">remove</code> Array of <code  class="code">string</code>s. User names to remove from the CC list. They must be full user names, and an error will be thrown if you pass in an invalid user name.</a></dt>
+</dl>
+
+<dt><a name="is_cc_accessible"
+><code  class="code">is_cc_accessible</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> Whether or not users in the CC list are allowed to access the bug, even if they aren&#39;t in a group that can normally access the bug.</p>
+
+<dt><a name="comment"
+><code  class="code">comment</code></a></dt>
+
+<dd>
+<p><code  class="code">hash</code>. A comment on the change. The hash may contain the following fields:</p>
+
+<dl>
+<dt><a 
+><code  class="code">body</code> <code  class="code">string</code> The actual text of the comment. <b>Note</b>: For compatibility with the parameters to <a href="#add_comment" class="podlinkpod"
+>&#34;add_comment&#34;</a>, you can also call this field <code  class="code">comment</code>, if you want.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">is_private</code> <code  class="code">boolean</code> Whether the comment is private or not. If you try to make a comment private and you don&#39;t have the permission to, an error will be thrown.</a></dt>
+</dl>
+
+<dt><a name="comment_is_private"
+><code  class="code">comment_is_private</code></a></dt>
+
+<dd>
+<p><code  class="code">hash</code> This is how you update the privacy of comments that are already on a bug. This is a hash, where the keys are the <code  class="code">int</code> id of comments (not their count on a bug, like #1, #2, #3, but their globally-unique id, as returned by <a href="#comments" class="podlinkpod"
+>&#34;comments&#34;</a>) and the value is a <code  class="code">boolean</code> which specifies whether that comment should become private (<code  class="code">true</code>) or public (<code  class="code">false</code>).</p>
+
+<p>The comment ids must be valid for the bug being updated. Thus, it is not practical to use this while updating multiple bugs at once, as a single comment id will never be valid on multiple bugs.</p>
+
+<dt><a name="component"
+><code  class="code">component</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The Component the bug is in.</p>
+
+<dt><a name="deadline"
+><code  class="code">deadline</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The Deadline field--a date specifying when the bug must be completed by, in the format <code  class="code">YYYY-MM-DD</code>.</p>
+
+<dt><a name="dupe_of"
+><code  class="code">dupe_of</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The bug that this bug is a duplicate of. If you want to mark a bug as a duplicate, the safest thing to do is to set this value and <i>not</i> set the <code  class="code">status</code> or <code  class="code">resolution</code> fields. They will automatically be set by Bugzilla to the appropriate values for duplicate bugs.</p>
+
+<dt><a name="estimated_time"
+><code  class="code">estimated_time</code></a></dt>
+
+<dd>
+<p><code  class="code">double</code> The total estimate of time required to fix the bug, in hours. This is the <i>total</i> estimate, not the amount of time remaining to fix it.</p>
+
+<dt><a name="groups"
+><code  class="code">groups</code></a></dt>
+
+<dd>
+<p><code  class="code">hash</code> The groups a bug is in. To modify this field, pass a hash, which may have the following fields:</p>
+
+<dl>
+<dt><a 
+><code  class="code">add</code> Array of <code  class="code">string</code>s. The names of groups to add. Passing in an invalid group name or a group that you cannot add to this bug will cause an error to be thrown.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">remove</code> Array of <code  class="code">string</code>s. The names of groups to remove. Passing in an invalid group name or a group that you cannot remove from this bug will cause an error to be thrown.</a></dt>
+</dl>
+
+<dt><a name="keywords"
+><code  class="code">keywords</code></a></dt>
+
+<dd>
+<p><code  class="code">hash</code> Keywords on the bug. To modify this field, pass a hash, which may have the following fields:</p>
+
+<dl>
+<dt><a 
+><code  class="code">add</code> An array of <code  class="code">strings</code>s. The names of keywords to add to the field on the bug. Passing something that isn&#39;t a valid keyword name will cause an error to be thrown.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">remove</code> An array of <code  class="code">string</code>s. The names of keywords to remove from the field on the bug. Passing something that isn&#39;t a valid keyword name will cause an error to be thrown.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">set</code> An array of <code  class="code">strings</code>s. An exact set of keywords to set the field to, on the bug. Passing something that isn&#39;t a valid keyword name will cause an error to be thrown. Specifying <code  class="code">set</code> overrides <code  class="code">add</code> and <code  class="code">remove</code>.</a></dt>
+</dl>
+
+<dt><a name="op_sys"
+><code  class="code">op_sys</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The Operating System (&#34;OS&#34;) field on the bug.</p>
+
+<dt><a name="platform"
+><code  class="code">platform</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The Platform or &#34;Hardware&#34; field on the bug.</p>
+
+<dt><a name="priority"
+><code  class="code">priority</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The Priority field on the bug.</p>
+
+<dt><a name="product"
+><code  class="code">product</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the product that the bug is in. If you change this, you will probably also want to change <code  class="code">target_milestone</code>, <code  class="code">version</code>, and <code  class="code">component</code>, since those have different legal values in every product.</p>
+
+<p>If you cannot change the <code  class="code">target_milestone</code> field, it will be reset to the default for the product, when you move a bug to a new product.</p>
+
+<p>You may also wish to add or remove groups, as which groups are valid on a bug depends on the product. Groups that are not valid in the new product will be automatically removed, and groups which are mandatory in the new product will be automaticaly added, but no other automatic group changes will be done.</p>
+
+<p>Note that users can only move a bug into a product if they would normally have permission to file new bugs in that product.</p>
+
+<dt><a name="qa_contact"
+><code  class="code">qa_contact</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The full login name of the bug&#39;s QA Contact.</p>
+
+<dt><a name="is_creator_accessible"
+><code  class="code">is_creator_accessible</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> Whether or not the bug&#39;s reporter is allowed to access the bug, even if he or she isn&#39;t in a group that can normally access the bug.</p>
+
+<dt><a name="remaining_time"
+><code  class="code">remaining_time</code></a></dt>
+
+<dd>
+<p><code  class="code">double</code> How much work time is remaining to fix the bug, in hours. If you set <code  class="code">work_time</code> but don&#39;t explicitly set <code  class="code">remaining_time</code>, then the <code  class="code">work_time</code> will be deducted from the bug&#39;s <code  class="code">remaining_time</code>.</p>
+
+<dt><a name="reset_assigned_to"
+><code  class="code">reset_assigned_to</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> If true, the <code  class="code">assigned_to</code> field will be reset to the default for the component that the bug is in. (If you have set the component at the same time as using this, then the component used will be the new component, not the old one.)</p>
+
+<dt><a name="reset_qa_contact"
+><code  class="code">reset_qa_contact</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> If true, the <code  class="code">qa_contact</code> field will be reset to the default for the component that the bug is in. (If you have set the component at the same time as using this, then the component used will be the new component, not the old one.)</p>
+
+<dt><a name="resolution"
+><code  class="code">resolution</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The current resolution. May only be set if you are closing a bug or if you are modifying an already-closed bug. Attempting to set the resolution to <i>any</i> value (even an empty or null string) on an open bug will cause an error to be thrown.</p>
+
+<p>If you change the <code  class="code">status</code> field to an open status, the resolution field will automatically be cleared, so you don&#39;t have to clear it manually.</p>
+
+<dt><a name="see_also"
+><code  class="code">see_also</code></a></dt>
+
+<dd>
+<p><code  class="code">hash</code> The See Also field on a bug, specifying URLs to bugs in other bug trackers. To modify this field, pass a hash, which may have the following fields:</p>
+
+<dl>
+<dt><a 
+><code  class="code">add</code> An array of <code  class="code">strings</code>s. URLs to add to the field. Each URL must be a valid URL to a bug-tracker, or an error will be thrown.</a></dt>
+
+<dd>
+<dt><a name="remove_An_array_of_strings._URLs_to_remove_from_the_field._Invalid_URLs_will_be_ignored."
+><code  class="code">remove</code> An array of <code  class="code">string</code>s. URLs to remove from the field. Invalid URLs will be ignored.</a></dt>
+</dl>
+
+<dt><a name="severity"
+><code  class="code">severity</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The Severity field of a bug.</p>
+
+<dt><a name="status"
+><code  class="code">status</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The status you want to change the bug to. Note that if a bug is changing from open to closed, you should also specify a <code  class="code">resolution</code>.</p>
+
+<dt><a name="summary"
+><code  class="code">summary</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The Summary field of the bug.</p>
+
+<dt><a name="target_milestone"
+><code  class="code">target_milestone</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The bug&#39;s Target Milestone.</p>
+
+<dt><a name="url"
+><code  class="code">url</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The &#34;URL&#34; field of a bug.</p>
+
+<dt><a name="version"
+><code  class="code">version</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The bug&#39;s Version field.</p>
+
+<dt><a name="whiteboard"
+><code  class="code">whiteboard</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The Status Whiteboard field of a bug.</p>
+
+<dt><a name="work_time"
+><code  class="code">work_time</code></a></dt>
+
+<dd>
+<p><code  class="code">double</code> The number of hours worked on this bug as part of this change. If you set <code  class="code">work_time</code> but don&#39;t explicitly set <code  class="code">remaining_time</code>, then the <code  class="code">work_time</code> will be deducted from the bug&#39;s <code  class="code">remaining_time</code>.</p>
+</dd>
+</dl>
+
+<p>You can also set the value of any custom field by passing its name as a parameter, and the value to set the field to. For multiple-selection fields, the value should be an array of strings.</p>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A <code  class="code">hash</code> with a single field, &#34;bugs&#34;. This points to an array of hashes with the following fields:</p>
+
+<dl>
+<dt><a name="id"
+><code  class="code">id</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The id of the bug that was updated.</p>
+
+<dt><a name="alias"
+><code  class="code">alias</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The alias of the bug that was updated, if this bug has an alias.</p>
+
+<dt><a name="last_change_time"
+><code  class="code">last_change_time</code></a></dt>
+
+<dd>
+<p><code  class="code">dateTime</code> The exact time that this update was done at, for this bug. If no update was done (that is, no fields had their values changed and no comment was added) then this will instead be the last time the bug was updated.</p>
+
+<dt><a name="changes"
+><code  class="code">changes</code></a></dt>
+
+<dd>
+<p><code  class="code">hash</code> The changes that were actually done on this bug. The keys are the names of the fields that were changed, and the values are a hash with two keys:</p>
+
+<dl>
+<dt><a 
+><code  class="code">added</code> (<code  class="code">string</code>) The values that were added to this field, possibly a comma-and-space-separated list if multiple values were added.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">removed</code> (<code  class="code">string</code>) The values that were removed from this field, possibly a comma-and-space-separated list if multiple values were removed.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<p>Here&#39;s an example of what a return value might look like:</p>
+
+<pre  class="code"> { 
+   bugs =&#62; [
+     {
+       id    =&#62; 123,
+       alias =&#62; &#39;foo&#39;,
+       last_change_time =&#62; &#39;2010-01-01T12:34:56&#39;,
+       changes =&#62; {
+         status =&#62; {
+           removed =&#62; &#39;NEW&#39;,
+           added   =&#62; &#39;ASSIGNED&#39;
+         },
+         keywords =&#62; {
+           removed =&#62; &#39;bar&#39;,
+           added   =&#62; &#39;qux, quo, qui&#39;, 
+         }
+       },
+     }
+   ]
+ }</pre>
+
+<p>Currently, some fields are not tracked in changes: <code  class="code">comment</code>, <code  class="code">comment_is_private</code>, and <code  class="code">work_time</code>. This means that they will not show up in the return value even if they were successfully updated. This may change in a future version of Bugzilla.</p>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<p>This function can throw all of the errors that <a href="#get" class="podlinkpod"
+>&#34;get&#34;</a>, <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a>, and <a href="#add_comment" class="podlinkpod"
+>&#34;add_comment&#34;</a> can throw, plus:</p>
+
+<dl>
+<dt><a name="50_(Empty_Field)"
+>50 (Empty Field)</a></dt>
+
+<dd>
+<p>You tried to set some field to be empty, but that field cannot be empty. The error message will have more details.</p>
+
+<dt><a name="52_(Input_Not_A_Number)"
+>52 (Input Not A Number)</a></dt>
+
+<dd>
+<p>You tried to set a numeric field to a value that wasn&#39;t numeric.</p>
+
+<dt><a name="54_(Number_Too_Large)"
+>54 (Number Too Large)</a></dt>
+
+<dd>
+<p>You tried to set a numeric field to a value larger than that field can accept.</p>
+
+<dt><a name="55_(Number_Too_Small)"
+>55 (Number Too Small)</a></dt>
+
+<dd>
+<p>You tried to set a negative value in a numeric field that does not accept negative values.</p>
+
+<dt><a name="56_(Bad_Date/Time)"
+>56 (Bad Date/Time)</a></dt>
+
+<dd>
+<p>You specified an invalid date or time in a date/time field (such as the <code  class="code">deadline</code> field or a custom date/time field).</p>
+
+<dt><a name="112_(See_Also_Invalid)"
+>112 (See Also Invalid)</a></dt>
+
+<dd>
+<p>You attempted to add an invalid value to the <code  class="code">see_also</code> field.</p>
+
+<dt><a name="115_(Permission_Denied)"
+>115 (Permission Denied)</a></dt>
+
+<dd>
+<p>You don&#39;t have permission to change a particular field to a particular value. The error message will have more detail.</p>
+
+<dt><a name="116_(Dependency_Loop)"
+>116 (Dependency Loop)</a></dt>
+
+<dd>
+<p>You specified a value in the <code  class="code">blocks</code> or <code  class="code">depends_on</code> fields that causes a dependency loop.</p>
+
+<dt><a name="117_(Invalid_Comment_ID)"
+>117 (Invalid Comment ID)</a></dt>
+
+<dd>
+<p>You specified a comment id in <code  class="code">comment_is_private</code> that isn&#39;t on this bug.</p>
+
+<dt><a name="118_(Duplicate_Loop)"
+>118 (Duplicate Loop)</a></dt>
+
+<dd>
+<p>You specified a value for <code  class="code">dupe_of</code> that causes an infinite loop of duplicates.</p>
+
+<dt><a name="119_(dupe_of_Required)"
+>119 (dupe_of Required)</a></dt>
+
+<dd>
+<p>You changed the resolution to <code  class="code">DUPLICATE</code> but did not specify a value for the <code  class="code">dupe_of</code> field.</p>
+
+<dt><a name="120_(Group_Add/Remove_Denied)"
+>120 (Group Add/Remove Denied)</a></dt>
+
+<dd>
+<p>You tried to add or remove a group that you don&#39;t have permission to modify for this bug, or you tried to add a group that isn&#39;t valid in this product.</p>
+
+<dt><a name="121_(Resolution_Required)"
+>121 (Resolution Required)</a></dt>
+
+<dd>
+<p>You tried to set the <code  class="code">status</code> field to a closed status, but you didn&#39;t specify a resolution.</p>
+
+<dt><a name="122_(Resolution_On_Open_Status)"
+>122 (Resolution On Open Status)</a></dt>
+
+<dd>
+<p>This bug has an open status, but you specified a value for the <code  class="code">resolution</code> field.</p>
+
+<dt><a name="123_(Invalid_Status_Transition)"
+>123 (Invalid Status Transition)</a></dt>
+
+<dd>
+<p>You tried to change from one status to another, but the status workflow rules don&#39;t allow that change.</p>
+</dd>
+</dl>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Added_in_Bugzilla_4.0."
+>Added in Bugzilla <b>4.0</b>.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="update_see_also"
+>update_see_also</a></h2>
+
+<p><b>EXPERIMENTAL</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Adds or removes URLs for the &#34;See Also&#34; field on bugs. These URLs must point to some valid bug in some Bugzilla installation or in Launchpad.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="ids"
+><code  class="code">ids</code></a></dt>
+
+<dd>
+<p>Array of <code  class="code">int</code>s or <code  class="code">string</code>s. The ids or aliases of bugs that you want to modify.</p>
+
+<dt><a name="add"
+><code  class="code">add</code></a></dt>
+
+<dd>
+<p>Array of <code  class="code">string</code>s. URLs to Bugzilla bugs. These URLs will be added to the See Also field. They must be valid URLs to <code  class="code">show_bug.cgi</code> in a Bugzilla installation or to a bug filed at launchpad.net.</p>
+
+<p>If the URLs don&#39;t start with <code  class="code">http://</code> or <code  class="code">https://</code>, it will be assumed that <code  class="code">http://</code> should be added to the beginning of the string.</p>
+
+<p>It is safe to specify URLs that are already in the &#34;See Also&#34; field on a bug--they will just be silently ignored.</p>
+
+<dt><a name="remove"
+><code  class="code">remove</code></a></dt>
+
+<dd>
+<p>Array of <code  class="code">string</code>s. These URLs will be removed from the See Also field. You must specify the full URL that you want removed. However, matching is done case-insensitively, so you don&#39;t have to specify the URL in exact case, if you don&#39;t want to.</p>
+
+<p>If you specify a URL that is not in the See Also field of a particular bug, it will just be silently ignored. Invaild URLs are currently silently ignored, though this may change in some future version of Bugzilla.</p>
+</dd>
+</dl>
+
+<p>NOTE: If you specify the same URL in both <code  class="code">add</code> and <code  class="code">remove</code>, it will be <i>added</i>. (That is, <code  class="code">add</code> overrides <code  class="code">remove</code>.)</p>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p><code  class="code">changes</code>, a hash where the keys are numeric bug ids and the contents are a hash with one key, <code  class="code">see_also</code>. <code  class="code">see_also</code> points to a hash, which contains two keys, <code  class="code">added</code> and <code  class="code">removed</code>. These are arrays of strings, representing the actual changes that were made to the bug.</p>
+
+<p>Here&#39;s a diagram of what the return value looks like for updating bug ids 1 and 2:</p>
+
+<pre  class="code"> {
+   changes =&#62; {
+       1 =&#62; {
+           see_also =&#62; {
+               added   =&#62; (an array of bug URLs),
+               removed =&#62; (an array of bug URLs),
+           }
+       },
+       2 =&#62; {
+           see_also =&#62; {
+               added   =&#62; (an array of bug URLs),
+               removed =&#62; (an array of bug URLs),
+           }
+       }
+   }
+ }</pre>
+
+<p>This return value allows you to tell what this method actually did. It is in this format to be compatible with the return value of a future <code  class="code">Bug.update</code> method.</p>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<p>This method can throw all of the errors that <a href="#get" class="podlinkpod"
+>&#34;get&#34;</a> throws, plus:</p>
+
+<dl>
+<dt><a name="109_(Bug_Edit_Denied)"
+>109 (Bug Edit Denied)</a></dt>
+
+<dd>
+<p>You did not have the necessary rights to edit the bug.</p>
+
+<dt><a name="112_(Invalid_Bug_URL)"
+>112 (Invalid Bug URL)</a></dt>
+
+<dd>
+<p>One of the URLs you provided did not look like a valid bug URL.</p>
+
+<dt><a name="115_(See_Also_Edit_Denied)"
+>115 (See Also Edit Denied)</a></dt>
+
+<dd>
+<p>You did not have the necessary rights to edit the See Also field for this bug.</p>
+</dd>
+</dl>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Added_in_Bugzilla_3.4."
+>Added in Bugzilla <b>3.4</b>.</a></dt>
+
+<dd>
+<dt><a name="Before_Bugzilla_3.6,_error_115_had_a_generic_error_code_of_32000."
+>Before Bugzilla <b>3.6</b>, error 115 had a generic error code of 32000.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="update_tags"
+>update_tags</a></h2>
+
+<p><b>UNSTABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Adds or removes tags on bugs.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="ids"
+><code  class="code">ids</code></a></dt>
+
+<dd>
+<p><b>Required</b> <code  class="code">array</code> An array of ints and/or strings--the ids or aliases of bugs that you want to add or remove tags to. All the tags will be added or removed to all these bugs.</p>
+
+<dt><a name="tags"
+><code  class="code">tags</code></a></dt>
+
+<dd>
+<p><b>Required</b> <code  class="code">hash</code> A hash representing tags to be added and/or removed. The hash has the following fields:</p>
+
+<dl>
+<dt><a name="add_An_array_of_strings_representing_tag_names_to_be_added_to_the_bugs."
+><code  class="code">add</code> An array of <code  class="code">string</code>s representing tag names to be added to the bugs.</a></dt>
+
+<dd>
+<p>It is safe to specify tags that are already associated with the bugs--they will just be silently ignored.</p>
+
+<dt><a name="remove_An_array_of_strings_representing_tag_names_to_be_removed_from_the_bugs."
+><code  class="code">remove</code> An array of <code  class="code">string</code>s representing tag names to be removed from the bugs.</a></dt>
+
+<dd>
+<p>It is safe to specify tags that are not associated with any bugs--they will just be silently ignored.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p><code  class="code">changes</code>, a hash containing bug IDs as keys and one single value name &#34;tags&#34; which is also a hash, with <code  class="code">added</code> and <code  class="code">removed</code> as keys. See <a href="#update_see_also" class="podlinkpod"
+>&#34;update_see_also&#34;</a> for an example of how it looks like.</p>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<p>This method can throw the same errors as <a href="#get" class="podlinkpod"
+>&#34;get&#34;</a>.</p>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Added_in_Bugzilla_4.4."
+>Added in Bugzilla <b>4.4</b>.</a></dt>
+</dl>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/WebService/Bugzilla.html b/docs/en/html/api/Bugzilla/WebService/Bugzilla.html
new file mode 100644 (file)
index 0000000..e4fe71f
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/WebService/Bugzilla.html
@@ -0,0 +1,344 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::WebService::Bugzilla</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::WebService::Bugzilla</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#version'>version</a>
+    <li class='indexItem indexItem2'><a href='#extensions'>extensions</a>
+    <li class='indexItem indexItem2'><a href='#timezone'>timezone</a>
+    <li class='indexItem indexItem2'><a href='#time'>time</a>
+    <li class='indexItem indexItem2'><a href='#parameters'>parameters</a>
+    <li class='indexItem indexItem2'><a href='#last_audit_time'>last_audit_time</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::WebService::Bugzilla - Global functions for the webservice interface.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This provides functions that tell you about Bugzilla in general.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<p>See <a href="../../Bugzilla/WebService.html" class="podlinkpod"
+>Bugzilla::WebService</a> for a description of how parameters are passed,
+and what <b>STABLE</b>,
+<b>UNSTABLE</b>,
+and <b>EXPERIMENTAL</b> mean.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="version"
+>version</a></h2>
+
+<p><b>STABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Returns the current version of Bugzilla.</p>
+
+<dt><a name="Params_(none)"
+><b>Params</b> (none)</a></dt>
+
+<dd>
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hash with a single item,
+<code  class="code">version</code>,
+that is the version as a string.</p>
+
+<dt><a name="Errors_(none)"
+><b>Errors</b> (none)</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="extensions"
+>extensions</a></h2>
+
+<p><b>EXPERIMENTAL</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Gets information about the extensions that are currently installed and enabled in this Bugzilla.</p>
+
+<dt><a name="Params_(none)"
+><b>Params</b> (none)</a></dt>
+
+<dd>
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hash with a single item,
+<code  class="code">extensions</code>.
+This points to a hash.
+<i>That</i> hash contains the names of extensions as keys,
+and the values are a hash.
+That hash contains a single key <code  class="code">version</code>,
+which is the version of the extension,
+or <code  class="code">0</code> if the extension hasn&#39;t defined a version.</p>
+
+<p>The return value looks something like this:</p>
+
+<pre  class="code"> extensions =&#62; {
+     Example =&#62; {
+         version =&#62; &#39;3.6&#39;,
+     },
+     BmpConvert =&#62; {
+         version =&#62; &#39;1.0&#39;,
+     },
+ }</pre>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Added_in_Bugzilla_3.2."
+>Added in Bugzilla <b>3.2</b>.</a></dt>
+
+<dd>
+<dt><a 
+>As of Bugzilla <b>3.6</b>, the names of extensions are canonical names that the extensions define themselves. Before 3.6, the names of the extensions depended on the directory they were in on the Bugzilla server.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="timezone"
+>timezone</a></h2>
+
+<p><b>DEPRECATED</b> This method may be removed in a future version of Bugzilla. Use <a href="#time" class="podlinkpod"
+>&#34;time&#34;</a> instead.</p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Returns the timezone that Bugzilla expects dates and times in.</p>
+
+<dt><a name="Params_(none)"
+><b>Params</b> (none)</a></dt>
+
+<dd>
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hash with a single item, <code  class="code">timezone</code>, that is the timezone offset as a string in (+/-)XXXX (RFC 2822) format.</p>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="As_of_Bugzilla_3.6,_the_timezone_returned_is_always_+0000_(the_UTC_timezone)."
+>As of Bugzilla <b>3.6</b>, the timezone returned is always <code  class="code">+0000</code> (the UTC timezone).</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="time"
+>time</a></h2>
+
+<p><b>STABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Gets information about what time the Bugzilla server thinks it is, and what timezone it&#39;s running in.</p>
+
+<dt><a name="Params_(none)"
+><b>Params</b> (none)</a></dt>
+
+<dd>
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A struct with the following items:</p>
+
+<dl>
+<dt><a name="db_time"
+><code  class="code">db_time</code></a></dt>
+
+<dd>
+<p><code  class="code">dateTime</code> The current time in UTC, according to the Bugzilla <i>database server</i>.</p>
+
+<p>Note that Bugzilla assumes that the database and the webserver are running in the same time zone. However, if the web server and the database server aren&#39;t synchronized for some reason, <i>this</i> is the time that you should rely on for doing searches and other input to the WebService.</p>
+
+<dt><a name="web_time"
+><code  class="code">web_time</code></a></dt>
+
+<dd>
+<p><code  class="code">dateTime</code> This is the current time in UTC, according to Bugzilla&#39;s <i>web server</i>.</p>
+
+<p>This might be different by a second from <code  class="code">db_time</code> since this comes from a different source. If it&#39;s any more different than a second, then there is likely some problem with this Bugzilla instance. In this case you should rely on the <code  class="code">db_time</code>, not the <code  class="code">web_time</code>.</p>
+
+<dt><a name="web_time_utc"
+><code  class="code">web_time_utc</code></a></dt>
+
+<dd>
+<p>Identical to <code  class="code">web_time</code>. (Exists only for backwards-compatibility with versions of Bugzilla before 3.6.)</p>
+
+<dt><a name="tz_name"
+><code  class="code">tz_name</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The literal string <code  class="code">UTC</code>. (Exists only for backwards-compatibility with versions of Bugzilla before 3.6.)</p>
+
+<dt><a name="tz_short_name"
+><code  class="code">tz_short_name</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The literal string <code  class="code">UTC</code>. (Exists only for backwards-compatibility with versions of Bugzilla before 3.6.)</p>
+
+<dt><a name="tz_offset"
+><code  class="code">tz_offset</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The literal string <code  class="code">+0000</code>. (Exists only for backwards-compatibility with versions of Bugzilla before 3.6.)</p>
+</dd>
+</dl>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Added_in_Bugzilla_3.4."
+>Added in Bugzilla <b>3.4</b>.</a></dt>
+
+<dd>
+<dt><a 
+>As of Bugzilla <b>3.6</b>, this method returns all data as though the server were in the UTC timezone, instead of returning information in the server&#39;s local timezone.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="parameters"
+>parameters</a></h2>
+
+<p><b>UNSTABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Returns parameter values currently used in this Bugzilla.</p>
+
+<dt><a name="Params_(none)"
+><b>Params</b> (none)</a></dt>
+
+<dd>
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hash with a single item <code  class="code">parameters</code> which contains a hash with the name of the parameters as keys and their value as values. All values are returned as strings. The list of parameters returned by this method depends on the user credentials:</p>
+
+<p>A logged-out user can only access the <code  class="code">maintainer</code> and <code  class="code">requirelogin</code> parameters.</p>
+
+<p>A logged-in user can access the following parameters (listed alphabetically): <code  class="code">allowemailchange</code>, <code  class="code">attachment_base</code>, <code  class="code">commentonchange_resolution</code>, <code  class="code">commentonduplicate</code>, <code  class="code">cookiepath</code>, <code  class="code">defaultopsys</code>, <code  class="code">defaultplatform</code>, <code  class="code">defaultpriority</code>, <code  class="code">defaultseverity</code>, <code  class="code">duplicate_or_move_bug_status</code>, <code  class="code">emailregexpdesc</code>, <code  class="code">emailsuffix</code>, <code  class="code">letsubmitterchoosemilestone</code>, <code  class="code">letsubmitterchoosepriority</code>, <code  class="code">mailfrom</code>, <code  class="code">maintainer</code>, <code  class="code">maxattachmentsize</code>, <code  class="code">maxlocalattachment</code>, <code  class="code">musthavemilestoneonaccept</code>, <code  class="code">noresolveonopenblockers</code>, <code  class="code">password_complexity</code>, <code  class="code">rememberlogin</code>, <code  class="code">requirelogin</code>, <code  class="code">search_allow_no_criteria</code>, <code  class="code">urlbase</code>, <code  class="code">use_see_also</code>, <code  class="code">useclassification</code>, <code  class="code">usemenuforusers</code>, <code  class="code">useqacontact</code>, <code  class="code">usestatuswhiteboard</code>, <code  class="code">usetargetmilestone</code>.</p>
+
+<p>A user in the tweakparams group can access all existing parameters. New parameters can appear or obsolete parameters can disappear depending on the version of Bugzilla and on extensions being installed. The list of parameters returned by this method is not stable and will never be stable.</p>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Added_in_Bugzilla_4.4."
+>Added in Bugzilla <b>4.4</b>.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="last_audit_time"
+>last_audit_time</a></h2>
+
+<p><b>EXPERIMENTAL</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Gets the latest time of the audit_log table.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p>You can pass the optional parameter <code  class="code">class</code> to get the maximum for only the listed classes.</p>
+
+<dl>
+<dt><a name="class_(array)_-_An_array_of_strings_representing_the_class_names."
+><code  class="code">class</code> (array) - An array of strings representing the class names.</a></dt>
+
+<dd>
+<p><b>Note:</b> The class names are defined as &#34;Bugzilla::&#60;class_name&#62;&#34;. For the product use Bugzilla:Product.</p>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hash with a single item, <code  class="code">last_audit_time</code>, that is the maximum of the at_time from the audit_log.</p>
+
+<dt><a name="Errors_(none)"
+><b>Errors</b> (none)</a></dt>
+
+<dd>
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Added_in_Bugzilla_4.4."
+>Added in Bugzilla <b>4.4</b>.</a></dt>
+</dl>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/WebService/Classification.html b/docs/en/html/api/Bugzilla/WebService/Classification.html
new file mode 100644 (file)
index 0000000..a0cd107
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/WebService/Classification.html
@@ -0,0 +1,183 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Webservice::Classification</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Webservice::Classification</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <li class='indexItem indexItem1'><a href='#Classification_Retrieval'>Classification Retrieval</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#get'>get</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Webservice::Classification - The Classification API</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This part of the Bugzilla API allows you to deal with the available Classifications.
+You will be able to get information about them as well as manipulate them.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<p>See <a href="../../Bugzilla/WebService.html" class="podlinkpod"
+>Bugzilla::WebService</a> for a description of how parameters are passed,
+and what <b>STABLE</b>,
+<b>UNSTABLE</b>,
+and <b>EXPERIMENTAL</b> mean.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="Classification_Retrieval"
+>Classification Retrieval</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="get"
+>get</a></h2>
+
+<p><b>EXPERIMENTAL</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Returns a hash containing information about a set of classifications.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p>In addition to the parameters below,
+this method also accepts the standard <a href="../../Bugzilla/WebService.html#include_fields" class="podlinkpod"
+>include_fields</a> and <a href="../../Bugzilla/WebService.html#exclude_fields" class="podlinkpod"
+>exclude_fields</a> arguments.</p>
+
+<p>You could get classifications info by supplying their names and/or ids.
+So,
+this method accepts the following parameters:</p>
+
+<dl>
+<dt><a name="ids"
+><code  class="code">ids</code></a></dt>
+
+<dd>
+<p>An array of classification ids.</p>
+
+<dt><a name="names"
+><code  class="code">names</code></a></dt>
+
+<dd>
+<p>An array of classification names.</p>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hash with the key <code  class="code">classifications</code> and an array of hashes as the corresponding value.
+Each element of the array represents a classification that the user is authorized to see and has the following keys:</p>
+
+<dl>
+<dt><a name="id"
+><code  class="code">id</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The id of the classification.</p>
+
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the classification.</p>
+
+<dt><a name="description"
+><code  class="code">description</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The description of the classificaion.</p>
+
+<dt><a name="sort_key"
+><code  class="code">sort_key</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The value which determines the order the classification is sorted.</p>
+
+<dt><a name="products"
+><code  class="code">products</code></a></dt>
+
+<dd>
+<p>An array of hashes.
+The array contains the products the user is authorized to access within the classification.
+Each hash has the following keys:</p>
+
+<dl>
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the product.</p>
+
+<dt><a name="id"
+><code  class="code">id</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The id of the product.</p>
+
+<dt><a name="description"
+><code  class="code">description</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The description of the product.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="900_(Classification_not_enabled)"
+>900 (Classification not enabled)</a></dt>
+
+<dd>
+<p>Classification is not enabled on this installation.</p>
+</dd>
+</dl>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Added_in_Bugzilla_4.4."
+>Added in Bugzilla <b>4.4</b>.</a></dt>
+</dl>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/WebService/Group.html b/docs/en/html/api/Bugzilla/WebService/Group.html
new file mode 100644 (file)
index 0000000..77c0b49
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/WebService/Group.html
@@ -0,0 +1,279 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Webservice::Group</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Webservice::Group</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <li class='indexItem indexItem1'><a href='#Group_Creation_and_Modification'>Group Creation and Modification</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#create'>create</a>
+    <li class='indexItem indexItem2'><a href='#update'>update</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Webservice::Group - The API for creating,
+changing,
+and getting information about Groups.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This part of the Bugzilla API allows you to create Groups and get information about them.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<p>See <a href="../../Bugzilla/WebService.html" class="podlinkpod"
+>Bugzilla::WebService</a> for a description of how parameters are passed,
+and what <b>STABLE</b>,
+<b>UNSTABLE</b>,
+and <b>EXPERIMENTAL</b> mean.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="Group_Creation_and_Modification"
+>Group Creation and Modification</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="create"
+>create</a></h2>
+
+<p><b>UNSTABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>This allows you to create a new group in Bugzilla.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p>Some params must be set,
+or an error will be thrown.
+These params are marked <b>Required</b>.</p>
+
+<dl>
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p><b>Required</b> <code  class="code">string</code> A short name for this group.
+Must be unique.
+This is not usually displayed in the user interface,
+except in a few places.</p>
+
+<dt><a name="description"
+><code  class="code">description</code></a></dt>
+
+<dd>
+<p><b>Required</b> <code  class="code">string</code> A human-readable name for this group.
+Should be relatively short.
+This is what will normally appear in the UI as the name of the group.</p>
+
+<dt><a name="user_regexp"
+><code  class="code">user_regexp</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> A regular expression.
+Any user whose Bugzilla username matches this regular expression will automatically be granted membership in this group.</p>
+
+<dt><a name="is_active"
+><code  class="code">is_active</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> <code  class="code">True</code> if new group can be used for bugs,
+<code  class="code">False</code> if this is a group that will only contain users and no bugs will be restricted to it.</p>
+
+<dt><a name="icon_url"
+><code  class="code">icon_url</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> A URL pointing to a small icon used to identify the group.
+This icon will show up next to users&#39; names in various parts of Bugzilla if they are in this group.</p>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hash with one element,
+<code  class="code">id</code>.
+This is the id of the newly-created group.</p>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="800_(Empty_Group_Name)"
+>800 (Empty Group Name)</a></dt>
+
+<dd>
+<p>You must specify a value for the <code  class="code">name</code> field.</p>
+
+<dt><a name="801_(Group_Exists)"
+>801 (Group Exists)</a></dt>
+
+<dd>
+<p>There is already another group with the same <code  class="code">name</code>.</p>
+
+<dt><a name="802_(Group_Missing_Description)"
+>802 (Group Missing Description)</a></dt>
+
+<dd>
+<p>You must specify a value for the <code  class="code">description</code> field.</p>
+
+<dt><a name="803_(Group_Regexp_Invalid)"
+>803 (Group Regexp Invalid)</a></dt>
+
+<dd>
+<p>You specified an invalid regular expression in the <code  class="code">user_regexp</code> field.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="update"
+>update</a></h2>
+
+<p><b>UNSTABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>This allows you to update a group in Bugzilla.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p>At least <code  class="code">ids</code> or <code  class="code">names</code> must be set,
+or an error will be thrown.</p>
+
+<dl>
+<dt><a name="ids"
+><code  class="code">ids</code></a></dt>
+
+<dd>
+<p><b>Required</b> <code  class="code">array</code> Contain ids of groups to update.</p>
+
+<dt><a name="names"
+><code  class="code">names</code></a></dt>
+
+<dd>
+<p><b>Required</b> <code  class="code">array</code> Contain names of groups to update.</p>
+
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> A new name for group.</p>
+
+<dt><a name="description"
+><code  class="code">description</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> A new description for groups.
+This is what will appear in the UI as the name of the groups.</p>
+
+<dt><a name="user_regexp"
+><code  class="code">user_regexp</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> A new regular expression for email.
+Will automatically grant membership to these groups to anyone with an email address that matches this perl regular expression.</p>
+
+<dt><a name="is_active"
+><code  class="code">is_active</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> Set if groups are active and eligible to be used for bugs.
+True if bugs can be restricted to this group,
+false otherwise.</p>
+
+<dt><a name="icon_url"
+><code  class="code">icon_url</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> A URL pointing to an icon that will appear next to the name of users who are in this group.</p>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A <code  class="code">hash</code> with a single field &#34;groups&#34;.
+This points to an array of hashes with the following fields:</p>
+
+<dl>
+<dt><a name="id"
+><code  class="code">id</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The id of the group that was updated.</p>
+
+<dt><a name="changes"
+><code  class="code">changes</code></a></dt>
+
+<dd>
+<p><code  class="code">hash</code> The changes that were actually done on this group.
+The keys are the names of the fields that were changed,
+and the values are a hash with two keys:</p>
+
+<dl>
+<dt><a name="added"
+><code  class="code">added</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The values that were added to this field,
+possibly a comma-and-space-separated list if multiple values were added.</p>
+
+<dt><a name="removed"
+><code  class="code">removed</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The values that were removed from this field,
+possibly a comma-and-space-separated list if multiple values were removed.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<p>The same as <a href="#create" class="podlinkpod"
+>&#34;create&#34;</a>.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/WebService/Product.html b/docs/en/html/api/Bugzilla/WebService/Product.html
new file mode 100644 (file)
index 0000000..cb9dd75
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/WebService/Product.html
@@ -0,0 +1,775 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Webservice::Product</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Webservice::Product</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <li class='indexItem indexItem1'><a href='#List_Products'>List Products</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#get_selectable_products'>get_selectable_products</a>
+    <li class='indexItem indexItem2'><a href='#get_enterable_products'>get_enterable_products</a>
+    <li class='indexItem indexItem2'><a href='#get_accessible_products'>get_accessible_products</a>
+    <li class='indexItem indexItem2'><a href='#get'>get</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#Product_Creation_and_Modification'>Product Creation and Modification</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#create'>create</a>
+    <li class='indexItem indexItem2'><a href='#update'>update</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Webservice::Product - The Product API</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This part of the Bugzilla API allows you to list the available Products and get information about them.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<p>See <a href="../../Bugzilla/WebService.html" class="podlinkpod"
+>Bugzilla::WebService</a> for a description of how parameters are passed,
+and what <b>STABLE</b>,
+<b>UNSTABLE</b>,
+and <b>EXPERIMENTAL</b> mean.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="List_Products"
+>List Products</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="get_selectable_products"
+>get_selectable_products</a></h2>
+
+<p><b>EXPERIMENTAL</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Returns a list of the ids of the products the user can search on.</p>
+
+<dt><a name="Params_(none)"
+><b>Params</b> (none)</a></dt>
+
+<dd>
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hash containing one item,
+<code  class="code">ids</code>,
+that contains an array of product ids.</p>
+
+<dt><a name="Errors_(none)"
+><b>Errors</b> (none)</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="get_enterable_products"
+>get_enterable_products</a></h2>
+
+<p><b>EXPERIMENTAL</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Returns a list of the ids of the products the user can enter bugs against.</p>
+
+<dt><a name="Params_(none)"
+><b>Params</b> (none)</a></dt>
+
+<dd>
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hash containing one item,
+<code  class="code">ids</code>,
+that contains an array of product ids.</p>
+
+<dt><a name="Errors_(none)"
+><b>Errors</b> (none)</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="get_accessible_products"
+>get_accessible_products</a></h2>
+
+<p><b>UNSTABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Returns a list of the ids of the products the user can search or enter bugs against.</p>
+
+<dt><a name="Params_(none)"
+><b>Params</b> (none)</a></dt>
+
+<dd>
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hash containing one item,
+<code  class="code">ids</code>,
+that contains an array of product ids.</p>
+
+<dt><a name="Errors_(none)"
+><b>Errors</b> (none)</a></dt>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="get"
+>get</a></h2>
+
+<p><b>EXPERIMENTAL</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Returns a list of information about the products passed to it.</p>
+
+<p><b>Note</b>: You must at least specify one of <code  class="code">ids</code> or <code  class="code">names</code>.</p>
+
+<p><b>Note</b>: Can also be called as &#34;get_products&#34; for compatibilty with Bugzilla 3.0 API.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p>In addition to the parameters below,
+this method also accepts the standard <a href="../../Bugzilla/WebService.html#include_fields" class="podlinkpod"
+>include_fields</a> and <a href="../../Bugzilla/WebService.html#exclude_fields" class="podlinkpod"
+>exclude_fields</a> arguments.</p>
+
+<p>This RPC call supports sub field restrictions.</p>
+
+<dl>
+<dt><a name="ids"
+><code  class="code">ids</code></a></dt>
+
+<dd>
+<p>An array of product ids</p>
+
+<dt><a name="names"
+><code  class="code">names</code></a></dt>
+
+<dd>
+<p>An array of product names</p>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hash containing one item,
+<code  class="code">products</code>,
+that is an array of hashes.
+Each hash describes a product,
+and has the following items:</p>
+
+<dl>
+<dt><a name="id"
+><code  class="code">id</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> An integer id uniquely identifying the product in this installation only.</p>
+
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the product.
+This is a unique identifier for the product.</p>
+
+<dt><a name="description"
+><code  class="code">description</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> A description of the product,
+which may contain HTML.</p>
+
+<dt><a name="is_active"
+><code  class="code">is_active</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> A boolean indicating if the product is active.</p>
+
+<dt><a name="default_milestone"
+><code  class="code">default_milestone</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the default milestone for the product.</p>
+
+<dt><a name="has_unconfirmed"
+><code  class="code">has_unconfirmed</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> Indicates whether the UNCONFIRMED bug status is available for this product.</p>
+
+<dt><a name="classification"
+><code  class="code">classification</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The classification name for the product.</p>
+
+<dt><a name="components"
+><code  class="code">components</code></a></dt>
+
+<dd>
+<p><code  class="code">array</code> An array of hashes,
+where each hash describes a component,
+and has the following items:</p>
+
+<dl>
+<dt><a name="id"
+><code  class="code">id</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> An integer id uniquely identifying the component in this installation only.</p>
+
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the component.
+This is a unique identifier for this component.</p>
+
+<dt><a name="description"
+><code  class="code">description</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> A description of the component,
+which may contain HTML.</p>
+
+<dt><a name="default_assigned_to"
+><code  class="code">default_assigned_to</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The login name of the user to whom new bugs will be assigned by default.</p>
+
+<dt><a name="default_qa_contact"
+><code  class="code">default_qa_contact</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The login name of the user who will be set as the QA Contact for new bugs by default.
+Empty string if the QA contact is not defined.</p>
+
+<dt><a name="sort_key"
+><code  class="code">sort_key</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> Components,
+when displayed in a list,
+are sorted first by this integer and then secondly by their name.</p>
+
+<dt><a name="is_active"
+><code  class="code">is_active</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> A boolean indicating if the component is active.
+Inactive components are not enabled for new bugs.</p>
+
+<dt><a name="flag_types"
+><code  class="code">flag_types</code></a></dt>
+
+<dd>
+<p>A hash containing the two items <code  class="code">bug</code> and <code  class="code">attachment</code> that each contains an array of hashes,
+where each hash describes a flagtype,
+and has the following items:</p>
+
+<dl>
+<dt><a name="id"
+><code  class="code">id</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> Returns the ID of the flagtype.</p>
+
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> Returns the name of the flagtype.</p>
+
+<dt><a name="description"
+><code  class="code">description</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> Returns the description of the flagtype.</p>
+
+<dt><a name="cc_list"
+><code  class="code">cc_list</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> Returns the concatenated CC list for the flagtype,
+as a single string.</p>
+
+<dt><a name="sort_key"
+><code  class="code">sort_key</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> Returns the sortkey of the flagtype.</p>
+
+<dt><a name="is_active"
+><code  class="code">is_active</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> Returns whether the flagtype is active or disabled.
+Flags being in a disabled flagtype are not deleted.
+It only prevents you from adding new flags to it.</p>
+
+<dt><a name="is_requestable"
+><code  class="code">is_requestable</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> Returns whether you can request for the given flagtype (i.e.
+whether the &#39;?&#39; flag is available or not).</p>
+
+<dt><a name="is_requesteeble"
+><code  class="code">is_requesteeble</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> Returns whether you can ask someone specifically or not.</p>
+
+<dt><a name="is_multiplicable"
+><code  class="code">is_multiplicable</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> Returns whether you can have more than one flag for the given flagtype in a given bug/attachment.</p>
+
+<dt><a name="grant_group"
+><code  class="code">grant_group</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> the group id that is allowed to grant/deny flags of this type.
+If the item is not included all users are allowed to grant/deny this flagtype.</p>
+
+<dt><a name="request_group"
+><code  class="code">request_group</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> the group id that is allowed to request the flag if the flag is of the type requestable.
+If the item is not included all users are allowed request this flagtype.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<dt><a name="versions"
+><code  class="code">versions</code></a></dt>
+
+<dd>
+<p><code  class="code">array</code> An array of hashes,
+where each hash describes a version,
+and has the following items: <code  class="code">name</code>,
+<code  class="code">sort_key</code> and <code  class="code">is_active</code>.</p>
+
+<dt><a name="milestones"
+><code  class="code">milestones</code></a></dt>
+
+<dd>
+<p><code  class="code">array</code> An array of hashes,
+where each hash describes a milestone,
+and has the following items: <code  class="code">name</code>,
+<code  class="code">sort_key</code> and <code  class="code">is_active</code>.</p>
+</dd>
+</dl>
+
+<p>Note,
+that if the user tries to access a product that is not in the list of accessible products for the user,
+or a product that does not exist,
+that is silently ignored,
+and no information about that product is returned.</p>
+
+<dt><a name="Errors_(none)"
+><b>Errors</b> (none)</a></dt>
+
+<dd>
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="In_Bugzilla_4.2,_names_was_added_as_an_input_parameter."
+>In Bugzilla <b>4.2</b>,
+<code  class="code">names</code> was added as an input parameter.</a></dt>
+
+<dd>
+<dt><a 
+>In Bugzilla <b>4.2</b>,
+<code  class="code">classification</code>,
+<code  class="code">components</code>,
+<code  class="code">versions</code>,
+<code  class="code">milestones</code>,
+<code  class="code">default_milestone</code> and <code  class="code">has_unconfirmed</code> were added to the fields returned by <code  class="code">get</code> as a replacement for <code  class="code">internals</code>,
+which has been removed.</a></dt>
+
+<dd>
+<dt><a name="In_Bugzilla_4.4,_flag_types_was_added_to_the_fields_returned_by_get."
+>In Bugzilla <b>4.4</b>,
+<code  class="code">flag_types</code> was added to the fields returned by <code  class="code">get</code>.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="Product_Creation_and_Modification"
+>Product Creation and Modification</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="create"
+>create</a></h2>
+
+<p><b>EXPERIMENTAL</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>This allows you to create a new product in Bugzilla.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p>Some params must be set,
+or an error will be thrown.
+These params are marked <b>Required</b>.</p>
+
+<dl>
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p><b>Required</b> <code  class="code">string</code> The name of this product.
+Must be globally unique within Bugzilla.</p>
+
+<dt><a name="description"
+><code  class="code">description</code></a></dt>
+
+<dd>
+<p><b>Required</b> <code  class="code">string</code> A description for this product.
+Allows some simple HTML.</p>
+
+<dt><a name="version"
+><code  class="code">version</code></a></dt>
+
+<dd>
+<p><b>Required</b> <code  class="code">string</code> The default version for this product.</p>
+
+<dt><a name="has_unconfirmed"
+><code  class="code">has_unconfirmed</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> Allow the UNCONFIRMED status to be set on bugs in this product.
+Default: true.</p>
+
+<dt><a name="classification"
+><code  class="code">classification</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the Classification which contains this product.</p>
+
+<dt><a name="default_milestone"
+><code  class="code">default_milestone</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The default milestone for this product.
+Default &#39;---&#39;.</p>
+
+<dt><a name="is_open"
+><code  class="code">is_open</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> True if the product is currently allowing bugs to be entered into it.
+Default: true.</p>
+
+<dt><a name="create_series"
+><code  class="code">create_series</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> True if you want series for New Charts to be created for this new product.
+Default: true.</p>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hash with one element,
+id.
+This is the id of the newly-filed product.</p>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="51_(Classification_does_not_exist)"
+>51 (Classification does not exist)</a></dt>
+
+<dd>
+<p>You must specify an existing classification name.</p>
+
+<dt><a name="700_(Product_blank_name)"
+>700 (Product blank name)</a></dt>
+
+<dd>
+<p>You must specify a non-blank name for this product.</p>
+
+<dt><a name="701_(Product_name_too_long)"
+>701 (Product name too long)</a></dt>
+
+<dd>
+<p>The name specified for this product was longer than the maximum allowed length.</p>
+
+<dt><a name="702_(Product_name_already_exists)"
+>702 (Product name already exists)</a></dt>
+
+<dd>
+<p>You specified the name of a product that already exists.
+(Product names must be globally unique in Bugzilla.)</p>
+
+<dt><a name="703_(Product_must_have_description)"
+>703 (Product must have description)</a></dt>
+
+<dd>
+<p>You must specify a description for this product.</p>
+
+<dt><a name="704_(Product_must_have_version)"
+>704 (Product must have version)</a></dt>
+
+<dd>
+<p>You must specify a version for this product.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="update"
+>update</a></h2>
+
+<p><b>EXPERIMENTAL</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>This allows you to update a product in Bugzilla.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p><b>Note:</b> The following parameters specify which products you are updating.
+You must set one or both of these parameters.</p>
+
+<dl>
+<dt><a name="ids"
+><code  class="code">ids</code></a></dt>
+
+<dd>
+<p><code  class="code">array</code> of <code  class="code">int</code>s.
+Numeric ids of the products that you wish to update.</p>
+
+<dt><a name="names"
+><code  class="code">names</code></a></dt>
+
+<dd>
+<p><code  class="code">array</code> or <code  class="code">string</code>s.
+Names of the products that you wish to update.</p>
+</dd>
+</dl>
+
+<p><b>Note:</b> The following parameters specify the new values you want to set for the products you are updating.</p>
+
+<dl>
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> A new name for this product.
+If you try to set this while updating more than one product,
+an error will occur,
+as product names must be unique.</p>
+
+<dt><a name="default_milestone"
+><code  class="code">default_milestone</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> When a new bug is filed,
+what milestone does it get by default if the user does not choose one?
+Must represent a milestone that is valid for this product.</p>
+
+<dt><a name="description"
+><code  class="code">description</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> Update the long description for these products to this value.</p>
+
+<dt><a name="has_unconfirmed"
+><code  class="code">has_unconfirmed</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> Allow the UNCONFIRMED status to be set on bugs in products.</p>
+
+<dt><a name="is_open"
+><code  class="code">is_open</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> True if the product is currently allowing bugs to be entered into it,
+False otherwise.</p>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A <code  class="code">hash</code> with a single field &#34;products&#34;.
+This points to an array of hashes with the following fields:</p>
+
+<dl>
+<dt><a name="id"
+><code  class="code">id</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The id of the product that was updated.</p>
+
+<dt><a name="changes"
+><code  class="code">changes</code></a></dt>
+
+<dd>
+<p><code  class="code">hash</code> The changes that were actually done on this product.
+The keys are the names of the fields that were changed,
+and the values are a hash with two keys:</p>
+
+<dl>
+<dt><a name="added"
+><code  class="code">added</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The value that this field was changed to.</p>
+
+<dt><a name="removed"
+><code  class="code">removed</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The value that was previously set in this field.</p>
+</dd>
+</dl>
+
+<p>Note that booleans will be represented with the strings &#39;1&#39; and &#39;0&#39;.</p>
+
+<p>Here&#39;s an example of what a return value might look like:</p>
+
+<pre  class="code"> { 
+   products =&#62; [
+     {
+       id =&#62; 123,
+       changes =&#62; {
+         name =&#62; {
+           removed =&#62; &#39;FooName&#39;,
+           added   =&#62; &#39;BarName&#39;
+         },
+         has_unconfirmed =&#62; {
+           removed =&#62; &#39;1&#39;,
+           added   =&#62; &#39;0&#39;,
+         }
+       }
+     }
+   ]
+ }</pre>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="700_(Product_blank_name)"
+>700 (Product blank name)</a></dt>
+
+<dd>
+<p>You must specify a non-blank name for this product.</p>
+
+<dt><a name="701_(Product_name_too_long)"
+>701 (Product name too long)</a></dt>
+
+<dd>
+<p>The name specified for this product was longer than the maximum allowed length.</p>
+
+<dt><a name="702_(Product_name_already_exists)"
+>702 (Product name already exists)</a></dt>
+
+<dd>
+<p>You specified the name of a product that already exists. (Product names must be globally unique in Bugzilla.)</p>
+
+<dt><a name="703_(Product_must_have_description)"
+>703 (Product must have description)</a></dt>
+
+<dd>
+<p>You must specify a description for this product.</p>
+
+<dt><a name="704_(Product_must_have_version)"
+>704 (Product must have version)</a></dt>
+
+<dd>
+<p>You must specify a version for this product.</p>
+
+<dt><a name="705_(Product_must_define_a_default_milestone)"
+>705 (Product must define a default milestone)</a></dt>
+
+<dd>
+<p>You must define a default milestone.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Added_in_Bugzilla_4.4."
+>Added in Bugzilla <b>4.4</b>.</a></dt>
+</dl>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/WebService/Server/JSONRPC.html b/docs/en/html/api/Bugzilla/WebService/Server/JSONRPC.html
new file mode 100644 (file)
index 0000000..52b0bc9
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/WebService/Server/JSONRPC.html
@@ -0,0 +1,171 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::WebService::Server::JSONRPC</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::WebService::Server::JSONRPC</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#JSON-RPC'>JSON-RPC</a>
+  <li class='indexItem indexItem1'><a href='#CONNECTING'>CONNECTING</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Connecting_via_GET'>Connecting via GET</a>
+    <li class='indexItem indexItem2'><a href='#JSONP'>JSONP</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#PARAMETERS'>PARAMETERS</a>
+  <li class='indexItem indexItem1'><a href='#ERRORS'>ERRORS</a>
+  <li class='indexItem indexItem1'><a href='#SEE_ALSO'>SEE ALSO</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::WebService::Server::JSONRPC - The JSON-RPC Interface to Bugzilla</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This documentation describes things about the Bugzilla WebService that are specific to JSON-RPC.
+For a general overview of the Bugzilla WebServices,
+see <a href="../../../Bugzilla/WebService.html" class="podlinkpod"
+>Bugzilla::WebService</a>.</p>
+
+<p>Please note that <i>everything</i> about this JSON-RPC interface is <b>EXPERIMENTAL</b>.
+If you want a fully stable API,
+please use the <code  class="code">Bugzilla::WebService::Server::XMLRPC|XML-RPC</code> interface.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="JSON-RPC"
+>JSON-RPC</a></h1>
+
+<p>Bugzilla supports both JSON-RPC 1.0 and 1.1.
+We recommend that you use JSON-RPC 1.0 instead of 1.1,
+though,
+because 1.1 is deprecated.</p>
+
+<p>At some point in the future,
+Bugzilla may also support JSON-RPC 2.0.</p>
+
+<p>The JSON-RPC standards are described at <a href="http://json-rpc.org/" class="podlinkurl"
+>http://json-rpc.org/</a>.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CONNECTING"
+>CONNECTING</a></h1>
+
+<p>The endpoint for the JSON-RPC interface is the <code  class="code">jsonrpc.cgi</code> script in your Bugzilla installation.
+For example,
+if your Bugzilla is at <code  class="code">bugzilla.yourdomain.com</code>,
+then your JSON-RPC client would access the API via: <code  class="code">http://bugzilla.yourdomain.com/jsonrpc.cgi</code></p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Connecting_via_GET"
+>Connecting via GET</a></h2>
+
+<p>The most powerful way to access the JSON-RPC interface is by HTTP POST.
+However,
+for convenience,
+you can also access certain methods by using GET (a normal webpage load).
+Methods that modify the database or cause some action to happen in Bugzilla cannot be called over GET.
+Only methods that simply return data can be used over GET.</p>
+
+<p>For security reasons,
+when you connect over GET,
+cookie authentication is not accepted.
+If you want to authenticate using GET,
+you have to use the <code  class="code">Bugzilla_login</code> and <code  class="code">Bugzilla_password</code> method described at <a href="../../../Bugzilla/WebService.html#LOGGING_IN" class="podlinkpod"
+>&#34;LOGGING IN&#34; in Bugzilla::WebService</a>.</p>
+
+<p>To connect over GET,
+simply send the values that you&#39;d normally send for each JSON-RPC argument as URL parameters,
+with the <code  class="code">params</code> item being a JSON string.</p>
+
+<p>The simplest example is a call to <code  class="code">Bugzilla.time</code>:</p>
+
+<pre  class="code"> jsonrpc.cgi?method=Bugzilla.time</pre>
+
+<p>Here&#39;s a call to <code  class="code">User.get</code>, with several parameters:</p>
+
+<pre  class="code"> jsonrpc.cgi?method=User.get&#38;params=[ { &#34;ids&#34;: [1,2], &#34;names&#34;: [&#34;user@domain.com&#34;] } ]</pre>
+
+<p>Although in reality you would url-encode the <code  class="code">params</code> argument, so it would look more like this:</p>
+
+<pre  class="code"> jsonrpc.cgi?method=User.get&#38;params=%5B+%7B+%22ids%22%3A+%5B1%2C2%5D%2C+%22names%22%3A+%5B%22user%40domain.com%22%5D+%7D+%5D</pre>
+
+<p>You can also specify <code  class="code">version</code> as a URL parameter, if you want to specify what version of the JSON-RPC protocol you&#39;re using, and <code  class="code">id</code> as a URL parameter if you want there to be a specific <code  class="code">id</code> value in the returned JSON-RPC response.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="JSONP"
+>JSONP</a></h2>
+
+<p>When calling the JSON-RPC WebService over GET, you can use the &#34;JSONP&#34; method of doing cross-domain requests, if you want to access the WebService directly on a web page from another site. JSONP is described at <a href="http://bob.pythonmac.org/archives/2005/12/05/remote-json-jsonp/" class="podlinkurl"
+>http://bob.pythonmac.org/archives/2005/12/05/remote-json-jsonp/</a>.</p>
+
+<p>To use JSONP with Bugzilla&#39;s JSON-RPC WebService, simply specify a <code  class="code">callback</code> parameter to jsonrpc.cgi when using it via GET as described above. For example, here&#39;s some HTML you could use to get the data from <code  class="code">Bugzilla.time</code> on a remote website, using JSONP:</p>
+
+<pre  class="code"> &#60;script type=&#34;text/javascript&#34; 
+         src=&#34;http://bugzilla.example.com/jsonrpc.cgi?method=Bugzilla.time&#38;amp;callback=foo&#34;&#62;</pre>
+
+<p>That would call the <code  class="code">Bugzilla.time</code> method and pass its value to a function called <code  class="code">foo</code> as the only argument. All the other URL parameters (such as <code  class="code">params</code>, for passing in arguments to methods) that can be passed to <code  class="code">jsonrpc.cgi</code> during GET requests are also available, of course. The above is just the simplest possible example.</p>
+
+<p>The values returned when using JSONP are identical to the values returned when not using JSONP, so you will also get error messages if there is an error.</p>
+
+<p>The <code  class="code">callback</code> URL parameter may only contain letters, numbers, periods, and the underscore (<code  class="code">_</code>) character. Including any other characters will cause Bugzilla to throw an error. (This error will be a normal JSON-RPC response, not JSONP.)</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="PARAMETERS"
+>PARAMETERS</a></h1>
+
+<p>For JSON-RPC 1.0, the very first parameter should be an object containing the named parameters. For example, if you were passing two named parameters, one called <code  class="code">foo</code> and the other called <code  class="code">bar</code>, the <code  class="code">params</code> element of your JSON-RPC call would look like:</p>
+
+<pre  class="code"> &#34;params&#34;: [{ &#34;foo&#34;: 1, &#34;bar&#34;: &#34;something&#34; }]</pre>
+
+<p>For JSON-RPC 1.1, you can pass parameters either in the above fashion or using the standard named-parameters mechanism of JSON-RPC 1.1.</p>
+
+<p><code  class="code">dateTime</code> fields are strings in the standard ISO-8601 format: <code  class="code">YYYY-MM-DDTHH:MM:SSZ</code>, where <code  class="code">T</code> and <code  class="code">Z</code> are a literal T and Z, respectively. The &#34;Z&#34; means that all times are in UTC timezone--times are always returned in UTC, and should be passed in as UTC. (Note: The JSON-RPC interface currently also accepts non-UTC times for any values passed in, if they include a time-zone specifier that follows the ISO-8601 standard, instead of &#34;Z&#34; at the end. This behavior is expected to continue into the future, but to be fully safe for forward-compatibility with all future versions of Bugzilla, it is safest to pass in all times as UTC with the &#34;Z&#34; timezone specifier.)</p>
+
+<p><code  class="code">base64</code> fields are strings that have been base64 encoded. Note that although normal base64 encoding includes newlines to break up the data, newlines within a string are not valid JSON, so you should not insert newlines into your base64-encoded string.</p>
+
+<p>All other types are standard JSON types.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="ERRORS"
+>ERRORS</a></h1>
+
+<p>JSON-RPC 1.0 and JSON-RPC 1.1 both return an <code  class="code">error</code> element when they throw an error. In Bugzilla, the error contents look like:</p>
+
+<pre  class="code"> { message: &#39;Some message here&#39;, code: 123 }</pre>
+
+<p>So, for example, in JSON-RPC 1.0, an error response would look like:</p>
+
+<pre  class="code"> { 
+   result: null, 
+   error: { message: &#39;Some message here&#39;, code: 123 }, 
+   id: 1
+ }</pre>
+
+<p>Every error has a &#34;code&#34;, as described in <a href="../../../Bugzilla/WebService.html#ERRORS" class="podlinkpod"
+>&#34;ERRORS&#34; in Bugzilla::WebService</a>. Errors with a numeric <code  class="code">code</code> higher than 100000 are errors thrown by the JSON-RPC library that Bugzilla uses, not by Bugzilla.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SEE_ALSO"
+>SEE ALSO</a></h1>
+
+<p><a href="../../../Bugzilla/WebService.html" class="podlinkpod"
+>Bugzilla::WebService</a></p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/WebService/Server/XMLRPC.html b/docs/en/html/api/Bugzilla/WebService/Server/XMLRPC.html
new file mode 100644 (file)
index 0000000..118a626
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/WebService/Server/XMLRPC.html
@@ -0,0 +1,126 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::WebService::Server::XMLRPC</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::WebService::Server::XMLRPC</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#XML-RPC'>XML-RPC</a>
+  <li class='indexItem indexItem1'><a href='#CONNECTING'>CONNECTING</a>
+  <li class='indexItem indexItem1'><a href='#PARAMETERS'>PARAMETERS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#How_XML-RPC_WebService_Methods_Take_Parameters'>How XML-RPC WebService Methods Take Parameters</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#EXTENSIONS_TO_THE_XML-RPC_STANDARD'>EXTENSIONS TO THE XML-RPC STANDARD</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Undefined_Values'>Undefined Values</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#SEE_ALSO'>SEE ALSO</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::WebService::Server::XMLRPC - The XML-RPC Interface to Bugzilla</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This documentation describes things about the Bugzilla WebService that are specific to XML-RPC.
+For a general overview of the Bugzilla WebServices,
+see <a href="../../../Bugzilla/WebService.html" class="podlinkpod"
+>Bugzilla::WebService</a>.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="XML-RPC"
+>XML-RPC</a></h1>
+
+<p>The XML-RPC standard is described here: <a href="http://www.xmlrpc.com/spec" class="podlinkurl"
+>http://www.xmlrpc.com/spec</a></p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CONNECTING"
+>CONNECTING</a></h1>
+
+<p>The endpoint for the XML-RPC interface is the <code  class="code">xmlrpc.cgi</code> script in your Bugzilla installation.
+For example,
+if your Bugzilla is at <code  class="code">bugzilla.yourdomain.com</code>,
+then your XML-RPC client would access the API via: <code  class="code">http://bugzilla.yourdomain.com/xmlrpc.cgi</code></p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="PARAMETERS"
+>PARAMETERS</a></h1>
+
+<p><code  class="code">dateTime</code> fields are the standard <code  class="code">dateTime.iso8601</code> XML-RPC field.
+They should be in <code  class="code">YYYY-MM-DDTHH:MM:SS</code> format (where <code  class="code">T</code> is a literal T).
+As of Bugzilla <b>3.6</b>,
+Bugzilla always expects <code  class="code">dateTime</code> fields to be in the UTC timezone,
+and all returned <code  class="code">dateTime</code> values are in the UTC timezone.</p>
+
+<p>All other fields are standard XML-RPC types.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="How_XML-RPC_WebService_Methods_Take_Parameters"
+>How XML-RPC WebService Methods Take Parameters</a></h2>
+
+<p>All functions take a single argument,
+a <code  class="code">&#60;struct&#62;</code> that contains all parameters.
+The names of the parameters listed in the API docs for each function are the <code  class="code">&#60;name&#62;</code> element for the struct <code  class="code">&#60;member&#62;</code>s.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="EXTENSIONS_TO_THE_XML-RPC_STANDARD"
+>EXTENSIONS TO THE XML-RPC STANDARD</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Undefined_Values"
+>Undefined Values</a></h2>
+
+<p>Normally,
+XML-RPC does not allow empty values for <code  class="code">int</code>,
+<code  class="code">double</code>,
+or <code  class="code">dateTime.iso8601</code> fields.
+Bugzilla does--it treats empty values as <code  class="code">undef</code> (called <code  class="code">NULL</code> or <code  class="code">None</code> in some programming languages).</p>
+
+<p>Bugzilla accepts a timezone specifier at the end of <code  class="code">dateTime.iso8601</code> fields that are specified as method arguments.
+The format of the timezone specifier is specified in the ISO-8601 standard.
+If no timezone specifier is included,
+the passed-in time is assumed to be in the UTC timezone.
+Bugzilla will never output a timezone specifier on returned data,
+because doing so would violate the XML-RPC specification.
+All returned times are in the UTC timezone.</p>
+
+<p>Bugzilla also accepts an element called <code  class="code">&#60;nil&#62;</code>,
+as specified by the XML-RPC extension here: <a href="http://ontosys.com/xml-rpc/extensions.php" class="podlinkurl"
+>http://ontosys.com/xml-rpc/extensions.php</a>,
+which is always considered to be <code  class="code">undef</code>,
+no matter what it contains.</p>
+
+<p>Bugzilla does not use <code  class="code">&#60;nil&#62;</code> values in returned data,
+because currently most clients do not support <code  class="code">&#60;nil&#62;</code>.
+Instead,
+any fields with <code  class="code">undef</code> values will be stripped from the response completely.
+Therefore <b>the client must handle the fact that some expected fields may not be returned</b>.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SEE_ALSO"
+>SEE ALSO</a></h1>
+
+<p><a href="../../../Bugzilla/WebService.html" class="podlinkpod"
+>Bugzilla::WebService</a></p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/WebService/User.html b/docs/en/html/api/Bugzilla/WebService/User.html
new file mode 100644 (file)
index 0000000..401db79
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/WebService/User.html
@@ -0,0 +1,770 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Webservice::User</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Webservice::User</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <li class='indexItem indexItem1'><a href='#Logging_In_and_Out'>Logging In and Out</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#login'>login</a>
+    <li class='indexItem indexItem2'><a href='#logout'>logout</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#Account_Creation_and_Modification'>Account Creation and Modification</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#offer_account_by_email'>offer_account_by_email</a>
+    <li class='indexItem indexItem2'><a href='#create'>create</a>
+    <li class='indexItem indexItem2'><a href='#update'>update</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#User_Info'>User Info</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#get'>get</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Webservice::User - The User Account and Login API</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This part of the Bugzilla API allows you to create User Accounts and log in/out using an existing account.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<p>See <a href="../../Bugzilla/WebService.html" class="podlinkpod"
+>Bugzilla::WebService</a> for a description of how parameters are passed,
+and what <b>STABLE</b>,
+<b>UNSTABLE</b>,
+and <b>EXPERIMENTAL</b> mean.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="Logging_In_and_Out"
+>Logging In and Out</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="login"
+>login</a></h2>
+
+<p><b>STABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Logging in,
+with a username and password,
+is required for many Bugzilla installations,
+in order to search for bugs,
+post new bugs,
+etc.
+This method logs in an user.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="login_(string)_-_The_user&#39;s_login_name."
+><code  class="code">login</code> (string) - The user&#39;s login name.</a></dt>
+
+<dd>
+<dt><a name="password_(string)_-_The_user&#39;s_password."
+><code  class="code">password</code> (string) - The user&#39;s password.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">remember</code> (bool) <b>Optional</b> - if the cookies returned by the call to login should expire with the session or not.
+In order for this option to have effect the Bugzilla server must be configured to allow the user to set this option - the Bugzilla parameter <i>rememberlogin</i> must be set to &#34;defaulton&#34; or &#34;defaultoff&#34;.
+Addionally,
+the client application must implement management of cookies across sessions.</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>On success,
+a hash containing one item,
+<code  class="code">id</code>,
+the numeric id of the user that was logged in.
+A set of http cookies is also sent with the response.
+These cookies must be sent along with any future requests to the webservice,
+for the duration of the session.</p>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="300_(Invalid_Username_or_Password)"
+>300 (Invalid Username or Password)</a></dt>
+
+<dd>
+<p>The username does not exist,
+or the password is wrong.</p>
+
+<dt><a name="301_(Login_Disabled)"
+>301 (Login Disabled)</a></dt>
+
+<dd>
+<p>The ability to login with this account has been disabled.
+A reason may be specified with the error.</p>
+
+<dt><a name="305_(New_Password_Required)"
+>305 (New Password Required)</a></dt>
+
+<dd>
+<p>The current password is correct,
+but the user is asked to change his password.</p>
+
+<dt><a name="50_(Param_Required)"
+>50 (Param Required)</a></dt>
+
+<dd>
+<p>A login or password parameter was not provided.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="logout"
+>logout</a></h2>
+
+<p><b>STABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Log out the user.
+Does nothing if there is no user logged in.</p>
+
+<dt><a name="Params_(none)"
+><b>Params</b> (none)</a></dt>
+
+<dd>
+<dt><a name="Returns_(nothing)"
+><b>Returns</b> (nothing)</a></dt>
+
+<dd>
+<dt><a name="Errors_(none)"
+><b>Errors</b> (none)</a></dt>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="Account_Creation_and_Modification"
+>Account Creation and Modification</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="offer_account_by_email"
+>offer_account_by_email</a></h2>
+
+<p><b>STABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Sends an email to the user,
+offering to create an account.
+The user will have to click on a URL in the email,
+and choose their password and real name.</p>
+
+<p>This is the recommended way to create a Bugzilla account.</p>
+
+<dt><a name="Param"
+><b>Param</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="email_(string)_-_the_email_to_send_the_offer_to."
+><code  class="code">email</code> (string) - the email to send the offer to.</a></dt>
+</dl>
+
+<dt><a name="Returns_(nothing)"
+><b>Returns</b> (nothing)</a></dt>
+
+<dd>
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="500_(Account_Already_Exists)"
+>500 (Account Already Exists)</a></dt>
+
+<dd>
+<p>An account with that email address already exists in Bugzilla.</p>
+
+<dt><a name="501_(Illegal_Email_Address)"
+>501 (Illegal Email Address)</a></dt>
+
+<dd>
+<p>This Bugzilla does not allow you to create accounts with the format of email address you specified.
+Account creation may be entirely disabled.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="create"
+>create</a></h2>
+
+<p><b>STABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Creates a user account directly in Bugzilla,
+password and all.
+Instead of this,
+you should use <a href="#offer_account_by_email" class="podlinkpod"
+>&#34;offer_account_by_email&#34;</a> when possible,
+because that makes sure that the email address specified can actually receive an email.
+This function does not check that.</p>
+
+<p>You must be logged in and have the <code  class="code">editusers</code> privilege in order to call this function.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="email_(string)_-_The_email_address_for_the_new_user."
+><code  class="code">email</code> (string) - The email address for the new user.</a></dt>
+
+<dd>
+<dt><a name="full_name_(string)_Optional_-_The_user&#39;s_full_name._Will_be_set_to_empty_if_not_specified."
+><code  class="code">full_name</code> (string) <b>Optional</b> - The user&#39;s full name.
+Will be set to empty if not specified.</a></dt>
+
+<dd>
+<dt><a 
+><code  class="code">password</code> (string) <b>Optional</b> - The password for the new user account,
+in plain text.
+It will be stripped of leading and trailing whitespace.
+If blank or not specified,
+the newly created account will exist in Bugzilla,
+but will not be allowed to log in using DB authentication until a password is set either by the user (through resetting their password) or by the administrator.</a></dt>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hash containing one item,
+<code  class="code">id</code>,
+the numeric id of the user that was created.</p>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<p>The same as <a href="#offer_account_by_email" class="podlinkpod"
+>&#34;offer_account_by_email&#34;</a>.
+If a password is specified,
+the function may also throw:</p>
+
+<dl>
+<dt><a name="502_(Password_Too_Short)"
+>502 (Password Too Short)</a></dt>
+
+<dd>
+<p>The password specified is too short.
+(Usually,
+this means the password is under three characters.)</p>
+</dd>
+</dl>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Error_503_(Password_Too_Long)_removed_in_Bugzilla_3.6."
+>Error 503 (Password Too Long) removed in Bugzilla <b>3.6</b>.</a></dt>
+</dl>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="update"
+>update</a></h2>
+
+<p><b>EXPERIMENTAL</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Updates user accounts in Bugzilla.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="ids"
+><code  class="code">ids</code></a></dt>
+
+<dd>
+<p><code  class="code">array</code> Contains ids of user to update.</p>
+
+<dt><a name="names"
+><code  class="code">names</code></a></dt>
+
+<dd>
+<p><code  class="code">array</code> Contains email/login of user to update.</p>
+
+<dt><a name="full_name"
+><code  class="code">full_name</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The new name of the user.</p>
+
+<dt><a name="email"
+><code  class="code">email</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The email of the user.
+Note that email used to login to bugzilla.
+Also note that you can only update one user at a time when changing the login name / email.
+(An error will be thrown if you try to update this field for multiple users at once.)</p>
+
+<dt><a name="password"
+><code  class="code">password</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The password of the user.</p>
+
+<dt><a name="email_enabled"
+><code  class="code">email_enabled</code></a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> A boolean value to enable/disable sending bug-related mail to the user.</p>
+
+<dt><a name="login_denied_text"
+><code  class="code">login_denied_text</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> A text field that holds the reason for disabling a user from logging into bugzilla,
+if empty then the user account is enabled otherwise it is disabled/closed.</p>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A <code  class="code">hash</code> with a single field &#34;users&#34;.
+This points to an array of hashes with the following fields:</p>
+
+<dl>
+<dt><a name="id"
+><code  class="code">id</code></a></dt>
+
+<dd>
+<p><code  class="code">int</code> The id of the user that was updated.</p>
+
+<dt><a name="changes"
+><code  class="code">changes</code></a></dt>
+
+<dd>
+<p><code  class="code">hash</code> The changes that were actually done on this user.
+The keys are the names of the fields that were changed,
+and the values are a hash with two keys:</p>
+
+<dl>
+<dt><a name="added"
+><code  class="code">added</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The values that were added to this field,
+possibly a comma-and-space-separated list if multiple values were added.</p>
+
+<dt><a name="removed"
+><code  class="code">removed</code></a></dt>
+
+<dd>
+<p><code  class="code">string</code> The values that were removed from this field,
+possibly a comma-and-space-separated list if multiple values were removed.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="51_(Bad_Login_Name)"
+>51 (Bad Login Name)</a></dt>
+
+<dd>
+<p>You passed an invalid login name in the &#34;names&#34; array.</p>
+
+<dt><a name="304_(Authorization_Required)"
+>304 (Authorization Required)</a></dt>
+
+<dd>
+<p>Logged-in users are not authorized to edit other users.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="User_Info"
+>User Info</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="get"
+>get</a></h2>
+
+<p><b>STABLE</b></p>
+
+<dl>
+<dt><a name="Description"
+><b>Description</b></a></dt>
+
+<dd>
+<p>Gets information about user accounts in Bugzilla.</p>
+
+<dt><a name="Params"
+><b>Params</b></a></dt>
+
+<dd>
+<p><b>Note</b>: At least one of <code  class="code">ids</code>,
+<code  class="code">names</code>,
+or <code  class="code">match</code> must be specified.</p>
+
+<p><b>Note</b>: Users will not be returned more than once,
+so even if a user is matched by more than one argument,
+only one user will be returned.</p>
+
+<p>In addition to the parameters below,
+this method also accepts the standard <a href="../../Bugzilla/WebService.html#include_fields" class="podlinkpod"
+>include_fields</a> and <a href="../../Bugzilla/WebService.html#exclude_fields" class="podlinkpod"
+>exclude_fields</a> arguments.</p>
+
+<dl>
+<dt><a name="ids_(array)"
+><code  class="code">ids</code> (array)</a></dt>
+
+<dd>
+<p>An array of integers,
+representing user ids.</p>
+
+<p>Logged-out users cannot pass this parameter to this function.
+If they try,
+they will get an error.
+Logged-in users will get an error if they specify the id of a user they cannot see.</p>
+
+<dt><a name="names_(array)"
+><code  class="code">names</code> (array)</a></dt>
+
+<dd>
+<p>An array of login names (strings).</p>
+
+<dt><a name="match_(array)"
+><code  class="code">match</code> (array)</a></dt>
+
+<dd>
+<p>An array of strings.
+This works just like &#34;user matching&#34; in Bugzilla itself.
+Users will be returned whose real name or login name contains any one of the specified strings.
+Users that you cannot see will not be included in the returned list.</p>
+
+<p>Some Bugzilla installations have user-matching turned off,
+in which case you will only be returned exact matches.</p>
+
+<p>Most installations have a limit on how many matches are returned for each string,
+which defaults to 1000 but can be changed by the Bugzilla administrator.</p>
+
+<p>Logged-out users cannot use this argument,
+and an error will be thrown if they try.
+(This is to make it harder for spammers to harvest email addresses from Bugzilla,
+and also to enforce the user visibility restrictions that are implemented on some Bugzillas.)</p>
+
+<dt><a name="group_ids_(array)"
+><code  class="code">group_ids</code> (array)</a></dt>
+
+<dd>
+<dt><a name="groups_(array)"
+><code  class="code">groups</code> (array)</a></dt>
+
+<dd>
+<p><code  class="code">group_ids</code> is an array of numeric ids for groups that a user can be in.
+<code  class="code">groups</code> is an array of names of groups that a user can be in.
+If these are specified,
+they limit the return value to users who are in <i>any</i> of the groups specified.</p>
+
+<dt><a name="include_disabled_(boolean)"
+><code  class="code">include_disabled</code> (boolean)</a></dt>
+
+<dd>
+<p>By default,
+when using the <code  class="code">match</code> parameter,
+disabled users are excluded from the returned results unless their full username is identical to the match string.
+Setting <code  class="code">include_disabled</code> to <code  class="code">true</code> will include disabled users in the returned results even if their username doesn&#39;t fully match the input string.</p>
+</dd>
+</dl>
+
+<dt><a name="Returns"
+><b>Returns</b></a></dt>
+
+<dd>
+<p>A hash containing one item,
+<code  class="code">users</code>,
+that is an array of hashes.
+Each hash describes a user,
+and has the following items:</p>
+
+<dl>
+<dt><a name="id"
+>id</a></dt>
+
+<dd>
+<p><code  class="code">int</code> The unique integer ID that Bugzilla uses to represent this user.
+Even if the user&#39;s login name changes,
+this will not change.</p>
+
+<dt><a name="real_name"
+>real_name</a></dt>
+
+<dd>
+<p><code  class="code">string</code> The actual name of the user.
+May be blank.</p>
+
+<dt><a name="email"
+>email</a></dt>
+
+<dd>
+<p><code  class="code">string</code> The email address of the user.</p>
+
+<dt><a name="name"
+>name</a></dt>
+
+<dd>
+<p><code  class="code">string</code> The login name of the user.
+Note that in some situations this is different than their email.</p>
+
+<dt><a name="can_login"
+>can_login</a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> A boolean value to indicate if the user can login into bugzilla.</p>
+
+<dt><a name="email_enabled"
+>email_enabled</a></dt>
+
+<dd>
+<p><code  class="code">boolean</code> A boolean value to indicate if bug-related mail will be sent to the user or not.</p>
+
+<dt><a name="login_denied_text"
+>login_denied_text</a></dt>
+
+<dd>
+<p><code  class="code">string</code> A text field that holds the reason for disabling a user from logging into bugzilla,
+if empty then the user account is enabled.
+Otherwise it is disabled/closed.</p>
+
+<dt><a name="groups"
+>groups</a></dt>
+
+<dd>
+<p><code  class="code">array</code> An array of group hashes the user is a member of.
+If the currently logged in user is querying his own account or is a member of the &#39;editusers&#39; group,
+the array will contain all the groups that the user is a member of.
+Otherwise,
+the array will only contain groups that the logged in user can bless.
+Each hash describes the group and contains the following items:</p>
+
+<dl>
+<dt><a name="id"
+>id</a></dt>
+
+<dd>
+<p><code  class="code">int</code> The group id</p>
+
+<dt><a name="name"
+>name</a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the group</p>
+
+<dt><a name="description"
+>description</a></dt>
+
+<dd>
+<p><code  class="code">string</code> The description for the group</p>
+</dd>
+</dl>
+
+<dt><a name="saved_searches"
+>saved_searches</a></dt>
+
+<dd>
+<p><code  class="code">array</code> An array of hashes,
+each of which represents a user&#39;s saved search and has the following keys:</p>
+
+<dl>
+<dt><a name="id"
+>id</a></dt>
+
+<dd>
+<p><code  class="code">int</code> An integer id uniquely identifying the saved search.</p>
+
+<dt><a name="name"
+>name</a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the saved search.</p>
+
+<dt><a name="query"
+>query</a></dt>
+
+<dd>
+<p><code  class="code">string</code> The CGI parameters for the saved search.</p>
+</dd>
+</dl>
+
+<dt><a name="saved_reports"
+>saved_reports</a></dt>
+
+<dd>
+<p><code  class="code">array</code> An array of hashes,
+each of which represents a user&#39;s saved report and has the following keys:</p>
+
+<dl>
+<dt><a name="id"
+>id</a></dt>
+
+<dd>
+<p><code  class="code">int</code> An integer id uniquely identifying the saved report.</p>
+
+<dt><a name="name"
+>name</a></dt>
+
+<dd>
+<p><code  class="code">string</code> The name of the saved report.</p>
+
+<dt><a name="query"
+>query</a></dt>
+
+<dd>
+<p><code  class="code">string</code> The CGI parameters for the saved report.</p>
+</dd>
+</dl>
+
+<p><b>Note</b>: If you are not logged in to Bugzilla when you call this function,
+you will only be returned the <code  class="code">id</code>,
+<code  class="code">name</code>,
+and <code  class="code">real_name</code> items.
+If you are logged in and not in editusers group,
+you will only be returned the <code  class="code">id</code>,
+<code  class="code">name</code>,
+<code  class="code">real_name</code>,
+<code  class="code">email</code>,
+<code  class="code">can_login</code>,
+and <code  class="code">groups</code> items.
+The groups returned are filtered based on your permission to bless each group.
+The <code  class="code">saved_searches</code> and <code  class="code">saved_reports</code> items are only returned if you are querying your own account,
+even if you are in the editusers group.</p>
+</dd>
+</dl>
+
+<dt><a name="Errors"
+><b>Errors</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="51_(Bad_Login_Name_or_Group_ID)"
+>51 (Bad Login Name or Group ID)</a></dt>
+
+<dd>
+<p>You passed an invalid login name in the &#34;names&#34; array or a bad group ID in the <code  class="code">group_ids</code> argument.</p>
+
+<dt><a name="304_(Authorization_Required)"
+>304 (Authorization Required)</a></dt>
+
+<dd>
+<p>You are logged in,
+but you are not authorized to see one of the users you wanted to get information about by user id.</p>
+
+<dt><a name="505_(User_Access_By_Id_or_User-Matching_Denied)"
+>505 (User Access By Id or User-Matching Denied)</a></dt>
+
+<dd>
+<p>Logged-out users cannot use the &#34;ids&#34; or &#34;match&#34; arguments to this function.</p>
+
+<dt><a name="804_(Invalid_Group_Name)"
+>804 (Invalid Group Name)</a></dt>
+
+<dd>
+<p>You passed a group name in the <code  class="code">groups</code> argument which either does not exist or you do not belong to it.</p>
+</dd>
+</dl>
+
+<dt><a name="History"
+><b>History</b></a></dt>
+
+<dd>
+<dl>
+<dt><a name="Added_in_Bugzilla_3.4."
+>Added in Bugzilla <b>3.4</b>.</a></dt>
+
+<dd>
+<dt><a name="group_ids_and_groups_were_added_in_Bugzilla_4.0."
+><code  class="code">group_ids</code> and <code  class="code">groups</code> were added in Bugzilla <b>4.0</b>.</a></dt>
+
+<dd>
+<dt><a name="include_disabled_was_added_in_Bugzilla_4.0._Default_behavior_for_match_was_changed_to_only_return_enabled_accounts."
+><code  class="code">include_disabled</code> was added in Bugzilla <b>4.0</b>.
+Default behavior for <code  class="code">match</code> was changed to only return enabled accounts.</a></dt>
+
+<dd>
+<dt><a name="Error_804_has_been_added_in_Bugzilla_4.0.9_and_4.2.4._It&#39;s_now_illegal_to_pass_a_group_name_you_don&#39;t_belong_to."
+>Error 804 has been added in Bugzilla 4.0.9 and 4.2.4.
+It&#39;s now illegal to pass a group name you don&#39;t belong to.</a></dt>
+
+<dd>
+<dt><a name="groups,_saved_searches,_and_saved_reports_were_added_in_Bugzilla_4.4."
+><code  class="code">groups</code>,
+<code  class="code">saved_searches</code>,
+and <code  class="code">saved_reports</code> were added in Bugzilla <b>4.4</b>.</a></dt>
+</dl>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/WebService/Util.html b/docs/en/html/api/Bugzilla/WebService/Util.html
new file mode 100644 (file)
index 0000000..63ebde7
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/WebService/Util.html
@@ -0,0 +1,95 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::WebService::Util</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1></h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#filter'>filter</a>
+    <li class='indexItem indexItem2'><a href='#filter_wants'>filter_wants</a>
+    <li class='indexItem indexItem2'><a href='#validate'>validate</a>
+    <li class='indexItem indexItem2'><a href='#translate'>translate</a>
+    <li class='indexItem indexItem2'><a href='#params_to_objects'>params_to_objects</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::WebService::Util - Utility functions used inside of the WebService code.
+These are <b>not</b> functions that can be called via the WebService.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This is somewhat like <a href="../../Bugzilla/Util.html" class="podlinkpod"
+>Bugzilla::Util</a>,
+but these functions are only used internally in the WebService code.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> filter({ include_fields =&#62; [&#39;id&#39;, &#39;name&#39;], 
+          exclude_fields =&#62; [&#39;name&#39;] }, $hash);
+ my $wants = filter_wants $params, &#39;field_name&#39;;
+ validate(@_, &#39;ids&#39;);</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="filter"
+>filter</a></h2>
+
+<p>This helps implement the <code  class="code">include_fields</code> and <code  class="code">exclude_fields</code> arguments of WebService methods. Given a hash (the second argument to this subroutine), this will remove any keys that are <i>not</i> in <code  class="code">include_fields</code> and then remove any keys that <i>are</i> in <code  class="code">exclude_fields</code>.</p>
+
+<p>An optional third option can be passed that prefixes the field name to allow filtering of data two or more levels deep.</p>
+
+<p>For example, if you want to filter out the <code  class="code">id</code> key/value in components returned by Product.get, you would use the value <code  class="code">component.id</code> in your <code  class="code">exclude_fields</code> list.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="filter_wants"
+>filter_wants</a></h2>
+
+<p>Returns <code  class="code">1</code> if a filter would preserve the specified field when passing a hash to <a href="#filter" class="podlinkpod"
+>&#34;filter&#34;</a>, <code  class="code">0</code> otherwise.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="validate"
+>validate</a></h2>
+
+<p>This helps in the validation of parameters passed into the WebService methods. Currently it converts listed parameters into an array reference if the client only passed a single scalar value. It modifies the parameters hash in place so other parameters should be unaltered.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="translate"
+>translate</a></h2>
+
+<p>WebService methods frequently take parameters with different names than the ones that we use internally in Bugzilla. This function takes a hashref that has field names for keys and returns a hashref with those keys renamed according to the mapping passed in with the second parameter (which is also a hashref).</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="params_to_objects"
+>params_to_objects</a></h2>
+
+<p>Creates objects of the type passed in as the second parameter, using the parameters passed to a WebService method (the first parameter to this function). Helps make life simpler for WebService methods that internally create objects via both &#34;ids&#34; and &#34;names&#34; fields. Also de-duplicates objects that were loaded by both &#34;ids&#34; and &#34;names&#34;. Returns an arrayref of objects.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Whine.html b/docs/en/html/api/Bugzilla/Whine.html
new file mode 100644 (file)
index 0000000..7042365
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Whine.html
@@ -0,0 +1,113 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Whine</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Whine</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Constructors'>Constructors</a>
+    <li class='indexItem indexItem2'><a href='#Accessors'>Accessors</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Whine - A Whine event</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> use Bugzilla::Whine;
+
+ my $event = new Bugzilla::Whine($event_id);
+
+ my $subject      = $event-&#62;subject;
+ my $body         = $event-&#62;body;
+ my $mailifnobugs = $event-&#62;mail_if_no_bugs;
+ my $user         = $event-&#62;user;</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This module exists to represent a whine event that has been saved to the database.</p>
+
+<p>This is an implementation of <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, and so has all the same methods available as <a href="../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, in addition to what is documented below.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Constructors"
+>Constructors</a></h2>
+
+<dl>
+<dt><a name="new"
+><code  class="code">new</code></a></dt>
+
+<dd>
+<p>Does not accept a bare <code  class="code">name</code> argument. Instead, accepts only an id.</p>
+
+<p>See also: <a href="../Bugzilla/Object.html#new" class="podlinkpod"
+>&#34;new&#34; in Bugzilla::Object</a>.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Accessors"
+>Accessors</a></h2>
+
+<p>These return data about the object, without modifying the object.</p>
+
+<dl>
+<dt><a name="subject"
+><code  class="code">subject</code></a></dt>
+
+<dd>
+<p>Returns the subject of the whine event.</p>
+
+<dt><a name="body"
+><code  class="code">body</code></a></dt>
+
+<dd>
+<p>Returns the body of the whine event.</p>
+
+<dt><a name="mail_if_no_bugs"
+><code  class="code">mail_if_no_bugs</code></a></dt>
+
+<dd>
+<p>Returns a numeric 1(<code  class="code">true</code>) or 0(<code  class="code">false</code>) to represent whether this whine event object is supposed to be mailed even if there are no bugs returned by the query.</p>
+
+<dt><a name="user"
+><code  class="code">user</code></a></dt>
+
+<dd>
+<p>Returns the <a href="../Bugzilla/User.html" class="podlinkpod"
+>Bugzilla::User</a> object for the owner of the <a href="../Bugzilla/Whine.html" class="podlinkpod"
+>Bugzilla::Whine</a> event.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Whine/Query.html b/docs/en/html/api/Bugzilla/Whine/Query.html
new file mode 100644 (file)
index 0000000..ba9729f
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Whine/Query.html
@@ -0,0 +1,126 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Whine::Query</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Whine::Query</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Constructors'>Constructors</a>
+    <li class='indexItem indexItem2'><a href='#Accessors'>Accessors</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Whine::Query - A query object used by <a href="../../Bugzilla/Whine.html" class="podlinkpod"
+>Bugzilla::Whine</a>.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> use Bugzilla::Whine::Query;
+
+ my $query = new Bugzilla::Whine::Query($id);
+
+ my $event_id          = $query-&#62;eventid;
+ my $id                = $query-&#62;id;
+ my $query_name        = $query-&#62;name;
+ my $sortkey           = $query-&#62;sortkey;
+ my $one_email_per_bug = $query-&#62;one_email_per_bug;
+ my $title             = $query-&#62;title;</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This module exists to represent a query for a <a href="../../Bugzilla/Whine/Event.html" class="podlinkpod"
+>Bugzilla::Whine::Event</a>. Each event, which are groups of schedules and queries based on how the user configured the event, may have zero or more queries associated with it. Additionally, the queries are selected from the user&#39;s saved searches, or <a href="../../Bugzilla/Search/Saved.html" class="podlinkpod"
+>Bugzilla::Search::Saved</a> object with a matching <code  class="code">name</code> attribute for the user.</p>
+
+<p>This is an implementation of <a href="../../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, and so has all the same methods available as <a href="../../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, in addition to what is documented below.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Constructors"
+>Constructors</a></h2>
+
+<dl>
+<dt><a name="new"
+><code  class="code">new</code></a></dt>
+
+<dd>
+<p>Does not accept a bare <code  class="code">name</code> argument. Instead, accepts only an id.</p>
+
+<p>See also: <a href="../../Bugzilla/Object.html#new" class="podlinkpod"
+>&#34;new&#34; in Bugzilla::Object</a>.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Accessors"
+>Accessors</a></h2>
+
+<p>These return data about the object, without modifying the object.</p>
+
+<dl>
+<dt><a name="event_id"
+><code  class="code">event_id</code></a></dt>
+
+<dd>
+<p>The <a href="../../Bugzilla/Whine/Event.html" class="podlinkpod"
+>Bugzilla::Whine::Event</a> object id for this object.</p>
+
+<dt><a name="name"
+><code  class="code">name</code></a></dt>
+
+<dd>
+<p>The <a href="../../Bugzilla/Search/Saved.html" class="podlinkpod"
+>Bugzilla::Search::Saved</a> query object name for this object.</p>
+
+<dt><a name="sortkey"
+><code  class="code">sortkey</code></a></dt>
+
+<dd>
+<p>The relational sorting key as compared with other <a href="../../Bugzilla/Whine/Query.html" class="podlinkpod"
+>Bugzilla::Whine::Query</a> objects.</p>
+
+<dt><a name="one_email_per_bug"
+><code  class="code">one_email_per_bug</code></a></dt>
+
+<dd>
+<p>Returns a numeric 1(<code  class="code">true</code>) or 0(<code  class="code">false</code>) to represent whether this <a href="../../Bugzilla/Whine/Query.html" class="podlinkpod"
+>Bugzilla::Whine::Query</a> object is supposed to be mailed as a list of bugs or one email per bug.</p>
+
+<dt><a name="title"
+><code  class="code">title</code></a></dt>
+
+<dd>
+<p>The title of this object as it appears in the user forms and emails.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/Bugzilla/Whine/Schedule.html b/docs/en/html/api/Bugzilla/Whine/Schedule.html
new file mode 100644 (file)
index 0000000..ffd7bd1
--- /dev/null
+++ b/docs/en/html/api/Bugzilla/Whine/Schedule.html
@@ -0,0 +1,139 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+Bugzilla::Whine::Schedule</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="../.././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>Bugzilla::Whine::Schedule</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Constructors'>Constructors</a>
+    <li class='indexItem indexItem2'><a href='#Accessors'>Accessors</a>
+  </ul>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>Bugzilla::Whine::Schedule - A schedule object used by <a href="../../Bugzilla/Whine.html" class="podlinkpod"
+>Bugzilla::Whine</a>.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> use Bugzilla::Whine::Schedule;
+
+ my $schedule = new Bugzilla::Whine::Schedule($schedule_id);
+
+ my $event_id    = $schedule-&#62;eventid;
+ my $run_day     = $schedule-&#62;run_day;
+ my $run_time    = $schedule-&#62;run_time;
+ my $is_group    = $schedule-&#62;mailto_is_group;
+ my $object      = $schedule-&#62;mailto;
+ my $array_ref   = $schedule-&#62;mailto_users;</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This module exists to represent a <a href="../../Bugzilla/Whine.html" class="podlinkpod"
+>Bugzilla::Whine</a> event schedule.</p>
+
+<p>This is an implementation of <a href="../../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, and so has all the same methods available as <a href="../../Bugzilla/Object.html" class="podlinkpod"
+>Bugzilla::Object</a>, in addition to what is documented below.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="METHODS"
+>METHODS</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Constructors"
+>Constructors</a></h2>
+
+<dl>
+<dt><a name="new"
+><code  class="code">new</code></a></dt>
+
+<dd>
+<p>Does not accept a bare <code  class="code">name</code> argument. Instead, accepts only an id.</p>
+
+<p>See also: <a href="../../Bugzilla/Object.html#new" class="podlinkpod"
+>&#34;new&#34; in Bugzilla::Object</a>.</p>
+</dd>
+</dl>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Accessors"
+>Accessors</a></h2>
+
+<p>These return data about the object, without modifying the object.</p>
+
+<dl>
+<dt><a name="event_id"
+><code  class="code">event_id</code></a></dt>
+
+<dd>
+<p>The <a href="../../Bugzilla/Whine.html" class="podlinkpod"
+>Bugzilla::Whine</a> event object id for this object.</p>
+
+<dt><a name="run_day"
+><code  class="code">run_day</code></a></dt>
+
+<dd>
+<p>The day or day pattern that a <a href="../../Bugzilla/Whine.html" class="podlinkpod"
+>Bugzilla::Whine</a> event is scheduled to run.</p>
+
+<dt><a name="run_time"
+><code  class="code">run_time</code></a></dt>
+
+<dd>
+<p>The time or time pattern that a <a href="../../Bugzilla/Whine.html" class="podlinkpod"
+>Bugzilla::Whine</a> event is scheduled to run.</p>
+
+<dt><a name="mailto_is_group"
+><code  class="code">mailto_is_group</code></a></dt>
+
+<dd>
+<p>Returns a numeric 1 (<code  class="code">group</code>) or 0 (<code  class="code">user</code>) to represent whether <a href="#mailto" class="podlinkpod"
+>&#34;mailto&#34;</a> is a group or user.</p>
+
+<dt><a name="mailto"
+><code  class="code">mailto</code></a></dt>
+
+<dd>
+<p>This is either a <a href="../../Bugzilla/User.html" class="podlinkpod"
+>Bugzilla::User</a> or <a href="../../Bugzilla/Group.html" class="podlinkpod"
+>Bugzilla::Group</a> object to represent the user or group this scheduled event is set to be mailed to.</p>
+
+<dt><a name="mailto_users"
+><code  class="code">mailto_users</code></a></dt>
+
+<dd>
+<p>Returns an array reference of <a href="../../Bugzilla/User.html" class="podlinkpod"
+>Bugzilla::User</a>s. This is derived from the <a href="../../Bugzilla/Group.html" class="podlinkpod"
+>Bugzilla::Group</a> stored in <a href="#mailto" class="podlinkpod"
+>&#34;mailto&#34;</a> if <a href="#mailto_is_group" class="podlinkpod"
+>&#34;mailto_is_group&#34;</a> is true and the group is still active, otherwise it will contain a single array element for the <a href="../../Bugzilla/User.html" class="podlinkpod"
+>Bugzilla::User</a> in <a href="#mailto" class="podlinkpod"
+>&#34;mailto&#34;</a>.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/checksetup.html b/docs/en/html/api/checksetup.html
new file mode 100644 (file)
index 0000000..e2babad
--- /dev/null
+++ b/docs/en/html/api/checksetup.html
@@ -0,0 +1,267 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+checksetup.pl</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="./../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>checksetup.pl</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#OPTIONS'>OPTIONS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#MODIFYING_CHECKSETUP'>MODIFYING CHECKSETUP</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#How_Checksetup_Works'>How Checksetup Works</a>
+    <li class='indexItem indexItem2'><a href='#Modifying_the_Database'>Modifying the Database</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#RUNNING_CHECKSETUP_NON-INTERACTIVELY'>RUNNING CHECKSETUP NON-INTERACTIVELY</a>
+  <li class='indexItem indexItem1'><a href='#SEE_ALSO'>SEE ALSO</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>checksetup.pl - A do-it-all upgrade and installation script for Bugzilla.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> ./checksetup.pl [--help|--check-modules|--version]
+ ./checksetup.pl [SCRIPT [--verbose]] [--no-templates|-t]
+                 [--make-admin=user@domain.com]
+                 [--reset-password=user@domain.com]</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="OPTIONS"
+>OPTIONS</a></h1>
+
+<dl>
+<dt><a name="SCRIPT"
+><em  class="code">SCRIPT</em></a></dt>
+
+<dd>
+<p>Name of script to drive non-interactive mode. This script should define an <code  class="code">%answer</code> hash whose keys are variable names and the values answers to all the questions checksetup.pl asks. For details on the format of this script, do <code  class="code">perldoc checksetup.pl</code> and look for the <a href="#RUNNING_CHECKSETUP_NON-INTERACTIVELY" class="podlinkpod"
+>&#34;RUNNING CHECKSETUP NON-INTERACTIVELY&#34;</a> section.</p>
+
+<dt><a name="--help"
+><b>--help</b></a></dt>
+
+<dd>
+<p>Display this help text</p>
+
+<dt><a name="--check-modules"
+><b>--check-modules</b></a></dt>
+
+<dd>
+<p>Only check for correct module dependencies and quit afterward.</p>
+
+<dt><a name="--make-admin=username@domain.com"
+><b>--make-admin</b>=username@domain.com</a></dt>
+
+<dd>
+<p>Makes the specified user into a Bugzilla administrator. This is in case you accidentally lock yourself out of the Bugzilla administrative interface.</p>
+
+<dt><a name="--reset-password=user@domain.com"
+><b>--reset-password</b>=user@domain.com</a></dt>
+
+<dd>
+<p>Resets the specified user&#39;s password. checksetup.pl will prompt you to enter a new password for the user.</p>
+
+<dt><a name="--no-templates_(-t)"
+><b>--no-templates</b> (<b>-t</b>)</a></dt>
+
+<dd>
+<p>Don&#39;t compile the templates at all. Existing compiled templates will remain; missing compiled templates will not be created. (Used primarily by developers to speed up checksetup.) Use this switch at your own risk.</p>
+
+<dt><a name="--verbose"
+><b>--verbose</b></a></dt>
+
+<dd>
+<p>Output results of SCRIPT being processed.</p>
+
+<dt><a name="--version"
+><b>--version</b></a></dt>
+
+<dd>
+<p>Display the version of Bugzilla, Perl, and some info about the system that Bugzilla is being installed on, and then exit.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Hey, what&#39;s this?</p>
+
+<p><em  class="code">checksetup.pl</em> is a script that is supposed to run during installation time and also after every upgrade.</p>
+
+<p>The goal of this script is to make the installation even easier. It does this by doing things for you as well as testing for problems in advance.</p>
+
+<p>You can run the script whenever you like. You MUST run it after you update Bugzilla, because it will then update your SQL table definitions to resync them with the code.</p>
+
+<p>You can see all the details of what the script does at <a href="#How_Checksetup_Works" class="podlinkpod"
+>&#34;How Checksetup Works&#34;</a>.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="MODIFYING_CHECKSETUP"
+>MODIFYING CHECKSETUP</a></h1>
+
+<p>There should be no need for Bugzilla Administrators to modify this script; all user-configurable stuff has been moved into a local configuration file called <em  class="code">localconfig</em>. When that file in changed and <em  class="code">checksetup.pl</em> is run, then the user&#39;s changes will be reflected back into the database.</p>
+
+<p>However, developers often need to modify the installation process. This section explains how <em  class="code">checksetup.pl</em> works, so that you know the right part to modify.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="How_Checksetup_Works"
+>How Checksetup Works</a></h2>
+
+<p><em  class="code">checksetup.pl</em> runs through several stages during installation:</p>
+
+<ol>
+<li>Checks if the required and optional perl modules are installed, using <a href="./Bugzilla/Install/Requirements.html#check_requirements" class="podlinkpod"
+>&#34;check_requirements&#34; in Bugzilla::Install::Requirements</a>.</li>
+
+<li>Creates or updates the <em  class="code">localconfig</em> file, using <a href="./Bugzilla/Install/Localconfig.html#update_localconfig" class="podlinkpod"
+>&#34;update_localconfig&#34; in Bugzilla::Install::Localconfig</a>.</li>
+
+<li>Checks the DBD and database version, using <a href="./Bugzilla/DB.html#bz_check_requirements" class="podlinkpod"
+>&#34;bz_check_requirements&#34; in Bugzilla::DB</a>.</li>
+
+<li>Creates the Bugzilla database if it doesn&#39;t exist, using <a href="./Bugzilla/DB.html#bz_create_database" class="podlinkpod"
+>&#34;bz_create_database&#34; in Bugzilla::DB</a>.</li>
+
+<li>Creates all of the tables in the Bugzilla database, using <a href="./Bugzilla/DB.html#bz_setup_database" class="podlinkpod"
+>&#34;bz_setup_database&#34; in Bugzilla::DB</a>.
+<p>Note that all the table definitions are stored in <a href="./Bugzilla/DB/Schema.html#ABSTRACT_SCHEMA" class="podlinkpod"
+>&#34;ABSTRACT_SCHEMA&#34; in Bugzilla::DB::Schema</a>.</p>
+</li>
+
+<li>Puts the values into the enum tables (like <code  class="code">resolution</code>, <code  class="code">bug_status</code>, etc.) using <a href="./Bugzilla/DB.html#bz_populate_enum_tables" class="podlinkpod"
+>&#34;bz_populate_enum_tables&#34; in Bugzilla::DB</a>.</li>
+
+<li>Creates any files that Bugzilla needs but doesn&#39;t ship with, using <a href="./Bugzilla/Install/Filesystem.html#update_filesystem" class="podlinkpod"
+>&#34;update_filesystem&#34; in Bugzilla::Install::Filesystem</a>.</li>
+
+<li>Creates the <em  class="code">.htaccess</em> files if you haven&#39;t specified not to in <em  class="code">localconfig</em>. It does this with <a href="./Bugzilla/Install/Filesystem.html#create_htaccess" class="podlinkpod"
+>&#34;create_htaccess&#34; in Bugzilla::Install::Filesystem</a>.</li>
+
+<li>Updates the system parameters (stored in <em  class="code">data/params</em>), using <a href="./Bugzilla/Config.html#update_params" class="podlinkpod"
+>&#34;update_params&#34; in Bugzilla::Config</a>.</li>
+
+<li>Pre-compiles all templates, to improve the speed of Bugzilla. It uses <a href="./Bugzilla/Template.html#precompile_templates" class="podlinkpod"
+>&#34;precompile_templates&#34; in Bugzilla::Template</a> to do this.</li>
+
+<li>Fixes all file permissions to be secure. It does this differently depending on whether or not you&#39;ve specified <code  class="code">$webservergroup</code> in <em  class="code">localconfig</em>.
+<p>The function that does this is <a href="./Bugzilla/Install/Filesystem.html#fix_all_file_permissions" class="podlinkpod"
+>&#34;fix_all_file_permissions&#34; in Bugzilla::Install::Filesystem</a>.</p>
+</li>
+
+<li>Populates the <code  class="code">fielddefs</code> table, using <a href="./Bugzilla/Field.html#populate_field_definitions" class="podlinkpod"
+>&#34;populate_field_definitions&#34; in Bugzilla::Field</a>.</li>
+
+<li>This is the major part of checksetup--updating the table definitions from one version of Bugzilla to another.
+<p>The code for this is in <a href="./Bugzilla/Install/DB.html#update_table_definitions" class="podlinkpod"
+>&#34;update_table_definitions&#34; in Bugzilla::Install::DB</a>.</p>
+
+<p>This includes creating the default Classification (using <a href="./Bugzilla/Install.html#create_default_classification" class="podlinkpod"
+>&#34;create_default_classification&#34; in Bugzilla::Install</a>) and setting up all the foreign keys for all tables, using <a href="./Bugzilla/DB.html#bz_setup_foreign_keys" class="podlinkpod"
+>&#34;bz_setup_foreign_keys&#34; in Bugzilla::DB</a>.</p>
+</li>
+
+<li>Creates the system groups--the ones like <code  class="code">editbugs</code>, <code  class="code">admin</code>, and so on. This is <a href="./Bugzilla/Install.html#update_system_groups" class="podlinkpod"
+>&#34;update_system_groups&#34; in Bugzilla::Install</a>.</li>
+
+<li>Creates all of the user-adjustable preferences that appear on the &#34;General Preferences&#34; screen. This is <a href="./Bugzilla/Install.html#update_settings" class="podlinkpod"
+>&#34;update_settings&#34; in Bugzilla::Install</a>.</li>
+
+<li>Creates an administrator, if one doesn&#39;t already exist, using <a href="./Bugzilla/Install.html#create_admin" class="podlinkpod"
+>&#34;create_admin&#34; in Bugzilla::Install</a>.
+<p>We also can make somebody an admin at this step, if the user specified the <code  class="code">--make-admin</code> switch.</p>
+</li>
+
+<li>Creates the default Product and Component, using <a href="./Bugzilla/Install.html#create_default_product" class="podlinkpod"
+>&#34;create_default_product&#34; in Bugzilla::Install</a>.</li>
+</ol>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Modifying_the_Database"
+>Modifying the Database</a></h2>
+
+<p>Sometimes you&#39;ll want to modify the database. In fact, that&#39;s mostly what checksetup does, is upgrade old Bugzilla databases to the modern format.</p>
+
+<p>If you&#39;d like to know how to make changes to the datbase, see the information in the Bugzilla Developer&#39;s Guide, at: <a href="http://www.bugzilla.org/docs/developer.html#sql-schema" class="podlinkurl"
+>http://www.bugzilla.org/docs/developer.html#sql-schema</a></p>
+
+<p>Also see <a href="./Bugzilla/DB.html#Schema_Modification_Methods" class="podlinkpod"
+>&#34;Schema Modification Methods&#34; in Bugzilla::DB</a> and <a href="./Bugzilla/DB.html#Schema_Information_Methods" class="podlinkpod"
+>&#34;Schema Information Methods&#34; in Bugzilla::DB</a>.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="RUNNING_CHECKSETUP_NON-INTERACTIVELY"
+>RUNNING CHECKSETUP NON-INTERACTIVELY</a></h1>
+
+<p>To operate checksetup non-interactively, run it with a single argument specifying a filename that contains the information usually obtained by prompting the user or by editing localconfig.</p>
+
+<p>The format of that file is as follows:</p>
+
+<pre  class="code"> $answer{&#39;db_host&#39;}   = &#39;localhost&#39;;
+ $answer{&#39;db_driver&#39;} = &#39;mydbdriver&#39;;
+ $answer{&#39;db_port&#39;}   = 0;
+ $answer{&#39;db_name&#39;}   = &#39;mydbname&#39;;
+ $answer{&#39;db_user&#39;}   = &#39;mydbuser&#39;;
+ $answer{&#39;db_pass&#39;}   = &#39;mydbpass&#39;;
+
+ $answer{&#39;urlbase&#39;} = &#39;http://bugzilla.mydomain.com/&#39;;
+
+ (Any localconfig variable or parameter can be specified as above.)
+
+ $answer{&#39;ADMIN_EMAIL&#39;} = &#39;myadmin@mydomain.net&#39;;
+ $answer{&#39;ADMIN_PASSWORD&#39;} = &#39;fooey&#39;;
+ $answer{&#39;ADMIN_REALNAME&#39;} = &#39;Joel Peshkin&#39;;
+
+ $answer{&#39;SMTP_SERVER&#39;} = &#39;mail.mydomain.net&#39;;
+
+ $answer{&#39;NO_PAUSE&#39;} = 1</pre>
+
+<p><code  class="code">NO_PAUSE</code> means &#34;never stop and prompt the user to hit Enter to continue, just go ahead and do things, even if they are potentially dangerous.&#34; Don&#39;t set this to 1 unless you know what you are doing.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SEE_ALSO"
+>SEE ALSO</a></h1>
+
+<ul>
+<li><a href="./Bugzilla/Install/Requirements.html" class="podlinkpod"
+>Bugzilla::Install::Requirements</a></li>
+
+<li><a href="./Bugzilla/Install/Localconfig.html" class="podlinkpod"
+>Bugzilla::Install::Localconfig</a></li>
+
+<li><a href="./Bugzilla/Install/Filesystem.html" class="podlinkpod"
+>Bugzilla::Install::Filesystem</a></li>
+
+<li><a href="./Bugzilla/Install/DB.html" class="podlinkpod"
+>Bugzilla::Install::DB</a></li>
+
+<li><a href="./Bugzilla/Install.html" class="podlinkpod"
+>Bugzilla::Install</a></li>
+
+<li><a href="./Bugzilla/Config.html#update_params" class="podlinkpod"
+>&#34;update_params&#34; in Bugzilla::Config</a></li>
+
+<li><a href="./Bugzilla/DB.html#CONNECTION" class="podlinkpod"
+>&#34;CONNECTION&#34; in Bugzilla::DB</a></li>
+</ul>
+<p class="backlinkbottom"><b><a name="___bottom" href="index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/collectstats.html b/docs/en/html/api/collectstats.html
new file mode 100644 (file)
index 0000000..c80f4d5
--- /dev/null
+++ b/docs/en/html/api/collectstats.html
@@ -0,0 +1,64 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+collectstats.pl</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="./../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>collectstats.pl</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#OPTIONS'>OPTIONS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>collectstats.pl - Collect data about Bugzilla bugs.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> ./collectstats.pl [--regenerate] [--help]</pre>
+
+<p>Collects data about bugs to be used in Old and New Charts.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="OPTIONS"
+>OPTIONS</a></h1>
+
+<dl>
+<dt><a name="--help"
+><b>--help</b></a></dt>
+
+<dd>
+<p>Print this help page.</p>
+
+<dt><a name="--regenerate"
+><b>--regenerate</b></a></dt>
+
+<dd>
+<p>Recreate all the data about bugs, from day 1. This option is only relevant for Old Charts, and has no effect for New Charts. This option will overwrite all existing collected data and can take a huge amount of time. You normally don&#39;t need to use this option (do not use it in a cron job).</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This script collects data about all bugs for Old Charts, triaged by product and by bug status and resolution. It also collects data for New Charts, based on existing series. For New Charts, data is only collected once a series is defined; this script cannot recreate data prior to this date.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/contrib/bz_webservice_demo.html b/docs/en/html/api/contrib/bz_webservice_demo.html
new file mode 100644 (file)
index 0000000..2bd957c
--- /dev/null
+++ b/docs/en/html/api/contrib/bz_webservice_demo.html
@@ -0,0 +1,314 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+bz_webservice_demo.pl</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>bz_webservice_demo.pl</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#OPTIONS'>OPTIONS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Initialization'>Initialization</a>
+    <li class='indexItem indexItem2'><a href='#Debugging'>Debugging</a>
+    <li class='indexItem indexItem2'><a href='#Checking_Bugzilla%27s_version'>Checking Bugzilla&#39;s version</a>
+    <li class='indexItem indexItem2'><a href='#Checking_Bugzilla%27s_timezone'>Checking Bugzilla&#39;s timezone</a>
+    <li class='indexItem indexItem2'><a href='#Getting_Extension_Information'>Getting Extension Information</a>
+    <li class='indexItem indexItem2'><a href='#Logging_In_and_Out'>Logging In and Out</a>
+    <ul   class='indexList indexList3'>
+      <li class='indexItem indexItem3'><a href='#Using_Bugzilla%27s_Environment_Authentication'>Using Bugzilla&#39;s Environment Authentication</a>
+      <li class='indexItem indexItem3'><a href='#Using_Bugzilla%27s_CGI_Variable_Authentication'>Using Bugzilla&#39;s CGI Variable Authentication</a>
+    </ul>
+    <li class='indexItem indexItem2'><a href='#Retrieving_Bug_Information'>Retrieving Bug Information</a>
+    <li class='indexItem indexItem2'><a href='#Retrieving_Product_Information'>Retrieving Product Information</a>
+    <li class='indexItem indexItem2'><a href='#Creating_A_Bug'>Creating A Bug</a>
+    <li class='indexItem indexItem2'><a href='#Getting_Legal_Field_Values'>Getting Legal Field Values</a>
+    <li class='indexItem indexItem2'><a href='#Adding_a_comment_to_a_bug'>Adding a comment to a bug</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#NOTES'>NOTES</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Character_Set_Encoding'>Character Set Encoding</a>
+    <li class='indexItem indexItem2'><a href='#Format_For_Create_File'>Format For Create File</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#SEE_ALSO'>SEE ALSO</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>bz_webservice_demo.pl - Show how to talk to Bugzilla via XMLRPC</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<p><code  class="code">bz_webservice_demo.pl [options]</code></p>
+
+<p><code  class="code">bz_webservice_demo.pl --help</code> for detailed help</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="OPTIONS"
+>OPTIONS</a></h1>
+
+<dl>
+<dt><a name="--help,_-h,_-?"
+>--help,
+-h,
+-?</a></dt>
+
+<dd>
+<p>Print a short help message and exit.</p>
+
+<dt><a name="--uri"
+>--uri</a></dt>
+
+<dd>
+<p>URI to Bugzilla&#39;s <code  class="code">xmlrpc.cgi</code> script,
+along the lines of <code  class="code">http://your.bugzilla.installation/path/to/bugzilla/xmlrpc.cgi</code>.</p>
+
+<dt><a name="--login"
+>--login</a></dt>
+
+<dd>
+<p>Bugzilla login name.
+Specify this together with <b>--password</b> in order to log in.</p>
+
+<p>Specify this without a value in order to log out.</p>
+
+<dt><a name="--password"
+>--password</a></dt>
+
+<dd>
+<p>Bugzilla password.
+Specify this together with <b>--login</b> in order to log in.</p>
+
+<dt><a name="--rememberlogin"
+>--rememberlogin</a></dt>
+
+<dd>
+<p>Gives access to Bugzilla&#39;s &#34;Bugzilla_remember&#34; option.
+Specify this option while logging in to do the same thing as ticking the <code  class="code">Bugzilla_remember</code> box on Bugilla&#39;s log in form.
+Don&#39;t specify this option to do the same thing as unchecking the box.</p>
+
+<p>See Bugzilla&#39;s rememberlogin parameter for details.</p>
+
+<dt><a name="--bug_id"
+>--bug_id</a></dt>
+
+<dd>
+<p>Pass a bug ID to have <code  class="code">bz_webservice_demo.pl</code> do some bug-related test calls.</p>
+
+<dt><a name="--product_name"
+>--product_name</a></dt>
+
+<dd>
+<p>Pass a product name to have <code  class="code">bz_webservice_demo.pl</code> do some product-related test calls.</p>
+
+<dt><a name="--create"
+>--create</a></dt>
+
+<dd>
+<p>Specify a file that contains settings for the creating of a new bug.</p>
+
+<dt><a name="--field"
+>--field</a></dt>
+
+<dd>
+<p>Pass a field name to get legal values for this field.
+It must be either a global select field (such as bug_status,
+resolution,
+rep_platform,
+op_sys,
+priority,
+bug_severity) or a custom select field.</p>
+
+<dt><a name="--comment"
+>--comment</a></dt>
+
+<dd>
+<p>A comment to add to a bug identified by <b>--bug_id</b>.
+You must also pass a <b>--login</b> and <b>--password</b> to log in to Bugzilla.</p>
+
+<dt><a name="--private"
+>--private</a></dt>
+
+<dd>
+<p>An optional non-zero value to specify <b>--comment</b> as private.</p>
+
+<dt><a name="--worktime"
+>--worktime</a></dt>
+
+<dd>
+<p>An optional double precision number specifying the work time for <b>--comment</b>.</p>
+
+<dt><a name="--extension_info"
+>--extension_info</a></dt>
+
+<dd>
+<p>If specified on the command line,
+the script returns the information about the extensions that are installed.</p>
+
+<dt><a name="--debug"
+>--debug</a></dt>
+
+<dd>
+<p>Enable tracing at the debug level of XMLRPC requests and responses.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Initialization"
+>Initialization</a></h2>
+
+<p>Using the XMLRPC::Lite class,
+you set up a proxy,
+as shown in this script.
+Bugzilla&#39;s XMLRPC URI ends in <code  class="code">xmlrpc.cgi</code>,
+so your URI looks along the lines of <code  class="code">http://your.bugzilla.installation/path/to/bugzilla/xmlrpc.cgi</code>.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Debugging"
+>Debugging</a></h2>
+
+<p>Enable tracing at the debug level of XMLRPC requests and responses if requested.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Checking_Bugzilla&#39;s_version"
+>Checking Bugzilla&#39;s version</a></h2>
+
+<p>To make sure the Bugzilla you&#39;re connecting to supports the methods you wish to call,
+you may want to compare the result of <code  class="code">Bugzilla.version</code> to the minimum required version your application needs.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Checking_Bugzilla&#39;s_timezone"
+>Checking Bugzilla&#39;s timezone</a></h2>
+
+<p>To make sure that you understand the dates and times that Bugzilla returns to you,
+you may want to call <code  class="code">Bugzilla.timezone</code>.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Getting_Extension_Information"
+>Getting Extension Information</a></h2>
+
+<p>Returns all the information any extensions have decided to provide to the webservice.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Logging_In_and_Out"
+>Logging In and Out</a></h2>
+
+<h3><a class='u' href='#___top' title='click to go to top of document'
+name="Using_Bugzilla&#39;s_Environment_Authentication"
+>Using Bugzilla&#39;s Environment Authentication</a></h3>
+
+<p>Use a <code  class="code">http://login:password@your.bugzilla.installation/path/to/bugzilla/xmlrpc.cgi</code> style URI.
+You don&#39;t log out if you&#39;re using this kind of authentication.</p>
+
+<h3><a class='u' href='#___top' title='click to go to top of document'
+name="Using_Bugzilla&#39;s_CGI_Variable_Authentication"
+>Using Bugzilla&#39;s CGI Variable Authentication</a></h3>
+
+<p>Use the <code  class="code">User.login</code> and <code  class="code">User.logout</code> calls to log in and out,
+as shown in this script.</p>
+
+<p>The <code  class="code">Bugzilla_remember</code> parameter is optional.
+If omitted,
+Bugzilla&#39;s defaults apply (as specified by its <code  class="code">rememberlogin</code> parameter).</p>
+
+<p>Bugzilla hands back cookies you&#39;ll need to pass along during your work calls.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Retrieving_Bug_Information"
+>Retrieving Bug Information</a></h2>
+
+<p>Call <code  class="code">Bug.get</code> with the ID of the bug you want to know more of.
+The call will return a <code  class="code">Bugzilla::Bug</code> object.</p>
+
+<p>Note: You can also use &#34;Bug.get_bugs&#34; for compatibility with Bugzilla 3.0 API.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Retrieving_Product_Information"
+>Retrieving Product Information</a></h2>
+
+<p>Call <code  class="code">Product.get</code> with the name of the product you want to know more of.
+The call will return a <code  class="code">Bugzilla::Product</code> object.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Creating_A_Bug"
+>Creating A Bug</a></h2>
+
+<p>Call <code  class="code">Bug.create</code> with the settings read from the file indicated on the command line.
+The file must contain a valid anonymous hash to use as argument for the call to <code  class="code">Bug.create</code>.
+The call will return a hash with a bug id for the newly created bug.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Getting_Legal_Field_Values"
+>Getting Legal Field Values</a></h2>
+
+<p>Call <code  class="code">Bug.legal_values</code> with the name of the field (including custom select fields).
+The call will return a reference to an array with the list of legal values for this field.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Adding_a_comment_to_a_bug"
+>Adding a comment to a bug</a></h2>
+
+<p>Call <code  class="code">Bug.add_comment</code> with the bug id,
+the comment text,
+and optionally the number of hours you worked on the bug,
+and a boolean indicating if the comment is private or not.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NOTES"
+>NOTES</a></h1>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Character_Set_Encoding"
+>Character Set Encoding</a></h2>
+
+<p>Make sure that your application either uses the same character set encoding as Bugzilla does,
+or that it converts correspondingly when using the web service API.
+By default,
+Bugzilla uses UTF-8 as its character set encoding.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Format_For_Create_File"
+>Format For Create File</a></h2>
+
+<p>The create format file is a piece of Perl code,
+that should look something like this:</p>
+
+<pre  class="code">    {
+        product     =&#62; &#34;TestProduct&#34;, 
+        component   =&#62; &#34;TestComponent&#34;,
+        summary     =&#62; &#34;TestBug - created from bz_webservice_demo.pl&#34;,
+        version     =&#62; &#34;unspecified&#34;,
+        description =&#62; &#34;This is a description of the bug... hohoho&#34;,
+        op_sys      =&#62; &#34;All&#34;,
+        platform    =&#62; &#34;All&#34;,   
+        priority    =&#62; &#34;P4&#34;,
+        severity    =&#62; &#34;normal&#34;
+    };</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SEE_ALSO"
+>SEE ALSO</a></h1>
+
+<p>There are code comments in <code  class="code">bz_webservice_demo.pl</code> which might be of further help to you.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/contrib/bzdbcopy.html b/docs/en/html/api/contrib/bzdbcopy.html
new file mode 100644 (file)
index 0000000..29e343c
--- /dev/null
+++ b/docs/en/html/api/contrib/bzdbcopy.html
@@ -0,0 +1,54 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+bzdbcopy.pl</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>bzdbcopy.pl</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>bzdbcopy.pl - Copies data from one Bugzilla database to another.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>The intended use of this script is to copy data from an installation running on one DB platform to an installation running on another DB platform.</p>
+
+<p>It must be run from the directory containing your Bugzilla installation.
+That means if this script is in the contrib/ directory,
+you should be running it as: <code  class="code">./contrib/bzdbcopy.pl</code></p>
+
+<p>Note: Both schemas must already exist and be <b>IDENTICAL</b>.
+(That is,
+they must have both been created/updated by the same version of checksetup.pl.) This script will <b>DESTROY ALL CURRENT DATA</b> in the target database.</p>
+
+<p>Both Schemas must be at least from Bugzilla 2.19.3,
+but if you&#39;re running a Bugzilla from before 2.20rc2,
+you&#39;ll need the patch at: <a href="http://bugzilla.mozilla.org/show_bug.cgi?id=300311" class="podlinkurl"
+>http://bugzilla.mozilla.org/show_bug.cgi?id=300311</a> in order to be able to run this script.</p>
+
+<p>Before you using it,
+you have to correctly set all the variables in the &#34;User-Configurable Settings&#34; section at the top of the script.
+The <code  class="code">SOURCE</code> settings are for the database you&#39;re copying from,
+and the <code  class="code">TARGET</code> settings are for the database you&#39;re copying to.
+The <code  class="code">DB_TYPE</code> is the name of a DB driver from the <em  class="code">Bugzilla/DB/</em> directory.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/contrib/console.html b/docs/en/html/api/contrib/console.html
new file mode 100644 (file)
index 0000000..bd72578
--- /dev/null
+++ b/docs/en/html/api/contrib/console.html
@@ -0,0 +1,64 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+console.pl</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>console.pl</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p><b>console.pl</b> - command-line interface to Bugzilla API</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<p>$ <b>contrib/console.pl</b></p>
+
+<p>Bugzilla&#62; <b>b(5)-&#62;short_desc</b></p>
+
+<blockquote>
+<p>&#34;Misplaced Widget&#34;</p>
+</blockquote>
+
+<p>Bugzilla&#62; <b>$f = f &#34;cf_subsystem&#34;; scalar @{$f-&#62;legal_values}</b></p>
+
+<blockquote>
+<p>177</p>
+</blockquote>
+
+<p>Bugzilla&#62; <b>p filter html_light,
+&#34;1 &#60; 2 &#60;b&#62;3&#60;/b&#62;&#34;</b></p>
+
+<blockquote>
+<p>1 &#38;lt; 2 &#60;b&#62;3&#60;/b&#62;</p>
+</blockquote>
+
+<p>Bugzilla&#62; <b>$u = u 5; $u-&#62;groups; d $u</b></p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>Loads Bugzilla packages and prints expressions with Data::Dumper.
+Useful for checking results of Bugzilla API calls without opening a debug file from a cgi.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/contrib/extension-convert.html b/docs/en/html/api/contrib/extension-convert.html
new file mode 100644 (file)
index 0000000..d87b9eb
--- /dev/null
+++ b/docs/en/html/api/contrib/extension-convert.html
@@ -0,0 +1,38 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+extension-convert.pl</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>extension-convert.pl</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>extension-convert.pl - Convert extensions from the pre-3.6 format to the 3.6 format.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> contrib/extension-convert.pl name
+
+ Converts an extension in the F&#60;extensions/&#62; directory into the new
+ extension layout for Bugzilla 3.6.</pre>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/contrib/merge-users.html b/docs/en/html/api/contrib/merge-users.html
new file mode 100644 (file)
index 0000000..bd87a21
--- /dev/null
+++ b/docs/en/html/api/contrib/merge-users.html
@@ -0,0 +1,46 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+merge-users.pl</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>merge-users.pl</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>merge-users.pl - Merge two user accounts.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> This script moves activity from one user account to another.
+ Specify the two accounts on the command line, e.g.:
+
+ ./merge-users.pl old_account@foo.com new_account@bar.com
+ or:
+ ./merge-users.pl id:old_userid id:new_userid
+ or:
+ ./merge-users.pl id:old_userid new_account@bar.com
+
+ Notes: - the new account must already exist.
+        - the id:old_userid syntax permits you to migrate
+          activity from a deleted account to an existing one.</pre>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/contrib/recode.html b/docs/en/html/api/contrib/recode.html
new file mode 100644 (file)
index 0000000..d9f3cb7
--- /dev/null
+++ b/docs/en/html/api/contrib/recode.html
@@ -0,0 +1,102 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+recode.pl</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>recode.pl</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#OPTIONS'>OPTIONS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>recode.pl - Converts a database from one encoding (or multiple encodings) to UTF-8.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> contrib/recode.pl [--guess [--show-failures]] [--charset=iso-8859-2]
+                   [--overrides=file_name]
+
+  --dry-run        Don&#39;t modify the database.
+
+  --charset        Primary charset your data is currently in. This can be
+                   optionally omitted if you do --guess.
+
+  --guess          Try to guess the charset of the data.
+
+  --show-failures  If we fail to guess, show where we failed.
+
+  --overrides      Specify a file containing overrides. See --help
+                   for more info.
+
+  --help           Display detailed help.
+
+ If you aren&#39;t sure what to do, try:
+
+   contrib/recode.pl --guess --charset=cp1252</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="OPTIONS"
+>OPTIONS</a></h1>
+
+<dl>
+<dt><a name="--dry-run"
+>--dry-run</a></dt>
+
+<dd>
+<p>Don&#39;t modify the database, just print out what the conversions will be.</p>
+
+<p>recode.pl will print out a Key for each item. You can use this in the overrides file, described below.</p>
+
+<dt><a name="--guess"
+>--guess</a></dt>
+
+<dd>
+<p>If your database is in multiple different encodings, specify this switch and recode.pl will do its best to determine the original charset of the data. The detection is usually very reliable.</p>
+
+<p>If recode.pl cannot guess the charset, it will leave the data alone, unless you&#39;ve specified --charset.</p>
+
+<dt><a name="--charset=charset-name"
+>--charset=charset-name</a></dt>
+
+<dd>
+<p>If you do not specify --guess, then your database is converted from this character set into the UTF-8.</p>
+
+<p>If you have specified --guess, recode.pl will use this charset as a fallback--when it cannot guess the charset of a particular piece of data, it will guess that the data is in this charset and convert it from this charset to UTF-8.</p>
+
+<p>charset-name must be a charset that is known to perl&#39;s Encode module. To see a list of available charsets, do:</p>
+
+<p><code  class="code">perl -MEncode -e &#39;print join(&#34;\n&#34;, Encode-&#62;encodings(&#34;:all&#34;))&#39;</code></p>
+
+<dt><a name="--show-failures"
+>--show-failures</a></dt>
+
+<dd>
+<p>If --guess fails to guess a charset, print out the data it failed on.</p>
+
+<dt><a name="--overrides=file_name"
+>--overrides=file_name</a></dt>
+
+<dd>
+<p>This is a way of specifying certain encodings to override the encodings of --guess. The file is a series of lines. The line should start with the Key from --dry-run, and then a space, and then the encoding you&#39;d like to use.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/email_in.html b/docs/en/html/api/email_in.html
new file mode 100644 (file)
index 0000000..6b79d89
--- /dev/null
+++ b/docs/en/html/api/email_in.html
@@ -0,0 +1,155 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+email_in.pl</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="./../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>email_in.pl</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <ul   class='indexList indexList2'>
+    <li class='indexItem indexItem2'><a href='#Creating_a_New_Bug'>Creating a New Bug</a>
+    <li class='indexItem indexItem2'><a href='#Modifying_an_Existing_Bug'>Modifying an Existing Bug</a>
+    <ul   class='indexList indexList3'>
+      <li class='indexItem indexItem3'><a href='#Adding%2FRemoving_CCs'>Adding/Removing CCs</a>
+    </ul>
+    <li class='indexItem indexItem2'><a href='#Errors'>Errors</a>
+  </ul>
+  <li class='indexItem indexItem1'><a href='#CAUTION'>CAUTION</a>
+  <li class='indexItem indexItem1'><a href='#LIMITATIONS'>LIMITATIONS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>email_in.pl - The Bugzilla Inbound Email Interface</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<p>./email_in.pl [-vvv] [--default name=value] [--override name=value] &#60; email.txt</p>
+
+<p>Reads an email on STDIN (the standard input).</p>
+
+<p>Options:</p>
+
+<pre  class="code">   --verbose (-v)        - Make the script print more to STDERR.
+                           Specify multiple times to print even more.
+
+   --default name=value  - Specify defaults for field values, like
+                           product=TestProduct. Can be specified multiple
+                           times to specify defaults for multiple fields.
+
+   --override name=value - Override field values specified in the email,
+                           like product=TestProduct. Can be specified
+                           multiple times to override multiple fields.</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This script processes inbound email and creates a bug, or appends data to an existing bug.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Creating_a_New_Bug"
+>Creating a New Bug</a></h2>
+
+<p>The script expects to read an email with the following format:</p>
+
+<pre  class="code"> From: account@domain.com
+ Subject: Bug Summary
+
+ @product ProductName
+ @component ComponentName
+ @version 1.0
+
+ This is a bug description. It will be entered into the bug exactly as
+ written here.
+
+ It can be multiple paragraphs.
+
+ -- 
+ This is a signature line, and will be removed automatically, It will not
+ be included in the bug description.</pre>
+
+<p>For the list of valid field names for the <code  class="code">@</code> fields, including a list of which ones are required, see <a href="./Bugzilla/WebService/Bug.html#create" class="podlinkpod"
+>&#34;create&#34; in Bugzilla::WebService::Bug</a>. (Note, however, that you cannot specify <code  class="code">@description</code> as a field-- you just add a comment by adding text after the <code  class="code">@</code> fields.)</p>
+
+<p>The values for the fields can be split across multiple lines, but note that a newline will be parsed as a single space, for the value. So, for example:</p>
+
+<pre  class="code"> @summary This is a very long
+ description</pre>
+
+<p>Will be parsed as &#34;This is a very long description&#34;.</p>
+
+<p>If you specify <code  class="code">@summary</code>, it will override the summary you specify in the Subject header.</p>
+
+<p><code  class="code">account@domain.com</code> (the value of the <code  class="code">From</code> header) must be a valid Bugzilla account.</p>
+
+<p>Note that signatures must start with &#39;-- &#39;, the standard signature border.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Modifying_an_Existing_Bug"
+>Modifying an Existing Bug</a></h2>
+
+<p>Bugzilla determines what bug you want to modify in one of two ways:</p>
+
+<ul>
+<li>Your subject starts with [Bug 123456] -- then it modifies bug 123456.</li>
+
+<li>You include <code  class="code">@id 123456</code> in the first lines of the email.</li>
+</ul>
+
+<p>If you do both, <code  class="code">@id</code> takes precedence.</p>
+
+<p>You send your email in the same format as for creating a bug, except that you only specify the fields you want to change. If the very first non-blank line of the email doesn&#39;t begin with <code  class="code">@</code>, then it will be assumed that you are only adding a comment to the bug.</p>
+
+<p>Note that when updating a bug, the <code  class="code">Subject</code> header is ignored, except for getting the bug ID. If you want to change the bug&#39;s summary, you have to specify <code  class="code">@summary</code> as one of the fields to change.</p>
+
+<p>Please remember not to include any extra text in your emails, as that text will also be added as a comment. This includes any text that your email client automatically quoted and included, if this is a reply to another email.</p>
+
+<h3><a class='u' href='#___top' title='click to go to top of document'
+name="Adding/Removing_CCs"
+>Adding/Removing CCs</a></h3>
+
+<p>To add CCs, you can specify them in a comma-separated list in <code  class="code">@cc</code>.</p>
+
+<p>To remove CCs, specify them as a comma-separated list in <code  class="code">@removecc</code>.</p>
+
+<h2><a class='u' href='#___top' title='click to go to top of document'
+name="Errors"
+>Errors</a></h2>
+
+<p>If your request cannot be completed for any reason, Bugzilla will send an email back to you. If your request succeeds, Bugzilla will not send you anything.</p>
+
+<p>If any part of your request fails, all of it will fail. No partial changes will happen.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="CAUTION"
+>CAUTION</a></h1>
+
+<p>The script does not do any validation that the user is who they say they are. That is, it accepts <i>any</i> &#39;From&#39; address, as long as it&#39;s a valid Bugzilla account. So make sure that your MTA validates that the message is actually coming from who it says it&#39;s coming from, and only allow access to the inbound email system from people you trust.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="LIMITATIONS"
+>LIMITATIONS</a></h1>
+
+<p>The email interface only accepts emails that are correctly formatted per RFC2822. If you send it an incorrectly formatted message, it may behave in an unpredictable fashion.</p>
+
+<p>You cannot modify Flags through the email interface.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/extensions/create.html b/docs/en/html/api/extensions/create.html
new file mode 100644 (file)
index 0000000..6ff15e9
--- /dev/null
+++ b/docs/en/html/api/extensions/create.html
@@ -0,0 +1,38 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+extensions/create.pl</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>extensions/create.pl</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>extensions/create.pl - Create a framework for a new Bugzilla Extension.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> extensions/create.pl NAME
+
+ Creates a framework for an extension called NAME in the F&#60;extensions/&#62;
+ directory.</pre>
+<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/importxml.html b/docs/en/html/api/importxml.html
new file mode 100644 (file)
index 0000000..81df146
--- /dev/null
+++ b/docs/en/html/api/importxml.html
@@ -0,0 +1,109 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+importxml</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="./../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>importxml</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#OPTIONS'>OPTIONS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>importxml - Import bugzilla bug data from xml.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> importxml.pl [options] [file ...]</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="OPTIONS"
+>OPTIONS</a></h1>
+
+<dl>
+<dt><a name="-?"
+><b>-?</b></a></dt>
+
+<dd>
+<p>Print a brief help message and exit.</p>
+
+<dt><a name="-v"
+><b>-v</b></a></dt>
+
+<dd>
+<p>Print error and debug information. Mulltiple -v increases verbosity</p>
+
+<dt><a name="-m_--sendmail"
+><b>-m</b> <b>--sendmail</b></a></dt>
+
+<dd>
+<p>Send mail to exporter with a log of bugs imported and any errors.</p>
+
+<dt><a name="--attach_path"
+><b>--attach_path</b></a></dt>
+
+<dd>
+<p>The path to the attachment files. (Required if encoding=&#34;filename&#34; is used for attachments.)</p>
+
+<dt><a name="--bug_page"
+><b>--bug_page</b></a></dt>
+
+<dd>
+<p>The page that links to the bug on top of urlbase. Its default value is &#34;show_bug.cgi?id=&#34;, which is what Bugzilla installations use. You only need to pass this argument if you are importing bugs from another bug tracking system.</p>
+
+<dt><a name="--product=name"
+><b>--product=name</b></a></dt>
+
+<dd>
+<p>The product to put the bug in if the product specified in the XML doesn&#39;t exist.</p>
+
+<dt><a name="--component=name"
+><b>--component=name</b></a></dt>
+
+<dd>
+<p>The component to put the bug in if the component specified in the XML doesn&#39;t exist.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<pre  class="code">     This script is used to import bugs from another installation of bugzilla.
+     It can be used in two ways.
+     First using the move function of bugzilla
+     on another system will send mail to an alias provided by
+     the administrator of the target installation (you). Set up an alias
+     similar to the one given below so this mail will be automatically 
+     run by this script and imported into your database.  Run &#39;newaliases&#39;
+     after adding this alias to your aliases file. Make sure your sendmail
+     installation is configured to allow mail aliases to execute code. 
+
+     bugzilla-import: &#34;|/usr/bin/perl /opt/bugzilla/importxml.pl --mail&#34;
+
+     Second it can be run from the command line with any xml file from 
+     STDIN that conforms to the bugzilla DTD. In this case you can pass 
+     an argument to set whether you want to send the
+     mail that will be sent to the exporter and maintainer normally.
+
+     importxml.pl [options] bugsfile.xml</pre>
+<p class="backlinkbottom"><b><a name="___bottom" href="index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/index.html b/docs/en/html/api/index.html
new file mode 100644 (file)
index 0000000..420d2fb
--- /dev/null
+++ b/docs/en/html/api/index.html
@@ -0,0 +1,373 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+    <title>Bugzilla 4.4 API Documentation</title>
+  
+<link rel="stylesheet" title="style" type="text/css" href="./../../../style.css" media="all" >
+
+</head>
+  <body class="contentspage">
+    <h1>Bugzilla 4.4 API Documentation</h1>
+<dl class='superindex'>
+<dt><a name="Extensions">Extensions</a></dt>
+<dd>
+<table class="pod_desc_table">
+<tr class="even">
+  <th><a href="./extensions/create.html">extensions::create</a></th>
+  <td>Create a framework for a new Bugzilla Extension.</td>
+</tr>
+</table></dd>
+
+<dt><a name="Files">Files</a></dt>
+<dd>
+<table class="pod_desc_table">
+<tr class="even">
+  <th><a href="./checksetup.html">checksetup</a></th>
+  <td>A do-it-all upgrade and installation script for Bugzilla.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./collectstats.html">collectstats</a></th>
+  <td>Collect data about Bugzilla bugs.</td>
+</tr>
+<tr class="even">
+  <th><a href="./contrib/bz_webservice_demo.html">contrib::bz_webservice_demo</a></th>
+  <td>Show how to talk to Bugzilla via XMLRPC</td>
+</tr>
+<tr class="odd">
+  <th><a href="./contrib/bzdbcopy.html">contrib::bzdbcopy</a></th>
+  <td>Copies data from one Bugzilla database to another.</td>
+</tr>
+<tr class="even">
+  <th><a href="./contrib/console.html">contrib::console</a></th>
+  <td>command-line interface to Bugzilla API</td>
+</tr>
+<tr class="odd">
+  <th><a href="./contrib/extension-convert.html">contrib::extension-convert</a></th>
+  <td>Convert extensions from the pre-3.6 format to the 3.6 format.</td>
+</tr>
+<tr class="even">
+  <th><a href="./contrib/merge-users.html">contrib::merge-users</a></th>
+  <td>Merge two user accounts.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./contrib/recode.html">contrib::recode</a></th>
+  <td>Converts a database from one encoding (or multiple encodings) to UTF-8.</td>
+</tr>
+<tr class="even">
+  <th><a href="./email_in.html">email_in</a></th>
+  <td>The Bugzilla Inbound Email Interface</td>
+</tr>
+<tr class="odd">
+  <th><a href="./importxml.html">importxml</a></th>
+  <td>Import bugzilla bug data from xml.</td>
+</tr>
+<tr class="even">
+  <th><a href="./install-module.html">install-module</a></th>
+  <td>Installs or upgrades modules from CPAN. This script does not run on Windows.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./jobqueue.html">jobqueue</a></th>
+  <td>Runs jobs in the background for Bugzilla.</td>
+</tr>
+<tr class="even">
+  <th><a href="./migrate.html">migrate</a></th>
+  <td>A script to migrate from other bug-trackers to Bugzilla.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./sanitycheck.html">sanitycheck</a></th>
+  <td>Perl script to perform a sanity check at the command line</td>
+</tr>
+</table></dd>
+
+<dt><a name="Modules">Modules</a></dt>
+<dd>
+<table class="pod_desc_table">
+<tr class="even">
+  <th><a href="./Bugzilla.html">Bugzilla</a></th>
+  <td>Semi-persistent collection of various objects used by scripts and modules</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Attachment.html">Bugzilla::Attachment</a></th>
+  <td>Bugzilla attachment class.</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Auth.html">Bugzilla::Auth</a></th>
+  <td>An object that authenticates the login credentials for a user.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Auth/Login.html">Bugzilla::Auth::Login</a></th>
+  <td>Gets username/password data from the user.</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Auth/Verify.html">Bugzilla::Auth::Verify</a></th>
+  <td>An object that verifies usernames and passwords.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/CGI.html">Bugzilla::CGI</a></th>
+  <td>CGI handling for Bugzilla</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Classification.html">Bugzilla::Classification</a></th>
+  <td>Bugzilla classification class.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Comment.html">Bugzilla::Comment</a></th>
+  <td>A Comment for a given bug</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Component.html">Bugzilla::Component</a></th>
+  <td>Bugzilla product component class.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Config.html">Bugzilla::Config</a></th>
+  <td>Configuration parameters for Bugzilla</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Config/Common.html">Bugzilla::Config::Common</a></th>
+  <td>Parameter checking functions</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/DB.html">Bugzilla::DB</a></th>
+  <td>Database access routines, using DBI</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/DB/Mysql.html">Bugzilla::DB::Mysql</a></th>
+  <td>Bugzilla database compatibility layer for MySQL</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/DB/Oracle.html">Bugzilla::DB::Oracle</a></th>
+  <td>Bugzilla database compatibility layer for Oracle</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/DB/Pg.html">Bugzilla::DB::Pg</a></th>
+  <td>Bugzilla database compatibility layer for PostgreSQL</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/DB/Schema.html">Bugzilla::DB::Schema</a></th>
+  <td>Abstract database schema for Bugzilla</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/DB/Sqlite.html">Bugzilla::DB::Sqlite</a></th>
+  <td>Bugzilla database compatibility layer for SQLite</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Error.html">Bugzilla::Error</a></th>
+  <td>Error handling utilities for Bugzilla</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Extension.html">Bugzilla::Extension</a></th>
+  <td>Base class for Bugzilla Extensions.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Field.html">Bugzilla::Field</a></th>
+  <td>a particular piece of information about bugs and useful routines for form field manipulation</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Field/Choice.html">Bugzilla::Field::Choice</a></th>
+  <td>A legal value for a &#60;select&#62;-type field.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Field/ChoiceInterface.html">Bugzilla::Field::ChoiceInterface</a></th>
+  <td>Makes an object act like a Bugzilla::Field::Choice.</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Flag.html">Bugzilla::Flag</a></th>
+  <td>A module to deal with Bugzilla flag values.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/FlagType.html">Bugzilla::FlagType</a></th>
+  <td>A module to deal with Bugzilla flag types.</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Group.html">Bugzilla::Group</a></th>
+  <td>Bugzilla group class.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Hook.html">Bugzilla::Hook</a></th>
+  <td>Extendable extension hooks for Bugzilla code</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Install.html">Bugzilla::Install</a></th>
+  <td>Functions and variables having to do with installation.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Install/CPAN.html">Bugzilla::Install::CPAN</a></th>
+  <td>Routines to install Perl modules from CPAN.</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Install/DB.html">Bugzilla::Install::DB</a></th>
+  <td>Fix up the database during installation.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Install/Filesystem.html">Bugzilla::Install::Filesystem</a></th>
+  <td>Fix up the filesystem during installation.</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Install/Localconfig.html">Bugzilla::Install::Localconfig</a></th>
+  <td></td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Install/Requirements.html">Bugzilla::Install::Requirements</a></th>
+  <td>Functions and variables dealing with Bugzilla&#39;s perl-module requirements.</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Install/Util.html">Bugzilla::Install::Util</a></th>
+  <td>Utility functions that are useful both during installation and afterwards.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/JobQueue.html">Bugzilla::JobQueue</a></th>
+  <td>Interface between Bugzilla and TheSchwartz.</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/JobQueue/Runner.html">Bugzilla::JobQueue::Runner</a></th>
+  <td>A class representing the daemon that runs the job queue.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Keyword.html">Bugzilla::Keyword</a></th>
+  <td>A Keyword that can be added to a bug.</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Migrate.html">Bugzilla::Migrate</a></th>
+  <td>Functions to migrate from other databases</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Milestone.html">Bugzilla::Milestone</a></th>
+  <td>Bugzilla product milestone class.</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Object.html">Bugzilla::Object</a></th>
+  <td>A base class for objects in Bugzilla.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Product.html">Bugzilla::Product</a></th>
+  <td>Bugzilla product class.</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Report.html">Bugzilla::Report</a></th>
+  <td>Bugzilla report class.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Search.html">Bugzilla::Search</a></th>
+  <td>Provides methods to run queries against bugs.</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Search/Recent.html">Bugzilla::Search::Recent</a></th>
+  <td>A search recently run by a logged-in user.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Search/Saved.html">Bugzilla::Search::Saved</a></th>
+  <td>A saved search</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Status.html">Bugzilla::Status</a></th>
+  <td>Bug status class.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Template.html">Bugzilla::Template</a></th>
+  <td>Wrapper around the Template Toolkit Template object</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Template/Plugin/Bugzilla.html">Bugzilla::Template::Plugin::Bugzilla</a></th>
+  <td></td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Template/Plugin/Hook.html">Bugzilla::Template::Plugin::Hook</a></th>
+  <td></td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Token.html">Bugzilla::Token</a></th>
+  <td>Provides different routines to manage tokens.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Update.html">Bugzilla::Update</a></th>
+  <td>Update routines for Bugzilla</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/User.html">Bugzilla::User</a></th>
+  <td>Object for a Bugzilla user</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/User/Setting.html">Bugzilla::User::Setting</a></th>
+  <td>Object for a user preference setting</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/User/Setting/Lang.html">Bugzilla::User::Setting::Lang</a></th>
+  <td>Object for a user preference setting for preferred language</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/User/Setting/Skin.html">Bugzilla::User::Setting::Skin</a></th>
+  <td>Object for a user preference setting for skins</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/User/Setting/Timezone.html">Bugzilla::User::Setting::Timezone</a></th>
+  <td>Object for a user preference setting for desired timezone</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/UserAgent.html">Bugzilla::UserAgent</a></th>
+  <td>UserAgent utilities for Bugzilla</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Util.html">Bugzilla::Util</a></th>
+  <td>Generic utility functions for bugzilla</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Version.html">Bugzilla::Version</a></th>
+  <td>Bugzilla product version class.</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/WebService.html">Bugzilla::WebService</a></th>
+  <td>The Web Service interface to Bugzilla</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/WebService/Bug.html">Bugzilla::WebService::Bug</a></th>
+  <td>The API for creating, changing, and getting the details of bugs.</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/WebService/Bugzilla.html">Bugzilla::WebService::Bugzilla</a></th>
+  <td>Global functions for the webservice interface.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/WebService/Classification.html">Bugzilla::WebService::Classification</a></th>
+  <td>The Classification API</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/WebService/Group.html">Bugzilla::WebService::Group</a></th>
+  <td>The API for creating, changing, and getting information about Groups.</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/WebService/Product.html">Bugzilla::WebService::Product</a></th>
+  <td>The Product API</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/WebService/Server/JSONRPC.html">Bugzilla::WebService::Server::JSONRPC</a></th>
+  <td>The JSON-RPC Interface to Bugzilla</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/WebService/Server/XMLRPC.html">Bugzilla::WebService::Server::XMLRPC</a></th>
+  <td>The XML-RPC Interface to Bugzilla</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/WebService/User.html">Bugzilla::WebService::User</a></th>
+  <td>The User Account and Login API</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/WebService/Util.html">Bugzilla::WebService::Util</a></th>
+  <td></td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Whine.html">Bugzilla::Whine</a></th>
+  <td>A Whine event</td>
+</tr>
+<tr class="odd">
+  <th><a href="./Bugzilla/Whine/Query.html">Bugzilla::Whine::Query</a></th>
+  <td>A query object used by Bugzilla::Whine.</td>
+</tr>
+<tr class="even">
+  <th><a href="./Bugzilla/Whine/Schedule.html">Bugzilla::Whine::Schedule</a></th>
+  <td>A schedule object used by Bugzilla::Whine.</td>
+</tr>
+</table></dd>
+
+</dl>
+</body></html>
\ No newline at end of file

diff --git a/docs/en/html/api/install-module.html b/docs/en/html/api/install-module.html
new file mode 100644 (file)
index 0000000..031ef67
--- /dev/null
+++ b/docs/en/html/api/install-module.html
@@ -0,0 +1,98 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+install-module.pl</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="./../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>install-module.pl</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#OPTIONS'>OPTIONS</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>install-module.pl - Installs or upgrades modules from CPAN.
+This script does not run on Windows.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code">  ./install-module.pl Module::Name [--global]
+  ./install-module.pl --all [--global]
+  ./install-module.pl --upgrade-all [--global]
+  ./install-module.pl --show-config
+  ./install-module.pl --shell
+
+  Do &#34;./install-module.pl --help&#34; for more information.</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="OPTIONS"
+>OPTIONS</a></h1>
+
+<dl>
+<dt><a name="Module::Name"
+><b>Module::Name</b></a></dt>
+
+<dd>
+<p>The name of a module that you want to install from CPAN. This is the same thing that you&#39;d give to the <code  class="code">install</code> command in the CPAN shell.</p>
+
+<p>You can specify multiple module names separated by a space to install multiple modules.</p>
+
+<dt><a name="--global"
+><b>--global</b></a></dt>
+
+<dd>
+<p>This makes install-module install modules globally for all applications, instead of just for Bugzilla.</p>
+
+<p>On most systems, you have to be root for <code  class="code">--global</code> to work.</p>
+
+<dt><a name="--all"
+><b>--all</b></a></dt>
+
+<dd>
+<p>This will make install-module do its best to install every required and optional module that is not installed that Bugzilla can use.</p>
+
+<p>Some modules may fail to install. You can run checksetup.pl to see which installed properly.</p>
+
+<dt><a name="--upgrade-all"
+><b>--upgrade-all</b></a></dt>
+
+<dd>
+<p>This is like <code  class="code">--all</code>, except it forcibly installs the very latest version of every Bugzilla prerequisite, whether or not you already have them installed.</p>
+
+<dt><a name="--show-config"
+><b>--show-config</b></a></dt>
+
+<dd>
+<p>Prints out the CPAN configuration in raw Perl format. Useful for debugging.</p>
+
+<dt><a name="--shell"
+><b>--shell</b></a></dt>
+
+<dd>
+<p>Starts a CPAN shell using the configuration of <em  class="code">install-module.pl</em>.</p>
+
+<dt><a name="--help"
+><b>--help</b></a></dt>
+
+<dd>
+<p>Shows this help.</p>
+</dd>
+</dl>
+<p class="backlinkbottom"><b><a name="___bottom" href="index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/jobqueue.html b/docs/en/html/api/jobqueue.html
new file mode 100644 (file)
index 0000000..0be1404
--- /dev/null
+++ b/docs/en/html/api/jobqueue.html
@@ -0,0 +1,80 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+jobqueue.pl</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="./../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>jobqueue.pl</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+  <li class='indexItem indexItem1'><a href='#Running_jobqueue.pl_as_a_System_Service'>Running jobqueue.pl as a System Service</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>jobqueue.pl - Runs jobs in the background for Bugzilla.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> ./jobqueue.pl [OPTIONS] COMMAND
+
+   OPTIONS:
+   -f        Run in the foreground (don&#39;t detach)
+   -d        Output a lot of debugging information
+   -p file   Specify the file where jobqueue.pl should store its current
+             process id. Defaults to F&#60;data/jobqueue.pl.pid&#62;.
+   -n name   What should this process call itself in the system log?
+             Defaults to the full path you used to invoke the script.
+
+   COMMANDS:
+   start     Starts a new jobqueue daemon if there isn&#39;t one running already
+   stop      Stops a running jobqueue daemon
+   restart   Stops a running jobqueue if one is running, and then
+             starts a new one.
+   once      Checks the job queue once, executes the first item found (if
+             any) and then exits
+   onepass   Checks the job queue, executes all items found, and then exits
+   check     Report the current status of the daemon.
+   install   On some *nix systems, this automatically installs and
+             configures jobqueue.pl as a system service so that it will
+             start every time the machine boots.
+   uninstall Removes the system service for jobqueue.pl.
+   help      Display this usage info
+   version   Display the version of jobqueue.pl</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>See <a href="./Bugzilla/JobQueue.html" class="podlinkpod"
+>Bugzilla::JobQueue</a> and <a href="./Bugzilla/JobQueue/Runner.html" class="podlinkpod"
+>Bugzilla::JobQueue::Runner</a>.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="Running_jobqueue.pl_as_a_System_Service"
+>Running jobqueue.pl as a System Service</a></h1>
+
+<p>For systems that use Upstart or SysV Init, there is a SysV/Upstart init script included with Bugzilla for jobqueue.pl: <em  class="code">contrib/bugzilla-queue</em>. It should work out-of-the-box on RHEL, Fedora, CentOS etc.</p>
+
+<p>You can install it by doing <code  class="code">./jobqueue.pl install</code> as root, after already having run <a href="./checksetup.html" class="podlinkpod"
+>checksetup</a> at least once to completion on this Bugzilla installation.</p>
+
+<p>If you are using a system that isn&#39;t RHEL, Fedora, CentOS, etc., then you may have to modify <em  class="code">contrib/bugzilla-queue</em> and install it yourself manually in order to get <code  class="code">jobqueue.pl</code> running as a system service.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/migrate.html b/docs/en/html/api/migrate.html
new file mode 100644 (file)
index 0000000..667d984
--- /dev/null
+++ b/docs/en/html/api/migrate.html
@@ -0,0 +1,78 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+migrate.pl</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="./../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>migrate.pl</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#OPTIONS'>OPTIONS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>migrate.pl - A script to migrate from other bug-trackers to Bugzilla.</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> ./migrate.pl --from=&#60;tracker&#62; [--verbose] [--dry-run]
+
+ Migrates from another bug-tracker to Bugzilla. If you want
+ to upgrade Bugzilla, use checksetup.pl instead.
+
+ Always test this on a backup copy of your database before
+ running it on your live Bugzilla.</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="OPTIONS"
+>OPTIONS</a></h1>
+
+<dl>
+<dt><a name="--from=tracker"
+><b>--from=tracker</b></a></dt>
+
+<dd>
+<p>Specifies what bug-tracker you&#39;re migrating from. To see what values are valid, see the contents of the <em  class="code">Bugzilla/Migrate/</em> directory.</p>
+
+<dt><a name="--dry-run"
+><b>--dry-run</b></a></dt>
+
+<dd>
+<p>Don&#39;t modify the Bugzilla database at all, just test the import. Note that this could cause significant slowdown and other strange effects on a live Bugzilla, so only use it on a test instance.</p>
+
+<dt><a name="--verbose"
+><b>--verbose</b></a></dt>
+
+<dd>
+<p>If specified, this script will output extra debugging information to STDERR. Specify multiple times (up to three) for more information.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This script copies data from another bug-tracker into Bugzilla. It migrates users, products, and bugs from the other bug-tracker into this Bugzilla, without removing any of the data currently in this Bugzilla.</p>
+
+<p>Note that you will need enough space in your temporary directory to hold the size of all attachments in your current bug-tracker.</p>
+
+<p>You may also need to increase the number of file handles a process is allowed to hold open (as the migrator will create a file handle for each attachment in your database). On Linux and simliar systems, you can do this as root by typing <code  class="code">ulimit -n 65535</code> before running your script.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/api/sanitycheck.html b/docs/en/html/api/sanitycheck.html
new file mode 100644 (file)
index 0000000..b52ed32
--- /dev/null
+++ b/docs/en/html/api/sanitycheck.html
@@ -0,0 +1,69 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>
+sanitycheck.pl</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="stylesheet" title="style" type="text/css" href="./../../../style.css" media="all" >
+
+</head>
+  <body id="pod">
+<p class="backlinktop"><b><a name="___top" href="index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
+<h1>sanitycheck.pl</h1>
+<div class='indexgroup'>
+<ul   class='indexList indexList1'>
+  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
+  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
+  <li class='indexItem indexItem1'><a href='#OPTIONS'>OPTIONS</a>
+  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
+</ul>
+</div>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="NAME"
+>NAME</a></h1>
+
+<p>sanitycheck.pl - Perl script to perform a sanity check at the command line</p>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="SYNOPSIS"
+>SYNOPSIS</a></h1>
+
+<pre  class="code"> ./sanitycheck.pl [--help]
+ ./sanitycheck.pl [--verbose] --login &#60;user@domain.com&#62;</pre>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="OPTIONS"
+>OPTIONS</a></h1>
+
+<dl>
+<dt><a name="--help"
+><b>--help</b></a></dt>
+
+<dd>
+<p>Displays this help text</p>
+
+<dt><a name="--verbose"
+><b>--verbose</b></a></dt>
+
+<dd>
+<p>Causes this script to be more verbose in its output. Without this option, the script will return only errors. With the option, the script will append all output to the email.</p>
+
+<dt><a name="--login"
+><b>--login</b></a></dt>
+
+<dd>
+<p>This should be passed the email address of a user that is capable of running the Sanity Check process, a user with the editcomponents priv. This user will receive an email with the results of the script run.</p>
+</dd>
+</dl>
+
+<h1><a class='u' href='#___top' title='click to go to top of document'
+name="DESCRIPTION"
+>DESCRIPTION</a></h1>
+
+<p>This script provides a way of running a &#39;Sanity Check&#39; on the database via either a CLI or cron. It is equivalent to calling sanitycheck.cgi via a web browser.</p>
+<p class="backlinkbottom"><b><a name="___bottom" href="index.html" title="All Documents">&lt;&lt;</a></b></p>
+
+<!-- end doc -->
+
+</body></html>

diff --git a/docs/en/html/attachments.html b/docs/en/html/attachments.html
new file mode 100644 (file)
index 0000000..cef7a29
--- /dev/null
+++ b/docs/en/html/attachments.html
@@ -0,0 +1,61 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>5.7. Attachments</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="prev" href="bugreports.html" title="5.6. Filing Bugs"><link rel="next" href="hintsandtips.html" title="5.8. Hints and Tips"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.7. Attachments</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="bugreports.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Using Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="hintsandtips.html">Next</a></td></tr></table><hr></div><div class="section" title="5.7. Attachments"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="attachments"></a>5.7. Attachments</h2></div></div></div><p>
+      You should use attachments, rather than comments, for large chunks of ASCII
+      data, such as trace, debugging output files, or log files. That way, it
+      doesn't bloat the bug for everyone who wants to read it, and cause people to
+      receive fat, useless mails.
+    </p><p>You should make sure to trim screenshots. There's no need to show the
+      whole screen if you are pointing out a single-pixel problem.
+    </p><p>Bugzilla stores and uses a Content-Type for each attachment
+      (e.g. text/html). To download an attachment as a different
+      Content-Type (e.g. application/xhtml+xml), you can override this
+      using a 'content_type' parameter on the URL, e.g.
+      <code class="filename">&amp;content_type=text/plain</code>.
+    </p><p>
+      Also, you can enter the URL pointing to the attachment instead of
+      uploading the attachment itself. For example, this is useful if you want to
+      point to an external application, a website or a very large file. Note that
+      there is no guarantee that the source file will always be available, nor
+      that its content will remain unchanged.
+    </p><p>
+      Another way to attach data is to paste text directly in the text field,
+      and Bugzilla will convert it into an attachment. This is pretty useful
+      when you do copy and paste, and you don't want to put the text in a temporary
+      file first.
+    </p><div class="section" title="5.7.1. Patch Viewer"><div class="titlepage"><div><div><h3 class="title"><a name="patchviewer"></a>5.7.1. Patch Viewer</h3></div></div></div><p>Viewing and reviewing patches in Bugzilla is often difficult due to
+      lack of context, improper format and the inherent readability issues that
+      raw patches present.  Patch Viewer is an enhancement to Bugzilla designed
+      to fix that by offering increased context, linking to sections, and
+      integrating with Bonsai, LXR and CVS.</p><p>Patch viewer allows you to:</p><table border="0" summary="Simple list" class="simplelist"><tr><td>View patches in color, with side-by-side view rather than trying
+        to interpret the contents of the patch.</td></tr><tr><td>See the difference between two patches.</td></tr><tr><td>Get more context in a patch.</td></tr><tr><td>Collapse and expand sections of a patch for easy
+        reading.</td></tr><tr><td>Link to a particular section of a patch for discussion or
+        review</td></tr><tr><td>Go to Bonsai or LXR to see more context, blame, and
+        cross-references for the part of the patch you are looking at</td></tr><tr><td>Create a rawtext unified format diff out of any patch, no
+        matter what format it came from</td></tr></table><div class="section" title="5.7.1.1. Viewing Patches in Patch Viewer"><div class="titlepage"><div><div><h4 class="title"><a name="patchviewer_view"></a>5.7.1.1. Viewing Patches in Patch Viewer</h4></div></div></div><p>The main way to view a patch in patch viewer is to click on the
+        "Diff" link next to a patch in the Attachments list on a bug. You may
+        also do this within the edit window by clicking the "View Attachment As
+        Diff" button in the Edit Attachment screen.</p></div><div class="section" title="5.7.1.2. Seeing the Difference Between Two Patches"><div class="titlepage"><div><div><h4 class="title"><a name="patchviewer_diff"></a>5.7.1.2. Seeing the Difference Between Two Patches</h4></div></div></div><p>To see the difference between two patches, you must first view the
+        newer patch in Patch Viewer.  Then select the older patch from the
+        dropdown at the top of the page ("Differences between [dropdown] and
+        this patch") and click the "Diff" button. This will show you what
+        is new or changed in the newer patch.</p></div><div class="section" title="5.7.1.3. Getting More Context in a Patch"><div class="titlepage"><div><div><h4 class="title"><a name="patchviewer_context"></a>5.7.1.3. Getting More Context in a Patch</h4></div></div></div><p>To get more context in a patch, you put a number in the textbox at
+        the top of Patch Viewer ("Patch / File / [textbox]") and hit enter.
+        This will give you that many lines of context before and after each
+        change. Alternatively, you can click on the "File" link there and it
+        will show each change in the full context of the file. This feature only
+        works against files that were diffed using "cvs diff".</p></div><div class="section" title="5.7.1.4. Collapsing and Expanding Sections of a Patch"><div class="titlepage"><div><div><h4 class="title"><a name="patchviewer_collapse"></a>5.7.1.4. Collapsing and Expanding Sections of a Patch</h4></div></div></div><p>To view only a certain set of files in a patch (for example, if a
+        patch is absolutely huge and you want to only review part of it at a
+        time), you can click the "(+)" and "(-)" links next to each file (to
+        expand it or collapse it). If you want to collapse all files or expand
+        all files, you can click the "Collapse All" and "Expand All" links at the
+        top of the page.</p></div><div class="section" title="5.7.1.5. Linking to a Section of a Patch"><div class="titlepage"><div><div><h4 class="title"><a name="patchviewer_link"></a>5.7.1.5. Linking to a Section of a Patch</h4></div></div></div><p>To link to a section of a patch (for example, if you want to be
+        able to give someone a URL to show them which part you are talking
+        about) you simply click the "Link Here" link on the section header. The
+        resulting URL can be copied and used in discussion.</p></div><div class="section" title="5.7.1.6. Going to Bonsai and LXR"><div class="titlepage"><div><div><h4 class="title"><a name="patchviewer_bonsai_lxr"></a>5.7.1.6. Going to Bonsai and LXR</h4></div></div></div><p>To go to Bonsai to get blame for the lines you are interested in,
+        you can click the "Lines XX-YY" link on the section header you are
+        interested in. This works even if the patch is against an old
+        version of the file, since Bonsai stores all versions of the file.</p><p>To go to LXR, you click on the filename on the file header
+        (unfortunately, since LXR only does the most recent version, line
+        numbers are likely to rot).</p></div><div class="section" title="5.7.1.7. Creating a Unified Diff"><div class="titlepage"><div><div><h4 class="title"><a name="patchviewer_unified_diff"></a>5.7.1.7. Creating a Unified Diff</h4></div></div></div><p>If the patch is not in a format that you like, you can turn it
+        into a unified diff format by clicking the "Raw Unified" link at the top
+        of the page.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="bugreports.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="using.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="hintsandtips.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5.6. Filing Bugs </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 5.8. Hints and Tips</td></tr></table></div></body></html>

diff --git a/docs/en/html/bug_page.html b/docs/en/html/bug_page.html
new file mode 100644 (file)
index 0000000..5b8039f
--- /dev/null
+++ b/docs/en/html/bug_page.html
@@ -0,0 +1,130 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>5.3. Anatomy of a Bug</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="prev" href="myaccount.html" title="5.2. Create a Bugzilla Account"><link rel="next" href="lifecycle.html" title="5.4. Life Cycle of a Bug"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.3. Anatomy of a Bug</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="myaccount.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Using Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="lifecycle.html">Next</a></td></tr></table><hr></div><div class="section" title="5.3. Anatomy of a Bug"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="bug_page"></a>5.3. Anatomy of a Bug</h2></div></div></div><p>The core of Bugzilla is the screen which displays a particular
+    bug. It's a good place to explain some Bugzilla concepts. 
+    <a class="ulink" href="http://landfill.bugzilla.org/bugzilla-tip/show_bug.cgi?id=1" target="_top">
+    Bug 1 on Landfill</a>
+
+    is a good example. Note that the labels for most fields are hyperlinks;
+    clicking them will take you to context-sensitive help on that
+    particular field. Fields marked * may not be present on every
+    installation of Bugzilla.</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+          <span class="emphasis"><em>Product and Component</em></span>: 
+          Bugs are divided up by Product and Component, with a Product
+          having one or more Components in it. For example,
+          bugzilla.mozilla.org's "Bugzilla" Product is composed of several
+          Components:
+          </p><div class="variablelist"><dl><dt><span class="term">Administration:</span></dt><dd><p>
+                  Administration of a Bugzilla installation.
+                </p></dd><dt><span class="term">Bugzilla-General:</span></dt><dd><p>
+                  Anything that doesn't fit in the other components, or spans
+                  multiple components.
+                </p></dd><dt><span class="term">Creating/Changing Bugs:</span></dt><dd><p>
+                  Creating, changing, and viewing bugs.
+                </p></dd><dt><span class="term">Documentation:</span></dt><dd><p>
+                  The Bugzilla documentation, including The Bugzilla Guide.
+                </p></dd><dt><span class="term">Email:</span></dt><dd><p>
+                  Anything to do with email sent by Bugzilla.
+                </p></dd><dt><span class="term">Installation:</span></dt><dd><p>
+                  The installation process of Bugzilla.
+                </p></dd><dt><span class="term">Query/Buglist:</span></dt><dd><p>
+                  Anything to do with searching for bugs and viewing the
+                  buglists.
+                </p></dd><dt><span class="term">Reporting/Charting:</span></dt><dd><p>
+                  Getting reports from Bugzilla.
+                </p></dd><dt><span class="term">User Accounts:</span></dt><dd><p>
+                  Anything about managing a user account from the user's perspective.
+                  Saved queries, creating accounts, changing passwords, logging in,
+                  etc.
+                </p></dd><dt><span class="term">User Interface:</span></dt><dd><p>
+                  General issues having to do with the user interface cosmetics (not
+                  functionality) including cosmetic issues, HTML templates,
+                  etc.
+                </p></dd></dl></div><p>
+        </p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Status and Resolution:</em></span>
+
+        These define exactly what state the bug is in - from not even
+        being confirmed as a bug, through to being fixed and the fix
+        confirmed by Quality Assurance. The different possible values for
+        Status and Resolution on your installation should be documented in the
+        context-sensitive help for those items.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Assigned To:</em></span>
+        The person responsible for fixing the bug.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>*QA Contact:</em></span>
+        The person responsible for quality assurance on this bug.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>*URL:</em></span>
+        A URL associated with the bug, if any.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Summary:</em></span>
+        A one-sentence summary of the problem.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>*Status Whiteboard:</em></span>
+        (a.k.a. Whiteboard) A free-form text area for adding short notes
+        and tags to a bug.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>*Keywords:</em></span>
+        The administrator can define keywords which you can use to tag and
+        categorise bugs - e.g. The Mozilla Project has keywords like crash
+        and regression.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Platform and OS:</em></span>
+        These indicate the computing environment where the bug was
+        found.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Version:</em></span>
+        The "Version" field is usually used for versions of a product which
+        have been released, and is set to indicate which versions of a
+        Component have the particular problem the bug report is
+        about.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Priority:</em></span>
+        The bug assignee uses this field to prioritize his or her bugs.
+        It's a good idea not to change this on other people's bugs.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Severity:</em></span>
+        This indicates how severe the problem is - from blocker
+        ("application unusable") to trivial ("minor cosmetic issue"). You
+        can also use this field to indicate whether a bug is an enhancement
+        request.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>*Target:</em></span>
+        (a.k.a. Target Milestone) A future version by which the bug is to
+        be fixed. e.g. The Bugzilla Project's milestones for future
+        Bugzilla versions are 2.18, 2.20, 3.0, etc. Milestones are not
+        restricted to numbers, thought - you can use any text strings, such
+        as dates.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Reporter:</em></span>
+        The person who filed the bug.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>CC list:</em></span>
+        A list of people who get mail when the bug changes.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>*Time Tracking:</em></span>
+        This form can be used for time tracking.
+        To use this feature, you have to be blessed group membership
+        specified by the <span class="quote">“<span class="quote">timetrackinggroup</span>”</span> parameter.
+        </p><div class="variablelist"><dl><dt><span class="term">Orig. Est.:</span></dt><dd><p>
+                This field shows the original estimated time.
+              </p></dd><dt><span class="term">Current Est.:</span></dt><dd><p>
+                This field shows the current estimated time.
+                This number is calculated from <span class="quote">“<span class="quote">Hours Worked</span>”</span>
+                and <span class="quote">“<span class="quote">Hours Left</span>”</span>.
+              </p></dd><dt><span class="term">Hours Worked:</span></dt><dd><p>
+                This field shows the number of hours worked.
+              </p></dd><dt><span class="term">Hours Left:</span></dt><dd><p>
+                This field shows the <span class="quote">“<span class="quote">Current Est.</span>”</span> -
+                <span class="quote">“<span class="quote">Hours Worked</span>”</span>.
+                This value + <span class="quote">“<span class="quote">Hours Worked</span>”</span> will become the
+                new Current Est.
+              </p></dd><dt><span class="term">%Complete:</span></dt><dd><p>
+                This field shows what percentage of the task is complete.
+              </p></dd><dt><span class="term">Gain:</span></dt><dd><p>
+                This field shows the number of hours that the bug is ahead of the
+              <span class="quote">“<span class="quote">Orig. Est.</span>”</span>.
+              </p></dd><dt><span class="term">Deadline:</span></dt><dd><p>
+                This field shows the deadline for this bug.
+              </p></dd></dl></div><p>
+        </p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Attachments:</em></span>
+          You can attach files (e.g. testcases or patches) to bugs. If there
+          are any attachments, they are listed in this section.
+        </p></li><li class="listitem"><p>
+        <span class="emphasis"><em>*Dependencies:</em></span>
+        If this bug cannot be fixed unless other bugs are fixed (depends
+        on), or this bug stops other bugs being fixed (blocks), their
+        numbers are recorded here.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>*Votes:</em></span>
+        Whether this bug has any votes.</p></li><li class="listitem"><p>
+        <span class="emphasis"><em>Additional Comments:</em></span>
+        You can add your two cents to the bug discussion here, if you have
+        something worthwhile to say.</p></li></ol></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="myaccount.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="using.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="lifecycle.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5.2. Create a Bugzilla Account </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 5.4. Life Cycle of a Bug</td></tr></table></div></body></html>

diff --git a/docs/en/html/bug_status_workflow.html b/docs/en/html/bug_status_workflow.html
new file mode 100644 (file)
index 0000000..90669b0
--- /dev/null
+++ b/docs/en/html/bug_status_workflow.html
@@ -0,0 +1,16 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.12. Bug Status Workflow</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="edit-values.html" title="3.11. Legal Values"><link rel="next" href="voting.html" title="3.13. Voting"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.12. Bug Status Workflow</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="edit-values.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="voting.html">Next</a></td></tr></table><hr></div><div class="section" title="3.12. Bug Status Workflow"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="bug_status_workflow"></a>3.12. Bug Status Workflow</h2></div></div></div><p>
+      The bug status workflow is no longer hardcoded but can be freely customized
+      from the web interface. Only one bug status cannot be renamed nor deleted,
+      UNCONFIRMED, but the workflow involving it is free. The configuration
+      page displays all existing bug statuses twice, first on the left for bug
+      statuses we come from and on the top for bug statuses we move to.
+      If the checkbox is checked, then the transition between the two bug statuses
+      is legal, else it's forbidden independently of your privileges. The bug status
+      used for the "duplicate_or_move_bug_status" parameter must be part of the
+      workflow as that is the bug status which will be used when duplicating or
+      moving a bug, so it must be available from each bug status.
+    </p><p>
+      When the workflow is set, the "View Current Triggers" link below the table
+      lets you set which transitions require a comment from the user.
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="edit-values.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="administration.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="voting.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.11. Legal Values </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.13. Voting</td></tr></table></div></body></html>

diff --git a/docs/en/html/bugreports.html b/docs/en/html/bugreports.html
new file mode 100644 (file)
index 0000000..f9de037
--- /dev/null
+++ b/docs/en/html/bugreports.html
@@ -0,0 +1,79 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>5.6. Filing Bugs</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="prev" href="query.html" title="5.5. Searching for Bugs"><link rel="next" href="attachments.html" title="5.7. Attachments"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.6. Filing Bugs</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="query.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Using Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="attachments.html">Next</a></td></tr></table><hr></div><div class="section" title="5.6. Filing Bugs"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="bugreports"></a>5.6. Filing Bugs</h2></div></div></div><div class="section" title="5.6.1. Reporting a New Bug"><div class="titlepage"><div><div><h3 class="title"><a name="fillingbugs"></a>5.6.1. Reporting a New Bug</h3></div></div></div><p>Years of bug writing experience has been distilled for your
+      reading pleasure into the 
+      <a class="ulink" href="http://landfill.bugzilla.org/bugzilla-tip/page.cgi?id=bug-writing.html" target="_top">
+      Bug Writing Guidelines</a>. 
+      While some of the advice is Mozilla-specific, the basic principles of
+      reporting Reproducible, Specific bugs, isolating the Product you are
+      using, the Version of the Product, the Component which failed, the
+      Hardware Platform, and Operating System you were using at the time of
+      the failure go a long way toward ensuring accurate, responsible fixes
+      for the bug that bit you.</p><p>The procedure for filing a bug is as follows:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+            Click the <span class="quote">“<span class="quote">New</span>”</span> link available in the footer
+            of pages, or the <span class="quote">“<span class="quote">Enter a new bug report</span>”</span> link
+            displayed on the home page of the Bugzilla installation.
+          </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+              If you want to file a test bug to see how Bugzilla works,
+              you can do it on one of our test installations on
+              <a class="ulink" href="http://landfill.bugzilla.org/bugzilla-tip/" target="_top">Landfill</a>.
+            </p></td></tr></table></div></li><li class="listitem"><p>
+            You first have to select the product in which you found a bug.
+          </p></li><li class="listitem"><p>
+            You now see a form where you can specify the component (part of
+            the product which is affected by the bug you discovered; if you have
+            no idea, just select <span class="quote">“<span class="quote">General</span>”</span> if such a component exists),
+            the version of the program you were using, the Operating System and
+            platform your program is running on and the severity of the bug (if the
+            bug you found crashes the program, it's probably a major or a critical
+            bug; if it's a typo somewhere, that's something pretty minor; if it's
+            something you would like to see implemented, then that's an enhancement).
+          </p></li><li class="listitem"><p>
+            You now have to give a short but descriptive summary of the bug you found.
+            <span class="quote">“<span class="quote">My program is crashing all the time</span>”</span> is a very poor summary
+            and doesn't help developers at all. Try something more meaningful or
+            your bug will probably be ignored due to a lack of precision.
+            The next step is to give a very detailed list of steps to reproduce
+            the problem you encountered. Try to limit these steps to a minimum set
+            required to reproduce the problem. This will make the life of
+            developers easier, and the probability that they consider your bug in
+            a reasonable timeframe will be much higher.
+          </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+              Try to make sure that everything in the summary is also in the first
+              comment. Summaries are often updated and this will ensure your original
+              information is easily accessible.
+            </p></td></tr></table></div></li><li class="listitem"><p>
+            As you file the bug, you can also attach a document (testcase, patch,
+            or screenshot of the problem).
+          </p></li><li class="listitem"><p>
+            Depending on the Bugzilla installation you are using and the product in
+            which you are filing the bug, you can also request developers to consider
+            your bug in different ways (such as requesting review for the patch you
+            just attached, requesting your bug to block the next release of the
+            product, and many other product specific requests).
+          </p></li><li class="listitem"><p>
+            Now is a good time to read your bug report again. Remove all misspellings,
+            otherwise your bug may not be found by developers running queries for some
+            specific words, and so your bug would not get any attention.
+            Also make sure you didn't forget any important information developers
+            should know in order to reproduce the problem, and make sure your
+            description of the problem is explicit and clear enough.
+            When you think your bug report is ready to go, the last step is to
+            click the <span class="quote">“<span class="quote">Commit</span>”</span> button to add your report into the database.
+          </p></li></ol></div><p>
+      You do not need to put "any" or similar strings in the URL field.
+      If there is no specific URL associated with the bug, leave this 
+      field blank.
+      </p><p>If you feel a bug you filed was incorrectly marked as a
+      DUPLICATE of another, please question it in your bug, not      
+      the bug it was duped to. Feel free to CC the person who duped it 
+      if they are not already CCed.
+      </p></div><div class="section" title="5.6.2. Clone an Existing Bug"><div class="titlepage"><div><div><h3 class="title"><a name="cloningbugs"></a>5.6.2. Clone an Existing Bug</h3></div></div></div><p>
+        Starting with version 2.20, Bugzilla has a feature that allows you
+        to clone an existing bug. The newly created bug will inherit
+        most settings from the old bug. This allows you to track more
+        easily similar concerns in a new bug. To use this, go to the bug
+        that you want to clone, then click the <span class="quote">“<span class="quote">Clone This Bug</span>”</span>
+        link on the bug page. This will take you to the <span class="quote">“<span class="quote">Enter Bug</span>”</span>
+        page that is filled with the values that the old bug has.
+        You can change those values and/or texts if needed.
+      </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="query.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="using.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="attachments.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5.5. Searching for Bugs </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 5.7. Attachments</td></tr></table></div></body></html>

diff --git a/docs/en/html/classifications.html b/docs/en/html/classifications.html
new file mode 100644 (file)
index 0000000..05f0b46
--- /dev/null
+++ b/docs/en/html/classifications.html
@@ -0,0 +1,9 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.3. Classifications</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="useradmin.html" title="3.2. User Administration"><link rel="next" href="products.html" title="3.4. Products"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.3. Classifications</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="useradmin.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="products.html">Next</a></td></tr></table><hr></div><div class="section" title="3.3. Classifications"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="classifications"></a>3.3. Classifications</h2></div></div></div><p>Classifications tend to be used in order to group several related
+    products into one distinct entity.</p><p>The classifications layer is disabled by default; it can be turned
+    on or off using the useclassification parameter,
+    in the <span class="emphasis"><em>Bug Fields</em></span> section of the edit parameters screen.</p><p>Access to the administration of classifications is controlled using
+    the <span class="emphasis"><em>editclassifications</em></span> system group, which defines
+    a privilege for creating, destroying, and editing classifications.</p><p>When activated, classifications will introduce an additional
+    step when filling bugs (dedicated to classification selection), and they
+    will also appear in the advanced search form.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="useradmin.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="administration.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="products.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.2. User Administration </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.4. Products</td></tr></table></div></body></html>

diff --git a/docs/en/html/cmdline-bugmail.html b/docs/en/html/cmdline-bugmail.html
new file mode 100644 (file)
index 0000000..5477ca0
--- /dev/null
+++ b/docs/en/html/cmdline-bugmail.html
@@ -0,0 +1,26 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>B.2. Command-line 'Send Unsent Bug-mail' tool</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="patches.html" title="Appendix B. Contrib"><link rel="prev" href="cmdline.html" title="B.1. Command-line Search Interface"><link rel="next" href="install-perlmodules-manual.html" title="Appendix C. Manual Installation of Perl Modules"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">B.2. Command-line 'Send Unsent Bug-mail' tool</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="cmdline.html">Prev</a> </td><th width="60%" align="center">Appendix B. Contrib</th><td width="20%" align="right"> <a accesskey="n" href="install-perlmodules-manual.html">Next</a></td></tr></table><hr></div><div class="section" title="B.2. Command-line 'Send Unsent Bug-mail' tool"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="cmdline-bugmail"></a>B.2. Command-line 'Send Unsent Bug-mail' tool</h2></div></div></div><p>
+      Within the <code class="filename">contrib</code> directory
+      exists a utility with the descriptive (if compact) name
+      of <code class="filename">sendunsentbugmail.pl</code>. The purpose of this
+      script is, simply, to send out any bug-related mail that should
+      have been sent by now, but for one reason or another has not.
+    </p><p>
+      To accomplish this task, <code class="filename">sendunsentbugmail.pl</code> uses
+      the same mechanism as the <code class="filename">sanitycheck.cgi</code> script;
+      it scans through the entire database looking for bugs with changes that
+      were made more than 30 minutes ago, but where there is no record of
+      anyone related to that bug having been sent mail. Having compiled a list,
+      it then uses the standard rules to determine who gets mail, and sends it
+      out.
+    </p><p>
+      As the script runs, it indicates the bug for which it is currently
+      sending mail; when it has finished, it gives a numerical count of how
+      many mails were sent and how many people were excluded. (Individual
+      user names are not recorded or displayed.) If the script produces
+      no output, that means no unsent mail was detected.
+    </p><p>
+      <span class="emphasis"><em>Usage</em></span>: move the sendunsentbugmail.pl script
+      up into the main directory, ensure it has execute permission, and run it
+      from the command line (or from a cron job) with no parameters.
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="cmdline.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="patches.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="install-perlmodules-manual.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">B.1. Command-line Search Interface </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Appendix C. Manual Installation of Perl Modules</td></tr></table></div></body></html>

diff --git a/docs/en/html/cmdline.html b/docs/en/html/cmdline.html
new file mode 100644 (file)
index 0000000..19bcc05
--- /dev/null
+++ b/docs/en/html/cmdline.html
@@ -0,0 +1,43 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>B.1. Command-line Search Interface</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="patches.html" title="Appendix B. Contrib"><link rel="prev" href="patches.html" title="Appendix B. Contrib"><link rel="next" href="cmdline-bugmail.html" title="B.2. Command-line 'Send Unsent Bug-mail' tool"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">B.1. Command-line Search Interface</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="patches.html">Prev</a> </td><th width="60%" align="center">Appendix B. Contrib</th><td width="20%" align="right"> <a accesskey="n" href="cmdline-bugmail.html">Next</a></td></tr></table><hr></div><div class="section" title="B.1. Command-line Search Interface"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="cmdline"></a>B.1. Command-line Search Interface</h2></div></div></div><p>
+      There are a suite of Unix utilities for searching Bugzilla from the 
+      command line. They live in the 
+      <code class="filename">contrib/cmdline</code> directory.
+      There are three files - <code class="filename">query.conf</code>,
+      <code class="filename">buglist</code> and <code class="filename">bugs</code>.
+    </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        These files pre-date the templatization work done as part of the
+        2.16 release, and have not been updated.
+      </p></td></tr></table></div><p>
+      <code class="filename">query.conf</code> contains the mapping from
+      options to field names and comparison types. Quoted option names
+      are <span class="quote">“<span class="quote">grepped</span>”</span> for, so it should be easy to edit this
+      file. Comments (#) have no effect; you must make sure these lines
+      do not contain any quoted <span class="quote">“<span class="quote">option</span>”</span>.
+    </p><p>
+      <code class="filename">buglist</code> is a shell script that submits a
+      Bugzilla query and writes the resulting HTML page to stdout.
+      It supports both short options, (such as <span class="quote">“<span class="quote">-Afoo</span>”</span>
+      or <span class="quote">“<span class="quote">-Rbar</span>”</span>) and long options (such
+      as <span class="quote">“<span class="quote">--assignedto=foo</span>”</span> or <span class="quote">“<span class="quote">--reporter=bar</span>”</span>).
+      If the first character of an option is not <span class="quote">“<span class="quote">-</span>”</span>, it is
+      treated as if it were prefixed with <span class="quote">“<span class="quote">--default=</span>”</span>.
+    </p><p>
+      The column list is taken from the COLUMNLIST environment variable.
+      This is equivalent to the <span class="quote">“<span class="quote">Change Columns</span>”</span> option
+      that is available when you list bugs in buglist.cgi. If you have
+      already used Bugzilla, grep for COLUMNLIST in your cookies file
+      to see your current COLUMNLIST setting.
+    </p><p>
+      <code class="filename">bugs</code> is a simple shell script which calls
+      <code class="filename">buglist</code> and extracts the
+      bug numbers from the output. Adding the prefix
+      <span class="quote">“<span class="quote">http://bugzilla.mozilla.org/buglist.cgi?bug_id=</span>”</span>
+      turns the bug list into a working link if any bugs are found.
+      Counting bugs is easy. Pipe the results through 
+      <span class="command"><strong>sed -e 's/,/ /g' | wc | awk '{printf $2 "\n"}'</strong></span>
+    </p><p>
+      Akkana Peck says she has good results piping 
+      <code class="filename">buglist</code> output through 
+      <span class="command"><strong>w3m -T text/html -dump</strong></span>
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="patches.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="patches.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="cmdline-bugmail.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Appendix B. Contrib </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> B.2. Command-line 'Send Unsent Bug-mail' tool</td></tr></table></div></body></html>

diff --git a/docs/en/html/components.html b/docs/en/html/components.html
new file mode 100644 (file)
index 0000000..3542909
--- /dev/null
+++ b/docs/en/html/components.html
@@ -0,0 +1,26 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.5. Components</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="products.html" title="3.4. Products"><link rel="next" href="versions.html" title="3.6. Versions"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.5. Components</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="products.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="versions.html">Next</a></td></tr></table><hr></div><div class="section" title="3.5. Components"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="components"></a>3.5. Components</h2></div></div></div><p>Components are subsections of a Product. E.g. the computer game 
+    you are designing may have a "UI"
+    component, an "API" component, a "Sound System" component, and a
+    "Plugins" component, each overseen by a different programmer. It
+    often makes sense to divide Components in Bugzilla according to the
+    natural divisions of responsibility within your Product or
+    company.</p><p>
+    Each component has a default assignee and (if you turned it on in the parameters),
+    a QA Contact. The default assignee should be the primary person who fixes bugs in
+    that component. The QA Contact should be the person who will ensure
+    these bugs are completely fixed. The Assignee, QA Contact, and Reporter
+    will get email when new bugs are created in this Component and when
+    these bugs change. Default Assignee and Default QA Contact fields only
+    dictate the 
+    <span class="emphasis"><em>default assignments</em></span>; 
+    these can be changed on bug submission, or at any later point in
+    a bug's life.</p><p>To create a new Component:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Select the <span class="quote">“<span class="quote">Edit components</span>”</span> link 
+        from the <span class="quote">“<span class="quote">Edit product</span>”</span> page</p></li><li class="listitem"><p>Select the <span class="quote">“<span class="quote">Add</span>”</span> link in the bottom right.</p></li><li class="listitem"><p>Fill out the <span class="quote">“<span class="quote">Component</span>”</span> field, a 
+        short <span class="quote">“<span class="quote">Description</span>”</span>, the 
+        <span class="quote">“<span class="quote">Default Assignee</span>”</span>, <span class="quote">“<span class="quote">Default CC List</span>”</span> 
+        and <span class="quote">“<span class="quote">Default QA Contact</span>”</span> (if enabled). 
+        The <span class="quote">“<span class="quote">Component Description</span>”</span> field may contain a 
+        limited subset of HTML tags. The <span class="quote">“<span class="quote">Default Assignee</span>”</span> 
+        field must be a login name already existing in the Bugzilla database. 
+        </p></li></ol></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="products.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="administration.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="versions.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.4. Products </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.6. Versions</td></tr></table></div></body></html>

diff --git a/docs/en/html/configuration.html b/docs/en/html/configuration.html
new file mode 100644 (file)
index 0000000..ea0f4ec
--- /dev/null
+++ b/docs/en/html/configuration.html
@@ -0,0 +1,432 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>2.2. Configuration</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="installing-bugzilla.html" title="Chapter 2. Installing Bugzilla"><link rel="prev" href="installation.html" title="2.1. Installation"><link rel="next" href="extraconfig.html" title="2.3. Optional Additional Configuration"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.2. Configuration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="installation.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Installing Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="extraconfig.html">Next</a></td></tr></table><hr></div><div class="section" title="2.2. Configuration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="configuration"></a>2.2. Configuration</h2></div></div></div><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        Poorly-configured MySQL and Bugzilla installations have
+        given attackers full access to systems in the past. Please take the
+        security parts of these guidelines seriously, even for Bugzilla 
+        machines hidden away behind your firewall. Be certain to read
+        <a class="xref" href="security.html" title="Chapter 4. Bugzilla Security">Chapter 4, <i>Bugzilla Security</i></a> for some important security tips.
+      </p></td></tr></table></div><div class="section" title="2.2.1. localconfig"><div class="titlepage"><div><div><h3 class="title"><a name="localconfig"></a>2.2.1. localconfig</h3></div></div></div><p>
+        You should now run <code class="filename">checksetup.pl</code> again, this time
+        without the <code class="literal">--check-modules</code> switch.
+      </p><pre class="screen"><code class="prompt">bash#</code> ./checksetup.pl</pre><p>
+        This time, <code class="filename">checksetup.pl</code> should tell you that all
+        the correct modules are installed and will display a message about, and
+        write out a  file called, <code class="filename">localconfig</code>. This file
+        contains the default settings for a number of Bugzilla parameters.
+      </p><p>
+        Load this file in your editor. The only two values you
+        <span class="emphasis"><em>need</em></span> to change are $db_driver and $db_pass,
+        respectively the type of the database and the password for
+        the user you will create for your database. Pick a strong
+        password (for simplicity, it should not contain single quote
+        characters) and put it here. $db_driver can be either 'mysql',
+        'Pg', 'Oracle' or 'Sqlite'.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          In Oracle, <code class="literal">$db_name</code> should actually be 
+          the SID name of your database (e.g. "XE" if you are using Oracle XE).
+        </p></td></tr></table></div><p>
+        You may need to change the value of 
+        <span class="emphasis"><em>webservergroup</em></span> if your web server does not 
+        run in the "apache" group.  On Debian, for example, Apache runs in 
+        the "www-data" group.  If you are going to run Bugzilla on a 
+        machine where you do not have root access (such as on a shared web 
+        hosting account), you will need to leave
+        <span class="emphasis"><em>webservergroup</em></span> empty, ignoring the warnings 
+        that <code class="filename">checksetup.pl</code> will subsequently display 
+        every time it is run.
+      </p><div class="caution" title="Caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          If you are using suexec, you should use your own primary group
+          for <span class="emphasis"><em>webservergroup</em></span> rather than leaving it
+          empty, and see the additional directions in the suexec section
+          <a class="xref" href="nonroot.html#suexec" title="2.6.6.1. suexec or shared hosting">Section 2.6.6.1, “suexec or shared hosting”</a>.
+        </p></td></tr></table></div><p>
+        The other options in the <code class="filename">localconfig</code> file
+        are documented by their accompanying comments. If you have a slightly
+        non-standard database setup, you may wish to change one or more of
+        the other "$db_*" parameters.
+      </p></div><div class="section" title="2.2.2. Database Server"><div class="titlepage"><div><div><h3 class="title"><a name="database-engine"></a>2.2.2. Database Server</h3></div></div></div><p>
+        This section deals with configuring your database server for use
+        with Bugzilla. Currently, MySQL (<a class="xref" href="configuration.html#mysql" title="2.2.2.2. MySQL">Section 2.2.2.2, “MySQL”</a>),
+        PostgreSQL (<a class="xref" href="configuration.html#postgresql" title="2.2.2.3. PostgreSQL">Section 2.2.2.3, “PostgreSQL”</a>), Oracle (<a class="xref" href="configuration.html#oracle" title="2.2.2.4. Oracle">Section 2.2.2.4, “Oracle”</a>)
+        and SQLite (<a class="xref" href="configuration.html#sqlite" title="2.2.2.5. SQLite">Section 2.2.2.5, “SQLite”</a>) are available.
+      </p><div class="section" title="2.2.2.1. Bugzilla Database Schema"><div class="titlepage"><div><div><h4 class="title"><a name="database-schema"></a>2.2.2.1. Bugzilla Database Schema</h4></div></div></div><p>
+          The Bugzilla database schema is available at
+          <a class="ulink" href="http://www.ravenbrook.com/project/p4dti/tool/cgi/bugzilla-schema/" target="_top">Ravenbrook</a>.
+          This very valuable tool can generate a written description of
+          the Bugzilla database schema for any version of Bugzilla. It
+          can also generate a diff between two versions to help someone
+          see what has changed.
+        </p></div><div class="section" title="2.2.2.2. MySQL"><div class="titlepage"><div><div><h4 class="title"><a name="mysql"></a>2.2.2.2. MySQL</h4></div></div></div><div class="caution" title="Caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            MySQL's default configuration is insecure.
+            We highly recommend to run <code class="filename">mysql_secure_installation</code>
+            on Linux or the MySQL installer on Windows, and follow the instructions.
+            Important points to note are:
+            </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Be sure that the root account has a secure password set.</p></li><li class="listitem"><p>Do not create an anonymous account, and if it exists, say "yes"
+                to remove it.</p></li><li class="listitem"><p>If your web server and MySQL server are on the same machine,
+                you should disable the network access.</p></li></ol></div><p>
+          </p></td></tr></table></div><div class="section" title="2.2.2.2.1. Allow large attachments and many comments"><div class="titlepage"><div><div><h5 class="title"><a name="mysql-max-allowed-packet"></a>2.2.2.2.1. Allow large attachments and many comments</h5></div></div></div><p>By default, MySQL will only allow you to insert things
+          into the database that are smaller than 1MB. Attachments
+          may be larger than this. Also, Bugzilla combines all comments
+          on a single bug into one field for full-text searching, and the
+          combination of all comments on a single bug could in some cases
+          be larger than 1MB.</p><p>To change MySQL's default, you need to edit your MySQL
+          configuration file, which is usually <code class="filename">/etc/my.cnf</code>
+          on Linux. We recommend that you allow at least 4MB packets by
+          adding the "max_allowed_packet" parameter to your MySQL 
+          configuration in the "[mysqld]" section, like this:</p><pre class="screen">[mysqld]
+# Allow packets up to 4MB
+max_allowed_packet=4M
+          </pre></div><div class="section" title="2.2.2.2.2. Allow small words in full-text indexes"><div class="titlepage"><div><div><h5 class="title"><a name="idp6661792"></a>2.2.2.2.2. Allow small words in full-text indexes</h5></div></div></div><p>By default, words must be at least four characters in length
+          in order to be indexed by MySQL's full-text indexes. This causes
+          a lot of Bugzilla specific words to be missed, including "cc",
+          "ftp" and "uri".</p><p>MySQL can be configured to index those words by setting the
+          ft_min_word_len param to the minimum size of the words to index.
+          This can be done by modifying the <code class="filename">/etc/my.cnf</code>
+          according to the example below:</p><pre class="screen">[mysqld]
+# Allow small words in full-text indexes
+ft_min_word_len=2</pre><p>Rebuilding the indexes can be done based on documentation found at
+          <a class="ulink" href="http://www.mysql.com/doc/en/Fulltext_Fine-tuning.html" target="_top">http://www.mysql.com/doc/en/Fulltext_Fine-tuning.html</a>.
+          </p></div><div class="section" title="2.2.2.2.3. Add a user to MySQL"><div class="titlepage"><div><div><h5 class="title"><a name="install-setupdatabase-adduser"></a>2.2.2.2.3. Add a user to MySQL</h5></div></div></div><p>
+            You need to add a new MySQL user for Bugzilla to use.
+            (It's not safe to have Bugzilla use the MySQL root account.)
+            The following instructions assume the defaults in
+            <code class="filename">localconfig</code>; if you changed those,
+            you need to modify the SQL command appropriately. You will
+            need the <em class="replaceable"><code>$db_pass</code></em> password you
+            set in <code class="filename">localconfig</code> in 
+            <a class="xref" href="configuration.html#localconfig" title="2.2.1. localconfig">Section 2.2.1, “localconfig”</a>.
+          </p><p>
+            We use an SQL <span class="command"><strong>GRANT</strong></span> command to create
+            a <span class="quote">“<span class="quote">bugs</span>”</span> user. This also restricts the 
+            <span class="quote">“<span class="quote">bugs</span>”</span>user to operations within a database
+            called <span class="quote">“<span class="quote">bugs</span>”</span>, and only allows the account
+            to connect from <span class="quote">“<span class="quote">localhost</span>”</span>. Modify it to
+            reflect your setup if you will be connecting from another
+            machine or as a different user.
+          </p><p>
+            Run the <code class="filename">mysql</code> command-line client and enter:
+          </p><pre class="screen">
+<code class="prompt">mysql&gt;</code> GRANT SELECT, INSERT,
+       UPDATE, DELETE, INDEX, ALTER, CREATE, LOCK TABLES,
+       CREATE TEMPORARY TABLES, DROP, REFERENCES ON bugs.*
+       TO bugs@localhost IDENTIFIED BY '<em class="replaceable"><code>$db_pass</code></em>';
+<code class="prompt">mysql&gt;</code> FLUSH PRIVILEGES;
+          </pre></div><div class="section" title="2.2.2.2.4. Permit attachments table to grow beyond 4GB"><div class="titlepage"><div><div><h5 class="title"><a name="idp6677968"></a>2.2.2.2.4. Permit attachments table to grow beyond 4GB</h5></div></div></div><p>
+            By default, MySQL will limit the size of a table to 4GB.
+            This limit is present even if the underlying filesystem
+            has no such limit.  To set a higher limit, follow these
+            instructions.
+          </p><p>
+            After you have completed the rest of the installation (or at least the
+            database setup parts), you should run the <code class="filename">MySQL</code>
+            command-line client and enter the following, replacing <code class="literal">$bugs_db</code>
+            with your Bugzilla database name (<span class="emphasis"><em>bugs</em></span> by default):
+          </p><pre class="screen">
+<code class="prompt">mysql&gt;</code> use <em class="replaceable"><code>$bugs_db</code></em>
+<code class="prompt">mysql&gt;</code> ALTER TABLE attachments
+           AVG_ROW_LENGTH=1000000, MAX_ROWS=20000;
+          </pre><p>
+            The above command will change the limit to 20GB. Mysql will have 
+            to make a temporary copy of your entire table to do this. Ideally, 
+            you should do this when your attachments table is still small. 
+          </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+              This does not affect Big Files, attachments that are stored directly
+              on disk instead of in the database.
+            </p></td></tr></table></div></div></div><div class="section" title="2.2.2.3. PostgreSQL"><div class="titlepage"><div><div><h4 class="title"><a name="postgresql"></a>2.2.2.3. PostgreSQL</h4></div></div></div><div class="section" title="2.2.2.3.1. Add a User to PostgreSQL"><div class="titlepage"><div><div><h5 class="title"><a name="idp6687568"></a>2.2.2.3.1. Add a User to PostgreSQL</h5></div></div></div><p>You need to add a new user to PostgreSQL for the Bugzilla
+          application to use when accessing the database. The following instructions
+          assume the defaults in <code class="filename">localconfig</code>; if you
+          changed those, you need to modify the commands appropriately. You will
+          need the <em class="replaceable"><code>$db_pass</code></em> password you
+          set in <code class="filename">localconfig</code> in 
+          <a class="xref" href="configuration.html#localconfig" title="2.2.1. localconfig">Section 2.2.1, “localconfig”</a>.</p><p>On most systems, to create the user in PostgreSQL, you will need to
+          login as the root user, and then</p><pre class="screen"><code class="prompt">bash#</code> su - postgres</pre><p>As the postgres user, you then need to create a new user: </p><pre class="screen"><code class="prompt">bash$</code> createuser -U postgres -dRSP bugs</pre><p>When asked for a password, provide the password which will be set as
+          <em class="replaceable"><code>$db_pass</code></em> in <code class="filename">localconfig</code>.
+          The created user will not be a superuser (-S) and will not be able to create
+          new users (-R). He will only have the ability to create databases (-d).</p></div><div class="section" title="2.2.2.3.2. Configure PostgreSQL"><div class="titlepage"><div><div><h5 class="title"><a name="idp6697120"></a>2.2.2.3.2. Configure PostgreSQL</h5></div></div></div><p>Now, you will need to edit <code class="filename">pg_hba.conf</code> which is
+          usually located in <code class="filename">/var/lib/pgsql/data/</code>. In this file,
+          you will need to add a new line to it as follows:</p><p>
+            <code class="computeroutput">host   all    bugs   127.0.0.1    255.255.255.255  md5</code>
+          </p><p>This means that for TCP/IP (host) connections, allow connections from
+          '127.0.0.1' to 'all' databases on this server from the 'bugs' user, and use
+          password authentication (md5) for that user.</p><p>Now, you will need to restart PostgreSQL, but you will need to fully
+          stop and start the server rather than just restarting due to the possibility
+          of a change to <code class="filename">postgresql.conf</code>. After the server has
+          restarted, you will need to edit <code class="filename">localconfig</code>, finding
+          the <code class="literal">$db_driver</code> variable and setting it to
+          <code class="literal">Pg</code> and changing the password in <code class="literal">$db_pass</code>
+          to the one you picked previously, while setting up the account.</p></div></div><div class="section" title="2.2.2.4. Oracle"><div class="titlepage"><div><div><h4 class="title"><a name="oracle"></a>2.2.2.4. Oracle</h4></div></div></div><div class="section" title="2.2.2.4.1. Create a New Tablespace"><div class="titlepage"><div><div><h5 class="title"><a name="idp6707344"></a>2.2.2.4.1. Create a New Tablespace</h5></div></div></div><p>
+            You can use the existing tablespace or create a new one for Bugzilla.
+            To create a new tablespace, run the following command:
+          </p><pre class="programlisting">
+CREATE TABLESPACE bugs
+DATAFILE '<em class="replaceable"><code>$path_to_datafile</code></em>' SIZE 500M
+AUTOEXTEND ON NEXT 30M MAXSIZE UNLIMITED
+          </pre><p>
+            Here, the name of the tablespace is 'bugs', but you can
+            choose another name. <em class="replaceable"><code>$path_to_datafile</code></em> is
+            the path to the file containing your database, for instance
+            <code class="filename">/u01/oradata/bugzilla.dbf</code>.
+            The initial size of the database file is set in this example to 500 Mb,
+            with an increment of 30 Mb everytime we reach the size limit of the file.
+          </p></div><div class="section" title="2.2.2.4.2. Add a User to Oracle"><div class="titlepage"><div><div><h5 class="title"><a name="idp6712016"></a>2.2.2.4.2. Add a User to Oracle</h5></div></div></div><p>
+            The user name and password must match what you set in
+            <code class="filename">localconfig</code> (<code class="literal">$db_user</code>
+            and <code class="literal">$db_pass</code>, respectively). Here, we assume that
+            the user name is 'bugs' and the tablespace name is the same
+            as above. 
+          </p><pre class="programlisting">
+CREATE USER bugs
+IDENTIFIED BY "<em class="replaceable"><code>$db_pass</code></em>"
+DEFAULT TABLESPACE bugs
+TEMPORARY TABLESPACE TEMP
+PROFILE DEFAULT;
+-- GRANT/REVOKE ROLE PRIVILEGES
+GRANT CONNECT TO bugs;
+GRANT RESOURCE TO bugs;
+-- GRANT/REVOKE SYSTEM PRIVILEGES
+GRANT UNLIMITED TABLESPACE TO bugs;
+GRANT EXECUTE ON CTXSYS.CTX_DDL TO bugs;
+          </pre></div><div class="section" title="2.2.2.4.3. Configure the Web Server"><div class="titlepage"><div><div><h5 class="title"><a name="idp6717152"></a>2.2.2.4.3. Configure the Web Server</h5></div></div></div><p>
+            If you use Apache, append these lines to <code class="filename">httpd.conf</code>
+            to set ORACLE_HOME and LD_LIBRARY_PATH. For instance:
+          </p><pre class="programlisting">
+SetEnv ORACLE_HOME /u01/app/oracle/product/10.2.0/
+SetEnv LD_LIBRARY_PATH /u01/app/oracle/product/10.2.0/lib/
+          </pre><p>
+            When this is done, restart your web server.
+          </p></div></div><div class="section" title="2.2.2.5. SQLite"><div class="titlepage"><div><div><h4 class="title"><a name="sqlite"></a>2.2.2.5. SQLite</h4></div></div></div><div class="caution" title="Caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            Due to SQLite's <a class="ulink" href="http://sqlite.org/faq.html#q5" target="_top">concurrency
+            limitations</a> we recommend SQLite only for small and development
+            Bugzilla installations.
+          </p></td></tr></table></div><p>
+          No special configuration is required to run Bugzilla on SQLite.
+          The database will be stored in <code class="filename">data/db/$db_name</code>,
+          where <code class="literal">$db_name</code> is the database name defined
+          in <code class="filename">localconfig</code>.
+        </p></div></div><div class="section" title="2.2.3. checksetup.pl"><div class="titlepage"><div><div><h3 class="title"><a name="idp6726528"></a>2.2.3. checksetup.pl</h3></div></div></div><p>
+        Next, rerun <code class="filename">checksetup.pl</code>. It reconfirms
+        that all the modules are present, and notices the altered 
+        localconfig file, which it assumes you have edited to your
+        satisfaction. It compiles the UI templates,
+        connects to the database using the 'bugs'
+        user you created and the password you defined, and creates the 
+        'bugs' database and the tables therein. 
+      </p><p>
+        After that, it asks for details of an administrator account. Bugzilla
+        can have multiple administrators - you can create more later - but
+        it needs one to start off with.
+        Enter the email address of an administrator, his or her full name, 
+        and a suitable Bugzilla password.
+      </p><p>
+        <code class="filename">checksetup.pl</code> will then finish. You may rerun
+        <code class="filename">checksetup.pl</code> at any time if you wish.
+      </p></div><div class="section" title="2.2.4. Web server"><div class="titlepage"><div><div><h3 class="title"><a name="http"></a>2.2.4. Web server</h3></div></div></div><p>
+        Configure your web server according to the instructions in the
+        appropriate section. (If it makes a difference in your choice,
+        the Bugzilla Team recommends Apache.) To check whether your web server
+       is correctly configured, try to access <code class="filename">testagent.cgi</code>
+       from your web server. If "OK" is displayed, then your configuration
+       is successful. Regardless of which web server
+        you are using, however, ensure that sensitive information is
+        not remotely available by properly applying the access controls in
+        <a class="xref" href="security-webserver.html#security-webserver-access" title="4.2.1. Disabling Remote Access to Bugzilla Configuration Files">Section 4.2.1, “Disabling Remote Access to Bugzilla Configuration Files”</a>. You can run
+        <code class="filename">testserver.pl</code> to check if your web server serves
+        Bugzilla files as expected.
+      </p><div class="section" title="2.2.4.1. Bugzilla using Apache"><div class="titlepage"><div><div><h4 class="title"><a name="http-apache"></a>2.2.4.1. Bugzilla using Apache</h4></div></div></div><p>You have two options for running Bugzilla under Apache - 
+          <a class="link" href="configuration.html#http-apache-mod_cgi" title="2.2.4.1.1. Apache httpd™ with mod_cgi">mod_cgi</a> (the default) and
+          <a class="link" href="configuration.html#http-apache-mod_perl" title="2.2.4.1.2. Apache httpd™ with mod_perl">mod_perl</a> (new in Bugzilla
+          2.23)
+        </p><div class="section" title="2.2.4.1.1. Apache httpd™ with mod_cgi"><div class="titlepage"><div><div><h5 class="title"><a name="http-apache-mod_cgi"></a>2.2.4.1.1. Apache <span class="productname">httpd</span>™ with mod_cgi</h5></div></div></div><p>
+            To configure your Apache web server to work with Bugzilla while using
+            mod_cgi, do the following:
+            </p><div class="procedure"><ol class="procedure" type="1"><li class="step" title="Step 1"><p>
+                Load <code class="filename">httpd.conf</code> in your editor.
+                In Fedora and Red Hat Linux, this file is found in
+                <code class="filename">/etc/httpd/conf</code>.
+                </p></li><li class="step" title="Step 2"><p>
+                Apache uses <code class="computeroutput">&lt;Directory&gt;</code>
+                directives to permit fine-grained permission setting. Add the
+                following lines to a directive that applies to the location
+                of your Bugzilla installation. (If such a section does not
+                exist, you'll want to add one.) In this example, Bugzilla has
+                been installed at 
+                <code class="filename">/var/www/html/bugzilla</code>.
+                </p><pre class="programlisting">
+&lt;Directory /var/www/html/bugzilla&gt;
+AddHandler cgi-script .cgi
+Options +ExecCGI
+DirectoryIndex index.cgi index.html
+AllowOverride Limit FileInfo Indexes Options
+&lt;/Directory&gt;
+                </pre><p>
+                These instructions: allow apache to run .cgi files found
+                within the bugzilla directory; instructs the server to look
+                for a file called <code class="filename">index.cgi</code> or, if not
+                found, <code class="filename">index.html</code> if someone
+                only types the directory name into the browser; and allows
+                Bugzilla's <code class="filename">.htaccess</code> files to override
+                some global permissions.
+                </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+                    It is possible to make these changes globally, or to the
+                    directive controlling Bugzilla's parent directory (e.g.
+                    <code class="computeroutput">&lt;Directory /var/www/html/&gt;</code>).
+                    Such changes would also apply to the Bugzilla directory...
+                    but they would also apply to many other places where they
+                    may or may not be appropriate. In most cases, including
+                    this one, it is better to be as restrictive as possible
+                    when granting extra access.
+                </p></td></tr></table></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+                    On Windows, you may have to also add the
+                    <code class="computeroutput">ScriptInterpreterSource Registry-Strict</code>
+                    line, see <a class="link" href="os-specific.html#win32-http" title="2.5.1.3. Serving the web pages">Windows specific notes</a>.
+                </p></td></tr></table></div></li><li class="step" title="Step 3"><p>
+                <code class="filename">checksetup.pl</code> can set tighter permissions
+                on Bugzilla's files and directories if it knows what group the
+                web server runs as. Find the <code class="computeroutput">Group</code>
+                line in <code class="filename">httpd.conf</code>, place the value found
+                there in the <em class="replaceable"><code>$webservergroup</code></em> variable
+                in <code class="filename">localconfig</code>, then rerun
+                <code class="filename">checksetup.pl</code>.
+                </p></li><li class="step" title="Step 4"><p>
+                Optional: If Bugzilla does not actually reside in the webspace
+                directory, but instead has been symbolically linked there, you
+                will need to add the following to the
+                <code class="computeroutput">Options</code> line of the Bugzilla 
+                <code class="computeroutput">&lt;Directory&gt;</code> directive
+                (the same one as in the step above):
+                </p><pre class="programlisting">+FollowSymLinks</pre><p>
+                Without this directive, Apache will not follow symbolic links
+                to places outside its own directory structure, and you will be
+                unable to run Bugzilla.
+                </p></li></ol></div></div><div class="section" title="2.2.4.1.2. Apache httpd™ with mod_perl"><div class="titlepage"><div><div><h5 class="title"><a name="http-apache-mod_perl"></a>2.2.4.1.2. Apache <span class="productname">httpd</span>™ with mod_perl</h5></div></div></div><p>Some configuration is required to make Bugzilla work with Apache
+            and mod_perl</p><div class="procedure"><ol class="procedure" type="1"><li class="step" title="Step 1"><p>
+                Load <code class="filename">httpd.conf</code> in your editor.
+                In Fedora and Red Hat Linux, this file is found in
+                <code class="filename">/etc/httpd/conf</code>.
+                </p></li><li class="step" title="Step 2"><p>Add the following information to your httpd.conf file, substituting
+                where appropriate with your own local paths.</p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>This should be used instead of the &lt;Directory&gt; block
+                shown above. This should also be above any other <code class="literal">mod_perl</code>
+                directives within the <code class="filename">httpd.conf</code> and must be specified
+                in the order as below.</p></td></tr></table></div><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>You should also ensure that you have disabled <code class="literal">KeepAlive</code>
+                support in your Apache install when utilizing Bugzilla under mod_perl</p></td></tr></table></div><pre class="programlisting">
+PerlSwitches -w -T
+PerlConfigRequire /var/www/html/bugzilla/mod_perl.pl
+                </pre></li><li class="step" title="Step 3"><p>
+                                       <code class="filename">checksetup.pl</code> can set tighter permissions
+                                       on Bugzilla's files and directories if it knows what group the
+                                       web server runs as. Find the <code class="computeroutput">Group</code>
+                                       line in <code class="filename">httpd.conf</code>, place the value found
+                                       there in the <em class="replaceable"><code>$webservergroup</code></em> variable
+                                       in <code class="filename">localconfig</code>, then rerun
+                                       <code class="filename">checksetup.pl</code>.
+                               </p></li></ol></div><p>On restarting Apache, Bugzilla should now be running within the
+            mod_perl environment. Please ensure you have run checksetup.pl to set
+                   permissions before you restart Apache.</p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Please bear the following points in mind when looking at using 
+                Bugzilla under mod_perl: 
+            </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
+                    mod_perl support in Bugzilla can take up a HUGE amount of RAM. You could be
+                    looking at 30MB per httpd child, easily. Basically, you just need a lot of RAM.
+                    The more RAM you can get, the better. mod_perl is basically trading RAM for
+                    speed. At least 2GB total system RAM is recommended for running Bugzilla under
+                    mod_perl.
+                </p></li><li class="listitem"><p>
+                    Under mod_perl, you have to restart Apache if you make any manual change to
+                    any Bugzilla file. You can't just reload--you have to actually 
+                                       <span class="emphasis"><em>restart</em></span> the server (as in make sure it stops and starts 
+                                       again). You <span class="emphasis"><em>can</em></span> change localconfig and the params file 
+                                       manually, if you want, because those are re-read every time you load a page.
+                </p></li><li class="listitem"><p>
+                    You must run in Apache's Prefork MPM (this is the default). The Worker MPM
+                    may not work--we haven't tested Bugzilla's mod_perl support under threads.
+                                       (And, in fact, we're fairly sure it <span class="emphasis"><em>won't</em></span> work.)
+                </p></li><li class="listitem"><p>
+                    Bugzilla generally expects to be the only mod_perl application running on
+                    your entire server. It may or may not work if there are other applications also
+                    running under mod_perl. It does try its best to play nice with other mod_perl
+                    applications, but it still may have conflicts.
+                </p></li><li class="listitem"><p>
+                    It is recommended that you have one Bugzilla instance running under mod_perl
+                    on your server. Bugzilla has not been tested with more than one instance running.
+                </p></li></ul></div><p>
+            </p></td></tr></table></div></div></div><div class="section" title="2.2.4.2. Microsoft Internet Information Services™"><div class="titlepage"><div><div><h4 class="title"><a name="http-iis"></a>2.2.4.2. Microsoft <span class="productname">Internet Information Services</span>™</h4></div></div></div><p>
+          If you are running Bugzilla on Windows and choose to use
+          Microsoft's <span class="productname">Internet Information Services</span>™
+          or <span class="productname">Personal Web Server</span>™ you will need
+          to perform a number of other configuration steps as explained below.
+          You may also want to refer to the following Microsoft Knowledge
+          Base articles: 
+          <a class="ulink" href="http://support.microsoft.com/default.aspx?scid=kb;en-us;245225" target="_top">245225</a> 
+          <span class="quote">“<span class="quote">HOW TO: Configure and Test a PERL Script with IIS 4.0,
+          5.0, and 5.1</span>”</span> (for <span class="productname">Internet Information
+          Services</span>™) and 
+          <a class="ulink" href="http://support.microsoft.com/default.aspx?scid=kb;en-us;231998" target="_top">231998</a>          
+          <span class="quote">“<span class="quote">HOW TO: FP2000: How to Use Perl with Microsoft Personal Web
+          Server on Windows 95/98</span>”</span> (for <span class="productname">Personal Web
+          Server</span>™).
+        </p><p>
+          You will need to create a virtual directory for the Bugzilla
+          install.  Put the Bugzilla files in a directory that is named
+          something <span class="emphasis"><em>other</em></span> than what you want your
+          end-users accessing.  That is, if you want your users to access
+          your Bugzilla installation through 
+          <span class="quote">“<span class="quote">http://&lt;yourdomainname&gt;/Bugzilla</span>”</span>, then do
+          <span class="emphasis"><em>not</em></span> put your Bugzilla files in a directory
+          named <span class="quote">“<span class="quote">Bugzilla</span>”</span>.  Instead, place them in a different
+          location, and then use the IIS Administration tool to create a
+          Virtual Directory named "Bugzilla" that acts as an alias for the
+          actual location of the files.  When creating that virtual directory,
+          make sure you add the <span class="quote">“<span class="quote">Execute (such as ISAPI applications or
+          CGI)</span>”</span> access permission.
+        </p><p>
+          You will also need to tell IIS how to handle Bugzilla's
+          .cgi files. Using the IIS Administration tool again, open up
+          the properties for the new virtual directory and select the
+          Configuration option to access the Script Mappings. Create an
+          entry mapping .cgi to:
+        </p><pre class="programlisting">
+&lt;full path to perl.exe &gt;\perl.exe -x&lt;full path to Bugzilla&gt; -wT "%s" %s
+        </pre><p>
+          For example:
+        </p><pre class="programlisting">
+c:\perl\bin\perl.exe -xc:\bugzilla -wT "%s" %s
+        </pre><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            The ActiveState install may have already created an entry for
+            .pl files that is limited to <span class="quote">“<span class="quote">GET,HEAD,POST</span>”</span>. If
+            so, this mapping should be <span class="emphasis"><em>removed</em></span> as
+            Bugzilla's .pl files are not designed to be run via a web server.
+          </p></td></tr></table></div><p>
+          IIS will also need to know that the index.cgi should be treated
+          as a default document.  On the Documents tab page of the virtual
+          directory properties, you need to add index.cgi as a default
+          document type.  If you  wish, you may remove the other default
+          document types for this particular virtual directory, since Bugzilla 
+          doesn't use any of them.
+        </p><p>
+          Also, and this can't be stressed enough, make sure that files
+          such as <code class="filename">localconfig</code> and your
+          <code class="filename">data</code> directory are
+          secured as described in <a class="xref" href="security-webserver.html#security-webserver-access" title="4.2.1. Disabling Remote Access to Bugzilla Configuration Files">Section 4.2.1, “Disabling Remote Access to Bugzilla Configuration Files”</a>.
+        </p></div></div><div class="section" title="2.2.5. Bugzilla"><div class="titlepage"><div><div><h3 class="title"><a name="install-config-bugzilla"></a>2.2.5. Bugzilla</h3></div></div></div><p>
+        Your Bugzilla should now be working. Access 
+        <code class="filename">http://&lt;your-bugzilla-server&gt;/</code> - 
+        you should see the Bugzilla
+        front page. If not, consult the Troubleshooting section,
+        <a class="xref" href="troubleshooting.html" title="Appendix A. Troubleshooting">Appendix A, <i>Troubleshooting</i></a>.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          The URL above may be incorrect if you installed Bugzilla into a 
+          subdirectory or used a symbolic link from your web site root to 
+          the Bugzilla directory.
+        </p></td></tr></table></div><p>
+        Log in with the administrator account you defined in the last 
+        <code class="filename">checksetup.pl</code> run. You should go through 
+        the Parameters page and see if there are any you wish to change.
+        They key parameters are documented in <a class="xref" href="parameters.html" title="3.1. Bugzilla Configuration">Section 3.1, “Bugzilla Configuration”</a>;
+        you should certainly alter 
+        <span class="command"><strong>maintainer</strong></span> and <span class="command"><strong>urlbase</strong></span>; 
+        you may also want to alter 
+        <span class="command"><strong>cookiepath</strong></span> or <span class="command"><strong>requirelogin</strong></span>.
+      </p><p>
+        Bugzilla has several optional features which require extra 
+        configuration. You can read about those in
+        <a class="xref" href="extraconfig.html" title="2.3. Optional Additional Configuration">Section 2.3, “Optional Additional Configuration”</a>.
+      </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="installation.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="installing-bugzilla.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="extraconfig.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2.1. Installation </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 2.3. Optional Additional Configuration</td></tr></table></div></body></html>

diff --git a/docs/en/html/conventions.html b/docs/en/html/conventions.html
new file mode 100644 (file)
index 0000000..1855cdc
--- /dev/null
+++ b/docs/en/html/conventions.html
@@ -0,0 +1,23 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>1.5. Document Conventions</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="about.html" title="Chapter 1. About This Guide"><link rel="prev" href="credits.html" title="1.4. Credits"><link rel="next" href="installing-bugzilla.html" title="Chapter 2. Installing Bugzilla"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">1.5. Document Conventions</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="credits.html">Prev</a> </td><th width="60%" align="center">Chapter 1. About This Guide</th><td width="20%" align="right"> <a accesskey="n" href="installing-bugzilla.html">Next</a></td></tr></table><hr></div><div class="section" title="1.5. Document Conventions"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="conventions"></a>1.5. Document Conventions</h2></div></div></div><p>This document uses the following conventions:</p><div class="caution" title="Caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>This is a caution. Make sure to read this to not be in trouble!</p></td></tr></table></div><div class="tip" title="Tip" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../images/tip.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>This is a hint or tip, especially about some configuration tweaks.</p></td></tr></table></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>This is just a note, for your information.</p></td></tr></table></div><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>This is a warning, something you should take care of.</p></td></tr></table></div><p>
+    A filename or a path to a filename is displayed like this:
+    <code class="filename">/path/to/filename.ext</code>
+  </p><p>
+    A command to type in the shell is displayed like this:
+    <span class="command"><strong>command --arguments</strong></span>
+  </p><p>bash$ represents a normal user's prompt under bash shell</p><p>bash# represents a root user's prompt under bash shell</p><p>
+    A word which is in the glossary will appear like this:
+    <a class="glossterm" href="glossary.html#gloss-bugzilla"><em class="glossterm">Bugzilla</em></a>
+  </p><p>
+    A sample of code is illustrated like this:
+    </p><pre class="programlisting">
+First Line of Code
+Second Line of Code
+...
+    </pre><p>
+  </p><p>
+    This documentation is maintained in DocBook 4.2 XML format.
+    Changes are best submitted as plain text or XML diffs, attached
+    to a bug filed in the <a class="ulink" href="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla;component=Documentation" target="_top">Bugzilla Documentation</a>
+    component.
+  </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="credits.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="about.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="installing-bugzilla.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">1.4. Credits </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 2. Installing Bugzilla</td></tr></table></div></body></html>

diff --git a/docs/en/html/copyright.html b/docs/en/html/copyright.html
new file mode 100644 (file)
index 0000000..8818fa0
--- /dev/null
+++ b/docs/en/html/copyright.html
@@ -0,0 +1,14 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>1.1. Copyright Information</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="about.html" title="Chapter 1. About This Guide"><link rel="prev" href="about.html" title="Chapter 1. About This Guide"><link rel="next" href="disclaimer.html" title="1.2. Disclaimer"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">1.1. Copyright Information</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="about.html">Prev</a> </td><th width="60%" align="center">Chapter 1. About This Guide</th><td width="20%" align="right"> <a accesskey="n" href="disclaimer.html">Next</a></td></tr></table><hr></div><div class="section" title="1.1. Copyright Information"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="copyright"></a>1.1. Copyright Information</h2></div></div></div><p>This document is copyright (c) 2000-2013 by the various
+    Bugzilla contributors who wrote it.</p><div class="blockquote"><blockquote class="blockquote"><p>
+       Permission is granted to copy, distribute and/or modify this
+       document under the terms of the GNU Free Documentation
+       License, Version 1.1 or any later version published by the
+       Free Software Foundation; with no Invariant Sections, no
+       Front-Cover Texts, and with no Back-Cover Texts. A copy of
+       the license is included in <a class="xref" href="gfdl.html" title="Appendix D. GNU Free Documentation License">Appendix D, <i>GNU Free Documentation License</i></a>.
+      </p></blockquote></div><p>
+      If you have any questions regarding this document, its
+      copyright, or publishing this document in non-electronic form,
+      please contact the Bugzilla Team. 
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="about.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="about.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="disclaimer.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 1. About This Guide </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 1.2. Disclaimer</td></tr></table></div></body></html>

diff --git a/docs/en/html/credits.html b/docs/en/html/credits.html
new file mode 100644 (file)
index 0000000..9dea2aa
--- /dev/null
+++ b/docs/en/html/credits.html
@@ -0,0 +1,32 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>1.4. Credits</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="about.html" title="Chapter 1. About This Guide"><link rel="prev" href="newversions.html" title="1.3. New Versions"><link rel="next" href="conventions.html" title="1.5. Document Conventions"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">1.4. Credits</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="newversions.html">Prev</a> </td><th width="60%" align="center">Chapter 1. About This Guide</th><td width="20%" align="right"> <a accesskey="n" href="conventions.html">Next</a></td></tr></table><hr></div><div class="section" title="1.4. Credits"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="credits"></a>1.4. Credits</h2></div></div></div><p>
+      The people listed below have made enormous contributions to the
+      creation of this Guide, through their writing, dedicated hacking efforts,
+      numerous e-mail and IRC support sessions, and overall excellent
+      contribution to the Bugzilla community:
+    </p><div class="variablelist"><dl><dt><span class="term">Matthew P. Barnson <code class="email">&lt;<a class="email" href="mailto:mbarnson@sisna.com">mbarnson@sisna.com</a>&gt;</code></span></dt><dd><p>for the Herculean task of pulling together the Bugzilla Guide
+          and shepherding it to 2.14.
+          </p></dd><dt><span class="term">Terry Weissman <code class="email">&lt;<a class="email" href="mailto:terry@mozilla.org">terry@mozilla.org</a>&gt;</code></span></dt><dd><p>for initially writing Bugzilla and creating the README upon
+          which the UNIX installation documentation is largely based.
+          </p></dd><dt><span class="term">Tara Hernandez <code class="email">&lt;<a class="email" href="mailto:tara@tequilarists.org">tara@tequilarists.org</a>&gt;</code></span></dt><dd><p>for keeping Bugzilla development going strong after Terry left
+          mozilla.org and for running landfill.
+          </p></dd><dt><span class="term">Dave Lawrence <code class="email">&lt;<a class="email" href="mailto:dkl@redhat.com">dkl@redhat.com</a>&gt;</code></span></dt><dd><p>for providing insight into the key differences between Red
+          Hat's customized Bugzilla.
+          </p></dd><dt><span class="term">Dawn Endico <code class="email">&lt;<a class="email" href="mailto:endico@mozilla.org">endico@mozilla.org</a>&gt;</code></span></dt><dd><p>for being a hacker extraordinaire and putting up with Matthew's
+          incessant questions and arguments on irc.mozilla.org in #mozwebtools
+          </p></dd><dt><span class="term">Jacob Steenhagen <code class="email">&lt;<a class="email" href="mailto:jake@bugzilla.org">jake@bugzilla.org</a>&gt;</code></span></dt><dd><p>for taking over documentation during the 2.17 development
+          period.
+          </p></dd><dt><span class="term">Dave Miller <code class="email">&lt;<a class="email" href="mailto:justdave@bugzilla.org">justdave@bugzilla.org</a>&gt;</code></span></dt><dd><p>for taking over as project lead when Tara stepped down and
+         continually pushing for the documentation to be the best it can be.
+          </p></dd></dl></div><p>
+      Thanks also go to the following people for significant contributions 
+      to this documentation:
+      <span class="simplelist">Kevin Brannen, Vlad Dascalu, Ben FrantzDale, Eric Hanson, Zach Lipton, Gervase Markham, Andrew Pearson, Joe Robins, Spencer Smith, Ron Teitelbaum, Shane Travis, Martin Wulffeld</span>.
+    </p><p>
+      Also, thanks are due to the members of the 
+      <a class="ulink" href="news://news.mozilla.org/mozilla.support.bugzilla" target="_top">
+      mozilla.support.bugzilla</a>
+      newsgroup (and its predecessor, netscape.public.mozilla.webtools).
+      Without your discussions, insight, suggestions, and patches,
+      this could never have happened.
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="newversions.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="about.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="conventions.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">1.3. New Versions </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 1.5. Document Conventions</td></tr></table></div></body></html>

diff --git a/docs/en/html/cust-change-permissions.html b/docs/en/html/cust-change-permissions.html
new file mode 100644 (file)
index 0000000..1f4b7f4
--- /dev/null
+++ b/docs/en/html/cust-change-permissions.html
@@ -0,0 +1,91 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>6.4. Customizing Who Can Change What</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="customization.html" title="Chapter 6. Customizing Bugzilla"><link rel="prev" href="cust-templates.html" title="6.3. Template Customization"><link rel="next" href="integration.html" title="6.5. Integrating Bugzilla with Third-Party Tools"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">6.4. Customizing Who Can Change What</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="cust-templates.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Customizing Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="integration.html">Next</a></td></tr></table><hr></div><div class="section" title="6.4. Customizing Who Can Change What"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="cust-change-permissions"></a>6.4. Customizing Who Can Change What</h2></div></div></div><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        This feature should be considered experimental; the Bugzilla code you
+        will be changing is not stable, and could change or move between 
+        versions. Be aware that if you make modifications as outlined here, 
+        you may have
+        to re-make them or port them if Bugzilla changes internally between
+        versions, and you upgrade.
+      </p></td></tr></table></div><p>
+      Companies often have rules about which employees, or classes of employees,
+      are allowed to change certain things in the bug system. For example, 
+      only the bug's designated QA Contact may be allowed to VERIFY the bug.
+      Bugzilla has been
+      designed to make it easy for you to write your own custom rules to define
+      who is allowed to make what sorts of value transition.
+    </p><p>
+     By default, assignees, QA owners and users
+     with <span class="emphasis"><em>editbugs</em></span> privileges can edit all fields of bugs, 
+     except group restrictions (unless they are members of the groups they 
+     are trying to change). Bug reporters also have the ability to edit some 
+     fields, but in a more restrictive manner. Other users, without 
+     <span class="emphasis"><em>editbugs</em></span> privileges, cannot edit 
+     bugs, except to comment and add themselves to the CC list.
+    </p><p>
+      For maximum flexibility, customizing this means editing Bugzilla's Perl 
+      code. This gives the administrator complete control over exactly who is
+      allowed to do what. The relevant method is called
+      <code class="filename">check_can_change_field()</code>,
+      and is found in <code class="filename">Bug.pm</code> in your
+      Bugzilla/ directory. If you open that file and search for
+      <span class="quote">“<span class="quote">sub check_can_change_field</span>”</span>, you'll find it.
+    </p><p>
+      This function has been carefully commented to allow you to see exactly
+      how it works, and give you an idea of how to make changes to it.
+      Certain marked sections should not be changed - these are
+      the <span class="quote">“<span class="quote">plumbing</span>”</span> which makes the rest of the function work.
+      In between those sections, you'll find snippets of code like:
+      </p><pre class="programlisting">    # Allow the assignee to change anything.
+    if ($ownerid eq $whoid) {
+        return 1;
+    }</pre><p>
+      It's fairly obvious what this piece of code does.
+    </p><p>
+      So, how does one go about changing this function? Well, simple changes
+      can be made just by removing pieces - for example, if you wanted to 
+      prevent any user adding a comment to a bug, just remove the lines marked
+      <span class="quote">“<span class="quote">Allow anyone to change comments.</span>”</span> If you don't want the
+      Reporter to have any special rights on bugs they have filed, just
+      remove the entire section that deals with the Reporter.
+    </p><p>
+      More complex customizations are not much harder. Basically, you add
+      a check in the right place in the function, i.e. after all the variables
+      you are using have been set up. So, don't look at $ownerid before 
+      $ownerid has been obtained from the database. You can either add a
+      positive check, which returns 1 (allow) if certain conditions are true,
+      or a negative check, which returns 0 (deny.) E.g.:
+      </p><pre class="programlisting">    if ($field eq "qacontact") {
+        if (Bugzilla-&gt;user-&gt;in_group("quality_assurance")) {
+            return 1;
+        } 
+        else {
+            return 0;
+        }
+    }</pre><p>
+      This says that only users in the group "quality_assurance" can change
+      the QA Contact field of a bug.
+    </p><p>
+      Getting more weird:
+      </p><pre class="programlisting">    if (($field eq "priority") &amp;&amp;
+        (Bugzilla-&gt;user-&gt;email =~ /.*\@example\.com$/))
+    {
+        if ($oldvalue eq "P1") {
+            return 1;
+        } 
+        else {
+            return 0;
+        }
+    }</pre><p>
+      This says that if the user is trying to change the priority field,
+      and their email address is @example.com, they can only do so if the
+      old value of the field was "P1". Not very useful, but illustrative.
+    </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        If you are modifying <code class="filename">process_bug.cgi</code> in any
+        way, do not change the code that is bounded by DO_NOT_CHANGE blocks.
+        Doing so could compromise security, or cause your installation to
+        stop working entirely.
+      </p></td></tr></table></div><p>
+      For a list of possible field names, look at the bugs table in the 
+      database. If you need help writing custom rules for your organization,
+      ask in the newsgroup.
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="cust-templates.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="customization.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="integration.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">6.3. Template Customization </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 6.5. Integrating Bugzilla with Third-Party Tools</td></tr></table></div></body></html>

diff --git a/docs/en/html/cust-skins.html b/docs/en/html/cust-skins.html
new file mode 100644 (file)
index 0000000..b76de7f
--- /dev/null
+++ b/docs/en/html/cust-skins.html
@@ -0,0 +1,22 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>6.2. Custom Skins</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="customization.html" title="Chapter 6. Customizing Bugzilla"><link rel="prev" href="extensions.html" title="6.1. Bugzilla Extensions"><link rel="next" href="cust-templates.html" title="6.3. Template Customization"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">6.2. Custom Skins</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="extensions.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Customizing Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="cust-templates.html">Next</a></td></tr></table><hr></div><div class="section" title="6.2. Custom Skins"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="cust-skins"></a>6.2. Custom Skins</h2></div></div></div><p>
+      Bugzilla allows you to have multiple skins. These are custom CSS and possibly
+      also custom images for Bugzilla. To create a new custom skin, you have two
+      choices:
+      </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
+            Make a single CSS file, and put it in the 
+            <code class="filename">skins/contrib</code> directory.
+          </p></li><li class="listitem"><p>
+            Make a directory that contains all the same CSS file
+            names as <code class="filename">skins/standard/</code>, and put
+            your directory in <code class="filename">skins/contrib/</code>.
+          </p></li></ul></div><p>
+    </p><p>
+      After you put the file or the directory there, make sure to run checksetup.pl
+      so that it can reset the file permissions correctly.
+    </p><p>
+      After you have installed the new skin, it will show up as an option in the
+      user's General Preferences. If you would like to force a particular skin on all
+      users, just select it in the Default Preferences and then uncheck "Enabled" on
+      the preference.
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="extensions.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="customization.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="cust-templates.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">6.1. Bugzilla Extensions </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 6.3. Template Customization</td></tr></table></div></body></html>

diff --git a/docs/en/html/cust-templates.html b/docs/en/html/cust-templates.html
new file mode 100644 (file)
index 0000000..7f8966e
--- /dev/null
+++ b/docs/en/html/cust-templates.html
@@ -0,0 +1,267 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>6.3. Template Customization</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="customization.html" title="Chapter 6. Customizing Bugzilla"><link rel="prev" href="cust-skins.html" title="6.2. Custom Skins"><link rel="next" href="cust-change-permissions.html" title="6.4. Customizing Who Can Change What"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">6.3. Template Customization</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="cust-skins.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Customizing Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="cust-change-permissions.html">Next</a></td></tr></table><hr></div><div class="section" title="6.3. Template Customization"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="cust-templates"></a>6.3. Template Customization</h2></div></div></div><p>
+      Administrators can configure the look and feel of Bugzilla without
+      having to edit Perl files or face the nightmare of massive merge
+      conflicts when they upgrade to a newer version in the future.
+    </p><p>
+      Templatization also makes localized versions of Bugzilla possible, 
+      for the first time. It's possible to have Bugzilla's UI language 
+      determined by the user's browser. More information is available in
+      <a class="xref" href="cust-templates.html#template-http-accept" title="6.3.6. Configuring Bugzilla to Detect the User's Language">Section 6.3.6, “Configuring Bugzilla to Detect the User's Language”</a>.
+    </p><div class="section" title="6.3.1. Template Directory Structure"><div class="titlepage"><div><div><h3 class="title"><a name="template-directory"></a>6.3.1. Template Directory Structure</h3></div></div></div><p>
+        The template directory structure starts with top level directory 
+        named <code class="filename">template</code>, which contains a directory
+        for each installed localization. The next level defines the
+        language used in the templates. Bugzilla comes with English
+        templates, so the directory name is <code class="filename">en</code>,
+        and we will discuss <code class="filename">template/en</code> throughout
+        the documentation. Below <code class="filename">template/en</code> is the
+        <code class="filename">default</code> directory, which contains all the
+        standard templates shipped with Bugzilla.
+      </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          A directory <code class="filename">data/templates</code> also exists;
+          this is where Template Toolkit puts the compiled versions of
+          the templates from either the default or custom directories.
+          <span class="emphasis"><em>Do not</em></span> directly edit the files in this
+          directory, or all your changes will be lost the next time
+          Template Toolkit recompiles the templates.
+        </p></td></tr></table></div></div><div class="section" title="6.3.2. Choosing a Customization Method"><div class="titlepage"><div><div><h3 class="title"><a name="template-method"></a>6.3.2. Choosing a Customization Method</h3></div></div></div><p>
+        If you want to edit Bugzilla's templates, the first decision
+        you must make is how you want to go about doing so. There are two
+        choices, and which you use depends mainly on the scope of your 
+        modifications, and the method you plan to use to upgrade Bugzilla.
+      </p><p>
+        The first method of making customizations is to directly edit the
+        templates found in <code class="filename">template/en/default</code>.
+        This is probably the best way to go about it if you are going to
+        be upgrading Bugzilla through Bzr, because if you then execute
+        a <span class="command"><strong>bzr update</strong></span>, any changes you have made will
+        be merged automagically with the updated versions.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          If you use this method, and Bzr conflicts occur during an
+          update, the conflicted templates (and possibly other parts
+          of your installation) will not work until they are resolved.
+        </p></td></tr></table></div><p>
+        The second method is to copy the templates to be modified
+        into a mirrored directory structure under 
+        <code class="filename">template/en/custom</code>. Templates in this
+        directory structure automatically override any identically-named
+        and identically-located templates in the 
+        <code class="filename">default</code> directory. 
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          The <code class="filename">custom</code> directory does not exist
+          at first and must be created if you want to use it.
+        </p></td></tr></table></div><p>
+        The second method of customization should be used if you 
+        use the overwriting method of upgrade, because otherwise 
+        your changes will be lost.  This method may also be better if
+        you are using the Bzr method of upgrading and are going to make major
+        changes, because it is guaranteed that the contents of this directory
+        will not be touched during an upgrade, and you can then decide whether
+        to continue using your own templates, or make the effort to merge your
+        changes into the new versions by hand.
+      </p><p>
+        Using this method, your installation may break if incompatible
+        changes are made to the template interface.  Such changes should
+        be documented in the release notes, provided you are using a
+        stable release of Bugzilla.  If you use using unstable code, you will
+        need to deal with this one yourself, although if possible the changes
+        will be mentioned before they occur in the deprecations section of the
+        previous stable release's release notes.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Regardless of which method you choose, it is recommended that
+          you run <span class="command"><strong>./checksetup.pl</strong></span> after 
+          editing any templates in the <code class="filename">template/en/default</code>
+          directory, and after creating or editing any templates in the 
+          <code class="filename">custom</code> directory.
+        </p></td></tr></table></div><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          It is <span class="emphasis"><em>required</em></span> that you run 
+          <span class="command"><strong>./checksetup.pl</strong></span> after creating a new
+          template in the <code class="filename">custom</code> directory. Failure
+          to do so will raise an incomprehensible error message.
+        </p></td></tr></table></div></div><div class="section" title="6.3.3. How To Edit Templates"><div class="titlepage"><div><div><h3 class="title"><a name="template-edit"></a>6.3.3. How To Edit Templates</h3></div></div></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          If you are making template changes that you intend on submitting back
+          for inclusion in standard Bugzilla, you should read the relevant
+          sections of the 
+          <a class="ulink" href="http://www.bugzilla.org/docs/developer.html" target="_top">Developers'
+          Guide</a>.
+        </p></td></tr></table></div><p>
+        The syntax of the Template Toolkit language is beyond the scope of
+        this guide. It's reasonably easy to pick up by looking at the current 
+        templates; or, you can read the manual, available on the
+        <a class="ulink" href="http://www.template-toolkit.org" target="_top">Template Toolkit home
+        page</a>.
+      </p><p>
+        One thing you should take particular care about is the need
+        to properly HTML filter data that has been passed into the template.
+        This means that if the data can possibly contain special HTML characters
+        such as &lt;, and the data was not intended to be HTML, they need to be
+        converted to entity form, i.e. &amp;lt;.  You use the 'html' filter in the
+        Template Toolkit to do this (or the 'uri' filter to encode special
+        characters in URLs).  If you forget, you may open up your installation
+        to cross-site scripting attacks.
+      </p><p>
+        Editing templates is a good way of doing a <span class="quote">“<span class="quote">poor man's custom
+        fields</span>”</span>.
+        For example, if you don't use the Status Whiteboard, but want to have
+        a free-form text entry box for <span class="quote">“<span class="quote">Build Identifier</span>”</span>,
+        then you can just
+        edit the templates to change the field labels. It's still be called
+        status_whiteboard internally, but your users don't need to know that.
+      </p></div><div class="section" title="6.3.4. Template Formats and Types"><div class="titlepage"><div><div><h3 class="title"><a name="template-formats"></a>6.3.4. Template Formats and Types</h3></div></div></div><p>
+        Some CGI's have the ability to use more than one template. For example,
+        <code class="filename">buglist.cgi</code> can output itself as RDF, or as two 
+        formats of HTML (complex and simple). The mechanism that provides this 
+        feature is extensible.
+      </p><p>
+        Bugzilla can support different types of output, which again can have 
+        multiple formats. In order to request a certain type, you can append 
+        the &amp;ctype=&lt;contenttype&gt; (such as rdf or html) to the 
+        <code class="filename">&lt;cginame&gt;.cgi</code> URL. If you would like to 
+        retrieve a certain format, you can use the &amp;format=&lt;format&gt; 
+        (such as simple or complex) in the URL.
+      </p><p>
+        To see if a CGI supports multiple output formats and types, grep the
+        CGI for <span class="quote">“<span class="quote">get_format</span>”</span>. If it's not present, adding
+        multiple format/type support isn't too hard - see how it's done in
+        other CGIs, e.g. config.cgi.
+      </p><p>
+        To make a new format template for a CGI which supports this, 
+        open a current template for
+        that CGI and take note of the INTERFACE comment (if present.) This 
+        comment defines what variables are passed into this template. If 
+        there isn't one, I'm afraid you'll have to read the template and
+        the code to find out what information you get. 
+      </p><p>
+        Write your template in whatever markup or text style is appropriate.
+      </p><p>
+        You now need to decide what content type you want your template
+        served as. The content types are defined in the
+        <code class="filename">Bugzilla/Constants.pm</code> file in the 
+        <code class="filename">contenttypes</code>
+        constant. If your content type is not there, add it. Remember
+        the three- or four-letter tag assigned to your content type. 
+        This tag will be part of the template filename.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          After adding or changing a content type, it's suitable to edit
+          <code class="filename">Bugzilla/Constants.pm</code> in order to reflect
+          the changes. Also, the file should be kept up to date after an
+          upgrade if content types have been customized in the past. 
+        </p></td></tr></table></div><p>
+        Save the template as <code class="filename">&lt;stubname&gt;-&lt;formatname&gt;.&lt;contenttypetag&gt;.tmpl</code>. 
+        Try out the template by calling the CGI as 
+        <code class="filename">&lt;cginame&gt;.cgi?format=&lt;formatname&gt;&amp;ctype=&lt;type&gt;</code> .
+      </p></div><div class="section" title="6.3.5. Particular Templates"><div class="titlepage"><div><div><h3 class="title"><a name="template-specific"></a>6.3.5. Particular Templates</h3></div></div></div><p>
+        There are a few templates you may be particularly interested in
+        customizing for your installation.
+      </p><p>
+        <span class="command"><strong>index.html.tmpl</strong></span>:
+        This is the Bugzilla front page.
+      </p><p>
+        <span class="command"><strong>global/header.html.tmpl</strong></span>:
+        This defines the header that goes on all Bugzilla pages.
+        The header includes the banner, which is what appears to users
+        and is probably what you want to edit instead.  However the
+        header also includes the HTML HEAD section, so you could for
+        example add a stylesheet or META tag by editing the header.
+      </p><p>
+        <span class="command"><strong>global/banner.html.tmpl</strong></span>:
+        This contains the <span class="quote">“<span class="quote">banner</span>”</span>, the part of the header
+        that appears
+        at the top of all Bugzilla pages.  The default banner is reasonably
+        barren, so you'll probably want to customize this to give your
+        installation a distinctive look and feel.  It is recommended you
+        preserve the Bugzilla version number in some form so the version 
+        you are running can be determined, and users know what docs to read.
+      </p><p>
+        <span class="command"><strong>global/footer.html.tmpl</strong></span>:
+        This defines the footer that goes on all Bugzilla pages.  Editing
+        this is another way to quickly get a distinctive look and feel for
+        your Bugzilla installation.
+      </p><p>
+        <span class="command"><strong>global/variables.none.tmpl</strong></span>:
+        This defines a list of terms that may be changed in order to
+        <span class="quote">“<span class="quote">brand</span>”</span> the Bugzilla instance In this way, terms
+        like <span class="quote">“<span class="quote">bugs</span>”</span> can be replaced with <span class="quote">“<span class="quote">issues</span>”</span>
+        across the whole Bugzilla installation. The name
+        <span class="quote">“<span class="quote">Bugzilla</span>”</span> and other words can be customized as well.
+      </p><p>
+        <span class="command"><strong>list/table.html.tmpl</strong></span>:
+        This template controls the appearance of the bug lists created
+        by Bugzilla. Editing this template allows per-column control of 
+        the width and title of a column, the maximum display length of
+        each entry, and the wrap behaviour of long entries.
+        For long bug lists, Bugzilla inserts a 'break' every 100 bugs by
+        default; this behaviour is also controlled by this template, and
+        that value can be modified here.
+       </p><p>
+        <span class="command"><strong>bug/create/user-message.html.tmpl</strong></span>:
+        This is a message that appears near the top of the bug reporting page.
+        By modifying this, you can tell your users how they should report
+        bugs.
+      </p><p>
+        <span class="command"><strong>bug/process/midair.html.tmpl</strong></span>:
+        This is the page used if two people submit simultaneous changes to the
+        same bug.  The second person to submit their changes will get this page
+        to tell them what the first person did, and ask if they wish to
+        overwrite those changes or go back and revisit the bug.  The default
+        title and header on this page read "Mid-air collision detected!"  If
+        you work in the aviation industry, or other environment where this
+        might be found offensive (yes, we have true stories of this happening)
+        you'll want to change this to something more appropriate for your
+        environment.
+      </p><p>
+        <span class="command"><strong>bug/create/create.html.tmpl</strong></span> and
+        <span class="command"><strong>bug/create/comment.txt.tmpl</strong></span>:
+        You may not wish to go to the effort of creating custom fields in
+        Bugzilla, yet you want to make sure that each bug report contains
+        a number of pieces of important information for which there is not
+        a special field. The bug entry system has been designed in an
+        extensible fashion to enable you to add arbitrary HTML widgets,
+        such as drop-down lists or textboxes, to the bug entry page
+        and have their values appear formatted in the initial comment.
+        A hidden field that indicates the format should be added inside
+        the form in order to make the template functional. Its value should
+        be the suffix of the template filename. For example, if the file
+        is called <code class="filename">create-cust.html.tmpl</code>, then
+        </p><pre class="programlisting">&lt;input type="hidden" name="format" value="cust"&gt;</pre><p>
+        should be used inside the form.
+      </p><p>  
+        An example of this is the mozilla.org 
+        <a class="ulink" href="http://landfill.bugzilla.org/bugzilla-tip/enter_bug.cgi?product=WorldControl;format=guided" target="_top">guided
+        bug submission form</a>. The code for this comes with the Bugzilla
+        distribution as an example for you to copy. It can be found in the
+        files 
+        <code class="filename">create-guided.html.tmpl</code> and
+        <code class="filename">comment-guided.html.tmpl</code>.
+      </p><p>
+        So to use this feature, create a custom template for 
+        <code class="filename">enter_bug.cgi</code>. The default template, on which you
+        could base it, is 
+        <code class="filename">custom/bug/create/create.html.tmpl</code>.
+        Call it <code class="filename">create-&lt;formatname&gt;.html.tmpl</code>, and
+        in it, add widgets for each piece of information you'd like
+        collected - such as a build number, or set of steps to reproduce.
+      </p><p>
+        Then, create a template like 
+        <code class="filename">custom/bug/create/comment.txt.tmpl</code>, and call it 
+        <code class="filename">comment-&lt;formatname&gt;.txt.tmpl</code>. This 
+        template should reference the form fields you have created using
+        the syntax <code class="filename">[% form.&lt;fieldname&gt; %]</code>. When a 
+        bug report is
+        submitted, the initial comment attached to the bug report will be
+        formatted according to the layout of this template.
+      </p><p>
+        For example, if your custom enter_bug template had a field
+        </p><pre class="programlisting">&lt;input type="text" name="buildid" size="30"&gt;</pre><p>
+        and then your comment.txt.tmpl had
+        </p><pre class="programlisting">BuildID: [% form.buildid %]</pre><p>
+        then something like
+        </p><pre class="programlisting">BuildID: 20020303</pre><p>
+        would appear in the initial comment.
+      </p></div><div class="section" title="6.3.6. Configuring Bugzilla to Detect the User's Language"><div class="titlepage"><div><div><h3 class="title"><a name="template-http-accept"></a>6.3.6. Configuring Bugzilla to Detect the User's Language</h3></div></div></div><p>Bugzilla honours the user's Accept: HTTP header. You can install
+      templates in other languages, and Bugzilla will pick the most appropriate
+      according to a priority order defined by you. Many
+      language templates can be obtained from <a class="ulink" href="http://www.bugzilla.org/download.html#localizations" target="_top">http://www.bugzilla.org/download.html#localizations</a>. Instructions
+      for submitting new languages are also available from that location.
+      </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="cust-skins.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="customization.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="cust-change-permissions.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">6.2. Custom Skins </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 6.4. Customizing Who Can Change What</td></tr></table></div></body></html>

diff --git a/docs/en/html/custom-fields.html b/docs/en/html/custom-fields.html
new file mode 100644 (file)
index 0000000..8cfc9e4
--- /dev/null
+++ b/docs/en/html/custom-fields.html
@@ -0,0 +1,130 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.10. Custom Fields</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="keywords.html" title="3.9. Keywords"><link rel="next" href="edit-values.html" title="3.11. Legal Values"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.10. Custom Fields</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="keywords.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="edit-values.html">Next</a></td></tr></table><hr></div><div class="section" title="3.10. Custom Fields"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="custom-fields"></a>3.10. Custom Fields</h2></div></div></div><p>
+      The release of Bugzilla 3.0 added the ability to create Custom Fields. 
+      Custom Fields are treated like any other field - they can be set in bugs
+      and used for search queries. Administrators should keep in mind that
+      adding too many fields can make the user interface more complicated and
+      harder to use. Custom Fields should be added only when necessary and with 
+      careful consideration.
+    </p><div class="tip" title="Tip" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../images/tip.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        Before adding a Custom Field, make sure that Bugzilla cannot already
+        do the desired behavior. Many Bugzilla options are not enabled by 
+        default, and many times Administrators find that simply enabling
+        certain options that already exist is sufficient. 
+      </p></td></tr></table></div><p>
+      Administrators can manage Custom Fields using the
+      <span class="quote">“<span class="quote">Custom Fields</span>”</span> link on the Administration page. The Custom
+      Fields administration page displays a list of Custom Fields, if any exist,
+      and a link to "Add a new custom field". 
+    </p><div class="section" title="3.10.1. Adding Custom Fields"><div class="titlepage"><div><div><h3 class="title"><a name="add-custom-fields"></a>3.10.1. Adding Custom Fields</h3></div></div></div><p>
+        To add a new Custom Field, click the "Add a new custom field" link. This
+        page displays several options for the new field, described below.
+      </p><p>
+        The following attributes must be set for each new custom field:
+        </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
+              <span class="emphasis"><em>Name:</em></span>
+              The name of the field in the database, used internally. This name 
+              MUST begin with <span class="quote">“<span class="quote">cf_</span>”</span> to prevent confusion with 
+              standard fields. If this string is omitted, it will
+              be automatically added to the name entered. 
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Description:</em></span>
+              A brief string which is used as the label for this Custom Field.
+              That is the string that users will see, and should be
+              short and explicit.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Type:</em></span>
+              The type of field to create. There are
+              several types available:
+              </p><div class="variablelist"><dl><dt><span class="term">Bug ID:</span></dt><dd><p>
+                      A field where you can enter the ID of another bug from
+                      the same Bugzilla installation. To point to a bug in a remote
+                      installation, use the See Also field instead.
+                    </p></dd><dt><span class="term">Large Text Box:</span></dt><dd><p>
+                      A multiple line box for entering free text.
+                    </p></dd><dt><span class="term">Free Text:</span></dt><dd><p>
+                      A single line box for entering free text.
+                    </p></dd><dt><span class="term">Multiple-Selection Box:</span></dt><dd><p>
+                      A list box where multiple options
+                      can be selected. After creating this field, it must be edited
+                      to add the selection options. See
+                      <a class="xref" href="edit-values.html#edit-values-list" title="3.11.1. Viewing/Editing legal values">Section 3.11.1, “Viewing/Editing legal values”</a> for information about
+                      editing legal values.
+                    </p></dd><dt><span class="term">Drop Down:</span></dt><dd><p>
+                      A list box where only one option can be selected.
+                      After creating this field, it must be edited to add the
+                      selection options. See
+                      <a class="xref" href="edit-values.html#edit-values-list" title="3.11.1. Viewing/Editing legal values">Section 3.11.1, “Viewing/Editing legal values”</a> for information about
+                      editing legal values.
+                    </p></dd><dt><span class="term">Date/Time:</span></dt><dd><p>
+                      A date field. This field appears with a
+                      calendar widget for choosing the date.
+                    </p></dd></dl></div><p>
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Sortkey:</em></span>
+              Integer that determines in which order Custom Fields are
+              displayed in the User Interface, especially when viewing a bug. 
+              Fields with lower values are displayed first.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Reverse Relationship Description:</em></span>
+              When the custom field is of type <span class="quote">“<span class="quote">Bug ID</span>”</span>, you can
+              enter text here which will be used as label in the referenced
+              bug to list bugs which point to it. This gives you the ability
+              to have a mutual relationship between two bugs.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Can be set on bug creation:</em></span>
+              Boolean that determines whether this field can be set on
+              bug creation. If not selected, then a bug must be created 
+              before this field can be set. See <a class="xref" href="bugreports.html" title="5.6. Filing Bugs">Section 5.6, “Filing Bugs”</a> 
+              for information about filing bugs.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Displayed in bugmail for new bugs:</em></span>
+              Boolean that determines whether the value set on this field
+              should appear in bugmail when the bug is filed. This attribute
+              has no effect if the field cannot be set on bug creation.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Is obsolete:</em></span>
+              Boolean that determines whether this field should
+              be displayed at all. Obsolete Custom Fields are hidden.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Is mandatory:</em></span>
+              Boolean that determines whether this field must be set.
+              For single and multi-select fields, this means that a (non-default)
+              value must be selected, and for text and date fields, some text
+              must be entered.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Field only appears when:</em></span>
+              A custom field can be made visible when some criteria is met.
+              For instance, when the bug belongs to one or more products,
+              or when the bug is of some given severity. If left empty, then
+              the custom field will always be visible, in all bugs.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Field that controls the values that appear in this field:</em></span>
+              When the custom field is of type <span class="quote">“<span class="quote">Drop Down</span>”</span> or
+              <span class="quote">“<span class="quote">Multiple-Selection Box</span>”</span>, you can restrict the
+              availability of the values of the custom field based on the
+              value of another field. This criteria is independent of the
+              criteria used in the <span class="quote">“<span class="quote">Field only appears when</span>”</span>
+              setting. For instance, you may decide that some given value
+              <span class="quote">“<span class="quote">valueY</span>”</span> is only available when the bug status
+              is RESOLVED while the value <span class="quote">“<span class="quote">valueX</span>”</span> should
+              always be listed.
+              Once you have selected the field which should control the
+              availability of the values of this custom field, you can
+              edit values of this custom field to set the criteria, see
+              <a class="xref" href="edit-values.html#edit-values-list" title="3.11.1. Viewing/Editing legal values">Section 3.11.1, “Viewing/Editing legal values”</a>.
+            </p></li></ul></div><p>
+      </p></div><div class="section" title="3.10.2. Editing Custom Fields"><div class="titlepage"><div><div><h3 class="title"><a name="edit-custom-fields"></a>3.10.2. Editing Custom Fields</h3></div></div></div><p>
+        As soon as a Custom Field is created, its name and type cannot be
+        changed. If this field is a drop down menu, its legal values can
+        be set as described in <a class="xref" href="edit-values.html#edit-values-list" title="3.11.1. Viewing/Editing legal values">Section 3.11.1, “Viewing/Editing legal values”</a>. All
+        other attributes can be edited as described above.
+      </p></div><div class="section" title="3.10.3. Deleting Custom Fields"><div class="titlepage"><div><div><h3 class="title"><a name="delete-custom-fields"></a>3.10.3. Deleting Custom Fields</h3></div></div></div><p>
+        Only custom fields which are marked as obsolete, and which never
+        have been used, can be deleted completely (else the integrity
+        of the bug history would be compromised). For custom fields marked
+        as obsolete, a "Delete" link will appear in the <span class="quote">“<span class="quote">Action</span>”</span>
+        column. If the custom field has been used in the past, the deletion
+        will be rejected. But marking the field as obsolete is sufficient
+        to hide it from the user interface entirely.
+      </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="keywords.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="administration.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="edit-values.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.9. Keywords </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.11. Legal Values</td></tr></table></div></body></html>

diff --git a/docs/en/html/customization.html b/docs/en/html/customization.html
new file mode 100644 (file)
index 0000000..b680df9
--- /dev/null
+++ b/docs/en/html/customization.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 6. Customizing Bugzilla</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="prev" href="whining.html" title="5.13. Whining"><link rel="next" href="extensions.html" title="6.1. Bugzilla Extensions"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 6. Customizing Bugzilla</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="whining.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="extensions.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 6. Customizing Bugzilla"><div class="titlepage"><div><div><h2 class="title"><a name="customization"></a>Chapter 6. Customizing Bugzilla</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="extensions.html">6.1. Bugzilla Extensions</a></span></dt><dt><span class="section"><a href="cust-skins.html">6.2. Custom Skins</a></span></dt><dt><span class="section"><a href="cust-templates.html">6.3. Template Customization</a></span></dt><dd><dl><dt><span class="section"><a href="cust-templates.html#template-directory">6.3.1. Template Directory Structure</a></span></dt><dt><span class="section"><a href="cust-templates.html#template-method">6.3.2. Choosing a Customization Method</a></span></dt><dt><span class="section"><a href="cust-templates.html#template-edit">6.3.3. How To Edit Templates</a></span></dt><dt><span class="section"><a href="cust-templates.html#template-formats">6.3.4. Template Formats and Types</a></span></dt><dt><span class="section"><a href="cust-templates.html#template-specific">6.3.5. Particular Templates</a></span></dt><dt><span class="section"><a href="cust-templates.html#template-http-accept">6.3.6. Configuring Bugzilla to Detect the User's Language</a></span></dt></dl></dd><dt><span class="section"><a href="cust-change-permissions.html">6.4. Customizing Who Can Change What</a></span></dt><dt><span class="section"><a href="integration.html">6.5. Integrating Bugzilla with Third-Party Tools</a></span></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="whining.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="extensions.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5.13. Whining </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 6.1. Bugzilla Extensions</td></tr></table></div></body></html>

diff --git a/docs/en/html/disclaimer.html b/docs/en/html/disclaimer.html
new file mode 100644 (file)
index 0000000..a86cae2
--- /dev/null
+++ b/docs/en/html/disclaimer.html
@@ -0,0 +1,25 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>1.2. Disclaimer</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="about.html" title="Chapter 1. About This Guide"><link rel="prev" href="copyright.html" title="1.1. Copyright Information"><link rel="next" href="newversions.html" title="1.3. New Versions"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">1.2. Disclaimer</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="copyright.html">Prev</a> </td><th width="60%" align="center">Chapter 1. About This Guide</th><td width="20%" align="right"> <a accesskey="n" href="newversions.html">Next</a></td></tr></table><hr></div><div class="section" title="1.2. Disclaimer"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="disclaimer"></a>1.2. Disclaimer</h2></div></div></div><p>
+      No liability for the contents of this document can be accepted.
+      Follow the instructions herein at your own risk.
+      This document may contain errors
+      and inaccuracies that may damage your system, cause your partner 
+      to leave you, your boss to fire you, your cats to
+      pee on your furniture and clothing, and global thermonuclear
+      war. Proceed with caution.
+    </p><p>
+      Naming of particular products or brands should not be seen as
+      endorsements, with the exception of the term "GNU/Linux". We
+      wholeheartedly endorse the use of GNU/Linux; it is an extremely 
+      versatile, stable,
+      and robust operating system that offers an ideal operating
+      environment for Bugzilla.
+    </p><p>
+      Although the Bugzilla development team has taken great care to
+      ensure that all exploitable bugs have been fixed, security holes surely 
+      exist in any piece of code. Great care should be taken both in 
+      the installation and usage of this software. The Bugzilla development
+      team members assume no liability for your use of Bugzilla. You have 
+      the source code, and are responsible for auditing it yourself to ensure
+      your security needs are met.
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="copyright.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="about.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="newversions.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">1.1. Copyright Information </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 1.3. New Versions</td></tr></table></div></body></html>

diff --git a/docs/en/html/edit-values.html b/docs/en/html/edit-values.html
new file mode 100644 (file)
index 0000000..2fa7371
--- /dev/null
+++ b/docs/en/html/edit-values.html
@@ -0,0 +1,29 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.11. Legal Values</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="custom-fields.html" title="3.10. Custom Fields"><link rel="next" href="bug_status_workflow.html" title="3.12. Bug Status Workflow"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.11. Legal Values</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="custom-fields.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="bug_status_workflow.html">Next</a></td></tr></table><hr></div><div class="section" title="3.11. Legal Values"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="edit-values"></a>3.11. Legal Values</h2></div></div></div><p>
+      Legal values for the operating system, platform, bug priority and
+      severity, custom fields of type <span class="quote">“<span class="quote">Drop Down</span>”</span> and
+      <span class="quote">“<span class="quote">Multiple-Selection Box</span>”</span> (see <a class="xref" href="custom-fields.html" title="3.10. Custom Fields">Section 3.10, “Custom Fields”</a>),
+      as well as the list of valid bug statuses and resolutions can be
+      customized from the same interface. You can add, edit, disable and
+      remove values which can be used with these fields.
+    </p><div class="section" title="3.11.1. Viewing/Editing legal values"><div class="titlepage"><div><div><h3 class="title"><a name="edit-values-list"></a>3.11.1. Viewing/Editing legal values</h3></div></div></div><p>
+        Editing legal values requires <span class="quote">“<span class="quote">admin</span>”</span> privileges.
+        Select "Field Values" from the Administration page. A list of all
+        fields, both system fields and Custom Fields, for which legal values
+        can be edited appears. Click a field name to edit its legal values.
+      </p><p>
+        There is no limit to how many values a field can have, but each value 
+        must be unique to that field. The sortkey is important to display these
+        values in the desired order.
+      </p><p>
+        When the availability of the values of a custom field is controlled
+        by another field, you can select from here which value of the other field
+        must be set for the value of the custom field to appear.
+      </p></div><div class="section" title="3.11.2. Deleting legal values"><div class="titlepage"><div><div><h3 class="title"><a name="edit-values-delete"></a>3.11.2. Deleting legal values</h3></div></div></div><p>
+        Legal values from Custom Fields can be deleted, but only if the 
+        following two conditions are respected:
+      </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>The value is not used by default for the field.</p></li><li class="listitem"><p>No bug is currently using this value.</p></li></ol></div><p>
+        If any of these conditions is not respected, the value cannot be deleted.
+       The only way to delete these values is to reassign bugs to another value
+       and to set another value as default for the field.
+      </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="custom-fields.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="administration.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="bug_status_workflow.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.10. Custom Fields </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.12. Bug Status Workflow</td></tr></table></div></body></html>

diff --git a/docs/en/html/extensions.html b/docs/en/html/extensions.html
new file mode 100644 (file)
index 0000000..b4b9f02
--- /dev/null
+++ b/docs/en/html/extensions.html
@@ -0,0 +1,11 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>6.1. Bugzilla Extensions</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="customization.html" title="Chapter 6. Customizing Bugzilla"><link rel="prev" href="customization.html" title="Chapter 6. Customizing Bugzilla"><link rel="next" href="cust-skins.html" title="6.2. Custom Skins"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">6.1. Bugzilla Extensions</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="customization.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Customizing Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="cust-skins.html">Next</a></td></tr></table><hr></div><div class="section" title="6.1. Bugzilla Extensions"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="extensions"></a>6.1. Bugzilla Extensions</h2></div></div></div><p>
+      One of the best ways to customize Bugzilla is by writing a Bugzilla
+      Extension. Bugzilla Extensions let you modify both the code and
+      UI of Bugzilla in a way that can be distributed to other Bugzilla
+      users and ported forward to future versions of Bugzilla with minimal
+      effort.
+    </p><p>
+         See the <a class="ulink" href="../html/api/Bugzilla/Extension.html" target="_top">Bugzilla Extension
+      documentation</a> for information on how to write an Extension.
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="customization.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="customization.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="cust-skins.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 6. Customizing Bugzilla </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 6.2. Custom Skins</td></tr></table></div></body></html>

diff --git a/docs/en/html/extraconfig.html b/docs/en/html/extraconfig.html
new file mode 100644 (file)
index 0000000..aee323e
--- /dev/null
+++ b/docs/en/html/extraconfig.html
@@ -0,0 +1,71 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>2.3. Optional Additional Configuration</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="installing-bugzilla.html" title="Chapter 2. Installing Bugzilla"><link rel="prev" href="configuration.html" title="2.2. Configuration"><link rel="next" href="multiple-bz-dbs.html" title="2.4. Multiple Bugzilla databases with a single installation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.3. Optional Additional Configuration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="configuration.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Installing Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="multiple-bz-dbs.html">Next</a></td></tr></table><hr></div><div class="section" title="2.3. Optional Additional Configuration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="extraconfig"></a>2.3. Optional Additional Configuration</h2></div></div></div><p>
+      Bugzilla has a number of optional features. This section describes how
+      to configure or enable them.
+    </p><div class="section" title="2.3.1. Bug Graphs"><div class="titlepage"><div><div><h3 class="title"><a name="idp11598064"></a>2.3.1. Bug Graphs</h3></div></div></div><p>If you have installed the necessary Perl modules you
+      can start collecting statistics for the nifty Bugzilla 
+      graphs.</p><pre class="screen"><code class="prompt">bash#</code> <span class="command"><strong>crontab -e</strong></span></pre><p>
+        This should bring up the crontab file in your editor. 
+        Add a cron entry like this to run 
+        <code class="filename">collectstats.pl</code> 
+        daily at 5 after midnight:
+      </p><pre class="programlisting">5 0 * * * cd &lt;your-bugzilla-directory&gt; &amp;&amp; ./collectstats.pl</pre><p>
+        After two days have passed you'll be able to view bug graphs from
+        the Reports page.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Windows does not have 'cron', but it does have the Task
+          Scheduler, which performs the same duties. There are also
+          third-party tools that can be used to implement cron, such as
+          <a class="ulink" href="http://www.nncron.ru/" target="_top">nncron</a>.
+        </p></td></tr></table></div></div><div class="section" title="2.3.2. The Whining Cron"><div class="titlepage"><div><div><h3 class="title"><a name="installation-whining-cron"></a>2.3.2. The Whining Cron</h3></div></div></div><p>What good are
+      bugs if they're not annoying? To help make them more so you
+      can set up Bugzilla's automatic whining system to complain at engineers
+      which leave their bugs in the CONFIRMED state without triaging them.
+      </p><p>
+        This can be done by adding the following command as a daily
+        crontab entry, in the same manner as explained above for bug
+        graphs. This example runs it at 12.55am. 
+      </p><pre class="programlisting">55 0 * * * cd &lt;your-bugzilla-directory&gt; &amp;&amp; ./whineatnews.pl</pre><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Windows does not have 'cron', but it does have the Task
+          Scheduler, which performs the same duties. There are also
+          third-party tools that can be used to implement cron, such as
+          <a class="ulink" href="http://www.nncron.ru/" target="_top">nncron</a>.
+        </p></td></tr></table></div></div><div class="section" title="2.3.3. Whining"><div class="titlepage"><div><div><h3 class="title"><a name="installation-whining"></a>2.3.3. Whining</h3></div></div></div><p>
+        As of Bugzilla 2.20, users can configure Bugzilla to regularly annoy 
+        them at regular intervals, by having Bugzilla execute saved searches
+        at certain times and emailing the results to the user.  This is known
+        as "Whining".  The process of configuring Whining is described 
+        in <a class="xref" href="whining.html" title="5.13. Whining">Section 5.13, “Whining”</a>, but for it to work a Perl script must be
+        executed at regular intervals.
+      </p><p>
+        This can be done by adding the following command as a daily
+        crontab entry, in the same manner as explained above for bug
+        graphs. This example runs it every 15 minutes. 
+      </p><pre class="programlisting">*/15 * * * * cd &lt;your-bugzilla-directory&gt; &amp;&amp; ./whine.pl</pre><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Whines can be executed as often as every 15 minutes, so if you specify
+          longer intervals between executions of whine.pl, some users may not 
+          be whined at as often as they would expect.  Depending on the person,
+          this can either be a very Good Thing or a very Bad Thing.
+        </p></td></tr></table></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Windows does not have 'cron', but it does have the Task
+          Scheduler, which performs the same duties. There are also
+          third-party tools that can be used to implement cron, such as
+          <a class="ulink" href="http://www.nncron.ru/" target="_top">nncron</a>.
+        </p></td></tr></table></div></div><div class="section" title="2.3.4. Serving Alternate Formats with the right MIME type"><div class="titlepage"><div><div><h3 class="title"><a name="apache-addtype"></a>2.3.4. Serving Alternate Formats with the right MIME type</h3></div></div></div><p>
+        Some Bugzilla pages have alternate formats, other than just plain
+        <acronym class="acronym">HTML</acronym>. In particular, a few Bugzilla pages can 
+        output their contents as either <acronym class="acronym">XUL</acronym> (a special 
+        Mozilla format, that looks like a program <acronym class="acronym">GUI</acronym>) 
+        or <acronym class="acronym">RDF</acronym> (a type of structured <acronym class="acronym">XML</acronym> 
+        that can be read by various programs).
+      </p><p>
+        In order for your users to see these pages correctly, Apache must 
+        send them with the right <acronym class="acronym">MIME</acronym> type. To do this, 
+        add the following lines to your Apache configuration, either in the 
+        <code class="computeroutput">&lt;VirtualHost&gt;</code> section for your
+        Bugzilla, or in the <code class="computeroutput">&lt;Directory&gt;</code>
+        section for your Bugzilla:
+      </p><p>
+        </p><pre class="screen">AddType application/vnd.mozilla.xul+xml .xul
+AddType application/rdf+xml .rdf</pre><p>
+      </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="configuration.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="installing-bugzilla.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="multiple-bz-dbs.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2.2. Configuration </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 2.4. Multiple Bugzilla databases with a single installation</td></tr></table></div></body></html>

diff --git a/docs/en/html/flags-overview.html b/docs/en/html/flags-overview.html
new file mode 100644 (file)
index 0000000..e4b40af
--- /dev/null
+++ b/docs/en/html/flags-overview.html
@@ -0,0 +1,248 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.8. Flags</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="milestones.html" title="3.7. Milestones"><link rel="next" href="keywords.html" title="3.9. Keywords"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.8. Flags</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="milestones.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="keywords.html">Next</a></td></tr></table><hr></div><div class="section" title="3.8. Flags"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="flags-overview"></a>3.8. Flags</h2></div></div></div><p>
+     Flags are a way to attach a specific status to a bug or attachment, 
+     either <span class="quote">“<span class="quote">+</span>”</span> or <span class="quote">“<span class="quote">-</span>”</span>. The meaning of these symbols depends on the text
+     the flag itself, but contextually they could mean pass/fail, 
+     accept/reject, approved/denied, or even a simple yes/no. If your site
+     allows requestable flags, then users may set a flag to <span class="quote">“<span class="quote">?</span>”</span> as a 
+     request to another user that they look at the bug/attachment, and set
+     the flag to its correct status.
+   </p><div class="section" title="3.8.1. A Simple Example"><div class="titlepage"><div><div><h3 class="title"><a name="flags-simpleexample"></a>3.8.1. A Simple Example</h3></div></div></div><p>
+       A developer might want to ask their manager, 
+       <span class="quote">“<span class="quote">Should we fix this bug before we release version 2.0?</span>”</span> 
+       They might want to do this for a <span class="emphasis"><em>lot</em></span> of bugs,
+       so it would be nice to streamline the process...
+     </p><p>
+       In Bugzilla, it would work this way:
+       </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+             The Bugzilla administrator creates a flag type called 
+             <span class="quote">“<span class="quote">blocking2.0</span>”</span> that shows up on all bugs in 
+             your product.
+           </p><p>
+             It shows up on the <span class="quote">“<span class="quote">Show Bug</span>”</span> screen
+             as the text <span class="quote">“<span class="quote">blocking2.0</span>”</span> with a drop-down box next
+             to it. The drop-down box contains four values: an empty space,
+             <span class="quote">“<span class="quote">?</span>”</span>, <span class="quote">“<span class="quote">-</span>”</span>, and <span class="quote">“<span class="quote">+</span>”</span>.
+           </p></li><li class="listitem"><p>The developer sets the flag to <span class="quote">“<span class="quote">?</span>”</span>.</p></li><li class="listitem"><p>
+             The manager sees the <code class="computeroutput">blocking2.0</code>
+             flag with a <span class="quote">“<span class="quote">?</span>”</span> value.
+           </p></li><li class="listitem"><p>
+             If the manager thinks the feature should go into the product
+             before version 2.0 can be released, he sets the flag to 
+             <span class="quote">“<span class="quote">+</span>”</span>. Otherwise, he sets it to <span class="quote">“<span class="quote">-</span>”</span>.
+           </p></li><li class="listitem"><p>
+             Now, every Bugzilla user who looks at the bug knows whether or 
+             not the bug needs to be fixed before release of version 2.0.
+           </p></li></ol></div><p>
+     </p></div><div class="section" title="3.8.2. About Flags"><div class="titlepage"><div><div><h3 class="title"><a name="flags-about"></a>3.8.2. About Flags</h3></div></div></div><div class="section" title="3.8.2.1. Values"><div class="titlepage"><div><div><h4 class="title"><a name="flag-values"></a>3.8.2.1. Values</h4></div></div></div><p>
+         Flags can have three values:
+         </p><div class="variablelist"><dl><dt><span class="term"><code class="computeroutput">?</code></span></dt><dd>
+               A user is requesting that a status be set. (Think of it as 'A question is being asked'.)
+             </dd><dt><span class="term"><code class="computeroutput">-</code></span></dt><dd>
+               The status has been set negatively. (The question has been answered <span class="quote">“<span class="quote">no</span>”</span>.)
+             </dd><dt><span class="term"><code class="computeroutput">+</code></span></dt><dd>
+               The status has been set positively.
+               (The question has been answered <span class="quote">“<span class="quote">yes</span>”</span>.)
+             </dd></dl></div><p>
+       </p><p>
+         Actually, there's a fourth value a flag can have -- 
+         <span class="quote">“<span class="quote">unset</span>”</span> -- which shows up as a blank space. This 
+         just means that nobody has expressed an opinion (or asked
+         someone else to express an opinion) about this bug or attachment.
+       </p></div></div><div class="section" title="3.8.3. Using flag requests"><div class="titlepage"><div><div><h3 class="title"><a name="flag-askto"></a>3.8.3. Using flag requests</h3></div></div></div><p>
+       If a flag has been defined as 'requestable', and a user has enough privileges
+       to request it (see below), the user can set the flag's status to <span class="quote">“<span class="quote">?</span>”</span>.
+       This status indicates that someone (a.k.a. <span class="quote">“<span class="quote">the requester</span>”</span>) is asking
+       someone else to set the flag to either <span class="quote">“<span class="quote">+</span>”</span> or <span class="quote">“<span class="quote">-</span>”</span>.
+     </p><p>
+       If a flag has been defined as 'specifically requestable', 
+       a text box will appear next to the flag into which the requester may
+       enter a Bugzilla username. That named person (a.k.a. <span class="quote">“<span class="quote">the requestee</span>”</span>)
+       will receive an email notifying them of the request, and pointing them
+       to the bug/attachment in question.
+     </p><p>
+       If a flag has <span class="emphasis"><em>not</em></span> been defined as 'specifically requestable',
+       then no such text-box will appear. A request to set this flag cannot be made of
+       any specific individual, but must be asked <span class="quote">“<span class="quote">to the wind</span>”</span>.
+       A requester may <span class="quote">“<span class="quote">ask the wind</span>”</span> on any flag simply by leaving the text-box blank.
+     </p></div><div class="section" title="3.8.4. Two Types of Flags"><div class="titlepage"><div><div><h3 class="title"><a name="flag-types"></a>3.8.4. Two Types of Flags</h3></div></div></div><p>
+       Flags can go in two places: on an attachment, or on a bug.
+     </p><div class="section" title="3.8.4.1. Attachment Flags"><div class="titlepage"><div><div><h4 class="title"><a name="flag-type-attachment"></a>3.8.4.1. Attachment Flags</h4></div></div></div><p>
+         Attachment flags are used to ask a question about a specific 
+         attachment on a bug.
+       </p><p>
+         Many Bugzilla installations use this to 
+         request that one developer <span class="quote">“<span class="quote">review</span>”</span> another 
+         developer's code before they check it in. They attach the code to
+         a bug report, and then set a flag on that attachment called
+         <span class="quote">“<span class="quote">review</span>”</span> to 
+         <code class="computeroutput">review?boss@domain.com</code>.
+         boss@domain.com is then notified by email that
+         he has to check out that attachment and approve it or deny it.
+       </p><p>
+         For a Bugzilla user, attachment flags show up in three places:
+         </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+               On the list of attachments in the <span class="quote">“<span class="quote">Show Bug</span>”</span>
+               screen, you can see the current state of any flags that
+               have been set to ?, +, or -. You can see who asked about 
+               the flag (the requester), and who is being asked (the 
+               requestee).
+             </p></li><li class="listitem"><p>
+              When you <span class="quote">“<span class="quote">Edit</span>”</span> an attachment, you can 
+              see any settable flag, along with any flags that have 
+              already been set. This <span class="quote">“<span class="quote">Edit Attachment</span>”</span> 
+              screen is where you set flags to ?, -, +, or unset them.
+             </p></li><li class="listitem"><p>
+               Requests are listed in the <span class="quote">“<span class="quote">Request Queue</span>”</span>, which
+               is accessible from the <span class="quote">“<span class="quote">My Requests</span>”</span> link (if you are
+               logged in) or <span class="quote">“<span class="quote">Requests</span>”</span> link (if you are logged out)
+               visible in the footer of all pages.
+             </p></li></ol></div><p>
+       </p></div><div class="section" title="3.8.4.2. Bug Flags"><div class="titlepage"><div><div><h4 class="title"><a name="flag-type-bug"></a>3.8.4.2. Bug Flags</h4></div></div></div><p>
+         Bug flags are used to set a status on the bug itself. You can 
+         see Bug Flags in the <span class="quote">“<span class="quote">Show Bug</span>”</span> and <span class="quote">“<span class="quote">Requests</span>”</span>
+         screens, as described above.
+       </p><p>
+         Only users with enough privileges (see below) may set flags on bugs.
+         This doesn't necessarily include the assignee, reporter, or users with the
+         <code class="computeroutput">editbugs</code> permission.
+       </p></div></div><div class="section" title="3.8.5. Administering Flags"><div class="titlepage"><div><div><h3 class="title"><a name="flags-admin"></a>3.8.5. Administering Flags</h3></div></div></div><p>
+       If you have the <span class="quote">“<span class="quote">editcomponents</span>”</span> permission, you can
+       edit Flag Types from the main administration page. Clicking the
+       <span class="quote">“<span class="quote">Flags</span>”</span> link will bring you to the <span class="quote">“<span class="quote">Administer
+       Flag Types</span>”</span> page. Here, you can select whether you want 
+       to create (or edit) a Bug flag, or an Attachment flag.
+     </p><p>
+       No matter which you choose, the interface is the same, so we'll 
+       just go over it once.
+     </p><div class="section" title="3.8.5.1. Editing a Flag"><div class="titlepage"><div><div><h4 class="title"><a name="flags-edit"></a>3.8.5.1. Editing a Flag</h4></div></div></div><p>
+         To edit a flag's properties, just click the flag's name.
+         That will take you to the same
+         form as described below (<a class="xref" href="flags-overview.html#flags-create" title="3.8.5.2. Creating a Flag">Section 3.8.5.2, “Creating a Flag”</a>).
+       </p></div><div class="section" title="3.8.5.2. Creating a Flag"><div class="titlepage"><div><div><h4 class="title"><a name="flags-create"></a>3.8.5.2. Creating a Flag</h4></div></div></div><p>
+          When you click on the <span class="quote">“<span class="quote">Create a Flag Type for...</span>”</span>
+          link, you will be presented with a form. Here is what the fields in 
+          the form mean:
+        </p><div class="section" title="3.8.5.2.1. Name"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-field-name"></a>3.8.5.2.1. Name</h5></div></div></div><p>
+            This is the name of the flag. This will be displayed 
+            to Bugzilla users who are looking at or setting the flag. 
+            The name may contain any valid Unicode characters except commas
+            and spaces.
+          </p></div><div class="section" title="3.8.5.2.2. Description"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-field-description"></a>3.8.5.2.2. Description</h5></div></div></div><p>
+            The description describes the flag in more detail. It is visible
+            in a tooltip when hovering over a flag either in the <span class="quote">“<span class="quote">Show Bug</span>”</span>
+            or <span class="quote">“<span class="quote">Edit Attachment</span>”</span> pages. This field can be as
+            long as you like, and can contain any character you want.
+          </p></div><div class="section" title="3.8.5.2.3. Category"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-field-category"></a>3.8.5.2.3. Category</h5></div></div></div><p>
+            Default behaviour for a newly-created flag is to appear on
+            products and all components, which is why <span class="quote">“<span class="quote">__Any__:__Any__</span>”</span>
+            is already entered in the <span class="quote">“<span class="quote">Inclusions</span>”</span> box.
+            If this is not your desired behaviour, you must either set some
+            exclusions (for products on which you don't want the flag to appear),
+            or you must remove <span class="quote">“<span class="quote">__Any__:__Any__</span>”</span> from the Inclusions box
+            and define products/components specifically for this flag.
+          </p><p>
+            To create an Inclusion, select a Product from the top drop-down box.
+            You may also select a specific component from the bottom drop-down box.
+            (Setting <span class="quote">“<span class="quote">__Any__</span>”</span> for Product translates to, 
+            <span class="quote">“<span class="quote">all the products in this Bugzilla</span>”</span>.
+            Selecting  <span class="quote">“<span class="quote">__Any__</span>”</span> in the Component field means
+            <span class="quote">“<span class="quote">all components in the selected product.</span>”</span>) 
+            Selections made, press <span class="quote">“<span class="quote">Include</span>”</span>, and your
+            Product/Component pairing will show up in the <span class="quote">“<span class="quote">Inclusions</span>”</span> box on the right.
+          </p><p>
+            To create an Exclusion, the process is the same; select a Product from the
+            top drop-down box, select a specific component if you want one, and press
+            <span class="quote">“<span class="quote">Exclude</span>”</span>. The Product/Component pairing will show up in the 
+            <span class="quote">“<span class="quote">Exclusions</span>”</span> box on the right.
+          </p><p>
+            This flag <span class="emphasis"><em>will</em></span> and <span class="emphasis"><em>can</em></span> be set for any
+            products/components that appearing in the <span class="quote">“<span class="quote">Inclusions</span>”</span> box 
+            (or which fall under the appropriate <span class="quote">“<span class="quote">__Any__</span>”</span>). 
+            This flag <span class="emphasis"><em>will not</em></span> appear (and therefore cannot be set) on
+            any products appearing in the <span class="quote">“<span class="quote">Exclusions</span>”</span> box.
+            <span class="emphasis"><em> IMPORTANT: Exclusions override inclusions.</em></span>
+          </p><p>
+            You may select a Product without selecting a specific Component,
+            but you can't select a Component without a Product, or to select a
+            Component that does not belong to the named Product. If you do so,
+            Bugzilla will display an error message, even if all your products
+            have a component by that name.
+          </p><p><span class="emphasis"><em>Example:</em></span> Let's say you have a product called 
+            <span class="quote">“<span class="quote">Jet Plane</span>”</span> that has thousands of components. You want
+            to be able to ask if a problem should be fixed in the next model of 
+            plane you release. We'll call the flag <span class="quote">“<span class="quote">fixInNext</span>”</span>.
+            But, there's one component in <span class="quote">“<span class="quote">Jet Plane,</span>”</span> 
+            called <span class="quote">“<span class="quote">Pilot.</span>”</span> It doesn't make sense to release a 
+            new pilot, so you don't want to have the flag show up in that component.
+            So, you include <span class="quote">“<span class="quote">Jet Plane:__Any__</span>”</span> and you exclude 
+            <span class="quote">“<span class="quote">Jet Plane:Pilot</span>”</span>.
+          </p></div><div class="section" title="3.8.5.2.4. Sort Key"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-field-sortkey"></a>3.8.5.2.4. Sort Key</h5></div></div></div><p>
+            Flags normally show up in alphabetical order. If you want them to 
+            show up in a different order, you can use this key set the order on each flag. 
+            Flags with a lower sort key will appear before flags with a higher
+            sort key. Flags that have the same sort key will be sorted alphabetically,
+            but they will still be after flags with a lower sort key, and before flags
+            with a higher sort key.
+          </p><p>
+            <span class="emphasis"><em>Example:</em></span> I have AFlag (Sort Key 100), BFlag (Sort Key 10), 
+            CFlag (Sort Key 10), and DFlag (Sort Key 1). These show up in
+            the order: DFlag, BFlag, CFlag, AFlag.
+          </p></div><div class="section" title="3.8.5.2.5. Active"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-field-active"></a>3.8.5.2.5. Active</h5></div></div></div><p>
+            Sometimes, you might want to keep old flag information in the 
+            Bugzilla database, but stop users from setting any new flags of this type.
+            To do this, uncheck <span class="quote">“<span class="quote">active</span>”</span>. Deactivated
+            flags will still show up in the UI if they are ?, +, or -, but they
+            may only be cleared (unset), and cannot be changed to a new value.
+            Once a deactivated flag is cleared, it will completely disappear from a 
+            bug/attachment, and cannot be set again.
+          </p></div><div class="section" title="3.8.5.2.6. Requestable"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-field-requestable"></a>3.8.5.2.6. Requestable</h5></div></div></div><p>
+            New flags are, by default, <span class="quote">“<span class="quote">requestable</span>”</span>, meaning that they
+            offer users the <span class="quote">“<span class="quote">?</span>”</span> option, as well as <span class="quote">“<span class="quote">+</span>”</span>
+            and <span class="quote">“<span class="quote">-</span>”</span>.
+            To remove the ? option, uncheck <span class="quote">“<span class="quote">requestable</span>”</span>.
+          </p></div><div class="section" title="3.8.5.2.7. Specifically Requestable"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-field-specific"></a>3.8.5.2.7. Specifically Requestable</h5></div></div></div><p>
+            By default this box is checked for new flags, meaning that users may make
+            flag requests of specific individuals. Unchecking this box will remove the
+            text box next to a flag; if it is still requestable, then requests may
+            only be made <span class="quote">“<span class="quote">to the wind.</span>”</span> Removing this after specific
+            requests have been made will not remove those requests; that data will
+            stay in the database (though it will no longer appear to the user).
+          </p></div><div class="section" title="3.8.5.2.8. Multiplicable"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-field-multiplicable"></a>3.8.5.2.8. Multiplicable</h5></div></div></div><p>
+            Any flag with <span class="quote">“<span class="quote">Multiplicable</span>”</span> set (default for new flags is 'on')
+            may be set more than once. After being set once, an unset flag
+            of the same type will appear below it with <span class="quote">“<span class="quote">addl.</span>”</span> (short for 
+            <span class="quote">“<span class="quote">additional</span>”</span>) before the name. There is no limit to the number of
+            times a Multiplicable flags may be set on the same bug/attachment.
+          </p></div><div class="section" title="3.8.5.2.9. CC List"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-field-cclist"></a>3.8.5.2.9. CC List</h5></div></div></div><p>
+            If you want certain users to be notified every time this flag is 
+            set to ?, -, +, or unset, add them here. This is a comma-separated 
+            list of email addresses that need not be restricted to Bugzilla usernames.
+          </p></div><div class="section" title="3.8.5.2.10. Grant Group"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-grant-group"></a>3.8.5.2.10. Grant Group</h5></div></div></div><p>
+            When this field is set to some given group, only users in the group
+            can set the flag to <span class="quote">“<span class="quote">+</span>”</span> and <span class="quote">“<span class="quote">-</span>”</span>. This
+            field does not affect who can request or cancel the flag. For that,
+            see the <span class="quote">“<span class="quote">Request Group</span>”</span> field below. If this field
+            is left blank, all users can set or delete this flag. This field is
+            useful for restricting which users can approve or reject requests.
+          </p></div><div class="section" title="3.8.5.2.11. Request Group"><div class="titlepage"><div><div><h5 class="title"><a name="flags-create-request-group"></a>3.8.5.2.11. Request Group</h5></div></div></div><p>
+            When this field is set to some given group, only users in the group
+            can request or cancel this flag. Note that this field has no effect
+            if the <span class="quote">“<span class="quote">grant group</span>”</span> field is empty. You can set the
+            value of this field to a different group, but both fields have to be
+            set to a group for this field to have an effect.
+          </p></div></div><div class="section" title="3.8.5.3. Deleting a Flag"><div class="titlepage"><div><div><h4 class="title"><a name="flags-delete"></a>3.8.5.3. Deleting a Flag</h4></div></div></div><p>
+          When you are at the <span class="quote">“<span class="quote">Administer Flag Types</span>”</span> screen,
+          you will be presented with a list of Bug flags and a list of Attachment
+          Flags.
+        </p><p>
+          To delete a flag, click on the <span class="quote">“<span class="quote">Delete</span>”</span> link next to
+          the flag description.
+        </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            Once you delete a flag, it is <span class="emphasis"><em>gone</em></span> from
+            your Bugzilla. All the data for that flag will be deleted.
+            Everywhere that flag was set, it will disappear,
+            and you cannot get that data back. If you want to keep flag data,
+            but don't want anybody to set any new flags or change current flags,
+            unset <span class="quote">“<span class="quote">active</span>”</span> in the flag Edit form.
+          </p></td></tr></table></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="milestones.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="administration.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="keywords.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.7. Milestones </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.9. Keywords</td></tr></table></div></body></html>

diff --git a/docs/en/html/flags.html b/docs/en/html/flags.html
new file mode 100644 (file)
index 0000000..f28deff
--- /dev/null
+++ b/docs/en/html/flags.html
@@ -0,0 +1,42 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>5.12. Flags</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="prev" href="reporting.html" title="5.11. Reports and Charts"><link rel="next" href="whining.html" title="5.13. Whining"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.12. Flags</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="reporting.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Using Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="whining.html">Next</a></td></tr></table><hr></div><div class="section" title="5.12. Flags"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="flags"></a>5.12. Flags</h2></div></div></div><p>
+      A flag is a kind of status that can be set on bugs or attachments
+      to indicate that the bugs/attachments are in a certain state.
+      Each installation can define its own set of flags that can be set
+      on bugs or attachments.
+    </p><p>
+      If your installation has defined a flag, you can set or unset that flag,
+      and if your administrator has enabled requesting of flags, you can submit
+      a request for another user to set the flag.
+    </p><p>
+      To set a flag, select either "+" or "-" from the drop-down menu next to
+      the name of the flag in the "Flags" list.  The meaning of these values are
+      flag-specific and thus cannot be described in this documentation,
+      but by way of example, setting a flag named "review" to "+" may indicate
+      that the bug/attachment has passed review, while setting it to "-"
+      may indicate that the bug/attachment has failed review.
+    </p><p>
+      To unset a flag, click its drop-down menu and select the blank value.
+      Note that marking an attachment as obsolete automatically cancels all
+      pending requests for the attachment.
+    </p><p>
+      If your administrator has enabled requests for a flag, request a flag
+      by selecting "?" from the drop-down menu and then entering the username
+      of the user you want to set the flag in the text field next to the menu.
+    </p><p>
+      A set flag appears in bug reports and on "edit attachment" pages with the
+      abbreviated username of the user who set the flag prepended to the
+      flag name. For example, if Jack sets a "review" flag to "+", it appears
+      as Jack: review [ + ]
+    </p><p>
+      A requested flag appears with the user who requested the flag prepended
+      to the flag name and the user who has been requested to set the flag
+      appended to the flag name within parentheses.  For example, if Jack
+      asks Jill for review, it appears as Jack: review [ ? ] (Jill).
+    </p><p>
+      You can browse through open requests made of you and by you by selecting
+      'My Requests' from the footer. You can also look at open requests limited
+      by other requesters, requestees, products, components, and flag names from
+      this page. Note that you can use '-' for requestee to specify flags with
+      'no requestee' set.
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="reporting.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="using.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="whining.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5.11. Reports and Charts </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 5.13. Whining</td></tr></table></div></body></html>

diff --git a/docs/en/html/general-advice.html b/docs/en/html/general-advice.html
new file mode 100644 (file)
index 0000000..8490142
--- /dev/null
+++ b/docs/en/html/general-advice.html
@@ -0,0 +1,28 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>A.1. General Advice</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="troubleshooting.html" title="Appendix A. Troubleshooting"><link rel="prev" href="troubleshooting.html" title="Appendix A. Troubleshooting"><link rel="next" href="trbl-testserver.html" title="A.2. The Apache web server is not serving Bugzilla pages"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">A.1. General Advice</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="troubleshooting.html">Prev</a> </td><th width="60%" align="center">Appendix A. Troubleshooting</th><td width="20%" align="right"> <a accesskey="n" href="trbl-testserver.html">Next</a></td></tr></table><hr></div><div class="section" title="A.1. General Advice"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="general-advice"></a>A.1. General Advice</h2></div></div></div><p>If you can't get <code class="filename">checksetup.pl</code> to run to 
+    completion, it normally explains what's wrong and how to fix it.
+    If you can't work it out, or if it's being uncommunicative, post 
+    the errors in the 
+    <a class="ulink" href="news://news.mozilla.org/mozilla.support.bugzilla" target="_top">mozilla.support.bugzilla</a>
+    newsgroup.
+    </p><p>If you have made it all the way through
+    <a class="xref" href="installation.html" title="2.1. Installation">Section 2.1, “Installation”</a> (Installation) and
+    <a class="xref" href="configuration.html" title="2.2. Configuration">Section 2.2, “Configuration”</a> (Configuration) but accessing the Bugzilla
+    URL doesn't work, the first thing to do is to check your web server error
+    log. For Apache, this is often located at
+    <code class="filename">/etc/logs/httpd/error_log</code>. The error messages
+    you see may be self-explanatory enough to enable you to diagnose and
+    fix the problem. If not, see below for some commonly-encountered 
+    errors. If that doesn't help, post the errors to the newsgroup.
+    </p><p>
+      Bugzilla can also log all user-based errors (and many code-based errors)
+      that occur, without polluting the web server's error log.  To enable
+      Bugzilla error logging, create a file that Bugzilla can write to, named
+      <code class="filename">errorlog</code>, in the Bugzilla <code class="filename">data</code>
+      directory.  Errors will be logged as they occur, and will include the type
+      of the error, the IP address and username (if available) of the user who
+      triggered the error, and the values of all environment variables; if a
+      form was being submitted, the data in the form will also be included.
+      To disable error logging, delete or rename the
+      <code class="filename">errorlog</code> file.
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="troubleshooting.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="troubleshooting.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="trbl-testserver.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Appendix A. Troubleshooting </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> A.2. The Apache web server is not serving Bugzilla pages</td></tr></table></div></body></html>

diff --git a/docs/en/html/gfdl-0.html b/docs/en/html/gfdl-0.html
new file mode 100644 (file)
index 0000000..26dec3b
--- /dev/null
+++ b/docs/en/html/gfdl-0.html
@@ -0,0 +1,17 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>D.0. Preamble</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="gfdl.html" title="Appendix D. GNU Free Documentation License"><link rel="prev" href="gfdl.html" title="Appendix D. GNU Free Documentation License"><link rel="next" href="gfdl-1.html" title="D.1. Applicability and Definition"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">D.0. Preamble</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="gfdl.html">Prev</a> </td><th width="60%" align="center">Appendix D. GNU Free Documentation License</th><td width="20%" align="right"> <a accesskey="n" href="gfdl-1.html">Next</a></td></tr></table><hr></div><div class="section" title="D.0. Preamble"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-0"></a>D.0. Preamble</h2></div></div></div><p>The purpose of this License is to make a manual, textbook, or other
+    written document "free" in the sense of freedom: to assure everyone the
+    effective freedom to copy and redistribute it, with or without modifying
+    it, either commercially or noncommercially. Secondarily, this License
+    preserves for the author and publisher a way to get credit for their
+    work, while not being considered responsible for modifications made by
+    others.</p><p>This License is a kind of "copyleft", which means that derivative
+    works of the document must themselves be free in the same sense. It
+    complements the GNU General Public License, which is a copyleft license
+    designed for free software.</p><p>We have designed this License in order to use it for manuals for
+    free software, because free software needs free documentation: a free
+    program should come with manuals providing the same freedoms that the
+    software does. But this License is not limited to software manuals; it
+    can be used for any textual work, regardless of subject matter or whether
+    it is published as a printed book. We recommend this License principally
+    for works whose purpose is instruction or reference.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="gfdl.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gfdl.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="gfdl-1.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Appendix D. GNU Free Documentation License </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> D.1. Applicability and Definition</td></tr></table></div></body></html>

diff --git a/docs/en/html/gfdl-1.html b/docs/en/html/gfdl-1.html
new file mode 100644 (file)
index 0000000..b87e0b2
--- /dev/null
+++ b/docs/en/html/gfdl-1.html
@@ -0,0 +1,42 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>D.1. Applicability and Definition</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="gfdl.html" title="Appendix D. GNU Free Documentation License"><link rel="prev" href="gfdl-0.html" title="D.0. Preamble"><link rel="next" href="gfdl-2.html" title="D.2. Verbatim Copying"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">D.1. Applicability and Definition</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="gfdl-0.html">Prev</a> </td><th width="60%" align="center">Appendix D. GNU Free Documentation License</th><td width="20%" align="right"> <a accesskey="n" href="gfdl-2.html">Next</a></td></tr></table><hr></div><div class="section" title="D.1. Applicability and Definition"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-1"></a>D.1. Applicability and Definition</h2></div></div></div><p>This License applies to any manual or other work that contains a
+    notice placed by the copyright holder saying it can be distributed under
+    the terms of this License. The "Document", below, refers to any such
+    manual or work. Any member of the public is a licensee, and is addressed
+    as "you".</p><p>A "Modified Version" of the Document means any work containing the
+    Document or a portion of it, either copied verbatim, or with
+    modifications and/or translated into another language.</p><p>A "Secondary Section" is a named appendix or a front-matter section
+    of the Document that deals exclusively with the relationship of the
+    publishers or authors of the Document to the Document's overall subject
+    (or to related matters) and contains nothing that could fall directly
+    within that overall subject. (For example, if the Document is in part a
+    textbook of mathematics, a Secondary Section may not explain any
+    mathematics.) The relationship could be a matter of historical connection
+    with the subject or with related matters, or of legal, commercial,
+    philosophical, ethical or political position regarding them.</p><p>The "Invariant Sections" are certain Secondary Sections whose
+    titles are designated, as being those of Invariant Sections, in the
+    notice that says that the Document is released under this License.</p><p>The "Cover Texts" are certain short passages of text that are
+    listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says
+    that the Document is released under this License.</p><p>A "Transparent" copy of the Document means a machine-readable copy,
+    represented in a format whose specification is available to the general
+    public, whose contents can be viewed and edited directly and
+    straightforwardly with generic text editors or (for images composed of
+    pixels) generic paint programs or (for drawings) some widely available
+    drawing editor, and that is suitable for input to text formatters or for
+    automatic translation to a variety of formats suitable for input to text
+    formatters. A copy made in an otherwise Transparent file format whose
+    markup has been designed to thwart or discourage subsequent modification
+    by readers is not Transparent. A copy that is not "Transparent" is called
+    "Opaque".</p><p>Examples of suitable formats for Transparent copies include plain
+    ASCII without markup, Texinfo input format, LaTeX input format, SGML or
+    XML using a publicly available DTD, and standard-conforming simple HTML
+    designed for human modification. Opaque formats include PostScript, PDF,
+    proprietary formats that can be read and edited only by proprietary word
+    processors, SGML or XML for which the DTD and/or processing tools are not
+    generally available, and the machine-generated HTML produced by some word
+    processors for output purposes only.</p><p>The "Title Page" means, for a printed book, the title page itself,
+    plus such following pages as are needed to hold, legibly, the material
+    this License requires to appear in the title page. For works in formats
+    which do not have any title page as such, "Title Page" means the text
+    near the most prominent appearance of the work's title, preceding the
+    beginning of the body of the text.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="gfdl-0.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gfdl.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="gfdl-2.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">D.0. Preamble </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> D.2. Verbatim Copying</td></tr></table></div></body></html>

diff --git a/docs/en/html/gfdl-10.html b/docs/en/html/gfdl-10.html
new file mode 100644 (file)
index 0000000..658f8ff
--- /dev/null
+++ b/docs/en/html/gfdl-10.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>D.10. Future Revisions of this License</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="gfdl.html" title="Appendix D. GNU Free Documentation License"><link rel="prev" href="gfdl-9.html" title="D.9. Termination"><link rel="next" href="gfdl-howto.html" title="D.. How to use this License for your documents"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">D.10. Future Revisions of this License</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="gfdl-9.html">Prev</a> </td><th width="60%" align="center">Appendix D. GNU Free Documentation License</th><td width="20%" align="right"> <a accesskey="n" href="gfdl-howto.html">Next</a></td></tr></table><hr></div><div class="section" title="D.10. Future Revisions of this License"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-10"></a>D.10. Future Revisions of this License</h2></div></div></div><p>The Free Software Foundation may publish new, revised versions of
+    the GNU Free Documentation License from time to time. Such new versions
+    will be similar in spirit to the present version, but may differ in
+    detail to address new problems or concerns. See 
+    <a class="ulink" href="http://www.gnu.org/copyleft/" target="_top">http://www.gnu.org/copyleft/</a>.</p><p>Each version of the License is given a distinguishing version
+    number. If the Document specifies that a particular numbered version of
+    this License "or any later version" applies to it, you have the option of
+    following the terms and conditions either of that specified version or of
+    any later version that has been published (not as a draft) by the Free
+    Software Foundation. If the Document does not specify a version number of
+    this License, you may choose any version ever published (not as a draft)
+    by the Free Software Foundation.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="gfdl-9.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gfdl.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="gfdl-howto.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">D.9. Termination </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> D.. How to use this License for your documents</td></tr></table></div></body></html>

diff --git a/docs/en/html/gfdl-2.html b/docs/en/html/gfdl-2.html
new file mode 100644 (file)
index 0000000..aacdd59
--- /dev/null
+++ b/docs/en/html/gfdl-2.html
@@ -0,0 +1,11 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>D.2. Verbatim Copying</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="gfdl.html" title="Appendix D. GNU Free Documentation License"><link rel="prev" href="gfdl-1.html" title="D.1. Applicability and Definition"><link rel="next" href="gfdl-3.html" title="D.3. Copying in Quantity"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">D.2. Verbatim Copying</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="gfdl-1.html">Prev</a> </td><th width="60%" align="center">Appendix D. GNU Free Documentation License</th><td width="20%" align="right"> <a accesskey="n" href="gfdl-3.html">Next</a></td></tr></table><hr></div><div class="section" title="D.2. Verbatim Copying"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-2"></a>D.2. Verbatim Copying</h2></div></div></div><p>You may copy and distribute the Document in any medium, either
+    commercially or noncommercially, provided that this License, the
+    copyright notices, and the license notice saying this License applies to
+    the Document are reproduced in all copies, and that you add no other
+    conditions whatsoever to those of this License. You may not use technical
+    measures to obstruct or control the reading or further copying of the
+    copies you make or distribute. However, you may accept compensation in
+    exchange for copies. If you distribute a large enough number of copies
+    you must also follow the conditions in section 3.</p><p>You may also lend copies, under the same conditions stated above,
+    and you may publicly display copies.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="gfdl-1.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gfdl.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="gfdl-3.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">D.1. Applicability and Definition </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> D.3. Copying in Quantity</td></tr></table></div></body></html>

diff --git a/docs/en/html/gfdl-3.html b/docs/en/html/gfdl-3.html
new file mode 100644 (file)
index 0000000..96b7619
--- /dev/null
+++ b/docs/en/html/gfdl-3.html
@@ -0,0 +1,29 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>D.3. Copying in Quantity</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="gfdl.html" title="Appendix D. GNU Free Documentation License"><link rel="prev" href="gfdl-2.html" title="D.2. Verbatim Copying"><link rel="next" href="gfdl-4.html" title="D.4. Modifications"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">D.3. Copying in Quantity</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="gfdl-2.html">Prev</a> </td><th width="60%" align="center">Appendix D. GNU Free Documentation License</th><td width="20%" align="right"> <a accesskey="n" href="gfdl-4.html">Next</a></td></tr></table><hr></div><div class="section" title="D.3. Copying in Quantity"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-3"></a>D.3. Copying in Quantity</h2></div></div></div><p>If you publish printed copies of the Document numbering more than
+    100, and the Document's license notice requires Cover Texts, you must
+    enclose the copies in covers that carry, clearly and legibly, all these
+    Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts
+    on the back cover. Both covers must also clearly and legibly identify you
+    as the publisher of these copies. The front cover must present the full
+    title with all words of the title equally prominent and visible. You may
+    add other material on the covers in addition. Copying with changes
+    limited to the covers, as long as they preserve the title of the Document
+    and satisfy these conditions, can be treated as verbatim copying in other
+    respects.</p><p>If the required texts for either cover are too voluminous to fit
+    legibly, you should put the first ones listed (as many as fit reasonably)
+    on the actual cover, and continue the rest onto adjacent pages.</p><p>If you publish or distribute Opaque copies of the Document
+    numbering more than 100, you must either include a machine-readable
+    Transparent copy along with each Opaque copy, or state in or with each
+    Opaque copy a publicly-accessible computer-network location containing a
+    complete Transparent copy of the Document, free of added material, which
+    the general network-using public has access to download anonymously at no
+    charge using public-standard network protocols. If you use the latter
+    option, you must take reasonably prudent steps, when you begin
+    distribution of Opaque copies in quantity, to ensure that this
+    Transparent copy will remain thus accessible at the stated location until
+    at least one year after the last time you distribute an Opaque copy
+    (directly or through your agents or retailers) of that edition to the
+    public.</p><p>It is requested, but not required, that you contact the authors of
+    the Document well before redistributing any large number of copies, to
+    give them a chance to provide you with an updated version of the
+    Document.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="gfdl-2.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gfdl.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="gfdl-4.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">D.2. Verbatim Copying </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> D.4. Modifications</td></tr></table></div></body></html>

diff --git a/docs/en/html/gfdl-4.html b/docs/en/html/gfdl-4.html
new file mode 100644 (file)
index 0000000..68d48ad
--- /dev/null
+++ b/docs/en/html/gfdl-4.html
@@ -0,0 +1,60 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>D.4. Modifications</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="gfdl.html" title="Appendix D. GNU Free Documentation License"><link rel="prev" href="gfdl-3.html" title="D.3. Copying in Quantity"><link rel="next" href="gfdl-5.html" title="D.5. Combining Documents"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">D.4. Modifications</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="gfdl-3.html">Prev</a> </td><th width="60%" align="center">Appendix D. GNU Free Documentation License</th><td width="20%" align="right"> <a accesskey="n" href="gfdl-5.html">Next</a></td></tr></table><hr></div><div class="section" title="D.4. Modifications"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-4"></a>D.4. Modifications</h2></div></div></div><p>You may copy and distribute a Modified Version of the Document
+    under the conditions of sections 2 and 3 above, provided that you release
+    the Modified Version under precisely this License, with the Modified
+    Version filling the role of the Document, thus licensing distribution and
+    modification of the Modified Version to whoever possesses a copy of it.
+    In addition, you must do these things in the Modified Version:</p><div class="orderedlist"><ol class="orderedlist" type="A"><li class="listitem"><p>Use in the Title Page (and on the covers, if any) a title
+        distinct from that of the Document, and from those of previous
+        versions (which should, if there were any, be listed in the History
+        section of the Document). You may use the same title as a previous
+        version if the original publisher of that version gives
+        permission.</p></li><li class="listitem"><p>List on the Title Page, as authors, one or more persons or
+        entities responsible for authorship of the modifications in the
+        Modified Version, together with at least five of the principal
+        authors of the Document (all of its principal authors, if it has less
+        than five).</p></li><li class="listitem"><p>State on the Title page the name of the publisher of the
+        Modified Version, as the publisher.</p></li><li class="listitem"><p>Preserve all the copyright notices of the Document.</p></li><li class="listitem"><p>Add an appropriate copyright notice for your modifications
+        adjacent to the other copyright notices.</p></li><li class="listitem"><p>Include, immediately after the copyright notices, a license
+        notice giving the public permission to use the Modified Version under
+        the terms of this License, in the form shown in the Addendum
+        below.</p></li><li class="listitem"><p>Preserve in that license notice the full lists of Invariant
+        Sections and required Cover Texts given in the Document's license
+        notice.</p></li><li class="listitem"><p>Include an unaltered copy of this License.</p></li><li class="listitem"><p>Preserve the section entitled "History", and its title, and add
+        to it an item stating at least the title, year, new authors, and
+        publisher of the Modified Version as given on the Title Page. If
+        there is no section entitled "History" in the Document, create one
+        stating the title, year, authors, and publisher of the Document as
+        given on its Title Page, then add an item describing the Modified
+        Version as stated in the previous sentence.</p></li><li class="listitem"><p>Preserve the network location, if any, given in the Document
+        for public access to a Transparent copy of the Document, and likewise
+        the network locations given in the Document for previous versions it
+        was based on. These may be placed in the "History" section. You may
+        omit a network location for a work that was published at least four
+        years before the Document itself, or if the original publisher of the
+        version it refers to gives permission.</p></li><li class="listitem"><p>In any section entitled "Acknowledgements" or "Dedications",
+        preserve the section's title, and preserve in the section all the
+        substance and tone of each of the contributor acknowledgements and/or
+        dedications given therein.</p></li><li class="listitem"><p>Preserve all the Invariant Sections of the Document, unaltered
+        in their text and in their titles. Section numbers or the equivalent
+        are not considered part of the section titles.</p></li><li class="listitem"><p>Delete any section entitled "Endorsements". Such a section may
+        not be included in the Modified Version.</p></li><li class="listitem"><p>Do not retitle any existing section as "Endorsements" or to
+        conflict in title with any Invariant Section.</p></li></ol></div><p>If the Modified Version includes new front-matter sections or
+    appendices that qualify as Secondary Sections and contain no material
+    copied from the Document, you may at your option designate some or all of
+    these sections as invariant. To do this, add their titles to the list of
+    Invariant Sections in the Modified Version's license notice. These titles
+    must be distinct from any other section titles.</p><p>You may add a section entitled "Endorsements", provided it contains
+    nothing but endorsements of your Modified Version by various parties--for
+    example, statements of peer review or that the text has been approved by
+    an organization as the authoritative definition of a standard.</p><p>You may add a passage of up to five words as a Front-Cover Text,
+    and a passage of up to 25 words as a Back-Cover Text, to the end of the
+    list of Cover Texts in the Modified Version. Only one passage of
+    Front-Cover Text and one of Back-Cover Text may be added by (or through
+    arrangements made by) any one entity. If the Document already includes a
+    cover text for the same cover, previously added by you or by arrangement
+    made by the same entity you are acting on behalf of, you may not add
+    another; but you may replace the old one, on explicit permission from the
+    previous publisher that added the old one.</p><p>The author(s) and publisher(s) of the Document do not by this
+    License give permission to use their names for publicity for or to assert
+    or imply endorsement of any Modified Version.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="gfdl-3.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gfdl.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="gfdl-5.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">D.3. Copying in Quantity </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> D.5. Combining Documents</td></tr></table></div></body></html>

diff --git a/docs/en/html/gfdl-5.html b/docs/en/html/gfdl-5.html
new file mode 100644 (file)
index 0000000..4132621
--- /dev/null
+++ b/docs/en/html/gfdl-5.html
@@ -0,0 +1,18 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>D.5. Combining Documents</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="gfdl.html" title="Appendix D. GNU Free Documentation License"><link rel="prev" href="gfdl-4.html" title="D.4. Modifications"><link rel="next" href="gfdl-6.html" title="D.6. Collections of Documents"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">D.5. Combining Documents</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="gfdl-4.html">Prev</a> </td><th width="60%" align="center">Appendix D. GNU Free Documentation License</th><td width="20%" align="right"> <a accesskey="n" href="gfdl-6.html">Next</a></td></tr></table><hr></div><div class="section" title="D.5. Combining Documents"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-5"></a>D.5. Combining Documents</h2></div></div></div><p>You may combine the Document with other documents released under
+    this License, under the terms defined in section 4 above for modified
+    versions, provided that you include in the combination all of the
+    Invariant Sections of all of the original documents, unmodified, and list
+    them all as Invariant Sections of your combined work in its license
+    notice.</p><p>The combined work need only contain one copy of this License, and
+    multiple identical Invariant Sections may be replaced with a single copy.
+    If there are multiple Invariant Sections with the same name but different
+    contents, make the title of each such section unique by adding at the end
+    of it, in parentheses, the name of the original author or publisher of
+    that section if known, or else a unique number. Make the same adjustment
+    to the section titles in the list of Invariant Sections in the license
+    notice of the combined work.</p><p>In the combination, you must combine any sections entitled
+    "History" in the various original documents, forming one section entitled
+    "History"; likewise combine any sections entitled "Acknowledgements", and
+    any sections entitled "Dedications". You must delete all sections
+    entitled "Endorsements."</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="gfdl-4.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gfdl.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="gfdl-6.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">D.4. Modifications </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> D.6. Collections of Documents</td></tr></table></div></body></html>

diff --git a/docs/en/html/gfdl-6.html b/docs/en/html/gfdl-6.html
new file mode 100644 (file)
index 0000000..c716771
--- /dev/null
+++ b/docs/en/html/gfdl-6.html
@@ -0,0 +1,10 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>D.6. Collections of Documents</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="gfdl.html" title="Appendix D. GNU Free Documentation License"><link rel="prev" href="gfdl-5.html" title="D.5. Combining Documents"><link rel="next" href="gfdl-7.html" title="D.7. Aggregation with Independent Works"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">D.6. Collections of Documents</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="gfdl-5.html">Prev</a> </td><th width="60%" align="center">Appendix D. GNU Free Documentation License</th><td width="20%" align="right"> <a accesskey="n" href="gfdl-7.html">Next</a></td></tr></table><hr></div><div class="section" title="D.6. Collections of Documents"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-6"></a>D.6. Collections of Documents</h2></div></div></div><p>You may make a collection consisting of the Document and other
+    documents released under this License, and replace the individual copies
+    of this License in the various documents with a single copy that is
+    included in the collection, provided that you follow the rules of this
+    License for verbatim copying of each of the documents in all other
+    respects.</p><p>You may extract a single document from such a collection, and
+    distribute it individually under this License, provided you insert a copy
+    of this License into the extracted document, and follow this License in
+    all other respects regarding verbatim copying of that document.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="gfdl-5.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gfdl.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="gfdl-7.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">D.5. Combining Documents </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> D.7. Aggregation with Independent Works</td></tr></table></div></body></html>

diff --git a/docs/en/html/gfdl-7.html b/docs/en/html/gfdl-7.html
new file mode 100644 (file)
index 0000000..7ef5598
--- /dev/null
+++ b/docs/en/html/gfdl-7.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>D.7. Aggregation with Independent Works</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="gfdl.html" title="Appendix D. GNU Free Documentation License"><link rel="prev" href="gfdl-6.html" title="D.6. Collections of Documents"><link rel="next" href="gfdl-8.html" title="D.8. Translation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">D.7. Aggregation with Independent Works</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="gfdl-6.html">Prev</a> </td><th width="60%" align="center">Appendix D. GNU Free Documentation License</th><td width="20%" align="right"> <a accesskey="n" href="gfdl-8.html">Next</a></td></tr></table><hr></div><div class="section" title="D.7. Aggregation with Independent Works"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-7"></a>D.7. Aggregation with Independent Works</h2></div></div></div><p>A compilation of the Document or its derivatives with other
+    separate and independent documents or works, in or on a volume of a
+    storage or distribution medium, does not as a whole count as a Modified
+    Version of the Document, provided no compilation copyright is claimed for
+    the compilation. Such a compilation is called an "aggregate", and this
+    License does not apply to the other self-contained works thus compiled
+    with the Document, on account of their being thus compiled, if they are
+    not themselves derivative works of the Document.</p><p>If the Cover Text requirement of section 3 is applicable to these
+    copies of the Document, then if the Document is less than one quarter of
+    the entire aggregate, the Document's Cover Texts may be placed on covers
+    that surround only the Document within the aggregate. Otherwise they must
+    appear on covers around the whole aggregate.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="gfdl-6.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gfdl.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="gfdl-8.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">D.6. Collections of Documents </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> D.8. Translation</td></tr></table></div></body></html>

diff --git a/docs/en/html/gfdl-8.html b/docs/en/html/gfdl-8.html
new file mode 100644 (file)
index 0000000..2b4108e
--- /dev/null
+++ b/docs/en/html/gfdl-8.html
@@ -0,0 +1,11 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>D.8. Translation</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="gfdl.html" title="Appendix D. GNU Free Documentation License"><link rel="prev" href="gfdl-7.html" title="D.7. Aggregation with Independent Works"><link rel="next" href="gfdl-9.html" title="D.9. Termination"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">D.8. Translation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="gfdl-7.html">Prev</a> </td><th width="60%" align="center">Appendix D. GNU Free Documentation License</th><td width="20%" align="right"> <a accesskey="n" href="gfdl-9.html">Next</a></td></tr></table><hr></div><div class="section" title="D.8. Translation"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-8"></a>D.8. Translation</h2></div></div></div><p>Translation is considered a kind of modification, so you may
+    distribute translations of the Document under the terms of section 4.
+    Replacing Invariant Sections with translations requires special
+    permission from their copyright holders, but you may include translations
+    of some or all Invariant Sections in addition to the original versions of
+    these Invariant Sections. You may include a translation of this License
+    provided that you also include the original English version of this
+    License. In case of a disagreement between the translation and the
+    original English version of this License, the original English version
+    will prevail.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="gfdl-7.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gfdl.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="gfdl-9.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">D.7. Aggregation with Independent Works </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> D.9. Termination</td></tr></table></div></body></html>

diff --git a/docs/en/html/gfdl-9.html b/docs/en/html/gfdl-9.html
new file mode 100644 (file)
index 0000000..74a02aa
--- /dev/null
+++ b/docs/en/html/gfdl-9.html
@@ -0,0 +1,8 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>D.9. Termination</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="gfdl.html" title="Appendix D. GNU Free Documentation License"><link rel="prev" href="gfdl-8.html" title="D.8. Translation"><link rel="next" href="gfdl-10.html" title="D.10. Future Revisions of this License"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">D.9. Termination</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="gfdl-8.html">Prev</a> </td><th width="60%" align="center">Appendix D. GNU Free Documentation License</th><td width="20%" align="right"> <a accesskey="n" href="gfdl-10.html">Next</a></td></tr></table><hr></div><div class="section" title="D.9. Termination"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-9"></a>D.9. Termination</h2></div></div></div><p>You may not copy, modify, sublicense, or distribute the Document
+    except as expressly provided for under this License. Any other attempt to
+    copy, modify, sublicense or distribute the Document is void, and will
+    automatically terminate your rights under this License. However, parties
+    who have received copies, or rights, from you under this License will not
+    have their licenses terminated so long as such parties remain in full
+    compliance.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="gfdl-8.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gfdl.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="gfdl-10.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">D.8. Translation </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> D.10. Future Revisions of this License</td></tr></table></div></body></html>

diff --git a/docs/en/html/gfdl-howto.html b/docs/en/html/gfdl-howto.html
new file mode 100644 (file)
index 0000000..24f0a1e
--- /dev/null
+++ b/docs/en/html/gfdl-howto.html
@@ -0,0 +1,16 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>D.. How to use this License for your documents</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="gfdl.html" title="Appendix D. GNU Free Documentation License"><link rel="prev" href="gfdl-10.html" title="D.10. Future Revisions of this License"><link rel="next" href="glossary.html" title="Glossary"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">D.. How to use this License for your documents</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="gfdl-10.html">Prev</a> </td><th width="60%" align="center">Appendix D. GNU Free Documentation License</th><td width="20%" align="right"> <a accesskey="n" href="glossary.html">Next</a></td></tr></table><hr></div><div class="section" title="D.. How to use this License for your documents"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gfdl-howto"></a>D.. How to use this License for your documents</h2></div></div></div><p>To use this License in a document you have written, include a copy
+    of the License in the document and put the following copyright and
+    license notices just after the title page:</p><div class="blockquote"><blockquote class="blockquote"><p>Copyright (c) YEAR YOUR NAME. Permission is granted to copy,
+      distribute and/or modify this document under the terms of the GNU Free
+      Documentation License, Version 1.1 or any later version published by
+      the Free Software Foundation; with the Invariant Sections being LIST
+      THEIR TITLES, with the Front-Cover Texts being LIST, and with the
+      Back-Cover Texts being LIST. A copy of the license is included in the
+      section entitled "GNU Free Documentation License".</p></blockquote></div><p>If you have no Invariant Sections, write "with no Invariant
+    Sections" instead of saying which ones are invariant. If you have no
+    Front-Cover Texts, write "no Front-Cover Texts" instead of "Front-Cover
+    Texts being LIST"; likewise for Back-Cover Texts.</p><p>If your document contains nontrivial examples of program code, we
+    recommend releasing these examples in parallel under your choice of free
+    software license, such as the GNU General Public License, to permit their
+    use in free software.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="gfdl-10.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gfdl.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="glossary.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">D.10. Future Revisions of this License </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Glossary</td></tr></table></div></body></html>

diff --git a/docs/en/html/gfdl.html b/docs/en/html/gfdl.html
new file mode 100644 (file)
index 0000000..c6f2c6d
--- /dev/null
+++ b/docs/en/html/gfdl.html
@@ -0,0 +1,5 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Appendix D. GNU Free Documentation License</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="prev" href="modules-manual-optional.html" title="C.3. Optional Modules"><link rel="next" href="gfdl-0.html" title="D.0. Preamble"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix D. GNU Free Documentation License</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="modules-manual-optional.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="gfdl-0.html">Next</a></td></tr></table><hr></div><div class="appendix" title="Appendix D. GNU Free Documentation License"><div class="titlepage"><div><div><h2 class="title"><a name="gfdl"></a>Appendix D. GNU Free Documentation License</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="gfdl-0.html">D.0. Preamble</a></span></dt><dt><span class="section"><a href="gfdl-1.html">D.1. Applicability and Definition</a></span></dt><dt><span class="section"><a href="gfdl-2.html">D.2. Verbatim Copying</a></span></dt><dt><span class="section"><a href="gfdl-3.html">D.3. Copying in Quantity</a></span></dt><dt><span class="section"><a href="gfdl-4.html">D.4. Modifications</a></span></dt><dt><span class="section"><a href="gfdl-5.html">D.5. Combining Documents</a></span></dt><dt><span class="section"><a href="gfdl-6.html">D.6. Collections of Documents</a></span></dt><dt><span class="section"><a href="gfdl-7.html">D.7. Aggregation with Independent Works</a></span></dt><dt><span class="section"><a href="gfdl-8.html">D.8. Translation</a></span></dt><dt><span class="section"><a href="gfdl-9.html">D.9. Termination</a></span></dt><dt><span class="section"><a href="gfdl-10.html">D.10. Future Revisions of this License</a></span></dt><dt><span class="section"><a href="gfdl-howto.html">D.. How to use this License for your documents</a></span></dt></dl></div><p>Version 1.1, March 2000</p><div class="blockquote"><blockquote class="blockquote"><p>Copyright (C) 2000 Free Software Foundation, Inc. 51 Franklin Street,
+    Fifth Floor, Boston, MA 02110-1301 USA Everyone is permitted to copy and
+    distribute verbatim copies of this license document, but changing it is
+    not allowed.</p></blockquote></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="modules-manual-optional.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="gfdl-0.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">C.3. Optional Modules </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> D.0. Preamble</td></tr></table></div></body></html>

diff --git a/docs/en/html/glossary.html b/docs/en/html/glossary.html
new file mode 100644 (file)
index 0000000..5455903
--- /dev/null
+++ b/docs/en/html/glossary.html
@@ -0,0 +1,195 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Glossary</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="prev" href="gfdl-howto.html" title="D.. How to use this License for your documents"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Glossary</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="gfdl-howto.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> </td></tr></table><hr></div><div class="glossary" title="Glossary"><div class="titlepage"><div><div><h2 class="title"><a name="glossary"></a>Glossary</h2></div></div></div><div class="glossdiv" title="0-9, high ascii"><h3 class="title">0-9, high ascii</h3><dl><dt><a name="gloss-htaccess"></a>.htaccess</dt><dd><p>Apache web server, and other NCSA-compliant web servers,
+        observe the convention of using files in directories called 
+        <code class="filename">.htaccess</code>
+
+        to restrict access to certain files. In Bugzilla, they are used
+        to keep secret files which would otherwise
+        compromise your installation - e.g. the 
+        <code class="filename">localconfig</code>
+        file contains the password to your database.
+        curious.</p></dd></dl></div><div class="glossdiv" title="A"><h3 class="title">A</h3><dl><dt><a name="gloss-apache"></a>Apache</dt><dd><p>In this context, Apache is the web server most commonly used
+        for serving up Bugzilla 
+        pages. Contrary to popular belief, the apache web server has nothing
+        to do with the ancient and noble Native American tribe, but instead
+        derived its name from the fact that it was 
+        <span class="quote">“<span class="quote">a patchy</span>”</span>
+        version of the original 
+        <acronym class="acronym">NCSA</acronym>
+        world-wide-web server.</p><div class="variablelist" title="Useful Directives when configuring Bugzilla"><p class="title"><b>Useful Directives when configuring Bugzilla</b></p><dl><dt><span class="term"><code class="computeroutput"><a class="ulink" href="http://httpd.apache.org/docs/2.0/mod/mod_mime.html#addhandler" target="_top">AddHandler</a></code></span></dt><dd><p>Tell Apache that it's OK to run CGI scripts.</p></dd><dt><span class="term"><code class="computeroutput"><a class="ulink" href="http://httpd.apache.org/docs-2.0/mod/core.html#allowoverride" target="_top">AllowOverride</a></code>, </span><span class="term"><code class="computeroutput"><a class="ulink" href="http://httpd.apache.org/docs-2.0/mod/core.html#options" target="_top">Options</a></code></span></dt><dd><p>These directives are used to tell Apache many things about
+              the directory they apply to. For Bugzilla's purposes, we need
+              them to allow script execution and <code class="filename">.htaccess</code>
+              overrides.
+              </p></dd><dt><span class="term"><code class="computeroutput"><a class="ulink" href="http://httpd.apache.org/docs-2.0/mod/mod_dir.html#directoryindex" target="_top">DirectoryIndex</a></code></span></dt><dd><p>Used to tell Apache what files are indexes. If you can
+              not add <code class="filename">index.cgi</code> to the list of valid files,
+              you'll need to set <code class="computeroutput">$index_html</code> to
+              1 in <code class="filename">localconfig</code> so
+              <span class="command"><strong>./checksetup.pl</strong></span> will create an
+              <code class="filename">index.html</code> that redirects to
+              <code class="filename">index.cgi</code>.
+              </p></dd><dt><span class="term"><code class="computeroutput"><a class="ulink" href="http://httpd.apache.org/docs-2.0/mod/core.html#scriptinterpretersource" target="_top">ScriptInterpreterSource</a></code></span></dt><dd><p>Used when running Apache on windows so the shebang line
+              doesn't have to be changed in every Bugzilla script.
+              </p></dd></dl></div><p>For more information about how to configure Apache for Bugzilla,
+        see <a class="xref" href="configuration.html#http-apache" title="2.2.4.1. Bugzilla using Apache">Section 2.2.4.1, “Bugzilla using Apache”</a>.
+        </p></dd></dl></div><div class="glossdiv" title="B"><h3 class="title">B</h3><dl><dt>Bug</dt><dd><p>A 
+        <span class="quote">“<span class="quote">bug</span>”</span>
+
+        in Bugzilla refers to an issue entered into the database which has an
+        associated number, assignments, comments, etc. Some also refer to a 
+        <span class="quote">“<span class="quote">tickets</span>”</span>
+        or 
+        <span class="quote">“<span class="quote">issues</span>”</span>; 
+        in the context of Bugzilla, they are synonymous.</p></dd><dt>Bug Number</dt><dd><p>Each Bugzilla bug is assigned a number that uniquely identifies
+        that bug. The bug associated with a bug number can be pulled up via a
+        query, or easily from the very front page by typing the number in the
+        "Find" box.</p></dd><dt><a name="gloss-bugzilla"></a>Bugzilla</dt><dd><p>Bugzilla is the world-leading free software bug tracking system.
+        </p></dd></dl></div><div class="glossdiv" title="C"><h3 class="title">C</h3><dl><dt><a name="gloss-cgi"></a>Common Gateway Interface</dt><dd><p><acronym class="acronym">CGI</acronym> is an acronym for Common Gateway Interface. This is
+        a standard for interfacing an external application with a web server. Bugzilla
+        is an example of a <acronym class="acronym">CGI</acronym> application.
+        </p></dd><dt><a name="gloss-component"></a>Component</dt><dd><p>A Component is a subsection of a Product. It should be a narrow
+        category, tailored to your organization. All Products must contain at
+        least one Component (and, as a matter of fact, creating a Product
+        with no Components will create an error in Bugzilla).</p></dd><dt><a name="gloss-cpan"></a>Comprehensive Perl Archive Network</dt><dd><p>
+        <acronym class="acronym">CPAN</acronym>
+
+        stands for the 
+        <span class="quote">“<span class="quote">Comprehensive Perl Archive Network</span>”</span>. 
+        CPAN maintains a large number of extremely useful 
+        <em class="glossterm">Perl</em>
+        modules - encapsulated chunks of code for performing a
+        particular task.</p></dd><dt><a name="gloss-contrib"></a><code class="filename">contrib</code></dt><dd><p>The <code class="filename">contrib</code> directory is
+        a location to put scripts that have been contributed to Bugzilla but
+        are not a part of the official distribution. These scripts are written
+        by third parties and may be in languages other than perl. For those
+        that are in perl, there may be additional modules or other requirements
+        than those of the official distribution.
+        </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Scripts in the <code class="filename">contrib</code>
+          directory are not officially supported by the Bugzilla team and may
+          break in between versions.
+          </p></td></tr></table></div><p>
+        </p></dd></dl></div><div class="glossdiv" title="D"><h3 class="title">D</h3><dl><dt><a name="gloss-daemon"></a>daemon</dt><dd><p>A daemon is a computer program which runs in the background. In
+        general, most daemons are started at boot time via System V init
+        scripts, or through RC scripts on BSD-based systems. 
+        <em class="glossterm">mysqld</em>, 
+        the MySQL server, and 
+        <em class="glossterm">apache</em>, 
+        a web server, are generally run as daemons.</p></dd><dt><a name="gloss-dos"></a>DOS Attack</dt><dd><p>A DOS, or Denial of Service attack, is when a user attempts to
+        deny access to a web server by repeatedly accessing a page or sending
+        malformed requests to a webserver. A D-DOS, or
+        Distributed Denial of Service attack, is when these requests come
+        from multiple sources at the same time. Unfortunately, these are much
+        more difficult to defend against.
+        </p></dd></dl></div><div class="glossdiv" title="G"><h3 class="title">G</h3><dl><dt><a name="gloss-groups"></a>Groups</dt><dd><p>The word 
+        <span class="quote">“<span class="quote">Groups</span>”</span>
+
+        has a very special meaning to Bugzilla. Bugzilla's main security
+        mechanism comes by placing users in groups, and assigning those
+        groups certain privileges to view bugs in particular
+        <em class="glossterm">Products</em>
+        in the 
+        <em class="glossterm">Bugzilla</em>
+        database.</p></dd></dl></div><div class="glossdiv" title="J"><h3 class="title">J</h3><dl><dt><a name="gloss-javascript"></a>JavaScript</dt><dd><p>JavaScript is cool, we should talk about it.
+        </p></dd></dl></div><div class="glossdiv" title="M"><h3 class="title">M</h3><dl><dt><a name="gloss-mta"></a>Message Transport Agent</dt><dd><p>A Message Transport Agent is used to control the flow of email on a system.
+        The <a class="ulink" href="http://search.cpan.org/dist/Email-Send/lib/Email/Send.pm" target="_top">Email::Send</a>
+        Perl module, which Bugzilla uses to send email, can be configured to
+        use many different underlying implementations for actually sending the
+        mail using the <code class="option">mail_delivery_method</code> parameter.
+        </p></dd><dt><a name="gloss-mysql"></a>MySQL</dt><dd><p>MySQL is one of the supported
+        <a class="glossterm" href="glossary.html#gloss-rdbms"><em class="glossterm">RDBMS</em></a> for Bugzilla. MySQL
+        can be downloaded from <a class="ulink" href="http://www.mysql.com" target="_top">http://www.mysql.com</a>. While you
+        should familiarize yourself with all of the documentation, some high
+        points are:
+        </p><div class="variablelist"><dl><dt><span class="term"><a class="ulink" href="http://www.mysql.com/doc/en/Backup.html" target="_top">Backup</a></span></dt><dd><p>Methods for backing up your Bugzilla database.
+              </p></dd><dt><span class="term"><a class="ulink" href="http://www.mysql.com/doc/en/Option_files.html" target="_top">Option Files</a></span></dt><dd><p>Information about how to configure MySQL using
+              <code class="filename">my.cnf</code>.
+              </p></dd><dt><span class="term"><a class="ulink" href="http://www.mysql.com/doc/en/Privilege_system.html" target="_top">Privilege System</a></span></dt><dd><p>Information about how to protect your MySQL server.
+              </p></dd></dl></div></dd></dl></div><div class="glossdiv" title="P"><h3 class="title">P</h3><dl><dt><a name="gloss-ppm"></a>Perl Package Manager</dt><dd><p><a class="ulink" href="http://aspn.activestate.com/ASPN/Downloads/ActivePerl/PPM/" target="_top">http://aspn.activestate.com/ASPN/Downloads/ActivePerl/PPM/</a>
+        </p></dd><dt>Product</dt><dd><p>A Product is a broad category of types of bugs, normally
+        representing a single piece of software or entity. In general,
+        there are several Components to a Product. A Product may define a
+        group (used for security) for all bugs entered into
+        its Components.</p></dd><dt>Perl</dt><dd><p>First written by Larry Wall, Perl is a remarkable program
+        language. It has the benefits of the flexibility of an interpreted
+        scripting language (such as shell script), combined with the speed
+        and power of a compiled language, such as C. 
+        <em class="glossterm">Bugzilla</em>
+
+        is maintained in Perl.</p></dd></dl></div><div class="glossdiv" title="Q"><h3 class="title">Q</h3><dl><dt>QA</dt><dd><p>
+        <span class="quote">“<span class="quote">QA</span>”</span>, 
+        <span class="quote">“<span class="quote">Q/A</span>”</span>, and 
+        <span class="quote">“<span class="quote">Q.A.</span>”</span>
+        are short for 
+        <span class="quote">“<span class="quote">Quality Assurance</span>”</span>. 
+        In most large software development organizations, there is a team
+        devoted to ensuring the product meets minimum standards before
+        shipping. This team will also generally want to track the progress of
+        bugs over their life cycle, thus the need for the 
+        <span class="quote">“<span class="quote">QA Contact</span>”</span>
+
+        field in a bug.</p></dd></dl></div><div class="glossdiv" title="R"><h3 class="title">R</h3><dl><dt><a name="gloss-rdbms"></a>Relational DataBase Management System</dt><dd><p>A relational database management system is a database system
+        that stores information in tables that are related to each other.
+        </p></dd><dt><a name="gloss-regexp"></a>Regular Expression</dt><dd><p>A regular expression is an expression used for pattern matching.
+              <a class="ulink" href="http://perldoc.com/perl5.6/pod/perlre.html#Regular-Expressions" target="_top">Documentation</a>
+        </p></dd></dl></div><div class="glossdiv" title="S"><h3 class="title">S</h3><dl><dt><a name="gloss-service"></a>Service</dt><dd><p>In Windows NT environment, a boot-time background application
+        is referred to as a service. These are generally managed through the
+        control panel while logged in as an account with
+        <span class="quote">“<span class="quote">Administrator</span>”</span> level capabilities. For more
+        information, consult your Windows manual or the MSKB.
+        </p></dd><dt>
+        <acronym class="acronym">SGML</acronym>
+      </dt><dd><p>
+        <acronym class="acronym">SGML</acronym>
+
+        stands for 
+        <span class="quote">“<span class="quote">Standard Generalized Markup Language</span>”</span>. 
+        Created in the 1980's to provide an extensible means to maintain
+        documentation based upon content instead of presentation, 
+        <acronym class="acronym">SGML</acronym>
+
+        has withstood the test of time as a robust, powerful language. 
+        <em class="glossterm">
+          <acronym class="acronym">XML</acronym>
+        </em>
+
+        is the 
+        <span class="quote">“<span class="quote">baby brother</span>”</span>
+
+        of SGML; any valid 
+        <acronym class="acronym">XML</acronym>
+
+        document it, by definition, a valid 
+        <acronym class="acronym">SGML</acronym>
+
+        document. The document you are reading is written and maintained in 
+        <acronym class="acronym">SGML</acronym>, 
+        and is also valid 
+        <acronym class="acronym">XML</acronym>
+
+        if you modify the Document Type Definition.</p></dd></dl></div><div class="glossdiv" title="T"><h3 class="title">T</h3><dl><dt><a name="gloss-target-milestone"></a>Target Milestone</dt><dd><p>Target Milestones are Product goals. They are configurable on a
+        per-Product basis. Most software development houses have a concept of
+        
+        <span class="quote">“<span class="quote">milestones</span>”</span>
+
+        where the people funding a project expect certain functionality on
+        certain dates. Bugzilla facilitates meeting these milestones by
+        giving you the ability to declare by which milestone a bug will be
+        fixed, or an enhancement will be implemented.</p></dd><dt><a name="gloss-tcl"></a>Tool Command Language</dt><dd><p>TCL is an open source scripting language available for Windows,
+        Macintosh, and Unix based systems. Bugzilla 1.0 was written in TCL but
+        never released. The first release of Bugzilla was 2.0, which was when
+        it was ported to perl.
+        </p></dd></dl></div><div class="glossdiv" title="Z"><h3 class="title">Z</h3><dl><dt><a name="gloss-zarro"></a>Zarro Boogs Found</dt><dd><p>This is just a goofy way of saying that there were no bugs
+        found matching your query. When asked to explain this message,
+        Terry had the following to say:
+        </p><div class="blockquote"><table border="0" width="100%" cellspacing="0" cellpadding="0" class="blockquote" summary="Block quote"><tr><td width="10%" valign="top"> </td><td width="80%" valign="top"><p>I've been asked to explain this ... way back when, when
+          Netscape released version 4.0 of its browser, we had a release
+          party.  Naturally, there had been a big push to try and fix every
+          known bug before the release. Naturally, that hadn't actually
+          happened.  (This is not unique to Netscape or to 4.0; the same thing
+          has happened with every software project I've ever seen.)  Anyway,
+          at the release party, T-shirts were handed out that said something
+          like "Netscape 4.0: Zarro Boogs". Just like the software, the
+          T-shirt had no known bugs.  Uh-huh.
+          </p><p>So, when you query for a list of bugs, and it gets no results,
+          you can think of this as a friendly reminder.  Of *course* there are
+          bugs matching your query, they just aren't in the bugsystem yet...
+          </p></td><td width="10%" valign="top"> </td></tr><tr><td width="10%" valign="top"> </td><td colspan="2" align="right" valign="top">--<span class="attribution">Terry Weissman</span></td></tr></table></div></dd></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="gfdl-howto.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> </td></tr><tr><td width="40%" align="left" valign="top">D.. How to use this License for your documents </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> </td></tr></table></div></body></html>

diff --git a/docs/en/html/groups.html b/docs/en/html/groups.html
new file mode 100644 (file)
index 0000000..0607f20
--- /dev/null
+++ b/docs/en/html/groups.html
@@ -0,0 +1,176 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.15. Groups and Group Security</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="quips.html" title="3.14. Quips"><link rel="next" href="sanitycheck.html" title="3.16. Checking and Maintaining Database Integrity"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.15. Groups and Group Security</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="quips.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="sanitycheck.html">Next</a></td></tr></table><hr></div><div class="section" title="3.15. Groups and Group Security"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="groups"></a>3.15. Groups and Group Security</h2></div></div></div><p>
+    Groups allow for separating bugs into logical divisions.
+    Groups are typically used
+    to isolate bugs that should only be seen by certain people. For
+    example, a company might create a different group for each one of its customers
+    or partners. Group permissions could be set so that each partner or customer would
+    only have access to their own bugs. Or, groups might be used to create
+    variable access controls for different departments within an organization.
+    Another common use of groups is to associate groups with products,
+    creating isolation and access control on a per-product basis.
+    </p><p>
+    Groups and group behaviors are controlled in several places:
+    </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+             The group configuration page. To view or edit existing groups, or to
+             create new groups, access the "Groups" link from the "Administration"
+             page. This section of the manual deals primarily with the aspect of
+             group controls accessed on this page.  
+           </p></li><li class="listitem"><p>
+            Global configuration parameters. Bugzilla has several parameters 
+            that control the overall default group behavior and restriction
+            levels. For more information on the parameters that control 
+            group behavior globally, see <a class="xref" href="parameters.html#param-group-security" title="3.1.9. Group Security">Section 3.1.9, “Group Security”</a>.
+          </p></li><li class="listitem"><p>
+            Product association with groups. Most of the functionality of groups
+            and group security is controlled at the product level. Some aspects
+            of group access controls for products are discussed in this section,
+            but for more detail see <a class="xref" href="products.html#product-group-controls" title="3.4.4. Assigning Group Controls to Products">Section 3.4.4, “Assigning Group Controls to Products”</a>.
+          </p></li><li class="listitem"><p>
+            Group access for users. See <a class="xref" href="groups.html#users-and-groups" title="3.15.3. Assigning Users to Groups">Section 3.15.3, “Assigning Users to Groups”</a> for
+            details on how users are assigned group access.
+          </p></li></ol></div><p>
+      Group permissions are such that if a bug belongs to a group, only members
+      of that group can see the bug. If a bug is in more than one group, only
+      members of <span class="emphasis"><em>all</em></span> the groups that the bug is in can see
+      the bug. For information on granting read-only access to certain people and
+      full edit access to others, see <a class="xref" href="products.html#product-group-controls" title="3.4.4. Assigning Group Controls to Products">Section 3.4.4, “Assigning Group Controls to Products”</a>.
+     </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        By default, bugs can also be seen by the Assignee, the Reporter, and 
+        by everyone on the CC List, regardless of whether or not the bug would 
+        typically be viewable by them. Visibility to the Reporter and CC List can 
+        be overridden (on a per-bug basis) by bringing up the bug, finding the 
+        section that starts with <span class="quote">“<span class="quote">Users in the roles selected below...</span>”</span>
+        and un-checking the box next to either 'Reporter' or 'CC List' (or both).
+      </p></td></tr></table></div><div class="section" title="3.15.1. Creating Groups"><div class="titlepage"><div><div><h3 class="title"><a name="create-groups"></a>3.15.1. Creating Groups</h3></div></div></div><p>
+        To create a new group, follow the steps below:
+      </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+            Select the <span class="quote">“<span class="quote">Administration</span>”</span> link in the page footer, 
+            and then select the <span class="quote">“<span class="quote">Groups</span>”</span> link from the 
+            Administration page.
+          </p></li><li class="listitem"><p>
+            A table of all the existing groups is displayed. Below the table is a
+            description of all the fields. To create a new group, select the 
+            <span class="quote">“<span class="quote">Add Group</span>”</span> link under the table of existing groups.
+          </p></li><li class="listitem"><p>
+            There are five fields to fill out. These fields are documented below
+            the form. Choose a name and description for the group. Decide whether
+            this group should be used for bugs (in all likelihood this should be
+            selected). Optionally, choose a regular expression that will
+            automatically add any matching users to the group, and choose an
+            icon that will help identify user comments for the group. The regular
+            expression can be useful, for example, to automatically put all users
+            from the same company into one group (if the group is for a specific
+            customer or partner). 
+          </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+               If <span class="quote">“<span class="quote">User RegExp</span>”</span> is filled out, users whose email 
+               addresses match the regular expression will automatically be 
+               members of the group as long as their email addresses continue 
+               to match the regular expression. If their email address changes
+               and no longer matches the regular expression, they will be removed
+               from the group. Versions 2.16 and older of Bugzilla did not automatically
+               remove users who's email addresses no longer matched the RegExp.
+             </p></td></tr></table></div><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+               If specifying a domain in the regular expression, end
+               the regexp with a "$". Otherwise, when granting access to 
+               "@mycompany\.com", access will also be granted to 
+               'badperson@mycompany.com.cracker.net'. Use the syntax,
+               '@mycompany\.com$' for the regular expression.
+             </p></td></tr></table></div></li><li class="listitem"><p>
+          After the new group is created, it can be edited for additional options. 
+          The "Edit Group" page allows for specifying other groups that should be included
+          in this group and which groups should be permitted to add and delete
+          users from this group. For more details, see <a class="xref" href="groups.html#edit-groups" title="3.15.2. Editing Groups and Assigning Group Permissions">Section 3.15.2, “Editing Groups and Assigning Group Permissions”</a>.
+          </p></li></ol></div></div><div class="section" title="3.15.2. Editing Groups and Assigning Group Permissions"><div class="titlepage"><div><div><h3 class="title"><a name="edit-groups"></a>3.15.2. Editing Groups and Assigning Group Permissions</h3></div></div></div><p>
+        To access the "Edit Groups" page, select the 
+        <span class="quote">“<span class="quote">Administration</span>”</span> link in the page footer, 
+        and then select the <span class="quote">“<span class="quote">Groups</span>”</span> link from the Administration page.
+        A table of all the existing groups is displayed. Click on a group name
+        you wish to edit or control permissions for.
+      </p><p>
+       The "Edit Groups" page contains the same five fields present when 
+       creating a new group. Below that are two additional sections, "Group
+       Permissions," and "Mass Remove". The "Mass Remove" option simply removes
+       all users from the group who match the regular expression entered. The
+       "Group Permissions" section requires further explanation.
+      </p><p>
+       The "Group Permissions" section on the "Edit Groups" page contains four sets
+       of permissions that control the relationship of this group to other
+       groups. If the 'usevisibilitygroups' parameter is in use (see
+       <a class="xref" href="parameters.html" title="3.1. Bugzilla Configuration">Section 3.1, “Bugzilla Configuration”</a>) two additional sets of permissions are displayed. 
+       Each set consists of two select boxes. On the left, a select box
+       with a list of all existing groups. On the right, a select box listing
+       all groups currently selected for this permission setting (this box will
+       be empty for new groups). The way these controls allow groups to relate
+       to one another is called <span class="emphasis"><em>inheritance</em></span>. 
+       Each of the six permissions is described below.
+      </p><div class="variablelist"><dl><dt><span class="term">
+            <span class="emphasis"><em>Groups That Are a Member of This Group</em></span>
+          </span></dt><dd><p> 
+              Members of any groups selected here will automatically have 
+              membership in this group. In other words, members of any selected 
+              group will inherit membership in this group. 
+            </p></dd><dt><span class="term">
+            <span class="emphasis"><em>Groups That This Group Is a Member Of</em></span>
+          </span></dt><dd><p>
+              Members of this group will inherit membership to any group 
+              selected here. For example, suppose the group being edited is
+              an Admin group. If there are two products  (Product1 and Product2) 
+              and each product has its
+              own group (Group1 and Group2), and the Admin group 
+              should have access to both products, 
+              simply select both Group1 and Group2 here. 
+           </p></dd><dt><span class="term">
+            <span class="emphasis"><em>Groups That Can Grant Membership in This Group</em></span>
+          </span></dt><dd><p>
+             The members of any group selected here will be able add users
+             to this group, even if they themselves are not in this group.
+           </p></dd><dt><span class="term">
+            <span class="emphasis"><em>Groups That This Group Can Grant Membership In</em></span>
+          </span></dt><dd><p>
+             Members of this group can add users to any group selected here,
+             even if they themselves are not in the selected groups.  
+           </p></dd><dt><span class="term">
+            <span class="emphasis"><em>Groups That Can See This Group</em></span>
+          </span></dt><dd><p>
+             Members of any selected group can see the users in this group.
+             This setting is only visible if the 'usevisibilitygroups' parameter
+             is enabled on the Bugzilla Configuration page. See
+             <a class="xref" href="parameters.html" title="3.1. Bugzilla Configuration">Section 3.1, “Bugzilla Configuration”</a> for information on configuring Bugzilla.
+           </p></dd><dt><span class="term">
+            <span class="emphasis"><em>Groups That This Group Can See</em></span>
+          </span></dt><dd><p>
+             Members of this group can see members in any of the selected groups.
+             This setting is only visible if the 'usevisibilitygroups' parameter
+             is enabled on the the Bugzilla Configuration page. See
+             <a class="xref" href="parameters.html" title="3.1. Bugzilla Configuration">Section 3.1, “Bugzilla Configuration”</a> for information on configuring Bugzilla.               
+           </p></dd></dl></div></div><div class="section" title="3.15.3. Assigning Users to Groups"><div class="titlepage"><div><div><h3 class="title"><a name="users-and-groups"></a>3.15.3. Assigning Users to Groups</h3></div></div></div><p>
+        A User can become a member of a group in several ways:
+      </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+            The user can be explicitly placed in the group by editing
+            the user's profile. This can be done by accessing the "Users" page
+            from the "Administration" page. Use the search form to find the user
+            you want to edit group membership for, and click on their email
+            address in the search results to edit their profile. The profile
+            page lists all the groups, and indicates if the user is a member of
+            the group either directly or indirectly. More information on indirect
+            group membership is below. For more details on User administration,
+            see <a class="xref" href="useradmin.html" title="3.2. User Administration">Section 3.2, “User Administration”</a>.
+          </p></li><li class="listitem"><p>
+           The group can include another group of which the user is
+           a member. This is indicated by square brackets around the checkbox  
+           next to the group name in the user's profile. 
+           See <a class="xref" href="groups.html#edit-groups" title="3.15.2. Editing Groups and Assigning Group Permissions">Section 3.15.2, “Editing Groups and Assigning Group Permissions”</a> for details on group inheritance.
+          </p></li><li class="listitem"><p>
+            The user's email address can match the regular expression
+            that has been specified to automatically grant membership to
+            the group. This is indicated by "*" around the check box by the
+            group name in the user's profile.
+            See <a class="xref" href="groups.html#create-groups" title="3.15.1. Creating Groups">Section 3.15.1, “Creating Groups”</a> for details on 
+            the regular expression option when creating groups.
+           </p></li></ol></div></div><div class="section" title="3.15.4. Assigning Group Controls to Products"><div class="titlepage"><div><div><h3 class="title"><a name="idp14405664"></a>3.15.4. Assigning Group Controls to Products</h3></div></div></div><p>
+     The primary functionality of groups is derived from the relationship of 
+     groups to products. The concepts around segregating access to bugs with
+     product group controls can be confusing. For details and examples on this
+     topic, see <a class="xref" href="products.html#product-group-controls" title="3.4.4. Assigning Group Controls to Products">Section 3.4.4, “Assigning Group Controls to Products”</a>.
+     </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="quips.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="administration.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="sanitycheck.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.14. Quips </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.16. Checking and Maintaining Database Integrity</td></tr></table></div></body></html>

diff --git a/docs/en/html/hintsandtips.html b/docs/en/html/hintsandtips.html
new file mode 100644 (file)
index 0000000..c12765d
--- /dev/null
+++ b/docs/en/html/hintsandtips.html
@@ -0,0 +1,40 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>5.8. Hints and Tips</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="prev" href="attachments.html" title="5.7. Attachments"><link rel="next" href="timetracking.html" title="5.9. Time Tracking Information"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.8. Hints and Tips</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="attachments.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Using Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="timetracking.html">Next</a></td></tr></table><hr></div><div class="section" title="5.8. Hints and Tips"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="hintsandtips"></a>5.8. Hints and Tips</h2></div></div></div><p>This section distills some Bugzilla tips and best practices
+    that have been developed.</p><div class="section" title="5.8.1. Autolinkification"><div class="titlepage"><div><div><h3 class="title"><a name="idp13714560"></a>5.8.1. Autolinkification</h3></div></div></div><p>Bugzilla comments are plain text - so typing &lt;U&gt; will
+      produce less-than, U, greater-than rather than underlined text.
+      However, Bugzilla will automatically make hyperlinks out of certain
+      sorts of text in comments. For example, the text 
+      "http://www.bugzilla.org" will be turned into a link:
+      <a class="ulink" href="http://www.bugzilla.org" target="_top">http://www.bugzilla.org</a>.
+      Other strings which get linkified in the obvious manner are:
+      </p><table border="0" summary="Simple list" class="simplelist"><tr><td>bug 12345</td></tr><tr><td>comment 7</td></tr><tr><td>bug 23456, comment 53</td></tr><tr><td>attachment 4321</td></tr><tr><td>mailto:george@example.com</td></tr><tr><td>george@example.com</td></tr><tr><td>ftp://ftp.mozilla.org</td></tr><tr><td>Most other sorts of URL</td></tr></table><p>
+      </p><p>A corollary here is that if you type a bug number in a comment,
+      you should put the word "bug" before it, so it gets autolinkified
+      for the convenience of others.
+      </p></div><div class="section" title="5.8.2. Comments"><div class="titlepage"><div><div><h3 class="title"><a name="commenting"></a>5.8.2. Comments</h3></div></div></div><p>If you are changing the fields on a bug, only comment if
+      either you have something pertinent to say, or Bugzilla requires it.
+      Otherwise, you may spam people unnecessarily with bug mail.
+      To take an example: a user can set up their account to filter out messages
+      where someone just adds themselves to the CC field of a bug
+      (which happens a lot.) If you come along, add yourself to the CC field,
+      and add a comment saying "Adding self to CC", then that person
+      gets a pointless piece of mail they would otherwise have avoided.
+      </p><p>
+      Don't use sigs in comments. Signing your name ("Bill") is acceptable,
+      if you do it out of habit, but full mail/news-style
+      four line ASCII art creations are not.
+      </p></div><div class="section" title="5.8.3. Server-Side Comment Wrapping"><div class="titlepage"><div><div><h3 class="title"><a name="comment-wrapping"></a>5.8.3. Server-Side Comment Wrapping</h3></div></div></div><p>
+      Bugzilla stores comments unwrapped and wraps them at display time. This
+      ensures proper wrapping in all browsers. Lines beginning with the "&gt;" 
+      character are assumed to be quotes, and are not wrapped.
+      </p></div><div class="section" title="5.8.4. Dependency Tree"><div class="titlepage"><div><div><h3 class="title"><a name="dependencytree"></a>5.8.4. Dependency Tree</h3></div></div></div><p>
+        On the <span class="quote">“<span class="quote">Dependency tree</span>”</span> page linked from each bug
+        page, you can see the dependency relationship from the bug as a
+        tree structure.
+      </p><p>
+        You can change how much depth to show, and you can hide resolved bugs
+        from this page. You can also collaps/expand dependencies for
+        each bug on the tree view, using the [-]/[+] buttons that appear
+        before its summary. This option is not available for terminal
+        bugs in the tree (that don't have further dependencies).
+      </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="attachments.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="using.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="timetracking.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5.7. Attachments </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 5.9. Time Tracking Information</td></tr></table></div></body></html>

diff --git a/docs/en/html/index.html b/docs/en/html/index.html
new file mode 100644 (file)
index 0000000..96a9beb
--- /dev/null
+++ b/docs/en/html/index.html
@@ -0,0 +1,18 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>The Bugzilla Guide - 4.4 Release</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="description" content="This is the documentation for Bugzilla, a bug-tracking system from mozilla.org. Bugzilla is an enterprise-class piece of software that tracks millions of bugs and issues for hundreds of organizations around the world. The most current version of this document can always be found on the Bugzilla Documentation Page."><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="next" href="about.html" title="Chapter 1. About This Guide"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">The Bugzilla Guide - 4.4 
+    Release</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="about.html">Next</a></td></tr></table><hr></div><div class="book" title="The Bugzilla Guide - 4.4 Release"><div class="titlepage"><div><div><h1 class="title"><a name="index"></a>The Bugzilla Guide - 4.4 
+    Release</h1></div><div><div class="authorgroup"><h3 class="corpauthor">The Bugzilla Team</h3></div></div><div><p class="pubdate">2013-05-22</p></div><div><div class="abstract" title="Abstract"><p class="title"><b>Abstract</b></p><p>
+             This is the documentation for Bugzilla, a 
+             bug-tracking system from mozilla.org.
+             Bugzilla is an enterprise-class piece of software
+             that tracks millions of bugs and issues for hundreds of
+             organizations around the world.
+      </p><p>
+        The most current version of this document can always be found on the
+        <a class="ulink" href="http://www.bugzilla.org/docs/" target="_top">Bugzilla 
+        Documentation Page</a>.
+      </p></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="chapter"><a href="about.html">1. About This Guide</a></span></dt><dd><dl><dt><span class="section"><a href="copyright.html">1.1. Copyright Information</a></span></dt><dt><span class="section"><a href="disclaimer.html">1.2. Disclaimer</a></span></dt><dt><span class="section"><a href="newversions.html">1.3. New Versions</a></span></dt><dt><span class="section"><a href="credits.html">1.4. Credits</a></span></dt><dt><span class="section"><a href="conventions.html">1.5. Document Conventions</a></span></dt></dl></dd><dt><span class="chapter"><a href="installing-bugzilla.html">2. Installing Bugzilla</a></span></dt><dd><dl><dt><span class="section"><a href="installation.html">2.1. Installation</a></span></dt><dd><dl><dt><span class="section"><a href="installation.html#install-perl">2.1.1. Perl</a></span></dt><dt><span class="section"><a href="installation.html#install-database">2.1.2. Database Engine</a></span></dt><dt><span class="section"><a href="installation.html#install-webserver">2.1.3. Web Server</a></span></dt><dt><span class="section"><a href="installation.html#install-bzfiles">2.1.4. Bugzilla</a></span></dt><dt><span class="section"><a href="installation.html#install-perlmodules">2.1.5. Perl Modules</a></span></dt><dt><span class="section"><a href="installation.html#install-MTA">2.1.6. Mail Transfer Agent (MTA)</a></span></dt><dt><span class="section"><a href="installation.html#using-mod_perl-with-bugzilla">2.1.7. Installing Bugzilla on mod_perl</a></span></dt></dl></dd><dt><span class="section"><a href="configuration.html">2.2. Configuration</a></span></dt><dd><dl><dt><span class="section"><a href="configuration.html#localconfig">2.2.1. localconfig</a></span></dt><dt><span class="section"><a href="configuration.html#database-engine">2.2.2. Database Server</a></span></dt><dt><span class="section"><a href="configuration.html#idp6726528">2.2.3. checksetup.pl</a></span></dt><dt><span class="section"><a href="configuration.html#http">2.2.4. Web server</a></span></dt><dt><span class="section"><a href="configuration.html#install-config-bugzilla">2.2.5. Bugzilla</a></span></dt></dl></dd><dt><span class="section"><a href="extraconfig.html">2.3. Optional Additional Configuration</a></span></dt><dd><dl><dt><span class="section"><a href="extraconfig.html#idp11598064">2.3.1. Bug Graphs</a></span></dt><dt><span class="section"><a href="extraconfig.html#installation-whining-cron">2.3.2. The Whining Cron</a></span></dt><dt><span class="section"><a href="extraconfig.html#installation-whining">2.3.3. Whining</a></span></dt><dt><span class="section"><a href="extraconfig.html#apache-addtype">2.3.4. Serving Alternate Formats with the right MIME type</a></span></dt></dl></dd><dt><span class="section"><a href="multiple-bz-dbs.html">2.4. Multiple Bugzilla databases with a single installation</a></span></dt><dt><span class="section"><a href="os-specific.html">2.5. OS-Specific Installation Notes</a></span></dt><dd><dl><dt><span class="section"><a href="os-specific.html#os-win32">2.5.1. Microsoft Windows</a></span></dt><dt><span class="section"><a href="os-specific.html#os-macosx">2.5.2. <span class="productname">Mac OS X</span>™</a></span></dt><dt><span class="section"><a href="os-specific.html#os-linux">2.5.3. Linux Distributions</a></span></dt></dl></dd><dt><span class="section"><a href="nonroot.html">2.6. UNIX (non-root) Installation Notes</a></span></dt><dd><dl><dt><span class="section"><a href="nonroot.html#idp11695712">2.6.1. Introduction</a></span></dt><dt><span class="section"><a href="nonroot.html#idp11697952">2.6.2. MySQL</a></span></dt><dt><span class="section"><a href="nonroot.html#idp11719632">2.6.3. Perl</a></span></dt><dt><span class="section"><a href="nonroot.html#install-perlmodules-nonroot">2.6.4. Perl Modules</a></span></dt><dt><span class="section"><a href="nonroot.html#idp11734464">2.6.5. HTTP Server</a></span></dt><dt><span class="section"><a href="nonroot.html#idp11741472">2.6.6. Bugzilla</a></span></dt></dl></dd><dt><span class="section"><a href="upgrade.html">2.7. Upgrading to New Releases</a></span></dt><dd><dl><dt><span class="section"><a href="upgrade.html#upgrade-before">2.7.1. Before You Upgrade</a></span></dt><dt><span class="section"><a href="upgrade.html#upgrade-files">2.7.2. Getting The New Bugzilla</a></span></dt><dt><span class="section"><a href="upgrade.html#upgrade-completion">2.7.3. Completing Your Upgrade</a></span></dt><dt><span class="section"><a href="upgrade.html#upgrade-notifications">2.7.4. Automatic Notifications of New Releases</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="administration.html">3. Administering Bugzilla</a></span></dt><dd><dl><dt><span class="section"><a href="parameters.html">3.1. Bugzilla Configuration</a></span></dt><dd><dl><dt><span class="section"><a href="parameters.html#param-requiredsettings">3.1.1. Required Settings</a></span></dt><dt><span class="section"><a href="parameters.html#param-admin-policies">3.1.2. Administrative Policies</a></span></dt><dt><span class="section"><a href="parameters.html#param-user-authentication">3.1.3. User Authentication</a></span></dt><dt><span class="section"><a href="parameters.html#param-attachments">3.1.4. Attachments</a></span></dt><dt><span class="section"><a href="parameters.html#param-bug-change-policies">3.1.5. Bug Change Policies</a></span></dt><dt><span class="section"><a href="parameters.html#param-bugfields">3.1.6. Bug Fields</a></span></dt><dt><span class="section"><a href="parameters.html#param-bugmoving">3.1.7. Bug Moving</a></span></dt><dt><span class="section"><a href="parameters.html#param-dependency-graphs">3.1.8. Dependency Graphs</a></span></dt><dt><span class="section"><a href="parameters.html#param-group-security">3.1.9. Group Security</a></span></dt><dt><span class="section"><a href="parameters.html#bzldap">3.1.10. LDAP Authentication</a></span></dt><dt><span class="section"><a href="parameters.html#bzradius">3.1.11. RADIUS Authentication</a></span></dt><dt><span class="section"><a href="parameters.html#param-email">3.1.12. Email</a></span></dt><dt><span class="section"><a href="parameters.html#param-patchviewer">3.1.13. Patch Viewer</a></span></dt><dt><span class="section"><a href="parameters.html#param-querydefaults">3.1.14. Query Defaults</a></span></dt><dt><span class="section"><a href="parameters.html#param-shadowdatabase">3.1.15. Shadow Database</a></span></dt><dt><span class="section"><a href="parameters.html#admin-usermatching">3.1.16. User Matching</a></span></dt></dl></dd><dt><span class="section"><a href="useradmin.html">3.2. User Administration</a></span></dt><dd><dl><dt><span class="section"><a href="useradmin.html#defaultuser">3.2.1. Creating the Default User</a></span></dt><dt><span class="section"><a href="useradmin.html#manageusers">3.2.2. Managing Other Users</a></span></dt></dl></dd><dt><span class="section"><a href="classifications.html">3.3. Classifications</a></span></dt><dt><span class="section"><a href="products.html">3.4. Products</a></span></dt><dd><dl><dt><span class="section"><a href="products.html#create-product">3.4.1. Creating New Products</a></span></dt><dt><span class="section"><a href="products.html#edit-products">3.4.2. Editing Products</a></span></dt><dt><span class="section"><a href="products.html#comps-vers-miles-products">3.4.3. Adding or Editing Components, Versions and Target Milestones</a></span></dt><dt><span class="section"><a href="products.html#product-group-controls">3.4.4. Assigning Group Controls to Products</a></span></dt></dl></dd><dt><span class="section"><a href="components.html">3.5. Components</a></span></dt><dt><span class="section"><a href="versions.html">3.6. Versions</a></span></dt><dt><span class="section"><a href="milestones.html">3.7. Milestones</a></span></dt><dt><span class="section"><a href="flags-overview.html">3.8. Flags</a></span></dt><dd><dl><dt><span class="section"><a href="flags-overview.html#flags-simpleexample">3.8.1. A Simple Example</a></span></dt><dt><span class="section"><a href="flags-overview.html#flags-about">3.8.2. About Flags</a></span></dt><dt><span class="section"><a href="flags-overview.html#flag-askto">3.8.3. Using flag requests</a></span></dt><dt><span class="section"><a href="flags-overview.html#flag-types">3.8.4. Two Types of Flags</a></span></dt><dt><span class="section"><a href="flags-overview.html#flags-admin">3.8.5. Administering Flags</a></span></dt></dl></dd><dt><span class="section"><a href="keywords.html">3.9. Keywords</a></span></dt><dt><span class="section"><a href="custom-fields.html">3.10. Custom Fields</a></span></dt><dd><dl><dt><span class="section"><a href="custom-fields.html#add-custom-fields">3.10.1. Adding Custom Fields</a></span></dt><dt><span class="section"><a href="custom-fields.html#edit-custom-fields">3.10.2. Editing Custom Fields</a></span></dt><dt><span class="section"><a href="custom-fields.html#delete-custom-fields">3.10.3. Deleting Custom Fields</a></span></dt></dl></dd><dt><span class="section"><a href="edit-values.html">3.11. Legal Values</a></span></dt><dd><dl><dt><span class="section"><a href="edit-values.html#edit-values-list">3.11.1. Viewing/Editing legal values</a></span></dt><dt><span class="section"><a href="edit-values.html#edit-values-delete">3.11.2. Deleting legal values</a></span></dt></dl></dd><dt><span class="section"><a href="bug_status_workflow.html">3.12. Bug Status Workflow</a></span></dt><dt><span class="section"><a href="voting.html">3.13. Voting</a></span></dt><dt><span class="section"><a href="quips.html">3.14. Quips</a></span></dt><dt><span class="section"><a href="groups.html">3.15. Groups and Group Security</a></span></dt><dd><dl><dt><span class="section"><a href="groups.html#create-groups">3.15.1. Creating Groups</a></span></dt><dt><span class="section"><a href="groups.html#edit-groups">3.15.2. Editing Groups and Assigning Group Permissions</a></span></dt><dt><span class="section"><a href="groups.html#users-and-groups">3.15.3. Assigning Users to Groups</a></span></dt><dt><span class="section"><a href="groups.html#idp14405664">3.15.4. Assigning Group Controls to Products</a></span></dt></dl></dd><dt><span class="section"><a href="sanitycheck.html">3.16. Checking and Maintaining Database Integrity</a></span></dt></dl></dd><dt><span class="chapter"><a href="security.html">4. Bugzilla Security</a></span></dt><dd><dl><dt><span class="section"><a href="security-os.html">4.1. Operating System</a></span></dt><dd><dl><dt><span class="section"><a href="security-os.html#security-os-ports">4.1.1. TCP/IP Ports</a></span></dt><dt><span class="section"><a href="security-os.html#security-os-accounts">4.1.2. System User Accounts</a></span></dt><dt><span class="section"><a href="security-os.html#security-os-chroot">4.1.3. The <code class="filename">chroot</code> Jail</a></span></dt></dl></dd><dt><span class="section"><a href="security-webserver.html">4.2. Web server</a></span></dt><dd><dl><dt><span class="section"><a href="security-webserver.html#security-webserver-access">4.2.1. Disabling Remote Access to Bugzilla Configuration Files</a></span></dt></dl></dd><dt><span class="section"><a href="security-bugzilla.html">4.3. Bugzilla</a></span></dt><dd><dl><dt><span class="section"><a href="security-bugzilla.html#security-bugzilla-charset">4.3.1. Prevent users injecting malicious Javascript</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="using.html">5. Using Bugzilla</a></span></dt><dd><dl><dt><span class="section"><a href="using-intro.html">5.1. Introduction</a></span></dt><dt><span class="section"><a href="myaccount.html">5.2. Create a Bugzilla Account</a></span></dt><dt><span class="section"><a href="bug_page.html">5.3. Anatomy of a Bug</a></span></dt><dt><span class="section"><a href="lifecycle.html">5.4. Life Cycle of a Bug</a></span></dt><dt><span class="section"><a href="query.html">5.5. Searching for Bugs</a></span></dt><dd><dl><dt><span class="section"><a href="query.html#boolean">5.5.1. Boolean Charts</a></span></dt><dt><span class="section"><a href="query.html#quicksearch">5.5.2. Quicksearch</a></span></dt><dt><span class="section"><a href="query.html#casesensitivity">5.5.3. Case Sensitivity in Searches</a></span></dt><dt><span class="section"><a href="query.html#list">5.5.4. Bug Lists</a></span></dt><dt><span class="section"><a href="query.html#individual-buglists">5.5.5. Adding/removing tags to/from bugs</a></span></dt></dl></dd><dt><span class="section"><a href="bugreports.html">5.6. Filing Bugs</a></span></dt><dd><dl><dt><span class="section"><a href="bugreports.html#fillingbugs">5.6.1. Reporting a New Bug</a></span></dt><dt><span class="section"><a href="bugreports.html#cloningbugs">5.6.2. Clone an Existing Bug</a></span></dt></dl></dd><dt><span class="section"><a href="attachments.html">5.7. Attachments</a></span></dt><dd><dl><dt><span class="section"><a href="attachments.html#patchviewer">5.7.1. Patch Viewer</a></span></dt></dl></dd><dt><span class="section"><a href="hintsandtips.html">5.8. Hints and Tips</a></span></dt><dd><dl><dt><span class="section"><a href="hintsandtips.html#idp13714560">5.8.1. Autolinkification</a></span></dt><dt><span class="section"><a href="hintsandtips.html#commenting">5.8.2. Comments</a></span></dt><dt><span class="section"><a href="hintsandtips.html#comment-wrapping">5.8.3. Server-Side Comment Wrapping</a></span></dt><dt><span class="section"><a href="hintsandtips.html#dependencytree">5.8.4. Dependency Tree</a></span></dt></dl></dd><dt><span class="section"><a href="timetracking.html">5.9. Time Tracking Information</a></span></dt><dt><span class="section"><a href="userpreferences.html">5.10. User Preferences</a></span></dt><dd><dl><dt><span class="section"><a href="userpreferences.html#generalpreferences">5.10.1. General Preferences</a></span></dt><dt><span class="section"><a href="userpreferences.html#emailpreferences">5.10.2. Email Preferences</a></span></dt><dt><span class="section"><a href="userpreferences.html#savedsearches">5.10.3. Saved Searches</a></span></dt><dt><span class="section"><a href="userpreferences.html#accountpreferences">5.10.4. Name and Password</a></span></dt><dt><span class="section"><a href="userpreferences.html#permissionsettings">5.10.5. Permissions</a></span></dt></dl></dd><dt><span class="section"><a href="reporting.html">5.11. Reports and Charts</a></span></dt><dd><dl><dt><span class="section"><a href="reporting.html#reports">5.11.1. Reports</a></span></dt><dt><span class="section"><a href="reporting.html#charts">5.11.2. Charts</a></span></dt></dl></dd><dt><span class="section"><a href="flags.html">5.12. Flags</a></span></dt><dt><span class="section"><a href="whining.html">5.13. Whining</a></span></dt><dd><dl><dt><span class="section"><a href="whining.html#whining-overview">5.13.1. The Event</a></span></dt><dt><span class="section"><a href="whining.html#whining-schedule">5.13.2. Whining Schedule</a></span></dt><dt><span class="section"><a href="whining.html#whining-query">5.13.3. Whining Searches</a></span></dt><dt><span class="section"><a href="whining.html#idp7758112">5.13.4. Saving Your Changes</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="customization.html">6. Customizing Bugzilla</a></span></dt><dd><dl><dt><span class="section"><a href="extensions.html">6.1. Bugzilla Extensions</a></span></dt><dt><span class="section"><a href="cust-skins.html">6.2. Custom Skins</a></span></dt><dt><span class="section"><a href="cust-templates.html">6.3. Template Customization</a></span></dt><dd><dl><dt><span class="section"><a href="cust-templates.html#template-directory">6.3.1. Template Directory Structure</a></span></dt><dt><span class="section"><a href="cust-templates.html#template-method">6.3.2. Choosing a Customization Method</a></span></dt><dt><span class="section"><a href="cust-templates.html#template-edit">6.3.3. How To Edit Templates</a></span></dt><dt><span class="section"><a href="cust-templates.html#template-formats">6.3.4. Template Formats and Types</a></span></dt><dt><span class="section"><a href="cust-templates.html#template-specific">6.3.5. Particular Templates</a></span></dt><dt><span class="section"><a href="cust-templates.html#template-http-accept">6.3.6. Configuring Bugzilla to Detect the User's Language</a></span></dt></dl></dd><dt><span class="section"><a href="cust-change-permissions.html">6.4. Customizing Who Can Change What</a></span></dt><dt><span class="section"><a href="integration.html">6.5. Integrating Bugzilla with Third-Party Tools</a></span></dt></dl></dd><dt><span class="appendix"><a href="troubleshooting.html">A. Troubleshooting</a></span></dt><dd><dl><dt><span class="section"><a href="general-advice.html">A.1. General Advice</a></span></dt><dt><span class="section"><a href="trbl-testserver.html">A.2. The Apache web server is not serving Bugzilla pages</a></span></dt><dt><span class="section"><a href="trbl-perlmodule.html">A.3. I installed a Perl module, but 
+      <code class="filename">checksetup.pl</code> claims it's not installed!</a></span></dt><dt><span class="section"><a href="trbl-dbdSponge.html">A.4. DBD::Sponge::db prepare failed</a></span></dt><dt><span class="section"><a href="paranoid-security.html">A.5. cannot chdir(/var/spool/mqueue)</a></span></dt><dt><span class="section"><a href="trbl-relogin-everyone.html">A.6. Everybody is constantly being forced to relogin</a></span></dt><dt><span class="section"><a href="trbl-index.html">A.7. <code class="filename">index.cgi</code> doesn't show up unless specified in the URL</a></span></dt><dt><span class="section"><a href="trbl-passwd-encryption.html">A.8. 
+      checksetup.pl reports "Client does not support authentication protocol
+      requested by server..."
+    </a></span></dt></dl></dd><dt><span class="appendix"><a href="patches.html">B. Contrib</a></span></dt><dd><dl><dt><span class="section"><a href="cmdline.html">B.1. Command-line Search Interface</a></span></dt><dt><span class="section"><a href="cmdline-bugmail.html">B.2. Command-line 'Send Unsent Bug-mail' tool</a></span></dt></dl></dd><dt><span class="appendix"><a href="install-perlmodules-manual.html">C. Manual Installation of Perl Modules</a></span></dt><dd><dl><dt><span class="section"><a href="modules-manual-instructions.html">C.1. Instructions</a></span></dt><dt><span class="section"><a href="modules-manual-download.html">C.2. Download Locations</a></span></dt><dt><span class="section"><a href="modules-manual-optional.html">C.3. Optional Modules</a></span></dt></dl></dd><dt><span class="appendix"><a href="gfdl.html">D. GNU Free Documentation License</a></span></dt><dd><dl><dt><span class="section"><a href="gfdl-0.html">D.0. Preamble</a></span></dt><dt><span class="section"><a href="gfdl-1.html">D.1. Applicability and Definition</a></span></dt><dt><span class="section"><a href="gfdl-2.html">D.2. Verbatim Copying</a></span></dt><dt><span class="section"><a href="gfdl-3.html">D.3. Copying in Quantity</a></span></dt><dt><span class="section"><a href="gfdl-4.html">D.4. Modifications</a></span></dt><dt><span class="section"><a href="gfdl-5.html">D.5. Combining Documents</a></span></dt><dt><span class="section"><a href="gfdl-6.html">D.6. Collections of Documents</a></span></dt><dt><span class="section"><a href="gfdl-7.html">D.7. Aggregation with Independent Works</a></span></dt><dt><span class="section"><a href="gfdl-8.html">D.8. Translation</a></span></dt><dt><span class="section"><a href="gfdl-9.html">D.9. Termination</a></span></dt><dt><span class="section"><a href="gfdl-10.html">D.10. Future Revisions of this License</a></span></dt><dt><span class="section"><a href="gfdl-howto.html">D.. How to use this License for your documents</a></span></dt></dl></dd><dt><span class="glossary"><a href="glossary.html">Glossary</a></span></dt></dl></div><div class="list-of-figures"><p><b>List of Figures</b></p><dl><dt>5.1. <a href="lifecycle.html#lifecycle-image">Lifecycle of a Bugzilla Bug</a></dt></dl></div><div class="list-of-examples"><p><b>List of Examples</b></p><dl><dt>A.1. <a href="trbl-relogin-everyone.html#trbl-relogin-everyone-share">Examples of urlbase/cookiepath pairs for sharing login cookies</a></dt><dt>A.2. <a href="trbl-relogin-everyone.html#trbl-relogin-everyone-restrict">Examples of urlbase/cookiepath pairs to restrict the login cookie</a></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="about.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"> </td><td width="40%" align="right" valign="top"> Chapter 1. About This Guide</td></tr></table></div></body></html>

diff --git a/docs/en/html/install-perlmodules-manual.html b/docs/en/html/install-perlmodules-manual.html
new file mode 100644 (file)
index 0000000..d32815f
--- /dev/null
+++ b/docs/en/html/install-perlmodules-manual.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Appendix C. Manual Installation of Perl Modules</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="prev" href="cmdline-bugmail.html" title="B.2. Command-line 'Send Unsent Bug-mail' tool"><link rel="next" href="modules-manual-instructions.html" title="C.1. Instructions"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix C. Manual Installation of Perl Modules</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="cmdline-bugmail.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="modules-manual-instructions.html">Next</a></td></tr></table><hr></div><div class="appendix" title="Appendix C. Manual Installation of Perl Modules"><div class="titlepage"><div><div><h2 class="title"><a name="install-perlmodules-manual"></a>Appendix C. Manual Installation of Perl Modules</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="modules-manual-instructions.html">C.1. Instructions</a></span></dt><dt><span class="section"><a href="modules-manual-download.html">C.2. Download Locations</a></span></dt><dt><span class="section"><a href="modules-manual-optional.html">C.3. Optional Modules</a></span></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="cmdline-bugmail.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="modules-manual-instructions.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">B.2. Command-line 'Send Unsent Bug-mail' tool </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> C.1. Instructions</td></tr></table></div></body></html>

diff --git a/docs/en/html/installation.html b/docs/en/html/installation.html
new file mode 100644 (file)
index 0000000..fe37c80
--- /dev/null
+++ b/docs/en/html/installation.html
@@ -0,0 +1,273 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>2.1. Installation</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="installing-bugzilla.html" title="Chapter 2. Installing Bugzilla"><link rel="prev" href="installing-bugzilla.html" title="Chapter 2. Installing Bugzilla"><link rel="next" href="configuration.html" title="2.2. Configuration"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.1. Installation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="installing-bugzilla.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Installing Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="configuration.html">Next</a></td></tr></table><hr></div><div class="section" title="2.1. Installation"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="installation"></a>2.1. Installation</h2></div></div></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>If you just want to <span class="emphasis"><em>use</em></span> Bugzilla, 
+      you do not need to install it. None of this chapter is relevant to
+      you. Ask your Bugzilla administrator for the URL to access it from
+      your web browser.
+      </p></td></tr></table></div><p>The Bugzilla server software is usually installed on Linux or 
+    Solaris. 
+    If you are installing on another OS, check <a class="xref" href="os-specific.html" title="2.5. OS-Specific Installation Notes">Section 2.5, “OS-Specific Installation Notes”</a>
+    before you start your installation to see if there are any special
+    instructions.
+    </p><p>This guide assumes that you have administrative access to the
+    Bugzilla machine. It not possible to
+    install and run Bugzilla itself without administrative access except
+    in the very unlikely event that every single prerequisite is
+    already installed.
+    </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>The installation process may make your machine insecure for
+      short periods of time. Make sure there is a firewall between you
+      and the Internet.
+      </p></td></tr></table></div><p>
+    You are strongly recommended to make a backup of your system
+    before installing Bugzilla (and at regular intervals thereafter :-).
+    </p><p>In outline, the installation proceeds as follows:
+    </p><div class="procedure"><ol class="procedure" type="1"><li class="step" title="Step 1"><p><a class="link" href="installation.html#install-perl" title="2.1.1. Perl">Install Perl</a>
+        (5.8.1 or above)
+        </p></li><li class="step" title="Step 2"><p><a class="link" href="installation.html#install-database" title="2.1.2. Database Engine">Install a Database Engine</a>
+        </p></li><li class="step" title="Step 3"><p><a class="link" href="installation.html#install-webserver" title="2.1.3. Web Server">Install a Webserver</a>
+        </p></li><li class="step" title="Step 4"><p><a class="link" href="installation.html#install-bzfiles" title="2.1.4. Bugzilla">Install Bugzilla</a>
+        </p></li><li class="step" title="Step 5"><p><a class="link" href="installation.html#install-perlmodules" title="2.1.5. Perl Modules">Install Perl modules</a>
+        </p></li><li class="step" title="Step 6"><p>
+          <a class="link" href="installation.html#install-MTA" title="2.1.6. Mail Transfer Agent (MTA)">Install a Mail Transfer Agent</a>
+          (Sendmail 8.7 or above, or an MTA that is Sendmail-compatible with at least this version)
+        </p></li><li class="step" title="Step 7"><p>Configure all of the above.
+        </p></li></ol></div><div class="section" title="2.1.1. Perl"><div class="titlepage"><div><div><h3 class="title"><a name="install-perl"></a>2.1.1. Perl</h3></div></div></div><p>Installed Version Test: </p><pre class="programlisting">perl -v</pre><p>Any machine that doesn't have Perl on it is a sad machine indeed.
+      If you don't have it and your OS doesn't provide official packages, 
+      visit <a class="ulink" href="http://www.perl.org" target="_top">http://www.perl.org</a>.
+      Although Bugzilla runs with Perl 5.8.1,
+      it's a good idea to be using the latest stable version.
+      </p></div><div class="section" title="2.1.2. Database Engine"><div class="titlepage"><div><div><h3 class="title"><a name="install-database"></a>2.1.2. Database Engine</h3></div></div></div><p>
+        Bugzilla supports MySQL, PostgreSQL and Oracle as database servers.
+        You only require one of these systems to make use of Bugzilla.
+      </p><div class="section" title="2.1.2.1. MySQL"><div class="titlepage"><div><div><h4 class="title"><a name="install-mysql"></a>2.1.2.1. MySQL</h4></div></div></div><p>Installed Version Test: </p><pre class="programlisting">mysql -V</pre><p>
+          If you don't have it and your OS doesn't provide official packages, 
+          visit <a class="ulink" href="http://www.mysql.com" target="_top">http://www.mysql.com</a>. You need MySQL version
+          5.0.15 or higher.
+          </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p> Many of the binary
+            versions of MySQL store their data files in 
+            <code class="filename">/var</code>.
+            On some Unix systems, this is part of a smaller root partition,
+            and may not have room for your bug database. To change the data
+            directory, you have to build MySQL from source yourself, and
+            set it as an option to <code class="filename">configure</code>.</p></td></tr></table></div><p>If you install from something other than a packaging/installation
+          system, such as .rpm (RPM Package Manager), .deb (Debian Package), .exe
+          (Windows Executable), or .msi (Windows Installer), make sure the MySQL
+          server is started when the machine boots.
+          </p></div><div class="section" title="2.1.2.2. PostgreSQL"><div class="titlepage"><div><div><h4 class="title"><a name="install-pg"></a>2.1.2.2. PostgreSQL</h4></div></div></div><p>Installed Version Test: </p><pre class="programlisting">psql -V</pre><p>
+          If you don't have it and your OS doesn't provide official packages, 
+          visit <a class="ulink" href="http://www.postgresql.org/" target="_top">http://www.postgresql.org/</a>. You need PostgreSQL
+          version 8.03.0000 or higher.
+          </p><p>If you install from something other than a packaging/installation
+          system, such as .rpm (RPM Package Manager), .deb (Debian Package), .exe
+          (Windows Executable), or .msi (Windows Installer), make sure the
+          PostgreSQL server is started when the machine boots.
+          </p></div><div class="section" title="2.1.2.3. Oracle"><div class="titlepage"><div><div><h4 class="title"><a name="install-oracle"></a>2.1.2.3. Oracle</h4></div></div></div><p>
+          Installed Version Test: </p><pre class="programlisting">select * from v$version</pre><p>
+          (you first have to log in into your DB)
+        </p><p>
+          If you don't have it and your OS doesn't provide official packages,
+          visit <a class="ulink" href="http://www.oracle.com/" target="_top">http://www.oracle.com/</a>. You need Oracle
+          version 10.02.0 or higher.
+        </p><p>
+          If you install from something other than a packaging/installation
+          system, such as .rpm (RPM Package Manager), .deb (Debian Package), .exe
+          (Windows Executable), or .msi (Windows Installer), make sure the
+          Oracle server is started when the machine boots.
+        </p></div></div><div class="section" title="2.1.3. Web Server"><div class="titlepage"><div><div><h3 class="title"><a name="install-webserver"></a>2.1.3. Web Server</h3></div></div></div><p>Installed Version Test: view the default welcome page at
+      http://&lt;your-machine&gt;/</p><p>
+        You have freedom of choice here, pretty much any web server that
+        is capable of running <a class="glossterm" href="glossary.html#gloss-cgi"><em class="glossterm">CGI</em></a>
+        scripts will work.
+        However, we strongly recommend using the Apache web server
+        (either 1.3.x or 2.x), and the installation instructions usually assume
+        you are using it. If you have got Bugzilla working using another web server,
+        please share your experiences with us by filing a bug in
+        <a class="ulink" href="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla;component=Documentation" target="_top">Bugzilla Documentation</a>.
+      </p><p>
+      If you don't have Apache and your OS doesn't provide official packages, 
+      visit <a class="ulink" href="http://httpd.apache.org/" target="_top">http://httpd.apache.org/</a>.
+      </p></div><div class="section" title="2.1.4. Bugzilla"><div class="titlepage"><div><div><h3 class="title"><a name="install-bzfiles"></a>2.1.4. Bugzilla</h3></div></div></div><p>
+        <a class="ulink" href="http://www.bugzilla.org/download/" target="_top">Download a Bugzilla tarball</a>
+        (or <a class="ulink" href="https://wiki.mozilla.org/Bugzilla:Bzr" target="_top">check it out from Bzr</a>)
+        and place it in a suitable directory, accessible by the default web server user
+        (probably <span class="quote">“<span class="quote">apache</span>”</span> or <span class="quote">“<span class="quote">www</span>”</span>). 
+        Good locations are either directly in the web server's document directories or
+        in <code class="filename">/usr/local</code> with a symbolic link to the web server's 
+        document directories or an alias in the web server's configuration.
+      </p><div class="caution" title="Caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>The default Bugzilla distribution is NOT designed to be placed
+        in a <code class="filename">cgi-bin</code> directory. This
+        includes any directory which is configured using the
+        <code class="option">ScriptAlias</code> directive of Apache.
+        </p></td></tr></table></div><p>Once all the files are in a web accessible directory, make that
+      directory writable by your web server's user. This is a temporary step
+      until you run the 
+      <code class="filename">checksetup.pl</code>
+      script, which locks down your installation.</p></div><div class="section" title="2.1.5. Perl Modules"><div class="titlepage"><div><div><h3 class="title"><a name="install-perlmodules"></a>2.1.5. Perl Modules</h3></div></div></div><p>Bugzilla's installation process is based
+      on a script called <code class="filename">checksetup.pl</code>. 
+      The first thing it checks is whether you have appropriate 
+      versions of all the required
+      Perl modules. The aim of this section is to pass this check. 
+      When it passes, proceed to <a class="xref" href="configuration.html" title="2.2. Configuration">Section 2.2, “Configuration”</a>.
+      </p><p>
+      At this point, you need to <code class="filename">su</code> to root. You should
+      remain as root until the end of the install. To check you have the
+      required modules, run:
+      </p><pre class="screen"><code class="prompt">bash#</code> ./checksetup.pl --check-modules</pre><p>
+        <code class="filename">checksetup.pl</code> will print out a list of the
+        required and optional Perl modules, together with the versions
+        (if any) installed on your machine.
+        The list of required modules is reasonably long; however, you 
+        may already have several of them installed.
+      </p><p>
+        The preferred way to install missing Perl modules is to use the package
+        manager provided by your operating system (e.g <span class="quote">“<span class="quote">rpm</span>”</span> or
+        <span class="quote">“<span class="quote">yum</span>”</span> on Linux distros, or <span class="quote">“<span class="quote">ppm</span>”</span> on Windows
+        if using ActivePerl, see <a class="xref" href="os-specific.html#win32-perl-modules" title="2.5.1.2. Perl Modules on Win32">Section 2.5.1.2, “Perl Modules on Win32”</a>).
+        If some Perl modules are still missing or are too old, then we recommend
+        using the <code class="filename">install-module.pl</code> script (doesn't work
+        with ActivePerl on Windows). If for some reason you really need to
+        install the Perl modules manually, see
+        <a class="xref" href="install-perlmodules-manual.html" title="Appendix C. Manual Installation of Perl Modules">Appendix C, <i>Manual Installation of Perl Modules</i></a>. For instance, on Unix,
+        you invoke <code class="filename">install-module.pl</code> as follows:
+      </p><pre class="screen"><code class="prompt">bash#</code> perl install-module.pl &lt;modulename&gt;</pre><div class="tip" title="Tip" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../images/tip.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Many people complain that Perl modules will not install for
+        them. Most times, the error messages complain that they are missing a
+        file in 
+        <span class="quote">“<span class="quote">@INC</span>”</span>.
+        Virtually every time, this error is due to permissions being set too
+        restrictively for you to compile Perl modules or not having the
+        necessary Perl development libraries installed on your system.
+        Consult your local UNIX systems administrator for help solving these
+        permissions issues; if you 
+        <span class="emphasis"><em>are</em></span>
+        the local UNIX sysadmin, please consult the newsgroup/mailing list
+        for further assistance or hire someone to help you out.</p></td></tr></table></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>If you are using a package-based system, and attempting to install the
+        Perl modules from CPAN, you may need to install the "development" packages for
+        MySQL and GD before attempting to install the related Perl modules. The names of
+        these packages will vary depending on the specific distribution you are using,
+        but are often called <code class="filename">&lt;packagename&gt;-devel</code>.</p></td></tr></table></div><p>
+        Here is a complete list of modules and their minimum versions.
+        Some modules have special installation notes, which follow.
+      </p><p>Required Perl modules:
+      </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+            CGI (3.51)
+          </p></li><li class="listitem"><p>
+            Date::Format (2.23)
+          </p></li><li class="listitem"><p>
+            DateTime (0.28)
+          </p></li><li class="listitem"><p>
+            DateTime::TimeZone (0.71)
+          </p></li><li class="listitem"><p>
+            DBI (1.54)
+          </p></li><li class="listitem"><p>
+            DBD::mysql (4.001) if using MySQL
+          </p></li><li class="listitem"><p>
+            DBD::Pg (2.7.0) if using PostgreSQL
+          </p></li><li class="listitem"><p>
+            DBD::Oracle (1.19) if using Oracle
+          </p></li><li class="listitem"><p>
+            Digest::SHA (any)
+          </p></li><li class="listitem"><p>
+            Email::Send (2.04)
+          </p></li><li class="listitem"><p>
+            Email::MIME (1.904)
+          </p></li><li class="listitem"><p>
+            Template (2.22)
+          </p></li><li class="listitem"><p>
+            URI (1.37)
+          </p></li></ol></div><p>
+
+      Optional Perl modules:
+      </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+            GD (1.20) for bug charting
+          </p></li><li class="listitem"><p>
+            Template::Plugin::GD::Image
+            (any) for Graphical Reports
+          </p></li><li class="listitem"><p>
+            Chart::Lines (2.1) for bug charting
+          </p></li><li class="listitem"><p>
+            GD::Graph (any) for bug charting
+          </p></li><li class="listitem"><p>
+            GD::Text (any) for bug charting
+          </p></li><li class="listitem"><p>
+            XML::Twig (any) for bug import/export
+          </p></li><li class="listitem"><p>
+            MIME::Parser (5.406) for bug import/export
+          </p></li><li class="listitem"><p>
+            LWP::UserAgent
+            (any) for Automatic Update Notifications
+          </p></li><li class="listitem"><p>
+            PatchReader (0.9.6) for pretty HTML view of patches
+          </p></li><li class="listitem"><p>
+            Net::LDAP
+            (any) for LDAP Authentication
+          </p></li><li class="listitem"><p>
+            Authen::SASL
+            (any) for SASL Authentication
+          </p></li><li class="listitem"><p>
+            Authen::Radius
+            (any) for RADIUS Authentication
+          </p></li><li class="listitem"><p>
+            SOAP::Lite (0.712) for the web service interface
+          </p></li><li class="listitem"><p>
+            JSON::RPC
+            (any) for the JSON-RPC interface
+          </p></li><li class="listitem"><p>
+            Test::Taint
+            (any) for the web service interface
+          </p></li><li class="listitem"><p>
+            HTML::Parser
+            (3.40) for More HTML in Product/Group Descriptions
+          </p></li><li class="listitem"><p>
+            HTML::Scrubber
+            (any) for More HTML in Product/Group Descriptions
+          </p></li><li class="listitem"><p>
+            Email::Reply
+            (any) for Inbound Email
+          </p></li><li class="listitem"><p>
+            TheSchwartz
+            (any) for Mail Queueing
+          </p></li><li class="listitem"><p>
+            Daemon::Generic
+            (any) for Mail Queueing
+          </p></li><li class="listitem"><p>
+            mod_perl2
+            (1.999022) for mod_perl
+          </p></li></ol></div><p>
+      </p></div><div class="section" title="2.1.6. Mail Transfer Agent (MTA)"><div class="titlepage"><div><div><h3 class="title"><a name="install-MTA"></a>2.1.6. Mail Transfer Agent (MTA)</h3></div></div></div><p>
+        Bugzilla is dependent on the availability of an e-mail system for its 
+        user authentication and for other tasks.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          This is not entirely true.  It is possible to completely disable 
+          email sending, or to have Bugzilla store email messages in a 
+          file instead of sending them.  However, this is mainly intended 
+          for testing, as disabling or diverting email on a production 
+          machine would mean that users could miss important events (such 
+          as bug changes or the creation of new accounts).
+        </p><p>
+          For more information, see the <span class="quote">“<span class="quote">mail_delivery_method</span>”</span> parameter
+          in <a class="xref" href="parameters.html" title="3.1. Bugzilla Configuration">Section 3.1, “Bugzilla Configuration”</a>.
+        </p></td></tr></table></div><p>
+        On Linux, any Sendmail-compatible MTA (Mail Transfer Agent) will 
+        suffice.  Sendmail, Postfix, qmail and Exim are examples of common 
+        MTAs. Sendmail is the original Unix MTA, but the others are easier to 
+        configure, and therefore many people replace Sendmail with Postfix or 
+        Exim. They are drop-in replacements, so Bugzilla will not 
+        distinguish between them.
+      </p><p>
+        If you are using Sendmail, version 8.7 or higher is required.
+        If you are using a Sendmail-compatible MTA, it must be congruent with 
+        at least version 8.7 of Sendmail.
+      </p><p>
+        Consult the manual for the specific MTA you choose for detailed 
+        installation instructions. Each of these programs will have their own 
+        configuration files where you must configure certain parameters to 
+        ensure that the mail is delivered properly. They are implemented 
+        as services, and you should ensure that the MTA is in the auto-start 
+        list of services for the machine.
+      </p><p>
+        If a simple mail sent with the command-line 'mail' program 
+        succeeds, then Bugzilla should also be fine.
+      </p></div><div class="section" title="2.1.7. Installing Bugzilla on mod_perl"><div class="titlepage"><div><div><h3 class="title"><a name="using-mod_perl-with-bugzilla"></a>2.1.7. Installing Bugzilla on mod_perl</h3></div></div></div><p>It is now possible to run the Bugzilla software under <code class="literal">mod_perl</code> on
+      Apache. <code class="literal">mod_perl</code> has some additional requirements to that of running
+      Bugzilla under <code class="literal">mod_cgi</code> (the standard and previous way).</p><p>Bugzilla requires <code class="literal">mod_perl</code> to be installed, which can be
+      obtained from <a class="ulink" href="http://perl.apache.org" target="_top">http://perl.apache.org</a> - Bugzilla requires
+      version 1.999022 (AKA 2.0.0-RC5) to be installed.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="installing-bugzilla.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="installing-bugzilla.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="configuration.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 2. Installing Bugzilla </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 2.2. Configuration</td></tr></table></div></body></html>

diff --git a/docs/en/html/installing-bugzilla.html b/docs/en/html/installing-bugzilla.html
new file mode 100644 (file)
index 0000000..9d3155a
--- /dev/null
+++ b/docs/en/html/installing-bugzilla.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 2. Installing Bugzilla</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="prev" href="conventions.html" title="1.5. Document Conventions"><link rel="next" href="installation.html" title="2.1. Installation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 2. Installing Bugzilla</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="conventions.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="installation.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 2. Installing Bugzilla"><div class="titlepage"><div><div><h2 class="title"><a name="installing-bugzilla"></a>Chapter 2. Installing Bugzilla</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="installation.html">2.1. Installation</a></span></dt><dd><dl><dt><span class="section"><a href="installation.html#install-perl">2.1.1. Perl</a></span></dt><dt><span class="section"><a href="installation.html#install-database">2.1.2. Database Engine</a></span></dt><dt><span class="section"><a href="installation.html#install-webserver">2.1.3. Web Server</a></span></dt><dt><span class="section"><a href="installation.html#install-bzfiles">2.1.4. Bugzilla</a></span></dt><dt><span class="section"><a href="installation.html#install-perlmodules">2.1.5. Perl Modules</a></span></dt><dt><span class="section"><a href="installation.html#install-MTA">2.1.6. Mail Transfer Agent (MTA)</a></span></dt><dt><span class="section"><a href="installation.html#using-mod_perl-with-bugzilla">2.1.7. Installing Bugzilla on mod_perl</a></span></dt></dl></dd><dt><span class="section"><a href="configuration.html">2.2. Configuration</a></span></dt><dd><dl><dt><span class="section"><a href="configuration.html#localconfig">2.2.1. localconfig</a></span></dt><dt><span class="section"><a href="configuration.html#database-engine">2.2.2. Database Server</a></span></dt><dt><span class="section"><a href="configuration.html#idp6726528">2.2.3. checksetup.pl</a></span></dt><dt><span class="section"><a href="configuration.html#http">2.2.4. Web server</a></span></dt><dt><span class="section"><a href="configuration.html#install-config-bugzilla">2.2.5. Bugzilla</a></span></dt></dl></dd><dt><span class="section"><a href="extraconfig.html">2.3. Optional Additional Configuration</a></span></dt><dd><dl><dt><span class="section"><a href="extraconfig.html#idp11598064">2.3.1. Bug Graphs</a></span></dt><dt><span class="section"><a href="extraconfig.html#installation-whining-cron">2.3.2. The Whining Cron</a></span></dt><dt><span class="section"><a href="extraconfig.html#installation-whining">2.3.3. Whining</a></span></dt><dt><span class="section"><a href="extraconfig.html#apache-addtype">2.3.4. Serving Alternate Formats with the right MIME type</a></span></dt></dl></dd><dt><span class="section"><a href="multiple-bz-dbs.html">2.4. Multiple Bugzilla databases with a single installation</a></span></dt><dt><span class="section"><a href="os-specific.html">2.5. OS-Specific Installation Notes</a></span></dt><dd><dl><dt><span class="section"><a href="os-specific.html#os-win32">2.5.1. Microsoft Windows</a></span></dt><dt><span class="section"><a href="os-specific.html#os-macosx">2.5.2. <span class="productname">Mac OS X</span>™</a></span></dt><dt><span class="section"><a href="os-specific.html#os-linux">2.5.3. Linux Distributions</a></span></dt></dl></dd><dt><span class="section"><a href="nonroot.html">2.6. UNIX (non-root) Installation Notes</a></span></dt><dd><dl><dt><span class="section"><a href="nonroot.html#idp11695712">2.6.1. Introduction</a></span></dt><dt><span class="section"><a href="nonroot.html#idp11697952">2.6.2. MySQL</a></span></dt><dt><span class="section"><a href="nonroot.html#idp11719632">2.6.3. Perl</a></span></dt><dt><span class="section"><a href="nonroot.html#install-perlmodules-nonroot">2.6.4. Perl Modules</a></span></dt><dt><span class="section"><a href="nonroot.html#idp11734464">2.6.5. HTTP Server</a></span></dt><dt><span class="section"><a href="nonroot.html#idp11741472">2.6.6. Bugzilla</a></span></dt></dl></dd><dt><span class="section"><a href="upgrade.html">2.7. Upgrading to New Releases</a></span></dt><dd><dl><dt><span class="section"><a href="upgrade.html#upgrade-before">2.7.1. Before You Upgrade</a></span></dt><dt><span class="section"><a href="upgrade.html#upgrade-files">2.7.2. Getting The New Bugzilla</a></span></dt><dt><span class="section"><a href="upgrade.html#upgrade-completion">2.7.3. Completing Your Upgrade</a></span></dt><dt><span class="section"><a href="upgrade.html#upgrade-notifications">2.7.4. Automatic Notifications of New Releases</a></span></dt></dl></dd></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="conventions.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="installation.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">1.5. Document Conventions </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 2.1. Installation</td></tr></table></div></body></html>

diff --git a/docs/en/html/integration.html b/docs/en/html/integration.html
new file mode 100644 (file)
index 0000000..53c8e01
--- /dev/null
+++ b/docs/en/html/integration.html
@@ -0,0 +1,8 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>6.5. Integrating Bugzilla with Third-Party Tools</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="customization.html" title="Chapter 6. Customizing Bugzilla"><link rel="prev" href="cust-change-permissions.html" title="6.4. Customizing Who Can Change What"><link rel="next" href="troubleshooting.html" title="Appendix A. Troubleshooting"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">6.5. Integrating Bugzilla with Third-Party Tools</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="cust-change-permissions.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Customizing Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="troubleshooting.html">Next</a></td></tr></table><hr></div><div class="section" title="6.5. Integrating Bugzilla with Third-Party Tools"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="integration"></a>6.5. Integrating Bugzilla with Third-Party Tools</h2></div></div></div><p>
+      Many utilities and applications can integrate with Bugzilla,
+      either on the client- or server-side. None of them are maintained
+      by the Bugzilla community, nor are they tested during our
+      QA tests, so use them at your own risk. They are listed at
+      <a class="ulink" href="https://wiki.mozilla.org/Bugzilla:Addons" target="_top">https://wiki.mozilla.org/Bugzilla:Addons</a>.
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="cust-change-permissions.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="customization.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="troubleshooting.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">6.4. Customizing Who Can Change What </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Appendix A. Troubleshooting</td></tr></table></div></body></html>

diff --git a/docs/en/html/keywords.html b/docs/en/html/keywords.html
new file mode 100644 (file)
index 0000000..922f3c5
--- /dev/null
+++ b/docs/en/html/keywords.html
@@ -0,0 +1,18 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.9. Keywords</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="flags-overview.html" title="3.8. Flags"><link rel="next" href="custom-fields.html" title="3.10. Custom Fields"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.9. Keywords</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="flags-overview.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="custom-fields.html">Next</a></td></tr></table><hr></div><div class="section" title="3.9. Keywords"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="keywords"></a>3.9. Keywords</h2></div></div></div><p>
+    The administrator can define keywords which can be used to tag and
+    categorise bugs. For example, the keyword "regression" is commonly used.
+    A company might have a policy stating all regressions
+    must be fixed by the next release - this keyword can make tracking those
+    bugs much easier.
+    </p><p>
+    Keywords are global, rather than per-product. If the administrator changes
+    a keyword currently applied to any bugs, the keyword cache must be rebuilt
+    using the <a class="xref" href="sanitycheck.html" title="3.16. Checking and Maintaining Database Integrity">Section 3.16, “Checking and Maintaining Database Integrity”</a> script. Currently keywords cannot
+    be marked obsolete to prevent future usage.
+    </p><p>
+    Keywords can be created, edited or deleted by clicking the "Keywords"
+    link in the admin page. There are two fields for each keyword - the keyword
+    itself and a brief description. Once created, keywords can be selected
+    and applied to individual bugs in that bug's "Details" section.
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="flags-overview.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="administration.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="custom-fields.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.8. Flags </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.10. Custom Fields</td></tr></table></div></body></html>

diff --git a/docs/en/html/lifecycle.html b/docs/en/html/lifecycle.html
new file mode 100644 (file)
index 0000000..829ada8
--- /dev/null
+++ b/docs/en/html/lifecycle.html
@@ -0,0 +1,11 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>5.4. Life Cycle of a Bug</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="prev" href="bug_page.html" title="5.3. Anatomy of a Bug"><link rel="next" href="query.html" title="5.5. Searching for Bugs"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.4. Life Cycle of a Bug</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="bug_page.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Using Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="query.html">Next</a></td></tr></table><hr></div><div class="section" title="5.4. Life Cycle of a Bug"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="lifecycle"></a>5.4. Life Cycle of a Bug</h2></div></div></div><p>
+      The life cycle of a bug, also known as workflow, is customizable to match
+      the needs of your organization, see <a class="xref" href="bug_status_workflow.html" title="3.12. Bug Status Workflow">Section 3.12, “Bug Status Workflow”</a>.
+      <a class="xref" href="lifecycle.html#lifecycle-image" title="Figure 5.1. Lifecycle of a Bugzilla Bug">Figure 5.1, “Lifecycle of a Bugzilla Bug”</a> contains a graphical representation of
+      the default workflow using the default bug statuses. If you wish to
+      customize this image for your site, the
+      <a class="ulink" href="../images/bzLifecycle.xml" target="_top">diagram file</a>
+      is available in <a class="ulink" href="http://www.gnome.org/projects/dia" target="_top">Dia's</a>
+      native XML format.
+    </p><div class="figure"><a name="lifecycle-image"></a><p class="title"><b>Figure 5.1. Lifecycle of a Bugzilla Bug</b></p><div class="figure-contents"><div class="mediaobject"><img src="../images/bzLifecycle.png" alt="Lifecycle of a Bugzilla Bug"></div></div></div><br class="figure-break"></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="bug_page.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="using.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="query.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5.3. Anatomy of a Bug </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 5.5. Searching for Bugs</td></tr></table></div></body></html>

diff --git a/docs/en/html/milestones.html b/docs/en/html/milestones.html
new file mode 100644 (file)
index 0000000..87b4e15
--- /dev/null
+++ b/docs/en/html/milestones.html
@@ -0,0 +1,12 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.7. Milestones</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="versions.html" title="3.6. Versions"><link rel="next" href="flags-overview.html" title="3.8. Flags"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.7. Milestones</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="versions.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="flags-overview.html">Next</a></td></tr></table><hr></div><div class="section" title="3.7. Milestones"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="milestones"></a>3.7. Milestones</h2></div></div></div><p>Milestones are "targets" that you plan to get a bug fixed by. For
+    example, you have a bug that you plan to fix for your 3.0 release, it
+    would be assigned the milestone of 3.0.</p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Milestone options will only appear for a Product if you turned
+      on the "usetargetmilestone" parameter in the "Bug Fields" tab of the
+      "Parameters" page.
+      </p></td></tr></table></div><p>To create new Milestones, and set Default Milestones:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Select "Edit milestones" from the "Edit product" page.</p></li><li class="listitem"><p>Select "Add" in the bottom right corner.</p></li><li class="listitem"><p>Enter the name of the Milestone in the "Milestone" field. You
+        can optionally set the "sortkey", which is a positive or negative
+        number (-32768 to 32767) that defines where in the list this particular
+        milestone appears. This is because milestones often do not 
+        occur in alphanumeric order For example, "Future" might be
+        after "Release 1.2". Select "Add".</p></li></ol></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="versions.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="administration.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="flags-overview.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.6. Versions </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.8. Flags</td></tr></table></div></body></html>

diff --git a/docs/en/html/modules-manual-download.html b/docs/en/html/modules-manual-download.html
new file mode 100644 (file)
index 0000000..c9459e1
--- /dev/null
+++ b/docs/en/html/modules-manual-download.html
@@ -0,0 +1,67 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>C.2. Download Locations</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="install-perlmodules-manual.html" title="Appendix C. Manual Installation of Perl Modules"><link rel="prev" href="modules-manual-instructions.html" title="C.1. Instructions"><link rel="next" href="modules-manual-optional.html" title="C.3. Optional Modules"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">C.2. Download Locations</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="modules-manual-instructions.html">Prev</a> </td><th width="60%" align="center">Appendix C. Manual Installation of Perl Modules</th><td width="20%" align="right"> <a accesskey="n" href="modules-manual-optional.html">Next</a></td></tr></table><hr></div><div class="section" title="C.2. Download Locations"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="modules-manual-download"></a>C.2. Download Locations</h2></div></div></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        Running Bugzilla on Windows requires the use of ActiveState
+        Perl 5.8.1 or higher. Many modules already exist in the core
+        distribution of ActiveState Perl. If some modules are missing, upgrade
+        ActiveState Perl to at least 5.12; it has all the required modules.
+      </p></td></tr></table></div><p>
+      CGI:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/CGI.pm/" target="_top">http://search.cpan.org/dist/CGI.pm/</a><br>
+        Documentation: <a class="ulink" href="http://perldoc.perl.org/CGI.html" target="_top">http://perldoc.perl.org/CGI.html</a><br>
+      </p></div><p>
+    </p><p>
+      Data-Dumper:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/Data-Dumper/" target="_top">http://search.cpan.org/dist/Data-Dumper/</a><br>
+        Documentation: <a class="ulink" href="http://search.cpan.org/dist/Data-Dumper/Dumper.pm" target="_top">http://search.cpan.org/dist/Data-Dumper/Dumper.pm</a><br>
+      </p></div><p>
+    </p><p>
+      Date::Format (part of TimeDate):
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/TimeDate/" target="_top">http://search.cpan.org/dist/TimeDate/</a><br>
+        Documentation: <a class="ulink" href="http://search.cpan.org/dist/TimeDate/lib/Date/Format.pm" target="_top">http://search.cpan.org/dist/TimeDate/lib/Date/Format.pm</a><br>
+      </p></div><p>
+    </p><p>
+      DBI:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/DBI/" target="_top">http://search.cpan.org/dist/DBI/</a><br>
+        Documentation: <a class="ulink" href="http://dbi.perl.org/docs/" target="_top">http://dbi.perl.org/docs/</a><br>
+      </p></div><p>
+    </p><p>
+      DBD::mysql:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/DBD-mysql/" target="_top">http://search.cpan.org/dist/DBD-mysql/</a><br>
+        Documentation: <a class="ulink" href="http://search.cpan.org/dist/DBD-mysql/lib/DBD/mysql.pm" target="_top">http://search.cpan.org/dist/DBD-mysql/lib/DBD/mysql.pm</a><br>
+      </p></div><p>
+    </p><p>
+      DBD::Pg:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/DBD-Pg/" target="_top">http://search.cpan.org/dist/DBD-Pg/</a><br>
+        Documentation: <a class="ulink" href="http://search.cpan.org/dist/DBD-Pg/Pg.pm" target="_top">http://search.cpan.org/dist/DBD-Pg/Pg.pm</a><br>
+      </p></div><p>
+    </p><p>
+      Template-Toolkit:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/Template-Toolkit/" target="_top">http://search.cpan.org/dist/Template-Toolkit/</a><br>
+        Documentation: <a class="ulink" href="http://www.template-toolkit.org/docs.html" target="_top">http://www.template-toolkit.org/docs.html</a><br>
+      </p></div><p>
+    </p><p>
+      GD:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/GD/" target="_top">http://search.cpan.org/dist/GD/</a><br>
+        Documentation: <a class="ulink" href="http://search.cpan.org/dist/GD/GD.pm" target="_top">http://search.cpan.org/dist/GD/GD.pm</a><br>
+      </p></div><p>
+    </p><p>
+      Template::Plugin::GD:
+      </p><div class="literallayout"><p><br>
+       CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/Template-GD/" target="_top">http://search.cpan.org/dist/Template-GD/</a><br>
+       Documentation: <a class="ulink" href="http://www.template-toolkit.org/docs/aqua/Modules/index.html" target="_top">http://www.template-toolkit.org/docs/aqua/Modules/index.html</a><br>
+      </p></div><p>
+    </p><p>
+      MIME::Parser (part of MIME-tools):
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/MIME-tools/" target="_top">http://search.cpan.org/dist/MIME-tools/</a><br>
+        Documentation: <a class="ulink" href="http://search.cpan.org/dist/MIME-tools/lib/MIME/Parser.pm" target="_top">http://search.cpan.org/dist/MIME-tools/lib/MIME/Parser.pm</a><br>
+      </p></div><p>
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="modules-manual-instructions.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="install-perlmodules-manual.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="modules-manual-optional.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">C.1. Instructions </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> C.3. Optional Modules</td></tr></table></div></body></html>

diff --git a/docs/en/html/modules-manual-instructions.html b/docs/en/html/modules-manual-instructions.html
new file mode 100644 (file)
index 0000000..73e1304
--- /dev/null
+++ b/docs/en/html/modules-manual-instructions.html
@@ -0,0 +1,24 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>C.1. Instructions</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="install-perlmodules-manual.html" title="Appendix C. Manual Installation of Perl Modules"><link rel="prev" href="install-perlmodules-manual.html" title="Appendix C. Manual Installation of Perl Modules"><link rel="next" href="modules-manual-download.html" title="C.2. Download Locations"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">C.1. Instructions</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="install-perlmodules-manual.html">Prev</a> </td><th width="60%" align="center">Appendix C. Manual Installation of Perl Modules</th><td width="20%" align="right"> <a accesskey="n" href="modules-manual-download.html">Next</a></td></tr></table><hr></div><div class="section" title="C.1. Instructions"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="modules-manual-instructions"></a>C.1. Instructions</h2></div></div></div><p>
+      If you need to install Perl modules manually, here's how it's done.
+      Download the module using the link given in the next section, and then
+      apply this magic incantation, as root:
+    </p><p>  
+      </p><pre class="screen"><code class="prompt">bash#</code> tar -xzvf &lt;module&gt;.tar.gz
+<code class="prompt">bash#</code> cd &lt;module&gt;
+<code class="prompt">bash#</code> perl Makefile.PL
+<code class="prompt">bash#</code> make
+<code class="prompt">bash#</code> make test
+<code class="prompt">bash#</code> make install</pre><p>
+    </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        In order to compile source code under Windows you will need to obtain
+        a 'make' utility.  The <span class="command"><strong>nmake</strong></span> utility provided with
+        Microsoft Visual C++ may be used.  As an alternative, there is a
+        utility called <span class="command"><strong>dmake</strong></span> available from CPAN which is
+        written entirely in Perl.
+      </p><p>
+        As described in <a class="xref" href="modules-manual-download.html" title="C.2. Download Locations">Section C.2, “Download Locations”</a>, however, most
+        packages already exist and are available from ActiveState or theory58S.
+        We highly recommend that you install them using the ppm GUI available with
+        ActiveState and to add the theory58S repository to your list of repositories.
+      </p></td></tr></table></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="install-perlmodules-manual.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="install-perlmodules-manual.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="modules-manual-download.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Appendix C. Manual Installation of Perl Modules </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> C.2. Download Locations</td></tr></table></div></body></html>

diff --git a/docs/en/html/modules-manual-optional.html b/docs/en/html/modules-manual-optional.html
new file mode 100644 (file)
index 0000000..3da71ac
--- /dev/null
+++ b/docs/en/html/modules-manual-optional.html
@@ -0,0 +1,32 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>C.3. Optional Modules</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="install-perlmodules-manual.html" title="Appendix C. Manual Installation of Perl Modules"><link rel="prev" href="modules-manual-download.html" title="C.2. Download Locations"><link rel="next" href="gfdl.html" title="Appendix D. GNU Free Documentation License"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">C.3. Optional Modules</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="modules-manual-download.html">Prev</a> </td><th width="60%" align="center">Appendix C. Manual Installation of Perl Modules</th><td width="20%" align="right"> <a accesskey="n" href="gfdl.html">Next</a></td></tr></table><hr></div><div class="section" title="C.3. Optional Modules"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="modules-manual-optional"></a>C.3. Optional Modules</h2></div></div></div><p>
+      Chart::Lines:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/Chart/" target="_top">http://search.cpan.org/dist/Chart/</a><br>
+        Documentation: <a class="ulink" href="http://search.cpan.org/dist/Chart/Chart.pod" target="_top">http://search.cpan.org/dist/Chart/Chart.pod</a><br>
+      </p></div><p>
+    </p><p>
+      GD::Graph:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/GDGraph/" target="_top">http://search.cpan.org/dist/GDGraph/</a><br>
+        Documentation: <a class="ulink" href="http://search.cpan.org/dist/GDGraph/Graph.pm" target="_top">http://search.cpan.org/dist/GDGraph/Graph.pm</a><br>
+      </p></div><p>
+    </p><p>
+      GD::Text::Align (part of GD::Text::Util):
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/GDTextUtil/" target="_top">http://search.cpan.org/dist/GDTextUtil/</a><br>
+        Documentation: <a class="ulink" href="http://search.cpan.org/dist/GDTextUtil/Text/Align.pm" target="_top">http://search.cpan.org/dist/GDTextUtil/Text/Align.pm</a><br>
+      </p></div><p>
+    </p><p>
+      XML::Twig:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/dist/XML-Twig/" target="_top">http://search.cpan.org/dist/XML-Twig/</a><br>
+        Documentation: <a class="ulink" href="http://standards.ieee.org/resources/spasystem/twig/twig_stable.html" target="_top">http://standards.ieee.org/resources/spasystem/twig/twig_stable.html</a><br>
+      </p></div><p>
+    </p><p>
+      PatchReader:
+      </p><div class="literallayout"><p><br>
+        CPAN Download Page: <a class="ulink" href="http://search.cpan.org/author/JKEISER/PatchReader/" target="_top">http://search.cpan.org/author/JKEISER/PatchReader/</a><br>
+        Documentation: <a class="ulink" href="http://www.johnkeiser.com/mozilla/Patch_Viewer.html" target="_top">http://www.johnkeiser.com/mozilla/Patch_Viewer.html</a><br>
+      </p></div><p>
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="modules-manual-download.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="install-perlmodules-manual.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="gfdl.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">C.2. Download Locations </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Appendix D. GNU Free Documentation License</td></tr></table></div></body></html>

diff --git a/docs/en/html/multiple-bz-dbs.html b/docs/en/html/multiple-bz-dbs.html
new file mode 100644 (file)
index 0000000..b49c26f
--- /dev/null
+++ b/docs/en/html/multiple-bz-dbs.html
@@ -0,0 +1,31 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>2.4. Multiple Bugzilla databases with a single installation</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="installing-bugzilla.html" title="Chapter 2. Installing Bugzilla"><link rel="prev" href="extraconfig.html" title="2.3. Optional Additional Configuration"><link rel="next" href="os-specific.html" title="2.5. OS-Specific Installation Notes"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.4. Multiple Bugzilla databases with a single installation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="extraconfig.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Installing Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="os-specific.html">Next</a></td></tr></table><hr></div><div class="section" title="2.4. Multiple Bugzilla databases with a single installation"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="multiple-bz-dbs"></a>2.4. Multiple Bugzilla databases with a single installation</h2></div></div></div><p>The previous instructions referred to a standard installation, with
+      one unique Bugzilla database. However, you may want to host several
+      distinct installations, without having several copies of the code. This is
+      possible by using the PROJECT environment variable. When accessed,
+      Bugzilla checks for the existence of this variable, and if present, uses
+      its value to check for an alternative configuration file named
+      <code class="filename">localconfig.&lt;PROJECT&gt;</code> in the same location as
+      the default one (<code class="filename">localconfig</code>). It also checks for
+      customized templates in a directory named
+      <code class="filename">&lt;PROJECT&gt;</code> in the same location as the
+      default one (<code class="filename">template/&lt;langcode&gt;</code>). By default
+      this is <code class="filename">template/en/default</code> so PROJECT's templates
+      would be located at <code class="filename">template/en/PROJECT</code>.</p><p>To set up an alternate installation, just export PROJECT=foo before
+      running <span class="command"><strong>checksetup.pl</strong></span> for the first time. It will
+      result in a file called <code class="filename">localconfig.foo</code> instead of
+      <code class="filename">localconfig</code>. Edit this file as described above, with
+      reference to a new database, and re-run <span class="command"><strong>checksetup.pl</strong></span>
+      to populate it. That's all.</p><p>Now you have to configure the web server to pass this environment
+      variable when accessed via an alternate URL, such as virtual host for
+      instance. The following is an example of how you could do it in Apache,
+      other Webservers may differ.
+</p><pre class="programlisting">
+&lt;VirtualHost 212.85.153.228:80&gt;
+    ServerName foo.bar.baz
+    SetEnv PROJECT foo
+    Alias /bugzilla /var/www/bugzilla
+&lt;/VirtualHost&gt;
+</pre><p>
+    </p><p>Don't forget to also export this variable before accessing Bugzilla
+       by other means, such as cron tasks for instance.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="extraconfig.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="installing-bugzilla.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="os-specific.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2.3. Optional Additional Configuration </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 2.5. OS-Specific Installation Notes</td></tr></table></div></body></html>

diff --git a/docs/en/html/myaccount.html b/docs/en/html/myaccount.html
new file mode 100644 (file)
index 0000000..e0ea45a
--- /dev/null
+++ b/docs/en/html/myaccount.html
@@ -0,0 +1,52 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>5.2. Create a Bugzilla Account</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="prev" href="using-intro.html" title="5.1. Introduction"><link rel="next" href="bug_page.html" title="5.3. Anatomy of a Bug"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.2. Create a Bugzilla Account</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="using-intro.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Using Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="bug_page.html">Next</a></td></tr></table><hr></div><div class="section" title="5.2. Create a Bugzilla Account"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="myaccount"></a>5.2. Create a Bugzilla Account</h2></div></div></div><p>If you want to use Bugzilla, first you need to create an account.
+    Consult with the administrator responsible for your installation of
+    Bugzilla for the URL you should use to access it. If you're
+    test-driving Bugzilla, use this URL: 
+    <a class="ulink" href="http://landfill.bugzilla.org/bugzilla-tip/" target="_top">http://landfill.bugzilla.org/bugzilla-tip/</a>.
+    </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+          On the home page <code class="filename">index.cgi</code>, click the
+          <span class="quote">“<span class="quote">Open a new Bugzilla account</span>”</span> link, or the
+          <span class="quote">“<span class="quote">New Account</span>”</span> link available in the footer of pages.
+          Now enter your email address, then click the <span class="quote">“<span class="quote">Send</span>”</span>
+          button.
+        </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            If none of these links is available, this means that the
+            administrator of the installation has disabled self-registration.
+            This means that only an administrator can create accounts
+            for other users. One reason could be that this installation is
+            private.
+          </p></td></tr></table></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            Also, if only some users are allowed to create an account on
+            the installation, you may see these links but your registration
+            may fail if your email address doesn't match the ones accepted
+            by the installation. This is another way to restrict who can
+            access and edit bugs in this installation.
+          </p></td></tr></table></div></li><li class="listitem"><p>
+          Within moments, and if your registration is accepted, you should
+          receive an email to the address you provided, which contains your
+          login name (generally the same as the email address), and two URLs
+          with a token (a random string generated by the installation) to
+          confirm, respectively cancel, your registration. This is a way to
+          prevent users from abusing the generation of user accounts, for
+          instance by entering inexistent email addresses, or email addresses
+          which do not belong to them.
+        </p></li><li class="listitem"><p>
+          By default, you have 3 days to confirm your registration. Past this
+          timeframe, the token is invalidated and the registration is
+          automatically canceled. You can also cancel this registration sooner
+          by using the appropriate URL in the email you got.
+        </p></li><li class="listitem"><p>
+          If you confirm your registration, Bugzilla will ask you your real name
+          (optional, but recommended) and your password, which must be between
+          3 and 16 characters long.
+        </p></li><li class="listitem"><p>
+          Now all you need to do is to click the <span class="quote">“<span class="quote">Log In</span>”</span>
+          link in the footer at the bottom of the page in your browser,
+          enter your email address and password you just chose into the
+          login form, and click the <span class="quote">“<span class="quote">Log in</span>”</span> button.
+        </p></li></ol></div><p>
+      You are now logged in. Bugzilla uses cookies to remember you are
+      logged in so, unless you have cookies disabled or your IP address changes,
+      you should not have to log in again during your session.
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="using-intro.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="using.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="bug_page.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5.1. Introduction </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 5.3. Anatomy of a Bug</td></tr></table></div></body></html>

diff --git a/docs/en/html/newversions.html b/docs/en/html/newversions.html
new file mode 100644 (file)
index 0000000..d09c245
--- /dev/null
+++ b/docs/en/html/newversions.html
@@ -0,0 +1,15 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>1.3. New Versions</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="about.html" title="Chapter 1. About This Guide"><link rel="prev" href="disclaimer.html" title="1.2. Disclaimer"><link rel="next" href="credits.html" title="1.4. Credits"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">1.3. New Versions</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="disclaimer.html">Prev</a> </td><th width="60%" align="center">Chapter 1. About This Guide</th><td width="20%" align="right"> <a accesskey="n" href="credits.html">Next</a></td></tr></table><hr></div><div class="section" title="1.3. New Versions"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="newversions"></a>1.3. New Versions</h2></div></div></div><p>
+      This is the 4.4 version of The Bugzilla Guide. It is so named
+      to match the current version of Bugzilla.
+    </p><p>
+      The latest version of this guide can always be found at <a class="ulink" href="http://www.bugzilla.org/docs/" target="_top">http://www.bugzilla.org/docs/</a>. However, you should read
+      the version which came with the Bugzilla release you are using.
+    </p><p>  
+      In addition, there are Bugzilla template localization projects in
+      <a class="ulink" href="http://www.bugzilla.org/download/#localizations" target="_top">several languages</a>.
+      They may have translated documentation available. If you would like to
+      volunteer to translate the Guide into additional languages, please visit the
+      <a class="ulink" href="https://wiki.mozilla.org/Bugzilla:L10n" target="_top">Bugzilla L10n team</a>
+      page.
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="disclaimer.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="about.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="credits.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">1.2. Disclaimer </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 1.4. Credits</td></tr></table></div></body></html>

diff --git a/docs/en/html/nonroot.html b/docs/en/html/nonroot.html
new file mode 100644 (file)
index 0000000..08eb62a
--- /dev/null
+++ b/docs/en/html/nonroot.html
@@ -0,0 +1,126 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>2.6. UNIX (non-root) Installation Notes</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="installing-bugzilla.html" title="Chapter 2. Installing Bugzilla"><link rel="prev" href="os-specific.html" title="2.5. OS-Specific Installation Notes"><link rel="next" href="upgrade.html" title="2.7. Upgrading to New Releases"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.6. UNIX (non-root) Installation Notes</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="os-specific.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Installing Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="upgrade.html">Next</a></td></tr></table><hr></div><div class="section" title="2.6. UNIX (non-root) Installation Notes"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="nonroot"></a>2.6. UNIX (non-root) Installation Notes</h2></div></div></div><div class="section" title="2.6.1. Introduction"><div class="titlepage"><div><div><h3 class="title"><a name="idp11695712"></a>2.6.1. Introduction</h3></div></div></div><p>If you are running a *NIX OS as non-root, either due
+      to lack of access (web hosts, for example) or for security
+      reasons, this will detail how to install Bugzilla on such
+      a setup. It is recommended that you read through the
+      <a class="xref" href="installation.html" title="2.1. Installation">Section 2.1, “Installation”</a>
+      first to get an idea on the installation steps required.
+      (These notes will reference to steps in that guide.)</p></div><div class="section" title="2.6.2. MySQL"><div class="titlepage"><div><div><h3 class="title"><a name="idp11697952"></a>2.6.2. MySQL</h3></div></div></div><p>You may have MySQL installed as root. If you're
+      setting up an account with a web host, a MySQL account
+      needs to be set up for you. From there, you can create
+      the bugs account, or use the account given to you.</p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>You may have problems trying to set up
+        <span class="command"><strong>GRANT</strong></span> permissions to the database.
+        If you're using a web host, chances are that you have a
+        separate database which is already locked down (or one big
+        database with limited/no access to the other areas), but you
+        may want to ask your system administrator what the security
+        settings are set to, and/or run the <span class="command"><strong>GRANT</strong></span>
+        command for you.</p><p>Also, you will probably not be able to change the MySQL
+        root user password (for obvious reasons), so skip that
+        step.</p></td></tr></table></div><div class="section" title="2.6.2.1. Running MySQL as Non-Root"><div class="titlepage"><div><div><h4 class="title"><a name="idp11702544"></a>2.6.2.1. Running MySQL as Non-Root</h4></div></div></div><div class="section" title="2.6.2.1.1. The Custom Configuration Method"><div class="titlepage"><div><div><h5 class="title"><a name="idp11703296"></a>2.6.2.1.1. The Custom Configuration Method</h5></div></div></div><p>Create a file .my.cnf in your 
+              home directory (using /home/foo in this example)
+              as follows....</p><pre class="programlisting">
+[mysqld]
+datadir=/home/foo/mymysql
+socket=/home/foo/mymysql/thesock
+port=8081
+
+[mysql]
+socket=/home/foo/mymysql/thesock
+port=8081
+
+[mysql.server]
+user=mysql
+basedir=/var/lib
+
+[safe_mysqld]
+err-log=/home/foo/mymysql/the.log
+pid-file=/home/foo/mymysql/the.pid
+              </pre></div><div class="section" title="2.6.2.1.2. The Custom Built Method"><div class="titlepage"><div><div><h5 class="title"><a name="idp11705744"></a>2.6.2.1.2. The Custom Built Method</h5></div></div></div><p>You can install MySQL as a not-root, if you really need to.
+            Build it with PREFIX set to <code class="filename">/home/foo/mysql</code>,
+            or use pre-installed executables, specifying that you want
+            to put all of the data files in <code class="filename">/home/foo/mysql/data</code>.
+            If there is another MySQL server running on the system that you
+            do not own, use the -P option to specify a TCP port that is not
+            in use.</p></div><div class="section" title="2.6.2.1.3. Starting the Server"><div class="titlepage"><div><div><h5 class="title"><a name="idp11709408"></a>2.6.2.1.3. Starting the Server</h5></div></div></div><p>After your mysqld program is built and any .my.cnf file is 
+            in place, you must initialize the databases (ONCE).</p><pre class="screen">
+<code class="prompt">bash$</code> <span class="command"><strong>mysql_install_db</strong></span>
+            </pre><p>Then start the daemon with</p><pre class="screen">
+<code class="prompt">bash$</code> <span class="command"><strong>safe_mysql &amp;</strong></span>
+            </pre><p>After you start mysqld the first time, you then connect to
+            it as "root" and <span class="command"><strong>GRANT</strong></span> permissions to other
+            users. (Again, the MySQL root account has nothing to do with
+            the *NIX root account.)</p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>You will need to start the daemons yourself. You can either
+              ask your system administrator to add them to system startup files, or
+              add a crontab entry that runs a script to check on these daemons
+              and restart them if needed.</p></td></tr></table></div><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Do NOT run daemons or other services on a server without first
+              consulting your system administrator! Daemons use up system resources
+              and running one may be in violation of your terms of service for any
+              machine on which you are a user!</p></td></tr></table></div></div></div></div><div class="section" title="2.6.3. Perl"><div class="titlepage"><div><div><h3 class="title"><a name="idp11719632"></a>2.6.3. Perl</h3></div></div></div><p>
+      On the extremely rare chance that you don't have Perl on
+      the machine, you will have to build the sources
+      yourself. The following commands should get your system
+      installed with your own personal version of Perl:
+      </p><pre class="screen">
+<code class="prompt">bash$</code> <span class="command"><strong>wget http://perl.org/CPAN/src/stable.tar.gz</strong></span>
+<code class="prompt">bash$</code> <span class="command"><strong>tar zvxf stable.tar.gz</strong></span>
+<code class="prompt">bash$</code> <span class="command"><strong>cd perl-5.8.1</strong></span>
+<code class="prompt">bash$</code> <span class="command"><strong>sh Configure -de -Dprefix=/home/foo/perl</strong></span>
+<code class="prompt">bash$</code> <span class="command"><strong>make &amp;&amp; make test &amp;&amp; make install</strong></span>
+      </pre><p>
+      Once you have Perl installed into a directory (probably
+      in <code class="filename">~/perl/bin</code>), you will need to
+      install the Perl Modules, described below.
+      </p></div><div class="section" title="2.6.4. Perl Modules"><div class="titlepage"><div><div><h3 class="title"><a name="install-perlmodules-nonroot"></a>2.6.4. Perl Modules</h3></div></div></div><p>
+      Installing the Perl modules as a non-root user is accomplished by
+      running the <code class="filename">install-module.pl</code>
+      script. For more details on this script, see 
+      <a class="ulink" href="../html/api/install-module.html" target="_top"><code class="filename">install-module.pl</code>
+      documentation</a>
+      </p></div><div class="section" title="2.6.5. HTTP Server"><div class="titlepage"><div><div><h3 class="title"><a name="idp11734464"></a>2.6.5. HTTP Server</h3></div></div></div><p>Ideally, this also needs to be installed as root and
+      run under a special web server account. As long as
+      the web server will allow the running of *.cgi files outside of a
+      cgi-bin, and a way of denying web access to certain files (such as a
+      .htaccess file), you should be good in this department.</p><div class="section" title="2.6.5.1. Running Apache as Non-Root"><div class="titlepage"><div><div><h4 class="title"><a name="idp11735952"></a>2.6.5.1. Running Apache as Non-Root</h4></div></div></div><p>You can run Apache as a non-root user, but the port will need
+        to be set to one above 1024. If you type <span class="command"><strong>httpd -V</strong></span>,
+        you will get a list of the variables that your system copy of httpd
+        uses. One of those, namely HTTPD_ROOT, tells you where that
+        installation looks for its config information.</p><p>From there, you can copy the config files to your own home
+        directory to start editing. When you edit those and then use the -d
+        option to override the HTTPD_ROOT compiled into the web server, you
+        get control of your own customized web server.</p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>You will need to start the daemons yourself. You can either
+          ask your system administrator to add them to system startup files, or
+          add a crontab entry that runs a script to check on these daemons
+          and restart them if needed.</p></td></tr></table></div><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Do NOT run daemons or other services on a server without first
+          consulting your system administrator! Daemons use up system resources
+          and running one may be in violation of your terms of service for any
+          machine on which you are a user!</p></td></tr></table></div></div></div><div class="section" title="2.6.6. Bugzilla"><div class="titlepage"><div><div><h3 class="title"><a name="idp11741472"></a>2.6.6. Bugzilla</h3></div></div></div><p>
+      When you run <span class="command"><strong>./checksetup.pl</strong></span> to create
+      the <code class="filename">localconfig</code> file, it will list the Perl
+      modules it finds. If one is missing, go back and double-check the
+      module installation from <a class="xref" href="nonroot.html#install-perlmodules-nonroot" title="2.6.4. Perl Modules">Section 2.6.4, “Perl Modules”</a>, 
+      then delete the <code class="filename">localconfig</code> file and try again.
+      </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>One option in <code class="filename">localconfig</code> you
+        might have problems with is the web server group. If you can't
+        successfully browse to the <code class="filename">index.cgi</code> (like
+        a Forbidden error), you may have to relax your permissions,
+        and blank out the web server group. Of course, this may pose
+        as a security risk. Having a properly jailed shell and/or
+        limited access to shell accounts may lessen the security risk,
+        but use at your own risk.</p></td></tr></table></div><div class="section" title="2.6.6.1. suexec or shared hosting"><div class="titlepage"><div><div><h4 class="title"><a name="suexec"></a>2.6.6.1. suexec or shared hosting</h4></div></div></div><p>If you are running on a system that uses suexec (most shared
+        hosting environments do this), you will need to set the
+        <span class="emphasis"><em>webservergroup</em></span> value in <code class="filename">localconfig</code>
+        to match <span class="emphasis"><em>your</em></span> primary group, rather than the one
+        the web server runs under.  You will need to run the following
+        shell commands after running <span class="command"><strong>./checksetup.pl</strong></span>,
+        every time you run it (or modify <code class="filename">checksetup.pl</code>
+        to do them for you via the system() command).
+        </p><pre class="programlisting">
+for i in docs graphs images js skins; do find $i -type d -exec chmod o+rx {} \; ; done
+for i in jpg gif css js png html rdf xul; do find . -name \*.$i -exec chmod o+r {} \; ; done
+find . -name .htaccess -exec chmod o+r {} \;
+chmod o+x . data data/webdot
+        </pre><p>
+        Pay particular attention to the number of semicolons and dots.
+        They are all important.  A future version of Bugzilla will
+        hopefully be able to do this for you out of the box.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="os-specific.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="installing-bugzilla.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="upgrade.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2.5. OS-Specific Installation Notes </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 2.7. Upgrading to New Releases</td></tr></table></div></body></html>

diff --git a/docs/en/html/os-specific.html b/docs/en/html/os-specific.html
new file mode 100644 (file)
index 0000000..233bace
--- /dev/null
+++ b/docs/en/html/os-specific.html
@@ -0,0 +1,134 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>2.5. OS-Specific Installation Notes</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="installing-bugzilla.html" title="Chapter 2. Installing Bugzilla"><link rel="prev" href="multiple-bz-dbs.html" title="2.4. Multiple Bugzilla databases with a single installation"><link rel="next" href="nonroot.html" title="2.6. UNIX (non-root) Installation Notes"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.5. OS-Specific Installation Notes</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="multiple-bz-dbs.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Installing Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="nonroot.html">Next</a></td></tr></table><hr></div><div class="section" title="2.5. OS-Specific Installation Notes"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="os-specific"></a>2.5. OS-Specific Installation Notes</h2></div></div></div><p>Many aspects of the Bugzilla installation can be affected by the
+    operating system you choose to install it on. Sometimes it can be made
+    easier and others more difficult. This section will attempt to help you
+    understand both the difficulties of running on specific operating systems
+    and the utilities available to make it easier.
+    </p><p>If you have anything to add or notes for an operating system not covered,
+    please file a bug in <a class="ulink" href="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla;component=Documentation" target="_top">Bugzilla Documentation</a>.
+    </p><div class="section" title="2.5.1. Microsoft Windows"><div class="titlepage"><div><div><h3 class="title"><a name="os-win32"></a>2.5.1. Microsoft Windows</h3></div></div></div><p>
+        Making Bugzilla work on Windows is more difficult than making it
+        work on Unix.  For that reason, we still recommend doing so on a Unix 
+        based system such as GNU/Linux.  That said, if you do want to get
+        Bugzilla running on Windows, you will need to make the following
+        adjustments. A detailed step-by-step
+        <a class="ulink" href="https://wiki.mozilla.org/Bugzilla:Win32Install" target="_top">
+        installation guide for Windows</a> is also available
+        if you need more help with your installation.
+      </p><div class="section" title="2.5.1.1. Win32 Perl"><div class="titlepage"><div><div><h4 class="title"><a name="win32-perl"></a>2.5.1.1. Win32 Perl</h4></div></div></div><p>
+          Perl for Windows can be obtained from 
+          <a class="ulink" href="http://www.activestate.com/" target="_top">ActiveState</a>.
+           You should be able to find a compiled binary at <a class="ulink" href="http://aspn.activestate.com/ASPN/Downloads/ActivePerl/" target="_top">http://aspn.activestate.com/ASPN/Downloads/ActivePerl/</a>.
+           The following instructions assume that you are using version
+           5.8.1 of ActiveState.
+          </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+             These instructions are for 32-bit versions of Windows. If you are
+             using a 64-bit version of Windows, you will need to install 32-bit
+             Perl in order to install the 32-bit modules as described below.
+            </p></td></tr></table></div></div><div class="section" title="2.5.1.2. Perl Modules on Win32"><div class="titlepage"><div><div><h4 class="title"><a name="win32-perl-modules"></a>2.5.1.2. Perl Modules on Win32</h4></div></div></div><p>
+          Bugzilla on Windows requires the same perl modules found in
+          <a class="xref" href="installation.html#install-perlmodules" title="2.1.5. Perl Modules">Section 2.1.5, “Perl Modules”</a>. The main difference is that
+          windows uses <a class="glossterm" href="glossary.html#gloss-ppm"><em class="glossterm">PPM</em></a> instead
+          of CPAN. ActiveState provides a GUI to manage Perl modules. We highly
+          recommend that you use it. If you prefer to use ppm from the
+          command-line, type:
+        </p><pre class="programlisting">
+C:\perl&gt; <span class="command"><strong>ppm install &lt;module name&gt;</strong></span>
+        </pre><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            The PPM repository stores modules in 'packages' that may have
+            a slightly different name than the module.  If retrieving these
+            modules from there, you will need to pay attention to the information
+            provided when you run <span class="command"><strong>checksetup.pl</strong></span> as it will
+            tell you what package you'll need to install.
+          </p></td></tr></table></div><div class="tip" title="Tip" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../images/tip.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            If you are behind a corporate firewall, you will need to let the
+            ActiveState PPM utility know how to get through it to access
+            the repositories by setting the HTTP_proxy system environmental
+            variable. For more information on setting that variable, see
+            the ActiveState documentation.
+          </p></td></tr></table></div></div><div class="section" title="2.5.1.3. Serving the web pages"><div class="titlepage"><div><div><h4 class="title"><a name="win32-http"></a>2.5.1.3. Serving the web pages</h4></div></div></div><p>
+          As is the case on Unix based systems, any web server should
+          be able to handle Bugzilla; however, the Bugzilla Team still
+          recommends Apache whenever asked. No matter what web server
+          you choose, be sure to pay attention to the security notes
+          in <a class="xref" href="security-webserver.html#security-webserver-access" title="4.2.1. Disabling Remote Access to Bugzilla Configuration Files">Section 4.2.1, “Disabling Remote Access to Bugzilla Configuration Files”</a>. More
+          information on configuring specific web servers can be found
+          in <a class="xref" href="configuration.html#http" title="2.2.4. Web server">Section 2.2.4, “Web server”</a>.
+        </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            The web server looks at <code class="filename">/usr/bin/perl</code> to
+            call Perl. If you are using Apache on windows, you can set the
+            <a class="ulink" href="http://httpd.apache.org/docs-2.0/mod/core.html#scriptinterpretersource" target="_top">ScriptInterpreterSource</a>
+            directive in your Apache config file to make it look at the
+            right place: insert the line
+            </p><pre class="programlisting">ScriptInterpreterSource Registry-Strict</pre><p>
+            into your <code class="filename">httpd.conf</code> file, and create the key
+            </p><pre class="programlisting">HKEY_CLASSES_ROOT\.cgi\Shell\ExecCGI\Command</pre><p>
+            with <code class="option">C:\Perl\bin\perl.exe -T</code> as value (adapt to your
+            path if needed) in the registry. When this is done, restart Apache.
+          </p></td></tr></table></div></div><div class="section" title="2.5.1.4. Sending Email"><div class="titlepage"><div><div><h4 class="title"><a name="win32-email"></a>2.5.1.4. Sending Email</h4></div></div></div><p>
+          To enable Bugzilla to send email on Windows, the server running the
+          Bugzilla code must be able to connect to, or act as, an SMTP server.
+        </p></div></div><div class="section" title="2.5.2. Mac OS X™"><div class="titlepage"><div><div><h3 class="title"><a name="os-macosx"></a>2.5.2. <span class="productname">Mac OS X</span>™</h3></div></div></div><p>Making Bugzilla work on Mac OS X requires the following 
+      adjustments.</p><div class="section" title="2.5.2.1. Sendmail"><div class="titlepage"><div><div><h4 class="title"><a name="macosx-sendmail"></a>2.5.2.1. Sendmail</h4></div></div></div><p>In Mac OS X 10.3 and later, 
+        <a class="ulink" href="http://www.postfix.org/" target="_top">Postfix</a> 
+        is used as the built-in email server.  Postfix provides an executable
+        that mimics sendmail enough to fool Bugzilla, as long as Bugzilla can 
+        find it. Bugzilla is able to find the fake sendmail executable without
+        any assistance.</p></div><div class="section" title="2.5.2.2. Libraries &amp; Perl Modules on Mac OS X"><div class="titlepage"><div><div><h4 class="title"><a name="macosx-libraries"></a>2.5.2.2. Libraries &amp; Perl Modules on Mac OS X</h4></div></div></div><p>Apple does not include the GD library with Mac OS X. Bugzilla
+        needs this for bug graphs.</p><p>You can use MacPorts (<a class="ulink" href="http://www.macports.org/" target="_top">http://www.macports.org/</a>)
+        or Fink (<a class="ulink" href="http://sourceforge.net/projects/fink/" target="_top">http://sourceforge.net/projects/fink/</a>), both
+        of which are similar in nature to the CPAN installer, but install
+        common unix programs.</p><p>Follow the instructions for setting up MacPorts or Fink.
+        Once you have one installed, you'll want to use it to install the
+        <code class="filename">gd2</code> package.
+        </p><p>Fink will prompt you for a number of dependencies, type 'y' and hit
+        enter to install all of the dependencies and then watch it work. You will
+        then be able to use <a class="glossterm" href="glossary.html#gloss-cpan"><em class="glossterm">CPAN</em></a> to
+        install the GD Perl module.
+        </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>To prevent creating conflicts with the software that Apple
+          installs by default, Fink creates its own directory tree at 
+          <code class="filename">/sw</code> where it installs most of
+          the software that it installs. This means your libraries and headers
+          will be at <code class="filename">/sw/lib</code> and
+          <code class="filename">/sw/include</code> instead of
+          <code class="filename">/usr/lib</code> and
+          <code class="filename">/usr/include</code>. When the
+          Perl module config script asks where your <code class="filename">libgd</code>
+          is, be sure to tell it
+          <code class="filename">/sw/lib</code>.
+          </p></td></tr></table></div><p>Also available via MacPorts and Fink is
+        <code class="filename">expat</code>. After installing the expat package, you
+        will be able to install XML::Parser using CPAN. If you use fink, there
+        is one caveat. Unlike recent versions of
+        the GD module, XML::Parser doesn't prompt for the location of the
+        required libraries. When using CPAN, you will need to use the following
+        command sequence:
+        </p><pre class="screen">
+# perl -MCPAN -e'look XML::Parser'
+# perl Makefile.PL EXPATLIBPATH=/sw/lib EXPATINCPATH=/sw/include
+# make; make test; make install
+# exit
+        </pre><p>
+          The <span class="command"><strong>look</strong></span> command will download the module and spawn
+          a new shell with the extracted files as the current working directory.
+        </p><p>
+          You should watch the output from these <span class="command"><strong>make</strong></span> commands,
+          especially <span class="quote">“<span class="quote">make test</span>”</span> as errors may prevent
+          XML::Parser from functioning correctly with Bugzilla.
+        </p><p>
+          The <span class="command"><strong>exit</strong></span> command will return you to your original shell.
+        </p></div></div><div class="section" title="2.5.3. Linux Distributions"><div class="titlepage"><div><div><h3 class="title"><a name="os-linux"></a>2.5.3. Linux Distributions</h3></div></div></div><p>Many Linux distributions include Bugzilla and its 
+            dependencies in their native package management systems. 
+            Installing Bugzilla with root access on any Linux system 
+            should be as simple as finding the Bugzilla package in the 
+            package management application and installing it using the 
+            normal command syntax. Several distributions also perform 
+            the proper web server configuration automatically on installation.
+            </p><p>Please consult the documentation of your Linux 
+            distribution for instructions on how to install packages, 
+            or for specific instructions on installing Bugzilla with 
+            native package management tools. There is also a 
+            <a class="ulink" href="http://wiki.mozilla.org/Bugzilla:Linux_Distro_Installation" target="_top">
+            Bugzilla Wiki Page</a> for distro-specific installation
+            notes.
+            </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="multiple-bz-dbs.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="installing-bugzilla.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="nonroot.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2.4. Multiple Bugzilla databases with a single installation </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 2.6. UNIX (non-root) Installation Notes</td></tr></table></div></body></html>

diff --git a/docs/en/html/parameters.html b/docs/en/html/parameters.html
new file mode 100644 (file)
index 0000000..5219c01
--- /dev/null
+++ b/docs/en/html/parameters.html
@@ -0,0 +1,478 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.1. Bugzilla Configuration</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="next" href="useradmin.html" title="3.2. User Administration"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.1. Bugzilla Configuration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="administration.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="useradmin.html">Next</a></td></tr></table><hr></div><div class="section" title="3.1. Bugzilla Configuration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="parameters"></a>3.1. Bugzilla Configuration</h2></div></div></div><p>
+      Bugzilla is configured by changing various parameters, accessed
+      from the "Parameters" link in the Administration page (the 
+      Administration page can be found by clicking the "Administration"
+      link in the footer). The parameters are divided into several categories,
+      accessed via the menu on the left. Following is a description of the 
+      different categories and important parameters within those categories. 
+    </p><div class="section" title="3.1.1. Required Settings"><div class="titlepage"><div><div><h3 class="title"><a name="param-requiredsettings"></a>3.1.1. Required Settings</h3></div></div></div><p>
+          The core required parameters for any Bugzilla installation are set
+          here. These parameters must be set before a new Bugzilla installation
+          can be used. Administrators should review this list before 
+          deploying a new Bugzilla installation.
+        </p><div class="variablelist"><dl><dt><span class="term">
+              maintainer
+            </span></dt><dd><p> 
+              Email address of the person 
+              responsible for maintaining this Bugzilla installation.
+              The address need not be that of a valid Bugzilla account.
+            </p></dd><dt><span class="term">
+              urlbase
+            </span></dt><dd><p>
+                Defines the fully qualified domain name and web 
+                server path to this Bugzilla installation.
+              </p><p>
+                For example, if the Bugzilla query page is
+                <code class="filename">http://www.foo.com/bugzilla/query.cgi</code>, 
+                the <span class="quote">“<span class="quote">urlbase</span>”</span> should be set
+                to <code class="filename">http://www.foo.com/bugzilla/</code>.
+              </p></dd><dt><span class="term">
+              docs_urlbase
+            </span></dt><dd><p>
+                Defines path to the Bugzilla documentation. This can be a fully
+                qualified domain name, or a path relative to "urlbase".
+              </p><p>
+                For example, if the "Bugzilla Configuration" page 
+                of the documentation is
+                <code class="filename">http://www.foo.com/bugzilla/docs/html/parameters.html</code>, 
+                set the <span class="quote">“<span class="quote">docs_urlbase</span>”</span>
+                to <code class="filename">http://www.foo.com/bugzilla/docs/html/</code>.
+              </p></dd><dt><span class="term">
+              sslbase
+            </span></dt><dd><p>
+                Defines the fully qualified domain name and web 
+                server path for HTTPS (SSL) connections to this Bugzilla installation.
+              </p><p>
+                For example, if the Bugzilla main page is
+                <code class="filename">https://www.foo.com/bugzilla/index.cgi</code>, 
+                the <span class="quote">“<span class="quote">sslbase</span>”</span> should be set
+                to <code class="filename">https://www.foo.com/bugzilla/</code>.
+              </p></dd><dt><span class="term">
+              ssl_redirect
+            </span></dt><dd><p>
+                If enabled, Bugzilla will force HTTPS (SSL) connections, by
+                automatically redirecting any users who try to use a non-SSL
+                connection.
+              </p></dd><dt><span class="term">
+              cookiedomain
+            </span></dt><dd><p>
+               Defines the domain for Bugzilla cookies. This is typically left blank.
+               If there are multiple hostnames that point to the same webserver, which
+               require the same cookie, then this parameter can be utilized. For
+               example, If your website is at 
+               <code class="filename">https://www.foo.com/</code>, setting this to 
+               <code class="filename">.foo.com/</code> will also allow 
+               <code class="filename">bar.foo.com/</code> to access Bugzilla cookies.
+              </p></dd><dt><span class="term">
+              cookiepath
+            </span></dt><dd><p>
+                Defines a path, relative to the web server root, that Bugzilla
+                cookies will be restricted to. For example, if the 
+                <span class="command"><strong>urlbase</strong></span> is set to
+                <code class="filename">http://www.foo.com/bugzilla/</code>, the 
+                <span class="command"><strong>cookiepath</strong></span> should be set to 
+                <code class="filename">/bugzilla/</code>. Setting it to "/" will allow all sites 
+                served by this web server or virtual host to read Bugzilla cookies.
+              </p></dd><dt><span class="term">
+              utf8
+            </span></dt><dd><p>
+               Determines whether to use UTF-8 (Unicode) encoding for all text in 
+               Bugzilla. New installations should set this to true to avoid character 
+               encoding problems. Existing databases should set this to true only 
+               after the data has been converted from existing legacy character 
+               encoding to UTF-8, using the 
+               <code class="filename">contrib/recode.pl</code> script.
+              </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+                  If you turn this parameter from "off" to "on", you must re-run 
+                  <code class="filename">checksetup.pl</code> immediately afterward.
+                </p></td></tr></table></div></dd><dt><span class="term">
+              shutdownhtml
+            </span></dt><dd><p>
+                If there is any text in this field, this Bugzilla installation will
+                be completely disabled and this text will appear instead of all
+                Bugzilla pages for all users, including Admins. Used in the event 
+                of site maintenance or outage situations. 
+              </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+                  Although regular log-in capability is disabled while 
+                  <span class="command"><strong>shutdownhtml</strong></span>
+                  is enabled, safeguards are in place to protect the unfortunate 
+                  admin who loses connection to Bugzilla. Should this happen to you,
+                  go directly to the <code class="filename">editparams.cgi</code> (by typing
+                  the URL in manually, if necessary). Doing this will prompt you to
+                  log in, and your name/password will be accepted here (but nowhere
+                  else). 
+                </p></td></tr></table></div></dd><dt><span class="term">
+              announcehtml
+            </span></dt><dd><p>
+                Any text in this field will be displayed at the top of every HTML
+                page in this Bugzilla installation. The text is not wrapped in any
+                tags. For best results, wrap the text in a <span class="quote">“<span class="quote">&lt;div&gt;</span>”</span>
+                tag. Any style attributes from the CSS can be applied. For example,
+                to make the text green inside of a red box, add <span class="quote">“<span class="quote">id=message</span>”</span>
+                to the <span class="quote">“<span class="quote">&lt;div&gt;</span>”</span> tag.
+              </p></dd><dt><span class="term">
+              proxy_url
+            </span></dt><dd><p>
+                If this Bugzilla installation is behind a proxy, enter the proxy 
+                information here to enable Bugzilla to access the Internet. Bugzilla
+                requires Internet access to utilize the 
+                <span class="command"><strong>upgrade_notification</strong></span> parameter (below). If the 
+                proxy requires authentication, use the syntax:
+                <code class="filename">http://user:pass@proxy_url/</code>.
+              </p></dd><dt><span class="term">
+              upgrade_notification
+            </span></dt><dd><p>
+                Enable or disable a notification on the homepage of this Bugzilla
+                installation when a newer version of Bugzilla is available. This
+                notification is only visible to administrators. Choose "disabled",
+                to turn off the notification. Otherwise, choose which version of
+                Bugzilla you want to be notified about: "development_snapshot" is the
+                latest release on the trunk; "latest_stable_release" is the most 
+                recent release available on the most recent stable branch; 
+                "stable_branch_release" the most recent release on the branch 
+                this installation is based on.
+              </p></dd></dl></div></div><div class="section" title="3.1.2. Administrative Policies"><div class="titlepage"><div><div><h3 class="title"><a name="param-admin-policies"></a>3.1.2. Administrative Policies</h3></div></div></div><p>
+            This page contains parameters for basic administrative functions.
+            Options include whether to allow the deletion of bugs and users,
+            and whether to allow users to change their email address.
+          </p></div><div class="section" title="3.1.3. User Authentication"><div class="titlepage"><div><div><h3 class="title"><a name="param-user-authentication"></a>3.1.3. User Authentication</h3></div></div></div><p>
+            This page contains the settings that control how this Bugzilla
+            installation will do its authentication. Choose what authentication
+            mechanism to use (the Bugzilla database, or an external source such
+            as LDAP), and set basic behavioral parameters. For example, choose
+            whether to require users to login to browse bugs, the management
+            of authentication cookies, and the regular expression used to
+            validate email addresses. Some parameters are highlighted below.
+          </p><div class="variablelist"><dl><dt><span class="term">
+              emailregexp
+            </span></dt><dd><p>
+                Defines the regular expression used to validate email addresses
+                used for login names. The default attempts to match fully
+                qualified email addresses (i.e. 'user@example.com') in a slightly
+                more restrictive way than what is allowed in RFC 2822.
+                Some Bugzilla installations allow only local user names (i.e 'user'
+                instead of 'user@example.com'). In that case, this parameter
+                should be used to define the email domain.
+              </p></dd><dt><span class="term">
+              emailsuffix
+            </span></dt><dd><p>
+                This string is appended to login names when actually sending 
+                email to a user. For example,
+                If <span class="command"><strong>emailregexp</strong></span> has been set to allow
+                local usernames,
+                then this parameter would contain the email domain for all users
+                (i.e. '@example.com').   
+              </p></dd></dl></div></div><div class="section" title="3.1.4. Attachments"><div class="titlepage"><div><div><h3 class="title"><a name="param-attachments"></a>3.1.4. Attachments</h3></div></div></div><p>
+            This page allows for setting restrictions and other parameters
+            regarding attachments to bugs. For example, control size limitations
+            and whether to allow pointing to external files via a URI.
+          </p></div><div class="section" title="3.1.5. Bug Change Policies"><div class="titlepage"><div><div><h3 class="title"><a name="param-bug-change-policies"></a>3.1.5. Bug Change Policies</h3></div></div></div><p>
+            Set policy on default behavior for bug change events. For example,
+            choose which status to set a bug to when it is marked as a duplicate,
+            and choose whether to allow bug reporters to set the priority or
+            target milestone. Also allows for configuration of what changes
+            should require the user to make a comment, described below.    
+          </p><div class="variablelist"><dl><dt><span class="term">
+              commenton*
+            </span></dt><dd><p>
+                All these fields allow you to dictate what changes can pass
+                without comment, and which must have a comment from the
+                person who changed them.  Often, administrators will allow
+                users to add themselves to the CC list, accept bugs, or
+                change the Status Whiteboard without adding a comment as to
+                their reasons for the change, yet require that most other
+                changes come with an explanation.
+              </p><p>
+                Set the "commenton" options according to your site policy. It
+                is a wise idea to require comments when users resolve, reassign, or
+                reopen bugs at the very least. 
+              </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+                  It is generally far better to require a developer comment
+                  when resolving bugs than not. Few things are more annoying to bug
+                  database users than having a developer mark a bug "fixed" without
+                  any comment as to what the fix was (or even that it was truly
+                  fixed!)
+                </p></td></tr></table></div></dd><dt><span class="term">
+              noresolveonopenblockers
+            </span></dt><dd><p>
+                This option will prevent users from resolving bugs as FIXED if
+                they have unresolved dependencies. Only the FIXED resolution
+                is affected. Users will be still able to resolve bugs to
+                resolutions other than FIXED if they have unresolved dependent
+                bugs.
+              </p></dd></dl></div></div><div class="section" title="3.1.6. Bug Fields"><div class="titlepage"><div><div><h3 class="title"><a name="param-bugfields"></a>3.1.6. Bug Fields</h3></div></div></div><p>
+            The parameters in this section determine the default settings of
+            several Bugzilla fields for new bugs, and also control whether
+            certain fields are used. For example, choose whether to use the
+            "target milestone" field or the "status whiteboard" field.
+          </p><div class="variablelist"><dl><dt><span class="term">
+              useqacontact
+            </span></dt><dd><p>
+                This allows you to define an email address for each component, 
+                in addition to that of the default assignee, who will be sent
+                carbon copies of incoming bugs.
+              </p></dd><dt><span class="term">
+              usestatuswhiteboard
+            </span></dt><dd><p>
+                This defines whether you wish to have a free-form, overwritable field
+                associated with each bug. The advantage of the Status Whiteboard is
+                that it can be deleted or modified with ease, and provides an
+                easily-searchable field for indexing some bugs that have some trait
+                in common.         
+              </p></dd></dl></div></div><div class="section" title="3.1.7. Bug Moving"><div class="titlepage"><div><div><h3 class="title"><a name="param-bugmoving"></a>3.1.7. Bug Moving</h3></div></div></div><p>
+            This page controls whether this Bugzilla installation allows certain
+            users to move bugs to an external database. If bug moving is enabled,
+            there are a number of parameters that control bug moving behaviors. 
+            For example, choose which users are allowed to move bugs, the location
+            of the external database, and the default product and component that
+            bugs moved <span class="emphasis"><em>from</em></span> other bug databases to this 
+            Bugzilla installation are assigned to. 
+          </p></div><div class="section" title="3.1.8. Dependency Graphs"><div class="titlepage"><div><div><h3 class="title"><a name="param-dependency-graphs"></a>3.1.8. Dependency Graphs</h3></div></div></div><p>
+            This page has one parameter that sets the location of a Web Dot
+            server, or of the Web Dot binary on the local system, that is used
+            to generate dependency graphs. Web Dot is a CGI program that creates
+            images from <code class="filename">.dot</code> graphic description files. If
+            no Web Dot server or binary is specified, then dependency graphs will
+            be disabled.
+          </p></div><div class="section" title="3.1.9. Group Security"><div class="titlepage"><div><div><h3 class="title"><a name="param-group-security"></a>3.1.9. Group Security</h3></div></div></div><p>
+              Bugzilla allows for the creation of different groups, with the
+              ability to restrict the visibility of bugs in a group to a set of 
+              specific users. Specific products can also be associated with
+              groups, and users restricted to only see products in their groups.
+              Several parameters are described in more detail below. Most of the
+              configuration of groups and their relationship to products is done
+              on the "Groups" and "Product" pages of the "Administration" area.
+              The options on this page control global default behavior. 
+              For more information on Groups and Group Security, see
+              <a class="xref" href="groups.html" title="3.15. Groups and Group Security">Section 3.15, “Groups and Group Security”</a> 
+            </p><div class="variablelist"><dl><dt><span class="term">
+              makeproductgroups
+            </span></dt><dd><p>
+                Determines whether or not to automatically create groups
+                when new products are created. If this is on, the groups will be
+                used for querying bugs.
+              </p></dd><dt><span class="term">
+              usevisibilitygroups
+            </span></dt><dd><p>
+                If selected, user visibility will be restricted to members of
+                groups, as selected in the group configuration settings. 
+                Each user-defined group can be allowed to see members of selected
+                other groups. 
+                For details on configuring groups (including the visibility 
+                restrictions) see <a class="xref" href="groups.html#edit-groups" title="3.15.2. Editing Groups and Assigning Group Permissions">Section 3.15.2, “Editing Groups and Assigning Group Permissions”</a>. 
+              </p></dd><dt><span class="term">
+              querysharegroup
+            </span></dt><dd><p>
+                The name of the group of users who are allowed to share saved
+                searches with one another. For more information on using 
+                saved searches, see <a class="xref" href="userpreferences.html#savedsearches" title="5.10.3. Saved Searches">Saved Searches</a>.
+              </p></dd></dl></div></div><div class="section" title="3.1.10. LDAP Authentication"><div class="titlepage"><div><div><h3 class="title"><a name="bzldap"></a>3.1.10. LDAP Authentication</h3></div></div></div><p>LDAP authentication is a module for Bugzilla's plugin 
+          authentication architecture. This page contains all the parameters
+          necessary to configure Bugzilla for use with LDAP authentication.
+          </p><p>
+          The existing authentication
+          scheme for Bugzilla uses email addresses as the primary user ID, and a
+          password to authenticate that user. All places within Bugzilla that
+          require a user ID (e.g assigning a bug) use the email
+          address. The LDAP authentication builds on top of this scheme, rather
+          than replacing it. The initial log-in is done with a username and
+          password for the LDAP directory. Bugzilla tries to bind to LDAP using
+          those credentials and, if successful, tries to map this account to a
+          Bugzilla account. If an LDAP mail attribute is defined, the value of this
+          attribute is used, otherwise the "emailsuffix" parameter is appended to LDAP
+          username to form a full email address. If an account for this address
+          already exists in the Bugzilla installation, it will log in to that account.
+          If no account for that email address exists, one is created at the time
+          of login. (In this case, Bugzilla will attempt to use the "displayName"
+          or "cn" attribute to determine the user's full name.) After
+          authentication, all other user-related tasks are still handled by email
+          address, not LDAP username. For example, bugs are still assigned by
+          email address and users are still queried by email address.
+          </p><div class="caution" title="Caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Because the Bugzilla account is not created until the first time
+            a user logs in, a user who has not yet logged is unknown to Bugzilla.
+            This means they cannot be used as an assignee or QA contact (default or
+            otherwise), added to any CC list, or any other such operation. One
+            possible workaround is the <code class="filename">bugzilla_ldapsync.rb</code>
+            script in the
+            <a class="glossterm" href="glossary.html#gloss-contrib"><em class="glossterm">
+            <code class="filename">contrib</code></em></a> 
+            directory. Another possible solution is fixing
+            <a class="ulink" href="https://bugzilla.mozilla.org/show_bug.cgi?id=201069" target="_top">bug
+            201069</a>.
+            </p></td></tr></table></div><p>Parameters required to use LDAP Authentication:</p><div class="variablelist"><dl><dt><a name="param-user_verify_class_for_ldap"></a><span class="term">user_verify_class</span></dt><dd><p>If you want to list <span class="quote">“<span class="quote">LDAP</span>”</span> here,
+                make sure to have set up the other parameters listed below.
+                Unless you have other (working) authentication methods listed as
+                well, you may otherwise not be able to log back in to Bugzilla once
+                you log out.
+                If this happens to you, you will need to manually edit
+                <code class="filename">data/params</code> and set user_verify_class to
+                <span class="quote">“<span class="quote">DB</span>”</span>.
+                </p></dd><dt><a name="param-LDAPserver"></a><span class="term">LDAPserver</span></dt><dd><p>This parameter should be set to the name (and optionally the
+                port) of your LDAP server. If no port is specified, it assumes
+                the default LDAP port of 389.
+                </p><p>For example: <span class="quote">“<span class="quote">ldap.company.com</span>”</span>
+                 or <span class="quote">“<span class="quote">ldap.company.com:3268</span>”</span>
+                </p><p>You can also specify a LDAP URI, so as to use other
+                protocols, such as LDAPS or LDAPI. If port was not specified in
+                the URI, the default is either 389 or 636 for 'LDAP' and 'LDAPS'
+                schemes respectively.
+                </p><div class="tip" title="Tip" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../images/tip.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+                    In order to use SSL with LDAP, specify a URI with "ldaps://".
+                    This will force the use of SSL over port 636.
+                  </p></td></tr></table></div><p>For example, normal LDAP: 
+                <span class="quote">“<span class="quote">ldap://ldap.company.com</span>”</span>, LDAP over SSL:
+                <span class="quote">“<span class="quote">ldaps://ldap.company.com</span>”</span> or LDAP over a UNIX 
+                domain socket <span class="quote">“<span class="quote">ldapi://%2fvar%2flib%2fldap_sock</span>”</span>.
+                </p></dd><dt><a name="param-LDAPbinddn"></a><span class="term">LDAPbinddn [Optional]</span></dt><dd><p>Some LDAP servers will not allow an anonymous bind to search
+                 the directory. If this is the case with your configuration you
+                 should set the LDAPbinddn parameter to the user account Bugzilla
+                 should use instead of the anonymous bind.
+                 </p><p>Ex. <span class="quote">“<span class="quote">cn=default,cn=user:password</span>”</span></p></dd><dt><a name="param-LDAPBaseDN"></a><span class="term">LDAPBaseDN</span></dt><dd><p>The LDAPBaseDN parameter should be set to the location in
+                 your LDAP tree that you would like to search for email addresses.
+                 Your uids should be unique under the DN specified here.
+                 </p><p>Ex. <span class="quote">“<span class="quote">ou=People,o=Company</span>”</span></p></dd><dt><a name="param-LDAPuidattribute"></a><span class="term">LDAPuidattribute</span></dt><dd><p>The LDAPuidattribute parameter should be set to the attribute
+                 which contains the unique UID of your users. The value retrieved
+                 from this attribute will be used when attempting to bind as the
+                 user to confirm their password.
+                 </p><p>Ex. <span class="quote">“<span class="quote">uid</span>”</span></p></dd><dt><a name="param-LDAPmailattribute"></a><span class="term">LDAPmailattribute</span></dt><dd><p>The LDAPmailattribute parameter should be the name of the
+                 attribute which contains the email address your users will enter
+                 into the Bugzilla login boxes.
+                 </p><p>Ex. <span class="quote">“<span class="quote">mail</span>”</span></p></dd></dl></div></div><div class="section" title="3.1.11. RADIUS Authentication"><div class="titlepage"><div><div><h3 class="title"><a name="bzradius"></a>3.1.11. RADIUS Authentication</h3></div></div></div><p>
+          RADIUS authentication is a module for Bugzilla's plugin 
+          authentication architecture. This page contains all the parameters
+          necessary for configuring Bugzilla to use RADIUS authentication.
+          </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+              Most caveats that apply to LDAP authentication apply to RADIUS
+              authentication as well. See <a class="xref" href="parameters.html#bzldap" title="3.1.10. LDAP Authentication">Section 3.1.10, “LDAP Authentication”</a> for details.
+            </p></td></tr></table></div><p>Parameters required to use RADIUS Authentication:</p><div class="variablelist"><dl><dt><a name="param-user_verify_class_for_radius"></a><span class="term">user_verify_class</span></dt><dd><p>If you want to list <span class="quote">“<span class="quote">RADIUS</span>”</span> here,
+                make sure to have set up the other parameters listed below.
+                Unless you have other (working) authentication methods listed as
+                well, you may otherwise not be able to log back in to Bugzilla once
+                you log out.
+                If this happens to you, you will need to manually edit
+                <code class="filename">data/params</code> and set user_verify_class to
+                <span class="quote">“<span class="quote">DB</span>”</span>.
+                </p></dd><dt><a name="param-RADIUS_server"></a><span class="term">RADIUS_server</span></dt><dd><p>This parameter should be set to the name (and optionally the
+                port) of your RADIUS server.
+                </p></dd><dt><a name="param-RADIUS_secret"></a><span class="term">RADIUS_secret</span></dt><dd><p>This parameter should be set to the RADIUS server's secret.
+                </p></dd><dt><a name="param-RADIUS_email_suffix"></a><span class="term">RADIUS_email_suffix</span></dt><dd><p>Bugzilla needs an e-mail address for each user account.
+                Therefore, it needs to determine the e-mail address corresponding
+                to a RADIUS user.
+                Bugzilla offers only a simple way to do this: it can concatenate
+                a suffix to the RADIUS user name to convert it into an e-mail
+                address.
+                You can specify this suffix in the RADIUS_email_suffix parameter.
+                </p><p>If this simple solution does not work for you, you'll
+                probably need to modify
+                <code class="filename">Bugzilla/Auth/Verify/RADIUS.pm</code> to match your
+                requirements.
+                </p></dd></dl></div></div><div class="section" title="3.1.12. Email"><div class="titlepage"><div><div><h3 class="title"><a name="param-email"></a>3.1.12. Email</h3></div></div></div><p>
+            This page contains all of the parameters for configuring how
+            Bugzilla deals with the email notifications it sends. See below
+            for a summary of important options. 
+          </p><div class="variablelist"><dl><dt><span class="term">
+              mail_delivery_method
+            </span></dt><dd><p>
+                This is used to specify how email is sent, or if it is sent at 
+                all.  There are several options included for different MTAs, 
+                along with two additional options that disable email sending.  
+                "Test" does not send mail, but instead saves it in 
+                <code class="filename">data/mailer.testfile</code> for later review.  
+                "None" disables email sending entirely.
+              </p></dd><dt><span class="term">
+              mailfrom
+            </span></dt><dd><p>
+                This is the email address that will appear in the "From" field
+                of all emails sent by this Bugzilla installation. Some email
+                servers require mail to be from a valid email address, therefore
+                it is recommended to choose a valid email address here.
+              </p></dd><dt><span class="term">
+              smtpserver
+            </span></dt><dd><p>
+                This is the SMTP server address, if the <span class="quote">“<span class="quote">mail_delivery_method</span>”</span>
+                parameter is set to SMTP.  Use "localhost" if you have a local MTA
+                running, otherwise use a remote SMTP server.  Append ":" and the port
+                number, if a non-default port is needed.
+              </p></dd><dt><span class="term">
+              smtp_username
+            </span></dt><dd><p>
+                Username to use for SASL authentication to the SMTP server.  Leave
+                this parameter empty if your server does not require authentication.
+              </p></dd><dt><span class="term">
+              smtp_password
+            </span></dt><dd><p>
+                Password to use for SASL authentication to the SMTP server. This
+                parameter will be ignored if the <span class="quote">“<span class="quote">smtp_username</span>”</span>
+                parameter is left empty.
+              </p></dd><dt><span class="term">
+              smtp_ssl
+            </span></dt><dd><p>
+                Enable SSL support for connection to the SMTP server.
+              </p></dd><dt><span class="term">
+              smtp_debug
+            </span></dt><dd><p>
+                This parameter allows you to enable detailed debugging output.
+                Log messages are printed the web server's error log.
+              </p></dd><dt><span class="term">
+              whinedays
+            </span></dt><dd><p>
+                Set this to the number of days you want to let bugs go
+                in the CONFIRMED state before notifying people they have
+                untouched new bugs. If you do not plan to use this feature, simply 
+                do not set up the whining cron job described in the installation
+                instructions, or set this value to "0" (never whine).
+              </p></dd><dt><span class="term">
+              globalwatcher
+            </span></dt><dd><p>
+                This allows you to define specific users who will
+                receive notification each time a new bug in entered, or when
+                an existing bug changes, according to the normal groupset
+                permissions. It may be useful for sending notifications to a
+                mailing-list, for instance.
+              </p></dd></dl></div></div><div class="section" title="3.1.13. Patch Viewer"><div class="titlepage"><div><div><h3 class="title"><a name="param-patchviewer"></a>3.1.13. Patch Viewer</h3></div></div></div><p>
+            This page contains configuration parameters for the CVS server, 
+            Bonsai server and LXR server that Bugzilla will use to enable the
+            features of the Patch Viewer. Bonsai is a tool that enables queries 
+            to a CVS tree. LXR is a tool that can cross reference and index source
+            code.
+          </p></div><div class="section" title="3.1.14. Query Defaults"><div class="titlepage"><div><div><h3 class="title"><a name="param-querydefaults"></a>3.1.14. Query Defaults</h3></div></div></div><p>
+            This page controls the default behavior of Bugzilla in regards to 
+            several aspects of querying bugs. Options include what the default
+            query options are, what the "My Bugs" page returns, whether users
+            can freely add bugs to the quip list, and how many duplicate bugs are 
+            needed to add a bug to the "most frequently reported" list.
+          </p></div><div class="section" title="3.1.15. Shadow Database"><div class="titlepage"><div><div><h3 class="title"><a name="param-shadowdatabase"></a>3.1.15. Shadow Database</h3></div></div></div><p>
+            This page controls whether a shadow database is used, and all the
+            parameters associated with the shadow database. Versions of Bugzilla
+            prior to 3.2 used the MyISAM table type, which supports
+            only table-level write locking. With MyISAM, any time someone is making a change to 
+            a bug, the entire table is locked until the write operation is complete.
+            Locking for write also blocks reads until the write is complete.
+          </p><p>
+            The <span class="quote">“<span class="quote">shadowdb</span>”</span> parameter was designed to get around
+            this limitation. While only a single user is allowed to write to
+            a table at a time, reads can continue unimpeded on a read-only
+            shadow copy of the database.
+          </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+              As of version 3.2, Bugzilla no longer uses the MyISAM table type.
+              Instead, InnoDB is used, which can do transaction-based locking.
+              Therefore, the limitations the Shadow Database feature was designed
+              to workaround no longer exist.
+            </p></td></tr></table></div></div><div class="section" title="3.1.16. User Matching"><div class="titlepage"><div><div><h3 class="title"><a name="admin-usermatching"></a>3.1.16. User Matching</h3></div></div></div><p>
+            The settings on this page control how users are selected and queried
+            when adding a user to a bug. For example, users need to be selected
+            when choosing who the bug is assigned to, adding to the CC list or 
+            selecting a QA contact. With the "usemenuforusers" parameter, it is 
+            possible to configure Bugzilla to 
+            display a list of users in the fields instead of an empty text field.
+            This should only be used in Bugzilla installations with a small number
+            of users. If users are selected via a text box, this page also
+            contains parameters for how user names can be queried and matched
+            when entered.
+          </p><p>
+            Another setting called 'ajax_user_autocompletion' enables certain
+            user fields to display a list of matched user names as a drop down after typing 
+            a few characters. Note that it is recommended to use mod_perl when
+            enabling 'ajax_user_autocompletion'.
+          </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="administration.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="administration.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="useradmin.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 3. Administering Bugzilla </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.2. User Administration</td></tr></table></div></body></html>

diff --git a/docs/en/html/paranoid-security.html b/docs/en/html/paranoid-security.html
new file mode 100644 (file)
index 0000000..c2acb42
--- /dev/null
+++ b/docs/en/html/paranoid-security.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>A.5. cannot chdir(/var/spool/mqueue)</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="troubleshooting.html" title="Appendix A. Troubleshooting"><link rel="prev" href="trbl-dbdSponge.html" title="A.4. DBD::Sponge::db prepare failed"><link rel="next" href="trbl-relogin-everyone.html" title="A.6. Everybody is constantly being forced to relogin"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">A.5. cannot chdir(/var/spool/mqueue)</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="trbl-dbdSponge.html">Prev</a> </td><th width="60%" align="center">Appendix A. Troubleshooting</th><td width="20%" align="right"> <a accesskey="n" href="trbl-relogin-everyone.html">Next</a></td></tr></table><hr></div><div class="section" title="A.5. cannot chdir(/var/spool/mqueue)"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="paranoid-security"></a>A.5. cannot chdir(/var/spool/mqueue)</h2></div></div></div><p>If you are installing Bugzilla on SuSE Linux, or some other
+    distributions with <span class="quote">“<span class="quote">paranoid</span>”</span> security options, it is
+    possible that the checksetup.pl script may fail with the error: 
+</p><pre class="programlisting">cannot chdir(/var/spool/mqueue): Permission denied
+</pre><p>
+    </p><p>This is because your <code class="filename">/var/spool/mqueue</code>
+    directory has a mode of <code class="computeroutput">drwx------</code>.
+    Type <span class="command"><strong>chmod 755 <code class="filename">/var/spool/mqueue</code></strong></span>
+    as root to fix this problem. This will allow any process running on your
+    machine the ability to <span class="emphasis"><em>read</em></span> the
+    <code class="filename">/var/spool/mqueue</code> directory.
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="trbl-dbdSponge.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="troubleshooting.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="trbl-relogin-everyone.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">A.4. DBD::Sponge::db prepare failed </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> A.6. Everybody is constantly being forced to relogin</td></tr></table></div></body></html>

diff --git a/docs/en/html/patches.html b/docs/en/html/patches.html
new file mode 100644 (file)
index 0000000..0395e87
--- /dev/null
+++ b/docs/en/html/patches.html
@@ -0,0 +1,9 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Appendix B. Contrib</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="prev" href="trbl-passwd-encryption.html" title='A.8.  checksetup.pl reports "Client does not support authentication protocol requested by server..."'><link rel="next" href="cmdline.html" title="B.1. Command-line Search Interface"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix B. Contrib</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="trbl-passwd-encryption.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="cmdline.html">Next</a></td></tr></table><hr></div><div class="appendix" title="Appendix B. Contrib"><div class="titlepage"><div><div><h2 class="title"><a name="patches"></a>Appendix B. Contrib</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="cmdline.html">B.1. Command-line Search Interface</a></span></dt><dt><span class="section"><a href="cmdline-bugmail.html">B.2. Command-line 'Send Unsent Bug-mail' tool</a></span></dt></dl></div><p>
+    There are a number of unofficial Bugzilla add-ons in the 
+    <code class="filename">$BUGZILLA_ROOT/contrib/</code>
+    directory. This section documents them.
+  </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="trbl-passwd-encryption.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="cmdline.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">A.8. 
+      checksetup.pl reports "Client does not support authentication protocol
+      requested by server..."
+     </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> B.1. Command-line Search Interface</td></tr></table></div></body></html>

diff --git a/docs/en/html/products.html b/docs/en/html/products.html
new file mode 100644 (file)
index 0000000..31c57eb
--- /dev/null
+++ b/docs/en/html/products.html
@@ -0,0 +1,280 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.4. Products</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="classifications.html" title="3.3. Classifications"><link rel="next" href="components.html" title="3.5. Components"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.4. Products</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="classifications.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="components.html">Next</a></td></tr></table><hr></div><div class="section" title="3.4. Products"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="products"></a>3.4. Products</h2></div></div></div><p>
+    <a class="glossterm" href="glossary.html#gloss-product"><em class="glossterm">
+    Products</em></a> typically represent real-world
+    shipping products. Products can be given 
+    <a class="xref" href="classifications.html" title="3.3. Classifications">Classifications</a>. 
+    For example, if a company makes computer games, 
+    they could have a classification of "Games", and a separate
+    product for each game. This company might also have a 
+    <span class="quote">“<span class="quote">Common</span>”</span> product for units of technology used 
+    in multiple games, and perhaps a few special products that
+    represent items that are not actually shipping products 
+    (for example, "Website", or "Administration").
+    </p><p>
+    Many of Bugzilla's settings are configurable on a per-product
+    basis. The number of <span class="quote">“<span class="quote">votes</span>”</span> available to 
+    users is set per-product, as is the number of votes
+    required to move a bug automatically from the UNCONFIRMED 
+    status to the CONFIRMED status.
+    </p><p>
+    When creating or editing products the following options are
+    available: 
+    </p><div class="variablelist"><dl><dt><span class="term">
+          Product
+        </span></dt><dd><p> 
+            The name of the product
+          </p></dd><dt><span class="term">
+          Description
+        </span></dt><dd><p> 
+            A brief description of the product
+          </p></dd><dt><span class="term">
+          Default milestone
+        </span></dt><dd><p> 
+            Select the default milestone for this product.
+          </p></dd><dt><span class="term">
+          Closed for bug entry
+        </span></dt><dd><p> 
+            Select this box to prevent new bugs from being
+            entered against this product.
+          </p></dd><dt><span class="term">
+          Maximum votes per person
+        </span></dt><dd><p> 
+            Maximum votes a user is allowed to give for this 
+            product
+          </p></dd><dt><span class="term">
+          Maximum votes a person can put on a single bug
+        </span></dt><dd><p> 
+            Maximum votes a user is allowed to give for this 
+            product in a single bug
+          </p></dd><dt><span class="term">
+          Confirmation threshold
+        </span></dt><dd><p> 
+            Number of votes needed to automatically remove any
+            bug against this product from the UNCONFIRMED state
+          </p></dd><dt><span class="term">
+          Version
+        </span></dt><dd><p> 
+            Specify which version of the product bugs will be
+            entered against.
+          </p></dd><dt><span class="term">
+          Create chart datasets for this product
+        </span></dt><dd><p> 
+            Select to make chart datasets available for this product.
+          </p></dd></dl></div><p>
+    When editing a product there is also a link to edit Group Access Controls,
+    see <a class="xref" href="products.html#product-group-controls" title="3.4.4. Assigning Group Controls to Products">Section 3.4.4, “Assigning Group Controls to Products”</a>.
+    </p><div class="section" title="3.4.1. Creating New Products"><div class="titlepage"><div><div><h3 class="title"><a name="create-product"></a>3.4.1. Creating New Products</h3></div></div></div><p>
+    To create a new product:
+    </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p> 
+        Select <span class="quote">“<span class="quote">Administration</span>”</span> from the footer and then
+        choose <span class="quote">“<span class="quote">Products</span>”</span> from the main administration page.
+        </p></li><li class="listitem"><p>
+        Select the <span class="quote">“<span class="quote">Add</span>”</span> link in the bottom right.
+        </p></li><li class="listitem"><p>
+        Enter the name of the product and a description. The
+        Description field may contain HTML.
+        </p></li><li class="listitem"><p>
+        When the product is created, Bugzilla will give a message
+        stating that a component must be created before any bugs can
+        be entered against the new product. Follow the link to create
+        a new component. See <a class="xref" href="components.html" title="3.5. Components">Components</a> for more
+        information.
+        </p></li></ol></div></div><div class="section" title="3.4.2. Editing Products"><div class="titlepage"><div><div><h3 class="title"><a name="edit-products"></a>3.4.2. Editing Products</h3></div></div></div><p>
+      To edit an existing product, click the "Products" link from the 
+      "Administration" page. If the 'useclassification' parameter is
+      turned on, a table of existing classifications is displayed,
+      including an "Unclassified" category. The table indicates how many products
+      are in each classification. Click on the classification name to see its
+      products. If the 'useclassification' parameter is not in use, the table 
+      lists all products directly. The product table summarizes the information 
+      about the product defined
+      when the product was created. Click on the product name to edit these
+      properties, and to access links to other product attributes such as the
+      product's components, versions, milestones, and group access controls.
+      </p></div><div class="section" title="3.4.3. Adding or Editing Components, Versions and Target Milestones"><div class="titlepage"><div><div><h3 class="title"><a name="comps-vers-miles-products"></a>3.4.3. Adding or Editing Components, Versions and Target Milestones</h3></div></div></div><p>
+          To edit existing, or add new, Components, Versions or Target Milestones 
+          to a Product, select the "Edit Components", "Edit Versions" or "Edit
+          Milestones" links from the "Edit Product" page. A table of existing 
+          Components, Versions or Milestones is displayed. Click on a item name 
+          to edit the properties of that item. Below the table is a link to add 
+          a new Component, Version or Milestone. 
+        </p><p>
+          For more information on components, see <a class="xref" href="components.html" title="3.5. Components">Components</a>.
+        </p><p>
+          For more information on versions, see <a class="xref" href="versions.html" title="3.6. Versions">Section 3.6, “Versions”</a>.
+        </p><p>
+          For more information on milestones, see <a class="xref" href="milestones.html" title="3.7. Milestones">Section 3.7, “Milestones”</a>.
+        </p></div><div class="section" title="3.4.4. Assigning Group Controls to Products"><div class="titlepage"><div><div><h3 class="title"><a name="product-group-controls"></a>3.4.4. Assigning Group Controls to Products</h3></div></div></div><p> 
+        On the <span class="quote">“<span class="quote">Edit Product</span>”</span> page, there is a link called 
+        <span class="quote">“<span class="quote">Edit Group Access Controls</span>”</span>. The settings on this page 
+        control the relationship of the groups to the product being edited.
+        </p><p>
+        Group Access Controls are an important aspect of using groups for 
+        isolating products and restricting access to bugs filed against those
+        products. For more information on groups, including how to create, edit
+        add users to, and alter permission of, see <a class="xref" href="groups.html" title="3.15. Groups and Group Security">Section 3.15, “Groups and Group Security”</a>.
+        </p><p>
+        After selecting the "Edit Group Access Controls" link from the "Edit
+        Product" page, a table containing all user-defined groups for this 
+        Bugzilla installation is displayed. The system groups that are created
+        when Bugzilla is installed are not applicable to Group Access Controls.
+        Below is description of what each of these fields means.
+        </p><p>
+        Groups may be applicable (e.g bugs in this product can be associated
+        with this group) , default (e.g. bugs in this product are in this group
+        by default), and mandatory (e.g. bugs in this product must be associated
+        with this group) for each product. Groups can also control access 
+        to bugs for a given product, or be used to make bugs for a product 
+        totally read-only unless the group restrictions are met. The best way to
+        understand these relationships is by example. See 
+        <a class="xref" href="products.html#group-control-examples" title="3.4.4.1. Common Applications of Group Controls">Section 3.4.4.1, “Common Applications of Group Controls”</a> for examples of 
+        product and group relationships.
+        </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            Products and Groups are not limited to a one-to-one relationship. 
+            Multiple groups can be associated with the same product, and groups
+            can be associated with more than one product. 
+          </p></td></tr></table></div><p>
+        If any group has <span class="emphasis"><em>Entry</em></span> selected, then the 
+        product will restrict bug entry to only those users 
+        who are members of <span class="emphasis"><em>all</em></span> the groups with 
+        <span class="emphasis"><em>Entry</em></span> selected.
+        </p><p>
+        If any group has <span class="emphasis"><em>Canedit</em></span> selected, 
+        then the product will be read-only for any users 
+        who are not members of <span class="emphasis"><em>all</em></span> of the groups with
+        <span class="emphasis"><em>Canedit</em></span> selected. <span class="emphasis"><em>Only</em></span> users who 
+        are members of all the <span class="emphasis"><em>Canedit</em></span> groups 
+        will be able to edit bugs for this product. This is an additional 
+        restriction that enables finer-grained control over products rather 
+        than just all-or-nothing access levels.
+        </p><p>
+        The following settings let you 
+        choose privileges on a <span class="emphasis"><em>per-product basis</em></span>.
+        This is a convenient way to give privileges to 
+        some users for some products only, without having 
+        to give them global privileges which would affect 
+        all products.
+        </p><p>
+        Any group having <span class="emphasis"><em>editcomponents</em></span> 
+        selected  allows users who are in this group to edit all 
+        aspects of this product, including components, milestones 
+        and versions.
+        </p><p>
+        Any group having <span class="emphasis"><em>canconfirm</em></span> selected 
+        allows users who are in this group to confirm bugs 
+        in this product.
+        </p><p>
+        Any group having <span class="emphasis"><em>editbugs</em></span> selected allows 
+        users who are in this group to edit all fields of 
+        bugs in this product.
+        </p><p>
+        The <span class="emphasis"><em>MemberControl</em></span> and 
+        <span class="emphasis"><em>OtherControl</em></span> are used in tandem to determine which 
+        bugs will be placed in this group. The only allowable combinations of
+        these two parameters are listed in a table on the "Edit Group Access Controls"
+        page. Consult this table for details on how these fields can be used.
+        Examples of different uses are described below.
+        </p><div class="section" title="3.4.4.1. Common Applications of Group Controls"><div class="titlepage"><div><div><h4 class="title"><a name="group-control-examples"></a>3.4.4.1. Common Applications of Group Controls</h4></div></div></div><p>
+        The use of groups is best explained by providing examples that illustrate
+        configurations for common use cases. The examples follow a common syntax:
+        <span class="emphasis"><em>Group: Entry, MemberControl, OtherControl, CanEdit,
+        EditComponents, CanConfirm, EditBugs</em></span>. Where "Group" is the name
+        of the group being edited for this product. The other fields all
+        correspond to the table on the "Edit Group Access Controls" page. If any
+        of these options are not listed, it means they are not checked.      
+      </p><p>
+            Basic Product/Group Restriction
+          </p><p>
+          Suppose there is a product called "Bar". The 
+          "Bar" product can only have bugs entered against it by users in the
+          group "Foo". Additionally, bugs filed against product "Bar" must stay
+          restricted to users to "Foo" at all times. Furthermore, only members
+          of group "Foo" can edit bugs filed against product "Bar", even if other
+          users could see the bug. This arrangement would achieved by the
+          following:
+        </p><pre class="programlisting">
+Product Bar: 
+foo: ENTRY, MANDATORY/MANDATORY, CANEDIT
+        </pre><p>
+          Perhaps such strict restrictions are not needed for product "Bar". A 
+          more lenient way to configure product "Bar" and group "Foo" would be:
+        </p><pre class="programlisting">
+Product Bar: 
+foo: ENTRY, SHOWN/SHOWN, EDITCOMPONENTS, CANCONFIRM, EDITBUGS
+        </pre><p>
+          The above indicates that for product "Bar", members of group "Foo" can
+          enter bugs. Any one with permission to edit a bug against product "Bar"
+          can put the bug
+          in group "Foo", even if they themselves are not in "Foo". Anyone in group
+          "Foo" can edit all aspects of the components of product "Bar", can confirm
+          bugs against product "Bar", and can edit all fields of any bug against
+          product "Bar".
+        </p><p>
+            General User Access With Security Group
+          </p><p>
+               To permit any user to file bugs against "Product A",
+               and to permit any user to submit those bugs into a
+               group called "Security":  
+            </p><pre class="programlisting"> 
+Product A:
+security: SHOWN/SHOWN
+      </pre><p>
+            General User Access With A Security Product
+          </p><p>
+            To permit any user to file bugs against product called "Security"
+            while keeping those bugs from becoming visible to anyone
+            outside the group "SecurityWorkers" (unless a member of the
+            "SecurityWorkers" group removes that restriction):
+          </p><pre class="programlisting"> 
+Product Security:
+securityworkers: DEFAULT/MANDATORY
+          </pre><p>
+            Product Isolation With a Common Group
+          </p><p>
+            To permit users of "Product A" to access the bugs for
+            "Product A", users of "Product B" to access the bugs for 
+            "Product B", and support staff, who are members of the "Support 
+            Group" to access both, three groups are needed:
+          </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Support Group: Contains members of the support staff.</p></li><li class="listitem"><p>AccessA Group: Contains users of product A and the Support group.</p></li><li class="listitem"><p>AccessB Group: Contains users of product B and the Support group.</p></li></ol></div><p>
+            Once these three groups are defined, the product group controls
+            can be set to:
+          </p><pre class="programlisting">
+Product A:
+AccessA: ENTRY, MANDATORY/MANDATORY
+Product B:
+AccessB: ENTRY, MANDATORY/MANDATORY
+        </pre><p>
+         Perhaps the "Support Group" wants more control. For example, 
+         the "Support Group"  could be permitted to make bugs inaccessible to 
+         users of both groups "AccessA" and "AccessB". 
+         Then, the "Support Group" could be permitted to publish
+         bugs relevant to all users in a third product (let's call it 
+         "Product Common") that is read-only
+         to anyone outside the "Support Group". In this way the "Support Group" 
+         could control bugs that should be seen by both groups. 
+         That configuration would be:
+        </p><pre class="programlisting">
+Product A:
+AccessA: ENTRY, MANDATORY/MANDATORY
+Support: SHOWN/NA
+Product B:
+AccessB: ENTRY, MANDATORY/MANDATORY
+Support: SHOWN/NA
+Product Common:
+Support: ENTRY, DEFAULT/MANDATORY, CANEDIT
+      </pre><p>
+            Make a Product Read Only
+          </p><p>
+            Sometimes a product is retired and should no longer have
+            new bugs filed against it (for example, an older version of a software
+            product that is no longer supported). A product can be made read-only
+            by creating a group called "readonly" and adding products to the
+            group as needed:
+          </p><pre class="programlisting">
+Product A:
+ReadOnly: ENTRY, NA/NA, CANEDIT
+         </pre><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            For more information on Groups outside of how they relate to products
+            see <a class="xref" href="groups.html" title="3.15. Groups and Group Security">Section 3.15, “Groups and Group Security”</a>.
+          </p></td></tr></table></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="classifications.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="administration.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="components.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.3. Classifications </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.5. Components</td></tr></table></div></body></html>

diff --git a/docs/en/html/query.html b/docs/en/html/query.html
new file mode 100644 (file)
index 0000000..27079fc
--- /dev/null
+++ b/docs/en/html/query.html
@@ -0,0 +1,186 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>5.5. Searching for Bugs</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="prev" href="lifecycle.html" title="5.4. Life Cycle of a Bug"><link rel="next" href="bugreports.html" title="5.6. Filing Bugs"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.5. Searching for Bugs</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="lifecycle.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Using Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="bugreports.html">Next</a></td></tr></table><hr></div><div class="section" title="5.5. Searching for Bugs"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="query"></a>5.5. Searching for Bugs</h2></div></div></div><p>The Bugzilla Search page is the interface where you can find
+    any bug report, comment, or patch currently in the Bugzilla system. You
+    can play with it here: 
+    <a class="ulink" href="http://landfill.bugzilla.org/bugzilla-tip/query.cgi" target="_top">http://landfill.bugzilla.org/bugzilla-tip/query.cgi</a>.</p><p>The Search page has controls for selecting different possible
+    values for all of the fields in a bug, as described above. For some
+    fields, multiple values can be selected. In those cases, Bugzilla
+    returns bugs where the content of the field matches any one of the selected
+    values. If none is selected, then the field can take any value.</p><p>
+      After a search is run, you can save it as a Saved Search, which
+      will appear in the page footer. If you are in the group defined 
+      by the "querysharegroup" parameter, you may share your queries 
+      with other users, see <a class="xref" href="userpreferences.html#savedsearches" title="5.10.3. Saved Searches">Saved Searches</a> for more details.
+    </p><div class="section" title="5.5.1. Boolean Charts"><div class="titlepage"><div><div><h3 class="title"><a name="boolean"></a>5.5.1. Boolean Charts</h3></div></div></div><p>
+        Highly advanced querying is done using Boolean Charts.
+      </p><p>
+        The boolean charts further restrict the set of results
+        returned by a query. It is possible to search for bugs
+        based on elaborate combinations of criteria.
+      </p><p>
+        The simplest boolean searches have only one term. These searches
+        permit the selected left <span class="emphasis"><em>field</em></span>
+        to be compared using a
+        selectable <span class="emphasis"><em>operator</em></span> to a
+        specified <span class="emphasis"><em>value.</em></span>
+        Using the "And," "Or," and "Add Another Boolean Chart" buttons, 
+        additional terms can be included in the query, further
+        altering the list of bugs returned by the query.
+      </p><p>
+        There are three fields in each row of a boolean search. 
+      </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
+            <span class="emphasis"><em>Field:</em></span>
+            the items being searched 
+          </p></li><li class="listitem"><p>
+            <span class="emphasis"><em>Operator:</em></span>
+            the comparison operator 
+          </p></li><li class="listitem"><p>
+            <span class="emphasis"><em>Value:</em></span>
+            the value to which the field is being compared
+          </p></li></ul></div><div class="section" title="5.5.1.1. Pronoun Substitution"><div class="titlepage"><div><div><h4 class="title"><a name="pronouns"></a>5.5.1.1. Pronoun Substitution</h4></div></div></div><p>
+          Sometimes, a query needs to compare a user-related field
+          (such as ReportedBy) with a role-specific user (such as the
+          user running the query or the user to whom each bug is assigned).
+          When the operator is either "equals" or "notequals", the value
+          can be "%reporter%", "%assignee%", "%qacontact%", or "%user%".
+          The user pronoun
+          refers to the user who is executing the query or, in the case
+          of whining reports, the user who will be the recipient
+          of the report. The reporter, assignee, and qacontact
+          pronouns refer to the corresponding fields in the bug.
+        </p><p>
+          Boolean charts also let you type a group name in any user-related
+          field if the operator is either "equals", "notequals" or "anyexact".
+          This will let you query for any member belonging (or not) to the
+          specified group. The group name must be entered following the
+          "%group.foo%" syntax, where "foo" is the group name.
+          So if you are looking for bugs reported by any user being in the
+          "editbugs" group, then you can type "%group.editbugs%".
+        </p></div><div class="section" title="5.5.1.2. Negation"><div class="titlepage"><div><div><h4 class="title"><a name="negation"></a>5.5.1.2. Negation</h4></div></div></div><p>
+          At first glance, negation seems redundant. Rather than
+          searching for
+          </p><div class="blockquote"><blockquote class="blockquote"><p>
+              NOT("summary" "contains the string" "foo"),
+            </p></blockquote></div><p>
+          one could search for 
+          </p><div class="blockquote"><blockquote class="blockquote"><p>
+              ("summary" "does not contain the string" "foo").
+            </p></blockquote></div><p>
+          However, the search 
+          </p><div class="blockquote"><blockquote class="blockquote"><p>
+              ("CC" "does not contain the string" "@mozilla.org")
+            </p></blockquote></div><p>
+          would find every bug where anyone on the CC list did not contain 
+          "@mozilla.org" while
+          </p><div class="blockquote"><blockquote class="blockquote"><p>
+              NOT("CC" "contains the string" "@mozilla.org")
+            </p></blockquote></div><p>
+          would find every bug where there was nobody on the CC list who
+          did contain the string. Similarly, the use of negation also permits
+          complex expressions to be built using terms OR'd together and then
+          negated. Negation permits queries such as
+          </p><div class="blockquote"><blockquote class="blockquote"><p>
+              NOT(("product" "equals" "update") OR 
+            ("component" "equals" "Documentation"))
+            </p></blockquote></div><p>
+          to find bugs that are neither 
+          in the update product or in the documentation component or
+          </p><div class="blockquote"><blockquote class="blockquote"><p>
+              NOT(("commenter" "equals" "%assignee%") OR 
+              ("component" "equals" "Documentation"))
+            </p></blockquote></div><p>
+          to find non-documentation
+          bugs on which the assignee has never commented.
+        </p></div><div class="section" title="5.5.1.3. Multiple Charts"><div class="titlepage"><div><div><h4 class="title"><a name="multiplecharts"></a>5.5.1.3. Multiple Charts</h4></div></div></div><p>
+          The terms within a single row of a boolean chart are all
+          constraints on a single piece of data. If you are looking for
+          a bug that has two different people cc'd on it, then you need 
+          to use two boolean charts. A search for
+          </p><div class="blockquote"><blockquote class="blockquote"><p>
+              ("cc" "contains the string" "foo@") AND
+              ("cc" "contains the string" "@mozilla.org")
+            </p></blockquote></div><p>
+          would return only bugs with "foo@mozilla.org" on the cc list.
+          If you wanted bugs where there is someone on the cc list
+          containing "foo@" and someone else containing "@mozilla.org",
+          then you would need two boolean charts.
+          </p><div class="blockquote"><blockquote class="blockquote"><p>
+              First chart: ("cc" "contains the string" "foo@")
+            </p><p>
+              Second chart: ("cc" "contains the string" "@mozilla.org")
+            </p></blockquote></div><p>
+          The bugs listed will be only the bugs where ALL the charts are true.
+        </p></div></div><div class="section" title="5.5.2. Quicksearch"><div class="titlepage"><div><div><h3 class="title"><a name="quicksearch"></a>5.5.2. Quicksearch</h3></div></div></div><p>
+        Quicksearch is a single-text-box query tool which uses
+        metacharacters to indicate what is to be searched. For example, typing
+        "<code class="literal">foo|bar</code>"
+        into Quicksearch would search for "foo" or "bar" in the
+        summary and status whiteboard of a bug; adding
+        "<code class="literal">:BazProduct</code>" would
+        search only in that product.
+        You can use it to find a bug by its number or its alias, too.
+      </p><p>
+        You'll find the Quicksearch box in Bugzilla's footer area.
+        On Bugzilla's front page, there is an additional
+        <a class="ulink" href="../../page.cgi?id=quicksearch.html" target="_top">Help</a>
+        link which details how to use it.
+      </p></div><div class="section" title="5.5.3. Case Sensitivity in Searches"><div class="titlepage"><div><div><h3 class="title"><a name="casesensitivity"></a>5.5.3. Case Sensitivity in Searches</h3></div></div></div><p>
+      Bugzilla queries are case-insensitive and accent-insensitive, when
+      used with either MySQL or Oracle databases. When using Bugzilla with
+      PostgreSQL, however, some queries are case-sensitive. This is due to
+      the way PostgreSQL handles case and accent sensitivity. 
+      </p></div><div class="section" title="5.5.4. Bug Lists"><div class="titlepage"><div><div><h3 class="title"><a name="list"></a>5.5.4. Bug Lists</h3></div></div></div><p>If you run a search, a list of matching bugs will be returned.
+      </p><p>The format of the list is configurable. For example, it can be
+      sorted by clicking the column headings. Other useful features can be
+      accessed using the links at the bottom of the list:
+        </p><div class="variablelist"><dl><dt><span class="term">Long Format:</span></dt><dd><p>
+                this gives you a large page with a non-editable summary of the fields
+                of each bug.
+              </p></dd><dt><span class="term">XML:</span></dt><dd><p>
+                get the buglist in the XML format.
+              </p></dd><dt><span class="term">CSV:</span></dt><dd><p>
+                get the buglist as comma-separated values, for import into e.g.
+                a spreadsheet.
+              </p></dd><dt><span class="term">Feed:</span></dt><dd><p>
+                get the buglist as an Atom feed.  Copy this link into your
+                favorite feed reader.  If you are using Firefox, you can also
+                save the list as a live bookmark by clicking the live bookmark
+                icon in the status bar.  To limit the number of bugs in the feed,
+                add a limit=n parameter to the URL.
+              </p></dd><dt><span class="term">iCalendar:</span></dt><dd><p>
+                Get the buglist as an iCalendar file. Each bug is represented as a
+                to-do item in the imported calendar.
+              </p></dd><dt><span class="term">Change Columns:</span></dt><dd><p>
+                change the bug attributes which appear in the list.
+              </p></dd><dt><span class="term">Change several bugs at once:</span></dt><dd><p>
+                If your account is sufficiently empowered, and more than one bug
+                appear in the bug list, this link is displayed which lets you make
+                the same change to all the bugs in the list - for example, changing
+                their assignee.
+              </p></dd><dt><span class="term">Send mail to bug assignees:</span></dt><dd><p>
+                If more than one bug appear in the bug list and there are at least
+                two distinct bug assignees, this links is displayed which lets you
+                easily send a mail to the assignees of all bugs on the list.
+              </p></dd><dt><span class="term">Edit Search:</span></dt><dd><p>
+                If you didn't get exactly the results you were looking for, you can
+                return to the Query page through this link and make small revisions
+                to the query you just made so you get more accurate results.
+              </p></dd><dt><span class="term">Remember Search As:</span></dt><dd><p>
+                You can give a search a name and remember it; a link will appear
+                in your page footer giving you quick access to run it again later.
+              </p></dd></dl></div><p>
+      </p></div><div class="section" title="5.5.5. Adding/removing tags to/from bugs"><div class="titlepage"><div><div><h3 class="title"><a name="individual-buglists"></a>5.5.5. Adding/removing tags to/from bugs</h3></div></div></div><p>
+        You can add and remove tags from individual bugs, which let you find and
+        manage bugs more easily. Tags are per-user and so are only visible and editable
+        by the user who created them. You can then run queries using tags as a criteria,
+        either by using the Advanced Search form, or simply by typing "tag:my_tag_name"
+        in the QuickSearch box at the top (or bottom) of the page. Tags can also be
+        displayed in buglists.
+      </p><p>
+        This feature is useful when you want to keep track of several bugs, but
+        for different reasons. Instead of adding yourself to the CC list of all
+        these bugs and mixing all these reasons, you can now store these bugs in
+        separate lists, e.g. <span class="quote">“<span class="quote">Keep in mind</span>”</span>, <span class="quote">“<span class="quote">Interesting bugs</span>”</span>,
+        or <span class="quote">“<span class="quote">Triage</span>”</span>. One big advantage of this way to manage bugs
+        is that you can easily add or remove tags from bugs one by one.
+      </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="lifecycle.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="using.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="bugreports.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5.4. Life Cycle of a Bug </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 5.6. Filing Bugs</td></tr></table></div></body></html>

diff --git a/docs/en/html/quips.html b/docs/en/html/quips.html
new file mode 100644 (file)
index 0000000..aa3997e
--- /dev/null
+++ b/docs/en/html/quips.html
@@ -0,0 +1,36 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.14. Quips</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="voting.html" title="3.13. Voting"><link rel="next" href="groups.html" title="3.15. Groups and Group Security"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.14. Quips</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="voting.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="groups.html">Next</a></td></tr></table><hr></div><div class="section" title="3.14. Quips"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="quips"></a>3.14. Quips</h2></div></div></div><p>
+      Quips are small text messages that can be configured to appear
+      next to search results. A Bugzilla installation can have its own specific
+      quips. Whenever a quip needs to be displayed, a random selection
+      is made from the pool of already existing quips.
+    </p><p>
+      Quip submission is controlled by the <span class="emphasis"><em>quip_list_entry_control</em></span>
+      parameter.  It has several possible values: open, moderated, or closed.
+      In order to enable quips approval you need to set this parameter to
+      "moderated". In this way, users are free to submit quips for addition
+      but an administrator must explicitly approve them before they are
+      actually used.
+    </p><p>
+      In order to see the user interface for the quips, it is enough to click
+      on a quip when it is displayed together with the search results. Or
+      it can be seen directly in the browser by visiting the quips.cgi URL
+      (prefixed with the usual web location of the Bugzilla installation).
+      Once the quip interface is displayed, it is enough to click the
+      "view and edit the whole quip list" in order to see the administration
+      page. A page with all the quips available in the database will
+      be displayed.
+    </p><p>
+      Next to each quip there is a checkbox, under the
+      "Approved" column. Quips who have this checkbox checked are
+      already approved and will appear next to the search results.
+      The ones that have it unchecked are still preserved in the
+      database but they will not appear on search results pages.
+      User submitted quips have initially the checkbox unchecked.
+    </p><p>
+      Also, there is a delete link next to each quip,
+      which can be used in order to permanently delete a quip.
+    </p><p>
+      Display of quips is controlled by the <span class="emphasis"><em>display_quips</em></span>
+      user preference.  Possible values are "on" and "off".
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="voting.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="administration.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="groups.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.13. Voting </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.15. Groups and Group Security</td></tr></table></div></body></html>

diff --git a/docs/en/html/reporting.html b/docs/en/html/reporting.html
new file mode 100644 (file)
index 0000000..eb726d2
--- /dev/null
+++ b/docs/en/html/reporting.html
@@ -0,0 +1,96 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>5.11. Reports and Charts</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="prev" href="userpreferences.html" title="5.10. User Preferences"><link rel="next" href="flags.html" title="5.12. Flags"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.11. Reports and Charts</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="userpreferences.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Using Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="flags.html">Next</a></td></tr></table><hr></div><div class="section" title="5.11. Reports and Charts"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="reporting"></a>5.11. Reports and Charts</h2></div></div></div><p>As well as the standard buglist, Bugzilla has two more ways of
+    viewing sets of bugs. These are the reports (which give different
+    views of the current state of the database) and charts (which plot
+    the changes in particular sets of bugs over time.)</p><div class="section" title="5.11.1. Reports"><div class="titlepage"><div><div><h3 class="title"><a name="reports"></a>5.11.1. Reports</h3></div></div></div><p>
+        A report is a view of the current state of the bug database.
+      </p><p>
+        You can run either an HTML-table-based report, or a graphical
+        line/pie/bar-chart-based one. The two have different pages to
+        define them, but are close cousins - once you've defined and
+        viewed a report, you can switch between any of the different
+        views of the data at will.
+      </p><p>
+        Both report types are based on the idea of defining a set of bugs
+        using the standard search interface, and then choosing some
+        aspect of that set to plot on the horizontal and/or vertical axes.
+        You can also get a form of 3-dimensional report by choosing to have
+        multiple images or tables.
+      </p><p>
+        So, for example, you could use the search form to choose "all
+        bugs in the WorldControl product", and then plot their severity
+        against their component to see which component had had the largest
+        number of bad bugs reported against it. 
+      </p><p>
+        Once you've defined your parameters and hit "Generate Report",
+        you can switch between HTML, CSV, Bar, Line and Pie. (Note: Pie
+        is only available if you didn't define a vertical axis, as pie
+        charts don't have one.) The other controls are fairly self-explanatory;
+        you can change the size of the image if you find text is overwriting
+        other text, or the bars are too thin to see.
+      </p></div><div class="section" title="5.11.2. Charts"><div class="titlepage"><div><div><h3 class="title"><a name="charts"></a>5.11.2. Charts</h3></div></div></div><p>
+        A chart is a view of the state of the bug database over time.
+      </p><p>
+        Bugzilla currently has two charting systems - Old Charts and New 
+        Charts. Old Charts have been part of Bugzilla for a long time; they
+        chart each status and resolution for each product, and that's all.
+        They are deprecated, and going away soon - we won't say any more 
+        about them.
+        New Charts are the future - they allow you to chart anything you
+        can define as a search.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Both charting forms require the administrator to set up the
+          data-gathering script. If you can't see any charts, ask them whether
+          they have done so.
+        </p></td></tr></table></div><p>
+        An individual line on a chart is called a data set.
+        All data sets are organised into categories and subcategories. The 
+        data sets that Bugzilla defines automatically use the Product name 
+        as a Category and Component names as Subcategories, but there is no 
+        need for you to follow that naming scheme with your own charts if 
+        you don't want to.
+      </p><p>
+        Data sets may be public or private. Everyone sees public data sets in
+        the list, but only their creator sees private data sets. Only 
+        administrators can make data sets public.
+        No two data sets, even two private ones, can have the same set of 
+        category, subcategory and name. So if you are creating private data 
+        sets, one idea is to have the Category be your username.
+      </p><div class="section" title="5.11.2.1. Creating Charts"><div class="titlepage"><div><div><h4 class="title"><a name="idp7718528"></a>5.11.2.1. Creating Charts</h4></div></div></div><p>
+          You create a chart by selecting a number of data sets from the
+          list, and pressing Add To List for each. In the List Of Data Sets
+          To Plot, you can define the label that data set will have in the
+          chart's legend, and also ask Bugzilla to Sum a number of data sets 
+          (e.g. you could Sum data sets representing RESOLVED, VERIFIED and 
+          CLOSED in a particular product to get a data set representing all 
+          the resolved bugs in that product.)
+        </p><p>
+          If you've erroneously added a data set to the list, select it
+          using the checkbox and click Remove. Once you add more than one 
+          data set, a "Grand Total" line
+          automatically appears at the bottom of the list. If you don't want
+          this, simply remove it as you would remove any other line.
+        </p><p>
+          You may also choose to plot only over a certain date range, and
+          to cumulate the results - that is, to plot each one using the 
+          previous one as a baseline, so the top line gives a sum of all 
+          the data sets. It's easier to try than to explain :-)
+        </p><p>
+          Once a data set is in the list, one can also perform certain 
+          actions on it. For example, one can edit the
+          data set's parameters (name, frequency etc.) if it's one you
+          created or if you are an administrator.
+        </p><p>
+           Once you are happy, click Chart This List to see the chart.
+        </p></div><div class="section" title="5.11.2.2. Creating New Data Sets"><div class="titlepage"><div><div><h4 class="title"><a name="charts-new-series"></a>5.11.2.2. Creating New Data Sets</h4></div></div></div><p>
+          You may also create new data sets of your own. To do this,
+          click the "create a new data set" link on the Create Chart page.
+          This takes you to a search-like interface where you can define
+          the search that Bugzilla will plot. At the bottom of the page,
+          you choose the category, sub-category and name of your new
+          data set. 
+        </p><p>
+          If you have sufficient permissions, you can make the data set public,
+          and reduce the frequency of data collection to less than the default
+          seven days.
+        </p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="userpreferences.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="using.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="flags.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5.10. User Preferences </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 5.12. Flags</td></tr></table></div></body></html>

diff --git a/docs/en/html/sanitycheck.html b/docs/en/html/sanitycheck.html
new file mode 100644 (file)
index 0000000..1a800b3
--- /dev/null
+++ b/docs/en/html/sanitycheck.html
@@ -0,0 +1,27 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.16. Checking and Maintaining Database Integrity</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="groups.html" title="3.15. Groups and Group Security"><link rel="next" href="security.html" title="Chapter 4. Bugzilla Security"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.16. Checking and Maintaining Database Integrity</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="groups.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="security.html">Next</a></td></tr></table><hr></div><div class="section" title="3.16. Checking and Maintaining Database Integrity"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sanitycheck"></a>3.16. Checking and Maintaining Database Integrity</h2></div></div></div><p>
+    Over time it is possible for the Bugzilla database to become corrupt
+    or to have anomalies.
+    This could happen through normal usage of Bugzilla, manual database
+    administration outside of the Bugzilla user interface, or from some
+    other unexpected event. Bugzilla includes a "Sanity Check" script that
+    can perform several basic database checks, and repair certain problems or
+    inconsistencies. 
+    </p><p>
+    To run the "Sanity Check" script, log in as an Administrator and click the
+    "Sanity Check" link in the admin page. Any problems that are found will be
+    displayed in red letters. If the script is capable of fixing a problem,
+    it will present a link to initiate the fix. If the script cannot
+    fix the problem it will require manual database administration or recovery.
+    </p><p>
+    The "Sanity Check" script can also be run from the command line via the perl
+    script <code class="filename">sanitycheck.pl</code>. The script can also be run as
+    a <span class="command"><strong>cron</strong></span> job. Results will be delivered by email.
+    </p><p>
+    The "Sanity Check" script should be run on a regular basis as a matter of
+    best practice.
+    </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+      The "Sanity Check" script is no substitute for a competent database
+      administrator. It is only designed to check and repair basic database
+      problems.
+      </p></td></tr></table></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="groups.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="administration.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="security.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.15. Groups and Group Security </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 4. Bugzilla Security</td></tr></table></div></body></html>

diff --git a/docs/en/html/security-bugzilla.html b/docs/en/html/security-bugzilla.html
new file mode 100644 (file)
index 0000000..bcd2e7a
--- /dev/null
+++ b/docs/en/html/security-bugzilla.html
@@ -0,0 +1,17 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>4.3. Bugzilla</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="security.html" title="Chapter 4. Bugzilla Security"><link rel="prev" href="security-webserver.html" title="4.2. Web server"><link rel="next" href="using.html" title="Chapter 5. Using Bugzilla"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.3. Bugzilla</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="security-webserver.html">Prev</a> </td><th width="60%" align="center">Chapter 4. Bugzilla Security</th><td width="20%" align="right"> <a accesskey="n" href="using.html">Next</a></td></tr></table><hr></div><div class="section" title="4.3. Bugzilla"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="security-bugzilla"></a>4.3. Bugzilla</h2></div></div></div><div class="section" title="4.3.1. Prevent users injecting malicious Javascript"><div class="titlepage"><div><div><h3 class="title"><a name="security-bugzilla-charset"></a>4.3.1. Prevent users injecting malicious Javascript</h3></div></div></div><p>If you installed Bugzilla version 2.22 or later from scratch,
+      then the <span class="emphasis"><em>utf8</em></span> parameter is switched on by default.
+      This makes Bugzilla explicitly set the character encoding, following
+      <a class="ulink" href="http://www.cert.org/tech_tips/malicious_code_mitigation.html#3" target="_top">a
+      CERT advisory</a> recommending exactly this.
+      The following therefore does not apply to you; just keep
+      <span class="emphasis"><em>utf8</em></span> turned on.
+      </p><p>If you've upgraded from an older version, then it may be possible
+      for a Bugzilla user to take advantage of character set encoding
+      ambiguities to inject HTML into Bugzilla comments.
+      This could include malicious scripts. 
+      This is because due to internationalization concerns, we are unable to
+      turn the <span class="emphasis"><em>utf8</em></span> parameter on by default for upgraded
+      installations.
+      Turning it on manually will prevent this problem.
+      </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="security-webserver.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="security.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="using.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.2. Web server </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 5. Using Bugzilla</td></tr></table></div></body></html>

diff --git a/docs/en/html/security-os.html b/docs/en/html/security-os.html
new file mode 100644 (file)
index 0000000..46cc3ed
--- /dev/null
+++ b/docs/en/html/security-os.html
@@ -0,0 +1,33 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>4.1. Operating System</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="security.html" title="Chapter 4. Bugzilla Security"><link rel="prev" href="security.html" title="Chapter 4. Bugzilla Security"><link rel="next" href="security-webserver.html" title="4.2. Web server"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.1. Operating System</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="security.html">Prev</a> </td><th width="60%" align="center">Chapter 4. Bugzilla Security</th><td width="20%" align="right"> <a accesskey="n" href="security-webserver.html">Next</a></td></tr></table><hr></div><div class="section" title="4.1. Operating System"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="security-os"></a>4.1. Operating System</h2></div></div></div><div class="section" title="4.1.1. TCP/IP Ports"><div class="titlepage"><div><div><h3 class="title"><a name="security-os-ports"></a>4.1.1. TCP/IP Ports</h3></div></div></div><p>The TCP/IP standard defines more than 65,000 ports for sending
+      and receiving traffic. Of those, Bugzilla needs exactly one to operate
+      (different configurations and options may require up to 3). You should
+      audit your server and make sure that you aren't listening on any ports
+      you don't need to be. It's also highly recommended that the server
+      Bugzilla resides on, along with any other machines you administer, be
+      placed behind some kind of firewall.
+      </p></div><div class="section" title="4.1.2. System User Accounts"><div class="titlepage"><div><div><h3 class="title"><a name="security-os-accounts"></a>4.1.2. System User Accounts</h3></div></div></div><p>Many <a class="glossterm" href="glossary.html#gloss-daemon"><em class="glossterm">daemons</em></a>, such
+      as Apache's <code class="filename">httpd</code> or MySQL's
+      <code class="filename">mysqld</code>, run as either <span class="quote">“<span class="quote">root</span>”</span> or
+      <span class="quote">“<span class="quote">nobody</span>”</span>. This is even worse on Windows machines where the
+      majority of <a class="glossterm" href="glossary.html#gloss-service"><em class="glossterm">services</em></a>
+      run as <span class="quote">“<span class="quote">SYSTEM</span>”</span>. While running as <span class="quote">“<span class="quote">root</span>”</span> or
+      <span class="quote">“<span class="quote">SYSTEM</span>”</span> introduces obvious security concerns, the
+      problems introduced by running everything as <span class="quote">“<span class="quote">nobody</span>”</span> may
+      not be so obvious. Basically, if you run every daemon as
+      <span class="quote">“<span class="quote">nobody</span>”</span> and one of them gets compromised it can
+      compromise every other daemon running as <span class="quote">“<span class="quote">nobody</span>”</span> on your
+      machine. For this reason, it is recommended that you create a user
+      account for each daemon.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>You will need to set the <code class="option">webservergroup</code> option
+        in <code class="filename">localconfig</code> to the group your web server runs
+        as. This will allow <code class="filename">./checksetup.pl</code> to set file
+        permissions on Unix systems so that nothing is world-writable.
+        </p></td></tr></table></div></div><div class="section" title="4.1.3. The chroot Jail"><div class="titlepage"><div><div><h3 class="title"><a name="security-os-chroot"></a>4.1.3. The <code class="filename">chroot</code> Jail</h3></div></div></div><p>
+        If your system supports it, you may wish to consider running
+        Bugzilla inside of a <code class="filename">chroot</code> jail. This option
+        provides unprecedented security by restricting anything running
+        inside the jail from accessing any information outside of it. If you
+        wish to use this option, please consult the documentation that came
+        with your system.
+      </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="security.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="security.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="security-webserver.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 4. Bugzilla Security </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 4.2. Web server</td></tr></table></div></body></html>

diff --git a/docs/en/html/security-webserver.html b/docs/en/html/security-webserver.html
new file mode 100644 (file)
index 0000000..bb642c6
--- /dev/null
+++ b/docs/en/html/security-webserver.html
@@ -0,0 +1,31 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>4.2. Web server</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="security.html" title="Chapter 4. Bugzilla Security"><link rel="prev" href="security-os.html" title="4.1. Operating System"><link rel="next" href="security-bugzilla.html" title="4.3. Bugzilla"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.2. Web server</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="security-os.html">Prev</a> </td><th width="60%" align="center">Chapter 4. Bugzilla Security</th><td width="20%" align="right"> <a accesskey="n" href="security-bugzilla.html">Next</a></td></tr></table><hr></div><div class="section" title="4.2. Web server"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="security-webserver"></a>4.2. Web server</h2></div></div></div><div class="section" title="4.2.1. Disabling Remote Access to Bugzilla Configuration Files"><div class="titlepage"><div><div><h3 class="title"><a name="security-webserver-access"></a>4.2.1. Disabling Remote Access to Bugzilla Configuration Files</h3></div></div></div><p>
+        There are many files that are placed in the Bugzilla directory
+        area that should not be accessible from the web server. Because of the way
+        Bugzilla is currently layed out, the list of what should and should not
+        be accessible is rather complicated. A quick way is to run
+        <code class="filename">testserver.pl</code> to check if your web server serves
+        Bugzilla files as expected. If not, you may want to follow the few
+        steps below.
+      </p><div class="tip" title="Tip" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../images/tip.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Bugzilla ships with the ability to create
+        <a class="glossterm" href="glossary.html#gloss-htaccess"><em class="glossterm"><code class="filename">.htaccess</code></em></a>
+        files that enforce these rules. Instructions for enabling these
+        directives in Apache can be found in <a class="xref" href="configuration.html#http-apache" title="2.2.4.1. Bugzilla using Apache">Section 2.2.4.1, “Bugzilla using Apache”</a>
+        </p></td></tr></table></div><div class="itemizedlist"><ul class="itemizedlist" type="disc" compact><li class="listitem"><p>In the main Bugzilla directory, you should:</p><div class="itemizedlist"><ul class="itemizedlist" type="circle" compact><li class="listitem"><p>Block:
+              <span class="simplelist"><code class="filename">*.pl</code>, <code class="filename">*localconfig*</code></span>
+              </p></li></ul></div></li><li class="listitem"><p>In <code class="filename">data</code>:</p><div class="itemizedlist"><ul class="itemizedlist" type="circle" compact><li class="listitem"><p>Block everything</p></li></ul></div></li><li class="listitem"><p>In <code class="filename">data/webdot</code>:</p><div class="itemizedlist"><ul class="itemizedlist" type="circle" compact><li class="listitem"><p>If you use a remote webdot server:</p><div class="itemizedlist"><ul class="itemizedlist" type="square" compact><li class="listitem"><p>Block everything</p></li><li class="listitem"><p>But allow
+                  <span class="simplelist"><code class="filename">*.dot</code></span>
+                  only for the remote webdot server</p></li></ul></div></li><li class="listitem"><p>Otherwise, if you use a local GraphViz:</p><div class="itemizedlist"><ul class="itemizedlist" type="square" compact><li class="listitem"><p>Block everything</p></li><li class="listitem"><p>But allow:
+                  <span class="simplelist"><code class="filename">*.png</code>, <code class="filename">*.gif</code>, <code class="filename">*.jpg</code>, <code class="filename">*.map</code></span>
+                  </p></li></ul></div></li><li class="listitem"><p>And if you don't use any dot:</p><div class="itemizedlist"><ul class="itemizedlist" type="square" compact><li class="listitem"><p>Block everything</p></li></ul></div></li></ul></div></li><li class="listitem"><p>In <code class="filename">Bugzilla</code>:</p><div class="itemizedlist"><ul class="itemizedlist" type="circle" compact><li class="listitem"><p>Block everything</p></li></ul></div></li><li class="listitem"><p>In <code class="filename">template</code>:</p><div class="itemizedlist"><ul class="itemizedlist" type="circle" compact><li class="listitem"><p>Block everything</p></li></ul></div></li></ul></div><p>Be sure to test that data that should not be accessed remotely is
+      properly blocked. Of particular interest is the localconfig file which
+      contains your database password. Also, be aware that many editors
+      create temporary and backup files in the working directory and that
+      those should also not be accessible. For more information, see
+      <a class="ulink" href="http://bugzilla.mozilla.org/show_bug.cgi?id=186383" target="_top">bug 186383</a>
+      or
+      <a class="ulink" href="http://online.securityfocus.com/bid/6501" target="_top">Bugtraq ID 6501</a>.
+      To test, simply run <code class="filename">testserver.pl</code>, as said above.
+      </p><div class="tip" title="Tip" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../images/tip.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Be sure to check <a class="xref" href="configuration.html#http" title="2.2.4. Web server">Section 2.2.4, “Web server”</a> for instructions
+        specific to the web server you use.
+        </p></td></tr></table></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="security-os.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="security.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="security-bugzilla.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.1. Operating System </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 4.3. Bugzilla</td></tr></table></div></body></html>

diff --git a/docs/en/html/security.html b/docs/en/html/security.html
new file mode 100644 (file)
index 0000000..a4ea4f8
--- /dev/null
+++ b/docs/en/html/security.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 4. Bugzilla Security</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="prev" href="sanitycheck.html" title="3.16. Checking and Maintaining Database Integrity"><link rel="next" href="security-os.html" title="4.1. Operating System"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 4. Bugzilla Security</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="sanitycheck.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="security-os.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 4. Bugzilla Security"><div class="titlepage"><div><div><h2 class="title"><a name="security"></a>Chapter 4. Bugzilla Security</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="security-os.html">4.1. Operating System</a></span></dt><dd><dl><dt><span class="section"><a href="security-os.html#security-os-ports">4.1.1. TCP/IP Ports</a></span></dt><dt><span class="section"><a href="security-os.html#security-os-accounts">4.1.2. System User Accounts</a></span></dt><dt><span class="section"><a href="security-os.html#security-os-chroot">4.1.3. The <code class="filename">chroot</code> Jail</a></span></dt></dl></dd><dt><span class="section"><a href="security-webserver.html">4.2. Web server</a></span></dt><dd><dl><dt><span class="section"><a href="security-webserver.html#security-webserver-access">4.2.1. Disabling Remote Access to Bugzilla Configuration Files</a></span></dt></dl></dd><dt><span class="section"><a href="security-bugzilla.html">4.3. Bugzilla</a></span></dt><dd><dl><dt><span class="section"><a href="security-bugzilla.html#security-bugzilla-charset">4.3.1. Prevent users injecting malicious Javascript</a></span></dt></dl></dd></dl></div><p>While some of the items in this chapter are related to the operating
+  system Bugzilla is running on or some of the support software required to
+  run Bugzilla, it is all related to protecting your data. This is not
+  intended to be a comprehensive guide to securing Linux, Apache, MySQL, or
+  any other piece of software mentioned. There is no substitute for active
+  administration and monitoring of a machine. The key to good security is
+  actually right in the middle of the word: <span class="emphasis"><em>U R It</em></span>.
+  </p><p>While programmers in general always strive to write secure code,
+  accidents can and do happen. The best approach to security is to always
+  assume that the program you are working with isn't 100% secure and restrict
+  its access to other parts of your machine as much as possible.
+  </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="sanitycheck.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="security-os.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.16. Checking and Maintaining Database Integrity </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 4.1. Operating System</td></tr></table></div></body></html>

diff --git a/docs/en/html/timetracking.html b/docs/en/html/timetracking.html
new file mode 100644 (file)
index 0000000..21936bc
--- /dev/null
+++ b/docs/en/html/timetracking.html
@@ -0,0 +1,20 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>5.9. Time Tracking Information</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="prev" href="hintsandtips.html" title="5.8. Hints and Tips"><link rel="next" href="userpreferences.html" title="5.10. User Preferences"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.9. Time Tracking Information</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="hintsandtips.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Using Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="userpreferences.html">Next</a></td></tr></table><hr></div><div class="section" title="5.9. Time Tracking Information"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="timetracking"></a>5.9. Time Tracking Information</h2></div></div></div><p>
+      Users who belong to the group specified by the <span class="quote">“<span class="quote">timetrackinggroup</span>”</span>
+      parameter have access to time-related fields. Developers can see
+      deadlines and estimated times to fix bugs, and can provide time spent
+      on these bugs.
+    </p><p>
+      At any time, a summary of the time spent by developers on bugs is
+      accessible either from bug lists when clicking the <span class="quote">“<span class="quote">Time Summary</span>”</span>
+      button or from individual bugs when clicking the <span class="quote">“<span class="quote">Summarize time</span>”</span>
+      link in the time tracking table. The <code class="filename">summarize_time.cgi</code>
+      page lets you view this information either per developer or per bug,
+      and can be split on a month basis to have greater details on how time
+      is spent by developers.
+    </p><p>
+      As soon as a bug is marked as RESOLVED, the remaining time expected
+      to fix the bug is set to zero. This lets QA people set it again for
+      their own usage, and it will be set to zero again when the bug will
+      be marked as CLOSED.
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="hintsandtips.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="using.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="userpreferences.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5.8. Hints and Tips </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 5.10. User Preferences</td></tr></table></div></body></html>

diff --git a/docs/en/html/trbl-dbdSponge.html b/docs/en/html/trbl-dbdSponge.html
new file mode 100644 (file)
index 0000000..b30711d
--- /dev/null
+++ b/docs/en/html/trbl-dbdSponge.html
@@ -0,0 +1,22 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>A.4. DBD::Sponge::db prepare failed</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="troubleshooting.html" title="Appendix A. Troubleshooting"><link rel="prev" href="trbl-perlmodule.html" title="A.3. I installed a Perl module, but checksetup.pl claims it's not installed!"><link rel="next" href="paranoid-security.html" title="A.5. cannot chdir(/var/spool/mqueue)"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">A.4. DBD::Sponge::db prepare failed</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="trbl-perlmodule.html">Prev</a> </td><th width="60%" align="center">Appendix A. Troubleshooting</th><td width="20%" align="right"> <a accesskey="n" href="paranoid-security.html">Next</a></td></tr></table><hr></div><div class="section" title="A.4. DBD::Sponge::db prepare failed"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="trbl-dbdSponge"></a>A.4. DBD::Sponge::db prepare failed</h2></div></div></div><p>The following error message may appear due to a bug in DBD::mysql
+    (over which the Bugzilla team have no control):
+    </p><pre class="programlisting"> DBD::Sponge::db prepare failed: Cannot determine NUM_OF_FIELDS at D:/Perl/site/lib/DBD/mysql.pm line 248.
+  SV = NULL(0x0) at 0x20fc444
+  REFCNT = 1
+  FLAGS = (PADBUSY,PADMY)
+</pre><p>To fix this, go to 
+    <code class="filename">&lt;path-to-perl&gt;/lib/DBD/sponge.pm</code> 
+    in your Perl installation and replace
+    </p><pre class="programlisting"> my $numFields;
+ if ($attribs-&gt;{'NUM_OF_FIELDS'}) {
+     $numFields = $attribs-&gt;{'NUM_OF_FIELDS'};
+ } elsif ($attribs-&gt;{'NAME'}) {
+     $numFields = @{$attribs-&gt;{NAME}};
+</pre><p>with</p><pre class="programlisting"> my $numFields;
+ if ($attribs-&gt;{'NUM_OF_FIELDS'}) {
+     $numFields = $attribs-&gt;{'NUM_OF_FIELDS'};
+ } elsif ($attribs-&gt;{'NAMES'}) {
+     $numFields = @{$attribs-&gt;{NAMES}};
+</pre><p>(note the S added to NAME.)</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="trbl-perlmodule.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="troubleshooting.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="paranoid-security.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">A.3. I installed a Perl module, but 
+      <code class="filename">checksetup.pl</code> claims it's not installed! </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> A.5. cannot chdir(/var/spool/mqueue)</td></tr></table></div></body></html>

diff --git a/docs/en/html/trbl-index.html b/docs/en/html/trbl-index.html
new file mode 100644 (file)
index 0000000..c1f41eb
--- /dev/null
+++ b/docs/en/html/trbl-index.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>A.7. index.cgi doesn't show up unless specified in the URL</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="troubleshooting.html" title="Appendix A. Troubleshooting"><link rel="prev" href="trbl-relogin-everyone.html" title="A.6. Everybody is constantly being forced to relogin"><link rel="next" href="trbl-passwd-encryption.html" title='A.8.  checksetup.pl reports "Client does not support authentication protocol requested by server..."'></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">A.7. <code class="filename">index.cgi</code> doesn't show up unless specified in the URL</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="trbl-relogin-everyone.html">Prev</a> </td><th width="60%" align="center">Appendix A. Troubleshooting</th><td width="20%" align="right"> <a accesskey="n" href="trbl-passwd-encryption.html">Next</a></td></tr></table><hr></div><div class="section" title="A.7. index.cgi doesn't show up unless specified in the URL"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="trbl-index"></a>A.7. <code class="filename">index.cgi</code> doesn't show up unless specified in the URL</h2></div></div></div><p>
+      You probably need to set up your web server in such a way that it
+      will serve the index.cgi page as an index page.
+    </p><p>
+      If you are using Apache, you can do this by adding 
+      <code class="filename">index.cgi</code> to the end of the 
+      <code class="computeroutput">DirectoryIndex</code> line
+      as mentioned in <a class="xref" href="configuration.html#http-apache" title="2.2.4.1. Bugzilla using Apache">Section 2.2.4.1, “Bugzilla using Apache”</a>.
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="trbl-relogin-everyone.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="troubleshooting.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="trbl-passwd-encryption.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">A.6. Everybody is constantly being forced to relogin </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> A.8. 
+      checksetup.pl reports "Client does not support authentication protocol
+      requested by server..."
+    </td></tr></table></div></body></html>

diff --git a/docs/en/html/trbl-passwd-encryption.html b/docs/en/html/trbl-passwd-encryption.html
new file mode 100644 (file)
index 0000000..9649695
--- /dev/null
+++ b/docs/en/html/trbl-passwd-encryption.html
@@ -0,0 +1,21 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>A.8.  checksetup.pl reports "Client does not support authentication protocol requested by server..."</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="troubleshooting.html" title="Appendix A. Troubleshooting"><link rel="prev" href="trbl-index.html" title="A.7. index.cgi doesn't show up unless specified in the URL"><link rel="next" href="patches.html" title="Appendix B. Contrib"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">A.8. 
+      checksetup.pl reports "Client does not support authentication protocol
+      requested by server..."
+    </th></tr><tr><td width="20%" align="left"><a accesskey="p" href="trbl-index.html">Prev</a> </td><th width="60%" align="center">Appendix A. Troubleshooting</th><td width="20%" align="right"> <a accesskey="n" href="patches.html">Next</a></td></tr></table><hr></div><div class="section" title='A.8.  checksetup.pl reports "Client does not support authentication protocol requested by server..."'><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="trbl-passwd-encryption"></a>A.8. 
+      checksetup.pl reports "Client does not support authentication protocol
+      requested by server..."
+    </h2></div></div></div><p>
+      This error is occurring because you are using the new password
+      encryption that comes with MySQL 4.1, while your
+      <code class="filename">DBD::mysql</code> module was compiled against an
+      older version of MySQL. If you recompile <code class="filename">DBD::mysql</code>
+      against the current MySQL libraries (or just obtain a newer version
+      of this module) then the error may go away.
+    </p><p>
+      If that does not fix the problem, or if you cannot recompile the
+      existing module (e.g. you're running Windows) and/or don't want to
+      replace it (e.g. you want to keep using a packaged version), then a
+      workaround is available from the MySQL docs:
+      <a class="ulink" href="http://dev.mysql.com/doc/mysql/en/Old_client.html" target="_top">http://dev.mysql.com/doc/mysql/en/Old_client.html</a>
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="trbl-index.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="troubleshooting.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="patches.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">A.7. <code class="filename">index.cgi</code> doesn't show up unless specified in the URL </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Appendix B. Contrib</td></tr></table></div></body></html>

diff --git a/docs/en/html/trbl-perlmodule.html b/docs/en/html/trbl-perlmodule.html
new file mode 100644 (file)
index 0000000..1b81d2e
--- /dev/null
+++ b/docs/en/html/trbl-perlmodule.html
@@ -0,0 +1,12 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>A.3. I installed a Perl module, but checksetup.pl claims it's not installed!</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="troubleshooting.html" title="Appendix A. Troubleshooting"><link rel="prev" href="trbl-testserver.html" title="A.2. The Apache web server is not serving Bugzilla pages"><link rel="next" href="trbl-dbdSponge.html" title="A.4. DBD::Sponge::db prepare failed"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">A.3. I installed a Perl module, but 
+      <code class="filename">checksetup.pl</code> claims it's not installed!</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="trbl-testserver.html">Prev</a> </td><th width="60%" align="center">Appendix A. Troubleshooting</th><td width="20%" align="right"> <a accesskey="n" href="trbl-dbdSponge.html">Next</a></td></tr></table><hr></div><div class="section" title="A.3. I installed a Perl module, but checksetup.pl claims it's not installed!"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="trbl-perlmodule"></a>A.3. I installed a Perl module, but 
+      <code class="filename">checksetup.pl</code> claims it's not installed!</h2></div></div></div><p>This could be caused by one of two things:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>You have two versions of Perl on your machine. You are installing
+        modules into one, and Bugzilla is using the other. Rerun the CPAN
+        commands (or manual compile) using the full path to Perl from the 
+        top of <code class="filename">checksetup.pl</code>. This will make sure you 
+        are installing the modules in the right place.
+        </p></li><li class="listitem"><p>The permissions on your library directories are set incorrectly.
+        They must, at the very least, be readable by the web server user or
+        group. It is recommended that they be world readable.
+        </p></li></ol></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="trbl-testserver.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="troubleshooting.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="trbl-dbdSponge.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">A.2. The Apache web server is not serving Bugzilla pages </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> A.4. DBD::Sponge::db prepare failed</td></tr></table></div></body></html>

diff --git a/docs/en/html/trbl-relogin-everyone.html b/docs/en/html/trbl-relogin-everyone.html
new file mode 100644 (file)
index 0000000..e99f546
--- /dev/null
+++ b/docs/en/html/trbl-relogin-everyone.html
@@ -0,0 +1,44 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>A.6. Everybody is constantly being forced to relogin</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="troubleshooting.html" title="Appendix A. Troubleshooting"><link rel="prev" href="paranoid-security.html" title="A.5. cannot chdir(/var/spool/mqueue)"><link rel="next" href="trbl-index.html" title="A.7. index.cgi doesn't show up unless specified in the URL"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">A.6. Everybody is constantly being forced to relogin</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="paranoid-security.html">Prev</a> </td><th width="60%" align="center">Appendix A. Troubleshooting</th><td width="20%" align="right"> <a accesskey="n" href="trbl-index.html">Next</a></td></tr></table><hr></div><div class="section" title="A.6. Everybody is constantly being forced to relogin"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="trbl-relogin-everyone"></a>A.6. Everybody is constantly being forced to relogin</h2></div></div></div><p>The most-likely cause is that the <span class="quote">“<span class="quote">cookiepath</span>”</span> parameter
+  is not set correctly in the Bugzilla configuration.  You can change this (if
+  you're a Bugzilla administrator) from the editparams.cgi page via the web interface.
+  </p><p>The value of the cookiepath parameter should be the actual directory
+  containing your Bugzilla installation, <span class="emphasis"><em>as seen by the end-user's
+  web browser</em></span>. Leading and trailing slashes are mandatory. You can
+  also set the cookiepath to any directory which is a parent of the Bugzilla
+  directory (such as '/', the root directory). But you can't put something
+  that isn't at least a partial match or it won't work. What you're actually
+  doing is restricting the end-user's browser to sending the cookies back only
+  to that directory.
+  </p><p>How do you know if you want your specific Bugzilla directory or the
+  whole site?
+  </p><p>If you have only one Bugzilla running on the server, and you don't
+  mind having other applications on the same server with it being able to see
+  the cookies (you might be doing this on purpose if you have other things on
+  your site that share authentication with Bugzilla), then you'll want to have
+  the cookiepath set to "/", or to a sufficiently-high enough directory that
+  all of the involved apps can see the cookies.
+  </p><div class="example"><a name="trbl-relogin-everyone-share"></a><p class="title"><b>Example A.1. Examples of urlbase/cookiepath pairs for sharing login cookies</b></p><div class="example-contents"><div class="blockquote"><blockquote class="blockquote"><div class="literallayout"><p><br>
+urlbase is http://bugzilla.mozilla.org/<br>
+cookiepath is /<br>
+<br>
+urlbase is http://tools.mysite.tld/bugzilla/<br>
+        but you have http://tools.mysite.tld/someotherapp/ which shares<br>
+        authentication with your Bugzilla<br>
+cookiepath is /<br>
+      </p></div></blockquote></div></div></div><br class="example-break"><p>On the other hand, if you have more than one Bugzilla running on the
+   server (some people do - we do on landfill) then you need to have the
+   cookiepath restricted enough so that the different Bugzillas don't
+   confuse their cookies with one another.
+   </p><div class="example"><a name="trbl-relogin-everyone-restrict"></a><p class="title"><b>Example A.2. Examples of urlbase/cookiepath pairs to restrict the login cookie</b></p><div class="example-contents"><div class="blockquote"><blockquote class="blockquote"><div class="literallayout"><p><br>
+urlbase is http://landfill.bugzilla.org/bugzilla-tip/<br>
+cookiepath is /bugzilla-tip/<br>
+<br>
+urlbase is http://landfill.bugzilla.org/bugzilla-4.0-branch/<br>
+cookiepath is /bugzilla-4.0-branch/<br>
+        </p></div></blockquote></div></div></div><br class="example-break"><p>If you had cookiepath set to <span class="quote">“<span class="quote">/</span>”</span> at any point in the
+    past and need to set it to something more restrictive
+    (i.e. <span class="quote">“<span class="quote">/bugzilla/</span>”</span>), you can safely do this without
+    requiring users to delete their Bugzilla-related cookies in their
+    browser (this is true starting with Bugzilla 2.18 and Bugzilla 2.16.5).
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="paranoid-security.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="troubleshooting.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="trbl-index.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">A.5. cannot chdir(/var/spool/mqueue) </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> A.7. <code class="filename">index.cgi</code> doesn't show up unless specified in the URL</td></tr></table></div></body></html>

diff --git a/docs/en/html/trbl-testserver.html b/docs/en/html/trbl-testserver.html
new file mode 100644 (file)
index 0000000..a8e9c00
--- /dev/null
+++ b/docs/en/html/trbl-testserver.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>A.2. The Apache web server is not serving Bugzilla pages</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="troubleshooting.html" title="Appendix A. Troubleshooting"><link rel="prev" href="general-advice.html" title="A.1. General Advice"><link rel="next" href="trbl-perlmodule.html" title="A.3. I installed a Perl module, but checksetup.pl claims it's not installed!"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">A.2. The Apache web server is not serving Bugzilla pages</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="general-advice.html">Prev</a> </td><th width="60%" align="center">Appendix A. Troubleshooting</th><td width="20%" align="right"> <a accesskey="n" href="trbl-perlmodule.html">Next</a></td></tr></table><hr></div><div class="section" title="A.2. The Apache web server is not serving Bugzilla pages"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="trbl-testserver"></a>A.2. The Apache web server is not serving Bugzilla pages</h2></div></div></div><p>After you have run <span class="command"><strong>checksetup.pl</strong></span> twice,
+    run <span class="command"><strong>testserver.pl http://yoursite.yourdomain/yoururl</strong></span>
+    to confirm that your web server is configured properly for
+    Bugzilla.
+    </p><pre class="programlisting">
+<code class="prompt">bash$</code> ./testserver.pl http://landfill.bugzilla.org/bugzilla-tip
+TEST-OK Webserver is running under group id in $webservergroup.
+TEST-OK Got ant picture.
+TEST-OK Webserver is executing CGIs.
+TEST-OK Webserver is preventing fetch of http://landfill.bugzilla.org/bugzilla-tip/localconfig.
+</pre></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="general-advice.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="troubleshooting.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="trbl-perlmodule.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">A.1. General Advice </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> A.3. I installed a Perl module, but 
+      <code class="filename">checksetup.pl</code> claims it's not installed!</td></tr></table></div></body></html>

diff --git a/docs/en/html/troubleshooting.html b/docs/en/html/troubleshooting.html
new file mode 100644 (file)
index 0000000..19e455a
--- /dev/null
+++ b/docs/en/html/troubleshooting.html
@@ -0,0 +1,9 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Appendix A. Troubleshooting</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="prev" href="integration.html" title="6.5. Integrating Bugzilla with Third-Party Tools"><link rel="next" href="general-advice.html" title="A.1. General Advice"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix A. Troubleshooting</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="integration.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="general-advice.html">Next</a></td></tr></table><hr></div><div class="appendix" title="Appendix A. Troubleshooting"><div class="titlepage"><div><div><h2 class="title"><a name="troubleshooting"></a>Appendix A. Troubleshooting</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="general-advice.html">A.1. General Advice</a></span></dt><dt><span class="section"><a href="trbl-testserver.html">A.2. The Apache web server is not serving Bugzilla pages</a></span></dt><dt><span class="section"><a href="trbl-perlmodule.html">A.3. I installed a Perl module, but 
+      <code class="filename">checksetup.pl</code> claims it's not installed!</a></span></dt><dt><span class="section"><a href="trbl-dbdSponge.html">A.4. DBD::Sponge::db prepare failed</a></span></dt><dt><span class="section"><a href="paranoid-security.html">A.5. cannot chdir(/var/spool/mqueue)</a></span></dt><dt><span class="section"><a href="trbl-relogin-everyone.html">A.6. Everybody is constantly being forced to relogin</a></span></dt><dt><span class="section"><a href="trbl-index.html">A.7. <code class="filename">index.cgi</code> doesn't show up unless specified in the URL</a></span></dt><dt><span class="section"><a href="trbl-passwd-encryption.html">A.8. 
+      checksetup.pl reports "Client does not support authentication protocol
+      requested by server..."
+    </a></span></dt></dl></div><p>This section gives solutions to common Bugzilla installation
+  problems. If none of the section headings seems to match your
+  problem, read the general advice.
+  </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="integration.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="general-advice.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">6.5. Integrating Bugzilla with Third-Party Tools </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> A.1. General Advice</td></tr></table></div></body></html>

diff --git a/docs/en/html/upgrade.html b/docs/en/html/upgrade.html
new file mode 100644 (file)
index 0000000..d55f644
--- /dev/null
+++ b/docs/en/html/upgrade.html
@@ -0,0 +1,241 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>2.7. Upgrading to New Releases</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="installing-bugzilla.html" title="Chapter 2. Installing Bugzilla"><link rel="prev" href="nonroot.html" title="2.6. UNIX (non-root) Installation Notes"><link rel="next" href="administration.html" title="Chapter 3. Administering Bugzilla"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.7. Upgrading to New Releases</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="nonroot.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Installing Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="administration.html">Next</a></td></tr></table><hr></div><div class="section" title="2.7. Upgrading to New Releases"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="upgrade"></a>2.7. Upgrading to New Releases</h2></div></div></div><p>Upgrading to new Bugzilla releases is very simple. There is
+      a script named <code class="filename">checksetup.pl</code> included with
+      Bugzilla that will automatically do all of the database migration
+      for you.</p><p>The following sections explain how to upgrade from one
+      version of Bugzilla to another. Whether you are upgrading
+      from one bug-fix version to another (such as 4.2 to 4.2.1)
+      or from one major version to another (such as from 4.0 to 4.2),
+      the instructions are always the same.</p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        Any examples in the following sections are written as though the
+        user were updating to version 4.2.1, but the procedures are the
+        same no matter what version you're updating to. Also, in the
+        examples, the user's Bugzilla installation is found at
+        <code class="filename">/var/www/html/bugzilla</code>. If that is not the
+        same as the location of your Bugzilla installation, simply
+        substitute the proper paths where appropriate.
+      </p></td></tr></table></div><div class="section" title="2.7.1. Before You Upgrade"><div class="titlepage"><div><div><h3 class="title"><a name="upgrade-before"></a>2.7.1. Before You Upgrade</h3></div></div></div><p>Before you start your upgrade, there are a few important
+        steps to take:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+            Read the <a class="ulink" href="http://www.bugzilla.org/releases/" target="_top">Release
+            Notes</a> of the version you're upgrading to,
+            particularly the "Notes for Upgraders" section.
+          </p></li><li class="listitem"><p>
+            View the Sanity Check (<a class="xref" href="sanitycheck.html" title="3.16. Checking and Maintaining Database Integrity">Section 3.16, “Checking and Maintaining Database Integrity”</a>) page
+            on your installation before upgrading. Attempt to fix all warnings
+            that the page produces before you go any further, or you may
+            experience problems  during your upgrade.
+          </p></li><li class="listitem"><p>
+            Shut down your Bugzilla installation by putting some HTML or
+            text in the shutdownhtml parameter
+            (see <a class="xref" href="parameters.html" title="3.1. Bugzilla Configuration">Section 3.1, “Bugzilla Configuration”</a>).
+          </p></li><li class="listitem"><p>
+            Make a backup of the Bugzilla database.
+            <span class="emphasis"><em>THIS IS VERY IMPORTANT</em></span>. If
+            anything goes wrong during the upgrade, your installation
+            can be corrupted beyond recovery. Having a backup keeps you safe.
+          </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+              Upgrading is a one-way process. You cannot "downgrade" an
+              upgraded Bugzilla. If you wish to revert to the old Bugzilla
+              version for any reason, you will have to restore your database
+              from this backup.
+            </p></td></tr></table></div><p>Here are some sample commands you could use to backup
+            your database, depending on what database system you're
+            using. You may have to modify these commands for your
+            particular setup.</p><div class="variablelist"><dl><dt><span class="term">MySQL:</span></dt><dd><p>
+                  <span class="command"><strong>mysqldump --opt -u bugs -p bugs &gt; bugs.sql</strong></span>
+                </p></dd><dt><span class="term">PostgreSQL:</span></dt><dd><p>
+                  <span class="command"><strong>pg_dump --no-privileges --no-owner -h localhost -U bugs
+                    &gt; bugs.sql</strong></span>
+                </p></dd></dl></div></li></ol></div></div><div class="section" title="2.7.2. Getting The New Bugzilla"><div class="titlepage"><div><div><h3 class="title"><a name="upgrade-files"></a>2.7.2. Getting The New Bugzilla</h3></div></div></div><p>There are three ways to get the new version of Bugzilla.
+        We'll list them here briefly and then explain them
+        more later.</p><div class="variablelist"><dl><dt><span class="term">Bzr (<a class="xref" href="upgrade.html#upgrade-bzr" title="2.7.2.2. Upgrading using Bzr">Section 2.7.2.2, “Upgrading using Bzr”</a>)</span></dt><dd><p>
+              If you have <span class="command"><strong>bzr</strong></span> installed on your machine
+              and you have Internet access, this is the easiest way to
+              upgrade, particularly if you have made modifications
+              to the code or templates of Bugzilla.
+            </p></dd><dt><span class="term">Download the tarball (<a class="xref" href="upgrade.html#upgrade-tarball" title="2.7.2.3. Upgrading using the tarball">Section 2.7.2.3, “Upgrading using the tarball”</a>)</span></dt><dd><p>
+              This is a very simple way to upgrade, and good if you
+              haven't made many (or any) modifications to the code or
+              templates of your Bugzilla.
+            </p></dd><dt><span class="term">Patches (<a class="xref" href="upgrade.html#upgrade-patches" title="2.7.2.4. Upgrading using patches">Section 2.7.2.4, “Upgrading using patches”</a>)</span></dt><dd><p>
+              If you have made modifications to your Bugzilla, and
+              you don't have Internet access or you don't want to use
+              bzr, then this is the best way to upgrade.
+            </p><p>
+              You can only do minor upgrades (such as 4.2 to 4.2.1 or
+              4.2.1 to 4.2.2) with patches.
+            </p></dd></dl></div><div class="section" title="2.7.2.1. If you have modified your Bugzilla"><div class="titlepage"><div><div><h4 class="title"><a name="upgrade-modified"></a>2.7.2.1. If you have modified your Bugzilla</h4></div></div></div><p>
+          If you have modified the code or templates of your Bugzilla,
+          then upgrading requires a bit more thought and effort.
+          A discussion of the various methods of updating compared with
+          degree and methods of local customization can be found in
+          <a class="xref" href="cust-templates.html#template-method" title="6.3.2. Choosing a Customization Method">Section 6.3.2, “Choosing a Customization Method”</a>.
+        </p><p>
+          The larger the jump you are trying to make, the more difficult it
+          is going to be to upgrade if you have made local customizations.
+          Upgrading from 4.2 to 4.2.1 should be fairly painless even if
+          you are heavily customized, but going from 2.18 to 4.2 is going
+          to mean a fair bit of work re-writing your local changes to use
+          the new files, logic, templates, etc. If you have done no local
+          changes at all, however, then upgrading should be approximately
+          the same amount of work regardless of how long it has been since
+          your version was released.
+        </p></div><div class="section" title="2.7.2.2. Upgrading using Bzr"><div class="titlepage"><div><div><h4 class="title"><a name="upgrade-bzr"></a>2.7.2.2. Upgrading using Bzr</h4></div></div></div><p>
+          This requires that you have bzr installed (most Unix machines do),
+          and requires that you are able to access
+          <a class="ulink" href="http://bzr.mozilla.org/bugzilla/" target="_top">bzr.mozilla.org</a>,
+          which may not be an option if you don't have Internet access.
+        </p><p>
+          The following shows the sequence of commands needed to update a
+          Bugzilla installation via Bzr, and a typical series of results.
+          These commands assume that you already have Bugzilla installed
+          using Bzr.
+        </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            If your installation is still using CVS, you must first convert
+            it to Bzr. A very detailed step by step documentation can be
+            found on <a class="ulink" href="https://wiki.mozilla.org/Bugzilla:Moving_From_CVS_To_Bazaar" target="_top">wiki.mozilla.org</a>.
+          </p></td></tr></table></div><pre class="programlisting">
+bash$ <span class="command"><strong>cd /var/www/html/bugzilla</strong></span>
+bash$ <span class="command"><strong>bzr switch 4.2</strong></span> (only run this command when not yet running 4.2)
+bash$ <span class="command"><strong>bzr up -r tag:bugzilla-4.2.1</strong></span>
++N  extensions/MoreBugUrl/
++N  extensions/MoreBugUrl/Config.pm
++N  extensions/MoreBugUrl/Extension.pm
+...
+ M  Bugzilla/Attachment.pm
+ M  Bugzilla/Attachment/PatchReader.pm
+ M  Bugzilla/Bug.pm
+...
+All changes applied successfully.
+        </pre><div class="caution" title="Caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            If a line in the output from <span class="command"><strong>bzr up</strong></span> mentions
+            a conflict, then that represents a file with local changes that
+            Bzr was unable to properly merge. You need to resolve these
+            conflicts manually before Bugzilla (or at least the portion using
+            that file) will be usable.
+          </p></td></tr></table></div></div><div class="section" title="2.7.2.3. Upgrading using the tarball"><div class="titlepage"><div><div><h4 class="title"><a name="upgrade-tarball"></a>2.7.2.3. Upgrading using the tarball</h4></div></div></div><p>
+          If you are unable (or unwilling) to use Bzr, another option that's
+          always available is to obtain the latest tarball from the <a class="ulink" href="http://www.bugzilla.org/download/" target="_top">Download Page</a> and 
+          create a new Bugzilla installation from that.
+        </p><p>
+          This sequence of commands shows how to get the tarball from the
+          command-line; it is also possible to download it from the site
+          directly in a web browser. If you go that route, save the file
+          to the <code class="filename">/var/www/html</code>
+          directory (or its equivalent, if you use something else) and 
+          omit the first three lines of the example.
+        </p><pre class="programlisting">
+bash$ <span class="command"><strong>cd /var/www/html</strong></span>
+bash$ <span class="command"><strong>wget http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-4.2.1.tar.gz</strong></span>
+<span class="emphasis"><em>(Output omitted)</em></span>
+bash$ <span class="command"><strong>tar xzvf bugzilla-4.2.1.tar.gz</strong></span>
+bugzilla-4.2.1/
+bugzilla-4.2.1/colchange.cgi
+<span class="emphasis"><em>(Output truncated)</em></span>
+bash$ <span class="command"><strong>cd bugzilla-4.2.1</strong></span>
+bash$ <span class="command"><strong>cp ../bugzilla/localconfig* .</strong></span>
+bash$ <span class="command"><strong>cp -r ../bugzilla/data .</strong></span>
+bash$ <span class="command"><strong>cd ..</strong></span>
+bash$ <span class="command"><strong>mv bugzilla bugzilla.old</strong></span>
+bash$ <span class="command"><strong>mv bugzilla-4.2.1 bugzilla</strong></span>
+        </pre><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            The <span class="command"><strong>cp</strong></span> commands both end with periods which
+            is a very important detail--it means that the destination
+            directory is the current working directory.
+          </p></td></tr></table></div><div class="caution" title="Caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            If you have some extensions installed, you will have to copy them
+            to the new bugzilla directory too. Extensions are located in
+            <code class="filename">bugzilla/extensions/</code>. Only copy those you
+            installed, not those managed by the Bugzilla team.
+          </p></td></tr></table></div><p>
+          This upgrade method will give you a clean install of Bugzilla.
+          That's fine if you don't have any local customizations that you
+          want to maintain. If you do have customizations, then you will 
+          need to reapply them by hand to the appropriate files.
+        </p></div><div class="section" title="2.7.2.4. Upgrading using patches"><div class="titlepage"><div><div><h4 class="title"><a name="upgrade-patches"></a>2.7.2.4. Upgrading using patches</h4></div></div></div><p>
+          A patch is a collection of all the bug fixes that have been made
+          since the last bug-fix release.
+        </p><p>
+          If you are doing a bug-fix upgrade—that is, one where only the 
+          last number of the revision changes, such as from 4.2 to
+          4.2.1—then you have the option of obtaining and applying a
+          patch file from the <a class="ulink" href="http://www.bugzilla.org/download/" target="_top">Download Page</a>.
+        </p><p>
+          As above, this example starts with obtaining the file via the 
+          command line. If you have already downloaded it, you can omit the
+          first two commands.
+        </p><pre class="programlisting">
+bash$ <span class="command"><strong>cd /var/www/html/bugzilla</strong></span>
+bash$ <span class="command"><strong>wget http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-4.2-to-4.2.1.diff.gz</strong></span>
+<span class="emphasis"><em>(Output omitted)</em></span>
+bash$ <span class="command"><strong>gunzip bugzilla-4.2-to-4.2.1.diff.gz</strong></span>
+bash$ <span class="command"><strong>patch -p1 &lt; bugzilla-4.2-to-4.2.1.diff</strong></span>
+patching file Bugzilla/Constants.pm
+patching file enter_bug.cgi
+<span class="emphasis"><em>(etc.)</em></span>
+        </pre><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+            Be aware that upgrading from a patch file does not change the
+            entries in your <code class="filename">.bzr</code> directory.
+            This could make it more difficult to upgrade using Bzr
+            (<a class="xref" href="upgrade.html#upgrade-bzr" title="2.7.2.2. Upgrading using Bzr">Section 2.7.2.2, “Upgrading using Bzr”</a>) in the future.
+          </p></td></tr></table></div></div></div><div class="section" title="2.7.3. Completing Your Upgrade"><div class="titlepage"><div><div><h3 class="title"><a name="upgrade-completion"></a>2.7.3. Completing Your Upgrade</h3></div></div></div><p>
+        Now that you have the new Bugzilla code, there are a few final
+        steps to complete your upgrade.
+      </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
+            If your new Bugzilla installation is in a different
+            directory or on a different machine than your old Bugzilla
+            installation, make sure that you have copied the
+            <code class="filename">data</code> directory and the
+            <code class="filename">localconfig</code> file from your old Bugzilla
+            installation. (If you followed the tarball instructions
+            above, this has already happened.)
+          </p></li><li class="listitem"><p>
+            If this is a major update, check that the configuration
+            (<a class="xref" href="configuration.html" title="2.2. Configuration">Section 2.2, “Configuration”</a>) for your new Bugzilla is
+            up-to-date. Sometimes the configuration requirements change
+            between major versions.
+          </p></li><li class="listitem"><p>
+            If you didn't do it as part of the above configuration step,
+            now you need to run <span class="command"><strong>checksetup.pl</strong></span>, which
+            will do everything required to convert your existing database
+            and settings for the new version:
+          </p><pre class="programlisting">
+bash$ <span class="command"><strong>cd /var/www/html/bugzilla</strong></span>
+bash$ <span class="command"><strong>./checksetup.pl</strong></span>
+          </pre><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+              The period at the beginning of the command
+              <span class="command"><strong>./checksetup.pl</strong></span> is important and cannot
+              be omitted.
+            </p></td></tr></table></div><div class="caution" title="Caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+              If this is a major upgrade (say, 3.6 to 4.2 or similar),
+              running <span class="command"><strong>checksetup.pl</strong></span> on a large
+              installation (75,000 or more bugs) can take a long time,
+              possibly several hours.
+            </p></td></tr></table></div></li><li class="listitem"><p>
+            Clear any HTML or text that you put into the shutdownhtml
+            parameter, to re-activate Bugzilla.
+          </p></li><li class="listitem"><p>
+            View the Sanity Check (<a class="xref" href="sanitycheck.html" title="3.16. Checking and Maintaining Database Integrity">Section 3.16, “Checking and Maintaining Database Integrity”</a>) page in your
+            upgraded Bugzilla.
+          </p><p>
+            It is recommended that, if possible, you fix any problems
+            you see, immediately. Failure to do this may mean that Bugzilla
+            will not work correctly. Be aware that if the sanity check page
+            contains more errors after an upgrade, it doesn't necessarily
+            mean there are more errors in your database than there were
+            before, as additional tests are added to the sanity check over
+            time, and it is possible that those errors weren't being
+            checked for in the old version.
+          </p></li></ol></div></div><div class="section" title="2.7.4. Automatic Notifications of New Releases"><div class="titlepage"><div><div><h3 class="title"><a name="upgrade-notifications"></a>2.7.4. Automatic Notifications of New Releases</h3></div></div></div><p>
+        Bugzilla 3.0 introduced the ability to automatically notify
+        administrators when new releases are available, based on the
+        <code class="literal">upgrade_notification</code> parameter, see
+        <a class="xref" href="parameters.html" title="3.1. Bugzilla Configuration">Section 3.1, “Bugzilla Configuration”</a>. Administrators will see these
+        notifications when they access the <code class="filename">index.cgi</code>
+        page, i.e. generally when logging in. Bugzilla will check once per
+        day for new releases, unless the parameter is set to
+        <span class="quote">“<span class="quote">disabled</span>”</span>. If you are behind a proxy, you may have to set
+        the <code class="literal">proxy_url</code> parameter accordingly. If the proxy
+        requires authentication, use the
+        <code class="literal">http://user:pass@proxy_url/</code> syntax.
+      </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="nonroot.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="installing-bugzilla.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="administration.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2.6. UNIX (non-root) Installation Notes </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 3. Administering Bugzilla</td></tr></table></div></body></html>

diff --git a/docs/en/html/useradmin.html b/docs/en/html/useradmin.html
new file mode 100644 (file)
index 0000000..5db8d9c
--- /dev/null
+++ b/docs/en/html/useradmin.html
@@ -0,0 +1,183 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.2. User Administration</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="parameters.html" title="3.1. Bugzilla Configuration"><link rel="next" href="classifications.html" title="3.3. Classifications"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.2. User Administration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="parameters.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="classifications.html">Next</a></td></tr></table><hr></div><div class="section" title="3.2. User Administration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="useradmin"></a>3.2. User Administration</h2></div></div></div><div class="section" title="3.2.1. Creating the Default User"><div class="titlepage"><div><div><h3 class="title"><a name="defaultuser"></a>3.2.1. Creating the Default User</h3></div></div></div><p>When you first run checksetup.pl after installing Bugzilla, it
+      will prompt you for the administrative username (email address) and
+      password for this "super user". If for some reason you delete
+      the "super user" account, re-running checksetup.pl will again prompt
+      you for this username and password.</p><div class="tip" title="Tip" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../images/tip.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>If you wish to add more administrative users, add them to 
+        the "admin" group and, optionally, edit the tweakparams, editusers,
+        creategroups, editcomponents, and editkeywords groups to add the
+        entire admin group to those groups (which is the case by default).
+        </p></td></tr></table></div></div><div class="section" title="3.2.2. Managing Other Users"><div class="titlepage"><div><div><h3 class="title"><a name="manageusers"></a>3.2.2. Managing Other Users</h3></div></div></div><div class="section" title="3.2.2.1. Searching for existing users"><div class="titlepage"><div><div><h4 class="title"><a name="user-account-search"></a>3.2.2.1. Searching for existing users</h4></div></div></div><p>
+          If you have <span class="quote">“<span class="quote">editusers</span>”</span> privileges or if you are allowed
+          to grant privileges for some groups, the <span class="quote">“<span class="quote">Users</span>”</span> link
+          will appear in the Administration page.
+        </p><p>
+          The first screen is a search form to search for existing user
+          accounts. You can run searches based either on the user ID, real
+          name or login name (i.e. the email address, or just the first part
+          of the email address if the "emailsuffix" parameter is set).
+          The search can be conducted
+          in different ways using the listbox to the right of the text entry
+          box. You can match by case-insensitive substring (the default),
+          regular expression, a <span class="emphasis"><em>reverse</em></span> regular expression
+          match (which finds every user name which does NOT match the regular
+          expression), or the exact string if you know exactly who you are
+          looking for. The search can be restricted to users who are in a
+          specific group. By default, the restriction is turned off.
+        </p><p>
+          The search returns a list of
+          users matching your criteria. User properties can be edited by clicking
+          the login name. The Account History of a user can be viewed by clicking
+          the "View" link in the Account History column. The Account History
+          displays changes that have been made to the user account, the time of
+          the change and the user who made the change. For example, the Account
+          History page will display details of when a user was added or removed
+          from a group.
+        </p></div><div class="section" title="3.2.2.2. Creating new users"><div class="titlepage"><div><div><h4 class="title"><a name="createnewusers"></a>3.2.2.2. Creating new users</h4></div></div></div><div class="section" title="3.2.2.2.1. Self-registration"><div class="titlepage"><div><div><h5 class="title"><a name="self-registration"></a>3.2.2.2.1. Self-registration</h5></div></div></div><p>
+            By default, users can create their own user accounts by clicking the
+            <span class="quote">“<span class="quote">New Account</span>”</span> link at the bottom of each page (assuming
+            they aren't logged in as someone else already). If you want to disable
+            this self-registration, or if you want to restrict who can create his
+            own user account, you have to edit the <span class="quote">“<span class="quote">createemailregexp</span>”</span>
+            parameter in the <span class="quote">“<span class="quote">Configuration</span>”</span> page, see
+            <a class="xref" href="parameters.html" title="3.1. Bugzilla Configuration">Section 3.1, “Bugzilla Configuration”</a>.
+          </p></div><div class="section" title="3.2.2.2.2. Accounts created by an administrator"><div class="titlepage"><div><div><h5 class="title"><a name="user-account-creation"></a>3.2.2.2.2. Accounts created by an administrator</h5></div></div></div><p>
+            Users with <span class="quote">“<span class="quote">editusers</span>”</span> privileges, such as administrators,
+            can create user accounts for other users:
+          </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>After logging in, click the "Users" link at the footer of
+              the query page, and then click "Add a new user".</p></li><li class="listitem"><p>Fill out the form presented. This page is self-explanatory.
+              When done, click "Submit".</p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Adding a user this way will <span class="emphasis"><em>not</em></span>
+                send an email informing them of their username and password.
+                While useful for creating dummy accounts (watchers which
+                shuttle mail to another system, for instance, or email
+                addresses which are a mailing list), in general it is
+                preferable to log out and use the <span class="quote">“<span class="quote">New Account</span>”</span>
+                button to create users, as it will pre-populate all the
+                required fields and also notify the user of her account name
+                and password.</p></td></tr></table></div></li></ol></div></div></div><div class="section" title="3.2.2.3. Modifying Users"><div class="titlepage"><div><div><h4 class="title"><a name="modifyusers"></a>3.2.2.3. Modifying Users</h4></div></div></div><p>Once you have found your user, you can change the following
+        fields:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
+            <span class="emphasis"><em>Login Name</em></span>: 
+            This is generally the user's full email address. However, if you
+            have are using the <span class="quote">“<span class="quote">emailsuffix</span>”</span> parameter, this may
+            just be the user's login name. Note that users can now change their
+            login names themselves (to any valid email address).
+            </p></li><li class="listitem"><p>
+            <span class="emphasis"><em>Real Name</em></span>: The user's real name. Note that
+            Bugzilla does not require this to create an account.</p></li><li class="listitem"><p>
+            <span class="emphasis"><em>Password</em></span>: 
+            You can change the user's password here. Users can automatically
+            request a new password, so you shouldn't need to do this often.
+            If you want to disable an account, see Disable Text below.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Bugmail Disabled</em></span>:
+              Mark this checkbox to disable bugmail and whinemail completely
+              for this account. This checkbox replaces the data/nomail file
+              which existed in older versions of Bugzilla.
+            </p></li><li class="listitem"><p>
+              <span class="emphasis"><em>Disable Text</em></span>: 
+              If you type anything in this box, including just a space, the
+              user is prevented from logging in, or making any changes to 
+              bugs via the web interface. 
+              The HTML you type in this box is presented to the user when
+              they attempt to perform these actions, and should explain
+              why the account was disabled.
+            </p><p>
+              Users with disabled accounts will continue to receive
+              mail from Bugzilla; furthermore, they will not be able
+              to log in themselves to change their own preferences and
+              stop it. If you want an account (disabled or active) to
+              stop receiving mail, simply check the
+              <span class="quote">“<span class="quote">Bugmail Disabled</span>”</span> checkbox above.
+            </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+                Even users whose accounts have been disabled can still
+                submit bugs via the e-mail gateway, if one exists.
+                The e-mail gateway should <span class="emphasis"><em>not</em></span> be
+                enabled for secure installations of Bugzilla.
+              </p></td></tr></table></div><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+                Don't disable all the administrator accounts!
+              </p></td></tr></table></div></li><li class="listitem"><p>
+            <span class="emphasis"><em>&lt;groupname&gt;</em></span>: 
+            If you have created some groups, e.g. "securitysensitive", then
+            checkboxes will appear here to allow you to add users to, or
+            remove them from, these groups. The first checkbox gives the
+            user the ability to add and remove other users as members of
+            this group. The second checkbox adds the user himself as a member
+            of the group.
+            </p></li><li class="listitem"><p>
+            <span class="emphasis"><em>canconfirm</em></span>: 
+            This field is only used if you have enabled the "unconfirmed"
+            status. If you enable this for a user,
+            that user can then move bugs from "Unconfirmed" to a "Confirmed"
+            status (e.g.: "New" status).</p></li><li class="listitem"><p>
+            <span class="emphasis"><em>creategroups</em></span>: 
+            This option will allow a user to create and destroy groups in
+            Bugzilla.</p></li><li class="listitem"><p>
+            <span class="emphasis"><em>editbugs</em></span>: 
+            Unless a user has this bit set, they can only edit those bugs
+            for which they are the assignee or the reporter. Even if this
+            option is unchecked, users can still add comments to bugs.
+            </p></li><li class="listitem"><p>
+            <span class="emphasis"><em>editcomponents</em></span>: 
+            This flag allows a user to create new products and components,
+            as well as modify and destroy those that have no bugs associated
+            with them. If a product or component has bugs associated with it,
+            those bugs must be moved to a different product or component
+            before Bugzilla will allow them to be destroyed.
+            </p></li><li class="listitem"><p>
+            <span class="emphasis"><em>editkeywords</em></span>: 
+            If you use Bugzilla's keyword functionality, enabling this
+            feature allows a user to create and destroy keywords. As always,
+            the keywords for existing bugs containing the keyword the user
+            wishes to destroy must be changed before Bugzilla will allow it
+            to die.</p></li><li class="listitem"><p>
+            <span class="emphasis"><em>editusers</em></span>: 
+            This flag allows a user to do what you're doing right now: edit
+            other users. This will allow those with the right to do so to
+            remove administrator privileges from other users or grant them to
+            themselves. Enable with care.</p></li><li class="listitem"><p>
+            <span class="emphasis"><em>tweakparams</em></span>: 
+            This flag allows a user to change Bugzilla's Params 
+            (using <code class="filename">editparams.cgi</code>.)</p></li><li class="listitem"><p> 
+            <span class="emphasis"><em>&lt;productname&gt;</em></span>:
+            This allows an administrator to specify the products 
+            in which a user can see bugs. If you turn on the 
+            <span class="quote">“<span class="quote">makeproductgroups</span>”</span> parameter in
+            the Group Security Panel in the Parameters page, 
+            then Bugzilla creates one group per product (at the time you create 
+            the product), and this group has exactly the same name as the 
+            product itself. Note that for products that already exist when
+            the parameter is turned on, the corresponding group will not be
+            created. The user must still have the <span class="quote">“<span class="quote">editbugs</span>”</span> 
+            privilege to edit bugs in these products.</p></li></ul></div></div><div class="section" title="3.2.2.4. Deleting Users"><div class="titlepage"><div><div><h4 class="title"><a name="user-account-deletion"></a>3.2.2.4. Deleting Users</h4></div></div></div><p>
+          If the <span class="quote">“<span class="quote">allowuserdeletion</span>”</span> parameter is turned on, see
+          <a class="xref" href="parameters.html" title="3.1. Bugzilla Configuration">Section 3.1, “Bugzilla Configuration”</a>, then you can also delete user accounts.
+          Note that this is most of the time not the best thing to do. If only
+          a warning in a yellow box is displayed, then the deletion is safe.
+          If a warning is also displayed in a red box, then you should NOT try
+          to delete the user account, else you will get referential integrity
+          problems in your database, which can lead to unexpected behavior,
+          such as bugs not appearing in bug lists anymore, or data displaying
+          incorrectly. You have been warned!
+        </p></div><div class="section" title="3.2.2.5. Impersonating Users"><div class="titlepage"><div><div><h4 class="title"><a name="impersonatingusers"></a>3.2.2.5. Impersonating Users</h4></div></div></div><p>
+        There may be times when an administrator would like to do something as
+        another user.  The <span class="command"><strong>sudo</strong></span> feature may be used to do 
+        this.
+        </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          To use the sudo feature, you must be in the
+          <span class="emphasis"><em>bz_sudoers</em></span> group.  By default, all
+          administrators are in this group.</p></td></tr></table></div><p>
+        If you have access to this feature, you may start a session by
+        going to the Edit Users page, Searching for a user and clicking on 
+        their login.  You should see a link below their login name titled 
+        "Impersonate this user".  Click on the link.  This will take you 
+        to a page where you will see a description of the feature and 
+        instructions for using it.  After reading the text, simply 
+        enter the login of the user you would like to impersonate, provide 
+        a short message explaining why you are doing this, and press the 
+        button.</p><p>
+        As long as you are using this feature, everything you do will be done 
+        as if you were logged in as the user you are impersonating.</p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          The user you are impersonating will not be told about what you are 
+          doing.  If you do anything that results in mail being sent, that 
+          mail will appear to be from the user you are impersonating.  You 
+          should be extremely careful while using this feature.</p></td></tr></table></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="parameters.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="administration.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="classifications.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.1. Bugzilla Configuration </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.3. Classifications</td></tr></table></div></body></html>

diff --git a/docs/en/html/userpreferences.html b/docs/en/html/userpreferences.html
new file mode 100644 (file)
index 0000000..92cae41
--- /dev/null
+++ b/docs/en/html/userpreferences.html
@@ -0,0 +1,212 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>5.10. User Preferences</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="prev" href="timetracking.html" title="5.9. Time Tracking Information"><link rel="next" href="reporting.html" title="5.11. Reports and Charts"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.10. User Preferences</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="timetracking.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Using Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="reporting.html">Next</a></td></tr></table><hr></div><div class="section" title="5.10. User Preferences"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="userpreferences"></a>5.10. User Preferences</h2></div></div></div><p>
+    Once logged in, you can customize various aspects of
+    Bugzilla via the "Preferences" link in the page footer.
+    The preferences are split into five tabs:</p><div class="section" title="5.10.1. General Preferences"><div class="titlepage"><div><div><h3 class="title"><a name="generalpreferences"></a>5.10.1. General Preferences</h3></div></div></div><p>
+        This tab allows you to change several default settings of Bugzilla.
+      </p><div class="itemizedlist"><ul class="itemizedlist" type="disc" compact><li class="listitem"><p>
+            Bugzilla's general appearance (skin) - select which skin to use.
+            Bugzilla supports adding custom skins.
+          </p></li><li class="listitem"><p>
+            Quote the associated comment when you click on its reply link - sets
+            the behavior of the comment "Reply" link. Options include quoting the
+            full comment, just reference the comment number, or turn the link off.
+          </p></li><li class="listitem"><p>
+            Language used in email - select which language email will be sent in,
+            from the list of available languages.
+          </p></li><li class="listitem"><p>
+            After changing a bug - This controls what page is displayed after
+            changes to a bug are submitted. The options include to show the bug
+            just modified, to show the next bug in your list, or to do nothing.
+          </p></li><li class="listitem"><p>
+            Enable tags for bugs - turn bug tagging on or off.
+          </p></li><li class="listitem"><p>
+            Zoom textareas large when in use (requires JavaScript) - enable or
+            disable the automatic expanding of text areas when  text is being
+            entered into them. 
+          </p></li><li class="listitem"><p>
+            Field separator character for CSV files -
+            Select between a comma and semi-colon for exported CSV bug lists.
+          </p></li><li class="listitem"><p>
+            Automatically add me to the CC list of bugs I change - set default
+            behavior of CC list. Options include "Always", "Never", and "Only
+            if I have no role on them". 
+          </p></li><li class="listitem"><p>
+            When viewing a bug, show comments in this order -
+            controls the order of comments. Options include "Oldest
+            to Newest", "Newest to Oldest" and "Newest to Oldest, but keep the
+            bug description at the top".
+          </p></li><li class="listitem"><p>
+            Show a quip at the top of each bug list - controls
+            whether a quip will be shown on the Bug list page.
+          </p></li></ul></div></div><div class="section" title="5.10.2. Email Preferences"><div class="titlepage"><div><div><h3 class="title"><a name="emailpreferences"></a>5.10.2. Email Preferences</h3></div></div></div><p>
+        This tab allows you to enable or disable email notification on
+        specific events.
+      </p><p>
+        In general, users have almost complete control over how much (or
+        how little) email Bugzilla sends them. If you want to receive the
+        maximum amount of email possible, click the <span class="quote">“<span class="quote">Enable All 
+        Mail</span>”</span> button. If you don't want to receive any email from
+        Bugzilla at all, click the <span class="quote">“<span class="quote">Disable All Mail</span>”</span> button.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          A Bugzilla administrator can stop a user from receiving
+          bugmail by clicking the <span class="quote">“<span class="quote">Bugmail Disabled</span>”</span> checkbox
+          when editing the user account. This is a drastic step
+          best taken only for disabled accounts, as it overrides 
+          the user's individual mail preferences.
+        </p></td></tr></table></div><p>
+        There are two global options -- <span class="quote">“<span class="quote">Email me when someone
+        asks me to set a flag</span>”</span> and <span class="quote">“<span class="quote">Email me when someone
+        sets a flag I asked for</span>”</span>. These define how you want to
+        receive bugmail with regards to flags. Their use is quite
+        straightforward; enable the checkboxes if you want Bugzilla to
+        send you mail under either of the above conditions.
+      </p><p>
+        If you'd like to set your bugmail to something besides
+        'Completely ON' and 'Completely OFF', the
+        <span class="quote">“<span class="quote">Field/recipient specific options</span>”</span> table
+        allows you to do just that. The rows of the table
+        define events that can happen to a bug -- things like
+        attachments being added, new comments being made, the
+        priority changing, etc. The columns in the table define
+        your relationship with the bug:
+      </p><div class="itemizedlist"><ul class="itemizedlist" type="disc" compact><li class="listitem"><p>
+            Reporter - Where you are the person who initially
+            reported the bug. Your name/account appears in the
+            <span class="quote">“<span class="quote">Reporter:</span>”</span> field.
+          </p></li><li class="listitem"><p>
+            Assignee - Where you are the person who has been
+            designated as the one responsible for the bug. Your
+            name/account appears in the <span class="quote">“<span class="quote">Assigned To:</span>”</span>
+            field of the bug.
+          </p></li><li class="listitem"><p>
+            QA Contact - You are one of the designated
+            QA Contacts for the bug. Your account appears in the 
+            <span class="quote">“<span class="quote">QA Contact:</span>”</span> text-box of the bug.
+          </p></li><li class="listitem"><p>
+            CC - You are on the list CC List for the bug.
+            Your account appears in the <span class="quote">“<span class="quote">CC:</span>”</span> text box
+            of the bug.
+          </p></li><li class="listitem"><p>
+            Voter - You have placed one or more votes for the bug.
+            Your account appears only if someone clicks on the 
+            <span class="quote">“<span class="quote">Show votes for this bug</span>”</span> link on the bug.
+          </p></li></ul></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Some columns may not be visible for your installation, depending
+          on your site's configuration.
+        </p></td></tr></table></div><p>
+        To fine-tune your bugmail, decide the events for which you want
+        to receive bugmail; then decide if you want to receive it all
+        the time (enable the checkbox for every column), or only when
+        you have a certain relationship with a bug (enable the checkbox
+        only for those columns). For example: if you didn't want to
+        receive mail when someone added themselves to the CC list, you
+        could uncheck all the boxes in the <span class="quote">“<span class="quote">CC Field Changes</span>”</span>
+        line. As another example, if you never wanted to receive email
+        on bugs you reported unless the bug was resolved, you would
+        un-check all boxes in the <span class="quote">“<span class="quote">Reporter</span>”</span> column
+        except for the one on the <span class="quote">“<span class="quote">The bug is resolved or
+        verified</span>”</span> row.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Bugzilla adds the <span class="quote">“<span class="quote">X-Bugzilla-Reason</span>”</span> header to
+          all bugmail it sends, describing the recipient's relationship
+          (AssignedTo, Reporter, QAContact, CC, or Voter) to the bug.
+          This header can be used to do further client-side filtering.
+        </p></td></tr></table></div><p>
+        Bugzilla has a feature called <span class="quote">“<span class="quote">Users Watching</span>”</span>.
+        When you enter one or more comma-delineated user accounts (usually email
+        addresses) into the text entry box, you will receive a copy of all the
+        bugmail those users are sent (security settings permitting).
+        This powerful functionality enables seamless transitions as developers
+        change projects or users go on holiday.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          The ability to watch other users may not be available in all
+          Bugzilla installations. If you don't see this feature, and feel
+          that you need it, speak to your administrator.
+        </p></td></tr></table></div><p>
+        Each user listed in the <span class="quote">“<span class="quote">Users watching you</span>”</span> field
+        has you listed in their <span class="quote">“<span class="quote">Users to watch</span>”</span> list
+        and can get bugmail according to your relationship to the bug and
+        their <span class="quote">“<span class="quote">Field/recipient specific options</span>”</span> setting.
+      </p></div><div class="section" title="5.10.3. Saved Searches"><div class="titlepage"><div><div><h3 class="title"><a name="savedsearches"></a>5.10.3. Saved Searches</h3></div></div></div><p>
+      On this tab you can view and run any Saved Searches that you have
+      created, and also any Saved Searches that other members of the group
+      defined in the "querysharegroup" parameter have shared. 
+      Saved Searches can be added to the page footer from this screen. 
+      If somebody is sharing a Search with a group she or he is allowed to
+      <a class="link" href="groups.html" title="3.15. Groups and Group Security">assign users to</a>, the sharer may opt to have
+      the Search show up in the footer of the group's direct members by default.
+      </p></div><div class="section" title="5.10.4. Name and Password"><div class="titlepage"><div><div><h3 class="title"><a name="accountpreferences"></a>5.10.4. Name and Password</h3></div></div></div><p>On this tab, you can change your basic account information,
+      including your password, email address and real name. For security
+      reasons, in order to change anything on this page you must type your
+      <span class="emphasis"><em>current</em></span> password into the <span class="quote">“<span class="quote">Password</span>”</span>
+      field at the top of the page.
+      If you attempt to change your email address, a confirmation
+      email is sent to both the old and new addresses, with a link to use to
+      confirm the change. This helps to prevent account hijacking.</p></div><div class="section" title="5.10.5. Permissions"><div class="titlepage"><div><div><h3 class="title"><a name="permissionsettings"></a>5.10.5. Permissions</h3></div></div></div><p>
+      This is a purely informative page which outlines your current
+      permissions on this installation of Bugzilla.
+      </p><p>
+      A complete list of permissions is below. Only users with 
+      <span class="emphasis"><em>editusers</em></span> privileges can change the permissions 
+      of other users.
+      </p><div class="variablelist"><dl><dt><span class="term">
+            admin
+          </span></dt><dd><p> 
+             Indicates user is an Administrator.
+            </p></dd><dt><span class="term">
+            bz_canusewhineatothers
+          </span></dt><dd><p> 
+             Indicates user can configure whine reports for other users.
+            </p></dd><dt><span class="term">
+             bz_canusewhines
+          </span></dt><dd><p> 
+             Indicates user can configure whine reports for self.
+            </p></dd><dt><span class="term">
+             bz_quip_moderators
+          </span></dt><dd><p>
+             Indicates user can moderate quips.
+            </p></dd><dt><span class="term">
+             bz_sudoers
+          </span></dt><dd><p> 
+             Indicates user can perform actions as other users.
+            </p></dd><dt><span class="term">
+             bz_sudo_protect
+          </span></dt><dd><p> 
+             Indicates user cannot be impersonated by other users.
+            </p></dd><dt><span class="term">
+             canconfirm
+          </span></dt><dd><p> 
+             Indicates user can confirm a bug or mark it a duplicate.
+            </p></dd><dt><span class="term">
+             creategroups
+          </span></dt><dd><p> 
+             Indicates user can create and destroy groups.
+            </p></dd><dt><span class="term">
+             editbugs
+          </span></dt><dd><p> 
+             Indicates user can edit all bug fields.
+            </p></dd><dt><span class="term">
+             editclassifications
+          </span></dt><dd><p> 
+             Indicates user can create, destroy, and edit classifications.
+            </p></dd><dt><span class="term">
+             editcomponents
+          </span></dt><dd><p> 
+             Indicates user can create, destroy, and edit components.
+            </p></dd><dt><span class="term">
+             editkeywords
+          </span></dt><dd><p> 
+             Indicates user can create, destroy, and edit keywords.
+            </p></dd><dt><span class="term">
+             editusers
+          </span></dt><dd><p> 
+             Indicates user can edit or disable users.
+            </p></dd><dt><span class="term">
+             tweakparams
+          </span></dt><dd><p> 
+             Indicates user can change Parameters.
+            </p></dd></dl></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        For more information on how permissions work in Bugzilla (i.e. who can
+        change what), see  <a class="xref" href="cust-change-permissions.html" title="6.4. Customizing Who Can Change What">Section 6.4, “Customizing Who Can Change What”</a>. 
+        </p></td></tr></table></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="timetracking.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="using.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="reporting.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5.9. Time Tracking Information </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 5.11. Reports and Charts</td></tr></table></div></body></html>

diff --git a/docs/en/html/using-intro.html b/docs/en/html/using-intro.html
new file mode 100644 (file)
index 0000000..e09ffb7
--- /dev/null
+++ b/docs/en/html/using-intro.html
@@ -0,0 +1,12 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>5.1. Introduction</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="prev" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="next" href="myaccount.html" title="5.2. Create a Bugzilla Account"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.1. Introduction</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="using.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Using Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="myaccount.html">Next</a></td></tr></table><hr></div><div class="section" title="5.1. Introduction"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="using-intro"></a>5.1. Introduction</h2></div></div></div><p>This section contains information for end-users of Bugzilla.  There
+    is a Bugzilla test installation, called
+    <a class="ulink" href="http://landfill.bugzilla.org/" target="_top">Landfill</a>, which you are
+    welcome to play with (if it's up). However, not all of the Bugzilla
+    installations there will necessarily have all Bugzilla features enabled,
+    and different installations run different versions, so some things may not
+    quite work as this document describes.</p><p>
+      Frequently Asked Questions (FAQ) are available and answered on
+      <a class="ulink" href="http://wiki.mozilla.org/Bugzilla:FAQ" target="_top">wiki.mozilla.org</a>.
+      They may cover some questions you have which are left unanswered.
+    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="using.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="using.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="myaccount.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 5. Using Bugzilla </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 5.2. Create a Bugzilla Account</td></tr></table></div></body></html>

diff --git a/docs/en/html/using.html b/docs/en/html/using.html
new file mode 100644 (file)
index 0000000..7703a86
--- /dev/null
+++ b/docs/en/html/using.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 5. Using Bugzilla</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="prev" href="security-bugzilla.html" title="4.3. Bugzilla"><link rel="next" href="using-intro.html" title="5.1. Introduction"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 5. Using Bugzilla</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="security-bugzilla.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="using-intro.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 5. Using Bugzilla"><div class="titlepage"><div><div><h2 class="title"><a name="using"></a>Chapter 5. Using Bugzilla</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="using-intro.html">5.1. Introduction</a></span></dt><dt><span class="section"><a href="myaccount.html">5.2. Create a Bugzilla Account</a></span></dt><dt><span class="section"><a href="bug_page.html">5.3. Anatomy of a Bug</a></span></dt><dt><span class="section"><a href="lifecycle.html">5.4. Life Cycle of a Bug</a></span></dt><dt><span class="section"><a href="query.html">5.5. Searching for Bugs</a></span></dt><dd><dl><dt><span class="section"><a href="query.html#boolean">5.5.1. Boolean Charts</a></span></dt><dt><span class="section"><a href="query.html#quicksearch">5.5.2. Quicksearch</a></span></dt><dt><span class="section"><a href="query.html#casesensitivity">5.5.3. Case Sensitivity in Searches</a></span></dt><dt><span class="section"><a href="query.html#list">5.5.4. Bug Lists</a></span></dt><dt><span class="section"><a href="query.html#individual-buglists">5.5.5. Adding/removing tags to/from bugs</a></span></dt></dl></dd><dt><span class="section"><a href="bugreports.html">5.6. Filing Bugs</a></span></dt><dd><dl><dt><span class="section"><a href="bugreports.html#fillingbugs">5.6.1. Reporting a New Bug</a></span></dt><dt><span class="section"><a href="bugreports.html#cloningbugs">5.6.2. Clone an Existing Bug</a></span></dt></dl></dd><dt><span class="section"><a href="attachments.html">5.7. Attachments</a></span></dt><dd><dl><dt><span class="section"><a href="attachments.html#patchviewer">5.7.1. Patch Viewer</a></span></dt></dl></dd><dt><span class="section"><a href="hintsandtips.html">5.8. Hints and Tips</a></span></dt><dd><dl><dt><span class="section"><a href="hintsandtips.html#idp13714560">5.8.1. Autolinkification</a></span></dt><dt><span class="section"><a href="hintsandtips.html#commenting">5.8.2. Comments</a></span></dt><dt><span class="section"><a href="hintsandtips.html#comment-wrapping">5.8.3. Server-Side Comment Wrapping</a></span></dt><dt><span class="section"><a href="hintsandtips.html#dependencytree">5.8.4. Dependency Tree</a></span></dt></dl></dd><dt><span class="section"><a href="timetracking.html">5.9. Time Tracking Information</a></span></dt><dt><span class="section"><a href="userpreferences.html">5.10. User Preferences</a></span></dt><dd><dl><dt><span class="section"><a href="userpreferences.html#generalpreferences">5.10.1. General Preferences</a></span></dt><dt><span class="section"><a href="userpreferences.html#emailpreferences">5.10.2. Email Preferences</a></span></dt><dt><span class="section"><a href="userpreferences.html#savedsearches">5.10.3. Saved Searches</a></span></dt><dt><span class="section"><a href="userpreferences.html#accountpreferences">5.10.4. Name and Password</a></span></dt><dt><span class="section"><a href="userpreferences.html#permissionsettings">5.10.5. Permissions</a></span></dt></dl></dd><dt><span class="section"><a href="reporting.html">5.11. Reports and Charts</a></span></dt><dd><dl><dt><span class="section"><a href="reporting.html#reports">5.11.1. Reports</a></span></dt><dt><span class="section"><a href="reporting.html#charts">5.11.2. Charts</a></span></dt></dl></dd><dt><span class="section"><a href="flags.html">5.12. Flags</a></span></dt><dt><span class="section"><a href="whining.html">5.13. Whining</a></span></dt><dd><dl><dt><span class="section"><a href="whining.html#whining-overview">5.13.1. The Event</a></span></dt><dt><span class="section"><a href="whining.html#whining-schedule">5.13.2. Whining Schedule</a></span></dt><dt><span class="section"><a href="whining.html#whining-query">5.13.3. Whining Searches</a></span></dt><dt><span class="section"><a href="whining.html#idp7758112">5.13.4. Saving Your Changes</a></span></dt></dl></dd></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="security-bugzilla.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="using-intro.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.3. Bugzilla </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 5.1. Introduction</td></tr></table></div></body></html>

diff --git a/docs/en/html/versions.html b/docs/en/html/versions.html
new file mode 100644 (file)
index 0000000..f6f1ac2
--- /dev/null
+++ b/docs/en/html/versions.html
@@ -0,0 +1,8 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.6. Versions</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="components.html" title="3.5. Components"><link rel="next" href="milestones.html" title="3.7. Milestones"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.6. Versions</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="components.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="milestones.html">Next</a></td></tr></table><hr></div><div class="section" title="3.6. Versions"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="versions"></a>3.6. Versions</h2></div></div></div><p>Versions are the revisions of the product, such as "Flinders
+    3.1", "Flinders 95", and "Flinders 2000". Version is not a multi-select
+    field; the usual practice is to select the earliest version known to have
+    the bug.
+    </p><p>To create and edit Versions:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>From the "Edit product" screen, select "Edit Versions"</p></li><li class="listitem"><p>You will notice that the product already has the default
+        version "undefined". Click the "Add" link in the bottom right.</p></li><li class="listitem"><p>Enter the name of the Version. This field takes text only. 
+        Then click the "Add" button.</p></li></ol></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="components.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="administration.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="milestones.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.5. Components </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.7. Milestones</td></tr></table></div></body></html>

diff --git a/docs/en/html/voting.html b/docs/en/html/voting.html
new file mode 100644 (file)
index 0000000..1f36a7f
--- /dev/null
+++ b/docs/en/html/voting.html
@@ -0,0 +1,23 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.13. Voting</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="bug_status_workflow.html" title="3.12. Bug Status Workflow"><link rel="next" href="quips.html" title="3.14. Quips"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.13. Voting</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="bug_status_workflow.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="quips.html">Next</a></td></tr></table><hr></div><div class="section" title="3.13. Voting"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="voting"></a>3.13. Voting</h2></div></div></div><p>All of the code for voting in Bugzilla has been moved into an
+    extension, called "Voting", in the <code class="filename">extensions/Voting/</code>
+    directory. To enable it, you must remove the <code class="filename">disabled</code>
+    file from that directory, and run <code class="filename">checksetup.pl</code>.</p><p>Voting allows users to be given a pot of votes which they can allocate
+    to bugs, to indicate that they'd like them fixed. 
+    This allows developers to gauge
+    user need for a particular enhancement or bugfix. By allowing bugs with
+    a certain number of votes to automatically move from "UNCONFIRMED" to
+    "CONFIRMED", users of the bug system can help high-priority bugs garner
+    attention so they don't sit for a long time awaiting triage.</p><p>To modify Voting settings:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Navigate to the "Edit product" screen for the Product you
+        wish to modify</p></li><li class="listitem"><p><span class="emphasis"><em>Maximum Votes per person</em></span>:
+        Setting this field to "0" disables voting.</p></li><li class="listitem"><p><span class="emphasis"><em>Maximum Votes a person can put on a single
+         bug</em></span>: 
+         It should probably be some number lower than the
+        "Maximum votes per person". Don't set this field to "0" if
+        "Maximum votes per person" is non-zero; that doesn't make
+        any sense.</p></li><li class="listitem"><p><span class="emphasis"><em>Number of votes a bug in this product needs to
+        automatically get out of the UNCONFIRMED state</em></span>: 
+        Setting this field to "0" disables the automatic move of
+        bugs from UNCONFIRMED to CONFIRMED. 
+        </p></li><li class="listitem"><p>Once you have adjusted the values to your preference, click
+        "Update".</p></li></ol></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="bug_status_workflow.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="administration.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="quips.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.12. Bug Status Workflow </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.14. Quips</td></tr></table></div></body></html>

diff --git a/docs/en/html/whining.html b/docs/en/html/whining.html
new file mode 100644 (file)
index 0000000..5471770
--- /dev/null
+++ b/docs/en/html/whining.html
@@ -0,0 +1,126 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>5.13. Whining</title><link rel="stylesheet" href="../../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4 Release"><link rel="up" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="prev" href="flags.html" title="5.12. Flags"><link rel="next" href="customization.html" title="Chapter 6. Customizing Bugzilla"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.13. Whining</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="flags.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Using Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="customization.html">Next</a></td></tr></table><hr></div><div class="section" title="5.13. Whining"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="whining"></a>5.13. Whining</h2></div></div></div><p>
+      Whining is a feature in Bugzilla that can regularly annoy users at 
+      specified times.  Using this feature, users can execute saved searches 
+      at specific times (i.e. the 15th of the month at midnight) or at 
+      regular intervals (i.e. every 15 minutes on Sundays).  The results of the
+      searches are sent to the user, either as a single email or as one email 
+      per bug, along with some descriptive text.
+    </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        Throughout this section it will be assumed that all users are members 
+        of the bz_canusewhines group, membership in which is required in order 
+        to use the Whining system.  You can easily make all users members of 
+        the bz_canusewhines group by setting the User RegExp to ".*" (without 
+        the quotes).
+      </p><p>
+        Also worth noting is the bz_canusewhineatothers group.  Members of this
+        group can create whines for any user or group in Bugzilla using a 
+        extended form of the whining interface.  Features only available to 
+        members of the bz_canusewhineatothers group will be noted in the 
+        appropriate places.
+      </p></td></tr></table></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        For whining to work, a special Perl script must be executed at regular
+        intervals.  More information on this is available in 
+        <a class="xref" href="extraconfig.html#installation-whining" title="2.3.3. Whining">Section 2.3.3, “Whining”</a>.
+      </p></td></tr></table></div><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+        This section does not cover the whineatnews.pl script.  See
+        <a class="xref" href="extraconfig.html#installation-whining-cron" title="2.3.2. The Whining Cron">Section 2.3.2, “The Whining Cron”</a> for more information on 
+        The Whining Cron.
+      </p></td></tr></table></div><div class="section" title="5.13.1. The Event"><div class="titlepage"><div><div><h3 class="title"><a name="whining-overview"></a>5.13.1. The Event</h3></div></div></div><p>
+        The whining system defines an "Event" as one or more queries being 
+        executed at regular intervals, with the results of said queries (if
+        there are any) being emailed to the user.  Events are created by 
+        clicking on the "Add new event" button.
+      </p><p>
+        Once a new event is created, the first thing to set is the "Email 
+        subject line".  The contents of this field will be used in the subject
+        line of every email generated by this event.  In addition to setting a 
+        subject, space is provided to enter some descriptive text that will be 
+        included at the top of each message (to help you in understanding why 
+        you received the email in the first place).
+      </p><p>
+        The next step is to specify when the Event is to be run (the Schedule) 
+        and what searches are to be performed (the Searches).
+      </p></div><div class="section" title="5.13.2. Whining Schedule"><div class="titlepage"><div><div><h3 class="title"><a name="whining-schedule"></a>5.13.2. Whining Schedule</h3></div></div></div><p>
+         Each whining event is associated with zero or more schedules.  A 
+         schedule is used to specify when the query (specified below) is to be
+         run.  A new event starts out with no schedules (which means it will 
+         never run, as it is not scheduled to run).  To add a schedule, press
+         the "Add a new schedule" button.
+      </p><p>
+         Each schedule includes an interval, which you use to tell Bugzilla 
+         when the event should be run.  An event can be run on certain days of
+         the week, certain days of the month, during weekdays (defined as 
+         Monday through Friday), or every day.
+      </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Be careful if you set your event to run on the 29th, 30th, or 31st of
+          the month, as your event may not run exactly when expected.  If you 
+          want your event to run on the last day of the month, select "Last day
+          of the month" as the interval.
+        </p></td></tr></table></div><p>
+        Once you have specified the day(s) on which the event is to be run, you
+        should now specify the time at which the event is to be run.  You can 
+        have the event run at a certain hour on the specified day(s), or 
+        every hour, half-hour, or quarter-hour on the specified day(s).
+      </p><p>
+        If a single schedule does not execute an event as many times as you 
+        would want, you can create another schedule for the same event.  For 
+        example, if you want to run an event on days whose numbers are
+        divisible by seven, you would need to add four schedules to the event,
+        setting the schedules to run on the 7th, 14th, 21st, and 28th (one day 
+        per schedule) at whatever time (or times) you choose.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          If you are a member of the bz_canusewhineatothers group, then you
+          will be presented with another option: "Mail to".  Using this you 
+          can control who will receive the emails generated by this event.  You
+          can choose to send the emails to a single user (identified by email 
+          address) or a single group (identified by group name).  To send to 
+          multiple users or groups, create a new schedule for each additional 
+          user/group.
+        </p></td></tr></table></div></div><div class="section" title="5.13.3. Whining Searches"><div class="titlepage"><div><div><h3 class="title"><a name="whining-query"></a>5.13.3. Whining Searches</h3></div></div></div><p>
+        Each whining event is associated with zero or more searches.  A search
+        is any saved search to be run as part of the specified schedule (see
+        above).  You start out without any searches associated with the event
+        (which means that the event will not run, as there will never be any
+        results to return).  To add a search, press the "Include search" button.
+      </p><p>
+        The first field to examine in your newly added search is the Sort field.
+        Searches are run, and results included, in the order specified by the
+        Sort field.  Searches with smaller Sort values will run before searches
+        with bigger Sort values.
+      </p><p>
+        The next field to examine is the Search field.  This is where you 
+        choose the actual search that is to be run.  Instead of defining search
+        parameters here, you are asked to choose from the list of saved 
+        searches (the same list that appears at the bottom of every Bugzilla 
+        page).  You are only allowed to choose from searches that you have 
+        saved yourself (the default saved search, "My Bugs", is not a valid 
+        choice).  If you do not have any saved searches, you can take this 
+        opportunity to create one (see <a class="xref" href="query.html#list" title="5.5.4. Bug Lists">Section 5.5.4, “Bug Lists”</a>).
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          When running queries, the whining system acts as if you are the user
+          executing the query.  This means that the whining system will ignore
+          bugs that match your query, but that you cannot access.
+        </p></td></tr></table></div><p>
+        Once you have chosen the saved search to be executed, give the query a 
+        descriptive title.  This title will appear in the email, above the 
+        results of the query.  If you choose "One message per bug", the query 
+        title will appear at the top of each email that contains a bug matching
+        your query.
+      </p><p>
+        Finally, decide if the results of the query should be sent in a single
+        email, or if each bug should appear in its own email.
+      </p><div class="warning" title="Warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          Think carefully before checking the "One message per bug" box.  If
+          you create a query that matches thousands of bugs, you will receive 
+          thousands of emails!
+        </p></td></tr></table></div></div><div class="section" title="5.13.4. Saving Your Changes"><div class="titlepage"><div><div><h3 class="title"><a name="idp7758112"></a>5.13.4. Saving Your Changes</h3></div></div></div><p>
+        Once you have defined at least one schedule, and created at least one 
+        query, go ahead and "Update/Commit".  This will save your Event and make
+        it available for immediate execution.
+      </p><div class="note" title="Note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
+          If you ever feel like deleting your event, you may do so using the 
+          "Remove Event" button in the upper-right corner of each Event.  You 
+          can also modify an existing event, so long as you "Update/Commit" 
+          after completing your modifications.
+        </p></td></tr></table></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="flags.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="using.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="customization.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5.12. Flags </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 6. Customizing Bugzilla</td></tr></table></div></body></html>

diff --git a/docs/en/images/bzLifecycle.png b/docs/en/images/bzLifecycle.png
new file mode 100644 (file)
index 0000000..c38b573
Binary files /dev/null and b/docs/en/images/bzLifecycle.png differ

diff --git a/docs/en/images/bzLifecycle.xml b/docs/en/images/bzLifecycle.xml
new file mode 100644 (file)
index 0000000..fe4611d
--- /dev/null
+++ b/docs/en/images/bzLifecycle.xml
@@ -0,0 +1,1731 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<dia:diagram xmlns:dia="http://www.lysator.liu.se/~alla/dia/">
+  <dia:diagramdata>
+    <dia:attribute name="background">
+      <dia:color val="#ffffff"/>
+    </dia:attribute>
+    <dia:attribute name="pagebreak">
+      <dia:color val="#000099"/>
+    </dia:attribute>
+    <dia:attribute name="paper">
+      <dia:composite type="paper">
+        <dia:attribute name="name">
+          <dia:string>#A4#</dia:string>
+        </dia:attribute>
+        <dia:attribute name="tmargin">
+          <dia:real val="2.8222000598907471"/>
+        </dia:attribute>
+        <dia:attribute name="bmargin">
+          <dia:real val="2.8222000598907471"/>
+        </dia:attribute>
+        <dia:attribute name="lmargin">
+          <dia:real val="2.8222000598907471"/>
+        </dia:attribute>
+        <dia:attribute name="rmargin">
+          <dia:real val="2.8222000598907471"/>
+        </dia:attribute>
+        <dia:attribute name="is_portrait">
+          <dia:boolean val="true"/>
+        </dia:attribute>
+        <dia:attribute name="scaling">
+          <dia:real val="1"/>
+        </dia:attribute>
+        <dia:attribute name="fitto">
+          <dia:boolean val="false"/>
+        </dia:attribute>
+      </dia:composite>
+    </dia:attribute>
+    <dia:attribute name="grid">
+      <dia:composite type="grid">
+        <dia:attribute name="width_x">
+          <dia:real val="1"/>
+        </dia:attribute>
+        <dia:attribute name="width_y">
+          <dia:real val="1"/>
+        </dia:attribute>
+        <dia:attribute name="visible_x">
+          <dia:int val="1"/>
+        </dia:attribute>
+        <dia:attribute name="visible_y">
+          <dia:int val="1"/>
+        </dia:attribute>
+        <dia:composite type="color"/>
+      </dia:composite>
+    </dia:attribute>
+    <dia:attribute name="color">
+      <dia:color val="#d8e5e5"/>
+    </dia:attribute>
+    <dia:attribute name="guides">
+      <dia:composite type="guides">
+        <dia:attribute name="hguides"/>
+        <dia:attribute name="vguides"/>
+      </dia:composite>
+    </dia:attribute>
+  </dia:diagramdata>
+  <dia:layer name="Background" visible="true" active="true">
+    <dia:object type="Standard - Line" version="0" id="O0">
+      <dia:attribute name="obj_pos">
+        <dia:point val="25.05,2.6"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="24.6882,2.55;25.4118,5.0618"/>
+      </dia:attribute>
+      <dia:attribute name="conn_endpoints">
+        <dia:point val="25.05,2.6"/>
+        <dia:point val="25.05,4.95"/>
+      </dia:attribute>
+      <dia:attribute name="numcp">
+        <dia:int val="2"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow">
+        <dia:enum val="22"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_length">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_width">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:connections>
+        <dia:connection handle="1" to="O4" connection="2"/>
+      </dia:connections>
+    </dia:object>
+    <dia:object type="Standard - Line" version="0" id="O1">
+      <dia:attribute name="obj_pos">
+        <dia:point val="16,8.9"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="15.6382,8.85;16.3618,12.1118"/>
+      </dia:attribute>
+      <dia:attribute name="conn_endpoints">
+        <dia:point val="16,8.9"/>
+        <dia:point val="16,12"/>
+      </dia:attribute>
+      <dia:attribute name="numcp">
+        <dia:int val="1"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow">
+        <dia:enum val="22"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_length">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_width">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:connections>
+        <dia:connection handle="0" to="O5" connection="13"/>
+        <dia:connection handle="1" to="O6" connection="2"/>
+      </dia:connections>
+    </dia:object>
+    <dia:object type="Standard - Line" version="0" id="O2">
+      <dia:attribute name="obj_pos">
+        <dia:point val="16,14"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="15.6382,13.95;16.3618,17.1118"/>
+      </dia:attribute>
+      <dia:attribute name="conn_endpoints">
+        <dia:point val="16,14"/>
+        <dia:point val="16,17"/>
+      </dia:attribute>
+      <dia:attribute name="numcp">
+        <dia:int val="1"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow">
+        <dia:enum val="22"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_length">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_width">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:connections>
+        <dia:connection handle="0" to="O6" connection="13"/>
+        <dia:connection handle="1" to="O7" connection="2"/>
+      </dia:connections>
+    </dia:object>
+    <dia:object type="Standard - BezierLine" version="0" id="O3">
+      <dia:attribute name="obj_pos">
+        <dia:point val="16,18.9"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="15.6382,18.85;16.3618,22.2"/>
+      </dia:attribute>
+      <dia:attribute name="bez_points">
+        <dia:point val="16,18.9"/>
+        <dia:point val="16,22"/>
+        <dia:point val="16,19.2"/>
+        <dia:point val="16,22.2"/>
+      </dia:attribute>
+      <dia:attribute name="corner_types">
+        <dia:enum val="0"/>
+        <dia:enum val="0"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow">
+        <dia:enum val="22"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_length">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_width">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:connections>
+        <dia:connection handle="0" to="O7" connection="13"/>
+        <dia:connection handle="3" to="O8" connection="2"/>
+      </dia:connections>
+    </dia:object>
+    <dia:object type="Flowchart - Box" version="0" id="O4">
+      <dia:attribute name="obj_pos">
+        <dia:point val="21.81,4.95"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="21.76,4.9;28.34,7"/>
+      </dia:attribute>
+      <dia:attribute name="elem_corner">
+        <dia:point val="21.81,4.95"/>
+      </dia:attribute>
+      <dia:attribute name="elem_width">
+        <dia:real val="6.480000001490116"/>
+      </dia:attribute>
+      <dia:attribute name="elem_height">
+        <dia:real val="2"/>
+      </dia:attribute>
+      <dia:attribute name="border_width">
+        <dia:real val="0.10000000149011612"/>
+      </dia:attribute>
+      <dia:attribute name="show_background">
+        <dia:boolean val="true"/>
+      </dia:attribute>
+      <dia:attribute name="corner_radius">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="padding">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>#UNCONFIRMED#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="80" name="Helvetica-Bold"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="25.05,6.145"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="1"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Flowchart - Box" version="0" id="O5">
+      <dia:attribute name="obj_pos">
+        <dia:point val="13,7"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="12.95,6.95;19.05,8.95"/>
+      </dia:attribute>
+      <dia:attribute name="elem_corner">
+        <dia:point val="13,7"/>
+      </dia:attribute>
+      <dia:attribute name="elem_width">
+        <dia:real val="6"/>
+      </dia:attribute>
+      <dia:attribute name="elem_height">
+        <dia:real val="1.9000000000000001"/>
+      </dia:attribute>
+      <dia:attribute name="show_background">
+        <dia:boolean val="true"/>
+      </dia:attribute>
+      <dia:attribute name="corner_radius">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="padding">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>#CONFIRMED#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="80" name="Helvetica-Bold"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="16,8.145"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="1"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Flowchart - Box" version="0" id="O6">
+      <dia:attribute name="obj_pos">
+        <dia:point val="12.9625,12"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="12.9125,11.95;19.0875,14.05"/>
+      </dia:attribute>
+      <dia:attribute name="elem_corner">
+        <dia:point val="12.9625,12"/>
+      </dia:attribute>
+      <dia:attribute name="elem_width">
+        <dia:real val="6.0749999999999993"/>
+      </dia:attribute>
+      <dia:attribute name="elem_height">
+        <dia:real val="2"/>
+      </dia:attribute>
+      <dia:attribute name="show_background">
+        <dia:boolean val="true"/>
+      </dia:attribute>
+      <dia:attribute name="corner_radius">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="padding">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>#IN_PROGRESS#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="80" name="Helvetica-Bold"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="16,13.195"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="1"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Flowchart - Box" version="0" id="O7">
+      <dia:attribute name="obj_pos">
+        <dia:point val="13,17"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="12.95,16.95;19.05,18.95"/>
+      </dia:attribute>
+      <dia:attribute name="elem_corner">
+        <dia:point val="13,17"/>
+      </dia:attribute>
+      <dia:attribute name="elem_width">
+        <dia:real val="6"/>
+      </dia:attribute>
+      <dia:attribute name="elem_height">
+        <dia:real val="1.9000000000000001"/>
+      </dia:attribute>
+      <dia:attribute name="inner_color">
+        <dia:color val="#bfbfbf"/>
+      </dia:attribute>
+      <dia:attribute name="show_background">
+        <dia:boolean val="true"/>
+      </dia:attribute>
+      <dia:attribute name="corner_radius">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="padding">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>#RESOLVED#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="80" name="Helvetica-Bold"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="16,18.145"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="1"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Flowchart - Box" version="0" id="O8">
+      <dia:attribute name="obj_pos">
+        <dia:point val="13,22.2"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="12.95,22.15;19.05,24.15"/>
+      </dia:attribute>
+      <dia:attribute name="elem_corner">
+        <dia:point val="13,22.2"/>
+      </dia:attribute>
+      <dia:attribute name="elem_width">
+        <dia:real val="6"/>
+      </dia:attribute>
+      <dia:attribute name="elem_height">
+        <dia:real val="1.9000000000000001"/>
+      </dia:attribute>
+      <dia:attribute name="inner_color">
+        <dia:color val="#bfbfbf"/>
+      </dia:attribute>
+      <dia:attribute name="show_background">
+        <dia:boolean val="true"/>
+      </dia:attribute>
+      <dia:attribute name="corner_radius">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="padding">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>#VERIFIED#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="80" name="Helvetica-Bold"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="16,23.345"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="1"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O9">
+      <dia:attribute name="obj_pos">
+        <dia:point val="17.75,5.0625"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="17.75,4.6175;21.6275,5.775"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>#Bug determined
+to be present#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.59999999999999998"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="17.75,5.0625"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O10">
+      <dia:attribute name="obj_pos">
+        <dia:point val="16.3365,10.4"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="16.3365,9.955;21.394,11.1125"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>#Developer is working
+on the bug#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.59999999999999998"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="16.3365,10.4"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Flowchart - Box" version="0" id="O11">
+      <dia:attribute name="obj_pos">
+        <dia:point val="-1.03711,14.8573"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="-1.08711,14.8073;4.71289,20.1073"/>
+      </dia:attribute>
+      <dia:attribute name="elem_corner">
+        <dia:point val="-1.03711,14.8573"/>
+      </dia:attribute>
+      <dia:attribute name="elem_width">
+        <dia:real val="5.6999999999999993"/>
+      </dia:attribute>
+      <dia:attribute name="elem_height">
+        <dia:real val="5.1999999999999993"/>
+      </dia:attribute>
+      <dia:attribute name="inner_color">
+        <dia:color val="#bfbfbf"/>
+      </dia:attribute>
+      <dia:attribute name="show_background">
+        <dia:boolean val="true"/>
+      </dia:attribute>
+      <dia:attribute name="corner_radius">
+        <dia:real val="0.10000000000000001"/>
+      </dia:attribute>
+      <dia:attribute name="padding">
+        <dia:real val="0.14999999999999999"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>#Possible resolutions:
+  FIXED
+  DUPLICATE
+  WONTFIX
+  WORKSFORME
+  INVALID#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.59999999999999998"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="-0.93711,16.1023"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Line" version="0" id="O12">
+      <dia:attribute name="obj_pos">
+        <dia:point val="4.66289,18.7573"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="4.63788,18.7286;13.1714,18.7823"/>
+      </dia:attribute>
+      <dia:attribute name="conn_endpoints">
+        <dia:point val="4.66289,18.7573"/>
+        <dia:point val="13.1464,18.7536"/>
+      </dia:attribute>
+      <dia:attribute name="numcp">
+        <dia:int val="1"/>
+      </dia:attribute>
+      <dia:attribute name="line_width">
+        <dia:real val="0.050000000000000003"/>
+      </dia:attribute>
+      <dia:attribute name="line_style">
+        <dia:enum val="4"/>
+      </dia:attribute>
+      <dia:connections>
+        <dia:connection handle="0" to="O11" connection="10"/>
+        <dia:connection handle="1" to="O7" connection="11"/>
+      </dia:connections>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O13">
+      <dia:attribute name="obj_pos">
+        <dia:point val="16.4,15.6"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="16.4,15.155;19.8425,15.7125"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>#Fix checked in#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.59999999999999998"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="16.4,15.6"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O14">
+      <dia:attribute name="obj_pos">
+        <dia:point val="8.2865,16.95"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="8.2865,16.505;12.294,17.6625"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>#QA not satisfied
+with the solution#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.59999999999999998"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="8.2865,16.95"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O15">
+      <dia:attribute name="obj_pos">
+        <dia:point val="16.2865,20.5"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="16.2865,20.055;20.6865,21.2125"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>#QA verifies that
+the solution works#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.59999999999999998"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="16.2865,20.5"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O16">
+      <dia:attribute name="obj_pos">
+        <dia:point val="6.4365,22.7"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="6.4365,22.255;12.494,22.8125"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>#Fix turns out to be wrong#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.59999999999999998"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="6.4365,22.7"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O17">
+      <dia:attribute name="obj_pos">
+        <dia:point val="22.8,22.15"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="22.8,21.705;27.85,22.8625"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>#Bug is reopened,
+was never confirmed#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.59999999999999998"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="22.8,22.15"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O18">
+      <dia:attribute name="obj_pos">
+        <dia:point val="16,7.95"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="16,7.355;16,8.1"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>##</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="16,7.95"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+      <dia:connections>
+        <dia:connection handle="0" to="O5" connection="16"/>
+      </dia:connections>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O19">
+      <dia:attribute name="obj_pos">
+        <dia:point val="16.9,10.5125"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="16.9,9.9175;16.9,10.6625"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>##</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="16.9,10.5125"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O20">
+      <dia:attribute name="obj_pos">
+        <dia:point val="19.55,15.6125"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="19.55,15.0175;19.55,15.7625"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>##</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="19.55,15.6125"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O21">
+      <dia:attribute name="obj_pos">
+        <dia:point val="20.3,20.8625"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="20.3,20.2675;20.3,21.0125"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>##</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="20.3,20.8625"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O22">
+      <dia:attribute name="obj_pos">
+        <dia:point val="20.2,20.8625"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="20.2,20.2675;20.2,21.0125"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>##</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="20.2,20.8625"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O23">
+      <dia:attribute name="obj_pos">
+        <dia:point val="19.75,21.0625"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="19.75,20.4675;19.75,21.2125"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>##</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="19.75,21.0625"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O24">
+      <dia:attribute name="obj_pos">
+        <dia:point val="12.8,1.5125"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="12.8,0.9175;12.8,1.6625"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>##</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="12.8,1.5125"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O25">
+      <dia:attribute name="obj_pos">
+        <dia:point val="13.7,15.7625"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="13.7,15.1675;13.7,15.9125"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>##</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="13.7,15.7625"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O26">
+      <dia:attribute name="obj_pos">
+        <dia:point val="9.65,11.7125"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="9.65,11.2675;13.555,12.4247"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>#Developer stops
+work on bug#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.59972222571740919"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="9.65,11.7125"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O27">
+      <dia:attribute name="obj_pos">
+        <dia:point val="20.55,19.0625"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="20.55,18.6175;26.5875,19.7747"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>#Bug is not fixable
+(e.g because it is invalid)#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.59972222571740919"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="20.55,19.0625"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - ZigZagLine" version="1" id="O28">
+      <dia:attribute name="obj_pos">
+        <dia:point val="12.9625,13"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="9.3,8.0632;13.1118,13.05"/>
+      </dia:attribute>
+      <dia:attribute name="orth_points">
+        <dia:point val="12.9625,13"/>
+        <dia:point val="9.35,13"/>
+        <dia:point val="9.35,8.425"/>
+        <dia:point val="13,8.425"/>
+      </dia:attribute>
+      <dia:attribute name="orth_orient">
+        <dia:enum val="0"/>
+        <dia:enum val="1"/>
+        <dia:enum val="0"/>
+      </dia:attribute>
+      <dia:attribute name="autorouting">
+        <dia:boolean val="false"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow">
+        <dia:enum val="22"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_length">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_width">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:connections>
+        <dia:connection handle="0" to="O6" connection="7"/>
+        <dia:connection handle="1" to="O5" connection="9"/>
+      </dia:connections>
+    </dia:object>
+    <dia:object type="Standard - ZigZagLine" version="1" id="O29">
+      <dia:attribute name="obj_pos">
+        <dia:point val="13,17.95"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="7.65,7.5882;13.1118,18"/>
+      </dia:attribute>
+      <dia:attribute name="orth_points">
+        <dia:point val="13,17.95"/>
+        <dia:point val="7.7,17.95"/>
+        <dia:point val="7.7,7.95"/>
+        <dia:point val="13,7.95"/>
+      </dia:attribute>
+      <dia:attribute name="orth_orient">
+        <dia:enum val="0"/>
+        <dia:enum val="1"/>
+        <dia:enum val="0"/>
+      </dia:attribute>
+      <dia:attribute name="autorouting">
+        <dia:boolean val="false"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow">
+        <dia:enum val="22"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_length">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_width">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:connections>
+        <dia:connection handle="0" to="O7" connection="7"/>
+        <dia:connection handle="1" to="O5" connection="7"/>
+      </dia:connections>
+    </dia:object>
+    <dia:object type="Standard - ZigZagLine" version="1" id="O30">
+      <dia:attribute name="obj_pos">
+        <dia:point val="13,23.15"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="5.9,7.1132;13.1118,23.2"/>
+      </dia:attribute>
+      <dia:attribute name="orth_points">
+        <dia:point val="13,23.15"/>
+        <dia:point val="5.95,23.15"/>
+        <dia:point val="5.95,7.475"/>
+        <dia:point val="13,7.475"/>
+      </dia:attribute>
+      <dia:attribute name="orth_orient">
+        <dia:enum val="0"/>
+        <dia:enum val="1"/>
+        <dia:enum val="0"/>
+      </dia:attribute>
+      <dia:attribute name="autorouting">
+        <dia:boolean val="false"/>
+      </dia:attribute>
+      <dia:attribute name="line_style">
+        <dia:enum val="4"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow">
+        <dia:enum val="22"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_length">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_width">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:connections>
+        <dia:connection handle="0" to="O8" connection="7"/>
+        <dia:connection handle="1" to="O5" connection="5"/>
+      </dia:connections>
+    </dia:object>
+    <dia:object type="Standard - ZigZagLine" version="1" id="O31">
+      <dia:attribute name="obj_pos">
+        <dia:point val="19.0498,7.95"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="18.8882,7.9;22.7,17.8368"/>
+      </dia:attribute>
+      <dia:attribute name="orth_points">
+        <dia:point val="19.0498,7.95"/>
+        <dia:point val="22.65,7.95"/>
+        <dia:point val="22.65,17.475"/>
+        <dia:point val="19,17.475"/>
+      </dia:attribute>
+      <dia:attribute name="orth_orient">
+        <dia:enum val="0"/>
+        <dia:enum val="1"/>
+        <dia:enum val="0"/>
+      </dia:attribute>
+      <dia:attribute name="autorouting">
+        <dia:boolean val="false"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow">
+        <dia:enum val="22"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_length">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_width">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:connections>
+        <dia:connection handle="0" to="O5" connection="16"/>
+        <dia:connection handle="1" to="O7" connection="6"/>
+      </dia:connections>
+    </dia:object>
+    <dia:object type="Standard - ZigZagLine" version="1" id="O32">
+      <dia:attribute name="obj_pos">
+        <dia:point val="26.67,6.95"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="18.8882,6.9;26.72,18.7868"/>
+      </dia:attribute>
+      <dia:attribute name="orth_points">
+        <dia:point val="26.67,6.95"/>
+        <dia:point val="26.67,18.425"/>
+        <dia:point val="19,18.425"/>
+      </dia:attribute>
+      <dia:attribute name="orth_orient">
+        <dia:enum val="1"/>
+        <dia:enum val="0"/>
+      </dia:attribute>
+      <dia:attribute name="autorouting">
+        <dia:boolean val="true"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow">
+        <dia:enum val="22"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_length">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_width">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:connections>
+        <dia:connection handle="0" to="O4" connection="14"/>
+        <dia:connection handle="1" to="O7" connection="10"/>
+      </dia:connections>
+    </dia:object>
+    <dia:object type="Standard - ZigZagLine" version="1" id="O33">
+      <dia:attribute name="obj_pos">
+        <dia:point val="23.43,6.95"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="18.9257,6.9;23.48,13.3618"/>
+      </dia:attribute>
+      <dia:attribute name="orth_points">
+        <dia:point val="23.43,6.95"/>
+        <dia:point val="23.43,13"/>
+        <dia:point val="19.0375,13"/>
+      </dia:attribute>
+      <dia:attribute name="orth_orient">
+        <dia:enum val="1"/>
+        <dia:enum val="0"/>
+      </dia:attribute>
+      <dia:attribute name="autorouting">
+        <dia:boolean val="true"/>
+      </dia:attribute>
+      <dia:attribute name="line_style">
+        <dia:enum val="4"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow">
+        <dia:enum val="22"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_length">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_width">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:connections>
+        <dia:connection handle="0" to="O4" connection="12"/>
+        <dia:connection handle="1" to="O6" connection="8"/>
+      </dia:connections>
+    </dia:object>
+    <dia:object type="Standard - ZigZagLine" version="1" id="O34">
+      <dia:attribute name="obj_pos">
+        <dia:point val="19,17.95"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="18.95,6.8382;25.4118,18"/>
+      </dia:attribute>
+      <dia:attribute name="orth_points">
+        <dia:point val="19,17.95"/>
+        <dia:point val="25.05,17.95"/>
+        <dia:point val="25.05,6.95"/>
+      </dia:attribute>
+      <dia:attribute name="orth_orient">
+        <dia:enum val="0"/>
+        <dia:enum val="1"/>
+      </dia:attribute>
+      <dia:attribute name="autorouting">
+        <dia:boolean val="true"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow">
+        <dia:enum val="22"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_length">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_width">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:connections>
+        <dia:connection handle="0" to="O7" connection="8"/>
+        <dia:connection handle="1" to="O4" connection="13"/>
+      </dia:connections>
+    </dia:object>
+    <dia:object type="Standard - ZigZagLine" version="1" id="O35">
+      <dia:attribute name="obj_pos">
+        <dia:point val="19,23.15"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="19,6.69175;28.5054,23.2"/>
+      </dia:attribute>
+      <dia:attribute name="orth_points">
+        <dia:point val="19,23.15"/>
+        <dia:point val="19,23.15"/>
+        <dia:point val="28.1436,23.15"/>
+        <dia:point val="28.1436,6.80355"/>
+      </dia:attribute>
+      <dia:attribute name="orth_orient">
+        <dia:enum val="1"/>
+        <dia:enum val="0"/>
+        <dia:enum val="1"/>
+      </dia:attribute>
+      <dia:attribute name="autorouting">
+        <dia:boolean val="false"/>
+      </dia:attribute>
+      <dia:attribute name="line_style">
+        <dia:enum val="4"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow">
+        <dia:enum val="22"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_length">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_width">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:connections>
+        <dia:connection handle="0" to="O8" connection="8"/>
+        <dia:connection handle="1" to="O4" connection="15"/>
+      </dia:connections>
+    </dia:object>
+    <dia:object type="Standard - Line" version="0" id="O36">
+      <dia:attribute name="obj_pos">
+        <dia:point val="16,0.65"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="15.6382,0.6;16.3618,7.1118"/>
+      </dia:attribute>
+      <dia:attribute name="conn_endpoints">
+        <dia:point val="16,0.65"/>
+        <dia:point val="16,7"/>
+      </dia:attribute>
+      <dia:attribute name="numcp">
+        <dia:int val="1"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow">
+        <dia:enum val="22"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_length">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_width">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:connections>
+        <dia:connection handle="1" to="O5" connection="2"/>
+      </dia:connections>
+    </dia:object>
+    <dia:object type="Standard - ZigZagLine" version="1" id="O37">
+      <dia:attribute name="obj_pos">
+        <dia:point val="21.81,5.95"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="17.1382,5.9;21.86,7.1118"/>
+      </dia:attribute>
+      <dia:attribute name="orth_points">
+        <dia:point val="21.81,5.95"/>
+        <dia:point val="17.5,5.95"/>
+        <dia:point val="17.5,7"/>
+      </dia:attribute>
+      <dia:attribute name="orth_orient">
+        <dia:enum val="0"/>
+        <dia:enum val="1"/>
+      </dia:attribute>
+      <dia:attribute name="autorouting">
+        <dia:boolean val="true"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow">
+        <dia:enum val="22"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_length">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_width">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:connections>
+        <dia:connection handle="0" to="O4" connection="7"/>
+        <dia:connection handle="1" to="O5" connection="3"/>
+      </dia:connections>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O38">
+      <dia:attribute name="obj_pos">
+        <dia:point val="20.65,1.05"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="20.65,0.605;28.575,2.36194"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>#Bug is filed by a non-empowered
+user in a product where the
+UNCONFIRMED state is enabled#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.59972222571740919"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="20.65,1.05"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O39">
+      <dia:attribute name="obj_pos">
+        <dia:point val="26.65,1.5"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="26.65,0.905;26.65,1.65"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>##</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="26.65,1.5"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O40">
+      <dia:attribute name="obj_pos">
+        <dia:point val="21.2,5.2"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="21.2,4.605;21.2,5.35"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>##</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="21.2,5.2"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O41">
+      <dia:attribute name="obj_pos">
+        <dia:point val="12.95,10.85"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="12.95,10.255;12.95,11"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>##</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="12.95,10.85"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O42">
+      <dia:attribute name="obj_pos">
+        <dia:point val="18.95,15.45"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="18.95,14.855;18.95,15.6"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>##</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="18.95,15.45"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O43">
+      <dia:attribute name="obj_pos">
+        <dia:point val="21,15.55"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="21,14.955;21,15.7"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>##</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="21,15.55"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O44">
+      <dia:attribute name="obj_pos">
+        <dia:point val="13.6,20.7"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="13.6,20.105;13.6,20.85"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>##</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="13.6,20.7"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O45">
+      <dia:attribute name="obj_pos">
+        <dia:point val="24.35,9.7"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="24.35,9.105;24.35,9.85"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>##</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="24.35,9.7"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O46">
+      <dia:attribute name="obj_pos">
+        <dia:point val="23.85,9.95"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="23.85,9.355;23.85,10.1"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>##</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="23.85,9.95"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
+  </dia:layer>
+</dia:diagram>

diff --git a/docs/en/images/callouts/1.gif b/docs/en/images/callouts/1.gif
new file mode 100644 (file)
index 0000000..79fd388
Binary files /dev/null and b/docs/en/images/callouts/1.gif differ

diff --git a/docs/en/images/callouts/2.gif b/docs/en/images/callouts/2.gif
new file mode 100644 (file)
index 0000000..b9be050
Binary files /dev/null and b/docs/en/images/callouts/2.gif differ

diff --git a/docs/en/images/callouts/3.gif b/docs/en/images/callouts/3.gif
new file mode 100644 (file)
index 0000000..73635e3
Binary files /dev/null and b/docs/en/images/callouts/3.gif differ

diff --git a/docs/en/images/caution.gif b/docs/en/images/caution.gif
new file mode 100644 (file)
index 0000000..a482230
Binary files /dev/null and b/docs/en/images/caution.gif differ

diff --git a/docs/en/images/note.gif b/docs/en/images/note.gif
new file mode 100644 (file)
index 0000000..613bc7f
Binary files /dev/null and b/docs/en/images/note.gif differ

diff --git a/docs/en/images/tip.gif b/docs/en/images/tip.gif
new file mode 100644 (file)
index 0000000..c8d5ae9
Binary files /dev/null and b/docs/en/images/tip.gif differ

diff --git a/docs/en/images/warning.gif b/docs/en/images/warning.gif
new file mode 100644 (file)
index 0000000..693ffc3
Binary files /dev/null and b/docs/en/images/warning.gif differ

diff --git a/docs/en/rel_notes.txt b/docs/en/rel_notes.txt
new file mode 100644 (file)
index 0000000..4014951
--- /dev/null
+++ b/docs/en/rel_notes.txt
@@ -0,0 +1,3028 @@
+Release Notes for Bugzilla version 3.0 and higher are available in HTML
+format, either on the bugzilla.org website, or in your current installation,
+linked from the index page.
+
+bugzilla.org links for release notes
+------------------------------------
+3.0.2: http://www.bugzilla.org/releases/3.0.2/release-notes.html
+
+***************************************
+*** The Bugzilla 2.22 Release Notes ***
+***************************************
+
+Table of Contents
+*****************
+
+- Introduction
+- Important Updates In This Point Release
+- Minimum Requirements
+    * Perl
+    * For MySQL Users
+    * For PostgreSQL Users
+    * Required Perl Modules
+    * Optional Perl Modules
+- What's New?
+    * Complete PostgreSQL Support
+    * Parameters In Sections
+    * One Codebase, Multiple Databases
+    * UTF-8 for New Installations
+    * Admins Can Impersonate Users
+    * Bug Import and Moving Improvements
+    * Adding Individual Bugs to Saved Searches
+    * Attach URLs
+    * Optional "Strict Isolation" for Groups
+    * "editcomponents" Change
+    * "shutdownhtml" Change
+    * Miscellaneous Improvements
+    * All Changes
+- Deprecated Features
+- Outstanding Issues (<======================== IMPORTANT, PLEASE READ)
+- How to Upgrade From An Older Bugzilla
+    * Steps for Upgrading
+- Code Changes Which May Affect Customizations
+    * CGI.pl is Gone
+    * Other Changes
+- Security Fixes In 2.22 Releases
+- Release Notes for Previous Versions
+
+Introduction
+************
+Bugzilla 2.22 is one of our most polished releases. We did a lot of
+small cleanups to make Bugzilla easier to use and more useful in
+many, many small ways, in addition to adding some major new features.
+
+This document contains the release notes for Bugzilla 2.22.
+In this document, recently added, changed, and removed features
+of Bugzilla are described. If you are upgrading from an older version,
+you will definitely want to read these release notes in detail, so that
+you have an idea of what has changed.
+
+If you are upgrading from a version before 2.20, also read the 2.20 
+release notes (lower in this file) and any previous release notes.
+
+If you are installing a new Bugzilla, you will still want to look over
+the release notes to see if there is any particularly important 
+information that affects your installation.
+
+If you would like to contribute code to Bugzilla, read our 
+Contributor's Guide at:
+
+http://www.bugzilla.org/docs/contributor.html
+
+
+Important Updates In This Point Release
+***************************************
+
+This section describes bugs fixed in releases after the original 2.22
+release.
+
+Version 2.22.2
+--------------
+
++ Make Bugzilla compatible with Template Toolkit 2.15 (bug 357374)
+
++ Make Bugzilla compatible with versions of MySQL higher than 5.0.25
+  (bug 321645)
+
++ Sanity Check can now only be run by people with the "admin" privilege.
+  (bug 91761)
+
+Version 2.22.1
+--------------
+
++ When sending mail, Bugzilla could throw the error "Insecure dependency in
+  exec while running with -T switch" (bug 340538).
+
++ Using the public webdot server (for dependency graphs) should work 
+  again (bug 351243).
+
++ The "I'm added to or removed from this capacity" email preference
+  wasn't working for new bugs (bug 349852).
+
++ The original release of 2.22 incorrectly said it required Template-Toolkit
+  version 2.08. In actual fact, Bugzilla requires version 2.10 (bug 351478).
+
++ votes.cgi would crash if your bug was the one confirming a bug (bug 351300).
+
++ checksetup.pl now correctly reports if your Template::Plugin::GD module
+  is missing. If missing, it could lead to charts and graphs not working
+  (bug 345389).
+
++ The "Keyword" field on buglist.cgi was not sorted alphabetically, so
+  it wasn't very useful for sorting (bug 342828).
+
++ Sendmail will no longer complain about there being a newline in the
+  email address, when Bugzilla sends mail (bug 331365).
+
++ contrib/bzdbcopy.pl would try to insert an invalid value into the
+  database, unnecessarily (bug 335572).
+
++ Deleting a bug now correctly deletes its attachments from the database
+  (bug 339667).
+
+
+Minimum Requirements
+********************
+
+Perl
+----
+
+  Perl v5.6.1              (Non-Windows platforms)
+  ActiveState Perl v5.8.1  (Windows only)
+
+  Note that this is the last release of Bugzilla to support perl 5.6.x--
+  future versions will require perl 5.8.
+
+For MySQL Users
+---------------
+
+  MySQL v4.0.14                    (changed from 2.20)
+  perl module: DBD::mysql v2.9003  (changed from 2.18)
+
+For PostgreSQL Users
+--------------------
+
+  PostgreSQL 7.3.x
+  perl module: DBD::Pg 1.31 (1.41 required for PostgreSQL 8+)
+
+  WARNING: DBD::Pg 1.43 has a bug which causes checksetup.pl to fail
+  and corrupt the database. If you are using DBD::Pg 1.43, either downgrade
+  to 1.41 or upgrade to 1.45 (1.42 and 1.44 seem broken somehow too).
+
+  Note that this is the last release of Bugzilla to support PostgreSQL 7.x.
+  Future versions will require PostgreSQL 8.0 and DBD::Pg 1.45.
+
+Required Perl Modules
+---------------------
+
+  AppConfig v1.52
+  CGI v2.93
+  Data::Dumper (any)
+  Date::Format v2.21
+  DBI v1.38
+  File::Spec v0.84
+  File::Temp (any)
+  Template Toolkit v2.10 (changed from 2.20)
+  Text::Wrap v2001.0131
+  Mail::Mailer v1.67     (changed from 2.20)
+  MIME::Base64 v3.01     (new in 2.22)
+  MIME::Parser v5.406    (new in 2.22)
+  Storable (any)
+
+  Note: The SMTP support in Mail::Mailer 1.73 (the most recent version)
+        is broken. The last known working version is 1.67.
+
+Optional Perl Modules
+---------------------
+
+  Chart::Base v1.0
+  GD v1.20
+  GD::Graph (any)
+  GD::Text::Align (any)
+  Net::LDAP (any)
+  PatchReader v0.9.4
+  XML::Twig (any)       (new in 2.22)
+  Image::Magick         (new in 2.22)
+
+
+What's New?
+***********
+
+Complete PostgreSQL Support
+---------------------------
+Bugzilla 2.20 contained experimental support for PostgreSQL.
+In Bugzilla 2.22, PostgreSQL support is fully complete and stable. Using
+PostgreSQL with Bugzilla should be as stable as using MySQL, and if
+you experience any problems they will be taken as seriously as if you
+were running MySQL.
+
+There are no known remaining major problems with Bugzilla on PostgreSQL.
+All features of Bugzilla have been tested and work.
+
+
+Parameters In Sections
+----------------------
+Long-time users of Bugzilla know that over time the parameter list has
+grown quite large. It has now been split into sections to make it easier
+to use.
+
+
+One Codebase, Multiple Databases
+--------------------------------
+There is now limited support for having multiple projects use the
+same Bugzilla codebase, but all have separate databases.
+
+The different projects can have their own templates and their own
+bug database, but all use the same set of Bugzilla code in the same
+directory.
+
+To enable this, set an environment variable called PROJECT when
+calling the Bugzilla CGIs. Then for each project, you can have
+a localconfig.PROJECT (where "PROJECT" is the value of the PROJECT
+environment variable) file for the database parameters, and a 
+template/en/PROJECT directory (where "PROJECT" is the value of the
+PROJECT environment variable)
+
+This feature isn't documented yet, but we hope to have documentation for
+it soon.
+
+
+UTF-8 For New Installations
+---------------------------
+If this is the first time you're installing Bugzilla, it will now use
+UTF-8 encoding for all pages, automatically. It will also send emails
+in UTF-8. This eliminates most of the internationalization problems
+users have experienced, as one Bugzilla page may now contain any number
+of languages simultaneously.
+
+If you are upgrading and you want to use UTF-8, just turn on the "utf8"
+Parameter. However, realize that if you have non-UTF-8 data in your 
+Bugzilla, it will appear unreadable. (If you just have ASCII in your
+database, you're safe to turn on the "utf8" parameter, definitely.)
+
+
+Admins Can Impersonate Users
+----------------------------
+User impersonation (think of the su/sudo command on Unix) allows you
+to view pages and perform actions as if you are logged in as someone else,
+without having to know their password.
+
+A user in the new "bz_sudoers" group has the option of "becoming"
+any user in Bugzilla. Once they "become" that user, they *are* that user
+for the rest of the session, until they decide to switch back to being
+themselves.
+
+However, they cannot "become" any user in the "bz_sudo_protect" group.
+This group includes everybody in the "admin" and "bz_sudoers" groups by 
+default.
+
+Any time a user is impersonated, they will get an email notifying them
+who has impersonated them.
+
+
+Bug Import and Moving Improvements
+----------------------------------
+The XML Import script, importxml.pl, has been completely re-written.
+
+It now:
+
+  * Correctly imports the "priority" field
+  * Understands when the "Reporter" or "CC List" security boxes 
+    are unchecked on the bug.
+  * Places bugs in the appropriate groups
+  * Allows attachments to be imported
+  * Is much more forgiving about small problems in the XML
+
+
+Adding Individual Bugs to Saved Searches (Tagging)
+--------------------------------------------------
+Users now have the option of adding an individual bug to any
+particular Saved Search. Individual users that disagree with the site
+default can add or remove this feature (which appears as an entry box
+visible in the footer) by changing the General Preferences setting
+called "Enable tags for bugs".
+
+
+Attach URLs
+-----------
+Instead of attaching a file, you can now also attach a URL to a bug.
+This will show up just like an attachment on show_bug.cgi, but when
+you click on it, it will take you to the URL.
+
+To enable this, turn on the "allow_attach_url" parameter.
+
+
+Optional "Strict Isolation" for Groups
+--------------------------------------
+If you turn on the "strict_isolation" parameter in Bugzilla, you
+will *not* be able to add any user to the CC field (or set them
+as an Assignee or QA Contact) unless that user could normally see
+the bug. That is, you will no longer be able to "accidentally" 
+(or intentionally) give somebody access to a bug that they 
+otherwise couldn't see.
+
+
+"editcomponents" Change
+-----------------------
+Previously, all users who had "editcomponents" could see every Product,
+using the editcomponents.cgi script. Now, users with "editcomponents"
+can only see Products that they normally have access to.
+
+This restriction also affects editversions.cgi, editmilestones.cgi and
+editproducts.cgi.
+
+
+"shutdownhtml" Change
+---------------------
+All of Bugzilla is now affected by the "shutdownhtml" parameter,
+including command-line scripts. checksetup.pl is exempt. Many scripts
+(such as collectstats.pl and whine.pl) will just exit silently when
+"shutdownhtml" is turned on.
+
+
+Miscellaneous Improvements
+--------------------------
+
+- Added a frequently-requested user preference for whether or not to go
+  to the next bug in your list after submitting changes to a bug.
+
+- The ability to do relative date searches (like "1d" for "1 day" or "1w"
+  for "1 week") by hour now, in addition to days and other units of time.
+
+- "Alias" added to the New Bug form, for users with editbugs.
+
+- Users can now actually see the descriptions of flags that you enter
+  in editflagtypes.cgi. The description will appear as a tooltip
+  when a user places their mouse over the flag name on show_bug.cgi.
+
+- Bugzilla will optionally convert BMP attachments into PNGs for you.
+  See the "convert_uncompressed_images" in the "Attachments" section
+  of the Parameters.
+
+- You can now edit the Status Whiteboard when you are changing multiple
+  bugs at once.
+
+- The way that groups work in the database has changed, and large-scale 
+  Bugzilla use with many concurrent users should be much faster, as a 
+  result. (Technical Details: The need for Bugzilla to "derive groups" 
+  has gone away pretty much entirely.)
+
+- Performance improvements on searching attachment information that's not
+  the actual content of the attachment (such as searching the Attachment
+  Description or the Attachment MIME Type)
+
+- You can now specify multiple email addresses, comma-separated, when 
+  setting the requestee of a flag, and it will set the flag once for each
+  of those email addresses
+
+- "Bug Creation Time" is now searchable in the Boolean Charts.
+
+- When you mark a comment on a bug as private, the background color
+  of the comment will change immediately. However, in order for
+  Bugzilla to register that the comment is now private, you still
+  have to "submit" the changes.
+
+- Emails sent from Bugzilla now have "X-Bugzilla-Keywords" and
+  "X-Bugzilla-Severity" by default, containing the information
+  from the related Bugzilla fields.
+
+- You can now change the assignee and QA contact on multiple bugs at
+  once even when those bugs are in different products.
+
+- contrib/merge-users.pl allows you to merge two user accounts. This is
+  particulary useful when a user opened several accounts and only one should
+  be kept. It also lets you merge a deleted account with an existing one.
+
+All Changes
+-----------
+
+If you'd like to see all the changes between Bugzilla 2.20 and Bugzilla
+2.22, see:
+
+http://tinyurl.com/9p2tm
+
+
+Deprecated Features
+*******************
+
+- This is the last release of Bugzilla to support perl 5.6.x. All future
+  versions of Bugzilla will require at least perl 5.8.
+
+  This is the last release of Bugzilla to support PostgreSQL 7.x. Future
+  releases using PostgreSQL will require PostgreSQL 8.0 and DBD::Pg 1.45.
+
+Outstanding Issues
+******************
+
+- bug 305836: PostgreSQL users: do not use DBD::Pg version 1.43 with 
+  Bugzilla. It has a bug which can corrupt the database. Version 1.41
+  is fine. Version 1.45 or higher is fine too.
+
+- (No Bug Number) VERY IMPORTANT: If you have customized the values in
+  your Status/Resolution field, you must edit checksetup.pl BEFORE YOU
+  RUN IT. Find the line that starts like this:
+
+  bug_status   => ["UNCONFIRMED",
+
+  That's where you set the values for the Status field.
+
+  resolution   => ["","FIXED",
+
+  And that's where you set values for the Resolution field.
+
+  Those are both near line 1826 in checksetup.pl.
+
+  If you forget to do this, you will have to manually edit the "bug_status"
+  and "resolution" tables in the database to contain the correct values.
+
+- bug 276230: The support for restricting access to particular Categories of 
+  New Charts is not complete. You should treat the 'chartgroup' Param as the 
+  only access mechanism available. However, additionally, charts migrated from
+  Old Charts will be restricted to the groups that are marked MANDATORY for 
+  the corresponding Product. There is currently no way to change this 
+  restriction, and the groupings will not be updated if the group configuration
+  for the Product changes.
+
+- bug 37765: If you use the "sendmail" support of Bugzilla,
+  and you use an MTA which is *not* Sendmail (such as Postfix, Exim, etc.)
+  make sure the "sendmailnow" parameter is ON or Bugzilla will not send
+  e-mail correctly.
+
+- bug 69621: If you rename or remove a keyword that is in use on bugs, you will
+  need to rebuild the "keyword cache" by running sanitycheck.cgi and choosing
+  the option to rebuild the cache when it asks. Otherwise keywords may not show
+  up properly in search results.
+
+- (No Bug Number) If you have a lot of non-ASCII data in your Bugzilla (for 
+  example, if you use a translation of Bugzilla), don't enable the XS::Stash
+  option when you install the Template Toolkit, or your Bugzilla installation
+  may become slow. This problem is fixed in a not-yet-released version of the
+  Template Toolkit (after 2.14).
+
+- Bug 99215: Flags are not protected by "mid-air collision" detection.
+  Nor are any attachment changes.
+
+- Bug 89822: When changing multiple bugs at the same time, there is no
+  "mid-air collision" protection.
+
+- bug 322955: The email interface (bug_mail.pl) in the contrib/ directory
+  has not been maintained (as it has no maintainer), and does not work 
+  properly. We hope to have this fixed in our next major release of 
+  Bugzilla; however, any help or contributions in this area are very 
+  welcome.
+
+
+How to Upgrade From An Older Bugzilla
+*************************************
+
+NOTE: Upgrading from a large installation (over 10,000 bugs) running 2.18
+      or before may take a significant amount of time. checksetup will 
+      try to let you know how long it will take, but expect downtime 
+      of an hour or more if you have many bugs, many attachments, 
+      or many users.
+
+Steps for Upgrading
+-------------------
+
+1) Read these entire Release Notes, particularly the "Outstanding Issues"
+   and "Security Fixes" sections.
+
+2) View the Sanity Check (sanitycheck.cgi) page on your installation before
+   upgrading. Attempt to fix all warnings that the page produces before
+   you go any further, or you may experience problems during your upgrade.
+
+3) Make a backup of the Bugzilla database before you upgrade, perhaps
+   by using mysqldump. THIS IS VERY IMPORTANT. If anything goes wrong
+   during the upgrade, your installation can be corrupted beyond
+   recovery. Having a backup keeps you safe.
+
+   Example:
+
+      mysqldump -u root -p bugs > bugs-db.sql
+
+4) Replace the files in your installation with the new version of Bugzilla,
+   or you can try to use CVS to upgrade. The bugzilla.org website has 
+   instructions on how to do the actual installation.
+
+   You can also use a brand-new Bugzilla directory, as long as you
+   copy over the old data/ directory and the "localconfig" file to the
+   new installation.
+
+5) Run checksetup.pl after you install the new version.
+
+7) View the Sanity Check page again after you run checksetup.pl.
+
+8) It is recommended that, if possible, you fix any problems you find
+   immediately. Failure to do this may mean that Bugzilla will not work 
+   correctly. Be aware that if the sanity check page contains more errors after
+   an upgrade, it doesn't necessarily mean there are more errors in your 
+   database, as additional tests are added to the sanity check over time, and 
+   it is possible that those errors weren't being checked for in the old 
+   version.
+
+9) This version of Bugzilla contains improvements to the email that
+   Bugzilla sends when a bug is changed. The template for that email 
+   is contained in the "newchangedmail" parameter. If you would like
+   to take advantage of the email enhancements in this version of
+   Bugzilla, reset that parameter to its default. (You can customize
+   it after that again, if you want.)
+
+
+Code Changes Which May Affect Customizations
+********************************************
+
+CGI.pl is Gone
+--------------
+The CGI.pl file, which used to contain many global functions, and which
+also contained initialization code for every CGI, is gone. The functions
+have been moved to various places and sometimes renamed.
+
+The initialization code that used to happen inside CGI.pl is now inside
+of Bugzilla.pm. All CGIs must "use Bugzilla" in one way or another. (Some
+CGIs "use Bugzilla" by doing "require globals.pl".)
+
+
+Deriving Groups No Longer Happens
+---------------------------------
+Bugzilla no longer needs to "derive groups" in advance. That is, previously
+Bugzilla used to flatten the group heirarchy into the user_group_map
+table. (That is, show that a user was in every group they were in,
+even if they were only in that group because they belonged to *another*
+group.) Now the table only contains groups that the user is in directly,
+and groups that they are in because of a regexp.
+
+Instead, The Bugzilla::User->group function determines the groups a user
+is in when called.
+
+We did this because the group derivation was causing a lot of complexity
+in the code, and also deriving the groups was a slow process that 
+frequently had to happen inside of a database lock while sending mail
+or viewing a bug list.
+
+See https://bugzilla.mozilla.org/show_bug.cgi?id=304583 for details.
+
+
+Other Changes
+-------------
+
+- The move.pl script's functionality has been merged into process_bug.cgi.
+
+- $::template and $::vars are gone from globals.pl. Instead of $::template,
+  use Bugzilla->template. Every script creates the $vars variable by itself
+  instead of using a global $::vars variable.
+
+- $::userid is gone. Instead use Bugzilla->user->id.
+
+- QuickSearch is now in perl instead of in JavaScript. The code is in
+  Bugzilla/Search/QuickSearch.pm. This makes it much easier to customize,
+  and it also fixes some long-standing issues that QuickSearch had.
+
+- Attachment data is now in the attach_data table. Other information
+  about attachments is still in the "attachments" table.
+
+- Much like the 2.20 release, many functions have been removed from
+  globals.pl and CGI.pl. They were moved elsewhere and renamed.
+  Search RESOLVED bugs in bugzilla.mozilla.org for the old
+  version of the function name, and that will usually show you
+  the bug where we moved the function, allowing you to find out
+  what the new name and location is.
+
+- This is the last release that contains the deprecated
+  SendSQL, SqlQuote, FetchSqlData, MoreSqlData, and FetchOneColumn 
+  functions. Instead, you should use DBI functions. For a very brief 
+  example, see:
+
+  http://www.bugzilla.org/docs/developer.html#sql-sendreceive
+
+
+Security Fixes in 2.22 Releases
+*******************************
+
+A long-standing, well-known security issue is finally resolved in Bugzilla
+2.22: Previously, the "Session ID" of each user could be easily guessed,
+given enough time. This could have allowed an attacker to take over a
+user's account, in certain circumstances. Now, the "Session ID" is totally
+random, resolving this issue. See bug 119524 in bugzilla.mozilla.org for
+details.
+
+If you are very concerned about the security of your Bugzilla installation,
+it would be a very good idea to run the following command on your
+database immediately after upgrading:
+
+TRUNCATE TABLE logincookies;
+
+This is actually safe to do at any time--it just forces a logout of
+every single user, even those with saved sessions. (It invalidates
+every login cookie Bugzilla has ever given out.)
+
+Version 2.22.2
+--------------
+
+A Cross-Site Scripting vulnerability is fixed in Bugzilla 2.22.2. You can
+read the details of the fix at:
+
+http://www.bugzilla.org/security/2.20.3/
+
+Version 2.22.1
+--------------
+
+The Bugzilla team fixed two Information Leaks and three Cross-Site
+Scripting vulnerabilities that existed in versions of Bugzilla
+prior to 2.22.1. We strongly recommend that you update any 2.22 
+installation to 2.22.1, to be protected from these vulnerabilities.
+
+In addition, we have made an enhancement to security in this version
+of Bugzilla. In previous versions, it was possible for malicious
+users to exploit administrators in certain ways. Although this has
+never happened (to our knowledge) in the real world, we thought it
+was important that we protect administrators from this sort of attack.
+
+You can see details on all the vulnerabilities and enhancements at:
+
+http://www.bugzilla.org/security/2.18.5/
+
+
+Release Notes For Previous Versions
+************************************
+
+***************************************
+*** The Bugzilla 2.20 Release Notes ***
+***************************************
+
+Table of Contents
+*****************
+
+- Introduction
+- Important Updates in this Point Release
+    * Version 2.20.1
+    * Version 2.20.2
+- Minimum Requirements
+    * Perl
+    * For MySQL Users
+    * For PostgreSQL Users
+    * Required Perl Modules
+    * Optional Perl Modules
+- What's New?
+    * Experimental PostgreSQL Support
+    * New User-Interface Color/Style
+    * Higher-Level Categorization of Bugs (above "Product")
+    * Regular Reports by Email of Complex Queries ("Whining")
+    * "Environment Variable" Authentication Method
+    * User-List Drop-Down Menus
+    * Server-Side Comment Wrapping
+    * UI for Editing Priority, OS, Platform, and Severity
+    * Bugzilla Queries as RSS
+    * Choice of E-Mail Sending Methods
+    * "User Preferences"
+    * "Large Attachment" Storage
+    * "User Visibility" Controls
+    * Miscellaneous Improvements
+    * All Changes
+- Deprecated Features
+- Outstanding Issues (<======================== IMPORTANT, PLEASE READ)
+- How to Upgrade From An Older Bugzilla
+    * Steps for Upgrading
+- Code Changes Which May Affect Customizations
+    * The New Database-Compatibility Layer
+    * If You Customize Your Database...
+    * Many Functions Renamed
+    * User Preferences
+    * Other Changes
+- Security Fixes In 2.20 Releases
+- Release Notes for Previous Versions
+
+
+Introduction
+************
+
+This document contains the release notes for Bugzilla 2.20.
+In this document, recently added, changed, and removed features
+of Bugzilla are described. If you are upgrading from an older version,
+you will definitely want to read these release notes in detail, so that
+you have an idea of what has changed.
+
+If you are upgrading from a version before 2.18, also read the 2.18 release
+notes (lower in this file) and any previous release notes.
+
+If you are installing a new Bugzilla, you will still want to look over
+the release notes to see if there is any particularly important information
+that affects your installation.
+
+The 2.20 release has had about nine months of development since 2.18, but
+they were nearly the most active nine months in Bugzilla's history. We hope
+that users will appreciate our many external changes, and that Bugzilla
+administators will find that our internal changes make their lives easier.
+
+If you would like to contribute code to Bugzilla, read our 
+Contributor's Guide at:
+
+http://www.bugzilla.org/docs/contributor.html
+
+
+Important Updates In This Point Release
+***************************************
+
+Version 2.20.1
+--------------
+
++ Many PostgreSQL fixes, including fixing whine.pl on Pg 8 
+  (bug 301062) and fixing the --regenerate option of collectstats.pl
+  for all versions of Pg (bug 316971). However, users who want full
+  PostgreSQL support are encouraged to use the 2.22 series, as 
+  certain PostgreSQL bugs were discovered that will not be fixed 
+  in 2.20 (their fixes were too complex).
+
++ In Bugzilla 2.20, the "administrator" user created by checksetup.pl
+  would not ever be sent email, because their email preferences were
+  left blank. This has been fixed for 2.20.1. However, if you created
+  this administrative user with Bugzilla 2.20, make sure to go back
+  and enable their Email Preferences. (bug 317489)
+
++ The bzdbcopy.pl script mentioned in these release notes
+  has now actually been checked-in to the 2.20 branch, and so
+  it's included in this release. (bug 291776)
+
++ When there's only one Classification, you now won't be required
+  to pick a Classification on bug entry. (bug 311489)
+
++ You can no longer add dependencies on bugs you can't see.
+  (bug 141593)
+
++ The CC list is included in "New" bug emails, again. (bug 313661)
+
++ In the original 2.20, certain scripts were not correctly using
+  the "shadow database," if it was specified. This has been fixed
+  in 2.20.1. (bug 313695)
+
++ "Saved Searches" that were saved before Bugzilla 2.20, would throw
+  an error if they contained "Days Since Bug Changed." as part of their
+  criteria. This has been fixed in Bugzilla 2.20.1. (bug 302599)
+
++ You can now successfully delete a product even when Target Milestones
+  are turned off. (bug 317025)
+
++ checksetup.pl now correctly pre-compiles templates for languages other
+  than English. (bug 304417)
+
++ The "All Closed" chart that is created by default in New Charts 
+  now actually represents all closed bugs, and not all bugs in the 
+  product. (bug 300473)
+
++ CSV bug lists with more than 1000 dates now work properly. (bug 257813)
+
++ Various bugs with upgrading from previous versions of Bugzilla 
+  have been fixed. (bug 307662, bug 311047, bug 310108)
+
++ Many, many other bug fixes. See http://www.bugzilla.org/status/changes.html
+  for details on what was fixed between 2.20 and 2.20.1.
+
+
+Version 2.20.2
+--------------
+
++ Adding a new attachment and taking the bug at the same time does not
+  create a referential integrity problem anymore if the bug was marked as
+  a duplicate (bug 332705).
+
++ Some additional admin links have been added to the sidebar (bug 282613).
+
++ A new test has been added to our test suite, named 012throwables.t.
+  It will now make sure that all tags used in ThrowUserError() and
+  ThrowCodeError() are defined, and that there are no unused tags (bug 312042).
+
++ whine.pl now works correctly on MySQL 4.0. MySQL 4.1 is not affected
+  (bug 327348).
+
++ contrib/merge-users.pl allows you to merge two user accounts. This is
+  especially useful when a user opened several accounts and only one
+  should be kept (bug 188264).
+
++ The login form on index.cgi again works correctly on a fresh installation
+  (bug 328108).
+
++ Email preferences are now set correctly when creating a new user account
+  using the ENV method (bug 327355).
+
+
+Minimum Requirements
+********************
+
+Perl
+----
+
+  Perl v5.6.1            (changed from 2.18)  (Non-Windows platforms)
+  ActiveState Perl v5.8.1                     (Windows only)
+
+For MySQL Users
+---------------
+
+  MySQL v3.23.41                   (Note: 2.22 will require MySQL 4.x)
+  perl module: DBD::mysql v2.9003  (changed from 2.18)
+
+For PostgreSQL Users       (new in 2.20)
+--------------------
+
+  PostgreSQL 7.3.x          (8.x has received less testing)
+  perl module: DBD::Pg 1.31 (1.41 required for PostgreSQL 8+)
+
+Required Perl Modules
+---------------------
+
+  AppConfig v1.52
+  CGI v2.93
+  Data::Dumper (any)
+  Date::Format v2.21
+  DBI v1.38              (changed from 2.18)
+  File::Spec v0.84       (changed from 2.18)
+  File::Temp (any)
+  Template Toolkit v2.08
+  Text::Wrap v2001.0131
+  Mail::Mailer 1.65      (new in 2.20)
+  Storable (any)         (new in 2.20)
+
+Optional Perl Modules
+---------------------
+
+  Chart::Base v1.0
+  GD v1.20
+  GD::Graph (any)
+  GD::Text::Align (any)
+  Net::LDAP (any)
+  PatchReader v0.9.4
+  XML::Parser (any)
+
+
+What's New?
+***********
+
+Experimental PostgreSQL Support
+-------------------------------
+
+In addition to MySQL, Bugzilla now also supports PostgreSQL. PostgreSQL
+support is still somewhat experimental. Although most major features of
+Bugzilla work on PostgreSQL in 2.20, there are probably still a few bugs
+that need to be worked out.
+
+PostgreSQL support in 2.20 is acceptable for smaller production
+environments that don't mind running into a bug or two now and then.
+
+
+New User-Interface Color/Style
+------------------------------
+
+You'll notice that Bugzilla looks a bit nicer, now! We've made a few
+color and style changes to update the overall "feel" of Bugzilla's
+User Inteface. We plan to do even more work on the UI for 2.22.
+
+
+Higher-Level Categorization of Bugs (above "Product")
+-----------------------------------------------------
+
+Previous Bugzillas had "Products" that you could file bugs in,
+and "Components" for those products. Now, "Products" can be grouped
+into "Classifications."
+
+To enable this, a Bugzilla administrator can turn on the 
+"useclassification" parameter, using editparams.cgi.
+
+
+Regular Reports by Email of Complex Queries ("Whining")
+-------------------------------------------------------
+
+You can now tell Bugzilla to do a specific query (or set of queries)
+every X minutes/hours/days, and send you the results by email. This is
+great for keeping track on a daily basis of what's going on in 
+your Bugzilla.
+
+
+"Environment Variable" Authentication Method
+--------------------------------------------
+
+You can now tell Bugzilla to accept a certain value passed in from
+Apache as authentication for Bugzilla users. This means that Bugzilla
+now "supports" any type of authentication that Apache supports.
+
+To use this, set the "user_info_class" parameter to "ENV" and, at a 
+minimum, set the "auth_env_email" parameter to the name of the 
+Environment variable that passes the authenticated user (usually 
+"REMOTE_USER").  If your webserver knows users' real names as well, also
+set the "auth_env_realname" parameter.  If you are using a true 
+single-signon system that assigns an identifier uniquely to an
+individual, even across changes of email address, then set 
+"auth_env_id" to the name of that variable.
+
+
+User-List Drop-Down Menus
+-------------------------
+
+Now, anywhere in Bugzilla where you previously had to type in an
+email address by hand, you have the choice of having Bugzilla instead
+display a drop-down menu of users to pick from.
+
+This feature is best for small installations with few users, because
+on large installations the list grows too large to be useful.
+
+To enable the feature, turn on the "usemenuforusers" parameter in
+editparams.cgi.
+
+
+Server-Side Comment Wrapping
+----------------------------
+
+In older Bugzillas, comments were wrapped to 80 characters by the
+user's web browser, and then stored in the database that way. This caused
+problems because some browsers did not wrap comments properly.
+
+Now, Bugzilla stores comments unwrapped and wraps them at display time, so
+all new comments should be properly wrapped. Also, when you upgrade, Bugzilla
+will look for old "mis-wrapped" comments and attempt to wrap them properly.
+
+Lines beginning with the ">" character are assumed to be quotes, and are
+*not* wrapped.
+
+
+UI for Editing Priority, OS, Platform, and Severity
+---------------------------------------------------
+
+Bugzilla now has a User Interface for adding and removing values
+from the OS, Platform, Priority, and Severity fields. You can also
+rename values. Any user in the "editcomponents" group can click
+on the "Field Values" link in their page footer to edit these fields.
+
+Also, the default list of choices for OS and Platform for new 
+installations is now much smaller. Old installations will keep 
+the same list they have now.
+
+
+Bugzilla Queries as RSS
+-----------------------
+
+You can now view a Bugzilla query as valid RSS 1.0. This means that you
+could add a particular query to your RSS aggregator, if you wanted, to
+keep track of changes in Bugzilla.
+
+To see a query as RSS, just click on the "RSS" link on the bottom of
+your query results. Your query must return at least 1 result in order
+for you to see the link.
+
+
+Choice of E-Mail Sending Methods
+--------------------------------
+
+Bugzilla now uses perl's Mail::Mailer to send e-mail. This means that
+you have several choices of how Bugzilla can send email. By default, it
+still uses sendmail, but it can also use SMTP, qmail, or send all email
+to a file instead of out to users.
+
+A Bugzilla administrator can change which method is used by setting the
+"mail_delivery_method" parameter in editparams.cgi.
+
+
+"User Preferences"
+------------------
+
+Bugzilla users will now notice a section in their Preferences called
+"General Preferences." Administrators will notice a new link called
+"User Preferences."
+
+The Preferences system allows Bugzilla developers to specify arbitrary
+"user preferences" that change the behavior of certain parts of Bugzilla.
+Administrators can control whether or not users are allowed to use these
+preferences, and what the default settings are for a user who is not
+logged in.
+
+The first two preferences that we have implemented are:
+  + "Show a quip at the top of each bug list"
+  + "When viewing a bug, show comments in this order..."
+
+We plan to implement more preferences in the future.
+
+
+"Large Attachment" Storage
+--------------------------
+
+Bugzilla can now store very large attachments on disk instead of in the
+database. These attachments can't be searched with Boolean Charts, but
+they also don't take up database space, and they can be deleted individually
+by the admin.
+
+When uploading an attachment, a user chooses if it's a "Big File." If so,
+it's stored on the disk instead of in the database.
+
+To enable this feature, set the "maxlocalattachmentsize" parameter to
+a non-zero value, in editparams.cgi.
+
+
+"User Visibility" Controls
+--------------------------
+
+It is now possible to prevent users from encountering all other users when
+using user-matching or drop-down userlists.  To enable this restriction, 
+enable the "usevisibilitygroups" parameter.  Once this is enabled, each 
+group's permissions will include a new column for "visible."  The members 
+of any group for which the group being edited is visible will be
+able to user-match this groups's users or see them in dropdown lists.
+
+This does not control who a user can CC on a bug, only who they can 
+see in the user-matching lists or drop-downs.
+
+Miscellaneous Improvements
+--------------------------
+
+- Marking an attachment as obsolete will now cancel all pending flag
+  requests for that attachment. That is, any flag that was set to "?"
+  on that attachment will be cleared.
+
+- You can now see which users are "watching" you, on the email 
+  preferences page.
+
+- You can tell Bugzilla to mark certain comments in a different
+  color by adding "&mark=1,2,3,5-7" to the end of the show_bug.cgi URL,
+  where "1,2,3,5-7" means "highlight comment 1, comment 2, comment 3, and
+  comments 5 through 7."
+
+- "QA Contact" now also appears on the New Bug page, if QA Contacts are
+  enabled on your installation.
+
+- Bugzilla email now has the "In-Reply-To" header added to it, so if
+  you use an email client that supports threads, you can view your
+  Bugzilla email in threads. If you are upgrading to a new version of
+  Bugzilla, and you want this support, please see the instructions at:
+  https://bugzilla.mozilla.org/attachment.cgi?id=172267
+
+- The email preferences system has been slightly updated. You will notice
+  the changes on your Email Preferences page.
+
+- You can now negate individual "boolean charts" (in the 
+  "Advanced Searching" section at the bottom of the "Advanced 
+   Search" page). That is, you can add "NOT" to the front of them.
+
+- You can add the words %assignee%, %reporter%, %user% (yourself), or
+  %qacontact% on the right-hand side of a Boolean Chart. For example, you
+  could make a Boolean Chart which said "Reporter" "does not equal" 
+  "%assignee%". That would give you all bugs where the Reporter was not
+  the same as the Assignee.
+
+- You can now search Boolean Charts by "commenter."
+
+- If you have a group with no name, it will be re-named to "group_#" where
+  "#" is the numeric Bugzilla Group ID for that group.
+
+- If you are using time-tracking, you can now see a report of time spent
+  on bugs using summarize_time.cgi.
+
+- If you are using time-tracking, bugzilla will now set "hours remaining"
+  to "0" automatically if you RESOLVE a bug, whether you are in the
+  time-tracking group or not.
+
+
+Deprecated Features
+*******************
+
+- Bugzilla 2.20 is the last Bugzilla version to support MySQL 3.23.x.
+  Starting with Bugzilla 2.22, Bugzilla will require MySQL 4.0.x. This will
+  allow Bugzilla to take advantage of the advanced features of MySQL 4.
+
+
+Outstanding Issues
+******************
+
+- (No Bug Number) VERY IMPORTANT: If you have customized the values in
+  your Status/Resolution field, you must edit checksetup.pl BEFORE YOU
+  RUN IT. Find the line that starts like this:
+
+  bug_status   => ["UNCONFIRMED",
+
+  That's where you set the values for the Status field.
+
+  resolution   => ["","FIXED",
+
+  And that's where you set values for the Resolution field.
+
+  Those are both near line 1826 in checksetup.pl.
+
+  If you forget to do this, you will have to manually edit the "bug_status"
+  and "resolution" tables in the database to contain the correct values.
+
+- bug 37765: VERY IMPORTANT: If you use the "sendmail" support of Bugzilla,
+  and you use an MTA which is *not* Sendmail (such as Postfix, Exim, etc.) 
+  you MUST turn on the "sendmailnow" parameter or Bugzilla will not send 
+  e-mail correctly.
+
+- (No Bug Number) If you close your web browser while the process_bug.cgi
+  or post_bug.cgi screen is running, not all emails will be sent, and
+  the next time that that bug is updated, there will be two updates. This
+  is because of a behavior of Apache that is beyond our control.
+
+- bug 276230: The support for restricting access to particular Categories of 
+  New Charts is not complete. You should treat the 'chartgroup' Param as the 
+  only access mechanism available. However, additionally, charts migrated from
+  Old Charts will be restricted to the groups that are marked MANDATORY for 
+  the corresponding Product. There is currently no way to change this 
+  restriction, and the groupings will not be updated if the group configuration
+  for the Product changes. This will not be fixed in the 2.20 branch.
+
+- bug 69621: If you rename or remove a keyword that is in use on bugs, you will
+  need to rebuild the "keyword cache" by running sanitycheck.cgi and choosing
+  the option to rebuild the cache when it asks. Otherwise keywords may not show
+  up properly in search results.
+
+- (No Bug Number) If you have a lot of non-ASCII data in your Bugzilla (for 
+  example, if you use a translation of Bugzilla), don't enable the XS::Stash
+  option when you install the Template Toolkit, or your Bugzilla installation
+  may become slow. This problem is fixed in a not-yet-released version of the
+  Template Toolkit (after 2.14).
+
+- If at any time you upgraded from a version of Bugzilla between 2.17.4 -
+  2.17.7 to either 2.18rc3 or 2.19.1, you must manually fix your New Charts in
+  order for them to work. See the following link for instructions on how to do
+  this: https://bugzilla.mozilla.org/show_bug.cgi?id=276237#c18
+  If you are using 2.18rc3, but did not upgrade from version 2.17.4 or newer,
+  then you don't need to do this.
+
+- (No Bug Number) If your DBI is really, really old, Bugzilla might fail
+  with a strange error message when you try to run checksetup.pl. Try
+  upgrading your DBI using: perl -MCPAN -e'install DBI'
+
+- Bug 126266: Bugzilla does not use UTF-8 to display pages. This means
+  that if you enter non-ASCII characters into Bugzilla, they may
+  display strangely, or Bugzilla may have other problems. For a workaround,
+  see: http://www.bugzilla.org/docs/tip/html/security-bugzilla.html
+  This has been fixed in the 2.22 series.
+
+- Bug 99215: Flags are not protected by "mid-air collision" detection.
+  Nor are any attachment changes.
+
+- Bug 89822: When changing multiple bugs at the same time, there is no
+  "mid-air collision" protection.
+
+- Bug 285614: importxml.pl may be broken in many different ways.
+  It has been fixed and completely re-written in the 2.22 series.
+
+- (No Bug Number) Note that the email interface (bug_mail.pl) in the 
+  contrib/ directory has not been maintained (as it has no maintainer),
+  and so may not be working properly. Contributions are welcome, if
+  anybody would like to work on it.
+
+
+Upgrading From An Older Bugzilla
+************************************
+
+NOTE: Running checksetup.pl to upgrade a large installation (over 10,000 bugs)
+      may take a significant amount of time. checksetup will try to let
+      you know how long it will take, but expect downtime of an hour or
+      more if you have many bugs, many attachments, or many users.
+
+Steps for Upgrading
+-------------------
+
+1) View the Sanity Check (sanitycheck.cgi) page on your installation before
+   upgrading. Attempt to fix all warnings that the page produces before
+   you go any further, or you may experience problems during your upgrade.
+
+2) Make a backup of the  Bugzilla database before you upgrade, perhaps 
+   by using mysqldump.
+
+   Example:
+
+      mysqldump -u root -p --databases bugs > bugs.db.backup
+
+3) Replace the files in your installation with the new version of Bugzilla,
+   or you can try to use CVS to upgrade. The Bugzilla.org website has 
+   instructions on how to do the actual installation.
+
+4) Make sure that you run checksetup.pl after you install the new version.
+
+5) View the Sanity Check page again after you run checksetup.pl.
+
+6) It is recommended that, if possible, you fix any problems you find
+   immediately. Failure to do this may mean that Bugzilla will not work 
+   correctly. Be aware that if the sanity check page contains more errors after
+   an upgrade, it doesn't necessarily mean there are more errors in your 
+   database, as additional tests are added to the sanity check over time, and 
+   it is possible that those errors weren't being checked for in the old 
+   version.
+
+7) If you want threading support on your Bugzilla email (see the 
+   "Miscellaneous Improvements" section above for a description),
+    you need to follow the instructions at:
+    https://bugzilla.mozilla.org/attachment.cgi?id=172267
+
+
+Code Changes Which May Affect Customizations
+********************************************
+
+The New Database-Compatibility Layer
+------------------------------------
+
+For most customizations, this should have no effect. However, you should
+be aware that Bugzilla->dbh is now an instance of "Bugzilla::DB" instead
+of being a DBI object directly. In fact, it's actually a 
+Bugzilla::DB::Mysql for MySQL users, and a Bugzilla::DB::Pg for 
+PostgreSQL users.
+
+Anything called from $dbh (like $dbh->bz_last_key) that starts with
+"bz_" or "sql_" is a custom Bugzilla function. Anything *not* starting
+with those two prefixes is a normal DBI function.
+
+Methods whose names start with "sql_" generate a piece of a SQL statement.
+They generate the correct version of the statement for whichever database
+you are using.
+
+Methods whose names start with "bz_" do something directly.
+
+You can see more documentation about this at:
+
+http://www.bugzilla.org/docs/2.20/pod/Bugzilla/DB.pm
+
+
+If You Customize Your Database...
+---------------------------------
+
+In order to support multiple databases, we had to do something sort of
+tricky. Bugzilla now stores what it *thinks* the current database schema
+is, in a table called bz_schema.
+
+This means that when checksetup changes the database, it updates the
+bz_schema table. When *you* update the database, without using 
+checksetup to do it, the bz_schema table is *not* updated.
+
+So, if you're going to add/remove a new column/table to Bugzilla, or if you're
+going to change the definition of a column, try to do it by adding code to
+checksetup in the correct place. (It's one of the places where you find
+the word "--TABLE--".)
+
+You can see the documentation on the $dbh functions used to do this at:
+
+http://www.bugzilla.org/docs/2.20/pod/Bugzilla/DB.pm#schema_modification_methods
+
+
+Many Functions Renamed
+----------------------
+
+We are reorganizing the Bugzilla code so that it can support mod_perl. As
+part of this, we are moving all functions out of globals.pl and CGI.pl, and
+into modules in the Bugzilla/ directory.
+
+Sometimes when we moved them, we also renamed them. The new Bugzilla standard
+is to have functions_named_like_this, instead of FunctionsNamedLikeThis.
+
+So if you were using a FunctionNamedLikeThis that no longer works, try just
+using it as function_named_like_this. If that doesn't work, you may have to
+search for where we put it, and what we renamed it to. Most of the functions
+moved to logical places.
+
+If you really can't find it, search bugzilla.mozilla.org using the name
+of the old function. We usually moved one function per bug, so the new
+name will be somewhere in a bug report.
+
+
+User Preferences
+----------------
+
+Bugzilla now has a "User Preferences" system! These preferences are stored
+in the database, and specified by a Bugzilla developer. The Bugzilla
+developers actually call these "settings," but we called them "User 
+Preferences" in the UI to make things clearer.
+
+You access a user's settings differently depending on if you are in a
+.cgi file or in a template file:
+
+CGI: Bugzilla->user->settings->{'setting_name'}->value
+Template: Bugzilla.user.settings.setting_name.value
+
+Where "setting_name" is the name of the setting. You can see the current
+setting names in the "setting" table in the database.
+
+Remember that sometimes you may want to check a user's settings when 
+making a customization.
+
+To see how to add new settings, search for "add_setting" in checksetup.pl.
+Also see the template: template/en/default/global/setting-descs.none.tmpl.
+
+Other Changes
+-------------
+
+- The $::unconfirmedstate variable has been replaced by the actual string
+  "UNCONFIRMED" everywhere in Bugzilla code.
+
+- The %::FORM and %::MFORM variables are no longer used to access form
+  data. Instead, use $cgi->param(). There are many examples of how to do
+  this, all over the Bugzilla code.
+
+- SendSQL() and related calls are deprecated, and the various $dbh methods
+  should be used instead, such as $dbh->prepare() and $dbh->execute().
+  Bugzilla->dbh is the $dbh handle to use. For more information on how
+  to use the $dbh methods, see:  http://search.cpan.org/dist/DBI/DBI.pm
+
+- The $::userid variable will be going away. Use Bugzilla->user->id instead.
+
+- All global variables (any that start with $::, @::, or %::) will 
+  be entirely gone by Bugzilla 2.24.
+
+
+Security Fixes in 2.20 Releases
+*******************************
+
+2.20.1
+------
+
+There were three security issues discovered after the release of
+Bugzilla 2.20 that we resolved for Bugzilla 2.20.1. One SQL Injection
+(from an administrator only), one Cross-Site Scripting vulnerability
+(that mostly affects only the user who can exploit it), and one minor,
+extremely specific information leak.
+
+To see details on the vulnerabilities that were fixed, see the 
+Security Advisory at:
+
+http://www.bugzilla.org/security/2.16.10/
+
+
+Release Notes for Previous Versions
+***********************************
+
+*****************************************
+*** The Bugzilla 2.18.x Release Notes ***
+*****************************************
+
+Table of Contents
+*****************
+
+- Introduction
+- Important Updates In This Point Release
+    * Version 2.18.1
+    * Version 2.18.2
+- Requirements
+    * Dependency Requirements
+- What's New?
+    * Generic Reporting
+    * Generic Charting
+    * Request System
+    * Enterprise Group Support
+    * User Wildcard Matching
+    * Support for "Insiders"
+    * Time Tracking
+    * Authentication module/LDAP improvements
+    * Improved localization support
+    * Patch Viewer
+    * Comment Reply Links
+    * Full-Text Search
+    * Email Address Munging
+    * Simple Search
+    * Miscellaneous Improvements
+    * All Changes
+- What's Changed?
+    * Flag Names
+    * New Saved Search User Interface
+    * Rules for changing fields
+- Removed Features
+- Code Changes Which May Affect Customizations
+- Recommended Practice for the Upgrade
+    * Note About Upgrading From MySQL With ISAM Tables
+    * Steps for Upgrading
+- Outstanding Issues (<======================== IMPORTANT, PLEASE READ)
+- Security Fixes In 2.18 Releases
+- Detailed Version-To-Version Release Notes
+
+
+Introduction
+************
+
+This document contains the release notes for Bugzilla 2.18 and
+the bugfix releases after 2.18. In this document, recently added,
+changed, and removed features of Bugzilla are described.
+
+The 2.18 release is our current stable series, containing the results
+of over two years of hard and dedicated work by volunteers all over 
+the world under the lead of Dave Miller.
+
+
+Important Updates In This Point Release
+***************************************
+
+There are usually many other bug fixes than those listed below,
+but the below fixes are the ones that we thought System Administrators
+would like to specifically know about.
+
+To see a listing of all changes in this release, you can use the
+table available at:
+
+http://www.bugzilla.org/status/changes.html
+
+Version 2.18.1
+--------------
+
++ You can now enter a negative time for "Hours Worked"
+  in the time-tracking area. (Bug 271276)
+
++ The BugMail.pm customization required for Windows (as
+  described in the Bugzilla Guide) now actually works. (Bug 280911)
+
++ Users who were using Bugzilla 2.8 can now successfully upgrade
+  to 2.18.1 (they couldn't upgrade to 2.18). (Bug 283403)
+
++ Dependency mails are now properly sent during a mass-change of bugs.
+  (Bug 178157)
+
+
+Version 2.18.2
+--------------
+
++ You can now create accounts with createaccount.cgi even
+  when the "requirelogin" parameter is turned on. (Bug 294778)
+
++ Bugs that are in disabled groups may not show a padlock
+  on the bug list, or may otherwise behave strangely. You
+  can now fix this using sanitycheck.cgi. (Bug 277454)
+
++ If sendmail dies while you are marking a bug 
+  as a duplicate, the duplicates table will no longer become 
+  corrupted. (Bug 225042)
+
+
+Requirements
+************
+
+Dependency Requirements
+-----------------------
+
+Minimum software requirements:
+
+  MySQL v3.23.41         (changed from 2.16)
+  Perl v5.6.0            (changed from 2.16)  (Non-Windows platforms)
+  ActiveState Perl v5.8.1                     (Windows only)
+
+Required Perl modules:
+
+  AppConfig v1.52
+  CGI v2.93              (new since 2.16)    (changed from 2.17.7)
+  Data::Dumper (any)
+  Date::Format v2.21     (changed from 2.16)
+  DBI v1.36              (changed from 2.16)    (changed from 2.17.7)
+  DBD::mysql v2.1010     (changed from 2.16)
+  File::Spec v0.82
+  File::Temp (any)
+  Template Toolkit v2.08 (changed from 2.16)
+  Text::Wrap v2001.0131
+
+Optional Perl modules:
+
+  Chart::Base v1.0       (changed from 2.16) (changed from 2.17.7)
+  GD v1.20               (changed from 2.16)
+  GD::Graph (any)        (new since 2.16)
+  GD::Text::Align (any)  (new since 2.16)
+  Net::LDAP (any)        (new since 2.16)
+  PatchReader v0.9.4     (new since 2.16)    (changed from 2.17.7)
+  XML::Parser (any)
+
+
+What's New?
+***********
+
+Generic Reporting
+-----------------
+
+Bugzilla has a new mechanism for generating reports of the current state of
+the bug database.  It has two related parts: a table-based view, and several
+graphical views.
+
+The table-based view allows you to specify an x, y and z (multiple tables of
+data) axis to plot, and then restrict the bugs plotted using the standard
+query form.  You can view the resulting data as an HTML or CSV export (e.g.:
+for importing into a spreadsheet).
+
+There are also bar, line and pie charts, which are defined in a very similar
+way.  These views may be more appropriate for particular data types, and are
+suitable for saving and then putting into presentations or web pages.
+
+
+Generic Charting
+----------------
+
+Bugzilla has a new mechanism for generating charts (graphs over time) of any
+arbitrary search. This is known as "New Charts." Legacy data from the previous
+charting mechanism ("Old Charts") is migrated into the "New Charts" when you
+upgrade. The Old Charts mechanism remains, but is deprecated and will be 
+removed in a future version of Bugzilla.
+
+Individual users can see/create charts as long as they are a member of the 
+group specified in the Param 'chartgroup'. Data can be collected for 
+personal charts every seven days (or a longer period, as set by the user). 
+Charts created by an administrator can be made public (visible to all). Data 
+is collected for administrator charts every day (or a longer period, as set 
+by the admin).
+
+The data is collected by the collectstats.pl script, which an administrator 
+will need to arrange to be run once every day (see the manual). Chart data can
+be plotted in a number of different ways, and different data sets can be
+plotted on the same graph for comparison.
+
+Please see the Known Bugs section for some important limitations relating to
+access controls on charts.
+
+
+Request System
+---------------
+
+The Request System (RS) is a set of enhancements that adds powerful flag
+(superset of the old attachment status) features to the bugs.
+
+RS allows for four states: off, granted, denied, and (optionally) requested,
+where "granted" is the equivalent of "on". These additions mean it is no
+longer necessary to define a status to negate another status (e.g.
+"needs-work" to negate "has-review") because negation is built into each
+status via the status' "denied" state.  Bug statuses: Previously only
+attachments could have these kinds of statuses. RS enables them for bugs as
+well. This feature can be used to request and grant/deny certain properties
+for a bug, such as inclusion for a specific milestone or approval for checkin.
+This way, Bugzilla supports the natural decision-making process in your
+organization.
+
+- Requests: Flags can now optionally be made requestable, which means users
+  can ask other users to set them. When a user requests a flag, Bugzilla
+  emails the requestee and adds the request to a browsable queue so both the
+  requester and the requestee can keep track of its status. Once the
+  requestee fulfills the request by setting the flag to either granted or
+  denied, Bugzilla emails the requestee and removes the request from the
+  queue.  This feature supports workflow like the mozilla.org code review
+  and milestone approval processes, whereby code is peer reviewed before
+  being committed and patches get approved by product release managers for
+  inclusion in specific product releases.
+
+- Product/component specificity: Previously flags were product-specific, and
+  if you wanted the same flag for multiple products you had to define
+  multiple flags with the same name. Flags are now
+  product/component-specific, and a single flag can be enabled or disabled
+  for multiple product/component combinations via inclusions and exclusions
+  lists. Flags are enabled for all combinations on their inclusions list
+  except those that appear on their exclusions list.
+
+
+Enterprise Group Support
+------------------------
+
+Bugzilla is no longer limited to 55 access control groups. Administrators can
+define an arbitrary number of access groups composed of individual users or
+other groups.  The groups can be configured via the web interface to achieve a
+wide variety of access control policies. See the documentation section on
+'Groups And Group Controls' for details.
+
+
+User Wildcard Matching
+----------------------
+
+Sites can now enable the use of wildcards and substrings in bug entry and
+editing forms. If the user enters an incomplete username, he'll get a list of
+users that matched the given username.
+
+
+Support for "Insiders"
+----------------------
+
+If the 'insidergroup' parameter is defined, a specific group of users can be
+designated insiders who can designate comments and attachments as private to
+other insiders. These comments and attachments will be invisible to other
+users who are not members of the insiders group even if the bugs to which they
+apply are visible. Other insiders will see the comments and attachments with a
+visual tinting indicating that they are private.
+
+
+Time Tracking
+-------------
+
+Controls for tracking time spent fixing bugs are included in the bug form for
+members of the group specified by the 'timetrackinggroup' parameter. Any time
+comments are added to the bug, members of the time tracking group can add an
+amount of time they spent, and it's figured into the total and displayed at
+the top of the bug. Shown in the bug are your original estimate, the amount of
+time spent so far, the revised estimate of how much time is remaining, and
+your gain/loss on the original estimate.
+
+
+Authentication module/LDAP improvements
+---------------------------------------
+
+Bugzilla's authentication mechanisms have been modularized, making pluggable
+authentication schemes for Bugzilla a reality. Both the existing database and
+LDAP systems were ported as part of modularization process. Additionally, the
+CGI portion of the backend was redesigned to allow for authentication from
+other sources, including (theoretically) email, which will help Bug 94850.
+
+As part of this conversion, LDAP logins now use Perl's standard Net::LDAP
+module, which has no external library dependencies.
+
+
+Improved localization support
+-----------------------------
+
+Bugzilla administrators can now configure which languages are supported by
+their installations and automatically serve correct, localized content to
+users based on the HTTP 'Accept-Language' header sent from users' browsers.
+
+There are currently localized templates available for: Arabic, Belarusian,
+Chinese, French, German, Italian, Korean, Portuguese (Brazil) Spanish (Spain
+or Mexico) and Russian.  These localized template packs are third-party
+contributions, may only be available for specific versions, and may not be
+supported in the future. (http://www.bugzilla.org/download/#localizations)
+
+
+Patch Viewer
+------------
+
+Viewing and reviewing patches in Bugzilla is often difficult due to lack of
+context, improper format and the inherent readability issues that raw patches
+present. Patch Viewer is an enhancement to Bugzilla designed to fix that by
+offering increased context, linking to sections, and integrating with Bonsai,
+LXR and CVS.
+
+
+Comment Reply Links
+-------------------
+
+In Edit Bug, each bug comment now includes a convenient (reply) link that
+quotes the comment text into the textarea. This feature is only enabled in
+Javascript-capable browsers, but causes no inconvenience to other user agents.
+
+
+Full-Text Search
+----------------
+
+It is now possible to query the Bugzilla database using full-text searching,
+which spans comments and summaries, and which searches for substrings and stem
+variations of the search term. Basically, it's like using Google.
+
+
+Email Address Munging
+---------------------
+
+The fact that raw email addresses are displayed in Bugzilla makes it trivial
+for bots that spamharvest to spider through Bugzilla, in particular, through
+Bugzilla's buglists. This change adds HTML obfuscation of email addresses as
+they appear in the Bugzilla web pages.
+
+
+Google-like Bug Search
+----------------------
+
+Bugzilla now includes a very simple, Google-like "Find a Specific Bug" page,
+in addition to its advanced search page.
+
+
+Miscellaneous Improvements
+--------------------------
+
+- The "Assigned To" field on the new bug page is now prefilled with the default
+  component owner.
+
+- A bug alias column is now available in the buglist page.
+
+- Lists of bugs containing errors in the sanity check page now have a "view as
+  buglist" link in addition to the individual bug links.
+
+- Autolinkification Page - It's now possible to apply Bugzilla's comment
+  hyperlinking algorithm to any text you like. This should be useful for status
+  updates and other web pages which give lists of bugs. The bug links created
+  include the subject, status and resolution of the bug as a tooltip.
+
+- There are more <link> tags on the links toolbar for navigating quickly between
+  different areas.
+
+- Buglists are now available as comma-separated value files (CSV) and JavaScript
+  (JS) as well as HTML and RDF.
+
+- Keywords and dependencies can now be entered during initial bug entry.
+
+- A CSS id signature unique to each Bugzilla installation is now added to the
+  <body> tag on Bugzilla pages to allow custom end-user CSS to explicitly affect
+  Bugzilla.
+
+- Perl's path has been changed to a normal /usr/bin/perl from the original
+  legacy "bonsaitools" path specifier.
+
+- A new "always-require-login" parameter allows administrators to require a
+  login before being able to view any page, except the front page.
+
+- A developer may add an attachment, and also reassign a bug to himself as part
+  of that single action.
+
+- Bugzilla is now able to use the replication facilities provided by the
+  MySQL database to handle updates from the main database to the secondaries.
+
+- Mail handling is now between 125% to 175% faster.
+
+- Guided Bug Entry: You can see a sample enter_bug.cgi template at 
+  enter_bug.cgi?format=guided that "guides" users through the process of 
+  filing a "good" bug. It needs to be modified before use in your organization.
+
+- There is now a "Give me some help" link on the Advanced Search page that will
+  enable pop-up help for every field on the page.
+
+- The Bugzilla administrator can now forbid users from marking bugs RESOLVED 
+  when there are unresolved dependencies.
+
+
+All Changes
+-----------
+
+To see a list of EVERY bug that was fixed between 2.16 and 2.18 (over 1000),
+see: http://tinyurl.com/6m3e4
+
+
+What's Changed?
+***************
+
+
+Flag names
+----------
+
+Prerelease versions of Bugzilla 2.17 and 2.18 inadvertantly allowed
+commas and spaces in the names of flags, which due to the way they're
+processed, caused lots of internal havoc if you named flags to have
+any commas or spaces in them.  Having commas or spaces in the names
+can cause errors in the notification emails and in the bug activity
+log.  The ability to create new flags with these characters has been
+removed.  If you have any existing flags that you named that way,
+running checksetup will attempt to automatically rename them by
+replacing commas and spaces with underscores.
+
+
+New Saved Search User Interface
+-------------------------------
+
+In previous Bugzilla versions, you could specify on the search page that you 
+wanted to save a search and store it as a link in your footer. This option has
+now moved to the search results page (buglist.cgi), where you will see a 
+"Remember search" button with a box next to it to enter the name of the search.
+
+You can manage your saved searches on the Preferences page.
+
+
+Rules for changing fields
+-------------------------
+
+There have been some changes to the rules governing who can change which fields
+of a bug report.  The rules for Bugzilla version 2.16 and 2.18, along with
+differences between them, are listed below.  Bear in mind that there are other
+restrictions on bug manipulation besides the ones listed below.  In particular,
+the groups system enforces restrictions on who can create, edit, or even see
+any given bug.
+
+Bugzilla 2.16 rules:
+
+- anyone can make a null change;
+- anyone can add a comment;
+- anyone in the editbugs group can make any change;
+- the reporter can make any change to the status;
+- anyone in the canconfirm group can change the status
+  to any opened state (NEW, REOPENED, ASSIGNED).
+- anyone can change the status to any opened state
+  if the everconfirmed flag is set;
+- the owner, QA contact, or reporter can make any change
+  *except* changing the status to an opened state;
+- No other changes are permitted.
+
+[Note that these rules combine to allow the reporter to make any change
+to the bug.]
+
+Bugzilla 2.18 rules:
+
+- anyone can make a null change;
+- anyone can add a comment;
+- anyone in the editbugs group can make any change;
+- anyone in the canconfirm group can change the status
+  from UNCONFIRMED to any opened state;
+- the owner or QA contact can make any change;
+- the reporter can make any change *except*:
+  - changing the status from UNCONFIRMED to any opened state; or
+  - changing the target milestone; or
+  - changing the priority (unless the letsubmitterchoosepriority
+    parameter is set).
+- No other changes are permitted.
+
+The effective differences in the rules:
+
+- In 2.16, the reporter could always change anything about a bug.
+
+  In 2.18, the reporter can't:
+
+  - confirm the bug unless he is in the canconfirm group;
+  - change the target milestone;
+  - change the priority (unless the 'letsubmitterchoosepriority'
+    parameter is set;
+
+  (unless he is also the owner, the QA contact, or in the editbugs
+  group, in which case he can do all these things).
+
+- In 2.16, the owner or QA contact (if the 'useqacontact' parameter
+  is set) can't change the bug status to an opened status unless they
+  are also the reporter, or have editbugs or canconfirm, or the
+  everconfirmed flag is set on the bug).
+
+  In 2.18 the owner or QA contact can make any change to a bug.
+
+- In 2.16, a member of the canconfirm group can set the status
+  to any opened status.
+
+  In 2.18 this is only possible if the status was previously
+  the unconfirmed status.
+
+- In 2.16, the status can be set to anything by anybody
+  if the 'everconfirmed' flag is set.
+
+  In 2.18, this authorization code does not pay any attention
+  to the 'everconfirmed' flag.
+
+
+Removed Features
+****************
+
+- Please note that Bugzilla no longer supports MySQL 3.22. The minimum required
+  version is now 3.23.41.                                      
+
+- The "shadow database" mechanism is no longer used. Instead, use MySQL's 
+  built-in replication feature.
+
+- If you have placed any comments in the localconfig file, they may be removed
+  by checksetup.pl.
+
+
+Code Changes Which May Affect Customizations
+********************************************
+
+- A mechanism (called "Template Hooks") for third party extensions to plug into
+  existing templates without having to patch or replace distributed templates
+  has been added. More information on this can be found in the documentation.
+
+- Header output now uses CGI.pm, in a step towards enabling mod_perl
+  compatibility. This change will affect users that had customized charsets in
+  their CGI files: previously the charset had to be added everywhere that
+  printed the Content-Type header; now it only needs changing in one spot, in
+  Bugzilla/CGI.pm.
+
+- $::FORM{} and $::COOKIE{} are deprecated. Use the $cgi methods to access
+  them.
+
+- $::userid is gone in favor of Bugzilla->user->id
+
+- ConnectToDatabase() is gone (it's done automatically when you initialize the
+  Bugzilla object)
+
+- quietly_check_login() and confirm_login() are gone, use Bugzilla->login()
+  with parameters for whether the login is required or not.
+
+- Use Bugzilla->user->login in place of $::COOKIE{Bugzilla_login}
+
+- You can tell if there's a user logged in or not by using
+  Bugzilla->user rather than looking for $::userid==0.
+  In new 2.18 code, use defined(Bugzilla->user) && (Bugzilla->user->id)
+  In 2.20, this will become just (Bugzilla->user->id)
+  In templates, always test [% IF user.id %] rather than [% IF user %]
+
+- SendSQL() and related calls are deprecated, and the various $dbh methods 
+  should be used instead, such as $dbh->prepare() and $dbh->execute(). 
+  Bugzilla->dbh is the $dbh handle to use.
+
+
+Recommended Practice for the Upgrade
+************************************
+
+Note About Upgrading From MySQL With ISAM Tables
+------------------------------------------------
+As previously noted in the Dependency Requirements MySQL is now required 
+to be at least version 3.23.41.  This implies that all tables of type ISAM will 
+be converted by the checksetup.pl script to MyISAM.
+
+
+Steps for Upgrading
+-------------------
+
+1) View the Sanity Check (sanitycheck.cgi) page on your installation before
+   upgrading.
+
+2) As with any upgrade it is recommended that you make a backup of the 
+   Bugzilla database before you upgrade, perhaps by using mysqldump.
+
+   Example:
+
+      mysqldump -u root -p --databases bugs > bugs.db.backup
+
+3) Replace the files in your installation, or you can try to use CVS to upgrade.
+   The Bugzilla.org website has instructions on how to do the actual 
+   installation.
+
+4) Make sure that you run checksetup.pl after you install the new version.
+
+5) View the Sanity Check page again after you run checksetup.pl.
+
+6) It is recommended that, if possible, you fix any problems you find
+   immediately. Failure to do this may mean that Bugzilla will not work 
+   correctly. Be aware that if the sanity check page contains more errors after
+   an upgrade, it doesn't necessarily mean there are more errors in your 
+   database, as additional tests are added to the sanity check over time, and 
+   it is possible that those errors weren't being checked for in the old 
+   version.
+
+
+Outstanding Issues
+******************
+
+These are known problems with the release that we think you should know about. 
+They each have a bug number for http://bugzilla.mozilla.org/
+
+- If at any time you upgraded from a version of Bugzilla between 2.17.4 -
+  2.17.7 to either 2.18rc3 or 2.19.1, you must manually fix your New Charts in
+  order for them to work. See the following link for instructions on how to do
+  this: https://bugzilla.mozilla.org/show_bug.cgi?id=276237#c18
+  If you are using 2.18rc3, but did not upgrade from version 2.17.4 or newer,
+  then you don't need to do this.
+
+- bug 37765: If you use an MTA other than sendmail (such as Postfix, Exim, 
+  etc.) you MUST turn on the "sendmailnow" parameter or Bugzilla will not send
+  e-mail correctly.
+
+- bug 276230: The support for restricting access to particular Categories of 
+  New Charts is not complete. You should treat the 'chartgroup' Param as the 
+  only access mechanism available. However, additionally, charts migrated from
+  Old Charts will be restricted to the groups that are marked MANDATORY for 
+  the corresponding Product. There is currently no way to change this 
+  restriction, and the groupings will not be updated if the group configuration
+  for the Product changes.
+
+- bug 69621: If you rename or remove a keyword that is in use on bugs, you will
+  need to rebuild the "keyword cache" by running sanitycheck.cgi and choosing
+  the option to rebuild the cache when it asks. Otherwise keywords may not show
+  up properly in search results.
+
+- (No Bug Number) If you have a lot of non-ASCII data in your Bugzilla (for 
+  example, if you use a translation of Bugzilla), don't enable the XS::Stash
+  option when you install the Template Toolkit, or your Bugzilla installation
+  may become slow. This problem is fixed in a not-yet-released version of the
+  Template Toolkit (after 2.14).
+
+- bug 266579: Users may be able to circumvent not having "canconfirm" privileges
+  in some circumstances. This is fixed starting with 2.19.3, but will not
+  be fixed in any 2.18 release, as the changes required to fix it are quite
+  large.
+
+- bug 99215: Attachment changes have no mid-air collision detection, unlike bug
+  changes.
+
+- bug 57350: Searching using the "commenter is" option may be VERY slow. Note 
+  that searching for "field: comment, changed by: user@domain.com" is fast, 
+  though.
+
+- bug 151509: Using the boolean chart option "contains the string" with the 
+  "flag name" field or certain other fields will cause Bugzilla to emit an 
+  error. This is fixed in 2.20rc1, but will not be fixed in the 2.18 series.
+
+- bug 234159: Bugzilla may sometimes send multiple notices in one email.
+
+- bug 237107: If you search for attachment information using the Boolean Charts
+  at the bottom of the Advanced Query page, bugs without attachments will not
+  show up in the result list.
+
+
+Security Fixes In 2.18 Releases
+*******************************
+
+Version 2.18
+------------
+
+Summary:     XSS in Internal Error messages in Bugzilla 2.16.7 and 2.18rc3
+CVE Name:    CAN-2004-1061
+Reference:   https://bugzilla.mozilla.org/show_bug.cgi?id=272620
+Details:
+     It is possible to send a carefully crafted URL to Bugzilla designed to
+trigger an error message.  The Internal Error message includes javascript code
+which displays the URL the user is visiting.  The javascript code does not
+escape the URL before displaying it, allowing scripts contained in the URL to
+be executed by the browser.  Many browsers do not allow unescaped URLs to be
+sent to a webserver (thus complying with RFC 2616 section 2.3.1 and RFC 2396
+section 2.4.3), and are thus immune to this issue.
+    Browsers which are known to be immune: Firefox 1.0, Mozilla 1.7.5,
+Camino 0.8.2, Netscape 7.2, Safari 1.2.4
+     Browsers known to be susceptible: Internet Explorer 6 SP2,
+Konqueror 3.2
+     Browsers not listed here have not been tested.
+
+
+Version 2.18.1
+--------------
+
+Two security issues were fixed in Bugzilla 2.18.1, neither of them 
+critical.
+
+See http://www.bugzilla.org/security/2.16.8/ for details.
+
+
+Version 2.18.2
+--------------
+
+Two security issues were fixed in Bugzilla 2.18.2. One of them
+is a major Information Leak/Unauthorized Bug Change. The other
+is a minor Information Leak.
+
+See http://www.bugzilla.org/security/2.18.1/ for details.
+
+
+Detailed Version-To-Version Release Notes
+*****************************************
+
+*********************************************************
+*** USERS UPGRADING FROM ALL VERSIONS PRIOR TO 2.16.7 ***
+*********************************************************
+
+*** Security fixes ***
+
+- It is possible to send a carefully crafted HTTP POST message to
+  process_bug.cgi which will remove keywords from a bug even if you don't have
+  permissions to edit all bug fields (the "editbugs" permission).  Such changes
+  are reported in "bug changed" email notifications, so they are easily
+  detected and reversed if someone abuses it.  Users are now prevented from
+  making changes to keywords if they do not have editbugs privileges. (bug
+  252638)
+
+*** Bug fixes of note ***
+
+- Enforce a minimum of 10 minutes between attempts to reset a password, so
+  we don't mailbomb the user if someone submits the form many times in a
+  row. (bug 250897)
+
+- Put products in alphabetical order on the create attachment status page.
+  (bug 251427)
+
+- Specify MyISAM as the table type when creating new tables.  MySQL 4.1 and
+  up default to InnoDB, which doesn't support some of the indexing methods
+  that we use. (bug 263165)
+
+*********************************************************
+*** USERS UPGRADING FROM ALL VERSIONS PRIOR TO 2.16.6 ***
+*********************************************************
+
+*** Security fixes ***
+
+- If Bugzilla is configured to hide entire products from some users, both
+  duplicates.cgi and the form for mass-editing a list of bugs in buglist.cgi
+  can disclose the names of those hidden products to such users.
+  (bugs 234825 and 234855)
+
+- Several administration CGIs echo invalid data back to the user without
+  escaping it.  (bug 235265)
+
+- A user with privileges to grant membership to any group (i.e. usually an
+  administrator) can trick editusers.cgi into executing arbitrary SQL.
+  (bug 244272)
+
+*** Bug fixes of note ***
+
+- Allow XML import to function when there are regexp metacharacters in product
+  names (bug 237591) 
+
+- Allow the bug_email.pl contrib script to work with useqacontact (bug 239912) 
+
+- Improve the error message used by checksetup.pl when the MySQL requirements
+  are not met (bug 240228) 
+
+- Elimnate the warning in checksetup.pl about the minimum sendmail version (bug
+  240060) 
+
+- $webservergroup now defaults to group 'apache' in new installations (bug
+  224477)
+
+- Correct a situation where a bugmail message could be sent twice to a user
+  being added to the CC list if the address was entered in a different case
+  than the user registered with.  (bug 117297)
+
+- Various documentation updates
+
+*********************************************************
+*** USERS UPGRADING FROM ALL VERSIONS PRIOR TO 2.16.4 ***
+*********************************************************
+
+*** Bug fixes of note ***
+
+- Fix a "used only once" warning that ocurred only in perl 5.00503
+  (bug 2321691)
+
+- When a user is creating a new account and enters an invalid email
+  address, the error page sent the "Content-type" header twice, causing
+  the second one to be visible at the top of the page.
+  (bug 137121)
+
+- An HTML encoding issue which only affected Internet Explorer was
+  corrected in the "Change several bugs at once" page.
+  (bug 181106)
+ 
+- During initial setup, using invalid characters in the administrator
+  password would present an error message stating your password was
+  too long or too short instead of telling you it had invalid
+  characters.
+  (bug 166755)
+
+- When a user reset their own password via an emailed token, the new
+  password in the first field would be accepted if the second password
+  field was left blank.
+  (bug 123077)
+
+- Reopening bugs from the "change several bugs at once" page now works.
+  (bug 95430)
+
+- Fix a regression in xml.cgi caused by the previous bugfix for MySQL
+  SUM() changes.  The original fix didn't work properly either.
+  (bug 225474)
+
+- No longer use server push with the "Safari" browser, which claims to
+  use the Mozilla layout engine but doesn't.
+  (bug 188712)
+
+- Creating a shadow database no longer fails with taint mode errors.
+  (bug 227510)
+  
+- If you change your cookiepath setting at some stage (because you have
+  moved the directory Bugzilla resides on your webserver), users can
+  have login cookies with the old cookiepath, and their browsers will
+  send multiple logincookies.  Bugzilla now uses the first rather than
+  the last in order to get the most specific cookie which will be the
+  correct one.
+  (bug 121419) 
+  
+- Fixed a regression caused by the previous DBD::mysql fixes, that
+  caused older versions of DBD::mysql to break due to not supporting
+  the new DBI syntax.
+  (bug 224815)
+
+- Bugzilla no longer sends out invalid dates for cookie expiry.  This
+  bug had no known user visible ramifications.
+  (bug 228706)
+  
+- Update the shadow database parameters description to tell the user
+  about permissions requirements for creating a shadow database.
+  (bug 227513)
+
+- Various documentation updates.
+
+*********************************************************
+*** USERS UPGRADING FROM ALL VERSIONS PRIOR TO 2.16.3 ***
+*********************************************************
+
+*** SECURITY ISSUES RESOLVED ***
+
+- A user with 'editproducts' privileges (i.e. usually an administrator)
+  can select arbitrary SQL to be run by the nightly statistics cron job
+  (collectstats.pl), by giving a product a special name.
+  (bug 214290)
+
+- A user with 'editkeywords' privileges (i.e. usually an administrator)
+  can inject arbitrary SQL via the URL used to edit an existing keyword.
+  (bug 219044)
+
+- When deleting products and the 'usebuggroups' parameter is on, the
+  privilege which allows someone to add people to the group which is
+  being deleted does not get removed, allowing people with that
+  privilege to get that privilege for the next group that is created
+  which reuses that group ID.  Note that this only allows someone who
+  had been granted privileges in the past to retain them.
+  (bug 219690)
+
+- If you know the email address of someone who has voted on a secure
+  bug, you can access the summary of that bug even if you do not have
+  sufficient permissions to view the bug itself.
+  (bug 209376)
+
+*** Bug fixes of note ***
+
+Perl 5.8.0 Compatibility fixes:
+
+- Two taint errors were fixed, one in process_bug.cgi, and 
+  another in post_bug.cgi.
+  (bugs 220332 and 177828)
+
+MySQL 4.0 Compatibility fixes:
+
+- A cosmetic fix was applied to votes.cgi (if there were no 
+  votes, the "0" was not displayed) due to a change in semantics 
+  in SUM() in MySQL 4.0.
+  (bug 217422)
+
+DBD::mysql > 2.1026 Compatibility fixes:
+
+- DBD::mysql versions after 2.1026 return the table list quoted, which
+  broke the existing "table exists" check in checksetup.pl, which caused
+  the second and subsequent attempts to run checksetup.pl to fail.
+  (bug 212095) 
+
+Miscellaneous bug fixes:
+
+- A Mozilla-specific reference was removed from one of the report
+  templates.
+  (bug 221626)
+
+- It was possible to enter a situation where you were unable to get to
+  editparams.cgi to turn the shutdownhtml param back off after you
+  turned it on when Apache was configured to run Bugzilla in suexec
+  mode.
+  (bug 213384)
+  
+- The processmail rescanall task would not send e-mails about more than
+  one bug to the same address.
+  (bug 219508)
+
+- If Bugzilla hadn't been accessed in the last hour when the
+  collectstats.pl or whineatnews.pl cron jobs ran, the versioncache
+  would get recreated with the file owner being the user the cron job
+  was running as (usually not the webserver user), causing subsequent
+  access to Bugzilla by the webserver to fail until the permissions were
+  fixed. Now if versioncache isn't readable when accessing from the
+  webserver, we pretend it doesn't exist and recreate it again.
+  (bug 160422)
+
+- The 'sendmailnow' param is now on by default in new installations
+  (this does not affect existing installations).
+  (bug 146087)
+
+- The 008filter.t test would fail if you had multiple language packs
+  installed. It now properly tests all of the installed language packs.
+  (bug 203318)
+
+- A few minor documentation changes were committed.
+
+*********************************************************
+*** USERS UPGRADING FROM ALL VERSIONS PRIOR TO 2.16.2 ***
+*********************************************************
+
+*** SECURITY ISSUES RESOLVED ***
+
+- A cross site scripting (XSS) vulnerability was fixed in which bug 
+  summaries were not properly filtered when a user viewed a dependency graph 
+  allowing JavaScript to be embedded on that page.
+  (bug 192661)
+  
+- Several XSS vulnerabilities were fixed in which user
+  input was not escaped when being displayed. A new 
+  test has been added to warn about unfiltered data in template
+  files (t/008filter.t).
+  (bug 192677)
+
+- An issue was fixed in which the QA contact was still treated as the QA
+  contact even after the 'useqacontact' setting was turned off. This also
+  allowed the QA contact to edit the security groups and view secured bugs that
+  he/she was allowed to access prior to the 'useqacontact' setting being
+  deactivated.
+  (bug 194394)
+  
+- Fixed a situation where an attacker (with local access to the webserver)
+  could overwrite any file on the webserver to which the webserver user
+  has write access by creating appropriately named symbolic links in the
+  data and webdot directories (world-writable in many configurations).
+  Bugzilla now uses File::Temp to create secure temporary files.  File::Temp
+  is part of the Perl distribution for Perl 5.6.1 and later, but if you're
+  using an older version of Perl you'll need to install it with CPAN.
+  (bug 197153)
+
+** IMPORTANT CHANGES ***
+
+- New module requirement: File::Temp, as mentioned above.
+
+*** Bug fixes of note ***
+
+- An issue was fixed in which administrator rights could be removed from an
+  administrator who deleted a product while the 'usebuggroups' setting is
+  activated.
+  (bug 157704) 
+  
+- Fixed an issue in which importxml.pl would fail the test suite when running
+  under perl 5.8.0 with the optional XML::Parse module. 
+  (bug 172331)
+  
+- There was previously a bug in CGI.pl in which the following warning 
+  would be given under certain conditions: 
+  "Character in "c" format wrapped at CGI.pl..." 
+  This is now fixed. In some cases the warning was filling up web server log
+  files.
+  (bug 194125)
+  
+- Fixed a bug in which long component names (in excess of 50 characters) would
+  be accepted when creating the component but would cause problems when trying
+  to use that component on a bug because it would get truncated. It is now no
+  longer possible to create components with names in excess of 50 characters. 
+  (bug 197180)
+  
+- Fixed a bug in checksetup.pl in which permissions were not being fixed 
+  on the 'data/comments' file, the quip file. 
+  (bug 160279)
+
+*****************************************************************
+*** USERS UPGRADING FROM 2.16.1 OR EARLIER, 2.14.4 OR EARLIER ***
+*****************************************************************
+
+*** SECURITY ISSUES RESOLVED ***
+
+- Fixed a cross site scriptability issue in quips.  This is only a problem
+  if quips with HTML could have been inserted into your quips files.  Bugzilla
+  has not allowed this since 2.12.
+  (bug 179329)
+- checksetup.pl will now attempt to prevent access to "editor backups" of
+  localconfig.
+  (bug 186383)
+- collectstats.pl no longer makes data/mining (which contains graphing
+  information) world writeable.
+  (bug 183188)
+
+***********************************************
+*** USERS UPGRADING FROM 2.16.0 OR EARLIER  ***
+***********************************************
+
+*** SECURITY ISSUES RESOLVED ***
+
+- Apostrophes were not properly handled in email addresses.  This was a
+  regression introduced in 2.16.  It is not known whether this was
+  exploitable.
+  (bug 165221)
+
+See also next major section.
+
+*** Bug fixes of note ***
+
+- The VERSION cookie which allowed the previously entered version of a product
+  to be remembered was not correctly set.  It was only set as a session
+  cookie, and under some circumstances could interfere with other cookies
+  (such as the login information) send at the same time.
+  (bug 160227)
+
+- importxml.pl would fail if the versioncache needed to be updated.
+  (bug 164464)
+
+- Bug changes going through intermediate pages would munge fields with
+  multiple fields, such as CCs.
+  (bug 161203)
+
+- On failure in template->new, Bugzilla will now die rather than futilely
+  attempt to use an error template.
+  (bug 166023)
+
+- Fixed a problem where checksetup had problems converting old installations
+  that didn't have a duplicates table.
+  (bug 151619)
+
+- Fixed a problem that caused taint errors when viewing or editing user
+  preferences with Perl 5.005 and Template 2.08.
+  (bug 160710)
+
+See also next section.
+
+******************************************************
+*** USERS UPGRADING FROM 2.16.0, 2.14.3 OR EARLIER ***
+******************************************************
+
+*** SECURITY ISSUES RESOLVED ***
+
+- When a new product is added to an installation with 47 groups or more and
+  "usebuggroups" is enabled, the new group will be assigned a groupset bit
+  using Perl math that is not exact beyond 2^48.  This results in the new
+  group being defined with a "bit" that has several bits set.  As users are
+  given access to the new group, those users will also gain access to
+  spurious lower group privileges.  Also, group bits were not always reused
+  when groups were deleted.
+  (bug 167485)
+
+- The email interface had another insecure single parameter system call.  This
+  could potentially allow arbitrary shell commands to be run.  This file is
+  not supported at this time, but as long as we knew about the problem, we
+  couldn't overlook it.
+  (bug 163024)
+
+*** Bug fixes of note ***
+
+- The email interface was broken.  This was a 2.14.3 regression.  This file
+  is not supported at this time, but as long as we knew about the problem, we
+  couldn't overlook it.
+  (bug 160631)
+
+***********************************************
+*** USERS UPGRADING FROM 2.14.5 OR EARLIER  ***
+***********************************************
+
+*** SECURITY ISSUES RESOLVED ***
+
+- The bug reporter could set the priority even when
+  'letsubmitterchoosepriority' was off.
+  (bug 63018)
+
+- Most CGIs are now templatized.  This helps to make it
+  easier to remember to HTML filter values and easier to spot
+  when they are not, preventing cross site scripting attacks.
+  (bug 86168)
+
+- Most CGIs now run in taint mode.  This helps to prevent
+  failure to validate errors.
+  (bug 108982)
+
+*** IMPORTANT CHANGES ***
+
+- 2.16 introduces "templatization", a new feature that allows
+  administrators to easily customize the HTML output (the "look and feel")
+  of Bugzilla without altering Perl code.  Bugzilla uses the
+  "Template Toolkit" for this.  Please see the "Template Customization"
+  section of the Bugzilla Guide for more details.
+
+  Administrators who ran the 2.15 development version with custom
+  templates should check the templates are still valid, as file names
+  and file paths have changed.
+
+  Most output is now templatized.  This process will be complete next
+  milestone.
+
+  For speed, compiled templates are cached on disk.  If you modify the
+  templates, the toolkit will normally detect the changes, and recompile the
+  changed templates.
+
+  Adding new directories anywhere inside the template directory may cause 
+  permission errors if you don't have a webservergroup specified in
+  localconfig.  If you see these, rerun checksetup.pl as root.  If you do not
+  have root access, or cannot get someone who does to do this for you, you can
+  rename the data/template directory to data/template.old (or any other name
+  Bugzilla doesn't use).  Then rerun checksetup.pl to regenerate the compiled
+  templates.
+  (bug 86168, 97832)
+
+- Administrators can now configure maximum attachment sizes.  These
+  should remain below the maximum size for your MySQL server, or you
+  will get obscure MySQL errors if you attach a bigger attachment.
+
+  To find out the current size attachment that MySQL can accept, type
+  the command 'mysqladmin variables' and find out the value of the
+  'max_allowed_packet' varible in bytes.
+
+  To change the maximum size that MySQL can accept you can alter this
+  variable in your 'my.cnf' file.
+  (bug 91664)
+
+- Perl 5.004 is no longer supported because the Template Toolkit
+  requires 5.005.
+  (bug 97721)
+
+- New module requirements: Text::Wrap, Template [requires AppConfig],
+                           File::Spec.
+  (bugs 97784, 84338, 103778)
+
+- The index page is now a CGI instead of an HTML page.  You should remove
+  any existing index.html file and make sure your web server allows index.cgi
+  to be the default page in a directory.  If you are not able to do that you
+  can instead set index_html in the 'localconfig' file to 1 and checksetup.pl
+  will create a redirect page for you.
+  (bug 80183)
+
+- It is now recommended that administrators run "processmail rescanall"
+  after upgrading to 2.16 or beyond.
+
+  This will send out notification emails for changes that were
+  made but not emailed, due to Bugzilla bugs.  All known
+  causes of this have been fixed in this version (bug 104589 and 99519).
+
+  It is also recommended that this be run nightly to avoid
+  lengthy delays in future if this problem reoccurs.
+  (bug 106377)
+
+- In parallel with templatization, a lot of changes have been made to the HTML
+  output of the Bugzilla CGIs.  This could break code that attempts to parse
+  such code.  For example, this breaks mozbot.
+  (no bug number)
+
+- The "HTML template" parameters (headerhtml, bodyhtml, footerhtml,
+  errorhtml, bannerhtml, blurbhtml, mostfreqhtml, entryheaderhtml) have now
+  been moved to Template Toolkit templates.  If you have modified these
+  parameters you will need to make corresponding changes to the corresponding
+  templates.  Your old parameter values will be moved to a file called
+  old-params.txt by checksetup.pl.
+
+  The old parameters correspond to files in template/en/default as follows:
+
+  headerhtml:      global/header.html.tmpl
+  footerhtml:      global/footer.html.tmpl
+  bannerhtml:      global/banner.html.tmpl
+  blurbhtml:       global/banner.html.tmpl
+  mostfreqhtml:    reports/duplicates*.html.tmpl
+  entryheaderhtml: bug/create/user-message.html.tmpl
+
+  (bug 140437)
+
+*** Other changes of note ***
+
+- The query page has been redesigned for better user friendliness.
+  (bug 98707)
+- Users can now change their email account.
+  (bug 23067)
+- "Dependent Bug Changed" notification emails now contain the
+  dependent bug's summary and URL.
+  (bug 28736, 113383)
+- Bugs with severity "critical", "blocker", and "enhancement" are
+  visually differentiated on bug lists for browsers with sufficient
+  CSS support.
+  (bug 28884)
+- Bugzilla now has a sidebar for the Mozilla browser.
+  (bug 37339)
+- A link to just created attachments now appears in notification
+  email.
+  (bug 66651)
+- Comments now have numbers and can be referenced with
+  autohyperlinkifying similar to bugs.
+  (bug 71840)
+- The attachment system has been rewritten, supporting new
+  "attachment statuses" (like keywords, but for attachments),
+  the ability to obsolete attachments, edit attachment MIME type,
+  and edit whether the attachment is a patch.
+  (bugs 84338, 75176)
+- syncshadowdb now supports a configurable temp file location,
+  and properly shuts down Bugzilla while running.
+  (bug 75840)
+- Dependency tree now lets you exclude resolved bugs and bugs
+  below a specified depth.
+  (bugs 83058)
+- The "strictvaluechecks" parameter has gone away.  These checks
+  are now always done.
+  (bug 119715)
+- The midair collision page now shows all changes since the bug
+  page was loaded, not just the last one.
+  (bug 108312)
+- Added support for making dependency graphs with 'dot', which
+  is better at creating complex graphs than 'webdot'.
+  (bug 120537)
+
+*** Bug fixes of note ***
+
+- Bugzilla scripts are now usually not terminated when the browser
+  window they are running in is closed.  This caused hard to
+  reproduce bugs.
+  (bug 104589)
+- On browsers that "reflow" the page, large component / milestone /
+  version fields were extremely slow to reflow when you altered
+  the product field.
+  (bug 96534)
+- The selection in the component / milestone / version fields is
+  no longer lost when you change the selection in the product
+  field or use the back/forward buttons in your browser to return
+  to the page.
+  (bug 97966)
+- You could not reverse dependencies in one step.
+  (bug 82143)
+- Mass reassignment of non-open bugs will no longer reopen them.
+  (bug 30731)
+- Attempting to bulk change no bugs will now give a user-friendly
+  error message.
+  (bug 90333)
+- If you make a change to a bug where you only add yourself to CC,
+  email notifications are now properly sent out for MySQL 3.23.
+  (bug 99519)
+- Bug entry now properly validates the data it has been sent.
+  (bug 107743)
+- Midair collision checks will now properly work in all situations
+  where dependencies have changed.
+  (bug 73502)
+- Browsers can no longer corrupt the params file if they use the "wrong"
+  end-of-line markers.
+  (bug 92500)
+- The MySQL port defined in localconfig is now properly honoured.
+  (bug 98368)
+- Apostrophes in component/milestone/version names no longer cause
+  a problem on the query page.
+  (bug 30689/42810)
+- File attachment comments will now wrap.
+  (bug 52060)
+- Saved queries are no longer mangled if you need to log in again,
+  for example if you had cookies off.
+  (bug 38835)
+- Bug counts (on reports.cgi) were very slow if you had to
+  count a lot of bugs.
+  (bug 63249)
+- 2.14 introduced options to let people see a bug when their name
+  is on it but who aren't in the groups the bug is restricted
+  to.  These only allowed the people to view the bugs directly,
+  and not see them on buglists and receive email about them.
+  (bugs 95024, 97469)
+- A new 'cookiepath' parameter on editparams.cgi allows multiple
+  Bugzilla installations to exist on one host without problems.
+  (bug 19910)
+- whineatnews.pl now respects the 'sendmailnow' parameter.
+  (bug 52782)
+- The query page came up even when Bugzilla was shut down.
+  (bug 121747)
+- Quicksearch gave a weird error message when Bugzilla was
+  shut down.
+  (bug 121741)
+- Operating system detection fixes.
+  (bugs 92763, 135666)
+- QA contacts now receive emails when a new bug is created and
+  their only email preference was being added or removed from QA.
+  (bug 143091)
+
+***********************************************
+*** USERS UPGRADING FROM 2.14.4 OR EARLIER  ***
+***********************************************
+
+See section above about users upgrading from 2.16.1 or earlier,
+2.14.4 or earlier.
+
+***********************************************
+*** USERS UPGRADING FROM 2.14.3 OR EARLIER  ***
+***********************************************
+
+See section above about users upgrading from 2.16.0 or earlier.
+
+***********************************************
+*** USERS UPGRADING FROM 2.14.2 OR EARLIER  ***
+***********************************************
+
+*** SECURITY ISSUES RESOLVED ***
+
+- Basic maintenance on contrib/bug_email.pl and
+  contrib/bugzilla_email_append.pl which also fixes a
+  possible security hole with a misuse of a system() call.
+  These files are not supported at this time, but as long
+  as we knew about the problem, we couldn't overlook it.
+  (bug 154008)
+
+*** Bug fixes of note ***
+
+- The fix for bug 130821 in 2.14.2 broke being able to sort
+  bug lists on more than one field.  buglist.cgi now allows
+  you to sort on more than one field again.
+  (bug 152138)
+
+***********************************************
+*** USERS UPGRADING FROM 2.14.1 OR EARLIER  ***
+***********************************************
+
+*** SECURITY ISSUES RESOLVED ***
+
+- queryhelp.cgi no longer shows confidential products to
+  people it shouldn't.
+  (bug 126801)
+
+- It was possible for a user to bypass the IP check by
+  setting up a fake reverse DNS, if the Bugzilla web server
+  was configured to do reverse DNS lookups.  Apache is not
+  configured as such by default.  This is not a complete
+  exploit, as the user's login cookie would also need to
+  be divulged for this to be a problem.
+  (bug 129466)
+
+- In some situations the data directory became world writeable.
+  (bug 134575)
+
+- Any user with access to editusers.cgi could delete a user
+  regardless of whether 'allowuserdeletion' is on.
+  (bug 141557)
+
+- Real names were not HTML filtered, causing possible cross
+  site scripting attacks.
+  (bug 146447, 147486)
+
+- Mass change would set the groupset of every bug to be the
+  groupset of the first bug.
+  (bug 107718)
+
+- Some browsers (eg NetPositive) interacted with Bugzilla
+  badly and could have various form problems, including
+  removing group restrictions on bugs.
+  (bug 148674)
+
+- It was possible for random confidential information to be
+  divulged, if the shadow database was in use and became
+  corrupted.
+  (bug 92263)
+
+- The bug list sort order is now stricter about the SQL it will accept,
+  ensuring you use correct column name syntax.  Before this, there were
+  some syntax checks, so it is not known whether this problem was
+  exploitable.
+  (bug 130821)
+
+********************************************
+*** USERS UPGRADING FROM 2.14 OR EARLIER ***
+********************************************
+
+The 2.14.1 release fixes several security issues that became
+known to us after the Bugzilla 2.14 release.
+
+*** SECURITY ISSUES RESOLVED ***
+
+- If LDAP Authentication was being used, Bugzilla would allow
+  you to log in as anyone if you left the password blank.
+  (bug 54901)
+
+- It was possible to add comments or file a bug as someone else
+  by editing the HTML on the appropriate submission page before
+  submitting the form.  User identity is checked now, and the
+  form values suggesting the user are now ignored.
+  (bug 108385, 108516)
+
+- The Product popup menu on the show_bug form listed all
+  products, even if the user didn't have access to all of them.
+  It now only shows products the user has access to (and the
+  product the bug is in, if the user is viewing it because of
+  some other override).
+  (bug 102141)
+
+- If a user had any blessgroupset privileges (the ability to
+  change only specific privileges for other users), it was
+  possible to change your own groupset (privileges) by
+  altering the page HTML before submitting on editusers.cgi.
+  (bug 108821)
+
+- An untrusted variable was echoed back to user in the HTML
+  output if there was a login error while editing votes.
+  (bug 98146)
+
+- buglist.cgi had an undocumented parameter that allowed you
+  to pass arbitrary SQL for the "WHERE" part of a query.
+  This has been disabled.
+  (bug 108812)
+
+- It was possible for a user to send arbitrary SQL by inserting
+  single quotes in the "mybugslink" field in the user
+  preferences.
+  (bug 108822)
+
+- buglist.cgi was not validating that the field names being
+  passed from the "boolean chart" query form were valid field
+  names, thus allowing arbitrary SQL to be inserted if you 
+  edited the HTML by hand before submitting the form.
+  (bug 109679)
+
+- long_list.cgi was not validating that the bug ID parameter
+  was actually a number, allowing arbitrary SQL to be inserted
+  if you edited the HTML by hand.
+  (bug 109690)
+
+********************************************
+*** USERS UPGRADING FROM 2.12 OR EARLIER ***
+********************************************
+
+*** SECURITY ISSUES RESOLVED ***
+
+- Multiple instances of unauthorized access to confidential
+  bugs have been fixed.
+  (bug 39524, 39526, 39527, 39531, 39533, 70189, 82781)
+
+- Multiple instances of untrusted parameters not being
+  checked/escaped was fixed.  These included definite security
+  holes.
+  (bug 38854, 38855, 38859, 39536, 87701, 95235)
+
+- After logging in passwords no longer appear in the URL.
+  (bug 15980)
+
+- Procedures to prevent unauthorized access to confidential
+  files are now simpler.  In particular the shadow directory
+  no longer exists and the data/comments file no longer needs
+  to be directly accessible, so the entire data directory can
+  be blocked.  However, no changes are required here if you
+  have a properly secured 2.12 installation as no new files
+  must be protected.
+  (bug 71552, 73191)
+
+- If they do not already exist, checksetup.pl will attempt to
+  write Apache .htaccess files by default, to prevent
+  unauthorized access to confidential files.  You can turn this
+  off in the localconfig file.
+  (bug 76154)
+
+- Sanity check can now only be run by people in the 'editbugs'
+  group.  Although it would be better to have a separate
+  group, this is not possible until the limitation on the
+  number of groups allowed has been removed.
+  (bug 54556)
+
+- The password is no longer stored in plaintext form.  It will
+  be eradicated next time you run checksetup.pl.  A user must
+  now change their password via a password change request that
+  gets validated at their e-mail account, rather than have it
+  mailed to them.
+  (bug 74032)
+
+- When you are using product groups and you move a bug between
+  products (single or mass change), the bug will no longer be
+  restricted to the old product's group (if it was) and will
+  be restricted to the new product's group.
+  (bug 66235)
+
+- There are now options on a bug to choose whether the
+  reporter, and CCs can access a bug even if they aren't in
+  groups the bug it is restricted to.
+  (bug 39816)
+
+- You can no longer mark a bug as a duplicate of a bug you
+  can't see, and if you mark a bug a duplicate of a bug
+  the reporter cannot see you will be given options as to
+  what to do regarding adding the reporter of the resolved
+  bug to the CC of the open bug.
+  (bug 96085)
+
+*** IMPORTANT CHANGES ***
+
+- Bugzilla 2.14 no longer supports old email tech.  Upon
+  upgrading, all users will be moved over to new email tech.
+  This should speed up upgrading for installations with
+  a large number of bugs.
+  (bug 71552)
+
+- There is new functionality for people to see why they are
+  receiving notification mails.
+
+  Previously, some people filtered old email tech
+  notifications depending on whether they were in the To or the
+  CC header, in order to get a limited way of determining why
+  they were receiving the notification for filtering purposes.
+
+  Existing installations will need to make changes to support
+  this feature.  The receive reasons can be added to the
+  notifications as a header and/or in the body.  To add these
+  you will need to modify your newchangedmail parameter on
+  editparams.cgi, either by resetting it or appropriately
+  modifying it.  The header value is specified by
+  %reasonsheader% and the body by %reasonsbody%.  For example,
+  the new default parameter is:
+
+  --------------------------------------------------
+  From: bugzilla-daemon
+  To: %to%
+  Subject: [Bug %bugid%] %neworchanged%%summary%
+  X-Bugzilla-Reason: %reasonsheader%
+
+  %urlbase%show_bug.cgi?id=%bugid%
+
+  %diffs%
+
+
+
+  %reasonsbody%
+  --------------------------------------------------
+
+  (bug 26194)
+
+- Very long fields (especially multi-valued fields like keywords,
+  CCs, dependencies) on bug activity and notifications previously
+  could get truncated, resulting in useless notifications and data
+  loss on bug activity.  Now the multi-valued fields only show
+  changes, and very big changes are split into multiple lines.
+  Where data loss has already occurred on bug activity, it is
+  indicated using question marks.
+  (bug 55161, 92266)
+
+- Previously, when a product's voting preferences changed all
+  votes were removed from all the bugs in the product.  Also,
+  when a bug was moved to another product, all of its votes
+  were removed.  This no longer occurs.
+
+  Instead, if the action would leave one or more bugs with
+  greater than the maximum number of votes per person per bug,
+  the number of votes will be reduced to the maximum.  The
+  person will still be notified of this as before.
+
+  If the action would leave a user with more votes in a product
+  than is allowed, the limit will be breached so as to not lose
+  votes.  However the user will not be able to update their
+  votes except to fix this situation.  No further action is taken
+  in this version to make sure that the user does this.
+  (bug 28882, 92593)
+
+*** Other changes of note ***
+
+- Groups can now be marked inactive, so you can't add a new
+  restriction on that group to a bug, while leaving bugs that
+  were previously restricted on that group alone.
+  (bug 75482)
+- backdoor.cgi has been removed from the installation.  It was
+  old code that was Netscape-specific and its name was scaring
+  people.
+  (bug 87983)
+- You can now add or remove from CC on the bulk change page.
+  (bug 12819)
+- New users created by administrators are now automatically
+  inserted into groups according to the group's regular
+  expression.  Administrators must edit the user in a second
+  step to override these choices.  Previously the
+  administrator specified these explicitly which could lead
+  to incorrect settings.
+  (bug 45164)
+- The userregexp of system groups can now be edited without
+  resorting to direct database access.
+  (bug 65290)
+
+*** Bug fixes of note ***
+
+- The bug list page was sometimes bringing up a not logged in
+  footer when the user was logged in and the installation was
+  using a shadow database.
+  (bug 47914)
+- You can now view the bug summary in your browser title for
+  a group-restricted bug if you have proper permissions.
+  (bug 71767)
+- Quick search for search terms did not work in IE5.
+  This has been worked around.
+  (bug 77699)
+- Quick search for search terms crashed NN4.76/4.77 for Unix.
+  This has been worked around.
+  (bug 83619)
+- Queries on bugs you have commented on using the "added
+  comment" feature should be a lot faster and not time out
+  on large installations due to the addition of an index.
+  (bug 57350)
+- You can now alter group settings on bulk change for groups
+  that aren't on for all bugs or off for all bugs.
+  (bug 84714)
+- New bug notifications now include the CC and QA fields.
+  (bug 28458)
+- Bugzilla is now more Windows friendly, although it is still
+  not an official platform.
+  (bug 88179, 29064)
+- Passwords are now encrypted using Perl's encrypt function.
+  This makes Bugzilla more portable to more operating systems.
+  (bug 77473)
+- Bugzilla didn't properly shut down when told to - some
+  queries could still be sent to the database.
+  (bug 95082)
+
+********************************************
+*** USERS UPGRADING FROM 2.10 OR EARLIER ***
+********************************************
+
+*** SECURITY ISSUES RESOLVED ***
+
+- Some security holes have been fixed where shell escape characters
+  could be passed to Bugzilla, allowing remote users to execute
+  system commands on the web server.
+
+*** IMPORTANT CHANGES ***
+
+- There is now a facility for users to choose the sort of
+  notifications they wish to receive.  This facility will
+  probably be improved in future versions.
+  (bug 17464)
+
+- "Changed" will no longer appear on the subject line of
+  change notification emails.  Because of this, you should
+  change the subject line in your 'changedmail' and
+  'newchangedmail' params on editparams.cgi.  The subject
+  line needs to be changed from
+
+    Subject: [Bug %bugid%] %neworchanged% - %summary%
+
+  to:
+
+    Subject: [Bug %bugid%] %neworchanged%%summary%
+
+  or whatever is appropriate for the subject you are using
+  on your system.  Note the removal of the " - " in the
+  middle.
+  (bug 29820)
+
+*** Other changes of note ***
+
+- Bug titles now appear in the page title, and will hence
+  display in the user's browser's bookmarks and history.
+  (bug 22041)
+- Edit groups functionality (editgroups.cgi).
+  (bug 25010)
+- Support for moving bugs to other Bugzilla databases.
+  (bug 36133)
+- Bugzilla now can generate a frequently reported bugs list
+  based on what duplicates you receive.
+  (bug 25693)
+- When installing Bugzilla fresh, the administrator account is
+  now created in checksetup.pl.
+  (bug 17773)
+- Stored queries now show their name above the bug list, which
+  helps the user when they have multiple bug lists in multiple
+  browser windows.  It also appears in the page title, and will
+  hence display in the user's browser's bookmarks and history.
+  (bug 52228)
+- All states and resolutions can now be collected for charting.
+  (bug 6682)
+- A new search-engine-like "quick search" feature appears on
+  the front page to try and making searching easier.
+  (bug 69793)
+- Querying on dependencies now works in the advanced query
+  section of the query page.
+  (bug 30823)
+- When a bug is marked as a duplicate, the reporter of the
+  resolved bug is automatically added to the CC list of the
+  open bug.
+  (bug 28676)
+
+*** Bug fixes of note ***
+
+- Notification emails will now always be sent to QA contacts.
+  Previously they wouldn't if you were using new email tech.
+  (bug 30826)
+- When marking a bug as a duplicate, the duplicate stamp marked
+  on the open bug will no longer be written too early (such as
+  on mid-air collisions).
+  (bug 7873)
+- Various bug fixes were made to the initial assignee and QA
+  of a component.  It is no longer possible to enter an
+  invalid address.  They will also now properly update when
+  a user's email address is changed.  Sanity check will now
+  check these.
+  (bug 66876)
+- Administrators can no longer create an email accounts that do
+  not match the global email regular expression parameter.
+  Previously this could occur and would cause sanity check
+  errors.
+  (bug 32971)
+- The resolution field can no longer become empty when the
+  bug is resolved.  This occurred because of midair collisions.
+  (bug 49306)
+
+*******************************************
+*** USERS UPGRADING FROM 2.8 OR EARLIER ***
+*******************************************
+
+This version of Bugzilla cannot upgrade from version 2.8 (released
+November 19, 1999). You will first have to upgrade to Bugzilla 3.6 and
+then upgrade to the latest release.
+
+If you are upgrading from a version earlier than 2.8, See the 
+PGRADING-pre-2.8 file in Bugzilla 3.0 for information
+on upgrading from a version that is earlier than 2.8.

diff --git a/docs/en/txt/Bugzilla-Guide.txt b/docs/en/txt/Bugzilla-Guide.txt
new file mode 100644 (file)
index 0000000..b4b6fd6
--- /dev/null
+++ b/docs/en/txt/Bugzilla-Guide.txt
@@ -0,0 +1,6440 @@
+The Bugzilla Guide - 4.4 Release
+
+The Bugzilla Team
+
+   2013-05-22
+
+   Abstract
+
+   This is the documentation for Bugzilla, a bug-tracking system from
+   mozilla.org. Bugzilla is an enterprise-class piece of software that
+   tracks millions of bugs and issues for hundreds of organizations around
+   the world.
+
+   The most current version of this document can always be found on the
+   Bugzilla Documentation Page.
+     __________________________________________________________________
+
+   Table of Contents
+
+   1. About This Guide
+
+        1.1. Copyright Information
+        1.2. Disclaimer
+        1.3. New Versions
+        1.4. Credits
+        1.5. Document Conventions
+
+   2. Installing Bugzilla
+
+        2.1. Installation
+
+              2.1.1. Perl
+              2.1.2. Database Engine
+              2.1.3. Web Server
+              2.1.4. Bugzilla
+              2.1.5. Perl Modules
+              2.1.6. Mail Transfer Agent (MTA)
+              2.1.7. Installing Bugzilla on mod_perl
+
+        2.2. Configuration
+
+              2.2.1. localconfig
+              2.2.2. Database Server
+              2.2.3. checksetup.pl
+              2.2.4. Web server
+              2.2.5. Bugzilla
+
+        2.3. Optional Additional Configuration
+
+              2.3.1. Bug Graphs
+              2.3.2. The Whining Cron
+              2.3.3. Whining
+              2.3.4. Serving Alternate Formats with the right MIME type
+
+        2.4. Multiple Bugzilla databases with a single installation
+        2.5. OS-Specific Installation Notes
+
+              2.5.1. Microsoft Windows
+              2.5.2. Mac OS X™
+              2.5.3. Linux Distributions
+
+        2.6. UNIX (non-root) Installation Notes
+
+              2.6.1. Introduction
+              2.6.2. MySQL
+              2.6.3. Perl
+              2.6.4. Perl Modules
+              2.6.5. HTTP Server
+              2.6.6. Bugzilla
+
+        2.7. Upgrading to New Releases
+
+              2.7.1. Before You Upgrade
+              2.7.2. Getting The New Bugzilla
+              2.7.3. Completing Your Upgrade
+              2.7.4. Automatic Notifications of New Releases
+
+   3. Administering Bugzilla
+
+        3.1. Bugzilla Configuration
+
+              3.1.1. Required Settings
+              3.1.2. Administrative Policies
+              3.1.3. User Authentication
+              3.1.4. Attachments
+              3.1.5. Bug Change Policies
+              3.1.6. Bug Fields
+              3.1.7. Bug Moving
+              3.1.8. Dependency Graphs
+              3.1.9. Group Security
+              3.1.10. LDAP Authentication
+              3.1.11. RADIUS Authentication
+              3.1.12. Email
+              3.1.13. Patch Viewer
+              3.1.14. Query Defaults
+              3.1.15. Shadow Database
+              3.1.16. User Matching
+
+        3.2. User Administration
+
+              3.2.1. Creating the Default User
+              3.2.2. Managing Other Users
+
+        3.3. Classifications
+        3.4. Products
+
+              3.4.1. Creating New Products
+              3.4.2. Editing Products
+              3.4.3. Adding or Editing Components, Versions and Target
+                      Milestones
+
+              3.4.4. Assigning Group Controls to Products
+
+        3.5. Components
+        3.6. Versions
+        3.7. Milestones
+        3.8. Flags
+
+              3.8.1. A Simple Example
+              3.8.2. About Flags
+              3.8.3. Using flag requests
+              3.8.4. Two Types of Flags
+              3.8.5. Administering Flags
+
+        3.9. Keywords
+        3.10. Custom Fields
+
+              3.10.1. Adding Custom Fields
+              3.10.2. Editing Custom Fields
+              3.10.3. Deleting Custom Fields
+
+        3.11. Legal Values
+
+              3.11.1. Viewing/Editing legal values
+              3.11.2. Deleting legal values
+
+        3.12. Bug Status Workflow
+        3.13. Voting
+        3.14. Quips
+        3.15. Groups and Group Security
+
+              3.15.1. Creating Groups
+              3.15.2. Editing Groups and Assigning Group Permissions
+              3.15.3. Assigning Users to Groups
+              3.15.4. Assigning Group Controls to Products
+
+        3.16. Checking and Maintaining Database Integrity
+
+   4. Bugzilla Security
+
+        4.1. Operating System
+
+              4.1.1. TCP/IP Ports
+              4.1.2. System User Accounts
+              4.1.3. The chroot Jail
+
+        4.2. Web server
+
+              4.2.1. Disabling Remote Access to Bugzilla Configuration
+                      Files
+
+        4.3. Bugzilla
+
+              4.3.1. Prevent users injecting malicious Javascript
+
+   5. Using Bugzilla
+
+        5.1. Introduction
+        5.2. Create a Bugzilla Account
+        5.3. Anatomy of a Bug
+        5.4. Life Cycle of a Bug
+        5.5. Searching for Bugs
+
+              5.5.1. Boolean Charts
+              5.5.2. Quicksearch
+              5.5.3. Case Sensitivity in Searches
+              5.5.4. Bug Lists
+              5.5.5. Adding/removing tags to/from bugs
+
+        5.6. Filing Bugs
+
+              5.6.1. Reporting a New Bug
+              5.6.2. Clone an Existing Bug
+
+        5.7. Attachments
+
+              5.7.1. Patch Viewer
+
+        5.8. Hints and Tips
+
+              5.8.1. Autolinkification
+              5.8.2. Comments
+              5.8.3. Server-Side Comment Wrapping
+              5.8.4. Dependency Tree
+
+        5.9. Time Tracking Information
+        5.10. User Preferences
+
+              5.10.1. General Preferences
+              5.10.2. Email Preferences
+              5.10.3. Saved Searches
+              5.10.4. Name and Password
+              5.10.5. Permissions
+
+        5.11. Reports and Charts
+
+              5.11.1. Reports
+              5.11.2. Charts
+
+        5.12. Flags
+        5.13. Whining
+
+              5.13.1. The Event
+              5.13.2. Whining Schedule
+              5.13.3. Whining Searches
+              5.13.4. Saving Your Changes
+
+   6. Customizing Bugzilla
+
+        6.1. Bugzilla Extensions
+        6.2. Custom Skins
+        6.3. Template Customization
+
+              6.3.1. Template Directory Structure
+              6.3.2. Choosing a Customization Method
+              6.3.3. How To Edit Templates
+              6.3.4. Template Formats and Types
+              6.3.5. Particular Templates
+              6.3.6. Configuring Bugzilla to Detect the User's Language
+
+        6.4. Customizing Who Can Change What
+        6.5. Integrating Bugzilla with Third-Party Tools
+
+   A. Troubleshooting
+
+        A.1. General Advice
+        A.2. The Apache web server is not serving Bugzilla pages
+        A.3. I installed a Perl module, but checksetup.pl claims it's not
+                installed!
+
+        A.4. DBD::Sponge::db prepare failed
+        A.5. cannot chdir(/var/spool/mqueue)
+        A.6. Everybody is constantly being forced to relogin
+        A.7. index.cgi doesn't show up unless specified in the URL
+        A.8. checksetup.pl reports "Client does not support authentication
+                protocol requested by server..."
+
+   B. Contrib
+
+        B.1. Command-line Search Interface
+        B.2. Command-line 'Send Unsent Bug-mail' tool
+
+   C. Manual Installation of Perl Modules
+
+        C.1. Instructions
+        C.2. Download Locations
+        C.3. Optional Modules
+
+   D. GNU Free Documentation License
+
+        D.0. Preamble
+        D.1. Applicability and Definition
+        D.2. Verbatim Copying
+        D.3. Copying in Quantity
+        D.4. Modifications
+        D.5. Combining Documents
+        D.6. Collections of Documents
+        D.7. Aggregation with Independent Works
+        D.8. Translation
+        D.9. Termination
+        D.10. Future Revisions of this License
+        D.. How to use this License for your documents
+
+   Glossary
+
+   List of Figures
+
+   5.1. Lifecycle of a Bugzilla Bug
+
+   List of Examples
+
+   A.1. Examples of urlbase/cookiepath pairs for sharing login cookies
+   A.2. Examples of urlbase/cookiepath pairs to restrict the login cookie
+
+Chapter 1. About This Guide
+
+   Table of Contents
+
+   1.1. Copyright Information
+   1.2. Disclaimer
+   1.3. New Versions
+   1.4. Credits
+   1.5. Document Conventions
+
+1.1. Copyright Information
+
+   This document is copyright (c) 2000-2013 by the various Bugzilla
+   contributors who wrote it.
+
+     Permission is granted to copy, distribute and/or modify this
+     document under the terms of the GNU Free Documentation License,
+     Version 1.1 or any later version published by the Free Software
+     Foundation; with no Invariant Sections, no Front-Cover Texts, and
+     with no Back-Cover Texts. A copy of the license is included in
+     Appendix D, GNU Free Documentation License.
+
+   If you have any questions regarding this document, its copyright, or
+   publishing this document in non-electronic form, please contact the
+   Bugzilla Team.
+
+1.2. Disclaimer
+
+   No liability for the contents of this document can be accepted. Follow
+   the instructions herein at your own risk. This document may contain
+   errors and inaccuracies that may damage your system, cause your partner
+   to leave you, your boss to fire you, your cats to pee on your furniture
+   and clothing, and global thermonuclear war. Proceed with caution.
+
+   Naming of particular products or brands should not be seen as
+   endorsements, with the exception of the term "GNU/Linux". We
+   wholeheartedly endorse the use of GNU/Linux; it is an extremely
+   versatile, stable, and robust operating system that offers an ideal
+   operating environment for Bugzilla.
+
+   Although the Bugzilla development team has taken great care to ensure
+   that all exploitable bugs have been fixed, security holes surely exist
+   in any piece of code. Great care should be taken both in the
+   installation and usage of this software. The Bugzilla development team
+   members assume no liability for your use of Bugzilla. You have the
+   source code, and are responsible for auditing it yourself to ensure
+   your security needs are met.
+
+1.3. New Versions
+
+   This is the 4.4 version of The Bugzilla Guide. It is so named to match
+   the current version of Bugzilla.
+
+   The latest version of this guide can always be found at
+   http://www.bugzilla.org/docs/. However, you should read the version
+   which came with the Bugzilla release you are using.
+
+   In addition, there are Bugzilla template localization projects in
+   several languages. They may have translated documentation available. If
+   you would like to volunteer to translate the Guide into additional
+   languages, please visit the Bugzilla L10n team page.
+
+1.4. Credits
+
+   The people listed below have made enormous contributions to the
+   creation of this Guide, through their writing, dedicated hacking
+   efforts, numerous e-mail and IRC support sessions, and overall
+   excellent contribution to the Bugzilla community:
+
+   Matthew P. Barnson <mbarnson@sisna.com>
+          for the Herculean task of pulling together the Bugzilla Guide
+          and shepherding it to 2.14.
+
+   Terry Weissman <terry@mozilla.org>
+          for initially writing Bugzilla and creating the README upon
+          which the UNIX installation documentation is largely based.
+
+   Tara Hernandez <tara@tequilarists.org>
+          for keeping Bugzilla development going strong after Terry left
+          mozilla.org and for running landfill.
+
+   Dave Lawrence <dkl@redhat.com>
+          for providing insight into the key differences between Red Hat's
+          customized Bugzilla.
+
+   Dawn Endico <endico@mozilla.org>
+          for being a hacker extraordinaire and putting up with Matthew's
+          incessant questions and arguments on irc.mozilla.org in
+          #mozwebtools
+
+   Jacob Steenhagen <jake@bugzilla.org>
+          for taking over documentation during the 2.17 development
+          period.
+
+   Dave Miller <justdave@bugzilla.org>
+          for taking over as project lead when Tara stepped down and
+          continually pushing for the documentation to be the best it can
+          be.
+
+   Thanks also go to the following people for significant contributions to
+   this documentation: Kevin Brannen, Vlad Dascalu, Ben FrantzDale, Eric
+   Hanson, Zach Lipton, Gervase Markham, Andrew Pearson, Joe Robins,
+   Spencer Smith, Ron Teitelbaum, Shane Travis, Martin Wulffeld.
+
+   Also, thanks are due to the members of the mozilla.support.bugzilla
+   newsgroup (and its predecessor, netscape.public.mozilla.webtools).
+   Without your discussions, insight, suggestions, and patches, this could
+   never have happened.
+
+1.5. Document Conventions
+
+   This document uses the following conventions:
+   [Caution]
+
+   This is a caution. Make sure to read this to not be in trouble!
+   [Tip]
+
+   This is a hint or tip, especially about some configuration tweaks.
+   [Note]
+
+   This is just a note, for your information.
+   [Warning]
+
+   This is a warning, something you should take care of.
+
+   A filename or a path to a filename is displayed like this:
+   /path/to/filename.ext
+
+   A command to type in the shell is displayed like this: command
+   --arguments
+
+   bash$ represents a normal user's prompt under bash shell
+
+   bash# represents a root user's prompt under bash shell
+
+   A word which is in the glossary will appear like this: Bugzilla
+
+   A sample of code is illustrated like this:
+First Line of Code
+Second Line of Code
+...
+
+   This documentation is maintained in DocBook 4.2 XML format. Changes are
+   best submitted as plain text or XML diffs, attached to a bug filed in
+   the Bugzilla Documentation component.
+
+Chapter 2. Installing Bugzilla
+
+   Table of Contents
+
+   2.1. Installation
+
+        2.1.1. Perl
+        2.1.2. Database Engine
+        2.1.3. Web Server
+        2.1.4. Bugzilla
+        2.1.5. Perl Modules
+        2.1.6. Mail Transfer Agent (MTA)
+        2.1.7. Installing Bugzilla on mod_perl
+
+   2.2. Configuration
+
+        2.2.1. localconfig
+        2.2.2. Database Server
+        2.2.3. checksetup.pl
+        2.2.4. Web server
+        2.2.5. Bugzilla
+
+   2.3. Optional Additional Configuration
+
+        2.3.1. Bug Graphs
+        2.3.2. The Whining Cron
+        2.3.3. Whining
+        2.3.4. Serving Alternate Formats with the right MIME type
+
+   2.4. Multiple Bugzilla databases with a single installation
+   2.5. OS-Specific Installation Notes
+
+        2.5.1. Microsoft Windows
+        2.5.2. Mac OS X™
+        2.5.3. Linux Distributions
+
+   2.6. UNIX (non-root) Installation Notes
+
+        2.6.1. Introduction
+        2.6.2. MySQL
+        2.6.3. Perl
+        2.6.4. Perl Modules
+        2.6.5. HTTP Server
+        2.6.6. Bugzilla
+
+   2.7. Upgrading to New Releases
+
+        2.7.1. Before You Upgrade
+        2.7.2. Getting The New Bugzilla
+        2.7.3. Completing Your Upgrade
+        2.7.4. Automatic Notifications of New Releases
+
+2.1. Installation
+
+   [Note]
+
+   If you just want to use Bugzilla, you do not need to install it. None
+   of this chapter is relevant to you. Ask your Bugzilla administrator for
+   the URL to access it from your web browser.
+
+   The Bugzilla server software is usually installed on Linux or Solaris.
+   If you are installing on another OS, check Section 2.5, “OS-Specific
+   Installation Notes” before you start your installation to see if there
+   are any special instructions.
+
+   This guide assumes that you have administrative access to the Bugzilla
+   machine. It not possible to install and run Bugzilla itself without
+   administrative access except in the very unlikely event that every
+   single prerequisite is already installed.
+   [Warning]
+
+   The installation process may make your machine insecure for short
+   periods of time. Make sure there is a firewall between you and the
+   Internet.
+
+   You are strongly recommended to make a backup of your system before
+   installing Bugzilla (and at regular intervals thereafter :-).
+
+   In outline, the installation proceeds as follows:
+    1. Install Perl (5.8.1 or above)
+    2. Install a Database Engine
+    3. Install a Webserver
+    4. Install Bugzilla
+    5. Install Perl modules
+    6. Install a Mail Transfer Agent (Sendmail 8.7 or above, or an MTA
+       that is Sendmail-compatible with at least this version)
+    7. Configure all of the above.
+
+2.1.1. Perl
+
+   Installed Version Test:
+perl -v
+
+   Any machine that doesn't have Perl on it is a sad machine indeed. If
+   you don't have it and your OS doesn't provide official packages, visit
+   http://www.perl.org. Although Bugzilla runs with Perl 5.8.1, it's a
+   good idea to be using the latest stable version.
+
+2.1.2. Database Engine
+
+   Bugzilla supports MySQL, PostgreSQL and Oracle as database servers. You
+   only require one of these systems to make use of Bugzilla.
+
+2.1.2.1. MySQL
+
+   Installed Version Test:
+mysql -V
+
+   If you don't have it and your OS doesn't provide official packages,
+   visit http://www.mysql.com. You need MySQL version 5.0.15 or higher.
+   [Note]
+
+   Many of the binary versions of MySQL store their data files in /var. On
+   some Unix systems, this is part of a smaller root partition, and may
+   not have room for your bug database. To change the data directory, you
+   have to build MySQL from source yourself, and set it as an option to
+   configure.
+
+   If you install from something other than a packaging/installation
+   system, such as .rpm (RPM Package Manager), .deb (Debian Package), .exe
+   (Windows Executable), or .msi (Windows Installer), make sure the MySQL
+   server is started when the machine boots.
+
+2.1.2.2. PostgreSQL
+
+   Installed Version Test:
+psql -V
+
+   If you don't have it and your OS doesn't provide official packages,
+   visit http://www.postgresql.org/. You need PostgreSQL version 8.03.0000
+   or higher.
+
+   If you install from something other than a packaging/installation
+   system, such as .rpm (RPM Package Manager), .deb (Debian Package), .exe
+   (Windows Executable), or .msi (Windows Installer), make sure the
+   PostgreSQL server is started when the machine boots.
+
+2.1.2.3. Oracle
+
+   Installed Version Test:
+select * from v$version
+
+   (you first have to log in into your DB)
+
+   If you don't have it and your OS doesn't provide official packages,
+   visit http://www.oracle.com/. You need Oracle version 10.02.0 or
+   higher.
+
+   If you install from something other than a packaging/installation
+   system, such as .rpm (RPM Package Manager), .deb (Debian Package), .exe
+   (Windows Executable), or .msi (Windows Installer), make sure the Oracle
+   server is started when the machine boots.
+
+2.1.3. Web Server
+
+   Installed Version Test: view the default welcome page at
+   http://<your-machine>/
+
+   You have freedom of choice here, pretty much any web server that is
+   capable of running CGI scripts will work. However, we strongly
+   recommend using the Apache web server (either 1.3.x or 2.x), and the
+   installation instructions usually assume you are using it. If you have
+   got Bugzilla working using another web server, please share your
+   experiences with us by filing a bug in Bugzilla Documentation.
+
+   If you don't have Apache and your OS doesn't provide official packages,
+   visit http://httpd.apache.org/.
+
+2.1.4. Bugzilla
+
+   Download a Bugzilla tarball (or check it out from Bzr) and place it in
+   a suitable directory, accessible by the default web server user
+   (probably “apache” or “www”). Good locations are either directly in the
+   web server's document directories or in /usr/local with a symbolic link
+   to the web server's document directories or an alias in the web
+   server's configuration.
+   [Caution]
+
+   The default Bugzilla distribution is NOT designed to be placed in a
+   cgi-bin directory. This includes any directory which is configured
+   using the ScriptAlias directive of Apache.
+
+   Once all the files are in a web accessible directory, make that
+   directory writable by your web server's user. This is a temporary step
+   until you run the checksetup.pl script, which locks down your
+   installation.
+
+2.1.5. Perl Modules
+
+   Bugzilla's installation process is based on a script called
+   checksetup.pl. The first thing it checks is whether you have
+   appropriate versions of all the required Perl modules. The aim of this
+   section is to pass this check. When it passes, proceed to Section 2.2,
+   “Configuration”.
+
+   At this point, you need to su to root. You should remain as root until
+   the end of the install. To check you have the required modules, run:
+bash# ./checksetup.pl --check-modules
+
+   checksetup.pl will print out a list of the required and optional Perl
+   modules, together with the versions (if any) installed on your machine.
+   The list of required modules is reasonably long; however, you may
+   already have several of them installed.
+
+   The preferred way to install missing Perl modules is to use the package
+   manager provided by your operating system (e.g “rpm” or “yum” on Linux
+   distros, or “ppm” on Windows if using ActivePerl, see Section 2.5.1.2,
+   “Perl Modules on Win32”). If some Perl modules are still missing or are
+   too old, then we recommend using the install-module.pl script (doesn't
+   work with ActivePerl on Windows). If for some reason you really need to
+   install the Perl modules manually, see Appendix C, Manual Installation
+   of Perl Modules. For instance, on Unix, you invoke install-module.pl as
+   follows:
+bash# perl install-module.pl <modulename>
+
+   [Tip]
+
+   Many people complain that Perl modules will not install for them. Most
+   times, the error messages complain that they are missing a file in
+   “@INC”. Virtually every time, this error is due to permissions being
+   set too restrictively for you to compile Perl modules or not having the
+   necessary Perl development libraries installed on your system. Consult
+   your local UNIX systems administrator for help solving these
+   permissions issues; if you are the local UNIX sysadmin, please consult
+   the newsgroup/mailing list for further assistance or hire someone to
+   help you out.
+   [Note]
+
+   If you are using a package-based system, and attempting to install the
+   Perl modules from CPAN, you may need to install the "development"
+   packages for MySQL and GD before attempting to install the related Perl
+   modules. The names of these packages will vary depending on the
+   specific distribution you are using, but are often called
+   <packagename>-devel.
+
+   Here is a complete list of modules and their minimum versions. Some
+   modules have special installation notes, which follow.
+
+   Required Perl modules:
+    1. CGI (3.51)
+    2. Date::Format (2.23)
+    3. DateTime (0.28)
+    4. DateTime::TimeZone (0.71)
+    5. DBI (1.54)
+    6. DBD::mysql (4.001) if using MySQL
+    7. DBD::Pg (2.7.0) if using PostgreSQL
+    8. DBD::Oracle (1.19) if using Oracle
+    9. Digest::SHA (any)
+   10. Email::Send (2.04)
+   11. Email::MIME (1.904)
+   12. Template (2.22)
+   13. URI (1.37)
+
+   Optional Perl modules:
+    1. GD (1.20) for bug charting
+    2. Template::Plugin::GD::Image (any) for Graphical Reports
+    3. Chart::Lines (2.1) for bug charting
+    4. GD::Graph (any) for bug charting
+    5. GD::Text (any) for bug charting
+    6. XML::Twig (any) for bug import/export
+    7. MIME::Parser (5.406) for bug import/export
+    8. LWP::UserAgent (any) for Automatic Update Notifications
+    9. PatchReader (0.9.6) for pretty HTML view of patches
+   10. Net::LDAP (any) for LDAP Authentication
+   11. Authen::SASL (any) for SASL Authentication
+   12. Authen::Radius (any) for RADIUS Authentication
+   13. SOAP::Lite (0.712) for the web service interface
+   14. JSON::RPC (any) for the JSON-RPC interface
+   15. Test::Taint (any) for the web service interface
+   16. HTML::Parser (3.40) for More HTML in Product/Group Descriptions
+   17. HTML::Scrubber (any) for More HTML in Product/Group Descriptions
+   18. Email::Reply (any) for Inbound Email
+   19. TheSchwartz (any) for Mail Queueing
+   20. Daemon::Generic (any) for Mail Queueing
+   21. mod_perl2 (1.999022) for mod_perl
+
+2.1.6. Mail Transfer Agent (MTA)
+
+   Bugzilla is dependent on the availability of an e-mail system for its
+   user authentication and for other tasks.
+   [Note]
+
+   This is not entirely true. It is possible to completely disable email
+   sending, or to have Bugzilla store email messages in a file instead of
+   sending them. However, this is mainly intended for testing, as
+   disabling or diverting email on a production machine would mean that
+   users could miss important events (such as bug changes or the creation
+   of new accounts).
+
+   For more information, see the “mail_delivery_method” parameter in
+   Section 3.1, “Bugzilla Configuration”.
+
+   On Linux, any Sendmail-compatible MTA (Mail Transfer Agent) will
+   suffice. Sendmail, Postfix, qmail and Exim are examples of common MTAs.
+   Sendmail is the original Unix MTA, but the others are easier to
+   configure, and therefore many people replace Sendmail with Postfix or
+   Exim. They are drop-in replacements, so Bugzilla will not distinguish
+   between them.
+
+   If you are using Sendmail, version 8.7 or higher is required. If you
+   are using a Sendmail-compatible MTA, it must be congruent with at least
+   version 8.7 of Sendmail.
+
+   Consult the manual for the specific MTA you choose for detailed
+   installation instructions. Each of these programs will have their own
+   configuration files where you must configure certain parameters to
+   ensure that the mail is delivered properly. They are implemented as
+   services, and you should ensure that the MTA is in the auto-start list
+   of services for the machine.
+
+   If a simple mail sent with the command-line 'mail' program succeeds,
+   then Bugzilla should also be fine.
+
+2.1.7. Installing Bugzilla on mod_perl
+
+   It is now possible to run the Bugzilla software under mod_perl on
+   Apache. mod_perl has some additional requirements to that of running
+   Bugzilla under mod_cgi (the standard and previous way).
+
+   Bugzilla requires mod_perl to be installed, which can be obtained from
+   http://perl.apache.org - Bugzilla requires version 1.999022 (AKA
+   2.0.0-RC5) to be installed.
+
+2.2. Configuration
+
+   [Warning]
+
+   Poorly-configured MySQL and Bugzilla installations have given attackers
+   full access to systems in the past. Please take the security parts of
+   these guidelines seriously, even for Bugzilla machines hidden away
+   behind your firewall. Be certain to read Chapter 4, Bugzilla Security
+   for some important security tips.
+
+2.2.1. localconfig
+
+   You should now run checksetup.pl again, this time without the
+   --check-modules switch.
+bash# ./checksetup.pl
+
+   This time, checksetup.pl should tell you that all the correct modules
+   are installed and will display a message about, and write out a file
+   called, localconfig. This file contains the default settings for a
+   number of Bugzilla parameters.
+
+   Load this file in your editor. The only two values you need to change
+   are $db_driver and $db_pass, respectively the type of the database and
+   the password for the user you will create for your database. Pick a
+   strong password (for simplicity, it should not contain single quote
+   characters) and put it here. $db_driver can be either 'mysql', 'Pg',
+   'Oracle' or 'Sqlite'.
+   [Note]
+
+   In Oracle, $db_name should actually be the SID name of your database
+   (e.g. "XE" if you are using Oracle XE).
+
+   You may need to change the value of webservergroup if your web server
+   does not run in the "apache" group. On Debian, for example, Apache runs
+   in the "www-data" group. If you are going to run Bugzilla on a machine
+   where you do not have root access (such as on a shared web hosting
+   account), you will need to leave webservergroup empty, ignoring the
+   warnings that checksetup.pl will subsequently display every time it is
+   run.
+   [Caution]
+
+   If you are using suexec, you should use your own primary group for
+   webservergroup rather than leaving it empty, and see the additional
+   directions in the suexec section Section 2.6.6.1, “suexec or shared
+   hosting”.
+
+   The other options in the localconfig file are documented by their
+   accompanying comments. If you have a slightly non-standard database
+   setup, you may wish to change one or more of the other "$db_*"
+   parameters.
+
+2.2.2. Database Server
+
+   This section deals with configuring your database server for use with
+   Bugzilla. Currently, MySQL (Section 2.2.2.2, “MySQL”), PostgreSQL
+   (Section 2.2.2.3, “PostgreSQL”), Oracle (Section 2.2.2.4, “Oracle”) and
+   SQLite (Section 2.2.2.5, “SQLite”) are available.
+
+2.2.2.1. Bugzilla Database Schema
+
+   The Bugzilla database schema is available at Ravenbrook. This very
+   valuable tool can generate a written description of the Bugzilla
+   database schema for any version of Bugzilla. It can also generate a
+   diff between two versions to help someone see what has changed.
+
+2.2.2.2. MySQL
+
+   [Caution]
+
+   MySQL's default configuration is insecure. We highly recommend to run
+   mysql_secure_installation on Linux or the MySQL installer on Windows,
+   and follow the instructions. Important points to note are:
+    1. Be sure that the root account has a secure password set.
+    2. Do not create an anonymous account, and if it exists, say "yes" to
+       remove it.
+    3. If your web server and MySQL server are on the same machine, you
+       should disable the network access.
+
+2.2.2.2.1. Allow large attachments and many comments
+
+   By default, MySQL will only allow you to insert things into the
+   database that are smaller than 1MB. Attachments may be larger than
+   this. Also, Bugzilla combines all comments on a single bug into one
+   field for full-text searching, and the combination of all comments on a
+   single bug could in some cases be larger than 1MB.
+
+   To change MySQL's default, you need to edit your MySQL configuration
+   file, which is usually /etc/my.cnf on Linux. We recommend that you
+   allow at least 4MB packets by adding the "max_allowed_packet" parameter
+   to your MySQL configuration in the "[mysqld]" section, like this:
+[mysqld]
+# Allow packets up to 4MB
+max_allowed_packet=4M
+
+2.2.2.2.2. Allow small words in full-text indexes
+
+   By default, words must be at least four characters in length in order
+   to be indexed by MySQL's full-text indexes. This causes a lot of
+   Bugzilla specific words to be missed, including "cc", "ftp" and "uri".
+
+   MySQL can be configured to index those words by setting the
+   ft_min_word_len param to the minimum size of the words to index. This
+   can be done by modifying the /etc/my.cnf according to the example
+   below:
+[mysqld]
+# Allow small words in full-text indexes
+ft_min_word_len=2
+
+   Rebuilding the indexes can be done based on documentation found at
+   http://www.mysql.com/doc/en/Fulltext_Fine-tuning.html.
+
+2.2.2.2.3. Add a user to MySQL
+
+   You need to add a new MySQL user for Bugzilla to use. (It's not safe to
+   have Bugzilla use the MySQL root account.) The following instructions
+   assume the defaults in localconfig; if you changed those, you need to
+   modify the SQL command appropriately. You will need the $db_pass
+   password you set in localconfig in Section 2.2.1, “localconfig”.
+
+   We use an SQL GRANT command to create a “bugs” user. This also
+   restricts the “bugs”user to operations within a database called “bugs”,
+   and only allows the account to connect from “localhost”. Modify it to
+   reflect your setup if you will be connecting from another machine or as
+   a different user.
+
+   Run the mysql command-line client and enter:
+mysql> GRANT SELECT, INSERT,
+       UPDATE, DELETE, INDEX, ALTER, CREATE, LOCK TABLES,
+       CREATE TEMPORARY TABLES, DROP, REFERENCES ON bugs.*
+       TO bugs@localhost IDENTIFIED BY '$db_pass';
+mysql> FLUSH PRIVILEGES;
+
+2.2.2.2.4. Permit attachments table to grow beyond 4GB
+
+   By default, MySQL will limit the size of a table to 4GB. This limit is
+   present even if the underlying filesystem has no such limit. To set a
+   higher limit, follow these instructions.
+
+   After you have completed the rest of the installation (or at least the
+   database setup parts), you should run the MySQL command-line client and
+   enter the following, replacing $bugs_db with your Bugzilla database
+   name (bugs by default):
+mysql> use $bugs_db
+mysql> ALTER TABLE attachments
+           AVG_ROW_LENGTH=1000000, MAX_ROWS=20000;
+
+   The above command will change the limit to 20GB. Mysql will have to
+   make a temporary copy of your entire table to do this. Ideally, you
+   should do this when your attachments table is still small.
+   [Note]
+
+   This does not affect Big Files, attachments that are stored directly on
+   disk instead of in the database.
+
+2.2.2.3. PostgreSQL
+
+2.2.2.3.1. Add a User to PostgreSQL
+
+   You need to add a new user to PostgreSQL for the Bugzilla application
+   to use when accessing the database. The following instructions assume
+   the defaults in localconfig; if you changed those, you need to modify
+   the commands appropriately. You will need the $db_pass password you set
+   in localconfig in Section 2.2.1, “localconfig”.
+
+   On most systems, to create the user in PostgreSQL, you will need to
+   login as the root user, and then
+bash# su - postgres
+
+   As the postgres user, you then need to create a new user:
+bash$ createuser -U postgres -dRSP bugs
+
+   When asked for a password, provide the password which will be set as
+   $db_pass in localconfig. The created user will not be a superuser (-S)
+   and will not be able to create new users (-R). He will only have the
+   ability to create databases (-d).
+
+2.2.2.3.2. Configure PostgreSQL
+
+   Now, you will need to edit pg_hba.conf which is usually located in
+   /var/lib/pgsql/data/. In this file, you will need to add a new line to
+   it as follows:
+
+   host all bugs 127.0.0.1 255.255.255.255 md5
+
+   This means that for TCP/IP (host) connections, allow connections from
+   '127.0.0.1' to 'all' databases on this server from the 'bugs' user, and
+   use password authentication (md5) for that user.
+
+   Now, you will need to restart PostgreSQL, but you will need to fully
+   stop and start the server rather than just restarting due to the
+   possibility of a change to postgresql.conf. After the server has
+   restarted, you will need to edit localconfig, finding the $db_driver
+   variable and setting it to Pg and changing the password in $db_pass to
+   the one you picked previously, while setting up the account.
+
+2.2.2.4. Oracle
+
+2.2.2.4.1. Create a New Tablespace
+
+   You can use the existing tablespace or create a new one for Bugzilla.
+   To create a new tablespace, run the following command:
+CREATE TABLESPACE bugs
+DATAFILE '$path_to_datafile' SIZE 500M
+AUTOEXTEND ON NEXT 30M MAXSIZE UNLIMITED
+
+   Here, the name of the tablespace is 'bugs', but you can choose another
+   name. $path_to_datafile is the path to the file containing your
+   database, for instance /u01/oradata/bugzilla.dbf. The initial size of
+   the database file is set in this example to 500 Mb, with an increment
+   of 30 Mb everytime we reach the size limit of the file.
+
+2.2.2.4.2. Add a User to Oracle
+
+   The user name and password must match what you set in localconfig
+   ($db_user and $db_pass, respectively). Here, we assume that the user
+   name is 'bugs' and the tablespace name is the same as above.
+CREATE USER bugs
+IDENTIFIED BY "$db_pass"
+DEFAULT TABLESPACE bugs
+TEMPORARY TABLESPACE TEMP
+PROFILE DEFAULT;
+-- GRANT/REVOKE ROLE PRIVILEGES
+GRANT CONNECT TO bugs;
+GRANT RESOURCE TO bugs;
+-- GRANT/REVOKE SYSTEM PRIVILEGES
+GRANT UNLIMITED TABLESPACE TO bugs;
+GRANT EXECUTE ON CTXSYS.CTX_DDL TO bugs;
+
+2.2.2.4.3. Configure the Web Server
+
+   If you use Apache, append these lines to httpd.conf to set ORACLE_HOME
+   and LD_LIBRARY_PATH. For instance:
+SetEnv ORACLE_HOME /u01/app/oracle/product/10.2.0/
+SetEnv LD_LIBRARY_PATH /u01/app/oracle/product/10.2.0/lib/
+
+   When this is done, restart your web server.
+
+2.2.2.5. SQLite
+
+   [Caution]
+
+   Due to SQLite's concurrency limitations we recommend SQLite only for
+   small and development Bugzilla installations.
+
+   No special configuration is required to run Bugzilla on SQLite. The
+   database will be stored in data/db/$db_name, where $db_name is the
+   database name defined in localconfig.
+
+2.2.3. checksetup.pl
+
+   Next, rerun checksetup.pl. It reconfirms that all the modules are
+   present, and notices the altered localconfig file, which it assumes you
+   have edited to your satisfaction. It compiles the UI templates,
+   connects to the database using the 'bugs' user you created and the
+   password you defined, and creates the 'bugs' database and the tables
+   therein.
+
+   After that, it asks for details of an administrator account. Bugzilla
+   can have multiple administrators - you can create more later - but it
+   needs one to start off with. Enter the email address of an
+   administrator, his or her full name, and a suitable Bugzilla password.
+
+   checksetup.pl will then finish. You may rerun checksetup.pl at any time
+   if you wish.
+
+2.2.4. Web server
+
+   Configure your web server according to the instructions in the
+   appropriate section. (If it makes a difference in your choice, the
+   Bugzilla Team recommends Apache.) To check whether your web server is
+   correctly configured, try to access testagent.cgi from your web server.
+   If "OK" is displayed, then your configuration is successful. Regardless
+   of which web server you are using, however, ensure that sensitive
+   information is not remotely available by properly applying the access
+   controls in Section 4.2.1, “Disabling Remote Access to Bugzilla
+   Configuration Files”. You can run testserver.pl to check if your web
+   server serves Bugzilla files as expected.
+
+2.2.4.1. Bugzilla using Apache
+
+   You have two options for running Bugzilla under Apache - mod_cgi (the
+   default) and mod_perl (new in Bugzilla 2.23)
+
+2.2.4.1.1. Apache httpd™ with mod_cgi
+
+   To configure your Apache web server to work with Bugzilla while using
+   mod_cgi, do the following:
+    1. Load httpd.conf in your editor. In Fedora and Red Hat Linux, this
+       file is found in /etc/httpd/conf.
+    2. Apache uses <Directory> directives to permit fine-grained
+       permission setting. Add the following lines to a directive that
+       applies to the location of your Bugzilla installation. (If such a
+       section does not exist, you'll want to add one.) In this example,
+       Bugzilla has been installed at /var/www/html/bugzilla.
+<Directory /var/www/html/bugzilla>
+AddHandler cgi-script .cgi
+Options +ExecCGI
+DirectoryIndex index.cgi index.html
+AllowOverride Limit FileInfo Indexes Options
+</Directory>
+
+       These instructions: allow apache to run .cgi files found within the
+       bugzilla directory; instructs the server to look for a file called
+       index.cgi or, if not found, index.html if someone only types the
+       directory name into the browser; and allows Bugzilla's .htaccess
+       files to override some global permissions.
+
+       [Note]
+   It is possible to make these changes globally, or to the directive
+   controlling Bugzilla's parent directory (e.g. <Directory
+   /var/www/html/>). Such changes would also apply to the Bugzilla
+   directory... but they would also apply to many other places where they
+   may or may not be appropriate. In most cases, including this one, it is
+   better to be as restrictive as possible when granting extra access.
+
+       [Note]
+   On Windows, you may have to also add the ScriptInterpreterSource
+   Registry-Strict line, see Windows specific notes.
+    3. checksetup.pl can set tighter permissions on Bugzilla's files and
+       directories if it knows what group the web server runs as. Find the
+       Group line in httpd.conf, place the value found there in the
+       $webservergroup variable in localconfig, then rerun checksetup.pl.
+    4. Optional: If Bugzilla does not actually reside in the webspace
+       directory, but instead has been symbolically linked there, you will
+       need to add the following to the Options line of the Bugzilla
+       <Directory> directive (the same one as in the step above):
++FollowSymLinks
+       Without this directive, Apache will not follow symbolic links to
+       places outside its own directory structure, and you will be unable
+       to run Bugzilla.
+
+2.2.4.1.2. Apache httpd™ with mod_perl
+
+   Some configuration is required to make Bugzilla work with Apache and
+   mod_perl
+    1. Load httpd.conf in your editor. In Fedora and Red Hat Linux, this
+       file is found in /etc/httpd/conf.
+    2. Add the following information to your httpd.conf file, substituting
+       where appropriate with your own local paths.
+
+       [Note]
+   This should be used instead of the <Directory> block shown above. This
+   should also be above any other mod_perl directives within the
+   httpd.conf and must be specified in the order as below.
+
+   [Warning]
+   You should also ensure that you have disabled KeepAlive support in your
+   Apache install when utilizing Bugzilla under mod_perl
+PerlSwitches -w -T
+PerlConfigRequire /var/www/html/bugzilla/mod_perl.pl
+
+    3. checksetup.pl can set tighter permissions on Bugzilla's files and
+       directories if it knows what group the web server runs as. Find the
+       Group line in httpd.conf, place the value found there in the
+       $webservergroup variable in localconfig, then rerun checksetup.pl.
+
+   On restarting Apache, Bugzilla should now be running within the
+   mod_perl environment. Please ensure you have run checksetup.pl to set
+   permissions before you restart Apache.
+   [Note]
+
+   Please bear the following points in mind when looking at using Bugzilla
+   under mod_perl:
+     * mod_perl support in Bugzilla can take up a HUGE amount of RAM. You
+       could be looking at 30MB per httpd child, easily. Basically, you
+       just need a lot of RAM. The more RAM you can get, the better.
+       mod_perl is basically trading RAM for speed. At least 2GB total
+       system RAM is recommended for running Bugzilla under mod_perl.
+     * Under mod_perl, you have to restart Apache if you make any manual
+       change to any Bugzilla file. You can't just reload--you have to
+       actually restart the server (as in make sure it stops and starts
+       again). You can change localconfig and the params file manually, if
+       you want, because those are re-read every time you load a page.
+     * You must run in Apache's Prefork MPM (this is the default). The
+       Worker MPM may not work--we haven't tested Bugzilla's mod_perl
+       support under threads. (And, in fact, we're fairly sure it won't
+       work.)
+     * Bugzilla generally expects to be the only mod_perl application
+       running on your entire server. It may or may not work if there are
+       other applications also running under mod_perl. It does try its
+       best to play nice with other mod_perl applications, but it still
+       may have conflicts.
+     * It is recommended that you have one Bugzilla instance running under
+       mod_perl on your server. Bugzilla has not been tested with more
+       than one instance running.
+
+2.2.4.2. Microsoft Internet Information Services™
+
+   If you are running Bugzilla on Windows and choose to use Microsoft's
+   Internet Information Services™ or Personal Web Server™ you will need to
+   perform a number of other configuration steps as explained below. You
+   may also want to refer to the following Microsoft Knowledge Base
+   articles: 245225 “HOW TO: Configure and Test a PERL Script with IIS
+   4.0, 5.0, and 5.1” (for Internet Information Services™) and 231998 “HOW
+   TO: FP2000: How to Use Perl with Microsoft Personal Web Server on
+   Windows 95/98” (for Personal Web Server™).
+
+   You will need to create a virtual directory for the Bugzilla install.
+   Put the Bugzilla files in a directory that is named something other
+   than what you want your end-users accessing. That is, if you want your
+   users to access your Bugzilla installation through
+   “http://<yourdomainname>/Bugzilla”, then do not put your Bugzilla files
+   in a directory named “Bugzilla”. Instead, place them in a different
+   location, and then use the IIS Administration tool to create a Virtual
+   Directory named "Bugzilla" that acts as an alias for the actual
+   location of the files. When creating that virtual directory, make sure
+   you add the “Execute (such as ISAPI applications or CGI)” access
+   permission.
+
+   You will also need to tell IIS how to handle Bugzilla's .cgi files.
+   Using the IIS Administration tool again, open up the properties for the
+   new virtual directory and select the Configuration option to access the
+   Script Mappings. Create an entry mapping .cgi to:
+<full path to perl.exe >\perl.exe -x<full path to Bugzilla> -wT "%s" %s
+
+   For example:
+c:\perl\bin\perl.exe -xc:\bugzilla -wT "%s" %s
+
+   [Note]
+
+   The ActiveState install may have already created an entry for .pl files
+   that is limited to “GET,HEAD,POST”. If so, this mapping should be
+   removed as Bugzilla's .pl files are not designed to be run via a web
+   server.
+
+   IIS will also need to know that the index.cgi should be treated as a
+   default document. On the Documents tab page of the virtual directory
+   properties, you need to add index.cgi as a default document type. If
+   you wish, you may remove the other default document types for this
+   particular virtual directory, since Bugzilla doesn't use any of them.
+
+   Also, and this can't be stressed enough, make sure that files such as
+   localconfig and your data directory are secured as described in
+   Section 4.2.1, “Disabling Remote Access to Bugzilla Configuration
+   Files”.
+
+2.2.5. Bugzilla
+
+   Your Bugzilla should now be working. Access
+   http://<your-bugzilla-server>/ - you should see the Bugzilla front
+   page. If not, consult the Troubleshooting section, Appendix A,
+   Troubleshooting.
+   [Note]
+
+   The URL above may be incorrect if you installed Bugzilla into a
+   subdirectory or used a symbolic link from your web site root to the
+   Bugzilla directory.
+
+   Log in with the administrator account you defined in the last
+   checksetup.pl run. You should go through the Parameters page and see if
+   there are any you wish to change. They key parameters are documented in
+   Section 3.1, “Bugzilla Configuration”; you should certainly alter
+   maintainer and urlbase; you may also want to alter cookiepath or
+   requirelogin.
+
+   Bugzilla has several optional features which require extra
+   configuration. You can read about those in Section 2.3, “Optional
+   Additional Configuration”.
+
+2.3. Optional Additional Configuration
+
+   Bugzilla has a number of optional features. This section describes how
+   to configure or enable them.
+
+2.3.1. Bug Graphs
+
+   If you have installed the necessary Perl modules you can start
+   collecting statistics for the nifty Bugzilla graphs.
+bash# crontab -e
+
+   This should bring up the crontab file in your editor. Add a cron entry
+   like this to run collectstats.pl daily at 5 after midnight:
+5 0 * * * cd <your-bugzilla-directory> && ./collectstats.pl
+
+   After two days have passed you'll be able to view bug graphs from the
+   Reports page.
+   [Note]
+
+   Windows does not have 'cron', but it does have the Task Scheduler,
+   which performs the same duties. There are also third-party tools that
+   can be used to implement cron, such as nncron.
+
+2.3.2. The Whining Cron
+
+   What good are bugs if they're not annoying? To help make them more so
+   you can set up Bugzilla's automatic whining system to complain at
+   engineers which leave their bugs in the CONFIRMED state without
+   triaging them.
+
+   This can be done by adding the following command as a daily crontab
+   entry, in the same manner as explained above for bug graphs. This
+   example runs it at 12.55am.
+55 0 * * * cd <your-bugzilla-directory> && ./whineatnews.pl
+
+   [Note]
+
+   Windows does not have 'cron', but it does have the Task Scheduler,
+   which performs the same duties. There are also third-party tools that
+   can be used to implement cron, such as nncron.
+
+2.3.3. Whining
+
+   As of Bugzilla 2.20, users can configure Bugzilla to regularly annoy
+   them at regular intervals, by having Bugzilla execute saved searches at
+   certain times and emailing the results to the user. This is known as
+   "Whining". The process of configuring Whining is described in
+   Section 5.13, “Whining”, but for it to work a Perl script must be
+   executed at regular intervals.
+
+   This can be done by adding the following command as a daily crontab
+   entry, in the same manner as explained above for bug graphs. This
+   example runs it every 15 minutes.
+*/15 * * * * cd <your-bugzilla-directory> && ./whine.pl
+
+   [Note]
+
+   Whines can be executed as often as every 15 minutes, so if you specify
+   longer intervals between executions of whine.pl, some users may not be
+   whined at as often as they would expect. Depending on the person, this
+   can either be a very Good Thing or a very Bad Thing.
+   [Note]
+
+   Windows does not have 'cron', but it does have the Task Scheduler,
+   which performs the same duties. There are also third-party tools that
+   can be used to implement cron, such as nncron.
+
+2.3.4. Serving Alternate Formats with the right MIME type
+
+   Some Bugzilla pages have alternate formats, other than just plain HTML.
+   In particular, a few Bugzilla pages can output their contents as either
+   XUL (a special Mozilla format, that looks like a program GUI) or RDF (a
+   type of structured XML that can be read by various programs).
+
+   In order for your users to see these pages correctly, Apache must send
+   them with the right MIME type. To do this, add the following lines to
+   your Apache configuration, either in the <VirtualHost> section for your
+   Bugzilla, or in the <Directory> section for your Bugzilla:
+
+AddType application/vnd.mozilla.xul+xml .xul
+AddType application/rdf+xml .rdf
+
+2.4. Multiple Bugzilla databases with a single installation
+
+   The previous instructions referred to a standard installation, with one
+   unique Bugzilla database. However, you may want to host several
+   distinct installations, without having several copies of the code. This
+   is possible by using the PROJECT environment variable. When accessed,
+   Bugzilla checks for the existence of this variable, and if present,
+   uses its value to check for an alternative configuration file named
+   localconfig.<PROJECT> in the same location as the default one
+   (localconfig). It also checks for customized templates in a directory
+   named <PROJECT> in the same location as the default one
+   (template/<langcode>). By default this is template/en/default so
+   PROJECT's templates would be located at template/en/PROJECT.
+
+   To set up an alternate installation, just export PROJECT=foo before
+   running checksetup.pl for the first time. It will result in a file
+   called localconfig.foo instead of localconfig. Edit this file as
+   described above, with reference to a new database, and re-run
+   checksetup.pl to populate it. That's all.
+
+   Now you have to configure the web server to pass this environment
+   variable when accessed via an alternate URL, such as virtual host for
+   instance. The following is an example of how you could do it in Apache,
+   other Webservers may differ.
+<VirtualHost 212.85.153.228:80>
+    ServerName foo.bar.baz
+    SetEnv PROJECT foo
+    Alias /bugzilla /var/www/bugzilla
+</VirtualHost>
+
+   Don't forget to also export this variable before accessing Bugzilla by
+   other means, such as cron tasks for instance.
+
+2.5. OS-Specific Installation Notes
+
+   Many aspects of the Bugzilla installation can be affected by the
+   operating system you choose to install it on. Sometimes it can be made
+   easier and others more difficult. This section will attempt to help you
+   understand both the difficulties of running on specific operating
+   systems and the utilities available to make it easier.
+
+   If you have anything to add or notes for an operating system not
+   covered, please file a bug in Bugzilla Documentation.
+
+2.5.1. Microsoft Windows
+
+   Making Bugzilla work on Windows is more difficult than making it work
+   on Unix. For that reason, we still recommend doing so on a Unix based
+   system such as GNU/Linux. That said, if you do want to get Bugzilla
+   running on Windows, you will need to make the following adjustments. A
+   detailed step-by-step installation guide for Windows is also available
+   if you need more help with your installation.
+
+2.5.1.1. Win32 Perl
+
+   Perl for Windows can be obtained from ActiveState. You should be able
+   to find a compiled binary at
+   http://aspn.activestate.com/ASPN/Downloads/ActivePerl/. The following
+   instructions assume that you are using version 5.8.1 of ActiveState.
+   [Note]
+
+   These instructions are for 32-bit versions of Windows. If you are using
+   a 64-bit version of Windows, you will need to install 32-bit Perl in
+   order to install the 32-bit modules as described below.
+
+2.5.1.2. Perl Modules on Win32
+
+   Bugzilla on Windows requires the same perl modules found in
+   Section 2.1.5, “Perl Modules”. The main difference is that windows uses
+   PPM instead of CPAN. ActiveState provides a GUI to manage Perl modules.
+   We highly recommend that you use it. If you prefer to use ppm from the
+   command-line, type:
+C:\perl> ppm install <module name>
+
+   [Note]
+
+   The PPM repository stores modules in 'packages' that may have a
+   slightly different name than the module. If retrieving these modules
+   from there, you will need to pay attention to the information provided
+   when you run checksetup.pl as it will tell you what package you'll need
+   to install.
+   [Tip]
+
+   If you are behind a corporate firewall, you will need to let the
+   ActiveState PPM utility know how to get through it to access the
+   repositories by setting the HTTP_proxy system environmental variable.
+   For more information on setting that variable, see the ActiveState
+   documentation.
+
+2.5.1.3. Serving the web pages
+
+   As is the case on Unix based systems, any web server should be able to
+   handle Bugzilla; however, the Bugzilla Team still recommends Apache
+   whenever asked. No matter what web server you choose, be sure to pay
+   attention to the security notes in Section 4.2.1, “Disabling Remote
+   Access to Bugzilla Configuration Files”. More information on
+   configuring specific web servers can be found in Section 2.2.4, “Web
+   server”.
+   [Note]
+
+   The web server looks at /usr/bin/perl to call Perl. If you are using
+   Apache on windows, you can set the ScriptInterpreterSource directive in
+   your Apache config file to make it look at the right place: insert the
+   line
+ScriptInterpreterSource Registry-Strict
+
+   into your httpd.conf file, and create the key
+HKEY_CLASSES_ROOT\.cgi\Shell\ExecCGI\Command
+
+   with C:\Perl\bin\perl.exe -T as value (adapt to your path if needed) in
+   the registry. When this is done, restart Apache.
+
+2.5.1.4. Sending Email
+
+   To enable Bugzilla to send email on Windows, the server running the
+   Bugzilla code must be able to connect to, or act as, an SMTP server.
+
+2.5.2. Mac OS X™
+
+   Making Bugzilla work on Mac OS X requires the following adjustments.
+
+2.5.2.1. Sendmail
+
+   In Mac OS X 10.3 and later, Postfix is used as the built-in email
+   server. Postfix provides an executable that mimics sendmail enough to
+   fool Bugzilla, as long as Bugzilla can find it. Bugzilla is able to
+   find the fake sendmail executable without any assistance.
+
+2.5.2.2. Libraries & Perl Modules on Mac OS X
+
+   Apple does not include the GD library with Mac OS X. Bugzilla needs
+   this for bug graphs.
+
+   You can use MacPorts (http://www.macports.org/) or Fink
+   (http://sourceforge.net/projects/fink/), both of which are similar in
+   nature to the CPAN installer, but install common unix programs.
+
+   Follow the instructions for setting up MacPorts or Fink. Once you have
+   one installed, you'll want to use it to install the gd2 package.
+
+   Fink will prompt you for a number of dependencies, type 'y' and hit
+   enter to install all of the dependencies and then watch it work. You
+   will then be able to use CPAN to install the GD Perl module.
+   [Note]
+
+   To prevent creating conflicts with the software that Apple installs by
+   default, Fink creates its own directory tree at /sw where it installs
+   most of the software that it installs. This means your libraries and
+   headers will be at /sw/lib and /sw/include instead of /usr/lib and
+   /usr/include. When the Perl module config script asks where your libgd
+   is, be sure to tell it /sw/lib.
+
+   Also available via MacPorts and Fink is expat. After installing the
+   expat package, you will be able to install XML::Parser using CPAN. If
+   you use fink, there is one caveat. Unlike recent versions of the GD
+   module, XML::Parser doesn't prompt for the location of the required
+   libraries. When using CPAN, you will need to use the following command
+   sequence:
+# perl -MCPAN -e'look XML::Parser'
+# perl Makefile.PL EXPATLIBPATH=/sw/lib EXPATINCPATH=/sw/include
+# make; make test; make install
+# exit
+
+   The look command will download the module and spawn a new shell with
+   the extracted files as the current working directory.
+
+   You should watch the output from these make commands, especially “make
+   test” as errors may prevent XML::Parser from functioning correctly with
+   Bugzilla.
+
+   The exit command will return you to your original shell.
+
+2.5.3. Linux Distributions
+
+   Many Linux distributions include Bugzilla and its dependencies in their
+   native package management systems. Installing Bugzilla with root access
+   on any Linux system should be as simple as finding the Bugzilla package
+   in the package management application and installing it using the
+   normal command syntax. Several distributions also perform the proper
+   web server configuration automatically on installation.
+
+   Please consult the documentation of your Linux distribution for
+   instructions on how to install packages, or for specific instructions
+   on installing Bugzilla with native package management tools. There is
+   also a Bugzilla Wiki Page for distro-specific installation notes.
+
+2.6. UNIX (non-root) Installation Notes
+
+2.6.1. Introduction
+
+   If you are running a *NIX OS as non-root, either due to lack of access
+   (web hosts, for example) or for security reasons, this will detail how
+   to install Bugzilla on such a setup. It is recommended that you read
+   through the Section 2.1, “Installation” first to get an idea on the
+   installation steps required. (These notes will reference to steps in
+   that guide.)
+
+2.6.2. MySQL
+
+   You may have MySQL installed as root. If you're setting up an account
+   with a web host, a MySQL account needs to be set up for you. From
+   there, you can create the bugs account, or use the account given to
+   you.
+   [Warning]
+
+   You may have problems trying to set up GRANT permissions to the
+   database. If you're using a web host, chances are that you have a
+   separate database which is already locked down (or one big database
+   with limited/no access to the other areas), but you may want to ask
+   your system administrator what the security settings are set to, and/or
+   run the GRANT command for you.
+
+   Also, you will probably not be able to change the MySQL root user
+   password (for obvious reasons), so skip that step.
+
+2.6.2.1. Running MySQL as Non-Root
+
+2.6.2.1.1. The Custom Configuration Method
+
+   Create a file .my.cnf in your home directory (using /home/foo in this
+   example) as follows....
+[mysqld]
+datadir=/home/foo/mymysql
+socket=/home/foo/mymysql/thesock
+port=8081
+
+[mysql]
+socket=/home/foo/mymysql/thesock
+port=8081
+
+[mysql.server]
+user=mysql
+basedir=/var/lib
+
+[safe_mysqld]
+err-log=/home/foo/mymysql/the.log
+pid-file=/home/foo/mymysql/the.pid
+
+2.6.2.1.2. The Custom Built Method
+
+   You can install MySQL as a not-root, if you really need to. Build it
+   with PREFIX set to /home/foo/mysql, or use pre-installed executables,
+   specifying that you want to put all of the data files in
+   /home/foo/mysql/data. If there is another MySQL server running on the
+   system that you do not own, use the -P option to specify a TCP port
+   that is not in use.
+
+2.6.2.1.3. Starting the Server
+
+   After your mysqld program is built and any .my.cnf file is in place,
+   you must initialize the databases (ONCE).
+bash$ mysql_install_db
+
+   Then start the daemon with
+bash$ safe_mysql &
+
+   After you start mysqld the first time, you then connect to it as "root"
+   and GRANT permissions to other users. (Again, the MySQL root account
+   has nothing to do with the *NIX root account.)
+   [Note]
+
+   You will need to start the daemons yourself. You can either ask your
+   system administrator to add them to system startup files, or add a
+   crontab entry that runs a script to check on these daemons and restart
+   them if needed.
+   [Warning]
+
+   Do NOT run daemons or other services on a server without first
+   consulting your system administrator! Daemons use up system resources
+   and running one may be in violation of your terms of service for any
+   machine on which you are a user!
+
+2.6.3. Perl
+
+   On the extremely rare chance that you don't have Perl on the machine,
+   you will have to build the sources yourself. The following commands
+   should get your system installed with your own personal version of
+   Perl:
+bash$ wget http://perl.org/CPAN/src/stable.tar.gz
+bash$ tar zvxf stable.tar.gz
+bash$ cd perl-5.8.1
+bash$ sh Configure -de -Dprefix=/home/foo/perl
+bash$ make && make test && make install
+
+   Once you have Perl installed into a directory (probably in ~/perl/bin),
+   you will need to install the Perl Modules, described below.
+
+2.6.4. Perl Modules
+
+   Installing the Perl modules as a non-root user is accomplished by
+   running the install-module.pl script. For more details on this script,
+   see install-module.pl documentation
+
+2.6.5. HTTP Server
+
+   Ideally, this also needs to be installed as root and run under a
+   special web server account. As long as the web server will allow the
+   running of *.cgi files outside of a cgi-bin, and a way of denying web
+   access to certain files (such as a .htaccess file), you should be good
+   in this department.
+
+2.6.5.1. Running Apache as Non-Root
+
+   You can run Apache as a non-root user, but the port will need to be set
+   to one above 1024. If you type httpd -V, you will get a list of the
+   variables that your system copy of httpd uses. One of those, namely
+   HTTPD_ROOT, tells you where that installation looks for its config
+   information.
+
+   From there, you can copy the config files to your own home directory to
+   start editing. When you edit those and then use the -d option to
+   override the HTTPD_ROOT compiled into the web server, you get control
+   of your own customized web server.
+   [Note]
+
+   You will need to start the daemons yourself. You can either ask your
+   system administrator to add them to system startup files, or add a
+   crontab entry that runs a script to check on these daemons and restart
+   them if needed.
+   [Warning]
+
+   Do NOT run daemons or other services on a server without first
+   consulting your system administrator! Daemons use up system resources
+   and running one may be in violation of your terms of service for any
+   machine on which you are a user!
+
+2.6.6. Bugzilla
+
+   When you run ./checksetup.pl to create the localconfig file, it will
+   list the Perl modules it finds. If one is missing, go back and
+   double-check the module installation from Section 2.6.4, “Perl
+   Modules”, then delete the localconfig file and try again.
+   [Warning]
+
+   One option in localconfig you might have problems with is the web
+   server group. If you can't successfully browse to the index.cgi (like a
+   Forbidden error), you may have to relax your permissions, and blank out
+   the web server group. Of course, this may pose as a security risk.
+   Having a properly jailed shell and/or limited access to shell accounts
+   may lessen the security risk, but use at your own risk.
+
+2.6.6.1. suexec or shared hosting
+
+   If you are running on a system that uses suexec (most shared hosting
+   environments do this), you will need to set the webservergroup value in
+   localconfig to match your primary group, rather than the one the web
+   server runs under. You will need to run the following shell commands
+   after running ./checksetup.pl, every time you run it (or modify
+   checksetup.pl to do them for you via the system() command).
+for i in docs graphs images js skins; do find $i -type d -exec chmod o+rx {} \;
+ ; done
+for i in jpg gif css js png html rdf xul; do find . -name \*.$i -exec chmod o+r
+ {} \; ; done
+find . -name .htaccess -exec chmod o+r {} \;
+chmod o+x . data data/webdot
+
+   Pay particular attention to the number of semicolons and dots. They are
+   all important. A future version of Bugzilla will hopefully be able to
+   do this for you out of the box.
+
+2.7. Upgrading to New Releases
+
+   Upgrading to new Bugzilla releases is very simple. There is a script
+   named checksetup.pl included with Bugzilla that will automatically do
+   all of the database migration for you.
+
+   The following sections explain how to upgrade from one version of
+   Bugzilla to another. Whether you are upgrading from one bug-fix version
+   to another (such as 4.2 to 4.2.1) or from one major version to another
+   (such as from 4.0 to 4.2), the instructions are always the same.
+   [Note]
+
+   Any examples in the following sections are written as though the user
+   were updating to version 4.2.1, but the procedures are the same no
+   matter what version you're updating to. Also, in the examples, the
+   user's Bugzilla installation is found at /var/www/html/bugzilla. If
+   that is not the same as the location of your Bugzilla installation,
+   simply substitute the proper paths where appropriate.
+
+2.7.1. Before You Upgrade
+
+   Before you start your upgrade, there are a few important steps to take:
+    1. Read the Release Notes of the version you're upgrading to,
+       particularly the "Notes for Upgraders" section.
+    2. View the Sanity Check (Section 3.16, “Checking and Maintaining
+       Database Integrity”) page on your installation before upgrading.
+       Attempt to fix all warnings that the page produces before you go
+       any further, or you may experience problems during your upgrade.
+    3. Shut down your Bugzilla installation by putting some HTML or text
+       in the shutdownhtml parameter (see Section 3.1, “Bugzilla
+       Configuration”).
+    4. Make a backup of the Bugzilla database. THIS IS VERY IMPORTANT. If
+       anything goes wrong during the upgrade, your installation can be
+       corrupted beyond recovery. Having a backup keeps you safe.
+
+       [Warning]
+   Upgrading is a one-way process. You cannot "downgrade" an upgraded
+   Bugzilla. If you wish to revert to the old Bugzilla version for any
+   reason, you will have to restore your database from this backup.
+       Here are some sample commands you could use to backup your
+       database, depending on what database system you're using. You may
+       have to modify these commands for your particular setup.
+
+        MySQL:
+                mysqldump --opt -u bugs -p bugs > bugs.sql
+
+        PostgreSQL:
+                pg_dump --no-privileges --no-owner -h localhost -U bugs >
+                bugs.sql
+
+2.7.2. Getting The New Bugzilla
+
+   There are three ways to get the new version of Bugzilla. We'll list
+   them here briefly and then explain them more later.
+
+   Bzr (Section 2.7.2.2, “Upgrading using Bzr”)
+          If you have bzr installed on your machine and you have Internet
+          access, this is the easiest way to upgrade, particularly if you
+          have made modifications to the code or templates of Bugzilla.
+
+   Download the tarball (Section 2.7.2.3, “Upgrading using the tarball”)
+          This is a very simple way to upgrade, and good if you haven't
+          made many (or any) modifications to the code or templates of
+          your Bugzilla.
+
+   Patches (Section 2.7.2.4, “Upgrading using patches”)
+          If you have made modifications to your Bugzilla, and you don't
+          have Internet access or you don't want to use bzr, then this is
+          the best way to upgrade.
+
+          You can only do minor upgrades (such as 4.2 to 4.2.1 or 4.2.1 to
+          4.2.2) with patches.
+
+2.7.2.1. If you have modified your Bugzilla
+
+   If you have modified the code or templates of your Bugzilla, then
+   upgrading requires a bit more thought and effort. A discussion of the
+   various methods of updating compared with degree and methods of local
+   customization can be found in Section 6.3.2, “Choosing a Customization
+   Method”.
+
+   The larger the jump you are trying to make, the more difficult it is
+   going to be to upgrade if you have made local customizations. Upgrading
+   from 4.2 to 4.2.1 should be fairly painless even if you are heavily
+   customized, but going from 2.18 to 4.2 is going to mean a fair bit of
+   work re-writing your local changes to use the new files, logic,
+   templates, etc. If you have done no local changes at all, however, then
+   upgrading should be approximately the same amount of work regardless of
+   how long it has been since your version was released.
+
+2.7.2.2. Upgrading using Bzr
+
+   This requires that you have bzr installed (most Unix machines do), and
+   requires that you are able to access bzr.mozilla.org, which may not be
+   an option if you don't have Internet access.
+
+   The following shows the sequence of commands needed to update a
+   Bugzilla installation via Bzr, and a typical series of results. These
+   commands assume that you already have Bugzilla installed using Bzr.
+   [Warning]
+
+   If your installation is still using CVS, you must first convert it to
+   Bzr. A very detailed step by step documentation can be found on
+   wiki.mozilla.org.
+bash$ cd /var/www/html/bugzilla
+bash$ bzr switch 4.2 (only run this command when not yet running 4.2)
+bash$ bzr up -r tag:bugzilla-4.2.1
++N  extensions/MoreBugUrl/
++N  extensions/MoreBugUrl/Config.pm
++N  extensions/MoreBugUrl/Extension.pm
+...
+ M  Bugzilla/Attachment.pm
+ M  Bugzilla/Attachment/PatchReader.pm
+ M  Bugzilla/Bug.pm
+...
+All changes applied successfully.
+
+   [Caution]
+
+   If a line in the output from bzr up mentions a conflict, then that
+   represents a file with local changes that Bzr was unable to properly
+   merge. You need to resolve these conflicts manually before Bugzilla (or
+   at least the portion using that file) will be usable.
+
+2.7.2.3. Upgrading using the tarball
+
+   If you are unable (or unwilling) to use Bzr, another option that's
+   always available is to obtain the latest tarball from the Download Page
+   and create a new Bugzilla installation from that.
+
+   This sequence of commands shows how to get the tarball from the
+   command-line; it is also possible to download it from the site directly
+   in a web browser. If you go that route, save the file to the
+   /var/www/html directory (or its equivalent, if you use something else)
+   and omit the first three lines of the example.
+bash$ cd /var/www/html
+bash$ wget http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-4.2.1.tar.g
+z
+(Output omitted)
+bash$ tar xzvf bugzilla-4.2.1.tar.gz
+bugzilla-4.2.1/
+bugzilla-4.2.1/colchange.cgi
+(Output truncated)
+bash$ cd bugzilla-4.2.1
+bash$ cp ../bugzilla/localconfig* .
+bash$ cp -r ../bugzilla/data .
+bash$ cd ..
+bash$ mv bugzilla bugzilla.old
+bash$ mv bugzilla-4.2.1 bugzilla
+
+   [Warning]
+
+   The cp commands both end with periods which is a very important
+   detail--it means that the destination directory is the current working
+   directory.
+   [Caution]
+
+   If you have some extensions installed, you will have to copy them to
+   the new bugzilla directory too. Extensions are located in
+   bugzilla/extensions/. Only copy those you installed, not those managed
+   by the Bugzilla team.
+
+   This upgrade method will give you a clean install of Bugzilla. That's
+   fine if you don't have any local customizations that you want to
+   maintain. If you do have customizations, then you will need to reapply
+   them by hand to the appropriate files.
+
+2.7.2.4. Upgrading using patches
+
+   A patch is a collection of all the bug fixes that have been made since
+   the last bug-fix release.
+
+   If you are doing a bug-fix upgrade—that is, one where only the last
+   number of the revision changes, such as from 4.2 to 4.2.1—then you have
+   the option of obtaining and applying a patch file from the Download
+   Page.
+
+   As above, this example starts with obtaining the file via the command
+   line. If you have already downloaded it, you can omit the first two
+   commands.
+bash$ cd /var/www/html/bugzilla
+bash$ wget http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-4.2-to-4.2.
+1.diff.gz
+(Output omitted)
+bash$ gunzip bugzilla-4.2-to-4.2.1.diff.gz
+bash$ patch -p1 < bugzilla-4.2-to-4.2.1.diff
+patching file Bugzilla/Constants.pm
+patching file enter_bug.cgi
+(etc.)
+
+   [Warning]
+
+   Be aware that upgrading from a patch file does not change the entries
+   in your .bzr directory. This could make it more difficult to upgrade
+   using Bzr (Section 2.7.2.2, “Upgrading using Bzr”) in the future.
+
+2.7.3. Completing Your Upgrade
+
+   Now that you have the new Bugzilla code, there are a few final steps to
+   complete your upgrade.
+    1. If your new Bugzilla installation is in a different directory or on
+       a different machine than your old Bugzilla installation, make sure
+       that you have copied the data directory and the localconfig file
+       from your old Bugzilla installation. (If you followed the tarball
+       instructions above, this has already happened.)
+    2. If this is a major update, check that the configuration
+       (Section 2.2, “Configuration”) for your new Bugzilla is up-to-date.
+       Sometimes the configuration requirements change between major
+       versions.
+    3. If you didn't do it as part of the above configuration step, now
+       you need to run checksetup.pl, which will do everything required to
+       convert your existing database and settings for the new version:
+bash$ cd /var/www/html/bugzilla
+bash$ ./checksetup.pl
+
+   [Warning]
+   The period at the beginning of the command ./checksetup.pl is important
+   and cannot be omitted.
+
+       [Caution]
+   If this is a major upgrade (say, 3.6 to 4.2 or similar), running
+   checksetup.pl on a large installation (75,000 or more bugs) can take a
+   long time, possibly several hours.
+    4. Clear any HTML or text that you put into the shutdownhtml
+       parameter, to re-activate Bugzilla.
+    5. View the Sanity Check (Section 3.16, “Checking and Maintaining
+       Database Integrity”) page in your upgraded Bugzilla.
+       It is recommended that, if possible, you fix any problems you see,
+       immediately. Failure to do this may mean that Bugzilla will not
+       work correctly. Be aware that if the sanity check page contains
+       more errors after an upgrade, it doesn't necessarily mean there are
+       more errors in your database than there were before, as additional
+       tests are added to the sanity check over time, and it is possible
+       that those errors weren't being checked for in the old version.
+
+2.7.4. Automatic Notifications of New Releases
+
+   Bugzilla 3.0 introduced the ability to automatically notify
+   administrators when new releases are available, based on the
+   upgrade_notification parameter, see Section 3.1, “Bugzilla
+   Configuration”. Administrators will see these notifications when they
+   access the index.cgi page, i.e. generally when logging in. Bugzilla
+   will check once per day for new releases, unless the parameter is set
+   to “disabled”. If you are behind a proxy, you may have to set the
+   proxy_url parameter accordingly. If the proxy requires authentication,
+   use the http://user:pass@proxy_url/ syntax.
+
+Chapter 3. Administering Bugzilla
+
+   Table of Contents
+
+   3.1. Bugzilla Configuration
+
+        3.1.1. Required Settings
+        3.1.2. Administrative Policies
+        3.1.3. User Authentication
+        3.1.4. Attachments
+        3.1.5. Bug Change Policies
+        3.1.6. Bug Fields
+        3.1.7. Bug Moving
+        3.1.8. Dependency Graphs
+        3.1.9. Group Security
+        3.1.10. LDAP Authentication
+        3.1.11. RADIUS Authentication
+        3.1.12. Email
+        3.1.13. Patch Viewer
+        3.1.14. Query Defaults
+        3.1.15. Shadow Database
+        3.1.16. User Matching
+
+   3.2. User Administration
+
+        3.2.1. Creating the Default User
+        3.2.2. Managing Other Users
+
+   3.3. Classifications
+   3.4. Products
+
+        3.4.1. Creating New Products
+        3.4.2. Editing Products
+        3.4.3. Adding or Editing Components, Versions and Target
+                Milestones
+
+        3.4.4. Assigning Group Controls to Products
+
+   3.5. Components
+   3.6. Versions
+   3.7. Milestones
+   3.8. Flags
+
+        3.8.1. A Simple Example
+        3.8.2. About Flags
+        3.8.3. Using flag requests
+        3.8.4. Two Types of Flags
+        3.8.5. Administering Flags
+
+   3.9. Keywords
+   3.10. Custom Fields
+
+        3.10.1. Adding Custom Fields
+        3.10.2. Editing Custom Fields
+        3.10.3. Deleting Custom Fields
+
+   3.11. Legal Values
+
+        3.11.1. Viewing/Editing legal values
+        3.11.2. Deleting legal values
+
+   3.12. Bug Status Workflow
+   3.13. Voting
+   3.14. Quips
+   3.15. Groups and Group Security
+
+        3.15.1. Creating Groups
+        3.15.2. Editing Groups and Assigning Group Permissions
+        3.15.3. Assigning Users to Groups
+        3.15.4. Assigning Group Controls to Products
+
+   3.16. Checking and Maintaining Database Integrity
+
+3.1. Bugzilla Configuration
+
+   Bugzilla is configured by changing various parameters, accessed from
+   the "Parameters" link in the Administration page (the Administration
+   page can be found by clicking the "Administration" link in the footer).
+   The parameters are divided into several categories, accessed via the
+   menu on the left. Following is a description of the different
+   categories and important parameters within those categories.
+
+3.1.1. Required Settings
+
+   The core required parameters for any Bugzilla installation are set
+   here. These parameters must be set before a new Bugzilla installation
+   can be used. Administrators should review this list before deploying a
+   new Bugzilla installation.
+
+   maintainer
+          Email address of the person responsible for maintaining this
+          Bugzilla installation. The address need not be that of a valid
+          Bugzilla account.
+
+   urlbase
+          Defines the fully qualified domain name and web server path to
+          this Bugzilla installation.
+
+          For example, if the Bugzilla query page is
+          http://www.foo.com/bugzilla/query.cgi, the “urlbase” should be
+          set to http://www.foo.com/bugzilla/.
+
+   docs_urlbase
+          Defines path to the Bugzilla documentation. This can be a fully
+          qualified domain name, or a path relative to "urlbase".
+
+          For example, if the "Bugzilla Configuration" page of the
+          documentation is
+          http://www.foo.com/bugzilla/docs/html/parameters.html, set the
+          “docs_urlbase” to http://www.foo.com/bugzilla/docs/html/.
+
+   sslbase
+          Defines the fully qualified domain name and web server path for
+          HTTPS (SSL) connections to this Bugzilla installation.
+
+          For example, if the Bugzilla main page is
+          https://www.foo.com/bugzilla/index.cgi, the “sslbase” should be
+          set to https://www.foo.com/bugzilla/.
+
+   ssl_redirect
+          If enabled, Bugzilla will force HTTPS (SSL) connections, by
+          automatically redirecting any users who try to use a non-SSL
+          connection.
+
+   cookiedomain
+          Defines the domain for Bugzilla cookies. This is typically left
+          blank. If there are multiple hostnames that point to the same
+          webserver, which require the same cookie, then this parameter
+          can be utilized. For example, If your website is at
+          https://www.foo.com/, setting this to .foo.com/ will also allow
+          bar.foo.com/ to access Bugzilla cookies.
+
+   cookiepath
+          Defines a path, relative to the web server root, that Bugzilla
+          cookies will be restricted to. For example, if the urlbase is
+          set to http://www.foo.com/bugzilla/, the cookiepath should be
+          set to /bugzilla/. Setting it to "/" will allow all sites served
+          by this web server or virtual host to read Bugzilla cookies.
+
+   utf8
+          Determines whether to use UTF-8 (Unicode) encoding for all text
+          in Bugzilla. New installations should set this to true to avoid
+          character encoding problems. Existing databases should set this
+          to true only after the data has been converted from existing
+          legacy character encoding to UTF-8, using the contrib/recode.pl
+          script.
+
+          [Note]
+   If you turn this parameter from "off" to "on", you must re-run
+   checksetup.pl immediately afterward.
+
+   shutdownhtml
+          If there is any text in this field, this Bugzilla installation
+          will be completely disabled and this text will appear instead of
+          all Bugzilla pages for all users, including Admins. Used in the
+          event of site maintenance or outage situations.
+
+          [Note]
+   Although regular log-in capability is disabled while shutdownhtml is
+   enabled, safeguards are in place to protect the unfortunate admin who
+   loses connection to Bugzilla. Should this happen to you, go directly to
+   the editparams.cgi (by typing the URL in manually, if necessary). Doing
+   this will prompt you to log in, and your name/password will be accepted
+   here (but nowhere else).
+
+   announcehtml
+          Any text in this field will be displayed at the top of every
+          HTML page in this Bugzilla installation. The text is not wrapped
+          in any tags. For best results, wrap the text in a “<div>” tag.
+          Any style attributes from the CSS can be applied. For example,
+          to make the text green inside of a red box, add “id=message” to
+          the “<div>” tag.
+
+   proxy_url
+          If this Bugzilla installation is behind a proxy, enter the proxy
+          information here to enable Bugzilla to access the Internet.
+          Bugzilla requires Internet access to utilize the
+          upgrade_notification parameter (below). If the proxy requires
+          authentication, use the syntax: http://user:pass@proxy_url/.
+
+   upgrade_notification
+          Enable or disable a notification on the homepage of this
+          Bugzilla installation when a newer version of Bugzilla is
+          available. This notification is only visible to administrators.
+          Choose "disabled", to turn off the notification. Otherwise,
+          choose which version of Bugzilla you want to be notified about:
+          "development_snapshot" is the latest release on the trunk;
+          "latest_stable_release" is the most recent release available on
+          the most recent stable branch; "stable_branch_release" the most
+          recent release on the branch this installation is based on.
+
+3.1.2. Administrative Policies
+
+   This page contains parameters for basic administrative functions.
+   Options include whether to allow the deletion of bugs and users, and
+   whether to allow users to change their email address.
+
+3.1.3. User Authentication
+
+   This page contains the settings that control how this Bugzilla
+   installation will do its authentication. Choose what authentication
+   mechanism to use (the Bugzilla database, or an external source such as
+   LDAP), and set basic behavioral parameters. For example, choose whether
+   to require users to login to browse bugs, the management of
+   authentication cookies, and the regular expression used to validate
+   email addresses. Some parameters are highlighted below.
+
+   emailregexp
+          Defines the regular expression used to validate email addresses
+          used for login names. The default attempts to match fully
+          qualified email addresses (i.e. 'user@example.com') in a
+          slightly more restrictive way than what is allowed in RFC 2822.
+          Some Bugzilla installations allow only local user names (i.e
+          'user' instead of 'user@example.com'). In that case, this
+          parameter should be used to define the email domain.
+
+   emailsuffix
+          This string is appended to login names when actually sending
+          email to a user. For example, If emailregexp has been set to
+          allow local usernames, then this parameter would contain the
+          email domain for all users (i.e. '@example.com').
+
+3.1.4. Attachments
+
+   This page allows for setting restrictions and other parameters
+   regarding attachments to bugs. For example, control size limitations
+   and whether to allow pointing to external files via a URI.
+
+3.1.5. Bug Change Policies
+
+   Set policy on default behavior for bug change events. For example,
+   choose which status to set a bug to when it is marked as a duplicate,
+   and choose whether to allow bug reporters to set the priority or target
+   milestone. Also allows for configuration of what changes should require
+   the user to make a comment, described below.
+
+   commenton*
+          All these fields allow you to dictate what changes can pass
+          without comment, and which must have a comment from the person
+          who changed them. Often, administrators will allow users to add
+          themselves to the CC list, accept bugs, or change the Status
+          Whiteboard without adding a comment as to their reasons for the
+          change, yet require that most other changes come with an
+          explanation.
+
+          Set the "commenton" options according to your site policy. It is
+          a wise idea to require comments when users resolve, reassign, or
+          reopen bugs at the very least.
+
+          [Note]
+   It is generally far better to require a developer comment when
+   resolving bugs than not. Few things are more annoying to bug database
+   users than having a developer mark a bug "fixed" without any comment as
+   to what the fix was (or even that it was truly fixed!)
+
+   noresolveonopenblockers
+          This option will prevent users from resolving bugs as FIXED if
+          they have unresolved dependencies. Only the FIXED resolution is
+          affected. Users will be still able to resolve bugs to
+          resolutions other than FIXED if they have unresolved dependent
+          bugs.
+
+3.1.6. Bug Fields
+
+   The parameters in this section determine the default settings of
+   several Bugzilla fields for new bugs, and also control whether certain
+   fields are used. For example, choose whether to use the "target
+   milestone" field or the "status whiteboard" field.
+
+   useqacontact
+          This allows you to define an email address for each component,
+          in addition to that of the default assignee, who will be sent
+          carbon copies of incoming bugs.
+
+   usestatuswhiteboard
+          This defines whether you wish to have a free-form, overwritable
+          field associated with each bug. The advantage of the Status
+          Whiteboard is that it can be deleted or modified with ease, and
+          provides an easily-searchable field for indexing some bugs that
+          have some trait in common.
+
+3.1.7. Bug Moving
+
+   This page controls whether this Bugzilla installation allows certain
+   users to move bugs to an external database. If bug moving is enabled,
+   there are a number of parameters that control bug moving behaviors. For
+   example, choose which users are allowed to move bugs, the location of
+   the external database, and the default product and component that bugs
+   moved from other bug databases to this Bugzilla installation are
+   assigned to.
+
+3.1.8. Dependency Graphs
+
+   This page has one parameter that sets the location of a Web Dot server,
+   or of the Web Dot binary on the local system, that is used to generate
+   dependency graphs. Web Dot is a CGI program that creates images from
+   .dot graphic description files. If no Web Dot server or binary is
+   specified, then dependency graphs will be disabled.
+
+3.1.9. Group Security
+
+   Bugzilla allows for the creation of different groups, with the ability
+   to restrict the visibility of bugs in a group to a set of specific
+   users. Specific products can also be associated with groups, and users
+   restricted to only see products in their groups. Several parameters are
+   described in more detail below. Most of the configuration of groups and
+   their relationship to products is done on the "Groups" and "Product"
+   pages of the "Administration" area. The options on this page control
+   global default behavior. For more information on Groups and Group
+   Security, see Section 3.15, “Groups and Group Security”
+
+   makeproductgroups
+          Determines whether or not to automatically create groups when
+          new products are created. If this is on, the groups will be used
+          for querying bugs.
+
+   usevisibilitygroups
+          If selected, user visibility will be restricted to members of
+          groups, as selected in the group configuration settings. Each
+          user-defined group can be allowed to see members of selected
+          other groups. For details on configuring groups (including the
+          visibility restrictions) see Section 3.15.2, “Editing Groups and
+          Assigning Group Permissions”.
+
+   querysharegroup
+          The name of the group of users who are allowed to share saved
+          searches with one another. For more information on using saved
+          searches, see Saved Searches.
+
+3.1.10. LDAP Authentication
+
+   LDAP authentication is a module for Bugzilla's plugin authentication
+   architecture. This page contains all the parameters necessary to
+   configure Bugzilla for use with LDAP authentication.
+
+   The existing authentication scheme for Bugzilla uses email addresses as
+   the primary user ID, and a password to authenticate that user. All
+   places within Bugzilla that require a user ID (e.g assigning a bug) use
+   the email address. The LDAP authentication builds on top of this
+   scheme, rather than replacing it. The initial log-in is done with a
+   username and password for the LDAP directory. Bugzilla tries to bind to
+   LDAP using those credentials and, if successful, tries to map this
+   account to a Bugzilla account. If an LDAP mail attribute is defined,
+   the value of this attribute is used, otherwise the "emailsuffix"
+   parameter is appended to LDAP username to form a full email address. If
+   an account for this address already exists in the Bugzilla
+   installation, it will log in to that account. If no account for that
+   email address exists, one is created at the time of login. (In this
+   case, Bugzilla will attempt to use the "displayName" or "cn" attribute
+   to determine the user's full name.) After authentication, all other
+   user-related tasks are still handled by email address, not LDAP
+   username. For example, bugs are still assigned by email address and
+   users are still queried by email address.
+   [Caution]
+
+   Because the Bugzilla account is not created until the first time a user
+   logs in, a user who has not yet logged is unknown to Bugzilla. This
+   means they cannot be used as an assignee or QA contact (default or
+   otherwise), added to any CC list, or any other such operation. One
+   possible workaround is the bugzilla_ldapsync.rb script in the contrib
+   directory. Another possible solution is fixing bug 201069.
+
+   Parameters required to use LDAP Authentication:
+
+   user_verify_class
+          If you want to list “LDAP” here, make sure to have set up the
+          other parameters listed below. Unless you have other (working)
+          authentication methods listed as well, you may otherwise not be
+          able to log back in to Bugzilla once you log out. If this
+          happens to you, you will need to manually edit data/params and
+          set user_verify_class to “DB”.
+
+   LDAPserver
+          This parameter should be set to the name (and optionally the
+          port) of your LDAP server. If no port is specified, it assumes
+          the default LDAP port of 389.
+
+          For example: “ldap.company.com” or “ldap.company.com:3268”
+
+          You can also specify a LDAP URI, so as to use other protocols,
+          such as LDAPS or LDAPI. If port was not specified in the URI,
+          the default is either 389 or 636 for 'LDAP' and 'LDAPS' schemes
+          respectively.
+
+          [Tip]
+   In order to use SSL with LDAP, specify a URI with "ldaps://". This will
+   force the use of SSL over port 636.
+
+          For example, normal LDAP: “ldap://ldap.company.com”, LDAP over
+          SSL: “ldaps://ldap.company.com” or LDAP over a UNIX domain
+          socket “ldapi://%2fvar%2flib%2fldap_sock”.
+
+   LDAPbinddn [Optional]
+          Some LDAP servers will not allow an anonymous bind to search the
+          directory. If this is the case with your configuration you
+          should set the LDAPbinddn parameter to the user account Bugzilla
+          should use instead of the anonymous bind.
+
+          Ex. “cn=default,cn=user:password”
+
+   LDAPBaseDN
+          The LDAPBaseDN parameter should be set to the location in your
+          LDAP tree that you would like to search for email addresses.
+          Your uids should be unique under the DN specified here.
+
+          Ex. “ou=People,o=Company”
+
+   LDAPuidattribute
+          The LDAPuidattribute parameter should be set to the attribute
+          which contains the unique UID of your users. The value retrieved
+          from this attribute will be used when attempting to bind as the
+          user to confirm their password.
+
+          Ex. “uid”
+
+   LDAPmailattribute
+          The LDAPmailattribute parameter should be the name of the
+          attribute which contains the email address your users will enter
+          into the Bugzilla login boxes.
+
+          Ex. “mail”
+
+3.1.11. RADIUS Authentication
+
+   RADIUS authentication is a module for Bugzilla's plugin authentication
+   architecture. This page contains all the parameters necessary for
+   configuring Bugzilla to use RADIUS authentication.
+   [Note]
+
+   Most caveats that apply to LDAP authentication apply to RADIUS
+   authentication as well. See Section 3.1.10, “LDAP Authentication” for
+   details.
+
+   Parameters required to use RADIUS Authentication:
+
+   user_verify_class
+          If you want to list “RADIUS” here, make sure to have set up the
+          other parameters listed below. Unless you have other (working)
+          authentication methods listed as well, you may otherwise not be
+          able to log back in to Bugzilla once you log out. If this
+          happens to you, you will need to manually edit data/params and
+          set user_verify_class to “DB”.
+
+   RADIUS_server
+          This parameter should be set to the name (and optionally the
+          port) of your RADIUS server.
+
+   RADIUS_secret
+          This parameter should be set to the RADIUS server's secret.
+
+   RADIUS_email_suffix
+          Bugzilla needs an e-mail address for each user account.
+          Therefore, it needs to determine the e-mail address
+          corresponding to a RADIUS user. Bugzilla offers only a simple
+          way to do this: it can concatenate a suffix to the RADIUS user
+          name to convert it into an e-mail address. You can specify this
+          suffix in the RADIUS_email_suffix parameter.
+
+          If this simple solution does not work for you, you'll probably
+          need to modify Bugzilla/Auth/Verify/RADIUS.pm to match your
+          requirements.
+
+3.1.12. Email
+
+   This page contains all of the parameters for configuring how Bugzilla
+   deals with the email notifications it sends. See below for a summary of
+   important options.
+
+   mail_delivery_method
+          This is used to specify how email is sent, or if it is sent at
+          all. There are several options included for different MTAs,
+          along with two additional options that disable email sending.
+          "Test" does not send mail, but instead saves it in
+          data/mailer.testfile for later review. "None" disables email
+          sending entirely.
+
+   mailfrom
+          This is the email address that will appear in the "From" field
+          of all emails sent by this Bugzilla installation. Some email
+          servers require mail to be from a valid email address, therefore
+          it is recommended to choose a valid email address here.
+
+   smtpserver
+          This is the SMTP server address, if the “mail_delivery_method”
+          parameter is set to SMTP. Use "localhost" if you have a local
+          MTA running, otherwise use a remote SMTP server. Append ":" and
+          the port number, if a non-default port is needed.
+
+   smtp_username
+          Username to use for SASL authentication to the SMTP server.
+          Leave this parameter empty if your server does not require
+          authentication.
+
+   smtp_password
+          Password to use for SASL authentication to the SMTP server. This
+          parameter will be ignored if the “smtp_username” parameter is
+          left empty.
+
+   smtp_ssl
+          Enable SSL support for connection to the SMTP server.
+
+   smtp_debug
+          This parameter allows you to enable detailed debugging output.
+          Log messages are printed the web server's error log.
+
+   whinedays
+          Set this to the number of days you want to let bugs go in the
+          CONFIRMED state before notifying people they have untouched new
+          bugs. If you do not plan to use this feature, simply do not set
+          up the whining cron job described in the installation
+          instructions, or set this value to "0" (never whine).
+
+   globalwatcher
+          This allows you to define specific users who will receive
+          notification each time a new bug in entered, or when an existing
+          bug changes, according to the normal groupset permissions. It
+          may be useful for sending notifications to a mailing-list, for
+          instance.
+
+3.1.13. Patch Viewer
+
+   This page contains configuration parameters for the CVS server, Bonsai
+   server and LXR server that Bugzilla will use to enable the features of
+   the Patch Viewer. Bonsai is a tool that enables queries to a CVS tree.
+   LXR is a tool that can cross reference and index source code.
+
+3.1.14. Query Defaults
+
+   This page controls the default behavior of Bugzilla in regards to
+   several aspects of querying bugs. Options include what the default
+   query options are, what the "My Bugs" page returns, whether users can
+   freely add bugs to the quip list, and how many duplicate bugs are
+   needed to add a bug to the "most frequently reported" list.
+
+3.1.15. Shadow Database
+
+   This page controls whether a shadow database is used, and all the
+   parameters associated with the shadow database. Versions of Bugzilla
+   prior to 3.2 used the MyISAM table type, which supports only
+   table-level write locking. With MyISAM, any time someone is making a
+   change to a bug, the entire table is locked until the write operation
+   is complete. Locking for write also blocks reads until the write is
+   complete.
+
+   The “shadowdb” parameter was designed to get around this limitation.
+   While only a single user is allowed to write to a table at a time,
+   reads can continue unimpeded on a read-only shadow copy of the
+   database.
+   [Note]
+
+   As of version 3.2, Bugzilla no longer uses the MyISAM table type.
+   Instead, InnoDB is used, which can do transaction-based locking.
+   Therefore, the limitations the Shadow Database feature was designed to
+   workaround no longer exist.
+
+3.1.16. User Matching
+
+   The settings on this page control how users are selected and queried
+   when adding a user to a bug. For example, users need to be selected
+   when choosing who the bug is assigned to, adding to the CC list or
+   selecting a QA contact. With the "usemenuforusers" parameter, it is
+   possible to configure Bugzilla to display a list of users in the fields
+   instead of an empty text field. This should only be used in Bugzilla
+   installations with a small number of users. If users are selected via a
+   text box, this page also contains parameters for how user names can be
+   queried and matched when entered.
+
+   Another setting called 'ajax_user_autocompletion' enables certain user
+   fields to display a list of matched user names as a drop down after
+   typing a few characters. Note that it is recommended to use mod_perl
+   when enabling 'ajax_user_autocompletion'.
+
+3.2. User Administration
+
+3.2.1. Creating the Default User
+
+   When you first run checksetup.pl after installing Bugzilla, it will
+   prompt you for the administrative username (email address) and password
+   for this "super user". If for some reason you delete the "super user"
+   account, re-running checksetup.pl will again prompt you for this
+   username and password.
+   [Tip]
+
+   If you wish to add more administrative users, add them to the "admin"
+   group and, optionally, edit the tweakparams, editusers, creategroups,
+   editcomponents, and editkeywords groups to add the entire admin group
+   to those groups (which is the case by default).
+
+3.2.2. Managing Other Users
+
+3.2.2.1. Searching for existing users
+
+   If you have “editusers” privileges or if you are allowed to grant
+   privileges for some groups, the “Users” link will appear in the
+   Administration page.
+
+   The first screen is a search form to search for existing user accounts.
+   You can run searches based either on the user ID, real name or login
+   name (i.e. the email address, or just the first part of the email
+   address if the "emailsuffix" parameter is set). The search can be
+   conducted in different ways using the listbox to the right of the text
+   entry box. You can match by case-insensitive substring (the default),
+   regular expression, a reverse regular expression match (which finds
+   every user name which does NOT match the regular expression), or the
+   exact string if you know exactly who you are looking for. The search
+   can be restricted to users who are in a specific group. By default, the
+   restriction is turned off.
+
+   The search returns a list of users matching your criteria. User
+   properties can be edited by clicking the login name. The Account
+   History of a user can be viewed by clicking the "View" link in the
+   Account History column. The Account History displays changes that have
+   been made to the user account, the time of the change and the user who
+   made the change. For example, the Account History page will display
+   details of when a user was added or removed from a group.
+
+3.2.2.2. Creating new users
+
+3.2.2.2.1. Self-registration
+
+   By default, users can create their own user accounts by clicking the
+   “New Account” link at the bottom of each page (assuming they aren't
+   logged in as someone else already). If you want to disable this
+   self-registration, or if you want to restrict who can create his own
+   user account, you have to edit the “createemailregexp” parameter in the
+   “Configuration” page, see Section 3.1, “Bugzilla Configuration”.
+
+3.2.2.2.2. Accounts created by an administrator
+
+   Users with “editusers” privileges, such as administrators, can create
+   user accounts for other users:
+    1. After logging in, click the "Users" link at the footer of the query
+       page, and then click "Add a new user".
+    2. Fill out the form presented. This page is self-explanatory. When
+       done, click "Submit".
+
+       [Note]
+   Adding a user this way will not send an email informing them of their
+   username and password. While useful for creating dummy accounts
+   (watchers which shuttle mail to another system, for instance, or email
+   addresses which are a mailing list), in general it is preferable to log
+   out and use the “New Account” button to create users, as it will
+   pre-populate all the required fields and also notify the user of her
+   account name and password.
+
+3.2.2.3. Modifying Users
+
+   Once you have found your user, you can change the following fields:
+     * Login Name: This is generally the user's full email address.
+       However, if you have are using the “emailsuffix” parameter, this
+       may just be the user's login name. Note that users can now change
+       their login names themselves (to any valid email address).
+     * Real Name: The user's real name. Note that Bugzilla does not
+       require this to create an account.
+     * Password: You can change the user's password here. Users can
+       automatically request a new password, so you shouldn't need to do
+       this often. If you want to disable an account, see Disable Text
+       below.
+     * Bugmail Disabled: Mark this checkbox to disable bugmail and
+       whinemail completely for this account. This checkbox replaces the
+       data/nomail file which existed in older versions of Bugzilla.
+     * Disable Text: If you type anything in this box, including just a
+       space, the user is prevented from logging in, or making any changes
+       to bugs via the web interface. The HTML you type in this box is
+       presented to the user when they attempt to perform these actions,
+       and should explain why the account was disabled.
+       Users with disabled accounts will continue to receive mail from
+       Bugzilla; furthermore, they will not be able to log in themselves
+       to change their own preferences and stop it. If you want an account
+       (disabled or active) to stop receiving mail, simply check the
+       “Bugmail Disabled” checkbox above.
+
+       [Note]
+   Even users whose accounts have been disabled can still submit bugs via
+   the e-mail gateway, if one exists. The e-mail gateway should not be
+   enabled for secure installations of Bugzilla.
+
+       [Warning]
+                 Don't disable all the administrator accounts!
+     * <groupname>: If you have created some groups, e.g.
+       "securitysensitive", then checkboxes will appear here to allow you
+       to add users to, or remove them from, these groups. The first
+       checkbox gives the user the ability to add and remove other users
+       as members of this group. The second checkbox adds the user himself
+       as a member of the group.
+     * canconfirm: This field is only used if you have enabled the
+       "unconfirmed" status. If you enable this for a user, that user can
+       then move bugs from "Unconfirmed" to a "Confirmed" status (e.g.:
+       "New" status).
+     * creategroups: This option will allow a user to create and destroy
+       groups in Bugzilla.
+     * editbugs: Unless a user has this bit set, they can only edit those
+       bugs for which they are the assignee or the reporter. Even if this
+       option is unchecked, users can still add comments to bugs.
+     * editcomponents: This flag allows a user to create new products and
+       components, as well as modify and destroy those that have no bugs
+       associated with them. If a product or component has bugs associated
+       with it, those bugs must be moved to a different product or
+       component before Bugzilla will allow them to be destroyed.
+     * editkeywords: If you use Bugzilla's keyword functionality, enabling
+       this feature allows a user to create and destroy keywords. As
+       always, the keywords for existing bugs containing the keyword the
+       user wishes to destroy must be changed before Bugzilla will allow
+       it to die.
+     * editusers: This flag allows a user to do what you're doing right
+       now: edit other users. This will allow those with the right to do
+       so to remove administrator privileges from other users or grant
+       them to themselves. Enable with care.
+     * tweakparams: This flag allows a user to change Bugzilla's Params
+       (using editparams.cgi.)
+     * <productname>: This allows an administrator to specify the products
+       in which a user can see bugs. If you turn on the
+       “makeproductgroups” parameter in the Group Security Panel in the
+       Parameters page, then Bugzilla creates one group per product (at
+       the time you create the product), and this group has exactly the
+       same name as the product itself. Note that for products that
+       already exist when the parameter is turned on, the corresponding
+       group will not be created. The user must still have the “editbugs”
+       privilege to edit bugs in these products.
+
+3.2.2.4. Deleting Users
+
+   If the “allowuserdeletion” parameter is turned on, see Section 3.1,
+   “Bugzilla Configuration”, then you can also delete user accounts. Note
+   that this is most of the time not the best thing to do. If only a
+   warning in a yellow box is displayed, then the deletion is safe. If a
+   warning is also displayed in a red box, then you should NOT try to
+   delete the user account, else you will get referential integrity
+   problems in your database, which can lead to unexpected behavior, such
+   as bugs not appearing in bug lists anymore, or data displaying
+   incorrectly. You have been warned!
+
+3.2.2.5. Impersonating Users
+
+   There may be times when an administrator would like to do something as
+   another user. The sudo feature may be used to do this.
+   [Note]
+
+   To use the sudo feature, you must be in the bz_sudoers group. By
+   default, all administrators are in this group.
+
+   If you have access to this feature, you may start a session by going to
+   the Edit Users page, Searching for a user and clicking on their login.
+   You should see a link below their login name titled "Impersonate this
+   user". Click on the link. This will take you to a page where you will
+   see a description of the feature and instructions for using it. After
+   reading the text, simply enter the login of the user you would like to
+   impersonate, provide a short message explaining why you are doing this,
+   and press the button.
+
+   As long as you are using this feature, everything you do will be done
+   as if you were logged in as the user you are impersonating.
+   [Warning]
+
+   The user you are impersonating will not be told about what you are
+   doing. If you do anything that results in mail being sent, that mail
+   will appear to be from the user you are impersonating. You should be
+   extremely careful while using this feature.
+
+3.3. Classifications
+
+   Classifications tend to be used in order to group several related
+   products into one distinct entity.
+
+   The classifications layer is disabled by default; it can be turned on
+   or off using the useclassification parameter, in the Bug Fields section
+   of the edit parameters screen.
+
+   Access to the administration of classifications is controlled using the
+   editclassifications system group, which defines a privilege for
+   creating, destroying, and editing classifications.
+
+   When activated, classifications will introduce an additional step when
+   filling bugs (dedicated to classification selection), and they will
+   also appear in the advanced search form.
+
+3.4. Products
+
+   Products typically represent real-world shipping products. Products can
+   be given Classifications. For example, if a company makes computer
+   games, they could have a classification of "Games", and a separate
+   product for each game. This company might also have a “Common” product
+   for units of technology used in multiple games, and perhaps a few
+   special products that represent items that are not actually shipping
+   products (for example, "Website", or "Administration").
+
+   Many of Bugzilla's settings are configurable on a per-product basis.
+   The number of “votes” available to users is set per-product, as is the
+   number of votes required to move a bug automatically from the
+   UNCONFIRMED status to the CONFIRMED status.
+
+   When creating or editing products the following options are available:
+
+   Product
+          The name of the product
+
+   Description
+          A brief description of the product
+
+   Default milestone
+          Select the default milestone for this product.
+
+   Closed for bug entry
+          Select this box to prevent new bugs from being entered against
+          this product.
+
+   Maximum votes per person
+          Maximum votes a user is allowed to give for this product
+
+   Maximum votes a person can put on a single bug
+          Maximum votes a user is allowed to give for this product in a
+          single bug
+
+   Confirmation threshold
+          Number of votes needed to automatically remove any bug against
+          this product from the UNCONFIRMED state
+
+   Version
+          Specify which version of the product bugs will be entered
+          against.
+
+   Create chart datasets for this product
+          Select to make chart datasets available for this product.
+
+   When editing a product there is also a link to edit Group Access
+   Controls, see Section 3.4.4, “Assigning Group Controls to Products”.
+
+3.4.1. Creating New Products
+
+   To create a new product:
+    1. Select “Administration” from the footer and then choose “Products”
+       from the main administration page.
+    2. Select the “Add” link in the bottom right.
+    3. Enter the name of the product and a description. The Description
+       field may contain HTML.
+    4. When the product is created, Bugzilla will give a message stating
+       that a component must be created before any bugs can be entered
+       against the new product. Follow the link to create a new component.
+       See Components for more information.
+
+3.4.2. Editing Products
+
+   To edit an existing product, click the "Products" link from the
+   "Administration" page. If the 'useclassification' parameter is turned
+   on, a table of existing classifications is displayed, including an
+   "Unclassified" category. The table indicates how many products are in
+   each classification. Click on the classification name to see its
+   products. If the 'useclassification' parameter is not in use, the table
+   lists all products directly. The product table summarizes the
+   information about the product defined when the product was created.
+   Click on the product name to edit these properties, and to access links
+   to other product attributes such as the product's components, versions,
+   milestones, and group access controls.
+
+3.4.3. Adding or Editing Components, Versions and Target Milestones
+
+   To edit existing, or add new, Components, Versions or Target Milestones
+   to a Product, select the "Edit Components", "Edit Versions" or "Edit
+   Milestones" links from the "Edit Product" page. A table of existing
+   Components, Versions or Milestones is displayed. Click on a item name
+   to edit the properties of that item. Below the table is a link to add a
+   new Component, Version or Milestone.
+
+   For more information on components, see Components.
+
+   For more information on versions, see Section 3.6, “Versions”.
+
+   For more information on milestones, see Section 3.7, “Milestones”.
+
+3.4.4. Assigning Group Controls to Products
+
+   On the “Edit Product” page, there is a link called “Edit Group Access
+   Controls”. The settings on this page control the relationship of the
+   groups to the product being edited.
+
+   Group Access Controls are an important aspect of using groups for
+   isolating products and restricting access to bugs filed against those
+   products. For more information on groups, including how to create, edit
+   add users to, and alter permission of, see Section 3.15, “Groups and
+   Group Security”.
+
+   After selecting the "Edit Group Access Controls" link from the "Edit
+   Product" page, a table containing all user-defined groups for this
+   Bugzilla installation is displayed. The system groups that are created
+   when Bugzilla is installed are not applicable to Group Access Controls.
+   Below is description of what each of these fields means.
+
+   Groups may be applicable (e.g bugs in this product can be associated
+   with this group) , default (e.g. bugs in this product are in this group
+   by default), and mandatory (e.g. bugs in this product must be
+   associated with this group) for each product. Groups can also control
+   access to bugs for a given product, or be used to make bugs for a
+   product totally read-only unless the group restrictions are met. The
+   best way to understand these relationships is by example. See
+   Section 3.4.4.1, “Common Applications of Group Controls” for examples
+   of product and group relationships.
+   [Note]
+
+   Products and Groups are not limited to a one-to-one relationship.
+   Multiple groups can be associated with the same product, and groups can
+   be associated with more than one product.
+
+   If any group has Entry selected, then the product will restrict bug
+   entry to only those users who are members of all the groups with Entry
+   selected.
+
+   If any group has Canedit selected, then the product will be read-only
+   for any users who are not members of all of the groups with Canedit
+   selected. Only users who are members of all the Canedit groups will be
+   able to edit bugs for this product. This is an additional restriction
+   that enables finer-grained control over products rather than just
+   all-or-nothing access levels.
+
+   The following settings let you choose privileges on a per-product
+   basis. This is a convenient way to give privileges to some users for
+   some products only, without having to give them global privileges which
+   would affect all products.
+
+   Any group having editcomponents selected allows users who are in this
+   group to edit all aspects of this product, including components,
+   milestones and versions.
+
+   Any group having canconfirm selected allows users who are in this group
+   to confirm bugs in this product.
+
+   Any group having editbugs selected allows users who are in this group
+   to edit all fields of bugs in this product.
+
+   The MemberControl and OtherControl are used in tandem to determine
+   which bugs will be placed in this group. The only allowable
+   combinations of these two parameters are listed in a table on the "Edit
+   Group Access Controls" page. Consult this table for details on how
+   these fields can be used. Examples of different uses are described
+   below.
+
+3.4.4.1. Common Applications of Group Controls
+
+   The use of groups is best explained by providing examples that
+   illustrate configurations for common use cases. The examples follow a
+   common syntax: Group: Entry, MemberControl, OtherControl, CanEdit,
+   EditComponents, CanConfirm, EditBugs. Where "Group" is the name of the
+   group being edited for this product. The other fields all correspond to
+   the table on the "Edit Group Access Controls" page. If any of these
+   options are not listed, it means they are not checked.
+
+   Basic Product/Group Restriction
+
+   Suppose there is a product called "Bar". The "Bar" product can only
+   have bugs entered against it by users in the group "Foo". Additionally,
+   bugs filed against product "Bar" must stay restricted to users to "Foo"
+   at all times. Furthermore, only members of group "Foo" can edit bugs
+   filed against product "Bar", even if other users could see the bug.
+   This arrangement would achieved by the following:
+Product Bar:
+foo: ENTRY, MANDATORY/MANDATORY, CANEDIT
+
+   Perhaps such strict restrictions are not needed for product "Bar". A
+   more lenient way to configure product "Bar" and group "Foo" would be:
+Product Bar:
+foo: ENTRY, SHOWN/SHOWN, EDITCOMPONENTS, CANCONFIRM, EDITBUGS
+
+   The above indicates that for product "Bar", members of group "Foo" can
+   enter bugs. Any one with permission to edit a bug against product "Bar"
+   can put the bug in group "Foo", even if they themselves are not in
+   "Foo". Anyone in group "Foo" can edit all aspects of the components of
+   product "Bar", can confirm bugs against product "Bar", and can edit all
+   fields of any bug against product "Bar".
+
+   General User Access With Security Group
+
+   To permit any user to file bugs against "Product A", and to permit any
+   user to submit those bugs into a group called "Security":
+
+Product A:
+security: SHOWN/SHOWN
+
+   General User Access With A Security Product
+
+   To permit any user to file bugs against product called "Security" while
+   keeping those bugs from becoming visible to anyone outside the group
+   "SecurityWorkers" (unless a member of the "SecurityWorkers" group
+   removes that restriction):
+
+Product Security:
+securityworkers: DEFAULT/MANDATORY
+
+   Product Isolation With a Common Group
+
+   To permit users of "Product A" to access the bugs for "Product A",
+   users of "Product B" to access the bugs for "Product B", and support
+   staff, who are members of the "Support Group" to access both, three
+   groups are needed:
+    1. Support Group: Contains members of the support staff.
+    2. AccessA Group: Contains users of product A and the Support group.
+    3. AccessB Group: Contains users of product B and the Support group.
+
+   Once these three groups are defined, the product group controls can be
+   set to:
+Product A:
+AccessA: ENTRY, MANDATORY/MANDATORY
+Product B:
+AccessB: ENTRY, MANDATORY/MANDATORY
+
+   Perhaps the "Support Group" wants more control. For example, the
+   "Support Group" could be permitted to make bugs inaccessible to users
+   of both groups "AccessA" and "AccessB". Then, the "Support Group" could
+   be permitted to publish bugs relevant to all users in a third product
+   (let's call it "Product Common") that is read-only to anyone outside
+   the "Support Group". In this way the "Support Group" could control bugs
+   that should be seen by both groups. That configuration would be:
+Product A:
+AccessA: ENTRY, MANDATORY/MANDATORY
+Support: SHOWN/NA
+Product B:
+AccessB: ENTRY, MANDATORY/MANDATORY
+Support: SHOWN/NA
+Product Common:
+Support: ENTRY, DEFAULT/MANDATORY, CANEDIT
+
+   Make a Product Read Only
+
+   Sometimes a product is retired and should no longer have new bugs filed
+   against it (for example, an older version of a software product that is
+   no longer supported). A product can be made read-only by creating a
+   group called "readonly" and adding products to the group as needed:
+Product A:
+ReadOnly: ENTRY, NA/NA, CANEDIT
+
+   [Note]
+
+   For more information on Groups outside of how they relate to products
+   see Section 3.15, “Groups and Group Security”.
+
+3.5. Components
+
+   Components are subsections of a Product. E.g. the computer game you are
+   designing may have a "UI" component, an "API" component, a "Sound
+   System" component, and a "Plugins" component, each overseen by a
+   different programmer. It often makes sense to divide Components in
+   Bugzilla according to the natural divisions of responsibility within
+   your Product or company.
+
+   Each component has a default assignee and (if you turned it on in the
+   parameters), a QA Contact. The default assignee should be the primary
+   person who fixes bugs in that component. The QA Contact should be the
+   person who will ensure these bugs are completely fixed. The Assignee,
+   QA Contact, and Reporter will get email when new bugs are created in
+   this Component and when these bugs change. Default Assignee and Default
+   QA Contact fields only dictate the default assignments; these can be
+   changed on bug submission, or at any later point in a bug's life.
+
+   To create a new Component:
+    1. Select the “Edit components” link from the “Edit product” page
+    2. Select the “Add” link in the bottom right.
+    3. Fill out the “Component” field, a short “Description”, the “Default
+       Assignee”, “Default CC List” and “Default QA Contact” (if enabled).
+       The “Component Description” field may contain a limited subset of
+       HTML tags. The “Default Assignee” field must be a login name
+       already existing in the Bugzilla database.
+
+3.6. Versions
+
+   Versions are the revisions of the product, such as "Flinders 3.1",
+   "Flinders 95", and "Flinders 2000". Version is not a multi-select
+   field; the usual practice is to select the earliest version known to
+   have the bug.
+
+   To create and edit Versions:
+    1. From the "Edit product" screen, select "Edit Versions"
+    2. You will notice that the product already has the default version
+       "undefined". Click the "Add" link in the bottom right.
+    3. Enter the name of the Version. This field takes text only. Then
+       click the "Add" button.
+
+3.7. Milestones
+
+   Milestones are "targets" that you plan to get a bug fixed by. For
+   example, you have a bug that you plan to fix for your 3.0 release, it
+   would be assigned the milestone of 3.0.
+   [Note]
+
+   Milestone options will only appear for a Product if you turned on the
+   "usetargetmilestone" parameter in the "Bug Fields" tab of the
+   "Parameters" page.
+
+   To create new Milestones, and set Default Milestones:
+    1. Select "Edit milestones" from the "Edit product" page.
+    2. Select "Add" in the bottom right corner.
+    3. Enter the name of the Milestone in the "Milestone" field. You can
+       optionally set the "sortkey", which is a positive or negative
+       number (-32768 to 32767) that defines where in the list this
+       particular milestone appears. This is because milestones often do
+       not occur in alphanumeric order For example, "Future" might be
+       after "Release 1.2". Select "Add".
+
+3.8. Flags
+
+   Flags are a way to attach a specific status to a bug or attachment,
+   either “+” or “-”. The meaning of these symbols depends on the text the
+   flag itself, but contextually they could mean pass/fail, accept/reject,
+   approved/denied, or even a simple yes/no. If your site allows
+   requestable flags, then users may set a flag to “?” as a request to
+   another user that they look at the bug/attachment, and set the flag to
+   its correct status.
+
+3.8.1. A Simple Example
+
+   A developer might want to ask their manager, “Should we fix this bug
+   before we release version 2.0?” They might want to do this for a lot of
+   bugs, so it would be nice to streamline the process...
+
+   In Bugzilla, it would work this way:
+    1. The Bugzilla administrator creates a flag type called “blocking2.0”
+       that shows up on all bugs in your product.
+       It shows up on the “Show Bug” screen as the text “blocking2.0” with
+       a drop-down box next to it. The drop-down box contains four values:
+       an empty space, “?”, “-”, and “+”.
+    2. The developer sets the flag to “?”.
+    3. The manager sees the blocking2.0 flag with a “?” value.
+    4. If the manager thinks the feature should go into the product before
+       version 2.0 can be released, he sets the flag to “+”. Otherwise, he
+       sets it to “-”.
+    5. Now, every Bugzilla user who looks at the bug knows whether or not
+       the bug needs to be fixed before release of version 2.0.
+
+3.8.2. About Flags
+
+3.8.2.1. Values
+
+   Flags can have three values:
+
+   ?
+          A user is requesting that a status be set. (Think of it as 'A
+          question is being asked'.)
+
+   -
+          The status has been set negatively. (The question has been
+          answered “no”.)
+
+   +
+          The status has been set positively. (The question has been
+          answered “yes”.)
+
+   Actually, there's a fourth value a flag can have -- “unset” -- which
+   shows up as a blank space. This just means that nobody has expressed an
+   opinion (or asked someone else to express an opinion) about this bug or
+   attachment.
+
+3.8.3. Using flag requests
+
+   If a flag has been defined as 'requestable', and a user has enough
+   privileges to request it (see below), the user can set the flag's
+   status to “?”. This status indicates that someone (a.k.a. “the
+   requester”) is asking someone else to set the flag to either “+” or
+   “-”.
+
+   If a flag has been defined as 'specifically requestable', a text box
+   will appear next to the flag into which the requester may enter a
+   Bugzilla username. That named person (a.k.a. “the requestee”) will
+   receive an email notifying them of the request, and pointing them to
+   the bug/attachment in question.
+
+   If a flag has not been defined as 'specifically requestable', then no
+   such text-box will appear. A request to set this flag cannot be made of
+   any specific individual, but must be asked “to the wind”. A requester
+   may “ask the wind” on any flag simply by leaving the text-box blank.
+
+3.8.4. Two Types of Flags
+
+   Flags can go in two places: on an attachment, or on a bug.
+
+3.8.4.1. Attachment Flags
+
+   Attachment flags are used to ask a question about a specific attachment
+   on a bug.
+
+   Many Bugzilla installations use this to request that one developer
+   “review” another developer's code before they check it in. They attach
+   the code to a bug report, and then set a flag on that attachment called
+   “review” to review?boss@domain.com. boss@domain.com is then notified by
+   email that he has to check out that attachment and approve it or deny
+   it.
+
+   For a Bugzilla user, attachment flags show up in three places:
+    1. On the list of attachments in the “Show Bug” screen, you can see
+       the current state of any flags that have been set to ?, +, or -.
+       You can see who asked about the flag (the requester), and who is
+       being asked (the requestee).
+    2. When you “Edit” an attachment, you can see any settable flag, along
+       with any flags that have already been set. This “Edit Attachment”
+       screen is where you set flags to ?, -, +, or unset them.
+    3. Requests are listed in the “Request Queue”, which is accessible
+       from the “My Requests” link (if you are logged in) or “Requests”
+       link (if you are logged out) visible in the footer of all pages.
+
+3.8.4.2. Bug Flags
+
+   Bug flags are used to set a status on the bug itself. You can see Bug
+   Flags in the “Show Bug” and “Requests” screens, as described above.
+
+   Only users with enough privileges (see below) may set flags on bugs.
+   This doesn't necessarily include the assignee, reporter, or users with
+   the editbugs permission.
+
+3.8.5. Administering Flags
+
+   If you have the “editcomponents” permission, you can edit Flag Types
+   from the main administration page. Clicking the “Flags” link will bring
+   you to the “Administer Flag Types” page. Here, you can select whether
+   you want to create (or edit) a Bug flag, or an Attachment flag.
+
+   No matter which you choose, the interface is the same, so we'll just go
+   over it once.
+
+3.8.5.1. Editing a Flag
+
+   To edit a flag's properties, just click the flag's name. That will take
+   you to the same form as described below (Section 3.8.5.2, “Creating a
+   Flag”).
+
+3.8.5.2. Creating a Flag
+
+   When you click on the “Create a Flag Type for...” link, you will be
+   presented with a form. Here is what the fields in the form mean:
+
+3.8.5.2.1. Name
+
+   This is the name of the flag. This will be displayed to Bugzilla users
+   who are looking at or setting the flag. The name may contain any valid
+   Unicode characters except commas and spaces.
+
+3.8.5.2.2. Description
+
+   The description describes the flag in more detail. It is visible in a
+   tooltip when hovering over a flag either in the “Show Bug” or “Edit
+   Attachment” pages. This field can be as long as you like, and can
+   contain any character you want.
+
+3.8.5.2.3. Category
+
+   Default behaviour for a newly-created flag is to appear on products and
+   all components, which is why “__Any__:__Any__” is already entered in
+   the “Inclusions” box. If this is not your desired behaviour, you must
+   either set some exclusions (for products on which you don't want the
+   flag to appear), or you must remove “__Any__:__Any__” from the
+   Inclusions box and define products/components specifically for this
+   flag.
+
+   To create an Inclusion, select a Product from the top drop-down box.
+   You may also select a specific component from the bottom drop-down box.
+   (Setting “__Any__” for Product translates to, “all the products in this
+   Bugzilla”. Selecting “__Any__” in the Component field means “all
+   components in the selected product.”) Selections made, press “Include”,
+   and your Product/Component pairing will show up in the “Inclusions” box
+   on the right.
+
+   To create an Exclusion, the process is the same; select a Product from
+   the top drop-down box, select a specific component if you want one, and
+   press “Exclude”. The Product/Component pairing will show up in the
+   “Exclusions” box on the right.
+
+   This flag will and can be set for any products/components that
+   appearing in the “Inclusions” box (or which fall under the appropriate
+   “__Any__”). This flag will not appear (and therefore cannot be set) on
+   any products appearing in the “Exclusions” box. IMPORTANT: Exclusions
+   override inclusions.
+
+   You may select a Product without selecting a specific Component, but
+   you can't select a Component without a Product, or to select a
+   Component that does not belong to the named Product. If you do so,
+   Bugzilla will display an error message, even if all your products have
+   a component by that name.
+
+   Example: Let's say you have a product called “Jet Plane” that has
+   thousands of components. You want to be able to ask if a problem should
+   be fixed in the next model of plane you release. We'll call the flag
+   “fixInNext”. But, there's one component in “Jet Plane,” called “Pilot.”
+   It doesn't make sense to release a new pilot, so you don't want to have
+   the flag show up in that component. So, you include “Jet Plane:__Any__”
+   and you exclude “Jet Plane:Pilot”.
+
+3.8.5.2.4. Sort Key
+
+   Flags normally show up in alphabetical order. If you want them to show
+   up in a different order, you can use this key set the order on each
+   flag. Flags with a lower sort key will appear before flags with a
+   higher sort key. Flags that have the same sort key will be sorted
+   alphabetically, but they will still be after flags with a lower sort
+   key, and before flags with a higher sort key.
+
+   Example: I have AFlag (Sort Key 100), BFlag (Sort Key 10), CFlag (Sort
+   Key 10), and DFlag (Sort Key 1). These show up in the order: DFlag,
+   BFlag, CFlag, AFlag.
+
+3.8.5.2.5. Active
+
+   Sometimes, you might want to keep old flag information in the Bugzilla
+   database, but stop users from setting any new flags of this type. To do
+   this, uncheck “active”. Deactivated flags will still show up in the UI
+   if they are ?, +, or -, but they may only be cleared (unset), and
+   cannot be changed to a new value. Once a deactivated flag is cleared,
+   it will completely disappear from a bug/attachment, and cannot be set
+   again.
+
+3.8.5.2.6. Requestable
+
+   New flags are, by default, “requestable”, meaning that they offer users
+   the “?” option, as well as “+” and “-”. To remove the ? option, uncheck
+   “requestable”.
+
+3.8.5.2.7. Specifically Requestable
+
+   By default this box is checked for new flags, meaning that users may
+   make flag requests of specific individuals. Unchecking this box will
+   remove the text box next to a flag; if it is still requestable, then
+   requests may only be made “to the wind.” Removing this after specific
+   requests have been made will not remove those requests; that data will
+   stay in the database (though it will no longer appear to the user).
+
+3.8.5.2.8. Multiplicable
+
+   Any flag with “Multiplicable” set (default for new flags is 'on') may
+   be set more than once. After being set once, an unset flag of the same
+   type will appear below it with “addl.” (short for “additional”) before
+   the name. There is no limit to the number of times a Multiplicable
+   flags may be set on the same bug/attachment.
+
+3.8.5.2.9. CC List
+
+   If you want certain users to be notified every time this flag is set to
+   ?, -, +, or unset, add them here. This is a comma-separated list of
+   email addresses that need not be restricted to Bugzilla usernames.
+
+3.8.5.2.10. Grant Group
+
+   When this field is set to some given group, only users in the group can
+   set the flag to “+” and “-”. This field does not affect who can request
+   or cancel the flag. For that, see the “Request Group” field below. If
+   this field is left blank, all users can set or delete this flag. This
+   field is useful for restricting which users can approve or reject
+   requests.
+
+3.8.5.2.11. Request Group
+
+   When this field is set to some given group, only users in the group can
+   request or cancel this flag. Note that this field has no effect if the
+   “grant group” field is empty. You can set the value of this field to a
+   different group, but both fields have to be set to a group for this
+   field to have an effect.
+
+3.8.5.3. Deleting a Flag
+
+   When you are at the “Administer Flag Types” screen, you will be
+   presented with a list of Bug flags and a list of Attachment Flags.
+
+   To delete a flag, click on the “Delete” link next to the flag
+   description.
+   [Warning]
+
+   Once you delete a flag, it is gone from your Bugzilla. All the data for
+   that flag will be deleted. Everywhere that flag was set, it will
+   disappear, and you cannot get that data back. If you want to keep flag
+   data, but don't want anybody to set any new flags or change current
+   flags, unset “active” in the flag Edit form.
+
+3.9. Keywords
+
+   The administrator can define keywords which can be used to tag and
+   categorise bugs. For example, the keyword "regression" is commonly
+   used. A company might have a policy stating all regressions must be
+   fixed by the next release - this keyword can make tracking those bugs
+   much easier.
+
+   Keywords are global, rather than per-product. If the administrator
+   changes a keyword currently applied to any bugs, the keyword cache must
+   be rebuilt using the Section 3.16, “Checking and Maintaining Database
+   Integrity” script. Currently keywords cannot be marked obsolete to
+   prevent future usage.
+
+   Keywords can be created, edited or deleted by clicking the "Keywords"
+   link in the admin page. There are two fields for each keyword - the
+   keyword itself and a brief description. Once created, keywords can be
+   selected and applied to individual bugs in that bug's "Details"
+   section.
+
+3.10. Custom Fields
+
+   The release of Bugzilla 3.0 added the ability to create Custom Fields.
+   Custom Fields are treated like any other field - they can be set in
+   bugs and used for search queries. Administrators should keep in mind
+   that adding too many fields can make the user interface more
+   complicated and harder to use. Custom Fields should be added only when
+   necessary and with careful consideration.
+   [Tip]
+
+   Before adding a Custom Field, make sure that Bugzilla cannot already do
+   the desired behavior. Many Bugzilla options are not enabled by default,
+   and many times Administrators find that simply enabling certain options
+   that already exist is sufficient.
+
+   Administrators can manage Custom Fields using the “Custom Fields” link
+   on the Administration page. The Custom Fields administration page
+   displays a list of Custom Fields, if any exist, and a link to "Add a
+   new custom field".
+
+3.10.1. Adding Custom Fields
+
+   To add a new Custom Field, click the "Add a new custom field" link.
+   This page displays several options for the new field, described below.
+
+   The following attributes must be set for each new custom field:
+     * Name: The name of the field in the database, used internally. This
+       name MUST begin with “cf_” to prevent confusion with standard
+       fields. If this string is omitted, it will be automatically added
+       to the name entered.
+     * Description: A brief string which is used as the label for this
+       Custom Field. That is the string that users will see, and should be
+       short and explicit.
+     * Type: The type of field to create. There are several types
+       available:
+
+        Bug ID:
+                A field where you can enter the ID of another bug from the
+                same Bugzilla installation. To point to a bug in a remote
+                installation, use the See Also field instead.
+
+        Large Text Box:
+                A multiple line box for entering free text.
+
+        Free Text:
+                A single line box for entering free text.
+
+        Multiple-Selection Box:
+                A list box where multiple options can be selected. After
+                creating this field, it must be edited to add the
+                selection options. See Section 3.11.1, “Viewing/Editing
+                legal values” for information about editing legal values.
+
+        Drop Down:
+                A list box where only one option can be selected. After
+                creating this field, it must be edited to add the
+                selection options. See Section 3.11.1, “Viewing/Editing
+                legal values” for information about editing legal values.
+
+        Date/Time:
+                A date field. This field appears with a calendar widget
+                for choosing the date.
+
+     * Sortkey: Integer that determines in which order Custom Fields are
+       displayed in the User Interface, especially when viewing a bug.
+       Fields with lower values are displayed first.
+     * Reverse Relationship Description: When the custom field is of type
+       “Bug ID”, you can enter text here which will be used as label in
+       the referenced bug to list bugs which point to it. This gives you
+       the ability to have a mutual relationship between two bugs.
+     * Can be set on bug creation: Boolean that determines whether this
+       field can be set on bug creation. If not selected, then a bug must
+       be created before this field can be set. See Section 5.6, “Filing
+       Bugs” for information about filing bugs.
+     * Displayed in bugmail for new bugs: Boolean that determines whether
+       the value set on this field should appear in bugmail when the bug
+       is filed. This attribute has no effect if the field cannot be set
+       on bug creation.
+     * Is obsolete: Boolean that determines whether this field should be
+       displayed at all. Obsolete Custom Fields are hidden.
+     * Is mandatory: Boolean that determines whether this field must be
+       set. For single and multi-select fields, this means that a
+       (non-default) value must be selected, and for text and date fields,
+       some text must be entered.
+     * Field only appears when: A custom field can be made visible when
+       some criteria is met. For instance, when the bug belongs to one or
+       more products, or when the bug is of some given severity. If left
+       empty, then the custom field will always be visible, in all bugs.
+     * Field that controls the values that appear in this field: When the
+       custom field is of type “Drop Down” or “Multiple-Selection Box”,
+       you can restrict the availability of the values of the custom field
+       based on the value of another field. This criteria is independent
+       of the criteria used in the “Field only appears when” setting. For
+       instance, you may decide that some given value “valueY” is only
+       available when the bug status is RESOLVED while the value “valueX”
+       should always be listed. Once you have selected the field which
+       should control the availability of the values of this custom field,
+       you can edit values of this custom field to set the criteria, see
+       Section 3.11.1, “Viewing/Editing legal values”.
+
+3.10.2. Editing Custom Fields
+
+   As soon as a Custom Field is created, its name and type cannot be
+   changed. If this field is a drop down menu, its legal values can be set
+   as described in Section 3.11.1, “Viewing/Editing legal values”. All
+   other attributes can be edited as described above.
+
+3.10.3. Deleting Custom Fields
+
+   Only custom fields which are marked as obsolete, and which never have
+   been used, can be deleted completely (else the integrity of the bug
+   history would be compromised). For custom fields marked as obsolete, a
+   "Delete" link will appear in the “Action” column. If the custom field
+   has been used in the past, the deletion will be rejected. But marking
+   the field as obsolete is sufficient to hide it from the user interface
+   entirely.
+
+3.11. Legal Values
+
+   Legal values for the operating system, platform, bug priority and
+   severity, custom fields of type “Drop Down” and “Multiple-Selection
+   Box” (see Section 3.10, “Custom Fields”), as well as the list of valid
+   bug statuses and resolutions can be customized from the same interface.
+   You can add, edit, disable and remove values which can be used with
+   these fields.
+
+3.11.1. Viewing/Editing legal values
+
+   Editing legal values requires “admin” privileges. Select "Field Values"
+   from the Administration page. A list of all fields, both system fields
+   and Custom Fields, for which legal values can be edited appears. Click
+   a field name to edit its legal values.
+
+   There is no limit to how many values a field can have, but each value
+   must be unique to that field. The sortkey is important to display these
+   values in the desired order.
+
+   When the availability of the values of a custom field is controlled by
+   another field, you can select from here which value of the other field
+   must be set for the value of the custom field to appear.
+
+3.11.2. Deleting legal values
+
+   Legal values from Custom Fields can be deleted, but only if the
+   following two conditions are respected:
+    1. The value is not used by default for the field.
+    2. No bug is currently using this value.
+
+   If any of these conditions is not respected, the value cannot be
+   deleted. The only way to delete these values is to reassign bugs to
+   another value and to set another value as default for the field.
+
+3.12. Bug Status Workflow
+
+   The bug status workflow is no longer hardcoded but can be freely
+   customized from the web interface. Only one bug status cannot be
+   renamed nor deleted, UNCONFIRMED, but the workflow involving it is
+   free. The configuration page displays all existing bug statuses twice,
+   first on the left for bug statuses we come from and on the top for bug
+   statuses we move to. If the checkbox is checked, then the transition
+   between the two bug statuses is legal, else it's forbidden
+   independently of your privileges. The bug status used for the
+   "duplicate_or_move_bug_status" parameter must be part of the workflow
+   as that is the bug status which will be used when duplicating or moving
+   a bug, so it must be available from each bug status.
+
+   When the workflow is set, the "View Current Triggers" link below the
+   table lets you set which transitions require a comment from the user.
+
+3.13. Voting
+
+   All of the code for voting in Bugzilla has been moved into an
+   extension, called "Voting", in the extensions/Voting/ directory. To
+   enable it, you must remove the disabled file from that directory, and
+   run checksetup.pl.
+
+   Voting allows users to be given a pot of votes which they can allocate
+   to bugs, to indicate that they'd like them fixed. This allows
+   developers to gauge user need for a particular enhancement or bugfix.
+   By allowing bugs with a certain number of votes to automatically move
+   from "UNCONFIRMED" to "CONFIRMED", users of the bug system can help
+   high-priority bugs garner attention so they don't sit for a long time
+   awaiting triage.
+
+   To modify Voting settings:
+    1. Navigate to the "Edit product" screen for the Product you wish to
+       modify
+    2. Maximum Votes per person: Setting this field to "0" disables
+       voting.
+    3. Maximum Votes a person can put on a single bug: It should probably
+       be some number lower than the "Maximum votes per person". Don't set
+       this field to "0" if "Maximum votes per person" is non-zero; that
+       doesn't make any sense.
+    4. Number of votes a bug in this product needs to automatically get
+       out of the UNCONFIRMED state: Setting this field to "0" disables
+       the automatic move of bugs from UNCONFIRMED to CONFIRMED.
+    5. Once you have adjusted the values to your preference, click
+       "Update".
+
+3.14. Quips
+
+   Quips are small text messages that can be configured to appear next to
+   search results. A Bugzilla installation can have its own specific
+   quips. Whenever a quip needs to be displayed, a random selection is
+   made from the pool of already existing quips.
+
+   Quip submission is controlled by the quip_list_entry_control parameter.
+   It has several possible values: open, moderated, or closed. In order to
+   enable quips approval you need to set this parameter to "moderated". In
+   this way, users are free to submit quips for addition but an
+   administrator must explicitly approve them before they are actually
+   used.
+
+   In order to see the user interface for the quips, it is enough to click
+   on a quip when it is displayed together with the search results. Or it
+   can be seen directly in the browser by visiting the quips.cgi URL
+   (prefixed with the usual web location of the Bugzilla installation).
+   Once the quip interface is displayed, it is enough to click the "view
+   and edit the whole quip list" in order to see the administration page.
+   A page with all the quips available in the database will be displayed.
+
+   Next to each quip there is a checkbox, under the "Approved" column.
+   Quips who have this checkbox checked are already approved and will
+   appear next to the search results. The ones that have it unchecked are
+   still preserved in the database but they will not appear on search
+   results pages. User submitted quips have initially the checkbox
+   unchecked.
+
+   Also, there is a delete link next to each quip, which can be used in
+   order to permanently delete a quip.
+
+   Display of quips is controlled by the display_quips user preference.
+   Possible values are "on" and "off".
+
+3.15. Groups and Group Security
+
+   Groups allow for separating bugs into logical divisions. Groups are
+   typically used to isolate bugs that should only be seen by certain
+   people. For example, a company might create a different group for each
+   one of its customers or partners. Group permissions could be set so
+   that each partner or customer would only have access to their own bugs.
+   Or, groups might be used to create variable access controls for
+   different departments within an organization. Another common use of
+   groups is to associate groups with products, creating isolation and
+   access control on a per-product basis.
+
+   Groups and group behaviors are controlled in several places:
+    1. The group configuration page. To view or edit existing groups, or
+       to create new groups, access the "Groups" link from the
+       "Administration" page. This section of the manual deals primarily
+       with the aspect of group controls accessed on this page.
+    2. Global configuration parameters. Bugzilla has several parameters
+       that control the overall default group behavior and restriction
+       levels. For more information on the parameters that control group
+       behavior globally, see Section 3.1.9, “Group Security”.
+    3. Product association with groups. Most of the functionality of
+       groups and group security is controlled at the product level. Some
+       aspects of group access controls for products are discussed in this
+       section, but for more detail see Section 3.4.4, “Assigning Group
+       Controls to Products”.
+    4. Group access for users. See Section 3.15.3, “Assigning Users to
+       Groups” for details on how users are assigned group access.
+
+   Group permissions are such that if a bug belongs to a group, only
+   members of that group can see the bug. If a bug is in more than one
+   group, only members of all the groups that the bug is in can see the
+   bug. For information on granting read-only access to certain people and
+   full edit access to others, see Section 3.4.4, “Assigning Group
+   Controls to Products”.
+   [Note]
+
+   By default, bugs can also be seen by the Assignee, the Reporter, and by
+   everyone on the CC List, regardless of whether or not the bug would
+   typically be viewable by them. Visibility to the Reporter and CC List
+   can be overridden (on a per-bug basis) by bringing up the bug, finding
+   the section that starts with “Users in the roles selected below...” and
+   un-checking the box next to either 'Reporter' or 'CC List' (or both).
+
+3.15.1. Creating Groups
+
+   To create a new group, follow the steps below:
+    1. Select the “Administration” link in the page footer, and then
+       select the “Groups” link from the Administration page.
+    2. A table of all the existing groups is displayed. Below the table is
+       a description of all the fields. To create a new group, select the
+       “Add Group” link under the table of existing groups.
+    3. There are five fields to fill out. These fields are documented
+       below the form. Choose a name and description for the group. Decide
+       whether this group should be used for bugs (in all likelihood this
+       should be selected). Optionally, choose a regular expression that
+       will automatically add any matching users to the group, and choose
+       an icon that will help identify user comments for the group. The
+       regular expression can be useful, for example, to automatically put
+       all users from the same company into one group (if the group is for
+       a specific customer or partner).
+
+       [Note]
+   If “User RegExp” is filled out, users whose email addresses match the
+   regular expression will automatically be members of the group as long
+   as their email addresses continue to match the regular expression. If
+   their email address changes and no longer matches the regular
+   expression, they will be removed from the group. Versions 2.16 and
+   older of Bugzilla did not automatically remove users who's email
+   addresses no longer matched the RegExp.
+
+   [Warning]
+   If specifying a domain in the regular expression, end the regexp with a
+   "$". Otherwise, when granting access to "@mycompany\.com", access will
+   also be granted to 'badperson@mycompany.com.cracker.net'. Use the
+   syntax, '@mycompany\.com$' for the regular expression.
+    4. After the new group is created, it can be edited for additional
+       options. The "Edit Group" page allows for specifying other groups
+       that should be included in this group and which groups should be
+       permitted to add and delete users from this group. For more
+       details, see Section 3.15.2, “Editing Groups and Assigning Group
+       Permissions”.
+
+3.15.2. Editing Groups and Assigning Group Permissions
+
+   To access the "Edit Groups" page, select the “Administration” link in
+   the page footer, and then select the “Groups” link from the
+   Administration page. A table of all the existing groups is displayed.
+   Click on a group name you wish to edit or control permissions for.
+
+   The "Edit Groups" page contains the same five fields present when
+   creating a new group. Below that are two additional sections, "Group
+   Permissions," and "Mass Remove". The "Mass Remove" option simply
+   removes all users from the group who match the regular expression
+   entered. The "Group Permissions" section requires further explanation.
+
+   The "Group Permissions" section on the "Edit Groups" page contains four
+   sets of permissions that control the relationship of this group to
+   other groups. If the 'usevisibilitygroups' parameter is in use (see
+   Section 3.1, “Bugzilla Configuration”) two additional sets of
+   permissions are displayed. Each set consists of two select boxes. On
+   the left, a select box with a list of all existing groups. On the
+   right, a select box listing all groups currently selected for this
+   permission setting (this box will be empty for new groups). The way
+   these controls allow groups to relate to one another is called
+   inheritance. Each of the six permissions is described below.
+
+   Groups That Are a Member of This Group
+          Members of any groups selected here will automatically have
+          membership in this group. In other words, members of any
+          selected group will inherit membership in this group.
+
+   Groups That This Group Is a Member Of
+          Members of this group will inherit membership to any group
+          selected here. For example, suppose the group being edited is an
+          Admin group. If there are two products (Product1 and Product2)
+          and each product has its own group (Group1 and Group2), and the
+          Admin group should have access to both products, simply select
+          both Group1 and Group2 here.
+
+   Groups That Can Grant Membership in This Group
+          The members of any group selected here will be able add users to
+          this group, even if they themselves are not in this group.
+
+   Groups That This Group Can Grant Membership In
+          Members of this group can add users to any group selected here,
+          even if they themselves are not in the selected groups.
+
+   Groups That Can See This Group
+          Members of any selected group can see the users in this group.
+          This setting is only visible if the 'usevisibilitygroups'
+          parameter is enabled on the Bugzilla Configuration page. See
+          Section 3.1, “Bugzilla Configuration” for information on
+          configuring Bugzilla.
+
+   Groups That This Group Can See
+          Members of this group can see members in any of the selected
+          groups. This setting is only visible if the
+          'usevisibilitygroups' parameter is enabled on the the Bugzilla
+          Configuration page. See Section 3.1, “Bugzilla Configuration”
+          for information on configuring Bugzilla.
+
+3.15.3. Assigning Users to Groups
+
+   A User can become a member of a group in several ways:
+    1. The user can be explicitly placed in the group by editing the
+       user's profile. This can be done by accessing the "Users" page from
+       the "Administration" page. Use the search form to find the user you
+       want to edit group membership for, and click on their email address
+       in the search results to edit their profile. The profile page lists
+       all the groups, and indicates if the user is a member of the group
+       either directly or indirectly. More information on indirect group
+       membership is below. For more details on User administration, see
+       Section 3.2, “User Administration”.
+    2. The group can include another group of which the user is a member.
+       This is indicated by square brackets around the checkbox next to
+       the group name in the user's profile. See Section 3.15.2, “Editing
+       Groups and Assigning Group Permissions” for details on group
+       inheritance.
+    3. The user's email address can match the regular expression that has
+       been specified to automatically grant membership to the group. This
+       is indicated by "*" around the check box by the group name in the
+       user's profile. See Section 3.15.1, “Creating Groups” for details
+       on the regular expression option when creating groups.
+
+3.15.4. Assigning Group Controls to Products
+
+   The primary functionality of groups is derived from the relationship of
+   groups to products. The concepts around segregating access to bugs with
+   product group controls can be confusing. For details and examples on
+   this topic, see Section 3.4.4, “Assigning Group Controls to Products”.
+
+3.16. Checking and Maintaining Database Integrity
+
+   Over time it is possible for the Bugzilla database to become corrupt or
+   to have anomalies. This could happen through normal usage of Bugzilla,
+   manual database administration outside of the Bugzilla user interface,
+   or from some other unexpected event. Bugzilla includes a "Sanity Check"
+   script that can perform several basic database checks, and repair
+   certain problems or inconsistencies.
+
+   To run the "Sanity Check" script, log in as an Administrator and click
+   the "Sanity Check" link in the admin page. Any problems that are found
+   will be displayed in red letters. If the script is capable of fixing a
+   problem, it will present a link to initiate the fix. If the script
+   cannot fix the problem it will require manual database administration
+   or recovery.
+
+   The "Sanity Check" script can also be run from the command line via the
+   perl script sanitycheck.pl. The script can also be run as a cron job.
+   Results will be delivered by email.
+
+   The "Sanity Check" script should be run on a regular basis as a matter
+   of best practice.
+   [Warning]
+
+   The "Sanity Check" script is no substitute for a competent database
+   administrator. It is only designed to check and repair basic database
+   problems.
+
+Chapter 4. Bugzilla Security
+
+   Table of Contents
+
+   4.1. Operating System
+
+        4.1.1. TCP/IP Ports
+        4.1.2. System User Accounts
+        4.1.3. The chroot Jail
+
+   4.2. Web server
+
+        4.2.1. Disabling Remote Access to Bugzilla Configuration Files
+
+   4.3. Bugzilla
+
+        4.3.1. Prevent users injecting malicious Javascript
+
+   While some of the items in this chapter are related to the operating
+   system Bugzilla is running on or some of the support software required
+   to run Bugzilla, it is all related to protecting your data. This is not
+   intended to be a comprehensive guide to securing Linux, Apache, MySQL,
+   or any other piece of software mentioned. There is no substitute for
+   active administration and monitoring of a machine. The key to good
+   security is actually right in the middle of the word: U R It.
+
+   While programmers in general always strive to write secure code,
+   accidents can and do happen. The best approach to security is to always
+   assume that the program you are working with isn't 100% secure and
+   restrict its access to other parts of your machine as much as possible.
+
+4.1. Operating System
+
+4.1.1. TCP/IP Ports
+
+   The TCP/IP standard defines more than 65,000 ports for sending and
+   receiving traffic. Of those, Bugzilla needs exactly one to operate
+   (different configurations and options may require up to 3). You should
+   audit your server and make sure that you aren't listening on any ports
+   you don't need to be. It's also highly recommended that the server
+   Bugzilla resides on, along with any other machines you administer, be
+   placed behind some kind of firewall.
+
+4.1.2. System User Accounts
+
+   Many daemons, such as Apache's httpd or MySQL's mysqld, run as either
+   “root” or “nobody”. This is even worse on Windows machines where the
+   majority of services run as “SYSTEM”. While running as “root” or
+   “SYSTEM” introduces obvious security concerns, the problems introduced
+   by running everything as “nobody” may not be so obvious. Basically, if
+   you run every daemon as “nobody” and one of them gets compromised it
+   can compromise every other daemon running as “nobody” on your machine.
+   For this reason, it is recommended that you create a user account for
+   each daemon.
+   [Note]
+
+   You will need to set the webservergroup option in localconfig to the
+   group your web server runs as. This will allow ./checksetup.pl to set
+   file permissions on Unix systems so that nothing is world-writable.
+
+4.1.3. The chroot Jail
+
+   If your system supports it, you may wish to consider running Bugzilla
+   inside of a chroot jail. This option provides unprecedented security by
+   restricting anything running inside the jail from accessing any
+   information outside of it. If you wish to use this option, please
+   consult the documentation that came with your system.
+
+4.2. Web server
+
+4.2.1. Disabling Remote Access to Bugzilla Configuration Files
+
+   There are many files that are placed in the Bugzilla directory area
+   that should not be accessible from the web server. Because of the way
+   Bugzilla is currently layed out, the list of what should and should not
+   be accessible is rather complicated. A quick way is to run
+   testserver.pl to check if your web server serves Bugzilla files as
+   expected. If not, you may want to follow the few steps below.
+   [Tip]
+
+   Bugzilla ships with the ability to create .htaccess files that enforce
+   these rules. Instructions for enabling these directives in Apache can
+   be found in Section 2.2.4.1, “Bugzilla using Apache”
+     * In the main Bugzilla directory, you should:
+          + Block: *.pl, *localconfig*
+     * In data:
+          + Block everything
+     * In data/webdot:
+          + If you use a remote webdot server:
+               o Block everything
+               o But allow *.dot only for the remote webdot server
+          + Otherwise, if you use a local GraphViz:
+               o Block everything
+               o But allow: *.png, *.gif, *.jpg, *.map
+          + And if you don't use any dot:
+               o Block everything
+     * In Bugzilla:
+          + Block everything
+     * In template:
+          + Block everything
+
+   Be sure to test that data that should not be accessed remotely is
+   properly blocked. Of particular interest is the localconfig file which
+   contains your database password. Also, be aware that many editors
+   create temporary and backup files in the working directory and that
+   those should also not be accessible. For more information, see bug
+   186383 or Bugtraq ID 6501. To test, simply run testserver.pl, as said
+   above.
+   [Tip]
+
+   Be sure to check Section 2.2.4, “Web server” for instructions specific
+   to the web server you use.
+
+4.3. Bugzilla
+
+4.3.1. Prevent users injecting malicious Javascript
+
+   If you installed Bugzilla version 2.22 or later from scratch, then the
+   utf8 parameter is switched on by default. This makes Bugzilla
+   explicitly set the character encoding, following a CERT advisory
+   recommending exactly this. The following therefore does not apply to
+   you; just keep utf8 turned on.
+
+   If you've upgraded from an older version, then it may be possible for a
+   Bugzilla user to take advantage of character set encoding ambiguities
+   to inject HTML into Bugzilla comments. This could include malicious
+   scripts. This is because due to internationalization concerns, we are
+   unable to turn the utf8 parameter on by default for upgraded
+   installations. Turning it on manually will prevent this problem.
+
+Chapter 5. Using Bugzilla
+
+   Table of Contents
+
+   5.1. Introduction
+   5.2. Create a Bugzilla Account
+   5.3. Anatomy of a Bug
+   5.4. Life Cycle of a Bug
+   5.5. Searching for Bugs
+
+        5.5.1. Boolean Charts
+        5.5.2. Quicksearch
+        5.5.3. Case Sensitivity in Searches
+        5.5.4. Bug Lists
+        5.5.5. Adding/removing tags to/from bugs
+
+   5.6. Filing Bugs
+
+        5.6.1. Reporting a New Bug
+        5.6.2. Clone an Existing Bug
+
+   5.7. Attachments
+
+        5.7.1. Patch Viewer
+
+   5.8. Hints and Tips
+
+        5.8.1. Autolinkification
+        5.8.2. Comments
+        5.8.3. Server-Side Comment Wrapping
+        5.8.4. Dependency Tree
+
+   5.9. Time Tracking Information
+   5.10. User Preferences
+
+        5.10.1. General Preferences
+        5.10.2. Email Preferences
+        5.10.3. Saved Searches
+        5.10.4. Name and Password
+        5.10.5. Permissions
+
+   5.11. Reports and Charts
+
+        5.11.1. Reports
+        5.11.2. Charts
+
+   5.12. Flags
+   5.13. Whining
+
+        5.13.1. The Event
+        5.13.2. Whining Schedule
+        5.13.3. Whining Searches
+        5.13.4. Saving Your Changes
+
+5.1. Introduction
+
+   This section contains information for end-users of Bugzilla. There is a
+   Bugzilla test installation, called Landfill, which you are welcome to
+   play with (if it's up). However, not all of the Bugzilla installations
+   there will necessarily have all Bugzilla features enabled, and
+   different installations run different versions, so some things may not
+   quite work as this document describes.
+
+   Frequently Asked Questions (FAQ) are available and answered on
+   wiki.mozilla.org. They may cover some questions you have which are left
+   unanswered.
+
+5.2. Create a Bugzilla Account
+
+   If you want to use Bugzilla, first you need to create an account.
+   Consult with the administrator responsible for your installation of
+   Bugzilla for the URL you should use to access it. If you're
+   test-driving Bugzilla, use this URL:
+   http://landfill.bugzilla.org/bugzilla-tip/.
+    1. On the home page index.cgi, click the “Open a new Bugzilla account”
+       link, or the “New Account” link available in the footer of pages.
+       Now enter your email address, then click the “Send” button.
+
+       [Note]
+   If none of these links is available, this means that the administrator
+   of the installation has disabled self-registration. This means that
+   only an administrator can create accounts for other users. One reason
+   could be that this installation is private.
+
+       [Note]
+   Also, if only some users are allowed to create an account on the
+   installation, you may see these links but your registration may fail if
+   your email address doesn't match the ones accepted by the installation.
+   This is another way to restrict who can access and edit bugs in this
+   installation.
+    2. Within moments, and if your registration is accepted, you should
+       receive an email to the address you provided, which contains your
+       login name (generally the same as the email address), and two URLs
+       with a token (a random string generated by the installation) to
+       confirm, respectively cancel, your registration. This is a way to
+       prevent users from abusing the generation of user accounts, for
+       instance by entering inexistent email addresses, or email addresses
+       which do not belong to them.
+    3. By default, you have 3 days to confirm your registration. Past this
+       timeframe, the token is invalidated and the registration is
+       automatically canceled. You can also cancel this registration
+       sooner by using the appropriate URL in the email you got.
+    4. If you confirm your registration, Bugzilla will ask you your real
+       name (optional, but recommended) and your password, which must be
+       between 3 and 16 characters long.
+    5. Now all you need to do is to click the “Log In” link in the footer
+       at the bottom of the page in your browser, enter your email address
+       and password you just chose into the login form, and click the “Log
+       in” button.
+
+   You are now logged in. Bugzilla uses cookies to remember you are logged
+   in so, unless you have cookies disabled or your IP address changes, you
+   should not have to log in again during your session.
+
+5.3. Anatomy of a Bug
+
+   The core of Bugzilla is the screen which displays a particular bug.
+   It's a good place to explain some Bugzilla concepts. Bug 1 on Landfill
+   is a good example. Note that the labels for most fields are hyperlinks;
+   clicking them will take you to context-sensitive help on that
+   particular field. Fields marked * may not be present on every
+   installation of Bugzilla.
+    1. Product and Component: Bugs are divided up by Product and
+       Component, with a Product having one or more Components in it. For
+       example, bugzilla.mozilla.org's "Bugzilla" Product is composed of
+       several Components:
+
+        Administration:
+                Administration of a Bugzilla installation.
+
+        Bugzilla-General:
+                Anything that doesn't fit in the other components, or
+                spans multiple components.
+
+        Creating/Changing Bugs:
+                Creating, changing, and viewing bugs.
+
+        Documentation:
+                The Bugzilla documentation, including The Bugzilla Guide.
+
+        Email:
+                Anything to do with email sent by Bugzilla.
+
+        Installation:
+                The installation process of Bugzilla.
+
+        Query/Buglist:
+                Anything to do with searching for bugs and viewing the
+                buglists.
+
+        Reporting/Charting:
+                Getting reports from Bugzilla.
+
+        User Accounts:
+                Anything about managing a user account from the user's
+                perspective. Saved queries, creating accounts, changing
+                passwords, logging in, etc.
+
+        User Interface:
+                General issues having to do with the user interface
+                cosmetics (not functionality) including cosmetic issues,
+                HTML templates, etc.
+
+    2. Status and Resolution: These define exactly what state the bug is
+       in - from not even being confirmed as a bug, through to being fixed
+       and the fix confirmed by Quality Assurance. The different possible
+       values for Status and Resolution on your installation should be
+       documented in the context-sensitive help for those items.
+    3. Assigned To: The person responsible for fixing the bug.
+    4. *QA Contact: The person responsible for quality assurance on this
+       bug.
+    5. *URL: A URL associated with the bug, if any.
+    6. Summary: A one-sentence summary of the problem.
+    7. *Status Whiteboard: (a.k.a. Whiteboard) A free-form text area for
+       adding short notes and tags to a bug.
+    8. *Keywords: The administrator can define keywords which you can use
+       to tag and categorise bugs - e.g. The Mozilla Project has keywords
+       like crash and regression.
+    9. Platform and OS: These indicate the computing environment where the
+       bug was found.
+   10. Version: The "Version" field is usually used for versions of a
+       product which have been released, and is set to indicate which
+       versions of a Component have the particular problem the bug report
+       is about.
+   11. Priority: The bug assignee uses this field to prioritize his or her
+       bugs. It's a good idea not to change this on other people's bugs.
+   12. Severity: This indicates how severe the problem is - from blocker
+       ("application unusable") to trivial ("minor cosmetic issue"). You
+       can also use this field to indicate whether a bug is an enhancement
+       request.
+   13. *Target: (a.k.a. Target Milestone) A future version by which the
+       bug is to be fixed. e.g. The Bugzilla Project's milestones for
+       future Bugzilla versions are 2.18, 2.20, 3.0, etc. Milestones are
+       not restricted to numbers, thought - you can use any text strings,
+       such as dates.
+   14. Reporter: The person who filed the bug.
+   15. CC list: A list of people who get mail when the bug changes.
+   16. *Time Tracking: This form can be used for time tracking. To use
+       this feature, you have to be blessed group membership specified by
+       the “timetrackinggroup” parameter.
+
+        Orig. Est.:
+                This field shows the original estimated time.
+
+        Current Est.:
+                This field shows the current estimated time. This number
+                is calculated from “Hours Worked” and “Hours Left”.
+
+        Hours Worked:
+                This field shows the number of hours worked.
+
+        Hours Left:
+                This field shows the “Current Est.” - “Hours Worked”. This
+                value + “Hours Worked” will become the new Current Est.
+
+        %Complete:
+                This field shows what percentage of the task is complete.
+
+        Gain:
+                This field shows the number of hours that the bug is ahead
+                of the “Orig. Est.”.
+
+        Deadline:
+                This field shows the deadline for this bug.
+
+   17. Attachments: You can attach files (e.g. testcases or patches) to
+       bugs. If there are any attachments, they are listed in this
+       section.
+   18. *Dependencies: If this bug cannot be fixed unless other bugs are
+       fixed (depends on), or this bug stops other bugs being fixed
+       (blocks), their numbers are recorded here.
+   19. *Votes: Whether this bug has any votes.
+   20. Additional Comments: You can add your two cents to the bug
+       discussion here, if you have something worthwhile to say.
+
+5.4. Life Cycle of a Bug
+
+   The life cycle of a bug, also known as workflow, is customizable to
+   match the needs of your organization, see Section 3.12, “Bug Status
+   Workflow”. Figure 5.1, “Lifecycle of a Bugzilla Bug” contains a
+   graphical representation of the default workflow using the default bug
+   statuses. If you wish to customize this image for your site, the
+   diagram file is available in Dia's native XML format.
+
+   Figure 5.1. Lifecycle of a Bugzilla Bug
+   Lifecycle of a Bugzilla Bug
+
+5.5. Searching for Bugs
+
+   The Bugzilla Search page is the interface where you can find any bug
+   report, comment, or patch currently in the Bugzilla system. You can
+   play with it here: http://landfill.bugzilla.org/bugzilla-tip/query.cgi.
+
+   The Search page has controls for selecting different possible values
+   for all of the fields in a bug, as described above. For some fields,
+   multiple values can be selected. In those cases, Bugzilla returns bugs
+   where the content of the field matches any one of the selected values.
+   If none is selected, then the field can take any value.
+
+   After a search is run, you can save it as a Saved Search, which will
+   appear in the page footer. If you are in the group defined by the
+   "querysharegroup" parameter, you may share your queries with other
+   users, see Saved Searches for more details.
+
+5.5.1. Boolean Charts
+
+   Highly advanced querying is done using Boolean Charts.
+
+   The boolean charts further restrict the set of results returned by a
+   query. It is possible to search for bugs based on elaborate
+   combinations of criteria.
+
+   The simplest boolean searches have only one term. These searches permit
+   the selected left field to be compared using a selectable operator to a
+   specified value. Using the "And," "Or," and "Add Another Boolean Chart"
+   buttons, additional terms can be included in the query, further
+   altering the list of bugs returned by the query.
+
+   There are three fields in each row of a boolean search.
+     * Field: the items being searched
+     * Operator: the comparison operator
+     * Value: the value to which the field is being compared
+
+5.5.1.1. Pronoun Substitution
+
+   Sometimes, a query needs to compare a user-related field (such as
+   ReportedBy) with a role-specific user (such as the user running the
+   query or the user to whom each bug is assigned). When the operator is
+   either "equals" or "notequals", the value can be "%reporter%",
+   "%assignee%", "%qacontact%", or "%user%". The user pronoun refers to
+   the user who is executing the query or, in the case of whining reports,
+   the user who will be the recipient of the report. The reporter,
+   assignee, and qacontact pronouns refer to the corresponding fields in
+   the bug.
+
+   Boolean charts also let you type a group name in any user-related field
+   if the operator is either "equals", "notequals" or "anyexact". This
+   will let you query for any member belonging (or not) to the specified
+   group. The group name must be entered following the "%group.foo%"
+   syntax, where "foo" is the group name. So if you are looking for bugs
+   reported by any user being in the "editbugs" group, then you can type
+   "%group.editbugs%".
+
+5.5.1.2. Negation
+
+   At first glance, negation seems redundant. Rather than searching for
+
+     NOT("summary" "contains the string" "foo"),
+
+   one could search for
+
+     ("summary" "does not contain the string" "foo").
+
+   However, the search
+
+     ("CC" "does not contain the string" "@mozilla.org")
+
+   would find every bug where anyone on the CC list did not contain
+   "@mozilla.org" while
+
+     NOT("CC" "contains the string" "@mozilla.org")
+
+   would find every bug where there was nobody on the CC list who did
+   contain the string. Similarly, the use of negation also permits complex
+   expressions to be built using terms OR'd together and then negated.
+   Negation permits queries such as
+
+     NOT(("product" "equals" "update") OR ("component" "equals"
+     "Documentation"))
+
+   to find bugs that are neither in the update product or in the
+   documentation component or
+
+     NOT(("commenter" "equals" "%assignee%") OR ("component" "equals"
+     "Documentation"))
+
+   to find non-documentation bugs on which the assignee has never
+   commented.
+
+5.5.1.3. Multiple Charts
+
+   The terms within a single row of a boolean chart are all constraints on
+   a single piece of data. If you are looking for a bug that has two
+   different people cc'd on it, then you need to use two boolean charts. A
+   search for
+
+     ("cc" "contains the string" "foo@") AND ("cc" "contains the string"
+     "@mozilla.org")
+
+   would return only bugs with "foo@mozilla.org" on the cc list. If you
+   wanted bugs where there is someone on the cc list containing "foo@" and
+   someone else containing "@mozilla.org", then you would need two boolean
+   charts.
+
+     First chart: ("cc" "contains the string" "foo@")
+
+     Second chart: ("cc" "contains the string" "@mozilla.org")
+
+   The bugs listed will be only the bugs where ALL the charts are true.
+
+5.5.2. Quicksearch
+
+   Quicksearch is a single-text-box query tool which uses metacharacters
+   to indicate what is to be searched. For example, typing "foo|bar" into
+   Quicksearch would search for "foo" or "bar" in the summary and status
+   whiteboard of a bug; adding ":BazProduct" would search only in that
+   product. You can use it to find a bug by its number or its alias, too.
+
+   You'll find the Quicksearch box in Bugzilla's footer area. On
+   Bugzilla's front page, there is an additional Help link which details
+   how to use it.
+
+5.5.3. Case Sensitivity in Searches
+
+   Bugzilla queries are case-insensitive and accent-insensitive, when used
+   with either MySQL or Oracle databases. When using Bugzilla with
+   PostgreSQL, however, some queries are case-sensitive. This is due to
+   the way PostgreSQL handles case and accent sensitivity.
+
+5.5.4. Bug Lists
+
+   If you run a search, a list of matching bugs will be returned.
+
+   The format of the list is configurable. For example, it can be sorted
+   by clicking the column headings. Other useful features can be accessed
+   using the links at the bottom of the list:
+
+   Long Format:
+          this gives you a large page with a non-editable summary of the
+          fields of each bug.
+
+   XML:
+          get the buglist in the XML format.
+
+   CSV:
+          get the buglist as comma-separated values, for import into e.g.
+          a spreadsheet.
+
+   Feed:
+          get the buglist as an Atom feed. Copy this link into your
+          favorite feed reader. If you are using Firefox, you can also
+          save the list as a live bookmark by clicking the live bookmark
+          icon in the status bar. To limit the number of bugs in the feed,
+          add a limit=n parameter to the URL.
+
+   iCalendar:
+          Get the buglist as an iCalendar file. Each bug is represented as
+          a to-do item in the imported calendar.
+
+   Change Columns:
+          change the bug attributes which appear in the list.
+
+   Change several bugs at once:
+          If your account is sufficiently empowered, and more than one bug
+          appear in the bug list, this link is displayed which lets you
+          make the same change to all the bugs in the list - for example,
+          changing their assignee.
+
+   Send mail to bug assignees:
+          If more than one bug appear in the bug list and there are at
+          least two distinct bug assignees, this links is displayed which
+          lets you easily send a mail to the assignees of all bugs on the
+          list.
+
+   Edit Search:
+          If you didn't get exactly the results you were looking for, you
+          can return to the Query page through this link and make small
+          revisions to the query you just made so you get more accurate
+          results.
+
+   Remember Search As:
+          You can give a search a name and remember it; a link will appear
+          in your page footer giving you quick access to run it again
+          later.
+
+5.5.5. Adding/removing tags to/from bugs
+
+   You can add and remove tags from individual bugs, which let you find
+   and manage bugs more easily. Tags are per-user and so are only visible
+   and editable by the user who created them. You can then run queries
+   using tags as a criteria, either by using the Advanced Search form, or
+   simply by typing "tag:my_tag_name" in the QuickSearch box at the top
+   (or bottom) of the page. Tags can also be displayed in buglists.
+
+   This feature is useful when you want to keep track of several bugs, but
+   for different reasons. Instead of adding yourself to the CC list of all
+   these bugs and mixing all these reasons, you can now store these bugs
+   in separate lists, e.g. “Keep in mind”, “Interesting bugs”, or
+   “Triage”. One big advantage of this way to manage bugs is that you can
+   easily add or remove tags from bugs one by one.
+
+5.6. Filing Bugs
+
+5.6.1. Reporting a New Bug
+
+   Years of bug writing experience has been distilled for your reading
+   pleasure into the Bug Writing Guidelines. While some of the advice is
+   Mozilla-specific, the basic principles of reporting Reproducible,
+   Specific bugs, isolating the Product you are using, the Version of the
+   Product, the Component which failed, the Hardware Platform, and
+   Operating System you were using at the time of the failure go a long
+   way toward ensuring accurate, responsible fixes for the bug that bit
+   you.
+
+   The procedure for filing a bug is as follows:
+    1. Click the “New” link available in the footer of pages, or the
+       “Enter a new bug report” link displayed on the home page of the
+       Bugzilla installation.
+
+       [Note]
+   If you want to file a test bug to see how Bugzilla works, you can do it
+   on one of our test installations on Landfill.
+    2. You first have to select the product in which you found a bug.
+    3. You now see a form where you can specify the component (part of the
+       product which is affected by the bug you discovered; if you have no
+       idea, just select “General” if such a component exists), the
+       version of the program you were using, the Operating System and
+       platform your program is running on and the severity of the bug (if
+       the bug you found crashes the program, it's probably a major or a
+       critical bug; if it's a typo somewhere, that's something pretty
+       minor; if it's something you would like to see implemented, then
+       that's an enhancement).
+    4. You now have to give a short but descriptive summary of the bug you
+       found. “My program is crashing all the time” is a very poor summary
+       and doesn't help developers at all. Try something more meaningful
+       or your bug will probably be ignored due to a lack of precision.
+       The next step is to give a very detailed list of steps to reproduce
+       the problem you encountered. Try to limit these steps to a minimum
+       set required to reproduce the problem. This will make the life of
+       developers easier, and the probability that they consider your bug
+       in a reasonable timeframe will be much higher.
+
+       [Note]
+   Try to make sure that everything in the summary is also in the first
+   comment. Summaries are often updated and this will ensure your original
+   information is easily accessible.
+    5. As you file the bug, you can also attach a document (testcase,
+       patch, or screenshot of the problem).
+    6. Depending on the Bugzilla installation you are using and the
+       product in which you are filing the bug, you can also request
+       developers to consider your bug in different ways (such as
+       requesting review for the patch you just attached, requesting your
+       bug to block the next release of the product, and many other
+       product specific requests).
+    7. Now is a good time to read your bug report again. Remove all
+       misspellings, otherwise your bug may not be found by developers
+       running queries for some specific words, and so your bug would not
+       get any attention. Also make sure you didn't forget any important
+       information developers should know in order to reproduce the
+       problem, and make sure your description of the problem is explicit
+       and clear enough. When you think your bug report is ready to go,
+       the last step is to click the “Commit” button to add your report
+       into the database.
+
+   You do not need to put "any" or similar strings in the URL field. If
+   there is no specific URL associated with the bug, leave this field
+   blank.
+
+   If you feel a bug you filed was incorrectly marked as a DUPLICATE of
+   another, please question it in your bug, not the bug it was duped to.
+   Feel free to CC the person who duped it if they are not already CCed.
+
+5.6.2. Clone an Existing Bug
+
+   Starting with version 2.20, Bugzilla has a feature that allows you to
+   clone an existing bug. The newly created bug will inherit most settings
+   from the old bug. This allows you to track more easily similar concerns
+   in a new bug. To use this, go to the bug that you want to clone, then
+   click the “Clone This Bug” link on the bug page. This will take you to
+   the “Enter Bug” page that is filled with the values that the old bug
+   has. You can change those values and/or texts if needed.
+
+5.7. Attachments
+
+   You should use attachments, rather than comments, for large chunks of
+   ASCII data, such as trace, debugging output files, or log files. That
+   way, it doesn't bloat the bug for everyone who wants to read it, and
+   cause people to receive fat, useless mails.
+
+   You should make sure to trim screenshots. There's no need to show the
+   whole screen if you are pointing out a single-pixel problem.
+
+   Bugzilla stores and uses a Content-Type for each attachment (e.g.
+   text/html). To download an attachment as a different Content-Type (e.g.
+   application/xhtml+xml), you can override this using a 'content_type'
+   parameter on the URL, e.g. &content_type=text/plain.
+
+   Also, you can enter the URL pointing to the attachment instead of
+   uploading the attachment itself. For example, this is useful if you
+   want to point to an external application, a website or a very large
+   file. Note that there is no guarantee that the source file will always
+   be available, nor that its content will remain unchanged.
+
+   Another way to attach data is to paste text directly in the text field,
+   and Bugzilla will convert it into an attachment. This is pretty useful
+   when you do copy and paste, and you don't want to put the text in a
+   temporary file first.
+
+5.7.1. Patch Viewer
+
+   Viewing and reviewing patches in Bugzilla is often difficult due to
+   lack of context, improper format and the inherent readability issues
+   that raw patches present. Patch Viewer is an enhancement to Bugzilla
+   designed to fix that by offering increased context, linking to
+   sections, and integrating with Bonsai, LXR and CVS.
+
+   Patch viewer allows you to:
+   View patches in color, with side-by-side view rather than trying to
+   interpret the contents of the patch.
+   See the difference between two patches.
+   Get more context in a patch.
+   Collapse and expand sections of a patch for easy reading.
+   Link to a particular section of a patch for discussion or review
+   Go to Bonsai or LXR to see more context, blame, and cross-references
+   for the part of the patch you are looking at
+   Create a rawtext unified format diff out of any patch, no matter what
+   format it came from
+
+5.7.1.1. Viewing Patches in Patch Viewer
+
+   The main way to view a patch in patch viewer is to click on the "Diff"
+   link next to a patch in the Attachments list on a bug. You may also do
+   this within the edit window by clicking the "View Attachment As Diff"
+   button in the Edit Attachment screen.
+
+5.7.1.2. Seeing the Difference Between Two Patches
+
+   To see the difference between two patches, you must first view the
+   newer patch in Patch Viewer. Then select the older patch from the
+   dropdown at the top of the page ("Differences between [dropdown] and
+   this patch") and click the "Diff" button. This will show you what is
+   new or changed in the newer patch.
+
+5.7.1.3. Getting More Context in a Patch
+
+   To get more context in a patch, you put a number in the textbox at the
+   top of Patch Viewer ("Patch / File / [textbox]") and hit enter. This
+   will give you that many lines of context before and after each change.
+   Alternatively, you can click on the "File" link there and it will show
+   each change in the full context of the file. This feature only works
+   against files that were diffed using "cvs diff".
+
+5.7.1.4. Collapsing and Expanding Sections of a Patch
+
+   To view only a certain set of files in a patch (for example, if a patch
+   is absolutely huge and you want to only review part of it at a time),
+   you can click the "(+)" and "(-)" links next to each file (to expand it
+   or collapse it). If you want to collapse all files or expand all files,
+   you can click the "Collapse All" and "Expand All" links at the top of
+   the page.
+
+5.7.1.5. Linking to a Section of a Patch
+
+   To link to a section of a patch (for example, if you want to be able to
+   give someone a URL to show them which part you are talking about) you
+   simply click the "Link Here" link on the section header. The resulting
+   URL can be copied and used in discussion.
+
+5.7.1.6. Going to Bonsai and LXR
+
+   To go to Bonsai to get blame for the lines you are interested in, you
+   can click the "Lines XX-YY" link on the section header you are
+   interested in. This works even if the patch is against an old version
+   of the file, since Bonsai stores all versions of the file.
+
+   To go to LXR, you click on the filename on the file header
+   (unfortunately, since LXR only does the most recent version, line
+   numbers are likely to rot).
+
+5.7.1.7. Creating a Unified Diff
+
+   If the patch is not in a format that you like, you can turn it into a
+   unified diff format by clicking the "Raw Unified" link at the top of
+   the page.
+
+5.8. Hints and Tips
+
+   This section distills some Bugzilla tips and best practices that have
+   been developed.
+
+5.8.1. Autolinkification
+
+   Bugzilla comments are plain text - so typing <U> will produce
+   less-than, U, greater-than rather than underlined text. However,
+   Bugzilla will automatically make hyperlinks out of certain sorts of
+   text in comments. For example, the text "http://www.bugzilla.org" will
+   be turned into a link: http://www.bugzilla.org. Other strings which get
+   linkified in the obvious manner are:
+   bug 12345
+   comment 7
+   bug 23456, comment 53
+   attachment 4321
+   mailto:george@example.com
+   george@example.com
+   ftp://ftp.mozilla.org
+   Most other sorts of URL
+
+   A corollary here is that if you type a bug number in a comment, you
+   should put the word "bug" before it, so it gets autolinkified for the
+   convenience of others.
+
+5.8.2. Comments
+
+   If you are changing the fields on a bug, only comment if either you
+   have something pertinent to say, or Bugzilla requires it. Otherwise,
+   you may spam people unnecessarily with bug mail. To take an example: a
+   user can set up their account to filter out messages where someone just
+   adds themselves to the CC field of a bug (which happens a lot.) If you
+   come along, add yourself to the CC field, and add a comment saying
+   "Adding self to CC", then that person gets a pointless piece of mail
+   they would otherwise have avoided.
+
+   Don't use sigs in comments. Signing your name ("Bill") is acceptable,
+   if you do it out of habit, but full mail/news-style four line ASCII art
+   creations are not.
+
+5.8.3. Server-Side Comment Wrapping
+
+   Bugzilla stores comments unwrapped and wraps them at display time. This
+   ensures proper wrapping in all browsers. Lines beginning with the ">"
+   character are assumed to be quotes, and are not wrapped.
+
+5.8.4. Dependency Tree
+
+   On the “Dependency tree” page linked from each bug page, you can see
+   the dependency relationship from the bug as a tree structure.
+
+   You can change how much depth to show, and you can hide resolved bugs
+   from this page. You can also collaps/expand dependencies for each bug
+   on the tree view, using the [-]/[+] buttons that appear before its
+   summary. This option is not available for terminal bugs in the tree
+   (that don't have further dependencies).
+
+5.9. Time Tracking Information
+
+   Users who belong to the group specified by the “timetrackinggroup”
+   parameter have access to time-related fields. Developers can see
+   deadlines and estimated times to fix bugs, and can provide time spent
+   on these bugs.
+
+   At any time, a summary of the time spent by developers on bugs is
+   accessible either from bug lists when clicking the “Time Summary”
+   button or from individual bugs when clicking the “Summarize time” link
+   in the time tracking table. The summarize_time.cgi page lets you view
+   this information either per developer or per bug, and can be split on a
+   month basis to have greater details on how time is spent by developers.
+
+   As soon as a bug is marked as RESOLVED, the remaining time expected to
+   fix the bug is set to zero. This lets QA people set it again for their
+   own usage, and it will be set to zero again when the bug will be marked
+   as CLOSED.
+
+5.10. User Preferences
+
+   Once logged in, you can customize various aspects of Bugzilla via the
+   "Preferences" link in the page footer. The preferences are split into
+   five tabs:
+
+5.10.1. General Preferences
+
+   This tab allows you to change several default settings of Bugzilla.
+     * Bugzilla's general appearance (skin) - select which skin to use.
+       Bugzilla supports adding custom skins.
+     * Quote the associated comment when you click on its reply link -
+       sets the behavior of the comment "Reply" link. Options include
+       quoting the full comment, just reference the comment number, or
+       turn the link off.
+     * Language used in email - select which language email will be sent
+       in, from the list of available languages.
+     * After changing a bug - This controls what page is displayed after
+       changes to a bug are submitted. The options include to show the bug
+       just modified, to show the next bug in your list, or to do nothing.
+     * Enable tags for bugs - turn bug tagging on or off.
+     * Zoom textareas large when in use (requires JavaScript) - enable or
+       disable the automatic expanding of text areas when text is being
+       entered into them.
+     * Field separator character for CSV files - Select between a comma
+       and semi-colon for exported CSV bug lists.
+     * Automatically add me to the CC list of bugs I change - set default
+       behavior of CC list. Options include "Always", "Never", and "Only
+       if I have no role on them".
+     * When viewing a bug, show comments in this order - controls the
+       order of comments. Options include "Oldest to Newest", "Newest to
+       Oldest" and "Newest to Oldest, but keep the bug description at the
+       top".
+     * Show a quip at the top of each bug list - controls whether a quip
+       will be shown on the Bug list page.
+
+5.10.2. Email Preferences
+
+   This tab allows you to enable or disable email notification on specific
+   events.
+
+   In general, users have almost complete control over how much (or how
+   little) email Bugzilla sends them. If you want to receive the maximum
+   amount of email possible, click the “Enable All Mail” button. If you
+   don't want to receive any email from Bugzilla at all, click the
+   “Disable All Mail” button.
+   [Note]
+
+   A Bugzilla administrator can stop a user from receiving bugmail by
+   clicking the “Bugmail Disabled” checkbox when editing the user account.
+   This is a drastic step best taken only for disabled accounts, as it
+   overrides the user's individual mail preferences.
+
+   There are two global options -- “Email me when someone asks me to set a
+   flag” and “Email me when someone sets a flag I asked for”. These define
+   how you want to receive bugmail with regards to flags. Their use is
+   quite straightforward; enable the checkboxes if you want Bugzilla to
+   send you mail under either of the above conditions.
+
+   If you'd like to set your bugmail to something besides 'Completely ON'
+   and 'Completely OFF', the “Field/recipient specific options” table
+   allows you to do just that. The rows of the table define events that
+   can happen to a bug -- things like attachments being added, new
+   comments being made, the priority changing, etc. The columns in the
+   table define your relationship with the bug:
+     * Reporter - Where you are the person who initially reported the bug.
+       Your name/account appears in the “Reporter:” field.
+     * Assignee - Where you are the person who has been designated as the
+       one responsible for the bug. Your name/account appears in the
+       “Assigned To:” field of the bug.
+     * QA Contact - You are one of the designated QA Contacts for the bug.
+       Your account appears in the “QA Contact:” text-box of the bug.
+     * CC - You are on the list CC List for the bug. Your account appears
+       in the “CC:” text box of the bug.
+     * Voter - You have placed one or more votes for the bug. Your account
+       appears only if someone clicks on the “Show votes for this bug”
+       link on the bug.
+
+   [Note]
+
+   Some columns may not be visible for your installation, depending on
+   your site's configuration.
+
+   To fine-tune your bugmail, decide the events for which you want to
+   receive bugmail; then decide if you want to receive it all the time
+   (enable the checkbox for every column), or only when you have a certain
+   relationship with a bug (enable the checkbox only for those columns).
+   For example: if you didn't want to receive mail when someone added
+   themselves to the CC list, you could uncheck all the boxes in the “CC
+   Field Changes” line. As another example, if you never wanted to receive
+   email on bugs you reported unless the bug was resolved, you would
+   un-check all boxes in the “Reporter” column except for the one on the
+   “The bug is resolved or verified” row.
+   [Note]
+
+   Bugzilla adds the “X-Bugzilla-Reason” header to all bugmail it sends,
+   describing the recipient's relationship (AssignedTo, Reporter,
+   QAContact, CC, or Voter) to the bug. This header can be used to do
+   further client-side filtering.
+
+   Bugzilla has a feature called “Users Watching”. When you enter one or
+   more comma-delineated user accounts (usually email addresses) into the
+   text entry box, you will receive a copy of all the bugmail those users
+   are sent (security settings permitting). This powerful functionality
+   enables seamless transitions as developers change projects or users go
+   on holiday.
+   [Note]
+
+   The ability to watch other users may not be available in all Bugzilla
+   installations. If you don't see this feature, and feel that you need
+   it, speak to your administrator.
+
+   Each user listed in the “Users watching you” field has you listed in
+   their “Users to watch” list and can get bugmail according to your
+   relationship to the bug and their “Field/recipient specific options”
+   setting.
+
+5.10.3. Saved Searches
+
+   On this tab you can view and run any Saved Searches that you have
+   created, and also any Saved Searches that other members of the group
+   defined in the "querysharegroup" parameter have shared. Saved Searches
+   can be added to the page footer from this screen. If somebody is
+   sharing a Search with a group she or he is allowed to assign users to,
+   the sharer may opt to have the Search show up in the footer of the
+   group's direct members by default.
+
+5.10.4. Name and Password
+
+   On this tab, you can change your basic account information, including
+   your password, email address and real name. For security reasons, in
+   order to change anything on this page you must type your current
+   password into the “Password” field at the top of the page. If you
+   attempt to change your email address, a confirmation email is sent to
+   both the old and new addresses, with a link to use to confirm the
+   change. This helps to prevent account hijacking.
+
+5.10.5. Permissions
+
+   This is a purely informative page which outlines your current
+   permissions on this installation of Bugzilla.
+
+   A complete list of permissions is below. Only users with editusers
+   privileges can change the permissions of other users.
+
+   admin
+          Indicates user is an Administrator.
+
+   bz_canusewhineatothers
+          Indicates user can configure whine reports for other users.
+
+   bz_canusewhines
+          Indicates user can configure whine reports for self.
+
+   bz_quip_moderators
+          Indicates user can moderate quips.
+
+   bz_sudoers
+          Indicates user can perform actions as other users.
+
+   bz_sudo_protect
+          Indicates user cannot be impersonated by other users.
+
+   canconfirm
+          Indicates user can confirm a bug or mark it a duplicate.
+
+   creategroups
+          Indicates user can create and destroy groups.
+
+   editbugs
+          Indicates user can edit all bug fields.
+
+   editclassifications
+          Indicates user can create, destroy, and edit classifications.
+
+   editcomponents
+          Indicates user can create, destroy, and edit components.
+
+   editkeywords
+          Indicates user can create, destroy, and edit keywords.
+
+   editusers
+          Indicates user can edit or disable users.
+
+   tweakparams
+          Indicates user can change Parameters.
+
+   [Note]
+
+   For more information on how permissions work in Bugzilla (i.e. who can
+   change what), see Section 6.4, “Customizing Who Can Change What”.
+
+5.11. Reports and Charts
+
+   As well as the standard buglist, Bugzilla has two more ways of viewing
+   sets of bugs. These are the reports (which give different views of the
+   current state of the database) and charts (which plot the changes in
+   particular sets of bugs over time.)
+
+5.11.1. Reports
+
+   A report is a view of the current state of the bug database.
+
+   You can run either an HTML-table-based report, or a graphical
+   line/pie/bar-chart-based one. The two have different pages to define
+   them, but are close cousins - once you've defined and viewed a report,
+   you can switch between any of the different views of the data at will.
+
+   Both report types are based on the idea of defining a set of bugs using
+   the standard search interface, and then choosing some aspect of that
+   set to plot on the horizontal and/or vertical axes. You can also get a
+   form of 3-dimensional report by choosing to have multiple images or
+   tables.
+
+   So, for example, you could use the search form to choose "all bugs in
+   the WorldControl product", and then plot their severity against their
+   component to see which component had had the largest number of bad bugs
+   reported against it.
+
+   Once you've defined your parameters and hit "Generate Report", you can
+   switch between HTML, CSV, Bar, Line and Pie. (Note: Pie is only
+   available if you didn't define a vertical axis, as pie charts don't
+   have one.) The other controls are fairly self-explanatory; you can
+   change the size of the image if you find text is overwriting other
+   text, or the bars are too thin to see.
+
+5.11.2. Charts
+
+   A chart is a view of the state of the bug database over time.
+
+   Bugzilla currently has two charting systems - Old Charts and New
+   Charts. Old Charts have been part of Bugzilla for a long time; they
+   chart each status and resolution for each product, and that's all. They
+   are deprecated, and going away soon - we won't say any more about them.
+   New Charts are the future - they allow you to chart anything you can
+   define as a search.
+   [Note]
+
+   Both charting forms require the administrator to set up the
+   data-gathering script. If you can't see any charts, ask them whether
+   they have done so.
+
+   An individual line on a chart is called a data set. All data sets are
+   organised into categories and subcategories. The data sets that
+   Bugzilla defines automatically use the Product name as a Category and
+   Component names as Subcategories, but there is no need for you to
+   follow that naming scheme with your own charts if you don't want to.
+
+   Data sets may be public or private. Everyone sees public data sets in
+   the list, but only their creator sees private data sets. Only
+   administrators can make data sets public. No two data sets, even two
+   private ones, can have the same set of category, subcategory and name.
+   So if you are creating private data sets, one idea is to have the
+   Category be your username.
+
+5.11.2.1. Creating Charts
+
+   You create a chart by selecting a number of data sets from the list,
+   and pressing Add To List for each. In the List Of Data Sets To Plot,
+   you can define the label that data set will have in the chart's legend,
+   and also ask Bugzilla to Sum a number of data sets (e.g. you could Sum
+   data sets representing RESOLVED, VERIFIED and CLOSED in a particular
+   product to get a data set representing all the resolved bugs in that
+   product.)
+
+   If you've erroneously added a data set to the list, select it using the
+   checkbox and click Remove. Once you add more than one data set, a
+   "Grand Total" line automatically appears at the bottom of the list. If
+   you don't want this, simply remove it as you would remove any other
+   line.
+
+   You may also choose to plot only over a certain date range, and to
+   cumulate the results - that is, to plot each one using the previous one
+   as a baseline, so the top line gives a sum of all the data sets. It's
+   easier to try than to explain :-)
+
+   Once a data set is in the list, one can also perform certain actions on
+   it. For example, one can edit the data set's parameters (name,
+   frequency etc.) if it's one you created or if you are an administrator.
+
+   Once you are happy, click Chart This List to see the chart.
+
+5.11.2.2. Creating New Data Sets
+
+   You may also create new data sets of your own. To do this, click the
+   "create a new data set" link on the Create Chart page. This takes you
+   to a search-like interface where you can define the search that
+   Bugzilla will plot. At the bottom of the page, you choose the category,
+   sub-category and name of your new data set.
+
+   If you have sufficient permissions, you can make the data set public,
+   and reduce the frequency of data collection to less than the default
+   seven days.
+
+5.12. Flags
+
+   A flag is a kind of status that can be set on bugs or attachments to
+   indicate that the bugs/attachments are in a certain state. Each
+   installation can define its own set of flags that can be set on bugs or
+   attachments.
+
+   If your installation has defined a flag, you can set or unset that
+   flag, and if your administrator has enabled requesting of flags, you
+   can submit a request for another user to set the flag.
+
+   To set a flag, select either "+" or "-" from the drop-down menu next to
+   the name of the flag in the "Flags" list. The meaning of these values
+   are flag-specific and thus cannot be described in this documentation,
+   but by way of example, setting a flag named "review" to "+" may
+   indicate that the bug/attachment has passed review, while setting it to
+   "-" may indicate that the bug/attachment has failed review.
+
+   To unset a flag, click its drop-down menu and select the blank value.
+   Note that marking an attachment as obsolete automatically cancels all
+   pending requests for the attachment.
+
+   If your administrator has enabled requests for a flag, request a flag
+   by selecting "?" from the drop-down menu and then entering the username
+   of the user you want to set the flag in the text field next to the
+   menu.
+
+   A set flag appears in bug reports and on "edit attachment" pages with
+   the abbreviated username of the user who set the flag prepended to the
+   flag name. For example, if Jack sets a "review" flag to "+", it appears
+   as Jack: review [ + ]
+
+   A requested flag appears with the user who requested the flag prepended
+   to the flag name and the user who has been requested to set the flag
+   appended to the flag name within parentheses. For example, if Jack asks
+   Jill for review, it appears as Jack: review [ ? ] (Jill).
+
+   You can browse through open requests made of you and by you by
+   selecting 'My Requests' from the footer. You can also look at open
+   requests limited by other requesters, requestees, products, components,
+   and flag names from this page. Note that you can use '-' for requestee
+   to specify flags with 'no requestee' set.
+
+5.13. Whining
+
+   Whining is a feature in Bugzilla that can regularly annoy users at
+   specified times. Using this feature, users can execute saved searches
+   at specific times (i.e. the 15th of the month at midnight) or at
+   regular intervals (i.e. every 15 minutes on Sundays). The results of
+   the searches are sent to the user, either as a single email or as one
+   email per bug, along with some descriptive text.
+   [Warning]
+
+   Throughout this section it will be assumed that all users are members
+   of the bz_canusewhines group, membership in which is required in order
+   to use the Whining system. You can easily make all users members of the
+   bz_canusewhines group by setting the User RegExp to ".*" (without the
+   quotes).
+
+   Also worth noting is the bz_canusewhineatothers group. Members of this
+   group can create whines for any user or group in Bugzilla using a
+   extended form of the whining interface. Features only available to
+   members of the bz_canusewhineatothers group will be noted in the
+   appropriate places.
+   [Note]
+
+   For whining to work, a special Perl script must be executed at regular
+   intervals. More information on this is available in Section 2.3.3,
+   “Whining”.
+   [Note]
+
+   This section does not cover the whineatnews.pl script. See
+   Section 2.3.2, “The Whining Cron” for more information on The Whining
+   Cron.
+
+5.13.1. The Event
+
+   The whining system defines an "Event" as one or more queries being
+   executed at regular intervals, with the results of said queries (if
+   there are any) being emailed to the user. Events are created by
+   clicking on the "Add new event" button.
+
+   Once a new event is created, the first thing to set is the "Email
+   subject line". The contents of this field will be used in the subject
+   line of every email generated by this event. In addition to setting a
+   subject, space is provided to enter some descriptive text that will be
+   included at the top of each message (to help you in understanding why
+   you received the email in the first place).
+
+   The next step is to specify when the Event is to be run (the Schedule)
+   and what searches are to be performed (the Searches).
+
+5.13.2. Whining Schedule
+
+   Each whining event is associated with zero or more schedules. A
+   schedule is used to specify when the query (specified below) is to be
+   run. A new event starts out with no schedules (which means it will
+   never run, as it is not scheduled to run). To add a schedule, press the
+   "Add a new schedule" button.
+
+   Each schedule includes an interval, which you use to tell Bugzilla when
+   the event should be run. An event can be run on certain days of the
+   week, certain days of the month, during weekdays (defined as Monday
+   through Friday), or every day.
+   [Warning]
+
+   Be careful if you set your event to run on the 29th, 30th, or 31st of
+   the month, as your event may not run exactly when expected. If you want
+   your event to run on the last day of the month, select "Last day of the
+   month" as the interval.
+
+   Once you have specified the day(s) on which the event is to be run, you
+   should now specify the time at which the event is to be run. You can
+   have the event run at a certain hour on the specified day(s), or every
+   hour, half-hour, or quarter-hour on the specified day(s).
+
+   If a single schedule does not execute an event as many times as you
+   would want, you can create another schedule for the same event. For
+   example, if you want to run an event on days whose numbers are
+   divisible by seven, you would need to add four schedules to the event,
+   setting the schedules to run on the 7th, 14th, 21st, and 28th (one day
+   per schedule) at whatever time (or times) you choose.
+   [Note]
+
+   If you are a member of the bz_canusewhineatothers group, then you will
+   be presented with another option: "Mail to". Using this you can control
+   who will receive the emails generated by this event. You can choose to
+   send the emails to a single user (identified by email address) or a
+   single group (identified by group name). To send to multiple users or
+   groups, create a new schedule for each additional user/group.
+
+5.13.3. Whining Searches
+
+   Each whining event is associated with zero or more searches. A search
+   is any saved search to be run as part of the specified schedule (see
+   above). You start out without any searches associated with the event
+   (which means that the event will not run, as there will never be any
+   results to return). To add a search, press the "Include search" button.
+
+   The first field to examine in your newly added search is the Sort
+   field. Searches are run, and results included, in the order specified
+   by the Sort field. Searches with smaller Sort values will run before
+   searches with bigger Sort values.
+
+   The next field to examine is the Search field. This is where you choose
+   the actual search that is to be run. Instead of defining search
+   parameters here, you are asked to choose from the list of saved
+   searches (the same list that appears at the bottom of every Bugzilla
+   page). You are only allowed to choose from searches that you have saved
+   yourself (the default saved search, "My Bugs", is not a valid choice).
+   If you do not have any saved searches, you can take this opportunity to
+   create one (see Section 5.5.4, “Bug Lists”).
+   [Note]
+
+   When running queries, the whining system acts as if you are the user
+   executing the query. This means that the whining system will ignore
+   bugs that match your query, but that you cannot access.
+
+   Once you have chosen the saved search to be executed, give the query a
+   descriptive title. This title will appear in the email, above the
+   results of the query. If you choose "One message per bug", the query
+   title will appear at the top of each email that contains a bug matching
+   your query.
+
+   Finally, decide if the results of the query should be sent in a single
+   email, or if each bug should appear in its own email.
+   [Warning]
+
+   Think carefully before checking the "One message per bug" box. If you
+   create a query that matches thousands of bugs, you will receive
+   thousands of emails!
+
+5.13.4. Saving Your Changes
+
+   Once you have defined at least one schedule, and created at least one
+   query, go ahead and "Update/Commit". This will save your Event and make
+   it available for immediate execution.
+   [Note]
+
+   If you ever feel like deleting your event, you may do so using the
+   "Remove Event" button in the upper-right corner of each Event. You can
+   also modify an existing event, so long as you "Update/Commit" after
+   completing your modifications.
+
+Chapter 6. Customizing Bugzilla
+
+   Table of Contents
+
+   6.1. Bugzilla Extensions
+   6.2. Custom Skins
+   6.3. Template Customization
+
+        6.3.1. Template Directory Structure
+        6.3.2. Choosing a Customization Method
+        6.3.3. How To Edit Templates
+        6.3.4. Template Formats and Types
+        6.3.5. Particular Templates
+        6.3.6. Configuring Bugzilla to Detect the User's Language
+
+   6.4. Customizing Who Can Change What
+   6.5. Integrating Bugzilla with Third-Party Tools
+
+6.1. Bugzilla Extensions
+
+   One of the best ways to customize Bugzilla is by writing a Bugzilla
+   Extension. Bugzilla Extensions let you modify both the code and UI of
+   Bugzilla in a way that can be distributed to other Bugzilla users and
+   ported forward to future versions of Bugzilla with minimal effort.
+
+   See the Bugzilla Extension documentation for information on how to
+   write an Extension.
+
+6.2. Custom Skins
+
+   Bugzilla allows you to have multiple skins. These are custom CSS and
+   possibly also custom images for Bugzilla. To create a new custom skin,
+   you have two choices:
+     * Make a single CSS file, and put it in the skins/contrib directory.
+     * Make a directory that contains all the same CSS file names as
+       skins/standard/, and put your directory in skins/contrib/.
+
+   After you put the file or the directory there, make sure to run
+   checksetup.pl so that it can reset the file permissions correctly.
+
+   After you have installed the new skin, it will show up as an option in
+   the user's General Preferences. If you would like to force a particular
+   skin on all users, just select it in the Default Preferences and then
+   uncheck "Enabled" on the preference.
+
+6.3. Template Customization
+
+   Administrators can configure the look and feel of Bugzilla without
+   having to edit Perl files or face the nightmare of massive merge
+   conflicts when they upgrade to a newer version in the future.
+
+   Templatization also makes localized versions of Bugzilla possible, for
+   the first time. It's possible to have Bugzilla's UI language determined
+   by the user's browser. More information is available in Section 6.3.6,
+   “Configuring Bugzilla to Detect the User's Language”.
+
+6.3.1. Template Directory Structure
+
+   The template directory structure starts with top level directory named
+   template, which contains a directory for each installed localization.
+   The next level defines the language used in the templates. Bugzilla
+   comes with English templates, so the directory name is en, and we will
+   discuss template/en throughout the documentation. Below template/en is
+   the default directory, which contains all the standard templates
+   shipped with Bugzilla.
+   [Warning]
+
+   A directory data/templates also exists; this is where Template Toolkit
+   puts the compiled versions of the templates from either the default or
+   custom directories. Do not directly edit the files in this directory,
+   or all your changes will be lost the next time Template Toolkit
+   recompiles the templates.
+
+6.3.2. Choosing a Customization Method
+
+   If you want to edit Bugzilla's templates, the first decision you must
+   make is how you want to go about doing so. There are two choices, and
+   which you use depends mainly on the scope of your modifications, and
+   the method you plan to use to upgrade Bugzilla.
+
+   The first method of making customizations is to directly edit the
+   templates found in template/en/default. This is probably the best way
+   to go about it if you are going to be upgrading Bugzilla through Bzr,
+   because if you then execute a bzr update, any changes you have made
+   will be merged automagically with the updated versions.
+   [Note]
+
+   If you use this method, and Bzr conflicts occur during an update, the
+   conflicted templates (and possibly other parts of your installation)
+   will not work until they are resolved.
+
+   The second method is to copy the templates to be modified into a
+   mirrored directory structure under template/en/custom. Templates in
+   this directory structure automatically override any identically-named
+   and identically-located templates in the default directory.
+   [Note]
+
+   The custom directory does not exist at first and must be created if you
+   want to use it.
+
+   The second method of customization should be used if you use the
+   overwriting method of upgrade, because otherwise your changes will be
+   lost. This method may also be better if you are using the Bzr method of
+   upgrading and are going to make major changes, because it is guaranteed
+   that the contents of this directory will not be touched during an
+   upgrade, and you can then decide whether to continue using your own
+   templates, or make the effort to merge your changes into the new
+   versions by hand.
+
+   Using this method, your installation may break if incompatible changes
+   are made to the template interface. Such changes should be documented
+   in the release notes, provided you are using a stable release of
+   Bugzilla. If you use using unstable code, you will need to deal with
+   this one yourself, although if possible the changes will be mentioned
+   before they occur in the deprecations section of the previous stable
+   release's release notes.
+   [Note]
+
+   Regardless of which method you choose, it is recommended that you run
+   ./checksetup.pl after editing any templates in the template/en/default
+   directory, and after creating or editing any templates in the custom
+   directory.
+   [Warning]
+
+   It is required that you run ./checksetup.pl after creating a new
+   template in the custom directory. Failure to do so will raise an
+   incomprehensible error message.
+
+6.3.3. How To Edit Templates
+
+   [Note]
+
+   If you are making template changes that you intend on submitting back
+   for inclusion in standard Bugzilla, you should read the relevant
+   sections of the Developers' Guide.
+
+   The syntax of the Template Toolkit language is beyond the scope of this
+   guide. It's reasonably easy to pick up by looking at the current
+   templates; or, you can read the manual, available on the Template
+   Toolkit home page.
+
+   One thing you should take particular care about is the need to properly
+   HTML filter data that has been passed into the template. This means
+   that if the data can possibly contain special HTML characters such as
+   <, and the data was not intended to be HTML, they need to be converted
+   to entity form, i.e. &lt;. You use the 'html' filter in the Template
+   Toolkit to do this (or the 'uri' filter to encode special characters in
+   URLs). If you forget, you may open up your installation to cross-site
+   scripting attacks.
+
+   Editing templates is a good way of doing a “poor man's custom fields”.
+   For example, if you don't use the Status Whiteboard, but want to have a
+   free-form text entry box for “Build Identifier”, then you can just edit
+   the templates to change the field labels. It's still be called
+   status_whiteboard internally, but your users don't need to know that.
+
+6.3.4. Template Formats and Types
+
+   Some CGI's have the ability to use more than one template. For example,
+   buglist.cgi can output itself as RDF, or as two formats of HTML
+   (complex and simple). The mechanism that provides this feature is
+   extensible.
+
+   Bugzilla can support different types of output, which again can have
+   multiple formats. In order to request a certain type, you can append
+   the &ctype=<contenttype> (such as rdf or html) to the <cginame>.cgi
+   URL. If you would like to retrieve a certain format, you can use the
+   &format=<format> (such as simple or complex) in the URL.
+
+   To see if a CGI supports multiple output formats and types, grep the
+   CGI for “get_format”. If it's not present, adding multiple format/type
+   support isn't too hard - see how it's done in other CGIs, e.g.
+   config.cgi.
+
+   To make a new format template for a CGI which supports this, open a
+   current template for that CGI and take note of the INTERFACE comment
+   (if present.) This comment defines what variables are passed into this
+   template. If there isn't one, I'm afraid you'll have to read the
+   template and the code to find out what information you get.
+
+   Write your template in whatever markup or text style is appropriate.
+
+   You now need to decide what content type you want your template served
+   as. The content types are defined in the Bugzilla/Constants.pm file in
+   the contenttypes constant. If your content type is not there, add it.
+   Remember the three- or four-letter tag assigned to your content type.
+   This tag will be part of the template filename.
+   [Note]
+
+   After adding or changing a content type, it's suitable to edit
+   Bugzilla/Constants.pm in order to reflect the changes. Also, the file
+   should be kept up to date after an upgrade if content types have been
+   customized in the past.
+
+   Save the template as <stubname>-<formatname>.<contenttypetag>.tmpl. Try
+   out the template by calling the CGI as
+   <cginame>.cgi?format=<formatname>&ctype=<type> .
+
+6.3.5. Particular Templates
+
+   There are a few templates you may be particularly interested in
+   customizing for your installation.
+
+   index.html.tmpl: This is the Bugzilla front page.
+
+   global/header.html.tmpl: This defines the header that goes on all
+   Bugzilla pages. The header includes the banner, which is what appears
+   to users and is probably what you want to edit instead. However the
+   header also includes the HTML HEAD section, so you could for example
+   add a stylesheet or META tag by editing the header.
+
+   global/banner.html.tmpl: This contains the “banner”, the part of the
+   header that appears at the top of all Bugzilla pages. The default
+   banner is reasonably barren, so you'll probably want to customize this
+   to give your installation a distinctive look and feel. It is
+   recommended you preserve the Bugzilla version number in some form so
+   the version you are running can be determined, and users know what docs
+   to read.
+
+   global/footer.html.tmpl: This defines the footer that goes on all
+   Bugzilla pages. Editing this is another way to quickly get a
+   distinctive look and feel for your Bugzilla installation.
+
+   global/variables.none.tmpl: This defines a list of terms that may be
+   changed in order to “brand” the Bugzilla instance In this way, terms
+   like “bugs” can be replaced with “issues” across the whole Bugzilla
+   installation. The name “Bugzilla” and other words can be customized as
+   well.
+
+   list/table.html.tmpl: This template controls the appearance of the bug
+   lists created by Bugzilla. Editing this template allows per-column
+   control of the width and title of a column, the maximum display length
+   of each entry, and the wrap behaviour of long entries. For long bug
+   lists, Bugzilla inserts a 'break' every 100 bugs by default; this
+   behaviour is also controlled by this template, and that value can be
+   modified here.
+
+   bug/create/user-message.html.tmpl: This is a message that appears near
+   the top of the bug reporting page. By modifying this, you can tell your
+   users how they should report bugs.
+
+   bug/process/midair.html.tmpl: This is the page used if two people
+   submit simultaneous changes to the same bug. The second person to
+   submit their changes will get this page to tell them what the first
+   person did, and ask if they wish to overwrite those changes or go back
+   and revisit the bug. The default title and header on this page read
+   "Mid-air collision detected!" If you work in the aviation industry, or
+   other environment where this might be found offensive (yes, we have
+   true stories of this happening) you'll want to change this to something
+   more appropriate for your environment.
+
+   bug/create/create.html.tmpl and bug/create/comment.txt.tmpl: You may
+   not wish to go to the effort of creating custom fields in Bugzilla, yet
+   you want to make sure that each bug report contains a number of pieces
+   of important information for which there is not a special field. The
+   bug entry system has been designed in an extensible fashion to enable
+   you to add arbitrary HTML widgets, such as drop-down lists or
+   textboxes, to the bug entry page and have their values appear formatted
+   in the initial comment. A hidden field that indicates the format should
+   be added inside the form in order to make the template functional. Its
+   value should be the suffix of the template filename. For example, if
+   the file is called create-cust.html.tmpl, then
+<input type="hidden" name="format" value="cust">
+
+   should be used inside the form.
+
+   An example of this is the mozilla.org guided bug submission form. The
+   code for this comes with the Bugzilla distribution as an example for
+   you to copy. It can be found in the files create-guided.html.tmpl and
+   comment-guided.html.tmpl.
+
+   So to use this feature, create a custom template for enter_bug.cgi. The
+   default template, on which you could base it, is
+   custom/bug/create/create.html.tmpl. Call it
+   create-<formatname>.html.tmpl, and in it, add widgets for each piece of
+   information you'd like collected - such as a build number, or set of
+   steps to reproduce.
+
+   Then, create a template like custom/bug/create/comment.txt.tmpl, and
+   call it comment-<formatname>.txt.tmpl. This template should reference
+   the form fields you have created using the syntax [% form.<fieldname>
+   %]. When a bug report is submitted, the initial comment attached to the
+   bug report will be formatted according to the layout of this template.
+
+   For example, if your custom enter_bug template had a field
+<input type="text" name="buildid" size="30">
+
+   and then your comment.txt.tmpl had
+BuildID: [% form.buildid %]
+
+   then something like
+BuildID: 20020303
+
+   would appear in the initial comment.
+
+6.3.6. Configuring Bugzilla to Detect the User's Language
+
+   Bugzilla honours the user's Accept: HTTP header. You can install
+   templates in other languages, and Bugzilla will pick the most
+   appropriate according to a priority order defined by you. Many language
+   templates can be obtained from
+   http://www.bugzilla.org/download.html#localizations. Instructions for
+   submitting new languages are also available from that location.
+
+6.4. Customizing Who Can Change What
+
+   [Warning]
+
+   This feature should be considered experimental; the Bugzilla code you
+   will be changing is not stable, and could change or move between
+   versions. Be aware that if you make modifications as outlined here, you
+   may have to re-make them or port them if Bugzilla changes internally
+   between versions, and you upgrade.
+
+   Companies often have rules about which employees, or classes of
+   employees, are allowed to change certain things in the bug system. For
+   example, only the bug's designated QA Contact may be allowed to VERIFY
+   the bug. Bugzilla has been designed to make it easy for you to write
+   your own custom rules to define who is allowed to make what sorts of
+   value transition.
+
+   By default, assignees, QA owners and users with editbugs privileges can
+   edit all fields of bugs, except group restrictions (unless they are
+   members of the groups they are trying to change). Bug reporters also
+   have the ability to edit some fields, but in a more restrictive manner.
+   Other users, without editbugs privileges, cannot edit bugs, except to
+   comment and add themselves to the CC list.
+
+   For maximum flexibility, customizing this means editing Bugzilla's Perl
+   code. This gives the administrator complete control over exactly who is
+   allowed to do what. The relevant method is called
+   check_can_change_field(), and is found in Bug.pm in your Bugzilla/
+   directory. If you open that file and search for “sub
+   check_can_change_field”, you'll find it.
+
+   This function has been carefully commented to allow you to see exactly
+   how it works, and give you an idea of how to make changes to it.
+   Certain marked sections should not be changed - these are the
+   “plumbing” which makes the rest of the function work. In between those
+   sections, you'll find snippets of code like:
+    # Allow the assignee to change anything.
+    if ($ownerid eq $whoid) {
+        return 1;
+    }
+
+   It's fairly obvious what this piece of code does.
+
+   So, how does one go about changing this function? Well, simple changes
+   can be made just by removing pieces - for example, if you wanted to
+   prevent any user adding a comment to a bug, just remove the lines
+   marked “Allow anyone to change comments.” If you don't want the
+   Reporter to have any special rights on bugs they have filed, just
+   remove the entire section that deals with the Reporter.
+
+   More complex customizations are not much harder. Basically, you add a
+   check in the right place in the function, i.e. after all the variables
+   you are using have been set up. So, don't look at $ownerid before
+   $ownerid has been obtained from the database. You can either add a
+   positive check, which returns 1 (allow) if certain conditions are true,
+   or a negative check, which returns 0 (deny.) E.g.:
+    if ($field eq "qacontact") {
+        if (Bugzilla->user->in_group("quality_assurance")) {
+            return 1;
+        }
+        else {
+            return 0;
+        }
+    }
+
+   This says that only users in the group "quality_assurance" can change
+   the QA Contact field of a bug.
+
+   Getting more weird:
+    if (($field eq "priority") &&
+        (Bugzilla->user->email =~ /.*\@example\.com$/))
+    {
+        if ($oldvalue eq "P1") {
+            return 1;
+        }
+        else {
+            return 0;
+        }
+    }
+
+   This says that if the user is trying to change the priority field, and
+   their email address is @example.com, they can only do so if the old
+   value of the field was "P1". Not very useful, but illustrative.
+   [Warning]
+
+   If you are modifying process_bug.cgi in any way, do not change the code
+   that is bounded by DO_NOT_CHANGE blocks. Doing so could compromise
+   security, or cause your installation to stop working entirely.
+
+   For a list of possible field names, look at the bugs table in the
+   database. If you need help writing custom rules for your organization,
+   ask in the newsgroup.
+
+6.5. Integrating Bugzilla with Third-Party Tools
+
+   Many utilities and applications can integrate with Bugzilla, either on
+   the client- or server-side. None of them are maintained by the Bugzilla
+   community, nor are they tested during our QA tests, so use them at your
+   own risk. They are listed at https://wiki.mozilla.org/Bugzilla:Addons.
+
+Appendix A. Troubleshooting
+
+   Table of Contents
+
+   A.1. General Advice
+   A.2. The Apache web server is not serving Bugzilla pages
+   A.3. I installed a Perl module, but checksetup.pl claims it's not
+          installed!
+
+   A.4. DBD::Sponge::db prepare failed
+   A.5. cannot chdir(/var/spool/mqueue)
+   A.6. Everybody is constantly being forced to relogin
+   A.7. index.cgi doesn't show up unless specified in the URL
+   A.8. checksetup.pl reports "Client does not support authentication
+          protocol requested by server..."
+
+   This section gives solutions to common Bugzilla installation problems.
+   If none of the section headings seems to match your problem, read the
+   general advice.
+
+A.1. General Advice
+
+   If you can't get checksetup.pl to run to completion, it normally
+   explains what's wrong and how to fix it. If you can't work it out, or
+   if it's being uncommunicative, post the errors in the
+   mozilla.support.bugzilla newsgroup.
+
+   If you have made it all the way through Section 2.1, “Installation”
+   (Installation) and Section 2.2, “Configuration” (Configuration) but
+   accessing the Bugzilla URL doesn't work, the first thing to do is to
+   check your web server error log. For Apache, this is often located at
+   /etc/logs/httpd/error_log. The error messages you see may be
+   self-explanatory enough to enable you to diagnose and fix the problem.
+   If not, see below for some commonly-encountered errors. If that doesn't
+   help, post the errors to the newsgroup.
+
+   Bugzilla can also log all user-based errors (and many code-based
+   errors) that occur, without polluting the web server's error log. To
+   enable Bugzilla error logging, create a file that Bugzilla can write
+   to, named errorlog, in the Bugzilla data directory. Errors will be
+   logged as they occur, and will include the type of the error, the IP
+   address and username (if available) of the user who triggered the
+   error, and the values of all environment variables; if a form was being
+   submitted, the data in the form will also be included. To disable error
+   logging, delete or rename the errorlog file.
+
+A.2. The Apache web server is not serving Bugzilla pages
+
+   After you have run checksetup.pl twice, run testserver.pl
+   http://yoursite.yourdomain/yoururl to confirm that your web server is
+   configured properly for Bugzilla.
+bash$ ./testserver.pl http://landfill.bugzilla.org/bugzilla-tip
+TEST-OK Webserver is running under group id in $webservergroup.
+TEST-OK Got ant picture.
+TEST-OK Webserver is executing CGIs.
+TEST-OK Webserver is preventing fetch of http://landfill.bugzilla.org/bugzilla-
+tip/localconfig.
+
+A.3. I installed a Perl module, but checksetup.pl claims it's not installed!
+
+   This could be caused by one of two things:
+    1. You have two versions of Perl on your machine. You are installing
+       modules into one, and Bugzilla is using the other. Rerun the CPAN
+       commands (or manual compile) using the full path to Perl from the
+       top of checksetup.pl. This will make sure you are installing the
+       modules in the right place.
+    2. The permissions on your library directories are set incorrectly.
+       They must, at the very least, be readable by the web server user or
+       group. It is recommended that they be world readable.
+
+A.4. DBD::Sponge::db prepare failed
+
+   The following error message may appear due to a bug in DBD::mysql (over
+   which the Bugzilla team have no control):
+ DBD::Sponge::db prepare failed: Cannot determine NUM_OF_FIELDS at D:/Perl/site
+/lib/DBD/mysql.pm line 248.
+  SV = NULL(0x0) at 0x20fc444
+  REFCNT = 1
+  FLAGS = (PADBUSY,PADMY)
+
+   To fix this, go to <path-to-perl>/lib/DBD/sponge.pm in your Perl
+   installation and replace
+ my $numFields;
+ if ($attribs->{'NUM_OF_FIELDS'}) {
+     $numFields = $attribs->{'NUM_OF_FIELDS'};
+ } elsif ($attribs->{'NAME'}) {
+     $numFields = @{$attribs->{NAME}};
+
+   with
+ my $numFields;
+ if ($attribs->{'NUM_OF_FIELDS'}) {
+     $numFields = $attribs->{'NUM_OF_FIELDS'};
+ } elsif ($attribs->{'NAMES'}) {
+     $numFields = @{$attribs->{NAMES}};
+
+   (note the S added to NAME.)
+
+A.5. cannot chdir(/var/spool/mqueue)
+
+   If you are installing Bugzilla on SuSE Linux, or some other
+   distributions with “paranoid” security options, it is possible that the
+   checksetup.pl script may fail with the error:
+cannot chdir(/var/spool/mqueue): Permission denied
+
+   This is because your /var/spool/mqueue directory has a mode of
+   drwx------. Type chmod 755 /var/spool/mqueue as root to fix this
+   problem. This will allow any process running on your machine the
+   ability to read the /var/spool/mqueue directory.
+
+A.6. Everybody is constantly being forced to relogin
+
+   The most-likely cause is that the “cookiepath” parameter is not set
+   correctly in the Bugzilla configuration. You can change this (if you're
+   a Bugzilla administrator) from the editparams.cgi page via the web
+   interface.
+
+   The value of the cookiepath parameter should be the actual directory
+   containing your Bugzilla installation, as seen by the end-user's web
+   browser. Leading and trailing slashes are mandatory. You can also set
+   the cookiepath to any directory which is a parent of the Bugzilla
+   directory (such as '/', the root directory). But you can't put
+   something that isn't at least a partial match or it won't work. What
+   you're actually doing is restricting the end-user's browser to sending
+   the cookies back only to that directory.
+
+   How do you know if you want your specific Bugzilla directory or the
+   whole site?
+
+   If you have only one Bugzilla running on the server, and you don't mind
+   having other applications on the same server with it being able to see
+   the cookies (you might be doing this on purpose if you have other
+   things on your site that share authentication with Bugzilla), then
+   you'll want to have the cookiepath set to "/", or to a
+   sufficiently-high enough directory that all of the involved apps can
+   see the cookies.
+
+   Example A.1. Examples of urlbase/cookiepath pairs for sharing login
+   cookies
+
+   urlbase is http://bugzilla.mozilla.org/
+   cookiepath is /
+   urlbase is http://tools.mysite.tld/bugzilla/
+           but you have http://tools.mysite.tld/someotherapp/ which shares
+           authentication with your Bugzilla
+   cookiepath is /
+
+   On the other hand, if you have more than one Bugzilla running on the
+   server (some people do - we do on landfill) then you need to have the
+   cookiepath restricted enough so that the different Bugzillas don't
+   confuse their cookies with one another.
+
+   Example A.2. Examples of urlbase/cookiepath pairs to restrict the login
+   cookie
+
+   urlbase is http://landfill.bugzilla.org/bugzilla-tip/
+   cookiepath is /bugzilla-tip/
+   urlbase is http://landfill.bugzilla.org/bugzilla-4.0-branch/
+   cookiepath is /bugzilla-4.0-branch/
+
+   If you had cookiepath set to “/” at any point in the past and need to
+   set it to something more restrictive (i.e. “/bugzilla/”), you can
+   safely do this without requiring users to delete their Bugzilla-related
+   cookies in their browser (this is true starting with Bugzilla 2.18 and
+   Bugzilla 2.16.5).
+
+A.7. index.cgi doesn't show up unless specified in the URL
+
+   You probably need to set up your web server in such a way that it will
+   serve the index.cgi page as an index page.
+
+   If you are using Apache, you can do this by adding index.cgi to the end
+   of the DirectoryIndex line as mentioned in Section 2.2.4.1, “Bugzilla
+   using Apache”.
+
+A.8.  checksetup.pl reports "Client does not support authentication protocol
+requested by server..."
+
+   This error is occurring because you are using the new password
+   encryption that comes with MySQL 4.1, while your DBD::mysql module was
+   compiled against an older version of MySQL. If you recompile DBD::mysql
+   against the current MySQL libraries (or just obtain a newer version of
+   this module) then the error may go away.
+
+   If that does not fix the problem, or if you cannot recompile the
+   existing module (e.g. you're running Windows) and/or don't want to
+   replace it (e.g. you want to keep using a packaged version), then a
+   workaround is available from the MySQL docs:
+   http://dev.mysql.com/doc/mysql/en/Old_client.html
+
+Appendix B. Contrib
+
+   Table of Contents
+
+   B.1. Command-line Search Interface
+   B.2. Command-line 'Send Unsent Bug-mail' tool
+
+   There are a number of unofficial Bugzilla add-ons in the
+   $BUGZILLA_ROOT/contrib/ directory. This section documents them.
+
+B.1. Command-line Search Interface
+
+   There are a suite of Unix utilities for searching Bugzilla from the
+   command line. They live in the contrib/cmdline directory. There are
+   three files - query.conf, buglist and bugs.
+   [Warning]
+
+   These files pre-date the templatization work done as part of the 2.16
+   release, and have not been updated.
+
+   query.conf contains the mapping from options to field names and
+   comparison types. Quoted option names are “grepped” for, so it should
+   be easy to edit this file. Comments (#) have no effect; you must make
+   sure these lines do not contain any quoted “option”.
+
+   buglist is a shell script that submits a Bugzilla query and writes the
+   resulting HTML page to stdout. It supports both short options, (such as
+   “-Afoo” or “-Rbar”) and long options (such as “--assignedto=foo” or
+   “--reporter=bar”). If the first character of an option is not “-”, it
+   is treated as if it were prefixed with “--default=”.
+
+   The column list is taken from the COLUMNLIST environment variable. This
+   is equivalent to the “Change Columns” option that is available when you
+   list bugs in buglist.cgi. If you have already used Bugzilla, grep for
+   COLUMNLIST in your cookies file to see your current COLUMNLIST setting.
+
+   bugs is a simple shell script which calls buglist and extracts the bug
+   numbers from the output. Adding the prefix
+   “http://bugzilla.mozilla.org/buglist.cgi?bug_id=” turns the bug list
+   into a working link if any bugs are found. Counting bugs is easy. Pipe
+   the results through sed -e 's/,/ /g' | wc | awk '{printf $2 "\n"}'
+
+   Akkana Peck says she has good results piping buglist output through w3m
+   -T text/html -dump
+
+B.2. Command-line 'Send Unsent Bug-mail' tool
+
+   Within the contrib directory exists a utility with the descriptive (if
+   compact) name of sendunsentbugmail.pl. The purpose of this script is,
+   simply, to send out any bug-related mail that should have been sent by
+   now, but for one reason or another has not.
+
+   To accomplish this task, sendunsentbugmail.pl uses the same mechanism
+   as the sanitycheck.cgi script; it scans through the entire database
+   looking for bugs with changes that were made more than 30 minutes ago,
+   but where there is no record of anyone related to that bug having been
+   sent mail. Having compiled a list, it then uses the standard rules to
+   determine who gets mail, and sends it out.
+
+   As the script runs, it indicates the bug for which it is currently
+   sending mail; when it has finished, it gives a numerical count of how
+   many mails were sent and how many people were excluded. (Individual
+   user names are not recorded or displayed.) If the script produces no
+   output, that means no unsent mail was detected.
+
+   Usage: move the sendunsentbugmail.pl script up into the main directory,
+   ensure it has execute permission, and run it from the command line (or
+   from a cron job) with no parameters.
+
+Appendix C. Manual Installation of Perl Modules
+
+   Table of Contents
+
+   C.1. Instructions
+   C.2. Download Locations
+   C.3. Optional Modules
+
+C.1. Instructions
+
+   If you need to install Perl modules manually, here's how it's done.
+   Download the module using the link given in the next section, and then
+   apply this magic incantation, as root:
+
+bash# tar -xzvf <module>.tar.gz
+bash# cd <module>
+bash# perl Makefile.PL
+bash# make
+bash# make test
+bash# make install
+
+   [Note]
+
+   In order to compile source code under Windows you will need to obtain a
+   'make' utility. The nmake utility provided with Microsoft Visual C++
+   may be used. As an alternative, there is a utility called dmake
+   available from CPAN which is written entirely in Perl.
+
+   As described in Section C.2, “Download Locations”, however, most
+   packages already exist and are available from ActiveState or theory58S.
+   We highly recommend that you install them using the ppm GUI available
+   with ActiveState and to add the theory58S repository to your list of
+   repositories.
+
+C.2. Download Locations
+
+   [Note]
+
+   Running Bugzilla on Windows requires the use of ActiveState Perl 5.8.1
+   or higher. Many modules already exist in the core distribution of
+   ActiveState Perl. If some modules are missing, upgrade ActiveState Perl
+   to at least 5.12; it has all the required modules.
+
+   CGI:
+
+           CPAN Download Page: http://search.cpan.org/dist/CGI.pm/
+           Documentation: http://perldoc.perl.org/CGI.html
+
+   Data-Dumper:
+
+           CPAN Download Page: http://search.cpan.org/dist/Data-Dumper/
+           Documentation: http://search.cpan.org/dist/Data-Dumper/Dumper.p
+   m
+
+   Date::Format (part of TimeDate):
+
+           CPAN Download Page: http://search.cpan.org/dist/TimeDate/
+           Documentation: http://search.cpan.org/dist/TimeDate/lib/Date/Fo
+   rmat.pm
+
+   DBI:
+
+           CPAN Download Page: http://search.cpan.org/dist/DBI/
+           Documentation: http://dbi.perl.org/docs/
+
+   DBD::mysql:
+
+           CPAN Download Page: http://search.cpan.org/dist/DBD-mysql/
+           Documentation: http://search.cpan.org/dist/DBD-mysql/lib/DBD/my
+   sql.pm
+
+   DBD::Pg:
+
+           CPAN Download Page: http://search.cpan.org/dist/DBD-Pg/
+           Documentation: http://search.cpan.org/dist/DBD-Pg/Pg.pm
+
+   Template-Toolkit:
+
+           CPAN Download Page: http://search.cpan.org/dist/Template-Toolki
+   t/
+           Documentation: http://www.template-toolkit.org/docs.html
+
+   GD:
+
+           CPAN Download Page: http://search.cpan.org/dist/GD/
+           Documentation: http://search.cpan.org/dist/GD/GD.pm
+
+   Template::Plugin::GD:
+
+          CPAN Download Page: http://search.cpan.org/dist/Template-GD/
+          Documentation: http://www.template-toolkit.org/docs/aqua/Modules
+   /index.html
+
+   MIME::Parser (part of MIME-tools):
+
+           CPAN Download Page: http://search.cpan.org/dist/MIME-tools/
+           Documentation: http://search.cpan.org/dist/MIME-tools/lib/MIME/
+   Parser.pm
+
+C.3. Optional Modules
+
+   Chart::Lines:
+
+           CPAN Download Page: http://search.cpan.org/dist/Chart/
+           Documentation: http://search.cpan.org/dist/Chart/Chart.pod
+
+   GD::Graph:
+
+           CPAN Download Page: http://search.cpan.org/dist/GDGraph/
+           Documentation: http://search.cpan.org/dist/GDGraph/Graph.pm
+
+   GD::Text::Align (part of GD::Text::Util):
+
+           CPAN Download Page: http://search.cpan.org/dist/GDTextUtil/
+           Documentation: http://search.cpan.org/dist/GDTextUtil/Text/Alig
+   n.pm
+
+   XML::Twig:
+
+           CPAN Download Page: http://search.cpan.org/dist/XML-Twig/
+           Documentation: http://standards.ieee.org/resources/spasystem/tw
+   ig/twig_stable.html
+
+   PatchReader:
+
+           CPAN Download Page: http://search.cpan.org/author/JKEISER/Patch
+   Reader/
+           Documentation: http://www.johnkeiser.com/mozilla/Patch_Viewer.h
+   tml
+
+Appendix D. GNU Free Documentation License
+
+   Table of Contents
+
+   D.0. Preamble
+   D.1. Applicability and Definition
+   D.2. Verbatim Copying
+   D.3. Copying in Quantity
+   D.4. Modifications
+   D.5. Combining Documents
+   D.6. Collections of Documents
+   D.7. Aggregation with Independent Works
+   D.8. Translation
+   D.9. Termination
+   D.10. Future Revisions of this License
+   D.. How to use this License for your documents
+
+   Version 1.1, March 2000
+
+     Copyright (C) 2000 Free Software Foundation, Inc. 51 Franklin
+     Street, Fifth Floor, Boston, MA 02110-1301 USA Everyone is permitted
+     to copy and distribute verbatim copies of this license document, but
+     changing it is not allowed.
+
+D.0. Preamble
+
+   The purpose of this License is to make a manual, textbook, or other
+   written document "free" in the sense of freedom: to assure everyone the
+   effective freedom to copy and redistribute it, with or without
+   modifying it, either commercially or noncommercially. Secondarily, this
+   License preserves for the author and publisher a way to get credit for
+   their work, while not being considered responsible for modifications
+   made by others.
+
+   This License is a kind of "copyleft", which means that derivative works
+   of the document must themselves be free in the same sense. It
+   complements the GNU General Public License, which is a copyleft license
+   designed for free software.
+
+   We have designed this License in order to use it for manuals for free
+   software, because free software needs free documentation: a free
+   program should come with manuals providing the same freedoms that the
+   software does. But this License is not limited to software manuals; it
+   can be used for any textual work, regardless of subject matter or
+   whether it is published as a printed book. We recommend this License
+   principally for works whose purpose is instruction or reference.
+
+D.1. Applicability and Definition
+
+   This License applies to any manual or other work that contains a notice
+   placed by the copyright holder saying it can be distributed under the
+   terms of this License. The "Document", below, refers to any such manual
+   or work. Any member of the public is a licensee, and is addressed as
+   "you".
+
+   A "Modified Version" of the Document means any work containing the
+   Document or a portion of it, either copied verbatim, or with
+   modifications and/or translated into another language.
+
+   A "Secondary Section" is a named appendix or a front-matter section of
+   the Document that deals exclusively with the relationship of the
+   publishers or authors of the Document to the Document's overall subject
+   (or to related matters) and contains nothing that could fall directly
+   within that overall subject. (For example, if the Document is in part a
+   textbook of mathematics, a Secondary Section may not explain any
+   mathematics.) The relationship could be a matter of historical
+   connection with the subject or with related matters, or of legal,
+   commercial, philosophical, ethical or political position regarding
+   them.
+
+   The "Invariant Sections" are certain Secondary Sections whose titles
+   are designated, as being those of Invariant Sections, in the notice
+   that says that the Document is released under this License.
+
+   The "Cover Texts" are certain short passages of text that are listed,
+   as Front-Cover Texts or Back-Cover Texts, in the notice that says that
+   the Document is released under this License.
+
+   A "Transparent" copy of the Document means a machine-readable copy,
+   represented in a format whose specification is available to the general
+   public, whose contents can be viewed and edited directly and
+   straightforwardly with generic text editors or (for images composed of
+   pixels) generic paint programs or (for drawings) some widely available
+   drawing editor, and that is suitable for input to text formatters or
+   for automatic translation to a variety of formats suitable for input to
+   text formatters. A copy made in an otherwise Transparent file format
+   whose markup has been designed to thwart or discourage subsequent
+   modification by readers is not Transparent. A copy that is not
+   "Transparent" is called "Opaque".
+
+   Examples of suitable formats for Transparent copies include plain ASCII
+   without markup, Texinfo input format, LaTeX input format, SGML or XML
+   using a publicly available DTD, and standard-conforming simple HTML
+   designed for human modification. Opaque formats include PostScript,
+   PDF, proprietary formats that can be read and edited only by
+   proprietary word processors, SGML or XML for which the DTD and/or
+   processing tools are not generally available, and the machine-generated
+   HTML produced by some word processors for output purposes only.
+
+   The "Title Page" means, for a printed book, the title page itself, plus
+   such following pages as are needed to hold, legibly, the material this
+   License requires to appear in the title page. For works in formats
+   which do not have any title page as such, "Title Page" means the text
+   near the most prominent appearance of the work's title, preceding the
+   beginning of the body of the text.
+
+D.2. Verbatim Copying
+
+   You may copy and distribute the Document in any medium, either
+   commercially or noncommercially, provided that this License, the
+   copyright notices, and the license notice saying this License applies
+   to the Document are reproduced in all copies, and that you add no other
+   conditions whatsoever to those of this License. You may not use
+   technical measures to obstruct or control the reading or further
+   copying of the copies you make or distribute. However, you may accept
+   compensation in exchange for copies. If you distribute a large enough
+   number of copies you must also follow the conditions in section 3.
+
+   You may also lend copies, under the same conditions stated above, and
+   you may publicly display copies.
+
+D.3. Copying in Quantity
+
+   If you publish printed copies of the Document numbering more than 100,
+   and the Document's license notice requires Cover Texts, you must
+   enclose the copies in covers that carry, clearly and legibly, all these
+   Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts
+   on the back cover. Both covers must also clearly and legibly identify
+   you as the publisher of these copies. The front cover must present the
+   full title with all words of the title equally prominent and visible.
+   You may add other material on the covers in addition. Copying with
+   changes limited to the covers, as long as they preserve the title of
+   the Document and satisfy these conditions, can be treated as verbatim
+   copying in other respects.
+
+   If the required texts for either cover are too voluminous to fit
+   legibly, you should put the first ones listed (as many as fit
+   reasonably) on the actual cover, and continue the rest onto adjacent
+   pages.
+
+   If you publish or distribute Opaque copies of the Document numbering
+   more than 100, you must either include a machine-readable Transparent
+   copy along with each Opaque copy, or state in or with each Opaque copy
+   a publicly-accessible computer-network location containing a complete
+   Transparent copy of the Document, free of added material, which the
+   general network-using public has access to download anonymously at no
+   charge using public-standard network protocols. If you use the latter
+   option, you must take reasonably prudent steps, when you begin
+   distribution of Opaque copies in quantity, to ensure that this
+   Transparent copy will remain thus accessible at the stated location
+   until at least one year after the last time you distribute an Opaque
+   copy (directly or through your agents or retailers) of that edition to
+   the public.
+
+   It is requested, but not required, that you contact the authors of the
+   Document well before redistributing any large number of copies, to give
+   them a chance to provide you with an updated version of the Document.
+
+D.4. Modifications
+
+   You may copy and distribute a Modified Version of the Document under
+   the conditions of sections 2 and 3 above, provided that you release the
+   Modified Version under precisely this License, with the Modified
+   Version filling the role of the Document, thus licensing distribution
+   and modification of the Modified Version to whoever possesses a copy of
+   it. In addition, you must do these things in the Modified Version:
+    A. Use in the Title Page (and on the covers, if any) a title distinct
+       from that of the Document, and from those of previous versions
+       (which should, if there were any, be listed in the History section
+       of the Document). You may use the same title as a previous version
+       if the original publisher of that version gives permission.
+    B. List on the Title Page, as authors, one or more persons or entities
+       responsible for authorship of the modifications in the Modified
+       Version, together with at least five of the principal authors of
+       the Document (all of its principal authors, if it has less than
+       five).
+    C. State on the Title page the name of the publisher of the Modified
+       Version, as the publisher.
+    D. Preserve all the copyright notices of the Document.
+    E. Add an appropriate copyright notice for your modifications adjacent
+       to the other copyright notices.
+    F. Include, immediately after the copyright notices, a license notice
+       giving the public permission to use the Modified Version under the
+       terms of this License, in the form shown in the Addendum below.
+    G. Preserve in that license notice the full lists of Invariant
+       Sections and required Cover Texts given in the Document's license
+       notice.
+    H. Include an unaltered copy of this License.
+    I. Preserve the section entitled "History", and its title, and add to
+       it an item stating at least the title, year, new authors, and
+       publisher of the Modified Version as given on the Title Page. If
+       there is no section entitled "History" in the Document, create one
+       stating the title, year, authors, and publisher of the Document as
+       given on its Title Page, then add an item describing the Modified
+       Version as stated in the previous sentence.
+    J. Preserve the network location, if any, given in the Document for
+       public access to a Transparent copy of the Document, and likewise
+       the network locations given in the Document for previous versions
+       it was based on. These may be placed in the "History" section. You
+       may omit a network location for a work that was published at least
+       four years before the Document itself, or if the original publisher
+       of the version it refers to gives permission.
+    K. In any section entitled "Acknowledgements" or "Dedications",
+       preserve the section's title, and preserve in the section all the
+       substance and tone of each of the contributor acknowledgements
+       and/or dedications given therein.
+    L. Preserve all the Invariant Sections of the Document, unaltered in
+       their text and in their titles. Section numbers or the equivalent
+       are not considered part of the section titles.
+    M. Delete any section entitled "Endorsements". Such a section may not
+       be included in the Modified Version.
+    N. Do not retitle any existing section as "Endorsements" or to
+       conflict in title with any Invariant Section.
+
+   If the Modified Version includes new front-matter sections or
+   appendices that qualify as Secondary Sections and contain no material
+   copied from the Document, you may at your option designate some or all
+   of these sections as invariant. To do this, add their titles to the
+   list of Invariant Sections in the Modified Version's license notice.
+   These titles must be distinct from any other section titles.
+
+   You may add a section entitled "Endorsements", provided it contains
+   nothing but endorsements of your Modified Version by various
+   parties--for example, statements of peer review or that the text has
+   been approved by an organization as the authoritative definition of a
+   standard.
+
+   You may add a passage of up to five words as a Front-Cover Text, and a
+   passage of up to 25 words as a Back-Cover Text, to the end of the list
+   of Cover Texts in the Modified Version. Only one passage of Front-Cover
+   Text and one of Back-Cover Text may be added by (or through
+   arrangements made by) any one entity. If the Document already includes
+   a cover text for the same cover, previously added by you or by
+   arrangement made by the same entity you are acting on behalf of, you
+   may not add another; but you may replace the old one, on explicit
+   permission from the previous publisher that added the old one.
+
+   The author(s) and publisher(s) of the Document do not by this License
+   give permission to use their names for publicity for or to assert or
+   imply endorsement of any Modified Version.
+
+D.5. Combining Documents
+
+   You may combine the Document with other documents released under this
+   License, under the terms defined in section 4 above for modified
+   versions, provided that you include in the combination all of the
+   Invariant Sections of all of the original documents, unmodified, and
+   list them all as Invariant Sections of your combined work in its
+   license notice.
+
+   The combined work need only contain one copy of this License, and
+   multiple identical Invariant Sections may be replaced with a single
+   copy. If there are multiple Invariant Sections with the same name but
+   different contents, make the title of each such section unique by
+   adding at the end of it, in parentheses, the name of the original
+   author or publisher of that section if known, or else a unique number.
+   Make the same adjustment to the section titles in the list of Invariant
+   Sections in the license notice of the combined work.
+
+   In the combination, you must combine any sections entitled "History" in
+   the various original documents, forming one section entitled "History";
+   likewise combine any sections entitled "Acknowledgements", and any
+   sections entitled "Dedications". You must delete all sections entitled
+   "Endorsements."
+
+D.6. Collections of Documents
+
+   You may make a collection consisting of the Document and other
+   documents released under this License, and replace the individual
+   copies of this License in the various documents with a single copy that
+   is included in the collection, provided that you follow the rules of
+   this License for verbatim copying of each of the documents in all other
+   respects.
+
+   You may extract a single document from such a collection, and
+   distribute it individually under this License, provided you insert a
+   copy of this License into the extracted document, and follow this
+   License in all other respects regarding verbatim copying of that
+   document.
+
+D.7. Aggregation with Independent Works
+
+   A compilation of the Document or its derivatives with other separate
+   and independent documents or works, in or on a volume of a storage or
+   distribution medium, does not as a whole count as a Modified Version of
+   the Document, provided no compilation copyright is claimed for the
+   compilation. Such a compilation is called an "aggregate", and this
+   License does not apply to the other self-contained works thus compiled
+   with the Document, on account of their being thus compiled, if they are
+   not themselves derivative works of the Document.
+
+   If the Cover Text requirement of section 3 is applicable to these
+   copies of the Document, then if the Document is less than one quarter
+   of the entire aggregate, the Document's Cover Texts may be placed on
+   covers that surround only the Document within the aggregate. Otherwise
+   they must appear on covers around the whole aggregate.
+
+D.8. Translation
+
+   Translation is considered a kind of modification, so you may distribute
+   translations of the Document under the terms of section 4. Replacing
+   Invariant Sections with translations requires special permission from
+   their copyright holders, but you may include translations of some or
+   all Invariant Sections in addition to the original versions of these
+   Invariant Sections. You may include a translation of this License
+   provided that you also include the original English version of this
+   License. In case of a disagreement between the translation and the
+   original English version of this License, the original English version
+   will prevail.
+
+D.9. Termination
+
+   You may not copy, modify, sublicense, or distribute the Document except
+   as expressly provided for under this License. Any other attempt to
+   copy, modify, sublicense or distribute the Document is void, and will
+   automatically terminate your rights under this License. However,
+   parties who have received copies, or rights, from you under this
+   License will not have their licenses terminated so long as such parties
+   remain in full compliance.
+
+D.10. Future Revisions of this License
+
+   The Free Software Foundation may publish new, revised versions of the
+   GNU Free Documentation License from time to time. Such new versions
+   will be similar in spirit to the present version, but may differ in
+   detail to address new problems or concerns. See
+   http://www.gnu.org/copyleft/.
+
+   Each version of the License is given a distinguishing version number.
+   If the Document specifies that a particular numbered version of this
+   License "or any later version" applies to it, you have the option of
+   following the terms and conditions either of that specified version or
+   of any later version that has been published (not as a draft) by the
+   Free Software Foundation. If the Document does not specify a version
+   number of this License, you may choose any version ever published (not
+   as a draft) by the Free Software Foundation.
+
+D.. How to use this License for your documents
+
+   To use this License in a document you have written, include a copy of
+   the License in the document and put the following copyright and license
+   notices just after the title page:
+
+     Copyright (c) YEAR YOUR NAME. Permission is granted to copy,
+     distribute and/or modify this document under the terms of the GNU
+     Free Documentation License, Version 1.1 or any later version
+     published by the Free Software Foundation; with the Invariant
+     Sections being LIST THEIR TITLES, with the Front-Cover Texts being
+     LIST, and with the Back-Cover Texts being LIST. A copy of the
+     license is included in the section entitled "GNU Free Documentation
+     License".
+
+   If you have no Invariant Sections, write "with no Invariant Sections"
+   instead of saying which ones are invariant. If you have no Front-Cover
+   Texts, write "no Front-Cover Texts" instead of "Front-Cover Texts being
+   LIST"; likewise for Back-Cover Texts.
+
+   If your document contains nontrivial examples of program code, we
+   recommend releasing these examples in parallel under your choice of
+   free software license, such as the GNU General Public License, to
+   permit their use in free software.
+
+Glossary
+
+0-9, high ascii
+
+   .htaccess
+          Apache web server, and other NCSA-compliant web servers, observe
+          the convention of using files in directories called .htaccess to
+          restrict access to certain files. In Bugzilla, they are used to
+          keep secret files which would otherwise compromise your
+          installation - e.g. the localconfig file contains the password
+          to your database. curious.
+
+A
+
+   Apache
+          In this context, Apache is the web server most commonly used for
+          serving up Bugzilla pages. Contrary to popular belief, the
+          apache web server has nothing to do with the ancient and noble
+          Native American tribe, but instead derived its name from the
+          fact that it was “a patchy” version of the original NCSA
+          world-wide-web server.
+
+          Useful Directives when configuring Bugzilla
+
+        AddHandler
+                Tell Apache that it's OK to run CGI scripts.
+
+        AllowOverride, Options
+                These directives are used to tell Apache many things about
+                the directory they apply to. For Bugzilla's purposes, we
+                need them to allow script execution and .htaccess
+                overrides.
+
+        DirectoryIndex
+                Used to tell Apache what files are indexes. If you can not
+                add index.cgi to the list of valid files, you'll need to
+                set $index_html to 1 in localconfig so ./checksetup.pl
+                will create an index.html that redirects to index.cgi.
+
+        ScriptInterpreterSource
+                Used when running Apache on windows so the shebang line
+                doesn't have to be changed in every Bugzilla script.
+
+          For more information about how to configure Apache for Bugzilla,
+          see Section 2.2.4.1, “Bugzilla using Apache”.
+
+B
+
+   Bug
+          A “bug” in Bugzilla refers to an issue entered into the database
+          which has an associated number, assignments, comments, etc. Some
+          also refer to a “tickets” or “issues”; in the context of
+          Bugzilla, they are synonymous.
+
+   Bug Number
+          Each Bugzilla bug is assigned a number that uniquely identifies
+          that bug. The bug associated with a bug number can be pulled up
+          via a query, or easily from the very front page by typing the
+          number in the "Find" box.
+
+   Bugzilla
+          Bugzilla is the world-leading free software bug tracking system.
+
+C
+
+   Common Gateway Interface
+          CGI is an acronym for Common Gateway Interface. This is a
+          standard for interfacing an external application with a web
+          server. Bugzilla is an example of a CGI application.
+
+   Component
+          A Component is a subsection of a Product. It should be a narrow
+          category, tailored to your organization. All Products must
+          contain at least one Component (and, as a matter of fact,
+          creating a Product with no Components will create an error in
+          Bugzilla).
+
+   Comprehensive Perl Archive Network
+          CPAN stands for the “Comprehensive Perl Archive Network”. CPAN
+          maintains a large number of extremely useful Perl modules -
+          encapsulated chunks of code for performing a particular task.
+
+   contrib
+          The contrib directory is a location to put scripts that have
+          been contributed to Bugzilla but are not a part of the official
+          distribution. These scripts are written by third parties and may
+          be in languages other than perl. For those that are in perl,
+          there may be additional modules or other requirements than those
+          of the official distribution.
+
+          [Note]
+   Scripts in the contrib directory are not officially supported by the
+   Bugzilla team and may break in between versions.
+
+D
+
+   daemon
+          A daemon is a computer program which runs in the background. In
+          general, most daemons are started at boot time via System V init
+          scripts, or through RC scripts on BSD-based systems. mysqld, the
+          MySQL server, and apache, a web server, are generally run as
+          daemons.
+
+   DOS Attack
+          A DOS, or Denial of Service attack, is when a user attempts to
+          deny access to a web server by repeatedly accessing a page or
+          sending malformed requests to a webserver. A D-DOS, or
+          Distributed Denial of Service attack, is when these requests
+          come from multiple sources at the same time. Unfortunately,
+          these are much more difficult to defend against.
+
+G
+
+   Groups
+          The word “Groups” has a very special meaning to Bugzilla.
+          Bugzilla's main security mechanism comes by placing users in
+          groups, and assigning those groups certain privileges to view
+          bugs in particular Products in the Bugzilla database.
+
+J
+
+   JavaScript
+          JavaScript is cool, we should talk about it.
+
+M
+
+   Message Transport Agent
+          A Message Transport Agent is used to control the flow of email
+          on a system. The Email::Send Perl module, which Bugzilla uses to
+          send email, can be configured to use many different underlying
+          implementations for actually sending the mail using the
+          mail_delivery_method parameter.
+
+   MySQL
+          MySQL is one of the supported RDBMS for Bugzilla. MySQL can be
+          downloaded from http://www.mysql.com. While you should
+          familiarize yourself with all of the documentation, some high
+          points are:
+
+        Backup
+                Methods for backing up your Bugzilla database.
+
+        Option Files
+                Information about how to configure MySQL using my.cnf.
+
+        Privilege System
+                Information about how to protect your MySQL server.
+
+P
+
+   Perl Package Manager
+          http://aspn.activestate.com/ASPN/Downloads/ActivePerl/PPM/
+
+   Product
+          A Product is a broad category of types of bugs, normally
+          representing a single piece of software or entity. In general,
+          there are several Components to a Product. A Product may define
+          a group (used for security) for all bugs entered into its
+          Components.
+
+   Perl
+          First written by Larry Wall, Perl is a remarkable program
+          language. It has the benefits of the flexibility of an
+          interpreted scripting language (such as shell script), combined
+          with the speed and power of a compiled language, such as C.
+          Bugzilla is maintained in Perl.
+
+Q
+
+   QA
+          “QA”, “Q/A”, and “Q.A.” are short for “Quality Assurance”. In
+          most large software development organizations, there is a team
+          devoted to ensuring the product meets minimum standards before
+          shipping. This team will also generally want to track the
+          progress of bugs over their life cycle, thus the need for the
+          “QA Contact” field in a bug.
+
+R
+
+   Relational DataBase Management System
+          A relational database management system is a database system
+          that stores information in tables that are related to each
+          other.
+
+   Regular Expression
+          A regular expression is an expression used for pattern matching.
+          Documentation
+
+S
+
+   Service
+          In Windows NT environment, a boot-time background application is
+          referred to as a service. These are generally managed through
+          the control panel while logged in as an account with
+          “Administrator” level capabilities. For more information,
+          consult your Windows manual or the MSKB.
+
+   SGML
+          SGML stands for “Standard Generalized Markup Language”. Created
+          in the 1980's to provide an extensible means to maintain
+          documentation based upon content instead of presentation, SGML
+          has withstood the test of time as a robust, powerful language.
+          XML is the “baby brother” of SGML; any valid XML document it, by
+          definition, a valid SGML document. The document you are reading
+          is written and maintained in SGML, and is also valid XML if you
+          modify the Document Type Definition.
+
+T
+
+   Target Milestone
+          Target Milestones are Product goals. They are configurable on a
+          per-Product basis. Most software development houses have a
+          concept of “milestones” where the people funding a project
+          expect certain functionality on certain dates. Bugzilla
+          facilitates meeting these milestones by giving you the ability
+          to declare by which milestone a bug will be fixed, or an
+          enhancement will be implemented.
+
+   Tool Command Language
+          TCL is an open source scripting language available for Windows,
+          Macintosh, and Unix based systems. Bugzilla 1.0 was written in
+          TCL but never released. The first release of Bugzilla was 2.0,
+          which was when it was ported to perl.
+
+Z
+
+   Zarro Boogs Found
+          This is just a goofy way of saying that there were no bugs found
+          matching your query. When asked to explain this message, Terry
+          had the following to say:
+
+
+
+   I've been asked to explain this ... way back when, when Netscape
+   released version 4.0 of its browser, we had a release party. Naturally,
+   there had been a big push to try and fix every known bug before the
+   release. Naturally, that hadn't actually happened. (This is not unique
+   to Netscape or to 4.0; the same thing has happened with every software
+   project I've ever seen.) Anyway, at the release party, T-shirts were
+   handed out that said something like "Netscape 4.0: Zarro Boogs". Just
+   like the software, the T-shirt had no known bugs. Uh-huh.
+   So, when you query for a list of bugs, and it gets no results, you can
+   think of this as a friendly reminder. Of *course* there are bugs
+   matching your query, they just aren't in the bugsystem yet...
+
+            --Terry Weissman

diff --git a/docs/en/xml/Bugzilla-Guide.xml b/docs/en/xml/Bugzilla-Guide.xml
new file mode 100644 (file)
index 0000000..cd99a06
--- /dev/null
+++ b/docs/en/xml/Bugzilla-Guide.xml
@@ -0,0 +1,134 @@
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                      "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+    <!ENTITY % myents SYSTEM "bugzilla.ent">
+    %myents;
+]>
+
+<!-- Coding standards for this document 
+
+*  Other than the GFDL, please use the "section" tag instead of "sect1", 
+   "sect2", etc.
+*  Use Entities to include files for new chapters in Bugzilla-Guide.xml.
+*  Try to use Entities for frequently-used passages of text as well.
+*  Ensure all documents compile cleanly to HTML after modification.
+   The warning, "DTDDECL catalog types not supported" is normal.
+*  Try to index important terms wherever possible.
+*  Use "glossterm" whenever you introduce a new term.
+*  Follow coding standards at http://www.tldp.org, and
+   check out the KDE guidelines (they are nice, too)
+   http://i18n.kde.org/doc/markup.html
+*  All tags should be lowercase.
+*  Please use sensible spacing.  The comments at the very end of each
+   file define reasonable defaults for PSGML mode in EMACS.
+*  Double-indent tags, use double spacing whenever possible, and
+   try to avoid clutter and feel free to waste space in the code to make it 
+   more readable.
+
+-->
+
+<book id="index">
+
+<!-- Header -->
+
+  <bookinfo>
+    <title>The Bugzilla Guide - &bz-ver; 
+    Release</title>
+
+    <authorgroup>
+      <corpauthor>The Bugzilla Team</corpauthor>
+    </authorgroup>
+
+    <pubdate>&bz-date;</pubdate>
+
+    <abstract>
+      <para>
+             This is the documentation for Bugzilla, a 
+             bug-tracking system from mozilla.org.
+             Bugzilla is an enterprise-class piece of software
+             that tracks millions of bugs and issues for hundreds of
+             organizations around the world.
+      </para>
+
+      <para>
+        The most current version of this document can always be found on the
+        <ulink url="http://www.bugzilla.org/docs/">Bugzilla 
+        Documentation Page</ulink>.
+      </para>
+
+    </abstract>
+
+    <keywordset>
+      <keyword>Bugzilla</keyword>
+      <keyword>Guide</keyword>
+      <keyword>installation</keyword>
+      <keyword>FAQ</keyword>
+      <keyword>administration</keyword>
+      <keyword>integration</keyword>
+      <keyword>MySQL</keyword>
+      <keyword>Mozilla</keyword>
+      <keyword>webtools</keyword>
+    </keywordset>
+  </bookinfo>
+
+<!-- About This Guide -->
+<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="about.xml"/>
+
+<!-- Installing Bugzilla -->
+<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="installation.xml"/>
+
+<!-- Administering Bugzilla -->
+<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="administration.xml"/>
+
+<!-- Securing Bugzilla -->
+<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="security.xml"/>
+
+<!-- Using Bugzilla -->
+<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="using.xml"/>
+
+<!-- Customizing Bugzilla -->
+<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="customization.xml"/>
+
+<!-- Appendix: Troubleshooting -->
+<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="troubleshooting.xml"/>
+
+<!-- Appendix: Custom Patches -->
+<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="patches.xml"/>
+
+<!-- Appendix: Manually Installing Perl Modules -->
+<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="modules.xml"/>
+
+<!-- Appendix: GNU Free Documentation License -->
+<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gfdl.xml"/>
+
+<!-- Glossary -->
+<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="glossary.xml"/>
+
+</book>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-always-quote-attributes:t
+sgml-auto-insert-required-elements:t
+sgml-balanced-tag-edit:t
+sgml-exposed-tags:nil
+sgml-general-insert-case:lower
+sgml-indent-data:t
+sgml-indent-step:2
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+sgml-minimize-attributes:nil
+sgml-namecase-general:t
+sgml-omittag:t
+sgml-parent-document:("Bugzilla-Guide.xml" "book" "chapter")
+sgml-shorttag:t
+sgml-tag-region-if-active:t
+End:
+-->

diff --git a/docs/en/xml/about.xml b/docs/en/xml/about.xml
new file mode 100644 (file)
index 0000000..4d5d2a4
--- /dev/null
+++ b/docs/en/xml/about.xml
@@ -0,0 +1,223 @@
+<?xml version="1.0"?>
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                      "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+    <!ENTITY % myents SYSTEM "bugzilla.ent">
+    %myents;
+]>
+
+<chapter id="about">
+<title>About This Guide</title>
+
+  <section id="copyright">
+    <title>Copyright Information</title>
+
+    <para>This document is copyright (c) 2000-&current-year; by the various
+    Bugzilla contributors who wrote it.</para>
+    
+    <blockquote>
+      <para>
+       Permission is granted to copy, distribute and/or modify this
+       document under the terms of the GNU Free Documentation
+       License, Version 1.1 or any later version published by the
+       Free Software Foundation; with no Invariant Sections, no
+       Front-Cover Texts, and with no Back-Cover Texts. A copy of
+       the license is included in <xref linkend="gfdl"/>.
+      </para>
+    </blockquote>
+    <para>
+      If you have any questions regarding this document, its
+      copyright, or publishing this document in non-electronic form,
+      please contact the Bugzilla Team. 
+    </para>
+  </section>
+
+  <section id="disclaimer">
+    <title>Disclaimer</title>
+    <para>
+      No liability for the contents of this document can be accepted.
+      Follow the instructions herein at your own risk.
+      This document may contain errors
+      and inaccuracies that may damage your system, cause your partner 
+      to leave you, your boss to fire you, your cats to
+      pee on your furniture and clothing, and global thermonuclear
+      war. Proceed with caution.
+    </para>
+    <para>
+      Naming of particular products or brands should not be seen as
+      endorsements, with the exception of the term "GNU/Linux". We
+      wholeheartedly endorse the use of GNU/Linux; it is an extremely 
+      versatile, stable,
+      and robust operating system that offers an ideal operating
+      environment for Bugzilla.
+    </para>
+    <para>
+      Although the Bugzilla development team has taken great care to
+      ensure that all exploitable bugs have been fixed, security holes surely 
+      exist in any piece of code. Great care should be taken both in 
+      the installation and usage of this software. The Bugzilla development
+      team members assume no liability for your use of Bugzilla. You have 
+      the source code, and are responsible for auditing it yourself to ensure
+      your security needs are met.
+    </para>
+  </section>
+
+<!-- Section 2: New Versions -->
+
+  <section id="newversions">
+    <title>New Versions</title>
+    <para>
+      This is the &bz-ver; version of The Bugzilla Guide. It is so named
+      to match the current version of Bugzilla.
+    </para>
+    <para>
+      The latest version of this guide can always be found at <ulink
+      url="http://www.bugzilla.org/docs/"/>. However, you should read
+      the version which came with the Bugzilla release you are using.
+    </para>
+    
+    <para>  
+      In addition, there are Bugzilla template localization projects in
+      <ulink url="http://www.bugzilla.org/download/#localizations">several languages</ulink>.
+      They may have translated documentation available. If you would like to
+      volunteer to translate the Guide into additional languages, please visit the
+      <ulink url="https://wiki.mozilla.org/Bugzilla:L10n">Bugzilla L10n team</ulink>
+      page.
+    </para>
+  </section>
+
+  <section id="credits">
+    <title>Credits</title>
+    <para>
+      The people listed below have made enormous contributions to the
+      creation of this Guide, through their writing, dedicated hacking efforts,
+      numerous e-mail and IRC support sessions, and overall excellent
+      contribution to the Bugzilla community:
+    </para>
+
+    <!-- TODO: This is evil... there has to be a valid way to get this look -->
+    <variablelist>
+      <varlistentry>
+        <term>Matthew P. Barnson <email>mbarnson@sisna.com</email></term>
+        <listitem>
+          <para>for the Herculean task of pulling together the Bugzilla Guide
+          and shepherding it to 2.14.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>Terry Weissman <email>terry@mozilla.org</email></term>
+        <listitem>
+          <para>for initially writing Bugzilla and creating the README upon
+          which the UNIX installation documentation is largely based.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>Tara Hernandez <email>tara@tequilarists.org</email></term>
+        <listitem>
+          <para>for keeping Bugzilla development going strong after Terry left
+          mozilla.org and for running landfill.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>Dave Lawrence <email>dkl@redhat.com</email></term>
+        <listitem>
+          <para>for providing insight into the key differences between Red
+          Hat's customized Bugzilla.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>Dawn Endico <email>endico@mozilla.org</email></term>
+        <listitem>
+          <para>for being a hacker extraordinaire and putting up with Matthew's
+          incessant questions and arguments on irc.mozilla.org in #mozwebtools
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>Jacob Steenhagen <email>jake@bugzilla.org</email></term>
+        <listitem>
+          <para>for taking over documentation during the 2.17 development
+          period.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+       <term>Dave Miller <email>justdave@bugzilla.org</email></term>
+       <listitem>
+          <para>for taking over as project lead when Tara stepped down and
+         continually pushing for the documentation to be the best it can be.
+          </para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+
+    <para>
+      Thanks also go to the following people for significant contributions 
+      to this documentation:
+      <simplelist type="inline">
+        <member>Kevin Brannen</member>
+        <member>Vlad Dascalu</member>
+        <member>Ben FrantzDale</member>
+        <member>Eric Hanson</member>
+        <member>Zach Lipton</member>
+        <member>Gervase Markham</member>
+        <member>Andrew Pearson</member>
+        <member>Joe Robins</member>
+        <member>Spencer Smith</member>
+        <member>Ron Teitelbaum</member>
+        <member>Shane Travis</member>
+        <member>Martin Wulffeld</member>
+      </simplelist>.
+    </para>
+    
+    <para>
+      Also, thanks are due to the members of the 
+      <ulink url="news://news.mozilla.org/mozilla.support.bugzilla">
+      mozilla.support.bugzilla</ulink>
+      newsgroup (and its predecessor, netscape.public.mozilla.webtools).
+      Without your discussions, insight, suggestions, and patches,
+      this could never have happened.
+    </para>
+  </section>
+
+  <!-- conventions used here (didn't want to give it a chapter of its own) -->
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="conventions.xml" />
+</chapter>
+
+<!-- Keep this comment at the end of the file 
+Local variables: 
+mode: sgml 
+sgml-always-quote-attributes:t
+sgml-auto-insert-required-elements:t
+sgml-balanced-tag-edit:t
+sgml-exposed-tags:nil
+sgml-general-insert-case:lower
+sgml-indent-data:t 
+sgml-indent-step:2 
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil 
+sgml-minimize-attributes:nil
+sgml-namecase-general:t 
+sgml-omittag:t
+sgml-parent-document:("Bugzilla-Guide.xml" "book" "chapter")
+sgml-shorttag:t 
+sgml-tag-region-if-active:t 
+End: -->

diff --git a/docs/en/xml/administration.xml b/docs/en/xml/administration.xml
new file mode 100644 (file)
index 0000000..d0525d9
--- /dev/null
+++ b/docs/en/xml/administration.xml
@@ -0,0 +1,3207 @@
+<?xml version="1.0"?>
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                      "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+    <!ENTITY % myents SYSTEM "bugzilla.ent">
+    %myents;
+]>
+
+<chapter id="administration">
+  <title>Administering Bugzilla</title>
+
+  <section id="parameters">
+    <title>Bugzilla Configuration</title>
+
+    <para>
+      Bugzilla is configured by changing various parameters, accessed
+      from the "Parameters" link in the Administration page (the 
+      Administration page can be found by clicking the "Administration"
+      link in the footer). The parameters are divided into several categories,
+      accessed via the menu on the left. Following is a description of the 
+      different categories and important parameters within those categories. 
+    </para>
+
+      <section id="param-requiredsettings">
+        <title>Required Settings</title>
+
+        <para>
+          The core required parameters for any Bugzilla installation are set
+          here. These parameters must be set before a new Bugzilla installation
+          can be used. Administrators should review this list before 
+          deploying a new Bugzilla installation.
+        </para>
+
+        <variablelist>
+
+          <varlistentry>
+            <term>
+              maintainer
+            </term>
+            <listitem>
+              <para> 
+              Email address of the person 
+              responsible for maintaining this Bugzilla installation.
+              The address need not be that of a valid Bugzilla account.
+            </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              urlbase
+            </term>
+            <listitem>
+              <para>
+                Defines the fully qualified domain name and web 
+                server path to this Bugzilla installation.
+              </para>
+              <para>
+                For example, if the Bugzilla query page is
+                <filename>http://www.foo.com/bugzilla/query.cgi</filename>, 
+                the <quote>urlbase</quote> should be set
+                to <filename>http://www.foo.com/bugzilla/</filename>.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              docs_urlbase
+            </term>
+            <listitem>
+              <para>
+                Defines path to the Bugzilla documentation. This can be a fully
+                qualified domain name, or a path relative to "urlbase".
+              </para>
+              <para>
+                For example, if the "Bugzilla Configuration" page 
+                of the documentation is
+                <filename>http://www.foo.com/bugzilla/docs/html/parameters.html</filename>, 
+                set the <quote>docs_urlbase</quote>
+                to <filename>http://www.foo.com/bugzilla/docs/html/</filename>.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              sslbase
+            </term>
+            <listitem>
+              <para>
+                Defines the fully qualified domain name and web 
+                server path for HTTPS (SSL) connections to this Bugzilla installation.
+              </para>
+              <para>
+                For example, if the Bugzilla main page is
+                <filename>https://www.foo.com/bugzilla/index.cgi</filename>, 
+                the <quote>sslbase</quote> should be set
+                to <filename>https://www.foo.com/bugzilla/</filename>.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              ssl_redirect
+            </term>
+            <listitem>
+              <para>
+                If enabled, Bugzilla will force HTTPS (SSL) connections, by
+                automatically redirecting any users who try to use a non-SSL
+                connection.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              cookiedomain
+            </term>
+            <listitem>
+              <para>
+               Defines the domain for Bugzilla cookies. This is typically left blank.
+               If there are multiple hostnames that point to the same webserver, which
+               require the same cookie, then this parameter can be utilized. For
+               example, If your website is at 
+               <filename>https://www.foo.com/</filename>, setting this to 
+               <filename>.foo.com/</filename> will also allow 
+               <filename>bar.foo.com/</filename> to access Bugzilla cookies.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              cookiepath
+            </term>
+            <listitem>
+              <para>
+                Defines a path, relative to the web server root, that Bugzilla
+                cookies will be restricted to. For example, if the 
+                <command>urlbase</command> is set to
+                <filename>http://www.foo.com/bugzilla/</filename>, the 
+                <command>cookiepath</command> should be set to 
+                <filename>/bugzilla/</filename>. Setting it to "/" will allow all sites 
+                served by this web server or virtual host to read Bugzilla cookies.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              utf8
+            </term>
+            <listitem>
+              <para>
+               Determines whether to use UTF-8 (Unicode) encoding for all text in 
+               Bugzilla. New installations should set this to true to avoid character 
+               encoding problems. Existing databases should set this to true only 
+               after the data has been converted from existing legacy character 
+               encoding to UTF-8, using the 
+               <filename>contrib/recode.pl</filename> script.
+              </para>
+              <note>
+                <para>
+                  If you turn this parameter from "off" to "on", you must re-run 
+                  <filename>checksetup.pl</filename> immediately afterward.
+                </para>
+              </note>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              shutdownhtml
+            </term>
+            <listitem>
+              <para>
+                If there is any text in this field, this Bugzilla installation will
+                be completely disabled and this text will appear instead of all
+                Bugzilla pages for all users, including Admins. Used in the event 
+                of site maintenance or outage situations. 
+              </para>
+              <note>
+                <para>
+                  Although regular log-in capability is disabled while 
+                  <command>shutdownhtml</command>
+                  is enabled, safeguards are in place to protect the unfortunate 
+                  admin who loses connection to Bugzilla. Should this happen to you,
+                  go directly to the <filename>editparams.cgi</filename> (by typing
+                  the URL in manually, if necessary). Doing this will prompt you to
+                  log in, and your name/password will be accepted here (but nowhere
+                  else). 
+                </para>
+              </note>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              announcehtml
+            </term>
+            <listitem>
+              <para>
+                Any text in this field will be displayed at the top of every HTML
+                page in this Bugzilla installation. The text is not wrapped in any
+                tags. For best results, wrap the text in a <quote>&lt;div&gt;</quote>
+                tag. Any style attributes from the CSS can be applied. For example,
+                to make the text green inside of a red box, add <quote>id=message</quote>
+                to the <quote>&lt;div&gt;</quote> tag.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              proxy_url
+            </term>
+            <listitem>
+              <para>
+                If this Bugzilla installation is behind a proxy, enter the proxy 
+                information here to enable Bugzilla to access the Internet. Bugzilla
+                requires Internet access to utilize the 
+                <command>upgrade_notification</command> parameter (below). If the 
+                proxy requires authentication, use the syntax:
+                <filename>http://user:pass@proxy_url/</filename>.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              upgrade_notification
+            </term>
+            <listitem>
+              <para>
+                Enable or disable a notification on the homepage of this Bugzilla
+                installation when a newer version of Bugzilla is available. This
+                notification is only visible to administrators. Choose "disabled",
+                to turn off the notification. Otherwise, choose which version of
+                Bugzilla you want to be notified about: "development_snapshot" is the
+                latest release on the trunk; "latest_stable_release" is the most 
+                recent release available on the most recent stable branch; 
+                "stable_branch_release" the most recent release on the branch 
+                this installation is based on.
+              </para>
+            </listitem>
+          </varlistentry>
+
+        </variablelist>
+
+        </section>
+
+        <section id="param-admin-policies">
+          <title>Administrative Policies</title>
+          <para>
+            This page contains parameters for basic administrative functions.
+            Options include whether to allow the deletion of bugs and users,
+            and whether to allow users to change their email address.
+          </para>
+        </section>
+
+        <section id="param-user-authentication">
+          <title>User Authentication</title>
+          <para>
+            This page contains the settings that control how this Bugzilla
+            installation will do its authentication. Choose what authentication
+            mechanism to use (the Bugzilla database, or an external source such
+            as LDAP), and set basic behavioral parameters. For example, choose
+            whether to require users to login to browse bugs, the management
+            of authentication cookies, and the regular expression used to
+            validate email addresses. Some parameters are highlighted below.
+          </para>
+
+        <variablelist>
+
+          <varlistentry>
+            <term>
+              emailregexp
+            </term>
+            <listitem>
+              <para>
+                Defines the regular expression used to validate email addresses
+                used for login names. The default attempts to match fully
+                qualified email addresses (i.e. 'user@example.com') in a slightly
+                more restrictive way than what is allowed in RFC 2822.
+                Some Bugzilla installations allow only local user names (i.e 'user'
+                instead of 'user@example.com'). In that case, this parameter
+                should be used to define the email domain.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              emailsuffix
+            </term>
+            <listitem>
+              <para>
+                This string is appended to login names when actually sending 
+                email to a user. For example,
+                If <command>emailregexp</command> has been set to allow
+                local usernames,
+                then this parameter would contain the email domain for all users
+                (i.e. '@example.com').   
+              </para>
+            </listitem>
+          </varlistentry>
+
+        </variablelist>
+
+        </section>
+
+        <section id="param-attachments">
+          <title>Attachments</title>
+          <para>
+            This page allows for setting restrictions and other parameters
+            regarding attachments to bugs. For example, control size limitations
+            and whether to allow pointing to external files via a URI.
+          </para>
+        </section>
+
+        <section id="param-bug-change-policies">
+          <title>Bug Change Policies</title>
+          <para>
+            Set policy on default behavior for bug change events. For example,
+            choose which status to set a bug to when it is marked as a duplicate,
+            and choose whether to allow bug reporters to set the priority or
+            target milestone. Also allows for configuration of what changes
+            should require the user to make a comment, described below.    
+          </para>
+
+        <variablelist>
+
+          <varlistentry>
+            <term>
+              commenton*
+            </term>
+            <listitem>
+              <para>
+                All these fields allow you to dictate what changes can pass
+                without comment, and which must have a comment from the
+                person who changed them.  Often, administrators will allow
+                users to add themselves to the CC list, accept bugs, or
+                change the Status Whiteboard without adding a comment as to
+                their reasons for the change, yet require that most other
+                changes come with an explanation.
+              </para>
+
+              <para>
+                Set the "commenton" options according to your site policy. It
+                is a wise idea to require comments when users resolve, reassign, or
+                reopen bugs at the very least. 
+              </para>
+
+              <note>
+                <para>
+                  It is generally far better to require a developer comment
+                  when resolving bugs than not. Few things are more annoying to bug
+                  database users than having a developer mark a bug "fixed" without
+                  any comment as to what the fix was (or even that it was truly
+                  fixed!)
+                </para>
+              </note>
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term>
+              noresolveonopenblockers
+            </term>
+            <listitem>
+              <para>
+                This option will prevent users from resolving bugs as FIXED if
+                they have unresolved dependencies. Only the FIXED resolution
+                is affected. Users will be still able to resolve bugs to
+                resolutions other than FIXED if they have unresolved dependent
+                bugs.
+              </para>
+            </listitem>
+          </varlistentry>
+
+        </variablelist>
+
+        </section>
+
+        <section id="param-bugfields">
+          <title>Bug Fields</title>
+          <para>
+            The parameters in this section determine the default settings of
+            several Bugzilla fields for new bugs, and also control whether
+            certain fields are used. For example, choose whether to use the
+            "target milestone" field or the "status whiteboard" field.
+          </para>
+
+        <variablelist>
+
+          <varlistentry>    
+            <term>
+              useqacontact
+            </term>
+            <listitem>
+              <para>
+                This allows you to define an email address for each component, 
+                in addition to that of the default assignee, who will be sent
+                carbon copies of incoming bugs.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              usestatuswhiteboard
+            </term>
+            <listitem>
+              <para>
+                This defines whether you wish to have a free-form, overwritable field
+                associated with each bug. The advantage of the Status Whiteboard is
+                that it can be deleted or modified with ease, and provides an
+                easily-searchable field for indexing some bugs that have some trait
+                in common.         
+              </para>
+            </listitem>
+          </varlistentry>
+
+        </variablelist>
+
+        </section>
+
+        <section id="param-bugmoving">
+          <title>Bug Moving</title>
+          <para>
+            This page controls whether this Bugzilla installation allows certain
+            users to move bugs to an external database. If bug moving is enabled,
+            there are a number of parameters that control bug moving behaviors. 
+            For example, choose which users are allowed to move bugs, the location
+            of the external database, and the default product and component that
+            bugs moved <emphasis>from</emphasis> other bug databases to this 
+            Bugzilla installation are assigned to. 
+          </para>
+
+        </section>
+
+        <section id="param-dependency-graphs">
+          <title>Dependency Graphs</title>
+          <para>
+            This page has one parameter that sets the location of a Web Dot
+            server, or of the Web Dot binary on the local system, that is used
+            to generate dependency graphs. Web Dot is a CGI program that creates
+            images from <filename>.dot</filename> graphic description files. If
+            no Web Dot server or binary is specified, then dependency graphs will
+            be disabled.
+          </para>
+        </section>
+
+        <section id="param-group-security">
+          <title>Group Security</title>
+            <para>
+              Bugzilla allows for the creation of different groups, with the
+              ability to restrict the visibility of bugs in a group to a set of 
+              specific users. Specific products can also be associated with
+              groups, and users restricted to only see products in their groups.
+              Several parameters are described in more detail below. Most of the
+              configuration of groups and their relationship to products is done
+              on the "Groups" and "Product" pages of the "Administration" area.
+              The options on this page control global default behavior. 
+              For more information on Groups and Group Security, see
+              <xref linkend="groups"/> 
+            </para>
+
+        <variablelist>
+
+          <varlistentry>
+            <term>
+              makeproductgroups
+            </term>
+            <listitem>
+              <para>
+                Determines whether or not to automatically create groups
+                when new products are created. If this is on, the groups will be
+                used for querying bugs.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              usevisibilitygroups
+            </term>
+            <listitem>
+              <para>
+                If selected, user visibility will be restricted to members of
+                groups, as selected in the group configuration settings. 
+                Each user-defined group can be allowed to see members of selected
+                other groups. 
+                For details on configuring groups (including the visibility 
+                restrictions) see <xref linkend="edit-groups"/>. 
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              querysharegroup
+            </term>
+            <listitem>
+              <para>
+                The name of the group of users who are allowed to share saved
+                searches with one another. For more information on using 
+                saved searches, see <xref linkend="savedsearches"/>.
+              </para>
+            </listitem>
+          </varlistentry>
+
+        </variablelist>
+    
+        </section>
+
+        <section id="bzldap">
+          <title>LDAP Authentication</title>
+
+          <para>LDAP authentication is a module for Bugzilla's plugin 
+          authentication architecture. This page contains all the parameters
+          necessary to configure Bugzilla for use with LDAP authentication.
+          </para>
+
+          <para>
+          The existing authentication
+          scheme for Bugzilla uses email addresses as the primary user ID, and a
+          password to authenticate that user. All places within Bugzilla that
+          require a user ID (e.g assigning a bug) use the email
+          address. The LDAP authentication builds on top of this scheme, rather
+          than replacing it. The initial log-in is done with a username and
+          password for the LDAP directory. Bugzilla tries to bind to LDAP using
+          those credentials and, if successful, tries to map this account to a
+          Bugzilla account. If an LDAP mail attribute is defined, the value of this
+          attribute is used, otherwise the "emailsuffix" parameter is appended to LDAP
+          username to form a full email address. If an account for this address
+          already exists in the Bugzilla installation, it will log in to that account.
+          If no account for that email address exists, one is created at the time
+          of login. (In this case, Bugzilla will attempt to use the "displayName"
+          or "cn" attribute to determine the user's full name.) After
+          authentication, all other user-related tasks are still handled by email
+          address, not LDAP username. For example, bugs are still assigned by
+          email address and users are still queried by email address.
+          </para>
+
+          <caution>
+            <para>Because the Bugzilla account is not created until the first time
+            a user logs in, a user who has not yet logged is unknown to Bugzilla.
+            This means they cannot be used as an assignee or QA contact (default or
+            otherwise), added to any CC list, or any other such operation. One
+            possible workaround is the <filename>bugzilla_ldapsync.rb</filename>
+            script in the
+            <glossterm linkend="gloss-contrib">
+            <filename class="directory">contrib</filename></glossterm> 
+            directory. Another possible solution is fixing
+            <ulink url="https://bugzilla.mozilla.org/show_bug.cgi?id=201069">bug
+            201069</ulink>.
+            </para>
+          </caution>
+
+          <para>Parameters required to use LDAP Authentication:</para>
+
+          <variablelist>
+            <varlistentry id="param-user_verify_class_for_ldap">
+              <term>user_verify_class</term>
+              <listitem>
+                <para>If you want to list <quote>LDAP</quote> here,
+                make sure to have set up the other parameters listed below.
+                Unless you have other (working) authentication methods listed as
+                well, you may otherwise not be able to log back in to Bugzilla once
+                you log out.
+                If this happens to you, you will need to manually edit
+                <filename>data/params</filename> and set user_verify_class to
+                <quote>DB</quote>.
+                </para>
+              </listitem>
+            </varlistentry>
+    
+            <varlistentry id="param-LDAPserver">
+              <term>LDAPserver</term>
+              <listitem>
+                <para>This parameter should be set to the name (and optionally the
+                port) of your LDAP server. If no port is specified, it assumes
+                the default LDAP port of 389.
+                </para>
+                <para>For example: <quote>ldap.company.com</quote>
+                 or <quote>ldap.company.com:3268</quote>
+                </para>
+                <para>You can also specify a LDAP URI, so as to use other
+                protocols, such as LDAPS or LDAPI. If port was not specified in
+                the URI, the default is either 389 or 636 for 'LDAP' and 'LDAPS'
+                schemes respectively.
+                </para>
+                <tip>
+                  <para>
+                    In order to use SSL with LDAP, specify a URI with "ldaps://".
+                    This will force the use of SSL over port 636.
+                  </para>
+                </tip>
+                <para>For example, normal LDAP: 
+                <quote>ldap://ldap.company.com</quote>, LDAP over SSL:
+                <quote>ldaps://ldap.company.com</quote> or LDAP over a UNIX 
+                domain socket <quote>ldapi://%2fvar%2flib%2fldap_sock</quote>.
+                </para>
+               </listitem>
+             </varlistentry>
+    
+             <varlistentry id="param-LDAPbinddn">
+               <term>LDAPbinddn [Optional]</term>
+               <listitem>
+                 <para>Some LDAP servers will not allow an anonymous bind to search
+                 the directory. If this is the case with your configuration you
+                 should set the LDAPbinddn parameter to the user account Bugzilla
+                 should use instead of the anonymous bind.
+                 </para>
+                 <para>Ex. <quote>cn=default,cn=user:password</quote></para>
+               </listitem>
+             </varlistentry>
+    
+             <varlistentry id="param-LDAPBaseDN">
+               <term>LDAPBaseDN</term>
+               <listitem>
+                 <para>The LDAPBaseDN parameter should be set to the location in
+                 your LDAP tree that you would like to search for email addresses.
+                 Your uids should be unique under the DN specified here.
+                 </para>
+                 <para>Ex. <quote>ou=People,o=Company</quote></para>
+               </listitem>
+             </varlistentry>
+    
+             <varlistentry id="param-LDAPuidattribute">
+               <term>LDAPuidattribute</term>
+               <listitem>
+                 <para>The LDAPuidattribute parameter should be set to the attribute
+                 which contains the unique UID of your users. The value retrieved
+                 from this attribute will be used when attempting to bind as the
+                 user to confirm their password.
+                 </para>
+                 <para>Ex. <quote>uid</quote></para>
+               </listitem>
+             </varlistentry>
+
+             <varlistentry id="param-LDAPmailattribute">
+               <term>LDAPmailattribute</term>
+               <listitem>
+                 <para>The LDAPmailattribute parameter should be the name of the
+                 attribute which contains the email address your users will enter
+                 into the Bugzilla login boxes.
+                 </para>
+                 <para>Ex. <quote>mail</quote></para>
+               </listitem>
+              </varlistentry>
+          </variablelist>
+
+        </section>
+
+        <section id="bzradius">
+          <title>RADIUS Authentication</title>
+
+          <para>
+          RADIUS authentication is a module for Bugzilla's plugin 
+          authentication architecture. This page contains all the parameters
+          necessary for configuring Bugzilla to use RADIUS authentication.
+          </para>
+          <note>
+            <para>
+              Most caveats that apply to LDAP authentication apply to RADIUS
+              authentication as well. See <xref linkend="bzldap"/> for details.
+            </para>
+          </note>
+
+          <para>Parameters required to use RADIUS Authentication:</para>
+
+          <variablelist>
+            <varlistentry id="param-user_verify_class_for_radius">
+              <term>user_verify_class</term>
+              <listitem>
+                <para>If you want to list <quote>RADIUS</quote> here,
+                make sure to have set up the other parameters listed below.
+                Unless you have other (working) authentication methods listed as
+                well, you may otherwise not be able to log back in to Bugzilla once
+                you log out.
+                If this happens to you, you will need to manually edit
+                <filename>data/params</filename> and set user_verify_class to
+                <quote>DB</quote>.
+                </para>
+              </listitem>
+            </varlistentry>
+    
+            <varlistentry id="param-RADIUS_server">
+              <term>RADIUS_server</term>
+              <listitem>
+                <para>This parameter should be set to the name (and optionally the
+                port) of your RADIUS server.
+                </para>
+              </listitem>
+            </varlistentry>
+    
+            <varlistentry id="param-RADIUS_secret">
+              <term>RADIUS_secret</term>
+              <listitem>
+                <para>This parameter should be set to the RADIUS server's secret.
+                </para>
+              </listitem>
+            </varlistentry>
+
+            <varlistentry id="param-RADIUS_email_suffix">
+              <term>RADIUS_email_suffix</term>
+              <listitem>
+                <para>Bugzilla needs an e-mail address for each user account.
+                Therefore, it needs to determine the e-mail address corresponding
+                to a RADIUS user.
+                Bugzilla offers only a simple way to do this: it can concatenate
+                a suffix to the RADIUS user name to convert it into an e-mail
+                address.
+                You can specify this suffix in the RADIUS_email_suffix parameter.
+                </para>
+                <para>If this simple solution does not work for you, you'll
+                probably need to modify
+                <filename>Bugzilla/Auth/Verify/RADIUS.pm</filename> to match your
+                requirements.
+                </para>
+              </listitem>
+            </varlistentry>
+          </variablelist>
+
+        </section>
+    
+        <section id="param-email">
+          <title>Email</title>
+          <para>
+            This page contains all of the parameters for configuring how
+            Bugzilla deals with the email notifications it sends. See below
+            for a summary of important options. 
+          </para>
+
+        <variablelist>
+
+          <varlistentry>
+            <term>
+              mail_delivery_method
+            </term>
+            <listitem>
+              <para>
+                This is used to specify how email is sent, or if it is sent at 
+                all.  There are several options included for different MTAs, 
+                along with two additional options that disable email sending.  
+                "Test" does not send mail, but instead saves it in 
+                <filename>data/mailer.testfile</filename> for later review.  
+                "None" disables email sending entirely.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              mailfrom
+            </term>
+            <listitem>
+              <para>
+                This is the email address that will appear in the "From" field
+                of all emails sent by this Bugzilla installation. Some email
+                servers require mail to be from a valid email address, therefore
+                it is recommended to choose a valid email address here.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              smtpserver
+            </term>
+            <listitem>
+              <para>
+                This is the SMTP server address, if the <quote>mail_delivery_method</quote>
+                parameter is set to SMTP.  Use "localhost" if you have a local MTA
+                running, otherwise use a remote SMTP server.  Append ":" and the port
+                number, if a non-default port is needed.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              smtp_username
+            </term>
+            <listitem>
+              <para>
+                Username to use for SASL authentication to the SMTP server.  Leave
+                this parameter empty if your server does not require authentication.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              smtp_password
+            </term>
+            <listitem>
+              <para>
+                Password to use for SASL authentication to the SMTP server. This
+                parameter will be ignored if the <quote>smtp_username</quote>
+                parameter is left empty.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              smtp_ssl
+            </term>
+            <listitem>
+              <para>
+                Enable SSL support for connection to the SMTP server.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              smtp_debug
+            </term>
+            <listitem>
+              <para>
+                This parameter allows you to enable detailed debugging output.
+                Log messages are printed the web server's error log.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              whinedays
+            </term>
+            <listitem>
+              <para>
+                Set this to the number of days you want to let bugs go
+                in the CONFIRMED state before notifying people they have
+                untouched new bugs. If you do not plan to use this feature, simply 
+                do not set up the whining cron job described in the installation
+                instructions, or set this value to "0" (never whine).
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>
+              globalwatcher
+            </term>
+            <listitem>
+              <para>
+                This allows you to define specific users who will
+                receive notification each time a new bug in entered, or when
+                an existing bug changes, according to the normal groupset
+                permissions. It may be useful for sending notifications to a
+                mailing-list, for instance.
+              </para>
+            </listitem>
+          </varlistentry>
+
+        </variablelist>
+
+        </section>
+
+        <section id="param-patchviewer">
+          <title>Patch Viewer</title>
+          <para>
+            This page contains configuration parameters for the CVS server, 
+            Bonsai server and LXR server that Bugzilla will use to enable the
+            features of the Patch Viewer. Bonsai is a tool that enables queries 
+            to a CVS tree. LXR is a tool that can cross reference and index source
+            code.
+          </para>
+        </section>
+
+        <section id="param-querydefaults">
+          <title>Query Defaults</title>
+          <para>
+            This page controls the default behavior of Bugzilla in regards to 
+            several aspects of querying bugs. Options include what the default
+            query options are, what the "My Bugs" page returns, whether users
+            can freely add bugs to the quip list, and how many duplicate bugs are 
+            needed to add a bug to the "most frequently reported" list.
+          </para>
+        </section>
+
+        <section id="param-shadowdatabase">
+          <title>Shadow Database</title>
+          <para>
+            This page controls whether a shadow database is used, and all the
+            parameters associated with the shadow database. Versions of Bugzilla
+            prior to 3.2 used the MyISAM table type, which supports
+            only table-level write locking. With MyISAM, any time someone is making a change to 
+            a bug, the entire table is locked until the write operation is complete.
+            Locking for write also blocks reads until the write is complete.
+          </para> 
+          <para>
+            The <quote>shadowdb</quote> parameter was designed to get around
+            this limitation. While only a single user is allowed to write to
+            a table at a time, reads can continue unimpeded on a read-only
+            shadow copy of the database.
+          </para>
+
+          <note>
+            <para>
+              As of version 3.2, Bugzilla no longer uses the MyISAM table type.
+              Instead, InnoDB is used, which can do transaction-based locking.
+              Therefore, the limitations the Shadow Database feature was designed
+              to workaround no longer exist.
+            </para>
+          </note>
+
+        </section>
+
+        <section id="admin-usermatching">
+          <title>User Matching</title>
+          <para>
+            The settings on this page control how users are selected and queried
+            when adding a user to a bug. For example, users need to be selected
+            when choosing who the bug is assigned to, adding to the CC list or 
+            selecting a QA contact. With the "usemenuforusers" parameter, it is 
+            possible to configure Bugzilla to 
+            display a list of users in the fields instead of an empty text field.
+            This should only be used in Bugzilla installations with a small number
+            of users. If users are selected via a text box, this page also
+            contains parameters for how user names can be queried and matched
+            when entered.
+          </para>
+          <para>
+            Another setting called 'ajax_user_autocompletion' enables certain
+            user fields to display a list of matched user names as a drop down after typing 
+            a few characters. Note that it is recommended to use mod_perl when
+            enabling 'ajax_user_autocompletion'.
+          </para>
+        </section>
+
+  </section>
+
+  <section id="useradmin">
+    <title>User Administration</title>
+
+    <section id="defaultuser">
+      <title>Creating the Default User</title>
+
+      <para>When you first run checksetup.pl after installing Bugzilla, it
+      will prompt you for the administrative username (email address) and
+      password for this "super user". If for some reason you delete
+      the "super user" account, re-running checksetup.pl will again prompt
+      you for this username and password.</para>
+
+      <tip>
+        <para>If you wish to add more administrative users, add them to 
+        the "admin" group and, optionally, edit the tweakparams, editusers,
+        creategroups, editcomponents, and editkeywords groups to add the
+        entire admin group to those groups (which is the case by default).
+        </para>
+      </tip>
+    </section>
+
+    <section id="manageusers">
+      <title>Managing Other Users</title>
+
+      <section id="user-account-search">
+        <title>Searching for existing users</title>
+
+        <para>
+          If you have <quote>editusers</quote> privileges or if you are allowed
+          to grant privileges for some groups, the <quote>Users</quote> link
+          will appear in the Administration page.
+        </para>
+
+        <para>
+          The first screen is a search form to search for existing user
+          accounts. You can run searches based either on the user ID, real
+          name or login name (i.e. the email address, or just the first part
+          of the email address if the "emailsuffix" parameter is set).
+          The search can be conducted
+          in different ways using the listbox to the right of the text entry
+          box. You can match by case-insensitive substring (the default),
+          regular expression, a <emphasis>reverse</emphasis> regular expression
+          match (which finds every user name which does NOT match the regular
+          expression), or the exact string if you know exactly who you are
+          looking for. The search can be restricted to users who are in a
+          specific group. By default, the restriction is turned off.
+        </para>
+
+        <para>
+          The search returns a list of
+          users matching your criteria. User properties can be edited by clicking
+          the login name. The Account History of a user can be viewed by clicking
+          the "View" link in the Account History column. The Account History
+          displays changes that have been made to the user account, the time of
+          the change and the user who made the change. For example, the Account
+          History page will display details of when a user was added or removed
+          from a group.
+        </para>
+      </section>
+
+      <section id="createnewusers">
+        <title>Creating new users</title>
+
+        <section id="self-registration">
+          <title>Self-registration</title>
+
+          <para>
+            By default, users can create their own user accounts by clicking the
+            <quote>New Account</quote> link at the bottom of each page (assuming
+            they aren't logged in as someone else already). If you want to disable
+            this self-registration, or if you want to restrict who can create his
+            own user account, you have to edit the <quote>createemailregexp</quote>
+            parameter in the <quote>Configuration</quote> page, see
+            <xref linkend="parameters" />.
+          </para>
+        </section>
+
+        <section id="user-account-creation">
+          <title>Accounts created by an administrator</title>
+
+          <para>
+            Users with <quote>editusers</quote> privileges, such as administrators,
+            can create user accounts for other users:
+          </para>
+
+          <orderedlist>
+            <listitem>
+              <para>After logging in, click the "Users" link at the footer of
+              the query page, and then click "Add a new user".</para>
+            </listitem>
+
+            <listitem>
+              <para>Fill out the form presented. This page is self-explanatory.
+              When done, click "Submit".</para>
+
+              <note>
+                <para>Adding a user this way will <emphasis>not</emphasis>
+                send an email informing them of their username and password.
+                While useful for creating dummy accounts (watchers which
+                shuttle mail to another system, for instance, or email
+                addresses which are a mailing list), in general it is
+                preferable to log out and use the <quote>New Account</quote>
+                button to create users, as it will pre-populate all the
+                required fields and also notify the user of her account name
+                and password.</para>
+              </note>
+            </listitem>
+          </orderedlist>
+        </section>
+      </section>
+
+      <section id="modifyusers">
+        <title>Modifying Users</title>
+
+        <para>Once you have found your user, you can change the following
+        fields:</para>
+
+        <itemizedlist>
+          <listitem>
+            <para>
+            <emphasis>Login Name</emphasis>: 
+            This is generally the user's full email address. However, if you
+            have are using the <quote>emailsuffix</quote> parameter, this may
+            just be the user's login name. Note that users can now change their
+            login names themselves (to any valid email address).
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+            <emphasis>Real Name</emphasis>: The user's real name. Note that
+            Bugzilla does not require this to create an account.</para>
+          </listitem>
+
+          <listitem>
+            <para>
+            <emphasis>Password</emphasis>: 
+            You can change the user's password here. Users can automatically
+            request a new password, so you shouldn't need to do this often.
+            If you want to disable an account, see Disable Text below.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <emphasis>Bugmail Disabled</emphasis>:
+              Mark this checkbox to disable bugmail and whinemail completely
+              for this account. This checkbox replaces the data/nomail file
+              which existed in older versions of Bugzilla.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <emphasis>Disable Text</emphasis>: 
+              If you type anything in this box, including just a space, the
+              user is prevented from logging in, or making any changes to 
+              bugs via the web interface. 
+              The HTML you type in this box is presented to the user when
+              they attempt to perform these actions, and should explain
+              why the account was disabled.
+            </para>
+            <para>
+              Users with disabled accounts will continue to receive
+              mail from Bugzilla; furthermore, they will not be able
+              to log in themselves to change their own preferences and
+              stop it. If you want an account (disabled or active) to
+              stop receiving mail, simply check the
+              <quote>Bugmail Disabled</quote> checkbox above.
+            </para>
+            <note>
+              <para>
+                Even users whose accounts have been disabled can still
+                submit bugs via the e-mail gateway, if one exists.
+                The e-mail gateway should <emphasis>not</emphasis> be
+                enabled for secure installations of Bugzilla.
+              </para>
+            </note>
+            <warning>
+              <para>
+                Don't disable all the administrator accounts!
+              </para>
+            </warning>
+          </listitem>
+
+          <listitem>
+            <para>
+            <emphasis>&lt;groupname&gt;</emphasis>: 
+            If you have created some groups, e.g. "securitysensitive", then
+            checkboxes will appear here to allow you to add users to, or
+            remove them from, these groups. The first checkbox gives the
+            user the ability to add and remove other users as members of
+            this group. The second checkbox adds the user himself as a member
+            of the group.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+            <emphasis>canconfirm</emphasis>: 
+            This field is only used if you have enabled the "unconfirmed"
+            status. If you enable this for a user,
+            that user can then move bugs from "Unconfirmed" to a "Confirmed"
+            status (e.g.: "New" status).</para>
+          </listitem>
+
+          <listitem>
+            <para>
+            <emphasis>creategroups</emphasis>: 
+            This option will allow a user to create and destroy groups in
+            Bugzilla.</para>
+          </listitem>
+
+          <listitem>
+            <para>
+            <emphasis>editbugs</emphasis>: 
+            Unless a user has this bit set, they can only edit those bugs
+            for which they are the assignee or the reporter. Even if this
+            option is unchecked, users can still add comments to bugs.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+            <emphasis>editcomponents</emphasis>: 
+            This flag allows a user to create new products and components,
+            as well as modify and destroy those that have no bugs associated
+            with them. If a product or component has bugs associated with it,
+            those bugs must be moved to a different product or component
+            before Bugzilla will allow them to be destroyed.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+            <emphasis>editkeywords</emphasis>: 
+            If you use Bugzilla's keyword functionality, enabling this
+            feature allows a user to create and destroy keywords. As always,
+            the keywords for existing bugs containing the keyword the user
+            wishes to destroy must be changed before Bugzilla will allow it
+            to die.</para>
+          </listitem>
+
+          <listitem>
+            <para>
+            <emphasis>editusers</emphasis>: 
+            This flag allows a user to do what you're doing right now: edit
+            other users. This will allow those with the right to do so to
+            remove administrator privileges from other users or grant them to
+            themselves. Enable with care.</para>
+          </listitem>
+
+
+          <listitem>
+            <para>
+            <emphasis>tweakparams</emphasis>: 
+            This flag allows a user to change Bugzilla's Params 
+            (using <filename>editparams.cgi</filename>.)</para>
+          </listitem>
+
+          <listitem>
+            <para> 
+            <emphasis>&lt;productname&gt;</emphasis>:
+            This allows an administrator to specify the products 
+            in which a user can see bugs. If you turn on the 
+            <quote>makeproductgroups</quote> parameter in
+            the Group Security Panel in the Parameters page, 
+            then Bugzilla creates one group per product (at the time you create 
+            the product), and this group has exactly the same name as the 
+            product itself. Note that for products that already exist when
+            the parameter is turned on, the corresponding group will not be
+            created. The user must still have the <quote>editbugs</quote> 
+            privilege to edit bugs in these products.</para>
+          </listitem>
+        </itemizedlist>
+      </section>
+
+      <section id="user-account-deletion">
+        <title>Deleting Users</title>
+        <para>
+          If the <quote>allowuserdeletion</quote> parameter is turned on, see
+          <xref linkend="parameters" />, then you can also delete user accounts.
+          Note that this is most of the time not the best thing to do. If only
+          a warning in a yellow box is displayed, then the deletion is safe.
+          If a warning is also displayed in a red box, then you should NOT try
+          to delete the user account, else you will get referential integrity
+          problems in your database, which can lead to unexpected behavior,
+          such as bugs not appearing in bug lists anymore, or data displaying
+          incorrectly. You have been warned!
+        </para>
+      </section>
+
+      <section id="impersonatingusers">
+        <title>Impersonating Users</title>
+        
+        <para>
+        There may be times when an administrator would like to do something as
+        another user.  The <command>sudo</command> feature may be used to do 
+        this.
+        </para>
+        
+        <note>
+          <para>
+          To use the sudo feature, you must be in the
+          <emphasis>bz_sudoers</emphasis> group.  By default, all
+          administrators are in this group.</para>
+        </note>
+        
+        <para>
+        If you have access to this feature, you may start a session by
+        going to the Edit Users page, Searching for a user and clicking on 
+        their login.  You should see a link below their login name titled 
+        "Impersonate this user".  Click on the link.  This will take you 
+        to a page where you will see a description of the feature and 
+        instructions for using it.  After reading the text, simply 
+        enter the login of the user you would like to impersonate, provide 
+        a short message explaining why you are doing this, and press the 
+        button.</para>
+        
+        <para>
+        As long as you are using this feature, everything you do will be done 
+        as if you were logged in as the user you are impersonating.</para>
+        
+        <warning>
+          <para>
+          The user you are impersonating will not be told about what you are 
+          doing.  If you do anything that results in mail being sent, that 
+          mail will appear to be from the user you are impersonating.  You 
+          should be extremely careful while using this feature.</para>
+        </warning>
+      </section>
+    </section>
+  </section>
+
+  <section id="classifications" xreflabel="Classifications">
+    <title>Classifications</title>
+
+    <para>Classifications tend to be used in order to group several related
+    products into one distinct entity.</para>
+
+    <para>The classifications layer is disabled by default; it can be turned
+    on or off using the useclassification parameter,
+    in the <emphasis>Bug Fields</emphasis> section of the edit parameters screen.</para>
+
+    <para>Access to the administration of classifications is controlled using
+    the <emphasis>editclassifications</emphasis> system group, which defines
+    a privilege for creating, destroying, and editing classifications.</para>
+
+    <para>When activated, classifications will introduce an additional
+    step when filling bugs (dedicated to classification selection), and they
+    will also appear in the advanced search form.</para>
+  </section>
+
+  <section id="products" xreflabel="Products">
+    <title>Products</title>
+
+    <para>
+    <glossterm linkend="gloss-product" baseform="product">
+    Products</glossterm> typically represent real-world
+    shipping products. Products can be given 
+    <xref linkend="classifications"/>. 
+    For example, if a company makes computer games, 
+    they could have a classification of "Games", and a separate
+    product for each game. This company might also have a 
+    <quote>Common</quote> product for units of technology used 
+    in multiple games, and perhaps a few special products that
+    represent items that are not actually shipping products 
+    (for example, "Website", or "Administration").
+    </para>
+
+    <para>
+    Many of Bugzilla's settings are configurable on a per-product
+    basis. The number of <quote>votes</quote> available to 
+    users is set per-product, as is the number of votes
+    required to move a bug automatically from the UNCONFIRMED 
+    status to the CONFIRMED status.
+    </para>
+
+    <para>
+    When creating or editing products the following options are
+    available: 
+    </para> 
+
+    <variablelist>
+
+      <varlistentry>
+        <term>
+          Product
+        </term>
+        <listitem>
+          <para> 
+            The name of the product
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>
+          Description
+        </term>
+        <listitem>
+          <para> 
+            A brief description of the product
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>
+          Default milestone
+        </term>
+        <listitem>
+          <para> 
+            Select the default milestone for this product.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>
+          Closed for bug entry
+        </term>
+        <listitem>
+          <para> 
+            Select this box to prevent new bugs from being
+            entered against this product.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>
+          Maximum votes per person
+        </term>
+        <listitem>
+          <para> 
+            Maximum votes a user is allowed to give for this 
+            product
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>
+          Maximum votes a person can put on a single bug
+        </term>
+        <listitem>
+          <para> 
+            Maximum votes a user is allowed to give for this 
+            product in a single bug
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>
+          Confirmation threshold
+        </term>
+        <listitem>
+          <para> 
+            Number of votes needed to automatically remove any
+            bug against this product from the UNCONFIRMED state
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>
+          Version
+        </term>
+        <listitem>
+          <para> 
+            Specify which version of the product bugs will be
+            entered against.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>
+          Create chart datasets for this product
+        </term>
+        <listitem>
+          <para> 
+            Select to make chart datasets available for this product.
+          </para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+    <para>
+    When editing a product there is also a link to edit Group Access Controls,
+    see <xref linkend="product-group-controls"/>.
+    </para>
+
+    <section id="create-product">
+      <title>Creating New Products</title>
+
+    <para>
+    To create a new product:
+    </para>
+
+    <orderedlist>
+      <listitem>
+        <para> 
+        Select <quote>Administration</quote> from the footer and then
+        choose <quote>Products</quote> from the main administration page.
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+        Select the <quote>Add</quote> link in the bottom right.
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+        Enter the name of the product and a description. The
+        Description field may contain HTML.
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+        When the product is created, Bugzilla will give a message
+        stating that a component must be created before any bugs can
+        be entered against the new product. Follow the link to create
+        a new component. See <xref linkend="components"/> for more
+        information.
+        </para>
+      </listitem>
+    </orderedlist>
+
+    </section>
+
+    <section id="edit-products">
+      <title>Editing Products</title>
+
+      <para>
+      To edit an existing product, click the "Products" link from the 
+      "Administration" page. If the 'useclassification' parameter is
+      turned on, a table of existing classifications is displayed,
+      including an "Unclassified" category. The table indicates how many products
+      are in each classification. Click on the classification name to see its
+      products. If the 'useclassification' parameter is not in use, the table 
+      lists all products directly. The product table summarizes the information 
+      about the product defined
+      when the product was created. Click on the product name to edit these
+      properties, and to access links to other product attributes such as the
+      product's components, versions, milestones, and group access controls.
+      </para>
+
+      </section>
+
+      <section id="comps-vers-miles-products">
+        <title>Adding or Editing Components, Versions and Target Milestones</title>
+        <para>
+          To edit existing, or add new, Components, Versions or Target Milestones 
+          to a Product, select the "Edit Components", "Edit Versions" or "Edit
+          Milestones" links from the "Edit Product" page. A table of existing 
+          Components, Versions or Milestones is displayed. Click on a item name 
+          to edit the properties of that item. Below the table is a link to add 
+          a new Component, Version or Milestone. 
+        </para>
+        <para>
+          For more information on components, see <xref linkend="components"/>.
+        </para>
+        <para>
+          For more information on versions, see <xref linkend="versions"/>.
+        </para>
+        <para>
+          For more information on milestones, see <xref linkend="milestones"/>.
+        </para>
+      </section>
+
+      <section id="product-group-controls">
+        <title>Assigning Group Controls to Products</title>
+
+        <para> 
+        On the <quote>Edit Product</quote> page, there is a link called 
+        <quote>Edit Group Access Controls</quote>. The settings on this page 
+        control the relationship of the groups to the product being edited.
+        </para> 
+
+        <para>
+        Group Access Controls are an important aspect of using groups for 
+        isolating products and restricting access to bugs filed against those
+        products. For more information on groups, including how to create, edit
+        add users to, and alter permission of, see <xref linkend="groups"/>.
+        </para>
+
+        <para>
+        After selecting the "Edit Group Access Controls" link from the "Edit
+        Product" page, a table containing all user-defined groups for this 
+        Bugzilla installation is displayed. The system groups that are created
+        when Bugzilla is installed are not applicable to Group Access Controls.
+        Below is description of what each of these fields means.
+        </para>
+
+        <para>
+        Groups may be applicable (e.g bugs in this product can be associated
+        with this group) , default (e.g. bugs in this product are in this group
+        by default), and mandatory (e.g. bugs in this product must be associated
+        with this group) for each product. Groups can also control access 
+        to bugs for a given product, or be used to make bugs for a product 
+        totally read-only unless the group restrictions are met. The best way to
+        understand these relationships is by example. See 
+        <xref linkend="group-control-examples"/> for examples of 
+        product and group relationships.
+        </para>
+  
+        <note>
+          <para>
+            Products and Groups are not limited to a one-to-one relationship. 
+            Multiple groups can be associated with the same product, and groups
+            can be associated with more than one product. 
+          </para>
+        </note> 
+
+        <para>
+        If any group has <emphasis>Entry</emphasis> selected, then the 
+        product will restrict bug entry to only those users 
+        who are members of <emphasis>all</emphasis> the groups with 
+        <emphasis>Entry</emphasis> selected.
+        </para>
+
+        <para>
+        If any group has <emphasis>Canedit</emphasis> selected, 
+        then the product will be read-only for any users 
+        who are not members of <emphasis>all</emphasis> of the groups with
+        <emphasis>Canedit</emphasis> selected. <emphasis>Only</emphasis> users who 
+        are members of all the <emphasis>Canedit</emphasis> groups 
+        will be able to edit bugs for this product. This is an additional 
+        restriction that enables finer-grained control over products rather 
+        than just all-or-nothing access levels.
+        </para>
+
+        <para>
+        The following settings let you 
+        choose privileges on a <emphasis>per-product basis</emphasis>.
+        This is a convenient way to give privileges to 
+        some users for some products only, without having 
+        to give them global privileges which would affect 
+        all products.
+        </para>
+
+        <para>
+        Any group having <emphasis>editcomponents</emphasis> 
+        selected  allows users who are in this group to edit all 
+        aspects of this product, including components, milestones 
+        and versions.
+        </para>
+
+        <para>
+        Any group having <emphasis>canconfirm</emphasis> selected 
+        allows users who are in this group to confirm bugs 
+        in this product.
+        </para>
+
+        <para>
+        Any group having <emphasis>editbugs</emphasis> selected allows 
+        users who are in this group to edit all fields of 
+        bugs in this product.
+        </para>
+
+        <para>
+        The <emphasis>MemberControl</emphasis> and 
+        <emphasis>OtherControl</emphasis> are used in tandem to determine which 
+        bugs will be placed in this group. The only allowable combinations of
+        these two parameters are listed in a table on the "Edit Group Access Controls"
+        page. Consult this table for details on how these fields can be used.
+        Examples of different uses are described below.
+        </para>
+
+      <section id="group-control-examples">
+      <title>Common Applications of Group Controls</title>
+
+      <para>
+        The use of groups is best explained by providing examples that illustrate
+        configurations for common use cases. The examples follow a common syntax:
+        <emphasis>Group: Entry, MemberControl, OtherControl, CanEdit,
+        EditComponents, CanConfirm, EditBugs</emphasis>. Where "Group" is the name
+        of the group being edited for this product. The other fields all
+        correspond to the table on the "Edit Group Access Controls" page. If any
+        of these options are not listed, it means they are not checked.      
+      </para>
+      
+          <para>
+            Basic Product/Group Restriction
+          </para>
+
+        <para>
+          Suppose there is a product called "Bar". The 
+          "Bar" product can only have bugs entered against it by users in the
+          group "Foo". Additionally, bugs filed against product "Bar" must stay
+          restricted to users to "Foo" at all times. Furthermore, only members
+          of group "Foo" can edit bugs filed against product "Bar", even if other
+          users could see the bug. This arrangement would achieved by the
+          following:
+        </para>
+
+        <programlisting>
+Product Bar: 
+foo: ENTRY, MANDATORY/MANDATORY, CANEDIT
+        </programlisting>
+
+        <para>
+          Perhaps such strict restrictions are not needed for product "Bar". A 
+          more lenient way to configure product "Bar" and group "Foo" would be:
+        </para>
+
+        <programlisting>
+Product Bar: 
+foo: ENTRY, SHOWN/SHOWN, EDITCOMPONENTS, CANCONFIRM, EDITBUGS
+        </programlisting>
+
+        <para>
+          The above indicates that for product "Bar", members of group "Foo" can
+          enter bugs. Any one with permission to edit a bug against product "Bar"
+          can put the bug
+          in group "Foo", even if they themselves are not in "Foo". Anyone in group
+          "Foo" can edit all aspects of the components of product "Bar", can confirm
+          bugs against product "Bar", and can edit all fields of any bug against
+          product "Bar".
+        </para>
+ 
+          <para>
+            General User Access With Security Group
+          </para>
+
+             <para>
+               To permit any user to file bugs against "Product A",
+               and to permit any user to submit those bugs into a
+               group called "Security":  
+            </para>
+
+      <programlisting> 
+Product A:
+security: SHOWN/SHOWN
+      </programlisting>
+
+          <para>
+            General User Access With A Security Product
+          </para>
+
+          <para>
+            To permit any user to file bugs against product called "Security"
+            while keeping those bugs from becoming visible to anyone
+            outside the group "SecurityWorkers" (unless a member of the
+            "SecurityWorkers" group removes that restriction):
+          </para>
+
+          <programlisting> 
+Product Security:
+securityworkers: DEFAULT/MANDATORY
+          </programlisting>
+
+          <para>
+            Product Isolation With a Common Group
+          </para>
+
+          <para>
+            To permit users of "Product A" to access the bugs for
+            "Product A", users of "Product B" to access the bugs for 
+            "Product B", and support staff, who are members of the "Support 
+            Group" to access both, three groups are needed:
+          </para>
+
+          <orderedlist>
+
+          <listitem>
+            <para>Support Group: Contains members of the support staff.</para>
+          </listitem>
+
+          <listitem>
+            <para>AccessA Group: Contains users of product A and the Support group.</para>
+          </listitem>
+
+          <listitem>
+            <para>AccessB Group: Contains users of product B and the Support group.</para>
+          </listitem>
+
+          </orderedlist>
+
+          <para>
+            Once these three groups are defined, the product group controls
+            can be set to:
+          </para>
+
+          <programlisting>
+Product A:
+AccessA: ENTRY, MANDATORY/MANDATORY
+Product B:
+AccessB: ENTRY, MANDATORY/MANDATORY
+        </programlisting>
+
+        <para>
+         Perhaps the "Support Group" wants more control. For example, 
+         the "Support Group"  could be permitted to make bugs inaccessible to 
+         users of both groups "AccessA" and "AccessB". 
+         Then, the "Support Group" could be permitted to publish
+         bugs relevant to all users in a third product (let's call it 
+         "Product Common") that is read-only
+         to anyone outside the "Support Group". In this way the "Support Group" 
+         could control bugs that should be seen by both groups. 
+         That configuration would be:
+        </para>
+
+      <programlisting>
+Product A:
+AccessA: ENTRY, MANDATORY/MANDATORY
+Support: SHOWN/NA
+Product B:
+AccessB: ENTRY, MANDATORY/MANDATORY
+Support: SHOWN/NA
+Product Common:
+Support: ENTRY, DEFAULT/MANDATORY, CANEDIT
+      </programlisting>
+
+          <para>
+            Make a Product Read Only
+          </para>
+
+          <para>
+            Sometimes a product is retired and should no longer have
+            new bugs filed against it (for example, an older version of a software
+            product that is no longer supported). A product can be made read-only
+            by creating a group called "readonly" and adding products to the
+            group as needed:
+          </para>
+
+         <programlisting>
+Product A:
+ReadOnly: ENTRY, NA/NA, CANEDIT
+         </programlisting>
+
+        <note>
+          <para>
+            For more information on Groups outside of how they relate to products
+            see <xref linkend="groups"/>.
+          </para>
+        </note>
+
+       </section>
+
+    </section>
+
+  </section>
+
+  <section id="components" xreflabel="Components">
+    <title>Components</title>
+
+    <para>Components are subsections of a Product. E.g. the computer game 
+    you are designing may have a "UI"
+    component, an "API" component, a "Sound System" component, and a
+    "Plugins" component, each overseen by a different programmer. It
+    often makes sense to divide Components in Bugzilla according to the
+    natural divisions of responsibility within your Product or
+    company.</para>
+
+    <para>
+    Each component has a default assignee and (if you turned it on in the parameters),
+    a QA Contact. The default assignee should be the primary person who fixes bugs in
+    that component. The QA Contact should be the person who will ensure
+    these bugs are completely fixed. The Assignee, QA Contact, and Reporter
+    will get email when new bugs are created in this Component and when
+    these bugs change. Default Assignee and Default QA Contact fields only
+    dictate the 
+    <emphasis>default assignments</emphasis>; 
+    these can be changed on bug submission, or at any later point in
+    a bug's life.</para>
+
+    <para>To create a new Component:</para>
+
+   <orderedlist>
+      <listitem>
+        <para>Select the <quote>Edit components</quote> link 
+        from the <quote>Edit product</quote> page</para>
+      </listitem>
+
+      <listitem>
+        <para>Select the <quote>Add</quote> link in the bottom right.</para>
+      </listitem>
+
+      <listitem>
+        <para>Fill out the <quote>Component</quote> field, a 
+        short <quote>Description</quote>, the 
+        <quote>Default Assignee</quote>, <quote>Default CC List</quote> 
+        and <quote>Default QA Contact</quote> (if enabled). 
+        The <quote>Component Description</quote> field may contain a 
+        limited subset of HTML tags. The <quote>Default Assignee</quote> 
+        field must be a login name already existing in the Bugzilla database. 
+        </para>
+      </listitem>
+    </orderedlist>
+  </section>
+
+  <section id="versions">
+    <title>Versions</title>
+
+    <para>Versions are the revisions of the product, such as "Flinders
+    3.1", "Flinders 95", and "Flinders 2000". Version is not a multi-select
+    field; the usual practice is to select the earliest version known to have
+    the bug.
+    </para>
+
+    <para>To create and edit Versions:</para>
+
+    <orderedlist>
+      <listitem>
+        <para>From the "Edit product" screen, select "Edit Versions"</para>
+      </listitem>
+
+      <listitem>
+        <para>You will notice that the product already has the default
+        version "undefined". Click the "Add" link in the bottom right.</para>
+      </listitem>
+
+      <listitem>
+        <para>Enter the name of the Version. This field takes text only. 
+        Then click the "Add" button.</para>
+      </listitem>
+
+    </orderedlist>
+  </section>
+
+  <section id="milestones">
+    <title>Milestones</title>
+
+    <para>Milestones are "targets" that you plan to get a bug fixed by. For
+    example, you have a bug that you plan to fix for your 3.0 release, it
+    would be assigned the milestone of 3.0.</para>
+
+    <note>
+      <para>Milestone options will only appear for a Product if you turned
+      on the "usetargetmilestone" parameter in the "Bug Fields" tab of the
+      "Parameters" page.
+      </para>
+    </note>
+
+    <para>To create new Milestones, and set Default Milestones:</para>
+
+    <orderedlist>
+      <listitem>
+        <para>Select "Edit milestones" from the "Edit product" page.</para>
+      </listitem>
+
+      <listitem>
+        <para>Select "Add" in the bottom right corner.</para>
+      </listitem>
+
+      <listitem>
+        <para>Enter the name of the Milestone in the "Milestone" field. You
+        can optionally set the "sortkey", which is a positive or negative
+        number (-32768 to 32767) that defines where in the list this particular
+        milestone appears. This is because milestones often do not 
+        occur in alphanumeric order For example, "Future" might be
+        after "Release 1.2". Select "Add".</para>
+      </listitem>
+    </orderedlist>
+  </section>
+  
+ <section id="flags-overview">
+   <title>Flags</title>
+   
+   <para>
+     Flags are a way to attach a specific status to a bug or attachment, 
+     either <quote>+</quote> or <quote>-</quote>. The meaning of these symbols depends on the text
+     the flag itself, but contextually they could mean pass/fail, 
+     accept/reject, approved/denied, or even a simple yes/no. If your site
+     allows requestable flags, then users may set a flag to <quote>?</quote> as a 
+     request to another user that they look at the bug/attachment, and set
+     the flag to its correct status.
+   </para>
+
+   <section id="flags-simpleexample">
+     <title>A Simple Example</title>
+
+     <para>
+       A developer might want to ask their manager, 
+       <quote>Should we fix this bug before we release version 2.0?</quote> 
+       They might want to do this for a <emphasis>lot</emphasis> of bugs,
+       so it would be nice to streamline the process...
+     </para>
+     <para>
+       In Bugzilla, it would work this way:
+       <orderedlist>
+         <listitem>
+           <para>
+             The Bugzilla administrator creates a flag type called 
+             <quote>blocking2.0</quote> that shows up on all bugs in 
+             your product.
+           </para>
+ 
+           <para>
+             It shows up on the <quote>Show Bug</quote> screen
+             as the text <quote>blocking2.0</quote> with a drop-down box next
+             to it. The drop-down box contains four values: an empty space,
+             <quote>?</quote>, <quote>-</quote>, and <quote>+</quote>.
+           </para>
+         </listitem>
+         <listitem>
+           <para>The developer sets the flag to <quote>?</quote>.</para>
+         </listitem>
+         <listitem>
+           <para>
+             The manager sees the <computeroutput>blocking2.0</computeroutput>
+             flag with a <quote>?</quote> value.
+           </para>
+         </listitem>
+         <listitem>
+           <para>
+             If the manager thinks the feature should go into the product
+             before version 2.0 can be released, he sets the flag to 
+             <quote>+</quote>. Otherwise, he sets it to <quote>-</quote>.
+           </para>
+         </listitem>
+         <listitem>
+           <para>
+             Now, every Bugzilla user who looks at the bug knows whether or 
+             not the bug needs to be fixed before release of version 2.0.
+           </para>
+         </listitem>
+       </orderedlist>
+     </para>
+
+   </section>
+
+   <section id="flags-about">
+     <title>About Flags</title>
+
+     <section id="flag-values">
+       <title>Values</title>
+       <para>
+         Flags can have three values:
+         <variablelist>
+           <varlistentry>
+             <term><computeroutput>?</computeroutput></term>
+             <listitem><simpara>
+               A user is requesting that a status be set. (Think of it as 'A question is being asked'.)
+             </simpara></listitem>
+           </varlistentry>
+           <varlistentry>
+             <term><computeroutput>-</computeroutput></term>
+             <listitem><simpara>
+               The status has been set negatively. (The question has been answered <quote>no</quote>.)
+             </simpara></listitem>
+           </varlistentry>
+           <varlistentry>
+             <term><computeroutput>+</computeroutput></term>
+             <listitem><simpara>
+               The status has been set positively.
+               (The question has been answered <quote>yes</quote>.)
+             </simpara></listitem>
+           </varlistentry>
+         </variablelist>
+       </para>
+       <para>
+         Actually, there's a fourth value a flag can have -- 
+         <quote>unset</quote> -- which shows up as a blank space. This 
+         just means that nobody has expressed an opinion (or asked
+         someone else to express an opinion) about this bug or attachment.
+       </para>
+     </section>
+   </section>
+
+   <section id="flag-askto">
+     <title>Using flag requests</title>
+     <para>
+       If a flag has been defined as 'requestable', and a user has enough privileges
+       to request it (see below), the user can set the flag's status to <quote>?</quote>.
+       This status indicates that someone (a.k.a. <quote>the requester</quote>) is asking
+       someone else to set the flag to either <quote>+</quote> or <quote>-</quote>.
+     </para>
+     <para>
+       If a flag has been defined as 'specifically requestable', 
+       a text box will appear next to the flag into which the requester may
+       enter a Bugzilla username. That named person (a.k.a. <quote>the requestee</quote>)
+       will receive an email notifying them of the request, and pointing them
+       to the bug/attachment in question.
+     </para>
+     <para>
+       If a flag has <emphasis>not</emphasis> been defined as 'specifically requestable',
+       then no such text-box will appear. A request to set this flag cannot be made of
+       any specific individual, but must be asked <quote>to the wind</quote>.
+       A requester may <quote>ask the wind</quote> on any flag simply by leaving the text-box blank.
+     </para>
+   </section>
+
+   <section id="flag-types">
+     <title>Two Types of Flags</title>
+    
+     <para>
+       Flags can go in two places: on an attachment, or on a bug.
+     </para>
+
+     <section id="flag-type-attachment">
+       <title>Attachment Flags</title>
+      
+       <para>
+         Attachment flags are used to ask a question about a specific 
+         attachment on a bug.
+       </para>
+       <para>
+         Many Bugzilla installations use this to 
+         request that one developer <quote>review</quote> another 
+         developer's code before they check it in. They attach the code to
+         a bug report, and then set a flag on that attachment called
+         <quote>review</quote> to 
+         <computeroutput>review?boss@domain.com</computeroutput>.
+         boss@domain.com is then notified by email that
+         he has to check out that attachment and approve it or deny it.
+       </para>
+
+       <para>
+         For a Bugzilla user, attachment flags show up in three places:
+         <orderedlist>
+           <listitem>
+             <para>
+               On the list of attachments in the <quote>Show Bug</quote>
+               screen, you can see the current state of any flags that
+               have been set to ?, +, or -. You can see who asked about 
+               the flag (the requester), and who is being asked (the 
+               requestee).
+             </para>
+           </listitem>
+           <listitem>
+             <para>
+              When you <quote>Edit</quote> an attachment, you can 
+              see any settable flag, along with any flags that have 
+              already been set. This <quote>Edit Attachment</quote> 
+              screen is where you set flags to ?, -, +, or unset them.
+             </para>
+           </listitem>
+           <listitem>
+             <para>
+               Requests are listed in the <quote>Request Queue</quote>, which
+               is accessible from the <quote>My Requests</quote> link (if you are
+               logged in) or <quote>Requests</quote> link (if you are logged out)
+               visible in the footer of all pages.
+             </para>
+           </listitem>
+         </orderedlist>
+       </para>
+
+     </section>
+
+     <section id="flag-type-bug">
+       <title>Bug Flags</title>
+
+       <para>
+         Bug flags are used to set a status on the bug itself. You can 
+         see Bug Flags in the <quote>Show Bug</quote> and <quote>Requests</quote>
+         screens, as described above.
+       </para>
+       <para>
+         Only users with enough privileges (see below) may set flags on bugs.
+         This doesn't necessarily include the assignee, reporter, or users with the
+         <computeroutput>editbugs</computeroutput> permission.
+       </para>
+     </section>
+
+   </section>
+
+   <section id="flags-admin">
+     <title>Administering Flags</title>
+
+     <para>
+       If you have the <quote>editcomponents</quote> permission, you can
+       edit Flag Types from the main administration page. Clicking the
+       <quote>Flags</quote> link will bring you to the <quote>Administer
+       Flag Types</quote> page. Here, you can select whether you want 
+       to create (or edit) a Bug flag, or an Attachment flag.
+     </para>
+     <para>
+       No matter which you choose, the interface is the same, so we'll 
+       just go over it once.
+     </para>
+
+     <section id="flags-edit">
+       <title>Editing a Flag</title>
+       <para>
+         To edit a flag's properties, just click the flag's name.
+         That will take you to the same
+         form as described below (<xref linkend="flags-create"/>).
+       </para>
+     </section>
+
+     <section id="flags-create">
+       <title>Creating a Flag</title>
+       
+        <para>
+          When you click on the <quote>Create a Flag Type for...</quote>
+          link, you will be presented with a form. Here is what the fields in 
+          the form mean:
+        </para>
+
+        <section id="flags-create-field-name">
+          <title>Name</title>
+          <para>
+            This is the name of the flag. This will be displayed 
+            to Bugzilla users who are looking at or setting the flag. 
+            The name may contain any valid Unicode characters except commas
+            and spaces.
+          </para>
+        </section>
+
+        <section id="flags-create-field-description">
+          <title>Description</title>
+          <para>
+            The description describes the flag in more detail. It is visible
+            in a tooltip when hovering over a flag either in the <quote>Show Bug</quote>
+            or <quote>Edit Attachment</quote> pages. This field can be as
+            long as you like, and can contain any character you want.
+          </para>
+        </section>
+
+        <section id="flags-create-field-category">
+          <title>Category</title>
+
+          <para>
+            Default behaviour for a newly-created flag is to appear on
+            products and all components, which is why <quote>__Any__:__Any__</quote>
+            is already entered in the <quote>Inclusions</quote> box.
+            If this is not your desired behaviour, you must either set some
+            exclusions (for products on which you don't want the flag to appear),
+            or you must remove <quote>__Any__:__Any__</quote> from the Inclusions box
+            and define products/components specifically for this flag.
+          </para>
+
+          <para>
+            To create an Inclusion, select a Product from the top drop-down box.
+            You may also select a specific component from the bottom drop-down box.
+            (Setting <quote>__Any__</quote> for Product translates to, 
+            <quote>all the products in this Bugzilla</quote>.
+            Selecting  <quote>__Any__</quote> in the Component field means
+            <quote>all components in the selected product.</quote>) 
+            Selections made, press <quote>Include</quote>, and your
+            Product/Component pairing will show up in the <quote>Inclusions</quote> box on the right.
+          </para>
+
+          <para>
+            To create an Exclusion, the process is the same; select a Product from the
+            top drop-down box, select a specific component if you want one, and press
+            <quote>Exclude</quote>. The Product/Component pairing will show up in the 
+            <quote>Exclusions</quote> box on the right.
+          </para>
+
+          <para>
+            This flag <emphasis>will</emphasis> and <emphasis>can</emphasis> be set for any
+            products/components that appearing in the <quote>Inclusions</quote> box 
+            (or which fall under the appropriate <quote>__Any__</quote>). 
+            This flag <emphasis>will not</emphasis> appear (and therefore cannot be set) on
+            any products appearing in the <quote>Exclusions</quote> box.
+            <emphasis> IMPORTANT: Exclusions override inclusions.</emphasis>
+          </para>
+
+          <para>
+            You may select a Product without selecting a specific Component,
+            but you can't select a Component without a Product, or to select a
+            Component that does not belong to the named Product. If you do so,
+            Bugzilla will display an error message, even if all your products
+            have a component by that name.
+          </para>
+
+          <para><emphasis>Example:</emphasis> Let's say you have a product called 
+            <quote>Jet Plane</quote> that has thousands of components. You want
+            to be able to ask if a problem should be fixed in the next model of 
+            plane you release. We'll call the flag <quote>fixInNext</quote>.
+            But, there's one component in <quote>Jet Plane,</quote> 
+            called <quote>Pilot.</quote> It doesn't make sense to release a 
+            new pilot, so you don't want to have the flag show up in that component.
+            So, you include <quote>Jet Plane:__Any__</quote> and you exclude 
+            <quote>Jet Plane:Pilot</quote>.
+          </para>
+        </section>
+
+        <section id="flags-create-field-sortkey">
+          <title>Sort Key</title>
+          <para>
+            Flags normally show up in alphabetical order. If you want them to 
+            show up in a different order, you can use this key set the order on each flag. 
+            Flags with a lower sort key will appear before flags with a higher
+            sort key. Flags that have the same sort key will be sorted alphabetically,
+            but they will still be after flags with a lower sort key, and before flags
+            with a higher sort key.
+          </para>
+          <para>
+            <emphasis>Example:</emphasis> I have AFlag (Sort Key 100), BFlag (Sort Key 10), 
+            CFlag (Sort Key 10), and DFlag (Sort Key 1). These show up in
+            the order: DFlag, BFlag, CFlag, AFlag.
+          </para>
+        </section>
+
+        <section id="flags-create-field-active">
+          <title>Active</title>
+          <para>
+            Sometimes, you might want to keep old flag information in the 
+            Bugzilla database, but stop users from setting any new flags of this type.
+            To do this, uncheck <quote>active</quote>. Deactivated
+            flags will still show up in the UI if they are ?, +, or -, but they
+            may only be cleared (unset), and cannot be changed to a new value.
+            Once a deactivated flag is cleared, it will completely disappear from a 
+            bug/attachment, and cannot be set again.
+          </para>
+        </section>
+
+        <section id="flags-create-field-requestable">
+          <title>Requestable</title>
+          <para>
+            New flags are, by default, <quote>requestable</quote>, meaning that they
+            offer users the <quote>?</quote> option, as well as <quote>+</quote>
+            and <quote>-</quote>.
+            To remove the ? option, uncheck <quote>requestable</quote>.
+          </para>
+        </section>
+
+        <section id="flags-create-field-specific">
+          <title>Specifically Requestable</title>
+          <para>
+            By default this box is checked for new flags, meaning that users may make
+            flag requests of specific individuals. Unchecking this box will remove the
+            text box next to a flag; if it is still requestable, then requests may
+            only be made <quote>to the wind.</quote> Removing this after specific
+            requests have been made will not remove those requests; that data will
+            stay in the database (though it will no longer appear to the user).
+          </para>
+        </section>
+
+        <section id="flags-create-field-multiplicable">
+          <title>Multiplicable</title>
+          <para>
+            Any flag with <quote>Multiplicable</quote> set (default for new flags is 'on')
+            may be set more than once. After being set once, an unset flag
+            of the same type will appear below it with <quote>addl.</quote> (short for 
+            <quote>additional</quote>) before the name. There is no limit to the number of
+            times a Multiplicable flags may be set on the same bug/attachment.
+          </para>
+        </section>
+
+       <section id="flags-create-field-cclist">
+          <title>CC List</title>
+
+          <para>
+            If you want certain users to be notified every time this flag is 
+            set to ?, -, +, or unset, add them here. This is a comma-separated 
+            list of email addresses that need not be restricted to Bugzilla usernames.
+          </para>
+        </section>
+
+        <section id="flags-create-grant-group">
+          <title>Grant Group</title>
+          <para>
+            When this field is set to some given group, only users in the group
+            can set the flag to <quote>+</quote> and <quote>-</quote>. This
+            field does not affect who can request or cancel the flag. For that,
+            see the <quote>Request Group</quote> field below. If this field
+            is left blank, all users can set or delete this flag. This field is
+            useful for restricting which users can approve or reject requests.
+          </para>
+        </section>
+
+        <section id="flags-create-request-group">
+          <title>Request Group</title>
+          <para>
+            When this field is set to some given group, only users in the group
+            can request or cancel this flag. Note that this field has no effect
+            if the <quote>grant group</quote> field is empty. You can set the
+            value of this field to a different group, but both fields have to be
+            set to a group for this field to have an effect.
+          </para>
+        </section>
+      </section> <!-- flags-create -->
+
+      <section id="flags-delete">
+        <title>Deleting a Flag</title>
+
+        <para>
+          When you are at the <quote>Administer Flag Types</quote> screen,
+          you will be presented with a list of Bug flags and a list of Attachment
+          Flags.
+        </para>
+        <para>
+          To delete a flag, click on the <quote>Delete</quote> link next to
+          the flag description.
+        </para>
+        <warning>
+          <para>
+            Once you delete a flag, it is <emphasis>gone</emphasis> from
+            your Bugzilla. All the data for that flag will be deleted.
+            Everywhere that flag was set, it will disappear,
+            and you cannot get that data back. If you want to keep flag data,
+            but don't want anybody to set any new flags or change current flags,
+            unset <quote>active</quote> in the flag Edit form.
+          </para>
+        </warning>
+      </section>
+
+    </section> <!-- flags-admin -->
+
+    <!-- XXX We should add a "Uses of Flags" section, here, with examples. -->
+
+  </section> <!-- flags -->
+
+  <section id="keywords">
+    <title>Keywords</title>
+
+    <para>
+    The administrator can define keywords which can be used to tag and
+    categorise bugs. For example, the keyword "regression" is commonly used.
+    A company might have a policy stating all regressions
+    must be fixed by the next release - this keyword can make tracking those
+    bugs much easier.
+    </para>
+    <para>
+    Keywords are global, rather than per-product. If the administrator changes
+    a keyword currently applied to any bugs, the keyword cache must be rebuilt
+    using the <xref linkend="sanitycheck"/> script. Currently keywords cannot
+    be marked obsolete to prevent future usage.
+    </para>
+    <para>
+    Keywords can be created, edited or deleted by clicking the "Keywords"
+    link in the admin page. There are two fields for each keyword - the keyword
+    itself and a brief description. Once created, keywords can be selected
+    and applied to individual bugs in that bug's "Details" section.
+    </para>
+  </section>
+
+  <section id="custom-fields">
+    <title>Custom Fields</title>
+
+    <para>
+      The release of Bugzilla 3.0 added the ability to create Custom Fields. 
+      Custom Fields are treated like any other field - they can be set in bugs
+      and used for search queries. Administrators should keep in mind that
+      adding too many fields can make the user interface more complicated and
+      harder to use. Custom Fields should be added only when necessary and with 
+      careful consideration.
+    </para>
+    <tip>
+      <para>
+        Before adding a Custom Field, make sure that Bugzilla cannot already
+        do the desired behavior. Many Bugzilla options are not enabled by 
+        default, and many times Administrators find that simply enabling
+        certain options that already exist is sufficient. 
+      </para>
+    </tip>
+    <para>
+      Administrators can manage Custom Fields using the
+      <quote>Custom Fields</quote> link on the Administration page. The Custom
+      Fields administration page displays a list of Custom Fields, if any exist,
+      and a link to "Add a new custom field". 
+    </para>
+
+    <section id="add-custom-fields">
+      <title>Adding Custom Fields</title>
+
+      <para>
+        To add a new Custom Field, click the "Add a new custom field" link. This
+        page displays several options for the new field, described below.
+      </para>
+
+      <para>
+        The following attributes must be set for each new custom field:
+        <itemizedlist>
+          <listitem>
+            <para>
+              <emphasis>Name:</emphasis>
+              The name of the field in the database, used internally. This name 
+              MUST begin with <quote>cf_</quote> to prevent confusion with 
+              standard fields. If this string is omitted, it will
+              be automatically added to the name entered. 
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <emphasis>Description:</emphasis>
+              A brief string which is used as the label for this Custom Field.
+              That is the string that users will see, and should be
+              short and explicit.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <emphasis>Type:</emphasis>
+              The type of field to create. There are
+              several types available:
+              <variablelist>
+                <varlistentry>
+                  <term>Bug ID:</term>
+                  <listitem>
+                    <para>
+                      A field where you can enter the ID of another bug from
+                      the same Bugzilla installation. To point to a bug in a remote
+                      installation, use the See Also field instead.
+                    </para>
+                  </listitem>
+                </varlistentry>
+
+                <varlistentry>
+                  <term>Large Text Box:</term>
+                  <listitem>
+                    <para>
+                      A multiple line box for entering free text.
+                    </para>
+                  </listitem>
+                </varlistentry>
+
+                <varlistentry>
+                  <term>Free Text:</term>
+                  <listitem>
+                    <para>
+                      A single line box for entering free text.
+                    </para>
+                  </listitem>
+                </varlistentry>
+
+                <varlistentry>
+                  <term>Multiple-Selection Box:</term>
+                  <listitem>
+                    <para>
+                      A list box where multiple options
+                      can be selected. After creating this field, it must be edited
+                      to add the selection options. See
+                      <xref linkend="edit-values-list" /> for information about
+                      editing legal values.
+                    </para>
+                  </listitem>
+                </varlistentry>
+
+                <varlistentry>
+                  <term>Drop Down:</term>
+                  <listitem>
+                    <para>
+                      A list box where only one option can be selected.
+                      After creating this field, it must be edited to add the
+                      selection options. See
+                      <xref linkend="edit-values-list" /> for information about
+                      editing legal values.
+                    </para>
+                  </listitem>
+                </varlistentry>
+
+                <varlistentry>
+                  <term>Date/Time:</term>
+                  <listitem>
+                    <para>
+                      A date field. This field appears with a
+                      calendar widget for choosing the date.
+                    </para>
+                  </listitem>
+                </varlistentry>
+              </variablelist>
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <emphasis>Sortkey:</emphasis>
+              Integer that determines in which order Custom Fields are
+              displayed in the User Interface, especially when viewing a bug. 
+              Fields with lower values are displayed first.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <emphasis>Reverse Relationship Description:</emphasis>
+              When the custom field is of type <quote>Bug ID</quote>, you can
+              enter text here which will be used as label in the referenced
+              bug to list bugs which point to it. This gives you the ability
+              to have a mutual relationship between two bugs.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <emphasis>Can be set on bug creation:</emphasis>
+              Boolean that determines whether this field can be set on
+              bug creation. If not selected, then a bug must be created 
+              before this field can be set. See <xref linkend="bugreports" /> 
+              for information about filing bugs.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <emphasis>Displayed in bugmail for new bugs:</emphasis>
+              Boolean that determines whether the value set on this field
+              should appear in bugmail when the bug is filed. This attribute
+              has no effect if the field cannot be set on bug creation.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <emphasis>Is obsolete:</emphasis>
+              Boolean that determines whether this field should
+              be displayed at all. Obsolete Custom Fields are hidden.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <emphasis>Is mandatory:</emphasis>
+              Boolean that determines whether this field must be set.
+              For single and multi-select fields, this means that a (non-default)
+              value must be selected, and for text and date fields, some text
+              must be entered.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <emphasis>Field only appears when:</emphasis>
+              A custom field can be made visible when some criteria is met.
+              For instance, when the bug belongs to one or more products,
+              or when the bug is of some given severity. If left empty, then
+              the custom field will always be visible, in all bugs.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <emphasis>Field that controls the values that appear in this field:</emphasis>
+              When the custom field is of type <quote>Drop Down</quote> or
+              <quote>Multiple-Selection Box</quote>, you can restrict the
+              availability of the values of the custom field based on the
+              value of another field. This criteria is independent of the
+              criteria used in the <quote>Field only appears when</quote>
+              setting. For instance, you may decide that some given value
+              <quote>valueY</quote> is only available when the bug status
+              is RESOLVED while the value <quote>valueX</quote> should
+              always be listed.
+              Once you have selected the field which should control the
+              availability of the values of this custom field, you can
+              edit values of this custom field to set the criteria, see
+              <xref linkend="edit-values-list" />.
+            </para>
+          </listitem>
+        </itemizedlist>
+      </para>
+    </section>
+
+    <section id="edit-custom-fields">
+      <title>Editing Custom Fields</title>
+
+      <para>
+        As soon as a Custom Field is created, its name and type cannot be
+        changed. If this field is a drop down menu, its legal values can
+        be set as described in <xref linkend="edit-values-list" />. All
+        other attributes can be edited as described above.
+      </para>
+    </section>
+
+    <section id="delete-custom-fields">
+      <title>Deleting Custom Fields</title>
+
+      <para>
+        Only custom fields which are marked as obsolete, and which never
+        have been used, can be deleted completely (else the integrity
+        of the bug history would be compromised). For custom fields marked
+        as obsolete, a "Delete" link will appear in the <quote>Action</quote>
+        column. If the custom field has been used in the past, the deletion
+        will be rejected. But marking the field as obsolete is sufficient
+        to hide it from the user interface entirely.
+      </para>
+    </section>
+  </section>
+
+  <section id="edit-values">
+    <title>Legal Values</title>
+
+    <para>
+      Legal values for the operating system, platform, bug priority and
+      severity, custom fields of type <quote>Drop Down</quote> and
+      <quote>Multiple-Selection Box</quote> (see <xref linkend="custom-fields" />),
+      as well as the list of valid bug statuses and resolutions can be
+      customized from the same interface. You can add, edit, disable and
+      remove values which can be used with these fields.
+    </para>
+
+    <section id="edit-values-list">
+      <title>Viewing/Editing legal values</title>
+      <para>
+        Editing legal values requires <quote>admin</quote> privileges.
+        Select "Field Values" from the Administration page. A list of all
+        fields, both system fields and Custom Fields, for which legal values
+        can be edited appears. Click a field name to edit its legal values.
+      </para>
+      <para>
+        There is no limit to how many values a field can have, but each value 
+        must be unique to that field. The sortkey is important to display these
+        values in the desired order.
+      </para>
+      <para>
+        When the availability of the values of a custom field is controlled
+        by another field, you can select from here which value of the other field
+        must be set for the value of the custom field to appear.
+      </para>
+    </section>
+
+    <section id="edit-values-delete">
+      <title>Deleting legal values</title>
+      <para>
+        Legal values from Custom Fields can be deleted, but only if the 
+        following two conditions are respected:
+      </para>
+
+      <orderedlist>
+        <listitem>
+         <para>The value is not used by default for the field.</para>
+       </listitem>
+
+       <listitem>
+         <para>No bug is currently using this value.</para>
+        </listitem>
+      </orderedlist>
+
+      <para>
+        If any of these conditions is not respected, the value cannot be deleted.
+       The only way to delete these values is to reassign bugs to another value
+       and to set another value as default for the field.
+      </para>
+    </section>
+  </section>
+
+  <section id="bug_status_workflow">
+    <title>Bug Status Workflow</title>
+
+    <para>
+      The bug status workflow is no longer hardcoded but can be freely customized
+      from the web interface. Only one bug status cannot be renamed nor deleted,
+      UNCONFIRMED, but the workflow involving it is free. The configuration
+      page displays all existing bug statuses twice, first on the left for bug
+      statuses we come from and on the top for bug statuses we move to.
+      If the checkbox is checked, then the transition between the two bug statuses
+      is legal, else it's forbidden independently of your privileges. The bug status
+      used for the "duplicate_or_move_bug_status" parameter must be part of the
+      workflow as that is the bug status which will be used when duplicating or
+      moving a bug, so it must be available from each bug status.
+    </para>
+    <para>
+      When the workflow is set, the "View Current Triggers" link below the table
+      lets you set which transitions require a comment from the user.
+    </para>
+  </section>
+
+  <section id="voting">
+    <title>Voting</title>
+
+    <para>All of the code for voting in Bugzilla has been moved into an
+    extension, called "Voting", in the <filename>extensions/Voting/</filename>
+    directory. To enable it, you must remove the <filename>disabled</filename>
+    file from that directory, and run <filename>checksetup.pl</filename>.</para>
+
+    <para>Voting allows users to be given a pot of votes which they can allocate
+    to bugs, to indicate that they'd like them fixed. 
+    This allows developers to gauge
+    user need for a particular enhancement or bugfix. By allowing bugs with
+    a certain number of votes to automatically move from "UNCONFIRMED" to
+    "CONFIRMED", users of the bug system can help high-priority bugs garner
+    attention so they don't sit for a long time awaiting triage.</para>
+
+    <para>To modify Voting settings:</para>
+
+    <orderedlist>
+      <listitem>
+        <para>Navigate to the "Edit product" screen for the Product you
+        wish to modify</para>
+      </listitem>
+
+      <listitem>
+        <para><emphasis>Maximum Votes per person</emphasis>:
+        Setting this field to "0" disables voting.</para>
+      </listitem>
+
+      <listitem>
+        <para><emphasis>Maximum Votes a person can put on a single
+         bug</emphasis>: 
+         It should probably be some number lower than the
+        "Maximum votes per person". Don't set this field to "0" if
+        "Maximum votes per person" is non-zero; that doesn't make
+        any sense.</para>
+      </listitem>
+
+      <listitem>
+        <para><emphasis>Number of votes a bug in this product needs to
+        automatically get out of the UNCONFIRMED state</emphasis>: 
+        Setting this field to "0" disables the automatic move of
+        bugs from UNCONFIRMED to CONFIRMED. 
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>Once you have adjusted the values to your preference, click
+        "Update".</para>
+      </listitem>
+    </orderedlist>
+  </section>
+
+  <section id="quips">
+    <title>Quips</title>
+
+    <para>
+      Quips are small text messages that can be configured to appear
+      next to search results. A Bugzilla installation can have its own specific
+      quips. Whenever a quip needs to be displayed, a random selection
+      is made from the pool of already existing quips.
+    </para>
+  
+    <para>
+      Quip submission is controlled by the <emphasis>quip_list_entry_control</emphasis>
+      parameter.  It has several possible values: open, moderated, or closed.
+      In order to enable quips approval you need to set this parameter to
+      "moderated". In this way, users are free to submit quips for addition
+      but an administrator must explicitly approve them before they are
+      actually used.
+    </para>
+
+    <para>
+      In order to see the user interface for the quips, it is enough to click
+      on a quip when it is displayed together with the search results. Or
+      it can be seen directly in the browser by visiting the quips.cgi URL
+      (prefixed with the usual web location of the Bugzilla installation).
+      Once the quip interface is displayed, it is enough to click the
+      "view and edit the whole quip list" in order to see the administration
+      page. A page with all the quips available in the database will
+      be displayed.
+    </para>
+
+    <para>
+      Next to each quip there is a checkbox, under the
+      "Approved" column. Quips who have this checkbox checked are
+      already approved and will appear next to the search results.
+      The ones that have it unchecked are still preserved in the
+      database but they will not appear on search results pages.
+      User submitted quips have initially the checkbox unchecked.
+    </para>
+  
+    <para>
+      Also, there is a delete link next to each quip,
+      which can be used in order to permanently delete a quip.
+    </para>
+
+    <para>
+      Display of quips is controlled by the <emphasis>display_quips</emphasis>
+      user preference.  Possible values are "on" and "off".
+    </para>
+  </section>
+
+  <section id="groups">
+    <title>Groups and Group Security</title>
+
+    <para>
+    Groups allow for separating bugs into logical divisions.
+    Groups are typically used
+    to isolate bugs that should only be seen by certain people. For
+    example, a company might create a different group for each one of its customers
+    or partners. Group permissions could be set so that each partner or customer would
+    only have access to their own bugs. Or, groups might be used to create
+    variable access controls for different departments within an organization.
+    Another common use of groups is to associate groups with products,
+    creating isolation and access control on a per-product basis.
+    </para>
+
+    <para>
+    Groups and group behaviors are controlled in several places:
+    </para>
+
+      <orderedlist>
+
+         <listitem>
+           <para>
+             The group configuration page. To view or edit existing groups, or to
+             create new groups, access the "Groups" link from the "Administration"
+             page. This section of the manual deals primarily with the aspect of
+             group controls accessed on this page.  
+           </para>
+         </listitem> 
+
+        <listitem>
+          <para>
+            Global configuration parameters. Bugzilla has several parameters 
+            that control the overall default group behavior and restriction
+            levels. For more information on the parameters that control 
+            group behavior globally, see <xref linkend="param-group-security"/>.
+          </para>
+
+         </listitem>
+
+         <listitem>
+          <para>
+            Product association with groups. Most of the functionality of groups
+            and group security is controlled at the product level. Some aspects
+            of group access controls for products are discussed in this section,
+            but for more detail see <xref linkend="product-group-controls"/>.
+          </para>
+         </listitem>
+
+         <listitem>
+          <para>
+            Group access for users. See <xref linkend="users-and-groups"/> for
+            details on how users are assigned group access.
+          </para>
+         </listitem>
+
+      </orderedlist>
+
+    <para>
+      Group permissions are such that if a bug belongs to a group, only members
+      of that group can see the bug. If a bug is in more than one group, only
+      members of <emphasis>all</emphasis> the groups that the bug is in can see
+      the bug. For information on granting read-only access to certain people and
+      full edit access to others, see <xref linkend="product-group-controls"/>.
+     </para> 
+
+     <note>
+      <para>
+        By default, bugs can also be seen by the Assignee, the Reporter, and 
+        by everyone on the CC List, regardless of whether or not the bug would 
+        typically be viewable by them. Visibility to the Reporter and CC List can 
+        be overridden (on a per-bug basis) by bringing up the bug, finding the 
+        section that starts with <quote>Users in the roles selected below...</quote>
+        and un-checking the box next to either 'Reporter' or 'CC List' (or both).
+      </para>
+    </note> 
+
+    <section id="create-groups">
+      <title>Creating Groups</title>
+
+      <para>
+        To create a new group, follow the steps below:
+      </para>
+  
+      <orderedlist>
+
+        <listitem>
+          <para>
+            Select the <quote>Administration</quote> link in the page footer, 
+            and then select the <quote>Groups</quote> link from the 
+            Administration page.
+          </para>
+        </listitem>
+  
+        <listitem>
+          <para>
+            A table of all the existing groups is displayed. Below the table is a
+            description of all the fields. To create a new group, select the 
+            <quote>Add Group</quote> link under the table of existing groups.
+          </para>
+        </listitem>
+  
+        <listitem>
+          <para>
+            There are five fields to fill out. These fields are documented below
+            the form. Choose a name and description for the group. Decide whether
+            this group should be used for bugs (in all likelihood this should be
+            selected). Optionally, choose a regular expression that will
+            automatically add any matching users to the group, and choose an
+            icon that will help identify user comments for the group. The regular
+            expression can be useful, for example, to automatically put all users
+            from the same company into one group (if the group is for a specific
+            customer or partner). 
+          </para>
+            <note>
+             <para>
+               If <quote>User RegExp</quote> is filled out, users whose email 
+               addresses match the regular expression will automatically be 
+               members of the group as long as their email addresses continue 
+               to match the regular expression. If their email address changes
+               and no longer matches the regular expression, they will be removed
+               from the group. Versions 2.16 and older of Bugzilla did not automatically
+               remove users who's email addresses no longer matched the RegExp.
+             </para>
+            </note>
+            <warning>
+             <para>
+               If specifying a domain in the regular expression, end
+               the regexp with a "$". Otherwise, when granting access to 
+               "@mycompany\.com", access will also be granted to 
+               'badperson@mycompany.com.cracker.net'. Use the syntax,
+               '@mycompany\.com$' for the regular expression.
+             </para>
+            </warning>
+        </listitem>
+
+        <listitem>
+          <para>
+          After the new group is created, it can be edited for additional options. 
+          The "Edit Group" page allows for specifying other groups that should be included
+          in this group and which groups should be permitted to add and delete
+          users from this group. For more details, see <xref linkend="edit-groups"/>.
+          </para>
+        </listitem>
+      </orderedlist>
+  
+    </section>
+ 
+    <section id="edit-groups">
+      <title>Editing Groups and Assigning Group Permissions</title>
+
+      <para>
+        To access the "Edit Groups" page, select the 
+        <quote>Administration</quote> link in the page footer, 
+        and then select the <quote>Groups</quote> link from the Administration page.
+        A table of all the existing groups is displayed. Click on a group name
+        you wish to edit or control permissions for.
+      </para>
+
+      <para>
+       The "Edit Groups" page contains the same five fields present when 
+       creating a new group. Below that are two additional sections, "Group
+       Permissions," and "Mass Remove". The "Mass Remove" option simply removes
+       all users from the group who match the regular expression entered. The
+       "Group Permissions" section requires further explanation.
+      </para>
+
+      <para>
+       The "Group Permissions" section on the "Edit Groups" page contains four sets
+       of permissions that control the relationship of this group to other
+       groups. If the 'usevisibilitygroups' parameter is in use (see
+       <xref linkend="parameters"/>) two additional sets of permissions are displayed. 
+       Each set consists of two select boxes. On the left, a select box
+       with a list of all existing groups. On the right, a select box listing
+       all groups currently selected for this permission setting (this box will
+       be empty for new groups). The way these controls allow groups to relate
+       to one another is called <emphasis>inheritance</emphasis>. 
+       Each of the six permissions is described below.
+      </para>
+
+      <variablelist>
+
+        <varlistentry>
+
+          <term>
+            <emphasis>Groups That Are a Member of This Group</emphasis>
+          </term>
+
+          <listitem>
+            <para> 
+              Members of any groups selected here will automatically have 
+              membership in this group. In other words, members of any selected 
+              group will inherit membership in this group. 
+            </para>
+          </listitem>
+
+        </varlistentry>
+
+        <varlistentry>
+
+          <term>
+            <emphasis>Groups That This Group Is a Member Of</emphasis>
+          </term>
+
+          <listitem>
+            <para>
+              Members of this group will inherit membership to any group 
+              selected here. For example, suppose the group being edited is
+              an Admin group. If there are two products  (Product1 and Product2) 
+              and each product has its
+              own group (Group1 and Group2), and the Admin group 
+              should have access to both products, 
+              simply select both Group1 and Group2 here. 
+           </para>
+          </listitem>
+
+        </varlistentry>
+
+        <varlistentry>
+
+          <term>
+            <emphasis>Groups That Can Grant Membership in This Group</emphasis>
+          </term>
+
+          <listitem>
+           <para>
+             The members of any group selected here will be able add users
+             to this group, even if they themselves are not in this group.
+           </para>
+          </listitem>
+
+        </varlistentry>
+
+        <varlistentry>
+
+          <term>
+            <emphasis>Groups That This Group Can Grant Membership In</emphasis>
+          </term>
+
+          <listitem>
+           <para>
+             Members of this group can add users to any group selected here,
+             even if they themselves are not in the selected groups.  
+           </para>
+          </listitem>
+
+        </varlistentry>
+
+        <varlistentry>
+
+          <term>
+            <emphasis>Groups That Can See This Group</emphasis>
+          </term>
+
+          <listitem>
+           <para>
+             Members of any selected group can see the users in this group.
+             This setting is only visible if the 'usevisibilitygroups' parameter
+             is enabled on the Bugzilla Configuration page. See
+             <xref linkend="parameters"/> for information on configuring Bugzilla.
+           </para>
+          </listitem>
+
+        </varlistentry>
+
+        <varlistentry>
+
+          <term>
+            <emphasis>Groups That This Group Can See</emphasis>
+          </term>
+
+          <listitem>
+           <para>
+             Members of this group can see members in any of the selected groups.
+             This setting is only visible if the 'usevisibilitygroups' parameter
+             is enabled on the the Bugzilla Configuration page. See
+             <xref linkend="parameters"/> for information on configuring Bugzilla.               
+           </para>
+          </listitem>
+
+        </varlistentry>
+
+    </variablelist>
+
+    </section>
+
+    <section id="users-and-groups">
+      <title>Assigning Users to Groups</title>
+
+      <para>
+        A User can become a member of a group in several ways:
+      </para>
+
+      <orderedlist>
+
+        <listitem>
+          <para>
+            The user can be explicitly placed in the group by editing
+            the user's profile. This can be done by accessing the "Users" page
+            from the "Administration" page. Use the search form to find the user
+            you want to edit group membership for, and click on their email
+            address in the search results to edit their profile. The profile
+            page lists all the groups, and indicates if the user is a member of
+            the group either directly or indirectly. More information on indirect
+            group membership is below. For more details on User administration,
+            see <xref linkend="useradmin"/>.
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+           The group can include another group of which the user is
+           a member. This is indicated by square brackets around the checkbox  
+           next to the group name in the user's profile. 
+           See <xref linkend="edit-groups"/> for details on group inheritance.
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            The user's email address can match the regular expression
+            that has been specified to automatically grant membership to
+            the group. This is indicated by "*" around the check box by the
+            group name in the user's profile.
+            See <xref linkend="create-groups"/> for details on 
+            the regular expression option when creating groups.
+           </para>
+        </listitem>
+
+      </orderedlist>
+
+    </section>
+
+    <section>
+     <title>Assigning Group Controls to Products</title>
+
+     <para>
+     The primary functionality of groups is derived from the relationship of 
+     groups to products. The concepts around segregating access to bugs with
+     product group controls can be confusing. For details and examples on this
+     topic, see <xref linkend="product-group-controls" />.
+     </para>
+
+    </section>
+  </section>
+
+  <section id="sanitycheck">
+    <title>Checking and Maintaining Database Integrity</title>
+
+    <para>
+    Over time it is possible for the Bugzilla database to become corrupt
+    or to have anomalies.
+    This could happen through normal usage of Bugzilla, manual database
+    administration outside of the Bugzilla user interface, or from some
+    other unexpected event. Bugzilla includes a "Sanity Check" script that
+    can perform several basic database checks, and repair certain problems or
+    inconsistencies. 
+    </para>
+    <para>
+    To run the "Sanity Check" script, log in as an Administrator and click the
+    "Sanity Check" link in the admin page. Any problems that are found will be
+    displayed in red letters. If the script is capable of fixing a problem,
+    it will present a link to initiate the fix. If the script cannot
+    fix the problem it will require manual database administration or recovery.
+    </para>
+    <para>
+    The "Sanity Check" script can also be run from the command line via the perl
+    script <filename>sanitycheck.pl</filename>. The script can also be run as
+    a <command>cron</command> job. Results will be delivered by email.
+    </para>
+    <para>
+    The "Sanity Check" script should be run on a regular basis as a matter of
+    best practice.
+    </para>
+    <warning>
+      <para>
+      The "Sanity Check" script is no substitute for a competent database
+      administrator. It is only designed to check and repair basic database
+      problems.
+      </para>
+    </warning>
+
+  </section>
+
+
+</chapter>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-always-quote-attributes:t
+sgml-auto-insert-required-elements:t
+sgml-balanced-tag-edit:t
+sgml-exposed-tags:nil
+sgml-general-insert-case:lower
+sgml-indent-data:t
+sgml-indent-step:2
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+sgml-minimize-attributes:nil
+sgml-namecase-general:t
+sgml-omittag:t
+sgml-parent-document:("Bugzilla-Guide.xml" "book" "chapter")
+sgml-shorttag:t
+sgml-tag-region-if-active:t
+End:
+-->

diff --git a/docs/en/xml/bugzilla.ent b/docs/en/xml/bugzilla.ent
new file mode 100644 (file)
index 0000000..0d141e8
--- /dev/null
+++ b/docs/en/xml/bugzilla.ent
@@ -0,0 +1,60 @@
+<!ENTITY bz-ver "4.4">
+<!ENTITY bz-date "2013-05-22">
+<!ENTITY current-year "2013">
+
+<!ENTITY min-perl-ver "5.8.1">
+<!ENTITY landfillbase "http://landfill.bugzilla.org/bugzilla-tip/">
+<!ENTITY bzg-bugs "http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla;component=Documentation">
+
+<!-- Module Versions -->
+<!ENTITY min-cgi-ver "3.51">
+<!ENTITY min-digest-sha-ver "any">
+<!ENTITY min-date-format-ver "2.23">
+<!ENTITY min-datetime-ver "0.28">
+<!ENTITY min-datetime-timezone-ver "0.71">
+<!ENTITY min-dbi-ver "1.54">
+<!ENTITY min-template-ver "2.22">
+<!ENTITY min-email-send-ver "2.04">
+<!ENTITY min-email-mime-ver "1.904">
+<!ENTITY min-uri-ver "1.37">
+<!ENTITY min-list-moreutils-ver "0.32">
+<!ENTITY min-math-random-isaac-ver "1.0.1">
+<!ENTITY min-gd-ver "1.20">
+<!ENTITY min-chart-lines-ver "2.1">
+<!ENTITY min-template-plugin-gd-image-ver "any">
+<!ENTITY min-gd-text-ver "any">
+<!ENTITY min-gd-graph-ver "any">
+<!ENTITY min-mime-parser-ver "5.406">
+<!ENTITY min-lwp-useragent-ver "any">
+<!ENTITY min-xml-twig-ver "any">
+<!ENTITY min-patchreader-ver "0.9.6">
+<!ENTITY min-net-ldap-ver "any">
+<!ENTITY min-authen-sasl-ver "any">
+<!ENTITY min-net-smtp-ssl-ver "1.01">
+<!ENTITY min-authen-radius-ver "any">
+<!ENTITY min-soap-lite-ver "0.712">
+<!ENTITY min-json-rpc-ver "any">
+<!ENTITY min-json-xs-ver "2.0">
+<!ENTITY min-test-taint-ver "any">
+<!ENTITY min-html-parser-ver "3.40">
+<!ENTITY min-html-scrubber-ver "any">
+<!ENTITY min-encode-ver "2.21">
+<!ENTITY min-encode-detect-ver "any">
+<!ENTITY min-email-reply-ver "any">
+<!ENTITY min-html-formattext-withlinks-ver "0.13">
+<!ENTITY min-theschwartz-ver "any">
+<!ENTITY min-daemon-generic-ver "any">
+<!ENTITY min-mod_perl2-ver "1.999022">
+<!ENTITY min-apache2-sizelimit-ver "0.96">
+<!ENTITY min-file-mimeinfo-magic-ver "any">
+<!ENTITY min-io-scalar-ver "any">
+
+ <!-- Database Versions --> 
+<!ENTITY min-dbd-pg-ver "2.7.0">
+<!ENTITY min-pg-ver "8.03.0000">
+<!ENTITY min-dbd-mysql-ver "4.001">
+<!ENTITY min-mysql-ver "5.0.15">
+<!ENTITY min-dbd-sqlite-ver "1.29">
+<!ENTITY min-sqlite-ver "3.6.22">
+<!ENTITY min-dbd-oracle-ver "1.19">
+<!ENTITY min-oracle-ver "10.02.0">

diff --git a/docs/en/xml/conventions.xml b/docs/en/xml/conventions.xml
new file mode 100644 (file)
index 0000000..7071465
--- /dev/null
+++ b/docs/en/xml/conventions.xml
@@ -0,0 +1,91 @@
+<?xml version="1.0"?>
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                      "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+    <!ENTITY % myents SYSTEM "bugzilla.ent">
+    %myents;
+]>
+
+<section id="conventions">
+  <title>Document Conventions</title>
+
+  <para>This document uses the following conventions:</para>
+
+  <caution>
+    <para>This is a caution. Make sure to read this to not be in trouble!</para>
+  </caution>
+
+  <tip>
+    <para>This is a hint or tip, especially about some configuration tweaks.</para>
+  </tip>
+
+  <note>
+    <para>This is just a note, for your information.</para>
+  </note>
+
+  <warning>
+    <para>This is a warning, something you should take care of.</para>
+  </warning>
+
+  <para>
+    A filename or a path to a filename is displayed like this:
+    <filename>/path/to/filename.ext</filename>
+  </para>
+
+  <para>
+    A command to type in the shell is displayed like this:
+    <command>command --arguments</command>
+  </para>
+
+  <para>bash$ represents a normal user's prompt under bash shell</para>
+
+  <para>bash# represents a root user's prompt under bash shell</para>
+
+  <para>
+    A word which is in the glossary will appear like this:
+    <glossterm linkend="gloss-bugzilla">Bugzilla</glossterm>
+  </para>
+
+  <para>
+    A sample of code is illustrated like this:
+    <programlisting>
+First Line of Code
+Second Line of Code
+...
+    </programlisting>
+  </para>
+
+  <para>
+    This documentation is maintained in DocBook 4.2 XML format.
+    Changes are best submitted as plain text or XML diffs, attached
+    to a bug filed in the <ulink url="&bzg-bugs;">Bugzilla Documentation</ulink>
+    component.
+  </para>
+</section>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-always-quote-attributes:t
+sgml-auto-insert-required-elements:t
+sgml-balanced-tag-edit:t
+sgml-exposed-tags:nil
+sgml-general-insert-case:lower
+sgml-indent-data:t
+sgml-indent-step:2
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+sgml-minimize-attributes:nil
+sgml-namecase-general:t
+sgml-omittag:t
+sgml-parent-document:("Bugzilla-Guide.xml" "book" "chapter")
+sgml-shorttag:t
+sgml-tag-region-if-active:t
+End:
+-->

diff --git a/docs/en/xml/customization.xml b/docs/en/xml/customization.xml
new file mode 100644 (file)
index 0000000..c140acf
--- /dev/null
+++ b/docs/en/xml/customization.xml
@@ -0,0 +1,612 @@
+<?xml version="1.0"?>
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                      "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+    <!ENTITY % myents SYSTEM "bugzilla.ent">
+    %myents;
+]>
+
+<chapter id="customization">
+  <title>Customizing Bugzilla</title>
+
+  <section id="extensions">
+    <title>Bugzilla Extensions</title>
+
+    <para>
+      One of the best ways to customize Bugzilla is by writing a Bugzilla
+      Extension. Bugzilla Extensions let you modify both the code and
+      UI of Bugzilla in a way that can be distributed to other Bugzilla
+      users and ported forward to future versions of Bugzilla with minimal
+      effort.
+    </para>
+
+    <para>
+         See the <ulink url="../html/api/Bugzilla/Extension.html">Bugzilla Extension
+      documentation</ulink> for information on how to write an Extension.
+    </para>
+  </section>
+
+  <section id="cust-skins">
+    <title>Custom Skins</title>
+    
+    <para>
+      Bugzilla allows you to have multiple skins. These are custom CSS and possibly
+      also custom images for Bugzilla. To create a new custom skin, you have two
+      choices:
+      <itemizedlist>
+        <listitem>
+          <para>
+            Make a single CSS file, and put it in the 
+            <filename>skins/contrib</filename> directory.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Make a directory that contains all the same CSS file
+            names as <filename>skins/standard/</filename>, and put
+            your directory in <filename>skins/contrib/</filename>.
+          </para>
+        </listitem>
+      </itemizedlist>
+    </para>
+      
+    <para>
+      After you put the file or the directory there, make sure to run checksetup.pl
+      so that it can reset the file permissions correctly.
+    </para>
+    <para>
+      After you have installed the new skin, it will show up as an option in the
+      user's General Preferences. If you would like to force a particular skin on all
+      users, just select it in the Default Preferences and then uncheck "Enabled" on
+      the preference.
+    </para>
+  </section>
+  
+  <section id="cust-templates">
+    <title>Template Customization</title>
+    
+    <para>
+      Administrators can configure the look and feel of Bugzilla without
+      having to edit Perl files or face the nightmare of massive merge
+      conflicts when they upgrade to a newer version in the future.
+    </para>
+    
+    <para>
+      Templatization also makes localized versions of Bugzilla possible, 
+      for the first time. It's possible to have Bugzilla's UI language 
+      determined by the user's browser. More information is available in
+      <xref linkend="template-http-accept"/>.
+    </para>
+    
+    <section id="template-directory">
+      <title>Template Directory Structure</title>
+      <para>
+        The template directory structure starts with top level directory 
+        named <filename>template</filename>, which contains a directory
+        for each installed localization. The next level defines the
+        language used in the templates. Bugzilla comes with English
+        templates, so the directory name is <filename>en</filename>,
+        and we will discuss <filename>template/en</filename> throughout
+        the documentation. Below <filename>template/en</filename> is the
+        <filename>default</filename> directory, which contains all the
+        standard templates shipped with Bugzilla.
+      </para>
+
+      <warning>
+        <para>
+          A directory <filename>data/templates</filename> also exists;
+          this is where Template Toolkit puts the compiled versions of
+          the templates from either the default or custom directories.
+          <emphasis>Do not</emphasis> directly edit the files in this
+          directory, or all your changes will be lost the next time
+          Template Toolkit recompiles the templates.
+        </para>
+      </warning>
+    </section>
+
+    <section id="template-method">
+      <title>Choosing a Customization Method</title>
+      <para>
+        If you want to edit Bugzilla's templates, the first decision
+        you must make is how you want to go about doing so. There are two
+        choices, and which you use depends mainly on the scope of your 
+        modifications, and the method you plan to use to upgrade Bugzilla.
+      </para> 
+
+      <para>
+        The first method of making customizations is to directly edit the
+        templates found in <filename>template/en/default</filename>.
+        This is probably the best way to go about it if you are going to
+        be upgrading Bugzilla through Bzr, because if you then execute
+        a <command>bzr update</command>, any changes you have made will
+        be merged automagically with the updated versions.
+      </para>
+
+      <note>
+        <para>
+          If you use this method, and Bzr conflicts occur during an
+          update, the conflicted templates (and possibly other parts
+          of your installation) will not work until they are resolved.
+        </para>
+      </note>
+
+      <para>
+        The second method is to copy the templates to be modified
+        into a mirrored directory structure under 
+        <filename>template/en/custom</filename>. Templates in this
+        directory structure automatically override any identically-named
+        and identically-located templates in the 
+        <filename>default</filename> directory. 
+      </para>
+
+      <note>
+        <para>
+          The <filename>custom</filename> directory does not exist
+          at first and must be created if you want to use it.
+        </para>
+      </note>
+
+      <para>
+        The second method of customization should be used if you 
+        use the overwriting method of upgrade, because otherwise 
+        your changes will be lost.  This method may also be better if
+        you are using the Bzr method of upgrading and are going to make major
+        changes, because it is guaranteed that the contents of this directory
+        will not be touched during an upgrade, and you can then decide whether
+        to continue using your own templates, or make the effort to merge your
+        changes into the new versions by hand.
+      </para>
+
+      <para>
+        Using this method, your installation may break if incompatible
+        changes are made to the template interface.  Such changes should
+        be documented in the release notes, provided you are using a
+        stable release of Bugzilla.  If you use using unstable code, you will
+        need to deal with this one yourself, although if possible the changes
+        will be mentioned before they occur in the deprecations section of the
+        previous stable release's release notes.
+      </para>
+
+      <note>
+        <para>
+          Regardless of which method you choose, it is recommended that
+          you run <command>./checksetup.pl</command> after 
+          editing any templates in the <filename>template/en/default</filename>
+          directory, and after creating or editing any templates in the 
+          <filename>custom</filename> directory.
+        </para>
+      </note>
+
+      <warning>
+        <para>
+          It is <emphasis>required</emphasis> that you run 
+          <command>./checksetup.pl</command> after creating a new
+          template in the <filename>custom</filename> directory. Failure
+          to do so will raise an incomprehensible error message.
+        </para>
+      </warning>
+    </section>
+    
+    <section id="template-edit">
+      <title>How To Edit Templates</title>
+      
+      <note>
+        <para>
+          If you are making template changes that you intend on submitting back
+          for inclusion in standard Bugzilla, you should read the relevant
+          sections of the 
+          <ulink url="http://www.bugzilla.org/docs/developer.html">Developers'
+          Guide</ulink>.
+        </para>
+      </note>
+      
+      <para>
+        The syntax of the Template Toolkit language is beyond the scope of
+        this guide. It's reasonably easy to pick up by looking at the current 
+        templates; or, you can read the manual, available on the
+        <ulink url="http://www.template-toolkit.org">Template Toolkit home
+        page</ulink>.
+      </para>
+      
+      <para>
+        One thing you should take particular care about is the need
+        to properly HTML filter data that has been passed into the template.
+        This means that if the data can possibly contain special HTML characters
+        such as &lt;, and the data was not intended to be HTML, they need to be
+        converted to entity form, i.e. &amp;lt;.  You use the 'html' filter in the
+        Template Toolkit to do this (or the 'uri' filter to encode special
+        characters in URLs).  If you forget, you may open up your installation
+        to cross-site scripting attacks.
+      </para>
+
+      <para>
+        Editing templates is a good way of doing a <quote>poor man's custom
+        fields</quote>.
+        For example, if you don't use the Status Whiteboard, but want to have
+        a free-form text entry box for <quote>Build Identifier</quote>,
+        then you can just
+        edit the templates to change the field labels. It's still be called
+        status_whiteboard internally, but your users don't need to know that.
+      </para>
+      
+    </section>
+            
+    
+    <section id="template-formats">
+      <title>Template Formats and Types</title>
+      
+      <para>
+        Some CGI's have the ability to use more than one template. For example,
+        <filename>buglist.cgi</filename> can output itself as RDF, or as two 
+        formats of HTML (complex and simple). The mechanism that provides this 
+        feature is extensible.
+      </para>
+
+      <para>
+        Bugzilla can support different types of output, which again can have 
+        multiple formats. In order to request a certain type, you can append 
+        the &amp;ctype=&lt;contenttype&gt; (such as rdf or html) to the 
+        <filename>&lt;cginame&gt;.cgi</filename> URL. If you would like to 
+        retrieve a certain format, you can use the &amp;format=&lt;format&gt; 
+        (such as simple or complex) in the URL.
+      </para>
+      
+      <para>
+        To see if a CGI supports multiple output formats and types, grep the
+        CGI for <quote>get_format</quote>. If it's not present, adding
+        multiple format/type support isn't too hard - see how it's done in
+        other CGIs, e.g. config.cgi.
+      </para>
+      
+      <para>
+        To make a new format template for a CGI which supports this, 
+        open a current template for
+        that CGI and take note of the INTERFACE comment (if present.) This 
+        comment defines what variables are passed into this template. If 
+        there isn't one, I'm afraid you'll have to read the template and
+        the code to find out what information you get. 
+      </para>     
+  
+      <para>
+        Write your template in whatever markup or text style is appropriate.
+      </para>
+      
+      <para>
+        You now need to decide what content type you want your template
+        served as. The content types are defined in the
+        <filename>Bugzilla/Constants.pm</filename> file in the 
+        <filename>contenttypes</filename>
+        constant. If your content type is not there, add it. Remember
+        the three- or four-letter tag assigned to your content type. 
+        This tag will be part of the template filename.
+      </para>
+
+      <note>
+        <para>
+          After adding or changing a content type, it's suitable to edit
+          <filename>Bugzilla/Constants.pm</filename> in order to reflect
+          the changes. Also, the file should be kept up to date after an
+          upgrade if content types have been customized in the past. 
+        </para>
+      </note>
+      
+      <para>
+        Save the template as <filename>&lt;stubname&gt;-&lt;formatname&gt;.&lt;contenttypetag&gt;.tmpl</filename>. 
+        Try out the template by calling the CGI as 
+        <filename>&lt;cginame&gt;.cgi?format=&lt;formatname&gt;&amp;ctype=&lt;type&gt;</filename> .
+      </para>       
+    </section>
+    
+    
+    <section id="template-specific">
+      <title>Particular Templates</title>
+      
+      <para>
+        There are a few templates you may be particularly interested in
+        customizing for your installation.
+      </para>
+      
+      <para>
+        <command>index.html.tmpl</command>:
+        This is the Bugzilla front page.
+      </para>      
+
+      <para>
+        <command>global/header.html.tmpl</command>:
+        This defines the header that goes on all Bugzilla pages.
+        The header includes the banner, which is what appears to users
+        and is probably what you want to edit instead.  However the
+        header also includes the HTML HEAD section, so you could for
+        example add a stylesheet or META tag by editing the header.
+      </para>
+
+      <para>
+        <command>global/banner.html.tmpl</command>:
+        This contains the <quote>banner</quote>, the part of the header
+        that appears
+        at the top of all Bugzilla pages.  The default banner is reasonably
+        barren, so you'll probably want to customize this to give your
+        installation a distinctive look and feel.  It is recommended you
+        preserve the Bugzilla version number in some form so the version 
+        you are running can be determined, and users know what docs to read.
+      </para>
+
+      <para>
+        <command>global/footer.html.tmpl</command>:
+        This defines the footer that goes on all Bugzilla pages.  Editing
+        this is another way to quickly get a distinctive look and feel for
+        your Bugzilla installation.
+      </para>
+
+      <para>
+        <command>global/variables.none.tmpl</command>:
+        This defines a list of terms that may be changed in order to
+        <quote>brand</quote> the Bugzilla instance In this way, terms
+        like <quote>bugs</quote> can be replaced with <quote>issues</quote>
+        across the whole Bugzilla installation. The name
+        <quote>Bugzilla</quote> and other words can be customized as well.
+      </para>
+
+      <para>
+        <command>list/table.html.tmpl</command>:
+        This template controls the appearance of the bug lists created
+        by Bugzilla. Editing this template allows per-column control of 
+        the width and title of a column, the maximum display length of
+        each entry, and the wrap behaviour of long entries.
+        For long bug lists, Bugzilla inserts a 'break' every 100 bugs by
+        default; this behaviour is also controlled by this template, and
+        that value can be modified here.
+       </para>
+
+      <para>
+        <command>bug/create/user-message.html.tmpl</command>:
+        This is a message that appears near the top of the bug reporting page.
+        By modifying this, you can tell your users how they should report
+        bugs.
+      </para>
+
+      <para>
+        <command>bug/process/midair.html.tmpl</command>:
+        This is the page used if two people submit simultaneous changes to the
+        same bug.  The second person to submit their changes will get this page
+        to tell them what the first person did, and ask if they wish to
+        overwrite those changes or go back and revisit the bug.  The default
+        title and header on this page read "Mid-air collision detected!"  If
+        you work in the aviation industry, or other environment where this
+        might be found offensive (yes, we have true stories of this happening)
+        you'll want to change this to something more appropriate for your
+        environment.
+      </para>
+
+      <para>
+        <command>bug/create/create.html.tmpl</command> and
+        <command>bug/create/comment.txt.tmpl</command>:
+        You may not wish to go to the effort of creating custom fields in
+        Bugzilla, yet you want to make sure that each bug report contains
+        a number of pieces of important information for which there is not
+        a special field. The bug entry system has been designed in an
+        extensible fashion to enable you to add arbitrary HTML widgets,
+        such as drop-down lists or textboxes, to the bug entry page
+        and have their values appear formatted in the initial comment.
+        A hidden field that indicates the format should be added inside
+        the form in order to make the template functional. Its value should
+        be the suffix of the template filename. For example, if the file
+        is called <filename>create-cust.html.tmpl</filename>, then
+        <programlisting>&lt;input type="hidden" name="format" value="cust"&gt;</programlisting>
+        should be used inside the form.
+      </para>
+
+      <para>  
+        An example of this is the mozilla.org 
+        <ulink url="http://landfill.bugzilla.org/bugzilla-tip/enter_bug.cgi?product=WorldControl;format=guided">guided
+        bug submission form</ulink>. The code for this comes with the Bugzilla
+        distribution as an example for you to copy. It can be found in the
+        files 
+        <filename>create-guided.html.tmpl</filename> and
+        <filename>comment-guided.html.tmpl</filename>.
+      </para>  
+
+      <para>
+        So to use this feature, create a custom template for 
+        <filename>enter_bug.cgi</filename>. The default template, on which you
+        could base it, is 
+        <filename>custom/bug/create/create.html.tmpl</filename>.
+        Call it <filename>create-&lt;formatname&gt;.html.tmpl</filename>, and
+        in it, add widgets for each piece of information you'd like
+        collected - such as a build number, or set of steps to reproduce.
+      </para>
+
+      <para>
+        Then, create a template like 
+        <filename>custom/bug/create/comment.txt.tmpl</filename>, and call it 
+        <filename>comment-&lt;formatname&gt;.txt.tmpl</filename>. This 
+        template should reference the form fields you have created using
+        the syntax <filename>[% form.&lt;fieldname&gt; %]</filename>. When a 
+        bug report is
+        submitted, the initial comment attached to the bug report will be
+        formatted according to the layout of this template.
+      </para> 
+
+      <para>
+        For example, if your custom enter_bug template had a field
+        <programlisting>&lt;input type="text" name="buildid" size="30"&gt;</programlisting>
+        and then your comment.txt.tmpl had
+        <programlisting>BuildID: [% form.buildid %]</programlisting>
+        then something like
+        <programlisting>BuildID: 20020303</programlisting>
+        would appear in the initial comment.
+      </para>            
+    </section>          
+
+
+    <section id="template-http-accept">
+      <title>Configuring Bugzilla to Detect the User's Language</title>
+
+      <para>Bugzilla honours the user's Accept: HTTP header. You can install
+      templates in other languages, and Bugzilla will pick the most appropriate
+      according to a priority order defined by you. Many
+      language templates can be obtained from <ulink 
+      url="http://www.bugzilla.org/download.html#localizations"/>. Instructions
+      for submitting new languages are also available from that location.
+      </para>
+    </section>
+      
+  </section>
+
+  <section id="cust-change-permissions">
+    <title>Customizing Who Can Change What</title>
+    
+    <warning>
+      <para>
+        This feature should be considered experimental; the Bugzilla code you
+        will be changing is not stable, and could change or move between 
+        versions. Be aware that if you make modifications as outlined here, 
+        you may have
+        to re-make them or port them if Bugzilla changes internally between
+        versions, and you upgrade.
+      </para>
+    </warning>
+      
+    <para>
+      Companies often have rules about which employees, or classes of employees,
+      are allowed to change certain things in the bug system. For example, 
+      only the bug's designated QA Contact may be allowed to VERIFY the bug.
+      Bugzilla has been
+      designed to make it easy for you to write your own custom rules to define
+      who is allowed to make what sorts of value transition.
+    </para>
+
+    <para>
+     By default, assignees, QA owners and users
+     with <emphasis>editbugs</emphasis> privileges can edit all fields of bugs, 
+     except group restrictions (unless they are members of the groups they 
+     are trying to change). Bug reporters also have the ability to edit some 
+     fields, but in a more restrictive manner. Other users, without 
+     <emphasis>editbugs</emphasis> privileges, cannot edit 
+     bugs, except to comment and add themselves to the CC list.
+    </para> 
+    
+    <para>
+      For maximum flexibility, customizing this means editing Bugzilla's Perl 
+      code. This gives the administrator complete control over exactly who is
+      allowed to do what. The relevant method is called
+      <filename>check_can_change_field()</filename>,
+      and is found in <filename>Bug.pm</filename> in your
+      Bugzilla/ directory. If you open that file and search for
+      <quote>sub check_can_change_field</quote>, you'll find it.
+    </para>
+    
+    <para>
+      This function has been carefully commented to allow you to see exactly
+      how it works, and give you an idea of how to make changes to it.
+      Certain marked sections should not be changed - these are
+      the <quote>plumbing</quote> which makes the rest of the function work.
+      In between those sections, you'll find snippets of code like:
+      <programlisting>    # Allow the assignee to change anything.
+    if ($ownerid eq $whoid) {
+        return 1;
+    }</programlisting>
+      It's fairly obvious what this piece of code does.
+    </para>      
+      
+    <para>
+      So, how does one go about changing this function? Well, simple changes
+      can be made just by removing pieces - for example, if you wanted to 
+      prevent any user adding a comment to a bug, just remove the lines marked
+      <quote>Allow anyone to change comments.</quote> If you don't want the
+      Reporter to have any special rights on bugs they have filed, just
+      remove the entire section that deals with the Reporter.
+    </para>
+    
+    <para>
+      More complex customizations are not much harder. Basically, you add
+      a check in the right place in the function, i.e. after all the variables
+      you are using have been set up. So, don't look at $ownerid before 
+      $ownerid has been obtained from the database. You can either add a
+      positive check, which returns 1 (allow) if certain conditions are true,
+      or a negative check, which returns 0 (deny.) E.g.:
+      <programlisting>    if ($field eq "qacontact") {
+        if (Bugzilla->user->in_group("quality_assurance")) {
+            return 1;
+        } 
+        else {
+            return 0;
+        }
+    }</programlisting>
+      This says that only users in the group "quality_assurance" can change
+      the QA Contact field of a bug.
+    </para>
+
+    <para>
+      Getting more weird:
+      <programlisting><![CDATA[    if (($field eq "priority") &&
+        (Bugzilla->user->email =~ /.*\@example\.com$/))
+    {
+        if ($oldvalue eq "P1") {
+            return 1;
+        } 
+        else {
+            return 0;
+        }
+    }]]></programlisting>
+      This says that if the user is trying to change the priority field,
+      and their email address is @example.com, they can only do so if the
+      old value of the field was "P1". Not very useful, but illustrative.
+    </para>
+
+    <warning>
+      <para>
+        If you are modifying <filename>process_bug.cgi</filename> in any
+        way, do not change the code that is bounded by DO_NOT_CHANGE blocks.
+        Doing so could compromise security, or cause your installation to
+        stop working entirely.
+      </para>
+    </warning>
+    
+    <para>
+      For a list of possible field names, look at the bugs table in the 
+      database. If you need help writing custom rules for your organization,
+      ask in the newsgroup.
+    </para>    
+  </section>   
+
+  <section id="integration">
+    <title>Integrating Bugzilla with Third-Party Tools</title>
+
+    <para>
+      Many utilities and applications can integrate with Bugzilla,
+      either on the client- or server-side. None of them are maintained
+      by the Bugzilla community, nor are they tested during our
+      QA tests, so use them at your own risk. They are listed at
+      <ulink url="https://wiki.mozilla.org/Bugzilla:Addons" />.
+    </para>
+  </section>
+
+</chapter>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-always-quote-attributes:t
+sgml-auto-insert-required-elements:t
+sgml-balanced-tag-edit:t
+sgml-exposed-tags:nil
+sgml-general-insert-case:lower
+sgml-indent-data:t
+sgml-indent-step:2
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+sgml-minimize-attributes:nil
+sgml-namecase-general:t
+sgml-omittag:t
+sgml-parent-document:("Bugzilla-Guide.xml" "book" "chapter")
+sgml-shorttag:t
+sgml-tag-region-if-active:t
+End:
+-->

diff --git a/docs/en/xml/gfdl.xml b/docs/en/xml/gfdl.xml
new file mode 100644 (file)
index 0000000..4d10f28
--- /dev/null
+++ b/docs/en/xml/gfdl.xml
@@ -0,0 +1,457 @@
+<?xml version="1.0"?>
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                      "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+    <!ENTITY % myents SYSTEM "bugzilla.ent">
+    %myents;
+]>
+
+<appendix id="gfdl">
+  <title>GNU Free Documentation License</title>
+
+<!-- - GNU Project - Free Software Foundation (FSF) -->
+<!-- LINK REV="made" HREF="mailto:webmasters@gnu.org" -->
+<!-- section>
+    <title>GNU Free Documentation License</title -->
+  <para>Version 1.1, March 2000</para>
+
+  <blockquote>
+    <para>Copyright (C) 2000 Free Software Foundation, Inc. 51 Franklin Street,
+    Fifth Floor, Boston, MA 02110-1301 USA Everyone is permitted to copy and
+    distribute verbatim copies of this license document, but changing it is
+    not allowed.</para>
+  </blockquote>
+
+  <section label="0" id="gfdl-0">
+    <title>Preamble</title>
+
+    <para>The purpose of this License is to make a manual, textbook, or other
+    written document "free" in the sense of freedom: to assure everyone the
+    effective freedom to copy and redistribute it, with or without modifying
+    it, either commercially or noncommercially. Secondarily, this License
+    preserves for the author and publisher a way to get credit for their
+    work, while not being considered responsible for modifications made by
+    others.</para>
+
+    <para>This License is a kind of "copyleft", which means that derivative
+    works of the document must themselves be free in the same sense. It
+    complements the GNU General Public License, which is a copyleft license
+    designed for free software.</para>
+
+    <para>We have designed this License in order to use it for manuals for
+    free software, because free software needs free documentation: a free
+    program should come with manuals providing the same freedoms that the
+    software does. But this License is not limited to software manuals; it
+    can be used for any textual work, regardless of subject matter or whether
+    it is published as a printed book. We recommend this License principally
+    for works whose purpose is instruction or reference.</para>
+  </section>
+
+  <section label="1" id="gfdl-1">
+    <title>Applicability and Definition</title>
+
+    <para>This License applies to any manual or other work that contains a
+    notice placed by the copyright holder saying it can be distributed under
+    the terms of this License. The "Document", below, refers to any such
+    manual or work. Any member of the public is a licensee, and is addressed
+    as "you".</para>
+
+    <para>A "Modified Version" of the Document means any work containing the
+    Document or a portion of it, either copied verbatim, or with
+    modifications and/or translated into another language.</para>
+
+    <para>A "Secondary Section" is a named appendix or a front-matter section
+    of the Document that deals exclusively with the relationship of the
+    publishers or authors of the Document to the Document's overall subject
+    (or to related matters) and contains nothing that could fall directly
+    within that overall subject. (For example, if the Document is in part a
+    textbook of mathematics, a Secondary Section may not explain any
+    mathematics.) The relationship could be a matter of historical connection
+    with the subject or with related matters, or of legal, commercial,
+    philosophical, ethical or political position regarding them.</para>
+
+    <para>The "Invariant Sections" are certain Secondary Sections whose
+    titles are designated, as being those of Invariant Sections, in the
+    notice that says that the Document is released under this License.</para>
+
+    <para>The "Cover Texts" are certain short passages of text that are
+    listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says
+    that the Document is released under this License.</para>
+
+    <para>A "Transparent" copy of the Document means a machine-readable copy,
+    represented in a format whose specification is available to the general
+    public, whose contents can be viewed and edited directly and
+    straightforwardly with generic text editors or (for images composed of
+    pixels) generic paint programs or (for drawings) some widely available
+    drawing editor, and that is suitable for input to text formatters or for
+    automatic translation to a variety of formats suitable for input to text
+    formatters. A copy made in an otherwise Transparent file format whose
+    markup has been designed to thwart or discourage subsequent modification
+    by readers is not Transparent. A copy that is not "Transparent" is called
+    "Opaque".</para>
+
+    <para>Examples of suitable formats for Transparent copies include plain
+    ASCII without markup, Texinfo input format, LaTeX input format, SGML or
+    XML using a publicly available DTD, and standard-conforming simple HTML
+    designed for human modification. Opaque formats include PostScript, PDF,
+    proprietary formats that can be read and edited only by proprietary word
+    processors, SGML or XML for which the DTD and/or processing tools are not
+    generally available, and the machine-generated HTML produced by some word
+    processors for output purposes only.</para>
+
+    <para>The "Title Page" means, for a printed book, the title page itself,
+    plus such following pages as are needed to hold, legibly, the material
+    this License requires to appear in the title page. For works in formats
+    which do not have any title page as such, "Title Page" means the text
+    near the most prominent appearance of the work's title, preceding the
+    beginning of the body of the text.</para>
+  </section>
+
+  <section label="2" id="gfdl-2">
+    <title>Verbatim Copying</title>
+
+    <para>You may copy and distribute the Document in any medium, either
+    commercially or noncommercially, provided that this License, the
+    copyright notices, and the license notice saying this License applies to
+    the Document are reproduced in all copies, and that you add no other
+    conditions whatsoever to those of this License. You may not use technical
+    measures to obstruct or control the reading or further copying of the
+    copies you make or distribute. However, you may accept compensation in
+    exchange for copies. If you distribute a large enough number of copies
+    you must also follow the conditions in section 3.</para>
+
+    <para>You may also lend copies, under the same conditions stated above,
+    and you may publicly display copies.</para>
+  </section>
+
+  <section label="3" id="gfdl-3">
+    <title>Copying in Quantity</title>
+
+    <para>If you publish printed copies of the Document numbering more than
+    100, and the Document's license notice requires Cover Texts, you must
+    enclose the copies in covers that carry, clearly and legibly, all these
+    Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts
+    on the back cover. Both covers must also clearly and legibly identify you
+    as the publisher of these copies. The front cover must present the full
+    title with all words of the title equally prominent and visible. You may
+    add other material on the covers in addition. Copying with changes
+    limited to the covers, as long as they preserve the title of the Document
+    and satisfy these conditions, can be treated as verbatim copying in other
+    respects.</para>
+
+    <para>If the required texts for either cover are too voluminous to fit
+    legibly, you should put the first ones listed (as many as fit reasonably)
+    on the actual cover, and continue the rest onto adjacent pages.</para>
+
+    <para>If you publish or distribute Opaque copies of the Document
+    numbering more than 100, you must either include a machine-readable
+    Transparent copy along with each Opaque copy, or state in or with each
+    Opaque copy a publicly-accessible computer-network location containing a
+    complete Transparent copy of the Document, free of added material, which
+    the general network-using public has access to download anonymously at no
+    charge using public-standard network protocols. If you use the latter
+    option, you must take reasonably prudent steps, when you begin
+    distribution of Opaque copies in quantity, to ensure that this
+    Transparent copy will remain thus accessible at the stated location until
+    at least one year after the last time you distribute an Opaque copy
+    (directly or through your agents or retailers) of that edition to the
+    public.</para>
+
+    <para>It is requested, but not required, that you contact the authors of
+    the Document well before redistributing any large number of copies, to
+    give them a chance to provide you with an updated version of the
+    Document.</para>
+  </section>
+
+  <section label="4" id="gfdl-4">
+    <title>Modifications</title>
+
+    <para>You may copy and distribute a Modified Version of the Document
+    under the conditions of sections 2 and 3 above, provided that you release
+    the Modified Version under precisely this License, with the Modified
+    Version filling the role of the Document, thus licensing distribution and
+    modification of the Modified Version to whoever possesses a copy of it.
+    In addition, you must do these things in the Modified Version:</para>
+
+    <orderedlist numeration="upperalpha">
+      <listitem>
+        <para>Use in the Title Page (and on the covers, if any) a title
+        distinct from that of the Document, and from those of previous
+        versions (which should, if there were any, be listed in the History
+        section of the Document). You may use the same title as a previous
+        version if the original publisher of that version gives
+        permission.</para>
+      </listitem>
+
+      <listitem>
+        <para>List on the Title Page, as authors, one or more persons or
+        entities responsible for authorship of the modifications in the
+        Modified Version, together with at least five of the principal
+        authors of the Document (all of its principal authors, if it has less
+        than five).</para>
+      </listitem>
+
+      <listitem>
+        <para>State on the Title page the name of the publisher of the
+        Modified Version, as the publisher.</para>
+      </listitem>
+
+      <listitem>
+        <para>Preserve all the copyright notices of the Document.</para>
+      </listitem>
+
+      <listitem>
+        <para>Add an appropriate copyright notice for your modifications
+        adjacent to the other copyright notices.</para>
+      </listitem>
+
+      <listitem>
+        <para>Include, immediately after the copyright notices, a license
+        notice giving the public permission to use the Modified Version under
+        the terms of this License, in the form shown in the Addendum
+        below.</para>
+      </listitem>
+
+      <listitem>
+        <para>Preserve in that license notice the full lists of Invariant
+        Sections and required Cover Texts given in the Document's license
+        notice.</para>
+      </listitem>
+
+      <listitem>
+        <para>Include an unaltered copy of this License.</para>
+      </listitem>
+
+      <listitem>
+        <para>Preserve the section entitled "History", and its title, and add
+        to it an item stating at least the title, year, new authors, and
+        publisher of the Modified Version as given on the Title Page. If
+        there is no section entitled "History" in the Document, create one
+        stating the title, year, authors, and publisher of the Document as
+        given on its Title Page, then add an item describing the Modified
+        Version as stated in the previous sentence.</para>
+      </listitem>
+
+      <listitem>
+        <para>Preserve the network location, if any, given in the Document
+        for public access to a Transparent copy of the Document, and likewise
+        the network locations given in the Document for previous versions it
+        was based on. These may be placed in the "History" section. You may
+        omit a network location for a work that was published at least four
+        years before the Document itself, or if the original publisher of the
+        version it refers to gives permission.</para>
+      </listitem>
+
+      <listitem>
+        <para>In any section entitled "Acknowledgements" or "Dedications",
+        preserve the section's title, and preserve in the section all the
+        substance and tone of each of the contributor acknowledgements and/or
+        dedications given therein.</para>
+      </listitem>
+
+      <listitem>
+        <para>Preserve all the Invariant Sections of the Document, unaltered
+        in their text and in their titles. Section numbers or the equivalent
+        are not considered part of the section titles.</para>
+      </listitem>
+
+      <listitem>
+        <para>Delete any section entitled "Endorsements". Such a section may
+        not be included in the Modified Version.</para>
+      </listitem>
+
+      <listitem>
+        <para>Do not retitle any existing section as "Endorsements" or to
+        conflict in title with any Invariant Section.</para>
+      </listitem>
+    </orderedlist>
+
+    <para>If the Modified Version includes new front-matter sections or
+    appendices that qualify as Secondary Sections and contain no material
+    copied from the Document, you may at your option designate some or all of
+    these sections as invariant. To do this, add their titles to the list of
+    Invariant Sections in the Modified Version's license notice. These titles
+    must be distinct from any other section titles.</para>
+
+    <para>You may add a section entitled "Endorsements", provided it contains
+    nothing but endorsements of your Modified Version by various parties--for
+    example, statements of peer review or that the text has been approved by
+    an organization as the authoritative definition of a standard.</para>
+
+    <para>You may add a passage of up to five words as a Front-Cover Text,
+    and a passage of up to 25 words as a Back-Cover Text, to the end of the
+    list of Cover Texts in the Modified Version. Only one passage of
+    Front-Cover Text and one of Back-Cover Text may be added by (or through
+    arrangements made by) any one entity. If the Document already includes a
+    cover text for the same cover, previously added by you or by arrangement
+    made by the same entity you are acting on behalf of, you may not add
+    another; but you may replace the old one, on explicit permission from the
+    previous publisher that added the old one.</para>
+
+    <para>The author(s) and publisher(s) of the Document do not by this
+    License give permission to use their names for publicity for or to assert
+    or imply endorsement of any Modified Version.</para>
+  </section>
+
+  <section label="5" id="gfdl-5">
+    <title>Combining Documents</title>
+
+    <para>You may combine the Document with other documents released under
+    this License, under the terms defined in section 4 above for modified
+    versions, provided that you include in the combination all of the
+    Invariant Sections of all of the original documents, unmodified, and list
+    them all as Invariant Sections of your combined work in its license
+    notice.</para>
+
+    <para>The combined work need only contain one copy of this License, and
+    multiple identical Invariant Sections may be replaced with a single copy.
+    If there are multiple Invariant Sections with the same name but different
+    contents, make the title of each such section unique by adding at the end
+    of it, in parentheses, the name of the original author or publisher of
+    that section if known, or else a unique number. Make the same adjustment
+    to the section titles in the list of Invariant Sections in the license
+    notice of the combined work.</para>
+
+    <para>In the combination, you must combine any sections entitled
+    "History" in the various original documents, forming one section entitled
+    "History"; likewise combine any sections entitled "Acknowledgements", and
+    any sections entitled "Dedications". You must delete all sections
+    entitled "Endorsements."</para>
+  </section>
+
+  <section label="6" id="gfdl-6">
+    <title>Collections of Documents</title>
+
+    <para>You may make a collection consisting of the Document and other
+    documents released under this License, and replace the individual copies
+    of this License in the various documents with a single copy that is
+    included in the collection, provided that you follow the rules of this
+    License for verbatim copying of each of the documents in all other
+    respects.</para>
+
+    <para>You may extract a single document from such a collection, and
+    distribute it individually under this License, provided you insert a copy
+    of this License into the extracted document, and follow this License in
+    all other respects regarding verbatim copying of that document.</para>
+  </section>
+
+  <section label="7" id="gfdl-7">
+    <title>Aggregation with Independent Works</title>
+
+    <para>A compilation of the Document or its derivatives with other
+    separate and independent documents or works, in or on a volume of a
+    storage or distribution medium, does not as a whole count as a Modified
+    Version of the Document, provided no compilation copyright is claimed for
+    the compilation. Such a compilation is called an "aggregate", and this
+    License does not apply to the other self-contained works thus compiled
+    with the Document, on account of their being thus compiled, if they are
+    not themselves derivative works of the Document.</para>
+
+    <para>If the Cover Text requirement of section 3 is applicable to these
+    copies of the Document, then if the Document is less than one quarter of
+    the entire aggregate, the Document's Cover Texts may be placed on covers
+    that surround only the Document within the aggregate. Otherwise they must
+    appear on covers around the whole aggregate.</para>
+  </section>
+
+  <section label="8" id="gfdl-8">
+    <title>Translation</title>
+
+    <para>Translation is considered a kind of modification, so you may
+    distribute translations of the Document under the terms of section 4.
+    Replacing Invariant Sections with translations requires special
+    permission from their copyright holders, but you may include translations
+    of some or all Invariant Sections in addition to the original versions of
+    these Invariant Sections. You may include a translation of this License
+    provided that you also include the original English version of this
+    License. In case of a disagreement between the translation and the
+    original English version of this License, the original English version
+    will prevail.</para>
+  </section>
+
+  <section label="9" id="gfdl-9">
+    <title>Termination</title>
+
+    <para>You may not copy, modify, sublicense, or distribute the Document
+    except as expressly provided for under this License. Any other attempt to
+    copy, modify, sublicense or distribute the Document is void, and will
+    automatically terminate your rights under this License. However, parties
+    who have received copies, or rights, from you under this License will not
+    have their licenses terminated so long as such parties remain in full
+    compliance.</para>
+  </section>
+
+  <section label="10" id="gfdl-10">
+    <title>Future Revisions of this License</title>
+
+    <para>The Free Software Foundation may publish new, revised versions of
+    the GNU Free Documentation License from time to time. Such new versions
+    will be similar in spirit to the present version, but may differ in
+    detail to address new problems or concerns. See 
+    <ulink url="http://www.gnu.org/copyleft/"/>.</para>
+
+    <para>Each version of the License is given a distinguishing version
+    number. If the Document specifies that a particular numbered version of
+    this License "or any later version" applies to it, you have the option of
+    following the terms and conditions either of that specified version or of
+    any later version that has been published (not as a draft) by the Free
+    Software Foundation. If the Document does not specify a version number of
+    this License, you may choose any version ever published (not as a draft)
+    by the Free Software Foundation.</para>
+  </section>
+
+  <section label="" id="gfdl-howto">
+    <title>How to use this License for your documents</title>
+
+    <para>To use this License in a document you have written, include a copy
+    of the License in the document and put the following copyright and
+    license notices just after the title page:</para>
+
+    <blockquote>
+      <para>Copyright (c) YEAR YOUR NAME. Permission is granted to copy,
+      distribute and/or modify this document under the terms of the GNU Free
+      Documentation License, Version 1.1 or any later version published by
+      the Free Software Foundation; with the Invariant Sections being LIST
+      THEIR TITLES, with the Front-Cover Texts being LIST, and with the
+      Back-Cover Texts being LIST. A copy of the license is included in the
+      section entitled "GNU Free Documentation License".</para>
+    </blockquote>
+
+    <para>If you have no Invariant Sections, write "with no Invariant
+    Sections" instead of saying which ones are invariant. If you have no
+    Front-Cover Texts, write "no Front-Cover Texts" instead of "Front-Cover
+    Texts being LIST"; likewise for Back-Cover Texts.</para>
+
+    <para>If your document contains nontrivial examples of program code, we
+    recommend releasing these examples in parallel under your choice of free
+    software license, such as the GNU General Public License, to permit their
+    use in free software.</para>
+  </section>
+</appendix>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-always-quote-attributes:t
+sgml-auto-insert-required-elements:t
+sgml-balanced-tag-edit:t
+sgml-exposed-tags:nil
+sgml-general-insert-case:lower
+sgml-indent-data:t
+sgml-indent-step:2
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+sgml-minimize-attributes:nil
+sgml-namecase-general:t
+sgml-omittag:t
+sgml-parent-document:("Bugzilla-Guide.xml" "book" "chapter")
+sgml-shorttag:t
+sgml-tag-region-if-active:t
+End:
+-->

diff --git a/docs/en/xml/glossary.xml b/docs/en/xml/glossary.xml
new file mode 100644 (file)
index 0000000..5458fa3
--- /dev/null
+++ b/docs/en/xml/glossary.xml
@@ -0,0 +1,561 @@
+<?xml version="1.0"?>
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<!DOCTYPE glossary PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                      "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+    <!ENTITY % myents SYSTEM "bugzilla.ent">
+    %myents;
+]>
+
+<glossary id="glossary">
+  <glossdiv>
+    <title>0-9, high ascii</title>
+
+    <glossentry id="gloss-htaccess">
+      <glossterm>.htaccess</glossterm>
+
+      <glossdef>
+        <para>Apache web server, and other NCSA-compliant web servers,
+        observe the convention of using files in directories called 
+        <filename>.htaccess</filename>
+
+        to restrict access to certain files. In Bugzilla, they are used
+        to keep secret files which would otherwise
+        compromise your installation - e.g. the 
+        <filename>localconfig</filename>
+        file contains the password to your database.
+        curious.</para>
+      </glossdef>
+    </glossentry>
+  </glossdiv>
+
+  <glossdiv id="gloss-a">
+    <title>A</title>
+
+    <glossentry id="gloss-apache">
+      <glossterm>Apache</glossterm>
+
+      <glossdef>
+        <para>In this context, Apache is the web server most commonly used
+        for serving up Bugzilla 
+        pages. Contrary to popular belief, the apache web server has nothing
+        to do with the ancient and noble Native American tribe, but instead
+        derived its name from the fact that it was 
+        <quote>a patchy</quote>
+        version of the original 
+        <acronym>NCSA</acronym>
+        world-wide-web server.</para>
+
+        <variablelist>
+          <title>Useful Directives when configuring Bugzilla</title>
+
+          <varlistentry>
+            <term><computeroutput><ulink url="http://httpd.apache.org/docs/2.0/mod/mod_mime.html#addhandler">AddHandler</ulink></computeroutput></term>
+            <listitem>
+              <para>Tell Apache that it's OK to run CGI scripts.</para>
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term><computeroutput><ulink url="http://httpd.apache.org/docs-2.0/mod/core.html#allowoverride">AllowOverride</ulink></computeroutput></term>
+            <term><computeroutput><ulink url="http://httpd.apache.org/docs-2.0/mod/core.html#options">Options</ulink></computeroutput></term>
+            <listitem>
+              <para>These directives are used to tell Apache many things about
+              the directory they apply to. For Bugzilla's purposes, we need
+              them to allow script execution and <filename>.htaccess</filename>
+              overrides.
+              </para>
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term><computeroutput><ulink url="http://httpd.apache.org/docs-2.0/mod/mod_dir.html#directoryindex">DirectoryIndex</ulink></computeroutput></term>
+            <listitem>
+              <para>Used to tell Apache what files are indexes. If you can
+              not add <filename>index.cgi</filename> to the list of valid files,
+              you'll need to set <computeroutput>$index_html</computeroutput> to
+              1 in <filename>localconfig</filename> so
+              <command>./checksetup.pl</command> will create an
+              <filename>index.html</filename> that redirects to
+              <filename>index.cgi</filename>.
+              </para>
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term><computeroutput><ulink url="http://httpd.apache.org/docs-2.0/mod/core.html#scriptinterpretersource">ScriptInterpreterSource</ulink></computeroutput></term>
+            <listitem>
+              <para>Used when running Apache on windows so the shebang line
+              doesn't have to be changed in every Bugzilla script.
+              </para>
+            </listitem>
+          </varlistentry>
+        </variablelist>
+
+        <para>For more information about how to configure Apache for Bugzilla,
+        see <xref linkend="http-apache"/>.
+        </para>
+      </glossdef>
+    </glossentry>
+  </glossdiv>
+
+  <glossdiv id="gloss-b">
+    <title>B</title>
+
+    <glossentry>
+      <glossterm>Bug</glossterm>
+
+      <glossdef>
+        <para>A 
+        <quote>bug</quote>
+
+        in Bugzilla refers to an issue entered into the database which has an
+        associated number, assignments, comments, etc. Some also refer to a 
+        <quote>tickets</quote>
+        or 
+        <quote>issues</quote>; 
+        in the context of Bugzilla, they are synonymous.</para>
+      </glossdef>
+    </glossentry>
+
+    <glossentry>
+      <glossterm>Bug Number</glossterm>
+
+      <glossdef>
+        <para>Each Bugzilla bug is assigned a number that uniquely identifies
+        that bug. The bug associated with a bug number can be pulled up via a
+        query, or easily from the very front page by typing the number in the
+        "Find" box.</para>
+      </glossdef>
+    </glossentry>
+
+    <glossentry id="gloss-bugzilla">
+      <glossterm>Bugzilla</glossterm>
+
+      <glossdef>
+        <para>Bugzilla is the world-leading free software bug tracking system.
+        </para>
+      </glossdef>
+    </glossentry>
+  </glossdiv>
+
+  <glossdiv id="gloss-c">
+    <title>C</title>
+
+    <glossentry id="gloss-cgi">
+      <glossterm>Common Gateway Interface</glossterm>
+      <acronym>CGI</acronym>
+      <glossdef>
+        <para><acronym>CGI</acronym> is an acronym for Common Gateway Interface. This is
+        a standard for interfacing an external application with a web server. Bugzilla
+        is an example of a <acronym>CGI</acronym> application.
+        </para>
+      </glossdef>
+    </glossentry>
+
+    <glossentry id="gloss-component">
+      <glossterm>Component</glossterm>
+
+      <glossdef>
+        <para>A Component is a subsection of a Product. It should be a narrow
+        category, tailored to your organization. All Products must contain at
+        least one Component (and, as a matter of fact, creating a Product
+        with no Components will create an error in Bugzilla).</para>
+      </glossdef>
+    </glossentry>
+
+    <glossentry id="gloss-cpan">
+      <glossterm>Comprehensive Perl Archive Network</glossterm>
+      <acronym>CPAN</acronym>
+
+      <!-- TODO: Rewrite def for CPAN -->
+      <glossdef>
+        <para>
+        <acronym>CPAN</acronym>
+
+        stands for the 
+        <quote>Comprehensive Perl Archive Network</quote>. 
+        CPAN maintains a large number of extremely useful 
+        <glossterm>Perl</glossterm>
+        modules - encapsulated chunks of code for performing a
+        particular task.</para>
+      </glossdef>
+    </glossentry>
+
+    <glossentry id="gloss-contrib">
+      <glossterm><filename class="directory">contrib</filename></glossterm>
+
+      <glossdef>
+        <para>The <filename class="directory">contrib</filename> directory is
+        a location to put scripts that have been contributed to Bugzilla but
+        are not a part of the official distribution. These scripts are written
+        by third parties and may be in languages other than perl. For those
+        that are in perl, there may be additional modules or other requirements
+        than those of the official distribution.
+        <note>
+          <para>Scripts in the <filename class="directory">contrib</filename>
+          directory are not officially supported by the Bugzilla team and may
+          break in between versions.
+          </para>
+        </note>
+        </para>
+      </glossdef>
+    </glossentry>
+  </glossdiv>
+
+  <glossdiv id="gloss-d">
+    <title>D</title>
+
+    <glossentry id="gloss-daemon">
+      <glossterm>daemon</glossterm>
+
+      <glossdef>
+        <para>A daemon is a computer program which runs in the background. In
+        general, most daemons are started at boot time via System V init
+        scripts, or through RC scripts on BSD-based systems. 
+        <glossterm>mysqld</glossterm>, 
+        the MySQL server, and 
+        <glossterm>apache</glossterm>, 
+        a web server, are generally run as daemons.</para>
+      </glossdef>
+    </glossentry>
+    
+    <glossentry id="gloss-dos">
+      <glossterm>DOS Attack</glossterm>
+      
+      <glossdef>
+        <para>A DOS, or Denial of Service attack, is when a user attempts to
+        deny access to a web server by repeatedly accessing a page or sending
+        malformed requests to a webserver. A D-DOS, or
+        Distributed Denial of Service attack, is when these requests come
+        from multiple sources at the same time. Unfortunately, these are much
+        more difficult to defend against.
+        </para>
+      </glossdef>
+    </glossentry>
+    
+  </glossdiv>
+
+  <glossdiv id="gloss-g">
+    <title>G</title>
+
+    <glossentry id="gloss-groups">
+      <glossterm>Groups</glossterm>
+
+      <glossdef>
+        <para>The word 
+        <quote>Groups</quote>
+
+        has a very special meaning to Bugzilla. Bugzilla's main security
+        mechanism comes by placing users in groups, and assigning those
+        groups certain privileges to view bugs in particular
+        <glossterm>Products</glossterm>
+        in the 
+        <glossterm>Bugzilla</glossterm>
+        database.</para>
+      </glossdef>
+    </glossentry>
+  </glossdiv>
+
+  <glossdiv id="gloss-j">
+    <title>J</title>
+
+    <glossentry id="gloss-javascript">
+      <glossterm>JavaScript</glossterm>
+      <glossdef>
+        <para>JavaScript is cool, we should talk about it.
+        </para>
+      </glossdef>
+    </glossentry>
+  </glossdiv>
+
+  <glossdiv id="gloss-m">
+    <title>M</title>
+
+    <glossentry id="gloss-mta">
+      <glossterm>Message Transport Agent</glossterm>
+      <acronym>MTA</acronym>
+
+      <glossdef>
+        <para>A Message Transport Agent is used to control the flow of email on a system.
+        The <ulink url="http://search.cpan.org/dist/Email-Send/lib/Email/Send.pm">Email::Send</ulink>
+        Perl module, which Bugzilla uses to send email, can be configured to
+        use many different underlying implementations for actually sending the
+        mail using the <option>mail_delivery_method</option> parameter.
+        </para>
+      </glossdef>
+    </glossentry>
+
+    <glossentry id="gloss-mysql">
+      <glossterm>MySQL</glossterm>
+
+      <glossdef>
+        <para>MySQL is one of the supported
+        <glossterm linkend="gloss-rdbms">RDBMS</glossterm> for Bugzilla. MySQL
+        can be downloaded from <ulink url="http://www.mysql.com"/>. While you
+        should familiarize yourself with all of the documentation, some high
+        points are:
+        </para>
+        <variablelist>
+          <varlistentry>
+            <term><ulink url="http://www.mysql.com/doc/en/Backup.html">Backup</ulink></term>
+            <listitem>
+              <para>Methods for backing up your Bugzilla database.
+              </para>
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term><ulink url="http://www.mysql.com/doc/en/Option_files.html">Option Files</ulink></term>
+            <listitem>
+              <para>Information about how to configure MySQL using
+              <filename>my.cnf</filename>.
+              </para>
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term><ulink url="http://www.mysql.com/doc/en/Privilege_system.html">Privilege System</ulink></term>
+            <listitem>
+              <para>Information about how to protect your MySQL server.
+              </para>
+            </listitem>
+          </varlistentry>
+        </variablelist>
+      </glossdef>
+    </glossentry>
+  </glossdiv>
+
+  <glossdiv id="gloss-p">
+    <title>P</title>
+
+    <glossentry id="gloss-ppm">
+      <glossterm>Perl Package Manager</glossterm>
+      <acronym>PPM</acronym>
+
+      <glossdef>
+        <para><ulink url="http://aspn.activestate.com/ASPN/Downloads/ActivePerl/PPM/"/>
+        </para>
+      </glossdef>
+    </glossentry>
+
+    <glossentry>
+      <glossterm id="gloss-product">Product</glossterm>
+
+      <glossdef>
+        <para>A Product is a broad category of types of bugs, normally
+        representing a single piece of software or entity. In general,
+        there are several Components to a Product. A Product may define a
+        group (used for security) for all bugs entered into
+        its Components.</para>
+      </glossdef>
+    </glossentry>
+
+    <glossentry>
+      <glossterm>Perl</glossterm>
+
+      <glossdef>
+        <para>First written by Larry Wall, Perl is a remarkable program
+        language. It has the benefits of the flexibility of an interpreted
+        scripting language (such as shell script), combined with the speed
+        and power of a compiled language, such as C. 
+        <glossterm>Bugzilla</glossterm>
+
+        is maintained in Perl.</para>
+      </glossdef>
+    </glossentry>
+  </glossdiv>
+
+  <glossdiv id="gloss-q">
+    <title>Q</title>
+
+    <glossentry>
+      <glossterm>QA</glossterm>
+
+      <glossdef>
+        <para>
+        <quote>QA</quote>, 
+        <quote>Q/A</quote>, and 
+        <quote>Q.A.</quote>
+        are short for 
+        <quote>Quality Assurance</quote>. 
+        In most large software development organizations, there is a team
+        devoted to ensuring the product meets minimum standards before
+        shipping. This team will also generally want to track the progress of
+        bugs over their life cycle, thus the need for the 
+        <quote>QA Contact</quote>
+
+        field in a bug.</para>
+      </glossdef>
+    </glossentry>
+  </glossdiv>
+
+  <glossdiv id="gloss-r">
+    <title>R</title>
+
+    <glossentry id="gloss-rdbms">
+      <glossterm>Relational DataBase Management System</glossterm>
+      <acronym>RDBMS</acronym>
+
+      <glossdef>
+        <para>A relational database management system is a database system
+        that stores information in tables that are related to each other.
+        </para>
+      </glossdef>
+    </glossentry>
+
+    <glossentry id="gloss-regexp">
+      <glossterm>Regular Expression</glossterm>
+      <acronym>regexp</acronym>
+
+      <glossdef>
+          <para>A regular expression is an expression used for pattern matching.
+              <ulink url="http://perldoc.com/perl5.6/pod/perlre.html#Regular-Expressions">Documentation</ulink>
+        </para>
+      </glossdef>
+    </glossentry>
+  </glossdiv>
+
+  <glossdiv id="gloss-s">
+    <title>S</title>
+
+    <glossentry id="gloss-service">
+      <glossterm>Service</glossterm>
+      
+      <glossdef>
+        <para>In Windows NT environment, a boot-time background application
+        is referred to as a service. These are generally managed through the
+        control panel while logged in as an account with
+        <quote>Administrator</quote> level capabilities. For more
+        information, consult your Windows manual or the MSKB.
+        </para>
+      </glossdef>
+    </glossentry>
+
+    <glossentry>
+      <glossterm>
+        <acronym>SGML</acronym>
+      </glossterm>
+
+      <glossdef>
+        <para>
+        <acronym>SGML</acronym>
+
+        stands for 
+        <quote>Standard Generalized Markup Language</quote>. 
+        Created in the 1980's to provide an extensible means to maintain
+        documentation based upon content instead of presentation, 
+        <acronym>SGML</acronym>
+
+        has withstood the test of time as a robust, powerful language. 
+        <glossterm>
+          <acronym>XML</acronym>
+        </glossterm>
+
+        is the 
+        <quote>baby brother</quote>
+
+        of SGML; any valid 
+        <acronym>XML</acronym>
+
+        document it, by definition, a valid 
+        <acronym>SGML</acronym>
+
+        document. The document you are reading is written and maintained in 
+        <acronym>SGML</acronym>, 
+        and is also valid 
+        <acronym>XML</acronym>
+
+        if you modify the Document Type Definition.</para>
+      </glossdef>
+    </glossentry>
+  </glossdiv>
+
+  <glossdiv id="gloss-t">
+    <title>T</title>
+
+    <glossentry id="gloss-target-milestone" xreflabel="Target Milestone">
+      <glossterm>Target Milestone</glossterm>
+
+      <glossdef>
+        <para>Target Milestones are Product goals. They are configurable on a
+        per-Product basis. Most software development houses have a concept of
+        
+        <quote>milestones</quote>
+
+        where the people funding a project expect certain functionality on
+        certain dates. Bugzilla facilitates meeting these milestones by
+        giving you the ability to declare by which milestone a bug will be
+        fixed, or an enhancement will be implemented.</para>
+      </glossdef>
+    </glossentry>
+
+    <glossentry id="gloss-tcl">
+      <glossterm>Tool Command Language</glossterm>
+      <acronym>TCL</acronym>
+      <glossdef>
+        <para>TCL is an open source scripting language available for Windows,
+        Macintosh, and Unix based systems. Bugzilla 1.0 was written in TCL but
+        never released. The first release of Bugzilla was 2.0, which was when
+        it was ported to perl.
+        </para>
+      </glossdef>
+    </glossentry>
+  </glossdiv>
+
+  <glossdiv id="gloss-z">
+    <title>Z</title>
+
+    <glossentry id="gloss-zarro">
+      <glossterm>Zarro Boogs Found</glossterm>
+
+      <glossdef>
+        <para>This is just a goofy way of saying that there were no bugs
+        found matching your query. When asked to explain this message,
+        Terry had the following to say:
+        </para>
+
+        <blockquote>
+          <attribution>Terry Weissman</attribution>
+          <para>I've been asked to explain this ... way back when, when
+          Netscape released version 4.0 of its browser, we had a release
+          party.  Naturally, there had been a big push to try and fix every
+          known bug before the release. Naturally, that hadn't actually
+          happened.  (This is not unique to Netscape or to 4.0; the same thing
+          has happened with every software project I've ever seen.)  Anyway,
+          at the release party, T-shirts were handed out that said something
+          like "Netscape 4.0: Zarro Boogs". Just like the software, the
+          T-shirt had no known bugs.  Uh-huh.
+          </para>
+
+          <para>So, when you query for a list of bugs, and it gets no results,
+          you can think of this as a friendly reminder.  Of *course* there are
+          bugs matching your query, they just aren't in the bugsystem yet...
+          </para>
+        </blockquote>
+
+      </glossdef>
+    </glossentry>
+  </glossdiv>
+</glossary>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-always-quote-attributes:t
+sgml-auto-insert-required-elements:t
+sgml-balanced-tag-edit:t
+sgml-exposed-tags:nil
+sgml-general-insert-case:lower
+sgml-indent-data:t
+sgml-indent-step:2
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+sgml-minimize-attributes:nil
+sgml-namecase-general:t
+sgml-omittag:t
+sgml-parent-document:("Bugzilla-Guide.xml" "book" "chapter")
+sgml-shorttag:t
+sgml-tag-region-if-active:t
+End:
+-->

diff --git a/docs/en/xml/index.xml b/docs/en/xml/index.xml
new file mode 100644 (file)
index 0000000..e71a504
--- /dev/null
+++ b/docs/en/xml/index.xml
@@ -0,0 +1,27 @@
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-always-quote-attributes:t
+sgml-auto-insert-required-elements:t
+sgml-balanced-tag-edit:t
+sgml-exposed-tags:nil
+sgml-general-insert-case:lower
+sgml-indent-data:t
+sgml-indent-step:2
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+sgml-minimize-attributes:nil
+sgml-namecase-general:t
+sgml-omittag:t
+sgml-parent-document:("Bugzilla-Guide.xml" "book" "chapter")
+sgml-shorttag:t
+sgml-tag-region-if-active:t
+End:
+-->

diff --git a/docs/en/xml/installation.xml b/docs/en/xml/installation.xml
new file mode 100644 (file)
index 0000000..efd0c46
--- /dev/null
+++ b/docs/en/xml/installation.xml
@@ -0,0 +1,2453 @@
+<?xml version="1.0"?>
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                      "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+    <!ENTITY % myents SYSTEM "bugzilla.ent">
+    %myents;
+]>
+
+<chapter id="installing-bugzilla">
+  <title>Installing Bugzilla</title>
+
+  <section id="installation">
+    <title>Installation</title>
+
+    <note>
+      <para>If you just want to <emphasis>use</emphasis> Bugzilla, 
+      you do not need to install it. None of this chapter is relevant to
+      you. Ask your Bugzilla administrator for the URL to access it from
+      your web browser.
+      </para>
+    </note>
+
+    <para>The Bugzilla server software is usually installed on Linux or 
+    Solaris. 
+    If you are installing on another OS, check <xref linkend="os-specific"/>
+    before you start your installation to see if there are any special
+    instructions.
+    </para>
+
+    <para>This guide assumes that you have administrative access to the
+    Bugzilla machine. It not possible to
+    install and run Bugzilla itself without administrative access except
+    in the very unlikely event that every single prerequisite is
+    already installed.
+    </para>
+
+    <warning>
+      <para>The installation process may make your machine insecure for
+      short periods of time. Make sure there is a firewall between you
+      and the Internet.
+      </para>
+    </warning>
+
+    <para>
+    You are strongly recommended to make a backup of your system
+    before installing Bugzilla (and at regular intervals thereafter :-).
+    </para>
+
+    <para>In outline, the installation proceeds as follows:
+    </para>
+
+    <procedure>
+      <step>
+        <para><link linkend="install-perl">Install Perl</link>
+        (&min-perl-ver; or above)
+        </para>
+      </step>
+      <step>
+        <para><link linkend="install-database">Install a Database Engine</link>
+        </para>
+      </step>
+      <step>
+        <para><link linkend="install-webserver">Install a Webserver</link>
+        </para>
+      </step>
+      <step>
+        <para><link linkend="install-bzfiles">Install Bugzilla</link>
+        </para>
+      </step>
+      <step>
+        <para><link linkend="install-perlmodules">Install Perl modules</link>
+        </para>
+      </step>
+      <step>
+        <para>
+          <link linkend="install-MTA">Install a Mail Transfer Agent</link>
+          (Sendmail 8.7 or above, or an MTA that is Sendmail-compatible with at least this version)
+        </para>
+      </step>
+      <step>
+        <para>Configure all of the above.
+        </para>
+      </step>
+    </procedure>
+
+    <section id="install-perl">
+      <title>Perl</title>
+
+      <para>Installed Version Test: <programlisting>perl -v</programlisting></para>
+      
+      <para>Any machine that doesn't have Perl on it is a sad machine indeed.
+      If you don't have it and your OS doesn't provide official packages, 
+      visit <ulink url="http://www.perl.org"/>.
+      Although Bugzilla runs with Perl &min-perl-ver;,
+      it's a good idea to be using the latest stable version.
+      </para>
+    </section>
+
+    <section id="install-database">
+      <title>Database Engine</title>
+      
+      <para>
+        Bugzilla supports MySQL, PostgreSQL and Oracle as database servers.
+        You only require one of these systems to make use of Bugzilla.
+      </para>
+
+      <section id="install-mysql">
+          <title>MySQL</title>
+          <para>Installed Version Test: <programlisting>mysql -V</programlisting></para>
+      
+          <para>
+          If you don't have it and your OS doesn't provide official packages, 
+          visit <ulink url="http://www.mysql.com"/>. You need MySQL version
+          &min-mysql-ver; or higher.
+          </para>
+      
+          <note>
+            <para> Many of the binary
+            versions of MySQL store their data files in 
+            <filename class="directory">/var</filename>.
+            On some Unix systems, this is part of a smaller root partition,
+            and may not have room for your bug database. To change the data
+            directory, you have to build MySQL from source yourself, and
+            set it as an option to <filename>configure</filename>.</para>
+          </note> 
+           
+          <para>If you install from something other than a packaging/installation
+          system, such as .rpm (RPM Package Manager), .deb (Debian Package), .exe
+          (Windows Executable), or .msi (Windows Installer), make sure the MySQL
+          server is started when the machine boots.
+          </para>
+      </section>
+      
+      <section id="install-pg">
+          <title>PostgreSQL</title>
+          <para>Installed Version Test: <programlisting>psql -V</programlisting></para>
+      
+          <para>
+          If you don't have it and your OS doesn't provide official packages, 
+          visit <ulink url="http://www.postgresql.org/"/>. You need PostgreSQL
+          version &min-pg-ver; or higher.
+          </para>
+           
+          <para>If you install from something other than a packaging/installation
+          system, such as .rpm (RPM Package Manager), .deb (Debian Package), .exe
+          (Windows Executable), or .msi (Windows Installer), make sure the
+          PostgreSQL server is started when the machine boots.
+          </para>
+      </section>
+
+      <section id="install-oracle">
+        <title>Oracle</title>
+        <para>
+          Installed Version Test: <programlisting>select * from v$version</programlisting>
+          (you first have to log in into your DB)
+        </para>
+
+        <para>
+          If you don't have it and your OS doesn't provide official packages,
+          visit <ulink url="http://www.oracle.com/"/>. You need Oracle
+          version &min-oracle-ver; or higher.
+        </para>
+
+        <para>
+          If you install from something other than a packaging/installation
+          system, such as .rpm (RPM Package Manager), .deb (Debian Package), .exe
+          (Windows Executable), or .msi (Windows Installer), make sure the
+          Oracle server is started when the machine boots.
+        </para>
+      </section>
+    </section>
+    
+    <section id="install-webserver">
+      <title>Web Server</title>
+
+      <para>Installed Version Test: view the default welcome page at
+      http://&lt;your-machine&gt;/</para>
+      
+      <para>
+        You have freedom of choice here, pretty much any web server that
+        is capable of running <glossterm linkend="gloss-cgi">CGI</glossterm>
+        scripts will work.
+        However, we strongly recommend using the Apache web server
+        (either 1.3.x or 2.x), and the installation instructions usually assume
+        you are using it. If you have got Bugzilla working using another web server,
+        please share your experiences with us by filing a bug in
+        <ulink url="&bzg-bugs;">Bugzilla Documentation</ulink>.
+      </para>
+
+      <para>
+      If you don't have Apache and your OS doesn't provide official packages, 
+      visit <ulink url="http://httpd.apache.org/"/>.
+      </para>
+
+    </section>
+
+    <section id="install-bzfiles">
+      <title>Bugzilla</title>
+
+      <para>
+        <ulink url="http://www.bugzilla.org/download/">Download a Bugzilla tarball</ulink>
+        (or <ulink url="https://wiki.mozilla.org/Bugzilla:Bzr">check it out from Bzr</ulink>)
+        and place it in a suitable directory, accessible by the default web server user
+        (probably <quote>apache</quote> or <quote>www</quote>). 
+        Good locations are either directly in the web server's document directories or
+        in <filename>/usr/local</filename> with a symbolic link to the web server's 
+        document directories or an alias in the web server's configuration.
+      </para>
+
+      <caution>
+        <para>The default Bugzilla distribution is NOT designed to be placed
+        in a <filename class="directory">cgi-bin</filename> directory. This
+        includes any directory which is configured using the
+        <option>ScriptAlias</option> directive of Apache.
+        </para>
+      </caution>
+      
+      <para>Once all the files are in a web accessible directory, make that
+      directory writable by your web server's user. This is a temporary step
+      until you run the 
+      <filename>checksetup.pl</filename>
+      script, which locks down your installation.</para>
+    </section>
+
+    <section id="install-perlmodules">
+      <title>Perl Modules</title>
+      
+      <para>Bugzilla's installation process is based
+      on a script called <filename>checksetup.pl</filename>. 
+      The first thing it checks is whether you have appropriate 
+      versions of all the required
+      Perl modules. The aim of this section is to pass this check. 
+      When it passes, proceed to <xref linkend="configuration"/>.
+      </para>
+      
+      <para>
+      At this point, you need to <filename>su</filename> to root. You should
+      remain as root until the end of the install. To check you have the
+      required modules, run:
+      </para>
+      
+      <screen><prompt>bash#</prompt> ./checksetup.pl --check-modules</screen>
+ 
+      <para>
+        <filename>checksetup.pl</filename> will print out a list of the
+        required and optional Perl modules, together with the versions
+        (if any) installed on your machine.
+        The list of required modules is reasonably long; however, you 
+        may already have several of them installed.
+      </para>
+      
+      <para>
+        The preferred way to install missing Perl modules is to use the package
+        manager provided by your operating system (e.g <quote>rpm</quote> or
+        <quote>yum</quote> on Linux distros, or <quote>ppm</quote> on Windows
+        if using ActivePerl, see <xref linkend="win32-perl-modules"/>).
+        If some Perl modules are still missing or are too old, then we recommend
+        using the <filename>install-module.pl</filename> script (doesn't work
+        with ActivePerl on Windows). If for some reason you really need to
+        install the Perl modules manually, see
+        <xref linkend="install-perlmodules-manual"/>. For instance, on Unix,
+        you invoke <filename>install-module.pl</filename> as follows:
+      </para>  
+        
+      <screen><prompt>bash#</prompt> perl install-module.pl &lt;modulename&gt;</screen>
+
+      <tip>
+        <para>Many people complain that Perl modules will not install for
+        them. Most times, the error messages complain that they are missing a
+        file in 
+        <quote>@INC</quote>.
+        Virtually every time, this error is due to permissions being set too
+        restrictively for you to compile Perl modules or not having the
+        necessary Perl development libraries installed on your system.
+        Consult your local UNIX systems administrator for help solving these
+        permissions issues; if you 
+        <emphasis>are</emphasis>
+        the local UNIX sysadmin, please consult the newsgroup/mailing list
+        for further assistance or hire someone to help you out.</para>
+      </tip>
+
+      <note>
+        <para>If you are using a package-based system, and attempting to install the
+        Perl modules from CPAN, you may need to install the "development" packages for
+        MySQL and GD before attempting to install the related Perl modules. The names of
+        these packages will vary depending on the specific distribution you are using,
+        but are often called <filename>&lt;packagename&gt;-devel</filename>.</para>
+      </note>
+ 
+      <para>
+        Here is a complete list of modules and their minimum versions.
+        Some modules have special installation notes, which follow.
+      </para>
+
+      <para>Required Perl modules:
+      <orderedlist>
+
+        <listitem>
+          <para>
+            CGI (&min-cgi-ver;)
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Date::Format (&min-date-format-ver;)
+          </para>
+        </listitem>
+    
+        <listitem>
+          <para>
+            DateTime (&min-datetime-ver;)
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            DateTime::TimeZone (&min-datetime-timezone-ver;)
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            DBI (&min-dbi-ver;)
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            DBD::mysql (&min-dbd-mysql-ver;) if using MySQL
+          </para>
+        </listitem>
+        
+        <listitem>
+          <para>
+            DBD::Pg (&min-dbd-pg-ver;) if using PostgreSQL
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            DBD::Oracle (&min-dbd-oracle-ver;) if using Oracle
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Digest::SHA (&min-digest-sha-ver;)
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Email::Send (&min-email-send-ver;)
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Email::MIME (&min-email-mime-ver;)
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Template (&min-template-ver;)
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            URI (&min-uri-ver;)
+          </para>
+        </listitem>
+      </orderedlist>
+
+      Optional Perl modules:
+      <orderedlist>
+        <listitem>
+          <para>
+            GD (&min-gd-ver;) for bug charting
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Template::Plugin::GD::Image
+            (&min-template-plugin-gd-image-ver;) for Graphical Reports
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Chart::Lines (&min-chart-lines-ver;) for bug charting
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            GD::Graph (&min-gd-graph-ver;) for bug charting
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            GD::Text (&min-gd-text-ver;) for bug charting
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            XML::Twig (&min-xml-twig-ver;) for bug import/export
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            MIME::Parser (&min-mime-parser-ver;) for bug import/export
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            LWP::UserAgent
+            (&min-lwp-useragent-ver;) for Automatic Update Notifications
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            PatchReader (&min-patchreader-ver;) for pretty HTML view of patches
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Net::LDAP
+            (&min-net-ldap-ver;) for LDAP Authentication
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Authen::SASL
+            (&min-authen-sasl-ver;) for SASL Authentication
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Authen::Radius
+            (&min-authen-radius-ver;) for RADIUS Authentication
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            SOAP::Lite (&min-soap-lite-ver;) for the web service interface
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            JSON::RPC
+            (&min-json-rpc-ver;) for the JSON-RPC interface
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Test::Taint
+            (&min-test-taint-ver;) for the web service interface
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            HTML::Parser
+            (&min-html-parser-ver;) for More HTML in Product/Group Descriptions
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            HTML::Scrubber
+            (&min-html-scrubber-ver;) for More HTML in Product/Group Descriptions
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Email::Reply
+            (&min-email-reply-ver;) for Inbound Email
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            TheSchwartz
+            (&min-theschwartz-ver;) for Mail Queueing
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Daemon::Generic
+            (&min-daemon-generic-ver;) for Mail Queueing
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            mod_perl2
+            (&min-mod_perl2-ver;) for mod_perl
+          </para>
+        </listitem>
+      </orderedlist>
+      </para>
+    </section>
+
+    <section id="install-MTA">
+      <title>Mail Transfer Agent (MTA)</title>
+    
+      <para>
+        Bugzilla is dependent on the availability of an e-mail system for its 
+        user authentication and for other tasks.
+      </para>
+
+      <note>
+        <para>
+          This is not entirely true.  It is possible to completely disable 
+          email sending, or to have Bugzilla store email messages in a 
+          file instead of sending them.  However, this is mainly intended 
+          for testing, as disabling or diverting email on a production 
+          machine would mean that users could miss important events (such 
+          as bug changes or the creation of new accounts).
+        </para>
+
+        <para>
+          For more information, see the <quote>mail_delivery_method</quote> parameter
+          in <xref linkend="parameters" />.
+        </para>
+      </note>
+    
+      <para>
+        On Linux, any Sendmail-compatible MTA (Mail Transfer Agent) will 
+        suffice.  Sendmail, Postfix, qmail and Exim are examples of common 
+        MTAs. Sendmail is the original Unix MTA, but the others are easier to 
+        configure, and therefore many people replace Sendmail with Postfix or 
+        Exim. They are drop-in replacements, so Bugzilla will not 
+        distinguish between them.
+      </para>
+
+      <para>
+        If you are using Sendmail, version 8.7 or higher is required.
+        If you are using a Sendmail-compatible MTA, it must be congruent with 
+        at least version 8.7 of Sendmail.
+      </para>
+
+      <para>
+        Consult the manual for the specific MTA you choose for detailed 
+        installation instructions. Each of these programs will have their own 
+        configuration files where you must configure certain parameters to 
+        ensure that the mail is delivered properly. They are implemented 
+        as services, and you should ensure that the MTA is in the auto-start 
+        list of services for the machine.
+      </para>
+
+      <para>
+        If a simple mail sent with the command-line 'mail' program 
+        succeeds, then Bugzilla should also be fine.
+      </para>
+
+    </section>  
+    <section id="using-mod_perl-with-bugzilla">
+      <title>Installing Bugzilla on mod_perl</title>
+      <para>It is now possible to run the Bugzilla software under <literal>mod_perl</literal> on
+      Apache. <literal>mod_perl</literal> has some additional requirements to that of running
+      Bugzilla under <literal>mod_cgi</literal> (the standard and previous way).</para>
+      
+      <para>Bugzilla requires <literal>mod_perl</literal> to be installed, which can be
+      obtained from <ulink url="http://perl.apache.org"/> - Bugzilla requires
+      version &min-mod_perl2-ver; (AKA 2.0.0-RC5) to be installed.</para>
+    </section>
+  </section>
+  
+  <section id="configuration">
+    <title>Configuration</title>
+
+    <warning>
+      <para>
+        Poorly-configured MySQL and Bugzilla installations have
+        given attackers full access to systems in the past. Please take the
+        security parts of these guidelines seriously, even for Bugzilla 
+        machines hidden away behind your firewall. Be certain to read
+        <xref linkend="security"/> for some important security tips.
+      </para>      
+    </warning>
+
+    <section id="localconfig">
+      <title>localconfig</title>
+      
+      <para>
+        You should now run <filename>checksetup.pl</filename> again, this time
+        without the <literal>--check-modules</literal> switch.
+      </para>
+      <screen><prompt>bash#</prompt> ./checksetup.pl</screen>
+      <para>
+        This time, <filename>checksetup.pl</filename> should tell you that all
+        the correct modules are installed and will display a message about, and
+        write out a  file called, <filename>localconfig</filename>. This file
+        contains the default settings for a number of Bugzilla parameters.
+      </para>
+      
+      <para>
+        Load this file in your editor. The only two values you
+        <emphasis>need</emphasis> to change are $db_driver and $db_pass,
+        respectively the type of the database and the password for
+        the user you will create for your database. Pick a strong
+        password (for simplicity, it should not contain single quote
+        characters) and put it here. $db_driver can be either 'mysql',
+        'Pg', 'Oracle' or 'Sqlite'.
+      </para>
+
+      <note>
+        <para>
+          In Oracle, <literal>$db_name</literal> should actually be 
+          the SID name of your database (e.g. "XE" if you are using Oracle XE).
+        </para>
+      </note>
+
+      <para>
+        You may need to change the value of 
+        <emphasis>webservergroup</emphasis> if your web server does not 
+        run in the "apache" group.  On Debian, for example, Apache runs in 
+        the "www-data" group.  If you are going to run Bugzilla on a 
+        machine where you do not have root access (such as on a shared web 
+        hosting account), you will need to leave
+        <emphasis>webservergroup</emphasis> empty, ignoring the warnings 
+        that <filename>checksetup.pl</filename> will subsequently display 
+        every time it is run.
+      </para>
+      
+      <caution>
+        <para>
+          If you are using suexec, you should use your own primary group
+          for <emphasis>webservergroup</emphasis> rather than leaving it
+          empty, and see the additional directions in the suexec section
+          <xref linkend="suexec" />.
+        </para>
+      </caution>
+
+      <para>
+        The other options in the <filename>localconfig</filename> file
+        are documented by their accompanying comments. If you have a slightly
+        non-standard database setup, you may wish to change one or more of
+        the other "$db_*" parameters.
+      </para>
+    </section>
+    
+    <section id="database-engine">
+      <title>Database Server</title>
+      <para>
+        This section deals with configuring your database server for use
+        with Bugzilla. Currently, MySQL (<xref linkend="mysql"/>),
+        PostgreSQL (<xref linkend="postgresql"/>), Oracle (<xref linkend="oracle"/>)
+        and SQLite (<xref linkend="sqlite"/>) are available.
+      </para>
+
+      <section id="database-schema">
+        <title>Bugzilla Database Schema</title>
+
+        <para>
+          The Bugzilla database schema is available at
+          <ulink url="http://www.ravenbrook.com/project/p4dti/tool/cgi/bugzilla-schema/">Ravenbrook</ulink>.
+          This very valuable tool can generate a written description of
+          the Bugzilla database schema for any version of Bugzilla. It
+          can also generate a diff between two versions to help someone
+          see what has changed.
+        </para>
+      </section>
+
+      <section id="mysql">
+        <title>MySQL</title>
+
+        <caution>
+          <para>
+            MySQL's default configuration is insecure.
+            We highly recommend to run <filename>mysql_secure_installation</filename>
+            on Linux or the MySQL installer on Windows, and follow the instructions.
+            Important points to note are:
+            <orderedlist>
+              <listitem>
+                <para>Be sure that the root account has a secure password set.</para>
+              </listitem>
+              <listitem>
+                <para>Do not create an anonymous account, and if it exists, say "yes"
+                to remove it.</para>
+              </listitem>
+              <listitem>
+                <para>If your web server and MySQL server are on the same machine,
+                you should disable the network access.</para>
+              </listitem>
+            </orderedlist>
+          </para>
+        </caution>
+ 
+        <section id="mysql-max-allowed-packet">
+          <title>Allow large attachments and many comments</title>
+          
+          <para>By default, MySQL will only allow you to insert things
+          into the database that are smaller than 1MB. Attachments
+          may be larger than this. Also, Bugzilla combines all comments
+          on a single bug into one field for full-text searching, and the
+          combination of all comments on a single bug could in some cases
+          be larger than 1MB.</para>
+          
+          <para>To change MySQL's default, you need to edit your MySQL
+          configuration file, which is usually <filename>/etc/my.cnf</filename>
+          on Linux. We recommend that you allow at least 4MB packets by
+          adding the "max_allowed_packet" parameter to your MySQL 
+          configuration in the "[mysqld]" section, like this:</para>
+
+          <screen>[mysqld]
+# Allow packets up to 4MB
+max_allowed_packet=4M
+          </screen>
+        </section>
+        
+        <section>
+          <title>Allow small words in full-text indexes</title>
+
+          <para>By default, words must be at least four characters in length
+          in order to be indexed by MySQL's full-text indexes. This causes
+          a lot of Bugzilla specific words to be missed, including "cc",
+          "ftp" and "uri".</para>
+
+          <para>MySQL can be configured to index those words by setting the
+          ft_min_word_len param to the minimum size of the words to index.
+          This can be done by modifying the <filename>/etc/my.cnf</filename>
+          according to the example below:</para>
+
+          <screen>[mysqld]
+# Allow small words in full-text indexes
+ft_min_word_len=2</screen>
+
+          <para>Rebuilding the indexes can be done based on documentation found at
+          <ulink url="http://www.mysql.com/doc/en/Fulltext_Fine-tuning.html"/>.
+          </para>
+        </section>
+        
+        <section id="install-setupdatabase-adduser">
+          <title>Add a user to MySQL</title>
+
+          <para>
+            You need to add a new MySQL user for Bugzilla to use.
+            (It's not safe to have Bugzilla use the MySQL root account.)
+            The following instructions assume the defaults in
+            <filename>localconfig</filename>; if you changed those,
+            you need to modify the SQL command appropriately. You will
+            need the <replaceable>$db_pass</replaceable> password you
+            set in <filename>localconfig</filename> in 
+            <xref linkend="localconfig"/>.
+          </para>
+
+          <para>
+            We use an SQL <command>GRANT</command> command to create
+            a <quote>bugs</quote> user. This also restricts the 
+            <quote>bugs</quote>user to operations within a database
+            called <quote>bugs</quote>, and only allows the account
+            to connect from <quote>localhost</quote>. Modify it to
+            reflect your setup if you will be connecting from another
+            machine or as a different user.
+          </para>
+        
+          <para>
+            Run the <filename>mysql</filename> command-line client and enter:
+          </para>
+
+          <screen>
+<prompt>mysql&gt;</prompt> GRANT SELECT, INSERT,
+       UPDATE, DELETE, INDEX, ALTER, CREATE, LOCK TABLES,
+       CREATE TEMPORARY TABLES, DROP, REFERENCES ON bugs.*
+       TO bugs@localhost IDENTIFIED BY '<replaceable>$db_pass</replaceable>';
+<prompt>mysql&gt;</prompt> FLUSH PRIVILEGES;
+          </screen>
+        </section>
+
+        <section>
+          <title>Permit attachments table to grow beyond 4GB</title>
+
+          <para>
+            By default, MySQL will limit the size of a table to 4GB.
+            This limit is present even if the underlying filesystem
+            has no such limit.  To set a higher limit, follow these
+            instructions.
+          </para>
+
+          <para>
+            After you have completed the rest of the installation (or at least the
+            database setup parts), you should run the <filename>MySQL</filename>
+            command-line client and enter the following, replacing <literal>$bugs_db</literal>
+            with your Bugzilla database name (<emphasis>bugs</emphasis> by default):
+          </para>
+
+          <screen>
+<prompt>mysql&gt;</prompt> use <replaceable>$bugs_db</replaceable>
+<prompt>mysql&gt;</prompt> ALTER TABLE attachments
+           AVG_ROW_LENGTH=1000000, MAX_ROWS=20000;
+          </screen>
+
+          <para>
+            The above command will change the limit to 20GB. Mysql will have 
+            to make a temporary copy of your entire table to do this. Ideally, 
+            you should do this when your attachments table is still small. 
+          </para>
+
+          <note>
+            <para>
+              This does not affect Big Files, attachments that are stored directly
+              on disk instead of in the database.
+            </para>
+          </note>
+        </section>
+      </section>
+      
+      <section id="postgresql">
+        <title>PostgreSQL</title>
+        <section>
+          <title>Add a User to PostgreSQL</title>
+
+          <para>You need to add a new user to PostgreSQL for the Bugzilla
+          application to use when accessing the database. The following instructions
+          assume the defaults in <filename>localconfig</filename>; if you
+          changed those, you need to modify the commands appropriately. You will
+          need the <replaceable>$db_pass</replaceable> password you
+          set in <filename>localconfig</filename> in 
+          <xref linkend="localconfig"/>.</para>
+
+          <para>On most systems, to create the user in PostgreSQL, you will need to
+          login as the root user, and then</para>
+
+          <screen><prompt>bash#</prompt> su - postgres</screen>
+
+          <para>As the postgres user, you then need to create a new user: </para>
+            
+          <screen><prompt>bash$</prompt> createuser -U postgres -dRSP bugs</screen>
+ 
+          <para>When asked for a password, provide the password which will be set as
+          <replaceable>$db_pass</replaceable> in <filename>localconfig</filename>.
+          The created user will not be a superuser (-S) and will not be able to create
+          new users (-R). He will only have the ability to create databases (-d).</para>
+        </section>
+        
+        <section>
+          <title>Configure PostgreSQL</title>
+
+          <para>Now, you will need to edit <filename>pg_hba.conf</filename> which is
+          usually located in <filename>/var/lib/pgsql/data/</filename>. In this file,
+          you will need to add a new line to it as follows:</para>
+
+          <para>
+            <computeroutput>host   all    bugs   127.0.0.1    255.255.255.255  md5</computeroutput>
+          </para>
+          
+          <para>This means that for TCP/IP (host) connections, allow connections from
+          '127.0.0.1' to 'all' databases on this server from the 'bugs' user, and use
+          password authentication (md5) for that user.</para>
+
+          <para>Now, you will need to restart PostgreSQL, but you will need to fully
+          stop and start the server rather than just restarting due to the possibility
+          of a change to <filename>postgresql.conf</filename>. After the server has
+          restarted, you will need to edit <filename>localconfig</filename>, finding
+          the <literal>$db_driver</literal> variable and setting it to
+          <literal>Pg</literal> and changing the password in <literal>$db_pass</literal>
+          to the one you picked previously, while setting up the account.</para> 
+        </section>
+      </section>
+
+      <section id="oracle">
+        <title>Oracle</title>
+        <section>
+          <title>Create a New Tablespace</title>
+
+          <para>
+            You can use the existing tablespace or create a new one for Bugzilla.
+            To create a new tablespace, run the following command:
+          </para>
+
+          <programlisting>
+CREATE TABLESPACE bugs
+DATAFILE '<replaceable>$path_to_datafile</replaceable>' SIZE 500M
+AUTOEXTEND ON NEXT 30M MAXSIZE UNLIMITED
+          </programlisting>
+
+          <para>
+            Here, the name of the tablespace is 'bugs', but you can
+            choose another name. <replaceable>$path_to_datafile</replaceable> is
+            the path to the file containing your database, for instance
+            <filename>/u01/oradata/bugzilla.dbf</filename>.
+            The initial size of the database file is set in this example to 500 Mb,
+            with an increment of 30 Mb everytime we reach the size limit of the file.
+          </para>
+        </section>
+
+        <section>
+          <title>Add a User to Oracle</title>
+
+          <para>
+            The user name and password must match what you set in
+            <filename>localconfig</filename> (<literal>$db_user</literal>
+            and <literal>$db_pass</literal>, respectively). Here, we assume that
+            the user name is 'bugs' and the tablespace name is the same
+            as above. 
+          </para>
+
+          <programlisting>
+CREATE USER bugs
+IDENTIFIED BY "<replaceable>$db_pass</replaceable>"
+DEFAULT TABLESPACE bugs
+TEMPORARY TABLESPACE TEMP
+PROFILE DEFAULT;
+-- GRANT/REVOKE ROLE PRIVILEGES
+GRANT CONNECT TO bugs;
+GRANT RESOURCE TO bugs;
+-- GRANT/REVOKE SYSTEM PRIVILEGES
+GRANT UNLIMITED TABLESPACE TO bugs;
+GRANT EXECUTE ON CTXSYS.CTX_DDL TO bugs;
+          </programlisting>
+        </section>
+
+        <section>
+          <title>Configure the Web Server</title>
+
+          <para>
+            If you use Apache, append these lines to <filename>httpd.conf</filename>
+            to set ORACLE_HOME and LD_LIBRARY_PATH. For instance:
+          </para>
+
+          <programlisting>
+SetEnv ORACLE_HOME /u01/app/oracle/product/10.2.0/
+SetEnv LD_LIBRARY_PATH /u01/app/oracle/product/10.2.0/lib/
+          </programlisting>
+
+          <para>
+            When this is done, restart your web server.
+          </para>
+        </section>
+      </section>
+
+      <section id="sqlite">
+        <title>SQLite</title>
+
+        <caution>
+          <para>
+            Due to SQLite's <ulink url="http://sqlite.org/faq.html#q5">concurrency
+            limitations</ulink> we recommend SQLite only for small and development
+            Bugzilla installations.
+          </para>
+        </caution>
+
+        <para>
+          No special configuration is required to run Bugzilla on SQLite.
+          The database will be stored in <filename>data/db/$db_name</filename>,
+          where <literal>$db_name</literal> is the database name defined
+          in <filename>localconfig</filename>.
+        </para>
+      </section>
+    </section>
+
+    <section>
+      <title>checksetup.pl</title>
+
+      <para>
+        Next, rerun <filename>checksetup.pl</filename>. It reconfirms
+        that all the modules are present, and notices the altered 
+        localconfig file, which it assumes you have edited to your
+        satisfaction. It compiles the UI templates,
+        connects to the database using the 'bugs'
+        user you created and the password you defined, and creates the 
+        'bugs' database and the tables therein. 
+      </para>
+
+      <para>
+        After that, it asks for details of an administrator account. Bugzilla
+        can have multiple administrators - you can create more later - but
+        it needs one to start off with.
+        Enter the email address of an administrator, his or her full name, 
+        and a suitable Bugzilla password.
+      </para>
+      
+      <para>
+        <filename>checksetup.pl</filename> will then finish. You may rerun
+        <filename>checksetup.pl</filename> at any time if you wish.
+      </para>
+    </section>
+
+
+    <section id="http">
+      <title>Web server</title>
+      <para>
+        Configure your web server according to the instructions in the
+        appropriate section. (If it makes a difference in your choice,
+        the Bugzilla Team recommends Apache.) To check whether your web server
+       is correctly configured, try to access <filename>testagent.cgi</filename>
+       from your web server. If "OK" is displayed, then your configuration
+       is successful. Regardless of which web server
+        you are using, however, ensure that sensitive information is
+        not remotely available by properly applying the access controls in
+        <xref linkend="security-webserver-access"/>. You can run
+        <filename>testserver.pl</filename> to check if your web server serves
+        Bugzilla files as expected.
+      </para>
+
+      <section id="http-apache">
+        <title>Bugzilla using Apache</title>
+        <para>You have two options for running Bugzilla under Apache - 
+          <link linkend="http-apache-mod_cgi">mod_cgi</link> (the default) and
+          <link linkend="http-apache-mod_perl">mod_perl</link> (new in Bugzilla
+          2.23)
+        </para>
+        <section id="http-apache-mod_cgi">
+            <title>Apache <productname>httpd</productname> with mod_cgi</title>
+    
+            <para>
+            To configure your Apache web server to work with Bugzilla while using
+            mod_cgi, do the following:
+            </para>
+            
+            <procedure>
+            <step>
+                <para>
+                Load <filename>httpd.conf</filename> in your editor.
+                In Fedora and Red Hat Linux, this file is found in
+                <filename class="directory">/etc/httpd/conf</filename>.
+                </para>
+            </step>
+    
+            <step>
+                <para>
+                Apache uses <computeroutput>&lt;Directory&gt;</computeroutput>
+                directives to permit fine-grained permission setting. Add the
+                following lines to a directive that applies to the location
+                of your Bugzilla installation. (If such a section does not
+                exist, you'll want to add one.) In this example, Bugzilla has
+                been installed at 
+                <filename class="directory">/var/www/html/bugzilla</filename>.
+                </para>
+    
+                <programlisting>
+&lt;Directory /var/www/html/bugzilla&gt;
+AddHandler cgi-script .cgi
+Options +ExecCGI
+DirectoryIndex index.cgi index.html
+AllowOverride Limit FileInfo Indexes Options
+&lt;/Directory&gt;
+                </programlisting>
+    
+                <para>
+                These instructions: allow apache to run .cgi files found
+                within the bugzilla directory; instructs the server to look
+                for a file called <filename>index.cgi</filename> or, if not
+                found, <filename>index.html</filename> if someone
+                only types the directory name into the browser; and allows
+                Bugzilla's <filename>.htaccess</filename> files to override
+                some global permissions.
+                </para>
+    
+                <note>
+                <para>
+                    It is possible to make these changes globally, or to the
+                    directive controlling Bugzilla's parent directory (e.g.
+                    <computeroutput>&lt;Directory /var/www/html/&gt;</computeroutput>).
+                    Such changes would also apply to the Bugzilla directory...
+                    but they would also apply to many other places where they
+                    may or may not be appropriate. In most cases, including
+                    this one, it is better to be as restrictive as possible
+                    when granting extra access.
+                </para>
+                </note>
+
+                <note>
+                <para>
+                    On Windows, you may have to also add the
+                    <computeroutput>ScriptInterpreterSource Registry-Strict</computeroutput>
+                    line, see <link linkend="win32-http">Windows specific notes</link>.
+                </para>
+                </note>
+            </step>                    
+    
+            <step>
+                <para>
+                <filename>checksetup.pl</filename> can set tighter permissions
+                on Bugzilla's files and directories if it knows what group the
+                web server runs as. Find the <computeroutput>Group</computeroutput>
+                line in <filename>httpd.conf</filename>, place the value found
+                there in the <replaceable>$webservergroup</replaceable> variable
+                in <filename>localconfig</filename>, then rerun
+                <filename>checksetup.pl</filename>.
+                </para>
+            </step>
+
+            <step>
+                <para>
+                Optional: If Bugzilla does not actually reside in the webspace
+                directory, but instead has been symbolically linked there, you
+                will need to add the following to the
+                <computeroutput>Options</computeroutput> line of the Bugzilla 
+                <computeroutput>&lt;Directory&gt;</computeroutput> directive
+                (the same one as in the step above):
+                </para>
+    
+                <programlisting>+FollowSymLinks</programlisting>
+    
+                <para>
+                Without this directive, Apache will not follow symbolic links
+                to places outside its own directory structure, and you will be
+                unable to run Bugzilla.
+                </para>
+            </step>
+            </procedure>
+        </section>
+        <section id="http-apache-mod_perl">
+            <title>Apache <productname>httpd</productname> with mod_perl</title>
+            
+            <para>Some configuration is required to make Bugzilla work with Apache
+            and mod_perl</para>
+            
+            <procedure>
+            <step>
+                <para>
+                Load <filename>httpd.conf</filename> in your editor.
+                In Fedora and Red Hat Linux, this file is found in
+                <filename class="directory">/etc/httpd/conf</filename>.
+                </para>
+            </step>
+            
+            <step>
+                <para>Add the following information to your httpd.conf file, substituting
+                where appropriate with your own local paths.</para>
+                
+                <note>
+                <para>This should be used instead of the &lt;Directory&gt; block
+                shown above. This should also be above any other <literal>mod_perl</literal>
+                directives within the <filename>httpd.conf</filename> and must be specified
+                in the order as below.</para>
+                </note>
+                <warning>
+                <para>You should also ensure that you have disabled <literal>KeepAlive</literal>
+                support in your Apache install when utilizing Bugzilla under mod_perl</para>
+                </warning> 
+
+                <programlisting>
+PerlSwitches -w -T
+PerlConfigRequire /var/www/html/bugzilla/mod_perl.pl
+                </programlisting>
+            </step>
+                       
+                       <step>
+                               <para>
+                                       <filename>checksetup.pl</filename> can set tighter permissions
+                                       on Bugzilla's files and directories if it knows what group the
+                                       web server runs as. Find the <computeroutput>Group</computeroutput>
+                                       line in <filename>httpd.conf</filename>, place the value found
+                                       there in the <replaceable>$webservergroup</replaceable> variable
+                                       in <filename>localconfig</filename>, then rerun
+                                       <filename>checksetup.pl</filename>.
+                               </para>
+            </step>
+            </procedure>
+            
+            <para>On restarting Apache, Bugzilla should now be running within the
+            mod_perl environment. Please ensure you have run checksetup.pl to set
+                   permissions before you restart Apache.</para>
+        
+            <note>
+            <para>Please bear the following points in mind when looking at using 
+                Bugzilla under mod_perl: 
+            <itemizedlist>
+                <listitem>
+                <para>
+                    mod_perl support in Bugzilla can take up a HUGE amount of RAM. You could be
+                    looking at 30MB per httpd child, easily. Basically, you just need a lot of RAM.
+                    The more RAM you can get, the better. mod_perl is basically trading RAM for
+                    speed. At least 2GB total system RAM is recommended for running Bugzilla under
+                    mod_perl.
+                </para>
+                </listitem>
+                <listitem>
+                <para>
+                    Under mod_perl, you have to restart Apache if you make any manual change to
+                    any Bugzilla file. You can't just reload--you have to actually 
+                                       <emphasis>restart</emphasis> the server (as in make sure it stops and starts 
+                                       again). You <emphasis>can</emphasis> change localconfig and the params file 
+                                       manually, if you want, because those are re-read every time you load a page.
+                </para>
+                </listitem>
+                <listitem>
+                <para>
+                    You must run in Apache's Prefork MPM (this is the default). The Worker MPM
+                    may not work--we haven't tested Bugzilla's mod_perl support under threads.
+                                       (And, in fact, we're fairly sure it <emphasis>won't</emphasis> work.)
+                </para>
+                </listitem>
+                <listitem>
+                <para>
+                    Bugzilla generally expects to be the only mod_perl application running on
+                    your entire server. It may or may not work if there are other applications also
+                    running under mod_perl. It does try its best to play nice with other mod_perl
+                    applications, but it still may have conflicts.
+                </para>
+                </listitem>
+                <listitem>
+                <para>
+                    It is recommended that you have one Bugzilla instance running under mod_perl
+                    on your server. Bugzilla has not been tested with more than one instance running.
+                </para>
+                </listitem>
+            </itemizedlist>
+            </para>
+            </note>
+        </section>
+      </section>
+      
+      <section id="http-iis">
+        <title>Microsoft <productname>Internet Information Services</productname></title>
+
+        <para>
+          If you are running Bugzilla on Windows and choose to use
+          Microsoft's <productname>Internet Information Services</productname>
+          or <productname>Personal Web Server</productname> you will need
+          to perform a number of other configuration steps as explained below.
+          You may also want to refer to the following Microsoft Knowledge
+          Base articles: 
+          <ulink url="http://support.microsoft.com/default.aspx?scid=kb;en-us;245225">245225</ulink> 
+          <quote>HOW TO: Configure and Test a PERL Script with IIS 4.0,
+          5.0, and 5.1</quote> (for <productname>Internet Information
+          Services</productname>) and 
+          <ulink url="http://support.microsoft.com/default.aspx?scid=kb;en-us;231998">231998</ulink>          
+          <quote>HOW TO: FP2000: How to Use Perl with Microsoft Personal Web
+          Server on Windows 95/98</quote> (for <productname>Personal Web
+          Server</productname>).
+        </para>
+
+        <para>
+          You will need to create a virtual directory for the Bugzilla
+          install.  Put the Bugzilla files in a directory that is named
+          something <emphasis>other</emphasis> than what you want your
+          end-users accessing.  That is, if you want your users to access
+          your Bugzilla installation through 
+          <quote>http://&lt;yourdomainname&gt;/Bugzilla</quote>, then do
+          <emphasis>not</emphasis> put your Bugzilla files in a directory
+          named <quote>Bugzilla</quote>.  Instead, place them in a different
+          location, and then use the IIS Administration tool to create a
+          Virtual Directory named "Bugzilla" that acts as an alias for the
+          actual location of the files.  When creating that virtual directory,
+          make sure you add the <quote>Execute (such as ISAPI applications or
+          CGI)</quote> access permission.
+        </para>
+
+        <para>
+          You will also need to tell IIS how to handle Bugzilla's
+          .cgi files. Using the IIS Administration tool again, open up
+          the properties for the new virtual directory and select the
+          Configuration option to access the Script Mappings. Create an
+          entry mapping .cgi to:
+        </para>
+
+        <programlisting>
+&lt;full path to perl.exe &gt;\perl.exe -x&lt;full path to Bugzilla&gt; -wT "%s" %s
+        </programlisting>
+
+        <para>
+          For example:
+        </para>
+
+        <programlisting>
+c:\perl\bin\perl.exe -xc:\bugzilla -wT "%s" %s
+        </programlisting>
+
+        <note>
+          <para>
+            The ActiveState install may have already created an entry for
+            .pl files that is limited to <quote>GET,HEAD,POST</quote>. If
+            so, this mapping should be <emphasis>removed</emphasis> as
+            Bugzilla's .pl files are not designed to be run via a web server.
+          </para>
+        </note>
+
+        <para>
+          IIS will also need to know that the index.cgi should be treated
+          as a default document.  On the Documents tab page of the virtual
+          directory properties, you need to add index.cgi as a default
+          document type.  If you  wish, you may remove the other default
+          document types for this particular virtual directory, since Bugzilla 
+          doesn't use any of them.
+        </para>
+
+        <para>
+          Also, and this can't be stressed enough, make sure that files
+          such as <filename>localconfig</filename> and your
+          <filename class="directory">data</filename> directory are
+          secured as described in <xref linkend="security-webserver-access"/>.
+        </para>
+
+      </section>
+
+    </section>
+    
+    <section id="install-config-bugzilla">
+      <title>Bugzilla</title>
+      
+      <para>
+        Your Bugzilla should now be working. Access 
+        <filename>http://&lt;your-bugzilla-server&gt;/</filename> - 
+        you should see the Bugzilla
+        front page. If not, consult the Troubleshooting section,
+        <xref linkend="troubleshooting"/>.
+      </para>
+
+      <note>
+        <para>
+          The URL above may be incorrect if you installed Bugzilla into a 
+          subdirectory or used a symbolic link from your web site root to 
+          the Bugzilla directory.
+        </para>
+      </note>
+      
+      <para>
+        Log in with the administrator account you defined in the last 
+        <filename>checksetup.pl</filename> run. You should go through 
+        the Parameters page and see if there are any you wish to change.
+        They key parameters are documented in <xref linkend="parameters"/>;
+        you should certainly alter 
+        <command>maintainer</command> and <command>urlbase</command>; 
+        you may also want to alter 
+        <command>cookiepath</command> or <command>requirelogin</command>.
+      </para>
+
+      <para>
+        Bugzilla has several optional features which require extra 
+        configuration. You can read about those in
+        <xref linkend="extraconfig"/>.
+      </para>
+    </section> 
+  </section>
+
+  <section id="extraconfig">
+    <title>Optional Additional Configuration</title>
+
+    <para>
+      Bugzilla has a number of optional features. This section describes how
+      to configure or enable them.
+    </para>
+    
+    <section>
+      <title>Bug Graphs</title>
+
+      <para>If you have installed the necessary Perl modules you
+      can start collecting statistics for the nifty Bugzilla 
+      graphs.</para>
+
+      <screen><prompt>bash#</prompt> <command>crontab -e</command></screen>
+
+      <para>
+        This should bring up the crontab file in your editor. 
+        Add a cron entry like this to run 
+        <filename>collectstats.pl</filename> 
+        daily at 5 after midnight:
+      </para>
+      
+      <programlisting>5 0 * * * cd &lt;your-bugzilla-directory&gt; &amp;&amp; ./collectstats.pl</programlisting>
+
+      <para>
+        After two days have passed you'll be able to view bug graphs from
+        the Reports page.
+      </para>
+
+      <note>
+        <para>
+          Windows does not have 'cron', but it does have the Task
+          Scheduler, which performs the same duties. There are also
+          third-party tools that can be used to implement cron, such as
+          <ulink url="http://www.nncron.ru/">nncron</ulink>.
+        </para>
+      </note>
+    </section>
+
+    <section id="installation-whining-cron">
+      <title>The Whining Cron</title>
+
+      <para>What good are
+      bugs if they're not annoying? To help make them more so you
+      can set up Bugzilla's automatic whining system to complain at engineers
+      which leave their bugs in the CONFIRMED state without triaging them.
+      </para>
+      <para>
+        This can be done by adding the following command as a daily
+        crontab entry, in the same manner as explained above for bug
+        graphs. This example runs it at 12.55am. 
+      </para>
+
+      <programlisting>55 0 * * * cd &lt;your-bugzilla-directory&gt; &amp;&amp; ./whineatnews.pl</programlisting>
+
+      <note>
+        <para>
+          Windows does not have 'cron', but it does have the Task
+          Scheduler, which performs the same duties. There are also
+          third-party tools that can be used to implement cron, such as
+          <ulink url="http://www.nncron.ru/">nncron</ulink>.
+        </para>
+      </note>
+    </section>
+
+    <section id="installation-whining">
+      <title>Whining</title>
+
+      <para>
+        As of Bugzilla 2.20, users can configure Bugzilla to regularly annoy 
+        them at regular intervals, by having Bugzilla execute saved searches
+        at certain times and emailing the results to the user.  This is known
+        as "Whining".  The process of configuring Whining is described 
+        in <xref linkend="whining"/>, but for it to work a Perl script must be
+        executed at regular intervals.
+      </para>
+
+      <para>
+        This can be done by adding the following command as a daily
+        crontab entry, in the same manner as explained above for bug
+        graphs. This example runs it every 15 minutes. 
+      </para>
+
+      <programlisting>*/15 * * * * cd &lt;your-bugzilla-directory&gt; &amp;&amp; ./whine.pl</programlisting>
+
+      <note>
+        <para>
+          Whines can be executed as often as every 15 minutes, so if you specify
+          longer intervals between executions of whine.pl, some users may not 
+          be whined at as often as they would expect.  Depending on the person,
+          this can either be a very Good Thing or a very Bad Thing.
+        </para>
+      </note>
+
+      <note>
+        <para>
+          Windows does not have 'cron', but it does have the Task
+          Scheduler, which performs the same duties. There are also
+          third-party tools that can be used to implement cron, such as
+          <ulink url="http://www.nncron.ru/">nncron</ulink>.
+        </para>
+      </note>
+    </section>
+        
+    <section id="apache-addtype">
+      <title>Serving Alternate Formats with the right MIME type</title>
+
+      <para>
+        Some Bugzilla pages have alternate formats, other than just plain
+        <acronym>HTML</acronym>. In particular, a few Bugzilla pages can 
+        output their contents as either <acronym>XUL</acronym> (a special 
+        Mozilla format, that looks like a program <acronym>GUI</acronym>) 
+        or <acronym>RDF</acronym> (a type of structured <acronym>XML</acronym> 
+        that can be read by various programs).
+      </para>
+      <para>
+        In order for your users to see these pages correctly, Apache must 
+        send them with the right <acronym>MIME</acronym> type. To do this, 
+        add the following lines to your Apache configuration, either in the 
+        <computeroutput>&lt;VirtualHost&gt;</computeroutput> section for your
+        Bugzilla, or in the <computeroutput>&lt;Directory&gt;</computeroutput>
+        section for your Bugzilla:
+      </para>
+      <para>
+        <screen>AddType application/vnd.mozilla.xul+xml .xul
+AddType application/rdf+xml .rdf</screen>
+      </para>
+    </section>    
+  </section>
+
+  <section id="multiple-bz-dbs">
+    <title>Multiple Bugzilla databases with a single installation</title>
+
+    <para>The previous instructions referred to a standard installation, with
+      one unique Bugzilla database. However, you may want to host several
+      distinct installations, without having several copies of the code. This is
+      possible by using the PROJECT environment variable. When accessed,
+      Bugzilla checks for the existence of this variable, and if present, uses
+      its value to check for an alternative configuration file named
+      <filename>localconfig.&lt;PROJECT&gt;</filename> in the same location as
+      the default one (<filename>localconfig</filename>). It also checks for
+      customized templates in a directory named
+      <filename>&lt;PROJECT&gt;</filename> in the same location as the
+      default one (<filename>template/&lt;langcode&gt;</filename>). By default
+      this is <filename>template/en/default</filename> so PROJECT's templates
+      would be located at <filename>template/en/PROJECT</filename>.</para> 
+
+      <para>To set up an alternate installation, just export PROJECT=foo before
+      running <command>checksetup.pl</command> for the first time. It will
+      result in a file called <filename>localconfig.foo</filename> instead of
+      <filename>localconfig</filename>. Edit this file as described above, with
+      reference to a new database, and re-run <command>checksetup.pl</command>
+      to populate it. That's all.</para>
+
+    <para>Now you have to configure the web server to pass this environment
+      variable when accessed via an alternate URL, such as virtual host for
+      instance. The following is an example of how you could do it in Apache,
+      other Webservers may differ.
+<programlisting>
+&lt;VirtualHost 212.85.153.228:80&gt;
+    ServerName foo.bar.baz
+    SetEnv PROJECT foo
+    Alias /bugzilla /var/www/bugzilla
+&lt;/VirtualHost&gt;
+</programlisting>
+    </para>
+
+    <para>Don't forget to also export this variable before accessing Bugzilla
+       by other means, such as cron tasks for instance.</para> 
+  </section>
+
+  <section id="os-specific">
+    <title>OS-Specific Installation Notes</title>
+
+    <para>Many aspects of the Bugzilla installation can be affected by the
+    operating system you choose to install it on. Sometimes it can be made
+    easier and others more difficult. This section will attempt to help you
+    understand both the difficulties of running on specific operating systems
+    and the utilities available to make it easier.
+    </para>
+
+    <para>If you have anything to add or notes for an operating system not covered,
+    please file a bug in <ulink url="&bzg-bugs;">Bugzilla Documentation</ulink>.
+    </para>
+
+    <section id="os-win32">
+      <title>Microsoft Windows</title>
+      <para>
+        Making Bugzilla work on Windows is more difficult than making it
+        work on Unix.  For that reason, we still recommend doing so on a Unix 
+        based system such as GNU/Linux.  That said, if you do want to get
+        Bugzilla running on Windows, you will need to make the following
+        adjustments. A detailed step-by-step
+        <ulink url="https://wiki.mozilla.org/Bugzilla:Win32Install">
+        installation guide for Windows</ulink> is also available
+        if you need more help with your installation.
+      </para>
+
+      <section id="win32-perl">
+        <title>Win32 Perl</title>
+        <para>
+          Perl for Windows can be obtained from 
+          <ulink url="http://www.activestate.com/">ActiveState</ulink>.
+           You should be able to find a compiled binary at <ulink 
+           url="http://aspn.activestate.com/ASPN/Downloads/ActivePerl/" />.
+           The following instructions assume that you are using version
+           5.8.1 of ActiveState.
+          </para>
+
+          <note>
+            <para>
+             These instructions are for 32-bit versions of Windows. If you are
+             using a 64-bit version of Windows, you will need to install 32-bit
+             Perl in order to install the 32-bit modules as described below.
+            </para>
+          </note>
+
+        </section>
+  
+      <section id="win32-perl-modules">
+        <title>Perl Modules on Win32</title>
+
+        <para>
+          Bugzilla on Windows requires the same perl modules found in
+          <xref linkend="install-perlmodules"/>. The main difference is that
+          windows uses <glossterm linkend="gloss-ppm">PPM</glossterm> instead
+          of CPAN. ActiveState provides a GUI to manage Perl modules. We highly
+          recommend that you use it. If you prefer to use ppm from the
+          command-line, type:
+        </para>
+
+        <programlisting>
+C:\perl&gt; <command>ppm install &lt;module name&gt;</command>
+        </programlisting>
+
+        <note>
+          <para>
+            The PPM repository stores modules in 'packages' that may have
+            a slightly different name than the module.  If retrieving these
+            modules from there, you will need to pay attention to the information
+            provided when you run <command>checksetup.pl</command> as it will
+            tell you what package you'll need to install.
+          </para>
+        </note>
+
+        <tip>
+          <para>
+            If you are behind a corporate firewall, you will need to let the
+            ActiveState PPM utility know how to get through it to access
+            the repositories by setting the HTTP_proxy system environmental
+            variable. For more information on setting that variable, see
+            the ActiveState documentation.
+          </para>
+        </tip>
+      </section>
+  
+      <section id="win32-http">
+        <title>Serving the web pages</title>
+
+        <para>
+          As is the case on Unix based systems, any web server should
+          be able to handle Bugzilla; however, the Bugzilla Team still
+          recommends Apache whenever asked. No matter what web server
+          you choose, be sure to pay attention to the security notes
+          in <xref linkend="security-webserver-access"/>. More
+          information on configuring specific web servers can be found
+          in <xref linkend="http"/>.
+        </para>
+
+        <note>
+          <para>
+            The web server looks at <filename>/usr/bin/perl</filename> to
+            call Perl. If you are using Apache on windows, you can set the
+            <ulink url="http://httpd.apache.org/docs-2.0/mod/core.html#scriptinterpretersource">ScriptInterpreterSource</ulink>
+            directive in your Apache config file to make it look at the
+            right place: insert the line
+            <programlisting>ScriptInterpreterSource Registry-Strict</programlisting>
+            into your <filename>httpd.conf</filename> file, and create the key
+            <programlisting>HKEY_CLASSES_ROOT\.cgi\Shell\ExecCGI\Command</programlisting>
+            with <option>C:\Perl\bin\perl.exe -T</option> as value (adapt to your
+            path if needed) in the registry. When this is done, restart Apache.
+          </para>
+        </note>
+
+      </section>
+      
+      <section id="win32-email">
+        <title>Sending Email</title>
+
+        <para>
+          To enable Bugzilla to send email on Windows, the server running the
+          Bugzilla code must be able to connect to, or act as, an SMTP server.
+        </para>
+        
+      </section>
+    </section>
+
+    <section id="os-macosx">
+      <title><productname>Mac OS X</productname></title>
+
+      <para>Making Bugzilla work on Mac OS X requires the following 
+      adjustments.</para>
+
+      <section id="macosx-sendmail">
+        <title>Sendmail</title>
+
+        <para>In Mac OS X 10.3 and later, 
+        <ulink url="http://www.postfix.org/">Postfix</ulink> 
+        is used as the built-in email server.  Postfix provides an executable
+        that mimics sendmail enough to fool Bugzilla, as long as Bugzilla can 
+        find it. Bugzilla is able to find the fake sendmail executable without
+        any assistance.</para>
+
+      </section>
+
+      <section id="macosx-libraries">
+        <title>Libraries &amp; Perl Modules on Mac OS X</title>
+
+        <para>Apple does not include the GD library with Mac OS X. Bugzilla
+        needs this for bug graphs.</para>
+
+        <para>You can use MacPorts (<ulink url="http://www.macports.org/"/>)
+        or Fink (<ulink url="http://sourceforge.net/projects/fink/"/>), both
+        of which are similar in nature to the CPAN installer, but install
+        common unix programs.</para>
+
+        <para>Follow the instructions for setting up MacPorts or Fink.
+        Once you have one installed, you'll want to use it to install the
+        <filename>gd2</filename> package.
+        </para>
+
+        <para>Fink will prompt you for a number of dependencies, type 'y' and hit
+        enter to install all of the dependencies and then watch it work. You will
+        then be able to use <glossterm linkend="gloss-cpan">CPAN</glossterm> to
+        install the GD Perl module.
+        </para>
+
+        <note>
+          <para>To prevent creating conflicts with the software that Apple
+          installs by default, Fink creates its own directory tree at 
+          <filename class="directory">/sw</filename> where it installs most of
+          the software that it installs. This means your libraries and headers
+          will be at <filename class="directory">/sw/lib</filename> and
+          <filename class="directory">/sw/include</filename> instead of
+          <filename class="directory">/usr/lib</filename> and
+          <filename class="directory">/usr/include</filename>. When the
+          Perl module config script asks where your <filename>libgd</filename>
+          is, be sure to tell it
+          <filename class="directory">/sw/lib</filename>.
+          </para>
+        </note>
+
+        <para>Also available via MacPorts and Fink is
+        <filename>expat</filename>. After installing the expat package, you
+        will be able to install XML::Parser using CPAN. If you use fink, there
+        is one caveat. Unlike recent versions of
+        the GD module, XML::Parser doesn't prompt for the location of the
+        required libraries. When using CPAN, you will need to use the following
+        command sequence:
+        </para>
+
+        <screen>
+# perl -MCPAN -e'look XML::Parser'
+# perl Makefile.PL EXPATLIBPATH=/sw/lib EXPATINCPATH=/sw/include
+# make; make test; make install
+# exit
+        </screen>
+        <para>
+          The <command>look</command> command will download the module and spawn
+          a new shell with the extracted files as the current working directory.
+        </para>
+        <para>
+          You should watch the output from these <command>make</command> commands,
+          especially <quote>make test</quote> as errors may prevent
+          XML::Parser from functioning correctly with Bugzilla.
+        </para>
+        <para>
+          The <command>exit</command> command will return you to your original shell.
+        </para>
+      </section>
+    </section>
+
+    <section id="os-linux">
+      <title>Linux Distributions</title>
+            <para>Many Linux distributions include Bugzilla and its 
+            dependencies in their native package management systems. 
+            Installing Bugzilla with root access on any Linux system 
+            should be as simple as finding the Bugzilla package in the 
+            package management application and installing it using the 
+            normal command syntax. Several distributions also perform 
+            the proper web server configuration automatically on installation.
+            </para>
+            <para>Please consult the documentation of your Linux 
+            distribution for instructions on how to install packages, 
+            or for specific instructions on installing Bugzilla with 
+            native package management tools. There is also a 
+            <ulink url="http://wiki.mozilla.org/Bugzilla:Linux_Distro_Installation">
+            Bugzilla Wiki Page</ulink> for distro-specific installation
+            notes.
+            </para>
+    </section>
+  </section>
+
+
+  <section id="nonroot">
+    <title>UNIX (non-root) Installation Notes</title>
+
+    <section>
+      <title>Introduction</title>
+
+      <para>If you are running a *NIX OS as non-root, either due
+      to lack of access (web hosts, for example) or for security
+      reasons, this will detail how to install Bugzilla on such
+      a setup. It is recommended that you read through the
+      <xref linkend="installation" />
+      first to get an idea on the installation steps required.
+      (These notes will reference to steps in that guide.)</para>
+
+    </section>
+
+    <section>
+      <title>MySQL</title>
+
+      <para>You may have MySQL installed as root. If you're
+      setting up an account with a web host, a MySQL account
+      needs to be set up for you. From there, you can create
+      the bugs account, or use the account given to you.</para>
+
+      <warning>
+        <para>You may have problems trying to set up
+        <command>GRANT</command> permissions to the database.
+        If you're using a web host, chances are that you have a
+        separate database which is already locked down (or one big
+        database with limited/no access to the other areas), but you
+        may want to ask your system administrator what the security
+        settings are set to, and/or run the <command>GRANT</command>
+        command for you.</para>
+
+        <para>Also, you will probably not be able to change the MySQL
+        root user password (for obvious reasons), so skip that
+        step.</para>
+      </warning>
+
+      <section>
+        <title>Running MySQL as Non-Root</title>
+          <section>
+            <title>The Custom Configuration Method</title>
+              <para>Create a file .my.cnf in your 
+              home directory (using /home/foo in this example)
+              as follows....</para>
+              <programlisting>
+[mysqld]
+datadir=/home/foo/mymysql
+socket=/home/foo/mymysql/thesock
+port=8081
+
+[mysql]
+socket=/home/foo/mymysql/thesock
+port=8081
+
+[mysql.server]
+user=mysql
+basedir=/var/lib
+
+[safe_mysqld]
+err-log=/home/foo/mymysql/the.log
+pid-file=/home/foo/mymysql/the.pid
+              </programlisting>
+          </section>
+          <section>
+            <title>The Custom Built Method</title>
+    
+            <para>You can install MySQL as a not-root, if you really need to.
+            Build it with PREFIX set to <filename class="directory">/home/foo/mysql</filename>,
+            or use pre-installed executables, specifying that you want
+            to put all of the data files in <filename class="directory">/home/foo/mysql/data</filename>.
+            If there is another MySQL server running on the system that you
+            do not own, use the -P option to specify a TCP port that is not
+            in use.</para>
+          </section>
+    
+          <section>
+            <title>Starting the Server</title>
+            <para>After your mysqld program is built and any .my.cnf file is 
+            in place, you must initialize the databases (ONCE).</para>
+            <screen>
+<prompt>bash$</prompt> <command>mysql_install_db</command>
+            </screen>
+            <para>Then start the daemon with</para>
+            <screen>
+<prompt>bash$</prompt> <command>safe_mysql &amp;</command>
+            </screen>
+            <para>After you start mysqld the first time, you then connect to
+            it as "root" and <command>GRANT</command> permissions to other
+            users. (Again, the MySQL root account has nothing to do with
+            the *NIX root account.)</para>
+    
+            <note>
+              <para>You will need to start the daemons yourself. You can either
+              ask your system administrator to add them to system startup files, or
+              add a crontab entry that runs a script to check on these daemons
+              and restart them if needed.</para>
+            </note>
+    
+            <warning>
+              <para>Do NOT run daemons or other services on a server without first
+              consulting your system administrator! Daemons use up system resources
+              and running one may be in violation of your terms of service for any
+              machine on which you are a user!</para>
+            </warning>
+          </section>
+      </section>
+    </section>
+
+    <section>
+      <title>Perl</title>
+
+      <para>
+      On the extremely rare chance that you don't have Perl on
+      the machine, you will have to build the sources
+      yourself. The following commands should get your system
+      installed with your own personal version of Perl:
+      </para>
+
+      <screen>
+<prompt>bash$</prompt> <command>wget http://perl.org/CPAN/src/stable.tar.gz</command>
+<prompt>bash$</prompt> <command>tar zvxf stable.tar.gz</command>
+<prompt>bash$</prompt> <command>cd perl-&min-perl-ver;</command>
+<prompt>bash$</prompt> <command>sh Configure -de -Dprefix=/home/foo/perl</command>
+<prompt>bash$</prompt> <command>make &amp;&amp; make test &amp;&amp; make install</command>
+      </screen>
+
+      <para>
+      Once you have Perl installed into a directory (probably
+      in <filename class="directory">~/perl/bin</filename>), you will need to
+      install the Perl Modules, described below.
+      </para>
+    </section>
+
+    <section id="install-perlmodules-nonroot">
+      <title>Perl Modules</title>
+
+      <para>
+      Installing the Perl modules as a non-root user is accomplished by
+      running the <filename>install-module.pl</filename>
+      script. For more details on this script, see 
+      <ulink url="../html/api/install-module.html"><filename>install-module.pl</filename>
+      documentation</ulink>
+      </para>
+    </section>
+
+    <section>
+      <title>HTTP Server</title>
+
+      <para>Ideally, this also needs to be installed as root and
+      run under a special web server account. As long as
+      the web server will allow the running of *.cgi files outside of a
+      cgi-bin, and a way of denying web access to certain files (such as a
+      .htaccess file), you should be good in this department.</para>
+
+      <section>
+        <title>Running Apache as Non-Root</title>
+
+        <para>You can run Apache as a non-root user, but the port will need
+        to be set to one above 1024. If you type <command>httpd -V</command>,
+        you will get a list of the variables that your system copy of httpd
+        uses. One of those, namely HTTPD_ROOT, tells you where that
+        installation looks for its config information.</para>
+
+        <para>From there, you can copy the config files to your own home
+        directory to start editing. When you edit those and then use the -d
+        option to override the HTTPD_ROOT compiled into the web server, you
+        get control of your own customized web server.</para>
+
+        <note>
+          <para>You will need to start the daemons yourself. You can either
+          ask your system administrator to add them to system startup files, or
+          add a crontab entry that runs a script to check on these daemons
+          and restart them if needed.</para>
+        </note>
+
+        <warning>
+          <para>Do NOT run daemons or other services on a server without first
+          consulting your system administrator! Daemons use up system resources
+          and running one may be in violation of your terms of service for any
+          machine on which you are a user!</para>
+        </warning>
+      </section>
+    </section>
+
+    <section>
+      <title>Bugzilla</title>
+
+      <para>
+      When you run <command>./checksetup.pl</command> to create
+      the <filename>localconfig</filename> file, it will list the Perl
+      modules it finds. If one is missing, go back and double-check the
+      module installation from <xref linkend="install-perlmodules-nonroot"/>, 
+      then delete the <filename>localconfig</filename> file and try again.
+      </para>
+
+      <warning>
+        <para>One option in <filename>localconfig</filename> you
+        might have problems with is the web server group. If you can't
+        successfully browse to the <filename>index.cgi</filename> (like
+        a Forbidden error), you may have to relax your permissions,
+        and blank out the web server group. Of course, this may pose
+        as a security risk. Having a properly jailed shell and/or
+        limited access to shell accounts may lessen the security risk,
+        but use at your own risk.</para>
+      </warning>
+
+      <section id="suexec">
+        <title>suexec or shared hosting</title>
+
+        <para>If you are running on a system that uses suexec (most shared
+        hosting environments do this), you will need to set the
+        <emphasis>webservergroup</emphasis> value in <filename>localconfig</filename>
+        to match <emphasis>your</emphasis> primary group, rather than the one
+        the web server runs under.  You will need to run the following
+        shell commands after running <command>./checksetup.pl</command>,
+        every time you run it (or modify <filename>checksetup.pl</filename>
+        to do them for you via the system() command).
+        <programlisting>
+for i in docs graphs images js skins; do find $i -type d -exec chmod o+rx {} \; ; done
+for i in jpg gif css js png html rdf xul; do find . -name \*.$i -exec chmod o+r {} \; ; done
+find . -name .htaccess -exec chmod o+r {} \;
+chmod o+x . data data/webdot
+        </programlisting>
+        Pay particular attention to the number of semicolons and dots.
+        They are all important.  A future version of Bugzilla will
+        hopefully be able to do this for you out of the box.</para>
+      </section>
+    </section>
+  </section>
+
+
+  <section id="upgrade">
+    <title>Upgrading to New Releases</title>
+
+    <para>Upgrading to new Bugzilla releases is very simple. There is
+      a script named <filename>checksetup.pl</filename> included with
+      Bugzilla that will automatically do all of the database migration
+      for you.</para>
+
+    <para>The following sections explain how to upgrade from one
+      version of Bugzilla to another. Whether you are upgrading
+      from one bug-fix version to another (such as 4.2 to 4.2.1)
+      or from one major version to another (such as from 4.0 to 4.2),
+      the instructions are always the same.</para>
+
+    <note>
+      <para>
+        Any examples in the following sections are written as though the
+        user were updating to version 4.2.1, but the procedures are the
+        same no matter what version you're updating to. Also, in the
+        examples, the user's Bugzilla installation is found at
+        <filename>/var/www/html/bugzilla</filename>. If that is not the
+        same as the location of your Bugzilla installation, simply
+        substitute the proper paths where appropriate.
+      </para>
+    </note>
+
+    <section id="upgrade-before">
+      <title>Before You Upgrade</title>
+    
+      <para>Before you start your upgrade, there are a few important
+        steps to take:</para>
+
+      <orderedlist>
+        <listitem>
+          <para>
+            Read the <ulink url="http://www.bugzilla.org/releases/">Release
+            Notes</ulink> of the version you're upgrading to,
+            particularly the "Notes for Upgraders" section.
+          </para>
+        </listitem>
+        
+        <listitem>
+          <para>
+            View the Sanity Check (<xref linkend="sanitycheck"/>) page
+            on your installation before upgrading. Attempt to fix all warnings
+            that the page produces before you go any further, or you may
+            experience problems  during your upgrade.
+          </para>
+        </listitem>
+        
+        <listitem>
+          <para>
+            Shut down your Bugzilla installation by putting some HTML or
+            text in the shutdownhtml parameter
+            (see <xref linkend="parameters"/>).
+          </para>
+        </listitem>
+        
+        <listitem>
+          <para>
+            Make a backup of the Bugzilla database.
+            <emphasis>THIS IS VERY IMPORTANT</emphasis>. If
+            anything goes wrong during the upgrade, your installation
+            can be corrupted beyond recovery. Having a backup keeps you safe.
+          </para>
+
+          <warning>
+            <para>
+              Upgrading is a one-way process. You cannot "downgrade" an
+              upgraded Bugzilla. If you wish to revert to the old Bugzilla
+              version for any reason, you will have to restore your database
+              from this backup.
+            </para>
+          </warning>
+
+          <para>Here are some sample commands you could use to backup
+            your database, depending on what database system you're
+            using. You may have to modify these commands for your
+            particular setup.</para>
+          
+          <variablelist>
+            <varlistentry>
+              <term>MySQL:</term>
+              <listitem>
+                <para>
+                  <command>mysqldump --opt -u bugs -p bugs > bugs.sql</command>
+                </para>
+              </listitem>
+            </varlistentry>
+              
+            <varlistentry>
+              <term>PostgreSQL:</term>
+              <listitem>
+                <para>
+                  <command>pg_dump --no-privileges --no-owner -h localhost -U bugs
+                    > bugs.sql</command>
+                </para>
+              </listitem>
+            </varlistentry>
+          </variablelist>
+        </listitem>
+      </orderedlist>
+    </section>
+      
+    <section id="upgrade-files">
+      <title>Getting The New Bugzilla</title>
+      
+      <para>There are three ways to get the new version of Bugzilla.
+        We'll list them here briefly and then explain them
+        more later.</para>
+      
+      <variablelist>
+        <varlistentry>
+          <term>Bzr (<xref linkend="upgrade-bzr"/>)</term>
+          <listitem>
+            <para>
+              If you have <command>bzr</command> installed on your machine
+              and you have Internet access, this is the easiest way to
+              upgrade, particularly if you have made modifications
+              to the code or templates of Bugzilla.
+            </para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>Download the tarball (<xref linkend="upgrade-tarball"/>)</term>
+          <listitem>
+            <para>
+              This is a very simple way to upgrade, and good if you
+              haven't made many (or any) modifications to the code or
+              templates of your Bugzilla.
+            </para>
+          </listitem>
+        </varlistentry>
+        
+        <varlistentry>
+          <term>Patches (<xref linkend="upgrade-patches"/>)</term>
+          <listitem>
+            <para>
+              If you have made modifications to your Bugzilla, and
+              you don't have Internet access or you don't want to use
+              bzr, then this is the best way to upgrade.
+            </para>
+
+            <para>
+              You can only do minor upgrades (such as 4.2 to 4.2.1 or
+              4.2.1 to 4.2.2) with patches.
+            </para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+        
+      <section id="upgrade-modified">
+        <title>If you have modified your Bugzilla</title>
+      
+        <para>
+          If you have modified the code or templates of your Bugzilla,
+          then upgrading requires a bit more thought and effort.
+          A discussion of the various methods of updating compared with
+          degree and methods of local customization can be found in
+          <xref linkend="template-method"/>.
+        </para>
+
+        <para>
+          The larger the jump you are trying to make, the more difficult it
+          is going to be to upgrade if you have made local customizations.
+          Upgrading from 4.2 to 4.2.1 should be fairly painless even if
+          you are heavily customized, but going from 2.18 to 4.2 is going
+          to mean a fair bit of work re-writing your local changes to use
+          the new files, logic, templates, etc. If you have done no local
+          changes at all, however, then upgrading should be approximately
+          the same amount of work regardless of how long it has been since
+          your version was released.
+        </para>
+      </section>
+
+      <section id="upgrade-bzr">
+        <title>Upgrading using Bzr</title>
+
+        <para>
+          This requires that you have bzr installed (most Unix machines do),
+          and requires that you are able to access
+          <ulink url="http://bzr.mozilla.org/bugzilla/">bzr.mozilla.org</ulink>,
+          which may not be an option if you don't have Internet access.
+        </para>
+
+        <para>
+          The following shows the sequence of commands needed to update a
+          Bugzilla installation via Bzr, and a typical series of results.
+          These commands assume that you already have Bugzilla installed
+          using Bzr.
+        </para>
+
+        <warning>
+          <para>
+            If your installation is still using CVS, you must first convert
+            it to Bzr. A very detailed step by step documentation can be
+            found on <ulink url="https://wiki.mozilla.org/Bugzilla:Moving_From_CVS_To_Bazaar">wiki.mozilla.org</ulink>.
+          </para>
+        </warning>
+
+        <programlisting>
+bash$ <command>cd /var/www/html/bugzilla</command>
+bash$ <command>bzr switch 4.2</command> (only run this command when not yet running 4.2)
+bash$ <command>bzr up -r tag:bugzilla-4.2.1</command>
++N  extensions/MoreBugUrl/
++N  extensions/MoreBugUrl/Config.pm
++N  extensions/MoreBugUrl/Extension.pm
+...
+ M  Bugzilla/Attachment.pm
+ M  Bugzilla/Attachment/PatchReader.pm
+ M  Bugzilla/Bug.pm
+...
+All changes applied successfully.
+        </programlisting>
+
+        <caution>
+          <para>
+            If a line in the output from <command>bzr up</command> mentions
+            a conflict, then that represents a file with local changes that
+            Bzr was unable to properly merge. You need to resolve these
+            conflicts manually before Bugzilla (or at least the portion using
+            that file) will be usable.
+          </para>
+        </caution>
+      </section>
+
+      <section id="upgrade-tarball">
+        <title>Upgrading using the tarball</title>
+
+        <para>
+          If you are unable (or unwilling) to use Bzr, another option that's
+          always available is to obtain the latest tarball from the <ulink
+          url="http://www.bugzilla.org/download/">Download Page</ulink> and 
+          create a new Bugzilla installation from that.
+        </para>
+
+        <para>
+          This sequence of commands shows how to get the tarball from the
+          command-line; it is also possible to download it from the site
+          directly in a web browser. If you go that route, save the file
+          to the <filename class="directory">/var/www/html</filename>
+          directory (or its equivalent, if you use something else) and 
+          omit the first three lines of the example.
+        </para>
+
+        <programlisting>
+bash$ <command>cd /var/www/html</command>
+bash$ <command>wget http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-4.2.1.tar.gz</command>
+<emphasis>(Output omitted)</emphasis>
+bash$ <command>tar xzvf bugzilla-4.2.1.tar.gz</command>
+bugzilla-4.2.1/
+bugzilla-4.2.1/colchange.cgi
+<emphasis>(Output truncated)</emphasis>
+bash$ <command>cd bugzilla-4.2.1</command>
+bash$ <command>cp ../bugzilla/localconfig* .</command>
+bash$ <command>cp -r ../bugzilla/data .</command>
+bash$ <command>cd ..</command>
+bash$ <command>mv bugzilla bugzilla.old</command>
+bash$ <command>mv bugzilla-4.2.1 bugzilla</command>
+        </programlisting>
+
+        <warning>
+          <para>
+            The <command>cp</command> commands both end with periods which
+            is a very important detail--it means that the destination
+            directory is the current working directory.
+          </para>
+        </warning>
+
+        <caution>
+          <para>
+            If you have some extensions installed, you will have to copy them
+            to the new bugzilla directory too. Extensions are located in
+            <filename>bugzilla/extensions/</filename>. Only copy those you
+            installed, not those managed by the Bugzilla team.
+          </para>
+        </caution>
+
+        <para>
+          This upgrade method will give you a clean install of Bugzilla.
+          That's fine if you don't have any local customizations that you
+          want to maintain. If you do have customizations, then you will 
+          need to reapply them by hand to the appropriate files.
+        </para>
+      </section>
+
+      <section id="upgrade-patches">
+        <title>Upgrading using patches</title>
+
+        <para>
+          A patch is a collection of all the bug fixes that have been made
+          since the last bug-fix release.
+        </para>
+
+        <para>
+          If you are doing a bug-fix upgrade&mdash;that is, one where only the 
+          last number of the revision changes, such as from 4.2 to
+          4.2.1&mdash;then you have the option of obtaining and applying a
+          patch file from the <ulink
+          url="http://www.bugzilla.org/download/">Download Page</ulink>.
+        </para>
+
+        <para>
+          As above, this example starts with obtaining the file via the 
+          command line. If you have already downloaded it, you can omit the
+          first two commands.
+        </para>
+
+        <programlisting>
+bash$ <command>cd /var/www/html/bugzilla</command>
+bash$ <command>wget http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-4.2-to-4.2.1.diff.gz</command>
+<emphasis>(Output omitted)</emphasis>
+bash$ <command>gunzip bugzilla-4.2-to-4.2.1.diff.gz</command>
+bash$ <command>patch -p1 &lt; bugzilla-4.2-to-4.2.1.diff</command>
+patching file Bugzilla/Constants.pm
+patching file enter_bug.cgi
+<emphasis>(etc.)</emphasis>
+        </programlisting>
+
+        <warning>
+          <para>
+            Be aware that upgrading from a patch file does not change the
+            entries in your <filename class="directory">.bzr</filename> directory.
+            This could make it more difficult to upgrade using Bzr
+            (<xref linkend="upgrade-bzr"/>) in the future.
+          </para>
+        </warning>
+
+      </section>
+    </section>
+
+    <section id="upgrade-completion">
+      <title>Completing Your Upgrade</title>
+
+      <para>
+        Now that you have the new Bugzilla code, there are a few final
+        steps to complete your upgrade.
+      </para>
+      
+      <orderedlist>
+        <listitem>
+          <para>
+            If your new Bugzilla installation is in a different
+            directory or on a different machine than your old Bugzilla
+            installation, make sure that you have copied the
+            <filename>data</filename> directory and the
+            <filename>localconfig</filename> file from your old Bugzilla
+            installation. (If you followed the tarball instructions
+            above, this has already happened.)
+          </para>
+        </listitem>
+        
+        <listitem>
+          <para>
+            If this is a major update, check that the configuration
+            (<xref linkend="configuration"/>) for your new Bugzilla is
+            up-to-date. Sometimes the configuration requirements change
+            between major versions.
+          </para>
+        </listitem>
+        
+        <listitem>
+          <para>
+            If you didn't do it as part of the above configuration step,
+            now you need to run <command>checksetup.pl</command>, which
+            will do everything required to convert your existing database
+            and settings for the new version:
+          </para>
+
+          <programlisting>
+bash$ <command>cd /var/www/html/bugzilla</command>
+bash$ <command>./checksetup.pl</command>
+          </programlisting>
+
+          <warning>
+            <para>
+              The period at the beginning of the command
+              <command>./checksetup.pl</command> is important and cannot
+              be omitted.
+            </para>
+          </warning>
+          
+          <caution>
+            <para>
+              If this is a major upgrade (say, 3.6 to 4.2 or similar),
+              running <command>checksetup.pl</command> on a large
+              installation (75,000 or more bugs) can take a long time,
+              possibly several hours.
+            </para>
+          </caution>
+        </listitem>
+
+        <listitem>
+          <para>
+            Clear any HTML or text that you put into the shutdownhtml
+            parameter, to re-activate Bugzilla.
+          </para> 
+        </listitem>
+
+        <listitem>
+          <para>
+            View the Sanity Check (<xref linkend="sanitycheck"/>) page in your
+            upgraded Bugzilla.
+          </para>
+          <para>
+            It is recommended that, if possible, you fix any problems
+            you see, immediately. Failure to do this may mean that Bugzilla
+            will not work correctly. Be aware that if the sanity check page
+            contains more errors after an upgrade, it doesn't necessarily
+            mean there are more errors in your database than there were
+            before, as additional tests are added to the sanity check over
+            time, and it is possible that those errors weren't being
+            checked for in the old version.
+          </para>
+        </listitem>
+      </orderedlist>
+
+    </section>
+    
+    <section id="upgrade-notifications">
+      <title>Automatic Notifications of New Releases</title>
+
+      <para>
+        Bugzilla 3.0 introduced the ability to automatically notify
+        administrators when new releases are available, based on the
+        <literal>upgrade_notification</literal> parameter, see
+        <xref linkend="parameters"/>. Administrators will see these
+        notifications when they access the <filename>index.cgi</filename>
+        page, i.e. generally when logging in. Bugzilla will check once per
+        day for new releases, unless the parameter is set to
+        <quote>disabled</quote>. If you are behind a proxy, you may have to set
+        the <literal>proxy_url</literal> parameter accordingly. If the proxy
+        requires authentication, use the
+        <literal>http://user:pass@proxy_url/</literal> syntax.
+      </para>
+    </section>
+  </section>
+
+</chapter>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-always-quote-attributes:t
+sgml-auto-insert-required-elements:t
+sgml-balanced-tag-edit:t
+sgml-exposed-tags:nil
+sgml-general-insert-case:lower
+sgml-indent-data:t
+sgml-indent-step:2
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+sgml-minimize-attributes:nil
+sgml-namecase-general:t
+sgml-omittag:t
+sgml-parent-document:("Bugzilla-Guide.xml" "book" "chapter")
+sgml-shorttag:t
+sgml-tag-region-if-active:t
+End:
+-->

diff --git a/docs/en/xml/modules.xml b/docs/en/xml/modules.xml
new file mode 100644 (file)
index 0000000..2e7a651
--- /dev/null
+++ b/docs/en/xml/modules.xml
@@ -0,0 +1,188 @@
+<?xml version="1.0"?>
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                      "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+    <!ENTITY % myents SYSTEM "bugzilla.ent">
+    %myents;
+]>
+
+<appendix id="install-perlmodules-manual">
+  <title>Manual Installation of Perl Modules</title>
+  
+  <section id="modules-manual-instructions">
+    <title>Instructions</title>
+    <para>
+      If you need to install Perl modules manually, here's how it's done.
+      Download the module using the link given in the next section, and then
+      apply this magic incantation, as root:
+    </para>
+
+    <para>  
+      <screen><prompt>bash#</prompt> tar -xzvf &lt;module&gt;.tar.gz
+<prompt>bash#</prompt> cd &lt;module&gt;
+<prompt>bash#</prompt> perl Makefile.PL
+<prompt>bash#</prompt> make
+<prompt>bash#</prompt> make test
+<prompt>bash#</prompt> make install</screen>
+    </para>
+    <note>
+      <para>
+        In order to compile source code under Windows you will need to obtain
+        a 'make' utility.  The <command>nmake</command> utility provided with
+        Microsoft Visual C++ may be used.  As an alternative, there is a
+        utility called <command>dmake</command> available from CPAN which is
+        written entirely in Perl.
+      </para>
+      <para>
+        As described in <xref linkend="modules-manual-download" />, however, most
+        packages already exist and are available from ActiveState or theory58S.
+        We highly recommend that you install them using the ppm GUI available with
+        ActiveState and to add the theory58S repository to your list of repositories.
+      </para>
+    </note>
+  </section>
+    
+  <section id="modules-manual-download">
+    <title>Download Locations</title>
+    
+    <note>
+      <para>
+        Running Bugzilla on Windows requires the use of ActiveState
+        Perl 5.8.1 or higher. Many modules already exist in the core
+        distribution of ActiveState Perl. If some modules are missing, upgrade
+        ActiveState Perl to at least 5.12; it has all the required modules.
+      </para>
+    </note>
+
+    <para>
+      CGI:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/CGI.pm/"/>
+        Documentation: <ulink url="http://perldoc.perl.org/CGI.html"/>
+      </literallayout>
+    </para>
+
+    <para>
+      Data-Dumper:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/Data-Dumper/"/>
+        Documentation: <ulink url="http://search.cpan.org/dist/Data-Dumper/Dumper.pm"/>
+      </literallayout>
+    </para>
+    
+    <para>
+      Date::Format (part of TimeDate):
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/TimeDate/"/>
+        Documentation: <ulink url="http://search.cpan.org/dist/TimeDate/lib/Date/Format.pm"/>
+      </literallayout>
+    </para>
+
+    <para>
+      DBI:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/DBI/"/>
+        Documentation: <ulink url="http://dbi.perl.org/docs/"/>
+      </literallayout>
+    </para>
+
+    <para>
+      DBD::mysql:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/DBD-mysql/"/>
+        Documentation: <ulink url="http://search.cpan.org/dist/DBD-mysql/lib/DBD/mysql.pm"/>
+      </literallayout>
+    </para>
+
+    <para>
+      DBD::Pg:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/DBD-Pg/"/>
+        Documentation: <ulink url="http://search.cpan.org/dist/DBD-Pg/Pg.pm"/>
+      </literallayout>
+    </para>
+
+    <para>
+      Template-Toolkit:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/Template-Toolkit/"/>
+        Documentation: <ulink url="http://www.template-toolkit.org/docs.html"/>
+      </literallayout>
+    </para>
+
+    <para>
+      GD:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/GD/"/>
+        Documentation: <ulink url="http://search.cpan.org/dist/GD/GD.pm"/>
+      </literallayout>
+    </para>
+
+    <para>
+      Template::Plugin::GD:
+      <literallayout>
+       CPAN Download Page: <ulink url="http://search.cpan.org/dist/Template-GD/" />
+       Documentation: <ulink url="http://www.template-toolkit.org/docs/aqua/Modules/index.html" />
+      </literallayout>
+    </para>
+
+    <para>
+      MIME::Parser (part of MIME-tools):
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/MIME-tools/"/>
+        Documentation: <ulink url="http://search.cpan.org/dist/MIME-tools/lib/MIME/Parser.pm"/>
+      </literallayout>
+    </para>
+
+  </section>
+
+  <section id="modules-manual-optional">
+    <title>Optional Modules</title>
+
+    <para>
+      Chart::Lines:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/Chart/"/>
+        Documentation: <ulink url="http://search.cpan.org/dist/Chart/Chart.pod"/>
+      </literallayout>
+    </para>
+
+     <para>
+      GD::Graph:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/GDGraph/"/>
+        Documentation: <ulink url="http://search.cpan.org/dist/GDGraph/Graph.pm"/>
+      </literallayout>
+    </para>
+
+    <para>
+      GD::Text::Align (part of GD::Text::Util):
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/GDTextUtil/"/>
+        Documentation: <ulink url="http://search.cpan.org/dist/GDTextUtil/Text/Align.pm"/>
+      </literallayout>
+    </para>
+
+   <para>
+      XML::Twig:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/XML-Twig/"/>
+        Documentation: <ulink url="http://standards.ieee.org/resources/spasystem/twig/twig_stable.html"/>
+      </literallayout>
+    </para>
+
+    <para>
+      PatchReader:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/author/JKEISER/PatchReader/"/>
+        Documentation: <ulink url="http://www.johnkeiser.com/mozilla/Patch_Viewer.html"/>
+      </literallayout>
+    </para>
+   </section>
+</appendix>

diff --git a/docs/en/xml/patches.xml b/docs/en/xml/patches.xml
new file mode 100644 (file)
index 0000000..ed7d304
--- /dev/null
+++ b/docs/en/xml/patches.xml
@@ -0,0 +1,143 @@
+<?xml version="1.0"?>
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                      "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+    <!ENTITY % myents SYSTEM "bugzilla.ent">
+    %myents;
+]>
+
+<appendix id="patches" xreflabel="Useful Patches and Utilities for Bugzilla">
+  <title>Contrib</title>
+
+  <para>
+    There are a number of unofficial Bugzilla add-ons in the 
+    <filename class="directory">$BUGZILLA_ROOT/contrib/</filename>
+    directory. This section documents them.
+  </para>
+
+  <section id="cmdline">
+    <title>Command-line Search Interface</title>
+
+    <para>
+      There are a suite of Unix utilities for searching Bugzilla from the 
+      command line. They live in the 
+      <filename class="directory">contrib/cmdline</filename> directory.
+      There are three files - <filename>query.conf</filename>,
+      <filename>buglist</filename> and <filename>bugs</filename>.
+    </para>
+
+    <warning>
+      <para>
+        These files pre-date the templatization work done as part of the
+        2.16 release, and have not been updated.
+      </para>
+    </warning>
+    
+    <para>
+      <filename>query.conf</filename> contains the mapping from
+      options to field names and comparison types. Quoted option names
+      are <quote>grepped</quote> for, so it should be easy to edit this
+      file. Comments (#) have no effect; you must make sure these lines
+      do not contain any quoted <quote>option</quote>.
+    </para>
+
+    <para>
+      <filename>buglist</filename> is a shell script that submits a
+      Bugzilla query and writes the resulting HTML page to stdout.
+      It supports both short options, (such as <quote>-Afoo</quote>
+      or <quote>-Rbar</quote>) and long options (such
+      as <quote>--assignedto=foo</quote> or <quote>--reporter=bar</quote>).
+      If the first character of an option is not <quote>-</quote>, it is
+      treated as if it were prefixed with <quote>--default=</quote>.
+    </para>
+
+    <para>
+      The column list is taken from the COLUMNLIST environment variable.
+      This is equivalent to the <quote>Change Columns</quote> option
+      that is available when you list bugs in buglist.cgi. If you have
+      already used Bugzilla, grep for COLUMNLIST in your cookies file
+      to see your current COLUMNLIST setting.
+    </para>
+
+    <para>
+      <filename>bugs</filename> is a simple shell script which calls
+      <filename>buglist</filename> and extracts the
+      bug numbers from the output. Adding the prefix
+      <quote>http://bugzilla.mozilla.org/buglist.cgi?bug_id=</quote>
+      turns the bug list into a working link if any bugs are found.
+      Counting bugs is easy. Pipe the results through 
+      <command>sed -e 's/,/ /g' | wc | awk '{printf $2 "\n"}'</command>
+    </para>
+
+    <para>
+      Akkana Peck says she has good results piping 
+      <filename>buglist</filename> output through 
+      <command>w3m -T text/html -dump</command>
+    </para>
+
+  </section>
+
+  <section id="cmdline-bugmail">
+    <title>Command-line 'Send Unsent Bug-mail' tool</title>
+
+    <para>
+      Within the <filename class="directory">contrib</filename> directory
+      exists a utility with the descriptive (if compact) name
+      of <filename>sendunsentbugmail.pl</filename>. The purpose of this
+      script is, simply, to send out any bug-related mail that should
+      have been sent by now, but for one reason or another has not.
+    </para>
+
+    <para>
+      To accomplish this task, <filename>sendunsentbugmail.pl</filename> uses
+      the same mechanism as the <filename>sanitycheck.cgi</filename> script;
+      it scans through the entire database looking for bugs with changes that
+      were made more than 30 minutes ago, but where there is no record of
+      anyone related to that bug having been sent mail. Having compiled a list,
+      it then uses the standard rules to determine who gets mail, and sends it
+      out.
+    </para>
+
+    <para>
+      As the script runs, it indicates the bug for which it is currently
+      sending mail; when it has finished, it gives a numerical count of how
+      many mails were sent and how many people were excluded. (Individual
+      user names are not recorded or displayed.) If the script produces
+      no output, that means no unsent mail was detected.
+    </para>
+
+    <para>
+      <emphasis>Usage</emphasis>: move the sendunsentbugmail.pl script
+      up into the main directory, ensure it has execute permission, and run it
+      from the command line (or from a cron job) with no parameters.
+    </para>
+  </section>
+
+</appendix>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-always-quote-attributes:t
+sgml-auto-insert-required-elements:t
+sgml-balanced-tag-edit:t
+sgml-exposed-tags:nil
+sgml-general-insert-case:lower
+sgml-indent-data:t
+sgml-indent-step:2
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+sgml-minimize-attributes:nil
+sgml-namecase-general:t
+sgml-omittag:t
+sgml-parent-document:("Bugzilla-Guide.xml" "book" "chapter")
+sgml-shorttag:t
+sgml-tag-region-if-active:t
+End:
+-->

diff --git a/docs/en/xml/security.xml b/docs/en/xml/security.xml
new file mode 100644 (file)
index 0000000..5826040
--- /dev/null
+++ b/docs/en/xml/security.xml
@@ -0,0 +1,281 @@
+<?xml version="1.0"?>
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                      "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+    <!ENTITY % myents SYSTEM "bugzilla.ent">
+    %myents;
+]>
+
+<chapter id="security">
+<title>Bugzilla Security</title>
+
+  <para>While some of the items in this chapter are related to the operating
+  system Bugzilla is running on or some of the support software required to
+  run Bugzilla, it is all related to protecting your data. This is not
+  intended to be a comprehensive guide to securing Linux, Apache, MySQL, or
+  any other piece of software mentioned. There is no substitute for active
+  administration and monitoring of a machine. The key to good security is
+  actually right in the middle of the word: <emphasis>U R It</emphasis>.
+  </para>
+  
+  <para>While programmers in general always strive to write secure code,
+  accidents can and do happen. The best approach to security is to always
+  assume that the program you are working with isn't 100% secure and restrict
+  its access to other parts of your machine as much as possible.
+  </para>
+ 
+  <section id="security-os">
+  <title>Operating System</title>
+  
+    <section id="security-os-ports">
+    <title>TCP/IP Ports</title>
+    
+      <!-- TODO: Get exact number of ports -->
+      <para>The TCP/IP standard defines more than 65,000 ports for sending
+      and receiving traffic. Of those, Bugzilla needs exactly one to operate
+      (different configurations and options may require up to 3). You should
+      audit your server and make sure that you aren't listening on any ports
+      you don't need to be. It's also highly recommended that the server
+      Bugzilla resides on, along with any other machines you administer, be
+      placed behind some kind of firewall.
+      </para>
+    
+    </section>
+    
+    <section id="security-os-accounts">
+    <title>System User Accounts</title>
+    
+      <para>Many <glossterm linkend="gloss-daemon">daemons</glossterm>, such
+      as Apache's <filename>httpd</filename> or MySQL's
+      <filename>mysqld</filename>, run as either <quote>root</quote> or
+      <quote>nobody</quote>. This is even worse on Windows machines where the
+      majority of <glossterm linkend="gloss-service">services</glossterm>
+      run as <quote>SYSTEM</quote>. While running as <quote>root</quote> or
+      <quote>SYSTEM</quote> introduces obvious security concerns, the
+      problems introduced by running everything as <quote>nobody</quote> may
+      not be so obvious. Basically, if you run every daemon as
+      <quote>nobody</quote> and one of them gets compromised it can
+      compromise every other daemon running as <quote>nobody</quote> on your
+      machine. For this reason, it is recommended that you create a user
+      account for each daemon.
+      </para>
+    
+      <note>
+        <para>You will need to set the <option>webservergroup</option> option
+        in <filename>localconfig</filename> to the group your web server runs
+        as. This will allow <filename>./checksetup.pl</filename> to set file
+        permissions on Unix systems so that nothing is world-writable.
+        </para>
+      </note>
+    
+    </section>
+    
+    <section id="security-os-chroot">
+    <title>The <filename>chroot</filename> Jail</title>
+    
+      <para>
+        If your system supports it, you may wish to consider running
+        Bugzilla inside of a <filename>chroot</filename> jail. This option
+        provides unprecedented security by restricting anything running
+        inside the jail from accessing any information outside of it. If you
+        wish to use this option, please consult the documentation that came
+        with your system.
+      </para>
+      
+    </section>
+  
+  </section>
+
+  <section id="security-webserver">
+  <title>Web server</title>
+
+    <section id="security-webserver-access">
+    <title>Disabling Remote Access to Bugzilla Configuration Files</title>
+    
+      <para>
+        There are many files that are placed in the Bugzilla directory
+        area that should not be accessible from the web server. Because of the way
+        Bugzilla is currently layed out, the list of what should and should not
+        be accessible is rather complicated. A quick way is to run
+        <filename>testserver.pl</filename> to check if your web server serves
+        Bugzilla files as expected. If not, you may want to follow the few
+        steps below.
+      </para>
+      
+      <tip>
+        <para>Bugzilla ships with the ability to create
+        <glossterm linkend="gloss-htaccess"><filename>.htaccess</filename></glossterm>
+        files that enforce these rules. Instructions for enabling these
+        directives in Apache can be found in <xref linkend="http-apache"/>
+        </para>
+      </tip>
+        
+      <itemizedlist spacing="compact">
+        <listitem>
+          <para>In the main Bugzilla directory, you should:</para>
+          <itemizedlist spacing="compact">
+            <listitem>
+              <para>Block:
+              <simplelist type="inline">
+                <member><filename>*.pl</filename></member>
+                <member><filename>*localconfig*</filename></member>
+              </simplelist>
+              </para>
+            </listitem>
+          </itemizedlist>
+        </listitem>
+
+        <listitem>
+          <para>In <filename class="directory">data</filename>:</para>
+          <itemizedlist spacing="compact">
+            <listitem>
+              <para>Block everything</para>
+            </listitem>
+          </itemizedlist>
+        </listitem>
+
+        <listitem>
+          <para>In <filename class="directory">data/webdot</filename>:</para>
+          <itemizedlist spacing="compact">
+            <listitem>
+              <para>If you use a remote webdot server:</para>
+              <itemizedlist spacing="compact">
+                <listitem>
+                  <para>Block everything</para>
+                </listitem>
+                <listitem>
+                  <para>But allow
+                  <simplelist type="inline">
+                    <member><filename>*.dot</filename></member>
+                  </simplelist>
+                  only for the remote webdot server</para>
+                </listitem>
+              </itemizedlist>
+            </listitem>
+            <listitem>
+              <para>Otherwise, if you use a local GraphViz:</para>
+              <itemizedlist spacing="compact">
+                <listitem>
+                  <para>Block everything</para>
+                </listitem>
+                <listitem>
+                  <para>But allow:
+                  <simplelist type="inline">
+                    <member><filename>*.png</filename></member>
+                    <member><filename>*.gif</filename></member>
+                    <member><filename>*.jpg</filename></member>
+                    <member><filename>*.map</filename></member>
+                  </simplelist>
+                  </para>
+                </listitem>
+              </itemizedlist>
+            </listitem>
+            <listitem>
+              <para>And if you don't use any dot:</para>
+              <itemizedlist spacing="compact">
+                <listitem>
+                  <para>Block everything</para>
+                </listitem>
+              </itemizedlist>
+            </listitem>
+          </itemizedlist>
+        </listitem>
+
+        <listitem>
+          <para>In <filename class="directory">Bugzilla</filename>:</para>
+          <itemizedlist spacing="compact">
+            <listitem>
+              <para>Block everything</para>
+            </listitem>
+          </itemizedlist>
+        </listitem>
+
+        <listitem>
+          <para>In <filename class="directory">template</filename>:</para>
+          <itemizedlist spacing="compact">
+            <listitem>
+              <para>Block everything</para>
+            </listitem>
+          </itemizedlist>
+        </listitem>
+      </itemizedlist>
+
+      <para>Be sure to test that data that should not be accessed remotely is
+      properly blocked. Of particular interest is the localconfig file which
+      contains your database password. Also, be aware that many editors
+      create temporary and backup files in the working directory and that
+      those should also not be accessible. For more information, see
+      <ulink url="http://bugzilla.mozilla.org/show_bug.cgi?id=186383">bug 186383</ulink>
+      or
+      <ulink url="http://online.securityfocus.com/bid/6501">Bugtraq ID 6501</ulink>.
+      To test, simply run <filename>testserver.pl</filename>, as said above.
+      </para>
+      
+      <tip>
+        <para>Be sure to check <xref linkend="http"/> for instructions
+        specific to the web server you use.
+        </para>
+      </tip>
+    
+    </section>
+
+      
+  </section>
+  
+  
+  <section id="security-bugzilla">
+  <title>Bugzilla</title>
+
+    <section id="security-bugzilla-charset">
+    <title>Prevent users injecting malicious Javascript</title>
+
+      <para>If you installed Bugzilla version 2.22 or later from scratch,
+      then the <emphasis>utf8</emphasis> parameter is switched on by default.
+      This makes Bugzilla explicitly set the character encoding, following
+      <ulink
+      url="http://www.cert.org/tech_tips/malicious_code_mitigation.html#3">a
+      CERT advisory</ulink> recommending exactly this.
+      The following therefore does not apply to you; just keep
+      <emphasis>utf8</emphasis> turned on.
+      </para>
+
+      <para>If you've upgraded from an older version, then it may be possible
+      for a Bugzilla user to take advantage of character set encoding
+      ambiguities to inject HTML into Bugzilla comments.
+      This could include malicious scripts. 
+      This is because due to internationalization concerns, we are unable to
+      turn the <emphasis>utf8</emphasis> parameter on by default for upgraded
+      installations.
+      Turning it on manually will prevent this problem.
+      </para>
+    </section>    
+    
+  </section>
+
+</chapter> 
+
+<!-- Keep this comment at the end of the file 
+Local variables: 
+mode: sgml 
+sgml-always-quote-attributes:t
+sgml-auto-insert-required-elements:t
+sgml-balanced-tag-edit:t
+sgml-exposed-tags:nil
+sgml-general-insert-case:lower
+sgml-indent-data:t 
+sgml-indent-step:2 
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil 
+sgml-minimize-attributes:nil
+sgml-namecase-general:t 
+sgml-omittag:t
+sgml-parent-document:("Bugzilla-Guide.xml" "book" "chapter")
+sgml-shorttag:t 
+sgml-tag-region-if-active:t 
+End: -->

diff --git a/docs/en/xml/troubleshooting.xml b/docs/en/xml/troubleshooting.xml
new file mode 100644 (file)
index 0000000..7dcf752
--- /dev/null
+++ b/docs/en/xml/troubleshooting.xml
@@ -0,0 +1,287 @@
+<?xml version="1.0"?>
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                      "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+    <!ENTITY % myents SYSTEM "bugzilla.ent">
+    %myents;
+]>
+
+<appendix id="troubleshooting">
+<title>Troubleshooting</title>
+
+  <para>This section gives solutions to common Bugzilla installation
+  problems. If none of the section headings seems to match your
+  problem, read the general advice.
+  </para>
+    
+  <section id="general-advice">
+  <title>General Advice</title>
+    <para>If you can't get <filename>checksetup.pl</filename> to run to 
+    completion, it normally explains what's wrong and how to fix it.
+    If you can't work it out, or if it's being uncommunicative, post 
+    the errors in the 
+    <ulink url="news://news.mozilla.org/mozilla.support.bugzilla">mozilla.support.bugzilla</ulink>
+    newsgroup.
+    </para>
+
+    <para>If you have made it all the way through
+    <xref linkend="installation"/> (Installation) and
+    <xref linkend="configuration"/> (Configuration) but accessing the Bugzilla
+    URL doesn't work, the first thing to do is to check your web server error
+    log. For Apache, this is often located at
+    <filename>/etc/logs/httpd/error_log</filename>. The error messages
+    you see may be self-explanatory enough to enable you to diagnose and
+    fix the problem. If not, see below for some commonly-encountered 
+    errors. If that doesn't help, post the errors to the newsgroup.
+    </para>
+
+    <para>
+      Bugzilla can also log all user-based errors (and many code-based errors)
+      that occur, without polluting the web server's error log.  To enable
+      Bugzilla error logging, create a file that Bugzilla can write to, named
+      <filename>errorlog</filename>, in the Bugzilla <filename>data</filename>
+      directory.  Errors will be logged as they occur, and will include the type
+      of the error, the IP address and username (if available) of the user who
+      triggered the error, and the values of all environment variables; if a
+      form was being submitted, the data in the form will also be included.
+      To disable error logging, delete or rename the
+      <filename>errorlog</filename> file.
+    </para>
+  </section>
+        
+  <section id="trbl-testserver">
+  <title>The Apache web server is not serving Bugzilla pages</title>
+    <para>After you have run <command>checksetup.pl</command> twice,
+    run <command>testserver.pl http://yoursite.yourdomain/yoururl</command>
+    to confirm that your web server is configured properly for
+    Bugzilla.
+    </para>
+    <programlisting>
+<prompt>bash$</prompt> ./testserver.pl http://landfill.bugzilla.org/bugzilla-tip
+TEST-OK Webserver is running under group id in $webservergroup.
+TEST-OK Got ant picture.
+TEST-OK Webserver is executing CGIs.
+TEST-OK Webserver is preventing fetch of http://landfill.bugzilla.org/bugzilla-tip/localconfig.
+</programlisting>
+  </section>
+
+  <section id="trbl-perlmodule">
+  <title>I installed a Perl module, but 
+      <filename>checksetup.pl</filename> claims it's not installed!</title>
+      
+    <para>This could be caused by one of two things:</para>
+    <orderedlist>
+      <listitem>
+        <para>You have two versions of Perl on your machine. You are installing
+        modules into one, and Bugzilla is using the other. Rerun the CPAN
+        commands (or manual compile) using the full path to Perl from the 
+        top of <filename>checksetup.pl</filename>. This will make sure you 
+        are installing the modules in the right place.
+        </para>
+      </listitem>
+      <listitem>
+        <para>The permissions on your library directories are set incorrectly.
+        They must, at the very least, be readable by the web server user or
+        group. It is recommended that they be world readable.
+        </para>
+      </listitem>
+    </orderedlist>
+  </section>
+
+  <section id="trbl-dbdSponge">
+  <title>DBD::Sponge::db prepare failed</title>
+      
+    <para>The following error message may appear due to a bug in DBD::mysql
+    (over which the Bugzilla team have no control):
+    </para>
+      
+<programlisting><![CDATA[ DBD::Sponge::db prepare failed: Cannot determine NUM_OF_FIELDS at D:/Perl/site/lib/DBD/mysql.pm line 248.
+  SV = NULL(0x0) at 0x20fc444
+  REFCNT = 1
+  FLAGS = (PADBUSY,PADMY)
+]]></programlisting>
+
+    <para>To fix this, go to 
+    <filename>&lt;path-to-perl&gt;/lib/DBD/sponge.pm</filename> 
+    in your Perl installation and replace
+    </para>
+        
+<programlisting><![CDATA[ my $numFields;
+ if ($attribs->{'NUM_OF_FIELDS'}) {
+     $numFields = $attribs->{'NUM_OF_FIELDS'};
+ } elsif ($attribs->{'NAME'}) {
+     $numFields = @{$attribs->{NAME}};
+]]></programlisting>
+
+    <para>with</para>
+
+<programlisting><![CDATA[ my $numFields;
+ if ($attribs->{'NUM_OF_FIELDS'}) {
+     $numFields = $attribs->{'NUM_OF_FIELDS'};
+ } elsif ($attribs->{'NAMES'}) {
+     $numFields = @{$attribs->{NAMES}};
+]]></programlisting>
+
+     <para>(note the S added to NAME.)</para>
+  </section>
+    
+  <section id="paranoid-security">
+  <title>cannot chdir(/var/spool/mqueue)</title>
+
+    <para>If you are installing Bugzilla on SuSE Linux, or some other
+    distributions with <quote>paranoid</quote> security options, it is
+    possible that the checksetup.pl script may fail with the error: 
+<programlisting><![CDATA[cannot chdir(/var/spool/mqueue): Permission denied
+]]></programlisting>
+    </para>
+      
+    <para>This is because your <filename>/var/spool/mqueue</filename>
+    directory has a mode of <computeroutput>drwx------</computeroutput>.
+    Type <command>chmod 755 <filename>/var/spool/mqueue</filename></command>
+    as root to fix this problem. This will allow any process running on your
+    machine the ability to <emphasis>read</emphasis> the
+    <filename>/var/spool/mqueue</filename> directory.
+    </para>
+  </section>    
+
+  <section id="trbl-relogin-everyone">
+  <title>Everybody is constantly being forced to relogin</title>
+  
+  <para>The most-likely cause is that the <quote>cookiepath</quote> parameter
+  is not set correctly in the Bugzilla configuration.  You can change this (if
+  you're a Bugzilla administrator) from the editparams.cgi page via the web interface.
+  </para>
+
+  <para>The value of the cookiepath parameter should be the actual directory
+  containing your Bugzilla installation, <emphasis>as seen by the end-user's
+  web browser</emphasis>. Leading and trailing slashes are mandatory. You can
+  also set the cookiepath to any directory which is a parent of the Bugzilla
+  directory (such as '/', the root directory). But you can't put something
+  that isn't at least a partial match or it won't work. What you're actually
+  doing is restricting the end-user's browser to sending the cookies back only
+  to that directory.
+  </para>
+
+  <para>How do you know if you want your specific Bugzilla directory or the
+  whole site?
+  </para>
+
+  <para>If you have only one Bugzilla running on the server, and you don't
+  mind having other applications on the same server with it being able to see
+  the cookies (you might be doing this on purpose if you have other things on
+  your site that share authentication with Bugzilla), then you'll want to have
+  the cookiepath set to "/", or to a sufficiently-high enough directory that
+  all of the involved apps can see the cookies.
+  </para>
+
+  <example id="trbl-relogin-everyone-share">
+  <title>Examples of urlbase/cookiepath pairs for sharing login cookies</title>
+
+    <blockquote>
+      <literallayout>
+urlbase is http://bugzilla.mozilla.org/
+cookiepath is /
+
+urlbase is http://tools.mysite.tld/bugzilla/
+        but you have http://tools.mysite.tld/someotherapp/ which shares
+        authentication with your Bugzilla
+cookiepath is /
+      </literallayout>
+    </blockquote>
+  </example>
+
+   <para>On the other hand, if you have more than one Bugzilla running on the
+   server (some people do - we do on landfill) then you need to have the
+   cookiepath restricted enough so that the different Bugzillas don't
+   confuse their cookies with one another.
+   </para>
+
+
+   <example id="trbl-relogin-everyone-restrict">
+   <title>Examples of urlbase/cookiepath pairs to restrict the login cookie</title>
+      <blockquote>
+        <literallayout>
+urlbase is http://landfill.bugzilla.org/bugzilla-tip/
+cookiepath is /bugzilla-tip/
+
+urlbase is http://landfill.bugzilla.org/bugzilla-4.0-branch/
+cookiepath is /bugzilla-4.0-branch/
+        </literallayout>
+      </blockquote>
+    </example>
+
+    <para>If you had cookiepath set to <quote>/</quote> at any point in the
+    past and need to set it to something more restrictive
+    (i.e. <quote>/bugzilla/</quote>), you can safely do this without
+    requiring users to delete their Bugzilla-related cookies in their
+    browser (this is true starting with Bugzilla 2.18 and Bugzilla 2.16.5).
+    </para>
+  </section>
+
+  <section id="trbl-index">
+  <title><filename>index.cgi</filename> doesn't show up unless specified in the URL</title>
+    <para>
+      You probably need to set up your web server in such a way that it
+      will serve the index.cgi page as an index page.
+    </para>
+    <para>
+      If you are using Apache, you can do this by adding 
+      <filename>index.cgi</filename> to the end of the 
+      <computeroutput>DirectoryIndex</computeroutput> line
+      as mentioned in <xref linkend="http-apache"/>.
+    </para>
+
+  </section>
+
+  <section id="trbl-passwd-encryption">
+    <title>
+      checksetup.pl reports "Client does not support authentication protocol
+      requested by server..."
+    </title>
+
+    <para>
+      This error is occurring because you are using the new password
+      encryption that comes with MySQL 4.1, while your
+      <filename>DBD::mysql</filename> module was compiled against an
+      older version of MySQL. If you recompile <filename>DBD::mysql</filename>
+      against the current MySQL libraries (or just obtain a newer version
+      of this module) then the error may go away.
+    </para>
+
+    <para>
+      If that does not fix the problem, or if you cannot recompile the
+      existing module (e.g. you're running Windows) and/or don't want to
+      replace it (e.g. you want to keep using a packaged version), then a
+      workaround is available from the MySQL docs:
+      <ulink url="http://dev.mysql.com/doc/mysql/en/Old_client.html"/>
+    </para>
+
+  </section>
+
+</appendix> 
+
+<!-- Keep this comment at the end of the file 
+Local variables: 
+mode: sgml 
+sgml-always-quote-attributes:t
+sgml-auto-insert-required-elements:t
+sgml-balanced-tag-edit:t
+sgml-exposed-tags:nil
+sgml-general-insert-case:lower
+sgml-indent-data:t 
+sgml-indent-step:2 
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil 
+sgml-minimize-attributes:nil
+sgml-namecase-general:t 
+sgml-omittag:t
+sgml-parent-document:("Bugzilla-Guide.xml" "book" "chapter")
+sgml-shorttag:t 
+sgml-tag-region-if-active:t 
+End: -->

diff --git a/docs/en/xml/using.xml b/docs/en/xml/using.xml
new file mode 100644 (file)
index 0000000..f91695c
--- /dev/null
+++ b/docs/en/xml/using.xml
@@ -0,0 +1,2077 @@
+<?xml version="1.0"?>
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                      "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+    <!ENTITY % myents SYSTEM "bugzilla.ent">
+    %myents;
+]>
+
+<chapter id="using">
+  <title>Using Bugzilla</title>
+
+  <section id="using-intro">
+    <title>Introduction</title>
+    <para>This section contains information for end-users of Bugzilla.  There
+    is a Bugzilla test installation, called
+    <ulink url="http://landfill.bugzilla.org/">Landfill</ulink>, which you are
+    welcome to play with (if it's up). However, not all of the Bugzilla
+    installations there will necessarily have all Bugzilla features enabled,
+    and different installations run different versions, so some things may not
+    quite work as this document describes.</para>
+
+    <para>
+      Frequently Asked Questions (FAQ) are available and answered on
+      <ulink url="http://wiki.mozilla.org/Bugzilla:FAQ">wiki.mozilla.org</ulink>.
+      They may cover some questions you have which are left unanswered.
+    </para>
+  </section>
+      
+  <section id="myaccount">
+    <title>Create a Bugzilla Account</title>
+
+    <para>If you want to use Bugzilla, first you need to create an account.
+    Consult with the administrator responsible for your installation of
+    Bugzilla for the URL you should use to access it. If you're
+    test-driving Bugzilla, use this URL: 
+    <ulink url="&landfillbase;"/>.
+    </para>
+
+    <orderedlist>
+      <listitem>
+        <para>
+          On the home page <filename>index.cgi</filename>, click the
+          <quote>Open a new Bugzilla account</quote> link, or the
+          <quote>New Account</quote> link available in the footer of pages.
+          Now enter your email address, then click the <quote>Send</quote>
+          button.
+        </para>
+
+        <note>
+          <para>
+            If none of these links is available, this means that the
+            administrator of the installation has disabled self-registration.
+            This means that only an administrator can create accounts
+            for other users. One reason could be that this installation is
+            private.
+          </para>
+        </note>
+
+        <note>
+          <para>
+            Also, if only some users are allowed to create an account on
+            the installation, you may see these links but your registration
+            may fail if your email address doesn't match the ones accepted
+            by the installation. This is another way to restrict who can
+            access and edit bugs in this installation.
+          </para>
+        </note>
+      </listitem>
+
+      <listitem>
+        <para>
+          Within moments, and if your registration is accepted, you should
+          receive an email to the address you provided, which contains your
+          login name (generally the same as the email address), and two URLs
+          with a token (a random string generated by the installation) to
+          confirm, respectively cancel, your registration. This is a way to
+          prevent users from abusing the generation of user accounts, for
+          instance by entering inexistent email addresses, or email addresses
+          which do not belong to them.
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+          By default, you have 3 days to confirm your registration. Past this
+          timeframe, the token is invalidated and the registration is
+          automatically canceled. You can also cancel this registration sooner
+          by using the appropriate URL in the email you got.
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+          If you confirm your registration, Bugzilla will ask you your real name
+          (optional, but recommended) and your password, which must be between
+          3 and 16 characters long.
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+          Now all you need to do is to click the <quote>Log In</quote>
+          link in the footer at the bottom of the page in your browser,
+          enter your email address and password you just chose into the
+          login form, and click the <quote>Log in</quote> button.
+        </para>
+      </listitem>
+    </orderedlist>
+
+    <para>
+      You are now logged in. Bugzilla uses cookies to remember you are
+      logged in so, unless you have cookies disabled or your IP address changes,
+      you should not have to log in again during your session.
+    </para>
+  </section>
+
+  <section id="bug_page">
+    <title>Anatomy of a Bug</title>
+
+    <para>The core of Bugzilla is the screen which displays a particular
+    bug. It's a good place to explain some Bugzilla concepts. 
+    <ulink
+    url="&landfillbase;show_bug.cgi?id=1">
+    Bug 1 on Landfill</ulink>
+
+    is a good example. Note that the labels for most fields are hyperlinks;
+    clicking them will take you to context-sensitive help on that
+    particular field. Fields marked * may not be present on every
+    installation of Bugzilla.</para>
+
+    <orderedlist>
+      <listitem>
+        <para>
+          <emphasis>Product and Component</emphasis>: 
+          Bugs are divided up by Product and Component, with a Product
+          having one or more Components in it. For example,
+          bugzilla.mozilla.org's "Bugzilla" Product is composed of several
+          Components:
+          <variablelist>
+            <varlistentry>
+              <term>Administration:</term>
+              <listitem>
+                <para>
+                  Administration of a Bugzilla installation.
+                </para>
+              </listitem>
+            </varlistentry>
+
+            <varlistentry>
+              <term>Bugzilla-General:</term>
+              <listitem>
+                <para>
+                  Anything that doesn't fit in the other components, or spans
+                  multiple components.
+                </para>
+              </listitem>
+            </varlistentry>
+
+            <varlistentry>
+              <term>Creating/Changing Bugs:</term>
+              <listitem>
+                <para>
+                  Creating, changing, and viewing bugs.
+                </para>
+              </listitem>
+            </varlistentry>
+
+            <varlistentry>
+              <term>Documentation:</term>
+              <listitem>
+                <para>
+                  The Bugzilla documentation, including The Bugzilla Guide.
+                </para>
+              </listitem>
+            </varlistentry>
+
+            <varlistentry>
+              <term>Email:</term>
+              <listitem>
+                <para>
+                  Anything to do with email sent by Bugzilla.
+                </para>
+              </listitem>
+            </varlistentry>
+
+            <varlistentry>
+              <term>Installation:</term>
+              <listitem>
+                <para>
+                  The installation process of Bugzilla.
+                </para>
+              </listitem>
+            </varlistentry>
+
+            <varlistentry>
+              <term>Query/Buglist:</term>
+              <listitem>
+                <para>
+                  Anything to do with searching for bugs and viewing the
+                  buglists.
+                </para>
+              </listitem>
+            </varlistentry>
+
+            <varlistentry>
+              <term>Reporting/Charting:</term>
+              <listitem>
+                <para>
+                  Getting reports from Bugzilla.
+                </para>
+              </listitem>
+            </varlistentry>
+
+            <varlistentry>
+              <term>User Accounts:</term>
+              <listitem>
+                <para>
+                  Anything about managing a user account from the user's perspective.
+                  Saved queries, creating accounts, changing passwords, logging in,
+                  etc.
+                </para>
+              </listitem>
+            </varlistentry>
+
+            <varlistentry>
+              <term>User Interface:</term>
+              <listitem>
+                <para>
+                  General issues having to do with the user interface cosmetics (not
+                  functionality) including cosmetic issues, HTML templates,
+                  etc.
+                </para>
+              </listitem>
+            </varlistentry>
+          </variablelist>
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+        <emphasis>Status and Resolution:</emphasis>
+
+        These define exactly what state the bug is in - from not even
+        being confirmed as a bug, through to being fixed and the fix
+        confirmed by Quality Assurance. The different possible values for
+        Status and Resolution on your installation should be documented in the
+        context-sensitive help for those items.</para>
+      </listitem>
+
+      <listitem>
+        <para>
+        <emphasis>Assigned To:</emphasis>
+        The person responsible for fixing the bug.</para>
+      </listitem>
+
+      <listitem>
+        <para>
+        <emphasis>*QA Contact:</emphasis>
+        The person responsible for quality assurance on this bug.</para>
+      </listitem>
+
+      <listitem>
+        <para>
+        <emphasis>*URL:</emphasis>
+        A URL associated with the bug, if any.</para>
+      </listitem>
+
+      <listitem>
+        <para>
+        <emphasis>Summary:</emphasis>
+        A one-sentence summary of the problem.</para>
+      </listitem>
+
+      <listitem>
+        <para>
+        <emphasis>*Status Whiteboard:</emphasis>
+        (a.k.a. Whiteboard) A free-form text area for adding short notes
+        and tags to a bug.</para>
+      </listitem>
+
+      <listitem>
+        <para>
+        <emphasis>*Keywords:</emphasis>
+        The administrator can define keywords which you can use to tag and
+        categorise bugs - e.g. The Mozilla Project has keywords like crash
+        and regression.</para>
+      </listitem>
+
+      <listitem>
+        <para>
+        <emphasis>Platform and OS:</emphasis>
+        These indicate the computing environment where the bug was
+        found.</para>
+      </listitem>
+
+      <listitem>
+        <para>
+        <emphasis>Version:</emphasis>
+        The "Version" field is usually used for versions of a product which
+        have been released, and is set to indicate which versions of a
+        Component have the particular problem the bug report is
+        about.</para>
+      </listitem>
+
+      <listitem>
+        <para>
+        <emphasis>Priority:</emphasis>
+        The bug assignee uses this field to prioritize his or her bugs.
+        It's a good idea not to change this on other people's bugs.</para>
+      </listitem>
+
+      <listitem>
+        <para>
+        <emphasis>Severity:</emphasis>
+        This indicates how severe the problem is - from blocker
+        ("application unusable") to trivial ("minor cosmetic issue"). You
+        can also use this field to indicate whether a bug is an enhancement
+        request.</para>
+      </listitem>
+
+      <listitem>
+        <para>
+        <emphasis>*Target:</emphasis>
+        (a.k.a. Target Milestone) A future version by which the bug is to
+        be fixed. e.g. The Bugzilla Project's milestones for future
+        Bugzilla versions are 2.18, 2.20, 3.0, etc. Milestones are not
+        restricted to numbers, thought - you can use any text strings, such
+        as dates.</para>
+      </listitem>
+
+      <listitem>
+        <para>
+        <emphasis>Reporter:</emphasis>
+        The person who filed the bug.</para>
+      </listitem>
+
+      <listitem>
+        <para>
+        <emphasis>CC list:</emphasis>
+        A list of people who get mail when the bug changes.</para>
+      </listitem>
+
+      <listitem>
+        <para>
+        <emphasis>*Time Tracking:</emphasis>
+        This form can be used for time tracking.
+        To use this feature, you have to be blessed group membership
+        specified by the <quote>timetrackinggroup</quote> parameter.
+        <variablelist>
+          <varlistentry>
+            <term>Orig. Est.:</term>
+            <listitem>
+              <para>
+                This field shows the original estimated time.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>Current Est.:</term>
+            <listitem>
+              <para>
+                This field shows the current estimated time.
+                This number is calculated from <quote>Hours Worked</quote>
+                and <quote>Hours Left</quote>.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>Hours Worked:</term>
+            <listitem>
+              <para>
+                This field shows the number of hours worked.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>Hours Left:</term>
+            <listitem>
+              <para>
+                This field shows the <quote>Current Est.</quote> -
+                <quote>Hours Worked</quote>.
+                This value + <quote>Hours Worked</quote> will become the
+                new Current Est.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>%Complete:</term>
+            <listitem>
+              <para>
+                This field shows what percentage of the task is complete.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>Gain:</term>
+            <listitem>
+              <para>
+                This field shows the number of hours that the bug is ahead of the
+              <quote>Orig. Est.</quote>.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>Deadline:</term>
+            <listitem>
+              <para>
+                This field shows the deadline for this bug.
+              </para>
+            </listitem>
+          </varlistentry>
+        </variablelist>
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+        <emphasis>Attachments:</emphasis>
+          You can attach files (e.g. testcases or patches) to bugs. If there
+          are any attachments, they are listed in this section.
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+        <emphasis>*Dependencies:</emphasis>
+        If this bug cannot be fixed unless other bugs are fixed (depends
+        on), or this bug stops other bugs being fixed (blocks), their
+        numbers are recorded here.</para>
+      </listitem>
+
+      <listitem>
+        <para>
+        <emphasis>*Votes:</emphasis>
+        Whether this bug has any votes.</para>
+      </listitem>
+
+      <listitem>
+        <para>
+        <emphasis>Additional Comments:</emphasis>
+        You can add your two cents to the bug discussion here, if you have
+        something worthwhile to say.</para>
+      </listitem>
+    </orderedlist>
+  </section>
+
+  <section id="lifecycle">
+    <title>Life Cycle of a Bug</title>
+
+    <para>
+      The life cycle of a bug, also known as workflow, is customizable to match
+      the needs of your organization, see <xref linkend="bug_status_workflow"/>.
+      <xref linkend="lifecycle-image"/> contains a graphical representation of
+      the default workflow using the default bug statuses. If you wish to
+      customize this image for your site, the
+      <ulink url="../images/bzLifecycle.xml">diagram file</ulink>
+      is available in <ulink url="http://www.gnome.org/projects/dia">Dia's</ulink>
+      native XML format.
+    </para>
+
+    <figure id="lifecycle-image">
+      <title>Lifecycle of a Bugzilla Bug</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="../images/bzLifecycle.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+  </section>
+
+  <section id="query">
+    <title>Searching for Bugs</title>
+
+    <para>The Bugzilla Search page is the interface where you can find
+    any bug report, comment, or patch currently in the Bugzilla system. You
+    can play with it here: 
+    <ulink url="&landfillbase;query.cgi"/>.</para>
+
+    <para>The Search page has controls for selecting different possible
+    values for all of the fields in a bug, as described above. For some
+    fields, multiple values can be selected. In those cases, Bugzilla
+    returns bugs where the content of the field matches any one of the selected
+    values. If none is selected, then the field can take any value.</para>
+
+    <para>
+      After a search is run, you can save it as a Saved Search, which
+      will appear in the page footer. If you are in the group defined 
+      by the "querysharegroup" parameter, you may share your queries 
+      with other users, see <xref linkend="savedsearches"/> for more details.
+    </para>
+
+    <section id="boolean">
+      <title>Boolean Charts</title>
+      <para>
+        Highly advanced querying is done using Boolean Charts.
+      </para>
+      <para>
+        The boolean charts further restrict the set of results
+        returned by a query. It is possible to search for bugs
+        based on elaborate combinations of criteria.
+      </para>
+      <para>
+        The simplest boolean searches have only one term. These searches
+        permit the selected left <emphasis>field</emphasis>
+        to be compared using a
+        selectable <emphasis>operator</emphasis> to a
+        specified <emphasis>value.</emphasis>
+        Using the "And," "Or," and "Add Another Boolean Chart" buttons, 
+        additional terms can be included in the query, further
+        altering the list of bugs returned by the query.
+      </para>
+      <para>
+        There are three fields in each row of a boolean search. 
+      </para>
+      <itemizedlist>
+        <listitem>
+          <para>
+            <emphasis>Field:</emphasis>
+            the items being searched 
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            <emphasis>Operator:</emphasis>
+            the comparison operator 
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            <emphasis>Value:</emphasis>
+            the value to which the field is being compared
+          </para>
+        </listitem>
+      </itemizedlist>
+      <section id="pronouns">
+        <title>Pronoun Substitution</title>
+        <para>
+          Sometimes, a query needs to compare a user-related field
+          (such as ReportedBy) with a role-specific user (such as the
+          user running the query or the user to whom each bug is assigned).
+          When the operator is either "equals" or "notequals", the value
+          can be "%reporter%", "%assignee%", "%qacontact%", or "%user%".
+          The user pronoun
+          refers to the user who is executing the query or, in the case
+          of whining reports, the user who will be the recipient
+          of the report. The reporter, assignee, and qacontact
+          pronouns refer to the corresponding fields in the bug.
+        </para>
+        <para>
+          Boolean charts also let you type a group name in any user-related
+          field if the operator is either "equals", "notequals" or "anyexact".
+          This will let you query for any member belonging (or not) to the
+          specified group. The group name must be entered following the
+          "%group.foo%" syntax, where "foo" is the group name.
+          So if you are looking for bugs reported by any user being in the
+          "editbugs" group, then you can type "%group.editbugs%".
+        </para>
+      </section>
+      <section id="negation">
+        <title>Negation</title>
+        <para>
+          At first glance, negation seems redundant. Rather than
+          searching for
+          <blockquote>
+            <para>
+              NOT("summary" "contains the string" "foo"),
+            </para>
+          </blockquote>
+          one could search for 
+          <blockquote>
+            <para>
+              ("summary" "does not contain the string" "foo").
+            </para>
+          </blockquote>
+          However, the search 
+          <blockquote>
+            <para>
+              ("CC" "does not contain the string" "@mozilla.org")
+            </para>
+          </blockquote>
+          would find every bug where anyone on the CC list did not contain 
+          "@mozilla.org" while
+          <blockquote>
+            <para>
+              NOT("CC" "contains the string" "@mozilla.org")
+            </para>
+          </blockquote>
+          would find every bug where there was nobody on the CC list who
+          did contain the string. Similarly, the use of negation also permits
+          complex expressions to be built using terms OR'd together and then
+          negated. Negation permits queries such as
+          <blockquote>
+            <para>
+              NOT(("product" "equals" "update") OR 
+            ("component" "equals" "Documentation"))
+            </para>
+          </blockquote>
+          to find bugs that are neither 
+          in the update product or in the documentation component or
+          <blockquote>
+            <para>
+              NOT(("commenter" "equals" "%assignee%") OR 
+              ("component" "equals" "Documentation"))
+            </para>
+          </blockquote>
+          to find non-documentation
+          bugs on which the assignee has never commented.
+        </para>
+      </section>
+      <section id="multiplecharts">
+        <title>Multiple Charts</title>
+        <para>
+          The terms within a single row of a boolean chart are all
+          constraints on a single piece of data. If you are looking for
+          a bug that has two different people cc'd on it, then you need 
+          to use two boolean charts. A search for
+          <blockquote>
+            <para>
+              ("cc" "contains the string" "foo@") AND
+              ("cc" "contains the string" "@mozilla.org")
+            </para>
+          </blockquote>
+          would return only bugs with "foo@mozilla.org" on the cc list.
+          If you wanted bugs where there is someone on the cc list
+          containing "foo@" and someone else containing "@mozilla.org",
+          then you would need two boolean charts.
+          <blockquote>
+            <para>
+              First chart: ("cc" "contains the string" "foo@")
+            </para>
+            <para>
+              Second chart: ("cc" "contains the string" "@mozilla.org")
+            </para>
+          </blockquote>
+          The bugs listed will be only the bugs where ALL the charts are true.
+        </para>
+      </section>
+    </section>
+
+    <section id="quicksearch">
+      <title>Quicksearch</title>
+
+      <para>
+        Quicksearch is a single-text-box query tool which uses
+        metacharacters to indicate what is to be searched. For example, typing
+        "<literal>foo|bar</literal>"
+        into Quicksearch would search for "foo" or "bar" in the
+        summary and status whiteboard of a bug; adding
+        "<literal>:BazProduct</literal>" would
+        search only in that product.
+        You can use it to find a bug by its number or its alias, too.
+      </para>
+
+      <para>
+        You'll find the Quicksearch box in Bugzilla's footer area.
+        On Bugzilla's front page, there is an additional
+        <ulink url="../../page.cgi?id=quicksearch.html">Help</ulink>
+        link which details how to use it.
+      </para>
+    </section>
+    <section id="casesensitivity">
+      <title>Case Sensitivity in Searches</title>
+      <para>
+      Bugzilla queries are case-insensitive and accent-insensitive, when
+      used with either MySQL or Oracle databases. When using Bugzilla with
+      PostgreSQL, however, some queries are case-sensitive. This is due to
+      the way PostgreSQL handles case and accent sensitivity. 
+      </para>
+    </section>
+    <section id="list">
+      <title>Bug Lists</title>
+
+      <para>If you run a search, a list of matching bugs will be returned.
+      </para>
+
+      <para>The format of the list is configurable. For example, it can be
+      sorted by clicking the column headings. Other useful features can be
+      accessed using the links at the bottom of the list:
+        <variablelist>
+          <varlistentry>
+            <term>Long Format:</term>
+            <listitem>
+              <para>
+                this gives you a large page with a non-editable summary of the fields
+                of each bug.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>XML:</term>
+            <listitem>
+              <para>
+                get the buglist in the XML format.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>CSV:</term>
+            <listitem>
+              <para>
+                get the buglist as comma-separated values, for import into e.g.
+                a spreadsheet.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>Feed:</term>
+            <listitem>
+              <para>
+                get the buglist as an Atom feed.  Copy this link into your
+                favorite feed reader.  If you are using Firefox, you can also
+                save the list as a live bookmark by clicking the live bookmark
+                icon in the status bar.  To limit the number of bugs in the feed,
+                add a limit=n parameter to the URL.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>iCalendar:</term>
+            <listitem>
+              <para>
+                Get the buglist as an iCalendar file. Each bug is represented as a
+                to-do item in the imported calendar.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>Change Columns:</term>
+            <listitem>
+              <para>
+                change the bug attributes which appear in the list.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>Change several bugs at once:</term>
+            <listitem>
+              <para>
+                If your account is sufficiently empowered, and more than one bug
+                appear in the bug list, this link is displayed which lets you make
+                the same change to all the bugs in the list - for example, changing
+                their assignee.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>Send mail to bug assignees:</term>
+            <listitem>
+              <para>
+                If more than one bug appear in the bug list and there are at least
+                two distinct bug assignees, this links is displayed which lets you
+                easily send a mail to the assignees of all bugs on the list.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>Edit Search:</term>
+            <listitem>
+              <para>
+                If you didn't get exactly the results you were looking for, you can
+                return to the Query page through this link and make small revisions
+                to the query you just made so you get more accurate results.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term>Remember Search As:</term>
+            <listitem>
+              <para>
+                You can give a search a name and remember it; a link will appear
+                in your page footer giving you quick access to run it again later.
+              </para>
+            </listitem>
+          </varlistentry>
+        </variablelist>
+      </para>
+    </section>
+
+    <section id="individual-buglists">
+      <title>Adding/removing tags to/from bugs</title>
+      <para>
+        You can add and remove tags from individual bugs, which let you find and
+        manage bugs more easily. Tags are per-user and so are only visible and editable
+        by the user who created them. You can then run queries using tags as a criteria,
+        either by using the Advanced Search form, or simply by typing "tag:my_tag_name"
+        in the QuickSearch box at the top (or bottom) of the page. Tags can also be
+        displayed in buglists.
+      </para>
+
+      <para>
+        This feature is useful when you want to keep track of several bugs, but
+        for different reasons. Instead of adding yourself to the CC list of all
+        these bugs and mixing all these reasons, you can now store these bugs in
+        separate lists, e.g. <quote>Keep in mind</quote>, <quote>Interesting bugs</quote>,
+        or <quote>Triage</quote>. One big advantage of this way to manage bugs
+        is that you can easily add or remove tags from bugs one by one.
+      </para>
+    </section>
+  </section>
+
+  <section id="bugreports">
+    <title>Filing Bugs</title>
+
+    <section id="fillingbugs">
+      <title>Reporting a New Bug</title>
+    
+      <para>Years of bug writing experience has been distilled for your
+      reading pleasure into the 
+      <ulink
+      url="&landfillbase;page.cgi?id=bug-writing.html">
+      Bug Writing Guidelines</ulink>. 
+      While some of the advice is Mozilla-specific, the basic principles of
+      reporting Reproducible, Specific bugs, isolating the Product you are
+      using, the Version of the Product, the Component which failed, the
+      Hardware Platform, and Operating System you were using at the time of
+      the failure go a long way toward ensuring accurate, responsible fixes
+      for the bug that bit you.</para>
+
+      <para>The procedure for filing a bug is as follows:</para>
+
+      <orderedlist>
+        <listitem>
+          <para>
+            Click the <quote>New</quote> link available in the footer
+            of pages, or the <quote>Enter a new bug report</quote> link
+            displayed on the home page of the Bugzilla installation.
+          </para>
+
+          <note>
+            <para>
+              If you want to file a test bug to see how Bugzilla works,
+              you can do it on one of our test installations on
+              <ulink url="&landfillbase;">Landfill</ulink>.
+            </para>
+          </note>
+        </listitem>
+
+        <listitem>
+          <para>
+            You first have to select the product in which you found a bug.
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            You now see a form where you can specify the component (part of
+            the product which is affected by the bug you discovered; if you have
+            no idea, just select <quote>General</quote> if such a component exists),
+            the version of the program you were using, the Operating System and
+            platform your program is running on and the severity of the bug (if the
+            bug you found crashes the program, it's probably a major or a critical
+            bug; if it's a typo somewhere, that's something pretty minor; if it's
+            something you would like to see implemented, then that's an enhancement).
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            You now have to give a short but descriptive summary of the bug you found.
+            <quote>My program is crashing all the time</quote> is a very poor summary
+            and doesn't help developers at all. Try something more meaningful or
+            your bug will probably be ignored due to a lack of precision.
+            The next step is to give a very detailed list of steps to reproduce
+            the problem you encountered. Try to limit these steps to a minimum set
+            required to reproduce the problem. This will make the life of
+            developers easier, and the probability that they consider your bug in
+            a reasonable timeframe will be much higher.
+          </para>
+
+          <note>
+            <para>
+              Try to make sure that everything in the summary is also in the first
+              comment. Summaries are often updated and this will ensure your original
+              information is easily accessible.
+            </para>
+          </note>
+        </listitem>
+
+        <listitem>
+          <para>
+            As you file the bug, you can also attach a document (testcase, patch,
+            or screenshot of the problem).
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Depending on the Bugzilla installation you are using and the product in
+            which you are filing the bug, you can also request developers to consider
+            your bug in different ways (such as requesting review for the patch you
+            just attached, requesting your bug to block the next release of the
+            product, and many other product specific requests).
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Now is a good time to read your bug report again. Remove all misspellings,
+            otherwise your bug may not be found by developers running queries for some
+            specific words, and so your bug would not get any attention.
+            Also make sure you didn't forget any important information developers
+            should know in order to reproduce the problem, and make sure your
+            description of the problem is explicit and clear enough.
+            When you think your bug report is ready to go, the last step is to
+            click the <quote>Commit</quote> button to add your report into the database.
+          </para>
+        </listitem>
+      </orderedlist>
+
+      <para>
+      You do not need to put "any" or similar strings in the URL field.
+      If there is no specific URL associated with the bug, leave this 
+      field blank.
+      </para> 
+
+      <para>If you feel a bug you filed was incorrectly marked as a
+      DUPLICATE of another, please question it in your bug, not      
+      the bug it was duped to. Feel free to CC the person who duped it 
+      if they are not already CCed.
+      </para>
+    </section>
+
+    <section id="cloningbugs">
+      <title>Clone an Existing Bug</title>
+
+      <para>
+        Starting with version 2.20, Bugzilla has a feature that allows you
+        to clone an existing bug. The newly created bug will inherit
+        most settings from the old bug. This allows you to track more
+        easily similar concerns in a new bug. To use this, go to the bug
+        that you want to clone, then click the <quote>Clone This Bug</quote>
+        link on the bug page. This will take you to the <quote>Enter Bug</quote>
+        page that is filled with the values that the old bug has.
+        You can change those values and/or texts if needed.
+      </para>
+    </section>
+      
+  </section>
+
+  <section id="attachments">
+    <title>Attachments</title>
+
+    <para>
+      You should use attachments, rather than comments, for large chunks of ASCII
+      data, such as trace, debugging output files, or log files. That way, it
+      doesn't bloat the bug for everyone who wants to read it, and cause people to
+      receive fat, useless mails.
+    </para>
+
+    <para>You should make sure to trim screenshots. There's no need to show the
+      whole screen if you are pointing out a single-pixel problem.
+    </para>
+
+    <para>Bugzilla stores and uses a Content-Type for each attachment
+      (e.g. text/html). To download an attachment as a different
+      Content-Type (e.g. application/xhtml+xml), you can override this
+      using a 'content_type' parameter on the URL, e.g.
+      <filename>&amp;content_type=text/plain</filename>.
+    </para>
+
+    <para>
+      Also, you can enter the URL pointing to the attachment instead of
+      uploading the attachment itself. For example, this is useful if you want to
+      point to an external application, a website or a very large file. Note that
+      there is no guarantee that the source file will always be available, nor
+      that its content will remain unchanged.
+    </para>
+
+    <para>
+      Another way to attach data is to paste text directly in the text field,
+      and Bugzilla will convert it into an attachment. This is pretty useful
+      when you do copy and paste, and you don't want to put the text in a temporary
+      file first.
+    </para>
+
+    <section id="patchviewer">
+      <title>Patch Viewer</title>
+
+      <para>Viewing and reviewing patches in Bugzilla is often difficult due to
+      lack of context, improper format and the inherent readability issues that
+      raw patches present.  Patch Viewer is an enhancement to Bugzilla designed
+      to fix that by offering increased context, linking to sections, and
+      integrating with Bonsai, LXR and CVS.</para>
+
+      <para>Patch viewer allows you to:</para>
+
+      <simplelist>
+        <member>View patches in color, with side-by-side view rather than trying
+        to interpret the contents of the patch.</member>
+        <member>See the difference between two patches.</member>
+        <member>Get more context in a patch.</member>
+        <member>Collapse and expand sections of a patch for easy
+        reading.</member>
+        <member>Link to a particular section of a patch for discussion or
+        review</member>
+        <member>Go to Bonsai or LXR to see more context, blame, and
+        cross-references for the part of the patch you are looking at</member>
+        <member>Create a rawtext unified format diff out of any patch, no
+        matter what format it came from</member>
+      </simplelist>
+
+      <section id="patchviewer_view">
+        <title>Viewing Patches in Patch Viewer</title>
+        <para>The main way to view a patch in patch viewer is to click on the
+        "Diff" link next to a patch in the Attachments list on a bug. You may
+        also do this within the edit window by clicking the "View Attachment As
+        Diff" button in the Edit Attachment screen.</para>
+      </section>
+
+      <section id="patchviewer_diff">
+        <title>Seeing the Difference Between Two Patches</title>
+        <para>To see the difference between two patches, you must first view the
+        newer patch in Patch Viewer.  Then select the older patch from the
+        dropdown at the top of the page ("Differences between [dropdown] and
+        this patch") and click the "Diff" button. This will show you what
+        is new or changed in the newer patch.</para>
+      </section>
+
+      <section id="patchviewer_context">
+        <title>Getting More Context in a Patch</title>
+        <para>To get more context in a patch, you put a number in the textbox at
+        the top of Patch Viewer ("Patch / File / [textbox]") and hit enter.
+        This will give you that many lines of context before and after each
+        change. Alternatively, you can click on the "File" link there and it
+        will show each change in the full context of the file. This feature only
+        works against files that were diffed using "cvs diff".</para>
+      </section>
+
+      <section id="patchviewer_collapse">
+        <title>Collapsing and Expanding Sections of a Patch</title>
+        <para>To view only a certain set of files in a patch (for example, if a
+        patch is absolutely huge and you want to only review part of it at a
+        time), you can click the "(+)" and "(-)" links next to each file (to
+        expand it or collapse it). If you want to collapse all files or expand
+        all files, you can click the "Collapse All" and "Expand All" links at the
+        top of the page.</para>
+      </section>
+
+      <section id="patchviewer_link">
+        <title>Linking to a Section of a Patch</title>
+        <para>To link to a section of a patch (for example, if you want to be
+        able to give someone a URL to show them which part you are talking
+        about) you simply click the "Link Here" link on the section header. The
+        resulting URL can be copied and used in discussion.</para>
+      </section>
+
+      <section id="patchviewer_bonsai_lxr">
+        <title>Going to Bonsai and LXR</title>
+        <para>To go to Bonsai to get blame for the lines you are interested in,
+        you can click the "Lines XX-YY" link on the section header you are
+        interested in. This works even if the patch is against an old
+        version of the file, since Bonsai stores all versions of the file.</para>
+
+        <para>To go to LXR, you click on the filename on the file header
+        (unfortunately, since LXR only does the most recent version, line
+        numbers are likely to rot).</para>
+      </section>
+
+      <section id="patchviewer_unified_diff">
+        <title>Creating a Unified Diff</title>
+        <para>If the patch is not in a format that you like, you can turn it
+        into a unified diff format by clicking the "Raw Unified" link at the top
+        of the page.</para>
+      </section>
+    </section>
+  </section>
+
+  <section id="hintsandtips">
+    <title>Hints and Tips</title>
+
+    <para>This section distills some Bugzilla tips and best practices
+    that have been developed.</para>
+
+    <section>
+      <title>Autolinkification</title>
+      <para>Bugzilla comments are plain text - so typing &lt;U&gt; will
+      produce less-than, U, greater-than rather than underlined text.
+      However, Bugzilla will automatically make hyperlinks out of certain
+      sorts of text in comments. For example, the text 
+      "http://www.bugzilla.org" will be turned into a link:
+      <ulink url="http://www.bugzilla.org"/>.
+      Other strings which get linkified in the obvious manner are:
+      <simplelist>
+        <member>bug 12345</member>
+        <member>comment 7</member>
+        <member>bug 23456, comment 53</member>
+        <member>attachment 4321</member>
+        <member>mailto:george@example.com</member>
+        <member>george@example.com</member>
+        <member>ftp://ftp.mozilla.org</member>
+        <member>Most other sorts of URL</member>
+      </simplelist>
+      </para>
+
+      <para>A corollary here is that if you type a bug number in a comment,
+      you should put the word "bug" before it, so it gets autolinkified
+      for the convenience of others.
+      </para>
+    </section>
+
+    <section id="commenting">
+      <title>Comments</title>
+
+      <para>If you are changing the fields on a bug, only comment if
+      either you have something pertinent to say, or Bugzilla requires it.
+      Otherwise, you may spam people unnecessarily with bug mail.
+      To take an example: a user can set up their account to filter out messages
+      where someone just adds themselves to the CC field of a bug
+      (which happens a lot.) If you come along, add yourself to the CC field,
+      and add a comment saying "Adding self to CC", then that person
+      gets a pointless piece of mail they would otherwise have avoided.
+      </para>
+
+      <para>
+      Don't use sigs in comments. Signing your name ("Bill") is acceptable,
+      if you do it out of habit, but full mail/news-style
+      four line ASCII art creations are not.
+      </para>
+    </section>
+
+    <section id="comment-wrapping">
+      <title>Server-Side Comment Wrapping</title>
+      <para>
+      Bugzilla stores comments unwrapped and wraps them at display time. This
+      ensures proper wrapping in all browsers. Lines beginning with the ">" 
+      character are assumed to be quotes, and are not wrapped.
+      </para>
+    </section>
+
+    <section id="dependencytree">
+      <title>Dependency Tree</title>
+
+      <para>
+        On the <quote>Dependency tree</quote> page linked from each bug
+        page, you can see the dependency relationship from the bug as a
+        tree structure.
+      </para>
+
+      <para>
+        You can change how much depth to show, and you can hide resolved bugs
+        from this page. You can also collaps/expand dependencies for
+        each bug on the tree view, using the [-]/[+] buttons that appear
+        before its summary. This option is not available for terminal
+        bugs in the tree (that don't have further dependencies).
+      </para>
+    </section>
+  </section>
+
+  <section id="timetracking">
+    <title>Time Tracking Information</title>
+
+    <para>
+      Users who belong to the group specified by the <quote>timetrackinggroup</quote>
+      parameter have access to time-related fields. Developers can see
+      deadlines and estimated times to fix bugs, and can provide time spent
+      on these bugs.
+    </para>
+
+    <para>
+      At any time, a summary of the time spent by developers on bugs is
+      accessible either from bug lists when clicking the <quote>Time Summary</quote>
+      button or from individual bugs when clicking the <quote>Summarize time</quote>
+      link in the time tracking table. The <filename>summarize_time.cgi</filename>
+      page lets you view this information either per developer or per bug,
+      and can be split on a month basis to have greater details on how time
+      is spent by developers.
+    </para>
+
+    <para>
+      As soon as a bug is marked as RESOLVED, the remaining time expected
+      to fix the bug is set to zero. This lets QA people set it again for
+      their own usage, and it will be set to zero again when the bug will
+      be marked as CLOSED.
+    </para>
+  </section>
+
+  <section id="userpreferences">
+    <title>User Preferences</title>
+
+    <para>
+    Once logged in, you can customize various aspects of
+    Bugzilla via the "Preferences" link in the page footer.
+    The preferences are split into five tabs:</para>
+
+    <section id="generalpreferences" xreflabel="General Preferences">
+      <title>General Preferences</title>
+
+      <para>
+        This tab allows you to change several default settings of Bugzilla.
+      </para>
+
+      <itemizedlist spacing="compact">
+        <listitem>
+          <para>
+            Bugzilla's general appearance (skin) - select which skin to use.
+            Bugzilla supports adding custom skins.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Quote the associated comment when you click on its reply link - sets
+            the behavior of the comment "Reply" link. Options include quoting the
+            full comment, just reference the comment number, or turn the link off.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Language used in email - select which language email will be sent in,
+            from the list of available languages.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            After changing a bug - This controls what page is displayed after
+            changes to a bug are submitted. The options include to show the bug
+            just modified, to show the next bug in your list, or to do nothing.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Enable tags for bugs - turn bug tagging on or off.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Zoom textareas large when in use (requires JavaScript) - enable or
+            disable the automatic expanding of text areas when  text is being
+            entered into them. 
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Field separator character for CSV files -
+            Select between a comma and semi-colon for exported CSV bug lists.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Automatically add me to the CC list of bugs I change - set default
+            behavior of CC list. Options include "Always", "Never", and "Only
+            if I have no role on them". 
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            When viewing a bug, show comments in this order -
+            controls the order of comments. Options include "Oldest
+            to Newest", "Newest to Oldest" and "Newest to Oldest, but keep the
+            bug description at the top".
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Show a quip at the top of each bug list - controls
+            whether a quip will be shown on the Bug list page.
+          </para>
+        </listitem>
+      </itemizedlist>
+    </section>
+
+    <section id="emailpreferences">
+      <title>Email Preferences</title>
+
+      <para>
+        This tab allows you to enable or disable email notification on
+        specific events.
+      </para>
+
+      <para>
+        In general, users have almost complete control over how much (or
+        how little) email Bugzilla sends them. If you want to receive the
+        maximum amount of email possible, click the <quote>Enable All 
+        Mail</quote> button. If you don't want to receive any email from
+        Bugzilla at all, click the <quote>Disable All Mail</quote> button.
+      </para>
+
+      <note>
+        <para>
+          A Bugzilla administrator can stop a user from receiving
+          bugmail by clicking the <quote>Bugmail Disabled</quote> checkbox
+          when editing the user account. This is a drastic step
+          best taken only for disabled accounts, as it overrides 
+          the user's individual mail preferences.
+        </para>
+      </note>
+  
+      <para>
+        There are two global options -- <quote>Email me when someone
+        asks me to set a flag</quote> and <quote>Email me when someone
+        sets a flag I asked for</quote>. These define how you want to
+        receive bugmail with regards to flags. Their use is quite
+        straightforward; enable the checkboxes if you want Bugzilla to
+        send you mail under either of the above conditions.
+      </para>
+
+      <para>
+        If you'd like to set your bugmail to something besides
+        'Completely ON' and 'Completely OFF', the
+        <quote>Field/recipient specific options</quote> table
+        allows you to do just that. The rows of the table
+        define events that can happen to a bug -- things like
+        attachments being added, new comments being made, the
+        priority changing, etc. The columns in the table define
+        your relationship with the bug:
+      </para>
+
+      <itemizedlist spacing="compact">
+        <listitem>
+          <para>
+            Reporter - Where you are the person who initially
+            reported the bug. Your name/account appears in the
+            <quote>Reporter:</quote> field.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Assignee - Where you are the person who has been
+            designated as the one responsible for the bug. Your
+            name/account appears in the <quote>Assigned To:</quote>
+            field of the bug.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            QA Contact - You are one of the designated
+            QA Contacts for the bug. Your account appears in the 
+            <quote>QA Contact:</quote> text-box of the bug.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            CC - You are on the list CC List for the bug.
+            Your account appears in the <quote>CC:</quote> text box
+            of the bug.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Voter - You have placed one or more votes for the bug.
+            Your account appears only if someone clicks on the 
+            <quote>Show votes for this bug</quote> link on the bug.
+          </para>
+        </listitem>
+      </itemizedlist>
+
+      <note>
+        <para>
+          Some columns may not be visible for your installation, depending
+          on your site's configuration.
+        </para>
+      </note>
+
+      <para>
+        To fine-tune your bugmail, decide the events for which you want
+        to receive bugmail; then decide if you want to receive it all
+        the time (enable the checkbox for every column), or only when
+        you have a certain relationship with a bug (enable the checkbox
+        only for those columns). For example: if you didn't want to
+        receive mail when someone added themselves to the CC list, you
+        could uncheck all the boxes in the <quote>CC Field Changes</quote>
+        line. As another example, if you never wanted to receive email
+        on bugs you reported unless the bug was resolved, you would
+        un-check all boxes in the <quote>Reporter</quote> column
+        except for the one on the <quote>The bug is resolved or
+        verified</quote> row.
+      </para>
+
+      <note>
+        <para>
+          Bugzilla adds the <quote>X-Bugzilla-Reason</quote> header to
+          all bugmail it sends, describing the recipient's relationship
+          (AssignedTo, Reporter, QAContact, CC, or Voter) to the bug.
+          This header can be used to do further client-side filtering.
+        </para>
+      </note>
+
+      <para>
+        Bugzilla has a feature called <quote>Users Watching</quote>.
+        When you enter one or more comma-delineated user accounts (usually email
+        addresses) into the text entry box, you will receive a copy of all the
+        bugmail those users are sent (security settings permitting).
+        This powerful functionality enables seamless transitions as developers
+        change projects or users go on holiday.
+      </para>
+
+      <note>
+        <para>
+          The ability to watch other users may not be available in all
+          Bugzilla installations. If you don't see this feature, and feel
+          that you need it, speak to your administrator.
+        </para>
+      </note>
+
+      <para>
+        Each user listed in the <quote>Users watching you</quote> field
+        has you listed in their <quote>Users to watch</quote> list
+        and can get bugmail according to your relationship to the bug and
+        their <quote>Field/recipient specific options</quote> setting.
+      </para>
+
+    </section>
+
+    <section id="savedsearches" xreflabel="Saved Searches">
+      <title>Saved Searches</title>
+      <para>
+      On this tab you can view and run any Saved Searches that you have
+      created, and also any Saved Searches that other members of the group
+      defined in the "querysharegroup" parameter have shared. 
+      Saved Searches can be added to the page footer from this screen. 
+      If somebody is sharing a Search with a group she or he is allowed to
+      <link linkend="groups">assign users to</link>, the sharer may opt to have
+      the Search show up in the footer of the group's direct members by default.
+      </para>
+    </section>
+
+    <section id="accountpreferences" xreflabel="Name and Password">
+      <title>Name and Password</title>
+
+      <para>On this tab, you can change your basic account information,
+      including your password, email address and real name. For security
+      reasons, in order to change anything on this page you must type your
+      <emphasis>current</emphasis> password into the <quote>Password</quote>
+      field at the top of the page.
+      If you attempt to change your email address, a confirmation
+      email is sent to both the old and new addresses, with a link to use to
+      confirm the change. This helps to prevent account hijacking.</para>
+    </section>
+
+    <section id="permissionsettings">
+      <title>Permissions</title>
+      
+      <para>
+      This is a purely informative page which outlines your current
+      permissions on this installation of Bugzilla.
+      </para>
+
+      <para>
+      A complete list of permissions is below. Only users with 
+      <emphasis>editusers</emphasis> privileges can change the permissions 
+      of other users.
+      </para>
+
+      <variablelist>
+        <varlistentry>
+          <term>
+            admin
+          </term>
+          <listitem>
+            <para> 
+             Indicates user is an Administrator.
+            </para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>
+            bz_canusewhineatothers
+          </term>
+          <listitem>
+            <para> 
+             Indicates user can configure whine reports for other users.
+            </para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>
+             bz_canusewhines
+          </term>
+          <listitem>
+            <para> 
+             Indicates user can configure whine reports for self.
+            </para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>
+             bz_quip_moderators
+          </term>
+          <listitem>
+            <para>
+             Indicates user can moderate quips.
+            </para>
+          </listitem>
+        </varlistentry>
+ 
+        <varlistentry>
+          <term>
+             bz_sudoers
+          </term>
+          <listitem>
+            <para> 
+             Indicates user can perform actions as other users.
+            </para>
+          </listitem>
+        </varlistentry>        
+
+        <varlistentry>
+          <term>
+             bz_sudo_protect
+          </term>
+          <listitem>
+            <para> 
+             Indicates user cannot be impersonated by other users.
+            </para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>
+             canconfirm
+          </term>
+          <listitem>
+            <para> 
+             Indicates user can confirm a bug or mark it a duplicate.
+            </para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>
+             creategroups
+          </term>
+          <listitem>
+            <para> 
+             Indicates user can create and destroy groups.
+            </para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>
+             editbugs
+          </term>
+          <listitem>
+            <para> 
+             Indicates user can edit all bug fields.
+            </para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>
+             editclassifications
+          </term>
+          <listitem>
+            <para> 
+             Indicates user can create, destroy, and edit classifications.
+            </para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>
+             editcomponents
+          </term>
+          <listitem>
+            <para> 
+             Indicates user can create, destroy, and edit components.
+            </para>
+          </listitem>
+        </varlistentry>
+ 
+        <varlistentry>
+          <term>
+             editkeywords
+          </term>
+          <listitem>
+            <para> 
+             Indicates user can create, destroy, and edit keywords.
+            </para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>
+             editusers
+          </term>
+          <listitem>
+            <para> 
+             Indicates user can edit or disable users.
+            </para>
+          </listitem>
+        </varlistentry>
+       
+        <varlistentry>
+          <term>
+             tweakparams
+          </term>
+          <listitem>
+            <para> 
+             Indicates user can change Parameters.
+            </para>
+          </listitem>
+        </varlistentry>
+
+      </variablelist>
+
+       <note>
+        <para>
+        For more information on how permissions work in Bugzilla (i.e. who can
+        change what), see  <xref linkend="cust-change-permissions"/>. 
+        </para>
+       </note>
+
+    </section>
+  </section>
+  
+  
+  <section id="reporting">
+    <title>Reports and Charts</title>
+    
+    <para>As well as the standard buglist, Bugzilla has two more ways of
+    viewing sets of bugs. These are the reports (which give different
+    views of the current state of the database) and charts (which plot
+    the changes in particular sets of bugs over time.)</para>
+    
+    <section id="reports">
+      <title>Reports</title>
+      
+      <para>
+        A report is a view of the current state of the bug database.
+      </para>
+      
+      <para>
+        You can run either an HTML-table-based report, or a graphical
+        line/pie/bar-chart-based one. The two have different pages to
+        define them, but are close cousins - once you've defined and
+        viewed a report, you can switch between any of the different
+        views of the data at will.
+      </para>
+      
+      <para>
+        Both report types are based on the idea of defining a set of bugs
+        using the standard search interface, and then choosing some
+        aspect of that set to plot on the horizontal and/or vertical axes.
+        You can also get a form of 3-dimensional report by choosing to have
+        multiple images or tables.
+      </para>
+      
+      <para>
+        So, for example, you could use the search form to choose "all
+        bugs in the WorldControl product", and then plot their severity
+        against their component to see which component had had the largest
+        number of bad bugs reported against it. 
+      </para>
+      
+      <para>
+        Once you've defined your parameters and hit "Generate Report",
+        you can switch between HTML, CSV, Bar, Line and Pie. (Note: Pie
+        is only available if you didn't define a vertical axis, as pie
+        charts don't have one.) The other controls are fairly self-explanatory;
+        you can change the size of the image if you find text is overwriting
+        other text, or the bars are too thin to see.
+      </para>
+      
+    </section>
+    
+    <section id="charts">
+      <title>Charts</title>
+      
+      <para>
+        A chart is a view of the state of the bug database over time.
+      </para>
+      
+      <para>
+        Bugzilla currently has two charting systems - Old Charts and New 
+        Charts. Old Charts have been part of Bugzilla for a long time; they
+        chart each status and resolution for each product, and that's all.
+        They are deprecated, and going away soon - we won't say any more 
+        about them.
+        New Charts are the future - they allow you to chart anything you
+        can define as a search.
+      </para>
+      
+      <note>
+        <para>
+          Both charting forms require the administrator to set up the
+          data-gathering script. If you can't see any charts, ask them whether
+          they have done so.
+        </para>
+      </note>
+      
+      <para>
+        An individual line on a chart is called a data set.
+        All data sets are organised into categories and subcategories. The 
+        data sets that Bugzilla defines automatically use the Product name 
+        as a Category and Component names as Subcategories, but there is no 
+        need for you to follow that naming scheme with your own charts if 
+        you don't want to.
+      </para>
+      
+      <para>
+        Data sets may be public or private. Everyone sees public data sets in
+        the list, but only their creator sees private data sets. Only 
+        administrators can make data sets public.
+        No two data sets, even two private ones, can have the same set of 
+        category, subcategory and name. So if you are creating private data 
+        sets, one idea is to have the Category be your username.
+      </para>
+      
+      <section>
+        <title>Creating Charts</title>
+        
+        <para>
+          You create a chart by selecting a number of data sets from the
+          list, and pressing Add To List for each. In the List Of Data Sets
+          To Plot, you can define the label that data set will have in the
+          chart's legend, and also ask Bugzilla to Sum a number of data sets 
+          (e.g. you could Sum data sets representing RESOLVED, VERIFIED and 
+          CLOSED in a particular product to get a data set representing all 
+          the resolved bugs in that product.)
+        </para>
+
+        <para>
+          If you've erroneously added a data set to the list, select it
+          using the checkbox and click Remove. Once you add more than one 
+          data set, a "Grand Total" line
+          automatically appears at the bottom of the list. If you don't want
+          this, simply remove it as you would remove any other line.
+        </para>
+        
+        <para>
+          You may also choose to plot only over a certain date range, and
+          to cumulate the results - that is, to plot each one using the 
+          previous one as a baseline, so the top line gives a sum of all 
+          the data sets. It's easier to try than to explain :-)
+        </para>
+
+        <para>
+          Once a data set is in the list, one can also perform certain 
+          actions on it. For example, one can edit the
+          data set's parameters (name, frequency etc.) if it's one you
+          created or if you are an administrator.
+        </para>
+
+        <para>
+           Once you are happy, click Chart This List to see the chart.
+        </para>
+
+      </section>
+      
+      <section id="charts-new-series">
+        <title>Creating New Data Sets</title>
+        
+        <para>
+          You may also create new data sets of your own. To do this,
+          click the "create a new data set" link on the Create Chart page.
+          This takes you to a search-like interface where you can define
+          the search that Bugzilla will plot. At the bottom of the page,
+          you choose the category, sub-category and name of your new
+          data set. 
+        </para>
+
+        <para>
+          If you have sufficient permissions, you can make the data set public,
+          and reduce the frequency of data collection to less than the default
+          seven days.
+        </para>
+      </section>
+      
+    </section>
+    
+  </section>
+  
+  <section id="flags">
+    <title>Flags</title>
+    
+    <para>
+      A flag is a kind of status that can be set on bugs or attachments
+      to indicate that the bugs/attachments are in a certain state.
+      Each installation can define its own set of flags that can be set
+      on bugs or attachments.
+    </para>
+    
+    <para>
+      If your installation has defined a flag, you can set or unset that flag,
+      and if your administrator has enabled requesting of flags, you can submit
+      a request for another user to set the flag.
+    </para>
+    
+    <para>
+      To set a flag, select either "+" or "-" from the drop-down menu next to
+      the name of the flag in the "Flags" list.  The meaning of these values are
+      flag-specific and thus cannot be described in this documentation,
+      but by way of example, setting a flag named "review" to "+" may indicate
+      that the bug/attachment has passed review, while setting it to "-"
+      may indicate that the bug/attachment has failed review.
+    </para>
+    
+    <para>
+      To unset a flag, click its drop-down menu and select the blank value.
+      Note that marking an attachment as obsolete automatically cancels all
+      pending requests for the attachment.
+    </para>
+    
+    <para>
+      If your administrator has enabled requests for a flag, request a flag
+      by selecting "?" from the drop-down menu and then entering the username
+      of the user you want to set the flag in the text field next to the menu.
+    </para>
+    
+    <para>
+      A set flag appears in bug reports and on "edit attachment" pages with the
+      abbreviated username of the user who set the flag prepended to the
+      flag name. For example, if Jack sets a "review" flag to "+", it appears
+      as Jack: review [ + ]
+    </para>
+  
+    <para>
+      A requested flag appears with the user who requested the flag prepended
+      to the flag name and the user who has been requested to set the flag
+      appended to the flag name within parentheses.  For example, if Jack
+      asks Jill for review, it appears as Jack: review [ ? ] (Jill).
+    </para>
+
+    <para>
+      You can browse through open requests made of you and by you by selecting
+      'My Requests' from the footer. You can also look at open requests limited
+      by other requesters, requestees, products, components, and flag names from
+      this page. Note that you can use '-' for requestee to specify flags with
+      'no requestee' set.
+    </para>
+  </section>
+
+  <section id="whining">
+    <title>Whining</title>
+
+    <para>
+      Whining is a feature in Bugzilla that can regularly annoy users at 
+      specified times.  Using this feature, users can execute saved searches 
+      at specific times (i.e. the 15th of the month at midnight) or at 
+      regular intervals (i.e. every 15 minutes on Sundays).  The results of the
+      searches are sent to the user, either as a single email or as one email 
+      per bug, along with some descriptive text.
+    </para>
+
+    <warning>
+      <para>
+        Throughout this section it will be assumed that all users are members 
+        of the bz_canusewhines group, membership in which is required in order 
+        to use the Whining system.  You can easily make all users members of 
+        the bz_canusewhines group by setting the User RegExp to ".*" (without 
+        the quotes).
+      </para>
+
+      <para>
+        Also worth noting is the bz_canusewhineatothers group.  Members of this
+        group can create whines for any user or group in Bugzilla using a 
+        extended form of the whining interface.  Features only available to 
+        members of the bz_canusewhineatothers group will be noted in the 
+        appropriate places.
+      </para>
+    </warning>
+
+    <note>
+      <para>
+        For whining to work, a special Perl script must be executed at regular
+        intervals.  More information on this is available in 
+        <xref linkend="installation-whining"/>.
+      </para>
+    </note>
+
+    <note>
+      <para>
+        This section does not cover the whineatnews.pl script.  See
+        <xref linkend="installation-whining-cron"/> for more information on 
+        The Whining Cron.
+      </para>
+    </note>
+
+    <section id="whining-overview">
+      <title>The Event</title>
+
+      <para>
+        The whining system defines an "Event" as one or more queries being 
+        executed at regular intervals, with the results of said queries (if
+        there are any) being emailed to the user.  Events are created by 
+        clicking on the "Add new event" button.
+      </para>
+
+      <para>
+        Once a new event is created, the first thing to set is the "Email 
+        subject line".  The contents of this field will be used in the subject
+        line of every email generated by this event.  In addition to setting a 
+        subject, space is provided to enter some descriptive text that will be 
+        included at the top of each message (to help you in understanding why 
+        you received the email in the first place).
+      </para>
+
+      <para>
+        The next step is to specify when the Event is to be run (the Schedule) 
+        and what searches are to be performed (the Searches).
+      </para>
+
+    </section>
+
+    <section id="whining-schedule">
+      <title>Whining Schedule</title>
+
+      <para>
+         Each whining event is associated with zero or more schedules.  A 
+         schedule is used to specify when the query (specified below) is to be
+         run.  A new event starts out with no schedules (which means it will 
+         never run, as it is not scheduled to run).  To add a schedule, press
+         the "Add a new schedule" button.
+      </para>
+
+      <para>
+         Each schedule includes an interval, which you use to tell Bugzilla 
+         when the event should be run.  An event can be run on certain days of
+         the week, certain days of the month, during weekdays (defined as 
+         Monday through Friday), or every day.
+      </para>
+
+      <warning>
+        <para>
+          Be careful if you set your event to run on the 29th, 30th, or 31st of
+          the month, as your event may not run exactly when expected.  If you 
+          want your event to run on the last day of the month, select "Last day
+          of the month" as the interval.
+        </para>
+      </warning>
+
+      <para>
+        Once you have specified the day(s) on which the event is to be run, you
+        should now specify the time at which the event is to be run.  You can 
+        have the event run at a certain hour on the specified day(s), or 
+        every hour, half-hour, or quarter-hour on the specified day(s).
+      </para>
+
+      <para>
+        If a single schedule does not execute an event as many times as you 
+        would want, you can create another schedule for the same event.  For 
+        example, if you want to run an event on days whose numbers are
+        divisible by seven, you would need to add four schedules to the event,
+        setting the schedules to run on the 7th, 14th, 21st, and 28th (one day 
+        per schedule) at whatever time (or times) you choose.
+      </para>
+
+      <note>
+        <para>
+          If you are a member of the bz_canusewhineatothers group, then you
+          will be presented with another option: "Mail to".  Using this you 
+          can control who will receive the emails generated by this event.  You
+          can choose to send the emails to a single user (identified by email 
+          address) or a single group (identified by group name).  To send to 
+          multiple users or groups, create a new schedule for each additional 
+          user/group.
+        </para>
+      </note>
+    </section>
+
+    <section id="whining-query">
+      <title>Whining Searches</title>
+
+      <para>
+        Each whining event is associated with zero or more searches.  A search
+        is any saved search to be run as part of the specified schedule (see
+        above).  You start out without any searches associated with the event
+        (which means that the event will not run, as there will never be any
+        results to return).  To add a search, press the "Include search" button.
+      </para>
+
+      <para>
+        The first field to examine in your newly added search is the Sort field.
+        Searches are run, and results included, in the order specified by the
+        Sort field.  Searches with smaller Sort values will run before searches
+        with bigger Sort values.
+      </para>
+
+      <para>
+        The next field to examine is the Search field.  This is where you 
+        choose the actual search that is to be run.  Instead of defining search
+        parameters here, you are asked to choose from the list of saved 
+        searches (the same list that appears at the bottom of every Bugzilla 
+        page).  You are only allowed to choose from searches that you have 
+        saved yourself (the default saved search, "My Bugs", is not a valid 
+        choice).  If you do not have any saved searches, you can take this 
+        opportunity to create one (see <xref linkend="list"/>).
+      </para>
+
+      <note>
+        <para>
+          When running queries, the whining system acts as if you are the user
+          executing the query.  This means that the whining system will ignore
+          bugs that match your query, but that you cannot access.
+        </para>
+      </note>
+
+      <para>
+        Once you have chosen the saved search to be executed, give the query a 
+        descriptive title.  This title will appear in the email, above the 
+        results of the query.  If you choose "One message per bug", the query 
+        title will appear at the top of each email that contains a bug matching
+        your query.
+      </para>
+
+      <para>
+        Finally, decide if the results of the query should be sent in a single
+        email, or if each bug should appear in its own email.
+      </para>
+
+      <warning>
+        <para>
+          Think carefully before checking the "One message per bug" box.  If
+          you create a query that matches thousands of bugs, you will receive 
+          thousands of emails!
+        </para>
+      </warning>
+    </section>
+
+    <section>
+      <title>Saving Your Changes</title>
+
+      <para>
+        Once you have defined at least one schedule, and created at least one 
+        query, go ahead and "Update/Commit".  This will save your Event and make
+        it available for immediate execution.
+      </para>
+
+      <note>
+        <para>
+          If you ever feel like deleting your event, you may do so using the 
+          "Remove Event" button in the upper-right corner of each Event.  You 
+          can also modify an existing event, so long as you "Update/Commit" 
+          after completing your modifications.
+        </para>
+      </note>
+    </section>
+
+  </section>
+
+</chapter>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-always-quote-attributes:t
+sgml-auto-insert-required-elements:t
+sgml-balanced-tag-edit:t
+sgml-exposed-tags:nil
+sgml-general-insert-case:lower
+sgml-indent-data:t
+sgml-indent-step:2
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+sgml-minimize-attributes:nil
+sgml-namecase-general:t
+sgml-omittag:t
+sgml-parent-document:("Bugzilla-Guide.xml" "book" "chapter")
+sgml-shorttag:t
+sgml-tag-region-if-active:t
+End:
+-->

diff --git a/docs/lib/Pod/Simple/HTML/Bugzilla.pm b/docs/lib/Pod/Simple/HTML/Bugzilla.pm
new file mode 100644 (file)
index 0000000..cc607be
--- /dev/null
+++ b/docs/lib/Pod/Simple/HTML/Bugzilla.pm
@@ -0,0 +1,65 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Pod::Simple::HTML::Bugzilla;
+
+use strict;
+use base qw(Pod::Simple::HTML);
+
+# Without this constant, HTMLBatch will throw undef warnings.
+use constant VERSION    => $Pod::Simple::HTML::VERSION;
+use constant CODE_CLASS => ' class="code"';
+use constant META_CT  => '<meta http-equiv="Content-Type" content="text/html;'
+                         . ' charset=UTF-8">';
+use constant DOCTYPE  => '<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01'
+    . ' Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">';
+
+sub new {
+    my $self    = shift->SUPER::new(@_);
+
+    my $doctype      = $self->DOCTYPE;
+    my $content_type = $self->META_CT;
+
+    my $html_pre_title = <<END_HTML;
+$doctype
+<html>
+  <head>
+    <title>
+END_HTML
+
+    my $html_post_title = <<END_HTML;
+</title>
+    $content_type
+  </head>
+  <body id="pod">
+END_HTML
+
+    $self->html_header_before_title($html_pre_title);
+    $self->html_header_after_title($html_post_title);
+
+    # Fix some tags to have classes so that we can adjust them.
+    my $code = CODE_CLASS;
+    $self->{'Tagmap'}->{'Verbatim'} = "\n<pre $code>";
+    $self->{'Tagmap'}->{'VerbatimFormatted'} = "\n<pre $code>";
+    $self->{'Tagmap'}->{'F'} = "<em $code>";
+    $self->{'Tagmap'}->{'C'} = "<code $code>";
+
+    # Don't put head4 tags into the Table of Contents. We have this
+    delete $Pod::Simple::HTML::ToIndex{'head4'};
+
+    return $self;
+}
+
+# Override do_beginning to put the name of the module at the top
+sub do_beginning {
+    my $self = shift;
+    $self->SUPER::do_beginning(@_);
+    print {$self->{'output_fh'}} "<h1>" . $self->get_short_title . "</h1>";
+    return 1;
+}
+
+1;

diff --git a/docs/lib/Pod/Simple/HTMLBatch/Bugzilla.pm b/docs/lib/Pod/Simple/HTMLBatch/Bugzilla.pm
new file mode 100644 (file)
index 0000000..366ceb7
--- /dev/null
+++ b/docs/lib/Pod/Simple/HTMLBatch/Bugzilla.pm
@@ -0,0 +1,107 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Pod::Simple::HTMLBatch::Bugzilla;
+
+use strict;
+use base qw(Pod::Simple::HTMLBatch);
+
+# This is the same hack that HTMLBatch does to "import" this subroutine.
+BEGIN { *esc = \&Pod::Simple::HTML::esc }
+
+# Describes how top-level modules should be sorted and named. This
+# is a translation from HTMLBatch's names to our categories.
+# Note that if you leave out a category here, it will not be indexed
+# in the contents file, even though its HTML POD will still exist.
+use constant FILE_TRANSLATION => {
+    Files      => ['importxml', 'contrib', 'checksetup', 'email_in', 
+                   'install-module', 'sanitycheck', 'jobqueue', 'migrate',
+                   'collectstats'],
+    Modules    => ['bugzilla'],
+    Extensions => ['extensions'],
+};
+
+# This is basically copied from Pod::Simple::HTMLBatch, and overridden
+# so that we can format things more nicely.
+sub _write_contents_middle {
+    my ($self, $Contents, $outfile, $toplevel2submodules) = @_;
+
+    my $file_trans = FILE_TRANSLATION;
+
+    # For every top-level category...
+    foreach my $category (sort keys %$file_trans) {
+        # Get all of the HTMLBatch categories that should be in this
+        # category.
+        my @category_data;
+        foreach my $b_category (@{$file_trans->{$category}}) {
+            my $data = $toplevel2submodules->{$b_category};
+            push(@category_data, @$data) if $data;
+        }
+        next unless @category_data;
+
+        my @downlines = sort {$a->[-1] cmp $b->[-1]} @category_data;
+
+        # And finally, actually print out the table for this category. 
+        printf $Contents qq[<dt><a name="%s">%s</a></dt>\n<dd>\n],
+                esc($category), esc($category);
+        print $Contents '<table class="pod_desc_table">' . "\n";
+
+        # For every POD...
+        my $row_count = 0;
+        foreach my $e (@downlines) {
+            $row_count++;
+            my $even_or_odd = $row_count % 2 ? 'even' : 'odd';
+            my $name = esc($e->[0]);
+            my $path = join( "/", '.', esc(@{$e->[3]}) )
+               . $Pod::Simple::HTML::HTML_EXTENSION;
+            my $description = $self->{bugzilla_desc}->{$name} || '';
+            $description = esc($description);
+            my $html = <<END_HTML;
+<tr class="$even_or_odd">
+  <th><a href="$path">$name</a></th>
+  <td>$description</td>
+</tr>
+END_HTML
+      
+            print $Contents $html;
+        }
+        print $Contents "</table></dd>\n\n";
+    }
+
+    return 1;
+}
+
+# This stores the name and description for each file, so that
+# we can get that information out later.
+sub note_for_contents_file {
+    my $self = shift;
+    my $retval = $self->SUPER::note_for_contents_file(@_);
+
+    my ($namelets, $infile) = @_;
+    my $parser   = $self->html_render_class->new;
+    $parser->set_source($infile);
+    my $full_title = $parser->get_title;
+    $full_title =~ /^\S+\s+-+\s+(.+)/;
+    my $description = $1;
+    
+    $self->{bugzilla_desc} ||= {};
+    $self->{bugzilla_desc}->{join('::', @$namelets)} = $description;
+
+    return $retval;
+}
+
+# Exclude modules being in lib/.
+sub find_all_pods {
+    my($self, $dirs) = @_;
+    my $mod2path = $self->SUPER::find_all_pods($dirs);
+    foreach my $mod (keys %$mod2path) {
+        delete $mod2path->{$mod} if $mod =~ /^lib::/;
+    }
+    return $mod2path;
+}
+
+1;

diff --git a/docs/makedocs.pl b/docs/makedocs.pl
new file mode 100755 (executable)
index 0000000..4bf1fb4
--- /dev/null
+++ b/docs/makedocs.pl
@@ -0,0 +1,179 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# This script compiles all the documentation.
+
+use strict;
+use Cwd;
+
+# We need to be in this directory to use our libraries.
+BEGIN {
+    require File::Basename;
+    import File::Basename qw(dirname);
+    chdir dirname($0);
+}
+
+use lib qw(.. ../lib lib);
+
+# We only compile our POD if Pod::Simple is installed. We do the checks
+# this way so that if there's a compile error in Pod::Simple::HTML::Bugzilla,
+# makedocs doesn't just silently fail, but instead actually tells us there's
+# a compile error.
+my $pod_simple;
+if (eval { require Pod::Simple }) {
+    require Pod::Simple::HTMLBatch::Bugzilla;
+    require Pod::Simple::HTML::Bugzilla;
+    $pod_simple = 1;
+};
+
+use Bugzilla::Install::Requirements 
+    qw(REQUIRED_MODULES OPTIONAL_MODULES);
+use Bugzilla::Constants qw(DB_MODULE BUGZILLA_VERSION);
+
+###############################################################################
+# Generate minimum version list
+###############################################################################
+
+my $modules = REQUIRED_MODULES;
+my $opt_modules = OPTIONAL_MODULES;
+
+my $template;
+{
+    open(TEMPLATE, '<', 'bugzilla.ent.tmpl')
+      or die('Could not open bugzilla.ent.tmpl: ' . $!);
+    local $/;
+    $template = <TEMPLATE>;
+    close TEMPLATE;
+}
+open(ENTITIES, '>', 'bugzilla.ent') or die('Could not open bugzilla.ent: ' . $!);
+print ENTITIES "$template\n";
+print ENTITIES '<!-- Module Versions -->' . "\n";
+foreach my $module (@$modules, @$opt_modules)
+{
+    my $name = $module->{'module'};
+    $name =~ s/::/-/g;
+    $name = lc($name);
+    #This needs to be a string comparison, due to the modules having
+    #version numbers like 0.9.4
+    my $version = $module->{'version'} eq 0 ? 'any' : $module->{'version'};
+    print ENTITIES '<!ENTITY min-' . $name . '-ver "'.$version.'">' . "\n";
+}
+
+print ENTITIES "\n <!-- Database Versions --> \n";
+
+my $db_modules = DB_MODULE;
+foreach my $db (keys %$db_modules) {
+    my $dbd  = $db_modules->{$db}->{dbd};
+    my $name = $dbd->{module};
+    $name =~ s/::/-/g;
+    $name = lc($name);
+    my $version    = $dbd->{version} || 'any';
+    my $db_version = $db_modules->{$db}->{'db_version'};
+    print ENTITIES '<!ENTITY min-' . $name . '-ver "'.$version.'">' . "\n";
+    print ENTITIES '<!ENTITY min-' . lc($db) . '-ver "'.$db_version.'">' . "\n";
+}
+close(ENTITIES);
+
+###############################################################################
+# Subs
+###############################################################################
+
+sub MakeDocs {
+
+    my ($name, $cmdline) = @_;
+
+    print "Creating $name documentation ...\n" if defined $name;
+    print "$cmdline\n\n";
+    system $cmdline;
+    print "\n";
+
+}
+
+sub make_pod {
+
+    print "Creating API documentation...\n";
+
+    my $converter = Pod::Simple::HTMLBatch::Bugzilla->new;
+    # Don't output progress information.
+    $converter->verbose(0);
+    $converter->html_render_class('Pod::Simple::HTML::Bugzilla');
+
+    my $doctype      = Pod::Simple::HTML::Bugzilla->DOCTYPE;
+    my $content_type = Pod::Simple::HTML::Bugzilla->META_CT;
+    my $bz_version   = BUGZILLA_VERSION;
+
+    my $contents_start = <<END_HTML;
+$doctype
+<html>
+  <head>
+    $content_type
+    <title>Bugzilla $bz_version API Documentation</title>
+  </head>
+  <body class="contentspage">
+    <h1>Bugzilla $bz_version API Documentation</h1>
+END_HTML
+
+    $converter->contents_page_start($contents_start);
+    $converter->contents_page_end("</body></html>");
+    $converter->add_css('./../../../style.css');
+    $converter->javascript_flurry(0);
+    $converter->css_flurry(0);
+    $converter->batch_convert(['../../'], 'html/api/');
+
+    print "\n";
+}
+
+###############################################################################
+# Make the docs ...
+###############################################################################
+
+my @langs;
+# search for sub directories which have a 'xml' sub-directory
+opendir(LANGS, './');
+foreach my $dir (readdir(LANGS)) {
+    next if (($dir eq '.') || ($dir eq '..') || (! -d $dir));
+    if (-d "$dir/xml") {
+        push(@langs, $dir);
+    }
+}
+closedir(LANGS);
+
+my $docparent = getcwd();
+foreach my $lang (@langs) {
+    chdir "$docparent/$lang";
+    MakeDocs(undef, 'cp ../bugzilla.ent ./xml/');
+
+    if (!-d 'txt') {
+        unlink 'txt';
+        mkdir 'txt', 0755;
+    }
+    if (!-d 'pdf') {
+        unlink 'pdf';
+        mkdir 'pdf', 0755;
+    }
+    if (!-d 'html') {
+        unlink 'html';
+        mkdir 'html', 0755;
+    }
+    if (!-d 'html/api') {
+        unlink 'html/api';
+        mkdir 'html/api', 0755;
+    }
+
+    make_pod() if $pod_simple;
+
+    MakeDocs('separate HTML', 'xmlto -m ../xsl/chunks.xsl -o html html xml/Bugzilla-Guide.xml');
+    MakeDocs('big HTML', 'xmlto -m ../xsl/nochunks.xsl -o html html-nochunks xml/Bugzilla-Guide.xml');
+    MakeDocs('big text', 'lynx -dump -justify=off -nolist html/Bugzilla-Guide.html > txt/Bugzilla-Guide.txt');
+
+    if (! grep($_ eq "--with-pdf", @ARGV)) {
+        next;
+    }
+
+    MakeDocs('PDF', 'dblatex -p ../xsl/pdf.xsl -o pdf/Bugzilla-Guide.pdf xml/Bugzilla-Guide.xml');
+}

diff --git a/docs/style.css b/docs/style.css
new file mode 100644 (file)
index 0000000..8604b5b
--- /dev/null
+++ b/docs/style.css
@@ -0,0 +1,95 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+body {
+  background: white;
+  color: #111;
+  padding: 0 1em;
+  font-family: Verdana, Arial, sans-serif;
+}
+
+a:link, a:active { color: #36415c; }
+a:visited { color: #666; }
+a:hover   { color: #888; }
+
+h1 {
+  font-size: 150%;
+  font-weight: bold;
+  border-bottom: 2px solid #ccc;
+}
+h2 {
+  font-size: 125%;
+  font-weight: bold;
+  border-bottom: 1px solid #ccc;
+  margin-bottom: 8px;
+}
+h3 {
+  font-size: 115%;
+  font-weight: bold;
+  margin-bottom: 0;
+  padding-bottom: 0;
+}
+
+/* This makes Description/Params/Returns look nice. */
+dd   { margin-top: .2em; }
+dd p { margin-top: 0; }
+dl   { margin-bottom: 1em; }
+
+/* This makes the names of functions slightly larger, in Gecko. */
+body > dl > dt code { font-size: 1.35em; }
+
+#pod h1 a, #pod h2 a, #pod h3 a {
+  color: #36415c;
+  text-decoration: none;
+}
+
+pre, code, tt, kbd, samp {
+  /* Unfortunately, the default monospace fonts on most browsers
+     look odd with relative sizing. */
+  font-size: 12px;
+}
+
+.code {
+  background: #eed;
+  border: 1px solid #ccc;
+}
+
+pre.code, pre.programlisting, pre.screen {
+  margin-left: 10px;
+  padding: 0.5em;
+  background: #eed;
+  border: 1px solid #ccc;
+}
+
+/* Special styles for the Contents page */
+
+.contentspage dt {
+  font-size: large;
+  font-weight: bold;
+}
+
+.pod_desc_table {
+  border-collapse: collapse;
+  table-layout: auto;
+  border: 1px solid #ccc;
+}
+
+.pod_desc_table th {
+  text-align: left;
+}
+
+.pod_desc_table td, .pod_desc_table th {
+  padding: .25em;
+  border-top: 1px solid #ccc;
+}
+
+.pod_desc_table .odd th, .pod_desc_table .odd td {
+  background-color: #eee;
+}
+
+.pod_desc_table 

diff --git a/docs/xsl/bugzilla-docs.xsl b/docs/xsl/bugzilla-docs.xsl
new file mode 100644 (file)
index 0000000..f791087
--- /dev/null
+++ b/docs/xsl/bugzilla-docs.xsl
@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+    <!-- Nicer Filenames -->
+    <xsl:param name="use.id.as.filename" select="1"/>
+
+    <!-- Label sections if they aren't automatically labeled -->
+    <xsl:param name="section.autolabel" select="1"/>
+    <xsl:param name="section.label.includes.component.label" select="1"/>
+
+    <!-- Table of Contents Depth -->
+    <xsl:param name="toc.section.depth">2</xsl:param>
+    <xsl:param name="generate.section.toc.level" select="0"/>
+
+    <!-- Show titles of next/previous page -->
+    <xsl:param name="navig.showtitles">1</xsl:param>
+
+    <!-- Tidy up the HTML a bit... -->
+    <xsl:param name="html.cleanup" select="1"/>
+    <xsl:param name="make.valid.html" select="1"/>
+    <xsl:param name="html.stylesheet">../../style.css</xsl:param>
+    <xsl:param name="highlight.source" select="1"/>
+
+    <!-- Use Graphics, specify their Path and Extension -->
+    <xsl:param name="admon.graphics" select="1"/>
+    <xsl:param name="admon.graphics.path">../images/</xsl:param>
+    <xsl:param name="admon.graphics.extension">.gif</xsl:param>
+    <xsl:param name="admon.textlabel" select="0"/>
+    <xsl:param name="admon.style">margin-left: 1em; margin-right: 1em</xsl:param>
+</xsl:stylesheet>

diff --git a/docs/xsl/chunks.xsl b/docs/xsl/chunks.xsl
new file mode 100644 (file)
index 0000000..1389dd5
--- /dev/null
+++ b/docs/xsl/chunks.xsl
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+    <!-- Include default bugzilla XSL -->
+    <xsl:include href="bugzilla-docs.xsl"/>
+    <!-- Set Chunk Specific XSL Params -->
+    <xsl:param name="chunker.output.doctype-public">-//W3C//DTD HTML 4.01 Transitional//EN</xsl:param>
+    <xsl:param name="chunker.output.doctype-system">http://www.w3.org/TR/html4/loose.dtd</xsl:param>
+    <xsl:param name="chunk.section.depth" select="1"/>
+    <xsl:param name="chunk.first.sections" select="1"/>
+    <xsl:param name="chunker.output.encoding" select="UTF-8"/>
+    <xsl:param name="chunk.quietly" select="1"/>
+</xsl:stylesheet>

diff --git a/docs/xsl/nochunks.xsl b/docs/xsl/nochunks.xsl
new file mode 100644 (file)
index 0000000..2b10a0d
--- /dev/null
+++ b/docs/xsl/nochunks.xsl
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+    <xsl:output method="html" encoding="UTF-8" indent="no"
+                doctype-public="-//W3C//DTD HTML 4.01 Transitional//EN"
+                doctype-system="http://www.w3.org/TR/html4/loose.dtd"/>
+    <!-- Include default bugzilla XSL -->
+    <xsl:include href="bugzilla-docs.xsl"/>
+    <!-- No other params necessary -->
+</xsl:stylesheet>

diff --git a/docs/xsl/pdf.xsl b/docs/xsl/pdf.xsl
new file mode 100644 (file)
index 0000000..d1febf7
--- /dev/null
+++ b/docs/xsl/pdf.xsl
@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     This Source Code Form is "Incompatible With Secondary Licenses", as
+     defined by the Mozilla Public License, v. 2.0.
+-->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                xmlns:fo="http://www.w3.org/1999/XSL/Format"
+                version="1.0">
+    <!-- Some layout parameters -->
+    <xsl:param name="generate.index" select="0"/>
+    <xsl:param name="doc.collab.show" select="0"/>
+    <xsl:param name="latex.output.revhistory" select="0"/>
+    <xsl:param name="doc.lot.show"></xsl:param>
+    <xsl:param name="latex.encoding">utf8</xsl:param>
+    <xsl:param name="imagedata.default.scale">pagebound</xsl:param>
+    <xsl:param name="latex.hyperparam">colorlinks,linkcolor=blue,urlcolor=blue</xsl:param>
+
+    <!-- Show <ulink>s as footnotes -->
+    <xsl:param name="ulink.footnotes" select="1"/>
+    <xsl:param name="ulink.show" select="1"/>
+
+    <!-- Don't use Graphics -->
+    <xsl:param name="admon.graphics" select="0"/>
+    <xsl:param name="callout.graphics" select="0"/>
+
+    <!-- Make pdflatex shut up about <prompt> and <command> within <programlisting>, -->
+    <!-- see http://dblatex.sourceforge.net/doc/manual/sec-verbatim.html             -->
+    <xsl:template match="prompt|command" mode="latex.programlisting">
+        <xsl:param name="co-tagin" select="'&lt;:'"/>
+        <xsl:param name="rnode" select="/"/>
+        <xsl:param name="probe" select="0"/>
+
+        <xsl:call-template name="verbatim.boldseq">
+            <xsl:with-param name="co-tagin" select="$co-tagin"/>
+            <xsl:with-param name="rnode" select="$rnode"/>
+            <xsl:with-param name="probe" select="$probe"/>
+        </xsl:call-template>
+    </xsl:template>
+</xsl:stylesheet>

diff --git a/duplicates.cgi b/duplicates.cgi
new file mode 100755 (executable)
index 0000000..0196221
--- /dev/null
+++ b/duplicates.cgi
@@ -0,0 +1,247 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Bug;
+use Bugzilla::Field;
+use Bugzilla::Product;
+
+use constant DEFAULTS => {
+    # We want to show bugs which:
+    # a) Aren't CLOSED; and
+    # b)  i) Aren't VERIFIED; OR
+    #    ii) Were resolved INVALID/WONTFIX
+    #
+    # The rationale behind this is that people will eventually stop
+    # reporting fixed bugs when they get newer versions of the software,
+    # but if the bug is determined to be erroneous, people will still
+    # keep reporting it, so we do need to show it here.
+    fully_exclude_status  => ['CLOSED'],
+    partly_exclude_status => ['VERIFIED'],
+    except_resolution => ['INVALID', 'WONTFIX'],
+    changedsince => 7,
+    maxrows      => 20,
+    sortby       => 'count',
+};
+
+###############
+# Subroutines #
+###############
+
+# $counts is a count of exactly how many direct duplicates there are for
+# each bug we're considering. $dups is a map of duplicates, from one
+# bug_id to another. We go through the duplicates map ($dups) and if one bug
+# in $count is a duplicate of another bug in $count, we add their counts
+# together under the target bug.
+sub add_indirect_dups {
+    my ($counts, $dups) = @_;
+
+    foreach my $add_from (keys %$dups) {
+        my $add_to     = walk_dup_chain($dups, $add_from);
+        my $add_amount = delete $counts->{$add_from} || 0;
+        $counts->{$add_to} += $add_amount;
+    }
+}
+
+sub walk_dup_chain {
+    my ($dups, $from_id) = @_;
+    my $to_id = $dups->{$from_id};
+    my %seen;
+    while (my $bug_id = $dups->{$to_id}) {
+        if ($seen{$bug_id}) {
+            warn "Duplicate loop: $to_id -> $bug_id\n";
+            last;
+        }
+        $seen{$bug_id} = 1;
+        $to_id = $bug_id;
+    }
+    # Optimize for future calls to add_indirect_dups.
+    $dups->{$from_id} = $to_id;
+    return $to_id;
+}
+
+# Get params from URL
+sub formvalue {
+    my ($name) = (@_);
+    my $cgi = Bugzilla->cgi;
+    if (defined $cgi->param($name)) {
+        return $cgi->param($name);
+    }
+    elsif (exists DEFAULTS->{$name}) {
+        return ref DEFAULTS->{$name} ? @{ DEFAULTS->{$name} } 
+                                     : DEFAULTS->{$name};
+    }
+    return undef;
+}
+
+sub sort_duplicates {
+    my ($a, $b, $sort_by) = @_;
+    if ($sort_by eq 'count' or $sort_by eq 'delta') {
+        return $a->{$sort_by} <=> $b->{$sort_by};
+    }
+    if ($sort_by =~ /^(bug_)?id$/) {
+        return $a->{'bug'}->$sort_by <=> $b->{'bug'}->$sort_by;
+    }
+    return $a->{'bug'}->$sort_by cmp $b->{'bug'}->$sort_by;
+    
+}
+
+###############
+# Main Script #
+###############
+
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $user = Bugzilla->login();
+
+my $dbh = Bugzilla->switch_to_shadow_db();
+
+my $changedsince = formvalue("changedsince");
+my $maxrows = formvalue("maxrows");
+my $openonly = formvalue("openonly");
+my $sortby = formvalue("sortby");
+if (!grep(lc($_) eq lc($sortby), qw(count delta id))) {
+    Bugzilla::Field->check($sortby);
+}
+my $reverse = formvalue("reverse");
+# Reverse count and delta by default.
+if (!defined $reverse) {
+    if ($sortby eq 'count' or $sortby eq 'delta') {
+        $reverse = 1;
+    }
+    else {
+        $reverse = 0;
+    }
+}
+my @query_products = $cgi->param('product');
+my $sortvisible = formvalue("sortvisible");
+my @bugs;
+if ($sortvisible) {
+    my @limit_to_ids = (split(/[:,]/, formvalue("bug_id") || ''));
+    @bugs = @{ Bugzilla::Bug->new_from_list(\@limit_to_ids) };
+    @bugs = @{ $user->visible_bugs(\@bugs) };
+}
+
+# Make sure all products are valid.
+@query_products = map { Bugzilla::Product->check($_) } @query_products;
+
+# Small backwards-compatibility hack, dated 2002-04-10.
+$sortby = "count" if $sortby eq "dup_count";
+
+my $origmaxrows = $maxrows;
+detaint_natural($maxrows)
+  || ThrowUserError("invalid_maxrows", { maxrows => $origmaxrows});
+
+my $origchangedsince = $changedsince;
+detaint_natural($changedsince)
+  || ThrowUserError("invalid_changedsince", 
+                    { changedsince => $origchangedsince });
+
+my %total_dups = @{$dbh->selectcol_arrayref(
+    "SELECT dupe_of, COUNT(dupe)
+       FROM duplicates
+   GROUP BY dupe_of", {Columns => [1,2]})};
+
+my %dupe_relation = @{$dbh->selectcol_arrayref(
+    "SELECT dupe, dupe_of FROM duplicates
+      WHERE dupe IN (SELECT dupe_of FROM duplicates)",
+    {Columns => [1,2]})};
+add_indirect_dups(\%total_dups, \%dupe_relation);
+
+my $reso_field_id = get_field_id('resolution');
+my %since_dups = @{$dbh->selectcol_arrayref(
+    "SELECT dupe_of, COUNT(dupe)
+       FROM duplicates INNER JOIN bugs_activity 
+                       ON bugs_activity.bug_id = duplicates.dupe 
+      WHERE added = 'DUPLICATE' AND fieldid = ? 
+            AND bug_when >= "
+                . $dbh->sql_date_math('LOCALTIMESTAMP(0)', '-', '?', 'DAY') .
+ " GROUP BY dupe_of", {Columns=>[1,2]},
+    $reso_field_id, $changedsince)};
+add_indirect_dups(\%since_dups, \%dupe_relation);
+
+# Enforce the mostfreqthreshold parameter and the "bug_id" cgi param.
+my $mostfreq = Bugzilla->params->{'mostfreqthreshold'};
+foreach my $id (keys %total_dups) {
+    if ($total_dups{$id} < $mostfreq) {
+        delete $total_dups{$id};
+        next;
+    }
+    if ($sortvisible and !grep($_->id == $id, @bugs)) {
+        delete $total_dups{$id};
+    }
+}
+
+if (!@bugs) {
+    @bugs = @{ Bugzilla::Bug->new_from_list([keys %total_dups]) };
+    @bugs = @{ $user->visible_bugs(\@bugs) };
+}
+
+my @fully_exclude_status = formvalue('fully_exclude_status');
+my @partly_exclude_status = formvalue('partly_exclude_status');
+my @except_resolution = formvalue('except_resolution');
+
+# Filter bugs by criteria
+my @result_bugs;
+foreach my $bug (@bugs) {
+    # It's possible, if somebody specified a bug ID that wasn't a dup
+    # in the "buglist" parameter and specified $sortvisible that there
+    # would be bugs in the list with 0 dups, so we want to avoid that.
+    next if !$total_dups{$bug->id};
+
+    next if ($openonly and !$bug->isopened);
+    # If the bug has a status in @fully_exclude_status, we skip it,
+    # no question.
+    next if grep($_ eq $bug->bug_status, @fully_exclude_status);
+    # If the bug has a status in @partly_exclude_status, we skip it...
+    if (grep($_ eq $bug->bug_status, @partly_exclude_status)) {
+        # ...unless it has a resolution in @except_resolution.
+        next if !grep($_ eq $bug->resolution, @except_resolution);
+    }
+
+    if (scalar @query_products) {
+        next if !grep($_->id == $bug->product_id, @query_products);
+    }
+
+    # Note: maximum row count is dealt with later.
+    push (@result_bugs, { bug => $bug,
+                          count => $total_dups{$bug->id},
+                          delta => $since_dups{$bug->id} || 0 });
+}
+@bugs = @result_bugs;
+@bugs = sort { sort_duplicates($a, $b, $sortby) } @bugs;
+if ($reverse) {
+    @bugs = reverse @bugs;
+}
+@bugs = @bugs[0..$maxrows-1] if scalar(@bugs) > $maxrows;
+
+my %vars = (
+    bugs     => \@bugs,
+    bug_ids  => [map { $_->{'bug'}->id } @bugs],
+    sortby   => $sortby,
+    openonly => $openonly,
+    maxrows  => $maxrows,
+    reverse  => $reverse,
+    format   => scalar $cgi->param('format'),
+    product  => [map { $_->name } @query_products],
+    sortvisible  => $sortvisible,
+    changedsince => $changedsince,
+);
+
+my $format = $template->get_format("reports/duplicates", $vars{'format'});
+print $cgi->header;
+
+# Generate and return the UI (HTML page) from the appropriate template.
+$template->process($format->{'template'}, \%vars)
+  || ThrowTemplateError($template->error());

diff --git a/editclassifications.cgi b/editclassifications.cgi
new file mode 100755 (executable)
index 0000000..3a2647a
--- /dev/null
+++ b/editclassifications.cgi
@@ -0,0 +1,225 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Classification;
+use Bugzilla::Token;
+
+my $dbh = Bugzilla->dbh;
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+local our $vars = {};
+
+sub LoadTemplate {
+    my $action = shift;
+    my $cgi = Bugzilla->cgi;
+    my $template = Bugzilla->template;
+
+    $vars->{'classifications'} = [Bugzilla::Classification->get_all]
+      if ($action eq 'select');
+    # There is currently only one section about classifications,
+    # so all pages point to it. Let's define it here.
+    $vars->{'doc_section'} = 'classifications.html';
+
+    $action =~ /(\w+)/;
+    $action = $1;
+    print $cgi->header();
+    $template->process("admin/classifications/$action.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# Preliminary checks:
+#
+
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+print $cgi->header();
+
+$user->in_group('editclassifications')
+  || ThrowUserError("auth_failure", {group  => "editclassifications",
+                                     action => "edit",
+                                     object => "classifications"});
+
+ThrowUserError("auth_classification_not_enabled") 
+    unless Bugzilla->params->{"useclassification"};
+
+#
+# often used variables
+#
+my $action     = trim($cgi->param('action')         || '');
+my $class_name = trim($cgi->param('classification') || '');
+my $token      = $cgi->param('token');
+
+#
+# action='' -> Show nice list of classifications
+#
+LoadTemplate('select') unless $action;
+
+#
+# action='add' -> present form for parameters for new classification
+#
+# (next action will be 'new')
+#
+
+if ($action eq 'add') {
+    $vars->{'token'} = issue_session_token('add_classification');
+    LoadTemplate($action);
+}
+
+#
+# action='new' -> add classification entered in the 'action=add' screen
+#
+
+if ($action eq 'new') {
+    check_token_data($token, 'add_classification');
+
+    my $classification =
+      Bugzilla::Classification->create({name        => $class_name,
+                                        description => scalar $cgi->param('description'),
+                                        sortkey     => scalar $cgi->param('sortkey')});
+
+    delete_token($token);
+
+    $vars->{'message'} = 'classification_created';
+    $vars->{'classification'} = $classification;
+    $vars->{'classifications'} = [Bugzilla::Classification->get_all];
+    $vars->{'token'} = issue_session_token('reclassify_classifications');
+    LoadTemplate('reclassify');
+}
+
+#
+# action='del' -> ask if user really wants to delete
+#
+# (next action would be 'delete')
+#
+
+if ($action eq 'del') {
+
+    my $classification = Bugzilla::Classification->check($class_name);
+
+    if ($classification->id == 1) {
+        ThrowUserError("classification_not_deletable");
+    }
+
+    if ($classification->product_count()) {
+        ThrowUserError("classification_has_products");
+    }
+
+    $vars->{'classification'} = $classification;
+    $vars->{'token'} = issue_session_token('delete_classification');
+
+    LoadTemplate($action);
+}
+
+#
+# action='delete' -> really delete the classification
+#
+
+if ($action eq 'delete') {
+    check_token_data($token, 'delete_classification');
+
+    my $classification = Bugzilla::Classification->check($class_name);
+    $classification->remove_from_db;
+    delete_token($token);
+
+    $vars->{'message'} = 'classification_deleted';
+    $vars->{'classification'} = $classification;
+    LoadTemplate('select');
+}
+
+#
+# action='edit' -> present the edit classifications from
+#
+# (next action would be 'update')
+#
+
+if ($action eq 'edit') {
+    my $classification = Bugzilla::Classification->check($class_name);
+
+    $vars->{'classification'} = $classification;
+    $vars->{'token'} = issue_session_token('edit_classification');
+
+    LoadTemplate($action);
+}
+
+#
+# action='update' -> update the classification
+#
+
+if ($action eq 'update') {
+    check_token_data($token, 'edit_classification');
+
+    my $class_old_name = trim($cgi->param('classificationold') || '');
+    my $classification = Bugzilla::Classification->check($class_old_name);
+
+    $classification->set_all({
+        name        => $class_name,
+        description => scalar $cgi->param('description'),
+        sortkey     => scalar $cgi->param('sortkey'),
+    });
+
+    my $changes = $classification->update;
+    delete_token($token);
+
+    $vars->{'message'} = 'classification_updated';
+    $vars->{'classification'} = $classification;
+    $vars->{'changes'} = $changes;
+    LoadTemplate('select');
+}
+
+#
+# action='reclassify' -> reclassify products for the classification
+#
+
+if ($action eq 'reclassify') {
+    my $classification = Bugzilla::Classification->check($class_name);
+   
+    my $sth = $dbh->prepare("UPDATE products SET classification_id = ?
+                             WHERE name = ?");
+
+    if (defined $cgi->param('add_products')) {
+        check_token_data($token, 'reclassify_classifications');
+        if (defined $cgi->param('prodlist')) {
+            foreach my $prod ($cgi->param("prodlist")) {
+                trick_taint($prod);
+                $sth->execute($classification->id, $prod);
+            }
+        }
+        delete_token($token);
+    } elsif (defined $cgi->param('remove_products')) {
+        check_token_data($token, 'reclassify_classifications');
+        if (defined $cgi->param('myprodlist')) {
+            foreach my $prod ($cgi->param("myprodlist")) {
+                trick_taint($prod);
+                $sth->execute(1,$prod);
+            }
+        }
+        delete_token($token);
+    }
+
+    $vars->{'classifications'} = [Bugzilla::Classification->get_all];
+    $vars->{'classification'} = $classification;
+    $vars->{'token'} = issue_session_token('reclassify_classifications');
+
+    LoadTemplate($action);
+}
+
+#
+# No valid action found
+#
+
+ThrowUserError('unknown_action', {action => $action});

diff --git a/editcomponents.cgi b/editcomponents.cgi
new file mode 100755 (executable)
index 0000000..7ff1dae
--- /dev/null
+++ b/editcomponents.cgi
@@ -0,0 +1,242 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::User;
+use Bugzilla::Component;
+use Bugzilla::Token;
+
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $vars = {};
+# There is only one section about components in the documentation,
+# so all actions point to the same page.
+$vars->{'doc_section'} = 'components.html';
+
+#
+# Preliminary checks:
+#
+
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+print $cgi->header();
+
+$user->in_group('editcomponents')
+  || scalar(@{$user->get_products_by_permission('editcomponents')})
+  || ThrowUserError("auth_failure", {group  => "editcomponents",
+                                     action => "edit",
+                                     object => "components"});
+
+#
+# often used variables
+#
+my $product_name  = trim($cgi->param('product')     || '');
+my $comp_name     = trim($cgi->param('component')   || '');
+my $action        = trim($cgi->param('action')      || '');
+my $showbugcounts = (defined $cgi->param('showbugcounts'));
+my $token         = $cgi->param('token');
+
+#
+# product = '' -> Show nice list of products
+#
+
+unless ($product_name) {
+    my $selectable_products = $user->get_selectable_products;
+    # If the user has editcomponents privs for some products only,
+    # we have to restrict the list of products to display.
+    unless ($user->in_group('editcomponents')) {
+        $selectable_products = $user->get_products_by_permission('editcomponents');
+    }
+    $vars->{'products'} = $selectable_products;
+    $vars->{'showbugcounts'} = $showbugcounts;
+
+    $template->process("admin/components/select-product.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+my $product = $user->check_can_admin_product($product_name);
+
+#
+# action='' -> Show nice list of components
+#
+
+unless ($action) {
+    $vars->{'showbugcounts'} = $showbugcounts;
+    $vars->{'product'} = $product;
+    $template->process("admin/components/list.html.tmpl", $vars)
+        || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='add' -> present form for parameters for new component
+#
+# (next action will be 'new')
+#
+
+if ($action eq 'add') {
+    $vars->{'token'} = issue_session_token('add_component');
+    $vars->{'product'} = $product;
+    $template->process("admin/components/create.html.tmpl", $vars)
+        || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='new' -> add component entered in the 'action=add' screen
+#
+
+if ($action eq 'new') {
+    check_token_data($token, 'add_component');
+    # Do the user matching
+    Bugzilla::User::match_field ({
+        'initialowner'     => { 'type' => 'single' },
+        'initialqacontact' => { 'type' => 'single' },
+        'initialcc'        => { 'type' => 'multi'  },
+    });
+
+    my $default_assignee   = trim($cgi->param('initialowner')     || '');
+    my $default_qa_contact = trim($cgi->param('initialqacontact') || '');
+    my $description        = trim($cgi->param('description')      || '');
+    my @initial_cc         = $cgi->param('initialcc');
+    my $isactive           = $cgi->param('isactive');
+
+    my $component = Bugzilla::Component->create({
+        name             => $comp_name,
+        product          => $product,
+        description      => $description,
+        initialowner     => $default_assignee,
+        initialqacontact => $default_qa_contact,
+        initial_cc       => \@initial_cc,
+        # XXX We should not be creating series for products that we
+        # didn't create series for.
+        create_series    => 1,
+   });
+
+    $vars->{'message'} = 'component_created';
+    $vars->{'comp'} = $component;
+    $vars->{'product'} = $product;
+    delete_token($token);
+
+    $template->process("admin/components/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='del' -> ask if user really wants to delete
+#
+# (next action would be 'delete')
+#
+
+if ($action eq 'del') {
+    $vars->{'token'} = issue_session_token('delete_component');
+    $vars->{'comp'} =
+      Bugzilla::Component->check({ product => $product, name => $comp_name });
+    $vars->{'product'} = $product;
+
+    $template->process("admin/components/confirm-delete.html.tmpl", $vars)
+        || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='delete' -> really delete the component
+#
+
+if ($action eq 'delete') {
+    check_token_data($token, 'delete_component');
+    my $component =
+        Bugzilla::Component->check({ product => $product, name => $comp_name });
+
+    $component->remove_from_db;
+
+    $vars->{'message'} = 'component_deleted';
+    $vars->{'comp'} = $component;
+    $vars->{'product'} = $product;
+    $vars->{'no_edit_component_link'} = 1;
+    delete_token($token);
+
+    $template->process("admin/components/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='edit' -> present the edit component form
+#
+# (next action would be 'update')
+#
+
+if ($action eq 'edit') {
+    $vars->{'token'} = issue_session_token('edit_component');
+    my $component =
+        Bugzilla::Component->check({ product => $product, name => $comp_name });
+    $vars->{'comp'} = $component;
+
+    $vars->{'initial_cc_names'} = 
+        join(', ', map($_->login, @{$component->initial_cc}));
+
+    $vars->{'product'} = $product;
+
+    $template->process("admin/components/edit.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='update' -> update the component
+#
+
+if ($action eq 'update') {
+    check_token_data($token, 'edit_component');
+    # Do the user matching
+    Bugzilla::User::match_field ({
+        'initialowner'     => { 'type' => 'single' },
+        'initialqacontact' => { 'type' => 'single' },
+        'initialcc'        => { 'type' => 'multi'  },
+    });
+
+    my $comp_old_name         = trim($cgi->param('componentold')     || '');
+    my $default_assignee      = trim($cgi->param('initialowner')     || '');
+    my $default_qa_contact    = trim($cgi->param('initialqacontact') || '');
+    my $description           = trim($cgi->param('description')      || '');
+    my @initial_cc            = $cgi->param('initialcc');
+    my $isactive              = $cgi->param('isactive');
+  
+    my $component =
+        Bugzilla::Component->check({ product => $product, name => $comp_old_name });
+
+    $component->set_name($comp_name);
+    $component->set_description($description);
+    $component->set_default_assignee($default_assignee);
+    $component->set_default_qa_contact($default_qa_contact);
+    $component->set_cc_list(\@initial_cc);
+    $component->set_is_active($isactive);
+    my $changes = $component->update();
+
+    $vars->{'message'} = 'component_updated';
+    $vars->{'comp'} = $component;
+    $vars->{'product'} = $product;
+    $vars->{'changes'} = $changes;
+    delete_token($token);
+
+    $template->process("admin/components/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+# No valid action found
+ThrowUserError('unknown_action', {action => $action});

diff --git a/editfields.cgi b/editfields.cgi
new file mode 100755 (executable)
index 0000000..5d9e053
--- /dev/null
+++ b/editfields.cgi
@@ -0,0 +1,168 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Util;
+use Bugzilla::Field;
+use Bugzilla::Token;
+
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $vars = {};
+
+# Make sure the user is logged in and is an administrator.
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+$user->in_group('admin')
+  || ThrowUserError('auth_failure', {group  => 'admin',
+                                     action => 'edit',
+                                     object => 'custom_fields'});
+
+my $action = trim($cgi->param('action') || '');
+my $token  = $cgi->param('token');
+
+print $cgi->header();
+
+# List all existing custom fields if no action is given.
+if (!$action) {
+    $template->process('admin/custom_fields/list.html.tmpl', $vars)
+        || ThrowTemplateError($template->error());
+}
+# Interface to add a new custom field.
+elsif ($action eq 'add') {
+    $vars->{'token'} = issue_session_token('add_field');
+
+    $template->process('admin/custom_fields/create.html.tmpl', $vars)
+        || ThrowTemplateError($template->error());
+}
+elsif ($action eq 'new') {
+    check_token_data($token, 'add_field');
+    $vars->{'field'} = Bugzilla::Field->create({
+        name        => scalar $cgi->param('name'),
+        description => scalar $cgi->param('desc'),
+        long_desc   => scalar $cgi->param('long_desc'),
+        type        => scalar $cgi->param('type'),
+        sortkey     => scalar $cgi->param('sortkey'),
+        mailhead    => scalar $cgi->param('new_bugmail'),
+        enter_bug   => scalar $cgi->param('enter_bug'),
+        obsolete    => scalar $cgi->param('obsolete'),
+        custom      => 1,
+        buglist     => 1,
+        visibility_field_id => scalar $cgi->param('visibility_field_id'),
+        visibility_values => [ $cgi->param('visibility_values') ],
+        value_field_id => scalar $cgi->param('value_field_id'),
+        reverse_desc => scalar $cgi->param('reverse_desc'),
+        is_mandatory => scalar $cgi->param('is_mandatory'),
+    });
+
+    delete_token($token);
+
+    $vars->{'message'} = 'custom_field_created';
+
+    $template->process('admin/custom_fields/list.html.tmpl', $vars)
+        || ThrowTemplateError($template->error());
+}
+elsif ($action eq 'edit') {
+    my $name = $cgi->param('name') || ThrowUserError('field_missing_name');
+    # Custom field names must start with "cf_".
+    if ($name !~ /^cf_/) {
+        $name = 'cf_' . $name;
+    }
+    my $field = new Bugzilla::Field({'name' => $name});
+    $field || ThrowUserError('customfield_nonexistent', {'name' => $name});
+
+    $vars->{'field'} = $field;
+    $vars->{'token'} = issue_session_token('edit_field');
+
+    $template->process('admin/custom_fields/edit.html.tmpl', $vars)
+        || ThrowTemplateError($template->error());
+}
+elsif ($action eq 'update') {
+    check_token_data($token, 'edit_field');
+    my $name = $cgi->param('name');
+
+    # Validate fields.
+    $name || ThrowUserError('field_missing_name');
+    # Custom field names must start with "cf_".
+    if ($name !~ /^cf_/) {
+        $name = 'cf_' . $name;
+    }
+    my $field = new Bugzilla::Field({'name' => $name});
+    $field || ThrowUserError('customfield_nonexistent', {'name' => $name});
+
+    $field->set_description($cgi->param('desc'));
+    $field->set_long_desc($cgi->param('long_desc'));
+    $field->set_sortkey($cgi->param('sortkey'));
+    $field->set_in_new_bugmail($cgi->param('new_bugmail'));
+    $field->set_enter_bug($cgi->param('enter_bug'));
+    $field->set_obsolete($cgi->param('obsolete'));
+    $field->set_is_mandatory($cgi->param('is_mandatory'));
+    $field->set_visibility_field($cgi->param('visibility_field_id'));
+    $field->set_visibility_values([ $cgi->param('visibility_values') ]);
+    $field->set_value_field($cgi->param('value_field_id'));
+    $field->set_reverse_desc($cgi->param('reverse_desc'));
+    $field->update();
+
+    delete_token($token);
+
+    $vars->{'field'}   = $field;
+    $vars->{'message'} = 'custom_field_updated';
+
+    $template->process('admin/custom_fields/list.html.tmpl', $vars)
+        || ThrowTemplateError($template->error());
+}
+elsif ($action eq 'del') {
+    my $name = $cgi->param('name');
+
+    # Validate field.
+    $name || ThrowUserError('field_missing_name');
+    # Custom field names must start with "cf_".
+    if ($name !~ /^cf_/) {
+        $name = 'cf_' . $name;
+    }
+    my $field = new Bugzilla::Field({'name' => $name});
+    $field || ThrowUserError('customfield_nonexistent', {'name' => $name});
+
+    $vars->{'field'} = $field;
+    $vars->{'token'} = issue_session_token('delete_field');
+
+    $template->process('admin/custom_fields/confirm-delete.html.tmpl', $vars)
+            || ThrowTemplateError($template->error());
+}
+elsif ($action eq 'delete') {
+    check_token_data($token, 'delete_field');
+    my $name = $cgi->param('name');
+
+    # Validate fields.
+    $name || ThrowUserError('field_missing_name');
+    # Custom field names must start with "cf_".
+    if ($name !~ /^cf_/) {
+        $name = 'cf_' . $name;
+    }
+    my $field = new Bugzilla::Field({'name' => $name});
+    $field || ThrowUserError('customfield_nonexistent', {'name' => $name});
+
+    # Calling remove_from_db will check if field can be deleted.
+    # If the field cannot be deleted, it will throw an error.
+    $field->remove_from_db();
+    
+    $vars->{'field'}   = $field;
+    $vars->{'message'} = 'custom_field_deleted';
+    
+    delete_token($token);
+
+    $template->process('admin/custom_fields/list.html.tmpl', $vars)
+        || ThrowTemplateError($template->error());
+}
+else {
+    ThrowUserError('unknown_action', {action => $action});
+}

diff --git a/editflagtypes.cgi b/editflagtypes.cgi
new file mode 100755 (executable)
index 0000000..e9c430d
--- /dev/null
+++ b/editflagtypes.cgi
@@ -0,0 +1,534 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+################################################################################
+# Script Initialization
+################################################################################
+
+# Make it harder for us to do dangerous things in Perl.
+use strict;
+use lib qw(. lib);
+
+# Use Bugzilla's flag modules for handling flag types.
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Flag;
+use Bugzilla::FlagType;
+use Bugzilla::Group;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Product;
+use Bugzilla::Token;
+
+# Make sure the user is logged in and has the right privileges.
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+
+print $cgi->header();
+
+$user->in_group('editcomponents')
+  || scalar(@{$user->get_products_by_permission('editcomponents')})
+  || ThrowUserError("auth_failure", {group  => "editcomponents",
+                                     action => "edit",
+                                     object => "flagtypes"});
+
+# We need this everywhere.
+my $vars = get_products_and_components();
+my @products = @{$vars->{products}};
+
+my $action = $cgi->param('action') || 'list';
+my $token  = $cgi->param('token');
+my $product = $cgi->param('product');
+my $component = $cgi->param('component');
+my $flag_id = $cgi->param('id');
+
+if ($product) {
+    # Make sure the user is allowed to view this product name.
+    # Users with global editcomponents privs can see all product names.
+    ($product) = grep { lc($_->name) eq lc($product) } @products;
+    $product || ThrowUserError('product_access_denied', { name => $cgi->param('product') });
+}
+
+if ($component) {
+    ($product && $product->id)
+      || ThrowUserError('flag_type_component_without_product');
+    ($component) = grep { lc($_->name) eq lc($component) } @{$product->components};
+    $component || ThrowUserError('product_unknown_component', { product => $product->name,
+                                                                comp => $cgi->param('component') });
+}
+
+# If 'categoryAction' is set, it has priority over 'action'.
+if (my ($category_action) = grep { $_ =~ /^categoryAction-(?:\w+)$/ } $cgi->param()) {
+    $category_action =~ s/^categoryAction-//;
+
+    my @inclusions = $cgi->param('inclusions');
+    my @exclusions = $cgi->param('exclusions');
+    my @categories;
+    if ($category_action =~ /^(in|ex)clude$/) {
+        if (!$user->in_group('editcomponents') && !$product) {
+            # The user can only add the flag type to products he can administrate.
+            foreach my $prod (@products) {
+                push(@categories, $prod->id . ':0')
+            }
+        }
+        else {
+            my $category = ($product ? $product->id : 0) . ':' .
+                           ($component ? $component->id : 0);
+            push(@categories, $category);
+        }
+    }
+
+    if ($category_action eq 'include') {
+        foreach my $category (@categories) {
+            push(@inclusions, $category) unless grep($_ eq $category, @inclusions);
+        }
+    }
+    elsif ($category_action eq 'exclude') {
+        foreach my $category (@categories) {
+            push(@exclusions, $category) unless grep($_ eq $category, @exclusions);
+        }
+    }
+    elsif ($category_action eq 'removeInclusion') {
+        my @inclusion_to_remove = $cgi->param('inclusion_to_remove');
+        foreach my $remove (@inclusion_to_remove) {
+            @inclusions = grep { $_ ne $remove } @inclusions;
+        }
+    }
+    elsif ($category_action eq 'removeExclusion') {
+        my @exclusion_to_remove = $cgi->param('exclusion_to_remove');
+        foreach my $remove (@exclusion_to_remove) {
+            @exclusions = grep { $_ ne $remove } @exclusions;
+        }
+    }
+
+    $vars->{'groups'} = get_settable_groups();
+    $vars->{'action'} = $action;
+
+    my $type = {};
+    $type->{$_} = $cgi->param($_) foreach $cgi->param();
+    # Make sure boolean fields are defined, else they fall back to 1.
+    foreach my $boolean (qw(is_active is_requestable is_requesteeble is_multiplicable)) {
+        $type->{$boolean} ||= 0;
+    }
+
+    # That's what I call a big hack. The template expects to see a group object.
+    $type->{'grant_group'} = {};
+    $type->{'grant_group'}->{'name'} = $cgi->param('grant_group');
+    $type->{'request_group'} = {};
+    $type->{'request_group'}->{'name'} = $cgi->param('request_group');
+
+    $vars->{'inclusions'} = clusion_array_to_hash(\@inclusions, \@products);
+    $vars->{'exclusions'} = clusion_array_to_hash(\@exclusions, \@products);
+
+    $vars->{'type'} = $type;
+    $vars->{'token'} = $token;
+    $vars->{'check_clusions'} = 1;
+    $vars->{'can_fully_edit'} = $cgi->param('can_fully_edit');
+
+    $template->process("admin/flag-type/edit.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+if ($action eq 'list') {
+    my $product_id = $product ? $product->id : 0;
+    my $component_id = $component ? $component->id : 0;
+    my $show_flag_counts = $cgi->param('show_flag_counts') ? 1 : 0;
+    my $group_id = $cgi->param('group');
+    if ($group_id) {
+        detaint_natural($group_id) || ThrowUserError('invalid_group_ID');
+    }
+
+    my $bug_flagtypes;
+    my $attach_flagtypes;
+
+    # If a component is given, restrict the list to flag types available
+    # for this component.
+    if ($component) {
+        $bug_flagtypes = $component->flag_types->{'bug'};
+        $attach_flagtypes = $component->flag_types->{'attachment'};
+
+        # Filter flag types if a group ID is given.
+        $bug_flagtypes = filter_group($bug_flagtypes, $group_id);
+        $attach_flagtypes = filter_group($attach_flagtypes, $group_id);
+
+    }
+    # If only a product is specified but no component, then restrict the list
+    # to flag types available in at least one component of that product.
+    elsif ($product) {
+        $bug_flagtypes = $product->flag_types->{'bug'};
+        $attach_flagtypes = $product->flag_types->{'attachment'};
+
+        # Filter flag types if a group ID is given.
+        $bug_flagtypes = filter_group($bug_flagtypes, $group_id);
+        $attach_flagtypes = filter_group($attach_flagtypes, $group_id);
+    }
+    # If no product is given, then show all flag types available.
+    else {
+        my $flagtypes = get_editable_flagtypes(\@products, $group_id);
+        $bug_flagtypes = [grep { $_->target_type eq 'bug' } @$flagtypes];
+        $attach_flagtypes = [grep { $_->target_type eq 'attachment' } @$flagtypes];
+    }
+
+    if ($show_flag_counts) {
+        my %bug_lists;
+        my %map = ('+' => 'granted', '-' => 'denied', '?' => 'pending');
+
+        foreach my $flagtype (@$bug_flagtypes, @$attach_flagtypes) {
+            $bug_lists{$flagtype->id} = {};
+            my $flags = Bugzilla::Flag->match({type_id => $flagtype->id});
+            # Build lists of bugs, triaged by flag status.
+            push(@{$bug_lists{$flagtype->id}->{$map{$_->status}}}, $_->bug_id) foreach @$flags;
+        }
+        $vars->{'bug_lists'} = \%bug_lists;
+        $vars->{'show_flag_counts'} = 1;
+    }
+
+    $vars->{'selected_product'} = $product ? $product->name : '';
+    $vars->{'selected_component'} = $component ? $component->name : '';
+    $vars->{'bug_types'} = $bug_flagtypes;
+    $vars->{'attachment_types'} = $attach_flagtypes;
+
+    $template->process("admin/flag-type/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+if ($action eq 'enter') {
+    my $type = $cgi->param('target_type');
+    ($type eq 'bug' || $type eq 'attachment')
+      || ThrowCodeError('flag_type_target_type_invalid', { target_type => $type });
+
+    $vars->{'action'} = 'insert';
+    $vars->{'token'} = issue_session_token('add_flagtype');
+    $vars->{'type'} = { 'target_type' => $type };
+    # Only users with global editcomponents privs can add a flagtype
+    # to all products.
+    $vars->{'inclusions'} = { '__Any__:__Any__' => '0:0' }
+      if $user->in_group('editcomponents');
+    $vars->{'can_fully_edit'} = 1;
+    # Get a list of groups available to restrict this flag type against.
+    $vars->{'groups'} = get_settable_groups();
+
+    $template->process("admin/flag-type/edit.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+if ($action eq 'edit' || $action eq 'copy') {
+    my ($flagtype, $can_fully_edit) = $user->check_can_admin_flagtype($flag_id);
+    $vars->{'type'} = $flagtype;
+    $vars->{'can_fully_edit'} = $can_fully_edit;
+
+    if ($user->in_group('editcomponents')) {
+        $vars->{'inclusions'} = $flagtype->inclusions;
+        $vars->{'exclusions'} = $flagtype->exclusions;
+    }
+    else {
+        # Filter products the user shouldn't know about.
+        $vars->{'inclusions'} = clusion_array_to_hash([values %{$flagtype->inclusions}], \@products);
+        $vars->{'exclusions'} = clusion_array_to_hash([values %{$flagtype->exclusions}], \@products);
+    }
+
+    if ($action eq 'copy') {
+        $vars->{'action'} = "insert";
+        $vars->{'token'} = issue_session_token('add_flagtype');
+    }
+    else { 
+        $vars->{'action'} = "update";
+        $vars->{'token'} = issue_session_token('edit_flagtype');
+    }
+
+    # Get a list of groups available to restrict this flag type against.
+    $vars->{'groups'} = get_settable_groups();
+
+    $template->process("admin/flag-type/edit.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+if ($action eq 'insert') {
+    check_token_data($token, 'add_flagtype');
+
+    my $name             = $cgi->param('name');
+    my $description      = $cgi->param('description');
+    my $target_type      = $cgi->param('target_type');
+    my $cc_list          = $cgi->param('cc_list');
+    my $sortkey          = $cgi->param('sortkey');
+    my $is_active        = $cgi->param('is_active');
+    my $is_requestable   = $cgi->param('is_requestable');
+    my $is_specifically  = $cgi->param('is_requesteeble');
+    my $is_multiplicable = $cgi->param('is_multiplicable');
+    my $grant_group      = $cgi->param('grant_group');
+    my $request_group    = $cgi->param('request_group');
+    my @inclusions       = $cgi->param('inclusions');
+    my @exclusions       = $cgi->param('exclusions');
+
+    # Filter inclusion and exclusion lists to products the user can see.
+    unless ($user->in_group('editcomponents')) {
+        @inclusions = values %{clusion_array_to_hash(\@inclusions, \@products)};
+        @exclusions = values %{clusion_array_to_hash(\@exclusions, \@products)};
+    }
+
+    my $flagtype = Bugzilla::FlagType->create({
+        name        => $name,
+        description => $description,
+        target_type => $target_type,
+        cc_list     => $cc_list,
+        sortkey     => $sortkey,
+        is_active   => $is_active,
+        is_requestable   => $is_requestable,
+        is_requesteeble  => $is_specifically,
+        is_multiplicable => $is_multiplicable,
+        grant_group      => $grant_group,
+        request_group    => $request_group,
+        inclusions       => \@inclusions,
+        exclusions       => \@exclusions
+    });
+
+    delete_token($token);
+
+    $vars->{'name'} = $flagtype->name;
+    $vars->{'message'} = "flag_type_created";
+
+    my $flagtypes = get_editable_flagtypes(\@products);
+    $vars->{'bug_types'} = [grep { $_->target_type eq 'bug' } @$flagtypes];
+    $vars->{'attachment_types'} = [grep { $_->target_type eq 'attachment' } @$flagtypes];
+
+    $template->process("admin/flag-type/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+if ($action eq 'update') {
+    check_token_data($token, 'edit_flagtype');
+
+    my $name             = $cgi->param('name');
+    my $description      = $cgi->param('description');
+    my $cc_list          = $cgi->param('cc_list');
+    my $sortkey          = $cgi->param('sortkey');
+    my $is_active        = $cgi->param('is_active');
+    my $is_requestable   = $cgi->param('is_requestable');
+    my $is_specifically  = $cgi->param('is_requesteeble');
+    my $is_multiplicable = $cgi->param('is_multiplicable');
+    my $grant_group      = $cgi->param('grant_group');
+    my $request_group    = $cgi->param('request_group');
+    my @inclusions       = $cgi->param('inclusions');
+    my @exclusions       = $cgi->param('exclusions');
+
+    my ($flagtype, $can_fully_edit) = $user->check_can_admin_flagtype($flag_id);
+    if ($cgi->param('check_clusions') && !$user->in_group('editcomponents')) {
+        # Filter inclusion and exclusion lists to products the user can edit.
+        @inclusions = values %{clusion_array_to_hash(\@inclusions, \@products)};
+        @exclusions = values %{clusion_array_to_hash(\@exclusions, \@products)};
+        # Bring back the products the user cannot edit.
+        foreach my $item (values %{$flagtype->inclusions}) {
+            my ($prod_id, $comp_id) = split(':', $item);
+            push(@inclusions, $item) unless grep { $_->id == $prod_id } @products;
+        }
+        foreach my $item (values %{$flagtype->exclusions}) {
+            my ($prod_id, $comp_id) = split(':', $item);
+            push(@exclusions, $item) unless grep { $_->id == $prod_id } @products;
+        }
+    }
+
+    if ($can_fully_edit) {
+        $flagtype->set_name($name);
+        $flagtype->set_description($description);
+        $flagtype->set_cc_list($cc_list);
+        $flagtype->set_sortkey($sortkey);
+        $flagtype->set_is_active($is_active);
+        $flagtype->set_is_requestable($is_requestable);
+        $flagtype->set_is_specifically_requestable($is_specifically);
+        $flagtype->set_is_multiplicable($is_multiplicable);
+        $flagtype->set_grant_group($grant_group);
+        $flagtype->set_request_group($request_group);
+    }
+    $flagtype->set_clusions({ inclusions => \@inclusions, exclusions => \@exclusions})
+      if $cgi->param('check_clusions');
+    my $changes = $flagtype->update();
+
+    delete_token($token);
+
+    $vars->{'flagtype'} = $flagtype;
+    $vars->{'changes'} = $changes;
+    $vars->{'message'} = 'flag_type_updated';
+
+    my $flagtypes = get_editable_flagtypes(\@products);
+    $vars->{'bug_types'} = [grep { $_->target_type eq 'bug' } @$flagtypes];
+    $vars->{'attachment_types'} = [grep { $_->target_type eq 'attachment' } @$flagtypes];
+
+    $template->process("admin/flag-type/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+if ($action eq 'confirmdelete') {
+    my ($flagtype, $can_fully_edit) = $user->check_can_admin_flagtype($flag_id);
+    ThrowUserError('flag_type_cannot_delete', { flagtype => $flagtype }) unless $can_fully_edit;
+
+    $vars->{'flag_type'} = $flagtype;
+    $vars->{'token'} = issue_session_token('delete_flagtype');
+
+    $template->process("admin/flag-type/confirm-delete.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+if ($action eq 'delete') {
+    check_token_data($token, 'delete_flagtype');
+
+    my ($flagtype, $can_fully_edit) = $user->check_can_admin_flagtype($flag_id);
+    ThrowUserError('flag_type_cannot_delete', { flagtype => $flagtype }) unless $can_fully_edit;
+
+    $flagtype->remove_from_db();
+
+    delete_token($token);
+
+    $vars->{'name'} = $flagtype->name;
+    $vars->{'message'} = "flag_type_deleted";
+
+    my @flagtypes = Bugzilla::FlagType->get_all;
+    $vars->{'bug_types'} = [grep { $_->target_type eq 'bug' } @flagtypes];
+    $vars->{'attachment_types'} = [grep { $_->target_type eq 'attachment' } @flagtypes];
+
+    $template->process("admin/flag-type/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+if ($action eq 'deactivate') {
+    check_token_data($token, 'delete_flagtype');
+
+    my ($flagtype, $can_fully_edit) = $user->check_can_admin_flagtype($flag_id);
+    ThrowUserError('flag_type_cannot_deactivate', { flagtype => $flagtype }) unless $can_fully_edit;
+
+    $flagtype->set_is_active(0);
+    $flagtype->update();
+
+    delete_token($token);
+
+    $vars->{'message'} = "flag_type_deactivated";
+    $vars->{'flag_type'} = $flagtype;
+
+    my @flagtypes = Bugzilla::FlagType->get_all;
+    $vars->{'bug_types'} = [grep { $_->target_type eq 'bug' } @flagtypes];
+    $vars->{'attachment_types'} = [grep { $_->target_type eq 'attachment' } @flagtypes];
+
+    $template->process("admin/flag-type/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+ThrowUserError('unknown_action', {action => $action});
+
+#####################
+# Helper subroutines
+#####################
+
+sub get_products_and_components {
+    my $vars = {};
+    my $user = Bugzilla->user;
+
+    my @products;
+    if ($user->in_group('editcomponents')) {
+        @products = Bugzilla::Product->get_all;
+    }
+    else {
+        @products = @{$user->get_products_by_permission('editcomponents')};
+    }
+    # We require all unique component names.
+    my %components;
+    foreach my $product (@products) {
+        foreach my $component (@{$product->components}) {
+            $components{$component->name} = 1;
+        }
+    }
+    $vars->{'products'} = \@products;
+    $vars->{'components'} = [sort(keys %components)];
+    return $vars;
+}
+
+sub get_editable_flagtypes {
+    my ($products, $group_id) = @_;
+    my $flagtypes;
+
+    if (Bugzilla->user->in_group('editcomponents')) {
+        $flagtypes = Bugzilla::FlagType::match({ group => $group_id });
+        return $flagtypes;
+    }
+
+    my %visible_flagtypes;
+    foreach my $product (@$products) {
+        foreach my $target ('bug', 'attachment') {
+            my $prod_flagtypes = $product->flag_types->{$target};
+            $visible_flagtypes{$_->id} ||= $_ foreach @$prod_flagtypes;
+        }
+    }
+    @$flagtypes = sort { $a->sortkey <=> $b->sortkey || $a->name cmp $b->name }
+                    values %visible_flagtypes;
+    # Filter flag types if a group ID is given.
+    $flagtypes = filter_group($flagtypes, $group_id);
+    return $flagtypes;
+}
+
+sub get_settable_groups {
+    my $user = Bugzilla->user;
+    my $groups = $user->in_group('editcomponents') ? [Bugzilla::Group->get_all] : $user->groups;
+    return $groups;
+}
+
+sub filter_group {
+    my ($flag_types, $gid) = @_;
+    return $flag_types unless $gid;
+
+    my @flag_types = grep {($_->grant_group && $_->grant_group->id == $gid)
+                           || ($_->request_group && $_->request_group->id == $gid)} @$flag_types;
+
+    return \@flag_types;
+}
+
+# Convert the array @clusions('prod_ID:comp_ID') back to a hash of
+# the form %clusions{'prod_name:comp_name'} = 'prod_ID:comp_ID'
+sub clusion_array_to_hash {
+    my ($array, $visible_products) = @_;
+    my $user = Bugzilla->user;
+    my $has_privs = $user->in_group('editcomponents');
+
+    my %hash;
+    my %products;
+    my %components;
+
+    foreach my $ids (@$array) {
+        my ($product_id, $component_id) = split(":", $ids);
+        my $product_name = "__Any__";
+        my $component_name = "__Any__";
+
+        if ($product_id) {
+            ($products{$product_id}) = grep { $_->id == $product_id } @$visible_products;
+            next unless $products{$product_id};
+            $product_name = $products{$product_id}->name;
+
+            if ($component_id) {
+                ($components{$component_id}) =
+                  grep { $_->id == $component_id } @{$products{$product_id}->components};
+                next unless $components{$component_id};
+                $component_name = $components{$component_id}->name;
+            }
+        }
+        else {
+            # Users with local editcomponents privs cannot use __Any__:__Any__.
+            next unless $has_privs;
+            # It's illegal to select a component without a product.
+            next if $component_id;
+        }
+        $hash{"$product_name:$component_name"} = $ids;
+    }
+    return \%hash;
+}

diff --git a/editgroups.cgi b/editgroups.cgi
new file mode 100755 (executable)
index 0000000..d603ab1
--- /dev/null
+++ b/editgroups.cgi
@@ -0,0 +1,454 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Config qw(:admin);
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Group;
+use Bugzilla::Product;
+use Bugzilla::User;
+use Bugzilla::Token;
+
+use constant SPECIAL_GROUPS => ('chartgroup', 'insidergroup',
+                                'timetrackinggroup', 'querysharegroup');
+
+my $cgi = Bugzilla->cgi;
+my $dbh = Bugzilla->dbh;
+my $template = Bugzilla->template;
+my $vars = {};
+
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+print $cgi->header();
+
+$user->in_group('creategroups')
+  || ThrowUserError("auth_failure", {group  => "creategroups",
+                                     action => "edit",
+                                     object => "groups"});
+
+my $action = trim($cgi->param('action') || '');
+my $token  = $cgi->param('token');
+
+# CheckGroupID checks that a positive integer is given and is
+# actually a valid group ID. If all tests are successful, the
+# trimmed group ID is returned.
+
+sub CheckGroupID {
+    my ($group_id) = @_;
+    $group_id = trim($group_id || 0);
+    ThrowUserError("group_not_specified") unless $group_id;
+    (detaint_natural($group_id)
+      && Bugzilla->dbh->selectrow_array("SELECT id FROM groups WHERE id = ?",
+                                        undef, $group_id))
+      || ThrowUserError("invalid_group_ID");
+    return $group_id;
+}
+
+# CheckGroupRegexp checks that the regular expression is valid
+# (the regular expression being optional, the test is successful
+# if none is given, as expected). The trimmed regular expression
+# is returned.
+
+sub CheckGroupRegexp {
+    my ($regexp) = @_;
+    $regexp = trim($regexp || '');
+    trick_taint($regexp);
+    ThrowUserError("invalid_regexp") unless (eval {qr/$regexp/});
+    return $regexp;
+}
+
+# A helper for displaying the edit.html.tmpl template.
+sub get_current_and_available {
+    my ($group, $vars) = @_;
+
+    my @all_groups         = Bugzilla::Group->get_all;
+    my @members_current    = @{$group->grant_direct(GROUP_MEMBERSHIP)};
+    my @member_of_current  = @{$group->granted_by_direct(GROUP_MEMBERSHIP)};
+    my @bless_from_current = @{$group->grant_direct(GROUP_BLESS)};
+    my @bless_to_current   = @{$group->granted_by_direct(GROUP_BLESS)};
+    my (@visible_from_current, @visible_to_me_current);
+    if (Bugzilla->params->{'usevisibilitygroups'}) {
+        @visible_from_current  = @{$group->grant_direct(GROUP_VISIBLE)};
+        @visible_to_me_current = @{$group->granted_by_direct(GROUP_VISIBLE)};
+    }
+
+    # Figure out what groups are not currently a member of this group,
+    # and what groups this group is not currently a member of.
+    my (@members_available, @member_of_available,
+        @bless_from_available, @bless_to_available,
+        @visible_from_available, @visible_to_me_available);
+    foreach my $group_option (@all_groups) {
+        if (Bugzilla->params->{'usevisibilitygroups'}) {
+            push(@visible_from_available, $group_option)
+                if !grep($_->id == $group_option->id, @visible_from_current);
+            push(@visible_to_me_available, $group_option)
+                if !grep($_->id == $group_option->id, @visible_to_me_current);
+        }
+
+        push(@bless_from_available, $group_option)
+            if !grep($_->id == $group_option->id, @bless_from_current);
+
+        # The group itself should never show up in the membership lists,
+        # and should show up in only one of the bless lists (otherwise
+        # you can try to allow it to bless itself twice, leading to a
+        # database unique constraint error).
+        next if $group_option->id == $group->id;
+
+        push(@members_available, $group_option)
+            if !grep($_->id == $group_option->id, @members_current);
+        push(@member_of_available, $group_option)
+            if !grep($_->id == $group_option->id, @member_of_current);
+        push(@bless_to_available, $group_option)
+           if !grep($_->id == $group_option->id, @bless_to_current);
+    }
+
+    $vars->{'members_current'}     = \@members_current;
+    $vars->{'members_available'}   = \@members_available;
+    $vars->{'member_of_current'}   = \@member_of_current;
+    $vars->{'member_of_available'} = \@member_of_available;
+
+    $vars->{'bless_from_current'}   = \@bless_from_current;
+    $vars->{'bless_from_available'} = \@bless_from_available;
+    $vars->{'bless_to_current'}     = \@bless_to_current;
+    $vars->{'bless_to_available'}   = \@bless_to_available;
+
+    if (Bugzilla->params->{'usevisibilitygroups'}) {
+        $vars->{'visible_from_current'}    = \@visible_from_current;
+        $vars->{'visible_from_available'}  = \@visible_from_available;
+        $vars->{'visible_to_me_current'}   = \@visible_to_me_current;
+        $vars->{'visible_to_me_available'} = \@visible_to_me_available;
+    }
+}
+
+# If no action is specified, get a list of all groups available.
+
+unless ($action) {
+    my @groups = Bugzilla::Group->get_all;
+    $vars->{'groups'} = \@groups;
+    
+    print $cgi->header();
+    $template->process("admin/groups/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='changeform' -> present form for altering an existing group
+#
+# (next action will be 'postchanges')
+#
+
+if ($action eq 'changeform') {
+    # Check that an existing group ID is given
+    my $group_id = CheckGroupID($cgi->param('group'));
+    my $group = new Bugzilla::Group($group_id);
+
+    get_current_and_available($group, $vars);
+    $vars->{'group'} = $group;
+    $vars->{'token'}       = issue_session_token('edit_group');
+
+    print $cgi->header();
+    $template->process("admin/groups/edit.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+
+    exit;
+}
+
+#
+# action='add' -> present form for parameters for new group
+#
+# (next action will be 'new')
+#
+
+if ($action eq 'add') {
+    $vars->{'token'} = issue_session_token('add_group');
+    print $cgi->header();
+    $template->process("admin/groups/create.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    
+    exit;
+}
+
+
+
+#
+# action='new' -> add group entered in the 'action=add' screen
+#
+
+if ($action eq 'new') {
+    check_token_data($token, 'add_group');
+    my $group = Bugzilla::Group->create({
+        name        => scalar $cgi->param('name'),
+        description => scalar $cgi->param('desc'),
+        userregexp  => scalar $cgi->param('regexp'),
+        isactive    => scalar $cgi->param('isactive'),
+        icon_url    => scalar $cgi->param('icon_url'),
+        isbuggroup  => 1,
+    });
+
+    # Permit all existing products to use the new group if makeproductgroups.
+    if ($cgi->param('insertnew')) {
+        $dbh->do('INSERT INTO group_control_map
+                  (group_id, product_id, membercontrol, othercontrol)
+                  SELECT ?, products.id, ?, ? FROM products',
+                  undef, ($group->id, CONTROLMAPSHOWN, CONTROLMAPNA));
+    }
+    delete_token($token);
+
+    $vars->{'message'} = 'group_created';
+    $vars->{'group'} = $group;
+    get_current_and_available($group, $vars);
+    $vars->{'token'} = issue_session_token('edit_group');
+
+    print $cgi->header();
+    $template->process("admin/groups/edit.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='del' -> ask if user really wants to delete
+#
+# (next action would be 'delete')
+#
+
+if ($action eq 'del') {
+    # Check that an existing group ID is given
+    my $group = Bugzilla::Group->check({ id => $cgi->param('group') });
+    $group->check_remove({ test_only => 1 });
+    $vars->{'shared_queries'} =
+        $dbh->selectrow_array('SELECT COUNT(*)
+                                 FROM namedquery_group_map
+                                WHERE group_id = ?', undef, $group->id);
+
+    $vars->{'group'} = $group;
+    $vars->{'token'} = issue_session_token('delete_group');
+
+    print $cgi->header();
+    $template->process("admin/groups/delete.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    
+    exit;
+}
+
+#
+# action='delete' -> really delete the group
+#
+
+if ($action eq 'delete') {
+    check_token_data($token, 'delete_group');
+    # Check that an existing group ID is given
+    my $group = Bugzilla::Group->check({ id => $cgi->param('group') });
+    $vars->{'name'} = $group->name;
+    $group->remove_from_db({
+        remove_from_users => scalar $cgi->param('removeusers'),
+        remove_from_bugs  => scalar $cgi->param('removebugs'),
+        remove_from_flags => scalar $cgi->param('removeflags'),
+        remove_from_products => scalar $cgi->param('unbind'),
+    });
+    delete_token($token);
+
+    $vars->{'message'} = 'group_deleted';
+    $vars->{'groups'} = [Bugzilla::Group->get_all];
+
+    print $cgi->header();
+    $template->process("admin/groups/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='postchanges' -> update the groups
+#
+
+if ($action eq 'postchanges') {
+    check_token_data($token, 'edit_group');
+    my $changes = doGroupChanges();
+    delete_token($token);
+
+    my $group = new Bugzilla::Group($cgi->param('group_id'));
+    get_current_and_available($group, $vars);
+    $vars->{'message'} = 'group_updated';
+    $vars->{'group'}   = $group;
+    $vars->{'changes'} = $changes;
+    $vars->{'token'} = issue_session_token('edit_group');
+
+    print $cgi->header();
+    $template->process("admin/groups/edit.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+if ($action eq 'confirm_remove') {
+    my $group = new Bugzilla::Group(CheckGroupID($cgi->param('group_id')));
+    $vars->{'group'} = $group;
+    $vars->{'regexp'} = CheckGroupRegexp($cgi->param('regexp'));
+    $vars->{'token'} = issue_session_token('remove_group_members');
+    $template->process('admin/groups/confirm-remove.html.tmpl', $vars)
+        || ThrowTemplateError($template->error());
+    exit;
+}
+
+if ($action eq 'remove_regexp') {
+    check_token_data($token, 'remove_group_members');
+    # remove all explicit users from the group with
+    # gid = $cgi->param('group') that match the regular expression
+    # stored in the DB for that group or all of them period
+
+    my $group  = new Bugzilla::Group(CheckGroupID($cgi->param('group_id')));
+    my $regexp = CheckGroupRegexp($cgi->param('regexp'));
+
+    $dbh->bz_start_transaction();
+
+    my $users = $group->members_direct();
+    my $sth_delete = $dbh->prepare(
+        "DELETE FROM user_group_map
+           WHERE user_id = ? AND isbless = 0 AND group_id = ?");
+
+    my @deleted;
+    foreach my $member (@$users) {
+        if ($regexp eq '' || $member->login =~ m/$regexp/i) {
+            $sth_delete->execute($member->id, $group->id);
+            push(@deleted, $member);
+        }
+    }
+    $dbh->bz_commit_transaction();
+
+    $vars->{'users'}  = \@deleted;
+    $vars->{'regexp'} = $regexp;
+    delete_token($token);
+
+    $vars->{'message'} = 'group_membership_removed';
+    $vars->{'group'} = $group->name;
+    $vars->{'groups'} = [Bugzilla::Group->get_all];
+
+    print $cgi->header();
+    $template->process("admin/groups/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+
+    exit;
+}
+
+# No valid action found
+ThrowUserError('unknown_action', {action => $action});
+
+# Helper sub to handle the making of changes to a group
+sub doGroupChanges {
+    my $cgi = Bugzilla->cgi;
+    my $dbh = Bugzilla->dbh;
+
+    $dbh->bz_start_transaction();
+
+    # Check that the given group ID is valid and make a Group.
+    my $group = new Bugzilla::Group(CheckGroupID($cgi->param('group_id')));
+
+    if (defined $cgi->param('regexp')) {
+        $group->set_user_regexp($cgi->param('regexp'));
+    }
+
+    if ($group->is_bug_group) {
+        if (defined $cgi->param('name')) {
+            $group->set_name($cgi->param('name'));
+        }
+        if (defined $cgi->param('desc')) {
+            $group->set_description($cgi->param('desc'));
+        }
+        # Only set isactive if we came from the right form.
+        if (defined $cgi->param('regexp')) {
+            $group->set_is_active($cgi->param('isactive'));
+        }
+    }
+
+    if (defined $cgi->param('icon_url')) {
+        $group->set_icon_url($cgi->param('icon_url'));
+    }
+
+    my $changes = $group->update();
+
+    my $sth_insert = $dbh->prepare('INSERT INTO group_group_map
+                                    (member_id, grantor_id, grant_type)
+                                    VALUES (?, ?, ?)');
+
+    my $sth_delete = $dbh->prepare('DELETE FROM group_group_map
+                                     WHERE member_id = ?
+                                           AND grantor_id = ?
+                                           AND grant_type = ?');
+
+    # First item is the type, second is whether or not it's "reverse" 
+    # (granted_by) (see _do_add for more explanation).
+    my %fields = (
+        members       => [GROUP_MEMBERSHIP, 0],
+        bless_from    => [GROUP_BLESS, 0],
+        visible_from  => [GROUP_VISIBLE, 0],
+        member_of     => [GROUP_MEMBERSHIP, 1],
+        bless_to      => [GROUP_BLESS, 1],
+        visible_to_me => [GROUP_VISIBLE, 1]
+    );
+    while (my ($field, $data) = each %fields) {
+        _do_add($group, $changes, $sth_insert, "${field}_add", 
+                $data->[0], $data->[1]);
+        _do_remove($group, $changes, $sth_delete, "${field}_remove",
+                   $data->[0], $data->[1]);
+    }
+
+    $dbh->bz_commit_transaction();
+    return $changes;
+}
+
+sub _do_add {
+    my ($group, $changes, $sth_insert, $field, $type, $reverse) = @_;
+    my $cgi = Bugzilla->cgi;
+
+    my $current;
+    # $reverse means we're doing a granted_by--that is, somebody else
+    # is granting us something.
+    if ($reverse) {
+        $current = $group->granted_by_direct($type);
+    }
+    else {
+        $current = $group->grant_direct($type);
+    }
+
+    my $add_items = Bugzilla::Group->new_from_list([$cgi->param($field)]);
+
+    foreach my $add (@$add_items) {
+        next if grep($_->id == $add->id, @$current);
+
+        $changes->{$field} ||= [];
+        push(@{$changes->{$field}}, $add->name);
+        # They go this direction for a normal "This group is granting
+        # $add something."
+        my @ids = ($add->id, $group->id);
+        # But they get reversed for "This group is being granted something
+        # by $add."
+        @ids = reverse @ids if $reverse;
+        $sth_insert->execute(@ids, $type);
+    }
+}
+
+sub _do_remove {
+    my ($group, $changes, $sth_delete, $field, $type, $reverse) = @_;
+    my $cgi = Bugzilla->cgi;
+    my $remove_items = Bugzilla::Group->new_from_list([$cgi->param($field)]);
+
+    foreach my $remove (@$remove_items) {
+        my @ids = ($remove->id, $group->id);
+        # See _do_add for an explanation of $reverse
+        @ids = reverse @ids if $reverse;
+        # Deletions always succeed and are harmless if they fail, so we
+        # don't need to do any checks.
+        $sth_delete->execute(@ids, $type);
+        $changes->{$field} ||= [];
+        push(@{$changes->{$field}}, $remove->name);
+    }
+}

diff --git a/editkeywords.cgi b/editkeywords.cgi
new file mode 100755 (executable)
index 0000000..ab86a2f
--- /dev/null
+++ b/editkeywords.cgi
@@ -0,0 +1,173 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Keyword;
+use Bugzilla::Token;
+
+my $cgi = Bugzilla->cgi;
+my $dbh = Bugzilla->dbh;
+my $template = Bugzilla->template;
+my $vars = {};
+
+#
+# Preliminary checks:
+#
+
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+print $cgi->header();
+
+$user->in_group('editkeywords')
+  || ThrowUserError("auth_failure", {group  => "editkeywords",
+                                     action => "edit",
+                                     object => "keywords"});
+
+my $action = trim($cgi->param('action')  || '');
+my $key_id = $cgi->param('id');
+my $token  = $cgi->param('token');
+
+$vars->{'action'} = $action;
+
+
+if ($action eq "") {
+    $vars->{'keywords'} = Bugzilla::Keyword->get_all_with_bug_count();
+
+    print $cgi->header();
+    $template->process("admin/keywords/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+
+    exit;
+}
+    
+
+if ($action eq 'add') {
+    $vars->{'token'} = issue_session_token('add_keyword');
+
+    print $cgi->header();
+
+    $template->process("admin/keywords/create.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+
+    exit;
+}
+
+#
+# action='new' -> add keyword entered in the 'action=add' screen
+#
+if ($action eq 'new') {
+    check_token_data($token, 'add_keyword');
+    my $name = $cgi->param('name') || '';
+    my $desc = $cgi->param('description')  || '';
+
+    my $keyword = Bugzilla::Keyword->create(
+        { name => $name, description => $desc });
+
+    delete_token($token);
+
+    print $cgi->header();
+
+    $vars->{'message'} = 'keyword_created';
+    $vars->{'name'} = $keyword->name;
+    $vars->{'keywords'} = Bugzilla::Keyword->get_all_with_bug_count();
+
+    $template->process("admin/keywords/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+
+#
+# action='edit' -> present the edit keywords from
+#
+# (next action would be 'update')
+#
+
+if ($action eq 'edit') {
+    my $keyword = new Bugzilla::Keyword($key_id)
+        || ThrowUserError('invalid_keyword_id', { id => $key_id });
+
+    $vars->{'keyword'} = $keyword;
+    $vars->{'token'} = issue_session_token('edit_keyword');
+
+    print $cgi->header();
+    $template->process("admin/keywords/edit.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+
+#
+# action='update' -> update the keyword
+#
+
+if ($action eq 'update') {
+    check_token_data($token, 'edit_keyword');
+    my $keyword = new Bugzilla::Keyword($key_id)
+        || ThrowUserError('invalid_keyword_id', { id => $key_id });
+
+    $keyword->set_all({
+        name        => scalar $cgi->param('name'),
+        description => scalar $cgi->param('description'),
+    });
+    my $changes = $keyword->update();
+
+    delete_token($token);
+
+    print $cgi->header();
+
+    $vars->{'message'} = 'keyword_updated';
+    $vars->{'keyword'} = $keyword;
+    $vars->{'changes'} = $changes;
+    $vars->{'keywords'} = Bugzilla::Keyword->get_all_with_bug_count();
+
+    $template->process("admin/keywords/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+if ($action eq 'del') {
+    my $keyword =  new Bugzilla::Keyword($key_id)
+        || ThrowUserError('invalid_keyword_id', { id => $key_id });
+
+    $vars->{'keyword'} = $keyword;
+    $vars->{'token'} = issue_session_token('delete_keyword');
+
+    print $cgi->header();
+    $template->process("admin/keywords/confirm-delete.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+if ($action eq 'delete') {
+    check_token_data($token, 'delete_keyword');
+    my $keyword =  new Bugzilla::Keyword($key_id)
+        || ThrowUserError('invalid_keyword_id', { id => $key_id });
+
+    $keyword->remove_from_db();
+
+    delete_token($token);
+
+    print $cgi->header();
+
+    $vars->{'message'} = 'keyword_deleted';
+    $vars->{'keyword'} = $keyword;
+    $vars->{'keywords'} = Bugzilla::Keyword->get_all_with_bug_count();
+
+    $template->process("admin/keywords/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+ThrowUserError('unknown_action', {action => $action});

diff --git a/editmilestones.cgi b/editmilestones.cgi
new file mode 100755 (executable)
index 0000000..93152cd
--- /dev/null
+++ b/editmilestones.cgi
@@ -0,0 +1,216 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Milestone;
+use Bugzilla::Token;
+
+my $cgi = Bugzilla->cgi;
+my $dbh = Bugzilla->dbh;
+my $template = Bugzilla->template;
+my $vars = {};
+# There is only one section about milestones in the documentation,
+# so all actions point to the same page.
+$vars->{'doc_section'} = 'milestones.html';
+
+#
+# Preliminary checks:
+#
+
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+print $cgi->header();
+
+$user->in_group('editcomponents')
+  || scalar(@{$user->get_products_by_permission('editcomponents')})
+  || ThrowUserError("auth_failure", {group  => "editcomponents",
+                                     action => "edit",
+                                     object => "milestones"});
+
+#
+# often used variables
+#
+my $product_name   = trim($cgi->param('product')     || '');
+my $milestone_name = trim($cgi->param('milestone')   || '');
+my $sortkey        = trim($cgi->param('sortkey')     || 0);
+my $action         = trim($cgi->param('action')      || '');
+my $showbugcounts = (defined $cgi->param('showbugcounts'));
+my $token          = $cgi->param('token');
+my $isactive       = $cgi->param('isactive');
+
+#
+# product = '' -> Show nice list of products
+#
+
+unless ($product_name) {
+    my $selectable_products = $user->get_selectable_products;
+    # If the user has editcomponents privs for some products only,
+    # we have to restrict the list of products to display.
+    unless ($user->in_group('editcomponents')) {
+        $selectable_products = $user->get_products_by_permission('editcomponents');
+    }
+    $vars->{'products'} = $selectable_products;
+    $vars->{'showbugcounts'} = $showbugcounts;
+
+    $template->process("admin/milestones/select-product.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+my $product = $user->check_can_admin_product($product_name);
+
+#
+# action='' -> Show nice list of milestones
+#
+
+unless ($action) {
+
+    $vars->{'showbugcounts'} = $showbugcounts;
+    $vars->{'product'} = $product;
+    $template->process("admin/milestones/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='add' -> present form for parameters for new milestone
+#
+# (next action will be 'new')
+#
+
+if ($action eq 'add') {
+    $vars->{'token'} = issue_session_token('add_milestone');
+    $vars->{'product'} = $product;
+    $template->process("admin/milestones/create.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='new' -> add milestone entered in the 'action=add' screen
+#
+
+if ($action eq 'new') {
+    check_token_data($token, 'add_milestone');
+
+    my $milestone = Bugzilla::Milestone->create({ value    => $milestone_name,
+                                                  product  => $product,
+                                                  sortkey  => $sortkey });
+
+    delete_token($token);
+
+    $vars->{'message'} = 'milestone_created';
+    $vars->{'milestone'} = $milestone;
+    $vars->{'product'} = $product;
+    $template->process("admin/milestones/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='del' -> ask if user really wants to delete
+#
+# (next action would be 'delete')
+#
+
+if ($action eq 'del') {
+    my $milestone = Bugzilla::Milestone->check({ product => $product,
+                                                 name    => $milestone_name });
+    
+    $vars->{'milestone'} = $milestone;
+    $vars->{'product'} = $product;
+
+    # The default milestone cannot be deleted.
+    if ($product->default_milestone eq $milestone->name) {
+        ThrowUserError("milestone_is_default", { milestone => $milestone });
+    }
+    $vars->{'token'} = issue_session_token('delete_milestone');
+
+    $template->process("admin/milestones/confirm-delete.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='delete' -> really delete the milestone
+#
+
+if ($action eq 'delete') {
+    check_token_data($token, 'delete_milestone');
+    my $milestone = Bugzilla::Milestone->check({ product => $product,
+                                                 name    => $milestone_name });
+    $milestone->remove_from_db;
+    delete_token($token);
+
+    $vars->{'message'} = 'milestone_deleted';
+    $vars->{'milestone'} = $milestone;
+    $vars->{'product'} = $product;
+    $vars->{'no_edit_milestone_link'} = 1;
+
+    $template->process("admin/milestones/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='edit' -> present the edit milestone form
+#
+# (next action would be 'update')
+#
+
+if ($action eq 'edit') {
+
+    my $milestone = Bugzilla::Milestone->check({ product => $product,
+                                                 name    => $milestone_name });
+
+    $vars->{'milestone'} = $milestone;
+    $vars->{'product'} = $product;
+    $vars->{'token'} = issue_session_token('edit_milestone');
+
+    $template->process("admin/milestones/edit.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='update' -> update the milestone
+#
+
+if ($action eq 'update') {
+    check_token_data($token, 'edit_milestone');
+    my $milestone_old_name = trim($cgi->param('milestoneold') || '');
+    my $milestone = Bugzilla::Milestone->check({ product => $product,
+                                                 name    => $milestone_old_name });
+
+    $milestone->set_name($milestone_name);
+    $milestone->set_sortkey($sortkey);
+    $milestone->set_is_active($isactive);
+    my $changes = $milestone->update();
+    # Reloading the product since the default milestone name
+    # could have been changed.
+    $product = new Bugzilla::Product({ name => $product_name });
+
+    delete_token($token);
+
+    $vars->{'message'} = 'milestone_updated';
+    $vars->{'milestone'} = $milestone;
+    $vars->{'product'} = $product;
+    $vars->{'changes'} = $changes;
+    $template->process("admin/milestones/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+# No valid action found
+ThrowUserError('unknown_action', {action => $action});

diff --git a/editparams.cgi b/editparams.cgi
new file mode 100755 (executable)
index 0000000..b522fd4
--- /dev/null
+++ b/editparams.cgi
@@ -0,0 +1,151 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Config qw(:admin);
+use Bugzilla::Config::Common;
+use Bugzilla::Hook;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Token;
+use Bugzilla::User;
+use Bugzilla::User::Setting;
+use Bugzilla::Status;
+
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $vars = {};
+
+print $cgi->header();
+
+$user->in_group('tweakparams')
+  || ThrowUserError("auth_failure", {group  => "tweakparams",
+                                     action => "access",
+                                     object => "parameters"});
+
+my $action = trim($cgi->param('action') || '');
+my $token  = $cgi->param('token');
+my $current_panel = $cgi->param('section') || 'core';
+$current_panel =~ /^([A-Za-z0-9_-]+)$/;
+$current_panel = $1;
+
+my $current_module;
+my @panels = ();
+my $param_panels = Bugzilla::Config::param_panels();
+foreach my $panel (keys %$param_panels) {
+    my $module = $param_panels->{$panel};
+    eval("require $module") || die $@;
+    my @module_param_list = "$module"->get_param_list();
+    my $item = { name => lc($panel),
+                 current => ($current_panel eq lc($panel)) ? 1 : 0,
+                 param_list => \@module_param_list,
+                 sortkey => eval "\$${module}::sortkey;"
+               };
+    defined($item->{'sortkey'}) || ($item->{'sortkey'} = 100000);
+    push(@panels, $item);
+    $current_module = $panel if ($current_panel eq lc($panel));
+}
+
+my %hook_panels = map { $_->{name} => { params => $_->{param_list} } }
+                      @panels;
+# Note that this hook is also called in Bugzilla::Config.
+Bugzilla::Hook::process('config_modify_panels', { panels => \%hook_panels });
+
+$vars->{panels} = \@panels;
+
+if ($action eq 'save' && $current_module) {
+    check_token_data($token, 'edit_parameters');
+    my @changes = ();
+    my @module_param_list = @{ $hook_panels{lc($current_module)}->{params} };
+
+    foreach my $i (@module_param_list) {
+        my $name = $i->{'name'};
+        my $value = $cgi->param($name);
+
+        if (defined $cgi->param("reset-$name") && !$i->{'no_reset'}) {
+            $value = $i->{'default'};
+        } else {
+            if ($i->{'type'} eq 'm') {
+                # This simplifies the code below
+                $value = [ $cgi->param($name) ];
+            } else {
+                # Get rid of windows/mac-style line endings.
+                $value =~ s/\r\n?/\n/g;
+                # assume single linefeed is an empty string
+                $value =~ s/^\n$//;
+            }
+            # Stop complaining if the URL has no trailing slash.
+            # XXX - This hack can go away once bug 303662 is implemented.
+            if ($name =~ /(?<!webdot)base$/) {
+                $value = "$value/" if ($value && $value !~ m#/$#);
+            }
+        }
+
+        my $changed;
+        if ($i->{'type'} eq 'm') {
+            my @old = sort @{Bugzilla->params->{$name}};
+            my @new = sort @$value;
+            if (scalar(@old) != scalar(@new)) {
+                $changed = 1;
+            } else {
+                $changed = 0; # Assume not changed...
+                for (my $cnt = 0; $cnt < scalar(@old); ++$cnt) {
+                    if ($old[$cnt] ne $new[$cnt]) {
+                        # entry is different, therefore changed
+                        $changed = 1;
+                        last;
+                    }
+                }
+            }
+        } else {
+            $changed = ($value eq Bugzilla->params->{$name})? 0 : 1;
+        }
+
+        if ($changed) {
+            if (exists $i->{'checker'}) {
+                my $ok = $i->{'checker'}->($value, $i);
+                if ($ok ne "") {
+                    ThrowUserError('invalid_parameter', { name => $name, err => $ok });
+                }
+            } elsif ($name eq 'globalwatchers') {
+                # can't check this as others, as Bugzilla::Config::Common
+                # cannot use Bugzilla::User
+                foreach my $watcher (split(/[,\s]+/, $value)) {
+                    ThrowUserError(
+                        'invalid_parameter',
+                        { name => $name, err => "no such user $watcher" }
+                    ) unless login_to_id($watcher);
+                }
+            }
+            push(@changes, $name);
+            SetParam($name, $value);
+            if (($name eq "shutdownhtml") && ($value ne "")) {
+                $vars->{'shutdown_is_active'} = 1;
+            }
+            if ($name eq 'duplicate_or_move_bug_status') {
+                Bugzilla::Status::add_missing_bug_status_transitions($value);
+            }
+        }
+    }
+
+    $vars->{'message'} = 'parameters_updated';
+    $vars->{'param_changed'} = \@changes;
+
+    write_params();
+    delete_token($token);
+}
+
+$vars->{'token'} = issue_session_token('edit_parameters');
+
+$template->process("admin/params/editparams.html.tmpl", $vars)
+    || ThrowTemplateError($template->error());

diff --git a/editproducts.cgi b/editproducts.cgi
new file mode 100755 (executable)
index 0000000..b4f1649
--- /dev/null
+++ b/editproducts.cgi
@@ -0,0 +1,427 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Group;
+use Bugzilla::Product;
+use Bugzilla::Component;
+use Bugzilla::Classification;
+use Bugzilla::Token;
+
+#
+# Preliminary checks:
+#
+
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+my $whoid = $user->id;
+
+my $dbh = Bugzilla->dbh;
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $vars = {};
+# Remove this as soon as the documentation about products has been
+# improved and each action has its own section.
+$vars->{'doc_section'} = 'products.html';
+
+print $cgi->header();
+
+$user->in_group('editcomponents')
+  || scalar(@{$user->get_products_by_permission('editcomponents')})
+  || ThrowUserError("auth_failure", {group  => "editcomponents",
+                                     action => "edit",
+                                     object => "products"});
+
+#
+# often used variables
+#
+my $classification_name = trim($cgi->param('classification') || '');
+my $product_name = trim($cgi->param('product') || '');
+my $action  = trim($cgi->param('action')  || '');
+my $token = $cgi->param('token');
+
+#
+# product = '' -> Show nice list of classifications (if
+# classifications enabled)
+#
+
+if (Bugzilla->params->{'useclassification'} 
+    && !$classification_name
+    && !$product_name)
+{
+    my $class;
+    if ($user->in_group('editcomponents')) {
+        $class = [Bugzilla::Classification->get_all];
+    }
+    else {
+        # Only keep classifications containing at least one product
+        # which you can administer.
+        my $products = $user->get_products_by_permission('editcomponents');
+        my %class_ids = map { $_->classification_id => 1 } @$products;
+        $class = Bugzilla::Classification->new_from_list([keys %class_ids]);
+    }
+    $vars->{'classifications'} = $class;
+
+    $template->process("admin/products/list-classifications.html.tmpl", $vars)
+        || ThrowTemplateError($template->error());
+    exit;
+}
+
+
+#
+# action = '' -> Show a nice list of products, unless a product
+#                is already specified (then edit it)
+#
+
+if (!$action && !$product_name) {
+    my $classification;
+    my $products;
+
+    if (Bugzilla->params->{'useclassification'}) {
+        $classification = Bugzilla::Classification->check($classification_name);
+        $products = $user->get_selectable_products($classification->id);
+        $vars->{'classification'} = $classification;
+    } else {
+        $products = $user->get_selectable_products;
+    }
+
+    # If the user has editcomponents privs for some products only,
+    # we have to restrict the list of products to display.
+    unless ($user->in_group('editcomponents')) {
+        $products = $user->get_products_by_permission('editcomponents');
+        if (Bugzilla->params->{'useclassification'}) {
+            @$products = grep {$_->classification_id == $classification->id} @$products;
+        }
+    }
+    $vars->{'products'} = $products;
+    $vars->{'showbugcounts'} = $cgi->param('showbugcounts') ? 1 : 0;
+
+    $template->process("admin/products/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+
+
+
+#
+# action='add' -> present form for parameters for new product
+#
+# (next action will be 'new')
+#
+
+if ($action eq 'add') {
+    # The user must have the global editcomponents privs to add
+    # new products.
+    $user->in_group('editcomponents')
+      || ThrowUserError("auth_failure", {group  => "editcomponents",
+                                         action => "add",
+                                         object => "products"});
+
+    if (Bugzilla->params->{'useclassification'}) {
+        my $classification = Bugzilla::Classification->check($classification_name);
+        $vars->{'classification'} = $classification;
+    }
+    $vars->{'token'} = issue_session_token('add_product');
+
+    $template->process("admin/products/create.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+
+    exit;
+}
+
+
+#
+# action='new' -> add product entered in the 'action=add' screen
+#
+
+if ($action eq 'new') {
+    # The user must have the global editcomponents privs to add
+    # new products.
+    $user->in_group('editcomponents')
+      || ThrowUserError("auth_failure", {group  => "editcomponents",
+                                         action => "add",
+                                         object => "products"});
+
+    check_token_data($token, 'add_product');
+
+    Bugzilla::User::match_field ({
+        'initialowner'     => { 'type' => 'single' },
+        'initialqacontact' => { 'type' => 'single' },
+        'initialcc'        => { 'type' => 'multi'  },
+    });
+
+    my %product_create_params = (
+        classification   => $classification_name,
+        name             => $product_name,
+        description      => scalar $cgi->param('description'),
+        version          => scalar $cgi->param('version'),
+        defaultmilestone => scalar $cgi->param('defaultmilestone'),
+        isactive         => scalar $cgi->param('is_active'),
+        create_series    => scalar $cgi->param('createseries'),
+        allows_unconfirmed => scalar $cgi->param('allows_unconfirmed'),
+    );
+
+    $dbh->bz_start_transaction();
+    my $product = Bugzilla::Product->create(\%product_create_params);
+
+    my @initial_cc = $cgi->param('initialcc');
+    my %component_create_params = (
+        product          => $product,
+        name             => trim($cgi->param('component') || ''),
+        description      => scalar $cgi->param('comp_desc'),
+        initialowner     => scalar $cgi->param('initialowner'),
+        initialqacontact => scalar $cgi->param('initialqacontact'),
+        initial_cc       => \@initial_cc,
+        create_series    => scalar $cgi->param('createseries'),
+   );
+
+    Bugzilla::Component->create(\%component_create_params);
+    $dbh->bz_commit_transaction();
+
+    delete_token($token);
+
+    $vars->{'message'} = 'product_created';
+    $vars->{'product'} = $product;
+    if (Bugzilla->params->{'useclassification'}) {
+        $vars->{'classification'} = new Bugzilla::Classification($product->classification_id);
+    }
+    $vars->{'token'} = issue_session_token('edit_product');
+
+    $template->process("admin/products/edit.html.tmpl", $vars)
+        || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='del' -> ask if user really wants to delete
+#
+# (next action would be 'delete')
+#
+
+if ($action eq 'del') {
+    my $product = $user->check_can_admin_product($product_name);
+
+    if (Bugzilla->params->{'useclassification'}) {
+        $vars->{'classification'} = new Bugzilla::Classification($product->classification_id);
+    }
+    $vars->{'product'} = $product;
+    $vars->{'token'} = issue_session_token('delete_product');
+    
+    Bugzilla::Hook::process('product_confirm_delete', { vars => $vars });
+    
+    $template->process("admin/products/confirm-delete.html.tmpl", $vars)
+        || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='delete' -> really delete the product
+#
+
+if ($action eq 'delete') {
+    my $product = $user->check_can_admin_product($product_name);
+    check_token_data($token, 'delete_product');
+
+    $product->remove_from_db({ delete_series => scalar $cgi->param('delete_series')});
+    delete_token($token);
+
+    $vars->{'message'} = 'product_deleted';
+    $vars->{'product'} = $product;
+    $vars->{'no_edit_product_link'} = 1;
+
+    if (Bugzilla->params->{'useclassification'}) {
+        $vars->{'classifications'} = $user->in_group('editcomponents') ?
+          [Bugzilla::Classification->get_all] : $user->get_selectable_classifications;
+
+        $template->process("admin/products/list-classifications.html.tmpl", $vars)
+          || ThrowTemplateError($template->error());
+    }
+    else {
+        my $products = $user->get_selectable_products;
+        # If the user has editcomponents privs for some products only,
+        # we have to restrict the list of products to display.
+        unless ($user->in_group('editcomponents')) {
+            $products = $user->get_products_by_permission('editcomponents');
+        }
+        $vars->{'products'} = $products;
+
+        $template->process("admin/products/list.html.tmpl", $vars)
+          || ThrowTemplateError($template->error());
+    }
+    exit;
+}
+
+#
+# action='edit' -> present the 'edit product' form
+# If a product is given with no action associated with it, then edit it.
+#
+# (next action would be 'update')
+#
+
+if ($action eq 'edit' || (!$action && $product_name)) {
+    my $product = $user->check_can_admin_product($product_name);
+
+    if (Bugzilla->params->{'useclassification'}) {
+        $vars->{'classification'} = new Bugzilla::Classification($product->classification_id);
+    }
+    $vars->{'product'} = $product;
+    $vars->{'token'} = issue_session_token('edit_product');
+
+    $template->process("admin/products/edit.html.tmpl", $vars)
+        || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='update' -> update the product
+#
+if ($action eq 'update') {
+    check_token_data($token, 'edit_product');
+    my $product_old_name = trim($cgi->param('product_old_name') || '');
+    my $product = $user->check_can_admin_product($product_old_name);
+
+    $product->set_all({
+        name        => $product_name,
+        description => scalar $cgi->param('description'),
+        is_active   => scalar $cgi->param('is_active'),
+        allows_unconfirmed => scalar $cgi->param('allows_unconfirmed'),
+        default_milestone  => scalar $cgi->param('defaultmilestone'),
+    });
+
+    my $changes = $product->update();
+
+    delete_token($token);
+
+    if (Bugzilla->params->{'useclassification'}) {
+        $vars->{'classification'} = new Bugzilla::Classification($product->classification_id);
+    }
+    $vars->{'product'} = $product;
+    $vars->{'changes'} = $changes;
+
+    $template->process("admin/products/updated.html.tmpl", $vars)
+        || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='editgroupcontrols' -> display product group controls
+#
+
+if ($action eq 'editgroupcontrols') {
+    my $product = $user->check_can_admin_product($product_name);
+
+    $vars->{'product'} = $product;
+    $vars->{'token'} = issue_session_token('edit_group_controls');
+
+    $template->process("admin/products/groupcontrol/edit.html.tmpl", $vars)
+        || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='updategroupcontrols' -> update product group controls
+#
+
+if ($action eq 'updategroupcontrols') {
+    my $product = $user->check_can_admin_product($product_name);
+    check_token_data($token, 'edit_group_controls');
+
+    my @now_na = ();
+    my @now_mandatory = ();
+    foreach my $f ($cgi->param()) {
+        if ($f =~ /^membercontrol_(\d+)$/) {
+            my $id = $1;
+            if ($cgi->param($f) == CONTROLMAPNA) {
+                push @now_na,$id;
+            } elsif ($cgi->param($f) == CONTROLMAPMANDATORY) {
+                push @now_mandatory,$id;
+            }
+        }
+    }
+    if (!defined $cgi->param('confirmed')) {
+        my $na_groups;
+        if (@now_na) {
+            $na_groups = $dbh->selectall_arrayref(
+                    'SELECT groups.name, COUNT(bugs.bug_id) AS count
+                       FROM bugs
+                 INNER JOIN bug_group_map
+                         ON bug_group_map.bug_id = bugs.bug_id
+                 INNER JOIN groups
+                         ON bug_group_map.group_id = groups.id
+                      WHERE groups.id IN (' . join(', ', @now_na) . ')
+                        AND bugs.product_id = ? ' .
+                       $dbh->sql_group_by('groups.name'),
+                   {'Slice' => {}}, $product->id);
+        }
+
+        # return the mandatory groups which need to have bug entries
+        # added to the bug_group_map and the corresponding bug count
+
+        my $mandatory_groups;
+        if (@now_mandatory) {
+            $mandatory_groups = $dbh->selectall_arrayref(
+                    'SELECT groups.name,
+                           (SELECT COUNT(bugs.bug_id)
+                              FROM bugs
+                             WHERE bugs.product_id = ?
+                               AND bugs.bug_id NOT IN
+                                (SELECT bug_group_map.bug_id FROM bug_group_map
+                                  WHERE bug_group_map.group_id = groups.id))
+                           AS count
+                      FROM groups
+                     WHERE groups.id IN (' . join(', ', @now_mandatory) . ')
+                     ORDER BY groups.name',
+                   {'Slice' => {}}, $product->id);
+            # remove zero counts
+            @$mandatory_groups = grep { $_->{count} } @$mandatory_groups;
+
+        }
+        if (($na_groups && scalar(@$na_groups))
+            || ($mandatory_groups && scalar(@$mandatory_groups)))
+        {
+            $vars->{'product'} = $product;
+            $vars->{'na_groups'} = $na_groups;
+            $vars->{'mandatory_groups'} = $mandatory_groups;
+            $template->process("admin/products/groupcontrol/confirm-edit.html.tmpl", $vars)
+                || ThrowTemplateError($template->error());
+            exit;
+        }
+    }
+
+    my $groups = Bugzilla::Group->match({isactive => 1, isbuggroup => 1});
+    foreach my $group (@$groups) {
+        my $group_id = $group->id;
+        $product->set_group_controls($group,
+                                     {entry          => scalar $cgi->param("entry_$group_id") || 0,
+                                      membercontrol  => scalar $cgi->param("membercontrol_$group_id") || CONTROLMAPNA,
+                                      othercontrol   => scalar $cgi->param("othercontrol_$group_id") || CONTROLMAPNA,
+                                      canedit        => scalar $cgi->param("canedit_$group_id") || 0,
+                                      editcomponents => scalar $cgi->param("editcomponents_$group_id") || 0,
+                                      editbugs       => scalar $cgi->param("editbugs_$group_id") || 0,
+                                      canconfirm     => scalar $cgi->param("canconfirm_$group_id") || 0});
+    }
+    my $changes = $product->update;
+
+    delete_token($token);
+
+    $vars->{'product'} = $product;
+    $vars->{'changes'} = $changes;
+
+    $template->process("admin/products/groupcontrol/updated.html.tmpl", $vars)
+        || ThrowTemplateError($template->error());
+    exit;
+}
+
+# No valid action found
+ThrowUserError('unknown_action', {action => $action});

diff --git a/editsettings.cgi b/editsettings.cgi
new file mode 100755 (executable)
index 0000000..17740cd
--- /dev/null
+++ b/editsettings.cgi
@@ -0,0 +1,63 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::User::Setting;
+use Bugzilla::Token;
+
+my $template = Bugzilla->template;
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+my $cgi = Bugzilla->cgi;
+my $vars = {};
+
+print $cgi->header;
+
+$user->in_group('tweakparams')
+  || ThrowUserError("auth_failure", {group  => "tweakparams",
+                                     action => "modify",
+                                     object => "settings"});
+
+my $action = trim($cgi->param('action') || '');
+my $token = $cgi->param('token');
+
+if ($action eq 'update') {
+    check_token_data($token, 'edit_settings');
+    my $settings = Bugzilla::User::Setting::get_defaults();
+    my $changed = 0;
+
+    foreach my $name (keys %$settings) {
+        my $old_enabled = $settings->{$name}->{'is_enabled'};
+        my $old_value = $settings->{$name}->{'default_value'};
+        my $enabled = defined $cgi->param("${name}-enabled") || 0;
+        my $value = $cgi->param("${name}");
+        my $setting = new Bugzilla::User::Setting($name);
+
+        $setting->validate_value($value);
+
+        if ($old_enabled != $enabled || $old_value ne $value) {
+            Bugzilla::User::Setting::set_default($name, $value, $enabled);
+            $changed = 1;
+        }
+    }
+    $vars->{'message'} = 'default_settings_updated';
+    $vars->{'changes_saved'} = $changed;
+    delete_token($token);
+}
+
+# Don't use $settings as defaults may have changed.
+$vars->{'settings'} = Bugzilla::User::Setting::get_defaults();
+$vars->{'token'} = issue_session_token('edit_settings');
+
+$template->process("admin/settings/edit.html.tmpl", $vars)
+  || ThrowTemplateError($template->error());

diff --git a/editusers.cgi b/editusers.cgi
new file mode 100755 (executable)
index 0000000..d022321
--- /dev/null
+++ b/editusers.cgi
@@ -0,0 +1,793 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::User;
+use Bugzilla::Bug;
+use Bugzilla::BugMail;
+use Bugzilla::Flag;
+use Bugzilla::Field;
+use Bugzilla::Group;
+use Bugzilla::Token;
+
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+my $cgi       = Bugzilla->cgi;
+my $template  = Bugzilla->template;
+my $dbh       = Bugzilla->dbh;
+my $userid    = $user->id;
+my $editusers = $user->in_group('editusers');
+local our $vars     = {};
+
+# Reject access if there is no sense in continuing.
+$editusers
+    || $user->can_bless()
+    || ThrowUserError("auth_failure", {group  => "editusers",
+                                       reason => "cant_bless",
+                                       action => "edit",
+                                       object => "users"});
+
+print $cgi->header();
+
+# Common CGI params
+my $action         = $cgi->param('action') || 'search';
+my $otherUserID    = $cgi->param('userid');
+my $otherUserLogin = $cgi->param('user');
+my $token          = $cgi->param('token');
+
+# Prefill template vars with data used in all or nearly all templates
+$vars->{'editusers'} = $editusers;
+mirrorListSelectionValues();
+
+Bugzilla::Hook::process('admin_editusers_action',
+    { vars => $vars, user => $user, action => $action });
+
+###########################################################################
+if ($action eq 'search') {
+    # Allow to restrict the search to any group the user is allowed to bless.
+    $vars->{'restrictablegroups'} = $user->bless_groups();
+    $template->process('admin/users/search.html.tmpl', $vars)
+       || ThrowTemplateError($template->error());
+
+###########################################################################
+} elsif ($action eq 'list') {
+    my $matchvalue    = $cgi->param('matchvalue') || '';
+    my $matchstr      = trim($cgi->param('matchstr'));
+    my $matchtype     = $cgi->param('matchtype');
+    my $grouprestrict = $cgi->param('grouprestrict') || '0';
+    my $enabled_only  = $cgi->param('enabled_only') || '0';
+    my $query = 'SELECT DISTINCT userid, login_name, realname, is_enabled, ' .
+                $dbh->sql_date_format('last_seen_date', '%Y-%m-%d') . ' AS last_seen_date ' .
+                'FROM profiles';
+    my @bindValues;
+    my $nextCondition;
+    my $visibleGroups;
+
+    # If a group ID is given, make sure it is a valid one.
+    my $group;
+    if ($grouprestrict) {
+        $group = new Bugzilla::Group(scalar $cgi->param('groupid'));
+        $group || ThrowUserError('invalid_group_ID');
+    }
+
+    if (!$editusers && Bugzilla->params->{'usevisibilitygroups'}) {
+        # Show only users in visible groups.
+        $visibleGroups = $user->visible_groups_as_string();
+
+        if ($visibleGroups) {
+            $query .= qq{, user_group_map AS ugm
+                         WHERE ugm.user_id = profiles.userid
+                           AND ugm.isbless = 0
+                           AND ugm.group_id IN ($visibleGroups)
+                        };
+            $nextCondition = 'AND';
+        }
+    } else {
+        $visibleGroups = 1;
+        if ($grouprestrict eq '1') {
+            $query .= qq{, user_group_map AS ugm
+                         WHERE ugm.user_id = profiles.userid
+                           AND ugm.isbless = 0
+                        };
+            $nextCondition = 'AND';
+        }
+        else {
+            $nextCondition = 'WHERE';
+        }
+    }
+
+    if (!$visibleGroups) {
+        $vars->{'users'} = {};
+    }
+    else {
+        # Handle selection by login name, real name, or userid.
+        if (defined($matchtype)) {
+            $query .= " $nextCondition ";
+            my $expr = "";
+            if ($matchvalue eq 'userid') {
+                if ($matchstr) {
+                    my $stored_matchstr = $matchstr;
+                    detaint_natural($matchstr) 
+                        || ThrowUserError('illegal_user_id', {userid => $stored_matchstr});
+                }
+                $expr = "profiles.userid";
+            } elsif ($matchvalue eq 'realname') {
+                $expr = "profiles.realname";
+            } else {
+                $expr = "profiles.login_name";
+            }
+
+            if ($matchtype =~ /^(regexp|notregexp|exact)$/) {
+                $matchstr ||= '.';
+            }
+            else {
+                $matchstr = '' unless defined $matchstr;
+            }
+            # We can trick_taint because we use the value in a SELECT only,
+            # using a placeholder.
+            trick_taint($matchstr);
+
+            if ($matchtype eq 'regexp') {
+                $query .= $dbh->sql_regexp($expr, '?', 0, $dbh->quote($matchstr));
+            } elsif ($matchtype eq 'notregexp') {
+                $query .= $dbh->sql_not_regexp($expr, '?', 0, $dbh->quote($matchstr));
+            } elsif ($matchtype eq 'exact') {
+                $query .= $expr . ' = ?';
+            } else { # substr or unknown
+                $query .= $dbh->sql_iposition('?', $expr) . ' > 0';
+            }
+            $nextCondition = 'AND';
+            push(@bindValues, $matchstr);
+        }
+
+        # Handle selection by group.
+        if ($grouprestrict eq '1') {
+            my $grouplist = join(',',
+                @{Bugzilla::Group->flatten_group_membership($group->id)});
+            $query .= " $nextCondition ugm.group_id IN($grouplist) ";
+        }
+
+        if ($enabled_only eq '1') {
+            $query .= " $nextCondition profiles.is_enabled = 1 ";
+            $nextCondition = 'AND';
+        }
+
+        $query .= ' ORDER BY profiles.login_name';
+
+        $vars->{'users'} = $dbh->selectall_arrayref($query,
+                                                    {'Slice' => {}},
+                                                    @bindValues);
+
+    }
+
+    if ($matchtype && $matchtype eq 'exact' && scalar(@{$vars->{'users'}}) == 1) {
+        my $match_user_id = $vars->{'users'}[0]->{'userid'};
+        my $match_user = check_user($match_user_id);
+        edit_processing($match_user);
+    } else {
+        $template->process('admin/users/list.html.tmpl', $vars)
+            || ThrowTemplateError($template->error());
+    }
+
+###########################################################################
+} elsif ($action eq 'add') {
+    $editusers || ThrowUserError("auth_failure", {group  => "editusers",
+                                                  action => "add",
+                                                  object => "users"});
+
+    $vars->{'token'} = issue_session_token('add_user');
+
+    $template->process('admin/users/create.html.tmpl', $vars)
+       || ThrowTemplateError($template->error());
+
+###########################################################################
+} elsif ($action eq 'new') {
+    $editusers || ThrowUserError("auth_failure", {group  => "editusers",
+                                                  action => "add",
+                                                  object => "users"});
+
+    check_token_data($token, 'add_user');
+
+    # When e.g. the 'Env' auth method is used, the password field
+    # is not displayed. In that case, set the password to *.
+    my $password = $cgi->param('password');
+    $password = '*' if !defined $password;
+
+    my $new_user = Bugzilla::User->create({
+        login_name    => scalar $cgi->param('login'),
+        cryptpassword => $password,
+        realname      => scalar $cgi->param('name'),
+        disabledtext  => scalar $cgi->param('disabledtext'),
+        disable_mail  => scalar $cgi->param('disable_mail'),
+        extern_id     => scalar $cgi->param('extern_id'),
+        });
+
+    userDataToVars($new_user->id);
+
+    delete_token($token);
+
+    # We already display the updated page. We have to recreate a token now.
+    $vars->{'token'} = issue_session_token('edit_user');
+    $vars->{'message'} = 'account_created';
+    $template->process('admin/users/edit.html.tmpl', $vars)
+       || ThrowTemplateError($template->error());
+
+###########################################################################
+} elsif ($action eq 'edit') {
+    my $otherUser = check_user($otherUserID, $otherUserLogin);
+    edit_processing($otherUser);
+
+###########################################################################
+} elsif ($action eq 'update') {
+    check_token_data($token, 'edit_user');
+    my $otherUser = check_user($otherUserID, $otherUserLogin);
+    $otherUserID = $otherUser->id;
+
+    # Lock tables during the check+update session.
+    $dbh->bz_start_transaction();
+ 
+    $editusers || $user->can_see_user($otherUser)
+        || ThrowUserError('auth_failure', {reason => "not_visible",
+                                           action => "modify",
+                                           object => "user"});
+
+    $vars->{'loginold'} = $otherUser->login;
+
+    # Update profiles table entry; silently skip doing this if the user
+    # is not authorized.
+    my $changes = {};
+    if ($editusers) {
+        $otherUser->set_login($cgi->param('login'));
+        $otherUser->set_name($cgi->param('name'));
+        $otherUser->set_password($cgi->param('password'))
+            if $cgi->param('password');
+        $otherUser->set_disabledtext($cgi->param('disabledtext'));
+        $otherUser->set_disable_mail($cgi->param('disable_mail'));
+        $otherUser->set_extern_id($cgi->param('extern_id'))
+            if defined($cgi->param('extern_id'));
+        $changes = $otherUser->update();
+    }
+
+    # Update group settings.
+    my $sth_add_mapping = $dbh->prepare(
+        qq{INSERT INTO user_group_map (
+                  user_id, group_id, isbless, grant_type
+                 ) VALUES (
+                  ?, ?, ?, ?
+                 )
+          });
+    my $sth_remove_mapping = $dbh->prepare(
+        qq{DELETE FROM user_group_map
+            WHERE user_id = ?
+              AND group_id = ?
+              AND isbless = ?
+              AND grant_type = ?
+          });
+
+    my @groupsAddedTo;
+    my @groupsRemovedFrom;
+    my @groupsGrantedRightsToBless;
+    my @groupsDeniedRightsToBless;
+
+    # Regard only groups the user is allowed to bless and skip all others
+    # silently.
+    # XXX: checking for existence of each user_group_map entry
+    #      would allow to display a friendlier error message on page reloads.
+    userDataToVars($otherUserID);
+    my $permissions = $vars->{'permissions'};
+    foreach my $blessable (@{$user->bless_groups()}) {
+        my $id = $blessable->id;
+        my $name = $blessable->name;
+
+        # Change memberships.
+        my $groupid = $cgi->param("group_$id") || 0;
+        if ($groupid != $permissions->{$id}->{'directmember'}) {
+            if (!$groupid) {
+                $sth_remove_mapping->execute(
+                    $otherUserID, $id, 0, GRANT_DIRECT);
+                push(@groupsRemovedFrom, $name);
+            } else {
+                $sth_add_mapping->execute(
+                    $otherUserID, $id, 0, GRANT_DIRECT);
+                push(@groupsAddedTo, $name);
+            }
+        }
+
+        # Only members of the editusers group may change bless grants.
+        # Skip silently if this is not the case.
+        if ($editusers) {
+            my $groupid = $cgi->param("bless_$id") || 0;
+            if ($groupid != $permissions->{$id}->{'directbless'}) {
+                if (!$groupid) {
+                    $sth_remove_mapping->execute(
+                        $otherUserID, $id, 1, GRANT_DIRECT);
+                    push(@groupsDeniedRightsToBless, $name);
+                } else {
+                    $sth_add_mapping->execute(
+                        $otherUserID, $id, 1, GRANT_DIRECT);
+                    push(@groupsGrantedRightsToBless, $name);
+                }
+            }
+        }
+    }
+    if (@groupsAddedTo || @groupsRemovedFrom) {
+        $dbh->do(qq{INSERT INTO profiles_activity (
+                           userid, who,
+                           profiles_when, fieldid,
+                           oldvalue, newvalue
+                          ) VALUES (
+                           ?, ?, now(), ?, ?, ?
+                          )
+                   },
+                 undef,
+                 ($otherUserID, $userid,
+                  get_field_id('bug_group'),
+                  join(', ', @groupsRemovedFrom), join(', ', @groupsAddedTo)));
+    }
+    # XXX: should create profiles_activity entries for blesser changes.
+
+    $dbh->bz_commit_transaction();
+
+    # XXX: userDataToVars may be off when editing ourselves.
+    userDataToVars($otherUserID);
+    delete_token($token);
+
+    $vars->{'message'} = 'account_updated';
+    $vars->{'changed_fields'} = [keys %$changes];
+    $vars->{'groups_added_to'} = \@groupsAddedTo;
+    $vars->{'groups_removed_from'} = \@groupsRemovedFrom;
+    $vars->{'groups_granted_rights_to_bless'} = \@groupsGrantedRightsToBless;
+    $vars->{'groups_denied_rights_to_bless'} = \@groupsDeniedRightsToBless;
+    # We already display the updated page. We have to recreate a token now.
+    $vars->{'token'} = issue_session_token('edit_user');
+
+    $template->process('admin/users/edit.html.tmpl', $vars)
+       || ThrowTemplateError($template->error());
+
+###########################################################################
+} elsif ($action eq 'del') {
+    my $otherUser = check_user($otherUserID, $otherUserLogin);
+    $otherUserID = $otherUser->id;
+
+    Bugzilla->params->{'allowuserdeletion'} 
+        || ThrowUserError('users_deletion_disabled');
+    $editusers || ThrowUserError('auth_failure', {group  => "editusers",
+                                                  action => "delete",
+                                                  object => "users"});
+    $vars->{'otheruser'}      = $otherUser;
+
+    # Find other cross references.
+    $vars->{'attachments'} = $dbh->selectrow_array(
+        'SELECT COUNT(*) FROM attachments WHERE submitter_id = ?',
+        undef, $otherUserID);
+    $vars->{'assignee_or_qa'} = $dbh->selectrow_array(
+        qq{SELECT COUNT(*)
+           FROM bugs
+           WHERE assigned_to = ? OR qa_contact = ?},
+        undef, ($otherUserID, $otherUserID));
+    $vars->{'reporter'} = $dbh->selectrow_array(
+        'SELECT COUNT(*) FROM bugs WHERE reporter = ?',
+        undef, $otherUserID);
+    $vars->{'cc'} = $dbh->selectrow_array(
+        'SELECT COUNT(*) FROM cc WHERE who = ?',
+        undef, $otherUserID);
+    $vars->{'bugs_activity'} = $dbh->selectrow_array(
+        'SELECT COUNT(*) FROM bugs_activity WHERE who = ?',
+        undef, $otherUserID);
+    $vars->{'component_cc'} = $dbh->selectrow_array(
+        'SELECT COUNT(*) FROM component_cc WHERE user_id = ?',
+        undef, $otherUserID);
+    $vars->{'email_setting'} = $dbh->selectrow_array(
+        'SELECT COUNT(*) FROM email_setting WHERE user_id = ?',
+        undef, $otherUserID);
+    $vars->{'flags'}{'requestee'} = $dbh->selectrow_array(
+        'SELECT COUNT(*) FROM flags WHERE requestee_id = ?',
+        undef, $otherUserID);
+    $vars->{'flags'}{'setter'} = $dbh->selectrow_array(
+        'SELECT COUNT(*) FROM flags WHERE setter_id = ?',
+        undef, $otherUserID);
+    $vars->{'longdescs'} = $dbh->selectrow_array(
+        'SELECT COUNT(*) FROM longdescs WHERE who = ?',
+        undef, $otherUserID);
+    my $namedquery_ids = $dbh->selectcol_arrayref(
+        'SELECT id FROM namedqueries WHERE userid = ?',
+        undef, $otherUserID);
+    $vars->{'namedqueries'} = scalar(@$namedquery_ids);
+    if (scalar(@$namedquery_ids)) {
+        $vars->{'namedquery_group_map'} = $dbh->selectrow_array(
+            'SELECT COUNT(*) FROM namedquery_group_map WHERE namedquery_id IN' .
+            ' (' . join(', ', @$namedquery_ids) . ')');
+    }
+    else {
+        $vars->{'namedquery_group_map'} = 0;
+    }
+    $vars->{'profile_setting'} = $dbh->selectrow_array(
+        'SELECT COUNT(*) FROM profile_setting WHERE user_id = ?',
+        undef, $otherUserID);
+    $vars->{'profiles_activity'} = $dbh->selectrow_array(
+        'SELECT COUNT(*) FROM profiles_activity WHERE who = ? AND userid != ?',
+        undef, ($otherUserID, $otherUserID));
+    $vars->{'quips'} = $dbh->selectrow_array(
+        'SELECT COUNT(*) FROM quips WHERE userid = ?',
+        undef, $otherUserID);
+    $vars->{'series'} = $dbh->selectrow_array(
+        'SELECT COUNT(*) FROM series WHERE creator = ?',
+        undef, $otherUserID);
+    $vars->{'watch'}{'watched'} = $dbh->selectrow_array(
+        'SELECT COUNT(*) FROM watch WHERE watched = ?',
+        undef, $otherUserID);
+    $vars->{'watch'}{'watcher'} = $dbh->selectrow_array(
+        'SELECT COUNT(*) FROM watch WHERE watcher = ?',
+        undef, $otherUserID);
+    $vars->{'whine_events'} = $dbh->selectrow_array(
+        'SELECT COUNT(*) FROM whine_events WHERE owner_userid = ?',
+        undef, $otherUserID);
+    $vars->{'whine_schedules'} = $dbh->selectrow_array(
+        qq{SELECT COUNT(distinct eventid)
+           FROM whine_schedules
+           WHERE mailto = ?
+           AND mailto_type = ?
+          },
+        undef, ($otherUserID, MAILTO_USER));
+    $vars->{'token'} = issue_session_token('delete_user');
+
+    $template->process('admin/users/confirm-delete.html.tmpl', $vars)
+       || ThrowTemplateError($template->error());
+
+###########################################################################
+} elsif ($action eq 'delete') {
+    check_token_data($token, 'delete_user');
+    my $otherUser = check_user($otherUserID, $otherUserLogin);
+    $otherUserID = $otherUser->id;
+
+    # Cache for user accounts.
+    my %usercache = (0 => new Bugzilla::User());
+    my %updatedbugs;
+
+    # Lock tables during the check+removal session.
+    # XXX: if there was some change on these tables after the deletion
+    #      confirmation checks, we may do something here we haven't warned
+    #      about.
+    $dbh->bz_start_transaction();
+
+    Bugzilla->params->{'allowuserdeletion'}
+        || ThrowUserError('users_deletion_disabled');
+    $editusers || ThrowUserError('auth_failure',
+                                 {group  => "editusers",
+                                  action => "delete",
+                                  object => "users"});
+    @{$otherUser->product_responsibilities()}
+        && ThrowUserError('user_has_responsibility');
+
+    Bugzilla->logout_user($otherUser);
+
+    # Get the named query list so we can delete namedquery_group_map entries.
+    my $namedqueries_as_string = join(', ', @{$dbh->selectcol_arrayref(
+        'SELECT id FROM namedqueries WHERE userid = ?', undef, $otherUserID)});
+
+    # Get the timestamp for LogActivityEntry.
+    my $timestamp = $dbh->selectrow_array('SELECT NOW()');
+
+    # When we update a bug_activity entry, we update the bug timestamp, too.
+    my $sth_set_bug_timestamp =
+        $dbh->prepare('UPDATE bugs SET delta_ts = ? WHERE bug_id = ?');
+
+    my $sth_updateFlag = $dbh->prepare('INSERT INTO bugs_activity
+                  (bug_id, attach_id, who, bug_when, fieldid, removed, added)
+                  VALUES (?, ?, ?, ?, ?, ?, ?)');
+
+    # Flags
+    my $flag_ids =
+      $dbh->selectcol_arrayref('SELECT id FROM flags WHERE requestee_id = ?',
+                                undef, $otherUserID);
+
+    my $flags = Bugzilla::Flag->new_from_list($flag_ids);
+
+    $dbh->do('UPDATE flags SET requestee_id = NULL, modification_date = ?
+              WHERE requestee_id = ?', undef, ($timestamp, $otherUserID));
+
+    # We want to remove the requestee but leave the requester alone,
+    # so we have to log these changes manually.
+    my %bugs;
+    push(@{$bugs{$_->bug_id}->{$_->attach_id || 0}}, $_) foreach @$flags;
+    my $fieldid = get_field_id('flagtypes.name');
+    foreach my $bug_id (keys %bugs) {
+        foreach my $attach_id (keys %{$bugs{$bug_id}}) {
+            my @old_summaries = Bugzilla::Flag->snapshot($bugs{$bug_id}->{$attach_id});
+            $_->_set_requestee() foreach @{$bugs{$bug_id}->{$attach_id}};
+            my @new_summaries = Bugzilla::Flag->snapshot($bugs{$bug_id}->{$attach_id});
+            my ($removed, $added) =
+              Bugzilla::Flag->update_activity(\@old_summaries, \@new_summaries);
+            $sth_updateFlag->execute($bug_id, $attach_id || undef, $userid,
+                                     $timestamp, $fieldid, $removed, $added);
+        }
+        $sth_set_bug_timestamp->execute($timestamp, $bug_id);
+        $updatedbugs{$bug_id} = 1;
+    }
+
+    # Simple deletions in referred tables.
+    $dbh->do('DELETE FROM email_setting WHERE user_id = ?', undef,
+             $otherUserID);
+    $dbh->do('DELETE FROM logincookies WHERE userid = ?', undef, $otherUserID);
+    $dbh->do('DELETE FROM namedqueries WHERE userid = ?', undef, $otherUserID);
+    $dbh->do('DELETE FROM namedqueries_link_in_footer WHERE user_id = ?', undef,
+             $otherUserID);
+    if ($namedqueries_as_string) {
+        $dbh->do('DELETE FROM namedquery_group_map WHERE namedquery_id IN ' .
+                 "($namedqueries_as_string)");
+    }
+    $dbh->do('DELETE FROM profile_setting WHERE user_id = ?', undef,
+             $otherUserID);
+    $dbh->do('DELETE FROM profiles_activity WHERE userid = ? OR who = ?', undef,
+             ($otherUserID, $otherUserID));
+    $dbh->do('DELETE FROM tokens WHERE userid = ?', undef, $otherUserID);
+    $dbh->do('DELETE FROM user_group_map WHERE user_id = ?', undef,
+             $otherUserID);
+    $dbh->do('DELETE FROM watch WHERE watcher = ? OR watched = ?', undef,
+             ($otherUserID, $otherUserID));
+
+    # Deletions in referred tables which need LogActivityEntry.
+    my $buglist = $dbh->selectcol_arrayref('SELECT bug_id FROM cc WHERE who = ?',
+                                            undef, $otherUserID);
+    $dbh->do('DELETE FROM cc WHERE who = ?', undef, $otherUserID);
+    foreach my $bug_id (@$buglist) {
+        LogActivityEntry($bug_id, 'cc', $otherUser->login, '', $userid,
+                         $timestamp);
+        $sth_set_bug_timestamp->execute($timestamp, $bug_id);
+        $updatedbugs{$bug_id} = 1;
+    }
+
+    # Even more complex deletions in referred tables.
+    my $id;
+
+    # 1) Series
+    my $sth_seriesid = $dbh->prepare(
+           'SELECT series_id FROM series WHERE creator = ?');
+    my $sth_deleteSeries = $dbh->prepare(
+           'DELETE FROM series WHERE series_id = ?');
+    my $sth_deleteSeriesData = $dbh->prepare(
+           'DELETE FROM series_data WHERE series_id = ?');
+
+    $sth_seriesid->execute($otherUserID);
+    while ($id = $sth_seriesid->fetchrow_array()) {
+        $sth_deleteSeriesData->execute($id);
+        $sth_deleteSeries->execute($id);
+    }
+
+    # 2) Whines
+    my $sth_whineidFromEvents = $dbh->prepare(
+           'SELECT id FROM whine_events WHERE owner_userid = ?');
+    my $sth_deleteWhineEvent = $dbh->prepare(
+           'DELETE FROM whine_events WHERE id = ?');
+    my $sth_deleteWhineQuery = $dbh->prepare(
+           'DELETE FROM whine_queries WHERE eventid = ?');
+    my $sth_deleteWhineSchedule = $dbh->prepare(
+           'DELETE FROM whine_schedules WHERE eventid = ?');
+
+    $dbh->do('DELETE FROM whine_schedules WHERE mailto = ? AND mailto_type = ?',
+             undef, ($otherUserID, MAILTO_USER));
+
+    $sth_whineidFromEvents->execute($otherUserID);
+    while ($id = $sth_whineidFromEvents->fetchrow_array()) {
+        $sth_deleteWhineQuery->execute($id);
+        $sth_deleteWhineSchedule->execute($id);
+        $sth_deleteWhineEvent->execute($id);
+    }
+
+    # 3) Bugs
+    # 3.1) fall back to the default assignee
+    $buglist = $dbh->selectall_arrayref(
+        'SELECT bug_id, initialowner
+         FROM bugs
+         INNER JOIN components ON components.id = bugs.component_id
+         WHERE assigned_to = ?', undef, $otherUserID);
+
+    my $sth_updateAssignee = $dbh->prepare(
+        'UPDATE bugs SET assigned_to = ?, delta_ts = ? WHERE bug_id = ?');
+
+    foreach my $bug (@$buglist) {
+        my ($bug_id, $default_assignee_id) = @$bug;
+        $sth_updateAssignee->execute($default_assignee_id,
+                                     $timestamp, $bug_id);
+        $updatedbugs{$bug_id} = 1;
+        $default_assignee_id ||= 0;
+        $usercache{$default_assignee_id} ||=
+            new Bugzilla::User($default_assignee_id);
+        LogActivityEntry($bug_id, 'assigned_to', $otherUser->login,
+                         $usercache{$default_assignee_id}->login,
+                         $userid, $timestamp);
+    }
+
+    # 3.2) fall back to the default QA contact
+    $buglist = $dbh->selectall_arrayref(
+        'SELECT bug_id, initialqacontact
+         FROM bugs
+         INNER JOIN components ON components.id = bugs.component_id
+         WHERE qa_contact = ?', undef, $otherUserID);
+
+    my $sth_updateQAcontact = $dbh->prepare(
+        'UPDATE bugs SET qa_contact = ?, delta_ts = ? WHERE bug_id = ?');
+
+    foreach my $bug (@$buglist) {
+        my ($bug_id, $default_qa_contact_id) = @$bug;
+        $sth_updateQAcontact->execute($default_qa_contact_id,
+                                      $timestamp, $bug_id);
+        $updatedbugs{$bug_id} = 1;
+        $default_qa_contact_id ||= 0;
+        $usercache{$default_qa_contact_id} ||=
+            new Bugzilla::User($default_qa_contact_id);
+        LogActivityEntry($bug_id, 'qa_contact', $otherUser->login,
+                         $usercache{$default_qa_contact_id}->login,
+                         $userid, $timestamp);
+    }
+
+    # Finally, remove the user account itself.
+    $dbh->do('DELETE FROM profiles WHERE userid = ?', undef, $otherUserID);
+
+    $dbh->bz_commit_transaction();
+    delete_token($token);
+
+    $vars->{'message'} = 'account_deleted';
+    $vars->{'otheruser'}{'login'} = $otherUser->login;
+    $vars->{'restrictablegroups'} = $user->bless_groups();
+    $template->process('admin/users/search.html.tmpl', $vars)
+       || ThrowTemplateError($template->error());
+
+    # Send mail about what we've done to bugs.
+    # The deleted user is not notified of the changes.
+    foreach (keys(%updatedbugs)) {
+        Bugzilla::BugMail::Send($_, {'changer' => $user} );
+    }
+
+###########################################################################
+} elsif ($action eq 'activity') {
+    my $otherUser = check_user($otherUserID, $otherUserLogin);
+
+    $vars->{'profile_changes'} = $dbh->selectall_arrayref(
+        "SELECT profiles.login_name AS who, " .
+                $dbh->sql_date_format('profiles_activity.profiles_when') . " AS activity_when,
+                fielddefs.name AS what,
+                profiles_activity.oldvalue AS removed,
+                profiles_activity.newvalue AS added
+         FROM profiles_activity
+         INNER JOIN profiles ON profiles_activity.who = profiles.userid
+         INNER JOIN fielddefs ON fielddefs.id = profiles_activity.fieldid
+         WHERE profiles_activity.userid = ?
+         ORDER BY profiles_activity.profiles_when",
+        {'Slice' => {}},
+        $otherUser->id);
+
+    $vars->{'otheruser'} = $otherUser;
+
+    $template->process("account/profile-activity.html.tmpl", $vars)
+        || ThrowTemplateError($template->error());
+
+###########################################################################
+} else {
+    ThrowUserError('unknown_action', {action => $action});
+}
+
+exit;
+
+###########################################################################
+# Helpers
+###########################################################################
+
+# Try to build a user object using its ID, else its login name, and throw
+# an error if the user does not exist.
+sub check_user {
+    my ($otherUserID, $otherUserLogin) = @_;
+
+    my $otherUser;
+    my $vars = {};
+
+    if ($otherUserID) {
+        $otherUser = Bugzilla::User->new($otherUserID);
+        $vars->{'user_id'} = $otherUserID;
+    }
+    elsif ($otherUserLogin) {
+        $otherUser = new Bugzilla::User({ name => $otherUserLogin });
+        $vars->{'user_login'} = $otherUserLogin;
+    }
+    ($otherUser && $otherUser->id) || ThrowUserError('invalid_user', $vars);
+
+    return $otherUser;
+}
+
+# Copy incoming list selection values from CGI params to template variables.
+sub mirrorListSelectionValues {
+    my $cgi = Bugzilla->cgi;
+    if (defined($cgi->param('matchtype'))) {
+        foreach ('matchvalue', 'matchstr', 'matchtype', 'grouprestrict', 'groupid') {
+            $vars->{'listselectionvalues'}{$_} = $cgi->param($_);
+        }
+    }
+}
+
+# Retrieve user data for the user editing form. User creation and user
+# editing code rely on this to call derive_groups().
+sub userDataToVars {
+    my $otheruserid = shift;
+    my $otheruser = new Bugzilla::User($otheruserid);
+    my $query;
+    my $user = Bugzilla->user;
+    my $dbh = Bugzilla->dbh;
+
+    my $grouplist = $otheruser->groups_as_string;
+
+    $vars->{'otheruser'} = $otheruser;
+    $vars->{'groups'} = $user->bless_groups();
+
+    $vars->{'permissions'} = $dbh->selectall_hashref(
+        qq{SELECT id,
+                  COUNT(directmember.group_id) AS directmember,
+                  COUNT(regexpmember.group_id) AS regexpmember,
+                  (CASE WHEN (groups.id IN ($grouplist)
+                              AND COUNT(directmember.group_id) = 0
+                              AND COUNT(regexpmember.group_id) = 0
+                             ) THEN 1 ELSE 0 END) 
+                      AS derivedmember,
+                  COUNT(directbless.group_id) AS directbless
+           FROM groups
+           LEFT JOIN user_group_map AS directmember
+                  ON directmember.group_id = id
+                 AND directmember.user_id = ?
+                 AND directmember.isbless = 0
+                 AND directmember.grant_type = ?
+           LEFT JOIN user_group_map AS regexpmember
+                  ON regexpmember.group_id = id
+                 AND regexpmember.user_id = ?
+                 AND regexpmember.isbless = 0
+                 AND regexpmember.grant_type = ?
+           LEFT JOIN user_group_map AS directbless
+                  ON directbless.group_id = id
+                 AND directbless.user_id = ?
+                 AND directbless.isbless = 1
+                 AND directbless.grant_type = ?
+          } . $dbh->sql_group_by('id'),
+        'id', undef,
+        ($otheruserid, GRANT_DIRECT,
+         $otheruserid, GRANT_REGEXP,
+         $otheruserid, GRANT_DIRECT));
+
+    # Find indirect bless permission.
+    $query = qq{SELECT groups.id
+                FROM groups, group_group_map AS ggm
+                WHERE groups.id = ggm.grantor_id
+                  AND ggm.member_id IN ($grouplist)
+                  AND ggm.grant_type = ?
+               } . $dbh->sql_group_by('id');
+    foreach (@{$dbh->selectall_arrayref($query, undef,
+                                        (GROUP_BLESS))}) {
+        # Merge indirect bless permissions into permission variable.
+        $vars->{'permissions'}{${$_}[0]}{'indirectbless'} = 1;
+    }
+}
+
+sub edit_processing {
+    my $otherUser = shift;
+    my $user = Bugzilla->user;
+    my $template = Bugzilla->template;
+
+    $user->in_group('editusers') || $user->can_see_user($otherUser)
+        || ThrowUserError('auth_failure', {reason => "not_visible",
+                                           action => "modify",
+                                           object => "user"});
+
+    userDataToVars($otherUser->id);
+    $vars->{'token'} = issue_session_token('edit_user');
+
+    $template->process('admin/users/edit.html.tmpl', $vars)
+       || ThrowTemplateError($template->error());
+}

diff --git a/editvalues.cgi b/editvalues.cgi
new file mode 100755 (executable)
index 0000000..60c39c9
--- /dev/null
+++ b/editvalues.cgi
@@ -0,0 +1,192 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# This is a script to edit the values of fields that have drop-down
+# or select boxes. It is largely a copy of editmilestones.cgi, but 
+# with some cleanup.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Constants;
+use Bugzilla::Token;
+use Bugzilla::Field;
+use Bugzilla::Field::Choice;
+
+###############
+# Subroutines #
+###############
+
+sub display_field_values {
+    my $vars = shift;
+    my $template = Bugzilla->template;
+    $vars->{'values'} = $vars->{'field'}->legal_values;
+    $template->process("admin/fieldvalues/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+######################################################################
+# Main Body Execution
+######################################################################
+
+# require the user to have logged in
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+my $dbh      = Bugzilla->dbh;
+my $cgi      = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $vars = {};
+
+# Replace this entry by separate entries in templates when
+# the documentation about legal values becomes bigger.
+$vars->{'doc_section'} = 'edit-values.html';
+
+print $cgi->header();
+
+$user->in_group('admin')
+  || ThrowUserError('auth_failure', {group  => "admin",
+                                     action => "edit",
+                                     object => "field_values"});
+
+#
+# often-used variables
+#
+my $action = trim($cgi->param('action')  || '');
+my $token  = $cgi->param('token');
+
+#
+# field = '' -> Show nice list of fields
+#
+if (!$cgi->param('field')) {
+    my @field_list =
+        @{ Bugzilla->fields({ is_select => 1, is_abnormal => 0 }) };
+
+    $vars->{'fields'} = \@field_list;
+    $template->process("admin/fieldvalues/select-field.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+# At this point, the field must be defined.
+my $field = Bugzilla::Field->check($cgi->param('field'));
+if (!$field->is_select || $field->is_abnormal) {
+    ThrowUserError('fieldname_invalid', { field => $field });
+}
+$vars->{'field'} = $field;
+
+#
+# action='' -> Show nice list of values.
+#
+display_field_values($vars) unless $action;
+
+#
+# action='add' -> show form for adding new field value.
+# (next action will be 'new')
+#
+if ($action eq 'add') {
+    $vars->{'token'} = issue_session_token('add_field_value');
+    $template->process("admin/fieldvalues/create.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+#
+# action='new' -> add field value entered in the 'action=add' screen
+#
+if ($action eq 'new') {
+    check_token_data($token, 'add_field_value');
+
+    my $created_value = Bugzilla::Field::Choice->type($field)->create({
+        value   => scalar $cgi->param('value'), 
+        sortkey => scalar $cgi->param('sortkey'),
+        is_open => scalar $cgi->param('is_open'),
+        visibility_value_id => scalar $cgi->param('visibility_value_id'),
+    });
+
+    delete_token($token);
+
+    $vars->{'message'} = 'field_value_created';
+    $vars->{'value'} = $created_value;
+    display_field_values($vars);
+}
+
+# After this, we always have a value
+my $value = Bugzilla::Field::Choice->type($field)->check($cgi->param('value'));
+$vars->{'value'} = $value;
+
+#
+# action='del' -> ask if user really wants to delete
+# (next action would be 'delete')
+#
+if ($action eq 'del') {
+    # If the value cannot be deleted, throw an error.
+    if ($value->is_static) {
+        ThrowUserError('fieldvalue_not_deletable', $vars);
+    }
+    $vars->{'token'} = issue_session_token('delete_field_value');
+
+    $template->process("admin/fieldvalues/confirm-delete.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+
+    exit;
+}
+
+
+#
+# action='delete' -> really delete the field value
+#
+if ($action eq 'delete') {
+    check_token_data($token, 'delete_field_value');
+    $value->remove_from_db();
+    delete_token($token);
+    $vars->{'message'} = 'field_value_deleted';
+    $vars->{'no_edit_link'} = 1;
+    display_field_values($vars);
+}
+
+
+#
+# action='edit' -> present the edit-value form
+# (next action would be 'update')
+#
+if ($action eq 'edit') {
+    $vars->{'token'} = issue_session_token('edit_field_value');
+    $template->process("admin/fieldvalues/edit.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+
+    exit;
+}
+
+
+#
+# action='update' -> update the field value
+#
+if ($action eq 'update') {
+    check_token_data($token, 'edit_field_value');
+    $vars->{'value_old'} = $value->name;
+    my %params = (
+        name    => scalar $cgi->param('value_new'),
+        sortkey => scalar $cgi->param('sortkey'),
+        visibility_value => scalar $cgi->param('visibility_value_id'),
+    );
+    if ($cgi->should_set('is_active')) {
+        $params{is_active} = $cgi->param('is_active');
+    }
+    $value->set_all(\%params);
+    $vars->{'changes'} = $value->update();
+    delete_token($token);
+    $vars->{'message'} = 'field_value_updated';
+    display_field_values($vars);
+}
+
+# No valid action found
+ThrowUserError('unknown_action', {action => $action});

diff --git a/editversions.cgi b/editversions.cgi
new file mode 100755 (executable)
index 0000000..4951c27
--- /dev/null
+++ b/editversions.cgi
@@ -0,0 +1,208 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Version;
+use Bugzilla::Token;
+
+my $cgi = Bugzilla->cgi;
+my $dbh = Bugzilla->dbh;
+my $template = Bugzilla->template;
+my $vars = {};
+# There is only one section about versions in the documentation,
+# so all actions point to the same page.
+$vars->{'doc_section'} = 'versions.html';
+
+#
+# Preliminary checks:
+#
+
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+print $cgi->header();
+
+$user->in_group('editcomponents')
+  || scalar(@{$user->get_products_by_permission('editcomponents')})
+  || ThrowUserError("auth_failure", {group  => "editcomponents",
+                                     action => "edit",
+                                     object => "versions"});
+
+#
+# often used variables
+#
+my $product_name = trim($cgi->param('product') || '');
+my $version_name = trim($cgi->param('version') || '');
+my $action       = trim($cgi->param('action')  || '');
+my $showbugcounts = (defined $cgi->param('showbugcounts'));
+my $token        = $cgi->param('token');
+my $isactive     = $cgi->param('isactive');
+
+#
+# product = '' -> Show nice list of products
+#
+
+unless ($product_name) {
+    my $selectable_products = $user->get_selectable_products;
+    # If the user has editcomponents privs for some products only,
+    # we have to restrict the list of products to display.
+    unless ($user->in_group('editcomponents')) {
+        $selectable_products = $user->get_products_by_permission('editcomponents');
+    }
+    $vars->{'products'} = $selectable_products;
+    $vars->{'showbugcounts'} = $showbugcounts;
+
+    $template->process("admin/versions/select-product.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+my $product = $user->check_can_admin_product($product_name);
+
+#
+# action='' -> Show nice list of versions
+#
+
+unless ($action) {
+    $vars->{'showbugcounts'} = $showbugcounts;
+    $vars->{'product'} = $product;
+    $template->process("admin/versions/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+
+    exit;
+}
+
+#
+# action='add' -> present form for parameters for new version
+#
+# (next action will be 'new')
+#
+
+if ($action eq 'add') {
+    $vars->{'token'} = issue_session_token('add_version');
+    $vars->{'product'} = $product;
+    $template->process("admin/versions/create.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+
+    exit;
+}
+
+#
+# action='new' -> add version entered in the 'action=add' screen
+#
+
+if ($action eq 'new') {
+    check_token_data($token, 'add_version');
+    my $version = Bugzilla::Version->create(
+        { value => $version_name, product => $product });
+    delete_token($token);
+
+    $vars->{'message'} = 'version_created';
+    $vars->{'version'} = $version;
+    $vars->{'product'} = $product;
+    $template->process("admin/versions/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+
+    exit;
+}
+
+#
+# action='del' -> ask if user really wants to delete
+#
+# (next action would be 'delete')
+#
+
+if ($action eq 'del') {
+    my $version = Bugzilla::Version->check({ product => $product,
+                                             name    => $version_name });
+    $vars->{'version'} = $version;
+    $vars->{'product'} = $product;
+    $vars->{'token'} = issue_session_token('delete_version');
+    $template->process("admin/versions/confirm-delete.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+
+    exit;
+}
+
+#
+# action='delete' -> really delete the version
+#
+
+if ($action eq 'delete') {
+    check_token_data($token, 'delete_version');
+    my $version = Bugzilla::Version->check({ product => $product, 
+                                             name    => $version_name });
+    $version->remove_from_db;
+    delete_token($token);
+
+    $vars->{'message'} = 'version_deleted';
+    $vars->{'version'} = $version;
+    $vars->{'product'} = $product;
+    $vars->{'no_edit_version_link'} = 1;
+
+    $template->process("admin/versions/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+
+    exit;
+}
+
+#
+# action='edit' -> present the edit version form
+#
+# (next action would be 'update')
+#
+
+if ($action eq 'edit') {
+    my $version = Bugzilla::Version->check({ product => $product,
+                                             name    => $version_name });
+    $vars->{'version'} = $version;
+    $vars->{'product'} = $product;
+    $vars->{'token'} = issue_session_token('edit_version');
+
+    $template->process("admin/versions/edit.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+
+    exit;
+}
+
+#
+# action='update' -> update the version
+#
+
+if ($action eq 'update') {
+    check_token_data($token, 'edit_version');
+    my $version_old_name = trim($cgi->param('versionold') || '');
+    my $version = Bugzilla::Version->check({ product => $product,
+                                             name   => $version_old_name });
+
+    $dbh->bz_start_transaction();
+
+    $version->set_name($version_name);
+    $version->set_is_active($isactive);
+    my $changes = $version->update();
+
+    $dbh->bz_commit_transaction();
+    delete_token($token);
+
+    $vars->{'message'} = 'version_updated';
+    $vars->{'version'} = $version;
+    $vars->{'product'} = $product;
+    $vars->{'changes'} = $changes;
+    $template->process("admin/versions/list.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+
+    exit;
+}
+
+# No valid action found
+ThrowUserError('unknown_action', {action => $action});

diff --git a/editwhines.cgi b/editwhines.cgi
new file mode 100755 (executable)
index 0000000..5227f1d
--- /dev/null
+++ b/editwhines.cgi
@@ -0,0 +1,399 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+################################################################################
+# Script Initialization
+################################################################################
+
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::User;
+use Bugzilla::Group;
+use Bugzilla::Token;
+use Bugzilla::Whine::Schedule;
+use Bugzilla::Whine::Query;
+use Bugzilla::Whine;
+
+# require the user to have logged in
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+###############################################################################
+# Main Body Execution
+###############################################################################
+
+my $cgi      = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $vars     = {};
+my $dbh      = Bugzilla->dbh;
+
+my $userid   = $user->id;
+my $token    = $cgi->param('token');
+my $sth; # database statement handle
+
+# $events is a hash ref of Bugzilla::Whine objects keyed by event id,
+# that stores the active user's events.
+#
+# Eventually, it winds up with:
+#  'queries'  - array ref containing hashes of:
+#       'name'          - the name of the saved query
+#       'title'         - The title line for the search results table
+#       'sort'          - Numeric sort ID
+#       'id'            - row ID for the query entry
+#       'onemailperbug' - whether a single message must be sent for each
+#                         result.
+#  'schedule' - array ref containing hashes of:
+#       'day' - Day or range of days this schedule will be run
+#       'time' - time or interval to run
+#       'mailto_type' - MAILTO_USER or MAILTO_GROUP
+#       'mailto' - person/group who will receive the results
+#       'id' - row ID for the schedule
+my $events = get_events($userid);
+
+# First see if this user may use whines
+$user->in_group('bz_canusewhines')
+  || ThrowUserError("auth_failure", {group  => "bz_canusewhines",
+                                     action => "schedule",
+                                     object => "reports"});
+
+# May this user send mail to other users?
+my $can_mail_others = $user->in_group('bz_canusewhineatothers');
+
+# If the form was submitted, we need to look for what needs to be added or
+# removed, then what was altered.
+
+if ($cgi->param('update')) {
+    check_token_data($token, 'edit_whine');
+
+    if ($cgi->param("add_event")) {
+        # we create a new event
+        $sth = $dbh->prepare("INSERT INTO whine_events " .
+                             "(owner_userid) " .
+                             "VALUES (?)");
+        $sth->execute($userid);
+    }
+    else {
+        for my $eventid (keys %{$events}) {
+            # delete an entire event
+            if ($cgi->param("remove_event_$eventid")) {
+                # We need to make sure these belong to the same user,
+                # otherwise we could simply delete whatever matched that ID.
+                #
+                # schedules
+                my $schedules = Bugzilla::Whine::Schedule->match({ eventid => $eventid });
+                $sth = $dbh->prepare("DELETE FROM whine_schedules "
+                    . "WHERE id=?");
+                foreach my $schedule (@$schedules) {                    
+                    $sth->execute($schedule->id);
+                }
+
+                # queries
+                $sth = $dbh->prepare("SELECT whine_queries.id " .
+                                     "FROM whine_queries " .
+                                     "LEFT JOIN whine_events " .
+                                     "ON whine_events.id = " .
+                                     "whine_queries.eventid " .
+                                     "WHERE whine_events.id = ? " .
+                                     "AND whine_events.owner_userid = ?");
+                $sth->execute($eventid, $userid);
+                my @ids = @{$sth->fetchall_arrayref};
+                $sth = $dbh->prepare("DELETE FROM whine_queries " .
+                                     "WHERE id=?");
+                for (@ids) {
+                    my $delete_id = $_->[0];
+                    $sth->execute($delete_id);
+                }
+
+                # events
+                $sth = $dbh->prepare("DELETE FROM whine_events " .
+                                     "WHERE id=? AND owner_userid=?");
+                $sth->execute($eventid, $userid);
+            }
+            else {
+                # check the subject, body and mailifnobugs for changes
+                my $subject = ($cgi->param("event_${eventid}_subject") or '');
+                my $body    = ($cgi->param("event_${eventid}_body")    or '');
+                my $mailifnobugs = $cgi->param("event_${eventid}_mailifnobugs") ? 1 : 0;
+
+                trick_taint($subject) if $subject;
+                trick_taint($body)    if $body;
+
+                if ( ($subject ne $events->{$eventid}->subject)
+                  || ($mailifnobugs != $events->{$eventid}->mail_if_no_bugs)
+                  || ($body    ne $events->{$eventid}->body) ) {
+
+                    $sth = $dbh->prepare("UPDATE whine_events " .
+                                         "SET subject=?, body=?, mailifnobugs=? " .
+                                         "WHERE id=?");
+                    $sth->execute($subject, $body, $mailifnobugs, $eventid);
+                }
+
+                # add a schedule
+                if ($cgi->param("add_schedule_$eventid")) {
+                    # the schedule table must be locked before altering
+                    $sth = $dbh->prepare("INSERT INTO whine_schedules " .
+                                         "(eventid, mailto_type, mailto, " .
+                                         "run_day, run_time) " .
+                                         "VALUES (?, ?, ?, 'Sun', 2)");
+                    $sth->execute($eventid, MAILTO_USER, $userid);
+                }
+                # add a query
+                elsif ($cgi->param("add_query_$eventid")) {
+                    $sth = $dbh->prepare("INSERT INTO whine_queries "
+                        . "(eventid) "
+                        . "VALUES (?)");
+                    $sth->execute($eventid);
+                }
+            }
+
+            # now check all of the schedules and queries to see if they need
+            # to be altered or deleted
+
+            # Check schedules for changes
+            my $schedules = Bugzilla::Whine::Schedule->match({ eventid => $eventid });
+            my @scheduleids = ();
+            foreach my $schedule (@$schedules) {
+                push @scheduleids, $schedule->id;
+            }
+
+            # we need to double-check all of the user IDs in mailto to make
+            # sure they exist
+            my $arglist = {};   # args for match_field
+            for my $sid (@scheduleids) {
+                if ($cgi->param("mailto_type_$sid") == MAILTO_USER) {
+                    $arglist->{"mailto_$sid"} = {
+                        'type' => 'single',
+                    };
+                }
+            }
+            if (scalar %{$arglist}) {
+                Bugzilla::User::match_field($arglist);
+            }
+
+            for my $sid (@scheduleids) {
+                if ($cgi->param("remove_schedule_$sid")) {
+                    # having the assignee id in here is a security failsafe
+                    $sth = $dbh->prepare("SELECT whine_schedules.id " .
+                                         "FROM whine_schedules " .
+                                         "LEFT JOIN whine_events " .
+                                         "ON whine_events.id = " .
+                                         "whine_schedules.eventid " .
+                                         "WHERE whine_events.owner_userid=? " .
+                                         "AND whine_schedules.id =?");
+                    $sth->execute($userid, $sid);
+
+                    my @ids = @{$sth->fetchall_arrayref};
+                    for (@ids) {
+                        $sth = $dbh->prepare("DELETE FROM whine_schedules " .
+                                             "WHERE id=?");
+                        $sth->execute($_->[0]);
+                    }
+                }
+                else {
+                    my $o_day         = $cgi->param("orig_day_$sid") || '';
+                    my $day           = $cgi->param("day_$sid") || '';
+                    my $o_time        = $cgi->param("orig_time_$sid") || 0;
+                    my $time          = $cgi->param("time_$sid") || 0;
+                    my $o_mailto      = $cgi->param("orig_mailto_$sid") || '';
+                    my $mailto        = $cgi->param("mailto_$sid") || '';
+                    my $o_mailto_type = $cgi->param("orig_mailto_type_$sid") || 0;
+                    my $mailto_type   = $cgi->param("mailto_type_$sid") || 0;
+
+                    my $mailto_id = $userid;
+
+                    # get an id for the mailto address
+                    if ($can_mail_others && $mailto) {
+                        if ($mailto_type == MAILTO_USER) {
+                            $mailto_id = login_to_id($mailto);
+                        }
+                        elsif ($mailto_type == MAILTO_GROUP) {
+                            # The group name is used in a placeholder.
+                            trick_taint($mailto);
+                            $mailto_id = Bugzilla::Group::ValidateGroupName($mailto, ($user))
+                                           || ThrowUserError('invalid_group_name', { name => $mailto });
+                        }
+                        else {
+                            # bad value, so it will just mail to the whine
+                            # owner.  $mailto_id was already set above.
+                            $mailto_type = MAILTO_USER;
+                        }
+                    }
+
+                    detaint_natural($mailto_type);
+
+                    if ( ($o_day  ne $day) ||
+                         ($o_time ne $time) ||
+                         ($o_mailto ne $mailto) ||
+                         ($o_mailto_type != $mailto_type) ){
+
+                        trick_taint($day);
+                        trick_taint($time);
+
+                        # the schedule table must be locked
+                        $sth = $dbh->prepare("UPDATE whine_schedules " .
+                                             "SET run_day=?, run_time=?, " .
+                                             "mailto_type=?, mailto=?, " .
+                                             "run_next=NULL " .
+                                             "WHERE id=?");
+                        $sth->execute($day, $time, $mailto_type,
+                                      $mailto_id, $sid);
+                    }
+                }
+            }
+
+            # Check queries for changes
+            my $queries = Bugzilla::Whine::Query->match({ eventid => $eventid });
+            for my $query (@$queries) {
+                my $qid = $query->id;
+                if ($cgi->param("remove_query_$qid")) {
+
+                    $sth = $dbh->prepare("SELECT whine_queries.id " .
+                                         "FROM whine_queries " .
+                                         "LEFT JOIN whine_events " .
+                                         "ON whine_events.id = " .
+                                         "whine_queries.eventid " .
+                                         "WHERE whine_events.owner_userid=? " .
+                                         "AND whine_queries.id =?");
+                    $sth->execute($userid, $qid);
+
+                    for (@{$sth->fetchall_arrayref}) {
+                        $sth = $dbh->prepare("DELETE FROM whine_queries " .
+                                             "WHERE id=?");
+                        $sth->execute($_->[0]);
+                    }
+                }
+                else {
+                    my $o_sort      = $cgi->param("orig_query_sort_$qid") || 0;
+                    my $sort        = $cgi->param("query_sort_$qid") || 0;
+                    my $o_queryname = $cgi->param("orig_query_name_$qid") || '';
+                    my $queryname   = $cgi->param("query_name_$qid") || '';
+                    my $o_title     = $cgi->param("orig_query_title_$qid") || '';
+                    my $title       = $cgi->param("query_title_$qid") || '';
+                    my $o_onemailperbug =
+                            $cgi->param("orig_query_onemailperbug_$qid") || 0;
+                    my $onemailperbug   =
+                            $cgi->param("query_onemailperbug_$qid") ? 1 : 0;
+
+                    if ( ($o_sort != $sort) ||
+                         ($o_queryname ne $queryname) ||
+                         ($o_onemailperbug != $onemailperbug) ||
+                         ($o_title ne $title) ){
+
+                        detaint_natural($sort);
+                        trick_taint($queryname);
+                        trick_taint($title);
+
+                        $sth = $dbh->prepare("UPDATE whine_queries " .
+                                             "SET sortkey=?, " .
+                                             "query_name=?, " .
+                                             "title=?, " .
+                                             "onemailperbug=? " .
+                                             "WHERE id=?");
+                        $sth->execute($sort, $queryname, $title,
+                                      $onemailperbug, $qid);
+                    }
+                }
+            }
+        }
+    }
+    delete_token($token);
+}
+
+$vars->{'mail_others'} = $can_mail_others;
+
+# Return the appropriate HTTP response headers.
+print $cgi->header();
+
+# Get events again, to cover any updates that were made
+$events = get_events($userid);
+
+# Here is the data layout as sent to the template:
+#
+#   events
+#       event_id #
+#           schedule
+#               day
+#               time
+#               mailto
+#           queries
+#               name
+#               title
+#               sort
+#
+# build the whine list by event id
+for my $event_id (keys %{$events}) {
+    $events->{$event_id}->{'schedule'} = [];
+    $events->{$event_id}->{'queries'} = [];
+
+    # schedules
+    my $schedules = Bugzilla::Whine::Schedule->match({ eventid => $event_id });
+    foreach my $schedule (@$schedules) {
+        my $mailto_type = $schedule->mailto_is_group ? MAILTO_GROUP 
+                                                     : MAILTO_USER;
+        my $mailto = '';
+        if ($mailto_type == MAILTO_USER) {
+            $mailto = $schedule->mailto->login;
+        }
+        elsif ($mailto_type == MAILTO_GROUP) {
+            $mailto = $schedule->mailto->name;
+        }
+
+        push @{$events->{$event_id}->{'schedule'}},
+             {
+                 'day'         => $schedule->run_day,
+                 'time'        => $schedule->run_time,
+                 'mailto_type' => $mailto_type,
+                 'mailto'      => $mailto,
+                 'id'          => $schedule->id,
+             };
+    }
+
+    # queries
+    my $queries = Bugzilla::Whine::Query->match({ eventid => $event_id });
+    for my $query (@$queries) {
+        push @{$events->{$event_id}->{'queries'}}, 
+             {
+                 'name'          => $query->name,
+                 'title'         => $query->title,
+                 'sort'          => $query->sortkey,
+                 'id'            => $query->id,
+                 'onemailperbug' => $query->one_email_per_bug,
+             };
+    }
+}
+
+$vars->{'events'} = $events;
+
+# get the available queries
+$sth = $dbh->prepare("SELECT name FROM namedqueries WHERE userid=?");
+$sth->execute($userid);
+
+$vars->{'available_queries'} = [];
+while (my ($query) = $sth->fetchrow_array) {
+    push @{$vars->{'available_queries'}}, $query;
+}
+$vars->{'token'} = issue_session_token('edit_whine');
+$vars->{'local_timezone'} = Bugzilla->local_timezone->short_name_for_datetime(DateTime->now());
+
+$template->process("whine/schedule.html.tmpl", $vars)
+  || ThrowTemplateError($template->error());
+
+# get_events takes a userid and returns a hash of
+# Bugzilla::Whine objects keyed by event ID.
+sub get_events {
+    my $userid = shift;
+    my $event_rows = Bugzilla::Whine->match({ owner_userid => $userid });
+    my %events = map { $_->{id} => $_ } @$event_rows;
+
+    return \%events;
+}

diff --git a/editworkflow.cgi b/editworkflow.cgi
new file mode 100755 (executable)
index 0000000..36b8ab8
--- /dev/null
+++ b/editworkflow.cgi
@@ -0,0 +1,138 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Token;
+use Bugzilla::Status;
+
+my $cgi = Bugzilla->cgi;
+my $dbh = Bugzilla->dbh;
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+print $cgi->header();
+
+$user->in_group('admin')
+  || ThrowUserError('auth_failure', {group  => 'admin',
+                                     action => 'modify',
+                                     object => 'workflow'});
+
+my $action = $cgi->param('action') || 'edit';
+my $token = $cgi->param('token');
+
+sub get_workflow {
+    my $dbh = Bugzilla->dbh;
+    my $workflow = $dbh->selectall_arrayref('SELECT old_status, new_status, require_comment
+                                             FROM status_workflow');
+    my %workflow;
+    foreach my $row (@$workflow) {
+        my ($old, $new, $type) = @$row;
+        $workflow{$old || 0}{$new} = $type;
+    }
+    return \%workflow;
+}
+
+sub load_template {
+    my ($filename, $message) = @_;
+    my $template = Bugzilla->template;
+    my $vars = {};
+
+    $vars->{'statuses'} = [Bugzilla::Status->get_all];
+    $vars->{'workflow'} = get_workflow();
+    $vars->{'token'} = issue_session_token("workflow_$filename");
+    $vars->{'message'} = $message;
+
+    $template->process("admin/workflow/$filename.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+if ($action eq 'edit') {
+    load_template('edit');
+}
+elsif ($action eq 'update') {
+    check_token_data($token, 'workflow_edit');
+    my $statuses = [Bugzilla::Status->get_all];
+    my $workflow = get_workflow();
+
+    my $sth_insert = $dbh->prepare('INSERT INTO status_workflow (old_status, new_status)
+                                    VALUES (?, ?)');
+    my $sth_delete = $dbh->prepare('DELETE FROM status_workflow
+                                    WHERE old_status = ? AND new_status = ?');
+    my $sth_delnul = $dbh->prepare('DELETE FROM status_workflow
+                                    WHERE old_status IS NULL AND new_status = ?');
+
+    # Part 1: Initial bug statuses.
+    foreach my $new (@$statuses) {
+        if ($cgi->param('w_0_' . $new->id)) {
+            $sth_insert->execute(undef, $new->id)
+              unless defined $workflow->{0}->{$new->id};
+        }
+        else {
+            $sth_delnul->execute($new->id);
+        }
+    }
+
+    # Part 2: Bug status changes.
+    foreach my $old (@$statuses) {
+        foreach my $new (@$statuses) {
+            next if $old->id == $new->id;
+
+            # All transitions to 'duplicate_or_move_bug_status' must be valid.
+            if ($cgi->param('w_' . $old->id . '_' . $new->id)
+                || ($new->name eq Bugzilla->params->{'duplicate_or_move_bug_status'}))
+            {
+                $sth_insert->execute($old->id, $new->id)
+                  unless defined $workflow->{$old->id}->{$new->id};
+            }
+            else {
+                $sth_delete->execute($old->id, $new->id);
+            }
+        }
+    }
+    delete_token($token);
+    load_template('edit', 'workflow_updated');
+}
+elsif ($action eq 'edit_comment') {
+    load_template('comment');
+}
+elsif ($action eq 'update_comment') {
+    check_token_data($token, 'workflow_comment');
+    my $workflow = get_workflow();
+
+    my $sth_update = $dbh->prepare('UPDATE status_workflow SET require_comment = ?
+                                    WHERE old_status = ? AND new_status = ?');
+    my $sth_updnul = $dbh->prepare('UPDATE status_workflow SET require_comment = ?
+                                    WHERE old_status IS NULL AND new_status = ?');
+
+    foreach my $old (keys %$workflow) {
+        # Hashes cannot have undef as a key, so we use 0. But the DB
+        # must store undef, for referential integrity.
+        my $old_id_for_db = $old || undef;
+        foreach my $new (keys %{$workflow->{$old}}) {
+            my $comment_required = $cgi->param("c_${old}_$new") ? 1 : 0;
+            next if ($workflow->{$old}->{$new} == $comment_required);
+            if ($old_id_for_db) {
+                $sth_update->execute($comment_required, $old_id_for_db, $new);
+            }
+            else {
+                $sth_updnul->execute($comment_required, $new);
+            }
+        }
+    }
+    delete_token($token);
+    load_template('comment', 'workflow_updated');
+}
+else {
+    ThrowUserError('unknown_action', {action => $action});
+}

diff --git a/email_in.pl b/email_in.pl
new file mode 100755 (executable)
index 0000000..6be7be8
--- /dev/null
+++ b/email_in.pl
@@ -0,0 +1,677 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use warnings;
+
+# MTAs may call this script from any directory, but it should always
+# run from this one so that it can find its modules.
+use Cwd qw(abs_path);
+use File::Basename qw(dirname);
+BEGIN {
+    # Untaint the abs_path.
+    my ($a) = abs_path($0) =~ /^(.*)$/;
+    chdir dirname($a);
+}
+
+use lib qw(. lib);
+
+use Data::Dumper;
+use Email::Address;
+use Email::Reply qw(reply);
+use Email::MIME;
+use Getopt::Long qw(:config bundling);
+use HTML::FormatText::WithLinks;
+use Pod::Usage;
+use Encode;
+use Scalar::Util qw(blessed);
+use List::MoreUtils qw(firstidx);
+
+use Bugzilla;
+use Bugzilla::Attachment;
+use Bugzilla::Bug;
+use Bugzilla::BugMail;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Field;
+use Bugzilla::Mailer;
+use Bugzilla::Token;
+use Bugzilla::User;
+use Bugzilla::Util;
+use Bugzilla::Hook;
+
+#############
+# Constants #
+#############
+
+# This is the USENET standard line for beginning a signature block
+# in a message. RFC-compliant mailers use this.
+use constant SIGNATURE_DELIMITER => '-- ';
+
+# These MIME types represent a "body" of an email if they have an
+# "inline" Content-Disposition (or no content disposition).
+use constant BODY_TYPES => qw(
+    text/plain
+    text/html
+    application/xhtml+xml
+    multipart/alternative
+);
+
+# $input_email is a global so that it can be used in die_handler.
+our ($input_email, %switch);
+
+####################
+# Main Subroutines #
+####################
+
+sub parse_mail {
+    my ($mail_text) = @_;
+    debug_print('Parsing Email');
+    $input_email = Email::MIME->new($mail_text);
+    
+    my %fields = %{ $switch{'default'} || {} };
+    Bugzilla::Hook::process('email_in_before_parse', { mail => $input_email,
+                                                       fields => \%fields });
+
+    my $summary = $input_email->header('Subject');
+    if ($summary =~ /\[\S+ (\d+)\](.*)/i) {
+        $fields{'bug_id'} = $1;
+        $summary = trim($2);
+    }
+
+    # Ignore automatic replies.
+    # XXX - Improve the way to detect such subjects in different languages.
+    my $auto_submitted = $input_email->header('Auto-Submitted') || '';
+    if ($summary =~ /out of( the)? office/i || $auto_submitted eq 'auto-replied') {
+        debug_print("Automatic reply detected: $summary");
+        exit;
+    }
+
+    my ($body, $attachments) = get_body_and_attachments($input_email);
+
+    debug_print("Body:\n" . $body, 3);
+
+    $body = remove_leading_blank_lines($body);
+    my @body_lines = split(/\r?\n/s, $body);
+
+    # If there are fields specified.
+    if ($body =~ /^\s*@/s) {
+        my $current_field;
+        while (my $line = shift @body_lines) {
+            # If the sig is starting, we want to keep this in the 
+            # @body_lines so that we don't keep the sig as part of the 
+            # comment down below.
+            if ($line eq SIGNATURE_DELIMITER) {
+                unshift(@body_lines, $line);
+                last;
+            }
+            # Otherwise, we stop parsing fields on the first blank line.
+            $line = trim($line);
+            last if !$line;
+            if ($line =~ /^\@(\w+)\s*(?:=|\s|$)\s*(.*)\s*/) {
+                $current_field = lc($1);
+                $fields{$current_field} = $2;
+            }
+            else {
+                $fields{$current_field} .= " $line";
+            }
+        }
+    }
+
+    %fields = %{ Bugzilla::Bug::map_fields(\%fields) };
+
+    my ($reporter) = Email::Address->parse($input_email->header('From'));
+    $fields{'reporter'} = $reporter->address;
+
+    # The summary line only affects us if we're doing a post_bug.
+    # We have to check it down here because there might have been
+    # a bug_id specified in the body of the email.
+    if (!$fields{'bug_id'} && !$fields{'short_desc'}) {
+        $fields{'short_desc'} = $summary;
+    }
+
+    # The Importance/X-Priority headers are only used when creating a new bug.
+    # 1) If somebody specifies a priority, use it.
+    # 2) If there is an Importance or X-Priority header, use it as
+    #    something that is relative to the default priority.
+    #    If the value is High or 1, increase the priority by 1.
+    #    If the value is Low or 5, decrease the priority by 1.
+    # 3) Otherwise, use the default priority.
+    # Note: this will only work if the 'letsubmitterchoosepriority'
+    # parameter is enabled.
+    my $importance = $input_email->header('Importance')
+                     || $input_email->header('X-Priority');
+    if (!$fields{'bug_id'} && !$fields{'priority'} && $importance) {
+        my @legal_priorities = @{get_legal_field_values('priority')};
+        my $i = firstidx { $_ eq Bugzilla->params->{'defaultpriority'} } @legal_priorities;
+        if ($importance =~ /(high|[12])/i) {
+            $i-- unless $i == 0;
+        }
+        elsif ($importance =~ /(low|[45])/i) {
+            $i++ unless $i == $#legal_priorities;
+        }
+        $fields{'priority'} = $legal_priorities[$i];
+    }
+
+    my $comment = '';
+    # Get the description, except the signature.
+    foreach my $line (@body_lines) {
+        last if $line eq SIGNATURE_DELIMITER;
+        $comment .= "$line\n";
+    }
+    $fields{'comment'} = $comment;
+
+    my %override = %{ $switch{'override'} || {} };
+    foreach my $key (keys %override) {
+        $fields{$key} = $override{$key};
+    }
+
+    debug_print("Parsed Fields:\n" . Dumper(\%fields), 2);
+
+    debug_print("Attachments:\n" . Dumper($attachments), 3);
+    if (@$attachments) {
+        $fields{'attachments'} = $attachments;
+    }
+
+    return \%fields;
+}
+
+sub check_email_fields {
+    my ($fields) = @_;
+
+    my ($retval, $non_conclusive_fields) =
+      Bugzilla::User::match_field({
+        'assigned_to'   => { 'type' => 'single' },
+        'qa_contact'    => { 'type' => 'single' },
+        'cc'            => { 'type' => 'multi'  },
+        'newcc'         => { 'type' => 'multi'  }
+      }, $fields, MATCH_SKIP_CONFIRM);
+
+    if ($retval != USER_MATCH_SUCCESS) {
+        ThrowUserError('user_match_too_many', {fields => $non_conclusive_fields});
+    }
+}
+
+sub post_bug {
+    my ($fields) = @_;
+    debug_print('Posting a new bug...');
+
+    my $user = Bugzilla->user;
+
+    check_email_fields($fields);
+
+    my $bug = Bugzilla::Bug->create($fields);
+    debug_print("Created bug " . $bug->id);
+    return ($bug, $bug->comments->[0]);
+}
+
+sub process_bug {
+    my ($fields_in) = @_; 
+    my %fields = %$fields_in;
+
+    my $bug_id = $fields{'bug_id'};
+    $fields{'id'} = $bug_id;
+    delete $fields{'bug_id'};
+
+    debug_print("Updating Bug $fields{id}...");
+
+    my $bug = Bugzilla::Bug->check($bug_id);
+
+    if ($fields{'bug_status'}) {
+        $fields{'knob'} = $fields{'bug_status'};
+    }
+    # If no status is given, then we only want to change the resolution.
+    elsif ($fields{'resolution'}) {
+        $fields{'knob'} = 'change_resolution';
+        $fields{'resolution_knob_change_resolution'} = $fields{'resolution'};
+    }
+    if ($fields{'dup_id'}) {
+        $fields{'knob'} = 'duplicate';
+    }
+
+    # Move @cc to @newcc as @cc is used by process_bug.cgi to remove
+    # users from the CC list when @removecc is set.
+    $fields{'newcc'} = delete $fields{'cc'} if $fields{'cc'};
+
+    # Make it possible to remove CCs.
+    if ($fields{'removecc'}) {
+        $fields{'cc'} = [split(',', $fields{'removecc'})];
+        $fields{'removecc'} = 1;
+    }
+
+    check_email_fields(\%fields);
+
+    my $cgi = Bugzilla->cgi;
+    foreach my $field (keys %fields) {
+        $cgi->param(-name => $field, -value => $fields{$field});
+    }
+    $cgi->param('longdesclength', scalar @{ $bug->comments });
+    $cgi->param('token', issue_hash_token([$bug->id, $bug->delta_ts]));
+
+    require 'process_bug.cgi';
+    debug_print("Bug processed.");
+
+    my $added_comment;
+    if (trim($fields{'comment'})) {
+        # The "old" bug object doesn't contain the comment we just added.
+        $added_comment = Bugzilla::Bug->check($bug_id)->comments->[-1];
+    }
+    return ($bug, $added_comment);
+}
+
+sub handle_attachments {
+    my ($bug, $attachments, $comment) = @_;
+    return if !$attachments;
+    debug_print("Handling attachments...");
+    my $dbh = Bugzilla->dbh;
+    $dbh->bz_start_transaction();
+    my ($update_comment, $update_bug);
+    foreach my $attachment (@$attachments) {
+        debug_print("Inserting Attachment: " . Dumper($attachment), 3);
+        my $type = $attachment->content_type || 'application/octet-stream';
+        # MUAs add stuff like "name=" to content-type that we really don't
+        # want.
+        $type =~ s/;.*//;
+        my $obj = Bugzilla::Attachment->create({
+            bug         => $bug,
+            description => $attachment->filename(1),
+            filename    => $attachment->filename(1),
+            mimetype    => $type,
+            data        => $attachment->body,
+        });
+        # If we added a comment, and our comment does not already have a type,
+        # and this is our first attachment, then we make the comment an 
+        # "attachment created" comment.
+        if ($comment and !$comment->type and !$update_comment) {
+            $comment->set_all({ type       => CMT_ATTACHMENT_CREATED, 
+                                extra_data => $obj->id });
+            $update_comment = 1;
+        }
+        else {
+            $bug->add_comment('', { type => CMT_ATTACHMENT_CREATED,
+                                    extra_data => $obj->id });
+            $update_bug = 1;
+        }
+    }
+    # We only update the comments and bugs at the end of the transaction,
+    # because doing so modifies bugs_fulltext, which is a non-transactional
+    # table.
+    $bug->update() if $update_bug;
+    $comment->update() if $update_comment;
+    $dbh->bz_commit_transaction();
+}
+
+######################
+# Helper Subroutines #
+######################
+
+sub debug_print {
+    my ($str, $level) = @_;
+    $level ||= 1;
+    print STDERR "$str\n" if $level <= $switch{'verbose'};
+}
+
+sub get_body_and_attachments {
+    my ($email) = @_;
+
+    my $ct = $email->content_type || 'text/plain';
+    debug_print("Splitting Body and Attachments [Type: $ct]...", 2);
+
+    my ($bodies, $attachments) = split_body_and_attachments($email);
+    debug_print(scalar(@$bodies) . " body part(s) and " . scalar(@$attachments)
+                . " attachment part(s).");
+    debug_print('Bodies: ' . Dumper($bodies), 3);
+
+    # Get the first part of the email that contains a text body,
+    # and make all the other pieces into attachments. (This handles
+    # people or MUAs who accidentally attach text files as an "inline"
+    # attachment.)
+    my $body;
+    while (@$bodies) {
+        my $possible = shift @$bodies;
+        $body = get_text_alternative($possible);
+        if (defined $body) {
+            unshift(@$attachments, @$bodies);
+            last;
+        }
+    }
+
+    if (!defined $body) {
+        # Note that this only happens if the email does not contain any
+        # text/plain parts. If the email has an empty text/plain part,
+        # you're fine, and this message does NOT get thrown.
+        ThrowUserError('email_no_body');
+    }
+
+    debug_print("Picked Body:\n$body", 2);
+    
+    return ($body, $attachments);
+}
+
+sub get_text_alternative {
+    my ($email) = @_;
+
+    my @parts = $email->parts;
+    my $body;
+    foreach my $part (@parts) {
+        my $ct = $part->content_type || 'text/plain';
+        my $charset = 'iso-8859-1';
+        # The charset may be quoted.
+        if ($ct =~ /charset="?([^;"]+)/) {
+            $charset= $1;
+        }
+        debug_print("Alternative Part Content-Type: $ct", 2);
+        debug_print("Alternative Part Character Encoding: $charset", 2);
+        # If we find a text/plain body here, return it immediately.
+        if (!$ct || $ct =~ m{^text/plain}i) {
+            return _decode_body($charset, $part->body);
+        }
+        # If we find a text/html body, decode it, but don't return
+        # it immediately, because there might be a text/plain alternative
+        # later. This could be any HTML type.
+        if ($ct =~ m{^application/xhtml\+xml}i or $ct =~ m{text/html}i) {
+            my $parser = HTML::FormatText::WithLinks->new(
+                # Put footnnote indicators after the text, not before it.
+                before_link => '',
+                after_link  => '[%n]',
+                # Convert bold and italics, use "*" for bold instead of "_".
+                with_emphasis => 1,
+                bold_marker => '*',
+                # If the same link appears multiple times, only create
+                # one footnote.
+                unique_links => 1,
+                # If the link text is the URL, don't create a footnote.
+                skip_linked_urls => 1,
+            );
+            $body = _decode_body($charset, $part->body);
+            $body = $parser->parse($body);
+        }
+    }
+
+    return $body;
+}
+
+sub _decode_body {
+    my ($charset, $body) = @_;
+    if (Bugzilla->params->{'utf8'} && !utf8::is_utf8($body)) {
+        return Encode::decode($charset, $body);
+    }
+    return $body;
+}
+
+sub remove_leading_blank_lines {
+    my ($text) = @_;
+    $text =~ s/^(\s*\n)+//s;
+    return $text;
+}
+
+sub html_strip {
+    my ($var) = @_;
+    # Trivial HTML tag remover (this is just for error messages, really.)
+    $var =~ s/<[^>]*>//g;
+    # And this basically reverses the Template-Toolkit html filter.
+    $var =~ s/\&amp;/\&/g;
+    $var =~ s/\&lt;/</g;
+    $var =~ s/\&gt;/>/g;
+    $var =~ s/\&quot;/\"/g;
+    $var =~ s/&#64;/@/g;
+    # Also remove undesired newlines and consecutive spaces.
+    $var =~ s/[\n\s]+/ /gms;
+    return $var;
+}
+
+sub split_body_and_attachments {
+    my ($email) = @_;
+
+    my (@body, @attachments);
+    foreach my $part ($email->parts) {
+        my $ct = lc($part->content_type || 'text/plain');
+        my $disposition = lc($part->header('Content-Disposition') || 'inline');
+        # Remove the charset, etc. from the content-type, we don't care here.
+        $ct =~ s/;.*//;
+        debug_print("Part Content-Type: [$ct]", 2);
+        debug_print("Part Disposition: [$disposition]", 2);
+
+        if ($disposition eq 'inline' and grep($_ eq $ct, BODY_TYPES)) {
+            push(@body, $part);
+            next;
+        }
+        
+        if (scalar($part->parts) == 1) {
+            push(@attachments, $part);
+            next;
+        }
+
+        # If this part has sub-parts, analyze them similarly to how we
+        # did above and return the relevant pieces.
+        my ($add_body, $add_attachments) = split_body_and_attachments($part);
+        push(@body, @$add_body);
+        push(@attachments, @$add_attachments);
+    }
+
+    return (\@body, \@attachments);
+}
+
+
+sub die_handler {
+    my ($msg) = @_;
+
+    # In Template-Toolkit, [% RETURN %] is implemented as a call to "die".
+    # But of course, we really don't want to actually *die* just because
+    # the user-error or code-error template ended. So we don't really die.
+    return if blessed($msg) && $msg->isa('Template::Exception')
+              && $msg->type eq 'return';
+
+    # If this is inside an eval, then we should just act like...we're
+    # in an eval (instead of printing the error and exiting).
+    die(@_) if $^S;
+
+    # We can't depend on the MTA to send an error message, so we have
+    # to generate one properly.
+    if ($input_email) {
+       $msg =~ s/at .+ line.*$//ms;
+       $msg =~ s/^Compilation failed in require.+$//ms;
+       $msg = html_strip($msg);
+       my $from = Bugzilla->params->{'mailfrom'};
+       my $reply = reply(to => $input_email, from => $from, top_post => 1, 
+                         body => "$msg\n");
+       MessageToMTA($reply->as_string);
+    }
+    print STDERR "$msg\n";
+    # We exit with a successful value, because we don't want the MTA
+    # to *also* send a failure notice.
+    exit;
+}
+
+###############
+# Main Script #
+###############
+
+$SIG{__DIE__} = \&die_handler;
+
+GetOptions(\%switch, 'help|h', 'verbose|v+', 'default=s%', 'override=s%');
+$switch{'verbose'} ||= 0;
+
+# Print the help message if that switch was selected.
+pod2usage({-verbose => 0, -exitval => 1}) if $switch{'help'};
+
+Bugzilla->usage_mode(USAGE_MODE_EMAIL);
+
+my @mail_lines = <STDIN>;
+my $mail_text = join("", @mail_lines);
+my $mail_fields = parse_mail($mail_text);
+
+Bugzilla::Hook::process('email_in_after_parse', { fields => $mail_fields });
+
+my $attachments = delete $mail_fields->{'attachments'};
+
+my $username = $mail_fields->{'reporter'};
+# If emailsuffix is in use, we have to remove it from the email address.
+if (my $suffix = Bugzilla->params->{'emailsuffix'}) {
+    $username =~ s/\Q$suffix\E$//i;
+}
+
+my $user = Bugzilla::User->check($username);
+Bugzilla->set_user($user);
+
+my ($bug, $comment);
+if ($mail_fields->{'bug_id'}) {
+    ($bug, $comment) = process_bug($mail_fields);
+}
+else {
+    ($bug, $comment) = post_bug($mail_fields);
+}
+
+handle_attachments($bug, $attachments, $comment);
+
+# This is here for post_bug and handle_attachments, so that when posting a bug
+# with an attachment, any comment goes out as an attachment comment.
+#
+# Eventually this should be sending the mail for process_bug, too, but we have
+# to wait for $bug->update() to be fully used in email_in.pl first. So
+# currently, process_bug.cgi does the mail sending for bugs, and this does
+# any mail sending for attachments after the first one.
+Bugzilla::BugMail::Send($bug->id, { changer => Bugzilla->user });
+debug_print("Sent bugmail");
+
+
+__END__
+
+=head1 NAME
+
+email_in.pl - The Bugzilla Inbound Email Interface
+
+=head1 SYNOPSIS
+
+./email_in.pl [-vvv] [--default name=value] [--override name=value] < email.txt
+
+Reads an email on STDIN (the standard input).
+
+Options:
+
+   --verbose (-v)        - Make the script print more to STDERR.
+                           Specify multiple times to print even more.
+
+   --default name=value  - Specify defaults for field values, like
+                           product=TestProduct. Can be specified multiple
+                           times to specify defaults for multiple fields.
+
+   --override name=value - Override field values specified in the email,
+                           like product=TestProduct. Can be specified
+                           multiple times to override multiple fields.
+
+=head1 DESCRIPTION
+
+This script processes inbound email and creates a bug, or appends data
+to an existing bug.
+
+=head2 Creating a New Bug
+
+The script expects to read an email with the following format:
+
+ From: account@domain.com
+ Subject: Bug Summary
+
+ @product ProductName
+ @component ComponentName
+ @version 1.0
+
+ This is a bug description. It will be entered into the bug exactly as
+ written here.
+
+ It can be multiple paragraphs.
+
+ -- 
+ This is a signature line, and will be removed automatically, It will not
+ be included in the bug description.
+
+For the list of valid field names for the C<@> fields, including
+a list of which ones are required, see L<Bugzilla::WebService::Bug/create>.
+(Note, however, that you cannot specify C<@description> as a field--
+you just add a comment by adding text after the C<@> fields.)
+
+The values for the fields can be split across multiple lines, but
+note that a newline will be parsed as a single space, for the value.
+So, for example:
+
+ @summary This is a very long
+ description
+
+Will be parsed as "This is a very long description".
+
+If you specify C<@summary>, it will override the summary you specify
+in the Subject header.
+
+C<account@domain.com> (the value of the C<From> header) must be a valid
+Bugzilla account.
+
+Note that signatures must start with '-- ', the standard signature
+border.
+
+=head2 Modifying an Existing Bug
+
+Bugzilla determines what bug you want to modify in one of two ways:
+
+=over
+
+=item *
+
+Your subject starts with [Bug 123456] -- then it modifies bug 123456.
+
+=item *
+
+You include C<@id 123456> in the first lines of the email.
+
+=back
+
+If you do both, C<@id> takes precedence.
+
+You send your email in the same format as for creating a bug, except
+that you only specify the fields you want to change. If the very
+first non-blank line of the email doesn't begin with C<@>, then it
+will be assumed that you are only adding a comment to the bug.
+
+Note that when updating a bug, the C<Subject> header is ignored,
+except for getting the bug ID. If you want to change the bug's summary,
+you have to specify C<@summary> as one of the fields to change.
+
+Please remember not to include any extra text in your emails, as that
+text will also be added as a comment. This includes any text that your
+email client automatically quoted and included, if this is a reply to
+another email.
+
+=head3 Adding/Removing CCs
+
+To add CCs, you can specify them in a comma-separated list in C<@cc>.
+
+To remove CCs, specify them as a comma-separated list in C<@removecc>.
+
+=head2 Errors
+
+If your request cannot be completed for any reason, Bugzilla will
+send an email back to you. If your request succeeds, Bugzilla will
+not send you anything.
+
+If any part of your request fails, all of it will fail. No partial
+changes will happen.
+
+=head1 CAUTION
+
+The script does not do any validation that the user is who they say
+they are. That is, it accepts I<any> 'From' address, as long as it's
+a valid Bugzilla account. So make sure that your MTA validates that
+the message is actually coming from who it says it's coming from,
+and only allow access to the inbound email system from people you trust.
+
+=head1 LIMITATIONS
+
+The email interface only accepts emails that are correctly formatted
+per RFC2822. If you send it an incorrectly formatted message, it
+may behave in an unpredictable fashion.
+
+You cannot modify Flags through the email interface.

diff --git a/enter_bug.cgi b/enter_bug.cgi
new file mode 100755 (executable)
index 0000000..1f80501
--- /dev/null
+++ b/enter_bug.cgi
@@ -0,0 +1,353 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+##############################################################################
+#
+# enter_bug.cgi
+# -------------
+# Displays bug entry form. Bug fields are specified through popup menus, 
+# drop-down lists, or text fields. Default for these values can be 
+# passed in as parameters to the cgi.
+#
+##############################################################################
+
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Bug;
+use Bugzilla::Hook;
+use Bugzilla::Classification;
+use Bugzilla::Token;
+use Bugzilla::Field;
+use Bugzilla::Status;
+use Bugzilla::UserAgent;
+
+use List::MoreUtils qw(none);
+
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+my $cloned_bug;
+my $cloned_bug_id;
+
+my $cgi = Bugzilla->cgi;
+my $dbh = Bugzilla->dbh;
+my $template = Bugzilla->template;
+my $vars = {};
+
+# All pages point to the same part of the documentation.
+$vars->{'doc_section'} = 'bugreports.html';
+
+my $product_name = trim($cgi->param('product') || '');
+# Will contain the product object the bug is created in.
+my $product;
+
+if ($product_name eq '') {
+    # If the user cannot enter bugs in any product, stop here.
+    my @enterable_products = @{$user->get_enterable_products};
+    ThrowUserError('no_products') unless scalar(@enterable_products);
+
+    my $classification = Bugzilla->params->{'useclassification'} ?
+        scalar($cgi->param('classification')) : '__all';
+
+    # Unless a real classification name is given, we sort products
+    # by classification.
+    my @classifications;
+
+    unless ($classification && $classification ne '__all') {
+        @classifications = @{sort_products_by_classification(\@enterable_products)};
+    }
+
+    unless ($classification) {
+        # We know there is at least one classification available,
+        # else we would have stopped earlier.
+        if (scalar(@classifications) > 1) {
+            # We only need classification objects.
+            $vars->{'classifications'} = [map {$_->{'object'}} @classifications];
+
+            $vars->{'target'} = "enter_bug.cgi";
+            $vars->{'format'} = $cgi->param('format');
+            $vars->{'cloned_bug_id'} = $cgi->param('cloned_bug_id');
+
+            print $cgi->header();
+            $template->process("global/choose-classification.html.tmpl", $vars)
+               || ThrowTemplateError($template->error());
+            exit;
+        }
+        # If we come here, then there is only one classification available.
+        $classification = $classifications[0]->{'object'}->name;
+    }
+
+    # Keep only enterable products which are in the specified classification.
+    if ($classification ne "__all") {
+        my $class = new Bugzilla::Classification({'name' => $classification});
+        # If the classification doesn't exist, then there is no product in it.
+        if ($class) {
+            @enterable_products
+              = grep {$_->classification_id == $class->id} @enterable_products;
+            @classifications = ({object => $class, products => \@enterable_products});
+        }
+        else {
+            @enterable_products = ();
+        }
+    }
+
+    if (scalar(@enterable_products) == 0) {
+        ThrowUserError('no_products');
+    }
+    elsif (scalar(@enterable_products) > 1) {
+        $vars->{'classifications'} = \@classifications;
+        $vars->{'target'} = "enter_bug.cgi";
+        $vars->{'format'} = $cgi->param('format');
+        $vars->{'cloned_bug_id'} = $cgi->param('cloned_bug_id');
+
+        print $cgi->header();
+        $template->process("global/choose-product.html.tmpl", $vars)
+          || ThrowTemplateError($template->error());
+        exit;
+    } else {
+        # Only one product exists.
+        $product = $enterable_products[0];
+    }
+}
+
+# We need to check and make sure that the user has permission
+# to enter a bug against this product.
+$product = $user->can_enter_product($product || $product_name, THROW_ERROR);
+
+##############################################################################
+# Useful Subroutines
+##############################################################################
+sub formvalue {
+    my ($name, $default) = (@_);
+    return Bugzilla->cgi->param($name) || $default || "";
+}
+
+##############################################################################
+# End of subroutines
+##############################################################################
+
+my $has_editbugs = $user->in_group('editbugs', $product->id);
+my $has_canconfirm = $user->in_group('canconfirm', $product->id);
+
+# If a user is trying to clone a bug
+#   Check that the user has authorization to view the parent bug
+#   Create an instance of Bug that holds the info from the parent
+$cloned_bug_id = $cgi->param('cloned_bug_id');
+
+if ($cloned_bug_id) {
+    $cloned_bug = Bugzilla::Bug->check($cloned_bug_id);
+    $cloned_bug_id = $cloned_bug->id;
+}
+
+if (scalar(@{$product->components}) == 1) {
+    # Only one component; just pick it.
+    $cgi->param('component', $product->components->[0]->name);
+}
+
+my %default;
+
+$vars->{'product'}               = $product;
+
+$vars->{'priority'}              = get_legal_field_values('priority');
+$vars->{'bug_severity'}          = get_legal_field_values('bug_severity');
+$vars->{'rep_platform'}          = get_legal_field_values('rep_platform');
+$vars->{'op_sys'}                = get_legal_field_values('op_sys');
+
+$vars->{'assigned_to'}           = formvalue('assigned_to');
+$vars->{'assigned_to_disabled'}  = !$has_editbugs;
+$vars->{'cc_disabled'}           = 0;
+
+$vars->{'qa_contact'}           = formvalue('qa_contact');
+$vars->{'qa_contact_disabled'}  = !$has_editbugs;
+
+$vars->{'cloned_bug_id'}         = $cloned_bug_id;
+
+$vars->{'token'} = issue_session_token('create_bug');
+
+
+my @enter_bug_fields = grep { $_->enter_bug } Bugzilla->active_custom_fields;
+foreach my $field (@enter_bug_fields) {
+    my $cf_name = $field->name;
+    my $cf_value = $cgi->param($cf_name);
+    if (defined $cf_value) {
+        if ($field->type == FIELD_TYPE_MULTI_SELECT) {
+            $cf_value = [$cgi->param($cf_name)];
+        }
+        $default{$cf_name} = $vars->{$cf_name} = $cf_value;
+    }
+}
+
+# This allows the Field visibility and value controls to work with the
+# Classification and Product fields as a parent.
+$default{'classification'} = $product->classification->name;
+$default{'product'} = $product->name;
+
+if ($cloned_bug_id) {
+
+    $default{'component_'}    = $cloned_bug->component;
+    $default{'priority'}      = $cloned_bug->priority;
+    $default{'bug_severity'}  = $cloned_bug->bug_severity;
+    $default{'rep_platform'}  = $cloned_bug->rep_platform;
+    $default{'op_sys'}        = $cloned_bug->op_sys;
+
+    $vars->{'short_desc'}     = $cloned_bug->short_desc;
+    $vars->{'bug_file_loc'}   = $cloned_bug->bug_file_loc;
+    $vars->{'keywords'}       = $cloned_bug->keywords;
+    $vars->{'dependson'}      = join (", ", $cloned_bug_id, @{$cloned_bug->dependson});
+    $vars->{'blocked'}        = join (", ", @{$cloned_bug->blocked});
+    $vars->{'deadline'}       = $cloned_bug->deadline;
+    $vars->{'estimated_time'} = $cloned_bug->estimated_time;
+
+    if (scalar @{$cloned_bug->cc}) {
+        $vars->{'cc'}         = join (", ", @{$cloned_bug->cc});
+    } else {
+        $vars->{'cc'}         = formvalue('cc');
+    }
+    
+    if ($cloned_bug->reporter->id != $user->id
+        && none { $_ eq $cloned_bug->reporter->login } @{$cloned_bug->cc}) {
+        $vars->{'cc'} = join (", ", $cloned_bug->reporter->login, $vars->{'cc'}); 
+    }
+
+    foreach my $field (@enter_bug_fields) {
+        my $field_name = $field->name;
+        $vars->{$field_name} = $cloned_bug->$field_name;
+    }
+
+    # We need to ensure that we respect the 'insider' status of
+    # the first comment, if it has one. Either way, make a note
+    # that this bug was cloned from another bug.
+    my $bug_desc = $cloned_bug->comments({ order => 'oldest_to_newest' })->[0];
+    my $isprivate = $bug_desc->is_private;
+
+    $vars->{'comment'} = "";
+    $vars->{'comment_is_private'} = 0;
+
+    if (!$isprivate || $user->is_insider) {
+        # We use "body" to avoid any format_comment text, which would be
+        # pointless to clone.
+        $vars->{'comment'} = $bug_desc->body;
+        $vars->{'comment_is_private'} = $isprivate;
+    }
+
+} # end of cloned bug entry form
+
+else {
+    $default{'component_'}    = formvalue('component');
+    $default{'priority'}      = formvalue('priority', Bugzilla->params->{'defaultpriority'});
+    $default{'bug_severity'}  = formvalue('bug_severity', Bugzilla->params->{'defaultseverity'});
+    $default{'rep_platform'}  = formvalue('rep_platform', 
+                                          Bugzilla->params->{'defaultplatform'} || detect_platform());
+    $default{'op_sys'}        = formvalue('op_sys', 
+                                          Bugzilla->params->{'defaultopsys'} || detect_op_sys());
+
+    $vars->{'alias'}          = formvalue('alias');
+    $vars->{'short_desc'}     = formvalue('short_desc');
+    $vars->{'bug_file_loc'}   = formvalue('bug_file_loc', "http://");
+    $vars->{'keywords'}       = formvalue('keywords');
+    $vars->{'dependson'}      = formvalue('dependson');
+    $vars->{'blocked'}        = formvalue('blocked');
+    $vars->{'deadline'}       = formvalue('deadline');
+    $vars->{'estimated_time'} = formvalue('estimated_time');
+
+    $vars->{'cc'}             = join(', ', $cgi->param('cc'));
+
+    $vars->{'comment'}        = formvalue('comment');
+    $vars->{'comment_is_private'} = formvalue('comment_is_private');
+
+} # end of normal/bookmarked entry form
+
+
+# IF this is a cloned bug,
+# AND the clone's product is the same as the parent's
+#   THEN use the version from the parent bug
+# ELSE IF a version is supplied in the URL
+#   THEN use it
+# ELSE IF there is a version in the cookie
+#   THEN use it (Posting a bug sets a cookie for the current version.)
+# ELSE
+#   The default version is the last one in the list (which, it is
+#   hoped, will be the most recent one).
+#
+# Eventually maybe each product should have a "current version"
+# parameter.
+$vars->{'version'} = $product->versions;
+
+my $version_cookie = $cgi->cookie("VERSION-" . $product->name);
+
+if ( ($cloned_bug_id) &&
+     ($product->name eq $cloned_bug->product ) ) {
+    $default{'version'} = $cloned_bug->version;
+} elsif (formvalue('version')) {
+    $default{'version'} = formvalue('version');
+} elsif (defined $version_cookie
+         and grep { $_->name eq $version_cookie } @{ $vars->{'version'} })
+{
+    $default{'version'} = $version_cookie;
+} else {
+    $default{'version'} = $vars->{'version'}->[$#{$vars->{'version'}}]->name;
+}
+
+# Get list of milestones.
+if ( Bugzilla->params->{'usetargetmilestone'} ) {
+    $vars->{'target_milestone'} = $product->milestones;
+    if (formvalue('target_milestone')) {
+       $default{'target_milestone'} = formvalue('target_milestone');
+    } else {
+       $default{'target_milestone'} = $product->default_milestone;
+    }
+}
+
+# Construct the list of allowable statuses.
+my @statuses = @{ Bugzilla::Bug->new_bug_statuses($product) };
+# Exclude closed states from the UI, even if the workflow allows them.
+# The back-end code will still accept them, though.
+# XXX We should remove this when the UI accepts closed statuses and update
+# Bugzilla::Bug->default_bug_status.
+@statuses = grep { $_->is_open } @statuses;
+
+scalar(@statuses) || ThrowUserError('no_initial_bug_status');
+
+$vars->{'bug_status'} = \@statuses;
+
+# Get the default from a template value if it is legitimate.
+# Otherwise, and only if the user has privs, set the default
+# to the first confirmed bug status on the list, if available.
+
+my $picked_status = formvalue('bug_status');
+if ($picked_status and grep($_->name eq $picked_status, @statuses)) {
+    $default{'bug_status'} = formvalue('bug_status');
+} else {
+    $default{'bug_status'} = Bugzilla::Bug->default_bug_status(@statuses);
+}
+
+my @groups = $cgi->param('groups');
+if ($cloned_bug) {
+    my @clone_groups = map { $_->name } @{ $cloned_bug->groups_in };
+    # It doesn't matter if there are duplicate names, since all we check
+    # for in the template is whether or not the group is set.
+    push(@groups, @clone_groups);
+}
+$default{'groups'} = \@groups;
+
+Bugzilla::Hook::process('enter_bug_entrydefaultvars', { vars => $vars });
+
+$vars->{'default'} = \%default;
+
+my $format = $template->get_format("bug/create/create",
+                                   scalar $cgi->param('format'), 
+                                   scalar $cgi->param('ctype'));
+
+print $cgi->header($format->{'ctype'});
+$template->process($format->{'template'}, $vars)
+  || ThrowTemplateError($template->error());          

diff --git a/extensions/BmpConvert/Config.pm b/extensions/BmpConvert/Config.pm
new file mode 100644 (file)
index 0000000..42fb3ce
--- /dev/null
+++ b/extensions/BmpConvert/Config.pm
@@ -0,0 +1,19 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::BmpConvert;
+use strict;
+use constant NAME => 'BmpConvert';
+use constant REQUIRED_MODULES => [
+  {
+      package => 'PerlMagick',
+      module  => 'Image::Magick',
+      version => 0,
+  },
+];
+
+__PACKAGE__->NAME;

diff --git a/extensions/BmpConvert/Extension.pm b/extensions/BmpConvert/Extension.pm
new file mode 100644 (file)
index 0000000..87ec5f5
--- /dev/null
+++ b/extensions/BmpConvert/Extension.pm
@@ -0,0 +1,42 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::BmpConvert;
+use strict;
+use base qw(Bugzilla::Extension);
+
+use Image::Magick;
+
+our $VERSION = '1.0';
+
+sub attachment_process_data {
+    my ($self, $args) = @_;
+    return unless $args->{attributes}->{mimetype} eq 'image/bmp';
+
+    my $data = ${$args->{data}};
+    my $img = Image::Magick->new(magick => 'bmp');
+
+    # $data is a filehandle.
+    if (ref $data) {
+        $img->Read(file => \*$data);
+        $img->set(magick => 'png');
+        $img->Write(file => \*$data);
+    }
+    # $data is a blob.
+    else {
+        $img->BlobToImage($data);
+        $img->set(magick => 'png');
+        $data = $img->ImageToBlob();
+    }
+    undef $img;
+
+    ${$args->{data}} = $data;
+    $args->{attributes}->{mimetype} = 'image/png';
+    $args->{attributes}->{filename} =~ s/^(.+)\.bmp$/$1.png/i;
+}
+
+ __PACKAGE__->NAME;

diff --git a/extensions/BmpConvert/disabled b/extensions/BmpConvert/disabled
new file mode 100644 (file)
index 0000000..e69de29

diff --git a/extensions/Example/Config.pm b/extensions/Example/Config.pm
new file mode 100644 (file)
index 0000000..b40ed99
--- /dev/null
+++ b/extensions/Example/Config.pm
@@ -0,0 +1,28 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::Example;
+use strict;
+use constant NAME => 'Example';
+use constant REQUIRED_MODULES => [
+    {
+        package => 'Data-Dumper',
+        module  => 'Data::Dumper',
+        version => 0,
+    },
+];
+
+use constant OPTIONAL_MODULES => [
+    {
+        package => 'Acme',
+        module  => 'Acme',
+        version => 1.11,
+        feature => ['example_acme'],
+    },
+];
+
+__PACKAGE__->NAME;

diff --git a/extensions/Example/Extension.pm b/extensions/Example/Extension.pm
new file mode 100644 (file)
index 0000000..08a5144
--- /dev/null
+++ b/extensions/Example/Extension.pm
@@ -0,0 +1,944 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::Example;
+use strict;
+use base qw(Bugzilla::Extension);
+
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Group;
+use Bugzilla::User;
+use Bugzilla::User::Setting;
+use Bugzilla::Util qw(diff_arrays html_quote);
+use Bugzilla::Status qw(is_open_state);
+use Bugzilla::Install::Filesystem;
+
+# This is extensions/Example/lib/Util.pm. I can load this here in my
+# Extension.pm only because I have a Config.pm.
+use Bugzilla::Extension::Example::Util;
+
+use Data::Dumper;
+
+# See bugmail_relationships.
+use constant REL_EXAMPLE => -127;
+
+our $VERSION = '1.0';
+
+sub admin_editusers_action {
+    my ($self, $args) = @_;
+    my ($vars, $action, $user) = @$args{qw(vars action user)};
+    my $template = Bugzilla->template;
+
+    if ($action eq 'my_action') {
+        # Allow to restrict the search to any group the user is allowed to bless.
+        $vars->{'restrictablegroups'} = $user->bless_groups();
+        $template->process('admin/users/search.html.tmpl', $vars)
+            || ThrowTemplateError($template->error());
+        exit;
+    }
+}
+
+sub attachment_process_data {
+    my ($self, $args) = @_;
+    my $type     = $args->{attributes}->{mimetype};
+    my $filename = $args->{attributes}->{filename};
+
+    # Make sure images have the correct extension.
+    # Uncomment the two lines below to make this check effective.
+    if ($type =~ /^image\/(\w+)$/) {
+        my $format = $1;
+        if ($filename =~ /^(.+)(:?\.[^\.]+)$/) {
+            my $name = $1;
+            #$args->{attributes}->{filename} = "${name}.$format";
+        }
+        else {
+            # The file has no extension. We append it.
+            #$args->{attributes}->{filename} .= ".$format";
+        }
+    }
+}
+
+sub auth_login_methods {
+    my ($self, $args) = @_;
+    my $modules = $args->{modules};
+    if (exists $modules->{Example}) {
+        $modules->{Example} = 'Bugzilla/Extension/Example/Auth/Login.pm';
+    }
+}
+
+sub auth_verify_methods {
+    my ($self, $args) = @_;
+    my $modules = $args->{modules};
+    if (exists $modules->{Example}) {
+        $modules->{Example} = 'Bugzilla/Extension/Example/Auth/Verify.pm';
+    }
+}
+
+sub bug_check_can_change_field {
+    my ($self, $args) = @_;
+
+    my ($bug, $field, $new_value, $old_value, $priv_results)
+        = @$args{qw(bug field new_value old_value priv_results)};
+
+    my $user = Bugzilla->user;
+
+    # Disallow a bug from being reopened if currently closed unless user 
+    # is in 'admin' group
+    if ($field eq 'bug_status' && $bug->product_obj->name eq 'Example') {
+        if (!is_open_state($old_value) && is_open_state($new_value) 
+            && !$user->in_group('admin')) 
+        {
+            push(@$priv_results, PRIVILEGES_REQUIRED_EMPOWERED);
+            return;
+        }
+    }
+
+    # Disallow a bug's keywords from being edited unless user is the
+    # reporter of the bug 
+    if ($field eq 'keywords' && $bug->product_obj->name eq 'Example' 
+        && $user->login ne $bug->reporter->login) 
+    {
+        push(@$priv_results, PRIVILEGES_REQUIRED_REPORTER);
+        return;
+    }
+
+    # Allow updating of priority even if user cannot normally edit the bug 
+    # and they are in group 'engineering'
+    if ($field eq 'priority' && $bug->product_obj->name eq 'Example'
+        && $user->in_group('engineering')) 
+    {
+        push(@$priv_results, PRIVILEGES_REQUIRED_NONE);
+        return;
+    }
+}
+
+sub bug_columns {
+    my ($self, $args) = @_;
+    my $columns = $args->{'columns'};
+    push (@$columns, "delta_ts AS example")
+}
+
+sub bug_end_of_create {
+    my ($self, $args) = @_;
+
+    # This code doesn't actually *do* anything, it's just here to show you
+    # how to use this hook.
+    my $bug = $args->{'bug'};
+    my $timestamp = $args->{'timestamp'};
+    
+    my $bug_id = $bug->id;
+    # Uncomment this line to see a line in your webserver's error log whenever
+    # you file a bug.
+    # warn "Bug $bug_id has been filed!";
+}
+
+sub bug_end_of_create_validators {
+    my ($self, $args) = @_;
+    
+    # This code doesn't actually *do* anything, it's just here to show you
+    # how to use this hook.
+    my $bug_params = $args->{'params'};
+    
+    # Uncomment this line below to see a line in your webserver's error log
+    # containing all validated bug field values every time you file a bug.
+    # warn Dumper($bug_params);
+    
+    # This would remove all ccs from the bug, preventing ANY ccs from being
+    # added on bug creation.
+    # $bug_params->{cc} = [];
+}
+
+sub bug_start_of_update {
+    my ($self, $args) = @_;
+
+    # This code doesn't actually *do* anything, it's just here to show you
+    # how to use this hook.
+    my ($bug, $old_bug, $timestamp, $changes) = 
+        @$args{qw(bug old_bug timestamp changes)};
+
+    foreach my $field (keys %$changes) {
+        my $used_to_be = $changes->{$field}->[0];
+        my $now_it_is  = $changes->{$field}->[1];
+    }
+
+    my $old_summary = $old_bug->short_desc;
+
+    my $status_message;
+    if (my $status_change = $changes->{'bug_status'}) {
+        my $old_status = new Bugzilla::Status({ name => $status_change->[0] });
+        my $new_status = new Bugzilla::Status({ name => $status_change->[1] });
+        if ($new_status->is_open && !$old_status->is_open) {
+            $status_message = "Bug re-opened!";
+        }
+        if (!$new_status->is_open && $old_status->is_open) {
+            $status_message = "Bug closed!";
+        }
+    }
+
+    my $bug_id = $bug->id;
+    my $num_changes = scalar keys %$changes;
+    my $result = "There were $num_changes changes to fields on bug $bug_id"
+                 . " at $timestamp.";
+    # Uncomment this line to see $result in your webserver's error log whenever
+    # you update a bug.
+    # warn $result;
+}
+
+sub bug_end_of_update {
+    my ($self, $args) = @_;
+    
+    # This code doesn't actually *do* anything, it's just here to show you
+    # how to use this hook.
+    my ($bug, $old_bug, $timestamp, $changes) = 
+        @$args{qw(bug old_bug timestamp changes)};
+    
+    foreach my $field (keys %$changes) {
+        my $used_to_be = $changes->{$field}->[0];
+        my $now_it_is  = $changes->{$field}->[1];
+    }
+
+    my $old_summary = $old_bug->short_desc;
+
+    my $status_message;
+    if (my $status_change = $changes->{'bug_status'}) {
+        my $old_status = new Bugzilla::Status({ name => $status_change->[0] });
+        my $new_status = new Bugzilla::Status({ name => $status_change->[1] });
+        if ($new_status->is_open && !$old_status->is_open) {
+            $status_message = "Bug re-opened!";
+        }
+        if (!$new_status->is_open && $old_status->is_open) {
+            $status_message = "Bug closed!";
+        }
+    }
+    
+    my $bug_id = $bug->id;
+    my $num_changes = scalar keys %$changes;
+    my $result = "There were $num_changes changes to fields on bug $bug_id"
+                 . " at $timestamp.";
+    # Uncomment this line to see $result in your webserver's error log whenever
+    # you update a bug.
+    # warn $result;
+}
+
+sub bug_fields {
+    my ($self, $args) = @_;
+
+    my $fields = $args->{'fields'};
+    push (@$fields, "example")
+}
+
+sub bug_format_comment {
+    my ($self, $args) = @_;
+    
+    # This replaces every occurrence of the word "foo" with the word
+    # "bar"
+    
+    my $regexes = $args->{'regexes'};
+    push(@$regexes, { match => qr/\bfoo\b/, replace => 'bar' });
+    
+    # And this links every occurrence of the word "bar" to example.com,
+    # but it won't affect "foo"s that have already been turned into "bar"
+    # above (because each regex is run in order, and later regexes don't modify
+    # earlier matches, due to some cleverness in Bugzilla's internals).
+    #
+    # For example, the phrase "foo bar" would become:
+    # bar <a href="http://example.com/bar">bar</a>
+    my $bar_match = qr/\b(bar)\b/;
+    push(@$regexes, { match => $bar_match, replace => \&_replace_bar });
+}
+
+# Used by bug_format_comment--see its code for an explanation.
+sub _replace_bar {
+    my $args = shift;
+    # $match is the first parentheses match in the $bar_match regex 
+    # in bug-format_comment.pl. We get up to 10 regex matches as 
+    # arguments to this function.
+    my $match = $args->{matches}->[0];
+    # Remember, you have to HTML-escape any data that you are returning!
+    $match = html_quote($match);
+    return qq{<a href="http://example.com/">$match</a>};
+};
+
+sub buglist_columns {
+    my ($self, $args) = @_;
+    
+    my $columns = $args->{'columns'};
+    $columns->{'example'} = { 'name' => 'bugs.delta_ts' , 'title' => 'Example' };
+    $columns->{'product_desc'} = { 'name'  => 'prod_desc.description',
+                                   'title' => 'Product Description' };
+}
+
+sub buglist_column_joins {
+    my ($self, $args) = @_;
+    my $joins = $args->{'column_joins'};
+
+    # This column is added using the "buglist_columns" hook
+    $joins->{'product_desc'} = {
+        from  => 'product_id',
+        to    => 'id',
+        table => 'products',
+        as    => 'prod_desc',
+        join  => 'INNER',
+    };
+}
+
+sub search_operator_field_override {
+    my ($self, $args) = @_;
+    
+    my $operators = $args->{'operators'};
+
+    my $original = $operators->{component}->{_non_changed};
+    $operators->{component} = {
+        _non_changed => sub { _component_nonchanged($original, @_) }
+    };
+}
+
+sub _component_nonchanged {
+    my $original = shift;
+    my ($invocant, $args) = @_;
+
+    $invocant->$original($args);
+    # Actually, it does not change anything in the result,
+    # just an example.
+    $args->{term} = $args->{term} . " OR 1=2";
+}
+
+sub bugmail_recipients {
+    my ($self, $args) = @_;
+    my $recipients = $args->{recipients};
+    my $bug = $args->{bug};
+
+    my $user = 
+        new Bugzilla::User({ name => Bugzilla->params->{'maintainer'} });
+
+    if ($bug->id == 1) {
+        # Uncomment the line below to add the maintainer to the recipients
+        # list of every bugmail from bug 1 as though that the maintainer
+        # were on the CC list.
+        #$recipients->{$user->id}->{+REL_CC} = 1;
+
+        # And this line adds the maintainer as though he had the "REL_EXAMPLE"
+        # relationship from the bugmail_relationships hook below.
+        #$recipients->{$user->id}->{+REL_EXAMPLE} = 1;
+    }
+}
+
+sub bugmail_relationships {
+    my ($self, $args) = @_;
+    my $relationships = $args->{relationships};
+    $relationships->{+REL_EXAMPLE} = 'Example';
+}
+
+sub config_add_panels {
+    my ($self, $args) = @_;
+    
+    my $modules = $args->{panel_modules};
+    $modules->{Example} = "Bugzilla::Extension::Example::Config";
+}
+
+sub config_modify_panels {
+    my ($self, $args) = @_;
+    
+    my $panels = $args->{panels};
+    
+    # Add the "Example" auth methods.
+    my $auth_params = $panels->{'auth'}->{params};
+    my ($info_class)   = grep($_->{name} eq 'user_info_class', @$auth_params);
+    my ($verify_class) = grep($_->{name} eq 'user_verify_class', @$auth_params);
+
+    push(@{ $info_class->{choices} },   'CGI,Example');
+    push(@{ $verify_class->{choices} }, 'Example');
+
+    push(@$auth_params, { name => 'param_example',
+                          type => 't',
+                          default => 0,
+                          checker => \&check_numeric });    
+}
+
+sub db_schema_abstract_schema {
+    my ($self, $args) = @_;
+#    $args->{'schema'}->{'example_table'} = {
+#        FIELDS => [
+#            id       => {TYPE => 'SMALLSERIAL', NOTNULL => 1,
+#                     PRIMARYKEY => 1},
+#            for_key  => {TYPE => 'INT3', NOTNULL => 1,
+#                           REFERENCES  => {TABLE  =>  'example_table2',
+#                                           COLUMN =>  'id',
+#                                           DELETE => 'CASCADE'}},
+#            col_3    => {TYPE => 'varchar(64)', NOTNULL => 1},
+#        ],
+#        INDEXES => [
+#            id_index_idx   => {FIELDS => ['col_3'], TYPE => 'UNIQUE'},
+#            for_id_idx => ['for_key'],
+#        ],
+#    };
+}
+
+sub email_in_before_parse {
+    my ($self, $args) = @_;
+
+    my $subject = $args->{mail}->header('Subject');
+    # Correctly extract the bug ID from email subjects of the form [Bug comp/NNN].
+    if ($subject =~ /\[.*(\d+)\].*/) {
+        $args->{fields}->{bug_id} = $1;
+    }
+}
+
+sub email_in_after_parse {
+    my ($self, $args) = @_;
+    my $reporter = $args->{fields}->{reporter};
+    my $dbh = Bugzilla->dbh;
+
+    # No other check needed if this is a valid regular user.
+    return if login_to_id($reporter);
+
+    # The reporter is not a regular user. We create an account for him,
+    # but he can only comment on existing bugs.
+    # This is useful for people who reply by email to bugmails received
+    # in mailing-lists.
+    if ($args->{fields}->{bug_id}) {
+        # WARNING: we return now to skip the remaining code below.
+        # You must understand that removing this line would make the code
+        # below effective! Do it only if you are OK with the behavior
+        # described here.
+        return;
+
+        Bugzilla::User->create({ login_name => $reporter, cryptpassword => '*' });
+
+        # For security reasons, delete all fields unrelated to comments.
+        foreach my $field (keys %{$args->{fields}}) {
+            next if $field =~ /^(?:bug_id|comment|reporter)$/;
+            delete $args->{fields}->{$field};
+        }
+    }
+    else {
+        ThrowUserError('invalid_username', { name => $reporter });
+    }
+}
+
+sub enter_bug_entrydefaultvars {
+    my ($self, $args) = @_;
+    
+    my $vars = $args->{vars};
+    $vars->{'example'} = 1;
+}
+
+sub error_catch {
+    my ($self, $args) = @_;
+    # Customize the error message displayed when someone tries to access
+    # page.cgi with an invalid page ID, and keep track of this attempt
+    # in the web server log.
+    return unless Bugzilla->error_mode == ERROR_MODE_WEBPAGE;
+    return unless $args->{error} eq 'bad_page_cgi_id';
+
+    my $page_id = $args->{vars}->{page_id};
+    my $login = Bugzilla->user->identity || "Someone";
+    warn "$login attempted to access page.cgi with id = $page_id";
+
+    my $page = $args->{message};
+    my $new_error_msg = "Ah ah, you tried to access $page_id? Good try!";
+    $new_error_msg = html_quote($new_error_msg);
+    # There are better tools to parse an HTML page, but it's just an example.
+    # Since Perl 5.16, we can no longer write "class" inside look-behind
+    # assertions, because "ss" is also seen as the german ß character, which
+    # makes Perl 5.16 complain. The right fix is to use the /aa modifier,
+    # but it's only understood since Perl 5.14. So the workaround is to write
+    # "clas[s]" instead of "class". Stupid and ugly hack, but it works with
+    # all Perl versions.
+    $$page =~ s/(?<=<td id="error_msg" clas[s]="throw_error">).*(?=<\/td>)/$new_error_msg/si;
+}
+
+sub flag_end_of_update {
+    my ($self, $args) = @_;
+    
+    # This code doesn't actually *do* anything, it's just here to show you
+    # how to use this hook.
+    my $flag_params = $args;
+    my ($object, $timestamp, $old_flags, $new_flags) =
+        @$flag_params{qw(object timestamp old_flags new_flags)};
+    my ($removed, $added) = diff_arrays($old_flags, $new_flags);
+    my ($granted, $denied) = (0, 0);
+    foreach my $new_flag (@$added) {
+        $granted++ if $new_flag =~ /\+$/;
+        $denied++ if $new_flag =~ /-$/;
+    }
+    my $bug_id = $object->isa('Bugzilla::Bug') ? $object->id 
+                                               : $object->bug_id;
+    my $result = "$granted flags were granted and $denied flags were denied"
+                 . " on bug $bug_id at $timestamp.";
+    # Uncomment this line to see $result in your webserver's error log whenever
+    # you update flags.
+    # warn $result;
+}
+
+sub group_before_delete {
+    my ($self, $args) = @_;
+    # This code doesn't actually *do* anything, it's just here to show you
+    # how to use this hook.
+
+    my $group = $args->{'group'};
+    my $group_id = $group->id;
+    # Uncomment this line to see a line in your webserver's error log whenever
+    # you file a bug.
+    # warn "Group $group_id is about to be deleted!";
+}
+
+sub group_end_of_create {
+    my ($self, $args) = @_;
+    # This code doesn't actually *do* anything, it's just here to show you
+    # how to use this hook.
+    my $group = $args->{'group'};
+
+    my $group_id = $group->id;
+    # Uncomment this line to see a line in your webserver's error log whenever
+    # you create a new group.
+    #warn "Group $group_id has been created!";
+}
+
+sub group_end_of_update {
+    my ($self, $args) = @_;
+    # This code doesn't actually *do* anything, it's just here to show you
+    # how to use this hook.
+
+    my ($group, $changes) = @$args{qw(group changes)};
+
+    foreach my $field (keys %$changes) {
+        my $used_to_be = $changes->{$field}->[0];
+        my $now_it_is  = $changes->{$field}->[1];
+    }
+
+    my $group_id = $group->id;
+    my $num_changes = scalar keys %$changes;
+    my $result = 
+        "There were $num_changes changes to fields on group $group_id.";
+    # Uncomment this line to see $result in your webserver's error log whenever
+    # you update a group.
+    #warn $result;
+}
+
+sub install_before_final_checks {
+    my ($self, $args) = @_;
+    print "Install-before_final_checks hook\n" unless $args->{silent};
+    
+    # Add a new user setting like this:
+    #
+    # add_setting('product_chooser',           # setting name
+    #             ['pretty', 'full', 'small'], # options
+    #             'pretty');                   # default
+    #
+    # To add descriptions for the setting and choices, add extra values to 
+    # the hash defined in global/setting-descs.none.tmpl. Do this in a hook: 
+    # hook/global/setting-descs-settings.none.tmpl .
+}
+
+sub install_filesystem {
+    my ($self, $args) = @_;
+    my $create_dirs  = $args->{'create_dirs'};
+    my $recurse_dirs = $args->{'recurse_dirs'};
+    my $htaccess     = $args->{'htaccess'};
+
+    # Create a new directory in datadir specifically for this extension.
+    # The directory will need to allow files to be created by the extension
+    # code as well as allow the webserver to server content from it.
+    # my $data_path = bz_locations->{'datadir'} . "/" . __PACKAGE__->NAME;
+    # $create_dirs->{$data_path} = Bugzilla::Install::Filesystem::DIR_CGI_WRITE;
+   
+    # Update the permissions of any files and directories that currently reside
+    # in the extension's directory. 
+    # $recurse_dirs->{$data_path} = {
+    #     files => Bugzilla::Install::Filesystem::CGI_READ,
+    #     dirs  => Bugzilla::Install::Filesystem::DIR_CGI_WRITE
+    # };
+    
+    # Create a htaccess file that allows specific content to be served from the 
+    # extension's directory.
+    # $htaccess->{"$data_path/.htaccess"} = {
+    #     perms    => Bugzilla::Install::Filesystem::WS_SERVE,
+    #     contents => Bugzilla::Install::Filesystem::HT_DEFAULT_DENY
+    # };
+}
+
+sub install_update_db {
+    my $dbh = Bugzilla->dbh;
+#    $dbh->bz_add_column('example', 'new_column',
+#                        {TYPE => 'INT2', NOTNULL => 1, DEFAULT => 0});
+#    $dbh->bz_add_index('example', 'example_new_column_idx', [qw(value)]);
+}
+
+sub install_update_db_fielddefs {
+    my $dbh = Bugzilla->dbh;
+#    $dbh->bz_add_column('fielddefs', 'example_column', 
+#                        {TYPE => 'MEDIUMTEXT', NOTNULL => 1, DEFAULT => ''});
+}
+
+sub job_map {
+    my ($self, $args) = @_;
+    
+    my $job_map = $args->{job_map};
+    
+    # This adds the named class (an instance of TheSchwartz::Worker) as a
+    # handler for when a job is added with the name "some_task".
+    $job_map->{'some_task'} = 'Bugzilla::Extension::Example::Job::SomeClass';
+    
+    # Schedule a job like this:
+    # my $queue = Bugzilla->job_queue();
+    # $queue->insert('some_task', { some_parameter => $some_variable });
+}
+
+sub mailer_before_send {
+    my ($self, $args) = @_;
+    
+    my $email = $args->{email};
+    # If you add a header to an email, it's best to start it with
+    # 'X-Bugzilla-<Extension>' so that you don't conflict with
+    # other extensions.
+    $email->header_set('X-Bugzilla-Example-Header', 'Example');
+}
+
+sub object_before_create {
+    my ($self, $args) = @_;
+    
+    my $class = $args->{'class'};
+    my $object_params = $args->{'params'};
+    
+    # Note that this is a made-up class, for this example.
+    if ($class->isa('Bugzilla::ExampleObject')) {
+        warn "About to create an ExampleObject!";
+        warn "Got the following parameters: " 
+             . join(', ', keys(%$object_params));
+    }
+}
+
+sub object_before_delete {
+    my ($self, $args) = @_;
+
+    my $object = $args->{'object'};
+
+    # Note that this is a made-up class, for this example.
+    if ($object->isa('Bugzilla::ExampleObject')) {
+        my $id = $object->id;
+        warn "An object with id $id is about to be deleted!";
+    } 
+}
+
+sub object_before_set {
+    my ($self, $args) = @_;
+    
+    my ($object, $field, $value) = @$args{qw(object field value)};
+    
+    # Note that this is a made-up class, for this example.
+    if ($object->isa('Bugzilla::ExampleObject')) {
+        warn "The field $field is changing from " . $object->{$field} 
+             . " to $value!";
+    }
+}
+
+sub object_columns {
+    my ($self, $args) = @_;
+    my ($class, $columns) = @$args{qw(class columns)};
+
+    if ($class->isa('Bugzilla::ExampleObject')) {
+        push(@$columns, 'example');
+    }
+}
+
+sub object_end_of_create {
+    my ($self, $args) = @_;
+    
+    my $class  = $args->{'class'};
+    my $object = $args->{'object'};
+
+    warn "Created a new $class object!";
+}
+
+sub object_end_of_create_validators {
+    my ($self, $args) = @_;
+    
+    my $class = $args->{'class'};
+    my $object_params = $args->{'params'};
+    
+    # Note that this is a made-up class, for this example.
+    if ($class->isa('Bugzilla::ExampleObject')) {
+        # Always set example_field to 1, even if the validators said otherwise.
+        $object_params->{example_field} = 1;
+    }
+    
+}
+
+sub object_end_of_set {
+    my ($self, $args) = @_;
+
+    my ($object, $field) = @$args{qw(object field)};
+
+    # Note that this is a made-up class, for this example.
+    if ($object->isa('Bugzilla::ExampleObject')) {
+        warn "The field $field has changed to " . $object->{$field};
+    }
+}
+
+sub object_end_of_set_all {
+    my ($self, $args) = @_;
+    
+    my $object = $args->{'object'};
+    my $object_params = $args->{'params'};
+    
+    # Note that this is a made-up class, for this example.
+    if ($object->isa('Bugzilla::ExampleObject')) {
+        if ($object_params->{example_field} == 1) {
+            $object->{example_field} = 1;
+        }
+    }
+    
+}
+
+sub object_end_of_update {
+    my ($self, $args) = @_;
+    
+    my ($object, $old_object, $changes) = 
+        @$args{qw(object old_object changes)};
+    
+    # Note that this is a made-up class, for this example.
+    if ($object->isa('Bugzilla::ExampleObject')) {
+        if (defined $changes->{'name'}) {
+            my ($old, $new) = @{ $changes->{'name'} };
+            print "The name field changed from $old to $new!";
+        }
+    }
+}
+
+sub object_update_columns {
+    my ($self, $args) = @_;
+    my ($object, $columns) = @$args{qw(object columns)};
+
+    if ($object->isa('Bugzilla::ExampleObject')) {
+        push(@$columns, 'example');
+    }
+}
+
+sub object_validators {
+    my ($self, $args) = @_;
+    my ($class, $validators) = @$args{qw(class validators)};
+
+    if ($class->isa('Bugzilla::Bug')) {
+        # This is an example of adding a new validator.
+        # See the _check_example subroutine below.
+        $validators->{example} = \&_check_example;
+
+        # This is an example of overriding an existing validator.
+        # See the check_short_desc validator below.
+        my $original = $validators->{short_desc};
+        $validators->{short_desc} = sub { _check_short_desc($original, @_) };
+    }
+}
+
+sub _check_example {
+    my ($invocant, $value, $field) = @_;
+    warn "I was called to validate the value of $field.";
+    warn "The value of $field that I was passed in is: $value";
+
+    # Make the value always be 1.
+    my $fixed_value = 1;
+    return $fixed_value;
+}
+
+sub _check_short_desc {
+    my $original = shift;
+    my $invocant = shift;
+    my $value = $invocant->$original(@_);
+    if ($value !~ /example/i) {
+        # Use this line to make Bugzilla throw an error every time
+        # you try to file a bug or update a bug without the word "example"
+        # in the summary.
+        if (0) {
+            ThrowUserError('example_short_desc_invalid');
+        }
+    }
+    return $value;
+}
+
+sub page_before_template {
+    my ($self, $args) = @_;
+    
+    my ($vars, $page) = @$args{qw(vars page_id)};
+    
+    # You can see this hook in action by loading page.cgi?id=example.html
+    if ($page eq 'example.html') {
+        $vars->{cgi_variables} = { Bugzilla->cgi->Vars };
+    }
+}
+
+sub path_info_whitelist {
+    my ($self, $args) = @_;
+    my $whitelist = $args->{whitelist};
+    push(@$whitelist, "page.cgi");
+}
+
+sub post_bug_after_creation {
+    my ($self, $args) = @_;
+    
+    my $vars = $args->{vars};
+    $vars->{'example'} = 1;
+}
+
+sub product_confirm_delete {
+    my ($self, $args) = @_;
+    
+    my $vars = $args->{vars};
+    $vars->{'example'} = 1;
+}
+
+
+sub product_end_of_create {
+    my ($self, $args) = @_;
+
+    my $product = $args->{product};
+
+    # For this example, any lines of code that actually make changes to your
+    # database have been commented out.
+
+    # This section will take a group that exists in your installation
+    # (possible called test_group) and automatically makes the new
+    # product hidden to only members of the group. Just remove
+    # the restriction if you want the new product to be public.
+
+    my $example_group = new Bugzilla::Group({ name => 'example_group' });
+
+    if ($example_group) {
+        $product->set_group_controls($example_group, 
+                { entry          => 1,
+                  membercontrol  => CONTROLMAPMANDATORY,
+                  othercontrol   => CONTROLMAPMANDATORY });
+#        $product->update();
+    }
+
+    # This section will automatically add a default component
+    # to the new product called 'No Component'.
+
+    my $default_assignee = new Bugzilla::User(
+        { name => Bugzilla->params->{maintainer} });
+
+    if ($default_assignee) {
+#        Bugzilla::Component->create(
+#            { name             => 'No Component',
+#              product          => $product,
+#              description      => 'Select this component if one does not ' . 
+#                                  'exist in the current list of components',
+#              initialowner     => $default_assignee });
+    }
+}
+
+sub quicksearch_map {
+    my ($self, $args) = @_;
+    my $map = $args->{'map'};
+
+    # This demonstrates adding a shorter alias for a long custom field name.
+    $map->{'impact'} = $map->{'cf_long_field_name_for_impact_field'};
+}
+
+sub sanitycheck_check {
+    my ($self, $args) = @_;
+    
+    my $dbh = Bugzilla->dbh;
+    my $sth;
+    
+    my $status = $args->{'status'};
+    
+    # Check that all users are Australian
+    $status->('example_check_au_user');
+    
+    $sth = $dbh->prepare("SELECT userid, login_name
+                            FROM profiles
+                           WHERE login_name NOT LIKE '%.au'");
+    $sth->execute;
+    
+    my $seen_nonau = 0;
+    while (my ($userid, $login, $numgroups) = $sth->fetchrow_array) {
+        $status->('example_check_au_user_alert',
+                  { userid => $userid, login => $login },
+                  'alert');
+        $seen_nonau = 1;
+    }
+    
+    $status->('example_check_au_user_prompt') if $seen_nonau;
+}
+
+sub sanitycheck_repair {
+    my ($self, $args) = @_;
+    
+    my $cgi = Bugzilla->cgi;
+    my $dbh = Bugzilla->dbh;
+    
+    my $status = $args->{'status'};
+    
+    if ($cgi->param('example_repair_au_user')) {
+        $status->('example_repair_au_user_start');
+    
+        #$dbh->do("UPDATE profiles
+        #             SET login_name = CONCAT(login_name, '.au')
+        #           WHERE login_name NOT LIKE '%.au'");
+    
+        $status->('example_repair_au_user_end');
+    }
+}
+
+sub template_before_create {
+    my ($self, $args) = @_;
+    
+    my $config = $args->{'config'};
+    # This will be accessible as "example_global_variable" in every
+    # template in Bugzilla. See Bugzilla/Template.pm's create() function
+    # for more things that you can set.
+    $config->{VARIABLES}->{example_global_variable} = sub { return 'value' };
+}
+
+sub template_before_process {
+    my ($self, $args) = @_;
+    
+    my ($vars, $file, $context) = @$args{qw(vars file context)};
+
+    if ($file eq 'bug/edit.html.tmpl') {
+        $vars->{'viewing_the_bug_form'} = 1;
+    }
+}
+
+sub user_preferences {
+    my ($self, $args) = @_;
+    my $tab = $args->{current_tab};
+    my $save = $args->{save_changes};
+    my $handled = $args->{handled};
+
+    return unless $tab eq 'my_tab';
+
+    my $value = Bugzilla->input_params->{'example_pref'};
+    if ($save) {
+        # Validate your data and update the DB accordingly.
+        $value =~ s/\s+/:/g;
+    }
+    $args->{'vars'}->{example_pref} = $value;
+
+    # Set the 'handled' scalar reference to true so that the caller
+    # knows the panel name is valid and that an extension took care of it.
+    $$handled = 1;
+}
+
+sub webservice {
+    my ($self, $args) = @_;
+
+    my $dispatch = $args->{dispatch};
+    $dispatch->{Example} = "Bugzilla::Extension::Example::WebService";
+}
+
+sub webservice_error_codes {
+    my ($self, $args) = @_;
+    
+    my $error_map = $args->{error_map};
+    $error_map->{'example_my_error'} = 10001;
+}
+
+# This must be the last line of your extension.
+__PACKAGE__->NAME;

diff --git a/extensions/Example/disabled b/extensions/Example/disabled
new file mode 100644 (file)
index 0000000..e69de29

diff --git a/extensions/Example/lib/Auth/Login.pm b/extensions/Example/lib/Auth/Login.pm
new file mode 100644 (file)
index 0000000..f878311
--- /dev/null
+++ b/extensions/Example/lib/Auth/Login.pm
@@ -0,0 +1,19 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::Example::Auth::Login;
+use strict;
+use base qw(Bugzilla::Auth::Login);
+use constant user_can_create_account => 0;
+use Bugzilla::Constants;
+
+# Always returns no data.
+sub get_login_info {
+    return { failure => AUTH_NODATA };
+}
+
+1;

diff --git a/extensions/Example/lib/Auth/Verify.pm b/extensions/Example/lib/Auth/Verify.pm
new file mode 100644 (file)
index 0000000..0d068b2
--- /dev/null
+++ b/extensions/Example/lib/Auth/Verify.pm
@@ -0,0 +1,18 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::Example::Auth::Verify;
+use strict;
+use base qw(Bugzilla::Auth::Verify);
+use Bugzilla::Constants;
+
+# A verifier that always fails.
+sub check_credentials {
+    return { failure => AUTH_NO_SUCH_USER };
+}
+
+1;

diff --git a/extensions/Example/lib/Config.pm b/extensions/Example/lib/Config.pm
new file mode 100644 (file)
index 0000000..b0497a7
--- /dev/null
+++ b/extensions/Example/lib/Config.pm
@@ -0,0 +1,29 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::Example::Config;
+use strict;
+use warnings;
+
+use Bugzilla::Config::Common;
+
+our $sortkey = 5000;
+
+sub get_param_list {
+    my ($class) = @_;
+
+    my @param_list = (
+    {
+        name => 'example_string',
+        type => 't',
+        default => 'EXAMPLE',
+    },
+    );
+    return @param_list;
+}
+
+1;

diff --git a/extensions/Example/lib/Util.pm b/extensions/Example/lib/Util.pm
new file mode 100644 (file)
index 0000000..b4ed3e0
--- /dev/null
+++ b/extensions/Example/lib/Util.pm
@@ -0,0 +1,15 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::Example::Util;
+use strict;
+use warnings;
+
+# This file exists only to demonstrate how to use and name your
+# modules in an extension.
+
+1;

diff --git a/extensions/Example/lib/WebService.pm b/extensions/Example/lib/WebService.pm
new file mode 100644 (file)
index 0000000..659189d
--- /dev/null
+++ b/extensions/Example/lib/WebService.pm
@@ -0,0 +1,19 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::Example::WebService;
+use strict;
+use warnings;
+use base qw(Bugzilla::WebService);
+use Bugzilla::Error;
+
+# This can be called as Example.hello() from the WebService.
+sub hello { return 'Hello!'; }
+
+sub throw_an_error { ThrowUserError('example_my_error') }
+
+1;

diff --git a/extensions/Example/template/en/default/account/prefs/my_tab.html.tmpl b/extensions/Example/template/en/default/account/prefs/my_tab.html.tmpl
new file mode 100644 (file)
index 0000000..d2f1dcd
--- /dev/null
+++ b/extensions/Example/template/en/default/account/prefs/my_tab.html.tmpl
@@ -0,0 +1,18 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+<p>
+  Type some short text in the field below. Whitespaces will be replaced
+  by colons.
+</p>
+
+<p>
+  <label for="example_pref">Short text:</label>
+  <input type="text" id="example_pref" name="example_pref" size="30"
+         maxlength="50" value="[% example_pref FILTER html %]">
+</p>

diff --git a/extensions/Example/template/en/default/admin/params/example.html.tmpl b/extensions/Example/template/en/default/admin/params/example.html.tmpl
new file mode 100644 (file)
index 0000000..4814394
--- /dev/null
+++ b/extensions/Example/template/en/default/admin/params/example.html.tmpl
@@ -0,0 +1,16 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[%
+    title = "Example Extension"
+    desc = "Configure example extension"
+%]
+
+[% param_descs = {
+  example_string => "Example string",
+}
+%]

diff --git a/extensions/Example/template/en/default/hook/account/prefs/prefs-tabs.html.tmpl b/extensions/Example/template/en/default/hook/account/prefs/prefs-tabs.html.tmpl
new file mode 100644 (file)
index 0000000..202dd1e
--- /dev/null
+++ b/extensions/Example/template/en/default/hook/account/prefs/prefs-tabs.html.tmpl
@@ -0,0 +1,11 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% tabs = tabs.import([{ name => "my_tab", label => "Example Custom Preferences",
+                         link => "userprefs.cgi?tab=my_tab", saveable => 1 }
+                      ]) %]

diff --git a/extensions/Example/template/en/default/hook/admin/params/editparams-current_panel.html.tmpl b/extensions/Example/template/en/default/hook/admin/params/editparams-current_panel.html.tmpl
new file mode 100644 (file)
index 0000000..42826e9
--- /dev/null
+++ b/extensions/Example/template/en/default/hook/admin/params/editparams-current_panel.html.tmpl
@@ -0,0 +1,11 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% IF panel.name == "auth" %]
+    [% panel.param_descs.param_example = 'Example new parameter' %]
+[% END -%]

diff --git a/extensions/Example/template/en/default/hook/admin/sanitycheck/messages-statuses.html.tmpl b/extensions/Example/template/en/default/hook/admin/sanitycheck/messages-statuses.html.tmpl
new file mode 100644 (file)
index 0000000..9cc4551
--- /dev/null
+++ b/extensions/Example/template/en/default/hook/admin/sanitycheck/messages-statuses.html.tmpl
@@ -0,0 +1,23 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% IF    san_tag == "example_check_au_user" %]
+  <em>EXAMPLE PLUGIN</em> - Checking for non-Australian users.
+[% ELSIF san_tag == "example_check_au_user_alert" %]
+  User &lt;[% login FILTER html %]&gt; isn't Australian.
+  [% IF user.in_group('editusers') %]
+    <a href="editusers.cgi?id=[% userid FILTER none %]">Edit this user</a>.
+  [% END %]
+[% ELSIF san_tag == "example_check_au_user_prompt" %]
+  <a href="sanitycheck.cgi?example_repair_au_user=1&amp;token=
+     [%- issue_hash_token(['sanitycheck']) FILTER uri %]">Fix these users</a>.
+[% ELSIF san_tag == "example_repair_au_user_start" %]
+  <em>EXAMPLE PLUGIN</em> - OK, would now make users Australian.
+[% ELSIF san_tag == "example_repair_au_user_end" %]
+  <em>EXAMPLE PLUGIN</em> - Users would now be Australian.
+[% END %]

diff --git a/extensions/Example/template/en/default/hook/global/footer-end.html.tmpl b/extensions/Example/template/en/default/hook/global/footer-end.html.tmpl
new file mode 100644 (file)
index 0000000..f4cb1e0
--- /dev/null
+++ b/extensions/Example/template/en/default/hook/global/footer-end.html.tmpl
@@ -0,0 +1,16 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% USE date %]
+
+<p align="center">
+  <em>[% component.callers.first FILTER html %]</em> processed
+  on [% date.format(date.now, '%b %d, %Y at %H:%M:%S') FILTER html %].
+  <br>
+  (provided by the Example extension).
+</p>

diff --git a/extensions/Example/template/en/default/hook/global/setting-descs-settings.none.tmpl b/extensions/Example/template/en/default/hook/global/setting-descs-settings.none.tmpl
new file mode 100644 (file)
index 0000000..7077f26
--- /dev/null
+++ b/extensions/Example/template/en/default/hook/global/setting-descs-settings.none.tmpl
@@ -0,0 +1,14 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% 
+    setting_descs.product_chooser = "Product chooser to use when entering $terms.bugs",
+    setting_descs.pretty = "Pretty chooser with common products and icons",
+    setting_descs.full   = "Full chooser with all products",
+    setting_descs.small  = "Product chooser for mobile devices",
+%]

diff --git a/extensions/Example/template/en/default/hook/global/user-error-errors.html.tmpl b/extensions/Example/template/en/default/hook/global/user-error-errors.html.tmpl
new file mode 100644 (file)
index 0000000..33c77e4
--- /dev/null
+++ b/extensions/Example/template/en/default/hook/global/user-error-errors.html.tmpl
@@ -0,0 +1,14 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[% IF error == "example_my_error" %]
+   [% title = "Example Error Title" %]
+   This is the error message! It contains <em>some html</em>.
+[% ELSIF error == "example_short_desc_invalid" %]
+  [% title = "Bad Summary" %]
+  The Summary must contain the word "example".
+[% END %]

diff --git a/extensions/Example/template/en/default/pages/example.html.tmpl b/extensions/Example/template/en/default/pages/example.html.tmpl
new file mode 100644 (file)
index 0000000..fda74bf
--- /dev/null
+++ b/extensions/Example/template/en/default/pages/example.html.tmpl
@@ -0,0 +1,19 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+    title = "Example Page" 
+%]
+
+<p>Here's what you passed me:</p>
+[% USE Dumper %]
+<pre>
+  [% Dumper.dump_html(cgi_variables) FILTER none %]
+</pre>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/extensions/Example/template/en/default/setup/strings.txt.pl b/extensions/Example/template/en/default/setup/strings.txt.pl
new file mode 100644 (file)
index 0000000..9855054
--- /dev/null
+++ b/extensions/Example/template/en/default/setup/strings.txt.pl
@@ -0,0 +1,12 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+%strings = (
+  feature_example_acme => 'Example Extension: Acme Feature',
+);
+
+1;

diff --git a/extensions/MoreBugUrl/Config.pm b/extensions/MoreBugUrl/Config.pm
new file mode 100644 (file)
index 0000000..b5af9c0
--- /dev/null
+++ b/extensions/MoreBugUrl/Config.pm
@@ -0,0 +1,19 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::MoreBugUrl;
+use strict;
+
+use constant NAME => 'MoreBugUrl';
+
+use constant REQUIRED_MODULES => [
+];
+
+use constant OPTIONAL_MODULES => [
+];
+
+__PACKAGE__->NAME;

diff --git a/extensions/MoreBugUrl/Extension.pm b/extensions/MoreBugUrl/Extension.pm
new file mode 100644 (file)
index 0000000..52b6e61
--- /dev/null
+++ b/extensions/MoreBugUrl/Extension.pm
@@ -0,0 +1,46 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::MoreBugUrl;
+use strict;
+use base qw(Bugzilla::Extension);
+
+use constant MORE_SUB_CLASSES => qw(
+    Bugzilla::Extension::MoreBugUrl::ReviewBoard
+    Bugzilla::Extension::MoreBugUrl::Rietveld
+    Bugzilla::Extension::MoreBugUrl::RT
+    Bugzilla::Extension::MoreBugUrl::GetSatisfaction
+    Bugzilla::Extension::MoreBugUrl::PHP
+);
+
+# We need to update bug_see_also table because both
+# Rietveld and ReviewBoard were originally under Bugzilla/BugUrl/.
+sub install_update_db {
+    my $dbh = Bugzilla->dbh;
+
+    my $should_rename = $dbh->selectrow_array(
+        q{SELECT 1 FROM bug_see_also
+          WHERE class IN ('Bugzilla::BugUrl::Rietveld', 
+                          'Bugzilla::BugUrl::ReviewBoard')});
+
+    if ($should_rename) {
+        my $sth = $dbh->prepare('UPDATE bug_see_also SET class = ?
+                                 WHERE class = ?');
+        $sth->execute('Bugzilla::Extension::MoreBugUrl::ReviewBoard',
+                      'Bugzilla::BugUrl::ReviewBoard');
+
+        $sth->execute('Bugzilla::Extension::MoreBugUrl::Rietveld',
+                      'Bugzilla::BugUrl::Rietveld');
+    }
+}
+
+sub bug_url_sub_classes {
+    my ($self, $args) = @_;
+    push @{ $args->{sub_classes} }, MORE_SUB_CLASSES;
+}
+
+__PACKAGE__->NAME;

diff --git a/extensions/MoreBugUrl/disabled b/extensions/MoreBugUrl/disabled
new file mode 100644 (file)
index 0000000..e69de29

diff --git a/extensions/MoreBugUrl/lib/GetSatisfaction.pm b/extensions/MoreBugUrl/lib/GetSatisfaction.pm
new file mode 100644 (file)
index 0000000..e454856
--- /dev/null
+++ b/extensions/MoreBugUrl/lib/GetSatisfaction.pm
@@ -0,0 +1,37 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::MoreBugUrl::GetSatisfaction;
+use strict;
+use base qw(Bugzilla::BugUrl);
+
+###############################
+####        Methods        ####
+###############################
+
+sub should_handle {
+    my ($class, $uri) = @_;
+
+    # GetSatisfaction URLs only have one form:
+    #   http(s)://getsatisfaction.com/PROJECT_NAME/topics/TOPIC_NAME
+    return (lc($uri->authority) eq 'getsatisfaction.com'
+            and $uri->path =~ m|^/[^/]+/topics/[^/]+$|) ? 1 : 0;
+}
+
+sub _check_value {
+    my ($class, $uri) = @_;
+
+    $uri = $class->SUPER::_check_value($uri);
+
+    # GetSatisfaction HTTP URLs redirect to HTTPS, so just use the HTTPS
+    # scheme.
+    $uri->scheme('https');
+
+    return $uri;
+}
+
+1;

diff --git a/extensions/MoreBugUrl/lib/PHP.pm b/extensions/MoreBugUrl/lib/PHP.pm
new file mode 100644 (file)
index 0000000..c17a499
--- /dev/null
+++ b/extensions/MoreBugUrl/lib/PHP.pm
@@ -0,0 +1,40 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::MoreBugUrl::PHP;
+use strict;
+use base qw(Bugzilla::BugUrl);
+
+###############################
+####        Methods        ####
+###############################
+
+sub should_handle {
+    my ($class, $uri) = @_;
+
+    # PHP Bug URLs have only one form:
+    #   https://bugs.php.net/bug.php?id=1234
+    return (lc($uri->authority) eq 'bugs.php.net'
+            and $uri->path =~ m|/bug\.php$|
+            and $uri->query_param('id') =~ /^\d+$/) ? 1 : 0;
+}
+
+sub _check_value {
+    my $class = shift;
+
+    my $uri = $class->SUPER::_check_value(@_);
+
+    # PHP Bug URLs redirect to HTTPS, so just use the HTTPS scheme.
+    $uri->scheme('https');
+
+    # And remove any # part if there is one.
+    $uri->fragment(undef);
+
+    return $uri;
+}
+
+1;

diff --git a/extensions/MoreBugUrl/lib/RT.pm b/extensions/MoreBugUrl/lib/RT.pm
new file mode 100644 (file)
index 0000000..724c773
--- /dev/null
+++ b/extensions/MoreBugUrl/lib/RT.pm
@@ -0,0 +1,37 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::MoreBugUrl::RT;
+use strict;
+use base qw(Bugzilla::BugUrl);
+
+###############################
+####        Methods        ####
+###############################
+
+sub should_handle {
+    my ($class, $uri) = @_;
+
+    # RT URLs can look like various things:
+    #   http://example.com/rt/Ticket/Display.html?id=1234
+    #   https://example.com/Public/Bug/Display.html?id=1234
+    return ($uri->path =~ m|/Display\.html$|
+            and $uri->query_param('id') =~ /^\d+$/) ? 1 : 0;
+}
+
+sub _check_value {
+    my $class = shift;
+
+    my $uri = $class->SUPER::_check_value(@_);
+
+    # And remove any # part if there is one.
+    $uri->fragment(undef);
+
+    return $uri;
+}
+
+1;

diff --git a/extensions/MoreBugUrl/lib/ReviewBoard.pm b/extensions/MoreBugUrl/lib/ReviewBoard.pm
new file mode 100644 (file)
index 0000000..7628dd3
--- /dev/null
+++ b/extensions/MoreBugUrl/lib/ReviewBoard.pm
@@ -0,0 +1,42 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::MoreBugUrl::ReviewBoard;
+use strict;
+use base qw(Bugzilla::BugUrl);
+
+###############################
+####        Methods        ####
+###############################
+
+sub should_handle {
+    my ($class, $uri) = @_;
+    return ($uri->path =~ m|/r/\d+/?$|) ? 1 : 0;
+}
+
+sub _check_value {
+    my $class = shift;
+
+    my $uri = $class->SUPER::_check_value(@_);
+
+    # Review Board URLs have only one form (the trailing slash is optional):
+    #   http://reviews.reviewboard.org/r/111/
+
+    # Make sure there are no query parameters.
+    $uri->query(undef);
+    # And remove any # part if there is one.
+    $uri->fragment(undef);
+
+    # make sure the trailing slash is present
+    if ($uri->path !~ m|/$|) {
+        $uri->path($uri->path . '/');
+    }
+
+    return $uri;
+}
+
+1;

diff --git a/extensions/MoreBugUrl/lib/Rietveld.pm b/extensions/MoreBugUrl/lib/Rietveld.pm
new file mode 100644 (file)
index 0000000..0c52892
--- /dev/null
+++ b/extensions/MoreBugUrl/lib/Rietveld.pm
@@ -0,0 +1,45 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::MoreBugUrl::Rietveld;
+use strict;
+use base qw(Bugzilla::BugUrl);
+
+###############################
+####        Methods        ####
+###############################
+
+sub should_handle {
+    my ($class, $uri) = @_;
+    return ($uri->authority =~ /\.appspot\.com$/i
+            and $uri->path =~ m#^/\d+(?:/|/show)?$#) ? 1 : 0;
+}
+
+sub _check_value {
+    my ($class, $uri) = @_;
+
+    $uri = $class->SUPER::_check_value($uri);
+
+    # Rietveld URLs have three forms:
+    #   http(s)://example.appspot.com/1234
+    #   http(s)://example.appspot.com/1234/
+    #   http(s)://example.appspot.com/1234/show
+    if ($uri->path =~ m#^/(\d+)(?:/|/show)$#) {
+        # This is the shortest standard URL form for Rietveld issues,
+        # and so we reduce all URLs to this.
+        $uri->path('/' . $1);
+    }
+
+    # Make sure there are no query parameters.
+    $uri->query(undef);
+    # And remove any # part if there is one.
+    $uri->fragment(undef);
+
+    return $uri;
+}
+
+1;

diff --git a/extensions/MoreBugUrl/template/en/default/hook/global/user-error-bug_url_invalid_tracker.html.tmpl b/extensions/MoreBugUrl/template/en/default/hook/global/user-error-bug_url_invalid_tracker.html.tmpl
new file mode 100644 (file)
index 0000000..7683e42
--- /dev/null
+++ b/extensions/MoreBugUrl/template/en/default/hook/global/user-error-bug_url_invalid_tracker.html.tmpl
@@ -0,0 +1,13 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+<li>A Review Board review request.</li>
+<li>An issue in a Rietveld installation.</li>
+<li>A ticket in an RT installation.</li>
+<li>A topic on getsatisfaction.com.</li>
+<li>A b[% %]ug on b[% %]ugs.php.net.</li>

diff --git a/extensions/OldBugMove/Config.pm b/extensions/OldBugMove/Config.pm
new file mode 100644 (file)
index 0000000..9564861
--- /dev/null
+++ b/extensions/OldBugMove/Config.pm
@@ -0,0 +1,11 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::OldBugMove;
+use strict;
+use constant NAME => 'OldBugMove';
+__PACKAGE__->NAME;

diff --git a/extensions/OldBugMove/Extension.pm b/extensions/OldBugMove/Extension.pm
new file mode 100644 (file)
index 0000000..9a499d5
--- /dev/null
+++ b/extensions/OldBugMove/Extension.pm
@@ -0,0 +1,196 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::OldBugMove;
+use strict;
+use base qw(Bugzilla::Extension);
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Field::Choice;
+use Bugzilla::Mailer;
+use Bugzilla::User;
+use Bugzilla::Util qw(trim);
+
+use Scalar::Util qw(blessed);
+use Storable qw(dclone);
+
+use constant VERSION => BUGZILLA_VERSION;
+
+# This is 4 because that's what it originally was when this code was
+# a part of Bugzilla.
+use constant CMT_MOVED_TO => 4;
+
+sub install_update_db {
+    my $reso_type = Bugzilla::Field::Choice->type('resolution');
+    my $moved_reso = $reso_type->new({ name => 'MOVED' });
+    # We make the MOVED resolution inactive, so that it doesn't show up
+    # as a valid drop-down option.
+    if ($moved_reso) {
+        $moved_reso->set_is_active(0);
+        $moved_reso->update();
+    }
+    else {
+        print "Creating the MOVED resolution...\n";
+        $reso_type->create(
+           { value   => 'MOVED', sortkey => '30000', isactive => 0 });
+    }
+}
+
+sub config_add_panels {
+    my ($self, $args) = @_;
+    my $modules = $args->{'panel_modules'};
+    $modules->{'OldBugMove'} = 'Bugzilla::Extension::OldBugMove::Params';
+}
+
+sub template_before_create {
+    my ($self, $args) = @_;
+    my $config = $args->{config};
+
+    my $constants = $config->{CONSTANTS};
+    $constants->{CMT_MOVED_TO} = CMT_MOVED_TO;
+
+    my $vars = $config->{VARIABLES};
+    $vars->{oldbugmove_user_is_mover} = \&_user_is_mover;
+}
+
+sub object_before_delete {
+    my ($self, $args) = @_;
+    my $object = $args->{'object'};
+    if ($object->isa('Bugzilla::Field::Choice::resolution')) {
+        if ($object->name eq 'MOVED') {
+            ThrowUserError('oldbugmove_no_delete_moved');
+        }
+    }
+}
+
+sub object_before_set {
+    my ($self, $args) = @_;
+    my ($object, $field) = @$args{qw(object field)};
+    if ($field eq 'resolution' and $object->isa('Bugzilla::Bug')) {
+        # Store the old value so that end_of_set can check it.
+        $object->{'_oldbugmove_old_resolution'} = $object->resolution;
+    }
+}
+
+sub object_end_of_set {
+    my ($self, $args) = @_;
+    my ($object, $field) = @$args{qw(object field)};
+    if ($field eq 'resolution' and $object->isa('Bugzilla::Bug')) {
+        my $old_value = delete $object->{'_oldbugmove_old_resolution'};
+        return if $old_value eq $object->resolution;
+        if ($object->resolution eq 'MOVED') {
+            $object->add_comment('', { type => CMT_MOVED_TO,
+                                       extra_data => Bugzilla->user->login });
+        }
+    }
+}
+
+sub object_end_of_set_all {
+    my ($self, $args) = @_;
+    my $object = $args->{'object'};
+
+    if ($object->isa('Bugzilla::Bug') and Bugzilla->input_params->{'oldbugmove'}) {
+        my $new_status = Bugzilla->params->{'duplicate_or_move_bug_status'};
+        $object->set_bug_status($new_status, { resolution => 'MOVED' });
+    }
+}
+
+sub object_validators {
+    my ($self, $args) = @_;
+    my ($class, $validators) = @$args{qw(class validators)};
+    if ($class->isa('Bugzilla::Comment')) {
+        my $extra_data_validator = $validators->{extra_data};
+        $validators->{extra_data} = 
+            sub { _check_comment_extra_data($extra_data_validator, @_) };
+    }
+    elsif ($class->isa('Bugzilla::Bug')) {
+        my $reso_validator = $validators->{resolution};
+        $validators->{resolution} =
+            sub { _check_bug_resolution($reso_validator, @_) };
+    }
+}
+
+sub _check_bug_resolution {
+    my $original_validator = shift;
+    my ($invocant, $resolution) = @_;
+
+    if ($resolution eq 'MOVED' && $invocant->resolution ne 'MOVED'
+        && !Bugzilla->input_params->{'oldbugmove'})
+    {
+        # MOVED has a special meaning and can only be used when
+        # really moving bugs to another installation.
+        ThrowUserError('oldbugmove_no_manual_move');
+    }
+
+    return $original_validator->(@_);
+}
+
+sub _check_comment_extra_data {
+    my $original_validator = shift;
+    my ($invocant, $extra_data, undef, $params) = @_;
+    my $type = blessed($invocant) ? $invocant->type : $params->{type};
+
+    if ($type == CMT_MOVED_TO) {
+        return Bugzilla::User->check($extra_data)->login;
+    }
+    return $original_validator->(@_);
+}
+
+sub bug_end_of_update {
+    my ($self, $args) = @_;
+    my ($bug, $old_bug, $changes) = @$args{qw(bug old_bug changes)};
+    if (defined $changes->{'resolution'}
+        and $changes->{'resolution'}->[1] eq 'MOVED')
+    {
+        $self->_move_bug($bug, $old_bug);
+    }
+}
+
+sub _move_bug {
+    my ($self, $bug, $old_bug) = @_;
+
+    my $dbh = Bugzilla->dbh;
+    my $template = Bugzilla->template;
+
+    _user_is_mover(Bugzilla->user) 
+        or ThrowUserError("auth_failure", { action => 'move',
+                                            object => 'bugs' });
+
+    # Don't export the new status and resolution. We want the current
+    # ones.
+    local $Storable::forgive_me = 1;
+    my $export_me = dclone($bug);
+    $export_me->{bug_status} = $old_bug->bug_status;
+    delete $export_me->{status};
+    $export_me->{resolution} = $old_bug->resolution;
+
+    # Prepare and send all data about these bugs to the new database
+    my $to = Bugzilla->params->{'move-to-address'};
+    $to =~ s/@/\@/;
+    my $from = Bugzilla->params->{'mailfrom'};
+    $from =~ s/@/\@/;
+    my $msg = "To: $to\n";
+    $msg .= "From: Bugzilla <" . $from . ">\n";
+    $msg .= "Subject: Moving bug " . $bug->id . "\n\n";
+    my @fieldlist = (Bugzilla::Bug->fields, 'group', 'long_desc',
+                     'attachment', 'attachmentdata');
+    my %displayfields = map { $_ => 1 } @fieldlist;
+    my $vars = { bugs => [$export_me], displayfields => \%displayfields };
+    $template->process("bug/show.xml.tmpl", $vars, \$msg)
+      || ThrowTemplateError($template->error());
+    $msg .= "\n";
+    MessageToMTA($msg);
+}
+
+sub _user_is_mover {
+    my $user = shift;
+
+    my @movers = map { trim($_) } split(',', Bugzilla->params->{'movers'});
+    return ($user->id and grep($_ eq $user->login, @movers)) ? 1 : 0;
+}
+
+__PACKAGE__->NAME;

diff --git a/extensions/OldBugMove/disabled b/extensions/OldBugMove/disabled
new file mode 100644 (file)
index 0000000..e69de29

diff --git a/extensions/OldBugMove/lib/Params.pm b/extensions/OldBugMove/lib/Params.pm
new file mode 100644 (file)
index 0000000..dbb1eb2
--- /dev/null
+++ b/extensions/OldBugMove/lib/Params.pm
@@ -0,0 +1,36 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::OldBugMove::Params;
+
+use strict;
+
+use Bugzilla::Config::Common;
+
+our $sortkey = 700;
+
+use constant get_param_list => (
+  {
+   name => 'move-to-url',
+   type => 't',
+   default => ''
+  },
+
+  {
+   name => 'move-to-address',
+   type => 't',
+   default => 'bugzilla-import'
+  },
+
+  {
+   name => 'movers',
+   type => 't',
+   default => ''
+  },
+);
+
+1;

diff --git a/extensions/OldBugMove/template/en/default/admin/params/oldbugmove.html.tmpl b/extensions/OldBugMove/template/en/default/admin/params/oldbugmove.html.tmpl
new file mode 100644 (file)
index 0000000..0a54c46
--- /dev/null
+++ b/extensions/OldBugMove/template/en/default/admin/params/oldbugmove.html.tmpl
@@ -0,0 +1,27 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[%
+   title = "$terms.Bug Moving"
+   desc = "Set up parameters to move $terms.bugs to/from another installation"
+%]
+
+[% param_descs = {
+
+  "move-to-url" => 
+    "The URL of the database we allow some of our $terms.bugs to"
+    _ " be moved to.",
+
+  "move-to-address" => 
+    "To move ${terms.bugs}, an email is sent to the target database."
+    _ " This is the email address that that database uses to listen"
+    _ " for incoming ${terms.bugs}.",
+
+  movers => 
+    "A list of people with permission to move $terms.bugs ",
+
+} %]

diff --git a/extensions/OldBugMove/template/en/default/hook/bug/edit-after_comment_textarea.html.tmpl b/extensions/OldBugMove/template/en/default/hook/bug/edit-after_comment_textarea.html.tmpl
new file mode 100644 (file)
index 0000000..1490f08
--- /dev/null
+++ b/extensions/OldBugMove/template/en/default/hook/bug/edit-after_comment_textarea.html.tmpl
@@ -0,0 +1,15 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% IF oldbugmove_user_is_mover(user) AND bug.resolution != 'MOVED' %]
+  <p>
+    <input type="submit" id="oldbugmove" name="oldbugmove"
+           value="Move [% terms.Bug FILTER html %] to 
+                  [%= Param('move-to-url') FILTER html %]">
+  </p>
+[% END %]

diff --git a/extensions/OldBugMove/template/en/default/hook/bug/format_comment-type.txt.tmpl b/extensions/OldBugMove/template/en/default/hook/bug/format_comment-type.txt.tmpl
new file mode 100644 (file)
index 0000000..afe03af
--- /dev/null
+++ b/extensions/OldBugMove/template/en/default/hook/bug/format_comment-type.txt.tmpl
@@ -0,0 +1,17 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% IF comment.type == constants.CMT_MOVED_TO %]
+[% comment.body %]
+
+[%+ terms.Bug %] moved to [% Param("move-to-url") %].
+If the move succeeded, [% comment.extra_data FILTER email %] will receive a mail
+containing the number of the new [% terms.bug %] in the other database.
+If all went well, please paste in a link to the new [% terms.bug %]. 
+Otherwise, reopen this [% terms.bug %].
+[% END %]

diff --git a/extensions/OldBugMove/template/en/default/hook/global/user-error-auth_failure_action.html.tmpl b/extensions/OldBugMove/template/en/default/hook/global/user-error-auth_failure_action.html.tmpl
new file mode 100644 (file)
index 0000000..1966a1a
--- /dev/null
+++ b/extensions/OldBugMove/template/en/default/hook/global/user-error-auth_failure_action.html.tmpl
@@ -0,0 +1,11 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% IF action == "move" %]
+  move
+[% END %]

diff --git a/extensions/OldBugMove/template/en/default/hook/global/user-error-errors.html.tmpl b/extensions/OldBugMove/template/en/default/hook/global/user-error-errors.html.tmpl
new file mode 100644 (file)
index 0000000..d45026b
--- /dev/null
+++ b/extensions/OldBugMove/template/en/default/hook/global/user-error-errors.html.tmpl
@@ -0,0 +1,17 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% IF error == "oldbugmove_no_delete_moved" %]
+    As long as the OldBugMove extension is active, you cannot
+    delete the [%+ display_value("resolution", "MOVED") FILTER html %]
+    resolution.
+[% ELSIF error == "oldbugmove_no_manual_move" %]
+    You cannot set the resolution of [% terms.abug %] to 
+    [%+ display_value("resolution", "MOVED") FILTER html %] without
+    moving the [% terms.bug %].
+[% END %]

diff --git a/extensions/OldBugMove/template/en/default/hook/list/edit-multiple-after_groups.html.tmpl b/extensions/OldBugMove/template/en/default/hook/list/edit-multiple-after_groups.html.tmpl
new file mode 100644 (file)
index 0000000..a5380da
--- /dev/null
+++ b/extensions/OldBugMove/template/en/default/hook/list/edit-multiple-after_groups.html.tmpl
@@ -0,0 +1,15 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% IF oldbugmove_user_is_mover(user) %]
+  <p>
+    <input type="submit" id="oldbugmove" name="oldbugmove"
+           value="Move [% terms.Bugs FILTER html %] to 
+                  [%= Param('move-to-url') FILTER html %]">
+  </p>
+[% END %]

diff --git a/extensions/Voting/Config.pm b/extensions/Voting/Config.pm
new file mode 100644 (file)
index 0000000..4fefe95
--- /dev/null
+++ b/extensions/Voting/Config.pm
@@ -0,0 +1,19 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::Voting;
+use strict;
+
+use constant NAME => 'Voting';
+
+use constant REQUIRED_MODULES => [
+];
+
+use constant OPTIONAL_MODULES => [
+];
+
+__PACKAGE__->NAME;

diff --git a/extensions/Voting/Extension.pm b/extensions/Voting/Extension.pm
new file mode 100644 (file)
index 0000000..49ab99e
--- /dev/null
+++ b/extensions/Voting/Extension.pm
@@ -0,0 +1,869 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::Extension::Voting;
+use strict;
+use base qw(Bugzilla::Extension);
+
+use Bugzilla::Bug;
+use Bugzilla::BugMail;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Field;
+use Bugzilla::Mailer;
+use Bugzilla::User;
+use Bugzilla::Util qw(detaint_natural);
+use Bugzilla::Token;
+
+use List::Util qw(min);
+
+use constant VERSION => BUGZILLA_VERSION;
+use constant DEFAULT_VOTES_PER_BUG => 1;
+# These came from Bugzilla itself, so they maintain the old numbers
+# they had before.
+use constant CMT_POPULAR_VOTES => 3;
+use constant REL_VOTER => 4;
+
+################
+# Installation #
+################
+
+BEGIN {
+    *Bugzilla::Bug::votes = \&votes;
+}
+
+sub votes {
+    my $self = shift;
+    my $dbh = Bugzilla->dbh;
+
+    return $self->{votes} if exists $self->{votes};
+
+    $self->{votes} = $dbh->selectrow_array('SELECT votes FROM bugs WHERE bug_id = ?',
+                                           undef, $self->id);
+    return $self->{votes};
+}
+
+sub db_schema_abstract_schema {
+    my ($self, $args) = @_;
+    $args->{'schema'}->{'votes'} = {
+        FIELDS => [
+            who        => {TYPE => 'INT3', NOTNULL => 1,
+                           REFERENCES => {TABLE  => 'profiles',
+                                          COLUMN => 'userid',
+                                          DELETE => 'CASCADE'}},
+            bug_id     => {TYPE => 'INT3', NOTNULL => 1,
+                           REFERENCES  => {TABLE  =>  'bugs',
+                                           COLUMN =>  'bug_id',
+                                           DELETE => 'CASCADE'}},
+            vote_count => {TYPE => 'INT2', NOTNULL => 1},
+        ],
+        INDEXES => [
+            votes_who_idx    => ['who'],
+            votes_bug_id_idx => ['bug_id'],
+        ],
+    };
+}
+
+sub install_update_db {
+    my $dbh = Bugzilla->dbh;
+    # Note that before Bugzilla 4.0, voting was a built-in part of Bugzilla,
+    # so updates to the columns for old versions of Bugzilla happen in
+    # Bugzilla::Install::DB, and can't safely be moved to this extension.
+
+    my $field = new Bugzilla::Field({ name => 'votes' });
+    if (!$field) {
+        Bugzilla::Field->create(
+            { name => 'votes', description => 'Votes', buglist => 1 });
+    }
+
+    $dbh->bz_add_column('products', 'votesperuser',
+        {TYPE => 'INT2', NOTNULL => 1, DEFAULT => 0});
+    $dbh->bz_add_column('products', 'maxvotesperbug', 
+        {TYPE => 'INT2', NOTNULL => 1, DEFAULT => DEFAULT_VOTES_PER_BUG});
+    $dbh->bz_add_column('products', 'votestoconfirm',
+        {TYPE => 'INT2', NOTNULL => 1, DEFAULT => 0});
+
+    $dbh->bz_add_column('bugs', 'votes',
+        {TYPE => 'INT3', NOTNULL => 1, DEFAULT => 0});
+    $dbh->bz_add_index('bugs', 'bugs_votes_idx', ['votes']);
+
+    # maxvotesperbug used to default to 10,000, which isn't very sensible.
+    my $per_bug = $dbh->bz_column_info('products', 'maxvotesperbug');
+    if ($per_bug->{DEFAULT} != DEFAULT_VOTES_PER_BUG) {
+        $dbh->bz_alter_column('products', 'maxvotesperbug',
+            {TYPE => 'INT2', NOTNULL => 1, DEFAULT => DEFAULT_VOTES_PER_BUG});
+    }
+}
+
+###########
+# Objects #
+###########
+
+sub object_columns {
+    my ($self, $args) = @_;
+    my ($class, $columns) = @$args{qw(class columns)};
+    if ($class->isa('Bugzilla::Bug')) {
+        push(@$columns, 'votes');
+    }
+    elsif ($class->isa('Bugzilla::Product')) {
+        push(@$columns, qw(votesperuser maxvotesperbug votestoconfirm));
+    }
+}
+
+sub bug_fields {
+    my ($self, $args) = @_;
+    my $fields = $args->{fields};
+    push(@$fields, 'votes');
+}
+
+sub object_update_columns {
+    my ($self, $args) = @_;
+    my ($object, $columns) = @$args{qw(object columns)};
+    if ($object->isa('Bugzilla::Product')) {
+        push(@$columns, qw(votesperuser maxvotesperbug votestoconfirm));
+    }
+}
+
+sub object_validators {
+    my ($self, $args) = @_;
+    my ($class, $validators) = @$args{qw(class validators)};
+    if ($class->isa('Bugzilla::Product')) {
+        $validators->{'votesperuser'}   = \&_check_votesperuser;
+        $validators->{'maxvotesperbug'} = \&_check_maxvotesperbug;
+        $validators->{'votestoconfirm'} = \&_check_votestoconfirm;
+    }
+}
+
+sub object_before_create {
+    my ($self, $args) = @_;
+    my ($class, $params) = @$args{qw(class params)};
+    if ($class->isa('Bugzilla::Bug')) {
+        # Don't ever allow people to directly specify "votes" into the bugs
+        # table.
+        delete $params->{votes};
+    }
+    elsif ($class->isa('Bugzilla::Product')) {
+        my $input = Bugzilla->input_params;
+        $params->{votesperuser}   = $input->{'votesperuser'};
+        $params->{maxvotesperbug} = $input->{'maxvotesperbug'};
+        $params->{votestoconfirm} = $input->{'votestoconfirm'};
+    }
+}
+
+sub object_end_of_set_all {
+    my ($self, $args) = @_;
+    my ($object) = $args->{object};
+    if ($object->isa('Bugzilla::Product')) {
+        my $input = Bugzilla->input_params;
+        $object->set('votesperuser',   $input->{'votesperuser'});
+        $object->set('maxvotesperbug', $input->{'maxvotesperbug'});
+        $object->set('votestoconfirm', $input->{'votestoconfirm'});
+    }
+}
+
+sub object_end_of_update {
+    my ($self, $args) = @_;
+    my ($object, $changes) = @$args{qw(object changes)};
+    if ( $object->isa('Bugzilla::Product')
+         and ($changes->{maxvotesperbug} or $changes->{votesperuser} 
+              or $changes->{votestoconfirm}) ) 
+    {
+        _modify_bug_votes($object, $changes);
+    }
+}
+
+sub bug_end_of_update {
+    my ($self, $args) = @_;
+    my ($bug, $changes) = @$args{qw(bug changes)};
+
+    if ($changes->{'product'}) {
+        my @msgs;
+        # If some votes have been removed, RemoveVotes() returns
+        # a list of messages to send to voters.
+        @msgs = _remove_votes($bug->id, 0, 'votes_bug_moved');
+        _confirm_if_vote_confirmed($bug->id);
+
+        foreach my $msg (@msgs) {
+            MessageToMTA($msg);
+        }
+    }
+}
+
+#############
+# Templates #
+#############
+
+sub template_before_create {
+    my ($self, $args) = @_;
+    my $config = $args->{config};
+    my $constants = $config->{CONSTANTS};
+    $constants->{REL_VOTER} = REL_VOTER;
+    $constants->{CMT_POPULAR_VOTES} = CMT_POPULAR_VOTES;
+    $constants->{DEFAULT_VOTES_PER_BUG} = DEFAULT_VOTES_PER_BUG;
+}
+
+
+sub template_before_process {
+    my ($self, $args) = @_;
+    my ($vars, $file) = @$args{qw(vars file)};
+    if ($file eq 'admin/users/confirm-delete.html.tmpl') {
+        my $who = $vars->{otheruser};
+        my $votes = Bugzilla->dbh->selectrow_array(
+            'SELECT COUNT(*) FROM votes WHERE who = ?', undef, $who->id);
+        if ($votes) {
+            $vars->{other_safe} = 1;
+            $vars->{votes} = $votes;
+        }
+    }
+}
+
+###########
+# Bugmail #
+###########
+
+sub bugmail_recipients {
+    my ($self, $args) = @_;
+    my ($bug, $recipients) = @$args{qw(bug recipients)};
+    my $dbh = Bugzilla->dbh;
+
+    my $voters = $dbh->selectcol_arrayref(
+        "SELECT who FROM votes WHERE bug_id = ?", undef, $bug->id);
+    $recipients->{$_}->{+REL_VOTER} = 1 foreach (@$voters);
+}
+
+sub bugmail_relationships {
+    my ($self, $args) = @_;
+    my $relationships = $args->{relationships};
+    $relationships->{+REL_VOTER} = 'Voter';
+}
+
+###############
+# Sanitycheck #
+###############
+
+sub sanitycheck_check {
+    my ($self, $args) = @_;
+    my $status = $args->{status};
+
+    # Vote Cache
+    $status->('voting_count_start');
+    my $dbh = Bugzilla->dbh;
+    my %cached_counts = @{ $dbh->selectcol_arrayref(
+        'SELECT bug_id, votes FROM bugs', {Columns=>[1,2]}) };
+
+    my %real_counts = @{ $dbh->selectcol_arrayref(
+        'SELECT bug_id, SUM(vote_count) FROM votes '
+        . $dbh->sql_group_by('bug_id'), {Columns=>[1,2]}) };
+
+    my $needs_rebuild;
+    foreach my $id (keys %cached_counts) {
+        my $cached_count = $cached_counts{$id};
+        my $real_count = $real_counts{$id} || 0;
+        if ($cached_count < 0) {
+            $status->('voting_count_alert', { id => $id }, 'alert');
+        }
+        elsif ($cached_count != $real_count) {
+            $status->('voting_cache_alert', { id => $id }, 'alert');
+            $needs_rebuild = 1;
+        }
+    }
+
+    $status->('voting_cache_rebuild_fix') if $needs_rebuild;
+}
+
+sub sanitycheck_repair {
+    my ($self, $args) = @_;
+    my $status = $args->{status};
+    my $input = Bugzilla->input_params;
+    my $dbh = Bugzilla->dbh;
+
+    return if !$input->{rebuild_vote_cache};
+
+    $status->('voting_cache_rebuild_start');
+    $dbh->bz_start_transaction();
+    $dbh->do('UPDATE bugs SET votes = 0');
+
+    my $sth = $dbh->prepare(
+        'SELECT bug_id, SUM(vote_count) FROM votes '
+        . $dbh->sql_group_by('bug_id'));
+    $sth->execute();
+
+    my $sth_update = $dbh->prepare(
+        'UPDATE bugs SET votes = ? WHERE bug_id = ?');
+    while (my ($id, $count) = $sth->fetchrow_array) {
+        $sth_update->execute($count, $id);
+    }
+    $dbh->bz_commit_transaction();
+    $status->('voting_cache_rebuild_end');
+}
+
+
+##############
+# Validators #
+##############
+
+sub _check_votesperuser {
+    return _check_votes(0, @_);
+}
+
+sub _check_maxvotesperbug {
+    return _check_votes(DEFAULT_VOTES_PER_BUG, @_);
+}
+
+sub _check_votestoconfirm {
+    return _check_votes(0, @_);
+}
+
+# This subroutine is only used internally by other _check_votes_* validators.
+sub _check_votes {
+    my ($default, $invocant, $votes, $field) = @_;
+
+    detaint_natural($votes) if defined $votes;
+    # On product creation, if the number of votes is not a valid integer,
+    # we silently fall back to the given default value.
+    # If the product already exists and the change is illegal, we complain.
+    if (!defined $votes) {
+        if (ref $invocant) {
+            ThrowUserError('voting_product_illegal_votes',
+                           { field => $field, votes => $_[2] });
+        }
+        else {
+            $votes = $default;
+        }
+    }
+    return $votes;
+}
+
+#########
+# Pages #
+#########
+
+sub page_before_template {
+    my ($self, $args) = @_;
+    my $page = $args->{page_id};
+    my $vars = $args->{vars};
+
+    if ($page =~ m{^voting/bug\.}) {
+        _page_bug($vars);
+    }
+    elsif ($page =~ m{^voting/user\.}) {
+        _page_user($vars);
+    }
+}
+
+sub _page_bug {
+    my ($vars) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $input = Bugzilla->input_params;
+
+    my $bug_id = $input->{bug_id};
+    my $bug = Bugzilla::Bug->check($bug_id);
+
+    $vars->{'bug'} = $bug;
+    $vars->{'users'} =
+        $dbh->selectall_arrayref('SELECT profiles.login_name,
+                                         profiles.userid AS id,
+                                         votes.vote_count
+                                    FROM votes
+                              INNER JOIN profiles
+                                      ON profiles.userid = votes.who
+                                   WHERE votes.bug_id = ?',
+                                  {Slice=>{}}, $bug->id);
+}
+
+sub _page_user {
+    my ($vars) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $user = Bugzilla->user;
+    my $input = Bugzilla->input_params;
+
+    my $action = $input->{action};
+    if ($action and $action eq 'vote') {
+        _update_votes($vars);
+    }
+
+    # If a bug_id is given, and we're editing, we'll add it to the votes list.
+    
+    my $bug_id = $input->{bug_id};
+    my $bug = Bugzilla::Bug->check($bug_id) if $bug_id;
+    my $who_id = $input->{user_id} || $user->id;
+
+    # Logged-out users must specify a user_id.
+    Bugzilla->login(LOGIN_REQUIRED) if !$who_id;
+
+    my $who = Bugzilla::User->check({ id => $who_id });
+
+    my $canedit = $user->id == $who->id;
+
+    $dbh->bz_start_transaction();
+
+    if ($canedit && $bug) {
+        # Make sure there is an entry for this bug
+        # in the vote table, just so that things display right.
+        my $has_votes = $dbh->selectrow_array('SELECT vote_count FROM votes 
+                                               WHERE bug_id = ? AND who = ?',
+                                               undef, ($bug->id, $who->id));
+        if (!$has_votes) {
+            $dbh->do('INSERT INTO votes (who, bug_id, vote_count) 
+                      VALUES (?, ?, 0)', undef, ($who->id, $bug->id));
+        }
+    }
+
+    my (@products, @all_bug_ids);
+    # Read the votes data for this user for each product.
+    foreach my $product (@{ $user->get_selectable_products }) {
+        next unless ($product->{votesperuser} > 0);
+
+        my @bugs;
+        my @bug_ids;
+        my $total = 0;
+        my $onevoteonly = 0;
+
+        my $vote_list =
+            $dbh->selectall_arrayref('SELECT votes.bug_id, votes.vote_count,
+                                             bugs.short_desc
+                                        FROM votes
+                                  INNER JOIN bugs
+                                          ON votes.bug_id = bugs.bug_id
+                                       WHERE votes.who = ?
+                                         AND bugs.product_id = ?
+                                    ORDER BY votes.bug_id',
+                                      undef, ($who->id, $product->id));
+
+        $user->visible_bugs([map { $_->[0] } @$vote_list]);
+        foreach (@$vote_list) {
+            my ($id, $count, $summary) = @$_;
+            $total += $count;
+
+            # Next if user can't see this bug. So, the totals will be correct
+            # and they can see there are votes 'missing', but not on what bug
+            # they are. This seems a reasonable compromise; the alternative is
+            # to lie in the totals.
+            next if !$user->can_see_bug($id);
+
+            push (@bugs, { id => $id,
+                           summary => $summary,
+                           count => $count });
+            push (@bug_ids, $id);
+            push (@all_bug_ids, $id);
+        }
+
+        $onevoteonly = 1 if (min($product->{votesperuser},
+                                 $product->{maxvotesperbug}) == 1);
+
+        # Only add the product for display if there are any bugs in it.
+        if ($#bugs > -1) {
+            push (@products, { name => $product->name,
+                               bugs => \@bugs,
+                               bug_ids => \@bug_ids,
+                               onevoteonly => $onevoteonly,
+                               total => $total,
+                               maxvotes => $product->{votesperuser},
+                               maxperbug => $product->{maxvotesperbug} });
+        }
+    }
+
+    if ($canedit && $bug) {
+        $dbh->do('DELETE FROM votes WHERE vote_count = 0 AND who = ?',
+                 undef, $who->id);
+    }
+    $dbh->bz_commit_transaction();
+
+    $vars->{'canedit'} = $canedit;
+    $vars->{'voting_user'} = { "login" => $who->name };
+    $vars->{'products'} = \@products;
+    $vars->{'this_bug'} = $bug;
+    $vars->{'all_bug_ids'} = \@all_bug_ids;
+}
+
+sub _update_votes {
+    my ($vars) = @_;
+
+    ############################################################################
+    # Begin Data/Security Validation
+    ############################################################################
+
+    my $cgi = Bugzilla->cgi;
+    my $dbh = Bugzilla->dbh;
+    my $template = Bugzilla->template;
+    my $user = Bugzilla->login(LOGIN_REQUIRED);
+    my $input = Bugzilla->input_params;
+
+    # Build a list of bug IDs for which votes have been submitted.  Votes
+    # are submitted in form fields in which the field names are the bug 
+    # IDs and the field values are the number of votes.
+
+    my @buglist = grep {/^\d+$/} keys %$input;
+
+    # If no bugs are in the buglist, let's make sure the user gets notified
+    # that their votes will get nuked if they continue.
+    if (scalar(@buglist) == 0) {
+        if (!defined $cgi->param('delete_all_votes')) {
+            print $cgi->header();
+            $template->process("voting/delete-all.html.tmpl", $vars)
+              || ThrowTemplateError($template->error());
+            exit;
+        }
+        elsif ($cgi->param('delete_all_votes') == 0) {
+            print $cgi->redirect("page.cgi?id=voting/user.html");
+            exit;
+        }
+    }
+
+    # Call check() on each bug ID to make sure it is a positive
+    # integer representing an existing bug that the user is authorized 
+    # to access, and make sure the number of votes submitted is also
+    # a non-negative integer (a series of digits not preceded by a
+    # minus sign).
+    my (%votes, @bugs);
+    foreach my $id (@buglist) {
+      my $bug = Bugzilla::Bug->check($id);
+      push(@bugs, $bug);
+      $id = $bug->id;
+      $votes{$id} = $input->{$id};
+      detaint_natural($votes{$id})
+        || ThrowUserError("voting_must_be_nonnegative");
+    }
+
+    my $token = $cgi->param('token');
+    check_hash_token($token, ['vote']);
+
+    ############################################################################
+    # End Data/Security Validation
+    ############################################################################
+    my $who = $user->id;
+
+    # If the user is voting for bugs, make sure they aren't overstuffing
+    # the ballot box.
+    if (scalar @bugs) {
+        my (%prodcount, %products);
+        foreach my $bug (@bugs) {
+            my $bug_id = $bug->id;
+            my $prod = $bug->product;
+            $products{$prod} ||= $bug->product_obj;
+            $prodcount{$prod} ||= 0;
+            $prodcount{$prod} += $votes{$bug_id};
+
+            # Make sure we haven't broken the votes-per-bug limit
+            ($votes{$bug_id} <= $products{$prod}->{maxvotesperbug})
+              || ThrowUserError("voting_too_many_votes_for_bug",
+                                {max => $products{$prod}->{maxvotesperbug},
+                                 product => $prod,
+                                 votes => $votes{$bug_id}});
+        }
+
+        # Make sure we haven't broken the votes-per-product limit
+        foreach my $prod (keys(%prodcount)) {
+            ($prodcount{$prod} <= $products{$prod}->{votesperuser})
+              || ThrowUserError("voting_too_many_votes_for_product",
+                                {max => $products{$prod}->{votesperuser},
+                                 product => $prod,
+                                 votes => $prodcount{$prod}});
+        }
+    }
+
+    # Update the user's votes in the database.  If the user did not submit 
+    # any votes, they may be using a form with checkboxes to remove all their
+    # votes (checkboxes are not submitted along with other form data when
+    # they are not checked, and Bugzilla uses them to represent single votes
+    # for products that only allow one vote per bug).  In that case, we still
+    # need to clear the user's votes from the database.
+    my %affected;
+    $dbh->bz_start_transaction();
+
+    # Take note of, and delete the user's old votes from the database.
+    my $bug_list = $dbh->selectcol_arrayref('SELECT bug_id FROM votes
+                                             WHERE who = ?', undef, $who);
+
+    foreach my $id (@$bug_list) {
+        $affected{$id} = 1;
+    }
+    $dbh->do('DELETE FROM votes WHERE who = ?', undef, $who);
+
+    my $sth_insertVotes = $dbh->prepare('INSERT INTO votes (who, bug_id, vote_count)
+                                         VALUES (?, ?, ?)');
+
+    # Insert the new values in their place
+    foreach my $id (@buglist) {
+        if ($votes{$id} > 0) {
+            $sth_insertVotes->execute($who, $id, $votes{$id});
+        }
+        $affected{$id} = 1;
+    }
+
+    # Update the cached values in the bugs table
+    print $cgi->header();
+    my @updated_bugs = ();
+
+    my $sth_getVotes = $dbh->prepare("SELECT SUM(vote_count) FROM votes
+                                      WHERE bug_id = ?");
+
+    my $sth_updateVotes = $dbh->prepare("UPDATE bugs SET votes = ?
+                                         WHERE bug_id = ?");
+
+    foreach my $id (keys %affected) {
+        $sth_getVotes->execute($id);
+        my $v = $sth_getVotes->fetchrow_array || 0;
+        $sth_updateVotes->execute($v, $id);
+
+        my $confirmed = _confirm_if_vote_confirmed($id);
+        push (@updated_bugs, $id) if $confirmed;
+    }
+
+    $dbh->bz_commit_transaction();
+
+    $vars->{'type'} = "votes";
+    $vars->{'title_tag'} = 'change_votes';
+    foreach my $bug_id (@updated_bugs) {
+        $vars->{'id'} = $bug_id;
+        $vars->{'sent_bugmail'} = 
+            Bugzilla::BugMail::Send($bug_id, { 'changer' => $user });
+        
+        $template->process("bug/process/results.html.tmpl", $vars)
+          || ThrowTemplateError($template->error());
+        # Set header_done to 1 only after the first bug.
+        $vars->{'header_done'} = 1;
+    }
+    $vars->{'votes_recorded'} = 1;
+}
+
+######################
+# Helper Subroutines #
+######################
+
+sub _modify_bug_votes {
+    my ($product, $changes) = @_;
+    my $dbh = Bugzilla->dbh;
+    my @msgs;
+
+    # 1. too many votes for a single user on a single bug.
+    my @toomanyvotes_list;
+    if ($product->{maxvotesperbug} < $product->{votesperuser}) {
+        my $votes = $dbh->selectall_arrayref(
+            'SELECT votes.who, votes.bug_id
+               FROM votes
+                    INNER JOIN bugs ON bugs.bug_id = votes.bug_id
+              WHERE bugs.product_id = ?
+                    AND votes.vote_count > ?',
+            undef, ($product->id, $product->{maxvotesperbug}));
+
+        foreach my $vote (@$votes) {
+            my ($who, $id) = (@$vote);
+            # If some votes are removed, _remove_votes() returns a list
+            # of messages to send to voters.
+            push(@msgs, _remove_votes($id, $who, 'votes_too_many_per_bug'));
+            my $name = user_id_to_login($who);
+
+            push(@toomanyvotes_list, {id => $id, name => $name});
+        }
+    }
+
+    $changes->{'_too_many_votes'} = \@toomanyvotes_list;
+
+    # 2. too many total votes for a single user.
+    # This part doesn't work in the general case because _remove_votes
+    # doesn't enforce votesperuser (except per-bug when it's less
+    # than maxvotesperbug).  See _remove_votes().
+
+    my $votes = $dbh->selectall_arrayref(
+        'SELECT votes.who, votes.vote_count
+           FROM votes
+                INNER JOIN bugs ON bugs.bug_id = votes.bug_id
+          WHERE bugs.product_id = ?',
+         undef, $product->id);
+
+    my %counts;
+    foreach my $vote (@$votes) {
+        my ($who, $count) = @$vote;
+        if (!defined $counts{$who}) {
+            $counts{$who} = $count;
+        } else {
+            $counts{$who} += $count;
+        }
+    }
+
+    my @toomanytotalvotes_list;
+    foreach my $who (keys(%counts)) {
+        if ($counts{$who} > $product->{votesperuser}) {
+            my $bug_ids = $dbh->selectcol_arrayref(
+                'SELECT votes.bug_id
+                   FROM votes
+                        INNER JOIN bugs ON bugs.bug_id = votes.bug_id
+                  WHERE bugs.product_id = ?
+                        AND votes.who = ?',
+                undef, $product->id, $who);
+
+            foreach my $bug_id (@$bug_ids) {
+                # _remove_votes returns a list of messages to send
+                # in case some voters had too many votes.
+                push(@msgs, _remove_votes($bug_id, $who, 
+                                          'votes_too_many_per_user'));
+                my $name = user_id_to_login($who);
+
+                push(@toomanytotalvotes_list, {id => $bug_id, name => $name});
+            }
+        }
+    }
+
+    $changes->{'_too_many_total_votes'} = \@toomanytotalvotes_list;
+
+    # 3. enough votes to confirm
+    my $bug_list = $dbh->selectcol_arrayref(
+        'SELECT bug_id FROM bugs 
+          WHERE product_id = ? AND bug_status = ? AND votes >= ?',
+        undef, ($product->id, 'UNCONFIRMED', $product->{votestoconfirm}));
+
+    my @updated_bugs;
+    foreach my $bug_id (@$bug_list) {
+        my $confirmed = _confirm_if_vote_confirmed($bug_id);
+        push (@updated_bugs, $bug_id) if $confirmed;
+    }
+    $changes->{'_confirmed_bugs'} = \@updated_bugs;
+
+    # Now that changes are done, we can send emails to voters.
+    foreach my $msg (@msgs) {
+        MessageToMTA($msg);
+    }
+    # And send out emails about changed bugs
+    foreach my $bug_id (@updated_bugs) {
+        my $sent_bugmail = Bugzilla::BugMail::Send(
+            $bug_id, { changer => Bugzilla->user });
+        $changes->{'_confirmed_bugs_sent_bugmail'}->{$bug_id} = $sent_bugmail;
+    }
+}
+
+# If a bug is moved to a product which allows less votes per bug
+# compared to the previous product, extra votes need to be removed.
+sub _remove_votes {
+    my ($id, $who, $reason) = (@_);
+    my $dbh = Bugzilla->dbh;
+
+    my $whopart = ($who) ? " AND votes.who = $who" : "";
+
+    my $sth = $dbh->prepare("SELECT profiles.login_name, " .
+                            "profiles.userid, votes.vote_count, " .
+                            "products.votesperuser, products.maxvotesperbug " .
+                            "FROM profiles " .
+                            "LEFT JOIN votes ON profiles.userid = votes.who " .
+                            "LEFT JOIN bugs ON votes.bug_id = bugs.bug_id " .
+                            "LEFT JOIN products ON products.id = bugs.product_id " .
+                            "WHERE votes.bug_id = ? " . $whopart);
+    $sth->execute($id);
+    my @list;
+    while (my ($name, $userid, $oldvotes, $votesperuser, $maxvotesperbug) = $sth->fetchrow_array()) {
+        push(@list, [$name, $userid, $oldvotes, $votesperuser, $maxvotesperbug]);
+    }
+
+    # @messages stores all emails which have to be sent, if any.
+    # This array is passed to the caller which will send these emails itself.
+    my @messages = ();
+
+    if (scalar(@list)) {
+        foreach my $ref (@list) {
+            my ($name, $userid, $oldvotes, $votesperuser, $maxvotesperbug) = (@$ref);
+
+            $maxvotesperbug = min($votesperuser, $maxvotesperbug);
+
+            # If this product allows voting and the user's votes are in
+            # the acceptable range, then don't do anything.
+            next if $votesperuser && $oldvotes <= $maxvotesperbug;
+
+            # If the user has more votes on this bug than this product
+            # allows, then reduce the number of votes so it fits
+            my $newvotes = $maxvotesperbug;
+
+            my $removedvotes = $oldvotes - $newvotes;
+
+            if ($newvotes) {
+                $dbh->do("UPDATE votes SET vote_count = ? " .
+                         "WHERE bug_id = ? AND who = ?",
+                         undef, ($newvotes, $id, $userid));
+            } else {
+                $dbh->do("DELETE FROM votes WHERE bug_id = ? AND who = ?",
+                         undef, ($id, $userid));
+            }
+
+            # Notice that we did not make sure that the user fit within the $votesperuser
+            # range.  This is considered to be an acceptable alternative to losing votes
+            # during product moves.  Then next time the user attempts to change their votes,
+            # they will be forced to fit within the $votesperuser limit.
+
+            # Now lets send the e-mail to alert the user to the fact that their votes have
+            # been reduced or removed.
+            my $vars = {
+                'to' => $name . Bugzilla->params->{'emailsuffix'},
+                'bugid' => $id,
+                'reason' => $reason,
+
+                'votesremoved' => $removedvotes,
+                'votesold' => $oldvotes,
+                'votesnew' => $newvotes,
+            };
+
+            my $voter = new Bugzilla::User($userid);
+            my $template = Bugzilla->template_inner($voter->setting('lang'));
+
+            my $msg;
+            $template->process("voting/votes-removed.txt.tmpl", $vars, \$msg);
+            push(@messages, $msg);
+        }
+
+        my $votes = $dbh->selectrow_array("SELECT SUM(vote_count) " .
+                                          "FROM votes WHERE bug_id = ?",
+                                          undef, $id) || 0;
+        $dbh->do("UPDATE bugs SET votes = ? WHERE bug_id = ?",
+                 undef, ($votes, $id));
+    }
+    # Now return the array containing emails to be sent.
+    return @messages;
+}
+
+# If a user votes for a bug, or the number of votes required to
+# confirm a bug has been reduced, check if the bug is now confirmed.
+sub _confirm_if_vote_confirmed {
+    my $id = shift;
+    my $bug = new Bugzilla::Bug($id);
+
+    my $ret = 0;
+    if (!$bug->everconfirmed
+        and $bug->product_obj->{votestoconfirm}
+        and $bug->votes >= $bug->product_obj->{votestoconfirm})
+    {
+        $bug->add_comment('', { type => CMT_POPULAR_VOTES });
+
+        if ($bug->bug_status eq 'UNCONFIRMED') {
+            # Get a valid open state.
+            my $new_status;
+            foreach my $state (@{$bug->status->can_change_to}) {
+                if ($state->is_open && $state->name ne 'UNCONFIRMED') {
+                    $new_status = $state->name;
+                    last;
+                }
+            }
+            ThrowCodeError('voting_no_open_bug_status') unless $new_status;
+
+            # We cannot call $bug->set_bug_status() here, because a user without
+            # canconfirm privs should still be able to confirm a bug by
+            # popular vote. We already know the new status is valid, so it's safe.
+            $bug->{bug_status} = $new_status;
+            $bug->{everconfirmed} = 1;
+            delete $bug->{'status'}; # Contains the status object.
+        }
+        else {
+            # If the bug is in a closed state, only set everconfirmed to 1.
+            # Do not call $bug->_set_everconfirmed(), for the same reason as above.
+            $bug->{everconfirmed} = 1;
+        }
+        $bug->update();
+
+        $ret = 1;
+    }
+    return $ret;
+}
+
+
+__PACKAGE__->NAME;

diff --git a/extensions/Voting/disabled b/extensions/Voting/disabled
new file mode 100644 (file)
index 0000000..e69de29

diff --git a/extensions/Voting/template/en/default/hook/account/prefs/email-relationships.html.tmpl b/extensions/Voting/template/en/default/hook/account/prefs/email-relationships.html.tmpl
new file mode 100644 (file)
index 0000000..846d742
--- /dev/null
+++ b/extensions/Voting/template/en/default/hook/account/prefs/email-relationships.html.tmpl
@@ -0,0 +1,10 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% relationships.push({ id = constants.REL_VOTER, description = "Voter" }) %]
+[% no_added_removed.push(constants.REL_VOTER) %]

diff --git a/extensions/Voting/template/en/default/hook/admin/products/edit-common-rows.html.tmpl b/extensions/Voting/template/en/default/hook/admin/products/edit-common-rows.html.tmpl
new file mode 100644 (file)
index 0000000..9a8373b
--- /dev/null
+++ b/extensions/Voting/template/en/default/hook/admin/products/edit-common-rows.html.tmpl
@@ -0,0 +1,47 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% DEFAULT 
+  product.maxvotesperbug = constants.DEFAULT_VOTES_PER_BUG
+  product.votesperuser = 0
+  product.votestoconfirm = 0
+%]
+  
+<tr>
+  <th align="right">Maximum votes per person:</th>
+  <td><input size="5" maxlength="5" name="votesperuser" id="votesperuser"
+             value="[% product.votesperuser FILTER html %]">
+  </td>
+</tr>
+
+<tr>
+  <th align="right">
+    Maximum votes a person can put on a single [% terms.bug %]:
+  </th>
+  <td><input size="5" maxlength="5" name="maxvotesperbug" id="maxvotesperbug"
+             value="[% product.maxvotesperbug FILTER html %]">
+  </td>
+</tr>
+
+<tr id="votes_to_confirm_container"
+    [%- ' class="bz_default_hidden"' IF !product.allows_unconfirmed %]>
+  <th align="right">
+    Confirm [% terms.abug %] if it gets this many votes:
+  </th>
+  <td>
+    <input size="3" maxlength="5" name="votestoconfirm" id="votestoconfirm"
+           value="[% product.votestoconfirm FILTER html %]">
+    <br>(Setting this to 0 disables auto-confirming [% terms.bugs %]
+    by vote.)
+    <script type="text/javascript">
+        YAHOO.util.Event.addListener('allows_unconfirmed', 'change',
+            function() { bz_toggleClass('votes_to_confirm_container',
+                                        'bz_default_hidden'); });
+    </script>
+  </td>
+</tr>

diff --git a/extensions/Voting/template/en/default/hook/admin/products/updated-changes.html.tmpl b/extensions/Voting/template/en/default/hook/admin/products/updated-changes.html.tmpl
new file mode 100644 (file)
index 0000000..64db63d
--- /dev/null
+++ b/extensions/Voting/template/en/default/hook/admin/products/updated-changes.html.tmpl
@@ -0,0 +1,90 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% SET checkvotes = 0 %]
+
+[% IF changes.votesperuser.defined %]
+  <p>
+  Updated votes per user from
+  [%+ changes.votesperuser.0 FILTER html %] to
+  [%+ product.votesperuser FILTER html %].
+  </p>
+  [% checkvotes = 1 %]
+[% END %]
+
+[% IF changes.maxvotesperbug.defined %]
+  <p>
+  Updated maximum votes per [% terms.bug %] from
+  [%+ changes.maxvotesperbug.0 FILTER html %] to
+  [%+ product.maxvotesperbug FILTER html %].
+  </p>
+  [% checkvotes = 1 %]
+[% END %]
+
+[% IF changes.votestoconfirm.defined %]
+  <p>
+  Updated number of votes needed to confirm a [% terms.bug %] from
+  [%+ changes.votestoconfirm.0 FILTER html %] to
+  [%+ product.votestoconfirm FILTER html %].
+  </p>
+  [% checkvotes = 1 %]
+[% END %]
+
+[%# Note that this display of changed votes and/or confirmed bugs is
+    not very scalable. We could have a _lot_, and we just list them all.
+    One day we should limit this perhaps, or have a more scalable display %]
+
+[% IF checkvotes %]
+  <hr>
+
+  <p>Checking existing votes in this product for anybody who now
+  has too many votes for [% terms.abug %]...<br>
+  [% IF changes._too_many_votes.size %]
+    [% FOREACH detail = changes._too_many_votes %]
+      &rarr;removed votes for [% terms.bug %] <a href="show_bug.cgi?id=
+     [%- detail.id FILTER uri %]">
+     [%- detail.id FILTER html %]</a> from [% detail.name FILTER html %]<br>
+    [% END %]
+  [% ELSE %]
+    &rarr;there were none.
+  [% END %]
+  </p>
+
+  <p>Checking existing votes in this product for anybody
+  who now has too many total votes...<br>
+  [% IF changes._too_many_total_votes.size %]
+    [% FOREACH detail = changes._too_many_total_votes %]
+      &rarr;removed votes for [% terms.bug %] <a href="show_bug.cgi?id=
+     [%- detail.id FILTER uri %]">
+     [%- detail.id FILTER html %]</a> from [% detail.name FILTER html %]<br>
+    [% END %]
+  [% ELSE %]
+    &rarr;there were none.
+  [% END %]
+  </p>
+
+  <p>Checking unconfirmed [% terms.bugs %] in this product for any which now have
+  sufficient votes...<br>
+  [% IF changes._confirmed_bugs.size %]
+    [% FOREACH id = changes._confirmed_bugs %]
+
+      [%# This is INCLUDED instead of PROCESSED to avoid variables getting
+          overwritten, which happens otherwise %]
+      [% INCLUDE bug/process/results.html.tmpl
+        type = 'votes'
+        header_done = 1
+        sent_bugmail = changes._confirmed_bugs_sent_bugmail.$id
+        id = id
+      %]
+    [% END %]
+  [% ELSE %]
+    &rarr;there were none.
+  [% END %]
+  </p>
+
+[% END %]

diff --git a/extensions/Voting/template/en/default/hook/admin/sanitycheck/messages-statuses.html.tmpl b/extensions/Voting/template/en/default/hook/admin/sanitycheck/messages-statuses.html.tmpl
new file mode 100644 (file)
index 0000000..926fead
--- /dev/null
+++ b/extensions/Voting/template/en/default/hook/admin/sanitycheck/messages-statuses.html.tmpl
@@ -0,0 +1,29 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% IF san_tag == "voting_cache_rebuild_fix" %]
+    <a href="sanitycheck.cgi?rebuild_vote_cache=1&amp;token=
+       [%- issue_hash_token(['sanitycheck']) FILTER uri %]">Click here to
+    rebuild the vote cache</a>
+
+[% ELSIF san_tag == "voting_cache_alert" %]
+    Bad vote cache for [% PROCESS bug_link bug_id = id %]
+
+[% ELSIF san_tag == "voting_count_start" %]
+    Checking cached vote counts.
+
+[% ELSIF san_tag == "voting_count_alert" %]
+    Bad vote sum for [% terms.bug %] [%+ id FILTER html %].
+
+[% ELSIF san_tag == "voting_cache_rebuild_start" %]
+    OK, now rebuilding vote cache.
+
+[% ELSIF san_tag == "voting_cache_rebuild_end" %]
+    Vote cache has been rebuilt
+
+[% END %]

diff --git a/extensions/Voting/template/en/default/hook/admin/users/confirm-delete-warn_safe.html.tmpl b/extensions/Voting/template/en/default/hook/admin/users/confirm-delete-warn_safe.html.tmpl
new file mode 100644 (file)
index 0000000..b971dac
--- /dev/null
+++ b/extensions/Voting/template/en/default/hook/admin/users/confirm-delete-warn_safe.html.tmpl
@@ -0,0 +1,26 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% IF votes %]
+  <li>
+    [% otheruser.login FILTER html %] has voted on
+    [% IF votes == 1 %]
+      [%+ terms.abug %]
+    [% ELSE %]
+      [%+ votes FILTER html %] [%+ terms.bugs %]
+    [% END %].
+
+    If you delete the user account,
+    [% IF votes == 1 %]
+      this vote
+    [% ELSE %]
+      these votes
+    [% END %]
+    will be deleted along with the user account.
+  </li>
+[% END %]

diff --git a/extensions/Voting/template/en/default/hook/bug/edit-after_importance.html.tmpl b/extensions/Voting/template/en/default/hook/bug/edit-after_importance.html.tmpl
new file mode 100644 (file)
index 0000000..6710ab3
--- /dev/null
+++ b/extensions/Voting/template/en/default/hook/bug/edit-after_importance.html.tmpl
@@ -0,0 +1,25 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[% IF bug.product_obj.votesperuser %]
+  <span id="votes_container">
+    [% IF bug.votes %]
+      with
+      <a href="page.cgi?id=voting/bug.html&amp;bug_id=
+               [%- bug.id FILTER uri %]">
+        [%- bug.votes FILTER html %] 
+        [% IF bug.votes == 1 %]
+            vote
+        [% ELSE %]
+            votes
+        [% END %]</a>
+    [% END %]
+    (<a href="page.cgi?id=voting/user.html&amp;bug_id=
+              [%- bug.id FILTER uri %]#vote_
+              [%- bug.id FILTER uri %]">vote</a>)
+  </span>
+[% END %]

diff --git a/extensions/Voting/template/en/default/hook/bug/format_comment-type.txt.tmpl b/extensions/Voting/template/en/default/hook/bug/format_comment-type.txt.tmpl
new file mode 100644 (file)
index 0000000..64d3f65
--- /dev/null
+++ b/extensions/Voting/template/en/default/hook/bug/format_comment-type.txt.tmpl
@@ -0,0 +1,11 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% IF comment.type == constants.CMT_POPULAR_VOTES %]
+*** This [% terms.bug %] has been confirmed by popular vote. ***
+[% END %]

diff --git a/extensions/Voting/template/en/default/hook/bug/process/header-title.html.tmpl b/extensions/Voting/template/en/default/hook/bug/process/header-title.html.tmpl
new file mode 100644 (file)
index 0000000..200fe4b
--- /dev/null
+++ b/extensions/Voting/template/en/default/hook/bug/process/header-title.html.tmpl
@@ -0,0 +1,11 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% IF title_tag == "change_votes" %]
+  [% title = "Change Votes" %]
+[% END %]

diff --git a/extensions/Voting/template/en/default/hook/bug/process/results-title.html.tmpl b/extensions/Voting/template/en/default/hook/bug/process/results-title.html.tmpl
new file mode 100644 (file)
index 0000000..86e48de
--- /dev/null
+++ b/extensions/Voting/template/en/default/hook/bug/process/results-title.html.tmpl
@@ -0,0 +1,9 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% title.votes = "$Link confirmed by number of votes" %]

diff --git a/extensions/Voting/template/en/default/hook/bug/show-header-end.html.tmpl b/extensions/Voting/template/en/default/hook/bug/show-header-end.html.tmpl
new file mode 100644 (file)
index 0000000..92b373d
--- /dev/null
+++ b/extensions/Voting/template/en/default/hook/bug/show-header-end.html.tmpl
@@ -0,0 +1,9 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% style_urls.push('extensions/Voting/web/style.css') %]

diff --git a/extensions/Voting/template/en/default/hook/global/code-error-errors.html.tmpl b/extensions/Voting/template/en/default/hook/global/code-error-errors.html.tmpl
new file mode 100644 (file)
index 0000000..81d9fff
--- /dev/null
+++ b/extensions/Voting/template/en/default/hook/global/code-error-errors.html.tmpl
@@ -0,0 +1,13 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% IF error == "voting_no_open_bug_status" %]
+    [% title = "$terms.Bug Cannot Be Confirmed" %]
+    There is no valid transition from
+    [%+ display_value("bug_status", "UNCONFIRMED") FILTER html %] to an open state
+[% END %]

diff --git a/extensions/Voting/template/en/default/hook/global/field-descs-end.none.tmpl b/extensions/Voting/template/en/default/hook/global/field-descs-end.none.tmpl
new file mode 100644 (file)
index 0000000..33e8ac7
--- /dev/null
+++ b/extensions/Voting/template/en/default/hook/global/field-descs-end.none.tmpl
@@ -0,0 +1,11 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% IF in_template_var %]
+  [% vars.field_descs.votes = "Votes" %]
+[% END %]

diff --git a/extensions/Voting/template/en/default/hook/global/reason-descs-end.none.tmpl b/extensions/Voting/template/en/default/hook/global/reason-descs-end.none.tmpl
new file mode 100644 (file)
index 0000000..28a1e36
--- /dev/null
+++ b/extensions/Voting/template/en/default/hook/global/reason-descs-end.none.tmpl
@@ -0,0 +1,11 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% reason_descs.${constants.REL_VOTER} = "You voted for the ${terms.bug}." %]
+[% watch_reason_descs.${constants.REL_VOTER} = 
+  "You are watching a voter for the ${terms.bug}." %]

diff --git a/extensions/Voting/template/en/default/hook/global/user-error-errors.html.tmpl b/extensions/Voting/template/en/default/hook/global/user-error-errors.html.tmpl
new file mode 100644 (file)
index 0000000..55c32d4
--- /dev/null
+++ b/extensions/Voting/template/en/default/hook/global/user-error-errors.html.tmpl
@@ -0,0 +1,43 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% IF error == "voting_must_be_nonnegative" %]
+    [% title = "Votes Must Be Non-negative" %]
+    [% admindocslinks = {'voting.html' => 'Setting up the voting feature'} %]
+    Only use non-negative numbers for your [% terms.bug %] votes.
+
+[% ELSIF error == "voting_product_illegal_votes" %]
+    [% title = "Votes Must Be Non-negative" %]
+    [% admindocslinks = {'voting.html' => 'Setting up the voting feature'} %]
+    '[% votes FILTER html %]' is an invalid value for the
+    <em>
+    [% IF field == "votesperuser" %]
+      Votes Per User
+    [% ELSIF field == "maxvotesperbug" %]
+      Maximum Votes Per [% terms.Bug %]
+    [% ELSIF field == "votestoconfirm" %]
+      Votes To Confirm
+    [% END %]
+    </em> field, which should contain a non-negative number.
+
+[% ELSIF error == "voting_too_many_votes_for_bug" %]
+    [% title = "Illegal Vote" %]
+    [% admindocslinks = {'voting.html' => 'Setting up the voting feature'} %]
+    You may only use at most [% max FILTER html %] votes for a single
+    [%+ terms.bug %] in the
+    <tt>[% product FILTER html %]</tt> product, but you are trying to
+    use [% votes FILTER html %].
+
+[% ELSIF error == "voting_too_many_votes_for_product" %]
+    [% title = "Illegal Vote" %]
+    [% admindocslinks = {'voting.html' => 'Setting up the voting feature'} %]
+    You tried to use [% votes FILTER html %] votes in the
+    <tt>[% product FILTER html %]</tt> product, which exceeds the maximum of
+    [%+ max FILTER html %] votes for this product.
+
+[% END %]

diff --git a/extensions/Voting/template/en/default/hook/search/form-after_freetext_fields.html.tmpl b/extensions/Voting/template/en/default/hook/search/form-after_freetext_fields.html.tmpl
new file mode 100644 (file)
index 0000000..cb549e3
--- /dev/null
+++ b/extensions/Voting/template/en/default/hook/search/form-after_freetext_fields.html.tmpl
@@ -0,0 +1,16 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+<div class="search_field_row">
+  <span class="field_label ">
+    <label for="votes">Only [% terms.bugs %] with at least</label>:
+  </span>
+  <input name="votes" id="votes" size="3"
+         value="[% default.votes.0 FILTER html %]"> votes
+  <input type="hidden" name="votes_type" value="greaterthaneq">
+</div>

diff --git a/extensions/Voting/template/en/default/hook/search/search-report-select-rep_fields.html.tmpl b/extensions/Voting/template/en/default/hook/search/search-report-select-rep_fields.html.tmpl
new file mode 100644 (file)
index 0000000..d8ec155
--- /dev/null
+++ b/extensions/Voting/template/en/default/hook/search/search-report-select-rep_fields.html.tmpl
@@ -0,0 +1,9 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% rep_fields.push('votes') %]

diff --git a/extensions/Voting/template/en/default/pages/voting.html.tmpl b/extensions/Voting/template/en/default/pages/voting.html.tmpl
new file mode 100644 (file)
index 0000000..82a4bbd
--- /dev/null
+++ b/extensions/Voting/template/en/default/pages/voting.html.tmpl
@@ -0,0 +1,55 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% INCLUDE global/header.html.tmpl title = "Voting" %]
+
+<p>[% terms.Bugzilla %] has a "voting" feature. Each product allows users to 
+have a certain number of votes. (Some products may not allow any, which means 
+you can't vote on things in those products at all.) With your vote, you 
+indicate which [% terms.bugs %] you think are the most important and 
+would like to see fixed. Note that voting is nowhere near as effective 
+as providing a fix yourself.</p>
+
+<p>Depending on how the administrator has configured the relevant product,
+you may be able to vote for the same [% terms.bug %] more than once.
+Remember that you have a limited number of votes. When weighted voting 
+is allowed and a limited number of votes are available to you, you will 
+have to decide whether you want to distribute your votes among a large 
+number of [% terms.bugs %] indicating your minimal interest or focus on 
+a few [% terms.bugs %] indicating your strong support for them.
+</p>
+
+<p>To look at votes:</p>
+
+<ul>
+  <li>Go to the query page. Do a normal query, but enter 1 in the "At least
+  ___ votes" field. This will show you items that match your query that
+  have at least one vote.</li>
+</ul>
+
+<p>To vote for [% terms.abug %]:</p>
+
+<ul>
+  <li>Bring up the [% terms.bug %] in question.</li>
+
+  <li>Click on the "(vote)" link that appears on the right of the "Importance"
+  fields. (If no such link appears, then voting may not be allowed in
+  this [% terms.bug %]'s product.)</li>
+
+  <li>Indicate how many votes you want to give this [% terms.bug %]. This page 
+  also displays how many votes you've given to other [% terms.bugs %], so you 
+  may rebalance your votes as necessary.</li>
+</ul>
+
+<p>You will automatically get email notifying you of any changes that occur
+on [% terms.bugs %] you vote for.</p>
+
+<p>You may review your votes at any time by clicking on the "<a href=
+"page.cgi?id=voting/user.html">My Votes</a>" link in the page footer.</p>
+
+[% INCLUDE global/footer.html.tmpl %]

diff --git a/extensions/Voting/template/en/default/pages/voting/bug.html.tmpl b/extensions/Voting/template/en/default/pages/voting/bug.html.tmpl
new file mode 100644 (file)
index 0000000..2ba784f
--- /dev/null
+++ b/extensions/Voting/template/en/default/pages/voting/bug.html.tmpl
@@ -0,0 +1,50 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # bug: Bugzilla::Bug that we are listing the votes for.
+  # users: list of hashes. May be empty. Each hash has two members:
+  #   login_name: string. The login name of the user whose vote is attached
+  #   vote_count: integer. The number of times that user has votes for this bug.
+  #%]
+
+[% subheader = BLOCK %]
+  [% "$terms.Bug $bug.id" FILTER bug_link(bug) FILTER none %] - [% bug.short_desc FILTER html %]
+[% END %]
+
+[% PROCESS global/header.html.tmpl
+           title = "Show Votes"
+           subheader = subheader
+ %]
+
+[% total = 0 %]
+<table cellspacing="4">
+  <tr>
+    <th>Who</th>
+    <th>Number of votes</th>
+  </tr>
+
+  [% FOREACH voter = users %]
+    [% total = total + voter.vote_count %]
+    <tr>
+      <td>
+          <a href="page.cgi?id=voting/user.html&amp;user_id=
+                  [%- voter.id FILTER uri %]">
+          [% voter.login_name FILTER email FILTER html %]
+        </a>
+      </td>
+      <td align="right">
+        [% voter.vote_count FILTER html %]
+      </td>
+    </tr>
+  [% END %]
+</table>
+
+<p>Total votes: [% total FILTER html %]</p>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/extensions/Voting/template/en/default/pages/voting/user.html.tmpl b/extensions/Voting/template/en/default/pages/voting/user.html.tmpl
new file mode 100644 (file)
index 0000000..27ce2ac
--- /dev/null
+++ b/extensions/Voting/template/en/default/pages/voting/user.html.tmpl
@@ -0,0 +1,179 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # voting_user: hash containing a 'login' field
+  #
+  # products: list of hashes containing details of products relating to
+  #           voting: 
+  #            name: name of product
+  #            bugs: list of bugs the user has voted for
+  #            bug_ids: list of bug ids the user has voted for
+  #            onevoteonly: one or more votes allowed per bug?
+  #            total: users current vote count for the product
+  #            maxvotes: max votes allowed for a user in this product
+  #            maxperbug: max votes per bug allowed for a user in this product
+  #
+  # this_bug: Bugzilla::Bug; if the user is voting for a bug, this is the bug
+  #
+  # canedit: boolean; Should the votes be presented in a form, or readonly? 
+  #
+  # all_bug_ids: List of all bug ids the user has voted for, across all products
+  #%]
+
+[% IF !header_done %]
+  [% subheader = voting_user.login FILTER html %]
+  [% IF canedit %]
+    [% title = "Change Votes" %]
+    [% IF this_bug %]
+      [%# We .select and .focus the input so it works for textbox and 
+          checkbox %]
+      [% onload = "document.forms['voting_form'].bug_" _ this_bug.id _
+                  ".select();document.forms['voting_form'].bug_" _ this_bug.id _
+                  ".focus()" %]
+    [% END %]
+  [% ELSE %]
+    [% title = "Show Votes" %]
+  [% END %]
+  [% PROCESS global/header.html.tmpl
+             style_urls = [ "extensions/Voting/web/style.css" ] 
+  %]
+[% ELSE %]
+  <hr>
+[% END %]
+
+[% IF votes_recorded %]
+  <p>
+    <font color="red">
+      The changes to your votes have been saved.
+    </font>
+  </p>
+[% ELSE %]
+  <br>
+[% END %]
+
+[% IF products.size %]
+  <form name="voting_form" method="post" action="page.cgi?id=voting/user.html">
+    <input type="hidden" name="action" value="vote">
+    <input type="hidden" name="token" value="[% issue_hash_token(['vote']) FILTER html %]">
+    <table cellspacing="4">
+      <tr>
+        <td></td>
+        <th>Votes</th>
+        <th>[% terms.Bug %] #</th>
+        <th>Summary</th>
+      </tr>
+
+      [% onevoteproduct = 0 %]
+      [% multivoteproduct = 0 %]
+      [% FOREACH product = products %]
+        [% IF product.onevoteonly %]
+          [% onevoteproduct = 1 %]
+        [% ELSE %]
+          [% multivoteproduct = 1 %]
+        [% END %]
+        <tr>
+          <th>[% product.name FILTER html %]</th>
+          <td colspan="2" ><a href="buglist.cgi?bug_id=
+              [%- product.bug_ids.join(",") FILTER uri %]">([% terms.bug %] list)</a>
+          </td>
+          <td>
+            [% IF product.maxperbug < product.maxvotes AND
+                  product.maxperbug > 1 %]
+              <font size="-1">
+                (Note: only [% product.maxperbug FILTER html %] vote
+                [% "s" IF product.maxperbug != 1 %] allowed per [% terms.bug %] in
+                this product.)
+              </font>
+            [% END %]
+          </td>
+        </tr>
+
+        [% FOREACH bug = product.bugs %]
+          <tr [% IF bug.id == this_bug.id && canedit %] 
+            class="bz_bug_being_voted_on" [% END %]>
+            <td>
+              [% IF bug.id == this_bug.id && canedit %]
+                [% IF product.onevoteonly %]
+                  Vote For This [% terms.Bug %] &rarr;
+                [% ELSE %]
+                  Enter Votes Here &rarr;
+                [% END %]
+              [%- END %]
+            </td>
+            <td align="right"><a name="vote_[% bug.id FILTER html %]">
+              [% IF canedit %]
+                [% IF product.onevoteonly %]
+                  <input type="checkbox" name="[% bug.id FILTER html %]" value="1"
+                    [% " checked" IF bug.count %] id="bug_[% bug.id FILTER html %]">
+                [% ELSE %]
+                  <input name="[% bug.id FILTER html %]" value="[% bug.count FILTER html %]"
+                         size="2" id="bug_[% bug.id FILTER html %]">
+                [% END %]
+              [% ELSE %]
+                [% bug.count FILTER html %]
+              [% END %]
+            </a></td>
+            <td align="center">
+              [% bug.id FILTER bug_link(bug) FILTER none %]
+            </td>
+            <td>
+              [% bug.summary FILTER html %]
+              (<a href="page.cgi?id=voting/bug.html&amp;bug_id=[% bug.id FILTER uri %]">Show Votes</a>)
+            </td>
+          </tr>
+        [% END %]
+
+        <tr>
+          <td></td>
+          <td colspan="3">[% product.total FILTER html %] vote
+            [% "s" IF product.total != 1 %] used out of [% product.maxvotes FILTER html %]
+            allowed.
+            <br>
+            <br>
+          </td>
+        </tr>
+      [% END %]
+    </table>
+
+    [% IF canedit %]
+      <input type="submit" value="Change My Votes" id="change"> or 
+      <a href="buglist.cgi?bug_id=[% all_bug_ids.join(",") FILTER uri %]">view all
+        as [% terms.bug %] list</a>
+      <br>
+      <br>
+      To change your votes,
+      [% IF multivoteproduct %]
+        type in new numbers (using zero to mean no votes)
+        [% " or " IF onevoteproduct %]
+      [% END %]
+      [% IF onevoteproduct %]
+        change the checkbox
+      [% END %]
+      and then click <b>Change My Votes</b>.
+    [% ELSE %]
+       <a href="buglist.cgi?bug_id=[% all_bug_ids.join(",") FILTER uri %]">View all
+         as [% terms.bug %] list</a>
+    [% END %]
+  </form>
+[% ELSE %]
+  <p>
+    [% IF canedit %]
+    You are
+    [% ELSE %]
+    This user is
+    [% END %]
+    currently not voting on any [% terms.bugs %].
+  </p>
+[% END %]
+
+<p>
+  <a href="page.cgi?id=voting.html">Help with voting</a>.
+</p>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/extensions/Voting/template/en/default/voting/delete-all.html.tmpl b/extensions/Voting/template/en/default/voting/delete-all.html.tmpl
new file mode 100644 (file)
index 0000000..683ec06
--- /dev/null
+++ b/extensions/Voting/template/en/default/voting/delete-all.html.tmpl
@@ -0,0 +1,38 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # This template has no interface.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+           title = "Remove your votes?"
+ %]
+
+<p>
+  You are about to remove all of your [% terms.bug %] votes. Are you sure you wish to
+  remove your vote from every [% terms.bug %] you've voted on?
+</p>
+
+<form action="page.cgi?id=voting/user.html" method="post">
+    <input type="hidden" name="action" value="vote">
+    <input type="hidden" name="token" value="[% issue_hash_token(['vote']) FILTER html %]">
+  <p>
+    <input type="radio" name="delete_all_votes" value="1">
+    Yes, delete all my votes
+  </p>
+  <p>
+    <input type="radio" name="delete_all_votes" value="0" checked="checked">
+    No, go back and review my votes
+  </p>
+  <p>
+    <input type="submit" id="vote" value="Submit">
+  </p>
+</form>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/extensions/Voting/template/en/default/voting/votes-removed.txt.tmpl b/extensions/Voting/template/en/default/voting/votes-removed.txt.tmpl
new file mode 100644 (file)
index 0000000..e3cb34d
--- /dev/null
+++ b/extensions/Voting/template/en/default/voting/votes-removed.txt.tmpl
@@ -0,0 +1,40 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+From: [% Param('mailfrom') %]
+To: [% to %]
+Subject: [% terms.Bug %] [%+ bugid %] Some or all of your votes have been removed.
+X-Bugzilla-Type: voteremoved
+
+Some or all of your votes have been removed from [% terms.bug %] [%+ bugid %].
+
+You had [% votesold FILTER html %] [%+ IF votesold == 1 %]vote[% ELSE %]votes[% END
+%] on this [% terms.bug %], but [% votesremoved FILTER html %] have been removed.
+
+[% IF votesnew %]
+You still have [% votesnew FILTER html %] [%+ IF votesnew == 1 %]vote[% ELSE %]votes[% END %] on this [% terms.bug %].
+[% ELSE %]
+You have no more votes remaining on this [% terms.bug %].
+[% END %]
+
+Reason:
+[% IF reason == "votes_bug_moved" %]
+  This [% terms.bug %] has been moved to a different product.
+
+[% ELSIF reason == "votes_too_many_per_bug" %]
+  The rules for voting on this product has changed;
+  you had too many votes for a single [% terms.bug %].
+
+[% ELSIF reason == "votes_too_many_per_user" %]
+  The rules for voting on this product has changed; you had
+  too many total votes, so all votes have been removed.
+[% END %]
+
+
+
+[% urlbase %]show_bug.cgi?id=[% bugid %]

diff --git a/extensions/Voting/web/style.css b/extensions/Voting/web/style.css
new file mode 100644 (file)
index 0000000..3f06200
--- /dev/null
+++ b/extensions/Voting/web/style.css
@@ -0,0 +1,21 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+/* Highlight the row for the bug being voted on */
+tr.bz_bug_being_voted_on {
+    background-color: #e2e2e2;
+}
+
+tr.bz_bug_being_voted_on td {
+    border-style: solid none solid none;
+    border-width: thin;
+}
+
+#votes_container { 
+    white-space: nowrap; 
+}

diff --git a/extensions/create.pl b/extensions/create.pl
new file mode 100755 (executable)
index 0000000..7bcf103
--- /dev/null
+++ b/extensions/create.pl
@@ -0,0 +1,71 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Util qw(get_text);
+
+use File::Path qw(mkpath);
+
+my $base_dir = bz_locations()->{'extensionsdir'};
+
+my $name = $ARGV[0] or ThrowUserError('extension_create_no_name');
+$name = ucfirst($name);
+if ($name !~ /^[A-Z]/) {
+    ThrowUserError('extension_first_letter_caps', { name => $name });
+}
+
+my $extension_dir = "$base_dir/$name"; 
+mkpath($extension_dir) 
+  || die "$extension_dir already exists or cannot be created.\n";
+
+my $lcname = lc($name);
+foreach my $path (qw(lib web template/en/default/hook), 
+                  "template/en/default/$lcname")
+{
+    mkpath("$extension_dir/$path") || die "$extension_dir/$path: $!";
+}
+
+my $template = Bugzilla->template;
+my $vars = { name => $name, path => $extension_dir };
+my %create_files = (
+    'config.pm.tmpl'       => 'Config.pm',
+    'extension.pm.tmpl'    => 'Extension.pm',
+    'util.pm.tmpl'         => 'lib/Util.pm',
+    'web-readme.txt.tmpl'  => 'web/README',
+    'hook-readme.txt.tmpl' => 'template/en/default/hook/README',
+    'name-readme.txt.tmpl' => "template/en/default/$lcname/README",
+);
+
+foreach my $template_file (keys %create_files) {
+    my $target = $create_files{$template_file};
+    my $output;
+    $template->process("extensions/$template_file", $vars, \$output)
+      or ThrowTemplateError($template->error());
+   open(my $fh, '>', "$extension_dir/$target");
+   print $fh $output;
+   close($fh);
+}
+
+print get_text('extension_created', $vars), "\n";
+
+__END__
+
+=head1 NAME
+
+extensions/create.pl - Create a framework for a new Bugzilla Extension.
+
+=head1 SYNOPSIS
+
+ extensions/create.pl NAME
+
+ Creates a framework for an extension called NAME in the F<extensions/>
+ directory.

diff --git a/images/favicon.ico b/images/favicon.ico
new file mode 100644 (file)
index 0000000..c8ade39
Binary files /dev/null and b/images/favicon.ico differ

diff --git a/images/padlock.png b/images/padlock.png
new file mode 100644 (file)
index 0000000..a8be368
Binary files /dev/null and b/images/padlock.png differ

diff --git a/importxml.pl b/importxml.pl
new file mode 100755 (executable)
index 0000000..7a11811
--- /dev/null
+++ b/importxml.pl
@@ -0,0 +1,1340 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# This script reads in xml bug data from standard input and inserts
+# a new bug into bugzilla. Everything before the beginning <?xml line
+# is removed so you can pipe in email messages.
+
+use strict;
+
+#####################################################################
+#
+# This script is used to import bugs from another installation of bugzilla.
+# It can be used in two ways.
+# First using the move function of bugzilla
+# on another system will send mail to an alias provided by
+# the administrator of the target installation (you). Set up an alias
+# similar to the one given below so this mail will be automatically
+# run by this script and imported into your database.  Run 'newaliases'
+# after adding this alias to your aliases file. Make sure your sendmail
+# installation is configured to allow mail aliases to execute code.
+#
+# bugzilla-import: "|/usr/bin/perl /opt/bugzilla/importxml.pl"
+#
+# Second it can be run from the command line with any xml file from
+# STDIN that conforms to the bugzilla DTD. In this case you can pass
+# an argument to set whether you want to send the
+# mail that will be sent to the exporter and maintainer normally.
+#
+# importxml.pl bugsfile.xml
+#
+#####################################################################
+
+use File::Basename qw(dirname);
+# MTAs may call this script from any directory, but it should always
+# run from this one so that it can find its modules.
+BEGIN {
+    require File::Basename;
+    my $dir = $0; $dir =~ /(.*)/; $dir = $1; # trick taint
+    chdir(File::Basename::dirname($dir));
+}
+
+use lib qw(. lib);
+# Data dumber is used for debugging, I got tired of copying it back in 
+# and then removing it. 
+#use Data::Dumper;
+
+
+use Bugzilla;
+use Bugzilla::Object;
+use Bugzilla::Bug;
+use Bugzilla::Product;
+use Bugzilla::Version;
+use Bugzilla::Component;
+use Bugzilla::Milestone;
+use Bugzilla::FlagType;
+use Bugzilla::BugMail;
+use Bugzilla::Mailer;
+use Bugzilla::User;
+use Bugzilla::Util;
+use Bugzilla::Constants;
+use Bugzilla::Keyword;
+use Bugzilla::Field;
+use Bugzilla::Status;
+
+use MIME::Base64;
+use MIME::Parser;
+use Getopt::Long;
+use Pod::Usage;
+use XML::Twig;
+
+my $debug = 0;
+my $mail  = '';
+my $attach_path = '';
+my $help  = 0;
+my $bug_page = 'show_bug.cgi?id=';
+my $default_product_name = '';
+my $default_component_name = '';
+
+my $result = GetOptions(
+    "verbose|debug+" => \$debug,
+    "mail|sendmail!" => \$mail,
+    "attach_path=s"  => \$attach_path,
+    "help|?"         => \$help,
+    "bug_page=s"     => \$bug_page,
+    "product=s"      => \$default_product_name,
+    "component=s"    => \$default_component_name,
+);
+
+pod2usage(0) if $help;
+
+use constant OK_LEVEL    => 3;
+use constant DEBUG_LEVEL => 2;
+use constant ERR_LEVEL   => 1;
+
+our @logs;
+our @attachments;
+our $bugtotal;
+my $xml;
+my $dbh = Bugzilla->dbh;
+my $params = Bugzilla->params;
+my ($timestamp) = $dbh->selectrow_array("SELECT NOW()");
+
+###############################################################################
+# Helper sub routines                                                         #
+###############################################################################
+
+sub MailMessage {
+    return unless ($mail);
+    my $subject    = shift;
+    my $message    = shift;
+    my @recipients = @_;
+    my $from   = $params->{"mailfrom"};
+    $from =~ s/@/\@/g;
+
+    foreach my $to (@recipients){
+        my $header = "To: $to\n";
+        $header .= "From: Bugzilla <$from>\n";
+        $header .= "Subject: $subject\n\n";
+        my $sendmessage = $header . $message . "\n";
+        MessageToMTA($sendmessage);
+    }
+
+}
+
+sub Debug {
+    return unless ($debug);
+    my ( $message, $level ) = (@_);
+    print STDERR "OK: $message \n" if ( $level == OK_LEVEL );
+    print STDERR "ERR: $message \n" if ( $level == ERR_LEVEL );
+    print STDERR "$message\n"
+      if ( ( $debug == $level ) && ( $level == DEBUG_LEVEL ) );
+}
+
+sub Error {
+    my ( $reason, $errtype, $exporter ) = @_;
+    my $subject = "Bug import error: $reason";
+    my $message = "Cannot import these bugs because $reason ";
+    $message .= "\n\nPlease re-open the original bug.\n" if ($errtype);
+    $message .= "For more info, contact " . $params->{"maintainer"} . ".\n";
+    my @to = ( $params->{"maintainer"}, $exporter);
+    Debug( $message, ERR_LEVEL );
+    MailMessage( $subject, $message, @to );
+    exit;
+}
+
+# This subroutine handles flags for process_bug. It is generic in that
+# it can handle both attachment flags and bug flags.
+sub flag_handler {
+    my (
+        $name,            $status,      $setter_login,
+        $requestee_login, $exporterid,  $bugid,
+        $componentid,     $productid,   $attachid
+      )
+      = @_;
+
+    my $type         = ($attachid) ? "attachment" : "bug";
+    my $err          = '';
+    my $setter       = new Bugzilla::User({ name => $setter_login });
+    my $requestee;
+    my $requestee_id;
+
+    unless ($setter) {
+        $err = "Invalid setter $setter_login on $type flag $name\n";
+        $err .= "   Dropping flag $name\n";
+        return $err;
+    }
+    if ( !$setter->can_see_bug($bugid) ) {
+        $err .= "Setter is not a member of bug group\n";
+        $err .= "   Dropping flag $name\n";
+        return $err;
+    }
+    my $setter_id = $setter->id;
+    if ( defined($requestee_login) ) {
+        $requestee = new Bugzilla::User({ name => $requestee_login });
+        if ( $requestee ) {
+            if ( !$requestee->can_see_bug($bugid) ) {
+                $err .= "Requestee is not a member of bug group\n";
+                $err .= "   Requesting from the wind\n";
+            }    
+            else{
+                $requestee_id = $requestee->id;
+            }
+        }
+        else {
+            $err = "Invalid requestee $requestee_login on $type flag $name\n";
+            $err .= "   Requesting from the wind.\n";
+        }
+        
+    }
+    my $flag_types;
+
+    # If this is an attachment flag we need to do some dirty work to look
+    # up the flagtype ID
+    if ($attachid) {
+        $flag_types = Bugzilla::FlagType::match(
+            {
+                'target_type'  => 'attachment',
+                'product_id'   => $productid,
+                'component_id' => $componentid
+            } );
+    }
+    else {
+        my $bug = new Bugzilla::Bug($bugid);
+        $flag_types = $bug->flag_types;
+    }
+    unless ($flag_types){
+        $err  = "No flag types defined for this bug\n";
+        $err .= "   Dropping flag $name\n";
+        return $err;
+    }
+
+    # We need to see if the imported flag is in the list of known flags
+    # It is possible for two flags on the same bug have the same name
+    # If this is the case, we will only match the first one.
+    my $ftype;
+    foreach my $f ( @{$flag_types} ) {
+        if ( $f->name eq $name) {
+            $ftype = $f;
+            last;
+        }
+    }
+
+    if ($ftype) {    # We found the flag in the list
+        my $grant_group = $ftype->grant_group;
+        if (( $status eq '+' || $status eq '-' ) 
+            && $grant_group && !$setter->in_group_id($grant_group->id)) {
+            $err = "Setter $setter_login on $type flag $name ";
+            $err .= "is not in the Grant Group\n";
+            $err .= "   Dropping flag $name\n";
+            return $err;
+        }
+        my $request_group = $ftype->request_group;
+        if ($request_group
+            && $status eq '?' && !$setter->in_group_id($request_group->id)) {
+            $err = "Setter $setter_login on $type flag $name ";
+            $err .= "is not in the Request Group\n";
+            $err .= "   Dropping flag $name\n";
+            return $err;
+        }
+
+        # Take the first flag_type that matches
+        unless ($ftype->is_active) {
+            $err = "Flag $name is not active in this database\n";
+            $err .= "   Dropping flag $name\n";
+            return $err;
+        }
+
+        $dbh->do("INSERT INTO flags 
+                 (type_id, status, bug_id, attach_id, creation_date, 
+                  setter_id, requestee_id)
+                  VALUES (?, ?, ?, ?, ?, ?, ?)", undef,
+            ($ftype->id, $status, $bugid, $attachid, $timestamp,
+            $setter_id, $requestee_id));
+    }
+    else {
+        $err = "Dropping unknown $type flag: $name\n";
+        return $err;
+    }
+    return $err;
+}
+
+# Converts and returns the input data as an array.
+sub _to_array {
+    my $value = shift;
+
+    $value = [$value] if !ref($value);
+    return @$value;
+}
+
+###############################################################################
+# XML Handlers                                                                #
+###############################################################################
+
+# This subroutine gets called only once - as soon as the <bugzilla> opening
+# tag is parsed. It simply checks to see that the all important exporter
+# maintainer and URL base are set.
+#
+#    exporter:   email address of the person moving the bugs
+#    maintainer: the maintainer of the bugzilla installation
+#                as set in the parameters file
+#    urlbase:    The urlbase parameter of the installation
+#                bugs are being moved from
+#
+sub init() {
+    my ( $twig, $bugzilla ) = @_;
+    my $root       = $twig->root;
+    my $maintainer = $root->{'att'}->{'maintainer'};
+    my $exporter   = $root->{'att'}->{'exporter'};
+    my $urlbase    = $root->{'att'}->{'urlbase'};
+    my $xmlversion = $root->{'att'}->{'version'};
+
+    if ($xmlversion ne BUGZILLA_VERSION) {
+            my $log = "Possible version conflict!\n";
+            $log .= "   XML was exported from Bugzilla version $xmlversion\n";
+            $log .= "   But this installation uses ";
+            $log .= BUGZILLA_VERSION . "\n";
+            Debug($log, OK_LEVEL);
+            push(@logs, $log);
+    }
+    Error( "no maintainer", "REOPEN", $exporter ) unless ($maintainer);
+    Error( "no exporter",   "REOPEN", $exporter ) unless ($exporter);
+    Error( "invalid exporter: $exporter", "REOPEN", $exporter ) if ( !login_to_id($exporter) );
+    Error( "no urlbase set", "REOPEN", $exporter ) unless ($urlbase);
+}
+    
+
+# Parse attachments.
+#
+# This subroutine is called once for each attachment in the xml file.
+# It is called as soon as the closing </attachment> tag is parsed.
+# Since attachments have the potential to be very large, and
+# since each attachment will be inside <bug>..</bug> tags we shove
+# the attachment onto an array which will be processed by process_bug
+# and then disposed of. The attachment array will then contain only
+# one bugs' attachments at a time.
+# The cycle will then repeat for the next <bug>
+#
+# The attach_id is ignored since mysql generates a new one for us.
+# The submitter_id gets filled in with $exporterid.
+
+sub process_attachment() {
+    my ( $twig, $attach ) = @_;
+    Debug( "Parsing attachments", DEBUG_LEVEL );
+    my %attachment;
+
+    $attachment{'date'} =
+        format_time( $attach->field('date'), "%Y-%m-%d %R" ) || $timestamp;
+    $attachment{'desc'}       = $attach->field('desc');
+    $attachment{'ctype'}      = $attach->field('type') || "unknown/unknown";
+    $attachment{'attachid'}   = $attach->field('attachid');
+    $attachment{'ispatch'}    = $attach->{'att'}->{'ispatch'} || 0;
+    $attachment{'isobsolete'} = $attach->{'att'}->{'isobsolete'} || 0;
+    $attachment{'isprivate'}  = $attach->{'att'}->{'isprivate'} || 0;
+    $attachment{'filename'}   = $attach->field('filename') || "file";
+    $attachment{'attacher'}   = $attach->field('attacher');
+    # Attachment data is not exported in versions 2.20 and older.
+    if (defined $attach->first_child('data') &&
+            defined $attach->first_child('data')->{'att'}->{'encoding'}) {
+        my $encoding = $attach->first_child('data')->{'att'}->{'encoding'};
+        if ($encoding =~ /base64/) {
+            # decode the base64
+            my $data   = $attach->field('data');
+            my $output = decode_base64($data);
+            $attachment{'data'} = $output;
+        }
+        elsif ($encoding =~ /filename/) {
+            # read the attachment file
+            Error("attach_path is required", undef) unless ($attach_path);
+            
+            my $filename = $attach->field('data');
+            # Remove any leading path data from the filename
+            $filename =~ s/(.*\/|.*\\)//gs;
+            
+            my $attach_filename = $attach_path . "/" . $filename;
+            open(ATTACH_FH, "<", $attach_filename) or
+                Error("cannot open $attach_filename", undef);
+            $attachment{'data'} = do { local $/; <ATTACH_FH> };
+            close ATTACH_FH;
+        }
+    }
+    else {
+        $attachment{'data'} = $attach->field('data');
+    }
+
+    # attachment flags
+    my @aflags;
+    foreach my $aflag ( $attach->children('flag') ) {
+        my %aflag;
+        $aflag{'name'}      = $aflag->{'att'}->{'name'};
+        $aflag{'status'}    = $aflag->{'att'}->{'status'};
+        $aflag{'setter'}    = $aflag->{'att'}->{'setter'};
+        $aflag{'requestee'} = $aflag->{'att'}->{'requestee'};
+        push @aflags, \%aflag;
+    }
+    $attachment{'flags'} = \@aflags if (@aflags);
+
+    # free up the memory for use by the rest of the script
+    $attach->delete;
+    if ($attachment{'attachid'}) {
+        push @attachments, \%attachment;
+    }
+    else {
+        push @attachments, "err";
+    }
+}
+
+# This subroutine will be called once for each <bug> in the xml file.
+# It is called as soon as the closing </bug> tag is parsed.
+# If this bug had any <attachment> tags, they will have been processed
+# before we get to this point and their data will be in the @attachments
+# array.
+# As each bug is processed, it is inserted into the database and then
+# purged from memory to free it up for later bugs.
+
+sub process_bug {
+    my ( $twig, $bug ) = @_;
+    my $root             = $twig->root;
+    my $maintainer       = $root->{'att'}->{'maintainer'};
+    my $exporter_login   = $root->{'att'}->{'exporter'};
+    my $exporter         = new Bugzilla::User({ name => $exporter_login });
+    my $urlbase          = $root->{'att'}->{'urlbase'};
+    my $url              = $urlbase . $bug_page;
+    trick_taint($url);
+
+    # We will store output information in this variable.
+    my $log = "";
+    if ( defined $bug->{'att'}->{'error'} ) {
+        $log .= "\nError in bug " . $bug->field('bug_id') . "\@$urlbase: ";
+        $log .= $bug->{'att'}->{'error'} . "\n";
+        if ( $bug->{'att'}->{'error'} =~ /NotFound/ ) {
+            $log .= "$exporter_login tried to move bug " . $bug->field('bug_id');
+            $log .= " here, but $urlbase reports that this bug";
+            $log .= " does not exist.\n";
+        }
+        elsif ( $bug->{'att'}->{'error'} =~ /NotPermitted/ ) {
+            $log .= "$exporter_login tried to move bug " . $bug->field('bug_id');
+            $log .= " here, but $urlbase reports that $exporter_login does ";
+            $log .= " not have access to that bug.\n";
+        }
+        return;
+    }
+    $bugtotal++;
+
+    # This list contains all other bug fields that we want to process.
+    # If it is not in this list it will not be included.
+    my %all_fields;
+    foreach my $field ( 
+        qw(long_desc attachment flag group), Bugzilla::Bug::fields() )
+    {
+        $all_fields{$field} = 1;
+    }
+    
+    my %bug_fields;
+    my $err = "";
+
+   # Loop through all the xml tags inside a <bug> and compare them to the
+   # lists of fields. If they match throw them into the hash. Otherwise
+   # append it to the log, which will go into the comments when we are done.
+    foreach my $bugchild ( $bug->children() ) {
+        Debug( "Parsing field: " . $bugchild->name, DEBUG_LEVEL );
+
+        # Skip the token if one is included. We don't want it included in
+        # the comments, and it is not used by the importer.
+        next if $bugchild->name eq 'token';
+
+        if ( defined $all_fields{ $bugchild->name } ) {
+            my @values = $bug->children_text($bugchild->name);
+            if (scalar @values > 1) {
+                $bug_fields{$bugchild->name} = \@values;
+            }
+            else {
+                $bug_fields{$bugchild->name} = $values[0];
+            }
+        }
+        else {
+            $err .= "Unknown bug field \"" . $bugchild->name . "\"";
+            $err .= " encountered while moving bug\n";
+            $err .= "   <" . $bugchild->name . ">";
+            if ( $bugchild->children_count > 1 ) {
+                $err .= "\n";
+                foreach my $subchild ( $bugchild->children() ) {
+                    $err .= "     <" . $subchild->name . ">";
+                    $err .= $subchild->field;
+                    $err .= "</" . $subchild->name . ">\n";
+                }
+            }
+            else {
+                $err .= $bugchild->field;
+            }
+            $err .= "</" . $bugchild->name . ">\n";
+        }
+    }
+
+    # Parse long descriptions
+    my @long_descs;
+    foreach my $comment ( $bug->children('long_desc') ) {
+        Debug( "Parsing Long Description", DEBUG_LEVEL );
+        my %long_desc = ( who       => $comment->field('who'),
+                          bug_when  => $comment->field('bug_when'),
+                          isprivate => $comment->{'att'}->{'isprivate'} || 0 );
+
+        # If the exporter is not in the insidergroup, keep the comment public.
+        $long_desc{isprivate} = 0 unless $exporter->is_insider;
+
+        my $data = $comment->field('thetext');
+        if ( defined $comment->first_child('thetext')->{'att'}->{'encoding'}
+            && $comment->first_child('thetext')->{'att'}->{'encoding'} =~
+            /base64/ )
+        {
+            $data = decode_base64($data);
+        }
+
+        # For backwards-compatibility with Bugzillas before 3.6:
+        #
+        # If we leave the attachment ID in the comment it will be made a link
+        # to the wrong attachment. Since the new attachment ID is unknown yet
+        # let's strip it out for now. We will make a comment with the right ID
+        # later
+        $data =~ s/Created an attachment \(id=\d+\)/Created an attachment/g;
+
+        # Same goes for bug #'s Since we don't know if the referenced bug
+        # is also being moved, lets make sure they know it means a different
+        # bugzilla.
+        $data =~ s/([Bb]ugs?\s*\#?\s*(\d+))/$url$2/g;
+
+        # Keep the original commenter if possible, else we will fall back
+        # to the exporter account.
+        $long_desc{whoid} = login_to_id($long_desc{who});
+
+        if (!$long_desc{whoid}) {
+            $data = "The original author of this comment is $long_desc{who}.\n\n" . $data;
+        }
+
+        $long_desc{'thetext'} = $data;
+        push @long_descs, \%long_desc;
+    }
+
+    my @sorted_descs = sort { $a->{'bug_when'} cmp $b->{'bug_when'} } @long_descs;
+
+    my $comments = "\n\n--- Bug imported by $exporter_login ";
+    $comments .= format_time(scalar localtime(time()), '%Y-%m-%d %R %Z') . " ";
+    $comments .= " ---\n\n";
+    $comments .= "This bug was previously known as _bug_ $bug_fields{'bug_id'} at ";
+    $comments .= $url . $bug_fields{'bug_id'} . "\n";
+    if ( defined $bug_fields{'dependson'} ) {
+        $comments .= "This bug depended on bug(s) " .
+                     join(' ', _to_array($bug_fields{'dependson'})) . ".\n";
+    }
+    if ( defined $bug_fields{'blocked'} ) {
+        $comments .= "This bug blocked bug(s) " .
+                     join(' ', _to_array($bug_fields{'blocked'})) . ".\n";
+    }
+
+    # Now we process each of the fields in turn and make sure they contain
+    # valid data. We will create two parallel arrays, one for the query
+    # and one for the values. For every field we need to push an entry onto
+    # each array.
+    my @query  = ();
+    my @values = ();
+
+    # Each of these fields we will check for newlines and shove onto the array
+    foreach my $field (qw(status_whiteboard bug_file_loc short_desc)) {
+        if ($bug_fields{$field}) {
+            $bug_fields{$field} = clean_text( $bug_fields{$field} );
+            push( @query,  $field );
+            push( @values, $bug_fields{$field} );
+        }
+    }
+
+    # Alias
+    if ( $bug_fields{'alias'} ) {
+        my ($alias) = $dbh->selectrow_array("SELECT COUNT(*) FROM bugs 
+                                                WHERE alias = ?", undef,
+                                                $bug_fields{'alias'} );
+        if ($alias) {
+            $err .= "Dropping conflicting bug alias ";
+            $err .= $bug_fields{'alias'} . "\n";
+        }
+        else {
+            $alias = $bug_fields{'alias'};
+            push @query,  'alias';
+            push @values, $alias;
+        }
+    }
+
+    # Timestamps
+    push( @query, "creation_ts" );
+    push( @values,
+        format_time( $bug_fields{'creation_ts'}, "%Y-%m-%d %T" )
+          || $timestamp );
+
+    push( @query, "delta_ts" );
+    push( @values,
+        format_time( $bug_fields{'delta_ts'}, "%Y-%m-%d %T" )
+          || $timestamp );
+
+    # Bug Access
+    push( @query,  "cclist_accessible" );
+    push( @values, $bug_fields{'cclist_accessible'} ? 1 : 0 );
+
+    push( @query,  "reporter_accessible" );
+    push( @values, $bug_fields{'reporter_accessible'} ? 1 : 0 );
+
+    my $product = new Bugzilla::Product(
+        { name => $bug_fields{'product'} || '' });
+    if (!$product) {
+        $err .= "Unknown Product " . $bug_fields{'product'} . "\n";
+        $err .= "   Using default product set at the command line.\n";
+        $product = new Bugzilla::Product({ name => $default_product_name })
+            or Error("an invalid default product was defined for the target"
+                     . " DB. " . $params->{"maintainer"} . " needs to specify "
+                     . "--product when calling importxml.pl", "REOPEN", 
+                     $exporter);
+    }
+    my $component = new Bugzilla::Component({
+        product => $product, name => $bug_fields{'component'} || '' });
+    if (!$component) {
+        $err .= "Unknown Component " . $bug_fields{'component'} . "\n";
+        $err .= "   Using default product and component set ";
+        $err .= "at the command line.\n";
+
+        $product = new Bugzilla::Product({ name => $default_product_name });
+        $component = new Bugzilla::Component({
+           name => $default_component_name, product => $product });
+        if (!$component) {
+            Error("an invalid default component was defined for the target" 
+                  . " DB. ".  $params->{"maintainer"} . " needs to specify " 
+                  . "--component when calling importxml.pl", "REOPEN", 
+                  $exporter);
+        }
+    }
+
+    my $prod_id = $product->id;
+    my $comp_id = $component->id;
+
+    push( @query,  "product_id" );
+    push( @values, $prod_id );
+    push( @query,  "component_id" );
+    push( @values, $comp_id );
+
+    # Since there is no default version for a product, we check that the one
+    # coming over is valid. If not we will use the first one in @versions
+    # and warn them.
+    my $version = new Bugzilla::Version(
+          { product => $product, name => $bug_fields{'version'} });
+
+    push( @query, "version" );
+    if ($version) {
+        push( @values, $version->name );
+    }
+    else {
+        my @versions = @{ $product->versions };
+        my $v        = $versions[0];
+        push( @values, $v->name );
+        $err .= "Unknown version \"";
+        $err .= ( defined $bug_fields{'version'} )
+            ? $bug_fields{'version'}
+            : "unknown";
+        $err .= " in product " . $product->name . ". \n";
+        $err .= "   Setting version to \"" . $v->name . "\".\n";
+    }
+
+    # Milestone
+    if ( $params->{"usetargetmilestone"} ) {
+        my $milestone;
+        if (defined $bug_fields{'target_milestone'}
+            && $bug_fields{'target_milestone'} ne "") {
+
+            $milestone = new Bugzilla::Milestone(
+                { product => $product, name => $bug_fields{'target_milestone'} });
+        }
+        if ($milestone) {
+            push( @values, $milestone->name );
+        }
+        else {
+            push( @values, $product->default_milestone );
+            $err .= "Unknown milestone \"";
+            $err .= ( defined $bug_fields{'target_milestone'} )
+                ? $bug_fields{'target_milestone'}
+                : "unknown";
+            $err .= " in product " . $product->name . ". \n";
+            $err .= "   Setting to default milestone for this product, ";
+            $err .= "\"" . $product->default_milestone . "\".\n";
+        }
+        push( @query, "target_milestone" );
+    }
+
+    # For priority, severity, opsys and platform we check that the one being
+    # imported is valid. If it is not we use the defaults set in the parameters.
+    if (defined( $bug_fields{'bug_severity'} )
+        && check_field('bug_severity', scalar $bug_fields{'bug_severity'},
+                       undef, ERR_LEVEL) )
+    {
+        push( @values, $bug_fields{'bug_severity'} );
+    }
+    else {
+        push( @values, $params->{'defaultseverity'} );
+        $err .= "Unknown severity ";
+        $err .= ( defined $bug_fields{'bug_severity'} )
+          ? $bug_fields{'bug_severity'}
+          : "unknown";
+        $err .= ". Setting to default severity \"";
+        $err .= $params->{'defaultseverity'} . "\".\n";
+    }
+    push( @query, "bug_severity" );
+
+    if (defined( $bug_fields{'priority'} )
+        && check_field('priority', scalar $bug_fields{'priority'},
+                       undef, ERR_LEVEL ) )
+    {
+        push( @values, $bug_fields{'priority'} );
+    }
+    else {
+        push( @values, $params->{'defaultpriority'} );
+        $err .= "Unknown priority ";
+        $err .= ( defined $bug_fields{'priority'} )
+          ? $bug_fields{'priority'}
+          : "unknown";
+        $err .= ". Setting to default priority \"";
+        $err .= $params->{'defaultpriority'} . "\".\n";
+    }
+    push( @query, "priority" );
+
+    if (defined( $bug_fields{'rep_platform'} )
+        && check_field('rep_platform', scalar $bug_fields{'rep_platform'},
+                       undef, ERR_LEVEL ) )
+    {
+        push( @values, $bug_fields{'rep_platform'} );
+    }
+    else {
+        push( @values, $params->{'defaultplatform'} );
+        $err .= "Unknown platform ";
+        $err .= ( defined $bug_fields{'rep_platform'} )
+          ? $bug_fields{'rep_platform'}
+          : "unknown";
+        $err .=". Setting to default platform \"";
+        $err .= $params->{'defaultplatform'} . "\".\n";
+    }
+    push( @query, "rep_platform" );
+
+    if (defined( $bug_fields{'op_sys'} )
+        && check_field('op_sys',  scalar $bug_fields{'op_sys'},
+                       undef, ERR_LEVEL ) )
+    {
+        push( @values, $bug_fields{'op_sys'} );
+    }
+    else {
+        push( @values, $params->{'defaultopsys'} );
+        $err .= "Unknown operating system ";
+        $err .= ( defined $bug_fields{'op_sys'} )
+          ? $bug_fields{'op_sys'}
+          : "unknown";
+        $err .= ". Setting to default OS \"" . $params->{'defaultopsys'} . "\".\n";
+    }
+    push( @query, "op_sys" );
+
+    # Process time fields
+    if ( $params->{"timetrackinggroup"} ) {
+        my $date = validate_date( $bug_fields{'deadline'} ) ? $bug_fields{'deadline'} : undef;
+        push( @values, $date );
+        push( @query,  "deadline" );
+        if ( defined $bug_fields{'estimated_time'} ) {
+            eval {
+                Bugzilla::Object::_validate_time($bug_fields{'estimated_time'}, "e");
+            };
+            if (!$@){
+                push( @values, $bug_fields{'estimated_time'} );
+                push( @query,  "estimated_time" );
+            }
+        }
+        if ( defined $bug_fields{'remaining_time'} ) {
+            eval {
+                Bugzilla::Object::_validate_time($bug_fields{'remaining_time'}, "r");
+            };
+            if (!$@){
+                push( @values, $bug_fields{'remaining_time'} );
+                push( @query,  "remaining_time" );
+            }
+        }
+        if ( defined $bug_fields{'actual_time'} ) {
+            eval {
+                Bugzilla::Object::_validate_time($bug_fields{'actual_time'}, "a");
+            };
+            if ($@){
+                $bug_fields{'actual_time'} = 0.0;
+                $err .= "Invalid Actual Time. Setting to 0.0\n";
+            }
+        }
+        else {
+            $bug_fields{'actual_time'} = 0.0;
+            $err .= "Actual time not defined. Setting to 0.0\n";
+        }
+    }
+
+    # Reporter Assignee QA Contact
+    my $exporterid = $exporter->id;
+    my $reporterid = login_to_id( $bug_fields{'reporter'} )
+      if $bug_fields{'reporter'};
+    push( @query, "reporter" );
+    if ( ( $bug_fields{'reporter'} ) && ($reporterid) ) {
+        push( @values, $reporterid );
+    }
+    else {
+        push( @values, $exporterid );
+        $err .= "The original reporter of this bug does not have\n";
+        $err .= "   an account here. Reassigning to the person who moved\n";
+        $err .= "   it here: $exporter_login.\n";
+        if ( $bug_fields{'reporter'} ) {
+            $err .= "   Previous reporter was $bug_fields{'reporter'}.\n";
+        }
+        else {
+            $err .= "   Previous reporter is unknown.\n";
+        }
+    }
+
+    my $changed_owner = 0;
+    my $owner;
+    push( @query, "assigned_to" );
+    if ( ( $bug_fields{'assigned_to'} )
+        && ( $owner = login_to_id( $bug_fields{'assigned_to'} )) ) {
+        push( @values, $owner );
+    }
+    else {
+        push( @values, $component->default_assignee->id );
+        $changed_owner = 1;
+        $err .= "The original assignee of this bug does not have\n";
+        $err .= "   an account here. Reassigning to the default assignee\n";
+        $err .= "   for the component, ". $component->default_assignee->login .".\n";
+        if ( $bug_fields{'assigned_to'} ) {
+            $err .= "   Previous assignee was $bug_fields{'assigned_to'}.\n";
+        }
+        else {
+            $err .= "   Previous assignee is unknown.\n";
+        }
+    }
+
+    if ( $params->{"useqacontact"} ) {
+        my $qa_contact;
+        push( @query, "qa_contact" );
+        if ( ( defined $bug_fields{'qa_contact'})
+            && ( $qa_contact = login_to_id( $bug_fields{'qa_contact'} ) ) ) {
+            push( @values, $qa_contact );
+        }
+        else {
+            push(@values, $component->default_qa_contact ?
+                          $component->default_qa_contact->id : undef);
+
+            if ($component->default_qa_contact) {
+                $err .= "Setting qa contact to the default for this product.\n";
+                $err .= "   This bug either had no qa contact or an invalid one.\n";
+            }
+        }
+    }
+
+    # Status & Resolution
+    my $valid_res = check_field('resolution',  
+                                  scalar $bug_fields{'resolution'}, 
+                                  undef, ERR_LEVEL );
+    my $valid_status = check_field('bug_status',  
+                                  scalar $bug_fields{'bug_status'}, 
+                                  undef, ERR_LEVEL );
+    my $status = $bug_fields{'bug_status'} || undef;
+    my $resolution = $bug_fields{'resolution'} || undef;
+    
+    # Check everconfirmed 
+    my $everconfirmed;
+    if ($product->allows_unconfirmed) {
+        $everconfirmed = $bug_fields{'everconfirmed'} || 0;
+    }
+    else {
+        $everconfirmed = 1;
+    }
+    push (@query,  "everconfirmed");
+    push (@values, $everconfirmed);
+
+    # Sanity check will complain about having bugs marked duplicate but no
+    # entry in the dup table. Since we can't tell the bug ID of bugs
+    # that might not yet be in the database we have no way of populating
+    # this table. Change the resolution instead.
+    if ( $valid_res  && ( $bug_fields{'resolution'} eq "DUPLICATE" ) ) {
+        $resolution = "INVALID";
+        $err .= "This bug was marked DUPLICATE in the database ";
+        $err .= "it was moved from.\n    Changing resolution to \"INVALID\"\n";
+    } 
+
+    # If there is at least 1 initial bug status different from UNCO, use it,
+    # else use the open bug status with the lowest sortkey (different from UNCO).
+    my @bug_statuses = @{Bugzilla::Status->can_change_to()};
+    @bug_statuses = grep { $_->name ne 'UNCONFIRMED' } @bug_statuses;
+
+    my $initial_status;
+    if (scalar(@bug_statuses)) {
+        $initial_status = $bug_statuses[0]->name;
+    }
+    else {
+        @bug_statuses = Bugzilla::Status->get_all();
+        # Exclude UNCO and inactive bug statuses.
+        @bug_statuses = grep { $_->is_active && $_->name ne 'UNCONFIRMED'} @bug_statuses;
+        my @open_statuses = grep { $_->is_open } @bug_statuses;
+        if (scalar(@open_statuses)) {
+            $initial_status = $open_statuses[0]->name;
+        }
+        else {
+            # There is NO other open bug statuses outside UNCO???
+            Error("no open bug statuses available.");
+        }
+    }
+
+    if ($status) {
+        if($valid_status){
+            if (is_open_state($status)) {
+                if ($resolution) {
+                    $err .= "Resolution set on an open status.\n";
+                    $err .= "   Dropping resolution $resolution\n";
+                    $resolution = undef;
+                }
+                if($changed_owner){
+                    if($everconfirmed){  
+                        $status = $initial_status;
+                    }
+                    else{
+                        $status = "UNCONFIRMED";
+                    }
+                    if ($status ne $bug_fields{'bug_status'}){
+                        $err .= "Bug reassigned, setting status to \"$status\".\n";
+                        $err .= "   Previous status was \"";
+                        $err .=  $bug_fields{'bug_status'} . "\".\n";
+                    }
+                }
+                if($everconfirmed){
+                    if($status eq "UNCONFIRMED"){
+                        $err .= "Bug Status was UNCONFIRMED but everconfirmed was true\n";
+                        $err .= "   Setting status to $initial_status\n";
+                        $status = $initial_status;
+                    }
+                }
+                else{ # $everconfirmed is false
+                    if($status ne "UNCONFIRMED"){
+                        $err .= "Bug Status was $status but everconfirmed was false\n";
+                        $err .= "   Setting status to UNCONFIRMED\n";
+                        $status = "UNCONFIRMED";
+                    }
+                }
+            }
+            else {
+               if (!$resolution) {
+                   $err .= "Missing Resolution. Setting status to ";
+                   if($everconfirmed){
+                       $status = $initial_status;
+                       $err .= "$initial_status\n";
+                   }
+                   else{
+                       $status = "UNCONFIRMED";
+                       $err .= "UNCONFIRMED\n";
+                   }
+               }
+               elsif (!$valid_res) {
+                   $err .= "Unknown resolution \"$resolution\".\n";
+                   $err .= "   Setting resolution to INVALID\n";
+                   $resolution = "INVALID";
+               }
+            }   
+        }
+        else{ # $valid_status is false
+            if($everconfirmed){  
+                $status = $initial_status;
+            }
+            else{
+                $status = "UNCONFIRMED";
+            }        
+            $err .= "Bug has invalid status, setting status to \"$status\".\n";
+            $err .= "   Previous status was \"";
+            $err .=  $bug_fields{'bug_status'} . "\".\n";
+            $resolution = undef;
+        }
+    }
+    else {
+        if($everconfirmed){  
+            $status = $initial_status;
+        }
+        else{
+            $status = "UNCONFIRMED";
+        }        
+        $err .= "Bug has no status, setting status to \"$status\".\n";
+        $err .= "   Previous status was unknown\n";
+        $resolution = undef;
+    }
+
+    if ($resolution) {
+        push( @query,  "resolution" );
+        push( @values, $resolution );
+    }
+    
+    # Bug status
+    push( @query,  "bug_status" );
+    push( @values, $status );
+
+    # Custom fields - Multi-select fields have their own table.
+    my %multi_select_fields;
+    foreach my $field (Bugzilla->active_custom_fields) {
+        my $custom_field = $field->name;
+        my $value = $bug_fields{$custom_field};
+        next unless defined $value;
+        if ($field->type == FIELD_TYPE_FREETEXT) {
+            push(@query, $custom_field);
+            push(@values, clean_text($value));
+        } elsif ($field->type == FIELD_TYPE_TEXTAREA) {
+            push(@query, $custom_field);
+            push(@values, $value);
+        } elsif ($field->type == FIELD_TYPE_SINGLE_SELECT) {
+            my $is_well_formed = check_field($custom_field, $value, undef, ERR_LEVEL);
+            if ($is_well_formed) {
+                push(@query, $custom_field);
+                push(@values, $value);
+            } else {
+                $err .= "Skipping illegal value \"$value\" in $custom_field.\n" ;
+            }
+        } elsif ($field->type == FIELD_TYPE_MULTI_SELECT) {
+            my @legal_values;
+            foreach my $item (_to_array($value)) {
+                my $is_well_formed = check_field($custom_field, $item, undef, ERR_LEVEL);
+                if ($is_well_formed) {
+                    push(@legal_values, $item);
+                } else {
+                    $err .= "Skipping illegal value \"$item\" in $custom_field.\n" ;
+                }
+            }
+            if (scalar @legal_values) {
+                $multi_select_fields{$custom_field} = \@legal_values;
+            }
+        } elsif ($field->type == FIELD_TYPE_DATETIME) {
+            eval { $value = Bugzilla::Bug->_check_datetime_field($value); };
+            if ($@) {
+                $err .= "Skipping illegal value \"$value\" in $custom_field.\n" ;
+            }
+            else {
+                push(@query, $custom_field);
+                push(@values, $value);
+            }
+        } else {
+            $err .= "Type of custom field $custom_field is an unhandled FIELD_TYPE: " .
+                    $field->type . "\n";
+        }
+    }
+
+    # For the sake of sanitycheck.cgi we do this.
+    # Update lastdiffed if you do not want to have mail sent
+    unless ($mail) {
+        push @query,  "lastdiffed";
+        push @values, $timestamp;
+    }
+
+    # INSERT the bug
+    my $query = "INSERT INTO bugs (" . join( ", ", @query ) . ") VALUES (";
+       $query .= '?,' foreach (@values);
+    chop($query);    # Remove the last comma.
+       $query .= ")";
+
+    $dbh->do( $query, undef, @values );
+    my $id = $dbh->bz_last_key( 'bugs', 'bug_id' );
+
+    # We are almost certain to get some uninitialized warnings
+    # Since this is just for debugging the query, let's shut them up
+    eval {
+        no warnings 'uninitialized';
+        Debug(
+            "Bug Query: INSERT INTO bugs (\n"
+              . join( ",\n", @query )
+              . "\n) VALUES (\n"
+              . join( ",\n", @values ),
+            DEBUG_LEVEL
+        );
+    };
+
+    # Handle CC's
+    if ( defined $bug_fields{'cc'} ) {
+        my %ccseen;
+        my $sth_cc = $dbh->prepare("INSERT INTO cc (bug_id, who) VALUES (?,?)");
+        foreach my $person (_to_array($bug_fields{'cc'})) {
+            next unless $person;
+            my $uid;
+            if ($uid = login_to_id($person)) {
+                if ( !$ccseen{$uid} ) {
+                    $sth_cc->execute( $id, $uid );
+                    $ccseen{$uid} = 1;
+                }
+            }
+            else {
+                $err .= "CC member $person does not have an account here\n";
+            }
+        }
+    }
+
+    # Handle keywords
+    if ( defined( $bug_fields{'keywords'} ) ) {
+        my %keywordseen;
+        my $key_sth = $dbh->prepare(
+            "INSERT INTO keywords 
+                      (bug_id, keywordid) VALUES (?,?)"
+        );
+        foreach my $keyword ( split( /[\s,]+/, $bug_fields{'keywords'} )) {
+            next unless $keyword;
+            my $keyword_obj = new Bugzilla::Keyword({name => $keyword});
+            if (!$keyword_obj) {
+                $err .= "Skipping unknown keyword: $keyword.\n";
+                next;
+            }
+            if (!$keywordseen{$keyword_obj->id}) {
+                $key_sth->execute($id, $keyword_obj->id);
+                $keywordseen{$keyword_obj->id} = 1;
+            }
+        }
+    }
+
+    # Insert values of custom multi-select fields. They have already
+    # been validated.
+    foreach my $custom_field (keys %multi_select_fields) {
+        my $sth = $dbh->prepare("INSERT INTO bug_$custom_field
+                                 (bug_id, value) VALUES (?, ?)");
+        foreach my $value (@{$multi_select_fields{$custom_field}}) {
+            $sth->execute($id, $value);
+        }
+    }
+
+    # Parse bug flags
+    foreach my $bflag ( $bug->children('flag')) {
+        next unless ( defined($bflag) );
+        $err .= flag_handler(
+            $bflag->{'att'}->{'name'},   $bflag->{'att'}->{'status'},
+            $bflag->{'att'}->{'setter'}, $bflag->{'att'}->{'requestee'},
+            $exporterid,                 $id,
+            $comp_id,                    $prod_id,
+            undef
+        );
+    }
+
+    # Insert Attachments for the bug
+    foreach my $att (@attachments) {
+        if ($att eq "err"){
+            $err .= "No attachment ID specified, dropping attachment\n";
+            next;
+        }
+        if (!$exporter->is_insider && $att->{'isprivate'}) {
+            $err .= "Exporter not in insidergroup and attachment marked private.\n";
+            $err .= "   Marking attachment public\n";
+            $att->{'isprivate'} = 0;
+        }
+
+        my $attacher_id = $att->{'attacher'} ? login_to_id($att->{'attacher'}) : undef;
+
+        $dbh->do("INSERT INTO attachments 
+                 (bug_id, creation_ts, modification_time, filename, description,
+                 mimetype, ispatch, isprivate, isobsolete, submitter_id) 
+                 VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)",
+            undef, $id, $att->{'date'}, $att->{'date'}, $att->{'filename'},
+            $att->{'desc'}, $att->{'ctype'}, $att->{'ispatch'},
+            $att->{'isprivate'}, $att->{'isobsolete'}, $attacher_id || $exporterid);
+        my $att_id   = $dbh->bz_last_key( 'attachments', 'attach_id' );
+        my $att_data = $att->{'data'};
+        my $sth = $dbh->prepare("INSERT INTO attach_data (id, thedata) 
+                                 VALUES ($att_id, ?)" );
+        trick_taint($att_data);
+        $sth->bind_param( 1, $att_data, $dbh->BLOB_TYPE );
+        $sth->execute();
+
+        $comments .= "Imported an attachment (id=$att_id)\n";
+        if (!$attacher_id) {
+            if ($att->{'attacher'}) {
+                $err .= "The original submitter of attachment $att_id was\n   ";
+                $err .= $att->{'attacher'} . ", but he doesn't have an account here.\n";
+            }
+            else {
+                $err .= "The original submitter of attachment $att_id is unknown.\n";
+            }
+            $err .= "   Reassigning to the person who moved it here: $exporter_login.\n";
+        }
+
+        # Process attachment flags
+        foreach my $aflag (@{ $att->{'flags'} }) {
+            next unless defined($aflag) ;
+            $err .= flag_handler(
+                $aflag->{'name'},   $aflag->{'status'},
+                $aflag->{'setter'}, $aflag->{'requestee'},
+                $exporterid,        $id,
+                $comp_id,           $prod_id,
+                $att_id
+            );
+        }
+    }
+
+    # Clear the attachments array for the next bug
+    @attachments = ();
+
+    # Insert comments and append any errors
+    my $worktime = $bug_fields{'actual_time'} || 0.0;
+    $worktime = 0.0 if (!$exporter->is_timetracker);
+    $comments .= "\n$err\n" if $err;
+
+    my $sth_comment =
+      $dbh->prepare('INSERT INTO longdescs (bug_id, who, bug_when, isprivate,
+                                            thetext, work_time)
+                     VALUES (?, ?, ?, ?, ?, ?)');
+
+    foreach my $c (@sorted_descs) {
+        $sth_comment->execute($id, $c->{whoid} || $exporterid, $c->{bug_when},
+                              $c->{isprivate}, $c->{thetext}, 0);
+    }
+    $sth_comment->execute($id, $exporterid, $timestamp, 0, $comments, $worktime);
+    Bugzilla::Bug->new($id)->_sync_fulltext( new_bug => 1);
+
+    # Add this bug to each group of which its product is a member.
+    my $sth_group = $dbh->prepare("INSERT INTO bug_group_map (bug_id, group_id) 
+                         VALUES (?, ?)");
+    foreach my $group_id ( keys %{ $product->group_controls } ) {
+        if ($product->group_controls->{$group_id}->{'membercontrol'} != CONTROLMAPNA
+            && $product->group_controls->{$group_id}->{'othercontrol'} != CONTROLMAPNA){
+            $sth_group->execute( $id, $group_id );
+        }
+    }
+
+    $log .= "Bug ${url}$bug_fields{'bug_id'} ";
+    $log .= "imported as bug $id.\n";
+    $log .= $params->{"urlbase"} . "show_bug.cgi?id=$id\n\n";
+    if ($err) {
+        $log .= "The following problems were encountered while creating bug $id.\n";
+        $log .= $err;
+        $log .= "You may have to set certain fields in the new bug by hand.\n\n";
+    }
+    Debug( $log, OK_LEVEL );
+    push(@logs, $log);
+    Bugzilla::BugMail::Send( $id, { 'changer' => $exporter } ) if ($mail);
+
+    # done with the xml data. Lets clear it from memory
+    $twig->purge;
+
+}
+
+Debug( "Reading xml", DEBUG_LEVEL );
+
+# Read STDIN in slurp mode. VERY dangerous, but we live on the wild side ;-)
+local ($/);
+$xml = <>;
+
+# If there's anything except whitespace before <?xml then we guess it's a mail
+# and MIME::Parser should parse it. Else don't.
+if ($xml =~ m/\S.*<\?xml/s ) {
+
+    # If the email was encoded (Mailer::MessageToMTA() does it when using UTF-8),
+    # we have to decode it first, else the XML parsing will fail.
+    my $parser = MIME::Parser->new;
+    $parser->output_to_core(1);
+    $parser->tmp_to_core(1);
+    my $entity = $parser->parse_data($xml);
+    my $bodyhandle = $entity->bodyhandle;
+    $xml = $bodyhandle->as_string;
+
+}
+
+# remove everything in file before xml header
+$xml =~ s/^.+(<\?xml version.+)$/$1/s;
+
+Debug( "Parsing tree", DEBUG_LEVEL );
+my $twig = XML::Twig->new(
+    twig_handlers => {
+        bug        => \&process_bug,
+        attachment => \&process_attachment
+    },
+    start_tag_handlers => { bugzilla => \&init }
+);
+$twig->parse($xml);
+my $root       = $twig->root;
+my $maintainer = $root->{'att'}->{'maintainer'};
+my $exporter   = $root->{'att'}->{'exporter'};
+my $urlbase    = $root->{'att'}->{'urlbase'};
+
+# It is time to email the result of the import.
+my $log = join("\n\n", @logs);
+$log .=  "\n\nImported $bugtotal bug(s) from $urlbase,\n  sent by $exporter.\n";
+my $subject =  "$bugtotal Bug(s) successfully moved from $urlbase to " 
+   . $params->{"urlbase"};
+my @to = ($exporter, $maintainer);
+MailMessage( $subject, $log, @to );
+
+__END__
+
+=head1 NAME
+
+importxml - Import bugzilla bug data from xml.
+
+=head1 SYNOPSIS
+
+ importxml.pl [options] [file ...]
+
+=head1 OPTIONS
+
+=over
+
+=item B<-?>
+
+Print a brief help message and exit.
+
+=item B<-v>
+
+Print error and debug information. Mulltiple -v increases verbosity
+
+=item B<-m> B<--sendmail>
+
+Send mail to exporter with a log of bugs imported and any errors.
+
+=item B<--attach_path>
+
+The path to the attachment files. (Required if encoding="filename"
+is used for attachments.)
+
+=item B<--bug_page>
+
+The page that links to the bug on top of urlbase. Its default value
+is "show_bug.cgi?id=", which is what Bugzilla installations use.
+You only need to pass this argument if you are importing bugs from
+another bug tracking system.
+
+=item B<--product=name>
+
+The product to put the bug in if the product specified in the
+XML doesn't exist.
+
+=item B<--component=name>
+
+The component to put the bug in if the component specified in the
+XML doesn't exist.
+
+=back
+
+=head1 DESCRIPTION
+
+     This script is used to import bugs from another installation of bugzilla.
+     It can be used in two ways.
+     First using the move function of bugzilla
+     on another system will send mail to an alias provided by
+     the administrator of the target installation (you). Set up an alias
+     similar to the one given below so this mail will be automatically 
+     run by this script and imported into your database.  Run 'newaliases'
+     after adding this alias to your aliases file. Make sure your sendmail
+     installation is configured to allow mail aliases to execute code. 
+
+     bugzilla-import: "|/usr/bin/perl /opt/bugzilla/importxml.pl --mail"
+
+     Second it can be run from the command line with any xml file from 
+     STDIN that conforms to the bugzilla DTD. In this case you can pass 
+     an argument to set whether you want to send the
+     mail that will be sent to the exporter and maintainer normally.
+
+     importxml.pl [options] bugsfile.xml
+
+=cut

diff --git a/index.cgi b/index.cgi
new file mode 100755 (executable)
index 0000000..68352c0
--- /dev/null
+++ b/index.cgi
@@ -0,0 +1,60 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+###############################################################################
+# Script Initialization
+###############################################################################
+
+# Make it harder for us to do dangerous things in Perl.
+use strict;
+
+# Include the Bugzilla CGI and general utility library.
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Update;
+
+# Check whether or not the user is logged in
+my $user = Bugzilla->login(LOGIN_OPTIONAL);
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $vars = {};
+
+# And log out the user if requested. We do this first so that nothing
+# else accidentally relies on the current login.
+if ($cgi->param('logout')) {
+    Bugzilla->logout();
+    $user = Bugzilla->user;
+    $vars->{'message'} = "logged_out";
+    # Make sure that templates or other code doesn't get confused about this.
+    $cgi->delete('logout');
+}
+
+###############################################################################
+# Main Body Execution
+###############################################################################
+
+# Return the appropriate HTTP response headers.
+print $cgi->header();
+
+if ($user->in_group('admin')) {
+    # If 'urlbase' is not set, display the Welcome page.
+    unless (Bugzilla->params->{'urlbase'}) {
+        $template->process('welcome-admin.html.tmpl')
+          || ThrowTemplateError($template->error());
+        exit;
+    }
+    # Inform the administrator about new releases, if any.
+    $vars->{'release'} = Bugzilla::Update::get_notifications();
+}
+
+# Generate and return the UI (HTML page) from the appropriate template.
+$template->process("index.html.tmpl", $vars)
+  || ThrowTemplateError($template->error());

diff --git a/install-module.pl b/install-module.pl
new file mode 100755 (executable)
index 0000000..4663777
--- /dev/null
+++ b/install-module.pl
@@ -0,0 +1,161 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use warnings;
+
+# Have to abs_path('.') or calls to Bugzilla modules won't work once
+# CPAN has chdir'ed around. We do all of this in this funny order to
+# make sure that we use the lib/ modules instead of the base Perl modules,
+# in case the lib/ modules are newer.
+use Cwd qw(abs_path cwd);
+use lib abs_path('.');
+use Bugzilla::Constants;
+use lib abs_path(bz_locations()->{ext_libpath});
+
+use Bugzilla::Install::CPAN;
+
+use Bugzilla::Constants;
+use Bugzilla::Install::Requirements;
+use Bugzilla::Install::Util qw(bin_loc init_console vers_cmp);
+
+use Data::Dumper;
+use Getopt::Long;
+use Pod::Usage;
+
+init_console();
+
+my @original_args = @ARGV;
+my $original_dir = cwd();
+our %switch;
+GetOptions(\%switch, 'all|a', 'upgrade-all|u', 'show-config|s', 'global|g',
+                     'shell', 'help|h');
+
+pod2usage({ -verbose => 1 }) if $switch{'help'};
+
+if (ON_ACTIVESTATE) {
+    print <<END;
+You cannot run this script when using ActiveState Perl. Please follow
+the instructions given by checksetup.pl to install missing Perl modules.
+
+END
+    exit;
+}
+
+pod2usage({ -verbose => 0 }) if (!%switch && !@ARGV);
+
+set_cpan_config($switch{'global'});
+
+if ($switch{'show-config'}) {
+    print Dumper($CPAN::Config);
+    exit;
+}
+
+check_cpan_requirements($original_dir, \@original_args);
+
+if ($switch{'shell'}) {
+    CPAN::shell();
+    exit;
+}
+
+if ($switch{'all'} || $switch{'upgrade-all'}) {
+    my @modules;
+    if ($switch{'upgrade-all'}) {
+        @modules = (@{REQUIRED_MODULES()}, @{OPTIONAL_MODULES()});
+        push(@modules, DB_MODULE->{$_}->{dbd}) foreach (keys %{DB_MODULE()});
+    }
+    else {
+        # This is the only time we need a Bugzilla-related module, so
+        # we require them down here. Otherwise this script can be run from
+        # any directory, even outside of Bugzilla itself.
+        my $reqs = check_requirements(0);
+        @modules = (@{$reqs->{missing}}, @{$reqs->{optional}});
+        my $dbs = DB_MODULE;
+        foreach my $db (keys %$dbs) {
+            push(@modules, $dbs->{$db}->{dbd})
+                if !have_vers($dbs->{$db}->{dbd}, 0);
+        }
+    }
+    foreach my $module (@modules) {
+        my $cpan_name = $module->{module};
+        # --all shouldn't include mod_perl2, because it can have some complex
+        # configuration, and really should be installed on its own.
+        next if $cpan_name eq 'mod_perl2';
+        next if $cpan_name eq 'DBD::Oracle' and !$ENV{ORACLE_HOME};
+        next if $cpan_name eq 'DBD::Pg' and !bin_loc('pg_config');
+        install_module($cpan_name);
+    }
+}
+
+foreach my $module (@ARGV) {
+    install_module($module);
+}
+
+__END__
+
+=head1 NAME
+
+install-module.pl - Installs or upgrades modules from CPAN.
+This script does not run on Windows.
+
+=head1 SYNOPSIS
+
+  ./install-module.pl Module::Name [--global]
+  ./install-module.pl --all [--global]
+  ./install-module.pl --upgrade-all [--global]
+  ./install-module.pl --show-config
+  ./install-module.pl --shell
+
+  Do "./install-module.pl --help" for more information.
+
+=head1 OPTIONS
+
+=over
+
+=item B<Module::Name>
+
+The name of a module that you want to install from CPAN. This is the
+same thing that you'd give to the C<install> command in the CPAN shell.
+
+You can specify multiple module names separated by a space to install
+multiple modules.
+
+=item B<--global>
+
+This makes install-module install modules globally for all applications,
+instead of just for Bugzilla.
+
+On most systems, you have to be root for C<--global> to work.
+
+=item B<--all>
+
+This will make install-module do its best to install every required
+and optional module that is not installed that Bugzilla can use.
+
+Some modules may fail to install. You can run checksetup.pl to see
+which installed properly.
+
+=item B<--upgrade-all>
+
+This is like C<--all>, except it forcibly installs the very latest
+version of every Bugzilla prerequisite, whether or not you already
+have them installed.
+
+=item B<--show-config>
+
+Prints out the CPAN configuration in raw Perl format. Useful for debugging.
+
+=item B<--shell>
+
+Starts a CPAN shell using the configuration of F<install-module.pl>.
+
+=item B<--help>
+
+Shows this help.
+
+=back

diff --git a/jobqueue.pl b/jobqueue.pl
new file mode 100755 (executable)
index 0000000..3b96b8d
--- /dev/null
+++ b/jobqueue.pl
@@ -0,0 +1,73 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+use Cwd qw(abs_path);
+use File::Basename;
+BEGIN {
+    # Untaint the abs_path.
+    my ($a) = abs_path($0) =~ /^(.*)$/;
+    chdir dirname($a);
+}
+
+use lib qw(. lib);
+use Bugzilla;
+use Bugzilla::JobQueue::Runner;
+
+Bugzilla::JobQueue::Runner->new();
+
+=head1 NAME
+
+jobqueue.pl - Runs jobs in the background for Bugzilla.
+
+=head1 SYNOPSIS
+
+ ./jobqueue.pl [OPTIONS] COMMAND
+
+   OPTIONS:
+   -f        Run in the foreground (don't detach)
+   -d        Output a lot of debugging information
+   -p file   Specify the file where jobqueue.pl should store its current
+             process id. Defaults to F<data/jobqueue.pl.pid>.
+   -n name   What should this process call itself in the system log?
+             Defaults to the full path you used to invoke the script.
+
+   COMMANDS:
+   start     Starts a new jobqueue daemon if there isn't one running already
+   stop      Stops a running jobqueue daemon
+   restart   Stops a running jobqueue if one is running, and then
+             starts a new one.
+   once      Checks the job queue once, executes the first item found (if
+             any) and then exits
+   onepass   Checks the job queue, executes all items found, and then exits
+   check     Report the current status of the daemon.
+   install   On some *nix systems, this automatically installs and
+             configures jobqueue.pl as a system service so that it will
+             start every time the machine boots.
+   uninstall Removes the system service for jobqueue.pl.
+   help      Display this usage info
+   version   Display the version of jobqueue.pl
+
+=head1 DESCRIPTION
+
+See L<Bugzilla::JobQueue> and L<Bugzilla::JobQueue::Runner>.
+
+=head1 Running jobqueue.pl as a System Service
+
+For systems that use Upstart or SysV Init, there is a SysV/Upstart init
+script included with Bugzilla for jobqueue.pl: F<contrib/bugzilla-queue>.
+It should work out-of-the-box on RHEL, Fedora, CentOS etc.
+
+You can install it by doing C<./jobqueue.pl install> as root, after
+already having run L<checksetup> at least once to completion
+on this Bugzilla installation.
+
+If you are using a system that isn't RHEL, Fedora, CentOS, etc., then you
+may have to modify F<contrib/bugzilla-queue> and install it yourself
+manually in order to get C<jobqueue.pl> running as a system service.

diff --git a/js/TUI.js b/js/TUI.js
new file mode 100644 (file)
index 0000000..87de78b
--- /dev/null
+++ b/js/TUI.js
@@ -0,0 +1,96 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+/* This file provides JavaScript functions to be included when one wishes
+ * to show/hide certain UI elements, and have the state of them being
+ * shown/hidden stored in a cookie.
+ * 
+ * TUI stands for Tweak UI.
+ *
+ * Requires js/util.js and the YUI Dom and Cookie libraries.
+ *
+ * See template/en/default/bug/create/create.html.tmpl for a usage example.
+ */
+
+var TUI_HIDDEN_CLASS = 'bz_tui_hidden';
+var TUI_COOKIE_NAME  = 'TUI';
+
+var TUI_alternates = new Array();
+
+/** 
+ * Hides a particular class of elements if they are shown, 
+ * or shows them if they are hidden. Then it stores whether that
+ * class is now hidden or shown.
+ *
+ * @param className   The name of the CSS class to hide.
+ */
+function TUI_toggle_class(className) {
+    var elements = YAHOO.util.Dom.getElementsByClassName(className);
+    for (var i = 0; i < elements.length; i++) {
+        bz_toggleClass(elements[i], TUI_HIDDEN_CLASS);
+    }
+    _TUI_save_class_state(elements, className);
+    _TUI_toggle_control_link(className);
+}
+
+
+/**
+ * Specifies that a certain class of items should be hidden by default,
+ * if the user doesn't have a TUI cookie.
+ * 
+ * @param className   The class to hide by default.
+ */
+function TUI_hide_default(className) {
+    YAHOO.util.Event.onDOMReady(function () {
+        if (!YAHOO.util.Cookie.getSub('TUI', className)) {
+            TUI_toggle_class(className);
+        }
+    });
+}
+
+function _TUI_toggle_control_link(className) {
+    var link = document.getElementById(className + "_controller");
+    if (!link) return;
+    var original_text = link.innerHTML;
+    link.innerHTML = TUI_alternates[className];
+    TUI_alternates[className] = original_text;
+}
+
+function _TUI_save_class_state(elements, aClass) {
+    // We just check the first element to see if it's hidden or not, and
+    // consider that all elements are the same.
+    if (YAHOO.util.Dom.hasClass(elements[0], TUI_HIDDEN_CLASS)) {
+        _TUI_store(aClass, 0);
+    }
+    else {
+        _TUI_store(aClass, 1);
+    }
+}
+
+function _TUI_store(aClass, state) {
+    YAHOO.util.Cookie.setSub(TUI_COOKIE_NAME, aClass, state,
+    {
+        expires: new Date('January 1, 2038'),
+        path: BUGZILLA.param.cookie_path
+    });
+}
+
+function _TUI_restore() {
+    var yui_classes = YAHOO.util.Cookie.getSubs(TUI_COOKIE_NAME);
+    for (yui_item in yui_classes) {
+        if (yui_classes[yui_item] == 0) {
+            var elements = YAHOO.util.Dom.getElementsByClassName(yui_item);
+            for (var i = 0; i < elements.length; i++) {
+                YAHOO.util.Dom.addClass(elements[i], 'bz_tui_hidden');
+            }
+            _TUI_toggle_control_link(yui_item);
+        }
+    }
+}
+
+YAHOO.util.Event.onDOMReady(_TUI_restore);

diff --git a/js/attachment.js b/js/attachment.js
new file mode 100644 (file)
index 0000000..d9bdabc
--- /dev/null
+++ b/js/attachment.js
@@ -0,0 +1,342 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+function validateAttachmentForm(theform) {
+    var desc_value = YAHOO.lang.trim(theform.description.value);
+    if (desc_value == '') {
+        alert(BUGZILLA.string.attach_desc_required);
+        return false;
+    }
+    return true;
+}
+
+function updateCommentPrivacy(checkbox) {
+    var text_elem = document.getElementById('comment');
+    if (checkbox.checked) {
+        text_elem.className='bz_private';
+    } else {
+        text_elem.className='';
+    }
+}
+
+function setContentTypeDisabledState(form) {
+    var isdisabled = false;
+    if (form.ispatch.checked)
+        isdisabled = true;
+
+    for (var i = 0; i < form.contenttypemethod.length; i++)
+        form.contenttypemethod[i].disabled = isdisabled;
+
+    form.contenttypeselection.disabled = isdisabled;
+    form.contenttypeentry.disabled = isdisabled;
+}
+
+function TextFieldHandler() {
+    var field_text = document.getElementById("attach_text");
+    var greyfields = new Array("data", "autodetect", "list", "manual",
+                               "contenttypeselection", "contenttypeentry");
+    var i, thisfield;
+    if (field_text.value.match(/^\s*$/)) {
+        for (i = 0; i < greyfields.length; i++) {
+            thisfield = document.getElementById(greyfields[i]);
+            if (thisfield) {
+                thisfield.removeAttribute("disabled");
+            }
+        }
+    } else {
+        for (i = 0; i < greyfields.length; i++) {
+            thisfield = document.getElementById(greyfields[i]);
+            if (thisfield) {
+                thisfield.setAttribute("disabled", "disabled");
+            }
+        }
+    }
+}
+
+function DataFieldHandler() {
+    var field_data = document.getElementById("data");
+    var greyfields = new Array("attach_text");
+    var i, thisfield;
+    if (field_data.value.match(/^\s*$/)) {
+        for (i = 0; i < greyfields.length; i++) {
+            thisfield = document.getElementById(greyfields[i]);
+            if (thisfield) {
+                thisfield.removeAttribute("disabled");
+            }
+        }
+    } else {
+        for (i = 0; i < greyfields.length; i++) {
+            thisfield = document.getElementById(greyfields[i]);
+            if (thisfield) {
+                thisfield.setAttribute("disabled", "disabled");
+            }
+        }
+    }
+}
+
+function clearAttachmentFields() {
+    var element;
+
+    document.getElementById('data').value = '';
+    DataFieldHandler();
+    if ((element = document.getElementById('attach_text'))) {
+        element.value = '';
+        TextFieldHandler();
+    }
+    document.getElementById('description').value = '';
+    /* Fire onchange so that the disabled state of the content-type
+     * radio buttons are also reset 
+     */
+    element = document.getElementById('ispatch');
+    element.checked = '';
+    bz_fireEvent(element, 'change');
+    if ((element = document.getElementById('isprivate')))
+        element.checked = '';
+}
+
+/* Functions used when viewing patches in Diff mode. */
+
+function collapse_all() {
+  var elem = document.checkboxform.firstChild;
+  while (elem != null) {
+    if (elem.firstChild != null) {
+      var tbody = elem.firstChild.nextSibling;
+      if (tbody.className == 'file') {
+        tbody.className = 'file_collapse';
+        twisty = get_twisty_from_tbody(tbody);
+        twisty.firstChild.nodeValue = '(+)';
+        twisty.nextSibling.checked = false;
+      }
+    }
+    elem = elem.nextSibling;
+  }
+  return false;
+}
+
+function expand_all() {
+  var elem = document.checkboxform.firstChild;
+  while (elem != null) {
+    if (elem.firstChild != null) {
+      var tbody = elem.firstChild.nextSibling;
+      if (tbody.className == 'file_collapse') {
+        tbody.className = 'file';
+        twisty = get_twisty_from_tbody(tbody);
+        twisty.firstChild.nodeValue = '(-)';
+        twisty.nextSibling.checked = true;
+      }
+    }
+    elem = elem.nextSibling;
+  }
+  return false;
+}
+
+var current_restore_elem;
+
+function restore_all() {
+  current_restore_elem = null;
+  incremental_restore();
+}
+
+function incremental_restore() {
+  if (!document.checkboxform.restore_indicator.checked) {
+    return;
+  }
+  var next_restore_elem;
+  if (current_restore_elem) {
+    next_restore_elem = current_restore_elem.nextSibling;
+  } else {
+    next_restore_elem = document.checkboxform.firstChild;
+  }
+  while (next_restore_elem != null) {
+    current_restore_elem = next_restore_elem;
+    if (current_restore_elem.firstChild != null) {
+      restore_elem(current_restore_elem.firstChild.nextSibling);
+    }
+    next_restore_elem = current_restore_elem.nextSibling;
+  }
+}
+
+function restore_elem(elem, alertme) {
+  if (elem.className == 'file_collapse') {
+    twisty = get_twisty_from_tbody(elem);
+    if (twisty.nextSibling.checked) {
+      elem.className = 'file';
+      twisty.firstChild.nodeValue = '(-)';
+    }
+  } else if (elem.className == 'file') {
+    twisty = get_twisty_from_tbody(elem);
+    if (!twisty.nextSibling.checked) {
+      elem.className = 'file_collapse';
+      twisty.firstChild.nodeValue = '(+)';
+    }
+  }
+}
+
+function twisty_click(twisty) {
+  tbody = get_tbody_from_twisty(twisty);
+  if (tbody.className == 'file') {
+    tbody.className = 'file_collapse';
+    twisty.firstChild.nodeValue = '(+)';
+    twisty.nextSibling.checked = false;
+  } else {
+    tbody.className = 'file';
+    twisty.firstChild.nodeValue = '(-)';
+    twisty.nextSibling.checked = true;
+  }
+  return false;
+}
+
+function get_tbody_from_twisty(twisty) {
+  return twisty.parentNode.parentNode.parentNode.nextSibling;
+}
+function get_twisty_from_tbody(tbody) {
+  return tbody.previousSibling.firstChild.nextSibling.firstChild.firstChild;
+}
+
+var prev_mode = 'raw';
+var current_mode = 'raw';
+var has_edited = 0;
+var has_viewed_as_diff = 0;
+function editAsComment(patchviewerinstalled)
+{
+    switchToMode('edit', patchviewerinstalled);
+    has_edited = 1;
+}
+function undoEditAsComment(patchviewerinstalled)
+{
+    switchToMode(prev_mode, patchviewerinstalled);
+}
+function redoEditAsComment(patchviewerinstalled)
+{
+    switchToMode('edit', patchviewerinstalled);
+}
+
+function viewDiff(attachment_id, patchviewerinstalled)
+{
+    switchToMode('diff', patchviewerinstalled);
+
+    // If we have not viewed as diff before, set the view diff frame URL
+    if (!has_viewed_as_diff) {
+      var viewDiffFrame = document.getElementById('viewDiffFrame');
+      viewDiffFrame.src =
+          'attachment.cgi?id=' + attachment_id + '&action=diff&headers=0';
+      has_viewed_as_diff = 1;
+    }
+}
+
+function viewRaw(patchviewerinstalled)
+{
+    switchToMode('raw', patchviewerinstalled);
+}
+
+function switchToMode(mode, patchviewerinstalled)
+{
+    if (mode == current_mode) {
+      alert('switched to same mode!  This should not happen.');
+      return;
+    }
+
+    // Switch out of current mode
+    if (current_mode == 'edit') {
+      hideElementById('editFrame');
+      hideElementById('undoEditButton');
+    } else if (current_mode == 'raw') {
+      hideElementById('viewFrame');
+      if (patchviewerinstalled)
+          hideElementById('viewDiffButton');
+      hideElementById(has_edited ? 'redoEditButton' : 'editButton');
+      hideElementById('smallCommentFrame');
+    } else if (current_mode == 'diff') {
+      if (patchviewerinstalled)
+          hideElementById('viewDiffFrame');
+      hideElementById('viewRawButton');
+      hideElementById(has_edited ? 'redoEditButton' : 'editButton');
+      hideElementById('smallCommentFrame');
+    }
+
+    // Switch into new mode
+    if (mode == 'edit') {
+      showElementById('editFrame');
+      showElementById('undoEditButton');
+    } else if (mode == 'raw') {
+      showElementById('viewFrame');
+      if (patchviewerinstalled) 
+          showElementById('viewDiffButton');
+
+      showElementById(has_edited ? 'redoEditButton' : 'editButton');
+      showElementById('smallCommentFrame');
+    } else if (mode == 'diff') {
+      if (patchviewerinstalled) 
+        showElementById('viewDiffFrame');
+
+      showElementById('viewRawButton');
+      showElementById(has_edited ? 'redoEditButton' : 'editButton');
+      showElementById('smallCommentFrame');
+    }
+
+    prev_mode = current_mode;
+    current_mode = mode;
+}
+
+function hideElementById(id)
+{
+  var elm = document.getElementById(id);
+  if (elm) {
+    YAHOO.util.Dom.addClass(elm, 'bz_default_hidden');
+  }
+}
+
+function showElementById(id)
+{
+  var elm = document.getElementById(id);
+  if (elm) {
+    YAHOO.util.Dom.removeClass(elm, 'bz_default_hidden');
+  }
+}
+
+function normalizeComments()
+{
+  // Remove the unused comment field from the document so its contents
+  // do not get transmitted back to the server.
+
+  var small = document.getElementById('smallCommentFrame');
+  var big = document.getElementById('editFrame');
+  if ( (small) && YAHOO.util.Dom.hasClass(small, 'bz_default_hidden') )
+  {
+    small.parentNode.removeChild(small);
+  }
+  if ( (big) && YAHOO.util.Dom.hasClass(big, 'bz_default_hidden') )
+  {
+    big.parentNode.removeChild(big);
+  }
+}
+
+function toggle_attachment_details_visibility ( ) 
+{
+    // show hide classes
+    var container = document.getElementById('attachment_info');
+    if( YAHOO.util.Dom.hasClass(container, 'read') ){
+        YAHOO.util.Dom.replaceClass(container, 'read', 'edit');
+    }else{
+        YAHOO.util.Dom.replaceClass(container, 'edit', 'read');
+    }
+}
+
+/* Used in bug/create.html.tmpl to show/hide the attachment field. */
+
+function handleWantsAttachment(wants_attachment) {
+    if (wants_attachment) {
+        hideElementById('attachment_false');
+        showElementById('attachment_true');
+    }
+    else {
+        showElementById('attachment_false');
+        hideElementById('attachment_true');
+        clearAttachmentFields();
+    }
+}

diff --git a/js/bug.js b/js/bug.js
new file mode 100644 (file)
index 0000000..e38fefb
--- /dev/null
+++ b/js/bug.js
@@ -0,0 +1,120 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+/* This library assumes that the needed YUI libraries have been loaded 
+   already. */
+
+YAHOO.bugzilla.dupTable = {
+    counter: 0,
+    dataSource: null,
+    updateTable: function(dataTable, product_name, summary_field) {
+        if (summary_field.value.length < 4) return;
+
+        YAHOO.bugzilla.dupTable.counter = YAHOO.bugzilla.dupTable.counter + 1;
+        YAHOO.util.Connect.setDefaultPostHeader('application/json', true);
+        var json_object = {
+            version : "1.1",
+            method : "Bug.possible_duplicates",
+            id : YAHOO.bugzilla.dupTable.counter,
+            params : {
+                product : product_name,
+                summary : summary_field.value,
+                limit : 7,
+                include_fields : [ "id", "summary", "status", "resolution",
+                                   "update_token" ]
+            }
+        };
+        var post_data = YAHOO.lang.JSON.stringify(json_object);
+
+        var callback = {
+            success: dataTable.onDataReturnInitializeTable,
+            failure: dataTable.onDataReturnInitializeTable,
+            scope:   dataTable,
+            argument: dataTable.getState() 
+        };
+        dataTable.showTableMessage(dataTable.get("MSG_LOADING"),
+                                   YAHOO.widget.DataTable.CLASS_LOADING);
+        YAHOO.util.Dom.removeClass('possible_duplicates_container',
+                                   'bz_default_hidden');
+        dataTable.getDataSource().sendRequest(post_data, callback);
+    },
+    // This is the keyup event handler. It calls updateTable with a relatively
+    // long delay, to allow additional input. However, the delay is short
+    // enough that nobody could get from the summary field to the Submit
+    // Bug button before the table is shown (which is important, because
+    // the showing of the table causes the Submit Bug button to move, and
+    // if the table shows at the exact same time as the button is clicked,
+    // the click on the button won't register.)
+    doUpdateTable: function(e, args) {
+        var dt = args[0];
+        var product_name = args[1];
+        var summary = YAHOO.util.Event.getTarget(e);
+        clearTimeout(YAHOO.bugzilla.dupTable.lastTimeout);
+        YAHOO.bugzilla.dupTable.lastTimeout = setTimeout(function() {
+            YAHOO.bugzilla.dupTable.updateTable(dt, product_name, summary) },
+            600);
+    },
+    formatBugLink: function(el, oRecord, oColumn, oData) {
+        el.innerHTML = '<a href="show_bug.cgi?id=' + oData + '">' 
+                       + oData + '</a>';
+    },
+    formatStatus: function(el, oRecord, oColumn, oData) {
+        var resolution = oRecord.getData('resolution');
+        var bug_status = display_value('bug_status', oData);
+        if (resolution) {
+            el.innerHTML = bug_status + ' ' 
+                           + display_value('resolution', resolution);
+        }
+        else {
+            el.innerHTML = bug_status;
+        }
+    },
+    formatCcButton: function(el, oRecord, oColumn, oData) {
+        var url = 'process_bug.cgi?id=' + oRecord.getData('id') 
+                  + '&addselfcc=1&token=' + escape(oData);
+        var button = document.createElement('a');
+        button.setAttribute('href',  url);
+        button.innerHTML = YAHOO.bugzilla.dupTable.addCcMessage;
+        el.appendChild(button);
+        new YAHOO.widget.Button(button);
+    },
+    init_ds: function() {
+        var new_ds = new YAHOO.util.XHRDataSource("jsonrpc.cgi");
+        new_ds.connTimeout = 30000;
+        new_ds.connMethodPost = true;
+        new_ds.connXhrMode = "cancelStaleRequests";
+        new_ds.maxCacheEntries = 3;
+        new_ds.responseSchema = {
+            resultsList : "result.bugs",
+            metaFields : { error: "error", jsonRpcId: "id" }
+        };
+        // DataSource can't understand a JSON-RPC error response, so
+        // we have to modify the result data if we get one.
+        new_ds.doBeforeParseData = 
+            function(oRequest, oFullResponse, oCallback) {
+                if (oFullResponse.error) {
+                    oFullResponse.result = {};
+                    oFullResponse.result.bugs = [];
+                    if (console) {
+                        console.log("JSON-RPC error:", oFullResponse.error);
+                    }
+                }
+                return oFullResponse;
+        }
+
+        this.dataSource = new_ds;
+    },
+    init: function(data) {
+        if (this.dataSource == null) this.init_ds();
+        data.options.initialLoad = false;
+        var dt = new YAHOO.widget.DataTable(data.container, data.columns, 
+            this.dataSource, data.options); 
+        YAHOO.util.Event.on(data.summary_field, 'keyup', this.doUpdateTable,
+                            [dt, data.product_name]);
+    }
+};

diff --git a/js/change-columns.js b/js/change-columns.js
new file mode 100644 (file)
index 0000000..704905f
--- /dev/null
+++ b/js/change-columns.js
@@ -0,0 +1,132 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+function initChangeColumns() {
+    window.onunload = unload;
+    var av_select = document.getElementById("available_columns");
+    var sel_select = document.getElementById("selected_columns");
+    YAHOO.util.Dom.removeClass(
+        ['avail_header', av_select, 'select_button', 
+         'deselect_button', 'up_button', 'down_button'], 'bz_default_hidden');
+    switch_options(sel_select, av_select, false);
+    sel_select.selectedIndex = -1;
+    updateView();
+}
+
+function switch_options(from_box, to_box, selected) {
+    for (var i = 0; i<from_box.options.length; i++) {
+        var opt = from_box.options[i];
+        if (opt.selected == selected) {
+            var newopt = new Option(opt.text, opt.value, opt.defaultselected, opt.selected);
+            to_box.options[to_box.options.length] = newopt;
+            from_box.options[i] = null;
+            i = i - 1;
+        }
+        
+    }
+}
+
+function move_select() {
+    var av_select = document.getElementById("available_columns");
+    var sel_select = document.getElementById("selected_columns");
+    switch_options(av_select, sel_select, true);
+    updateView();
+}
+
+function move_deselect() {
+    var av_select = document.getElementById("available_columns");
+    var sel_select = document.getElementById("selected_columns");
+    switch_options(sel_select, av_select, true);
+    updateView();
+}
+
+function move_up() {
+    var sel_select = document.getElementById("selected_columns");
+    var last = sel_select.options[0];
+    var dummy = new Option("", "", false, false);
+    for (var i = 1; i<sel_select.options.length; i++) {
+        var opt = sel_select.options[i];
+        if (opt.selected) {
+            sel_select.options[i] = dummy;
+            sel_select.options[i-1] = opt;
+            sel_select.options[i] = last;
+        }
+        else{
+            last = opt;
+        }        
+    }
+    updateView();
+}
+
+function move_down() {
+    var sel_select = document.getElementById("selected_columns");
+    var last = sel_select.options[sel_select.options.length-1];
+    var dummy = new Option("", "", false, false);
+    for (var i = sel_select.options.length-2; i >= 0; i--) {
+        var opt = sel_select.options[i];
+        if (opt.selected) {
+            sel_select.options[i] = dummy;
+            sel_select.options[i + 1] = opt;
+            sel_select.options[i] = last;
+        }
+        else{
+            last = opt;
+        }        
+    }
+    updateView();
+}
+
+function updateView() {
+    var select_button = document.getElementById("select_button");
+    var deselect_button = document.getElementById("deselect_button");
+    var up_button = document.getElementById("up_button");
+    var down_button = document.getElementById("down_button");
+    select_button.disabled = true;
+    deselect_button.disabled = true;
+    up_button.disabled = true;
+    down_button.disabled = true;
+    var av_select = document.getElementById("available_columns");
+    var sel_select = document.getElementById("selected_columns");
+    for (var i = 0; i < av_select.options.length;  i++) {
+        if (av_select.options[i].selected) {
+            select_button.disabled = false;
+            break;
+        }
+    }
+    for (var i = 0; i < sel_select.options.length; i++) {
+        if (sel_select.options[i].selected) {
+            deselect_button.disabled = false;
+            up_button.disabled = false;
+            down_button.disabled = false;
+            break;
+        }
+    }
+    if (sel_select.options.length > 0) {
+        if (sel_select.options[0].selected) {
+            up_button.disabled = true;
+        }
+        if (sel_select.options[sel_select.options.length - 1].selected) {
+            down_button.disabled = true;
+        }
+    }
+}
+
+function change_submit() {
+    var sel_select = document.getElementById("selected_columns");
+    for (var i = 0; i < sel_select.options.length; i++) {
+        sel_select.options[i].selected = true;
+    }
+    return false;
+}
+
+function unload() {
+       var sel_select = document.getElementById("selected_columns");
+    for (var i = 0; i < sel_select.options.length; i++) {
+        sel_select.options[i].selected = true;
+    }
+}

diff --git a/js/comments.js b/js/comments.js
new file mode 100644 (file)
index 0000000..acf5dbf
--- /dev/null
+++ b/js/comments.js
@@ -0,0 +1,157 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+function updateCommentPrivacy(checkbox, id) {
+    var comment_elem = document.getElementById('comment_text_'+id).parentNode;
+    if (checkbox.checked) {
+      if (!comment_elem.className.match('bz_private')) {
+        comment_elem.className = comment_elem.className.concat(' bz_private');
+      }
+    }
+    else {
+      comment_elem.className =
+        comment_elem.className.replace(/(\s*|^)bz_private(\s*|$)/, '$2');
+    }
+}
+
+/* The functions below expand and collapse comments  */
+
+function toggle_comment_display(link, comment_id) {
+    var comment = document.getElementById('comment_text_' + comment_id);
+    var re = new RegExp(/\bcollapsed\b/);
+    if (comment.className.match(re))
+        expand_comment(link, comment);
+    else
+        collapse_comment(link, comment);
+}
+
+function toggle_all_comments(action) {
+    // If for some given ID the comment doesn't exist, this doesn't mean
+    // there are no more comments, but that the comment is private and
+    // the user is not allowed to view it.
+
+    var comments = YAHOO.util.Dom.getElementsByClassName('bz_comment_text');
+    for (var i = 0; i < comments.length; i++) {
+        var comment = comments[i];
+        if (!comment)
+            continue;
+
+        var id = comments[i].id.match(/\d*$/);
+        var link = document.getElementById('comment_link_' + id);
+        if (action == 'collapse')
+            collapse_comment(link, comment);
+        else
+            expand_comment(link, comment);
+    }
+}
+
+function collapse_comment(link, comment) {
+    link.innerHTML = "[+]";
+    YAHOO.util.Dom.addClass(comment, 'collapsed');
+}
+
+function expand_comment(link, comment) {
+    link.innerHTML = "[&minus;]";
+    YAHOO.util.Dom.removeClass(comment, 'collapsed');
+}
+
+function wrapReplyText(text) {
+    // This is -3 to account for "\n> "
+    var maxCol = BUGZILLA.constant.COMMENT_COLS - 3;
+    var text_lines = text.replace(/[\s\n]+$/, '').split("\n");
+    var wrapped_lines = new Array();
+
+    for (var i = 0; i < text_lines.length; i++) {
+        var paragraph = text_lines[i];
+        // Don't wrap already-quoted text.
+        if (paragraph.indexOf('>') == 0) {
+            wrapped_lines.push('> ' + paragraph);
+            continue;
+        }
+
+        var replace_lines = new Array();
+        while (paragraph.length > maxCol) {
+            var testLine = paragraph.substring(0, maxCol);
+            var pos = testLine.search(/\s\S*$/);
+
+            if (pos < 1) {
+                // Try to find some ASCII punctuation that's reasonable
+                // to break on.
+                var punct = '\\-\\./,!;:';
+                var punctRe = new RegExp('[' + punct + '][^' + punct + ']+$');
+                pos = testLine.search(punctRe) + 1;
+                // Try to find some CJK Punctuation that's reasonable
+                // to break on.
+                if (pos == 0)
+                    pos = testLine.search(/[\u3000\u3001\u3002\u303E\u303F]/) + 1;
+                // If we can't find any break point, we simply break long
+                // words. This makes long, punctuation-less CJK text wrap,
+                // even if it wraps incorrectly.
+                if (pos == 0) pos = maxCol;
+            }
+
+            var wrapped_line = paragraph.substring(0, pos);
+            replace_lines.push(wrapped_line);
+            paragraph = paragraph.substring(pos);
+            // Strip whitespace from the start of the line
+            paragraph = paragraph.replace(/^\s+/, '');
+        }
+        replace_lines.push(paragraph);
+        wrapped_lines.push("> " + replace_lines.join("\n> "));
+    }
+    return wrapped_lines.join("\n") + "\n\n";
+}
+
+/* This way, we are sure that browsers which do not support JS
+   * won't display this link  */
+
+function addCollapseLink(count, title) {
+    document.write(' <a href="#" class="bz_collapse_comment"' +
+                   ' id="comment_link_' + count +
+                   '" onclick="toggle_comment_display(this, ' +  count +
+                   '); return false;" title="' + title + '">[&minus;]<\/a> ');
+}
+
+function goto_add_comments( anchor ){
+    anchor =  (anchor || "add_comment");
+    // we need this line to expand the comment box
+    document.getElementById('comment').focus();
+    setTimeout(function(){ 
+        document.location.hash = anchor;
+        // firefox doesn't seem to keep focus through the anchor change
+        document.getElementById('comment').focus();
+    },10);
+    return false;
+}
+
+if (typeof Node == 'undefined') {
+    /* MSIE doesn't define Node, so provide a compatibility object */
+    window.Node = {
+        TEXT_NODE: 3,
+        ENTITY_REFERENCE_NODE: 5
+    };
+}
+
+/* Concatenates all text from element's childNodes. This is used
+ * instead of innerHTML because we want the actual text (and
+ * innerText is non-standard).
+ */
+function getText(element) {
+    var child, text = "";
+    for (var i=0; i < element.childNodes.length; i++) {
+        child = element.childNodes[i];
+        var type = child.nodeType;
+        if (type == Node.TEXT_NODE || type == Node.ENTITY_REFERENCE_NODE) {
+            text += child.nodeValue;
+        } else {
+            /* recurse into nodes of other types */
+            text += getText(child);
+        }
+    }
+    return text;
+}

diff --git a/js/custom-search.js b/js/custom-search.js
new file mode 100644 (file)
index 0000000..61284c5
--- /dev/null
+++ b/js/custom-search.js
@@ -0,0 +1,344 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+var PAREN_INDENT_EM = 2;
+var ANY_ALL_SELECT_CLASS = 'any_all_select';
+
+// When somebody chooses to "Hide Advanced Features" for Custom Search,
+// we don't want to hide "Not" checkboxes if they've been checked. We
+// accomplish this by removing the custom_search_advanced class from Not
+// checkboxes when they are checked.
+//
+// We never add the custom_search_advanced class back. If we did, TUI
+// would get confused in this case: Check Not, Hide Advanced Features,
+// Uncheck Not, Show Advanced Features. (It hides "Not" when it shouldn't.)
+function custom_search_not_changed(id) {
+    var container = document.getElementById('custom_search_not_container_' + id);
+    YAHOO.util.Dom.removeClass(container, 'custom_search_advanced');
+
+    fix_query_string(container);
+}
+
+function custom_search_new_row() {
+    var row = document.getElementById('custom_search_last_row');
+    var clone = row.cloneNode(true);
+    
+    _cs_fix_row_ids(clone);
+   
+    // We only want one copy of the buttons, in the new row. So the old
+    // ones get deleted.
+    var op_button = document.getElementById('op_button');
+    row.removeChild(op_button);
+    var cp_button = document.getElementById('cp_container');
+    row.removeChild(cp_button);
+    var add_button = document.getElementById('add_button');
+    row.removeChild(add_button);
+    _remove_any_all(clone);
+
+    // Always make sure there's only one row with this id.
+    row.id = null;
+    row.parentNode.appendChild(clone);
+    cs_reconfigure(row);
+    fix_query_string(row);
+    return clone;
+}
+
+var _cs_source_any_all;
+function custom_search_open_paren() {
+    var row = document.getElementById('custom_search_last_row');
+
+    // create a copy of j_top and use that as the source, so we can modify
+    // j_top if required
+    if (!_cs_source_any_all) {
+        var j_top = document.getElementById('j_top');
+        _cs_source_any_all = j_top.cloneNode(true);
+    }
+
+    // find the parent any/all select, and remove the grouped option
+    var structure = _cs_build_structure(row);
+    var old_id = _cs_get_row_id(row);
+    var parent_j = document.getElementById(_cs_get_join(structure, 'f' + old_id));
+    _cs_remove_and_g(parent_j);
+
+    // If there's an "Any/All" select in this row, it needs to stay as
+    // part of the parent paren set.
+    var old_any_all = _remove_any_all(row);
+    if (old_any_all) {
+        var any_all_row = row.cloneNode(false);
+        any_all_row.id = null;
+        any_all_row.appendChild(old_any_all);
+        row.parentNode.insertBefore(any_all_row, row);
+    }
+
+    // We also need a "Not" checkbox to stay in the parent paren set.
+    var new_not = YAHOO.util.Dom.getElementsByClassName(
+        'custom_search_not_container', null, row);
+    var not_for_paren = new_not[0].cloneNode(true);
+
+    // Preserve the values when modifying the row.
+    var id = _cs_fix_row_ids(row, true);
+    var prev_id = id - 1;
+
+    var paren_row = row.cloneNode(false);
+    paren_row.id = null;
+    paren_row.innerHTML = '(<input type="hidden" name="f' + prev_id
+                        + '" id="f' + prev_id + '" value="OP">';
+    paren_row.insertBefore(not_for_paren, paren_row.firstChild);
+    row.parentNode.insertBefore(paren_row, row);
+
+    // New paren set needs a new "Any/All" select.
+    var any_all_container = document.createElement('div');
+    YAHOO.util.Dom.addClass(any_all_container, ANY_ALL_SELECT_CLASS);
+    var any_all = _cs_source_any_all.cloneNode(true);
+    any_all.name = 'j' + prev_id;
+    any_all.id = any_all.name;
+    any_all_container.appendChild(any_all);
+    row.insertBefore(any_all_container, row.firstChild);
+
+    var margin = YAHOO.util.Dom.getStyle(row, 'margin-left');
+    var int_match = margin.match(/\d+/);
+    var new_margin = parseInt(int_match[0]) + PAREN_INDENT_EM;
+    YAHOO.util.Dom.setStyle(row, 'margin-left', new_margin + 'em');
+    YAHOO.util.Dom.removeClass('cp_container', 'bz_default_hidden');
+
+    cs_reconfigure(any_all_container);
+    fix_query_string(any_all_container);
+}
+
+function custom_search_close_paren() {
+    var new_row = custom_search_new_row();
+    
+    // We need to up the new row's id by one more, because we're going
+    // to insert a "CP" before it.
+    var id = _cs_fix_row_ids(new_row);
+
+    var margin = YAHOO.util.Dom.getStyle(new_row, 'margin-left');
+    var int_match = margin.match(/\d+/);
+    var new_margin = parseInt(int_match[0]) - PAREN_INDENT_EM;
+    YAHOO.util.Dom.setStyle(new_row, 'margin-left', new_margin + 'em');
+
+    var paren_row = new_row.cloneNode(false);
+    paren_row.id = null;
+    paren_row.innerHTML = ')<input type="hidden" name="f' + (id - 1)
+                        + '" id="f' + (id - 1) + '" value="CP">';
+  
+    new_row.parentNode.insertBefore(paren_row, new_row);
+
+    if (new_margin == 0) {
+        YAHOO.util.Dom.addClass('cp_container', 'bz_default_hidden');
+    }
+
+    cs_reconfigure(new_row);
+    fix_query_string(new_row);
+}
+
+// When a user goes Back in their browser after searching, some browsers
+// (Chrome, as of September 2011) do not remember the DOM that was created
+// by the Custom Search JS. (In other words, their whole entered Custom
+// Search disappears.) The solution is to update the History object,
+// using the query string, which query.cgi can read to re-create the page
+// exactly as the user had it before.
+function fix_query_string(form_member) {
+    // window.History comes from history.js.
+    // It falls back to the normal window.history object for HTML5 browsers.
+    if (!(window.History && window.History.replaceState))
+        return;
+
+    var form = YAHOO.util.Dom.getAncestorByTagName(form_member, 'form');
+    // Disable the token field so setForm doesn't include it
+    var reenable_token = false;
+    if (form['token'] && !form['token'].disabled) {
+      form['token'].disabled = true;
+      reenable_token = true;
+    }
+    var query = YAHOO.util.Connect.setForm(form);
+    if (reenable_token)
+      form['token'].disabled = false;
+    window.History.replaceState(null, document.title, '?' + query);
+}
+
+// Browsers that do not support HTML5's history.replaceState gain an emulated
+// version via history.js, with the full query_string in the location's hash.
+// We rewrite the URL to include the hash and redirect to the new location,
+// which causes custom search fields to work.
+function redirect_html4_browsers() {
+    var hash = document.location.hash;
+    if (hash == '') return;
+    hash = hash.substring(1);
+    if (hash.substring(0, 10) != 'query.cgi?') return;
+    var url = document.location + "";
+    url = url.substring(0, url.indexOf('query.cgi#')) + hash;
+    document.location = url;
+}
+
+function _cs_fix_row_ids(row, preserve_values) {
+    // Update the label of the checkbox.
+    var label = YAHOO.util.Dom.getElementBy(function() { return true }, 'label', row);
+    var id_match = label.htmlFor.match(/\d+$/);
+    var id = parseInt(id_match[0]) + 1;
+    label.htmlFor = label.htmlFor.replace(/\d+$/, id);
+
+    // Sets all the inputs in the row back to their default
+    // and fixes their id.
+    var fields =
+        YAHOO.util.Dom.getElementsByClassName('custom_search_form_field', null, row);
+    for (var i = 0; i < fields.length; i++) {
+        var field = fields[i];
+
+        if (!preserve_values) {
+            if (field.type == "checkbox") {
+                field.checked = false;
+            }
+            else {
+                field.value = '';
+            }
+        }
+
+        // Update the numeric id for the row.
+        field.name = field.name.replace(/\d+$/, id);
+        field.id = field.name;
+    }
+
+    return id;
+}
+
+function _cs_build_structure(form_member) {
+    // build a map of the structure of the custom fields
+    var form = YAHOO.util.Dom.getAncestorByTagName(form_member, 'form');
+    var last_id = _get_last_cs_row_id(form);
+    var structure = [ 'j_top' ];
+    var nested = [ structure ];
+    for (var id = 1; id <= last_id; id++) {
+        var f = form['f' + id];
+        if (!f || !f.parentNode.parentNode) continue;
+
+        if (f.value == 'OP') {
+            var j = [ 'j' + id ];
+            nested[nested.length - 1].push(j);
+            nested.push(j);
+            continue;
+        } else if (f.value == 'CP') {
+            nested.pop();
+            continue;
+        } else {
+            nested[nested.length - 1].push('f' + id);
+        }
+    }
+    return structure;
+}
+
+function cs_reconfigure(form_member) {
+    var structure = _cs_build_structure(form_member);
+    _cs_add_listeners(structure);
+    _cs_trigger_j_listeners(structure);
+    fix_query_string(form_member);
+
+    var j = _cs_get_join(structure, 'f' + _get_last_cs_row_id());
+    document.getElementById('op_button').disabled = document.getElementById(j).value == 'AND_G';
+}
+
+function _cs_add_listeners(parents) {
+    for (var i = 0, l = parents.length; i < l; i++) {
+        if (typeof(parents[i]) == 'object') {
+            // nested
+            _cs_add_listeners(parents[i]);
+        } else if (i == 0) {
+            // joiner
+            YAHOO.util.Event.removeListener(parents[i], 'change', _cs_j_change);
+            YAHOO.util.Event.addListener(parents[i], 'change', _cs_j_change, parents);
+        } else {
+            // field
+            YAHOO.util.Event.removeListener(parents[i], 'change', _cs_f_change);
+            YAHOO.util.Event.addListener(parents[i], 'change', _cs_f_change, parents);
+        }
+    }
+}
+
+function _cs_trigger_j_listeners(fields) {
+    var has_children = false;
+    for (var i = 0, l = fields.length; i < l; i++) {
+        if (typeof(fields[i]) == 'undefined') {
+            continue;
+        } else if (typeof(fields[i]) == 'object') {
+            // nested
+            _cs_trigger_j_listeners(fields[i]);
+            has_children = true;
+        } else if (i == 0) {
+            _cs_j_change(undefined, fields);
+        }
+    }
+    if (has_children) {
+        _cs_remove_and_g(document.getElementById(fields[0]));
+    }
+}
+
+function _cs_get_join(parents, field) {
+    for (var i = 0, l = parents.length; i < l; i++) {
+        if (typeof(parents[i]) == 'object') {
+            // nested
+            var result = _cs_get_join(parents[i], field);
+            if (result) return result;
+        } else if (parents[i] == field) {
+            return parents[0];
+        }
+    }
+    return false;
+}
+
+function _cs_remove_and_g(join_field) {
+    var index = bz_optionIndex(join_field, 'AND_G');
+    join_field.options[index] = null;
+    join_field.options[bz_optionIndex(join_field, 'AND')].innerHTML = cs_and_label;
+    join_field.options[bz_optionIndex(join_field, 'OR')].innerHTML = cs_or_label;
+}
+
+function _cs_j_change(evt, fields, field) {
+    var j = document.getElementById(fields[0]);
+    if (j && j.value == 'AND_G') {
+        for (var i = 1, l = fields.length; i < l; i++) {
+            if (typeof(fields[i]) == 'object') continue;
+            if (!field) {
+                field = document.getElementById(fields[i]).value;
+            } else {
+                document.getElementById(fields[i]).value = field;
+            }
+        }
+        if (evt) {
+            fix_query_string(j);
+        }
+        if ('f' + _get_last_cs_row_id() == fields[fields.length - 1]) {
+            document.getElementById('op_button').style.display = 'none';
+        }
+    } else {
+        document.getElementById('op_button').style.display = '';
+    }
+}
+
+function _cs_f_change(evt, args) {
+    var field = YAHOO.util.Event.getTarget(evt);
+    _cs_j_change(evt, args, field.value);
+}
+
+function _get_last_cs_row_id() {
+    return _cs_get_row_id('custom_search_last_row');
+}
+
+function _cs_get_row_id(row) {
+    var label = YAHOO.util.Dom.getElementBy(function() { return true }, 'label', row);
+    return parseInt(label.htmlFor.match(/\d+$/)[0]);
+}
+
+function _remove_any_all(parent) {
+    var any_all = YAHOO.util.Dom.getElementsByClassName(
+        ANY_ALL_SELECT_CLASS, null, parent);
+    if (any_all[0]) {
+        parent.removeChild(any_all[0]);
+        return any_all[0];
+    }
+    return null;
+}

diff --git a/js/expanding-tree.js b/js/expanding-tree.js
new file mode 100644 (file)
index 0000000..02b1ed7
--- /dev/null
+++ b/js/expanding-tree.js
@@ -0,0 +1,142 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+if (!Node) {
+    // MSIE doesn't define Node, so provide a compatibility object
+    var Node = { TEXT_NODE: 3 }
+}
+
+if (!highlighted) {
+    var highlighted = 0;
+    var highlightedclass = "";
+    var highlightedover = 0;
+}
+
+function doToggle(node, event) {
+    var deep = event.altKey || event.ctrlKey;
+
+    if (node.nodeType == Node.TEXT_NODE)
+        node = node.parentNode;
+
+    var toggle = node.nextSibling;
+    while (toggle && toggle.tagName != "UL")
+        toggle = toggle.nextSibling;
+
+    if (toggle) {
+        if (deep) {
+            var direction = toggleDisplay(toggle, node);
+            changeChildren(toggle, direction);
+        } else {
+            toggleDisplay(toggle, node);
+        }
+    }
+    /* avoid problems with default actions on links (mozilla's
+     * ctrl/shift-click defaults, for instance */
+    event.preventBubble();
+    event.preventDefault();
+    return false;
+}
+
+function changeChildren(node, direction) {
+    var item = node.firstChild;
+    while (item) {
+        /* find the LI inside the UL I got */
+        while (item && item.tagName != "LI")
+            item = item.nextSibling;
+        if (!item)
+            return;
+
+        /* got it, now find the first A */
+        var child = item.firstChild;
+        while (child && child.tagName != "A")
+            child = child.nextSibling;
+        if (!child) {
+            return
+        }
+        var bullet = child;
+
+        /* and check if it has its own sublist */
+        var sublist = item.firstChild;
+        while (sublist && sublist.tagName != "UL")
+            sublist = sublist.nextSibling;
+        if (sublist) {
+            if (direction && isClosed(sublist)) {
+                openNode(sublist, bullet);
+            } else if (!direction && !isClosed(sublist)) {
+                closeNode(sublist, bullet);
+            }
+            changeChildren(sublist, direction)
+        }
+        item = item.nextSibling;
+    }
+}
+
+function openNode(node, bullet) {
+    node.style.display = "block";
+    bullet.className = "b b_open";
+}
+
+function closeNode(node, bullet) {
+    node.style.display = "none";
+    bullet.className = "b b_closed";
+}
+
+function isClosed(node) {
+    /* XXX we should in fact check our *computed* style, not the display
+     * attribute of the current node, which may be inherited and not
+     * set. However, this really only matters when changing the default
+     * appearance of the tree through a parent style. */
+    return node.style.display == "none";
+}
+
+function toggleDisplay(node, bullet) {
+    if (isClosed(node)) {
+        openNode(node, bullet);
+        return true;
+    }
+
+    closeNode(node, bullet);
+    return false;
+}
+
+function duplicated(element) {
+    var allsumm= document.getElementsByTagName("span");
+    if (highlighted) {
+        for (i = 0;i < allsumm.length; i++) {
+            if (allsumm.item(i).id == highlighted) {
+                allsumm.item(i).className = highlightedclass;
+            }
+        }
+        if (highlighted == element) {
+            highlighted = 0;
+            return;
+        }
+    } 
+    highlighted = element;
+    var elem = document.getElementById(element);
+    highlightedclass = elem.className;
+    for (var i = 0;i < allsumm.length; i++) {
+        if (allsumm.item(i).id == element) {
+            allsumm.item(i).className = "summ_h";
+        }
+    }
+}
+
+function duplicatedover(element) {
+    if (!highlighted) {
+        highlightedover = 1;
+        duplicated(element);
+    }
+}
+
+function duplicatedout(element) {
+    if (highlighted == element && highlightedover) {
+        highlightedover = 0;
+        duplicated(element);
+    }
+}

diff --git a/js/field.js b/js/field.js
new file mode 100644 (file)
index 0000000..c0d0aaa
--- /dev/null
+++ b/js/field.js
@@ -0,0 +1,983 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+/* This library assumes that the needed YUI libraries have been loaded 
+   already. */
+
+var bz_no_validate_enter_bug = false;
+function validateEnterBug(theform) {
+    // This is for the "bookmarkable templates" button.
+    if (bz_no_validate_enter_bug) {
+        // Set it back to false for people who hit the "back" button
+        bz_no_validate_enter_bug = false;
+        return true;
+    }
+
+    var component = theform.component;
+    var short_desc = theform.short_desc;
+    var version = theform.version;
+    var bug_status = theform.bug_status;
+    var description = theform.comment;
+    var attach_data = theform.data;
+    var attach_desc = theform.description;
+
+    var current_errors = YAHOO.util.Dom.getElementsByClassName(
+        'validation_error_text', null, theform);
+    for (var i = 0; i < current_errors.length; i++) {
+        current_errors[i].parentNode.removeChild(current_errors[i]);
+    }
+    var current_error_fields = YAHOO.util.Dom.getElementsByClassName(
+        'validation_error_field', null, theform);
+    for (var i = 0; i < current_error_fields.length; i++) {
+        var field = current_error_fields[i];
+        YAHOO.util.Dom.removeClass(field, 'validation_error_field');
+    }
+
+    var focus_me;
+
+    // These are checked in the reverse order that they appear on the page,
+    // so that the one closest to the top of the form will be focused.
+    if (attach_data.value && YAHOO.lang.trim(attach_desc.value) == '') {
+        _errorFor(attach_desc, 'attach_desc');
+        focus_me = attach_desc;
+    }
+    var check_description = status_comment_required[bug_status.value];
+    if (check_description && YAHOO.lang.trim(description.value) == '') {
+        _errorFor(description, 'description');
+        focus_me = description;
+    }
+    if (YAHOO.lang.trim(short_desc.value) == '') {
+        _errorFor(short_desc);
+        focus_me = short_desc;
+    }
+    if (version.selectedIndex < 0) {
+        _errorFor(version);
+        focus_me = version;
+    }
+    if (component.selectedIndex < 0) {
+        _errorFor(component);
+        focus_me = component;
+    }
+
+    if (focus_me) {
+        focus_me.focus();
+        return false;
+    }
+
+    return true;
+}
+
+function _errorFor(field, name) {
+    if (!name) name = field.id;
+    var string_name = name + '_required';
+    var error_text = BUGZILLA.string[string_name];
+    var new_node = document.createElement('div');
+    YAHOO.util.Dom.addClass(new_node, 'validation_error_text');
+    new_node.innerHTML = error_text;
+    YAHOO.util.Dom.insertAfter(new_node, field);
+    YAHOO.util.Dom.addClass(field, 'validation_error_field');
+}
+
+/* This function is never to be called directly, but only indirectly
+ * using template/en/default/global/calendar.js.tmpl, so that localization
+ * works. For the same reason, if you modify this function's parameter list,
+ * you need to modify the documentation in said template as well. */
+function createCalendar(name, start_weekday, months_long, weekdays_short) {
+    var cal = new YAHOO.widget.Calendar('calendar_' + name, 
+                                        'con_calendar_' + name,
+                                        { START_WEEKDAY:  start_weekday,
+                                          MONTHS_LONG:    months_long,
+                                          WEEKDAYS_SHORT: weekdays_short
+                                        });
+    YAHOO.bugzilla['calendar_' + name] = cal;
+    var field = document.getElementById(name);
+    cal.selectEvent.subscribe(setFieldFromCalendar, field, false);
+    updateCalendarFromField(field);
+    cal.render();
+}
+
+/* The onclick handlers for the button that shows the calendar. */
+function showCalendar(field_name) {
+    var calendar  = YAHOO.bugzilla["calendar_" + field_name];
+    var field     = document.getElementById(field_name);
+    var button    = document.getElementById('button_calendar_' + field_name);
+
+    bz_overlayBelow(calendar.oDomContainer, field);
+    calendar.show();
+    button.onclick = function() { hideCalendar(field_name); };
+
+    // Because of the way removeListener works, this has to be a function
+    // attached directly to this calendar.
+    calendar.bz_myBodyCloser = function(event) {
+        var container = this.oDomContainer;
+        var target    = YAHOO.util.Event.getTarget(event);
+        if (target != container && target != button
+            && !YAHOO.util.Dom.isAncestor(container, target))
+        {
+            hideCalendar(field_name);
+        }
+    };
+
+    // If somebody clicks outside the calendar, hide it.
+    YAHOO.util.Event.addListener(document.body, 'click', 
+                                 calendar.bz_myBodyCloser, calendar, true);
+
+    // Make Esc close the calendar.
+    calendar.bz_escCal = function (event) {
+        var key = YAHOO.util.Event.getCharCode(event);
+        if (key == 27) {
+            hideCalendar(field_name);
+        }
+    };
+    YAHOO.util.Event.addListener(document.body, 'keydown', calendar.bz_escCal);
+}
+
+function hideCalendar(field_name) {
+    var cal = YAHOO.bugzilla["calendar_" + field_name];
+    cal.hide();
+    var button = document.getElementById('button_calendar_' + field_name);
+    button.onclick = function() { showCalendar(field_name); };
+    YAHOO.util.Event.removeListener(document.body, 'click',
+                                    cal.bz_myBodyCloser);
+    YAHOO.util.Event.removeListener(document.body, 'keydown', cal.bz_escCal);
+}
+
+/* This is the selectEvent for our Calendar objects on our custom 
+ * DateTime fields.
+ */
+function setFieldFromCalendar(type, args, date_field) {
+    var dates = args[0];
+    var setDate = dates[0];
+
+    // We can't just write the date straight into the field, because there 
+    // might already be a time there.
+    var timeRe = /\b(\d{1,2}):(\d\d)(?::(\d\d))?/;
+    var currentTime = timeRe.exec(date_field.value);
+    var d = new Date(setDate[0], setDate[1] - 1, setDate[2]);
+    if (currentTime) {
+        d.setHours(currentTime[1], currentTime[2]);
+        if (currentTime[3]) {
+            d.setSeconds(currentTime[3]);
+        }
+    }
+
+    var year = d.getFullYear();
+    // JavaScript's "Date" represents January as 0 and December as 11.
+    var month = d.getMonth() + 1;
+    if (month < 10) month = '0' + String(month);
+    var day = d.getDate();
+    if (day < 10) day = '0' + String(day);
+    var dateStr = year + '-' + month  + '-' + day;
+
+    if (currentTime) {
+        var minutes = d.getMinutes();
+        if (minutes < 10) minutes = '0' + String(minutes);
+        var seconds = d.getSeconds();
+        if (seconds > 0 && seconds < 10) {
+            seconds = '0' + String(seconds);
+        }
+
+        dateStr = dateStr + ' ' + d.getHours() + ':' + minutes;
+        if (seconds) dateStr = dateStr + ':' + seconds;
+    }
+
+    date_field.value = dateStr;
+    hideCalendar(date_field.id);
+}
+
+/* Sets the calendar based on the current field value. 
+ */ 
+function updateCalendarFromField(date_field) {
+    var dateRe = /(\d\d\d\d)-(\d\d?)-(\d\d?)/;
+    var pieces = dateRe.exec(date_field.value);
+    if (pieces) {
+        var cal = YAHOO.bugzilla["calendar_" + date_field.id];
+        cal.select(new Date(pieces[1], pieces[2] - 1, pieces[3]));
+        var selectedArray = cal.getSelectedDates();
+        var selected = selectedArray[0];
+        cal.cfg.setProperty("pagedate", (selected.getMonth() + 1) + '/' 
+                                        + selected.getFullYear());
+        cal.render();
+    }
+}
+
+function setupEditLink(id) {
+    var link_container = 'container_showhide_' + id;
+    var input_container = 'container_' + id;
+    var link = 'showhide_' + id;
+    hideEditableField(link_container, input_container, link);
+}
+
+/* Hide input/select fields and show the text with (edit) next to it */
+function hideEditableField( container, input, action, field_id, original_value, new_value ) {
+    YAHOO.util.Dom.removeClass(container, 'bz_default_hidden');
+    YAHOO.util.Dom.addClass(input, 'bz_default_hidden');
+    YAHOO.util.Event.addListener(action, 'click', showEditableField,
+                                 new Array(container, input, field_id, new_value));
+    if(field_id != ""){
+        YAHOO.util.Event.addListener(window, 'load', checkForChangedFieldValues,
+                        new Array(container, input, field_id, original_value));
+    }
+}
+
+/* showEditableField (e, ContainerInputArray)
+ * Function hides the (edit) link and the text and displays the input/select field
+ *
+ * var e: the event
+ * var ContainerInputArray: An array containing the (edit) and text area and the input being displayed
+ * var ContainerInputArray[0]: the container that will be hidden usually shows the (edit) or (take) text
+ * var ContainerInputArray[1]: the input area and label that will be displayed
+ * var ContainerInputArray[2]: the input/select field id for which the new value must be set
+ * var ContainerInputArray[3]: the new value to set the input/select field to when (take) is clicked
+ */
+function showEditableField (e, ContainerInputArray) {
+    var inputs = new Array();
+    var inputArea = YAHOO.util.Dom.get(ContainerInputArray[1]);    
+    if ( ! inputArea ){
+        YAHOO.util.Event.preventDefault(e);
+        return;
+    }
+    YAHOO.util.Dom.addClass(ContainerInputArray[0], 'bz_default_hidden');
+    YAHOO.util.Dom.removeClass(inputArea, 'bz_default_hidden');
+    if ( inputArea.tagName.toLowerCase() == "input" ) {
+        inputs.push(inputArea);
+    } else if (ContainerInputArray[2]) {
+        inputs.push(document.getElementById(ContainerInputArray[2]));
+    } else {
+        inputs = inputArea.getElementsByTagName('input');
+    }
+    if ( inputs.length > 0 ) {
+        // Change the first field's value to ContainerInputArray[2]
+        // if present before focusing.
+        var type = inputs[0].tagName.toLowerCase();
+        if (ContainerInputArray[3]) {
+            if ( type == "input" ) {
+                inputs[0].value = ContainerInputArray[3];
+            } else {
+                for (var i = 0; inputs[0].length; i++) {
+                    if ( inputs[0].options[i].value == ContainerInputArray[3] ) {
+                        inputs[0].options[i].selected = true;
+                        break;
+                    }
+                }
+            }
+        }
+        // focus on the first field, this makes it easier to edit
+        inputs[0].focus();
+        if ( type == "input" ) {
+            inputs[0].select();
+        }
+    }
+    YAHOO.util.Event.preventDefault(e);
+}
+
+
+/* checkForChangedFieldValues(e, array )
+ * Function checks if after the autocomplete by the browser if the values match the originals.
+ *   If they don't match then hide the text and show the input so users don't get confused.
+ *
+ * var e: the event
+ * var ContainerInputArray: An array containing the (edit) and text area and the input being displayed
+ * var ContainerInputArray[0]: the conainer that will be hidden usually shows the (edit) text
+ * var ContainerInputArray[1]: the input area and label that will be displayed
+ * var ContainerInputArray[2]: the field that is on the page, might get changed by browser autocomplete 
+ * var ContainerInputArray[3]: the original value from the page loading.
+ *
+ */  
+function checkForChangedFieldValues(e, ContainerInputArray ) {
+    var el = document.getElementById(ContainerInputArray[2]);
+    var unhide = false;
+    if ( el ) {
+        if ( el.value != ContainerInputArray[3] ||
+            ( el.value == "" && el.id != "alias" && el.id != 'qa_contact') ) {
+            unhide = true;
+        }
+        else {
+            var set_default = document.getElementById("set_default_" +
+                                                      ContainerInputArray[2]);
+            if ( set_default ) {
+                if(set_default.checked){
+                    unhide = true;
+                }              
+            }
+        }
+    }
+    if(unhide){
+        YAHOO.util.Dom.addClass(ContainerInputArray[0], 'bz_default_hidden');
+        YAHOO.util.Dom.removeClass(ContainerInputArray[1], 'bz_default_hidden');
+    }
+
+}
+
+function hideAliasAndSummary(short_desc_value, alias_value) {
+    // check the short desc field
+    hideEditableField( 'summary_alias_container','summary_alias_input',
+                       'editme_action','short_desc', short_desc_value);  
+    // check that the alias hasn't changed
+    var bz_alias_check_array = new Array('summary_alias_container',
+                                     'summary_alias_input', 'alias', alias_value);
+    YAHOO.util.Event.addListener( window, 'load', checkForChangedFieldValues,
+                                 bz_alias_check_array);
+}
+
+function showPeopleOnChange( field_id_list ) {
+    for(var i = 0; i < field_id_list.length; i++) {
+        YAHOO.util.Event.addListener( field_id_list[i],'change', showEditableField,
+                                      new Array('bz_qa_contact_edit_container',
+                                                'bz_qa_contact_input'));
+        YAHOO.util.Event.addListener( field_id_list[i],'change',showEditableField,
+                                      new Array('bz_assignee_edit_container',
+                                                'bz_assignee_input'));
+    }
+}
+
+function assignToDefaultOnChange(field_id_list, default_assignee, default_qa_contact) {
+    showPeopleOnChange(field_id_list);
+    for(var i = 0, l = field_id_list.length; i < l; i++) {
+        YAHOO.util.Event.addListener(field_id_list[i], 'change', function(evt, defaults) {
+            if (document.getElementById('assigned_to').value == defaults[0]) {
+                setDefaultCheckbox(evt, 'set_default_assignee');
+            }
+            if (document.getElementById('qa_contact')
+                && document.getElementById('qa_contact').value == defaults[1])
+            {
+                setDefaultCheckbox(evt, 'set_default_qa_contact');
+            }
+        }, [default_assignee, default_qa_contact]);
+    }
+}
+
+function initDefaultCheckbox(field_id){
+    YAHOO.util.Event.addListener( 'set_default_' + field_id,'change', boldOnChange,
+                                  'set_default_' + field_id);
+    YAHOO.util.Event.addListener( window,'load', checkForChangedFieldValues,
+                                  new Array( 'bz_' + field_id + '_edit_container',
+                                             'bz_' + field_id + '_input',
+                                             'set_default_' + field_id ,'1'));
+    
+    YAHOO.util.Event.addListener( window, 'load', boldOnChange,
+                                 'set_default_' + field_id ); 
+}
+
+function showHideStatusItems(e, dupArrayInfo) {
+    var el = document.getElementById('bug_status');
+    // finish doing stuff based on the selection.
+    if ( el ) {
+        showDuplicateItem(el);
+
+        // Make sure that fields whose visibility or values are controlled
+        // by "resolution" behave properly when resolution is hidden.
+        var resolution = document.getElementById('resolution');
+        if (resolution && resolution.options[0].value != '') {
+            resolution.bz_lastSelected = resolution.selectedIndex;
+            var emptyOption = new Option('', '');
+            resolution.insertBefore(emptyOption, resolution.options[0]);
+            emptyOption.selected = true;
+        }
+        YAHOO.util.Dom.addClass('resolution_settings', 'bz_default_hidden');
+        if (document.getElementById('resolution_settings_warning')) {
+            YAHOO.util.Dom.addClass('resolution_settings_warning',
+                                    'bz_default_hidden');
+        }
+        YAHOO.util.Dom.addClass('duplicate_display', 'bz_default_hidden');
+
+
+        if ( (el.value == dupArrayInfo[1] && dupArrayInfo[0] == "is_duplicate")
+             || bz_isValueInArray(close_status_array, el.value) ) 
+        {
+            YAHOO.util.Dom.removeClass('resolution_settings', 
+                                       'bz_default_hidden');
+            YAHOO.util.Dom.removeClass('resolution_settings_warning', 
+                                       'bz_default_hidden');
+
+            // Remove the blank option we inserted.
+            if (resolution && resolution.options[0].value == '') {
+                resolution.removeChild(resolution.options[0]);
+                resolution.selectedIndex = resolution.bz_lastSelected;
+            }
+        }
+
+        if (resolution) {
+            bz_fireEvent(resolution, 'change');
+        }
+    }
+}
+
+function showDuplicateItem(e) {
+    var resolution = document.getElementById('resolution');
+    var bug_status = document.getElementById('bug_status');
+    var dup_id = document.getElementById('dup_id');
+    if (resolution) {
+        if (resolution.value == 'DUPLICATE' && bz_isValueInArray( close_status_array, bug_status.value) ) {
+            // hide resolution show duplicate
+            YAHOO.util.Dom.removeClass('duplicate_settings', 
+                                       'bz_default_hidden');
+            YAHOO.util.Dom.addClass('dup_id_discoverable', 'bz_default_hidden');
+            // check to make sure the field is visible or IE throws errors
+            if( ! YAHOO.util.Dom.hasClass( dup_id, 'bz_default_hidden' ) ){
+                dup_id.focus();
+                dup_id.select();
+            }
+        }
+        else {
+            YAHOO.util.Dom.addClass('duplicate_settings', 'bz_default_hidden');
+            YAHOO.util.Dom.removeClass('dup_id_discoverable', 
+                                       'bz_default_hidden');
+            dup_id.blur();
+        }
+    }
+    YAHOO.util.Event.preventDefault(e); //prevents the hyperlink from going to the url in the href.
+}
+
+function setResolutionToDuplicate(e, duplicate_or_move_bug_status) {
+    var status = document.getElementById('bug_status');
+    var resolution = document.getElementById('resolution');
+    YAHOO.util.Dom.addClass('dup_id_discoverable', 'bz_default_hidden');
+    status.value = duplicate_or_move_bug_status;
+    bz_fireEvent(status, 'change');
+    resolution.value = "DUPLICATE";
+    bz_fireEvent(resolution, 'change');
+    YAHOO.util.Event.preventDefault(e);
+}
+
+function setDefaultCheckbox(e, field_id) {
+    var el = document.getElementById(field_id);
+    var elLabel = document.getElementById(field_id + "_label");
+    if( el && elLabel ) {
+        el.checked = "true";
+        YAHOO.util.Dom.setStyle(elLabel, 'font-weight', 'bold');
+    }
+}
+
+function boldOnChange(e, field_id){
+    var el = document.getElementById(field_id);
+    var elLabel = document.getElementById(field_id + "_label");
+    if( el && elLabel ) {
+        if( el.checked ){
+            YAHOO.util.Dom.setStyle(elLabel, 'font-weight', 'bold');
+        }
+        else{
+            YAHOO.util.Dom.setStyle(elLabel, 'font-weight', 'normal');
+        }
+    }
+}
+
+function updateCommentTagControl(checkbox, field) {
+    if (checkbox.checked) {
+        YAHOO.util.Dom.addClass(field, 'bz_private');
+    } else {
+        YAHOO.util.Dom.removeClass(field, 'bz_private');
+    }
+}
+
+/**
+ * Reset the value of the classification field and fire an event change
+ * on it.  Called when the product changes, in case the classification
+ * field (which is hidden) controls the visibility of any other fields.
+ */
+function setClassification() {
+    var classification = document.getElementById('classification');
+    var product = document.getElementById('product');
+    var selected_product = product.value; 
+    var select_classification = all_classifications[selected_product];
+    classification.value = select_classification;
+    bz_fireEvent(classification, 'change');
+}
+
+/**
+ * Says that a field should only be displayed when another field has
+ * a certain value. May only be called after the controller has already
+ * been added to the DOM.
+ */
+function showFieldWhen(controlled_id, controller_id, values) {
+    var controller = document.getElementById(controller_id);
+    // Note that we don't get an object for "controlled" here, because it
+    // might not yet exist in the DOM. We just pass along its id.
+    YAHOO.util.Event.addListener(controller, 'change',
+        handleVisControllerValueChange, [controlled_id, controller, values]);
+}
+
+/**
+ * Called by showFieldWhen when a field's visibility controller 
+ * changes values. 
+ */
+function handleVisControllerValueChange(e, args) {
+    var controlled_id = args[0];
+    var controller = args[1];
+    var values = args[2];
+
+    var label_container = 
+        document.getElementById('field_label_' + controlled_id);
+    var field_container =
+        document.getElementById('field_container_' + controlled_id);
+    var selected = false;
+    for (var i = 0; i < values.length; i++) {
+        if (bz_valueSelected(controller, values[i])) {
+            selected = true;
+            break;
+        }
+    }
+
+    if (selected) {
+        YAHOO.util.Dom.removeClass(label_container, 'bz_hidden_field');
+        YAHOO.util.Dom.removeClass(field_container, 'bz_hidden_field');
+    }
+    else {
+        YAHOO.util.Dom.addClass(label_container, 'bz_hidden_field');
+        YAHOO.util.Dom.addClass(field_container, 'bz_hidden_field');
+    }
+}
+
+/**
+ * This is a data structure representing the tree of controlled values.
+ * Let's call the "controller value" the "source" and the "controlled
+ * value" the "target". A target can have only one source, but a source
+ * can have an infinite number of targets.
+ *
+ * The data structure is a series of hash tables that go something
+ * like this:
+ *
+ * source_field -> target_field -> source_value_id -> target_value_ids
+ *
+ * We always know source_field when our event handler is called, since
+ * that's the field the event is being triggered on. We can then enumerate
+ * through every target field, check the status of each source field value,
+ * and act appropriately on each target value.
+ */
+var bz_value_controllers = {};
+// This keeps track of whether or not we've added an onchange handler
+// for the source field yet.
+var bz_value_controller_has_handler = {};
+function showValueWhen(target_field_id, target_value_ids,
+                       source_field_id, source_value_id, empty_shows_all)
+{
+    if (!bz_value_controllers[source_field_id]) {
+        bz_value_controllers[source_field_id] = {};
+    }
+    if (!bz_value_controllers[source_field_id][target_field_id]) {
+        bz_value_controllers[source_field_id][target_field_id] = {};
+    }
+    var source_values = bz_value_controllers[source_field_id][target_field_id];
+    source_values[source_value_id] = target_value_ids;
+
+    if (!bz_value_controller_has_handler[source_field_id]) {
+        var source_field = document.getElementById(source_field_id);
+        YAHOO.util.Event.addListener(source_field, 'change',
+            handleValControllerChange, [source_field, empty_shows_all]);
+        bz_value_controller_has_handler[source_field_id] = true;
+    }
+}
+
+function handleValControllerChange(e, args) {
+    var source = args[0];
+    var empty_shows_all = args[1];
+
+    for (var target_field_id in bz_value_controllers[source.id]) {
+        var target = document.getElementById(target_field_id);
+        if (!target) continue;
+        _update_displayed_values(source, target, empty_shows_all);
+    }
+}
+
+/* See the docs for bz_option_duplicate count lower down for an explanation
+ * of this data structure.
+ */
+var bz_option_hide_count = {};
+
+function _update_displayed_values(source, target, empty_shows_all) {
+    var show_all = (empty_shows_all && source.selectedIndex == -1);
+
+    bz_option_hide_count[target.id] = {};
+
+    var source_values = bz_value_controllers[source.id][target.id];
+    for (source_value_id in source_values) {
+        var source_option = getPossiblyHiddenOption(source, source_value_id);
+        var target_values = source_values[source_value_id];
+        for (var i = 0; i < target_values.length; i++) {
+            var target_value_id = target_values[i];
+            _handle_source_target(source_option, target, target_value_id,
+                                  show_all);
+        }
+    }
+
+    // We may have updated which elements are selected or not selected
+    // in the target field, and it may have handlers associated with
+    // that, so we need to fire the change event on the target.
+    bz_fireEvent(target, 'change');
+}
+
+function _handle_source_target(source_option, target, target_value_id,
+                               show_all)
+{
+    var target_option = getPossiblyHiddenOption(target, target_value_id);
+
+    // We always call either _show_option or _hide_option on every single
+    // target value. Although this is not theoretically the most efficient
+    // thing we can do, it handles all possible edge cases, and there are
+    // a lot of those, particularly when this code is being used on the
+    // search form.
+    if (source_option.selected || (show_all && !source_option.disabled)) {
+        _show_option(target_option, target);
+    }
+    else {
+        _hide_option(target_option, target);
+    }
+}
+
+/* When an option has duplicates (see the docs for bz_option_duplicates
+ * lower down in this file), we only want to hide it if *all* the duplicates
+ * would be hidden. So we keep a counter of how many duplicates each option
+ * has. Then, when we run through a "change" call for a source field,
+ * we count how many times each value gets hidden, and only actually
+ * hide it if the counter hits a number higher than the duplicate count.
+ */
+var bz_option_duplicate_count = {};
+
+function _show_option(option, field) {
+    if (!option.disabled) return;
+    option = showOptionInIE(option, field);
+    YAHOO.util.Dom.removeClass(option, 'bz_hidden_option');
+    option.disabled = false;
+}
+
+function _hide_option(option, field) {
+    if (option.disabled) return;
+
+    var value_id = option.bz_value_id;
+
+    if (field.id in bz_option_duplicate_count
+        && value_id in bz_option_duplicate_count[field.id])
+    {
+        if (!bz_option_hide_count[field.id][value_id]) {
+            bz_option_hide_count[field.id][value_id] = 0;
+        }
+        bz_option_hide_count[field.id][value_id]++;
+        var current = bz_option_hide_count[field.id][value_id];
+        var dups    = bz_option_duplicate_count[field.id][value_id];
+        // We check <= because the value in bz_option_duplicate_count is
+        // 1 less than the total number of duplicates (since the shown
+        // option is also a "duplicate" but not counted in
+        // bz_option_duplicate_count).
+        if (current <= dups) return;
+    }
+
+    YAHOO.util.Dom.addClass(option, 'bz_hidden_option');
+    option.selected = false;
+    option.disabled = true;
+    hideOptionInIE(option, field);
+}
+
+// A convenience function to generate the "id" tag of an <option>
+// based on the numeric id that Bugzilla uses for that value.
+function _value_id(field_name, id) {
+    return 'v' + id + '_' + field_name;
+}
+
+/*********************************/
+/* Code for Hiding Options in IE */
+/*********************************/
+
+/* IE 7 and below (and some other browsers) don't respond to "display: none"
+ * on <option> tags. However, you *can* insert a Comment Node as a
+ * child of a <select> tag. So we just insert a Comment where the <option>
+ * used to be. */
+var ie_hidden_options = {};
+function hideOptionInIE(anOption, aSelect) {
+    if (browserCanHideOptions(aSelect)) return;
+
+    var commentNode = document.createComment(anOption.value);
+    commentNode.id = anOption.id;
+    // This keeps the interface of Comments and Options the same for
+    // our other functions.
+    commentNode.disabled = true;
+    // replaceChild is very slow on IE in a <select> that has a lot of
+    // options, so we use replaceNode when we can.
+    if (anOption.replaceNode) {
+        anOption.replaceNode(commentNode);
+    }
+    else {
+        aSelect.replaceChild(commentNode, anOption);
+    }
+
+    // Store the comment node for quick access for getPossiblyHiddenOption
+    if (!ie_hidden_options[aSelect.id]) {
+        ie_hidden_options[aSelect.id] = {};
+    }
+    ie_hidden_options[aSelect.id][anOption.id] = commentNode;
+}
+
+function showOptionInIE(aNode, aSelect) {
+    if (browserCanHideOptions(aSelect)) return aNode;
+
+    // We do this crazy thing with innerHTML and createElement because
+    // this is the ONLY WAY that this works properly in IE.
+    var optionNode = document.createElement('option');
+    optionNode.innerHTML = aNode.data;
+    optionNode.value = aNode.data;
+    optionNode.id = aNode.id;
+    // replaceChild is very slow on IE in a <select> that has a lot of
+    // options, so we use replaceNode when we can.
+    if (aNode.replaceNode) {
+        aNode.replaceNode(optionNode);
+    }
+    else {
+        aSelect.replaceChild(optionNode, aNode);
+    }
+    delete ie_hidden_options[aSelect.id][optionNode.id];
+    return optionNode;
+}
+
+function initHidingOptionsForIE(select_name) {
+    var aSelect = document.getElementById(select_name);
+    if (browserCanHideOptions(aSelect)) return;
+    if (!aSelect) return;
+
+    for (var i = 0; ;i++) {
+        var item = aSelect.options[i];
+        if (!item) break;
+        if (item.disabled) {
+          hideOptionInIE(item, aSelect);
+          i--; // Hiding an option means that the options array has changed.
+        }
+    }
+}
+
+/* Certain fields, like the Component field, have duplicate values in
+ * them (the same name, but different ids). We don't display these
+ * duplicate values in the UI, but the option hiding/showing code still
+ * uses the ids of these unshown duplicates. So, whenever we get the
+ * id of an unshown duplicate in getPossiblyHiddenOption, we have to
+ * return the actually-used <option> instead.
+ *
+ * The structure of the data looks like:
+ *
+ *  field_name -> unshown_value_id -> shown_value_id_it_is_a_duplicate_of
+ */
+var bz_option_duplicates = {};
+
+function getPossiblyHiddenOption(aSelect, optionId) {
+
+    if (bz_option_duplicates[aSelect.id]
+        && bz_option_duplicates[aSelect.id][optionId])
+    {
+        optionId = bz_option_duplicates[aSelect.id][optionId];
+    }
+
+    // Works always for <option> tags, and works for commentNodes
+    // in IE (but not in Webkit).
+    var id = _value_id(aSelect.id, optionId);
+    var val = document.getElementById(id);
+
+    // This is for WebKit and other browsers that can't "display: none"
+    // an <option> and also can't getElementById for a commentNode.
+    if (!val && ie_hidden_options[aSelect.id]) {
+        val = ie_hidden_options[aSelect.id][id];
+    }
+
+    // We add this property for our own convenience, it's used in
+    // other places.
+    val.bz_value_id = optionId;
+
+    return val;
+}
+
+var browser_can_hide_options;
+function browserCanHideOptions(aSelect) {
+    /* As far as I can tell, browsers that don't hide <option> tags
+     * also never have a X position for <option> tags, even if
+     * they're visible. This is the only reliable way I found to
+     * differentiate browsers. So we create a visible option, see
+     * if it has a position, and then remove it. */
+    if (typeof(browser_can_hide_options) == "undefined") {
+        var new_opt = bz_createOptionInSelect(aSelect, '', '');
+        var opt_pos = YAHOO.util.Dom.getX(new_opt);
+        aSelect.removeChild(new_opt);
+        if (opt_pos) {
+            browser_can_hide_options = true;
+        }
+        else {
+            browser_can_hide_options = false;
+        }
+    }
+    return browser_can_hide_options;
+}
+
+/* (end) option hiding code */
+
+/**
+ * The Autoselect
+ */
+YAHOO.bugzilla.userAutocomplete = {
+    counter : 0,
+    dataSource : null,
+    generateRequest : function ( enteredText ){ 
+      YAHOO.bugzilla.userAutocomplete.counter = 
+                                   YAHOO.bugzilla.userAutocomplete.counter + 1;
+      YAHOO.util.Connect.setDefaultPostHeader('application/json', true);
+      var json_object = {
+          method : "User.get",
+          id : YAHOO.bugzilla.userAutocomplete.counter,
+          params : [ { 
+            match : [ decodeURIComponent(enteredText) ],
+            include_fields : [ "name", "real_name" ]
+          } ]
+      };
+      var stringified =  YAHOO.lang.JSON.stringify(json_object);
+      var debug = { msg: "json-rpc obj debug info", "json obj": json_object, 
+                    "param" : stringified}
+      YAHOO.bugzilla.userAutocomplete.debug_helper( debug );
+      return stringified;
+    },
+    resultListFormat : function(oResultData, enteredText, sResultMatch) {
+        return ( YAHOO.lang.escapeHTML(oResultData.real_name) + " ("
+                 + YAHOO.lang.escapeHTML(oResultData.name) + ")");
+    },
+    debug_helper : function ( ){
+        /* used to help debug any errors that might happen */
+        if( typeof(console) !== 'undefined' && console != null && arguments.length > 0 ){
+            console.log("debug helper info:", arguments);
+        }
+        return true;
+    },    
+    init_ds : function(){
+        this.dataSource = new YAHOO.util.XHRDataSource("jsonrpc.cgi");
+        this.dataSource.connTimeout = 30000;
+        this.dataSource.connMethodPost = true;
+        this.dataSource.connXhrMode = "cancelStaleRequests";
+        this.dataSource.maxCacheEntries = 5;
+        this.dataSource.responseSchema = {
+            resultsList : "result.users",
+            metaFields : { error: "error", jsonRpcId: "id"},
+            fields : [
+                { key : "name" },
+                { key : "real_name"}
+            ]
+        };
+    },
+    init : function( field, container, multiple ) {
+        if( this.dataSource == null ){
+            this.init_ds();  
+        }            
+        var userAutoComp = new YAHOO.widget.AutoComplete( field, container, 
+                                this.dataSource );
+        // other stuff we might want to do with the autocomplete goes here
+        userAutoComp.maxResultsDisplayed = BUGZILLA.param.maxusermatches;
+        userAutoComp.generateRequest = this.generateRequest;
+        userAutoComp.formatResult = this.resultListFormat;
+        userAutoComp.doBeforeLoadData = this.debug_helper;
+        userAutoComp.minQueryLength = 3;
+        userAutoComp.autoHighlight = false;
+        // this is a throttle to determine the delay of the query from typing
+        // set this higher to cause fewer calls to the server
+        userAutoComp.queryDelay = 0.05;
+        userAutoComp.useIFrame = true;
+        userAutoComp.resultTypeList = false;
+        if( multiple == true ){
+            userAutoComp.delimChar = [","];
+        }
+        
+    }
+};
+
+YAHOO.bugzilla.fieldAutocomplete = {
+    dataSource : [],
+    init_ds : function( field ) {
+        this.dataSource[field] =
+          new YAHOO.util.LocalDataSource( YAHOO.bugzilla.field_array[field] );
+    },
+    init : function( field, container ) {
+        if( this.dataSource[field] == null ) {
+            this.init_ds( field );
+        }
+        var fieldAutoComp =
+          new YAHOO.widget.AutoComplete(field, container, this.dataSource[field]);
+        fieldAutoComp.maxResultsDisplayed = YAHOO.bugzilla.field_array[field].length;
+        fieldAutoComp.formatResult = fieldAutoComp.formatEscapedResult;
+        fieldAutoComp.minQueryLength = 0;
+        fieldAutoComp.useIFrame = true;
+        fieldAutoComp.delimChar = [","," "];
+        fieldAutoComp.resultTypeList = false;
+        fieldAutoComp.queryDelay = 0;
+        /*  Causes all the possibilities in the field to appear when a user
+         *  focuses on the textbox 
+         */
+        fieldAutoComp.textboxFocusEvent.subscribe( function(){
+            var sInputValue = YAHOO.util.Dom.get(field).value;
+            if( sInputValue.length === 0
+                && YAHOO.bugzilla.field_array[field].length > 0 ){
+                this.sendQuery(sInputValue);
+                this.collapseContainer();
+                this.expandContainer();
+            }
+        });
+        fieldAutoComp.dataRequestEvent.subscribe( function(type, args) {
+            args[0].autoHighlight = args[1] != '';
+        });
+    }
+};
+
+/**
+ * Set the disable email checkbox to true if the user has disabled text
+ */
+function userDisabledTextOnChange(disabledtext) {
+    var disable_mail = document.getElementById('disable_mail');
+    if (disabledtext.value === "" && !disable_mail_manually_set) {
+        disable_mail.checked = false;
+    }
+    if (disabledtext.value !== "" && !disable_mail_manually_set) {
+        disable_mail.checked = true;
+    }
+}
+
+/**
+ * Force the browser to honour the selected option when a page is refreshed,
+ * but only if the user hasn't explicitly selected a different option.
+ */
+function initDirtyFieldTracking() {
+    // old IE versions don't provide the information we need to make this fix work
+    // however they aren't affected by this issue, so it's ok to ignore them
+    if (YAHOO.env.ua.ie > 0 && YAHOO.env.ua.ie <= 8) return;
+    var selects = document.getElementById('changeform').getElementsByTagName('select');
+    for (var i = 0, l = selects.length; i < l; i++) {
+        var el = selects[i];
+        var el_dirty = document.getElementById(el.name + '_dirty');
+        if (!el_dirty) continue;
+        if (!el_dirty.value) {
+            var preSelected = bz_preselectedOptions(el);
+            if (!el.multiple) {
+                preSelected.selected = true;
+            } else {
+                el.selectedIndex = -1;
+                for (var j = 0, m = preSelected.length; j < m; j++) {
+                    preSelected[j].selected = true;
+                }
+            }
+        }
+        YAHOO.util.Event.on(el, "change", function(e) {
+            var el = e.target || e.srcElement;
+            var preSelected = bz_preselectedOptions(el);
+            var currentSelected = bz_selectedOptions(el);
+            var isDirty = false;
+            if (!el.multiple) {
+                isDirty = preSelected.index != currentSelected.index;
+            } else {
+                if (preSelected.length != currentSelected.length) {
+                    isDirty = true;
+                } else {
+                    for (var i = 0, l = preSelected.length; i < l; i++) {
+                        if (currentSelected[i].index != preSelected[i].index) {
+                            isDirty = true;
+                            break;
+                        }
+                    }
+                }
+            }
+            document.getElementById(el.name + '_dirty').value = isDirty ? '1' : '';
+        });
+    }
+}

diff --git a/js/flag.js b/js/flag.js
new file mode 100644 (file)
index 0000000..c807089
--- /dev/null
+++ b/js/flag.js
@@ -0,0 +1,57 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+// Shows or hides a requestee field depending on whether or not
+// the user is requesting the corresponding flag.
+function toggleRequesteeField(flagField, no_focus)
+{
+  // Convert the ID of the flag field into the ID of its corresponding
+  // requestee field and then use the ID to get the field.
+  var id = flagField.name.replace(/flag(_type)?-(\d+)/, "requestee$1-$2");
+  var requesteeField = document.getElementById(id);
+  if (!requesteeField) return;
+
+  // Show or hide the requestee field based on the value
+  // of the flag field.
+  if (flagField.value == "?") {
+      YAHOO.util.Dom.removeClass(requesteeField.parentNode, 'bz_default_hidden');
+      if (!no_focus) requesteeField.focus();
+  } else
+      YAHOO.util.Dom.addClass(requesteeField.parentNode, 'bz_default_hidden');
+}
+
+// Hides requestee fields when the window is loaded since they shouldn't
+// be enabled until the user requests that flag type.
+function hideRequesteeFields()
+{
+  var inputElements = document.getElementsByTagName("input");
+  var selectElements = document.getElementsByTagName("select");
+  //You cannot update Node lists, so you must create an array to combine the NodeLists
+  var allElements = [];
+  for( var i=0; i < inputElements.length; i++ ) {
+      allElements[allElements.length] = inputElements.item(i);
+  }
+  for( var i=0; i < selectElements.length; i++ ) { //Combine inputs with selects
+      allElements[allElements.length] = selectElements.item(i);
+  }
+  var inputElement, id, flagField;
+  for ( var i=0 ; i<allElements.length ; i++ )
+  {
+    inputElement = allElements[i];
+    if (inputElement.name.search(/^requestee(_type)?-(\d+)$/) != -1)
+    {
+      // Convert the ID of the requestee field into the ID of its corresponding
+      // flag field and then use the ID to get the field.
+      id = inputElement.name.replace(/requestee(_type)?-(\d+)/, "flag$1-$2");
+      flagField = document.getElementById(id);
+      if (flagField && flagField.value != "?")
+          YAHOO.util.Dom.addClass(inputElement.parentNode, 'bz_default_hidden');
+    }
+  }
+}
+YAHOO.util.Event.onDOMReady(hideRequesteeFields);

diff --git a/js/global.js b/js/global.js
new file mode 100644 (file)
index 0000000..265ade4
--- /dev/null
+++ b/js/global.js
@@ -0,0 +1,121 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+var mini_login_constants;
+
+function show_mini_login_form( suffix ) {
+    var login_link = document.getElementById('login_link' + suffix);
+    var login_form = document.getElementById('mini_login' + suffix);
+    var account_container = document.getElementById('new_account_container'
+                                                    + suffix);
+
+    YAHOO.util.Dom.addClass(login_link, 'bz_default_hidden');
+    YAHOO.util.Dom.removeClass(login_form, 'bz_default_hidden');
+    YAHOO.util.Dom.addClass(account_container, 'bz_default_hidden');
+    return false;
+}
+
+function hide_mini_login_form( suffix ) {
+    var login_link = document.getElementById('login_link' + suffix);
+    var login_form = document.getElementById('mini_login' + suffix);
+    var account_container = document.getElementById('new_account_container'
+                                                    + suffix);
+
+    YAHOO.util.Dom.removeClass(login_link, 'bz_default_hidden');
+    YAHOO.util.Dom.addClass(login_form, 'bz_default_hidden');
+    YAHOO.util.Dom.removeClass(account_container, 'bz_default_hidden');
+    return false;
+}
+
+function show_forgot_form( suffix ) {
+    var forgot_link = document.getElementById('forgot_link' + suffix);
+    var forgot_form = document.getElementById('forgot_form' + suffix);
+    var login_container = document.getElementById('mini_login_container' 
+                                                  + suffix);
+    YAHOO.util.Dom.addClass(forgot_link, 'bz_default_hidden');
+    YAHOO.util.Dom.removeClass(forgot_form, 'bz_default_hidden');
+    YAHOO.util.Dom.addClass(login_container, 'bz_default_hidden');
+    return false;
+}
+
+function hide_forgot_form( suffix ) {
+    var forgot_link = document.getElementById('forgot_link' + suffix);
+    var forgot_form = document.getElementById('forgot_form' + suffix);
+    var login_container = document.getElementById('mini_login_container'
+                                                  + suffix);
+    YAHOO.util.Dom.removeClass(forgot_link, 'bz_default_hidden');
+    YAHOO.util.Dom.addClass(forgot_form, 'bz_default_hidden');
+    YAHOO.util.Dom.removeClass(login_container, 'bz_default_hidden');
+    return false;
+}
+
+function init_mini_login_form( suffix ) {
+    var mini_login = document.getElementById('Bugzilla_login' +  suffix );
+    var mini_password = document.getElementById('Bugzilla_password' +  suffix );
+    var mini_dummy = document.getElementById(
+        'Bugzilla_password_dummy' + suffix);
+    // If the login and password are blank when the page loads, we display
+    // "login" and "password" in the boxes by default.
+    if (mini_login.value == "" && mini_password.value == "") {
+        mini_login.value = mini_login_constants.login;
+        YAHOO.util.Dom.addClass(mini_login, "bz_mini_login_help");
+        YAHOO.util.Dom.addClass(mini_password, 'bz_default_hidden');
+        YAHOO.util.Dom.removeClass(mini_dummy, 'bz_default_hidden');
+    }
+    else {
+        show_mini_login_form(suffix);
+    }
+}
+
+// Clear the words "login" and "password" from the form when you click
+// in one of the boxes. We clear them both when you click in either box
+// so that the browser's password-autocomplete can work.
+function mini_login_on_focus( suffix ) {
+    var mini_login = document.getElementById('Bugzilla_login' +  suffix );
+    var mini_password = document.getElementById('Bugzilla_password' +  suffix );
+    var mini_dummy = document.getElementById(
+        'Bugzilla_password_dummy' + suffix);
+
+    YAHOO.util.Dom.removeClass(mini_login, "bz_mini_login_help");
+    if (mini_login.value == mini_login_constants.login) {
+        mini_login.value = '';
+    }
+    YAHOO.util.Dom.removeClass(mini_password, 'bz_default_hidden');
+    YAHOO.util.Dom.addClass(mini_dummy, 'bz_default_hidden');
+}
+
+function check_mini_login_fields( suffix ) {
+    var mini_login = document.getElementById('Bugzilla_login' +  suffix );
+    var mini_password = document.getElementById('Bugzilla_password' +  suffix );
+    if( (mini_login.value != "" && mini_password.value != "") 
+         &&  mini_login.value != mini_login_constants.login )
+    {
+      return true;
+    }
+    window.alert( mini_login_constants.warning );
+    return false;
+}
+
+function set_language( value ) {
+    YAHOO.util.Cookie.set('LANG', value,
+    {
+        expires: new Date('January 1, 2038'),
+        path: BUGZILLA.param.cookie_path
+    });
+    window.location.reload()
+}
+
+// This basically duplicates Bugzilla::Util::display_value for code that
+// can't go through the template and has to be in JS.
+function display_value(field, value) {
+    var field_trans = BUGZILLA.value_descs[field];
+    if (!field_trans) return value;
+    var translated = field_trans[value];
+    if (translated) return translated;
+    return value;
+}

diff --git a/js/history.js/license.txt b/js/history.js/license.txt
new file mode 100644 (file)
index 0000000..719aafc
--- /dev/null
+++ b/js/history.js/license.txt
@@ -0,0 +1,10 @@
+Copyright (c) 2011, Benjamin Arthur Lupton
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+  • Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+  • Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+  • Neither the name of Benjamin Arthur Lupton nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

diff --git a/js/history.js/native.history.js b/js/history.js/native.history.js
new file mode 100644 (file)
index 0000000..3d34166
--- /dev/null
+++ b/js/history.js/native.history.js
@@ -0,0 +1 @@
+window.JSON||(window.JSON={}),function(){function f(a){return a<10?"0"+a:a}function quote(a){return escapable.lastIndex=0,escapable.test(a)?'"'+a.replace(escapable,function(a){var b=meta[a];return typeof b=="string"?b:"\\u"+("0000"+a.charCodeAt(0).toString(16)).slice(-4)})+'"':'"'+a+'"'}function str(a,b){var c,d,e,f,g=gap,h,i=b[a];i&&typeof i=="object"&&typeof i.toJSON=="function"&&(i=i.toJSON(a)),typeof rep=="function"&&(i=rep.call(b,a,i));switch(typeof i){case"string":return quote(i);case"number":return isFinite(i)?String(i):"null";case"boolean":case"null":return String(i);case"object":if(!i)return"null";gap+=indent,h=[];if(Object.prototype.toString.apply(i)==="[object Array]"){f=i.length;for(c=0;c<f;c+=1)h[c]=str(c,i)||"null";return e=h.length===0?"[]":gap?"[\n"+gap+h.join(",\n"+gap)+"\n"+g+"]":"["+h.join(",")+"]",gap=g,e}if(rep&&typeof rep=="object"){f=rep.length;for(c=0;c<f;c+=1)d=rep[c],typeof d=="string"&&(e=str(d,i),e&&h.push(quote(d)+(gap?": ":":")+e))}else for(d in i)Object.hasOwnProperty.call(i,d)&&(e=str(d,i),e&&h.push(quote(d)+(gap?": ":":")+e));return e=h.length===0?"{}":gap?"{\n"+gap+h.join(",\n"+gap)+"\n"+g+"}":"{"+h.join(",")+"}",gap=g,e}}"use strict",typeof Date.prototype.toJSON!="function"&&(Date.prototype.toJSON=function(a){return isFinite(this.valueOf())?this.getUTCFullYear()+"-"+f(this.getUTCMonth()+1)+"-"+f(this.getUTCDate())+"T"+f(this.getUTCHours())+":"+f(this.getUTCMinutes())+":"+f(this.getUTCSeconds())+"Z":null},String.prototype.toJSON=Number.prototype.toJSON=Boolean.prototype.toJSON=function(a){return this.valueOf()});var JSON=window.JSON,cx=/[\u0000\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,escapable=/[\\\"\x00-\x1f\x7f-\x9f\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,gap,indent,meta={"\b":"\\b","\t":"\\t","\n":"\\n","\f":"\\f","\r":"\\r",'"':'\\"',"\\":"\\\\"},rep;typeof JSON.stringify!="function"&&(JSON.stringify=function(a,b,c){var d;gap="",indent="";if(typeof c=="number")for(d=0;d<c;d+=1)indent+=" ";else typeof c=="string"&&(indent=c);rep=b;if(!b||typeof b=="function"||typeof b=="object"&&typeof b.length=="number")return str("",{"":a});throw new Error("JSON.stringify")}),typeof JSON.parse!="function"&&(JSON.parse=function(text,reviver){function walk(a,b){var c,d,e=a[b];if(e&&typeof e=="object")for(c in e)Object.hasOwnProperty.call(e,c)&&(d=walk(e,c),d!==undefined?e[c]=d:delete e[c]);return reviver.call(a,b,e)}var j;text=String(text),cx.lastIndex=0,cx.test(text)&&(text=text.replace(cx,function(a){return"\\u"+("0000"+a.charCodeAt(0).toString(16)).slice(-4)}));if(/^[\],:{}\s]*$/.test(text.replace(/\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g,"@").replace(/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g,"]").replace(/(?:^|:|,)(?:\s*\[)+/g,"")))return j=eval("("+text+")"),typeof reviver=="function"?walk({"":j},""):j;throw new SyntaxError("JSON.parse")})}(),function(a,b){"use strict";var c=a.History=a.History||{};if(typeof c.Adapter!="undefined")throw new Error("History.js Adapter has already been loaded...");c.Adapter={handlers:{},_uid:1,uid:function(a){return a._uid||(a._uid=c.Adapter._uid++)},bind:function(a,b,d){var e=c.Adapter.uid(a);c.Adapter.handlers[e]=c.Adapter.handlers[e]||{},c.Adapter.handlers[e][b]=c.Adapter.handlers[e][b]||[],c.Adapter.handlers[e][b].push(d),a["on"+b]=function(a,b){return function(d){c.Adapter.trigger(a,b,d)}}(a,b)},trigger:function(a,b,d){d=d||{};var e=c.Adapter.uid(a),f,g;c.Adapter.handlers[e]=c.Adapter.handlers[e]||{},c.Adapter.handlers[e][b]=c.Adapter.handlers[e][b]||[];for(f=0,g=c.Adapter.handlers[e][b].length;f<g;++f)c.Adapter.handlers[e][b][f].apply(this,[d])},extractEventData:function(a,c){var d=c&&c[a]||b;return d},onDomLoad:function(b){var c=a.setTimeout(function(){b()},2e3);a.onload=function(){clearTimeout(c),b()}}},typeof c.init!="undefined"&&c.init()}(window),function(a,b){"use strict";var c=a.document,d=a.setTimeout||d,e=a.clearTimeout||e,f=a.setInterval||f,g=a.History=a.History||{};if(typeof g.initHtml4!="undefined")throw new Error("History.js HTML4 Support has already been loaded...");g.initHtml4=function(){if(typeof g.initHtml4.initialized!="undefined")return!1;g.initHtml4.initialized=!0,g.enabled=!0,g.savedHashes=[],g.isLastHash=function(a){var b=g.getHashByIndex(),c;return c=a===b,c},g.saveHash=function(a){return g.isLastHash(a)?!1:(g.savedHashes.push(a),!0)},g.getHashByIndex=function(a){var b=null;return typeof a=="undefined"?b=g.savedHashes[g.savedHashes.length-1]:a<0?b=g.savedHashes[g.savedHashes.length+a]:b=g.savedHashes[a],b},g.discardedHashes={},g.discardedStates={},g.discardState=function(a,b,c){var d=g.getHashByState(a),e;return e={discardedState:a,backState:c,forwardState:b},g.discardedStates[d]=e,!0},g.discardHash=function(a,b,c){var d={discardedHash:a,backState:c,forwardState:b};return g.discardedHashes[a]=d,!0},g.discardedState=function(a){var b=g.getHashByState(a),c;return c=g.discardedStates[b]||!1,c},g.discardedHash=function(a){var b=g.discardedHashes[a]||!1;return b},g.recycleState=function(a){var b=g.getHashByState(a);return g.discardedState(a)&&delete g.discardedStates[b],!0},g.emulated.hashChange&&(g.hashChangeInit=function(){g.checkerFunction=null;var b="",d,e,h,i;return g.isInternetExplorer()?(d="historyjs-iframe",e=c.createElement("iframe"),e.setAttribute("id",d),e.style.display="none",c.body.appendChild(e),e.contentWindow.document.open(),e.contentWindow.document.close(),h="",i=!1,g.checkerFunction=function(){if(i)return!1;i=!0;var c=g.getHash()||"",d=g.unescapeHash(e.contentWindow.document.location.hash)||"";return c!==b?(b=c,d!==c&&(h=d=c,e.contentWindow.document.open(),e.contentWindow.document.close(),e.contentWindow.document.location.hash=g.escapeHash(c)),g.Adapter.trigger(a,"hashchange")):d!==h&&(h=d,g.setHash(d,!1)),i=!1,!0}):g.checkerFunction=function(){var c=g.getHash();return c!==b&&(b=c,g.Adapter.trigger(a,"hashchange")),!0},g.intervalList.push(f(g.checkerFunction,g.options.hashChangeInterval)),!0},g.Adapter.onDomLoad(g.hashChangeInit)),g.emulated.pushState&&(g.onHashChange=function(b){var d=b&&b.newURL||c.location.href,e=g.getHashByUrl(d),f=null,h=null,i=null,j;return g.isLastHash(e)?(g.busy(!1),!1):(g.doubleCheckComplete(),g.saveHash(e),e&&g.isTraditionalAnchor(e)?(g.Adapter.trigger(a,"anchorchange"),g.busy(!1),!1):(f=g.extractState(g.getFullUrl(e||c.location.href,!1),!0),g.isLastSavedState(f)?(g.busy(!1),!1):(h=g.getHashByState(f),j=g.discardedState(f),j?(g.getHashByIndex(-2)===g.getHashByState(j.forwardState)?g.back(!1):g.forward(!1),!1):(g.pushState(f.data,f.title,f.url,!1),!0))))},g.Adapter.bind(a,"hashchange",g.onHashChange),g.pushState=function(b,d,e,f){if(g.getHashByUrl(e))throw new Error("History.js does not support states with fragement-identifiers (hashes/anchors).");if(f!==!1&&g.busy())return g.pushQueue({scope:g,callback:g.pushState,args:arguments,queue:f}),!1;g.busy(!0);var h=g.createStateObject(b,d,e),i=g.getHashByState(h),j=g.getState(!1),k=g.getHashByState(j),l=g.getHash();return g.storeState(h),g.expectedStateId=h.id,g.recycleState(h),g.setTitle(h),i===k?(g.busy(!1),!1):i!==l&&i!==g.getShortUrl(c.location.href)?(g.setHash(i,!1),!1):(g.saveState(h),g.Adapter.trigger(a,"statechange"),g.busy(!1),!0)},g.replaceState=function(a,b,c,d){if(g.getHashByUrl(c))throw new Error("History.js does not support states with fragement-identifiers (hashes/anchors).");if(d!==!1&&g.busy())return g.pushQueue({scope:g,callback:g.replaceState,args:arguments,queue:d}),!1;g.busy(!0);var e=g.createStateObject(a,b,c),f=g.getState(!1),h=g.getStateByIndex(-2);return g.discardState(f,e,h),g.pushState(e.data,e.title,e.url,!1),!0}),g.emulated.pushState&&g.getHash()&&!g.emulated.hashChange&&g.Adapter.onDomLoad(function(){g.Adapter.trigger(a,"hashchange")})},typeof g.init!="undefined"&&g.init()}(window),function(a,b){"use strict";var c=a.console||b,d=a.document,e=a.navigator,f=a.sessionStorage||!1,g=a.setTimeout,h=a.clearTimeout,i=a.setInterval,j=a.clearInterval,k=a.JSON,l=a.alert,m=a.History=a.History||{},n=a.history;k.stringify=k.stringify||k.encode,k.parse=k.parse||k.decode;if(typeof m.init!="undefined")throw new Error("History.js Core has already been loaded...");m.init=function(){return typeof m.Adapter=="undefined"?!1:(typeof m.initCore!="undefined"&&m.initCore(),typeof m.initHtml4!="undefined"&&m.initHtml4(),!0)},m.initCore=function(){if(typeof m.initCore.initialized!="undefined")return!1;m.initCore.initialized=!0,m.options=m.options||{},m.options.hashChangeInterval=m.options.hashChangeInterval||100,m.options.safariPollInterval=m.options.safariPollInterval||500,m.options.doubleCheckInterval=m.options.doubleCheckInterval||500,m.options.storeInterval=m.options.storeInterval||1e3,m.options.busyDelay=m.options.busyDelay||250,m.options.debug=m.options.debug||!1,m.options.initialTitle=m.options.initialTitle||d.title,m.intervalList=[],m.clearAllIntervals=function(){var a,b=m.intervalList;if(typeof b!="undefined"&&b!==null){for(a=0;a<b.length;a++)j(b[a]);m.intervalList=null}},m.debug=function(){(m.options.debug||!1)&&m.log.apply(m,arguments)},m.log=function(){var a=typeof c!="undefined"&&typeof c.log!="undefined"&&typeof c.log.apply!="undefined",b=d.getElementById("log"),e,f,g,h,i;a?(h=Array.prototype.slice.call(arguments),e=h.shift(),typeof c.debug!="undefined"?c.debug.apply(c,[e,h]):c.log.apply(c,[e,h])):e="\n"+arguments[0]+"\n";for(f=1,g=arguments.length;f<g;++f){i=arguments[f];if(typeof i=="object"&&typeof k!="undefined")try{i=k.stringify(i)}catch(j){}e+="\n"+i+"\n"}return b?(b.value+=e+"\n-----\n",b.scrollTop=b.scrollHeight-b.clientHeight):a||l(e),!0},m.getInternetExplorerMajorVersion=function(){var a=m.getInternetExplorerMajorVersion.cached=typeof m.getInternetExplorerMajorVersion.cached!="undefined"?m.getInternetExplorerMajorVersion.cached:function(){var a=3,b=d.createElement("div"),c=b.getElementsByTagName("i");while((b.innerHTML="<!--[if gt IE "+ ++a+"]><i></i><![endif]-->")&&c[0]);return a>4?a:!1}();return a},m.isInternetExplorer=function(){var a=m.isInternetExplorer.cached=typeof m.isInternetExplorer.cached!="undefined"?m.isInternetExplorer.cached:Boolean(m.getInternetExplorerMajorVersion());return a},m.emulated={pushState:!Boolean(a.history&&a.history.pushState&&a.history.replaceState&&!/ Mobile\/([1-7][a-z]|(8([abcde]|f(1[0-8]))))/i.test(e.userAgent)&&!/AppleWebKit\/5([0-2]|3[0-2])/i.test(e.userAgent)),hashChange:Boolean(!("onhashchange"in a||"onhashchange"in d)||m.isInternetExplorer()&&m.getInternetExplorerMajorVersion()<8)},m.enabled=!m.emulated.pushState,m.bugs={setHash:Boolean(!m.emulated.pushState&&e.vendor==="Apple Computer, Inc."&&/AppleWebKit\/5([0-2]|3[0-3])/.test(e.userAgent)),safariPoll:Boolean(!m.emulated.pushState&&e.vendor==="Apple Computer, Inc."&&/AppleWebKit\/5([0-2]|3[0-3])/.test(e.userAgent)),ieDoubleCheck:Boolean(m.isInternetExplorer()&&m.getInternetExplorerMajorVersion()<8),hashEscape:Boolean(m.isInternetExplorer()&&m.getInternetExplorerMajorVersion()<7)},m.isEmptyObject=function(a){for(var b in a)return!1;return!0},m.cloneObject=function(a){var b,c;return a?(b=k.stringify(a),c=k.parse(b)):c={},c},m.getRootUrl=function(){var a=d.location.protocol+"//"+(d.location.hostname||d.location.host);if(d.location.port||!1)a+=":"+d.location.port;return a+="/",a},m.getBaseHref=function(){var a=d.getElementsByTagName("base"),b=null,c="";return a.length===1&&(b=a[0],c=b.href.replace(/[^\/]+$/,"")),c=c.replace(/\/+$/,""),c&&(c+="/"),c},m.getBaseUrl=function(){var a=m.getBaseHref()||m.getBasePageUrl()||m.getRootUrl();return a},m.getPageUrl=function(){var a=m.getState(!1,!1),b=(a||{}).url||d.location.href,c;return c=b.replace(/\/+$/,"").replace(/[^\/]+$/,function(a,b,c){return/\./.test(a)?a:a+"/"}),c},m.getBasePageUrl=function(){var a=d.location.href.replace(/[#\?].*/,"").replace(/[^\/]+$/,function(a,b,c){return/[^\/]$/.test(a)?"":a}).replace(/\/+$/,"")+"/";return a},m.getFullUrl=function(a,b){var c=a,d=a.substring(0,1);return b=typeof b=="undefined"?!0:b,/[a-z]+\:\/\//.test(a)||(d==="/"?c=m.getRootUrl()+a.replace(/^\/+/,""):d==="#"?c=m.getPageUrl().replace(/#.*/,"")+a:d==="?"?c=m.getPageUrl().replace(/[\?#].*/,"")+a:b?c=m.getBaseUrl()+a.replace(/^(\.\/)+/,""):c=m.getBasePageUrl()+a.replace(/^(\.\/)+/,"")),c.replace(/\#$/,"")},m.getShortUrl=function(a){var b=a,c=m.getBaseUrl(),d=m.getRootUrl();return m.emulated.pushState&&(b=b.replace(c,"")),b=b.replace(d,"/"),m.isTraditionalAnchor(b)&&(b="./"+b),b=b.replace(/^(\.\/)+/g,"./").replace(/\#$/,""),b},m.store={},m.idToState=m.idToState||{},m.stateToId=m.stateToId||{},m.urlToId=m.urlToId||{},m.storedStates=m.storedStates||[],m.savedStates=m.savedStates||[],m.normalizeStore=function(){m.store.idToState=m.store.idToState||{},m.store.urlToId=m.store.urlToId||{},m.store.stateToId=m.store.stateToId||{}},m.getState=function(a,b){typeof a=="undefined"&&(a=!0),typeof b=="undefined"&&(b=!0);var c=m.getLastSavedState();return!c&&b&&(c=m.createStateObject()),a&&(c=m.cloneObject(c),c.url=c.cleanUrl||c.url),c},m.getIdByState=function(a){var b=m.extractId(a.url),c;if(!b){c=m.getStateString(a);if(typeof m.stateToId[c]!="undefined")b=m.stateToId[c];else if(typeof m.store.stateToId[c]!="undefined")b=m.store.stateToId[c];else{for(;;){b=(new Date).getTime()+String(Math.random()).replace(/\D/g,"");if(typeof m.idToState[b]=="undefined"&&typeof m.store.idToState[b]=="undefined")break}m.stateToId[c]=b,m.idToState[b]=a}}return b},m.normalizeState=function(a){var b,c;if(!a||typeof a!="object")a={};if(typeof a.normalized!="undefined")return a;if(!a.data||typeof a.data!="object")a.data={};b={},b.normalized=!0,b.title=a.title||"",b.url=m.getFullUrl(m.unescapeString(a.url||d.location.href)),b.hash=m.getShortUrl(b.url),b.data=m.cloneObject(a.data),b.id=m.getIdByState(b),b.cleanUrl=b.url.replace(/\??\&_suid.*/,""),b.url=b.cleanUrl,c=!m.isEmptyObject(b.data);if(b.title||c)b.hash=m.getShortUrl(b.url).replace(/\??\&_suid.*/,""),/\?/.test(b.hash)||(b.hash+="?"),b.hash+="&_suid="+b.id;return b.hashedUrl=m.getFullUrl(b.hash),(m.emulated.pushState||m.bugs.safariPoll)&&m.hasUrlDuplicate(b)&&(b.url=b.hashedUrl),b},m.createStateObject=function(a,b,c){var d={data:a,title:b,url:c};return d=m.normalizeState(d),d},m.getStateById=function(a){a=String(a);var c=m.idToState[a]||m.store.idToState[a]||b;return c},m.getStateString=function(a){var b,c,d;return b=m.normalizeState(a),c={data:b.data,title:a.title,url:a.url},d=k.stringify(c),d},m.getStateId=function(a){var b,c;return b=m.normalizeState(a),c=b.id,c},m.getHashByState=function(a){var b,c;return b=m.normalizeState(a),c=b.hash,c},m.extractId=function(a){var b,c,d;return c=/(.*)\&_suid=([0-9]+)$/.exec(a),d=c?c[1]||a:a,b=c?String(c[2]||""):"",b||!1},m.isTraditionalAnchor=function(a){var b=!/[\/\?\.]/.test(a);return b},m.extractState=function(a,b){var c=null,d,e;return b=b||!1,d=m.extractId(a),d&&(c=m.getStateById(d)),c||(e=m.getFullUrl(a),d=m.getIdByUrl(e)||!1,d&&(c=m.getStateById(d)),!c&&b&&!m.isTraditionalAnchor(a)&&(c=m.createStateObject(null,null,e))),c},m.getIdByUrl=function(a){var c=m.urlToId[a]||m.store.urlToId[a]||b;return c},m.getLastSavedState=function(){return m.savedStates[m.savedStates.length-1]||b},m.getLastStoredState=function(){return m.storedStates[m.storedStates.length-1]||b},m.hasUrlDuplicate=function(a){var b=!1,c;return c=m.extractState(a.url),b=c&&c.id!==a.id,b},m.storeState=function(a){return m.urlToId[a.url]=a.id,m.storedStates.push(m.cloneObject(a)),a},m.isLastSavedState=function(a){var b=!1,c,d,e;return m.savedStates.length&&(c=a.id,d=m.getLastSavedState(),e=d.id,b=c===e),b},m.saveState=function(a){return m.isLastSavedState(a)?!1:(m.savedStates.push(m.cloneObject(a)),!0)},m.getStateByIndex=function(a){var b=null;return typeof a=="undefined"?b=m.savedStates[m.savedStates.length-1]:a<0?b=m.savedStates[m.savedStates.length+a]:b=m.savedStates[a],b},m.getHash=function(){var a=m.unescapeHash(d.location.hash);return a},m.unescapeString=function(b){var c=b,d;for(;;){d=a.unescape(c);if(d===c)break;c=d}return c},m.unescapeHash=function(a){var b=m.normalizeHash(a);return b=m.unescapeString(b),b},m.normalizeHash=function(a){var b=a.replace(/[^#]*#/,"").replace(/#.*/,"");return b},m.setHash=function(a,b){var c,e,f;return b!==!1&&m.busy()?(m.pushQueue({scope:m,callback:m.setHash,args:arguments,queue:b}),!1):(c=m.escapeHash(a),m.busy(!0),e=m.extractState(a,!0),e&&!m.emulated.pushState?m.pushState(e.data,e.title,e.url,!1):d.location.hash!==c&&(m.bugs.setHash?(f=m.getPageUrl(),m.pushState(null,null,f+"#"+c,!1)):d.location.hash=c),m)},m.escapeHash=function(b){var c=m.normalizeHash(b);return c=a.escape(c),m.bugs.hashEscape||(c=c.replace(/\%21/g,"!").replace(/\%26/g,"&").replace(/\%3D/g,"=").replace(/\%3F/g,"?")),c},m.getHashByUrl=function(a){var b=String(a).replace(/([^#]*)#?([^#]*)#?(.*)/,"$2");return b=m.unescapeHash(b),b},m.setTitle=function(a){var b=a.title,c;b||(c=m.getStateByIndex(0),c&&c.url===a.url&&(b=c.title||m.options.initialTitle));try{d.getElementsByTagName("title")[0].innerHTML=b.replace("<","&lt;").replace(">","&gt;").replace(" & "," &amp; ")}catch(e){}return d.title=b,m},m.queues=[],m.busy=function(a){typeof a!="undefined"?m.busy.flag=a:typeof m.busy.flag=="undefined"&&(m.busy.flag=!1);if(!m.busy.flag){h(m.busy.timeout);var b=function(){var a,c,d;if(m.busy.flag)return;for(a=m.queues.length-1;a>=0;--a){c=m.queues[a];if(c.length===0)continue;d=c.shift(),m.fireQueueItem(d),m.busy.timeout=g(b,m.options.busyDelay)}};m.busy.timeout=g(b,m.options.busyDelay)}return m.busy.flag},m.busy.flag=!1,m.fireQueueItem=function(a){return a.callback.apply(a.scope||m,a.args||[])},m.pushQueue=function(a){return m.queues[a.queue||0]=m.queues[a.queue||0]||[],m.queues[a.queue||0].push(a),m},m.queue=function(a,b){return typeof a=="function"&&(a={callback:a}),typeof b!="undefined"&&(a.queue=b),m.busy()?m.pushQueue(a):m.fireQueueItem(a),m},m.clearQueue=function(){return m.busy.flag=!1,m.queues=[],m},m.stateChanged=!1,m.doubleChecker=!1,m.doubleCheckComplete=function(){return m.stateChanged=!0,m.doubleCheckClear(),m},m.doubleCheckClear=function(){return m.doubleChecker&&(h(m.doubleChecker),m.doubleChecker=!1),m},m.doubleCheck=function(a){return m.stateChanged=!1,m.doubleCheckClear(),m.bugs.ieDoubleCheck&&(m.doubleChecker=g(function(){return m.doubleCheckClear(),m.stateChanged||a(),!0},m.options.doubleCheckInterval)),m},m.safariStatePoll=function(){var b=m.extractState(d.location.href),c;if(!m.isLastSavedState(b))c=b;else return;return c||(c=m.createStateObject()),m.Adapter.trigger(a,"popstate"),m},m.back=function(a){return a!==!1&&m.busy()?(m.pushQueue({scope:m,callback:m.back,args:arguments,queue:a}),!1):(m.busy(!0),m.doubleCheck(function(){m.back(!1)}),n.go(-1),!0)},m.forward=function(a){return a!==!1&&m.busy()?(m.pushQueue({scope:m,callback:m.forward,args:arguments,queue:a}),!1):(m.busy(!0),m.doubleCheck(function(){m.forward(!1)}),n.go(1),!0)},m.go=function(a,b){var c;if(a>0)for(c=1;c<=a;++c)m.forward(b);else{if(!(a<0))throw new Error("History.go: History.go requires a positive or negative integer passed.");for(c=-1;c>=a;--c)m.back(b)}return m};if(m.emulated.pushState){var o=function(){};m.pushState=m.pushState||o,m.replaceState=m.replaceState||o}else m.onPopState=function(b,c){var e=!1,f=!1,g,h;return m.doubleCheckComplete(),g=m.getHash(),g?(h=m.extractState(g||d.location.href,!0),h?m.replaceState(h.data,h.title,h.url,!1):(m.Adapter.trigger(a,"anchorchange"),m.busy(!1)),m.expectedStateId=!1,!1):(e=m.Adapter.extractEventData("state",b,c)||!1,e?f=m.getStateById(e):m.expectedStateId?f=m.getStateById(m.expectedStateId):f=m.extractState(d.location.href),f||(f=m.createStateObject(null,null,d.location.href)),m.expectedStateId=!1,m.isLastSavedState(f)?(m.busy(!1),!1):(m.storeState(f),m.saveState(f),m.setTitle(f),m.Adapter.trigger(a,"statechange"),m.busy(!1),!0))},m.Adapter.bind(a,"popstate",m.onPopState),m.pushState=function(b,c,d,e){if(m.getHashByUrl(d)&&m.emulated.pushState)throw new Error("History.js does not support states with fragement-identifiers (hashes/anchors).");if(e!==!1&&m.busy())return m.pushQueue({scope:m,callback:m.pushState,args:arguments,queue:e}),!1;m.busy(!0);var f=m.createStateObject(b,c,d);return m.isLastSavedState(f)?m.busy(!1):(m.storeState(f),m.expectedStateId=f.id,n.pushState(f.id,f.title,f.url),m.Adapter.trigger(a,"popstate")),!0},m.replaceState=function(b,c,d,e){if(m.getHashByUrl(d)&&m.emulated.pushState)throw new Error("History.js does not support states with fragement-identifiers (hashes/anchors).");if(e!==!1&&m.busy())return m.pushQueue({scope:m,callback:m.replaceState,args:arguments,queue:e}),!1;m.busy(!0);var f=m.createStateObject(b,c,d);return m.isLastSavedState(f)?m.busy(!1):(m.storeState(f),m.expectedStateId=f.id,n.replaceState(f.id,f.title,f.url),m.Adapter.trigger(a,"popstate")),!0};if(f){try{m.store=k.parse(f.getItem("History.store"))||{}}catch(p){m.store={}}m.normalizeStore()}else m.store={},m.normalizeStore();m.Adapter.bind(a,"beforeunload",m.clearAllIntervals),m.Adapter.bind(a,"unload",m.clearAllIntervals),m.saveState(m.storeState(m.extractState(d.location.href,!0))),f&&(m.onUnload=function(){var a,b;try{a=k.parse(f.getItem("History.store"))||{}}catch(c){a={}}a.idToState=a.idToState||{},a.urlToId=a.urlToId||{},a.stateToId=a.stateToId||{};for(b in m.idToState){if(!m.idToState.hasOwnProperty(b))continue;a.idToState[b]=m.idToState[b]}for(b in m.urlToId){if(!m.urlToId.hasOwnProperty(b))continue;a.urlToId[b]=m.urlToId[b]}for(b in m.stateToId){if(!m.stateToId.hasOwnProperty(b))continue;a.stateToId[b]=m.stateToId[b]}m.store=a,m.normalizeStore(),f.setItem("History.store",k.stringify(a))},m.intervalList.push(i(m.onUnload,m.options.storeInterval)),m.Adapter.bind(a,"beforeunload",m.onUnload),m.Adapter.bind(a,"unload",m.onUnload));if(!m.emulated.pushState){m.bugs.safariPoll&&m.intervalList.push(i(m.safariStatePoll,m.options.safariPollInterval));if(e.vendor==="Apple Computer, Inc."||(e.appCodeName||"")==="Mozilla")m.Adapter.bind(a,"hashchange",function(){m.Adapter.trigger(a,"popstate")}),m.getHash()&&m.Adapter.onDomLoad(function(){m.Adapter.trigger(a,"hashchange")})}},m.init()}(window)
\ No newline at end of file

diff --git a/js/history.js/readme.txt b/js/history.js/readme.txt
new file mode 100644 (file)
index 0000000..1288d07
--- /dev/null
+++ b/js/history.js/readme.txt
@@ -0,0 +1,2 @@
+History.js (v1.7.1 - October 4 2011)
+http://github.com/balupton/history.js

diff --git a/js/params.js b/js/params.js
new file mode 100644 (file)
index 0000000..ac552a5
--- /dev/null
+++ b/js/params.js
@@ -0,0 +1,50 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+function sortedList_moveItem(paramName, direction, separator) {
+    var select = document.getElementById('select_' + paramName);
+    var inputField = document.getElementById('input_' + paramName);
+    var currentIndex = select.selectedIndex;
+    var newIndex = currentIndex + direction;
+    var optionCurrentIndex;
+    var optionNewIndex;
+
+    /* Return if no selection */
+    if (currentIndex < 0) return;
+    /* Return if trying to move upward out of list */
+    if (newIndex < 0) return;
+    /* Return if trying to move downward out of list */
+    if (newIndex >= select.length) return;
+
+    /* Move selection */
+    optionNewIndex = select.options[newIndex];
+    optionCurrentIndex = select.options[currentIndex];
+    /* Because some browsers don't accept the same option object twice in a
+     * selection list, we need to put a blank option here first */
+    select.options[newIndex] = new Option();
+    select.options[currentIndex] = optionNewIndex;
+    select.options[newIndex] = optionCurrentIndex;
+    select.selectedIndex = newIndex;
+    populateInputField(select, inputField, separator);
+}
+
+function populateInputField(select, inputField, separator) {
+    var i;
+    var stringRepresentation = '';
+
+    for (i = 0; i < select.length; i++) {
+        if (select.options[i].value == separator) {
+            break;
+        }
+        if (stringRepresentation != '') {
+            stringRepresentation += ',';
+        }
+        stringRepresentation += select.options[i].value;
+    }
+    inputField.value = stringRepresentation;
+}

diff --git a/js/productform.js b/js/productform.js
new file mode 100644 (file)
index 0000000..d5e24d3
--- /dev/null
+++ b/js/productform.js
@@ -0,0 +1,327 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+// Functions to update form select elements based on a
+// collection of javascript arrays containing strings.
+
+/**
+ * Reads the selected products and updates component, version and milestone
+ * lists accordingly.
+ *
+ * @param  product    Select element that contains products.
+ * @param  component  Select element that contains components. Can be null if
+ *                    there is no such element to update.
+ * @param  version    Select element that contains versions. Can be null if
+ *                    there is no such element to update.
+ * @param  milestone  Select element that contains milestones. Can be null if
+ *                    there is no such element to update.
+ * @param  anyval     Value to use for a special "Any" list item. Can be null
+ *                    to not use any. If used must and will be first item in
+ *                    the select element.
+ *
+ * @global cpts       Array of arrays, indexed by product name. The subarrays
+ *                    contain a list of components to be fed to the respective
+ *                    select element.
+ * @global vers       Array of arrays, indexed by product name. The subarrays
+ *                    contain a list of versions to be fed to the respective
+ *                    select element.
+ * @global tms        Array of arrays, indexed by product name. The subarrays
+ *                    contain a list of milestones to be fed to the respective
+ *                    select element.
+ * @global first_load Boolean; true if this is the first time this page loads
+ *                    or false if not.
+ * @global last_sel   Array that contains last list of products so we know what
+ *                    has changed, and optimize for additions.
+ */
+function selectProduct(product, component, version, milestone, anyval) {
+    // This is to avoid handling events that occur before the form
+    // itself is ready, which could happen in buggy browsers.
+    if (!product)
+        return;
+
+    // Do nothing if no products are defined. This is to avoid the
+    // "a has no properties" error from merge_arrays function.
+    if (product.length == (anyval != null ? 1 : 0))
+        return;
+
+    // If this is the first load and nothing is selected, no need to
+    // merge and sort all lists; they are created sorted.
+    if ((first_load) && (product.selectedIndex == -1)) {
+        first_load = false;
+        return;
+    }
+
+    // Turn first_load off. This is tricky, since it seems to be
+    // redundant with the above clause. It's not: if when we first load
+    // the page there is _one_ element selected, it won't fall into that
+    // clause, and first_load will remain 1. Then, if we unselect that
+    // item, selectProduct will be called but the clause will be valid
+    // (since selectedIndex == -1), and we will return - incorrectly -
+    // without merge/sorting.
+    first_load = false;
+
+    // Stores products that are selected.
+    var sel = Array();
+
+    // True if sel array has a full list or false if sel contains only
+    // new products that are to be merged to the current list.
+    var merging = false;
+
+    // If nothing is selected, or the special "Any" option is selected
+    // which represents all products, then pick all products so we show
+    // all components.
+    var findall = (product.selectedIndex == -1
+                   || (anyval != null && product.options[0].selected));
+
+    if (useclassification) {
+        // Update index based on the complete product array.
+        sel = get_selection(product, findall, true, anyval);
+        for (var i=0; i<sel.length; i++)
+           sel[i] = prods[sel[i]];
+    }
+    else {
+        sel = get_selection(product, findall, false, anyval);
+    }
+    if (!findall) {
+        // Save sel for the next invocation of selectProduct().
+        var tmp = sel;
+
+        // This is an optimization: if we have just added products to an
+        // existing selection, no need to clear the form controls and add
+        // everybody again; just merge the new ones with the existing
+        // options.
+        if ((last_sel.length > 0) && (last_sel.length < sel.length)) {
+            sel = fake_diff_array(sel, last_sel);
+            merging = true;
+        }
+        last_sel = tmp;
+    }
+
+    // Do the actual fill/update.
+    if (component) {
+        var saved_cpts = get_selection(component, false, true, null);
+        updateSelect(cpts, sel, component, merging, anyval);
+        restoreSelection(component, saved_cpts);
+    }
+
+    if (version) {
+        var saved_vers = get_selection(version, false, true, null);
+        updateSelect(vers, sel, version, merging, anyval);
+        restoreSelection(version, saved_vers);
+    }
+
+    if (milestone) {
+        var saved_tms = get_selection(milestone, false, true, null);
+        updateSelect(tms, sel, milestone, merging, anyval);
+        restoreSelection(milestone, saved_tms);
+    }
+}
+
+/**
+ * Adds to the target select element all elements from array that
+ * correspond to the selected items.
+ *
+ * @param array   An array of arrays, indexed by number. The array should
+ *                contain elements for each selection.
+ * @param sel     A list of selected items, either whole or a diff depending
+ *                on merging parameter.
+ * @param target  Select element that is to be updated.
+ * @param merging Boolean that determines if we are merging in a diff or
+ *                substituting the whole selection. A diff is used to optimize
+ *                adding selections.
+ * @param anyval  Name of special "Any" value to add. Can be null if not used.
+ * @return        Boolean; true if target contains options or false if target
+ *                is empty.
+ *
+ * Example (compsel is a select form element):
+ *
+ *     var components = Array();
+ *     components[1] = [ 'ComponentA', 'ComponentB' ];
+ *     components[2] = [ 'ComponentC', 'ComponentD' ];
+ *     source = [ 2 ];
+ *     updateSelect(components, source, compsel, false, null);
+ *
+ * This would clear compsel and add 'ComponentC' and 'ComponentD' to it.
+ */
+function updateSelect(array, sel, target, merging, anyval) {
+    var i, item;
+
+    // If we have no versions/components/milestones.
+    if (array.length < 1) {
+        target.options.length = 0;
+        return false;
+    }
+
+    if (merging) {
+        // Array merging/sorting in the case of multiple selections
+        // merge in the current options with the first selection.
+        item = merge_arrays(array[sel[0]], target.options, 1);
+
+        // Merge the rest of the selection with the results.
+        for (i = 1 ; i < sel.length ; i++)
+            item = merge_arrays(array[sel[i]], item, 0);
+    }
+    else if (sel.length > 1) {
+        // Here we micro-optimize for two arrays to avoid merging with a
+        // null array.
+        item = merge_arrays(array[sel[0]],array[sel[1]], 0);
+
+        // Merge the arrays. Not very good for multiple selections.
+        for (i = 2; i < sel.length; i++)
+            item = merge_arrays(item, array[sel[i]], 0);
+    }
+    else {
+        // Single item in selection, just get me the list.
+        item = array[sel[0]];
+    }
+
+    // Clear current selection.
+    target.options.length = 0;
+
+    // Add special "Any" value back to the list.
+    if (anyval != null)
+        target.options[0] = new Option(anyval, "");
+
+    // Load elements of list into select element.
+    for (i = 0; i < item.length; i++)
+        target.options[target.options.length] = new Option(item[i], item[i]);
+
+    return true;
+}
+
+/**
+ * Selects items in select element that are defined to be selected.
+ *
+ * @param control  Select element of which selected options are to be restored.
+ * @param selnames Array of option names to select.
+ */
+function restoreSelection(control, selnames) {
+    // Right. This sucks but I see no way to avoid going through the
+    // list and comparing to the contents of the control.
+    for (var j = 0; j < selnames.length; j++)
+        for (var i = 0; i < control.options.length; i++)
+            if (control.options[i].value == selnames[j])
+                control.options[i].selected = true;
+}
+
+/**
+ * Returns elements in a that are not in b.
+ * NOT A REAL DIFF: does not check the reverse.
+ *
+ * @param  a First array to compare.
+ * @param  b Second array to compare.
+ * @return   Array of elements in a but not in b.
+ */
+function fake_diff_array(a, b) {
+    var newsel = new Array();
+    var found = false;
+
+    // Do a boring array diff to see who's new.
+    for (var ia in a) {
+        for (var ib in b)
+            if (a[ia] == b[ib])
+                found = true;
+
+        if (!found)
+            newsel[newsel.length] = a[ia];
+
+        found = false;
+    }
+
+    return newsel;
+}
+
+/**
+ * Takes two arrays and sorts them by string, returning a new, sorted
+ * array. The merge removes dupes, too.
+ *
+ * @param  a           First array to merge.
+ * @param  b           Second array or an optionitem element to merge.
+ * @param  b_is_select Boolean; true if b is an optionitem element (need to
+ *                     access its value by item.value) or false if b is a
+ *                     an array.
+ * @return             Merged and sorted array.
+ */
+function merge_arrays(a, b, b_is_select) {
+    var pos_a = 0;
+    var pos_b = 0;
+    var ret = new Array();
+    var bitem, aitem;
+
+    // Iterate through both arrays and add the larger item to the return
+    // list. Remove dupes, too. Use toLowerCase to provide
+    // case-insensitivity.
+    while ((pos_a < a.length) && (pos_b < b.length)) {
+        aitem = a[pos_a];
+        if (b_is_select)
+            bitem = b[pos_b].value;
+        else
+            bitem = b[pos_b];
+
+        // Smaller item in list a.
+        if (aitem.toLowerCase() < bitem.toLowerCase()) {
+            ret[ret.length] = aitem;
+            pos_a++;
+        }
+        else {
+            // Smaller item in list b.
+            if (aitem.toLowerCase() > bitem.toLowerCase()) {
+                ret[ret.length] = bitem;
+                pos_b++;
+            }
+            else {
+                // List contents are equal, include both counters.
+                ret[ret.length] = aitem;
+                pos_a++;
+                pos_b++;
+            }
+        }
+    }
+
+    // Catch leftovers here. These sections are ugly code-copying.
+    if (pos_a < a.length)
+        for (; pos_a < a.length ; pos_a++)
+            ret[ret.length] = a[pos_a];
+
+    if (pos_b < b.length) {
+        for (; pos_b < b.length; pos_b++) {
+            if (b_is_select)
+                bitem = b[pos_b].value;
+            else
+                bitem = b[pos_b];
+            ret[ret.length] = bitem;
+        }
+    }
+
+    return ret;
+}
+
+/**
+ * Returns an array of indexes or values of options in a select form element.
+ *
+ * @param  control     Select form element from which to find selections.
+ * @param  findall     Boolean; true to return all options or false to return
+ *                     only selected options.
+ * @param  want_values Boolean; true to return values and false to return
+ *                     indexes.
+ * @param  anyval      Name of a special "Any" value that should be skipped. Can
+ *                     be null if not used.
+ * @return             Array of all or selected indexes or values.
+ */
+function get_selection(control, findall, want_values, anyval) {
+    var ret = new Array();
+
+    if ((!findall) && (control.selectedIndex == -1))
+        return ret;
+
+    for (var i = (anyval != null ? 1 : 0); i < control.length; i++)
+        if (findall || control.options[i].selected)
+            ret[ret.length] = want_values ? control.options[i].value : i;
+
+    return ret;
+}

diff --git a/js/util.js b/js/util.js
new file mode 100644 (file)
index 0000000..6d1f889
--- /dev/null
+++ b/js/util.js
@@ -0,0 +1,305 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+/**
+ * Locate where an element is on the page, x-wise.
+ *
+ * @param  obj Element of which location to return.
+ * @return     Current position of the element relative to the left of the
+ *             page window. Measured in pixels.
+ */
+function bz_findPosX(obj)
+{
+    var curleft = 0;
+
+    if (obj.offsetParent) {
+        while (obj) {
+            curleft += obj.offsetLeft;
+            obj = obj.offsetParent;
+        }
+    }
+    else if (obj.x) {
+        curleft += obj.x;
+    }
+
+    return curleft;
+}
+
+/**
+ * Locate where an element is on the page, y-wise.
+ *
+ * @param  obj Element of which location to return.
+ * @return     Current position of the element relative to the top of the
+ *             page window. Measured in pixels.
+ */
+function bz_findPosY(obj)
+{
+    var curtop = 0;
+
+    if (obj.offsetParent) {
+        while (obj) {
+            curtop += obj.offsetTop;
+            obj = obj.offsetParent;
+        }
+    }
+    else if (obj.y) {
+        curtop += obj.y;
+    }
+
+    return curtop;
+}
+
+/**
+ * Get the full height of an element, even if it's larger than the browser
+ * window.
+ *
+ * @param  fromObj Element of which height to return.
+ * @return         Current height of the element. Measured in pixels.
+ */
+function bz_getFullHeight(fromObj)
+{
+    var scrollY;
+
+    // All but Mac IE
+    if (fromObj.scrollHeight > fromObj.offsetHeight) {
+        scrollY = fromObj.scrollHeight;
+    // Mac IE
+    }  else {
+        scrollY = fromObj.offsetHeight;
+    }
+
+    return scrollY;
+}
+
+/**
+ * Get the full width of an element, even if it's larger than the browser
+ * window.
+ *
+ * @param  fromObj Element of which width to return.
+ * @return         Current width of the element. Measured in pixels.
+ */
+function bz_getFullWidth(fromObj)
+{
+    var scrollX;
+
+    // All but Mac IE
+    if (fromObj.scrollWidth > fromObj.offsetWidth) {
+        scrollX = fromObj.scrollWidth;
+    // Mac IE
+    }  else {
+        scrollX = fromObj.offsetWidth;
+    }
+
+    return scrollX;
+}
+
+/**
+ * Causes a block to appear directly underneath another block,
+ * overlaying anything below it.
+ * 
+ * @param item   The block that you want to move.
+ * @param parent The block that it goes on top of.
+ * @return nothing
+ */
+function bz_overlayBelow(item, parent) {
+    var elemY = bz_findPosY(parent);
+    var elemX = bz_findPosX(parent);
+    var elemH = parent.offsetHeight;
+
+    item.style.position = 'absolute';
+    item.style.left = elemX + "px";
+    item.style.top = elemY + elemH + 1 + "px";
+}
+
+/**
+ * Checks if a specified value is in the specified array.
+ *
+ * @param  aArray Array to search for the value.
+ * @param  aValue Value to search from the array.
+ * @return        Boolean; true if value is found in the array and false if not.
+ */
+function bz_isValueInArray(aArray, aValue)
+{
+  var run = 0;
+  var len = aArray.length;
+
+  for ( ; run < len; run++) {
+    if (aArray[run] == aValue) {
+      return true;
+    }
+  }
+
+  return false;
+}
+
+/**
+ * Create wanted options in a select form control.
+ *
+ * @param  aSelect        Select form control to manipulate.
+ * @param  aValue         Value attribute of the new option element.
+ * @param  aTextValue     Value of a text node appended to the new option
+ *                        element.
+ * @return                Created option element.
+ */
+function bz_createOptionInSelect(aSelect, aTextValue, aValue) {
+  var myOption = new Option(aTextValue, aValue);
+  aSelect.options[aSelect.length] = myOption;
+  return myOption;
+}
+
+/**
+ * Clears all options from a select form control.
+ *
+ * @param  aSelect    Select form control of which options to clear.
+ */
+function bz_clearOptions(aSelect) {
+
+  var length = aSelect.options.length;
+
+  for (var i = 0; i < length; i++) {
+    aSelect.removeChild(aSelect.options[0]);
+  }
+}
+
+/**
+ * Takes an array and moves all the values to an select.
+ *
+ * @param aSelect         Select form control to populate. Will be cleared
+ *                        before array values are created in it.
+ * @param aArray          Array with values to populate select with.
+ */
+function bz_populateSelectFromArray(aSelect, aArray) {
+  // Clear the field
+  bz_clearOptions(aSelect);
+
+  for (var i = 0; i < aArray.length; i++) {
+    var item = aArray[i];
+    bz_createOptionInSelect(aSelect, item[1], item[0]);
+  }
+}
+
+/**
+ * Tells you whether or not a particular value is selected in a select,
+ * whether it's a multi-select or a single-select. The check is 
+ * case-sensitive.
+ *
+ * @param aSelect        The select you're checking.
+ * @param aValue         The value that you want to know about.
+ */
+function bz_valueSelected(aSelect, aValue) {
+    var options = aSelect.options;
+    for (var i = 0; i < options.length; i++) {
+        if (options[i].selected && options[i].value == aValue) {
+            return true;
+        }
+    }
+    return false;
+}
+
+/**
+ * Returns all Option elements that are selected in a <select>,
+ * as an array. Returns an empty array if nothing is selected.
+ *
+ * @param aSelect The select you want the selected values of.
+ */
+function bz_selectedOptions(aSelect) {
+    // HTML 5
+    if (aSelect.selectedOptions) {
+        return aSelect.selectedOptions;
+    }
+
+    var start_at = aSelect.selectedIndex;
+    if (start_at == -1) return [];
+    var first_selected =  aSelect.options[start_at];
+    if (!aSelect.multiple) return first_selected;
+    // selectedIndex is specified as being the "first selected item",
+    // so we can start from there.
+    var selected = [first_selected];
+    var options_length = aSelect.options.length;
+    // We start after first_selected
+    for (var i = start_at + 1; i < options_length; i++) {
+        var this_option = aSelect.options[i];
+        if (this_option.selected) selected.push(this_option);
+    }
+    return selected;
+}
+
+/**
+ * Returns all Option elements that have the "selected" attribute, as an array.
+ * Returns an empty array if nothing is selected.
+ *
+ * @param aSelect The select you want the pre-selected values of.
+ */
+function bz_preselectedOptions(aSelect) {
+    var options = aSelect.options;
+    var selected = new Array();
+    for (var i = 0, l = options.length; i < l; i++) {
+        var attributes = options[i].attributes;
+        for (var j = 0, m = attributes.length; j < m; j++) {
+            if (attributes[j].name == 'selected') {
+                if (!aSelect.multiple) return options[i];
+                selected.push(options[i]);
+            }
+        }
+    }
+    return selected;
+}
+
+/**
+ * Tells you where (what index) in a <select> a particular option is.
+ * Returns -1 if the value is not in the <select>
+ *
+ * @param aSelect       The select you're checking.
+ * @param aValue        The value you want to know the index of.
+ */
+function bz_optionIndex(aSelect, aValue) {
+    for (var i = 0; i < aSelect.options.length; i++) {
+        if (aSelect.options[i].value == aValue) {
+            return i;
+        }
+    }
+    return -1;
+}
+
+/**
+ * Used to fire an event programmatically.
+ * 
+ * @param anElement      The element you want to fire the event of.
+ * @param anEvent        The name of the event you want to fire, 
+ *                       without the word "on" in front of it.
+ */
+function bz_fireEvent(anElement, anEvent) {
+    if (document.createEvent) {
+        // DOM-compliant browser
+        var evt = document.createEvent("HTMLEvents");
+        evt.initEvent(anEvent, true, true);
+        return !anElement.dispatchEvent(evt);
+    } else {
+        // IE
+        var evt = document.createEventObject();
+        return anElement.fireEvent('on' + anEvent, evt);
+    }
+}
+
+/**
+ * Adds a CSS class to an element if it doesn't have it. Removes the
+ * CSS class from the element if the element does have the class.
+ *
+ * Requires YUI's Dom library.
+ *
+ * @param anElement  The element to toggle the class on
+ * @param aClass     The name of the CSS class to toggle.
+ */
+function bz_toggleClass(anElement, aClass) {
+    if (YAHOO.util.Dom.hasClass(anElement, aClass)) {
+        YAHOO.util.Dom.removeClass(anElement, aClass);
+    }
+    else {
+        YAHOO.util.Dom.addClass(anElement, aClass);
+    }
+}

diff --git a/js/yui/animation/animation-min.js b/js/yui/animation/animation-min.js
new file mode 100644 (file)
index 0000000..26dde3d
--- /dev/null
+++ b/js/yui/animation/animation-min.js
@@ -0,0 +1,23 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){var b=YAHOO.util;var a=function(d,c,e,f){if(!d){}this.init(d,c,e,f);};a.NAME="Anim";a.prototype={toString:function(){var c=this.getEl()||{};var d=c.id||c.tagName;return(this.constructor.NAME+": "+d);},patterns:{noNegatives:/width|height|opacity|padding/i,offsetAttribute:/^((width|height)|(top|left))$/,defaultUnit:/width|height|top$|bottom$|left$|right$/i,offsetUnit:/\d+(em|%|en|ex|pt|in|cm|mm|pc)$/i},doMethod:function(c,e,d){return this.method(this.currentFrame,e,d-e,this.totalFrames);},setAttribute:function(c,f,e){var d=this.getEl();if(this.patterns.noNegatives.test(c)){f=(f>0)?f:0;}if(c in d&&!("style" in d&&c in d.style)){d[c]=f;}else{b.Dom.setStyle(d,c,f+e);}},getAttribute:function(c){var e=this.getEl();var g=b.Dom.getStyle(e,c);if(g!=="auto"&&!this.patterns.offsetUnit.test(g)){return parseFloat(g);}var d=this.patterns.offsetAttribute.exec(c)||[];var h=!!(d[3]);var f=!!(d[2]);if("style" in e){if(f||(b.Dom.getStyle(e,"position")=="absolute"&&h)){g=e["offset"+d[0].charAt(0).toUpperCase()+d[0].substr(1)];}else{g=0;}}else{if(c in e){g=e[c];}}return g;},getDefaultUnit:function(c){if(this.patterns.defaultUnit.test(c)){return"px";}return"";},setRuntimeAttribute:function(d){var j;var e;var f=this.attributes;this.runtimeAttributes[d]={};var h=function(i){return(typeof i!=="undefined");};if(!h(f[d]["to"])&&!h(f[d]["by"])){return false;}j=(h(f[d]["from"]))?f[d]["from"]:this.getAttribute(d);if(h(f[d]["to"])){e=f[d]["to"];}else{if(h(f[d]["by"])){if(j.constructor==Array){e=[];for(var g=0,c=j.length;g<c;++g){e[g]=j[g]+f[d]["by"][g]*1;}}else{e=j+f[d]["by"]*1;}}}this.runtimeAttributes[d].start=j;this.runtimeAttributes[d].end=e;this.runtimeAttributes[d].unit=(h(f[d].unit))?f[d]["unit"]:this.getDefaultUnit(d);return true;},init:function(f,c,h,i){var d=false;var e=null;var g=0;f=b.Dom.get(f);this.attributes=c||{};this.duration=!YAHOO.lang.isUndefined(h)?h:1;this.method=i||b.Easing.easeNone;this.useSeconds=true;this.currentFrame=0;this.totalFrames=b.AnimMgr.fps;this.setEl=function(j){f=b.Dom.get(j);};this.getEl=function(){return f;};this.isAnimated=function(){return d;};this.getStartTime=function(){return e;};this.runtimeAttributes={};this.animate=function(){if(this.isAnimated()){return false;}this.currentFrame=0;this.totalFrames=(this.useSeconds)?Math.ceil(b.AnimMgr.fps*this.duration):this.duration;if(this.duration===0&&this.useSeconds){this.totalFrames=1;}b.AnimMgr.registerElement(this);return true;};this.stop=function(j){if(!this.isAnimated()){return false;}if(j){this.currentFrame=this.totalFrames;this._onTween.fire();}b.AnimMgr.stop(this);};this._handleStart=function(){this.onStart.fire();this.runtimeAttributes={};for(var j in this.attributes){if(this.attributes.hasOwnProperty(j)){this.setRuntimeAttribute(j);}}d=true;g=0;e=new Date();};this._handleTween=function(){var l={duration:new Date()-this.getStartTime(),currentFrame:this.currentFrame};l.toString=function(){return("duration: "+l.duration+", currentFrame: "+l.currentFrame);};this.onTween.fire(l);var k=this.runtimeAttributes;for(var j in k){if(k.hasOwnProperty(j)){this.setAttribute(j,this.doMethod(j,k[j].start,k[j].end),k[j].unit);}}this.afterTween.fire(l);g+=1;};this._handleComplete=function(){var j=(new Date()-e)/1000;var k={duration:j,frames:g,fps:g/j};k.toString=function(){return("duration: "+k.duration+", frames: "+k.frames+", fps: "+k.fps);};d=false;g=0;this.onComplete.fire(k);};this._onStart=new b.CustomEvent("_start",this,true);this.onStart=new b.CustomEvent("start",this);this.onTween=new b.CustomEvent("tween",this);this.afterTween=new b.CustomEvent("afterTween",this);this._onTween=new b.CustomEvent("_tween",this,true);this.onComplete=new b.CustomEvent("complete",this);this._onComplete=new b.CustomEvent("_complete",this,true);this._onStart.subscribe(this._handleStart);this._onTween.subscribe(this._handleTween);this._onComplete.subscribe(this._handleComplete);}};b.Anim=a;})();YAHOO.util.AnimMgr=new function(){var e=null;var c=[];var g=0;this.fps=1000;this.delay=20;this.registerElement=function(j){c[c.length]=j;g+=1;j._onStart.fire();this.start();};var f=[];var d=false;var h=function(){var j=f.shift();b.apply(YAHOO.util.AnimMgr,j);if(f.length){arguments.callee();}};var b=function(k,j){j=j||a(k);if(!k.isAnimated()||j===-1){return false;}k._onComplete.fire();c.splice(j,1);g-=1;if(g<=0){this.stop();}return true;};this.unRegister=function(){f.push(arguments);if(!d){d=true;h();d=false;}};this.start=function(){if(e===null){e=setInterval(this.run,this.delay);}};this.stop=function(l){if(!l){clearInterval(e);for(var k=0,j=c.length;k<j;++k){this.unRegister(c[0],0);}c=[];e=null;g=0;}else{this.unRegister(l);}};this.run=function(){for(var l=0,j=c.length;l<j;++l){var k=c[l];if(!k||!k.isAnimated()){continue;}if(k.currentFrame<k.totalFrames||k.totalFrames===null){k.currentFrame+=1;if(k.useSeconds){i(k);}k._onTween.fire();}else{YAHOO.util.AnimMgr.stop(k,l);}}};var a=function(l){for(var k=0,j=c.length;k<j;++k){if(c[k]===l){return k;}}return -1;};var i=function(k){var n=k.totalFrames;var m=k.currentFrame;var l=(k.currentFrame*k.duration*1000/k.totalFrames);var j=(new Date()-k.getStartTime());var o=0;if(j<k.duration*1000){o=Math.round((j/l-1)*k.currentFrame);}else{o=n-(m+1);}if(o>0&&isFinite(o)){if(k.currentFrame+o>=n){o=n-(m+1);}k.currentFrame+=o;}};this._queue=c;this._getIndex=a;};YAHOO.util.Bezier=new function(){this.getPosition=function(e,d){var f=e.length;var c=[];for(var b=0;b<f;++b){c[b]=[e[b][0],e[b][1]];}for(var a=1;a<f;++a){for(b=0;b<f-a;++b){c[b][0]=(1-d)*c[b][0]+d*c[parseInt(b+1,10)][0];c[b][1]=(1-d)*c[b][1]+d*c[parseInt(b+1,10)][1];}}return[c[0][0],c[0][1]];};};(function(){var a=function(f,e,g,h){a.superclass.constructor.call(this,f,e,g,h);};a.NAME="ColorAnim";a.DEFAULT_BGCOLOR="#fff";var c=YAHOO.util;YAHOO.extend(a,c.Anim);var d=a.superclass;var b=a.prototype;b.patterns.color=/color$/i;b.patterns.rgb=/^rgb\(([0-9]+)\s*,\s*([0-9]+)\s*,\s*([0-9]+)\)$/i;b.patterns.hex=/^#?([0-9A-F]{2})([0-9A-F]{2})([0-9A-F]{2})$/i;b.patterns.hex3=/^#?([0-9A-F]{1})([0-9A-F]{1})([0-9A-F]{1})$/i;
+b.patterns.transparent=/^transparent|rgba\(0, 0, 0, 0\)$/;b.parseColor=function(e){if(e.length==3){return e;}var f=this.patterns.hex.exec(e);if(f&&f.length==4){return[parseInt(f[1],16),parseInt(f[2],16),parseInt(f[3],16)];}f=this.patterns.rgb.exec(e);if(f&&f.length==4){return[parseInt(f[1],10),parseInt(f[2],10),parseInt(f[3],10)];}f=this.patterns.hex3.exec(e);if(f&&f.length==4){return[parseInt(f[1]+f[1],16),parseInt(f[2]+f[2],16),parseInt(f[3]+f[3],16)];}return null;};b.getAttribute=function(e){var g=this.getEl();if(this.patterns.color.test(e)){var i=YAHOO.util.Dom.getStyle(g,e);var h=this;if(this.patterns.transparent.test(i)){var f=YAHOO.util.Dom.getAncestorBy(g,function(j){return !h.patterns.transparent.test(i);});if(f){i=c.Dom.getStyle(f,e);}else{i=a.DEFAULT_BGCOLOR;}}}else{i=d.getAttribute.call(this,e);}return i;};b.doMethod=function(f,k,g){var j;if(this.patterns.color.test(f)){j=[];for(var h=0,e=k.length;h<e;++h){j[h]=d.doMethod.call(this,f,k[h],g[h]);}j="rgb("+Math.floor(j[0])+","+Math.floor(j[1])+","+Math.floor(j[2])+")";}else{j=d.doMethod.call(this,f,k,g);}return j;};b.setRuntimeAttribute=function(f){d.setRuntimeAttribute.call(this,f);if(this.patterns.color.test(f)){var h=this.attributes;var k=this.parseColor(this.runtimeAttributes[f].start);var g=this.parseColor(this.runtimeAttributes[f].end);if(typeof h[f]["to"]==="undefined"&&typeof h[f]["by"]!=="undefined"){g=this.parseColor(h[f].by);for(var j=0,e=k.length;j<e;++j){g[j]=k[j]+g[j];}}this.runtimeAttributes[f].start=k;this.runtimeAttributes[f].end=g;}};c.ColorAnim=a;})();
+/*!
+TERMS OF USE - EASING EQUATIONS
+Open source under the BSD License.
+Copyright 2001 Robert Penner All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+ * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+ * Neither the name of the author nor the names of contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+*/
+YAHOO.util.Easing={easeNone:function(e,a,g,f){return g*e/f+a;},easeIn:function(e,a,g,f){return g*(e/=f)*e+a;},easeOut:function(e,a,g,f){return -g*(e/=f)*(e-2)+a;},easeBoth:function(e,a,g,f){if((e/=f/2)<1){return g/2*e*e+a;}return -g/2*((--e)*(e-2)-1)+a;},easeInStrong:function(e,a,g,f){return g*(e/=f)*e*e*e+a;},easeOutStrong:function(e,a,g,f){return -g*((e=e/f-1)*e*e*e-1)+a;},easeBothStrong:function(e,a,g,f){if((e/=f/2)<1){return g/2*e*e*e*e+a;}return -g/2*((e-=2)*e*e*e-2)+a;},elasticIn:function(g,e,k,j,f,i){if(g==0){return e;}if((g/=j)==1){return e+k;}if(!i){i=j*0.3;}if(!f||f<Math.abs(k)){f=k;var h=i/4;}else{var h=i/(2*Math.PI)*Math.asin(k/f);}return -(f*Math.pow(2,10*(g-=1))*Math.sin((g*j-h)*(2*Math.PI)/i))+e;},elasticOut:function(g,e,k,j,f,i){if(g==0){return e;}if((g/=j)==1){return e+k;}if(!i){i=j*0.3;}if(!f||f<Math.abs(k)){f=k;var h=i/4;}else{var h=i/(2*Math.PI)*Math.asin(k/f);}return f*Math.pow(2,-10*g)*Math.sin((g*j-h)*(2*Math.PI)/i)+k+e;},elasticBoth:function(g,e,k,j,f,i){if(g==0){return e;}if((g/=j/2)==2){return e+k;}if(!i){i=j*(0.3*1.5);}if(!f||f<Math.abs(k)){f=k;var h=i/4;}else{var h=i/(2*Math.PI)*Math.asin(k/f);}if(g<1){return -0.5*(f*Math.pow(2,10*(g-=1))*Math.sin((g*j-h)*(2*Math.PI)/i))+e;}return f*Math.pow(2,-10*(g-=1))*Math.sin((g*j-h)*(2*Math.PI)/i)*0.5+k+e;},backIn:function(e,a,h,g,f){if(typeof f=="undefined"){f=1.70158;}return h*(e/=g)*e*((f+1)*e-f)+a;},backOut:function(e,a,h,g,f){if(typeof f=="undefined"){f=1.70158;}return h*((e=e/g-1)*e*((f+1)*e+f)+1)+a;},backBoth:function(e,a,h,g,f){if(typeof f=="undefined"){f=1.70158;}if((e/=g/2)<1){return h/2*(e*e*(((f*=(1.525))+1)*e-f))+a;}return h/2*((e-=2)*e*(((f*=(1.525))+1)*e+f)+2)+a;},bounceIn:function(e,a,g,f){return g-YAHOO.util.Easing.bounceOut(f-e,0,g,f)+a;},bounceOut:function(e,a,g,f){if((e/=f)<(1/2.75)){return g*(7.5625*e*e)+a;}else{if(e<(2/2.75)){return g*(7.5625*(e-=(1.5/2.75))*e+0.75)+a;}else{if(e<(2.5/2.75)){return g*(7.5625*(e-=(2.25/2.75))*e+0.9375)+a;}}}return g*(7.5625*(e-=(2.625/2.75))*e+0.984375)+a;},bounceBoth:function(e,a,g,f){if(e<f/2){return YAHOO.util.Easing.bounceIn(e*2,0,g,f)*0.5+a;}return YAHOO.util.Easing.bounceOut(e*2-f,0,g,f)*0.5+g*0.5+a;}};(function(){var a=function(h,g,i,j){if(h){a.superclass.constructor.call(this,h,g,i,j);}};a.NAME="Motion";var e=YAHOO.util;YAHOO.extend(a,e.ColorAnim);var f=a.superclass;var c=a.prototype;c.patterns.points=/^points$/i;c.setAttribute=function(g,i,h){if(this.patterns.points.test(g)){h=h||"px";f.setAttribute.call(this,"left",i[0],h);f.setAttribute.call(this,"top",i[1],h);}else{f.setAttribute.call(this,g,i,h);}};c.getAttribute=function(g){if(this.patterns.points.test(g)){var h=[f.getAttribute.call(this,"left"),f.getAttribute.call(this,"top")];}else{h=f.getAttribute.call(this,g);}return h;};c.doMethod=function(g,k,h){var j=null;if(this.patterns.points.test(g)){var i=this.method(this.currentFrame,0,100,this.totalFrames)/100;j=e.Bezier.getPosition(this.runtimeAttributes[g],i);
+}else{j=f.doMethod.call(this,g,k,h);}return j;};c.setRuntimeAttribute=function(q){if(this.patterns.points.test(q)){var h=this.getEl();var k=this.attributes;var g;var m=k["points"]["control"]||[];var j;var n,p;if(m.length>0&&!(m[0] instanceof Array)){m=[m];}else{var l=[];for(n=0,p=m.length;n<p;++n){l[n]=m[n];}m=l;}if(e.Dom.getStyle(h,"position")=="static"){e.Dom.setStyle(h,"position","relative");}if(d(k["points"]["from"])){e.Dom.setXY(h,k["points"]["from"]);}else{e.Dom.setXY(h,e.Dom.getXY(h));}g=this.getAttribute("points");if(d(k["points"]["to"])){j=b.call(this,k["points"]["to"],g);var o=e.Dom.getXY(this.getEl());for(n=0,p=m.length;n<p;++n){m[n]=b.call(this,m[n],g);}}else{if(d(k["points"]["by"])){j=[g[0]+k["points"]["by"][0],g[1]+k["points"]["by"][1]];for(n=0,p=m.length;n<p;++n){m[n]=[g[0]+m[n][0],g[1]+m[n][1]];}}}this.runtimeAttributes[q]=[g];if(m.length>0){this.runtimeAttributes[q]=this.runtimeAttributes[q].concat(m);}this.runtimeAttributes[q][this.runtimeAttributes[q].length]=j;}else{f.setRuntimeAttribute.call(this,q);}};var b=function(g,i){var h=e.Dom.getXY(this.getEl());g=[g[0]-h[0]+i[0],g[1]-h[1]+i[1]];return g;};var d=function(g){return(typeof g!=="undefined");};e.Motion=a;})();(function(){var d=function(f,e,g,h){if(f){d.superclass.constructor.call(this,f,e,g,h);}};d.NAME="Scroll";var b=YAHOO.util;YAHOO.extend(d,b.ColorAnim);var c=d.superclass;var a=d.prototype;a.doMethod=function(e,h,f){var g=null;if(e=="scroll"){g=[this.method(this.currentFrame,h[0],f[0]-h[0],this.totalFrames),this.method(this.currentFrame,h[1],f[1]-h[1],this.totalFrames)];}else{g=c.doMethod.call(this,e,h,f);}return g;};a.getAttribute=function(e){var g=null;var f=this.getEl();if(e=="scroll"){g=[f.scrollLeft,f.scrollTop];}else{g=c.getAttribute.call(this,e);}return g;};a.setAttribute=function(e,h,g){var f=this.getEl();if(e=="scroll"){f.scrollLeft=h[0];f.scrollTop=h[1];}else{c.setAttribute.call(this,e,h,g);}};b.Scroll=d;})();YAHOO.register("animation",YAHOO.util.Anim,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/assets/skins/sam/ajax-loader.gif b/js/yui/assets/skins/sam/ajax-loader.gif
new file mode 100644 (file)
index 0000000..fe2cd23
Binary files /dev/null and b/js/yui/assets/skins/sam/ajax-loader.gif differ

diff --git a/js/yui/assets/skins/sam/asc.gif b/js/yui/assets/skins/sam/asc.gif
new file mode 100644 (file)
index 0000000..a1fe738
Binary files /dev/null and b/js/yui/assets/skins/sam/asc.gif differ

diff --git a/js/yui/assets/skins/sam/autocomplete.css b/js/yui/assets/skins/sam/autocomplete.css
new file mode 100644 (file)
index 0000000..54541c5
--- /dev/null
+++ b/js/yui/assets/skins/sam/autocomplete.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+.yui-skin-sam .yui-ac{position:relative;font-family:arial;font-size:100%}.yui-skin-sam .yui-ac-input{position:absolute;width:100%}.yui-skin-sam .yui-ac-container{position:absolute;top:1.6em;width:100%}.yui-skin-sam .yui-ac-content{position:absolute;width:100%;border:1px solid #808080;background:#fff;overflow:hidden;z-index:9050}.yui-skin-sam .yui-ac-shadow{position:absolute;margin:.3em;width:100%;background:#000;-moz-opacity:.10;opacity:.10;filter:alpha(opacity=10);z-index:9049}.yui-skin-sam .yui-ac iframe{opacity:0;filter:alpha(opacity=0);padding-right:.3em;padding-bottom:.3em}.yui-skin-sam .yui-ac-content ul{margin:0;padding:0;width:100%}.yui-skin-sam .yui-ac-content li{margin:0;padding:2px 5px;cursor:default;white-space:nowrap;list-style:none;zoom:1}.yui-skin-sam .yui-ac-content li.yui-ac-prehighlight{background:#b3d4ff}.yui-skin-sam .yui-ac-content li.yui-ac-highlight{background:#426fd9;color:#FFF}

diff --git a/js/yui/assets/skins/sam/back-h.png b/js/yui/assets/skins/sam/back-h.png
new file mode 100644 (file)
index 0000000..5f69f4e
Binary files /dev/null and b/js/yui/assets/skins/sam/back-h.png differ

diff --git a/js/yui/assets/skins/sam/back-v.png b/js/yui/assets/skins/sam/back-v.png
new file mode 100644 (file)
index 0000000..658574a
Binary files /dev/null and b/js/yui/assets/skins/sam/back-v.png differ

diff --git a/js/yui/assets/skins/sam/bar-h.png b/js/yui/assets/skins/sam/bar-h.png
new file mode 100644 (file)
index 0000000..fea13b1
Binary files /dev/null and b/js/yui/assets/skins/sam/bar-h.png differ

diff --git a/js/yui/assets/skins/sam/bar-v.png b/js/yui/assets/skins/sam/bar-v.png
new file mode 100644 (file)
index 0000000..2efd664
Binary files /dev/null and b/js/yui/assets/skins/sam/bar-v.png differ

diff --git a/js/yui/assets/skins/sam/bg-h.gif b/js/yui/assets/skins/sam/bg-h.gif
new file mode 100644 (file)
index 0000000..9962889
Binary files /dev/null and b/js/yui/assets/skins/sam/bg-h.gif differ

diff --git a/js/yui/assets/skins/sam/bg-v.gif b/js/yui/assets/skins/sam/bg-v.gif
new file mode 100644 (file)
index 0000000..8e287cd
Binary files /dev/null and b/js/yui/assets/skins/sam/bg-v.gif differ

diff --git a/js/yui/assets/skins/sam/blankimage.png b/js/yui/assets/skins/sam/blankimage.png
new file mode 100644 (file)
index 0000000..b87bb24
Binary files /dev/null and b/js/yui/assets/skins/sam/blankimage.png differ

diff --git a/js/yui/assets/skins/sam/button.css b/js/yui/assets/skins/sam/button.css
new file mode 100644 (file)
index 0000000..c54fc72
--- /dev/null
+++ b/js/yui/assets/skins/sam/button.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+.yui-button{display:-moz-inline-box;display:inline-block;vertical-align:text-bottom;}.yui-button .first-child{display:block;*display:inline-block;}.yui-button button,.yui-button a{display:block;*display:inline-block;border:none;margin:0;}.yui-button button{background-color:transparent;*overflow:visible;cursor:pointer;}.yui-button a{text-decoration:none;}.yui-skin-sam .yui-button{border-width:1px 0;border-style:solid;border-color:#808080;background:url(sprite.png) repeat-x 0 0;margin:auto .25em;}.yui-skin-sam .yui-button .first-child{border-width:0 1px;border-style:solid;border-color:#808080;margin:0 -1px;_margin:0;}.yui-skin-sam .yui-button button,.yui-skin-sam .yui-button a,.yui-skin-sam .yui-button a:visited{padding:0 10px;font-size:93%;line-height:2;*line-height:1.7;min-height:2em;*min-height:auto;color:#000;}.yui-skin-sam .yui-button a{*line-height:1.875;*padding-bottom:1px;}.yui-skin-sam .yui-split-button button,.yui-skin-sam .yui-menu-button button{padding-right:20px;background-position:right center;background-repeat:no-repeat;}.yui-skin-sam .yui-menu-button button{background-image:url(menu-button-arrow.png);}.yui-skin-sam .yui-split-button button{background-image:url(split-button-arrow.png);}.yui-skin-sam .yui-button-focus{border-color:#7D98B8;background-position:0 -1300px;}.yui-skin-sam .yui-button-focus .first-child{border-color:#7D98B8;}.yui-skin-sam .yui-split-button-focus button{background-image:url(split-button-arrow-focus.png);}.yui-skin-sam .yui-button-hover{border-color:#7D98B8;background-position:0 -1300px;}.yui-skin-sam .yui-button-hover .first-child{border-color:#7D98B8;}.yui-skin-sam .yui-split-button-hover button{background-image:url(split-button-arrow-hover.png);}.yui-skin-sam .yui-button-active{border-color:#7D98B8;background-position:0 -1700px;}.yui-skin-sam .yui-button-active .first-child{border-color:#7D98B8;}.yui-skin-sam .yui-split-button-activeoption{border-color:#808080;background-position:0 0;}.yui-skin-sam .yui-split-button-activeoption .first-child{border-color:#808080;}.yui-skin-sam .yui-split-button-activeoption button{background-image:url(split-button-arrow-active.png);}.yui-skin-sam .yui-radio-button-checked,.yui-skin-sam .yui-checkbox-button-checked{border-color:#304369;background-position:0 -1400px;}.yui-skin-sam .yui-radio-button-checked .first-child,.yui-skin-sam .yui-checkbox-button-checked .first-child{border-color:#304369;}.yui-skin-sam .yui-radio-button-checked button,.yui-skin-sam .yui-checkbox-button-checked button{color:#fff;}.yui-skin-sam .yui-button-disabled{border-color:#ccc;background-position:0 -1500px;}.yui-skin-sam .yui-button-disabled .first-child{border-color:#ccc;}.yui-skin-sam .yui-button-disabled button,.yui-skin-sam .yui-button-disabled a,.yui-skin-sam .yui-button-disabled a:visited{color:#A6A6A6;cursor:default;}.yui-skin-sam .yui-menu-button-disabled button{background-image:url(menu-button-arrow-disabled.png);}.yui-skin-sam .yui-split-button-disabled button{background-image:url(split-button-arrow-disabled.png);}

diff --git a/js/yui/assets/skins/sam/calendar.css b/js/yui/assets/skins/sam/calendar.css
new file mode 100644 (file)
index 0000000..df1d705
--- /dev/null
+++ b/js/yui/assets/skins/sam/calendar.css
@@ -0,0 +1,8 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+.yui-calcontainer{position:relative;float:left;_overflow:hidden}.yui-calcontainer iframe{position:absolute;border:0;margin:0;padding:0;z-index:0;width:100%;height:100%;left:0;top:0}.yui-calcontainer iframe.fixedsize{width:50em;height:50em;top:-1px;left:-1px}.yui-calcontainer.multi .groupcal{z-index:1;float:left;position:relative}.yui-calcontainer .title{position:relative;z-index:1}.yui-calcontainer .close-icon{position:absolute;z-index:1;text-indent:-10000em;overflow:hidden}.yui-calendar{position:relative}.yui-calendar .calnavleft{position:absolute;z-index:1;text-indent:-10000em;overflow:hidden}.yui-calendar .calnavright{position:absolute;z-index:1;text-indent:-10000em;overflow:hidden}.yui-calendar .calheader{position:relative;width:100%;text-align:center}.yui-calcontainer .yui-cal-nav-mask{position:absolute;z-index:2;margin:0;padding:0;width:100%;height:100%;_width:0;_height:0;left:0;top:0;display:none}.yui-calcontainer .yui-cal-nav{position:absolute;z-index:3;top:0;display:none}.yui-calcontainer .yui-cal-nav .yui-cal-nav-btn{display:-moz-inline-box;display:inline-block}.yui-calcontainer .yui-cal-nav .yui-cal-nav-btn button{display:block;*display:inline-block;*overflow:visible;border:0;background-color:transparent;cursor:pointer}.yui-calendar .calbody a:hover{background:inherit}p#clear{clear:left;padding-top:10px}.yui-skin-sam .yui-calcontainer{background-color:#f2f2f2;border:1px solid #808080;padding:10px}.yui-skin-sam .yui-calcontainer.multi{padding:0 5px 0 5px}.yui-skin-sam .yui-calcontainer.multi .groupcal{background-color:transparent;border:0;padding:10px 5px 10px 5px;margin:0}.yui-skin-sam .yui-calcontainer .title{background:url(sprite.png) repeat-x 0 0;border-bottom:1px solid #ccc;font:100% sans-serif;color:#000;font-weight:bold;height:auto;padding:.4em;margin:0 -10px 10px -10px;top:0;left:0;text-align:left}.yui-skin-sam .yui-calcontainer.multi .title{margin:0 -5px 0 -5px}.yui-skin-sam .yui-calcontainer.withtitle{padding-top:0}.yui-skin-sam .yui-calcontainer .calclose{background:url(sprite.png) no-repeat 0 -300px;width:25px;height:15px;top:.4em;right:.4em;cursor:pointer}.yui-skin-sam .yui-calendar{border-spacing:0;border-collapse:collapse;font:100% sans-serif;text-align:center;margin:0}.yui-skin-sam .yui-calendar .calhead{background:transparent;border:0;vertical-align:middle;padding:0}.yui-skin-sam .yui-calendar .calheader{background:transparent;font-weight:bold;padding:0 0 .6em 0;text-align:center}.yui-skin-sam .yui-calendar .calheader img{border:0}.yui-skin-sam .yui-calendar .calnavleft{background:url(sprite.png) no-repeat 0 -450px;width:25px;height:15px;top:0;bottom:0;left:-10px;margin-left:.4em;cursor:pointer}.yui-skin-sam .yui-calendar .calnavright{background:url(sprite.png) no-repeat 0 -500px;width:25px;height:15px;top:0;bottom:0;right:-10px;margin-right:.4em;cursor:pointer}.yui-skin-sam .yui-calendar .calweekdayrow{height:2em}.yui-skin-sam .yui-calendar .calweekdayrow th{padding:0;border:0}.yui-skin-sam .yui-calendar .calweekdaycell{color:#000;font-weight:bold;text-align:center;width:2em}.yui-skin-sam .yui-calendar .calfoot{background-color:#f2f2f2}.yui-skin-sam .yui-calendar .calrowhead,.yui-skin-sam .yui-calendar .calrowfoot{color:#a6a6a6;font-size:85%;font-style:normal;font-weight:normal;border:0}.yui-skin-sam .yui-calendar .calrowhead{text-align:right;padding:0 2px 0 0}.yui-skin-sam .yui-calendar .calrowfoot{text-align:left;padding:0 0 0 2px}.yui-skin-sam .yui-calendar td.calcell{border:1px solid #ccc;background:#fff;padding:1px;height:1.6em;line-height:1.6em;text-align:center;white-space:nowrap}.yui-skin-sam .yui-calendar td.calcell a{color:#06c;display:block;height:100%;text-decoration:none}.yui-skin-sam .yui-calendar td.calcell.today{background-color:#000}.yui-skin-sam .yui-calendar td.calcell.today a{background-color:#fff}.yui-skin-sam .yui-calendar td.calcell.oom{background-color:#ccc;color:#a6a6a6;cursor:default}.yui-skin-sam .yui-calendar td.calcell.oom a{color:#a6a6a6}.yui-skin-sam .yui-calendar td.calcell.selected{background-color:#fff;color:#000}.yui-skin-sam .yui-calendar td.calcell.selected a{background-color:#b3d4ff;color:#000}.yui-skin-sam .yui-calendar td.calcell.calcellhover{background-color:#426fd9;color:#fff;cursor:pointer}.yui-skin-sam .yui-calendar td.calcell.calcellhover a{background-color:#426fd9;color:#fff}.yui-skin-sam .yui-calendar td.calcell.previous{color:#e0e0e0}.yui-skin-sam .yui-calendar td.calcell.restricted{text-decoration:line-through}.yui-skin-sam .yui-calendar td.calcell.highlight1{background-color:#cf9}.yui-skin-sam .yui-calendar td.calcell.highlight2{background-color:#9cf}.yui-skin-sam .yui-calendar td.calcell.highlight3{background-color:#fcc}.yui-skin-sam .yui-calendar td.calcell.highlight4{background-color:#cf9}.yui-skin-sam .yui-calendar a.calnav{border:1px solid #f2f2f2;padding:0 4px;text-decoration:none;color:#000;zoom:1}.yui-skin-sam .yui-calendar a.calnav:hover{background:url(sprite.png) repeat-x 0 0;border-color:#a0a0a0;cursor:pointer}.yui-skin-sam .yui-calcontainer .yui-cal-nav-mask{background-color:#000;opacity:.25;filter:alpha(opacity=25)}.yui-skin-sam .yui-calcontainer .yui-cal-nav{font-family:arial,helvetica,clean,sans-serif;font-size:93%;border:1px solid #808080;left:50%;margin-left:-7em;width:14em;padding:0;top:2.5em;background-color:#f2f2f2}.yui-skin-sam .yui-calcontainer.withtitle .yui-cal-nav{top:4.5em}.yui-skin-sam .yui-calcontainer.multi .yui-cal-nav{width:16em;margin-left:-8em}.yui-skin-sam .yui-calcontainer .yui-cal-nav-y,.yui-skin-sam .yui-calcontainer .yui-cal-nav-m,.yui-skin-sam .yui-calcontainer .yui-cal-nav-b{padding:5px 10px 5px 10px}.yui-skin-sam .yui-calcontainer .yui-cal-nav-b{text-align:center}.yui-skin-sam .yui-calcontainer .yui-cal-nav-e{margin-top:5px;padding:5px;background-color:#edf5ff;border-top:1px solid black;display:none}.yui-skin-sam .yui-calcontainer .yui-cal-nav label{display:block;font-weight:bold}
+.yui-skin-sam .yui-calcontainer .yui-cal-nav-mc{width:100%;_width:auto}.yui-skin-sam .yui-calcontainer .yui-cal-nav-y input.yui-invalid{background-color:#ffee69;border:1px solid #000}.yui-skin-sam .yui-calcontainer .yui-cal-nav-yc{width:4em}.yui-skin-sam .yui-calcontainer .yui-cal-nav .yui-cal-nav-btn{border:1px solid #808080;background:url(sprite.png) repeat-x 0 0;background-color:#ccc;margin:auto .15em}.yui-skin-sam .yui-calcontainer .yui-cal-nav .yui-cal-nav-btn button{padding:0 8px;font-size:93%;line-height:2;*line-height:1.7;min-height:2em;*min-height:auto;color:#000}.yui-skin-sam .yui-calcontainer .yui-cal-nav .yui-cal-nav-btn.yui-default{border:1px solid #304369;background-color:#426fd9;background:url(sprite.png) repeat-x 0 -1400px}.yui-skin-sam .yui-calcontainer .yui-cal-nav .yui-cal-nav-btn.yui-default button{color:#fff}

diff --git a/js/yui/assets/skins/sam/carousel.css b/js/yui/assets/skins/sam/carousel.css
new file mode 100644 (file)
index 0000000..b3d86a6
--- /dev/null
+++ b/js/yui/assets/skins/sam/carousel.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+.yui-carousel{visibility:hidden;overflow:hidden;position:relative;text-align:left;zoom:1;}.yui-carousel.yui-carousel-visible{visibility:visible;}.yui-carousel-content{overflow:hidden;position:relative;text-align:center;}.yui-carousel-element li{border:1px solid #ccc;list-style:none;margin:1px;overflow:hidden;padding:0;position:absolute;text-align:center;}.yui-carousel-vertical .yui-carousel-element li{display:block;float:none;}.yui-log .carousel{background:#f2e886;}.yui-carousel-nav{zoom:1;}.yui-carousel-nav:after{content:".";display:block;height:0;clear:both;visibility:hidden;}.yui-carousel-button-focus{outline:1px dotted #000;}.yui-carousel-min-width{min-width:115px;}.yui-carousel-element{overflow:hidden;position:relative;margin:0 auto;padding:0;text-align:left;*margin:0;}.yui-carousel-horizontal .yui-carousel-element{width:320000px;}.yui-carousel-vertical .yui-carousel-element{height:320000px;}.yui-skin-sam .yui-carousel-nav select{position:static;}.yui-carousel .yui-carousel-item-selected{border:1px dashed #000;margin:1px;}.yui-skin-sam .yui-carousel,.yui-skin-sam .yui-carousel-vertical{border:1px solid #808080;}.yui-skin-sam .yui-carousel-nav{background:url(sprite.png) repeat-x 0 0;padding:3px;text-align:right;}.yui-skin-sam .yui-carousel-button{background:url(sprite.png) no-repeat 0 -600px;float:right;height:19px;margin:5px;overflow:hidden;width:40px;}.yui-skin-sam .yui-carousel-vertical .yui-carousel-button{background-position:0 -800px;}.yui-skin-sam .yui-carousel-button-disabled{background-position:0 -2000px;}.yui-skin-sam .yui-carousel-vertical .yui-carousel-button-disabled{background-position:0 -2100px;}.yui-skin-sam .yui-carousel-button input,.yui-skin-sam .yui-carousel-button button{background-color:transparent;border:0;cursor:pointer;display:block;height:44px;margin:-2px 0 0 -2px;padding:0 0 0 50px;}.yui-skin-sam span.yui-carousel-first-button{background-position:0 -550px;margin-left:-100px;margin-right:50px;*margin:5px 5px 5px -90px;}.yui-skin-sam .yui-carousel-vertical span.yui-carousel-first-button{background-position:0 -750px;}.yui-skin-sam span.yui-carousel-first-button-disabled{background-position:0 -1950px;}.yui-skin-sam .yui-carousel-vertical span.yui-carousel-first-button-disabled{background-position:0 -2050px;}.yui-skin-sam .yui-carousel-nav ul{float:right;height:19px;margin:0;margin-left:-220px;margin-right:100px;*margin-left:-160px;*margin-right:0;padding:0;}.yui-skin-sam .yui-carousel-min-width .yui-carousel-nav ul{*margin-left:-170px;}.yui-skin-sam .yui-carousel-nav select{position:relative;*right:50px;top:4px;}.yui-skin-sam .yui-carousel-vertical .yui-carousel-nav select{position:static;}.yui-skin-sam .yui-carousel-vertical .yui-carousel-nav ul,.yui-skin-sam .yui-carousel-vertical .yui-carousel-nav select{float:none;margin:0;*zoom:1;}.yui-skin-sam .yui-carousel-nav ul li{background:url(sprite.png) no-repeat 0 -650px;cursor:pointer;float:left;height:9px;list-style:none;margin:10px 0 0 5px;overflow:hidden;padding:0;width:9px;}.yui-skin-sam .yui-carousel-nav ul:after{content:".";display:block;height:0;clear:both;visibility:hidden;}.yui-skin-sam .yui-carousel-nav ul li a{display:block;width:100%;height:100%;text-indent:-10000px;text-align:left;overflow:hidden;}.yui-skin-sam .yui-carousel-nav ul li.yui-carousel-nav-page-focus{outline:1px dotted #000;}.yui-skin-sam .yui-carousel-nav ul li.yui-carousel-nav-page-selected{background-position:0 -700px;}.yui-skin-sam .yui-carousel-item-loading{background:url(ajax-loader.gif) no-repeat 50% 50%;position:absolute;text-indent:-150px;}

diff --git a/js/yui/assets/skins/sam/check0.gif b/js/yui/assets/skins/sam/check0.gif
new file mode 100644 (file)
index 0000000..193028b
Binary files /dev/null and b/js/yui/assets/skins/sam/check0.gif differ

diff --git a/js/yui/assets/skins/sam/check1.gif b/js/yui/assets/skins/sam/check1.gif
new file mode 100644 (file)
index 0000000..7d9ceba
Binary files /dev/null and b/js/yui/assets/skins/sam/check1.gif differ

diff --git a/js/yui/assets/skins/sam/check2.gif b/js/yui/assets/skins/sam/check2.gif
new file mode 100644 (file)
index 0000000..1813175
Binary files /dev/null and b/js/yui/assets/skins/sam/check2.gif differ

diff --git a/js/yui/assets/skins/sam/colorpicker.css b/js/yui/assets/skins/sam/colorpicker.css
new file mode 100644 (file)
index 0000000..77ac7c1
--- /dev/null
+++ b/js/yui/assets/skins/sam/colorpicker.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+.yui-picker-panel{background:#e3e3e3;border-color:#888}.yui-picker-panel .hd{background-color:#ccc;font-size:100%;line-height:100%;border:1px solid #e3e3e3;font-weight:bold;overflow:hidden;padding:6px;color:#000}.yui-picker-panel .bd{background:#e8e8e8;margin:1px;height:200px}.yui-picker-panel .ft{background:#e8e8e8;margin:1px;padding:1px}.yui-picker{position:relative}.yui-picker-hue-thumb{cursor:default;width:18px;height:18px;top:-8px;left:-2px;z-index:9;position:absolute}.yui-picker-hue-bg{-moz-outline:0;outline:0 none;position:absolute;left:200px;height:183px;width:14px;background:url(hue_bg.png) no-repeat;top:4px}.yui-picker-bg{-moz-outline:0;outline:0 none;position:absolute;top:4px;left:4px;height:182px;width:182px;background-color:#F00;background-image:url(picker_mask.png)}*html .yui-picker-bg{background-image:none;filter:progid:DXImageTransform.Microsoft.AlphaImageLoader(src='picker_mask.png',sizingMethod='scale')}.yui-picker-mask{position:absolute;z-index:1;top:0;left:0}.yui-picker-thumb{cursor:default;width:11px;height:11px;z-index:9;position:absolute;top:-4px;left:-4px}.yui-picker-swatch{position:absolute;left:240px;top:4px;height:60px;width:55px;border:1px solid #888}.yui-picker-websafe-swatch{position:absolute;left:304px;top:4px;height:24px;width:24px;border:1px solid #888}.yui-picker-controls{position:absolute;top:72px;left:226px;font:1em monospace}.yui-picker-controls .hd{background:transparent;border-width:0!important}.yui-picker-controls .bd{height:100px;border-width:0!important}.yui-picker-controls ul{float:left;padding:0 2px 0 0;margin:0}.yui-picker-controls li{padding:2px;list-style:none;margin:0}.yui-picker-controls input{font-size:.85em;width:2.4em}.yui-picker-hex-controls{clear:both;padding:2px}.yui-picker-hex-controls input{width:4.6em}.yui-picker-controls a{font:1em arial,helvetica,clean,sans-serif;display:block;*display:inline-block;padding:0;color:#000}

diff --git a/js/yui/assets/skins/sam/container.css b/js/yui/assets/skins/sam/container.css
new file mode 100644 (file)
index 0000000..e4db6e3
--- /dev/null
+++ b/js/yui/assets/skins/sam/container.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+.yui-overlay,.yui-panel-container{visibility:hidden;position:absolute;z-index:2}.yui-panel{position:relative}.yui-panel-container form{margin:0}.mask{z-index:1;display:none;position:absolute;top:0;left:0;right:0;bottom:0}.mask.block-scrollbars{overflow:auto}.masked select,.drag select,.hide-select select{_visibility:hidden}.yui-panel-container select{_visibility:inherit}.hide-scrollbars,.hide-scrollbars *{overflow:hidden}.hide-scrollbars select{display:none}.show-scrollbars{overflow:auto}.yui-panel-container.show-scrollbars,.yui-tt.show-scrollbars{overflow:visible}.yui-panel-container.show-scrollbars .underlay,.yui-tt.show-scrollbars .yui-tt-shadow{overflow:auto}.yui-panel-container.shadow .underlay.yui-force-redraw{padding-bottom:1px}.yui-effect-fade .underlay,.yui-effect-fade .yui-tt-shadow{display:none}.yui-tt-shadow{position:absolute}.yui-override-padding{padding:0!important}.yui-panel-container .container-close{overflow:hidden;text-indent:-10000em;text-decoration:none}.yui-overlay.yui-force-redraw,.yui-panel-container.yui-force-redraw{margin-bottom:1px}.yui-skin-sam .mask{background-color:#000;opacity:.25;filter:alpha(opacity=25)}.yui-skin-sam .yui-panel-container{padding:0 1px;*padding:2px}.yui-skin-sam .yui-panel{position:relative;left:0;top:0;border-style:solid;border-width:1px 0;border-color:#808080;z-index:1;*border-width:1px;*zoom:1;_zoom:normal}.yui-skin-sam .yui-panel .hd,.yui-skin-sam .yui-panel .bd,.yui-skin-sam .yui-panel .ft{border-style:solid;border-width:0 1px;border-color:#808080;margin:0 -1px;*margin:0;*border:0}.yui-skin-sam .yui-panel .hd{border-bottom:solid 1px #ccc}.yui-skin-sam .yui-panel .bd,.yui-skin-sam .yui-panel .ft{background-color:#f2f2f2}.yui-skin-sam .yui-panel .hd{padding:0 10px;font-size:93%;line-height:2;*line-height:1.9;font-weight:bold;color:#000;background:url(sprite.png) repeat-x 0 -200px}.yui-skin-sam .yui-panel .bd{padding:10px}.yui-skin-sam .yui-panel .ft{border-top:solid 1px #808080;padding:5px 10px;font-size:77%}.yui-skin-sam .container-close{position:absolute;top:5px;right:6px;width:25px;height:15px;background:url(sprite.png) no-repeat 0 -300px;cursor:pointer}.yui-skin-sam .yui-panel-container .underlay{right:-1px;left:-1px}.yui-skin-sam .yui-panel-container.matte{padding:9px 10px;background-color:#fff}.yui-skin-sam .yui-panel-container.shadow{_padding:2px 4px 0 2px}.yui-skin-sam .yui-panel-container.shadow .underlay{position:absolute;top:2px;left:-3px;right:-3px;bottom:-3px;*top:4px;*left:-1px;*right:-1px;*bottom:-1px;_top:0;_left:0;_right:0;_bottom:0;_margin-top:3px;_margin-left:-1px;background-color:#000;opacity:.12;filter:alpha(opacity=12)}.yui-skin-sam .yui-dialog .ft{border-top:0;padding:0 10px 10px 10px;font-size:100%}.yui-skin-sam .yui-dialog .ft .button-group{display:block;text-align:right}.yui-skin-sam .yui-dialog .ft button.default{font-weight:bold}.yui-skin-sam .yui-dialog .ft span.default{border-color:#304369;background-position:0 -1400px}.yui-skin-sam .yui-dialog .ft span.default .first-child{border-color:#304369}.yui-skin-sam .yui-dialog .ft span.default button{color:#fff}.yui-skin-sam .yui-dialog .ft span.yui-button-disabled{background-position:0 -1500px;border-color:#ccc}.yui-skin-sam .yui-dialog .ft span.yui-button-disabled .first-child{border-color:#ccc}.yui-skin-sam .yui-dialog .ft span.yui-button-disabled button{color:#a6a6a6}.yui-skin-sam .yui-simple-dialog .bd .yui-icon{background:url(sprite.png) no-repeat 0 0;width:16px;height:16px;margin-right:10px;float:left}.yui-skin-sam .yui-simple-dialog .bd span.blckicon{background-position:0 -1100px}.yui-skin-sam .yui-simple-dialog .bd span.alrticon{background-position:0 -1050px}.yui-skin-sam .yui-simple-dialog .bd span.hlpicon{background-position:0 -1150px}.yui-skin-sam .yui-simple-dialog .bd span.infoicon{background-position:0 -1200px}.yui-skin-sam .yui-simple-dialog .bd span.warnicon{background-position:0 -1900px}.yui-skin-sam .yui-simple-dialog .bd span.tipicon{background-position:0 -1250px}.yui-skin-sam .yui-tt .bd{position:relative;top:0;left:0;z-index:1;color:#000;padding:2px 5px;border-color:#d4c237 #A6982b #a6982b #A6982B;border-width:1px;border-style:solid;background-color:#ffee69}.yui-skin-sam .yui-tt.show-scrollbars .bd{overflow:auto}.yui-skin-sam .yui-tt-shadow{top:2px;right:-3px;left:-3px;bottom:-3px;background-color:#000}.yui-skin-sam .yui-tt-shadow-visible{opacity:.12;filter:alpha(opacity=12)}

diff --git a/js/yui/assets/skins/sam/datatable.css b/js/yui/assets/skins/sam/datatable.css
new file mode 100644 (file)
index 0000000..91d07c3
--- /dev/null
+++ b/js/yui/assets/skins/sam/datatable.css
@@ -0,0 +1,8 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+.yui-skin-sam .yui-dt-mask{position:absolute;z-index:9500}.yui-dt-tmp{position:absolute;left:-9000px}.yui-dt-scrollable .yui-dt-bd{overflow:auto}.yui-dt-scrollable .yui-dt-hd{overflow:hidden;position:relative}.yui-dt-scrollable .yui-dt-bd thead tr,.yui-dt-scrollable .yui-dt-bd thead th{position:absolute;left:-1500px}.yui-dt-scrollable tbody{-moz-outline:0}.yui-skin-sam thead .yui-dt-sortable{cursor:pointer}.yui-skin-sam thead .yui-dt-draggable{cursor:move}.yui-dt-coltarget{position:absolute;z-index:999}.yui-dt-hd{zoom:1}th.yui-dt-resizeable .yui-dt-resizerliner{position:relative}.yui-dt-resizer{position:absolute;right:0;bottom:0;height:100%;cursor:e-resize;cursor:col-resize;background-color:#CCC;opacity:0;filter:alpha(opacity=0)}.yui-dt-resizerproxy{visibility:hidden;position:absolute;z-index:9000;background-color:#CCC;opacity:0;filter:alpha(opacity=0)}th.yui-dt-hidden .yui-dt-liner,td.yui-dt-hidden .yui-dt-liner,th.yui-dt-hidden .yui-dt-resizer{display:none}.yui-dt-editor,.yui-dt-editor-shim{position:absolute;z-index:9000}.yui-skin-sam .yui-dt table{margin:0;padding:0;font-family:arial;font-size:inherit;border-collapse:separate;*border-collapse:collapse;border-spacing:0;border:1px solid #7f7f7f}.yui-skin-sam .yui-dt thead{border-spacing:0}.yui-skin-sam .yui-dt caption{color:#000;font-size:85%;font-weight:normal;font-style:italic;line-height:1;padding:1em 0;text-align:center}.yui-skin-sam .yui-dt th{background:#d8d8da url(sprite.png) repeat-x 0 0}.yui-skin-sam .yui-dt th,.yui-skin-sam .yui-dt th a{font-weight:normal;text-decoration:none;color:#000;vertical-align:bottom}.yui-skin-sam .yui-dt th{margin:0;padding:0;border:0;border-right:1px solid #cbcbcb}.yui-skin-sam .yui-dt tr.yui-dt-first td{border-top:1px solid #7f7f7f}.yui-skin-sam .yui-dt th .yui-dt-liner{white-space:nowrap}.yui-skin-sam .yui-dt-liner{margin:0;padding:0;padding:4px 10px 4px 10px}.yui-skin-sam .yui-dt-coltarget{width:5px;background-color:red}.yui-skin-sam .yui-dt td{margin:0;padding:0;border:0;border-right:1px solid #cbcbcb;text-align:left}.yui-skin-sam .yui-dt-list td{border-right:0}.yui-skin-sam .yui-dt-resizer{width:6px}.yui-skin-sam .yui-dt-mask{background-color:#000;opacity:.25;filter:alpha(opacity=25)}.yui-skin-sam .yui-dt-message{background-color:#FFF}.yui-skin-sam .yui-dt-scrollable table{border:0}.yui-skin-sam .yui-dt-scrollable .yui-dt-hd{border-left:1px solid #7f7f7f;border-top:1px solid #7f7f7f;border-right:1px solid #7f7f7f}.yui-skin-sam .yui-dt-scrollable .yui-dt-bd{border-left:1px solid #7f7f7f;border-bottom:1px solid #7f7f7f;border-right:1px solid #7f7f7f;background-color:#FFF}.yui-skin-sam .yui-dt-scrollable .yui-dt-data tr.yui-dt-last td{border-bottom:1px solid #7f7f7f}.yui-skin-sam th.yui-dt-asc,.yui-skin-sam th.yui-dt-desc{background:url(sprite.png) repeat-x 0 -100px}.yui-skin-sam th.yui-dt-sortable .yui-dt-label{margin-right:10px}.yui-skin-sam th.yui-dt-asc .yui-dt-liner{background:url(dt-arrow-up.png) no-repeat right}.yui-skin-sam th.yui-dt-desc .yui-dt-liner{background:url(dt-arrow-dn.png) no-repeat right}tbody .yui-dt-editable{cursor:pointer}.yui-dt-editor{text-align:left;background-color:#f2f2f2;border:1px solid #808080;padding:6px}.yui-dt-editor label{padding-left:4px;padding-right:6px}.yui-dt-editor .yui-dt-button{padding-top:6px;text-align:right}.yui-dt-editor .yui-dt-button button{background:url(sprite.png) repeat-x 0 0;border:1px solid #999;width:4em;height:1.8em;margin-left:6px}.yui-dt-editor .yui-dt-button button.yui-dt-default{background:url(sprite.png) repeat-x 0 -1400px;background-color:#5584e0;border:1px solid #304369;color:#FFF}.yui-dt-editor .yui-dt-button button:hover{background:url(sprite.png) repeat-x 0 -1300px;color:#000}.yui-dt-editor .yui-dt-button button:active{background:url(sprite.png) repeat-x 0 -1700px;color:#000}.yui-skin-sam tr.yui-dt-even{background-color:#FFF}.yui-skin-sam tr.yui-dt-odd{background-color:#edf5ff}.yui-skin-sam tr.yui-dt-even td.yui-dt-asc,.yui-skin-sam tr.yui-dt-even td.yui-dt-desc{background-color:#edf5ff}.yui-skin-sam tr.yui-dt-odd td.yui-dt-asc,.yui-skin-sam tr.yui-dt-odd td.yui-dt-desc{background-color:#dbeaff}.yui-skin-sam .yui-dt-list tr.yui-dt-even{background-color:#FFF}.yui-skin-sam .yui-dt-list tr.yui-dt-odd{background-color:#FFF}.yui-skin-sam .yui-dt-list tr.yui-dt-even td.yui-dt-asc,.yui-skin-sam .yui-dt-list tr.yui-dt-even td.yui-dt-desc{background-color:#edf5ff}.yui-skin-sam .yui-dt-list tr.yui-dt-odd td.yui-dt-asc,.yui-skin-sam .yui-dt-list tr.yui-dt-odd td.yui-dt-desc{background-color:#edf5ff}.yui-skin-sam th.yui-dt-highlighted,.yui-skin-sam th.yui-dt-highlighted a{background-color:#b2d2ff}.yui-skin-sam tr.yui-dt-highlighted,.yui-skin-sam tr.yui-dt-highlighted td.yui-dt-asc,.yui-skin-sam tr.yui-dt-highlighted td.yui-dt-desc,.yui-skin-sam tr.yui-dt-even td.yui-dt-highlighted,.yui-skin-sam tr.yui-dt-odd td.yui-dt-highlighted{cursor:pointer;background-color:#b2d2ff}.yui-skin-sam .yui-dt-list th.yui-dt-highlighted,.yui-skin-sam .yui-dt-list th.yui-dt-highlighted a{background-color:#b2d2ff}.yui-skin-sam .yui-dt-list tr.yui-dt-highlighted,.yui-skin-sam .yui-dt-list tr.yui-dt-highlighted td.yui-dt-asc,.yui-skin-sam .yui-dt-list tr.yui-dt-highlighted td.yui-dt-desc,.yui-skin-sam .yui-dt-list tr.yui-dt-even td.yui-dt-highlighted,.yui-skin-sam .yui-dt-list tr.yui-dt-odd td.yui-dt-highlighted{cursor:pointer;background-color:#b2d2ff}.yui-skin-sam th.yui-dt-selected,.yui-skin-sam th.yui-dt-selected a{background-color:#446cd7}.yui-skin-sam tr.yui-dt-selected td,.yui-skin-sam tr.yui-dt-selected td.yui-dt-asc,.yui-skin-sam tr.yui-dt-selected td.yui-dt-desc{background-color:#426fd9;color:#FFF}.yui-skin-sam tr.yui-dt-even td.yui-dt-selected,.yui-skin-sam tr.yui-dt-odd td.yui-dt-selected{background-color:#446cd7;color:#FFF}.yui-skin-sam .yui-dt-list th.yui-dt-selected,.yui-skin-sam .yui-dt-list th.yui-dt-selected a{background-color:#446cd7}
+.yui-skin-sam .yui-dt-list tr.yui-dt-selected td,.yui-skin-sam .yui-dt-list tr.yui-dt-selected td.yui-dt-asc,.yui-skin-sam .yui-dt-list tr.yui-dt-selected td.yui-dt-desc{background-color:#426fd9;color:#FFF}.yui-skin-sam .yui-dt-list tr.yui-dt-even td.yui-dt-selected,.yui-skin-sam .yui-dt-list tr.yui-dt-odd td.yui-dt-selected{background-color:#446cd7;color:#FFF}.yui-skin-sam .yui-dt-paginator{display:block;margin:6px 0;white-space:nowrap}.yui-skin-sam .yui-dt-paginator .yui-dt-first,.yui-skin-sam .yui-dt-paginator .yui-dt-last,.yui-skin-sam .yui-dt-paginator .yui-dt-selected{padding:2px 6px}.yui-skin-sam .yui-dt-paginator a.yui-dt-first,.yui-skin-sam .yui-dt-paginator a.yui-dt-last{text-decoration:none}.yui-skin-sam .yui-dt-paginator .yui-dt-previous,.yui-skin-sam .yui-dt-paginator .yui-dt-next{display:none}.yui-skin-sam a.yui-dt-page{border:1px solid #cbcbcb;padding:2px 6px;text-decoration:none;background-color:#fff}.yui-skin-sam .yui-dt-selected{border:1px solid #fff;background-color:#fff}

diff --git a/js/yui/assets/skins/sam/desc.gif b/js/yui/assets/skins/sam/desc.gif
new file mode 100644 (file)
index 0000000..c114f29
Binary files /dev/null and b/js/yui/assets/skins/sam/desc.gif differ

diff --git a/js/yui/assets/skins/sam/dt-arrow-dn.png b/js/yui/assets/skins/sam/dt-arrow-dn.png
new file mode 100644 (file)
index 0000000..85fda0b
Binary files /dev/null and b/js/yui/assets/skins/sam/dt-arrow-dn.png differ

diff --git a/js/yui/assets/skins/sam/dt-arrow-up.png b/js/yui/assets/skins/sam/dt-arrow-up.png
new file mode 100644 (file)
index 0000000..1c67431
Binary files /dev/null and b/js/yui/assets/skins/sam/dt-arrow-up.png differ

diff --git a/js/yui/assets/skins/sam/editor-knob.gif b/js/yui/assets/skins/sam/editor-knob.gif
new file mode 100644 (file)
index 0000000..03feab3
Binary files /dev/null and b/js/yui/assets/skins/sam/editor-knob.gif differ

diff --git a/js/yui/assets/skins/sam/editor-sprite-active.gif b/js/yui/assets/skins/sam/editor-sprite-active.gif
new file mode 100644 (file)
index 0000000..3e9d420
Binary files /dev/null and b/js/yui/assets/skins/sam/editor-sprite-active.gif differ

diff --git a/js/yui/assets/skins/sam/editor-sprite.gif b/js/yui/assets/skins/sam/editor-sprite.gif
new file mode 100644 (file)
index 0000000..02042fa
Binary files /dev/null and b/js/yui/assets/skins/sam/editor-sprite.gif differ

diff --git a/js/yui/assets/skins/sam/editor.css b/js/yui/assets/skins/sam/editor.css
new file mode 100644 (file)
index 0000000..d3cde1c
--- /dev/null
+++ b/js/yui/assets/skins/sam/editor.css
@@ -0,0 +1,10 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+.yui-busy{cursor:wait!important;}.yui-toolbar-container fieldset,.yui-editor-container fieldset{padding:0;margin:0;border:0;}.yui-toolbar-container legend{display:none;}.yui-skin-sam .yui-toolbar-container .yui-button button,.yui-skin-sam .yui-toolbar-container .yui-button a,.yui-skin-sam .yui-toolbar-container .yui-button a:visited{font-size:0;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-select button,.yui-skin-sam .yui-toolbar-container .yui-toolbar-select a,.yui-skin-sam .yui-toolbar-container .yui-toolbar-select a:visited,.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton button,.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton a,.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton a:visited{font-size:12px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton a.up,.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton a.down{font-size:0;line-height:0;padding:0;}.yui-toolbar-container .yui-toolbar-subcont{padding:.25em 0;zoom:1;}.yui-toolbar-container-collapsed .yui-toolbar-subcont{display:none;}.yui-toolbar-container .yui-toolbar-subcont:after{display:block;clear:both;visibility:hidden;content:'.';height:0;}.yui-toolbar-container span.yui-toolbar-draghandle{cursor:move;border-left:1px solid #999;border-right:1px solid #999;overflow:hidden;text-indent:77777px;width:2px;height:20px;display:block;clear:none;float:left;margin:0 0 0 .2em;}.yui-toolbar-container .yui-toolbar-titlebar.draggable{cursor:move;}.yui-toolbar-container .yui-toolbar-titlebar{position:relative;}.yui-toolbar-container .yui-toolbar-titlebar h2{font-weight:bold;letter-spacing:0;border:none;color:#000;margin:0;padding:.2em;}.yui-toolbar-container .yui-toolbar-titlebar h2 a{text-decoration:none;color:#000;cursor:default;}.yui-toolbar-container.yui-toolbar-grouped span.yui-toolbar-draghandle{height:40px;}.yui-toolbar-container .yui-toolbar-group{float:left;margin-right:.5em;zoom:1;}.yui-toolbar-container .yui-toolbar-group:after{display:block;clear:both;visibility:hidden;content:'.';height:0;}.yui-toolbar-container .yui-toolbar-group h3{font-size:75%;padding:0 0 0 .25em;margin:0;}.yui-toolbar-container span.yui-toolbar-separator{width:2px;padding:0;height:18px;margin:.2em 0 .2em .1em;display:none;float:left;}.yui-toolbar-container.yui-toolbar-grouped span.yui-toolbar-separator{height:45px;*height:50px;}.yui-toolbar-container.yui-toolbar-grouped .yui-toolbar-group span.yui-toolbar-separator{height:18px;display:block;}.yui-toolbar-container ul li{margin:0;padding:0;list-style-type:none;}.yui-toolbar-container .yui-toolbar-nogrouplabels h3{display:none;}.yui-toolbar-container .yui-push-button,.yui-toolbar-container .yui-color-button,.yui-toolbar-container .yui-menu-button{position:relative;cursor:pointer;}.yui-toolbar-container .yui-button .first-child,.yui-toolbar-container .yui-button .first-child a{height:100%;width:100%;overflow:hidden;font-size:0;}.yui-toolbar-container .yui-button-disabled{cursor:default;}.yui-toolbar-container .yui-button-disabled .yui-toolbar-icon{opacity:.5;filter:alpha(opacity=50);}.yui-toolbar-container .yui-button-disabled .up,.yui-toolbar-container .yui-button-disabled .down{opacity:.5;filter:alpha(opacity=50);}.yui-toolbar-container .yui-button a{overflow:hidden;}.yui-toolbar-container .yui-toolbar-select .first-child a{cursor:pointer;}.yui-toolbar-fontname-arial{font-family:Arial;}.yui-toolbar-fontname-arial-black{font-family:Arial Black;}.yui-toolbar-fontname-comic-sans-ms{font-family:Comic Sans MS;}.yui-toolbar-fontname-courier-new{font-family:Courier New;}.yui-toolbar-fontname-times-new-roman{font-family:Times New Roman;}.yui-toolbar-fontname-verdana{font-family:Verdana;}.yui-toolbar-fontname-impact{font-family:Impact;}.yui-toolbar-fontname-lucida-console{font-family:Lucida Console;}.yui-toolbar-fontname-tahoma{font-family:Tahoma;}.yui-toolbar-fontname-trebuchet-ms{font-family:Trebuchet MS;}.yui-toolbar-container .yui-toolbar-spinbutton{position:relative;}.yui-toolbar-container .yui-toolbar-spinbutton .first-child a{z-index:0;opacity:1;}.yui-toolbar-container .yui-toolbar-spinbutton a.up,.yui-toolbar-container .yui-toolbar-spinbutton a.down{position:absolute;display:block;right:0;cursor:pointer;z-index:1;padding:0;margin:0;}.yui-toolbar-container .yui-overlay{position:absolute;}.yui-toolbar-container .yui-overlay ul li{margin:0;list-style-type:none;}.yui-toolbar-container{z-index:1;}.yui-editor-container .yui-editor-editable-container{position:relative;z-index:0;width:100%;}.yui-editor-container .yui-editor-masked{background-color:#CCC;height:100%;width:100%;position:absolute;top:0;left:0;opacity:.5;filter:alpha(opacity=50);}.yui-editor-container iframe{border:0;padding:0;margin:0;zoom:1;display:block;}.yui-editor-container .yui-editor-editable{padding:0;margin:0;}.yui-editor-container .dompath{font-size:85%;}.yui-editor-panel .hd{text-align:left;position:relative;}.yui-editor-panel .hd h3{font-weight:bold;padding:.25em 0 .25em .25em;margin:0;}.yui-editor-panel .bd{width:100%;zoom:1;position:relative;}.yui-editor-panel .bd div.yui-editor-body-cont{padding:.25em .1em;zoom:1;}.yui-editor-panel .bd .gecko form{overflow:auto;}.yui-editor-panel .bd div.yui-editor-body-cont:after{display:block;clear:both;visibility:hidden;content:'.';height:0;}.yui-editor-panel .ft{text-align:right;width:99%;float:left;clear:both;}.yui-editor-panel .ft span.tip{display:block;position:relative;padding:.5em .5em .5em 23px;text-align:left;zoom:1;}.yui-editor-panel label{clear:both;float:left;padding:0;width:100%;text-align:left;zoom:1;}.yui-editor-panel .gecko label{overflow:auto;}.yui-editor-panel label strong{float:left;width:6em;}.yui-editor-panel .removeLink{width:80%;text-align:right;}.yui-editor-panel label input{margin-left:.25em;float:left;}.yui-editor-panel .yui-toolbar-group{margin-bottom:.75em;}.yui-editor-panel .height-width{float:left;}.yui-editor-panel .height-width span{font-style:italic;display:block;float:left;overflow:visible;}.yui-editor-panel .height-width span.info{font-size:70%;margin-top:3px;float:none;}
+.yui-editor-panel .yui-toolbar-bordersize,.yui-editor-panel .yui-toolbar-bordertype{font-size:75%;}.yui-editor-panel .yui-toolbar-container span.yui-toolbar-separator{border:none;}.yui-editor-panel .yui-toolbar-bordersize span a span,.yui-editor-panel .yui-toolbar-bordertype span a span{display:block;height:8px;left:4px;position:absolute;top:3px;_top:-5px;width:24px;text-indent:52px;font-size:0;}.yui-editor-panel .yui-toolbar-bordertype span a span.yui-toolbar-bordertype-solid{border-bottom:1px solid black;}.yui-editor-panel .yui-toolbar-bordertype span a span.yui-toolbar-bordertype-dotted{border-bottom:1px dotted black;}.yui-editor-panel .yui-toolbar-bordertype span a span.yui-toolbar-bordertype-dashed{border-bottom:1px dashed black;}.yui-editor-panel .yui-toolbar-bordersize span a span.yui-toolbar-bordersize-0{*top:0;text-indent:0;font-size:75%;}.yui-editor-panel .yui-toolbar-bordersize span a span.yui-toolbar-bordersize-1{border-bottom:1px solid black;}.yui-editor-panel .yui-toolbar-bordersize span a span.yui-toolbar-bordersize-2{border-bottom:2px solid black;}.yui-editor-panel .yui-toolbar-bordersize span a span.yui-toolbar-bordersize-3{top:2px;*top:-5px;border-bottom:3px solid black;}.yui-editor-panel .yui-toolbar-bordersize span a span.yui-toolbar-bordersize-4{top:1px;*top:-5px;border-bottom:4px solid black;}.yui-editor-panel .yui-toolbar-bordersize span a span.yui-toolbar-bordersize-5{top:1px;*top:-5px;border-bottom:5px solid black;}.yui-toolbar-container .yui-toolbar-bordersize-menu,.yui-toolbar-container .yui-toolbar-bordertype-menu{width:95px!important;}.yui-toolbar-bordersize-menu .yuimenuitemlabel,.yui-toolbar-bordertype-menu .yuimenuitemlabel,.yui-toolbar-bordersize-menu .yuimenuitemlabel,.yui-toolbar-bordertype-menu .yuimenuitemlabel:hover{margin:0 3px 7px 17px;}.yui-toolbar-bordersize-menu .yuimenuitemlabel .checkedindicator,.yui-toolbar-bordertype-menu .yuimenuitemlabel .checkedindicator{position:absolute;left:-12px;*top:14px;*left:0;}.yui-toolbar-bordersize-menu li.yui-toolbar-bordersize-1 a{border-bottom:1px solid black;height:14px;}.yui-toolbar-bordersize-menu li.yui-toolbar-bordersize-2 a{border-bottom:2px solid black;height:14px;}.yui-toolbar-bordersize-menu li.yui-toolbar-bordersize-3 a{border-bottom:3px solid black;height:14px;}.yui-toolbar-bordersize-menu li.yui-toolbar-bordersize-4 a{border-bottom:4px solid black;height:14px;}.yui-toolbar-bordersize-menu li.yui-toolbar-bordersize-5 a{border-bottom:5px solid black;height:14px;}.yui-toolbar-bordertype-menu li.yui-toolbar-bordertype-solid a{border-bottom:1px solid black;height:14px;}.yui-toolbar-bordertype-menu li.yui-toolbar-bordertype-dashed a{border-bottom:1px dashed black;height:14px;}.yui-toolbar-bordertype-menu li.yui-toolbar-bordertype-dotted a{border-bottom:1px dotted black;height:14px;}h2.yui-editor-skipheader,h3.yui-editor-skipheader{height:0;margin:0;padding:0;border:none;width:0;overflow:hidden;position:absolute;}.yui-toolbar-colors{width:133px;zoom:1;display:none;z-index:100;overflow:hidden;}.yui-toolbar-colors:after{display:block;clear:both;visibility:hidden;content:'.';height:0;}.yui-toolbar-colors a{height:9px;width:9px;float:left;display:block;overflow:hidden;text-indent:999px;margin:0;cursor:pointer;border:1px solid #F6F7EE;}.yui-toolbar-colors a:hover{border:1px solid black;}.yui-color-button-menu{overflow:visible;background-color:transparent;}.yui-toolbar-colors span{position:relative;display:block;padding:3px;overflow:hidden;float:left;width:100%;zoom:1;}.yui-toolbar-colors span:after{display:block;clear:both;visibility:hidden;content:'.';height:0;}.yui-toolbar-colors span em{height:35px;width:30px;float:left;display:block;overflow:hidden;text-indent:999px;margin:.75px;border:1px solid black;}.yui-toolbar-colors span strong{font-weight:normal;padding-left:3px;display:block;font-size:85%;float:left;width:65%;}.yui-toolbar-group-undoredo h3,.yui-toolbar-group-insertitem h3,.yui-toolbar-group-indentlist h3{width:68px;}.yui-toolbar-group-indentlist2 h3{width:122px;}.yui-toolbar-group-alignment h3{width:130px;}.yui-skin-sam .yui-editor-container{border:1px solid #808080;}.yui-skin-sam .yui-toolbar-container{zoom:1;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-titlebar{background:url(sprite.png) repeat-x 0 -200px;position:relative;}.yui-skin-sam .yui-editor-container .draggable .yui-toolbar-titlebar{cursor:move;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-titlebar h2{color:#000;font-weight:bold;margin:0;padding:.3em 1em;font-size:100%;text-align:left;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-group h3{color:#808080;font-size:75%;margin:1em 0 0;padding-bottom:0;padding-left:.25em;text-align:left;}.yui-toolbar-container span.yui-toolbar-separator{border:none;text-indent:33px;overflow:hidden;margin:0 .25em;}.yui-skin-sam .yui-toolbar-container{background-color:#F2F2F2;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-subcont{padding:0 1em .35em;border-bottom:1px solid #808080;}.yui-skin-sam .yui-toolbar-container-collapsed .yui-toolbar-titlebar{border-bottom:1px solid #808080;}.yui-skin-sam .yui-editor-container .visible .yui-menu-shadow,.yui-skin-sam .yui-editor-panel .visible .yui-menu-shadow{display:none;}.yui-skin-sam .yui-editor-container ul{list-style-type:none;margin:0;padding:0;}.yui-skin-sam .yui-editor-container ul li{list-style-type:none;margin:0;padding:0;}.yui-skin-sam .yui-toolbar-group ul li.yui-toolbar-groupitem{float:left;}.yui-skin-sam .yui-editor-container .dompath{background-color:#F2F2F2;border-top:1px solid #808080;color:#999;text-align:left;padding:.25em;}.yui-skin-sam .yui-toolbar-container .collapse{background:url(sprite.png) no-repeat 0 -400px;}.yui-skin-sam .yui-toolbar-container .collapsed{background:url(sprite.png) no-repeat 0 -350px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-titlebar span.collapse{cursor:pointer;position:absolute;top:4px;right:2px;display:block;overflow:hidden;height:15px;width:15px;text-indent:9999px;}
+.yui-skin-sam .yui-toolbar-container .yui-push-button,.yui-skin-sam .yui-toolbar-container .yui-color-button,.yui-skin-sam .yui-toolbar-container .yui-menu-button{background:url(sprite.png) repeat-x 0 0;position:relative;display:block;height:22px;width:30px;_font-size:0;margin:0;border-color:#808080;color:#f2f2f2;border-style:solid;border-width:1px 0;zoom:1;}.yui-skin-sam .yui-toolbar-container .yui-push-button a,.yui-skin-sam .yui-toolbar-container .yui-color-button a,.yui-skin-sam .yui-toolbar-container .yui-menu-button a{padding-left:35px;height:20px;text-decoration:none;font-size:0;line-height:2;display:block;color:#000;overflow:hidden;white-space:nowrap;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton a,.yui-skin-sam .yui-toolbar-container .yui-toolbar-select a{font-size:12px;}.yui-skin-sam .yui-toolbar-container .yui-push-button .first-child,.yui-skin-sam .yui-toolbar-container .yui-color-button .first-child,.yui-skin-sam .yui-toolbar-container .yui-menu-button .first-child{border-color:#808080;border-style:solid;border-width:0 1px;margin:0 -1px;display:block;position:relative;}.yui-skin-sam .yui-toolbar-container .yui-push-button-disabled .first-child,.yui-skin-sam .yui-toolbar-container .yui-color-button-disabled .first-child,.yui-skin-sam .yui-toolbar-container .yui-menu-button-disabled .first-child{border-color:#ccc;}.yui-skin-sam .yui-toolbar-container .yui-push-button-disabled a,.yui-skin-sam .yui-toolbar-container .yui-color-button-disabled a,.yui-skin-sam .yui-toolbar-container .yui-menu-button-disabled a{color:#A6A6A6;cursor:default;}.yui-skin-sam .yui-toolbar-container .yui-push-button-disabled,.yui-skin-sam .yui-toolbar-container .yui-color-button-disabled,.yui-skin-sam .yui-toolbar-container .yui-menu-button-disabled{border-color:#ccc;}.yui-skin-sam .yui-toolbar-container .yui-button .first-child{*left:0;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-fontname{width:135px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-heading{width:92px;}.yui-skin-sam .yui-toolbar-container .yui-button-hover{background:url(sprite.png) repeat-x 0 -1300px;border-color:#808080;}.yui-skin-sam .yui-toolbar-container .yui-button-selected{background:url(sprite.png) repeat-x 0 -1700px;border-color:#808080;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-nogrouplabels h3{display:none;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-nogrouplabels .yui-toolbar-group{margin-top:.75em;}.yui-skin-sam .yui-toolbar-container .yui-push-button span.yui-toolbar-icon,.yui-skin-sam .yui-toolbar-container .yui-color-button span.yui-toolbar-icon,.yui-skin-sam .yui-toolbar-container .yui-menu-button span.yui-toolbar-icon{display:block;position:absolute;top:2px;height:18px;width:18px;overflow:hidden;background:url(editor-sprite.gif) no-repeat 30px 30px;}.yui-skin-sam .yui-toolbar-container .yui-button-selected span.yui-toolbar-icon,.yui-skin-sam .yui-toolbar-container .yui-button-hover span.yui-toolbar-icon{background-image:url(editor-sprite-active.gif);}.yui-skin-sam .yui-toolbar-container .visible .yuimenuitemlabel{cursor:pointer;color:#000;*position:relative;}.yui-skin-sam .yui-toolbar-container .yui-button-menu{background-color:#fff;}.yui-skin-sam .yui-toolbar-container .yui-button-menu .yui-menu-body-scrolled{position:relative;}.yui-skin-sam div.yuimenu li.selected{background-color:#B3D4FF;}.yui-skin-sam div.yuimenu li.selected a.selected{color:#000;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-bold span.yui-toolbar-icon{background-position:0 0;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-strikethrough span.yui-toolbar-icon{background-position:0 -108px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-italic span.yui-toolbar-icon{background-position:0 -36px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-undo span.yui-toolbar-icon{background-position:0 -1326px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-redo span.yui-toolbar-icon{background-position:0 -1355px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-underline span.yui-toolbar-icon{background-position:0 -72px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-subscript span.yui-toolbar-icon{background-position:0 -180px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-superscript span.yui-toolbar-icon{background-position:0 -144px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-forecolor span.yui-toolbar-icon{background-position:0 -216px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-backcolor span.yui-toolbar-icon{background-position:0 -288px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-justifyleft span.yui-toolbar-icon{background-position:0 -324px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-justifycenter span.yui-toolbar-icon{background-position:0 -360px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-justifyright span.yui-toolbar-icon{background-position:0 -396px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-justifyfull span.yui-toolbar-icon{background-position:0 -432px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-indent span.yui-toolbar-icon{background-position:0 -720px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-outdent span.yui-toolbar-icon{background-position:0 -684px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-createlink span.yui-toolbar-icon{background-position:0 -792px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-insertimage span.yui-toolbar-icon{background-position:1px -756px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-left span.yui-toolbar-icon{background-position:0 -972px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-right span.yui-toolbar-icon{background-position:0 -936px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-inline span.yui-toolbar-icon{background-position:0 -900px;left:5px;}
+.yui-skin-sam .yui-toolbar-container .yui-toolbar-block span.yui-toolbar-icon{background-position:0 -864px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-bordercolor span.yui-toolbar-icon{background-position:0 -252px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-removeformat span.yui-toolbar-icon{background-position:0 -1080px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-hiddenelements span.yui-toolbar-icon{background-position:0 -1044px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-insertunorderedlist span.yui-toolbar-icon{background-position:0 -468px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-insertorderedlist span.yui-toolbar-icon{background-position:0 -504px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton,.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton .first-child{width:35px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton .first-child a{padding-left:2px;text-align:left;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton span.yui-toolbar-icon{display:none;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton a.up,.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton a.down{right:2px;background:url(editor-sprite.gif) no-repeat 0 -1222px;overflow:hidden;height:6px;width:7px;min-height:0;padding:0;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton a.up{top:2px;background-position:0 -1222px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton a.down{bottom:2px;background-position:0 -1187px;}.yui-skin-sam .yui-toolbar-container select{height:22px;border:1px solid #808080;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-select .first-child a{padding-left:5px;text-align:left;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-select span.yui-toolbar-icon{background:url(editor-sprite.gif) no-repeat 0 -1144px;overflow:hidden;right:-2px;top:0;height:20px;}.yui-skin-sam .yui-editor-panel .yui-color-button-menu .bd{background-color:transparent;border:none;width:135px;}.yui-skin-sam .yui-color-button-menu .yui-toolbar-colors{border:1px solid #808080;}.yui-skin-sam .yui-editor-panel{padding:0;margin:0;border:none;background-color:transparent;overflow:visible;position:absolute;}.yui-skin-sam .yui-editor-panel .hd{margin:10px 0 0;padding:0;border:none;}.yui-skin-sam .yui-editor-panel .hd h3{color:#000;border:1px solid #808080;background:url(sprite.png) repeat-x 0 -200px;width:99%;position:relative;margin:0;padding:3px 0 0 0;font-size:93%;text-indent:5px;height:20px;}.yui-skin-sam .yui-editor-panel .bd{background-color:#F2F2F2;border-left:1px solid #808080;border-right:1px solid #808080;width:99%;margin:0;padding:0;overflow:visible;}.yui-skin-sam .yui-editor-panel ul{list-style-type:none;margin:0;padding:0;}.yui-skin-sam .yui-editor-panel ul li{margin:0;padding:0;}.yui-skin-sam .yui-editor-panel .yui-toolbar-container .yui-toolbar-subcont{padding:0;border:none;margin-top:.35em;}.yui-skin-sam .yui-editor-panel .yui-toolbar-bordersize,.yui-skin-sam .yui-editor-panel .yui-toolbar-bordertype{width:50px;}.yui-skin-sam .yui-editor-panel label{display:block;float:none;padding:4px 0;margin-bottom:7px;}.yui-skin-sam .yui-editor-panel label strong{font-weight:normal;font-size:93%;text-align:right;padding-top:2px;}.yui-skin-sam .yui-editor-panel label input{width:75%;}.yui-skin-sam .yui-editor-panel .createlink_target,.yui-skin-sam .yui-editor-panel .insertimage_target{width:auto;margin-right:5px;}.yui-skin-sam .yui-editor-panel .removeLink{width:98%;}.yui-skin-sam .yui-editor-panel label input.warning{background-color:#FFEE69;}.yui-skin-sam .yui-editor-panel .yui-toolbar-group h3{color:#000;float:left;font-weight:normal;font-size:93%;margin:5px 0 0 0;padding:0 3px 0 0;text-align:right;}.yui-skin-sam .yui-editor-panel .height-width h3{margin:3px 0 0 10px;}.yui-skin-sam .yui-editor-panel .height-width{margin:3px 0 0 35px;*margin-left:14px;width:42%;*width:44%;}.yui-skin-sam .yui-editor-panel .yui-toolbar-group-border{width:190px;}.yui-skin-sam .yui-editor-panel .no-button .yui-toolbar-group-border{width:210px;}.yui-skin-sam .yui-editor-panel .yui-toolbar-group-padding{width:203px;_width:198px;}.yui-skin-sam .yui-editor-panel .no-button .yui-toolbar-group-padding{width:172px;}.yui-skin-sam .yui-editor-panel .yui-toolbar-group-padding h3{margin-left:25px;*margin-left:12px;}.yui-skin-sam .yui-editor-panel .yui-toolbar-group-textflow{width:182px;}.yui-skin-sam .yui-editor-panel .hd{background:none;}.yui-skin-sam .yui-editor-panel .ft{background-color:#F2F2F2;border:1px solid #808080;border-top:none;padding:0;margin:0 0 2px 0;}.yui-skin-sam .yui-editor-panel .hd span.close{background:url(sprite.png) no-repeat 0 -300px;cursor:pointer;display:block;height:16px;overflow:hidden;position:absolute;right:5px;text-indent:500px;top:2px;width:26px;}.yui-skin-sam .yui-editor-panel .ft span.tip{background-color:#EDF5FF;border-top:1px solid #808080;font-size:85%;}.yui-skin-sam .yui-editor-panel .ft span.tip strong{display:block;float:left;margin:0 2px 8px 0;}.yui-skin-sam .yui-editor-panel .ft span.tip span.icon{background:url(editor-sprite.gif) no-repeat 0 -1260px;display:block;height:20px;left:2px;position:absolute;top:8px;width:20px;}.yui-skin-sam .yui-editor-panel .ft span.tip span.icon-info{background-position:2px -1260px;}.yui-skin-sam .yui-editor-panel .ft span.tip span.icon-warn{background-position:2px -1296px;}.yui-skin-sam .yui-editor-panel .hd span.knob{position:absolute;height:10px;width:28px;top:-10px;left:25px;text-indent:9999px;overflow:hidden;background:url(editor-knob.gif) no-repeat 0 0;}.yui-skin-sam .yui-editor-panel .yui-toolbar-container{float:left;width:100%;background-image:none;border:none;}.yui-skin-sam .yui-editor-panel .yui-toolbar-container .bd{background-color:#fff;}.yui-editor-blankimage{background-image:url(blankimage.png);}.yui-skin-sam .yui-editor-container .yui-resize-handle-br{height:11px;width:11px;background-position:-20px -60px;background-color:transparent;}

diff --git a/js/yui/assets/skins/sam/header_background.png b/js/yui/assets/skins/sam/header_background.png
new file mode 100644 (file)
index 0000000..3ef7909
Binary files /dev/null and b/js/yui/assets/skins/sam/header_background.png differ

diff --git a/js/yui/assets/skins/sam/hue_bg.png b/js/yui/assets/skins/sam/hue_bg.png
new file mode 100644 (file)
index 0000000..d9bcdeb
Binary files /dev/null and b/js/yui/assets/skins/sam/hue_bg.png differ

diff --git a/js/yui/assets/skins/sam/imagecropper.css b/js/yui/assets/skins/sam/imagecropper.css
new file mode 100644 (file)
index 0000000..87a081a
--- /dev/null
+++ b/js/yui/assets/skins/sam/imagecropper.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+.yui-crop{position:relative;}.yui-crop .yui-crop-mask{position:absolute;top:0;left:0;height:100%;width:100%;}.yui-crop .yui-resize{position:absolute;top:10px;left:10px;border:0;}.yui-crop .yui-crop-resize-mask{position:absolute;top:0;left:0;height:100%;width:100%;background-position:-10px -10px;overflow:hidden;}.yui-skin-sam .yui-crop .yui-crop-mask{background-color:#000;opacity:.5;filter:alpha(opacity=50);}.yui-skin-sam .yui-crop .yui-resize{border:1px dashed #fff;}

diff --git a/js/yui/assets/skins/sam/layout.css b/js/yui/assets/skins/sam/layout.css
new file mode 100644 (file)
index 0000000..de790e9
--- /dev/null
+++ b/js/yui/assets/skins/sam/layout.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+.yui-layout-loading{visibility:hidden;}body.yui-layout{overflow:hidden;position:relative;padding:0;margin:0;}.yui-layout-doc{position:relative;overflow:hidden;padding:0;margin:0;}.yui-layout-unit{height:50px;width:50px;padding:0;margin:0;float:none;z-index:0;}.yui-layout-unit-top{position:absolute;top:0;left:0;width:100%;}.yui-layout-unit-left{position:absolute;top:0;left:0;}.yui-layout-unit-right{position:absolute;top:0;right:0;}.yui-layout-unit-bottom{position:absolute;bottom:0;left:0;width:100%;}.yui-layout-unit-center{position:absolute;top:0;left:0;width:100%;}.yui-layout div.yui-layout-hd{position:absolute;top:0;left:0;zoom:1;width:100%;}.yui-layout div.yui-layout-bd{position:absolute;top:0;left:0;zoom:1;width:100%;}.yui-layout .yui-layout-noscroll div.yui-layout-bd{overflow:hidden;}.yui-layout .yui-layout-scroll div.yui-layout-bd{overflow:auto;}.yui-layout div.yui-layout-ft{position:absolute;bottom:0;left:0;width:100%;zoom:1;}.yui-layout .yui-layout-unit div.yui-layout-hd h2{text-align:left;}.yui-layout .yui-layout-unit div.yui-layout-hd .collapse{cursor:pointer;height:13px;position:absolute;right:2px;top:2px;width:17px;font-size:0;}.yui-layout .yui-layout-unit div.yui-layout-hd .close{cursor:pointer;height:13px;position:absolute;right:2px;top:2px;width:17px;font-size:0;}.yui-layout .yui-layout-unit div.yui-layout-hd .collapse-close{right:25px;}.yui-layout .yui-layout-clip{position:absolute;height:20px;background-color:#c0c0c0;display:none;}.yui-layout .yui-layout-clip .collapse{cursor:pointer;height:13px;position:absolute;right:2px;top:2px;width:17px;font-size:0;}.yui-layout .yui-layout-wrap{height:100%;width:100%;position:absolute;left:0;}.yui-skin-sam .yui-layout .yui-resize-proxy{border:none;font-size:0;margin:0;padding:0;}.yui-skin-sam .yui-layout .yui-resize-resizing .yui-resize-handle{display:none;zoom:1;}.yui-skin-sam .yui-layout .yui-resize-proxy div{position:absolute;border:1px solid #808080;background-color:#EDF5FF;}.yui-skin-sam .yui-layout .yui-resize .yui-resize-handle-active{zoom:1;}.yui-skin-sam .yui-layout .yui-resize-proxy .yui-layout-handle-l{width:5px;height:100%;top:0;left:0;zoom:1;}.yui-skin-sam .yui-layout .yui-resize-proxy .yui-layout-handle-r{width:5px;top:0;right:0;height:100%;position:absolute;zoom:1;}.yui-skin-sam .yui-layout .yui-resize-proxy .yui-layout-handle-b{width:100%;bottom:0;left:0;height:5px;}.yui-skin-sam .yui-layout .yui-resize-proxy .yui-layout-handle-t{width:100%;top:0;left:0;height:5px;}.yui-skin-sam .yui-layout .yui-layout-unit-left div.yui-layout-hd .collapse{background:transparent url(layout_sprite.png) no-repeat -20px -160px;border:1px solid #808080;}.yui-skin-sam .yui-layout .yui-layout-clip-left .collapse{background:transparent url(layout_sprite.png) no-repeat -20px -140px;border:1px solid #808080;}.yui-skin-sam .yui-layout .yui-layout-unit-right div.yui-layout-hd .collapse{background:transparent url(layout_sprite.png) no-repeat -20px -200px;border:1px solid #808080;}.yui-skin-sam .yui-layout .yui-layout-clip-right .collapse{background:transparent url(layout_sprite.png) no-repeat -20px -120px;border:1px solid #808080;}.yui-skin-sam .yui-layout .yui-layout-unit-top div.yui-layout-hd .collapse{background:transparent url(layout_sprite.png) no-repeat -20px -220px;border:1px solid #808080;}.yui-skin-sam .yui-layout .yui-layout-clip-top .collapse{background:transparent url(layout_sprite.png) no-repeat -20px -240px;border:1px solid #808080;}.yui-skin-sam .yui-layout .yui-layout-unit-bottom div.yui-layout-hd .collapse{background:transparent url(layout_sprite.png) no-repeat -20px -260px;border:1px solid #808080;}.yui-skin-sam .yui-layout .yui-layout-clip-bottom .collapse{background:transparent url(layout_sprite.png) no-repeat -20px -180px;border:1px solid #808080;}.yui-skin-sam .yui-layout .yui-layout-unit div.yui-layout-hd .close{background:transparent url(layout_sprite.png) no-repeat -20px -100px;border:1px solid #808080;}.yui-skin-sam .yui-layout .yui-layout-hd{background:url(sprite.png) repeat-x 0 -1400px;border:1px solid #808080;}.yui-skin-sam .yui-layout{background-color:#EDF5FF;}.yui-skin-sam .yui-layout .yui-layout-unit div.yui-layout-hd h2{font-weight:bold;color:#fff;padding:3px;margin:0;}.yui-skin-sam .yui-layout .yui-layout-unit div.yui-layout-bd{border:1px solid #808080;border-bottom:none;border-top:none;*border-bottom-width:0;*border-top-width:0;background-color:#f2f2f2;text-align:left;}.yui-skin-sam .yui-layout .yui-layout-unit div.yui-layout-bd-noft{border-bottom:1px solid #808080;}.yui-skin-sam .yui-layout .yui-layout-unit div.yui-layout-bd-nohd{border-top:1px solid #808080;}.yui-skin-sam .yui-layout .yui-layout-clip{position:absolute;height:20px;background-color:#EDF5FF;display:none;border:1px solid #808080;}.yui-skin-sam .yui-layout div.yui-layout-ft{border:1px solid #808080;border-top:none;*border-top-width:0;background-color:#f2f2f2;}.yui-skin-sam .yui-layout-unit .yui-resize-handle{background-color:transparent;zoom:1;}.yui-skin-sam .yui-layout-unit .yui-resize-handle-r{right:0;top:0;background-image:none;zoom:1;}.yui-skin-sam .yui-layout-unit .yui-resize-handle-l{left:0;top:0;background-image:none;zoom:1;}.yui-skin-sam .yui-layout-unit .yui-resize-handle-b{right:0;bottom:0;background-image:none;}.yui-skin-sam .yui-layout-unit .yui-resize-handle-t{right:0;top:0;background-image:none;}.yui-skin-sam .yui-layout-unit .yui-resize-handle-r .yui-layout-resize-knob,.yui-skin-sam .yui-layout-unit .yui-resize-handle-l .yui-layout-resize-knob{position:absolute;height:16px;width:6px;top:45%;left:0;display:block;background:transparent url(layout_sprite.png) no-repeat 0 -5px;}.yui-skin-sam .yui-layout-unit .yui-resize-handle-t .yui-layout-resize-knob,.yui-skin-sam .yui-layout-unit .yui-resize-handle-b .yui-layout-resize-knob{position:absolute;height:6px;width:16px;left:45%;background:transparent url(layout_sprite.png) no-repeat -20px 0;zoom:1;}

diff --git a/js/yui/assets/skins/sam/layout_sprite.png b/js/yui/assets/skins/sam/layout_sprite.png
new file mode 100644 (file)
index 0000000..d6fce3c
Binary files /dev/null and b/js/yui/assets/skins/sam/layout_sprite.png differ

diff --git a/js/yui/assets/skins/sam/loading.gif b/js/yui/assets/skins/sam/loading.gif
new file mode 100644 (file)
index 0000000..0bbf3bc
Binary files /dev/null and b/js/yui/assets/skins/sam/loading.gif differ

diff --git a/js/yui/assets/skins/sam/logger.css b/js/yui/assets/skins/sam/logger.css
new file mode 100644 (file)
index 0000000..bc5397e
--- /dev/null
+++ b/js/yui/assets/skins/sam/logger.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+.yui-skin-sam .yui-log{padding:1em;width:31em;background-color:#AAA;color:#000;border:1px solid black;font-family:monospace;font-size:77%;text-align:left;z-index:9000}.yui-skin-sam .yui-log-container{position:absolute;top:1em;right:1em}.yui-skin-sam .yui-log input{margin:0;padding:0;font-family:arial;font-size:100%;font-weight:normal}.yui-skin-sam .yui-log .yui-log-btns{position:relative;float:right;bottom:.25em}.yui-skin-sam .yui-log .yui-log-hd{margin-top:1em;padding:.5em;background-color:#575757}.yui-skin-sam .yui-log .yui-log-hd h4{margin:0;padding:0;font-size:108%;font-weight:bold;color:#FFF}.yui-skin-sam .yui-log .yui-log-bd{width:100%;height:20em;background-color:#FFF;border:1px solid gray;overflow:auto}.yui-skin-sam .yui-log p{margin:1px;padding:.1em}.yui-skin-sam .yui-log pre{margin:0;padding:0}.yui-skin-sam .yui-log pre.yui-log-verbose{white-space:pre-wrap;white-space:-moz-pre-wrap!important;white-space:-pre-wrap;white-space:-o-pre-wrap;word-wrap:break-word}.yui-skin-sam .yui-log .yui-log-ft{margin-top:.5em}.yui-skin-sam .yui-log .yui-log-ft .yui-log-sourcefilters{width:100%;border-top:1px solid #575757;margin-top:.75em;padding-top:.75em}.yui-skin-sam .yui-log .yui-log-filtergrp{margin-right:.5em}.yui-skin-sam .yui-log .info{background-color:#a7cc25}.yui-skin-sam .yui-log .warn{background-color:#f58516}.yui-skin-sam .yui-log .error{background-color:#e32f0b}.yui-skin-sam .yui-log .time{background-color:#a6c9d7}.yui-skin-sam .yui-log .window{background-color:#f2e886}

diff --git a/js/yui/assets/skins/sam/menu-button-arrow-disabled.png b/js/yui/assets/skins/sam/menu-button-arrow-disabled.png
new file mode 100644 (file)
index 0000000..8cef2ab
Binary files /dev/null and b/js/yui/assets/skins/sam/menu-button-arrow-disabled.png differ

diff --git a/js/yui/assets/skins/sam/menu-button-arrow.png b/js/yui/assets/skins/sam/menu-button-arrow.png
new file mode 100644 (file)
index 0000000..f03dfee
Binary files /dev/null and b/js/yui/assets/skins/sam/menu-button-arrow.png differ

diff --git a/js/yui/assets/skins/sam/menu.css b/js/yui/assets/skins/sam/menu.css
new file mode 100644 (file)
index 0000000..744ef09
--- /dev/null
+++ b/js/yui/assets/skins/sam/menu.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+.yuimenu{top:-999em;left:-999em;}.yuimenubar{position:static;}.yuimenu .yuimenu,.yuimenubar .yuimenu{position:absolute;}.yuimenubar li,.yuimenu li{list-style-type:none;}.yuimenubar ul,.yuimenu ul,.yuimenubar li,.yuimenu li,.yuimenu h6,.yuimenubar h6{margin:0;padding:0;}.yuimenuitemlabel,.yuimenubaritemlabel{text-align:left;white-space:nowrap;}.yuimenubar ul{*zoom:1;}.yuimenubar .yuimenu ul{*zoom:normal;}.yuimenubar>.bd>ul:after{content:".";display:block;clear:both;visibility:hidden;height:0;line-height:0;}.yuimenubaritem{float:left;}.yuimenubaritemlabel,.yuimenuitemlabel{display:block;}.yuimenuitemlabel .helptext{font-style:normal;display:block;margin:-1em 0 0 10em;}.yui-menu-shadow{position:absolute;visibility:hidden;z-index:-1;}.yui-menu-shadow-visible{top:2px;right:-3px;left:-3px;bottom:-3px;visibility:visible;}.hide-scrollbars *{overflow:hidden;}.hide-scrollbars select{display:none;}.yuimenu.show-scrollbars,.yuimenubar.show-scrollbars{overflow:visible;}.yuimenu.hide-scrollbars .yui-menu-shadow,.yuimenubar.hide-scrollbars .yui-menu-shadow{overflow:hidden;}.yuimenu.show-scrollbars .yui-menu-shadow,.yuimenubar.show-scrollbars .yui-menu-shadow{overflow:auto;}.yui-overlay.yui-force-redraw{margin-bottom:1px;}.yui-skin-sam .yuimenubar{font-size:93%;line-height:2;*line-height:1.9;border:solid 1px #808080;background:url(sprite.png) repeat-x 0 0;}.yui-skin-sam .yuimenubarnav .yuimenubaritem{border-right:solid 1px #ccc;}.yui-skin-sam .yuimenubaritemlabel{padding:0 10px;color:#000;text-decoration:none;cursor:default;border-style:solid;border-color:#808080;border-width:1px 0;*position:relative;margin:-1px 0;}.yui-skin-sam .yuimenubaritemlabel:visited{color:#000;}.yui-skin-sam .yuimenubarnav .yuimenubaritemlabel{padding-right:20px;*display:inline-block;}.yui-skin-sam .yuimenubarnav .yuimenubaritemlabel-hassubmenu{background:url(menubaritem_submenuindicator.png) right center no-repeat;}.yui-skin-sam .yuimenubaritem-selected{background:url(sprite.png) repeat-x 0 -1700px;}.yui-skin-sam .yuimenubaritemlabel-selected{border-color:#7D98B8;}.yui-skin-sam .yuimenubarnav .yuimenubaritemlabel-selected{border-left-width:1px;margin-left:-1px;*left:-1px;}.yui-skin-sam .yuimenubaritemlabel-disabled,.yui-skin-sam .yuimenubaritemlabel-disabled:visited{cursor:default;color:#A6A6A6;}.yui-skin-sam .yuimenubarnav .yuimenubaritemlabel-hassubmenu-disabled{background-image:url(menubaritem_submenuindicator_disabled.png);}.yui-skin-sam .yuimenu{font-size:93%;line-height:1.5;*line-height:1.45;}.yui-skin-sam .yuimenubar .yuimenu,.yui-skin-sam .yuimenu .yuimenu{font-size:100%;}.yui-skin-sam .yuimenu .bd{*zoom:1;_zoom:normal;border:solid 1px #808080;background-color:#fff;}.yui-skin-sam .yuimenu .yuimenu .bd{*zoom:normal;}.yui-skin-sam .yuimenu ul{padding:3px 0;border-width:1px 0 0 0;border-color:#ccc;border-style:solid;}.yui-skin-sam .yuimenu ul.first-of-type{border-width:0;}.yui-skin-sam .yuimenu h6{font-weight:bold;border-style:solid;border-color:#ccc;border-width:1px 0 0 0;color:#a4a4a4;padding:3px 10px 0 10px;}.yui-skin-sam .yuimenu ul.hastitle,.yui-skin-sam .yuimenu h6.first-of-type{border-width:0;}.yui-skin-sam .yuimenu .yui-menu-body-scrolled{border-color:#ccc #808080;overflow:hidden;}.yui-skin-sam .yuimenu .topscrollbar,.yui-skin-sam .yuimenu .bottomscrollbar{height:16px;border:solid 1px #808080;background:#fff url(sprite.png) no-repeat 0 0;}.yui-skin-sam .yuimenu .topscrollbar{border-bottom-width:0;background-position:center -950px;}.yui-skin-sam .yuimenu .topscrollbar_disabled{background-position:center -975px;}.yui-skin-sam .yuimenu .bottomscrollbar{border-top-width:0;background-position:center -850px;}.yui-skin-sam .yuimenu .bottomscrollbar_disabled{background-position:center -875px;}.yui-skin-sam .yuimenuitem{_border-bottom:solid 1px #fff;}.yui-skin-sam .yuimenuitemlabel{padding:0 20px;color:#000;text-decoration:none;cursor:default;}.yui-skin-sam .yuimenuitemlabel:visited{color:#000;}.yui-skin-sam .yuimenuitemlabel .helptext{margin-top:-1.5em;*margin-top:-1.45em;}.yui-skin-sam .yuimenuitem-hassubmenu{background-image:url(menuitem_submenuindicator.png);background-position:right center;background-repeat:no-repeat;}.yui-skin-sam .yuimenuitem-checked{background-image:url(menuitem_checkbox.png);background-position:left center;background-repeat:no-repeat;}.yui-skin-sam .yui-menu-shadow-visible{background-color:#000;opacity:.12;filter:alpha(opacity=12);}.yui-skin-sam .yuimenuitem-selected{background-color:#B3D4FF;}.yui-skin-sam .yuimenuitemlabel-disabled,.yui-skin-sam .yuimenuitemlabel-disabled:visited{cursor:default;color:#A6A6A6;}.yui-skin-sam .yuimenuitem-hassubmenu-disabled{background-image:url(menuitem_submenuindicator_disabled.png);}.yui-skin-sam .yuimenuitem-checked-disabled{background-image:url(menuitem_checkbox_disabled.png);}

diff --git a/js/yui/assets/skins/sam/menubaritem_submenuindicator.png b/js/yui/assets/skins/sam/menubaritem_submenuindicator.png
new file mode 100644 (file)
index 0000000..030941c
Binary files /dev/null and b/js/yui/assets/skins/sam/menubaritem_submenuindicator.png differ

diff --git a/js/yui/assets/skins/sam/menubaritem_submenuindicator_disabled.png b/js/yui/assets/skins/sam/menubaritem_submenuindicator_disabled.png
new file mode 100644 (file)
index 0000000..6c16122
Binary files /dev/null and b/js/yui/assets/skins/sam/menubaritem_submenuindicator_disabled.png differ

diff --git a/js/yui/assets/skins/sam/menuitem_checkbox.png b/js/yui/assets/skins/sam/menuitem_checkbox.png
new file mode 100644 (file)
index 0000000..1437a4f
Binary files /dev/null and b/js/yui/assets/skins/sam/menuitem_checkbox.png differ

diff --git a/js/yui/assets/skins/sam/menuitem_checkbox_disabled.png b/js/yui/assets/skins/sam/menuitem_checkbox_disabled.png
new file mode 100644 (file)
index 0000000..5d5b998
Binary files /dev/null and b/js/yui/assets/skins/sam/menuitem_checkbox_disabled.png differ

diff --git a/js/yui/assets/skins/sam/menuitem_submenuindicator.png b/js/yui/assets/skins/sam/menuitem_submenuindicator.png
new file mode 100644 (file)
index 0000000..ea4f660
Binary files /dev/null and b/js/yui/assets/skins/sam/menuitem_submenuindicator.png differ

diff --git a/js/yui/assets/skins/sam/menuitem_submenuindicator_disabled.png b/js/yui/assets/skins/sam/menuitem_submenuindicator_disabled.png
new file mode 100644 (file)
index 0000000..427d60a
Binary files /dev/null and b/js/yui/assets/skins/sam/menuitem_submenuindicator_disabled.png differ

diff --git a/js/yui/assets/skins/sam/paginator.css b/js/yui/assets/skins/sam/paginator.css
new file mode 100644 (file)
index 0000000..57a10bc
--- /dev/null
+++ b/js/yui/assets/skins/sam/paginator.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+.yui-skin-sam .yui-pg-container{display:block;margin:6px 0;white-space:nowrap}.yui-skin-sam .yui-pg-first,.yui-skin-sam .yui-pg-previous,.yui-skin-sam .yui-pg-next,.yui-skin-sam .yui-pg-last,.yui-skin-sam .yui-pg-current,.yui-skin-sam .yui-pg-pages,.yui-skin-sam .yui-pg-page{display:inline-block;font-family:arial,helvetica,clean,sans-serif;padding:3px 6px;zoom:1}.yui-skin-sam .yui-pg-pages{padding:0}.yui-skin-sam .yui-pg-current{padding:3px 0}.yui-skin-sam a.yui-pg-first:link,.yui-skin-sam a.yui-pg-first:visited,.yui-skin-sam a.yui-pg-first:active,.yui-skin-sam a.yui-pg-first:hover,.yui-skin-sam a.yui-pg-previous:link,.yui-skin-sam a.yui-pg-previous:visited,.yui-skin-sam a.yui-pg-previous:active,.yui-skin-sam a.yui-pg-previous:hover,.yui-skin-sam a.yui-pg-next:link,.yui-skin-sam a.yui-pg-next:visited,.yui-skin-sam a.yui-pg-next:active,.yui-skin-sam a.yui-pg-next:hover,.yui-skin-sam a.yui-pg-last:link,.yui-skin-sam a.yui-pg-last:visited,.yui-skin-sam a.yui-pg-last:active,.yui-skin-sam a.yui-pg-last:hover,.yui-skin-sam a.yui-pg-page:link,.yui-skin-sam a.yui-pg-page:visited,.yui-skin-sam a.yui-pg-page:active,.yui-skin-sam a.yui-pg-page:hover{color:#06c;text-decoration:underline;outline:0}.yui-skin-sam span.yui-pg-first,.yui-skin-sam span.yui-pg-previous,.yui-skin-sam span.yui-pg-next,.yui-skin-sam span.yui-pg-last{color:#a6a6a6}.yui-skin-sam .yui-pg-page{background-color:#fff;border:1px solid #cbcbcb;padding:2px 6px;text-decoration:none}.yui-skin-sam .yui-pg-current-page{background-color:transparent;border:0;font-weight:bold;padding:3px 6px}.yui-skin-sam .yui-pg-page{margin-left:1px;margin-right:1px}.yui-skin-sam .yui-pg-first,.yui-skin-sam .yui-pg-previous{padding-left:0}.yui-skin-sam .yui-pg-next,.yui-skin-sam .yui-pg-last{padding-right:0}.yui-skin-sam .yui-pg-current,.yui-skin-sam .yui-pg-rpp-options{margin-left:1em;margin-right:1em}

diff --git a/js/yui/assets/skins/sam/picker_mask.png b/js/yui/assets/skins/sam/picker_mask.png
new file mode 100644 (file)
index 0000000..f8d9193
Binary files /dev/null and b/js/yui/assets/skins/sam/picker_mask.png differ

diff --git a/js/yui/assets/skins/sam/profilerviewer.css b/js/yui/assets/skins/sam/profilerviewer.css
new file mode 100644 (file)
index 0000000..8b3bfb4
--- /dev/null
+++ b/js/yui/assets/skins/sam/profilerviewer.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+.yui-skin-sam .yui-pv{background-color:#4a4a4a;font-family:arial;position:relative;width:99%;z-index:1000;margin-bottom:1em;overflow:hidden;}.yui-skin-sam .yui-pv .hd{background:url(header_background.png) repeat-x;min-height:30px;overflow:hidden;zoom:1;padding:2px 0;}.yui-skin-sam .yui-pv .hd h4{padding:8px 10px;margin:0;font:bold 14px arial;color:#fff;}.yui-skin-sam .yui-pv .hd a{background:#3f6bc3;font:bold 11px arial;color:#fff;padding:4px;margin:3px 10px 0 0;border:1px solid #3f567d;cursor:pointer;display:block;float:right;}.yui-skin-sam .yui-pv .hd span{display:none;}.yui-skin-sam .yui-pv .hd span.yui-pv-busy{height:18px;width:18px;background:url(wait.gif) no-repeat;overflow:hidden;display:block;float:right;margin:4px 10px 0 0;}.yui-skin-sam .yui-pv .hd:after,.yui-pv .bd:after,.yui-skin-sam .yui-pv-chartlegend dl:after{content:'.';visibility:hidden;clear:left;height:0;display:block;}.yui-skin-sam .yui-pv .bd{position:relative;zoom:1;overflow-x:auto;overflow-y:hidden;}.yui-skin-sam .yui-pv .yui-pv-table{padding:0 10px;margin:5px 0 10px 0;}.yui-skin-sam .yui-pv .yui-pv-table .yui-dt-bd td{color:#eeee5c;font:12px arial;}.yui-skin-sam .yui-pv .yui-pv-table tr.yui-dt-odd{background:#929292;}.yui-skin-sam .yui-pv .yui-pv-table tr.yui-dt-even{background:#58637a;}.yui-skin-sam .yui-pv .yui-pv-table tr.yui-dt-even td.yui-dt-asc,.yui-skin-sam .yui-pv .yui-pv-table tr.yui-dt-even td.yui-dt-desc{background:#384970;}.yui-skin-sam .yui-pv .yui-pv-table tr.yui-dt-odd td.yui-dt-asc,.yui-skin-sam .yui-pv .yui-pv-table tr.yui-dt-odd td.yui-dt-desc{background:#6F6E6E;}.yui-skin-sam .yui-pv .yui-pv-table .yui-dt-hd th{background-image:none;background:#2E2D2D;}.yui-skin-sam .yui-pv th.yui-dt-asc .yui-dt-liner{background:transparent url(asc.gif) no-repeat scroll right center;}.yui-skin-sam .yui-pv th.yui-dt-desc .yui-dt-liner{background:transparent url(desc.gif) no-repeat scroll right center;}.yui-skin-sam .yui-pv .yui-pv-table .yui-dt-hd th a{color:#fff;font:bold 12px arial;}.yui-skin-sam .yui-pv .yui-pv-table .yui-dt-hd th.yui-dt-asc,.yui-skin-sam .yui-pv .yui-pv-table .yui-dt-hd th.yui-dt-desc{background:#333;}.yui-skin-sam .yui-pv-chartcontainer{padding:0 10px;}.yui-skin-sam .yui-pv-chart{height:250px;clear:right;margin:5px 0 0 0;color:#fff;}.yui-skin-sam .yui-pv-chartlegend div{float:right;margin:0 0 0 10px;_width:250px;}.yui-skin-sam .yui-pv-chartlegend dl{border:1px solid #999;padding:.2em 0 .2em .5em;zoom:1;margin:5px 0;}.yui-skin-sam .yui-pv-chartlegend dt{float:left;display:block;height:.7em;width:.7em;padding:0;}.yui-skin-sam .yui-pv-chartlegend dd{float:left;display:block;color:#fff;margin:0 1em 0 .5em;padding:0;font:11px arial;}.yui-skin-sam .yui-pv-minimized{height:35px;}.yui-skin-sam .yui-pv-minimized .bd{top:-3000px;}.yui-skin-sam .yui-pv-minimized .hd a.yui-pv-refresh{display:none;}

diff --git a/js/yui/assets/skins/sam/progressbar.css b/js/yui/assets/skins/sam/progressbar.css
new file mode 100644 (file)
index 0000000..b44a87d
--- /dev/null
+++ b/js/yui/assets/skins/sam/progressbar.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+.yui-pb-bar,.yui-pb-mask{width:100%;height:100%}.yui-pb{position:relative;top:0;left:0;width:200px;height:20px;padding:0;border:0;margin:0;text-align:left}.yui-pb-mask{position:absolute;top:0;left:0;z-index:2}.yui-pb-mask div{width:50%;height:50%;background-repeat:no-repeat;padding:0;position:absolute}.yui-pb-tl{background-position:top left}.yui-pb-tr{background-position:top right;left:50%}.yui-pb-bl{background-position:bottom left;top:50%}.yui-pb-br{background-position:bottom right;left:50%;top:50%}.yui-pb-bar{margin:0;position:absolute;left:0;top:0;z-index:1}.yui-pb-ltr .yui-pb-bar{_position:static}.yui-pb-rtl .yui-pb-bar{background-position:right}.yui-pb-btt .yui-pb-bar{background-position:left bottom}.yui-pb-bar{background-color:blue}.yui-pb{border:thin solid #808080}.yui-skin-sam .yui-pb{background-color:transparent;border:solid #808080;border-width:1px 0}.yui-skin-sam .yui-pb-rtl,.yui-skin-sam .yui-pb-ltr{background-image:url(back-h.png);background-repeat:repeat-x}.yui-skin-sam .yui-pb-ttb,.yui-skin-sam .yui-pb-btt{background-image:url(back-v.png);background-repeat:repeat-y}.yui-skin-sam .yui-pb-bar{background-color:transparent}.yui-skin-sam .yui-pb-ltr .yui-pb-bar,.yui-skin-sam .yui-pb-rtl .yui-pb-bar{background-image:url(bar-h.png);background-repeat:repeat-x}.yui-skin-sam .yui-pb-ttb .yui-pb-bar,.yui-skin-sam .yui-pb-btt .yui-pb-bar{background-image:url(bar-v.png);background-repeat:repeat-y}.yui-skin-sam .yui-pb-mask{border:solid #808080;border-width:0 1px;margin:0 -1px}.yui-skin-sam .yui-pb-caption{color:#000;text-align:center;margin:0 auto}.yui-skin-sam .yui-pb-range{color:#a6a6a6}

diff --git a/js/yui/assets/skins/sam/resize.css b/js/yui/assets/skins/sam/resize.css
new file mode 100644 (file)
index 0000000..e332fe9
--- /dev/null
+++ b/js/yui/assets/skins/sam/resize.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+.yui-resize{position:relative;zoom:1;z-index:0;}.yui-resize-wrap{zoom:1;}.yui-draggable{cursor:move;}.yui-resize .yui-resize-handle{position:absolute;z-index:1;font-size:0;margin:0;padding:0;zoom:1;height:1px;width:1px;}.yui-resize .yui-resize-handle-br{height:5px;width:5px;bottom:0;right:0;cursor:se-resize;z-index:2;zoom:1;}.yui-resize .yui-resize-handle-bl{height:5px;width:5px;bottom:0;left:0;cursor:sw-resize;z-index:2;zoom:1;}.yui-resize .yui-resize-handle-tl{height:5px;width:5px;top:0;left:0;cursor:nw-resize;z-index:2;zoom:1;}.yui-resize .yui-resize-handle-tr{height:5px;width:5px;top:0;right:0;cursor:ne-resize;z-index:2;zoom:1;}.yui-resize .yui-resize-handle-r{width:5px;height:100%;top:0;right:0;cursor:e-resize;zoom:1;}.yui-resize .yui-resize-handle-l{height:100%;width:5px;top:0;left:0;cursor:w-resize;zoom:1;}.yui-resize .yui-resize-handle-b{width:100%;height:5px;bottom:0;right:0;cursor:s-resize;zoom:1;}.yui-resize .yui-resize-handle-t{width:100%;height:5px;top:0;right:0;cursor:n-resize;zoom:1;}.yui-resize-proxy{position:absolute;border:1px dashed #000;visibility:hidden;z-index:1000;}.yui-resize-hover .yui-resize-handle,.yui-resize-hidden .yui-resize-handle{opacity:0;filter:alpha(opacity=0);}.yui-resize-ghost{opacity:.5;filter:alpha(opacity=50);}.yui-resize-knob .yui-resize-handle{height:6px;width:6px;}.yui-resize-knob .yui-resize-handle-tr{right:-3px;top:-3px;}.yui-resize-knob .yui-resize-handle-tl{left:-3px;top:-3px;}.yui-resize-knob .yui-resize-handle-bl{left:-3px;bottom:-3px;}.yui-resize-knob .yui-resize-handle-br{right:-3px;bottom:-3px;}.yui-resize-knob .yui-resize-handle-t{left:45%;top:-3px;}.yui-resize-knob .yui-resize-handle-r{right:-3px;top:45%;}.yui-resize-knob .yui-resize-handle-l{left:-3px;top:45%;}.yui-resize-knob .yui-resize-handle-b{left:45%;bottom:-3px;}.yui-resize-status{position:absolute;top:-999px;left:-999px;padding:2px;font-size:80%;display:none;zoom:1;z-index:9999;}.yui-resize-status strong,.yui-resize-status em{font-weight:normal;font-style:normal;padding:1px;zoom:1;}.yui-skin-sam .yui-resize .yui-resize-handle{background-color:#F2F2F2;zoom:1;}.yui-skin-sam .yui-resize .yui-resize-handle-active{background-color:#7D98B8;zoom:1;}.yui-skin-sam .yui-resize .yui-resize-handle-l,.yui-skin-sam .yui-resize .yui-resize-handle-r,.yui-skin-sam .yui-resize .yui-resize-handle-l-active,.yui-skin-sam .yui-resize .yui-resize-handle-r-active{height:100%;zoom:1;}.yui-skin-sam .yui-resize-knob .yui-resize-handle{border:1px solid #808080;}.yui-skin-sam .yui-resize-hover .yui-resize-handle-active{opacity:1;filter:alpha(opacity=100);}.yui-skin-sam .yui-resize-proxy{border:1px dashed #426FD9;}.yui-skin-sam .yui-resize-status{border:1px solid #A6982B;border-top:1px solid #D4C237;background-color:#FFEE69;color:#000;}.yui-skin-sam .yui-resize-status strong,.yui-skin-sam .yui-resize-status em{float:left;display:block;clear:both;padding:1px;text-align:center;}.yui-skin-sam .yui-resize .yui-resize-handle-inner-r,.yui-skin-sam .yui-resize .yui-resize-handle-inner-l{background:transparent url(layout_sprite.png) no-repeat 0 -5px;height:16px;width:5px;position:absolute;top:45%;}.yui-skin-sam .yui-resize .yui-resize-handle-inner-t,.yui-skin-sam .yui-resize .yui-resize-handle-inner-b{background:transparent url(layout_sprite.png) no-repeat -20px 0;height:5px;width:16px;position:absolute;left:50%;}.yui-skin-sam .yui-resize .yui-resize-handle-br{background-image:url(layout_sprite.png);background-repeat:no-repeat;background-position:-22px -62px;}.yui-skin-sam .yui-resize .yui-resize-handle-tr{background-image:url(layout_sprite.png);background-repeat:no-repeat;background-position:-22px -42px;}.yui-skin-sam .yui-resize .yui-resize-handle-tl{background-image:url(layout_sprite.png);background-repeat:no-repeat;background-position:-22px -82px;}.yui-skin-sam .yui-resize .yui-resize-handle-bl{background-image:url(layout_sprite.png);background-repeat:no-repeat;background-position:-22px -23px;}.yui-skin-sam .yui-resize-knob .yui-resize-handle-t,.yui-skin-sam .yui-resize-knob .yui-resize-handle-r,.yui-skin-sam .yui-resize-knob .yui-resize-handle-b,.yui-skin-sam .yui-resize-knob .yui-resize-handle-l,.yui-skin-sam .yui-resize-knob .yui-resize-handle-tl,.yui-skin-sam .yui-resize-knob .yui-resize-handle-tr,.yui-skin-sam .yui-resize-knob .yui-resize-handle-bl,.yui-skin-sam .yui-resize-knob .yui-resize-handle-br,.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-t,.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-r,.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-b,.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-l,.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-tl,.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-tr,.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-bl,.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-br{background-image:none;}.yui-skin-sam .yui-resize-knob .yui-resize-handle-l,.yui-skin-sam .yui-resize-knob .yui-resize-handle-r,.yui-skin-sam .yui-resize-knob .yui-resize-handle-l-active,.yui-skin-sam .yui-resize-knob .yui-resize-handle-r-active{height:6px;width:6px;}.yui-skin-sam .yui-resize-textarea .yui-resize-handle-r{right:-8px;}.yui-skin-sam .yui-resize-textarea .yui-resize-handle-b{bottom:-8px;}.yui-skin-sam .yui-resize-textarea .yui-resize-handle-br{right:-8px;bottom:-8px;}

diff --git a/js/yui/assets/skins/sam/simpleeditor.css b/js/yui/assets/skins/sam/simpleeditor.css
new file mode 100644 (file)
index 0000000..bf4016e
--- /dev/null
+++ b/js/yui/assets/skins/sam/simpleeditor.css
@@ -0,0 +1,10 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+.yui-busy{cursor:wait!important;}.yui-toolbar-container fieldset,.yui-editor-container fieldset{padding:0;margin:0;border:0;}.yui-toolbar-container legend{display:none;}.yui-skin-sam .yui-toolbar-container .yui-button button,.yui-skin-sam .yui-toolbar-container .yui-button a,.yui-skin-sam .yui-toolbar-container .yui-button a:visited{font-size:0;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-select button,.yui-skin-sam .yui-toolbar-container .yui-toolbar-select a,.yui-skin-sam .yui-toolbar-container .yui-toolbar-select a:visited,.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton button,.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton a,.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton a:visited{font-size:12px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton a.up,.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton a.down{font-size:0;line-height:0;padding:0;}.yui-toolbar-container .yui-toolbar-subcont{padding:.25em 0;zoom:1;}.yui-toolbar-container-collapsed .yui-toolbar-subcont{display:none;}.yui-toolbar-container .yui-toolbar-subcont:after{display:block;clear:both;visibility:hidden;content:'.';height:0;}.yui-toolbar-container span.yui-toolbar-draghandle{cursor:move;border-left:1px solid #999;border-right:1px solid #999;overflow:hidden;text-indent:77777px;width:2px;height:20px;display:block;clear:none;float:left;margin:0 0 0 .2em;}.yui-toolbar-container .yui-toolbar-titlebar.draggable{cursor:move;}.yui-toolbar-container .yui-toolbar-titlebar{position:relative;}.yui-toolbar-container .yui-toolbar-titlebar h2{font-weight:bold;letter-spacing:0;border:none;color:#000;margin:0;padding:.2em;}.yui-toolbar-container .yui-toolbar-titlebar h2 a{text-decoration:none;color:#000;cursor:default;}.yui-toolbar-container.yui-toolbar-grouped span.yui-toolbar-draghandle{height:40px;}.yui-toolbar-container .yui-toolbar-group{float:left;margin-right:.5em;zoom:1;}.yui-toolbar-container .yui-toolbar-group:after{display:block;clear:both;visibility:hidden;content:'.';height:0;}.yui-toolbar-container .yui-toolbar-group h3{font-size:75%;padding:0 0 0 .25em;margin:0;}.yui-toolbar-container span.yui-toolbar-separator{width:2px;padding:0;height:18px;margin:.2em 0 .2em .1em;display:none;float:left;}.yui-toolbar-container.yui-toolbar-grouped span.yui-toolbar-separator{height:45px;*height:50px;}.yui-toolbar-container.yui-toolbar-grouped .yui-toolbar-group span.yui-toolbar-separator{height:18px;display:block;}.yui-toolbar-container ul li{margin:0;padding:0;list-style-type:none;}.yui-toolbar-container .yui-toolbar-nogrouplabels h3{display:none;}.yui-toolbar-container .yui-push-button,.yui-toolbar-container .yui-color-button,.yui-toolbar-container .yui-menu-button{position:relative;cursor:pointer;}.yui-toolbar-container .yui-button .first-child,.yui-toolbar-container .yui-button .first-child a{height:100%;width:100%;overflow:hidden;font-size:0;}.yui-toolbar-container .yui-button-disabled{cursor:default;}.yui-toolbar-container .yui-button-disabled .yui-toolbar-icon{opacity:.5;filter:alpha(opacity=50);}.yui-toolbar-container .yui-button-disabled .up,.yui-toolbar-container .yui-button-disabled .down{opacity:.5;filter:alpha(opacity=50);}.yui-toolbar-container .yui-button a{overflow:hidden;}.yui-toolbar-container .yui-toolbar-select .first-child a{cursor:pointer;}.yui-toolbar-fontname-arial{font-family:Arial;}.yui-toolbar-fontname-arial-black{font-family:Arial Black;}.yui-toolbar-fontname-comic-sans-ms{font-family:Comic Sans MS;}.yui-toolbar-fontname-courier-new{font-family:Courier New;}.yui-toolbar-fontname-times-new-roman{font-family:Times New Roman;}.yui-toolbar-fontname-verdana{font-family:Verdana;}.yui-toolbar-fontname-impact{font-family:Impact;}.yui-toolbar-fontname-lucida-console{font-family:Lucida Console;}.yui-toolbar-fontname-tahoma{font-family:Tahoma;}.yui-toolbar-fontname-trebuchet-ms{font-family:Trebuchet MS;}.yui-toolbar-container .yui-toolbar-spinbutton{position:relative;}.yui-toolbar-container .yui-toolbar-spinbutton .first-child a{z-index:0;opacity:1;}.yui-toolbar-container .yui-toolbar-spinbutton a.up,.yui-toolbar-container .yui-toolbar-spinbutton a.down{position:absolute;display:block;right:0;cursor:pointer;z-index:1;padding:0;margin:0;}.yui-toolbar-container .yui-overlay{position:absolute;}.yui-toolbar-container .yui-overlay ul li{margin:0;list-style-type:none;}.yui-toolbar-container{z-index:1;}.yui-editor-container .yui-editor-editable-container{position:relative;z-index:0;width:100%;}.yui-editor-container .yui-editor-masked{background-color:#CCC;height:100%;width:100%;position:absolute;top:0;left:0;opacity:.5;filter:alpha(opacity=50);}.yui-editor-container iframe{border:0;padding:0;margin:0;zoom:1;display:block;}.yui-editor-container .yui-editor-editable{padding:0;margin:0;}.yui-editor-container .dompath{font-size:85%;}.yui-editor-panel .hd{text-align:left;position:relative;}.yui-editor-panel .hd h3{font-weight:bold;padding:.25em 0 .25em .25em;margin:0;}.yui-editor-panel .bd{width:100%;zoom:1;position:relative;}.yui-editor-panel .bd div.yui-editor-body-cont{padding:.25em .1em;zoom:1;}.yui-editor-panel .bd .gecko form{overflow:auto;}.yui-editor-panel .bd div.yui-editor-body-cont:after{display:block;clear:both;visibility:hidden;content:'.';height:0;}.yui-editor-panel .ft{text-align:right;width:99%;float:left;clear:both;}.yui-editor-panel .ft span.tip{display:block;position:relative;padding:.5em .5em .5em 23px;text-align:left;zoom:1;}.yui-editor-panel label{clear:both;float:left;padding:0;width:100%;text-align:left;zoom:1;}.yui-editor-panel .gecko label{overflow:auto;}.yui-editor-panel label strong{float:left;width:6em;}.yui-editor-panel .removeLink{width:80%;text-align:right;}.yui-editor-panel label input{margin-left:.25em;float:left;}.yui-editor-panel .yui-toolbar-group{margin-bottom:.75em;}.yui-editor-panel .height-width{float:left;}.yui-editor-panel .height-width span{font-style:italic;display:block;float:left;overflow:visible;}.yui-editor-panel .height-width span.info{font-size:70%;margin-top:3px;float:none;}
+.yui-editor-panel .yui-toolbar-bordersize,.yui-editor-panel .yui-toolbar-bordertype{font-size:75%;}.yui-editor-panel .yui-toolbar-container span.yui-toolbar-separator{border:none;}.yui-editor-panel .yui-toolbar-bordersize span a span,.yui-editor-panel .yui-toolbar-bordertype span a span{display:block;height:8px;left:4px;position:absolute;top:3px;_top:-5px;width:24px;text-indent:52px;font-size:0;}.yui-editor-panel .yui-toolbar-bordertype span a span.yui-toolbar-bordertype-solid{border-bottom:1px solid black;}.yui-editor-panel .yui-toolbar-bordertype span a span.yui-toolbar-bordertype-dotted{border-bottom:1px dotted black;}.yui-editor-panel .yui-toolbar-bordertype span a span.yui-toolbar-bordertype-dashed{border-bottom:1px dashed black;}.yui-editor-panel .yui-toolbar-bordersize span a span.yui-toolbar-bordersize-0{*top:0;text-indent:0;font-size:75%;}.yui-editor-panel .yui-toolbar-bordersize span a span.yui-toolbar-bordersize-1{border-bottom:1px solid black;}.yui-editor-panel .yui-toolbar-bordersize span a span.yui-toolbar-bordersize-2{border-bottom:2px solid black;}.yui-editor-panel .yui-toolbar-bordersize span a span.yui-toolbar-bordersize-3{top:2px;*top:-5px;border-bottom:3px solid black;}.yui-editor-panel .yui-toolbar-bordersize span a span.yui-toolbar-bordersize-4{top:1px;*top:-5px;border-bottom:4px solid black;}.yui-editor-panel .yui-toolbar-bordersize span a span.yui-toolbar-bordersize-5{top:1px;*top:-5px;border-bottom:5px solid black;}.yui-toolbar-container .yui-toolbar-bordersize-menu,.yui-toolbar-container .yui-toolbar-bordertype-menu{width:95px!important;}.yui-toolbar-bordersize-menu .yuimenuitemlabel,.yui-toolbar-bordertype-menu .yuimenuitemlabel,.yui-toolbar-bordersize-menu .yuimenuitemlabel,.yui-toolbar-bordertype-menu .yuimenuitemlabel:hover{margin:0 3px 7px 17px;}.yui-toolbar-bordersize-menu .yuimenuitemlabel .checkedindicator,.yui-toolbar-bordertype-menu .yuimenuitemlabel .checkedindicator{position:absolute;left:-12px;*top:14px;*left:0;}.yui-toolbar-bordersize-menu li.yui-toolbar-bordersize-1 a{border-bottom:1px solid black;height:14px;}.yui-toolbar-bordersize-menu li.yui-toolbar-bordersize-2 a{border-bottom:2px solid black;height:14px;}.yui-toolbar-bordersize-menu li.yui-toolbar-bordersize-3 a{border-bottom:3px solid black;height:14px;}.yui-toolbar-bordersize-menu li.yui-toolbar-bordersize-4 a{border-bottom:4px solid black;height:14px;}.yui-toolbar-bordersize-menu li.yui-toolbar-bordersize-5 a{border-bottom:5px solid black;height:14px;}.yui-toolbar-bordertype-menu li.yui-toolbar-bordertype-solid a{border-bottom:1px solid black;height:14px;}.yui-toolbar-bordertype-menu li.yui-toolbar-bordertype-dashed a{border-bottom:1px dashed black;height:14px;}.yui-toolbar-bordertype-menu li.yui-toolbar-bordertype-dotted a{border-bottom:1px dotted black;height:14px;}h2.yui-editor-skipheader,h3.yui-editor-skipheader{height:0;margin:0;padding:0;border:none;width:0;overflow:hidden;position:absolute;}.yui-toolbar-colors{width:133px;zoom:1;display:none;z-index:100;overflow:hidden;}.yui-toolbar-colors:after{display:block;clear:both;visibility:hidden;content:'.';height:0;}.yui-toolbar-colors a{height:9px;width:9px;float:left;display:block;overflow:hidden;text-indent:999px;margin:0;cursor:pointer;border:1px solid #F6F7EE;}.yui-toolbar-colors a:hover{border:1px solid black;}.yui-color-button-menu{overflow:visible;background-color:transparent;}.yui-toolbar-colors span{position:relative;display:block;padding:3px;overflow:hidden;float:left;width:100%;zoom:1;}.yui-toolbar-colors span:after{display:block;clear:both;visibility:hidden;content:'.';height:0;}.yui-toolbar-colors span em{height:35px;width:30px;float:left;display:block;overflow:hidden;text-indent:999px;margin:.75px;border:1px solid black;}.yui-toolbar-colors span strong{font-weight:normal;padding-left:3px;display:block;font-size:85%;float:left;width:65%;}.yui-toolbar-group-undoredo h3,.yui-toolbar-group-insertitem h3,.yui-toolbar-group-indentlist h3{width:68px;}.yui-toolbar-group-indentlist2 h3{width:122px;}.yui-toolbar-group-alignment h3{width:130px;}.yui-skin-sam .yui-editor-container{border:1px solid #808080;}.yui-skin-sam .yui-toolbar-container{zoom:1;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-titlebar{background:url(sprite.png) repeat-x 0 -200px;position:relative;}.yui-skin-sam .yui-editor-container .draggable .yui-toolbar-titlebar{cursor:move;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-titlebar h2{color:#000;font-weight:bold;margin:0;padding:.3em 1em;font-size:100%;text-align:left;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-group h3{color:#808080;font-size:75%;margin:1em 0 0;padding-bottom:0;padding-left:.25em;text-align:left;}.yui-toolbar-container span.yui-toolbar-separator{border:none;text-indent:33px;overflow:hidden;margin:0 .25em;}.yui-skin-sam .yui-toolbar-container{background-color:#F2F2F2;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-subcont{padding:0 1em .35em;border-bottom:1px solid #808080;}.yui-skin-sam .yui-toolbar-container-collapsed .yui-toolbar-titlebar{border-bottom:1px solid #808080;}.yui-skin-sam .yui-editor-container .visible .yui-menu-shadow,.yui-skin-sam .yui-editor-panel .visible .yui-menu-shadow{display:none;}.yui-skin-sam .yui-editor-container ul{list-style-type:none;margin:0;padding:0;}.yui-skin-sam .yui-editor-container ul li{list-style-type:none;margin:0;padding:0;}.yui-skin-sam .yui-toolbar-group ul li.yui-toolbar-groupitem{float:left;}.yui-skin-sam .yui-editor-container .dompath{background-color:#F2F2F2;border-top:1px solid #808080;color:#999;text-align:left;padding:.25em;}.yui-skin-sam .yui-toolbar-container .collapse{background:url(sprite.png) no-repeat 0 -400px;}.yui-skin-sam .yui-toolbar-container .collapsed{background:url(sprite.png) no-repeat 0 -350px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-titlebar span.collapse{cursor:pointer;position:absolute;top:4px;right:2px;display:block;overflow:hidden;height:15px;width:15px;text-indent:9999px;}
+.yui-skin-sam .yui-toolbar-container .yui-push-button,.yui-skin-sam .yui-toolbar-container .yui-color-button,.yui-skin-sam .yui-toolbar-container .yui-menu-button{background:url(sprite.png) repeat-x 0 0;position:relative;display:block;height:22px;width:30px;_font-size:0;margin:0;border-color:#808080;color:#f2f2f2;border-style:solid;border-width:1px 0;zoom:1;}.yui-skin-sam .yui-toolbar-container .yui-push-button a,.yui-skin-sam .yui-toolbar-container .yui-color-button a,.yui-skin-sam .yui-toolbar-container .yui-menu-button a{padding-left:35px;height:20px;text-decoration:none;font-size:0;line-height:2;display:block;color:#000;overflow:hidden;white-space:nowrap;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton a,.yui-skin-sam .yui-toolbar-container .yui-toolbar-select a{font-size:12px;}.yui-skin-sam .yui-toolbar-container .yui-push-button .first-child,.yui-skin-sam .yui-toolbar-container .yui-color-button .first-child,.yui-skin-sam .yui-toolbar-container .yui-menu-button .first-child{border-color:#808080;border-style:solid;border-width:0 1px;margin:0 -1px;display:block;position:relative;}.yui-skin-sam .yui-toolbar-container .yui-push-button-disabled .first-child,.yui-skin-sam .yui-toolbar-container .yui-color-button-disabled .first-child,.yui-skin-sam .yui-toolbar-container .yui-menu-button-disabled .first-child{border-color:#ccc;}.yui-skin-sam .yui-toolbar-container .yui-push-button-disabled a,.yui-skin-sam .yui-toolbar-container .yui-color-button-disabled a,.yui-skin-sam .yui-toolbar-container .yui-menu-button-disabled a{color:#A6A6A6;cursor:default;}.yui-skin-sam .yui-toolbar-container .yui-push-button-disabled,.yui-skin-sam .yui-toolbar-container .yui-color-button-disabled,.yui-skin-sam .yui-toolbar-container .yui-menu-button-disabled{border-color:#ccc;}.yui-skin-sam .yui-toolbar-container .yui-button .first-child{*left:0;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-fontname{width:135px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-heading{width:92px;}.yui-skin-sam .yui-toolbar-container .yui-button-hover{background:url(sprite.png) repeat-x 0 -1300px;border-color:#808080;}.yui-skin-sam .yui-toolbar-container .yui-button-selected{background:url(sprite.png) repeat-x 0 -1700px;border-color:#808080;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-nogrouplabels h3{display:none;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-nogrouplabels .yui-toolbar-group{margin-top:.75em;}.yui-skin-sam .yui-toolbar-container .yui-push-button span.yui-toolbar-icon,.yui-skin-sam .yui-toolbar-container .yui-color-button span.yui-toolbar-icon,.yui-skin-sam .yui-toolbar-container .yui-menu-button span.yui-toolbar-icon{display:block;position:absolute;top:2px;height:18px;width:18px;overflow:hidden;background:url(editor-sprite.gif) no-repeat 30px 30px;}.yui-skin-sam .yui-toolbar-container .yui-button-selected span.yui-toolbar-icon,.yui-skin-sam .yui-toolbar-container .yui-button-hover span.yui-toolbar-icon{background-image:url(editor-sprite-active.gif);}.yui-skin-sam .yui-toolbar-container .visible .yuimenuitemlabel{cursor:pointer;color:#000;*position:relative;}.yui-skin-sam .yui-toolbar-container .yui-button-menu{background-color:#fff;}.yui-skin-sam .yui-toolbar-container .yui-button-menu .yui-menu-body-scrolled{position:relative;}.yui-skin-sam div.yuimenu li.selected{background-color:#B3D4FF;}.yui-skin-sam div.yuimenu li.selected a.selected{color:#000;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-bold span.yui-toolbar-icon{background-position:0 0;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-strikethrough span.yui-toolbar-icon{background-position:0 -108px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-italic span.yui-toolbar-icon{background-position:0 -36px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-undo span.yui-toolbar-icon{background-position:0 -1326px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-redo span.yui-toolbar-icon{background-position:0 -1355px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-underline span.yui-toolbar-icon{background-position:0 -72px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-subscript span.yui-toolbar-icon{background-position:0 -180px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-superscript span.yui-toolbar-icon{background-position:0 -144px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-forecolor span.yui-toolbar-icon{background-position:0 -216px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-backcolor span.yui-toolbar-icon{background-position:0 -288px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-justifyleft span.yui-toolbar-icon{background-position:0 -324px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-justifycenter span.yui-toolbar-icon{background-position:0 -360px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-justifyright span.yui-toolbar-icon{background-position:0 -396px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-justifyfull span.yui-toolbar-icon{background-position:0 -432px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-indent span.yui-toolbar-icon{background-position:0 -720px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-outdent span.yui-toolbar-icon{background-position:0 -684px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-createlink span.yui-toolbar-icon{background-position:0 -792px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-insertimage span.yui-toolbar-icon{background-position:1px -756px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-left span.yui-toolbar-icon{background-position:0 -972px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-right span.yui-toolbar-icon{background-position:0 -936px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-inline span.yui-toolbar-icon{background-position:0 -900px;left:5px;}
+.yui-skin-sam .yui-toolbar-container .yui-toolbar-block span.yui-toolbar-icon{background-position:0 -864px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-bordercolor span.yui-toolbar-icon{background-position:0 -252px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-removeformat span.yui-toolbar-icon{background-position:0 -1080px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-hiddenelements span.yui-toolbar-icon{background-position:0 -1044px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-insertunorderedlist span.yui-toolbar-icon{background-position:0 -468px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-insertorderedlist span.yui-toolbar-icon{background-position:0 -504px;left:5px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton,.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton .first-child{width:35px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton .first-child a{padding-left:2px;text-align:left;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton span.yui-toolbar-icon{display:none;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton a.up,.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton a.down{right:2px;background:url(editor-sprite.gif) no-repeat 0 -1222px;overflow:hidden;height:6px;width:7px;min-height:0;padding:0;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton a.up{top:2px;background-position:0 -1222px;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-spinbutton a.down{bottom:2px;background-position:0 -1187px;}.yui-skin-sam .yui-toolbar-container select{height:22px;border:1px solid #808080;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-select .first-child a{padding-left:5px;text-align:left;}.yui-skin-sam .yui-toolbar-container .yui-toolbar-select span.yui-toolbar-icon{background:url(editor-sprite.gif) no-repeat 0 -1144px;overflow:hidden;right:-2px;top:0;height:20px;}.yui-skin-sam .yui-editor-panel .yui-color-button-menu .bd{background-color:transparent;border:none;width:135px;}.yui-skin-sam .yui-color-button-menu .yui-toolbar-colors{border:1px solid #808080;}.yui-skin-sam .yui-editor-panel{padding:0;margin:0;border:none;background-color:transparent;overflow:visible;position:absolute;}.yui-skin-sam .yui-editor-panel .hd{margin:10px 0 0;padding:0;border:none;}.yui-skin-sam .yui-editor-panel .hd h3{color:#000;border:1px solid #808080;background:url(sprite.png) repeat-x 0 -200px;width:99%;position:relative;margin:0;padding:3px 0 0 0;font-size:93%;text-indent:5px;height:20px;}.yui-skin-sam .yui-editor-panel .bd{background-color:#F2F2F2;border-left:1px solid #808080;border-right:1px solid #808080;width:99%;margin:0;padding:0;overflow:visible;}.yui-skin-sam .yui-editor-panel ul{list-style-type:none;margin:0;padding:0;}.yui-skin-sam .yui-editor-panel ul li{margin:0;padding:0;}.yui-skin-sam .yui-editor-panel .yui-toolbar-container .yui-toolbar-subcont{padding:0;border:none;margin-top:.35em;}.yui-skin-sam .yui-editor-panel .yui-toolbar-bordersize,.yui-skin-sam .yui-editor-panel .yui-toolbar-bordertype{width:50px;}.yui-skin-sam .yui-editor-panel label{display:block;float:none;padding:4px 0;margin-bottom:7px;}.yui-skin-sam .yui-editor-panel label strong{font-weight:normal;font-size:93%;text-align:right;padding-top:2px;}.yui-skin-sam .yui-editor-panel label input{width:75%;}.yui-skin-sam .yui-editor-panel .createlink_target,.yui-skin-sam .yui-editor-panel .insertimage_target{width:auto;margin-right:5px;}.yui-skin-sam .yui-editor-panel .removeLink{width:98%;}.yui-skin-sam .yui-editor-panel label input.warning{background-color:#FFEE69;}.yui-skin-sam .yui-editor-panel .yui-toolbar-group h3{color:#000;float:left;font-weight:normal;font-size:93%;margin:5px 0 0 0;padding:0 3px 0 0;text-align:right;}.yui-skin-sam .yui-editor-panel .height-width h3{margin:3px 0 0 10px;}.yui-skin-sam .yui-editor-panel .height-width{margin:3px 0 0 35px;*margin-left:14px;width:42%;*width:44%;}.yui-skin-sam .yui-editor-panel .yui-toolbar-group-border{width:190px;}.yui-skin-sam .yui-editor-panel .no-button .yui-toolbar-group-border{width:210px;}.yui-skin-sam .yui-editor-panel .yui-toolbar-group-padding{width:203px;_width:198px;}.yui-skin-sam .yui-editor-panel .no-button .yui-toolbar-group-padding{width:172px;}.yui-skin-sam .yui-editor-panel .yui-toolbar-group-padding h3{margin-left:25px;*margin-left:12px;}.yui-skin-sam .yui-editor-panel .yui-toolbar-group-textflow{width:182px;}.yui-skin-sam .yui-editor-panel .hd{background:none;}.yui-skin-sam .yui-editor-panel .ft{background-color:#F2F2F2;border:1px solid #808080;border-top:none;padding:0;margin:0 0 2px 0;}.yui-skin-sam .yui-editor-panel .hd span.close{background:url(sprite.png) no-repeat 0 -300px;cursor:pointer;display:block;height:16px;overflow:hidden;position:absolute;right:5px;text-indent:500px;top:2px;width:26px;}.yui-skin-sam .yui-editor-panel .ft span.tip{background-color:#EDF5FF;border-top:1px solid #808080;font-size:85%;}.yui-skin-sam .yui-editor-panel .ft span.tip strong{display:block;float:left;margin:0 2px 8px 0;}.yui-skin-sam .yui-editor-panel .ft span.tip span.icon{background:url(editor-sprite.gif) no-repeat 0 -1260px;display:block;height:20px;left:2px;position:absolute;top:8px;width:20px;}.yui-skin-sam .yui-editor-panel .ft span.tip span.icon-info{background-position:2px -1260px;}.yui-skin-sam .yui-editor-panel .ft span.tip span.icon-warn{background-position:2px -1296px;}.yui-skin-sam .yui-editor-panel .hd span.knob{position:absolute;height:10px;width:28px;top:-10px;left:25px;text-indent:9999px;overflow:hidden;background:url(editor-knob.gif) no-repeat 0 0;}.yui-skin-sam .yui-editor-panel .yui-toolbar-container{float:left;width:100%;background-image:none;border:none;}.yui-skin-sam .yui-editor-panel .yui-toolbar-container .bd{background-color:#fff;}.yui-editor-blankimage{background-image:url(blankimage.png);}.yui-skin-sam .yui-editor-container .yui-resize-handle-br{height:11px;width:11px;background-position:-20px -60px;background-color:transparent;}
\ No newline at end of file

diff --git a/js/yui/assets/skins/sam/slider.css b/js/yui/assets/skins/sam/slider.css
new file mode 100644 (file)
index 0000000..3947edc
--- /dev/null
+++ b/js/yui/assets/skins/sam/slider.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+.yui-h-slider,.yui-v-slider,.yui-region-slider{position:relative;}.yui-h-slider .yui-slider-thumb,.yui-v-slider .yui-slider-thumb,.yui-region-slider .yui-slider-thumb{position:absolute;cursor:default;}.yui-skin-sam .yui-h-slider{background:url(bg-h.gif) no-repeat 5px 0;height:28px;width:228px;}.yui-skin-sam .yui-h-slider .yui-slider-thumb{top:4px;}.yui-skin-sam .yui-v-slider{background:url(bg-v.gif) no-repeat 12px 0;height:228px;width:48px;}.yui-skin-sam .yui-region-slider{height:228px;width:228px;}

diff --git a/js/yui/assets/skins/sam/split-button-arrow-active.png b/js/yui/assets/skins/sam/split-button-arrow-active.png
new file mode 100644 (file)
index 0000000..fa58c50
Binary files /dev/null and b/js/yui/assets/skins/sam/split-button-arrow-active.png differ

diff --git a/js/yui/assets/skins/sam/split-button-arrow-disabled.png b/js/yui/assets/skins/sam/split-button-arrow-disabled.png
new file mode 100644 (file)
index 0000000..0a6a82c
Binary files /dev/null and b/js/yui/assets/skins/sam/split-button-arrow-disabled.png differ

diff --git a/js/yui/assets/skins/sam/split-button-arrow-focus.png b/js/yui/assets/skins/sam/split-button-arrow-focus.png
new file mode 100644 (file)
index 0000000..167d71e
Binary files /dev/null and b/js/yui/assets/skins/sam/split-button-arrow-focus.png differ

diff --git a/js/yui/assets/skins/sam/split-button-arrow-hover.png b/js/yui/assets/skins/sam/split-button-arrow-hover.png
new file mode 100644 (file)
index 0000000..167d71e
Binary files /dev/null and b/js/yui/assets/skins/sam/split-button-arrow-hover.png differ

diff --git a/js/yui/assets/skins/sam/split-button-arrow.png b/js/yui/assets/skins/sam/split-button-arrow.png
new file mode 100644 (file)
index 0000000..b33a93f
Binary files /dev/null and b/js/yui/assets/skins/sam/split-button-arrow.png differ

diff --git a/js/yui/assets/skins/sam/sprite.png b/js/yui/assets/skins/sam/sprite.png
new file mode 100644 (file)
index 0000000..73634d6
Binary files /dev/null and b/js/yui/assets/skins/sam/sprite.png differ

diff --git a/js/yui/assets/skins/sam/tabview.css b/js/yui/assets/skins/sam/tabview.css
new file mode 100644 (file)
index 0000000..9c3a358
--- /dev/null
+++ b/js/yui/assets/skins/sam/tabview.css
@@ -0,0 +1,8 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+.yui-navset .yui-nav li,.yui-navset .yui-navset-top .yui-nav li,.yui-navset .yui-navset-bottom .yui-nav li{margin:0 .5em 0 0}.yui-navset-left .yui-nav li,.yui-navset-right .yui-nav li{margin:0 0 .5em}.yui-navset .yui-content .yui-hidden{border:0;height:0;width:0;padding:0;position:absolute;left:-999999px;overflow:hidden;visibility:hidden}.yui-navset .yui-navset-left .yui-nav,.yui-navset .yui-navset-right .yui-nav,.yui-navset-left .yui-nav,.yui-navset-right .yui-nav{width:6em}.yui-navset-top .yui-nav,.yui-navset-bottom .yui-nav{width:auto}.yui-navset .yui-navset-left,.yui-navset-left{padding:0 0 0 6em}.yui-navset-right{padding:0 6em 0 0}.yui-navset-top,.yui-navset-bottom{padding:auto}.yui-nav,.yui-nav li{margin:0;padding:0;list-style:none}.yui-navset li em{font-style:normal}.yui-navset{position:relative;zoom:1}.yui-navset .yui-content,.yui-navset .yui-content div{zoom:1}.yui-navset .yui-content:after{content:'';display:block;clear:both}.yui-navset .yui-nav li,.yui-navset .yui-navset-top .yui-nav li,.yui-navset .yui-navset-bottom .yui-nav li{display:inline-block;display:-moz-inline-stack;*display:inline;vertical-align:bottom;cursor:pointer;zoom:1}.yui-navset-left .yui-nav li,.yui-navset-right .yui-nav li{display:block}.yui-navset .yui-nav a{position:relative}.yui-navset .yui-nav li a,.yui-navset-top .yui-nav li a,.yui-navset-bottom .yui-nav li a{display:block;display:inline-block;vertical-align:bottom;zoom:1}.yui-navset-left .yui-nav li a,.yui-navset-right .yui-nav li a{display:block}.yui-navset-bottom .yui-nav li a{vertical-align:text-top}.yui-navset .yui-nav li a em,.yui-navset-top .yui-nav li a em,.yui-navset-bottom .yui-nav li a em{display:block}.yui-navset .yui-navset-left .yui-nav,.yui-navset .yui-navset-right .yui-nav,.yui-navset-left .yui-nav,.yui-navset-right .yui-nav{position:absolute;z-index:1}.yui-navset-top .yui-nav,.yui-navset-bottom .yui-nav{position:static}.yui-navset .yui-navset-left .yui-nav,.yui-navset-left .yui-nav{left:0;right:auto}.yui-navset .yui-navset-right .yui-nav,.yui-navset-right .yui-nav{right:0;left:auto}.yui-skin-sam .yui-navset .yui-nav,.yui-skin-sam .yui-navset .yui-navset-top .yui-nav{border:solid #2647a0;border-width:0 0 5px;zoom:1}.yui-skin-sam .yui-navset .yui-nav li,.yui-skin-sam .yui-navset .yui-navset-top .yui-nav li{margin:0 .16em 0 0;padding:1px 0 0;zoom:1}.yui-skin-sam .yui-navset .yui-nav .selected,.yui-skin-sam .yui-navset .yui-navset-top .yui-nav .selected{margin:0 .16em -1px 0}.yui-skin-sam .yui-navset .yui-nav a,.yui-skin-sam .yui-navset .yui-navset-top .yui-nav a{background:#d8d8d8 url(sprite.png) repeat-x;border:solid #a3a3a3;border-width:0 1px;color:#000;position:relative;text-decoration:none}.yui-skin-sam .yui-navset .yui-nav a em,.yui-skin-sam .yui-navset .yui-navset-top .yui-nav a em{border:solid #a3a3a3;border-width:1px 0 0;padding:.25em .75em;left:0;right:0;bottom:0;top:-1px;position:relative}.yui-skin-sam .yui-navset .yui-nav .selected a,.yui-skin-sam .yui-navset .yui-nav .selected a:focus,.yui-skin-sam .yui-navset .yui-nav .selected a:hover{background:#2647a0 url(sprite.png) repeat-x left -1400px;color:#fff}.yui-skin-sam .yui-navset .yui-nav a:hover,.yui-skin-sam .yui-navset .yui-nav a:focus{background:#bfdaff url(sprite.png) repeat-x left -1300px;outline:0}.yui-skin-sam .yui-navset .yui-nav .selected a em{padding:.35em .75em}.yui-skin-sam .yui-navset .yui-nav .selected a,.yui-skin-sam .yui-navset .yui-nav .selected a em{border-color:#243356}.yui-skin-sam .yui-navset .yui-content{background:#edf5ff}.yui-skin-sam .yui-navset .yui-content,.yui-skin-sam .yui-navset .yui-navset-top .yui-content{border:1px solid #808080;border-top-color:#243356;padding:.25em .5em}.yui-skin-sam .yui-navset-left .yui-nav,.yui-skin-sam .yui-navset .yui-navset-left .yui-nav,.yui-skin-sam .yui-navset .yui-navset-right .yui-nav,.yui-skin-sam .yui-navset-right .yui-nav{border-width:0 5px 0 0;Xposition:absolute;top:0;bottom:0}.yui-skin-sam .yui-navset .yui-navset-right .yui-nav,.yui-skin-sam .yui-navset-right .yui-nav{border-width:0 0 0 5px}.yui-skin-sam .yui-navset-left .yui-nav li,.yui-skin-sam .yui-navset .yui-navset-left .yui-nav li,.yui-skin-sam .yui-navset-right .yui-nav li{margin:0 0 .16em;padding:0 0 0 1px}.yui-skin-sam .yui-navset-right .yui-nav li{padding:0 1px 0 0}.yui-skin-sam .yui-navset-left .yui-nav .selected,.yui-skin-sam .yui-navset .yui-navset-left .yui-nav .selected{margin:0 -1px .16em 0}.yui-skin-sam .yui-navset-right .yui-nav .selected{margin:0 0 .16em -1px}.yui-skin-sam .yui-navset-left .yui-nav a,.yui-skin-sam .yui-navset-right .yui-nav a{border-width:1px 0}.yui-skin-sam .yui-navset-left .yui-nav a em,.yui-skin-sam .yui-navset .yui-navset-left .yui-nav a em,.yui-skin-sam .yui-navset-right .yui-nav a em{border-width:0 0 0 1px;padding:.2em .75em;top:auto;left:-1px}.yui-skin-sam .yui-navset-right .yui-nav a em{border-width:0 1px 0 0;left:auto;right:-1px}.yui-skin-sam .yui-navset-left .yui-nav a,.yui-skin-sam .yui-navset-left .yui-nav .selected a,.yui-skin-sam .yui-navset-left .yui-nav a:hover,.yui-skin-sam .yui-navset-right .yui-nav a,.yui-skin-sam .yui-navset-right .yui-nav .selected a,.yui-skin-sam .yui-navset-right .yui-nav a:hover,.yui-skin-sam .yui-navset-bottom .yui-nav a,.yui-skin-sam .yui-navset-bottom .yui-nav .selected a,.yui-skin-sam .yui-navset-bottom .yui-nav a:hover{background-image:none}.yui-skin-sam .yui-navset-left .yui-content{border:1px solid #808080;border-left-color:#243356}.yui-skin-sam .yui-navset-bottom .yui-nav,.yui-skin-sam .yui-navset .yui-navset-bottom .yui-nav{border-width:5px 0 0}.yui-skin-sam .yui-navset .yui-navset-bottom .yui-nav .selected,.yui-skin-sam .yui-navset-bottom .yui-nav .selected{margin:-1px .16em 0 0}.yui-skin-sam .yui-navset .yui-navset-bottom .yui-nav li,.yui-skin-sam .yui-navset-bottom .yui-nav li{padding:0 0 1px 0;vertical-align:top}.yui-skin-sam .yui-navset .yui-navset-bottom .yui-nav a em,.yui-skin-sam .yui-navset-bottom .yui-nav a em{border-width:0 0 1px;top:auto;bottom:-1px}
+.yui-skin-sam .yui-navset-bottom .yui-content,.yui-skin-sam .yui-navset .yui-navset-bottom .yui-content{border:1px solid #808080;border-bottom-color:#243356}

diff --git a/js/yui/assets/skins/sam/treeview-loading.gif b/js/yui/assets/skins/sam/treeview-loading.gif
new file mode 100644 (file)
index 0000000..0bbf3bc
Binary files /dev/null and b/js/yui/assets/skins/sam/treeview-loading.gif differ

diff --git a/js/yui/assets/skins/sam/treeview-sprite.gif b/js/yui/assets/skins/sam/treeview-sprite.gif
new file mode 100644 (file)
index 0000000..8fb3f01
Binary files /dev/null and b/js/yui/assets/skins/sam/treeview-sprite.gif differ

diff --git a/js/yui/assets/skins/sam/treeview.css b/js/yui/assets/skins/sam/treeview.css
new file mode 100644 (file)
index 0000000..8fa8da8
--- /dev/null
+++ b/js/yui/assets/skins/sam/treeview.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+table.ygtvtable{margin-bottom:0;border:0;border-collapse:collapse}td.ygtvcell{border:0;padding:0}a.ygtvspacer{text-decoration:none;outline-style:none;display:block}.ygtvtn{width:18px;height:22px;background:url(treeview-sprite.gif) 0 -5600px no-repeat;cursor:pointer}.ygtvtm{width:18px;height:22px;cursor:pointer;background:url(treeview-sprite.gif) 0 -4000px no-repeat}.ygtvtmh,.ygtvtmhh{width:18px;height:22px;cursor:pointer;background:url(treeview-sprite.gif) 0 -4800px no-repeat}.ygtvtp{width:18px;height:22px;cursor:pointer;background:url(treeview-sprite.gif) 0 -6400px no-repeat}.ygtvtph,.ygtvtphh{width:18px;height:22px;cursor:pointer;background:url(treeview-sprite.gif) 0 -7200px no-repeat}.ygtvln{width:18px;height:22px;background:url(treeview-sprite.gif) 0 -1600px no-repeat;cursor:pointer}.ygtvlm{width:18px;height:22px;cursor:pointer;background:url(treeview-sprite.gif) 0 0 no-repeat}.ygtvlmh,.ygtvlmhh{width:18px;height:22px;cursor:pointer;background:url(treeview-sprite.gif) 0 -800px no-repeat}.ygtvlp{width:18px;height:22px;cursor:pointer;background:url(treeview-sprite.gif) 0 -2400px no-repeat}.ygtvlph,.ygtvlphh{width:18px;height:22px;cursor:pointer;background:url(treeview-sprite.gif) 0 -3200px no-repeat;cursor:pointer}.ygtvloading{width:18px;height:22px;background:url(treeview-loading.gif) 0 0 no-repeat}.ygtvdepthcell{width:18px;height:22px;background:url(treeview-sprite.gif) 0 -8000px no-repeat}.ygtvblankdepthcell{width:18px;height:22px}* html .ygtvchildren{height:2%}.ygtvlabel,.ygtvlabel:link,.ygtvlabel:visited,.ygtvlabel:hover{margin-left:2px;text-decoration:none;background-color:white;cursor:pointer}.ygtvcontent{cursor:default}.ygtvspacer{height:22px;width:18px}.ygtvfocus{background-color:#c0e0e0;border:0}.ygtvfocus .ygtvlabel,.ygtvfocus .ygtvlabel:link,.ygtvfocus .ygtvlabel:visited,.ygtvfocus .ygtvlabel:hover{background-color:#c0e0e0}.ygtvfocus a{outline-style:none}.ygtvok{width:18px;height:22px;background:url(treeview-sprite.gif) 0 -8800px no-repeat}.ygtvok:hover{background:url(treeview-sprite.gif) 0 -8844px no-repeat}.ygtvcancel{width:18px;height:22px;background:url(treeview-sprite.gif) 0 -8822px no-repeat}.ygtvcancel:hover{background:url(treeview-sprite.gif) 0 -8866px no-repeat}.ygtv-label-editor{background-color:#f2f2f2;border:1px solid silver;position:absolute;display:none;overflow:hidden;margin:auto;z-index:9000}.ygtv-edit-TextNode{width:190px}.ygtv-edit-TextNode .ygtvcancel,.ygtv-edit-TextNode .ygtvok{border:0}.ygtv-edit-TextNode .ygtv-button-container{float:right}.ygtv-edit-TextNode .ygtv-input input{width:140px}.ygtv-edit-DateNode .ygtvcancel{border:0}.ygtv-edit-DateNode .ygtvok{display:none}.ygtv-edit-DateNode .ygtv-button-container{text-align:right;margin:auto}.ygtv-highlight .ygtv-highlight1,.ygtv-highlight .ygtv-highlight1 .ygtvlabel{background-color:blue;color:white}.ygtv-highlight .ygtv-highlight2,.ygtv-highlight .ygtv-highlight2 .ygtvlabel{background-color:silver}.ygtv-highlight .ygtv-highlight0 .ygtvfocus .ygtvlabel,.ygtv-highlight .ygtv-highlight1 .ygtvfocus .ygtvlabel,.ygtv-highlight .ygtv-highlight2 .ygtvfocus .ygtvlabel{background-color:#c0e0e0}.ygtv-highlight .ygtvcontent{padding-right:1em}.ygtv-checkbox .ygtv-highlight0 .ygtvcontent{padding-left:1em;background:url(check0.gif) no-repeat}.ygtv-checkbox .ygtv-highlight0 .ygtvfocus.ygtvcontent,.ygtv-checkbox .ygtv-highlight1 .ygtvfocus.ygtvcontent,.ygtv-checkbox .ygtv-highlight2 .ygtvfocus.ygtvcontent{background-color:#c0e0e0}.ygtv-checkbox .ygtv-highlight1 .ygtvcontent{padding-left:1em;background:url(check1.gif) no-repeat}.ygtv-checkbox .ygtv-highlight2 .ygtvcontent{padding-left:1em;background:url(check2.gif) no-repeat}

diff --git a/js/yui/assets/skins/sam/wait.gif b/js/yui/assets/skins/sam/wait.gif
new file mode 100644 (file)
index 0000000..471c1a4
Binary files /dev/null and b/js/yui/assets/skins/sam/wait.gif differ

diff --git a/js/yui/assets/skins/sam/yuitest.css b/js/yui/assets/skins/sam/yuitest.css
new file mode 100644 (file)
index 0000000..7cfa36b
--- /dev/null
+++ b/js/yui/assets/skins/sam/yuitest.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+

diff --git a/js/yui/autocomplete/autocomplete-min.js b/js/yui/autocomplete/autocomplete-min.js
new file mode 100644 (file)
index 0000000..5a588b8
--- /dev/null
+++ b/js/yui/autocomplete/autocomplete-min.js
@@ -0,0 +1,12 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.widget.DS_JSArray=YAHOO.util.LocalDataSource;YAHOO.widget.DS_JSFunction=YAHOO.util.FunctionDataSource;YAHOO.widget.DS_XHR=function(b,a,d){var c=new YAHOO.util.XHRDataSource(b,d);c._aDeprecatedSchema=a;return c;};YAHOO.widget.DS_ScriptNode=function(b,a,d){var c=new YAHOO.util.ScriptNodeDataSource(b,d);c._aDeprecatedSchema=a;return c;};YAHOO.widget.DS_XHR.TYPE_JSON=YAHOO.util.DataSourceBase.TYPE_JSON;YAHOO.widget.DS_XHR.TYPE_XML=YAHOO.util.DataSourceBase.TYPE_XML;YAHOO.widget.DS_XHR.TYPE_FLAT=YAHOO.util.DataSourceBase.TYPE_TEXT;YAHOO.widget.AutoComplete=function(g,b,j,c){if(g&&b&&j){if(j&&YAHOO.lang.isFunction(j.sendRequest)){this.dataSource=j;}else{return;}this.key=0;var d=j.responseSchema;if(j._aDeprecatedSchema){var k=j._aDeprecatedSchema;if(YAHOO.lang.isArray(k)){if((j.responseType===YAHOO.util.DataSourceBase.TYPE_JSON)||(j.responseType===YAHOO.util.DataSourceBase.TYPE_UNKNOWN)){d.resultsList=k[0];this.key=k[1];d.fields=(k.length<3)?null:k.slice(1);}else{if(j.responseType===YAHOO.util.DataSourceBase.TYPE_XML){d.resultNode=k[0];this.key=k[1];d.fields=k.slice(1);}else{if(j.responseType===YAHOO.util.DataSourceBase.TYPE_TEXT){d.recordDelim=k[0];d.fieldDelim=k[1];}}}j.responseSchema=d;}}if(YAHOO.util.Dom.inDocument(g)){if(YAHOO.lang.isString(g)){this._sName="instance"+YAHOO.widget.AutoComplete._nIndex+" "+g;this._elTextbox=document.getElementById(g);}else{this._sName=(g.id)?"instance"+YAHOO.widget.AutoComplete._nIndex+" "+g.id:"instance"+YAHOO.widget.AutoComplete._nIndex;this._elTextbox=g;}YAHOO.util.Dom.addClass(this._elTextbox,"yui-ac-input");}else{return;}if(YAHOO.util.Dom.inDocument(b)){if(YAHOO.lang.isString(b)){this._elContainer=document.getElementById(b);}else{this._elContainer=b;}if(this._elContainer.style.display=="none"){}var e=this._elContainer.parentNode;var a=e.tagName.toLowerCase();if(a=="div"){YAHOO.util.Dom.addClass(e,"yui-ac");}else{}}else{return;}if(this.dataSource.dataType===YAHOO.util.DataSourceBase.TYPE_LOCAL){this.applyLocalFilter=true;}if(c&&(c.constructor==Object)){for(var i in c){if(i){this[i]=c[i];}}}this._initContainerEl();this._initProps();this._initListEl();this._initContainerHelperEls();var h=this;var f=this._elTextbox;YAHOO.util.Event.addListener(f,"keyup",h._onTextboxKeyUp,h);YAHOO.util.Event.addListener(f,"keydown",h._onTextboxKeyDown,h);YAHOO.util.Event.addListener(f,"focus",h._onTextboxFocus,h);YAHOO.util.Event.addListener(f,"blur",h._onTextboxBlur,h);YAHOO.util.Event.addListener(b,"mouseover",h._onContainerMouseover,h);YAHOO.util.Event.addListener(b,"mouseout",h._onContainerMouseout,h);YAHOO.util.Event.addListener(b,"click",h._onContainerClick,h);YAHOO.util.Event.addListener(b,"scroll",h._onContainerScroll,h);YAHOO.util.Event.addListener(b,"resize",h._onContainerResize,h);YAHOO.util.Event.addListener(f,"keypress",h._onTextboxKeyPress,h);YAHOO.util.Event.addListener(window,"unload",h._onWindowUnload,h);this.textboxFocusEvent=new YAHOO.util.CustomEvent("textboxFocus",this);this.textboxKeyEvent=new YAHOO.util.CustomEvent("textboxKey",this);this.dataRequestEvent=new YAHOO.util.CustomEvent("dataRequest",this);this.dataRequestCancelEvent=new YAHOO.util.CustomEvent("dataRequestCancel",this);this.dataReturnEvent=new YAHOO.util.CustomEvent("dataReturn",this);this.dataErrorEvent=new YAHOO.util.CustomEvent("dataError",this);this.containerPopulateEvent=new YAHOO.util.CustomEvent("containerPopulate",this);this.containerExpandEvent=new YAHOO.util.CustomEvent("containerExpand",this);this.typeAheadEvent=new YAHOO.util.CustomEvent("typeAhead",this);this.itemMouseOverEvent=new YAHOO.util.CustomEvent("itemMouseOver",this);this.itemMouseOutEvent=new YAHOO.util.CustomEvent("itemMouseOut",this);this.itemArrowToEvent=new YAHOO.util.CustomEvent("itemArrowTo",this);this.itemArrowFromEvent=new YAHOO.util.CustomEvent("itemArrowFrom",this);this.itemSelectEvent=new YAHOO.util.CustomEvent("itemSelect",this);this.unmatchedItemSelectEvent=new YAHOO.util.CustomEvent("unmatchedItemSelect",this);this.selectionEnforceEvent=new YAHOO.util.CustomEvent("selectionEnforce",this);this.containerCollapseEvent=new YAHOO.util.CustomEvent("containerCollapse",this);this.textboxBlurEvent=new YAHOO.util.CustomEvent("textboxBlur",this);this.textboxChangeEvent=new YAHOO.util.CustomEvent("textboxChange",this);f.setAttribute("autocomplete","off");YAHOO.widget.AutoComplete._nIndex++;}else{}};YAHOO.widget.AutoComplete.prototype.dataSource=null;YAHOO.widget.AutoComplete.prototype.applyLocalFilter=null;YAHOO.widget.AutoComplete.prototype.queryMatchCase=false;YAHOO.widget.AutoComplete.prototype.queryMatchContains=false;YAHOO.widget.AutoComplete.prototype.queryMatchSubset=false;YAHOO.widget.AutoComplete.prototype.minQueryLength=1;YAHOO.widget.AutoComplete.prototype.maxResultsDisplayed=10;YAHOO.widget.AutoComplete.prototype.queryDelay=0.2;YAHOO.widget.AutoComplete.prototype.typeAheadDelay=0.5;YAHOO.widget.AutoComplete.prototype.queryInterval=500;YAHOO.widget.AutoComplete.prototype.highlightClassName="yui-ac-highlight";YAHOO.widget.AutoComplete.prototype.prehighlightClassName=null;YAHOO.widget.AutoComplete.prototype.delimChar=null;YAHOO.widget.AutoComplete.prototype.autoHighlight=true;YAHOO.widget.AutoComplete.prototype.typeAhead=false;YAHOO.widget.AutoComplete.prototype.animHoriz=false;YAHOO.widget.AutoComplete.prototype.animVert=true;YAHOO.widget.AutoComplete.prototype.animSpeed=0.3;YAHOO.widget.AutoComplete.prototype.forceSelection=false;YAHOO.widget.AutoComplete.prototype.allowBrowserAutocomplete=true;YAHOO.widget.AutoComplete.prototype.alwaysShowContainer=false;YAHOO.widget.AutoComplete.prototype.useIFrame=false;YAHOO.widget.AutoComplete.prototype.useShadow=false;YAHOO.widget.AutoComplete.prototype.suppressInputUpdate=false;YAHOO.widget.AutoComplete.prototype.resultTypeList=true;YAHOO.widget.AutoComplete.prototype.queryQuestionMark=true;YAHOO.widget.AutoComplete.prototype.autoSnapContainer=true;YAHOO.widget.AutoComplete.prototype.toString=function(){return"AutoComplete "+this._sName;};YAHOO.widget.AutoComplete.prototype.getInputEl=function(){return this._elTextbox;
+};YAHOO.widget.AutoComplete.prototype.getContainerEl=function(){return this._elContainer;};YAHOO.widget.AutoComplete.prototype.isFocused=function(){return this._bFocused;};YAHOO.widget.AutoComplete.prototype.isContainerOpen=function(){return this._bContainerOpen;};YAHOO.widget.AutoComplete.prototype.getListEl=function(){return this._elList;};YAHOO.widget.AutoComplete.prototype.getListItemMatch=function(a){if(a._sResultMatch){return a._sResultMatch;}else{return null;}};YAHOO.widget.AutoComplete.prototype.getListItemData=function(a){if(a._oResultData){return a._oResultData;}else{return null;}};YAHOO.widget.AutoComplete.prototype.getListItemIndex=function(a){if(YAHOO.lang.isNumber(a._nItemIndex)){return a._nItemIndex;}else{return null;}};YAHOO.widget.AutoComplete.prototype.setHeader=function(b){if(this._elHeader){var a=this._elHeader;if(b){a.innerHTML=b;a.style.display="";}else{a.innerHTML="";a.style.display="none";}}};YAHOO.widget.AutoComplete.prototype.setFooter=function(b){if(this._elFooter){var a=this._elFooter;if(b){a.innerHTML=b;a.style.display="";}else{a.innerHTML="";a.style.display="none";}}};YAHOO.widget.AutoComplete.prototype.setBody=function(a){if(this._elBody){var b=this._elBody;YAHOO.util.Event.purgeElement(b,true);if(a){b.innerHTML=a;b.style.display="";}else{b.innerHTML="";b.style.display="none";}this._elList=null;}};YAHOO.widget.AutoComplete.prototype.generateRequest=function(b){var a=this.dataSource.dataType;if(a===YAHOO.util.DataSourceBase.TYPE_XHR){if(!this.dataSource.connMethodPost){b=(this.queryQuestionMark?"?":"")+(this.dataSource.scriptQueryParam||"query")+"="+b+(this.dataSource.scriptQueryAppend?("&"+this.dataSource.scriptQueryAppend):"");}else{b=(this.dataSource.scriptQueryParam||"query")+"="+b+(this.dataSource.scriptQueryAppend?("&"+this.dataSource.scriptQueryAppend):"");}}else{if(a===YAHOO.util.DataSourceBase.TYPE_SCRIPTNODE){b="&"+(this.dataSource.scriptQueryParam||"query")+"="+b+(this.dataSource.scriptQueryAppend?("&"+this.dataSource.scriptQueryAppend):"");}}return b;};YAHOO.widget.AutoComplete.prototype.sendQuery=function(b){this._bFocused=true;var a=(this.delimChar)?this._elTextbox.value+b:b;this._sendQuery(a);};YAHOO.widget.AutoComplete.prototype.snapContainer=function(){var a=this._elTextbox,b=YAHOO.util.Dom.getXY(a);b[1]+=YAHOO.util.Dom.get(a).offsetHeight+2;YAHOO.util.Dom.setXY(this._elContainer,b);};YAHOO.widget.AutoComplete.prototype.expandContainer=function(){this._toggleContainer(true);};YAHOO.widget.AutoComplete.prototype.collapseContainer=function(){this._toggleContainer(false);};YAHOO.widget.AutoComplete.prototype.clearList=function(){var b=this._elList.childNodes,a=b.length-1;for(;a>-1;a--){b[a].style.display="none";}};YAHOO.widget.AutoComplete.prototype.getSubsetMatches=function(e){var d,c,a;for(var b=e.length;b>=this.minQueryLength;b--){a=this.generateRequest(e.substr(0,b));this.dataRequestEvent.fire(this,d,a);c=this.dataSource.getCachedResponse(a);if(c){return this.filterResults.apply(this.dataSource,[e,c,c,{scope:this}]);}}return null;};YAHOO.widget.AutoComplete.prototype.preparseRawResponse=function(c,b,a){var d=((this.responseStripAfter!=="")&&(b.indexOf))?b.indexOf(this.responseStripAfter):-1;if(d!=-1){b=b.substring(0,d);}return b;};YAHOO.widget.AutoComplete.prototype.filterResults=function(l,n,r,m){if(m&&m.argument&&YAHOO.lang.isValue(m.argument.query)){l=m.argument.query;}if(l&&l!==""){r=YAHOO.widget.AutoComplete._cloneObject(r);var j=m.scope,q=this,c=r.results,o=[],b=j.maxResultsDisplayed,k=(q.queryMatchCase||j.queryMatchCase),a=(q.queryMatchContains||j.queryMatchContains);for(var d=0,h=c.length;d<h;d++){var f=c[d];var e=null;if(YAHOO.lang.isString(f)){e=f;}else{if(YAHOO.lang.isArray(f)){e=f[0];}else{if(this.responseSchema.fields){var p=this.responseSchema.fields[0].key||this.responseSchema.fields[0];e=f[p];}else{if(this.key){e=f[this.key];}}}}if(YAHOO.lang.isString(e)){var g=(k)?e.indexOf(decodeURIComponent(l)):e.toLowerCase().indexOf(decodeURIComponent(l).toLowerCase());if((!a&&(g===0))||(a&&(g>-1))){o.push(f);}}if(h>b&&o.length===b){break;}}r.results=o;}else{}return r;};YAHOO.widget.AutoComplete.prototype.handleResponse=function(c,a,b){if((this instanceof YAHOO.widget.AutoComplete)&&this._sName){this._populateList(c,a,b);}};YAHOO.widget.AutoComplete.prototype.doBeforeLoadData=function(c,a,b){return true;};YAHOO.widget.AutoComplete.prototype.formatResult=function(b,d,a){var c=(a)?a:"";return c;};YAHOO.widget.AutoComplete.prototype.formatEscapedResult=function(c,d,b){var a=(b)?b:"";return YAHOO.lang.escapeHTML(a);};YAHOO.widget.AutoComplete.prototype.doBeforeExpandContainer=function(d,a,c,b){return true;};YAHOO.widget.AutoComplete.prototype.destroy=function(){var b=this.toString();var a=this._elTextbox;var d=this._elContainer;this.textboxFocusEvent.unsubscribeAll();this.textboxKeyEvent.unsubscribeAll();this.dataRequestEvent.unsubscribeAll();this.dataReturnEvent.unsubscribeAll();this.dataErrorEvent.unsubscribeAll();this.containerPopulateEvent.unsubscribeAll();this.containerExpandEvent.unsubscribeAll();this.typeAheadEvent.unsubscribeAll();this.itemMouseOverEvent.unsubscribeAll();this.itemMouseOutEvent.unsubscribeAll();this.itemArrowToEvent.unsubscribeAll();this.itemArrowFromEvent.unsubscribeAll();this.itemSelectEvent.unsubscribeAll();this.unmatchedItemSelectEvent.unsubscribeAll();this.selectionEnforceEvent.unsubscribeAll();this.containerCollapseEvent.unsubscribeAll();this.textboxBlurEvent.unsubscribeAll();this.textboxChangeEvent.unsubscribeAll();YAHOO.util.Event.purgeElement(a,true);YAHOO.util.Event.purgeElement(d,true);d.innerHTML="";for(var c in this){if(YAHOO.lang.hasOwnProperty(this,c)){this[c]=null;}}};YAHOO.widget.AutoComplete.prototype.textboxFocusEvent=null;YAHOO.widget.AutoComplete.prototype.textboxKeyEvent=null;YAHOO.widget.AutoComplete.prototype.dataRequestEvent=null;YAHOO.widget.AutoComplete.prototype.dataRequestCancelEvent=null;YAHOO.widget.AutoComplete.prototype.dataReturnEvent=null;YAHOO.widget.AutoComplete.prototype.dataErrorEvent=null;
+YAHOO.widget.AutoComplete.prototype.containerPopulateEvent=null;YAHOO.widget.AutoComplete.prototype.containerExpandEvent=null;YAHOO.widget.AutoComplete.prototype.typeAheadEvent=null;YAHOO.widget.AutoComplete.prototype.itemMouseOverEvent=null;YAHOO.widget.AutoComplete.prototype.itemMouseOutEvent=null;YAHOO.widget.AutoComplete.prototype.itemArrowToEvent=null;YAHOO.widget.AutoComplete.prototype.itemArrowFromEvent=null;YAHOO.widget.AutoComplete.prototype.itemSelectEvent=null;YAHOO.widget.AutoComplete.prototype.unmatchedItemSelectEvent=null;YAHOO.widget.AutoComplete.prototype.selectionEnforceEvent=null;YAHOO.widget.AutoComplete.prototype.containerCollapseEvent=null;YAHOO.widget.AutoComplete.prototype.textboxBlurEvent=null;YAHOO.widget.AutoComplete.prototype.textboxChangeEvent=null;YAHOO.widget.AutoComplete._nIndex=0;YAHOO.widget.AutoComplete.prototype._sName=null;YAHOO.widget.AutoComplete.prototype._elTextbox=null;YAHOO.widget.AutoComplete.prototype._elContainer=null;YAHOO.widget.AutoComplete.prototype._elContent=null;YAHOO.widget.AutoComplete.prototype._elHeader=null;YAHOO.widget.AutoComplete.prototype._elBody=null;YAHOO.widget.AutoComplete.prototype._elFooter=null;YAHOO.widget.AutoComplete.prototype._elShadow=null;YAHOO.widget.AutoComplete.prototype._elIFrame=null;YAHOO.widget.AutoComplete.prototype._bFocused=false;YAHOO.widget.AutoComplete.prototype._oAnim=null;YAHOO.widget.AutoComplete.prototype._bContainerOpen=false;YAHOO.widget.AutoComplete.prototype._bOverContainer=false;YAHOO.widget.AutoComplete.prototype._elList=null;YAHOO.widget.AutoComplete.prototype._nDisplayedItems=0;YAHOO.widget.AutoComplete.prototype._sCurQuery=null;YAHOO.widget.AutoComplete.prototype._sPastSelections="";YAHOO.widget.AutoComplete.prototype._sInitInputValue=null;YAHOO.widget.AutoComplete.prototype._elCurListItem=null;YAHOO.widget.AutoComplete.prototype._elCurPrehighlightItem=null;YAHOO.widget.AutoComplete.prototype._bItemSelected=false;YAHOO.widget.AutoComplete.prototype._nKeyCode=null;YAHOO.widget.AutoComplete.prototype._nDelayID=-1;YAHOO.widget.AutoComplete.prototype._nTypeAheadDelayID=-1;YAHOO.widget.AutoComplete.prototype._iFrameSrc="javascript:false;";YAHOO.widget.AutoComplete.prototype._queryInterval=null;YAHOO.widget.AutoComplete.prototype._sLastTextboxValue=null;YAHOO.widget.AutoComplete.prototype._initProps=function(){var b=this.minQueryLength;if(!YAHOO.lang.isNumber(b)){this.minQueryLength=1;}var e=this.maxResultsDisplayed;if(!YAHOO.lang.isNumber(e)||(e<1)){this.maxResultsDisplayed=10;}var f=this.queryDelay;if(!YAHOO.lang.isNumber(f)||(f<0)){this.queryDelay=0.2;}var c=this.typeAheadDelay;if(!YAHOO.lang.isNumber(c)||(c<0)){this.typeAheadDelay=0.2;}var a=this.delimChar;if(YAHOO.lang.isString(a)&&(a.length>0)){this.delimChar=[a];}else{if(!YAHOO.lang.isArray(a)){this.delimChar=null;}}var d=this.animSpeed;if((this.animHoriz||this.animVert)&&YAHOO.util.Anim){if(!YAHOO.lang.isNumber(d)||(d<0)){this.animSpeed=0.3;}if(!this._oAnim){this._oAnim=new YAHOO.util.Anim(this._elContent,{},this.animSpeed);}else{this._oAnim.duration=this.animSpeed;}}if(this.forceSelection&&a){}};YAHOO.widget.AutoComplete.prototype._initContainerHelperEls=function(){if(this.useShadow&&!this._elShadow){var a=document.createElement("div");a.className="yui-ac-shadow";a.style.width=0;a.style.height=0;this._elShadow=this._elContainer.appendChild(a);}if(this.useIFrame&&!this._elIFrame){var b=document.createElement("iframe");b.src=this._iFrameSrc;b.frameBorder=0;b.scrolling="no";b.style.position="absolute";b.style.width=0;b.style.height=0;b.style.padding=0;b.tabIndex=-1;b.role="presentation";b.title="Presentational iframe shim";this._elIFrame=this._elContainer.appendChild(b);}};YAHOO.widget.AutoComplete.prototype._initContainerEl=function(){YAHOO.util.Dom.addClass(this._elContainer,"yui-ac-container");if(!this._elContent){var c=document.createElement("div");c.className="yui-ac-content";c.style.display="none";this._elContent=this._elContainer.appendChild(c);var b=document.createElement("div");b.className="yui-ac-hd";b.style.display="none";this._elHeader=this._elContent.appendChild(b);var d=document.createElement("div");d.className="yui-ac-bd";this._elBody=this._elContent.appendChild(d);var a=document.createElement("div");a.className="yui-ac-ft";a.style.display="none";this._elFooter=this._elContent.appendChild(a);}else{}};YAHOO.widget.AutoComplete.prototype._initListEl=function(){var c=this.maxResultsDisplayed,a=this._elList||document.createElement("ul"),b;while(a.childNodes.length<c){b=document.createElement("li");b.style.display="none";b._nItemIndex=a.childNodes.length;a.appendChild(b);}if(!this._elList){var d=this._elBody;YAHOO.util.Event.purgeElement(d,true);d.innerHTML="";this._elList=d.appendChild(a);}this._elBody.style.display="";};YAHOO.widget.AutoComplete.prototype._focus=function(){var a=this;setTimeout(function(){try{a._elTextbox.focus();}catch(b){}},0);};YAHOO.widget.AutoComplete.prototype._enableIntervalDetection=function(){var a=this;if(!a._queryInterval&&a.queryInterval){a._queryInterval=setInterval(function(){a._onInterval();},a.queryInterval);}};YAHOO.widget.AutoComplete.prototype.enableIntervalDetection=YAHOO.widget.AutoComplete.prototype._enableIntervalDetection;YAHOO.widget.AutoComplete.prototype._onInterval=function(){var a=this._elTextbox.value;var b=this._sLastTextboxValue;if(a!=b){this._sLastTextboxValue=a;this._sendQuery(a);}};YAHOO.widget.AutoComplete.prototype._clearInterval=function(){if(this._queryInterval){clearInterval(this._queryInterval);this._queryInterval=null;}};YAHOO.widget.AutoComplete.prototype._isIgnoreKey=function(a){if((a==9)||(a==13)||(a==16)||(a==17)||(a>=18&&a<=20)||(a==27)||(a>=33&&a<=35)||(a>=36&&a<=40)||(a>=44&&a<=45)||(a==229)){return true;}return false;};YAHOO.widget.AutoComplete.prototype._sendQuery=function(d){if(this.minQueryLength<0){this._toggleContainer(false);return;}if(this.delimChar){var a=this._extractQuery(d);d=a.query;this._sPastSelections=a.previous;}if((d&&(d.length<this.minQueryLength))||(!d&&this.minQueryLength>0)){if(this._nDelayID!=-1){clearTimeout(this._nDelayID);
+}this._toggleContainer(false);return;}d=encodeURIComponent(d);this._nDelayID=-1;if(this.dataSource.queryMatchSubset||this.queryMatchSubset){var c=this.getSubsetMatches(d);if(c){this.handleResponse(d,c,{query:d});return;}}if(this.dataSource.responseStripAfter){this.dataSource.doBeforeParseData=this.preparseRawResponse;}if(this.applyLocalFilter){this.dataSource.doBeforeCallback=this.filterResults;}var b=this.generateRequest(d);if(b!==undefined){this.dataRequestEvent.fire(this,d,b);this.dataSource.sendRequest(b,{success:this.handleResponse,failure:this.handleResponse,scope:this,argument:{query:d}});}else{this.dataRequestCancelEvent.fire(this,d);}};YAHOO.widget.AutoComplete.prototype._populateListItem=function(b,a,c){b.innerHTML=this.formatResult(a,c,b._sResultMatch);};YAHOO.widget.AutoComplete.prototype._populateList=function(n,f,c){if(this._nTypeAheadDelayID!=-1){clearTimeout(this._nTypeAheadDelayID);}n=(c&&c.query)?c.query:n;var h=this.doBeforeLoadData(n,f,c);if(h&&!f.error){this.dataReturnEvent.fire(this,n,f.results);if(this._bFocused){var p=decodeURIComponent(n);this._sCurQuery=p;this._bItemSelected=false;var u=f.results,a=Math.min(u.length,this.maxResultsDisplayed),m=(this.dataSource.responseSchema.fields)?(this.dataSource.responseSchema.fields[0].key||this.dataSource.responseSchema.fields[0]):0;if(a>0){if(!this._elList||(this._elList.childNodes.length<a)){this._initListEl();}this._initContainerHelperEls();var l=this._elList.childNodes;for(var t=a-1;t>=0;t--){var s=l[t],e=u[t];if(this.resultTypeList){var b=[];b[0]=(YAHOO.lang.isString(e))?e:e[m]||e[this.key];var o=this.dataSource.responseSchema.fields;if(YAHOO.lang.isArray(o)&&(o.length>1)){for(var q=1,v=o.length;q<v;q++){b[b.length]=e[o[q].key||o[q]];}}else{if(YAHOO.lang.isArray(e)){b=e;}else{if(YAHOO.lang.isString(e)){b=[e];}else{b[1]=e;}}}e=b;}s._sResultMatch=(YAHOO.lang.isString(e))?e:(YAHOO.lang.isArray(e))?e[0]:(e[m]||"");s._oResultData=e;this._populateListItem(s,e,p);s.style.display="";}if(a<l.length){var g;for(var r=l.length-1;r>=a;r--){g=l[r];g.style.display="none";}}this._nDisplayedItems=a;this.containerPopulateEvent.fire(this,n,u);if(this.autoHighlight){var d=this._elList.firstChild;this._toggleHighlight(d,"to");this.itemArrowToEvent.fire(this,d);this._typeAhead(d,n);}else{this._toggleHighlight(this._elCurListItem,"from");}h=this._doBeforeExpandContainer(this._elTextbox,this._elContainer,n,u);this._toggleContainer(h);}else{this._toggleContainer(false);}return;}}else{this.dataErrorEvent.fire(this,n,f);}};YAHOO.widget.AutoComplete.prototype._doBeforeExpandContainer=function(d,a,c,b){if(this.autoSnapContainer){this.snapContainer();}return this.doBeforeExpandContainer(d,a,c,b);};YAHOO.widget.AutoComplete.prototype._clearSelection=function(){var a=(this.delimChar)?this._extractQuery(this._elTextbox.value):{previous:"",query:this._elTextbox.value};this._elTextbox.value=a.previous;this.selectionEnforceEvent.fire(this,a.query);};YAHOO.widget.AutoComplete.prototype._textMatchesOption=function(){var a=null;for(var b=0;b<this._nDisplayedItems;b++){var c=this._elList.childNodes[b];var d=(""+c._sResultMatch).toLowerCase();if(d==this._sCurQuery.toLowerCase()){a=c;break;}}return(a);};YAHOO.widget.AutoComplete.prototype._typeAhead=function(b,d){if(!this.typeAhead||(this._nKeyCode==8)){return;}var a=this,c=this._elTextbox;if(c.setSelectionRange||c.createTextRange){this._nTypeAheadDelayID=setTimeout(function(){var f=c.value.length;a._updateValue(b);var g=c.value.length;a._selectText(c,f,g);var e=c.value.substr(f,g);a._sCurQuery=b._sResultMatch;a.typeAheadEvent.fire(a,d,e);},(this.typeAheadDelay*1000));}};YAHOO.widget.AutoComplete.prototype._selectText=function(d,a,b){if(d.setSelectionRange){d.setSelectionRange(a,b);}else{if(d.createTextRange){var c=d.createTextRange();c.moveStart("character",a);c.moveEnd("character",b-d.value.length);c.select();}else{d.select();}}};YAHOO.widget.AutoComplete.prototype._extractQuery=function(h){var c=this.delimChar,f=-1,g,e,b=c.length-1,d;for(;b>=0;b--){g=h.lastIndexOf(c[b]);if(g>f){f=g;}}if(c[b]==" "){for(var a=c.length-1;a>=0;a--){if(h[f-1]==c[a]){f--;break;}}}if(f>-1){e=f+1;while(h.charAt(e)==" "){e+=1;}d=h.substring(0,e);h=h.substr(e);}else{d="";}return{previous:d,query:h};};YAHOO.widget.AutoComplete.prototype._toggleContainerHelpers=function(d){var e=this._elContent.offsetWidth+"px";var b=this._elContent.offsetHeight+"px";if(this.useIFrame&&this._elIFrame){var c=this._elIFrame;if(d){c.style.width=e;c.style.height=b;c.style.padding="";}else{c.style.width=0;c.style.height=0;c.style.padding=0;}}if(this.useShadow&&this._elShadow){var a=this._elShadow;if(d){a.style.width=e;a.style.height=b;}else{a.style.width=0;a.style.height=0;}}};YAHOO.widget.AutoComplete.prototype._toggleContainer=function(i){var d=this._elContainer;if(this.alwaysShowContainer&&this._bContainerOpen){return;}if(!i){this._toggleHighlight(this._elCurListItem,"from");this._nDisplayedItems=0;this._sCurQuery=null;if(this._elContent.style.display=="none"){return;}}var a=this._oAnim;if(a&&a.getEl()&&(this.animHoriz||this.animVert)){if(a.isAnimated()){a.stop(true);}var g=this._elContent.cloneNode(true);d.appendChild(g);g.style.top="-9000px";g.style.width="";g.style.height="";g.style.display="";var f=g.offsetWidth;var c=g.offsetHeight;var b=(this.animHoriz)?0:f;var e=(this.animVert)?0:c;a.attributes=(i)?{width:{to:f},height:{to:c}}:{width:{to:b},height:{to:e}};if(i&&!this._bContainerOpen){this._elContent.style.width=b+"px";this._elContent.style.height=e+"px";}else{this._elContent.style.width=f+"px";this._elContent.style.height=c+"px";}d.removeChild(g);g=null;var h=this;var j=function(){a.onComplete.unsubscribeAll();if(i){h._toggleContainerHelpers(true);h._bContainerOpen=i;h.containerExpandEvent.fire(h);}else{h._elContent.style.display="none";h._bContainerOpen=i;h.containerCollapseEvent.fire(h);}};this._toggleContainerHelpers(false);this._elContent.style.display="";a.onComplete.subscribe(j);a.animate();}else{if(i){this._elContent.style.display="";this._toggleContainerHelpers(true);
+this._bContainerOpen=i;this.containerExpandEvent.fire(this);}else{this._toggleContainerHelpers(false);this._elContent.style.display="none";this._bContainerOpen=i;this.containerCollapseEvent.fire(this);}}};YAHOO.widget.AutoComplete.prototype._toggleHighlight=function(a,c){if(a){var b=this.highlightClassName;if(this._elCurListItem){YAHOO.util.Dom.removeClass(this._elCurListItem,b);this._elCurListItem=null;}if((c=="to")&&b){YAHOO.util.Dom.addClass(a,b);this._elCurListItem=a;}}};YAHOO.widget.AutoComplete.prototype._togglePrehighlight=function(b,c){var a=this.prehighlightClassName;if(this._elCurPrehighlightItem){YAHOO.util.Dom.removeClass(this._elCurPrehighlightItem,a);}if(b==this._elCurListItem){return;}if((c=="mouseover")&&a){YAHOO.util.Dom.addClass(b,a);this._elCurPrehighlightItem=b;}else{YAHOO.util.Dom.removeClass(b,a);}};YAHOO.widget.AutoComplete.prototype._updateValue=function(c){if(!this.suppressInputUpdate){var f=this._elTextbox;var e=(this.delimChar)?(this.delimChar[0]||this.delimChar):null;var b=c._sResultMatch;var d="";if(e){d=this._sPastSelections;d+=b+e;if(e!=" "){d+=" ";}}else{d=b;}f.value=d;if(f.type=="textarea"){f.scrollTop=f.scrollHeight;}var a=f.value.length;this._selectText(f,a,a);this._elCurListItem=c;}};YAHOO.widget.AutoComplete.prototype._selectItem=function(a){this._bItemSelected=true;this._updateValue(a);this._sPastSelections=this._elTextbox.value;this._clearInterval();this.itemSelectEvent.fire(this,a,a._oResultData);this._toggleContainer(false);};YAHOO.widget.AutoComplete.prototype._jumpSelection=function(){if(this._elCurListItem){this._selectItem(this._elCurListItem);}else{this._toggleContainer(false);}};YAHOO.widget.AutoComplete.prototype._moveSelection=function(g){if(this._bContainerOpen){var h=this._elCurListItem,d=-1;if(h){d=h._nItemIndex;}var e=(g==40)?(d+1):(d-1);if(e<-2||e>=this._nDisplayedItems){return;}if(h){this._toggleHighlight(h,"from");this.itemArrowFromEvent.fire(this,h);}if(e==-1){if(this.delimChar){this._elTextbox.value=this._sPastSelections+this._sCurQuery;}else{this._elTextbox.value=this._sCurQuery;}return;}if(e==-2){this._toggleContainer(false);return;}var f=this._elList.childNodes[e],b=this._elContent,c=YAHOO.util.Dom.getStyle(b,"overflow"),i=YAHOO.util.Dom.getStyle(b,"overflowY"),a=((c=="auto")||(c=="scroll")||(i=="auto")||(i=="scroll"));if(a&&(e>-1)&&(e<this._nDisplayedItems)){if(g==40){if((f.offsetTop+f.offsetHeight)>(b.scrollTop+b.offsetHeight)){b.scrollTop=(f.offsetTop+f.offsetHeight)-b.offsetHeight;}else{if((f.offsetTop+f.offsetHeight)<b.scrollTop){b.scrollTop=f.offsetTop;}}}else{if(f.offsetTop<b.scrollTop){this._elContent.scrollTop=f.offsetTop;}else{if(f.offsetTop>(b.scrollTop+b.offsetHeight)){this._elContent.scrollTop=(f.offsetTop+f.offsetHeight)-b.offsetHeight;}}}}this._toggleHighlight(f,"to");this.itemArrowToEvent.fire(this,f);if(this.typeAhead){this._updateValue(f);this._sCurQuery=f._sResultMatch;}}};YAHOO.widget.AutoComplete.prototype._onContainerMouseover=function(a,c){var d=YAHOO.util.Event.getTarget(a);var b=d.nodeName.toLowerCase();while(d&&(b!="table")){switch(b){case"body":return;case"li":if(c.prehighlightClassName){c._togglePrehighlight(d,"mouseover");}else{c._toggleHighlight(d,"to");}c.itemMouseOverEvent.fire(c,d);break;case"div":if(YAHOO.util.Dom.hasClass(d,"yui-ac-container")){c._bOverContainer=true;return;}break;default:break;}d=d.parentNode;if(d){b=d.nodeName.toLowerCase();}}};YAHOO.widget.AutoComplete.prototype._onContainerMouseout=function(a,c){var d=YAHOO.util.Event.getTarget(a);var b=d.nodeName.toLowerCase();while(d&&(b!="table")){switch(b){case"body":return;case"li":if(c.prehighlightClassName){c._togglePrehighlight(d,"mouseout");}else{c._toggleHighlight(d,"from");}c.itemMouseOutEvent.fire(c,d);break;case"ul":c._toggleHighlight(c._elCurListItem,"to");break;case"div":if(YAHOO.util.Dom.hasClass(d,"yui-ac-container")){c._bOverContainer=false;return;}break;default:break;}d=d.parentNode;if(d){b=d.nodeName.toLowerCase();}}};YAHOO.widget.AutoComplete.prototype._onContainerClick=function(a,c){var d=YAHOO.util.Event.getTarget(a);var b=d.nodeName.toLowerCase();while(d&&(b!="table")){switch(b){case"body":return;case"li":c._toggleHighlight(d,"to");c._selectItem(d);return;default:break;}d=d.parentNode;if(d){b=d.nodeName.toLowerCase();}}};YAHOO.widget.AutoComplete.prototype._onContainerScroll=function(a,b){b._focus();};YAHOO.widget.AutoComplete.prototype._onContainerResize=function(a,b){b._toggleContainerHelpers(b._bContainerOpen);};YAHOO.widget.AutoComplete.prototype._onTextboxKeyDown=function(a,b){var c=a.keyCode;if(b._nTypeAheadDelayID!=-1){clearTimeout(b._nTypeAheadDelayID);}switch(c){case 9:if(!YAHOO.env.ua.opera&&(navigator.userAgent.toLowerCase().indexOf("mac")==-1)||(YAHOO.env.ua.webkit>420)){if(b._elCurListItem){if(b.delimChar&&(b._nKeyCode!=c)){if(b._bContainerOpen){YAHOO.util.Event.stopEvent(a);}}b._selectItem(b._elCurListItem);}else{b._toggleContainer(false);}}break;case 13:if(!YAHOO.env.ua.opera&&(navigator.userAgent.toLowerCase().indexOf("mac")==-1)||(YAHOO.env.ua.webkit>420)){if(b._elCurListItem){if(b._nKeyCode!=c){if(b._bContainerOpen){YAHOO.util.Event.stopEvent(a);}}b._selectItem(b._elCurListItem);}else{b._toggleContainer(false);}}break;case 27:b._toggleContainer(false);return;case 39:b._jumpSelection();break;case 38:if(b._bContainerOpen){YAHOO.util.Event.stopEvent(a);b._moveSelection(c);}break;case 40:if(b._bContainerOpen){YAHOO.util.Event.stopEvent(a);b._moveSelection(c);}break;default:b._bItemSelected=false;b._toggleHighlight(b._elCurListItem,"from");b.textboxKeyEvent.fire(b,c);break;}if(c===18){b._enableIntervalDetection();}b._nKeyCode=c;};YAHOO.widget.AutoComplete.prototype._onTextboxKeyPress=function(a,b){var c=a.keyCode;if(YAHOO.env.ua.opera||(navigator.userAgent.toLowerCase().indexOf("mac")!=-1)&&(YAHOO.env.ua.webkit<420)){switch(c){case 9:if(b._bContainerOpen){if(b.delimChar){YAHOO.util.Event.stopEvent(a);}if(b._elCurListItem){b._selectItem(b._elCurListItem);}else{b._toggleContainer(false);}}break;case 13:if(b._bContainerOpen){YAHOO.util.Event.stopEvent(a);
+if(b._elCurListItem){b._selectItem(b._elCurListItem);}else{b._toggleContainer(false);}}break;default:break;}}else{if(c==229){b._enableIntervalDetection();}}};YAHOO.widget.AutoComplete.prototype._onTextboxKeyUp=function(a,c){var b=this.value;c._initProps();var d=a.keyCode;if(c._isIgnoreKey(d)){return;}if(c._nDelayID!=-1){clearTimeout(c._nDelayID);}c._nDelayID=setTimeout(function(){c._sendQuery(b);},(c.queryDelay*1000));};YAHOO.widget.AutoComplete.prototype._onTextboxFocus=function(a,b){if(!b._bFocused){b._elTextbox.setAttribute("autocomplete","off");b._bFocused=true;b._sInitInputValue=b._elTextbox.value;b.textboxFocusEvent.fire(b);}};YAHOO.widget.AutoComplete.prototype._onTextboxBlur=function(a,c){if(!c._bOverContainer||(c._nKeyCode==9)){if(!c._bItemSelected){var b=c._textMatchesOption();if(!c._bContainerOpen||(c._bContainerOpen&&(b===null))){if(c.forceSelection){c._clearSelection();}else{c.unmatchedItemSelectEvent.fire(c,c._sCurQuery);}}else{if(c.forceSelection){c._selectItem(b);}}}c._clearInterval();c._bFocused=false;if(c._sInitInputValue!==c._elTextbox.value){c.textboxChangeEvent.fire(c);}c.textboxBlurEvent.fire(c);c._toggleContainer(false);}else{c._focus();}};YAHOO.widget.AutoComplete.prototype._onWindowUnload=function(a,b){if(b&&b._elTextbox&&b.allowBrowserAutocomplete){b._elTextbox.setAttribute("autocomplete","on");}};YAHOO.widget.AutoComplete.prototype.doBeforeSendQuery=function(a){return this.generateRequest(a);};YAHOO.widget.AutoComplete.prototype.getListItems=function(){var c=[],b=this._elList.childNodes;for(var a=b.length-1;a>=0;a--){c[a]=b[a];}return c;};YAHOO.widget.AutoComplete._cloneObject=function(d){if(!YAHOO.lang.isValue(d)){return d;}var f={};if(YAHOO.lang.isFunction(d)){f=d;}else{if(YAHOO.lang.isArray(d)){var e=[];for(var c=0,b=d.length;c<b;c++){e[c]=YAHOO.widget.AutoComplete._cloneObject(d[c]);}f=e;}else{if(YAHOO.lang.isObject(d)){for(var a in d){if(YAHOO.lang.hasOwnProperty(d,a)){if(YAHOO.lang.isValue(d[a])&&YAHOO.lang.isObject(d[a])||YAHOO.lang.isArray(d[a])){f[a]=YAHOO.widget.AutoComplete._cloneObject(d[a]);}else{f[a]=d[a];}}}}else{f=d;}}}return f;};YAHOO.register("autocomplete",YAHOO.widget.AutoComplete,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/base/base-min.css b/js/yui/base/base-min.css
new file mode 100644 (file)
index 0000000..f71b9a5
--- /dev/null
+++ b/js/yui/base/base-min.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+body{margin:10px}h1{font-size:138.5%}h2{font-size:123.1%}h3{font-size:108%}h1,h2,h3{margin:1em 0}h1,h2,h3,h4,h5,h6,strong,dt{font-weight:bold}optgroup{font-weight:normal}abbr,acronym{border-bottom:1px dotted #000;cursor:help}em{font-style:italic}del{text-decoration:line-through}blockquote,ul,ol,dl{margin:1em}ol,ul,dl{margin-left:2em}ol{list-style:decimal outside}ul{list-style:disc outside}dl dd{margin-left:1em}th,td{border:1px solid #000;padding:.5em}th{font-weight:bold;text-align:center}caption{margin-bottom:.5em;text-align:center}sup{vertical-align:super}sub{vertical-align:sub}p,fieldset,table,pre{margin-bottom:1em}button,input[type="checkbox"],input[type="radio"],input[type="reset"],input[type="submit"]{padding:1px}img{-ms-interpolation-mode:bicubic}
\ No newline at end of file

diff --git a/js/yui/base/base.css b/js/yui/base/base.css
new file mode 100644 (file)
index 0000000..557c75e
--- /dev/null
+++ b/js/yui/base/base.css
@@ -0,0 +1,137 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+/**
+ * YUI Base
+ * @module base
+ * @namespace yui-
+ * @requires reset, fonts
+*/
+
+body {
+       /* For breathing room between content and viewport. */
+       margin:10px;
+}
+
+h1 {
+       /* 18px via YUI Fonts CSS foundation. */
+       font-size: 138.5%;
+}
+
+h2 {
+       /* 16px via YUI Fonts CSS foundation. */
+       font-size: 123.1%;
+}
+
+h3 {
+       /* 14px via YUI Fonts CSS foundation. */
+       font-size: 108%;
+}
+
+h1,h2,h3 {
+       /* Top & bottom margin based on font size. */
+       margin: 1em 0;
+}
+
+h1,h2,h3,h4,h5,h6,strong,dt {
+       /* Bringing boldness back to headers and the strong element. */
+       font-weight: bold;
+}
+optgroup {
+       font-weight:normal;
+}
+
+abbr,acronym {
+       /* Indicating to users that more info is available. */
+       border-bottom: 1px dotted #000;
+       cursor: help;
+}
+
+em {
+       /* Bringing italics back to the em element. */
+       font-style: italic;
+}
+
+del {
+       /* Striking deleted phrases. */
+       text-decoration: line-through;
+}
+
+blockquote,ul,ol,dl {
+       /* Giving blockquotes and lists room to breath. */
+       margin: 1em;
+}
+
+ol,ul,dl {
+       /* Bringing lists on to the page with breathing room. */
+       margin-left: 2em;
+}
+
+ol {
+       /* Giving OL's LIs generated numbers. */
+       list-style: decimal outside;
+}
+
+ul {
+       /* Giving UL's LIs generated disc markers. */
+       list-style: disc outside;
+}
+
+dl dd {
+       /* Giving DD default indent. */
+       margin-left: 1em;
+}
+
+th,td {
+       /* Borders and padding to make the table readable. */
+       border: 1px solid #000;
+       padding: .5em;
+}
+
+th {
+       /* Distinguishing table headers from data cells. */
+       font-weight: bold;
+       text-align: center;
+}
+
+caption {
+       /* Coordinated margin to match cell's padding. */
+       margin-bottom: .5em;
+       /* Centered so it doesn't blend in to other content. */
+       text-align: center;
+}
+
+sup {
+       /* to preserve line-height and selector appearance */
+       vertical-align: super;
+}
+
+sub {
+       /* to preserve line-height and selector appearance */
+       vertical-align: sub;
+}
+
+p,
+fieldset,
+table,
+pre {
+       /* So things don't run into each other. */
+       margin-bottom: 1em;
+}
+/* Opera requires 1px of padding to render with contemporary native chrome */
+button,
+input[type="checkbox"],
+input[type="radio"],
+input[type="reset"],
+input[type="submit"] {
+       padding:1px;
+}
+
+/* make IE scale images properly */
+/* see http://code.flickr.com/blog/2008/11/12/on-ui-quality-the-little-things-client-side-image-resizing/ */
+ img {
+    -ms-interpolation-mode:bicubic;
+}

diff --git a/js/yui/button/button-min.js b/js/yui/button/button-min.js
new file mode 100644 (file)
index 0000000..15411fc
--- /dev/null
+++ b/js/yui/button/button-min.js
@@ -0,0 +1,11 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){var G=YAHOO.util.Dom,M=YAHOO.util.Event,I=YAHOO.lang,L=YAHOO.env.ua,B=YAHOO.widget.Overlay,J=YAHOO.widget.Menu,D={},K=null,E=null,C=null;function F(O,N,R,P){var S,Q;if(I.isString(O)&&I.isString(N)){if(L.ie&&(L.ie<9)){Q='<input type="'+O+'" name="'+N+'"';if(P){Q+=" checked";}Q+=">";S=document.createElement(Q);S.value=R;}else{S=document.createElement("input");S.name=N;S.type=O;S.value=R;if(P){S.checked=true;}}}return S;}function H(O,V){var N=O.nodeName.toUpperCase(),S=(this.CLASS_NAME_PREFIX+this.CSS_CLASS_NAME),T=this,U,P,Q;function W(X){if(!(X in V)){U=O.getAttributeNode(X);if(U&&("value" in U)){V[X]=U.value;}}}function R(){W("type");if(V.type=="button"){V.type="push";}if(!("disabled" in V)){V.disabled=O.disabled;}W("name");W("value");W("title");}switch(N){case"A":V.type="link";W("href");W("target");break;case"INPUT":R();if(!("checked" in V)){V.checked=O.checked;}break;case"BUTTON":R();P=O.parentNode.parentNode;if(G.hasClass(P,S+"-checked")){V.checked=true;}if(G.hasClass(P,S+"-disabled")){V.disabled=true;}O.removeAttribute("value");O.setAttribute("type","button");break;}O.removeAttribute("id");O.removeAttribute("name");if(!("tabindex" in V)){V.tabindex=O.tabIndex;}if(!("label" in V)){Q=N=="INPUT"?O.value:O.innerHTML;if(Q&&Q.length>0){V.label=Q;}}}function A(P){var O=P.attributes,N=O.srcelement,R=N.nodeName.toUpperCase(),Q=this;if(R==this.NODE_NAME){P.element=N;P.id=N.id;G.getElementsBy(function(S){switch(S.nodeName.toUpperCase()){case"BUTTON":case"A":case"INPUT":H.call(Q,S,O);break;}},"*",N);}else{switch(R){case"BUTTON":case"A":case"INPUT":H.call(this,N,O);break;}}}YAHOO.widget.Button=function(R,O){if(!B&&YAHOO.widget.Overlay){B=YAHOO.widget.Overlay;}if(!J&&YAHOO.widget.Menu){J=YAHOO.widget.Menu;}var Q=YAHOO.widget.Button.superclass.constructor,P,N;if(arguments.length==1&&!I.isString(R)&&!R.nodeName){if(!R.id){R.id=G.generateId();}Q.call(this,(this.createButtonElement(R.type)),R);}else{P={element:null,attributes:(O||{})};if(I.isString(R)){N=G.get(R);if(N){if(!P.attributes.id){P.attributes.id=R;}P.attributes.srcelement=N;A.call(this,P);if(!P.element){P.element=this.createButtonElement(P.attributes.type);}Q.call(this,P.element,P.attributes);}}else{if(R.nodeName){if(!P.attributes.id){if(R.id){P.attributes.id=R.id;}else{P.attributes.id=G.generateId();}}P.attributes.srcelement=R;A.call(this,P);if(!P.element){P.element=this.createButtonElement(P.attributes.type);}Q.call(this,P.element,P.attributes);}}}};YAHOO.extend(YAHOO.widget.Button,YAHOO.util.Element,{_button:null,_menu:null,_hiddenFields:null,_onclickAttributeValue:null,_activationKeyPressed:false,_activationButtonPressed:false,_hasKeyEventHandlers:false,_hasMouseEventHandlers:false,_nOptionRegionX:0,CLASS_NAME_PREFIX:"yui-",NODE_NAME:"SPAN",CHECK_ACTIVATION_KEYS:[32],ACTIVATION_KEYS:[13,32],OPTION_AREA_WIDTH:20,CSS_CLASS_NAME:"button",_setType:function(N){if(N=="split"){this.on("option",this._onOption);}},_setLabel:function(O){this._button.innerHTML=O;var P,N=L.gecko;if(N&&N<1.9&&G.inDocument(this.get("element"))){P=(this.CLASS_NAME_PREFIX+this.CSS_CLASS_NAME);this.removeClass(P);I.later(0,this,this.addClass,P);}},_setTabIndex:function(N){this._button.tabIndex=N;},_setTitle:function(N){if(this.get("type")!="link"){this._button.title=N;}},_setDisabled:function(N){if(this.get("type")!="link"){if(N){if(this._menu){this._menu.hide();}if(this.hasFocus()){this.blur();}this._button.setAttribute("disabled","disabled");this.addStateCSSClasses("disabled");this.removeStateCSSClasses("hover");this.removeStateCSSClasses("active");this.removeStateCSSClasses("focus");}else{this._button.removeAttribute("disabled");this.removeStateCSSClasses("disabled");}}},_setHref:function(N){if(this.get("type")=="link"){this._button.href=N;}},_setTarget:function(N){if(this.get("type")=="link"){this._button.setAttribute("target",N);}},_setChecked:function(N){var O=this.get("type");if(O=="checkbox"||O=="radio"){if(N){this.addStateCSSClasses("checked");}else{this.removeStateCSSClasses("checked");}}},_setMenu:function(U){var P=this.get("lazyloadmenu"),R=this.get("element"),N,W=false,X,O,Q;function V(){X.render(R.parentNode);this.removeListener("appendTo",V);}function T(){X.cfg.queueProperty("container",R.parentNode);this.removeListener("appendTo",T);}function S(){var Y;if(X){G.addClass(X.element,this.get("menuclassname"));G.addClass(X.element,this.CLASS_NAME_PREFIX+this.get("type")+"-button-menu");X.showEvent.subscribe(this._onMenuShow,null,this);X.hideEvent.subscribe(this._onMenuHide,null,this);X.renderEvent.subscribe(this._onMenuRender,null,this);if(J&&X instanceof J){if(P){Y=this.get("container");if(Y){X.cfg.queueProperty("container",Y);}else{this.on("appendTo",T);}}X.cfg.queueProperty("clicktohide",false);X.keyDownEvent.subscribe(this._onMenuKeyDown,this,true);X.subscribe("click",this._onMenuClick,this,true);this.on("selectedMenuItemChange",this._onSelectedMenuItemChange);Q=X.srcElement;if(Q&&Q.nodeName.toUpperCase()=="SELECT"){Q.style.display="none";Q.parentNode.removeChild(Q);}}else{if(B&&X instanceof B){if(!K){K=new YAHOO.widget.OverlayManager();}K.register(X);}}this._menu=X;if(!W&&!P){if(G.inDocument(R)){X.render(R.parentNode);}else{this.on("appendTo",V);}}}}if(B){if(J){N=J.prototype.CSS_CLASS_NAME;}if(U&&J&&(U instanceof J)){X=U;W=true;S.call(this);}else{if(B&&U&&(U instanceof B)){X=U;W=true;X.cfg.queueProperty("visible",false);S.call(this);}else{if(J&&I.isArray(U)){X=new J(G.generateId(),{lazyload:P,itemdata:U});this._menu=X;this.on("appendTo",S);}else{if(I.isString(U)){O=G.get(U);if(O){if(J&&G.hasClass(O,N)||O.nodeName.toUpperCase()=="SELECT"){X=new J(U,{lazyload:P});S.call(this);}else{if(B){X=new B(U,{visible:false});S.call(this);}}}}else{if(U&&U.nodeName){if(J&&G.hasClass(U,N)||U.nodeName.toUpperCase()=="SELECT"){X=new J(U,{lazyload:P});S.call(this);}else{if(B){if(!U.id){G.generateId(U);}X=new B(U,{visible:false});S.call(this);}}}}}}}}},_setOnClick:function(N){if(this._onclickAttributeValue&&(this._onclickAttributeValue!=N)){this.removeListener("click",this._onclickAttributeValue.fn);
+this._onclickAttributeValue=null;}if(!this._onclickAttributeValue&&I.isObject(N)&&I.isFunction(N.fn)){this.on("click",N.fn,N.obj,N.scope);this._onclickAttributeValue=N;}},_isActivationKey:function(N){var S=this.get("type"),O=(S=="checkbox"||S=="radio")?this.CHECK_ACTIVATION_KEYS:this.ACTIVATION_KEYS,Q=O.length,R=false,P;if(Q>0){P=Q-1;do{if(N==O[P]){R=true;break;}}while(P--);}return R;},_isSplitButtonOptionKey:function(P){var O=(M.getCharCode(P)==40);var N=function(Q){M.preventDefault(Q);this.removeListener("keypress",N);};if(O){if(L.opera){this.on("keypress",N);}M.preventDefault(P);}return O;},_addListenersToForm:function(){var T=this.getForm(),S=YAHOO.widget.Button.onFormKeyPress,R,N,Q,P,O;if(T){M.on(T,"reset",this._onFormReset,null,this);M.on(T,"submit",this._onFormSubmit,null,this);N=this.get("srcelement");if(this.get("type")=="submit"||(N&&N.type=="submit")){Q=M.getListeners(T,"keypress");R=false;if(Q){P=Q.length;if(P>0){O=P-1;do{if(Q[O].fn==S){R=true;break;}}while(O--);}}if(!R){M.on(T,"keypress",S);}}}},_showMenu:function(R){if(YAHOO.widget.MenuManager){YAHOO.widget.MenuManager.hideVisible();}if(K){K.hideAll();}var N=this._menu,Q=this.get("menualignment"),P=this.get("focusmenu"),O;if(this._renderedMenu){N.cfg.setProperty("context",[this.get("element"),Q[0],Q[1]]);N.cfg.setProperty("preventcontextoverlap",true);N.cfg.setProperty("constraintoviewport",true);}else{N.cfg.queueProperty("context",[this.get("element"),Q[0],Q[1]]);N.cfg.queueProperty("preventcontextoverlap",true);N.cfg.queueProperty("constraintoviewport",true);}this.focus();if(J&&N&&(N instanceof J)){O=N.focus;N.focus=function(){};if(this._renderedMenu){N.cfg.setProperty("minscrollheight",this.get("menuminscrollheight"));N.cfg.setProperty("maxheight",this.get("menumaxheight"));}else{N.cfg.queueProperty("minscrollheight",this.get("menuminscrollheight"));N.cfg.queueProperty("maxheight",this.get("menumaxheight"));}N.show();N.focus=O;N.align();if(R.type=="mousedown"){M.stopPropagation(R);}if(P){N.focus();}}else{if(B&&N&&(N instanceof B)){if(!this._renderedMenu){N.render(this.get("element").parentNode);}N.show();N.align();}}},_hideMenu:function(){var N=this._menu;if(N){N.hide();}},_onMouseOver:function(O){var Q=this.get("type"),N,P;if(Q==="split"){N=this.get("element");P=(G.getX(N)+(N.offsetWidth-this.OPTION_AREA_WIDTH));this._nOptionRegionX=P;}if(!this._hasMouseEventHandlers){if(Q==="split"){this.on("mousemove",this._onMouseMove);}this.on("mouseout",this._onMouseOut);this._hasMouseEventHandlers=true;}this.addStateCSSClasses("hover");if(Q==="split"&&(M.getPageX(O)>P)){this.addStateCSSClasses("hoveroption");}if(this._activationButtonPressed){this.addStateCSSClasses("active");}if(this._bOptionPressed){this.addStateCSSClasses("activeoption");}if(this._activationButtonPressed||this._bOptionPressed){M.removeListener(document,"mouseup",this._onDocumentMouseUp);}},_onMouseMove:function(N){var O=this._nOptionRegionX;if(O){if(M.getPageX(N)>O){this.addStateCSSClasses("hoveroption");}else{this.removeStateCSSClasses("hoveroption");}}},_onMouseOut:function(N){var O=this.get("type");this.removeStateCSSClasses("hover");if(O!="menu"){this.removeStateCSSClasses("active");}if(this._activationButtonPressed||this._bOptionPressed){M.on(document,"mouseup",this._onDocumentMouseUp,null,this);}if(O==="split"&&(M.getPageX(N)>this._nOptionRegionX)){this.removeStateCSSClasses("hoveroption");}},_onDocumentMouseUp:function(P){this._activationButtonPressed=false;this._bOptionPressed=false;var Q=this.get("type"),N,O;if(Q=="menu"||Q=="split"){N=M.getTarget(P);O=this._menu.element;if(N!=O&&!G.isAncestor(O,N)){this.removeStateCSSClasses((Q=="menu"?"active":"activeoption"));this._hideMenu();}}M.removeListener(document,"mouseup",this._onDocumentMouseUp);},_onMouseDown:function(P){var Q,O=true;function N(){this._hideMenu();this.removeListener("mouseup",N);}if((P.which||P.button)==1){if(!this.hasFocus()){I.later(0,this,this.focus);}Q=this.get("type");if(Q=="split"){if(M.getPageX(P)>this._nOptionRegionX){this.fireEvent("option",P);O=false;}else{this.addStateCSSClasses("active");this._activationButtonPressed=true;}}else{if(Q=="menu"){if(this.isActive()){this._hideMenu();this._activationButtonPressed=false;}else{this._showMenu(P);this._activationButtonPressed=true;}}else{this.addStateCSSClasses("active");this._activationButtonPressed=true;}}if(Q=="split"||Q=="menu"){this._hideMenuTimer=I.later(250,this,this.on,["mouseup",N]);}}return O;},_onMouseUp:function(P){this.inMouseDown=false;var Q=this.get("type"),N=this._hideMenuTimer,O=true;if(N){N.cancel();}if(Q=="checkbox"||Q=="radio"){if((P.which||P.button)!=1){return;}this.set("checked",!(this.get("checked")));}this._activationButtonPressed=false;if(Q!="menu"){this.removeStateCSSClasses("active");}if(Q=="split"&&M.getPageX(P)>this._nOptionRegionX){O=false;}return O;},_onFocus:function(O){var N;this.addStateCSSClasses("focus");if(this._activationKeyPressed){this.addStateCSSClasses("active");}C=this;if(!this._hasKeyEventHandlers){N=this._button;M.on(N,"blur",this._onBlur,null,this);M.on(N,"keydown",this._onKeyDown,null,this);M.on(N,"keyup",this._onKeyUp,null,this);this._hasKeyEventHandlers=true;}this.fireEvent("focus",O);},_onBlur:function(N){this.removeStateCSSClasses("focus");if(this.get("type")!="menu"){this.removeStateCSSClasses("active");}if(this._activationKeyPressed){M.on(document,"keyup",this._onDocumentKeyUp,null,this);}C=null;this.fireEvent("blur",N);},_onDocumentKeyUp:function(N){if(this._isActivationKey(M.getCharCode(N))){this._activationKeyPressed=false;M.removeListener(document,"keyup",this._onDocumentKeyUp);}},_onKeyDown:function(O){var N=this._menu;if(this.get("type")=="split"&&this._isSplitButtonOptionKey(O)){this.fireEvent("option",O);}else{if(this._isActivationKey(M.getCharCode(O))){if(this.get("type")=="menu"){this._showMenu(O);}else{this._activationKeyPressed=true;this.addStateCSSClasses("active");}}}if(N&&N.cfg.getProperty("visible")&&M.getCharCode(O)==27){N.hide();this.focus();}},_onKeyUp:function(N){var O;
+if(this._isActivationKey(M.getCharCode(N))){O=this.get("type");if(O=="checkbox"||O=="radio"){this.set("checked",!(this.get("checked")));}this._activationKeyPressed=false;if(this.get("type")!="menu"){this.removeStateCSSClasses("active");}}},_onClick:function(P){var R=this.get("type"),Q,N,O;switch(R){case"submit":if(P.returnValue!==false){this.submitForm();}break;case"reset":Q=this.getForm();if(Q){Q.reset();}break;case"split":if(this._nOptionRegionX>0&&(M.getPageX(P)>this._nOptionRegionX)){O=false;}else{this._hideMenu();N=this.get("srcelement");if(N&&N.type=="submit"&&P.returnValue!==false){this.submitForm();}}break;}return O;},_onDblClick:function(O){var N=true;if(this.get("type")=="split"&&M.getPageX(O)>this._nOptionRegionX){N=false;}return N;},_onAppendTo:function(N){I.later(0,this,this._addListenersToForm);},_onFormReset:function(O){var P=this.get("type"),N=this._menu;if(P=="checkbox"||P=="radio"){this.resetValue("checked");}if(J&&N&&(N instanceof J)){this.resetValue("selectedMenuItem");}},_onFormSubmit:function(N){this.createHiddenFields();},_onDocumentMouseDown:function(R){var O=M.getTarget(R),Q=this.get("element"),P=this._menu.element;function N(T){var V,S,U;if(!T){return true;}for(V=0,S=T.length;V<S;V++){U=T[V].element;if(O==U||G.isAncestor(U,O)){return true;}if(T[V]&&T[V].getSubmenus){if(N(T[V].getSubmenus())){return true;}}}return false;}if(O!=Q&&!G.isAncestor(Q,O)&&O!=P&&!G.isAncestor(P,O)){if(this._menu&&this._menu.getSubmenus){if(!N(this._menu.getSubmenus())){return;}}this._hideMenu();if(L.ie&&(L.ie<9)&&O.focus){O.setActive();}M.removeListener(document,"mousedown",this._onDocumentMouseDown);}},_onOption:function(N){if(this.hasClass(this.CLASS_NAME_PREFIX+"split-button-activeoption")){this._hideMenu();this._bOptionPressed=false;}else{this._showMenu(N);this._bOptionPressed=true;}},_onMenuShow:function(N){M.on(document,"mousedown",this._onDocumentMouseDown,null,this);var O=(this.get("type")=="split")?"activeoption":"active";this.addStateCSSClasses(O);},_onMenuHide:function(N){var O=(this.get("type")=="split")?"activeoption":"active";this.removeStateCSSClasses(O);if(this.get("type")=="split"){this._bOptionPressed=false;}},_onMenuKeyDown:function(P,O){var N=O[0];if(M.getCharCode(N)==27){this.focus();if(this.get("type")=="split"){this._bOptionPressed=false;}}},_onMenuRender:function(P){var S=this.get("element"),O=S.parentNode,N=this._menu,R=N.element,Q=N.srcElement,T;if(O!=R.parentNode){O.appendChild(R);}this._renderedMenu=true;if(Q&&Q.nodeName.toLowerCase()==="select"&&Q.value){T=N.getItem(Q.selectedIndex);this.set("selectedMenuItem",T,true);this._onSelectedMenuItemChange({newValue:T});}},_onMenuClick:function(O,N){var Q=N[1],P;if(Q){this.set("selectedMenuItem",Q);P=this.get("srcelement");if(P&&P.type=="submit"){this.submitForm();}this._hideMenu();}},_onSelectedMenuItemChange:function(O){var P=O.prevValue,Q=O.newValue,N=this.CLASS_NAME_PREFIX;if(P){G.removeClass(P.element,(N+"button-selectedmenuitem"));}if(Q){G.addClass(Q.element,(N+"button-selectedmenuitem"));}},_onLabelClick:function(N){this.focus();var O=this.get("type");if(O=="radio"||O=="checkbox"){this.set("checked",(!this.get("checked")));}},createButtonElement:function(N){var P=this.NODE_NAME,O=document.createElement(P);O.innerHTML="<"+P+' class="first-child">'+(N=="link"?"<a></a>":'<button type="button"></button>')+"</"+P+">";return O;},addStateCSSClasses:function(O){var P=this.get("type"),N=this.CLASS_NAME_PREFIX;if(I.isString(O)){if(O!="activeoption"&&O!="hoveroption"){this.addClass(N+this.CSS_CLASS_NAME+("-"+O));}this.addClass(N+P+("-button-"+O));}},removeStateCSSClasses:function(O){var P=this.get("type"),N=this.CLASS_NAME_PREFIX;if(I.isString(O)){this.removeClass(N+this.CSS_CLASS_NAME+("-"+O));this.removeClass(N+P+("-button-"+O));}},createHiddenFields:function(){this.removeHiddenFields();var V=this.getForm(),Z,O,S,X,Y,T,U,N,R,W,P,Q=false;if(V&&!this.get("disabled")){O=this.get("type");S=(O=="checkbox"||O=="radio");if((S&&this.get("checked"))||(E==this)){Z=F((S?O:"hidden"),this.get("name"),this.get("value"),this.get("checked"));if(Z){if(S){Z.style.display="none";}V.appendChild(Z);}}X=this._menu;if(J&&X&&(X instanceof J)){Y=this.get("selectedMenuItem");P=X.srcElement;Q=(P&&P.nodeName.toUpperCase()=="SELECT");if(Y){U=(Y.value===null||Y.value==="")?Y.cfg.getProperty("text"):Y.value;T=this.get("name");if(Q){W=P.name;}else{if(T){W=(T+"_options");}}if(U&&W){N=F("hidden",W,U);V.appendChild(N);}}else{if(Q){N=V.appendChild(P);}}}if(Z&&N){this._hiddenFields=[Z,N];}else{if(!Z&&N){this._hiddenFields=N;}else{if(Z&&!N){this._hiddenFields=Z;}}}R=this._hiddenFields;}return R;},removeHiddenFields:function(){var Q=this._hiddenFields,O,P;function N(R){if(G.inDocument(R)){R.parentNode.removeChild(R);}}if(Q){if(I.isArray(Q)){O=Q.length;if(O>0){P=O-1;do{N(Q[P]);}while(P--);}}else{N(Q);}this._hiddenFields=null;}},submitForm:function(){var Q=this.getForm(),P=this.get("srcelement"),O=false,N;if(Q){if(this.get("type")=="submit"||(P&&P.type=="submit")){E=this;}if(L.ie&&(L.ie<9)){O=Q.fireEvent("onsubmit");}else{N=document.createEvent("HTMLEvents");N.initEvent("submit",true,true);O=Q.dispatchEvent(N);}if((L.ie||L.webkit)&&O){Q.submit();}}return O;},init:function(P,d){var V=d.type=="link"?"a":"button",a=d.srcelement,S=P.getElementsByTagName(V)[0],U;if(!S){U=P.getElementsByTagName("input")[0];if(U){S=document.createElement("button");S.setAttribute("type","button");U.parentNode.replaceChild(S,U);}}this._button=S;YAHOO.widget.Button.superclass.init.call(this,P,d);var T=this.get("id"),Z=T+"-button";S.id=Z;var X,Q;var e=function(f){return(f.htmlFor===T);};var c=function(){Q.setAttribute((L.ie?"htmlFor":"for"),Z);};if(a&&this.get("type")!="link"){X=G.getElementsBy(e,"label");if(I.isArray(X)&&X.length>0){Q=X[0];}}D[T]=this;var b=this.CLASS_NAME_PREFIX;this.addClass(b+this.CSS_CLASS_NAME);this.addClass(b+this.get("type")+"-button");M.on(this._button,"focus",this._onFocus,null,this);this.on("mouseover",this._onMouseOver);this.on("mousedown",this._onMouseDown);
+this.on("mouseup",this._onMouseUp);this.on("click",this._onClick);var R=this.get("onclick");this.set("onclick",null);this.set("onclick",R);this.on("dblclick",this._onDblClick);var O;if(Q){if(this.get("replaceLabel")){this.set("label",Q.innerHTML);O=Q.parentNode;O.removeChild(Q);}else{this.on("appendTo",c);M.on(Q,"click",this._onLabelClick,null,this);this._label=Q;}}this.on("appendTo",this._onAppendTo);var N=this.get("container"),Y=this.get("element"),W=G.inDocument(Y);if(N){if(a&&a!=Y){O=a.parentNode;if(O){O.removeChild(a);}}if(I.isString(N)){M.onContentReady(N,this.appendTo,N,this);}else{this.on("init",function(){I.later(0,this,this.appendTo,N);});}}else{if(!W&&a&&a!=Y){O=a.parentNode;if(O){this.fireEvent("beforeAppendTo",{type:"beforeAppendTo",target:O});O.replaceChild(Y,a);this.fireEvent("appendTo",{type:"appendTo",target:O});}}else{if(this.get("type")!="link"&&W&&a&&a==Y){this._addListenersToForm();}}}this.fireEvent("init",{type:"init",target:this});},initAttributes:function(O){var N=O||{};YAHOO.widget.Button.superclass.initAttributes.call(this,N);this.setAttributeConfig("type",{value:(N.type||"push"),validator:I.isString,writeOnce:true,method:this._setType});this.setAttributeConfig("label",{value:N.label,validator:I.isString,method:this._setLabel});this.setAttributeConfig("value",{value:N.value});this.setAttributeConfig("name",{value:N.name,validator:I.isString});this.setAttributeConfig("tabindex",{value:N.tabindex,validator:I.isNumber,method:this._setTabIndex});this.configureAttribute("title",{value:N.title,validator:I.isString,method:this._setTitle});this.setAttributeConfig("disabled",{value:(N.disabled||false),validator:I.isBoolean,method:this._setDisabled});this.setAttributeConfig("href",{value:N.href,validator:I.isString,method:this._setHref});this.setAttributeConfig("target",{value:N.target,validator:I.isString,method:this._setTarget});this.setAttributeConfig("checked",{value:(N.checked||false),validator:I.isBoolean,method:this._setChecked});this.setAttributeConfig("container",{value:N.container,writeOnce:true});this.setAttributeConfig("srcelement",{value:N.srcelement,writeOnce:true});this.setAttributeConfig("menu",{value:null,method:this._setMenu,writeOnce:true});this.setAttributeConfig("lazyloadmenu",{value:(N.lazyloadmenu===false?false:true),validator:I.isBoolean,writeOnce:true});this.setAttributeConfig("menuclassname",{value:(N.menuclassname||(this.CLASS_NAME_PREFIX+"button-menu")),validator:I.isString,method:this._setMenuClassName,writeOnce:true});this.setAttributeConfig("menuminscrollheight",{value:(N.menuminscrollheight||90),validator:I.isNumber});this.setAttributeConfig("menumaxheight",{value:(N.menumaxheight||0),validator:I.isNumber});this.setAttributeConfig("menualignment",{value:(N.menualignment||["tl","bl"]),validator:I.isArray});this.setAttributeConfig("selectedMenuItem",{value:null});this.setAttributeConfig("onclick",{value:N.onclick,method:this._setOnClick});this.setAttributeConfig("focusmenu",{value:(N.focusmenu===false?false:true),validator:I.isBoolean});this.setAttributeConfig("replaceLabel",{value:false,validator:I.isBoolean,writeOnce:true});},focus:function(){if(!this.get("disabled")){try{this._button.focus();}catch(N){}}},blur:function(){if(!this.get("disabled")){try{this._button.blur();}catch(N){}}},hasFocus:function(){return(C==this);},isActive:function(){return this.hasClass(this.CLASS_NAME_PREFIX+this.CSS_CLASS_NAME+"-active");},getMenu:function(){return this._menu;},getForm:function(){var N=this._button,O;if(N){O=N.form;}return O;},getHiddenFields:function(){return this._hiddenFields;},destroy:function(){var P=this.get("element"),N=this._menu,T=this._label,O,S;if(N){if(K&&K.find(N)){K.remove(N);}N.destroy();}M.purgeElement(P);M.purgeElement(this._button);M.removeListener(document,"mouseup",this._onDocumentMouseUp);M.removeListener(document,"keyup",this._onDocumentKeyUp);M.removeListener(document,"mousedown",this._onDocumentMouseDown);if(T){M.removeListener(T,"click",this._onLabelClick);O=T.parentNode;O.removeChild(T);}var Q=this.getForm();if(Q){M.removeListener(Q,"reset",this._onFormReset);M.removeListener(Q,"submit",this._onFormSubmit);}this.unsubscribeAll();O=P.parentNode;if(O){O.removeChild(P);}delete D[this.get("id")];var R=(this.CLASS_NAME_PREFIX+this.CSS_CLASS_NAME);S=G.getElementsByClassName(R,this.NODE_NAME,Q);if(I.isArray(S)&&S.length===0){M.removeListener(Q,"keypress",YAHOO.widget.Button.onFormKeyPress);}},fireEvent:function(O,N){var P=arguments[0];if(this.DOM_EVENTS[P]&&this.get("disabled")){return false;}return YAHOO.widget.Button.superclass.fireEvent.apply(this,arguments);},toString:function(){return("Button "+this.get("id"));}});YAHOO.widget.Button.onFormKeyPress=function(R){var P=M.getTarget(R),S=M.getCharCode(R),Q=P.nodeName&&P.nodeName.toUpperCase(),N=P.type,T=false,V,X,O,W;function U(a){var Z,Y;switch(a.nodeName.toUpperCase()){case"INPUT":case"BUTTON":if(a.type=="submit"&&!a.disabled){if(!T&&!O){O=a;}}break;default:Z=a.id;if(Z){V=D[Z];if(V){T=true;if(!V.get("disabled")){Y=V.get("srcelement");if(!X&&(V.get("type")=="submit"||(Y&&Y.type=="submit"))){X=V;}}}}break;}}if(S==13&&((Q=="INPUT"&&(N=="text"||N=="password"||N=="checkbox"||N=="radio"||N=="file"))||Q=="SELECT")){G.getElementsBy(U,"*",this);if(O){O.focus();}else{if(!O&&X){M.preventDefault(R);if(L.ie){X.get("element").fireEvent("onclick");}else{W=document.createEvent("HTMLEvents");W.initEvent("click",true,true);if(L.gecko<1.9){X.fireEvent("click",W);}else{X.get("element").dispatchEvent(W);}}}}}};YAHOO.widget.Button.addHiddenFieldsToForm=function(N){var R=YAHOO.widget.Button.prototype,T=G.getElementsByClassName((R.CLASS_NAME_PREFIX+R.CSS_CLASS_NAME),"*",N),Q=T.length,S,O,P;if(Q>0){for(P=0;P<Q;P++){O=T[P].id;if(O){S=D[O];if(S){S.createHiddenFields();}}}}};YAHOO.widget.Button.getButton=function(N){return D[N];};})();(function(){var C=YAHOO.util.Dom,B=YAHOO.util.Event,D=YAHOO.lang,A=YAHOO.widget.Button,E={};YAHOO.widget.ButtonGroup=function(J,H){var I=YAHOO.widget.ButtonGroup.superclass.constructor,K,G,F;
+if(arguments.length==1&&!D.isString(J)&&!J.nodeName){if(!J.id){F=C.generateId();J.id=F;}I.call(this,(this._createGroupElement()),J);}else{if(D.isString(J)){G=C.get(J);if(G){if(G.nodeName.toUpperCase()==this.NODE_NAME){I.call(this,G,H);}}}else{K=J.nodeName.toUpperCase();if(K&&K==this.NODE_NAME){if(!J.id){J.id=C.generateId();}I.call(this,J,H);}}}};YAHOO.extend(YAHOO.widget.ButtonGroup,YAHOO.util.Element,{_buttons:null,NODE_NAME:"DIV",CLASS_NAME_PREFIX:"yui-",CSS_CLASS_NAME:"buttongroup",_createGroupElement:function(){var F=document.createElement(this.NODE_NAME);return F;},_setDisabled:function(G){var H=this.getCount(),F;if(H>0){F=H-1;do{this._buttons[F].set("disabled",G);}while(F--);}},_onKeyDown:function(K){var G=B.getTarget(K),I=B.getCharCode(K),H=G.parentNode.parentNode.id,J=E[H],F=-1;if(I==37||I==38){F=(J.index===0)?(this._buttons.length-1):(J.index-1);}else{if(I==39||I==40){F=(J.index===(this._buttons.length-1))?0:(J.index+1);}}if(F>-1){this.check(F);this.getButton(F).focus();}},_onAppendTo:function(H){var I=this._buttons,G=I.length,F;for(F=0;F<G;F++){I[F].appendTo(this.get("element"));}},_onButtonCheckedChange:function(G,F){var I=G.newValue,H=this.get("checkedButton");if(I&&H!=F){if(H){H.set("checked",false,true);}this.set("checkedButton",F);this.set("value",F.get("value"));}else{if(H&&!H.set("checked")){H.set("checked",true,true);}}},init:function(I,H){this._buttons=[];YAHOO.widget.ButtonGroup.superclass.init.call(this,I,H);this.addClass(this.CLASS_NAME_PREFIX+this.CSS_CLASS_NAME);var K=(YAHOO.widget.Button.prototype.CLASS_NAME_PREFIX+"radio-button"),J=this.getElementsByClassName(K);if(J.length>0){this.addButtons(J);}function F(L){return(L.type=="radio");}J=C.getElementsBy(F,"input",this.get("element"));if(J.length>0){this.addButtons(J);}this.on("keydown",this._onKeyDown);this.on("appendTo",this._onAppendTo);var G=this.get("container");if(G){if(D.isString(G)){B.onContentReady(G,function(){this.appendTo(G);},null,this);}else{this.appendTo(G);}}},initAttributes:function(G){var F=G||{};YAHOO.widget.ButtonGroup.superclass.initAttributes.call(this,F);this.setAttributeConfig("name",{value:F.name,validator:D.isString});this.setAttributeConfig("disabled",{value:(F.disabled||false),validator:D.isBoolean,method:this._setDisabled});this.setAttributeConfig("value",{value:F.value});this.setAttributeConfig("container",{value:F.container,writeOnce:true});this.setAttributeConfig("checkedButton",{value:null});},addButton:function(J){var L,K,G,F,H,I;if(J instanceof A&&J.get("type")=="radio"){L=J;}else{if(!D.isString(J)&&!J.nodeName){J.type="radio";L=new A(J);}else{L=new A(J,{type:"radio"});}}if(L){F=this._buttons.length;H=L.get("name");I=this.get("name");L.index=F;this._buttons[F]=L;E[L.get("id")]=L;if(H!=I){L.set("name",I);}if(this.get("disabled")){L.set("disabled",true);}if(L.get("checked")){this.set("checkedButton",L);}K=L.get("element");G=this.get("element");if(K.parentNode!=G){G.appendChild(K);}L.on("checkedChange",this._onButtonCheckedChange,L,this);}return L;},addButtons:function(G){var H,I,J,F;if(D.isArray(G)){H=G.length;J=[];if(H>0){for(F=0;F<H;F++){I=this.addButton(G[F]);if(I){J[J.length]=I;}}}}return J;},removeButton:function(H){var I=this.getButton(H),G,F;if(I){this._buttons.splice(H,1);delete E[I.get("id")];I.removeListener("checkedChange",this._onButtonCheckedChange);I.destroy();G=this._buttons.length;if(G>0){F=this._buttons.length-1;do{this._buttons[F].index=F;}while(F--);}}},getButton:function(F){return this._buttons[F];},getButtons:function(){return this._buttons;},getCount:function(){return this._buttons.length;},focus:function(H){var I,G,F;if(D.isNumber(H)){I=this._buttons[H];if(I){I.focus();}}else{G=this.getCount();for(F=0;F<G;F++){I=this._buttons[F];if(!I.get("disabled")){I.focus();break;}}}},check:function(F){var G=this.getButton(F);if(G){G.set("checked",true);}},destroy:function(){var I=this._buttons.length,H=this.get("element"),F=H.parentNode,G;if(I>0){G=this._buttons.length-1;do{this._buttons[G].destroy();}while(G--);}B.purgeElement(H);F.removeChild(H);},toString:function(){return("ButtonGroup "+this.get("id"));}});})();YAHOO.register("button",YAHOO.widget.Button,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/calendar/calendar-min.js b/js/yui/calendar/calendar-min.js
new file mode 100644 (file)
index 0000000..223cdcf
--- /dev/null
+++ b/js/yui/calendar/calendar-min.js
@@ -0,0 +1,18 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){YAHOO.util.Config=function(d){if(d){this.init(d);}};var b=YAHOO.lang,c=YAHOO.util.CustomEvent,a=YAHOO.util.Config;a.CONFIG_CHANGED_EVENT="configChanged";a.BOOLEAN_TYPE="boolean";a.prototype={owner:null,queueInProgress:false,config:null,initialConfig:null,eventQueue:null,configChangedEvent:null,init:function(d){this.owner=d;this.configChangedEvent=this.createEvent(a.CONFIG_CHANGED_EVENT);this.configChangedEvent.signature=c.LIST;this.queueInProgress=false;this.config={};this.initialConfig={};this.eventQueue=[];},checkBoolean:function(d){return(typeof d==a.BOOLEAN_TYPE);},checkNumber:function(d){return(!isNaN(d));},fireEvent:function(d,f){var e=this.config[d];if(e&&e.event){e.event.fire(f);}},addProperty:function(e,d){e=e.toLowerCase();this.config[e]=d;d.event=this.createEvent(e,{scope:this.owner});d.event.signature=c.LIST;d.key=e;if(d.handler){d.event.subscribe(d.handler,this.owner);}this.setProperty(e,d.value,true);if(!d.suppressEvent){this.queueProperty(e,d.value);}},getConfig:function(){var d={},f=this.config,g,e;for(g in f){if(b.hasOwnProperty(f,g)){e=f[g];if(e&&e.event){d[g]=e.value;}}}return d;},getProperty:function(d){var e=this.config[d.toLowerCase()];if(e&&e.event){return e.value;}else{return undefined;}},resetProperty:function(d){d=d.toLowerCase();var e=this.config[d];if(e&&e.event){if(d in this.initialConfig){this.setProperty(d,this.initialConfig[d]);return true;}}else{return false;}},setProperty:function(e,g,d){var f;e=e.toLowerCase();if(this.queueInProgress&&!d){this.queueProperty(e,g);return true;}else{f=this.config[e];if(f&&f.event){if(f.validator&&!f.validator(g)){return false;}else{f.value=g;if(!d){this.fireEvent(e,g);this.configChangedEvent.fire([e,g]);}return true;}}else{return false;}}},queueProperty:function(v,r){v=v.toLowerCase();var u=this.config[v],l=false,k,g,h,j,p,t,f,n,o,d,m,w,e;if(u&&u.event){if(!b.isUndefined(r)&&u.validator&&!u.validator(r)){return false;}else{if(!b.isUndefined(r)){u.value=r;}else{r=u.value;}l=false;k=this.eventQueue.length;for(m=0;m<k;m++){g=this.eventQueue[m];if(g){h=g[0];j=g[1];if(h==v){this.eventQueue[m]=null;this.eventQueue.push([v,(!b.isUndefined(r)?r:j)]);l=true;break;}}}if(!l&&!b.isUndefined(r)){this.eventQueue.push([v,r]);}}if(u.supercedes){p=u.supercedes.length;for(w=0;w<p;w++){t=u.supercedes[w];f=this.eventQueue.length;for(e=0;e<f;e++){n=this.eventQueue[e];if(n){o=n[0];d=n[1];if(o==t.toLowerCase()){this.eventQueue.push([o,d]);this.eventQueue[e]=null;break;}}}}}return true;}else{return false;}},refireEvent:function(d){d=d.toLowerCase();var e=this.config[d];if(e&&e.event&&!b.isUndefined(e.value)){if(this.queueInProgress){this.queueProperty(d);}else{this.fireEvent(d,e.value);}}},applyConfig:function(d,g){var f,e;if(g){e={};for(f in d){if(b.hasOwnProperty(d,f)){e[f.toLowerCase()]=d[f];}}this.initialConfig=e;}for(f in d){if(b.hasOwnProperty(d,f)){this.queueProperty(f,d[f]);}}},refresh:function(){var d;for(d in this.config){if(b.hasOwnProperty(this.config,d)){this.refireEvent(d);}}},fireQueue:function(){var e,h,d,g,f;this.queueInProgress=true;for(e=0;e<this.eventQueue.length;e++){h=this.eventQueue[e];if(h){d=h[0];g=h[1];f=this.config[d];f.value=g;this.eventQueue[e]=null;this.fireEvent(d,g);}}this.queueInProgress=false;this.eventQueue=[];},subscribeToConfigEvent:function(d,e,g,h){var f=this.config[d.toLowerCase()];if(f&&f.event){if(!a.alreadySubscribed(f.event,e,g)){f.event.subscribe(e,g,h);}return true;}else{return false;}},unsubscribeFromConfigEvent:function(d,e,g){var f=this.config[d.toLowerCase()];if(f&&f.event){return f.event.unsubscribe(e,g);}else{return false;}},toString:function(){var d="Config";if(this.owner){d+=" ["+this.owner.toString()+"]";}return d;},outputEventQueue:function(){var d="",g,e,f=this.eventQueue.length;for(e=0;e<f;e++){g=this.eventQueue[e];if(g){d+=g[0]+"="+g[1]+", ";}}return d;},destroy:function(){var e=this.config,d,f;for(d in e){if(b.hasOwnProperty(e,d)){f=e[d];f.event.unsubscribeAll();f.event=null;}}this.configChangedEvent.unsubscribeAll();this.configChangedEvent=null;this.owner=null;this.config=null;this.initialConfig=null;this.eventQueue=null;}};a.alreadySubscribed=function(e,h,j){var f=e.subscribers.length,d,g;if(f>0){g=f-1;do{d=e.subscribers[g];if(d&&d.obj==j&&d.fn==h){return true;}}while(g--);}return false;};YAHOO.lang.augmentProto(a,YAHOO.util.EventProvider);}());YAHOO.widget.DateMath={DAY:"D",WEEK:"W",YEAR:"Y",MONTH:"M",ONE_DAY_MS:1000*60*60*24,WEEK_ONE_JAN_DATE:1,add:function(a,e,c){var g=new Date(a.getTime());switch(e){case this.MONTH:var f=a.getMonth()+c;var b=0;if(f<0){while(f<0){f+=12;b-=1;}}else{if(f>11){while(f>11){f-=12;b+=1;}}}g.setMonth(f);g.setFullYear(a.getFullYear()+b);break;case this.DAY:this._addDays(g,c);break;case this.YEAR:g.setFullYear(a.getFullYear()+c);break;case this.WEEK:this._addDays(g,(c*7));break;}return g;},_addDays:function(e,c){if(YAHOO.env.ua.webkit&&YAHOO.env.ua.webkit<420){if(c<0){for(var b=-128;c<b;c-=b){e.setDate(e.getDate()+b);}}else{for(var a=96;c>a;c-=a){e.setDate(e.getDate()+a);}}}e.setDate(e.getDate()+c);},subtract:function(a,c,b){return this.add(a,c,(b*-1));},before:function(c,b){var a=b.getTime();if(c.getTime()<a){return true;}else{return false;}},after:function(c,b){var a=b.getTime();if(c.getTime()>a){return true;}else{return false;}},between:function(b,a,c){if(this.after(b,a)&&this.before(b,c)){return true;}else{return false;}},getJan1:function(a){return this.getDate(a,0,1);},getDayOffset:function(b,d){var c=this.getJan1(d);var a=Math.ceil((b.getTime()-c.getTime())/this.ONE_DAY_MS);return a;},getWeekNumber:function(d,b,g){b=b||0;g=g||this.WEEK_ONE_JAN_DATE;var h=this.clearTime(d),l,m;if(h.getDay()===b){l=h;}else{l=this.getFirstDayOfWeek(h,b);}var i=l.getFullYear();m=new Date(l.getTime()+6*this.ONE_DAY_MS);var f;if(i!==m.getFullYear()&&m.getDate()>=g){f=1;}else{var e=this.clearTime(this.getDate(i,0,g)),a=this.getFirstDayOfWeek(e,b);var j=Math.round((h.getTime()-a.getTime())/this.ONE_DAY_MS);var k=j%7;var c=(j-k)/7;f=c+1;}return f;},getFirstDayOfWeek:function(d,a){a=a||0;
+var b=d.getDay(),c=(b-a+7)%7;return this.subtract(d,this.DAY,c);},isYearOverlapWeek:function(a){var c=false;var b=this.add(a,this.DAY,6);if(b.getFullYear()!=a.getFullYear()){c=true;}return c;},isMonthOverlapWeek:function(a){var c=false;var b=this.add(a,this.DAY,6);if(b.getMonth()!=a.getMonth()){c=true;}return c;},findMonthStart:function(a){var b=this.getDate(a.getFullYear(),a.getMonth(),1);return b;},findMonthEnd:function(b){var d=this.findMonthStart(b);var c=this.add(d,this.MONTH,1);var a=this.subtract(c,this.DAY,1);return a;},clearTime:function(a){a.setHours(12,0,0,0);return a;},getDate:function(e,a,c){var b=null;if(YAHOO.lang.isUndefined(c)){c=1;}if(e>=100){b=new Date(e,a,c);}else{b=new Date();b.setFullYear(e);b.setMonth(a);b.setDate(c);b.setHours(0,0,0,0);}return b;}};(function(){var c=YAHOO.util.Dom,a=YAHOO.util.Event,e=YAHOO.lang,d=YAHOO.widget.DateMath;function f(i,g,h){this.init.apply(this,arguments);}f.IMG_ROOT=null;f.DATE="D";f.MONTH_DAY="MD";f.WEEKDAY="WD";f.RANGE="R";f.MONTH="M";f.DISPLAY_DAYS=42;f.STOP_RENDER="S";f.SHORT="short";f.LONG="long";f.MEDIUM="medium";f.ONE_CHAR="1char";f.DEFAULT_CONFIG={YEAR_OFFSET:{key:"year_offset",value:0,supercedes:["pagedate","selected","mindate","maxdate"]},TODAY:{key:"today",value:new Date(),supercedes:["pagedate"]},PAGEDATE:{key:"pagedate",value:null},SELECTED:{key:"selected",value:[]},TITLE:{key:"title",value:""},CLOSE:{key:"close",value:false},IFRAME:{key:"iframe",value:(YAHOO.env.ua.ie&&YAHOO.env.ua.ie<=6)?true:false},MINDATE:{key:"mindate",value:null},MAXDATE:{key:"maxdate",value:null},MULTI_SELECT:{key:"multi_select",value:false},OOM_SELECT:{key:"oom_select",value:false},START_WEEKDAY:{key:"start_weekday",value:0},SHOW_WEEKDAYS:{key:"show_weekdays",value:true},SHOW_WEEK_HEADER:{key:"show_week_header",value:false},SHOW_WEEK_FOOTER:{key:"show_week_footer",value:false},HIDE_BLANK_WEEKS:{key:"hide_blank_weeks",value:false},NAV_ARROW_LEFT:{key:"nav_arrow_left",value:null},NAV_ARROW_RIGHT:{key:"nav_arrow_right",value:null},MONTHS_SHORT:{key:"months_short",value:["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"]},MONTHS_LONG:{key:"months_long",value:["January","February","March","April","May","June","July","August","September","October","November","December"]},WEEKDAYS_1CHAR:{key:"weekdays_1char",value:["S","M","T","W","T","F","S"]},WEEKDAYS_SHORT:{key:"weekdays_short",value:["Su","Mo","Tu","We","Th","Fr","Sa"]},WEEKDAYS_MEDIUM:{key:"weekdays_medium",value:["Sun","Mon","Tue","Wed","Thu","Fri","Sat"]},WEEKDAYS_LONG:{key:"weekdays_long",value:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"]},LOCALE_MONTHS:{key:"locale_months",value:"long"},LOCALE_WEEKDAYS:{key:"locale_weekdays",value:"short"},DATE_DELIMITER:{key:"date_delimiter",value:","},DATE_FIELD_DELIMITER:{key:"date_field_delimiter",value:"/"},DATE_RANGE_DELIMITER:{key:"date_range_delimiter",value:"-"},MY_MONTH_POSITION:{key:"my_month_position",value:1},MY_YEAR_POSITION:{key:"my_year_position",value:2},MD_MONTH_POSITION:{key:"md_month_position",value:1},MD_DAY_POSITION:{key:"md_day_position",value:2},MDY_MONTH_POSITION:{key:"mdy_month_position",value:1},MDY_DAY_POSITION:{key:"mdy_day_position",value:2},MDY_YEAR_POSITION:{key:"mdy_year_position",value:3},MY_LABEL_MONTH_POSITION:{key:"my_label_month_position",value:1},MY_LABEL_YEAR_POSITION:{key:"my_label_year_position",value:2},MY_LABEL_MONTH_SUFFIX:{key:"my_label_month_suffix",value:" "},MY_LABEL_YEAR_SUFFIX:{key:"my_label_year_suffix",value:""},NAV:{key:"navigator",value:null},STRINGS:{key:"strings",value:{previousMonth:"Previous Month",nextMonth:"Next Month",close:"Close"},supercedes:["close","title"]}};f._DEFAULT_CONFIG=f.DEFAULT_CONFIG;var b=f.DEFAULT_CONFIG;f._EVENT_TYPES={BEFORE_SELECT:"beforeSelect",SELECT:"select",BEFORE_DESELECT:"beforeDeselect",DESELECT:"deselect",CHANGE_PAGE:"changePage",BEFORE_RENDER:"beforeRender",RENDER:"render",BEFORE_DESTROY:"beforeDestroy",DESTROY:"destroy",RESET:"reset",CLEAR:"clear",BEFORE_HIDE:"beforeHide",HIDE:"hide",BEFORE_SHOW:"beforeShow",SHOW:"show",BEFORE_HIDE_NAV:"beforeHideNav",HIDE_NAV:"hideNav",BEFORE_SHOW_NAV:"beforeShowNav",SHOW_NAV:"showNav",BEFORE_RENDER_NAV:"beforeRenderNav",RENDER_NAV:"renderNav"};f.STYLES={CSS_ROW_HEADER:"calrowhead",CSS_ROW_FOOTER:"calrowfoot",CSS_CELL:"calcell",CSS_CELL_SELECTOR:"selector",CSS_CELL_SELECTED:"selected",CSS_CELL_SELECTABLE:"selectable",CSS_CELL_RESTRICTED:"restricted",CSS_CELL_TODAY:"today",CSS_CELL_OOM:"oom",CSS_CELL_OOB:"previous",CSS_HEADER:"calheader",CSS_HEADER_TEXT:"calhead",CSS_BODY:"calbody",CSS_WEEKDAY_CELL:"calweekdaycell",CSS_WEEKDAY_ROW:"calweekdayrow",CSS_FOOTER:"calfoot",CSS_CALENDAR:"yui-calendar",CSS_SINGLE:"single",CSS_CONTAINER:"yui-calcontainer",CSS_NAV_LEFT:"calnavleft",CSS_NAV_RIGHT:"calnavright",CSS_NAV:"calnav",CSS_CLOSE:"calclose",CSS_CELL_TOP:"calcelltop",CSS_CELL_LEFT:"calcellleft",CSS_CELL_RIGHT:"calcellright",CSS_CELL_BOTTOM:"calcellbottom",CSS_CELL_HOVER:"calcellhover",CSS_CELL_HIGHLIGHT1:"highlight1",CSS_CELL_HIGHLIGHT2:"highlight2",CSS_CELL_HIGHLIGHT3:"highlight3",CSS_CELL_HIGHLIGHT4:"highlight4",CSS_WITH_TITLE:"withtitle",CSS_FIXED_SIZE:"fixedsize",CSS_LINK_CLOSE:"link-close"};f._STYLES=f.STYLES;f.prototype={Config:null,parent:null,index:-1,cells:null,cellDates:null,id:null,containerId:null,oDomContainer:null,today:null,renderStack:null,_renderStack:null,oNavigator:null,_selectedDates:null,domEventMap:null,_parseArgs:function(h){var g={id:null,container:null,config:null};if(h&&h.length&&h.length>0){switch(h.length){case 1:g.id=null;g.container=h[0];g.config=null;break;case 2:if(e.isObject(h[1])&&!h[1].tagName&&!(h[1] instanceof String)){g.id=null;g.container=h[0];g.config=h[1];}else{g.id=h[0];g.container=h[1];g.config=null;}break;default:g.id=h[0];g.container=h[1];g.config=h[2];break;}}else{}return g;},init:function(j,h,i){var g=this._parseArgs(arguments);j=g.id;h=g.container;i=g.config;this.oDomContainer=c.get(h);this._oDoc=this.oDomContainer.ownerDocument;if(!this.oDomContainer.id){this.oDomContainer.id=c.generateId();
+}if(!j){j=this.oDomContainer.id+"_t";}this.id=j;this.containerId=this.oDomContainer.id;this.initEvents();this.cfg=new YAHOO.util.Config(this);this.Options={};this.Locale={};this.initStyles();c.addClass(this.oDomContainer,this.Style.CSS_CONTAINER);c.addClass(this.oDomContainer,this.Style.CSS_SINGLE);this.cellDates=[];this.cells=[];this.renderStack=[];this._renderStack=[];this.setupConfig();if(i){this.cfg.applyConfig(i,true);}this.cfg.fireQueue();this.today=this.cfg.getProperty("today");},configIframe:function(i,h,j){var g=h[0];if(!this.parent){if(c.inDocument(this.oDomContainer)){if(g){var k=c.getStyle(this.oDomContainer,"position");if(k=="absolute"||k=="relative"){if(!c.inDocument(this.iframe)){this.iframe=document.createElement("iframe");this.iframe.src="javascript:false;";c.setStyle(this.iframe,"opacity","0");if(YAHOO.env.ua.ie&&YAHOO.env.ua.ie<=6){c.addClass(this.iframe,this.Style.CSS_FIXED_SIZE);}this.oDomContainer.insertBefore(this.iframe,this.oDomContainer.firstChild);}}}else{if(this.iframe){if(this.iframe.parentNode){this.iframe.parentNode.removeChild(this.iframe);}this.iframe=null;}}}}},configTitle:function(h,g,i){var k=g[0];if(k){this.createTitleBar(k);}else{var j=this.cfg.getProperty(b.CLOSE.key);if(!j){this.removeTitleBar();}else{this.createTitleBar("&#160;");}}},configClose:function(h,g,i){var k=g[0],j=this.cfg.getProperty(b.TITLE.key);if(k){if(!j){this.createTitleBar("&#160;");}this.createCloseButton();}else{this.removeCloseButton();if(!j){this.removeTitleBar();}}},initEvents:function(){var g=f._EVENT_TYPES,i=YAHOO.util.CustomEvent,h=this;h.beforeSelectEvent=new i(g.BEFORE_SELECT);h.selectEvent=new i(g.SELECT);h.beforeDeselectEvent=new i(g.BEFORE_DESELECT);h.deselectEvent=new i(g.DESELECT);h.changePageEvent=new i(g.CHANGE_PAGE);h.beforeRenderEvent=new i(g.BEFORE_RENDER);h.renderEvent=new i(g.RENDER);h.beforeDestroyEvent=new i(g.BEFORE_DESTROY);h.destroyEvent=new i(g.DESTROY);h.resetEvent=new i(g.RESET);h.clearEvent=new i(g.CLEAR);h.beforeShowEvent=new i(g.BEFORE_SHOW);h.showEvent=new i(g.SHOW);h.beforeHideEvent=new i(g.BEFORE_HIDE);h.hideEvent=new i(g.HIDE);h.beforeShowNavEvent=new i(g.BEFORE_SHOW_NAV);h.showNavEvent=new i(g.SHOW_NAV);h.beforeHideNavEvent=new i(g.BEFORE_HIDE_NAV);h.hideNavEvent=new i(g.HIDE_NAV);h.beforeRenderNavEvent=new i(g.BEFORE_RENDER_NAV);h.renderNavEvent=new i(g.RENDER_NAV);h.beforeSelectEvent.subscribe(h.onBeforeSelect,this,true);h.selectEvent.subscribe(h.onSelect,this,true);h.beforeDeselectEvent.subscribe(h.onBeforeDeselect,this,true);h.deselectEvent.subscribe(h.onDeselect,this,true);h.changePageEvent.subscribe(h.onChangePage,this,true);h.renderEvent.subscribe(h.onRender,this,true);h.resetEvent.subscribe(h.onReset,this,true);h.clearEvent.subscribe(h.onClear,this,true);},doPreviousMonthNav:function(h,g){a.preventDefault(h);setTimeout(function(){g.previousMonth();var j=c.getElementsByClassName(g.Style.CSS_NAV_LEFT,"a",g.oDomContainer);if(j&&j[0]){try{j[0].focus();}catch(i){}}},0);},doNextMonthNav:function(h,g){a.preventDefault(h);setTimeout(function(){g.nextMonth();var j=c.getElementsByClassName(g.Style.CSS_NAV_RIGHT,"a",g.oDomContainer);if(j&&j[0]){try{j[0].focus();}catch(i){}}},0);},doSelectCell:function(m,g){var r,o,i,l;var n=a.getTarget(m),h=n.tagName.toLowerCase(),k=false;while(h!="td"&&!c.hasClass(n,g.Style.CSS_CELL_SELECTABLE)){if(!k&&h=="a"&&c.hasClass(n,g.Style.CSS_CELL_SELECTOR)){k=true;}n=n.parentNode;h=n.tagName.toLowerCase();if(n==this.oDomContainer||h=="html"){return;}}if(k){a.preventDefault(m);}r=n;if(c.hasClass(r,g.Style.CSS_CELL_SELECTABLE)){l=g.getIndexFromId(r.id);if(l>-1){o=g.cellDates[l];if(o){i=d.getDate(o[0],o[1]-1,o[2]);var q;if(g.Options.MULTI_SELECT){q=r.getElementsByTagName("a")[0];if(q){q.blur();}var j=g.cellDates[l];var p=g._indexOfSelectedFieldArray(j);if(p>-1){g.deselectCell(l);}else{g.selectCell(l);}}else{q=r.getElementsByTagName("a")[0];if(q){q.blur();}g.selectCell(l);}}}}},doCellMouseOver:function(i,h){var g;if(i){g=a.getTarget(i);}else{g=this;}while(g.tagName&&g.tagName.toLowerCase()!="td"){g=g.parentNode;if(!g.tagName||g.tagName.toLowerCase()=="html"){return;}}if(c.hasClass(g,h.Style.CSS_CELL_SELECTABLE)){c.addClass(g,h.Style.CSS_CELL_HOVER);}},doCellMouseOut:function(i,h){var g;if(i){g=a.getTarget(i);}else{g=this;}while(g.tagName&&g.tagName.toLowerCase()!="td"){g=g.parentNode;if(!g.tagName||g.tagName.toLowerCase()=="html"){return;}}if(c.hasClass(g,h.Style.CSS_CELL_SELECTABLE)){c.removeClass(g,h.Style.CSS_CELL_HOVER);}},setupConfig:function(){var g=this.cfg;g.addProperty(b.TODAY.key,{value:new Date(b.TODAY.value.getTime()),supercedes:b.TODAY.supercedes,handler:this.configToday,suppressEvent:true});g.addProperty(b.PAGEDATE.key,{value:b.PAGEDATE.value||new Date(b.TODAY.value.getTime()),handler:this.configPageDate});g.addProperty(b.SELECTED.key,{value:b.SELECTED.value.concat(),handler:this.configSelected});g.addProperty(b.TITLE.key,{value:b.TITLE.value,handler:this.configTitle});g.addProperty(b.CLOSE.key,{value:b.CLOSE.value,handler:this.configClose});g.addProperty(b.IFRAME.key,{value:b.IFRAME.value,handler:this.configIframe,validator:g.checkBoolean});g.addProperty(b.MINDATE.key,{value:b.MINDATE.value,handler:this.configMinDate});g.addProperty(b.MAXDATE.key,{value:b.MAXDATE.value,handler:this.configMaxDate});g.addProperty(b.MULTI_SELECT.key,{value:b.MULTI_SELECT.value,handler:this.configOptions,validator:g.checkBoolean});g.addProperty(b.OOM_SELECT.key,{value:b.OOM_SELECT.value,handler:this.configOptions,validator:g.checkBoolean});g.addProperty(b.START_WEEKDAY.key,{value:b.START_WEEKDAY.value,handler:this.configOptions,validator:g.checkNumber});g.addProperty(b.SHOW_WEEKDAYS.key,{value:b.SHOW_WEEKDAYS.value,handler:this.configOptions,validator:g.checkBoolean});g.addProperty(b.SHOW_WEEK_HEADER.key,{value:b.SHOW_WEEK_HEADER.value,handler:this.configOptions,validator:g.checkBoolean});g.addProperty(b.SHOW_WEEK_FOOTER.key,{value:b.SHOW_WEEK_FOOTER.value,handler:this.configOptions,validator:g.checkBoolean});g.addProperty(b.HIDE_BLANK_WEEKS.key,{value:b.HIDE_BLANK_WEEKS.value,handler:this.configOptions,validator:g.checkBoolean});
+g.addProperty(b.NAV_ARROW_LEFT.key,{value:b.NAV_ARROW_LEFT.value,handler:this.configOptions});g.addProperty(b.NAV_ARROW_RIGHT.key,{value:b.NAV_ARROW_RIGHT.value,handler:this.configOptions});g.addProperty(b.MONTHS_SHORT.key,{value:b.MONTHS_SHORT.value,handler:this.configLocale});g.addProperty(b.MONTHS_LONG.key,{value:b.MONTHS_LONG.value,handler:this.configLocale});g.addProperty(b.WEEKDAYS_1CHAR.key,{value:b.WEEKDAYS_1CHAR.value,handler:this.configLocale});g.addProperty(b.WEEKDAYS_SHORT.key,{value:b.WEEKDAYS_SHORT.value,handler:this.configLocale});g.addProperty(b.WEEKDAYS_MEDIUM.key,{value:b.WEEKDAYS_MEDIUM.value,handler:this.configLocale});g.addProperty(b.WEEKDAYS_LONG.key,{value:b.WEEKDAYS_LONG.value,handler:this.configLocale});var h=function(){g.refireEvent(b.LOCALE_MONTHS.key);g.refireEvent(b.LOCALE_WEEKDAYS.key);};g.subscribeToConfigEvent(b.START_WEEKDAY.key,h,this,true);g.subscribeToConfigEvent(b.MONTHS_SHORT.key,h,this,true);g.subscribeToConfigEvent(b.MONTHS_LONG.key,h,this,true);g.subscribeToConfigEvent(b.WEEKDAYS_1CHAR.key,h,this,true);g.subscribeToConfigEvent(b.WEEKDAYS_SHORT.key,h,this,true);g.subscribeToConfigEvent(b.WEEKDAYS_MEDIUM.key,h,this,true);g.subscribeToConfigEvent(b.WEEKDAYS_LONG.key,h,this,true);g.addProperty(b.LOCALE_MONTHS.key,{value:b.LOCALE_MONTHS.value,handler:this.configLocaleValues});g.addProperty(b.LOCALE_WEEKDAYS.key,{value:b.LOCALE_WEEKDAYS.value,handler:this.configLocaleValues});g.addProperty(b.YEAR_OFFSET.key,{value:b.YEAR_OFFSET.value,supercedes:b.YEAR_OFFSET.supercedes,handler:this.configLocale});g.addProperty(b.DATE_DELIMITER.key,{value:b.DATE_DELIMITER.value,handler:this.configLocale});g.addProperty(b.DATE_FIELD_DELIMITER.key,{value:b.DATE_FIELD_DELIMITER.value,handler:this.configLocale});g.addProperty(b.DATE_RANGE_DELIMITER.key,{value:b.DATE_RANGE_DELIMITER.value,handler:this.configLocale});g.addProperty(b.MY_MONTH_POSITION.key,{value:b.MY_MONTH_POSITION.value,handler:this.configLocale,validator:g.checkNumber});g.addProperty(b.MY_YEAR_POSITION.key,{value:b.MY_YEAR_POSITION.value,handler:this.configLocale,validator:g.checkNumber});g.addProperty(b.MD_MONTH_POSITION.key,{value:b.MD_MONTH_POSITION.value,handler:this.configLocale,validator:g.checkNumber});g.addProperty(b.MD_DAY_POSITION.key,{value:b.MD_DAY_POSITION.value,handler:this.configLocale,validator:g.checkNumber});g.addProperty(b.MDY_MONTH_POSITION.key,{value:b.MDY_MONTH_POSITION.value,handler:this.configLocale,validator:g.checkNumber});g.addProperty(b.MDY_DAY_POSITION.key,{value:b.MDY_DAY_POSITION.value,handler:this.configLocale,validator:g.checkNumber});g.addProperty(b.MDY_YEAR_POSITION.key,{value:b.MDY_YEAR_POSITION.value,handler:this.configLocale,validator:g.checkNumber});g.addProperty(b.MY_LABEL_MONTH_POSITION.key,{value:b.MY_LABEL_MONTH_POSITION.value,handler:this.configLocale,validator:g.checkNumber});g.addProperty(b.MY_LABEL_YEAR_POSITION.key,{value:b.MY_LABEL_YEAR_POSITION.value,handler:this.configLocale,validator:g.checkNumber});g.addProperty(b.MY_LABEL_MONTH_SUFFIX.key,{value:b.MY_LABEL_MONTH_SUFFIX.value,handler:this.configLocale});g.addProperty(b.MY_LABEL_YEAR_SUFFIX.key,{value:b.MY_LABEL_YEAR_SUFFIX.value,handler:this.configLocale});g.addProperty(b.NAV.key,{value:b.NAV.value,handler:this.configNavigator});g.addProperty(b.STRINGS.key,{value:b.STRINGS.value,handler:this.configStrings,validator:function(i){return e.isObject(i);},supercedes:b.STRINGS.supercedes});},configStrings:function(h,g,i){var j=e.merge(b.STRINGS.value,g[0]);this.cfg.setProperty(b.STRINGS.key,j,true);},configPageDate:function(h,g,i){this.cfg.setProperty(b.PAGEDATE.key,this._parsePageDate(g[0]),true);},configMinDate:function(h,g,i){var j=g[0];if(e.isString(j)){j=this._parseDate(j);this.cfg.setProperty(b.MINDATE.key,d.getDate(j[0],(j[1]-1),j[2]));}},configMaxDate:function(h,g,i){var j=g[0];if(e.isString(j)){j=this._parseDate(j);this.cfg.setProperty(b.MAXDATE.key,d.getDate(j[0],(j[1]-1),j[2]));}},configToday:function(i,h,j){var k=h[0];if(e.isString(k)){k=this._parseDate(k);}var g=d.clearTime(k);if(!this.cfg.initialConfig[b.PAGEDATE.key]){this.cfg.setProperty(b.PAGEDATE.key,g);}this.today=g;this.cfg.setProperty(b.TODAY.key,g,true);},configSelected:function(i,g,k){var h=g[0],j=b.SELECTED.key;if(h){if(e.isString(h)){this.cfg.setProperty(j,this._parseDates(h),true);}}if(!this._selectedDates){this._selectedDates=this.cfg.getProperty(j);}},configOptions:function(h,g,i){this.Options[h.toUpperCase()]=g[0];},configLocale:function(h,g,i){this.Locale[h.toUpperCase()]=g[0];this.cfg.refireEvent(b.LOCALE_MONTHS.key);this.cfg.refireEvent(b.LOCALE_WEEKDAYS.key);},configLocaleValues:function(j,i,k){j=j.toLowerCase();var m=i[0],h=this.cfg,n=this.Locale;switch(j){case b.LOCALE_MONTHS.key:switch(m){case f.SHORT:n.LOCALE_MONTHS=h.getProperty(b.MONTHS_SHORT.key).concat();break;case f.LONG:n.LOCALE_MONTHS=h.getProperty(b.MONTHS_LONG.key).concat();break;}break;case b.LOCALE_WEEKDAYS.key:switch(m){case f.ONE_CHAR:n.LOCALE_WEEKDAYS=h.getProperty(b.WEEKDAYS_1CHAR.key).concat();break;case f.SHORT:n.LOCALE_WEEKDAYS=h.getProperty(b.WEEKDAYS_SHORT.key).concat();break;case f.MEDIUM:n.LOCALE_WEEKDAYS=h.getProperty(b.WEEKDAYS_MEDIUM.key).concat();break;case f.LONG:n.LOCALE_WEEKDAYS=h.getProperty(b.WEEKDAYS_LONG.key).concat();break;}var l=h.getProperty(b.START_WEEKDAY.key);if(l>0){for(var g=0;g<l;++g){n.LOCALE_WEEKDAYS.push(n.LOCALE_WEEKDAYS.shift());}}break;}},configNavigator:function(h,g,i){var j=g[0];if(YAHOO.widget.CalendarNavigator&&(j===true||e.isObject(j))){if(!this.oNavigator){this.oNavigator=new YAHOO.widget.CalendarNavigator(this);this.beforeRenderEvent.subscribe(function(){if(!this.pages){this.oNavigator.erase();}},this,true);}}else{if(this.oNavigator){this.oNavigator.destroy();this.oNavigator=null;}}},initStyles:function(){var g=f.STYLES;this.Style={CSS_ROW_HEADER:g.CSS_ROW_HEADER,CSS_ROW_FOOTER:g.CSS_ROW_FOOTER,CSS_CELL:g.CSS_CELL,CSS_CELL_SELECTOR:g.CSS_CELL_SELECTOR,CSS_CELL_SELECTED:g.CSS_CELL_SELECTED,CSS_CELL_SELECTABLE:g.CSS_CELL_SELECTABLE,CSS_CELL_RESTRICTED:g.CSS_CELL_RESTRICTED,CSS_CELL_TODAY:g.CSS_CELL_TODAY,CSS_CELL_OOM:g.CSS_CELL_OOM,CSS_CELL_OOB:g.CSS_CELL_OOB,CSS_HEADER:g.CSS_HEADER,CSS_HEADER_TEXT:g.CSS_HEADER_TEXT,CSS_BODY:g.CSS_BODY,CSS_WEEKDAY_CELL:g.CSS_WEEKDAY_CELL,CSS_WEEKDAY_ROW:g.CSS_WEEKDAY_ROW,CSS_FOOTER:g.CSS_FOOTER,CSS_CALENDAR:g.CSS_CALENDAR,CSS_SINGLE:g.CSS_SINGLE,CSS_CONTAINER:g.CSS_CONTAINER,CSS_NAV_LEFT:g.CSS_NAV_LEFT,CSS_NAV_RIGHT:g.CSS_NAV_RIGHT,CSS_NAV:g.CSS_NAV,CSS_CLOSE:g.CSS_CLOSE,CSS_CELL_TOP:g.CSS_CELL_TOP,CSS_CELL_LEFT:g.CSS_CELL_LEFT,CSS_CELL_RIGHT:g.CSS_CELL_RIGHT,CSS_CELL_BOTTOM:g.CSS_CELL_BOTTOM,CSS_CELL_HOVER:g.CSS_CELL_HOVER,CSS_CELL_HIGHLIGHT1:g.CSS_CELL_HIGHLIGHT1,CSS_CELL_HIGHLIGHT2:g.CSS_CELL_HIGHLIGHT2,CSS_CELL_HIGHLIGHT3:g.CSS_CELL_HIGHLIGHT3,CSS_CELL_HIGHLIGHT4:g.CSS_CELL_HIGHLIGHT4,CSS_WITH_TITLE:g.CSS_WITH_TITLE,CSS_FIXED_SIZE:g.CSS_FIXED_SIZE,CSS_LINK_CLOSE:g.CSS_LINK_CLOSE};
+},buildMonthLabel:function(){return this._buildMonthLabel(this.cfg.getProperty(b.PAGEDATE.key));},_buildMonthLabel:function(g){var i=this.Locale.LOCALE_MONTHS[g.getMonth()]+this.Locale.MY_LABEL_MONTH_SUFFIX,h=(g.getFullYear()+this.Locale.YEAR_OFFSET)+this.Locale.MY_LABEL_YEAR_SUFFIX;if(this.Locale.MY_LABEL_MONTH_POSITION==2||this.Locale.MY_LABEL_YEAR_POSITION==1){return h+i;}else{return i+h;}},buildDayLabel:function(g){return g.getDate();},createTitleBar:function(g){var h=c.getElementsByClassName(YAHOO.widget.CalendarGroup.CSS_2UPTITLE,"div",this.oDomContainer)[0]||document.createElement("div");h.className=YAHOO.widget.CalendarGroup.CSS_2UPTITLE;h.innerHTML=g;this.oDomContainer.insertBefore(h,this.oDomContainer.firstChild);c.addClass(this.oDomContainer,this.Style.CSS_WITH_TITLE);return h;},removeTitleBar:function(){var g=c.getElementsByClassName(YAHOO.widget.CalendarGroup.CSS_2UPTITLE,"div",this.oDomContainer)[0]||null;if(g){a.purgeElement(g);this.oDomContainer.removeChild(g);}c.removeClass(this.oDomContainer,this.Style.CSS_WITH_TITLE);},createCloseButton:function(){var k=YAHOO.widget.CalendarGroup.CSS_2UPCLOSE,j=this.Style.CSS_LINK_CLOSE,m="us/my/bn/x_d.gif",l=c.getElementsByClassName(j,"a",this.oDomContainer)[0],g=this.cfg.getProperty(b.STRINGS.key),h=(g&&g.close)?g.close:"";if(!l){l=document.createElement("a");a.addListener(l,"click",function(o,n){n.hide();a.preventDefault(o);},this);}l.href="#";l.className=j;if(f.IMG_ROOT!==null){var i=c.getElementsByClassName(k,"img",l)[0]||document.createElement("img");i.src=f.IMG_ROOT+m;i.className=k;l.appendChild(i);}else{l.innerHTML='<span class="'+k+" "+this.Style.CSS_CLOSE+'">'+h+"</span>";}this.oDomContainer.appendChild(l);return l;},removeCloseButton:function(){var g=c.getElementsByClassName(this.Style.CSS_LINK_CLOSE,"a",this.oDomContainer)[0]||null;if(g){a.purgeElement(g);this.oDomContainer.removeChild(g);}},renderHeader:function(q){var p=7,o="us/tr/callt.gif",g="us/tr/calrt.gif",n=this.cfg,k=n.getProperty(b.PAGEDATE.key),l=n.getProperty(b.STRINGS.key),v=(l&&l.previousMonth)?l.previousMonth:"",h=(l&&l.nextMonth)?l.nextMonth:"",m;if(n.getProperty(b.SHOW_WEEK_HEADER.key)){p+=1;}if(n.getProperty(b.SHOW_WEEK_FOOTER.key)){p+=1;}q[q.length]="<thead>";q[q.length]="<tr>";q[q.length]='<th colspan="'+p+'" class="'+this.Style.CSS_HEADER_TEXT+'">';q[q.length]='<div class="'+this.Style.CSS_HEADER+'">';var x,u=false;if(this.parent){if(this.index===0){x=true;}if(this.index==(this.parent.cfg.getProperty("pages")-1)){u=true;}}else{x=true;u=true;}if(x){m=this._buildMonthLabel(d.subtract(k,d.MONTH,1));var r=n.getProperty(b.NAV_ARROW_LEFT.key);if(r===null&&f.IMG_ROOT!==null){r=f.IMG_ROOT+o;}var i=(r===null)?"":' style="background-image:url('+r+')"';q[q.length]='<a class="'+this.Style.CSS_NAV_LEFT+'"'+i+' href="#">'+v+" ("+m+")"+"</a>";}var w=this.buildMonthLabel();var s=this.parent||this;if(s.cfg.getProperty("navigator")){w='<a class="'+this.Style.CSS_NAV+'" href="#">'+w+"</a>";}q[q.length]=w;if(u){m=this._buildMonthLabel(d.add(k,d.MONTH,1));var t=n.getProperty(b.NAV_ARROW_RIGHT.key);if(t===null&&f.IMG_ROOT!==null){t=f.IMG_ROOT+g;}var j=(t===null)?"":' style="background-image:url('+t+')"';q[q.length]='<a class="'+this.Style.CSS_NAV_RIGHT+'"'+j+' href="#">'+h+" ("+m+")"+"</a>";}q[q.length]="</div>\n</th>\n</tr>";if(n.getProperty(b.SHOW_WEEKDAYS.key)){q=this.buildWeekdays(q);}q[q.length]="</thead>";return q;},buildWeekdays:function(h){h[h.length]='<tr class="'+this.Style.CSS_WEEKDAY_ROW+'">';if(this.cfg.getProperty(b.SHOW_WEEK_HEADER.key)){h[h.length]="<th>&#160;</th>";}for(var g=0;g<this.Locale.LOCALE_WEEKDAYS.length;++g){h[h.length]='<th class="'+this.Style.CSS_WEEKDAY_CELL+'">'+this.Locale.LOCALE_WEEKDAYS[g]+"</th>";}if(this.cfg.getProperty(b.SHOW_WEEK_FOOTER.key)){h[h.length]="<th>&#160;</th>";}h[h.length]="</tr>";return h;},renderBody:function(T,Q){var ao=this.cfg.getProperty(b.START_WEEKDAY.key);this.preMonthDays=T.getDay();if(ao>0){this.preMonthDays-=ao;}if(this.preMonthDays<0){this.preMonthDays+=7;}this.monthDays=d.findMonthEnd(T).getDate();this.postMonthDays=f.DISPLAY_DAYS-this.preMonthDays-this.monthDays;T=d.subtract(T,d.DAY,this.preMonthDays);var F,q,o="w",L="_cell",J="wd",Z="d",v,X,af=this.today,u=this.cfg,ae,D=af.getFullYear(),Y=af.getMonth(),k=af.getDate(),ad=u.getProperty(b.PAGEDATE.key),j=u.getProperty(b.HIDE_BLANK_WEEKS.key),P=u.getProperty(b.SHOW_WEEK_FOOTER.key),I=u.getProperty(b.SHOW_WEEK_HEADER.key),O=u.getProperty(b.OOM_SELECT.key),B=u.getProperty(b.MINDATE.key),H=u.getProperty(b.MAXDATE.key),A=this.Locale.YEAR_OFFSET;if(B){B=d.clearTime(B);}if(H){H=d.clearTime(H);}Q[Q.length]='<tbody class="m'+(ad.getMonth()+1)+" "+this.Style.CSS_BODY+'">';var am=0,w=document.createElement("div"),R=document.createElement("td");w.appendChild(R);var ac=this.parent||this;for(var ah=0;ah<6;ah++){F=d.getWeekNumber(T,ao);q=o+F;if(ah!==0&&j===true&&T.getMonth()!=ad.getMonth()){break;}else{Q[Q.length]='<tr class="'+q+'">';if(I){Q=this.renderRowHeader(F,Q);}for(var an=0;an<7;an++){v=[];this.clearElement(R);R.className=this.Style.CSS_CELL;R.id=this.id+L+am;if(T.getDate()==k&&T.getMonth()==Y&&T.getFullYear()==D){v[v.length]=ac.renderCellStyleToday;}var G=[T.getFullYear(),T.getMonth()+1,T.getDate()];this.cellDates[this.cellDates.length]=G;ae=T.getMonth()!=ad.getMonth();if(ae&&!O){v[v.length]=ac.renderCellNotThisMonth;}else{c.addClass(R,J+T.getDay());c.addClass(R,Z+T.getDate());var S=this.renderStack.concat();for(var ag=0,al=S.length;ag<al;++ag){X=null;var aa=S[ag],ap=aa[0],h,K,n;switch(ap){case f.DATE:h=aa[1][1];K=aa[1][2];n=aa[1][0];if(T.getMonth()+1==h&&T.getDate()==K&&T.getFullYear()==n){X=aa[2];this.renderStack.splice(ag,1);}break;case f.MONTH_DAY:h=aa[1][0];K=aa[1][1];if(T.getMonth()+1==h&&T.getDate()==K){X=aa[2];this.renderStack.splice(ag,1);}break;case f.RANGE:var N=aa[1][0],M=aa[1][1],U=N[1],z=N[2],E=N[0],ak=d.getDate(E,U-1,z),m=M[1],W=M[2],g=M[0],aj=d.getDate(g,m-1,W);if(T.getTime()>=ak.getTime()&&T.getTime()<=aj.getTime()){X=aa[2];if(T.getTime()==aj.getTime()){this.renderStack.splice(ag,1);
+}}break;case f.WEEKDAY:var y=aa[1][0];if(T.getDay()+1==y){X=aa[2];}break;case f.MONTH:h=aa[1][0];if(T.getMonth()+1==h){X=aa[2];}break;}if(X){v[v.length]=X;}}}if(this._indexOfSelectedFieldArray(G)>-1){v[v.length]=ac.renderCellStyleSelected;}if(ae){v[v.length]=ac.styleCellNotThisMonth;}if((B&&(T.getTime()<B.getTime()))||(H&&(T.getTime()>H.getTime()))){v[v.length]=ac.renderOutOfBoundsDate;}else{v[v.length]=ac.styleCellDefault;v[v.length]=ac.renderCellDefault;}for(var ab=0;ab<v.length;++ab){if(v[ab].call(ac,T,R)==f.STOP_RENDER){break;}}T.setTime(T.getTime()+d.ONE_DAY_MS);T=d.clearTime(T);if(am>=0&&am<=6){c.addClass(R,this.Style.CSS_CELL_TOP);}if((am%7)===0){c.addClass(R,this.Style.CSS_CELL_LEFT);}if(((am+1)%7)===0){c.addClass(R,this.Style.CSS_CELL_RIGHT);}var V=this.postMonthDays;if(j&&V>=7){var C=Math.floor(V/7);for(var ai=0;ai<C;++ai){V-=7;}}if(am>=((this.preMonthDays+V+this.monthDays)-7)){c.addClass(R,this.Style.CSS_CELL_BOTTOM);}Q[Q.length]=w.innerHTML;am++;}if(P){Q=this.renderRowFooter(F,Q);}Q[Q.length]="</tr>";}}Q[Q.length]="</tbody>";return Q;},renderFooter:function(g){return g;},render:function(){this.beforeRenderEvent.fire();var i=d.findMonthStart(this.cfg.getProperty(b.PAGEDATE.key));this.resetRenderers();this.cellDates.length=0;a.purgeElement(this.oDomContainer,true);var g=[],h;g[g.length]='<table cellSpacing="0" class="'+this.Style.CSS_CALENDAR+" y"+(i.getFullYear()+this.Locale.YEAR_OFFSET)+'" id="'+this.id+'">';g=this.renderHeader(g);g=this.renderBody(i,g);g=this.renderFooter(g);g[g.length]="</table>";this.oDomContainer.innerHTML=g.join("\n");this.applyListeners();h=((this._oDoc)&&this._oDoc.getElementById(this.id))||(this.id);this.cells=c.getElementsByClassName(this.Style.CSS_CELL,"td",h);this.cfg.refireEvent(b.TITLE.key);this.cfg.refireEvent(b.CLOSE.key);this.cfg.refireEvent(b.IFRAME.key);this.renderEvent.fire();},applyListeners:function(){var q=this.oDomContainer,h=this.parent||this,m="a",t="click";var n=c.getElementsByClassName(this.Style.CSS_NAV_LEFT,m,q),j=c.getElementsByClassName(this.Style.CSS_NAV_RIGHT,m,q);if(n&&n.length>0){this.linkLeft=n[0];a.addListener(this.linkLeft,t,this.doPreviousMonthNav,h,true);}if(j&&j.length>0){this.linkRight=j[0];a.addListener(this.linkRight,t,this.doNextMonthNav,h,true);}if(h.cfg.getProperty("navigator")!==null){this.applyNavListeners();}if(this.domEventMap){var k,g;for(var s in this.domEventMap){if(e.hasOwnProperty(this.domEventMap,s)){var o=this.domEventMap[s];if(!(o instanceof Array)){o=[o];}for(var l=0;l<o.length;l++){var r=o[l];g=c.getElementsByClassName(s,r.tag,this.oDomContainer);for(var p=0;p<g.length;p++){k=g[p];a.addListener(k,r.event,r.handler,r.scope,r.correct);}}}}}a.addListener(this.oDomContainer,"click",this.doSelectCell,this);a.addListener(this.oDomContainer,"mouseover",this.doCellMouseOver,this);a.addListener(this.oDomContainer,"mouseout",this.doCellMouseOut,this);},applyNavListeners:function(){var h=this.parent||this,i=this,g=c.getElementsByClassName(this.Style.CSS_NAV,"a",this.oDomContainer);if(g.length>0){a.addListener(g,"click",function(n,m){var l=a.getTarget(n);if(this===l||c.isAncestor(this,l)){a.preventDefault(n);}var j=h.oNavigator;if(j){var k=i.cfg.getProperty("pagedate");j.setYear(k.getFullYear()+i.Locale.YEAR_OFFSET);j.setMonth(k.getMonth());j.show();}});}},getDateByCellId:function(h){var g=this.getDateFieldsByCellId(h);return(g)?d.getDate(g[0],g[1]-1,g[2]):null;},getDateFieldsByCellId:function(g){g=this.getIndexFromId(g);return(g>-1)?this.cellDates[g]:null;},getCellIndex:function(j){var h=-1;if(j){var g=j.getMonth(),p=j.getFullYear(),o=j.getDate(),l=this.cellDates;for(var k=0;k<l.length;++k){var n=l[k];if(n[0]===p&&n[1]===g+1&&n[2]===o){h=k;break;}}}return h;},getIndexFromId:function(i){var h=-1,g=i.lastIndexOf("_cell");if(g>-1){h=parseInt(i.substring(g+5),10);}return h;},renderOutOfBoundsDate:function(h,g){c.addClass(g,this.Style.CSS_CELL_OOB);g.innerHTML=h.getDate();return f.STOP_RENDER;},renderRowHeader:function(h,g){g[g.length]='<th class="'+this.Style.CSS_ROW_HEADER+'">'+h+"</th>";return g;},renderRowFooter:function(h,g){g[g.length]='<th class="'+this.Style.CSS_ROW_FOOTER+'">'+h+"</th>";return g;},renderCellDefault:function(h,g){g.innerHTML='<a href="#" class="'+this.Style.CSS_CELL_SELECTOR+'">'+this.buildDayLabel(h)+"</a>";},styleCellDefault:function(h,g){c.addClass(g,this.Style.CSS_CELL_SELECTABLE);},renderCellStyleHighlight1:function(h,g){c.addClass(g,this.Style.CSS_CELL_HIGHLIGHT1);},renderCellStyleHighlight2:function(h,g){c.addClass(g,this.Style.CSS_CELL_HIGHLIGHT2);},renderCellStyleHighlight3:function(h,g){c.addClass(g,this.Style.CSS_CELL_HIGHLIGHT3);},renderCellStyleHighlight4:function(h,g){c.addClass(g,this.Style.CSS_CELL_HIGHLIGHT4);},renderCellStyleToday:function(h,g){c.addClass(g,this.Style.CSS_CELL_TODAY);},renderCellStyleSelected:function(h,g){c.addClass(g,this.Style.CSS_CELL_SELECTED);},renderCellNotThisMonth:function(h,g){this.styleCellNotThisMonth(h,g);g.innerHTML=h.getDate();return f.STOP_RENDER;},styleCellNotThisMonth:function(h,g){YAHOO.util.Dom.addClass(g,this.Style.CSS_CELL_OOM);},renderBodyCellRestricted:function(h,g){c.addClass(g,this.Style.CSS_CELL);c.addClass(g,this.Style.CSS_CELL_RESTRICTED);g.innerHTML=h.getDate();return f.STOP_RENDER;},addMonths:function(i){var h=b.PAGEDATE.key,j=this.cfg.getProperty(h),g=d.add(j,d.MONTH,i);this.cfg.setProperty(h,g);this.resetRenderers();this.changePageEvent.fire(j,g);},subtractMonths:function(g){this.addMonths(-1*g);},addYears:function(i){var h=b.PAGEDATE.key,j=this.cfg.getProperty(h),g=d.add(j,d.YEAR,i);this.cfg.setProperty(h,g);this.resetRenderers();this.changePageEvent.fire(j,g);},subtractYears:function(g){this.addYears(-1*g);},nextMonth:function(){this.addMonths(1);},previousMonth:function(){this.addMonths(-1);},nextYear:function(){this.addYears(1);},previousYear:function(){this.addYears(-1);},reset:function(){this.cfg.resetProperty(b.SELECTED.key);this.cfg.resetProperty(b.PAGEDATE.key);this.resetEvent.fire();},clear:function(){this.cfg.setProperty(b.SELECTED.key,[]);
+this.cfg.setProperty(b.PAGEDATE.key,new Date(this.today.getTime()));this.clearEvent.fire();},select:function(i){var l=this._toFieldArray(i),h=[],k=[],m=b.SELECTED.key;for(var g=0;g<l.length;++g){var j=l[g];if(!this.isDateOOB(this._toDate(j))){if(h.length===0){this.beforeSelectEvent.fire();k=this.cfg.getProperty(m);}h.push(j);if(this._indexOfSelectedFieldArray(j)==-1){k[k.length]=j;}}}if(h.length>0){if(this.parent){this.parent.cfg.setProperty(m,k);}else{this.cfg.setProperty(m,k);}this.selectEvent.fire(h);}return this.getSelectedDates();},selectCell:function(j){var h=this.cells[j],n=this.cellDates[j],m=this._toDate(n),i=c.hasClass(h,this.Style.CSS_CELL_SELECTABLE);if(i){this.beforeSelectEvent.fire();var l=b.SELECTED.key;var k=this.cfg.getProperty(l);var g=n.concat();if(this._indexOfSelectedFieldArray(g)==-1){k[k.length]=g;}if(this.parent){this.parent.cfg.setProperty(l,k);}else{this.cfg.setProperty(l,k);}this.renderCellStyleSelected(m,h);this.selectEvent.fire([g]);this.doCellMouseOut.call(h,null,this);}return this.getSelectedDates();},deselect:function(k){var g=this._toFieldArray(k),j=[],m=[],n=b.SELECTED.key;for(var h=0;h<g.length;++h){var l=g[h];if(!this.isDateOOB(this._toDate(l))){if(j.length===0){this.beforeDeselectEvent.fire();m=this.cfg.getProperty(n);}j.push(l);var i=this._indexOfSelectedFieldArray(l);if(i!=-1){m.splice(i,1);}}}if(j.length>0){if(this.parent){this.parent.cfg.setProperty(n,m);}else{this.cfg.setProperty(n,m);}this.deselectEvent.fire(j);}return this.getSelectedDates();},deselectCell:function(k){var h=this.cells[k],n=this.cellDates[k],i=this._indexOfSelectedFieldArray(n);var j=c.hasClass(h,this.Style.CSS_CELL_SELECTABLE);if(j){this.beforeDeselectEvent.fire();var l=this.cfg.getProperty(b.SELECTED.key),m=this._toDate(n),g=n.concat();if(i>-1){if((this.cfg.getProperty(b.PAGEDATE.key).getMonth()==m.getMonth()&&this.cfg.getProperty(b.PAGEDATE.key).getFullYear()==m.getFullYear())||this.cfg.getProperty(b.OOM_SELECT.key)){c.removeClass(h,this.Style.CSS_CELL_SELECTED);}l.splice(i,1);}if(this.parent){this.parent.cfg.setProperty(b.SELECTED.key,l);}else{this.cfg.setProperty(b.SELECTED.key,l);}this.deselectEvent.fire([g]);}return this.getSelectedDates();},deselectAll:function(){this.beforeDeselectEvent.fire();var j=b.SELECTED.key,g=this.cfg.getProperty(j),h=g.length,i=g.concat();if(this.parent){this.parent.cfg.setProperty(j,[]);}else{this.cfg.setProperty(j,[]);}if(h>0){this.deselectEvent.fire(i);}return this.getSelectedDates();},_toFieldArray:function(h){var g=[];if(h instanceof Date){g=[[h.getFullYear(),h.getMonth()+1,h.getDate()]];}else{if(e.isString(h)){g=this._parseDates(h);}else{if(e.isArray(h)){for(var j=0;j<h.length;++j){var k=h[j];g[g.length]=[k.getFullYear(),k.getMonth()+1,k.getDate()];}}}}return g;},toDate:function(g){return this._toDate(g);},_toDate:function(g){if(g instanceof Date){return g;}else{return d.getDate(g[0],g[1]-1,g[2]);}},_fieldArraysAreEqual:function(i,h){var g=false;if(i[0]==h[0]&&i[1]==h[1]&&i[2]==h[2]){g=true;}return g;},_indexOfSelectedFieldArray:function(k){var j=-1,g=this.cfg.getProperty(b.SELECTED.key);for(var i=0;i<g.length;++i){var h=g[i];if(k[0]==h[0]&&k[1]==h[1]&&k[2]==h[2]){j=i;break;}}return j;},isDateOOM:function(g){return(g.getMonth()!=this.cfg.getProperty(b.PAGEDATE.key).getMonth());},isDateOOB:function(i){var j=this.cfg.getProperty(b.MINDATE.key),k=this.cfg.getProperty(b.MAXDATE.key),h=d;if(j){j=h.clearTime(j);}if(k){k=h.clearTime(k);}var g=new Date(i.getTime());g=h.clearTime(g);return((j&&g.getTime()<j.getTime())||(k&&g.getTime()>k.getTime()));},_parsePageDate:function(g){var j;if(g){if(g instanceof Date){j=d.findMonthStart(g);}else{var k,i,h;h=g.split(this.cfg.getProperty(b.DATE_FIELD_DELIMITER.key));k=parseInt(h[this.cfg.getProperty(b.MY_MONTH_POSITION.key)-1],10)-1;i=parseInt(h[this.cfg.getProperty(b.MY_YEAR_POSITION.key)-1],10)-this.Locale.YEAR_OFFSET;j=d.getDate(i,k,1);}}else{j=d.getDate(this.today.getFullYear(),this.today.getMonth(),1);}return j;},onBeforeSelect:function(){if(this.cfg.getProperty(b.MULTI_SELECT.key)===false){if(this.parent){this.parent.callChildFunction("clearAllBodyCellStyles",this.Style.CSS_CELL_SELECTED);this.parent.deselectAll();}else{this.clearAllBodyCellStyles(this.Style.CSS_CELL_SELECTED);this.deselectAll();}}},onSelect:function(g){},onBeforeDeselect:function(){},onDeselect:function(g){},onChangePage:function(){this.render();},onRender:function(){},onReset:function(){this.render();},onClear:function(){this.render();},validate:function(){return true;},_parseDate:function(j){var k=j.split(this.Locale.DATE_FIELD_DELIMITER),g;if(k.length==2){g=[k[this.Locale.MD_MONTH_POSITION-1],k[this.Locale.MD_DAY_POSITION-1]];g.type=f.MONTH_DAY;}else{g=[k[this.Locale.MDY_YEAR_POSITION-1]-this.Locale.YEAR_OFFSET,k[this.Locale.MDY_MONTH_POSITION-1],k[this.Locale.MDY_DAY_POSITION-1]];g.type=f.DATE;}for(var h=0;h<g.length;h++){g[h]=parseInt(g[h],10);}return g;},_parseDates:function(h){var o=[],n=h.split(this.Locale.DATE_DELIMITER);for(var m=0;m<n.length;++m){var l=n[m];if(l.indexOf(this.Locale.DATE_RANGE_DELIMITER)!=-1){var g=l.split(this.Locale.DATE_RANGE_DELIMITER),k=this._parseDate(g[0]),p=this._parseDate(g[1]),j=this._parseRange(k,p);o=o.concat(j);}else{var i=this._parseDate(l);o.push(i);}}return o;},_parseRange:function(g,k){var h=d.add(d.getDate(g[0],g[1]-1,g[2]),d.DAY,1),j=d.getDate(k[0],k[1]-1,k[2]),i=[];i.push(g);while(h.getTime()<=j.getTime()){i.push([h.getFullYear(),h.getMonth()+1,h.getDate()]);h=d.add(h,d.DAY,1);}return i;},resetRenderers:function(){this.renderStack=this._renderStack.concat();},removeRenderers:function(){this._renderStack=[];this.renderStack=[];},clearElement:function(g){g.innerHTML="&#160;";g.className="";},addRenderer:function(g,h){var k=this._parseDates(g);for(var j=0;j<k.length;++j){var l=k[j];if(l.length==2){if(l[0] instanceof Array){this._addRenderer(f.RANGE,l,h);}else{this._addRenderer(f.MONTH_DAY,l,h);}}else{if(l.length==3){this._addRenderer(f.DATE,l,h);}}}},_addRenderer:function(h,i,g){var j=[h,i,g];
+this.renderStack.unshift(j);this._renderStack=this.renderStack.concat();},addMonthRenderer:function(h,g){this._addRenderer(f.MONTH,[h],g);},addWeekdayRenderer:function(h,g){this._addRenderer(f.WEEKDAY,[h],g);},clearAllBodyCellStyles:function(g){for(var h=0;h<this.cells.length;++h){c.removeClass(this.cells[h],g);}},setMonth:function(i){var g=b.PAGEDATE.key,h=this.cfg.getProperty(g);h.setMonth(parseInt(i,10));this.cfg.setProperty(g,h);},setYear:function(h){var g=b.PAGEDATE.key,i=this.cfg.getProperty(g);i.setFullYear(parseInt(h,10)-this.Locale.YEAR_OFFSET);this.cfg.setProperty(g,i);},getSelectedDates:function(){var i=[],h=this.cfg.getProperty(b.SELECTED.key);for(var k=0;k<h.length;++k){var j=h[k];var g=d.getDate(j[0],j[1]-1,j[2]);i.push(g);}i.sort(function(m,l){return m-l;});return i;},hide:function(){if(this.beforeHideEvent.fire()){this.oDomContainer.style.display="none";this.hideEvent.fire();}},show:function(){if(this.beforeShowEvent.fire()){this.oDomContainer.style.display="block";this.showEvent.fire();}},browser:(function(){var g=navigator.userAgent.toLowerCase();if(g.indexOf("opera")!=-1){return"opera";}else{if(g.indexOf("msie 7")!=-1){return"ie7";}else{if(g.indexOf("msie")!=-1){return"ie";}else{if(g.indexOf("safari")!=-1){return"safari";}else{if(g.indexOf("gecko")!=-1){return"gecko";}else{return false;}}}}}})(),toString:function(){return"Calendar "+this.id;},destroy:function(){if(this.beforeDestroyEvent.fire()){var g=this;if(g.navigator){g.navigator.destroy();}if(g.cfg){g.cfg.destroy();}a.purgeElement(g.oDomContainer,true);c.removeClass(g.oDomContainer,g.Style.CSS_WITH_TITLE);c.removeClass(g.oDomContainer,g.Style.CSS_CONTAINER);c.removeClass(g.oDomContainer,g.Style.CSS_SINGLE);g.oDomContainer.innerHTML="";g.oDomContainer=null;g.cells=null;this.destroyEvent.fire();}}};YAHOO.widget.Calendar=f;YAHOO.widget.Calendar_Core=YAHOO.widget.Calendar;YAHOO.widget.Cal_Core=YAHOO.widget.Calendar;})();(function(){var d=YAHOO.util.Dom,f=YAHOO.widget.DateMath,a=YAHOO.util.Event,e=YAHOO.lang,g=YAHOO.widget.Calendar;function b(j,h,i){if(arguments.length>0){this.init.apply(this,arguments);}}b.DEFAULT_CONFIG=b._DEFAULT_CONFIG=g.DEFAULT_CONFIG;b.DEFAULT_CONFIG.PAGES={key:"pages",value:2};var c=b.DEFAULT_CONFIG;b.prototype={init:function(k,i,j){var h=this._parseArgs(arguments);k=h.id;i=h.container;j=h.config;this.oDomContainer=d.get(i);if(!this.oDomContainer.id){this.oDomContainer.id=d.generateId();}if(!k){k=this.oDomContainer.id+"_t";}this.id=k;this.containerId=this.oDomContainer.id;this.initEvents();this.initStyles();this.pages=[];d.addClass(this.oDomContainer,b.CSS_CONTAINER);d.addClass(this.oDomContainer,b.CSS_MULTI_UP);this.cfg=new YAHOO.util.Config(this);this.Options={};this.Locale={};this.setupConfig();if(j){this.cfg.applyConfig(j,true);}this.cfg.fireQueue();},setupConfig:function(){var h=this.cfg;h.addProperty(c.PAGES.key,{value:c.PAGES.value,validator:h.checkNumber,handler:this.configPages});h.addProperty(c.YEAR_OFFSET.key,{value:c.YEAR_OFFSET.value,handler:this.delegateConfig,supercedes:c.YEAR_OFFSET.supercedes,suppressEvent:true});h.addProperty(c.TODAY.key,{value:new Date(c.TODAY.value.getTime()),supercedes:c.TODAY.supercedes,handler:this.configToday,suppressEvent:false});h.addProperty(c.PAGEDATE.key,{value:c.PAGEDATE.value||new Date(c.TODAY.value.getTime()),handler:this.configPageDate});h.addProperty(c.SELECTED.key,{value:[],handler:this.configSelected});h.addProperty(c.TITLE.key,{value:c.TITLE.value,handler:this.configTitle});h.addProperty(c.CLOSE.key,{value:c.CLOSE.value,handler:this.configClose});h.addProperty(c.IFRAME.key,{value:c.IFRAME.value,handler:this.configIframe,validator:h.checkBoolean});h.addProperty(c.MINDATE.key,{value:c.MINDATE.value,handler:this.delegateConfig});h.addProperty(c.MAXDATE.key,{value:c.MAXDATE.value,handler:this.delegateConfig});h.addProperty(c.MULTI_SELECT.key,{value:c.MULTI_SELECT.value,handler:this.delegateConfig,validator:h.checkBoolean});h.addProperty(c.OOM_SELECT.key,{value:c.OOM_SELECT.value,handler:this.delegateConfig,validator:h.checkBoolean});h.addProperty(c.START_WEEKDAY.key,{value:c.START_WEEKDAY.value,handler:this.delegateConfig,validator:h.checkNumber});h.addProperty(c.SHOW_WEEKDAYS.key,{value:c.SHOW_WEEKDAYS.value,handler:this.delegateConfig,validator:h.checkBoolean});h.addProperty(c.SHOW_WEEK_HEADER.key,{value:c.SHOW_WEEK_HEADER.value,handler:this.delegateConfig,validator:h.checkBoolean});h.addProperty(c.SHOW_WEEK_FOOTER.key,{value:c.SHOW_WEEK_FOOTER.value,handler:this.delegateConfig,validator:h.checkBoolean});h.addProperty(c.HIDE_BLANK_WEEKS.key,{value:c.HIDE_BLANK_WEEKS.value,handler:this.delegateConfig,validator:h.checkBoolean});h.addProperty(c.NAV_ARROW_LEFT.key,{value:c.NAV_ARROW_LEFT.value,handler:this.delegateConfig});h.addProperty(c.NAV_ARROW_RIGHT.key,{value:c.NAV_ARROW_RIGHT.value,handler:this.delegateConfig});h.addProperty(c.MONTHS_SHORT.key,{value:c.MONTHS_SHORT.value,handler:this.delegateConfig});h.addProperty(c.MONTHS_LONG.key,{value:c.MONTHS_LONG.value,handler:this.delegateConfig});h.addProperty(c.WEEKDAYS_1CHAR.key,{value:c.WEEKDAYS_1CHAR.value,handler:this.delegateConfig});h.addProperty(c.WEEKDAYS_SHORT.key,{value:c.WEEKDAYS_SHORT.value,handler:this.delegateConfig});h.addProperty(c.WEEKDAYS_MEDIUM.key,{value:c.WEEKDAYS_MEDIUM.value,handler:this.delegateConfig});h.addProperty(c.WEEKDAYS_LONG.key,{value:c.WEEKDAYS_LONG.value,handler:this.delegateConfig});h.addProperty(c.LOCALE_MONTHS.key,{value:c.LOCALE_MONTHS.value,handler:this.delegateConfig});h.addProperty(c.LOCALE_WEEKDAYS.key,{value:c.LOCALE_WEEKDAYS.value,handler:this.delegateConfig});h.addProperty(c.DATE_DELIMITER.key,{value:c.DATE_DELIMITER.value,handler:this.delegateConfig});h.addProperty(c.DATE_FIELD_DELIMITER.key,{value:c.DATE_FIELD_DELIMITER.value,handler:this.delegateConfig});h.addProperty(c.DATE_RANGE_DELIMITER.key,{value:c.DATE_RANGE_DELIMITER.value,handler:this.delegateConfig});h.addProperty(c.MY_MONTH_POSITION.key,{value:c.MY_MONTH_POSITION.value,handler:this.delegateConfig,validator:h.checkNumber});
+h.addProperty(c.MY_YEAR_POSITION.key,{value:c.MY_YEAR_POSITION.value,handler:this.delegateConfig,validator:h.checkNumber});h.addProperty(c.MD_MONTH_POSITION.key,{value:c.MD_MONTH_POSITION.value,handler:this.delegateConfig,validator:h.checkNumber});h.addProperty(c.MD_DAY_POSITION.key,{value:c.MD_DAY_POSITION.value,handler:this.delegateConfig,validator:h.checkNumber});h.addProperty(c.MDY_MONTH_POSITION.key,{value:c.MDY_MONTH_POSITION.value,handler:this.delegateConfig,validator:h.checkNumber});h.addProperty(c.MDY_DAY_POSITION.key,{value:c.MDY_DAY_POSITION.value,handler:this.delegateConfig,validator:h.checkNumber});h.addProperty(c.MDY_YEAR_POSITION.key,{value:c.MDY_YEAR_POSITION.value,handler:this.delegateConfig,validator:h.checkNumber});h.addProperty(c.MY_LABEL_MONTH_POSITION.key,{value:c.MY_LABEL_MONTH_POSITION.value,handler:this.delegateConfig,validator:h.checkNumber});h.addProperty(c.MY_LABEL_YEAR_POSITION.key,{value:c.MY_LABEL_YEAR_POSITION.value,handler:this.delegateConfig,validator:h.checkNumber});h.addProperty(c.MY_LABEL_MONTH_SUFFIX.key,{value:c.MY_LABEL_MONTH_SUFFIX.value,handler:this.delegateConfig});h.addProperty(c.MY_LABEL_YEAR_SUFFIX.key,{value:c.MY_LABEL_YEAR_SUFFIX.value,handler:this.delegateConfig});h.addProperty(c.NAV.key,{value:c.NAV.value,handler:this.configNavigator});h.addProperty(c.STRINGS.key,{value:c.STRINGS.value,handler:this.configStrings,validator:function(i){return e.isObject(i);},supercedes:c.STRINGS.supercedes});},initEvents:function(){var j=this,l="Event",m=YAHOO.util.CustomEvent;var i=function(o,s,n){for(var r=0;r<j.pages.length;++r){var q=j.pages[r];q[this.type+l].subscribe(o,s,n);}};var h=function(n,r){for(var q=0;q<j.pages.length;++q){var o=j.pages[q];o[this.type+l].unsubscribe(n,r);}};var k=g._EVENT_TYPES;j.beforeSelectEvent=new m(k.BEFORE_SELECT);j.beforeSelectEvent.subscribe=i;j.beforeSelectEvent.unsubscribe=h;j.selectEvent=new m(k.SELECT);j.selectEvent.subscribe=i;j.selectEvent.unsubscribe=h;j.beforeDeselectEvent=new m(k.BEFORE_DESELECT);j.beforeDeselectEvent.subscribe=i;j.beforeDeselectEvent.unsubscribe=h;j.deselectEvent=new m(k.DESELECT);j.deselectEvent.subscribe=i;j.deselectEvent.unsubscribe=h;j.changePageEvent=new m(k.CHANGE_PAGE);j.changePageEvent.subscribe=i;j.changePageEvent.unsubscribe=h;j.beforeRenderEvent=new m(k.BEFORE_RENDER);j.beforeRenderEvent.subscribe=i;j.beforeRenderEvent.unsubscribe=h;j.renderEvent=new m(k.RENDER);j.renderEvent.subscribe=i;j.renderEvent.unsubscribe=h;j.resetEvent=new m(k.RESET);j.resetEvent.subscribe=i;j.resetEvent.unsubscribe=h;j.clearEvent=new m(k.CLEAR);j.clearEvent.subscribe=i;j.clearEvent.unsubscribe=h;j.beforeShowEvent=new m(k.BEFORE_SHOW);j.showEvent=new m(k.SHOW);j.beforeHideEvent=new m(k.BEFORE_HIDE);j.hideEvent=new m(k.HIDE);j.beforeShowNavEvent=new m(k.BEFORE_SHOW_NAV);j.showNavEvent=new m(k.SHOW_NAV);j.beforeHideNavEvent=new m(k.BEFORE_HIDE_NAV);j.hideNavEvent=new m(k.HIDE_NAV);j.beforeRenderNavEvent=new m(k.BEFORE_RENDER_NAV);j.renderNavEvent=new m(k.RENDER_NAV);j.beforeDestroyEvent=new m(k.BEFORE_DESTROY);j.destroyEvent=new m(k.DESTROY);},configPages:function(u,s,n){var l=s[0],j=c.PAGEDATE.key,x="_",m,o=null,t="groupcal",w="first-of-type",k="last-of-type";for(var i=0;i<l;++i){var v=this.id+x+i,r=this.containerId+x+i,q=this.cfg.getConfig();q.close=false;q.title=false;q.navigator=null;if(i>0){m=new Date(o);this._setMonthOnDate(m,m.getMonth()+i);q.pageDate=m;}var h=this.constructChild(v,r,q);d.removeClass(h.oDomContainer,this.Style.CSS_SINGLE);d.addClass(h.oDomContainer,t);if(i===0){o=h.cfg.getProperty(j);d.addClass(h.oDomContainer,w);}if(i==(l-1)){d.addClass(h.oDomContainer,k);}h.parent=this;h.index=i;this.pages[this.pages.length]=h;}},configPageDate:function(o,n,l){var j=n[0],m;var k=c.PAGEDATE.key;for(var i=0;i<this.pages.length;++i){var h=this.pages[i];if(i===0){m=h._parsePageDate(j);h.cfg.setProperty(k,m);}else{var q=new Date(m);this._setMonthOnDate(q,q.getMonth()+i);h.cfg.setProperty(k,q);}}},configSelected:function(j,h,l){var k=c.SELECTED.key;this.delegateConfig(j,h,l);var i=(this.pages.length>0)?this.pages[0].cfg.getProperty(k):[];this.cfg.setProperty(k,i,true);},delegateConfig:function(i,h,l){var m=h[0];var k;for(var j=0;j<this.pages.length;j++){k=this.pages[j];k.cfg.setProperty(i,m);}},setChildFunction:function(k,i){var h=this.cfg.getProperty(c.PAGES.key);for(var j=0;j<h;++j){this.pages[j][k]=i;}},callChildFunction:function(m,i){var h=this.cfg.getProperty(c.PAGES.key);for(var l=0;l<h;++l){var k=this.pages[l];if(k[m]){var j=k[m];j.call(k,i);}}},constructChild:function(k,i,j){var h=document.getElementById(i);if(!h){h=document.createElement("div");h.id=i;this.oDomContainer.appendChild(h);}return new g(k,i,j);},setMonth:function(l){l=parseInt(l,10);var m;var i=c.PAGEDATE.key;for(var k=0;k<this.pages.length;++k){var j=this.pages[k];var h=j.cfg.getProperty(i);if(k===0){m=h.getFullYear();}else{h.setFullYear(m);}this._setMonthOnDate(h,l+k);j.cfg.setProperty(i,h);}},setYear:function(j){var i=c.PAGEDATE.key;j=parseInt(j,10);for(var l=0;l<this.pages.length;++l){var k=this.pages[l];var h=k.cfg.getProperty(i);if((h.getMonth()+1)==1&&l>0){j+=1;}k.setYear(j);}},render:function(){this.renderHeader();for(var i=0;i<this.pages.length;++i){var h=this.pages[i];h.render();}this.renderFooter();},select:function(h){for(var j=0;j<this.pages.length;++j){var i=this.pages[j];i.select(h);}return this.getSelectedDates();},selectCell:function(h){for(var j=0;j<this.pages.length;++j){var i=this.pages[j];i.selectCell(h);}return this.getSelectedDates();},deselect:function(h){for(var j=0;j<this.pages.length;++j){var i=this.pages[j];i.deselect(h);}return this.getSelectedDates();},deselectAll:function(){for(var i=0;i<this.pages.length;++i){var h=this.pages[i];h.deselectAll();}return this.getSelectedDates();},deselectCell:function(h){for(var j=0;j<this.pages.length;++j){var i=this.pages[j];i.deselectCell(h);}return this.getSelectedDates();},reset:function(){for(var i=0;i<this.pages.length;++i){var h=this.pages[i];h.reset();}},clear:function(){for(var i=0;
+i<this.pages.length;++i){var h=this.pages[i];h.clear();}this.cfg.setProperty(c.SELECTED.key,[]);this.cfg.setProperty(c.PAGEDATE.key,new Date(this.pages[0].today.getTime()));this.render();},nextMonth:function(){for(var i=0;i<this.pages.length;++i){var h=this.pages[i];h.nextMonth();}},previousMonth:function(){for(var i=this.pages.length-1;i>=0;--i){var h=this.pages[i];h.previousMonth();}},nextYear:function(){for(var i=0;i<this.pages.length;++i){var h=this.pages[i];h.nextYear();}},previousYear:function(){for(var i=0;i<this.pages.length;++i){var h=this.pages[i];h.previousYear();}},getSelectedDates:function(){var j=[];var i=this.cfg.getProperty(c.SELECTED.key);for(var l=0;l<i.length;++l){var k=i[l];var h=f.getDate(k[0],k[1]-1,k[2]);j.push(h);}j.sort(function(n,m){return n-m;});return j;},addRenderer:function(h,i){for(var k=0;k<this.pages.length;++k){var j=this.pages[k];j.addRenderer(h,i);}},addMonthRenderer:function(k,h){for(var j=0;j<this.pages.length;++j){var i=this.pages[j];i.addMonthRenderer(k,h);}},addWeekdayRenderer:function(i,h){for(var k=0;k<this.pages.length;++k){var j=this.pages[k];j.addWeekdayRenderer(i,h);}},removeRenderers:function(){this.callChildFunction("removeRenderers");},renderHeader:function(){},renderFooter:function(){},addMonths:function(h){this.callChildFunction("addMonths",h);},subtractMonths:function(h){this.callChildFunction("subtractMonths",h);},addYears:function(h){this.callChildFunction("addYears",h);},subtractYears:function(h){this.callChildFunction("subtractYears",h);},getCalendarPage:function(l){var o=null;if(l){var p=l.getFullYear(),k=l.getMonth();var j=this.pages;for(var n=0;n<j.length;++n){var h=j[n].cfg.getProperty("pagedate");if(h.getFullYear()===p&&h.getMonth()===k){o=j[n];break;}}}return o;},_setMonthOnDate:function(i,j){if(YAHOO.env.ua.webkit&&YAHOO.env.ua.webkit<420&&(j<0||j>11)){var h=f.add(i,f.MONTH,j-i.getMonth());i.setTime(h.getTime());}else{i.setMonth(j);}},_fixWidth:function(){var h=0;for(var j=0;j<this.pages.length;++j){var i=this.pages[j];h+=i.oDomContainer.offsetWidth;}if(h>0){this.oDomContainer.style.width=h+"px";}},toString:function(){return"CalendarGroup "+this.id;},destroy:function(){if(this.beforeDestroyEvent.fire()){var k=this;if(k.navigator){k.navigator.destroy();}if(k.cfg){k.cfg.destroy();}a.purgeElement(k.oDomContainer,true);d.removeClass(k.oDomContainer,b.CSS_CONTAINER);d.removeClass(k.oDomContainer,b.CSS_MULTI_UP);for(var j=0,h=k.pages.length;j<h;j++){k.pages[j].destroy();k.pages[j]=null;}k.oDomContainer.innerHTML="";k.oDomContainer=null;this.destroyEvent.fire();}}};b.CSS_CONTAINER="yui-calcontainer";b.CSS_MULTI_UP="multi";b.CSS_2UPTITLE="title";b.CSS_2UPCLOSE="close-icon";YAHOO.lang.augmentProto(b,g,"buildDayLabel","buildMonthLabel","renderOutOfBoundsDate","renderRowHeader","renderRowFooter","renderCellDefault","styleCellDefault","renderCellStyleHighlight1","renderCellStyleHighlight2","renderCellStyleHighlight3","renderCellStyleHighlight4","renderCellStyleToday","renderCellStyleSelected","renderCellNotThisMonth","styleCellNotThisMonth","renderBodyCellRestricted","initStyles","configTitle","configClose","configIframe","configStrings","configToday","configNavigator","createTitleBar","createCloseButton","removeTitleBar","removeCloseButton","hide","show","toDate","_toDate","_parseArgs","browser");YAHOO.widget.CalGrp=b;YAHOO.widget.CalendarGroup=b;YAHOO.widget.Calendar2up=function(j,h,i){this.init(j,h,i);};YAHOO.extend(YAHOO.widget.Calendar2up,b);YAHOO.widget.Cal2up=YAHOO.widget.Calendar2up;})();YAHOO.widget.CalendarNavigator=function(a){this.init(a);};(function(){var a=YAHOO.widget.CalendarNavigator;a.CLASSES={NAV:"yui-cal-nav",NAV_VISIBLE:"yui-cal-nav-visible",MASK:"yui-cal-nav-mask",YEAR:"yui-cal-nav-y",MONTH:"yui-cal-nav-m",BUTTONS:"yui-cal-nav-b",BUTTON:"yui-cal-nav-btn",ERROR:"yui-cal-nav-e",YEAR_CTRL:"yui-cal-nav-yc",MONTH_CTRL:"yui-cal-nav-mc",INVALID:"yui-invalid",DEFAULT:"yui-default"};a.DEFAULT_CONFIG={strings:{month:"Month",year:"Year",submit:"Okay",cancel:"Cancel",invalidYear:"Year needs to be a number"},monthFormat:YAHOO.widget.Calendar.LONG,initialFocus:"year"};a._DEFAULT_CFG=a.DEFAULT_CONFIG;a.ID_SUFFIX="_nav";a.MONTH_SUFFIX="_month";a.YEAR_SUFFIX="_year";a.ERROR_SUFFIX="_error";a.CANCEL_SUFFIX="_cancel";a.SUBMIT_SUFFIX="_submit";a.YR_MAX_DIGITS=4;a.YR_MINOR_INC=1;a.YR_MAJOR_INC=10;a.UPDATE_DELAY=50;a.YR_PATTERN=/^\d+$/;a.TRIM=/^\s*(.*?)\s*$/;})();YAHOO.widget.CalendarNavigator.prototype={id:null,cal:null,navEl:null,maskEl:null,yearEl:null,monthEl:null,errorEl:null,submitEl:null,cancelEl:null,firstCtrl:null,lastCtrl:null,_doc:null,_year:null,_month:0,__rendered:false,init:function(a){var c=a.oDomContainer;this.cal=a;this.id=c.id+YAHOO.widget.CalendarNavigator.ID_SUFFIX;this._doc=c.ownerDocument;var b=YAHOO.env.ua.ie;this.__isIEQuirks=(b&&((b<=6)||(this._doc.compatMode=="BackCompat")));},show:function(){var a=YAHOO.widget.CalendarNavigator.CLASSES;if(this.cal.beforeShowNavEvent.fire()){if(!this.__rendered){this.render();}this.clearErrors();this._updateMonthUI();this._updateYearUI();this._show(this.navEl,true);this.setInitialFocus();this.showMask();YAHOO.util.Dom.addClass(this.cal.oDomContainer,a.NAV_VISIBLE);this.cal.showNavEvent.fire();}},hide:function(){var a=YAHOO.widget.CalendarNavigator.CLASSES;if(this.cal.beforeHideNavEvent.fire()){this._show(this.navEl,false);this.hideMask();YAHOO.util.Dom.removeClass(this.cal.oDomContainer,a.NAV_VISIBLE);this.cal.hideNavEvent.fire();}},showMask:function(){this._show(this.maskEl,true);if(this.__isIEQuirks){this._syncMask();}},hideMask:function(){this._show(this.maskEl,false);},getMonth:function(){return this._month;},getYear:function(){return this._year;},setMonth:function(a){if(a>=0&&a<12){this._month=a;}this._updateMonthUI();},setYear:function(b){var a=YAHOO.widget.CalendarNavigator.YR_PATTERN;if(YAHOO.lang.isNumber(b)&&a.test(b+"")){this._year=b;}this._updateYearUI();},render:function(){this.cal.beforeRenderNavEvent.fire();if(!this.__rendered){this.createNav();this.createMask();this.applyListeners();
+this.__rendered=true;}this.cal.renderNavEvent.fire();},createNav:function(){var b=YAHOO.widget.CalendarNavigator;var c=this._doc;var e=c.createElement("div");e.className=b.CLASSES.NAV;var a=this.renderNavContents([]);e.innerHTML=a.join("");this.cal.oDomContainer.appendChild(e);this.navEl=e;this.yearEl=c.getElementById(this.id+b.YEAR_SUFFIX);this.monthEl=c.getElementById(this.id+b.MONTH_SUFFIX);this.errorEl=c.getElementById(this.id+b.ERROR_SUFFIX);this.submitEl=c.getElementById(this.id+b.SUBMIT_SUFFIX);this.cancelEl=c.getElementById(this.id+b.CANCEL_SUFFIX);if(YAHOO.env.ua.gecko&&this.yearEl&&this.yearEl.type=="text"){this.yearEl.setAttribute("autocomplete","off");}this._setFirstLastElements();},createMask:function(){var b=YAHOO.widget.CalendarNavigator.CLASSES;var a=this._doc.createElement("div");a.className=b.MASK;this.cal.oDomContainer.appendChild(a);this.maskEl=a;},_syncMask:function(){var b=this.cal.oDomContainer;if(b&&this.maskEl){var a=YAHOO.util.Dom.getRegion(b);YAHOO.util.Dom.setStyle(this.maskEl,"width",a.right-a.left+"px");YAHOO.util.Dom.setStyle(this.maskEl,"height",a.bottom-a.top+"px");}},renderNavContents:function(a){var c=YAHOO.widget.CalendarNavigator,d=c.CLASSES,b=a;b[b.length]='<div class="'+d.MONTH+'">';this.renderMonth(b);b[b.length]="</div>";b[b.length]='<div class="'+d.YEAR+'">';this.renderYear(b);b[b.length]="</div>";b[b.length]='<div class="'+d.BUTTONS+'">';this.renderButtons(b);b[b.length]="</div>";b[b.length]='<div class="'+d.ERROR+'" id="'+this.id+c.ERROR_SUFFIX+'"></div>';return b;},renderMonth:function(c){var f=YAHOO.widget.CalendarNavigator,g=f.CLASSES;var j=this.id+f.MONTH_SUFFIX,e=this.__getCfg("monthFormat"),a=this.cal.cfg.getProperty((e==YAHOO.widget.Calendar.SHORT)?"MONTHS_SHORT":"MONTHS_LONG"),d=c;if(a&&a.length>0){d[d.length]='<label for="'+j+'">';d[d.length]=this.__getCfg("month",true);d[d.length]="</label>";d[d.length]='<select name="'+j+'" id="'+j+'" class="'+g.MONTH_CTRL+'">';for(var b=0;b<a.length;b++){d[d.length]='<option value="'+b+'">';d[d.length]=a[b];d[d.length]="</option>";}d[d.length]="</select>";}return d;},renderYear:function(b){var d=YAHOO.widget.CalendarNavigator,e=d.CLASSES;var f=this.id+d.YEAR_SUFFIX,a=d.YR_MAX_DIGITS,c=b;c[c.length]='<label for="'+f+'">';c[c.length]=this.__getCfg("year",true);c[c.length]="</label>";c[c.length]='<input type="text" name="'+f+'" id="'+f+'" class="'+e.YEAR_CTRL+'" maxlength="'+a+'"/>';return c;},renderButtons:function(a){var c=YAHOO.widget.CalendarNavigator.CLASSES;var b=a;b[b.length]='<span class="'+c.BUTTON+" "+c.DEFAULT+'">';b[b.length]='<button type="button" id="'+this.id+"_submit"+'">';b[b.length]=this.__getCfg("submit",true);b[b.length]="</button>";b[b.length]="</span>";b[b.length]='<span class="'+c.BUTTON+'">';b[b.length]='<button type="button" id="'+this.id+"_cancel"+'">';b[b.length]=this.__getCfg("cancel",true);b[b.length]="</button>";b[b.length]="</span>";return b;},applyListeners:function(){var b=YAHOO.util.Event;function a(){if(this.validate()){this.setYear(this._getYearFromUI());}}function c(){this.setMonth(this._getMonthFromUI());}b.on(this.submitEl,"click",this.submit,this,true);b.on(this.cancelEl,"click",this.cancel,this,true);b.on(this.yearEl,"blur",a,this,true);b.on(this.monthEl,"change",c,this,true);if(this.__isIEQuirks){YAHOO.util.Event.on(this.cal.oDomContainer,"resize",this._syncMask,this,true);}this.applyKeyListeners();},purgeListeners:function(){var a=YAHOO.util.Event;a.removeListener(this.submitEl,"click",this.submit);a.removeListener(this.cancelEl,"click",this.cancel);a.removeListener(this.yearEl,"blur");a.removeListener(this.monthEl,"change");if(this.__isIEQuirks){a.removeListener(this.cal.oDomContainer,"resize",this._syncMask);}this.purgeKeyListeners();},applyKeyListeners:function(){var d=YAHOO.util.Event,a=YAHOO.env.ua;var c=(a.ie||a.webkit)?"keydown":"keypress";var b=(a.ie||a.opera||a.webkit)?"keydown":"keypress";d.on(this.yearEl,"keypress",this._handleEnterKey,this,true);d.on(this.yearEl,c,this._handleDirectionKeys,this,true);d.on(this.lastCtrl,b,this._handleTabKey,this,true);d.on(this.firstCtrl,b,this._handleShiftTabKey,this,true);},purgeKeyListeners:function(){var d=YAHOO.util.Event,a=YAHOO.env.ua;var c=(a.ie||a.webkit)?"keydown":"keypress";var b=(a.ie||a.opera||a.webkit)?"keydown":"keypress";d.removeListener(this.yearEl,"keypress",this._handleEnterKey);d.removeListener(this.yearEl,c,this._handleDirectionKeys);d.removeListener(this.lastCtrl,b,this._handleTabKey);d.removeListener(this.firstCtrl,b,this._handleShiftTabKey);},submit:function(){if(this.validate()){this.hide();this.setMonth(this._getMonthFromUI());this.setYear(this._getYearFromUI());var b=this.cal;var a=YAHOO.widget.CalendarNavigator.UPDATE_DELAY;if(a>0){var c=this;window.setTimeout(function(){c._update(b);},a);}else{this._update(b);}}},_update:function(b){var a=YAHOO.widget.DateMath.getDate(this.getYear()-b.cfg.getProperty("YEAR_OFFSET"),this.getMonth(),1);b.cfg.setProperty("pagedate",a);b.render();},cancel:function(){this.hide();},validate:function(){if(this._getYearFromUI()!==null){this.clearErrors();return true;}else{this.setYearError();this.setError(this.__getCfg("invalidYear",true));return false;}},setError:function(a){if(this.errorEl){this.errorEl.innerHTML=a;this._show(this.errorEl,true);}},clearError:function(){if(this.errorEl){this.errorEl.innerHTML="";this._show(this.errorEl,false);}},setYearError:function(){YAHOO.util.Dom.addClass(this.yearEl,YAHOO.widget.CalendarNavigator.CLASSES.INVALID);},clearYearError:function(){YAHOO.util.Dom.removeClass(this.yearEl,YAHOO.widget.CalendarNavigator.CLASSES.INVALID);},clearErrors:function(){this.clearError();this.clearYearError();},setInitialFocus:function(){var a=this.submitEl,c=this.__getCfg("initialFocus");if(c&&c.toLowerCase){c=c.toLowerCase();if(c=="year"){a=this.yearEl;try{this.yearEl.select();}catch(b){}}else{if(c=="month"){a=this.monthEl;}}}if(a&&YAHOO.lang.isFunction(a.focus)){try{a.focus();}catch(d){}}},erase:function(){if(this.__rendered){this.purgeListeners();
+this.yearEl=null;this.monthEl=null;this.errorEl=null;this.submitEl=null;this.cancelEl=null;this.firstCtrl=null;this.lastCtrl=null;if(this.navEl){this.navEl.innerHTML="";}var b=this.navEl.parentNode;if(b){b.removeChild(this.navEl);}this.navEl=null;var a=this.maskEl.parentNode;if(a){a.removeChild(this.maskEl);}this.maskEl=null;this.__rendered=false;}},destroy:function(){this.erase();this._doc=null;this.cal=null;this.id=null;},_show:function(b,a){if(b){YAHOO.util.Dom.setStyle(b,"display",(a)?"block":"none");}},_getMonthFromUI:function(){if(this.monthEl){return this.monthEl.selectedIndex;}else{return 0;}},_getYearFromUI:function(){var b=YAHOO.widget.CalendarNavigator;var a=null;if(this.yearEl){var c=this.yearEl.value;c=c.replace(b.TRIM,"$1");if(b.YR_PATTERN.test(c)){a=parseInt(c,10);}}return a;},_updateYearUI:function(){if(this.yearEl&&this._year!==null){this.yearEl.value=this._year;}},_updateMonthUI:function(){if(this.monthEl){this.monthEl.selectedIndex=this._month;}},_setFirstLastElements:function(){this.firstCtrl=this.monthEl;this.lastCtrl=this.cancelEl;if(this.__isMac){if(YAHOO.env.ua.webkit&&YAHOO.env.ua.webkit<420){this.firstCtrl=this.monthEl;this.lastCtrl=this.yearEl;}if(YAHOO.env.ua.gecko){this.firstCtrl=this.yearEl;this.lastCtrl=this.yearEl;}}},_handleEnterKey:function(b){var a=YAHOO.util.KeyListener.KEY;if(YAHOO.util.Event.getCharCode(b)==a.ENTER){YAHOO.util.Event.preventDefault(b);this.submit();}},_handleDirectionKeys:function(h){var g=YAHOO.util.Event,a=YAHOO.util.KeyListener.KEY,d=YAHOO.widget.CalendarNavigator;var f=(this.yearEl.value)?parseInt(this.yearEl.value,10):null;if(isFinite(f)){var b=false;switch(g.getCharCode(h)){case a.UP:this.yearEl.value=f+d.YR_MINOR_INC;b=true;break;case a.DOWN:this.yearEl.value=Math.max(f-d.YR_MINOR_INC,0);b=true;break;case a.PAGE_UP:this.yearEl.value=f+d.YR_MAJOR_INC;b=true;break;case a.PAGE_DOWN:this.yearEl.value=Math.max(f-d.YR_MAJOR_INC,0);b=true;break;default:break;}if(b){g.preventDefault(h);try{this.yearEl.select();}catch(c){}}}},_handleTabKey:function(d){var c=YAHOO.util.Event,a=YAHOO.util.KeyListener.KEY;if(c.getCharCode(d)==a.TAB&&!d.shiftKey){try{c.preventDefault(d);this.firstCtrl.focus();}catch(b){}}},_handleShiftTabKey:function(d){var c=YAHOO.util.Event,a=YAHOO.util.KeyListener.KEY;if(d.shiftKey&&c.getCharCode(d)==a.TAB){try{c.preventDefault(d);this.lastCtrl.focus();}catch(b){}}},__getCfg:function(d,b){var c=YAHOO.widget.CalendarNavigator.DEFAULT_CONFIG;var a=this.cal.cfg.getProperty("navigator");if(b){return(a!==true&&a.strings&&a.strings[d])?a.strings[d]:c.strings[d];}else{return(a!==true&&a[d])?a[d]:c[d];}},__isMac:(navigator.userAgent.toLowerCase().indexOf("macintosh")!=-1)};YAHOO.register("calendar",YAHOO.widget.Calendar,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/carousel/carousel-min.js b/js/yui/carousel/carousel-min.js
new file mode 100644 (file)
index 0000000..ed4062b
--- /dev/null
+++ b/js/yui/carousel/carousel-min.js
@@ -0,0 +1,12 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){var Q="Carousel";YAHOO.widget.Carousel=function(u,t){YAHOO.widget.Carousel.superclass.constructor.call(this,u,t);};var V=YAHOO.widget.Carousel,g=YAHOO.util.Dom,e=YAHOO.util.Event,r=YAHOO.lang,U={},a=true,F="afterScroll",i="allItemsRemoved",d="beforeHide",K="beforePageChange",k="beforeScroll",Z="beforeShow",B="blur",Y="focus",c="hide",T="itemAdded",q="itemRemoved",R="itemReplaced",C="itemSelected",M="loadItems",J="navigationStateChange",j="pageChange",I="render",W="show",b="startAutoPlay",s="stopAutoPlay",L="uiUpdate";function H(t,u){var v;for(v in u){if(u.hasOwnProperty(v)){g.setStyle(t,v,u[v]);}}}function X(u,t){var v=document.createElement(u);t=t||{};if(t.className){g.addClass(v,t.className);}if(t.styles){H(v,t.styles);}if(t.parent){t.parent.appendChild(v);}if(t.id){v.setAttribute("id",t.id);}if(t.content){if(t.content.nodeName){v.appendChild(t.content);}else{v.innerHTML=t.content;}}return v;}function f(v,u,t){var x;if(!v){return 0;}function w(AA,z){var AB;if(z=="marginRight"&&(YAHOO.env.ua.webkit||(YAHOO.env.ua.ie&&YAHOO.env.ua.ie>=9))){AB=parseInt(g.getStyle(AA,"marginLeft"),10);}else{AB=parseInt(g.getStyle(AA,z),10);}return r.isNumber(AB)?AB:0;}function y(AA,z){var AB;if(z=="marginRight"&&YAHOO.env.ua.webkit){AB=parseFloat(g.getStyle(AA,"marginLeft"));}else{AB=parseFloat(g.getStyle(AA,z));}return r.isNumber(AB)?AB:0;}if(typeof t=="undefined"){t="int";}switch(u){case"height":x=v.offsetHeight;if(x>0){x+=w(v,"marginTop")+w(v,"marginBottom");}else{x=y(v,"height")+w(v,"marginTop")+w(v,"marginBottom")+w(v,"borderTopWidth")+w(v,"borderBottomWidth")+w(v,"paddingTop")+w(v,"paddingBottom");}break;case"width":x=v.offsetWidth;if(x>0){x+=w(v,"marginLeft")+w(v,"marginRight");}else{x=y(v,"width")+w(v,"marginLeft")+w(v,"marginRight")+w(v,"borderLeftWidth")+w(v,"borderRightWidth")+w(v,"paddingLeft")+w(v,"paddingRight");}break;default:if(t=="int"){x=w(v,u);}else{if(t=="float"){x=y(v,u);}else{x=g.getStyle(v,u);}}break;}return x;}function P(x){var w=this,y,v,u=0,t=false;if(w._itemAttrCache[x]){return w._itemAttrCache[x];}if(w._itemsTable.numItems===0){return 0;}v=w._findClosestSibling(-1);if(r.isUndefined(v)){return 0;}y=g.get(v.id);if(typeof x=="undefined"){t=w.get("isVertical");}else{t=x=="height";}if(t){u=f(y,"height");}else{u=f(y,"width");}if(u){w._itemAttrCache[x]=u;}return u;}function O(){var u=this,v,t;v=u.get("isVertical");t=P.call(u,v?"height":"width");return(t*u.get("revealAmount")/100);}function o(AC){var AI=this,AA=AI._cols,AG=AI._rows,y,z,AD,AE,x,w,AB,t,v,AF,AH={},u=AI._itemsTable;AD=AI.get("isVertical");z=P.call(AI,AD?"height":"width");v=O.call(AI);if(AG){y=this.getPageForItem(AC);if(AD){x=Math.floor(AC/AA);AF=x;AB=AF*z;AH.top=(AB+v)+"px";z=P.call(AI,"width");AE=AC%AA;AF=AE;t=AF*z;AH.left=t+"px";}else{AE=AC%AA;w=(y-1)*AA;AF=AE+w;t=AF*z;AH.left=(t+v)+"px";z=P.call(AI,"height");x=Math.floor(AC/AA);w=(y-1)*AG;AF=x-w;AB=AF*z;AH.top=AB+"px";}}else{if(AD){AH.left=0;AH.top=((AC*z)+v)+"px";}else{AH.top=0;AH.left=((AC*z)+v)+"px";}}return AH;}function D(u){var t=this.get("numVisible");return Math.floor(u/t)*t;}function l(x){var w=this,v=0,u=0,t=w.get("isVertical")?"height":"width";v=P.call(w,t);u=v*x;return u;}function h(t,u){u.scrollPageBackward();e.preventDefault(t);}function m(t,u){u.scrollPageForward();e.preventDefault(t);}function p(x,u){var AA=this,AC=AA.CLASSES,t,z=AA._firstItem,y=AA.get("numItems"),AB=AA.get("numVisible"),w=u,v=z+AB-1;if(w>=0&&w<y){if(!r.isUndefined(AA._itemsTable.items[w])){t=g.get(AA._itemsTable.items[w].id);if(t){g.removeClass(t,AC.SELECTED_ITEM);}}}if(r.isNumber(x)){x=parseInt(x,10);x=r.isNumber(x)?x:0;}else{x=z;}if(r.isUndefined(AA._itemsTable.items[x])){x=D.call(AA,x);AA.scrollTo(x);}if(!r.isUndefined(AA._itemsTable.items[x])){t=g.get(AA._itemsTable.items[x].id);if(t){g.addClass(t,AC.SELECTED_ITEM);}}if(x<z||x>v){x=D.call(AA,x);AA.scrollTo(x);}}function G(u){var v=this,t=v.get("navigation");if(r.isUndefined(t)){return;}if(r.isUndefined(u)){if(!r.isUndefined(t.prev)&&r.isArray(t.prev)&&!r.isUndefined(t.prev[0])){g.setStyle(t.prev[0],"visibility","visible");}if(!r.isUndefined(t.next)&&r.isArray(t.next)&&!r.isUndefined(t.next[0])){g.setStyle(t.next[0],"visibility","visible");}if(!r.isUndefined(v._pages)&&!r.isUndefined(v._pages.el)){g.setStyle(v._pages.el,"visibility","visible");}}else{if(!r.isUndefined(t.prev)&&r.isArray(t.prev)&&!r.isUndefined(t.prev[0])){g.setStyle(t.prev[0],"visibility","hidden");}if(!r.isUndefined(t.next)&&r.isArray(t.next)&&!r.isUndefined(t.next[0])){g.setStyle(t.next[0],"visibility","hidden");}if(!r.isUndefined(v._pages)&&!r.isUndefined(v._pages.el)){g.setStyle(v._pages.el,"visibility","hidden");}}}function n(){var v=false,y=this,u=y.CLASSES,x,t,w;if(!y._hasRendered){return;}t=y.get("navigation");w=y._firstItem+y.get("numVisible");if(t.prev){if(y.get("numItems")===0||y._firstItem===0){if(y.get("numItems")===0||!y.get("isCircular")){e.removeListener(t.prev,"click",h);g.addClass(t.prev,u.FIRST_NAV_DISABLED);for(x=0;x<y._navBtns.prev.length;x++){y._navBtns.prev[x].setAttribute("disabled","true");}y._prevEnabled=false;}else{v=!y._prevEnabled;}}else{v=!y._prevEnabled;}if(v){e.on(t.prev,"click",h,y);g.removeClass(t.prev,u.FIRST_NAV_DISABLED);for(x=0;x<y._navBtns.prev.length;x++){y._navBtns.prev[x].removeAttribute("disabled");}y._prevEnabled=true;}}v=false;if(t.next){if(w>=y.get("numItems")){if(!y.get("isCircular")){e.removeListener(t.next,"click",m);g.addClass(t.next,u.DISABLED);for(x=0;x<y._navBtns.next.length;x++){y._navBtns.next[x].setAttribute("disabled","true");}y._nextEnabled=false;}else{v=!y._nextEnabled;}}else{v=!y._nextEnabled;}if(v){e.on(t.next,"click",m,y);g.removeClass(t.next,u.DISABLED);for(x=0;x<y._navBtns.next.length;x++){y._navBtns.next[x].removeAttribute("disabled");}y._nextEnabled=true;}}y.fireEvent(J,{next:y._nextEnabled,prev:y._prevEnabled});}function S(v){var w=this,t,u;if(!w._hasRendered){return;}u=w.get("numVisible");if(!r.isNumber(v)){v=Math.floor(w.get("selectedItem")/u);}t=Math.ceil(w.get("numItems")/u);w._pages.num=t;
+w._pages.cur=v;if(t>w.CONFIG.MAX_PAGER_BUTTONS){w._updatePagerMenu();}else{w._updatePagerButtons();}}function N(t,u){switch(u){case"height":return f(t,"marginTop")+f(t,"marginBottom")+f(t,"paddingTop")+f(t,"paddingBottom")+f(t,"borderTopWidth")+f(t,"borderBottomWidth");case"width":return f(t,"marginLeft")+f(t,"marginRight")+f(t,"paddingLeft")+f(t,"paddingRight")+f(t,"borderLeftWidth")+f(t,"borderRightWidth");default:break;}return f(t,u);}function A(u){var t=this;if(!r.isObject(u)){return;}switch(u.ev){case T:t._syncUiForItemAdd(u);break;case q:t._syncUiForItemRemove(u);break;case R:t._syncUiForItemReplace(u);break;case M:t._syncUiForLazyLoading(u);break;}t.fireEvent(L);}function E(w,u){var y=this,x=y.get("currentPage"),v,t=y.get("numVisible");v=parseInt(y._firstItem/t,10);if(v!=x){y.setAttributeConfig("currentPage",{value:v});y.fireEvent(j,v);}if(y.get("selectOnScroll")){if(y.get("selectedItem")!=y._selectedItem){y.set("selectedItem",y._selectedItem);}}clearTimeout(y._autoPlayTimer);delete y._autoPlayTimer;if(y.isAutoPlayOn()){y.startAutoPlay();}y.fireEvent(F,{first:y._firstItem,last:u},y);}V.getById=function(t){return U[t]?U[t].object:false;};YAHOO.extend(V,YAHOO.util.Element,{_rows:null,_cols:null,_animObj:null,_carouselEl:null,_clipEl:null,_firstItem:0,_hasFocus:false,_hasRendered:false,_isAnimationInProgress:false,_isAutoPlayInProgress:false,_itemsTable:null,_navBtns:null,_navEl:null,_nextEnabled:true,_pages:null,_pagination:null,_prevEnabled:true,_recomputeSize:true,_itemAttrCache:null,CLASSES:{BUTTON:"yui-carousel-button",CAROUSEL:"yui-carousel",CAROUSEL_EL:"yui-carousel-element",CONTAINER:"yui-carousel-container",CONTENT:"yui-carousel-content",DISABLED:"yui-carousel-button-disabled",FIRST_NAV:" yui-carousel-first-button",FIRST_NAV_DISABLED:"yui-carousel-first-button-disabled",FIRST_PAGE:"yui-carousel-nav-first-page",FOCUSSED_BUTTON:"yui-carousel-button-focus",HORIZONTAL:"yui-carousel-horizontal",ITEM_LOADING:"yui-carousel-item-loading",MIN_WIDTH:"yui-carousel-min-width",NAVIGATION:"yui-carousel-nav",NEXT_NAV:" yui-carousel-next-button",NEXT_PAGE:"yui-carousel-next",NAV_CONTAINER:"yui-carousel-buttons",PAGER_ITEM:"yui-carousel-pager-item",PAGINATION:"yui-carousel-pagination",PAGE_FOCUS:"yui-carousel-nav-page-focus",PREV_PAGE:"yui-carousel-prev",ITEM:"yui-carousel-item",SELECTED_ITEM:"yui-carousel-item-selected",SELECTED_NAV:"yui-carousel-nav-page-selected",VERTICAL:"yui-carousel-vertical",MULTI_ROW:"yui-carousel-multi-row",ROW:"yui-carousel-row",VERTICAL_CONTAINER:"yui-carousel-vertical-container",VISIBLE:"yui-carousel-visible"},CONFIG:{FIRST_VISIBLE:0,HORZ_MIN_WIDTH:180,MAX_PAGER_BUTTONS:5,VERT_MIN_WIDTH:115,NUM_VISIBLE:3},STRINGS:{ITEM_LOADING_CONTENT:"Loading",NEXT_BUTTON_TEXT:"Next Page",PAGER_PREFIX_TEXT:"Go to page ",PREVIOUS_BUTTON_TEXT:"Previous Page"},addItem:function(AA,u){var z=this,w,v,t,AB=0,y,x=z.get("numItems");if(!AA){return false;}if(r.isString(AA)||AA.nodeName){v=AA.nodeName?AA.innerHTML:AA;}else{if(r.isObject(AA)){v=AA.content;}else{return false;}}w=z.CLASSES.ITEM+(AA.className?" "+AA.className:"");t=AA.id?AA.id:g.generateId();if(r.isUndefined(u)){z._itemsTable.items.push({item:v,className:w,id:t});y=z._itemsTable.items.length-1;}else{if(u<0||u>x){return false;}if(!z._itemsTable.items[u]){z._itemsTable.items[u]=undefined;AB=1;}z._itemsTable.items.splice(u,AB,{item:v,className:w,id:t});}z._itemsTable.numItems++;if(x<z._itemsTable.items.length){z.set("numItems",z._itemsTable.items.length);}z.fireEvent(T,{pos:u,ev:T,newPos:y});return true;},addItems:function(t){var u,w,v=true;if(!r.isArray(t)){return false;}a=false;for(u=0,w=t.length;u<w;u++){if(this.addItem(t[u][0],t[u][1])===false){v=false;}}a=true;this._syncUiItems();return v;},blur:function(){this._carouselEl.blur();this.fireEvent(B);},clearItems:function(){var t=this,u=t.get("numItems");while(u>0){if(!t.removeItem(0)){}if(t._itemsTable.numItems===0){t.set("numItems",0);break;}u--;}t.fireEvent(i);},focus:function(){var AC=this,x,y,z,w,AB,AD,u,v,t;if(!AC._hasRendered){return;}if(AC.isAnimating()){return;}t=AC.get("selectedItem");AD=AC.get("numVisible");u=AC.get("selectOnScroll");v=(t>=0)?AC.getItem(t):null;x=AC.get("firstVisible");AB=x+AD-1;z=(t<x||t>AB);y=(v&&v.id)?g.get(v.id):null;w=AC._itemsTable;if(!u&&z){y=(w&&w.items&&w.items[x])?g.get(w.items[x].id):null;}if(y){try{y.focus();}catch(AA){}}AC.fireEvent(Y);},hide:function(){var t=this;if(t.fireEvent(d)!==false){t.removeClass(t.CLASSES.VISIBLE);G.call(t,false);t.fireEvent(c);}},init:function(w,u){var x=this,t=w,y=false,v;if(!w){return;}x._hasRendered=false;x._navBtns={prev:[],next:[]};x._pages={el:null,num:0,cur:0};x._pagination={};x._itemAttrCache={};x._itemsTable={loading:{},numItems:0,items:[],size:0};if(r.isString(w)){w=g.get(w);}else{if(!w.nodeName){return;}}V.superclass.init.call(x,w,u);v=x.get("selectedItem");if(v>0){x.set("firstVisible",D.call(x,v));}if(w){if(!w.id){w.setAttribute("id",g.generateId());}y=x._parseCarousel(w);if(!y){x._createCarousel(t);}}else{w=x._createCarousel(t);}t=w.id;x.initEvents();if(y){x._parseCarouselItems();}if(v>0){p.call(x,v,0);}if(!u||typeof u.isVertical=="undefined"){x.set("isVertical",false);}x._parseCarouselNavigation(w);x._navEl=x._setupCarouselNavigation();U[t]={object:x};x._loadItems(Math.min(x.get("firstVisible")+x.get("numVisible"),x.get("numItems"))-1);},initAttributes:function(t){var u=this;t=t||{};V.superclass.initAttributes.call(u,t);u.setAttributeConfig("carouselEl",{validator:r.isString,value:t.carouselEl||"OL"});u.setAttributeConfig("carouselItemEl",{validator:r.isString,value:t.carouselItemEl||"LI"});u.setAttributeConfig("currentPage",{readOnly:true,value:0});u.setAttributeConfig("firstVisible",{method:u._setFirstVisible,validator:u._validateFirstVisible,value:t.firstVisible||u.CONFIG.FIRST_VISIBLE});u.setAttributeConfig("selectOnScroll",{validator:r.isBoolean,value:t.selectOnScroll||true});u.setAttributeConfig("numVisible",{setter:u._numVisibleSetter,method:u._setNumVisible,validator:u._validateNumVisible,value:t.numVisible||u.CONFIG.NUM_VISIBLE});
+u.setAttributeConfig("numItems",{method:u._setNumItems,validator:u._validateNumItems,value:u._itemsTable.numItems});u.setAttributeConfig("scrollIncrement",{validator:u._validateScrollIncrement,value:t.scrollIncrement||1});u.setAttributeConfig("selectedItem",{setter:u._selectedItemSetter,method:u._setSelectedItem,validator:r.isNumber,value:-1});u.setAttributeConfig("revealAmount",{method:u._setRevealAmount,validator:u._validateRevealAmount,value:t.revealAmount||0});u.setAttributeConfig("isCircular",{validator:r.isBoolean,value:t.isCircular||false});u.setAttributeConfig("isVertical",{method:u._setOrientation,validator:r.isBoolean,value:t.isVertical||false});u.setAttributeConfig("navigation",{method:u._setNavigation,validator:u._validateNavigation,value:t.navigation||{prev:null,next:null,page:null}});u.setAttributeConfig("animation",{validator:u._validateAnimation,value:t.animation||{speed:0,effect:null}});u.setAttributeConfig("autoPlay",{validator:r.isNumber,value:t.autoPlay||0});u.setAttributeConfig("autoPlayInterval",{validator:r.isNumber,value:t.autoPlayInterval||0});u.setAttributeConfig("numPages",{readOnly:true,getter:u._getNumPages});u.setAttributeConfig("lastVisible",{readOnly:true,getter:u._getLastVisible});},initEvents:function(){var v=this,u=v.CLASSES,t;v.on("keydown",v._keyboardEventHandler);v.on(F,n);v.on(T,A);v.on(q,A);v.on(R,A);v.on(C,v._focusHandler);v.on(M,A);v.on(i,function(w){v.scrollTo(0);n.call(v);S.call(v);});v.on(j,S,v);v.on(I,function(w){if(v.get("selectedItem")===null||v.get("selectedItem")<=0){v.set("selectedItem",v.get("firstVisible"));}n.call(v,w);S.call(v,w);v._setClipContainerSize();v.show();});v.on("selectedItemChange",function(w){p.call(v,w.newValue,w.prevValue);if(w.newValue>=0){v._updateTabIndex(v.getElementForItem(w.newValue));}v.fireEvent(C,w.newValue);});v.on(L,function(w){n.call(v,w);S.call(v,w);});v.on("firstVisibleChange",function(w){if(!v.get("selectOnScroll")){if(w.newValue>=0){v._updateTabIndex(v.getElementForItem(w.newValue));}}});v.on("click",function(w){if(v.isAutoPlayOn()){v.stopAutoPlay();}v._itemClickHandler(w);v._pagerClickHandler(w);});e.onFocus(v.get("element"),function(w,y){var x=e.getTarget(w);if(x&&x.nodeName.toUpperCase()=="A"&&g.getAncestorByClassName(x,u.NAVIGATION)){if(t){g.removeClass(t,u.PAGE_FOCUS);}t=x.parentNode;g.addClass(t,u.PAGE_FOCUS);}else{if(t){g.removeClass(t,u.PAGE_FOCUS);}}y._hasFocus=true;y._updateNavButtons(e.getTarget(w),true);},v);e.onBlur(v.get("element"),function(w,x){x._hasFocus=false;x._updateNavButtons(e.getTarget(w),false);},v);},isAnimating:function(){return this._isAnimationInProgress;},isAutoPlayOn:function(){return this._isAutoPlayInProgress;},getElementForItem:function(t){var u=this;if(t<0||t>=u.get("numItems")){return null;}if(u._itemsTable.items[t]){return g.get(u._itemsTable.items[t].id);}return null;},getElementForItems:function(){var v=this,u=[],t;for(t=0;t<v._itemsTable.numItems;t++){u.push(v.getElementForItem(t));}return u;},getItem:function(t){var u=this;if(t<0||t>=u.get("numItems")){return null;}if(u._itemsTable.items.length>t){if(!r.isUndefined(u._itemsTable.items[t])){return u._itemsTable.items[t];}}return null;},getItems:function(){return this._itemsTable.items;},getLoadingItems:function(){return this._itemsTable.loading;},getRows:function(){return this._rows;},getCols:function(){return this._cols;},getItemPositionById:function(y){var w=this,x=w.get("numItems"),u=0,t=w._itemsTable.items,v;while(u<x){v=t[u]||{};if(v.id==y){return u;}u++;}return -1;},getVisibleItems:function(){var v=this,t=v.get("firstVisible"),w=t+v.get("numVisible"),u=[];while(t<w){u.push(v.getElementForItem(t));t++;}return u;},removeItem:function(v){var x=this,t=x._itemsTable,w,u=x.get("numItems");if(v<0||v>=u){return false;}w=t.items.splice(v,1);if(w&&w.length==1){if(t.numItems){t.numItems--;}x.set("numItems",u-1);x.fireEvent(q,{item:w[0],pos:v,ev:q});return true;}return false;},replaceItem:function(AB,w){var AA=this,y,x,v,z=AA.get("numItems"),u,t=AB;if(!AB){return false;}if(r.isString(AB)||AB.nodeName){x=AB.nodeName?AB.innerHTML:AB;}else{if(r.isObject(AB)){x=AB.content;}else{return false;}}if(r.isUndefined(w)){return false;}else{if(w<0||w>=z){return false;}u=AA._itemsTable.items[w];if(!u){u=AA._itemsTable.loading[w];AA._itemsTable.items[w]=undefined;}v=u.id||g.generateId();AA._itemsTable.items.splice(w,1,{item:x,className:AA.CLASSES.ITEM+(AB.className?" "+AB.className:""),id:v});t=AA._itemsTable.items[w];}AA.fireEvent(R,{newItem:t,oldItem:u,pos:w,ev:R});return true;},replaceItems:function(t){var u,w,v=true;if(!r.isArray(t)){return false;}a=false;for(u=0,w=t.length;u<w;u++){if(this.replaceItem(t[u][0],t[u][1])===false){v=false;}}a=true;this._syncUiItems();return v;},render:function(u){var w=this,t=w.CLASSES,v=w._rows;w.addClass(t.CAROUSEL);if(!w._clipEl){w._clipEl=w._createCarouselClip();w._clipEl.appendChild(w._carouselEl);}if(u){w.appendChild(w._clipEl);w.appendTo(u);}else{if(!g.inDocument(w.get("element"))){return false;}w.appendChild(w._clipEl);}if(v){g.addClass(w._clipEl,t.MULTI_ROW);}if(w.get("isVertical")){w.addClass(t.VERTICAL);}else{w.addClass(t.HORIZONTAL);}if(w.get("numItems")<1){return false;}w._refreshUi();return true;},scrollBackward:function(){var t=this;t.scrollTo(t._firstItem-t.get("scrollIncrement"));},scrollForward:function(){var t=this;t.scrollTo(t._firstItem+t.get("scrollIncrement"));},scrollPageBackward:function(){var v=this,w=v.get("isVertical"),u=v._cols,x=v.get("firstVisible"),t=x-v.get("numVisible");if(t<0){if(u){t=x-u;}}v.scrollTo(t);},scrollPageForward:function(){var u=this,t=u._firstItem+u.get("numVisible");if(t>u.get("numItems")){t=0;}if(u.get("selectOnScroll")){u._selectedItem=u._getSelectedItem(t);}u.scrollTo(t);},scrollTo:function(AK,AH){var AG=this,v,AI,AA,AC,AL,AM,AN,AD,AB,w,AF,t,x,u,y,AE,z,AO,AJ=AG._itemsTable;if(AJ.numItems===0||AK==AG._firstItem||AG.isAnimating()){return;}AI=AG.get("animation");AA=AG.get("isCircular");AC=AG.get("isVertical");AB=AG._cols;w=AG._rows;AN=AG._firstItem;AF=AG.get("numItems");
+t=AG.get("numVisible");u=AG.get("currentPage");AO=function(){if(AG.isAutoPlayOn()){AG.stopAutoPlay();}};if(AK<0){if(AA){if(AF%t!==0){AK=AF+(AF%t)-t-1;}else{AK=AF+AK;}}else{AO.call(AG);return;}}else{if(AF>0&&AK>AF-1){if(AG.get("isCircular")){AK=AF-AK;}else{AO.call(AG);return;}}}if(isNaN(AK)){return;}AM=(AG._firstItem>AK)?"backward":"forward";AE=AN+t;AE=(AE>AF-1)?AF-1:AE;y=AG.fireEvent(k,{dir:AM,first:AN,last:AE});if(y===false){return;}AG.fireEvent(K,{page:u});AD=AK+t-1;AG._loadItems(AD>AF-1?AF-1:AD);AL=0-AK;if(w){if(AC){AL=parseInt(AL/AB,10);}else{AL=parseInt(AL/w,10);}}AG._firstItem=AK;AG.set("firstVisible",AK);if(!AH&&AG.get("selectOnScroll")){AG._selectedItem=AK;}AE=AK+t;AE=(AE>AF-1)?AF-1:AE;x=l.call(AG,AL);v=AI.speed>0;if(v){AG._animateAndSetCarouselOffset(x,AK,AE,AH);}else{AG._setCarouselOffset(x);E.call(AG,AK,AE);}},getPageForItem:function(t){return Math.ceil((t+1)/parseInt(this.get("numVisible"),10));},getFirstVisibleOnPage:function(t){return(t-1)*this.get("numVisible");},selectPreviousItem:function(){var v=this,u=0,t=v.get("selectedItem");if(t==v._firstItem){u=t-v.get("numVisible");v._selectedItem=v._getSelectedItem(t-1);v.scrollTo(u,true);}else{u=v.get("selectedItem")-v.get("scrollIncrement");v.set("selectedItem",v._getSelectedItem(u));}},selectNextItem:function(){var u=this,t=0;t=u.get("selectedItem")+u.get("scrollIncrement");u.set("selectedItem",u._getSelectedItem(t));},show:function(){var u=this,t=u.CLASSES;if(u.fireEvent(Z)!==false){u.addClass(t.VISIBLE);G.call(u);u.fireEvent(W);}},startAutoPlay:function(){var t=this,u;if(r.isUndefined(t._autoPlayTimer)){u=t.get("autoPlayInterval");if(u<=0){return;}t._isAutoPlayInProgress=true;t.fireEvent(b);t._autoPlayTimer=setTimeout(function(){t._autoScroll();},u);}},stopAutoPlay:function(){var t=this;if(!r.isUndefined(t._autoPlayTimer)){clearTimeout(t._autoPlayTimer);delete t._autoPlayTimer;t._isAutoPlayInProgress=false;t.fireEvent(s);}},updatePagination:function(){var AB=this,z=AB._pagination;if(!z.el){return false;}var y=AB.get("numItems"),AC=AB.get("numVisible"),w=AB.get("firstVisible")+1,x=AB.get("currentPage")+1,t=AB.get("numPages"),v={"numVisible":AC,"numPages":t,"numItems":y,"selectedItem":AB.get("selectedItem")+1,"currentPage":x,"firstVisible":w,"lastVisible":AB.get("lastVisible")+1},u=z.callback||{},AA=u.scope&&u.obj?u.obj:AB;z.el.innerHTML=r.isFunction(u.fn)?u.fn.apply(AA,[z.template,v]):YAHOO.lang.substitute(z.template,v);},registerPagination:function(u,w,t){var v=this;v._pagination.template=u;v._pagination.callback=t||{};if(!v._pagination.el){v._pagination.el=X("DIV",{className:v.CLASSES.PAGINATION});if(w=="before"){v._navEl.insertBefore(v._pagination.el,v._navEl.firstChild);}else{v._navEl.appendChild(v._pagination.el);}v.on("itemSelected",v.updatePagination);v.on("pageChange",v.updatePagination);}v.updatePagination();},toString:function(){return Q+(this.get?" (#"+this.get("id")+")":"");},_animateAndSetCarouselOffset:function(y,w,u){var x=this,v=x.get("animation"),t=null;if(x.get("isVertical")){t=new YAHOO.util.Motion(x._carouselEl,{top:{to:y}},v.speed,v.effect);}else{t=new YAHOO.util.Motion(x._carouselEl,{left:{to:y}},v.speed,v.effect);}x._isAnimationInProgress=true;t.onComplete.subscribe(x._animationCompleteHandler,{scope:x,item:w,last:u});t.animate();},_animationCompleteHandler:function(t,u,v){v.scope._isAnimationInProgress=false;E.call(v.scope,v.item,v.last);},_autoScroll:function(){var u=this,v=u._firstItem,t;if(v>=u.get("numItems")-1){if(u.get("isCircular")){t=0;}else{u.stopAutoPlay();}}else{t=v+u.get("numVisible");}u._selectedItem=u._getSelectedItem(t);u.scrollTo.call(u,t);},_createCarousel:function(u){var w=this,t=w.CLASSES,v=g.get(u);if(!v){v=X("DIV",{className:t.CAROUSEL,id:u});}if(!w._carouselEl){w._carouselEl=X(w.get("carouselEl"),{className:t.CAROUSEL_EL});}return v;},_createCarouselClip:function(){return X("DIV",{className:this.CLASSES.CONTENT});},_createCarouselItem:function(v){var t,u=this;return X(u.get("carouselItemEl"),{className:v.className,styles:{},content:v.content,id:v.id});},_getValidIndex:function(v){var y=this,t=y.get("isCircular"),w=y.get("numItems"),x=y.get("numVisible"),u=w-1;if(v<0){v=t?Math.ceil(w/x)*x+v:0;}else{if(v>u){v=t?0:u;}}return v;},_getSelectedItem:function(x){var w=this,t=w.get("isCircular"),v=w.get("numItems"),u=v-1;if(x<0){if(t){x=v+x;}else{x=w.get("selectedItem");}}else{if(x>u){if(t){x=x-v;}else{x=w.get("selectedItem");}}}return x;},_focusHandler:function(){var t=this;if(t._hasFocus){t.focus();}},_itemClickHandler:function(x){var AA=this,y=AA.get("carouselItemEl"),u=AA.get("element"),v,w,z=e.getTarget(x),t=z.tagName.toUpperCase();if(t==="INPUT"||t==="SELECT"||t==="TEXTAREA"){return;}while(z&&z!=u&&z.id!=AA._carouselEl){v=z.nodeName;if(v.toUpperCase()==y){break;}z=z.parentNode;}if((w=AA.getItemPositionById(z.id))>=0){AA.set("selectedItem",AA._getSelectedItem(w));AA.focus();}},_keyboardEventHandler:function(v){var x=this,u=e.getCharCode(v),w=e.getTarget(v),t=false;if(x.isAnimating()||w.tagName.toUpperCase()==="SELECT"){return;}switch(u){case 37:case 38:x.selectPreviousItem();t=true;break;case 39:case 40:x.selectNextItem();t=true;break;case 33:x.scrollPageBackward();t=true;break;case 34:x.scrollPageForward();t=true;break;}if(t){if(x.isAutoPlayOn()){x.stopAutoPlay();}e.preventDefault(v);}},_loadItems:function(v){var y=this,u=y.get("numItems"),w=y.get("numVisible"),x=y.get("revealAmount"),z=y._itemsTable.items.length,t=y.get("lastVisible");if(z>v&&v+1>=w){z=v%w||v==t?v-v%w:v-w+1;}if(x&&v<u-1){v++;}if(v>=z&&(!y.getItem(z)||!y.getItem(v))){y.fireEvent(M,{ev:M,first:z,last:v,num:v-z+1});}},_pagerChangeHandler:function(u){var x=this,w=e.getTarget(u),v=w.value,t;if(v){t=x.getFirstVisibleOnPage(v);x._selectedItem=t;x.scrollTo(t);x.focus();}},_pagerClickHandler:function(z){var AB=this,v=AB.CLASSES,w=e.getTarget(z),u=w.nodeName.toUpperCase(),t,y,x,AA;if(g.hasClass(w,v.PAGER_ITEM)||g.hasClass(w.parentNode,v.PAGER_ITEM)){if(u=="EM"){w=w.parentNode;}t=w.href;y=t.lastIndexOf("#");x=parseInt(t.substring(y+1),10);
+if(x!=-1){AA=AB.getFirstVisibleOnPage(x);AB._selectedItem=AA;AB.scrollTo(AA);AB.focus();}e.preventDefault(z);}},_parseCarousel:function(v){var y=this,z,t,u,x,w;t=y.CLASSES;u=y.get("carouselEl");x=false;for(z=v.firstChild;z;z=z.nextSibling){if(z.nodeType==1){w=z.nodeName;if(w.toUpperCase()==u){y._carouselEl=z;g.addClass(y._carouselEl,y.CLASSES.CAROUSEL_EL);x=true;}}}return x;},_parseCarouselItems:function(){var AA=this,AC=AA.CLASSES,x=0,AB,t,v,w,u,y=AA.get("firstVisible"),z=AA._carouselEl;AB=AA._rows;v=AA.get("carouselItemEl");for(t=z.firstChild;t;t=t.nextSibling){if(t.nodeType==1){u=t.nodeName;if(u.toUpperCase()==v){if(t.id){w=t.id;}else{w=g.generateId();t.setAttribute("id",w);g.addClass(t,AA.CLASSES.ITEM);}AA.addItem(t,y);y++;}}}},_parseCarouselNavigation:function(z){var AA=this,y,AB=AA.CLASSES,u,x,w,t,v=false;t=g.getElementsByClassName(AB.PREV_PAGE,"*",z);if(t.length>0){for(x in t){if(t.hasOwnProperty(x)){u=t[x];if(u.nodeName=="INPUT"||u.nodeName=="BUTTON"||u.nodeName=="A"){AA._navBtns.prev.push(u);}else{w=u.getElementsByTagName("INPUT");if(r.isArray(w)&&w.length>0){AA._navBtns.prev.push(w[0]);}else{w=u.getElementsByTagName("BUTTON");if(r.isArray(w)&&w.length>0){AA._navBtns.prev.push(w[0]);}}}}}y={prev:t};}t=g.getElementsByClassName(AB.NEXT_PAGE,"*",z);if(t.length>0){for(x in t){if(t.hasOwnProperty(x)){u=t[x];if(u.nodeName=="INPUT"||u.nodeName=="BUTTON"||u.nodeName=="A"){AA._navBtns.next.push(u);}else{w=u.getElementsByTagName("INPUT");if(r.isArray(w)&&w.length>0){AA._navBtns.next.push(w[0]);}else{w=u.getElementsByTagName("BUTTON");if(r.isArray(w)&&w.length>0){AA._navBtns.next.push(w[0]);}}}}}if(y){y.next=t;}else{y={next:t};}}if(y){AA.set("navigation",y);v=true;}return v;},_refreshUi:function(){var x=this,y=x.get("isVertical"),AA=x.get("firstVisible"),u,v,z,t,w;if(x._itemsTable.numItems<1){return;}w=P.call(x,y?"height":"width");v=x._itemsTable.items[AA].id;w=y?f(v,"width"):f(v,"height");g.setStyle(x._carouselEl,y?"width":"height",w+"px");x._hasRendered=true;x.fireEvent(I);},_setCarouselOffset:function(v){var t=this,u;u=t.get("isVertical")?"top":"left";g.setStyle(t._carouselEl,u,v+"px");},_setupCarouselNavigation:function(){var y=this,w,u,t,AA,x,z,v;t=y.CLASSES;x=g.getElementsByClassName(t.NAVIGATION,"DIV",y.get("element"));if(x.length===0){x=X("DIV",{className:t.NAVIGATION});y.insertBefore(x,g.getFirstChild(y.get("element")));}else{x=x[0];}y._pages.el=X("UL");x.appendChild(y._pages.el);AA=y.get("navigation");if(r.isString(AA.prev)||r.isArray(AA.prev)){if(r.isString(AA.prev)){AA.prev=[AA.prev];}for(w in AA.prev){if(AA.prev.hasOwnProperty(w)){y._navBtns.prev.push(g.get(AA.prev[w]));}}}else{v=X("SPAN",{className:t.BUTTON+t.FIRST_NAV});g.setStyle(v,"visibility","visible");w=g.generateId();v.innerHTML='<button type="button" '+'id="'+w+'" name="'+y.STRINGS.PREVIOUS_BUTTON_TEXT+'">'+y.STRINGS.PREVIOUS_BUTTON_TEXT+"</button>";x.appendChild(v);w=g.get(w);y._navBtns.prev=[w];u={prev:[v]};}if(r.isString(AA.next)||r.isArray(AA.next)){if(r.isString(AA.next)){AA.next=[AA.next];}for(w in AA.next){if(AA.next.hasOwnProperty(w)){y._navBtns.next.push(g.get(AA.next[w]));}}}else{z=X("SPAN",{className:t.BUTTON+t.NEXT_NAV});g.setStyle(z,"visibility","visible");w=g.generateId();z.innerHTML='<button type="button" '+'id="'+w+'" name="'+y.STRINGS.NEXT_BUTTON_TEXT+'">'+y.STRINGS.NEXT_BUTTON_TEXT+"</button>";x.appendChild(z);w=g.get(w);y._navBtns.next=[w];if(u){u.next=[z];}else{u={next:[z]};}}if(u){y.set("navigation",u);}return x;},_setClipContainerSize:function(t,v){var AB=this,z=AB.get("isVertical"),AD=AB._rows,x=AB._cols,AA=AB.get("revealAmount"),u=P.call(AB,"height"),w=P.call(AB,"width"),AC,y;AB._recomputeSize=(AC===0);if(AB._recomputeSize){AB._hasRendered=false;return;}t=t||AB._clipEl;if(AD){AC=u*AD;y=w*x;}else{v=v||AB.get("numVisible");if(z){AC=u*v;}else{y=w*v;}}AA=O.call(AB);if(z){AC+=(AA*2);}else{y+=(AA*2);}if(z){AC+=N(AB._carouselEl,"height");g.setStyle(t,"height",AC+"px");if(x){y+=N(AB._carouselEl,"width");g.setStyle(t,"width",y+(0)+"px");}}else{y+=N(AB._carouselEl,"width");g.setStyle(t,"width",y+"px");if(AD){AC+=N(AB._carouselEl,"height");g.setStyle(t,"height",AC+"px");}}if(t){AB._setContainerSize(t);}},_setContainerSize:function(u,v){var y=this,t=y.CONFIG,AB=y.CLASSES,x,AA,w,z;x=y.get("isVertical");AA=y._rows;w=y._cols;u=u||y._clipEl;v=v||(x?"height":"width");z=parseFloat(g.getStyle(u,v),10);z=r.isNumber(z)?z:0;if(x){z+=N(y._carouselEl,"height")+f(y._navEl,"height");}else{z+=N(y._carouselEl,"width");}if(!x){if(z<t.HORZ_MIN_WIDTH){z=t.HORZ_MIN_WIDTH;y.addClass(AB.MIN_WIDTH);}}y.setStyle(v,z+"px");if(x){z=P.call(y,"width");if(w){z=z*w;}g.setStyle(y._carouselEl,"width",z+"px");if(z<t.VERT_MIN_WIDTH){z=t.VERT_MIN_WIDTH;y.addClass(AB.MIN_WIDTH);}y.setStyle("width",z+"px");}else{z=P.call(y,"height");if(AA){z=z*AA;}g.setStyle(y._carouselEl,"height",z+"px");}},_setFirstVisible:function(u){var t=this;if(u>=0&&u<t.get("numItems")){t.scrollTo(u);}else{u=t.get("firstVisible");}return u;},_setNavigation:function(t){var u=this;if(t.prev){e.on(t.prev,"click",h,u);}if(t.next){e.on(t.next,"click",m,u);}},_setNumVisible:function(u){var t=this;t._setClipContainerSize(t._clipEl,u);},_numVisibleSetter:function(v){var u=this,t=v;if(r.isArray(v)){u._cols=v[0];u._rows=v[1];t=v[0]*v[1];}return t;},_selectedItemSetter:function(u){var t=this;return(u<t.get("numItems"))?u:0;},_setNumItems:function(v){var u=this,t=u._itemsTable.numItems;if(r.isArray(u._itemsTable.items)){if(u._itemsTable.items.length!=t){t=u._itemsTable.items.length;u._itemsTable.numItems=t;}}if(v<t){while(t>v){u.removeItem(t-1);t--;}}return v;},_setOrientation:function(v){var u=this,t=u.CLASSES;if(v){u.replaceClass(t.HORIZONTAL,t.VERTICAL);}else{u.replaceClass(t.VERTICAL,t.HORIZONTAL);}return v;},_setRevealAmount:function(u){var t=this;if(u>=0&&u<=100){u=parseInt(u,10);u=r.isNumber(u)?u:0;t._setClipContainerSize();}else{u=t.get("revealAmount");}return u;},_setSelectedItem:function(t){this._selectedItem=t;},_getNumPages:function(){return Math.ceil(parseInt(this.get("numItems"),10)/parseInt(this.get("numVisible"),10));
+},_getLastVisible:function(){var t=this;return t.get("currentPage")+1==t.get("numPages")?t.get("numItems")-1:t.get("firstVisible")+t.get("numVisible")-1;},_syncUiForItemAdd:function(w){var x,AC=this,z=AC._carouselEl,t,AD,v=AC._itemsTable,u,y,AA,AB;y=r.isUndefined(w.pos)?w.newPos||v.numItems-1:w.pos;if(!u){AD=v.items[y]||{};t=AC._createCarouselItem({className:AD.className,styles:AD.styles,content:AD.item,id:AD.id,pos:y});if(r.isUndefined(w.pos)){if(!r.isUndefined(v.loading[y])){u=v.loading[y];}if(u){z.replaceChild(t,u);delete v.loading[y];}else{z.appendChild(t);}}else{if(!r.isUndefined(v.items[w.pos+1])){AA=g.get(v.items[w.pos+1].id);}if(AA){z.insertBefore(t,AA);}else{}}}else{if(r.isUndefined(w.pos)){if(!g.isAncestor(AC._carouselEl,u)){z.appendChild(u);}}else{if(!g.isAncestor(z,u)){if(!r.isUndefined(v.items[w.pos+1])){z.insertBefore(u,g.get(v.items[w.pos+1].id));}}}}if(!AC._hasRendered){AC._refreshUi();}if(AC.get("selectedItem")<0){AC.set("selectedItem",AC.get("firstVisible"));}AC._syncUiItems();},_syncUiForItemReplace:function(z){var y=this,v=y._carouselEl,t=y._itemsTable,AA=z.pos,x=z.newItem,u=z.oldItem,w;w=y._createCarouselItem({className:x.className,styles:x.styles,content:x.item,id:u.id});if((u=g.get(u.id))){u.className=x.className;u.styles=x.styles;u.innerHTML=x.item;t.items[AA]=w;if(t.loading[AA]){t.numItems++;delete t.loading[AA];}}},_syncUiForItemRemove:function(y){var x=this,t=x._carouselEl,v,w,u,z;u=x.get("numItems");w=y.item;z=y.pos;if(w&&(v=g.get(w.id))){if(v&&g.isAncestor(t,v)){e.purgeElement(v,true);t.removeChild(v);}if(x.get("selectedItem")==z){z=z>=u?u-1:z;}}else{}x._syncUiItems();},_findClosestSibling:function(y){var x=this,u=x._itemsTable,t=u.items.length,v=y,w;while(v<t&&!w){w=u.items[++v];}return w;},_syncUiForLazyLoading:function(x){var AD=this,AA=AD._carouselEl,v=AD._itemsTable,z=v.items.length,AC=AD._findClosestSibling(x.last),AB=x.last,y=AB-AD.get("numVisible")+1,t,u;for(var w=y;w<=AB;w++){if(!v.loading[w]&&!v.items[w]){t=AD._createCarouselItem({className:AD.CLASSES.ITEM+" "+AD.CLASSES.ITEM_LOADING,content:AD.STRINGS.ITEM_LOADING_CONTENT,id:g.generateId()});if(t){if(AC){AC=g.get(AC.id);if(AC){AA.insertBefore(t,AC);}else{}}else{AA.appendChild(t);}}v.loading[w]=t;}}AD._syncUiItems();},_syncUiItems:function(){if(!a){return;}var x,AB=this,z=AB.get("numItems"),w,v=AB._itemsTable,y=v.items,t=v.loading,AC,AA,u=false;for(w=0;w<z;w++){AC=y[w]||t[w];if(AC&&AC.id){AA=o.call(AB,w);AC.styles=AC.styles||{};for(x in AA){if(AC.styles[x]!==AA[x]){u=true;AC.styles[x]=AA[x];}}if(u){H(g.get(AC.id),AA);}u=false;}}},_updateNavButtons:function(x,u){var v,t=this.CLASSES,y,w=x.parentNode;if(!w){return;}y=w.parentNode;if(x.nodeName.toUpperCase()=="BUTTON"&&g.hasClass(w,t.BUTTON)){if(u){if(y){v=g.getChildren(y);if(v){g.removeClass(v,t.FOCUSSED_BUTTON);}}g.addClass(w,t.FOCUSSED_BUTTON);}else{g.removeClass(w,t.FOCUSSED_BUTTON);}}},_updatePagerButtons:function(){if(!a){return;}var AB=this,z=AB.CLASSES,AA=AB._pages.cur,t,y,w,AC,u=AB.get("numVisible"),x=AB._pages.num,v=AB._pages.el;if(x===0||!v){return;}g.setStyle(v,"visibility","hidden");while(v.firstChild){v.removeChild(v.firstChild);}for(w=0;w<x;w++){t=document.createElement("LI");if(w===0){g.addClass(t,z.FIRST_PAGE);}if(w==AA){g.addClass(t,z.SELECTED_NAV);}y="<a class="+z.PAGER_ITEM+' href="#'+(w+1)+'" tabindex="0"><em>'+AB.STRINGS.PAGER_PREFIX_TEXT+" "+(w+1)+"</em></a>";t.innerHTML=y;v.appendChild(t);}g.setStyle(v,"visibility","visible");},_updatePagerMenu:function(){var AB=this,z=AB.CLASSES,AA=AB._pages.cur,u,x,AC,v=AB.get("numVisible"),y=AB._pages.num,w=AB._pages.el,t;if(y===0||!w){return;}t=document.createElement("SELECT");if(!t){return;}g.setStyle(w,"visibility","hidden");while(w.firstChild){w.removeChild(w.firstChild);}for(x=0;x<y;x++){u=document.createElement("OPTION");u.value=x+1;u.innerHTML=AB.STRINGS.PAGER_PREFIX_TEXT+" "+(x+1);if(x==AA){u.setAttribute("selected","selected");}t.appendChild(u);}u=document.createElement("FORM");if(!u){}else{u.appendChild(t);w.appendChild(u);}e.addListener(t,"change",AB._pagerChangeHandler,this,true);g.setStyle(w,"visibility","visible");},_updateTabIndex:function(t){var u=this;if(t){if(u._focusableItemEl){u._focusableItemEl.tabIndex=-1;}u._focusableItemEl=t;t.tabIndex=0;}},_validateAnimation:function(t){var u=true;if(r.isObject(t)){if(t.speed){u=u&&r.isNumber(t.speed);}if(t.effect){u=u&&r.isFunction(t.effect);}else{if(!r.isUndefined(YAHOO.util.Easing)){t.effect=YAHOO.util.Easing.easeOut;}}}else{u=false;}return u;},_validateFirstVisible:function(v){var u=this,t=u.get("numItems");if(r.isNumber(v)){if(t===0&&v==t){return true;}else{return(v>=0&&v<t);}}return false;},_validateNavigation:function(t){var u;if(!r.isObject(t)){return false;}if(t.prev){if(!r.isArray(t.prev)){return false;}for(u in t.prev){if(t.prev.hasOwnProperty(u)){if(!r.isString(t.prev[u].nodeName)){return false;}}}}if(t.next){if(!r.isArray(t.next)){return false;}for(u in t.next){if(t.next.hasOwnProperty(u)){if(!r.isString(t.next[u].nodeName)){return false;}}}}return true;},_validateNumItems:function(t){return r.isNumber(t)&&(t>=0);},_validateNumVisible:function(t){var u=false;if(r.isNumber(t)){u=t>0&&t<=this.get("numItems");}else{if(r.isArray(t)){if(r.isNumber(t[0])&&r.isNumber(t[1])){u=t[0]*t[1]>0&&t.length==2;}}}return u;},_validateRevealAmount:function(t){var u=false;if(r.isNumber(t)){u=t>=0&&t<100;}return u;},_validateScrollIncrement:function(t){var u=false;if(r.isNumber(t)){u=(t>0&&t<this.get("numItems"));}return u;}});})();YAHOO.register("carousel",YAHOO.widget.Carousel,{version:"2.9.0",build:"2800"});YAHOO.register("carousel",YAHOO.widget.Carousel,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/charts/charts-min.js b/js/yui/charts/charts-min.js
new file mode 100644 (file)
index 0000000..40553ab
--- /dev/null
+++ b/js/yui/charts/charts-min.js
@@ -0,0 +1,9 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.widget.Chart=function(d,a,j,g){this._type=d;this._dataSource=j;var f={align:"",allowNetworking:"",allowScriptAccess:"",base:"",bgcolor:"",menu:"",name:"",quality:"",salign:"",scale:"",tabindex:"",wmode:""};var b={fixedAttributes:{allowScriptAccess:"always"},flashVars:{allowedDomain:document.location.hostname},backgroundColor:"#ffffff",host:this,version:9.045};for(var c in g){if(f.hasOwnProperty(c)){b.fixedAttributes[c]=g[c];}else{b[c]=g[c];}}this._id=b.id=b.id||YAHOO.util.Dom.generateId(null,"yuigen");this._swfURL=YAHOO.widget.Chart.SWFURL;this._containerID=a;this._attributes=b;this._swfEmbed=new YAHOO.widget.SWF(a,YAHOO.widget.Chart.SWFURL,b);this._swf=this._swfEmbed.swf;this._swfEmbed.subscribe("swfReady",this._eventHandler,this,true);try{this.createEvent("contentReady");}catch(h){}this.createEvent("itemMouseOverEvent");this.createEvent("itemMouseOutEvent");this.createEvent("itemClickEvent");this.createEvent("itemDoubleClickEvent");this.createEvent("itemDragStartEvent");this.createEvent("itemDragEvent");this.createEvent("itemDragEndEvent");};YAHOO.extend(YAHOO.widget.Chart,YAHOO.util.AttributeProvider,{_type:null,_pollingID:null,_pollingInterval:null,_dataTipFunction:null,_legendLabelFunction:null,_seriesFunctions:null,toString:function(){return"Chart "+this._id;},setStyle:function(a,b){b=YAHOO.lang.JSON.stringify(b);this._swf.setStyle(a,b);},setStyles:function(a){a=YAHOO.lang.JSON.stringify(a);this._swf.setStyles(a);},setSeriesStyles:function(b){for(var a=0;a<b.length;a++){b[a]=YAHOO.lang.JSON.stringify(b[a]);}this._swf.setSeriesStyles(b);},destroy:function(){if(this._dataSource!==null){if(this._pollingID!==null){this._dataSource.clearInterval(this._pollingID);this._pollingID=null;}}if(this._dataTipFunction){YAHOO.widget.Chart.removeProxyFunction(this._dataTipFunction);}if(this._legendLabelFunction){YAHOO.widget.Chart.removeProxyFunction(this._legendLabelFunction);}if(this._swf){var b=YAHOO.util.Dom.get(this._containerID);b.removeChild(this._swf);}var a=this._id;for(var c in this){if(YAHOO.lang.hasOwnProperty(this,c)){this[c]=null;}}},_initAttributes:function(a){this.setAttributeConfig("altText",{method:this._setAltText,getter:this._getAltText});this.setAttributeConfig("swfURL",{getter:this._getSWFURL});this.setAttributeConfig("request",{method:this._setRequest,getter:this._getRequest});this.setAttributeConfig("dataSource",{method:this._setDataSource,getter:this._getDataSource});this.setAttributeConfig("series",{method:this._setSeriesDefs,getter:this._getSeriesDefs});this.setAttributeConfig("categoryNames",{validator:YAHOO.lang.isArray,method:this._setCategoryNames,getter:this._getCategoryNames});this.setAttributeConfig("dataTipFunction",{method:this._setDataTipFunction,getter:this._getDataTipFunction});this.setAttributeConfig("legendLabelFunction",{method:this._setLegendLabelFunction,getter:this._getLegendLabelFunction});this.setAttributeConfig("polling",{method:this._setPolling,getter:this._getPolling});},_eventHandler:function(a){if(a.type=="swfReady"){this._swf=this._swfEmbed._swf;this._loadHandler();this.fireEvent("contentReady");}},_loadHandler:function(){if(!this._swf||!this._swf.setType){return;}this._swf.setType(this._type);if(this._attributes.style){var a=this._attributes.style;this.setStyles(a);}this._initialized=false;this._initAttributes(this._attributes);this.setAttributes(this._attributes,true);this._initialized=true;if(this._dataSource){this.set("dataSource",this._dataSource);}},refreshData:function(){if(!this._initialized){return;}if(this._dataSource!==null){if(this._pollingID!==null){this._dataSource.clearInterval(this._pollingID);this._pollingID=null;}if(this._pollingInterval>0){this._pollingID=this._dataSource.setInterval(this._pollingInterval,this._request,this._loadDataHandler,this);}this._dataSource.sendRequest(this._request,this._loadDataHandler,this);}},_loadDataHandler:function(d,c,m){if(this._swf){if(m){}else{var j;if(this._seriesFunctions){var k=this._seriesFunctions.length;for(j=0;j<k;j++){YAHOO.widget.Chart.removeProxyFunction(this._seriesFunctions[j]);}this._seriesFunctions=null;}this._seriesFunctions=[];var g=[];var f=0;var n=null;if(this._seriesDefs!==null){f=this._seriesDefs.length;for(j=0;j<f;j++){n=this._seriesDefs[j];var b={};for(var a in n){if(YAHOO.lang.hasOwnProperty(n,a)){if(a=="style"){if(n.style!==null){b.style=YAHOO.lang.JSON.stringify(n.style);}}else{if(a=="labelFunction"){if(n.labelFunction!==null){b.labelFunction=YAHOO.widget.Chart.getFunctionReference(n.labelFunction);this._seriesFunctions.push(b.labelFunction);}}else{if(a=="dataTipFunction"){if(n.dataTipFunction!==null){b.dataTipFunction=YAHOO.widget.Chart.getFunctionReference(n.dataTipFunction);this._seriesFunctions.push(b.dataTipFunction);}}else{if(a=="legendLabelFunction"){if(n.legendLabelFunction!==null){b.legendLabelFunction=YAHOO.widget.Chart.getFunctionReference(n.legendLabelFunction);this._seriesFunctions.push(b.legendLabelFunction);}}else{b[a]=n[a];}}}}}}g.push(b);}}if(f>0){for(j=0;j<f;j++){n=g[j];if(!n.type){n.type=this._type;}n.dataProvider=c.results;}}else{var h={type:this._type,dataProvider:c.results};g.push(h);}try{if(this._swf.setDataProvider){this._swf.setDataProvider(g);}}catch(l){this._swf.setDataProvider(g);}}}},_request:"",_getRequest:function(){return this._request;},_setRequest:function(a){this._request=a;this.refreshData();},_dataSource:null,_getDataSource:function(){return this._dataSource;},_setDataSource:function(a){this._dataSource=a;this.refreshData();},_seriesDefs:null,_getSeriesDefs:function(){return this._seriesDefs;},_setSeriesDefs:function(a){this._seriesDefs=a;this.refreshData();},_getCategoryNames:function(){return this._swf.getCategoryNames();},_setCategoryNames:function(a){this._swf.setCategoryNames(a);},_setDataTipFunction:function(a){if(this._dataTipFunction){YAHOO.widget.Chart.removeProxyFunction(this._dataTipFunction);}if(a){this._dataTipFunction=a=YAHOO.widget.Chart.getFunctionReference(a);}this._swf.setDataTipFunction(a);},_setLegendLabelFunction:function(a){if(this._legendLabelFunction){YAHOO.widget.Chart.removeProxyFunction(this._legendLabelFunction);
+}if(a){this._legendLabelFunction=a=YAHOO.widget.Chart.getFunctionReference(a);}this._swf.setLegendLabelFunction(a);},_getLegendLabelFunction:function(){return this._legendLabelFunction;},_getPolling:function(){return this._pollingInterval;},_setPolling:function(a){this._pollingInterval=a;this.refreshData();},_swfEmbed:null,_swfURL:null,_containerID:null,_swf:null,_id:null,_initialized:false,_attributes:null,set:function(a,b){this._attributes[a]=b;YAHOO.widget.Chart.superclass.set.call(this,a,b);},_getSWFURL:function(){return this._swfURL;},_getAltText:function(){return this._swf.getAltText();},_setAltText:function(a){this._swf.setAltText(a);}});YAHOO.widget.Chart.proxyFunctionCount=0;YAHOO.widget.Chart.createProxyFunction=function(c,b){var b=b||null;var a=YAHOO.widget.Chart.proxyFunctionCount;YAHOO.widget.Chart["proxyFunction"+a]=function(){return c.apply(b,arguments);};YAHOO.widget.Chart.proxyFunctionCount++;return"YAHOO.widget.Chart.proxyFunction"+a.toString();};YAHOO.widget.Chart.getFunctionReference=function(b){if(typeof b=="function"){b=YAHOO.widget.Chart.createProxyFunction(b);}else{if(b.func&&typeof b.func=="function"){var a=[b.func];if(b.scope&&typeof b.scope=="object"){a.push(b.scope);}b=YAHOO.widget.Chart.createProxyFunction.apply(this,a);}}return b;};YAHOO.widget.Chart.removeProxyFunction=function(a){if(!a||a.indexOf("YAHOO.widget.Chart.proxyFunction")<0){return;}a=a.substr(26);YAHOO.widget.Chart[a]=null;};YAHOO.widget.Chart.SWFURL="assets/charts.swf";YAHOO.widget.PieChart=function(a,c,b){YAHOO.widget.PieChart.superclass.constructor.call(this,"pie",a,c,b);};YAHOO.lang.extend(YAHOO.widget.PieChart,YAHOO.widget.Chart,{_initAttributes:function(a){YAHOO.widget.PieChart.superclass._initAttributes.call(this,a);this.setAttributeConfig("dataField",{validator:YAHOO.lang.isString,method:this._setDataField,getter:this._getDataField});this.setAttributeConfig("categoryField",{validator:YAHOO.lang.isString,method:this._setCategoryField,getter:this._getCategoryField});},_getDataField:function(){return this._swf.getDataField();},_setDataField:function(a){this._swf.setDataField(a);},_getCategoryField:function(){return this._swf.getCategoryField();},_setCategoryField:function(a){this._swf.setCategoryField(a);}});YAHOO.widget.CartesianChart=function(c,a,d,b){YAHOO.widget.CartesianChart.superclass.constructor.call(this,c,a,d,b);};YAHOO.lang.extend(YAHOO.widget.CartesianChart,YAHOO.widget.Chart,{_xAxisLabelFunctions:[],_yAxisLabelFunctions:[],destroy:function(){this._removeAxisFunctions(this._xAxisLabelFunctions);this._removeAxisFunctions(this._yAxisLabelFunctions);YAHOO.widget.CartesianChart.superclass.destroy.call(this);},_initAttributes:function(a){YAHOO.widget.CartesianChart.superclass._initAttributes.call(this,a);this.setAttributeConfig("xField",{validator:YAHOO.lang.isString,method:this._setXField,getter:this._getXField});this.setAttributeConfig("yField",{validator:YAHOO.lang.isString,method:this._setYField,getter:this._getYField});this.setAttributeConfig("xAxis",{method:this._setXAxis});this.setAttributeConfig("xAxes",{method:this._setXAxes});this.setAttributeConfig("yAxis",{method:this._setYAxis});this.setAttributeConfig("yAxes",{method:this._setYAxes});this.setAttributeConfig("constrainViewport",{method:this._setConstrainViewport});},_getXField:function(){return this._swf.getHorizontalField();},_setXField:function(a){this._swf.setHorizontalField(a);},_getYField:function(){return this._swf.getVerticalField();},_setYField:function(a){this._swf.setVerticalField(a);},_getClonedAxis:function(a){var b={};for(var c in a){if(c=="labelFunction"){if(a.labelFunction&&a.labelFunction!==null){b.labelFunction=YAHOO.widget.Chart.getFunctionReference(a.labelFunction);}}else{b[c]=a[c];}}return b;},_removeAxisFunctions:function(c){if(c&&c.length>0){var a=c.length;for(var b=0;b<a;b++){if(c[b]!==null){YAHOO.widget.Chart.removeProxyFunction(c[b]);}}c=[];}},_setXAxis:function(a){if(a.position!="bottom"&&a.position!="top"){a.position="bottom";}this._removeAxisFunctions(this._xAxisLabelFunctions);a=this._getClonedAxis(a);this._xAxisLabelFunctions.push(a.labelFunction);this._swf.setHorizontalAxis(a);},_setXAxes:function(c){this._removeAxisFunctions(this._xAxisLabelFunctions);var a=c.length;for(var b=0;b<a;b++){if(c[b].position=="left"){c[b].position="bottom";}c[b]=this._getClonedAxis(c[b]);if(c[b].labelFunction){this._xAxisLabelFunctions.push(c[b].labelFunction);}this._swf.setHorizontalAxis(c[b]);}},_setYAxis:function(a){this._removeAxisFunctions(this._yAxisLabelFunctions);a=this._getClonedAxis(a);this._yAxisLabelFunctions.push(a.labelFunction);this._swf.setVerticalAxis(a);},_setYAxes:function(c){this._removeAxisFunctions(this._yAxisLabelFunctions);var a=c.length;for(var b=0;b<a;b++){c[b]=this._getClonedAxis(c[b]);if(c[b].labelFunction){this._yAxisLabelFunctions.push(c[b].labelFunction);}this._swf.setVerticalAxis(c[b]);}},_setConstrainViewport:function(a){this._swf.setConstrainViewport(a);},setSeriesStylesByIndex:function(a,b){b=YAHOO.lang.JSON.stringify(b);if(this._swf&&this._swf.setSeriesStylesByIndex){this._swf.setSeriesStylesByIndex(a,b);}}});YAHOO.widget.LineChart=function(a,c,b){YAHOO.widget.LineChart.superclass.constructor.call(this,"line",a,c,b);};YAHOO.lang.extend(YAHOO.widget.LineChart,YAHOO.widget.CartesianChart);YAHOO.widget.ColumnChart=function(a,c,b){YAHOO.widget.ColumnChart.superclass.constructor.call(this,"column",a,c,b);};YAHOO.lang.extend(YAHOO.widget.ColumnChart,YAHOO.widget.CartesianChart);YAHOO.widget.BarChart=function(a,c,b){YAHOO.widget.BarChart.superclass.constructor.call(this,"bar",a,c,b);};YAHOO.lang.extend(YAHOO.widget.BarChart,YAHOO.widget.CartesianChart);YAHOO.widget.StackedColumnChart=function(a,c,b){YAHOO.widget.StackedColumnChart.superclass.constructor.call(this,"stackcolumn",a,c,b);};YAHOO.lang.extend(YAHOO.widget.StackedColumnChart,YAHOO.widget.CartesianChart);YAHOO.widget.StackedBarChart=function(a,c,b){YAHOO.widget.StackedBarChart.superclass.constructor.call(this,"stackbar",a,c,b);
+};YAHOO.lang.extend(YAHOO.widget.StackedBarChart,YAHOO.widget.CartesianChart);YAHOO.widget.Axis=function(){};YAHOO.widget.Axis.prototype={type:null,reverse:false,labelFunction:null,labelSpacing:2,title:null};YAHOO.widget.NumericAxis=function(){YAHOO.widget.NumericAxis.superclass.constructor.call(this);};YAHOO.lang.extend(YAHOO.widget.NumericAxis,YAHOO.widget.Axis,{type:"numeric",minimum:NaN,maximum:NaN,majorUnit:NaN,minorUnit:NaN,snapToUnits:true,stackingEnabled:false,alwaysShowZero:true,scale:"linear",roundMajorUnit:true,calculateByLabelSize:true,position:"left",adjustMaximumByMajorUnit:true,adjustMinimumByMajorUnit:true});YAHOO.widget.TimeAxis=function(){YAHOO.widget.TimeAxis.superclass.constructor.call(this);};YAHOO.lang.extend(YAHOO.widget.TimeAxis,YAHOO.widget.Axis,{type:"time",minimum:null,maximum:null,majorUnit:NaN,majorTimeUnit:null,minorUnit:NaN,minorTimeUnit:null,snapToUnits:true,stackingEnabled:false,calculateByLabelSize:true});YAHOO.widget.CategoryAxis=function(){YAHOO.widget.CategoryAxis.superclass.constructor.call(this);};YAHOO.lang.extend(YAHOO.widget.CategoryAxis,YAHOO.widget.Axis,{type:"category",categoryNames:null,calculateCategoryCount:false});YAHOO.widget.Series=function(){};YAHOO.widget.Series.prototype={type:null,displayName:null};YAHOO.widget.CartesianSeries=function(){YAHOO.widget.CartesianSeries.superclass.constructor.call(this);};YAHOO.lang.extend(YAHOO.widget.CartesianSeries,YAHOO.widget.Series,{xField:null,yField:null,axis:"primary",showInLegend:true});YAHOO.widget.ColumnSeries=function(){YAHOO.widget.ColumnSeries.superclass.constructor.call(this);};YAHOO.lang.extend(YAHOO.widget.ColumnSeries,YAHOO.widget.CartesianSeries,{type:"column"});YAHOO.widget.LineSeries=function(){YAHOO.widget.LineSeries.superclass.constructor.call(this);};YAHOO.lang.extend(YAHOO.widget.LineSeries,YAHOO.widget.CartesianSeries,{type:"line"});YAHOO.widget.BarSeries=function(){YAHOO.widget.BarSeries.superclass.constructor.call(this);};YAHOO.lang.extend(YAHOO.widget.BarSeries,YAHOO.widget.CartesianSeries,{type:"bar"});YAHOO.widget.PieSeries=function(){YAHOO.widget.PieSeries.superclass.constructor.call(this);};YAHOO.lang.extend(YAHOO.widget.PieSeries,YAHOO.widget.Series,{type:"pie",dataField:null,categoryField:null,labelFunction:null});YAHOO.widget.StackedBarSeries=function(){YAHOO.widget.StackedBarSeries.superclass.constructor.call(this);};YAHOO.lang.extend(YAHOO.widget.StackedBarSeries,YAHOO.widget.CartesianSeries,{type:"stackbar"});YAHOO.widget.StackedColumnSeries=function(){YAHOO.widget.StackedColumnSeries.superclass.constructor.call(this);};YAHOO.lang.extend(YAHOO.widget.StackedColumnSeries,YAHOO.widget.CartesianSeries,{type:"stackcolumn"});YAHOO.register("charts",YAHOO.widget.Chart,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/colorpicker/colorpicker-min.js b/js/yui/colorpicker/colorpicker-min.js
new file mode 100644 (file)
index 0000000..dadac2a
--- /dev/null
+++ b/js/yui/colorpicker/colorpicker-min.js
@@ -0,0 +1,9 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.util.Color=function(){var a="0",b=YAHOO.lang.isArray,c=YAHOO.lang.isNumber;return{real2dec:function(d){return Math.min(255,Math.round(d*256));},hsv2rgb:function(l,y,w){if(b(l)){return this.hsv2rgb.call(this,l[0],l[1],l[2]);}var d,m,u,k=Math.floor((l/60)%6),n=(l/60)-k,j=w*(1-y),e=w*(1-n*y),x=w*(1-(1-n)*y),o;switch(k){case 0:d=w;m=x;u=j;break;case 1:d=e;m=w;u=j;break;case 2:d=j;m=w;u=x;break;case 3:d=j;m=e;u=w;break;case 4:d=x;m=j;u=w;break;case 5:d=w;m=j;u=e;break;}o=this.real2dec;return[o(d),o(m),o(u)];},rgb2hsv:function(d,j,k){if(b(d)){return this.rgb2hsv.apply(this,d);}d/=255;j/=255;k/=255;var i,n,e=Math.min(Math.min(d,j),k),l=Math.max(Math.max(d,j),k),m=l-e,f;switch(l){case e:i=0;break;case d:i=60*(j-k)/m;if(j<k){i+=360;}break;case j:i=(60*(k-d)/m)+120;break;case k:i=(60*(d-j)/m)+240;break;}n=(l===0)?0:1-(e/l);f=[Math.round(i),n,l];return f;},rgb2hex:function(h,e,d){if(b(h)){return this.rgb2hex.apply(this,h);}var i=this.dec2hex;return i(h)+i(e)+i(d);},dec2hex:function(d){d=parseInt(d,10)|0;d=(d>255||d<0)?0:d;return(a+d.toString(16)).slice(-2).toUpperCase();},hex2dec:function(d){return parseInt(d,16);},hex2rgb:function(d){var e=this.hex2dec;return[e(d.slice(0,2)),e(d.slice(2,4)),e(d.slice(4,6))];},websafe:function(h,e,d){if(b(h)){return this.websafe.apply(this,h);}var i=function(f){if(c(f)){f=Math.min(Math.max(0,f),255);var g,j;for(g=0;g<256;g=g+51){j=g+51;if(f>=g&&f<=j){return(f-g>25)?j:g;}}}return f;};return[i(h),i(e),i(d)];}};}();(function(){var k=0,g=YAHOO.util,d=YAHOO.lang,e=YAHOO.widget.Slider,c=g.Color,f=g.Dom,j=g.Event,a=d.substitute,i="yui-picker";function h(l,b){k=k+1;b=b||{};if(arguments.length===1&&!YAHOO.lang.isString(l)&&!l.nodeName){b=l;l=b.element||null;}if(!l&&!b.element){l=this._createHostElement(b);}h.superclass.constructor.call(this,l,b);this.initPicker();}YAHOO.extend(h,YAHOO.util.Element,{ID:{R:i+"-r",R_HEX:i+"-rhex",G:i+"-g",G_HEX:i+"-ghex",B:i+"-b",B_HEX:i+"-bhex",H:i+"-h",S:i+"-s",V:i+"-v",PICKER_BG:i+"-bg",PICKER_THUMB:i+"-thumb",HUE_BG:i+"-hue-bg",HUE_THUMB:i+"-hue-thumb",HEX:i+"-hex",SWATCH:i+"-swatch",WEBSAFE_SWATCH:i+"-websafe-swatch",CONTROLS:i+"-controls",RGB_CONTROLS:i+"-rgb-controls",HSV_CONTROLS:i+"-hsv-controls",HEX_CONTROLS:i+"-hex-controls",HEX_SUMMARY:i+"-hex-summary",CONTROLS_LABEL:i+"-controls-label"},TXT:{ILLEGAL_HEX:"Illegal hex value entered",SHOW_CONTROLS:"Show color details",HIDE_CONTROLS:"Hide color details",CURRENT_COLOR:"Currently selected color: {rgb}",CLOSEST_WEBSAFE:"Closest websafe color: {rgb}. Click to select.",R:"R",G:"G",B:"B",H:"H",S:"S",V:"V",HEX:"#",DEG:"\u00B0",PERCENT:"%"},IMAGE:{PICKER_THUMB:"../../build/colorpicker/assets/picker_thumb.png",HUE_THUMB:"../../build/colorpicker/assets/hue_thumb.png"},DEFAULT:{PICKER_SIZE:180},OPT:{HUE:"hue",SATURATION:"saturation",VALUE:"value",RED:"red",GREEN:"green",BLUE:"blue",HSV:"hsv",RGB:"rgb",WEBSAFE:"websafe",HEX:"hex",PICKER_SIZE:"pickersize",SHOW_CONTROLS:"showcontrols",SHOW_RGB_CONTROLS:"showrgbcontrols",SHOW_HSV_CONTROLS:"showhsvcontrols",SHOW_HEX_CONTROLS:"showhexcontrols",SHOW_HEX_SUMMARY:"showhexsummary",SHOW_WEBSAFE:"showwebsafe",CONTAINER:"container",IDS:"ids",ELEMENTS:"elements",TXT:"txt",IMAGES:"images",ANIMATE:"animate"},skipAnim:true,_createHostElement:function(){var b=document.createElement("div");if(this.CSS.BASE){b.className=this.CSS.BASE;}return b;},_updateHueSlider:function(){var b=this.get(this.OPT.PICKER_SIZE),l=this.get(this.OPT.HUE);l=b-Math.round(l/360*b);if(l===b){l=0;}this.hueSlider.setValue(l,this.skipAnim);},_updatePickerSlider:function(){var l=this.get(this.OPT.PICKER_SIZE),m=this.get(this.OPT.SATURATION),b=this.get(this.OPT.VALUE);m=Math.round(m*l/100);b=Math.round(l-(b*l/100));this.pickerSlider.setRegionValue(m,b,this.skipAnim);},_updateSliders:function(){this._updateHueSlider();this._updatePickerSlider();},setValue:function(l,b){b=(b)||false;this.set(this.OPT.RGB,l,b);this._updateSliders();},hueSlider:null,pickerSlider:null,_getH:function(){var b=this.get(this.OPT.PICKER_SIZE),l=(b-this.hueSlider.getValue())/b;l=Math.round(l*360);return(l===360)?0:l;},_getS:function(){return this.pickerSlider.getXValue()/this.get(this.OPT.PICKER_SIZE);},_getV:function(){var b=this.get(this.OPT.PICKER_SIZE);return(b-this.pickerSlider.getYValue())/b;},_updateSwatch:function(){var m=this.get(this.OPT.RGB),o=this.get(this.OPT.WEBSAFE),n=this.getElement(this.ID.SWATCH),l=m.join(","),b=this.get(this.OPT.TXT);f.setStyle(n,"background-color","rgb("+l+")");n.title=a(b.CURRENT_COLOR,{"rgb":"#"+this.get(this.OPT.HEX)});n=this.getElement(this.ID.WEBSAFE_SWATCH);l=o.join(",");f.setStyle(n,"background-color","rgb("+l+")");n.title=a(b.CLOSEST_WEBSAFE,{"rgb":"#"+c.rgb2hex(o)});},_getValuesFromSliders:function(){this.set(this.OPT.RGB,c.hsv2rgb(this._getH(),this._getS(),this._getV()));},_updateFormFields:function(){this.getElement(this.ID.H).value=this.get(this.OPT.HUE);this.getElement(this.ID.S).value=this.get(this.OPT.SATURATION);this.getElement(this.ID.V).value=this.get(this.OPT.VALUE);this.getElement(this.ID.R).value=this.get(this.OPT.RED);this.getElement(this.ID.R_HEX).innerHTML=c.dec2hex(this.get(this.OPT.RED));this.getElement(this.ID.G).value=this.get(this.OPT.GREEN);this.getElement(this.ID.G_HEX).innerHTML=c.dec2hex(this.get(this.OPT.GREEN));this.getElement(this.ID.B).value=this.get(this.OPT.BLUE);this.getElement(this.ID.B_HEX).innerHTML=c.dec2hex(this.get(this.OPT.BLUE));this.getElement(this.ID.HEX).value=this.get(this.OPT.HEX);},_onHueSliderChange:function(n){var l=this._getH(),b=c.hsv2rgb(l,1,1),m="rgb("+b.join(",")+")";this.set(this.OPT.HUE,l,true);f.setStyle(this.getElement(this.ID.PICKER_BG),"background-color",m);if(this.hueSlider.valueChangeSource!==e.SOURCE_SET_VALUE){this._getValuesFromSliders();}this._updateFormFields();this._updateSwatch();},_onPickerSliderChange:function(m){var l=this._getS(),b=this._getV();this.set(this.OPT.SATURATION,Math.round(l*100),true);this.set(this.OPT.VALUE,Math.round(b*100),true);if(this.pickerSlider.valueChangeSource!==e.SOURCE_SET_VALUE){this._getValuesFromSliders();
+}this._updateFormFields();this._updateSwatch();},_getCommand:function(b){var l=j.getCharCode(b);if(l===38){return 3;}else{if(l===13){return 6;}else{if(l===40){return 4;}else{if(l>=48&&l<=57){return 1;}else{if(l>=97&&l<=102){return 2;}else{if(l>=65&&l<=70){return 2;}else{if("8, 9, 13, 27, 37, 39".indexOf(l)>-1||b.ctrlKey||b.metaKey){return 5;}else{return 0;}}}}}}}},_useFieldValue:function(l,b,n){var m=b.value;if(n!==this.OPT.HEX){m=parseInt(m,10);}if(m!==this.get(n)){this.set(n,m);}},_rgbFieldKeypress:function(m,b,o){var n=this._getCommand(m),l=(m.shiftKey)?10:1;switch(n){case 6:this._useFieldValue.apply(this,arguments);break;case 3:this.set(o,Math.min(this.get(o)+l,255));this._updateFormFields();break;case 4:this.set(o,Math.max(this.get(o)-l,0));this._updateFormFields();break;default:}},_hexFieldKeypress:function(l,b,n){var m=this._getCommand(l);if(m===6){this._useFieldValue.apply(this,arguments);}},_hexOnly:function(l,b){var m=this._getCommand(l);switch(m){case 6:case 5:case 1:break;case 2:if(b!==true){break;}default:j.stopEvent(l);return false;}},_numbersOnly:function(b){return this._hexOnly(b,true);},getElement:function(b){return this.get(this.OPT.ELEMENTS)[this.get(this.OPT.IDS)[b]];},_createElements:function(){var n,m,q,o,l,b=this.get(this.OPT.IDS),r=this.get(this.OPT.TXT),t=this.get(this.OPT.IMAGES),s=function(p,v){var w=document.createElement(p);if(v){d.augmentObject(w,v,true);}return w;},u=function(p,v){var w=d.merge({autocomplete:"off",value:"0",size:3,maxlength:3},v);w.name=w.id;return new s(p,w);};l=this.get("element");n=new s("div",{id:b[this.ID.PICKER_BG],className:"yui-picker-bg",tabIndex:-1,hideFocus:true});m=new s("div",{id:b[this.ID.PICKER_THUMB],className:"yui-picker-thumb"});q=new s("img",{src:t.PICKER_THUMB});m.appendChild(q);n.appendChild(m);l.appendChild(n);n=new s("div",{id:b[this.ID.HUE_BG],className:"yui-picker-hue-bg",tabIndex:-1,hideFocus:true});m=new s("div",{id:b[this.ID.HUE_THUMB],className:"yui-picker-hue-thumb"});q=new s("img",{src:t.HUE_THUMB});m.appendChild(q);n.appendChild(m);l.appendChild(n);n=new s("div",{id:b[this.ID.CONTROLS],className:"yui-picker-controls"});l.appendChild(n);l=n;n=new s("div",{className:"hd"});m=new s("a",{id:b[this.ID.CONTROLS_LABEL],href:"#"});n.appendChild(m);l.appendChild(n);n=new s("div",{className:"bd"});l.appendChild(n);l=n;n=new s("ul",{id:b[this.ID.RGB_CONTROLS],className:"yui-picker-rgb-controls"});m=new s("li");m.appendChild(document.createTextNode(r.R+" "));o=new u("input",{id:b[this.ID.R],className:"yui-picker-r"});m.appendChild(o);n.appendChild(m);m=new s("li");m.appendChild(document.createTextNode(r.G+" "));o=new u("input",{id:b[this.ID.G],className:"yui-picker-g"});m.appendChild(o);n.appendChild(m);m=new s("li");m.appendChild(document.createTextNode(r.B+" "));o=new u("input",{id:b[this.ID.B],className:"yui-picker-b"});m.appendChild(o);n.appendChild(m);l.appendChild(n);n=new s("ul",{id:b[this.ID.HSV_CONTROLS],className:"yui-picker-hsv-controls"});m=new s("li");m.appendChild(document.createTextNode(r.H+" "));o=new u("input",{id:b[this.ID.H],className:"yui-picker-h"});m.appendChild(o);m.appendChild(document.createTextNode(" "+r.DEG));n.appendChild(m);m=new s("li");m.appendChild(document.createTextNode(r.S+" "));o=new u("input",{id:b[this.ID.S],className:"yui-picker-s"});m.appendChild(o);m.appendChild(document.createTextNode(" "+r.PERCENT));n.appendChild(m);m=new s("li");m.appendChild(document.createTextNode(r.V+" "));o=new u("input",{id:b[this.ID.V],className:"yui-picker-v"});m.appendChild(o);m.appendChild(document.createTextNode(" "+r.PERCENT));n.appendChild(m);l.appendChild(n);n=new s("ul",{id:b[this.ID.HEX_SUMMARY],className:"yui-picker-hex_summary"});m=new s("li",{id:b[this.ID.R_HEX]});n.appendChild(m);m=new s("li",{id:b[this.ID.G_HEX]});n.appendChild(m);m=new s("li",{id:b[this.ID.B_HEX]});n.appendChild(m);l.appendChild(n);n=new s("div",{id:b[this.ID.HEX_CONTROLS],className:"yui-picker-hex-controls"});n.appendChild(document.createTextNode(r.HEX+" "));m=new u("input",{id:b[this.ID.HEX],className:"yui-picker-hex",size:6,maxlength:6});n.appendChild(m);l.appendChild(n);l=this.get("element");n=new s("div",{id:b[this.ID.SWATCH],className:"yui-picker-swatch"});l.appendChild(n);n=new s("div",{id:b[this.ID.WEBSAFE_SWATCH],className:"yui-picker-websafe-swatch"});l.appendChild(n);},_attachRGBHSV:function(l,b){j.on(this.getElement(l),"keydown",function(n,m){m._rgbFieldKeypress(n,this,b);},this);j.on(this.getElement(l),"keypress",this._numbersOnly,this,true);j.on(this.getElement(l),"blur",function(n,m){m._useFieldValue(n,this,b);},this);},_updateRGB:function(){var b=[this.get(this.OPT.RED),this.get(this.OPT.GREEN),this.get(this.OPT.BLUE)];this.set(this.OPT.RGB,b);this._updateSliders();},_initElements:function(){var p=this.OPT,n=this.get(p.IDS),l=this.get(p.ELEMENTS),b,m,q;for(b in this.ID){if(d.hasOwnProperty(this.ID,b)){n[this.ID[b]]=n[b];}}m=f.get(n[this.ID.PICKER_BG]);if(!m){this._createElements();}else{}for(b in n){if(d.hasOwnProperty(n,b)){m=f.get(n[b]);q=f.generateId(m);n[b]=q;n[n[b]]=q;l[q]=m;}}},initPicker:function(){this._initSliders();this._bindUI();this.syncUI(true);},_initSliders:function(){var b=this.ID,l=this.get(this.OPT.PICKER_SIZE);this.hueSlider=e.getVertSlider(this.getElement(b.HUE_BG),this.getElement(b.HUE_THUMB),0,l);this.pickerSlider=e.getSliderRegion(this.getElement(b.PICKER_BG),this.getElement(b.PICKER_THUMB),0,l,0,l);this.set(this.OPT.ANIMATE,this.get(this.OPT.ANIMATE));},_bindUI:function(){var b=this.ID,l=this.OPT;this.hueSlider.subscribe("change",this._onHueSliderChange,this,true);this.pickerSlider.subscribe("change",this._onPickerSliderChange,this,true);j.on(this.getElement(b.WEBSAFE_SWATCH),"click",function(m){this.setValue(this.get(l.WEBSAFE));},this,true);j.on(this.getElement(b.CONTROLS_LABEL),"click",function(m){this.set(l.SHOW_CONTROLS,!this.get(l.SHOW_CONTROLS));j.preventDefault(m);},this,true);this._attachRGBHSV(b.R,l.RED);this._attachRGBHSV(b.G,l.GREEN);this._attachRGBHSV(b.B,l.BLUE);this._attachRGBHSV(b.H,l.HUE);
+this._attachRGBHSV(b.S,l.SATURATION);this._attachRGBHSV(b.V,l.VALUE);j.on(this.getElement(b.HEX),"keydown",function(n,m){m._hexFieldKeypress(n,this,l.HEX);},this);j.on(this.getElement(this.ID.HEX),"keypress",this._hexOnly,this,true);j.on(this.getElement(this.ID.HEX),"blur",function(n,m){m._useFieldValue(n,this,l.HEX);},this);},syncUI:function(b){this.skipAnim=b;this._updateRGB();this.skipAnim=false;},_updateRGBFromHSV:function(){var l=[this.get(this.OPT.HUE),this.get(this.OPT.SATURATION)/100,this.get(this.OPT.VALUE)/100],b=c.hsv2rgb(l);this.set(this.OPT.RGB,b);this._updateSliders();},_updateHex:function(){var o=this.get(this.OPT.HEX),b=o.length,p,n,m;if(b===3){p=o.split("");for(n=0;n<b;n=n+1){p[n]=p[n]+p[n];}o=p.join("");}if(o.length!==6){return false;}m=c.hex2rgb(o);this.setValue(m);},_hideShowEl:function(m,b){var l=(d.isString(m)?this.getElement(m):m);f.setStyle(l,"display",(b)?"":"none");},initAttributes:function(b){b=b||{};h.superclass.initAttributes.call(this,b);this.setAttributeConfig(this.OPT.PICKER_SIZE,{value:b.size||this.DEFAULT.PICKER_SIZE});this.setAttributeConfig(this.OPT.HUE,{value:b.hue||0,validator:d.isNumber});this.setAttributeConfig(this.OPT.SATURATION,{value:b.saturation||0,validator:d.isNumber});this.setAttributeConfig(this.OPT.VALUE,{value:d.isNumber(b.value)?b.value:100,validator:d.isNumber});this.setAttributeConfig(this.OPT.RED,{value:d.isNumber(b.red)?b.red:255,validator:d.isNumber});this.setAttributeConfig(this.OPT.GREEN,{value:d.isNumber(b.green)?b.green:255,validator:d.isNumber});this.setAttributeConfig(this.OPT.BLUE,{value:d.isNumber(b.blue)?b.blue:255,validator:d.isNumber});this.setAttributeConfig(this.OPT.HEX,{value:b.hex||"FFFFFF",validator:d.isString});this.setAttributeConfig(this.OPT.RGB,{value:b.rgb||[255,255,255],method:function(o){this.set(this.OPT.RED,o[0],true);this.set(this.OPT.GREEN,o[1],true);this.set(this.OPT.BLUE,o[2],true);var q=c.websafe(o),p=c.rgb2hex(o),n=c.rgb2hsv(o);this.set(this.OPT.WEBSAFE,q,true);this.set(this.OPT.HEX,p,true);if(n[1]){this.set(this.OPT.HUE,n[0],true);}this.set(this.OPT.SATURATION,Math.round(n[1]*100),true);this.set(this.OPT.VALUE,Math.round(n[2]*100),true);},readonly:true});this.setAttributeConfig(this.OPT.CONTAINER,{value:null,method:function(n){if(n){n.showEvent.subscribe(function(){this.pickerSlider.focus();},this,true);}}});this.setAttributeConfig(this.OPT.WEBSAFE,{value:b.websafe||[255,255,255]});var m=b.ids||d.merge({},this.ID),l;if(!b.ids&&k>1){for(l in m){if(d.hasOwnProperty(m,l)){m[l]=m[l]+k;}}}this.setAttributeConfig(this.OPT.IDS,{value:m,writeonce:true});this.setAttributeConfig(this.OPT.TXT,{value:b.txt||this.TXT,writeonce:true});this.setAttributeConfig(this.OPT.IMAGES,{value:b.images||this.IMAGE,writeonce:true});this.setAttributeConfig(this.OPT.ELEMENTS,{value:{},readonly:true});this.setAttributeConfig(this.OPT.SHOW_CONTROLS,{value:d.isBoolean(b.showcontrols)?b.showcontrols:true,method:function(n){var o=f.getElementsByClassName("bd","div",this.getElement(this.ID.CONTROLS))[0];this._hideShowEl(o,n);this.getElement(this.ID.CONTROLS_LABEL).innerHTML=(n)?this.get(this.OPT.TXT).HIDE_CONTROLS:this.get(this.OPT.TXT).SHOW_CONTROLS;}});this.setAttributeConfig(this.OPT.SHOW_RGB_CONTROLS,{value:d.isBoolean(b.showrgbcontrols)?b.showrgbcontrols:true,method:function(n){this._hideShowEl(this.ID.RGB_CONTROLS,n);}});this.setAttributeConfig(this.OPT.SHOW_HSV_CONTROLS,{value:d.isBoolean(b.showhsvcontrols)?b.showhsvcontrols:false,method:function(n){this._hideShowEl(this.ID.HSV_CONTROLS,n);if(n&&this.get(this.OPT.SHOW_HEX_SUMMARY)){this.set(this.OPT.SHOW_HEX_SUMMARY,false);}}});this.setAttributeConfig(this.OPT.SHOW_HEX_CONTROLS,{value:d.isBoolean(b.showhexcontrols)?b.showhexcontrols:false,method:function(n){this._hideShowEl(this.ID.HEX_CONTROLS,n);}});this.setAttributeConfig(this.OPT.SHOW_WEBSAFE,{value:d.isBoolean(b.showwebsafe)?b.showwebsafe:true,method:function(n){this._hideShowEl(this.ID.WEBSAFE_SWATCH,n);}});this.setAttributeConfig(this.OPT.SHOW_HEX_SUMMARY,{value:d.isBoolean(b.showhexsummary)?b.showhexsummary:true,method:function(n){this._hideShowEl(this.ID.HEX_SUMMARY,n);if(n&&this.get(this.OPT.SHOW_HSV_CONTROLS)){this.set(this.OPT.SHOW_HSV_CONTROLS,false);}}});this.setAttributeConfig(this.OPT.ANIMATE,{value:d.isBoolean(b.animate)?b.animate:true,method:function(n){if(this.pickerSlider){this.pickerSlider.animate=n;this.hueSlider.animate=n;}}});this.on(this.OPT.HUE+"Change",this._updateRGBFromHSV,this,true);this.on(this.OPT.SATURATION+"Change",this._updateRGBFromHSV,this,true);this.on(this.OPT.VALUE+"Change",this._updateRGBFromHSV,this,true);this.on(this.OPT.RED+"Change",this._updateRGB,this,true);this.on(this.OPT.GREEN+"Change",this._updateRGB,this,true);this.on(this.OPT.BLUE+"Change",this._updateRGB,this,true);this.on(this.OPT.HEX+"Change",this._updateHex,this,true);this._initElements();}});YAHOO.widget.ColorPicker=h;})();YAHOO.register("colorpicker",YAHOO.widget.ColorPicker,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/connection/connection-min.js b/js/yui/connection/connection-min.js
new file mode 100644 (file)
index 0000000..c0ec748
--- /dev/null
+++ b/js/yui/connection/connection-min.js
@@ -0,0 +1,9 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.util.Connect={_msxml_progid:["Microsoft.XMLHTTP","MSXML2.XMLHTTP.3.0","MSXML2.XMLHTTP"],_http_headers:{},_has_http_headers:false,_use_default_post_header:true,_default_post_header:"application/x-www-form-urlencoded; charset=UTF-8",_default_form_header:"application/x-www-form-urlencoded",_use_default_xhr_header:true,_default_xhr_header:"XMLHttpRequest",_has_default_headers:true,_isFormSubmit:false,_default_headers:{},_poll:{},_timeOut:{},_polling_interval:50,_transaction_id:0,startEvent:new YAHOO.util.CustomEvent("start"),completeEvent:new YAHOO.util.CustomEvent("complete"),successEvent:new YAHOO.util.CustomEvent("success"),failureEvent:new YAHOO.util.CustomEvent("failure"),abortEvent:new YAHOO.util.CustomEvent("abort"),_customEvents:{onStart:["startEvent","start"],onComplete:["completeEvent","complete"],onSuccess:["successEvent","success"],onFailure:["failureEvent","failure"],onUpload:["uploadEvent","upload"],onAbort:["abortEvent","abort"]},setProgId:function(a){this._msxml_progid.unshift(a);},setDefaultPostHeader:function(a){if(typeof a=="string"){this._default_post_header=a;this._use_default_post_header=true;}else{if(typeof a=="boolean"){this._use_default_post_header=a;}}},setDefaultXhrHeader:function(a){if(typeof a=="string"){this._default_xhr_header=a;}else{this._use_default_xhr_header=a;}},setPollingInterval:function(a){if(typeof a=="number"&&isFinite(a)){this._polling_interval=a;}},createXhrObject:function(g){var d,a,b;try{a=new XMLHttpRequest();d={conn:a,tId:g,xhr:true};}catch(c){for(b=0;b<this._msxml_progid.length;++b){try{a=new ActiveXObject(this._msxml_progid[b]);d={conn:a,tId:g,xhr:true};break;}catch(f){}}}finally{return d;}},getConnectionObject:function(a){var c,d=this._transaction_id;try{if(!a){c=this.createXhrObject(d);}else{c={tId:d};if(a==="xdr"){c.conn=this._transport;c.xdr=true;}else{if(a==="upload"){c.upload=true;}}}if(c){this._transaction_id++;}}catch(b){}return c;},asyncRequest:function(h,d,g,a){var b=g&&g.argument?g.argument:null,e=this,f,c;if(this._isFileUpload){c="upload";}else{if(g&&g.xdr){c="xdr";}}f=this.getConnectionObject(c);if(!f){return null;}else{if(g&&g.customevents){this.initCustomEvents(f,g);}if(this._isFormSubmit){if(this._isFileUpload){window.setTimeout(function(){e.uploadFile(f,g,d,a);},10);return f;}if(h.toUpperCase()=="GET"){if(this._sFormData.length!==0){d+=((d.indexOf("?")==-1)?"?":"&")+this._sFormData;}}else{if(h.toUpperCase()=="POST"){a=a?this._sFormData+"&"+a:this._sFormData;}}}if(h.toUpperCase()=="GET"&&(g&&g.cache===false)){d+=((d.indexOf("?")==-1)?"?":"&")+"rnd="+new Date().valueOf().toString();}if(this._use_default_xhr_header){if(!this._default_headers["X-Requested-With"]){this.initHeader("X-Requested-With",this._default_xhr_header,true);}}if((h.toUpperCase()==="POST"&&this._use_default_post_header)&&this._isFormSubmit===false){this.initHeader("Content-Type",this._default_post_header);}if(f.xdr){this.xdr(f,h,d,g,a);return f;}f.conn.open(h,d,true);if(this._has_default_headers||this._has_http_headers){this.setHeader(f);}this.handleReadyState(f,g);f.conn.send(a||"");if(this._isFormSubmit===true){this.resetFormState();}this.startEvent.fire(f,b);if(f.startEvent){f.startEvent.fire(f,b);}return f;}},initCustomEvents:function(a,c){var b;for(b in c.customevents){if(this._customEvents[b][0]){a[this._customEvents[b][0]]=new YAHOO.util.CustomEvent(this._customEvents[b][1],(c.scope)?c.scope:null);a[this._customEvents[b][0]].subscribe(c.customevents[b]);}}},handleReadyState:function(c,d){var b=this,a=(d&&d.argument)?d.argument:null;if(d&&d.timeout){this._timeOut[c.tId]=window.setTimeout(function(){b.abort(c,d,true);},d.timeout);}this._poll[c.tId]=window.setInterval(function(){if(c.conn&&c.conn.readyState===4){window.clearInterval(b._poll[c.tId]);delete b._poll[c.tId];if(d&&d.timeout){window.clearTimeout(b._timeOut[c.tId]);delete b._timeOut[c.tId];}b.completeEvent.fire(c,a);if(c.completeEvent){c.completeEvent.fire(c,a);}b.handleTransactionResponse(c,d);}},this._polling_interval);},handleTransactionResponse:function(b,j,d){var f,a,h=(j&&j.argument)?j.argument:null,c=(b.r&&b.r.statusText==="xdr:success")?true:false,i=(b.r&&b.r.statusText==="xdr:failure")?true:false,k=d;try{if((b.conn.status!==undefined&&b.conn.status!==0)||c){f=b.conn.status;}else{if(i&&!k){f=0;}else{f=13030;}}}catch(g){f=13030;}if((f>=200&&f<300)||f===1223||c){a=b.xdr?b.r:this.createResponseObject(b,h);if(j&&j.success){if(!j.scope){j.success(a);}else{j.success.apply(j.scope,[a]);}}this.successEvent.fire(a);if(b.successEvent){b.successEvent.fire(a);}}else{switch(f){case 12002:case 12029:case 12030:case 12031:case 12152:case 13030:a=this.createExceptionObject(b.tId,h,(d?d:false));if(j&&j.failure){if(!j.scope){j.failure(a);}else{j.failure.apply(j.scope,[a]);}}break;default:a=(b.xdr)?b.response:this.createResponseObject(b,h);if(j&&j.failure){if(!j.scope){j.failure(a);}else{j.failure.apply(j.scope,[a]);}}}this.failureEvent.fire(a);if(b.failureEvent){b.failureEvent.fire(a);}}this.releaseObject(b);a=null;},createResponseObject:function(a,h){var d={},k={},f,c,g,b;try{c=a.conn.getAllResponseHeaders();g=c.split("\n");for(f=0;f<g.length;f++){b=g[f].indexOf(":");if(b!=-1){k[g[f].substring(0,b)]=YAHOO.lang.trim(g[f].substring(b+2));}}}catch(j){}d.tId=a.tId;d.status=(a.conn.status==1223)?204:a.conn.status;d.statusText=(a.conn.status==1223)?"No Content":a.conn.statusText;d.getResponseHeader=k;d.getAllResponseHeaders=c;d.responseText=a.conn.responseText;d.responseXML=a.conn.responseXML;if(h){d.argument=h;}return d;},createExceptionObject:function(h,d,a){var f=0,g="communication failure",c=-1,b="transaction aborted",e={};e.tId=h;if(a){e.status=c;e.statusText=b;}else{e.status=f;e.statusText=g;}if(d){e.argument=d;}return e;},initHeader:function(a,d,c){var b=(c)?this._default_headers:this._http_headers;b[a]=d;if(c){this._has_default_headers=true;}else{this._has_http_headers=true;}},setHeader:function(a){var b;if(this._has_default_headers){for(b in this._default_headers){if(YAHOO.lang.hasOwnProperty(this._default_headers,b)){a.conn.setRequestHeader(b,this._default_headers[b]);
+}}}if(this._has_http_headers){for(b in this._http_headers){if(YAHOO.lang.hasOwnProperty(this._http_headers,b)){a.conn.setRequestHeader(b,this._http_headers[b]);}}this._http_headers={};this._has_http_headers=false;}},resetDefaultHeaders:function(){this._default_headers={};this._has_default_headers=false;},abort:function(e,g,a){var d,b=(g&&g.argument)?g.argument:null;e=e||{};if(e.conn){if(e.xhr){if(this.isCallInProgress(e)){e.conn.abort();window.clearInterval(this._poll[e.tId]);delete this._poll[e.tId];if(a){window.clearTimeout(this._timeOut[e.tId]);delete this._timeOut[e.tId];}d=true;}}else{if(e.xdr){e.conn.abort(e.tId);d=true;}}}else{if(e.upload){var c="yuiIO"+e.tId;var f=document.getElementById(c);if(f){YAHOO.util.Event.removeListener(f,"load");document.body.removeChild(f);if(a){window.clearTimeout(this._timeOut[e.tId]);delete this._timeOut[e.tId];}d=true;}}else{d=false;}}if(d===true){this.abortEvent.fire(e,b);if(e.abortEvent){e.abortEvent.fire(e,b);}this.handleTransactionResponse(e,g,true);}return d;},isCallInProgress:function(a){a=a||{};if(a.xhr&&a.conn){return a.conn.readyState!==4&&a.conn.readyState!==0;}else{if(a.xdr&&a.conn){return a.conn.isCallInProgress(a.tId);}else{if(a.upload===true){return document.getElementById("yuiIO"+a.tId)?true:false;}else{return false;}}}},releaseObject:function(a){if(a&&a.conn){a.conn=null;a=null;}}};(function(){var g=YAHOO.util.Connect,h={};function d(i){var j='<object id="YUIConnectionSwf" type="application/x-shockwave-flash" data="'+i+'" width="0" height="0">'+'<param name="movie" value="'+i+'">'+'<param name="allowScriptAccess" value="always">'+"</object>",k=document.createElement("div");document.body.appendChild(k);k.innerHTML=j;}function b(l,i,j,n,k){h[parseInt(l.tId)]={"o":l,"c":n};if(k){n.method=i;n.data=k;}l.conn.send(j,n,l.tId);}function e(i){d(i);g._transport=document.getElementById("YUIConnectionSwf");}function c(){g.xdrReadyEvent.fire();}function a(j,i){if(j){g.startEvent.fire(j,i.argument);if(j.startEvent){j.startEvent.fire(j,i.argument);}}}function f(j){var k=h[j.tId].o,i=h[j.tId].c;if(j.statusText==="xdr:start"){a(k,i);return;}j.responseText=decodeURI(j.responseText);k.r=j;if(i.argument){k.r.argument=i.argument;}this.handleTransactionResponse(k,i,j.statusText==="xdr:abort"?true:false);delete h[j.tId];}g.xdr=b;g.swf=d;g.transport=e;g.xdrReadyEvent=new YAHOO.util.CustomEvent("xdrReady");g.xdrReady=c;g.handleXdrResponse=f;})();(function(){var e=YAHOO.util.Connect,g=YAHOO.util.Event,a=document.documentMode?document.documentMode:false;e._isFileUpload=false;e._formNode=null;e._sFormData=null;e._submitElementValue=null;e.uploadEvent=new YAHOO.util.CustomEvent("upload");e._hasSubmitListener=function(){if(g){g.addListener(document,"click",function(k){var j=g.getTarget(k),i=j.nodeName.toLowerCase();if((i==="input"||i==="button")&&(j.type&&j.type.toLowerCase()=="submit")){e._submitElementValue=encodeURIComponent(j.name)+"="+encodeURIComponent(j.value);}});return true;}return false;}();function h(w,r,m){var v,l,u,s,z,t=false,p=[],y=0,o,q,n,x,k;this.resetFormState();if(typeof w=="string"){v=(document.getElementById(w)||document.forms[w]);}else{if(typeof w=="object"){v=w;}else{return;}}if(r){this.createFrame(m?m:null);this._isFormSubmit=true;this._isFileUpload=true;this._formNode=v;return;}for(o=0,q=v.elements.length;o<q;++o){l=v.elements[o];z=l.disabled;u=l.name;if(!z&&u){u=encodeURIComponent(u)+"=";s=encodeURIComponent(l.value);switch(l.type){case"select-one":if(l.selectedIndex>-1){k=l.options[l.selectedIndex];p[y++]=u+encodeURIComponent((k.attributes.value&&k.attributes.value.specified)?k.value:k.text);}break;case"select-multiple":if(l.selectedIndex>-1){for(n=l.selectedIndex,x=l.options.length;n<x;++n){k=l.options[n];if(k.selected){p[y++]=u+encodeURIComponent((k.attributes.value&&k.attributes.value.specified)?k.value:k.text);}}}break;case"radio":case"checkbox":if(l.checked){p[y++]=u+s;}break;case"file":case undefined:case"reset":case"button":break;case"submit":if(t===false){if(this._hasSubmitListener&&this._submitElementValue){p[y++]=this._submitElementValue;}t=true;}break;default:p[y++]=u+s;}}}this._isFormSubmit=true;this._sFormData=p.join("&");this.initHeader("Content-Type",this._default_form_header);return this._sFormData;}function d(){this._isFormSubmit=false;this._isFileUpload=false;this._formNode=null;this._sFormData="";}function c(i){var j="yuiIO"+this._transaction_id,l=(a===9)?true:false,k;if(YAHOO.env.ua.ie&&!l){k=document.createElement('<iframe id="'+j+'" name="'+j+'" />');if(typeof i=="boolean"){k.src="javascript:false";}}else{k=document.createElement("iframe");k.id=j;k.name=j;}k.style.position="absolute";k.style.top="-1000px";k.style.left="-1000px";document.body.appendChild(k);}function f(j){var m=[],k=j.split("&"),l,n;for(l=0;l<k.length;l++){n=k[l].indexOf("=");if(n!=-1){m[l]=document.createElement("input");m[l].type="hidden";m[l].name=decodeURIComponent(k[l].substring(0,n));m[l].value=decodeURIComponent(k[l].substring(n+1));this._formNode.appendChild(m[l]);}}return m;}function b(m,y,n,l){var t="yuiIO"+m.tId,u="multipart/form-data",w=document.getElementById(t),p=(a>=8)?true:false,z=this,v=(y&&y.argument)?y.argument:null,x,s,k,r,j,q;j={action:this._formNode.getAttribute("action"),method:this._formNode.getAttribute("method"),target:this._formNode.getAttribute("target")};this._formNode.setAttribute("action",n);this._formNode.setAttribute("method","POST");this._formNode.setAttribute("target",t);if(YAHOO.env.ua.ie&&!p){this._formNode.setAttribute("encoding",u);}else{this._formNode.setAttribute("enctype",u);}if(l){x=this.appendPostData(l);}this._formNode.submit();this.startEvent.fire(m,v);if(m.startEvent){m.startEvent.fire(m,v);}if(y&&y.timeout){this._timeOut[m.tId]=window.setTimeout(function(){z.abort(m,y,true);},y.timeout);}if(x&&x.length>0){for(s=0;s<x.length;s++){this._formNode.removeChild(x[s]);}}for(k in j){if(YAHOO.lang.hasOwnProperty(j,k)){if(j[k]){this._formNode.setAttribute(k,j[k]);}else{this._formNode.removeAttribute(k);}}}this.resetFormState();
+q=function(){var i,A,B;if(y&&y.timeout){window.clearTimeout(z._timeOut[m.tId]);delete z._timeOut[m.tId];}z.completeEvent.fire(m,v);if(m.completeEvent){m.completeEvent.fire(m,v);}r={tId:m.tId,argument:v};try{i=w.contentWindow.document.getElementsByTagName("body")[0];A=w.contentWindow.document.getElementsByTagName("pre")[0];if(i){if(A){B=A.textContent?A.textContent:A.innerText;}else{B=i.textContent?i.textContent:i.innerText;}}r.responseText=B;r.responseXML=w.contentWindow.document.XMLDocument?w.contentWindow.document.XMLDocument:w.contentWindow.document;}catch(o){}if(y&&y.upload){if(!y.scope){y.upload(r);}else{y.upload.apply(y.scope,[r]);}}z.uploadEvent.fire(r);if(m.uploadEvent){m.uploadEvent.fire(r);}g.removeListener(w,"load",q);setTimeout(function(){document.body.removeChild(w);z.releaseObject(m);},100);};g.addListener(w,"load",q);}e.setForm=h;e.resetFormState=d;e.createFrame=c;e.appendPostData=f;e.uploadFile=b;})();YAHOO.register("connection",YAHOO.util.Connect,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/connection/connection.swf b/js/yui/connection/connection.swf
new file mode 100644 (file)
index 0000000..c33a7fe
Binary files /dev/null and b/js/yui/connection/connection.swf differ

diff --git a/js/yui/connection/connection_core-min.js b/js/yui/connection/connection_core-min.js
new file mode 100644 (file)
index 0000000..c51420f
--- /dev/null
+++ b/js/yui/connection/connection_core-min.js
@@ -0,0 +1,8 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.util.Connect={_msxml_progid:["Microsoft.XMLHTTP","MSXML2.XMLHTTP.3.0","MSXML2.XMLHTTP"],_http_headers:{},_has_http_headers:false,_use_default_post_header:true,_default_post_header:"application/x-www-form-urlencoded; charset=UTF-8",_default_form_header:"application/x-www-form-urlencoded",_use_default_xhr_header:true,_default_xhr_header:"XMLHttpRequest",_has_default_headers:true,_isFormSubmit:false,_default_headers:{},_poll:{},_timeOut:{},_polling_interval:50,_transaction_id:0,startEvent:new YAHOO.util.CustomEvent("start"),completeEvent:new YAHOO.util.CustomEvent("complete"),successEvent:new YAHOO.util.CustomEvent("success"),failureEvent:new YAHOO.util.CustomEvent("failure"),abortEvent:new YAHOO.util.CustomEvent("abort"),_customEvents:{onStart:["startEvent","start"],onComplete:["completeEvent","complete"],onSuccess:["successEvent","success"],onFailure:["failureEvent","failure"],onUpload:["uploadEvent","upload"],onAbort:["abortEvent","abort"]},setProgId:function(A){this._msxml_progid.unshift(A);},setDefaultPostHeader:function(A){if(typeof A=="string"){this._default_post_header=A;this._use_default_post_header=true;}else{if(typeof A=="boolean"){this._use_default_post_header=A;}}},setDefaultXhrHeader:function(A){if(typeof A=="string"){this._default_xhr_header=A;}else{this._use_default_xhr_header=A;}},setPollingInterval:function(A){if(typeof A=="number"&&isFinite(A)){this._polling_interval=A;}},createXhrObject:function(F){var D,A,B;try{A=new XMLHttpRequest();D={conn:A,tId:F,xhr:true};}catch(C){for(B=0;B<this._msxml_progid.length;++B){try{A=new ActiveXObject(this._msxml_progid[B]);D={conn:A,tId:F,xhr:true};break;}catch(E){}}}finally{return D;}},getConnectionObject:function(A){var C,D=this._transaction_id;try{if(!A){C=this.createXhrObject(D);}else{C={tId:D};if(A==="xdr"){C.conn=this._transport;C.xdr=true;}else{if(A==="upload"){C.upload=true;}}}if(C){this._transaction_id++;}}catch(B){}return C;},asyncRequest:function(H,D,G,A){var B=G&&G.argument?G.argument:null,E=this,F,C;if(this._isFileUpload){C="upload";}else{if(G&&G.xdr){C="xdr";}}F=this.getConnectionObject(C);if(!F){return null;}else{if(G&&G.customevents){this.initCustomEvents(F,G);}if(this._isFormSubmit){if(this._isFileUpload){window.setTimeout(function(){E.uploadFile(F,G,D,A);},10);return F;}if(H.toUpperCase()=="GET"){if(this._sFormData.length!==0){D+=((D.indexOf("?")==-1)?"?":"&")+this._sFormData;}}else{if(H.toUpperCase()=="POST"){A=A?this._sFormData+"&"+A:this._sFormData;}}}if(H.toUpperCase()=="GET"&&(G&&G.cache===false)){D+=((D.indexOf("?")==-1)?"?":"&")+"rnd="+new Date().valueOf().toString();}if(this._use_default_xhr_header){if(!this._default_headers["X-Requested-With"]){this.initHeader("X-Requested-With",this._default_xhr_header,true);}}if((H.toUpperCase()==="POST"&&this._use_default_post_header)&&this._isFormSubmit===false){this.initHeader("Content-Type",this._default_post_header);}if(F.xdr){this.xdr(F,H,D,G,A);return F;}F.conn.open(H,D,true);if(this._has_default_headers||this._has_http_headers){this.setHeader(F);}this.handleReadyState(F,G);F.conn.send(A||"");if(this._isFormSubmit===true){this.resetFormState();}this.startEvent.fire(F,B);if(F.startEvent){F.startEvent.fire(F,B);}return F;}},initCustomEvents:function(A,C){var B;for(B in C.customevents){if(this._customEvents[B][0]){A[this._customEvents[B][0]]=new YAHOO.util.CustomEvent(this._customEvents[B][1],(C.scope)?C.scope:null);A[this._customEvents[B][0]].subscribe(C.customevents[B]);}}},handleReadyState:function(C,D){var B=this,A=(D&&D.argument)?D.argument:null;if(D&&D.timeout){this._timeOut[C.tId]=window.setTimeout(function(){B.abort(C,D,true);},D.timeout);}this._poll[C.tId]=window.setInterval(function(){if(C.conn&&C.conn.readyState===4){window.clearInterval(B._poll[C.tId]);delete B._poll[C.tId];if(D&&D.timeout){window.clearTimeout(B._timeOut[C.tId]);delete B._timeOut[C.tId];}B.completeEvent.fire(C,A);if(C.completeEvent){C.completeEvent.fire(C,A);}B.handleTransactionResponse(C,D);}},this._polling_interval);},handleTransactionResponse:function(B,I,D){var E,A,G=(I&&I.argument)?I.argument:null,C=(B.r&&B.r.statusText==="xdr:success")?true:false,H=(B.r&&B.r.statusText==="xdr:failure")?true:false,J=D;try{if((B.conn.status!==undefined&&B.conn.status!==0)||C){E=B.conn.status;}else{if(H&&!J){E=0;}else{E=13030;}}}catch(F){E=13030;}if((E>=200&&E<300)||E===1223||C){A=B.xdr?B.r:this.createResponseObject(B,G);if(I&&I.success){if(!I.scope){I.success(A);}else{I.success.apply(I.scope,[A]);}}this.successEvent.fire(A);if(B.successEvent){B.successEvent.fire(A);}}else{switch(E){case 12002:case 12029:case 12030:case 12031:case 12152:case 13030:A=this.createExceptionObject(B.tId,G,(D?D:false));if(I&&I.failure){if(!I.scope){I.failure(A);}else{I.failure.apply(I.scope,[A]);}}break;default:A=(B.xdr)?B.response:this.createResponseObject(B,G);if(I&&I.failure){if(!I.scope){I.failure(A);}else{I.failure.apply(I.scope,[A]);}}}this.failureEvent.fire(A);if(B.failureEvent){B.failureEvent.fire(A);}}this.releaseObject(B);A=null;},createResponseObject:function(A,G){var D={},I={},E,C,F,B;try{C=A.conn.getAllResponseHeaders();F=C.split("\n");for(E=0;E<F.length;E++){B=F[E].indexOf(":");if(B!=-1){I[F[E].substring(0,B)]=YAHOO.lang.trim(F[E].substring(B+2));}}}catch(H){}D.tId=A.tId;D.status=(A.conn.status==1223)?204:A.conn.status;D.statusText=(A.conn.status==1223)?"No Content":A.conn.statusText;D.getResponseHeader=I;D.getAllResponseHeaders=C;D.responseText=A.conn.responseText;D.responseXML=A.conn.responseXML;if(G){D.argument=G;}return D;},createExceptionObject:function(H,D,A){var F=0,G="communication failure",C=-1,B="transaction aborted",E={};E.tId=H;if(A){E.status=C;E.statusText=B;}else{E.status=F;E.statusText=G;}if(D){E.argument=D;}return E;},initHeader:function(A,D,C){var B=(C)?this._default_headers:this._http_headers;B[A]=D;if(C){this._has_default_headers=true;}else{this._has_http_headers=true;}},setHeader:function(A){var B;if(this._has_default_headers){for(B in this._default_headers){if(YAHOO.lang.hasOwnProperty(this._default_headers,B)){A.conn.setRequestHeader(B,this._default_headers[B]);
+}}}if(this._has_http_headers){for(B in this._http_headers){if(YAHOO.lang.hasOwnProperty(this._http_headers,B)){A.conn.setRequestHeader(B,this._http_headers[B]);}}this._http_headers={};this._has_http_headers=false;}},resetDefaultHeaders:function(){this._default_headers={};this._has_default_headers=false;},abort:function(E,G,A){var D,B=(G&&G.argument)?G.argument:null;E=E||{};if(E.conn){if(E.xhr){if(this.isCallInProgress(E)){E.conn.abort();window.clearInterval(this._poll[E.tId]);delete this._poll[E.tId];if(A){window.clearTimeout(this._timeOut[E.tId]);delete this._timeOut[E.tId];}D=true;}}else{if(E.xdr){E.conn.abort(E.tId);D=true;}}}else{if(E.upload){var C="yuiIO"+E.tId;var F=document.getElementById(C);if(F){YAHOO.util.Event.removeListener(F,"load");document.body.removeChild(F);if(A){window.clearTimeout(this._timeOut[E.tId]);delete this._timeOut[E.tId];}D=true;}}else{D=false;}}if(D===true){this.abortEvent.fire(E,B);if(E.abortEvent){E.abortEvent.fire(E,B);}this.handleTransactionResponse(E,G,true);}return D;},isCallInProgress:function(A){A=A||{};if(A.xhr&&A.conn){return A.conn.readyState!==4&&A.conn.readyState!==0;}else{if(A.xdr&&A.conn){return A.conn.isCallInProgress(A.tId);}else{if(A.upload===true){return document.getElementById("yuiIO"+A.tId)?true:false;}else{return false;}}}},releaseObject:function(A){if(A&&A.conn){A.conn=null;A=null;}}};YAHOO.register("connection_core",YAHOO.util.Connect,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/container/container-min.js b/js/yui/container/container-min.js
new file mode 100644 (file)
index 0000000..5be17aa
--- /dev/null
+++ b/js/yui/container/container-min.js
@@ -0,0 +1,19 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){YAHOO.util.Config=function(d){if(d){this.init(d);}};var b=YAHOO.lang,c=YAHOO.util.CustomEvent,a=YAHOO.util.Config;a.CONFIG_CHANGED_EVENT="configChanged";a.BOOLEAN_TYPE="boolean";a.prototype={owner:null,queueInProgress:false,config:null,initialConfig:null,eventQueue:null,configChangedEvent:null,init:function(d){this.owner=d;this.configChangedEvent=this.createEvent(a.CONFIG_CHANGED_EVENT);this.configChangedEvent.signature=c.LIST;this.queueInProgress=false;this.config={};this.initialConfig={};this.eventQueue=[];},checkBoolean:function(d){return(typeof d==a.BOOLEAN_TYPE);},checkNumber:function(d){return(!isNaN(d));},fireEvent:function(d,f){var e=this.config[d];if(e&&e.event){e.event.fire(f);}},addProperty:function(e,d){e=e.toLowerCase();this.config[e]=d;d.event=this.createEvent(e,{scope:this.owner});d.event.signature=c.LIST;d.key=e;if(d.handler){d.event.subscribe(d.handler,this.owner);}this.setProperty(e,d.value,true);if(!d.suppressEvent){this.queueProperty(e,d.value);}},getConfig:function(){var d={},f=this.config,g,e;for(g in f){if(b.hasOwnProperty(f,g)){e=f[g];if(e&&e.event){d[g]=e.value;}}}return d;},getProperty:function(d){var e=this.config[d.toLowerCase()];if(e&&e.event){return e.value;}else{return undefined;}},resetProperty:function(d){d=d.toLowerCase();var e=this.config[d];if(e&&e.event){if(d in this.initialConfig){this.setProperty(d,this.initialConfig[d]);return true;}}else{return false;}},setProperty:function(e,g,d){var f;e=e.toLowerCase();if(this.queueInProgress&&!d){this.queueProperty(e,g);return true;}else{f=this.config[e];if(f&&f.event){if(f.validator&&!f.validator(g)){return false;}else{f.value=g;if(!d){this.fireEvent(e,g);this.configChangedEvent.fire([e,g]);}return true;}}else{return false;}}},queueProperty:function(v,r){v=v.toLowerCase();var u=this.config[v],l=false,k,g,h,j,p,t,f,n,o,d,m,w,e;if(u&&u.event){if(!b.isUndefined(r)&&u.validator&&!u.validator(r)){return false;}else{if(!b.isUndefined(r)){u.value=r;}else{r=u.value;}l=false;k=this.eventQueue.length;for(m=0;m<k;m++){g=this.eventQueue[m];if(g){h=g[0];j=g[1];if(h==v){this.eventQueue[m]=null;this.eventQueue.push([v,(!b.isUndefined(r)?r:j)]);l=true;break;}}}if(!l&&!b.isUndefined(r)){this.eventQueue.push([v,r]);}}if(u.supercedes){p=u.supercedes.length;for(w=0;w<p;w++){t=u.supercedes[w];f=this.eventQueue.length;for(e=0;e<f;e++){n=this.eventQueue[e];if(n){o=n[0];d=n[1];if(o==t.toLowerCase()){this.eventQueue.push([o,d]);this.eventQueue[e]=null;break;}}}}}return true;}else{return false;}},refireEvent:function(d){d=d.toLowerCase();var e=this.config[d];if(e&&e.event&&!b.isUndefined(e.value)){if(this.queueInProgress){this.queueProperty(d);}else{this.fireEvent(d,e.value);}}},applyConfig:function(d,g){var f,e;if(g){e={};for(f in d){if(b.hasOwnProperty(d,f)){e[f.toLowerCase()]=d[f];}}this.initialConfig=e;}for(f in d){if(b.hasOwnProperty(d,f)){this.queueProperty(f,d[f]);}}},refresh:function(){var d;for(d in this.config){if(b.hasOwnProperty(this.config,d)){this.refireEvent(d);}}},fireQueue:function(){var e,h,d,g,f;this.queueInProgress=true;for(e=0;e<this.eventQueue.length;e++){h=this.eventQueue[e];if(h){d=h[0];g=h[1];f=this.config[d];f.value=g;this.eventQueue[e]=null;this.fireEvent(d,g);}}this.queueInProgress=false;this.eventQueue=[];},subscribeToConfigEvent:function(d,e,g,h){var f=this.config[d.toLowerCase()];if(f&&f.event){if(!a.alreadySubscribed(f.event,e,g)){f.event.subscribe(e,g,h);}return true;}else{return false;}},unsubscribeFromConfigEvent:function(d,e,g){var f=this.config[d.toLowerCase()];if(f&&f.event){return f.event.unsubscribe(e,g);}else{return false;}},toString:function(){var d="Config";if(this.owner){d+=" ["+this.owner.toString()+"]";}return d;},outputEventQueue:function(){var d="",g,e,f=this.eventQueue.length;for(e=0;e<f;e++){g=this.eventQueue[e];if(g){d+=g[0]+"="+g[1]+", ";}}return d;},destroy:function(){var e=this.config,d,f;for(d in e){if(b.hasOwnProperty(e,d)){f=e[d];f.event.unsubscribeAll();f.event=null;}}this.configChangedEvent.unsubscribeAll();this.configChangedEvent=null;this.owner=null;this.config=null;this.initialConfig=null;this.eventQueue=null;}};a.alreadySubscribed=function(e,h,j){var f=e.subscribers.length,d,g;if(f>0){g=f-1;do{d=e.subscribers[g];if(d&&d.obj==j&&d.fn==h){return true;}}while(g--);}return false;};YAHOO.lang.augmentProto(a,YAHOO.util.EventProvider);}());(function(){YAHOO.widget.Module=function(r,q){if(r){this.init(r,q);}else{}};var f=YAHOO.util.Dom,d=YAHOO.util.Config,n=YAHOO.util.Event,m=YAHOO.util.CustomEvent,g=YAHOO.widget.Module,i=YAHOO.env.ua,h,p,o,e,a={"BEFORE_INIT":"beforeInit","INIT":"init","APPEND":"append","BEFORE_RENDER":"beforeRender","RENDER":"render","CHANGE_HEADER":"changeHeader","CHANGE_BODY":"changeBody","CHANGE_FOOTER":"changeFooter","CHANGE_CONTENT":"changeContent","DESTROY":"destroy","BEFORE_SHOW":"beforeShow","SHOW":"show","BEFORE_HIDE":"beforeHide","HIDE":"hide"},j={"VISIBLE":{key:"visible",value:true,validator:YAHOO.lang.isBoolean},"EFFECT":{key:"effect",suppressEvent:true,supercedes:["visible"]},"MONITOR_RESIZE":{key:"monitorresize",value:true},"APPEND_TO_DOCUMENT_BODY":{key:"appendtodocumentbody",value:false}};g.IMG_ROOT=null;g.IMG_ROOT_SSL=null;g.CSS_MODULE="yui-module";g.CSS_HEADER="hd";g.CSS_BODY="bd";g.CSS_FOOTER="ft";g.RESIZE_MONITOR_SECURE_URL="javascript:false;";g.RESIZE_MONITOR_BUFFER=1;g.textResizeEvent=new m("textResize");g.forceDocumentRedraw=function(){var q=document.documentElement;if(q){q.className+=" ";q.className=YAHOO.lang.trim(q.className);}};function l(){if(!h){h=document.createElement("div");h.innerHTML=('<div class="'+g.CSS_HEADER+'"></div>'+'<div class="'+g.CSS_BODY+'"></div><div class="'+g.CSS_FOOTER+'"></div>');p=h.firstChild;o=p.nextSibling;e=o.nextSibling;}return h;}function k(){if(!p){l();}return(p.cloneNode(false));}function b(){if(!o){l();}return(o.cloneNode(false));}function c(){if(!e){l();}return(e.cloneNode(false));}g.prototype={constructor:g,element:null,header:null,body:null,footer:null,id:null,imageRoot:g.IMG_ROOT,initEvents:function(){var q=m.LIST;
+this.beforeInitEvent=this.createEvent(a.BEFORE_INIT);this.beforeInitEvent.signature=q;this.initEvent=this.createEvent(a.INIT);this.initEvent.signature=q;this.appendEvent=this.createEvent(a.APPEND);this.appendEvent.signature=q;this.beforeRenderEvent=this.createEvent(a.BEFORE_RENDER);this.beforeRenderEvent.signature=q;this.renderEvent=this.createEvent(a.RENDER);this.renderEvent.signature=q;this.changeHeaderEvent=this.createEvent(a.CHANGE_HEADER);this.changeHeaderEvent.signature=q;this.changeBodyEvent=this.createEvent(a.CHANGE_BODY);this.changeBodyEvent.signature=q;this.changeFooterEvent=this.createEvent(a.CHANGE_FOOTER);this.changeFooterEvent.signature=q;this.changeContentEvent=this.createEvent(a.CHANGE_CONTENT);this.changeContentEvent.signature=q;this.destroyEvent=this.createEvent(a.DESTROY);this.destroyEvent.signature=q;this.beforeShowEvent=this.createEvent(a.BEFORE_SHOW);this.beforeShowEvent.signature=q;this.showEvent=this.createEvent(a.SHOW);this.showEvent.signature=q;this.beforeHideEvent=this.createEvent(a.BEFORE_HIDE);this.beforeHideEvent.signature=q;this.hideEvent=this.createEvent(a.HIDE);this.hideEvent.signature=q;},platform:function(){var q=navigator.userAgent.toLowerCase();if(q.indexOf("windows")!=-1||q.indexOf("win32")!=-1){return"windows";}else{if(q.indexOf("macintosh")!=-1){return"mac";}else{return false;}}}(),browser:function(){var q=navigator.userAgent.toLowerCase();if(q.indexOf("opera")!=-1){return"opera";}else{if(q.indexOf("msie 7")!=-1){return"ie7";}else{if(q.indexOf("msie")!=-1){return"ie";}else{if(q.indexOf("safari")!=-1){return"safari";}else{if(q.indexOf("gecko")!=-1){return"gecko";}else{return false;}}}}}}(),isSecure:function(){if(window.location.href.toLowerCase().indexOf("https")===0){return true;}else{return false;}}(),initDefaultConfig:function(){this.cfg.addProperty(j.VISIBLE.key,{handler:this.configVisible,value:j.VISIBLE.value,validator:j.VISIBLE.validator});this.cfg.addProperty(j.EFFECT.key,{handler:this.configEffect,suppressEvent:j.EFFECT.suppressEvent,supercedes:j.EFFECT.supercedes});this.cfg.addProperty(j.MONITOR_RESIZE.key,{handler:this.configMonitorResize,value:j.MONITOR_RESIZE.value});this.cfg.addProperty(j.APPEND_TO_DOCUMENT_BODY.key,{value:j.APPEND_TO_DOCUMENT_BODY.value});},init:function(v,u){var s,w;this.initEvents();this.beforeInitEvent.fire(g);this.cfg=new d(this);if(this.isSecure){this.imageRoot=g.IMG_ROOT_SSL;}if(typeof v=="string"){s=v;v=document.getElementById(v);if(!v){v=(l()).cloneNode(false);v.id=s;}}this.id=f.generateId(v);this.element=v;w=this.element.firstChild;if(w){var r=false,q=false,t=false;do{if(1==w.nodeType){if(!r&&f.hasClass(w,g.CSS_HEADER)){this.header=w;r=true;}else{if(!q&&f.hasClass(w,g.CSS_BODY)){this.body=w;q=true;}else{if(!t&&f.hasClass(w,g.CSS_FOOTER)){this.footer=w;t=true;}}}}}while((w=w.nextSibling));}this.initDefaultConfig();f.addClass(this.element,g.CSS_MODULE);if(u){this.cfg.applyConfig(u,true);}if(!d.alreadySubscribed(this.renderEvent,this.cfg.fireQueue,this.cfg)){this.renderEvent.subscribe(this.cfg.fireQueue,this.cfg,true);}this.initEvent.fire(g);},initResizeMonitor:function(){var r=(i.gecko&&this.platform=="windows");if(r){var q=this;setTimeout(function(){q._initResizeMonitor();},0);}else{this._initResizeMonitor();}},_initResizeMonitor:function(){var q,s,u;function w(){g.textResizeEvent.fire();}if(!i.opera){s=f.get("_yuiResizeMonitor");var v=this._supportsCWResize();if(!s){s=document.createElement("iframe");if(this.isSecure&&g.RESIZE_MONITOR_SECURE_URL&&i.ie){s.src=g.RESIZE_MONITOR_SECURE_URL;}if(!v){u=["<html><head><script ",'type="text/javascript">',"window.onresize=function(){window.parent.","YAHOO.widget.Module.textResizeEvent.","fire();};<","/script></head>","<body></body></html>"].join("");s.src="data:text/html;charset=utf-8,"+encodeURIComponent(u);}s.id="_yuiResizeMonitor";s.title="Text Resize Monitor";s.tabIndex=-1;s.setAttribute("role","presentation");s.style.position="absolute";s.style.visibility="hidden";var r=document.body,t=r.firstChild;if(t){r.insertBefore(s,t);}else{r.appendChild(s);}s.style.backgroundColor="transparent";s.style.borderWidth="0";s.style.width="2em";s.style.height="2em";s.style.left="0";s.style.top=(-1*(s.offsetHeight+g.RESIZE_MONITOR_BUFFER))+"px";s.style.visibility="visible";if(i.webkit){q=s.contentWindow.document;q.open();q.close();}}if(s&&s.contentWindow){g.textResizeEvent.subscribe(this.onDomResize,this,true);if(!g.textResizeInitialized){if(v){if(!n.on(s.contentWindow,"resize",w)){n.on(s,"resize",w);}}g.textResizeInitialized=true;}this.resizeMonitor=s;}}},_supportsCWResize:function(){var q=true;if(i.gecko&&i.gecko<=1.8){q=false;}return q;},onDomResize:function(s,r){var q=-1*(this.resizeMonitor.offsetHeight+g.RESIZE_MONITOR_BUFFER);this.resizeMonitor.style.top=q+"px";this.resizeMonitor.style.left="0";},setHeader:function(r){var q=this.header||(this.header=k());if(r.nodeName){q.innerHTML="";q.appendChild(r);}else{q.innerHTML=r;}if(this._rendered){this._renderHeader();}this.changeHeaderEvent.fire(r);this.changeContentEvent.fire();},appendToHeader:function(r){var q=this.header||(this.header=k());q.appendChild(r);this.changeHeaderEvent.fire(r);this.changeContentEvent.fire();},setBody:function(r){var q=this.body||(this.body=b());if(r.nodeName){q.innerHTML="";q.appendChild(r);}else{q.innerHTML=r;}if(this._rendered){this._renderBody();}this.changeBodyEvent.fire(r);this.changeContentEvent.fire();},appendToBody:function(r){var q=this.body||(this.body=b());q.appendChild(r);this.changeBodyEvent.fire(r);this.changeContentEvent.fire();},setFooter:function(r){var q=this.footer||(this.footer=c());if(r.nodeName){q.innerHTML="";q.appendChild(r);}else{q.innerHTML=r;}if(this._rendered){this._renderFooter();}this.changeFooterEvent.fire(r);this.changeContentEvent.fire();},appendToFooter:function(r){var q=this.footer||(this.footer=c());q.appendChild(r);this.changeFooterEvent.fire(r);this.changeContentEvent.fire();},render:function(s,q){var t=this;function r(u){if(typeof u=="string"){u=document.getElementById(u);
+}if(u){t._addToParent(u,t.element);t.appendEvent.fire();}}this.beforeRenderEvent.fire();if(!q){q=this.element;}if(s){r(s);}else{if(!f.inDocument(this.element)){return false;}}this._renderHeader(q);this._renderBody(q);this._renderFooter(q);this._rendered=true;this.renderEvent.fire();return true;},_renderHeader:function(q){q=q||this.element;if(this.header&&!f.inDocument(this.header)){var r=q.firstChild;if(r){q.insertBefore(this.header,r);}else{q.appendChild(this.header);}}},_renderBody:function(q){q=q||this.element;if(this.body&&!f.inDocument(this.body)){if(this.footer&&f.isAncestor(q,this.footer)){q.insertBefore(this.body,this.footer);}else{q.appendChild(this.body);}}},_renderFooter:function(q){q=q||this.element;if(this.footer&&!f.inDocument(this.footer)){q.appendChild(this.footer);}},destroy:function(q){var r,s=!(q);if(this.element){n.purgeElement(this.element,s);r=this.element.parentNode;}if(r){r.removeChild(this.element);}this.element=null;this.header=null;this.body=null;this.footer=null;g.textResizeEvent.unsubscribe(this.onDomResize,this);this.cfg.destroy();this.cfg=null;this.destroyEvent.fire();},show:function(){this.cfg.setProperty("visible",true);},hide:function(){this.cfg.setProperty("visible",false);},configVisible:function(r,q,s){var t=q[0];if(t){if(this.beforeShowEvent.fire()){f.setStyle(this.element,"display","block");this.showEvent.fire();}}else{if(this.beforeHideEvent.fire()){f.setStyle(this.element,"display","none");this.hideEvent.fire();}}},configEffect:function(r,q,s){this._cachedEffects=(this.cacheEffects)?this._createEffects(q[0]):null;},cacheEffects:true,_createEffects:function(t){var q=null,u,r,s;if(t){if(t instanceof Array){q=[];u=t.length;for(r=0;r<u;r++){s=t[r];if(s.effect){q[q.length]=s.effect(this,s.duration);}}}else{if(t.effect){q=[t.effect(this,t.duration)];}}}return q;},configMonitorResize:function(s,r,t){var q=r[0];if(q){this.initResizeMonitor();}else{g.textResizeEvent.unsubscribe(this.onDomResize,this,true);this.resizeMonitor=null;}},_addToParent:function(q,r){if(!this.cfg.getProperty("appendtodocumentbody")&&q===document.body&&q.firstChild){q.insertBefore(r,q.firstChild);}else{q.appendChild(r);}},toString:function(){return"Module "+this.id;}};YAHOO.lang.augmentProto(g,YAHOO.util.EventProvider);}());(function(){YAHOO.widget.Overlay=function(p,o){YAHOO.widget.Overlay.superclass.constructor.call(this,p,o);};var i=YAHOO.lang,m=YAHOO.util.CustomEvent,g=YAHOO.widget.Module,n=YAHOO.util.Event,f=YAHOO.util.Dom,d=YAHOO.util.Config,k=YAHOO.env.ua,b=YAHOO.widget.Overlay,h="subscribe",e="unsubscribe",c="contained",j,a={"BEFORE_MOVE":"beforeMove","MOVE":"move"},l={"X":{key:"x",validator:i.isNumber,suppressEvent:true,supercedes:["iframe"]},"Y":{key:"y",validator:i.isNumber,suppressEvent:true,supercedes:["iframe"]},"XY":{key:"xy",suppressEvent:true,supercedes:["iframe"]},"CONTEXT":{key:"context",suppressEvent:true,supercedes:["iframe"]},"FIXED_CENTER":{key:"fixedcenter",value:false,supercedes:["iframe","visible"]},"WIDTH":{key:"width",suppressEvent:true,supercedes:["context","fixedcenter","iframe"]},"HEIGHT":{key:"height",suppressEvent:true,supercedes:["context","fixedcenter","iframe"]},"AUTO_FILL_HEIGHT":{key:"autofillheight",supercedes:["height"],value:"body"},"ZINDEX":{key:"zindex",value:null},"CONSTRAIN_TO_VIEWPORT":{key:"constraintoviewport",value:false,validator:i.isBoolean,supercedes:["iframe","x","y","xy"]},"IFRAME":{key:"iframe",value:(k.ie==6?true:false),validator:i.isBoolean,supercedes:["zindex"]},"PREVENT_CONTEXT_OVERLAP":{key:"preventcontextoverlap",value:false,validator:i.isBoolean,supercedes:["constraintoviewport"]}};b.IFRAME_SRC="javascript:false;";b.IFRAME_OFFSET=3;b.VIEWPORT_OFFSET=10;b.TOP_LEFT="tl";b.TOP_RIGHT="tr";b.BOTTOM_LEFT="bl";b.BOTTOM_RIGHT="br";b.PREVENT_OVERLAP_X={"tltr":true,"blbr":true,"brbl":true,"trtl":true};b.PREVENT_OVERLAP_Y={"trbr":true,"tlbl":true,"bltl":true,"brtr":true};b.CSS_OVERLAY="yui-overlay";b.CSS_HIDDEN="yui-overlay-hidden";b.CSS_IFRAME="yui-overlay-iframe";b.STD_MOD_RE=/^\s*?(body|footer|header)\s*?$/i;b.windowScrollEvent=new m("windowScroll");b.windowResizeEvent=new m("windowResize");b.windowScrollHandler=function(p){var o=n.getTarget(p);if(!o||o===window||o===window.document){if(k.ie){if(!window.scrollEnd){window.scrollEnd=-1;}clearTimeout(window.scrollEnd);window.scrollEnd=setTimeout(function(){b.windowScrollEvent.fire();},1);}else{b.windowScrollEvent.fire();}}};b.windowResizeHandler=function(o){if(k.ie){if(!window.resizeEnd){window.resizeEnd=-1;}clearTimeout(window.resizeEnd);window.resizeEnd=setTimeout(function(){b.windowResizeEvent.fire();},100);}else{b.windowResizeEvent.fire();}};b._initialized=null;if(b._initialized===null){n.on(window,"scroll",b.windowScrollHandler);n.on(window,"resize",b.windowResizeHandler);b._initialized=true;}b._TRIGGER_MAP={"windowScroll":b.windowScrollEvent,"windowResize":b.windowResizeEvent,"textResize":g.textResizeEvent};YAHOO.extend(b,g,{CONTEXT_TRIGGERS:[],init:function(p,o){b.superclass.init.call(this,p);this.beforeInitEvent.fire(b);f.addClass(this.element,b.CSS_OVERLAY);if(o){this.cfg.applyConfig(o,true);}if(this.platform=="mac"&&k.gecko){if(!d.alreadySubscribed(this.showEvent,this.showMacGeckoScrollbars,this)){this.showEvent.subscribe(this.showMacGeckoScrollbars,this,true);}if(!d.alreadySubscribed(this.hideEvent,this.hideMacGeckoScrollbars,this)){this.hideEvent.subscribe(this.hideMacGeckoScrollbars,this,true);}}this.initEvent.fire(b);},initEvents:function(){b.superclass.initEvents.call(this);var o=m.LIST;this.beforeMoveEvent=this.createEvent(a.BEFORE_MOVE);this.beforeMoveEvent.signature=o;this.moveEvent=this.createEvent(a.MOVE);this.moveEvent.signature=o;},initDefaultConfig:function(){b.superclass.initDefaultConfig.call(this);var o=this.cfg;o.addProperty(l.X.key,{handler:this.configX,validator:l.X.validator,suppressEvent:l.X.suppressEvent,supercedes:l.X.supercedes});o.addProperty(l.Y.key,{handler:this.configY,validator:l.Y.validator,suppressEvent:l.Y.suppressEvent,supercedes:l.Y.supercedes});
+o.addProperty(l.XY.key,{handler:this.configXY,suppressEvent:l.XY.suppressEvent,supercedes:l.XY.supercedes});o.addProperty(l.CONTEXT.key,{handler:this.configContext,suppressEvent:l.CONTEXT.suppressEvent,supercedes:l.CONTEXT.supercedes});o.addProperty(l.FIXED_CENTER.key,{handler:this.configFixedCenter,value:l.FIXED_CENTER.value,validator:l.FIXED_CENTER.validator,supercedes:l.FIXED_CENTER.supercedes});o.addProperty(l.WIDTH.key,{handler:this.configWidth,suppressEvent:l.WIDTH.suppressEvent,supercedes:l.WIDTH.supercedes});o.addProperty(l.HEIGHT.key,{handler:this.configHeight,suppressEvent:l.HEIGHT.suppressEvent,supercedes:l.HEIGHT.supercedes});o.addProperty(l.AUTO_FILL_HEIGHT.key,{handler:this.configAutoFillHeight,value:l.AUTO_FILL_HEIGHT.value,validator:this._validateAutoFill,supercedes:l.AUTO_FILL_HEIGHT.supercedes});o.addProperty(l.ZINDEX.key,{handler:this.configzIndex,value:l.ZINDEX.value});o.addProperty(l.CONSTRAIN_TO_VIEWPORT.key,{handler:this.configConstrainToViewport,value:l.CONSTRAIN_TO_VIEWPORT.value,validator:l.CONSTRAIN_TO_VIEWPORT.validator,supercedes:l.CONSTRAIN_TO_VIEWPORT.supercedes});o.addProperty(l.IFRAME.key,{handler:this.configIframe,value:l.IFRAME.value,validator:l.IFRAME.validator,supercedes:l.IFRAME.supercedes});o.addProperty(l.PREVENT_CONTEXT_OVERLAP.key,{value:l.PREVENT_CONTEXT_OVERLAP.value,validator:l.PREVENT_CONTEXT_OVERLAP.validator,supercedes:l.PREVENT_CONTEXT_OVERLAP.supercedes});},moveTo:function(o,p){this.cfg.setProperty("xy",[o,p]);},hideMacGeckoScrollbars:function(){f.replaceClass(this.element,"show-scrollbars","hide-scrollbars");},showMacGeckoScrollbars:function(){f.replaceClass(this.element,"hide-scrollbars","show-scrollbars");},_setDomVisibility:function(o){f.setStyle(this.element,"visibility",(o)?"visible":"hidden");var p=b.CSS_HIDDEN;if(o){f.removeClass(this.element,p);}else{f.addClass(this.element,p);}},configVisible:function(x,w,t){var p=w[0],B=f.getStyle(this.element,"visibility"),o=this._cachedEffects||this._createEffects(this.cfg.getProperty("effect")),A=(this.platform=="mac"&&k.gecko),y=d.alreadySubscribed,q,v,s,r,u,z;if(B=="inherit"){v=this.element.parentNode;while(v.nodeType!=9&&v.nodeType!=11){B=f.getStyle(v,"visibility");if(B!="inherit"){break;}v=v.parentNode;}if(B=="inherit"){B="visible";}}if(p){if(A){this.showMacGeckoScrollbars();}if(o){if(p){if(B!="visible"||B===""||this._fadingOut){if(this.beforeShowEvent.fire()){z=o.length;for(s=0;s<z;s++){q=o[s];if(s===0&&!y(q.animateInCompleteEvent,this.showEvent.fire,this.showEvent)){q.animateInCompleteEvent.subscribe(this.showEvent.fire,this.showEvent,true);}q.animateIn();}}}}}else{if(B!="visible"||B===""){if(this.beforeShowEvent.fire()){this._setDomVisibility(true);this.cfg.refireEvent("iframe");this.showEvent.fire();}}else{this._setDomVisibility(true);}}}else{if(A){this.hideMacGeckoScrollbars();}if(o){if(B=="visible"||this._fadingIn){if(this.beforeHideEvent.fire()){z=o.length;for(r=0;r<z;r++){u=o[r];if(r===0&&!y(u.animateOutCompleteEvent,this.hideEvent.fire,this.hideEvent)){u.animateOutCompleteEvent.subscribe(this.hideEvent.fire,this.hideEvent,true);}u.animateOut();}}}else{if(B===""){this._setDomVisibility(false);}}}else{if(B=="visible"||B===""){if(this.beforeHideEvent.fire()){this._setDomVisibility(false);this.hideEvent.fire();}}else{this._setDomVisibility(false);}}}},doCenterOnDOMEvent:function(){var o=this.cfg,p=o.getProperty("fixedcenter");if(o.getProperty("visible")){if(p&&(p!==c||this.fitsInViewport())){this.center();}}},fitsInViewport:function(){var s=b.VIEWPORT_OFFSET,q=this.element,t=q.offsetWidth,r=q.offsetHeight,o=f.getViewportWidth(),p=f.getViewportHeight();return((t+s<o)&&(r+s<p));},configFixedCenter:function(s,q,t){var u=q[0],p=d.alreadySubscribed,r=b.windowResizeEvent,o=b.windowScrollEvent;if(u){this.center();if(!p(this.beforeShowEvent,this.center)){this.beforeShowEvent.subscribe(this.center);}if(!p(r,this.doCenterOnDOMEvent,this)){r.subscribe(this.doCenterOnDOMEvent,this,true);}if(!p(o,this.doCenterOnDOMEvent,this)){o.subscribe(this.doCenterOnDOMEvent,this,true);}}else{this.beforeShowEvent.unsubscribe(this.center);r.unsubscribe(this.doCenterOnDOMEvent,this);o.unsubscribe(this.doCenterOnDOMEvent,this);}},configHeight:function(r,p,s){var o=p[0],q=this.element;f.setStyle(q,"height",o);this.cfg.refireEvent("iframe");},configAutoFillHeight:function(t,s,p){var v=s[0],q=this.cfg,u="autofillheight",w="height",r=q.getProperty(u),o=this._autoFillOnHeightChange;q.unsubscribeFromConfigEvent(w,o);g.textResizeEvent.unsubscribe(o);this.changeContentEvent.unsubscribe(o);if(r&&v!==r&&this[r]){f.setStyle(this[r],w,"");}if(v){v=i.trim(v.toLowerCase());q.subscribeToConfigEvent(w,o,this[v],this);g.textResizeEvent.subscribe(o,this[v],this);this.changeContentEvent.subscribe(o,this[v],this);q.setProperty(u,v,true);}},configWidth:function(r,o,s){var q=o[0],p=this.element;f.setStyle(p,"width",q);this.cfg.refireEvent("iframe");},configzIndex:function(q,o,r){var s=o[0],p=this.element;if(!s){s=f.getStyle(p,"zIndex");if(!s||isNaN(s)){s=0;}}if(this.iframe||this.cfg.getProperty("iframe")===true){if(s<=0){s=1;}}f.setStyle(p,"zIndex",s);this.cfg.setProperty("zIndex",s,true);if(this.iframe){this.stackIframe();}},configXY:function(q,p,r){var t=p[0],o=t[0],s=t[1];this.cfg.setProperty("x",o);this.cfg.setProperty("y",s);this.beforeMoveEvent.fire([o,s]);o=this.cfg.getProperty("x");s=this.cfg.getProperty("y");this.cfg.refireEvent("iframe");this.moveEvent.fire([o,s]);},configX:function(q,p,r){var o=p[0],s=this.cfg.getProperty("y");this.cfg.setProperty("x",o,true);this.cfg.setProperty("y",s,true);this.beforeMoveEvent.fire([o,s]);o=this.cfg.getProperty("x");s=this.cfg.getProperty("y");f.setX(this.element,o,true);this.cfg.setProperty("xy",[o,s],true);this.cfg.refireEvent("iframe");this.moveEvent.fire([o,s]);},configY:function(q,p,r){var o=this.cfg.getProperty("x"),s=p[0];this.cfg.setProperty("x",o,true);this.cfg.setProperty("y",s,true);this.beforeMoveEvent.fire([o,s]);o=this.cfg.getProperty("x");s=this.cfg.getProperty("y");f.setY(this.element,s,true);
+this.cfg.setProperty("xy",[o,s],true);this.cfg.refireEvent("iframe");this.moveEvent.fire([o,s]);},showIframe:function(){var p=this.iframe,o;if(p){o=this.element.parentNode;if(o!=p.parentNode){this._addToParent(o,p);}p.style.display="block";}},hideIframe:function(){if(this.iframe){this.iframe.style.display="none";}},syncIframe:function(){var o=this.iframe,q=this.element,s=b.IFRAME_OFFSET,p=(s*2),r;if(o){o.style.width=(q.offsetWidth+p+"px");o.style.height=(q.offsetHeight+p+"px");r=this.cfg.getProperty("xy");if(!i.isArray(r)||(isNaN(r[0])||isNaN(r[1]))){this.syncPosition();r=this.cfg.getProperty("xy");}f.setXY(o,[(r[0]-s),(r[1]-s)]);}},stackIframe:function(){if(this.iframe){var o=f.getStyle(this.element,"zIndex");if(!YAHOO.lang.isUndefined(o)&&!isNaN(o)){f.setStyle(this.iframe,"zIndex",(o-1));}}},configIframe:function(r,q,s){var o=q[0];function t(){var v=this.iframe,w=this.element,x;if(!v){if(!j){j=document.createElement("iframe");if(this.isSecure){j.src=b.IFRAME_SRC;}if(k.ie){j.style.filter="alpha(opacity=0)";j.frameBorder=0;}else{j.style.opacity="0";}j.style.position="absolute";j.style.border="none";j.style.margin="0";j.style.padding="0";j.style.display="none";j.tabIndex=-1;j.className=b.CSS_IFRAME;}v=j.cloneNode(false);v.id=this.id+"_f";x=w.parentNode;var u=x||document.body;this._addToParent(u,v);this.iframe=v;}this.showIframe();this.syncIframe();this.stackIframe();if(!this._hasIframeEventListeners){this.showEvent.subscribe(this.showIframe);this.hideEvent.subscribe(this.hideIframe);this.changeContentEvent.subscribe(this.syncIframe);this._hasIframeEventListeners=true;}}function p(){t.call(this);this.beforeShowEvent.unsubscribe(p);this._iframeDeferred=false;}if(o){if(this.cfg.getProperty("visible")){t.call(this);}else{if(!this._iframeDeferred){this.beforeShowEvent.subscribe(p);this._iframeDeferred=true;}}}else{this.hideIframe();if(this._hasIframeEventListeners){this.showEvent.unsubscribe(this.showIframe);this.hideEvent.unsubscribe(this.hideIframe);this.changeContentEvent.unsubscribe(this.syncIframe);this._hasIframeEventListeners=false;}}},_primeXYFromDOM:function(){if(YAHOO.lang.isUndefined(this.cfg.getProperty("xy"))){this.syncPosition();this.cfg.refireEvent("xy");this.beforeShowEvent.unsubscribe(this._primeXYFromDOM);}},configConstrainToViewport:function(p,o,q){var r=o[0];if(r){if(!d.alreadySubscribed(this.beforeMoveEvent,this.enforceConstraints,this)){this.beforeMoveEvent.subscribe(this.enforceConstraints,this,true);}if(!d.alreadySubscribed(this.beforeShowEvent,this._primeXYFromDOM)){this.beforeShowEvent.subscribe(this._primeXYFromDOM);}}else{this.beforeShowEvent.unsubscribe(this._primeXYFromDOM);this.beforeMoveEvent.unsubscribe(this.enforceConstraints,this);}},configContext:function(u,t,q){var x=t[0],r,o,v,s,p,w=this.CONTEXT_TRIGGERS;if(x){r=x[0];o=x[1];v=x[2];s=x[3];p=x[4];if(w&&w.length>0){s=(s||[]).concat(w);}if(r){if(typeof r=="string"){this.cfg.setProperty("context",[document.getElementById(r),o,v,s,p],true);}if(o&&v){this.align(o,v,p);}if(this._contextTriggers){this._processTriggers(this._contextTriggers,e,this._alignOnTrigger);}if(s){this._processTriggers(s,h,this._alignOnTrigger);this._contextTriggers=s;}}}},_alignOnTrigger:function(p,o){this.align();},_findTriggerCE:function(o){var p=null;if(o instanceof m){p=o;}else{if(b._TRIGGER_MAP[o]){p=b._TRIGGER_MAP[o];}}return p;},_processTriggers:function(s,v,r){var q,u;for(var p=0,o=s.length;p<o;++p){q=s[p];u=this._findTriggerCE(q);if(u){u[v](r,this,true);}else{this[v](q,r);}}},align:function(p,w,s){var v=this.cfg.getProperty("context"),t=this,o,q,u;function r(z,A){var y=null,x=null;switch(p){case b.TOP_LEFT:y=A;x=z;break;case b.TOP_RIGHT:y=A-q.offsetWidth;x=z;break;case b.BOTTOM_LEFT:y=A;x=z-q.offsetHeight;break;case b.BOTTOM_RIGHT:y=A-q.offsetWidth;x=z-q.offsetHeight;break;}if(y!==null&&x!==null){if(s){y+=s[0];x+=s[1];}t.moveTo(y,x);}}if(v){o=v[0];q=this.element;t=this;if(!p){p=v[1];}if(!w){w=v[2];}if(!s&&v[4]){s=v[4];}if(q&&o){u=f.getRegion(o);switch(w){case b.TOP_LEFT:r(u.top,u.left);break;case b.TOP_RIGHT:r(u.top,u.right);break;case b.BOTTOM_LEFT:r(u.bottom,u.left);break;case b.BOTTOM_RIGHT:r(u.bottom,u.right);break;}}}},enforceConstraints:function(p,o,q){var s=o[0];var r=this.getConstrainedXY(s[0],s[1]);this.cfg.setProperty("x",r[0],true);this.cfg.setProperty("y",r[1],true);this.cfg.setProperty("xy",r,true);},_getConstrainedPos:function(y,p){var t=this.element,r=b.VIEWPORT_OFFSET,A=(y=="x"),z=(A)?t.offsetWidth:t.offsetHeight,s=(A)?f.getViewportWidth():f.getViewportHeight(),D=(A)?f.getDocumentScrollLeft():f.getDocumentScrollTop(),C=(A)?b.PREVENT_OVERLAP_X:b.PREVENT_OVERLAP_Y,o=this.cfg.getProperty("context"),u=(z+r<s),w=this.cfg.getProperty("preventcontextoverlap")&&o&&C[(o[1]+o[2])],v=D+r,B=D+s-z-r,q=p;if(p<v||p>B){if(w){q=this._preventOverlap(y,o[0],z,s,D);}else{if(u){if(p<v){q=v;}else{if(p>B){q=B;}}}else{q=v;}}}return q;},_preventOverlap:function(y,w,z,u,C){var A=(y=="x"),t=b.VIEWPORT_OFFSET,s=this,q=((A)?f.getX(w):f.getY(w))-C,o=(A)?w.offsetWidth:w.offsetHeight,p=q-t,r=(u-(q+o))-t,D=false,v=function(){var x;if((s.cfg.getProperty(y)-C)>q){x=(q-z);}else{x=(q+o);}s.cfg.setProperty(y,(x+C),true);return x;},B=function(){var E=((s.cfg.getProperty(y)-C)>q)?r:p,x;if(z>E){if(D){v();}else{v();D=true;x=B();}}return x;};B();return this.cfg.getProperty(y);},getConstrainedX:function(o){return this._getConstrainedPos("x",o);},getConstrainedY:function(o){return this._getConstrainedPos("y",o);},getConstrainedXY:function(o,p){return[this.getConstrainedX(o),this.getConstrainedY(p)];},center:function(){var r=b.VIEWPORT_OFFSET,s=this.element.offsetWidth,q=this.element.offsetHeight,p=f.getViewportWidth(),t=f.getViewportHeight(),o,u;if(s<p){o=(p/2)-(s/2)+f.getDocumentScrollLeft();}else{o=r+f.getDocumentScrollLeft();}if(q<t){u=(t/2)-(q/2)+f.getDocumentScrollTop();}else{u=r+f.getDocumentScrollTop();}this.cfg.setProperty("xy",[parseInt(o,10),parseInt(u,10)]);this.cfg.refireEvent("iframe");if(k.webkit){this.forceContainerRedraw();}},syncPosition:function(){var o=f.getXY(this.element);
+this.cfg.setProperty("x",o[0],true);this.cfg.setProperty("y",o[1],true);this.cfg.setProperty("xy",o,true);},onDomResize:function(q,p){var o=this;b.superclass.onDomResize.call(this,q,p);setTimeout(function(){o.syncPosition();o.cfg.refireEvent("iframe");o.cfg.refireEvent("context");},0);},_getComputedHeight:(function(){if(document.defaultView&&document.defaultView.getComputedStyle){return function(p){var o=null;if(p.ownerDocument&&p.ownerDocument.defaultView){var q=p.ownerDocument.defaultView.getComputedStyle(p,"");if(q){o=parseInt(q.height,10);}}return(i.isNumber(o))?o:null;};}else{return function(p){var o=null;if(p.style.pixelHeight){o=p.style.pixelHeight;}return(i.isNumber(o))?o:null;};}})(),_validateAutoFillHeight:function(o){return(!o)||(i.isString(o)&&b.STD_MOD_RE.test(o));},_autoFillOnHeightChange:function(r,p,q){var o=this.cfg.getProperty("height");if((o&&o!=="auto")||(o===0)){this.fillHeight(q);}},_getPreciseHeight:function(p){var o=p.offsetHeight;if(p.getBoundingClientRect){var q=p.getBoundingClientRect();o=q.bottom-q.top;}return o;},fillHeight:function(r){if(r){var p=this.innerElement||this.element,o=[this.header,this.body,this.footer],v,w=0,x=0,t=0,q=false;for(var u=0,s=o.length;u<s;u++){v=o[u];if(v){if(r!==v){x+=this._getPreciseHeight(v);}else{q=true;}}}if(q){if(k.ie||k.opera){f.setStyle(r,"height",0+"px");}w=this._getComputedHeight(p);if(w===null){f.addClass(p,"yui-override-padding");w=p.clientHeight;f.removeClass(p,"yui-override-padding");}t=Math.max(w-x,0);f.setStyle(r,"height",t+"px");if(r.offsetHeight!=t){t=Math.max(t-(r.offsetHeight-t),0);}f.setStyle(r,"height",t+"px");}}},bringToTop:function(){var s=[],r=this.element;function v(z,y){var B=f.getStyle(z,"zIndex"),A=f.getStyle(y,"zIndex"),x=(!B||isNaN(B))?0:parseInt(B,10),w=(!A||isNaN(A))?0:parseInt(A,10);if(x>w){return -1;}else{if(x<w){return 1;}else{return 0;}}}function q(y){var x=f.hasClass(y,b.CSS_OVERLAY),w=YAHOO.widget.Panel;if(x&&!f.isAncestor(r,y)){if(w&&f.hasClass(y,w.CSS_PANEL)){s[s.length]=y.parentNode;}else{s[s.length]=y;}}}f.getElementsBy(q,"div",document.body);s.sort(v);var o=s[0],u;if(o){u=f.getStyle(o,"zIndex");if(!isNaN(u)){var t=false;if(o!=r){t=true;}else{if(s.length>1){var p=f.getStyle(s[1],"zIndex");if(!isNaN(p)&&(u==p)){t=true;}}}if(t){this.cfg.setProperty("zindex",(parseInt(u,10)+2));}}}},destroy:function(o){if(this.iframe){this.iframe.parentNode.removeChild(this.iframe);}this.iframe=null;b.windowResizeEvent.unsubscribe(this.doCenterOnDOMEvent,this);b.windowScrollEvent.unsubscribe(this.doCenterOnDOMEvent,this);g.textResizeEvent.unsubscribe(this._autoFillOnHeightChange);if(this._contextTriggers){this._processTriggers(this._contextTriggers,e,this._alignOnTrigger);}b.superclass.destroy.call(this,o);},forceContainerRedraw:function(){var o=this;f.addClass(o.element,"yui-force-redraw");setTimeout(function(){f.removeClass(o.element,"yui-force-redraw");},0);},toString:function(){return"Overlay "+this.id;}});}());(function(){YAHOO.widget.OverlayManager=function(g){this.init(g);};var d=YAHOO.widget.Overlay,c=YAHOO.util.Event,e=YAHOO.util.Dom,b=YAHOO.util.Config,f=YAHOO.util.CustomEvent,a=YAHOO.widget.OverlayManager;a.CSS_FOCUSED="focused";a.prototype={constructor:a,overlays:null,initDefaultConfig:function(){this.cfg.addProperty("overlays",{suppressEvent:true});this.cfg.addProperty("focusevent",{value:"mousedown"});},init:function(i){this.cfg=new b(this);this.initDefaultConfig();if(i){this.cfg.applyConfig(i,true);}this.cfg.fireQueue();var h=null;this.getActive=function(){return h;};this.focus=function(j){var k=this.find(j);if(k){k.focus();}};this.remove=function(k){var m=this.find(k),j;if(m){if(h==m){h=null;}var l=(m.element===null&&m.cfg===null)?true:false;if(!l){j=e.getStyle(m.element,"zIndex");m.cfg.setProperty("zIndex",-1000,true);}this.overlays.sort(this.compareZIndexDesc);this.overlays=this.overlays.slice(0,(this.overlays.length-1));m.hideEvent.unsubscribe(m.blur);m.destroyEvent.unsubscribe(this._onOverlayDestroy,m);m.focusEvent.unsubscribe(this._onOverlayFocusHandler,m);m.blurEvent.unsubscribe(this._onOverlayBlurHandler,m);if(!l){c.removeListener(m.element,this.cfg.getProperty("focusevent"),this._onOverlayElementFocus);m.cfg.setProperty("zIndex",j,true);m.cfg.setProperty("manager",null);}if(m.focusEvent._managed){m.focusEvent=null;}if(m.blurEvent._managed){m.blurEvent=null;}if(m.focus._managed){m.focus=null;}if(m.blur._managed){m.blur=null;}}};this.blurAll=function(){var k=this.overlays.length,j;if(k>0){j=k-1;do{this.overlays[j].blur();}while(j--);}};this._manageBlur=function(j){var k=false;if(h==j){e.removeClass(h.element,a.CSS_FOCUSED);h=null;k=true;}return k;};this._manageFocus=function(j){var k=false;if(h!=j){if(h){h.blur();}h=j;this.bringToTop(h);e.addClass(h.element,a.CSS_FOCUSED);k=true;}return k;};var g=this.cfg.getProperty("overlays");if(!this.overlays){this.overlays=[];}if(g){this.register(g);this.overlays.sort(this.compareZIndexDesc);}},_onOverlayElementFocus:function(i){var g=c.getTarget(i),h=this.close;if(h&&(g==h||e.isAncestor(h,g))){this.blur();}else{this.focus();}},_onOverlayDestroy:function(h,g,i){this.remove(i);},_onOverlayFocusHandler:function(h,g,i){this._manageFocus(i);},_onOverlayBlurHandler:function(h,g,i){this._manageBlur(i);},_bindFocus:function(g){var h=this;if(!g.focusEvent){g.focusEvent=g.createEvent("focus");g.focusEvent.signature=f.LIST;g.focusEvent._managed=true;}else{g.focusEvent.subscribe(h._onOverlayFocusHandler,g,h);}if(!g.focus){c.on(g.element,h.cfg.getProperty("focusevent"),h._onOverlayElementFocus,null,g);g.focus=function(){if(h._manageFocus(this)){if(this.cfg.getProperty("visible")&&this.focusFirst){this.focusFirst();}this.focusEvent.fire();}};g.focus._managed=true;}},_bindBlur:function(g){var h=this;if(!g.blurEvent){g.blurEvent=g.createEvent("blur");g.blurEvent.signature=f.LIST;g.focusEvent._managed=true;}else{g.blurEvent.subscribe(h._onOverlayBlurHandler,g,h);}if(!g.blur){g.blur=function(){if(h._manageBlur(this)){this.blurEvent.fire();}};g.blur._managed=true;}g.hideEvent.subscribe(g.blur);
+},_bindDestroy:function(g){var h=this;g.destroyEvent.subscribe(h._onOverlayDestroy,g,h);},_syncZIndex:function(g){var h=e.getStyle(g.element,"zIndex");if(!isNaN(h)){g.cfg.setProperty("zIndex",parseInt(h,10));}else{g.cfg.setProperty("zIndex",0);}},register:function(g){var k=false,h,j;if(g instanceof d){g.cfg.addProperty("manager",{value:this});this._bindFocus(g);this._bindBlur(g);this._bindDestroy(g);this._syncZIndex(g);this.overlays.push(g);this.bringToTop(g);k=true;}else{if(g instanceof Array){for(h=0,j=g.length;h<j;h++){k=this.register(g[h])||k;}}}return k;},bringToTop:function(m){var i=this.find(m),l,g,j;if(i){j=this.overlays;j.sort(this.compareZIndexDesc);g=j[0];if(g){l=e.getStyle(g.element,"zIndex");if(!isNaN(l)){var k=false;if(g!==i){k=true;}else{if(j.length>1){var h=e.getStyle(j[1].element,"zIndex");if(!isNaN(h)&&(l==h)){k=true;}}}if(k){i.cfg.setProperty("zindex",(parseInt(l,10)+2));}}j.sort(this.compareZIndexDesc);}}},find:function(g){var l=g instanceof d,j=this.overlays,p=j.length,k=null,m,h;if(l||typeof g=="string"){for(h=p-1;h>=0;h--){m=j[h];if((l&&(m===g))||(m.id==g)){k=m;break;}}}return k;},compareZIndexDesc:function(j,i){var h=(j.cfg)?j.cfg.getProperty("zIndex"):null,g=(i.cfg)?i.cfg.getProperty("zIndex"):null;if(h===null&&g===null){return 0;}else{if(h===null){return 1;}else{if(g===null){return -1;}else{if(h>g){return -1;}else{if(h<g){return 1;}else{return 0;}}}}}},showAll:function(){var h=this.overlays,j=h.length,g;for(g=j-1;g>=0;g--){h[g].show();}},hideAll:function(){var h=this.overlays,j=h.length,g;for(g=j-1;g>=0;g--){h[g].hide();}},toString:function(){return"OverlayManager";}};}());(function(){YAHOO.widget.Tooltip=function(p,o){YAHOO.widget.Tooltip.superclass.constructor.call(this,p,o);};var e=YAHOO.lang,n=YAHOO.util.Event,m=YAHOO.util.CustomEvent,c=YAHOO.util.Dom,j=YAHOO.widget.Tooltip,h=YAHOO.env.ua,g=(h.ie&&(h.ie<=6||document.compatMode=="BackCompat")),f,i={"PREVENT_OVERLAP":{key:"preventoverlap",value:true,validator:e.isBoolean,supercedes:["x","y","xy"]},"SHOW_DELAY":{key:"showdelay",value:200,validator:e.isNumber},"AUTO_DISMISS_DELAY":{key:"autodismissdelay",value:5000,validator:e.isNumber},"HIDE_DELAY":{key:"hidedelay",value:250,validator:e.isNumber},"TEXT":{key:"text",suppressEvent:true},"CONTAINER":{key:"container"},"DISABLED":{key:"disabled",value:false,suppressEvent:true},"XY_OFFSET":{key:"xyoffset",value:[0,25],suppressEvent:true}},a={"CONTEXT_MOUSE_OVER":"contextMouseOver","CONTEXT_MOUSE_OUT":"contextMouseOut","CONTEXT_TRIGGER":"contextTrigger"};j.CSS_TOOLTIP="yui-tt";function k(q,o){var p=this.cfg,r=p.getProperty("width");if(r==o){p.setProperty("width",q);}}function d(p,o){if("_originalWidth" in this){k.call(this,this._originalWidth,this._forcedWidth);}var q=document.body,u=this.cfg,t=u.getProperty("width"),r,s;if((!t||t=="auto")&&(u.getProperty("container")!=q||u.getProperty("x")>=c.getViewportWidth()||u.getProperty("y")>=c.getViewportHeight())){s=this.element.cloneNode(true);s.style.visibility="hidden";s.style.top="0px";s.style.left="0px";q.appendChild(s);r=(s.offsetWidth+"px");q.removeChild(s);s=null;u.setProperty("width",r);u.refireEvent("xy");this._originalWidth=t||"";this._forcedWidth=r;}}function b(p,o,q){this.render(q);}function l(){n.onDOMReady(b,this.cfg.getProperty("container"),this);}YAHOO.extend(j,YAHOO.widget.Overlay,{init:function(p,o){j.superclass.init.call(this,p);this.beforeInitEvent.fire(j);c.addClass(this.element,j.CSS_TOOLTIP);if(o){this.cfg.applyConfig(o,true);}this.cfg.queueProperty("visible",false);this.cfg.queueProperty("constraintoviewport",true);this.setBody("");this.subscribe("changeContent",d);this.subscribe("init",l);this.subscribe("render",this.onRender);this.initEvent.fire(j);},initEvents:function(){j.superclass.initEvents.call(this);var o=m.LIST;this.contextMouseOverEvent=this.createEvent(a.CONTEXT_MOUSE_OVER);this.contextMouseOverEvent.signature=o;this.contextMouseOutEvent=this.createEvent(a.CONTEXT_MOUSE_OUT);this.contextMouseOutEvent.signature=o;this.contextTriggerEvent=this.createEvent(a.CONTEXT_TRIGGER);this.contextTriggerEvent.signature=o;},initDefaultConfig:function(){j.superclass.initDefaultConfig.call(this);this.cfg.addProperty(i.PREVENT_OVERLAP.key,{value:i.PREVENT_OVERLAP.value,validator:i.PREVENT_OVERLAP.validator,supercedes:i.PREVENT_OVERLAP.supercedes});this.cfg.addProperty(i.SHOW_DELAY.key,{handler:this.configShowDelay,value:200,validator:i.SHOW_DELAY.validator});this.cfg.addProperty(i.AUTO_DISMISS_DELAY.key,{handler:this.configAutoDismissDelay,value:i.AUTO_DISMISS_DELAY.value,validator:i.AUTO_DISMISS_DELAY.validator});this.cfg.addProperty(i.HIDE_DELAY.key,{handler:this.configHideDelay,value:i.HIDE_DELAY.value,validator:i.HIDE_DELAY.validator});this.cfg.addProperty(i.TEXT.key,{handler:this.configText,suppressEvent:i.TEXT.suppressEvent});this.cfg.addProperty(i.CONTAINER.key,{handler:this.configContainer,value:document.body});this.cfg.addProperty(i.DISABLED.key,{handler:this.configContainer,value:i.DISABLED.value,supressEvent:i.DISABLED.suppressEvent});this.cfg.addProperty(i.XY_OFFSET.key,{value:i.XY_OFFSET.value.concat(),supressEvent:i.XY_OFFSET.suppressEvent});},configText:function(p,o,q){var r=o[0];if(r){this.setBody(r);}},configContainer:function(q,p,r){var o=p[0];if(typeof o=="string"){this.cfg.setProperty("container",document.getElementById(o),true);}},_removeEventListeners:function(){var r=this._context,o,q,p;if(r){o=r.length;if(o>0){p=o-1;do{q=r[p];n.removeListener(q,"mouseover",this.onContextMouseOver);n.removeListener(q,"mousemove",this.onContextMouseMove);n.removeListener(q,"mouseout",this.onContextMouseOut);}while(p--);}}},configContext:function(t,p,u){var s=p[0],v,o,r,q;if(s){if(!(s instanceof Array)){if(typeof s=="string"){this.cfg.setProperty("context",[document.getElementById(s)],true);}else{this.cfg.setProperty("context",[s],true);}s=this.cfg.getProperty("context");}this._removeEventListeners();this._context=s;v=this._context;if(v){o=v.length;if(o>0){q=o-1;do{r=v[q];n.on(r,"mouseover",this.onContextMouseOver,this);
+n.on(r,"mousemove",this.onContextMouseMove,this);n.on(r,"mouseout",this.onContextMouseOut,this);}while(q--);}}}},onContextMouseMove:function(p,o){o.pageX=n.getPageX(p);o.pageY=n.getPageY(p);},onContextMouseOver:function(q,p){var o=this;if(o.title){p._tempTitle=o.title;o.title="";}if(p.fireEvent("contextMouseOver",o,q)!==false&&!p.cfg.getProperty("disabled")){if(p.hideProcId){clearTimeout(p.hideProcId);p.hideProcId=null;}n.on(o,"mousemove",p.onContextMouseMove,p);p.showProcId=p.doShow(q,o);}},onContextMouseOut:function(q,p){var o=this;if(p._tempTitle){o.title=p._tempTitle;p._tempTitle=null;}if(p.showProcId){clearTimeout(p.showProcId);p.showProcId=null;}if(p.hideProcId){clearTimeout(p.hideProcId);p.hideProcId=null;}p.fireEvent("contextMouseOut",o,q);p.hideProcId=setTimeout(function(){p.hide();},p.cfg.getProperty("hidedelay"));},doShow:function(r,o){var t=this.cfg.getProperty("xyoffset"),p=t[0],s=t[1],q=this;if(h.opera&&o.tagName&&o.tagName.toUpperCase()=="A"){s+=12;}return setTimeout(function(){var u=q.cfg.getProperty("text");if(q._tempTitle&&(u===""||YAHOO.lang.isUndefined(u)||YAHOO.lang.isNull(u))){q.setBody(q._tempTitle);}else{q.cfg.refireEvent("text");}q.moveTo(q.pageX+p,q.pageY+s);if(q.cfg.getProperty("preventoverlap")){q.preventOverlap(q.pageX,q.pageY);}n.removeListener(o,"mousemove",q.onContextMouseMove);q.contextTriggerEvent.fire(o);q.show();q.hideProcId=q.doHide();},this.cfg.getProperty("showdelay"));},doHide:function(){var o=this;return setTimeout(function(){o.hide();},this.cfg.getProperty("autodismissdelay"));},preventOverlap:function(s,r){var o=this.element.offsetHeight,q=new YAHOO.util.Point(s,r),p=c.getRegion(this.element);p.top-=5;p.left-=5;p.right+=5;p.bottom+=5;if(p.contains(q)){this.cfg.setProperty("y",(r-o-5));}},onRender:function(s,r){function t(){var w=this.element,v=this.underlay;if(v){v.style.width=(w.offsetWidth+6)+"px";v.style.height=(w.offsetHeight+1)+"px";}}function p(){c.addClass(this.underlay,"yui-tt-shadow-visible");if(h.ie){this.forceUnderlayRedraw();}}function o(){c.removeClass(this.underlay,"yui-tt-shadow-visible");}function u(){var x=this.underlay,w,v,z,y;if(!x){w=this.element;v=YAHOO.widget.Module;z=h.ie;y=this;if(!f){f=document.createElement("div");f.className="yui-tt-shadow";}x=f.cloneNode(false);w.appendChild(x);this.underlay=x;this._shadow=this.underlay;p.call(this);this.subscribe("beforeShow",p);this.subscribe("hide",o);if(g){window.setTimeout(function(){t.call(y);},0);this.cfg.subscribeToConfigEvent("width",t);this.cfg.subscribeToConfigEvent("height",t);this.subscribe("changeContent",t);v.textResizeEvent.subscribe(t,this,true);this.subscribe("destroy",function(){v.textResizeEvent.unsubscribe(t,this);});}}}function q(){u.call(this);this.unsubscribe("beforeShow",q);}if(this.cfg.getProperty("visible")){u.call(this);}else{this.subscribe("beforeShow",q);}},forceUnderlayRedraw:function(){var o=this;c.addClass(o.underlay,"yui-force-redraw");setTimeout(function(){c.removeClass(o.underlay,"yui-force-redraw");},0);},destroy:function(){this._removeEventListeners();j.superclass.destroy.call(this);},toString:function(){return"Tooltip "+this.id;}});}());(function(){YAHOO.widget.Panel=function(v,u){YAHOO.widget.Panel.superclass.constructor.call(this,v,u);};var s=null;var e=YAHOO.lang,f=YAHOO.util,a=f.Dom,t=f.Event,m=f.CustomEvent,k=YAHOO.util.KeyListener,i=f.Config,h=YAHOO.widget.Overlay,o=YAHOO.widget.Panel,l=YAHOO.env.ua,p=(l.ie&&(l.ie<=6||document.compatMode=="BackCompat")),g,q,c,d={"BEFORE_SHOW_MASK":"beforeShowMask","BEFORE_HIDE_MASK":"beforeHideMask","SHOW_MASK":"showMask","HIDE_MASK":"hideMask","DRAG":"drag"},n={"CLOSE":{key:"close",value:true,validator:e.isBoolean,supercedes:["visible"]},"DRAGGABLE":{key:"draggable",value:(f.DD?true:false),validator:e.isBoolean,supercedes:["visible"]},"DRAG_ONLY":{key:"dragonly",value:false,validator:e.isBoolean,supercedes:["draggable"]},"UNDERLAY":{key:"underlay",value:"shadow",supercedes:["visible"]},"MODAL":{key:"modal",value:false,validator:e.isBoolean,supercedes:["visible","zindex"]},"KEY_LISTENERS":{key:"keylisteners",suppressEvent:true,supercedes:["visible"]},"STRINGS":{key:"strings",supercedes:["close"],validator:e.isObject,value:{close:"Close"}}};o.CSS_PANEL="yui-panel";o.CSS_PANEL_CONTAINER="yui-panel-container";o.FOCUSABLE=["a","button","select","textarea","input","iframe"];function j(v,u){if(!this.header&&this.cfg.getProperty("draggable")){this.setHeader("&#160;");}}function r(v,u,w){var z=w[0],x=w[1],y=this.cfg,A=y.getProperty("width");if(A==x){y.setProperty("width",z);}this.unsubscribe("hide",r,w);}function b(v,u){var y,x,w;if(p){y=this.cfg;x=y.getProperty("width");if(!x||x=="auto"){w=(this.element.offsetWidth+"px");y.setProperty("width",w);this.subscribe("hide",r,[(x||""),w]);}}}YAHOO.extend(o,h,{init:function(v,u){o.superclass.init.call(this,v);this.beforeInitEvent.fire(o);a.addClass(this.element,o.CSS_PANEL);this.buildWrapper();if(u){this.cfg.applyConfig(u,true);}this.subscribe("showMask",this._addFocusHandlers);this.subscribe("hideMask",this._removeFocusHandlers);this.subscribe("beforeRender",j);this.subscribe("render",function(){this.setFirstLastFocusable();this.subscribe("changeContent",this.setFirstLastFocusable);});this.subscribe("show",this._focusOnShow);this.initEvent.fire(o);},_onElementFocus:function(z){if(s===this){var y=t.getTarget(z),x=document.documentElement,v=(y!==x&&y!==window);if(v&&y!==this.element&&y!==this.mask&&!a.isAncestor(this.element,y)){try{this._focusFirstModal();}catch(w){try{if(v&&y!==document.body){y.blur();}}catch(u){}}}}},_focusFirstModal:function(){var u=this.firstElement;if(u){u.focus();}else{if(this._modalFocus){this._modalFocus.focus();}else{this.innerElement.focus();}}},_addFocusHandlers:function(v,u){if(!this.firstElement){if(l.webkit||l.opera){if(!this._modalFocus){this._createHiddenFocusElement();}}else{this.innerElement.tabIndex=0;}}this._setTabLoop(this.firstElement,this.lastElement);t.onFocus(document.documentElement,this._onElementFocus,this,true);s=this;},_createHiddenFocusElement:function(){var u=document.createElement("button");
+u.style.height="1px";u.style.width="1px";u.style.position="absolute";u.style.left="-10000em";u.style.opacity=0;u.tabIndex=-1;this.innerElement.appendChild(u);this._modalFocus=u;},_removeFocusHandlers:function(v,u){t.removeFocusListener(document.documentElement,this._onElementFocus,this);if(s==this){s=null;}},_focusOnShow:function(v,u,w){if(u&&u[1]){t.stopEvent(u[1]);}if(!this.focusFirst(v,u,w)){if(this.cfg.getProperty("modal")){this._focusFirstModal();}}},focusFirst:function(w,u,z){var v=this.firstElement,y=false;if(u&&u[1]){t.stopEvent(u[1]);}if(v){try{v.focus();y=true;}catch(x){}}return y;},focusLast:function(w,u,z){var v=this.lastElement,y=false;if(u&&u[1]){t.stopEvent(u[1]);}if(v){try{v.focus();y=true;}catch(x){}}return y;},_setTabLoop:function(u,v){this.setTabLoop(u,v);},setTabLoop:function(x,z){var v=this.preventBackTab,w=this.preventTabOut,u=this.showEvent,y=this.hideEvent;if(v){v.disable();u.unsubscribe(v.enable,v);y.unsubscribe(v.disable,v);v=this.preventBackTab=null;}if(w){w.disable();u.unsubscribe(w.enable,w);y.unsubscribe(w.disable,w);w=this.preventTabOut=null;}if(x){this.preventBackTab=new k(x,{shift:true,keys:9},{fn:this.focusLast,scope:this,correctScope:true});v=this.preventBackTab;u.subscribe(v.enable,v,true);y.subscribe(v.disable,v,true);}if(z){this.preventTabOut=new k(z,{shift:false,keys:9},{fn:this.focusFirst,scope:this,correctScope:true});w=this.preventTabOut;u.subscribe(w.enable,w,true);y.subscribe(w.disable,w,true);}},getFocusableElements:function(v){v=v||this.innerElement;var x={},u=this;for(var w=0;w<o.FOCUSABLE.length;w++){x[o.FOCUSABLE[w]]=true;}return a.getElementsBy(function(y){return u._testIfFocusable(y,x);},null,v);},_testIfFocusable:function(u,v){if(u.focus&&u.type!=="hidden"&&!u.disabled&&v[u.tagName.toLowerCase()]){return true;}return false;},setFirstLastFocusable:function(){this.firstElement=null;this.lastElement=null;var u=this.getFocusableElements();this.focusableElements=u;if(u.length>0){this.firstElement=u[0];this.lastElement=u[u.length-1];}if(this.cfg.getProperty("modal")){this._setTabLoop(this.firstElement,this.lastElement);}},initEvents:function(){o.superclass.initEvents.call(this);var u=m.LIST;this.showMaskEvent=this.createEvent(d.SHOW_MASK);this.showMaskEvent.signature=u;this.beforeShowMaskEvent=this.createEvent(d.BEFORE_SHOW_MASK);this.beforeShowMaskEvent.signature=u;this.hideMaskEvent=this.createEvent(d.HIDE_MASK);this.hideMaskEvent.signature=u;this.beforeHideMaskEvent=this.createEvent(d.BEFORE_HIDE_MASK);this.beforeHideMaskEvent.signature=u;this.dragEvent=this.createEvent(d.DRAG);this.dragEvent.signature=u;},initDefaultConfig:function(){o.superclass.initDefaultConfig.call(this);this.cfg.addProperty(n.CLOSE.key,{handler:this.configClose,value:n.CLOSE.value,validator:n.CLOSE.validator,supercedes:n.CLOSE.supercedes});this.cfg.addProperty(n.DRAGGABLE.key,{handler:this.configDraggable,value:(f.DD)?true:false,validator:n.DRAGGABLE.validator,supercedes:n.DRAGGABLE.supercedes});this.cfg.addProperty(n.DRAG_ONLY.key,{value:n.DRAG_ONLY.value,validator:n.DRAG_ONLY.validator,supercedes:n.DRAG_ONLY.supercedes});this.cfg.addProperty(n.UNDERLAY.key,{handler:this.configUnderlay,value:n.UNDERLAY.value,supercedes:n.UNDERLAY.supercedes});this.cfg.addProperty(n.MODAL.key,{handler:this.configModal,value:n.MODAL.value,validator:n.MODAL.validator,supercedes:n.MODAL.supercedes});this.cfg.addProperty(n.KEY_LISTENERS.key,{handler:this.configKeyListeners,suppressEvent:n.KEY_LISTENERS.suppressEvent,supercedes:n.KEY_LISTENERS.supercedes});this.cfg.addProperty(n.STRINGS.key,{value:n.STRINGS.value,handler:this.configStrings,validator:n.STRINGS.validator,supercedes:n.STRINGS.supercedes});},configClose:function(y,v,z){var A=v[0],x=this.close,u=this.cfg.getProperty("strings"),w;if(A){if(!x){if(!c){c=document.createElement("a");c.className="container-close";c.href="#";}x=c.cloneNode(true);w=this.innerElement.firstChild;if(w){this.innerElement.insertBefore(x,w);}else{this.innerElement.appendChild(x);}x.innerHTML=(u&&u.close)?u.close:"&#160;";t.on(x,"click",this._doClose,this,true);this.close=x;}else{x.style.display="block";}}else{if(x){x.style.display="none";}}},_doClose:function(u){t.preventDefault(u);this.hide();},configDraggable:function(v,u,w){var x=u[0];if(x){if(!f.DD){this.cfg.setProperty("draggable",false);return;}if(this.header){a.setStyle(this.header,"cursor","move");this.registerDragDrop();}this.subscribe("beforeShow",b);}else{if(this.dd){this.dd.unreg();}if(this.header){a.setStyle(this.header,"cursor","auto");}this.unsubscribe("beforeShow",b);}},configUnderlay:function(D,C,z){var B=(this.platform=="mac"&&l.gecko),E=C[0].toLowerCase(),v=this.underlay,w=this.element;function x(){var F=false;if(!v){if(!q){q=document.createElement("div");q.className="underlay";}v=q.cloneNode(false);this.element.appendChild(v);this.underlay=v;if(p){this.sizeUnderlay();this.cfg.subscribeToConfigEvent("width",this.sizeUnderlay);this.cfg.subscribeToConfigEvent("height",this.sizeUnderlay);this.changeContentEvent.subscribe(this.sizeUnderlay);YAHOO.widget.Module.textResizeEvent.subscribe(this.sizeUnderlay,this,true);}if(l.webkit&&l.webkit<420){this.changeContentEvent.subscribe(this.forceUnderlayRedraw);}F=true;}}function A(){var F=x.call(this);if(!F&&p){this.sizeUnderlay();}this._underlayDeferred=false;this.beforeShowEvent.unsubscribe(A);}function y(){if(this._underlayDeferred){this.beforeShowEvent.unsubscribe(A);this._underlayDeferred=false;}if(v){this.cfg.unsubscribeFromConfigEvent("width",this.sizeUnderlay);this.cfg.unsubscribeFromConfigEvent("height",this.sizeUnderlay);this.changeContentEvent.unsubscribe(this.sizeUnderlay);this.changeContentEvent.unsubscribe(this.forceUnderlayRedraw);YAHOO.widget.Module.textResizeEvent.unsubscribe(this.sizeUnderlay,this,true);this.element.removeChild(v);this.underlay=null;}}switch(E){case"shadow":a.removeClass(w,"matte");a.addClass(w,"shadow");break;case"matte":if(!B){y.call(this);}a.removeClass(w,"shadow");a.addClass(w,"matte");break;default:if(!B){y.call(this);
+}a.removeClass(w,"shadow");a.removeClass(w,"matte");break;}if((E=="shadow")||(B&&!v)){if(this.cfg.getProperty("visible")){var u=x.call(this);if(!u&&p){this.sizeUnderlay();}}else{if(!this._underlayDeferred){this.beforeShowEvent.subscribe(A);this._underlayDeferred=true;}}}},configModal:function(v,u,x){var w=u[0];if(w){if(!this._hasModalityEventListeners){this.subscribe("beforeShow",this.buildMask);this.subscribe("beforeShow",this.bringToTop);this.subscribe("beforeShow",this.showMask);this.subscribe("hide",this.hideMask);h.windowResizeEvent.subscribe(this.sizeMask,this,true);this._hasModalityEventListeners=true;}}else{if(this._hasModalityEventListeners){if(this.cfg.getProperty("visible")){this.hideMask();this.removeMask();}this.unsubscribe("beforeShow",this.buildMask);this.unsubscribe("beforeShow",this.bringToTop);this.unsubscribe("beforeShow",this.showMask);this.unsubscribe("hide",this.hideMask);h.windowResizeEvent.unsubscribe(this.sizeMask,this);this._hasModalityEventListeners=false;}}},removeMask:function(){var v=this.mask,u;if(v){this.hideMask();u=v.parentNode;if(u){u.removeChild(v);}this.mask=null;}},configKeyListeners:function(x,u,A){var w=u[0],z,y,v;if(w){if(w instanceof Array){y=w.length;for(v=0;v<y;v++){z=w[v];if(!i.alreadySubscribed(this.showEvent,z.enable,z)){this.showEvent.subscribe(z.enable,z,true);}if(!i.alreadySubscribed(this.hideEvent,z.disable,z)){this.hideEvent.subscribe(z.disable,z,true);this.destroyEvent.subscribe(z.disable,z,true);}}}else{if(!i.alreadySubscribed(this.showEvent,w.enable,w)){this.showEvent.subscribe(w.enable,w,true);}if(!i.alreadySubscribed(this.hideEvent,w.disable,w)){this.hideEvent.subscribe(w.disable,w,true);this.destroyEvent.subscribe(w.disable,w,true);}}}},configStrings:function(v,u,w){var x=e.merge(n.STRINGS.value,u[0]);this.cfg.setProperty(n.STRINGS.key,x,true);},configHeight:function(x,v,y){var u=v[0],w=this.innerElement;a.setStyle(w,"height",u);this.cfg.refireEvent("iframe");},_autoFillOnHeightChange:function(x,v,w){o.superclass._autoFillOnHeightChange.apply(this,arguments);if(p){var u=this;setTimeout(function(){u.sizeUnderlay();},0);}},configWidth:function(x,u,y){var w=u[0],v=this.innerElement;a.setStyle(v,"width",w);this.cfg.refireEvent("iframe");},configzIndex:function(v,u,x){o.superclass.configzIndex.call(this,v,u,x);if(this.mask||this.cfg.getProperty("modal")===true){var w=a.getStyle(this.element,"zIndex");if(!w||isNaN(w)){w=0;}if(w===0){this.cfg.setProperty("zIndex",1);}else{this.stackMask();}}},buildWrapper:function(){var w=this.element.parentNode,u=this.element,v=document.createElement("div");v.className=o.CSS_PANEL_CONTAINER;v.id=u.id+"_c";if(w){w.insertBefore(v,u);}v.appendChild(u);this.element=v;this.innerElement=u;a.setStyle(this.innerElement,"visibility","inherit");},sizeUnderlay:function(){var v=this.underlay,u;if(v){u=this.element;v.style.width=u.offsetWidth+"px";v.style.height=u.offsetHeight+"px";}},registerDragDrop:function(){var v=this;if(this.header){if(!f.DD){return;}var u=(this.cfg.getProperty("dragonly")===true);this.dd=new f.DD(this.element.id,this.id,{dragOnly:u});if(!this.header.id){this.header.id=this.id+"_h";}this.dd.startDrag=function(){var x,z,w,C,B,A;if(YAHOO.env.ua.ie==6){a.addClass(v.element,"drag");}if(v.cfg.getProperty("constraintoviewport")){var y=h.VIEWPORT_OFFSET;x=v.element.offsetHeight;z=v.element.offsetWidth;w=a.getViewportWidth();C=a.getViewportHeight();B=a.getDocumentScrollLeft();A=a.getDocumentScrollTop();if(x+y<C){this.minY=A+y;this.maxY=A+C-x-y;}else{this.minY=A+y;this.maxY=A+y;}if(z+y<w){this.minX=B+y;this.maxX=B+w-z-y;}else{this.minX=B+y;this.maxX=B+y;}this.constrainX=true;this.constrainY=true;}else{this.constrainX=false;this.constrainY=false;}v.dragEvent.fire("startDrag",arguments);};this.dd.onDrag=function(){v.syncPosition();v.cfg.refireEvent("iframe");if(this.platform=="mac"&&YAHOO.env.ua.gecko){this.showMacGeckoScrollbars();}v.dragEvent.fire("onDrag",arguments);};this.dd.endDrag=function(){if(YAHOO.env.ua.ie==6){a.removeClass(v.element,"drag");}v.dragEvent.fire("endDrag",arguments);v.moveEvent.fire(v.cfg.getProperty("xy"));};this.dd.setHandleElId(this.header.id);this.dd.addInvalidHandleType("INPUT");this.dd.addInvalidHandleType("SELECT");this.dd.addInvalidHandleType("TEXTAREA");}},buildMask:function(){var u=this.mask;if(!u){if(!g){g=document.createElement("div");g.className="mask";g.innerHTML="&#160;";}u=g.cloneNode(true);u.id=this.id+"_mask";document.body.insertBefore(u,document.body.firstChild);this.mask=u;if(YAHOO.env.ua.gecko&&this.platform=="mac"){a.addClass(this.mask,"block-scrollbars");}this.stackMask();}},hideMask:function(){if(this.cfg.getProperty("modal")&&this.mask&&this.beforeHideMaskEvent.fire()){this.mask.style.display="none";a.removeClass(document.body,"masked");this.hideMaskEvent.fire();}},showMask:function(){if(this.cfg.getProperty("modal")&&this.mask&&this.beforeShowMaskEvent.fire()){a.addClass(document.body,"masked");this.sizeMask();this.mask.style.display="block";this.showMaskEvent.fire();}},sizeMask:function(){if(this.mask){var v=this.mask,w=a.getViewportWidth(),u=a.getViewportHeight();if(v.offsetHeight>u){v.style.height=u+"px";}if(v.offsetWidth>w){v.style.width=w+"px";}v.style.height=a.getDocumentHeight()+"px";v.style.width=a.getDocumentWidth()+"px";}},stackMask:function(){if(this.mask){var u=a.getStyle(this.element,"zIndex");if(!YAHOO.lang.isUndefined(u)&&!isNaN(u)){a.setStyle(this.mask,"zIndex",u-1);}}},render:function(u){return o.superclass.render.call(this,u,this.innerElement);},_renderHeader:function(u){u=u||this.innerElement;o.superclass._renderHeader.call(this,u);},_renderBody:function(u){u=u||this.innerElement;o.superclass._renderBody.call(this,u);},_renderFooter:function(u){u=u||this.innerElement;o.superclass._renderFooter.call(this,u);},destroy:function(u){h.windowResizeEvent.unsubscribe(this.sizeMask,this);this.removeMask();if(this.close){t.purgeElement(this.close);}o.superclass.destroy.call(this,u);},forceUnderlayRedraw:function(){var v=this.underlay;a.addClass(v,"yui-force-redraw");
+setTimeout(function(){a.removeClass(v,"yui-force-redraw");},0);},toString:function(){return"Panel "+this.id;}});}());(function(){YAHOO.widget.Dialog=function(j,i){YAHOO.widget.Dialog.superclass.constructor.call(this,j,i);};var b=YAHOO.util.Event,g=YAHOO.util.CustomEvent,e=YAHOO.util.Dom,a=YAHOO.widget.Dialog,f=YAHOO.lang,h={"BEFORE_SUBMIT":"beforeSubmit","SUBMIT":"submit","MANUAL_SUBMIT":"manualSubmit","ASYNC_SUBMIT":"asyncSubmit","FORM_SUBMIT":"formSubmit","CANCEL":"cancel"},c={"POST_METHOD":{key:"postmethod",value:"async"},"POST_DATA":{key:"postdata",value:null},"BUTTONS":{key:"buttons",value:"none",supercedes:["visible"]},"HIDEAFTERSUBMIT":{key:"hideaftersubmit",value:true}};a.CSS_DIALOG="yui-dialog";function d(){var m=this._aButtons,k,l,j;if(f.isArray(m)){k=m.length;if(k>0){j=k-1;do{l=m[j];if(YAHOO.widget.Button&&l instanceof YAHOO.widget.Button){l.destroy();}else{if(l.tagName.toUpperCase()=="BUTTON"){b.purgeElement(l);b.purgeElement(l,false);}}}while(j--);}}}YAHOO.extend(a,YAHOO.widget.Panel,{form:null,initDefaultConfig:function(){a.superclass.initDefaultConfig.call(this);this.callback={success:null,failure:null,argument:null};this.cfg.addProperty(c.POST_METHOD.key,{handler:this.configPostMethod,value:c.POST_METHOD.value,validator:function(i){if(i!="form"&&i!="async"&&i!="none"&&i!="manual"){return false;}else{return true;}}});this.cfg.addProperty(c.POST_DATA.key,{value:c.POST_DATA.value});this.cfg.addProperty(c.HIDEAFTERSUBMIT.key,{value:c.HIDEAFTERSUBMIT.value});this.cfg.addProperty(c.BUTTONS.key,{handler:this.configButtons,value:c.BUTTONS.value,supercedes:c.BUTTONS.supercedes});},initEvents:function(){a.superclass.initEvents.call(this);var i=g.LIST;this.beforeSubmitEvent=this.createEvent(h.BEFORE_SUBMIT);this.beforeSubmitEvent.signature=i;this.submitEvent=this.createEvent(h.SUBMIT);this.submitEvent.signature=i;this.manualSubmitEvent=this.createEvent(h.MANUAL_SUBMIT);this.manualSubmitEvent.signature=i;this.asyncSubmitEvent=this.createEvent(h.ASYNC_SUBMIT);this.asyncSubmitEvent.signature=i;this.formSubmitEvent=this.createEvent(h.FORM_SUBMIT);this.formSubmitEvent.signature=i;this.cancelEvent=this.createEvent(h.CANCEL);this.cancelEvent.signature=i;},init:function(j,i){a.superclass.init.call(this,j);this.beforeInitEvent.fire(a);e.addClass(this.element,a.CSS_DIALOG);this.cfg.setProperty("visible",false);if(i){this.cfg.applyConfig(i,true);}this.beforeHideEvent.subscribe(this.blurButtons,this,true);this.subscribe("changeBody",this.registerForm);this.initEvent.fire(a);},doSubmit:function(){var q=YAHOO.util.Connect,r=this.form,l=false,o=false,s,n,m,j;switch(this.cfg.getProperty("postmethod")){case"async":s=r.elements;n=s.length;if(n>0){m=n-1;do{if(s[m].type=="file"){l=true;break;}}while(m--);}if(l&&YAHOO.env.ua.ie&&this.isSecure){o=true;}j=this._getFormAttributes(r);q.setForm(r,l,o);var k=this.cfg.getProperty("postdata");var p=q.asyncRequest(j.method,j.action,this.callback,k);this.asyncSubmitEvent.fire(p);break;case"form":r.submit();this.formSubmitEvent.fire();break;case"none":case"manual":this.manualSubmitEvent.fire();break;}},_getFormAttributes:function(k){var i={method:null,action:null};if(k){if(k.getAttributeNode){var j=k.getAttributeNode("action");var l=k.getAttributeNode("method");if(j){i.action=j.value;}if(l){i.method=l.value;}}else{i.action=k.getAttribute("action");i.method=k.getAttribute("method");}}i.method=(f.isString(i.method)?i.method:"POST").toUpperCase();i.action=f.isString(i.action)?i.action:"";return i;},registerForm:function(){var i=this.element.getElementsByTagName("form")[0];if(this.form){if(this.form==i&&e.isAncestor(this.element,this.form)){return;}else{b.purgeElement(this.form);this.form=null;}}if(!i){i=document.createElement("form");i.name="frm_"+this.id;this.body.appendChild(i);}if(i){this.form=i;b.on(i,"submit",this._submitHandler,this,true);}},_submitHandler:function(i){b.stopEvent(i);this.submit();this.form.blur();},setTabLoop:function(i,j){i=i||this.firstButton;j=j||this.lastButton;a.superclass.setTabLoop.call(this,i,j);},_setTabLoop:function(i,j){i=i||this.firstButton;j=this.lastButton||j;this.setTabLoop(i,j);},setFirstLastFocusable:function(){a.superclass.setFirstLastFocusable.call(this);var k,j,m,n=this.focusableElements;this.firstFormElement=null;this.lastFormElement=null;if(this.form&&n&&n.length>0){j=n.length;for(k=0;k<j;++k){m=n[k];if(this.form===m.form){this.firstFormElement=m;break;}}for(k=j-1;k>=0;--k){m=n[k];if(this.form===m.form){this.lastFormElement=m;break;}}}},configClose:function(j,i,k){a.superclass.configClose.apply(this,arguments);},_doClose:function(i){b.preventDefault(i);this.cancel();},configButtons:function(t,s,n){var o=YAHOO.widget.Button,v=s[0],l=this.innerElement,u,q,k,r,p,j,m;d.call(this);this._aButtons=null;if(f.isArray(v)){p=document.createElement("span");p.className="button-group";r=v.length;this._aButtons=[];this.defaultHtmlButton=null;for(m=0;m<r;m++){u=v[m];if(o){k=new o({label:u.text,type:u.type});k.appendTo(p);q=k.get("element");if(u.isDefault){k.addClass("default");this.defaultHtmlButton=q;}if(f.isFunction(u.handler)){k.set("onclick",{fn:u.handler,obj:this,scope:this});}else{if(f.isObject(u.handler)&&f.isFunction(u.handler.fn)){k.set("onclick",{fn:u.handler.fn,obj:((!f.isUndefined(u.handler.obj))?u.handler.obj:this),scope:(u.handler.scope||this)});}}this._aButtons[this._aButtons.length]=k;}else{q=document.createElement("button");q.setAttribute("type","button");if(u.isDefault){q.className="default";this.defaultHtmlButton=q;}q.innerHTML=u.text;if(f.isFunction(u.handler)){b.on(q,"click",u.handler,this,true);}else{if(f.isObject(u.handler)&&f.isFunction(u.handler.fn)){b.on(q,"click",u.handler.fn,((!f.isUndefined(u.handler.obj))?u.handler.obj:this),(u.handler.scope||this));}}p.appendChild(q);this._aButtons[this._aButtons.length]=q;}u.htmlButton=q;if(m===0){this.firstButton=q;}if(m==(r-1)){this.lastButton=q;}}this.setFooter(p);j=this.footer;if(e.inDocument(this.element)&&!e.isAncestor(l,j)){l.appendChild(j);}this.buttonSpan=p;}else{p=this.buttonSpan;
+j=this.footer;if(p&&j){j.removeChild(p);this.buttonSpan=null;this.firstButton=null;this.lastButton=null;this.defaultHtmlButton=null;}}this.changeContentEvent.fire();},getButtons:function(){return this._aButtons||null;},focusFirst:function(k,i,n){var j=this.firstFormElement,m=false;if(i&&i[1]){b.stopEvent(i[1]);if(i[0]===9&&this.firstElement){j=this.firstElement;}}if(j){try{j.focus();m=true;}catch(l){}}else{if(this.defaultHtmlButton){m=this.focusDefaultButton();}else{m=this.focusFirstButton();}}return m;},focusLast:function(k,i,n){var o=this.cfg.getProperty("buttons"),j=this.lastFormElement,m=false;if(i&&i[1]){b.stopEvent(i[1]);if(i[0]===9&&this.lastElement){j=this.lastElement;}}if(o&&f.isArray(o)){m=this.focusLastButton();}else{if(j){try{j.focus();m=true;}catch(l){}}}return m;},_getButton:function(j){var i=YAHOO.widget.Button;if(i&&j&&j.nodeName&&j.id){j=i.getButton(j.id)||j;}return j;},focusDefaultButton:function(){var i=this._getButton(this.defaultHtmlButton),k=false;if(i){try{i.focus();k=true;}catch(j){}}return k;},blurButtons:function(){var o=this.cfg.getProperty("buttons"),l,n,k,j;if(o&&f.isArray(o)){l=o.length;if(l>0){j=(l-1);do{n=o[j];if(n){k=this._getButton(n.htmlButton);if(k){try{k.blur();}catch(m){}}}}while(j--);}}},focusFirstButton:function(){var m=this.cfg.getProperty("buttons"),k,i,l=false;if(m&&f.isArray(m)){k=m[0];if(k){i=this._getButton(k.htmlButton);if(i){try{i.focus();l=true;}catch(j){}}}}return l;},focusLastButton:function(){var n=this.cfg.getProperty("buttons"),j,l,i,m=false;if(n&&f.isArray(n)){j=n.length;if(j>0){l=n[(j-1)];if(l){i=this._getButton(l.htmlButton);if(i){try{i.focus();m=true;}catch(k){}}}}}return m;},configPostMethod:function(j,i,k){this.registerForm();},validate:function(){return true;},submit:function(){if(this.validate()){if(this.beforeSubmitEvent.fire()){this.doSubmit();this.submitEvent.fire();if(this.cfg.getProperty("hideaftersubmit")){this.hide();}return true;}else{return false;}}else{return false;}},cancel:function(){this.cancelEvent.fire();this.hide();},getData:function(){var A=this.form,k,t,w,m,u,r,q,j,x,l,y,B,p,C,o,z,v;function s(n){var i=n.tagName.toUpperCase();return((i=="INPUT"||i=="TEXTAREA"||i=="SELECT")&&n.name==m);}if(A){k=A.elements;t=k.length;w={};for(z=0;z<t;z++){m=k[z].name;u=e.getElementsBy(s,"*",A);r=u.length;if(r>0){if(r==1){u=u[0];q=u.type;j=u.tagName.toUpperCase();switch(j){case"INPUT":if(q=="checkbox"){w[m]=u.checked;}else{if(q!="radio"){w[m]=u.value;}}break;case"TEXTAREA":w[m]=u.value;break;case"SELECT":x=u.options;l=x.length;y=[];for(v=0;v<l;v++){B=x[v];if(B.selected){o=B.attributes.value;y[y.length]=(o&&o.specified)?B.value:B.text;}}w[m]=y;break;}}else{q=u[0].type;switch(q){case"radio":for(v=0;v<r;v++){p=u[v];if(p.checked){w[m]=p.value;break;}}break;case"checkbox":y=[];for(v=0;v<r;v++){C=u[v];if(C.checked){y[y.length]=C.value;}}w[m]=y;break;}}}}}return w;},destroy:function(i){d.call(this);this._aButtons=null;var j=this.element.getElementsByTagName("form"),k;if(j.length>0){k=j[0];if(k){b.purgeElement(k);if(k.parentNode){k.parentNode.removeChild(k);}this.form=null;}}a.superclass.destroy.call(this,i);},toString:function(){return"Dialog "+this.id;}});}());(function(){YAHOO.widget.SimpleDialog=function(e,d){YAHOO.widget.SimpleDialog.superclass.constructor.call(this,e,d);};var c=YAHOO.util.Dom,b=YAHOO.widget.SimpleDialog,a={"ICON":{key:"icon",value:"none",suppressEvent:true},"TEXT":{key:"text",value:"",suppressEvent:true,supercedes:["icon"]}};b.ICON_BLOCK="blckicon";b.ICON_ALARM="alrticon";b.ICON_HELP="hlpicon";b.ICON_INFO="infoicon";b.ICON_WARN="warnicon";b.ICON_TIP="tipicon";b.ICON_CSS_CLASSNAME="yui-icon";b.CSS_SIMPLEDIALOG="yui-simple-dialog";YAHOO.extend(b,YAHOO.widget.Dialog,{initDefaultConfig:function(){b.superclass.initDefaultConfig.call(this);this.cfg.addProperty(a.ICON.key,{handler:this.configIcon,value:a.ICON.value,suppressEvent:a.ICON.suppressEvent});this.cfg.addProperty(a.TEXT.key,{handler:this.configText,value:a.TEXT.value,suppressEvent:a.TEXT.suppressEvent,supercedes:a.TEXT.supercedes});},init:function(e,d){b.superclass.init.call(this,e);this.beforeInitEvent.fire(b);c.addClass(this.element,b.CSS_SIMPLEDIALOG);this.cfg.queueProperty("postmethod","manual");if(d){this.cfg.applyConfig(d,true);}this.beforeRenderEvent.subscribe(function(){if(!this.body){this.setBody("");}},this,true);this.initEvent.fire(b);},registerForm:function(){b.superclass.registerForm.call(this);var e=this.form.ownerDocument,d=e.createElement("input");d.type="hidden";d.name=this.id;d.value="";this.form.appendChild(d);},configIcon:function(k,j,h){var d=j[0],e=this.body,f=b.ICON_CSS_CLASSNAME,l,i,g;if(d&&d!="none"){l=c.getElementsByClassName(f,"*",e);if(l.length===1){i=l[0];g=i.parentNode;if(g){g.removeChild(i);i=null;}}if(d.indexOf(".")==-1){i=document.createElement("span");i.className=(f+" "+d);i.innerHTML="&#160;";}else{i=document.createElement("img");i.src=(this.imageRoot+d);i.className=f;}if(i){e.insertBefore(i,e.firstChild);}}},configText:function(e,d,f){var g=d[0];if(g){this.setBody(g);this.cfg.refireEvent("icon");}},toString:function(){return"SimpleDialog "+this.id;}});}());(function(){YAHOO.widget.ContainerEffect=function(e,h,g,d,f){if(!f){f=YAHOO.util.Anim;}this.overlay=e;this.attrIn=h;this.attrOut=g;this.targetElement=d||e.element;this.animClass=f;};var b=YAHOO.util.Dom,c=YAHOO.util.CustomEvent,a=YAHOO.widget.ContainerEffect;a.FADE=function(d,f){var g=YAHOO.util.Easing,i={attributes:{opacity:{from:0,to:1}},duration:f,method:g.easeIn},e={attributes:{opacity:{to:0}},duration:f,method:g.easeOut},h=new a(d,i,e,d.element);h.handleUnderlayStart=function(){var k=this.overlay.underlay;if(k&&YAHOO.env.ua.ie){var j=(k.filters&&k.filters.length>0);if(j){b.addClass(d.element,"yui-effect-fade");}}};h.handleUnderlayComplete=function(){var j=this.overlay.underlay;if(j&&YAHOO.env.ua.ie){b.removeClass(d.element,"yui-effect-fade");}};h.handleStartAnimateIn=function(k,j,l){l.overlay._fadingIn=true;b.addClass(l.overlay.element,"hide-select");if(!l.overlay.underlay){l.overlay.cfg.refireEvent("underlay");
+}l.handleUnderlayStart();l.overlay._setDomVisibility(true);b.setStyle(l.overlay.element,"opacity",0);};h.handleCompleteAnimateIn=function(k,j,l){l.overlay._fadingIn=false;b.removeClass(l.overlay.element,"hide-select");if(l.overlay.element.style.filter){l.overlay.element.style.filter=null;}l.handleUnderlayComplete();l.overlay.cfg.refireEvent("iframe");l.animateInCompleteEvent.fire();};h.handleStartAnimateOut=function(k,j,l){l.overlay._fadingOut=true;b.addClass(l.overlay.element,"hide-select");l.handleUnderlayStart();};h.handleCompleteAnimateOut=function(k,j,l){l.overlay._fadingOut=false;b.removeClass(l.overlay.element,"hide-select");if(l.overlay.element.style.filter){l.overlay.element.style.filter=null;}l.overlay._setDomVisibility(false);b.setStyle(l.overlay.element,"opacity",1);l.handleUnderlayComplete();l.overlay.cfg.refireEvent("iframe");l.animateOutCompleteEvent.fire();};h.init();return h;};a.SLIDE=function(f,d){var i=YAHOO.util.Easing,l=f.cfg.getProperty("x")||b.getX(f.element),k=f.cfg.getProperty("y")||b.getY(f.element),m=b.getClientWidth(),h=f.element.offsetWidth,j={attributes:{points:{to:[l,k]}},duration:d,method:i.easeIn},e={attributes:{points:{to:[(m+25),k]}},duration:d,method:i.easeOut},g=new a(f,j,e,f.element,YAHOO.util.Motion);g.handleStartAnimateIn=function(o,n,p){p.overlay.element.style.left=((-25)-h)+"px";p.overlay.element.style.top=k+"px";};g.handleTweenAnimateIn=function(q,p,r){var s=b.getXY(r.overlay.element),o=s[0],n=s[1];if(b.getStyle(r.overlay.element,"visibility")=="hidden"&&o<l){r.overlay._setDomVisibility(true);}r.overlay.cfg.setProperty("xy",[o,n],true);r.overlay.cfg.refireEvent("iframe");};g.handleCompleteAnimateIn=function(o,n,p){p.overlay.cfg.setProperty("xy",[l,k],true);p.startX=l;p.startY=k;p.overlay.cfg.refireEvent("iframe");p.animateInCompleteEvent.fire();};g.handleStartAnimateOut=function(o,n,r){var p=b.getViewportWidth(),s=b.getXY(r.overlay.element),q=s[1];r.animOut.attributes.points.to=[(p+25),q];};g.handleTweenAnimateOut=function(p,o,q){var s=b.getXY(q.overlay.element),n=s[0],r=s[1];q.overlay.cfg.setProperty("xy",[n,r],true);q.overlay.cfg.refireEvent("iframe");};g.handleCompleteAnimateOut=function(o,n,p){p.overlay._setDomVisibility(false);p.overlay.cfg.setProperty("xy",[l,k]);p.animateOutCompleteEvent.fire();};g.init();return g;};a.prototype={init:function(){this.beforeAnimateInEvent=this.createEvent("beforeAnimateIn");this.beforeAnimateInEvent.signature=c.LIST;this.beforeAnimateOutEvent=this.createEvent("beforeAnimateOut");this.beforeAnimateOutEvent.signature=c.LIST;this.animateInCompleteEvent=this.createEvent("animateInComplete");this.animateInCompleteEvent.signature=c.LIST;this.animateOutCompleteEvent=this.createEvent("animateOutComplete");this.animateOutCompleteEvent.signature=c.LIST;this.animIn=new this.animClass(this.targetElement,this.attrIn.attributes,this.attrIn.duration,this.attrIn.method);this.animIn.onStart.subscribe(this.handleStartAnimateIn,this);this.animIn.onTween.subscribe(this.handleTweenAnimateIn,this);this.animIn.onComplete.subscribe(this.handleCompleteAnimateIn,this);this.animOut=new this.animClass(this.targetElement,this.attrOut.attributes,this.attrOut.duration,this.attrOut.method);this.animOut.onStart.subscribe(this.handleStartAnimateOut,this);this.animOut.onTween.subscribe(this.handleTweenAnimateOut,this);this.animOut.onComplete.subscribe(this.handleCompleteAnimateOut,this);},animateIn:function(){this._stopAnims(this.lastFrameOnStop);this.beforeAnimateInEvent.fire();this.animIn.animate();},animateOut:function(){this._stopAnims(this.lastFrameOnStop);this.beforeAnimateOutEvent.fire();this.animOut.animate();},lastFrameOnStop:true,_stopAnims:function(d){if(this.animOut&&this.animOut.isAnimated()){this.animOut.stop(d);}if(this.animIn&&this.animIn.isAnimated()){this.animIn.stop(d);}},handleStartAnimateIn:function(e,d,f){},handleTweenAnimateIn:function(e,d,f){},handleCompleteAnimateIn:function(e,d,f){},handleStartAnimateOut:function(e,d,f){},handleTweenAnimateOut:function(e,d,f){},handleCompleteAnimateOut:function(e,d,f){},toString:function(){var d="ContainerEffect";if(this.overlay){d+=" ["+this.overlay.toString()+"]";}return d;}};YAHOO.lang.augmentProto(a,YAHOO.util.EventProvider);})();YAHOO.register("container",YAHOO.widget.Module,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/container/container_core-min.js b/js/yui/container/container_core-min.js
new file mode 100644 (file)
index 0000000..d1e3b7a
--- /dev/null
+++ b/js/yui/container/container_core-min.js
@@ -0,0 +1,14 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){YAHOO.util.Config=function(d){if(d){this.init(d);}};var b=YAHOO.lang,c=YAHOO.util.CustomEvent,a=YAHOO.util.Config;a.CONFIG_CHANGED_EVENT="configChanged";a.BOOLEAN_TYPE="boolean";a.prototype={owner:null,queueInProgress:false,config:null,initialConfig:null,eventQueue:null,configChangedEvent:null,init:function(d){this.owner=d;this.configChangedEvent=this.createEvent(a.CONFIG_CHANGED_EVENT);this.configChangedEvent.signature=c.LIST;this.queueInProgress=false;this.config={};this.initialConfig={};this.eventQueue=[];},checkBoolean:function(d){return(typeof d==a.BOOLEAN_TYPE);},checkNumber:function(d){return(!isNaN(d));},fireEvent:function(d,f){var e=this.config[d];if(e&&e.event){e.event.fire(f);}},addProperty:function(e,d){e=e.toLowerCase();this.config[e]=d;d.event=this.createEvent(e,{scope:this.owner});d.event.signature=c.LIST;d.key=e;if(d.handler){d.event.subscribe(d.handler,this.owner);}this.setProperty(e,d.value,true);if(!d.suppressEvent){this.queueProperty(e,d.value);}},getConfig:function(){var d={},f=this.config,g,e;for(g in f){if(b.hasOwnProperty(f,g)){e=f[g];if(e&&e.event){d[g]=e.value;}}}return d;},getProperty:function(d){var e=this.config[d.toLowerCase()];if(e&&e.event){return e.value;}else{return undefined;}},resetProperty:function(d){d=d.toLowerCase();var e=this.config[d];if(e&&e.event){if(d in this.initialConfig){this.setProperty(d,this.initialConfig[d]);return true;}}else{return false;}},setProperty:function(e,g,d){var f;e=e.toLowerCase();if(this.queueInProgress&&!d){this.queueProperty(e,g);return true;}else{f=this.config[e];if(f&&f.event){if(f.validator&&!f.validator(g)){return false;}else{f.value=g;if(!d){this.fireEvent(e,g);this.configChangedEvent.fire([e,g]);}return true;}}else{return false;}}},queueProperty:function(v,r){v=v.toLowerCase();var u=this.config[v],l=false,k,g,h,j,p,t,f,n,o,d,m,w,e;if(u&&u.event){if(!b.isUndefined(r)&&u.validator&&!u.validator(r)){return false;}else{if(!b.isUndefined(r)){u.value=r;}else{r=u.value;}l=false;k=this.eventQueue.length;for(m=0;m<k;m++){g=this.eventQueue[m];if(g){h=g[0];j=g[1];if(h==v){this.eventQueue[m]=null;this.eventQueue.push([v,(!b.isUndefined(r)?r:j)]);l=true;break;}}}if(!l&&!b.isUndefined(r)){this.eventQueue.push([v,r]);}}if(u.supercedes){p=u.supercedes.length;for(w=0;w<p;w++){t=u.supercedes[w];f=this.eventQueue.length;for(e=0;e<f;e++){n=this.eventQueue[e];if(n){o=n[0];d=n[1];if(o==t.toLowerCase()){this.eventQueue.push([o,d]);this.eventQueue[e]=null;break;}}}}}return true;}else{return false;}},refireEvent:function(d){d=d.toLowerCase();var e=this.config[d];if(e&&e.event&&!b.isUndefined(e.value)){if(this.queueInProgress){this.queueProperty(d);}else{this.fireEvent(d,e.value);}}},applyConfig:function(d,g){var f,e;if(g){e={};for(f in d){if(b.hasOwnProperty(d,f)){e[f.toLowerCase()]=d[f];}}this.initialConfig=e;}for(f in d){if(b.hasOwnProperty(d,f)){this.queueProperty(f,d[f]);}}},refresh:function(){var d;for(d in this.config){if(b.hasOwnProperty(this.config,d)){this.refireEvent(d);}}},fireQueue:function(){var e,h,d,g,f;this.queueInProgress=true;for(e=0;e<this.eventQueue.length;e++){h=this.eventQueue[e];if(h){d=h[0];g=h[1];f=this.config[d];f.value=g;this.eventQueue[e]=null;this.fireEvent(d,g);}}this.queueInProgress=false;this.eventQueue=[];},subscribeToConfigEvent:function(d,e,g,h){var f=this.config[d.toLowerCase()];if(f&&f.event){if(!a.alreadySubscribed(f.event,e,g)){f.event.subscribe(e,g,h);}return true;}else{return false;}},unsubscribeFromConfigEvent:function(d,e,g){var f=this.config[d.toLowerCase()];if(f&&f.event){return f.event.unsubscribe(e,g);}else{return false;}},toString:function(){var d="Config";if(this.owner){d+=" ["+this.owner.toString()+"]";}return d;},outputEventQueue:function(){var d="",g,e,f=this.eventQueue.length;for(e=0;e<f;e++){g=this.eventQueue[e];if(g){d+=g[0]+"="+g[1]+", ";}}return d;},destroy:function(){var e=this.config,d,f;for(d in e){if(b.hasOwnProperty(e,d)){f=e[d];f.event.unsubscribeAll();f.event=null;}}this.configChangedEvent.unsubscribeAll();this.configChangedEvent=null;this.owner=null;this.config=null;this.initialConfig=null;this.eventQueue=null;}};a.alreadySubscribed=function(e,h,j){var f=e.subscribers.length,d,g;if(f>0){g=f-1;do{d=e.subscribers[g];if(d&&d.obj==j&&d.fn==h){return true;}}while(g--);}return false;};YAHOO.lang.augmentProto(a,YAHOO.util.EventProvider);}());(function(){YAHOO.widget.Module=function(r,q){if(r){this.init(r,q);}else{}};var f=YAHOO.util.Dom,d=YAHOO.util.Config,n=YAHOO.util.Event,m=YAHOO.util.CustomEvent,g=YAHOO.widget.Module,i=YAHOO.env.ua,h,p,o,e,a={"BEFORE_INIT":"beforeInit","INIT":"init","APPEND":"append","BEFORE_RENDER":"beforeRender","RENDER":"render","CHANGE_HEADER":"changeHeader","CHANGE_BODY":"changeBody","CHANGE_FOOTER":"changeFooter","CHANGE_CONTENT":"changeContent","DESTROY":"destroy","BEFORE_SHOW":"beforeShow","SHOW":"show","BEFORE_HIDE":"beforeHide","HIDE":"hide"},j={"VISIBLE":{key:"visible",value:true,validator:YAHOO.lang.isBoolean},"EFFECT":{key:"effect",suppressEvent:true,supercedes:["visible"]},"MONITOR_RESIZE":{key:"monitorresize",value:true},"APPEND_TO_DOCUMENT_BODY":{key:"appendtodocumentbody",value:false}};g.IMG_ROOT=null;g.IMG_ROOT_SSL=null;g.CSS_MODULE="yui-module";g.CSS_HEADER="hd";g.CSS_BODY="bd";g.CSS_FOOTER="ft";g.RESIZE_MONITOR_SECURE_URL="javascript:false;";g.RESIZE_MONITOR_BUFFER=1;g.textResizeEvent=new m("textResize");g.forceDocumentRedraw=function(){var q=document.documentElement;if(q){q.className+=" ";q.className=YAHOO.lang.trim(q.className);}};function l(){if(!h){h=document.createElement("div");h.innerHTML=('<div class="'+g.CSS_HEADER+'"></div>'+'<div class="'+g.CSS_BODY+'"></div><div class="'+g.CSS_FOOTER+'"></div>');p=h.firstChild;o=p.nextSibling;e=o.nextSibling;}return h;}function k(){if(!p){l();}return(p.cloneNode(false));}function b(){if(!o){l();}return(o.cloneNode(false));}function c(){if(!e){l();}return(e.cloneNode(false));}g.prototype={constructor:g,element:null,header:null,body:null,footer:null,id:null,imageRoot:g.IMG_ROOT,initEvents:function(){var q=m.LIST;
+this.beforeInitEvent=this.createEvent(a.BEFORE_INIT);this.beforeInitEvent.signature=q;this.initEvent=this.createEvent(a.INIT);this.initEvent.signature=q;this.appendEvent=this.createEvent(a.APPEND);this.appendEvent.signature=q;this.beforeRenderEvent=this.createEvent(a.BEFORE_RENDER);this.beforeRenderEvent.signature=q;this.renderEvent=this.createEvent(a.RENDER);this.renderEvent.signature=q;this.changeHeaderEvent=this.createEvent(a.CHANGE_HEADER);this.changeHeaderEvent.signature=q;this.changeBodyEvent=this.createEvent(a.CHANGE_BODY);this.changeBodyEvent.signature=q;this.changeFooterEvent=this.createEvent(a.CHANGE_FOOTER);this.changeFooterEvent.signature=q;this.changeContentEvent=this.createEvent(a.CHANGE_CONTENT);this.changeContentEvent.signature=q;this.destroyEvent=this.createEvent(a.DESTROY);this.destroyEvent.signature=q;this.beforeShowEvent=this.createEvent(a.BEFORE_SHOW);this.beforeShowEvent.signature=q;this.showEvent=this.createEvent(a.SHOW);this.showEvent.signature=q;this.beforeHideEvent=this.createEvent(a.BEFORE_HIDE);this.beforeHideEvent.signature=q;this.hideEvent=this.createEvent(a.HIDE);this.hideEvent.signature=q;},platform:function(){var q=navigator.userAgent.toLowerCase();if(q.indexOf("windows")!=-1||q.indexOf("win32")!=-1){return"windows";}else{if(q.indexOf("macintosh")!=-1){return"mac";}else{return false;}}}(),browser:function(){var q=navigator.userAgent.toLowerCase();if(q.indexOf("opera")!=-1){return"opera";}else{if(q.indexOf("msie 7")!=-1){return"ie7";}else{if(q.indexOf("msie")!=-1){return"ie";}else{if(q.indexOf("safari")!=-1){return"safari";}else{if(q.indexOf("gecko")!=-1){return"gecko";}else{return false;}}}}}}(),isSecure:function(){if(window.location.href.toLowerCase().indexOf("https")===0){return true;}else{return false;}}(),initDefaultConfig:function(){this.cfg.addProperty(j.VISIBLE.key,{handler:this.configVisible,value:j.VISIBLE.value,validator:j.VISIBLE.validator});this.cfg.addProperty(j.EFFECT.key,{handler:this.configEffect,suppressEvent:j.EFFECT.suppressEvent,supercedes:j.EFFECT.supercedes});this.cfg.addProperty(j.MONITOR_RESIZE.key,{handler:this.configMonitorResize,value:j.MONITOR_RESIZE.value});this.cfg.addProperty(j.APPEND_TO_DOCUMENT_BODY.key,{value:j.APPEND_TO_DOCUMENT_BODY.value});},init:function(v,u){var s,w;this.initEvents();this.beforeInitEvent.fire(g);this.cfg=new d(this);if(this.isSecure){this.imageRoot=g.IMG_ROOT_SSL;}if(typeof v=="string"){s=v;v=document.getElementById(v);if(!v){v=(l()).cloneNode(false);v.id=s;}}this.id=f.generateId(v);this.element=v;w=this.element.firstChild;if(w){var r=false,q=false,t=false;do{if(1==w.nodeType){if(!r&&f.hasClass(w,g.CSS_HEADER)){this.header=w;r=true;}else{if(!q&&f.hasClass(w,g.CSS_BODY)){this.body=w;q=true;}else{if(!t&&f.hasClass(w,g.CSS_FOOTER)){this.footer=w;t=true;}}}}}while((w=w.nextSibling));}this.initDefaultConfig();f.addClass(this.element,g.CSS_MODULE);if(u){this.cfg.applyConfig(u,true);}if(!d.alreadySubscribed(this.renderEvent,this.cfg.fireQueue,this.cfg)){this.renderEvent.subscribe(this.cfg.fireQueue,this.cfg,true);}this.initEvent.fire(g);},initResizeMonitor:function(){var r=(i.gecko&&this.platform=="windows");if(r){var q=this;setTimeout(function(){q._initResizeMonitor();},0);}else{this._initResizeMonitor();}},_initResizeMonitor:function(){var q,s,u;function w(){g.textResizeEvent.fire();}if(!i.opera){s=f.get("_yuiResizeMonitor");var v=this._supportsCWResize();if(!s){s=document.createElement("iframe");if(this.isSecure&&g.RESIZE_MONITOR_SECURE_URL&&i.ie){s.src=g.RESIZE_MONITOR_SECURE_URL;}if(!v){u=["<html><head><script ",'type="text/javascript">',"window.onresize=function(){window.parent.","YAHOO.widget.Module.textResizeEvent.","fire();};<","/script></head>","<body></body></html>"].join("");s.src="data:text/html;charset=utf-8,"+encodeURIComponent(u);}s.id="_yuiResizeMonitor";s.title="Text Resize Monitor";s.tabIndex=-1;s.setAttribute("role","presentation");s.style.position="absolute";s.style.visibility="hidden";var r=document.body,t=r.firstChild;if(t){r.insertBefore(s,t);}else{r.appendChild(s);}s.style.backgroundColor="transparent";s.style.borderWidth="0";s.style.width="2em";s.style.height="2em";s.style.left="0";s.style.top=(-1*(s.offsetHeight+g.RESIZE_MONITOR_BUFFER))+"px";s.style.visibility="visible";if(i.webkit){q=s.contentWindow.document;q.open();q.close();}}if(s&&s.contentWindow){g.textResizeEvent.subscribe(this.onDomResize,this,true);if(!g.textResizeInitialized){if(v){if(!n.on(s.contentWindow,"resize",w)){n.on(s,"resize",w);}}g.textResizeInitialized=true;}this.resizeMonitor=s;}}},_supportsCWResize:function(){var q=true;if(i.gecko&&i.gecko<=1.8){q=false;}return q;},onDomResize:function(s,r){var q=-1*(this.resizeMonitor.offsetHeight+g.RESIZE_MONITOR_BUFFER);this.resizeMonitor.style.top=q+"px";this.resizeMonitor.style.left="0";},setHeader:function(r){var q=this.header||(this.header=k());if(r.nodeName){q.innerHTML="";q.appendChild(r);}else{q.innerHTML=r;}if(this._rendered){this._renderHeader();}this.changeHeaderEvent.fire(r);this.changeContentEvent.fire();},appendToHeader:function(r){var q=this.header||(this.header=k());q.appendChild(r);this.changeHeaderEvent.fire(r);this.changeContentEvent.fire();},setBody:function(r){var q=this.body||(this.body=b());if(r.nodeName){q.innerHTML="";q.appendChild(r);}else{q.innerHTML=r;}if(this._rendered){this._renderBody();}this.changeBodyEvent.fire(r);this.changeContentEvent.fire();},appendToBody:function(r){var q=this.body||(this.body=b());q.appendChild(r);this.changeBodyEvent.fire(r);this.changeContentEvent.fire();},setFooter:function(r){var q=this.footer||(this.footer=c());if(r.nodeName){q.innerHTML="";q.appendChild(r);}else{q.innerHTML=r;}if(this._rendered){this._renderFooter();}this.changeFooterEvent.fire(r);this.changeContentEvent.fire();},appendToFooter:function(r){var q=this.footer||(this.footer=c());q.appendChild(r);this.changeFooterEvent.fire(r);this.changeContentEvent.fire();},render:function(s,q){var t=this;function r(u){if(typeof u=="string"){u=document.getElementById(u);
+}if(u){t._addToParent(u,t.element);t.appendEvent.fire();}}this.beforeRenderEvent.fire();if(!q){q=this.element;}if(s){r(s);}else{if(!f.inDocument(this.element)){return false;}}this._renderHeader(q);this._renderBody(q);this._renderFooter(q);this._rendered=true;this.renderEvent.fire();return true;},_renderHeader:function(q){q=q||this.element;if(this.header&&!f.inDocument(this.header)){var r=q.firstChild;if(r){q.insertBefore(this.header,r);}else{q.appendChild(this.header);}}},_renderBody:function(q){q=q||this.element;if(this.body&&!f.inDocument(this.body)){if(this.footer&&f.isAncestor(q,this.footer)){q.insertBefore(this.body,this.footer);}else{q.appendChild(this.body);}}},_renderFooter:function(q){q=q||this.element;if(this.footer&&!f.inDocument(this.footer)){q.appendChild(this.footer);}},destroy:function(q){var r,s=!(q);if(this.element){n.purgeElement(this.element,s);r=this.element.parentNode;}if(r){r.removeChild(this.element);}this.element=null;this.header=null;this.body=null;this.footer=null;g.textResizeEvent.unsubscribe(this.onDomResize,this);this.cfg.destroy();this.cfg=null;this.destroyEvent.fire();},show:function(){this.cfg.setProperty("visible",true);},hide:function(){this.cfg.setProperty("visible",false);},configVisible:function(r,q,s){var t=q[0];if(t){if(this.beforeShowEvent.fire()){f.setStyle(this.element,"display","block");this.showEvent.fire();}}else{if(this.beforeHideEvent.fire()){f.setStyle(this.element,"display","none");this.hideEvent.fire();}}},configEffect:function(r,q,s){this._cachedEffects=(this.cacheEffects)?this._createEffects(q[0]):null;},cacheEffects:true,_createEffects:function(t){var q=null,u,r,s;if(t){if(t instanceof Array){q=[];u=t.length;for(r=0;r<u;r++){s=t[r];if(s.effect){q[q.length]=s.effect(this,s.duration);}}}else{if(t.effect){q=[t.effect(this,t.duration)];}}}return q;},configMonitorResize:function(s,r,t){var q=r[0];if(q){this.initResizeMonitor();}else{g.textResizeEvent.unsubscribe(this.onDomResize,this,true);this.resizeMonitor=null;}},_addToParent:function(q,r){if(!this.cfg.getProperty("appendtodocumentbody")&&q===document.body&&q.firstChild){q.insertBefore(r,q.firstChild);}else{q.appendChild(r);}},toString:function(){return"Module "+this.id;}};YAHOO.lang.augmentProto(g,YAHOO.util.EventProvider);}());(function(){YAHOO.widget.Overlay=function(p,o){YAHOO.widget.Overlay.superclass.constructor.call(this,p,o);};var i=YAHOO.lang,m=YAHOO.util.CustomEvent,g=YAHOO.widget.Module,n=YAHOO.util.Event,f=YAHOO.util.Dom,d=YAHOO.util.Config,k=YAHOO.env.ua,b=YAHOO.widget.Overlay,h="subscribe",e="unsubscribe",c="contained",j,a={"BEFORE_MOVE":"beforeMove","MOVE":"move"},l={"X":{key:"x",validator:i.isNumber,suppressEvent:true,supercedes:["iframe"]},"Y":{key:"y",validator:i.isNumber,suppressEvent:true,supercedes:["iframe"]},"XY":{key:"xy",suppressEvent:true,supercedes:["iframe"]},"CONTEXT":{key:"context",suppressEvent:true,supercedes:["iframe"]},"FIXED_CENTER":{key:"fixedcenter",value:false,supercedes:["iframe","visible"]},"WIDTH":{key:"width",suppressEvent:true,supercedes:["context","fixedcenter","iframe"]},"HEIGHT":{key:"height",suppressEvent:true,supercedes:["context","fixedcenter","iframe"]},"AUTO_FILL_HEIGHT":{key:"autofillheight",supercedes:["height"],value:"body"},"ZINDEX":{key:"zindex",value:null},"CONSTRAIN_TO_VIEWPORT":{key:"constraintoviewport",value:false,validator:i.isBoolean,supercedes:["iframe","x","y","xy"]},"IFRAME":{key:"iframe",value:(k.ie==6?true:false),validator:i.isBoolean,supercedes:["zindex"]},"PREVENT_CONTEXT_OVERLAP":{key:"preventcontextoverlap",value:false,validator:i.isBoolean,supercedes:["constraintoviewport"]}};b.IFRAME_SRC="javascript:false;";b.IFRAME_OFFSET=3;b.VIEWPORT_OFFSET=10;b.TOP_LEFT="tl";b.TOP_RIGHT="tr";b.BOTTOM_LEFT="bl";b.BOTTOM_RIGHT="br";b.PREVENT_OVERLAP_X={"tltr":true,"blbr":true,"brbl":true,"trtl":true};b.PREVENT_OVERLAP_Y={"trbr":true,"tlbl":true,"bltl":true,"brtr":true};b.CSS_OVERLAY="yui-overlay";b.CSS_HIDDEN="yui-overlay-hidden";b.CSS_IFRAME="yui-overlay-iframe";b.STD_MOD_RE=/^\s*?(body|footer|header)\s*?$/i;b.windowScrollEvent=new m("windowScroll");b.windowResizeEvent=new m("windowResize");b.windowScrollHandler=function(p){var o=n.getTarget(p);if(!o||o===window||o===window.document){if(k.ie){if(!window.scrollEnd){window.scrollEnd=-1;}clearTimeout(window.scrollEnd);window.scrollEnd=setTimeout(function(){b.windowScrollEvent.fire();},1);}else{b.windowScrollEvent.fire();}}};b.windowResizeHandler=function(o){if(k.ie){if(!window.resizeEnd){window.resizeEnd=-1;}clearTimeout(window.resizeEnd);window.resizeEnd=setTimeout(function(){b.windowResizeEvent.fire();},100);}else{b.windowResizeEvent.fire();}};b._initialized=null;if(b._initialized===null){n.on(window,"scroll",b.windowScrollHandler);n.on(window,"resize",b.windowResizeHandler);b._initialized=true;}b._TRIGGER_MAP={"windowScroll":b.windowScrollEvent,"windowResize":b.windowResizeEvent,"textResize":g.textResizeEvent};YAHOO.extend(b,g,{CONTEXT_TRIGGERS:[],init:function(p,o){b.superclass.init.call(this,p);this.beforeInitEvent.fire(b);f.addClass(this.element,b.CSS_OVERLAY);if(o){this.cfg.applyConfig(o,true);}if(this.platform=="mac"&&k.gecko){if(!d.alreadySubscribed(this.showEvent,this.showMacGeckoScrollbars,this)){this.showEvent.subscribe(this.showMacGeckoScrollbars,this,true);}if(!d.alreadySubscribed(this.hideEvent,this.hideMacGeckoScrollbars,this)){this.hideEvent.subscribe(this.hideMacGeckoScrollbars,this,true);}}this.initEvent.fire(b);},initEvents:function(){b.superclass.initEvents.call(this);var o=m.LIST;this.beforeMoveEvent=this.createEvent(a.BEFORE_MOVE);this.beforeMoveEvent.signature=o;this.moveEvent=this.createEvent(a.MOVE);this.moveEvent.signature=o;},initDefaultConfig:function(){b.superclass.initDefaultConfig.call(this);var o=this.cfg;o.addProperty(l.X.key,{handler:this.configX,validator:l.X.validator,suppressEvent:l.X.suppressEvent,supercedes:l.X.supercedes});o.addProperty(l.Y.key,{handler:this.configY,validator:l.Y.validator,suppressEvent:l.Y.suppressEvent,supercedes:l.Y.supercedes});
+o.addProperty(l.XY.key,{handler:this.configXY,suppressEvent:l.XY.suppressEvent,supercedes:l.XY.supercedes});o.addProperty(l.CONTEXT.key,{handler:this.configContext,suppressEvent:l.CONTEXT.suppressEvent,supercedes:l.CONTEXT.supercedes});o.addProperty(l.FIXED_CENTER.key,{handler:this.configFixedCenter,value:l.FIXED_CENTER.value,validator:l.FIXED_CENTER.validator,supercedes:l.FIXED_CENTER.supercedes});o.addProperty(l.WIDTH.key,{handler:this.configWidth,suppressEvent:l.WIDTH.suppressEvent,supercedes:l.WIDTH.supercedes});o.addProperty(l.HEIGHT.key,{handler:this.configHeight,suppressEvent:l.HEIGHT.suppressEvent,supercedes:l.HEIGHT.supercedes});o.addProperty(l.AUTO_FILL_HEIGHT.key,{handler:this.configAutoFillHeight,value:l.AUTO_FILL_HEIGHT.value,validator:this._validateAutoFill,supercedes:l.AUTO_FILL_HEIGHT.supercedes});o.addProperty(l.ZINDEX.key,{handler:this.configzIndex,value:l.ZINDEX.value});o.addProperty(l.CONSTRAIN_TO_VIEWPORT.key,{handler:this.configConstrainToViewport,value:l.CONSTRAIN_TO_VIEWPORT.value,validator:l.CONSTRAIN_TO_VIEWPORT.validator,supercedes:l.CONSTRAIN_TO_VIEWPORT.supercedes});o.addProperty(l.IFRAME.key,{handler:this.configIframe,value:l.IFRAME.value,validator:l.IFRAME.validator,supercedes:l.IFRAME.supercedes});o.addProperty(l.PREVENT_CONTEXT_OVERLAP.key,{value:l.PREVENT_CONTEXT_OVERLAP.value,validator:l.PREVENT_CONTEXT_OVERLAP.validator,supercedes:l.PREVENT_CONTEXT_OVERLAP.supercedes});},moveTo:function(o,p){this.cfg.setProperty("xy",[o,p]);},hideMacGeckoScrollbars:function(){f.replaceClass(this.element,"show-scrollbars","hide-scrollbars");},showMacGeckoScrollbars:function(){f.replaceClass(this.element,"hide-scrollbars","show-scrollbars");},_setDomVisibility:function(o){f.setStyle(this.element,"visibility",(o)?"visible":"hidden");var p=b.CSS_HIDDEN;if(o){f.removeClass(this.element,p);}else{f.addClass(this.element,p);}},configVisible:function(x,w,t){var p=w[0],B=f.getStyle(this.element,"visibility"),o=this._cachedEffects||this._createEffects(this.cfg.getProperty("effect")),A=(this.platform=="mac"&&k.gecko),y=d.alreadySubscribed,q,v,s,r,u,z;if(B=="inherit"){v=this.element.parentNode;while(v.nodeType!=9&&v.nodeType!=11){B=f.getStyle(v,"visibility");if(B!="inherit"){break;}v=v.parentNode;}if(B=="inherit"){B="visible";}}if(p){if(A){this.showMacGeckoScrollbars();}if(o){if(p){if(B!="visible"||B===""||this._fadingOut){if(this.beforeShowEvent.fire()){z=o.length;for(s=0;s<z;s++){q=o[s];if(s===0&&!y(q.animateInCompleteEvent,this.showEvent.fire,this.showEvent)){q.animateInCompleteEvent.subscribe(this.showEvent.fire,this.showEvent,true);}q.animateIn();}}}}}else{if(B!="visible"||B===""){if(this.beforeShowEvent.fire()){this._setDomVisibility(true);this.cfg.refireEvent("iframe");this.showEvent.fire();}}else{this._setDomVisibility(true);}}}else{if(A){this.hideMacGeckoScrollbars();}if(o){if(B=="visible"||this._fadingIn){if(this.beforeHideEvent.fire()){z=o.length;for(r=0;r<z;r++){u=o[r];if(r===0&&!y(u.animateOutCompleteEvent,this.hideEvent.fire,this.hideEvent)){u.animateOutCompleteEvent.subscribe(this.hideEvent.fire,this.hideEvent,true);}u.animateOut();}}}else{if(B===""){this._setDomVisibility(false);}}}else{if(B=="visible"||B===""){if(this.beforeHideEvent.fire()){this._setDomVisibility(false);this.hideEvent.fire();}}else{this._setDomVisibility(false);}}}},doCenterOnDOMEvent:function(){var o=this.cfg,p=o.getProperty("fixedcenter");if(o.getProperty("visible")){if(p&&(p!==c||this.fitsInViewport())){this.center();}}},fitsInViewport:function(){var s=b.VIEWPORT_OFFSET,q=this.element,t=q.offsetWidth,r=q.offsetHeight,o=f.getViewportWidth(),p=f.getViewportHeight();return((t+s<o)&&(r+s<p));},configFixedCenter:function(s,q,t){var u=q[0],p=d.alreadySubscribed,r=b.windowResizeEvent,o=b.windowScrollEvent;if(u){this.center();if(!p(this.beforeShowEvent,this.center)){this.beforeShowEvent.subscribe(this.center);}if(!p(r,this.doCenterOnDOMEvent,this)){r.subscribe(this.doCenterOnDOMEvent,this,true);}if(!p(o,this.doCenterOnDOMEvent,this)){o.subscribe(this.doCenterOnDOMEvent,this,true);}}else{this.beforeShowEvent.unsubscribe(this.center);r.unsubscribe(this.doCenterOnDOMEvent,this);o.unsubscribe(this.doCenterOnDOMEvent,this);}},configHeight:function(r,p,s){var o=p[0],q=this.element;f.setStyle(q,"height",o);this.cfg.refireEvent("iframe");},configAutoFillHeight:function(t,s,p){var v=s[0],q=this.cfg,u="autofillheight",w="height",r=q.getProperty(u),o=this._autoFillOnHeightChange;q.unsubscribeFromConfigEvent(w,o);g.textResizeEvent.unsubscribe(o);this.changeContentEvent.unsubscribe(o);if(r&&v!==r&&this[r]){f.setStyle(this[r],w,"");}if(v){v=i.trim(v.toLowerCase());q.subscribeToConfigEvent(w,o,this[v],this);g.textResizeEvent.subscribe(o,this[v],this);this.changeContentEvent.subscribe(o,this[v],this);q.setProperty(u,v,true);}},configWidth:function(r,o,s){var q=o[0],p=this.element;f.setStyle(p,"width",q);this.cfg.refireEvent("iframe");},configzIndex:function(q,o,r){var s=o[0],p=this.element;if(!s){s=f.getStyle(p,"zIndex");if(!s||isNaN(s)){s=0;}}if(this.iframe||this.cfg.getProperty("iframe")===true){if(s<=0){s=1;}}f.setStyle(p,"zIndex",s);this.cfg.setProperty("zIndex",s,true);if(this.iframe){this.stackIframe();}},configXY:function(q,p,r){var t=p[0],o=t[0],s=t[1];this.cfg.setProperty("x",o);this.cfg.setProperty("y",s);this.beforeMoveEvent.fire([o,s]);o=this.cfg.getProperty("x");s=this.cfg.getProperty("y");this.cfg.refireEvent("iframe");this.moveEvent.fire([o,s]);},configX:function(q,p,r){var o=p[0],s=this.cfg.getProperty("y");this.cfg.setProperty("x",o,true);this.cfg.setProperty("y",s,true);this.beforeMoveEvent.fire([o,s]);o=this.cfg.getProperty("x");s=this.cfg.getProperty("y");f.setX(this.element,o,true);this.cfg.setProperty("xy",[o,s],true);this.cfg.refireEvent("iframe");this.moveEvent.fire([o,s]);},configY:function(q,p,r){var o=this.cfg.getProperty("x"),s=p[0];this.cfg.setProperty("x",o,true);this.cfg.setProperty("y",s,true);this.beforeMoveEvent.fire([o,s]);o=this.cfg.getProperty("x");s=this.cfg.getProperty("y");f.setY(this.element,s,true);
+this.cfg.setProperty("xy",[o,s],true);this.cfg.refireEvent("iframe");this.moveEvent.fire([o,s]);},showIframe:function(){var p=this.iframe,o;if(p){o=this.element.parentNode;if(o!=p.parentNode){this._addToParent(o,p);}p.style.display="block";}},hideIframe:function(){if(this.iframe){this.iframe.style.display="none";}},syncIframe:function(){var o=this.iframe,q=this.element,s=b.IFRAME_OFFSET,p=(s*2),r;if(o){o.style.width=(q.offsetWidth+p+"px");o.style.height=(q.offsetHeight+p+"px");r=this.cfg.getProperty("xy");if(!i.isArray(r)||(isNaN(r[0])||isNaN(r[1]))){this.syncPosition();r=this.cfg.getProperty("xy");}f.setXY(o,[(r[0]-s),(r[1]-s)]);}},stackIframe:function(){if(this.iframe){var o=f.getStyle(this.element,"zIndex");if(!YAHOO.lang.isUndefined(o)&&!isNaN(o)){f.setStyle(this.iframe,"zIndex",(o-1));}}},configIframe:function(r,q,s){var o=q[0];function t(){var v=this.iframe,w=this.element,x;if(!v){if(!j){j=document.createElement("iframe");if(this.isSecure){j.src=b.IFRAME_SRC;}if(k.ie){j.style.filter="alpha(opacity=0)";j.frameBorder=0;}else{j.style.opacity="0";}j.style.position="absolute";j.style.border="none";j.style.margin="0";j.style.padding="0";j.style.display="none";j.tabIndex=-1;j.className=b.CSS_IFRAME;}v=j.cloneNode(false);v.id=this.id+"_f";x=w.parentNode;var u=x||document.body;this._addToParent(u,v);this.iframe=v;}this.showIframe();this.syncIframe();this.stackIframe();if(!this._hasIframeEventListeners){this.showEvent.subscribe(this.showIframe);this.hideEvent.subscribe(this.hideIframe);this.changeContentEvent.subscribe(this.syncIframe);this._hasIframeEventListeners=true;}}function p(){t.call(this);this.beforeShowEvent.unsubscribe(p);this._iframeDeferred=false;}if(o){if(this.cfg.getProperty("visible")){t.call(this);}else{if(!this._iframeDeferred){this.beforeShowEvent.subscribe(p);this._iframeDeferred=true;}}}else{this.hideIframe();if(this._hasIframeEventListeners){this.showEvent.unsubscribe(this.showIframe);this.hideEvent.unsubscribe(this.hideIframe);this.changeContentEvent.unsubscribe(this.syncIframe);this._hasIframeEventListeners=false;}}},_primeXYFromDOM:function(){if(YAHOO.lang.isUndefined(this.cfg.getProperty("xy"))){this.syncPosition();this.cfg.refireEvent("xy");this.beforeShowEvent.unsubscribe(this._primeXYFromDOM);}},configConstrainToViewport:function(p,o,q){var r=o[0];if(r){if(!d.alreadySubscribed(this.beforeMoveEvent,this.enforceConstraints,this)){this.beforeMoveEvent.subscribe(this.enforceConstraints,this,true);}if(!d.alreadySubscribed(this.beforeShowEvent,this._primeXYFromDOM)){this.beforeShowEvent.subscribe(this._primeXYFromDOM);}}else{this.beforeShowEvent.unsubscribe(this._primeXYFromDOM);this.beforeMoveEvent.unsubscribe(this.enforceConstraints,this);}},configContext:function(u,t,q){var x=t[0],r,o,v,s,p,w=this.CONTEXT_TRIGGERS;if(x){r=x[0];o=x[1];v=x[2];s=x[3];p=x[4];if(w&&w.length>0){s=(s||[]).concat(w);}if(r){if(typeof r=="string"){this.cfg.setProperty("context",[document.getElementById(r),o,v,s,p],true);}if(o&&v){this.align(o,v,p);}if(this._contextTriggers){this._processTriggers(this._contextTriggers,e,this._alignOnTrigger);}if(s){this._processTriggers(s,h,this._alignOnTrigger);this._contextTriggers=s;}}}},_alignOnTrigger:function(p,o){this.align();},_findTriggerCE:function(o){var p=null;if(o instanceof m){p=o;}else{if(b._TRIGGER_MAP[o]){p=b._TRIGGER_MAP[o];}}return p;},_processTriggers:function(s,v,r){var q,u;for(var p=0,o=s.length;p<o;++p){q=s[p];u=this._findTriggerCE(q);if(u){u[v](r,this,true);}else{this[v](q,r);}}},align:function(p,w,s){var v=this.cfg.getProperty("context"),t=this,o,q,u;function r(z,A){var y=null,x=null;switch(p){case b.TOP_LEFT:y=A;x=z;break;case b.TOP_RIGHT:y=A-q.offsetWidth;x=z;break;case b.BOTTOM_LEFT:y=A;x=z-q.offsetHeight;break;case b.BOTTOM_RIGHT:y=A-q.offsetWidth;x=z-q.offsetHeight;break;}if(y!==null&&x!==null){if(s){y+=s[0];x+=s[1];}t.moveTo(y,x);}}if(v){o=v[0];q=this.element;t=this;if(!p){p=v[1];}if(!w){w=v[2];}if(!s&&v[4]){s=v[4];}if(q&&o){u=f.getRegion(o);switch(w){case b.TOP_LEFT:r(u.top,u.left);break;case b.TOP_RIGHT:r(u.top,u.right);break;case b.BOTTOM_LEFT:r(u.bottom,u.left);break;case b.BOTTOM_RIGHT:r(u.bottom,u.right);break;}}}},enforceConstraints:function(p,o,q){var s=o[0];var r=this.getConstrainedXY(s[0],s[1]);this.cfg.setProperty("x",r[0],true);this.cfg.setProperty("y",r[1],true);this.cfg.setProperty("xy",r,true);},_getConstrainedPos:function(y,p){var t=this.element,r=b.VIEWPORT_OFFSET,A=(y=="x"),z=(A)?t.offsetWidth:t.offsetHeight,s=(A)?f.getViewportWidth():f.getViewportHeight(),D=(A)?f.getDocumentScrollLeft():f.getDocumentScrollTop(),C=(A)?b.PREVENT_OVERLAP_X:b.PREVENT_OVERLAP_Y,o=this.cfg.getProperty("context"),u=(z+r<s),w=this.cfg.getProperty("preventcontextoverlap")&&o&&C[(o[1]+o[2])],v=D+r,B=D+s-z-r,q=p;if(p<v||p>B){if(w){q=this._preventOverlap(y,o[0],z,s,D);}else{if(u){if(p<v){q=v;}else{if(p>B){q=B;}}}else{q=v;}}}return q;},_preventOverlap:function(y,w,z,u,C){var A=(y=="x"),t=b.VIEWPORT_OFFSET,s=this,q=((A)?f.getX(w):f.getY(w))-C,o=(A)?w.offsetWidth:w.offsetHeight,p=q-t,r=(u-(q+o))-t,D=false,v=function(){var x;if((s.cfg.getProperty(y)-C)>q){x=(q-z);}else{x=(q+o);}s.cfg.setProperty(y,(x+C),true);return x;},B=function(){var E=((s.cfg.getProperty(y)-C)>q)?r:p,x;if(z>E){if(D){v();}else{v();D=true;x=B();}}return x;};B();return this.cfg.getProperty(y);},getConstrainedX:function(o){return this._getConstrainedPos("x",o);},getConstrainedY:function(o){return this._getConstrainedPos("y",o);},getConstrainedXY:function(o,p){return[this.getConstrainedX(o),this.getConstrainedY(p)];},center:function(){var r=b.VIEWPORT_OFFSET,s=this.element.offsetWidth,q=this.element.offsetHeight,p=f.getViewportWidth(),t=f.getViewportHeight(),o,u;if(s<p){o=(p/2)-(s/2)+f.getDocumentScrollLeft();}else{o=r+f.getDocumentScrollLeft();}if(q<t){u=(t/2)-(q/2)+f.getDocumentScrollTop();}else{u=r+f.getDocumentScrollTop();}this.cfg.setProperty("xy",[parseInt(o,10),parseInt(u,10)]);this.cfg.refireEvent("iframe");if(k.webkit){this.forceContainerRedraw();}},syncPosition:function(){var o=f.getXY(this.element);
+this.cfg.setProperty("x",o[0],true);this.cfg.setProperty("y",o[1],true);this.cfg.setProperty("xy",o,true);},onDomResize:function(q,p){var o=this;b.superclass.onDomResize.call(this,q,p);setTimeout(function(){o.syncPosition();o.cfg.refireEvent("iframe");o.cfg.refireEvent("context");},0);},_getComputedHeight:(function(){if(document.defaultView&&document.defaultView.getComputedStyle){return function(p){var o=null;if(p.ownerDocument&&p.ownerDocument.defaultView){var q=p.ownerDocument.defaultView.getComputedStyle(p,"");if(q){o=parseInt(q.height,10);}}return(i.isNumber(o))?o:null;};}else{return function(p){var o=null;if(p.style.pixelHeight){o=p.style.pixelHeight;}return(i.isNumber(o))?o:null;};}})(),_validateAutoFillHeight:function(o){return(!o)||(i.isString(o)&&b.STD_MOD_RE.test(o));},_autoFillOnHeightChange:function(r,p,q){var o=this.cfg.getProperty("height");if((o&&o!=="auto")||(o===0)){this.fillHeight(q);}},_getPreciseHeight:function(p){var o=p.offsetHeight;if(p.getBoundingClientRect){var q=p.getBoundingClientRect();o=q.bottom-q.top;}return o;},fillHeight:function(r){if(r){var p=this.innerElement||this.element,o=[this.header,this.body,this.footer],v,w=0,x=0,t=0,q=false;for(var u=0,s=o.length;u<s;u++){v=o[u];if(v){if(r!==v){x+=this._getPreciseHeight(v);}else{q=true;}}}if(q){if(k.ie||k.opera){f.setStyle(r,"height",0+"px");}w=this._getComputedHeight(p);if(w===null){f.addClass(p,"yui-override-padding");w=p.clientHeight;f.removeClass(p,"yui-override-padding");}t=Math.max(w-x,0);f.setStyle(r,"height",t+"px");if(r.offsetHeight!=t){t=Math.max(t-(r.offsetHeight-t),0);}f.setStyle(r,"height",t+"px");}}},bringToTop:function(){var s=[],r=this.element;function v(z,y){var B=f.getStyle(z,"zIndex"),A=f.getStyle(y,"zIndex"),x=(!B||isNaN(B))?0:parseInt(B,10),w=(!A||isNaN(A))?0:parseInt(A,10);if(x>w){return -1;}else{if(x<w){return 1;}else{return 0;}}}function q(y){var x=f.hasClass(y,b.CSS_OVERLAY),w=YAHOO.widget.Panel;if(x&&!f.isAncestor(r,y)){if(w&&f.hasClass(y,w.CSS_PANEL)){s[s.length]=y.parentNode;}else{s[s.length]=y;}}}f.getElementsBy(q,"div",document.body);s.sort(v);var o=s[0],u;if(o){u=f.getStyle(o,"zIndex");if(!isNaN(u)){var t=false;if(o!=r){t=true;}else{if(s.length>1){var p=f.getStyle(s[1],"zIndex");if(!isNaN(p)&&(u==p)){t=true;}}}if(t){this.cfg.setProperty("zindex",(parseInt(u,10)+2));}}}},destroy:function(o){if(this.iframe){this.iframe.parentNode.removeChild(this.iframe);}this.iframe=null;b.windowResizeEvent.unsubscribe(this.doCenterOnDOMEvent,this);b.windowScrollEvent.unsubscribe(this.doCenterOnDOMEvent,this);g.textResizeEvent.unsubscribe(this._autoFillOnHeightChange);if(this._contextTriggers){this._processTriggers(this._contextTriggers,e,this._alignOnTrigger);}b.superclass.destroy.call(this,o);},forceContainerRedraw:function(){var o=this;f.addClass(o.element,"yui-force-redraw");setTimeout(function(){f.removeClass(o.element,"yui-force-redraw");},0);},toString:function(){return"Overlay "+this.id;}});}());(function(){YAHOO.widget.OverlayManager=function(g){this.init(g);};var d=YAHOO.widget.Overlay,c=YAHOO.util.Event,e=YAHOO.util.Dom,b=YAHOO.util.Config,f=YAHOO.util.CustomEvent,a=YAHOO.widget.OverlayManager;a.CSS_FOCUSED="focused";a.prototype={constructor:a,overlays:null,initDefaultConfig:function(){this.cfg.addProperty("overlays",{suppressEvent:true});this.cfg.addProperty("focusevent",{value:"mousedown"});},init:function(i){this.cfg=new b(this);this.initDefaultConfig();if(i){this.cfg.applyConfig(i,true);}this.cfg.fireQueue();var h=null;this.getActive=function(){return h;};this.focus=function(j){var k=this.find(j);if(k){k.focus();}};this.remove=function(k){var m=this.find(k),j;if(m){if(h==m){h=null;}var l=(m.element===null&&m.cfg===null)?true:false;if(!l){j=e.getStyle(m.element,"zIndex");m.cfg.setProperty("zIndex",-1000,true);}this.overlays.sort(this.compareZIndexDesc);this.overlays=this.overlays.slice(0,(this.overlays.length-1));m.hideEvent.unsubscribe(m.blur);m.destroyEvent.unsubscribe(this._onOverlayDestroy,m);m.focusEvent.unsubscribe(this._onOverlayFocusHandler,m);m.blurEvent.unsubscribe(this._onOverlayBlurHandler,m);if(!l){c.removeListener(m.element,this.cfg.getProperty("focusevent"),this._onOverlayElementFocus);m.cfg.setProperty("zIndex",j,true);m.cfg.setProperty("manager",null);}if(m.focusEvent._managed){m.focusEvent=null;}if(m.blurEvent._managed){m.blurEvent=null;}if(m.focus._managed){m.focus=null;}if(m.blur._managed){m.blur=null;}}};this.blurAll=function(){var k=this.overlays.length,j;if(k>0){j=k-1;do{this.overlays[j].blur();}while(j--);}};this._manageBlur=function(j){var k=false;if(h==j){e.removeClass(h.element,a.CSS_FOCUSED);h=null;k=true;}return k;};this._manageFocus=function(j){var k=false;if(h!=j){if(h){h.blur();}h=j;this.bringToTop(h);e.addClass(h.element,a.CSS_FOCUSED);k=true;}return k;};var g=this.cfg.getProperty("overlays");if(!this.overlays){this.overlays=[];}if(g){this.register(g);this.overlays.sort(this.compareZIndexDesc);}},_onOverlayElementFocus:function(i){var g=c.getTarget(i),h=this.close;if(h&&(g==h||e.isAncestor(h,g))){this.blur();}else{this.focus();}},_onOverlayDestroy:function(h,g,i){this.remove(i);},_onOverlayFocusHandler:function(h,g,i){this._manageFocus(i);},_onOverlayBlurHandler:function(h,g,i){this._manageBlur(i);},_bindFocus:function(g){var h=this;if(!g.focusEvent){g.focusEvent=g.createEvent("focus");g.focusEvent.signature=f.LIST;g.focusEvent._managed=true;}else{g.focusEvent.subscribe(h._onOverlayFocusHandler,g,h);}if(!g.focus){c.on(g.element,h.cfg.getProperty("focusevent"),h._onOverlayElementFocus,null,g);g.focus=function(){if(h._manageFocus(this)){if(this.cfg.getProperty("visible")&&this.focusFirst){this.focusFirst();}this.focusEvent.fire();}};g.focus._managed=true;}},_bindBlur:function(g){var h=this;if(!g.blurEvent){g.blurEvent=g.createEvent("blur");g.blurEvent.signature=f.LIST;g.focusEvent._managed=true;}else{g.blurEvent.subscribe(h._onOverlayBlurHandler,g,h);}if(!g.blur){g.blur=function(){if(h._manageBlur(this)){this.blurEvent.fire();}};g.blur._managed=true;}g.hideEvent.subscribe(g.blur);
+},_bindDestroy:function(g){var h=this;g.destroyEvent.subscribe(h._onOverlayDestroy,g,h);},_syncZIndex:function(g){var h=e.getStyle(g.element,"zIndex");if(!isNaN(h)){g.cfg.setProperty("zIndex",parseInt(h,10));}else{g.cfg.setProperty("zIndex",0);}},register:function(g){var k=false,h,j;if(g instanceof d){g.cfg.addProperty("manager",{value:this});this._bindFocus(g);this._bindBlur(g);this._bindDestroy(g);this._syncZIndex(g);this.overlays.push(g);this.bringToTop(g);k=true;}else{if(g instanceof Array){for(h=0,j=g.length;h<j;h++){k=this.register(g[h])||k;}}}return k;},bringToTop:function(m){var i=this.find(m),l,g,j;if(i){j=this.overlays;j.sort(this.compareZIndexDesc);g=j[0];if(g){l=e.getStyle(g.element,"zIndex");if(!isNaN(l)){var k=false;if(g!==i){k=true;}else{if(j.length>1){var h=e.getStyle(j[1].element,"zIndex");if(!isNaN(h)&&(l==h)){k=true;}}}if(k){i.cfg.setProperty("zindex",(parseInt(l,10)+2));}}j.sort(this.compareZIndexDesc);}}},find:function(g){var l=g instanceof d,j=this.overlays,p=j.length,k=null,m,h;if(l||typeof g=="string"){for(h=p-1;h>=0;h--){m=j[h];if((l&&(m===g))||(m.id==g)){k=m;break;}}}return k;},compareZIndexDesc:function(j,i){var h=(j.cfg)?j.cfg.getProperty("zIndex"):null,g=(i.cfg)?i.cfg.getProperty("zIndex"):null;if(h===null&&g===null){return 0;}else{if(h===null){return 1;}else{if(g===null){return -1;}else{if(h>g){return -1;}else{if(h<g){return 1;}else{return 0;}}}}}},showAll:function(){var h=this.overlays,j=h.length,g;for(g=j-1;g>=0;g--){h[g].show();}},hideAll:function(){var h=this.overlays,j=h.length,g;for(g=j-1;g>=0;g--){h[g].hide();}},toString:function(){return"OverlayManager";}};}());(function(){YAHOO.widget.ContainerEffect=function(e,h,g,d,f){if(!f){f=YAHOO.util.Anim;}this.overlay=e;this.attrIn=h;this.attrOut=g;this.targetElement=d||e.element;this.animClass=f;};var b=YAHOO.util.Dom,c=YAHOO.util.CustomEvent,a=YAHOO.widget.ContainerEffect;a.FADE=function(d,f){var g=YAHOO.util.Easing,i={attributes:{opacity:{from:0,to:1}},duration:f,method:g.easeIn},e={attributes:{opacity:{to:0}},duration:f,method:g.easeOut},h=new a(d,i,e,d.element);h.handleUnderlayStart=function(){var k=this.overlay.underlay;if(k&&YAHOO.env.ua.ie){var j=(k.filters&&k.filters.length>0);if(j){b.addClass(d.element,"yui-effect-fade");}}};h.handleUnderlayComplete=function(){var j=this.overlay.underlay;if(j&&YAHOO.env.ua.ie){b.removeClass(d.element,"yui-effect-fade");}};h.handleStartAnimateIn=function(k,j,l){l.overlay._fadingIn=true;b.addClass(l.overlay.element,"hide-select");if(!l.overlay.underlay){l.overlay.cfg.refireEvent("underlay");}l.handleUnderlayStart();l.overlay._setDomVisibility(true);b.setStyle(l.overlay.element,"opacity",0);};h.handleCompleteAnimateIn=function(k,j,l){l.overlay._fadingIn=false;b.removeClass(l.overlay.element,"hide-select");if(l.overlay.element.style.filter){l.overlay.element.style.filter=null;}l.handleUnderlayComplete();l.overlay.cfg.refireEvent("iframe");l.animateInCompleteEvent.fire();};h.handleStartAnimateOut=function(k,j,l){l.overlay._fadingOut=true;b.addClass(l.overlay.element,"hide-select");l.handleUnderlayStart();};h.handleCompleteAnimateOut=function(k,j,l){l.overlay._fadingOut=false;b.removeClass(l.overlay.element,"hide-select");if(l.overlay.element.style.filter){l.overlay.element.style.filter=null;}l.overlay._setDomVisibility(false);b.setStyle(l.overlay.element,"opacity",1);l.handleUnderlayComplete();l.overlay.cfg.refireEvent("iframe");l.animateOutCompleteEvent.fire();};h.init();return h;};a.SLIDE=function(f,d){var i=YAHOO.util.Easing,l=f.cfg.getProperty("x")||b.getX(f.element),k=f.cfg.getProperty("y")||b.getY(f.element),m=b.getClientWidth(),h=f.element.offsetWidth,j={attributes:{points:{to:[l,k]}},duration:d,method:i.easeIn},e={attributes:{points:{to:[(m+25),k]}},duration:d,method:i.easeOut},g=new a(f,j,e,f.element,YAHOO.util.Motion);g.handleStartAnimateIn=function(o,n,p){p.overlay.element.style.left=((-25)-h)+"px";p.overlay.element.style.top=k+"px";};g.handleTweenAnimateIn=function(q,p,r){var s=b.getXY(r.overlay.element),o=s[0],n=s[1];if(b.getStyle(r.overlay.element,"visibility")=="hidden"&&o<l){r.overlay._setDomVisibility(true);}r.overlay.cfg.setProperty("xy",[o,n],true);r.overlay.cfg.refireEvent("iframe");};g.handleCompleteAnimateIn=function(o,n,p){p.overlay.cfg.setProperty("xy",[l,k],true);p.startX=l;p.startY=k;p.overlay.cfg.refireEvent("iframe");p.animateInCompleteEvent.fire();};g.handleStartAnimateOut=function(o,n,r){var p=b.getViewportWidth(),s=b.getXY(r.overlay.element),q=s[1];r.animOut.attributes.points.to=[(p+25),q];};g.handleTweenAnimateOut=function(p,o,q){var s=b.getXY(q.overlay.element),n=s[0],r=s[1];q.overlay.cfg.setProperty("xy",[n,r],true);q.overlay.cfg.refireEvent("iframe");};g.handleCompleteAnimateOut=function(o,n,p){p.overlay._setDomVisibility(false);p.overlay.cfg.setProperty("xy",[l,k]);p.animateOutCompleteEvent.fire();};g.init();return g;};a.prototype={init:function(){this.beforeAnimateInEvent=this.createEvent("beforeAnimateIn");this.beforeAnimateInEvent.signature=c.LIST;this.beforeAnimateOutEvent=this.createEvent("beforeAnimateOut");this.beforeAnimateOutEvent.signature=c.LIST;this.animateInCompleteEvent=this.createEvent("animateInComplete");this.animateInCompleteEvent.signature=c.LIST;this.animateOutCompleteEvent=this.createEvent("animateOutComplete");this.animateOutCompleteEvent.signature=c.LIST;this.animIn=new this.animClass(this.targetElement,this.attrIn.attributes,this.attrIn.duration,this.attrIn.method);this.animIn.onStart.subscribe(this.handleStartAnimateIn,this);this.animIn.onTween.subscribe(this.handleTweenAnimateIn,this);this.animIn.onComplete.subscribe(this.handleCompleteAnimateIn,this);this.animOut=new this.animClass(this.targetElement,this.attrOut.attributes,this.attrOut.duration,this.attrOut.method);this.animOut.onStart.subscribe(this.handleStartAnimateOut,this);this.animOut.onTween.subscribe(this.handleTweenAnimateOut,this);this.animOut.onComplete.subscribe(this.handleCompleteAnimateOut,this);},animateIn:function(){this._stopAnims(this.lastFrameOnStop);
+this.beforeAnimateInEvent.fire();this.animIn.animate();},animateOut:function(){this._stopAnims(this.lastFrameOnStop);this.beforeAnimateOutEvent.fire();this.animOut.animate();},lastFrameOnStop:true,_stopAnims:function(d){if(this.animOut&&this.animOut.isAnimated()){this.animOut.stop(d);}if(this.animIn&&this.animIn.isAnimated()){this.animIn.stop(d);}},handleStartAnimateIn:function(e,d,f){},handleTweenAnimateIn:function(e,d,f){},handleCompleteAnimateIn:function(e,d,f){},handleStartAnimateOut:function(e,d,f){},handleTweenAnimateOut:function(e,d,f){},handleCompleteAnimateOut:function(e,d,f){},toString:function(){var d="ContainerEffect";if(this.overlay){d+=" ["+this.overlay.toString()+"]";}return d;}};YAHOO.lang.augmentProto(a,YAHOO.util.EventProvider);})();YAHOO.register("containercore",YAHOO.widget.Module,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/cookie/cookie-min.js b/js/yui/cookie/cookie-min.js
new file mode 100644 (file)
index 0000000..290c424
--- /dev/null
+++ b/js/yui/cookie/cookie-min.js
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.namespace("util");YAHOO.util.Cookie={_createCookieString:function(B,D,C,A){var F=YAHOO.lang,E=encodeURIComponent(B)+"="+(C?encodeURIComponent(D):D);if(F.isObject(A)){if(A.expires instanceof Date){E+="; expires="+A.expires.toUTCString();}if(F.isString(A.path)&&A.path!==""){E+="; path="+A.path;}if(F.isString(A.domain)&&A.domain!==""){E+="; domain="+A.domain;}if(A.secure===true){E+="; secure";}}return E;},_createCookieHashString:function(B){var D=YAHOO.lang;if(!D.isObject(B)){throw new TypeError("Cookie._createCookieHashString(): Argument must be an object.");}var C=[];for(var A in B){if(D.hasOwnProperty(B,A)&&!D.isFunction(B[A])&&!D.isUndefined(B[A])){C.push(encodeURIComponent(A)+"="+encodeURIComponent(String(B[A])));}}return C.join("&");},_parseCookieHash:function(E){var D=E.split("&"),F=null,C={};if(E.length>0){for(var B=0,A=D.length;B<A;B++){F=D[B].split("=");C[decodeURIComponent(F[0])]=decodeURIComponent(F[1]);}}return C;},_parseCookieString:function(J,A){var K={};if(YAHOO.lang.isString(J)&&J.length>0){var B=(A===false?function(L){return L;}:decodeURIComponent);var H=J.split(/;\s/g),I=null,C=null,E=null;for(var D=0,F=H.length;D<F;D++){E=H[D].match(/([^=]+)=/i);if(E instanceof Array){try{I=decodeURIComponent(E[1]);C=B(H[D].substring(E[1].length+1));}catch(G){}}else{I=decodeURIComponent(H[D]);C="";}K[I]=C;}}return K;},exists:function(A){if(!YAHOO.lang.isString(A)||A===""){throw new TypeError("Cookie.exists(): Cookie name must be a non-empty string.");}var B=this._parseCookieString(document.cookie,true);return B.hasOwnProperty(A);},get:function(B,A){var E=YAHOO.lang,C;if(E.isFunction(A)){C=A;A={};}else{if(E.isObject(A)){C=A.converter;}else{A={};}}var D=this._parseCookieString(document.cookie,!A.raw);if(!E.isString(B)||B===""){throw new TypeError("Cookie.get(): Cookie name must be a non-empty string.");}if(E.isUndefined(D[B])){return null;}if(!E.isFunction(C)){return D[B];}else{return C(D[B]);}},getSub:function(A,C,B){var E=YAHOO.lang,D=this.getSubs(A);if(D!==null){if(!E.isString(C)||C===""){throw new TypeError("Cookie.getSub(): Subcookie name must be a non-empty string.");}if(E.isUndefined(D[C])){return null;}if(!E.isFunction(B)){return D[C];}else{return B(D[C]);}}else{return null;}},getSubs:function(B){var A=YAHOO.lang.isString;if(!A(B)||B===""){throw new TypeError("Cookie.getSubs(): Cookie name must be a non-empty string.");}var C=this._parseCookieString(document.cookie,false);if(A(C[B])){return this._parseCookieHash(C[B]);}return null;},remove:function(B,A){if(!YAHOO.lang.isString(B)||B===""){throw new TypeError("Cookie.remove(): Cookie name must be a non-empty string.");}A=YAHOO.lang.merge(A||{},{expires:new Date(0)});return this.set(B,"",A);},removeSub:function(B,E,A){var F=YAHOO.lang;A=A||{};if(!F.isString(B)||B===""){throw new TypeError("Cookie.removeSub(): Cookie name must be a non-empty string.");}if(!F.isString(E)||E===""){throw new TypeError("Cookie.removeSub(): Subcookie name must be a non-empty string.");}var D=this.getSubs(B);if(F.isObject(D)&&F.hasOwnProperty(D,E)){delete D[E];if(!A.removeIfEmpty){return this.setSubs(B,D,A);}else{for(var C in D){if(F.hasOwnProperty(D,C)&&!F.isFunction(D[C])&&!F.isUndefined(D[C])){return this.setSubs(B,D,A);}}return this.remove(B,A);}}else{return"";}},set:function(B,C,A){var E=YAHOO.lang;A=A||{};if(!E.isString(B)){throw new TypeError("Cookie.set(): Cookie name must be a string.");}if(E.isUndefined(C)){throw new TypeError("Cookie.set(): Value cannot be undefined.");}var D=this._createCookieString(B,C,!A.raw,A);document.cookie=D;return D;},setSub:function(B,D,C,A){var F=YAHOO.lang;if(!F.isString(B)||B===""){throw new TypeError("Cookie.setSub(): Cookie name must be a non-empty string.");}if(!F.isString(D)||D===""){throw new TypeError("Cookie.setSub(): Subcookie name must be a non-empty string.");}if(F.isUndefined(C)){throw new TypeError("Cookie.setSub(): Subcookie value cannot be undefined.");}var E=this.getSubs(B);if(!F.isObject(E)){E={};}E[D]=C;return this.setSubs(B,E,A);},setSubs:function(B,C,A){var E=YAHOO.lang;if(!E.isString(B)){throw new TypeError("Cookie.setSubs(): Cookie name must be a string.");}if(!E.isObject(C)){throw new TypeError("Cookie.setSubs(): Cookie value must be an object.");}var D=this._createCookieString(B,this._createCookieHashString(C),false,A);document.cookie=D;return D;}};YAHOO.register("cookie",YAHOO.util.Cookie,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/datasource/datasource-min.js b/js/yui/datasource/datasource-min.js
new file mode 100644 (file)
index 0000000..d2a3da3
--- /dev/null
+++ b/js/yui/datasource/datasource-min.js
@@ -0,0 +1,12 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){var lang=YAHOO.lang,util=YAHOO.util,Ev=util.Event;util.DataSourceBase=function(oLiveData,oConfigs){if(oLiveData===null||oLiveData===undefined){return;}this.liveData=oLiveData;this._oQueue={interval:null,conn:null,requests:[]};this.responseSchema={};if(oConfigs&&(oConfigs.constructor==Object)){for(var sConfig in oConfigs){if(sConfig){this[sConfig]=oConfigs[sConfig];}}}var maxCacheEntries=this.maxCacheEntries;if(!lang.isNumber(maxCacheEntries)||(maxCacheEntries<0)){maxCacheEntries=0;}this._aIntervals=[];this.createEvent("cacheRequestEvent");this.createEvent("cacheResponseEvent");this.createEvent("requestEvent");this.createEvent("responseEvent");this.createEvent("responseParseEvent");this.createEvent("responseCacheEvent");this.createEvent("dataErrorEvent");this.createEvent("cacheFlushEvent");var DS=util.DataSourceBase;this._sName="DataSource instance"+DS._nIndex;DS._nIndex++;};var DS=util.DataSourceBase;lang.augmentObject(DS,{TYPE_UNKNOWN:-1,TYPE_JSARRAY:0,TYPE_JSFUNCTION:1,TYPE_XHR:2,TYPE_JSON:3,TYPE_XML:4,TYPE_TEXT:5,TYPE_HTMLTABLE:6,TYPE_SCRIPTNODE:7,TYPE_LOCAL:8,ERROR_DATAINVALID:"Invalid data",ERROR_DATANULL:"Null data",_nIndex:0,_nTransactionId:0,_cloneObject:function(o){if(!lang.isValue(o)){return o;}var copy={};if(Object.prototype.toString.apply(o)==="[object RegExp]"){copy=o;}else{if(lang.isFunction(o)){copy=o;}else{if(lang.isArray(o)){var array=[];for(var i=0,len=o.length;i<len;i++){array[i]=DS._cloneObject(o[i]);}copy=array;}else{if(lang.isObject(o)){for(var x in o){if(lang.hasOwnProperty(o,x)){if(lang.isValue(o[x])&&lang.isObject(o[x])||lang.isArray(o[x])){copy[x]=DS._cloneObject(o[x]);}else{copy[x]=o[x];}}}}else{copy=o;}}}}return copy;},_getLocationValue:function(field,context){var locator=field.locator||field.key||field,xmldoc=context.ownerDocument||context,result,res,value=null;try{if(!lang.isUndefined(xmldoc.evaluate)){result=xmldoc.evaluate(locator,context,xmldoc.createNSResolver(!context.ownerDocument?context.documentElement:context.ownerDocument.documentElement),0,null);while(res=result.iterateNext()){value=res.textContent;}}else{xmldoc.setProperty("SelectionLanguage","XPath");result=context.selectNodes(locator)[0];value=result.value||result.text||null;}return value;}catch(e){}},issueCallback:function(callback,params,error,scope){if(lang.isFunction(callback)){callback.apply(scope,params);}else{if(lang.isObject(callback)){scope=callback.scope||scope||window;var callbackFunc=callback.success;if(error){callbackFunc=callback.failure;}if(callbackFunc){callbackFunc.apply(scope,params.concat([callback.argument]));}}}},parseString:function(oData){if(!lang.isValue(oData)){return null;}var string=oData+"";if(lang.isString(string)){return string;}else{return null;}},parseNumber:function(oData){if(!lang.isValue(oData)||(oData==="")){return null;}var number=oData*1;if(lang.isNumber(number)){return number;}else{return null;}},convertNumber:function(oData){return DS.parseNumber(oData);},parseDate:function(oData){var date=null;if(lang.isValue(oData)&&!(oData instanceof Date)){date=new Date(oData);}else{return oData;}if(date instanceof Date){return date;}else{return null;}},convertDate:function(oData){return DS.parseDate(oData);}});DS.Parser={string:DS.parseString,number:DS.parseNumber,date:DS.parseDate};DS.prototype={_sName:null,_aCache:null,_oQueue:null,_aIntervals:null,maxCacheEntries:0,liveData:null,dataType:DS.TYPE_UNKNOWN,responseType:DS.TYPE_UNKNOWN,responseSchema:null,useXPath:false,cloneBeforeCaching:false,toString:function(){return this._sName;},getCachedResponse:function(oRequest,oCallback,oCaller){var aCache=this._aCache;if(this.maxCacheEntries>0){if(!aCache){this._aCache=[];}else{var nCacheLength=aCache.length;if(nCacheLength>0){var oResponse=null;this.fireEvent("cacheRequestEvent",{request:oRequest,callback:oCallback,caller:oCaller});for(var i=nCacheLength-1;i>=0;i--){var oCacheElem=aCache[i];if(this.isCacheHit(oRequest,oCacheElem.request)){oResponse=oCacheElem.response;this.fireEvent("cacheResponseEvent",{request:oRequest,response:oResponse,callback:oCallback,caller:oCaller});if(i<nCacheLength-1){aCache.splice(i,1);this.addToCache(oRequest,oResponse);}oResponse.cached=true;break;}}return oResponse;}}}else{if(aCache){this._aCache=null;}}return null;},isCacheHit:function(oRequest,oCachedRequest){return(oRequest===oCachedRequest);},addToCache:function(oRequest,oResponse){var aCache=this._aCache;if(!aCache){return;}while(aCache.length>=this.maxCacheEntries){aCache.shift();}oResponse=(this.cloneBeforeCaching)?DS._cloneObject(oResponse):oResponse;var oCacheElem={request:oRequest,response:oResponse};aCache[aCache.length]=oCacheElem;this.fireEvent("responseCacheEvent",{request:oRequest,response:oResponse});},flushCache:function(){if(this._aCache){this._aCache=[];this.fireEvent("cacheFlushEvent");}},setInterval:function(nMsec,oRequest,oCallback,oCaller){if(lang.isNumber(nMsec)&&(nMsec>=0)){var oSelf=this;var nId=setInterval(function(){oSelf.makeConnection(oRequest,oCallback,oCaller);},nMsec);this._aIntervals.push(nId);return nId;}else{}},clearInterval:function(nId){var tracker=this._aIntervals||[];for(var i=tracker.length-1;i>-1;i--){if(tracker[i]===nId){tracker.splice(i,1);clearInterval(nId);}}},clearAllIntervals:function(){var tracker=this._aIntervals||[];for(var i=tracker.length-1;i>-1;i--){clearInterval(tracker[i]);}tracker=[];},sendRequest:function(oRequest,oCallback,oCaller){var oCachedResponse=this.getCachedResponse(oRequest,oCallback,oCaller);if(oCachedResponse){DS.issueCallback(oCallback,[oRequest,oCachedResponse],false,oCaller);return null;}return this.makeConnection(oRequest,oCallback,oCaller);},makeConnection:function(oRequest,oCallback,oCaller){var tId=DS._nTransactionId++;this.fireEvent("requestEvent",{tId:tId,request:oRequest,callback:oCallback,caller:oCaller});var oRawResponse=this.liveData;this.handleResponse(oRequest,oRawResponse,oCallback,oCaller,tId);return tId;},handleResponse:function(oRequest,oRawResponse,oCallback,oCaller,tId){this.fireEvent("responseEvent",{tId:tId,request:oRequest,response:oRawResponse,callback:oCallback,caller:oCaller});
+var xhr=(this.dataType==DS.TYPE_XHR)?true:false;var oParsedResponse=null;var oFullResponse=oRawResponse;if(this.responseType===DS.TYPE_UNKNOWN){var ctype=(oRawResponse&&oRawResponse.getResponseHeader)?oRawResponse.getResponseHeader["Content-Type"]:null;if(ctype){if(ctype.indexOf("text/xml")>-1){this.responseType=DS.TYPE_XML;}else{if(ctype.indexOf("application/json")>-1){this.responseType=DS.TYPE_JSON;}else{if(ctype.indexOf("text/plain")>-1){this.responseType=DS.TYPE_TEXT;}}}}else{if(YAHOO.lang.isArray(oRawResponse)){this.responseType=DS.TYPE_JSARRAY;}else{if(oRawResponse&&oRawResponse.nodeType&&(oRawResponse.nodeType===9||oRawResponse.nodeType===1||oRawResponse.nodeType===11)){this.responseType=DS.TYPE_XML;}else{if(oRawResponse&&oRawResponse.nodeName&&(oRawResponse.nodeName.toLowerCase()=="table")){this.responseType=DS.TYPE_HTMLTABLE;}else{if(YAHOO.lang.isObject(oRawResponse)){this.responseType=DS.TYPE_JSON;}else{if(YAHOO.lang.isString(oRawResponse)){this.responseType=DS.TYPE_TEXT;}}}}}}}switch(this.responseType){case DS.TYPE_JSARRAY:if(xhr&&oRawResponse&&oRawResponse.responseText){oFullResponse=oRawResponse.responseText;}try{if(lang.isString(oFullResponse)){var parseArgs=[oFullResponse].concat(this.parseJSONArgs);if(lang.JSON){oFullResponse=lang.JSON.parse.apply(lang.JSON,parseArgs);}else{if(window.JSON&&JSON.parse){oFullResponse=JSON.parse.apply(JSON,parseArgs);}else{if(oFullResponse.parseJSON){oFullResponse=oFullResponse.parseJSON.apply(oFullResponse,parseArgs.slice(1));}else{while(oFullResponse.length>0&&(oFullResponse.charAt(0)!="{")&&(oFullResponse.charAt(0)!="[")){oFullResponse=oFullResponse.substring(1,oFullResponse.length);}if(oFullResponse.length>0){var arrayEnd=Math.max(oFullResponse.lastIndexOf("]"),oFullResponse.lastIndexOf("}"));oFullResponse=oFullResponse.substring(0,arrayEnd+1);oFullResponse=eval("("+oFullResponse+")");}}}}}}catch(e1){}oFullResponse=this.doBeforeParseData(oRequest,oFullResponse,oCallback);oParsedResponse=this.parseArrayData(oRequest,oFullResponse);break;case DS.TYPE_JSON:if(xhr&&oRawResponse&&oRawResponse.responseText){oFullResponse=oRawResponse.responseText;}try{if(lang.isString(oFullResponse)){var parseArgs=[oFullResponse].concat(this.parseJSONArgs);if(lang.JSON){oFullResponse=lang.JSON.parse.apply(lang.JSON,parseArgs);}else{if(window.JSON&&JSON.parse){oFullResponse=JSON.parse.apply(JSON,parseArgs);}else{if(oFullResponse.parseJSON){oFullResponse=oFullResponse.parseJSON.apply(oFullResponse,parseArgs.slice(1));}else{while(oFullResponse.length>0&&(oFullResponse.charAt(0)!="{")&&(oFullResponse.charAt(0)!="[")){oFullResponse=oFullResponse.substring(1,oFullResponse.length);}if(oFullResponse.length>0){var objEnd=Math.max(oFullResponse.lastIndexOf("]"),oFullResponse.lastIndexOf("}"));oFullResponse=oFullResponse.substring(0,objEnd+1);oFullResponse=eval("("+oFullResponse+")");}}}}}}catch(e){}oFullResponse=this.doBeforeParseData(oRequest,oFullResponse,oCallback);oParsedResponse=this.parseJSONData(oRequest,oFullResponse);break;case DS.TYPE_HTMLTABLE:if(xhr&&oRawResponse.responseText){var el=document.createElement("div");el.innerHTML=oRawResponse.responseText;oFullResponse=el.getElementsByTagName("table")[0];}oFullResponse=this.doBeforeParseData(oRequest,oFullResponse,oCallback);oParsedResponse=this.parseHTMLTableData(oRequest,oFullResponse);break;case DS.TYPE_XML:if(xhr&&oRawResponse.responseXML){oFullResponse=oRawResponse.responseXML;}oFullResponse=this.doBeforeParseData(oRequest,oFullResponse,oCallback);oParsedResponse=this.parseXMLData(oRequest,oFullResponse);break;case DS.TYPE_TEXT:if(xhr&&lang.isString(oRawResponse.responseText)){oFullResponse=oRawResponse.responseText;}oFullResponse=this.doBeforeParseData(oRequest,oFullResponse,oCallback);oParsedResponse=this.parseTextData(oRequest,oFullResponse);break;default:oFullResponse=this.doBeforeParseData(oRequest,oFullResponse,oCallback);oParsedResponse=this.parseData(oRequest,oFullResponse);break;}oParsedResponse=oParsedResponse||{};if(!oParsedResponse.results){oParsedResponse.results=[];}if(!oParsedResponse.meta){oParsedResponse.meta={};}if(!oParsedResponse.error){oParsedResponse=this.doBeforeCallback(oRequest,oFullResponse,oParsedResponse,oCallback);this.fireEvent("responseParseEvent",{request:oRequest,response:oParsedResponse,callback:oCallback,caller:oCaller});this.addToCache(oRequest,oParsedResponse);}else{oParsedResponse.error=true;this.fireEvent("dataErrorEvent",{request:oRequest,response:oRawResponse,callback:oCallback,caller:oCaller,message:DS.ERROR_DATANULL});}oParsedResponse.tId=tId;DS.issueCallback(oCallback,[oRequest,oParsedResponse],oParsedResponse.error,oCaller);},doBeforeParseData:function(oRequest,oFullResponse,oCallback){return oFullResponse;},doBeforeCallback:function(oRequest,oFullResponse,oParsedResponse,oCallback){return oParsedResponse;},parseData:function(oRequest,oFullResponse){if(lang.isValue(oFullResponse)){var oParsedResponse={results:oFullResponse,meta:{}};return oParsedResponse;}return null;},parseArrayData:function(oRequest,oFullResponse){if(lang.isArray(oFullResponse)){var results=[],i,j,rec,field,data;if(lang.isArray(this.responseSchema.fields)){var fields=this.responseSchema.fields;for(i=fields.length-1;i>=0;--i){if(typeof fields[i]!=="object"){fields[i]={key:fields[i]};}}var parsers={},p;for(i=fields.length-1;i>=0;--i){p=(typeof fields[i].parser==="function"?fields[i].parser:DS.Parser[fields[i].parser+""])||fields[i].converter;if(p){parsers[fields[i].key]=p;}}var arrType=lang.isArray(oFullResponse[0]);for(i=oFullResponse.length-1;i>-1;i--){var oResult={};rec=oFullResponse[i];if(typeof rec==="object"){for(j=fields.length-1;j>-1;j--){field=fields[j];data=arrType?rec[j]:rec[field.key];if(parsers[field.key]){data=parsers[field.key].call(this,data);}if(data===undefined){data=null;}oResult[field.key]=data;}}else{if(lang.isString(rec)){for(j=fields.length-1;j>-1;j--){field=fields[j];data=rec;if(parsers[field.key]){data=parsers[field.key].call(this,data);}if(data===undefined){data=null;}oResult[field.key]=data;
+}}}results[i]=oResult;}}else{results=oFullResponse;}var oParsedResponse={results:results};return oParsedResponse;}return null;},parseTextData:function(oRequest,oFullResponse){if(lang.isString(oFullResponse)){if(lang.isString(this.responseSchema.recordDelim)&&lang.isString(this.responseSchema.fieldDelim)){var oParsedResponse={results:[]};var recDelim=this.responseSchema.recordDelim;var fieldDelim=this.responseSchema.fieldDelim;if(oFullResponse.length>0){var newLength=oFullResponse.length-recDelim.length;if(oFullResponse.substr(newLength)==recDelim){oFullResponse=oFullResponse.substr(0,newLength);}if(oFullResponse.length>0){var recordsarray=oFullResponse.split(recDelim);for(var i=0,len=recordsarray.length,recIdx=0;i<len;++i){var bError=false,sRecord=recordsarray[i];if(lang.isString(sRecord)&&(sRecord.length>0)){var fielddataarray=recordsarray[i].split(fieldDelim);var oResult={};if(lang.isArray(this.responseSchema.fields)){var fields=this.responseSchema.fields;for(var j=fields.length-1;j>-1;j--){try{var data=fielddataarray[j];if(lang.isString(data)){if(data.charAt(0)=='"'){data=data.substr(1);}if(data.charAt(data.length-1)=='"'){data=data.substr(0,data.length-1);}var field=fields[j];var key=(lang.isValue(field.key))?field.key:field;if(!field.parser&&field.converter){field.parser=field.converter;}var parser=(typeof field.parser==="function")?field.parser:DS.Parser[field.parser+""];if(parser){data=parser.call(this,data);}if(data===undefined){data=null;}oResult[key]=data;}else{bError=true;}}catch(e){bError=true;}}}else{oResult=fielddataarray;}if(!bError){oParsedResponse.results[recIdx++]=oResult;}}}}}return oParsedResponse;}}return null;},parseXMLResult:function(result){var oResult={},schema=this.responseSchema;try{for(var m=schema.fields.length-1;m>=0;m--){var field=schema.fields[m];var key=(lang.isValue(field.key))?field.key:field;var data=null;if(this.useXPath){data=YAHOO.util.DataSource._getLocationValue(field,result);}else{var xmlAttr=result.attributes.getNamedItem(key);if(xmlAttr){data=xmlAttr.value;}else{var xmlNode=result.getElementsByTagName(key);if(xmlNode&&xmlNode.item(0)){var item=xmlNode.item(0);data=(item)?((item.text)?item.text:(item.textContent)?item.textContent:null):null;if(!data){var datapieces=[];for(var j=0,len=item.childNodes.length;j<len;j++){if(item.childNodes[j].nodeValue){datapieces[datapieces.length]=item.childNodes[j].nodeValue;}}if(datapieces.length>0){data=datapieces.join("");}}}}}if(data===null){data="";}if(!field.parser&&field.converter){field.parser=field.converter;}var parser=(typeof field.parser==="function")?field.parser:DS.Parser[field.parser+""];if(parser){data=parser.call(this,data);}if(data===undefined){data=null;}oResult[key]=data;}}catch(e){}return oResult;},parseXMLData:function(oRequest,oFullResponse){var bError=false,schema=this.responseSchema,oParsedResponse={meta:{}},xmlList=null,metaNode=schema.metaNode,metaLocators=schema.metaFields||{},i,k,loc,v;try{if(this.useXPath){for(k in metaLocators){oParsedResponse.meta[k]=YAHOO.util.DataSource._getLocationValue(metaLocators[k],oFullResponse);}}else{metaNode=metaNode?oFullResponse.getElementsByTagName(metaNode)[0]:oFullResponse;if(metaNode){for(k in metaLocators){if(lang.hasOwnProperty(metaLocators,k)){loc=metaLocators[k];v=metaNode.getElementsByTagName(loc)[0];if(v){v=v.firstChild.nodeValue;}else{v=metaNode.attributes.getNamedItem(loc);if(v){v=v.value;}}if(lang.isValue(v)){oParsedResponse.meta[k]=v;}}}}}xmlList=(schema.resultNode)?oFullResponse.getElementsByTagName(schema.resultNode):null;}catch(e){}if(!xmlList||!lang.isArray(schema.fields)){bError=true;}else{oParsedResponse.results=[];for(i=xmlList.length-1;i>=0;--i){var oResult=this.parseXMLResult(xmlList.item(i));oParsedResponse.results[i]=oResult;}}if(bError){oParsedResponse.error=true;}else{}return oParsedResponse;},parseJSONData:function(oRequest,oFullResponse){var oParsedResponse={results:[],meta:{}};if(lang.isObject(oFullResponse)&&this.responseSchema.resultsList){var schema=this.responseSchema,fields=schema.fields,resultsList=oFullResponse,results=[],metaFields=schema.metaFields||{},fieldParsers=[],fieldPaths=[],simpleFields=[],bError=false,i,len,j,v,key,parser,path;var buildPath=function(needle){var path=null,keys=[],i=0;if(needle){needle=needle.replace(/\[(['"])(.*?)\1\]/g,function(x,$1,$2){keys[i]=$2;return".@"+(i++);}).replace(/\[(\d+)\]/g,function(x,$1){keys[i]=parseInt($1,10)|0;return".@"+(i++);}).replace(/^\./,"");if(!/[^\w\.\$@]/.test(needle)){path=needle.split(".");for(i=path.length-1;i>=0;--i){if(path[i].charAt(0)==="@"){path[i]=keys[parseInt(path[i].substr(1),10)];}}}else{}}return path;};var walkPath=function(path,origin){var v=origin,i=0,len=path.length;for(;i<len&&v;++i){v=v[path[i]];}return v;};path=buildPath(schema.resultsList);if(path){resultsList=walkPath(path,oFullResponse);if(resultsList===undefined){bError=true;}}else{bError=true;}if(!resultsList){resultsList=[];}if(!lang.isArray(resultsList)){resultsList=[resultsList];}if(!bError){if(schema.fields){var field;for(i=0,len=fields.length;i<len;i++){field=fields[i];key=field.key||field;parser=((typeof field.parser==="function")?field.parser:DS.Parser[field.parser+""])||field.converter;path=buildPath(key);if(parser){fieldParsers[fieldParsers.length]={key:key,parser:parser};}if(path){if(path.length>1){fieldPaths[fieldPaths.length]={key:key,path:path};}else{simpleFields[simpleFields.length]={key:key,path:path[0]};}}else{}}for(i=resultsList.length-1;i>=0;--i){var r=resultsList[i],rec={};if(r){for(j=simpleFields.length-1;j>=0;--j){rec[simpleFields[j].key]=(r[simpleFields[j].path]!==undefined)?r[simpleFields[j].path]:r[j];}for(j=fieldPaths.length-1;j>=0;--j){rec[fieldPaths[j].key]=walkPath(fieldPaths[j].path,r);}for(j=fieldParsers.length-1;j>=0;--j){var p=fieldParsers[j].key;rec[p]=fieldParsers[j].parser.call(this,rec[p]);if(rec[p]===undefined){rec[p]=null;}}}results[i]=rec;}}else{results=resultsList;}for(key in metaFields){if(lang.hasOwnProperty(metaFields,key)){path=buildPath(metaFields[key]);
+if(path){v=walkPath(path,oFullResponse);oParsedResponse.meta[key]=v;}}}}else{oParsedResponse.error=true;}oParsedResponse.results=results;}else{oParsedResponse.error=true;}return oParsedResponse;},parseHTMLTableData:function(oRequest,oFullResponse){var bError=false;var elTable=oFullResponse;var fields=this.responseSchema.fields;var oParsedResponse={results:[]};if(lang.isArray(fields)){for(var i=0;i<elTable.tBodies.length;i++){var elTbody=elTable.tBodies[i];for(var j=elTbody.rows.length-1;j>-1;j--){var elRow=elTbody.rows[j];var oResult={};for(var k=fields.length-1;k>-1;k--){var field=fields[k];var key=(lang.isValue(field.key))?field.key:field;var data=elRow.cells[k].innerHTML;if(!field.parser&&field.converter){field.parser=field.converter;}var parser=(typeof field.parser==="function")?field.parser:DS.Parser[field.parser+""];if(parser){data=parser.call(this,data);}if(data===undefined){data=null;}oResult[key]=data;}oParsedResponse.results[j]=oResult;}}}else{bError=true;}if(bError){oParsedResponse.error=true;}else{}return oParsedResponse;}};lang.augmentProto(DS,util.EventProvider);util.LocalDataSource=function(oLiveData,oConfigs){this.dataType=DS.TYPE_LOCAL;if(oLiveData){if(YAHOO.lang.isArray(oLiveData)){this.responseType=DS.TYPE_JSARRAY;}else{if(oLiveData.nodeType&&oLiveData.nodeType==9){this.responseType=DS.TYPE_XML;}else{if(oLiveData.nodeName&&(oLiveData.nodeName.toLowerCase()=="table")){this.responseType=DS.TYPE_HTMLTABLE;oLiveData=oLiveData.cloneNode(true);}else{if(YAHOO.lang.isString(oLiveData)){this.responseType=DS.TYPE_TEXT;}else{if(YAHOO.lang.isObject(oLiveData)){this.responseType=DS.TYPE_JSON;}}}}}}else{oLiveData=[];this.responseType=DS.TYPE_JSARRAY;}util.LocalDataSource.superclass.constructor.call(this,oLiveData,oConfigs);};lang.extend(util.LocalDataSource,DS);lang.augmentObject(util.LocalDataSource,DS);util.FunctionDataSource=function(oLiveData,oConfigs){this.dataType=DS.TYPE_JSFUNCTION;oLiveData=oLiveData||function(){};util.FunctionDataSource.superclass.constructor.call(this,oLiveData,oConfigs);};lang.extend(util.FunctionDataSource,DS,{scope:null,makeConnection:function(oRequest,oCallback,oCaller){var tId=DS._nTransactionId++;this.fireEvent("requestEvent",{tId:tId,request:oRequest,callback:oCallback,caller:oCaller});var oRawResponse=(this.scope)?this.liveData.call(this.scope,oRequest,this,oCallback):this.liveData(oRequest,oCallback);if(this.responseType===DS.TYPE_UNKNOWN){if(YAHOO.lang.isArray(oRawResponse)){this.responseType=DS.TYPE_JSARRAY;}else{if(oRawResponse&&oRawResponse.nodeType&&oRawResponse.nodeType==9){this.responseType=DS.TYPE_XML;}else{if(oRawResponse&&oRawResponse.nodeName&&(oRawResponse.nodeName.toLowerCase()=="table")){this.responseType=DS.TYPE_HTMLTABLE;}else{if(YAHOO.lang.isObject(oRawResponse)){this.responseType=DS.TYPE_JSON;}else{if(YAHOO.lang.isString(oRawResponse)){this.responseType=DS.TYPE_TEXT;}}}}}}this.handleResponse(oRequest,oRawResponse,oCallback,oCaller,tId);return tId;}});lang.augmentObject(util.FunctionDataSource,DS);util.ScriptNodeDataSource=function(oLiveData,oConfigs){this.dataType=DS.TYPE_SCRIPTNODE;oLiveData=oLiveData||"";util.ScriptNodeDataSource.superclass.constructor.call(this,oLiveData,oConfigs);};lang.extend(util.ScriptNodeDataSource,DS,{getUtility:util.Get,asyncMode:"allowAll",scriptCallbackParam:"callback",generateRequestCallback:function(id){return"&"+this.scriptCallbackParam+"=YAHOO.util.ScriptNodeDataSource.callbacks["+id+"]";},doBeforeGetScriptNode:function(sUri){return sUri;},makeConnection:function(oRequest,oCallback,oCaller){var tId=DS._nTransactionId++;this.fireEvent("requestEvent",{tId:tId,request:oRequest,callback:oCallback,caller:oCaller});if(util.ScriptNodeDataSource._nPending===0){util.ScriptNodeDataSource.callbacks=[];util.ScriptNodeDataSource._nId=0;}var id=util.ScriptNodeDataSource._nId;util.ScriptNodeDataSource._nId++;var oSelf=this;util.ScriptNodeDataSource.callbacks[id]=function(oRawResponse){if((oSelf.asyncMode!=="ignoreStaleResponses")||(id===util.ScriptNodeDataSource.callbacks.length-1)){if(oSelf.responseType===DS.TYPE_UNKNOWN){if(YAHOO.lang.isArray(oRawResponse)){oSelf.responseType=DS.TYPE_JSARRAY;}else{if(oRawResponse.nodeType&&oRawResponse.nodeType==9){oSelf.responseType=DS.TYPE_XML;}else{if(oRawResponse.nodeName&&(oRawResponse.nodeName.toLowerCase()=="table")){oSelf.responseType=DS.TYPE_HTMLTABLE;}else{if(YAHOO.lang.isObject(oRawResponse)){oSelf.responseType=DS.TYPE_JSON;}else{if(YAHOO.lang.isString(oRawResponse)){oSelf.responseType=DS.TYPE_TEXT;}}}}}}oSelf.handleResponse(oRequest,oRawResponse,oCallback,oCaller,tId);}else{}delete util.ScriptNodeDataSource.callbacks[id];};util.ScriptNodeDataSource._nPending++;var sUri=this.liveData+oRequest+this.generateRequestCallback(id);sUri=this.doBeforeGetScriptNode(sUri);this.getUtility.script(sUri,{autopurge:true,onsuccess:util.ScriptNodeDataSource._bumpPendingDown,onfail:util.ScriptNodeDataSource._bumpPendingDown});return tId;}});lang.augmentObject(util.ScriptNodeDataSource,DS);lang.augmentObject(util.ScriptNodeDataSource,{_nId:0,_nPending:0,callbacks:[]});util.XHRDataSource=function(oLiveData,oConfigs){this.dataType=DS.TYPE_XHR;this.connMgr=this.connMgr||util.Connect;oLiveData=oLiveData||"";util.XHRDataSource.superclass.constructor.call(this,oLiveData,oConfigs);};lang.extend(util.XHRDataSource,DS,{connMgr:null,connXhrMode:"allowAll",connMethodPost:false,connTimeout:0,makeConnection:function(oRequest,oCallback,oCaller){var oRawResponse=null;var tId=DS._nTransactionId++;this.fireEvent("requestEvent",{tId:tId,request:oRequest,callback:oCallback,caller:oCaller});var oSelf=this;var oConnMgr=this.connMgr;var oQueue=this._oQueue;var _xhrSuccess=function(oResponse){if(oResponse&&(this.connXhrMode=="ignoreStaleResponses")&&(oResponse.tId!=oQueue.conn.tId)){return null;}else{if(!oResponse){this.fireEvent("dataErrorEvent",{request:oRequest,response:null,callback:oCallback,caller:oCaller,message:DS.ERROR_DATANULL});DS.issueCallback(oCallback,[oRequest,{error:true}],true,oCaller);return null;
+}else{if(this.responseType===DS.TYPE_UNKNOWN){var ctype=(oResponse.getResponseHeader)?oResponse.getResponseHeader["Content-Type"]:null;if(ctype){if(ctype.indexOf("text/xml")>-1){this.responseType=DS.TYPE_XML;}else{if(ctype.indexOf("application/json")>-1){this.responseType=DS.TYPE_JSON;}else{if(ctype.indexOf("text/plain")>-1){this.responseType=DS.TYPE_TEXT;}}}}}this.handleResponse(oRequest,oResponse,oCallback,oCaller,tId);}}};var _xhrFailure=function(oResponse){this.fireEvent("dataErrorEvent",{request:oRequest,response:oResponse,callback:oCallback,caller:oCaller,message:DS.ERROR_DATAINVALID});if(lang.isString(this.liveData)&&lang.isString(oRequest)&&(this.liveData.lastIndexOf("?")!==this.liveData.length-1)&&(oRequest.indexOf("?")!==0)){}oResponse=oResponse||{};oResponse.error=true;DS.issueCallback(oCallback,[oRequest,oResponse],true,oCaller);return null;};var _xhrCallback={success:_xhrSuccess,failure:_xhrFailure,scope:this};if(lang.isNumber(this.connTimeout)){_xhrCallback.timeout=this.connTimeout;}if(this.connXhrMode=="cancelStaleRequests"){if(oQueue.conn){if(oConnMgr.abort){oConnMgr.abort(oQueue.conn);oQueue.conn=null;}else{}}}if(oConnMgr&&oConnMgr.asyncRequest){var sLiveData=this.liveData;var isPost=this.connMethodPost;var sMethod=(isPost)?"POST":"GET";var sUri=(isPost||!lang.isValue(oRequest))?sLiveData:sLiveData+oRequest;var sRequest=(isPost)?oRequest:null;if(this.connXhrMode!="queueRequests"){oQueue.conn=oConnMgr.asyncRequest(sMethod,sUri,_xhrCallback,sRequest);}else{if(oQueue.conn){var allRequests=oQueue.requests;allRequests.push({request:oRequest,callback:_xhrCallback});if(!oQueue.interval){oQueue.interval=setInterval(function(){if(oConnMgr.isCallInProgress(oQueue.conn)){return;}else{if(allRequests.length>0){sUri=(isPost||!lang.isValue(allRequests[0].request))?sLiveData:sLiveData+allRequests[0].request;sRequest=(isPost)?allRequests[0].request:null;oQueue.conn=oConnMgr.asyncRequest(sMethod,sUri,allRequests[0].callback,sRequest);allRequests.shift();}else{clearInterval(oQueue.interval);oQueue.interval=null;}}},50);}}else{oQueue.conn=oConnMgr.asyncRequest(sMethod,sUri,_xhrCallback,sRequest);}}}else{DS.issueCallback(oCallback,[oRequest,{error:true}],true,oCaller);}return tId;}});lang.augmentObject(util.XHRDataSource,DS);util.DataSource=function(oLiveData,oConfigs){oConfigs=oConfigs||{};var dataType=oConfigs.dataType;if(dataType){if(dataType==DS.TYPE_LOCAL){return new util.LocalDataSource(oLiveData,oConfigs);}else{if(dataType==DS.TYPE_XHR){return new util.XHRDataSource(oLiveData,oConfigs);}else{if(dataType==DS.TYPE_SCRIPTNODE){return new util.ScriptNodeDataSource(oLiveData,oConfigs);}else{if(dataType==DS.TYPE_JSFUNCTION){return new util.FunctionDataSource(oLiveData,oConfigs);}}}}}if(YAHOO.lang.isString(oLiveData)){return new util.XHRDataSource(oLiveData,oConfigs);}else{if(YAHOO.lang.isFunction(oLiveData)){return new util.FunctionDataSource(oLiveData,oConfigs);}else{return new util.LocalDataSource(oLiveData,oConfigs);}}};lang.augmentObject(util.DataSource,DS);})();YAHOO.util.Number={format:function(e,k){if(e===""||e===null||!isFinite(e)){return"";}e=+e;k=YAHOO.lang.merge(YAHOO.util.Number.format.defaults,(k||{}));var j=e+"",l=Math.abs(e),b=k.decimalPlaces||0,r=k.thousandsSeparator,f=k.negativeFormat||("-"+k.format),q,p,g,h;if(f.indexOf("#")>-1){f=f.replace(/#/,k.format);}if(b<0){q=l-(l%1)+"";g=q.length+b;if(g>0){q=Number("."+q).toFixed(g).slice(2)+new Array(q.length-g+1).join("0");}else{q="0";}}else{var a=l+"";if(b>0||a.indexOf(".")>0){var d=Math.pow(10,b);q=Math.round(l*d)/d+"";var c=q.indexOf("."),m,o;if(c<0){m=b;o=(Math.pow(10,m)+"").substring(1);if(b>0){q=q+"."+o;}}else{m=b-(q.length-c-1);o=(Math.pow(10,m)+"").substring(1);q=q+o;}}else{q=l.toFixed(b)+"";}}p=q.split(/\D/);if(l>=1000){g=p[0].length%3||3;p[0]=p[0].slice(0,g)+p[0].slice(g).replace(/(\d{3})/g,r+"$1");}return YAHOO.util.Number.format._applyFormat((e<0?f:k.format),p.join(k.decimalSeparator),k);}};YAHOO.util.Number.format.defaults={format:"{prefix}{number}{suffix}",negativeFormat:null,decimalSeparator:".",decimalPlaces:null,thousandsSeparator:""};YAHOO.util.Number.format._applyFormat=function(a,b,c){return a.replace(/\{(\w+)\}/g,function(d,e){return e==="number"?b:e in c?c[e]:"";});};(function(){var a=function(c,e,d){if(typeof d==="undefined"){d=10;}for(;parseInt(c,10)<d&&d>1;d/=10){c=e.toString()+c;}return c.toString();};var b={formats:{a:function(e,c){return c.a[e.getDay()];},A:function(e,c){return c.A[e.getDay()];},b:function(e,c){return c.b[e.getMonth()];},B:function(e,c){return c.B[e.getMonth()];},C:function(c){return a(parseInt(c.getFullYear()/100,10),0);},d:["getDate","0"],e:["getDate"," "],g:function(c){return a(parseInt(b.formats.G(c)%100,10),0);},G:function(f){var g=f.getFullYear();var e=parseInt(b.formats.V(f),10);var c=parseInt(b.formats.W(f),10);if(c>e){g++;}else{if(c===0&&e>=52){g--;}}return g;},H:["getHours","0"],I:function(e){var c=e.getHours()%12;return a(c===0?12:c,0);},j:function(h){var g=new Date(""+h.getFullYear()+"/1/1 GMT");var e=new Date(""+h.getFullYear()+"/"+(h.getMonth()+1)+"/"+h.getDate()+" GMT");var c=e-g;var f=parseInt(c/60000/60/24,10)+1;return a(f,0,100);},k:["getHours"," "],l:function(e){var c=e.getHours()%12;return a(c===0?12:c," ");},m:function(c){return a(c.getMonth()+1,0);},M:["getMinutes","0"],p:function(e,c){return c.p[e.getHours()>=12?1:0];},P:function(e,c){return c.P[e.getHours()>=12?1:0];},s:function(e,c){return parseInt(e.getTime()/1000,10);},S:["getSeconds","0"],u:function(c){var e=c.getDay();return e===0?7:e;},U:function(g){var c=parseInt(b.formats.j(g),10);var f=6-g.getDay();var e=parseInt((c+f)/7,10);return a(e,0);},V:function(g){var f=parseInt(b.formats.W(g),10);var c=(new Date(""+g.getFullYear()+"/1/1")).getDay();var e=f+(c>4||c<=1?0:1);if(e===53&&(new Date(""+g.getFullYear()+"/12/31")).getDay()<4){e=1;}else{if(e===0){e=b.formats.V(new Date(""+(g.getFullYear()-1)+"/12/31"));}}return a(e,0);},w:"getDay",W:function(g){var c=parseInt(b.formats.j(g),10);var f=7-b.formats.u(g);var e=parseInt((c+f)/7,10);
+return a(e,0,10);},y:function(c){return a(c.getFullYear()%100,0);},Y:"getFullYear",z:function(f){var e=f.getTimezoneOffset();var c=a(parseInt(Math.abs(e/60),10),0);var g=a(Math.abs(e%60),0);return(e>0?"-":"+")+c+g;},Z:function(c){var e=c.toString().replace(/^.*:\d\d( GMT[+-]\d+)? \(?([A-Za-z ]+)\)?\d*$/,"$2").replace(/[a-z ]/g,"");if(e.length>4){e=b.formats.z(c);}return e;},"%":function(c){return"%";}},aggregates:{c:"locale",D:"%m/%d/%y",F:"%Y-%m-%d",h:"%b",n:"\n",r:"locale",R:"%H:%M",t:"\t",T:"%H:%M:%S",x:"locale",X:"locale"},format:function(g,f,d){f=f||{};if(!(g instanceof Date)){return YAHOO.lang.isValue(g)?g:"";}var h=f.format||"%m/%d/%Y";if(h==="YYYY/MM/DD"){h="%Y/%m/%d";}else{if(h==="DD/MM/YYYY"){h="%d/%m/%Y";}else{if(h==="MM/DD/YYYY"){h="%m/%d/%Y";}}}d=d||"en";if(!(d in YAHOO.util.DateLocale)){if(d.replace(/-[a-zA-Z]+$/,"") in YAHOO.util.DateLocale){d=d.replace(/-[a-zA-Z]+$/,"");}else{d="en";}}var j=YAHOO.util.DateLocale[d];var c=function(l,k){var m=b.aggregates[k];return(m==="locale"?j[k]:m);};var e=function(l,k){var m=b.formats[k];if(typeof m==="string"){return g[m]();}else{if(typeof m==="function"){return m.call(g,g,j);}else{if(typeof m==="object"&&typeof m[0]==="string"){return a(g[m[0]](),m[1]);}else{return k;}}}};while(h.match(/%[cDFhnrRtTxX]/)){h=h.replace(/%([cDFhnrRtTxX])/g,c);}var i=h.replace(/%([aAbBCdegGHIjklmMpPsSuUVwWyYzZ%])/g,e);c=e=undefined;return i;}};YAHOO.namespace("YAHOO.util");YAHOO.util.Date=b;YAHOO.util.DateLocale={a:["Sun","Mon","Tue","Wed","Thu","Fri","Sat"],A:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],b:["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"],B:["January","February","March","April","May","June","July","August","September","October","November","December"],c:"%a %d %b %Y %T %Z",p:["AM","PM"],P:["am","pm"],r:"%I:%M:%S %p",x:"%d/%m/%y",X:"%T"};YAHOO.util.DateLocale["en"]=YAHOO.lang.merge(YAHOO.util.DateLocale,{});YAHOO.util.DateLocale["en-US"]=YAHOO.lang.merge(YAHOO.util.DateLocale["en"],{c:"%a %d %b %Y %I:%M:%S %p %Z",x:"%m/%d/%Y",X:"%I:%M:%S %p"});YAHOO.util.DateLocale["en-GB"]=YAHOO.lang.merge(YAHOO.util.DateLocale["en"],{r:"%l:%M:%S %P %Z"});YAHOO.util.DateLocale["en-AU"]=YAHOO.lang.merge(YAHOO.util.DateLocale["en"]);})();YAHOO.register("datasource",YAHOO.util.DataSource,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/datatable/datatable-min.js b/js/yui/datatable/datatable-min.js
new file mode 100644 (file)
index 0000000..f603091
--- /dev/null
+++ b/js/yui/datatable/datatable-min.js
@@ -0,0 +1,33 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.util.Chain=function(){this.q=[].slice.call(arguments);this.createEvent("end");};YAHOO.util.Chain.prototype={id:0,run:function(){var g=this.q[0],d;if(!g){this.fireEvent("end");return this;}else{if(this.id){return this;}}d=g.method||g;if(typeof d==="function"){var f=g.scope||{},b=g.argument||[],a=g.timeout||0,e=this;if(!(b instanceof Array)){b=[b];}if(a<0){this.id=a;if(g.until){for(;!g.until();){d.apply(f,b);}}else{if(g.iterations){for(;g.iterations-->0;){d.apply(f,b);}}else{d.apply(f,b);}}this.q.shift();this.id=0;return this.run();}else{if(g.until){if(g.until()){this.q.shift();return this.run();}}else{if(!g.iterations||!--g.iterations){this.q.shift();}}this.id=setTimeout(function(){d.apply(f,b);if(e.id){e.id=0;e.run();}},a);}}return this;},add:function(a){this.q.push(a);return this;},pause:function(){if(this.id>0){clearTimeout(this.id);}this.id=0;return this;},stop:function(){this.pause();this.q=[];return this;}};YAHOO.lang.augmentProto(YAHOO.util.Chain,YAHOO.util.EventProvider);(function(){var a=YAHOO.util.Event,c=YAHOO.lang,b=[],d=function(h,e,f){var g;if(!h||h===f){g=false;}else{g=YAHOO.util.Selector.test(h,e)?h:d(h.parentNode,e,f);}return g;};c.augmentObject(a,{_createDelegate:function(f,e,g,h){return function(i){var j=this,n=a.getTarget(i),l=e,p=(j.nodeType===9),q,k,o,m;if(c.isFunction(e)){q=e(n);}else{if(c.isString(e)){if(!p){o=j.id;if(!o){o=a.generateId(j);}m=("#"+o+" ");l=(m+e).replace(/,/gi,(","+m));}if(YAHOO.util.Selector.test(n,l)){q=n;}else{if(YAHOO.util.Selector.test(n,((l.replace(/,/gi," *,"))+" *"))){q=d(n,l,j);}}}}if(q){k=q;if(h){if(h===true){k=g;}else{k=h;}}return f.call(k,i,q,j,g);}};},delegate:function(f,j,l,g,h,i){var e=j,k,m;if(c.isString(g)&&!YAHOO.util.Selector){return false;}if(j=="mouseenter"||j=="mouseleave"){if(!a._createMouseDelegate){return false;}e=a._getType(j);k=a._createMouseDelegate(l,h,i);m=a._createDelegate(function(p,o,n){return k.call(o,p,n);},g,h,i);}else{m=a._createDelegate(l,g,h,i);}b.push([f,e,l,m]);return a.on(f,e,m);},removeDelegate:function(f,j,i){var k=j,h=false,g,e;if(j=="mouseenter"||j=="mouseleave"){k=a._getType(j);}g=a._getCacheIndex(b,f,k,i);if(g>=0){e=b[g];}if(f&&e){h=a.removeListener(e[0],e[1],e[3]);if(h){delete b[g][2];delete b[g][3];b.splice(g,1);}}return h;}});}());(function(){var b=YAHOO.util.Event,g=YAHOO.lang,e=b.addListener,f=b.removeListener,c=b.getListeners,d=[],h={mouseenter:"mouseover",mouseleave:"mouseout"},a=function(n,m,l){var j=b._getCacheIndex(d,n,m,l),i,k;if(j>=0){i=d[j];}if(n&&i){k=f.call(b,i[0],m,i[3]);if(k){delete d[j][2];delete d[j][3];d.splice(j,1);}}return k;};g.augmentObject(b._specialTypes,h);g.augmentObject(b,{_createMouseDelegate:function(i,j,k){return function(q,m){var p=this,l=b.getRelatedTarget(q),o,n;if(p!=l&&!YAHOO.util.Dom.isAncestor(p,l)){o=p;if(k){if(k===true){o=j;}else{o=k;}}n=[q,j];if(m){n.splice(1,0,p,m);}return i.apply(o,n);}};},addListener:function(m,l,k,n,o){var i,j;if(h[l]){i=b._createMouseDelegate(k,n,o);i.mouseDelegate=true;d.push([m,l,k,i]);j=e.call(b,m,l,i);}else{j=e.apply(b,arguments);}return j;},removeListener:function(l,k,j){var i;if(h[k]){i=a.apply(b,arguments);}else{i=f.apply(b,arguments);}return i;},getListeners:function(p,o){var n=[],r,m=(o==="mouseover"||o==="mouseout"),q,k,j;if(o&&(m||h[o])){r=c.call(b,p,this._getType(o));if(r){for(k=r.length-1;k>-1;k--){j=r[k];q=j.fn.mouseDelegate;if((h[o]&&q)||(m&&!q)){n.push(j);}}}}else{n=c.apply(b,arguments);}return(n&&n.length)?n:null;}},true);b.on=b.addListener;}());YAHOO.register("event-mouseenter",YAHOO.util.Event,{version:"2.9.0",build:"2800"});var Y=YAHOO,Y_DOM=YAHOO.util.Dom,EMPTY_ARRAY=[],Y_UA=Y.env.ua,Y_Lang=Y.lang,Y_DOC=document,Y_DOCUMENT_ELEMENT=Y_DOC.documentElement,Y_DOM_inDoc=Y_DOM.inDocument,Y_mix=Y_Lang.augmentObject,Y_guid=Y_DOM.generateId,Y_getDoc=function(a){var b=Y_DOC;if(a){b=(a.nodeType===9)?a:a.ownerDocument||a.document||Y_DOC;}return b;},Y_Array=function(g,d){var c,b,h=d||0;try{return Array.prototype.slice.call(g,h);}catch(f){b=[];c=g.length;for(;h<c;h++){b.push(g[h]);}return b;}},Y_DOM_allById=function(f,a){a=a||Y_DOC;var b=[],c=[],d,e;if(a.querySelectorAll){c=a.querySelectorAll('[id="'+f+'"]');}else{if(a.all){b=a.all(f);if(b){if(b.nodeName){if(b.id===f){c.push(b);b=EMPTY_ARRAY;}else{b=[b];}}if(b.length){for(d=0;e=b[d++];){if(e.id===f||(e.attributes&&e.attributes.id&&e.attributes.id.value===f)){c.push(e);}}}}}else{c=[Y_getDoc(a).getElementById(f)];}}return c;};var COMPARE_DOCUMENT_POSITION="compareDocumentPosition",OWNER_DOCUMENT="ownerDocument",Selector={_foundCache:[],useNative:true,_compare:("sourceIndex" in Y_DOCUMENT_ELEMENT)?function(f,e){var d=f.sourceIndex,c=e.sourceIndex;if(d===c){return 0;}else{if(d>c){return 1;}}return -1;}:(Y_DOCUMENT_ELEMENT[COMPARE_DOCUMENT_POSITION]?function(b,a){if(b[COMPARE_DOCUMENT_POSITION](a)&4){return -1;}else{return 1;}}:function(e,d){var c,a,b;if(e&&d){c=e[OWNER_DOCUMENT].createRange();c.setStart(e,0);a=d[OWNER_DOCUMENT].createRange();a.setStart(d,0);b=c.compareBoundaryPoints(1,a);}return b;}),_sort:function(a){if(a){a=Y_Array(a,0,true);if(a.sort){a.sort(Selector._compare);}}return a;},_deDupe:function(a){var b=[],c,d;for(c=0;(d=a[c++]);){if(!d._found){b[b.length]=d;d._found=true;}}for(c=0;(d=b[c++]);){d._found=null;d.removeAttribute("_found");}return b;},query:function(b,j,k,a){if(typeof j=="string"){j=Y_DOM.get(j);if(!j){return(k)?null:[];}}else{j=j||Y_DOC;}var f=[],c=(Selector.useNative&&Y_DOC.querySelector&&!a),e=[[b,j]],g,l,d,h=(c)?Selector._nativeQuery:Selector._bruteQuery;if(b&&h){if(!a&&(!c||j.tagName)){e=Selector._splitQueries(b,j);}for(d=0;(g=e[d++]);){l=h(g[0],g[1],k);if(!k){l=Y_Array(l,0,true);}if(l){f=f.concat(l);}}if(e.length>1){f=Selector._sort(Selector._deDupe(f));}}Y.log("query: "+b+" returning: "+f.length,"info","Selector");return(k)?(f[0]||null):f;},_splitQueries:function(c,f){var b=c.split(","),d=[],g="",e,a;if(f){if(f.tagName){f.id=f.id||Y_guid();g='[id="'+f.id+'"] ';}for(e=0,a=b.length;e<a;++e){c=g+b[e];d.push([c,f]);}}return d;},_nativeQuery:function(a,b,c){if(Y_UA.webkit&&a.indexOf(":checked")>-1&&(Selector.pseudos&&Selector.pseudos.checked)){return Selector.query(a,b,c,true);
+}try{return b["querySelector"+(c?"":"All")](a);}catch(d){return Selector.query(a,b,c,true);}},filter:function(b,a){var c=[],d,e;if(b&&a){for(d=0;(e=b[d++]);){if(Selector.test(e,a)){c[c.length]=e;}}}else{Y.log("invalid filter input (nodes: "+b+", selector: "+a+")","warn","Selector");}return c;},test:function(c,d,k){var g=false,b=d.split(","),a=false,l,o,h,n,f,e,m;if(c&&c.tagName){if(!k&&!Y_DOM_inDoc(c)){l=c.parentNode;if(l){k=l;}else{n=c[OWNER_DOCUMENT].createDocumentFragment();n.appendChild(c);k=n;a=true;}}k=k||c[OWNER_DOCUMENT];if(!c.id){c.id=Y_guid();}for(f=0;(m=b[f++]);){m+='[id="'+c.id+'"]';h=Selector.query(m,k);for(e=0;o=h[e++];){if(o===c){g=true;break;}}if(g){break;}}if(a){n.removeChild(c);}}return g;}};YAHOO.util.Selector=Selector;var PARENT_NODE="parentNode",TAG_NAME="tagName",ATTRIBUTES="attributes",COMBINATOR="combinator",PSEUDOS="pseudos",SelectorCSS2={_reRegExpTokens:/([\^\$\?\[\]\*\+\-\.\(\)\|\\])/,SORT_RESULTS:true,_children:function(e,a){var b=e.children,d,c=[],f,g;if(e.children&&a&&e.children.tags){c=e.children.tags(a);}else{if((!b&&e[TAG_NAME])||(b&&a)){f=b||e.childNodes;b=[];for(d=0;(g=f[d++]);){if(g.tagName){if(!a||a===g.tagName){b.push(g);}}}}}return b||[];},_re:{attr:/(\[[^\]]*\])/g,esc:/\\[:\[\]\(\)#\.\'\>+~"]/gi,pseudos:/(\([^\)]*\))/g},shorthand:{"\\#(-?[_a-z]+[-\\w\\uE000]*)":"[id=$1]","\\.(-?[_a-z]+[-\\w\\uE000]*)":"[className~=$1]"},operators:{"":function(b,a){return !!b.getAttribute(a);},"~=":"(?:^|\\s+){val}(?:\\s+|$)","|=":"^{val}(?:-|$)"},pseudos:{"first-child":function(a){return Selector._children(a[PARENT_NODE])[0]===a;}},_bruteQuery:function(f,j,l){var g=[],a=[],i=Selector._tokenize(f),e=i[i.length-1],k=Y_getDoc(j),c,b,h,d;if(e){b=e.id;h=e.className;d=e.tagName||"*";if(j.getElementsByTagName){if(b&&(j.all||(j.nodeType===9||Y_DOM_inDoc(j)))){a=Y_DOM_allById(b,j);}else{if(h){a=j.getElementsByClassName(h);}else{a=j.getElementsByTagName(d);}}}else{c=j.firstChild;while(c){if(c.tagName){a.push(c);}c=c.nextSilbing||c.firstChild;}}if(a.length){g=Selector._filterNodes(a,i,l);}}return g;},_filterNodes:function(l,f,h){var r=0,q,s=f.length,k=s-1,e=[],o=l[0],v=o,t=Selector.getters,d,p,c,g,a,m,b,u;for(r=0;(v=o=l[r++]);){k=s-1;g=null;testLoop:while(v&&v.tagName){c=f[k];b=c.tests;q=b.length;if(q&&!a){while((u=b[--q])){d=u[1];if(t[u[0]]){m=t[u[0]](v,u[0]);}else{m=v[u[0]];if(m===undefined&&v.getAttribute){m=v.getAttribute(u[0]);}}if((d==="="&&m!==u[2])||(typeof d!=="string"&&d.test&&!d.test(m))||(!d.test&&typeof d==="function"&&!d(v,u[0],u[2]))){if((v=v[g])){while(v&&(!v.tagName||(c.tagName&&c.tagName!==v.tagName))){v=v[g];}}continue testLoop;}}}k--;if(!a&&(p=c.combinator)){g=p.axis;v=v[g];while(v&&!v.tagName){v=v[g];}if(p.direct){g=null;}}else{e.push(o);if(h){return e;}break;}}}o=v=null;return e;},combinators:{" ":{axis:"parentNode"},">":{axis:"parentNode",direct:true},"+":{axis:"previousSibling",direct:true}},_parsers:[{name:ATTRIBUTES,re:/^\uE003(-?[a-z]+[\w\-]*)+([~\|\^\$\*!=]=?)?['"]?([^\uE004'"]*)['"]?\uE004/i,fn:function(d,e){var c=d[2]||"",a=Selector.operators,b=(d[3])?d[3].replace(/\\/g,""):"",f;if((d[1]==="id"&&c==="=")||(d[1]==="className"&&Y_DOCUMENT_ELEMENT.getElementsByClassName&&(c==="~="||c==="="))){e.prefilter=d[1];d[3]=b;e[d[1]]=(d[1]==="id")?d[3]:b;}if(c in a){f=a[c];if(typeof f==="string"){d[3]=b.replace(Selector._reRegExpTokens,"\\$1");f=new RegExp(f.replace("{val}",d[3]));}d[2]=f;}if(!e.last||e.prefilter!==d[1]){return d.slice(1);}}},{name:TAG_NAME,re:/^((?:-?[_a-z]+[\w-]*)|\*)/i,fn:function(b,c){var a=b[1].toUpperCase();c.tagName=a;if(a!=="*"&&(!c.last||c.prefilter)){return[TAG_NAME,"=",a];}if(!c.prefilter){c.prefilter="tagName";}}},{name:COMBINATOR,re:/^\s*([>+~]|\s)\s*/,fn:function(a,b){}},{name:PSEUDOS,re:/^:([\-\w]+)(?:\uE005['"]?([^\uE005]*)['"]?\uE006)*/i,fn:function(a,b){var c=Selector[PSEUDOS][a[1]];if(c){if(a[2]){a[2]=a[2].replace(/\\/g,"");}return[a[2],c];}else{return false;}}}],_getToken:function(a){return{tagName:null,id:null,className:null,attributes:{},combinator:null,tests:[]};},_tokenize:function(c){c=c||"";c=Selector._replaceShorthand(Y_Lang.trim(c));var b=Selector._getToken(),h=c,g=[],j=false,e,f,d,a;outer:do{j=false;for(d=0;(a=Selector._parsers[d++]);){if((e=a.re.exec(c))){if(a.name!==COMBINATOR){b.selector=c;}c=c.replace(e[0],"");if(!c.length){b.last=true;}if(Selector._attrFilters[e[1]]){e[1]=Selector._attrFilters[e[1]];}f=a.fn(e,b);if(f===false){j=false;break outer;}else{if(f){b.tests.push(f);}}if(!c.length||a.name===COMBINATOR){g.push(b);b=Selector._getToken(b);if(a.name===COMBINATOR){b.combinator=Selector.combinators[e[1]];}}j=true;}}}while(j&&c.length);if(!j||c.length){Y.log("query: "+h+" contains unsupported token in: "+c,"warn","Selector");g=[];}return g;},_replaceShorthand:function(b){var d=Selector.shorthand,c=b.match(Selector._re.esc),e,h,g,f,a;if(c){b=b.replace(Selector._re.esc,"\uE000");}e=b.match(Selector._re.attr);h=b.match(Selector._re.pseudos);if(e){b=b.replace(Selector._re.attr,"\uE001");}if(h){b=b.replace(Selector._re.pseudos,"\uE002");}for(g in d){if(d.hasOwnProperty(g)){b=b.replace(new RegExp(g,"gi"),d[g]);}}if(e){for(f=0,a=e.length;f<a;++f){b=b.replace(/\uE001/,e[f]);}}if(h){for(f=0,a=h.length;f<a;++f){b=b.replace(/\uE002/,h[f]);}}b=b.replace(/\[/g,"\uE003");b=b.replace(/\]/g,"\uE004");b=b.replace(/\(/g,"\uE005");b=b.replace(/\)/g,"\uE006");if(c){for(f=0,a=c.length;f<a;++f){b=b.replace("\uE000",c[f]);}}return b;},_attrFilters:{"class":"className","for":"htmlFor"},getters:{href:function(b,a){return Y_DOM.getAttribute(b,a);}}};Y_mix(Selector,SelectorCSS2,true);Selector.getters.src=Selector.getters.rel=Selector.getters.href;if(Selector.useNative&&Y_DOC.querySelector){Selector.shorthand["\\.([^\\s\\\\(\\[:]*)"]="[class~=$1]";}Selector._reNth=/^(?:([\-]?\d*)(n){1}|(odd|even)$)*([\-+]?\d*)$/;Selector._getNth=function(d,o,q,h){Selector._reNth.test(o);var m=parseInt(RegExp.$1,10),c=RegExp.$2,j=RegExp.$3,k=parseInt(RegExp.$4,10)||0,p=[],l=Selector._children(d.parentNode,q),f;if(j){m=2;f="+";c="n";k=(j==="odd")?1:0;}else{if(isNaN(m)){m=(c)?1:0;
+}}if(m===0){if(h){k=l.length-k+1;}if(l[k-1]===d){return true;}else{return false;}}else{if(m<0){h=!!h;m=Math.abs(m);}}if(!h){for(var e=k-1,g=l.length;e<g;e+=m){if(e>=0&&l[e]===d){return true;}}}else{for(var e=l.length-k,g=l.length;e>=0;e-=m){if(e<g&&l[e]===d){return true;}}}return false;};Y_mix(Selector.pseudos,{"root":function(a){return a===a.ownerDocument.documentElement;},"nth-child":function(a,b){return Selector._getNth(a,b);},"nth-last-child":function(a,b){return Selector._getNth(a,b,null,true);},"nth-of-type":function(a,b){return Selector._getNth(a,b,a.tagName);},"nth-last-of-type":function(a,b){return Selector._getNth(a,b,a.tagName,true);},"last-child":function(b){var a=Selector._children(b.parentNode);return a[a.length-1]===b;},"first-of-type":function(a){return Selector._children(a.parentNode,a.tagName)[0]===a;},"last-of-type":function(b){var a=Selector._children(b.parentNode,b.tagName);return a[a.length-1]===b;},"only-child":function(b){var a=Selector._children(b.parentNode);return a.length===1&&a[0]===b;},"only-of-type":function(b){var a=Selector._children(b.parentNode,b.tagName);return a.length===1&&a[0]===b;},"empty":function(a){return a.childNodes.length===0;},"not":function(a,b){return !Selector.test(a,b);},"contains":function(a,b){var c=a.innerText||a.textContent||"";return c.indexOf(b)>-1;},"checked":function(a){return(a.checked===true||a.selected===true);},enabled:function(a){return(a.disabled!==undefined&&!a.disabled);},disabled:function(a){return(a.disabled);}});Y_mix(Selector.operators,{"^=":"^{val}","!=":function(b,a,c){return b[a]!==c;},"$=":"{val}$","*=":"{val}"});Selector.combinators["~"]={axis:"previousSibling"};YAHOO.register("selector",YAHOO.util.Selector,{version:"2.9.0",build:"2800"});var Dom=YAHOO.util.Dom;YAHOO.widget.ColumnSet=function(a){this._sId=Dom.generateId(null,"yui-cs");a=YAHOO.widget.DataTable._cloneObject(a);this._init(a);YAHOO.widget.ColumnSet._nCount++;};YAHOO.widget.ColumnSet._nCount=0;YAHOO.widget.ColumnSet.prototype={_sId:null,_aDefinitions:null,tree:null,flat:null,keys:null,headers:null,_init:function(j){var k=[];var a=[];var g=[];var e=[];var c=-1;var b=function(m,s){c++;if(!k[c]){k[c]=[];}for(var o=0;o<m.length;o++){var i=m[o];var q=new YAHOO.widget.Column(i);i.yuiColumnId=q._sId;a.push(q);if(s){q._oParent=s;}if(YAHOO.lang.isArray(i.children)){q.children=i.children;var r=0;var p=function(v){var w=v.children;for(var u=0;u<w.length;u++){if(YAHOO.lang.isArray(w[u].children)){p(w[u]);}else{r++;}}};p(i);q._nColspan=r;var t=i.children;for(var n=0;n<t.length;n++){var l=t[n];if(q.className&&(l.className===undefined)){l.className=q.className;}if(q.editor&&(l.editor===undefined)){l.editor=q.editor;}if(q.editorOptions&&(l.editorOptions===undefined)){l.editorOptions=q.editorOptions;}if(q.formatter&&(l.formatter===undefined)){l.formatter=q.formatter;}if(q.resizeable&&(l.resizeable===undefined)){l.resizeable=q.resizeable;}if(q.sortable&&(l.sortable===undefined)){l.sortable=q.sortable;}if(q.hidden){l.hidden=true;}if(q.width&&(l.width===undefined)){l.width=q.width;}if(q.minWidth&&(l.minWidth===undefined)){l.minWidth=q.minWidth;}if(q.maxAutoWidth&&(l.maxAutoWidth===undefined)){l.maxAutoWidth=q.maxAutoWidth;}if(q.type&&(l.type===undefined)){l.type=q.type;}if(q.type&&!q.formatter){q.formatter=q.type;}if(q.text&&!YAHOO.lang.isValue(q.label)){q.label=q.text;}if(q.parser){}if(q.sortOptions&&((q.sortOptions.ascFunction)||(q.sortOptions.descFunction))){}}if(!k[c+1]){k[c+1]=[];}b(t,q);}else{q._nKeyIndex=g.length;q._nColspan=1;g.push(q);}k[c].push(q);}c--;};if(YAHOO.lang.isArray(j)){b(j);this._aDefinitions=j;}else{return null;}var f;var d=function(l){var n=1;var q;var o;var r=function(t,p){p=p||1;for(var u=0;u<t.length;u++){var m=t[u];if(YAHOO.lang.isArray(m.children)){p++;r(m.children,p);p--;}else{if(p>n){n=p;}}}};for(var i=0;i<l.length;i++){q=l[i];r(q);for(var s=0;s<q.length;s++){o=q[s];if(!YAHOO.lang.isArray(o.children)){o._nRowspan=n;}else{o._nRowspan=1;}}n=1;}};d(k);for(f=0;f<k[0].length;f++){k[0][f]._nTreeIndex=f;}var h=function(l,m){e[l].push(m.getSanitizedKey());if(m._oParent){h(l,m._oParent);}};for(f=0;f<g.length;f++){e[f]=[];h(f,g[f]);e[f]=e[f].reverse();}this.tree=k;this.flat=a;this.keys=g;this.headers=e;},getId:function(){return this._sId;},toString:function(){return"ColumnSet instance "+this._sId;},getDefinitions:function(){var a=this._aDefinitions;var b=function(e,g){for(var d=0;d<e.length;d++){var f=e[d];var i=g.getColumnById(f.yuiColumnId);if(i){var h=i.getDefinition();for(var c in h){if(YAHOO.lang.hasOwnProperty(h,c)){f[c]=h[c];}}}if(YAHOO.lang.isArray(f.children)){b(f.children,g);}}};b(a,this);this._aDefinitions=a;return a;},getColumnById:function(c){if(YAHOO.lang.isString(c)){var a=this.flat;for(var b=a.length-1;b>-1;b--){if(a[b]._sId===c){return a[b];}}}return null;},getColumn:function(c){if(YAHOO.lang.isNumber(c)&&this.keys[c]){return this.keys[c];}else{if(YAHOO.lang.isString(c)){var a=this.flat;var d=[];for(var b=0;b<a.length;b++){if(a[b].key===c){d.push(a[b]);}}if(d.length===1){return d[0];}else{if(d.length>1){return d;}}}}return null;},getDescendants:function(d){var b=this;var c=[];var a;var e=function(f){c.push(f);if(f.children){for(a=0;a<f.children.length;a++){e(b.getColumn(f.children[a].key));}}};e(d);return c;}};YAHOO.widget.Column=function(b){this._sId=Dom.generateId(null,"yui-col");if(b&&YAHOO.lang.isObject(b)){for(var a in b){if(a){this[a]=b[a];}}}if(!YAHOO.lang.isValue(this.key)){this.key=Dom.generateId(null,"yui-dt-col");}if(!YAHOO.lang.isValue(this.field)){this.field=this.key;}YAHOO.widget.Column._nCount++;if(this.width&&!YAHOO.lang.isNumber(this.width)){this.width=null;}if(this.editor&&YAHOO.lang.isString(this.editor)){this.editor=new YAHOO.widget.CellEditor(this.editor,this.editorOptions);}};YAHOO.lang.augmentObject(YAHOO.widget.Column,{_nCount:0,formatCheckbox:function(b,a,c,d){YAHOO.widget.DataTable.formatCheckbox(b,a,c,d);},formatCurrency:function(b,a,c,d){YAHOO.widget.DataTable.formatCurrency(b,a,c,d);},formatDate:function(b,a,c,d){YAHOO.widget.DataTable.formatDate(b,a,c,d);
+},formatEmail:function(b,a,c,d){YAHOO.widget.DataTable.formatEmail(b,a,c,d);},formatLink:function(b,a,c,d){YAHOO.widget.DataTable.formatLink(b,a,c,d);},formatNumber:function(b,a,c,d){YAHOO.widget.DataTable.formatNumber(b,a,c,d);},formatSelect:function(b,a,c,d){YAHOO.widget.DataTable.formatDropdown(b,a,c,d);}});YAHOO.widget.Column.prototype={_sId:null,_nKeyIndex:null,_nTreeIndex:null,_nColspan:1,_nRowspan:1,_oParent:null,_elTh:null,_elThLiner:null,_elThLabel:null,_elResizer:null,_nWidth:null,_dd:null,_ddResizer:null,key:null,field:null,label:null,abbr:null,children:null,width:null,minWidth:null,maxAutoWidth:null,hidden:false,selected:false,className:null,formatter:null,currencyOptions:null,dateOptions:null,dropdownOptions:null,editor:null,resizeable:false,sortable:false,sortOptions:null,getId:function(){return this._sId;},toString:function(){return"Column instance "+this._sId;},getDefinition:function(){var a={};a.abbr=this.abbr;a.className=this.className;a.editor=this.editor;a.editorOptions=this.editorOptions;a.field=this.field;a.formatter=this.formatter;a.hidden=this.hidden;a.key=this.key;a.label=this.label;a.minWidth=this.minWidth;a.maxAutoWidth=this.maxAutoWidth;a.resizeable=this.resizeable;a.selected=this.selected;a.sortable=this.sortable;a.sortOptions=this.sortOptions;a.width=this.width;a._calculatedWidth=this._calculatedWidth;return a;},getKey:function(){return this.key;},getField:function(){return this.field;},getSanitizedKey:function(){return this.getKey().replace(/[^\w\-]/g,"");},getKeyIndex:function(){return this._nKeyIndex;},getTreeIndex:function(){return this._nTreeIndex;},getParent:function(){return this._oParent;},getColspan:function(){return this._nColspan;},getColSpan:function(){return this.getColspan();},getRowspan:function(){return this._nRowspan;},getThEl:function(){return this._elTh;},getThLinerEl:function(){return this._elThLiner;},getResizerEl:function(){return this._elResizer;},getColEl:function(){return this.getThEl();},getIndex:function(){return this.getKeyIndex();},format:function(){}};YAHOO.util.Sort={compare:function(d,c,e){if((d===null)||(typeof d=="undefined")){if((c===null)||(typeof c=="undefined")){return 0;}else{return 1;}}else{if((c===null)||(typeof c=="undefined")){return -1;}}if(d.constructor==String){d=d.toLowerCase();}if(c.constructor==String){c=c.toLowerCase();}if(d<c){return(e)?1:-1;}else{if(d>c){return(e)?-1:1;}else{return 0;}}}};YAHOO.widget.ColumnDD=function(d,a,c,b){if(d&&a&&c&&b){this.datatable=d;this.table=d.getTableEl();this.column=a;this.headCell=c;this.pointer=b;this.newIndex=null;this.init(c);this.initFrame();this.invalidHandleTypes={};this.setPadding(10,0,(this.datatable.getTheadEl().offsetHeight+10),0);YAHOO.util.Event.on(window,"resize",function(){this.initConstraints();},this,true);}else{}};if(YAHOO.util.DDProxy){YAHOO.extend(YAHOO.widget.ColumnDD,YAHOO.util.DDProxy,{initConstraints:function(){var g=YAHOO.util.Dom.getRegion(this.table),d=this.getEl(),f=YAHOO.util.Dom.getXY(d),c=parseInt(YAHOO.util.Dom.getStyle(d,"width"),10),a=parseInt(YAHOO.util.Dom.getStyle(d,"height"),10),e=((f[0]-g.left)+15),b=((g.right-f[0]-c)+15);this.setXConstraint(e,b);this.setYConstraint(10,10);},_resizeProxy:function(){YAHOO.widget.ColumnDD.superclass._resizeProxy.apply(this,arguments);var a=this.getDragEl(),b=this.getEl();YAHOO.util.Dom.setStyle(this.pointer,"height",(this.table.parentNode.offsetHeight+10)+"px");YAHOO.util.Dom.setStyle(this.pointer,"display","block");var c=YAHOO.util.Dom.getXY(b);YAHOO.util.Dom.setXY(this.pointer,[c[0],(c[1]-5)]);YAHOO.util.Dom.setStyle(a,"height",this.datatable.getContainerEl().offsetHeight+"px");YAHOO.util.Dom.setStyle(a,"width",(parseInt(YAHOO.util.Dom.getStyle(a,"width"),10)+4)+"px");YAHOO.util.Dom.setXY(this.dragEl,c);},onMouseDown:function(){this.initConstraints();this.resetConstraints();},clickValidator:function(b){if(!this.column.hidden){var a=YAHOO.util.Event.getTarget(b);return(this.isValidHandleChild(a)&&(this.id==this.handleElId||this.DDM.handleWasClicked(a,this.id)));}},onDragOver:function(h,a){var f=this.datatable.getColumn(a);if(f){var c=f.getTreeIndex();while((c===null)&&f.getParent()){f=f.getParent();c=f.getTreeIndex();}if(c!==null){var b=f.getThEl();var k=c;var d=YAHOO.util.Event.getPageX(h),i=YAHOO.util.Dom.getX(b),j=i+((YAHOO.util.Dom.get(b).offsetWidth)/2),e=this.column.getTreeIndex();if(d<j){YAHOO.util.Dom.setX(this.pointer,i);}else{var g=parseInt(b.offsetWidth,10);YAHOO.util.Dom.setX(this.pointer,(i+g));k++;}if(c>e){k--;}if(k<0){k=0;}else{if(k>this.datatable.getColumnSet().tree[0].length){k=this.datatable.getColumnSet().tree[0].length;}}this.newIndex=k;}}},onDragDrop:function(){this.datatable.reorderColumn(this.column,this.newIndex);},endDrag:function(){this.newIndex=null;YAHOO.util.Dom.setStyle(this.pointer,"display","none");}});}YAHOO.util.ColumnResizer=function(e,c,d,a,b){if(e&&c&&d&&a){this.datatable=e;this.column=c;this.headCell=d;this.headCellLiner=c.getThLinerEl();this.resizerLiner=d.firstChild;this.init(a,a,{dragOnly:true,dragElId:b.id});this.initFrame();this.resetResizerEl();this.setPadding(0,1,0,0);}else{}};if(YAHOO.util.DD){YAHOO.extend(YAHOO.util.ColumnResizer,YAHOO.util.DDProxy,{resetResizerEl:function(){var a=YAHOO.util.Dom.get(this.handleElId).style;a.left="auto";a.right=0;a.top="auto";a.bottom=0;a.height=this.headCell.offsetHeight+"px";},onMouseUp:function(h){var f=this.datatable.getColumnSet().keys,b;for(var c=0,a=f.length;c<a;c++){b=f[c];if(b._ddResizer){b._ddResizer.resetResizerEl();}}this.resetResizerEl();var d=this.headCellLiner;var g=d.offsetWidth-(parseInt(YAHOO.util.Dom.getStyle(d,"paddingLeft"),10)|0)-(parseInt(YAHOO.util.Dom.getStyle(d,"paddingRight"),10)|0);this.datatable.fireEvent("columnResizeEvent",{column:this.column,target:this.headCell,width:g});},onMouseDown:function(a){this.startWidth=this.headCellLiner.offsetWidth;this.startX=YAHOO.util.Event.getXY(a)[0];this.nLinerPadding=(parseInt(YAHOO.util.Dom.getStyle(this.headCellLiner,"paddingLeft"),10)|0)+(parseInt(YAHOO.util.Dom.getStyle(this.headCellLiner,"paddingRight"),10)|0);
+},clickValidator:function(b){if(!this.column.hidden){var a=YAHOO.util.Event.getTarget(b);return(this.isValidHandleChild(a)&&(this.id==this.handleElId||this.DDM.handleWasClicked(a,this.id)));}},startDrag:function(){var e=this.datatable.getColumnSet().keys,d=this.column.getKeyIndex(),b;for(var c=0,a=e.length;c<a;c++){b=e[c];if(b._ddResizer){YAHOO.util.Dom.get(b._ddResizer.handleElId).style.height="1em";}}},onDrag:function(c){var d=YAHOO.util.Event.getXY(c)[0];if(d>YAHOO.util.Dom.getX(this.headCellLiner)){var a=d-this.startX;var b=this.startWidth+a-this.nLinerPadding;if(b>0){this.datatable.setColumnWidth(this.column,b);}}}});}(function(){var g=YAHOO.lang,a=YAHOO.util,e=YAHOO.widget,c=a.Dom,f=a.Event,d=e.DataTable;YAHOO.widget.RecordSet=function(h){this._init(h);};var b=e.RecordSet;b._nCount=0;b.prototype={_sId:null,_init:function(h){this._sId=c.generateId(null,"yui-rs");e.RecordSet._nCount++;this._records=[];this._initEvents();if(h){if(g.isArray(h)){this.addRecords(h);}else{if(g.isObject(h)){this.addRecord(h);}}}},_initEvents:function(){this.createEvent("recordAddEvent");this.createEvent("recordsAddEvent");this.createEvent("recordSetEvent");this.createEvent("recordsSetEvent");this.createEvent("recordUpdateEvent");this.createEvent("recordDeleteEvent");this.createEvent("recordsDeleteEvent");this.createEvent("resetEvent");this.createEvent("recordValueUpdateEvent");},_addRecord:function(j,h){var i=new YAHOO.widget.Record(j);if(YAHOO.lang.isNumber(h)&&(h>-1)){this._records.splice(h,0,i);}else{this._records[this._records.length]=i;}return i;},_setRecord:function(i,h){if(!g.isNumber(h)||h<0){h=this._records.length;}return(this._records[h]=new e.Record(i));},_deleteRecord:function(i,h){if(!g.isNumber(h)||(h<0)){h=1;}this._records.splice(i,h);},getId:function(){return this._sId;},toString:function(){return"RecordSet instance "+this._sId;},getLength:function(){return this._records.length;},getRecord:function(h){var j;if(h instanceof e.Record){for(j=0;j<this._records.length;j++){if(this._records[j]&&(this._records[j]._sId===h._sId)){return h;}}}else{if(g.isNumber(h)){if((h>-1)&&(h<this.getLength())){return this._records[h];}}else{if(g.isString(h)){for(j=0;j<this._records.length;j++){if(this._records[j]&&(this._records[j]._sId===h)){return this._records[j];}}}}}return null;},getRecords:function(i,h){if(!g.isNumber(i)){return this._records;}if(!g.isNumber(h)){return this._records.slice(i);}return this._records.slice(i,i+h);},hasRecords:function(j,h){var l=this.getRecords(j,h);for(var k=0;k<h;++k){if(typeof l[k]==="undefined"){return false;}}return true;},getRecordIndex:function(j){if(j){for(var h=this._records.length-1;h>-1;h--){if(this._records[h]&&j.getId()===this._records[h].getId()){return h;}}}return null;},addRecord:function(j,h){if(g.isObject(j)){var i=this._addRecord(j,h);this.fireEvent("recordAddEvent",{record:i,data:j});return i;}else{return null;}},addRecords:function(m,l){if(g.isArray(m)){var p=[],j,n,h;l=g.isNumber(l)?l:this._records.length;j=l;for(n=0,h=m.length;n<h;++n){if(g.isObject(m[n])){var k=this._addRecord(m[n],j++);p.push(k);}}this.fireEvent("recordsAddEvent",{records:p,data:m});return p;}else{if(g.isObject(m)){var o=this._addRecord(m);this.fireEvent("recordsAddEvent",{records:[o],data:m});return o;}else{return null;}}},setRecord:function(j,h){if(g.isObject(j)){var i=this._setRecord(j,h);this.fireEvent("recordSetEvent",{record:i,data:j});return i;}else{return null;}},setRecords:function(o,n){var r=e.Record,k=g.isArray(o)?o:[o],q=[],p=0,h=k.length,m=0;n=parseInt(n,10)|0;for(;p<h;++p){if(typeof k[p]==="object"&&k[p]){q[m++]=this._records[n+p]=new r(k[p]);}}this.fireEvent("recordsSetEvent",{records:q,data:o});this.fireEvent("recordsSet",{records:q,data:o});if(k.length&&!q.length){}return q;},updateRecord:function(h,l){var j=this.getRecord(h);if(j&&g.isObject(l)){var k={};for(var i in j._oData){if(g.hasOwnProperty(j._oData,i)){k[i]=j._oData[i];}}j._oData=l;this.fireEvent("recordUpdateEvent",{record:j,newData:l,oldData:k});return j;}else{return null;}},updateKey:function(h,i,j){this.updateRecordValue(h,i,j);},updateRecordValue:function(h,k,n){var j=this.getRecord(h);if(j){var m=null;var l=j._oData[k];if(l&&g.isObject(l)){m={};for(var i in l){if(g.hasOwnProperty(l,i)){m[i]=l[i];}}}else{m=l;}j._oData[k]=n;this.fireEvent("keyUpdateEvent",{record:j,key:k,newData:n,oldData:m});this.fireEvent("recordValueUpdateEvent",{record:j,key:k,newData:n,oldData:m});}else{}},replaceRecords:function(h){this.reset();return this.addRecords(h);},sortRecords:function(h,j,i){return this._records.sort(function(l,k){return h(l,k,j,i);});},reverseRecords:function(){return this._records.reverse();},deleteRecord:function(h){if(g.isNumber(h)&&(h>-1)&&(h<this.getLength())){var i=this.getRecord(h).getData();this._deleteRecord(h);this.fireEvent("recordDeleteEvent",{data:i,index:h});return i;}else{return null;}},deleteRecords:function(k,h){if(!g.isNumber(h)){h=1;}if(g.isNumber(k)&&(k>-1)&&(k<this.getLength())){var m=this.getRecords(k,h);var j=[],n=[];for(var l=0;l<m.length;l++){j[j.length]=m[l];n[n.length]=m[l].getData();}this._deleteRecord(k,h);this.fireEvent("recordsDeleteEvent",{data:j,deletedData:n,index:k});return j;}else{return null;}},reset:function(){this._records=[];this.fireEvent("resetEvent");}};g.augmentProto(b,a.EventProvider);YAHOO.widget.Record=function(h){this._nCount=e.Record._nCount;this._sId=c.generateId(null,"yui-rec");e.Record._nCount++;this._oData={};if(g.isObject(h)){for(var i in h){if(g.hasOwnProperty(h,i)){this._oData[i]=h[i];}}}};YAHOO.widget.Record._nCount=0;YAHOO.widget.Record.prototype={_nCount:null,_sId:null,_oData:null,getCount:function(){return this._nCount;},getId:function(){return this._sId;},getData:function(h){if(g.isString(h)){return this._oData[h];}else{return this._oData;}},setData:function(h,i){this._oData[h]=i;}};})();(function(){var h=YAHOO.lang,a=YAHOO.util,e=YAHOO.widget,b=YAHOO.env.ua,c=a.Dom,g=a.Event,f=a.DataSourceBase;YAHOO.widget.DataTable=function(i,m,o,k){var l=e.DataTable;
+if(k&&k.scrollable){return new YAHOO.widget.ScrollingDataTable(i,m,o,k);}this._nIndex=l._nCount;this._sId=c.generateId(null,"yui-dt");this._oChainRender=new YAHOO.util.Chain();this._oChainRender.subscribe("end",this._onRenderChainEnd,this,true);this._initConfigs(k);this._initDataSource(o);if(!this._oDataSource){return;}this._initColumnSet(m);if(!this._oColumnSet){return;}this._initRecordSet();if(!this._oRecordSet){}l.superclass.constructor.call(this,i,this.configs);var q=this._initDomElements(i);if(!q){return;}this.showTableMessage(this.get("MSG_LOADING"),l.CLASS_LOADING);this._initEvents();l._nCount++;l._nCurrentCount++;var n={success:this.onDataReturnSetRows,failure:this.onDataReturnSetRows,scope:this,argument:this.getState()};var p=this.get("initialLoad");if(p===true){this._oDataSource.sendRequest(this.get("initialRequest"),n);}else{if(p===false){this.showTableMessage(this.get("MSG_EMPTY"),l.CLASS_EMPTY);}else{var j=p||{};n.argument=j.argument||{};this._oDataSource.sendRequest(j.request,n);}}};var d=e.DataTable;h.augmentObject(d,{CLASS_DATATABLE:"yui-dt",CLASS_LINER:"yui-dt-liner",CLASS_LABEL:"yui-dt-label",CLASS_MESSAGE:"yui-dt-message",CLASS_MASK:"yui-dt-mask",CLASS_DATA:"yui-dt-data",CLASS_COLTARGET:"yui-dt-coltarget",CLASS_RESIZER:"yui-dt-resizer",CLASS_RESIZERLINER:"yui-dt-resizerliner",CLASS_RESIZERPROXY:"yui-dt-resizerproxy",CLASS_EDITOR:"yui-dt-editor",CLASS_EDITOR_SHIM:"yui-dt-editor-shim",CLASS_PAGINATOR:"yui-dt-paginator",CLASS_PAGE:"yui-dt-page",CLASS_DEFAULT:"yui-dt-default",CLASS_PREVIOUS:"yui-dt-previous",CLASS_NEXT:"yui-dt-next",CLASS_FIRST:"yui-dt-first",CLASS_LAST:"yui-dt-last",CLASS_REC:"yui-dt-rec",CLASS_EVEN:"yui-dt-even",CLASS_ODD:"yui-dt-odd",CLASS_SELECTED:"yui-dt-selected",CLASS_HIGHLIGHTED:"yui-dt-highlighted",CLASS_HIDDEN:"yui-dt-hidden",CLASS_DISABLED:"yui-dt-disabled",CLASS_EMPTY:"yui-dt-empty",CLASS_LOADING:"yui-dt-loading",CLASS_ERROR:"yui-dt-error",CLASS_EDITABLE:"yui-dt-editable",CLASS_DRAGGABLE:"yui-dt-draggable",CLASS_RESIZEABLE:"yui-dt-resizeable",CLASS_SCROLLABLE:"yui-dt-scrollable",CLASS_SORTABLE:"yui-dt-sortable",CLASS_ASC:"yui-dt-asc",CLASS_DESC:"yui-dt-desc",CLASS_BUTTON:"yui-dt-button",CLASS_CHECKBOX:"yui-dt-checkbox",CLASS_DROPDOWN:"yui-dt-dropdown",CLASS_RADIO:"yui-dt-radio",_nCount:0,_nCurrentCount:0,_elDynStyleNode:null,_bDynStylesFallback:(b.ie)?true:false,_oDynStyles:{},_cloneObject:function(m){if(!h.isValue(m)){return m;}var p={};if(m instanceof YAHOO.widget.BaseCellEditor){p=m;}else{if(Object.prototype.toString.apply(m)==="[object RegExp]"){p=m;}else{if(h.isFunction(m)){p=m;}else{if(h.isArray(m)){var n=[];for(var l=0,k=m.length;l<k;l++){n[l]=d._cloneObject(m[l]);}p=n;}else{if(h.isObject(m)){for(var j in m){if(h.hasOwnProperty(m,j)){if(h.isValue(m[j])&&h.isObject(m[j])||h.isArray(m[j])){p[j]=d._cloneObject(m[j]);}else{p[j]=m[j];}}}}else{p=m;}}}}}return p;},formatButton:function(i,j,k,n,m){var l=h.isValue(n)?n:"Click";i.innerHTML='<button type="button" class="'+d.CLASS_BUTTON+'">'+l+"</button>";},formatCheckbox:function(i,j,k,n,m){var l=n;l=(l)?' checked="checked"':"";i.innerHTML='<input type="checkbox"'+l+' class="'+d.CLASS_CHECKBOX+'" />';},formatCurrency:function(j,k,l,n,m){var i=m||this;j.innerHTML=a.Number.format(n,l.currencyOptions||i.get("currencyOptions"));},formatDate:function(j,l,m,o,n){var i=n||this,k=m.dateOptions||i.get("dateOptions");j.innerHTML=a.Date.format(o,k,k.locale);},formatDropdown:function(l,u,q,j,t){var s=t||this,r=(h.isValue(j))?j:u.getData(q.field),v=(h.isArray(q.dropdownOptions))?q.dropdownOptions:null,k,p=l.getElementsByTagName("select");if(p.length===0){k=document.createElement("select");k.className=d.CLASS_DROPDOWN;k=l.appendChild(k);g.addListener(k,"change",s._onDropdownChange,s);}k=p[0];if(k){k.innerHTML="";if(v){for(var n=0;n<v.length;n++){var o=v[n];var m=document.createElement("option");m.value=(h.isValue(o.value))?o.value:o;m.innerHTML=(h.isValue(o.text))?o.text:(h.isValue(o.label))?o.label:o;m=k.appendChild(m);if(m.value==r){m.selected=true;}}}else{k.innerHTML='<option selected value="'+r+'">'+r+"</option>";}}else{l.innerHTML=h.isValue(j)?j:"";}},formatEmail:function(i,j,k,m,l){if(h.isString(m)){m=h.escapeHTML(m);i.innerHTML='<a href="mailto:'+m+'">'+m+"</a>";}else{i.innerHTML=h.isValue(m)?h.escapeHTML(m.toString()):"";}},formatLink:function(i,j,k,m,l){if(h.isString(m)){m=h.escapeHTML(m);i.innerHTML='<a href="'+m+'">'+m+"</a>";}else{i.innerHTML=h.isValue(m)?h.escapeHTML(m.toString()):"";}},formatNumber:function(j,k,l,n,m){var i=m||this;j.innerHTML=a.Number.format(n,l.numberOptions||i.get("numberOptions"));},formatRadio:function(j,k,l,o,n){var i=n||this,m=o;m=(m)?' checked="checked"':"";j.innerHTML='<input type="radio"'+m+' name="'+i.getId()+"-col-"+l.getSanitizedKey()+'"'+' class="'+d.CLASS_RADIO+'" />';},formatText:function(i,j,l,n,m){var k=(h.isValue(n))?n:"";i.innerHTML=h.escapeHTML(k.toString());},formatTextarea:function(j,k,m,o,n){var l=(h.isValue(o))?h.escapeHTML(o.toString()):"",i="<textarea>"+l+"</textarea>";j.innerHTML=i;},formatTextbox:function(j,k,m,o,n){var l=(h.isValue(o))?h.escapeHTML(o.toString()):"",i='<input type="text" value="'+l+'" />';j.innerHTML=i;},formatDefault:function(i,j,k,m,l){i.innerHTML=(h.isValue(m)&&m!=="")?m.toString():"&#160;";},validateNumber:function(j){var i=j*1;if(h.isNumber(i)){return i;}else{return undefined;}}});d.Formatter={button:d.formatButton,checkbox:d.formatCheckbox,currency:d.formatCurrency,"date":d.formatDate,dropdown:d.formatDropdown,email:d.formatEmail,link:d.formatLink,"number":d.formatNumber,radio:d.formatRadio,text:d.formatText,textarea:d.formatTextarea,textbox:d.formatTextbox,defaultFormatter:d.formatDefault};h.extend(d,a.Element,{initAttributes:function(i){i=i||{};d.superclass.initAttributes.call(this,i);this.setAttributeConfig("summary",{value:"",validator:h.isString,method:function(j){if(this._elTable){this._elTable.summary=j;}}});this.setAttributeConfig("selectionMode",{value:"standard",validator:h.isString});this.setAttributeConfig("sortedBy",{value:null,validator:function(j){if(j){return(h.isObject(j)&&j.key);
+}else{return(j===null);}},method:function(k){var r=this.get("sortedBy");this._configs.sortedBy.value=k;var j,o,m,q;if(this._elThead){if(r&&r.key&&r.dir){j=this._oColumnSet.getColumn(r.key);o=j.getKeyIndex();var u=j.getThEl();c.removeClass(u,r.dir);this.formatTheadCell(j.getThLinerEl().firstChild,j,k);}if(k){m=(k.column)?k.column:this._oColumnSet.getColumn(k.key);q=m.getKeyIndex();var v=m.getThEl();if(k.dir&&((k.dir=="asc")||(k.dir=="desc"))){var p=(k.dir=="desc")?d.CLASS_DESC:d.CLASS_ASC;c.addClass(v,p);}else{var l=k.dir||d.CLASS_ASC;c.addClass(v,l);}this.formatTheadCell(m.getThLinerEl().firstChild,m,k);}}if(this._elTbody){this._elTbody.style.display="none";var s=this._elTbody.rows,t;for(var n=s.length-1;n>-1;n--){t=s[n].childNodes;if(t[o]){c.removeClass(t[o],r.dir);}if(t[q]){c.addClass(t[q],k.dir);}}this._elTbody.style.display="";}this._clearTrTemplateEl();}});this.setAttributeConfig("paginator",{value:null,validator:function(j){return j===null||j instanceof e.Paginator;},method:function(){this._updatePaginator.apply(this,arguments);}});this.setAttributeConfig("caption",{value:null,validator:h.isString,method:function(j){this._initCaptionEl(j);}});this.setAttributeConfig("draggableColumns",{value:false,validator:h.isBoolean,method:function(j){if(this._elThead){if(j){this._initDraggableColumns();}else{this._destroyDraggableColumns();}}}});this.setAttributeConfig("renderLoopSize",{value:0,validator:h.isNumber});this.setAttributeConfig("sortFunction",{value:function(k,j,o,n){var m=YAHOO.util.Sort.compare,l=m(k.getData(n),j.getData(n),o);if(l===0){return m(k.getCount(),j.getCount(),o);}else{return l;}}});this.setAttributeConfig("formatRow",{value:null,validator:h.isFunction});this.setAttributeConfig("generateRequest",{value:function(k,n){k=k||{pagination:null,sortedBy:null};var m=encodeURIComponent((k.sortedBy)?k.sortedBy.key:n.getColumnSet().keys[0].getKey());var j=(k.sortedBy&&k.sortedBy.dir===YAHOO.widget.DataTable.CLASS_DESC)?"desc":"asc";var o=(k.pagination)?k.pagination.recordOffset:0;var l=(k.pagination)?k.pagination.rowsPerPage:null;return"sort="+m+"&dir="+j+"&startIndex="+o+((l!==null)?"&results="+l:"");},validator:h.isFunction});this.setAttributeConfig("initialRequest",{value:null});this.setAttributeConfig("initialLoad",{value:true});this.setAttributeConfig("dynamicData",{value:false,validator:h.isBoolean});this.setAttributeConfig("MSG_EMPTY",{value:"No records found.",validator:h.isString});this.setAttributeConfig("MSG_LOADING",{value:"Loading...",validator:h.isString});this.setAttributeConfig("MSG_ERROR",{value:"Data error.",validator:h.isString});this.setAttributeConfig("MSG_SORTASC",{value:"Click to sort ascending",validator:h.isString,method:function(k){if(this._elThead){for(var l=0,m=this.getColumnSet().keys,j=m.length;l<j;l++){if(m[l].sortable&&this.getColumnSortDir(m[l])===d.CLASS_ASC){m[l]._elThLabel.firstChild.title=k;}}}}});this.setAttributeConfig("MSG_SORTDESC",{value:"Click to sort descending",validator:h.isString,method:function(k){if(this._elThead){for(var l=0,m=this.getColumnSet().keys,j=m.length;l<j;l++){if(m[l].sortable&&this.getColumnSortDir(m[l])===d.CLASS_DESC){m[l]._elThLabel.firstChild.title=k;}}}}});this.setAttributeConfig("currencySymbol",{value:"$",validator:h.isString});this.setAttributeConfig("currencyOptions",{value:{prefix:this.get("currencySymbol"),decimalPlaces:2,decimalSeparator:".",thousandsSeparator:","}});this.setAttributeConfig("dateOptions",{value:{format:"%m/%d/%Y",locale:"en"}});this.setAttributeConfig("numberOptions",{value:{decimalPlaces:0,thousandsSeparator:","}});},_bInit:true,_nIndex:null,_nTrCount:0,_nTdCount:0,_sId:null,_oChainRender:null,_elContainer:null,_elMask:null,_elTable:null,_elCaption:null,_elColgroup:null,_elThead:null,_elTbody:null,_elMsgTbody:null,_elMsgTr:null,_elMsgTd:null,_elColumnDragTarget:null,_elColumnResizerProxy:null,_oDataSource:null,_oColumnSet:null,_oRecordSet:null,_oCellEditor:null,_sFirstTrId:null,_sLastTrId:null,_elTrTemplate:null,_aDynFunctions:[],_disabled:false,clearTextSelection:function(){var i;if(window.getSelection){i=window.getSelection();}else{if(document.getSelection){i=document.getSelection();}else{if(document.selection){i=document.selection;}}}if(i){if(i.empty){i.empty();}else{if(i.removeAllRanges){i.removeAllRanges();}else{if(i.collapse){i.collapse();}}}}},_focusEl:function(i){i=i||this._elTbody;setTimeout(function(){try{i.focus();}catch(j){}},0);},_repaintGecko:(b.gecko)?function(j){j=j||this._elContainer;var i=j.parentNode;var k=j.nextSibling;i.insertBefore(i.removeChild(j),k);}:function(){},_repaintOpera:(b.opera)?function(){if(b.opera){document.documentElement.className+=" ";document.documentElement.className=YAHOO.lang.trim(document.documentElement.className);}}:function(){},_repaintWebkit:(b.webkit)?function(j){j=j||this._elContainer;var i=j.parentNode;var k=j.nextSibling;i.insertBefore(i.removeChild(j),k);}:function(){},_initConfigs:function(i){if(!i||!h.isObject(i)){i={};}this.configs=i;},_initColumnSet:function(n){var m,k,j;if(this._oColumnSet){for(k=0,j=this._oColumnSet.keys.length;k<j;k++){m=this._oColumnSet.keys[k];d._oDynStyles["."+this.getId()+"-col-"+m.getSanitizedKey()+" ."+d.CLASS_LINER]=undefined;if(m.editor&&m.editor.unsubscribeAll){m.editor.unsubscribeAll();}}this._oColumnSet=null;this._clearTrTemplateEl();}if(h.isArray(n)){this._oColumnSet=new YAHOO.widget.ColumnSet(n);}else{if(n instanceof YAHOO.widget.ColumnSet){this._oColumnSet=n;}}var l=this._oColumnSet.keys;for(k=0,j=l.length;k<j;k++){m=l[k];if(m.editor&&m.editor.subscribe){m.editor.subscribe("showEvent",this._onEditorShowEvent,this,true);m.editor.subscribe("keydownEvent",this._onEditorKeydownEvent,this,true);m.editor.subscribe("revertEvent",this._onEditorRevertEvent,this,true);m.editor.subscribe("saveEvent",this._onEditorSaveEvent,this,true);m.editor.subscribe("cancelEvent",this._onEditorCancelEvent,this,true);m.editor.subscribe("blurEvent",this._onEditorBlurEvent,this,true);m.editor.subscribe("blockEvent",this._onEditorBlockEvent,this,true);
+m.editor.subscribe("unblockEvent",this._onEditorUnblockEvent,this,true);}}},_initDataSource:function(j){this._oDataSource=null;if(j&&(h.isFunction(j.sendRequest))){this._oDataSource=j;}else{var k=null;var o=this._elContainer;var l=0;if(o.hasChildNodes()){var n=o.childNodes;for(l=0;l<n.length;l++){if(n[l].nodeName&&n[l].nodeName.toLowerCase()=="table"){k=n[l];break;}}if(k){var m=[];for(;l<this._oColumnSet.keys.length;l++){m.push({key:this._oColumnSet.keys[l].key});}this._oDataSource=new f(k);this._oDataSource.responseType=f.TYPE_HTMLTABLE;this._oDataSource.responseSchema={fields:m};}}}},_initRecordSet:function(){if(this._oRecordSet){this._oRecordSet.reset();}else{this._oRecordSet=new YAHOO.widget.RecordSet();}},_initDomElements:function(i){this._initContainerEl(i);this._initTableEl(this._elContainer);this._initColgroupEl(this._elTable);this._initTheadEl(this._elTable);this._initMsgTbodyEl(this._elTable);this._initTbodyEl(this._elTable);if(!this._elContainer||!this._elTable||!this._elColgroup||!this._elThead||!this._elTbody||!this._elMsgTbody){return false;}else{return true;}},_destroyContainerEl:function(m){var k=this._oColumnSet.keys,l,j;c.removeClass(m,d.CLASS_DATATABLE);g.purgeElement(m);g.purgeElement(this._elThead,true);g.purgeElement(this._elTbody);g.purgeElement(this._elMsgTbody);l=m.getElementsByTagName("select");if(l.length){g.detachListener(l,"change");}for(j=k.length-1;j>=0;--j){if(k[j].editor){g.purgeElement(k[j].editor._elContainer);}}m.innerHTML="";this._elContainer=null;this._elColgroup=null;this._elThead=null;this._elTbody=null;},_initContainerEl:function(j){j=c.get(j);if(j&&j.nodeName&&(j.nodeName.toLowerCase()=="div")){this._destroyContainerEl(j);c.addClass(j,d.CLASS_DATATABLE);g.addListener(j,"focus",this._onTableFocus,this);g.addListener(j,"dblclick",this._onTableDblclick,this);this._elContainer=j;var i=document.createElement("div");i.className=d.CLASS_MASK;i.style.display="none";this._elMask=j.appendChild(i);}},_destroyTableEl:function(){var i=this._elTable;if(i){g.purgeElement(i,true);i.parentNode.removeChild(i);this._elCaption=null;this._elColgroup=null;this._elThead=null;this._elTbody=null;}},_initCaptionEl:function(i){if(this._elTable&&i){if(!this._elCaption){this._elCaption=this._elTable.createCaption();}this._elCaption.innerHTML=i;}else{if(this._elCaption){this._elCaption.parentNode.removeChild(this._elCaption);}}},_initTableEl:function(i){if(i){this._destroyTableEl();this._elTable=i.appendChild(document.createElement("table"));this._elTable.summary=this.get("summary");if(this.get("caption")){this._initCaptionEl(this.get("caption"));}g.delegate(this._elTable,"mouseenter",this._onTableMouseover,"thead ."+d.CLASS_LABEL,this);g.delegate(this._elTable,"mouseleave",this._onTableMouseout,"thead ."+d.CLASS_LABEL,this);g.delegate(this._elTable,"mouseenter",this._onTableMouseover,"tbody.yui-dt-data>tr>td",this);g.delegate(this._elTable,"mouseleave",this._onTableMouseout,"tbody.yui-dt-data>tr>td",this);g.delegate(this._elTable,"mouseenter",this._onTableMouseover,"tbody.yui-dt-message>tr>td",this);g.delegate(this._elTable,"mouseleave",this._onTableMouseout,"tbody.yui-dt-message>tr>td",this);}},_destroyColgroupEl:function(){var i=this._elColgroup;if(i){var j=i.parentNode;g.purgeElement(i,true);j.removeChild(i);this._elColgroup=null;}},_initColgroupEl:function(s){if(s){this._destroyColgroupEl();var l=this._aColIds||[],r=this._oColumnSet.keys,m=0,p=l.length,j,o,q=document.createDocumentFragment(),n=document.createElement("col");for(m=0,p=r.length;m<p;m++){o=r[m];j=q.appendChild(n.cloneNode(false));}var k=s.insertBefore(document.createElement("colgroup"),s.firstChild);k.appendChild(q);this._elColgroup=k;}},_insertColgroupColEl:function(i){if(h.isNumber(i)&&this._elColgroup){var j=this._elColgroup.childNodes[i]||null;this._elColgroup.insertBefore(document.createElement("col"),j);}},_removeColgroupColEl:function(i){if(h.isNumber(i)&&this._elColgroup&&this._elColgroup.childNodes[i]){this._elColgroup.removeChild(this._elColgroup.childNodes[i]);}},_reorderColgroupColEl:function(l,k){if(h.isArray(l)&&h.isNumber(k)&&this._elColgroup&&(this._elColgroup.childNodes.length>l[l.length-1])){var j,n=[];for(j=l.length-1;j>-1;j--){n.push(this._elColgroup.removeChild(this._elColgroup.childNodes[l[j]]));}var m=this._elColgroup.childNodes[k]||null;for(j=n.length-1;j>-1;j--){this._elColgroup.insertBefore(n[j],m);}}},_destroyTheadEl:function(){var j=this._elThead;if(j){var i=j.parentNode;g.purgeElement(j,true);this._destroyColumnHelpers();i.removeChild(j);this._elThead=null;}},_initTheadEl:function(v){v=v||this._elTable;if(v){this._destroyTheadEl();var q=(this._elColgroup)?v.insertBefore(document.createElement("thead"),this._elColgroup.nextSibling):v.appendChild(document.createElement("thead"));g.addListener(q,"focus",this._onTheadFocus,this);g.addListener(q,"keydown",this._onTheadKeydown,this);g.addListener(q,"mousedown",this._onTableMousedown,this);g.addListener(q,"mouseup",this._onTableMouseup,this);g.addListener(q,"click",this._onTheadClick,this);var x=this._oColumnSet,t,r,p,n;var w=x.tree;var o;for(r=0;r<w.length;r++){var m=q.appendChild(document.createElement("tr"));for(p=0;p<w[r].length;p++){t=w[r][p];o=m.appendChild(document.createElement("th"));this._initThEl(o,t);}if(r===0){c.addClass(m,d.CLASS_FIRST);}if(r===(w.length-1)){c.addClass(m,d.CLASS_LAST);}}var k=x.headers[0]||[];for(r=0;r<k.length;r++){c.addClass(c.get(this.getId()+"-th-"+k[r]),d.CLASS_FIRST);}var s=x.headers[x.headers.length-1]||[];for(r=0;r<s.length;r++){c.addClass(c.get(this.getId()+"-th-"+s[r]),d.CLASS_LAST);}if(b.webkit&&b.webkit<420){var u=this;setTimeout(function(){q.style.display="";},0);q.style.display="none";}this._elThead=q;this._initColumnHelpers();}},_initThEl:function(m,l){m.id=this.getId()+"-th-"+l.getSanitizedKey();m.innerHTML="";m.rowSpan=l.getRowspan();m.colSpan=l.getColspan();l._elTh=m;var i=m.appendChild(document.createElement("div"));i.id=m.id+"-liner";i.className=d.CLASS_LINER;l._elThLiner=i;var j=i.appendChild(document.createElement("span"));
+j.className=d.CLASS_LABEL;if(l.abbr){m.abbr=l.abbr;}if(l.hidden){this._clearMinWidth(l);}m.className=this._getColumnClassNames(l);if(l.width){var k=(l.minWidth&&(l.width<l.minWidth))?l.minWidth:l.width;if(d._bDynStylesFallback){m.firstChild.style.overflow="hidden";m.firstChild.style.width=k+"px";}else{this._setColumnWidthDynStyles(l,k+"px","hidden");}}this.formatTheadCell(j,l,this.get("sortedBy"));l._elThLabel=j;},formatTheadCell:function(i,m,k){var q=m.getKey();var p=h.isValue(m.label)?m.label:q;if(m.sortable){var n=this.getColumnSortDir(m,k);var j=(n===d.CLASS_DESC);if(k&&(m.key===k.key)){j=!(k.dir===d.CLASS_DESC);}var l=this.getId()+"-href-"+m.getSanitizedKey();var o=(j)?this.get("MSG_SORTDESC"):this.get("MSG_SORTASC");i.innerHTML='<a href="'+l+'" title="'+o+'" class="'+d.CLASS_SORTABLE+'">'+p+"</a>";}else{i.innerHTML=p;}},_destroyDraggableColumns:function(){var l,m;for(var k=0,j=this._oColumnSet.tree[0].length;k<j;k++){l=this._oColumnSet.tree[0][k];if(l._dd){l._dd=l._dd.unreg();c.removeClass(l.getThEl(),d.CLASS_DRAGGABLE);}}this._destroyColumnDragTargetEl();},_initDraggableColumns:function(){this._destroyDraggableColumns();if(a.DD){var m,n,k;for(var l=0,j=this._oColumnSet.tree[0].length;l<j;l++){m=this._oColumnSet.tree[0][l];n=m.getThEl();c.addClass(n,d.CLASS_DRAGGABLE);k=this._initColumnDragTargetEl();m._dd=new YAHOO.widget.ColumnDD(this,m,n,k);}}else{}},_destroyColumnDragTargetEl:function(){if(this._elColumnDragTarget){var i=this._elColumnDragTarget;YAHOO.util.Event.purgeElement(i);i.parentNode.removeChild(i);this._elColumnDragTarget=null;}},_initColumnDragTargetEl:function(){if(!this._elColumnDragTarget){var i=document.createElement("div");i.id=this.getId()+"-coltarget";i.className=d.CLASS_COLTARGET;i.style.display="none";document.body.insertBefore(i,document.body.firstChild);this._elColumnDragTarget=i;}return this._elColumnDragTarget;},_destroyResizeableColumns:function(){var k=this._oColumnSet.keys;for(var l=0,j=k.length;l<j;l++){if(k[l]._ddResizer){k[l]._ddResizer=k[l]._ddResizer.unreg();c.removeClass(k[l].getThEl(),d.CLASS_RESIZEABLE);}}this._destroyColumnResizerProxyEl();},_initResizeableColumns:function(){this._destroyResizeableColumns();if(a.DD){var p,k,n,q,j,r,m;for(var l=0,o=this._oColumnSet.keys.length;l<o;l++){p=this._oColumnSet.keys[l];if(p.resizeable){k=p.getThEl();c.addClass(k,d.CLASS_RESIZEABLE);n=p.getThLinerEl();q=k.appendChild(document.createElement("div"));q.className=d.CLASS_RESIZERLINER;q.appendChild(n);j=q.appendChild(document.createElement("div"));j.id=k.id+"-resizer";j.className=d.CLASS_RESIZER;p._elResizer=j;r=this._initColumnResizerProxyEl();p._ddResizer=new YAHOO.util.ColumnResizer(this,p,k,j,r);m=function(i){g.stopPropagation(i);};g.addListener(j,"click",m);}}}else{}},_destroyColumnResizerProxyEl:function(){if(this._elColumnResizerProxy){var i=this._elColumnResizerProxy;YAHOO.util.Event.purgeElement(i);i.parentNode.removeChild(i);this._elColumnResizerProxy=null;}},_initColumnResizerProxyEl:function(){if(!this._elColumnResizerProxy){var i=document.createElement("div");i.id=this.getId()+"-colresizerproxy";i.className=d.CLASS_RESIZERPROXY;document.body.insertBefore(i,document.body.firstChild);this._elColumnResizerProxy=i;}return this._elColumnResizerProxy;},_destroyColumnHelpers:function(){this._destroyDraggableColumns();this._destroyResizeableColumns();},_initColumnHelpers:function(){if(this.get("draggableColumns")){this._initDraggableColumns();}this._initResizeableColumns();},_destroyTbodyEl:function(){var i=this._elTbody;if(i){var j=i.parentNode;g.purgeElement(i,true);j.removeChild(i);this._elTbody=null;}},_initTbodyEl:function(j){if(j){this._destroyTbodyEl();var i=j.appendChild(document.createElement("tbody"));i.tabIndex=0;i.className=d.CLASS_DATA;g.addListener(i,"focus",this._onTbodyFocus,this);g.addListener(i,"mousedown",this._onTableMousedown,this);g.addListener(i,"mouseup",this._onTableMouseup,this);g.addListener(i,"keydown",this._onTbodyKeydown,this);g.addListener(i,"click",this._onTbodyClick,this);if(b.ie){i.hideFocus=true;}this._elTbody=i;}},_destroyMsgTbodyEl:function(){var i=this._elMsgTbody;if(i){var j=i.parentNode;g.purgeElement(i,true);j.removeChild(i);this._elTbody=null;}},_initMsgTbodyEl:function(l){if(l){var k=document.createElement("tbody");k.className=d.CLASS_MESSAGE;var j=k.appendChild(document.createElement("tr"));j.className=d.CLASS_FIRST+" "+d.CLASS_LAST;this._elMsgTr=j;var m=j.appendChild(document.createElement("td"));m.colSpan=this._oColumnSet.keys.length||1;m.className=d.CLASS_FIRST+" "+d.CLASS_LAST;this._elMsgTd=m;k=l.insertBefore(k,this._elTbody);var i=m.appendChild(document.createElement("div"));i.className=d.CLASS_LINER;this._elMsgTbody=k;g.addListener(k,"focus",this._onTbodyFocus,this);g.addListener(k,"mousedown",this._onTableMousedown,this);g.addListener(k,"mouseup",this._onTableMouseup,this);g.addListener(k,"keydown",this._onTbodyKeydown,this);g.addListener(k,"click",this._onTbodyClick,this);}},_initEvents:function(){this._initColumnSort();YAHOO.util.Event.addListener(document,"click",this._onDocumentClick,this);this.subscribe("paginatorChange",function(){this._handlePaginatorChange.apply(this,arguments);});this.subscribe("initEvent",function(){this.renderPaginator();});this._initCellEditing();},_initColumnSort:function(){this.subscribe("theadCellClickEvent",this.onEventSortColumn);var i=this.get("sortedBy");if(i){if(i.dir=="desc"){this._configs.sortedBy.value.dir=d.CLASS_DESC;}else{if(i.dir=="asc"){this._configs.sortedBy.value.dir=d.CLASS_ASC;}}}},_initCellEditing:function(){this.subscribe("editorBlurEvent",function(){this.onEditorBlurEvent.apply(this,arguments);});this.subscribe("editorBlockEvent",function(){this.onEditorBlockEvent.apply(this,arguments);});this.subscribe("editorUnblockEvent",function(){this.onEditorUnblockEvent.apply(this,arguments);});},_getColumnClassNames:function(l,k){var i;if(h.isString(l.className)){i=[l.className];}else{if(h.isArray(l.className)){i=l.className;}else{i=[];}}i[i.length]=this.getId()+"-col-"+l.getSanitizedKey();
+i[i.length]="yui-dt-col-"+l.getSanitizedKey();var j=this.get("sortedBy")||{};if(l.key===j.key){i[i.length]=j.dir||"";}if(l.hidden){i[i.length]=d.CLASS_HIDDEN;}if(l.selected){i[i.length]=d.CLASS_SELECTED;}if(l.sortable){i[i.length]=d.CLASS_SORTABLE;}if(l.resizeable){i[i.length]=d.CLASS_RESIZEABLE;}if(l.editor){i[i.length]=d.CLASS_EDITABLE;}if(k){i=i.concat(k);}return i.join(" ");},_clearTrTemplateEl:function(){this._elTrTemplate=null;},_getTrTemplateEl:function(u,o){if(this._elTrTemplate){return this._elTrTemplate;}else{var q=document,s=q.createElement("tr"),l=q.createElement("td"),k=q.createElement("div");l.appendChild(k);var t=document.createDocumentFragment(),r=this._oColumnSet.keys,n;var p;for(var m=0,j=r.length;m<j;m++){n=l.cloneNode(true);n=this._formatTdEl(r[m],n,m,(m===j-1));t.appendChild(n);}s.appendChild(t);s.className=d.CLASS_REC;this._elTrTemplate=s;return s;}},_formatTdEl:function(n,p,q,m){var t=this._oColumnSet;var i=t.headers,k=i[q],o="",v;for(var l=0,u=k.length;l<u;l++){v=this._sId+"-th-"+k[l]+" ";o+=v;}p.headers=o;var s=[];if(q===0){s[s.length]=d.CLASS_FIRST;}if(m){s[s.length]=d.CLASS_LAST;}p.className=this._getColumnClassNames(n,s);p.firstChild.className=d.CLASS_LINER;if(n.width&&d._bDynStylesFallback){var r=(n.minWidth&&(n.width<n.minWidth))?n.minWidth:n.width;p.firstChild.style.overflow="hidden";p.firstChild.style.width=r+"px";}return p;},_addTrEl:function(k){var j=this._getTrTemplateEl();var i=j.cloneNode(true);return this._updateTrEl(i,k);},_updateTrEl:function(q,r){var p=this.get("formatRow")?this.get("formatRow").call(this,q,r):true;if(p){q.style.display="none";var o=q.childNodes,m;for(var l=0,n=o.length;l<n;++l){m=o[l];this.formatCell(o[l].firstChild,r,this._oColumnSet.keys[l]);}q.style.display="";}var j=q.id,k=r.getId();if(this._sFirstTrId===j){this._sFirstTrId=k;}if(this._sLastTrId===j){this._sLastTrId=k;}q.id=k;return q;},_deleteTrEl:function(i){var j;if(!h.isNumber(i)){j=c.get(i).sectionRowIndex;}else{j=i;}if(h.isNumber(j)&&(j>-2)&&(j<this._elTbody.rows.length)){return this._elTbody.removeChild(this._elTbody.rows[i]);}else{return null;}},_unsetFirstRow:function(){if(this._sFirstTrId){c.removeClass(this._sFirstTrId,d.CLASS_FIRST);this._sFirstTrId=null;}},_setFirstRow:function(){this._unsetFirstRow();var i=this.getFirstTrEl();if(i){c.addClass(i,d.CLASS_FIRST);this._sFirstTrId=i.id;}},_unsetLastRow:function(){if(this._sLastTrId){c.removeClass(this._sLastTrId,d.CLASS_LAST);this._sLastTrId=null;}},_setLastRow:function(){this._unsetLastRow();var i=this.getLastTrEl();if(i){c.addClass(i,d.CLASS_LAST);this._sLastTrId=i.id;}},_setRowStripes:function(t,l){var m=this._elTbody.rows,q=0,s=m.length,p=[],r=0,n=[],j=0;if((t!==null)&&(t!==undefined)){var o=this.getTrEl(t);if(o){q=o.sectionRowIndex;if(h.isNumber(l)&&(l>1)){s=q+l;}}}for(var k=q;k<s;k++){if(k%2){p[r++]=m[k];}else{n[j++]=m[k];}}if(p.length){c.replaceClass(p,d.CLASS_EVEN,d.CLASS_ODD);}if(n.length){c.replaceClass(n,d.CLASS_ODD,d.CLASS_EVEN);}},_setSelections:function(){var l=this.getSelectedRows();var n=this.getSelectedCells();if((l.length>0)||(n.length>0)){var m=this._oColumnSet,k;for(var j=0;j<l.length;j++){k=c.get(l[j]);if(k){c.addClass(k,d.CLASS_SELECTED);}}for(j=0;j<n.length;j++){k=c.get(n[j].recordId);if(k){c.addClass(k.childNodes[m.getColumn(n[j].columnKey).getKeyIndex()],d.CLASS_SELECTED);}}}},_onRenderChainEnd:function(){this.hideTableMessage();if(this._elTbody.rows.length===0){this.showTableMessage(this.get("MSG_EMPTY"),d.CLASS_EMPTY);}var i=this;setTimeout(function(){if((i instanceof d)&&i._sId){if(i._bInit){i._bInit=false;i.fireEvent("initEvent");}i.fireEvent("renderEvent");i.fireEvent("refreshEvent");i.validateColumnWidths();i.fireEvent("postRenderEvent");}},0);},_onDocumentClick:function(l,j){var m=g.getTarget(l);var i=m.nodeName.toLowerCase();if(!c.isAncestor(j._elContainer,m)){j.fireEvent("tableBlurEvent");if(j._oCellEditor){if(j._oCellEditor.getContainerEl){var k=j._oCellEditor.getContainerEl();if(!c.isAncestor(k,m)&&(k.id!==m.id)){j._oCellEditor.fireEvent("blurEvent",{editor:j._oCellEditor});}}else{if(j._oCellEditor.isActive){if(!c.isAncestor(j._oCellEditor.container,m)&&(j._oCellEditor.container.id!==m.id)){j.fireEvent("editorBlurEvent",{editor:j._oCellEditor});}}}}}},_onTableFocus:function(j,i){i.fireEvent("tableFocusEvent");},_onTheadFocus:function(j,i){i.fireEvent("theadFocusEvent");i.fireEvent("tableFocusEvent");},_onTbodyFocus:function(j,i){i.fireEvent("tbodyFocusEvent");i.fireEvent("tableFocusEvent");},_onTableMouseover:function(n,m,i,k){var o=m;var j=o.nodeName&&o.nodeName.toLowerCase();var l=true;while(o&&(j!="table")){switch(j){case"body":return;case"a":break;case"td":l=k.fireEvent("cellMouseoverEvent",{target:o,event:n});break;case"span":if(c.hasClass(o,d.CLASS_LABEL)){l=k.fireEvent("theadLabelMouseoverEvent",{target:o,event:n});l=k.fireEvent("headerLabelMouseoverEvent",{target:o,event:n});}break;case"th":l=k.fireEvent("theadCellMouseoverEvent",{target:o,event:n});l=k.fireEvent("headerCellMouseoverEvent",{target:o,event:n});break;case"tr":if(o.parentNode.nodeName.toLowerCase()=="thead"){l=k.fireEvent("theadRowMouseoverEvent",{target:o,event:n});l=k.fireEvent("headerRowMouseoverEvent",{target:o,event:n});}else{l=k.fireEvent("rowMouseoverEvent",{target:o,event:n});}break;default:break;}if(l===false){return;}else{o=o.parentNode;if(o){j=o.nodeName.toLowerCase();}}}k.fireEvent("tableMouseoverEvent",{target:(o||k._elContainer),event:n});},_onTableMouseout:function(n,m,i,k){var o=m;var j=o.nodeName&&o.nodeName.toLowerCase();var l=true;while(o&&(j!="table")){switch(j){case"body":return;case"a":break;case"td":l=k.fireEvent("cellMouseoutEvent",{target:o,event:n});break;case"span":if(c.hasClass(o,d.CLASS_LABEL)){l=k.fireEvent("theadLabelMouseoutEvent",{target:o,event:n});l=k.fireEvent("headerLabelMouseoutEvent",{target:o,event:n});}break;case"th":l=k.fireEvent("theadCellMouseoutEvent",{target:o,event:n});l=k.fireEvent("headerCellMouseoutEvent",{target:o,event:n});break;case"tr":if(o.parentNode.nodeName.toLowerCase()=="thead"){l=k.fireEvent("theadRowMouseoutEvent",{target:o,event:n});
+l=k.fireEvent("headerRowMouseoutEvent",{target:o,event:n});}else{l=k.fireEvent("rowMouseoutEvent",{target:o,event:n});}break;default:break;}if(l===false){return;}else{o=o.parentNode;if(o){j=o.nodeName.toLowerCase();}}}k.fireEvent("tableMouseoutEvent",{target:(o||k._elContainer),event:n});},_onTableMousedown:function(l,j){var m=g.getTarget(l);var i=m.nodeName&&m.nodeName.toLowerCase();var k=true;while(m&&(i!="table")){switch(i){case"body":return;case"a":break;case"td":k=j.fireEvent("cellMousedownEvent",{target:m,event:l});break;case"span":if(c.hasClass(m,d.CLASS_LABEL)){k=j.fireEvent("theadLabelMousedownEvent",{target:m,event:l});k=j.fireEvent("headerLabelMousedownEvent",{target:m,event:l});}break;case"th":k=j.fireEvent("theadCellMousedownEvent",{target:m,event:l});k=j.fireEvent("headerCellMousedownEvent",{target:m,event:l});break;case"tr":if(m.parentNode.nodeName.toLowerCase()=="thead"){k=j.fireEvent("theadRowMousedownEvent",{target:m,event:l});k=j.fireEvent("headerRowMousedownEvent",{target:m,event:l});}else{k=j.fireEvent("rowMousedownEvent",{target:m,event:l});}break;default:break;}if(k===false){return;}else{m=m.parentNode;if(m){i=m.nodeName.toLowerCase();}}}j.fireEvent("tableMousedownEvent",{target:(m||j._elContainer),event:l});},_onTableMouseup:function(l,j){var m=g.getTarget(l);var i=m.nodeName&&m.nodeName.toLowerCase();var k=true;while(m&&(i!="table")){switch(i){case"body":return;case"a":break;case"td":k=j.fireEvent("cellMouseupEvent",{target:m,event:l});break;case"span":if(c.hasClass(m,d.CLASS_LABEL)){k=j.fireEvent("theadLabelMouseupEvent",{target:m,event:l});k=j.fireEvent("headerLabelMouseupEvent",{target:m,event:l});}break;case"th":k=j.fireEvent("theadCellMouseupEvent",{target:m,event:l});k=j.fireEvent("headerCellMouseupEvent",{target:m,event:l});break;case"tr":if(m.parentNode.nodeName.toLowerCase()=="thead"){k=j.fireEvent("theadRowMouseupEvent",{target:m,event:l});k=j.fireEvent("headerRowMouseupEvent",{target:m,event:l});}else{k=j.fireEvent("rowMouseupEvent",{target:m,event:l});}break;default:break;}if(k===false){return;}else{m=m.parentNode;if(m){i=m.nodeName.toLowerCase();}}}j.fireEvent("tableMouseupEvent",{target:(m||j._elContainer),event:l});},_onTableDblclick:function(l,j){var m=g.getTarget(l);var i=m.nodeName&&m.nodeName.toLowerCase();var k=true;while(m&&(i!="table")){switch(i){case"body":return;case"td":k=j.fireEvent("cellDblclickEvent",{target:m,event:l});break;case"span":if(c.hasClass(m,d.CLASS_LABEL)){k=j.fireEvent("theadLabelDblclickEvent",{target:m,event:l});k=j.fireEvent("headerLabelDblclickEvent",{target:m,event:l});}break;case"th":k=j.fireEvent("theadCellDblclickEvent",{target:m,event:l});k=j.fireEvent("headerCellDblclickEvent",{target:m,event:l});break;case"tr":if(m.parentNode.nodeName.toLowerCase()=="thead"){k=j.fireEvent("theadRowDblclickEvent",{target:m,event:l});k=j.fireEvent("headerRowDblclickEvent",{target:m,event:l});}else{k=j.fireEvent("rowDblclickEvent",{target:m,event:l});}break;default:break;}if(k===false){return;}else{m=m.parentNode;if(m){i=m.nodeName.toLowerCase();}}}j.fireEvent("tableDblclickEvent",{target:(m||j._elContainer),event:l});},_onTheadKeydown:function(l,j){var m=g.getTarget(l);var i=m.nodeName&&m.nodeName.toLowerCase();var k=true;while(m&&(i!="table")){switch(i){case"body":return;case"input":case"textarea":break;case"thead":k=j.fireEvent("theadKeyEvent",{target:m,event:l});break;default:break;}if(k===false){return;}else{m=m.parentNode;if(m){i=m.nodeName.toLowerCase();}}}j.fireEvent("tableKeyEvent",{target:(m||j._elContainer),event:l});},_onTbodyKeydown:function(m,k){var j=k.get("selectionMode");if(j=="standard"){k._handleStandardSelectionByKey(m);}else{if(j=="single"){k._handleSingleSelectionByKey(m);}else{if(j=="cellblock"){k._handleCellBlockSelectionByKey(m);}else{if(j=="cellrange"){k._handleCellRangeSelectionByKey(m);}else{if(j=="singlecell"){k._handleSingleCellSelectionByKey(m);}}}}}if(k._oCellEditor){if(k._oCellEditor.fireEvent){k._oCellEditor.fireEvent("blurEvent",{editor:k._oCellEditor});}else{if(k._oCellEditor.isActive){k.fireEvent("editorBlurEvent",{editor:k._oCellEditor});}}}var n=g.getTarget(m);var i=n.nodeName&&n.nodeName.toLowerCase();var l=true;while(n&&(i!="table")){switch(i){case"body":return;case"tbody":l=k.fireEvent("tbodyKeyEvent",{target:n,event:m});break;default:break;}if(l===false){return;}else{n=n.parentNode;if(n){i=n.nodeName.toLowerCase();}}}k.fireEvent("tableKeyEvent",{target:(n||k._elContainer),event:m});},_onTheadClick:function(l,j){if(j._oCellEditor){if(j._oCellEditor.fireEvent){j._oCellEditor.fireEvent("blurEvent",{editor:j._oCellEditor});}else{if(j._oCellEditor.isActive){j.fireEvent("editorBlurEvent",{editor:j._oCellEditor});}}}var m=g.getTarget(l),i=m.nodeName&&m.nodeName.toLowerCase(),k=true;while(m&&(i!="table")){switch(i){case"body":return;case"input":var n=m.type.toLowerCase();if(n=="checkbox"){k=j.fireEvent("theadCheckboxClickEvent",{target:m,event:l});}else{if(n=="radio"){k=j.fireEvent("theadRadioClickEvent",{target:m,event:l});}else{if((n=="button")||(n=="image")||(n=="submit")||(n=="reset")){if(!m.disabled){k=j.fireEvent("theadButtonClickEvent",{target:m,event:l});}else{k=false;}}else{if(m.disabled){k=false;}}}}break;case"a":k=j.fireEvent("theadLinkClickEvent",{target:m,event:l});break;case"button":if(!m.disabled){k=j.fireEvent("theadButtonClickEvent",{target:m,event:l});}else{k=false;}break;case"span":if(c.hasClass(m,d.CLASS_LABEL)){k=j.fireEvent("theadLabelClickEvent",{target:m,event:l});k=j.fireEvent("headerLabelClickEvent",{target:m,event:l});}break;case"th":k=j.fireEvent("theadCellClickEvent",{target:m,event:l});k=j.fireEvent("headerCellClickEvent",{target:m,event:l});break;case"tr":k=j.fireEvent("theadRowClickEvent",{target:m,event:l});k=j.fireEvent("headerRowClickEvent",{target:m,event:l});break;default:break;}if(k===false){return;}else{m=m.parentNode;if(m){i=m.nodeName.toLowerCase();}}}j.fireEvent("tableClickEvent",{target:(m||j._elContainer),event:l});},_onTbodyClick:function(l,j){if(j._oCellEditor){if(j._oCellEditor.fireEvent){j._oCellEditor.fireEvent("blurEvent",{editor:j._oCellEditor});
+}else{if(j._oCellEditor.isActive){j.fireEvent("editorBlurEvent",{editor:j._oCellEditor});}}}var m=g.getTarget(l),i=m.nodeName&&m.nodeName.toLowerCase(),k=true;while(m&&(i!="table")){switch(i){case"body":return;case"input":var n=m.type.toLowerCase();if(n=="checkbox"){k=j.fireEvent("checkboxClickEvent",{target:m,event:l});}else{if(n=="radio"){k=j.fireEvent("radioClickEvent",{target:m,event:l});}else{if((n=="button")||(n=="image")||(n=="submit")||(n=="reset")){if(!m.disabled){k=j.fireEvent("buttonClickEvent",{target:m,event:l});}else{k=false;}}else{if(m.disabled){k=false;}}}}break;case"a":k=j.fireEvent("linkClickEvent",{target:m,event:l});break;case"button":if(!m.disabled){k=j.fireEvent("buttonClickEvent",{target:m,event:l});}else{k=false;}break;case"td":k=j.fireEvent("cellClickEvent",{target:m,event:l});break;case"tr":k=j.fireEvent("rowClickEvent",{target:m,event:l});break;default:break;}if(k===false){return;}else{m=m.parentNode;if(m){i=m.nodeName.toLowerCase();}}}j.fireEvent("tableClickEvent",{target:(m||j._elContainer),event:l});},_onDropdownChange:function(j,i){var k=g.getTarget(j);i.fireEvent("dropdownChangeEvent",{event:j,target:k});},configs:null,getId:function(){return this._sId;},toString:function(){return"DataTable instance "+this._sId;},getDataSource:function(){return this._oDataSource;},getColumnSet:function(){return this._oColumnSet;},getRecordSet:function(){return this._oRecordSet;},getState:function(){return{totalRecords:this.get("paginator")?this.get("paginator").get("totalRecords"):this._oRecordSet.getLength(),pagination:this.get("paginator")?this.get("paginator").getState():null,sortedBy:this.get("sortedBy"),selectedRows:this.getSelectedRows(),selectedCells:this.getSelectedCells()};},getContainerEl:function(){return this._elContainer;},getTableEl:function(){return this._elTable;},getTheadEl:function(){return this._elThead;},getTbodyEl:function(){return this._elTbody;},getMsgTbodyEl:function(){return this._elMsgTbody;},getMsgTdEl:function(){return this._elMsgTd;},getTrEl:function(k){if(k instanceof YAHOO.widget.Record){return document.getElementById(k.getId());}else{if(h.isNumber(k)){var j=c.getElementsByClassName(d.CLASS_REC,"tr",this._elTbody);return j&&j[k]?j[k]:null;}else{if(k){var i=(h.isString(k))?document.getElementById(k):k;if(i&&i.ownerDocument==document){if(i.nodeName.toLowerCase()!="tr"){i=c.getAncestorByTagName(i,"tr");}return i;}}}}return null;},getFirstTrEl:function(){var k=this._elTbody.rows,j=0;while(k[j]){if(this.getRecord(k[j])){return k[j];}j++;}return null;},getLastTrEl:function(){var k=this._elTbody.rows,j=k.length-1;while(j>-1){if(this.getRecord(k[j])){return k[j];}j--;}return null;},getNextTrEl:function(l,i){var j=this.getTrIndex(l);if(j!==null){var k=this._elTbody.rows;if(i){while(j<k.length-1){l=k[j+1];if(this.getRecord(l)){return l;}j++;}}else{if(j<k.length-1){return k[j+1];}}}return null;},getPreviousTrEl:function(l,i){var j=this.getTrIndex(l);if(j!==null){var k=this._elTbody.rows;if(i){while(j>0){l=k[j-1];if(this.getRecord(l)){return l;}j--;}}else{if(j>0){return k[j-1];}}}return null;},getCellIndex:function(k){k=this.getTdEl(k);if(k){if(b.ie>0){var l=0,n=k.parentNode,m=n.childNodes,j=m.length;for(;l<j;l++){if(m[l]==k){return l;}}}else{return k.cellIndex;}}},getTdLinerEl:function(i){var j=this.getTdEl(i);return j.firstChild||null;},getTdEl:function(i){var n;var l=c.get(i);if(l&&(l.ownerDocument==document)){if(l.nodeName.toLowerCase()!="td"){n=c.getAncestorByTagName(l,"td");}else{n=l;}if(n&&((n.parentNode.parentNode==this._elTbody)||(n.parentNode.parentNode===null)||(n.parentNode.parentNode.nodeType===11))){return n;}}else{if(i){var m,k;if(h.isString(i.columnKey)&&h.isString(i.recordId)){m=this.getRecord(i.recordId);var o=this.getColumn(i.columnKey);if(o){k=o.getKeyIndex();}}if(i.record&&i.column&&i.column.getKeyIndex){m=i.record;k=i.column.getKeyIndex();}var j=this.getTrEl(m);if((k!==null)&&j&&j.cells&&j.cells.length>0){return j.cells[k]||null;}}}return null;},getFirstTdEl:function(j){var i=h.isValue(j)?this.getTrEl(j):this.getFirstTrEl();if(i){if(i.cells&&i.cells.length>0){return i.cells[0];}else{if(i.childNodes&&i.childNodes.length>0){return i.childNodes[0];}}}return null;},getLastTdEl:function(j){var i=h.isValue(j)?this.getTrEl(j):this.getLastTrEl();if(i){if(i.cells&&i.cells.length>0){return i.cells[i.cells.length-1];}else{if(i.childNodes&&i.childNodes.length>0){return i.childNodes[i.childNodes.length-1];}}}return null;},getNextTdEl:function(i){var m=this.getTdEl(i);if(m){var k=this.getCellIndex(m);var j=this.getTrEl(m);if(j.cells&&(j.cells.length)>0&&(k<j.cells.length-1)){return j.cells[k+1];}else{if(j.childNodes&&(j.childNodes.length)>0&&(k<j.childNodes.length-1)){return j.childNodes[k+1];}else{var l=this.getNextTrEl(j);if(l){return l.cells[0];}}}}return null;},getPreviousTdEl:function(i){var m=this.getTdEl(i);if(m){var k=this.getCellIndex(m);var j=this.getTrEl(m);if(k>0){if(j.cells&&j.cells.length>0){return j.cells[k-1];}else{if(j.childNodes&&j.childNodes.length>0){return j.childNodes[k-1];}}}else{var l=this.getPreviousTrEl(j);if(l){return this.getLastTdEl(l);}}}return null;},getAboveTdEl:function(j,i){var m=this.getTdEl(j);if(m){var l=this.getPreviousTrEl(m,i);if(l){var k=this.getCellIndex(m);if(l.cells&&l.cells.length>0){return l.cells[k]?l.cells[k]:null;}else{if(l.childNodes&&l.childNodes.length>0){return l.childNodes[k]?l.childNodes[k]:null;}}}}return null;},getBelowTdEl:function(j,i){var m=this.getTdEl(j);if(m){var l=this.getNextTrEl(m,i);if(l){var k=this.getCellIndex(m);if(l.cells&&l.cells.length>0){return l.cells[k]?l.cells[k]:null;}else{if(l.childNodes&&l.childNodes.length>0){return l.childNodes[k]?l.childNodes[k]:null;}}}}return null;},getThLinerEl:function(j){var i=this.getColumn(j);return(i)?i.getThLinerEl():null;},getThEl:function(k){var l;if(k instanceof YAHOO.widget.Column){var j=k;l=j.getThEl();if(l){return l;}}else{var i=c.get(k);if(i&&(i.ownerDocument==document)){if(i.nodeName.toLowerCase()!="th"){l=c.getAncestorByTagName(i,"th");
+}else{l=i;}return l;}}return null;},getTrIndex:function(m){var i=this.getRecord(m),k=this.getRecordIndex(i),l;if(i){l=this.getTrEl(i);if(l){return l.sectionRowIndex;}else{var j=this.get("paginator");if(j){return j.get("recordOffset")+k;}else{return k;}}}return null;},load:function(i){i=i||{};(i.datasource||this._oDataSource).sendRequest(i.request||this.get("initialRequest"),i.callback||{success:this.onDataReturnInitializeTable,failure:this.onDataReturnInitializeTable,scope:this,argument:this.getState()});},initializeTable:function(){this._bInit=true;this._oRecordSet.reset();var i=this.get("paginator");if(i){i.set("totalRecords",0);}this._unselectAllTrEls();this._unselectAllTdEls();this._aSelections=null;this._oAnchorRecord=null;this._oAnchorCell=null;this.set("sortedBy",null);},_runRenderChain:function(){this._oChainRender.run();},_getViewRecords:function(){var i=this.get("paginator");if(i){return this._oRecordSet.getRecords(i.getStartIndex(),i.getRowsPerPage());}else{return this._oRecordSet.getRecords();}},render:function(){this._oChainRender.stop();this.fireEvent("beforeRenderEvent");var r,p,o,s,l=this._getViewRecords();var m=this._elTbody,q=this.get("renderLoopSize"),t=l.length;if(t>0){m.style.display="none";while(m.lastChild){m.removeChild(m.lastChild);}m.style.display="";this._oChainRender.add({method:function(u){if((this instanceof d)&&this._sId){var k=u.nCurrentRecord,w=((u.nCurrentRecord+u.nLoopLength)>t)?t:(u.nCurrentRecord+u.nLoopLength),j,v;m.style.display="none";for(;k<w;k++){j=c.get(l[k].getId());j=j||this._addTrEl(l[k]);v=m.childNodes[k]||null;m.insertBefore(j,v);}m.style.display="";u.nCurrentRecord=k;}},scope:this,iterations:(q>0)?Math.ceil(t/q):1,argument:{nCurrentRecord:0,nLoopLength:(q>0)?q:t},timeout:(q>0)?0:-1});this._oChainRender.add({method:function(i){if((this instanceof d)&&this._sId){while(m.rows.length>t){m.removeChild(m.lastChild);}this._setFirstRow();this._setLastRow();this._setRowStripes();this._setSelections();}},scope:this,timeout:(q>0)?0:-1});}else{var n=m.rows.length;if(n>0){this._oChainRender.add({method:function(k){if((this instanceof d)&&this._sId){var j=k.nCurrent,v=k.nLoopLength,u=(j-v<0)?0:j-v;m.style.display="none";for(;j>u;j--){m.deleteRow(-1);}m.style.display="";k.nCurrent=j;}},scope:this,iterations:(q>0)?Math.ceil(n/q):1,argument:{nCurrent:n,nLoopLength:(q>0)?q:n},timeout:(q>0)?0:-1});}}this._runRenderChain();},disable:function(){this._disabled=true;var i=this._elTable;var j=this._elMask;j.style.width=i.offsetWidth+"px";j.style.height=i.offsetHeight+"px";j.style.left=i.offsetLeft+"px";j.style.display="";this.fireEvent("disableEvent");},undisable:function(){this._disabled=false;this._elMask.style.display="none";this.fireEvent("undisableEvent");},isDisabled:function(){return this._disabled;},destroy:function(){var k=this.toString();this._oChainRender.stop();this._destroyColumnHelpers();var m;for(var l=0,j=this._oColumnSet.flat.length;l<j;l++){m=this._oColumnSet.flat[l].editor;if(m&&m.destroy){m.destroy();this._oColumnSet.flat[l].editor=null;}}this._destroyPaginator();this._oRecordSet.unsubscribeAll();this.unsubscribeAll();g.removeListener(document,"click",this._onDocumentClick);this._destroyContainerEl(this._elContainer);for(var n in this){if(h.hasOwnProperty(this,n)){this[n]=null;}}d._nCurrentCount--;if(d._nCurrentCount<1){if(d._elDynStyleNode){document.getElementsByTagName("head")[0].removeChild(d._elDynStyleNode);d._elDynStyleNode=null;}}},showTableMessage:function(j,i){var k=this._elMsgTd;if(h.isString(j)){k.firstChild.innerHTML=j;}if(h.isString(i)){k.className=i;}this._elMsgTbody.style.display="";this.fireEvent("tableMsgShowEvent",{html:j,className:i});},hideTableMessage:function(){if(this._elMsgTbody.style.display!="none"){this._elMsgTbody.style.display="none";this._elMsgTbody.parentNode.style.width="";this.fireEvent("tableMsgHideEvent");}},focus:function(){this.focusTbodyEl();},focusTheadEl:function(){this._focusEl(this._elThead);},focusTbodyEl:function(){this._focusEl(this._elTbody);},onShow:function(){this.validateColumnWidths();for(var m=this._oColumnSet.keys,l=0,j=m.length,k;l<j;l++){k=m[l];if(k._ddResizer){k._ddResizer.resetResizerEl();}}},getRecordIndex:function(l){var k;if(!h.isNumber(l)){if(l instanceof YAHOO.widget.Record){return this._oRecordSet.getRecordIndex(l);}else{var j=this.getTrEl(l);if(j){k=j.sectionRowIndex;}}}else{k=l;}if(h.isNumber(k)){var i=this.get("paginator");if(i){return i.get("recordOffset")+k;}else{return k;}}return null;},getRecord:function(k){var j=this._oRecordSet.getRecord(k);if(!j){var i=this.getTrEl(k);if(i){j=this._oRecordSet.getRecord(i.id);}}if(j instanceof YAHOO.widget.Record){return this._oRecordSet.getRecord(j);}else{return null;}},getColumn:function(m){var o=this._oColumnSet.getColumn(m);if(!o){var n=this.getTdEl(m);if(n){o=this._oColumnSet.getColumn(this.getCellIndex(n));}else{n=this.getThEl(m);if(n){var k=this._oColumnSet.flat;for(var l=0,j=k.length;l<j;l++){if(k[l].getThEl().id===n.id){o=k[l];}}}}}if(!o){}return o;},getColumnById:function(i){return this._oColumnSet.getColumnById(i);},getColumnSortDir:function(k,l){if(k.sortOptions&&k.sortOptions.defaultDir){if(k.sortOptions.defaultDir=="asc"){k.sortOptions.defaultDir=d.CLASS_ASC;}else{if(k.sortOptions.defaultDir=="desc"){k.sortOptions.defaultDir=d.CLASS_DESC;}}}var j=(k.sortOptions&&k.sortOptions.defaultDir)?k.sortOptions.defaultDir:d.CLASS_ASC;var i=false;l=l||this.get("sortedBy");if(l&&(l.key===k.key)){i=true;if(l.dir){j=(l.dir===d.CLASS_ASC)?d.CLASS_DESC:d.CLASS_ASC;}else{j=(j===d.CLASS_ASC)?d.CLASS_DESC:d.CLASS_ASC;}}return j;},doBeforeSortColumn:function(j,i){this.showTableMessage(this.get("MSG_LOADING"),d.CLASS_LOADING);return true;},sortColumn:function(m,j){if(m&&(m instanceof YAHOO.widget.Column)){if(!m.sortable){c.addClass(this.getThEl(m),d.CLASS_SORTABLE);}if(j&&(j!==d.CLASS_ASC)&&(j!==d.CLASS_DESC)){j=null;}var n=j||this.getColumnSortDir(m);var l=this.get("sortedBy")||{};var t=(l.key===m.key)?true:false;var p=this.doBeforeSortColumn(m,n);
+if(p){if(this.get("dynamicData")){var s=this.getState();if(s.pagination){s.pagination.recordOffset=0;}s.sortedBy={key:m.key,dir:n};var k=this.get("generateRequest")(s,this);this.unselectAllRows();this.unselectAllCells();var r={success:this.onDataReturnSetRows,failure:this.onDataReturnSetRows,argument:s,scope:this};this._oDataSource.sendRequest(k,r);}else{var i=(m.sortOptions&&h.isFunction(m.sortOptions.sortFunction))?m.sortOptions.sortFunction:null;if(!t||j||i){i=i||this.get("sortFunction");var q=(m.sortOptions&&m.sortOptions.field)?m.sortOptions.field:m.field;this._oRecordSet.sortRecords(i,((n==d.CLASS_DESC)?true:false),q);}else{this._oRecordSet.reverseRecords();}var o=this.get("paginator");if(o){o.setPage(1,true);}this.render();this.set("sortedBy",{key:m.key,dir:n,column:m});}this.fireEvent("columnSortEvent",{column:m,dir:n});return;}}},setColumnWidth:function(j,i){if(!(j instanceof YAHOO.widget.Column)){j=this.getColumn(j);}if(j){if(h.isNumber(i)){i=(i>j.minWidth)?i:j.minWidth;j.width=i;this._setColumnWidth(j,i+"px");this.fireEvent("columnSetWidthEvent",{column:j,width:i});}else{if(i===null){j.width=i;this._setColumnWidth(j,"auto");this.validateColumnWidths(j);this.fireEvent("columnUnsetWidthEvent",{column:j});}}this._clearTrTemplateEl();}else{}},_setColumnWidth:function(j,i,k){if(j&&(j.getKeyIndex()!==null)){k=k||(((i==="")||(i==="auto"))?"visible":"hidden");if(!d._bDynStylesFallback){this._setColumnWidthDynStyles(j,i,k);}else{this._setColumnWidthDynFunction(j,i,k);}}else{}},_setColumnWidthDynStyles:function(m,l,n){var j=d._elDynStyleNode,k;if(!j){j=document.createElement("style");j.type="text/css";j=document.getElementsByTagName("head").item(0).appendChild(j);d._elDynStyleNode=j;}if(j){var i="."+this.getId()+"-col-"+m.getSanitizedKey()+" ."+d.CLASS_LINER;if(this._elTbody){this._elTbody.style.display="none";}k=d._oDynStyles[i];if(!k){if(j.styleSheet&&j.styleSheet.addRule){j.styleSheet.addRule(i,"overflow:"+n);j.styleSheet.addRule(i,"width:"+l);k=j.styleSheet.rules[j.styleSheet.rules.length-1];d._oDynStyles[i]=k;}else{if(j.sheet&&j.sheet.insertRule){j.sheet.insertRule(i+" {overflow:"+n+";width:"+l+";}",j.sheet.cssRules.length);k=j.sheet.cssRules[j.sheet.cssRules.length-1];d._oDynStyles[i]=k;}}}else{k.style.overflow=n;k.style.width=l;}if(this._elTbody){this._elTbody.style.display="";}}if(!k){d._bDynStylesFallback=true;this._setColumnWidthDynFunction(m,l);}},_setColumnWidthDynFunction:function(r,m,s){if(m=="auto"){m="";}var l=this._elTbody?this._elTbody.rows.length:0;if(!this._aDynFunctions[l]){var q,p,o;var t=["var colIdx=oColumn.getKeyIndex();","oColumn.getThLinerEl().style.overflow="];for(q=l-1,p=2;q>=0;--q){t[p++]="this._elTbody.rows[";t[p++]=q;t[p++]="].cells[colIdx].firstChild.style.overflow=";}t[p]="sOverflow;";t[p+1]="oColumn.getThLinerEl().style.width=";for(q=l-1,o=p+2;q>=0;--q){t[o++]="this._elTbody.rows[";t[o++]=q;t[o++]="].cells[colIdx].firstChild.style.width=";}t[o]="sWidth;";this._aDynFunctions[l]=new Function("oColumn","sWidth","sOverflow",t.join(""));}var n=this._aDynFunctions[l];if(n){n.call(this,r,m,s);}},validateColumnWidths:function(o){var l=this._elColgroup;var q=l.cloneNode(true);var p=false;var n=this._oColumnSet.keys;var k;if(o&&!o.hidden&&!o.width&&(o.getKeyIndex()!==null)){k=o.getThLinerEl();if((o.minWidth>0)&&(k.offsetWidth<o.minWidth)){q.childNodes[o.getKeyIndex()].style.width=o.minWidth+(parseInt(c.getStyle(k,"paddingLeft"),10)|0)+(parseInt(c.getStyle(k,"paddingRight"),10)|0)+"px";p=true;}else{if((o.maxAutoWidth>0)&&(k.offsetWidth>o.maxAutoWidth)){this._setColumnWidth(o,o.maxAutoWidth+"px","hidden");}}}else{for(var m=0,j=n.length;m<j;m++){o=n[m];if(!o.hidden&&!o.width){k=o.getThLinerEl();if((o.minWidth>0)&&(k.offsetWidth<o.minWidth)){q.childNodes[m].style.width=o.minWidth+(parseInt(c.getStyle(k,"paddingLeft"),10)|0)+(parseInt(c.getStyle(k,"paddingRight"),10)|0)+"px";p=true;}else{if((o.maxAutoWidth>0)&&(k.offsetWidth>o.maxAutoWidth)){this._setColumnWidth(o,o.maxAutoWidth+"px","hidden");}}}}}if(p){l.parentNode.replaceChild(q,l);this._elColgroup=q;}},_clearMinWidth:function(i){if(i.getKeyIndex()!==null){this._elColgroup.childNodes[i.getKeyIndex()].style.width="";}},_restoreMinWidth:function(i){if(i.minWidth&&(i.getKeyIndex()!==null)){this._elColgroup.childNodes[i.getKeyIndex()].style.width=i.minWidth+"px";}},hideColumn:function(r){if(!(r instanceof YAHOO.widget.Column)){r=this.getColumn(r);}if(r&&!r.hidden&&r.getTreeIndex()!==null){var o=this.getTbodyEl().rows;var n=o.length;var m=this._oColumnSet.getDescendants(r);for(var q=0,s=m.length;q<s;q++){var t=m[q];t.hidden=true;c.addClass(t.getThEl(),d.CLASS_HIDDEN);var k=t.getKeyIndex();if(k!==null){this._clearMinWidth(r);for(var p=0;p<n;p++){c.addClass(o[p].cells[k],d.CLASS_HIDDEN);}}this.fireEvent("columnHideEvent",{column:t});}this._repaintOpera();this._clearTrTemplateEl();}else{}},showColumn:function(r){if(!(r instanceof YAHOO.widget.Column)){r=this.getColumn(r);}if(r&&r.hidden&&(r.getTreeIndex()!==null)){var o=this.getTbodyEl().rows;var n=o.length;var m=this._oColumnSet.getDescendants(r);for(var q=0,s=m.length;q<s;q++){var t=m[q];t.hidden=false;c.removeClass(t.getThEl(),d.CLASS_HIDDEN);var k=t.getKeyIndex();if(k!==null){this._restoreMinWidth(r);for(var p=0;p<n;p++){c.removeClass(o[p].cells[k],d.CLASS_HIDDEN);}}this.fireEvent("columnShowEvent",{column:t});}this._clearTrTemplateEl();}else{}},removeColumn:function(p){if(!(p instanceof YAHOO.widget.Column)){p=this.getColumn(p);}if(p){var m=p.getTreeIndex();if(m!==null){var o,r,q=p.getKeyIndex();if(q===null){var u=[];var j=this._oColumnSet.getDescendants(p);for(o=0,r=j.length;o<r;o++){var s=j[o].getKeyIndex();if(s!==null){u[u.length]=s;}}if(u.length>0){q=u;}}else{q=[q];}if(q!==null){q.sort(function(v,i){return YAHOO.util.Sort.compare(v,i);});this._destroyTheadEl();var k=this._oColumnSet.getDefinitions();p=k.splice(m,1)[0];this._initColumnSet(k);this._initTheadEl();for(o=q.length-1;o>-1;o--){this._removeColgroupColEl(q[o]);}var t=this._elTbody.rows;if(t.length>0){var n=this.get("renderLoopSize"),l=t.length;
+this._oChainRender.add({method:function(y){if((this instanceof d)&&this._sId){var x=y.nCurrentRow,v=n>0?Math.min(x+n,t.length):t.length,z=y.aIndexes,w;for(;x<v;++x){for(w=z.length-1;w>-1;w--){t[x].removeChild(t[x].childNodes[z[w]]);}}y.nCurrentRow=x;}},iterations:(n>0)?Math.ceil(l/n):1,argument:{nCurrentRow:0,aIndexes:q},scope:this,timeout:(n>0)?0:-1});this._runRenderChain();}this.fireEvent("columnRemoveEvent",{column:p});return p;}}}},insertColumn:function(r,s){if(r instanceof YAHOO.widget.Column){r=r.getDefinition();}else{if(r.constructor!==Object){return;}}var x=this._oColumnSet;if(!h.isValue(s)||!h.isNumber(s)){s=x.tree[0].length;}this._destroyTheadEl();var z=this._oColumnSet.getDefinitions();z.splice(s,0,r);this._initColumnSet(z);this._initTheadEl();x=this._oColumnSet;var n=x.tree[0][s];var p,t,w=[];var l=x.getDescendants(n);for(p=0,t=l.length;p<t;p++){var u=l[p].getKeyIndex();if(u!==null){w[w.length]=u;}}if(w.length>0){var y=w.sort(function(A,i){return YAHOO.util.Sort.compare(A,i);})[0];for(p=w.length-1;p>-1;p--){this._insertColgroupColEl(w[p]);}var v=this._elTbody.rows;if(v.length>0){var o=this.get("renderLoopSize"),m=v.length;var k=[],q;for(p=0,t=w.length;p<t;p++){var j=w[p];q=this._getTrTemplateEl().childNodes[p].cloneNode(true);q=this._formatTdEl(this._oColumnSet.keys[j],q,j,(j===this._oColumnSet.keys.length-1));k[j]=q;}this._oChainRender.add({method:function(D){if((this instanceof d)&&this._sId){var C=D.nCurrentRow,B,F=D.descKeyIndexes,A=o>0?Math.min(C+o,v.length):v.length,E;for(;C<A;++C){E=v[C].childNodes[y]||null;for(B=F.length-1;B>-1;B--){v[C].insertBefore(D.aTdTemplates[F[B]].cloneNode(true),E);}}D.nCurrentRow=C;}},iterations:(o>0)?Math.ceil(m/o):1,argument:{nCurrentRow:0,aTdTemplates:k,descKeyIndexes:w},scope:this,timeout:(o>0)?0:-1});this._runRenderChain();}this.fireEvent("columnInsertEvent",{column:r,index:s});return n;}},reorderColumn:function(q,r){if(!(q instanceof YAHOO.widget.Column)){q=this.getColumn(q);}if(q&&YAHOO.lang.isNumber(r)){var z=q.getTreeIndex();if((z!==null)&&(z!==r)){var p,s,l=q.getKeyIndex(),k,v=[],t;if(l===null){k=this._oColumnSet.getDescendants(q);for(p=0,s=k.length;p<s;p++){t=k[p].getKeyIndex();if(t!==null){v[v.length]=t;}}if(v.length>0){l=v;}}else{l=[l];}if(l!==null){l.sort(function(A,i){return YAHOO.util.Sort.compare(A,i);});this._destroyTheadEl();var w=this._oColumnSet.getDefinitions();var j=w.splice(z,1)[0];w.splice(r,0,j);this._initColumnSet(w);this._initTheadEl();var n=this._oColumnSet.tree[0][r];var y=n.getKeyIndex();if(y===null){v=[];k=this._oColumnSet.getDescendants(n);for(p=0,s=k.length;p<s;p++){t=k[p].getKeyIndex();if(t!==null){v[v.length]=t;}}if(v.length>0){y=v;}}else{y=[y];}var x=y.sort(function(A,i){return YAHOO.util.Sort.compare(A,i);})[0];this._reorderColgroupColEl(l,x);var u=this._elTbody.rows;if(u.length>0){var o=this.get("renderLoopSize"),m=u.length;this._oChainRender.add({method:function(D){if((this instanceof d)&&this._sId){var C=D.nCurrentRow,B,F,E,A=o>0?Math.min(C+o,u.length):u.length,H=D.aIndexes,G;for(;C<A;++C){F=[];G=u[C];for(B=H.length-1;B>-1;B--){F.push(G.removeChild(G.childNodes[H[B]]));}E=G.childNodes[x]||null;for(B=F.length-1;B>-1;B--){G.insertBefore(F[B],E);}}D.nCurrentRow=C;}},iterations:(o>0)?Math.ceil(m/o):1,argument:{nCurrentRow:0,aIndexes:l},scope:this,timeout:(o>0)?0:-1});this._runRenderChain();}this.fireEvent("columnReorderEvent",{column:n,oldIndex:z});return n;}}}},selectColumn:function(k){k=this.getColumn(k);if(k&&!k.selected){if(k.getKeyIndex()!==null){k.selected=true;var l=k.getThEl();c.addClass(l,d.CLASS_SELECTED);var j=this.getTbodyEl().rows;var i=this._oChainRender;i.add({method:function(m){if((this instanceof d)&&this._sId&&j[m.rowIndex]&&j[m.rowIndex].cells[m.cellIndex]){c.addClass(j[m.rowIndex].cells[m.cellIndex],d.CLASS_SELECTED);}m.rowIndex++;},scope:this,iterations:j.length,argument:{rowIndex:0,cellIndex:k.getKeyIndex()}});this._clearTrTemplateEl();this._elTbody.style.display="none";this._runRenderChain();this._elTbody.style.display="";this.fireEvent("columnSelectEvent",{column:k});}else{}}},unselectColumn:function(k){k=this.getColumn(k);if(k&&k.selected){if(k.getKeyIndex()!==null){k.selected=false;var l=k.getThEl();c.removeClass(l,d.CLASS_SELECTED);var j=this.getTbodyEl().rows;var i=this._oChainRender;i.add({method:function(m){if((this instanceof d)&&this._sId&&j[m.rowIndex]&&j[m.rowIndex].cells[m.cellIndex]){c.removeClass(j[m.rowIndex].cells[m.cellIndex],d.CLASS_SELECTED);}m.rowIndex++;},scope:this,iterations:j.length,argument:{rowIndex:0,cellIndex:k.getKeyIndex()}});this._clearTrTemplateEl();this._elTbody.style.display="none";this._runRenderChain();this._elTbody.style.display="";this.fireEvent("columnUnselectEvent",{column:k});}else{}}},getSelectedColumns:function(n){var k=[];var l=this._oColumnSet.keys;for(var m=0,j=l.length;m<j;m++){if(l[m].selected){k[k.length]=l[m];}}return k;},highlightColumn:function(i){var l=this.getColumn(i);if(l&&(l.getKeyIndex()!==null)){var m=l.getThEl();c.addClass(m,d.CLASS_HIGHLIGHTED);var k=this.getTbodyEl().rows;var j=this._oChainRender;j.add({method:function(n){if((this instanceof d)&&this._sId&&k[n.rowIndex]&&k[n.rowIndex].cells[n.cellIndex]){c.addClass(k[n.rowIndex].cells[n.cellIndex],d.CLASS_HIGHLIGHTED);}n.rowIndex++;},scope:this,iterations:k.length,argument:{rowIndex:0,cellIndex:l.getKeyIndex()},timeout:-1});this._elTbody.style.display="none";this._runRenderChain();this._elTbody.style.display="";this.fireEvent("columnHighlightEvent",{column:l});}else{}},unhighlightColumn:function(i){var l=this.getColumn(i);if(l&&(l.getKeyIndex()!==null)){var m=l.getThEl();c.removeClass(m,d.CLASS_HIGHLIGHTED);var k=this.getTbodyEl().rows;var j=this._oChainRender;j.add({method:function(n){if((this instanceof d)&&this._sId&&k[n.rowIndex]&&k[n.rowIndex].cells[n.cellIndex]){c.removeClass(k[n.rowIndex].cells[n.cellIndex],d.CLASS_HIGHLIGHTED);}n.rowIndex++;},scope:this,iterations:k.length,argument:{rowIndex:0,cellIndex:l.getKeyIndex()},timeout:-1});this._elTbody.style.display="none";
+this._runRenderChain();this._elTbody.style.display="";this.fireEvent("columnUnhighlightEvent",{column:l});}else{}},addRow:function(o,k){if(h.isNumber(k)&&(k<0||k>this._oRecordSet.getLength())){return;}if(o&&h.isObject(o)){var m=this._oRecordSet.addRecord(o,k);if(m){var i;var j=this.get("paginator");if(j){var n=j.get("totalRecords");if(n!==e.Paginator.VALUE_UNLIMITED){j.set("totalRecords",n+1);}i=this.getRecordIndex(m);var l=(j.getPageRecords())[1];if(i<=l){this.render();}this.fireEvent("rowAddEvent",{record:m});return;}else{i=this.getRecordIndex(m);if(h.isNumber(i)){this._oChainRender.add({method:function(r){if((this instanceof d)&&this._sId){var s=r.record;var p=r.recIndex;var t=this._addTrEl(s);if(t){var q=(this._elTbody.rows[p])?this._elTbody.rows[p]:null;this._elTbody.insertBefore(t,q);if(p===0){this._setFirstRow();}if(q===null){this._setLastRow();}this._setRowStripes();this.hideTableMessage();this.fireEvent("rowAddEvent",{record:s});}}},argument:{record:m,recIndex:i},scope:this,timeout:(this.get("renderLoopSize")>0)?0:-1});this._runRenderChain();return;}}}}},addRows:function(k,n){if(h.isNumber(n)&&(n<0||n>this._oRecordSet.getLength())){return;}if(h.isArray(k)){var o=this._oRecordSet.addRecords(k,n);if(o){var s=this.getRecordIndex(o[0]);var r=this.get("paginator");if(r){var p=r.get("totalRecords");if(p!==e.Paginator.VALUE_UNLIMITED){r.set("totalRecords",p+o.length);}var q=(r.getPageRecords())[1];if(s<=q){this.render();}this.fireEvent("rowsAddEvent",{records:o});return;}else{var m=this.get("renderLoopSize");var j=s+k.length;var i=(j-s);var l=(s>=this._elTbody.rows.length);this._oChainRender.add({method:function(x){if((this instanceof d)&&this._sId){var y=x.aRecords,w=x.nCurrentRow,v=x.nCurrentRecord,t=m>0?Math.min(w+m,j):j,z=document.createDocumentFragment(),u=(this._elTbody.rows[w])?this._elTbody.rows[w]:null;for(;w<t;w++,v++){z.appendChild(this._addTrEl(y[v]));}this._elTbody.insertBefore(z,u);x.nCurrentRow=w;x.nCurrentRecord=v;}},iterations:(m>0)?Math.ceil(j/m):1,argument:{nCurrentRow:s,nCurrentRecord:0,aRecords:o},scope:this,timeout:(m>0)?0:-1});this._oChainRender.add({method:function(u){var t=u.recIndex;if(t===0){this._setFirstRow();}if(u.isLast){this._setLastRow();}this._setRowStripes();this.fireEvent("rowsAddEvent",{records:o});},argument:{recIndex:s,isLast:l},scope:this,timeout:-1});this._runRenderChain();this.hideTableMessage();return;}}}},updateRow:function(u,k){var r=u;if(!h.isNumber(r)){r=this.getRecordIndex(u);}if(h.isNumber(r)&&(r>=0)){var s=this._oRecordSet,q=s.getRecord(r);if(q){var o=this._oRecordSet.setRecord(k,r),j=this.getTrEl(q),p=q?q.getData():null;if(o){var t=this._aSelections||[],n=0,l=q.getId(),m=o.getId();for(;n<t.length;n++){if((t[n]===l)){t[n]=m;}else{if(t[n].recordId===l){t[n].recordId=m;}}}if(this._oAnchorRecord&&this._oAnchorRecord.getId()===l){this._oAnchorRecord=o;}if(this._oAnchorCell&&this._oAnchorCell.record.getId()===l){this._oAnchorCell.record=o;}this._oChainRender.add({method:function(){if((this instanceof d)&&this._sId){var v=this.get("paginator");if(v){var i=(v.getPageRecords())[0],w=(v.getPageRecords())[1];if((r>=i)||(r<=w)){this.render();}}else{if(j){this._updateTrEl(j,o);}else{this.getTbodyEl().appendChild(this._addTrEl(o));}}this.fireEvent("rowUpdateEvent",{record:o,oldData:p});}},scope:this,timeout:(this.get("renderLoopSize")>0)?0:-1});this._runRenderChain();return;}}}return;},updateRows:function(A,m){if(h.isArray(m)){var s=A,l=this._oRecordSet,o=l.getLength();if(!h.isNumber(A)){s=this.getRecordIndex(A);}if(h.isNumber(s)&&(s>=0)&&(s<l.getLength())){var E=s+m.length,B=l.getRecords(s,m.length),G=l.setRecords(m,s);if(G){var t=this._aSelections||[],D=0,C,u,x,z,y=this._oAnchorRecord?this._oAnchorRecord.getId():null,n=this._oAnchorCell?this._oAnchorCell.record.getId():null;for(;D<B.length;D++){z=B[D].getId();u=G[D];x=u.getId();for(C=0;C<t.length;C++){if((t[C]===z)){t[C]=x;}else{if(t[C].recordId===z){t[C].recordId=x;}}}if(y&&y===z){this._oAnchorRecord=u;}if(n&&n===z){this._oAnchorCell.record=u;}}var F=this.get("paginator");if(F){var r=(F.getPageRecords())[0],p=(F.getPageRecords())[1];if((s>=r)||(E<=p)){this.render();}this.fireEvent("rowsAddEvent",{newRecords:G,oldRecords:B});return;}else{var k=this.get("renderLoopSize"),v=m.length,w=(E>=o),q=(E>o);this._oChainRender.add({method:function(K){if((this instanceof d)&&this._sId){var L=K.aRecords,J=K.nCurrentRow,I=K.nDataPointer,H=k>0?Math.min(J+k,s+L.length):s+L.length;for(;J<H;J++,I++){if(q&&(J>=o)){this._elTbody.appendChild(this._addTrEl(L[I]));}else{this._updateTrEl(this._elTbody.rows[J],L[I]);}}K.nCurrentRow=J;K.nDataPointer=I;}},iterations:(k>0)?Math.ceil(v/k):1,argument:{nCurrentRow:s,aRecords:G,nDataPointer:0,isAdding:q},scope:this,timeout:(k>0)?0:-1});this._oChainRender.add({method:function(j){var i=j.recIndex;if(i===0){this._setFirstRow();}if(j.isLast){this._setLastRow();}this._setRowStripes();this.fireEvent("rowsAddEvent",{newRecords:G,oldRecords:B});},argument:{recIndex:s,isLast:w},scope:this,timeout:-1});this._runRenderChain();this.hideTableMessage();return;}}}}},deleteRow:function(s){var k=(h.isNumber(s))?s:this.getRecordIndex(s);if(h.isNumber(k)){var t=this.getRecord(k);if(t){var m=this.getTrIndex(k);var p=t.getId();var r=this._aSelections||[];for(var n=r.length-1;n>-1;n--){if((h.isString(r[n])&&(r[n]===p))||(h.isObject(r[n])&&(r[n].recordId===p))){r.splice(n,1);}}var l=this._oRecordSet.deleteRecord(k);if(l){var q=this.get("paginator");if(q){var o=q.get("totalRecords"),i=q.getPageRecords();if(o!==e.Paginator.VALUE_UNLIMITED){q.set("totalRecords",o-1);}if(!i||k<=i[1]){this.render();}this._oChainRender.add({method:function(){if((this instanceof d)&&this._sId){this.fireEvent("rowDeleteEvent",{recordIndex:k,oldData:l,trElIndex:m});}},scope:this,timeout:(this.get("renderLoopSize")>0)?0:-1});this._runRenderChain();}else{if(h.isNumber(m)){this._oChainRender.add({method:function(){if((this instanceof d)&&this._sId){var j=(k===this._oRecordSet.getLength());this._deleteTrEl(m);if(this._elTbody.rows.length>0){if(m===0){this._setFirstRow();
+}if(j){this._setLastRow();}if(m!=this._elTbody.rows.length){this._setRowStripes(m);}}this.fireEvent("rowDeleteEvent",{recordIndex:k,oldData:l,trElIndex:m});}},scope:this,timeout:(this.get("renderLoopSize")>0)?0:-1});this._runRenderChain();return;}}}}}return null;},deleteRows:function(y,s){var l=(h.isNumber(y))?y:this.getRecordIndex(y);if(h.isNumber(l)){var z=this.getRecord(l);if(z){var m=this.getTrIndex(l);var u=z.getId();var x=this._aSelections||[];for(var q=x.length-1;q>-1;q--){if((h.isString(x[q])&&(x[q]===u))||(h.isObject(x[q])&&(x[q].recordId===u))){x.splice(q,1);}}var n=l;var w=l;if(s&&h.isNumber(s)){n=(s>0)?l+s-1:l;w=(s>0)?l:l+s+1;s=(s>0)?s:s*-1;if(w<0){w=0;s=n-w+1;}}else{s=1;}var p=this._oRecordSet.deleteRecords(w,s);if(p){var v=this.get("paginator"),r=this.get("renderLoopSize");if(v){var t=v.get("totalRecords"),k=v.getPageRecords();if(t!==e.Paginator.VALUE_UNLIMITED){v.set("totalRecords",t-p.length);}if(!k||w<=k[1]){this.render();}this._oChainRender.add({method:function(j){if((this instanceof d)&&this._sId){this.fireEvent("rowsDeleteEvent",{recordIndex:w,oldData:p,count:s});}},scope:this,timeout:(r>0)?0:-1});this._runRenderChain();return;}else{if(h.isNumber(m)){var o=w;var i=s;this._oChainRender.add({method:function(B){if((this instanceof d)&&this._sId){var A=B.nCurrentRow,j=(r>0)?(Math.max(A-r,o)-1):o-1;for(;A>j;--A){this._deleteTrEl(A);}B.nCurrentRow=A;}},iterations:(r>0)?Math.ceil(s/r):1,argument:{nCurrentRow:n},scope:this,timeout:(r>0)?0:-1});this._oChainRender.add({method:function(){if(this._elTbody.rows.length>0){this._setFirstRow();this._setLastRow();this._setRowStripes();}this.fireEvent("rowsDeleteEvent",{recordIndex:w,oldData:p,count:s});},scope:this,timeout:-1});this._runRenderChain();return;}}}}}return null;},formatCell:function(j,l,m){if(!l){l=this.getRecord(j);}if(!m){m=this.getColumn(this.getCellIndex(j.parentNode));}if(l&&m){var i=m.field;var n=l.getData(i);var k=typeof m.formatter==="function"?m.formatter:d.Formatter[m.formatter+""]||d.Formatter.defaultFormatter;if(k){k.call(this,j,l,m,n);}else{j.innerHTML=n;}this.fireEvent("cellFormatEvent",{record:l,column:m,key:m.key,el:j});}else{}},updateCell:function(k,m,o,j){m=(m instanceof YAHOO.widget.Column)?m:this.getColumn(m);if(m&&m.getField()&&(k instanceof YAHOO.widget.Record)){var l=m.getField(),n=k.getData(l);this._oRecordSet.updateRecordValue(k,l,o);var i=this.getTdEl({record:k,column:m});if(i){this._oChainRender.add({method:function(){if((this instanceof d)&&this._sId){this.formatCell(i.firstChild,k,m);this.fireEvent("cellUpdateEvent",{record:k,column:m,oldData:n});}},scope:this,timeout:(this.get("renderLoopSize")>0)?0:-1});if(!j){this._runRenderChain();}}else{this.fireEvent("cellUpdateEvent",{record:k,column:m,oldData:n});}}},_updatePaginator:function(j){var i=this.get("paginator");if(i&&j!==i){i.unsubscribe("changeRequest",this.onPaginatorChangeRequest,this,true);}if(j){j.subscribe("changeRequest",this.onPaginatorChangeRequest,this,true);}},_handlePaginatorChange:function(l){if(l.prevValue===l.newValue){return;}var n=l.newValue,m=l.prevValue,k=this._defaultPaginatorContainers();if(m){if(m.getContainerNodes()[0]==k[0]){m.set("containers",[]);}m.destroy();if(k[0]){if(n&&!n.getContainerNodes().length){n.set("containers",k);}else{for(var j=k.length-1;j>=0;--j){if(k[j]){k[j].parentNode.removeChild(k[j]);}}}}}if(!this._bInit){this.render();}if(n){this.renderPaginator();}},_defaultPaginatorContainers:function(l){var j=this._sId+"-paginator0",k=this._sId+"-paginator1",i=c.get(j),m=c.get(k);if(l&&(!i||!m)){if(!i){i=document.createElement("div");i.id=j;c.addClass(i,d.CLASS_PAGINATOR);this._elContainer.insertBefore(i,this._elContainer.firstChild);}if(!m){m=document.createElement("div");m.id=k;c.addClass(m,d.CLASS_PAGINATOR);this._elContainer.appendChild(m);}}return[i,m];},_destroyPaginator:function(){var i=this.get("paginator");if(i){i.destroy();}},renderPaginator:function(){var i=this.get("paginator");if(!i){return;}if(!i.getContainerNodes().length){i.set("containers",this._defaultPaginatorContainers(true));}i.render();},doBeforePaginatorChange:function(i){this.showTableMessage(this.get("MSG_LOADING"),d.CLASS_LOADING);return true;},onPaginatorChangeRequest:function(l){var j=this.doBeforePaginatorChange(l);if(j){if(this.get("dynamicData")){var i=this.getState();i.pagination=l;var k=this.get("generateRequest")(i,this);this.unselectAllRows();this.unselectAllCells();var m={success:this.onDataReturnSetRows,failure:this.onDataReturnSetRows,argument:i,scope:this};this._oDataSource.sendRequest(k,m);}else{l.paginator.setStartIndex(l.recordOffset,true);l.paginator.setRowsPerPage(l.rowsPerPage,true);this.render();}}else{}},_elLastHighlightedTd:null,_aSelections:null,_oAnchorRecord:null,_oAnchorCell:null,_unselectAllTrEls:function(){var i=c.getElementsByClassName(d.CLASS_SELECTED,"tr",this._elTbody);c.removeClass(i,d.CLASS_SELECTED);},_getSelectionTrigger:function(){var l=this.get("selectionMode");var k={};var o,i,j,n,m;if((l=="cellblock")||(l=="cellrange")||(l=="singlecell")){o=this.getLastSelectedCell();if(!o){return null;}else{i=this.getRecord(o.recordId);j=this.getRecordIndex(i);n=this.getTrEl(i);m=this.getTrIndex(n);if(m===null){return null;}else{k.record=i;k.recordIndex=j;k.el=this.getTdEl(o);k.trIndex=m;k.column=this.getColumn(o.columnKey);k.colKeyIndex=k.column.getKeyIndex();k.cell=o;return k;}}}else{i=this.getLastSelectedRecord();if(!i){return null;}else{i=this.getRecord(i);j=this.getRecordIndex(i);n=this.getTrEl(i);m=this.getTrIndex(n);if(m===null){return null;}else{k.record=i;k.recordIndex=j;k.el=n;k.trIndex=m;return k;}}}},_getSelectionAnchor:function(k){var j=this.get("selectionMode");var l={};var m,o,i;if((j=="cellblock")||(j=="cellrange")||(j=="singlecell")){var n=this._oAnchorCell;if(!n){if(k){n=this._oAnchorCell=k.cell;}else{return null;}}m=this._oAnchorCell.record;o=this._oRecordSet.getRecordIndex(m);i=this.getTrIndex(m);if(i===null){if(o<this.getRecordIndex(this.getFirstTrEl())){i=0;}else{i=this.getRecordIndex(this.getLastTrEl());
+}}l.record=m;l.recordIndex=o;l.trIndex=i;l.column=this._oAnchorCell.column;l.colKeyIndex=l.column.getKeyIndex();l.cell=n;return l;}else{m=this._oAnchorRecord;if(!m){if(k){m=this._oAnchorRecord=k.record;}else{return null;}}o=this.getRecordIndex(m);i=this.getTrIndex(m);if(i===null){if(o<this.getRecordIndex(this.getFirstTrEl())){i=0;}else{i=this.getRecordIndex(this.getLastTrEl());}}l.record=m;l.recordIndex=o;l.trIndex=i;return l;}},_handleStandardSelectionByMouse:function(k){var j=k.target;var m=this.getTrEl(j);if(m){var p=k.event;var s=p.shiftKey;var o=p.ctrlKey||((navigator.userAgent.toLowerCase().indexOf("mac")!=-1)&&p.metaKey);var r=this.getRecord(m);var l=this._oRecordSet.getRecordIndex(r);var q=this._getSelectionAnchor();var n;if(s&&o){if(q){if(this.isSelected(q.record)){if(q.recordIndex<l){for(n=q.recordIndex+1;n<=l;n++){if(!this.isSelected(n)){this.selectRow(n);}}}else{for(n=q.recordIndex-1;n>=l;n--){if(!this.isSelected(n)){this.selectRow(n);}}}}else{if(q.recordIndex<l){for(n=q.recordIndex+1;n<=l-1;n++){if(this.isSelected(n)){this.unselectRow(n);}}}else{for(n=l+1;n<=q.recordIndex-1;n++){if(this.isSelected(n)){this.unselectRow(n);}}}this.selectRow(r);}}else{this._oAnchorRecord=r;if(this.isSelected(r)){this.unselectRow(r);}else{this.selectRow(r);}}}else{if(s){this.unselectAllRows();if(q){if(q.recordIndex<l){for(n=q.recordIndex;n<=l;n++){this.selectRow(n);}}else{for(n=q.recordIndex;n>=l;n--){this.selectRow(n);}}}else{this._oAnchorRecord=r;this.selectRow(r);}}else{if(o){this._oAnchorRecord=r;if(this.isSelected(r)){this.unselectRow(r);}else{this.selectRow(r);}}else{this._handleSingleSelectionByMouse(k);return;}}}}},_handleStandardSelectionByKey:function(m){var i=g.getCharCode(m);if((i==38)||(i==40)){var k=m.shiftKey;var j=this._getSelectionTrigger();if(!j){return null;}g.stopEvent(m);var l=this._getSelectionAnchor(j);if(k){if((i==40)&&(l.recordIndex<=j.trIndex)){this.selectRow(this.getNextTrEl(j.el));}else{if((i==38)&&(l.recordIndex>=j.trIndex)){this.selectRow(this.getPreviousTrEl(j.el));}else{this.unselectRow(j.el);}}}else{this._handleSingleSelectionByKey(m);}}},_handleSingleSelectionByMouse:function(k){var l=k.target;var j=this.getTrEl(l);if(j){var i=this.getRecord(j);this._oAnchorRecord=i;this.unselectAllRows();this.selectRow(i);}},_handleSingleSelectionByKey:function(l){var i=g.getCharCode(l);if((i==38)||(i==40)){var j=this._getSelectionTrigger();if(!j){return null;}g.stopEvent(l);var k;if(i==38){k=this.getPreviousTrEl(j.el);if(k===null){k=this.getFirstTrEl();}}else{if(i==40){k=this.getNextTrEl(j.el);if(k===null){k=this.getLastTrEl();}}}this.unselectAllRows();this.selectRow(k);this._oAnchorRecord=this.getRecord(k);}},_handleCellBlockSelectionByMouse:function(A){var B=A.target;var l=this.getTdEl(B);if(l){var z=A.event;var q=z.shiftKey;var m=z.ctrlKey||((navigator.userAgent.toLowerCase().indexOf("mac")!=-1)&&z.metaKey);var s=this.getTrEl(l);var r=this.getTrIndex(s);var v=this.getColumn(l);var w=v.getKeyIndex();var u=this.getRecord(s);var D=this._oRecordSet.getRecordIndex(u);var p={record:u,column:v};var t=this._getSelectionAnchor();var o=this.getTbodyEl().rows;var n,k,C,y,x;if(q&&m){if(t){if(this.isSelected(t.cell)){if(t.recordIndex===D){if(t.colKeyIndex<w){for(y=t.colKeyIndex+1;y<=w;y++){this.selectCell(s.cells[y]);}}else{if(w<t.colKeyIndex){for(y=w;y<t.colKeyIndex;y++){this.selectCell(s.cells[y]);}}}}else{if(t.recordIndex<D){n=Math.min(t.colKeyIndex,w);k=Math.max(t.colKeyIndex,w);for(y=t.trIndex;y<=r;y++){for(x=n;x<=k;x++){this.selectCell(o[y].cells[x]);}}}else{n=Math.min(t.trIndex,w);k=Math.max(t.trIndex,w);for(y=t.trIndex;y>=r;y--){for(x=k;x>=n;x--){this.selectCell(o[y].cells[x]);}}}}}else{if(t.recordIndex===D){if(t.colKeyIndex<w){for(y=t.colKeyIndex+1;y<w;y++){this.unselectCell(s.cells[y]);}}else{if(w<t.colKeyIndex){for(y=w+1;y<t.colKeyIndex;y++){this.unselectCell(s.cells[y]);}}}}if(t.recordIndex<D){for(y=t.trIndex;y<=r;y++){C=o[y];for(x=0;x<C.cells.length;x++){if(C.sectionRowIndex===t.trIndex){if(x>t.colKeyIndex){this.unselectCell(C.cells[x]);}}else{if(C.sectionRowIndex===r){if(x<w){this.unselectCell(C.cells[x]);}}else{this.unselectCell(C.cells[x]);}}}}}else{for(y=r;y<=t.trIndex;y++){C=o[y];for(x=0;x<C.cells.length;x++){if(C.sectionRowIndex==r){if(x>w){this.unselectCell(C.cells[x]);}}else{if(C.sectionRowIndex==t.trIndex){if(x<t.colKeyIndex){this.unselectCell(C.cells[x]);}}else{this.unselectCell(C.cells[x]);}}}}}this.selectCell(l);}}else{this._oAnchorCell=p;if(this.isSelected(p)){this.unselectCell(p);}else{this.selectCell(p);}}}else{if(q){this.unselectAllCells();if(t){if(t.recordIndex===D){if(t.colKeyIndex<w){for(y=t.colKeyIndex;y<=w;y++){this.selectCell(s.cells[y]);}}else{if(w<t.colKeyIndex){for(y=w;y<=t.colKeyIndex;y++){this.selectCell(s.cells[y]);}}}}else{if(t.recordIndex<D){n=Math.min(t.colKeyIndex,w);k=Math.max(t.colKeyIndex,w);for(y=t.trIndex;y<=r;y++){for(x=n;x<=k;x++){this.selectCell(o[y].cells[x]);}}}else{n=Math.min(t.colKeyIndex,w);k=Math.max(t.colKeyIndex,w);for(y=r;y<=t.trIndex;y++){for(x=n;x<=k;x++){this.selectCell(o[y].cells[x]);}}}}}else{this._oAnchorCell=p;this.selectCell(p);}}else{if(m){this._oAnchorCell=p;if(this.isSelected(p)){this.unselectCell(p);}else{this.selectCell(p);}}else{this._handleSingleCellSelectionByMouse(A);}}}}},_handleCellBlockSelectionByKey:function(o){var j=g.getCharCode(o);var t=o.shiftKey;if((j==9)||!t){this._handleSingleCellSelectionByKey(o);return;}if((j>36)&&(j<41)){var u=this._getSelectionTrigger();if(!u){return null;}g.stopEvent(o);var r=this._getSelectionAnchor(u);var k,s,l,q,m;var p=this.getTbodyEl().rows;var n=u.el.parentNode;if(j==40){if(r.recordIndex<=u.recordIndex){m=this.getNextTrEl(u.el);if(m){s=r.colKeyIndex;l=u.colKeyIndex;if(s>l){for(k=s;k>=l;k--){q=m.cells[k];this.selectCell(q);}}else{for(k=s;k<=l;k++){q=m.cells[k];this.selectCell(q);}}}}else{s=Math.min(r.colKeyIndex,u.colKeyIndex);l=Math.max(r.colKeyIndex,u.colKeyIndex);for(k=s;k<=l;k++){this.unselectCell(n.cells[k]);}}}else{if(j==38){if(r.recordIndex>=u.recordIndex){m=this.getPreviousTrEl(u.el);
+if(m){s=r.colKeyIndex;l=u.colKeyIndex;if(s>l){for(k=s;k>=l;k--){q=m.cells[k];this.selectCell(q);}}else{for(k=s;k<=l;k++){q=m.cells[k];this.selectCell(q);}}}}else{s=Math.min(r.colKeyIndex,u.colKeyIndex);l=Math.max(r.colKeyIndex,u.colKeyIndex);for(k=s;k<=l;k++){this.unselectCell(n.cells[k]);}}}else{if(j==39){if(r.colKeyIndex<=u.colKeyIndex){if(u.colKeyIndex<n.cells.length-1){s=r.trIndex;l=u.trIndex;if(s>l){for(k=s;k>=l;k--){q=p[k].cells[u.colKeyIndex+1];this.selectCell(q);}}else{for(k=s;k<=l;k++){q=p[k].cells[u.colKeyIndex+1];this.selectCell(q);}}}}else{s=Math.min(r.trIndex,u.trIndex);l=Math.max(r.trIndex,u.trIndex);for(k=s;k<=l;k++){this.unselectCell(p[k].cells[u.colKeyIndex]);}}}else{if(j==37){if(r.colKeyIndex>=u.colKeyIndex){if(u.colKeyIndex>0){s=r.trIndex;l=u.trIndex;if(s>l){for(k=s;k>=l;k--){q=p[k].cells[u.colKeyIndex-1];this.selectCell(q);}}else{for(k=s;k<=l;k++){q=p[k].cells[u.colKeyIndex-1];this.selectCell(q);}}}}else{s=Math.min(r.trIndex,u.trIndex);l=Math.max(r.trIndex,u.trIndex);for(k=s;k<=l;k++){this.unselectCell(p[k].cells[u.colKeyIndex]);}}}}}}}},_handleCellRangeSelectionByMouse:function(y){var z=y.target;var k=this.getTdEl(z);if(k){var x=y.event;var o=x.shiftKey;var l=x.ctrlKey||((navigator.userAgent.toLowerCase().indexOf("mac")!=-1)&&x.metaKey);var q=this.getTrEl(k);var p=this.getTrIndex(q);var t=this.getColumn(k);var u=t.getKeyIndex();var s=this.getRecord(q);var B=this._oRecordSet.getRecordIndex(s);var n={record:s,column:t};var r=this._getSelectionAnchor();var m=this.getTbodyEl().rows;var A,w,v;if(o&&l){if(r){if(this.isSelected(r.cell)){if(r.recordIndex===B){if(r.colKeyIndex<u){for(w=r.colKeyIndex+1;w<=u;w++){this.selectCell(q.cells[w]);}}else{if(u<r.colKeyIndex){for(w=u;w<r.colKeyIndex;w++){this.selectCell(q.cells[w]);}}}}else{if(r.recordIndex<B){for(w=r.colKeyIndex+1;w<q.cells.length;w++){this.selectCell(q.cells[w]);}for(w=r.trIndex+1;w<p;w++){for(v=0;v<m[w].cells.length;v++){this.selectCell(m[w].cells[v]);}}for(w=0;w<=u;w++){this.selectCell(q.cells[w]);}}else{for(w=u;w<q.cells.length;w++){this.selectCell(q.cells[w]);}for(w=p+1;w<r.trIndex;w++){for(v=0;v<m[w].cells.length;v++){this.selectCell(m[w].cells[v]);}}for(w=0;w<r.colKeyIndex;w++){this.selectCell(q.cells[w]);}}}}else{if(r.recordIndex===B){if(r.colKeyIndex<u){for(w=r.colKeyIndex+1;w<u;w++){this.unselectCell(q.cells[w]);}}else{if(u<r.colKeyIndex){for(w=u+1;w<r.colKeyIndex;w++){this.unselectCell(q.cells[w]);}}}}if(r.recordIndex<B){for(w=r.trIndex;w<=p;w++){A=m[w];for(v=0;v<A.cells.length;v++){if(A.sectionRowIndex===r.trIndex){if(v>r.colKeyIndex){this.unselectCell(A.cells[v]);}}else{if(A.sectionRowIndex===p){if(v<u){this.unselectCell(A.cells[v]);}}else{this.unselectCell(A.cells[v]);}}}}}else{for(w=p;w<=r.trIndex;w++){A=m[w];for(v=0;v<A.cells.length;v++){if(A.sectionRowIndex==p){if(v>u){this.unselectCell(A.cells[v]);}}else{if(A.sectionRowIndex==r.trIndex){if(v<r.colKeyIndex){this.unselectCell(A.cells[v]);}}else{this.unselectCell(A.cells[v]);}}}}}this.selectCell(k);}}else{this._oAnchorCell=n;if(this.isSelected(n)){this.unselectCell(n);}else{this.selectCell(n);}}}else{if(o){this.unselectAllCells();if(r){if(r.recordIndex===B){if(r.colKeyIndex<u){for(w=r.colKeyIndex;w<=u;w++){this.selectCell(q.cells[w]);}}else{if(u<r.colKeyIndex){for(w=u;w<=r.colKeyIndex;w++){this.selectCell(q.cells[w]);}}}}else{if(r.recordIndex<B){for(w=r.trIndex;w<=p;w++){A=m[w];for(v=0;v<A.cells.length;v++){if(A.sectionRowIndex==r.trIndex){if(v>=r.colKeyIndex){this.selectCell(A.cells[v]);}}else{if(A.sectionRowIndex==p){if(v<=u){this.selectCell(A.cells[v]);}}else{this.selectCell(A.cells[v]);}}}}}else{for(w=p;w<=r.trIndex;w++){A=m[w];for(v=0;v<A.cells.length;v++){if(A.sectionRowIndex==p){if(v>=u){this.selectCell(A.cells[v]);}}else{if(A.sectionRowIndex==r.trIndex){if(v<=r.colKeyIndex){this.selectCell(A.cells[v]);}}else{this.selectCell(A.cells[v]);}}}}}}}else{this._oAnchorCell=n;this.selectCell(n);}}else{if(l){this._oAnchorCell=n;if(this.isSelected(n)){this.unselectCell(n);}else{this.selectCell(n);}}else{this._handleSingleCellSelectionByMouse(y);}}}}},_handleCellRangeSelectionByKey:function(n){var j=g.getCharCode(n);var r=n.shiftKey;if((j==9)||!r){this._handleSingleCellSelectionByKey(n);return;}if((j>36)&&(j<41)){var s=this._getSelectionTrigger();if(!s){return null;}g.stopEvent(n);var q=this._getSelectionAnchor(s);var k,l,p;var o=this.getTbodyEl().rows;var m=s.el.parentNode;if(j==40){l=this.getNextTrEl(s.el);if(q.recordIndex<=s.recordIndex){for(k=s.colKeyIndex+1;k<m.cells.length;k++){p=m.cells[k];this.selectCell(p);}if(l){for(k=0;k<=s.colKeyIndex;k++){p=l.cells[k];this.selectCell(p);}}}else{for(k=s.colKeyIndex;k<m.cells.length;k++){this.unselectCell(m.cells[k]);}if(l){for(k=0;k<s.colKeyIndex;k++){this.unselectCell(l.cells[k]);}}}}else{if(j==38){l=this.getPreviousTrEl(s.el);if(q.recordIndex>=s.recordIndex){for(k=s.colKeyIndex-1;k>-1;k--){p=m.cells[k];this.selectCell(p);}if(l){for(k=m.cells.length-1;k>=s.colKeyIndex;k--){p=l.cells[k];this.selectCell(p);}}}else{for(k=s.colKeyIndex;k>-1;k--){this.unselectCell(m.cells[k]);}if(l){for(k=m.cells.length-1;k>s.colKeyIndex;k--){this.unselectCell(l.cells[k]);}}}}else{if(j==39){l=this.getNextTrEl(s.el);if(q.recordIndex<s.recordIndex){if(s.colKeyIndex<m.cells.length-1){p=m.cells[s.colKeyIndex+1];this.selectCell(p);}else{if(l){p=l.cells[0];this.selectCell(p);}}}else{if(q.recordIndex>s.recordIndex){this.unselectCell(m.cells[s.colKeyIndex]);if(s.colKeyIndex<m.cells.length-1){}else{}}else{if(q.colKeyIndex<=s.colKeyIndex){if(s.colKeyIndex<m.cells.length-1){p=m.cells[s.colKeyIndex+1];this.selectCell(p);}else{if(s.trIndex<o.length-1){p=l.cells[0];this.selectCell(p);}}}else{this.unselectCell(m.cells[s.colKeyIndex]);}}}}else{if(j==37){l=this.getPreviousTrEl(s.el);if(q.recordIndex<s.recordIndex){this.unselectCell(m.cells[s.colKeyIndex]);if(s.colKeyIndex>0){}else{}}else{if(q.recordIndex>s.recordIndex){if(s.colKeyIndex>0){p=m.cells[s.colKeyIndex-1];this.selectCell(p);}else{if(s.trIndex>0){p=l.cells[l.cells.length-1];this.selectCell(p);
+}}}else{if(q.colKeyIndex>=s.colKeyIndex){if(s.colKeyIndex>0){p=m.cells[s.colKeyIndex-1];this.selectCell(p);}else{if(s.trIndex>0){p=l.cells[l.cells.length-1];this.selectCell(p);}}}else{this.unselectCell(m.cells[s.colKeyIndex]);if(s.colKeyIndex>0){}else{}}}}}}}}}},_handleSingleCellSelectionByMouse:function(n){var o=n.target;var k=this.getTdEl(o);if(k){var j=this.getTrEl(k);var i=this.getRecord(j);var m=this.getColumn(k);var l={record:i,column:m};this._oAnchorCell=l;this.unselectAllCells();this.selectCell(l);}},_handleSingleCellSelectionByKey:function(m){var i=g.getCharCode(m);if((i==9)||((i>36)&&(i<41))){var k=m.shiftKey;var j=this._getSelectionTrigger();if(!j){return null;}var l;if(i==40){l=this.getBelowTdEl(j.el);if(l===null){l=j.el;}}else{if(i==38){l=this.getAboveTdEl(j.el);if(l===null){l=j.el;}}else{if((i==39)||(!k&&(i==9))){l=this.getNextTdEl(j.el);if(l===null){return;}}else{if((i==37)||(k&&(i==9))){l=this.getPreviousTdEl(j.el);if(l===null){return;}}}}}g.stopEvent(m);this.unselectAllCells();this.selectCell(l);this._oAnchorCell={record:this.getRecord(l),column:this.getColumn(l)};}},getSelectedTrEls:function(){return c.getElementsByClassName(d.CLASS_SELECTED,"tr",this._elTbody);},selectRow:function(p){var o,i;if(p instanceof YAHOO.widget.Record){o=this._oRecordSet.getRecord(p);i=this.getTrEl(o);}else{if(h.isNumber(p)){o=this.getRecord(p);i=this.getTrEl(o);}else{i=this.getTrEl(p);o=this.getRecord(i);}}if(o){var n=this._aSelections||[];var m=o.getId();var l=-1;if(n.indexOf){l=n.indexOf(m);}else{for(var k=n.length-1;k>-1;k--){if(n[k]===m){l=k;break;}}}if(l>-1){n.splice(l,1);}n.push(m);this._aSelections=n;if(!this._oAnchorRecord){this._oAnchorRecord=o;}if(i){c.addClass(i,d.CLASS_SELECTED);}this.fireEvent("rowSelectEvent",{record:o,el:i});}else{}},unselectRow:function(p){var i=this.getTrEl(p);var o;if(p instanceof YAHOO.widget.Record){o=this._oRecordSet.getRecord(p);}else{if(h.isNumber(p)){o=this.getRecord(p);}else{o=this.getRecord(i);}}if(o){var n=this._aSelections||[];var m=o.getId();var l=-1;if(n.indexOf){l=n.indexOf(m);}else{for(var k=n.length-1;k>-1;k--){if(n[k]===m){l=k;break;}}}if(l>-1){n.splice(l,1);this._aSelections=n;c.removeClass(i,d.CLASS_SELECTED);this.fireEvent("rowUnselectEvent",{record:o,el:i});return;}}},unselectAllRows:function(){var k=this._aSelections||[],m,l=[];for(var i=k.length-1;i>-1;i--){if(h.isString(k[i])){m=k.splice(i,1);l[l.length]=this.getRecord(h.isArray(m)?m[0]:m);}}this._aSelections=k;this._unselectAllTrEls();this.fireEvent("unselectAllRowsEvent",{records:l});},_unselectAllTdEls:function(){var i=c.getElementsByClassName(d.CLASS_SELECTED,"td",this._elTbody);c.removeClass(i,d.CLASS_SELECTED);},getSelectedTdEls:function(){return c.getElementsByClassName(d.CLASS_SELECTED,"td",this._elTbody);},selectCell:function(i){var p=this.getTdEl(i);if(p){var o=this.getRecord(p);var q=this.getColumn(this.getCellIndex(p));var m=q.getKey();if(o&&m){var n=this._aSelections||[];var l=o.getId();for(var k=n.length-1;k>-1;k--){if((n[k].recordId===l)&&(n[k].columnKey===m)){n.splice(k,1);break;}}n.push({recordId:l,columnKey:m});this._aSelections=n;if(!this._oAnchorCell){this._oAnchorCell={record:o,column:q};}c.addClass(p,d.CLASS_SELECTED);this.fireEvent("cellSelectEvent",{record:o,column:q,key:m,el:p});return;}}},unselectCell:function(i){var o=this.getTdEl(i);if(o){var n=this.getRecord(o);var p=this.getColumn(this.getCellIndex(o));var l=p.getKey();if(n&&l){var m=this._aSelections||[];var q=n.getId();for(var k=m.length-1;k>-1;k--){if((m[k].recordId===q)&&(m[k].columnKey===l)){m.splice(k,1);this._aSelections=m;c.removeClass(o,d.CLASS_SELECTED);this.fireEvent("cellUnselectEvent",{record:n,column:p,key:l,el:o});return;}}}}},unselectAllCells:function(){var k=this._aSelections||[];for(var i=k.length-1;i>-1;i--){if(h.isObject(k[i])){k.splice(i,1);}}this._aSelections=k;this._unselectAllTdEls();this.fireEvent("unselectAllCellsEvent");},isSelected:function(p){if(p&&(p.ownerDocument==document)){return(c.hasClass(this.getTdEl(p),d.CLASS_SELECTED)||c.hasClass(this.getTrEl(p),d.CLASS_SELECTED));}else{var n,k,i;var m=this._aSelections;if(m&&m.length>0){if(p instanceof YAHOO.widget.Record){n=p;}else{if(h.isNumber(p)){n=this.getRecord(p);}}if(n){k=n.getId();if(m.indexOf){if(m.indexOf(k)>-1){return true;}}else{for(i=m.length-1;i>-1;i--){if(m[i]===k){return true;}}}}else{if(p.record&&p.column){k=p.record.getId();var l=p.column.getKey();for(i=m.length-1;i>-1;i--){if((m[i].recordId===k)&&(m[i].columnKey===l)){return true;}}}}}}return false;},getSelectedRows:function(){var i=[];var l=this._aSelections||[];for(var k=0;k<l.length;k++){if(h.isString(l[k])){i.push(l[k]);}}return i;},getSelectedCells:function(){var k=[];var l=this._aSelections||[];for(var i=0;i<l.length;i++){if(l[i]&&h.isObject(l[i])){k.push(l[i]);}}return k;},getLastSelectedRecord:function(){var k=this._aSelections;if(k&&k.length>0){for(var j=k.length-1;j>-1;j--){if(h.isString(k[j])){return k[j];}}}},getLastSelectedCell:function(){var k=this._aSelections;if(k&&k.length>0){for(var j=k.length-1;j>-1;j--){if(k[j].recordId&&k[j].columnKey){return k[j];}}}},highlightRow:function(k){var i=this.getTrEl(k);if(i){var j=this.getRecord(i);c.addClass(i,d.CLASS_HIGHLIGHTED);this.fireEvent("rowHighlightEvent",{record:j,el:i});return;}},unhighlightRow:function(k){var i=this.getTrEl(k);if(i){var j=this.getRecord(i);c.removeClass(i,d.CLASS_HIGHLIGHTED);this.fireEvent("rowUnhighlightEvent",{record:j,el:i});return;}},highlightCell:function(i){var l=this.getTdEl(i);if(l){if(this._elLastHighlightedTd){this.unhighlightCell(this._elLastHighlightedTd);}var k=this.getRecord(l);var m=this.getColumn(this.getCellIndex(l));var j=m.getKey();c.addClass(l,d.CLASS_HIGHLIGHTED);this._elLastHighlightedTd=l;this.fireEvent("cellHighlightEvent",{record:k,column:m,key:j,el:l});return;}},unhighlightCell:function(i){var k=this.getTdEl(i);if(k){var j=this.getRecord(k);c.removeClass(k,d.CLASS_HIGHLIGHTED);this._elLastHighlightedTd=null;this.fireEvent("cellUnhighlightEvent",{record:j,column:this.getColumn(this.getCellIndex(k)),key:this.getColumn(this.getCellIndex(k)).getKey(),el:k});
+return;}},addCellEditor:function(j,i){j.editor=i;j.editor.subscribe("showEvent",this._onEditorShowEvent,this,true);j.editor.subscribe("keydownEvent",this._onEditorKeydownEvent,this,true);j.editor.subscribe("revertEvent",this._onEditorRevertEvent,this,true);j.editor.subscribe("saveEvent",this._onEditorSaveEvent,this,true);j.editor.subscribe("cancelEvent",this._onEditorCancelEvent,this,true);j.editor.subscribe("blurEvent",this._onEditorBlurEvent,this,true);j.editor.subscribe("blockEvent",this._onEditorBlockEvent,this,true);j.editor.subscribe("unblockEvent",this._onEditorUnblockEvent,this,true);},getCellEditor:function(){return this._oCellEditor;},showCellEditor:function(p,q,l){p=this.getTdEl(p);if(p){l=this.getColumn(p);if(l&&l.editor){var j=this._oCellEditor;if(j){if(this._oCellEditor.cancel){this._oCellEditor.cancel();}else{if(j.isActive){this.cancelCellEditor();}}}if(l.editor instanceof YAHOO.widget.BaseCellEditor){j=l.editor;var n=j.attach(this,p);if(n){j.render();j.move();n=this.doBeforeShowCellEditor(j);if(n){j.show();this._oCellEditor=j;}}}else{if(!q||!(q instanceof YAHOO.widget.Record)){q=this.getRecord(p);}if(!l||!(l instanceof YAHOO.widget.Column)){l=this.getColumn(p);}if(q&&l){if(!this._oCellEditor||this._oCellEditor.container){this._initCellEditorEl();}j=this._oCellEditor;j.cell=p;j.record=q;j.column=l;j.validator=(l.editorOptions&&h.isFunction(l.editorOptions.validator))?l.editorOptions.validator:null;j.value=q.getData(l.key);j.defaultValue=null;var k=j.container;var o=c.getX(p);var m=c.getY(p);if(isNaN(o)||isNaN(m)){o=p.offsetLeft+c.getX(this._elTbody.parentNode)-this._elTbody.scrollLeft;m=p.offsetTop+c.getY(this._elTbody.parentNode)-this._elTbody.scrollTop+this._elThead.offsetHeight;}k.style.left=o+"px";k.style.top=m+"px";this.doBeforeShowCellEditor(this._oCellEditor);k.style.display="";g.addListener(k,"keydown",function(s,r){if((s.keyCode==27)){r.cancelCellEditor();r.focusTbodyEl();}else{r.fireEvent("editorKeydownEvent",{editor:r._oCellEditor,event:s});}},this);var i;if(h.isString(l.editor)){switch(l.editor){case"checkbox":i=d.editCheckbox;break;case"date":i=d.editDate;break;case"dropdown":i=d.editDropdown;break;case"radio":i=d.editRadio;break;case"textarea":i=d.editTextarea;break;case"textbox":i=d.editTextbox;break;default:i=null;}}else{if(h.isFunction(l.editor)){i=l.editor;}}if(i){i(this._oCellEditor,this);if(!l.editorOptions||!l.editorOptions.disableBtns){this.showCellEditorBtns(k);}j.isActive=true;this.fireEvent("editorShowEvent",{editor:j});return;}}}}}},_initCellEditorEl:function(){var i=document.createElement("div");i.id=this._sId+"-celleditor";i.style.display="none";i.tabIndex=0;c.addClass(i,d.CLASS_EDITOR);var k=c.getFirstChild(document.body);if(k){i=c.insertBefore(i,k);}else{i=document.body.appendChild(i);}var j={};j.container=i;j.value=null;j.isActive=false;this._oCellEditor=j;},doBeforeShowCellEditor:function(i){return true;},saveCellEditor:function(){if(this._oCellEditor){if(this._oCellEditor.save){this._oCellEditor.save();}else{if(this._oCellEditor.isActive){var i=this._oCellEditor.value;var j=this._oCellEditor.record.getData(this._oCellEditor.column.key);if(this._oCellEditor.validator){i=this._oCellEditor.value=this._oCellEditor.validator.call(this,i,j,this._oCellEditor);if(i===null){this.resetCellEditor();this.fireEvent("editorRevertEvent",{editor:this._oCellEditor,oldData:j,newData:i});return;}}this._oRecordSet.updateRecordValue(this._oCellEditor.record,this._oCellEditor.column.key,this._oCellEditor.value);this.formatCell(this._oCellEditor.cell.firstChild,this._oCellEditor.record,this._oCellEditor.column);this._oChainRender.add({method:function(){this.validateColumnWidths();},scope:this});this._oChainRender.run();this.resetCellEditor();this.fireEvent("editorSaveEvent",{editor:this._oCellEditor,oldData:j,newData:i});}}}},cancelCellEditor:function(){if(this._oCellEditor){if(this._oCellEditor.cancel){this._oCellEditor.cancel();}else{if(this._oCellEditor.isActive){this.resetCellEditor();this.fireEvent("editorCancelEvent",{editor:this._oCellEditor});}}}},destroyCellEditor:function(){if(this._oCellEditor){this._oCellEditor.destroy();this._oCellEditor=null;}},_onEditorShowEvent:function(i){this.fireEvent("editorShowEvent",i);},_onEditorKeydownEvent:function(i){this.fireEvent("editorKeydownEvent",i);},_onEditorRevertEvent:function(i){this.fireEvent("editorRevertEvent",i);},_onEditorSaveEvent:function(i){this.fireEvent("editorSaveEvent",i);},_onEditorCancelEvent:function(i){this.fireEvent("editorCancelEvent",i);},_onEditorBlurEvent:function(i){this.fireEvent("editorBlurEvent",i);},_onEditorBlockEvent:function(i){this.fireEvent("editorBlockEvent",i);},_onEditorUnblockEvent:function(i){this.fireEvent("editorUnblockEvent",i);},onEditorBlurEvent:function(i){if(i.editor.disableBtns){if(i.editor.save){i.editor.save();}}else{if(i.editor.cancel){i.editor.cancel();}}},onEditorBlockEvent:function(i){this.disable();},onEditorUnblockEvent:function(i){this.undisable();},doBeforeLoadData:function(i,j,k){return true;},onEventSortColumn:function(k){var i=k.event;var m=k.target;var j=this.getThEl(m)||this.getTdEl(m);if(j){var l=this.getColumn(j);if(l.sortable){g.stopEvent(i);this.sortColumn(l);}}else{}},onEventSelectColumn:function(i){this.selectColumn(i.target);},onEventHighlightColumn:function(i){this.highlightColumn(i.target);},onEventUnhighlightColumn:function(i){this.unhighlightColumn(i.target);},onEventSelectRow:function(j){var i=this.get("selectionMode");if(i=="single"){this._handleSingleSelectionByMouse(j);}else{this._handleStandardSelectionByMouse(j);}},onEventSelectCell:function(j){var i=this.get("selectionMode");if(i=="cellblock"){this._handleCellBlockSelectionByMouse(j);}else{if(i=="cellrange"){this._handleCellRangeSelectionByMouse(j);}else{this._handleSingleCellSelectionByMouse(j);}}},onEventHighlightRow:function(i){this.highlightRow(i.target);},onEventUnhighlightRow:function(i){this.unhighlightRow(i.target);},onEventHighlightCell:function(i){this.highlightCell(i.target);
+},onEventUnhighlightCell:function(i){this.unhighlightCell(i.target);},onEventFormatCell:function(i){var l=i.target;var j=this.getTdEl(l);if(j){var k=this.getColumn(this.getCellIndex(j));this.formatCell(j.firstChild,this.getRecord(j),k);}else{}},onEventShowCellEditor:function(i){if(!this.isDisabled()){this.showCellEditor(i.target);}},onEventSaveCellEditor:function(i){if(this._oCellEditor){if(this._oCellEditor.save){this._oCellEditor.save();}else{this.saveCellEditor();}}},onEventCancelCellEditor:function(i){if(this._oCellEditor){if(this._oCellEditor.cancel){this._oCellEditor.cancel();}else{this.cancelCellEditor();}}},onDataReturnInitializeTable:function(i,j,k){if((this instanceof d)&&this._sId){this.initializeTable();this.onDataReturnSetRows(i,j,k);}},onDataReturnReplaceRows:function(m,l,n){if((this instanceof d)&&this._sId){this.fireEvent("dataReturnEvent",{request:m,response:l,payload:n});var j=this.doBeforeLoadData(m,l,n),k=this.get("paginator"),i=0;if(j&&l&&!l.error&&h.isArray(l.results)){this._oRecordSet.reset();if(this.get("dynamicData")){if(n&&n.pagination&&h.isNumber(n.pagination.recordOffset)){i=n.pagination.recordOffset;}else{if(k){i=k.getStartIndex();}}}this._oRecordSet.setRecords(l.results,i|0);this._handleDataReturnPayload(m,l,n);this.render();}else{if(j&&l.error){this.showTableMessage(this.get("MSG_ERROR"),d.CLASS_ERROR);}}}},onDataReturnAppendRows:function(j,k,l){if((this instanceof d)&&this._sId){this.fireEvent("dataReturnEvent",{request:j,response:k,payload:l});var i=this.doBeforeLoadData(j,k,l);if(i&&k&&!k.error&&h.isArray(k.results)){this.addRows(k.results);this._handleDataReturnPayload(j,k,l);}else{if(i&&k.error){this.showTableMessage(this.get("MSG_ERROR"),d.CLASS_ERROR);}}}},onDataReturnInsertRows:function(j,k,l){if((this instanceof d)&&this._sId){this.fireEvent("dataReturnEvent",{request:j,response:k,payload:l});var i=this.doBeforeLoadData(j,k,l);if(i&&k&&!k.error&&h.isArray(k.results)){this.addRows(k.results,(l?l.insertIndex:0));this._handleDataReturnPayload(j,k,l);}else{if(i&&k.error){this.showTableMessage(this.get("MSG_ERROR"),d.CLASS_ERROR);}}}},onDataReturnUpdateRows:function(j,k,l){if((this instanceof d)&&this._sId){this.fireEvent("dataReturnEvent",{request:j,response:k,payload:l});var i=this.doBeforeLoadData(j,k,l);if(i&&k&&!k.error&&h.isArray(k.results)){this.updateRows((l?l.updateIndex:0),k.results);this._handleDataReturnPayload(j,k,l);}else{if(i&&k.error){this.showTableMessage(this.get("MSG_ERROR"),d.CLASS_ERROR);}}}},onDataReturnSetRows:function(m,l,n){if((this instanceof d)&&this._sId){this.fireEvent("dataReturnEvent",{request:m,response:l,payload:n});var j=this.doBeforeLoadData(m,l,n),k=this.get("paginator"),i=0;if(j&&l&&!l.error&&h.isArray(l.results)){if(this.get("dynamicData")){if(n&&n.pagination&&h.isNumber(n.pagination.recordOffset)){i=n.pagination.recordOffset;}else{if(k){i=k.getStartIndex();}}this._oRecordSet.reset();}this._oRecordSet.setRecords(l.results,i|0);this._handleDataReturnPayload(m,l,n);this.render();}else{if(j&&l.error){this.showTableMessage(this.get("MSG_ERROR"),d.CLASS_ERROR);}}}else{}},handleDataReturnPayload:function(j,i,k){return k||{};},_handleDataReturnPayload:function(k,j,l){l=this.handleDataReturnPayload(k,j,l);if(l){var i=this.get("paginator");if(i){if(this.get("dynamicData")){if(e.Paginator.isNumeric(l.totalRecords)){i.set("totalRecords",l.totalRecords);}}else{i.set("totalRecords",this._oRecordSet.getLength());}if(h.isObject(l.pagination)){i.set("rowsPerPage",l.pagination.rowsPerPage);i.set("recordOffset",l.pagination.recordOffset);}}if(l.sortedBy){this.set("sortedBy",l.sortedBy);}else{if(l.sorting){this.set("sortedBy",l.sorting);}}}},showCellEditorBtns:function(k){var l=k.appendChild(document.createElement("div"));c.addClass(l,d.CLASS_BUTTON);var j=l.appendChild(document.createElement("button"));c.addClass(j,d.CLASS_DEFAULT);j.innerHTML="OK";g.addListener(j,"click",function(n,m){m.onEventSaveCellEditor(n,m);m.focusTbodyEl();},this,true);var i=l.appendChild(document.createElement("button"));i.innerHTML="Cancel";g.addListener(i,"click",function(n,m){m.onEventCancelCellEditor(n,m);m.focusTbodyEl();},this,true);},resetCellEditor:function(){var i=this._oCellEditor.container;i.style.display="none";g.purgeElement(i,true);i.innerHTML="";this._oCellEditor.value=null;this._oCellEditor.isActive=false;},getBody:function(){return this.getTbodyEl();},getCell:function(i){return this.getTdEl(i);},getRow:function(i){return this.getTrEl(i);},refreshView:function(){this.render();},select:function(k){if(!h.isArray(k)){k=[k];}for(var j=0;j<k.length;j++){this.selectRow(k[j]);}},onEventEditCell:function(i){this.onEventShowCellEditor(i);},_syncColWidths:function(){this.validateColumnWidths();}});d.prototype.onDataReturnSetRecords=d.prototype.onDataReturnSetRows;d.prototype.onPaginatorChange=d.prototype.onPaginatorChangeRequest;d.editCheckbox=function(){};d.editDate=function(){};d.editDropdown=function(){};d.editRadio=function(){};d.editTextarea=function(){};d.editTextbox=function(){};})();(function(){var c=YAHOO.lang,f=YAHOO.util,e=YAHOO.widget,a=YAHOO.env.ua,d=f.Dom,j=f.Event,i=f.DataSourceBase,g=e.DataTable,b=e.Paginator;e.ScrollingDataTable=function(n,m,k,l){l=l||{};if(l.scrollable){l.scrollable=false;}this._init();e.ScrollingDataTable.superclass.constructor.call(this,n,m,k,l);this.subscribe("columnShowEvent",this._onColumnChange);};var h=e.ScrollingDataTable;c.augmentObject(h,{CLASS_HEADER:"yui-dt-hd",CLASS_BODY:"yui-dt-bd"});c.extend(h,g,{_elHdContainer:null,_elHdTable:null,_elBdContainer:null,_elBdThead:null,_elTmpContainer:null,_elTmpTable:null,_bScrollbarX:null,initAttributes:function(k){k=k||{};h.superclass.initAttributes.call(this,k);this.setAttributeConfig("width",{value:null,validator:c.isString,method:function(l){if(this._elHdContainer&&this._elBdContainer){this._elHdContainer.style.width=l;this._elBdContainer.style.width=l;this._syncScrollX();this._syncScrollOverhang();}}});this.setAttributeConfig("height",{value:null,validator:c.isString,method:function(l){if(this._elHdContainer&&this._elBdContainer){this._elBdContainer.style.height=l;
+this._syncScrollX();this._syncScrollY();this._syncScrollOverhang();}}});this.setAttributeConfig("COLOR_COLUMNFILLER",{value:"#F2F2F2",validator:c.isString,method:function(l){if(this._elHdContainer){this._elHdContainer.style.backgroundColor=l;}}});},_init:function(){this._elHdContainer=null;this._elHdTable=null;this._elBdContainer=null;this._elBdThead=null;this._elTmpContainer=null;this._elTmpTable=null;},_initDomElements:function(k){this._initContainerEl(k);if(this._elContainer&&this._elHdContainer&&this._elBdContainer){this._initTableEl();if(this._elHdTable&&this._elTable){this._initColgroupEl(this._elHdTable);this._initTheadEl(this._elHdTable,this._elTable);this._initTbodyEl(this._elTable);this._initMsgTbodyEl(this._elTable);}}if(!this._elContainer||!this._elTable||!this._elColgroup||!this._elThead||!this._elTbody||!this._elMsgTbody||!this._elHdTable||!this._elBdThead){return false;}else{return true;}},_destroyContainerEl:function(k){d.removeClass(k,g.CLASS_SCROLLABLE);h.superclass._destroyContainerEl.call(this,k);this._elHdContainer=null;this._elBdContainer=null;},_initContainerEl:function(l){h.superclass._initContainerEl.call(this,l);if(this._elContainer){l=this._elContainer;d.addClass(l,g.CLASS_SCROLLABLE);var k=document.createElement("div");k.style.width=this.get("width")||"";k.style.backgroundColor=this.get("COLOR_COLUMNFILLER");d.addClass(k,h.CLASS_HEADER);this._elHdContainer=k;l.appendChild(k);var m=document.createElement("div");m.style.width=this.get("width")||"";m.style.height=this.get("height")||"";d.addClass(m,h.CLASS_BODY);j.addListener(m,"scroll",this._onScroll,this);this._elBdContainer=m;l.appendChild(m);}},_initCaptionEl:function(k){},_destroyHdTableEl:function(){var k=this._elHdTable;if(k){j.purgeElement(k,true);k.parentNode.removeChild(k);this._elBdThead=null;}},_initTableEl:function(){if(this._elHdContainer){this._destroyHdTableEl();this._elHdTable=this._elHdContainer.appendChild(document.createElement("table"));j.delegate(this._elHdTable,"mouseenter",this._onTableMouseover,"thead ."+g.CLASS_LABEL,this);j.delegate(this._elHdTable,"mouseleave",this._onTableMouseout,"thead ."+g.CLASS_LABEL,this);}h.superclass._initTableEl.call(this,this._elBdContainer);},_initTheadEl:function(l,k){l=l||this._elHdTable;k=k||this._elTable;this._initBdTheadEl(k);h.superclass._initTheadEl.call(this,l);},_initThEl:function(l,k){h.superclass._initThEl.call(this,l,k);l.id=this.getId()+"-fixedth-"+k.getSanitizedKey();},_destroyBdTheadEl:function(){var k=this._elBdThead;if(k){var l=k.parentNode;j.purgeElement(k,true);l.removeChild(k);this._elBdThead=null;this._destroyColumnHelpers();}},_initBdTheadEl:function(t){if(t){this._destroyBdTheadEl();var p=t.insertBefore(document.createElement("thead"),t.firstChild);var v=this._oColumnSet,u=v.tree,o,l,s,q,n,m,r;for(q=0,m=u.length;q<m;q++){l=p.appendChild(document.createElement("tr"));for(n=0,r=u[q].length;n<r;n++){s=u[q][n];o=l.appendChild(document.createElement("th"));this._initBdThEl(o,s,q,n);}}this._elBdThead=p;}},_initBdThEl:function(n,m){n.id=this.getId()+"-th-"+m.getSanitizedKey();n.rowSpan=m.getRowspan();n.colSpan=m.getColspan();if(m.abbr){n.abbr=m.abbr;}var l=m.getKey();var k=c.isValue(m.label)?m.label:l;n.innerHTML=k;},_initTbodyEl:function(k){h.superclass._initTbodyEl.call(this,k);k.style.marginTop=(this._elTbody.offsetTop>0)?"-"+this._elTbody.offsetTop+"px":0;},_focusEl:function(l){l=l||this._elTbody;var k=this;this._storeScrollPositions();setTimeout(function(){setTimeout(function(){try{l.focus();k._restoreScrollPositions();}catch(m){}},0);},0);},_runRenderChain:function(){this._storeScrollPositions();this._oChainRender.run();},_storeScrollPositions:function(){this._nScrollTop=this._elBdContainer.scrollTop;this._nScrollLeft=this._elBdContainer.scrollLeft;},clearScrollPositions:function(){this._nScrollTop=0;this._nScrollLeft=0;},_restoreScrollPositions:function(){if(this._nScrollTop){this._elBdContainer.scrollTop=this._nScrollTop;this._nScrollTop=null;}if(this._nScrollLeft){this._elBdContainer.scrollLeft=this._nScrollLeft;this._elHdContainer.scrollLeft=this._nScrollLeft;this._nScrollLeft=null;}},_validateColumnWidth:function(n,k){if(!n.width&&!n.hidden){var p=n.getThEl();if(n._calculatedWidth){this._setColumnWidth(n,"auto","visible");}if(p.offsetWidth!==k.offsetWidth){var m=(p.offsetWidth>k.offsetWidth)?n.getThLinerEl():k.firstChild;var l=Math.max(0,(m.offsetWidth-(parseInt(d.getStyle(m,"paddingLeft"),10)|0)-(parseInt(d.getStyle(m,"paddingRight"),10)|0)),n.minWidth);var o="visible";if((n.maxAutoWidth>0)&&(l>n.maxAutoWidth)){l=n.maxAutoWidth;o="hidden";}this._elTbody.style.display="none";this._setColumnWidth(n,l+"px",o);n._calculatedWidth=l;this._elTbody.style.display="";}}},validateColumnWidths:function(s){var u=this._oColumnSet.keys,w=u.length,l=this.getFirstTrEl();if(a.ie){this._setOverhangValue(1);}if(u&&l&&(l.childNodes.length===w)){var m=this.get("width");if(m){this._elHdContainer.style.width="";this._elBdContainer.style.width="";}this._elContainer.style.width="";if(s&&c.isNumber(s.getKeyIndex())){this._validateColumnWidth(s,l.childNodes[s.getKeyIndex()]);}else{var t,k=[],o,q,r;for(q=0;q<w;q++){s=u[q];if(!s.width&&!s.hidden&&s._calculatedWidth){k[k.length]=s;}}this._elTbody.style.display="none";for(q=0,r=k.length;q<r;q++){this._setColumnWidth(k[q],"auto","visible");}this._elTbody.style.display="";k=[];for(q=0;q<w;q++){s=u[q];t=l.childNodes[q];if(!s.width&&!s.hidden){var n=s.getThEl();if(n.offsetWidth!==t.offsetWidth){var v=(n.offsetWidth>t.offsetWidth)?s.getThLinerEl():t.firstChild;var p=Math.max(0,(v.offsetWidth-(parseInt(d.getStyle(v,"paddingLeft"),10)|0)-(parseInt(d.getStyle(v,"paddingRight"),10)|0)),s.minWidth);var x="visible";if((s.maxAutoWidth>0)&&(p>s.maxAutoWidth)){p=s.maxAutoWidth;x="hidden";}k[k.length]=[s,p,x];}}}this._elTbody.style.display="none";for(q=0,r=k.length;q<r;q++){o=k[q];this._setColumnWidth(o[0],o[1]+"px",o[2]);o[0]._calculatedWidth=o[1];}this._elTbody.style.display="";}if(m){this._elHdContainer.style.width=m;this._elBdContainer.style.width=m;
+}}this._syncScroll();this._restoreScrollPositions();},_syncScroll:function(){this._syncScrollX();this._syncScrollY();this._syncScrollOverhang();if(a.opera){this._elHdContainer.scrollLeft=this._elBdContainer.scrollLeft;if(!this.get("width")){document.body.style+="";}}},_syncScrollY:function(){var k=this._elTbody,l=this._elBdContainer;if(!this.get("width")){this._elContainer.style.width=(l.scrollHeight>l.clientHeight)?(k.parentNode.clientWidth+19)+"px":(k.parentNode.clientWidth+2)+"px";}},_syncScrollX:function(){var k=this._elTbody,l=this._elBdContainer;if(!this.get("height")&&(a.ie)){l.style.height=(l.scrollWidth>l.offsetWidth)?(k.parentNode.offsetHeight+18)+"px":k.parentNode.offsetHeight+"px";}if(this._elTbody.rows.length===0){this._elMsgTbody.parentNode.style.width=this.getTheadEl().parentNode.offsetWidth+"px";}else{this._elMsgTbody.parentNode.style.width="";}},_syncScrollOverhang:function(){var l=this._elBdContainer,k=1;if((l.scrollHeight>l.clientHeight)&&(l.scrollWidth>l.clientWidth)){k=18;}this._setOverhangValue(k);},_setOverhangValue:function(n){var p=this._oColumnSet.headers[this._oColumnSet.headers.length-1]||[],l=p.length,k=this._sId+"-fixedth-",o=n+"px solid "+this.get("COLOR_COLUMNFILLER");this._elThead.style.display="none";for(var m=0;m<l;m++){d.get(k+p[m]).style.borderRight=o;}this._elThead.style.display="";},getHdContainerEl:function(){return this._elHdContainer;},getBdContainerEl:function(){return this._elBdContainer;},getHdTableEl:function(){return this._elHdTable;},getBdTableEl:function(){return this._elTable;},disable:function(){var k=this._elMask;k.style.width=this._elBdContainer.offsetWidth+"px";k.style.height=this._elHdContainer.offsetHeight+this._elBdContainer.offsetHeight+"px";k.style.display="";this.fireEvent("disableEvent");},removeColumn:function(m){var k=this._elHdContainer.scrollLeft;var l=this._elBdContainer.scrollLeft;m=h.superclass.removeColumn.call(this,m);this._elHdContainer.scrollLeft=k;this._elBdContainer.scrollLeft=l;return m;},insertColumn:function(n,l){var k=this._elHdContainer.scrollLeft;var m=this._elBdContainer.scrollLeft;var o=h.superclass.insertColumn.call(this,n,l);this._elHdContainer.scrollLeft=k;this._elBdContainer.scrollLeft=m;return o;},reorderColumn:function(n,l){var k=this._elHdContainer.scrollLeft;var m=this._elBdContainer.scrollLeft;var o=h.superclass.reorderColumn.call(this,n,l);this._elHdContainer.scrollLeft=k;this._elBdContainer.scrollLeft=m;return o;},setColumnWidth:function(l,k){l=this.getColumn(l);if(l){this._storeScrollPositions();if(c.isNumber(k)){k=(k>l.minWidth)?k:l.minWidth;l.width=k;this._setColumnWidth(l,k+"px");this._syncScroll();this.fireEvent("columnSetWidthEvent",{column:l,width:k});}else{if(k===null){l.width=k;this._setColumnWidth(l,"auto");this.validateColumnWidths(l);this.fireEvent("columnUnsetWidthEvent",{column:l});}}this._clearTrTemplateEl();}else{}},scrollTo:function(m){var l=this.getTdEl(m);if(l){this.clearScrollPositions();this.getBdContainerEl().scrollLeft=l.offsetLeft;this.getBdContainerEl().scrollTop=l.parentNode.offsetTop;}else{var k=this.getTrEl(m);if(k){this.clearScrollPositions();this.getBdContainerEl().scrollTop=k.offsetTop;}}},showTableMessage:function(o,k){var p=this._elMsgTd;if(c.isString(o)){p.firstChild.innerHTML=o;}if(c.isString(k)){d.addClass(p.firstChild,k);}var n=this.getTheadEl();var l=n.parentNode;var m=l.offsetWidth;this._elMsgTbody.parentNode.style.width=this.getTheadEl().parentNode.offsetWidth+"px";this._elMsgTbody.style.display="";this.fireEvent("tableMsgShowEvent",{html:o,className:k});},_onColumnChange:function(k){var l=(k.column)?k.column:(k.editor)?k.editor.column:null;this._storeScrollPositions();this.validateColumnWidths(l);},_onScroll:function(m,l){l._elHdContainer.scrollLeft=l._elBdContainer.scrollLeft;if(l._oCellEditor&&l._oCellEditor.isActive){l.fireEvent("editorBlurEvent",{editor:l._oCellEditor});l.cancelCellEditor();}var n=j.getTarget(m);var k=n.nodeName.toLowerCase();l.fireEvent("tableScrollEvent",{event:m,target:n});},_onTheadKeydown:function(n,l){if(j.getCharCode(n)===9){setTimeout(function(){if((l instanceof h)&&l._sId){l._elBdContainer.scrollLeft=l._elHdContainer.scrollLeft;}},0);}var o=j.getTarget(n);var k=o.nodeName.toLowerCase();var m=true;while(o&&(k!="table")){switch(k){case"body":return;case"input":case"textarea":break;case"thead":m=l.fireEvent("theadKeyEvent",{target:o,event:n});break;default:break;}if(m===false){return;}else{o=o.parentNode;if(o){k=o.nodeName.toLowerCase();}}}l.fireEvent("tableKeyEvent",{target:(o||l._elContainer),event:n});}});})();(function(){var c=YAHOO.lang,f=YAHOO.util,e=YAHOO.widget,b=YAHOO.env.ua,d=f.Dom,i=f.Event,h=e.DataTable;e.BaseCellEditor=function(k,j){this._sId=this._sId||d.generateId(null,"yui-ceditor");YAHOO.widget.BaseCellEditor._nCount++;this._sType=k;this._initConfigs(j);this._initEvents();this._needsRender=true;};var a=e.BaseCellEditor;c.augmentObject(a,{_nCount:0,CLASS_CELLEDITOR:"yui-ceditor"});a.prototype={_sId:null,_sType:null,_oDataTable:null,_oColumn:null,_oRecord:null,_elTd:null,_elContainer:null,_elCancelBtn:null,_elSaveBtn:null,_initConfigs:function(k){if(k&&YAHOO.lang.isObject(k)){for(var j in k){if(j){this[j]=k[j];}}}},_initEvents:function(){this.createEvent("showEvent");this.createEvent("keydownEvent");this.createEvent("invalidDataEvent");this.createEvent("revertEvent");this.createEvent("saveEvent");this.createEvent("cancelEvent");this.createEvent("blurEvent");this.createEvent("blockEvent");this.createEvent("unblockEvent");},_initContainerEl:function(){if(this._elContainer){YAHOO.util.Event.purgeElement(this._elContainer,true);this._elContainer.innerHTML="";}var j=document.createElement("div");j.id=this.getId()+"-container";j.style.display="none";j.tabIndex=0;this.className=c.isArray(this.className)?this.className:this.className?[this.className]:[];this.className[this.className.length]=h.CLASS_EDITOR;j.className=this.className.join(" ");document.body.insertBefore(j,document.body.firstChild);this._elContainer=j;},_initShimEl:function(){if(this.useIFrame){if(!this._elIFrame){var j=document.createElement("iframe");
+j.src="javascript:false";j.frameBorder=0;j.scrolling="no";j.style.display="none";j.className=h.CLASS_EDITOR_SHIM;j.tabIndex=-1;j.role="presentation";j.title="Presentational iframe shim";document.body.insertBefore(j,document.body.firstChild);this._elIFrame=j;}}},_hide:function(){this.getContainerEl().style.display="none";if(this._elIFrame){this._elIFrame.style.display="none";}this.isActive=false;this.getDataTable()._oCellEditor=null;},asyncSubmitter:null,value:null,defaultValue:null,validator:null,resetInvalidData:true,isActive:false,LABEL_SAVE:"Save",LABEL_CANCEL:"Cancel",disableBtns:false,useIFrame:false,className:null,toString:function(){return"CellEditor instance "+this._sId;},getId:function(){return this._sId;},getDataTable:function(){return this._oDataTable;},getColumn:function(){return this._oColumn;},getRecord:function(){return this._oRecord;},getTdEl:function(){return this._elTd;},getContainerEl:function(){return this._elContainer;},destroy:function(){this.unsubscribeAll();var k=this.getColumn();if(k){k.editor=null;}var j=this.getContainerEl();if(j){i.purgeElement(j,true);j.parentNode.removeChild(j);}},render:function(){if(!this._needsRender){return;}this._initContainerEl();this._initShimEl();i.addListener(this.getContainerEl(),"keydown",function(l,j){if((l.keyCode==27)){var k=i.getTarget(l);if(k.nodeName&&k.nodeName.toLowerCase()==="select"){k.blur();}j.cancel();}j.fireEvent("keydownEvent",{editor:j,event:l});},this);this.renderForm();if(!this.disableBtns){this.renderBtns();}this.doAfterRender();this._needsRender=false;},renderBtns:function(){var l=this.getContainerEl().appendChild(document.createElement("div"));l.className=h.CLASS_BUTTON;var k=l.appendChild(document.createElement("button"));k.className=h.CLASS_DEFAULT;k.innerHTML=this.LABEL_SAVE;i.addListener(k,"click",function(m){this.save();},this,true);this._elSaveBtn=k;var j=l.appendChild(document.createElement("button"));j.innerHTML=this.LABEL_CANCEL;i.addListener(j,"click",function(m){this.cancel();},this,true);this._elCancelBtn=j;},attach:function(n,l){if(n instanceof YAHOO.widget.DataTable){this._oDataTable=n;l=n.getTdEl(l);if(l){this._elTd=l;var m=n.getColumn(l);if(m){this._oColumn=m;var j=n.getRecord(l);if(j){this._oRecord=j;var k=j.getData(this.getColumn().getField());this.value=(k!==undefined)?k:this.defaultValue;return true;}}}}return false;},move:function(){var m=this.getContainerEl(),l=this.getTdEl(),j=d.getX(l),n=d.getY(l);if(isNaN(j)||isNaN(n)){var k=this.getDataTable().getTbodyEl();j=l.offsetLeft+d.getX(k.parentNode)-k.scrollLeft;n=l.offsetTop+d.getY(k.parentNode)-k.scrollTop+this.getDataTable().getTheadEl().offsetHeight;}m.style.left=j+"px";m.style.top=n+"px";if(this._elIFrame){this._elIFrame.style.left=j+"px";this._elIFrame.style.top=n+"px";}},show:function(){var k=this.getContainerEl(),j=this._elIFrame;this.resetForm();this.isActive=true;k.style.display="";if(j){j.style.width=k.offsetWidth+"px";j.style.height=k.offsetHeight+"px";j.style.display="";}this.focus();this.fireEvent("showEvent",{editor:this});},block:function(){this.fireEvent("blockEvent",{editor:this});},unblock:function(){this.fireEvent("unblockEvent",{editor:this});},save:function(){var k=this.getInputValue();var l=k;if(this.validator){l=this.validator.call(this.getDataTable(),k,this.value,this);if(l===undefined){if(this.resetInvalidData){this.resetForm();}this.fireEvent("invalidDataEvent",{editor:this,oldData:this.value,newData:k});return;}}var m=this;var j=function(o,n){var p=m.value;if(o){m.value=n;m.getDataTable().updateCell(m.getRecord(),m.getColumn(),n);m._hide();m.fireEvent("saveEvent",{editor:m,oldData:p,newData:m.value});}else{m.resetForm();m.fireEvent("revertEvent",{editor:m,oldData:p,newData:n});}m.unblock();};this.block();if(c.isFunction(this.asyncSubmitter)){this.asyncSubmitter.call(this,j,l);}else{j(true,l);}},cancel:function(){if(this.isActive){this._hide();this.fireEvent("cancelEvent",{editor:this});}else{}},renderForm:function(){},doAfterRender:function(){},handleDisabledBtns:function(){},resetForm:function(){},focus:function(){},getInputValue:function(){}};c.augmentProto(a,f.EventProvider);e.CheckboxCellEditor=function(j){j=j||{};this._sId=this._sId||d.generateId(null,"yui-checkboxceditor");YAHOO.widget.BaseCellEditor._nCount++;e.CheckboxCellEditor.superclass.constructor.call(this,j.type||"checkbox",j);};c.extend(e.CheckboxCellEditor,a,{checkboxOptions:null,checkboxes:null,value:null,renderForm:function(){if(c.isArray(this.checkboxOptions)){var n,o,q,l,m,k;for(m=0,k=this.checkboxOptions.length;m<k;m++){n=this.checkboxOptions[m];o=c.isValue(n.value)?n.value:n;q=this.getId()+"-chk"+m;this.getContainerEl().innerHTML+='<input type="checkbox"'+' id="'+q+'"'+' value="'+o+'" />';l=this.getContainerEl().appendChild(document.createElement("label"));l.htmlFor=q;l.innerHTML=c.isValue(n.label)?n.label:n;}var p=[];for(m=0;m<k;m++){p[p.length]=this.getContainerEl().childNodes[m*2];}this.checkboxes=p;if(this.disableBtns){this.handleDisabledBtns();}}else{}},handleDisabledBtns:function(){i.addListener(this.getContainerEl(),"click",function(j){if(i.getTarget(j).tagName.toLowerCase()==="input"){this.save();}},this,true);},resetForm:function(){var p=c.isArray(this.value)?this.value:[this.value];for(var o=0,n=this.checkboxes.length;o<n;o++){this.checkboxes[o].checked=false;for(var m=0,l=p.length;m<l;m++){if(this.checkboxes[o].value==p[m]){this.checkboxes[o].checked=true;}}}},focus:function(){this.checkboxes[0].focus();},getInputValue:function(){var k=[];for(var m=0,l=this.checkboxes.length;m<l;m++){if(this.checkboxes[m].checked){k[k.length]=this.checkboxes[m].value;}}return k;}});c.augmentObject(e.CheckboxCellEditor,a);e.DateCellEditor=function(j){j=j||{};this._sId=this._sId||d.generateId(null,"yui-dateceditor");YAHOO.widget.BaseCellEditor._nCount++;e.DateCellEditor.superclass.constructor.call(this,j.type||"date",j);};c.extend(e.DateCellEditor,a,{calendar:null,calendarOptions:null,defaultValue:new Date(),renderForm:function(){if(YAHOO.widget.Calendar){var k=this.getContainerEl().appendChild(document.createElement("div"));
+k.id=this.getId()+"-dateContainer";var l=new YAHOO.widget.Calendar(this.getId()+"-date",k.id,this.calendarOptions);l.render();k.style.cssFloat="none";l.hideEvent.subscribe(function(){this.cancel();},this,true);if(b.ie){var j=this.getContainerEl().appendChild(document.createElement("div"));j.style.clear="both";}this.calendar=l;if(this.disableBtns){this.handleDisabledBtns();}}else{}},handleDisabledBtns:function(){this.calendar.selectEvent.subscribe(function(j){this.save();},this,true);},resetForm:function(){var j=this.value||(new Date());this.calendar.select(j);this.calendar.cfg.setProperty("pagedate",j,false);this.calendar.render();this.calendar.show();},focus:function(){},getInputValue:function(){return this.calendar.getSelectedDates()[0];}});c.augmentObject(e.DateCellEditor,a);e.DropdownCellEditor=function(j){j=j||{};this._sId=this._sId||d.generateId(null,"yui-dropdownceditor");YAHOO.widget.BaseCellEditor._nCount++;e.DropdownCellEditor.superclass.constructor.call(this,j.type||"dropdown",j);};c.extend(e.DropdownCellEditor,a,{dropdownOptions:null,dropdown:null,multiple:false,size:null,renderForm:function(){var n=this.getContainerEl().appendChild(document.createElement("select"));n.style.zoom=1;if(this.multiple){n.multiple="multiple";}if(c.isNumber(this.size)){n.size=this.size;}this.dropdown=n;if(c.isArray(this.dropdownOptions)){var o,m;for(var l=0,k=this.dropdownOptions.length;l<k;l++){o=this.dropdownOptions[l];m=document.createElement("option");m.value=(c.isValue(o.value))?o.value:o;m.innerHTML=(c.isValue(o.label))?o.label:o;m=n.appendChild(m);}if(this.disableBtns){this.handleDisabledBtns();}}},handleDisabledBtns:function(){if(this.multiple){i.addListener(this.dropdown,"blur",function(j){this.save();},this,true);}else{if(!b.ie){i.addListener(this.dropdown,"change",function(j){this.save();},this,true);}else{i.addListener(this.dropdown,"blur",function(j){this.save();},this,true);i.addListener(this.dropdown,"click",function(j){this.save();},this,true);}}},resetForm:function(){var s=this.dropdown.options,p=0,o=s.length;if(c.isArray(this.value)){var l=this.value,k=0,r=l.length,q={};for(;p<o;p++){s[p].selected=false;q[s[p].value]=s[p];}for(;k<r;k++){if(q[l[k]]){q[l[k]].selected=true;}}}else{for(;p<o;p++){if(this.value==s[p].value){s[p].selected=true;}}}},focus:function(){this.getDataTable()._focusEl(this.dropdown);},getInputValue:function(){var n=this.dropdown.options;if(this.multiple){var k=[],m=0,l=n.length;for(;m<l;m++){if(n[m].selected){k.push(n[m].value);}}return k;}else{return n[n.selectedIndex].value;}}});c.augmentObject(e.DropdownCellEditor,a);e.RadioCellEditor=function(j){j=j||{};this._sId=this._sId||d.generateId(null,"yui-radioceditor");YAHOO.widget.BaseCellEditor._nCount++;e.RadioCellEditor.superclass.constructor.call(this,j.type||"radio",j);};c.extend(e.RadioCellEditor,a,{radios:null,radioOptions:null,renderForm:function(){if(c.isArray(this.radioOptions)){var k,l,r,o;for(var n=0,p=this.radioOptions.length;n<p;n++){k=this.radioOptions[n];l=c.isValue(k.value)?k.value:k;r=this.getId()+"-radio"+n;this.getContainerEl().innerHTML+='<input type="radio"'+' name="'+this.getId()+'"'+' value="'+l+'"'+' id="'+r+'" />';o=this.getContainerEl().appendChild(document.createElement("label"));o.htmlFor=r;o.innerHTML=(c.isValue(k.label))?k.label:k;}var q=[],s;for(var m=0;m<p;m++){s=this.getContainerEl().childNodes[m*2];q[q.length]=s;}this.radios=q;if(this.disableBtns){this.handleDisabledBtns();}}else{}},handleDisabledBtns:function(){i.addListener(this.getContainerEl(),"click",function(j){if(i.getTarget(j).tagName.toLowerCase()==="input"){this.save();}},this,true);},resetForm:function(){for(var m=0,l=this.radios.length;m<l;m++){var k=this.radios[m];if(this.value==k.value){k.checked=true;return;}}},focus:function(){for(var l=0,k=this.radios.length;l<k;l++){if(this.radios[l].checked){this.radios[l].focus();return;}}},getInputValue:function(){for(var l=0,k=this.radios.length;l<k;l++){if(this.radios[l].checked){return this.radios[l].value;}}}});c.augmentObject(e.RadioCellEditor,a);e.TextareaCellEditor=function(j){j=j||{};this._sId=this._sId||d.generateId(null,"yui-textareaceditor");YAHOO.widget.BaseCellEditor._nCount++;e.TextareaCellEditor.superclass.constructor.call(this,j.type||"textarea",j);};c.extend(e.TextareaCellEditor,a,{textarea:null,renderForm:function(){var j=this.getContainerEl().appendChild(document.createElement("textarea"));this.textarea=j;if(this.disableBtns){this.handleDisabledBtns();}},handleDisabledBtns:function(){i.addListener(this.textarea,"blur",function(j){this.save();},this,true);},move:function(){this.textarea.style.width=this.getTdEl().offsetWidth+"px";this.textarea.style.height="3em";YAHOO.widget.TextareaCellEditor.superclass.move.call(this);},resetForm:function(){this.textarea.value=this.value;},focus:function(){this.getDataTable()._focusEl(this.textarea);this.textarea.select();},getInputValue:function(){return this.textarea.value;}});c.augmentObject(e.TextareaCellEditor,a);e.TextboxCellEditor=function(j){j=j||{};this._sId=this._sId||d.generateId(null,"yui-textboxceditor");YAHOO.widget.BaseCellEditor._nCount++;e.TextboxCellEditor.superclass.constructor.call(this,j.type||"textbox",j);};c.extend(e.TextboxCellEditor,a,{textbox:null,renderForm:function(){var j;if(b.webkit>420){j=this.getContainerEl().appendChild(document.createElement("form")).appendChild(document.createElement("input"));}else{j=this.getContainerEl().appendChild(document.createElement("input"));}j.type="text";this.textbox=j;i.addListener(j,"keypress",function(k){if((k.keyCode===13)){YAHOO.util.Event.preventDefault(k);this.save();}},this,true);if(this.disableBtns){this.handleDisabledBtns();}},move:function(){this.textbox.style.width=this.getTdEl().offsetWidth+"px";e.TextboxCellEditor.superclass.move.call(this);},resetForm:function(){this.textbox.value=c.isValue(this.value)?this.value.toString():"";},focus:function(){this.getDataTable()._focusEl(this.textbox);this.textbox.select();},getInputValue:function(){return this.textbox.value;
+}});c.augmentObject(e.TextboxCellEditor,a);h.Editors={checkbox:e.CheckboxCellEditor,"date":e.DateCellEditor,dropdown:e.DropdownCellEditor,radio:e.RadioCellEditor,textarea:e.TextareaCellEditor,textbox:e.TextboxCellEditor};e.CellEditor=function(k,j){if(k&&h.Editors[k]){c.augmentObject(a,h.Editors[k]);return new h.Editors[k](j);}else{return new a(null,j);}};var g=e.CellEditor;c.augmentObject(g,a);})();YAHOO.register("datatable",YAHOO.widget.DataTable,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/datemath/datemath-min.js b/js/yui/datemath/datemath-min.js
new file mode 100644 (file)
index 0000000..3445b28
--- /dev/null
+++ b/js/yui/datemath/datemath-min.js
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.widget.DateMath={DAY:"D",WEEK:"W",YEAR:"Y",MONTH:"M",ONE_DAY_MS:1000*60*60*24,WEEK_ONE_JAN_DATE:1,add:function(A,D,C){var F=new Date(A.getTime());switch(D){case this.MONTH:var E=A.getMonth()+C;var B=0;if(E<0){while(E<0){E+=12;B-=1;}}else{if(E>11){while(E>11){E-=12;B+=1;}}}F.setMonth(E);F.setFullYear(A.getFullYear()+B);break;case this.DAY:this._addDays(F,C);break;case this.YEAR:F.setFullYear(A.getFullYear()+C);break;case this.WEEK:this._addDays(F,(C*7));break;}return F;},_addDays:function(D,C){if(YAHOO.env.ua.webkit&&YAHOO.env.ua.webkit<420){if(C<0){for(var B=-128;C<B;C-=B){D.setDate(D.getDate()+B);}}else{for(var A=96;C>A;C-=A){D.setDate(D.getDate()+A);}}}D.setDate(D.getDate()+C);},subtract:function(A,C,B){return this.add(A,C,(B*-1));},before:function(C,B){var A=B.getTime();if(C.getTime()<A){return true;}else{return false;}},after:function(C,B){var A=B.getTime();if(C.getTime()>A){return true;}else{return false;}},between:function(B,A,C){if(this.after(B,A)&&this.before(B,C)){return true;}else{return false;}},getJan1:function(A){return this.getDate(A,0,1);},getDayOffset:function(B,D){var C=this.getJan1(D);var A=Math.ceil((B.getTime()-C.getTime())/this.ONE_DAY_MS);return A;},getWeekNumber:function(D,B,G){B=B||0;G=G||this.WEEK_ONE_JAN_DATE;var H=this.clearTime(D),L,M;if(H.getDay()===B){L=H;}else{L=this.getFirstDayOfWeek(H,B);}var I=L.getFullYear();M=new Date(L.getTime()+6*this.ONE_DAY_MS);var F;if(I!==M.getFullYear()&&M.getDate()>=G){F=1;}else{var E=this.clearTime(this.getDate(I,0,G)),A=this.getFirstDayOfWeek(E,B);var J=Math.round((H.getTime()-A.getTime())/this.ONE_DAY_MS);var K=J%7;var C=(J-K)/7;F=C+1;}return F;},getFirstDayOfWeek:function(D,A){A=A||0;var B=D.getDay(),C=(B-A+7)%7;return this.subtract(D,this.DAY,C);},isYearOverlapWeek:function(A){var C=false;var B=this.add(A,this.DAY,6);if(B.getFullYear()!=A.getFullYear()){C=true;}return C;},isMonthOverlapWeek:function(A){var C=false;var B=this.add(A,this.DAY,6);if(B.getMonth()!=A.getMonth()){C=true;}return C;},findMonthStart:function(A){var B=this.getDate(A.getFullYear(),A.getMonth(),1);return B;},findMonthEnd:function(B){var D=this.findMonthStart(B);var C=this.add(D,this.MONTH,1);var A=this.subtract(C,this.DAY,1);return A;},clearTime:function(A){A.setHours(12,0,0,0);return A;},getDate:function(D,A,C){var B=null;if(YAHOO.lang.isUndefined(C)){C=1;}if(D>=100){B=new Date(D,A,C);}else{B=new Date();B.setFullYear(D);B.setMonth(A);B.setDate(C);B.setHours(0,0,0,0);}return B;}};YAHOO.register("datemath",YAHOO.widget.DateMath,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/dom/dom-min.js b/js/yui/dom/dom-min.js
new file mode 100644 (file)
index 0000000..194f1e8
--- /dev/null
+++ b/js/yui/dom/dom-min.js
@@ -0,0 +1,9 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){YAHOO.env._id_counter=YAHOO.env._id_counter||0;var e=YAHOO.util,k=YAHOO.lang,L=YAHOO.env.ua,a=YAHOO.lang.trim,B={},F={},m=/^t(?:able|d|h)$/i,w=/color$/i,j=window.document,v=j.documentElement,C="ownerDocument",M="defaultView",U="documentElement",S="compatMode",z="offsetLeft",o="offsetTop",T="offsetParent",x="parentNode",K="nodeType",c="tagName",n="scrollLeft",H="scrollTop",p="getBoundingClientRect",V="getComputedStyle",y="currentStyle",l="CSS1Compat",A="BackCompat",E="class",f="className",i="",b=" ",R="(?:^|\\s)",J="(?= |$)",t="g",O="position",D="fixed",u="relative",I="left",N="top",Q="medium",P="borderLeftWidth",q="borderTopWidth",d=L.opera,h=L.webkit,g=L.gecko,s=L.ie;e.Dom={CUSTOM_ATTRIBUTES:(!v.hasAttribute)?{"for":"htmlFor","class":f}:{"htmlFor":"for","className":E},DOT_ATTRIBUTES:{checked:true},get:function(aa){var ac,X,ab,Z,W,G,Y=null;if(aa){if(typeof aa=="string"||typeof aa=="number"){ac=aa+"";aa=j.getElementById(aa);G=(aa)?aa.attributes:null;if(aa&&G&&G.id&&G.id.value===ac){return aa;}else{if(aa&&j.all){aa=null;X=j.all[ac];if(X&&X.length){for(Z=0,W=X.length;Z<W;++Z){if(X[Z].id===ac){return X[Z];}}}}}}else{if(e.Element&&aa instanceof e.Element){aa=aa.get("element");}else{if(!aa.nodeType&&"length" in aa){ab=[];for(Z=0,W=aa.length;Z<W;++Z){ab[ab.length]=e.Dom.get(aa[Z]);}aa=ab;}}}Y=aa;}return Y;},getComputedStyle:function(G,W){if(window[V]){return G[C][M][V](G,null)[W];}else{if(G[y]){return e.Dom.IE_ComputedStyle.get(G,W);}}},getStyle:function(G,W){return e.Dom.batch(G,e.Dom._getStyle,W);},_getStyle:function(){if(window[V]){return function(G,Y){Y=(Y==="float")?Y="cssFloat":e.Dom._toCamel(Y);var X=G.style[Y],W;if(!X){W=G[C][M][V](G,null);if(W){X=W[Y];}}return X;};}else{if(v[y]){return function(G,Y){var X;switch(Y){case"opacity":X=100;try{X=G.filters["DXImageTransform.Microsoft.Alpha"].opacity;}catch(Z){try{X=G.filters("alpha").opacity;}catch(W){}}return X/100;case"float":Y="styleFloat";default:Y=e.Dom._toCamel(Y);X=G[y]?G[y][Y]:null;return(G.style[Y]||X);}};}}}(),setStyle:function(G,W,X){e.Dom.batch(G,e.Dom._setStyle,{prop:W,val:X});},_setStyle:function(){if(!window.getComputedStyle&&j.documentElement.currentStyle){return function(W,G){var X=e.Dom._toCamel(G.prop),Y=G.val;if(W){switch(X){case"opacity":if(Y===""||Y===null||Y===1){W.style.removeAttribute("filter");}else{if(k.isString(W.style.filter)){W.style.filter="alpha(opacity="+Y*100+")";if(!W[y]||!W[y].hasLayout){W.style.zoom=1;}}}break;case"float":X="styleFloat";default:W.style[X]=Y;}}else{}};}else{return function(W,G){var X=e.Dom._toCamel(G.prop),Y=G.val;if(W){if(X=="float"){X="cssFloat";}W.style[X]=Y;}else{}};}}(),getXY:function(G){return e.Dom.batch(G,e.Dom._getXY);},_canPosition:function(G){return(e.Dom._getStyle(G,"display")!=="none"&&e.Dom._inDoc(G));},_getXY:function(W){var X,G,Z,ab,Y,aa,ac=Math.round,ad=false;if(e.Dom._canPosition(W)){Z=W[p]();ab=W[C];X=e.Dom.getDocumentScrollLeft(ab);G=e.Dom.getDocumentScrollTop(ab);ad=[Z[I],Z[N]];if(Y||aa){ad[0]-=aa;ad[1]-=Y;}if((G||X)){ad[0]+=X;ad[1]+=G;}ad[0]=ac(ad[0]);ad[1]=ac(ad[1]);}else{}return ad;},getX:function(G){var W=function(X){return e.Dom.getXY(X)[0];};return e.Dom.batch(G,W,e.Dom,true);},getY:function(G){var W=function(X){return e.Dom.getXY(X)[1];};return e.Dom.batch(G,W,e.Dom,true);},setXY:function(G,X,W){e.Dom.batch(G,e.Dom._setXY,{pos:X,noRetry:W});},_setXY:function(G,Z){var aa=e.Dom._getStyle(G,O),Y=e.Dom.setStyle,ad=Z.pos,W=Z.noRetry,ab=[parseInt(e.Dom.getComputedStyle(G,I),10),parseInt(e.Dom.getComputedStyle(G,N),10)],ac,X;ac=e.Dom._getXY(G);if(!ad||ac===false){return false;}if(aa=="static"){aa=u;Y(G,O,aa);}if(isNaN(ab[0])){ab[0]=(aa==u)?0:G[z];}if(isNaN(ab[1])){ab[1]=(aa==u)?0:G[o];}if(ad[0]!==null){Y(G,I,ad[0]-ac[0]+ab[0]+"px");}if(ad[1]!==null){Y(G,N,ad[1]-ac[1]+ab[1]+"px");}if(!W){X=e.Dom._getXY(G);if((ad[0]!==null&&X[0]!=ad[0])||(ad[1]!==null&&X[1]!=ad[1])){e.Dom._setXY(G,{pos:ad,noRetry:true});}}},setX:function(W,G){e.Dom.setXY(W,[G,null]);},setY:function(G,W){e.Dom.setXY(G,[null,W]);},getRegion:function(G){var W=function(X){var Y=false;if(e.Dom._canPosition(X)){Y=e.Region.getRegion(X);}else{}return Y;};return e.Dom.batch(G,W,e.Dom,true);},getClientWidth:function(){return e.Dom.getViewportWidth();},getClientHeight:function(){return e.Dom.getViewportHeight();},getElementsByClassName:function(ab,af,ac,ae,X,ad){af=af||"*";ac=(ac)?e.Dom.get(ac):null||j;if(!ac){return[];}var W=[],G=ac.getElementsByTagName(af),Z=e.Dom.hasClass;for(var Y=0,aa=G.length;Y<aa;++Y){if(Z(G[Y],ab)){W[W.length]=G[Y];}}if(ae){e.Dom.batch(W,ae,X,ad);}return W;},hasClass:function(W,G){return e.Dom.batch(W,e.Dom._hasClass,G);},_hasClass:function(X,W){var G=false,Y;if(X&&W){Y=e.Dom._getAttribute(X,f)||i;if(Y){Y=Y.replace(/\s+/g,b);}if(W.exec){G=W.test(Y);}else{G=W&&(b+Y+b).indexOf(b+W+b)>-1;}}else{}return G;},addClass:function(W,G){return e.Dom.batch(W,e.Dom._addClass,G);},_addClass:function(X,W){var G=false,Y;if(X&&W){Y=e.Dom._getAttribute(X,f)||i;if(!e.Dom._hasClass(X,W)){e.Dom.setAttribute(X,f,a(Y+b+W));G=true;}}else{}return G;},removeClass:function(W,G){return e.Dom.batch(W,e.Dom._removeClass,G);},_removeClass:function(Y,X){var W=false,aa,Z,G;if(Y&&X){aa=e.Dom._getAttribute(Y,f)||i;e.Dom.setAttribute(Y,f,aa.replace(e.Dom._getClassRegex(X),i));Z=e.Dom._getAttribute(Y,f);if(aa!==Z){e.Dom.setAttribute(Y,f,a(Z));W=true;if(e.Dom._getAttribute(Y,f)===""){G=(Y.hasAttribute&&Y.hasAttribute(E))?E:f;Y.removeAttribute(G);}}}else{}return W;},replaceClass:function(X,W,G){return e.Dom.batch(X,e.Dom._replaceClass,{from:W,to:G});},_replaceClass:function(Y,X){var W,ab,aa,G=false,Z;if(Y&&X){ab=X.from;aa=X.to;if(!aa){G=false;}else{if(!ab){G=e.Dom._addClass(Y,X.to);}else{if(ab!==aa){Z=e.Dom._getAttribute(Y,f)||i;W=(b+Z.replace(e.Dom._getClassRegex(ab),b+aa).replace(/\s+/g,b)).split(e.Dom._getClassRegex(aa));W.splice(1,0,b+aa);e.Dom.setAttribute(Y,f,a(W.join(i)));G=true;}}}}else{}return G;},generateId:function(G,X){X=X||"yui-gen";var W=function(Y){if(Y&&Y.id){return Y.id;}var Z=X+YAHOO.env._id_counter++;
+if(Y){if(Y[C]&&Y[C].getElementById(Z)){return e.Dom.generateId(Y,Z+X);}Y.id=Z;}return Z;};return e.Dom.batch(G,W,e.Dom,true)||W.apply(e.Dom,arguments);},isAncestor:function(W,X){W=e.Dom.get(W);X=e.Dom.get(X);var G=false;if((W&&X)&&(W[K]&&X[K])){if(W.contains&&W!==X){G=W.contains(X);}else{if(W.compareDocumentPosition){G=!!(W.compareDocumentPosition(X)&16);}}}else{}return G;},inDocument:function(G,W){return e.Dom._inDoc(e.Dom.get(G),W);},_inDoc:function(W,X){var G=false;if(W&&W[c]){X=X||W[C];G=e.Dom.isAncestor(X[U],W);}else{}return G;},getElementsBy:function(W,af,ab,ad,X,ac,ae){af=af||"*";ab=(ab)?e.Dom.get(ab):null||j;var aa=(ae)?null:[],G;if(ab){G=ab.getElementsByTagName(af);for(var Y=0,Z=G.length;Y<Z;++Y){if(W(G[Y])){if(ae){aa=G[Y];break;}else{aa[aa.length]=G[Y];}}}if(ad){e.Dom.batch(aa,ad,X,ac);}}return aa;},getElementBy:function(X,G,W){return e.Dom.getElementsBy(X,G,W,null,null,null,true);},batch:function(X,ab,aa,Z){var Y=[],W=(Z)?aa:null;X=(X&&(X[c]||X.item))?X:e.Dom.get(X);if(X&&ab){if(X[c]||X.length===undefined){return ab.call(W,X,aa);}for(var G=0;G<X.length;++G){Y[Y.length]=ab.call(W||X[G],X[G],aa);}}else{return false;}return Y;},getDocumentHeight:function(){var W=(j[S]!=l||h)?j.body.scrollHeight:v.scrollHeight,G=Math.max(W,e.Dom.getViewportHeight());return G;},getDocumentWidth:function(){var W=(j[S]!=l||h)?j.body.scrollWidth:v.scrollWidth,G=Math.max(W,e.Dom.getViewportWidth());return G;},getViewportHeight:function(){var G=self.innerHeight,W=j[S];if((W||s)&&!d){G=(W==l)?v.clientHeight:j.body.clientHeight;}return G;},getViewportWidth:function(){var G=self.innerWidth,W=j[S];if(W||s){G=(W==l)?v.clientWidth:j.body.clientWidth;}return G;},getAncestorBy:function(G,W){while((G=G[x])){if(e.Dom._testElement(G,W)){return G;}}return null;},getAncestorByClassName:function(W,G){W=e.Dom.get(W);if(!W){return null;}var X=function(Y){return e.Dom.hasClass(Y,G);};return e.Dom.getAncestorBy(W,X);},getAncestorByTagName:function(W,G){W=e.Dom.get(W);if(!W){return null;}var X=function(Y){return Y[c]&&Y[c].toUpperCase()==G.toUpperCase();};return e.Dom.getAncestorBy(W,X);},getPreviousSiblingBy:function(G,W){while(G){G=G.previousSibling;if(e.Dom._testElement(G,W)){return G;}}return null;},getPreviousSibling:function(G){G=e.Dom.get(G);if(!G){return null;}return e.Dom.getPreviousSiblingBy(G);},getNextSiblingBy:function(G,W){while(G){G=G.nextSibling;if(e.Dom._testElement(G,W)){return G;}}return null;},getNextSibling:function(G){G=e.Dom.get(G);if(!G){return null;}return e.Dom.getNextSiblingBy(G);},getFirstChildBy:function(G,X){var W=(e.Dom._testElement(G.firstChild,X))?G.firstChild:null;return W||e.Dom.getNextSiblingBy(G.firstChild,X);},getFirstChild:function(G,W){G=e.Dom.get(G);if(!G){return null;}return e.Dom.getFirstChildBy(G);},getLastChildBy:function(G,X){if(!G){return null;}var W=(e.Dom._testElement(G.lastChild,X))?G.lastChild:null;return W||e.Dom.getPreviousSiblingBy(G.lastChild,X);},getLastChild:function(G){G=e.Dom.get(G);return e.Dom.getLastChildBy(G);},getChildrenBy:function(W,Y){var X=e.Dom.getFirstChildBy(W,Y),G=X?[X]:[];e.Dom.getNextSiblingBy(X,function(Z){if(!Y||Y(Z)){G[G.length]=Z;}return false;});return G;},getChildren:function(G){G=e.Dom.get(G);if(!G){}return e.Dom.getChildrenBy(G);},getDocumentScrollLeft:function(G){G=G||j;return Math.max(G[U].scrollLeft,G.body.scrollLeft);},getDocumentScrollTop:function(G){G=G||j;return Math.max(G[U].scrollTop,G.body.scrollTop);},insertBefore:function(W,G){W=e.Dom.get(W);G=e.Dom.get(G);if(!W||!G||!G[x]){return null;}return G[x].insertBefore(W,G);},insertAfter:function(W,G){W=e.Dom.get(W);G=e.Dom.get(G);if(!W||!G||!G[x]){return null;}if(G.nextSibling){return G[x].insertBefore(W,G.nextSibling);}else{return G[x].appendChild(W);}},getClientRegion:function(){var X=e.Dom.getDocumentScrollTop(),W=e.Dom.getDocumentScrollLeft(),Y=e.Dom.getViewportWidth()+W,G=e.Dom.getViewportHeight()+X;return new e.Region(X,Y,G,W);},setAttribute:function(W,G,X){e.Dom.batch(W,e.Dom._setAttribute,{attr:G,val:X});},_setAttribute:function(X,W){var G=e.Dom._toCamel(W.attr),Y=W.val;if(X&&X.setAttribute){if(e.Dom.DOT_ATTRIBUTES[G]&&X.tagName&&X.tagName!="BUTTON"){X[G]=Y;}else{G=e.Dom.CUSTOM_ATTRIBUTES[G]||G;X.setAttribute(G,Y);}}else{}},getAttribute:function(W,G){return e.Dom.batch(W,e.Dom._getAttribute,G);},_getAttribute:function(W,G){var X;G=e.Dom.CUSTOM_ATTRIBUTES[G]||G;if(e.Dom.DOT_ATTRIBUTES[G]){X=W[G];}else{if(W&&"getAttribute" in W){if(/^(?:href|src)$/.test(G)){X=W.getAttribute(G,2);}else{X=W.getAttribute(G);}}else{}}return X;},_toCamel:function(W){var X=B;function G(Y,Z){return Z.toUpperCase();}return X[W]||(X[W]=W.indexOf("-")===-1?W:W.replace(/-([a-z])/gi,G));},_getClassRegex:function(W){var G;if(W!==undefined){if(W.exec){G=W;}else{G=F[W];if(!G){W=W.replace(e.Dom._patterns.CLASS_RE_TOKENS,"\\$1");W=W.replace(/\s+/g,b);G=F[W]=new RegExp(R+W+J,t);}}}return G;},_patterns:{ROOT_TAG:/^body|html$/i,CLASS_RE_TOKENS:/([\.\(\)\^\$\*\+\?\|\[\]\{\}\\])/g},_testElement:function(G,W){return G&&G[K]==1&&(!W||W(G));},_calcBorders:function(X,Y){var W=parseInt(e.Dom[V](X,q),10)||0,G=parseInt(e.Dom[V](X,P),10)||0;if(g){if(m.test(X[c])){W=0;G=0;}}Y[0]+=G;Y[1]+=W;return Y;}};var r=e.Dom[V];if(L.opera){e.Dom[V]=function(W,G){var X=r(W,G);if(w.test(G)){X=e.Dom.Color.toRGB(X);}return X;};}if(L.webkit){e.Dom[V]=function(W,G){var X=r(W,G);if(X==="rgba(0, 0, 0, 0)"){X="transparent";}return X;};}if(L.ie&&L.ie>=8){e.Dom.DOT_ATTRIBUTES.type=true;}})();YAHOO.util.Region=function(d,e,a,c){this.top=d;this.y=d;this[1]=d;this.right=e;this.bottom=a;this.left=c;this.x=c;this[0]=c;this.width=this.right-this.left;this.height=this.bottom-this.top;};YAHOO.util.Region.prototype.contains=function(a){return(a.left>=this.left&&a.right<=this.right&&a.top>=this.top&&a.bottom<=this.bottom);};YAHOO.util.Region.prototype.getArea=function(){return((this.bottom-this.top)*(this.right-this.left));};YAHOO.util.Region.prototype.intersect=function(f){var d=Math.max(this.top,f.top),e=Math.min(this.right,f.right),a=Math.min(this.bottom,f.bottom),c=Math.max(this.left,f.left);
+if(a>=d&&e>=c){return new YAHOO.util.Region(d,e,a,c);}else{return null;}};YAHOO.util.Region.prototype.union=function(f){var d=Math.min(this.top,f.top),e=Math.max(this.right,f.right),a=Math.max(this.bottom,f.bottom),c=Math.min(this.left,f.left);return new YAHOO.util.Region(d,e,a,c);};YAHOO.util.Region.prototype.toString=function(){return("Region {"+"top: "+this.top+", right: "+this.right+", bottom: "+this.bottom+", left: "+this.left+", height: "+this.height+", width: "+this.width+"}");};YAHOO.util.Region.getRegion=function(e){var g=YAHOO.util.Dom.getXY(e),d=g[1],f=g[0]+e.offsetWidth,a=g[1]+e.offsetHeight,c=g[0];return new YAHOO.util.Region(d,f,a,c);};YAHOO.util.Point=function(a,b){if(YAHOO.lang.isArray(a)){b=a[1];a=a[0];}YAHOO.util.Point.superclass.constructor.call(this,b,a,b,a);};YAHOO.extend(YAHOO.util.Point,YAHOO.util.Region);(function(){var b=YAHOO.util,a="clientTop",f="clientLeft",j="parentNode",k="right",w="hasLayout",i="px",u="opacity",l="auto",d="borderLeftWidth",g="borderTopWidth",p="borderRightWidth",v="borderBottomWidth",s="visible",q="transparent",n="height",e="width",h="style",t="currentStyle",r=/^width|height$/,o=/^(\d[.\d]*)+(em|ex|px|gd|rem|vw|vh|vm|ch|mm|cm|in|pt|pc|deg|rad|ms|s|hz|khz|%){1}?/i,m={get:function(x,z){var y="",A=x[t][z];if(z===u){y=b.Dom.getStyle(x,u);}else{if(!A||(A.indexOf&&A.indexOf(i)>-1)){y=A;}else{if(b.Dom.IE_COMPUTED[z]){y=b.Dom.IE_COMPUTED[z](x,z);}else{if(o.test(A)){y=b.Dom.IE.ComputedStyle.getPixel(x,z);}else{y=A;}}}}return y;},getOffset:function(z,E){var B=z[t][E],x=E.charAt(0).toUpperCase()+E.substr(1),C="offset"+x,y="pixel"+x,A="",D;if(B==l){D=z[C];if(D===undefined){A=0;}A=D;if(r.test(E)){z[h][E]=D;if(z[C]>D){A=D-(z[C]-D);}z[h][E]=l;}}else{if(!z[h][y]&&!z[h][E]){z[h][E]=B;}A=z[h][y];}return A+i;},getBorderWidth:function(x,z){var y=null;if(!x[t][w]){x[h].zoom=1;}switch(z){case g:y=x[a];break;case v:y=x.offsetHeight-x.clientHeight-x[a];break;case d:y=x[f];break;case p:y=x.offsetWidth-x.clientWidth-x[f];break;}return y+i;},getPixel:function(y,x){var A=null,B=y[t][k],z=y[t][x];y[h][k]=z;A=y[h].pixelRight;y[h][k]=B;return A+i;},getMargin:function(y,x){var z;if(y[t][x]==l){z=0+i;}else{z=b.Dom.IE.ComputedStyle.getPixel(y,x);}return z;},getVisibility:function(y,x){var z;while((z=y[t])&&z[x]=="inherit"){y=y[j];}return(z)?z[x]:s;},getColor:function(y,x){return b.Dom.Color.toRGB(y[t][x])||q;},getBorderColor:function(y,x){var z=y[t],A=z[x]||z.color;return b.Dom.Color.toRGB(b.Dom.Color.toHex(A));}},c={};c.top=c.right=c.bottom=c.left=c[e]=c[n]=m.getOffset;c.color=m.getColor;c[g]=c[p]=c[v]=c[d]=m.getBorderWidth;c.marginTop=c.marginRight=c.marginBottom=c.marginLeft=m.getMargin;c.visibility=m.getVisibility;c.borderColor=c.borderTopColor=c.borderRightColor=c.borderBottomColor=c.borderLeftColor=m.getBorderColor;b.Dom.IE_COMPUTED=c;b.Dom.IE_ComputedStyle=m;})();(function(){var c="toString",a=parseInt,b=RegExp,d=YAHOO.util;d.Dom.Color={KEYWORDS:{black:"000",silver:"c0c0c0",gray:"808080",white:"fff",maroon:"800000",red:"f00",purple:"800080",fuchsia:"f0f",green:"008000",lime:"0f0",olive:"808000",yellow:"ff0",navy:"000080",blue:"00f",teal:"008080",aqua:"0ff"},re_RGB:/^rgb\(([0-9]+)\s*,\s*([0-9]+)\s*,\s*([0-9]+)\)$/i,re_hex:/^#?([0-9A-F]{2})([0-9A-F]{2})([0-9A-F]{2})$/i,re_hex3:/([0-9A-F])/gi,toRGB:function(e){if(!d.Dom.Color.re_RGB.test(e)){e=d.Dom.Color.toHex(e);}if(d.Dom.Color.re_hex.exec(e)){e="rgb("+[a(b.$1,16),a(b.$2,16),a(b.$3,16)].join(", ")+")";}return e;},toHex:function(f){f=d.Dom.Color.KEYWORDS[f]||f;if(d.Dom.Color.re_RGB.exec(f)){f=[Number(b.$1).toString(16),Number(b.$2).toString(16),Number(b.$3).toString(16)];for(var e=0;e<f.length;e++){if(f[e].length<2){f[e]="0"+f[e];}}f=f.join("");}if(f.length<6){f=f.replace(d.Dom.Color.re_hex3,"$1$1");}if(f!=="transparent"&&f.indexOf("#")<0){f="#"+f;}return f.toUpperCase();}};}());YAHOO.register("dom",YAHOO.util.Dom,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/dragdrop/dragdrop-min.js b/js/yui/dragdrop/dragdrop-min.js
new file mode 100644 (file)
index 0000000..29b507f
--- /dev/null
+++ b/js/yui/dragdrop/dragdrop-min.js
@@ -0,0 +1,10 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+if(!YAHOO.util.DragDropMgr){YAHOO.util.DragDropMgr=function(){var A=YAHOO.util.Event,B=YAHOO.util.Dom;return{useShim:false,_shimActive:false,_shimState:false,_debugShim:false,_createShim:function(){var C=document.createElement("div");C.id="yui-ddm-shim";if(document.body.firstChild){document.body.insertBefore(C,document.body.firstChild);}else{document.body.appendChild(C);}C.style.display="none";C.style.backgroundColor="red";C.style.position="absolute";C.style.zIndex="99999";B.setStyle(C,"opacity","0");this._shim=C;A.on(C,"mouseup",this.handleMouseUp,this,true);A.on(C,"mousemove",this.handleMouseMove,this,true);A.on(window,"scroll",this._sizeShim,this,true);},_sizeShim:function(){if(this._shimActive){var C=this._shim;C.style.height=B.getDocumentHeight()+"px";C.style.width=B.getDocumentWidth()+"px";C.style.top="0";C.style.left="0";}},_activateShim:function(){if(this.useShim){if(!this._shim){this._createShim();}this._shimActive=true;var C=this._shim,D="0";if(this._debugShim){D=".5";}B.setStyle(C,"opacity",D);this._sizeShim();C.style.display="block";}},_deactivateShim:function(){this._shim.style.display="none";this._shimActive=false;},_shim:null,ids:{},handleIds:{},dragCurrent:null,dragOvers:{},deltaX:0,deltaY:0,preventDefault:true,stopPropagation:true,initialized:false,locked:false,interactionInfo:null,init:function(){this.initialized=true;},POINT:0,INTERSECT:1,STRICT_INTERSECT:2,mode:0,_execOnAll:function(E,D){for(var F in this.ids){for(var C in this.ids[F]){var G=this.ids[F][C];if(!this.isTypeOfDD(G)){continue;}G[E].apply(G,D);}}},_onLoad:function(){this.init();A.on(document,"mouseup",this.handleMouseUp,this,true);A.on(document,"mousemove",this.handleMouseMove,this,true);A.on(window,"unload",this._onUnload,this,true);A.on(window,"resize",this._onResize,this,true);},_onResize:function(C){this._execOnAll("resetConstraints",[]);},lock:function(){this.locked=true;},unlock:function(){this.locked=false;},isLocked:function(){return this.locked;},locationCache:{},useCache:true,clickPixelThresh:3,clickTimeThresh:1000,dragThreshMet:false,clickTimeout:null,startX:0,startY:0,fromTimeout:false,regDragDrop:function(D,C){if(!this.initialized){this.init();}if(!this.ids[C]){this.ids[C]={};}this.ids[C][D.id]=D;},removeDDFromGroup:function(E,C){if(!this.ids[C]){this.ids[C]={};}var D=this.ids[C];if(D&&D[E.id]){delete D[E.id];}},_remove:function(E){for(var D in E.groups){if(D){var C=this.ids[D];if(C&&C[E.id]){delete C[E.id];}}}delete this.handleIds[E.id];},regHandle:function(D,C){if(!this.handleIds[D]){this.handleIds[D]={};}this.handleIds[D][C]=C;},isDragDrop:function(C){return(this.getDDById(C))?true:false;},getRelated:function(H,D){var G=[];for(var F in H.groups){for(var E in this.ids[F]){var C=this.ids[F][E];if(!this.isTypeOfDD(C)){continue;}if(!D||C.isTarget){G[G.length]=C;}}}return G;},isLegalTarget:function(G,F){var D=this.getRelated(G,true);for(var E=0,C=D.length;E<C;++E){if(D[E].id==F.id){return true;}}return false;},isTypeOfDD:function(C){return(C&&C.__ygDragDrop);},isHandle:function(D,C){return(this.handleIds[D]&&this.handleIds[D][C]);},getDDById:function(D){for(var C in this.ids){if(this.ids[C][D]){return this.ids[C][D];}}return null;},handleMouseDown:function(E,D){this.currentTarget=YAHOO.util.Event.getTarget(E);this.dragCurrent=D;var C=D.getEl();this.startX=YAHOO.util.Event.getPageX(E);this.startY=YAHOO.util.Event.getPageY(E);this.deltaX=this.startX-C.offsetLeft;this.deltaY=this.startY-C.offsetTop;this.dragThreshMet=false;this.clickTimeout=setTimeout(function(){var F=YAHOO.util.DDM;F.startDrag(F.startX,F.startY);F.fromTimeout=true;},this.clickTimeThresh);},startDrag:function(C,E){if(this.dragCurrent&&this.dragCurrent.useShim){this._shimState=this.useShim;this.useShim=true;}this._activateShim();clearTimeout(this.clickTimeout);var D=this.dragCurrent;if(D&&D.events.b4StartDrag){D.b4StartDrag(C,E);D.fireEvent("b4StartDragEvent",{x:C,y:E});}if(D&&D.events.startDrag){D.startDrag(C,E);D.fireEvent("startDragEvent",{x:C,y:E});}this.dragThreshMet=true;},handleMouseUp:function(C){if(this.dragCurrent){clearTimeout(this.clickTimeout);if(this.dragThreshMet){if(this.fromTimeout){this.fromTimeout=false;this.handleMouseMove(C);}this.fromTimeout=false;this.fireEvents(C,true);}else{}this.stopDrag(C);this.stopEvent(C);}},stopEvent:function(C){if(this.stopPropagation){YAHOO.util.Event.stopPropagation(C);}if(this.preventDefault){YAHOO.util.Event.preventDefault(C);}},stopDrag:function(E,D){var C=this.dragCurrent;if(C&&!D){if(this.dragThreshMet){if(C.events.b4EndDrag){C.b4EndDrag(E);C.fireEvent("b4EndDragEvent",{e:E});}if(C.events.endDrag){C.endDrag(E);C.fireEvent("endDragEvent",{e:E});}}if(C.events.mouseUp){C.onMouseUp(E);C.fireEvent("mouseUpEvent",{e:E});}}if(this._shimActive){this._deactivateShim();if(this.dragCurrent&&this.dragCurrent.useShim){this.useShim=this._shimState;this._shimState=false;}}this.dragCurrent=null;this.dragOvers={};},handleMouseMove:function(F){var C=this.dragCurrent;if(C){if(YAHOO.env.ua.ie&&(YAHOO.env.ua.ie<9)&&!F.button){this.stopEvent(F);return this.handleMouseUp(F);}else{if(F.clientX<0||F.clientY<0){}}if(!this.dragThreshMet){var E=Math.abs(this.startX-YAHOO.util.Event.getPageX(F));var D=Math.abs(this.startY-YAHOO.util.Event.getPageY(F));if(E>this.clickPixelThresh||D>this.clickPixelThresh){this.startDrag(this.startX,this.startY);}}if(this.dragThreshMet){if(C&&C.events.b4Drag){C.b4Drag(F);C.fireEvent("b4DragEvent",{e:F});}if(C&&C.events.drag){C.onDrag(F);C.fireEvent("dragEvent",{e:F});}if(C){this.fireEvents(F,false);}}this.stopEvent(F);}},fireEvents:function(W,M){var c=this.dragCurrent;if(!c||c.isLocked()||c.dragOnly){return;}var O=YAHOO.util.Event.getPageX(W),N=YAHOO.util.Event.getPageY(W),Q=new YAHOO.util.Point(O,N),K=c.getTargetCoord(Q.x,Q.y),F=c.getDragEl(),E=["out","over","drop","enter"],V=new YAHOO.util.Region(K.y,K.x+F.offsetWidth,K.y+F.offsetHeight,K.x),I=[],D={},L={},R=[],d={outEvts:[],overEvts:[],dropEvts:[],enterEvts:[]};for(var T in this.dragOvers){var f=this.dragOvers[T];if(!this.isTypeOfDD(f)){continue;
+}if(!this.isOverTarget(Q,f,this.mode,V)){d.outEvts.push(f);}I[T]=true;delete this.dragOvers[T];}for(var S in c.groups){if("string"!=typeof S){continue;}for(T in this.ids[S]){var G=this.ids[S][T];if(!this.isTypeOfDD(G)){continue;}if(G.isTarget&&!G.isLocked()&&G!=c){if(this.isOverTarget(Q,G,this.mode,V)){D[S]=true;if(M){d.dropEvts.push(G);}else{if(!I[G.id]){d.enterEvts.push(G);}else{d.overEvts.push(G);}this.dragOvers[G.id]=G;}}}}}this.interactionInfo={out:d.outEvts,enter:d.enterEvts,over:d.overEvts,drop:d.dropEvts,point:Q,draggedRegion:V,sourceRegion:this.locationCache[c.id],validDrop:M};for(var C in D){R.push(C);}if(M&&!d.dropEvts.length){this.interactionInfo.validDrop=false;if(c.events.invalidDrop){c.onInvalidDrop(W);c.fireEvent("invalidDropEvent",{e:W});}}for(T=0;T<E.length;T++){var Z=null;if(d[E[T]+"Evts"]){Z=d[E[T]+"Evts"];}if(Z&&Z.length){var H=E[T].charAt(0).toUpperCase()+E[T].substr(1),Y="onDrag"+H,J="b4Drag"+H,P="drag"+H+"Event",X="drag"+H;if(this.mode){if(c.events[J]){c[J](W,Z,R);L[Y]=c.fireEvent(J+"Event",{event:W,info:Z,group:R});}if(c.events[X]&&(L[Y]!==false)){c[Y](W,Z,R);c.fireEvent(P,{event:W,info:Z,group:R});}}else{for(var a=0,U=Z.length;a<U;++a){if(c.events[J]){c[J](W,Z[a].id,R[0]);L[Y]=c.fireEvent(J+"Event",{event:W,info:Z[a].id,group:R[0]});}if(c.events[X]&&(L[Y]!==false)){c[Y](W,Z[a].id,R[0]);c.fireEvent(P,{event:W,info:Z[a].id,group:R[0]});}}}}}},getBestMatch:function(E){var G=null;var D=E.length;if(D==1){G=E[0];}else{for(var F=0;F<D;++F){var C=E[F];if(this.mode==this.INTERSECT&&C.cursorIsOver){G=C;break;}else{if(!G||!G.overlap||(C.overlap&&G.overlap.getArea()<C.overlap.getArea())){G=C;}}}}return G;},refreshCache:function(D){var F=D||this.ids;for(var C in F){if("string"!=typeof C){continue;}for(var E in this.ids[C]){var G=this.ids[C][E];if(this.isTypeOfDD(G)){var H=this.getLocation(G);if(H){this.locationCache[G.id]=H;}else{delete this.locationCache[G.id];}}}}},verifyEl:function(D){try{if(D){var C=D.offsetParent;if(C){return true;}}}catch(E){}return false;},getLocation:function(H){if(!this.isTypeOfDD(H)){return null;}var F=H.getEl(),K,E,D,M,L,N,C,J,G;try{K=YAHOO.util.Dom.getXY(F);}catch(I){}if(!K){return null;}E=K[0];D=E+F.offsetWidth;M=K[1];L=M+F.offsetHeight;N=M-H.padding[0];C=D+H.padding[1];J=L+H.padding[2];G=E-H.padding[3];return new YAHOO.util.Region(N,C,J,G);},isOverTarget:function(K,C,E,F){var G=this.locationCache[C.id];if(!G||!this.useCache){G=this.getLocation(C);this.locationCache[C.id]=G;}if(!G){return false;}C.cursorIsOver=G.contains(K);var J=this.dragCurrent;if(!J||(!E&&!J.constrainX&&!J.constrainY)){return C.cursorIsOver;}C.overlap=null;if(!F){var H=J.getTargetCoord(K.x,K.y);var D=J.getDragEl();F=new YAHOO.util.Region(H.y,H.x+D.offsetWidth,H.y+D.offsetHeight,H.x);}var I=F.intersect(G);if(I){C.overlap=I;return(E)?true:C.cursorIsOver;}else{return false;}},_onUnload:function(D,C){this.unregAll();},unregAll:function(){if(this.dragCurrent){this.stopDrag();this.dragCurrent=null;}this._execOnAll("unreg",[]);this.ids={};},elementCache:{},getElWrapper:function(D){var C=this.elementCache[D];if(!C||!C.el){C=this.elementCache[D]=new this.ElementWrapper(YAHOO.util.Dom.get(D));}return C;},getElement:function(C){return YAHOO.util.Dom.get(C);},getCss:function(D){var C=YAHOO.util.Dom.get(D);return(C)?C.style:null;},ElementWrapper:function(C){this.el=C||null;this.id=this.el&&C.id;this.css=this.el&&C.style;},getPosX:function(C){return YAHOO.util.Dom.getX(C);},getPosY:function(C){return YAHOO.util.Dom.getY(C);},swapNode:function(E,C){if(E.swapNode){E.swapNode(C);}else{var F=C.parentNode;var D=C.nextSibling;if(D==E){F.insertBefore(E,C);}else{if(C==E.nextSibling){F.insertBefore(C,E);}else{E.parentNode.replaceChild(C,E);F.insertBefore(E,D);}}}},getScroll:function(){var E,C,F=document.documentElement,D=document.body;if(F&&(F.scrollTop||F.scrollLeft)){E=F.scrollTop;C=F.scrollLeft;}else{if(D){E=D.scrollTop;C=D.scrollLeft;}else{}}return{top:E,left:C};},getStyle:function(D,C){return YAHOO.util.Dom.getStyle(D,C);},getScrollTop:function(){return this.getScroll().top;},getScrollLeft:function(){return this.getScroll().left;},moveToEl:function(C,E){var D=YAHOO.util.Dom.getXY(E);YAHOO.util.Dom.setXY(C,D);},getClientHeight:function(){return YAHOO.util.Dom.getViewportHeight();},getClientWidth:function(){return YAHOO.util.Dom.getViewportWidth();},numericSort:function(D,C){return(D-C);},_timeoutCount:0,_addListeners:function(){var C=YAHOO.util.DDM;if(YAHOO.util.Event&&document){C._onLoad();}else{if(C._timeoutCount>2000){}else{setTimeout(C._addListeners,10);if(document&&document.body){C._timeoutCount+=1;}}}},handleWasClicked:function(C,E){if(this.isHandle(E,C.id)){return true;}else{var D=C.parentNode;while(D){if(this.isHandle(E,D.id)){return true;}else{D=D.parentNode;}}}return false;}};}();YAHOO.util.DDM=YAHOO.util.DragDropMgr;YAHOO.util.DDM._addListeners();}(function(){var A=YAHOO.util.Event;var B=YAHOO.util.Dom;YAHOO.util.DragDrop=function(E,C,D){if(E){this.init(E,C,D);}};YAHOO.util.DragDrop.prototype={events:null,on:function(){this.subscribe.apply(this,arguments);},id:null,config:null,dragElId:null,handleElId:null,invalidHandleTypes:null,invalidHandleIds:null,invalidHandleClasses:null,startPageX:0,startPageY:0,groups:null,locked:false,lock:function(){this.locked=true;},unlock:function(){this.locked=false;},isTarget:true,padding:null,dragOnly:false,useShim:false,_domRef:null,__ygDragDrop:true,constrainX:false,constrainY:false,minX:0,maxX:0,minY:0,maxY:0,deltaX:0,deltaY:0,maintainOffset:false,xTicks:null,yTicks:null,primaryButtonOnly:true,available:false,hasOuterHandles:false,cursorIsOver:false,overlap:null,b4StartDrag:function(C,D){},startDrag:function(C,D){},b4Drag:function(C){},onDrag:function(C){},onDragEnter:function(C,D){},b4DragOver:function(C){},onDragOver:function(C,D){},b4DragOut:function(C){},onDragOut:function(C,D){},b4DragDrop:function(C){},onDragDrop:function(C,D){},onInvalidDrop:function(C){},b4EndDrag:function(C){},endDrag:function(C){},b4MouseDown:function(C){},onMouseDown:function(C){},onMouseUp:function(C){},onAvailable:function(){},getEl:function(){if(!this._domRef){this._domRef=B.get(this.id);
+}return this._domRef;},getDragEl:function(){return B.get(this.dragElId);},init:function(F,C,D){this.initTarget(F,C,D);A.on(this._domRef||this.id,"mousedown",this.handleMouseDown,this,true);for(var E in this.events){this.createEvent(E+"Event");}},initTarget:function(E,C,D){this.config=D||{};this.events={};this.DDM=YAHOO.util.DDM;this.groups={};if(typeof E!=="string"){this._domRef=E;E=B.generateId(E);}this.id=E;this.addToGroup((C)?C:"default");this.handleElId=E;A.onAvailable(E,this.handleOnAvailable,this,true);this.setDragElId(E);this.invalidHandleTypes={A:"A"};this.invalidHandleIds={};this.invalidHandleClasses=[];this.applyConfig();},applyConfig:function(){this.events={mouseDown:true,b4MouseDown:true,mouseUp:true,b4StartDrag:true,startDrag:true,b4EndDrag:true,endDrag:true,drag:true,b4Drag:true,invalidDrop:true,b4DragOut:true,dragOut:true,dragEnter:true,b4DragOver:true,dragOver:true,b4DragDrop:true,dragDrop:true};if(this.config.events){for(var C in this.config.events){if(this.config.events[C]===false){this.events[C]=false;}}}this.padding=this.config.padding||[0,0,0,0];this.isTarget=(this.config.isTarget!==false);this.maintainOffset=(this.config.maintainOffset);this.primaryButtonOnly=(this.config.primaryButtonOnly!==false);this.dragOnly=((this.config.dragOnly===true)?true:false);this.useShim=((this.config.useShim===true)?true:false);},handleOnAvailable:function(){this.available=true;this.resetConstraints();this.onAvailable();},setPadding:function(E,C,F,D){if(!C&&0!==C){this.padding=[E,E,E,E];}else{if(!F&&0!==F){this.padding=[E,C,E,C];}else{this.padding=[E,C,F,D];}}},setInitPosition:function(F,E){var G=this.getEl();if(!this.DDM.verifyEl(G)){if(G&&G.style&&(G.style.display=="none")){}else{}return;}var D=F||0;var C=E||0;var H=B.getXY(G);this.initPageX=H[0]-D;this.initPageY=H[1]-C;this.lastPageX=H[0];this.lastPageY=H[1];this.setStartPosition(H);},setStartPosition:function(D){var C=D||B.getXY(this.getEl());this.deltaSetXY=null;this.startPageX=C[0];this.startPageY=C[1];},addToGroup:function(C){this.groups[C]=true;this.DDM.regDragDrop(this,C);},removeFromGroup:function(C){if(this.groups[C]){delete this.groups[C];}this.DDM.removeDDFromGroup(this,C);},setDragElId:function(C){this.dragElId=C;},setHandleElId:function(C){if(typeof C!=="string"){C=B.generateId(C);}this.handleElId=C;this.DDM.regHandle(this.id,C);},setOuterHandleElId:function(C){if(typeof C!=="string"){C=B.generateId(C);}A.on(C,"mousedown",this.handleMouseDown,this,true);this.setHandleElId(C);this.hasOuterHandles=true;},unreg:function(){A.removeListener(this.id,"mousedown",this.handleMouseDown);this._domRef=null;this.DDM._remove(this);},isLocked:function(){return(this.DDM.isLocked()||this.locked);},handleMouseDown:function(J,I){var D=J.which||J.button;if(this.primaryButtonOnly&&D>1){return;}if(this.isLocked()){return;}var C=this.b4MouseDown(J),F=true;if(this.events.b4MouseDown){F=this.fireEvent("b4MouseDownEvent",J);}var E=this.onMouseDown(J),H=true;if(this.events.mouseDown){if(E===false){H=false;}else{H=this.fireEvent("mouseDownEvent",J);}}if((C===false)||(E===false)||(F===false)||(H===false)){return;}this.DDM.refreshCache(this.groups);var G=new YAHOO.util.Point(A.getPageX(J),A.getPageY(J));if(!this.hasOuterHandles&&!this.DDM.isOverTarget(G,this)){}else{if(this.clickValidator(J)){this.setStartPosition();this.DDM.handleMouseDown(J,this);this.DDM.stopEvent(J);}else{}}},clickValidator:function(D){var C=YAHOO.util.Event.getTarget(D);return(this.isValidHandleChild(C)&&(this.id==this.handleElId||this.DDM.handleWasClicked(C,this.id)));},getTargetCoord:function(E,D){var C=E-this.deltaX;var F=D-this.deltaY;if(this.constrainX){if(C<this.minX){C=this.minX;}if(C>this.maxX){C=this.maxX;}}if(this.constrainY){if(F<this.minY){F=this.minY;}if(F>this.maxY){F=this.maxY;}}C=this.getTick(C,this.xTicks);F=this.getTick(F,this.yTicks);return{x:C,y:F};},addInvalidHandleType:function(C){var D=C.toUpperCase();this.invalidHandleTypes[D]=D;},addInvalidHandleId:function(C){if(typeof C!=="string"){C=B.generateId(C);}this.invalidHandleIds[C]=C;},addInvalidHandleClass:function(C){this.invalidHandleClasses.push(C);},removeInvalidHandleType:function(C){var D=C.toUpperCase();delete this.invalidHandleTypes[D];},removeInvalidHandleId:function(C){if(typeof C!=="string"){C=B.generateId(C);}delete this.invalidHandleIds[C];},removeInvalidHandleClass:function(D){for(var E=0,C=this.invalidHandleClasses.length;E<C;++E){if(this.invalidHandleClasses[E]==D){delete this.invalidHandleClasses[E];}}},isValidHandleChild:function(F){var E=true;var H;try{H=F.nodeName.toUpperCase();}catch(G){H=F.nodeName;}E=E&&!this.invalidHandleTypes[H];E=E&&!this.invalidHandleIds[F.id];for(var D=0,C=this.invalidHandleClasses.length;E&&D<C;++D){E=!B.hasClass(F,this.invalidHandleClasses[D]);}return E;},setXTicks:function(F,C){this.xTicks=[];this.xTickSize=C;var E={};for(var D=this.initPageX;D>=this.minX;D=D-C){if(!E[D]){this.xTicks[this.xTicks.length]=D;E[D]=true;}}for(D=this.initPageX;D<=this.maxX;D=D+C){if(!E[D]){this.xTicks[this.xTicks.length]=D;E[D]=true;}}this.xTicks.sort(this.DDM.numericSort);},setYTicks:function(F,C){this.yTicks=[];this.yTickSize=C;var E={};for(var D=this.initPageY;D>=this.minY;D=D-C){if(!E[D]){this.yTicks[this.yTicks.length]=D;E[D]=true;}}for(D=this.initPageY;D<=this.maxY;D=D+C){if(!E[D]){this.yTicks[this.yTicks.length]=D;E[D]=true;}}this.yTicks.sort(this.DDM.numericSort);},setXConstraint:function(E,D,C){this.leftConstraint=parseInt(E,10);this.rightConstraint=parseInt(D,10);this.minX=this.initPageX-this.leftConstraint;this.maxX=this.initPageX+this.rightConstraint;if(C){this.setXTicks(this.initPageX,C);}this.constrainX=true;},clearConstraints:function(){this.constrainX=false;this.constrainY=false;this.clearTicks();},clearTicks:function(){this.xTicks=null;this.yTicks=null;this.xTickSize=0;this.yTickSize=0;},setYConstraint:function(C,E,D){this.topConstraint=parseInt(C,10);this.bottomConstraint=parseInt(E,10);this.minY=this.initPageY-this.topConstraint;this.maxY=this.initPageY+this.bottomConstraint;
+if(D){this.setYTicks(this.initPageY,D);}this.constrainY=true;},resetConstraints:function(){if(this.initPageX||this.initPageX===0){var D=(this.maintainOffset)?this.lastPageX-this.initPageX:0;var C=(this.maintainOffset)?this.lastPageY-this.initPageY:0;this.setInitPosition(D,C);}else{this.setInitPosition();}if(this.constrainX){this.setXConstraint(this.leftConstraint,this.rightConstraint,this.xTickSize);}if(this.constrainY){this.setYConstraint(this.topConstraint,this.bottomConstraint,this.yTickSize);}},getTick:function(I,F){if(!F){return I;}else{if(F[0]>=I){return F[0];}else{for(var D=0,C=F.length;D<C;++D){var E=D+1;if(F[E]&&F[E]>=I){var H=I-F[D];var G=F[E]-I;return(G>H)?F[D]:F[E];}}return F[F.length-1];}}},toString:function(){return("DragDrop "+this.id);}};YAHOO.augment(YAHOO.util.DragDrop,YAHOO.util.EventProvider);})();YAHOO.util.DD=function(C,A,B){if(C){this.init(C,A,B);}};YAHOO.extend(YAHOO.util.DD,YAHOO.util.DragDrop,{scroll:true,autoOffset:function(C,B){var A=C-this.startPageX;var D=B-this.startPageY;this.setDelta(A,D);},setDelta:function(B,A){this.deltaX=B;this.deltaY=A;},setDragElPos:function(C,B){var A=this.getDragEl();this.alignElWithMouse(A,C,B);},alignElWithMouse:function(C,G,F){var E=this.getTargetCoord(G,F);if(!this.deltaSetXY){var H=[E.x,E.y];YAHOO.util.Dom.setXY(C,H);var D=parseInt(YAHOO.util.Dom.getStyle(C,"left"),10);var B=parseInt(YAHOO.util.Dom.getStyle(C,"top"),10);this.deltaSetXY=[D-E.x,B-E.y];}else{YAHOO.util.Dom.setStyle(C,"left",(E.x+this.deltaSetXY[0])+"px");YAHOO.util.Dom.setStyle(C,"top",(E.y+this.deltaSetXY[1])+"px");}this.cachePosition(E.x,E.y);var A=this;setTimeout(function(){A.autoScroll.call(A,E.x,E.y,C.offsetHeight,C.offsetWidth);},0);},cachePosition:function(B,A){if(B){this.lastPageX=B;this.lastPageY=A;}else{var C=YAHOO.util.Dom.getXY(this.getEl());this.lastPageX=C[0];this.lastPageY=C[1];}},autoScroll:function(J,I,E,K){if(this.scroll){var L=this.DDM.getClientHeight();var B=this.DDM.getClientWidth();var N=this.DDM.getScrollTop();var D=this.DDM.getScrollLeft();var H=E+I;var M=K+J;var G=(L+N-I-this.deltaY);var F=(B+D-J-this.deltaX);var C=40;var A=(document.all)?80:30;if(H>L&&G<C){window.scrollTo(D,N+A);}if(I<N&&N>0&&I-N<C){window.scrollTo(D,N-A);}if(M>B&&F<C){window.scrollTo(D+A,N);}if(J<D&&D>0&&J-D<C){window.scrollTo(D-A,N);}}},applyConfig:function(){YAHOO.util.DD.superclass.applyConfig.call(this);this.scroll=(this.config.scroll!==false);},b4MouseDown:function(A){this.setStartPosition();this.autoOffset(YAHOO.util.Event.getPageX(A),YAHOO.util.Event.getPageY(A));},b4Drag:function(A){this.setDragElPos(YAHOO.util.Event.getPageX(A),YAHOO.util.Event.getPageY(A));},toString:function(){return("DD "+this.id);}});YAHOO.util.DDProxy=function(C,A,B){if(C){this.init(C,A,B);this.initFrame();}};YAHOO.util.DDProxy.dragElId="ygddfdiv";YAHOO.extend(YAHOO.util.DDProxy,YAHOO.util.DD,{resizeFrame:true,centerFrame:false,createFrame:function(){var B=this,A=document.body;if(!A||!A.firstChild){setTimeout(function(){B.createFrame();},50);return;}var F=this.getDragEl(),E=YAHOO.util.Dom;if(!F){F=document.createElement("div");F.id=this.dragElId;var D=F.style;D.position="absolute";D.visibility="hidden";D.cursor="move";D.border="2px solid #aaa";D.zIndex=999;D.height="25px";D.width="25px";var C=document.createElement("div");E.setStyle(C,"height","100%");E.setStyle(C,"width","100%");E.setStyle(C,"background-color","#ccc");E.setStyle(C,"opacity","0");F.appendChild(C);A.insertBefore(F,A.firstChild);}},initFrame:function(){this.createFrame();},applyConfig:function(){YAHOO.util.DDProxy.superclass.applyConfig.call(this);this.resizeFrame=(this.config.resizeFrame!==false);this.centerFrame=(this.config.centerFrame);this.setDragElId(this.config.dragElId||YAHOO.util.DDProxy.dragElId);},showFrame:function(E,D){var C=this.getEl();var A=this.getDragEl();var B=A.style;this._resizeProxy();if(this.centerFrame){this.setDelta(Math.round(parseInt(B.width,10)/2),Math.round(parseInt(B.height,10)/2));}this.setDragElPos(E,D);YAHOO.util.Dom.setStyle(A,"visibility","visible");},_resizeProxy:function(){if(this.resizeFrame){var H=YAHOO.util.Dom;var B=this.getEl();var C=this.getDragEl();var G=parseInt(H.getStyle(C,"borderTopWidth"),10);var I=parseInt(H.getStyle(C,"borderRightWidth"),10);var F=parseInt(H.getStyle(C,"borderBottomWidth"),10);var D=parseInt(H.getStyle(C,"borderLeftWidth"),10);if(isNaN(G)){G=0;}if(isNaN(I)){I=0;}if(isNaN(F)){F=0;}if(isNaN(D)){D=0;}var E=Math.max(0,B.offsetWidth-I-D);var A=Math.max(0,B.offsetHeight-G-F);H.setStyle(C,"width",E+"px");H.setStyle(C,"height",A+"px");}},b4MouseDown:function(B){this.setStartPosition();var A=YAHOO.util.Event.getPageX(B);var C=YAHOO.util.Event.getPageY(B);this.autoOffset(A,C);},b4StartDrag:function(A,B){this.showFrame(A,B);},b4EndDrag:function(A){YAHOO.util.Dom.setStyle(this.getDragEl(),"visibility","hidden");},endDrag:function(D){var C=YAHOO.util.Dom;var B=this.getEl();var A=this.getDragEl();C.setStyle(A,"visibility","");C.setStyle(B,"visibility","hidden");YAHOO.util.DDM.moveToEl(B,A);C.setStyle(A,"visibility","hidden");C.setStyle(B,"visibility","");},toString:function(){return("DDProxy "+this.id);}});YAHOO.util.DDTarget=function(C,A,B){if(C){this.initTarget(C,A,B);}};YAHOO.extend(YAHOO.util.DDTarget,YAHOO.util.DragDrop,{toString:function(){return("DDTarget "+this.id);}});YAHOO.register("dragdrop",YAHOO.util.DragDropMgr,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/element-delegate/element-delegate-min.js b/js/yui/element-delegate/element-delegate-min.js
new file mode 100644 (file)
index 0000000..b8d0a66
--- /dev/null
+++ b/js/yui/element-delegate/element-delegate-min.js
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){var A=YAHOO.util.Event,B=[],C={mouseenter:true,mouseleave:true};YAHOO.lang.augmentObject(YAHOO.util.Element.prototype,{delegate:function(J,L,F,H,I){if(YAHOO.lang.isString(F)&&!YAHOO.util.Selector){return false;}if(!A._createDelegate){return false;}var E=A._getType(J),G=this.get("element"),M,K,D=function(N){return M.call(G,N);};if(C[J]){if(!A._createMouseDelegate){return false;}K=A._createMouseDelegate(L,H,I);M=A._createDelegate(function(P,O,N){return K.call(O,P,N);},F,H,I);}else{M=A._createDelegate(L,F,H,I);}B.push([G,E,L,D]);return this.on(E,D);},removeDelegate:function(H,G){var I=A._getType(H),E=A._getCacheIndex(B,this.get("element"),I,G),F,D;if(E>=0){D=B[E];}if(D){F=this.removeListener(D[1],D[3]);if(F){delete B[E][2];delete B[E][3];B.splice(E,1);}}return F;}});}());YAHOO.register("element-delegate",YAHOO.util.Element,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/element/element-min.js b/js/yui/element/element-min.js
new file mode 100644 (file)
index 0000000..6a46421
--- /dev/null
+++ b/js/yui/element/element-min.js
@@ -0,0 +1,8 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.util.Attribute=function(b,a){if(a){this.owner=a;this.configure(b,true);}};YAHOO.util.Attribute.INVALID_VALUE={};YAHOO.util.Attribute.prototype={name:undefined,value:null,owner:null,readOnly:false,writeOnce:false,_initialConfig:null,_written:false,method:null,setter:null,getter:null,validator:null,getValue:function(){var a=this.value;if(this.getter){a=this.getter.call(this.owner,this.name,a);}return a;},setValue:function(f,b){var e,a=this.owner,c=this.name,g=YAHOO.util.Attribute.INVALID_VALUE,d={type:c,prevValue:this.getValue(),newValue:f};if(this.readOnly||(this.writeOnce&&this._written)){return false;}if(this.validator&&!this.validator.call(a,f)){return false;}if(!b){e=a.fireBeforeChangeEvent(d);if(e===false){return false;}}if(this.setter){f=this.setter.call(a,f,this.name);if(f===undefined){}if(f===g){return false;}}if(this.method){if(this.method.call(a,f,this.name)===g){return false;}}this.value=f;this._written=true;d.type=c;if(!b){this.owner.fireChangeEvent(d);}return true;},configure:function(b,c){b=b||{};if(c){this._written=false;}this._initialConfig=this._initialConfig||{};for(var a in b){if(b.hasOwnProperty(a)){this[a]=b[a];if(c){this._initialConfig[a]=b[a];}}}},resetValue:function(){return this.setValue(this._initialConfig.value);},resetConfig:function(){this.configure(this._initialConfig,true);},refresh:function(a){this.setValue(this.value,a);}};(function(){var a=YAHOO.util.Lang;YAHOO.util.AttributeProvider=function(){};YAHOO.util.AttributeProvider.prototype={_configs:null,get:function(c){this._configs=this._configs||{};var b=this._configs[c];if(!b||!this._configs.hasOwnProperty(c)){return null;}return b.getValue();},set:function(d,e,b){this._configs=this._configs||{};var c=this._configs[d];if(!c){return false;}return c.setValue(e,b);},getAttributeKeys:function(){this._configs=this._configs;var c=[],b;for(b in this._configs){if(a.hasOwnProperty(this._configs,b)&&!a.isUndefined(this._configs[b])){c[c.length]=b;}}return c;},setAttributes:function(d,b){for(var c in d){if(a.hasOwnProperty(d,c)){this.set(c,d[c],b);}}},resetValue:function(c,b){this._configs=this._configs||{};if(this._configs[c]){this.set(c,this._configs[c]._initialConfig.value,b);return true;}return false;},refresh:function(e,c){this._configs=this._configs||{};var f=this._configs;e=((a.isString(e))?[e]:e)||this.getAttributeKeys();for(var d=0,b=e.length;d<b;++d){if(f.hasOwnProperty(e[d])){this._configs[e[d]].refresh(c);}}},register:function(b,c){this.setAttributeConfig(b,c);},getAttributeConfig:function(c){this._configs=this._configs||{};var b=this._configs[c]||{};var d={};for(c in b){if(a.hasOwnProperty(b,c)){d[c]=b[c];}}return d;},setAttributeConfig:function(b,c,d){this._configs=this._configs||{};c=c||{};if(!this._configs[b]){c.name=b;this._configs[b]=this.createAttribute(c);}else{this._configs[b].configure(c,d);}},configureAttribute:function(b,c,d){this.setAttributeConfig(b,c,d);},resetAttributeConfig:function(b){this._configs=this._configs||{};this._configs[b].resetConfig();},subscribe:function(b,c){this._events=this._events||{};if(!(b in this._events)){this._events[b]=this.createEvent(b);}YAHOO.util.EventProvider.prototype.subscribe.apply(this,arguments);},on:function(){this.subscribe.apply(this,arguments);},addListener:function(){this.subscribe.apply(this,arguments);},fireBeforeChangeEvent:function(c){var b="before";b+=c.type.charAt(0).toUpperCase()+c.type.substr(1)+"Change";c.type=b;return this.fireEvent(c.type,c);},fireChangeEvent:function(b){b.type+="Change";return this.fireEvent(b.type,b);},createAttribute:function(b){return new YAHOO.util.Attribute(b,this);}};YAHOO.augment(YAHOO.util.AttributeProvider,YAHOO.util.EventProvider);})();(function(){var b=YAHOO.util.Dom,d=YAHOO.util.AttributeProvider,c={mouseenter:true,mouseleave:true};var a=function(e,f){this.init.apply(this,arguments);};a.DOM_EVENTS={"click":true,"dblclick":true,"keydown":true,"keypress":true,"keyup":true,"mousedown":true,"mousemove":true,"mouseout":true,"mouseover":true,"mouseup":true,"mouseenter":true,"mouseleave":true,"focus":true,"blur":true,"submit":true,"change":true};a.prototype={DOM_EVENTS:null,DEFAULT_HTML_SETTER:function(g,e){var f=this.get("element");if(f){f[e]=g;}return g;},DEFAULT_HTML_GETTER:function(e){var f=this.get("element"),g;if(f){g=f[e];}return g;},appendChild:function(e){e=e.get?e.get("element"):e;return this.get("element").appendChild(e);},getElementsByTagName:function(e){return this.get("element").getElementsByTagName(e);},hasChildNodes:function(){return this.get("element").hasChildNodes();},insertBefore:function(e,f){e=e.get?e.get("element"):e;f=(f&&f.get)?f.get("element"):f;return this.get("element").insertBefore(e,f);},removeChild:function(e){e=e.get?e.get("element"):e;return this.get("element").removeChild(e);},replaceChild:function(e,f){e=e.get?e.get("element"):e;f=f.get?f.get("element"):f;return this.get("element").replaceChild(e,f);},initAttributes:function(e){},addListener:function(j,i,k,h){h=h||this;var e=YAHOO.util.Event,g=this.get("element")||this.get("id"),f=this;if(c[j]&&!e._createMouseDelegate){return false;}if(!this._events[j]){if(g&&this.DOM_EVENTS[j]){e.on(g,j,function(m,l){if(m.srcElement&&!m.target){m.target=m.srcElement;}if((m.toElement&&!m.relatedTarget)||(m.fromElement&&!m.relatedTarget)){m.relatedTarget=e.getRelatedTarget(m);}if(!m.currentTarget){m.currentTarget=g;}f.fireEvent(j,m,l);},k,h);}this.createEvent(j,{scope:this});}return YAHOO.util.EventProvider.prototype.subscribe.apply(this,arguments);},on:function(){return this.addListener.apply(this,arguments);},subscribe:function(){return this.addListener.apply(this,arguments);},removeListener:function(f,e){return this.unsubscribe.apply(this,arguments);},addClass:function(e){b.addClass(this.get("element"),e);},getElementsByClassName:function(f,e){return b.getElementsByClassName(f,e,this.get("element"));},hasClass:function(e){return b.hasClass(this.get("element"),e);},removeClass:function(e){return b.removeClass(this.get("element"),e);},replaceClass:function(f,e){return b.replaceClass(this.get("element"),f,e);
+},setStyle:function(f,e){return b.setStyle(this.get("element"),f,e);},getStyle:function(e){return b.getStyle(this.get("element"),e);},fireQueue:function(){var f=this._queue;for(var g=0,e=f.length;g<e;++g){this[f[g][0]].apply(this,f[g][1]);}},appendTo:function(f,g){f=(f.get)?f.get("element"):b.get(f);this.fireEvent("beforeAppendTo",{type:"beforeAppendTo",target:f});g=(g&&g.get)?g.get("element"):b.get(g);var e=this.get("element");if(!e){return false;}if(!f){return false;}if(e.parent!=f){if(g){f.insertBefore(e,g);}else{f.appendChild(e);}}this.fireEvent("appendTo",{type:"appendTo",target:f});return e;},get:function(e){var g=this._configs||{},f=g.element;if(f&&!g[e]&&!YAHOO.lang.isUndefined(f.value[e])){this._setHTMLAttrConfig(e);}return d.prototype.get.call(this,e);},setAttributes:function(l,h){var f={},j=this._configOrder;for(var k=0,e=j.length;k<e;++k){if(l[j[k]]!==undefined){f[j[k]]=true;this.set(j[k],l[j[k]],h);}}for(var g in l){if(l.hasOwnProperty(g)&&!f[g]){this.set(g,l[g],h);}}},set:function(f,h,e){var g=this.get("element");if(!g){this._queue[this._queue.length]=["set",arguments];if(this._configs[f]){this._configs[f].value=h;}return;}if(!this._configs[f]&&!YAHOO.lang.isUndefined(g[f])){this._setHTMLAttrConfig(f);}return d.prototype.set.apply(this,arguments);},setAttributeConfig:function(e,f,g){this._configOrder.push(e);d.prototype.setAttributeConfig.apply(this,arguments);},createEvent:function(f,e){this._events[f]=true;return d.prototype.createEvent.apply(this,arguments);},init:function(f,e){this._initElement(f,e);},destroy:function(){var e=this.get("element");YAHOO.util.Event.purgeElement(e,true);this.unsubscribeAll();if(e&&e.parentNode){e.parentNode.removeChild(e);}this._queue=[];this._events={};this._configs={};this._configOrder=[];},_initElement:function(g,f){this._queue=this._queue||[];this._events=this._events||{};this._configs=this._configs||{};this._configOrder=[];f=f||{};f.element=f.element||g||null;var i=false;var e=a.DOM_EVENTS;this.DOM_EVENTS=this.DOM_EVENTS||{};for(var h in e){if(e.hasOwnProperty(h)){this.DOM_EVENTS[h]=e[h];}}if(typeof f.element==="string"){this._setHTMLAttrConfig("id",{value:f.element});}if(b.get(f.element)){i=true;this._initHTMLElement(f);this._initContent(f);}YAHOO.util.Event.onAvailable(f.element,function(){if(!i){this._initHTMLElement(f);}this.fireEvent("available",{type:"available",target:b.get(f.element)});},this,true);YAHOO.util.Event.onContentReady(f.element,function(){if(!i){this._initContent(f);}this.fireEvent("contentReady",{type:"contentReady",target:b.get(f.element)});},this,true);},_initHTMLElement:function(e){this.setAttributeConfig("element",{value:b.get(e.element),readOnly:true});},_initContent:function(e){this.initAttributes(e);this.setAttributes(e,true);this.fireQueue();},_setHTMLAttrConfig:function(e,g){var f=this.get("element");g=g||{};g.name=e;g.setter=g.setter||this.DEFAULT_HTML_SETTER;g.getter=g.getter||this.DEFAULT_HTML_GETTER;g.value=g.value||f[e];this._configs[e]=new YAHOO.util.Attribute(g,this);}};YAHOO.augment(a,d);YAHOO.util.Element=a;})();YAHOO.register("element",YAHOO.util.Element,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/event-delegate/event-delegate-min.js b/js/yui/event-delegate/event-delegate-min.js
new file mode 100644 (file)
index 0000000..5163f7a
--- /dev/null
+++ b/js/yui/event-delegate/event-delegate-min.js
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){var A=YAHOO.util.Event,C=YAHOO.lang,B=[],D=function(H,E,F){var G;if(!H||H===F){G=false;}else{G=YAHOO.util.Selector.test(H,E)?H:D(H.parentNode,E,F);}return G;};C.augmentObject(A,{_createDelegate:function(F,E,G,H){return function(I){var J=this,N=A.getTarget(I),L=E,P=(J.nodeType===9),Q,K,O,M;if(C.isFunction(E)){Q=E(N);}else{if(C.isString(E)){if(!P){O=J.id;if(!O){O=A.generateId(J);}M=("#"+O+" ");L=(M+E).replace(/,/gi,(","+M));}if(YAHOO.util.Selector.test(N,L)){Q=N;}else{if(YAHOO.util.Selector.test(N,((L.replace(/,/gi," *,"))+" *"))){Q=D(N,L,J);}}}}if(Q){K=Q;if(H){if(H===true){K=G;}else{K=H;}}return F.call(K,I,Q,J,G);}};},delegate:function(F,J,L,G,H,I){var E=J,K,M;if(C.isString(G)&&!YAHOO.util.Selector){return false;}if(J=="mouseenter"||J=="mouseleave"){if(!A._createMouseDelegate){return false;}E=A._getType(J);K=A._createMouseDelegate(L,H,I);M=A._createDelegate(function(P,O,N){return K.call(O,P,N);},G,H,I);}else{M=A._createDelegate(L,G,H,I);}B.push([F,E,L,M]);return A.on(F,E,M);},removeDelegate:function(F,J,I){var K=J,H=false,G,E;if(J=="mouseenter"||J=="mouseleave"){K=A._getType(J);}G=A._getCacheIndex(B,F,K,I);if(G>=0){E=B[G];}if(F&&E){H=A.removeListener(E[0],E[1],E[3]);if(H){delete B[G][2];delete B[G][3];B.splice(G,1);}}return H;}});}());YAHOO.register("event-delegate",YAHOO.util.Event,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/event-mouseenter/event-mouseenter-min.js b/js/yui/event-mouseenter/event-mouseenter-min.js
new file mode 100644 (file)
index 0000000..4a4e951
--- /dev/null
+++ b/js/yui/event-mouseenter/event-mouseenter-min.js
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){var b=YAHOO.util.Event,g=YAHOO.lang,e=b.addListener,f=b.removeListener,c=b.getListeners,d=[],h={mouseenter:"mouseover",mouseleave:"mouseout"},a=function(n,m,l){var j=b._getCacheIndex(d,n,m,l),i,k;if(j>=0){i=d[j];}if(n&&i){k=f.call(b,i[0],m,i[3]);if(k){delete d[j][2];delete d[j][3];d.splice(j,1);}}return k;};g.augmentObject(b._specialTypes,h);g.augmentObject(b,{_createMouseDelegate:function(i,j,k){return function(q,m){var p=this,l=b.getRelatedTarget(q),o,n;if(p!=l&&!YAHOO.util.Dom.isAncestor(p,l)){o=p;if(k){if(k===true){o=j;}else{o=k;}}n=[q,j];if(m){n.splice(1,0,p,m);}return i.apply(o,n);}};},addListener:function(m,l,k,n,o){var i,j;if(h[l]){i=b._createMouseDelegate(k,n,o);i.mouseDelegate=true;d.push([m,l,k,i]);j=e.call(b,m,l,i);}else{j=e.apply(b,arguments);}return j;},removeListener:function(l,k,j){var i;if(h[k]){i=a.apply(b,arguments);}else{i=f.apply(b,arguments);}return i;},getListeners:function(p,o){var n=[],r,m=(o==="mouseover"||o==="mouseout"),q,k,j;if(o&&(m||h[o])){r=c.call(b,p,this._getType(o));if(r){for(k=r.length-1;k>-1;k--){j=r[k];q=j.fn.mouseDelegate;if((h[o]&&q)||(m&&!q)){n.push(j);}}}}else{n=c.apply(b,arguments);}return(n&&n.length)?n:null;}},true);b.on=b.addListener;}());YAHOO.register("event-mouseenter",YAHOO.util.Event,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/event-simulate/event-simulate-min.js b/js/yui/event-simulate/event-simulate-min.js
new file mode 100644 (file)
index 0000000..63b9710
--- /dev/null
+++ b/js/yui/event-simulate/event-simulate-min.js
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.util.UserAction={simulateKeyEvent:function(f,j,e,c,l,b,a,k,h,n,m){f=YAHOO.util.Dom.get(f);if(!f){throw new Error("simulateKeyEvent(): Invalid target.");}if(YAHOO.lang.isString(j)){j=j.toLowerCase();switch(j){case"keyup":case"keydown":case"keypress":break;case"textevent":j="keypress";break;default:throw new Error("simulateKeyEvent(): Event type '"+j+"' not supported.");}}else{throw new Error("simulateKeyEvent(): Event type must be a string.");}if(!YAHOO.lang.isBoolean(e)){e=true;}if(!YAHOO.lang.isBoolean(c)){c=true;}if(!YAHOO.lang.isObject(l)){l=window;}if(!YAHOO.lang.isBoolean(b)){b=false;}if(!YAHOO.lang.isBoolean(a)){a=false;}if(!YAHOO.lang.isBoolean(k)){k=false;}if(!YAHOO.lang.isBoolean(h)){h=false;}if(!YAHOO.lang.isNumber(n)){n=0;}if(!YAHOO.lang.isNumber(m)){m=0;}var i=null;if(YAHOO.lang.isFunction(document.createEvent)){try{i=document.createEvent("KeyEvents");i.initKeyEvent(j,e,c,l,b,a,k,h,n,m);}catch(g){try{i=document.createEvent("Events");}catch(d){i=document.createEvent("UIEvents");}finally{i.initEvent(j,e,c);i.view=l;i.altKey=a;i.ctrlKey=b;i.shiftKey=k;i.metaKey=h;i.keyCode=n;i.charCode=m;}}f.dispatchEvent(i);}else{if(YAHOO.lang.isObject(document.createEventObject)){i=document.createEventObject();i.bubbles=e;i.cancelable=c;i.view=l;i.ctrlKey=b;i.altKey=a;i.shiftKey=k;i.metaKey=h;i.keyCode=(m>0)?m:n;f.fireEvent("on"+j,i);}else{throw new Error("simulateKeyEvent(): No event simulation framework present.");}}},simulateMouseEvent:function(k,p,h,e,q,j,g,f,d,b,c,a,o,m,i,l){k=YAHOO.util.Dom.get(k);if(!k){throw new Error("simulateMouseEvent(): Invalid target.");}l=l||null;if(YAHOO.lang.isString(p)){p=p.toLowerCase();switch(p){case"mouseover":case"mouseout":case"mousedown":case"mouseup":case"click":case"dblclick":case"mousemove":break;default:throw new Error("simulateMouseEvent(): Event type '"+p+"' not supported.");}}else{throw new Error("simulateMouseEvent(): Event type must be a string.");}if(!YAHOO.lang.isBoolean(h)){h=true;}if(!YAHOO.lang.isBoolean(e)){e=(p!="mousemove");}if(!YAHOO.lang.isObject(q)){q=window;}if(!YAHOO.lang.isNumber(j)){j=1;}if(!YAHOO.lang.isNumber(g)){g=0;}if(!YAHOO.lang.isNumber(f)){f=0;}if(!YAHOO.lang.isNumber(d)){d=0;}if(!YAHOO.lang.isNumber(b)){b=0;}if(!YAHOO.lang.isBoolean(c)){c=false;}if(!YAHOO.lang.isBoolean(a)){a=false;}if(!YAHOO.lang.isBoolean(o)){o=false;}if(!YAHOO.lang.isBoolean(m)){m=false;}if(!YAHOO.lang.isNumber(i)){i=0;}var n=null;if(YAHOO.lang.isFunction(document.createEvent)){n=document.createEvent("MouseEvents");if(n.initMouseEvent){n.initMouseEvent(p,h,e,q,j,g,f,d,b,c,a,o,m,i,l);}else{n=document.createEvent("UIEvents");n.initEvent(p,h,e);n.view=q;n.detail=j;n.screenX=g;n.screenY=f;n.clientX=d;n.clientY=b;n.ctrlKey=c;n.altKey=a;n.metaKey=m;n.shiftKey=o;n.button=i;n.relatedTarget=l;}if(l&&!n.relatedTarget){if(p=="mouseout"){n.toElement=l;}else{if(p=="mouseover"){n.fromElement=l;}}}k.dispatchEvent(n);}else{if(YAHOO.lang.isObject(document.createEventObject)){n=document.createEventObject();n.bubbles=h;n.cancelable=e;n.view=q;n.detail=j;n.screenX=g;n.screenY=f;n.clientX=d;n.clientY=b;n.ctrlKey=c;n.altKey=a;n.metaKey=m;n.shiftKey=o;switch(i){case 0:n.button=1;break;case 1:n.button=4;break;case 2:break;default:n.button=0;}n.relatedTarget=l;k.fireEvent("on"+p,n);}else{throw new Error("simulateMouseEvent(): No event simulation framework present.");}}},fireMouseEvent:function(c,b,a){a=a||{};this.simulateMouseEvent(c,b,a.bubbles,a.cancelable,a.view,a.detail,a.screenX,a.screenY,a.clientX,a.clientY,a.ctrlKey,a.altKey,a.shiftKey,a.metaKey,a.button,a.relatedTarget);},click:function(b,a){this.fireMouseEvent(b,"click",a);},dblclick:function(b,a){this.fireMouseEvent(b,"dblclick",a);},mousedown:function(b,a){this.fireMouseEvent(b,"mousedown",a);},mousemove:function(b,a){this.fireMouseEvent(b,"mousemove",a);},mouseout:function(b,a){this.fireMouseEvent(b,"mouseout",a);},mouseover:function(b,a){this.fireMouseEvent(b,"mouseover",a);},mouseup:function(b,a){this.fireMouseEvent(b,"mouseup",a);},fireKeyEvent:function(b,c,a){a=a||{};this.simulateKeyEvent(c,b,a.bubbles,a.cancelable,a.view,a.ctrlKey,a.altKey,a.shiftKey,a.metaKey,a.keyCode,a.charCode);},keydown:function(b,a){this.fireKeyEvent("keydown",b,a);},keypress:function(b,a){this.fireKeyEvent("keypress",b,a);},keyup:function(b,a){this.fireKeyEvent("keyup",b,a);}};YAHOO.register("event-simulate",YAHOO.util.UserAction,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/event/event-min.js b/js/yui/event/event-min.js
new file mode 100644 (file)
index 0000000..f4a0f25
--- /dev/null
+++ b/js/yui/event/event-min.js
@@ -0,0 +1,11 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.util.CustomEvent=function(d,c,b,a,e){this.type=d;this.scope=c||window;this.silent=b;this.fireOnce=e;this.fired=false;this.firedWith=null;this.signature=a||YAHOO.util.CustomEvent.LIST;this.subscribers=[];if(!this.silent){}var f="_YUICEOnSubscribe";if(d!==f){this.subscribeEvent=new YAHOO.util.CustomEvent(f,this,true);}this.lastError=null;};YAHOO.util.CustomEvent.LIST=0;YAHOO.util.CustomEvent.FLAT=1;YAHOO.util.CustomEvent.prototype={subscribe:function(b,c,d){if(!b){throw new Error("Invalid callback for subscriber to '"+this.type+"'");}if(this.subscribeEvent){this.subscribeEvent.fire(b,c,d);}var a=new YAHOO.util.Subscriber(b,c,d);if(this.fireOnce&&this.fired){this.notify(a,this.firedWith);}else{this.subscribers.push(a);}},unsubscribe:function(d,f){if(!d){return this.unsubscribeAll();}var e=false;for(var b=0,a=this.subscribers.length;b<a;++b){var c=this.subscribers[b];if(c&&c.contains(d,f)){this._delete(b);e=true;}}return e;},fire:function(){this.lastError=null;var h=[],a=this.subscribers.length;var d=[].slice.call(arguments,0),c=true,f,b=false;if(this.fireOnce){if(this.fired){return true;}else{this.firedWith=d;}}this.fired=true;if(!a&&this.silent){return true;}if(!this.silent){}var e=this.subscribers.slice();for(f=0;f<a;++f){var g=e[f];if(!g||!g.fn){b=true;}else{c=this.notify(g,d);if(false===c){if(!this.silent){}break;}}}return(c!==false);},notify:function(g,c){var b,i=null,f=g.getScope(this.scope),a=YAHOO.util.Event.throwErrors;if(!this.silent){}if(this.signature==YAHOO.util.CustomEvent.FLAT){if(c.length>0){i=c[0];}try{b=g.fn.call(f,i,g.obj);}catch(h){this.lastError=h;if(a){throw h;}}}else{try{b=g.fn.call(f,this.type,c,g.obj);}catch(d){this.lastError=d;if(a){throw d;}}}return b;},unsubscribeAll:function(){var a=this.subscribers.length,b;for(b=a-1;b>-1;b--){this._delete(b);}this.subscribers=[];return a;},_delete:function(a){var b=this.subscribers[a];if(b){delete b.fn;delete b.obj;}this.subscribers.splice(a,1);},toString:function(){return"CustomEvent: "+"'"+this.type+"', "+"context: "+this.scope;}};YAHOO.util.Subscriber=function(a,b,c){this.fn=a;this.obj=YAHOO.lang.isUndefined(b)?null:b;this.overrideContext=c;};YAHOO.util.Subscriber.prototype.getScope=function(a){if(this.overrideContext){if(this.overrideContext===true){return this.obj;}else{return this.overrideContext;}}return a;};YAHOO.util.Subscriber.prototype.contains=function(a,b){if(b){return(this.fn==a&&this.obj==b);}else{return(this.fn==a);}};YAHOO.util.Subscriber.prototype.toString=function(){return"Subscriber { obj: "+this.obj+", overrideContext: "+(this.overrideContext||"no")+" }";};if(!YAHOO.util.Event){YAHOO.util.Event=function(){var g=false,h=[],j=[],a=0,e=[],b=0,c={63232:38,63233:40,63234:37,63235:39,63276:33,63277:34,25:9},d=YAHOO.env.ua.ie,f="focusin",i="focusout";return{POLL_RETRYS:500,POLL_INTERVAL:40,EL:0,TYPE:1,FN:2,WFN:3,UNLOAD_OBJ:3,ADJ_SCOPE:4,OBJ:5,OVERRIDE:6,CAPTURE:7,lastError:null,isSafari:YAHOO.env.ua.webkit,webkit:YAHOO.env.ua.webkit,isIE:d,_interval:null,_dri:null,_specialTypes:{focusin:(d?"focusin":"focus"),focusout:(d?"focusout":"blur")},DOMReady:false,throwErrors:false,startInterval:function(){if(!this._interval){this._interval=YAHOO.lang.later(this.POLL_INTERVAL,this,this._tryPreloadAttach,null,true);}},onAvailable:function(q,m,o,p,n){var k=(YAHOO.lang.isString(q))?[q]:q;for(var l=0;l<k.length;l=l+1){e.push({id:k[l],fn:m,obj:o,overrideContext:p,checkReady:n});}a=this.POLL_RETRYS;this.startInterval();},onContentReady:function(n,k,l,m){this.onAvailable(n,k,l,m,true);},onDOMReady:function(){this.DOMReadyEvent.subscribe.apply(this.DOMReadyEvent,arguments);},_addListener:function(m,k,v,p,t,y){if(!v||!v.call){return false;}if(this._isValidCollection(m)){var w=true;for(var q=0,s=m.length;q<s;++q){w=this.on(m[q],k,v,p,t)&&w;}return w;}else{if(YAHOO.lang.isString(m)){var o=this.getEl(m);if(o){m=o;}else{this.onAvailable(m,function(){YAHOO.util.Event._addListener(m,k,v,p,t,y);});return true;}}}if(!m){return false;}if("unload"==k&&p!==this){j[j.length]=[m,k,v,p,t];return true;}var l=m;if(t){if(t===true){l=p;}else{l=t;}}var n=function(z){return v.call(l,YAHOO.util.Event.getEvent(z,m),p);};var x=[m,k,v,n,l,p,t,y];var r=h.length;h[r]=x;try{this._simpleAdd(m,k,n,y);}catch(u){this.lastError=u;this.removeListener(m,k,v);return false;}return true;},_getType:function(k){return this._specialTypes[k]||k;},addListener:function(m,p,l,n,o){var k=((p==f||p==i)&&!YAHOO.env.ua.ie)?true:false;return this._addListener(m,this._getType(p),l,n,o,k);},addFocusListener:function(l,k,m,n){return this.on(l,f,k,m,n);},removeFocusListener:function(l,k){return this.removeListener(l,f,k);},addBlurListener:function(l,k,m,n){return this.on(l,i,k,m,n);},removeBlurListener:function(l,k){return this.removeListener(l,i,k);},removeListener:function(l,k,r){var m,p,u;k=this._getType(k);if(typeof l=="string"){l=this.getEl(l);}else{if(this._isValidCollection(l)){var s=true;for(m=l.length-1;m>-1;m--){s=(this.removeListener(l[m],k,r)&&s);}return s;}}if(!r||!r.call){return this.purgeElement(l,false,k);}if("unload"==k){for(m=j.length-1;m>-1;m--){u=j[m];if(u&&u[0]==l&&u[1]==k&&u[2]==r){j.splice(m,1);return true;}}return false;}var n=null;var o=arguments[3];if("undefined"===typeof o){o=this._getCacheIndex(h,l,k,r);}if(o>=0){n=h[o];}if(!l||!n){return false;}var t=n[this.CAPTURE]===true?true:false;try{this._simpleRemove(l,k,n[this.WFN],t);}catch(q){this.lastError=q;return false;}delete h[o][this.WFN];delete h[o][this.FN];h.splice(o,1);return true;},getTarget:function(m,l){var k=m.target||m.srcElement;return this.resolveTextNode(k);},resolveTextNode:function(l){try{if(l&&3==l.nodeType){return l.parentNode;}}catch(k){return null;}return l;},getPageX:function(l){var k=l.pageX;if(!k&&0!==k){k=l.clientX||0;if(this.isIE){k+=this._getScrollLeft();}}return k;},getPageY:function(k){var l=k.pageY;if(!l&&0!==l){l=k.clientY||0;if(this.isIE){l+=this._getScrollTop();}}return l;},getXY:function(k){return[this.getPageX(k),this.getPageY(k)];},getRelatedTarget:function(l){var k=l.relatedTarget;
+if(!k){if(l.type=="mouseout"){k=l.toElement;}else{if(l.type=="mouseover"){k=l.fromElement;}}}return this.resolveTextNode(k);},getTime:function(m){if(!m.time){var l=new Date().getTime();try{m.time=l;}catch(k){this.lastError=k;return l;}}return m.time;},stopEvent:function(k){this.stopPropagation(k);this.preventDefault(k);},stopPropagation:function(k){if(k.stopPropagation){k.stopPropagation();}else{k.cancelBubble=true;}},preventDefault:function(k){if(k.preventDefault){k.preventDefault();}else{k.returnValue=false;}},getEvent:function(m,k){var l=m||window.event;if(!l){var n=this.getEvent.caller;while(n){l=n.arguments[0];if(l&&Event==l.constructor){break;}n=n.caller;}}return l;},getCharCode:function(l){var k=l.keyCode||l.charCode||0;if(YAHOO.env.ua.webkit&&(k in c)){k=c[k];}return k;},_getCacheIndex:function(n,q,r,p){for(var o=0,m=n.length;o<m;o=o+1){var k=n[o];if(k&&k[this.FN]==p&&k[this.EL]==q&&k[this.TYPE]==r){return o;}}return -1;},generateId:function(k){var l=k.id;if(!l){l="yuievtautoid-"+b;++b;k.id=l;}return l;},_isValidCollection:function(l){try{return(l&&typeof l!=="string"&&l.length&&!l.tagName&&!l.alert&&typeof l[0]!=="undefined");}catch(k){return false;}},elCache:{},getEl:function(k){return(typeof k==="string")?document.getElementById(k):k;},clearCache:function(){},DOMReadyEvent:new YAHOO.util.CustomEvent("DOMReady",YAHOO,0,0,1),_load:function(l){if(!g){g=true;var k=YAHOO.util.Event;k._ready();k._tryPreloadAttach();}},_ready:function(l){var k=YAHOO.util.Event;if(!k.DOMReady){k.DOMReady=true;k.DOMReadyEvent.fire();k._simpleRemove(document,"DOMContentLoaded",k._ready);}},_tryPreloadAttach:function(){if(e.length===0){a=0;if(this._interval){this._interval.cancel();this._interval=null;}return;}if(this.locked){return;}if(this.isIE){if(!this.DOMReady){this.startInterval();return;}}this.locked=true;var q=!g;if(!q){q=(a>0&&e.length>0);}var p=[];var r=function(t,u){var s=t;if(u.overrideContext){if(u.overrideContext===true){s=u.obj;}else{s=u.overrideContext;}}u.fn.call(s,u.obj);};var l,k,o,n,m=[];for(l=0,k=e.length;l<k;l=l+1){o=e[l];if(o){n=this.getEl(o.id);if(n){if(o.checkReady){if(g||n.nextSibling||!q){m.push(o);e[l]=null;}}else{r(n,o);e[l]=null;}}else{p.push(o);}}}for(l=0,k=m.length;l<k;l=l+1){o=m[l];r(this.getEl(o.id),o);}a--;if(q){for(l=e.length-1;l>-1;l--){o=e[l];if(!o||!o.id){e.splice(l,1);}}this.startInterval();}else{if(this._interval){this._interval.cancel();this._interval=null;}}this.locked=false;},purgeElement:function(p,q,s){var n=(YAHOO.lang.isString(p))?this.getEl(p):p;var r=this.getListeners(n,s),o,k;if(r){for(o=r.length-1;o>-1;o--){var m=r[o];this.removeListener(n,m.type,m.fn);}}if(q&&n&&n.childNodes){for(o=0,k=n.childNodes.length;o<k;++o){this.purgeElement(n.childNodes[o],q,s);}}},getListeners:function(n,k){var q=[],m;if(!k){m=[h,j];}else{if(k==="unload"){m=[j];}else{k=this._getType(k);m=[h];}}var s=(YAHOO.lang.isString(n))?this.getEl(n):n;for(var p=0;p<m.length;p=p+1){var u=m[p];if(u){for(var r=0,t=u.length;r<t;++r){var o=u[r];if(o&&o[this.EL]===s&&(!k||k===o[this.TYPE])){q.push({type:o[this.TYPE],fn:o[this.FN],obj:o[this.OBJ],adjust:o[this.OVERRIDE],scope:o[this.ADJ_SCOPE],index:r});}}}}return(q.length)?q:null;},_unload:function(s){var m=YAHOO.util.Event,p,o,n,r,q,t=j.slice(),k;for(p=0,r=j.length;p<r;++p){n=t[p];if(n){try{k=window;if(n[m.ADJ_SCOPE]){if(n[m.ADJ_SCOPE]===true){k=n[m.UNLOAD_OBJ];}else{k=n[m.ADJ_SCOPE];}}n[m.FN].call(k,m.getEvent(s,n[m.EL]),n[m.UNLOAD_OBJ]);}catch(w){}t[p]=null;}}n=null;k=null;j=null;if(h){for(o=h.length-1;o>-1;o--){n=h[o];if(n){try{m.removeListener(n[m.EL],n[m.TYPE],n[m.FN],o);}catch(v){}}}n=null;}try{m._simpleRemove(window,"unload",m._unload);m._simpleRemove(window,"load",m._load);}catch(u){}},_getScrollLeft:function(){return this._getScroll()[1];},_getScrollTop:function(){return this._getScroll()[0];},_getScroll:function(){var k=document.documentElement,l=document.body;if(k&&(k.scrollTop||k.scrollLeft)){return[k.scrollTop,k.scrollLeft];}else{if(l){return[l.scrollTop,l.scrollLeft];}else{return[0,0];}}},regCE:function(){},_simpleAdd:function(){if(window.addEventListener){return function(m,n,l,k){m.addEventListener(n,l,(k));};}else{if(window.attachEvent){return function(m,n,l,k){m.attachEvent("on"+n,l);};}else{return function(){};}}}(),_simpleRemove:function(){if(window.removeEventListener){return function(m,n,l,k){m.removeEventListener(n,l,(k));};}else{if(window.detachEvent){return function(l,m,k){l.detachEvent("on"+m,k);};}else{return function(){};}}}()};}();(function(){var a=YAHOO.util.Event;a.on=a.addListener;a.onFocus=a.addFocusListener;a.onBlur=a.addBlurListener;
+/*! DOMReady: based on work by: Dean Edwards/John Resig/Matthias Miller/Diego Perini */
+if(a.isIE){if(self!==self.top){document.onreadystatechange=function(){if(document.readyState=="complete"){document.onreadystatechange=null;a._ready();}};}else{YAHOO.util.Event.onDOMReady(YAHOO.util.Event._tryPreloadAttach,YAHOO.util.Event,true);var b=document.createElement("p");a._dri=setInterval(function(){try{b.doScroll("left");clearInterval(a._dri);a._dri=null;a._ready();b=null;}catch(c){}},a.POLL_INTERVAL);}}else{if(a.webkit&&a.webkit<525){a._dri=setInterval(function(){var c=document.readyState;if("loaded"==c||"complete"==c){clearInterval(a._dri);a._dri=null;a._ready();}},a.POLL_INTERVAL);}else{a._simpleAdd(document,"DOMContentLoaded",a._ready);}}a._simpleAdd(window,"load",a._load);a._simpleAdd(window,"unload",a._unload);a._tryPreloadAttach();})();}YAHOO.util.EventProvider=function(){};YAHOO.util.EventProvider.prototype={__yui_events:null,__yui_subscribers:null,subscribe:function(a,c,f,e){this.__yui_events=this.__yui_events||{};var d=this.__yui_events[a];if(d){d.subscribe(c,f,e);}else{this.__yui_subscribers=this.__yui_subscribers||{};var b=this.__yui_subscribers;if(!b[a]){b[a]=[];}b[a].push({fn:c,obj:f,overrideContext:e});}},unsubscribe:function(c,e,g){this.__yui_events=this.__yui_events||{};var a=this.__yui_events;if(c){var f=a[c];if(f){return f.unsubscribe(e,g);}}else{var b=true;for(var d in a){if(YAHOO.lang.hasOwnProperty(a,d)){b=b&&a[d].unsubscribe(e,g);
+}}return b;}return false;},unsubscribeAll:function(a){return this.unsubscribe(a);},createEvent:function(b,g){this.__yui_events=this.__yui_events||{};var e=g||{},d=this.__yui_events,f;if(d[b]){}else{f=new YAHOO.util.CustomEvent(b,e.scope||this,e.silent,YAHOO.util.CustomEvent.FLAT,e.fireOnce);d[b]=f;if(e.onSubscribeCallback){f.subscribeEvent.subscribe(e.onSubscribeCallback);}this.__yui_subscribers=this.__yui_subscribers||{};var a=this.__yui_subscribers[b];if(a){for(var c=0;c<a.length;++c){f.subscribe(a[c].fn,a[c].obj,a[c].overrideContext);}}}return d[b];},fireEvent:function(b){this.__yui_events=this.__yui_events||{};var d=this.__yui_events[b];if(!d){return null;}var a=[];for(var c=1;c<arguments.length;++c){a.push(arguments[c]);}return d.fire.apply(d,a);},hasEvent:function(a){if(this.__yui_events){if(this.__yui_events[a]){return true;}}return false;}};(function(){var a=YAHOO.util.Event,c=YAHOO.lang;YAHOO.util.KeyListener=function(d,i,e,f){if(!d){}else{if(!i){}else{if(!e){}}}if(!f){f=YAHOO.util.KeyListener.KEYDOWN;}var g=new YAHOO.util.CustomEvent("keyPressed");this.enabledEvent=new YAHOO.util.CustomEvent("enabled");this.disabledEvent=new YAHOO.util.CustomEvent("disabled");if(c.isString(d)){d=document.getElementById(d);}if(c.isFunction(e)){g.subscribe(e);}else{g.subscribe(e.fn,e.scope,e.correctScope);}function h(o,n){if(!i.shift){i.shift=false;}if(!i.alt){i.alt=false;}if(!i.ctrl){i.ctrl=false;}if(o.shiftKey==i.shift&&o.altKey==i.alt&&o.ctrlKey==i.ctrl){var j,m=i.keys,l;if(YAHOO.lang.isArray(m)){for(var k=0;k<m.length;k++){j=m[k];l=a.getCharCode(o);if(j==l){g.fire(l,o);break;}}}else{l=a.getCharCode(o);if(m==l){g.fire(l,o);}}}}this.enable=function(){if(!this.enabled){a.on(d,f,h);this.enabledEvent.fire(i);}this.enabled=true;};this.disable=function(){if(this.enabled){a.removeListener(d,f,h);this.disabledEvent.fire(i);}this.enabled=false;};this.toString=function(){return"KeyListener ["+i.keys+"] "+d.tagName+(d.id?"["+d.id+"]":"");};};var b=YAHOO.util.KeyListener;b.KEYDOWN="keydown";b.KEYUP="keyup";b.KEY={ALT:18,BACK_SPACE:8,CAPS_LOCK:20,CONTROL:17,DELETE:46,DOWN:40,END:35,ENTER:13,ESCAPE:27,HOME:36,LEFT:37,META:224,NUM_LOCK:144,PAGE_DOWN:34,PAGE_UP:33,PAUSE:19,PRINTSCREEN:44,RIGHT:39,SCROLL_LOCK:145,SHIFT:16,SPACE:32,TAB:9,UP:38};})();YAHOO.register("event",YAHOO.util.Event,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/fonts/fonts-min.css b/js/yui/fonts/fonts-min.css
new file mode 100644 (file)
index 0000000..0eb29e0
--- /dev/null
+++ b/js/yui/fonts/fonts-min.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+body{font:13px/1.231 arial,helvetica,clean,sans-serif;*font-size:small;*font:x-small}select,input,textarea,button{font:99% arial,helvetica,clean,sans-serif}table{font-size:inherit;font:100%}pre,code,kbd,samp,tt{font-family:monospace;*font-size:108%;line-height:100%}
\ No newline at end of file

diff --git a/js/yui/fonts/fonts.css b/js/yui/fonts/fonts.css
new file mode 100644 (file)
index 0000000..b170cd7
--- /dev/null
+++ b/js/yui/fonts/fonts.css
@@ -0,0 +1,55 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+/**
+ * YUI Fonts
+ * @module fonts
+ * @namespace yui-
+ * @requires 
+ */
+
+/**
+ * Percents could work for IE, but for backCompat purposes, we are using keywords.
+ * x-small is for IE6/7 quirks mode.
+ */
+body {
+       font:13px/1.231 arial,helvetica,clean,sans-serif;
+       /* for IE6/7 */ 
+       *font-size:small; 
+       /* for IE Quirks Mode */
+       *font:x-small; 
+}
+
+/**
+ * Nudge down to get to 13px equivalent for these form elements
+ */ 
+select,
+input,
+textarea,
+button {
+       font:99% arial,helvetica,clean,sans-serif;
+}
+
+/**
+ * To help tables remember to inherit
+ */
+table {
+       font-size:inherit;
+       font:100%;
+}
+
+/**
+ * Bump up IE to get to 13px equivalent for these fixed-width elements
+ */
+pre,
+code,
+kbd,
+samp,
+tt {
+       font-family:monospace;
+       *font-size:108%;
+       line-height:100%;
+}

diff --git a/js/yui/get/get-min.js b/js/yui/get/get-min.js
new file mode 100644 (file)
index 0000000..1fdcc49
--- /dev/null
+++ b/js/yui/get/get-min.js
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.util.Get=function(){var m={},k=0,r=0,l=false,n=YAHOO.env.ua,s=YAHOO.lang,q,d,e,i=function(x,t,y){var u=y||window,z=u.document,A=z.createElement(x),v;for(v in t){if(t.hasOwnProperty(v)){A.setAttribute(v,t[v]);}}return A;},h=function(u,v,t){var w={id:"yui__dyn_"+(r++),type:"text/css",rel:"stylesheet",href:u};if(t){s.augmentObject(w,t);}return i("link",w,v);},p=function(u,v,t){var w={id:"yui__dyn_"+(r++),type:"text/javascript",src:u};if(t){s.augmentObject(w,t);}return i("script",w,v);},a=function(t,u){return{tId:t.tId,win:t.win,data:t.data,nodes:t.nodes,msg:u,purge:function(){d(this.tId);}};},b=function(t,w){var u=m[w],v=(s.isString(t))?u.win.document.getElementById(t):t;if(!v){q(w,"target node not found: "+t);}return v;},c=function(w){var u=m[w],v,t;u.finished=true;if(u.aborted){v="transaction "+w+" was aborted";q(w,v);return;}if(u.onSuccess){t=u.scope||u.win;u.onSuccess.call(t,a(u));}},o=function(v){var u=m[v],t;if(u.onTimeout){t=u.scope||u;u.onTimeout.call(t,a(u));}},f=function(v,A){var u=m[v],D=u.win,C=D.document,B=C.getElementsByTagName("head")[0],x,y,t,E,z;if(u.timer){u.timer.cancel();}if(u.aborted){y="transaction "+v+" was aborted";q(v,y);return;}if(A){u.url.shift();if(u.varName){u.varName.shift();}}else{u.url=(s.isString(u.url))?[u.url]:u.url;if(u.varName){u.varName=(s.isString(u.varName))?[u.varName]:u.varName;}}if(u.url.length===0){if(u.type==="script"&&n.webkit&&n.webkit<420&&!u.finalpass&&!u.varName){z=p(null,u.win,u.attributes);z.innerHTML='YAHOO.util.Get._finalize("'+v+'");';u.nodes.push(z);B.appendChild(z);}else{c(v);}return;}t=u.url[0];if(!t){u.url.shift();return f(v);}if(u.timeout){u.timer=s.later(u.timeout,u,o,v);}if(u.type==="script"){x=p(t,D,u.attributes);}else{x=h(t,D,u.attributes);}e(u.type,x,v,t,D,u.url.length);u.nodes.push(x);if(u.insertBefore){E=b(u.insertBefore,v);if(E){E.parentNode.insertBefore(x,E);}}else{B.appendChild(x);}if((n.webkit||n.gecko)&&u.type==="css"){f(v,t);}},j=function(){if(l){return;}l=true;var t,u;for(t in m){if(m.hasOwnProperty(t)){u=m[t];if(u.autopurge&&u.finished){d(u.tId);delete m[t];}}}l=false;},g=function(u,t,v){var x="q"+(k++),w;v=v||{};if(k%YAHOO.util.Get.PURGE_THRESH===0){j();}m[x]=s.merge(v,{tId:x,type:u,url:t,finished:false,aborted:false,nodes:[]});w=m[x];w.win=w.win||window;w.scope=w.scope||w.win;w.autopurge=("autopurge" in w)?w.autopurge:(u==="script")?true:false;w.attributes=w.attributes||{};w.attributes.charset=v.charset||w.attributes.charset||"utf-8";s.later(0,w,f,x);return{tId:x};};e=function(H,z,x,u,D,E,G){var F=G||f,B,t,I,v,J,A,C,y;if(n.ie){z.onreadystatechange=function(){B=this.readyState;if("loaded"===B||"complete"===B){z.onreadystatechange=null;F(x,u);}};}else{if(n.webkit){if(H==="script"){if(n.webkit>=420){z.addEventListener("load",function(){F(x,u);});}else{t=m[x];if(t.varName){v=YAHOO.util.Get.POLL_FREQ;t.maxattempts=YAHOO.util.Get.TIMEOUT/v;t.attempts=0;t._cache=t.varName[0].split(".");t.timer=s.later(v,t,function(w){I=this._cache;A=I.length;J=this.win;for(C=0;C<A;C=C+1){J=J[I[C]];if(!J){this.attempts++;if(this.attempts++>this.maxattempts){y="Over retry limit, giving up";t.timer.cancel();q(x,y);}else{}return;}}t.timer.cancel();F(x,u);},null,true);}else{s.later(YAHOO.util.Get.POLL_FREQ,null,F,[x,u]);}}}}else{z.onload=function(){F(x,u);};}}};q=function(w,v){var u=m[w],t;if(u.onFailure){t=u.scope||u.win;u.onFailure.call(t,a(u,v));}};d=function(z){if(m[z]){var t=m[z],u=t.nodes,x=u.length,C=t.win.document,A=C.getElementsByTagName("head")[0],v,y,w,B;if(t.insertBefore){v=b(t.insertBefore,z);if(v){A=v.parentNode;}}for(y=0;y<x;y=y+1){w=u[y];if(w.clearAttributes){w.clearAttributes();}else{for(B in w){if(w.hasOwnProperty(B)){delete w[B];}}}A.removeChild(w);}t.nodes=[];}};return{POLL_FREQ:10,PURGE_THRESH:20,TIMEOUT:2000,_finalize:function(t){s.later(0,null,c,t);},abort:function(u){var v=(s.isString(u))?u:u.tId,t=m[v];if(t){t.aborted=true;}},script:function(t,u){return g("script",t,u);},css:function(t,u){return g("css",t,u);}};}();YAHOO.register("get",YAHOO.util.Get,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/grids/grids-min.css b/js/yui/grids/grids-min.css
new file mode 100644 (file)
index 0000000..3a172de
--- /dev/null
+++ b/js/yui/grids/grids-min.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+body{text-align:center}#doc,#doc2,#doc3,#doc4,.yui-t1,.yui-t2,.yui-t3,.yui-t4,.yui-t5,.yui-t6,.yui-t7{margin:auto;text-align:left;width:57.69em;*width:56.25em}#doc2{width:73.076em;*width:71.25em}#doc3{margin:auto 10px;width:auto}#doc4{width:74.923em;*width:73.05em}.yui-b{position:relative}.yui-b{_position:static}#yui-main .yui-b{position:static}#yui-main,.yui-g .yui-u .yui-g{width:100%}.yui-t1 #yui-main,.yui-t2 #yui-main,.yui-t3 #yui-main{float:right;margin-left:-25em}.yui-t4 #yui-main,.yui-t5 #yui-main,.yui-t6 #yui-main{float:left;margin-right:-25em}.yui-t1 .yui-b{float:left;width:12.30769em;*width:12.00em}.yui-t1 #yui-main .yui-b{margin-left:13.30769em;*margin-left:13.05em}.yui-t2 .yui-b{float:left;width:13.8461em;*width:13.50em}.yui-t2 #yui-main .yui-b{margin-left:14.8461em;*margin-left:14.55em}.yui-t3 .yui-b{float:left;width:23.0769em;*width:22.50em}.yui-t3 #yui-main .yui-b{margin-left:24.0769em;*margin-left:23.62em}.yui-t4 .yui-b{float:right;width:13.8456em;*width:13.50em}.yui-t4 #yui-main .yui-b{margin-right:14.8456em;*margin-right:14.55em}.yui-t5 .yui-b{float:right;width:18.4615em;*width:18.00em}.yui-t5 #yui-main .yui-b{margin-right:19.4615em;*margin-right:19.125em}.yui-t6 .yui-b{float:right;width:23.0769em;*width:22.50em}.yui-t6 #yui-main .yui-b{margin-right:24.0769em;*margin-right:23.62em}.yui-t7 #yui-main .yui-b{display:block;margin:0 0 1em 0}#yui-main .yui-b{float:none;width:auto}.yui-gb .yui-u,.yui-g .yui-gb .yui-u,.yui-gb .yui-g,.yui-gb .yui-gb,.yui-gb .yui-gc,.yui-gb .yui-gd,.yui-gb .yui-ge,.yui-gb .yui-gf,.yui-gc .yui-u,.yui-gc .yui-g,.yui-gd .yui-u{float:left}.yui-g .yui-u,.yui-g .yui-g,.yui-g .yui-gb,.yui-g .yui-gc,.yui-g .yui-gd,.yui-g .yui-ge,.yui-g .yui-gf,.yui-gc .yui-u,.yui-gd .yui-g,.yui-g .yui-gc .yui-u,.yui-ge .yui-u,.yui-ge .yui-g,.yui-gf .yui-g,.yui-gf .yui-u{float:right}.yui-g div.first,.yui-gb div.first,.yui-gc div.first,.yui-gd div.first,.yui-ge div.first,.yui-gf div.first,.yui-g .yui-gc div.first,.yui-g .yui-ge div.first,.yui-gc div.first div.first{float:left}.yui-g .yui-u,.yui-g .yui-g,.yui-g .yui-gb,.yui-g .yui-gc,.yui-g .yui-gd,.yui-g .yui-ge,.yui-g .yui-gf{width:49.1%}.yui-gb .yui-u,.yui-g .yui-gb .yui-u,.yui-gb .yui-g,.yui-gb .yui-gb,.yui-gb .yui-gc,.yui-gb .yui-gd,.yui-gb .yui-ge,.yui-gb .yui-gf,.yui-gc .yui-u,.yui-gc .yui-g,.yui-gd .yui-u{width:32%;margin-left:1.99%}.yui-gb .yui-u{*margin-left:1.9%;*width:31.9%}.yui-gc div.first,.yui-gd .yui-u{width:66%}.yui-gd div.first{width:32%}.yui-ge div.first,.yui-gf .yui-u{width:74.2%}.yui-ge .yui-u,.yui-gf div.first{width:24%}.yui-g .yui-gb div.first,.yui-gb div.first,.yui-gc div.first,.yui-gd div.first{margin-left:0}.yui-g .yui-g .yui-u,.yui-gb .yui-g .yui-u,.yui-gc .yui-g .yui-u,.yui-gd .yui-g .yui-u,.yui-ge .yui-g .yui-u,.yui-gf .yui-g .yui-u{width:49%;*width:48.1%;*margin-left:0}.yui-g .yui-g .yui-u{width:48.1%}.yui-g .yui-gb div.first,.yui-gb .yui-gb div.first{*margin-right:0;*width:32%;_width:31.7%}.yui-g .yui-gc div.first,.yui-gd .yui-g{width:66%}.yui-gb .yui-g div.first{*margin-right:4%;_margin-right:1.3%}.yui-gb .yui-gc div.first,.yui-gb .yui-gd div.first{*margin-right:0}.yui-gb .yui-gb .yui-u,.yui-gb .yui-gc .yui-u{*margin-left:1.8%;_margin-left:4%}.yui-g .yui-gb .yui-u{_margin-left:1.0%}.yui-gb .yui-gd .yui-u{*width:66%;_width:61.2%}.yui-gb .yui-gd div.first{*width:31%;_width:29.5%}.yui-g .yui-gc .yui-u,.yui-gb .yui-gc .yui-u{width:32%;_float:right;margin-right:0;_margin-left:0}.yui-gb .yui-gc div.first{width:66%;*float:left;*margin-left:0}.yui-gb .yui-ge .yui-u,.yui-gb .yui-gf .yui-u{margin:0}.yui-gb .yui-gb .yui-u{_margin-left:.7%}.yui-gb .yui-g div.first,.yui-gb .yui-gb div.first{*margin-left:0}.yui-gc .yui-g .yui-u,.yui-gd .yui-g .yui-u{*width:48.1%;*margin-left:0}.yui-gb .yui-gd div.first{width:32%}.yui-g .yui-gd div.first{_width:29.9%}.yui-ge .yui-g{width:24%}.yui-gf .yui-g{width:74.2%}.yui-gb .yui-ge div.yui-u,.yui-gb .yui-gf div.yui-u{float:right}.yui-gb .yui-ge div.first,.yui-gb .yui-gf div.first{float:left}.yui-gb .yui-ge .yui-u,.yui-gb .yui-gf div.first{*width:24%;_width:20%}.yui-gb .yui-ge div.first,.yui-gb .yui-gf .yui-u{*width:73.5%;_width:65.5%}.yui-ge div.first .yui-gd .yui-u{width:65%}.yui-ge div.first .yui-gd div.first{width:32%}#hd:after,#bd:after,#ft:after,.yui-g:after,.yui-gb:after,.yui-gc:after,.yui-gd:after,.yui-ge:after,.yui-gf:after{content:"";display:block;clear:both}#hd,#bd,#ft,.yui-g,.yui-gb,.yui-gc,.yui-gd,.yui-ge,.yui-gf{zoom:1}
\ No newline at end of file

diff --git a/js/yui/grids/grids.css b/js/yui/grids/grids.css
new file mode 100644 (file)
index 0000000..c5407c8
--- /dev/null
+++ b/js/yui/grids/grids.css
@@ -0,0 +1,465 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+/**
+ * YUI Grids
+ * @module grids
+ * @namespace yui-
+ * @requires reset, fonts
+ */
+
+/**  
+ * Note: Throughout this file, the *property (star-property) filter is used 
+ * to give a value to IE < 8 that other browsers do not see. The _property (underscore-property)
+ * is only seen by IE < 7, so the combo of *prop and _prop can differentiate between IE6 and IE7.
+ * 
+ * More information on these filters and related validation errors:
+ * http://tech.groups.yahoo.com/group/ydn-javascript/message/40059
+ */
+
+/**
+ * Section: General Rules
+ */
+
+body {
+       text-align: center;
+}
+
+/**
+ * Section: Page Width Rules (#doc, #doc2, #doc3, #doc4)
+ */
+
+#doc,#doc2,#doc3,#doc4,
+.yui-t1,.yui-t2,.yui-t3,.yui-t4,.yui-t5,.yui-t6,.yui-t7 {
+       margin: auto;
+       text-align: left;
+       width: 57.69em;
+       *width: 56.25em;
+}
+
+/* 950 Centered (doc2) */
+#doc2 {
+       width: 73.076em;
+       *width: 71.25em;
+}
+
+/* 100% (doc3) */
+#doc3 {
+/**
+ * Left and Right margins are not a structural part of Grids. Without them 
+ * Grids works fine, but content bleeds to the very edge of the document, which
+ * often impairs readability and usability. They are provided because they 
+ * prevent the content from "bleeding" into the browser's chrome. 
+ */
+       margin: auto 10px;
+       width: auto;
+}
+
+/* 974 Centered (doc4) */
+#doc4 {
+       width: 74.923em;
+       *width: 73.05em;
+}
+
+/**
+ * Section: Preset Template Rules (.yui-t[1-6])
+ */
+
+
+.yui-b {
+       /* to preserve source-order independence for Gecko */
+       position: relative;
+}
+
+.yui-b {
+       /* to preserve source-order independence for IE */
+       _position: static;
+}
+
+#yui-main .yui-b {
+       /* to preserve source-order independence for Gecko */
+       position: static;
+}
+
+#yui-main,
+.yui-g .yui-u .yui-g {
+       width: 100%;
+}
+
+.yui-t1 #yui-main,
+.yui-t2 #yui-main,
+.yui-t3 #yui-main {
+       float: right;
+       /* IE: preserve layout at narrow widths */
+       margin-left: -25em;
+}
+
+.yui-t4 #yui-main,
+.yui-t5 #yui-main,
+.yui-t6 #yui-main {
+       float: left;
+       /* IE: preserve layout at narrow widths */
+       margin-right: -25em;
+}
+
+/** 
+ * For Specific Template Presets
+ */
+
+.yui-t1 .yui-b {
+       float: left;
+       width: 12.30769em;
+       *width: 12.00em;
+}
+
+.yui-t1 #yui-main .yui-b {
+       margin-left: 13.30769em;
+       *margin-left: 13.05em;
+}
+
+.yui-t2 .yui-b {
+       float: left;
+       width: 13.8461em;
+       *width: 13.50em;
+}
+
+.yui-t2 #yui-main .yui-b {
+       margin-left: 14.8461em;
+       *margin-left: 14.55em;
+}
+
+.yui-t3 .yui-b {
+       float: left;
+       width: 23.0769em;
+       *width: 22.50em;
+}
+
+.yui-t3 #yui-main .yui-b {
+       margin-left: 24.0769em;
+       *margin-left: 23.62em;
+}
+
+.yui-t4 .yui-b {
+       float: right;
+       width: 13.8456em;
+       *width: 13.50em;
+}
+
+.yui-t4 #yui-main .yui-b {
+       margin-right: 14.8456em;
+       *margin-right: 14.55em;
+}
+
+.yui-t5 .yui-b {
+       float: right;
+       width: 18.4615em;
+       *width: 18.00em;
+}
+
+.yui-t5 #yui-main .yui-b {
+       margin-right: 19.4615em;
+       *margin-right: 19.125em;
+}
+
+.yui-t6 .yui-b {
+       float: right;
+       width: 23.0769em;
+       *width: 22.50em;
+}
+
+.yui-t6 #yui-main .yui-b {
+       margin-right: 24.0769em;
+       *margin-right: 23.62em;
+}
+
+.yui-t7 #yui-main .yui-b {
+       display: block;
+       margin: 0 0 1em 0;
+}
+
+#yui-main .yui-b {
+       float: none;
+       width: auto;
+}
+
+/**
+ * Section: Grids and Nesting Grids
+ */
+
+/* Children generally take half the available space */
+.yui-gb .yui-u,
+.yui-g .yui-gb .yui-u,
+.yui-gb .yui-g,
+.yui-gb .yui-gb,
+.yui-gb .yui-gc,
+.yui-gb .yui-gd,
+.yui-gb .yui-ge,
+.yui-gb .yui-gf,
+.yui-gc .yui-u, 
+.yui-gc .yui-g,
+.yui-gd .yui-u {
+       float: left;
+}
+
+/* Float units (and sub grids) to the right */
+.yui-g .yui-u,
+.yui-g .yui-g,
+.yui-g .yui-gb, 
+.yui-g .yui-gc, 
+.yui-g .yui-gd, 
+.yui-g .yui-ge, 
+.yui-g .yui-gf, 
+.yui-gc .yui-u, 
+.yui-gd .yui-g,
+.yui-g .yui-gc .yui-u,
+.yui-ge .yui-u, 
+.yui-ge .yui-g, 
+.yui-gf .yui-g,
+.yui-gf .yui-u {
+       float: right;
+}
+
+/*Float units (and sub grids) to the left */
+.yui-g div.first, 
+.yui-gb div.first,
+.yui-gc div.first,
+.yui-gd div.first, 
+.yui-ge div.first, 
+.yui-gf div.first,
+.yui-g .yui-gc div.first,
+.yui-g .yui-ge div.first,
+.yui-gc div.first div.first {
+       float: left;
+}
+
+.yui-g .yui-u,
+.yui-g .yui-g,
+.yui-g .yui-gb,
+.yui-g .yui-gc,
+.yui-g .yui-gd,
+.yui-g .yui-ge,
+.yui-g .yui-gf {
+       width: 49.1%;
+}
+
+.yui-gb .yui-u,
+.yui-g .yui-gb .yui-u,
+.yui-gb .yui-g,
+.yui-gb .yui-gb,
+.yui-gb .yui-gc,
+.yui-gb .yui-gd,
+.yui-gb .yui-ge,
+.yui-gb .yui-gf,
+.yui-gc .yui-u, 
+.yui-gc .yui-g,
+.yui-gd .yui-u {
+       width: 32%;
+       margin-left: 1.99%;
+}
+
+/* Give IE some extra breathing room for 1/3-based rounding issues */
+.yui-gb .yui-u {
+       *margin-left: 1.9%;
+       *width: 31.9%;
+}
+
+.yui-gc div.first, 
+       .yui-gd .yui-u {
+       width: 66%;
+}
+
+.yui-gd div.first {
+       width: 32%;
+}
+
+.yui-ge div.first, 
+       .yui-gf .yui-u {
+       width: 74.2%;
+}
+
+.yui-ge .yui-u,
+       .yui-gf div.first {
+       width: 24%;
+}
+
+.yui-g .yui-gb div.first,
+.yui-gb div.first, 
+.yui-gc div.first, 
+.yui-gd div.first {
+       margin-left: 0;
+}
+
+/**
+ * Section: Deep Nesting 
+ */
+
+.yui-g .yui-g .yui-u,
+.yui-gb .yui-g .yui-u,
+.yui-gc .yui-g .yui-u,
+.yui-gd .yui-g .yui-u,
+.yui-ge .yui-g .yui-u,
+.yui-gf .yui-g .yui-u {
+       width: 49%;
+       *width: 48.1%;
+       *margin-left: 0;
+}
+
+.yui-g .yui-g .yui-u {
+       width: 48.1%;
+}
+
+/* YUILibrary bug #1927599 from 1.14 to 2.6.0*/
+.yui-g .yui-gb div.first,
+       .yui-gb .yui-gb div.first {
+       *margin-right: 0;
+       *width: 32%;
+       _width: 31.7%;
+}
+
+.yui-g .yui-gc div.first, 
+       .yui-gd .yui-g {
+       width: 66%;
+}
+
+.yui-gb .yui-g div.first {
+       *margin-right: 4%;
+       _margin-right: 1.3%;
+}
+
+.yui-gb .yui-gc div.first, 
+       .yui-gb .yui-gd div.first {
+       *margin-right: 0;
+}
+
+.yui-gb .yui-gb .yui-u,
+       .yui-gb .yui-gc .yui-u {
+       *margin-left: 1.8%;
+       _margin-left: 4%;
+}
+
+.yui-g .yui-gb .yui-u {
+       _margin-left: 1.0%;
+}
+
+.yui-gb .yui-gd .yui-u {
+       *width: 66%;
+       _width: 61.2%;
+}
+
+.yui-gb .yui-gd div.first {
+       *width: 31%;
+       _width: 29.5%;
+}
+
+.yui-g .yui-gc .yui-u, 
+       .yui-gb .yui-gc .yui-u {
+       width: 32%;
+       _float: right;
+       margin-right: 0;
+       _margin-left: 0;
+}
+
+.yui-gb .yui-gc div.first {
+       width: 66%;
+       *float: left;
+       *margin-left: 0;
+}
+
+.yui-gb .yui-ge .yui-u, 
+       .yui-gb .yui-gf .yui-u {
+       margin: 0;
+}
+
+.yui-gb .yui-gb .yui-u {
+       _margin-left: .7%;
+}
+
+.yui-gb .yui-g div.first, 
+       .yui-gb .yui-gb div.first {
+       *margin-left: 0;
+}
+
+.yui-gc .yui-g .yui-u,
+       .yui-gd .yui-g .yui-u {
+       *width: 48.1%;
+       *margin-left: 0;
+}
+
+.yui-gb .yui-gd div.first {
+       width: 32%;
+}
+
+.yui-g .yui-gd div.first {
+       _width: 29.9%;
+}
+
+.yui-ge .yui-g {
+       width: 24%;
+}
+
+.yui-gf .yui-g {
+       width: 74.2%;
+}
+
+.yui-gb .yui-ge div.yui-u,
+       .yui-gb .yui-gf div.yui-u {
+       float: right;
+}
+
+.yui-gb .yui-ge div.first,
+       .yui-gb .yui-gf div.first {
+       float: left;
+}
+
+/* Width Accommodation for Nested Contexts */
+.yui-gb .yui-ge .yui-u,
+       .yui-gb .yui-gf div.first {
+       *width: 24%;
+       _width: 20%;
+}
+
+/* Width Accommodation for Nested Contexts */
+.yui-gb .yui-ge div.first, 
+       .yui-gb .yui-gf .yui-u {
+       *width: 73.5%;
+       _width: 65.5%;
+}
+
+/* Patch for GD within GE */
+.yui-ge div.first .yui-gd .yui-u {
+       width: 65%;
+}
+
+.yui-ge div.first .yui-gd div.first {
+       width: 32%;
+}
+
+/* @group Clearing */
+#hd:after,
+#bd:after,
+#ft:after,
+.yui-g:after, 
+.yui-gb:after, 
+.yui-gc:after, 
+.yui-gd:after, 
+.yui-ge:after, 
+.yui-gf:after {
+       content: "";
+       display: block;
+       clear: both;
+}
+
+#hd,
+#bd,
+#ft,
+.yui-g, 
+.yui-gb, 
+.yui-gc, 
+.yui-gd, 
+.yui-ge, 
+.yui-gf {
+       zoom: 1;
+}

diff --git a/js/yui/history/history-min.js b/js/yui/history/history-min.js
new file mode 100644 (file)
index 0000000..424256c
--- /dev/null
+++ b/js/yui/history/history-min.js
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.util.History=(function(){var d=null;var m=null;var g=false;var e=[];var c=[];function k(){var o,n;n=self.location.href;o=n.indexOf("#");return o>=0?n.substr(o+1):null;}function b(){var o,p,q=[],n=[];for(o in e){if(YAHOO.lang.hasOwnProperty(e,o)){p=e[o];q.push(o+"="+p.initialState);n.push(o+"="+p.currentState);}}m.value=q.join("&")+"|"+n.join("&");}function j(n){var s,t,o,q,r,v,u,p;if(!n){for(o in e){if(YAHOO.lang.hasOwnProperty(e,o)){q=e[o];q.currentState=q.initialState;q.onStateChange(i(q.currentState));}}return;}r=[];v=n.split("&");for(s=0,t=v.length;s<t;s++){u=v[s].split("=");if(u.length===2){o=u[0];p=u[1];r[o]=p;}}for(o in e){if(YAHOO.lang.hasOwnProperty(e,o)){q=e[o];p=r[o];if(!p||q.currentState!==p){q.currentState=typeof p==="undefined"?q.initialState:p;q.onStateChange(i(q.currentState));}}}}function l(q){var n,p;n='<html><body><div id="state">'+YAHOO.lang.escapeHTML(q)+"</div></body></html>";try{p=d.contentWindow.document;p.open();p.write(n);p.close();return true;}catch(o){return false;}}function h(){var q,n,p,o;if(!d.contentWindow||!d.contentWindow.document){setTimeout(h,10);return;}q=d.contentWindow.document;n=q.getElementById("state");p=n?n.innerText:null;o=k();setInterval(function(){var w,s,t,u,v,r;q=d.contentWindow.document;n=q.getElementById("state");w=n?n.innerText:null;v=k();if(w!==p){p=w;j(p);if(!p){s=[];for(t in e){if(YAHOO.lang.hasOwnProperty(e,t)){u=e[t];s.push(t+"="+u.initialState);}}v=s.join("&");}else{v=p;}self.location.hash=v;o=v;b();}else{if(v!==o){o=v;l(v);}}},50);g=true;YAHOO.util.History.onLoadEvent.fire();}function f(){var u,w,s,y,o,q,x,r,v,p,n,t;s=m.value.split("|");if(s.length>1){x=s[0].split("&");for(u=0,w=x.length;u<w;u++){y=x[u].split("=");if(y.length===2){o=y[0];r=y[1];q=YAHOO.lang.hasOwnProperty(e,o)&&e[o];if(q){q.initialState=r;}}}v=s[1].split("&");for(u=0,w=v.length;u<w;u++){y=v[u].split("=");if(y.length>=2){o=y[0];p=y[1];q=YAHOO.lang.hasOwnProperty(e,o)&&e[o];if(q){q.currentState=p;}}}}if(s.length>2){c=s[2].split(",");}if(YAHOO.env.ua.ie){if(typeof document.documentMode==="undefined"||document.documentMode<8){h();}else{YAHOO.util.Event.on(top,"hashchange",function(){var z=k();j(z);b();});g=true;YAHOO.util.History.onLoadEvent.fire();}}else{t=k();setInterval(function(){var B,z,A;z=k();if(z!==t){t=z;j(t);b();}},50);g=true;YAHOO.util.History.onLoadEvent.fire();}}function i(n){return decodeURIComponent(n.replace(/\+/g," "));}function a(n){return encodeURIComponent(n).replace(/%20/g,"+");}return{onLoadEvent:new YAHOO.util.CustomEvent("onLoad"),onReady:function(n,o,p){if(g){setTimeout(function(){var q=window;if(p){if(p===true){q=o;}else{q=p;}}n.call(q,"onLoad",[],o);},0);}else{YAHOO.util.History.onLoadEvent.subscribe(n,o,p);}},register:function(p,n,r,s,t){var q,o;if(typeof p!=="string"||YAHOO.lang.trim(p)===""||typeof n!=="string"||typeof r!=="function"){throw new Error("Missing or invalid argument");}if(YAHOO.lang.hasOwnProperty(e,p)){return;}if(g){throw new Error("All modules must be registered before calling YAHOO.util.History.initialize");}p=a(p);n=a(n);q=null;if(t===true){q=s;}else{q=t;}o=function(u){return r.call(q,u,s);};e[p]={name:p,initialState:n,currentState:n,onStateChange:o};},initialize:function(n,o){if(g){return;}if(YAHOO.env.ua.opera&&typeof history.navigationMode!=="undefined"){history.navigationMode="compatible";}if(typeof n==="string"){n=document.getElementById(n);}if(!n||n.tagName.toUpperCase()!=="TEXTAREA"&&(n.tagName.toUpperCase()!=="INPUT"||n.type!=="hidden"&&n.type!=="text")){throw new Error("Missing or invalid argument");}m=n;if(YAHOO.env.ua.ie&&(typeof document.documentMode==="undefined"||document.documentMode<8)){if(typeof o==="string"){o=document.getElementById(o);}if(!o||o.tagName.toUpperCase()!=="IFRAME"){throw new Error("Missing or invalid argument");}d=o;}YAHOO.util.Event.onDOMReady(f);},navigate:function(o,p){var n;if(typeof o!=="string"||typeof p!=="string"){throw new Error("Missing or invalid argument");}n={};n[o]=p;return YAHOO.util.History.multiNavigate(n);},multiNavigate:function(o){var n,p,r,q,s;if(typeof o!=="object"){throw new Error("Missing or invalid argument");}if(!g){throw new Error("The Browser History Manager is not initialized");}for(p in o){if(!YAHOO.lang.hasOwnProperty(e,a(p))){throw new Error("The following module has not been registered: "+p);}}n=[];for(p in e){if(YAHOO.lang.hasOwnProperty(e,p)){r=e[p];if(YAHOO.lang.hasOwnProperty(o,p)){q=o[i(p)];}else{q=i(r.currentState);}p=a(p);q=a(q);n.push(p+"="+q);}}s=n.join("&");if(YAHOO.env.ua.ie&&(typeof document.documentMode==="undefined"||document.documentMode<8)){return l(s);}else{self.location.hash=s;return true;}},getCurrentState:function(n){var o;if(typeof n!=="string"){throw new Error("Missing or invalid argument");}if(!g){throw new Error("The Browser History Manager is not initialized");}o=YAHOO.lang.hasOwnProperty(e,n)&&e[n];if(!o){throw new Error("No such registered module: "+n);}return i(o.currentState);},getBookmarkedState:function(s){var r,o,n,u,p,t,q;if(typeof s!=="string"){throw new Error("Missing or invalid argument");}n=self.location.href.indexOf("#");if(n>=0){u=self.location.href.substr(n+1);p=u.split("&");for(r=0,o=p.length;r<o;r++){t=p[r].split("=");if(t.length===2){q=t[0];if(q===s){return i(t[1]);}}}}return null;},getQueryStringParameter:function(s,p){var q,o,n,u,t,r;p=p||self.location.href;n=p.indexOf("?");u=n>=0?p.substr(n+1):p;n=u.lastIndexOf("#");u=n>=0?u.substr(0,n):u;t=u.split("&");for(q=0,o=t.length;q<o;q++){r=t[q].split("=");if(r.length>=2){if(r[0]===s){return i(r[1]);}}}return null;}};})();YAHOO.register("history",YAHOO.util.History,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/imagecropper/imagecropper-min.js b/js/yui/imagecropper/imagecropper-min.js
new file mode 100644 (file)
index 0000000..10cbba6
--- /dev/null
+++ b/js/yui/imagecropper/imagecropper-min.js
@@ -0,0 +1,8 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){var C=YAHOO.util.Dom,A=YAHOO.util.Event,D=YAHOO.lang;var B=function(F,E){var G={element:F,attributes:E||{}};B.superclass.constructor.call(this,G.element,G.attributes);};B._instances={};B.getCropperById=function(E){if(B._instances[E]){return B._instances[E];}return false;};YAHOO.extend(B,YAHOO.util.Element,{CSS_MAIN:"yui-crop",CSS_MASK:"yui-crop-mask",CSS_RESIZE_MASK:"yui-crop-resize-mask",_image:null,_active:null,_resize:null,_resizeEl:null,_resizeMaskEl:null,_wrap:null,_mask:null,_createWrap:function(){this._wrap=document.createElement("div");this._wrap.id=this.get("element").id+"_wrap";this._wrap.className=this.CSS_MAIN;var F=this.get("element");this._wrap.style.width=F.width?F.width+"px":C.getStyle(F,"width");this._wrap.style.height=F.height?F.height+"px":C.getStyle(F,"height");var E=this.get("element").parentNode;E.replaceChild(this._wrap,this.get("element"));this._wrap.appendChild(this.get("element"));A.on(this._wrap,"mouseover",this._handleMouseOver,this,true);A.on(this._wrap,"mouseout",this._handleMouseOut,this,true);A.on(this._wrap,"click",function(G){A.stopEvent(G);},this,true);},_createMask:function(){this._mask=document.createElement("div");this._mask.className=this.CSS_MASK;this._wrap.appendChild(this._mask);},_createResize:function(){this._resizeEl=document.createElement("div");this._resizeEl.className=YAHOO.util.Resize.prototype.CSS_RESIZE;this._resizeEl.style.position="absolute";this._resizeEl.innerHTML='<div class="'+this.CSS_RESIZE_MASK+'"></div>';this._resizeMaskEl=this._resizeEl.firstChild;this._wrap.appendChild(this._resizeEl);this._resizeEl.style.top=this.get("initialXY")[1]+"px";this._resizeEl.style.left=this.get("initialXY")[0]+"px";this._resizeMaskEl.style.height=Math.floor(this.get("initHeight"))+"px";this._resizeMaskEl.style.width=Math.floor(this.get("initWidth"))+"px";this._resize=new YAHOO.util.Resize(this._resizeEl,{knobHandles:true,handles:"all",draggable:true,status:this.get("status"),minWidth:this.get("minWidth"),minHeight:this.get("minHeight"),ratio:this.get("ratio"),autoRatio:this.get("autoRatio"),height:this.get("initHeight"),width:this.get("initWidth")});this._setBackgroundImage(this.get("element").getAttribute("src",2));this._setBackgroundPosition(-(this.get("initialXY")[0]),-(this.get("initialXY")[1]));this._resize.on("startResize",this._handleStartResizeEvent,this,true);this._resize.on("endResize",this._handleEndResizeEvent,this,true);this._resize.on("dragEvent",this._handleDragEvent,this,true);this._resize.on("beforeResize",this._handleBeforeResizeEvent,this,true);this._resize.on("resize",this._handleResizeEvent,this,true);this._resize.dd.on("b4StartDragEvent",this._handleB4DragEvent,this,true);},_handleMouseOver:function(F){var E="keydown";if(YAHOO.env.ua.gecko||YAHOO.env.ua.opera){E="keypress";}if(!this._active){this._active=true;if(this.get("useKeys")){A.on(document,E,this._handleKeyPress,this,true);}}},_handleMouseOut:function(F){var E="keydown";if(YAHOO.env.ua.gecko||YAHOO.env.ua.opera){E="keypress";}this._active=false;if(this.get("useKeys")){A.removeListener(document,E,this._handleKeyPress);}},_moveEl:function(G,J){var H=0,E=0,I=this._setConstraints(),F=true;switch(G){case"down":H=-(J);if((I.bottom-J)<0){F=false;this._resizeEl.style.top=(I.top+I.bottom)+"px";}break;case"up":H=(J);if((I.top-J)<0){F=false;this._resizeEl.style.top="0px";}break;case"right":E=-(J);if((I.right-J)<0){F=false;this._resizeEl.style.left=(I.left+I.right)+"px";}break;case"left":E=J;if((I.left-J)<0){F=false;this._resizeEl.style.left="0px";}break;}if(F){this._resizeEl.style.left=(parseInt(this._resizeEl.style.left,10)-E)+"px";this._resizeEl.style.top=(parseInt(this._resizeEl.style.top,10)-H)+"px";this.fireEvent("moveEvent",{target:"keypress"});}else{this._setConstraints();}this._syncBackgroundPosition();},_handleKeyPress:function(G){var E=A.getCharCode(G),F=false,H=((G.shiftKey)?this.get("shiftKeyTick"):this.get("keyTick"));switch(E){case 37:this._moveEl("left",H);F=true;break;case 38:this._moveEl("up",H);F=true;break;case 39:this._moveEl("right",H);F=true;break;case 40:this._moveEl("down",H);F=true;break;default:}if(F){A.preventDefault(G);}},_handleB4DragEvent:function(){this._setConstraints();},_handleDragEvent:function(){this._syncBackgroundPosition();this.fireEvent("dragEvent",arguments);this.fireEvent("moveEvent",{target:"dragevent"});},_handleBeforeResizeEvent:function(F){var I=C.getRegion(this.get("element")),J=this._resize._cache,H=this._resize._currentHandle,G=0,E=0;if(F.top&&(F.top<I.top)){G=(J.height+J.top)-I.top;C.setY(this._resize.getWrapEl(),I.top);this._resize.getWrapEl().style.height=G+"px";this._resize._cache.height=G;this._resize._cache.top=I.top;this._syncBackgroundPosition();return false;}if(F.left&&(F.left<I.left)){E=(J.width+J.left)-I.left;C.setX(this._resize.getWrapEl(),I.left);this._resize._cache.left=I.left;this._resize.getWrapEl().style.width=E+"px";this._resize._cache.width=E;this._syncBackgroundPosition();return false;}if(H!="tl"&&H!="l"&&H!="bl"){if(J.left&&F.width&&((J.left+F.width)>I.right)){E=(I.right-J.left);C.setX(this._resize.getWrapEl(),(I.right-E));this._resize.getWrapEl().style.width=E+"px";this._resize._cache.left=(I.right-E);this._resize._cache.width=E;this._syncBackgroundPosition();return false;}}if(H!="t"&&H!="tr"&&H!="tl"){if(J.top&&F.height&&((J.top+F.height)>I.bottom)){G=(I.bottom-J.top);C.setY(this._resize.getWrapEl(),(I.bottom-G));this._resize.getWrapEl().style.height=G+"px";this._resize._cache.height=G;this._resize._cache.top=(I.bottom-G);this._syncBackgroundPosition();return false;}}},_handleResizeMaskEl:function(){var E=this._resize._cache;this._resizeMaskEl.style.height=Math.floor(E.height)+"px";this._resizeMaskEl.style.width=Math.floor(E.width)+"px";},_handleResizeEvent:function(E){this._setConstraints(true);this._syncBackgroundPosition();this.fireEvent("resizeEvent",arguments);this.fireEvent("moveEvent",{target:"resizeevent"});},_syncBackgroundPosition:function(){this._handleResizeMaskEl();this._setBackgroundPosition(-(parseInt(this._resizeEl.style.left,10)),-(parseInt(this._resizeEl.style.top,10)));
+},_setBackgroundPosition:function(F,H){var J=parseInt(C.getStyle(this._resize.get("element"),"borderLeftWidth"),10);var G=parseInt(C.getStyle(this._resize.get("element"),"borderTopWidth"),10);if(isNaN(J)){J=0;}if(isNaN(G)){G=0;}var E=this._resize.getWrapEl().firstChild;var I=(F-J)+"px "+(H-G)+"px";this._resizeMaskEl.style.backgroundPosition=I;},_setBackgroundImage:function(F){var E=this._resize.getWrapEl().firstChild;this._image=F;E.style.backgroundImage="url("+F+"#)";},_handleEndResizeEvent:function(){this._setConstraints(true);},_handleStartResizeEvent:function(){this._setConstraints(true);var I=this._resize._cache.height,F=this._resize._cache.width,H=parseInt(this._resize.getWrapEl().style.top,10),E=parseInt(this._resize.getWrapEl().style.left,10),G=0,J=0;switch(this._resize._currentHandle){case"b":G=(I+this._resize.dd.bottomConstraint);break;case"l":J=(F+this._resize.dd.leftConstraint);break;case"r":G=(I+H);J=(F+this._resize.dd.rightConstraint);break;case"br":G=(I+this._resize.dd.bottomConstraint);J=(F+this._resize.dd.rightConstraint);break;case"tr":G=(I+H);J=(F+this._resize.dd.rightConstraint);break;}if(G){}if(J){}this.fireEvent("startResizeEvent",arguments);},_setConstraints:function(J){var H=this._resize;H.dd.resetConstraints();var N=parseInt(H.get("height"),10),F=parseInt(H.get("width"),10);if(J){N=H._cache.height;F=H._cache.width;}var L=C.getRegion(this.get("element"));var G=H.getWrapEl();var O=C.getXY(G);var I=O[0]-L.left;var M=L.right-O[0]-F;var K=O[1]-L.top;var E=L.bottom-O[1]-N;if(K<0){K=0;}H.dd.setXConstraint(I,M);H.dd.setYConstraint(K,E);return{top:K,right:M,bottom:E,left:I};},getCropCoords:function(){var E={top:parseInt(this._resize.getWrapEl().style.top,10),left:parseInt(this._resize.getWrapEl().style.left,10),height:this._resize._cache.height,width:this._resize._cache.width,image:this._image};return E;},reset:function(){this._resize.resize(null,this.get("initHeight"),this.get("initWidth"),0,0,true);this._resizeEl.style.top=this.get("initialXY")[1]+"px";this._resizeEl.style.left=this.get("initialXY")[0]+"px";this._syncBackgroundPosition();return this;},getEl:function(){return this.get("element");},getResizeEl:function(){return this._resizeEl;},getWrapEl:function(){return this._wrap;},getMaskEl:function(){return this._mask;},getResizeMaskEl:function(){return this._resizeMaskEl;},getResizeObject:function(){return this._resize;},init:function(G,E){B.superclass.init.call(this,G,E);var H=G;if(!D.isString(H)){if(H.tagName&&(H.tagName.toLowerCase()=="img")){H=C.generateId(H);}else{return false;}}else{var F=C.get(H);if(F.tagName&&F.tagName.toLowerCase()=="img"){}else{return false;}}B._instances[H]=this;this._createWrap();this._createMask();this._createResize();this._setConstraints();},initAttributes:function(E){B.superclass.initAttributes.call(this,E);this.setAttributeConfig("initialXY",{validator:YAHOO.lang.isArray,value:E.initialXY||[10,10]});this.setAttributeConfig("keyTick",{validator:YAHOO.lang.isNumber,value:E.keyTick||1});this.setAttributeConfig("shiftKeyTick",{validator:YAHOO.lang.isNumber,value:E.shiftKeyTick||10});this.setAttributeConfig("useKeys",{validator:YAHOO.lang.isBoolean,value:((E.useKeys===false)?false:true)});this.setAttributeConfig("status",{validator:YAHOO.lang.isBoolean,value:((E.status===false)?false:true),method:function(F){if(this._resize){this._resize.set("status",F);}}});this.setAttributeConfig("minHeight",{validator:YAHOO.lang.isNumber,value:E.minHeight||50,method:function(F){if(this._resize){this._resize.set("minHeight",F);}}});this.setAttributeConfig("minWidth",{validator:YAHOO.lang.isNumber,value:E.minWidth||50,method:function(F){if(this._resize){this._resize.set("minWidth",F);}}});this.setAttributeConfig("ratio",{validator:YAHOO.lang.isBoolean,value:E.ratio||false,method:function(F){if(this._resize){this._resize.set("ratio",F);}}});this.setAttributeConfig("autoRatio",{validator:YAHOO.lang.isBoolean,value:((E.autoRatio===false)?false:true),method:function(F){if(this._resize){this._resize.set("autoRatio",F);}}});this.setAttributeConfig("initHeight",{writeOnce:true,validator:YAHOO.lang.isNumber,value:E.initHeight||(this.get("element").height/4)});this.setAttributeConfig("initWidth",{validator:YAHOO.lang.isNumber,writeOnce:true,value:E.initWidth||(this.get("element").width/4)});},destroy:function(){this._resize.destroy();this._resizeEl.parentNode.removeChild(this._resizeEl);this._mask.parentNode.removeChild(this._mask);A.purgeElement(this._wrap);this._wrap.parentNode.replaceChild(this.get("element"),this._wrap);for(var E in this){if(D.hasOwnProperty(this,E)){this[E]=null;}}},toString:function(){if(this.get){return"ImageCropper (#"+this.get("id")+")";}return"Image Cropper";}});YAHOO.widget.ImageCropper=B;})();YAHOO.register("imagecropper",YAHOO.widget.ImageCropper,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/imageloader/imageloader-min.js b/js/yui/imageloader/imageloader-min.js
new file mode 100644 (file)
index 0000000..555633c
--- /dev/null
+++ b/js/yui/imageloader/imageloader-min.js
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+if(typeof(YAHOO.util.ImageLoader)=="undefined"){YAHOO.util.ImageLoader={};}YAHOO.util.ImageLoader.group=function(A,B,C){this.name="unnamed";this._imgObjs={};this.timeoutLen=C;this._timeout=null;this._triggers=[];this._customTriggers=[];this.foldConditional=false;this.className=null;this._classImageEls=null;if(YAHOO.util.Event.DOMReady){this._onloadTasks();}else{YAHOO.util.Event.onDOMReady(this._onloadTasks,this,true);}this.addTrigger(A,B);};YAHOO.util.ImageLoader.group.prototype.addTrigger=function(B,C){if(!B||!C){return;}var A=function(){this.fetch();};this._triggers.push([B,C,A]);YAHOO.util.Event.addListener(B,C,A,this,true);};YAHOO.util.ImageLoader.group.prototype.addCustomTrigger=function(B){if(!B||!B instanceof YAHOO.util.CustomEvent){return;}var A=function(){this.fetch();};this._customTriggers.push([B,A]);B.subscribe(A,this,true);};YAHOO.util.ImageLoader.group.prototype._onloadTasks=function(){if(this.timeoutLen&&typeof(this.timeoutLen)=="number"&&this.timeoutLen>0){this._timeout=setTimeout(this._getFetchTimeout(),this.timeoutLen*1000);}if(this.foldConditional){this._foldCheck();}};YAHOO.util.ImageLoader.group.prototype._getFetchTimeout=function(){var A=this;return function(){A.fetch();};};YAHOO.util.ImageLoader.group.prototype.registerBgImage=function(B,A){this._imgObjs[B]=new YAHOO.util.ImageLoader.bgImgObj(B,A);return this._imgObjs[B];};YAHOO.util.ImageLoader.group.prototype.registerSrcImage=function(D,B,C,A){this._imgObjs[D]=new YAHOO.util.ImageLoader.srcImgObj(D,B,C,A);return this._imgObjs[D];};YAHOO.util.ImageLoader.group.prototype.registerPngBgImage=function(C,B,A){this._imgObjs[C]=new YAHOO.util.ImageLoader.pngBgImgObj(C,B,A);return this._imgObjs[C];};YAHOO.util.ImageLoader.group.prototype.fetch=function(){var B,A,C;clearTimeout(this._timeout);for(B=0,A=this._triggers.length;B<A;B++){YAHOO.util.Event.removeListener(this._triggers[B][0],this._triggers[B][1],this._triggers[B][2]);}for(B=0,A=this._customTriggers.length;B<A;B++){this._customTriggers[B][0].unsubscribe(this._customTriggers[B][1],this);}this._fetchByClass();for(C in this._imgObjs){if(YAHOO.lang.hasOwnProperty(this._imgObjs,C)){this._imgObjs[C].fetch();}}};YAHOO.util.ImageLoader.group.prototype._foldCheck=function(){var C=(document.compatMode!="CSS1Compat")?document.body.scrollTop:document.documentElement.scrollTop,D=YAHOO.util.Dom.getViewportHeight(),A=C+D,E=(document.compatMode!="CSS1Compat")?document.body.scrollLeft:document.documentElement.scrollLeft,G=YAHOO.util.Dom.getViewportWidth(),I=E+G,B,J,F,H;for(B in this._imgObjs){if(YAHOO.lang.hasOwnProperty(this._imgObjs,B)){J=YAHOO.util.Dom.getXY(this._imgObjs[B].domId);if(J[1]<A&&J[0]<I){this._imgObjs[B].fetch();}}}if(this.className){this._classImageEls=YAHOO.util.Dom.getElementsByClassName(this.className);for(F=0,H=this._classImageEls.length;F<H;F++){J=YAHOO.util.Dom.getXY(this._classImageEls[F]);if(J[1]<A&&J[0]<I){YAHOO.util.Dom.removeClass(this._classImageEls[F],this.className);}}}};YAHOO.util.ImageLoader.group.prototype._fetchByClass=function(){if(!this.className){return;}if(this._classImageEls===null){this._classImageEls=YAHOO.util.Dom.getElementsByClassName(this.className);}YAHOO.util.Dom.removeClass(this._classImageEls,this.className);};YAHOO.util.ImageLoader.imgObj=function(B,A){this.domId=B;this.url=A;this.width=null;this.height=null;this.setVisible=false;this._fetched=false;};YAHOO.util.ImageLoader.imgObj.prototype.fetch=function(){if(this._fetched){return;}var A=document.getElementById(this.domId);if(!A){return;}this._applyUrl(A);if(this.setVisible){A.style.visibility="visible";}if(this.width){A.width=this.width;}if(this.height){A.height=this.height;}this._fetched=true;};YAHOO.util.ImageLoader.imgObj.prototype._applyUrl=function(A){};YAHOO.util.ImageLoader.bgImgObj=function(B,A){YAHOO.util.ImageLoader.bgImgObj.superclass.constructor.call(this,B,A);};YAHOO.lang.extend(YAHOO.util.ImageLoader.bgImgObj,YAHOO.util.ImageLoader.imgObj);YAHOO.util.ImageLoader.bgImgObj.prototype._applyUrl=function(A){A.style.backgroundImage="url('"+this.url+"')";};YAHOO.util.ImageLoader.srcImgObj=function(D,B,C,A){YAHOO.util.ImageLoader.srcImgObj.superclass.constructor.call(this,D,B);this.width=C;this.height=A;};YAHOO.lang.extend(YAHOO.util.ImageLoader.srcImgObj,YAHOO.util.ImageLoader.imgObj);YAHOO.util.ImageLoader.srcImgObj.prototype._applyUrl=function(A){A.src=this.url;};YAHOO.util.ImageLoader.pngBgImgObj=function(C,B,A){YAHOO.util.ImageLoader.pngBgImgObj.superclass.constructor.call(this,C,B);this.props=A||{};};YAHOO.lang.extend(YAHOO.util.ImageLoader.pngBgImgObj,YAHOO.util.ImageLoader.imgObj);YAHOO.util.ImageLoader.pngBgImgObj.prototype._applyUrl=function(B){if(YAHOO.env.ua.ie&&YAHOO.env.ua.ie<=6){var C=(YAHOO.lang.isUndefined(this.props.sizingMethod))?"scale":this.props.sizingMethod,A=(YAHOO.lang.isUndefined(this.props.enabled))?"true":this.props.enabled;B.style.filter='progid:DXImageTransform.Microsoft.AlphaImageLoader(src="'+this.url+'", sizingMethod="'+C+'", enabled="'+A+'")';}else{B.style.backgroundImage="url('"+this.url+"')";}};YAHOO.register("imageloader",YAHOO.util.ImageLoader,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/json/json-min.js b/js/yui/json/json-min.js
new file mode 100644 (file)
index 0000000..3130a24
--- /dev/null
+++ b/js/yui/json/json-min.js
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){var l=YAHOO.lang,isFunction=l.isFunction,isObject=l.isObject,isArray=l.isArray,_toStr=Object.prototype.toString,Native=(YAHOO.env.ua.caja?window:this).JSON,_UNICODE_EXCEPTIONS=/[\u0000\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,_ESCAPES=/\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g,_VALUES=/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g,_BRACKETS=/(?:^|:|,)(?:\s*\[)+/g,_UNSAFE=/[^\],:{}\s]/,_SPECIAL_CHARS=/[\\\"\x00-\x1f\x7f-\x9f\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,_CHARS={"\b":"\\b","\t":"\\t","\n":"\\n","\f":"\\f","\r":"\\r",'"':'\\"',"\\":"\\\\"},UNDEFINED="undefined",OBJECT="object",NULL="null",STRING="string",NUMBER="number",BOOLEAN="boolean",DATE="date",_allowable={"undefined":UNDEFINED,"string":STRING,"[object String]":STRING,"number":NUMBER,"[object Number]":NUMBER,"boolean":BOOLEAN,"[object Boolean]":BOOLEAN,"[object Date]":DATE,"[object RegExp]":OBJECT},EMPTY="",OPEN_O="{",CLOSE_O="}",OPEN_A="[",CLOSE_A="]",COMMA=",",COMMA_CR=",\n",CR="\n",COLON=":",COLON_SP=": ",QUOTE='"';Native=_toStr.call(Native)==="[object JSON]"&&Native;function _char(c){if(!_CHARS[c]){_CHARS[c]="\\u"+("0000"+(+(c.charCodeAt(0))).toString(16)).slice(-4);}return _CHARS[c];}function _revive(data,reviver){var walk=function(o,key){var k,v,value=o[key];if(value&&typeof value==="object"){for(k in value){if(l.hasOwnProperty(value,k)){v=walk(value,k);if(v===undefined){delete value[k];}else{value[k]=v;}}}}return reviver.call(o,key,value);};return typeof reviver==="function"?walk({"":data},""):data;}function _prepare(s){return s.replace(_UNICODE_EXCEPTIONS,_char);}function _isSafe(str){return l.isString(str)&&!_UNSAFE.test(str.replace(_ESCAPES,"@").replace(_VALUES,"]").replace(_BRACKETS,""));}function _parse(s,reviver){s=_prepare(s);if(_isSafe(s)){return _revive(eval("("+s+")"),reviver);}throw new SyntaxError("JSON.parse");}function _type(o){var t=typeof o;return _allowable[t]||_allowable[_toStr.call(o)]||(t===OBJECT?(o?OBJECT:NULL):UNDEFINED);}function _string(s){return QUOTE+s.replace(_SPECIAL_CHARS,_char)+QUOTE;}function _indent(s,space){return s.replace(/^/gm,space);}function _stringify(o,w,space){if(o===undefined){return undefined;}var replacer=isFunction(w)?w:null,format=_toStr.call(space).match(/String|Number/)||[],_date=YAHOO.lang.JSON.dateToString,stack=[],tmp,i,len;if(replacer||!isArray(w)){w=undefined;}if(w){tmp={};for(i=0,len=w.length;i<len;++i){tmp[w[i]]=true;}w=tmp;}space=format[0]==="Number"?new Array(Math.min(Math.max(0,space),10)+1).join(" "):(space||EMPTY).slice(0,10);function _serialize(h,key){var value=h[key],t=_type(value),a=[],colon=space?COLON_SP:COLON,arr,i,keys,k,v;if(isObject(value)&&isFunction(value.toJSON)){value=value.toJSON(key);}else{if(t===DATE){value=_date(value);}}if(isFunction(replacer)){value=replacer.call(h,key,value);}if(value!==h[key]){t=_type(value);}switch(t){case DATE:case OBJECT:break;case STRING:return _string(value);case NUMBER:return isFinite(value)?value+EMPTY:NULL;case BOOLEAN:return value+EMPTY;case NULL:return NULL;default:return undefined;}for(i=stack.length-1;i>=0;--i){if(stack[i]===value){throw new Error("JSON.stringify. Cyclical reference");}}arr=isArray(value);stack.push(value);if(arr){for(i=value.length-1;i>=0;--i){a[i]=_serialize(value,i)||NULL;}}else{keys=w||value;i=0;for(k in keys){if(l.hasOwnProperty(keys,k)){v=_serialize(value,k);if(v){a[i++]=_string(k)+colon+v;}}}}stack.pop();if(space&&a.length){return arr?OPEN_A+CR+_indent(a.join(COMMA_CR),space)+CR+CLOSE_A:OPEN_O+CR+_indent(a.join(COMMA_CR),space)+CR+CLOSE_O;}else{return arr?OPEN_A+a.join(COMMA)+CLOSE_A:OPEN_O+a.join(COMMA)+CLOSE_O;}}return _serialize({"":o},"");}YAHOO.lang.JSON={useNativeParse:!!Native,useNativeStringify:!!Native,isSafe:function(s){return _isSafe(_prepare(s));},parse:function(s,reviver){if(typeof s!=="string"){s+="";}return Native&&YAHOO.lang.JSON.useNativeParse?Native.parse(s,reviver):_parse(s,reviver);},stringify:function(o,w,space){return Native&&YAHOO.lang.JSON.useNativeStringify?Native.stringify(o,w,space):_stringify(o,w,space);},dateToString:function(d){function _zeroPad(v){return v<10?"0"+v:v;}return d.getUTCFullYear()+"-"+_zeroPad(d.getUTCMonth()+1)+"-"+_zeroPad(d.getUTCDate())+"T"+_zeroPad(d.getUTCHours())+COLON+_zeroPad(d.getUTCMinutes())+COLON+_zeroPad(d.getUTCSeconds())+"Z";},stringToDate:function(str){var m=str.match(/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.(\d{3}))?Z$/);if(m){var d=new Date();d.setUTCFullYear(m[1],m[2]-1,m[3]);d.setUTCHours(m[4],m[5],m[6],(m[7]||0));return d;}return str;}};YAHOO.lang.JSON.isValid=YAHOO.lang.JSON.isSafe;})();YAHOO.register("json",YAHOO.lang.JSON,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/layout/layout-min.js b/js/yui/layout/layout-min.js
new file mode 100644 (file)
index 0000000..8714716
--- /dev/null
+++ b/js/yui/layout/layout-min.js
@@ -0,0 +1,11 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){var C=YAHOO.util.Dom,A=YAHOO.util.Event,D=YAHOO.lang;var B=function(F,E){if(D.isObject(F)&&!F.tagName){E=F;F=null;}if(D.isString(F)){if(C.get(F)){F=C.get(F);}}if(!F){F=document.body;}var G={element:F,attributes:E||{}};B.superclass.constructor.call(this,G.element,G.attributes);};B._instances={};B.getLayoutById=function(E){if(B._instances[E]){return B._instances[E];}return false;};YAHOO.extend(B,YAHOO.util.Element,{browser:function(){var E=YAHOO.env.ua;E.standardsMode=false;E.secure=false;return E;}(),_units:null,_rendered:null,_zIndex:null,_sizes:null,_setBodySize:function(G){var F=0,E=0;G=((G===false)?false:true);if(this._isBody){F=C.getClientHeight();E=C.getClientWidth();}else{F=parseInt(this.getStyle("height"),10);E=parseInt(this.getStyle("width"),10);if(isNaN(E)){E=this.get("element").clientWidth;}if(isNaN(F)){F=this.get("element").clientHeight;}}if(this.get("minWidth")){if(E<this.get("minWidth")){E=this.get("minWidth");}}if(this.get("minHeight")){if(F<this.get("minHeight")){F=this.get("minHeight");}}if(G){if(F<0){F=0;}if(E<0){E=0;}C.setStyle(this._doc,"height",F+"px");C.setStyle(this._doc,"width",E+"px");}this._sizes.doc={h:F,w:E};this._setSides(G);},_setSides:function(J){var H=((this._units.top)?this._units.top.get("height"):0),G=((this._units.bottom)?this._units.bottom.get("height"):0),I=this._sizes.doc.h,E=this._sizes.doc.w;J=((J===false)?false:true);this._sizes.top={h:H,w:((this._units.top)?E:0),t:0};this._sizes.bottom={h:G,w:((this._units.bottom)?E:0)};var F=(I-(H+G));this._sizes.left={h:F,w:((this._units.left)?this._units.left.get("width"):0)};this._sizes.right={h:F,w:((this._units.right)?this._units.right.get("width"):0),l:((this._units.right)?(E-this._units.right.get("width")):0),t:((this._units.top)?this._sizes.top.h:0)};if(this._units.right&&J){this._units.right.set("top",this._sizes.right.t);if(!this._units.right._collapsing){this._units.right.set("left",this._sizes.right.l);}this._units.right.set("height",this._sizes.right.h,true);}if(this._units.left){this._sizes.left.l=0;if(this._units.top){this._sizes.left.t=this._sizes.top.h;}else{this._sizes.left.t=0;}if(J){this._units.left.set("top",this._sizes.left.t);this._units.left.set("height",this._sizes.left.h,true);this._units.left.set("left",0);}}if(this._units.bottom){this._sizes.bottom.t=this._sizes.top.h+this._sizes.left.h;if(J){this._units.bottom.set("top",this._sizes.bottom.t);this._units.bottom.set("width",this._sizes.bottom.w,true);}}if(this._units.top){if(J){this._units.top.set("width",this._sizes.top.w,true);}}this._setCenter(J);},_setCenter:function(G){G=((G===false)?false:true);var F=this._sizes.left.h;var E=(this._sizes.doc.w-(this._sizes.left.w+this._sizes.right.w));if(G){this._units.center.set("height",F,true);this._units.center.set("width",E,true);this._units.center.set("top",this._sizes.top.h);this._units.center.set("left",this._sizes.left.w);}this._sizes.center={h:F,w:E,t:this._sizes.top.h,l:this._sizes.left.w};},getSizes:function(){return this._sizes;},getUnitById:function(E){return YAHOO.widget.LayoutUnit.getLayoutUnitById(E);},getUnitByPosition:function(E){if(E){E=E.toLowerCase();if(this._units[E]){return this._units[E];}return false;}return false;},removeUnit:function(E){delete this._units[E.get("position")];this.resize();},addUnit:function(G){if(!G.position){return false;}if(this._units[G.position]){return false;}var H=null,J=null;if(G.id){if(C.get(G.id)){H=C.get(G.id);delete G.id;}}if(G.element){H=G.element;}if(!J){J=document.createElement("div");var L=C.generateId();J.id=L;}if(!H){H=document.createElement("div");}C.addClass(H,"yui-layout-wrap");if(this.browser.ie&&!this.browser.standardsMode){J.style.zoom=1;H.style.zoom=1;}if(J.firstChild){J.insertBefore(H,J.firstChild);}else{J.appendChild(H);}this._doc.appendChild(J);var I=false,F=false;if(G.height){I=parseInt(G.height,10);}if(G.width){F=parseInt(G.width,10);}var E={};YAHOO.lang.augmentObject(E,G);E.parent=this;E.wrap=H;E.height=I;E.width=F;var K=new YAHOO.widget.LayoutUnit(J,E);K.on("heightChange",this.resize,{unit:K},this);K.on("widthChange",this.resize,{unit:K},this);K.on("gutterChange",this.resize,{unit:K},this);this._units[G.position]=K;if(this._rendered){this.resize();}return K;},_createUnits:function(){var E=this.get("units");for(var F in E){if(D.hasOwnProperty(E,F)){this.addUnit(E[F]);}}},resize:function(H,G){var E=H;if(E&&E.prevValue&&E.newValue){if(E.prevValue==E.newValue){if(G){if(G.unit){if(!G.unit.get("animate")){H=false;}}}}}H=((H===false)?false:true);if(H){var F=this.fireEvent("beforeResize");if(F===false){H=false;}if(this.browser.ie){if(this._isBody){C.removeClass(document.documentElement,"yui-layout");C.addClass(document.documentElement,"yui-layout");}else{this.removeClass("yui-layout");this.addClass("yui-layout");}}}this._setBodySize(H);if(H){this.fireEvent("resize",{target:this,sizes:this._sizes,event:E});}return this;},_setupBodyElements:function(){this._doc=C.get("layout-doc");if(!this._doc){this._doc=document.createElement("div");this._doc.id="layout-doc";if(document.body.firstChild){document.body.insertBefore(this._doc,document.body.firstChild);}else{document.body.appendChild(this._doc);}}this._createUnits();this._setBodySize();A.on(window,"resize",this.resize,this,true);C.addClass(this._doc,"yui-layout-doc");},_setupElements:function(){this._doc=this.getElementsByClassName("yui-layout-doc")[0];if(!this._doc){this._doc=document.createElement("div");this.get("element").appendChild(this._doc);}this._createUnits();this._setBodySize();C.addClass(this._doc,"yui-layout-doc");},_isBody:null,_doc:null,init:function(F,E){this._zIndex=0;B.superclass.init.call(this,F,E);if(this.get("parent")){this._zIndex=this.get("parent")._zIndex+10;}this._sizes={};this._units={};var G=F;if(!D.isString(G)){G=C.generateId(G);}B._instances[G]=this;},render:function(){this._stamp();var E=this.get("element");if(E&&E.tagName&&(E.tagName.toLowerCase()=="body")){this._isBody=true;C.addClass(document.body,"yui-layout");if(C.hasClass(document.body,"yui-skin-sam")){C.addClass(document.documentElement,"yui-skin-sam");
+C.removeClass(document.body,"yui-skin-sam");}this._setupBodyElements();}else{this._isBody=false;this.addClass("yui-layout");this._setupElements();}this.resize();this._rendered=true;this.fireEvent("render");return this;},_stamp:function(){if(document.compatMode=="CSS1Compat"){this.browser.standardsMode=true;}if(window.location.href.toLowerCase().indexOf("https")===0){C.addClass(document.documentElement,"secure");this.browser.secure=true;}},initAttributes:function(E){B.superclass.initAttributes.call(this,E);this.setAttributeConfig("units",{writeOnce:true,validator:YAHOO.lang.isArray,value:E.units||[]});this.setAttributeConfig("minHeight",{value:E.minHeight||false,validator:YAHOO.lang.isNumber});this.setAttributeConfig("minWidth",{value:E.minWidth||false,validator:YAHOO.lang.isNumber});this.setAttributeConfig("height",{value:E.height||false,validator:YAHOO.lang.isNumber,method:function(F){if(F<0){F=0;}this.setStyle("height",F+"px");}});this.setAttributeConfig("width",{value:E.width||false,validator:YAHOO.lang.isNumber,method:function(F){if(F<0){F=0;}this.setStyle("width",F+"px");}});this.setAttributeConfig("parent",{writeOnce:true,value:E.parent||false,method:function(F){if(F){F.on("resize",this.resize,this,true);}}});},destroy:function(){var G=this.get("parent");if(G){G.removeListener("resize",this.resize,this,true);}A.removeListener(window,"resize",this.resize,this,true);this.unsubscribeAll();for(var E in this._units){if(D.hasOwnProperty(this._units,E)){if(this._units[E]){this._units[E].destroy(true);}}}A.purgeElement(this.get("element"),true);this.get("parentNode").removeChild(this.get("element"));delete YAHOO.widget.Layout._instances[this.get("id")];for(var F in this){if(D.hasOwnProperty(this,F)){this[F]=null;delete this[F];}}if(G){G.resize();}},toString:function(){if(this.get){return"Layout #"+this.get("id");}return"Layout";}});YAHOO.widget.Layout=B;})();(function(){var D=YAHOO.util.Dom,C=YAHOO.util.Selector,A=YAHOO.util.Event,E=YAHOO.lang;var B=function(G,F){var H={element:G,attributes:F||{}};B.superclass.constructor.call(this,H.element,H.attributes);};B._instances={};B.getLayoutUnitById=function(F){if(B._instances[F]){return B._instances[F];}return false;};YAHOO.extend(B,YAHOO.util.Element,{STR_CLOSE:"Click to close this pane.",STR_COLLAPSE:"Click to collapse this pane.",STR_EXPAND:"Click to expand this pane.",LOADING_CLASSNAME:"loading",browser:null,_sizes:null,_anim:null,_resize:null,_clip:null,_gutter:null,header:null,body:null,footer:null,_collapsed:null,_collapsing:null,_lastWidth:null,_lastHeight:null,_lastTop:null,_lastLeft:null,_lastScroll:null,_lastCenterScroll:null,_lastScrollTop:null,resize:function(F){var G=this.fireEvent("beforeResize");if(G===false){return this;}if(!this._collapsing||(F===true)){var N=this.get("scroll");this.set("scroll",false);var K=this._getBoxSize(this.header),J=this._getBoxSize(this.footer),L=[this.get("height"),this.get("width")];var H=(L[0]-K[0]-J[0])-(this._gutter.top+this._gutter.bottom),M=L[1]-(this._gutter.left+this._gutter.right);var O=(H+(K[0]+J[0])),I=M;if(this._collapsed&&!this._collapsing){this._setHeight(this._clip,O);this._setWidth(this._clip,I);D.setStyle(this._clip,"top",this.get("top")+this._gutter.top+"px");D.setStyle(this._clip,"left",this.get("left")+this._gutter.left+"px");}else{if(!this._collapsed||(this._collapsed&&this._collapsing)){O=this._setHeight(this.get("wrap"),O);I=this._setWidth(this.get("wrap"),I);this._sizes.wrap.h=O;this._sizes.wrap.w=I;D.setStyle(this.get("wrap"),"top",this._gutter.top+"px");D.setStyle(this.get("wrap"),"left",this._gutter.left+"px");this._sizes.header.w=this._setWidth(this.header,I);this._sizes.header.h=K[0];this._sizes.footer.w=this._setWidth(this.footer,I);this._sizes.footer.h=J[0];D.setStyle(this.footer,"bottom","0px");this._sizes.body.h=this._setHeight(this.body,(O-(K[0]+J[0])));this._sizes.body.w=this._setWidth(this.body,I);D.setStyle(this.body,"top",K[0]+"px");this.set("scroll",N);this.fireEvent("resize");}}}return this;},_setWidth:function(H,G){if(H){var F=this._getBorderSizes(H);G=(G-(F[1]+F[3]));G=this._fixQuirks(H,G,"w");if(G<0){G=0;}D.setStyle(H,"width",G+"px");}return G;},_setHeight:function(H,G){if(H){var F=this._getBorderSizes(H);G=(G-(F[0]+F[2]));G=this._fixQuirks(H,G,"h");if(G<0){G=0;}D.setStyle(H,"height",G+"px");}return G;},_fixQuirks:function(I,L,G){var K=0,H=2;if(G=="w"){K=1;H=3;}if((this.browser.ie<8)&&!this.browser.standardsMode){var F=this._getBorderSizes(I),J=this._getBorderSizes(I.parentNode);if((F[K]===0)&&(F[H]===0)){if((J[K]!==0)&&(J[H]!==0)){L=(L-(J[K]+J[H]));}}else{if((J[K]===0)&&(J[H]===0)){L=(L+(F[K]+F[H]));}}}return L;},_getBoxSize:function(H){var G=[0,0];if(H){if(this.browser.ie&&!this.browser.standardsMode){H.style.zoom=1;}var F=this._getBorderSizes(H);G[0]=H.clientHeight+(F[0]+F[2]);G[1]=H.clientWidth+(F[1]+F[3]);}return G;},_getBorderSizes:function(H){var G=[];H=H||this.get("element");if(this.browser.ie&&!this.browser.standardsMode){H.style.zoom=1;}G[0]=parseInt(D.getStyle(H,"borderTopWidth"),10);G[1]=parseInt(D.getStyle(H,"borderRightWidth"),10);G[2]=parseInt(D.getStyle(H,"borderBottomWidth"),10);G[3]=parseInt(D.getStyle(H,"borderLeftWidth"),10);for(var F=0;F<G.length;F++){if(isNaN(G[F])){G[F]=0;}}return G;},_createClip:function(){if(!this._clip){this._clip=document.createElement("div");this._clip.className="yui-layout-clip yui-layout-clip-"+this.get("position");this._clip.innerHTML='<div class="collapse"></div>';var F=this._clip.firstChild;F.title=this.STR_EXPAND;A.on(F,"click",this.expand,this,true);this.get("element").parentNode.appendChild(this._clip);}},_toggleClip:function(){if(!this._collapsed){var J=this._getBoxSize(this.header),K=this._getBoxSize(this.footer),I=[this.get("height"),this.get("width")];var H=(I[0]-J[0]-K[0])-(this._gutter.top+this._gutter.bottom),F=I[1]-(this._gutter.left+this._gutter.right),G=(H+(J[0]+K[0]));switch(this.get("position")){case"top":case"bottom":this._setWidth(this._clip,F);this._setHeight(this._clip,this.get("collapseSize"));
+D.setStyle(this._clip,"left",(this._lastLeft+this._gutter.left)+"px");if(this.get("position")=="bottom"){D.setStyle(this._clip,"top",((this._lastTop+this._lastHeight)-(this.get("collapseSize")-this._gutter.top))+"px");}else{D.setStyle(this._clip,"top",this.get("top")+this._gutter.top+"px");}break;case"left":case"right":this._setWidth(this._clip,this.get("collapseSize"));this._setHeight(this._clip,G);D.setStyle(this._clip,"top",(this.get("top")+this._gutter.top)+"px");if(this.get("position")=="right"){D.setStyle(this._clip,"left",(((this._lastLeft+this._lastWidth)-this.get("collapseSize"))-this._gutter.left)+"px");}else{D.setStyle(this._clip,"left",(this.get("left")+this._gutter.left)+"px");}break;}D.setStyle(this._clip,"display","block");this.setStyle("display","none");}else{D.setStyle(this._clip,"display","none");}},getSizes:function(){return this._sizes;},toggle:function(){if(this._collapsed){this.expand();}else{this.collapse();}return this;},expand:function(){if(!this._collapsed){return this;}var L=this.fireEvent("beforeExpand");if(L===false){return this;}this._collapsing=true;this.setStyle("zIndex",this._zIndex);if(this._anim){this.setStyle("display","none");var F={},H;switch(this.get("position")){case"left":case"right":this.set("width",this._lastWidth,true);this.setStyle("width",this._lastWidth+"px");this.get("parent").resize(false);H=this.get("parent").getSizes()[this.get("position")];this.set("height",H.h,true);var K=H.l;F={left:{to:K}};if(this.get("position")=="left"){F.left.from=(K-H.w);this.setStyle("left",(K-H.w)+"px");}break;case"top":case"bottom":this.set("height",this._lastHeight,true);this.setStyle("height",this._lastHeight+"px");this.get("parent").resize(false);H=this.get("parent").getSizes()[this.get("position")];this.set("width",H.w,true);var J=H.t;F={top:{to:J}};if(this.get("position")=="top"){this.setStyle("top",(J-H.h)+"px");F.top.from=(J-H.h);}break;}this._anim.attributes=F;var I=function(){this.setStyle("display","block");this.resize(true);this._anim.onStart.unsubscribe(I,this,true);};var G=function(){this._collapsing=false;this.setStyle("zIndex",this._zIndex);this.set("width",this._lastWidth);this.set("height",this._lastHeight);this._collapsed=false;this.resize();this.set("scroll",this._lastScroll);if(this._lastScrollTop>0){this.body.scrollTop=this._lastScrollTop;}this._anim.onComplete.unsubscribe(G,this,true);this.fireEvent("expand");};this._anim.onStart.subscribe(I,this,true);this._anim.onComplete.subscribe(G,this,true);this._anim.animate();this._toggleClip();}else{this._collapsing=false;this._toggleClip();this._collapsed=false;this._zIndex=this.getStyle("zIndex");this.setStyle("zIndex",this.get("parent")._zIndex);this.setStyle("display","block");this.set("width",this._lastWidth);this.set("height",this._lastHeight);this.resize();this.set("scroll",this._lastScroll);if(this._lastScrollTop>0){this.body.scrollTop=this._lastScrollTop;}this.fireEvent("expand");}return this;},collapse:function(){if(this._collapsed){return this;}var J=this.fireEvent("beforeCollapse");if(J===false){return this;}if(!this._clip){this._createClip();}this._collapsing=true;var G=this.get("width"),H=this.get("height"),F={};this._lastWidth=G;this._lastHeight=H;this._lastScroll=this.get("scroll");this._lastScrollTop=this.body.scrollTop;this.set("scroll",false,true);this._lastLeft=parseInt(this.get("element").style.left,10);this._lastTop=parseInt(this.get("element").style.top,10);if(isNaN(this._lastTop)){this._lastTop=0;this.set("top",0);}if(isNaN(this._lastLeft)){this._lastLeft=0;this.set("left",0);}this._zIndex=this.getStyle("zIndex");this.setStyle("zIndex",this.get("parent")._zIndex+1);var K=this.get("position");switch(K){case"top":case"bottom":this.set("height",(this.get("collapseSize")+(this._gutter.top+this._gutter.bottom)));F={top:{to:(this.get("top")-H)}};if(K=="bottom"){F.top.to=(this.get("top")+H);}break;case"left":case"right":this.set("width",(this.get("collapseSize")+(this._gutter.left+this._gutter.right)));F={left:{to:-(this._lastWidth)}};if(K=="right"){F.left={to:(this.get("left")+G)};}break;}if(this._anim){this._anim.attributes=F;var I=function(){this._collapsing=false;this._toggleClip();this.setStyle("zIndex",this.get("parent")._zIndex);this._collapsed=true;this.get("parent").resize();this._anim.onComplete.unsubscribe(I,this,true);this.fireEvent("collapse");};this._anim.onComplete.subscribe(I,this,true);this._anim.animate();}else{this._collapsing=false;this.setStyle("display","none");this._toggleClip();this.setStyle("zIndex",this.get("parent")._zIndex);this.get("parent").resize();this._collapsed=true;this.fireEvent("collapse");}return this;},close:function(){this.setStyle("display","none");this.get("parent").removeUnit(this);this.fireEvent("close");if(this._clip){this._clip.parentNode.removeChild(this._clip);this._clip=null;}return this.get("parent");},loadHandler:{success:function(F){this.body.innerHTML=F.responseText;this.resize(true);},failure:function(F){}},dataConnection:null,_loading:false,loadContent:function(){if(YAHOO.util.Connect&&this.get("dataSrc")&&!this._loading&&!this.get("dataLoaded")){this._loading=true;D.addClass(this.body,this.LOADING_CLASSNAME);this.dataConnection=YAHOO.util.Connect.asyncRequest(this.get("loadMethod"),this.get("dataSrc"),{success:function(F){this.loadHandler.success.call(this,F);this.set("dataLoaded",true);this.dataConnection=null;D.removeClass(this.body,this.LOADING_CLASSNAME);this._loading=false;this.fireEvent("load");},failure:function(F){this.loadHandler.failure.call(this,F);this.dataConnection=null;D.removeClass(this.body,this.LOADING_CLASSNAME);this._loading=false;this.fireEvent("loadError",{error:F});},scope:this,timeout:this.get("dataTimeout")});return this.dataConnection;}return false;},init:function(H,G){this._gutter={left:0,right:0,top:0,bottom:0};this._sizes={wrap:{h:0,w:0},header:{h:0,w:0},body:{h:0,w:0},footer:{h:0,w:0}};B.superclass.init.call(this,H,G);this.browser=this.get("parent").browser;var K=H;if(!E.isString(K)){K=D.generateId(K);
+}B._instances[K]=this;this.setStyle("position","absolute");this.addClass("yui-layout-unit");this.addClass("yui-layout-unit-"+this.get("position"));var J=this.getElementsByClassName("yui-layout-hd","div")[0];if(J){this.header=J;}var F=this.getElementsByClassName("yui-layout-bd","div")[0];if(F){this.body=F;}var I=this.getElementsByClassName("yui-layout-ft","div")[0];if(I){this.footer=I;}this.on("contentChange",this.resize,this,true);this._lastScrollTop=0;this.set("animate",this.get("animate"));},initAttributes:function(F){B.superclass.initAttributes.call(this,F);this.setAttributeConfig("wrap",{value:F.wrap||null,method:function(G){if(G){var H=D.generateId(G);B._instances[H]=this;}}});this.setAttributeConfig("grids",{value:F.grids||false});this.setAttributeConfig("top",{value:F.top||0,validator:E.isNumber,method:function(G){if(!this._collapsing){this.setStyle("top",G+"px");}}});this.setAttributeConfig("left",{value:F.left||0,validator:E.isNumber,method:function(G){if(!this._collapsing){this.setStyle("left",G+"px");}}});this.setAttributeConfig("minWidth",{value:F.minWidth||false,method:function(G){if(this._resize){this._resize.set("minWidth",G);}},validator:YAHOO.lang.isNumber});this.setAttributeConfig("maxWidth",{value:F.maxWidth||false,method:function(G){if(this._resize){this._resize.set("maxWidth",G);}},validator:YAHOO.lang.isNumber});this.setAttributeConfig("minHeight",{value:F.minHeight||false,method:function(G){if(this._resize){this._resize.set("minHeight",G);}},validator:YAHOO.lang.isNumber});this.setAttributeConfig("maxHeight",{value:F.maxHeight||false,method:function(G){if(this._resize){this._resize.set("maxHeight",G);}},validator:YAHOO.lang.isNumber});this.setAttributeConfig("height",{value:F.height,validator:E.isNumber,method:function(G){if(!this._collapsing){if(G<0){G=0;}this.setStyle("height",G+"px");}}});this.setAttributeConfig("width",{value:F.width,validator:E.isNumber,method:function(G){if(!this._collapsing){if(G<0){G=0;}this.setStyle("width",G+"px");}}});this.setAttributeConfig("zIndex",{value:F.zIndex||false,method:function(G){this.setStyle("zIndex",G);}});this.setAttributeConfig("position",{value:F.position});this.setAttributeConfig("gutter",{value:F.gutter||0,validator:YAHOO.lang.isString,method:function(H){var G=H.split(" ");if(G.length){this._gutter.top=parseInt(G[0],10);if(G[1]){this._gutter.right=parseInt(G[1],10);}else{this._gutter.right=this._gutter.top;}if(G[2]){this._gutter.bottom=parseInt(G[2],10);}else{this._gutter.bottom=this._gutter.top;}if(G[3]){this._gutter.left=parseInt(G[3],10);}else{if(G[1]){this._gutter.left=this._gutter.right;}else{this._gutter.left=this._gutter.top;}}}}});this.setAttributeConfig("parent",{writeOnce:true,value:F.parent||false,method:function(G){if(G){G.on("resize",this.resize,this,true);}}});this.setAttributeConfig("collapseSize",{value:F.collapseSize||25,validator:YAHOO.lang.isNumber});this.setAttributeConfig("duration",{value:F.duration||0.5});this.setAttributeConfig("easing",{value:F.easing||((YAHOO.util&&YAHOO.util.Easing)?YAHOO.util.Easing.BounceIn:"false")});this.setAttributeConfig("animate",{value:((F.animate===false)?false:true),validator:function(){var G=false;if(YAHOO.util.Anim){G=true;}return G;},method:function(G){if(G){this._anim=new YAHOO.util.Anim(this.get("element"),{},this.get("duration"),this.get("easing"));}else{this._anim=false;}}});this.setAttributeConfig("header",{value:F.header||false,method:function(G){if(G===false){if(this.header){D.addClass(this.body,"yui-layout-bd-nohd");this.header.parentNode.removeChild(this.header);this.header=null;}}else{if(!this.header){var I=this.getElementsByClassName("yui-layout-hd","div")[0];if(!I){I=this._createHeader();}this.header=I;}var H=this.header.getElementsByTagName("h2")[0];if(!H){H=document.createElement("h2");this.header.appendChild(H);}H.innerHTML=G;if(this.body){D.removeClass(this.body,"yui-layout-bd-nohd");}}this.fireEvent("contentChange",{target:"header"});}});this.setAttributeConfig("proxy",{writeOnce:true,value:((F.proxy===false)?false:true)});this.setAttributeConfig("body",{value:F.body||false,method:function(I){if(!this.body){var G=this.getElementsByClassName("yui-layout-bd","div")[0];if(G){this.body=G;}else{G=document.createElement("div");G.className="yui-layout-bd";this.body=G;this.get("wrap").appendChild(G);}}if(!this.header){D.addClass(this.body,"yui-layout-bd-nohd");}D.addClass(this.body,"yui-layout-bd-noft");var H=null;if(E.isString(I)){H=D.get(I);}else{if(I&&I.tagName){H=I;}}if(H){var J=D.generateId(H);B._instances[J]=this;this.body.appendChild(H);}else{this.body.innerHTML=I;}this._cleanGrids();this.fireEvent("contentChange",{target:"body"});}});this.setAttributeConfig("footer",{value:F.footer||false,method:function(H){if(H===false){if(this.footer){D.addClass(this.body,"yui-layout-bd-noft");this.footer.parentNode.removeChild(this.footer);this.footer=null;}}else{if(!this.footer){var I=this.getElementsByClassName("yui-layout-ft","div")[0];if(!I){I=document.createElement("div");I.className="yui-layout-ft";this.footer=I;this.get("wrap").appendChild(I);}else{this.footer=I;}}var G=null;if(E.isString(H)){G=D.get(H);}else{if(H&&H.tagName){G=H;}}if(G){this.footer.appendChild(G);}else{this.footer.innerHTML=H;}D.removeClass(this.body,"yui-layout-bd-noft");}this.fireEvent("contentChange",{target:"footer"});}});this.setAttributeConfig("close",{value:F.close||false,method:function(G){if(this.get("position")=="center"){return false;}if(!this.header&&G){this._createHeader();}if(!this.header){return;}var H=this.header?D.getElementsByClassName("close","div",this.header)[0]:null;if(G){if(!this.get("header")){this.set("header","&nbsp;");}if(!H){H=document.createElement("div");H.className="close";this.header.appendChild(H);A.on(H,"click",this.close,this,true);}H.title=this.STR_CLOSE;}else{if(H&&H.parentNode){A.purgeElement(H);H.parentNode.removeChild(H);}}this._configs.close.value=G;this.set("collapse",this.get("collapse"));}});this.setAttributeConfig("collapse",{value:F.collapse||false,method:function(G){if(this.get("position")=="center"){return false;
+}if(!this.header&&G){this._createHeader();}if(!this.header){return;}var H=this.header?D.getElementsByClassName("collapse","div",this.header)[0]:null;if(G){if(!this.get("header")){this.set("header","&nbsp;");}if(!H){H=document.createElement("div");this.header.appendChild(H);A.on(H,"click",this.collapse,this,true);}H.title=this.STR_COLLAPSE;H.className="collapse"+((this.get("close"))?" collapse-close":"");}else{if(H&&H.parentNode){A.purgeElement(H);H.parentNode.removeChild(H);}}}});this.setAttributeConfig("scroll",{value:(((F.scroll===true)||(F.scroll===false)||(F.scroll===null))?F.scroll:false),method:function(G){if((G===false)&&!this._collapsed){if(this.body){if(this.body.scrollTop>0){this._lastScrollTop=this.body.scrollTop;}}}if(G===true){this.addClass("yui-layout-scroll");this.removeClass("yui-layout-noscroll");if(this._lastScrollTop>0){if(this.body){this.body.scrollTop=this._lastScrollTop;}}}else{if(G===false){this.removeClass("yui-layout-scroll");this.addClass("yui-layout-noscroll");}else{if(G===null){this.removeClass("yui-layout-scroll");this.removeClass("yui-layout-noscroll");}}}}});this.setAttributeConfig("hover",{writeOnce:true,value:F.hover||false,validator:YAHOO.lang.isBoolean});this.setAttributeConfig("useShim",{value:F.useShim||false,validator:YAHOO.lang.isBoolean,method:function(G){if(this._resize){this._resize.set("useShim",G);}}});this.setAttributeConfig("resize",{value:F.resize||false,validator:function(G){if(YAHOO.util&&YAHOO.util.Resize){return true;}return false;},method:function(G){if(G&&!this._resize){if(this.get("position")=="center"){return false;}var I=false;switch(this.get("position")){case"top":I="b";break;case"bottom":I="t";break;case"right":I="l";break;case"left":I="r";break;}this.setStyle("position","absolute");if(I){this._resize=new YAHOO.util.Resize(this.get("element"),{proxy:this.get("proxy"),hover:this.get("hover"),status:false,autoRatio:false,handles:[I],minWidth:this.get("minWidth"),maxWidth:this.get("maxWidth"),minHeight:this.get("minHeight"),maxHeight:this.get("maxHeight"),height:this.get("height"),width:this.get("width"),setSize:false,useShim:this.get("useShim"),wrap:false});this._resize._handles[I].innerHTML='<div class="yui-layout-resize-knob"></div>';if(this.get("proxy")){var H=this._resize.getProxyEl();H.innerHTML='<div class="yui-layout-handle-'+I+'"></div>';}this._resize.on("startResize",function(J){this._lastScroll=this.get("scroll");this.set("scroll",false);if(this.get("parent")){this.get("parent").fireEvent("startResize");var K=this.get("parent").getUnitByPosition("center");this._lastCenterScroll=K.get("scroll");K.addClass(this._resize.CSS_RESIZING);K.set("scroll",false);}this.fireEvent("startResize");},this,true);this._resize.on("resize",function(J){this.set("height",J.height);this.set("width",J.width);},this,true);this._resize.on("endResize",function(J){this.set("scroll",this._lastScroll);if(this.get("parent")){var K=this.get("parent").getUnitByPosition("center");K.set("scroll",this._lastCenterScroll);K.removeClass(this._resize.CSS_RESIZING);}this.resize();this.fireEvent("endResize");},this,true);}}else{if(this._resize){this._resize.destroy();}}}});this.setAttributeConfig("dataSrc",{value:F.dataSrc});this.setAttributeConfig("loadMethod",{value:F.loadMethod||"GET",validator:YAHOO.lang.isString});this.setAttributeConfig("dataLoaded",{value:false,validator:YAHOO.lang.isBoolean,writeOnce:true});this.setAttributeConfig("dataTimeout",{value:F.dataTimeout||null,validator:YAHOO.lang.isNumber});},_cleanGrids:function(){if(this.get("grids")){var F=C.query("div.yui-b",this.body,true);if(F){D.removeClass(F,"yui-b");}A.onAvailable("yui-main",function(){D.setStyle(C.query("#yui-main"),"margin-left","0");D.setStyle(C.query("#yui-main"),"margin-right","0");});}},_createHeader:function(){var F=document.createElement("div");F.className="yui-layout-hd";if(this.get("firstChild")){this.get("wrap").insertBefore(F,this.get("wrap").firstChild);}else{this.get("wrap").appendChild(F);}this.header=F;return F;},destroy:function(H){if(this._resize){this._resize.destroy();}var G=this.get("parent");this.setStyle("display","none");if(this._clip){this._clip.parentNode.removeChild(this._clip);this._clip=null;}if(!H){G.removeUnit(this);}if(G){G.removeListener("resize",this.resize,this,true);}this.unsubscribeAll();A.purgeElement(this.get("element"),true);this.get("parentNode").removeChild(this.get("element"));delete YAHOO.widget.LayoutUnit._instances[this.get("id")];for(var F in this){if(E.hasOwnProperty(this,F)){this[F]=null;delete this[F];}}return G;},toString:function(){if(this.get){return"LayoutUnit #"+this.get("id")+" ("+this.get("position")+")";}return"LayoutUnit";}});YAHOO.widget.LayoutUnit=B;})();YAHOO.register("layout",YAHOO.widget.Layout,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/logger/logger-min.js b/js/yui/logger/logger-min.js
new file mode 100644 (file)
index 0000000..8d43c3c
--- /dev/null
+++ b/js/yui/logger/logger-min.js
@@ -0,0 +1,9 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.widget.LogMsg=function(a){this.msg=this.time=this.category=this.source=this.sourceDetail=null;if(a&&(a.constructor==Object)){for(var b in a){if(a.hasOwnProperty(b)){this[b]=a[b];}}}};YAHOO.widget.LogWriter=function(a){if(!a){YAHOO.log("Could not instantiate LogWriter due to invalid source.","error","LogWriter");return;}this._source=a;};YAHOO.widget.LogWriter.prototype.toString=function(){return"LogWriter "+this._sSource;};YAHOO.widget.LogWriter.prototype.log=function(a,b){YAHOO.widget.Logger.log(a,b,this._source);};YAHOO.widget.LogWriter.prototype.getSource=function(){return this._source;};YAHOO.widget.LogWriter.prototype.setSource=function(a){if(!a){YAHOO.log("Could not set source due to invalid source.","error",this.toString());return;}else{this._source=a;}};YAHOO.widget.LogWriter.prototype._source=null;if(!YAHOO.widget.Logger){YAHOO.widget.Logger={loggerEnabled:true,_browserConsoleEnabled:false,categories:["info","warn","error","time","window"],sources:["global"],_stack:[],maxStackEntries:2500,_startTime:new Date().getTime(),_lastTime:null,_windowErrorsHandled:false,_origOnWindowError:null};YAHOO.widget.Logger.log=function(b,f,g){if(this.loggerEnabled){if(!f){f="info";}else{f=f.toLocaleLowerCase();if(this._isNewCategory(f)){this._createNewCategory(f);}}var c="global";var a=null;if(g){var d=g.indexOf(" ");if(d>0){c=g.substring(0,d);a=g.substring(d,g.length);}else{c=g;}if(this._isNewSource(c)){this._createNewSource(c);}}var h=new Date();var j=new YAHOO.widget.LogMsg({msg:b,time:h,category:f,source:c,sourceDetail:a});var i=this._stack;var e=this.maxStackEntries;if(e&&!isNaN(e)&&(i.length>=e)){i.shift();}i.push(j);this.newLogEvent.fire(j);if(this._browserConsoleEnabled){this._printToBrowserConsole(j);}return true;}else{return false;}};YAHOO.widget.Logger.reset=function(){this._stack=[];this._startTime=new Date().getTime();this.loggerEnabled=true;this.log("Logger reset");this.logResetEvent.fire();};YAHOO.widget.Logger.getStack=function(){return this._stack;};YAHOO.widget.Logger.getStartTime=function(){return this._startTime;};YAHOO.widget.Logger.disableBrowserConsole=function(){YAHOO.log("Logger output to the function console.log() has been disabled.");this._browserConsoleEnabled=false;};YAHOO.widget.Logger.enableBrowserConsole=function(){this._browserConsoleEnabled=true;YAHOO.log("Logger output to the function console.log() has been enabled.");};YAHOO.widget.Logger.handleWindowErrors=function(){if(!YAHOO.widget.Logger._windowErrorsHandled){if(window.error){YAHOO.widget.Logger._origOnWindowError=window.onerror;}window.onerror=YAHOO.widget.Logger._onWindowError;YAHOO.widget.Logger._windowErrorsHandled=true;YAHOO.log("Logger handling of window.onerror has been enabled.");}else{YAHOO.log("Logger handling of window.onerror had already been enabled.");}};YAHOO.widget.Logger.unhandleWindowErrors=function(){if(YAHOO.widget.Logger._windowErrorsHandled){if(YAHOO.widget.Logger._origOnWindowError){window.onerror=YAHOO.widget.Logger._origOnWindowError;YAHOO.widget.Logger._origOnWindowError=null;}else{window.onerror=null;}YAHOO.widget.Logger._windowErrorsHandled=false;YAHOO.log("Logger handling of window.onerror has been disabled.");}else{YAHOO.log("Logger handling of window.onerror had already been disabled.");}};YAHOO.widget.Logger.categoryCreateEvent=new YAHOO.util.CustomEvent("categoryCreate",this,true);YAHOO.widget.Logger.sourceCreateEvent=new YAHOO.util.CustomEvent("sourceCreate",this,true);YAHOO.widget.Logger.newLogEvent=new YAHOO.util.CustomEvent("newLog",this,true);YAHOO.widget.Logger.logResetEvent=new YAHOO.util.CustomEvent("logReset",this,true);YAHOO.widget.Logger._createNewCategory=function(a){this.categories.push(a);this.categoryCreateEvent.fire(a);};YAHOO.widget.Logger._isNewCategory=function(b){for(var a=0;a<this.categories.length;a++){if(b==this.categories[a]){return false;}}return true;};YAHOO.widget.Logger._createNewSource=function(a){this.sources.push(a);this.sourceCreateEvent.fire(a);};YAHOO.widget.Logger._isNewSource=function(a){if(a){for(var b=0;b<this.sources.length;b++){if(a==this.sources[b]){return false;}}return true;}};YAHOO.widget.Logger._printToBrowserConsole=function(c){if((window.console&&console.log)||(window.opera&&opera.postError)){var e=c.category;var d=c.category.substring(0,4).toUpperCase();var g=c.time;var f;if(g.toLocaleTimeString){f=g.toLocaleTimeString();}else{f=g.toString();}var h=g.getTime();var b=(YAHOO.widget.Logger._lastTime)?(h-YAHOO.widget.Logger._lastTime):0;YAHOO.widget.Logger._lastTime=h;var a=f+" ("+b+"ms): "+c.source+": ";if(window.console){console.log(a,c.msg);}else{opera.postError(a+c.msg);}}};YAHOO.widget.Logger._onWindowError=function(a,c,b){try{YAHOO.widget.Logger.log(a+" ("+c+", line "+b+")","window");if(YAHOO.widget.Logger._origOnWindowError){YAHOO.widget.Logger._origOnWindowError();}}catch(d){return false;}};YAHOO.widget.Logger.log("Logger initialized");}(function(){var c=YAHOO.widget.Logger,e=YAHOO.util,f=e.Dom,a=e.Event,h=document;function b(i,d){i=h.createElement(i);if(d){for(var j in d){if(d.hasOwnProperty(j)){i[j]=d[j];}}}return i;}function g(i,d){this._sName=g._index;g._index++;this._init.apply(this,arguments);if(this.autoRender!==false){this.render();}}YAHOO.lang.augmentObject(g,{_index:0,ENTRY_TEMPLATE:(function(){return b("pre",{className:"yui-log-entry"});})(),VERBOSE_TEMPLATE:"<p><span class='{category}'>{label}</span> {totalTime}ms (+{elapsedTime}) {localTime}:</p><p>{sourceAndDetail}</p><p>{message}</p>",BASIC_TEMPLATE:"<p><span class='{category}'>{label}</span> {totalTime}ms (+{elapsedTime}) {localTime}: {sourceAndDetail}: {message}</p>"});g.prototype={logReaderEnabled:true,width:null,height:null,top:null,left:null,right:null,bottom:null,fontSize:null,footerEnabled:true,verboseOutput:true,entryFormat:null,newestOnTop:true,outputBuffer:100,thresholdMax:500,thresholdMin:100,isCollapsed:false,isPaused:false,draggable:true,toString:function(){return"LogReader instance"+this._sName;},pause:function(){this.isPaused=true;this._timeout=null;
+this.logReaderEnabled=false;if(this._btnPause){this._btnPause.value="Resume";}},resume:function(){this.isPaused=false;this.logReaderEnabled=true;this._printBuffer();if(this._btnPause){this._btnPause.value="Pause";}},render:function(){if(this.rendered){return;}this._initContainerEl();this._initHeaderEl();this._initConsoleEl();this._initFooterEl();this._initCategories();this._initSources();this._initDragDrop();c.newLogEvent.subscribe(this._onNewLog,this);c.logResetEvent.subscribe(this._onReset,this);c.categoryCreateEvent.subscribe(this._onCategoryCreate,this);c.sourceCreateEvent.subscribe(this._onSourceCreate,this);this.rendered=true;this._filterLogs();},destroy:function(){a.purgeElement(this._elContainer,true);this._elContainer.innerHTML="";this._elContainer.parentNode.removeChild(this._elContainer);this.rendered=false;},hide:function(){this._elContainer.style.display="none";},show:function(){this._elContainer.style.display="block";},collapse:function(){this._elConsole.style.display="none";if(this._elFt){this._elFt.style.display="none";}this._btnCollapse.value="Expand";this.isCollapsed=true;},expand:function(){this._elConsole.style.display="block";if(this._elFt){this._elFt.style.display="block";}this._btnCollapse.value="Collapse";this.isCollapsed=false;},getCheckbox:function(d){return this._filterCheckboxes[d];},getCategories:function(){return this._categoryFilters;},showCategory:function(j){var l=this._categoryFilters;if(l.indexOf){if(l.indexOf(j)>-1){return;}}else{for(var d=0;d<l.length;d++){if(l[d]===j){return;}}}this._categoryFilters.push(j);this._filterLogs();var k=this.getCheckbox(j);if(k){k.checked=true;}},hideCategory:function(j){var l=this._categoryFilters;for(var d=0;d<l.length;d++){if(j==l[d]){l.splice(d,1);break;}}this._filterLogs();var k=this.getCheckbox(j);if(k){k.checked=false;}},getSources:function(){return this._sourceFilters;},showSource:function(d){var l=this._sourceFilters;if(l.indexOf){if(l.indexOf(d)>-1){return;}}else{for(var j=0;j<l.length;j++){if(d==l[j]){return;}}}l.push(d);this._filterLogs();var k=this.getCheckbox(d);if(k){k.checked=true;}},hideSource:function(d){var l=this._sourceFilters;for(var j=0;j<l.length;j++){if(d==l[j]){l.splice(j,1);break;}}this._filterLogs();var k=this.getCheckbox(d);if(k){k.checked=false;}},clearConsole:function(){this._timeout=null;this._buffer=[];this._consoleMsgCount=0;var d=this._elConsole;d.innerHTML="";},setTitle:function(d){this._title.innerHTML=this.html2Text(d);},getLastTime:function(){return this._lastTime;},formatMsg:function(i){var d=this.entryFormat||(this.verboseOutput?g.VERBOSE_TEMPLATE:g.BASIC_TEMPLATE),j={category:i.category,label:i.category.substring(0,4).toUpperCase(),sourceAndDetail:i.sourceDetail?i.source+" "+i.sourceDetail:i.source,message:this.html2Text(i.msg||i.message||"")};if(i.time&&i.time.getTime){j.localTime=i.time.toLocaleTimeString?i.time.toLocaleTimeString():i.time.toString();j.elapsedTime=i.time.getTime()-this.getLastTime();j.totalTime=i.time.getTime()-c.getStartTime();}var k=g.ENTRY_TEMPLATE.cloneNode(true);if(this.verboseOutput){k.className+=" yui-log-verbose";}k.innerHTML=d.replace(/\{(\w+)\}/g,function(l,m){return(m in j)?j[m]:"";});return k;},html2Text:function(d){if(d){d+="";return d.replace(/&/g,"&#38;").replace(/</g,"&#60;").replace(/>/g,"&#62;");}return"";},_sName:null,_buffer:null,_consoleMsgCount:0,_lastTime:null,_timeout:null,_filterCheckboxes:null,_categoryFilters:null,_sourceFilters:null,_elContainer:null,_elHd:null,_elCollapse:null,_btnCollapse:null,_title:null,_elConsole:null,_elFt:null,_elBtns:null,_elCategoryFilters:null,_elSourceFilters:null,_btnPause:null,_btnClear:null,_init:function(d,i){this._buffer=[];this._filterCheckboxes={};this._lastTime=c.getStartTime();if(i&&(i.constructor==Object)){for(var j in i){if(i.hasOwnProperty(j)){this[j]=i[j];}}}this._elContainer=f.get(d);YAHOO.log("LogReader initialized",null,this.toString());},_initContainerEl:function(){if(!this._elContainer||!/div$/i.test(this._elContainer.tagName)){this._elContainer=h.body.insertBefore(b("div"),h.body.firstChild);f.addClass(this._elContainer,"yui-log-container");}f.addClass(this._elContainer,"yui-log");var k=this._elContainer.style,d=["width","right","top","fontSize"],l,j;for(j=d.length-1;j>=0;--j){l=d[j];if(this[l]){k[l]=this[l];}}if(this.left){k.left=this.left;k.right="auto";}if(this.bottom){k.bottom=this.bottom;k.top="auto";}if(YAHOO.env.ua.opera){h.body.style+="";}},_initHeaderEl:function(){if(this._elHd){a.purgeElement(this._elHd,true);this._elHd.innerHTML="";}this._elHd=b("div",{className:"yui-log-hd"});f.generateId(this._elHd,"yui-log-hd"+this._sName);this._elCollapse=b("div",{className:"yui-log-btns"});this._btnCollapse=b("input",{type:"button",className:"yui-log-button",value:"Collapse"});a.on(this._btnCollapse,"click",this._onClickCollapseBtn,this);this._title=b("h4",{innerHTML:"Logger Console"});this._elCollapse.appendChild(this._btnCollapse);this._elHd.appendChild(this._elCollapse);this._elHd.appendChild(this._title);this._elContainer.appendChild(this._elHd);},_initConsoleEl:function(){if(this._elConsole){a.purgeElement(this._elConsole,true);this._elConsole.innerHTML="";}this._elConsole=b("div",{className:"yui-log-bd"});if(this.height){this._elConsole.style.height=this.height;}this._elContainer.appendChild(this._elConsole);},_initFooterEl:function(){if(this.footerEnabled){if(this._elFt){a.purgeElement(this._elFt,true);this._elFt.innerHTML="";}this._elFt=b("div",{className:"yui-log-ft"});this._elBtns=b("div",{className:"yui-log-btns"});this._btnPause=b("input",{type:"button",className:"yui-log-button",value:"Pause"});a.on(this._btnPause,"click",this._onClickPauseBtn,this);this._btnClear=b("input",{type:"button",className:"yui-log-button",value:"Clear"});a.on(this._btnClear,"click",this._onClickClearBtn,this);this._elCategoryFilters=b("div",{className:"yui-log-categoryfilters"});this._elSourceFilters=b("div",{className:"yui-log-sourcefilters"});this._elBtns.appendChild(this._btnPause);this._elBtns.appendChild(this._btnClear);
+this._elFt.appendChild(this._elBtns);this._elFt.appendChild(this._elCategoryFilters);this._elFt.appendChild(this._elSourceFilters);this._elContainer.appendChild(this._elFt);}},_initDragDrop:function(){if(e.DD&&this.draggable&&this._elHd){var d=new e.DD(this._elContainer);d.setHandleElId(this._elHd.id);this._elHd.style.cursor="move";}},_initCategories:function(){this._categoryFilters=[];var k=c.categories;for(var d=0;d<k.length;d++){var i=k[d];this._categoryFilters.push(i);if(this._elCategoryFilters){this._createCategoryCheckbox(i);}}},_initSources:function(){this._sourceFilters=[];var k=c.sources;for(var i=0;i<k.length;i++){var d=k[i];this._sourceFilters.push(d);if(this._elSourceFilters){this._createSourceCheckbox(d);}}},_createCategoryCheckbox:function(l){if(this._elFt){var k=b("span",{className:"yui-log-filtergrp"}),j=f.generateId(null,"yui-log-filter-"+l+this._sName),d=b("input",{id:j,className:"yui-log-filter-"+l,type:"checkbox",category:l}),i=b("label",{htmlFor:j,className:l,innerHTML:l});a.on(d,"click",this._onCheckCategory,this);this._filterCheckboxes[l]=d;k.appendChild(d);k.appendChild(i);this._elCategoryFilters.appendChild(k);d.checked=true;}},_createSourceCheckbox:function(d){if(this._elFt){var l=b("span",{className:"yui-log-filtergrp"}),k=f.generateId(null,"yui-log-filter-"+d+this._sName),i=b("input",{id:k,className:"yui-log-filter-"+d,type:"checkbox",source:d}),j=b("label",{htmlFor:k,className:d,innerHTML:d});a.on(i,"click",this._onCheckSource,this);this._filterCheckboxes[d]=i;l.appendChild(i);l.appendChild(j);this._elSourceFilters.appendChild(l);i.checked=true;}},_filterLogs:function(){if(this._elConsole!==null){this.clearConsole();this._printToConsole(c.getStack());}},_printBuffer:function(){this._timeout=null;if(this._elConsole!==null){var j=this.thresholdMax;j=(j&&!isNaN(j))?j:500;if(this._consoleMsgCount<j){var d=[];for(var k=0;k<this._buffer.length;k++){d[k]=this._buffer[k];}this._buffer=[];this._printToConsole(d);}else{this._filterLogs();}if(!this.newestOnTop){this._elConsole.scrollTop=this._elConsole.scrollHeight;}}},_printToConsole:function(r){var k=r.length,v=h.createDocumentFragment(),y=[],z=this.thresholdMin,l=this._sourceFilters.length,w=this._categoryFilters.length,t,q,p,o,u;if(isNaN(z)||(z>this.thresholdMax)){z=0;}t=(k>z)?(k-z):0;for(q=t;q<k;q++){var n=false,s=false,x=r[q],d=x.source,m=x.category;for(p=0;p<l;p++){if(d==this._sourceFilters[p]){s=true;break;}}if(s){for(p=0;p<w;p++){if(m==this._categoryFilters[p]){n=true;break;}}}if(n){if(this._consoleMsgCount===0){this._lastTime=x.time.getTime();}o=this.formatMsg(x);if(typeof o==="string"){y[y.length]=o;}else{v.insertBefore(o,this.newestOnTop?v.firstChild||null:null);}this._consoleMsgCount++;this._lastTime=x.time.getTime();}}if(y.length){y.splice(0,0,this._elConsole.innerHTML);this._elConsole.innerHTML=this.newestOnTop?y.reverse().join(""):y.join("");}else{if(v.firstChild){this._elConsole.insertBefore(v,this.newestOnTop?this._elConsole.firstChild||null:null);}}},_onCategoryCreate:function(k,j,d){var i=j[0];d._categoryFilters.push(i);if(d._elFt){d._createCategoryCheckbox(i);}},_onSourceCreate:function(k,j,d){var i=j[0];d._sourceFilters.push(i);if(d._elFt){d._createSourceCheckbox(i);}},_onCheckCategory:function(d,i){var j=this.category;if(!this.checked){i.hideCategory(j);}else{i.showCategory(j);}},_onCheckSource:function(d,i){var j=this.source;if(!this.checked){i.hideSource(j);}else{i.showSource(j);}},_onClickCollapseBtn:function(d,i){if(!i.isCollapsed){i.collapse();}else{i.expand();}},_onClickPauseBtn:function(d,i){if(!i.isPaused){i.pause();}else{i.resume();}},_onClickClearBtn:function(d,i){i.clearConsole();},_onNewLog:function(k,j,d){var i=j[0];d._buffer.push(i);if(d.logReaderEnabled===true&&d._timeout===null){d._timeout=setTimeout(function(){d._printBuffer();},d.outputBuffer);}},_onReset:function(j,i,d){d._filterLogs();}};YAHOO.widget.LogReader=g;})();YAHOO.register("logger",YAHOO.widget.Logger,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/menu/menu-min.js b/js/yui/menu/menu-min.js
new file mode 100644 (file)
index 0000000..6122d38
--- /dev/null
+++ b/js/yui/menu/menu-min.js
@@ -0,0 +1,16 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){var K=YAHOO.env.ua,C=YAHOO.util.Dom,Z=YAHOO.util.Event,H=YAHOO.lang,T="DIV",P="hd",M="bd",O="ft",X="LI",A="disabled",D="mouseover",F="mouseout",U="mousedown",G="mouseup",V="click",B="keydown",N="keyup",I="keypress",L="clicktohide",S="position",Q="dynamic",Y="showdelay",J="selected",E="visible",W="UL",R="MenuManager";YAHOO.widget.MenuManager=function(){var l=false,d={},o={},h={},c={"click":"clickEvent","mousedown":"mouseDownEvent","mouseup":"mouseUpEvent","mouseover":"mouseOverEvent","mouseout":"mouseOutEvent","keydown":"keyDownEvent","keyup":"keyUpEvent","keypress":"keyPressEvent","focus":"focusEvent","focusin":"focusEvent","blur":"blurEvent","focusout":"blurEvent"},i=null;function b(r){var p,q;if(r&&r.tagName){switch(r.tagName.toUpperCase()){case T:p=r.parentNode;if((C.hasClass(r,P)||C.hasClass(r,M)||C.hasClass(r,O))&&p&&p.tagName&&p.tagName.toUpperCase()==T){q=p;}else{q=r;}break;case X:q=r;break;default:p=r.parentNode;if(p){q=b(p);}break;}}return q;}function e(t){var p=Z.getTarget(t),q=b(p),u=true,w=t.type,x,r,s,z,y;if(q){r=q.tagName.toUpperCase();if(r==X){s=q.id;if(s&&h[s]){z=h[s];y=z.parent;}}else{if(r==T){if(q.id){y=d[q.id];}}}}if(y){x=c[w];if(w=="click"&&(K.gecko&&y.platform!="mac")&&t.button>0){u=false;}if(u&&z&&!z.cfg.getProperty(A)){z[x].fire(t);}if(u){y[x].fire(t,z);}}else{if(w==U){for(var v in o){if(H.hasOwnProperty(o,v)){y=o[v];if(y.cfg.getProperty(L)&&!(y instanceof YAHOO.widget.MenuBar)&&y.cfg.getProperty(S)==Q){y.hide();if(K.ie&&p.focus&&(K.ie<9)){p.setActive();}}else{if(y.cfg.getProperty(Y)>0){y._cancelShowDelay();}if(y.activeItem){y.activeItem.blur();y.activeItem.cfg.setProperty(J,false);y.activeItem=null;}}}}}}}function n(q,p,r){if(d[r.id]){this.removeMenu(r);}}function k(q,p){var r=p[1];if(r){i=r;}}function f(q,p){i=null;}function a(r,q){var p=q[0],s=this.id;if(p){o[s]=this;}else{if(o[s]){delete o[s];}}}function j(q,p){m(this);}function m(q){var p=q.id;if(p&&h[p]){if(i==q){i=null;}delete h[p];q.destroyEvent.unsubscribe(j);}}function g(q,p){var s=p[0],r;if(s instanceof YAHOO.widget.MenuItem){r=s.id;if(!h[r]){h[r]=s;s.destroyEvent.subscribe(j);}}}return{addMenu:function(q){var p;if(q instanceof YAHOO.widget.Menu&&q.id&&!d[q.id]){d[q.id]=q;if(!l){p=document;Z.on(p,D,e,this,true);Z.on(p,F,e,this,true);Z.on(p,U,e,this,true);Z.on(p,G,e,this,true);Z.on(p,V,e,this,true);Z.on(p,B,e,this,true);Z.on(p,N,e,this,true);Z.on(p,I,e,this,true);Z.onFocus(p,e,this,true);Z.onBlur(p,e,this,true);l=true;}q.cfg.subscribeToConfigEvent(E,a);q.destroyEvent.subscribe(n,q,this);q.itemAddedEvent.subscribe(g);q.focusEvent.subscribe(k);q.blurEvent.subscribe(f);}},removeMenu:function(s){var q,p,r;if(s){q=s.id;if((q in d)&&(d[q]==s)){p=s.getItems();if(p&&p.length>0){r=p.length-1;do{m(p[r]);}while(r--);}delete d[q];if((q in o)&&(o[q]==s)){delete o[q];}if(s.cfg){s.cfg.unsubscribeFromConfigEvent(E,a);}s.destroyEvent.unsubscribe(n,s);s.itemAddedEvent.unsubscribe(g);s.focusEvent.unsubscribe(k);s.blurEvent.unsubscribe(f);}}},hideVisible:function(){var p;for(var q in o){if(H.hasOwnProperty(o,q)){p=o[q];if(!(p instanceof YAHOO.widget.MenuBar)&&p.cfg.getProperty(S)==Q){p.hide();}}}},getVisible:function(){return o;},getMenus:function(){return d;},getMenu:function(q){var p;if(q in d){p=d[q];}return p;},getMenuItem:function(q){var p;if(q in h){p=h[q];}return p;},getMenuItemGroup:function(t){var q=C.get(t),p,v,u,r,s;if(q&&q.tagName&&q.tagName.toUpperCase()==W){v=q.firstChild;if(v){p=[];do{r=v.id;if(r){u=this.getMenuItem(r);if(u){p[p.length]=u;}}}while((v=v.nextSibling));if(p.length>0){s=p;}}}return s;},getFocusedMenuItem:function(){return i;},getFocusedMenu:function(){var p;if(i){p=i.parent.getRoot();}return p;},toString:function(){return R;}};}();})();(function(){var AM=YAHOO.lang,Aq="Menu",G="DIV",K="div",Am="id",AH="SELECT",e="xy",R="y",Ax="UL",L="ul",AJ="first-of-type",k="LI",h="OPTGROUP",Az="OPTION",Ah="disabled",AY="none",y="selected",At="groupindex",i="index",O="submenu",Au="visible",AX="hidedelay",Ac="position",AD="dynamic",C="static",An=AD+","+C,Q="url",M="#",V="target",AU="maxheight",T="topscrollbar",x="bottomscrollbar",d="_",P=T+d+Ah,E=x+d+Ah,b="mousemove",Av="showdelay",c="submenuhidedelay",AF="iframe",w="constraintoviewport",A4="preventcontextoverlap",AO="submenualignment",Z="autosubmenudisplay",AC="clicktohide",g="container",j="scrollincrement",Aj="minscrollheight",A2="classname",Ag="shadow",Ar="keepopen",A0="hd",D="hastitle",p="context",u="",Ak="mousedown",Ae="keydown",Ao="height",U="width",AQ="px",Ay="effect",AE="monitorresize",AW="display",AV="block",J="visibility",z="absolute",AS="zindex",l="yui-menu-body-scrolled",AK="&#32;",A1=" ",Ai="mouseover",H="mouseout",AR="itemAdded",n="itemRemoved",AL="hidden",s="yui-menu-shadow",AG=s+"-visible",m=s+A1+AG;YAHOO.widget.Menu=function(A6,A5){if(A5){this.parent=A5.parent;this.lazyLoad=A5.lazyLoad||A5.lazyload;this.itemData=A5.itemData||A5.itemdata;}YAHOO.widget.Menu.superclass.constructor.call(this,A6,A5);};function B(A6){var A5=false;if(AM.isString(A6)){A5=(An.indexOf((A6.toLowerCase()))!=-1);}return A5;}var f=YAHOO.util.Dom,AA=YAHOO.util.Event,Aw=YAHOO.widget.Module,AB=YAHOO.widget.Overlay,r=YAHOO.widget.Menu,A3=YAHOO.widget.MenuManager,F=YAHOO.util.CustomEvent,As=YAHOO.env.ua,Ap,AT=false,Ad,Ab=[["mouseOverEvent",Ai],["mouseOutEvent",H],["mouseDownEvent",Ak],["mouseUpEvent","mouseup"],["clickEvent","click"],["keyPressEvent","keypress"],["keyDownEvent",Ae],["keyUpEvent","keyup"],["focusEvent","focus"],["blurEvent","blur"],["itemAddedEvent",AR],["itemRemovedEvent",n]],AZ={key:Au,value:false,validator:AM.isBoolean},AP={key:w,value:true,validator:AM.isBoolean,supercedes:[AF,"x",R,e]},AI={key:A4,value:true,validator:AM.isBoolean,supercedes:[w]},S={key:Ac,value:AD,validator:B,supercedes:[Au,AF]},A={key:AO,value:["tl","tr"]},t={key:Z,value:true,validator:AM.isBoolean,suppressEvent:true},Y={key:Av,value:250,validator:AM.isNumber,suppressEvent:true},q={key:AX,value:0,validator:AM.isNumber,suppressEvent:true},v={key:c,value:250,validator:AM.isNumber,suppressEvent:true},o={key:AC,value:true,validator:AM.isBoolean,suppressEvent:true},AN={key:g,suppressEvent:true},Af={key:j,value:1,validator:AM.isNumber,supercedes:[AU],suppressEvent:true},N={key:Aj,value:90,validator:AM.isNumber,supercedes:[AU],suppressEvent:true},X={key:AU,value:0,validator:AM.isNumber,supercedes:[AF],suppressEvent:true},W={key:A2,value:null,validator:AM.isString,suppressEvent:true},a={key:Ah,value:false,validator:AM.isBoolean,suppressEvent:true},I={key:Ag,value:true,validator:AM.isBoolean,suppressEvent:true,supercedes:[Au]},Al={key:Ar,value:false,validator:AM.isBoolean};
+function Aa(A5){Ad=AA.getTarget(A5);}YAHOO.lang.extend(r,AB,{CSS_CLASS_NAME:"yuimenu",ITEM_TYPE:null,GROUP_TITLE_TAG_NAME:"h6",OFF_SCREEN_POSITION:"-999em",_useHideDelay:false,_bHandledMouseOverEvent:false,_bHandledMouseOutEvent:false,_aGroupTitleElements:null,_aItemGroups:null,_aListElements:null,_nCurrentMouseX:0,_bStopMouseEventHandlers:false,_sClassName:null,lazyLoad:false,itemData:null,activeItem:null,parent:null,srcElement:null,init:function(A7,A6){this._aItemGroups=[];this._aListElements=[];this._aGroupTitleElements=[];if(!this.ITEM_TYPE){this.ITEM_TYPE=YAHOO.widget.MenuItem;}var A5;if(AM.isString(A7)){A5=f.get(A7);}else{if(A7.tagName){A5=A7;}}if(A5&&A5.tagName){switch(A5.tagName.toUpperCase()){case G:this.srcElement=A5;if(!A5.id){A5.setAttribute(Am,f.generateId());}r.superclass.init.call(this,A5);this.beforeInitEvent.fire(r);break;case AH:this.srcElement=A5;r.superclass.init.call(this,f.generateId());this.beforeInitEvent.fire(r);break;}}else{r.superclass.init.call(this,A7);this.beforeInitEvent.fire(r);}if(this.element){f.addClass(this.element,this.CSS_CLASS_NAME);this.initEvent.subscribe(this._onInit);this.beforeRenderEvent.subscribe(this._onBeforeRender);this.renderEvent.subscribe(this._onRender);this.beforeShowEvent.subscribe(this._onBeforeShow);this.hideEvent.subscribe(this._onHide);this.showEvent.subscribe(this._onShow);this.beforeHideEvent.subscribe(this._onBeforeHide);this.mouseOverEvent.subscribe(this._onMouseOver);this.mouseOutEvent.subscribe(this._onMouseOut);this.clickEvent.subscribe(this._onClick);this.keyDownEvent.subscribe(this._onKeyDown);this.keyPressEvent.subscribe(this._onKeyPress);this.blurEvent.subscribe(this._onBlur);if(!AT){AA.onFocus(document,Aa);AT=true;}if((As.gecko&&As.gecko<1.9)||(As.webkit&&As.webkit<523)){this.cfg.subscribeToConfigEvent(R,this._onYChange);}if(A6){this.cfg.applyConfig(A6,true);}A3.addMenu(this);this.initEvent.fire(r);}},_initSubTree:function(){var A6=this.srcElement,A5,A8,BB,BC,BA,A9,A7;if(A6){A5=(A6.tagName&&A6.tagName.toUpperCase());if(A5==G){BC=this.body.firstChild;if(BC){A8=0;BB=this.GROUP_TITLE_TAG_NAME.toUpperCase();do{if(BC&&BC.tagName){switch(BC.tagName.toUpperCase()){case BB:this._aGroupTitleElements[A8]=BC;break;case Ax:this._aListElements[A8]=BC;this._aItemGroups[A8]=[];A8++;break;}}}while((BC=BC.nextSibling));if(this._aListElements[0]){f.addClass(this._aListElements[0],AJ);}}}BC=null;if(A5){switch(A5){case G:BA=this._aListElements;A9=BA.length;if(A9>0){A7=A9-1;do{BC=BA[A7].firstChild;if(BC){do{if(BC&&BC.tagName&&BC.tagName.toUpperCase()==k){this.addItem(new this.ITEM_TYPE(BC,{parent:this}),A7);}}while((BC=BC.nextSibling));}}while(A7--);}break;case AH:BC=A6.firstChild;do{if(BC&&BC.tagName){switch(BC.tagName.toUpperCase()){case h:case Az:this.addItem(new this.ITEM_TYPE(BC,{parent:this}));break;}}}while((BC=BC.nextSibling));break;}}}},_getFirstEnabledItem:function(){var A5=this.getItems(),A9=A5.length,A8,A7;for(var A6=0;A6<A9;A6++){A8=A5[A6];if(A8&&!A8.cfg.getProperty(Ah)&&A8.element.style.display!=AY){A7=A8;break;}}return A7;},_addItemToGroup:function(BA,BB,BF){var BD,BG,A8,BE,A9,A6,A7,BC;function A5(BH,BI){return(BH[BI]||A5(BH,(BI+1)));}if(BB instanceof this.ITEM_TYPE){BD=BB;BD.parent=this;}else{if(AM.isString(BB)){BD=new this.ITEM_TYPE(BB,{parent:this});}else{if(AM.isObject(BB)){BB.parent=this;BD=new this.ITEM_TYPE(BB.text,BB);}}}if(BD){if(BD.cfg.getProperty(y)){this.activeItem=BD;}BG=AM.isNumber(BA)?BA:0;A8=this._getItemGroup(BG);if(!A8){A8=this._createItemGroup(BG);}if(AM.isNumber(BF)){A9=(BF>=A8.length);if(A8[BF]){A8.splice(BF,0,BD);}else{A8[BF]=BD;}BE=A8[BF];if(BE){if(A9&&(!BE.element.parentNode||BE.element.parentNode.nodeType==11)){this._aListElements[BG].appendChild(BE.element);}else{A6=A5(A8,(BF+1));if(A6&&(!BE.element.parentNode||BE.element.parentNode.nodeType==11)){this._aListElements[BG].insertBefore(BE.element,A6.element);}}BE.parent=this;this._subscribeToItemEvents(BE);this._configureSubmenu(BE);this._updateItemProperties(BG);this.itemAddedEvent.fire(BE);this.changeContentEvent.fire();BC=BE;}}else{A7=A8.length;A8[A7]=BD;BE=A8[A7];if(BE){if(!f.isAncestor(this._aListElements[BG],BE.element)){this._aListElements[BG].appendChild(BE.element);}BE.element.setAttribute(At,BG);BE.element.setAttribute(i,A7);BE.parent=this;BE.index=A7;BE.groupIndex=BG;this._subscribeToItemEvents(BE);this._configureSubmenu(BE);if(A7===0){f.addClass(BE.element,AJ);}this.itemAddedEvent.fire(BE);this.changeContentEvent.fire();BC=BE;}}}return BC;},_removeItemFromGroupByIndex:function(A8,A6){var A7=AM.isNumber(A8)?A8:0,A9=this._getItemGroup(A7),BB,BA,A5;if(A9){BB=A9.splice(A6,1);BA=BB[0];if(BA){this._updateItemProperties(A7);if(A9.length===0){A5=this._aListElements[A7];if(A5&&A5.parentNode){A5.parentNode.removeChild(A5);}this._aItemGroups.splice(A7,1);this._aListElements.splice(A7,1);A5=this._aListElements[0];if(A5){f.addClass(A5,AJ);}}this.itemRemovedEvent.fire(BA);this.changeContentEvent.fire();}}return BA;},_removeItemFromGroupByValue:function(A8,A5){var BA=this._getItemGroup(A8),BB,A9,A7,A6;if(BA){BB=BA.length;A9=-1;if(BB>0){A6=BB-1;do{if(BA[A6]==A5){A9=A6;break;}}while(A6--);if(A9>-1){A7=this._removeItemFromGroupByIndex(A8,A9);}}}return A7;},_updateItemProperties:function(A6){var A7=this._getItemGroup(A6),BA=A7.length,A9,A8,A5;if(BA>0){A5=BA-1;do{A9=A7[A5];if(A9){A8=A9.element;A9.index=A5;A9.groupIndex=A6;A8.setAttribute(At,A6);A8.setAttribute(i,A5);f.removeClass(A8,AJ);}}while(A5--);if(A8){f.addClass(A8,AJ);}}},_createItemGroup:function(A7){var A5,A6;if(!this._aItemGroups[A7]){this._aItemGroups[A7]=[];A5=document.createElement(L);this._aListElements[A7]=A5;A6=this._aItemGroups[A7];}return A6;},_getItemGroup:function(A7){var A5=AM.isNumber(A7)?A7:0,A8=this._aItemGroups,A6;if(A5 in A8){A6=A8[A5];}return A6;},_configureSubmenu:function(A5){var A6=A5.cfg.getProperty(O);if(A6){this.cfg.configChangedEvent.subscribe(this._onParentMenuConfigChange,A6,true);this.renderEvent.subscribe(this._onParentMenuRender,A6,true);}},_subscribeToItemEvents:function(A5){A5.destroyEvent.subscribe(this._onMenuItemDestroy,A5,this);
+A5.cfg.configChangedEvent.subscribe(this._onMenuItemConfigChange,A5,this);},_onVisibleChange:function(A7,A6){var A5=A6[0];if(A5){f.addClass(this.element,Au);}else{f.removeClass(this.element,Au);}},_cancelHideDelay:function(){var A5=this.getRoot()._hideDelayTimer;if(A5){A5.cancel();}},_execHideDelay:function(){this._cancelHideDelay();var A5=this.getRoot();A5._hideDelayTimer=AM.later(A5.cfg.getProperty(AX),this,function(){if(A5.activeItem){if(A5.hasFocus()){A5.activeItem.focus();}A5.clearActiveItem();}if(A5==this&&!(this instanceof YAHOO.widget.MenuBar)&&this.cfg.getProperty(Ac)==AD){this.hide();}});},_cancelShowDelay:function(){var A5=this.getRoot()._showDelayTimer;if(A5){A5.cancel();}},_execSubmenuHideDelay:function(A7,A6,A5){A7._submenuHideDelayTimer=AM.later(50,this,function(){if(this._nCurrentMouseX>(A6+10)){A7._submenuHideDelayTimer=AM.later(A5,A7,function(){this.hide();});}else{A7.hide();}});},_disableScrollHeader:function(){if(!this._bHeaderDisabled){f.addClass(this.header,P);this._bHeaderDisabled=true;}},_disableScrollFooter:function(){if(!this._bFooterDisabled){f.addClass(this.footer,E);this._bFooterDisabled=true;}},_enableScrollHeader:function(){if(this._bHeaderDisabled){f.removeClass(this.header,P);this._bHeaderDisabled=false;}},_enableScrollFooter:function(){if(this._bFooterDisabled){f.removeClass(this.footer,E);this._bFooterDisabled=false;}},_onMouseOver:function(BH,BA){var BI=BA[0],BE=BA[1],A5=AA.getTarget(BI),A9=this.getRoot(),BG=this._submenuHideDelayTimer,A6,A8,BD,A7,BC,BB;var BF=function(){if(this.parent.cfg.getProperty(y)){this.show();}};if(!this._bStopMouseEventHandlers){if(!this._bHandledMouseOverEvent&&(A5==this.element||f.isAncestor(this.element,A5))){if(this._useHideDelay){this._cancelHideDelay();}this._nCurrentMouseX=0;AA.on(this.element,b,this._onMouseMove,this,true);if(!(BE&&f.isAncestor(BE.element,AA.getRelatedTarget(BI)))){this.clearActiveItem();}if(this.parent&&BG){BG.cancel();this.parent.cfg.setProperty(y,true);A6=this.parent.parent;A6._bHandledMouseOutEvent=true;A6._bHandledMouseOverEvent=false;}this._bHandledMouseOverEvent=true;this._bHandledMouseOutEvent=false;}if(BE&&!BE.handledMouseOverEvent&&!BE.cfg.getProperty(Ah)&&(A5==BE.element||f.isAncestor(BE.element,A5))){A8=this.cfg.getProperty(Av);BD=(A8>0);if(BD){this._cancelShowDelay();}A7=this.activeItem;if(A7){A7.cfg.setProperty(y,false);}BC=BE.cfg;BC.setProperty(y,true);if(this.hasFocus()||A9._hasFocus){BE.focus();A9._hasFocus=false;}if(this.cfg.getProperty(Z)){BB=BC.getProperty(O);if(BB){if(BD){A9._showDelayTimer=AM.later(A9.cfg.getProperty(Av),BB,BF);}else{BB.show();}}}BE.handledMouseOverEvent=true;BE.handledMouseOutEvent=false;}}},_onMouseOut:function(BD,A7){var BE=A7[0],BB=A7[1],A8=AA.getRelatedTarget(BE),BC=false,BA,A9,A5,A6;if(!this._bStopMouseEventHandlers){if(BB&&!BB.cfg.getProperty(Ah)){BA=BB.cfg;A9=BA.getProperty(O);if(A9&&(A8==A9.element||f.isAncestor(A9.element,A8))){BC=true;}if(!BB.handledMouseOutEvent&&((A8!=BB.element&&!f.isAncestor(BB.element,A8))||BC)){if(!BC){BB.cfg.setProperty(y,false);if(A9){A5=this.cfg.getProperty(c);A6=this.cfg.getProperty(Av);if(!(this instanceof YAHOO.widget.MenuBar)&&A5>0&&A5>=A6){this._execSubmenuHideDelay(A9,AA.getPageX(BE),A5);}else{A9.hide();}}}BB.handledMouseOutEvent=true;BB.handledMouseOverEvent=false;}}if(!this._bHandledMouseOutEvent){if(this._didMouseLeave(A8)||BC){if(this._useHideDelay){this._execHideDelay();}AA.removeListener(this.element,b,this._onMouseMove);this._nCurrentMouseX=AA.getPageX(BE);this._bHandledMouseOutEvent=true;this._bHandledMouseOverEvent=false;}}}},_didMouseLeave:function(A5){return(A5===this._shadow||(A5!=this.element&&!f.isAncestor(this.element,A5)));},_onMouseMove:function(A6,A5){if(!this._bStopMouseEventHandlers){this._nCurrentMouseX=AA.getPageX(A6);}},_onClick:function(BG,A7){var BH=A7[0],BB=A7[1],BD=false,A9,BE,A6,A5,BA,BC,BF;var A8=function(){A6=this.getRoot();if(A6 instanceof YAHOO.widget.MenuBar||A6.cfg.getProperty(Ac)==C){A6.clearActiveItem();}else{A6.hide();}};if(BB){if(BB.cfg.getProperty(Ah)){AA.preventDefault(BH);A8.call(this);}else{A9=BB.cfg.getProperty(O);BA=BB.cfg.getProperty(Q);if(BA){BC=BA.indexOf(M);BF=BA.length;if(BC!=-1){BA=BA.substr(BC,BF);BF=BA.length;if(BF>1){A5=BA.substr(1,BF);BE=YAHOO.widget.MenuManager.getMenu(A5);if(BE){BD=(this.getRoot()===BE.getRoot());}}else{if(BF===1){BD=true;}}}}if(BD&&!BB.cfg.getProperty(V)){AA.preventDefault(BH);if(As.webkit){BB.focus();}else{BB.focusEvent.fire();}}if(!A9&&!this.cfg.getProperty(Ar)){A8.call(this);}}}},_stopMouseEventHandlers:function(){this._bStopMouseEventHandlers=true;AM.later(10,this,function(){this._bStopMouseEventHandlers=false;});},_onKeyDown:function(BJ,BD){var BG=BD[0],BF=BD[1],BC,BH,A6,A9,BK,A5,BN,A8,BI,A7,BE,BM,BA,BB;if(this._useHideDelay){this._cancelHideDelay();}if(BF&&!BF.cfg.getProperty(Ah)){BH=BF.cfg;A6=this.parent;switch(BG.keyCode){case 38:case 40:BK=(BG.keyCode==38)?BF.getPreviousEnabledSibling():BF.getNextEnabledSibling();if(BK){this.clearActiveItem();BK.cfg.setProperty(y,true);BK.focus();if(this.cfg.getProperty(AU)>0||f.hasClass(this.body,l)){A5=this.body;BN=A5.scrollTop;A8=A5.offsetHeight;BI=this.getItems();A7=BI.length-1;BE=BK.element.offsetTop;if(BG.keyCode==40){if(BE>=(A8+BN)){A5.scrollTop=BE-A8;}else{if(BE<=BN){A5.scrollTop=0;}}if(BK==BI[A7]){A5.scrollTop=BK.element.offsetTop;}}else{if(BE<=BN){A5.scrollTop=BE-BK.element.offsetHeight;}else{if(BE>=(BN+A8)){A5.scrollTop=BE;}}if(BK==BI[0]){A5.scrollTop=0;}}BN=A5.scrollTop;BM=A5.scrollHeight-A5.offsetHeight;if(BN===0){this._disableScrollHeader();this._enableScrollFooter();}else{if(BN==BM){this._enableScrollHeader();this._disableScrollFooter();}else{this._enableScrollHeader();this._enableScrollFooter();}}}}AA.preventDefault(BG);this._stopMouseEventHandlers();break;case 39:BC=BH.getProperty(O);if(BC){if(!BH.getProperty(y)){BH.setProperty(y,true);}BC.show();BC.setInitialFocus();BC.setInitialSelection();}else{A9=this.getRoot();if(A9 instanceof YAHOO.widget.MenuBar){BK=A9.activeItem.getNextEnabledSibling();
+if(BK){A9.clearActiveItem();BK.cfg.setProperty(y,true);BC=BK.cfg.getProperty(O);if(BC){BC.show();BC.setInitialFocus();}else{BK.focus();}}}}AA.preventDefault(BG);this._stopMouseEventHandlers();break;case 37:if(A6){BA=A6.parent;if(BA instanceof YAHOO.widget.MenuBar){BK=BA.activeItem.getPreviousEnabledSibling();if(BK){BA.clearActiveItem();BK.cfg.setProperty(y,true);BC=BK.cfg.getProperty(O);if(BC){BC.show();BC.setInitialFocus();}else{BK.focus();}}}else{this.hide();A6.focus();}}AA.preventDefault(BG);this._stopMouseEventHandlers();break;}}if(BG.keyCode==27){if(this.cfg.getProperty(Ac)==AD){this.hide();if(this.parent){this.parent.focus();}else{BB=this._focusedElement;if(BB&&BB.focus){try{BB.focus();}catch(BL){}}}}else{if(this.activeItem){BC=this.activeItem.cfg.getProperty(O);if(BC&&BC.cfg.getProperty(Au)){BC.hide();this.activeItem.focus();}else{this.activeItem.blur();this.activeItem.cfg.setProperty(y,false);}}}AA.preventDefault(BG);}},_onKeyPress:function(A7,A6){var A5=A6[0];if(A5.keyCode==40||A5.keyCode==38){AA.preventDefault(A5);}},_onBlur:function(A6,A5){if(this._hasFocus){this._hasFocus=false;}},_onYChange:function(A6,A5){var A8=this.parent,BA,A7,A9;if(A8){BA=A8.parent.body.scrollTop;if(BA>0){A9=(this.cfg.getProperty(R)-BA);f.setY(this.element,A9);A7=this.iframe;if(A7){f.setY(A7,A9);}this.cfg.setProperty(R,A9,true);}}},_onScrollTargetMouseOver:function(BB,BE){var BD=this._bodyScrollTimer;if(BD){BD.cancel();}this._cancelHideDelay();var A7=AA.getTarget(BB),A9=this.body,A8=this.cfg.getProperty(j),A5,A6;function BC(){var BF=A9.scrollTop;if(BF<A5){A9.scrollTop=(BF+A8);this._enableScrollHeader();}else{A9.scrollTop=A5;this._bodyScrollTimer.cancel();this._disableScrollFooter();}}function BA(){var BF=A9.scrollTop;if(BF>0){A9.scrollTop=(BF-A8);this._enableScrollFooter();}else{A9.scrollTop=0;this._bodyScrollTimer.cancel();this._disableScrollHeader();}}if(f.hasClass(A7,A0)){A6=BA;}else{A5=A9.scrollHeight-A9.offsetHeight;A6=BC;}this._bodyScrollTimer=AM.later(10,this,A6,null,true);},_onScrollTargetMouseOut:function(A7,A5){var A6=this._bodyScrollTimer;if(A6){A6.cancel();}this._cancelHideDelay();},_onInit:function(A6,A5){this.cfg.subscribeToConfigEvent(Au,this._onVisibleChange);var A7=!this.parent,A8=this.lazyLoad;if(((A7&&!A8)||(A7&&(this.cfg.getProperty(Au)||this.cfg.getProperty(Ac)==C))||(!A7&&!A8))&&this.getItemGroups().length===0){if(this.srcElement){this._initSubTree();}if(this.itemData){this.addItems(this.itemData);}}else{if(A8){this.cfg.fireQueue();}}},_onBeforeRender:function(A8,A7){var A9=this.element,BC=this._aListElements.length,A6=true,BB=0,A5,BA;if(BC>0){do{A5=this._aListElements[BB];if(A5){if(A6){f.addClass(A5,AJ);A6=false;}if(!f.isAncestor(A9,A5)){this.appendToBody(A5);}BA=this._aGroupTitleElements[BB];if(BA){if(!f.isAncestor(A9,BA)){A5.parentNode.insertBefore(BA,A5);}f.addClass(A5,D);}}BB++;}while(BB<BC);}},_onRender:function(A6,A5){if(this.cfg.getProperty(Ac)==AD){if(!this.cfg.getProperty(Au)){this.positionOffScreen();}}},_onBeforeShow:function(A7,A6){var A9,BC,A8,BA=this.cfg.getProperty(g);if(this.lazyLoad&&this.getItemGroups().length===0){if(this.srcElement){this._initSubTree();}if(this.itemData){if(this.parent&&this.parent.parent&&this.parent.parent.srcElement&&this.parent.parent.srcElement.tagName.toUpperCase()==AH){A9=this.itemData.length;for(BC=0;BC<A9;BC++){if(this.itemData[BC].tagName){this.addItem((new this.ITEM_TYPE(this.itemData[BC])));}}}else{this.addItems(this.itemData);}}A8=this.srcElement;if(A8){if(A8.tagName.toUpperCase()==AH){if(f.inDocument(A8)){this.render(A8.parentNode);}else{this.render(BA);}}else{this.render();}}else{if(this.parent){this.render(this.parent.element);}else{this.render(BA);}}}var BB=this.parent,A5;if(!BB&&this.cfg.getProperty(Ac)==AD){this.cfg.refireEvent(e);}if(BB){A5=BB.parent.cfg.getProperty(AO);this.cfg.setProperty(p,[BB.element,A5[0],A5[1]]);this.align();}},getConstrainedY:function(BH){var BS=this,BO=BS.cfg.getProperty(p),BV=BS.cfg.getProperty(AU),BR,BG={"trbr":true,"tlbl":true,"bltl":true,"brtr":true},BA=(BO&&BG[BO[1]+BO[2]]),BC=BS.element,BW=BC.offsetHeight,BQ=AB.VIEWPORT_OFFSET,BL=f.getViewportHeight(),BP=f.getDocumentScrollTop(),BM=(BS.cfg.getProperty(Aj)+BQ<BL),BU,BD,BJ,BK,BF=false,BE,A7,BI=BP+BQ,A9=BP+BL-BW-BQ,A5=BH;var BB=function(){var BX;if((BS.cfg.getProperty(R)-BP)>BJ){BX=(BJ-BW);}else{BX=(BJ+BK);}BS.cfg.setProperty(R,(BX+BP),true);return BX;};var A8=function(){if((BS.cfg.getProperty(R)-BP)>BJ){return(A7-BQ);}else{return(BE-BQ);}};var BN=function(){var BX;if((BS.cfg.getProperty(R)-BP)>BJ){BX=(BJ+BK);}else{BX=(BJ-BC.offsetHeight);}BS.cfg.setProperty(R,(BX+BP),true);};var A6=function(){BS._setScrollHeight(this.cfg.getProperty(AU));BS.hideEvent.unsubscribe(A6);};var BT=function(){var Ba=A8(),BX=(BS.getItems().length>0),BZ,BY;if(BW>Ba){BZ=BX?BS.cfg.getProperty(Aj):BW;if((Ba>BZ)&&BX){BR=Ba;}else{BR=BV;}BS._setScrollHeight(BR);BS.hideEvent.subscribe(A6);BN();if(Ba<BZ){if(BF){BB();}else{BB();BF=true;BY=BT();}}}else{if(BR&&(BR!==BV)){BS._setScrollHeight(BV);BS.hideEvent.subscribe(A6);BN();}}return BY;};if(BH<BI||BH>A9){if(BM){if(BS.cfg.getProperty(A4)&&BA){BD=BO[0];BK=BD.offsetHeight;BJ=(f.getY(BD)-BP);BE=BJ;A7=(BL-(BJ+BK));BT();A5=BS.cfg.getProperty(R);}else{if(!(BS instanceof YAHOO.widget.MenuBar)&&BW>=BL){BU=(BL-(BQ*2));if(BU>BS.cfg.getProperty(Aj)){BS._setScrollHeight(BU);BS.hideEvent.subscribe(A6);BN();A5=BS.cfg.getProperty(R);}}else{if(BH<BI){A5=BI;}else{if(BH>A9){A5=A9;}}}}}else{A5=BQ+BP;}}return A5;},_onHide:function(A6,A5){if(this.cfg.getProperty(Ac)===AD){this.positionOffScreen();}},_onShow:function(BD,BB){var A5=this.parent,A7,A8,BA,A6;function A9(BF){var BE;if(BF.type==Ak||(BF.type==Ae&&BF.keyCode==27)){BE=AA.getTarget(BF);if(BE!=A7.element||!f.isAncestor(A7.element,BE)){A7.cfg.setProperty(Z,false);AA.removeListener(document,Ak,A9);AA.removeListener(document,Ae,A9);}}}function BC(BF,BE,BG){this.cfg.setProperty(U,u);this.hideEvent.unsubscribe(BC,BG);}if(A5){A7=A5.parent;if(!A7.cfg.getProperty(Z)&&(A7 instanceof YAHOO.widget.MenuBar||A7.cfg.getProperty(Ac)==C)){A7.cfg.setProperty(Z,true);
+AA.on(document,Ak,A9);AA.on(document,Ae,A9);}if((this.cfg.getProperty("x")<A7.cfg.getProperty("x"))&&(As.gecko&&As.gecko<1.9)&&!this.cfg.getProperty(U)){A8=this.element;BA=A8.offsetWidth;A8.style.width=BA+AQ;A6=(BA-(A8.offsetWidth-BA))+AQ;this.cfg.setProperty(U,A6);this.hideEvent.subscribe(BC,A6);}}if(this===this.getRoot()&&this.cfg.getProperty(Ac)===AD){this._focusedElement=Ad;this.focus();}},_onBeforeHide:function(A7,A6){var A5=this.activeItem,A9=this.getRoot(),BA,A8;if(A5){BA=A5.cfg;BA.setProperty(y,false);A8=BA.getProperty(O);if(A8){A8.hide();}}if(As.ie&&this.cfg.getProperty(Ac)===AD&&this.parent){A9._hasFocus=this.hasFocus();}if(A9==this){A9.blur();}},_onParentMenuConfigChange:function(A6,A5,A9){var A7=A5[0][0],A8=A5[0][1];switch(A7){case AF:case w:case AX:case Av:case c:case AC:case Ay:case A2:case j:case AU:case Aj:case AE:case Ag:case A4:case Ar:A9.cfg.setProperty(A7,A8);break;case AO:if(!(this.parent.parent instanceof YAHOO.widget.MenuBar)){A9.cfg.setProperty(A7,A8);}break;}},_onParentMenuRender:function(A6,A5,BB){var A8=BB.parent.parent,A7=A8.cfg,A9={constraintoviewport:A7.getProperty(w),xy:[0,0],clicktohide:A7.getProperty(AC),effect:A7.getProperty(Ay),showdelay:A7.getProperty(Av),hidedelay:A7.getProperty(AX),submenuhidedelay:A7.getProperty(c),classname:A7.getProperty(A2),scrollincrement:A7.getProperty(j),maxheight:A7.getProperty(AU),minscrollheight:A7.getProperty(Aj),iframe:A7.getProperty(AF),shadow:A7.getProperty(Ag),preventcontextoverlap:A7.getProperty(A4),monitorresize:A7.getProperty(AE),keepopen:A7.getProperty(Ar)},BA;if(!(A8 instanceof YAHOO.widget.MenuBar)){A9[AO]=A7.getProperty(AO);}BB.cfg.applyConfig(A9);if(!this.lazyLoad){BA=this.parent.element;if(this.element.parentNode==BA){this.render();}else{this.render(BA);}}},_onMenuItemDestroy:function(A7,A6,A5){this._removeItemFromGroupByValue(A5.groupIndex,A5);},_onMenuItemConfigChange:function(A7,A6,A5){var A9=A6[0][0],BA=A6[0][1],A8;switch(A9){case y:if(BA===true){this.activeItem=A5;}break;case O:A8=A6[0][1];if(A8){this._configureSubmenu(A5);}break;}},configVisible:function(A7,A6,A8){var A5,A9;if(this.cfg.getProperty(Ac)==AD){r.superclass.configVisible.call(this,A7,A6,A8);}else{A5=A6[0];A9=f.getStyle(this.element,AW);f.setStyle(this.element,J,Au);if(A5){if(A9!=AV){this.beforeShowEvent.fire();f.setStyle(this.element,AW,AV);this.showEvent.fire();}}else{if(A9==AV){this.beforeHideEvent.fire();f.setStyle(this.element,AW,AY);this.hideEvent.fire();}}}},configPosition:function(A7,A6,BA){var A9=this.element,A8=A6[0]==C?C:z,BB=this.cfg,A5;f.setStyle(A9,Ac,A8);if(A8==C){f.setStyle(A9,AW,AV);BB.setProperty(Au,true);}else{f.setStyle(A9,J,AL);}if(A8==z){A5=BB.getProperty(AS);if(!A5||A5===0){BB.setProperty(AS,1);}}},configIframe:function(A6,A5,A7){if(this.cfg.getProperty(Ac)==AD){r.superclass.configIframe.call(this,A6,A5,A7);}},configHideDelay:function(A6,A5,A7){var A8=A5[0];this._useHideDelay=(A8>0);},configContainer:function(A6,A5,A8){var A7=A5[0];if(AM.isString(A7)){this.cfg.setProperty(g,f.get(A7),true);}},_clearSetWidthFlag:function(){this._widthSetForScroll=false;this.cfg.unsubscribeFromConfigEvent(U,this._clearSetWidthFlag);},_subscribeScrollHandlers:function(A6,A5){var A8=this._onScrollTargetMouseOver;var A7=this._onScrollTargetMouseOut;AA.on(A6,Ai,A8,this,true);AA.on(A6,H,A7,this,true);AA.on(A5,Ai,A8,this,true);AA.on(A5,H,A7,this,true);},_unsubscribeScrollHandlers:function(A6,A5){var A8=this._onScrollTargetMouseOver;var A7=this._onScrollTargetMouseOut;AA.removeListener(A6,Ai,A8);AA.removeListener(A6,H,A7);AA.removeListener(A5,Ai,A8);AA.removeListener(A5,H,A7);},_setScrollHeight:function(BF){var BC=BF,BB=false,BG=false,A8,A9,BE,A6,A5,BD,BA,A7;if(this.getItems().length>0){A8=this.element;A9=this.body;BE=this.header;A6=this.footer;A5=this.cfg.getProperty(Aj);if(BC>0&&BC<A5){BC=A5;}f.setStyle(A9,Ao,u);f.removeClass(A9,l);A9.scrollTop=0;BG=((As.gecko&&As.gecko<1.9)||As.ie);if(BC>0&&BG&&!this.cfg.getProperty(U)){BA=A8.offsetWidth;A8.style.width=BA+AQ;A7=(BA-(A8.offsetWidth-BA))+AQ;this.cfg.unsubscribeFromConfigEvent(U,this._clearSetWidthFlag);this.cfg.setProperty(U,A7);this._widthSetForScroll=true;this.cfg.subscribeToConfigEvent(U,this._clearSetWidthFlag);}if(BC>0&&(!BE&&!A6)){this.setHeader(AK);this.setFooter(AK);BE=this.header;A6=this.footer;f.addClass(BE,T);f.addClass(A6,x);A8.insertBefore(BE,A9);A8.appendChild(A6);}BD=BC;if(BE&&A6){BD=(BD-(BE.offsetHeight+A6.offsetHeight));}if((BD>0)&&(A9.offsetHeight>BC)){f.addClass(A9,l);f.setStyle(A9,Ao,(BD+AQ));if(!this._hasScrollEventHandlers){this._subscribeScrollHandlers(BE,A6);this._hasScrollEventHandlers=true;}this._disableScrollHeader();this._enableScrollFooter();BB=true;}else{if(BE&&A6){if(this._widthSetForScroll){this._widthSetForScroll=false;this.cfg.unsubscribeFromConfigEvent(U,this._clearSetWidthFlag);this.cfg.setProperty(U,u);}this._enableScrollHeader();this._enableScrollFooter();if(this._hasScrollEventHandlers){this._unsubscribeScrollHandlers(BE,A6);this._hasScrollEventHandlers=false;}A8.removeChild(BE);A8.removeChild(A6);this.header=null;this.footer=null;BB=true;}}if(BB){this.cfg.refireEvent(AF);this.cfg.refireEvent(Ag);}}},_setMaxHeight:function(A6,A5,A7){this._setScrollHeight(A7);this.renderEvent.unsubscribe(this._setMaxHeight);},configMaxHeight:function(A6,A5,A7){var A8=A5[0];if(this.lazyLoad&&!this.body&&A8>0){this.renderEvent.subscribe(this._setMaxHeight,A8,this);}else{this._setScrollHeight(A8);}},configClassName:function(A7,A6,A8){var A5=A6[0];if(this._sClassName){f.removeClass(this.element,this._sClassName);}f.addClass(this.element,A5);this._sClassName=A5;},_onItemAdded:function(A6,A5){var A7=A5[0];if(A7){A7.cfg.setProperty(Ah,true);}},configDisabled:function(A7,A6,BA){var A9=A6[0],A5=this.getItems(),BB,A8;if(AM.isArray(A5)){BB=A5.length;if(BB>0){A8=BB-1;do{A5[A8].cfg.setProperty(Ah,A9);}while(A8--);}if(A9){this.clearActiveItem(true);f.addClass(this.element,Ah);this.itemAddedEvent.subscribe(this._onItemAdded);}else{f.removeClass(this.element,Ah);this.itemAddedEvent.unsubscribe(this._onItemAdded);
+}}},_sizeShadow:function(){var A6=this.element,A5=this._shadow;if(A5&&A6){if(A5.style.width&&A5.style.height){A5.style.width=u;A5.style.height=u;}A5.style.width=(A6.offsetWidth+6)+AQ;A5.style.height=(A6.offsetHeight+1)+AQ;}},_replaceShadow:function(){this.element.appendChild(this._shadow);},_addShadowVisibleClass:function(){f.addClass(this._shadow,AG);},_removeShadowVisibleClass:function(){f.removeClass(this._shadow,AG);},_removeShadow:function(){var A5=(this._shadow&&this._shadow.parentNode);if(A5){A5.removeChild(this._shadow);}this.beforeShowEvent.unsubscribe(this._addShadowVisibleClass);this.beforeHideEvent.unsubscribe(this._removeShadowVisibleClass);this.cfg.unsubscribeFromConfigEvent(U,this._sizeShadow);this.cfg.unsubscribeFromConfigEvent(Ao,this._sizeShadow);this.cfg.unsubscribeFromConfigEvent(AU,this._sizeShadow);this.cfg.unsubscribeFromConfigEvent(AU,this._replaceShadow);this.changeContentEvent.unsubscribe(this._sizeShadow);Aw.textResizeEvent.unsubscribe(this._sizeShadow);},_createShadow:function(){var A6=this._shadow,A5;if(!A6){A5=this.element;if(!Ap){Ap=document.createElement(K);Ap.className=m;}A6=Ap.cloneNode(false);A5.appendChild(A6);this._shadow=A6;this.beforeShowEvent.subscribe(this._addShadowVisibleClass);this.beforeHideEvent.subscribe(this._removeShadowVisibleClass);if(As.ie){AM.later(0,this,function(){this._sizeShadow();this.syncIframe();});this.cfg.subscribeToConfigEvent(U,this._sizeShadow);this.cfg.subscribeToConfigEvent(Ao,this._sizeShadow);this.cfg.subscribeToConfigEvent(AU,this._sizeShadow);this.changeContentEvent.subscribe(this._sizeShadow);Aw.textResizeEvent.subscribe(this._sizeShadow,this,true);this.destroyEvent.subscribe(function(){Aw.textResizeEvent.unsubscribe(this._sizeShadow,this);});}this.cfg.subscribeToConfigEvent(AU,this._replaceShadow);}},_shadowBeforeShow:function(){if(this._shadow){this._replaceShadow();if(As.ie){this._sizeShadow();}}else{this._createShadow();}this.beforeShowEvent.unsubscribe(this._shadowBeforeShow);},configShadow:function(A6,A5,A7){var A8=A5[0];if(A8&&this.cfg.getProperty(Ac)==AD){if(this.cfg.getProperty(Au)){if(this._shadow){this._replaceShadow();if(As.ie){this._sizeShadow();}}else{this._createShadow();}}else{this.beforeShowEvent.subscribe(this._shadowBeforeShow);}}else{if(!A8){this.beforeShowEvent.unsubscribe(this._shadowBeforeShow);this._removeShadow();}}},initEvents:function(){r.superclass.initEvents.call(this);var A6=Ab.length-1,A7,A5;do{A7=Ab[A6];A5=this.createEvent(A7[1]);A5.signature=F.LIST;this[A7[0]]=A5;}while(A6--);},positionOffScreen:function(){var A6=this.iframe,A7=this.element,A5=this.OFF_SCREEN_POSITION;A7.style.top=u;A7.style.left=u;if(A6){A6.style.top=A5;A6.style.left=A5;}},getRoot:function(){var A7=this.parent,A6,A5;if(A7){A6=A7.parent;A5=A6?A6.getRoot():this;}else{A5=this;}return A5;},toString:function(){var A6=Aq,A5=this.id;if(A5){A6+=(A1+A5);}return A6;},setItemGroupTitle:function(BA,A9){var A8,A7,A6,A5;if(AM.isString(BA)&&BA.length>0){A8=AM.isNumber(A9)?A9:0;A7=this._aGroupTitleElements[A8];if(A7){A7.innerHTML=BA;}else{A7=document.createElement(this.GROUP_TITLE_TAG_NAME);A7.innerHTML=BA;this._aGroupTitleElements[A8]=A7;}A6=this._aGroupTitleElements.length-1;do{if(this._aGroupTitleElements[A6]){f.removeClass(this._aGroupTitleElements[A6],AJ);A5=A6;}}while(A6--);if(A5!==null){f.addClass(this._aGroupTitleElements[A5],AJ);}this.changeContentEvent.fire();}},addItem:function(A5,A6){return this._addItemToGroup(A6,A5);},addItems:function(A9,A8){var BB,A5,BA,A6,A7;if(AM.isArray(A9)){BB=A9.length;A5=[];for(A6=0;A6<BB;A6++){BA=A9[A6];if(BA){if(AM.isArray(BA)){A5[A5.length]=this.addItems(BA,A6);}else{A5[A5.length]=this._addItemToGroup(A8,BA);}}}if(A5.length){A7=A5;}}return A7;},insertItem:function(A5,A6,A7){return this._addItemToGroup(A7,A5,A6);},removeItem:function(A5,A7){var A8,A6;if(!AM.isUndefined(A5)){if(A5 instanceof YAHOO.widget.MenuItem){A8=this._removeItemFromGroupByValue(A7,A5);}else{if(AM.isNumber(A5)){A8=this._removeItemFromGroupByIndex(A7,A5);}}if(A8){A8.destroy();A6=A8;}}return A6;},getItems:function(){var A8=this._aItemGroups,A6,A7,A5=[];if(AM.isArray(A8)){A6=A8.length;A7=((A6==1)?A8[0]:(Array.prototype.concat.apply(A5,A8)));}return A7;},getItemGroups:function(){return this._aItemGroups;},getItem:function(A6,A7){var A8,A5;if(AM.isNumber(A6)){A8=this._getItemGroup(A7);if(A8){A5=A8[A6];}}return A5;},getSubmenus:function(){var A6=this.getItems(),BA=A6.length,A5,A7,A9,A8;if(BA>0){A5=[];for(A8=0;A8<BA;A8++){A9=A6[A8];if(A9){A7=A9.cfg.getProperty(O);if(A7){A5[A5.length]=A7;}}}}return A5;},clearContent:function(){var A9=this.getItems(),A6=A9.length,A7=this.element,A8=this.body,BD=this.header,A5=this.footer,BC,BB,BA;if(A6>0){BA=A6-1;do{BC=A9[BA];if(BC){BB=BC.cfg.getProperty(O);if(BB){this.cfg.configChangedEvent.unsubscribe(this._onParentMenuConfigChange,BB);this.renderEvent.unsubscribe(this._onParentMenuRender,BB);}this.removeItem(BC,BC.groupIndex);}}while(BA--);}if(BD){AA.purgeElement(BD);A7.removeChild(BD);}if(A5){AA.purgeElement(A5);A7.removeChild(A5);}if(A8){AA.purgeElement(A8);A8.innerHTML=u;}this.activeItem=null;this._aItemGroups=[];this._aListElements=[];this._aGroupTitleElements=[];this.cfg.setProperty(U,null);},destroy:function(A5){this.clearContent();this._aItemGroups=null;this._aListElements=null;this._aGroupTitleElements=null;r.superclass.destroy.call(this,A5);},setInitialFocus:function(){var A5=this._getFirstEnabledItem();if(A5){A5.focus();}},setInitialSelection:function(){var A5=this._getFirstEnabledItem();if(A5){A5.cfg.setProperty(y,true);}},clearActiveItem:function(A7){if(this.cfg.getProperty(Av)>0){this._cancelShowDelay();}var A5=this.activeItem,A8,A6;if(A5){A8=A5.cfg;if(A7){A5.blur();this.getRoot()._hasFocus=true;}A8.setProperty(y,false);A6=A8.getProperty(O);if(A6){A6.hide();}this.activeItem=null;}},focus:function(){if(!this.hasFocus()){this.setInitialFocus();}},blur:function(){var A5;if(this.hasFocus()){A5=A3.getFocusedMenuItem();if(A5){A5.blur();}}},hasFocus:function(){return(A3.getFocusedMenu()==this.getRoot());
+},_doItemSubmenuSubscribe:function(A6,A5,A8){var A9=A5[0],A7=A9.cfg.getProperty(O);if(A7){A7.subscribe.apply(A7,A8);}},_doSubmenuSubscribe:function(A6,A5,A8){var A7=this.cfg.getProperty(O);if(A7){A7.subscribe.apply(A7,A8);}},subscribe:function(){r.superclass.subscribe.apply(this,arguments);r.superclass.subscribe.call(this,AR,this._doItemSubmenuSubscribe,arguments);var A5=this.getItems(),A9,A8,A6,A7;if(A5){A9=A5.length;if(A9>0){A7=A9-1;do{A8=A5[A7];A6=A8.cfg.getProperty(O);if(A6){A6.subscribe.apply(A6,arguments);}else{A8.cfg.subscribeToConfigEvent(O,this._doSubmenuSubscribe,arguments);}}while(A7--);}}},unsubscribe:function(){r.superclass.unsubscribe.apply(this,arguments);r.superclass.unsubscribe.call(this,AR,this._doItemSubmenuSubscribe,arguments);var A5=this.getItems(),A9,A8,A6,A7;if(A5){A9=A5.length;if(A9>0){A7=A9-1;do{A8=A5[A7];A6=A8.cfg.getProperty(O);if(A6){A6.unsubscribe.apply(A6,arguments);}else{A8.cfg.unsubscribeFromConfigEvent(O,this._doSubmenuSubscribe,arguments);}}while(A7--);}}},initDefaultConfig:function(){r.superclass.initDefaultConfig.call(this);var A5=this.cfg;A5.addProperty(AZ.key,{handler:this.configVisible,value:AZ.value,validator:AZ.validator});A5.addProperty(AP.key,{handler:this.configConstrainToViewport,value:AP.value,validator:AP.validator,supercedes:AP.supercedes});A5.addProperty(AI.key,{value:AI.value,validator:AI.validator,supercedes:AI.supercedes});A5.addProperty(S.key,{handler:this.configPosition,value:S.value,validator:S.validator,supercedes:S.supercedes});A5.addProperty(A.key,{value:A.value,suppressEvent:A.suppressEvent});A5.addProperty(t.key,{value:t.value,validator:t.validator,suppressEvent:t.suppressEvent});A5.addProperty(Y.key,{value:Y.value,validator:Y.validator,suppressEvent:Y.suppressEvent});A5.addProperty(q.key,{handler:this.configHideDelay,value:q.value,validator:q.validator,suppressEvent:q.suppressEvent});A5.addProperty(v.key,{value:v.value,validator:v.validator,suppressEvent:v.suppressEvent});A5.addProperty(o.key,{value:o.value,validator:o.validator,suppressEvent:o.suppressEvent});A5.addProperty(AN.key,{handler:this.configContainer,value:document.body,suppressEvent:AN.suppressEvent});A5.addProperty(Af.key,{value:Af.value,validator:Af.validator,supercedes:Af.supercedes,suppressEvent:Af.suppressEvent});A5.addProperty(N.key,{value:N.value,validator:N.validator,supercedes:N.supercedes,suppressEvent:N.suppressEvent});A5.addProperty(X.key,{handler:this.configMaxHeight,value:X.value,validator:X.validator,suppressEvent:X.suppressEvent,supercedes:X.supercedes});A5.addProperty(W.key,{handler:this.configClassName,value:W.value,validator:W.validator,supercedes:W.supercedes});A5.addProperty(a.key,{handler:this.configDisabled,value:a.value,validator:a.validator,suppressEvent:a.suppressEvent});A5.addProperty(I.key,{handler:this.configShadow,value:I.value,validator:I.validator});A5.addProperty(Al.key,{value:Al.value,validator:Al.validator});}});})();(function(){YAHOO.widget.MenuItem=function(AS,AR){if(AS){if(AR){this.parent=AR.parent;this.value=AR.value;this.id=AR.id;}this.init(AS,AR);}};var x=YAHOO.util.Dom,j=YAHOO.widget.Module,AB=YAHOO.widget.Menu,c=YAHOO.widget.MenuItem,AK=YAHOO.util.CustomEvent,k=YAHOO.env.ua,AQ=YAHOO.lang,AL="text",O="#",Q="-",L="helptext",n="url",AH="target",A="emphasis",N="strongemphasis",b="checked",w="submenu",H="disabled",B="selected",P="hassubmenu",U="checked-disabled",AI="hassubmenu-disabled",AD="hassubmenu-selected",T="checked-selected",q="onclick",J="classname",AJ="",i="OPTION",v="OPTGROUP",K="LI",AE="href",r="SELECT",X="DIV",AN='<em class="helptext">',a="<em>",I="</em>",W="<strong>",y="</strong>",Y="preventcontextoverlap",h="obj",AG="scope",t="none",V="visible",E=" ",m="MenuItem",AA="click",D="show",M="hide",S="li",AF='<a href="#"></a>',p=[["mouseOverEvent","mouseover"],["mouseOutEvent","mouseout"],["mouseDownEvent","mousedown"],["mouseUpEvent","mouseup"],["clickEvent",AA],["keyPressEvent","keypress"],["keyDownEvent","keydown"],["keyUpEvent","keyup"],["focusEvent","focus"],["blurEvent","blur"],["destroyEvent","destroy"]],o={key:AL,value:AJ,validator:AQ.isString,suppressEvent:true},s={key:L,supercedes:[AL],suppressEvent:true},G={key:n,value:O,suppressEvent:true},AO={key:AH,suppressEvent:true},AP={key:A,value:false,validator:AQ.isBoolean,suppressEvent:true,supercedes:[AL]},d={key:N,value:false,validator:AQ.isBoolean,suppressEvent:true,supercedes:[AL]},l={key:b,value:false,validator:AQ.isBoolean,suppressEvent:true,supercedes:[H,B]},F={key:w,suppressEvent:true,supercedes:[H,B]},AM={key:H,value:false,validator:AQ.isBoolean,suppressEvent:true,supercedes:[AL,B]},f={key:B,value:false,validator:AQ.isBoolean,suppressEvent:true},u={key:q,suppressEvent:true},AC={key:J,value:null,validator:AQ.isString,suppressEvent:true},z={key:"keylistener",value:null,suppressEvent:true},C=null,e={};var Z=function(AU,AT){var AR=e[AU];if(!AR){e[AU]={};AR=e[AU];}var AS=AR[AT];if(!AS){AS=AU+Q+AT;AR[AT]=AS;}return AS;};var g=function(AR){x.addClass(this.element,Z(this.CSS_CLASS_NAME,AR));x.addClass(this._oAnchor,Z(this.CSS_LABEL_CLASS_NAME,AR));};var R=function(AR){x.removeClass(this.element,Z(this.CSS_CLASS_NAME,AR));x.removeClass(this._oAnchor,Z(this.CSS_LABEL_CLASS_NAME,AR));};c.prototype={CSS_CLASS_NAME:"yuimenuitem",CSS_LABEL_CLASS_NAME:"yuimenuitemlabel",SUBMENU_TYPE:null,_oAnchor:null,_oHelpTextEM:null,_oSubmenu:null,_oOnclickAttributeValue:null,_sClassName:null,constructor:c,index:null,groupIndex:null,parent:null,element:null,srcElement:null,value:null,browser:j.prototype.browser,id:null,init:function(AR,Ab){if(!this.SUBMENU_TYPE){this.SUBMENU_TYPE=AB;}this.cfg=new YAHOO.util.Config(this);this.initDefaultConfig();var AX=this.cfg,AY=O,AT,Aa,AZ,AS,AV,AU,AW;if(AQ.isString(AR)){this._createRootNodeStructure();AX.queueProperty(AL,AR);}else{if(AR&&AR.tagName){switch(AR.tagName.toUpperCase()){case i:this._createRootNodeStructure();AX.queueProperty(AL,AR.text);AX.queueProperty(H,AR.disabled);this.value=AR.value;this.srcElement=AR;break;case v:this._createRootNodeStructure();
+AX.queueProperty(AL,AR.label);AX.queueProperty(H,AR.disabled);this.srcElement=AR;this._initSubTree();break;case K:AZ=x.getFirstChild(AR);if(AZ){AY=AZ.getAttribute(AE,2);AS=AZ.getAttribute(AH);AV=AZ.innerHTML;}this.srcElement=AR;this.element=AR;this._oAnchor=AZ;AX.setProperty(AL,AV,true);AX.setProperty(n,AY,true);AX.setProperty(AH,AS,true);this._initSubTree();break;}}}if(this.element){AU=(this.srcElement||this.element).id;if(!AU){AU=this.id||x.generateId();this.element.id=AU;}this.id=AU;x.addClass(this.element,this.CSS_CLASS_NAME);x.addClass(this._oAnchor,this.CSS_LABEL_CLASS_NAME);AW=p.length-1;do{Aa=p[AW];AT=this.createEvent(Aa[1]);AT.signature=AK.LIST;this[Aa[0]]=AT;}while(AW--);if(Ab){AX.applyConfig(Ab);}AX.fireQueue();}},_createRootNodeStructure:function(){var AR,AS;if(!C){C=document.createElement(S);C.innerHTML=AF;}AR=C.cloneNode(true);AR.className=this.CSS_CLASS_NAME;AS=AR.firstChild;AS.className=this.CSS_LABEL_CLASS_NAME;this.element=AR;this._oAnchor=AS;},_initSubTree:function(){var AX=this.srcElement,AT=this.cfg,AV,AU,AS,AR,AW;if(AX.childNodes.length>0){if(this.parent.lazyLoad&&this.parent.srcElement&&this.parent.srcElement.tagName.toUpperCase()==r){AT.setProperty(w,{id:x.generateId(),itemdata:AX.childNodes});}else{AV=AX.firstChild;AU=[];do{if(AV&&AV.tagName){switch(AV.tagName.toUpperCase()){case X:AT.setProperty(w,AV);break;case i:AU[AU.length]=AV;break;}}}while((AV=AV.nextSibling));AS=AU.length;if(AS>0){AR=new this.SUBMENU_TYPE(x.generateId());AT.setProperty(w,AR);for(AW=0;AW<AS;AW++){AR.addItem((new AR.ITEM_TYPE(AU[AW])));}}}}},configText:function(Aa,AT,AV){var AS=AT[0],AU=this.cfg,AY=this._oAnchor,AR=AU.getProperty(L),AZ=AJ,AW=AJ,AX=AJ;if(AS){if(AR){AZ=AN+AR+I;}if(AU.getProperty(A)){AW=a;AX=I;}if(AU.getProperty(N)){AW=W;AX=y;}AY.innerHTML=(AW+AS+AX+AZ);}},configHelpText:function(AT,AS,AR){this.cfg.refireEvent(AL);},configURL:function(AT,AS,AR){var AV=AS[0];if(!AV){AV=O;}var AU=this._oAnchor;if(k.opera){AU.removeAttribute(AE);}AU.setAttribute(AE,AV);},configTarget:function(AU,AT,AS){var AR=AT[0],AV=this._oAnchor;if(AR&&AR.length>0){AV.setAttribute(AH,AR);}else{AV.removeAttribute(AH);}},configEmphasis:function(AT,AS,AR){var AV=AS[0],AU=this.cfg;if(AV&&AU.getProperty(N)){AU.setProperty(N,false);}AU.refireEvent(AL);},configStrongEmphasis:function(AU,AT,AS){var AR=AT[0],AV=this.cfg;if(AR&&AV.getProperty(A)){AV.setProperty(A,false);}AV.refireEvent(AL);},configChecked:function(AT,AS,AR){var AV=AS[0],AU=this.cfg;if(AV){g.call(this,b);}else{R.call(this,b);}AU.refireEvent(AL);if(AU.getProperty(H)){AU.refireEvent(H);}if(AU.getProperty(B)){AU.refireEvent(B);}},configDisabled:function(AT,AS,AR){var AV=AS[0],AW=this.cfg,AU=AW.getProperty(w),AX=AW.getProperty(b);if(AV){if(AW.getProperty(B)){AW.setProperty(B,false);}g.call(this,H);if(AU){g.call(this,AI);}if(AX){g.call(this,U);}}else{R.call(this,H);if(AU){R.call(this,AI);}if(AX){R.call(this,U);}}},configSelected:function(AT,AS,AR){var AX=this.cfg,AW=this._oAnchor,AV=AS[0],AY=AX.getProperty(b),AU=AX.getProperty(w);if(k.opera){AW.blur();}if(AV&&!AX.getProperty(H)){g.call(this,B);if(AU){g.call(this,AD);}if(AY){g.call(this,T);}}else{R.call(this,B);if(AU){R.call(this,AD);}if(AY){R.call(this,T);}}if(this.hasFocus()&&k.opera){AW.focus();}},_onSubmenuBeforeHide:function(AU,AT){var AV=this.parent,AR;function AS(){AV._oAnchor.blur();AR.beforeHideEvent.unsubscribe(AS);}if(AV.hasFocus()){AR=AV.parent;AR.beforeHideEvent.subscribe(AS);}},configSubmenu:function(AY,AT,AW){var AV=AT[0],AU=this.cfg,AS=this.parent&&this.parent.lazyLoad,AX,AZ,AR;if(AV){if(AV instanceof AB){AX=AV;AX.parent=this;AX.lazyLoad=AS;}else{if(AQ.isObject(AV)&&AV.id&&!AV.nodeType){AZ=AV.id;AR=AV;AR.lazyload=AS;AR.parent=this;AX=new this.SUBMENU_TYPE(AZ,AR);AU.setProperty(w,AX,true);}else{AX=new this.SUBMENU_TYPE(AV,{lazyload:AS,parent:this});AU.setProperty(w,AX,true);}}if(AX){AX.cfg.setProperty(Y,true);g.call(this,P);if(AU.getProperty(n)===O){AU.setProperty(n,(O+AX.id));}this._oSubmenu=AX;if(k.opera){AX.beforeHideEvent.subscribe(this._onSubmenuBeforeHide);}}}else{R.call(this,P);if(this._oSubmenu){this._oSubmenu.destroy();}}if(AU.getProperty(H)){AU.refireEvent(H);}if(AU.getProperty(B)){AU.refireEvent(B);}},configOnClick:function(AT,AS,AR){var AU=AS[0];if(this._oOnclickAttributeValue&&(this._oOnclickAttributeValue!=AU)){this.clickEvent.unsubscribe(this._oOnclickAttributeValue.fn,this._oOnclickAttributeValue.obj);this._oOnclickAttributeValue=null;}if(!this._oOnclickAttributeValue&&AQ.isObject(AU)&&AQ.isFunction(AU.fn)){this.clickEvent.subscribe(AU.fn,((h in AU)?AU.obj:this),((AG in AU)?AU.scope:null));this._oOnclickAttributeValue=AU;}},configClassName:function(AU,AT,AS){var AR=AT[0];if(this._sClassName){x.removeClass(this.element,this._sClassName);}x.addClass(this.element,AR);this._sClassName=AR;},_dispatchClickEvent:function(){var AS=this,AR;if(!AS.cfg.getProperty(H)){AR=x.getFirstChild(AS.element);this._dispatchDOMClick(AR);}},_dispatchDOMClick:function(AS){var AR;if(k.ie&&k.ie<9){AS.fireEvent(q);}else{if((k.gecko&&k.gecko>=1.9)||k.opera||k.webkit){AR=document.createEvent("HTMLEvents");AR.initEvent(AA,true,true);}else{AR=document.createEvent("MouseEvents");AR.initMouseEvent(AA,true,true,window,0,0,0,0,0,false,false,false,false,0,null);}AS.dispatchEvent(AR);}},_createKeyListener:function(AU,AT,AW){var AV=this,AS=AV.parent;var AR=new YAHOO.util.KeyListener(AS.element.ownerDocument,AW,{fn:AV._dispatchClickEvent,scope:AV,correctScope:true});if(AS.cfg.getProperty(V)){AR.enable();}AS.subscribe(D,AR.enable,null,AR);AS.subscribe(M,AR.disable,null,AR);AV._keyListener=AR;AS.unsubscribe(D,AV._createKeyListener,AW);},configKeyListener:function(AT,AS){var AV=AS[0],AU=this,AR=AU.parent;if(AU._keyData){AR.unsubscribe(D,AU._createKeyListener,AU._keyData);AU._keyData=null;}if(AU._keyListener){AR.unsubscribe(D,AU._keyListener.enable);AR.unsubscribe(M,AU._keyListener.disable);AU._keyListener.disable();AU._keyListener=null;}if(AV){AU._keyData=AV;AR.subscribe(D,AU._createKeyListener,AV,AU);}},initDefaultConfig:function(){var AR=this.cfg;
+AR.addProperty(o.key,{handler:this.configText,value:o.value,validator:o.validator,suppressEvent:o.suppressEvent});AR.addProperty(s.key,{handler:this.configHelpText,supercedes:s.supercedes,suppressEvent:s.suppressEvent});AR.addProperty(G.key,{handler:this.configURL,value:G.value,suppressEvent:G.suppressEvent});AR.addProperty(AO.key,{handler:this.configTarget,suppressEvent:AO.suppressEvent});AR.addProperty(AP.key,{handler:this.configEmphasis,value:AP.value,validator:AP.validator,suppressEvent:AP.suppressEvent,supercedes:AP.supercedes});AR.addProperty(d.key,{handler:this.configStrongEmphasis,value:d.value,validator:d.validator,suppressEvent:d.suppressEvent,supercedes:d.supercedes});AR.addProperty(l.key,{handler:this.configChecked,value:l.value,validator:l.validator,suppressEvent:l.suppressEvent,supercedes:l.supercedes});AR.addProperty(AM.key,{handler:this.configDisabled,value:AM.value,validator:AM.validator,suppressEvent:AM.suppressEvent});AR.addProperty(f.key,{handler:this.configSelected,value:f.value,validator:f.validator,suppressEvent:f.suppressEvent});AR.addProperty(F.key,{handler:this.configSubmenu,supercedes:F.supercedes,suppressEvent:F.suppressEvent});AR.addProperty(u.key,{handler:this.configOnClick,suppressEvent:u.suppressEvent});AR.addProperty(AC.key,{handler:this.configClassName,value:AC.value,validator:AC.validator,suppressEvent:AC.suppressEvent});AR.addProperty(z.key,{handler:this.configKeyListener,value:z.value,suppressEvent:z.suppressEvent});},getNextSibling:function(){var AR=function(AX){return(AX.nodeName.toLowerCase()==="ul");},AV=this.element,AU=x.getNextSibling(AV),AT,AS,AW;if(!AU){AT=AV.parentNode;AS=x.getNextSiblingBy(AT,AR);if(AS){AW=AS;}else{AW=x.getFirstChildBy(AT.parentNode,AR);}AU=x.getFirstChild(AW);}return YAHOO.widget.MenuManager.getMenuItem(AU.id);},getNextEnabledSibling:function(){var AR=this.getNextSibling();return(AR.cfg.getProperty(H)||AR.element.style.display==t)?AR.getNextEnabledSibling():AR;},getPreviousSibling:function(){var AR=function(AX){return(AX.nodeName.toLowerCase()==="ul");},AV=this.element,AU=x.getPreviousSibling(AV),AT,AS,AW;if(!AU){AT=AV.parentNode;AS=x.getPreviousSiblingBy(AT,AR);if(AS){AW=AS;}else{AW=x.getLastChildBy(AT.parentNode,AR);}AU=x.getLastChild(AW);}return YAHOO.widget.MenuManager.getMenuItem(AU.id);},getPreviousEnabledSibling:function(){var AR=this.getPreviousSibling();return(AR.cfg.getProperty(H)||AR.element.style.display==t)?AR.getPreviousEnabledSibling():AR;},focus:function(){var AU=this.parent,AT=this._oAnchor,AR=AU.activeItem;function AS(){try{if(!(k.ie&&!document.hasFocus())){if(AR){AR.blurEvent.fire();}AT.focus();this.focusEvent.fire();}}catch(AV){}}if(!this.cfg.getProperty(H)&&AU&&AU.cfg.getProperty(V)&&this.element.style.display!=t){AQ.later(0,this,AS);}},blur:function(){var AR=this.parent;if(!this.cfg.getProperty(H)&&AR&&AR.cfg.getProperty(V)){AQ.later(0,this,function(){try{this._oAnchor.blur();this.blurEvent.fire();}catch(AS){}},0);}},hasFocus:function(){return(YAHOO.widget.MenuManager.getFocusedMenuItem()==this);},destroy:function(){var AT=this.element,AS,AR,AV,AU;if(AT){AS=this.cfg.getProperty(w);if(AS){AS.destroy();}AR=AT.parentNode;if(AR){AR.removeChild(AT);this.destroyEvent.fire();}AU=p.length-1;do{AV=p[AU];this[AV[0]].unsubscribeAll();}while(AU--);this.cfg.configChangedEvent.unsubscribeAll();}},toString:function(){var AS=m,AR=this.id;if(AR){AS+=(E+AR);}return AS;}};AQ.augmentProto(c,YAHOO.util.EventProvider);})();(function(){var B="xy",C="mousedown",F="ContextMenu",J=" ";YAHOO.widget.ContextMenu=function(L,K){YAHOO.widget.ContextMenu.superclass.constructor.call(this,L,K);};var I=YAHOO.util.Event,E=YAHOO.env.ua,G=YAHOO.widget.ContextMenu,A={"TRIGGER_CONTEXT_MENU":"triggerContextMenu","CONTEXT_MENU":(E.opera?C:"contextmenu"),"CLICK":"click"},H={key:"trigger",suppressEvent:true};function D(L,K,M){this.cfg.setProperty(B,M);this.beforeShowEvent.unsubscribe(D,M);}YAHOO.lang.extend(G,YAHOO.widget.Menu,{_oTrigger:null,_bCancelled:false,contextEventTarget:null,triggerContextMenuEvent:null,init:function(L,K){G.superclass.init.call(this,L);this.beforeInitEvent.fire(G);if(K){this.cfg.applyConfig(K,true);}this.initEvent.fire(G);},initEvents:function(){G.superclass.initEvents.call(this);this.triggerContextMenuEvent=this.createEvent(A.TRIGGER_CONTEXT_MENU);this.triggerContextMenuEvent.signature=YAHOO.util.CustomEvent.LIST;},cancel:function(){this._bCancelled=true;},_removeEventHandlers:function(){var K=this._oTrigger;if(K){I.removeListener(K,A.CONTEXT_MENU,this._onTriggerContextMenu);if(E.opera){I.removeListener(K,A.CLICK,this._onTriggerClick);}}},_onTriggerClick:function(L,K){if(L.ctrlKey){I.stopEvent(L);}},_onTriggerContextMenu:function(M,K){var L;if(!(M.type==C&&!M.ctrlKey)){this.contextEventTarget=I.getTarget(M);this.triggerContextMenuEvent.fire(M);if(!this._bCancelled){I.stopEvent(M);YAHOO.widget.MenuManager.hideVisible();L=I.getXY(M);if(!YAHOO.util.Dom.inDocument(this.element)){this.beforeShowEvent.subscribe(D,L);}else{this.cfg.setProperty(B,L);}this.show();}this._bCancelled=false;}},toString:function(){var L=F,K=this.id;if(K){L+=(J+K);}return L;},initDefaultConfig:function(){G.superclass.initDefaultConfig.call(this);this.cfg.addProperty(H.key,{handler:this.configTrigger,suppressEvent:H.suppressEvent});},destroy:function(K){this._removeEventHandlers();G.superclass.destroy.call(this,K);},configTrigger:function(L,K,N){var M=K[0];if(M){if(this._oTrigger){this._removeEventHandlers();}this._oTrigger=M;I.on(M,A.CONTEXT_MENU,this._onTriggerContextMenu,this,true);if(E.opera){I.on(M,A.CLICK,this._onTriggerClick,this,true);}}else{this._removeEventHandlers();}}});}());YAHOO.widget.ContextMenuItem=YAHOO.widget.MenuItem;(function(){var D=YAHOO.lang,N="static",M="dynamic,"+N,A="disabled",F="selected",B="autosubmenudisplay",G="submenu",C="visible",Q=" ",H="submenutoggleregion",P="MenuBar";YAHOO.widget.MenuBar=function(T,S){YAHOO.widget.MenuBar.superclass.constructor.call(this,T,S);};function O(T){var S=false;if(D.isString(T)){S=(M.indexOf((T.toLowerCase()))!=-1);
+}return S;}var R=YAHOO.util.Event,L=YAHOO.widget.MenuBar,K={key:"position",value:N,validator:O,supercedes:[C]},E={key:"submenualignment",value:["tl","bl"]},J={key:B,value:false,validator:D.isBoolean,suppressEvent:true},I={key:H,value:false,validator:D.isBoolean};D.extend(L,YAHOO.widget.Menu,{init:function(T,S){if(!this.ITEM_TYPE){this.ITEM_TYPE=YAHOO.widget.MenuBarItem;}L.superclass.init.call(this,T);this.beforeInitEvent.fire(L);if(S){this.cfg.applyConfig(S,true);}this.initEvent.fire(L);},CSS_CLASS_NAME:"yuimenubar",SUBMENU_TOGGLE_REGION_WIDTH:20,_onKeyDown:function(U,T,Y){var S=T[0],Z=T[1],W,X,V;if(Z&&!Z.cfg.getProperty(A)){X=Z.cfg;switch(S.keyCode){case 37:case 39:if(Z==this.activeItem&&!X.getProperty(F)){X.setProperty(F,true);}else{V=(S.keyCode==37)?Z.getPreviousEnabledSibling():Z.getNextEnabledSibling();if(V){this.clearActiveItem();V.cfg.setProperty(F,true);W=V.cfg.getProperty(G);if(W){W.show();W.setInitialFocus();}else{V.focus();}}}R.preventDefault(S);break;case 40:if(this.activeItem!=Z){this.clearActiveItem();X.setProperty(F,true);Z.focus();}W=X.getProperty(G);if(W){if(W.cfg.getProperty(C)){W.setInitialSelection();W.setInitialFocus();}else{W.show();W.setInitialFocus();}}R.preventDefault(S);break;}}if(S.keyCode==27&&this.activeItem){W=this.activeItem.cfg.getProperty(G);if(W&&W.cfg.getProperty(C)){W.hide();this.activeItem.focus();}else{this.activeItem.cfg.setProperty(F,false);this.activeItem.blur();}R.preventDefault(S);}},_onClick:function(e,Y,b){L.superclass._onClick.call(this,e,Y,b);var d=Y[1],T=true,S,f,U,W,Z,a,c,V;var X=function(){if(a.cfg.getProperty(C)){a.hide();}else{a.show();}};if(d&&!d.cfg.getProperty(A)){f=Y[0];U=R.getTarget(f);W=this.activeItem;Z=this.cfg;if(W&&W!=d){this.clearActiveItem();}d.cfg.setProperty(F,true);a=d.cfg.getProperty(G);if(a){S=d.element;c=YAHOO.util.Dom.getX(S);V=c+(S.offsetWidth-this.SUBMENU_TOGGLE_REGION_WIDTH);if(Z.getProperty(H)){if(R.getPageX(f)>V){X();R.preventDefault(f);T=false;}}else{X();}}}return T;},configSubmenuToggle:function(U,T){var S=T[0];if(S){this.cfg.setProperty(B,false);}},toString:function(){var T=P,S=this.id;if(S){T+=(Q+S);}return T;},initDefaultConfig:function(){L.superclass.initDefaultConfig.call(this);var S=this.cfg;S.addProperty(K.key,{handler:this.configPosition,value:K.value,validator:K.validator,supercedes:K.supercedes});S.addProperty(E.key,{value:E.value,suppressEvent:E.suppressEvent});S.addProperty(J.key,{value:J.value,validator:J.validator,suppressEvent:J.suppressEvent});S.addProperty(I.key,{value:I.value,validator:I.validator,handler:this.configSubmenuToggle});}});}());YAHOO.widget.MenuBarItem=function(B,A){YAHOO.widget.MenuBarItem.superclass.constructor.call(this,B,A);};YAHOO.lang.extend(YAHOO.widget.MenuBarItem,YAHOO.widget.MenuItem,{init:function(B,A){if(!this.SUBMENU_TYPE){this.SUBMENU_TYPE=YAHOO.widget.Menu;}YAHOO.widget.MenuBarItem.superclass.init.call(this,B);var C=this.cfg;if(A){C.applyConfig(A,true);}C.fireQueue();},CSS_CLASS_NAME:"yuimenubaritem",CSS_LABEL_CLASS_NAME:"yuimenubaritemlabel",toString:function(){var A="MenuBarItem";if(this.cfg&&this.cfg.getProperty("text")){A+=(": "+this.cfg.getProperty("text"));}return A;}});YAHOO.register("menu",YAHOO.widget.Menu,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/paginator/paginator-min.js b/js/yui/paginator/paginator-min.js
new file mode 100644 (file)
index 0000000..fdf70c6
--- /dev/null
+++ b/js/yui/paginator/paginator-min.js
@@ -0,0 +1,11 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){var d=YAHOO.util.Dom,f=YAHOO.lang,b=f.isObject,e=f.isFunction,c=f.isArray,a=f.isString;function g(k){var n=g.VALUE_UNLIMITED,l,h,i,j,m;k=b(k)?k:{};this.initConfig();this.initEvents();this.set("rowsPerPage",k.rowsPerPage,true);if(g.isNumeric(k.totalRecords)){this.set("totalRecords",k.totalRecords,true);}this.initUIComponents();for(l in k){if(k.hasOwnProperty(l)){this.set(l,k[l],true);}}h=this.get("initialPage");i=this.get("totalRecords");j=this.get("rowsPerPage");if(h>1&&j!==n){m=(h-1)*j;if(i===n||m<i){this.set("recordOffset",m,true);}}}f.augmentObject(g,{id:0,ID_BASE:"yui-pg",VALUE_UNLIMITED:-1,TEMPLATE_DEFAULT:"{FirstPageLink} {PreviousPageLink} {PageLinks} {NextPageLink} {LastPageLink}",TEMPLATE_ROWS_PER_PAGE:"{FirstPageLink} {PreviousPageLink} {PageLinks} {NextPageLink} {LastPageLink} {RowsPerPageDropdown}",ui:{},isNumeric:function(h){return isFinite(+h);},toNumber:function(h){return isFinite(+h)?+h:null;}},true);g.prototype={_containers:[],_batch:false,_pageChanged:false,_state:null,initConfig:function(){var h=g.VALUE_UNLIMITED;this.setAttributeConfig("rowsPerPage",{value:0,validator:g.isNumeric,setter:g.toNumber});this.setAttributeConfig("containers",{value:null,validator:function(l){if(!c(l)){l=[l];}for(var k=0,j=l.length;k<j;++k){if(a(l[k])||(b(l[k])&&l[k].nodeType===1)){continue;}return false;}return true;},method:function(i){i=d.get(i);if(!c(i)){i=[i];}this._containers=i;}});this.setAttributeConfig("totalRecords",{value:0,validator:g.isNumeric,setter:g.toNumber});this.setAttributeConfig("recordOffset",{value:0,validator:function(j){var i=this.get("totalRecords");if(g.isNumeric(j)){j=+j;return i===h||i>j||(i===0&&j===0);}return false;},setter:g.toNumber});this.setAttributeConfig("initialPage",{value:1,validator:g.isNumeric,setter:g.toNumber});this.setAttributeConfig("template",{value:g.TEMPLATE_DEFAULT,validator:a});this.setAttributeConfig("containerClass",{value:"yui-pg-container",validator:a});this.setAttributeConfig("alwaysVisible",{value:true,validator:f.isBoolean});this.setAttributeConfig("updateOnChange",{value:false,validator:f.isBoolean});this.setAttributeConfig("id",{value:g.id++,readOnly:true});this.setAttributeConfig("rendered",{value:false,readOnly:true});},initUIComponents:function(){var j=g.ui,i,h;for(i in j){if(j.hasOwnProperty(i)){h=j[i];if(b(h)&&e(h.init)){h.init(this);}}}},initEvents:function(){this.createEvent("render");this.createEvent("rendered");this.createEvent("changeRequest");this.createEvent("pageChange");this.createEvent("beforeDestroy");this.createEvent("destroy");this._selfSubscribe();},_selfSubscribe:function(){this.subscribe("totalRecordsChange",this.updateVisibility,this,true);this.subscribe("alwaysVisibleChange",this.updateVisibility,this,true);this.subscribe("totalRecordsChange",this._handleStateChange,this,true);this.subscribe("recordOffsetChange",this._handleStateChange,this,true);this.subscribe("rowsPerPageChange",this._handleStateChange,this,true);this.subscribe("totalRecordsChange",this._syncRecordOffset,this,true);},_syncRecordOffset:function(k){var h=k.newValue,j,i;if(k.prevValue!==h){if(h!==g.VALUE_UNLIMITED){j=this.get("rowsPerPage");if(j&&this.get("recordOffset")>=h){i=this.getState({totalRecords:k.prevValue,recordOffset:this.get("recordOffset")});this.set("recordOffset",i.before.recordOffset);this._firePageChange(i);}}}},_handleStateChange:function(i){if(i.prevValue!==i.newValue){var j=this._state||{},h;j[i.type.replace(/Change$/,"")]=i.prevValue;h=this.getState(j);if(h.page!==h.before.page){if(this._batch){this._pageChanged=true;}else{this._firePageChange(h);}}}},_firePageChange:function(h){if(b(h)){var i=h.before;delete h.before;this.fireEvent("pageChange",{type:"pageChange",prevValue:h.page,newValue:i.page,prevState:h,newState:i});}},render:function(){if(this.get("rendered")){return this;}var l=this.get("template"),m=this.getState(),k=g.ID_BASE+this.get("id")+"-",j,h;for(j=0,h=this._containers.length;j<h;++j){this._renderTemplate(this._containers[j],l,k+j,true);}this.updateVisibility();if(this._containers.length){this.setAttributeConfig("rendered",{value:true});this.fireEvent("render",m);this.fireEvent("rendered",m);}return this;},_renderTemplate:function(j,n,m,l){var p=this.get("containerClass"),o,k,h;if(!j){return;}d.setStyle(j,"display","none");d.addClass(j,p);j.innerHTML=n.replace(/\{([a-z0-9_ \-]+)\}/gi,'<span class="yui-pg-ui yui-pg-ui-$1"></span>');o=d.getElementsByClassName("yui-pg-ui","span",j);for(k=0,h=o.length;k<h;++k){this.renderUIComponent(o[k],m);}if(!l){d.setStyle(j,"display","");}},renderUIComponent:function(h,m){var l=h.parentNode,k=/yui-pg-ui-(\w+)/.exec(h.className),j=k&&g.ui[k[1]],i;if(e(j)){i=new j(this);if(e(i.render)){l.replaceChild(i.render(m),h);}}return this;},destroy:function(){this.fireEvent("beforeDestroy");this.fireEvent("destroy");this.setAttributeConfig("rendered",{value:false});this.unsubscribeAll();},updateVisibility:function(m){var p=this.get("alwaysVisible"),n,j,q,o,k,l,h;if(!m||m.type==="alwaysVisibleChange"||!p){n=this.get("totalRecords");j=true;q=this.get("rowsPerPage");o=this.get("rowsPerPageOptions");if(c(o)){for(k=0,l=o.length;k<l;++k){h=o[k];if(f.isNumber(h||h.value)){q=Math.min(q,(h.value||h));}}}if(n!==g.VALUE_UNLIMITED&&n<=q){j=false;}j=j||p;for(k=0,l=this._containers.length;k<l;++k){d.setStyle(this._containers[k],"display",j?"":"none");}}},getContainerNodes:function(){return this._containers;},getTotalPages:function(){var h=this.get("totalRecords"),i=this.get("rowsPerPage");if(!i){return null;}if(h===g.VALUE_UNLIMITED){return g.VALUE_UNLIMITED;}return Math.ceil(h/i);},hasPage:function(i){if(!f.isNumber(i)||i<1){return false;}var h=this.getTotalPages();return(h===g.VALUE_UNLIMITED||h>=i);},getCurrentPage:function(){var h=this.get("rowsPerPage");if(!h||!this.get("totalRecords")){return 0;}return Math.floor(this.get("recordOffset")/h)+1;},hasNextPage:function(){var h=this.getCurrentPage(),i=this.getTotalPages();return h&&(i===g.VALUE_UNLIMITED||h<i);},getNextPage:function(){return this.hasNextPage()?this.getCurrentPage()+1:null;
+},hasPreviousPage:function(){return(this.getCurrentPage()>1);},getPreviousPage:function(){return(this.hasPreviousPage()?this.getCurrentPage()-1:1);},getPageRecords:function(k){if(!f.isNumber(k)){k=this.getCurrentPage();}var j=this.get("rowsPerPage"),i=this.get("totalRecords"),l,h;if(!k||!j){return null;}l=(k-1)*j;if(i!==g.VALUE_UNLIMITED){if(l>=i){return null;}h=Math.min(l+j,i)-1;}else{h=l+j-1;}return[l,h];},setPage:function(i,h){if(this.hasPage(i)&&i!==this.getCurrentPage()){if(this.get("updateOnChange")||h){this.set("recordOffset",(i-1)*this.get("rowsPerPage"));}else{this.fireEvent("changeRequest",this.getState({"page":i}));}}},getRowsPerPage:function(){return this.get("rowsPerPage");},setRowsPerPage:function(i,h){if(g.isNumeric(i)&&+i>0&&+i!==this.get("rowsPerPage")){if(this.get("updateOnChange")||h){this.set("rowsPerPage",i);}else{this.fireEvent("changeRequest",this.getState({"rowsPerPage":+i}));}}},getTotalRecords:function(){return this.get("totalRecords");},setTotalRecords:function(i,h){if(g.isNumeric(i)&&+i>=0&&+i!==this.get("totalRecords")){if(this.get("updateOnChange")||h){this.set("totalRecords",i);}else{this.fireEvent("changeRequest",this.getState({"totalRecords":+i}));}}},getStartIndex:function(){return this.get("recordOffset");},setStartIndex:function(i,h){if(g.isNumeric(i)&&+i>=0&&+i!==this.get("recordOffset")){if(this.get("updateOnChange")||h){this.set("recordOffset",i);}else{this.fireEvent("changeRequest",this.getState({"recordOffset":+i}));}}},getState:function(n){var p=g.VALUE_UNLIMITED,l=Math,m=l.max,o=l.ceil,j,h,k;function i(s,q,r){if(s<=0||q===0){return 0;}if(q===p||q>s){return s-(s%r);}return q-(q%r||r);}j={paginator:this,totalRecords:this.get("totalRecords"),rowsPerPage:this.get("rowsPerPage"),records:this.getPageRecords()};j.recordOffset=i(this.get("recordOffset"),j.totalRecords,j.rowsPerPage);j.page=o(j.recordOffset/j.rowsPerPage)+1;if(!n){return j;}h={paginator:this,before:j,rowsPerPage:n.rowsPerPage||j.rowsPerPage,totalRecords:(g.isNumeric(n.totalRecords)?m(n.totalRecords,p):+j.totalRecords)};if(h.totalRecords===0){h.recordOffset=h.page=0;}else{k=g.isNumeric(n.page)?(n.page-1)*h.rowsPerPage:g.isNumeric(n.recordOffset)?+n.recordOffset:j.recordOffset;h.recordOffset=i(k,h.totalRecords,h.rowsPerPage);h.page=o(h.recordOffset/h.rowsPerPage)+1;}h.records=[h.recordOffset,h.recordOffset+h.rowsPerPage-1];if(h.totalRecords!==p&&h.recordOffset<h.totalRecords&&h.records&&h.records[1]>h.totalRecords-1){h.records[1]=h.totalRecords-1;}return h;},setState:function(i){if(b(i)){this._state=this.getState({});i={page:i.page,rowsPerPage:i.rowsPerPage,totalRecords:i.totalRecords,recordOffset:i.recordOffset};if(i.page&&i.recordOffset===undefined){i.recordOffset=(i.page-1)*(i.rowsPerPage||this.get("rowsPerPage"));}this._batch=true;this._pageChanged=false;for(var h in i){if(i.hasOwnProperty(h)&&this._configs.hasOwnProperty(h)){this.set(h,i[h]);}}this._batch=false;if(this._pageChanged){this._pageChanged=false;this._firePageChange(this.getState(this._state));}}}};f.augmentProto(g,YAHOO.util.AttributeProvider);YAHOO.widget.Paginator=g;})();(function(){var c=YAHOO.widget.Paginator,b=YAHOO.lang,a=YAHOO.util.Dom.generateId;c.ui.CurrentPageReport=function(d){this.paginator=d;d.subscribe("recordOffsetChange",this.update,this,true);d.subscribe("rowsPerPageChange",this.update,this,true);d.subscribe("totalRecordsChange",this.update,this,true);d.subscribe("pageReportTemplateChange",this.update,this,true);d.subscribe("destroy",this.destroy,this,true);d.subscribe("pageReportClassChange",this.update,this,true);};c.ui.CurrentPageReport.init=function(d){d.setAttributeConfig("pageReportClass",{value:"yui-pg-current",validator:b.isString});d.setAttributeConfig("pageReportTemplate",{value:"({currentPage} of {totalPages})",validator:b.isString});d.setAttributeConfig("pageReportValueGenerator",{value:function(g){var f=g.getCurrentPage(),e=g.getPageRecords();return{"currentPage":e?f:0,"totalPages":g.getTotalPages(),"startIndex":e?e[0]:0,"endIndex":e?e[1]:0,"startRecord":e?e[0]+1:0,"endRecord":e?e[1]+1:0,"totalRecords":g.get("totalRecords")};},validator:b.isFunction});};c.ui.CurrentPageReport.sprintf=function(e,d){return e.replace(/\{([\w\s\-]+)\}/g,function(f,g){return(g in d)?d[g]:"";});};c.ui.CurrentPageReport.prototype={span:null,render:function(d){this.span=document.createElement("span");this.span.className=this.paginator.get("pageReportClass");a(this.span,d+"-page-report");this.update();return this.span;},update:function(d){if(d&&d.prevValue===d.newValue){return;}this.span.innerHTML=c.ui.CurrentPageReport.sprintf(this.paginator.get("pageReportTemplate"),this.paginator.get("pageReportValueGenerator")(this.paginator));},destroy:function(){this.span.parentNode.removeChild(this.span);this.span=null;}};})();(function(){var c=YAHOO.widget.Paginator,b=YAHOO.lang,a=YAHOO.util.Dom.generateId;c.ui.PageLinks=function(d){this.paginator=d;d.subscribe("recordOffsetChange",this.update,this,true);d.subscribe("rowsPerPageChange",this.update,this,true);d.subscribe("totalRecordsChange",this.update,this,true);d.subscribe("pageLinksChange",this.rebuild,this,true);d.subscribe("pageLinkClassChange",this.rebuild,this,true);d.subscribe("currentPageClassChange",this.rebuild,this,true);d.subscribe("destroy",this.destroy,this,true);d.subscribe("pageLinksContainerClassChange",this.rebuild,this,true);};c.ui.PageLinks.init=function(d){d.setAttributeConfig("pageLinkClass",{value:"yui-pg-page",validator:b.isString});d.setAttributeConfig("currentPageClass",{value:"yui-pg-current-page",validator:b.isString});d.setAttributeConfig("pageLinksContainerClass",{value:"yui-pg-pages",validator:b.isString});d.setAttributeConfig("pageLinks",{value:10,validator:c.isNumeric});d.setAttributeConfig("pageLabelBuilder",{value:function(e,f){return e;},validator:b.isFunction});d.setAttributeConfig("pageTitleBuilder",{value:function(e,f){return"Page "+e;},validator:b.isFunction});};c.ui.PageLinks.calculateRange=function(f,g,e){var j=c.VALUE_UNLIMITED,i,d,h;if(!f||e===0||g===0||(g===j&&e===j)){return[0,-1];
+}if(g!==j){e=e===j?g:Math.min(e,g);}i=Math.max(1,Math.ceil(f-(e/2)));if(g===j){d=i+e-1;}else{d=Math.min(g,i+e-1);}h=e-(d-i+1);i=Math.max(1,i-h);return[i,d];};c.ui.PageLinks.prototype={current:0,container:null,render:function(d){var e=this.paginator;this.container=document.createElement("span");a(this.container,d+"-pages");this.container.className=e.get("pageLinksContainerClass");YAHOO.util.Event.on(this.container,"click",this.onClick,this,true);this.update({newValue:null,rebuild:true});return this.container;},update:function(q){if(q&&q.prevValue===q.newValue){return;}var g=this.paginator,m=g.getCurrentPage();if(this.current!==m||!m||q.rebuild){var r=g.get("pageLabelBuilder"),l=g.get("pageTitleBuilder"),k=c.ui.PageLinks.calculateRange(m,g.getTotalPages(),g.get("pageLinks")),f=k[0],h=k[1],o="",d,j,n;d='<a href="#" class="{class}" page="{page}" title="{title}">{label}</a>';n='<span class="{class}">{label}</span>';for(j=f;j<=h;++j){if(j===m){o+=b.substitute(n,{"class":g.get("currentPageClass")+" "+g.get("pageLinkClass"),"label":r(j,g)});}else{o+=b.substitute(d,{"class":g.get("pageLinkClass"),"page":j,"label":r(j,g),"title":l(j,g)});}}this.container.innerHTML=o;}},rebuild:function(d){d.rebuild=true;this.update(d);},destroy:function(){YAHOO.util.Event.purgeElement(this.container,true);this.container.parentNode.removeChild(this.container);this.container=null;},onClick:function(f){var d=YAHOO.util.Event.getTarget(f);if(d&&YAHOO.util.Dom.hasClass(d,this.paginator.get("pageLinkClass"))){YAHOO.util.Event.stopEvent(f);this.paginator.setPage(parseInt(d.getAttribute("page"),10));}}};})();(function(){var c=YAHOO.widget.Paginator,b=YAHOO.lang,a=YAHOO.util.Dom.generateId;c.ui.FirstPageLink=function(d){this.paginator=d;d.subscribe("recordOffsetChange",this.update,this,true);d.subscribe("rowsPerPageChange",this.update,this,true);d.subscribe("totalRecordsChange",this.update,this,true);d.subscribe("destroy",this.destroy,this,true);d.subscribe("firstPageLinkLabelChange",this.update,this,true);d.subscribe("firstPageLinkClassChange",this.update,this,true);};c.ui.FirstPageLink.init=function(d){d.setAttributeConfig("firstPageLinkLabel",{value:"&lt;&lt; first",validator:b.isString});d.setAttributeConfig("firstPageLinkClass",{value:"yui-pg-first",validator:b.isString});d.setAttributeConfig("firstPageLinkTitle",{value:"First Page",validator:b.isString});};c.ui.FirstPageLink.prototype={current:null,link:null,span:null,render:function(e){var f=this.paginator,h=f.get("firstPageLinkClass"),d=f.get("firstPageLinkLabel"),g=f.get("firstPageLinkTitle");this.link=document.createElement("a");this.span=document.createElement("span");a(this.link,e+"-first-link");this.link.href="#";this.link.className=h;this.link.innerHTML=d;this.link.title=g;YAHOO.util.Event.on(this.link,"click",this.onClick,this,true);a(this.span,e+"-first-span");this.span.className=h;this.span.innerHTML=d;this.current=f.getCurrentPage()>1?this.link:this.span;return this.current;},update:function(f){if(f&&f.prevValue===f.newValue){return;}var d=this.current?this.current.parentNode:null;if(this.paginator.getCurrentPage()>1){if(d&&this.current===this.span){d.replaceChild(this.link,this.current);this.current=this.link;}}else{if(d&&this.current===this.link){d.replaceChild(this.span,this.current);this.current=this.span;}}},destroy:function(){YAHOO.util.Event.purgeElement(this.link);this.current.parentNode.removeChild(this.current);this.link=this.span=null;},onClick:function(d){YAHOO.util.Event.stopEvent(d);this.paginator.setPage(1);}};})();(function(){var c=YAHOO.widget.Paginator,b=YAHOO.lang,a=YAHOO.util.Dom.generateId;c.ui.LastPageLink=function(d){this.paginator=d;d.subscribe("recordOffsetChange",this.update,this,true);d.subscribe("rowsPerPageChange",this.update,this,true);d.subscribe("totalRecordsChange",this.update,this,true);d.subscribe("destroy",this.destroy,this,true);d.subscribe("lastPageLinkLabelChange",this.update,this,true);d.subscribe("lastPageLinkClassChange",this.update,this,true);};c.ui.LastPageLink.init=function(d){d.setAttributeConfig("lastPageLinkLabel",{value:"last &gt;&gt;",validator:b.isString});d.setAttributeConfig("lastPageLinkClass",{value:"yui-pg-last",validator:b.isString});d.setAttributeConfig("lastPageLinkTitle",{value:"Last Page",validator:b.isString});};c.ui.LastPageLink.prototype={current:null,link:null,span:null,na:null,render:function(e){var g=this.paginator,i=g.get("lastPageLinkClass"),d=g.get("lastPageLinkLabel"),f=g.getTotalPages(),h=g.get("lastPageLinkTitle");this.link=document.createElement("a");this.span=document.createElement("span");this.na=this.span.cloneNode(false);a(this.link,e+"-last-link");this.link.href="#";this.link.className=i;this.link.innerHTML=d;this.link.title=h;YAHOO.util.Event.on(this.link,"click",this.onClick,this,true);a(this.span,e+"-last-span");this.span.className=i;this.span.innerHTML=d;a(this.na,e+"-last-na");switch(f){case c.VALUE_UNLIMITED:this.current=this.na;break;case g.getCurrentPage():this.current=this.span;break;default:this.current=this.link;}return this.current;},update:function(f){if(f&&f.prevValue===f.newValue){return;}var d=this.current?this.current.parentNode:null,g=this.link;if(d){switch(this.paginator.getTotalPages()){case c.VALUE_UNLIMITED:g=this.na;break;case this.paginator.getCurrentPage():g=this.span;break;}if(this.current!==g){d.replaceChild(g,this.current);this.current=g;}}},destroy:function(){YAHOO.util.Event.purgeElement(this.link);this.current.parentNode.removeChild(this.current);this.link=this.span=null;},onClick:function(d){YAHOO.util.Event.stopEvent(d);this.paginator.setPage(this.paginator.getTotalPages());}};})();(function(){var c=YAHOO.widget.Paginator,b=YAHOO.lang,a=YAHOO.util.Dom.generateId;c.ui.NextPageLink=function(d){this.paginator=d;d.subscribe("recordOffsetChange",this.update,this,true);d.subscribe("rowsPerPageChange",this.update,this,true);d.subscribe("totalRecordsChange",this.update,this,true);d.subscribe("destroy",this.destroy,this,true);d.subscribe("nextPageLinkLabelChange",this.update,this,true);
+d.subscribe("nextPageLinkClassChange",this.update,this,true);};c.ui.NextPageLink.init=function(d){d.setAttributeConfig("nextPageLinkLabel",{value:"next &gt;",validator:b.isString});d.setAttributeConfig("nextPageLinkClass",{value:"yui-pg-next",validator:b.isString});d.setAttributeConfig("nextPageLinkTitle",{value:"Next Page",validator:b.isString});};c.ui.NextPageLink.prototype={current:null,link:null,span:null,render:function(e){var g=this.paginator,i=g.get("nextPageLinkClass"),d=g.get("nextPageLinkLabel"),f=g.getTotalPages(),h=g.get("nextPageLinkTitle");this.link=document.createElement("a");this.span=document.createElement("span");a(this.link,e+"-next-link");this.link.href="#";this.link.className=i;this.link.innerHTML=d;this.link.title=h;YAHOO.util.Event.on(this.link,"click",this.onClick,this,true);a(this.span,e+"-next-span");this.span.className=i;this.span.innerHTML=d;this.current=g.getCurrentPage()===f?this.span:this.link;return this.current;},update:function(g){if(g&&g.prevValue===g.newValue){return;}var f=this.paginator.getTotalPages(),d=this.current?this.current.parentNode:null;if(this.paginator.getCurrentPage()!==f){if(d&&this.current===this.span){d.replaceChild(this.link,this.current);this.current=this.link;}}else{if(this.current===this.link){if(d){d.replaceChild(this.span,this.current);this.current=this.span;}}}},destroy:function(){YAHOO.util.Event.purgeElement(this.link);this.current.parentNode.removeChild(this.current);this.link=this.span=null;},onClick:function(d){YAHOO.util.Event.stopEvent(d);this.paginator.setPage(this.paginator.getNextPage());}};})();(function(){var c=YAHOO.widget.Paginator,b=YAHOO.lang,a=YAHOO.util.Dom.generateId;c.ui.PreviousPageLink=function(d){this.paginator=d;d.subscribe("recordOffsetChange",this.update,this,true);d.subscribe("rowsPerPageChange",this.update,this,true);d.subscribe("totalRecordsChange",this.update,this,true);d.subscribe("destroy",this.destroy,this,true);d.subscribe("previousPageLinkLabelChange",this.update,this,true);d.subscribe("previousPageLinkClassChange",this.update,this,true);};c.ui.PreviousPageLink.init=function(d){d.setAttributeConfig("previousPageLinkLabel",{value:"&lt; prev",validator:b.isString});d.setAttributeConfig("previousPageLinkClass",{value:"yui-pg-previous",validator:b.isString});d.setAttributeConfig("previousPageLinkTitle",{value:"Previous Page",validator:b.isString});};c.ui.PreviousPageLink.prototype={current:null,link:null,span:null,render:function(e){var f=this.paginator,h=f.get("previousPageLinkClass"),d=f.get("previousPageLinkLabel"),g=f.get("previousPageLinkTitle");this.link=document.createElement("a");this.span=document.createElement("span");a(this.link,e+"-prev-link");this.link.href="#";this.link.className=h;this.link.innerHTML=d;this.link.title=g;YAHOO.util.Event.on(this.link,"click",this.onClick,this,true);a(this.span,e+"-prev-span");this.span.className=h;this.span.innerHTML=d;this.current=f.getCurrentPage()>1?this.link:this.span;return this.current;},update:function(f){if(f&&f.prevValue===f.newValue){return;}var d=this.current?this.current.parentNode:null;if(this.paginator.getCurrentPage()>1){if(d&&this.current===this.span){d.replaceChild(this.link,this.current);this.current=this.link;}}else{if(d&&this.current===this.link){d.replaceChild(this.span,this.current);this.current=this.span;}}},destroy:function(){YAHOO.util.Event.purgeElement(this.link);this.current.parentNode.removeChild(this.current);this.link=this.span=null;},onClick:function(d){YAHOO.util.Event.stopEvent(d);this.paginator.setPage(this.paginator.getPreviousPage());}};})();(function(){var c=YAHOO.widget.Paginator,b=YAHOO.lang,a=YAHOO.util.Dom.generateId;c.ui.RowsPerPageDropdown=function(d){this.paginator=d;d.subscribe("rowsPerPageChange",this.update,this,true);d.subscribe("rowsPerPageOptionsChange",this.rebuild,this,true);d.subscribe("totalRecordsChange",this._handleTotalRecordsChange,this,true);d.subscribe("destroy",this.destroy,this,true);d.subscribe("rowsPerPageDropdownClassChange",this.rebuild,this,true);};c.ui.RowsPerPageDropdown.init=function(d){d.setAttributeConfig("rowsPerPageOptions",{value:[],validator:b.isArray});d.setAttributeConfig("rowsPerPageDropdownClass",{value:"yui-pg-rpp-options",validator:b.isString});};c.ui.RowsPerPageDropdown.prototype={select:null,all:null,render:function(d){this.select=document.createElement("select");a(this.select,d+"-rpp");this.select.className=this.paginator.get("rowsPerPageDropdownClass");this.select.title="Rows per page";YAHOO.util.Event.on(this.select,"change",this.onChange,this,true);this.rebuild();return this.select;},rebuild:function(m){var d=this.paginator,g=this.select,n=d.get("rowsPerPageOptions"),f,l,h,j,k;this.all=null;for(j=0,k=n.length;j<k;++j){l=n[j];f=g.options[j]||g.appendChild(document.createElement("option"));h=b.isValue(l.value)?l.value:l;f.text=b.isValue(l.text)?l.text:l;if(b.isString(h)&&h.toLowerCase()==="all"){this.all=f;f.value=d.get("totalRecords");}else{f.value=h;}}while(g.options.length>n.length){g.removeChild(g.firstChild);}this.update();},update:function(j){if(j&&j.prevValue===j.newValue){return;}var h=this.paginator.get("rowsPerPage")+"",f=this.select.options,g,d;for(g=0,d=f.length;g<d;++g){if(f[g].value===h){f[g].selected=true;break;}}},onChange:function(d){this.paginator.setRowsPerPage(parseInt(this.select.options[this.select.selectedIndex].value,10));},_handleTotalRecordsChange:function(d){if(!this.all||(d&&d.prevValue===d.newValue)){return;}this.all.value=d.newValue;if(this.all.selected){this.paginator.set("rowsPerPage",d.newValue);}},destroy:function(){YAHOO.util.Event.purgeElement(this.select);this.select.parentNode.removeChild(this.select);this.select=null;}};})();(function(){var c=YAHOO.widget.Paginator,b=YAHOO.lang,a=YAHOO.util.Dom.generateId;c.ui.JumpToPageDropdown=function(d){this.paginator=d;d.subscribe("rowsPerPageChange",this.rebuild,this,true);d.subscribe("rowsPerPageOptionsChange",this.rebuild,this,true);d.subscribe("pageChange",this.update,this,true);d.subscribe("totalRecordsChange",this.rebuild,this,true);
+d.subscribe("destroy",this.destroy,this,true);};c.ui.JumpToPageDropdown.init=function(d){d.setAttributeConfig("jumpToPageDropdownClass",{value:"yui-pg-jtp-options",validator:b.isString});};c.ui.JumpToPageDropdown.prototype={select:null,render:function(d){this.select=document.createElement("select");a(this.select,d+"-jtp");this.select.className=this.paginator.get("jumpToPageDropdownClass");this.select.title="Jump to page";YAHOO.util.Event.on(this.select,"change",this.onChange,this,true);this.rebuild();return this.select;},rebuild:function(l){var k=this.paginator,j=this.select,f=k.getTotalPages(),h,g,d;this.all=null;for(g=0,d=f;g<d;++g){h=j.options[g]||j.appendChild(document.createElement("option"));h.innerHTML=g+1;h.value=g+1;}for(g=f,d=j.options.length;g<d;g++){j.removeChild(j.lastChild);}this.update();},update:function(j){if(j&&j.prevValue===j.newValue){return;}var h=this.paginator.getCurrentPage()+"",f=this.select.options,g,d;for(g=0,d=f.length;g<d;++g){if(f[g].value===h){f[g].selected=true;break;}}},onChange:function(d){this.paginator.setPage(parseInt(this.select.options[this.select.selectedIndex].value,false));},destroy:function(){YAHOO.util.Event.purgeElement(this.select);this.select.parentNode.removeChild(this.select);this.select=null;}};})();YAHOO.register("paginator",YAHOO.widget.Paginator,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/profiler/profiler-min.js b/js/yui/profiler/profiler-min.js
new file mode 100644 (file)
index 0000000..fdb58cc
--- /dev/null
+++ b/js/yui/profiler/profiler-min.js
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.namespace("tool");YAHOO.tool.Profiler=function(){var container={},report={},stopwatches={},WATCH_STARTED=0,WATCH_STOPPED=1,WATCH_PAUSED=2,lang=YAHOO.lang;function createReport(name){report[name]={calls:0,max:0,min:0,avg:0,points:[]};}function saveDataPoint(name,duration){var functionData=report[name];if(!functionData){functionData=createReport(name);}functionData.calls++;functionData.points.push(duration);if(functionData.calls>1){functionData.avg=((functionData.avg*(functionData.calls-1))+duration)/functionData.calls;functionData.min=Math.min(functionData.min,duration);functionData.max=Math.max(functionData.max,duration);}else{functionData.avg=duration;functionData.min=duration;functionData.max=duration;}}return{clear:function(name){if(lang.isString(name)){delete report[name];delete stopwatches[name];}else{report={};stopwatches={};}},getOriginal:function(name){return container[name];},instrument:function(name,method){var newMethod=function(){var start=new Date(),retval=method.apply(this,arguments),stop=new Date();saveDataPoint(name,stop-start);return retval;};lang.augmentObject(newMethod,method);newMethod.__yuiProfiled=true;newMethod.prototype=method.prototype;container[name]=method;container[name].__yuiFuncName=name;createReport(name);return newMethod;},pause:function(name){var now=new Date(),stopwatch=stopwatches[name];if(stopwatch&&stopwatch.state==WATCH_STARTED){stopwatch.total+=(now-stopwatch.start);stopwatch.start=0;stopwatch.state=WATCH_PAUSED;}},start:function(name){if(container[name]){throw new Error("Cannot use '"+name+"' for profiling through start(), name is already in use.");}else{if(!report[name]){createReport(name);}if(!stopwatches[name]){stopwatches[name]={state:WATCH_STOPPED,start:0,total:0};}if(stopwatches[name].state==WATCH_STOPPED){stopwatches[name].state=WATCH_STARTED;stopwatches[name].start=new Date();}}},stop:function(name){var now=new Date(),stopwatch=stopwatches[name];if(stopwatch){if(stopwatch.state==WATCH_STARTED){saveDataPoint(name,stopwatch.total+(now-stopwatch.start));}else{if(stopwatch.state==WATCH_PAUSED){saveDataPoint(name,stopwatch.total);}}stopwatch.start=0;stopwatch.total=0;stopwatch.state=WATCH_STOPPED;}},getAverage:function(name){return report[name].avg;},getCallCount:function(name){return report[name].calls;},getMax:function(name){return report[name].max;},getMin:function(name){return report[name].min;},getFunctionReport:function(name){return report[name];},getReport:function(name){return report[name];},getFullReport:function(filter){filter=filter||function(){return true;};if(lang.isFunction(filter)){var fullReport={};for(var name in report){if(filter(report[name])){fullReport[name]=report[name];}}return fullReport;}},registerConstructor:function(name,owner){this.registerFunction(name,owner,true);},registerFunction:function(name,owner,registerPrototype){var funcName=(name.indexOf(".")>-1?name.substring(name.lastIndexOf(".")+1):name),method,prototype;if(!lang.isObject(owner)){owner=eval(name.substring(0,name.lastIndexOf(".")));}method=owner[funcName];prototype=method.prototype;if(lang.isFunction(method)&&!method.__yuiProfiled){owner[funcName]=this.instrument(name,method);container[name].__yuiOwner=owner;container[name].__yuiFuncName=funcName;if(registerPrototype){this.registerObject(name+".prototype",prototype);}}},registerObject:function(name,object,recurse){object=(lang.isObject(object)?object:eval(name));container[name]=object;for(var prop in object){if(typeof object[prop]=="function"){if(prop!="constructor"&&prop!="superclass"){this.registerFunction(name+"."+prop,object);}}else{if(typeof object[prop]=="object"&&recurse){this.registerObject(name+"."+prop,object[prop],recurse);}}}},unregisterConstructor:function(name){if(lang.isFunction(container[name])){this.unregisterFunction(name,true);}},unregisterFunction:function(name,unregisterPrototype){if(lang.isFunction(container[name])){if(unregisterPrototype){this.unregisterObject(name+".prototype",container[name].prototype);}var owner=container[name].__yuiOwner,funcName=container[name].__yuiFuncName;delete container[name].__yuiOwner;delete container[name].__yuiFuncName;owner[funcName]=container[name];delete container[name];}},unregisterObject:function(name,recurse){if(lang.isObject(container[name])){var object=container[name];for(var prop in object){if(typeof object[prop]=="function"){this.unregisterFunction(name+"."+prop);}else{if(typeof object[prop]=="object"&&recurse){this.unregisterObject(name+"."+prop,recurse);}}}delete container[name];}}};}();YAHOO.register("profiler",YAHOO.tool.Profiler,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/profilerviewer/profilerviewer-min.js b/js/yui/profilerviewer/profilerviewer-min.js
new file mode 100644 (file)
index 0000000..5fa0fcb
--- /dev/null
+++ b/js/yui/profilerviewer/profilerviewer-min.js
@@ -0,0 +1,9 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){YAHOO.widget.ProfilerViewer=function(H,G){G=G||{};if(arguments.length==1&&!YAHOO.lang.isString(H)&&!H.nodeName){G=H;H=G.element||null;}if(!H&&!G.element){H=this._createProfilerViewerElement();}YAHOO.widget.ProfilerViewer.superclass.constructor.call(this,H,G);this._init();};YAHOO.extend(YAHOO.widget.ProfilerViewer,YAHOO.util.Element);YAHOO.lang.augmentObject(YAHOO.widget.ProfilerViewer,{CLASS:"yui-pv",CLASS_DASHBOARD:"yui-pv-dashboard",CLASS_REFRESH:"yui-pv-refresh",CLASS_BUSY:"yui-pv-busy",CLASS_CHART_CONTAINER:"yui-pv-chartcontainer",CLASS_CHART:"yui-pv-chart",CLASS_CHART_LEGEND:"yui-pv-chartlegend",CLASS_TABLE:"yui-pv-table",STRINGS:{title:"YUI ProfilerViewer",buttons:{viewprofiler:"View Profiler Data",hideprofiler:"Hide Profiler Report",showchart:"Show Chart",hidechart:"Hide Chart",refreshdata:"Refresh Data"},colHeads:{fn:["Function/Method",null],calls:["Calls",40],avg:["Average",80],min:["Shortest",70],max:["Longest",70],total:["Total Time",70],pct:["Percent",70]},millisecondsAbbrev:"ms",initMessage:"initialiazing chart...",installFlashMessage:"Unable to load Flash content. The YUI Charts Control requires Flash Player 9.0.45 or higher. You can download the latest version of Flash Player from the <a href='http://www.adobe.com/go/getflashplayer'>Adobe Flash Player Download Center</a>."},timeAxisLabelFunction:function(H){var G=(H===Math.floor(H))?H:(Math.round(H*1000))/1000;return(G+" "+YAHOO.widget.ProfilerViewer.STRINGS.millisecondsAbbrev);},percentAxisLabelFunction:function(H){var G=(H===Math.floor(H))?H:(Math.round(H*100))/100;return(G+"%");}},true);var C=YAHOO.util.Dom;var A=YAHOO.util.Event;var B=YAHOO.tool.Profiler;var E=YAHOO.widget.ProfilerViewer;var D=E.prototype;D.refreshData=function(){this.fireEvent("dataRefreshEvent");};D.getHeadEl=function(){return(this._headEl)?C.get(this._headEl):false;};D.getBodyEl=function(){return(this._bodyEl)?C.get(this._bodyEl):false;};D.getChartEl=function(){return(this._chartEl)?C.get(this._chartEl):false;};D.getTableEl=function(){return(this._tableEl)?C.get(this._tableEl):false;};D.getDataTable=function(){return this._dataTable;};D.getChart=function(){return this._chart;};D._rendered=false;D._headEl=null;D._bodyEl=null;D._toggleVisibleEl=null;D._busyEl=null;D._busy=false;D._tableEl=null;D._dataTable=null;D._chartEl=null;D._chartLegendEl=null;D._chartElHeight=250;D._chart=null;D._chartInitialized=false;D._init=function(){this.createEvent("dataRefreshEvent");this.createEvent("renderEvent");this.on("dataRefreshEvent",this._refreshDataTable,this,true);this._initLauncherDOM();if(this.get("showChart")){this.on("sortedByChange",this._refreshChart);}};D._createProfilerViewerElement=function(){var G=document.createElement("div");document.body.insertBefore(G,document.body.firstChild);C.addClass(G,this.SKIN_CLASS);C.addClass(G,E.CLASS);return G;};D.toString=function(){return"ProfilerViewer "+(this.get("id")||this.get("tagName"));};D._toggleVisible=function(){var G=(this.get("visible"))?false:true;this.set("visible",G);};D._show=function(){if(!this._busy){this._setBusyState(true);if(!this._rendered){var G=new YAHOO.util.YUILoader();if(this.get("base")){G.base=this.get("base");}var H=["datatable"];if(this.get("showChart")){H.push("charts");}G.insert({require:H,onSuccess:function(){this._render();},scope:this});}else{var I=this.get("element");C.removeClass(I,"yui-pv-minimized");this._toggleVisibleEl.innerHTML=E.STRINGS.buttons.hideprofiler;C.addClass(I,"yui-pv-null");C.removeClass(I,"yui-pv-null");this.refreshData();}}};D._hide=function(){this._toggleVisibleEl.innerHTML=E.STRINGS.buttons.viewprofiler;C.addClass(this.get("element"),"yui-pv-minimized");};D._render=function(){C.removeClass(this.get("element"),"yui-pv-minimized");this._initViewerDOM();this._initDataTable();if(this.get("showChart")){this._initChartDOM();this._initChart();}this._rendered=true;this._toggleVisibleEl.innerHTML=E.STRINGS.buttons.hideprofiler;this.fireEvent("renderEvent");};D._initLauncherDOM=function(){var I=this.get("element");C.addClass(I,E.CLASS);C.addClass(I,"yui-pv-minimized");this._headEl=document.createElement("div");C.addClass(this._headEl,"hd");var H=E.STRINGS.buttons;var G=(this.get("visible"))?H.hideprofiler:H.viewprofiler;this._toggleVisibleEl=this._createButton(G,this._headEl);this._refreshEl=this._createButton(H.refreshdata,this._headEl);C.addClass(this._refreshEl,E.CLASS_REFRESH);this._busyEl=document.createElement("span");this._headEl.appendChild(this._busyEl);var J=document.createElement("h4");J.innerHTML=E.STRINGS.title;this._headEl.appendChild(J);I.appendChild(this._headEl);A.on(this._toggleVisibleEl,"click",this._toggleVisible,this,true);A.on(this._refreshEl,"click",function(){if(!this._busy){this._setBusyState(true);this.fireEvent("dataRefreshEvent");}},this,true);};D._initViewerDOM=function(){var G=this.get("element");this._bodyEl=document.createElement("div");C.addClass(this._bodyEl,"bd");this._tableEl=document.createElement("div");C.addClass(this._tableEl,E.CLASS_TABLE);this._bodyEl.appendChild(this._tableEl);G.appendChild(this._bodyEl);};D._initChartDOM=function(){this._chartContainer=document.createElement("div");C.addClass(this._chartContainer,E.CLASS_CHART_CONTAINER);var H=document.createElement("div");C.addClass(H,E.CLASS_CHART_LEGEND);var G=document.createElement("div");this._chartLegendEl=document.createElement("dl");this._chartLegendEl.innerHTML="<dd>"+E.STRINGS.initMessage+"</dd>";this._chartEl=document.createElement("div");C.addClass(this._chartEl,E.CLASS_CHART);var I=document.createElement("p");I.innerHTML=E.STRINGS.installFlashMessage;this._chartEl.appendChild(I);this._chartContainer.appendChild(H);H.appendChild(G);G.appendChild(this._chartLegendEl);this._chartContainer.appendChild(this._chartEl);this._bodyEl.insertBefore(this._chartContainer,this._tableEl);};D._createButton=function(I,J,H){var G=document.createElement("a");G.innerHTML=G.title=I;if(J){if(!H){J.appendChild(G);}else{J.insertBefore(G,J.firstChild);}}return G;};D._setBusyState=function(G){if(G){C.addClass(this._busyEl,E.CLASS_BUSY);
+this._busy=true;}else{C.removeClass(this._busyEl,E.CLASS_BUSY);this._busy=false;}};D._genSortFunction=function(H,G){var J=H;var I=G;return function(L,K){if(I==YAHOO.widget.DataTable.CLASS_ASC){return L[J]-K[J];}else{return((L[J]-K[J])*-1);}};};var F=function(G){var I=0;for(var H=0;H<G.length;I+=G[H++]){}return I;};D._getProfilerData=function(){var L=B.getFullReport();var N=[];var H=0;for(name in L){if(YAHOO.lang.hasOwnProperty(L,name)){var G=L[name];var I={};I.fn=name;I.points=G.points.slice();I.calls=G.calls;I.min=G.min;I.max=G.max;I.avg=G.avg;I.total=F(I.points);I.points=G.points;var P=this.get("filter");if((!P)||(P(I))){N.push(I);H+=I.total;}}}for(var M=0,K=N.length;M<K;M++){N[M].pct=(H)?(N[M].total*100)/H:0;}var O=this.get("sortedBy");var Q=O.key;var J=O.dir;N.sort(this._genSortFunction(Q,J));return N;};D._initDataTable=function(){var P=this;this._dataSource=new YAHOO.util.DataSource(function(){return P._getProfilerData.call(P);},{responseType:YAHOO.util.DataSource.TYPE_JSARRAY,maxCacheEntries:0});var H=this._dataSource;H.responseSchema={fields:["fn","avg","calls","max","min","total","pct","points"]};var O=function(S,R,T,U){var Q=(U===Math.floor(U))?U:(Math.round(U*1000))/1000;S.innerHTML=Q+" "+E.STRINGS.millisecondsAbbrev;};var N=function(S,R,T,U){var Q=(U===Math.floor(U))?U:(Math.round(U*100))/100;S.innerHTML=Q+"%";};var M=YAHOO.widget.DataTable.CLASS_ASC;var J=YAHOO.widget.DataTable.CLASS_DESC;var K=E.STRINGS.colHeads;var I=O;var L=[{key:"fn",sortable:true,label:K.fn[0],sortOptions:{defaultDir:M},resizeable:(YAHOO.util.DragDrop)?true:false,minWidth:K.fn[1]},{key:"calls",sortable:true,label:K.calls[0],sortOptions:{defaultDir:J},width:K.calls[1]},{key:"avg",sortable:true,label:K.avg[0],sortOptions:{defaultDir:J},formatter:I,width:K.avg[1]},{key:"min",sortable:true,label:K.min[0],sortOptions:{defaultDir:M},formatter:I,width:K.min[1]},{key:"max",sortable:true,label:K.max[0],sortOptions:{defaultDir:J},formatter:I,width:K.max[1]},{key:"total",sortable:true,label:K.total[0],sortOptions:{defaultDir:J},formatter:I,width:K.total[1]},{key:"pct",sortable:true,label:K.pct[0],sortOptions:{defaultDir:J},formatter:N,width:K.pct[1]}];this._dataTable=new YAHOO.widget.DataTable(this._tableEl,L,H,{scrollable:true,height:this.get("tableHeight"),initialRequest:null,sortedBy:{key:"total",dir:YAHOO.widget.DataTable.CLASS_DESC}});var G=this._dataTable;G.subscribe("sortedByChange",this._sortedByChange,this,true);G.subscribe("renderEvent",this._dataTableRenderHandler,this,true);G.subscribe("initEvent",this._dataTableRenderHandler,this,true);A.on(this._tableEl.getElementsByTagName("th"),"click",this._thClickHandler,this,true);};D._sortedByChange=function(G){if(G.newValue&&G.newValue.key){this.set("sortedBy",{key:G.newValue.key,dir:G.newValue.dir});}};D._dataTableRenderHandler=function(G){this._setBusyState(false);};D._thClickHandler=function(G){this._setBusyState(true);};D._refreshDataTable=function(G){var H=this._dataTable;H.getDataSource().sendRequest("",H.onDataReturnInitializeTable,H);};D._refreshChart=function(){switch(this.get("sortedBy").key){case"fn":this._chart.set("dataSource",this._chart.get("dataSource"));return;case"calls":this._chart.set("xAxis",this._chartAxisDefinitionPlain);break;case"pct":this._chart.set("xAxis",this._chartAxisDefinitionPercent);break;default:this._chart.set("xAxis",this._chartAxisDefinitionTime);break;}this._drawChartLegend();this._chart.set("series",this._getSeriesDef(this.get("sortedBy").key));};D._getChartData=function(){var H=this._dataTable.getRecordSet().getRecords(0,this.get("maxChartFunctions"));var G=[];for(var J=0,I=H.length;J<I;J++){G.push(H[J].getData());}return G;};D._getSeriesDef=function(K){var J=this.get("chartSeriesDefinitions")[K];var G=[];for(var I=0,H=J.group.length;I<H;I++){var L=this.get("chartSeriesDefinitions")[J.group[I]];G.push({displayName:L.displayName,xField:L.xField,style:{color:L.style.color,size:L.style.size}});}return G;};D._initChart=function(){this._sizeChartCanvas();YAHOO.widget.Chart.SWFURL=this.get("swfUrl");var G=this;var H=new YAHOO.util.DataSource(function(){return G._getChartData.call(G);},{responseType:YAHOO.util.DataSource.TYPE_JSARRAY,maxCacheEntries:0});H.responseSchema={fields:["fn","avg","calls","max","min","total","pct"]};H.subscribe("responseEvent",this._sizeChartCanvas,this,true);this._chartAxisDefinitionTime=new YAHOO.widget.NumericAxis();this._chartAxisDefinitionTime.labelFunction="YAHOO.widget.ProfilerViewer.timeAxisLabelFunction";this._chartAxisDefinitionPercent=new YAHOO.widget.NumericAxis();this._chartAxisDefinitionPercent.labelFunction="YAHOO.widget.ProfilerViewer.percentAxisLabelFunction";this._chartAxisDefinitionPlain=new YAHOO.widget.NumericAxis();this._chart=new YAHOO.widget.BarChart(this._chartEl,H,{yField:"fn",series:this._getSeriesDef(this.get("sortedBy").key),style:this.get("chartStyle"),xAxis:this._chartAxisDefinitionTime});this._drawChartLegend();this._chartInitialized=true;this._dataTable.unsubscribe("initEvent",this._initChart,this);this._dataTable.subscribe("initEvent",this._refreshChart,this,true);};D._drawChartLegend=function(){var M=this.get("chartSeriesDefinitions");var I=M[this.get("sortedBy").key];var H=this._chartLegendEl;H.innerHTML="";for(var K=0,J=I.group.length;K<J;K++){var N=M[I.group[K]];var L=document.createElement("dt");C.setStyle(L,"backgroundColor","#"+N.style.color);var G=document.createElement("dd");G.innerHTML=N.displayName;H.appendChild(L);H.appendChild(G);}};D._sizeChartCanvas=function(I){var G=(I)?I.response.length:this.get("maxChartFunctions");var H=(G*36)+34;if(H!=parseInt(this._chartElHeight,10)){this._chartElHeight=H;C.setStyle(this._chartEl,"height",H+"px");}};D.initAttributes=function(G){YAHOO.widget.ProfilerViewer.superclass.initAttributes.call(this,G);this.setAttributeConfig("base",{value:G.base});this.setAttributeConfig("tableHeight",{value:G.tableHeight||"15em",method:function(H){if(this._dataTable){this._dataTable.set("height",H);}}});this.setAttributeConfig("sortedBy",{value:G.sortedBy||{key:"total",dir:"yui-dt-desc"}});
+this.setAttributeConfig("filter",{value:G.filter||null,validator:YAHOO.lang.isFunction});this.setAttributeConfig("swfUrl",{value:G.swfUrl||"http://yui.yahooapis.com/2.5.0/build/charts/assets/charts.swf"});this.setAttributeConfig("maxChartFunctions",{value:G.maxChartFunctions||6,method:function(H){if(this._rendered){this._sizeChartCanvas();}},validator:YAHOO.lang.isNumber});this.setAttributeConfig("chartStyle",{value:G.chartStyle||{font:{name:"Arial",color:15658588,size:12},background:{color:"6e6e63"}},method:function(){if(this._rendered&&this.get("showChart")){this._refreshChart();}}});this.setAttributeConfig("chartSeriesDefinitions",{value:G.chartSeriesDefinitions||{total:{displayName:E.STRINGS.colHeads.total[0],xField:"total",style:{color:"4d95dd",size:20},group:["total"]},calls:{displayName:E.STRINGS.colHeads.calls[0],xField:"calls",style:{color:"edff9f",size:20},group:["calls"]},avg:{displayName:E.STRINGS.colHeads.avg[0],xField:"avg",style:{color:"209daf",size:9},group:["avg","min","max"]},min:{displayName:E.STRINGS.colHeads.min[0],xField:"min",style:{color:"b6ecf4",size:9},group:["avg","min","max"]},max:{displayName:E.STRINGS.colHeads.max[0],xField:"max",style:{color:"29c7de",size:9},group:["avg","min","max"]},pct:{displayName:E.STRINGS.colHeads.pct[0],xField:"pct",style:{color:"C96EDB",size:20},group:["pct"]}},method:function(){if(this._rendered&&this.get("showChart")){this._refreshChart();}}});this.setAttributeConfig("visible",{value:G.visible||false,validator:YAHOO.lang.isBoolean,method:function(H){if(H){this._show();}else{if(this._rendered){this._hide();}}}});this.setAttributeConfig("showChart",{value:G.showChart||true,validator:YAHOO.lang.isBoolean,writeOnce:true});YAHOO.widget.ProfilerViewer.superclass.initAttributes.call(this,G);};})();YAHOO.register("profilerviewer",YAHOO.widget.ProfilerViewer,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/progressbar/progressbar-min.js b/js/yui/progressbar/progressbar-min.js
new file mode 100644 (file)
index 0000000..e3e8c62
--- /dev/null
+++ b/js/yui/progressbar/progressbar-min.js
@@ -0,0 +1,8 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){var c=YAHOO.util.Dom,i=YAHOO.lang,B="yui-pb",D=B+"-mask",A=B+"-bar",z=B+"-anim",q=B+"-tl",l=B+"-tr",k=B+"-bl",g=B+"-br",h="width",w="height",m="minValue",y="maxValue",j="value",a="anim",x="direction",e="ltr",t="rtl",G="ttb",s="btt",f="barEl",d="maskEl",v="ariaTextTemplate",n="animAcceleration",p="background-position",o="px",C="start",F="progress",u="complete";var r=function(b){r.superclass.constructor.call(this,document.createElement("div"),b);this._init(b);};YAHOO.widget.ProgressBar=r;r.MARKUP=['<div class="',A,'"></div><div class="',D,'"><div class="',q,'"></div><div class="',l,'"></div><div class="',k,'"></div><div class="',g,'"></div></div>'].join("");i.extend(r,YAHOO.util.Element,{_init:function(b){},initAttributes:function(I){r.superclass.initAttributes.call(this,I);this.set("innerHTML",r.MARKUP);this.addClass(B);var H,b=["id",h,w,"class","style"];while((H=b.pop())){if(H in I){this.set(H,I[H]);}}this.setAttributeConfig(f,{readOnly:true,value:this.getElementsByClassName(A)[0]});this.setAttributeConfig(d,{readOnly:true,value:this.getElementsByClassName(D)[0]});this.setAttributeConfig(x,{value:e,validator:function(J){if(this._rendered){return false;}switch(J){case e:case t:case G:case s:return true;default:return false;}}});this.setAttributeConfig(y,{value:100,validator:i.isNumber,method:function(J){this.get("element").setAttribute("aria-valuemax",J);if(this.get(j)>J){this.set(j,J);}}});this.setAttributeConfig(m,{value:0,validator:i.isNumber,method:function(J){this.get("element").setAttribute("aria-valuemin",J);if(this.get(j)<J){this.set(j,J);}}});this.setAttributeConfig(h,{getter:function(){return this.getStyle(h);},method:this._widthChange});this.setAttributeConfig(w,{getter:function(){return this.getStyle(w);},method:this._heightChange});this.setAttributeConfig(v,{value:"{value}"});this.setAttributeConfig(j,{value:0,validator:function(J){return i.isNumber(J)&&J>=this.get(m)&&J<=this.get(y);},method:this._valueChange});this.setAttributeConfig(a,{validator:function(J){return !!YAHOO.util.Anim;},setter:this._animSetter});this.setAttributeConfig(n,{value:null,validator:function(J){return i.isNumber(J)||i.isNull(J);},method:function(J){this._fixAnim(this.get(a),J);}});},render:function(H,I){if(this._rendered){return;}this._rendered=true;var J=this.get(x);this.addClass(B);this.addClass(B+"-"+J);var b=this.get("element");b.tabIndex=0;b.setAttribute("role","progressbar");b.setAttribute("aria-valuemin",this.get(m));b.setAttribute("aria-valuemax",this.get(y));this.appendTo(H,I);this.redraw(false);this._previousValue=this.get(j);this._fixEdges();this.on("minValueChange",this.redraw);this.on("maxValueChange",this.redraw);return this;},redraw:function(b){this._recalculateConstants();this._valueChange(this.get(j),b);},destroy:function(){this.set(a,false);this.unsubscribeAll();var b=this.get("element");if(b.parentNode){b.parentNode.removeChild(b);}},_previousValue:0,_barSpace:100,_barFactor:1,_rendered:false,_heightChange:function(b){if(i.isNumber(b)){b+=o;}this.setStyle(w,b);this._fixEdges();this.redraw(false);},_widthChange:function(b){if(i.isNumber(b)){b+=o;}this.setStyle(h,b);this._fixEdges();this.redraw(false);},_fixEdges:function(){if(!this._rendered||YAHOO.env.ua.ie||YAHOO.env.ua.gecko){return;}var J=this.get(d),L=c.getElementsByClassName(q,undefined,J)[0],I=c.getElementsByClassName(l,undefined,J)[0],K=c.getElementsByClassName(k,undefined,J)[0],H=c.getElementsByClassName(g,undefined,J)[0],b=(parseInt(c.getStyle(J,w),10)-parseInt(c.getStyle(L,w),10))+o;c.setStyle(K,w,b);c.setStyle(H,w,b);b=(parseInt(c.getStyle(J,h),10)-parseInt(c.getStyle(L,h),10))+o;c.setStyle(I,h,b);c.setStyle(H,h,b);},_recalculateConstants:function(){var b=this.get(f);switch(this.get(x)){case e:case t:this._barSpace=parseInt(this.get(h),10)-(parseInt(c.getStyle(b,"marginLeft"),10)||0)-(parseInt(c.getStyle(b,"marginRight"),10)||0);break;case G:case s:this._barSpace=parseInt(this.get(w),10)-(parseInt(c.getStyle(b,"marginTop"),10)||0)-(parseInt(c.getStyle(b,"marginBottom"),10)||0);break;}this._barFactor=this._barSpace/(this.get(y)-(this.get(m)||0))||1;},_animSetter:function(I){var H,b=this.get(f);if(I){if(I instanceof YAHOO.util.Anim){H=I;}else{H=new YAHOO.util.Anim(b);}H.onTween.subscribe(this._animOnTween,this,true);H.onComplete.subscribe(this._animComplete,this,true);this._fixAnim(H,this.get(n));}else{H=this.get(a);if(H){H.onTween.unsubscribeAll();H.onComplete.unsubscribeAll();}H=null;}return H;},_fixAnim:function(I,H){if(I){if(!this._oldSetAttribute){this._oldSetAttribute=I.setAttribute;}var b=this;switch(this.get(x)){case e:I.setAttribute=function(J,L,K){L=Math.round(L);b._oldSetAttribute.call(this,J,L,K);if(J==h){b._oldSetAttribute.call(this,p,-L*H,o);}};break;case t:I.setAttribute=function(J,M,K){M=Math.round(M);b._oldSetAttribute.call(this,J,M,K);if(J==h){var L=b._barSpace-M;b._oldSetAttribute.call(this,"left",L,o);b._oldSetAttribute.call(this,p,-L+M*H,o);}};break;case G:I.setAttribute=function(J,L,K){L=Math.round(L);b._oldSetAttribute.call(this,J,L,K);if(J==w){b._oldSetAttribute.call(this,p,"center "+(-L*H),o);}};break;case s:I.setAttribute=function(J,M,K){M=Math.round(M);b._oldSetAttribute.call(this,J,M,K);if(J==w){var L=b._barSpace-M;b._oldSetAttribute.call(this,"top",L,o);b._oldSetAttribute.call(this,p,"center "+(M*H-L),o);}};break;}}},_animComplete:function(){var b=this.get(j);this._previousValue=b;this.fireEvent(F,b);this.fireEvent(u,b);c.removeClass(this.get(f),z);},_animOnTween:function(b,H){var I=Math.floor(this._tweenFactor*H[0].currentFrame+this._previousValue);this.fireEvent(F,I);},_valueChange:function(J,H){var I=this.get(a),b=Math.floor((J-this.get(m))*this._barFactor);this._setAriaText(J);if(this._rendered){if(I){I.stop();if(I.isAnimated()){I._onComplete.fire();}}this.fireEvent(C,this._previousValue);r._barSizeFunctions[((H!==false)&&I)?1:0][this.get(x)].call(this,J,b,this.get(f),I);}},_setAriaText:function(H){var b=this.get("element"),I=i.substitute(this.get(v),{value:H,minValue:this.get(m),maxValue:this.get(y)});
+b.setAttribute("aria-valuenow",H);b.setAttribute("aria-valuetext",I);}});var E=[{},{}];r._barSizeFunctions=E;E[0][e]=function(J,b,H,I){c.setStyle(H,h,b+o);this.fireEvent(F,J);this.fireEvent(u,J);};E[0][t]=function(J,b,H,I){c.setStyle(H,h,b+o);c.setStyle(H,"left",(this._barSpace-b)+o);this.fireEvent(F,J);this.fireEvent(u,J);};E[0][G]=function(J,b,H,I){c.setStyle(H,w,b+o);this.fireEvent(F,J);this.fireEvent(u,J);};E[0][s]=function(J,b,H,I){c.setStyle(H,w,b+o);c.setStyle(H,"top",(this._barSpace-b)+o);this.fireEvent(F,J);this.fireEvent(u,J);};E[1][e]=function(J,b,H,I){c.addClass(H,z);this._tweenFactor=(J-this._previousValue)/I.totalFrames/I.duration;I.attributes={width:{to:b}};I.animate();};E[1][t]=E[1][e];E[1][G]=function(J,b,H,I){c.addClass(H,z);this._tweenFactor=(J-this._previousValue)/I.totalFrames/I.duration;I.attributes={height:{to:b}};I.animate();};E[1][s]=E[1][G];})();YAHOO.register("progressbar",YAHOO.widget.ProgressBar,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/reset-fonts-grids/reset-fonts-grids.css b/js/yui/reset-fonts-grids/reset-fonts-grids.css
new file mode 100644 (file)
index 0000000..7c73713
--- /dev/null
+++ b/js/yui/reset-fonts-grids/reset-fonts-grids.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+html{color:#000;background:#FFF}body,div,dl,dt,dd,ul,ol,li,h1,h2,h3,h4,h5,h6,pre,code,form,fieldset,legend,input,button,textarea,select,p,blockquote,th,td{margin:0;padding:0}table{border-collapse:collapse;border-spacing:0}fieldset,img{border:0}address,button,caption,cite,code,dfn,em,input,optgroup,option,select,strong,textarea,th,var{font:inherit}del,ins{text-decoration:none}li{list-style:none}caption,th{text-align:left}h1,h2,h3,h4,h5,h6{font-size:100%;font-weight:normal}q:before,q:after{content:''}abbr,acronym{border:0;font-variant:normal}sup{vertical-align:baseline}sub{vertical-align:baseline}legend{color:#000}body{font:13px/1.231 arial,helvetica,clean,sans-serif;*font-size:small;*font:x-small}select,input,textarea,button{font:99% arial,helvetica,clean,sans-serif}table{font-size:inherit;font:100%}pre,code,kbd,samp,tt{font-family:monospace;*font-size:108%;line-height:100%}body{text-align:center}#doc,#doc2,#doc3,#doc4,.yui-t1,.yui-t2,.yui-t3,.yui-t4,.yui-t5,.yui-t6,.yui-t7{margin:auto;text-align:left;width:57.69em;*width:56.25em}#doc2{width:73.076em;*width:71.25em}#doc3{margin:auto 10px;width:auto}#doc4{width:74.923em;*width:73.05em}.yui-b{position:relative}.yui-b{_position:static}#yui-main .yui-b{position:static}#yui-main,.yui-g .yui-u .yui-g{width:100%}.yui-t1 #yui-main,.yui-t2 #yui-main,.yui-t3 #yui-main{float:right;margin-left:-25em}.yui-t4 #yui-main,.yui-t5 #yui-main,.yui-t6 #yui-main{float:left;margin-right:-25em}.yui-t1 .yui-b{float:left;width:12.30769em;*width:12.00em}.yui-t1 #yui-main .yui-b{margin-left:13.30769em;*margin-left:13.05em}.yui-t2 .yui-b{float:left;width:13.8461em;*width:13.50em}.yui-t2 #yui-main .yui-b{margin-left:14.8461em;*margin-left:14.55em}.yui-t3 .yui-b{float:left;width:23.0769em;*width:22.50em}.yui-t3 #yui-main .yui-b{margin-left:24.0769em;*margin-left:23.62em}.yui-t4 .yui-b{float:right;width:13.8456em;*width:13.50em}.yui-t4 #yui-main .yui-b{margin-right:14.8456em;*margin-right:14.55em}.yui-t5 .yui-b{float:right;width:18.4615em;*width:18.00em}.yui-t5 #yui-main .yui-b{margin-right:19.4615em;*margin-right:19.125em}.yui-t6 .yui-b{float:right;width:23.0769em;*width:22.50em}.yui-t6 #yui-main .yui-b{margin-right:24.0769em;*margin-right:23.62em}.yui-t7 #yui-main .yui-b{display:block;margin:0 0 1em 0}#yui-main .yui-b{float:none;width:auto}.yui-gb .yui-u,.yui-g .yui-gb .yui-u,.yui-gb .yui-g,.yui-gb .yui-gb,.yui-gb .yui-gc,.yui-gb .yui-gd,.yui-gb .yui-ge,.yui-gb .yui-gf,.yui-gc .yui-u,.yui-gc .yui-g,.yui-gd .yui-u{float:left}.yui-g .yui-u,.yui-g .yui-g,.yui-g .yui-gb,.yui-g .yui-gc,.yui-g .yui-gd,.yui-g .yui-ge,.yui-g .yui-gf,.yui-gc .yui-u,.yui-gd .yui-g,.yui-g .yui-gc .yui-u,.yui-ge .yui-u,.yui-ge .yui-g,.yui-gf .yui-g,.yui-gf .yui-u{float:right}.yui-g div.first,.yui-gb div.first,.yui-gc div.first,.yui-gd div.first,.yui-ge div.first,.yui-gf div.first,.yui-g .yui-gc div.first,.yui-g .yui-ge div.first,.yui-gc div.first div.first{float:left}.yui-g .yui-u,.yui-g .yui-g,.yui-g .yui-gb,.yui-g .yui-gc,.yui-g .yui-gd,.yui-g .yui-ge,.yui-g .yui-gf{width:49.1%}.yui-gb .yui-u,.yui-g .yui-gb .yui-u,.yui-gb .yui-g,.yui-gb .yui-gb,.yui-gb .yui-gc,.yui-gb .yui-gd,.yui-gb .yui-ge,.yui-gb .yui-gf,.yui-gc .yui-u,.yui-gc .yui-g,.yui-gd .yui-u{width:32%;margin-left:1.99%}.yui-gb .yui-u{*margin-left:1.9%;*width:31.9%}.yui-gc div.first,.yui-gd .yui-u{width:66%}.yui-gd div.first{width:32%}.yui-ge div.first,.yui-gf .yui-u{width:74.2%}.yui-ge .yui-u,.yui-gf div.first{width:24%}.yui-g .yui-gb div.first,.yui-gb div.first,.yui-gc div.first,.yui-gd div.first{margin-left:0}.yui-g .yui-g .yui-u,.yui-gb .yui-g .yui-u,.yui-gc .yui-g .yui-u,.yui-gd .yui-g .yui-u,.yui-ge .yui-g .yui-u,.yui-gf .yui-g .yui-u{width:49%;*width:48.1%;*margin-left:0}.yui-g .yui-g .yui-u{width:48.1%}.yui-g .yui-gb div.first,.yui-gb .yui-gb div.first{*margin-right:0;*width:32%;_width:31.7%}.yui-g .yui-gc div.first,.yui-gd .yui-g{width:66%}.yui-gb .yui-g div.first{*margin-right:4%;_margin-right:1.3%}.yui-gb .yui-gc div.first,.yui-gb .yui-gd div.first{*margin-right:0}.yui-gb .yui-gb .yui-u,.yui-gb .yui-gc .yui-u{*margin-left:1.8%;_margin-left:4%}.yui-g .yui-gb .yui-u{_margin-left:1.0%}.yui-gb .yui-gd .yui-u{*width:66%;_width:61.2%}.yui-gb .yui-gd div.first{*width:31%;_width:29.5%}.yui-g .yui-gc .yui-u,.yui-gb .yui-gc .yui-u{width:32%;_float:right;margin-right:0;_margin-left:0}.yui-gb .yui-gc div.first{width:66%;*float:left;*margin-left:0}.yui-gb .yui-ge .yui-u,.yui-gb .yui-gf .yui-u{margin:0}.yui-gb .yui-gb .yui-u{_margin-left:.7%}.yui-gb .yui-g div.first,.yui-gb .yui-gb div.first{*margin-left:0}.yui-gc .yui-g .yui-u,.yui-gd .yui-g .yui-u{*width:48.1%;*margin-left:0}.yui-gb .yui-gd div.first{width:32%}.yui-g .yui-gd div.first{_width:29.9%}.yui-ge .yui-g{width:24%}.yui-gf .yui-g{width:74.2%}.yui-gb .yui-ge div.yui-u,.yui-gb .yui-gf div.yui-u{float:right}.yui-gb .yui-ge div.first,.yui-gb .yui-gf div.first{float:left}.yui-gb .yui-ge .yui-u,.yui-gb .yui-gf div.first{*width:24%;_width:20%}.yui-gb .yui-ge div.first,.yui-gb .yui-gf .yui-u{*width:73.5%;_width:65.5%}.yui-ge div.first .yui-gd .yui-u{width:65%}.yui-ge div.first .yui-gd div.first{width:32%}#hd:after,#bd:after,#ft:after,.yui-g:after,.yui-gb:after,.yui-gc:after,.yui-gd:after,.yui-ge:after,.yui-gf:after{content:"";display:block;clear:both}#hd,#bd,#ft,.yui-g,.yui-gb,.yui-gc,.yui-gd,.yui-ge,.yui-gf{zoom:1}
\ No newline at end of file

diff --git a/js/yui/reset-fonts/reset-fonts.css b/js/yui/reset-fonts/reset-fonts.css
new file mode 100644 (file)
index 0000000..c4df2bc
--- /dev/null
+++ b/js/yui/reset-fonts/reset-fonts.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+html{color:#000;background:#FFF}body,div,dl,dt,dd,ul,ol,li,h1,h2,h3,h4,h5,h6,pre,code,form,fieldset,legend,input,button,textarea,select,p,blockquote,th,td{margin:0;padding:0}table{border-collapse:collapse;border-spacing:0}fieldset,img{border:0}address,button,caption,cite,code,dfn,em,input,optgroup,option,select,strong,textarea,th,var{font:inherit}del,ins{text-decoration:none}li{list-style:none}caption,th{text-align:left}h1,h2,h3,h4,h5,h6{font-size:100%;font-weight:normal}q:before,q:after{content:''}abbr,acronym{border:0;font-variant:normal}sup{vertical-align:baseline}sub{vertical-align:baseline}legend{color:#000}body{font:13px/1.231 arial,helvetica,clean,sans-serif;*font-size:small;*font:x-small}select,input,textarea,button{font:99% arial,helvetica,clean,sans-serif}table{font-size:inherit;font:100%}pre,code,kbd,samp,tt{font-family:monospace;*font-size:108%;line-height:100%}
\ No newline at end of file

diff --git a/js/yui/reset/reset-min.css b/js/yui/reset/reset-min.css
new file mode 100644 (file)
index 0000000..dab807f
--- /dev/null
+++ b/js/yui/reset/reset-min.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+html{color:#000;background:#FFF}body,div,dl,dt,dd,ul,ol,li,h1,h2,h3,h4,h5,h6,pre,code,form,fieldset,legend,input,button,textarea,select,p,blockquote,th,td{margin:0;padding:0}table{border-collapse:collapse;border-spacing:0}fieldset,img{border:0}address,button,caption,cite,code,dfn,em,input,optgroup,option,select,strong,textarea,th,var{font:inherit}del,ins{text-decoration:none}li{list-style:none}caption,th{text-align:left}h1,h2,h3,h4,h5,h6{font-size:100%;font-weight:normal}q:before,q:after{content:''}abbr,acronym{border:0;font-variant:normal}sup{vertical-align:baseline}sub{vertical-align:baseline}legend{color:#000}
\ No newline at end of file

diff --git a/js/yui/reset/reset.css b/js/yui/reset/reset.css
new file mode 100644 (file)
index 0000000..9bca239
--- /dev/null
+++ b/js/yui/reset/reset.css
@@ -0,0 +1,123 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+/**
+ * YUI Reset
+ * @module reset
+ * @namespace
+ * @requires 
+ */
+html {
+       color: #000;
+       background: #FFF;
+}
+
+body,
+div,
+dl,
+dt,
+dd,
+ul,
+ol,
+li,
+h1,
+h2,
+h3,
+h4,
+h5,
+h6,
+pre,
+code,
+form,
+fieldset,
+legend,
+input,
+button,
+textarea,
+select,
+p,
+blockquote,
+th,
+td {
+       margin: 0;
+       padding: 0;
+}
+
+table {
+       border-collapse: collapse;
+       border-spacing: 0;
+}
+
+fieldset,
+img {
+       border: 0;
+}
+
+address,
+button,
+caption,
+cite,
+code,
+dfn,
+em,
+input,
+optgroup,
+option,
+select,
+strong,
+textarea,
+th,
+var {
+    font:inherit;
+}
+
+del,
+ins {
+       text-decoration: none;
+}
+
+li {
+       list-style: none;
+}
+
+caption,
+th {
+       text-align: left;
+}
+
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+       font-size: 100%;
+       font-weight: normal;
+}
+
+q:before,
+q:after {
+       content: '';
+}
+
+abbr,
+acronym {
+       border: 0;
+       font-variant: normal;
+}
+
+sup {
+       vertical-align: baseline;
+}
+
+sub {
+       vertical-align: baseline;
+}
+
+/*because legend doesn't inherit in IE */
+legend {
+       color: #000;
+}

diff --git a/js/yui/resize/resize-min.js b/js/yui/resize/resize-min.js
new file mode 100644 (file)
index 0000000..58c3895
--- /dev/null
+++ b/js/yui/resize/resize-min.js
@@ -0,0 +1,10 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){var E=YAHOO.util.Dom,A=YAHOO.util.Event,C=YAHOO.lang;var B=function(F,D){var G={element:F,attributes:D||{}};B.superclass.constructor.call(this,G.element,G.attributes);};B._instances={};B.getResizeById=function(D){if(B._instances[D]){return B._instances[D];}return false;};YAHOO.extend(B,YAHOO.util.Element,{CSS_RESIZE:"yui-resize",CSS_DRAG:"yui-draggable",CSS_HOVER:"yui-resize-hover",CSS_PROXY:"yui-resize-proxy",CSS_WRAP:"yui-resize-wrap",CSS_KNOB:"yui-resize-knob",CSS_HIDDEN:"yui-resize-hidden",CSS_HANDLE:"yui-resize-handle",CSS_STATUS:"yui-resize-status",CSS_GHOST:"yui-resize-ghost",CSS_RESIZING:"yui-resize-resizing",_resizeEvent:null,dd:null,browser:YAHOO.env.ua,_locked:null,_positioned:null,_dds:null,_wrap:null,_proxy:null,_handles:null,_currentHandle:null,_currentDD:null,_cache:null,_active:null,_createProxy:function(){if(this.get("proxy")){this._proxy=document.createElement("div");this._proxy.className=this.CSS_PROXY;this._proxy.style.height=this.get("element").clientHeight+"px";this._proxy.style.width=this.get("element").clientWidth+"px";this._wrap.parentNode.appendChild(this._proxy);}else{this.set("animate",false);}},_createWrap:function(){this._positioned=false;if(this.get("wrap")===false){switch(this.get("element").tagName.toLowerCase()){case"img":case"textarea":case"input":case"iframe":case"select":this.set("wrap",true);break;}}if(this.get("wrap")===true){this._wrap=document.createElement("div");this._wrap.id=this.get("element").id+"_wrap";this._wrap.className=this.CSS_WRAP;if(this.get("element").tagName.toLowerCase()=="textarea"){E.addClass(this._wrap,"yui-resize-textarea");}E.setStyle(this._wrap,"width",this.get("width")+"px");E.setStyle(this._wrap,"height",this.get("height")+"px");E.setStyle(this._wrap,"z-index",this.getStyle("z-index"));this.setStyle("z-index",0);var F=E.getStyle(this.get("element"),"position");E.setStyle(this._wrap,"position",((F=="static")?"relative":F));E.setStyle(this._wrap,"top",E.getStyle(this.get("element"),"top"));E.setStyle(this._wrap,"left",E.getStyle(this.get("element"),"left"));if(E.getStyle(this.get("element"),"position")=="absolute"){this._positioned=true;E.setStyle(this.get("element"),"position","relative");E.setStyle(this.get("element"),"top","0");E.setStyle(this.get("element"),"left","0");}var D=this.get("element").parentNode;D.replaceChild(this._wrap,this.get("element"));this._wrap.appendChild(this.get("element"));}else{this._wrap=this.get("element");if(E.getStyle(this._wrap,"position")=="absolute"){this._positioned=true;}}if(this.get("draggable")){this._setupDragDrop();}if(this.get("hover")){E.addClass(this._wrap,this.CSS_HOVER);}if(this.get("knobHandles")){E.addClass(this._wrap,this.CSS_KNOB);}if(this.get("hiddenHandles")){E.addClass(this._wrap,this.CSS_HIDDEN);}E.addClass(this._wrap,this.CSS_RESIZE);},_setupDragDrop:function(){E.addClass(this._wrap,this.CSS_DRAG);this.dd=new YAHOO.util.DD(this._wrap,this.get("id")+"-resize",{dragOnly:true,useShim:this.get("useShim")});this.dd.on("dragEvent",function(){this.fireEvent("dragEvent",arguments);},this,true);},_createHandles:function(){this._handles={};this._dds={};var G=this.get("handles");for(var F=0;F<G.length;F++){this._handles[G[F]]=document.createElement("div");this._handles[G[F]].id=E.generateId(this._handles[G[F]]);this._handles[G[F]].className=this.CSS_HANDLE+" "+this.CSS_HANDLE+"-"+G[F];var D=document.createElement("div");D.className=this.CSS_HANDLE+"-inner-"+G[F];this._handles[G[F]].appendChild(D);this._wrap.appendChild(this._handles[G[F]]);A.on(this._handles[G[F]],"mouseover",this._handleMouseOver,this,true);A.on(this._handles[G[F]],"mouseout",this._handleMouseOut,this,true);this._dds[G[F]]=new YAHOO.util.DragDrop(this._handles[G[F]],this.get("id")+"-handle-"+G,{useShim:this.get("useShim")});this._dds[G[F]].setPadding(15,15,15,15);this._dds[G[F]].on("startDragEvent",this._handleStartDrag,this._dds[G[F]],this);this._dds[G[F]].on("mouseDownEvent",this._handleMouseDown,this._dds[G[F]],this);}this._status=document.createElement("span");this._status.className=this.CSS_STATUS;document.body.insertBefore(this._status,document.body.firstChild);},_ieSelectFix:function(){return false;},_ieSelectBack:null,_setAutoRatio:function(D){if(this.get("autoRatio")){if(D&&D.shiftKey){this.set("ratio",true);}else{this.set("ratio",this._configs.ratio._initialConfig.value);}}},_handleMouseDown:function(D){if(this._locked){return false;}if(E.getStyle(this._wrap,"position")=="absolute"){this._positioned=true;}if(D){this._setAutoRatio(D);}if(this.browser.ie){this._ieSelectBack=document.body.onselectstart;document.body.onselectstart=this._ieSelectFix;}},_handleMouseOver:function(G){if(this._locked){return false;}E.removeClass(this._wrap,this.CSS_RESIZE);if(this.get("hover")){E.removeClass(this._wrap,this.CSS_HOVER);}var D=A.getTarget(G);if(!E.hasClass(D,this.CSS_HANDLE)){D=D.parentNode;}if(E.hasClass(D,this.CSS_HANDLE)&&!this._active){E.addClass(D,this.CSS_HANDLE+"-active");for(var F in this._handles){if(C.hasOwnProperty(this._handles,F)){if(this._handles[F]==D){E.addClass(D,this.CSS_HANDLE+"-"+F+"-active");break;}}}}E.addClass(this._wrap,this.CSS_RESIZE);},_handleMouseOut:function(G){E.removeClass(this._wrap,this.CSS_RESIZE);if(this.get("hover")&&!this._active){E.addClass(this._wrap,this.CSS_HOVER);}var D=A.getTarget(G);if(!E.hasClass(D,this.CSS_HANDLE)){D=D.parentNode;}if(E.hasClass(D,this.CSS_HANDLE)&&!this._active){E.removeClass(D,this.CSS_HANDLE+"-active");for(var F in this._handles){if(C.hasOwnProperty(this._handles,F)){if(this._handles[F]==D){E.removeClass(D,this.CSS_HANDLE+"-"+F+"-active");break;}}}}E.addClass(this._wrap,this.CSS_RESIZE);},_handleStartDrag:function(G,F){var D=F.getDragEl();if(E.hasClass(D,this.CSS_HANDLE)){if(E.getStyle(this._wrap,"position")=="absolute"){this._positioned=true;}this._active=true;this._currentDD=F;if(this._proxy){this._proxy.style.visibility="visible";this._proxy.style.zIndex="1000";this._proxy.style.height=this.get("element").clientHeight+"px";this._proxy.style.width=this.get("element").clientWidth+"px";
+}for(var H in this._handles){if(C.hasOwnProperty(this._handles,H)){if(this._handles[H]==D){this._currentHandle=H;var I="_handle_for_"+H;E.addClass(D,this.CSS_HANDLE+"-"+H+"-active");F.on("dragEvent",this[I],this,true);F.on("mouseUpEvent",this._handleMouseUp,this,true);break;}}}E.addClass(D,this.CSS_HANDLE+"-active");if(this.get("proxy")){var J=E.getXY(this.get("element"));E.setXY(this._proxy,J);if(this.get("ghost")){this.addClass(this.CSS_GHOST);}}E.addClass(this._wrap,this.CSS_RESIZING);this._setCache();this._updateStatus(this._cache.height,this._cache.width,this._cache.top,this._cache.left);this.fireEvent("startResize",{type:"startresize",target:this});}},_setCache:function(){this._cache.xy=E.getXY(this._wrap);E.setXY(this._wrap,this._cache.xy);this._cache.height=this.get("clientHeight");this._cache.width=this.get("clientWidth");this._cache.start.height=this._cache.height;this._cache.start.width=this._cache.width;this._cache.start.top=this._cache.xy[1];this._cache.start.left=this._cache.xy[0];this._cache.top=this._cache.xy[1];this._cache.left=this._cache.xy[0];this.set("height",this._cache.height,true);this.set("width",this._cache.width,true);},_handleMouseUp:function(F){this._active=false;var G="_handle_for_"+this._currentHandle;this._currentDD.unsubscribe("dragEvent",this[G],this,true);this._currentDD.unsubscribe("mouseUpEvent",this._handleMouseUp,this,true);if(this._proxy){this._proxy.style.visibility="hidden";this._proxy.style.zIndex="-1";if(this.get("setSize")){this.resize(F,this._cache.height,this._cache.width,this._cache.top,this._cache.left,true);}else{this.fireEvent("resize",{ev:"resize",target:this,height:this._cache.height,width:this._cache.width,top:this._cache.top,left:this._cache.left});}if(this.get("ghost")){this.removeClass(this.CSS_GHOST);}}if(this.get("hover")){E.addClass(this._wrap,this.CSS_HOVER);}if(this._status){E.setStyle(this._status,"display","none");}if(this.browser.ie){document.body.onselectstart=this._ieSelectBack;}if(this.browser.ie){E.removeClass(this._wrap,this.CSS_RESIZE);}for(var D in this._handles){if(C.hasOwnProperty(this._handles,D)){E.removeClass(this._handles[D],this.CSS_HANDLE+"-active");}}if(this.get("hover")&&!this._active){E.addClass(this._wrap,this.CSS_HOVER);}E.removeClass(this._wrap,this.CSS_RESIZING);E.removeClass(this._handles[this._currentHandle],this.CSS_HANDLE+"-"+this._currentHandle+"-active");E.removeClass(this._handles[this._currentHandle],this.CSS_HANDLE+"-active");if(this.browser.ie){E.addClass(this._wrap,this.CSS_RESIZE);}this._resizeEvent=null;this._currentHandle=null;if(!this.get("animate")){this.set("height",this._cache.height,true);this.set("width",this._cache.width,true);}this.fireEvent("endResize",{ev:"endResize",target:this,height:this._cache.height,width:this._cache.width,top:this._cache.top,left:this._cache.left});},_setRatio:function(K,N,Q,I){var O=K,G=N;if(this.get("ratio")){var P=this._cache.height,H=this._cache.width,F=parseInt(this.get("height"),10),L=parseInt(this.get("width"),10),M=this.get("maxHeight"),R=this.get("minHeight"),D=this.get("maxWidth"),J=this.get("minWidth");switch(this._currentHandle){case"l":K=F*(N/L);K=Math.min(Math.max(R,K),M);N=L*(K/F);Q=(this._cache.start.top-(-((F-K)/2)));I=(this._cache.start.left-(-((L-N))));break;case"r":K=F*(N/L);K=Math.min(Math.max(R,K),M);N=L*(K/F);Q=(this._cache.start.top-(-((F-K)/2)));break;case"t":N=L*(K/F);K=F*(N/L);I=(this._cache.start.left-(-((L-N)/2)));Q=(this._cache.start.top-(-((F-K))));break;case"b":N=L*(K/F);K=F*(N/L);I=(this._cache.start.left-(-((L-N)/2)));break;case"bl":K=F*(N/L);N=L*(K/F);I=(this._cache.start.left-(-((L-N))));break;case"br":K=F*(N/L);N=L*(K/F);break;case"tl":K=F*(N/L);N=L*(K/F);I=(this._cache.start.left-(-((L-N))));Q=(this._cache.start.top-(-((F-K))));break;case"tr":K=F*(N/L);N=L*(K/F);I=(this._cache.start.left);Q=(this._cache.start.top-(-((F-K))));break;}O=this._checkHeight(K);G=this._checkWidth(N);if((O!=K)||(G!=N)){Q=0;I=0;if(O!=K){G=this._cache.width;}if(G!=N){O=this._cache.height;}}}return[O,G,Q,I];},_updateStatus:function(K,G,J,F){if(this._resizeEvent&&(!C.isString(this._resizeEvent))){K=((K===0)?this._cache.start.height:K);G=((G===0)?this._cache.start.width:G);var I=parseInt(this.get("height"),10),D=parseInt(this.get("width"),10);if(isNaN(I)){I=parseInt(K,10);}if(isNaN(D)){D=parseInt(G,10);}var L=(parseInt(K,10)-I);var H=(parseInt(G,10)-D);this._cache.offsetHeight=L;this._cache.offsetWidth=H;if(this.get("status")){E.setStyle(this._status,"display","inline");this._status.innerHTML="<strong>"+parseInt(K,10)+" x "+parseInt(G,10)+"</strong><em>"+((L>0)?"+":"")+L+" x "+((H>0)?"+":"")+H+"</em>";E.setXY(this._status,[A.getPageX(this._resizeEvent)+12,A.getPageY(this._resizeEvent)+12]);}}},lock:function(D){this._locked=true;if(D&&this.dd){E.removeClass(this._wrap,"yui-draggable");this.dd.lock();}return this;},unlock:function(D){this._locked=false;if(D&&this.dd){E.addClass(this._wrap,"yui-draggable");this.dd.unlock();}return this;},isLocked:function(){return this._locked;},reset:function(){this.resize(null,this._cache.start.height,this._cache.start.width,this._cache.start.top,this._cache.start.left,true);return this;},resize:function(M,J,P,Q,H,F,K){if(this._locked){return false;}this._resizeEvent=M;var G=this._wrap,I=this.get("animate"),O=true;if(this._proxy&&!F){G=this._proxy;I=false;}this._setAutoRatio(M);if(this._positioned){if(this._proxy){Q=this._cache.top-Q;H=this._cache.left-H;}}var L=this._setRatio(J,P,Q,H);J=parseInt(L[0],10);P=parseInt(L[1],10);Q=parseInt(L[2],10);H=parseInt(L[3],10);if(Q==0){Q=E.getY(G);}if(H==0){H=E.getX(G);}if(this._positioned){if(this._proxy&&F){if(!I){G.style.top=this._proxy.style.top;G.style.left=this._proxy.style.left;}else{Q=this._proxy.style.top;H=this._proxy.style.left;}}else{if(!this.get("ratio")&&!this._proxy){Q=this._cache.top+-(Q);H=this._cache.left+-(H);}if(Q){if(this.get("minY")){if(Q<this.get("minY")){Q=this.get("minY");}}if(this.get("maxY")){if(Q>this.get("maxY")){Q=this.get("maxY");}}}if(H){if(this.get("minX")){if(H<this.get("minX")){H=this.get("minX");
+}}if(this.get("maxX")){if((H+P)>this.get("maxX")){H=(this.get("maxX")-P);}}}}}if(!K){var N=this.fireEvent("beforeResize",{ev:"beforeResize",target:this,height:J,width:P,top:Q,left:H});if(N===false){return false;}}this._updateStatus(J,P,Q,H);if(this._positioned){if(this._proxy&&F){}else{if(Q){E.setY(G,Q);this._cache.top=Q;}if(H){E.setX(G,H);this._cache.left=H;}}}if(J){if(!I){O=true;if(this._proxy&&F){if(!this.get("setSize")){O=false;}}if(O){G.style.height=J+"px";}if((this._proxy&&F)||!this._proxy){if(this._wrap!=this.get("element")){this.get("element").style.height=J+"px";}}}this._cache.height=J;}if(P){this._cache.width=P;if(!I){O=true;if(this._proxy&&F){if(!this.get("setSize")){O=false;}}if(O){G.style.width=P+"px";}if((this._proxy&&F)||!this._proxy){if(this._wrap!=this.get("element")){this.get("element").style.width=P+"px";}}}}if(I){if(YAHOO.util.Anim){var D=new YAHOO.util.Anim(G,{height:{to:this._cache.height},width:{to:this._cache.width}},this.get("animateDuration"),this.get("animateEasing"));if(this._positioned){if(Q){D.attributes.top={to:parseInt(Q,10)};}if(H){D.attributes.left={to:parseInt(H,10)};}}if(this._wrap!=this.get("element")){D.onTween.subscribe(function(){this.get("element").style.height=G.style.height;this.get("element").style.width=G.style.width;},this,true);}D.onComplete.subscribe(function(){this.set("height",J);this.set("width",P);this.fireEvent("resize",{ev:"resize",target:this,height:J,width:P,top:Q,left:H});},this,true);D.animate();}}else{if(this._proxy&&!F){this.fireEvent("proxyResize",{ev:"proxyresize",target:this,height:J,width:P,top:Q,left:H});}else{this.fireEvent("resize",{ev:"resize",target:this,height:J,width:P,top:Q,left:H});}}return this;},_handle_for_br:function(F){var G=this._setWidth(F.e);var D=this._setHeight(F.e);this.resize(F.e,D,G,0,0);},_handle_for_bl:function(G){var H=this._setWidth(G.e,true);var F=this._setHeight(G.e);var D=(H-this._cache.width);this.resize(G.e,F,H,0,D);},_handle_for_tl:function(G){var I=this._setWidth(G.e,true);var F=this._setHeight(G.e,true);var H=(F-this._cache.height);var D=(I-this._cache.width);this.resize(G.e,F,I,H,D);},_handle_for_tr:function(F){var H=this._setWidth(F.e);var D=this._setHeight(F.e,true);var G=(D-this._cache.height);this.resize(F.e,D,H,G,0);},_handle_for_r:function(D){this._dds.r.setYConstraint(0,0);var F=this._setWidth(D.e);this.resize(D.e,0,F,0,0);},_handle_for_l:function(F){this._dds.l.setYConstraint(0,0);var G=this._setWidth(F.e,true);var D=(G-this._cache.width);this.resize(F.e,0,G,0,D);},_handle_for_b:function(F){this._dds.b.setXConstraint(0,0);var D=this._setHeight(F.e);this.resize(F.e,D,0,0,0);},_handle_for_t:function(F){this._dds.t.setXConstraint(0,0);var D=this._setHeight(F.e,true);var G=(D-this._cache.height);this.resize(F.e,D,0,G,0);},_setWidth:function(H,J){var I=this._cache.xy[0],G=this._cache.width,D=A.getPageX(H),F=(D-I);if(J){F=(I-D)+parseInt(this.get("width"),10);}F=this._snapTick(F,this.get("xTicks"));F=this._checkWidth(F);return F;},_checkWidth:function(D){if(this.get("minWidth")){if(D<=this.get("minWidth")){D=this.get("minWidth");}}if(this.get("maxWidth")){if(D>=this.get("maxWidth")){D=this.get("maxWidth");}}return D;},_checkHeight:function(D){if(this.get("minHeight")){if(D<=this.get("minHeight")){D=this.get("minHeight");}}if(this.get("maxHeight")){if(D>=this.get("maxHeight")){D=this.get("maxHeight");}}return D;},_setHeight:function(G,I){var H=this._cache.xy[1],F=this._cache.height,J=A.getPageY(G),D=(J-H);if(I){D=(H-J)+parseInt(this.get("height"),10);}D=this._snapTick(D,this.get("yTicks"));D=this._checkHeight(D);return D;},_snapTick:function(G,F){if(!G||!F){return G;}var H=G;var D=G%F;if(D>0){if(D>(F/2)){H=G+(F-D);}else{H=G-D;}}return H;},init:function(H,F){this._locked=false;this._cache={xy:[],height:0,width:0,top:0,left:0,offsetHeight:0,offsetWidth:0,start:{height:0,width:0,top:0,left:0}};B.superclass.init.call(this,H,F);this.set("setSize",this.get("setSize"));if(F.height){this.set("height",parseInt(F.height,10));}else{var G=this.getStyle("height");if(G=="auto"){this.set("height",parseInt(this.get("element").offsetHeight,10));}}if(F.width){this.set("width",parseInt(F.width,10));}else{var D=this.getStyle("width");if(D=="auto"){this.set("width",parseInt(this.get("element").offsetWidth,10));}}var I=H;if(!C.isString(I)){I=E.generateId(I);}B._instances[I]=this;this._active=false;this._createWrap();this._createProxy();this._createHandles();},getProxyEl:function(){return this._proxy;},getWrapEl:function(){return this._wrap;},getStatusEl:function(){return this._status;},getActiveHandleEl:function(){return this._handles[this._currentHandle];},isActive:function(){return((this._active)?true:false);},initAttributes:function(D){B.superclass.initAttributes.call(this,D);this.setAttributeConfig("useShim",{value:((D.useShim===true)?true:false),validator:YAHOO.lang.isBoolean,method:function(F){for(var G in this._dds){if(C.hasOwnProperty(this._dds,G)){this._dds[G].useShim=F;}}if(this.dd){this.dd.useShim=F;}}});this.setAttributeConfig("setSize",{value:((D.setSize===false)?false:true),validator:YAHOO.lang.isBoolean});this.setAttributeConfig("wrap",{writeOnce:true,validator:YAHOO.lang.isBoolean,value:D.wrap||false});this.setAttributeConfig("handles",{writeOnce:true,value:D.handles||["r","b","br"],validator:function(F){if(C.isString(F)&&F.toLowerCase()=="all"){F=["t","b","r","l","bl","br","tl","tr"];}if(!C.isArray(F)){F=F.replace(/, /g,",");F=F.split(",");}this._configs.handles.value=F;}});this.setAttributeConfig("width",{value:D.width||parseInt(this.getStyle("width"),10),validator:YAHOO.lang.isNumber,method:function(F){F=parseInt(F,10);if(F>0){if(this.get("setSize")){this.setStyle("width",F+"px");}this._cache.width=F;this._configs.width.value=F;}}});this.setAttributeConfig("height",{value:D.height||parseInt(this.getStyle("height"),10),validator:YAHOO.lang.isNumber,method:function(F){F=parseInt(F,10);if(F>0){if(this.get("setSize")){this.setStyle("height",F+"px");}this._cache.height=F;this._configs.height.value=F;
+}}});this.setAttributeConfig("minWidth",{value:D.minWidth||15,validator:YAHOO.lang.isNumber});this.setAttributeConfig("minHeight",{value:D.minHeight||15,validator:YAHOO.lang.isNumber});this.setAttributeConfig("maxWidth",{value:D.maxWidth||10000,validator:YAHOO.lang.isNumber});this.setAttributeConfig("maxHeight",{value:D.maxHeight||10000,validator:YAHOO.lang.isNumber});this.setAttributeConfig("minY",{value:D.minY||false});this.setAttributeConfig("minX",{value:D.minX||false});this.setAttributeConfig("maxY",{value:D.maxY||false});this.setAttributeConfig("maxX",{value:D.maxX||false});this.setAttributeConfig("animate",{value:D.animate||false,validator:function(G){var F=true;if(!YAHOO.util.Anim){F=false;}return F;}});this.setAttributeConfig("animateEasing",{value:D.animateEasing||function(){var F=false;if(YAHOO.util.Easing&&YAHOO.util.Easing.easeOut){F=YAHOO.util.Easing.easeOut;}return F;}()});this.setAttributeConfig("animateDuration",{value:D.animateDuration||0.5});this.setAttributeConfig("proxy",{value:D.proxy||false,validator:YAHOO.lang.isBoolean});this.setAttributeConfig("ratio",{value:D.ratio||false,validator:YAHOO.lang.isBoolean});this.setAttributeConfig("ghost",{value:D.ghost||false,validator:YAHOO.lang.isBoolean});this.setAttributeConfig("draggable",{value:D.draggable||false,validator:YAHOO.lang.isBoolean,method:function(F){if(F&&this._wrap&&!this.dd){this._setupDragDrop();}else{if(this.dd){if(F){E.addClass(this._wrap,this.CSS_DRAG);this.dd.DDM.regDragDrop(this.dd,"default");}else{E.removeClass(this._wrap,this.CSS_DRAG);this.dd.unreg();}}}}});this.setAttributeConfig("hover",{value:D.hover||false,validator:YAHOO.lang.isBoolean});this.setAttributeConfig("hiddenHandles",{value:D.hiddenHandles||false,validator:YAHOO.lang.isBoolean});this.setAttributeConfig("knobHandles",{value:D.knobHandles||false,validator:YAHOO.lang.isBoolean});this.setAttributeConfig("xTicks",{value:D.xTicks||false});this.setAttributeConfig("yTicks",{value:D.yTicks||false});this.setAttributeConfig("status",{value:D.status||false,validator:YAHOO.lang.isBoolean});this.setAttributeConfig("autoRatio",{value:D.autoRatio||false,validator:YAHOO.lang.isBoolean});},destroy:function(){for(var F in this._handles){if(C.hasOwnProperty(this._handles,F)){A.purgeElement(this._handles[F]);this._handles[F].parentNode.removeChild(this._handles[F]);}}if(this._proxy){this._proxy.parentNode.removeChild(this._proxy);}if(this._status){this._status.parentNode.removeChild(this._status);}if(this.dd){this.dd.unreg();E.removeClass(this._wrap,this.CSS_DRAG);}if(this._wrap!=this.get("element")){this.setStyle("position",(this._positioned?"absolute":"relative"));this.setStyle("top",E.getStyle(this._wrap,"top"));this.setStyle("left",E.getStyle(this._wrap,"left"));this._wrap.parentNode.replaceChild(this.get("element"),this._wrap);}this.removeClass(this.CSS_RESIZE);delete YAHOO.util.Resize._instances[this.get("id")];for(var D in this){if(C.hasOwnProperty(this,D)){this[D]=null;delete this[D];}}},toString:function(){if(this.get){return"Resize (#"+this.get("id")+")";}return"Resize Utility";}});YAHOO.util.Resize=B;})();YAHOO.register("resize",YAHOO.util.Resize,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/selector/selector-min.js b/js/yui/selector/selector-min.js
new file mode 100644 (file)
index 0000000..178c68a
--- /dev/null
+++ b/js/yui/selector/selector-min.js
@@ -0,0 +1,8 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+var Y=YAHOO,Y_DOM=YAHOO.util.Dom,EMPTY_ARRAY=[],Y_UA=Y.env.ua,Y_Lang=Y.lang,Y_DOC=document,Y_DOCUMENT_ELEMENT=Y_DOC.documentElement,Y_DOM_inDoc=Y_DOM.inDocument,Y_mix=Y_Lang.augmentObject,Y_guid=Y_DOM.generateId,Y_getDoc=function(a){var b=Y_DOC;if(a){b=(a.nodeType===9)?a:a.ownerDocument||a.document||Y_DOC;}return b;},Y_Array=function(g,d){var c,b,h=d||0;try{return Array.prototype.slice.call(g,h);}catch(f){b=[];c=g.length;for(;h<c;h++){b.push(g[h]);}return b;}},Y_DOM_allById=function(f,a){a=a||Y_DOC;var b=[],c=[],d,e;if(a.querySelectorAll){c=a.querySelectorAll('[id="'+f+'"]');}else{if(a.all){b=a.all(f);if(b){if(b.nodeName){if(b.id===f){c.push(b);b=EMPTY_ARRAY;}else{b=[b];}}if(b.length){for(d=0;e=b[d++];){if(e.id===f||(e.attributes&&e.attributes.id&&e.attributes.id.value===f)){c.push(e);}}}}}else{c=[Y_getDoc(a).getElementById(f)];}}return c;};var COMPARE_DOCUMENT_POSITION="compareDocumentPosition",OWNER_DOCUMENT="ownerDocument",Selector={_foundCache:[],useNative:true,_compare:("sourceIndex" in Y_DOCUMENT_ELEMENT)?function(f,e){var d=f.sourceIndex,c=e.sourceIndex;if(d===c){return 0;}else{if(d>c){return 1;}}return -1;}:(Y_DOCUMENT_ELEMENT[COMPARE_DOCUMENT_POSITION]?function(b,a){if(b[COMPARE_DOCUMENT_POSITION](a)&4){return -1;}else{return 1;}}:function(e,d){var c,a,b;if(e&&d){c=e[OWNER_DOCUMENT].createRange();c.setStart(e,0);a=d[OWNER_DOCUMENT].createRange();a.setStart(d,0);b=c.compareBoundaryPoints(1,a);}return b;}),_sort:function(a){if(a){a=Y_Array(a,0,true);if(a.sort){a.sort(Selector._compare);}}return a;},_deDupe:function(a){var b=[],c,d;for(c=0;(d=a[c++]);){if(!d._found){b[b.length]=d;d._found=true;}}for(c=0;(d=b[c++]);){d._found=null;d.removeAttribute("_found");}return b;},query:function(b,j,k,a){if(j&&typeof j=="string"){j=Y_DOM.get(j);if(!j){return(k)?null:[];}}else{j=j||Y_DOC;}var f=[],c=(Selector.useNative&&Y_DOC.querySelector&&!a),e=[[b,j]],g,l,d,h=(c)?Selector._nativeQuery:Selector._bruteQuery;if(b&&h){if(!a&&(!c||j.tagName)){e=Selector._splitQueries(b,j);}for(d=0;(g=e[d++]);){l=h(g[0],g[1],k);if(!k){l=Y_Array(l,0,true);}if(l){f=f.concat(l);}}if(e.length>1){f=Selector._sort(Selector._deDupe(f));}}return(k)?(f[0]||null):f;},_splitQueries:function(c,f){var b=c.split(","),d=[],g="",e,a;if(f){if(f.tagName){f.id=f.id||Y_guid();g='[id="'+f.id+'"] ';}for(e=0,a=b.length;e<a;++e){c=g+b[e];d.push([c,f]);}}return d;},_nativeQuery:function(a,b,c){if(Y_UA.webkit&&a.indexOf(":checked")>-1&&(Selector.pseudos&&Selector.pseudos.checked)){return Selector.query(a,b,c,true);}try{return b["querySelector"+(c?"":"All")](a);}catch(d){return Selector.query(a,b,c,true);}},filter:function(b,a){var c=[],d,e;if(b&&a){for(d=0;(e=b[d++]);){if(Selector.test(e,a)){c[c.length]=e;}}}else{}return c;},test:function(c,d,k){var g=false,b=d.split(","),a=false,l,o,h,n,f,e,m;if(c&&c.tagName){if(!k&&!Y_DOM_inDoc(c)){l=c.parentNode;if(l){k=l;}else{n=c[OWNER_DOCUMENT].createDocumentFragment();n.appendChild(c);k=n;a=true;}}k=k||c[OWNER_DOCUMENT];if(!c.id){c.id=Y_guid();}for(f=0;(m=b[f++]);){m+='[id="'+c.id+'"]';h=Selector.query(m,k);for(e=0;o=h[e++];){if(o===c){g=true;break;}}if(g){break;}}if(a){n.removeChild(c);}}return g;}};YAHOO.util.Selector=Selector;var PARENT_NODE="parentNode",TAG_NAME="tagName",ATTRIBUTES="attributes",COMBINATOR="combinator",PSEUDOS="pseudos",SelectorCSS2={_reRegExpTokens:/([\^\$\?\[\]\*\+\-\.\(\)\|\\])/,SORT_RESULTS:true,_children:function(e,a){var b=e.children,d,c=[],f,g;if(e.children&&a&&e.children.tags){c=e.children.tags(a);}else{if((!b&&e[TAG_NAME])||(b&&a)){f=b||e.childNodes;b=[];for(d=0;(g=f[d++]);){if(g.tagName){if(!a||a===g.tagName){b.push(g);}}}}}return b||[];},_re:{attr:/(\[[^\]]*\])/g,esc:/\\[:\[\]\(\)#\.\'\>+~"]/gi,pseudos:/(\([^\)]*\))/g},shorthand:{"\\#(-?[_a-z]+[-\\w\\uE000]*)":"[id=$1]","\\.(-?[_a-z]+[-\\w\\uE000]*)":"[className~=$1]"},operators:{"":function(b,a){return !!b.getAttribute(a);},"~=":"(?:^|\\s+){val}(?:\\s+|$)","|=":"^{val}(?:-|$)"},pseudos:{"first-child":function(a){return Selector._children(a[PARENT_NODE])[0]===a;}},_bruteQuery:function(f,j,l){var g=[],a=[],i=Selector._tokenize(f),e=i[i.length-1],k=Y_getDoc(j),c,b,h,d;if(e){b=e.id;h=e.className;d=e.tagName||"*";if(j.getElementsByTagName){if(b&&(j.all||(j.nodeType===9||Y_DOM_inDoc(j)))){a=Y_DOM_allById(b,j);}else{if(h){a=j.getElementsByClassName(h);}else{a=j.getElementsByTagName(d);}}}else{c=j.firstChild;while(c){if(c.tagName){a.push(c);}c=c.nextSilbing||c.firstChild;}}if(a.length){g=Selector._filterNodes(a,i,l);}}return g;},_filterNodes:function(l,f,h){var r=0,q,s=f.length,k=s-1,e=[],o=l[0],v=o,t=Selector.getters,d,p,c,g,a,m,b,u;for(r=0;(v=o=l[r++]);){k=s-1;g=null;testLoop:while(v&&v.tagName){c=f[k];b=c.tests;q=b.length;if(q&&!a){while((u=b[--q])){d=u[1];if(t[u[0]]){m=t[u[0]](v,u[0]);}else{m=v[u[0]];if(m===undefined&&v.getAttribute){m=v.getAttribute(u[0]);}}if((d==="="&&m!==u[2])||(typeof d!=="string"&&d.test&&!d.test(m))||(!d.test&&typeof d==="function"&&!d(v,u[0],u[2]))){if((v=v[g])){while(v&&(!v.tagName||(c.tagName&&c.tagName!==v.tagName))){v=v[g];}}continue testLoop;}}}k--;if(!a&&(p=c.combinator)){g=p.axis;v=v[g];while(v&&!v.tagName){v=v[g];}if(p.direct){g=null;}}else{e.push(o);if(h){return e;}break;}}}o=v=null;return e;},combinators:{" ":{axis:"parentNode"},">":{axis:"parentNode",direct:true},"+":{axis:"previousSibling",direct:true}},_parsers:[{name:ATTRIBUTES,re:/^\uE003(-?[a-z]+[\w\-]*)+([~\|\^\$\*!=]=?)?['"]?([^\uE004'"]*)['"]?\uE004/i,fn:function(d,e){var c=d[2]||"",a=Selector.operators,b=(d[3])?d[3].replace(/\\/g,""):"",f;if((d[1]==="id"&&c==="=")||(d[1]==="className"&&Y_DOCUMENT_ELEMENT.getElementsByClassName&&(c==="~="||c==="="))){e.prefilter=d[1];d[3]=b;e[d[1]]=(d[1]==="id")?d[3]:b;}if(c in a){f=a[c];if(typeof f==="string"){d[3]=b.replace(Selector._reRegExpTokens,"\\$1");f=new RegExp(f.replace("{val}",d[3]));}d[2]=f;}if(!e.last||e.prefilter!==d[1]){return d.slice(1);}}},{name:TAG_NAME,re:/^((?:-?[_a-z]+[\w-]*)|\*)/i,fn:function(b,c){var a=b[1].toUpperCase();c.tagName=a;if(a!=="*"&&(!c.last||c.prefilter)){return[TAG_NAME,"=",a];
+}if(!c.prefilter){c.prefilter="tagName";}}},{name:COMBINATOR,re:/^\s*([>+~]|\s)\s*/,fn:function(a,b){}},{name:PSEUDOS,re:/^:([\-\w]+)(?:\uE005['"]?([^\uE005]*)['"]?\uE006)*/i,fn:function(a,b){var c=Selector[PSEUDOS][a[1]];if(c){if(a[2]){a[2]=a[2].replace(/\\/g,"");}return[a[2],c];}else{return false;}}}],_getToken:function(a){return{tagName:null,id:null,className:null,attributes:{},combinator:null,tests:[]};},_tokenize:function(c){c=c||"";c=Selector._replaceShorthand(Y_Lang.trim(c));var b=Selector._getToken(),h=c,g=[],j=false,e,f,d,a;outer:do{j=false;for(d=0;(a=Selector._parsers[d++]);){if((e=a.re.exec(c))){if(a.name!==COMBINATOR){b.selector=c;}c=c.replace(e[0],"");if(!c.length){b.last=true;}if(Selector._attrFilters[e[1]]){e[1]=Selector._attrFilters[e[1]];}f=a.fn(e,b);if(f===false){j=false;break outer;}else{if(f){b.tests.push(f);}}if(!c.length||a.name===COMBINATOR){g.push(b);b=Selector._getToken(b);if(a.name===COMBINATOR){b.combinator=Selector.combinators[e[1]];}}j=true;}}}while(j&&c.length);if(!j||c.length){g=[];}return g;},_replaceShorthand:function(b){var d=Selector.shorthand,c=b.match(Selector._re.esc),e,h,g,f,a;if(c){b=b.replace(Selector._re.esc,"\uE000");}e=b.match(Selector._re.attr);h=b.match(Selector._re.pseudos);if(e){b=b.replace(Selector._re.attr,"\uE001");}if(h){b=b.replace(Selector._re.pseudos,"\uE002");}for(g in d){if(d.hasOwnProperty(g)){b=b.replace(new RegExp(g,"gi"),d[g]);}}if(e){for(f=0,a=e.length;f<a;++f){b=b.replace(/\uE001/,e[f]);}}if(h){for(f=0,a=h.length;f<a;++f){b=b.replace(/\uE002/,h[f]);}}b=b.replace(/\[/g,"\uE003");b=b.replace(/\]/g,"\uE004");b=b.replace(/\(/g,"\uE005");b=b.replace(/\)/g,"\uE006");if(c){for(f=0,a=c.length;f<a;++f){b=b.replace("\uE000",c[f]);}}return b;},_attrFilters:{"class":"className","for":"htmlFor"},getters:{href:function(b,a){return Y_DOM.getAttribute(b,a);}}};Y_mix(Selector,SelectorCSS2,true);Selector.getters.src=Selector.getters.rel=Selector.getters.href;if(Selector.useNative&&Y_DOC.querySelector){Selector.shorthand["\\.([^\\s\\\\(\\[:]*)"]="[class~=$1]";}Selector._reNth=/^(?:([\-]?\d*)(n){1}|(odd|even)$)*([\-+]?\d*)$/;Selector._getNth=function(d,o,q,h){Selector._reNth.test(o);var m=parseInt(RegExp.$1,10),c=RegExp.$2,j=RegExp.$3,k=parseInt(RegExp.$4,10)||0,p=[],l=Selector._children(d.parentNode,q),f;if(j){m=2;f="+";c="n";k=(j==="odd")?1:0;}else{if(isNaN(m)){m=(c)?1:0;}}if(m===0){if(h){k=l.length-k+1;}if(l[k-1]===d){return true;}else{return false;}}else{if(m<0){h=!!h;m=Math.abs(m);}}if(!h){for(var e=k-1,g=l.length;e<g;e+=m){if(e>=0&&l[e]===d){return true;}}}else{for(var e=l.length-k,g=l.length;e>=0;e-=m){if(e<g&&l[e]===d){return true;}}}return false;};Y_mix(Selector.pseudos,{"root":function(a){return a===a.ownerDocument.documentElement;},"nth-child":function(a,b){return Selector._getNth(a,b);},"nth-last-child":function(a,b){return Selector._getNth(a,b,null,true);},"nth-of-type":function(a,b){return Selector._getNth(a,b,a.tagName);},"nth-last-of-type":function(a,b){return Selector._getNth(a,b,a.tagName,true);},"last-child":function(b){var a=Selector._children(b.parentNode);return a[a.length-1]===b;},"first-of-type":function(a){return Selector._children(a.parentNode,a.tagName)[0]===a;},"last-of-type":function(b){var a=Selector._children(b.parentNode,b.tagName);return a[a.length-1]===b;},"only-child":function(b){var a=Selector._children(b.parentNode);return a.length===1&&a[0]===b;},"only-of-type":function(b){var a=Selector._children(b.parentNode,b.tagName);return a.length===1&&a[0]===b;},"empty":function(a){return a.childNodes.length===0;},"not":function(a,b){return !Selector.test(a,b);},"contains":function(a,b){var c=a.innerText||a.textContent||"";return c.indexOf(b)>-1;},"checked":function(a){return(a.checked===true||a.selected===true);},enabled:function(a){return(a.disabled!==undefined&&!a.disabled);},disabled:function(a){return(a.disabled);}});Y_mix(Selector.operators,{"^=":"^{val}","!=":function(b,a,c){return b[a]!==c;},"$=":"{val}$","*=":"{val}"});Selector.combinators["~"]={axis:"previousSibling"};YAHOO.register("selector",YAHOO.util.Selector,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/slider/slider-min.js b/js/yui/slider/slider-min.js
new file mode 100644 (file)
index 0000000..a6e60b9
--- /dev/null
+++ b/js/yui/slider/slider-min.js
@@ -0,0 +1,9 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){var B=YAHOO.util.Dom.getXY,A=YAHOO.util.Event,D=Array.prototype.slice;function C(G,E,F,H){C.ANIM_AVAIL=(!YAHOO.lang.isUndefined(YAHOO.util.Anim));if(G){this.init(G,E,true);this.initSlider(H);this.initThumb(F);}}YAHOO.lang.augmentObject(C,{getHorizSlider:function(F,G,I,H,E){return new C(F,F,new YAHOO.widget.SliderThumb(G,F,I,H,0,0,E),"horiz");},getVertSlider:function(G,H,E,I,F){return new C(G,G,new YAHOO.widget.SliderThumb(H,G,0,0,E,I,F),"vert");},getSliderRegion:function(G,H,J,I,E,K,F){return new C(G,G,new YAHOO.widget.SliderThumb(H,G,J,I,E,K,F),"region");},SOURCE_UI_EVENT:1,SOURCE_SET_VALUE:2,SOURCE_KEY_EVENT:3,ANIM_AVAIL:false},true);YAHOO.extend(C,YAHOO.util.DragDrop,{_mouseDown:false,dragOnly:true,initSlider:function(E){this.type=E;this.createEvent("change",this);this.createEvent("slideStart",this);this.createEvent("slideEnd",this);this.isTarget=false;this.animate=C.ANIM_AVAIL;this.backgroundEnabled=true;this.tickPause=40;this.enableKeys=true;this.keyIncrement=20;this.moveComplete=true;this.animationDuration=0.2;this.SOURCE_UI_EVENT=1;this.SOURCE_SET_VALUE=2;this.valueChangeSource=0;this._silent=false;this.lastOffset=[0,0];},initThumb:function(F){var E=this;this.thumb=F;F.cacheBetweenDrags=true;if(F._isHoriz&&F.xTicks&&F.xTicks.length){this.tickPause=Math.round(360/F.xTicks.length);}else{if(F.yTicks&&F.yTicks.length){this.tickPause=Math.round(360/F.yTicks.length);}}F.onAvailable=function(){return E.setStartSliderState();};F.onMouseDown=function(){E._mouseDown=true;return E.focus();};F.startDrag=function(){E._slideStart();};F.onDrag=function(){E.fireEvents(true);};F.onMouseUp=function(){E.thumbMouseUp();};},onAvailable:function(){this._bindKeyEvents();},_bindKeyEvents:function(){A.on(this.id,"keydown",this.handleKeyDown,this,true);A.on(this.id,"keypress",this.handleKeyPress,this,true);},handleKeyPress:function(F){if(this.enableKeys){var E=A.getCharCode(F);switch(E){case 37:case 38:case 39:case 40:case 36:case 35:A.preventDefault(F);break;default:}}},handleKeyDown:function(J){if(this.enableKeys){var G=A.getCharCode(J),F=this.thumb,H=this.getXValue(),E=this.getYValue(),I=true;switch(G){case 37:H-=this.keyIncrement;break;case 38:E-=this.keyIncrement;break;case 39:H+=this.keyIncrement;break;case 40:E+=this.keyIncrement;break;case 36:H=F.leftConstraint;E=F.topConstraint;break;case 35:H=F.rightConstraint;E=F.bottomConstraint;break;default:I=false;}if(I){if(F._isRegion){this._setRegionValue(C.SOURCE_KEY_EVENT,H,E,true);}else{this._setValue(C.SOURCE_KEY_EVENT,(F._isHoriz?H:E),true);}A.stopEvent(J);}}},setStartSliderState:function(){this.setThumbCenterPoint();this.baselinePos=B(this.getEl());this.thumb.startOffset=this.thumb.getOffsetFromParent(this.baselinePos);if(this.thumb._isRegion){if(this.deferredSetRegionValue){this._setRegionValue.apply(this,this.deferredSetRegionValue);this.deferredSetRegionValue=null;}else{this.setRegionValue(0,0,true,true,true);}}else{if(this.deferredSetValue){this._setValue.apply(this,this.deferredSetValue);this.deferredSetValue=null;}else{this.setValue(0,true,true,true);}}},setThumbCenterPoint:function(){var E=this.thumb.getEl();if(E){this.thumbCenterPoint={x:parseInt(E.offsetWidth/2,10),y:parseInt(E.offsetHeight/2,10)};}},lock:function(){this.thumb.lock();this.locked=true;},unlock:function(){this.thumb.unlock();this.locked=false;},thumbMouseUp:function(){this._mouseDown=false;if(!this.isLocked()){this.endMove();}},onMouseUp:function(){this._mouseDown=false;if(this.backgroundEnabled&&!this.isLocked()){this.endMove();}},getThumb:function(){return this.thumb;},focus:function(){this.valueChangeSource=C.SOURCE_UI_EVENT;var E=this.getEl();if(E.focus){try{E.focus();}catch(F){}}this.verifyOffset();return !this.isLocked();},onChange:function(E,F){},onSlideStart:function(){},onSlideEnd:function(){},getValue:function(){return this.thumb.getValue();},getXValue:function(){return this.thumb.getXValue();},getYValue:function(){return this.thumb.getYValue();},setValue:function(){var E=D.call(arguments);E.unshift(C.SOURCE_SET_VALUE);return this._setValue.apply(this,E);},_setValue:function(I,L,G,H,E){var F=this.thumb,K,J;if(!F.available){this.deferredSetValue=arguments;return false;}if(this.isLocked()&&!H){return false;}if(isNaN(L)){return false;}if(F._isRegion){return false;}this._silent=E;this.valueChangeSource=I||C.SOURCE_SET_VALUE;F.lastOffset=[L,L];this.verifyOffset();this._slideStart();if(F._isHoriz){K=F.initPageX+L+this.thumbCenterPoint.x;this.moveThumb(K,F.initPageY,G);}else{J=F.initPageY+L+this.thumbCenterPoint.y;this.moveThumb(F.initPageX,J,G);}return true;},setRegionValue:function(){var E=D.call(arguments);E.unshift(C.SOURCE_SET_VALUE);return this._setRegionValue.apply(this,E);},_setRegionValue:function(F,J,H,I,G,K){var L=this.thumb,E,M;if(!L.available){this.deferredSetRegionValue=arguments;return false;}if(this.isLocked()&&!G){return false;}if(isNaN(J)){return false;}if(!L._isRegion){return false;}this._silent=K;this.valueChangeSource=F||C.SOURCE_SET_VALUE;L.lastOffset=[J,H];this.verifyOffset();this._slideStart();E=L.initPageX+J+this.thumbCenterPoint.x;M=L.initPageY+H+this.thumbCenterPoint.y;this.moveThumb(E,M,I);return true;},verifyOffset:function(){var F=B(this.getEl()),E=this.thumb;if(!this.thumbCenterPoint||!this.thumbCenterPoint.x){this.setThumbCenterPoint();}if(F){if(F[0]!=this.baselinePos[0]||F[1]!=this.baselinePos[1]){this.setInitPosition();this.baselinePos=F;E.initPageX=this.initPageX+E.startOffset[0];E.initPageY=this.initPageY+E.startOffset[1];E.deltaSetXY=null;this.resetThumbConstraints();return false;}}return true;},moveThumb:function(K,J,I,G){var L=this.thumb,M=this,F,E,H;if(!L.available){return;}L.setDelta(this.thumbCenterPoint.x,this.thumbCenterPoint.y);E=L.getTargetCoord(K,J);F=[Math.round(E.x),Math.round(E.y)];if(this.animate&&L._graduated&&!I){this.lock();this.curCoord=B(this.thumb.getEl());this.curCoord=[Math.round(this.curCoord[0]),Math.round(this.curCoord[1])];setTimeout(function(){M.moveOneTick(F);},this.tickPause);}else{if(this.animate&&C.ANIM_AVAIL&&!I){this.lock();
+H=new YAHOO.util.Motion(L.id,{points:{to:F}},this.animationDuration,YAHOO.util.Easing.easeOut);H.onComplete.subscribe(function(){M.unlock();if(!M._mouseDown){M.endMove();}});H.animate();}else{L.setDragElPos(K,J);if(!G&&!this._mouseDown){this.endMove();}}}},_slideStart:function(){if(!this._sliding){if(!this._silent){this.onSlideStart();this.fireEvent("slideStart");}this._sliding=true;this.moveComplete=false;}},_slideEnd:function(){if(this._sliding){var E=this._silent;this._sliding=false;this.moveComplete=true;this._silent=false;if(!E){this.onSlideEnd();this.fireEvent("slideEnd");}}},moveOneTick:function(F){var H=this.thumb,G=this,I=null,E,J;if(H._isRegion){I=this._getNextX(this.curCoord,F);E=(I!==null)?I[0]:this.curCoord[0];I=this._getNextY(this.curCoord,F);J=(I!==null)?I[1]:this.curCoord[1];I=E!==this.curCoord[0]||J!==this.curCoord[1]?[E,J]:null;}else{if(H._isHoriz){I=this._getNextX(this.curCoord,F);}else{I=this._getNextY(this.curCoord,F);}}if(I){this.curCoord=I;this.thumb.alignElWithMouse(H.getEl(),I[0]+this.thumbCenterPoint.x,I[1]+this.thumbCenterPoint.y);if(!(I[0]==F[0]&&I[1]==F[1])){setTimeout(function(){G.moveOneTick(F);},this.tickPause);}else{this.unlock();if(!this._mouseDown){this.endMove();}}}else{this.unlock();if(!this._mouseDown){this.endMove();}}},_getNextX:function(E,F){var H=this.thumb,J,G=[],I=null;if(E[0]>F[0]){J=H.tickSize-this.thumbCenterPoint.x;G=H.getTargetCoord(E[0]-J,E[1]);I=[G.x,G.y];}else{if(E[0]<F[0]){J=H.tickSize+this.thumbCenterPoint.x;G=H.getTargetCoord(E[0]+J,E[1]);I=[G.x,G.y];}else{}}return I;},_getNextY:function(E,F){var H=this.thumb,J,G=[],I=null;if(E[1]>F[1]){J=H.tickSize-this.thumbCenterPoint.y;G=H.getTargetCoord(E[0],E[1]-J);I=[G.x,G.y];}else{if(E[1]<F[1]){J=H.tickSize+this.thumbCenterPoint.y;G=H.getTargetCoord(E[0],E[1]+J);I=[G.x,G.y];}else{}}return I;},b4MouseDown:function(E){if(!this.backgroundEnabled){return false;}this.thumb.autoOffset();this.baselinePos=[];},onMouseDown:function(F){if(!this.backgroundEnabled||this.isLocked()){return false;}this._mouseDown=true;var E=A.getPageX(F),G=A.getPageY(F);this.focus();this._slideStart();this.moveThumb(E,G);},onDrag:function(F){if(this.backgroundEnabled&&!this.isLocked()){var E=A.getPageX(F),G=A.getPageY(F);this.moveThumb(E,G,true,true);this.fireEvents();}},endMove:function(){this.unlock();this.fireEvents();this._slideEnd();},resetThumbConstraints:function(){var E=this.thumb;E.setXConstraint(E.leftConstraint,E.rightConstraint,E.xTickSize);E.setYConstraint(E.topConstraint,E.bottomConstraint,E.xTickSize);},fireEvents:function(G){var F=this.thumb,I,H,E;if(!G){F.cachePosition();}if(!this.isLocked()){if(F._isRegion){I=F.getXValue();H=F.getYValue();if(I!=this.previousX||H!=this.previousY){if(!this._silent){this.onChange(I,H);this.fireEvent("change",{x:I,y:H});}}this.previousX=I;this.previousY=H;}else{E=F.getValue();if(E!=this.previousVal){if(!this._silent){this.onChange(E);this.fireEvent("change",E);}}this.previousVal=E;}}},toString:function(){return("Slider ("+this.type+") "+this.id);}});YAHOO.lang.augmentProto(C,YAHOO.util.EventProvider);YAHOO.widget.Slider=C;})();YAHOO.widget.SliderThumb=function(G,B,E,D,A,F,C){if(G){YAHOO.widget.SliderThumb.superclass.constructor.call(this,G,B);this.parentElId=B;}this.isTarget=false;this.tickSize=C;this.maintainOffset=true;this.initSlider(E,D,A,F,C);this.scroll=false;};YAHOO.extend(YAHOO.widget.SliderThumb,YAHOO.util.DD,{startOffset:null,dragOnly:true,_isHoriz:false,_prevVal:0,_graduated:false,getOffsetFromParent0:function(C){var A=YAHOO.util.Dom.getXY(this.getEl()),B=C||YAHOO.util.Dom.getXY(this.parentElId);return[(A[0]-B[0]),(A[1]-B[1])];},getOffsetFromParent:function(H){var A=this.getEl(),E,I,F,B,K,D,C,J,G;if(!this.deltaOffset){I=YAHOO.util.Dom.getXY(A);F=H||YAHOO.util.Dom.getXY(this.parentElId);E=[(I[0]-F[0]),(I[1]-F[1])];B=parseInt(YAHOO.util.Dom.getStyle(A,"left"),10);K=parseInt(YAHOO.util.Dom.getStyle(A,"top"),10);D=B-E[0];C=K-E[1];if(isNaN(D)||isNaN(C)){}else{this.deltaOffset=[D,C];}}else{J=parseInt(YAHOO.util.Dom.getStyle(A,"left"),10);G=parseInt(YAHOO.util.Dom.getStyle(A,"top"),10);E=[J+this.deltaOffset[0],G+this.deltaOffset[1]];}return E;},initSlider:function(D,C,A,E,B){this.initLeft=D;this.initRight=C;this.initUp=A;this.initDown=E;this.setXConstraint(D,C,B);this.setYConstraint(A,E,B);if(B&&B>1){this._graduated=true;}this._isHoriz=(D||C);this._isVert=(A||E);this._isRegion=(this._isHoriz&&this._isVert);},clearTicks:function(){YAHOO.widget.SliderThumb.superclass.clearTicks.call(this);this.tickSize=0;this._graduated=false;},getValue:function(){return(this._isHoriz)?this.getXValue():this.getYValue();},getXValue:function(){if(!this.available){return 0;}var A=this.getOffsetFromParent();if(YAHOO.lang.isNumber(A[0])){this.lastOffset=A;return(A[0]-this.startOffset[0]);}else{return(this.lastOffset[0]-this.startOffset[0]);}},getYValue:function(){if(!this.available){return 0;}var A=this.getOffsetFromParent();if(YAHOO.lang.isNumber(A[1])){this.lastOffset=A;return(A[1]-this.startOffset[1]);}else{return(this.lastOffset[1]-this.startOffset[1]);}},toString:function(){return"SliderThumb "+this.id;},onChange:function(A,B){}});(function(){var A=YAHOO.util.Event,B=YAHOO.widget;function C(I,F,H,D){var G=this,J={min:false,max:false},E,K;this.minSlider=I;this.maxSlider=F;this.activeSlider=I;this.isHoriz=I.thumb._isHoriz;E=this.minSlider.thumb.onMouseDown;K=this.maxSlider.thumb.onMouseDown;this.minSlider.thumb.onMouseDown=function(){G.activeSlider=G.minSlider;E.apply(this,arguments);};this.maxSlider.thumb.onMouseDown=function(){G.activeSlider=G.maxSlider;K.apply(this,arguments);};this.minSlider.thumb.onAvailable=function(){I.setStartSliderState();J.min=true;if(J.max){G.fireEvent("ready",G);}};this.maxSlider.thumb.onAvailable=function(){F.setStartSliderState();J.max=true;if(J.min){G.fireEvent("ready",G);}};I.onMouseDown=F.onMouseDown=function(L){return this.backgroundEnabled&&G._handleMouseDown(L);};I.onDrag=F.onDrag=function(L){G._handleDrag(L);};I.onMouseUp=F.onMouseUp=function(L){G._handleMouseUp(L);
+};I._bindKeyEvents=function(){G._bindKeyEvents(this);};F._bindKeyEvents=function(){};I.subscribe("change",this._handleMinChange,I,this);I.subscribe("slideStart",this._handleSlideStart,I,this);I.subscribe("slideEnd",this._handleSlideEnd,I,this);F.subscribe("change",this._handleMaxChange,F,this);F.subscribe("slideStart",this._handleSlideStart,F,this);F.subscribe("slideEnd",this._handleSlideEnd,F,this);this.createEvent("ready",this);this.createEvent("change",this);this.createEvent("slideStart",this);this.createEvent("slideEnd",this);D=YAHOO.lang.isArray(D)?D:[0,H];D[0]=Math.min(Math.max(parseInt(D[0],10)|0,0),H);D[1]=Math.max(Math.min(parseInt(D[1],10)|0,H),0);if(D[0]>D[1]){D.splice(0,2,D[1],D[0]);}this.minVal=D[0];this.maxVal=D[1];this.minSlider.setValue(this.minVal,true,true,true);this.maxSlider.setValue(this.maxVal,true,true,true);}C.prototype={minVal:-1,maxVal:-1,minRange:0,_handleSlideStart:function(E,D){this.fireEvent("slideStart",D);},_handleSlideEnd:function(E,D){this.fireEvent("slideEnd",D);},_handleDrag:function(D){B.Slider.prototype.onDrag.call(this.activeSlider,D);},_handleMinChange:function(){this.activeSlider=this.minSlider;this.updateValue();},_handleMaxChange:function(){this.activeSlider=this.maxSlider;this.updateValue();},_bindKeyEvents:function(D){A.on(D.id,"keydown",this._handleKeyDown,this,true);A.on(D.id,"keypress",this._handleKeyPress,this,true);},_handleKeyDown:function(D){this.activeSlider.handleKeyDown.apply(this.activeSlider,arguments);},_handleKeyPress:function(D){this.activeSlider.handleKeyPress.apply(this.activeSlider,arguments);},setValues:function(H,K,I,E,J){var F=this.minSlider,M=this.maxSlider,D=F.thumb,L=M.thumb,N=this,G={min:false,max:false};if(D._isHoriz){D.setXConstraint(D.leftConstraint,L.rightConstraint,D.tickSize);L.setXConstraint(D.leftConstraint,L.rightConstraint,L.tickSize);}else{D.setYConstraint(D.topConstraint,L.bottomConstraint,D.tickSize);L.setYConstraint(D.topConstraint,L.bottomConstraint,L.tickSize);}this._oneTimeCallback(F,"slideEnd",function(){G.min=true;if(G.max){N.updateValue(J);setTimeout(function(){N._cleanEvent(F,"slideEnd");N._cleanEvent(M,"slideEnd");},0);}});this._oneTimeCallback(M,"slideEnd",function(){G.max=true;if(G.min){N.updateValue(J);setTimeout(function(){N._cleanEvent(F,"slideEnd");N._cleanEvent(M,"slideEnd");},0);}});F.setValue(H,I,E,false);M.setValue(K,I,E,false);},setMinValue:function(F,H,I,E){var G=this.minSlider,D=this;this.activeSlider=G;D=this;this._oneTimeCallback(G,"slideEnd",function(){D.updateValue(E);setTimeout(function(){D._cleanEvent(G,"slideEnd");},0);});G.setValue(F,H,I);},setMaxValue:function(D,H,I,F){var G=this.maxSlider,E=this;this.activeSlider=G;this._oneTimeCallback(G,"slideEnd",function(){E.updateValue(F);setTimeout(function(){E._cleanEvent(G,"slideEnd");},0);});G.setValue(D,H,I);},updateValue:function(J){var E=this.minSlider.getValue(),K=this.maxSlider.getValue(),F=false,D,M,H,I,L,G;if(E!=this.minVal||K!=this.maxVal){F=true;D=this.minSlider.thumb;M=this.maxSlider.thumb;H=this.isHoriz?"x":"y";G=this.minSlider.thumbCenterPoint[H]+this.maxSlider.thumbCenterPoint[H];I=Math.max(K-G-this.minRange,0);L=Math.min(-E-G-this.minRange,0);if(this.isHoriz){I=Math.min(I,M.rightConstraint);D.setXConstraint(D.leftConstraint,I,D.tickSize);M.setXConstraint(L,M.rightConstraint,M.tickSize);}else{I=Math.min(I,M.bottomConstraint);D.setYConstraint(D.leftConstraint,I,D.tickSize);M.setYConstraint(L,M.bottomConstraint,M.tickSize);}}this.minVal=E;this.maxVal=K;if(F&&!J){this.fireEvent("change",this);}},selectActiveSlider:function(H){var E=this.minSlider,D=this.maxSlider,J=E.isLocked()||!E.backgroundEnabled,G=D.isLocked()||!E.backgroundEnabled,F=YAHOO.util.Event,I;if(J||G){this.activeSlider=J?D:E;}else{if(this.isHoriz){I=F.getPageX(H)-E.thumb.initPageX-E.thumbCenterPoint.x;}else{I=F.getPageY(H)-E.thumb.initPageY-E.thumbCenterPoint.y;}this.activeSlider=I*2>D.getValue()+E.getValue()?D:E;}},_handleMouseDown:function(D){if(!D._handled&&!this.minSlider._sliding&&!this.maxSlider._sliding){D._handled=true;this.selectActiveSlider(D);return B.Slider.prototype.onMouseDown.call(this.activeSlider,D);}else{return false;}},_handleMouseUp:function(D){B.Slider.prototype.onMouseUp.apply(this.activeSlider,arguments);},_oneTimeCallback:function(G,D,F){var E=function(){G.unsubscribe(D,E);F.apply({},arguments);};G.subscribe(D,E);},_cleanEvent:function(K,E){var J,I,D,G,H,F;if(K.__yui_events&&K.events[E]){for(I=K.__yui_events.length;I>=0;--I){if(K.__yui_events[I].type===E){J=K.__yui_events[I];break;}}if(J){H=J.subscribers;F=[];G=0;for(I=0,D=H.length;I<D;++I){if(H[I]){F[G++]=H[I];}}J.subscribers=F;}}}};YAHOO.lang.augmentProto(C,YAHOO.util.EventProvider);B.Slider.getHorizDualSlider=function(H,J,K,G,F,D){var I=new B.SliderThumb(J,H,0,G,0,0,F),E=new B.SliderThumb(K,H,0,G,0,0,F);return new C(new B.Slider(H,H,I,"horiz"),new B.Slider(H,H,E,"horiz"),G,D);};B.Slider.getVertDualSlider=function(H,J,K,G,F,D){var I=new B.SliderThumb(J,H,0,0,0,G,F),E=new B.SliderThumb(K,H,0,0,0,G,F);return new B.DualSlider(new B.Slider(H,H,I,"vert"),new B.Slider(H,H,E,"vert"),G,D);};YAHOO.widget.DualSlider=C;})();YAHOO.register("slider",YAHOO.widget.Slider,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/storage/storage-min.js b/js/yui/storage/storage-min.js
new file mode 100644 (file)
index 0000000..8cf0932
--- /dev/null
+++ b/js/yui/storage/storage-min.js
@@ -0,0 +1,8 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){var g=YAHOO,f=g.util,e=g.lang,c,d,b=/^type=(\w+)/i,a=/&value=(.*)/i;if(!f.Storage){c=function(h){g.log("Exception in YAHOO.util.Storage.?? - must be extended by a storage engine".replace("??",h).replace("??",this.getName?this.getName():"Unknown"),"error");};d=function(h,k,j){var i=this;g.env._id_counter+=1;i._cfg=e.isObject(j)?j:{};i._location=h;i._name=k;i.isReady=false;i.createEvent(d.CE_READY,{scope:i,fireOnce:true});i.createEvent(d.CE_CHANGE,{scope:i});i.subscribe(d.CE_READY,function(){i.isReady=true;});};d.CE_READY="YUIStorageReady";d.CE_CHANGE="YUIStorageChange";d.prototype={CE_READY:d.CE_READY,CE_CHANGE:d.CE_CHANGE,_cfg:"",_name:"",_location:"",length:0,isReady:false,clear:function(){this._clear();this.length=0;},getItem:function(h){g.log("Fetching item at  "+h);var i=this._getItem(h);return e.isValue(i)?this._getValue(i):null;},getName:function(){return this._name;},hasKey:function(h){return e.isString(h)&&this._hasKey(h);},key:function(h){g.log("Fetching key at "+h);if(e.isNumber(h)&&-1<h&&this.length>h){var i=this._key(h);if(i){return i;}}throw ("INDEX_SIZE_ERR - Storage.setItem - The provided index ("+h+") is not available");},removeItem:function(j){g.log("removing "+j);var i=this,h;if(i.hasKey(j)){h=i._getItem(j);if(!h){h=null;}i._removeItem(j);i.fireEvent(d.CE_CHANGE,new f.StorageEvent(i,j,h,null,f.StorageEvent.TYPE_REMOVE_ITEM));}else{}},setItem:function(j,k){g.log("SETTING "+k+" to "+j);if(e.isString(j)){var i=this,h=i._getItem(j);if(!h){h=null;}if(i._setItem(j,i._createValue(k))){i.fireEvent(d.CE_CHANGE,new f.StorageEvent(i,j,h,k,i.hasKey(j)?f.StorageEvent.TYPE_UPDATE_ITEM:f.StorageEvent.TYPE_ADD_ITEM));}else{throw ("QUOTA_EXCEEDED_ERROR - Storage.setItem - The choosen storage method ("+i.getName()+") has exceeded capacity");}}else{}},_clear:function(){c("_clear");return"";},_createValue:function(h){var i=(e.isNull(h)||e.isUndefined(h))?(""+h):typeof h;return"type="+i+"&value="+encodeURIComponent(""+h);},_getItem:function(h){c("_getItem");return"";},_getValue:function(h){var j=h.match(b)[1],i=h.match(a)[1];switch(j){case"boolean":return"true"==i;case"number":return parseFloat(i);case"null":return null;default:return decodeURIComponent(i);}},_key:function(h){c("_key");return"";},_hasKey:function(h){return null!==this._getItem(h);},_removeItem:function(h){c("_removeItem");return"";},_setItem:function(h,i){c("_setItem");return"";}};e.augmentProto(d,f.EventProvider);f.Storage=d;}}());(function(){var h=YAHOO.util,e=YAHOO.lang,d={},g=[],f={},b=function(i){return(i&&i.isAvailable())?i:null;},a=function(i,l,k){var j=d[i+l.ENGINE_NAME];if(!j){j=new l(i,k);d[i+l.ENGINE_NAME]=j;}return j;},c=function(i){switch(i){case h.StorageManager.LOCATION_LOCAL:case h.StorageManager.LOCATION_SESSION:return i;default:return h.StorageManager.LOCATION_SESSION;}};h.StorageManager={LOCATION_SESSION:"sessionStorage",LOCATION_LOCAL:"localStorage",get:function(q,k,p){var n=e.isObject(p)?p:{},o=b(f[q]),m,l;if(!o&&!n.force){if(n.order){l=n.order.length;for(m=0;m<l&&!o;m+=1){o=b(n.order[m]);}}if(!o){l=g.length;for(m=0;m<l&&!o;m+=1){o=b(g[m]);}}}if(o){return a(c(k),o,n.engine);}throw ("YAHOO.util.StorageManager.get - No engine available, please include an engine before calling this function.");},getByteSize:function(i){return encodeURIComponent(""+i).length;},register:function(i){if(e.isFunction(i)&&e.isFunction(i.isAvailable)&&e.isString(i.ENGINE_NAME)){f[i.ENGINE_NAME]=i;g.push(i);return true;}return false;}};YAHOO.register("StorageManager",h.SWFStore,{version:"2.9.0",build:"2800"});}());(function(){function a(e,d,c,b,f){this.key=d;this.oldValue=c;this.newValue=b;this.url=window.location.href;this.window=window;this.storageArea=e;this.type=f;}YAHOO.lang.augmentObject(a,{TYPE_ADD_ITEM:"addItem",TYPE_REMOVE_ITEM:"removeItem",TYPE_UPDATE_ITEM:"updateItem"});a.prototype={key:null,newValue:null,oldValue:null,source:null,storageArea:null,type:null,url:null};YAHOO.util.StorageEvent=a;}());(function(){var a=YAHOO.util;a.StorageEngineKeyed=function(){a.StorageEngineKeyed.superclass.constructor.apply(this,arguments);this._keys=[];this._keyMap={};};YAHOO.lang.extend(a.StorageEngineKeyed,a.Storage,{_keys:null,_keyMap:null,_addKey:function(b){if(!this._keyMap.hasOwnProperty(b)){this._keys.push(b);this._keyMap[b]=this.length;this.length=this._keys.length;}},_clear:function(){this._keys=[];this.length=0;},_indexOfKey:function(c){var b=this._keyMap[c];return undefined===b?-1:b;},_key:function(b){return this._keys[b];},_removeItem:function(f){var e=this,c=e._indexOfKey(f),d=e._keys.slice(c+1),b;delete e._keyMap[f];for(b in e._keyMap){if(c<e._keyMap[b]){e._keyMap[b]-=1;}}e._keys.length=c;e._keys=e._keys.concat(d);e.length=e._keys.length;}});}());(function(){var e=YAHOO.util,c=YAHOO.lang,a=function(f){f.begin();},b=function(f){f.commit();},d=function(f,h){var g=this,i=window[f];d.superclass.constructor.call(g,f,d.ENGINE_NAME,h);if(!i.begin){a=function(){};}if(!i.commit){b=function(){};}g.length=i.length;g._driver=i;g.fireEvent(e.Storage.CE_READY);};c.extend(d,e.Storage,{_driver:null,_clear:function(){var g=this,f,h;if(g._driver.clear){g._driver.clear();}else{for(f=g.length;0<=f;f-=1){h=g._key(f);g._removeItem(h);}}},_getItem:function(f){var g=this._driver.getItem(f);return c.isObject(g)?g.value:g;},_key:function(f){return this._driver.key(f);},_removeItem:function(f){var g=this._driver;a(g);g.removeItem(f);b(g);this.length=g.length;},_setItem:function(g,f){var i=this._driver;try{a(i);i.setItem(g,f);b(i);this.length=i.length;return true;}catch(h){return false;}}},true);d.ENGINE_NAME="html5";d.isAvailable=function(){try{return("localStorage" in window)&&window["localStorage"]!==null&&("sessionStorage" in window)&&window["sessionStorage"]!==null;}catch(f){return false;}};e.StorageManager.register(d);e.StorageEngineHTML5=d;}());(function(){var h=YAHOO.util,d=YAHOO.lang,e=9948,g="YUIStorageEngine",b=null,f=encodeURIComponent,a=decodeURIComponent,c=function(l,o){var n=this,p={},k,i,j;c.superclass.constructor.call(n,l,c.ENGINE_NAME,o);
+if(!b){b=google.gears.factory.create(c.GEARS);b.open(window.location.host.replace(/[\/\:\*\?"\<\>\|;,]/g,"")+"-"+c.DATABASE);b.execute("CREATE TABLE IF NOT EXISTS "+g+" (key TEXT, location TEXT, value TEXT)");}k=h.StorageManager.LOCATION_SESSION===n._location;i=h.Cookie.get("sessionKey"+c.ENGINE_NAME);if(!i){b.execute("BEGIN");b.execute("DELETE FROM "+g+' WHERE location="'+f(h.StorageManager.LOCATION_SESSION)+'"');b.execute("COMMIT");}j=b.execute("SELECT key FROM "+g+' WHERE location="'+f(n._location)+'"');p={};try{while(j.isValidRow()){var m=a(j.field(0));if(!p[m]){p[m]=true;n._addKey(m);}j.next();}}finally{j.close();}if(k){h.Cookie.set("sessionKey"+c.ENGINE_NAME,true);}n.fireEvent(h.Storage.CE_READY);};d.extend(c,h.StorageEngineKeyed,{_clear:function(){c.superclass._clear.call(this);b.execute("BEGIN");b.execute("DELETE FROM "+g+' WHERE location="'+f(this._location)+'"');b.execute("COMMIT");},_getItem:function(k){var i=b.execute("SELECT value FROM "+g+' WHERE key="'+f(k)+'" AND location="'+f(this._location)+'"'),j="";try{while(i.isValidRow()){j+=i.field(0);i.next();}}finally{i.close();}return j?a(j):null;},_removeItem:function(i){c.superclass._removeItem.call(this,i);b.execute("BEGIN");b.execute("DELETE FROM "+g+' WHERE key="'+f(i)+'" AND location="'+f(this._location)+'"');b.execute("COMMIT");},_setItem:function(r,k){this._addKey(r);var l=f(r),m=f(this._location),p=f(k),q=[],s=e-(l+m).length,o=0,n;if(s<p.length){for(n=p.length;o<n;o+=s){q.push(p.substr(o,s));}}else{q.push(p);}b.execute("BEGIN");b.execute("DELETE FROM "+g+' WHERE key="'+l+'" AND location="'+m+'"');for(o=0,n=q.length;o<n;o+=1){b.execute("INSERT INTO "+g+' VALUES ("'+l+'", "'+m+'", "'+q[o]+'")');}b.execute("COMMIT");return true;}});h.Event.on("unload",function(){if(b){b.close();}});c.ENGINE_NAME="gears";c.GEARS="beta.database";c.DATABASE="yui.database";c.isAvailable=function(){if(("google" in window)&&("gears" in window.google)){try{google.gears.factory.create(c.GEARS);return true;}catch(i){}}return false;};h.StorageManager.register(c);h.StorageEngineGears=c;}());(function(){var b=YAHOO,i=b.util,g=b.lang,f=i.Dom,j=i.StorageManager,c=215,h=138,d=new RegExp("^("+j.LOCATION_SESSION+"|"+j.LOCATION_LOCAL+")"),e=null,k=function(m,n){return m._location+n;},a=function(n){if(!e){if(!g.isString(n.swfURL)){n.swfURL=l.SWFURL;}if(!n.containerID){var o=document.getElementsByTagName("body")[0],m=o.appendChild(document.createElement("div"));n.containerID=f.generateId(m);}if(!n.attributes){n.attributes={};}if(!n.attributes.flashVars){n.attributes.flashVars={};}n.attributes.flashVars.allowedDomain=document.location.hostname;n.attributes.flashVars.useCompression="true";n.attributes.version=9.115;e=new b.widget.SWF(n.containerID,n.swfURL,n.attributes);e.subscribe("save",function(p){b.log(p.message,"info");});e.subscribe("quotaExceededError",function(p){b.log(p.message,"error");});e.subscribe("inadequateDimensions",function(p){b.log(p.message,"error");});e.subscribe("error",function(p){b.log(p.message,"error");});e.subscribe("securityError",function(p){b.log(p.message,"error");});}},l=function(m,p){var o=this;l.superclass.constructor.call(o,m,l.ENGINE_NAME,p);a(o._cfg);var n=function(){o._swf=e._swf;e.initialized=true;var s=j.LOCATION_SESSION===o._location,r=i.Cookie.get("sessionKey"+l.ENGINE_NAME),u,t,q;for(u=e.callSWF("getLength",[])-1;0<=u;u-=1){t=e.callSWF("getNameAt",[u]);q=s&&(-1<t.indexOf(j.LOCATION_SESSION));if(q&&!r){e.callSWF("removeItem",[t]);}else{if(s===q){o._addKey(t);}}}if(s){i.Cookie.set("sessionKey"+l.ENGINE_NAME,true);}o.fireEvent(i.Storage.CE_READY);};if(e.initialized){n();}else{e.addListener("contentReady",n);}};g.extend(l,i.StorageEngineKeyed,{_swf:null,_clear:function(){for(var m=this._keys.length-1,n;0<=m;m-=1){n=this._keys[m];e.callSWF("removeItem",[n]);}l.superclass._clear.call(this);},_getItem:function(m){var n=k(this,m);return e.callSWF("getValueOf",[n]);},_key:function(m){return l.superclass._key.call(this,m).replace(d,"");},_removeItem:function(m){b.log("removing SWF key: "+m);var n=k(this,m);l.superclass._removeItem.call(this,n);e.callSWF("removeItem",[n]);},_setItem:function(m,p){var n=k(this,m),o;if(e.callSWF("setItem",[n,p])){this._addKey(n);return true;}else{o=f.get(e._id);if(c>f.getStyle(o,"width").replace(/\D+/g,"")){f.setStyle(o,"width",c+"px");}if(h>f.getStyle(o,"height").replace(/\D+/g,"")){f.setStyle(o,"height",h+"px");}b.log("attempting to show settings. are dimensions adequate? "+e.callSWF("hasAdequateDimensions"));return e.callSWF("displaySettings",[]);}}});l.SWFURL="swfstore.swf";l.ENGINE_NAME="swf";l.isAvailable=function(){return(6<=b.env.ua.flash&&b.widget.SWF);};j.register(l);i.StorageEngineSWF=l;}());YAHOO.register("storage",YAHOO.util.Storage,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/stylesheet/stylesheet-min.js b/js/yui/stylesheet/stylesheet-min.js
new file mode 100644 (file)
index 0000000..fbb918d
--- /dev/null
+++ b/js/yui/stylesheet/stylesheet-min.js
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){var j=document,b=j.createElement("p"),e=b.style,c=YAHOO.lang,m={},i={},f=0,k=("cssFloat" in e)?"cssFloat":"styleFloat",g,a,l;a=("opacity" in e)?function(d){d.opacity="";}:function(d){d.filter="";};e.border="1px solid red";e.border="";l=e.borderLeft?function(d,o){var n;if(o!==k&&o.toLowerCase().indexOf("float")!=-1){o=k;}if(typeof d[o]==="string"){switch(o){case"opacity":case"filter":a(d);break;case"font":d.font=d.fontStyle=d.fontVariant=d.fontWeight=d.fontSize=d.lineHeight=d.fontFamily="";break;default:for(n in d){if(n.indexOf(o)===0){d[n]="";}}}}}:function(d,n){if(n!==k&&n.toLowerCase().indexOf("float")!=-1){n=k;}if(c.isString(d[n])){if(n==="opacity"){a(d);}else{d[n]="";}}};function h(u,o){var x,s,w,v={},n,y,q,t,d,p;if(!(this instanceof h)){return new h(u,o);}s=u&&(u.nodeName?u:j.getElementById(u));if(u&&i[u]){return i[u];}else{if(s&&s.yuiSSID&&i[s.yuiSSID]){return i[s.yuiSSID];}}if(!s||!/^(?:style|link)$/i.test(s.nodeName)){s=j.createElement("style");s.type="text/css";}if(c.isString(u)){if(u.indexOf("{")!=-1){if(s.styleSheet){s.styleSheet.cssText=u;}else{s.appendChild(j.createTextNode(u));}}else{if(!o){o=u;}}}if(!s.parentNode||s.parentNode.nodeName.toLowerCase()!=="head"){x=(s.ownerDocument||j).getElementsByTagName("head")[0];x.appendChild(s);}w=s.sheet||s.styleSheet;n=w&&("cssRules" in w)?"cssRules":"rules";q=("deleteRule" in w)?function(r){w.deleteRule(r);}:function(r){w.removeRule(r);};y=("insertRule" in w)?function(A,z,r){w.insertRule(A+" {"+z+"}",r);}:function(A,z,r){w.addRule(A,z,r);};for(t=w[n].length-1;t>=0;--t){d=w[n][t];p=d.selectorText;if(v[p]){v[p].style.cssText+=";"+d.style.cssText;q(t);}else{v[p]=d;}}s.yuiSSID="yui-stylesheet-"+(f++);h.register(s.yuiSSID,this);if(o){h.register(o,this);}c.augmentObject(this,{getId:function(){return s.yuiSSID;},node:s,enable:function(){w.disabled=false;return this;},disable:function(){w.disabled=true;return this;},isEnabled:function(){return !w.disabled;},set:function(B,A){var D=v[B],C=B.split(/\s*,\s*/),z,r;if(C.length>1){for(z=C.length-1;z>=0;--z){this.set(C[z],A);}return this;}if(!h.isValidSelector(B)){return this;}if(D){D.style.cssText=h.toCssText(A,D.style.cssText);}else{r=w[n].length;A=h.toCssText(A);if(A){y(B,A,r);v[B]=w[n][r];}}return this;},unset:function(B,A){var D=v[B],C=B.split(/\s*,\s*/),r=!A,E,z;if(C.length>1){for(z=C.length-1;z>=0;--z){this.unset(C[z],A);}return this;}if(D){if(!r){if(!c.isArray(A)){A=[A];}e.cssText=D.style.cssText;for(z=A.length-1;z>=0;--z){l(e,A[z]);}if(e.cssText){D.style.cssText=e.cssText;}else{r=true;}}if(r){E=w[n];for(z=E.length-1;z>=0;--z){if(E[z]===D){delete v[B];q(z);break;}}}}return this;},getCssText:function(A){var B,z,r;if(c.isString(A)){B=v[A.split(/\s*,\s*/)[0]];return B?B.style.cssText:null;}else{z=[];for(r in v){if(v.hasOwnProperty(r)){B=v[r];z.push(B.selectorText+" {"+B.style.cssText+"}");}}return z.join("\n");}}},true);}g=function(n,p){var o=n.styleFloat||n.cssFloat||n["float"],r;try{e.cssText=p||"";}catch(d){b=j.createElement("p");e=b.style;e.cssText=p||"";}if(c.isString(n)){e.cssText+=";"+n;}else{if(o&&!n[k]){n=c.merge(n);delete n.styleFloat;delete n.cssFloat;delete n["float"];n[k]=o;}for(r in n){if(n.hasOwnProperty(r)){try{e[r]=c.trim(n[r]);}catch(q){}}}}return e.cssText;};c.augmentObject(h,{toCssText:(("opacity" in e)?g:function(d,n){if(c.isObject(d)&&"opacity" in d){d=c.merge(d,{filter:"alpha(opacity="+(d.opacity*100)+")"});delete d.opacity;}return g(d,n);}),register:function(d,n){return !!(d&&n instanceof h&&!i[d]&&(i[d]=n));},isValidSelector:function(n){var d=false;if(n&&c.isString(n)){if(!m.hasOwnProperty(n)){m[n]=!/\S/.test(n.replace(/\s+|\s*[+~>]\s*/g," ").replace(/([^ ])\[.*?\]/g,"$1").replace(/([^ ])::?[a-z][a-z\-]+[a-z](?:\(.*?\))?/ig,"$1").replace(/(?:^| )[a-z0-6]+/ig," ").replace(/\\./g,"").replace(/[.#]\w[\w\-]*/g,""));}d=m[n];}return d;}},true);YAHOO.util.StyleSheet=h;})();YAHOO.register("stylesheet",YAHOO.util.StyleSheet,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/swf/swf-min.js b/js/yui/swf/swf-min.js
new file mode 100644 (file)
index 0000000..f91288f
--- /dev/null
+++ b/js/yui/swf/swf-min.js
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.namespace("widget");(function(){var f=0;var m=YAHOO.env.ua;var p="ShockwaveFlash";var o,q;if(m.gecko||m.webkit||m.opera){if((o=navigator.mimeTypes["application/x-shockwave-flash"])){if((q=o.enabledPlugin)){var j=[];j=q.description.replace(/\s[rd]/g,".").replace(/[A-Za-z\s]+/g,"").split(".");f=j[0]+".";switch((j[2].toString()).length){case 1:f+="00";break;case 2:f+="0";break;}f+=j[2];f=parseFloat(f);}}}else{if(m.ie){try{var i=new ActiveXObject(p+"."+p+".6");i.AllowScriptAccess="always";}catch(r){if(i!=null){f=6;}}if(f==0){try{var l=new ActiveXObject(p+"."+p);var j=[];j=l.GetVariable("$version").replace(/[A-Za-z\s]+/g,"").split(",");f=j[0]+".";switch((j[2].toString()).length){case 1:f+="00";break;case 2:f+="0";break;}f+=j[2];f=parseFloat(f);}catch(r){}}}}m.flash=f;YAHOO.util.SWFDetect={getFlashVersion:function(){return f;},isFlashVersionAtLeast:function(e){return f>=e;},parseFlashVersion:function(e){var u=e;if(YAHOO.lang.isString(e)){var v=e.split(".");if(v.length>2){u=parseInt(v[0]);u+=parseInt(v[2])*0.001;}else{u=parseFloat(e);}}return YAHOO.lang.isNumber(u)?u:null;}};var b=YAHOO.util.Dom,t=YAHOO.util.Event,g=YAHOO.util.SWFDetect,h=YAHOO.lang,a="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000",n="application/x-shockwave-flash",s="10.22",d="http://fpdownload.macromedia.com/pub/flashplayer/update/current/swf/autoUpdater.swf?"+Math.random(),c="YAHOO.widget.SWF.eventHandler",k={align:"",allowfullscreen:"",allownetworking:"",allowscriptaccess:"",base:"",bgcolor:"",devicefont:"",loop:"",menu:"",name:"",play:"",quality:"",salign:"",seamlesstabbing:"",scale:"",swliveconnect:"",tabindex:"",wmode:""};YAHOO.widget.SWF=function(e,K,F){this._queue=this._queue||[];this._events=this._events||{};this._configs=this._configs||{};this._id=b.generateId(null,"yuiswf");if(F.host){this._host=F.host;}var H=this._id;var x=b.get(e);var u=g.parseFlashVersion((F["version"])||s);var E=g.isFlashVersionAtLeast(u);var D=(m.flash>=8);var y=D&&!E&&F["useExpressInstall"];var C=(y)?d:K;var B="<object ";var I,A;var J="YUISwfId="+H+"&YUIBridgeCallback="+c;YAHOO.widget.SWF._instances[H]=this;if(x&&(E||y)&&C){B+='id="'+H+'" ';if(m.ie){B+='classid="'+a+'" ';}else{B+='type="'+n+'" data="'+YAHOO.lang.escapeHTML(C)+'" ';}I="100%";A="100%";B+='width="'+I+'" height="'+A+'">';if(m.ie){B+='<param name="movie" value="'+YAHOO.lang.escapeHTML(C)+'"/>';}for(var v in F.fixedAttributes){if(k.hasOwnProperty(v.toLowerCase())){B+='<param name="'+YAHOO.lang.escapeHTML(v.toLowerCase())+'" value="'+YAHOO.lang.escapeHTML(F.fixedAttributes[v])+'"/>';}}for(var G in F.flashVars){var z=F.flashVars[G];if(h.isString(z)){J+="&"+YAHOO.lang.escapeHTML(G)+"="+YAHOO.lang.escapeHTML(encodeURIComponent(z));}}if(J){B+='<param name="flashVars" value="'+J+'"/>';}B+="</object>";x.innerHTML=B;YAHOO.widget.SWF.superclass.constructor.call(this,b.get(H));this._swf=b.get(H);}};YAHOO.widget.SWF._instances=YAHOO.widget.SWF._instances||{};YAHOO.widget.SWF.eventHandler=function(e,u){YAHOO.widget.SWF._instances[e]._eventHandler(u);};YAHOO.extend(YAHOO.widget.SWF,YAHOO.util.Element,{_eventHandler:function(e){if(e.type=="swfReady"){this.createEvent("swfReady",{fireOnce:true});this.fireEvent("swfReady",e);}else{if(e.type=="log"){}else{if(this._host&&this._host.fireEvent){this._host.fireEvent(e.type,e);}else{this.fireEvent(e.type,e);}}}},callSWF:function(u,e){if(!e){e=[];}if(this._swf[u]){return(this._swf[u].apply(this._swf,e));}else{return null;}},toString:function(){return"SWF "+this._id;}});})();YAHOO.register("swf",YAHOO.widget.SWF,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/swfdetect/swfdetect-min.js b/js/yui/swfdetect/swfdetect-min.js
new file mode 100644 (file)
index 0000000..02da324
--- /dev/null
+++ b/js/yui/swfdetect/swfdetect-min.js
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.namespace("util");(function(){var h=0;var f=YAHOO.env.ua;var i="ShockwaveFlash";var b,d;if(f.gecko||f.webkit||f.opera){if((b=navigator.mimeTypes["application/x-shockwave-flash"])){if((d=b.enabledPlugin)){var c=[];c=d.description.replace(/\s[rd]/g,".").replace(/[A-Za-z\s]+/g,"").split(".");h=c[0]+".";switch((c[2].toString()).length){case 1:h+="00";break;case 2:h+="0";break;}h+=c[2];h=parseFloat(h);}}}else{if(f.ie){try{var j=new ActiveXObject(i+"."+i+".6");j.AllowScriptAccess="always";}catch(g){if(j!=null){h=6;}}if(h==0){try{var a=new ActiveXObject(i+"."+i);var c=[];c=a.GetVariable("$version").replace(/[A-Za-z\s]+/g,"").split(",");h=c[0]+".";switch((c[2].toString()).length){case 1:h+="00";break;case 2:h+="0";break;}h+=c[2];h=parseFloat(h);}catch(g){}}}}f.flash=h;YAHOO.util.SWFDetect={getFlashVersion:function(){return h;},isFlashVersionAtLeast:function(e){return h>=e;},parseFlashVersion:function(e){var k=e;if(YAHOO.lang.isString(e)){var l=e.split(".");if(l.length>2){k=parseInt(l[0]);k+=parseInt(l[2])*0.001;}else{k=parseFloat(e);}}return YAHOO.lang.isNumber(k)?k:null;}};})();YAHOO.register("swfdetect",YAHOO.util.SWFDetect,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/swfstore/swfstore-min.js b/js/yui/swfstore/swfstore-min.js
new file mode 100644 (file)
index 0000000..1efbba6
--- /dev/null
+++ b/js/yui/swfstore/swfstore-min.js
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.util.SWFStore=function(a,c,d){var b;var e;c=c.toString();d=d.toString();if(YAHOO.env.ua.ie){b="ie";}else{if(YAHOO.env.ua.gecko){b="gecko";}else{if(YAHOO.env.ua.webkit){b="webkit";}else{if(YAHOO.env.ua.caja){b="caja";}else{if(YAHOO.env.ua.opera){b="opera";}else{b="other";}}}}}if(YAHOO.util.Cookie.get("swfstore")==null||YAHOO.util.Cookie.get("swfstore")=="null"||YAHOO.util.Cookie.get("swfstore")==""){e=Math.round(Math.random()*Math.PI*100000);YAHOO.util.Cookie.set("swfstore",e);}else{e=YAHOO.util.Cookie.get("swfstore");}var f={version:9.115,useExpressInstall:false,fixedAttributes:{allowScriptAccess:"always",allowNetworking:"all",scale:"noScale"},flashVars:{allowedDomain:document.location.hostname,shareData:c,browser:e,useCompression:d}};this.embeddedSWF=new YAHOO.widget.SWF(a,YAHOO.util.SWFStore.SWFURL,f);this.createEvent("error");this.createEvent("quotaExceededError");this.createEvent("securityError");this.createEvent("save");this.createEvent("clear");this.createEvent("pending");this.createEvent("openingDialog");this.createEvent("inadequateDimensions");};YAHOO.extend(YAHOO.util.SWFStore,YAHOO.util.AttributeProvider,{on:function(a,b){this.embeddedSWF.addListener(a,b);},addListener:function(a,b){this.embeddedSWF.addListener(a,b);},toString:function(){return"SWFStore "+this._id;},getShareData:function(){return this.embeddedSWF.callSWF("getShareData");},setShareData:function(a){this.embeddedSWF.callSWF("setShareData",[a]);},hasAdequateDimensions:function(){return this.embeddedSWF.callSWF("hasAdequateDimensions");},getUseCompression:function(){return this.embeddedSWF.callSWF("getUseCompression");},setUseCompression:function(a){this.embeddedSWF.callSWF("setUseCompression",[a]);},setItem:function(a,b){if(typeof b=="string"){b=b.replace(/\\/g,"\\\\");}return this.embeddedSWF.callSWF("setItem",[a,b]);},getValueAt:function(a){return this.embeddedSWF.callSWF("getValueAt",[a]);},getNameAt:function(a){return this.embeddedSWF.callSWF("getNameAt",[a]);},getValueOf:function(a){return this.embeddedSWF.callSWF("getValueOf",[a]);},getTypeOf:function(a){return this.embeddedSWF.callSWF("getTypeOf",[a]);},getTypeAt:function(a){return this.embeddedSWF.callSWF("getTypeAt",[a]);},getItems:function(){return this.embeddedSWF.callSWF("getItems",[]);},removeItem:function(a){return this.embeddedSWF.callSWF("removeItem",[a]);},removeItemAt:function(a){return this.embeddedSWF.callSWF("removeItemAt",[a]);},getLength:function(){return this.embeddedSWF.callSWF("getLength",[]);},clear:function(){return this.embeddedSWF.callSWF("clear",[]);},calculateCurrentSize:function(){return this.embeddedSWF.callSWF("calculateCurrentSize",[]);},getModificationDate:function(){return this.embeddedSWF.callSWF("getModificationDate",[]);},setSize:function(b){var a=this.embeddedSWF.callSWF("setSize",[b]);return a;},displaySettings:function(){this.embeddedSWF.callSWF("displaySettings",[]);}});YAHOO.util.SWFStore.SWFURL="swfstore.swf";YAHOO.register("swfstore",YAHOO.util.SWFStore,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/swfstore/swfstore.swf b/js/yui/swfstore/swfstore.swf
new file mode 100644 (file)
index 0000000..9c26ed1
Binary files /dev/null and b/js/yui/swfstore/swfstore.swf differ

diff --git a/js/yui/tabview/tabview-min.js b/js/yui/tabview/tabview-min.js
new file mode 100644 (file)
index 0000000..9df66f2
--- /dev/null
+++ b/js/yui/tabview/tabview-min.js
@@ -0,0 +1,8 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){var b=YAHOO.util,c=b.Dom,i=b.Event,g=window.document,k="active",d="activeIndex",f="activeTab",e="disabled",a="contentEl",h="element",j=function(m,l){l=l||{};if(arguments.length==1&&!YAHOO.lang.isString(m)&&!m.nodeName){l=m;m=l.element||null;}if(!m&&!l.element){m=this._createTabViewElement(l);}j.superclass.constructor.call(this,m,l);};YAHOO.extend(j,b.Element,{CLASSNAME:"yui-navset",TAB_PARENT_CLASSNAME:"yui-nav",CONTENT_PARENT_CLASSNAME:"yui-content",_tabParent:null,_contentParent:null,addTab:function(n,o){var p=this.get("tabs"),s=this._tabParent,q=this._contentParent,l=n.get(h),m=n.get(a),t=this.get(d),r;if(!p){this._queue[this._queue.length]=["addTab",arguments];return false;}r=this.getTab(o);o=(o===undefined)?p.length:o;p.splice(o,0,n);if(r){s.insertBefore(l,r.get(h));if(m){q.appendChild(m);}}else{s.appendChild(l);if(m){q.appendChild(m);}}if(!n.get(k)){n.set("contentVisible",false,true);if(o<=t){this.set(d,t+1,true);}}else{this.set(f,n,true);this.set("activeIndex",o,true);}this._initTabEvents(n);},_initTabEvents:function(l){l.addListener(l.get("activationEvent"),l._onActivate,this,l);l.addListener("activationEventChange",l._onActivationEventChange,this,l);},_removeTabEvents:function(l){l.removeListener(l.get("activationEvent"),l._onActivate,this,l);l.removeListener("activationEventChange",l._onActivationEventChange,this,l);},DOMEventHandler:function(q){var r=i.getTarget(q),t=this._tabParent,s=this.get("tabs"),n,m,l;if(c.isAncestor(t,r)){for(var o=0,p=s.length;o<p;o++){m=s[o].get(h);l=s[o].get(a);if(r==m||c.isAncestor(m,r)){n=s[o];break;}}if(n){n.fireEvent(q.type,q);}}},getTab:function(l){return this.get("tabs")[l];},getTabIndex:function(p){var m=null,o=this.get("tabs");for(var n=0,l=o.length;n<l;++n){if(p==o[n]){m=n;break;}}return m;},removeTab:function(o){var n=this.get("tabs").length,l=this.get(d),m=this.getTabIndex(o);if(o===this.get(f)){if(n>1){if(m+1===n){this.set(d,m-1);}else{this.set(d,m+1);}}else{this.set(f,null);}}else{if(m<l){this.set(d,l-1,true);}}this._removeTabEvents(o);this._tabParent.removeChild(o.get(h));this._contentParent.removeChild(o.get(a));this._configs.tabs.value.splice(m,1);o.fireEvent("remove",{type:"remove",tabview:this});},toString:function(){var l=this.get("id")||this.get("tagName");return"TabView "+l;},contentTransition:function(m,l){if(m){m.set("contentVisible",true);}if(l){l.set("contentVisible",false);}},initAttributes:function(l){j.superclass.initAttributes.call(this,l);if(!l.orientation){l.orientation="top";}var n=this.get(h);if(!this.hasClass(this.CLASSNAME)){this.addClass(this.CLASSNAME);}this.setAttributeConfig("tabs",{value:[],readOnly:true});this._tabParent=this.getElementsByClassName(this.TAB_PARENT_CLASSNAME,"ul")[0]||this._createTabParent();this._contentParent=this.getElementsByClassName(this.CONTENT_PARENT_CLASSNAME,"div")[0]||this._createContentParent();this.setAttributeConfig("orientation",{value:l.orientation,method:function(o){var p=this.get("orientation");this.addClass("yui-navset-"+o);if(p!=o){this.removeClass("yui-navset-"+p);}if(o==="bottom"){this.appendChild(this._tabParent);}}});this.setAttributeConfig(d,{value:l.activeIndex,validator:function(q){var o=true,p;if(q){p=this.getTab(q);if(p&&p.get(e)){o=false;}}return o;}});this.setAttributeConfig(f,{value:l[f],method:function(p){var o=this.get(f);if(p){p.set(k,true);}if(o&&o!==p){o.set(k,false);}if(o&&p!==o){this.contentTransition(p,o);}else{if(p){p.set("contentVisible",true);}}},validator:function(p){var o=true;if(p&&p.get(e)){o=false;}return o;}});this.on("activeTabChange",this._onActiveTabChange);this.on("activeIndexChange",this._onActiveIndexChange);if(this._tabParent){this._initTabs();}this.DOM_EVENTS.submit=false;this.DOM_EVENTS.focus=false;this.DOM_EVENTS.blur=false;this.DOM_EVENTS.change=false;for(var m in this.DOM_EVENTS){if(YAHOO.lang.hasOwnProperty(this.DOM_EVENTS,m)){this.addListener.call(this,m,this.DOMEventHandler);}}},deselectTab:function(l){if(this.getTab(l)===this.get(f)){this.set(f,null);}},selectTab:function(l){this.set(f,this.getTab(l));},_onActiveTabChange:function(n){var l=this.get(d),m=this.getTabIndex(n.newValue);if(l!==m){if(!(this.set(d,m))){this.set(f,n.prevValue);}}},_onActiveIndexChange:function(l){if(l.newValue!==this.getTabIndex(this.get(f))){if(!(this.set(f,this.getTab(l.newValue)))){this.set(d,l.prevValue);}}},_initTabs:function(){var q=c.getChildren(this._tabParent),o=c.getChildren(this._contentParent),n=this.get(d),r,m,s;for(var p=0,l=q.length;p<l;++p){m={};if(o[p]){m.contentEl=o[p];}r=new YAHOO.widget.Tab(q[p],m);this.addTab(r);if(r.hasClass(r.ACTIVE_CLASSNAME)){s=r;}}if(n!=undefined){this.set(f,this.getTab(n));}else{this._configs[f].value=s;this._configs[d].value=this.getTabIndex(s);}},_createTabViewElement:function(l){var m=g.createElement("div");if(this.CLASSNAME){m.className=this.CLASSNAME;}return m;},_createTabParent:function(l){var m=g.createElement("ul");if(this.TAB_PARENT_CLASSNAME){m.className=this.TAB_PARENT_CLASSNAME;}this.get(h).appendChild(m);return m;},_createContentParent:function(l){var m=g.createElement("div");if(this.CONTENT_PARENT_CLASSNAME){m.className=this.CONTENT_PARENT_CLASSNAME;}this.get(h).appendChild(m);return m;}});YAHOO.widget.TabView=j;})();(function(){var d=YAHOO.util,i=d.Dom,l=YAHOO.lang,m="activeTab",j="label",g="labelEl",q="content",c="contentEl",o="element",p="cacheData",b="dataSrc",h="dataLoaded",a="dataTimeout",n="loadMethod",f="postData",k="disabled",e=function(s,r){r=r||{};if(arguments.length==1&&!l.isString(s)&&!s.nodeName){r=s;s=r.element;}if(!s&&!r.element){s=this._createTabElement(r);}this.loadHandler={success:function(t){this.set(q,t.responseText);},failure:function(t){}};e.superclass.constructor.call(this,s,r);this.DOM_EVENTS={};};YAHOO.extend(e,YAHOO.util.Element,{LABEL_TAGNAME:"em",ACTIVE_CLASSNAME:"selected",HIDDEN_CLASSNAME:"yui-hidden",ACTIVE_TITLE:"active",DISABLED_CLASSNAME:k,LOADING_CLASSNAME:"loading",dataConnection:null,loadHandler:null,_loading:false,toString:function(){var r=this.get(o),s=r.id||r.tagName;
+return"Tab "+s;},initAttributes:function(r){r=r||{};e.superclass.initAttributes.call(this,r);this.setAttributeConfig("activationEvent",{value:r.activationEvent||"click"});this.setAttributeConfig(g,{value:r[g]||this._getLabelEl(),method:function(s){s=i.get(s);var t=this.get(g);if(t){if(t==s){return false;}t.parentNode.replaceChild(s,t);this.set(j,s.innerHTML);}}});this.setAttributeConfig(j,{value:r.label||this._getLabel(),method:function(t){var s=this.get(g);if(!s){this.set(g,this._createLabelEl());}s.innerHTML=t;}});this.setAttributeConfig(c,{value:r[c]||document.createElement("div"),method:function(s){s=i.get(s);var t=this.get(c);if(t){if(t===s){return false;}if(!this.get("selected")){i.addClass(s,this.HIDDEN_CLASSNAME);}t.parentNode.replaceChild(s,t);this.set(q,s.innerHTML);}}});this.setAttributeConfig(q,{value:r[q]||this.get(c).innerHTML,method:function(s){this.get(c).innerHTML=s;}});this.setAttributeConfig(b,{value:r.dataSrc});this.setAttributeConfig(p,{value:r.cacheData||false,validator:l.isBoolean});this.setAttributeConfig(n,{value:r.loadMethod||"GET",validator:l.isString});this.setAttributeConfig(h,{value:false,validator:l.isBoolean,writeOnce:true});this.setAttributeConfig(a,{value:r.dataTimeout||null,validator:l.isNumber});this.setAttributeConfig(f,{value:r.postData||null});this.setAttributeConfig("active",{value:r.active||this.hasClass(this.ACTIVE_CLASSNAME),method:function(s){if(s===true){this.addClass(this.ACTIVE_CLASSNAME);this.set("title",this.ACTIVE_TITLE);}else{this.removeClass(this.ACTIVE_CLASSNAME);this.set("title","");}},validator:function(s){return l.isBoolean(s)&&!this.get(k);}});this.setAttributeConfig(k,{value:r.disabled||this.hasClass(this.DISABLED_CLASSNAME),method:function(s){if(s===true){this.addClass(this.DISABLED_CLASSNAME);}else{this.removeClass(this.DISABLED_CLASSNAME);}},validator:l.isBoolean});this.setAttributeConfig("href",{value:r.href||this.getElementsByTagName("a")[0].getAttribute("href",2)||"#",method:function(s){this.getElementsByTagName("a")[0].href=s;},validator:l.isString});this.setAttributeConfig("contentVisible",{value:r.contentVisible,method:function(s){if(s){i.removeClass(this.get(c),this.HIDDEN_CLASSNAME);if(this.get(b)){if(!this._loading&&!(this.get(h)&&this.get(p))){this._dataConnect();}}}else{i.addClass(this.get(c),this.HIDDEN_CLASSNAME);}},validator:l.isBoolean});},_dataConnect:function(){if(!d.Connect){return false;}i.addClass(this.get(c).parentNode,this.LOADING_CLASSNAME);this._loading=true;this.dataConnection=d.Connect.asyncRequest(this.get(n),this.get(b),{success:function(r){this.loadHandler.success.call(this,r);this.set(h,true);this.dataConnection=null;i.removeClass(this.get(c).parentNode,this.LOADING_CLASSNAME);this._loading=false;},failure:function(r){this.loadHandler.failure.call(this,r);this.dataConnection=null;i.removeClass(this.get(c).parentNode,this.LOADING_CLASSNAME);this._loading=false;},scope:this,timeout:this.get(a)},this.get(f));},_createTabElement:function(r){var v=document.createElement("li"),s=document.createElement("a"),u=r.label||null,t=r.labelEl||null;s.href=r.href||"#";v.appendChild(s);if(t){if(!u){u=this._getLabel();}}else{t=this._createLabelEl();}s.appendChild(t);return v;},_getLabelEl:function(){return this.getElementsByTagName(this.LABEL_TAGNAME)[0];},_createLabelEl:function(){var r=document.createElement(this.LABEL_TAGNAME);return r;},_getLabel:function(){var r=this.get(g);if(!r){return undefined;}return r.innerHTML;},_onActivate:function(u,t){var s=this,r=false;d.Event.preventDefault(u);if(s===t.get(m)){r=true;}t.set(m,s,r);},_onActivationEventChange:function(s){var r=this;if(s.prevValue!=s.newValue){r.removeListener(s.prevValue,r._onActivate);r.addListener(s.newValue,r._onActivate,this,r);}}});YAHOO.widget.Tab=e;})();YAHOO.register("tabview",YAHOO.widget.TabView,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/treeview/treeview-min.js b/js/yui/treeview/treeview-min.js
new file mode 100644 (file)
index 0000000..f8cb593
--- /dev/null
+++ b/js/yui/treeview/treeview-min.js
@@ -0,0 +1,12 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+(function(){var d=YAHOO.util.Dom,b=YAHOO.util.Event,f=YAHOO.lang,e=YAHOO.widget;YAHOO.widget.TreeView=function(h,g){if(h){this.init(h);}if(g){this.buildTreeFromObject(g);}else{if(f.trim(this._el.innerHTML)){this.buildTreeFromMarkup(h);}}};var c=e.TreeView;c.prototype={id:null,_el:null,_nodes:null,locked:false,_expandAnim:null,_collapseAnim:null,_animCount:0,maxAnim:2,_hasDblClickSubscriber:false,_dblClickTimer:null,currentFocus:null,singleNodeHighlight:false,_currentlyHighlighted:null,setExpandAnim:function(g){this._expandAnim=(e.TVAnim.isValid(g))?g:null;},setCollapseAnim:function(g){this._collapseAnim=(e.TVAnim.isValid(g))?g:null;},animateExpand:function(i,j){if(this._expandAnim&&this._animCount<this.maxAnim){var g=this;var h=e.TVAnim.getAnim(this._expandAnim,i,function(){g.expandComplete(j);});if(h){++this._animCount;this.fireEvent("animStart",{"node":j,"type":"expand"});h.animate();}return true;}return false;},animateCollapse:function(i,j){if(this._collapseAnim&&this._animCount<this.maxAnim){var g=this;var h=e.TVAnim.getAnim(this._collapseAnim,i,function(){g.collapseComplete(j);});if(h){++this._animCount;this.fireEvent("animStart",{"node":j,"type":"collapse"});h.animate();}return true;}return false;},expandComplete:function(g){--this._animCount;this.fireEvent("animComplete",{"node":g,"type":"expand"});},collapseComplete:function(g){--this._animCount;this.fireEvent("animComplete",{"node":g,"type":"collapse"});},init:function(i){this._el=d.get(i);this.id=d.generateId(this._el,"yui-tv-auto-id-");this.createEvent("animStart",this);this.createEvent("animComplete",this);this.createEvent("collapse",this);this.createEvent("collapseComplete",this);this.createEvent("expand",this);this.createEvent("expandComplete",this);this.createEvent("enterKeyPressed",this);this.createEvent("clickEvent",this);this.createEvent("focusChanged",this);var g=this;this.createEvent("dblClickEvent",{scope:this,onSubscribeCallback:function(){g._hasDblClickSubscriber=true;}});this.createEvent("labelClick",this);this.createEvent("highlightEvent",this);this._nodes=[];c.trees[this.id]=this;this.root=new e.RootNode(this);var h=e.LogWriter;if(this._initEditor){this._initEditor();}},buildTreeFromObject:function(g){var h=function(q,n){var m,r,l,k,p,j,o;for(m=0;m<n.length;m++){r=n[m];if(f.isString(r)){l=new e.TextNode(r,q);}else{if(f.isObject(r)){k=r.children;delete r.children;p=r.type||"text";delete r.type;switch(f.isString(p)&&p.toLowerCase()){case"text":l=new e.TextNode(r,q);break;case"menu":l=new e.MenuNode(r,q);break;case"html":l=new e.HTMLNode(r,q);break;default:if(f.isString(p)){j=e[p];}else{j=p;}if(f.isObject(j)){for(o=j;o&&o!==e.Node;o=o.superclass.constructor){}if(o){l=new j(r,q);}else{}}else{}}if(k){h(l,k);}}else{}}}};if(!f.isArray(g)){g=[g];}h(this.root,g);},buildTreeFromMarkup:function(i){var h=function(j){var n,q,m=[],l={},k,o;for(n=d.getFirstChild(j);n;n=d.getNextSibling(n)){switch(n.tagName.toUpperCase()){case"LI":k="";l={expanded:d.hasClass(n,"expanded"),title:n.title||n.alt||null,className:f.trim(n.className.replace(/\bexpanded\b/,""))||null};q=n.firstChild;if(q.nodeType==3){k=f.trim(q.nodeValue.replace(/[\n\t\r]*/g,""));if(k){l.type="text";l.label=k;}else{q=d.getNextSibling(q);}}if(!k){if(q.tagName.toUpperCase()=="A"){l.type="text";l.label=q.innerHTML;l.href=q.href;l.target=q.target;l.title=q.title||q.alt||l.title;}else{l.type="html";var p=document.createElement("div");p.appendChild(q.cloneNode(true));l.html=p.innerHTML;l.hasIcon=true;}}q=d.getNextSibling(q);switch(q&&q.tagName.toUpperCase()){case"UL":case"OL":l.children=h(q);break;}if(YAHOO.lang.JSON){o=n.getAttribute("yuiConfig");if(o){o=YAHOO.lang.JSON.parse(o);l=YAHOO.lang.merge(l,o);}}m.push(l);break;case"UL":case"OL":l={type:"text",label:"",children:h(q)};m.push(l);break;}}return m;};var g=d.getChildrenBy(d.get(i),function(k){var j=k.tagName.toUpperCase();return j=="UL"||j=="OL";});if(g.length){this.buildTreeFromObject(h(g[0]));}else{}},_getEventTargetTdEl:function(h){var i=b.getTarget(h);while(i&&!(i.tagName.toUpperCase()=="TD"&&d.hasClass(i.parentNode,"ygtvrow"))){i=d.getAncestorByTagName(i,"td");}if(f.isNull(i)){return null;}if(/\bygtv(blank)?depthcell/.test(i.className)){return null;}if(i.id){var g=i.id.match(/\bygtv([^\d]*)(.*)/);if(g&&g[2]&&this._nodes[g[2]]){return i;}}return null;},_onClickEvent:function(j){var h=this,l=this._getEventTargetTdEl(j),i,k,g=function(m){i.focus();if(m||!i.href){i.toggle();try{b.preventDefault(j);}catch(n){}}};if(!l){return;}i=this.getNodeByElement(l);if(!i){return;}k=b.getTarget(j);if(d.hasClass(k,i.labelStyle)||d.getAncestorByClassName(k,i.labelStyle)){this.fireEvent("labelClick",i);}if(this._closeEditor){this._closeEditor(false);}if(/\bygtv[tl][mp]h?h?/.test(l.className)){g(true);}else{if(this._dblClickTimer){window.clearTimeout(this._dblClickTimer);this._dblClickTimer=null;}else{if(this._hasDblClickSubscriber){this._dblClickTimer=window.setTimeout(function(){h._dblClickTimer=null;if(h.fireEvent("clickEvent",{event:j,node:i})!==false){g();}},200);}else{if(h.fireEvent("clickEvent",{event:j,node:i})!==false){g();}}}}},_onDblClickEvent:function(g){if(!this._hasDblClickSubscriber){return;}var h=this._getEventTargetTdEl(g);if(!h){return;}if(!(/\bygtv[tl][mp]h?h?/.test(h.className))){this.fireEvent("dblClickEvent",{event:g,node:this.getNodeByElement(h)});if(this._dblClickTimer){window.clearTimeout(this._dblClickTimer);this._dblClickTimer=null;}}},_onMouseOverEvent:function(g){var h;if((h=this._getEventTargetTdEl(g))&&(h=this.getNodeByElement(h))&&(h=h.getToggleEl())){h.className=h.className.replace(/\bygtv([lt])([mp])\b/gi,"ygtv$1$2h");}},_onMouseOutEvent:function(g){var h;if((h=this._getEventTargetTdEl(g))&&(h=this.getNodeByElement(h))&&(h=h.getToggleEl())){h.className=h.className.replace(/\bygtv([lt])([mp])h\b/gi,"ygtv$1$2");}},_onKeyDownEvent:function(l){var n=b.getTarget(l),k=this.getNodeByElement(n),j=k,g=YAHOO.util.KeyListener.KEY;switch(l.keyCode){case g.UP:do{if(j.previousSibling){j=j.previousSibling;}else{j=j.parent;
+}}while(j&&!j._canHaveFocus());if(j){j.focus();}b.preventDefault(l);break;case g.DOWN:do{if(j.nextSibling){j=j.nextSibling;}else{j.expand();j=(j.children.length||null)&&j.children[0];}}while(j&&!j._canHaveFocus);if(j){j.focus();}b.preventDefault(l);break;case g.LEFT:do{if(j.parent){j=j.parent;}else{j=j.previousSibling;}}while(j&&!j._canHaveFocus());if(j){j.focus();}b.preventDefault(l);break;case g.RIGHT:var i=this,m,h=function(o){i.unsubscribe("expandComplete",h);m(o);};m=function(o){do{if(o.isDynamic()&&!o.childrenRendered){i.subscribe("expandComplete",h);o.expand();o=null;break;}else{o.expand();if(o.children.length){o=o.children[0];}else{o=o.nextSibling;}}}while(o&&!o._canHaveFocus());if(o){o.focus();}};m(j);b.preventDefault(l);break;case g.ENTER:if(k.href){if(k.target){window.open(k.href,k.target);}else{window.location(k.href);}}else{k.toggle();}this.fireEvent("enterKeyPressed",k);b.preventDefault(l);break;case g.HOME:j=this.getRoot();if(j.children.length){j=j.children[0];}if(j._canHaveFocus()){j.focus();}b.preventDefault(l);break;case g.END:j=j.parent.children;j=j[j.length-1];if(j._canHaveFocus()){j.focus();}b.preventDefault(l);break;case 107:case 187:if(l.shiftKey){k.parent.expandAll();}else{k.expand();}break;case 109:case 189:if(l.shiftKey){k.parent.collapseAll();}else{k.collapse();}break;default:break;}},render:function(){var g=this.root.getHtml(),h=this.getEl();h.innerHTML=g;if(!this._hasEvents){b.on(h,"click",this._onClickEvent,this,true);b.on(h,"dblclick",this._onDblClickEvent,this,true);b.on(h,"mouseover",this._onMouseOverEvent,this,true);b.on(h,"mouseout",this._onMouseOutEvent,this,true);b.on(h,"keydown",this._onKeyDownEvent,this,true);}this._hasEvents=true;},getEl:function(){if(!this._el){this._el=d.get(this.id);}return this._el;},regNode:function(g){this._nodes[g.index]=g;},getRoot:function(){return this.root;},setDynamicLoad:function(g,h){this.root.setDynamicLoad(g,h);},expandAll:function(){if(!this.locked){this.root.expandAll();}},collapseAll:function(){if(!this.locked){this.root.collapseAll();}},getNodeByIndex:function(h){var g=this._nodes[h];return(g)?g:null;},getNodeByProperty:function(j,h){for(var g in this._nodes){if(this._nodes.hasOwnProperty(g)){var k=this._nodes[g];if((j in k&&k[j]==h)||(k.data&&h==k.data[j])){return k;}}}return null;},getNodesByProperty:function(k,j){var g=[];for(var h in this._nodes){if(this._nodes.hasOwnProperty(h)){var l=this._nodes[h];if((k in l&&l[k]==j)||(l.data&&j==l.data[k])){g.push(l);}}}return(g.length)?g:null;},getNodesBy:function(j){var g=[];for(var h in this._nodes){if(this._nodes.hasOwnProperty(h)){var k=this._nodes[h];if(j(k)){g.push(k);}}}return(g.length)?g:null;},getNodeByElement:function(i){var j=i,g,h=/ygtv([^\d]*)(.*)/;do{if(j&&j.id){g=j.id.match(h);if(g&&g[2]){return this.getNodeByIndex(g[2]);}}j=j.parentNode;if(!j||!j.tagName){break;}}while(j.id!==this.id&&j.tagName.toLowerCase()!=="body");return null;},getHighlightedNode:function(){return this._currentlyHighlighted;},removeNode:function(h,g){if(h.isRoot()){return false;}var i=h.parent;if(i.parent){i=i.parent;}this._deleteNode(h);if(g&&i&&i.childrenRendered){i.refresh();}return true;},_removeChildren_animComplete:function(g){this.unsubscribe(this._removeChildren_animComplete);this.removeChildren(g.node);},removeChildren:function(g){if(g.expanded){if(this._collapseAnim){this.subscribe("animComplete",this._removeChildren_animComplete,this,true);e.Node.prototype.collapse.call(g);return;}g.collapse();}while(g.children.length){this._deleteNode(g.children[0]);}if(g.isRoot()){e.Node.prototype.expand.call(g);}g.childrenRendered=false;g.dynamicLoadComplete=false;g.updateIcon();},_deleteNode:function(g){this.removeChildren(g);this.popNode(g);},popNode:function(k){var l=k.parent;var h=[];for(var j=0,g=l.children.length;j<g;++j){if(l.children[j]!=k){h[h.length]=l.children[j];}}l.children=h;l.childrenRendered=false;if(k.previousSibling){k.previousSibling.nextSibling=k.nextSibling;}if(k.nextSibling){k.nextSibling.previousSibling=k.previousSibling;}if(this.currentFocus==k){this.currentFocus=null;}if(this._currentlyHighlighted==k){this._currentlyHighlighted=null;}k.parent=null;k.previousSibling=null;k.nextSibling=null;k.tree=null;delete this._nodes[k.index];},destroy:function(){if(this._destroyEditor){this._destroyEditor();}var h=this.getEl();b.removeListener(h,"click");b.removeListener(h,"dblclick");b.removeListener(h,"mouseover");b.removeListener(h,"mouseout");b.removeListener(h,"keydown");for(var g=0;g<this._nodes.length;g++){var j=this._nodes[g];if(j&&j.destroy){j.destroy();}}h.innerHTML="";this._hasEvents=false;},toString:function(){return"TreeView "+this.id;},getNodeCount:function(){return this.getRoot().getNodeCount();},getTreeDefinition:function(){return this.getRoot().getNodeDefinition();},onExpand:function(g){},onCollapse:function(g){},setNodesProperty:function(g,i,h){this.root.setNodesProperty(g,i);if(h){this.root.refresh();}},onEventToggleHighlight:function(h){var g;if("node" in h&&h.node instanceof e.Node){g=h.node;}else{if(h instanceof e.Node){g=h;}else{return false;}}g.toggleHighlight();return false;}};var a=c.prototype;a.draw=a.render;YAHOO.augment(c,YAHOO.util.EventProvider);c.nodeCount=0;c.trees=[];c.getTree=function(h){var g=c.trees[h];return(g)?g:null;};c.getNode=function(h,i){var g=c.getTree(h);return(g)?g.getNodeByIndex(i):null;};c.FOCUS_CLASS_NAME="ygtvfocus";})();(function(){var b=YAHOO.util.Dom,c=YAHOO.lang,a=YAHOO.util.Event;YAHOO.widget.Node=function(f,e,d){if(f){this.init(f,e,d);}};YAHOO.widget.Node.prototype={index:0,children:null,tree:null,data:null,parent:null,depth:-1,expanded:false,multiExpand:true,renderHidden:false,childrenRendered:false,dynamicLoadComplete:false,previousSibling:null,nextSibling:null,_dynLoad:false,dataLoader:null,isLoading:false,hasIcon:true,iconMode:0,nowrap:false,isLeaf:false,contentStyle:"",contentElId:null,enableHighlight:true,highlightState:0,propagateHighlightUp:false,propagateHighlightDown:false,className:null,_type:"Node",init:function(g,f,d){this.data={};
+this.children=[];this.index=YAHOO.widget.TreeView.nodeCount;++YAHOO.widget.TreeView.nodeCount;this.contentElId="ygtvcontentel"+this.index;if(c.isObject(g)){for(var e in g){if(g.hasOwnProperty(e)){if(e.charAt(0)!="_"&&!c.isUndefined(this[e])&&!c.isFunction(this[e])){this[e]=g[e];}else{this.data[e]=g[e];}}}}if(!c.isUndefined(d)){this.expanded=d;}this.createEvent("parentChange",this);if(f){f.appendChild(this);}},applyParent:function(e){if(!e){return false;}this.tree=e.tree;this.parent=e;this.depth=e.depth+1;this.tree.regNode(this);e.childrenRendered=false;for(var f=0,d=this.children.length;f<d;++f){this.children[f].applyParent(this);}this.fireEvent("parentChange");return true;},appendChild:function(e){if(this.hasChildren()){var d=this.children[this.children.length-1];d.nextSibling=e;e.previousSibling=d;}this.children[this.children.length]=e;e.applyParent(this);if(this.childrenRendered&&this.expanded){this.getChildrenEl().style.display="";}return e;},appendTo:function(d){return d.appendChild(this);},insertBefore:function(d){var f=d.parent;if(f){if(this.tree){this.tree.popNode(this);}var e=d.isChildOf(f);f.children.splice(e,0,this);if(d.previousSibling){d.previousSibling.nextSibling=this;}this.previousSibling=d.previousSibling;this.nextSibling=d;d.previousSibling=this;this.applyParent(f);}return this;},insertAfter:function(d){var f=d.parent;if(f){if(this.tree){this.tree.popNode(this);}var e=d.isChildOf(f);if(!d.nextSibling){this.nextSibling=null;return this.appendTo(f);}f.children.splice(e+1,0,this);d.nextSibling.previousSibling=this;this.previousSibling=d;this.nextSibling=d.nextSibling;d.nextSibling=this;this.applyParent(f);}return this;},isChildOf:function(e){if(e&&e.children){for(var f=0,d=e.children.length;f<d;++f){if(e.children[f]===this){return f;}}}return -1;},getSiblings:function(){var d=this.parent.children.slice(0);for(var e=0;e<d.length&&d[e]!=this;e++){}d.splice(e,1);if(d.length){return d;}return null;},showChildren:function(){if(!this.tree.animateExpand(this.getChildrenEl(),this)){if(this.hasChildren()){this.getChildrenEl().style.display="";}}},hideChildren:function(){if(!this.tree.animateCollapse(this.getChildrenEl(),this)){this.getChildrenEl().style.display="none";}},getElId:function(){return"ygtv"+this.index;},getChildrenElId:function(){return"ygtvc"+this.index;},getToggleElId:function(){return"ygtvt"+this.index;},getEl:function(){return b.get(this.getElId());},getChildrenEl:function(){return b.get(this.getChildrenElId());},getToggleEl:function(){return b.get(this.getToggleElId());},getContentEl:function(){return b.get(this.contentElId);},collapse:function(){if(!this.expanded){return;}var d=this.tree.onCollapse(this);if(false===d){return;}d=this.tree.fireEvent("collapse",this);if(false===d){return;}if(!this.getEl()){this.expanded=false;}else{this.hideChildren();this.expanded=false;this.updateIcon();}d=this.tree.fireEvent("collapseComplete",this);},expand:function(f){if(this.isLoading||(this.expanded&&!f)){return;}var d=true;if(!f){d=this.tree.onExpand(this);if(false===d){return;}d=this.tree.fireEvent("expand",this);}if(false===d){return;}if(!this.getEl()){this.expanded=true;return;}if(!this.childrenRendered){this.getChildrenEl().innerHTML=this.renderChildren();}else{}this.expanded=true;this.updateIcon();if(this.isLoading){this.expanded=false;return;}if(!this.multiExpand){var g=this.getSiblings();for(var e=0;g&&e<g.length;++e){if(g[e]!=this&&g[e].expanded){g[e].collapse();}}}this.showChildren();d=this.tree.fireEvent("expandComplete",this);},updateIcon:function(){if(this.hasIcon){var d=this.getToggleEl();if(d){d.className=d.className.replace(/\bygtv(([tl][pmn]h?)|(loading))\b/gi,this.getStyle());}}d=b.get("ygtvtableel"+this.index);if(d){if(this.expanded){b.replaceClass(d,"ygtv-collapsed","ygtv-expanded");}else{b.replaceClass(d,"ygtv-expanded","ygtv-collapsed");}}},getStyle:function(){if(this.isLoading){return"ygtvloading";}else{var e=(this.nextSibling)?"t":"l";var d="n";if(this.hasChildren(true)||(this.isDynamic()&&!this.getIconMode())){d=(this.expanded)?"m":"p";}return"ygtv"+e+d;}},getHoverStyle:function(){var d=this.getStyle();if(this.hasChildren(true)&&!this.isLoading){d+="h";}return d;},expandAll:function(){var d=this.children.length;for(var e=0;e<d;++e){var f=this.children[e];if(f.isDynamic()){break;}else{if(!f.multiExpand){break;}else{f.expand();f.expandAll();}}}},collapseAll:function(){for(var d=0;d<this.children.length;++d){this.children[d].collapse();this.children[d].collapseAll();}},setDynamicLoad:function(d,e){if(d){this.dataLoader=d;this._dynLoad=true;}else{this.dataLoader=null;this._dynLoad=false;}if(e){this.iconMode=e;}},isRoot:function(){return(this==this.tree.root);},isDynamic:function(){if(this.isLeaf){return false;}else{return(!this.isRoot()&&(this._dynLoad||this.tree.root._dynLoad));}},getIconMode:function(){return(this.iconMode||this.tree.root.iconMode);},hasChildren:function(d){if(this.isLeaf){return false;}else{return(this.children.length>0||(d&&this.isDynamic()&&!this.dynamicLoadComplete));}},toggle:function(){if(!this.tree.locked&&(this.hasChildren(true)||this.isDynamic())){if(this.expanded){this.collapse();}else{this.expand();}}},getHtml:function(){this.childrenRendered=false;return['<div class="ygtvitem" id="',this.getElId(),'">',this.getNodeHtml(),this.getChildrenHtml(),"</div>"].join("");},getChildrenHtml:function(){var d=[];d[d.length]='<div class="ygtvchildren" id="'+this.getChildrenElId()+'"';if(!this.expanded||!this.hasChildren()){d[d.length]=' style="display:none;"';}d[d.length]=">";if((this.hasChildren(true)&&this.expanded)||(this.renderHidden&&!this.isDynamic())){d[d.length]=this.renderChildren();}d[d.length]="</div>";return d.join("");},renderChildren:function(){var d=this;if(this.isDynamic()&&!this.dynamicLoadComplete){this.isLoading=true;this.tree.locked=true;if(this.dataLoader){setTimeout(function(){d.dataLoader(d,function(){d.loadComplete();});},10);}else{if(this.tree.root.dataLoader){setTimeout(function(){d.tree.root.dataLoader(d,function(){d.loadComplete();
+});},10);}else{return"Error: data loader not found or not specified.";}}return"";}else{return this.completeRender();}},completeRender:function(){var e=[];for(var d=0;d<this.children.length;++d){e[e.length]=this.children[d].getHtml();}this.childrenRendered=true;return e.join("");},loadComplete:function(){this.getChildrenEl().innerHTML=this.completeRender();if(this.propagateHighlightDown){if(this.highlightState===1&&!this.tree.singleNodeHighlight){for(var d=0;d<this.children.length;d++){this.children[d].highlight(true);}}else{if(this.highlightState===0||this.tree.singleNodeHighlight){for(d=0;d<this.children.length;d++){this.children[d].unhighlight(true);}}}}this.dynamicLoadComplete=true;this.isLoading=false;this.expand(true);this.tree.locked=false;},getAncestor:function(e){if(e>=this.depth||e<0){return null;}var d=this.parent;while(d.depth>e){d=d.parent;}return d;},getDepthStyle:function(d){return(this.getAncestor(d).nextSibling)?"ygtvdepthcell":"ygtvblankdepthcell";},getNodeHtml:function(){var e=[];e[e.length]='<table id="ygtvtableel'+this.index+'" border="0" cellpadding="0" cellspacing="0" class="ygtvtable ygtvdepth'+this.depth;e[e.length]=" ygtv-"+(this.expanded?"expanded":"collapsed");if(this.enableHighlight){e[e.length]=" ygtv-highlight"+this.highlightState;}if(this.className){e[e.length]=" "+this.className;}e[e.length]='"><tr class="ygtvrow">';for(var d=0;d<this.depth;++d){e[e.length]='<td class="ygtvcell '+this.getDepthStyle(d)+'"><div class="ygtvspacer"></div></td>';}if(this.hasIcon){e[e.length]='<td id="'+this.getToggleElId();e[e.length]='" class="ygtvcell ';e[e.length]=this.getStyle();e[e.length]='"><a href="#" class="ygtvspacer">&#160;</a></td>';}e[e.length]='<td id="'+this.contentElId;e[e.length]='" class="ygtvcell ';e[e.length]=this.contentStyle+' ygtvcontent" ';e[e.length]=(this.nowrap)?' nowrap="nowrap" ':"";e[e.length]=" >";e[e.length]=this.getContentHtml();e[e.length]="</td></tr></table>";return e.join("");},getContentHtml:function(){return"";},refresh:function(){this.getChildrenEl().innerHTML=this.completeRender();if(this.hasIcon){var d=this.getToggleEl();if(d){d.className=d.className.replace(/\bygtv[lt][nmp]h*\b/gi,this.getStyle());}}},toString:function(){return this._type+" ("+this.index+")";},_focusHighlightedItems:[],_focusedItem:null,_canHaveFocus:function(){return this.getEl().getElementsByTagName("a").length>0;},_removeFocus:function(){if(this._focusedItem){a.removeListener(this._focusedItem,"blur");this._focusedItem=null;}var d;while((d=this._focusHighlightedItems.shift())){b.removeClass(d,YAHOO.widget.TreeView.FOCUS_CLASS_NAME);}},focus:function(){var f=false,d=this;if(this.tree.currentFocus){this.tree.currentFocus._removeFocus();}var e=function(g){if(g.parent){e(g.parent);g.parent.expand();}};e(this);b.getElementsBy(function(g){return(/ygtv(([tl][pmn]h?)|(content))/).test(g.className);},"td",d.getEl().firstChild,function(h){b.addClass(h,YAHOO.widget.TreeView.FOCUS_CLASS_NAME);if(!f){var g=h.getElementsByTagName("a");if(g.length){g=g[0];g.focus();d._focusedItem=g;a.on(g,"blur",function(){d.tree.fireEvent("focusChanged",{oldNode:d.tree.currentFocus,newNode:null});d.tree.currentFocus=null;d._removeFocus();});f=true;}}d._focusHighlightedItems.push(h);});if(f){this.tree.fireEvent("focusChanged",{oldNode:this.tree.currentFocus,newNode:this});this.tree.currentFocus=this;}else{this.tree.fireEvent("focusChanged",{oldNode:d.tree.currentFocus,newNode:null});this.tree.currentFocus=null;this._removeFocus();}return f;},getNodeCount:function(){for(var d=0,e=0;d<this.children.length;d++){e+=this.children[d].getNodeCount();}return e+1;},getNodeDefinition:function(){if(this.isDynamic()){return false;}var g,d=c.merge(this.data),f=[];if(this.expanded){d.expanded=this.expanded;}if(!this.multiExpand){d.multiExpand=this.multiExpand;}if(this.renderHidden){d.renderHidden=this.renderHidden;}if(!this.hasIcon){d.hasIcon=this.hasIcon;}if(this.nowrap){d.nowrap=this.nowrap;}if(this.className){d.className=this.className;}if(this.editable){d.editable=this.editable;}if(!this.enableHighlight){d.enableHighlight=this.enableHighlight;}if(this.highlightState){d.highlightState=this.highlightState;}if(this.propagateHighlightUp){d.propagateHighlightUp=this.propagateHighlightUp;}if(this.propagateHighlightDown){d.propagateHighlightDown=this.propagateHighlightDown;}d.type=this._type;for(var e=0;e<this.children.length;e++){g=this.children[e].getNodeDefinition();if(g===false){return false;}f.push(g);}if(f.length){d.children=f;}return d;},getToggleLink:function(){return"return false;";},setNodesProperty:function(d,g,f){if(d.charAt(0)!="_"&&!c.isUndefined(this[d])&&!c.isFunction(this[d])){this[d]=g;}else{this.data[d]=g;}for(var e=0;e<this.children.length;e++){this.children[e].setNodesProperty(d,g);}if(f){this.refresh();}},toggleHighlight:function(){if(this.enableHighlight){if(this.highlightState==1){this.unhighlight();}else{this.highlight();}}},highlight:function(e){if(this.enableHighlight){if(this.tree.singleNodeHighlight){if(this.tree._currentlyHighlighted){this.tree._currentlyHighlighted.unhighlight(e);}this.tree._currentlyHighlighted=this;}this.highlightState=1;this._setHighlightClassName();if(!this.tree.singleNodeHighlight){if(this.propagateHighlightDown){for(var d=0;d<this.children.length;d++){this.children[d].highlight(true);}}if(this.propagateHighlightUp){if(this.parent){this.parent._childrenHighlighted();}}}if(!e){this.tree.fireEvent("highlightEvent",this);}}},unhighlight:function(e){if(this.enableHighlight){this.tree._currentlyHighlighted=null;this.highlightState=0;this._setHighlightClassName();if(!this.tree.singleNodeHighlight){if(this.propagateHighlightDown){for(var d=0;d<this.children.length;d++){this.children[d].unhighlight(true);}}if(this.propagateHighlightUp){if(this.parent){this.parent._childrenHighlighted();}}}if(!e){this.tree.fireEvent("highlightEvent",this);}}},_childrenHighlighted:function(){var f=false,e=false;if(this.enableHighlight){for(var d=0;d<this.children.length;d++){switch(this.children[d].highlightState){case 0:e=true;
+break;case 1:f=true;break;case 2:f=e=true;break;}}if(f&&e){this.highlightState=2;}else{if(f){this.highlightState=1;}else{this.highlightState=0;}}this._setHighlightClassName();if(this.propagateHighlightUp){if(this.parent){this.parent._childrenHighlighted();}}}},_setHighlightClassName:function(){var d=b.get("ygtvtableel"+this.index);if(d){d.className=d.className.replace(/\bygtv-highlight\d\b/gi,"ygtv-highlight"+this.highlightState);}}};YAHOO.augment(YAHOO.widget.Node,YAHOO.util.EventProvider);})();YAHOO.widget.RootNode=function(a){this.init(null,null,true);this.tree=a;};YAHOO.extend(YAHOO.widget.RootNode,YAHOO.widget.Node,{_type:"RootNode",getNodeHtml:function(){return"";},toString:function(){return this._type;},loadComplete:function(){this.tree.draw();},getNodeCount:function(){for(var a=0,b=0;a<this.children.length;a++){b+=this.children[a].getNodeCount();}return b;},getNodeDefinition:function(){for(var c,a=[],b=0;b<this.children.length;b++){c=this.children[b].getNodeDefinition();if(c===false){return false;}a.push(c);}return a;},collapse:function(){},expand:function(){},getSiblings:function(){return null;},focus:function(){}});(function(){var b=YAHOO.util.Dom,c=YAHOO.lang,a=YAHOO.util.Event;YAHOO.widget.TextNode=function(f,e,d){if(f){if(c.isString(f)){f={label:f};}this.init(f,e,d);this.setUpLabel(f);}};YAHOO.extend(YAHOO.widget.TextNode,YAHOO.widget.Node,{labelStyle:"ygtvlabel",labelElId:null,label:null,title:null,href:null,target:"_self",_type:"TextNode",setUpLabel:function(d){if(c.isString(d)){d={label:d};}else{if(d.style){this.labelStyle=d.style;}}this.label=d.label;this.labelElId="ygtvlabelel"+this.index;},getLabelEl:function(){return b.get(this.labelElId);},getContentHtml:function(){var d=[];d[d.length]=this.href?"<a":"<span";d[d.length]=' id="'+c.escapeHTML(this.labelElId)+'"';d[d.length]=' class="'+c.escapeHTML(this.labelStyle)+'"';if(this.href){d[d.length]=' href="'+c.escapeHTML(this.href)+'"';d[d.length]=' target="'+c.escapeHTML(this.target)+'"';}if(this.title){d[d.length]=' title="'+c.escapeHTML(this.title)+'"';}d[d.length]=" >";d[d.length]=c.escapeHTML(this.label);d[d.length]=this.href?"</a>":"</span>";return d.join("");},getNodeDefinition:function(){var d=YAHOO.widget.TextNode.superclass.getNodeDefinition.call(this);if(d===false){return false;}d.label=this.label;if(this.labelStyle!="ygtvlabel"){d.style=this.labelStyle;}if(this.title){d.title=this.title;}if(this.href){d.href=this.href;}if(this.target!="_self"){d.target=this.target;}return d;},toString:function(){return YAHOO.widget.TextNode.superclass.toString.call(this)+": "+this.label;},onLabelClick:function(){return false;},refresh:function(){YAHOO.widget.TextNode.superclass.refresh.call(this);var d=this.getLabelEl();d.innerHTML=this.label;if(d.tagName.toUpperCase()=="A"){d.href=this.href;d.target=this.target;}}});})();YAHOO.widget.MenuNode=function(c,b,a){YAHOO.widget.MenuNode.superclass.constructor.call(this,c,b,a);this.multiExpand=false;};YAHOO.extend(YAHOO.widget.MenuNode,YAHOO.widget.TextNode,{_type:"MenuNode"});(function(){var b=YAHOO.util.Dom,c=YAHOO.lang,a=YAHOO.util.Event;var d=function(h,g,f,e){if(h){this.init(h,g,f);this.initContent(h,e);}};YAHOO.widget.HTMLNode=d;YAHOO.extend(d,YAHOO.widget.Node,{contentStyle:"ygtvhtml",html:null,_type:"HTMLNode",initContent:function(f,e){this.setHtml(f);this.contentElId="ygtvcontentel"+this.index;if(!c.isUndefined(e)){this.hasIcon=e;}},setHtml:function(f){this.html=(c.isObject(f)&&"html" in f)?f.html:f;var e=this.getContentEl();if(e){if(f.nodeType&&f.nodeType==1&&f.tagName){e.innerHTML="";}else{e.innerHTML=this.html;}}},getContentHtml:function(){if(typeof this.html==="string"){return this.html;}else{d._deferredNodes.push(this);if(!d._timer){d._timer=window.setTimeout(function(){var e;while((e=d._deferredNodes.pop())){e.getContentEl().appendChild(e.html);}d._timer=null;},0);}return"";}},getNodeDefinition:function(){var e=d.superclass.getNodeDefinition.call(this);if(e===false){return false;}e.html=this.html;return e;}});d._deferredNodes=[];d._timer=null;})();(function(){var b=YAHOO.util.Dom,c=YAHOO.lang,a=YAHOO.util.Event,d=YAHOO.widget.Calendar;YAHOO.widget.DateNode=function(g,f,e){YAHOO.widget.DateNode.superclass.constructor.call(this,g,f,e);};YAHOO.extend(YAHOO.widget.DateNode,YAHOO.widget.TextNode,{_type:"DateNode",calendarConfig:null,fillEditorContainer:function(g){var h,f=g.inputContainer;if(c.isUndefined(d)){b.replaceClass(g.editorPanel,"ygtv-edit-DateNode","ygtv-edit-TextNode");YAHOO.widget.DateNode.superclass.fillEditorContainer.call(this,g);return;}if(g.nodeType!=this._type){g.nodeType=this._type;g.saveOnEnter=false;g.node.destroyEditorContents(g);g.inputObject=h=new d(f.appendChild(document.createElement("div")));if(this.calendarConfig){h.cfg.applyConfig(this.calendarConfig,true);h.cfg.fireQueue();}h.selectEvent.subscribe(function(){this.tree._closeEditor(true);},this,true);}else{h=g.inputObject;}g.oldValue=this.label;h.cfg.setProperty("selected",this.label,false);var i=h.cfg.getProperty("DATE_FIELD_DELIMITER");var e=this.label.split(i);h.cfg.setProperty("pagedate",e[h.cfg.getProperty("MDY_MONTH_POSITION")-1]+i+e[h.cfg.getProperty("MDY_YEAR_POSITION")-1]);h.cfg.fireQueue();h.render();h.oDomContainer.focus();},getEditorValue:function(f){if(c.isUndefined(d)){return f.inputElement.value;}else{var h=f.inputObject,g=h.getSelectedDates()[0],e=[];e[h.cfg.getProperty("MDY_DAY_POSITION")-1]=g.getDate();e[h.cfg.getProperty("MDY_MONTH_POSITION")-1]=g.getMonth()+1;e[h.cfg.getProperty("MDY_YEAR_POSITION")-1]=g.getFullYear();return e.join(h.cfg.getProperty("DATE_FIELD_DELIMITER"));}},displayEditedValue:function(g,e){var f=e.node;f.label=g;f.getLabelEl().innerHTML=g;},getNodeDefinition:function(){var e=YAHOO.widget.DateNode.superclass.getNodeDefinition.call(this);if(e===false){return false;}if(this.calendarConfig){e.calendarConfig=this.calendarConfig;}return e;}});})();(function(){var e=YAHOO.util.Dom,f=YAHOO.lang,b=YAHOO.util.Event,d=YAHOO.widget.TreeView,c=d.prototype;d.editorData={active:false,whoHasIt:null,nodeType:null,editorPanel:null,inputContainer:null,buttonsContainer:null,node:null,saveOnEnter:true,oldValue:undefined};
+c.validator=null;c._initEditor=function(){this.createEvent("editorSaveEvent",this);this.createEvent("editorCancelEvent",this);};c._nodeEditing=function(m){if(m.fillEditorContainer&&m.editable){var i,k,l,j,h=d.editorData;h.active=true;h.whoHasIt=this;if(!h.nodeType){h.editorPanel=i=this.getEl().appendChild(document.createElement("div"));e.addClass(i,"ygtv-label-editor");i.tabIndex=0;l=h.buttonsContainer=i.appendChild(document.createElement("div"));e.addClass(l,"ygtv-button-container");j=l.appendChild(document.createElement("button"));e.addClass(j,"ygtvok");j.innerHTML=" ";j=l.appendChild(document.createElement("button"));e.addClass(j,"ygtvcancel");j.innerHTML=" ";b.on(l,"click",function(q){var r=b.getTarget(q),o=d.editorData,p=o.node,n=o.whoHasIt;if(e.hasClass(r,"ygtvok")){b.stopEvent(q);n._closeEditor(true);}if(e.hasClass(r,"ygtvcancel")){b.stopEvent(q);n._closeEditor(false);}});h.inputContainer=i.appendChild(document.createElement("div"));e.addClass(h.inputContainer,"ygtv-input");b.on(i,"keydown",function(q){var p=d.editorData,n=YAHOO.util.KeyListener.KEY,o=p.whoHasIt;switch(q.keyCode){case n.ENTER:b.stopEvent(q);if(p.saveOnEnter){o._closeEditor(true);}break;case n.ESCAPE:b.stopEvent(q);o._closeEditor(false);break;}});}else{i=h.editorPanel;}h.node=m;if(h.nodeType){e.removeClass(i,"ygtv-edit-"+h.nodeType);}e.addClass(i," ygtv-edit-"+m._type);e.setStyle(i,"display","block");e.setXY(i,e.getXY(m.getContentEl()));i.focus();m.fillEditorContainer(h);return true;}};c.onEventEditNode=function(h){if(h instanceof YAHOO.widget.Node){h.editNode();}else{if(h.node instanceof YAHOO.widget.Node){h.node.editNode();}}return false;};c._closeEditor=function(j){var h=d.editorData,i=h.node,k=true;if(!i||!h.active){return;}if(j){k=h.node.saveEditorValue(h)!==false;}else{this.fireEvent("editorCancelEvent",i);}if(k){e.setStyle(h.editorPanel,"display","none");h.active=false;i.focus();}};c._destroyEditor=function(){var h=d.editorData;if(h&&h.nodeType&&(!h.active||h.whoHasIt===this)){b.removeListener(h.editorPanel,"keydown");b.removeListener(h.buttonContainer,"click");h.node.destroyEditorContents(h);document.body.removeChild(h.editorPanel);h.nodeType=h.editorPanel=h.inputContainer=h.buttonsContainer=h.whoHasIt=h.node=null;h.active=false;}};var g=YAHOO.widget.Node.prototype;g.editable=false;g.editNode=function(){this.tree._nodeEditing(this);};g.fillEditorContainer=null;g.destroyEditorContents=function(h){b.purgeElement(h.inputContainer,true);h.inputContainer.innerHTML="";};g.saveEditorValue=function(h){var j=h.node,k,i=j.tree.validator;k=this.getEditorValue(h);if(f.isFunction(i)){k=i(k,h.oldValue,j);if(f.isUndefined(k)){return false;}}if(this.tree.fireEvent("editorSaveEvent",{newValue:k,oldValue:h.oldValue,node:j})!==false){this.displayEditedValue(k,h);}};g.getEditorValue=function(h){};g.displayEditedValue=function(i,h){};var a=YAHOO.widget.TextNode.prototype;a.fillEditorContainer=function(i){var h;if(i.nodeType!=this._type){i.nodeType=this._type;i.saveOnEnter=true;i.node.destroyEditorContents(i);i.inputElement=h=i.inputContainer.appendChild(document.createElement("input"));}else{h=i.inputElement;}i.oldValue=this.label;h.value=this.label;h.focus();h.select();};a.getEditorValue=function(h){return h.inputElement.value;};a.displayEditedValue=function(j,h){var i=h.node;i.label=j;i.getLabelEl().innerHTML=j;};a.destroyEditorContents=function(h){h.inputContainer.innerHTML="";};})();YAHOO.widget.TVAnim=function(){return{FADE_IN:"TVFadeIn",FADE_OUT:"TVFadeOut",getAnim:function(b,a,c){if(YAHOO.widget[b]){return new YAHOO.widget[b](a,c);}else{return null;}},isValid:function(a){return(YAHOO.widget[a]);}};}();YAHOO.widget.TVFadeIn=function(a,b){this.el=a;this.callback=b;};YAHOO.widget.TVFadeIn.prototype={animate:function(){var e=this;var d=this.el.style;d.opacity=0.1;d.filter="alpha(opacity=10)";d.display="";var c=0.4;var b=new YAHOO.util.Anim(this.el,{opacity:{from:0.1,to:1,unit:""}},c);b.onComplete.subscribe(function(){e.onComplete();});b.animate();},onComplete:function(){this.callback();},toString:function(){return"TVFadeIn";}};YAHOO.widget.TVFadeOut=function(a,b){this.el=a;this.callback=b;};YAHOO.widget.TVFadeOut.prototype={animate:function(){var d=this;var c=0.4;var b=new YAHOO.util.Anim(this.el,{opacity:{from:1,to:0.1,unit:""}},c);b.onComplete.subscribe(function(){d.onComplete();});b.animate();},onComplete:function(){var a=this.el.style;a.display="none";a.opacity=1;a.filter="alpha(opacity=100)";this.callback();},toString:function(){return"TVFadeOut";}};YAHOO.register("treeview",YAHOO.widget.TreeView,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/uploader/uploader-min.js b/js/yui/uploader/uploader-min.js
new file mode 100644 (file)
index 0000000..d1b28fc
--- /dev/null
+++ b/js/yui/uploader/uploader-min.js
@@ -0,0 +1,15 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+/*!
+ * SWFObject v1.5: Flash Player detection and embed - http://blog.deconcept.com/swfobject/
+ *
+ * SWFObject is (c) 2007 Geoff Stearns and is released under the MIT License:
+ * http://www.opensource.org/licenses/mit-license.php
+ * @namespace YAHOO
+ */
+YAHOO.namespace("deconcept");YAHOO.deconcept=YAHOO.deconcept||{};if(typeof YAHOO.deconcept.util=="undefined"||!YAHOO.deconcept.util){YAHOO.deconcept.util={};}if(typeof YAHOO.deconcept.SWFObjectUtil=="undefined"||!YAHOO.deconcept.SWFObjectUtil){YAHOO.deconcept.SWFObjectUtil={};}YAHOO.deconcept.SWFObject=function(f,d,m,g,j,l,n,i,a,e){if(!document.getElementById){return;}this.DETECT_KEY=e?e:"detectflash";this.skipDetect=YAHOO.deconcept.util.getRequestParameter(this.DETECT_KEY);this.params={};this.variables={};this.attributes=[];if(f){this.setAttribute("swf",f);}if(d){this.setAttribute("id",d);}if(m){this.setAttribute("width",m);}if(g){this.setAttribute("height",g);}if(j){this.setAttribute("version",new YAHOO.deconcept.PlayerVersion(j.toString().split(".")));}this.installedVer=YAHOO.deconcept.SWFObjectUtil.getPlayerVersion();if(!window.opera&&document.all&&this.installedVer.major>7){YAHOO.deconcept.SWFObject.doPrepUnload=true;}if(l){this.addParam("bgcolor",l);}var b=n?n:"high";this.addParam("quality",b);this.setAttribute("useExpressInstall",false);this.setAttribute("doExpressInstall",false);var k=(i)?i:window.location;this.setAttribute("xiRedirectUrl",k);this.setAttribute("redirectUrl","");if(a){this.setAttribute("redirectUrl",a);}};YAHOO.deconcept.SWFObject.prototype={useExpressInstall:function(a){this.xiSWFPath=!a?"expressinstall.swf":a;this.setAttribute("useExpressInstall",true);},setAttribute:function(a,b){this.attributes[a]=b;},getAttribute:function(a){return this.attributes[a];},addParam:function(a,b){this.params[a]=b;},getParams:function(){return this.params;},addVariable:function(a,b){this.variables[a]=b;},getVariable:function(a){return this.variables[a];},getVariables:function(){return this.variables;},getVariablePairs:function(){var a=[];var b;var c=this.getVariables();for(b in c){if(c.hasOwnProperty(b)){a[a.length]=YAHOO.lang.escapeHTML(b||"")+"="+YAHOO.lang.escapeHTML(encodeURIComponent(c[b]||""));}}return a;},getSWFHTML:function(){var d="";var c={};var a="";var b="";if(navigator.plugins&&navigator.mimeTypes&&navigator.mimeTypes.length){if(this.getAttribute("doExpressInstall")){this.addVariable("MMplayerType","PlugIn");this.setAttribute("swf",this.xiSWFPath);}d='<embed type="application/x-shockwave-flash" src="'+YAHOO.lang.escapeHTML(this.getAttribute("swf")||"")+'" width="'+YAHOO.lang.escapeHTML(this.getAttribute("width")||"")+'" height="'+YAHOO.lang.escapeHTML(this.getAttribute("height")||"")+'" style="'+YAHOO.lang.escapeHTML(this.getAttribute("style")||"")+'"';d+=' id="'+YAHOO.lang.escapeHTML(this.getAttribute("id")||"")+'" name="'+YAHOO.lang.escapeHTML(this.getAttribute("id")||"")+'" ';c=this.getParams();for(a in c){if(c.hasOwnProperty(a)){d+=YAHOO.lang.escapeHTML(a||"")+'="'+YAHOO.lang.escapeHTML(c[a]||"")+'" ';}}b=this.getVariablePairs().join("&");if(b.length>0){d+='flashvars="'+b+'"';}d+="/>";}else{if(this.getAttribute("doExpressInstall")){this.addVariable("MMplayerType","ActiveX");this.setAttribute("swf",this.xiSWFPath);}d='<object id="'+YAHOO.lang.escapeHTML(this.getAttribute("id")||"")+'" classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" width="'+YAHOO.lang.escapeHTML(this.getAttribute("width")||"")+'" height="'+YAHOO.lang.escapeHTML(this.getAttribute("height")||"")+'" style="'+YAHOO.lang.escapeHTML(this.getAttribute("style")||"")+'">';d+='<param name="movie" value="'+YAHOO.lang.escapeHTML(this.getAttribute("swf")||"")+'" />';c=this.getParams();for(a in c){if(c.hasOwnProperty(a)){d+='<param name="'+YAHOO.lang.escapeHTML(a||"")+'" value="'+YAHOO.lang.escapeHTML(c[a]||"")+'" />';}}b=this.getVariablePairs().join("&");if(b.length>0){d+='<param name="flashvars" value="'+b+'" />';}d+="</object>";}return d;},write:function(a){if(this.getAttribute("useExpressInstall")){var b=new YAHOO.deconcept.PlayerVersion([6,0,65]);if(this.installedVer.versionIsValid(b)&&!this.installedVer.versionIsValid(this.getAttribute("version"))){this.setAttribute("doExpressInstall",true);this.addVariable("MMredirectURL",escape(this.getAttribute("xiRedirectUrl")));document.title=document.title.slice(0,47)+" - Flash Player Installation";this.addVariable("MMdoctitle",document.title);}}if(this.skipDetect||this.getAttribute("doExpressInstall")||this.installedVer.versionIsValid(this.getAttribute("version"))){var c=(typeof a=="string")?document.getElementById(a):a;c.innerHTML=this.getSWFHTML();return true;}else{if(this.getAttribute("redirectUrl")!==""){document.location.replace(this.getAttribute("redirectUrl"));}}return false;}};YAHOO.deconcept.SWFObjectUtil.getPlayerVersion=function(){var d=null;var c=new YAHOO.deconcept.PlayerVersion([0,0,0]);if(navigator.plugins&&navigator.mimeTypes.length){var a=navigator.plugins["Shockwave Flash"];if(a&&a.description){c=new YAHOO.deconcept.PlayerVersion(a.description.replace(/([a-zA-Z]|\s)+/,"").replace(/(\s+r|\s+b[0-9]+)/,".").split("."));}}else{if(navigator.userAgent&&navigator.userAgent.indexOf("Windows CE")>=0){var b=3;while(d){try{b++;d=new ActiveXObject("ShockwaveFlash.ShockwaveFlash."+b);c=new YAHOO.deconcept.PlayerVersion([b,0,0]);}catch(f){d=null;}}}else{try{d=new ActiveXObject("ShockwaveFlash.ShockwaveFlash.7");}catch(f){try{d=new ActiveXObject("ShockwaveFlash.ShockwaveFlash.6");c=new YAHOO.deconcept.PlayerVersion([6,0,21]);d.AllowScriptAccess="always";}catch(f){if(c.major==6){return c;}}try{d=new ActiveXObject("ShockwaveFlash.ShockwaveFlash");}catch(f){}}if(d!==null){c=new YAHOO.deconcept.PlayerVersion(d.GetVariable("$version").split(" ")[1].split(","));}}}return c;};YAHOO.deconcept.PlayerVersion=function(a){this.major=a[0]!==null?parseInt(a[0],0):0;this.minor=a[1]!==null?parseInt(a[1],0):0;this.rev=a[2]!==null?parseInt(a[2],0):0;};YAHOO.deconcept.PlayerVersion.prototype.versionIsValid=function(a){if(this.major<a.major){return false;
+}if(this.major>a.major){return true;}if(this.minor<a.minor){return false;}if(this.minor>a.minor){return true;}if(this.rev<a.rev){return false;}return true;};YAHOO.deconcept.util={getRequestParameter:function(d){var c=document.location.search||document.location.hash;if(d===null){return c;}if(c){var b=c.substring(1).split("&");for(var a=0;a<b.length;a++){if(b[a].substring(0,b[a].indexOf("="))==d){return b[a].substring((b[a].indexOf("=")+1));}}}return"";}};YAHOO.deconcept.SWFObjectUtil.cleanupSWFs=function(){var c=document.getElementsByTagName("OBJECT");for(var b=c.length-1;b>=0;b--){c[b].style.display="none";for(var a in c[b]){if(typeof c[b][a]=="function"){c[b][a]=function(){};}}}};if(YAHOO.deconcept.SWFObject.doPrepUnload){if(!YAHOO.deconcept.unloadSet){YAHOO.deconcept.SWFObjectUtil.prepUnload=function(){__flash_unloadHandler=function(){};__flash_savedUnloadHandler=function(){};window.attachEvent("onunload",YAHOO.deconcept.SWFObjectUtil.cleanupSWFs);};window.attachEvent("onbeforeunload",YAHOO.deconcept.SWFObjectUtil.prepUnload);YAHOO.deconcept.unloadSet=true;}}if(!document.getElementById&&document.all){document.getElementById=function(a){return document.all[a];};}YAHOO.widget.FlashAdapter=function(f,a,b,c){this._queue=this._queue||[];this._events=this._events||{};this._configs=this._configs||{};b=b||{};this._id=b.id=b.id||YAHOO.util.Dom.generateId(null,"yuigen");b.version=b.version||"9.0.45";b.backgroundColor=b.backgroundColor||"#ffffff";this._attributes=b;this._swfURL=f;this._containerID=a;this._embedSWF(this._swfURL,this._containerID,b.id,b.version,b.backgroundColor,b.expressInstall,b.wmode,c);try{this.createEvent("contentReady");}catch(d){}};YAHOO.widget.FlashAdapter.owners=YAHOO.widget.FlashAdapter.owners||{};YAHOO.extend(YAHOO.widget.FlashAdapter,YAHOO.util.AttributeProvider,{_swfURL:null,_containerID:null,_swf:null,_id:null,_initialized:false,_attributes:null,toString:function(){return"FlashAdapter "+this._id;},destroy:function(){if(this._swf){var b=YAHOO.util.Dom.get(this._containerID);b.removeChild(this._swf);}var a=this._id;for(var c in this){if(YAHOO.lang.hasOwnProperty(this,c)){this[c]=null;}}},_embedSWF:function(j,i,e,c,f,g,b,h){var d=new YAHOO.deconcept.SWFObject(j,e,"100%","100%",c,f);if(g){d.useExpressInstall(g);}d.addParam("allowScriptAccess","always");if(b){d.addParam("wmode",b);}d.addParam("menu","false");d.addVariable("allowedDomain",document.location.hostname);d.addVariable("YUISwfId",e);d.addVariable("YUIBridgeCallback","YAHOO.widget.FlashAdapter.eventHandler");if(h){d.addVariable("buttonSkin",h);}var a=YAHOO.util.Dom.get(i);var k=d.write(a);if(k){this._swf=YAHOO.util.Dom.get(e);YAHOO.widget.FlashAdapter.owners[e]=this;}else{}},_eventHandler:function(b){var a=b.type;switch(a){case"swfReady":this._loadHandler();return;case"log":return;}this.fireEvent(a,b);},_loadHandler:function(){this._initialized=false;this._initAttributes(this._attributes);this.setAttributes(this._attributes,true);this._initialized=true;this.fireEvent("contentReady");},set:function(a,b){this._attributes[a]=b;YAHOO.widget.FlashAdapter.superclass.set.call(this,a,b);},_initAttributes:function(a){this.getAttributeConfig("altText",{method:this._getAltText});this.setAttributeConfig("altText",{method:this._setAltText});this.getAttributeConfig("swfURL",{method:this._getSWFURL});},_getSWFURL:function(){return this._swfURL;},_getAltText:function(){return this._swf.getAltText();},_setAltText:function(a){return this._swf.setAltText(a);}});YAHOO.widget.FlashAdapter.eventHandler=function(a,b){if(!YAHOO.widget.FlashAdapter.owners[a]){setTimeout(function(){YAHOO.widget.FlashAdapter.eventHandler(a,b);},0);}else{YAHOO.widget.FlashAdapter.owners[a]._eventHandler(b);}};YAHOO.widget.FlashAdapter.proxyFunctionCount=0;YAHOO.widget.FlashAdapter.createProxyFunction=function(b){var a=YAHOO.widget.FlashAdapter.proxyFunctionCount;YAHOO.widget.FlashAdapter["proxyFunction"+a]=function(){return b.apply(null,arguments);};YAHOO.widget.FlashAdapter.proxyFunctionCount++;return"YAHOO.widget.FlashAdapter.proxyFunction"+a.toString();};YAHOO.widget.FlashAdapter.removeProxyFunction=function(a){if(!a||a.indexOf("YAHOO.widget.FlashAdapter.proxyFunction")<0){return;}a=a.substr(26);YAHOO.widget.FlashAdapter[a]=null;};YAHOO.widget.Uploader=function(a,b,d){var c="window";if(!(b)||(b&&d)){c="transparent";}YAHOO.widget.Uploader.superclass.constructor.call(this,YAHOO.widget.Uploader.SWFURL,a,{wmode:c},b);this.createEvent("mouseDown");this.createEvent("mouseUp");this.createEvent("rollOver");this.createEvent("rollOut");this.createEvent("click");this.createEvent("fileSelect");this.createEvent("uploadStart");this.createEvent("uploadProgress");this.createEvent("uploadCancel");this.createEvent("uploadComplete");this.createEvent("uploadCompleteData");this.createEvent("uploadError");};YAHOO.widget.Uploader.SWFURL="assets/uploader.swf";YAHOO.extend(YAHOO.widget.Uploader,YAHOO.widget.FlashAdapter,{upload:function(a,b,e,c,d){this._swf.upload(a,b,e,c,d);},uploadThese:function(b,a,e,c,d){this._swf.uploadThese(b,a,e,c,d);},uploadAll:function(a,d,b,c){this._swf.uploadAll(a,d,b,c);},cancel:function(a){this._swf.cancel(a);},clearFileList:function(){this._swf.clearFileList();},removeFile:function(a){this._swf.removeFile(a);},setAllowLogging:function(a){this._swf.setAllowLogging(a);},setSimUploadLimit:function(a){this._swf.setSimUploadLimit(a);},setAllowMultipleFiles:function(a){this._swf.setAllowMultipleFiles(a);},setFileFilters:function(a){this._swf.setFileFilters(a);},enable:function(){this._swf.enable();},disable:function(){this._swf.disable();}});YAHOO.register("uploader",YAHOO.widget.Uploader,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/yahoo-dom-event/yahoo-dom-event.js b/js/yui/yahoo-dom-event/yahoo-dom-event.js
new file mode 100644 (file)
index 0000000..46c58bf
--- /dev/null
+++ b/js/yui/yahoo-dom-event/yahoo-dom-event.js
@@ -0,0 +1,14 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+if(typeof YAHOO=="undefined"||!YAHOO){var YAHOO={};}YAHOO.namespace=function(){var b=arguments,g=null,e,c,f;for(e=0;e<b.length;e=e+1){f=(""+b[e]).split(".");g=YAHOO;for(c=(f[0]=="YAHOO")?1:0;c<f.length;c=c+1){g[f[c]]=g[f[c]]||{};g=g[f[c]];}}return g;};YAHOO.log=function(d,a,c){var b=YAHOO.widget.Logger;if(b&&b.log){return b.log(d,a,c);}else{return false;}};YAHOO.register=function(a,f,e){var k=YAHOO.env.modules,c,j,h,g,d;if(!k[a]){k[a]={versions:[],builds:[]};}c=k[a];j=e.version;h=e.build;g=YAHOO.env.listeners;c.name=a;c.version=j;c.build=h;c.versions.push(j);c.builds.push(h);c.mainClass=f;for(d=0;d<g.length;d=d+1){g[d](c);}if(f){f.VERSION=j;f.BUILD=h;}else{YAHOO.log("mainClass is undefined for module "+a,"warn");}};YAHOO.env=YAHOO.env||{modules:[],listeners:[]};YAHOO.env.getVersion=function(a){return YAHOO.env.modules[a]||null;};YAHOO.env.parseUA=function(d){var e=function(i){var j=0;return parseFloat(i.replace(/\./g,function(){return(j++==1)?"":".";}));},h=navigator,g={ie:0,opera:0,gecko:0,webkit:0,chrome:0,mobile:null,air:0,ipad:0,iphone:0,ipod:0,ios:null,android:0,webos:0,caja:h&&h.cajaVersion,secure:false,os:null},c=d||(navigator&&navigator.userAgent),f=window&&window.location,b=f&&f.href,a;g.secure=b&&(b.toLowerCase().indexOf("https")===0);if(c){if((/windows|win32/i).test(c)){g.os="windows";}else{if((/macintosh/i).test(c)){g.os="macintosh";}else{if((/rhino/i).test(c)){g.os="rhino";}}}if((/KHTML/).test(c)){g.webkit=1;}a=c.match(/AppleWebKit\/([^\s]*)/);if(a&&a[1]){g.webkit=e(a[1]);if(/ Mobile\//.test(c)){g.mobile="Apple";a=c.match(/OS ([^\s]*)/);if(a&&a[1]){a=e(a[1].replace("_","."));}g.ios=a;g.ipad=g.ipod=g.iphone=0;a=c.match(/iPad|iPod|iPhone/);if(a&&a[0]){g[a[0].toLowerCase()]=g.ios;}}else{a=c.match(/NokiaN[^\/]*|Android \d\.\d|webOS\/\d\.\d/);if(a){g.mobile=a[0];}if(/webOS/.test(c)){g.mobile="WebOS";a=c.match(/webOS\/([^\s]*);/);if(a&&a[1]){g.webos=e(a[1]);}}if(/ Android/.test(c)){g.mobile="Android";a=c.match(/Android ([^\s]*);/);if(a&&a[1]){g.android=e(a[1]);}}}a=c.match(/Chrome\/([^\s]*)/);if(a&&a[1]){g.chrome=e(a[1]);}else{a=c.match(/AdobeAIR\/([^\s]*)/);if(a){g.air=a[0];}}}if(!g.webkit){a=c.match(/Opera[\s\/]([^\s]*)/);if(a&&a[1]){g.opera=e(a[1]);a=c.match(/Version\/([^\s]*)/);if(a&&a[1]){g.opera=e(a[1]);}a=c.match(/Opera Mini[^;]*/);if(a){g.mobile=a[0];}}else{a=c.match(/MSIE\s([^;]*)/);if(a&&a[1]){g.ie=e(a[1]);}else{a=c.match(/Gecko\/([^\s]*)/);if(a){g.gecko=1;a=c.match(/rv:([^\s\)]*)/);if(a&&a[1]){g.gecko=e(a[1]);}}}}}}return g;};YAHOO.env.ua=YAHOO.env.parseUA();(function(){YAHOO.namespace("util","widget","example");if("undefined"!==typeof YAHOO_config){var b=YAHOO_config.listener,a=YAHOO.env.listeners,d=true,c;if(b){for(c=0;c<a.length;c++){if(a[c]==b){d=false;break;}}if(d){a.push(b);}}}})();YAHOO.lang=YAHOO.lang||{};(function(){var f=YAHOO.lang,a=Object.prototype,c="[object Array]",h="[object Function]",i="[object Object]",b=[],g={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#x27;","/":"&#x2F;","`":"&#x60;"},d=["toString","valueOf"],e={isArray:function(j){return a.toString.apply(j)===c;},isBoolean:function(j){return typeof j==="boolean";},isFunction:function(j){return(typeof j==="function")||a.toString.apply(j)===h;},isNull:function(j){return j===null;},isNumber:function(j){return typeof j==="number"&&isFinite(j);},isObject:function(j){return(j&&(typeof j==="object"||f.isFunction(j)))||false;},isString:function(j){return typeof j==="string";},isUndefined:function(j){return typeof j==="undefined";},_IEEnumFix:(YAHOO.env.ua.ie)?function(l,k){var j,n,m;for(j=0;j<d.length;j=j+1){n=d[j];m=k[n];if(f.isFunction(m)&&m!=a[n]){l[n]=m;}}}:function(){},escapeHTML:function(j){return j.replace(/[&<>"'\/`]/g,function(k){return g[k];});},extend:function(m,n,l){if(!n||!m){throw new Error("extend failed, please check that "+"all dependencies are included.");}var k=function(){},j;k.prototype=n.prototype;m.prototype=new k();m.prototype.constructor=m;m.superclass=n.prototype;if(n.prototype.constructor==a.constructor){n.prototype.constructor=n;}if(l){for(j in l){if(f.hasOwnProperty(l,j)){m.prototype[j]=l[j];}}f._IEEnumFix(m.prototype,l);}},augmentObject:function(n,m){if(!m||!n){throw new Error("Absorb failed, verify dependencies.");}var j=arguments,l,o,k=j[2];if(k&&k!==true){for(l=2;l<j.length;l=l+1){n[j[l]]=m[j[l]];}}else{for(o in m){if(k||!(o in n)){n[o]=m[o];}}f._IEEnumFix(n,m);}return n;},augmentProto:function(m,l){if(!l||!m){throw new Error("Augment failed, verify dependencies.");}var j=[m.prototype,l.prototype],k;for(k=2;k<arguments.length;k=k+1){j.push(arguments[k]);}f.augmentObject.apply(this,j);return m;},dump:function(j,p){var l,n,r=[],t="{...}",k="f(){...}",q=", ",m=" => ";if(!f.isObject(j)){return j+"";}else{if(j instanceof Date||("nodeType" in j&&"tagName" in j)){return j;}else{if(f.isFunction(j)){return k;}}}p=(f.isNumber(p))?p:3;if(f.isArray(j)){r.push("[");for(l=0,n=j.length;l<n;l=l+1){if(f.isObject(j[l])){r.push((p>0)?f.dump(j[l],p-1):t);}else{r.push(j[l]);}r.push(q);}if(r.length>1){r.pop();}r.push("]");}else{r.push("{");for(l in j){if(f.hasOwnProperty(j,l)){r.push(l+m);if(f.isObject(j[l])){r.push((p>0)?f.dump(j[l],p-1):t);}else{r.push(j[l]);}r.push(q);}}if(r.length>1){r.pop();}r.push("}");}return r.join("");},substitute:function(x,y,E,l){var D,C,B,G,t,u,F=[],p,z=x.length,A="dump",r=" ",q="{",m="}",n,w;for(;;){D=x.lastIndexOf(q,z);if(D<0){break;}C=x.indexOf(m,D);if(D+1>C){break;}p=x.substring(D+1,C);G=p;u=null;B=G.indexOf(r);if(B>-1){u=G.substring(B+1);G=G.substring(0,B);}t=y[G];if(E){t=E(G,t,u);}if(f.isObject(t)){if(f.isArray(t)){t=f.dump(t,parseInt(u,10));}else{u=u||"";n=u.indexOf(A);if(n>-1){u=u.substring(4);}w=t.toString();if(w===i||n>-1){t=f.dump(t,parseInt(u,10));}else{t=w;}}}else{if(!f.isString(t)&&!f.isNumber(t)){t="~-"+F.length+"-~";F[F.length]=p;}}x=x.substring(0,D)+t+x.substring(C+1);if(l===false){z=D-1;}}for(D=F.length-1;D>=0;D=D-1){x=x.replace(new RegExp("~-"+D+"-~"),"{"+F[D]+"}","g");}return x;},trim:function(j){try{return j.replace(/^\s+|\s+$/g,"");}catch(k){return j;
+}},merge:function(){var n={},k=arguments,j=k.length,m;for(m=0;m<j;m=m+1){f.augmentObject(n,k[m],true);}return n;},later:function(t,k,u,n,p){t=t||0;k=k||{};var l=u,s=n,q,j;if(f.isString(u)){l=k[u];}if(!l){throw new TypeError("method undefined");}if(!f.isUndefined(n)&&!f.isArray(s)){s=[n];}q=function(){l.apply(k,s||b);};j=(p)?setInterval(q,t):setTimeout(q,t);return{interval:p,cancel:function(){if(this.interval){clearInterval(j);}else{clearTimeout(j);}}};},isValue:function(j){return(f.isObject(j)||f.isString(j)||f.isNumber(j)||f.isBoolean(j));}};f.hasOwnProperty=(a.hasOwnProperty)?function(j,k){return j&&j.hasOwnProperty&&j.hasOwnProperty(k);}:function(j,k){return !f.isUndefined(j[k])&&j.constructor.prototype[k]!==j[k];};e.augmentObject(f,e,true);YAHOO.util.Lang=f;f.augment=f.augmentProto;YAHOO.augment=f.augmentProto;YAHOO.extend=f.extend;})();YAHOO.register("yahoo",YAHOO,{version:"2.9.0",build:"2800"});(function(){YAHOO.env._id_counter=YAHOO.env._id_counter||0;var e=YAHOO.util,k=YAHOO.lang,L=YAHOO.env.ua,a=YAHOO.lang.trim,B={},F={},m=/^t(?:able|d|h)$/i,w=/color$/i,j=window.document,v=j.documentElement,C="ownerDocument",M="defaultView",U="documentElement",S="compatMode",z="offsetLeft",o="offsetTop",T="offsetParent",x="parentNode",K="nodeType",c="tagName",n="scrollLeft",H="scrollTop",p="getBoundingClientRect",V="getComputedStyle",y="currentStyle",l="CSS1Compat",A="BackCompat",E="class",f="className",i="",b=" ",R="(?:^|\\s)",J="(?= |$)",t="g",O="position",D="fixed",u="relative",I="left",N="top",Q="medium",P="borderLeftWidth",q="borderTopWidth",d=L.opera,h=L.webkit,g=L.gecko,s=L.ie;e.Dom={CUSTOM_ATTRIBUTES:(!v.hasAttribute)?{"for":"htmlFor","class":f}:{"htmlFor":"for","className":E},DOT_ATTRIBUTES:{checked:true},get:function(aa){var ac,X,ab,Z,W,G,Y=null;if(aa){if(typeof aa=="string"||typeof aa=="number"){ac=aa+"";aa=j.getElementById(aa);G=(aa)?aa.attributes:null;if(aa&&G&&G.id&&G.id.value===ac){return aa;}else{if(aa&&j.all){aa=null;X=j.all[ac];if(X&&X.length){for(Z=0,W=X.length;Z<W;++Z){if(X[Z].id===ac){return X[Z];}}}}}}else{if(e.Element&&aa instanceof e.Element){aa=aa.get("element");}else{if(!aa.nodeType&&"length" in aa){ab=[];for(Z=0,W=aa.length;Z<W;++Z){ab[ab.length]=e.Dom.get(aa[Z]);}aa=ab;}}}Y=aa;}return Y;},getComputedStyle:function(G,W){if(window[V]){return G[C][M][V](G,null)[W];}else{if(G[y]){return e.Dom.IE_ComputedStyle.get(G,W);}}},getStyle:function(G,W){return e.Dom.batch(G,e.Dom._getStyle,W);},_getStyle:function(){if(window[V]){return function(G,Y){Y=(Y==="float")?Y="cssFloat":e.Dom._toCamel(Y);var X=G.style[Y],W;if(!X){W=G[C][M][V](G,null);if(W){X=W[Y];}}return X;};}else{if(v[y]){return function(G,Y){var X;switch(Y){case"opacity":X=100;try{X=G.filters["DXImageTransform.Microsoft.Alpha"].opacity;}catch(Z){try{X=G.filters("alpha").opacity;}catch(W){}}return X/100;case"float":Y="styleFloat";default:Y=e.Dom._toCamel(Y);X=G[y]?G[y][Y]:null;return(G.style[Y]||X);}};}}}(),setStyle:function(G,W,X){e.Dom.batch(G,e.Dom._setStyle,{prop:W,val:X});},_setStyle:function(){if(!window.getComputedStyle&&j.documentElement.currentStyle){return function(W,G){var X=e.Dom._toCamel(G.prop),Y=G.val;if(W){switch(X){case"opacity":if(Y===""||Y===null||Y===1){W.style.removeAttribute("filter");}else{if(k.isString(W.style.filter)){W.style.filter="alpha(opacity="+Y*100+")";if(!W[y]||!W[y].hasLayout){W.style.zoom=1;}}}break;case"float":X="styleFloat";default:W.style[X]=Y;}}else{}};}else{return function(W,G){var X=e.Dom._toCamel(G.prop),Y=G.val;if(W){if(X=="float"){X="cssFloat";}W.style[X]=Y;}else{}};}}(),getXY:function(G){return e.Dom.batch(G,e.Dom._getXY);},_canPosition:function(G){return(e.Dom._getStyle(G,"display")!=="none"&&e.Dom._inDoc(G));},_getXY:function(W){var X,G,Z,ab,Y,aa,ac=Math.round,ad=false;if(e.Dom._canPosition(W)){Z=W[p]();ab=W[C];X=e.Dom.getDocumentScrollLeft(ab);G=e.Dom.getDocumentScrollTop(ab);ad=[Z[I],Z[N]];if(Y||aa){ad[0]-=aa;ad[1]-=Y;}if((G||X)){ad[0]+=X;ad[1]+=G;}ad[0]=ac(ad[0]);ad[1]=ac(ad[1]);}else{}return ad;},getX:function(G){var W=function(X){return e.Dom.getXY(X)[0];};return e.Dom.batch(G,W,e.Dom,true);},getY:function(G){var W=function(X){return e.Dom.getXY(X)[1];};return e.Dom.batch(G,W,e.Dom,true);},setXY:function(G,X,W){e.Dom.batch(G,e.Dom._setXY,{pos:X,noRetry:W});},_setXY:function(G,Z){var aa=e.Dom._getStyle(G,O),Y=e.Dom.setStyle,ad=Z.pos,W=Z.noRetry,ab=[parseInt(e.Dom.getComputedStyle(G,I),10),parseInt(e.Dom.getComputedStyle(G,N),10)],ac,X;ac=e.Dom._getXY(G);if(!ad||ac===false){return false;}if(aa=="static"){aa=u;Y(G,O,aa);}if(isNaN(ab[0])){ab[0]=(aa==u)?0:G[z];}if(isNaN(ab[1])){ab[1]=(aa==u)?0:G[o];}if(ad[0]!==null){Y(G,I,ad[0]-ac[0]+ab[0]+"px");}if(ad[1]!==null){Y(G,N,ad[1]-ac[1]+ab[1]+"px");}if(!W){X=e.Dom._getXY(G);if((ad[0]!==null&&X[0]!=ad[0])||(ad[1]!==null&&X[1]!=ad[1])){e.Dom._setXY(G,{pos:ad,noRetry:true});}}},setX:function(W,G){e.Dom.setXY(W,[G,null]);},setY:function(G,W){e.Dom.setXY(G,[null,W]);},getRegion:function(G){var W=function(X){var Y=false;if(e.Dom._canPosition(X)){Y=e.Region.getRegion(X);}else{}return Y;};return e.Dom.batch(G,W,e.Dom,true);},getClientWidth:function(){return e.Dom.getViewportWidth();},getClientHeight:function(){return e.Dom.getViewportHeight();},getElementsByClassName:function(ab,af,ac,ae,X,ad){af=af||"*";ac=(ac)?e.Dom.get(ac):null||j;if(!ac){return[];}var W=[],G=ac.getElementsByTagName(af),Z=e.Dom.hasClass;for(var Y=0,aa=G.length;Y<aa;++Y){if(Z(G[Y],ab)){W[W.length]=G[Y];}}if(ae){e.Dom.batch(W,ae,X,ad);}return W;},hasClass:function(W,G){return e.Dom.batch(W,e.Dom._hasClass,G);},_hasClass:function(X,W){var G=false,Y;if(X&&W){Y=e.Dom._getAttribute(X,f)||i;if(Y){Y=Y.replace(/\s+/g,b);}if(W.exec){G=W.test(Y);}else{G=W&&(b+Y+b).indexOf(b+W+b)>-1;}}else{}return G;},addClass:function(W,G){return e.Dom.batch(W,e.Dom._addClass,G);},_addClass:function(X,W){var G=false,Y;if(X&&W){Y=e.Dom._getAttribute(X,f)||i;if(!e.Dom._hasClass(X,W)){e.Dom.setAttribute(X,f,a(Y+b+W));G=true;}}else{}return G;},removeClass:function(W,G){return e.Dom.batch(W,e.Dom._removeClass,G);},_removeClass:function(Y,X){var W=false,aa,Z,G;if(Y&&X){aa=e.Dom._getAttribute(Y,f)||i;e.Dom.setAttribute(Y,f,aa.replace(e.Dom._getClassRegex(X),i));Z=e.Dom._getAttribute(Y,f);if(aa!==Z){e.Dom.setAttribute(Y,f,a(Z));W=true;if(e.Dom._getAttribute(Y,f)===""){G=(Y.hasAttribute&&Y.hasAttribute(E))?E:f;Y.removeAttribute(G);}}}else{}return W;},replaceClass:function(X,W,G){return e.Dom.batch(X,e.Dom._replaceClass,{from:W,to:G});},_replaceClass:function(Y,X){var W,ab,aa,G=false,Z;if(Y&&X){ab=X.from;aa=X.to;if(!aa){G=false;}else{if(!ab){G=e.Dom._addClass(Y,X.to);}else{if(ab!==aa){Z=e.Dom._getAttribute(Y,f)||i;W=(b+Z.replace(e.Dom._getClassRegex(ab),b+aa).replace(/\s+/g,b)).split(e.Dom._getClassRegex(aa));W.splice(1,0,b+aa);e.Dom.setAttribute(Y,f,a(W.join(i)));G=true;}}}}else{}return G;},generateId:function(G,X){X=X||"yui-gen";var W=function(Y){if(Y&&Y.id){return Y.id;}var Z=X+YAHOO.env._id_counter++;
+if(Y){if(Y[C]&&Y[C].getElementById(Z)){return e.Dom.generateId(Y,Z+X);}Y.id=Z;}return Z;};return e.Dom.batch(G,W,e.Dom,true)||W.apply(e.Dom,arguments);},isAncestor:function(W,X){W=e.Dom.get(W);X=e.Dom.get(X);var G=false;if((W&&X)&&(W[K]&&X[K])){if(W.contains&&W!==X){G=W.contains(X);}else{if(W.compareDocumentPosition){G=!!(W.compareDocumentPosition(X)&16);}}}else{}return G;},inDocument:function(G,W){return e.Dom._inDoc(e.Dom.get(G),W);},_inDoc:function(W,X){var G=false;if(W&&W[c]){X=X||W[C];G=e.Dom.isAncestor(X[U],W);}else{}return G;},getElementsBy:function(W,af,ab,ad,X,ac,ae){af=af||"*";ab=(ab)?e.Dom.get(ab):null||j;var aa=(ae)?null:[],G;if(ab){G=ab.getElementsByTagName(af);for(var Y=0,Z=G.length;Y<Z;++Y){if(W(G[Y])){if(ae){aa=G[Y];break;}else{aa[aa.length]=G[Y];}}}if(ad){e.Dom.batch(aa,ad,X,ac);}}return aa;},getElementBy:function(X,G,W){return e.Dom.getElementsBy(X,G,W,null,null,null,true);},batch:function(X,ab,aa,Z){var Y=[],W=(Z)?aa:null;X=(X&&(X[c]||X.item))?X:e.Dom.get(X);if(X&&ab){if(X[c]||X.length===undefined){return ab.call(W,X,aa);}for(var G=0;G<X.length;++G){Y[Y.length]=ab.call(W||X[G],X[G],aa);}}else{return false;}return Y;},getDocumentHeight:function(){var W=(j[S]!=l||h)?j.body.scrollHeight:v.scrollHeight,G=Math.max(W,e.Dom.getViewportHeight());return G;},getDocumentWidth:function(){var W=(j[S]!=l||h)?j.body.scrollWidth:v.scrollWidth,G=Math.max(W,e.Dom.getViewportWidth());return G;},getViewportHeight:function(){var G=self.innerHeight,W=j[S];if((W||s)&&!d){G=(W==l)?v.clientHeight:j.body.clientHeight;}return G;},getViewportWidth:function(){var G=self.innerWidth,W=j[S];if(W||s){G=(W==l)?v.clientWidth:j.body.clientWidth;}return G;},getAncestorBy:function(G,W){while((G=G[x])){if(e.Dom._testElement(G,W)){return G;}}return null;},getAncestorByClassName:function(W,G){W=e.Dom.get(W);if(!W){return null;}var X=function(Y){return e.Dom.hasClass(Y,G);};return e.Dom.getAncestorBy(W,X);},getAncestorByTagName:function(W,G){W=e.Dom.get(W);if(!W){return null;}var X=function(Y){return Y[c]&&Y[c].toUpperCase()==G.toUpperCase();};return e.Dom.getAncestorBy(W,X);},getPreviousSiblingBy:function(G,W){while(G){G=G.previousSibling;if(e.Dom._testElement(G,W)){return G;}}return null;},getPreviousSibling:function(G){G=e.Dom.get(G);if(!G){return null;}return e.Dom.getPreviousSiblingBy(G);},getNextSiblingBy:function(G,W){while(G){G=G.nextSibling;if(e.Dom._testElement(G,W)){return G;}}return null;},getNextSibling:function(G){G=e.Dom.get(G);if(!G){return null;}return e.Dom.getNextSiblingBy(G);},getFirstChildBy:function(G,X){var W=(e.Dom._testElement(G.firstChild,X))?G.firstChild:null;return W||e.Dom.getNextSiblingBy(G.firstChild,X);},getFirstChild:function(G,W){G=e.Dom.get(G);if(!G){return null;}return e.Dom.getFirstChildBy(G);},getLastChildBy:function(G,X){if(!G){return null;}var W=(e.Dom._testElement(G.lastChild,X))?G.lastChild:null;return W||e.Dom.getPreviousSiblingBy(G.lastChild,X);},getLastChild:function(G){G=e.Dom.get(G);return e.Dom.getLastChildBy(G);},getChildrenBy:function(W,Y){var X=e.Dom.getFirstChildBy(W,Y),G=X?[X]:[];e.Dom.getNextSiblingBy(X,function(Z){if(!Y||Y(Z)){G[G.length]=Z;}return false;});return G;},getChildren:function(G){G=e.Dom.get(G);if(!G){}return e.Dom.getChildrenBy(G);},getDocumentScrollLeft:function(G){G=G||j;return Math.max(G[U].scrollLeft,G.body.scrollLeft);},getDocumentScrollTop:function(G){G=G||j;return Math.max(G[U].scrollTop,G.body.scrollTop);},insertBefore:function(W,G){W=e.Dom.get(W);G=e.Dom.get(G);if(!W||!G||!G[x]){return null;}return G[x].insertBefore(W,G);},insertAfter:function(W,G){W=e.Dom.get(W);G=e.Dom.get(G);if(!W||!G||!G[x]){return null;}if(G.nextSibling){return G[x].insertBefore(W,G.nextSibling);}else{return G[x].appendChild(W);}},getClientRegion:function(){var X=e.Dom.getDocumentScrollTop(),W=e.Dom.getDocumentScrollLeft(),Y=e.Dom.getViewportWidth()+W,G=e.Dom.getViewportHeight()+X;return new e.Region(X,Y,G,W);},setAttribute:function(W,G,X){e.Dom.batch(W,e.Dom._setAttribute,{attr:G,val:X});},_setAttribute:function(X,W){var G=e.Dom._toCamel(W.attr),Y=W.val;if(X&&X.setAttribute){if(e.Dom.DOT_ATTRIBUTES[G]&&X.tagName&&X.tagName!="BUTTON"){X[G]=Y;}else{G=e.Dom.CUSTOM_ATTRIBUTES[G]||G;X.setAttribute(G,Y);}}else{}},getAttribute:function(W,G){return e.Dom.batch(W,e.Dom._getAttribute,G);},_getAttribute:function(W,G){var X;G=e.Dom.CUSTOM_ATTRIBUTES[G]||G;if(e.Dom.DOT_ATTRIBUTES[G]){X=W[G];}else{if(W&&"getAttribute" in W){if(/^(?:href|src)$/.test(G)){X=W.getAttribute(G,2);}else{X=W.getAttribute(G);}}else{}}return X;},_toCamel:function(W){var X=B;function G(Y,Z){return Z.toUpperCase();}return X[W]||(X[W]=W.indexOf("-")===-1?W:W.replace(/-([a-z])/gi,G));},_getClassRegex:function(W){var G;if(W!==undefined){if(W.exec){G=W;}else{G=F[W];if(!G){W=W.replace(e.Dom._patterns.CLASS_RE_TOKENS,"\\$1");W=W.replace(/\s+/g,b);G=F[W]=new RegExp(R+W+J,t);}}}return G;},_patterns:{ROOT_TAG:/^body|html$/i,CLASS_RE_TOKENS:/([\.\(\)\^\$\*\+\?\|\[\]\{\}\\])/g},_testElement:function(G,W){return G&&G[K]==1&&(!W||W(G));},_calcBorders:function(X,Y){var W=parseInt(e.Dom[V](X,q),10)||0,G=parseInt(e.Dom[V](X,P),10)||0;if(g){if(m.test(X[c])){W=0;G=0;}}Y[0]+=G;Y[1]+=W;return Y;}};var r=e.Dom[V];if(L.opera){e.Dom[V]=function(W,G){var X=r(W,G);if(w.test(G)){X=e.Dom.Color.toRGB(X);}return X;};}if(L.webkit){e.Dom[V]=function(W,G){var X=r(W,G);if(X==="rgba(0, 0, 0, 0)"){X="transparent";}return X;};}if(L.ie&&L.ie>=8){e.Dom.DOT_ATTRIBUTES.type=true;}})();YAHOO.util.Region=function(d,e,a,c){this.top=d;this.y=d;this[1]=d;this.right=e;this.bottom=a;this.left=c;this.x=c;this[0]=c;this.width=this.right-this.left;this.height=this.bottom-this.top;};YAHOO.util.Region.prototype.contains=function(a){return(a.left>=this.left&&a.right<=this.right&&a.top>=this.top&&a.bottom<=this.bottom);};YAHOO.util.Region.prototype.getArea=function(){return((this.bottom-this.top)*(this.right-this.left));};YAHOO.util.Region.prototype.intersect=function(f){var d=Math.max(this.top,f.top),e=Math.min(this.right,f.right),a=Math.min(this.bottom,f.bottom),c=Math.max(this.left,f.left);
+if(a>=d&&e>=c){return new YAHOO.util.Region(d,e,a,c);}else{return null;}};YAHOO.util.Region.prototype.union=function(f){var d=Math.min(this.top,f.top),e=Math.max(this.right,f.right),a=Math.max(this.bottom,f.bottom),c=Math.min(this.left,f.left);return new YAHOO.util.Region(d,e,a,c);};YAHOO.util.Region.prototype.toString=function(){return("Region {"+"top: "+this.top+", right: "+this.right+", bottom: "+this.bottom+", left: "+this.left+", height: "+this.height+", width: "+this.width+"}");};YAHOO.util.Region.getRegion=function(e){var g=YAHOO.util.Dom.getXY(e),d=g[1],f=g[0]+e.offsetWidth,a=g[1]+e.offsetHeight,c=g[0];return new YAHOO.util.Region(d,f,a,c);};YAHOO.util.Point=function(a,b){if(YAHOO.lang.isArray(a)){b=a[1];a=a[0];}YAHOO.util.Point.superclass.constructor.call(this,b,a,b,a);};YAHOO.extend(YAHOO.util.Point,YAHOO.util.Region);(function(){var b=YAHOO.util,a="clientTop",f="clientLeft",j="parentNode",k="right",w="hasLayout",i="px",u="opacity",l="auto",d="borderLeftWidth",g="borderTopWidth",p="borderRightWidth",v="borderBottomWidth",s="visible",q="transparent",n="height",e="width",h="style",t="currentStyle",r=/^width|height$/,o=/^(\d[.\d]*)+(em|ex|px|gd|rem|vw|vh|vm|ch|mm|cm|in|pt|pc|deg|rad|ms|s|hz|khz|%){1}?/i,m={get:function(x,z){var y="",A=x[t][z];if(z===u){y=b.Dom.getStyle(x,u);}else{if(!A||(A.indexOf&&A.indexOf(i)>-1)){y=A;}else{if(b.Dom.IE_COMPUTED[z]){y=b.Dom.IE_COMPUTED[z](x,z);}else{if(o.test(A)){y=b.Dom.IE.ComputedStyle.getPixel(x,z);}else{y=A;}}}}return y;},getOffset:function(z,E){var B=z[t][E],x=E.charAt(0).toUpperCase()+E.substr(1),C="offset"+x,y="pixel"+x,A="",D;if(B==l){D=z[C];if(D===undefined){A=0;}A=D;if(r.test(E)){z[h][E]=D;if(z[C]>D){A=D-(z[C]-D);}z[h][E]=l;}}else{if(!z[h][y]&&!z[h][E]){z[h][E]=B;}A=z[h][y];}return A+i;},getBorderWidth:function(x,z){var y=null;if(!x[t][w]){x[h].zoom=1;}switch(z){case g:y=x[a];break;case v:y=x.offsetHeight-x.clientHeight-x[a];break;case d:y=x[f];break;case p:y=x.offsetWidth-x.clientWidth-x[f];break;}return y+i;},getPixel:function(y,x){var A=null,B=y[t][k],z=y[t][x];y[h][k]=z;A=y[h].pixelRight;y[h][k]=B;return A+i;},getMargin:function(y,x){var z;if(y[t][x]==l){z=0+i;}else{z=b.Dom.IE.ComputedStyle.getPixel(y,x);}return z;},getVisibility:function(y,x){var z;while((z=y[t])&&z[x]=="inherit"){y=y[j];}return(z)?z[x]:s;},getColor:function(y,x){return b.Dom.Color.toRGB(y[t][x])||q;},getBorderColor:function(y,x){var z=y[t],A=z[x]||z.color;return b.Dom.Color.toRGB(b.Dom.Color.toHex(A));}},c={};c.top=c.right=c.bottom=c.left=c[e]=c[n]=m.getOffset;c.color=m.getColor;c[g]=c[p]=c[v]=c[d]=m.getBorderWidth;c.marginTop=c.marginRight=c.marginBottom=c.marginLeft=m.getMargin;c.visibility=m.getVisibility;c.borderColor=c.borderTopColor=c.borderRightColor=c.borderBottomColor=c.borderLeftColor=m.getBorderColor;b.Dom.IE_COMPUTED=c;b.Dom.IE_ComputedStyle=m;})();(function(){var c="toString",a=parseInt,b=RegExp,d=YAHOO.util;d.Dom.Color={KEYWORDS:{black:"000",silver:"c0c0c0",gray:"808080",white:"fff",maroon:"800000",red:"f00",purple:"800080",fuchsia:"f0f",green:"008000",lime:"0f0",olive:"808000",yellow:"ff0",navy:"000080",blue:"00f",teal:"008080",aqua:"0ff"},re_RGB:/^rgb\(([0-9]+)\s*,\s*([0-9]+)\s*,\s*([0-9]+)\)$/i,re_hex:/^#?([0-9A-F]{2})([0-9A-F]{2})([0-9A-F]{2})$/i,re_hex3:/([0-9A-F])/gi,toRGB:function(e){if(!d.Dom.Color.re_RGB.test(e)){e=d.Dom.Color.toHex(e);}if(d.Dom.Color.re_hex.exec(e)){e="rgb("+[a(b.$1,16),a(b.$2,16),a(b.$3,16)].join(", ")+")";}return e;},toHex:function(f){f=d.Dom.Color.KEYWORDS[f]||f;if(d.Dom.Color.re_RGB.exec(f)){f=[Number(b.$1).toString(16),Number(b.$2).toString(16),Number(b.$3).toString(16)];for(var e=0;e<f.length;e++){if(f[e].length<2){f[e]="0"+f[e];}}f=f.join("");}if(f.length<6){f=f.replace(d.Dom.Color.re_hex3,"$1$1");}if(f!=="transparent"&&f.indexOf("#")<0){f="#"+f;}return f.toUpperCase();}};}());YAHOO.register("dom",YAHOO.util.Dom,{version:"2.9.0",build:"2800"});YAHOO.util.CustomEvent=function(d,c,b,a,e){this.type=d;this.scope=c||window;this.silent=b;this.fireOnce=e;this.fired=false;this.firedWith=null;this.signature=a||YAHOO.util.CustomEvent.LIST;this.subscribers=[];if(!this.silent){}var f="_YUICEOnSubscribe";if(d!==f){this.subscribeEvent=new YAHOO.util.CustomEvent(f,this,true);}this.lastError=null;};YAHOO.util.CustomEvent.LIST=0;YAHOO.util.CustomEvent.FLAT=1;YAHOO.util.CustomEvent.prototype={subscribe:function(b,c,d){if(!b){throw new Error("Invalid callback for subscriber to '"+this.type+"'");}if(this.subscribeEvent){this.subscribeEvent.fire(b,c,d);}var a=new YAHOO.util.Subscriber(b,c,d);if(this.fireOnce&&this.fired){this.notify(a,this.firedWith);}else{this.subscribers.push(a);}},unsubscribe:function(d,f){if(!d){return this.unsubscribeAll();}var e=false;for(var b=0,a=this.subscribers.length;b<a;++b){var c=this.subscribers[b];if(c&&c.contains(d,f)){this._delete(b);e=true;}}return e;},fire:function(){this.lastError=null;var h=[],a=this.subscribers.length;var d=[].slice.call(arguments,0),c=true,f,b=false;if(this.fireOnce){if(this.fired){return true;}else{this.firedWith=d;}}this.fired=true;if(!a&&this.silent){return true;}if(!this.silent){}var e=this.subscribers.slice();for(f=0;f<a;++f){var g=e[f];if(!g||!g.fn){b=true;}else{c=this.notify(g,d);if(false===c){if(!this.silent){}break;}}}return(c!==false);},notify:function(g,c){var b,i=null,f=g.getScope(this.scope),a=YAHOO.util.Event.throwErrors;if(!this.silent){}if(this.signature==YAHOO.util.CustomEvent.FLAT){if(c.length>0){i=c[0];}try{b=g.fn.call(f,i,g.obj);}catch(h){this.lastError=h;if(a){throw h;}}}else{try{b=g.fn.call(f,this.type,c,g.obj);}catch(d){this.lastError=d;if(a){throw d;}}}return b;},unsubscribeAll:function(){var a=this.subscribers.length,b;for(b=a-1;b>-1;b--){this._delete(b);}this.subscribers=[];return a;},_delete:function(a){var b=this.subscribers[a];if(b){delete b.fn;delete b.obj;}this.subscribers.splice(a,1);},toString:function(){return"CustomEvent: "+"'"+this.type+"', "+"context: "+this.scope;}};YAHOO.util.Subscriber=function(a,b,c){this.fn=a;this.obj=YAHOO.lang.isUndefined(b)?null:b;this.overrideContext=c;};YAHOO.util.Subscriber.prototype.getScope=function(a){if(this.overrideContext){if(this.overrideContext===true){return this.obj;}else{return this.overrideContext;}}return a;};YAHOO.util.Subscriber.prototype.contains=function(a,b){if(b){return(this.fn==a&&this.obj==b);}else{return(this.fn==a);}};YAHOO.util.Subscriber.prototype.toString=function(){return"Subscriber { obj: "+this.obj+", overrideContext: "+(this.overrideContext||"no")+" }";};if(!YAHOO.util.Event){YAHOO.util.Event=function(){var g=false,h=[],j=[],a=0,e=[],b=0,c={63232:38,63233:40,63234:37,63235:39,63276:33,63277:34,25:9},d=YAHOO.env.ua.ie,f="focusin",i="focusout";return{POLL_RETRYS:500,POLL_INTERVAL:40,EL:0,TYPE:1,FN:2,WFN:3,UNLOAD_OBJ:3,ADJ_SCOPE:4,OBJ:5,OVERRIDE:6,CAPTURE:7,lastError:null,isSafari:YAHOO.env.ua.webkit,webkit:YAHOO.env.ua.webkit,isIE:d,_interval:null,_dri:null,_specialTypes:{focusin:(d?"focusin":"focus"),focusout:(d?"focusout":"blur")},DOMReady:false,throwErrors:false,startInterval:function(){if(!this._interval){this._interval=YAHOO.lang.later(this.POLL_INTERVAL,this,this._tryPreloadAttach,null,true);}},onAvailable:function(q,m,o,p,n){var k=(YAHOO.lang.isString(q))?[q]:q;for(var l=0;l<k.length;l=l+1){e.push({id:k[l],fn:m,obj:o,overrideContext:p,checkReady:n});}a=this.POLL_RETRYS;this.startInterval();},onContentReady:function(n,k,l,m){this.onAvailable(n,k,l,m,true);},onDOMReady:function(){this.DOMReadyEvent.subscribe.apply(this.DOMReadyEvent,arguments);},_addListener:function(m,k,v,p,t,y){if(!v||!v.call){return false;}if(this._isValidCollection(m)){var w=true;for(var q=0,s=m.length;q<s;++q){w=this.on(m[q],k,v,p,t)&&w;}return w;}else{if(YAHOO.lang.isString(m)){var o=this.getEl(m);if(o){m=o;}else{this.onAvailable(m,function(){YAHOO.util.Event._addListener(m,k,v,p,t,y);});return true;}}}if(!m){return false;}if("unload"==k&&p!==this){j[j.length]=[m,k,v,p,t];return true;}var l=m;if(t){if(t===true){l=p;}else{l=t;}}var n=function(z){return v.call(l,YAHOO.util.Event.getEvent(z,m),p);};var x=[m,k,v,n,l,p,t,y];var r=h.length;h[r]=x;try{this._simpleAdd(m,k,n,y);}catch(u){this.lastError=u;this.removeListener(m,k,v);return false;}return true;},_getType:function(k){return this._specialTypes[k]||k;},addListener:function(m,p,l,n,o){var k=((p==f||p==i)&&!YAHOO.env.ua.ie)?true:false;return this._addListener(m,this._getType(p),l,n,o,k);},addFocusListener:function(l,k,m,n){return this.on(l,f,k,m,n);},removeFocusListener:function(l,k){return this.removeListener(l,f,k);},addBlurListener:function(l,k,m,n){return this.on(l,i,k,m,n);},removeBlurListener:function(l,k){return this.removeListener(l,i,k);},removeListener:function(l,k,r){var m,p,u;k=this._getType(k);if(typeof l=="string"){l=this.getEl(l);}else{if(this._isValidCollection(l)){var s=true;for(m=l.length-1;m>-1;m--){s=(this.removeListener(l[m],k,r)&&s);}return s;}}if(!r||!r.call){return this.purgeElement(l,false,k);}if("unload"==k){for(m=j.length-1;m>-1;m--){u=j[m];if(u&&u[0]==l&&u[1]==k&&u[2]==r){j.splice(m,1);return true;}}return false;}var n=null;var o=arguments[3];if("undefined"===typeof o){o=this._getCacheIndex(h,l,k,r);}if(o>=0){n=h[o];}if(!l||!n){return false;}var t=n[this.CAPTURE]===true?true:false;try{this._simpleRemove(l,k,n[this.WFN],t);}catch(q){this.lastError=q;return false;}delete h[o][this.WFN];delete h[o][this.FN];h.splice(o,1);return true;},getTarget:function(m,l){var k=m.target||m.srcElement;return this.resolveTextNode(k);},resolveTextNode:function(l){try{if(l&&3==l.nodeType){return l.parentNode;}}catch(k){return null;}return l;},getPageX:function(l){var k=l.pageX;if(!k&&0!==k){k=l.clientX||0;if(this.isIE){k+=this._getScrollLeft();}}return k;},getPageY:function(k){var l=k.pageY;if(!l&&0!==l){l=k.clientY||0;if(this.isIE){l+=this._getScrollTop();}}return l;},getXY:function(k){return[this.getPageX(k),this.getPageY(k)];},getRelatedTarget:function(l){var k=l.relatedTarget;
+if(!k){if(l.type=="mouseout"){k=l.toElement;}else{if(l.type=="mouseover"){k=l.fromElement;}}}return this.resolveTextNode(k);},getTime:function(m){if(!m.time){var l=new Date().getTime();try{m.time=l;}catch(k){this.lastError=k;return l;}}return m.time;},stopEvent:function(k){this.stopPropagation(k);this.preventDefault(k);},stopPropagation:function(k){if(k.stopPropagation){k.stopPropagation();}else{k.cancelBubble=true;}},preventDefault:function(k){if(k.preventDefault){k.preventDefault();}else{k.returnValue=false;}},getEvent:function(m,k){var l=m||window.event;if(!l){var n=this.getEvent.caller;while(n){l=n.arguments[0];if(l&&Event==l.constructor){break;}n=n.caller;}}return l;},getCharCode:function(l){var k=l.keyCode||l.charCode||0;if(YAHOO.env.ua.webkit&&(k in c)){k=c[k];}return k;},_getCacheIndex:function(n,q,r,p){for(var o=0,m=n.length;o<m;o=o+1){var k=n[o];if(k&&k[this.FN]==p&&k[this.EL]==q&&k[this.TYPE]==r){return o;}}return -1;},generateId:function(k){var l=k.id;if(!l){l="yuievtautoid-"+b;++b;k.id=l;}return l;},_isValidCollection:function(l){try{return(l&&typeof l!=="string"&&l.length&&!l.tagName&&!l.alert&&typeof l[0]!=="undefined");}catch(k){return false;}},elCache:{},getEl:function(k){return(typeof k==="string")?document.getElementById(k):k;},clearCache:function(){},DOMReadyEvent:new YAHOO.util.CustomEvent("DOMReady",YAHOO,0,0,1),_load:function(l){if(!g){g=true;var k=YAHOO.util.Event;k._ready();k._tryPreloadAttach();}},_ready:function(l){var k=YAHOO.util.Event;if(!k.DOMReady){k.DOMReady=true;k.DOMReadyEvent.fire();k._simpleRemove(document,"DOMContentLoaded",k._ready);}},_tryPreloadAttach:function(){if(e.length===0){a=0;if(this._interval){this._interval.cancel();this._interval=null;}return;}if(this.locked){return;}if(this.isIE){if(!this.DOMReady){this.startInterval();return;}}this.locked=true;var q=!g;if(!q){q=(a>0&&e.length>0);}var p=[];var r=function(t,u){var s=t;if(u.overrideContext){if(u.overrideContext===true){s=u.obj;}else{s=u.overrideContext;}}u.fn.call(s,u.obj);};var l,k,o,n,m=[];for(l=0,k=e.length;l<k;l=l+1){o=e[l];if(o){n=this.getEl(o.id);if(n){if(o.checkReady){if(g||n.nextSibling||!q){m.push(o);e[l]=null;}}else{r(n,o);e[l]=null;}}else{p.push(o);}}}for(l=0,k=m.length;l<k;l=l+1){o=m[l];r(this.getEl(o.id),o);}a--;if(q){for(l=e.length-1;l>-1;l--){o=e[l];if(!o||!o.id){e.splice(l,1);}}this.startInterval();}else{if(this._interval){this._interval.cancel();this._interval=null;}}this.locked=false;},purgeElement:function(p,q,s){var n=(YAHOO.lang.isString(p))?this.getEl(p):p;var r=this.getListeners(n,s),o,k;if(r){for(o=r.length-1;o>-1;o--){var m=r[o];this.removeListener(n,m.type,m.fn);}}if(q&&n&&n.childNodes){for(o=0,k=n.childNodes.length;o<k;++o){this.purgeElement(n.childNodes[o],q,s);}}},getListeners:function(n,k){var q=[],m;if(!k){m=[h,j];}else{if(k==="unload"){m=[j];}else{k=this._getType(k);m=[h];}}var s=(YAHOO.lang.isString(n))?this.getEl(n):n;for(var p=0;p<m.length;p=p+1){var u=m[p];if(u){for(var r=0,t=u.length;r<t;++r){var o=u[r];if(o&&o[this.EL]===s&&(!k||k===o[this.TYPE])){q.push({type:o[this.TYPE],fn:o[this.FN],obj:o[this.OBJ],adjust:o[this.OVERRIDE],scope:o[this.ADJ_SCOPE],index:r});}}}}return(q.length)?q:null;},_unload:function(s){var m=YAHOO.util.Event,p,o,n,r,q,t=j.slice(),k;for(p=0,r=j.length;p<r;++p){n=t[p];if(n){try{k=window;if(n[m.ADJ_SCOPE]){if(n[m.ADJ_SCOPE]===true){k=n[m.UNLOAD_OBJ];}else{k=n[m.ADJ_SCOPE];}}n[m.FN].call(k,m.getEvent(s,n[m.EL]),n[m.UNLOAD_OBJ]);}catch(w){}t[p]=null;}}n=null;k=null;j=null;if(h){for(o=h.length-1;o>-1;o--){n=h[o];if(n){try{m.removeListener(n[m.EL],n[m.TYPE],n[m.FN],o);}catch(v){}}}n=null;}try{m._simpleRemove(window,"unload",m._unload);m._simpleRemove(window,"load",m._load);}catch(u){}},_getScrollLeft:function(){return this._getScroll()[1];},_getScrollTop:function(){return this._getScroll()[0];},_getScroll:function(){var k=document.documentElement,l=document.body;if(k&&(k.scrollTop||k.scrollLeft)){return[k.scrollTop,k.scrollLeft];}else{if(l){return[l.scrollTop,l.scrollLeft];}else{return[0,0];}}},regCE:function(){},_simpleAdd:function(){if(window.addEventListener){return function(m,n,l,k){m.addEventListener(n,l,(k));};}else{if(window.attachEvent){return function(m,n,l,k){m.attachEvent("on"+n,l);};}else{return function(){};}}}(),_simpleRemove:function(){if(window.removeEventListener){return function(m,n,l,k){m.removeEventListener(n,l,(k));};}else{if(window.detachEvent){return function(l,m,k){l.detachEvent("on"+m,k);};}else{return function(){};}}}()};}();(function(){var a=YAHOO.util.Event;a.on=a.addListener;a.onFocus=a.addFocusListener;a.onBlur=a.addBlurListener;
+/*! DOMReady: based on work by: Dean Edwards/John Resig/Matthias Miller/Diego Perini */
+if(a.isIE){if(self!==self.top){document.onreadystatechange=function(){if(document.readyState=="complete"){document.onreadystatechange=null;a._ready();}};}else{YAHOO.util.Event.onDOMReady(YAHOO.util.Event._tryPreloadAttach,YAHOO.util.Event,true);var b=document.createElement("p");a._dri=setInterval(function(){try{b.doScroll("left");clearInterval(a._dri);a._dri=null;a._ready();b=null;}catch(c){}},a.POLL_INTERVAL);}}else{if(a.webkit&&a.webkit<525){a._dri=setInterval(function(){var c=document.readyState;if("loaded"==c||"complete"==c){clearInterval(a._dri);a._dri=null;a._ready();}},a.POLL_INTERVAL);}else{a._simpleAdd(document,"DOMContentLoaded",a._ready);}}a._simpleAdd(window,"load",a._load);a._simpleAdd(window,"unload",a._unload);a._tryPreloadAttach();})();}YAHOO.util.EventProvider=function(){};YAHOO.util.EventProvider.prototype={__yui_events:null,__yui_subscribers:null,subscribe:function(a,c,f,e){this.__yui_events=this.__yui_events||{};var d=this.__yui_events[a];if(d){d.subscribe(c,f,e);}else{this.__yui_subscribers=this.__yui_subscribers||{};var b=this.__yui_subscribers;if(!b[a]){b[a]=[];}b[a].push({fn:c,obj:f,overrideContext:e});}},unsubscribe:function(c,e,g){this.__yui_events=this.__yui_events||{};var a=this.__yui_events;if(c){var f=a[c];if(f){return f.unsubscribe(e,g);}}else{var b=true;for(var d in a){if(YAHOO.lang.hasOwnProperty(a,d)){b=b&&a[d].unsubscribe(e,g);
+}}return b;}return false;},unsubscribeAll:function(a){return this.unsubscribe(a);},createEvent:function(b,g){this.__yui_events=this.__yui_events||{};var e=g||{},d=this.__yui_events,f;if(d[b]){}else{f=new YAHOO.util.CustomEvent(b,e.scope||this,e.silent,YAHOO.util.CustomEvent.FLAT,e.fireOnce);d[b]=f;if(e.onSubscribeCallback){f.subscribeEvent.subscribe(e.onSubscribeCallback);}this.__yui_subscribers=this.__yui_subscribers||{};var a=this.__yui_subscribers[b];if(a){for(var c=0;c<a.length;++c){f.subscribe(a[c].fn,a[c].obj,a[c].overrideContext);}}}return d[b];},fireEvent:function(b){this.__yui_events=this.__yui_events||{};var d=this.__yui_events[b];if(!d){return null;}var a=[];for(var c=1;c<arguments.length;++c){a.push(arguments[c]);}return d.fire.apply(d,a);},hasEvent:function(a){if(this.__yui_events){if(this.__yui_events[a]){return true;}}return false;}};(function(){var a=YAHOO.util.Event,c=YAHOO.lang;YAHOO.util.KeyListener=function(d,i,e,f){if(!d){}else{if(!i){}else{if(!e){}}}if(!f){f=YAHOO.util.KeyListener.KEYDOWN;}var g=new YAHOO.util.CustomEvent("keyPressed");this.enabledEvent=new YAHOO.util.CustomEvent("enabled");this.disabledEvent=new YAHOO.util.CustomEvent("disabled");if(c.isString(d)){d=document.getElementById(d);}if(c.isFunction(e)){g.subscribe(e);}else{g.subscribe(e.fn,e.scope,e.correctScope);}function h(o,n){if(!i.shift){i.shift=false;}if(!i.alt){i.alt=false;}if(!i.ctrl){i.ctrl=false;}if(o.shiftKey==i.shift&&o.altKey==i.alt&&o.ctrlKey==i.ctrl){var j,m=i.keys,l;if(YAHOO.lang.isArray(m)){for(var k=0;k<m.length;k++){j=m[k];l=a.getCharCode(o);if(j==l){g.fire(l,o);break;}}}else{l=a.getCharCode(o);if(m==l){g.fire(l,o);}}}}this.enable=function(){if(!this.enabled){a.on(d,f,h);this.enabledEvent.fire(i);}this.enabled=true;};this.disable=function(){if(this.enabled){a.removeListener(d,f,h);this.disabledEvent.fire(i);}this.enabled=false;};this.toString=function(){return"KeyListener ["+i.keys+"] "+d.tagName+(d.id?"["+d.id+"]":"");};};var b=YAHOO.util.KeyListener;b.KEYDOWN="keydown";b.KEYUP="keyup";b.KEY={ALT:18,BACK_SPACE:8,CAPS_LOCK:20,CONTROL:17,DELETE:46,DOWN:40,END:35,ENTER:13,ESCAPE:27,HOME:36,LEFT:37,META:224,NUM_LOCK:144,PAGE_DOWN:34,PAGE_UP:33,PAUSE:19,PRINTSCREEN:44,RIGHT:39,SCROLL_LOCK:145,SHIFT:16,SPACE:32,TAB:9,UP:38};})();YAHOO.register("event",YAHOO.util.Event,{version:"2.9.0",build:"2800"});YAHOO.register("yahoo-dom-event", YAHOO, {version: "2.9.0", build: "2800"});
\ No newline at end of file

diff --git a/js/yui/yahoo/yahoo-min.js b/js/yui/yahoo/yahoo-min.js
new file mode 100644 (file)
index 0000000..4f18140
--- /dev/null
+++ b/js/yui/yahoo/yahoo-min.js
@@ -0,0 +1,8 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+if(typeof YAHOO=="undefined"||!YAHOO){var YAHOO={};}YAHOO.namespace=function(){var b=arguments,g=null,e,c,f;for(e=0;e<b.length;e=e+1){f=(""+b[e]).split(".");g=YAHOO;for(c=(f[0]=="YAHOO")?1:0;c<f.length;c=c+1){g[f[c]]=g[f[c]]||{};g=g[f[c]];}}return g;};YAHOO.log=function(d,a,c){var b=YAHOO.widget.Logger;if(b&&b.log){return b.log(d,a,c);}else{return false;}};YAHOO.register=function(a,f,e){var k=YAHOO.env.modules,c,j,h,g,d;if(!k[a]){k[a]={versions:[],builds:[]};}c=k[a];j=e.version;h=e.build;g=YAHOO.env.listeners;c.name=a;c.version=j;c.build=h;c.versions.push(j);c.builds.push(h);c.mainClass=f;for(d=0;d<g.length;d=d+1){g[d](c);}if(f){f.VERSION=j;f.BUILD=h;}else{YAHOO.log("mainClass is undefined for module "+a,"warn");}};YAHOO.env=YAHOO.env||{modules:[],listeners:[]};YAHOO.env.getVersion=function(a){return YAHOO.env.modules[a]||null;};YAHOO.env.parseUA=function(d){var e=function(i){var j=0;return parseFloat(i.replace(/\./g,function(){return(j++==1)?"":".";}));},h=navigator,g={ie:0,opera:0,gecko:0,webkit:0,chrome:0,mobile:null,air:0,ipad:0,iphone:0,ipod:0,ios:null,android:0,webos:0,caja:h&&h.cajaVersion,secure:false,os:null},c=d||(navigator&&navigator.userAgent),f=window&&window.location,b=f&&f.href,a;g.secure=b&&(b.toLowerCase().indexOf("https")===0);if(c){if((/windows|win32/i).test(c)){g.os="windows";}else{if((/macintosh/i).test(c)){g.os="macintosh";}else{if((/rhino/i).test(c)){g.os="rhino";}}}if((/KHTML/).test(c)){g.webkit=1;}a=c.match(/AppleWebKit\/([^\s]*)/);if(a&&a[1]){g.webkit=e(a[1]);if(/ Mobile\//.test(c)){g.mobile="Apple";a=c.match(/OS ([^\s]*)/);if(a&&a[1]){a=e(a[1].replace("_","."));}g.ios=a;g.ipad=g.ipod=g.iphone=0;a=c.match(/iPad|iPod|iPhone/);if(a&&a[0]){g[a[0].toLowerCase()]=g.ios;}}else{a=c.match(/NokiaN[^\/]*|Android \d\.\d|webOS\/\d\.\d/);if(a){g.mobile=a[0];}if(/webOS/.test(c)){g.mobile="WebOS";a=c.match(/webOS\/([^\s]*);/);if(a&&a[1]){g.webos=e(a[1]);}}if(/ Android/.test(c)){g.mobile="Android";a=c.match(/Android ([^\s]*);/);if(a&&a[1]){g.android=e(a[1]);}}}a=c.match(/Chrome\/([^\s]*)/);if(a&&a[1]){g.chrome=e(a[1]);}else{a=c.match(/AdobeAIR\/([^\s]*)/);if(a){g.air=a[0];}}}if(!g.webkit){a=c.match(/Opera[\s\/]([^\s]*)/);if(a&&a[1]){g.opera=e(a[1]);a=c.match(/Version\/([^\s]*)/);if(a&&a[1]){g.opera=e(a[1]);}a=c.match(/Opera Mini[^;]*/);if(a){g.mobile=a[0];}}else{a=c.match(/MSIE\s([^;]*)/);if(a&&a[1]){g.ie=e(a[1]);}else{a=c.match(/Gecko\/([^\s]*)/);if(a){g.gecko=1;a=c.match(/rv:([^\s\)]*)/);if(a&&a[1]){g.gecko=e(a[1]);}}}}}}return g;};YAHOO.env.ua=YAHOO.env.parseUA();(function(){YAHOO.namespace("util","widget","example");if("undefined"!==typeof YAHOO_config){var b=YAHOO_config.listener,a=YAHOO.env.listeners,d=true,c;if(b){for(c=0;c<a.length;c++){if(a[c]==b){d=false;break;}}if(d){a.push(b);}}}})();YAHOO.lang=YAHOO.lang||{};(function(){var f=YAHOO.lang,a=Object.prototype,c="[object Array]",h="[object Function]",i="[object Object]",b=[],g={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#x27;","/":"&#x2F;","`":"&#x60;"},d=["toString","valueOf"],e={isArray:function(j){return a.toString.apply(j)===c;},isBoolean:function(j){return typeof j==="boolean";},isFunction:function(j){return(typeof j==="function")||a.toString.apply(j)===h;},isNull:function(j){return j===null;},isNumber:function(j){return typeof j==="number"&&isFinite(j);},isObject:function(j){return(j&&(typeof j==="object"||f.isFunction(j)))||false;},isString:function(j){return typeof j==="string";},isUndefined:function(j){return typeof j==="undefined";},_IEEnumFix:(YAHOO.env.ua.ie)?function(l,k){var j,n,m;for(j=0;j<d.length;j=j+1){n=d[j];m=k[n];if(f.isFunction(m)&&m!=a[n]){l[n]=m;}}}:function(){},escapeHTML:function(j){return j.replace(/[&<>"'\/`]/g,function(k){return g[k];});},extend:function(m,n,l){if(!n||!m){throw new Error("extend failed, please check that "+"all dependencies are included.");}var k=function(){},j;k.prototype=n.prototype;m.prototype=new k();m.prototype.constructor=m;m.superclass=n.prototype;if(n.prototype.constructor==a.constructor){n.prototype.constructor=n;}if(l){for(j in l){if(f.hasOwnProperty(l,j)){m.prototype[j]=l[j];}}f._IEEnumFix(m.prototype,l);}},augmentObject:function(n,m){if(!m||!n){throw new Error("Absorb failed, verify dependencies.");}var j=arguments,l,o,k=j[2];if(k&&k!==true){for(l=2;l<j.length;l=l+1){n[j[l]]=m[j[l]];}}else{for(o in m){if(k||!(o in n)){n[o]=m[o];}}f._IEEnumFix(n,m);}return n;},augmentProto:function(m,l){if(!l||!m){throw new Error("Augment failed, verify dependencies.");}var j=[m.prototype,l.prototype],k;for(k=2;k<arguments.length;k=k+1){j.push(arguments[k]);}f.augmentObject.apply(this,j);return m;},dump:function(j,p){var l,n,r=[],t="{...}",k="f(){...}",q=", ",m=" => ";if(!f.isObject(j)){return j+"";}else{if(j instanceof Date||("nodeType" in j&&"tagName" in j)){return j;}else{if(f.isFunction(j)){return k;}}}p=(f.isNumber(p))?p:3;if(f.isArray(j)){r.push("[");for(l=0,n=j.length;l<n;l=l+1){if(f.isObject(j[l])){r.push((p>0)?f.dump(j[l],p-1):t);}else{r.push(j[l]);}r.push(q);}if(r.length>1){r.pop();}r.push("]");}else{r.push("{");for(l in j){if(f.hasOwnProperty(j,l)){r.push(l+m);if(f.isObject(j[l])){r.push((p>0)?f.dump(j[l],p-1):t);}else{r.push(j[l]);}r.push(q);}}if(r.length>1){r.pop();}r.push("}");}return r.join("");},substitute:function(x,y,E,l){var D,C,B,G,t,u,F=[],p,z=x.length,A="dump",r=" ",q="{",m="}",n,w;for(;;){D=x.lastIndexOf(q,z);if(D<0){break;}C=x.indexOf(m,D);if(D+1>C){break;}p=x.substring(D+1,C);G=p;u=null;B=G.indexOf(r);if(B>-1){u=G.substring(B+1);G=G.substring(0,B);}t=y[G];if(E){t=E(G,t,u);}if(f.isObject(t)){if(f.isArray(t)){t=f.dump(t,parseInt(u,10));}else{u=u||"";n=u.indexOf(A);if(n>-1){u=u.substring(4);}w=t.toString();if(w===i||n>-1){t=f.dump(t,parseInt(u,10));}else{t=w;}}}else{if(!f.isString(t)&&!f.isNumber(t)){t="~-"+F.length+"-~";F[F.length]=p;}}x=x.substring(0,D)+t+x.substring(C+1);if(l===false){z=D-1;}}for(D=F.length-1;D>=0;D=D-1){x=x.replace(new RegExp("~-"+D+"-~"),"{"+F[D]+"}","g");}return x;},trim:function(j){try{return j.replace(/^\s+|\s+$/g,"");}catch(k){return j;
+}},merge:function(){var n={},k=arguments,j=k.length,m;for(m=0;m<j;m=m+1){f.augmentObject(n,k[m],true);}return n;},later:function(t,k,u,n,p){t=t||0;k=k||{};var l=u,s=n,q,j;if(f.isString(u)){l=k[u];}if(!l){throw new TypeError("method undefined");}if(!f.isUndefined(n)&&!f.isArray(s)){s=[n];}q=function(){l.apply(k,s||b);};j=(p)?setInterval(q,t):setTimeout(q,t);return{interval:p,cancel:function(){if(this.interval){clearInterval(j);}else{clearTimeout(j);}}};},isValue:function(j){return(f.isObject(j)||f.isString(j)||f.isNumber(j)||f.isBoolean(j));}};f.hasOwnProperty=(a.hasOwnProperty)?function(j,k){return j&&j.hasOwnProperty&&j.hasOwnProperty(k);}:function(j,k){return !f.isUndefined(j[k])&&j.constructor.prototype[k]!==j[k];};e.augmentObject(f,e,true);YAHOO.util.Lang=f;f.augment=f.augmentProto;YAHOO.augment=f.augmentProto;YAHOO.extend=f.extend;})();YAHOO.register("yahoo",YAHOO,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/yuiloader/yuiloader-min.js b/js/yui/yuiloader/yuiloader-min.js
new file mode 100644 (file)
index 0000000..ef12e38
--- /dev/null
+++ b/js/yui/yuiloader/yuiloader-min.js
@@ -0,0 +1,11 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+if(typeof YAHOO=="undefined"||!YAHOO){var YAHOO={};}YAHOO.namespace=function(){var b=arguments,g=null,e,c,f;for(e=0;e<b.length;e=e+1){f=(""+b[e]).split(".");g=YAHOO;for(c=(f[0]=="YAHOO")?1:0;c<f.length;c=c+1){g[f[c]]=g[f[c]]||{};g=g[f[c]];}}return g;};YAHOO.log=function(d,a,c){var b=YAHOO.widget.Logger;if(b&&b.log){return b.log(d,a,c);}else{return false;}};YAHOO.register=function(a,f,e){var k=YAHOO.env.modules,c,j,h,g,d;if(!k[a]){k[a]={versions:[],builds:[]};}c=k[a];j=e.version;h=e.build;g=YAHOO.env.listeners;c.name=a;c.version=j;c.build=h;c.versions.push(j);c.builds.push(h);c.mainClass=f;for(d=0;d<g.length;d=d+1){g[d](c);}if(f){f.VERSION=j;f.BUILD=h;}else{YAHOO.log("mainClass is undefined for module "+a,"warn");}};YAHOO.env=YAHOO.env||{modules:[],listeners:[]};YAHOO.env.getVersion=function(a){return YAHOO.env.modules[a]||null;};YAHOO.env.parseUA=function(d){var e=function(i){var j=0;return parseFloat(i.replace(/\./g,function(){return(j++==1)?"":".";}));},h=navigator,g={ie:0,opera:0,gecko:0,webkit:0,chrome:0,mobile:null,air:0,ipad:0,iphone:0,ipod:0,ios:null,android:0,webos:0,caja:h&&h.cajaVersion,secure:false,os:null},c=d||(navigator&&navigator.userAgent),f=window&&window.location,b=f&&f.href,a;g.secure=b&&(b.toLowerCase().indexOf("https")===0);if(c){if((/windows|win32/i).test(c)){g.os="windows";}else{if((/macintosh/i).test(c)){g.os="macintosh";}else{if((/rhino/i).test(c)){g.os="rhino";}}}if((/KHTML/).test(c)){g.webkit=1;}a=c.match(/AppleWebKit\/([^\s]*)/);if(a&&a[1]){g.webkit=e(a[1]);if(/ Mobile\//.test(c)){g.mobile="Apple";a=c.match(/OS ([^\s]*)/);if(a&&a[1]){a=e(a[1].replace("_","."));}g.ios=a;g.ipad=g.ipod=g.iphone=0;a=c.match(/iPad|iPod|iPhone/);if(a&&a[0]){g[a[0].toLowerCase()]=g.ios;}}else{a=c.match(/NokiaN[^\/]*|Android \d\.\d|webOS\/\d\.\d/);if(a){g.mobile=a[0];}if(/webOS/.test(c)){g.mobile="WebOS";a=c.match(/webOS\/([^\s]*);/);if(a&&a[1]){g.webos=e(a[1]);}}if(/ Android/.test(c)){g.mobile="Android";a=c.match(/Android ([^\s]*);/);if(a&&a[1]){g.android=e(a[1]);}}}a=c.match(/Chrome\/([^\s]*)/);if(a&&a[1]){g.chrome=e(a[1]);}else{a=c.match(/AdobeAIR\/([^\s]*)/);if(a){g.air=a[0];}}}if(!g.webkit){a=c.match(/Opera[\s\/]([^\s]*)/);if(a&&a[1]){g.opera=e(a[1]);a=c.match(/Version\/([^\s]*)/);if(a&&a[1]){g.opera=e(a[1]);}a=c.match(/Opera Mini[^;]*/);if(a){g.mobile=a[0];}}else{a=c.match(/MSIE\s([^;]*)/);if(a&&a[1]){g.ie=e(a[1]);}else{a=c.match(/Gecko\/([^\s]*)/);if(a){g.gecko=1;a=c.match(/rv:([^\s\)]*)/);if(a&&a[1]){g.gecko=e(a[1]);}}}}}}return g;};YAHOO.env.ua=YAHOO.env.parseUA();(function(){YAHOO.namespace("util","widget","example");if("undefined"!==typeof YAHOO_config){var b=YAHOO_config.listener,a=YAHOO.env.listeners,d=true,c;if(b){for(c=0;c<a.length;c++){if(a[c]==b){d=false;break;}}if(d){a.push(b);}}}})();YAHOO.lang=YAHOO.lang||{};(function(){var f=YAHOO.lang,a=Object.prototype,c="[object Array]",h="[object Function]",i="[object Object]",b=[],g={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#x27;","/":"&#x2F;","`":"&#x60;"},d=["toString","valueOf"],e={isArray:function(j){return a.toString.apply(j)===c;},isBoolean:function(j){return typeof j==="boolean";},isFunction:function(j){return(typeof j==="function")||a.toString.apply(j)===h;},isNull:function(j){return j===null;},isNumber:function(j){return typeof j==="number"&&isFinite(j);},isObject:function(j){return(j&&(typeof j==="object"||f.isFunction(j)))||false;},isString:function(j){return typeof j==="string";},isUndefined:function(j){return typeof j==="undefined";},_IEEnumFix:(YAHOO.env.ua.ie)?function(l,k){var j,n,m;for(j=0;j<d.length;j=j+1){n=d[j];m=k[n];if(f.isFunction(m)&&m!=a[n]){l[n]=m;}}}:function(){},escapeHTML:function(j){return j.replace(/[&<>"'\/`]/g,function(k){return g[k];});},extend:function(m,n,l){if(!n||!m){throw new Error("extend failed, please check that "+"all dependencies are included.");}var k=function(){},j;k.prototype=n.prototype;m.prototype=new k();m.prototype.constructor=m;m.superclass=n.prototype;if(n.prototype.constructor==a.constructor){n.prototype.constructor=n;}if(l){for(j in l){if(f.hasOwnProperty(l,j)){m.prototype[j]=l[j];}}f._IEEnumFix(m.prototype,l);}},augmentObject:function(n,m){if(!m||!n){throw new Error("Absorb failed, verify dependencies.");}var j=arguments,l,o,k=j[2];if(k&&k!==true){for(l=2;l<j.length;l=l+1){n[j[l]]=m[j[l]];}}else{for(o in m){if(k||!(o in n)){n[o]=m[o];}}f._IEEnumFix(n,m);}return n;},augmentProto:function(m,l){if(!l||!m){throw new Error("Augment failed, verify dependencies.");}var j=[m.prototype,l.prototype],k;for(k=2;k<arguments.length;k=k+1){j.push(arguments[k]);}f.augmentObject.apply(this,j);return m;},dump:function(j,p){var l,n,r=[],t="{...}",k="f(){...}",q=", ",m=" => ";if(!f.isObject(j)){return j+"";}else{if(j instanceof Date||("nodeType" in j&&"tagName" in j)){return j;}else{if(f.isFunction(j)){return k;}}}p=(f.isNumber(p))?p:3;if(f.isArray(j)){r.push("[");for(l=0,n=j.length;l<n;l=l+1){if(f.isObject(j[l])){r.push((p>0)?f.dump(j[l],p-1):t);}else{r.push(j[l]);}r.push(q);}if(r.length>1){r.pop();}r.push("]");}else{r.push("{");for(l in j){if(f.hasOwnProperty(j,l)){r.push(l+m);if(f.isObject(j[l])){r.push((p>0)?f.dump(j[l],p-1):t);}else{r.push(j[l]);}r.push(q);}}if(r.length>1){r.pop();}r.push("}");}return r.join("");},substitute:function(x,y,E,l){var D,C,B,G,t,u,F=[],p,z=x.length,A="dump",r=" ",q="{",m="}",n,w;for(;;){D=x.lastIndexOf(q,z);if(D<0){break;}C=x.indexOf(m,D);if(D+1>C){break;}p=x.substring(D+1,C);G=p;u=null;B=G.indexOf(r);if(B>-1){u=G.substring(B+1);G=G.substring(0,B);}t=y[G];if(E){t=E(G,t,u);}if(f.isObject(t)){if(f.isArray(t)){t=f.dump(t,parseInt(u,10));}else{u=u||"";n=u.indexOf(A);if(n>-1){u=u.substring(4);}w=t.toString();if(w===i||n>-1){t=f.dump(t,parseInt(u,10));}else{t=w;}}}else{if(!f.isString(t)&&!f.isNumber(t)){t="~-"+F.length+"-~";F[F.length]=p;}}x=x.substring(0,D)+t+x.substring(C+1);if(l===false){z=D-1;}}for(D=F.length-1;D>=0;D=D-1){x=x.replace(new RegExp("~-"+D+"-~"),"{"+F[D]+"}","g");}return x;},trim:function(j){try{return j.replace(/^\s+|\s+$/g,"");}catch(k){return j;
+}},merge:function(){var n={},k=arguments,j=k.length,m;for(m=0;m<j;m=m+1){f.augmentObject(n,k[m],true);}return n;},later:function(t,k,u,n,p){t=t||0;k=k||{};var l=u,s=n,q,j;if(f.isString(u)){l=k[u];}if(!l){throw new TypeError("method undefined");}if(!f.isUndefined(n)&&!f.isArray(s)){s=[n];}q=function(){l.apply(k,s||b);};j=(p)?setInterval(q,t):setTimeout(q,t);return{interval:p,cancel:function(){if(this.interval){clearInterval(j);}else{clearTimeout(j);}}};},isValue:function(j){return(f.isObject(j)||f.isString(j)||f.isNumber(j)||f.isBoolean(j));}};f.hasOwnProperty=(a.hasOwnProperty)?function(j,k){return j&&j.hasOwnProperty&&j.hasOwnProperty(k);}:function(j,k){return !f.isUndefined(j[k])&&j.constructor.prototype[k]!==j[k];};e.augmentObject(f,e,true);YAHOO.util.Lang=f;f.augment=f.augmentProto;YAHOO.augment=f.augmentProto;YAHOO.extend=f.extend;})();YAHOO.register("yahoo",YAHOO,{version:"2.9.0",build:"2800"});YAHOO.util.Get=function(){var m={},k=0,r=0,l=false,n=YAHOO.env.ua,s=YAHOO.lang,q,d,e,i=function(x,t,y){var u=y||window,z=u.document,A=z.createElement(x),v;for(v in t){if(t.hasOwnProperty(v)){A.setAttribute(v,t[v]);}}return A;},h=function(u,v,t){var w={id:"yui__dyn_"+(r++),type:"text/css",rel:"stylesheet",href:u};if(t){s.augmentObject(w,t);}return i("link",w,v);},p=function(u,v,t){var w={id:"yui__dyn_"+(r++),type:"text/javascript",src:u};if(t){s.augmentObject(w,t);}return i("script",w,v);},a=function(t,u){return{tId:t.tId,win:t.win,data:t.data,nodes:t.nodes,msg:u,purge:function(){d(this.tId);}};},b=function(t,w){var u=m[w],v=(s.isString(t))?u.win.document.getElementById(t):t;if(!v){q(w,"target node not found: "+t);}return v;},c=function(w){YAHOO.log("Finishing transaction "+w);var u=m[w],v,t;u.finished=true;if(u.aborted){v="transaction "+w+" was aborted";q(w,v);return;}if(u.onSuccess){t=u.scope||u.win;u.onSuccess.call(t,a(u));}},o=function(v){YAHOO.log("Timeout "+v,"info","get");var u=m[v],t;if(u.onTimeout){t=u.scope||u;u.onTimeout.call(t,a(u));}},f=function(v,A){YAHOO.log("_next: "+v+", loaded: "+A,"info","Get");var u=m[v],D=u.win,C=D.document,B=C.getElementsByTagName("head")[0],x,y,t,E,z;if(u.timer){u.timer.cancel();}if(u.aborted){y="transaction "+v+" was aborted";q(v,y);return;}if(A){u.url.shift();if(u.varName){u.varName.shift();}}else{u.url=(s.isString(u.url))?[u.url]:u.url;if(u.varName){u.varName=(s.isString(u.varName))?[u.varName]:u.varName;}}if(u.url.length===0){if(u.type==="script"&&n.webkit&&n.webkit<420&&!u.finalpass&&!u.varName){z=p(null,u.win,u.attributes);z.innerHTML='YAHOO.util.Get._finalize("'+v+'");';u.nodes.push(z);B.appendChild(z);}else{c(v);}return;}t=u.url[0];if(!t){u.url.shift();YAHOO.log("skipping empty url");return f(v);}YAHOO.log("attempting to load "+t,"info","Get");if(u.timeout){u.timer=s.later(u.timeout,u,o,v);}if(u.type==="script"){x=p(t,D,u.attributes);}else{x=h(t,D,u.attributes);}e(u.type,x,v,t,D,u.url.length);u.nodes.push(x);if(u.insertBefore){E=b(u.insertBefore,v);if(E){E.parentNode.insertBefore(x,E);}}else{B.appendChild(x);}YAHOO.log("Appending node: "+t,"info","Get");if((n.webkit||n.gecko)&&u.type==="css"){f(v,t);}},j=function(){if(l){return;}l=true;var t,u;for(t in m){if(m.hasOwnProperty(t)){u=m[t];if(u.autopurge&&u.finished){d(u.tId);delete m[t];}}}l=false;},g=function(u,t,v){var x="q"+(k++),w;v=v||{};if(k%YAHOO.util.Get.PURGE_THRESH===0){j();}m[x]=s.merge(v,{tId:x,type:u,url:t,finished:false,aborted:false,nodes:[]});w=m[x];w.win=w.win||window;w.scope=w.scope||w.win;w.autopurge=("autopurge" in w)?w.autopurge:(u==="script")?true:false;w.attributes=w.attributes||{};w.attributes.charset=v.charset||w.attributes.charset||"utf-8";s.later(0,w,f,x);return{tId:x};};e=function(H,z,x,u,D,E,G){var F=G||f,B,t,I,v,J,A,C,y;if(n.ie){z.onreadystatechange=function(){B=this.readyState;if("loaded"===B||"complete"===B){YAHOO.log(x+" onload "+u,"info","Get");z.onreadystatechange=null;F(x,u);}};}else{if(n.webkit){if(H==="script"){if(n.webkit>=420){z.addEventListener("load",function(){YAHOO.log(x+" DOM2 onload "+u,"info","Get");F(x,u);});}else{t=m[x];if(t.varName){v=YAHOO.util.Get.POLL_FREQ;YAHOO.log("Polling for "+t.varName[0]);t.maxattempts=YAHOO.util.Get.TIMEOUT/v;t.attempts=0;t._cache=t.varName[0].split(".");t.timer=s.later(v,t,function(w){I=this._cache;A=I.length;J=this.win;for(C=0;C<A;C=C+1){J=J[I[C]];if(!J){this.attempts++;if(this.attempts++>this.maxattempts){y="Over retry limit, giving up";t.timer.cancel();q(x,y);}else{YAHOO.log(I[C]+" failed, retrying");}return;}}YAHOO.log("Safari poll complete");t.timer.cancel();F(x,u);},null,true);}else{s.later(YAHOO.util.Get.POLL_FREQ,null,F,[x,u]);}}}}else{z.onload=function(){YAHOO.log(x+" onload "+u,"info","Get");F(x,u);};}}};q=function(w,v){YAHOO.log("get failure: "+v,"warn","Get");var u=m[w],t;if(u.onFailure){t=u.scope||u.win;u.onFailure.call(t,a(u,v));}};d=function(z){if(m[z]){var t=m[z],u=t.nodes,x=u.length,C=t.win.document,A=C.getElementsByTagName("head")[0],v,y,w,B;if(t.insertBefore){v=b(t.insertBefore,z);if(v){A=v.parentNode;}}for(y=0;y<x;y=y+1){w=u[y];if(w.clearAttributes){w.clearAttributes();}else{for(B in w){if(w.hasOwnProperty(B)){delete w[B];}}}A.removeChild(w);}t.nodes=[];}};return{POLL_FREQ:10,PURGE_THRESH:20,TIMEOUT:2000,_finalize:function(t){YAHOO.log(t+" finalized ","info","Get");s.later(0,null,c,t);},abort:function(u){var v=(s.isString(u))?u:u.tId,t=m[v];if(t){YAHOO.log("Aborting "+v,"info","Get");t.aborted=true;}},script:function(t,u){return g("script",t,u);},css:function(t,u){return g("css",t,u);}};}();YAHOO.register("get",YAHOO.util.Get,{version:"2.9.0",build:"2800"});(function(){var Y=YAHOO,util=Y.util,lang=Y.lang,env=Y.env,PROV="_provides",SUPER="_supersedes",REQ="expanded",AFTER="_after",VERSION="2.9.0";var YUI={dupsAllowed:{"yahoo":true,"get":true},info:{"root":VERSION+"/build/","base":"http://yui.yahooapis.com/"+VERSION+"/build/","comboBase":"http://yui.yahooapis.com/combo?","skin":{"defaultSkin":"sam","base":"assets/skins/","path":"skin.css","after":["reset","fonts","grids","base"],"rollup":3},dupsAllowed:["yahoo","get"],"moduleInfo":{"animation":{"type":"js","path":"animation/animation-min.js","requires":["dom","event"]},"autocomplete":{"type":"js","path":"autocomplete/autocomplete-min.js","requires":["dom","event","datasource"],"optional":["connection","animation"],"skinnable":true},"base":{"type":"css","path":"base/base-min.css","after":["reset","fonts","grids"]},"button":{"type":"js","path":"button/button-min.js","requires":["element"],"optional":["menu"],"skinnable":true},"calendar":{"type":"js","path":"calendar/calendar-min.js","requires":["event","dom"],supersedes:["datemath"],"skinnable":true},"carousel":{"type":"js","path":"carousel/carousel-min.js","requires":["element"],"optional":["animation"],"skinnable":true},"charts":{"type":"js","path":"charts/charts-min.js","requires":["element","json","datasource","swf"]},"colorpicker":{"type":"js","path":"colorpicker/colorpicker-min.js","requires":["slider","element"],"optional":["animation"],"skinnable":true},"connection":{"type":"js","path":"connection/connection-min.js","requires":["event"],"supersedes":["connectioncore"]},"connectioncore":{"type":"js","path":"connection/connection_core-min.js","requires":["event"],"pkg":"connection"},"container":{"type":"js","path":"container/container-min.js","requires":["dom","event"],"optional":["dragdrop","animation","connection"],"supersedes":["containercore"],"skinnable":true},"containercore":{"type":"js","path":"container/container_core-min.js","requires":["dom","event"],"pkg":"container"},"cookie":{"type":"js","path":"cookie/cookie-min.js","requires":["yahoo"]},"datasource":{"type":"js","path":"datasource/datasource-min.js","requires":["event"],"optional":["connection"]},"datatable":{"type":"js","path":"datatable/datatable-min.js","requires":["element","datasource"],"optional":["calendar","dragdrop","paginator"],"skinnable":true},datemath:{"type":"js","path":"datemath/datemath-min.js","requires":["yahoo"]},"dom":{"type":"js","path":"dom/dom-min.js","requires":["yahoo"]},"dragdrop":{"type":"js","path":"dragdrop/dragdrop-min.js","requires":["dom","event"]},"editor":{"type":"js","path":"editor/editor-min.js","requires":["menu","element","button"],"optional":["animation","dragdrop"],"supersedes":["simpleeditor"],"skinnable":true},"element":{"type":"js","path":"element/element-min.js","requires":["dom","event"],"optional":["event-mouseenter","event-delegate"]},"element-delegate":{"type":"js","path":"element-delegate/element-delegate-min.js","requires":["element"]},"event":{"type":"js","path":"event/event-min.js","requires":["yahoo"]},"event-simulate":{"type":"js","path":"event-simulate/event-simulate-min.js","requires":["event"]},"event-delegate":{"type":"js","path":"event-delegate/event-delegate-min.js","requires":["event"],"optional":["selector"]},"event-mouseenter":{"type":"js","path":"event-mouseenter/event-mouseenter-min.js","requires":["dom","event"]},"fonts":{"type":"css","path":"fonts/fonts-min.css"},"get":{"type":"js","path":"get/get-min.js","requires":["yahoo"]},"grids":{"type":"css","path":"grids/grids-min.css","requires":["fonts"],"optional":["reset"]},"history":{"type":"js","path":"history/history-min.js","requires":["event"]},"imagecropper":{"type":"js","path":"imagecropper/imagecropper-min.js","requires":["dragdrop","element","resize"],"skinnable":true},"imageloader":{"type":"js","path":"imageloader/imageloader-min.js","requires":["event","dom"]},"json":{"type":"js","path":"json/json-min.js","requires":["yahoo"]},"layout":{"type":"js","path":"layout/layout-min.js","requires":["element"],"optional":["animation","dragdrop","resize","selector"],"skinnable":true},"logger":{"type":"js","path":"logger/logger-min.js","requires":["event","dom"],"optional":["dragdrop"],"skinnable":true},"menu":{"type":"js","path":"menu/menu-min.js","requires":["containercore"],"skinnable":true},"paginator":{"type":"js","path":"paginator/paginator-min.js","requires":["element"],"skinnable":true},"profiler":{"type":"js","path":"profiler/profiler-min.js","requires":["yahoo"]},"profilerviewer":{"type":"js","path":"profilerviewer/profilerviewer-min.js","requires":["profiler","yuiloader","element"],"skinnable":true},"progressbar":{"type":"js","path":"progressbar/progressbar-min.js","requires":["element"],"optional":["animation"],"skinnable":true},"reset":{"type":"css","path":"reset/reset-min.css"},"reset-fonts-grids":{"type":"css","path":"reset-fonts-grids/reset-fonts-grids.css","supersedes":["reset","fonts","grids","reset-fonts"],"rollup":4},"reset-fonts":{"type":"css","path":"reset-fonts/reset-fonts.css","supersedes":["reset","fonts"],"rollup":2},"resize":{"type":"js","path":"resize/resize-min.js","requires":["dragdrop","element"],"optional":["animation"],"skinnable":true},"selector":{"type":"js","path":"selector/selector-min.js","requires":["yahoo","dom"]},"simpleeditor":{"type":"js","path":"editor/simpleeditor-min.js","requires":["element"],"optional":["containercore","menu","button","animation","dragdrop"],"skinnable":true,"pkg":"editor"},"slider":{"type":"js","path":"slider/slider-min.js","requires":["dragdrop"],"optional":["animation"],"skinnable":true},"storage":{"type":"js","path":"storage/storage-min.js","requires":["yahoo","event","cookie"],"optional":["swfstore"]},"stylesheet":{"type":"js","path":"stylesheet/stylesheet-min.js","requires":["yahoo"]},"swf":{"type":"js","path":"swf/swf-min.js","requires":["element"],"supersedes":["swfdetect"]},"swfdetect":{"type":"js","path":"swfdetect/swfdetect-min.js","requires":["yahoo"]},"swfstore":{"type":"js","path":"swfstore/swfstore-min.js","requires":["element","cookie","swf"]},"tabview":{"type":"js","path":"tabview/tabview-min.js","requires":["element"],"optional":["connection"],"skinnable":true},"treeview":{"type":"js","path":"treeview/treeview-min.js","requires":["event","dom"],"optional":["json","animation","calendar"],"skinnable":true},"uploader":{"type":"js","path":"uploader/uploader-min.js","requires":["element"]},"utilities":{"type":"js","path":"utilities/utilities.js","supersedes":["yahoo","event","dragdrop","animation","dom","connection","element","yahoo-dom-event","get","yuiloader","yuiloader-dom-event"],"rollup":8},"yahoo":{"type":"js","path":"yahoo/yahoo-min.js"},"yahoo-dom-event":{"type":"js","path":"yahoo-dom-event/yahoo-dom-event.js","supersedes":["yahoo","event","dom"],"rollup":3},"yuiloader":{"type":"js","path":"yuiloader/yuiloader-min.js","supersedes":["yahoo","get"]},"yuiloader-dom-event":{"type":"js","path":"yuiloader-dom-event/yuiloader-dom-event.js","supersedes":["yahoo","dom","event","get","yuiloader","yahoo-dom-event"],"rollup":5},"yuitest":{"type":"js","path":"yuitest/yuitest-min.js","requires":["logger"],"optional":["event-simulate"],"skinnable":true}}},ObjectUtil:{appendArray:function(o,a){if(a){for(var i=0;
+i<a.length;i=i+1){o[a[i]]=true;}}},keys:function(o,ordered){var a=[],i;for(i in o){if(lang.hasOwnProperty(o,i)){a.push(i);}}return a;}},ArrayUtil:{appendArray:function(a1,a2){Array.prototype.push.apply(a1,a2);},indexOf:function(a,val){for(var i=0;i<a.length;i=i+1){if(a[i]===val){return i;}}return -1;},toObject:function(a){var o={};for(var i=0;i<a.length;i=i+1){o[a[i]]=true;}return o;},uniq:function(a){return YUI.ObjectUtil.keys(YUI.ArrayUtil.toObject(a));}}};YAHOO.util.YUILoader=function(o){this._internalCallback=null;this._useYahooListener=false;this.onSuccess=null;this.onFailure=Y.log;this.onProgress=null;this.onTimeout=null;this.scope=this;this.data=null;this.insertBefore=null;this.charset=null;this.varName=null;this.base=YUI.info.base;this.comboBase=YUI.info.comboBase;this.combine=false;this.root=YUI.info.root;this.timeout=0;this.ignore=null;this.force=null;this.allowRollup=true;this.filter=null;this.required={};this.moduleInfo=lang.merge(YUI.info.moduleInfo);this.rollups=null;this.loadOptional=false;this.sorted=[];this.loaded={};this.dirty=true;this.inserted={};var self=this;env.listeners.push(function(m){if(self._useYahooListener){self.loadNext(m.name);}});this.skin=lang.merge(YUI.info.skin);this._config(o);};Y.util.YUILoader.prototype={FILTERS:{RAW:{"searchExp":"-min\\.js","replaceStr":".js"},DEBUG:{"searchExp":"-min\\.js","replaceStr":"-debug.js"}},SKIN_PREFIX:"skin-",_config:function(o){if(o){for(var i in o){if(lang.hasOwnProperty(o,i)){if(i=="require"){this.require(o[i]);}else{this[i]=o[i];}}}}var f=this.filter;if(lang.isString(f)){f=f.toUpperCase();if(f==="DEBUG"){this.require("logger");}if(!Y.widget.LogWriter){Y.widget.LogWriter=function(){return Y;};}this.filter=this.FILTERS[f];}},addModule:function(o){if(!o||!o.name||!o.type||(!o.path&&!o.fullpath)){return false;}o.ext=("ext" in o)?o.ext:true;o.requires=o.requires||[];this.moduleInfo[o.name]=o;this.dirty=true;return true;},require:function(what){var a=(typeof what==="string")?arguments:what;this.dirty=true;YUI.ObjectUtil.appendArray(this.required,a);},_addSkin:function(skin,mod){var name=this.formatSkin(skin),info=this.moduleInfo,sinf=this.skin,ext=info[mod]&&info[mod].ext;if(!info[name]){this.addModule({"name":name,"type":"css","path":sinf.base+skin+"/"+sinf.path,"after":sinf.after,"rollup":sinf.rollup,"ext":ext});}if(mod){name=this.formatSkin(skin,mod);if(!info[name]){var mdef=info[mod],pkg=mdef.pkg||mod;this.addModule({"name":name,"type":"css","after":sinf.after,"path":pkg+"/"+sinf.base+skin+"/"+mod+".css","ext":ext});}}return name;},getRequires:function(mod){if(!mod){return[];}if(!this.dirty&&mod.expanded){return mod.expanded;}mod.requires=mod.requires||[];var i,d=[],r=mod.requires,o=mod.optional,info=this.moduleInfo,m;for(i=0;i<r.length;i=i+1){d.push(r[i]);m=info[r[i]];YUI.ArrayUtil.appendArray(d,this.getRequires(m));}if(o&&this.loadOptional){for(i=0;i<o.length;i=i+1){d.push(o[i]);YUI.ArrayUtil.appendArray(d,this.getRequires(info[o[i]]));}}mod.expanded=YUI.ArrayUtil.uniq(d);return mod.expanded;},getProvides:function(name,notMe){var addMe=!(notMe),ckey=(addMe)?PROV:SUPER,m=this.moduleInfo[name],o={};if(!m){return o;}if(m[ckey]){return m[ckey];}var s=m.supersedes,done={},me=this;var add=function(mm){if(!done[mm]){done[mm]=true;lang.augmentObject(o,me.getProvides(mm));}};if(s){for(var i=0;i<s.length;i=i+1){add(s[i]);}}m[SUPER]=o;m[PROV]=lang.merge(o);m[PROV][name]=true;return m[ckey];},calculate:function(o){if(o||this.dirty){this._config(o);this._setup();this._explode();if(this.allowRollup){this._rollup();}this._reduce();this._sort();this.dirty=false;}},_setup:function(){var info=this.moduleInfo,name,i,j;for(name in info){if(lang.hasOwnProperty(info,name)){var m=info[name];if(m&&m.skinnable){var o=this.skin.overrides,smod;if(o&&o[name]){for(i=0;i<o[name].length;i=i+1){smod=this._addSkin(o[name][i],name);}}else{smod=this._addSkin(this.skin.defaultSkin,name);}if(YUI.ArrayUtil.indexOf(m.requires,smod)==-1){m.requires.push(smod);}}}}var l=lang.merge(this.inserted);if(!this._sandbox){l=lang.merge(l,env.modules);}if(this.ignore){YUI.ObjectUtil.appendArray(l,this.ignore);}if(this.force){for(i=0;i<this.force.length;i=i+1){if(this.force[i] in l){delete l[this.force[i]];}}}for(j in l){if(lang.hasOwnProperty(l,j)){lang.augmentObject(l,this.getProvides(j));}}this.loaded=l;},_explode:function(){var r=this.required,i,mod;for(i in r){if(lang.hasOwnProperty(r,i)){mod=this.moduleInfo[i];if(mod){var req=this.getRequires(mod);if(req){YUI.ObjectUtil.appendArray(r,req);}}}}},_skin:function(){},formatSkin:function(skin,mod){var s=this.SKIN_PREFIX+skin;if(mod){s=s+"-"+mod;}return s;},parseSkin:function(mod){if(mod.indexOf(this.SKIN_PREFIX)===0){var a=mod.split("-");return{skin:a[1],module:a[2]};}return null;},_rollup:function(){var i,j,m,s,rollups={},r=this.required,roll,info=this.moduleInfo;if(this.dirty||!this.rollups){for(i in info){if(lang.hasOwnProperty(info,i)){m=info[i];if(m&&m.rollup){rollups[i]=m;}}}this.rollups=rollups;}for(;;){var rolled=false;for(i in rollups){if(!r[i]&&!this.loaded[i]){m=info[i];s=m.supersedes;roll=false;if(!m.rollup){continue;}var skin=(m.ext)?false:this.parseSkin(i),c=0;if(skin){for(j in r){if(lang.hasOwnProperty(r,j)){if(i!==j&&this.parseSkin(j)){c++;roll=(c>=m.rollup);if(roll){break;}}}}}else{for(j=0;j<s.length;j=j+1){if(this.loaded[s[j]]&&(!YUI.dupsAllowed[s[j]])){roll=false;break;}else{if(r[s[j]]){c++;roll=(c>=m.rollup);if(roll){break;}}}}}if(roll){r[i]=true;rolled=true;this.getRequires(m);}}}if(!rolled){break;}}},_reduce:function(){var i,j,s,m,r=this.required;for(i in r){if(i in this.loaded){delete r[i];}else{var skinDef=this.parseSkin(i);if(skinDef){if(!skinDef.module){var skin_pre=this.SKIN_PREFIX+skinDef.skin;for(j in r){if(lang.hasOwnProperty(r,j)){m=this.moduleInfo[j];var ext=m&&m.ext;if(!ext&&j!==i&&j.indexOf(skin_pre)>-1){delete r[j];}}}}}else{m=this.moduleInfo[i];s=m&&m.supersedes;if(s){for(j=0;j<s.length;j=j+1){if(s[j] in r){delete r[s[j]];}}}}}}},_onFailure:function(msg){YAHOO.log("Failure","info","loader");
+var f=this.onFailure;if(f){f.call(this.scope,{msg:"failure: "+msg,data:this.data,success:false});}},_onTimeout:function(){YAHOO.log("Timeout","info","loader");var f=this.onTimeout;if(f){f.call(this.scope,{msg:"timeout",data:this.data,success:false});}},_sort:function(){var s=[],info=this.moduleInfo,loaded=this.loaded,checkOptional=!this.loadOptional,me=this;var requires=function(aa,bb){var mm=info[aa];if(loaded[bb]||!mm){return false;}var ii,rr=mm.expanded,after=mm.after,other=info[bb],optional=mm.optional;if(rr&&YUI.ArrayUtil.indexOf(rr,bb)>-1){return true;}if(after&&YUI.ArrayUtil.indexOf(after,bb)>-1){return true;}if(checkOptional&&optional&&YUI.ArrayUtil.indexOf(optional,bb)>-1){return true;}var ss=info[bb]&&info[bb].supersedes;if(ss){for(ii=0;ii<ss.length;ii=ii+1){if(requires(aa,ss[ii])){return true;}}}if(mm.ext&&mm.type=="css"&&!other.ext&&other.type=="css"){return true;}return false;};for(var i in this.required){if(lang.hasOwnProperty(this.required,i)){s.push(i);}}var p=0;for(;;){var l=s.length,a,b,j,k,moved=false;for(j=p;j<l;j=j+1){a=s[j];for(k=j+1;k<l;k=k+1){if(requires(a,s[k])){b=s.splice(k,1);s.splice(j,0,b[0]);moved=true;break;}}if(moved){break;}else{p=p+1;}}if(!moved){break;}}this.sorted=s;},toString:function(){var o={type:"YUILoader",base:this.base,filter:this.filter,required:this.required,loaded:this.loaded,inserted:this.inserted};lang.dump(o,1);},_combine:function(){this._combining=[];var self=this,s=this.sorted,len=s.length,js=this.comboBase,css=this.comboBase,target,startLen=js.length,i,m,type=this.loadType;YAHOO.log("type "+type);for(i=0;i<len;i=i+1){m=this.moduleInfo[s[i]];if(m&&!m.ext&&(!type||type===m.type)){target=this.root+m.path;target+="&";if(m.type=="js"){js+=target;}else{css+=target;}this._combining.push(s[i]);}}if(this._combining.length){YAHOO.log("Attempting to combine: "+this._combining,"info","loader");var callback=function(o){var c=this._combining,len=c.length,i,m;for(i=0;i<len;i=i+1){this.inserted[c[i]]=true;}this.loadNext(o.data);},loadScript=function(){if(js.length>startLen){YAHOO.util.Get.script(self._filter(js),{data:self._loading,onSuccess:callback,onFailure:self._onFailure,onTimeout:self._onTimeout,insertBefore:self.insertBefore,charset:self.charset,timeout:self.timeout,scope:self});}else{this.loadNext();}};if(css.length>startLen){YAHOO.util.Get.css(this._filter(css),{data:this._loading,onSuccess:loadScript,onFailure:this._onFailure,onTimeout:this._onTimeout,insertBefore:this.insertBefore,charset:this.charset,timeout:this.timeout,scope:self});}else{loadScript();}return;}else{this.loadNext(this._loading);}},insert:function(o,type){this.calculate(o);this._loading=true;this.loadType=type;if(this.combine){return this._combine();}if(!type){var self=this;this._internalCallback=function(){self._internalCallback=null;self.insert(null,"js");};this.insert(null,"css");return;}this.loadNext();},sandbox:function(o,type){var self=this,success=function(o){var idx=o.argument[0],name=o.argument[2];self._scriptText[idx]=o.responseText;if(self.onProgress){self.onProgress.call(self.scope,{name:name,scriptText:o.responseText,xhrResponse:o,data:self.data});}self._loadCount++;if(self._loadCount>=self._stopCount){var v=self.varName||"YAHOO";var t="(function() {\n";var b="\nreturn "+v+";\n})();";var ref=eval(t+self._scriptText.join("\n")+b);self._pushEvents(ref);if(ref){self.onSuccess.call(self.scope,{reference:ref,data:self.data});}else{self._onFailure.call(self.varName+" reference failure");}}},failure=function(o){self.onFailure.call(self.scope,{msg:"XHR failure",xhrResponse:o,data:self.data});};self._config(o);if(!self.onSuccess){throw new Error("You must supply an onSuccess handler for your sandbox");}self._sandbox=true;if(!type||type!=="js"){self._internalCallback=function(){self._internalCallback=null;self.sandbox(null,"js");};self.insert(null,"css");return;}if(!util.Connect){var ld=new YAHOO.util.YUILoader();ld.insert({base:self.base,filter:self.filter,require:"connection",insertBefore:self.insertBefore,charset:self.charset,onSuccess:function(){self.sandbox(null,"js");},scope:self},"js");return;}self._scriptText=[];self._loadCount=0;self._stopCount=self.sorted.length;self._xhr=[];self.calculate();var s=self.sorted,l=s.length,i,m,url;for(i=0;i<l;i=i+1){m=self.moduleInfo[s[i]];if(!m){self._onFailure("undefined module "+m);for(var j=0;j<self._xhr.length;j=j+1){self._xhr[j].abort();}return;}if(m.type!=="js"){self._loadCount++;continue;}url=m.fullpath;url=(url)?self._filter(url):self._url(m.path);var xhrData={success:success,failure:failure,scope:self,argument:[i,url,s[i]]};self._xhr.push(util.Connect.asyncRequest("GET",url,xhrData));}},loadNext:function(mname){if(!this._loading){return;}var self=this,donext=function(o){self.loadNext(o.data);},successfn,s=this.sorted,len=s.length,i,fn,m,url;if(mname){if(mname!==this._loading){return;}this.inserted[mname]=true;if(this.onProgress){this.onProgress.call(this.scope,{name:mname,data:this.data});}}for(i=0;i<len;i=i+1){if(s[i] in this.inserted){continue;}if(s[i]===this._loading){return;}m=this.moduleInfo[s[i]];if(!m){this.onFailure.call(this.scope,{msg:"undefined module "+m,data:this.data});return;}if(!this.loadType||this.loadType===m.type){successfn=donext;this._loading=s[i];fn=(m.type==="css")?util.Get.css:util.Get.script;url=m.fullpath;url=(url)?this._filter(url):this._url(m.path);if(env.ua.webkit&&env.ua.webkit<420&&m.type==="js"&&!m.varName){successfn=null;this._useYahooListener=true;}fn(url,{data:s[i],onSuccess:successfn,onFailure:this._onFailure,onTimeout:this._onTimeout,insertBefore:this.insertBefore,charset:this.charset,timeout:this.timeout,varName:m.varName,scope:self});return;}}this._loading=null;if(this._internalCallback){var f=this._internalCallback;this._internalCallback=null;f.call(this);}else{if(this.onSuccess){this._pushEvents();this.onSuccess.call(this.scope,{data:this.data});}}},_pushEvents:function(ref){var r=ref||YAHOO;if(r.util&&r.util.Event){r.util.Event._load();}},_filter:function(str){var f=this.filter;return(f)?str.replace(new RegExp(f.searchExp,"g"),f.replaceStr):str;
+},_url:function(path){return this._filter((this.base||"")+path);}};})();YAHOO.register("yuiloader",YAHOO.util.YUILoader,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/yuitest/yuitest-min.js b/js/yui/yuitest/yuitest-min.js
new file mode 100644 (file)
index 0000000..10398b2
--- /dev/null
+++ b/js/yui/yuitest/yuitest-min.js
@@ -0,0 +1,11 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.namespace("tool");(function(){var a=0;YAHOO.tool.TestCase=function(b){this._should={};for(var c in b){this[c]=b[c];}if(!YAHOO.lang.isString(this.name)){this.name="testCase"+(a++);}};YAHOO.tool.TestCase.prototype={resume:function(b){YAHOO.tool.TestRunner.resume(b);},wait:function(d,c){var b=arguments;if(YAHOO.lang.isFunction(b[0])){throw new YAHOO.tool.TestCase.Wait(b[0],b[1]);}else{throw new YAHOO.tool.TestCase.Wait(function(){YAHOO.util.Assert.fail("Timeout: wait() called but resume() never called.");},(YAHOO.lang.isNumber(b[0])?b[0]:10000));}},setUp:function(){},tearDown:function(){}};YAHOO.tool.TestCase.Wait=function(c,b){this.segment=(YAHOO.lang.isFunction(c)?c:null);this.delay=(YAHOO.lang.isNumber(b)?b:0);};})();YAHOO.namespace("tool");YAHOO.tool.TestSuite=function(a){this.name="";this.items=[];if(YAHOO.lang.isString(a)){this.name=a;}else{if(YAHOO.lang.isObject(a)){YAHOO.lang.augmentObject(this,a,true);}}if(this.name===""){this.name=YAHOO.util.Dom.generateId(null,"testSuite");}};YAHOO.tool.TestSuite.prototype={add:function(a){if(a instanceof YAHOO.tool.TestSuite||a instanceof YAHOO.tool.TestCase){this.items.push(a);}},setUp:function(){},tearDown:function(){}};YAHOO.namespace("tool");YAHOO.tool.TestRunner=(function(){function b(c){this.testObject=c;this.firstChild=null;this.lastChild=null;this.parent=null;this.next=null;this.results={passed:0,failed:0,total:0,ignored:0,duration:0};if(c instanceof YAHOO.tool.TestSuite){this.results.type="testsuite";this.results.name=c.name;}else{if(c instanceof YAHOO.tool.TestCase){this.results.type="testcase";this.results.name=c.name;}}}b.prototype={appendChild:function(c){var d=new b(c);if(this.firstChild===null){this.firstChild=this.lastChild=d;}else{this.lastChild.next=d;this.lastChild=d;}d.parent=this;return d;}};function a(){a.superclass.constructor.apply(this,arguments);this.masterSuite=new YAHOO.tool.TestSuite("yuitests"+(new Date()).getTime());this._cur=null;this._root=null;this._running=false;this._lastResults=null;var d=[this.TEST_CASE_BEGIN_EVENT,this.TEST_CASE_COMPLETE_EVENT,this.TEST_SUITE_BEGIN_EVENT,this.TEST_SUITE_COMPLETE_EVENT,this.TEST_PASS_EVENT,this.TEST_FAIL_EVENT,this.TEST_IGNORE_EVENT,this.COMPLETE_EVENT,this.BEGIN_EVENT];for(var c=0;c<d.length;c++){this.createEvent(d[c],{scope:this});}}YAHOO.lang.extend(a,YAHOO.util.EventProvider,{TEST_CASE_BEGIN_EVENT:"testcasebegin",TEST_CASE_COMPLETE_EVENT:"testcasecomplete",TEST_SUITE_BEGIN_EVENT:"testsuitebegin",TEST_SUITE_COMPLETE_EVENT:"testsuitecomplete",TEST_PASS_EVENT:"pass",TEST_FAIL_EVENT:"fail",TEST_IGNORE_EVENT:"ignore",COMPLETE_EVENT:"complete",BEGIN_EVENT:"begin",getName:function(){return this.masterSuite.name;},setName:function(c){this.masterSuite.name=c;},isRunning:function(){return this._running;},getResults:function(c){if(!this._running&&this._lastResults){if(YAHOO.lang.isFunction(c)){return c(this._lastResults);}else{return this._lastResults;}}else{return null;}},getCoverage:function(c){if(!this._running&&typeof _yuitest_coverage=="object"){if(YAHOO.lang.isFunction(c)){return c(_yuitest_coverage);}else{return _yuitest_coverage;}}else{return null;}},getName:function(){return this.masterSuite.name;},setName:function(c){this.masterSuite.name=c;},_addTestCaseToTestTree:function(c,d){var e=c.appendChild(d);for(var f in d){if(f.indexOf("test")===0&&YAHOO.lang.isFunction(d[f])){e.appendChild(f);}}},_addTestSuiteToTestTree:function(c,f){var e=c.appendChild(f);for(var d=0;d<f.items.length;d++){if(f.items[d] instanceof YAHOO.tool.TestSuite){this._addTestSuiteToTestTree(e,f.items[d]);}else{if(f.items[d] instanceof YAHOO.tool.TestCase){this._addTestCaseToTestTree(e,f.items[d]);}}}},_buildTestTree:function(){this._root=new b(this.masterSuite);for(var c=0;c<this.masterSuite.items.length;c++){if(this.masterSuite.items[c] instanceof YAHOO.tool.TestSuite){this._addTestSuiteToTestTree(this._root,this.masterSuite.items[c]);}else{if(this.masterSuite.items[c] instanceof YAHOO.tool.TestCase){this._addTestCaseToTestTree(this._root,this.masterSuite.items[c]);}}}},_handleTestObjectComplete:function(c){if(YAHOO.lang.isObject(c.testObject)){c.parent.results.passed+=c.results.passed;c.parent.results.failed+=c.results.failed;c.parent.results.total+=c.results.total;c.parent.results.ignored+=c.results.ignored;c.parent.results[c.testObject.name]=c.results;if(c.testObject instanceof YAHOO.tool.TestSuite){c.testObject.tearDown();c.results.duration=(new Date())-c._start;this.fireEvent(this.TEST_SUITE_COMPLETE_EVENT,{testSuite:c.testObject,results:c.results});}else{if(c.testObject instanceof YAHOO.tool.TestCase){c.results.duration=(new Date())-c._start;this.fireEvent(this.TEST_CASE_COMPLETE_EVENT,{testCase:c.testObject,results:c.results});}}}},_next:function(){if(this._cur===null){this._cur=this._root;}else{if(this._cur.firstChild){this._cur=this._cur.firstChild;}else{if(this._cur.next){this._cur=this._cur.next;}else{while(this._cur&&!this._cur.next&&this._cur!==this._root){this._handleTestObjectComplete(this._cur);this._cur=this._cur.parent;}if(this._cur==this._root){this._cur.results.type="report";this._cur.results.timestamp=(new Date()).toLocaleString();this._cur.results.duration=(new Date())-this._cur._start;this._lastResults=this._cur.results;this._running=false;this.fireEvent(this.COMPLETE_EVENT,{results:this._lastResults});this._cur=null;}else{this._handleTestObjectComplete(this._cur);this._cur=this._cur.next;}}}}return this._cur;},_run:function(){var e=false;var d=this._next();if(d!==null){this._running=true;this._lastResult=null;var c=d.testObject;if(YAHOO.lang.isObject(c)){if(c instanceof YAHOO.tool.TestSuite){this.fireEvent(this.TEST_SUITE_BEGIN_EVENT,{testSuite:c});d._start=new Date();c.setUp();}else{if(c instanceof YAHOO.tool.TestCase){this.fireEvent(this.TEST_CASE_BEGIN_EVENT,{testCase:c});d._start=new Date();}}if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._run();},0);}else{this._run();}}else{this._runTest(d);}}},_resumeTest:function(h){var c=this._cur;var i=c.testObject;
+var f=c.parent.testObject;if(f.__yui_wait){clearTimeout(f.__yui_wait);delete f.__yui_wait;}var l=(f._should.fail||{})[i];var d=(f._should.error||{})[i];var g=false;var j=null;try{h.apply(f);if(l){j=new YAHOO.util.ShouldFail();g=true;}else{if(d){j=new YAHOO.util.ShouldError();g=true;}}}catch(k){if(k instanceof YAHOO.util.AssertionError){if(!l){j=k;g=true;}}else{if(k instanceof YAHOO.tool.TestCase.Wait){if(YAHOO.lang.isFunction(k.segment)){if(YAHOO.lang.isNumber(k.delay)){if(typeof setTimeout!="undefined"){f.__yui_wait=setTimeout(function(){YAHOO.tool.TestRunner._resumeTest(k.segment);},k.delay);}else{throw new Error("Asynchronous tests not supported in this environment.");}}}return;}else{if(!d){j=new YAHOO.util.UnexpectedError(k);g=true;}else{if(YAHOO.lang.isString(d)){if(k.message!=d){j=new YAHOO.util.UnexpectedError(k);g=true;}}else{if(YAHOO.lang.isFunction(d)){if(!(k instanceof d)){j=new YAHOO.util.UnexpectedError(k);g=true;}}else{if(YAHOO.lang.isObject(d)){if(!(k instanceof d.constructor)||k.message!=d.message){j=new YAHOO.util.UnexpectedError(k);g=true;}}}}}}}}if(g){this.fireEvent(this.TEST_FAIL_EVENT,{testCase:f,testName:i,error:j});}else{this.fireEvent(this.TEST_PASS_EVENT,{testCase:f,testName:i});}f.tearDown();var e=(new Date())-c._start;c.parent.results[i]={result:g?"fail":"pass",message:j?j.getMessage():"Test passed",type:"test",name:i,duration:e};if(g){c.parent.results.failed++;}else{c.parent.results.passed++;}c.parent.results.total++;if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._run();},0);}else{this._run();}},_runTest:function(f){var c=f.testObject;var d=f.parent.testObject;var g=d[c];var e=(d._should.ignore||{})[c];if(e){f.parent.results[c]={result:"ignore",message:"Test ignored",type:"test",name:c};f.parent.results.ignored++;f.parent.results.total++;this.fireEvent(this.TEST_IGNORE_EVENT,{testCase:d,testName:c});if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._run();},0);}else{this._run();}}else{f._start=new Date();d.setUp();this._resumeTest(g);}},fireEvent:function(c,d){d=d||{};d.type=c;a.superclass.fireEvent.call(this,c,d);},add:function(c){this.masterSuite.add(c);},clear:function(){this.masterSuite=new YAHOO.tool.TestSuite("yuitests"+(new Date()).getTime());},resume:function(c){this._resumeTest(c||function(){});},run:function(c){var d=YAHOO.tool.TestRunner;if(!c&&this.masterSuite.items.length==1&&this.masterSuite.items[0] instanceof YAHOO.tool.TestSuite){this.masterSuite=this.masterSuite.items[0];}d._buildTestTree();d._root._start=new Date();d.fireEvent(d.BEGIN_EVENT);d._run();}});return new a();})();YAHOO.namespace("util");YAHOO.util.Assert={_formatMessage:function(b,a){var c=b;if(YAHOO.lang.isString(b)&&b.length>0){return YAHOO.lang.substitute(b,{message:a});}else{return a;}},fail:function(a){throw new YAHOO.util.AssertionError(this._formatMessage(a,"Test force-failed."));},areEqual:function(b,c,a){if(b!=c){throw new YAHOO.util.ComparisonFailure(this._formatMessage(a,"Values should be equal."),b,c);}},areNotEqual:function(a,c,b){if(a==c){throw new YAHOO.util.UnexpectedValue(this._formatMessage(b,"Values should not be equal."),a);}},areNotSame:function(a,c,b){if(a===c){throw new YAHOO.util.UnexpectedValue(this._formatMessage(b,"Values should not be the same."),a);}},areSame:function(b,c,a){if(b!==c){throw new YAHOO.util.ComparisonFailure(this._formatMessage(a,"Values should be the same."),b,c);}},isFalse:function(b,a){if(false!==b){throw new YAHOO.util.ComparisonFailure(this._formatMessage(a,"Value should be false."),false,b);}},isTrue:function(b,a){if(true!==b){throw new YAHOO.util.ComparisonFailure(this._formatMessage(a,"Value should be true."),true,b);}},isNaN:function(b,a){if(!isNaN(b)){throw new YAHOO.util.ComparisonFailure(this._formatMessage(a,"Value should be NaN."),NaN,b);}},isNotNaN:function(b,a){if(isNaN(b)){throw new YAHOO.util.UnexpectedValue(this._formatMessage(a,"Values should not be NaN."),NaN);}},isNotNull:function(b,a){if(YAHOO.lang.isNull(b)){throw new YAHOO.util.UnexpectedValue(this._formatMessage(a,"Values should not be null."),null);}},isNotUndefined:function(b,a){if(YAHOO.lang.isUndefined(b)){throw new YAHOO.util.UnexpectedValue(this._formatMessage(a,"Value should not be undefined."),undefined);}},isNull:function(b,a){if(!YAHOO.lang.isNull(b)){throw new YAHOO.util.ComparisonFailure(this._formatMessage(a,"Value should be null."),null,b);}},isUndefined:function(b,a){if(!YAHOO.lang.isUndefined(b)){throw new YAHOO.util.ComparisonFailure(this._formatMessage(a,"Value should be undefined."),undefined,b);}},isArray:function(b,a){if(!YAHOO.lang.isArray(b)){throw new YAHOO.util.UnexpectedValue(this._formatMessage(a,"Value should be an array."),b);}},isBoolean:function(b,a){if(!YAHOO.lang.isBoolean(b)){throw new YAHOO.util.UnexpectedValue(this._formatMessage(a,"Value should be a Boolean."),b);}},isFunction:function(b,a){if(!YAHOO.lang.isFunction(b)){throw new YAHOO.util.UnexpectedValue(this._formatMessage(a,"Value should be a function."),b);}},isInstanceOf:function(b,c,a){if(!(c instanceof b)){throw new YAHOO.util.ComparisonFailure(this._formatMessage(a,"Value isn't an instance of expected type."),b,c);}},isNumber:function(b,a){if(!YAHOO.lang.isNumber(b)){throw new YAHOO.util.UnexpectedValue(this._formatMessage(a,"Value should be a number."),b);}},isObject:function(b,a){if(!YAHOO.lang.isObject(b)){throw new YAHOO.util.UnexpectedValue(this._formatMessage(a,"Value should be an object."),b);}},isString:function(b,a){if(!YAHOO.lang.isString(b)){throw new YAHOO.util.UnexpectedValue(this._formatMessage(a,"Value should be a string."),b);}},isTypeOf:function(b,c,a){if(typeof c!=b){throw new YAHOO.util.ComparisonFailure(this._formatMessage(a,"Value should be of type "+b+"."),b,typeof c);}}};YAHOO.util.AssertionError=function(a){this.message=a;this.name="AssertionError";};YAHOO.lang.extend(YAHOO.util.AssertionError,Object,{getMessage:function(){return this.message;},toString:function(){return this.name+": "+this.getMessage();
+}});YAHOO.util.ComparisonFailure=function(b,a,c){YAHOO.util.AssertionError.call(this,b);this.expected=a;this.actual=c;this.name="ComparisonFailure";};YAHOO.lang.extend(YAHOO.util.ComparisonFailure,YAHOO.util.AssertionError,{getMessage:function(){return this.message+"\nExpected: "+this.expected+" ("+(typeof this.expected)+")"+"\nActual:"+this.actual+" ("+(typeof this.actual)+")";}});YAHOO.util.UnexpectedValue=function(b,a){YAHOO.util.AssertionError.call(this,b);this.unexpected=a;this.name="UnexpectedValue";};YAHOO.lang.extend(YAHOO.util.UnexpectedValue,YAHOO.util.AssertionError,{getMessage:function(){return this.message+"\nUnexpected: "+this.unexpected+" ("+(typeof this.unexpected)+") ";}});YAHOO.util.ShouldFail=function(a){YAHOO.util.AssertionError.call(this,a||"This test should fail but didn't.");this.name="ShouldFail";};YAHOO.lang.extend(YAHOO.util.ShouldFail,YAHOO.util.AssertionError);YAHOO.util.ShouldError=function(a){YAHOO.util.AssertionError.call(this,a||"This test should have thrown an error but didn't.");this.name="ShouldError";};YAHOO.lang.extend(YAHOO.util.ShouldError,YAHOO.util.AssertionError);YAHOO.util.UnexpectedError=function(a){YAHOO.util.AssertionError.call(this,"Unexpected error: "+a.message);this.cause=a;this.name="UnexpectedError";this.stack=a.stack;};YAHOO.lang.extend(YAHOO.util.UnexpectedError,YAHOO.util.AssertionError);YAHOO.util.ArrayAssert={contains:function(e,d,b){var c=false;var f=YAHOO.util.Assert;for(var a=0;a<d.length&&!c;a++){if(d[a]===e){c=true;}}if(!c){f.fail(f._formatMessage(b,"Value "+e+" ("+(typeof e)+") not found in array ["+d+"]."));}},containsItems:function(c,d,b){for(var a=0;a<c.length;a++){this.contains(c[a],d,b);}},containsMatch:function(e,d,b){if(typeof e!="function"){throw new TypeError("ArrayAssert.containsMatch(): First argument must be a function.");}var c=false;var f=YAHOO.util.Assert;for(var a=0;a<d.length&&!c;a++){if(e(d[a])){c=true;}}if(!c){f.fail(f._formatMessage(b,"No match found in array ["+d+"]."));}},doesNotContain:function(e,d,b){var c=false;var f=YAHOO.util.Assert;for(var a=0;a<d.length&&!c;a++){if(d[a]===e){c=true;}}if(c){f.fail(f._formatMessage(b,"Value found in array ["+d+"]."));}},doesNotContainItems:function(c,d,b){for(var a=0;a<c.length;a++){this.doesNotContain(c[a],d,b);}},doesNotContainMatch:function(e,d,b){if(typeof e!="function"){throw new TypeError("ArrayAssert.doesNotContainMatch(): First argument must be a function.");}var c=false;var f=YAHOO.util.Assert;for(var a=0;a<d.length&&!c;a++){if(e(d[a])){c=true;}}if(c){f.fail(f._formatMessage(b,"Value found in array ["+d+"]."));}},indexOf:function(e,d,a,c){for(var b=0;b<d.length;b++){if(d[b]===e){YAHOO.util.Assert.areEqual(a,b,c||"Value exists at index "+b+" but should be at index "+a+".");return;}}var f=YAHOO.util.Assert;f.fail(f._formatMessage(c,"Value doesn't exist in array ["+d+"]."));},itemsAreEqual:function(d,f,c){var a=Math.max(d.length,f.length||0);var e=YAHOO.util.Assert;for(var b=0;b<a;b++){e.areEqual(d[b],f[b],e._formatMessage(c,"Values in position "+b+" are not equal."));}},itemsAreEquivalent:function(e,f,b,d){if(typeof b!="function"){throw new TypeError("ArrayAssert.itemsAreEquivalent(): Third argument must be a function.");}var a=Math.max(e.length,f.length||0);for(var c=0;c<a;c++){if(!b(e[c],f[c])){throw new YAHOO.util.ComparisonFailure(YAHOO.util.Assert._formatMessage(d,"Values in position "+c+" are not equivalent."),e[c],f[c]);}}},isEmpty:function(c,a){if(c.length>0){var b=YAHOO.util.Assert;b.fail(b._formatMessage(a,"Array should be empty."));}},isNotEmpty:function(c,a){if(c.length===0){var b=YAHOO.util.Assert;b.fail(b._formatMessage(a,"Array should not be empty."));}},itemsAreSame:function(d,f,c){var a=Math.max(d.length,f.length||0);var e=YAHOO.util.Assert;for(var b=0;b<a;b++){e.areSame(d[b],f[b],e._formatMessage(c,"Values in position "+b+" are not the same."));}},lastIndexOf:function(e,d,a,c){var f=YAHOO.util.Assert;for(var b=d.length;b>=0;b--){if(d[b]===e){f.areEqual(a,b,f._formatMessage(c,"Value exists at index "+b+" but should be at index "+a+"."));return;}}f.fail(f._formatMessage(c,"Value doesn't exist in array."));}};YAHOO.namespace("util");YAHOO.util.ObjectAssert={propertiesAreEqual:function(d,g,c){var f=YAHOO.util.Assert;var b=[];for(var e in d){b.push(e);}for(var a=0;a<b.length;a++){f.isNotUndefined(g[b[a]],f._formatMessage(c,"Property '"+b[a]+"' expected."));}},hasProperty:function(a,b,c){if(!(a in b)){var d=YAHOO.util.Assert;d.fail(d._formatMessage(c,"Property '"+a+"' not found on object."));}},hasOwnProperty:function(a,b,c){if(!YAHOO.lang.hasOwnProperty(b,a)){var d=YAHOO.util.Assert;d.fail(d._formatMessage(c,"Property '"+a+"' not found on object instance."));}}};YAHOO.util.DateAssert={datesAreEqual:function(b,d,a){if(b instanceof Date&&d instanceof Date){var c=YAHOO.util.Assert;c.areEqual(b.getFullYear(),d.getFullYear(),c._formatMessage(a,"Years should be equal."));c.areEqual(b.getMonth(),d.getMonth(),c._formatMessage(a,"Months should be equal."));c.areEqual(b.getDate(),d.getDate(),c._formatMessage(a,"Day of month should be equal."));}else{throw new TypeError("DateAssert.datesAreEqual(): Expected and actual values must be Date objects.");}},timesAreEqual:function(b,d,a){if(b instanceof Date&&d instanceof Date){var c=YAHOO.util.Assert;c.areEqual(b.getHours(),d.getHours(),c._formatMessage(a,"Hours should be equal."));c.areEqual(b.getMinutes(),d.getMinutes(),c._formatMessage(a,"Minutes should be equal."));c.areEqual(b.getSeconds(),d.getSeconds(),c._formatMessage(a,"Seconds should be equal."));}else{throw new TypeError("DateAssert.timesAreEqual(): Expected and actual values must be Date objects.");}}};YAHOO.namespace("tool");YAHOO.tool.TestManager={TEST_PAGE_BEGIN_EVENT:"testpagebegin",TEST_PAGE_COMPLETE_EVENT:"testpagecomplete",TEST_MANAGER_BEGIN_EVENT:"testmanagerbegin",TEST_MANAGER_COMPLETE_EVENT:"testmanagercomplete",_curPage:null,_frame:null,_logger:null,_timeoutId:0,_pages:[],_results:null,_handleTestRunnerComplete:function(a){this.fireEvent(this.TEST_PAGE_COMPLETE_EVENT,{page:this._curPage,results:a.results});
+this._processResults(this._curPage,a.results);this._logger.clearTestRunner();if(this._pages.length){this._timeoutId=setTimeout(function(){YAHOO.tool.TestManager._run();},1000);}else{this.fireEvent(this.TEST_MANAGER_COMPLETE_EVENT,this._results);}},_processResults:function(c,a){var b=this._results;b.passed+=a.passed;b.failed+=a.failed;b.ignored+=a.ignored;b.total+=a.total;b.duration+=a.duration;if(a.failed){b.failedPages.push(c);}else{b.passedPages.push(c);}a.name=c;a.type="page";b[c]=a;},_run:function(){this._curPage=this._pages.shift();this.fireEvent(this.TEST_PAGE_BEGIN_EVENT,this._curPage);this._frame.location.replace(this._curPage);},load:function(){if(parent.YAHOO.tool.TestManager!==this){parent.YAHOO.tool.TestManager.load();}else{if(this._frame){var a=this._frame.YAHOO.tool.TestRunner;this._logger.setTestRunner(a);a.subscribe(a.COMPLETE_EVENT,this._handleTestRunnerComplete,this,true);a.run();}}},setPages:function(a){this._pages=a;},start:function(){if(!this._initialized){this.createEvent(this.TEST_PAGE_BEGIN_EVENT);this.createEvent(this.TEST_PAGE_COMPLETE_EVENT);this.createEvent(this.TEST_MANAGER_BEGIN_EVENT);this.createEvent(this.TEST_MANAGER_COMPLETE_EVENT);if(!this._frame){var a=document.createElement("iframe");a.style.visibility="hidden";a.style.position="absolute";document.body.appendChild(a);this._frame=a.contentWindow||a.contentDocument.parentWindow;}if(!this._logger){this._logger=new YAHOO.tool.TestLogger();}this._initialized=true;}this._results={passed:0,failed:0,ignored:0,total:0,type:"report",name:"YUI Test Results",duration:0,failedPages:[],passedPages:[]};this.fireEvent(this.TEST_MANAGER_BEGIN_EVENT,null);this._run();},stop:function(){clearTimeout(this._timeoutId);}};YAHOO.lang.augmentObject(YAHOO.tool.TestManager,YAHOO.util.EventProvider.prototype);YAHOO.namespace("tool");YAHOO.tool.TestLogger=function(b,a){YAHOO.tool.TestLogger.superclass.constructor.call(this,b,a);this.init();};YAHOO.lang.extend(YAHOO.tool.TestLogger,YAHOO.widget.LogReader,{footerEnabled:true,newestOnTop:false,formatMsg:function(b){var a=b.category;var c=this.html2Text(b.msg);return'<pre><p><span class="'+a+'">'+a.toUpperCase()+"</span> "+c+"</p></pre>";},init:function(){if(YAHOO.tool.TestRunner){this.setTestRunner(YAHOO.tool.TestRunner);}this.hideSource("global");this.hideSource("LogReader");this.hideCategory("warn");this.hideCategory("window");this.hideCategory("time");this.clearConsole();},clearTestRunner:function(){if(this._runner){this._runner.unsubscribeAll();this._runner=null;}},setTestRunner:function(a){if(this._runner){this.clearTestRunner();}this._runner=a;a.subscribe(a.TEST_PASS_EVENT,this._handleTestRunnerEvent,this,true);a.subscribe(a.TEST_FAIL_EVENT,this._handleTestRunnerEvent,this,true);a.subscribe(a.TEST_IGNORE_EVENT,this._handleTestRunnerEvent,this,true);a.subscribe(a.BEGIN_EVENT,this._handleTestRunnerEvent,this,true);a.subscribe(a.COMPLETE_EVENT,this._handleTestRunnerEvent,this,true);a.subscribe(a.TEST_SUITE_BEGIN_EVENT,this._handleTestRunnerEvent,this,true);a.subscribe(a.TEST_SUITE_COMPLETE_EVENT,this._handleTestRunnerEvent,this,true);a.subscribe(a.TEST_CASE_BEGIN_EVENT,this._handleTestRunnerEvent,this,true);a.subscribe(a.TEST_CASE_COMPLETE_EVENT,this._handleTestRunnerEvent,this,true);},_handleTestRunnerEvent:function(d){var a=YAHOO.tool.TestRunner;var c="";var b="";switch(d.type){case a.BEGIN_EVENT:c="Testing began at "+(new Date()).toString()+".";b="info";break;case a.COMPLETE_EVENT:c="Testing completed at "+(new Date()).toString()+".\nPassed:"+d.results.passed+" Failed:"+d.results.failed+" Total:"+d.results.total;b="info";break;case a.TEST_FAIL_EVENT:c=d.testName+": "+d.error.getMessage();b="fail";break;case a.TEST_IGNORE_EVENT:c=d.testName+": ignored.";b="ignore";break;case a.TEST_PASS_EVENT:c=d.testName+": passed.";b="pass";break;case a.TEST_SUITE_BEGIN_EVENT:c='Test suite "'+d.testSuite.name+'" started.';b="info";break;case a.TEST_SUITE_COMPLETE_EVENT:c='Test suite "'+d.testSuite.name+'" completed.\nPassed:'+d.results.passed+" Failed:"+d.results.failed+" Total:"+d.results.total;b="info";break;case a.TEST_CASE_BEGIN_EVENT:c='Test case "'+d.testCase.name+'" started.';b="info";break;case a.TEST_CASE_COMPLETE_EVENT:c='Test case "'+d.testCase.name+'" completed.\nPassed:'+d.results.passed+" Failed:"+d.results.failed+" Total:"+d.results.total;b="info";break;default:c="Unexpected event "+d.type;c="info";}YAHOO.log(c,b,"TestRunner");}});YAHOO.namespace("tool.TestFormat");(function(){YAHOO.tool.TestFormat.JSON=function(b){return YAHOO.lang.JSON.stringify(b);};function a(b){return b.replace(/["'<>&]/g,function(d){switch(d){case"<":return"&lt;";case">":return"&gt;";case'"':return"&quot;";case"'":return"&apos;";case"&":return"&amp;";}});}YAHOO.tool.TestFormat.XML=function(c){function b(f){var d=YAHOO.lang,e="<"+f.type+' name="'+a(f.name)+'"';if(d.isNumber(f.duration)){e+=' duration="'+f.duration+'"';}if(f.type=="test"){e+=' result="'+f.result+'" message="'+a(f.message)+'">';}else{e+=' passed="'+f.passed+'" failed="'+f.failed+'" ignored="'+f.ignored+'" total="'+f.total+'">';for(var g in f){if(d.hasOwnProperty(f,g)&&d.isObject(f[g])&&!d.isArray(f[g])){e+=b(f[g]);}}}e+="</"+f.type+">";return e;}return'<?xml version="1.0" encoding="UTF-8"?>'+b(c);};YAHOO.tool.TestFormat.JUnitXML=function(b){function c(f){var d=YAHOO.lang,e="",g;switch(f.type){case"test":if(f.result!="ignore"){e='<testcase name="'+a(f.name)+'">';if(f.result=="fail"){e+='<failure message="'+a(f.message)+'"><![CDATA['+f.message+"]]></failure>";}e+="</testcase>";}break;case"testcase":e='<testsuite name="'+a(f.name)+'" tests="'+f.total+'" failures="'+f.failed+'">';for(g in f){if(d.hasOwnProperty(f,g)&&d.isObject(f[g])&&!d.isArray(f[g])){e+=c(f[g]);}}e+="</testsuite>";break;case"testsuite":for(g in f){if(d.hasOwnProperty(f,g)&&d.isObject(f[g])&&!d.isArray(f[g])){e+=c(f[g]);}}break;case"report":e="<testsuites>";for(g in f){if(d.hasOwnProperty(f,g)&&d.isObject(f[g])&&!d.isArray(f[g])){e+=c(f[g]);}}e+="</testsuites>";}return e;}return'<?xml version="1.0" encoding="UTF-8"?>'+c(b);
+};YAHOO.tool.TestFormat.TAP=function(c){var d=1;function b(f){var e=YAHOO.lang,g="";switch(f.type){case"test":if(f.result!="ignore"){g="ok "+(d++)+" - "+f.name;if(f.result=="fail"){g="not "+g+" - "+f.message;}g+="\n";}else{g="#Ignored test "+f.name+"\n";}break;case"testcase":g="#Begin testcase "+f.name+"("+f.failed+" failed of "+f.total+")\n";for(prop in f){if(e.hasOwnProperty(f,prop)&&e.isObject(f[prop])&&!e.isArray(f[prop])){g+=b(f[prop]);}}g+="#End testcase "+f.name+"\n";break;case"testsuite":g="#Begin testsuite "+f.name+"("+f.failed+" failed of "+f.total+")\n";for(prop in f){if(e.hasOwnProperty(f,prop)&&e.isObject(f[prop])&&!e.isArray(f[prop])){g+=b(f[prop]);}}g+="#End testsuite "+f.name+"\n";break;case"report":for(prop in f){if(e.hasOwnProperty(f,prop)&&e.isObject(f[prop])&&!e.isArray(f[prop])){g+=b(f[prop]);}}}return g;}return"1.."+c.total+"\n"+b(c);};})();YAHOO.namespace("tool.CoverageFormat");YAHOO.tool.CoverageFormat.JSON=function(a){return YAHOO.lang.JSON.stringify(a);};YAHOO.tool.CoverageFormat.XdebugJSON=function(b){var a={},c;for(c in b){if(b.hasOwnProperty(c)){a[c]=b[c].lines;}}return YAHOO.lang.JSON.stringify(a);};YAHOO.namespace("tool");YAHOO.tool.TestReporter=function(a,b){this.url=a;this.format=b||YAHOO.tool.TestFormat.XML;this._fields=new Object();this._form=null;this._iframe=null;};YAHOO.tool.TestReporter.prototype={constructor:YAHOO.tool.TestReporter,_convertToISOString:function(a){function b(c){return c<10?"0"+c:c;}return a.getUTCFullYear()+"-"+b(a.getUTCMonth()+1)+"-"+b(a.getUTCDate())+"T"+b(a.getUTCHours())+":"+b(a.getUTCMinutes())+":"+b(a.getUTCSeconds())+"Z";},addField:function(a,b){this._fields[a]=b;},clearFields:function(){this._fields=new Object();},destroy:function(){if(this._form){this._form.parentNode.removeChild(this._form);this._form=null;}if(this._iframe){this._iframe.parentNode.removeChild(this._iframe);this._iframe=null;}this._fields=null;},report:function(a){if(!this._form){this._form=document.createElement("form");this._form.method="post";this._form.style.visibility="hidden";this._form.style.position="absolute";this._form.style.top=0;document.body.appendChild(this._form);if(YAHOO.env.ua.ie){this._iframe=document.createElement('<iframe name="yuiTestTarget" />');}else{this._iframe=document.createElement("iframe");this._iframe.name="yuiTestTarget";}this._iframe.src="javascript:false";this._iframe.style.visibility="hidden";this._iframe.style.position="absolute";this._iframe.style.top=0;document.body.appendChild(this._iframe);this._form.target="yuiTestTarget";}this._form.action=this.url;while(this._form.hasChildNodes()){this._form.removeChild(this._form.lastChild);}this._fields.results=this.format(a);this._fields.useragent=navigator.userAgent;this._fields.timestamp=this._convertToISOString(new Date());for(var b in this._fields){if(YAHOO.lang.hasOwnProperty(this._fields,b)&&typeof this._fields[b]!="function"){if(YAHOO.env.ua.ie){input=document.createElement('<input name="'+b+'" >');}else{input=document.createElement("input");input.name=b;}input.type="hidden";input.value=this._fields[b];this._form.appendChild(input);}}delete this._fields.results;delete this._fields.useragent;delete this._fields.timestamp;if(arguments[1]!==false){this._form.submit();}}};YUITest={TestRunner:YAHOO.tool.TestRunner,ResultsFormat:YAHOO.tool.TestFormat,CoverageFormat:YAHOO.tool.CoverageFormat};YAHOO.register("yuitest",YAHOO.tool.TestRunner,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/js/yui/yuitest/yuitest_core-min.js b/js/yui/yuitest/yuitest_core-min.js
new file mode 100644 (file)
index 0000000..3ddd3ce
--- /dev/null
+++ b/js/yui/yuitest/yuitest_core-min.js
@@ -0,0 +1,9 @@
+/*
+Copyright (c) 2011, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.com/yui/license.html
+version: 2.9.0
+*/
+YAHOO.namespace("tool");(function(){var a=0;YAHOO.tool.TestCase=function(b){this._should={};for(var c in b){this[c]=b[c];}if(!YAHOO.lang.isString(this.name)){this.name="testCase"+(a++);}};YAHOO.tool.TestCase.prototype={resume:function(b){YAHOO.tool.TestRunner.resume(b);},wait:function(d,c){var b=arguments;if(YAHOO.lang.isFunction(b[0])){throw new YAHOO.tool.TestCase.Wait(b[0],b[1]);}else{throw new YAHOO.tool.TestCase.Wait(function(){YAHOO.util.Assert.fail("Timeout: wait() called but resume() never called.");},(YAHOO.lang.isNumber(b[0])?b[0]:10000));}},setUp:function(){},tearDown:function(){}};YAHOO.tool.TestCase.Wait=function(c,b){this.segment=(YAHOO.lang.isFunction(c)?c:null);this.delay=(YAHOO.lang.isNumber(b)?b:0);};})();YAHOO.namespace("tool");YAHOO.tool.TestSuite=function(a){this.name="";this.items=[];if(YAHOO.lang.isString(a)){this.name=a;}else{if(YAHOO.lang.isObject(a)){YAHOO.lang.augmentObject(this,a,true);}}if(this.name===""){this.name=YAHOO.util.Dom.generateId(null,"testSuite");}};YAHOO.tool.TestSuite.prototype={add:function(a){if(a instanceof YAHOO.tool.TestSuite||a instanceof YAHOO.tool.TestCase){this.items.push(a);}},setUp:function(){},tearDown:function(){}};YAHOO.namespace("tool");YAHOO.tool.TestRunner=(function(){function b(c){this.testObject=c;this.firstChild=null;this.lastChild=null;this.parent=null;this.next=null;this.results={passed:0,failed:0,total:0,ignored:0,duration:0};if(c instanceof YAHOO.tool.TestSuite){this.results.type="testsuite";this.results.name=c.name;}else{if(c instanceof YAHOO.tool.TestCase){this.results.type="testcase";this.results.name=c.name;}}}b.prototype={appendChild:function(c){var d=new b(c);if(this.firstChild===null){this.firstChild=this.lastChild=d;}else{this.lastChild.next=d;this.lastChild=d;}d.parent=this;return d;}};function a(){a.superclass.constructor.apply(this,arguments);this.masterSuite=new YAHOO.tool.TestSuite("yuitests"+(new Date()).getTime());this._cur=null;this._root=null;this._running=false;this._lastResults=null;var d=[this.TEST_CASE_BEGIN_EVENT,this.TEST_CASE_COMPLETE_EVENT,this.TEST_SUITE_BEGIN_EVENT,this.TEST_SUITE_COMPLETE_EVENT,this.TEST_PASS_EVENT,this.TEST_FAIL_EVENT,this.TEST_IGNORE_EVENT,this.COMPLETE_EVENT,this.BEGIN_EVENT];for(var c=0;c<d.length;c++){this.createEvent(d[c],{scope:this});}}YAHOO.lang.extend(a,YAHOO.util.EventProvider,{TEST_CASE_BEGIN_EVENT:"testcasebegin",TEST_CASE_COMPLETE_EVENT:"testcasecomplete",TEST_SUITE_BEGIN_EVENT:"testsuitebegin",TEST_SUITE_COMPLETE_EVENT:"testsuitecomplete",TEST_PASS_EVENT:"pass",TEST_FAIL_EVENT:"fail",TEST_IGNORE_EVENT:"ignore",COMPLETE_EVENT:"complete",BEGIN_EVENT:"begin",getName:function(){return this.masterSuite.name;},setName:function(c){this.masterSuite.name=c;},isRunning:function(){return this._running;},getResults:function(c){if(!this._running&&this._lastResults){if(YAHOO.lang.isFunction(c)){return c(this._lastResults);}else{return this._lastResults;}}else{return null;}},getCoverage:function(c){if(!this._running&&typeof _yuitest_coverage=="object"){if(YAHOO.lang.isFunction(c)){return c(_yuitest_coverage);}else{return _yuitest_coverage;}}else{return null;}},getName:function(){return this.masterSuite.name;},setName:function(c){this.masterSuite.name=c;},_addTestCaseToTestTree:function(c,d){var e=c.appendChild(d);for(var f in d){if(f.indexOf("test")===0&&YAHOO.lang.isFunction(d[f])){e.appendChild(f);}}},_addTestSuiteToTestTree:function(c,f){var e=c.appendChild(f);for(var d=0;d<f.items.length;d++){if(f.items[d] instanceof YAHOO.tool.TestSuite){this._addTestSuiteToTestTree(e,f.items[d]);}else{if(f.items[d] instanceof YAHOO.tool.TestCase){this._addTestCaseToTestTree(e,f.items[d]);}}}},_buildTestTree:function(){this._root=new b(this.masterSuite);for(var c=0;c<this.masterSuite.items.length;c++){if(this.masterSuite.items[c] instanceof YAHOO.tool.TestSuite){this._addTestSuiteToTestTree(this._root,this.masterSuite.items[c]);}else{if(this.masterSuite.items[c] instanceof YAHOO.tool.TestCase){this._addTestCaseToTestTree(this._root,this.masterSuite.items[c]);}}}},_handleTestObjectComplete:function(c){if(YAHOO.lang.isObject(c.testObject)){c.parent.results.passed+=c.results.passed;c.parent.results.failed+=c.results.failed;c.parent.results.total+=c.results.total;c.parent.results.ignored+=c.results.ignored;c.parent.results[c.testObject.name]=c.results;if(c.testObject instanceof YAHOO.tool.TestSuite){c.testObject.tearDown();c.results.duration=(new Date())-c._start;this.fireEvent(this.TEST_SUITE_COMPLETE_EVENT,{testSuite:c.testObject,results:c.results});}else{if(c.testObject instanceof YAHOO.tool.TestCase){c.results.duration=(new Date())-c._start;this.fireEvent(this.TEST_CASE_COMPLETE_EVENT,{testCase:c.testObject,results:c.results});}}}},_next:function(){if(this._cur===null){this._cur=this._root;}else{if(this._cur.firstChild){this._cur=this._cur.firstChild;}else{if(this._cur.next){this._cur=this._cur.next;}else{while(this._cur&&!this._cur.next&&this._cur!==this._root){this._handleTestObjectComplete(this._cur);this._cur=this._cur.parent;}if(this._cur==this._root){this._cur.results.type="report";this._cur.results.timestamp=(new Date()).toLocaleString();this._cur.results.duration=(new Date())-this._cur._start;this._lastResults=this._cur.results;this._running=false;this.fireEvent(this.COMPLETE_EVENT,{results:this._lastResults});this._cur=null;}else{this._handleTestObjectComplete(this._cur);this._cur=this._cur.next;}}}}return this._cur;},_run:function(){var e=false;var d=this._next();if(d!==null){this._running=true;this._lastResult=null;var c=d.testObject;if(YAHOO.lang.isObject(c)){if(c instanceof YAHOO.tool.TestSuite){this.fireEvent(this.TEST_SUITE_BEGIN_EVENT,{testSuite:c});d._start=new Date();c.setUp();}else{if(c instanceof YAHOO.tool.TestCase){this.fireEvent(this.TEST_CASE_BEGIN_EVENT,{testCase:c});d._start=new Date();}}if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._run();},0);}else{this._run();}}else{this._runTest(d);}}},_resumeTest:function(h){var c=this._cur;var i=c.testObject;
+var f=c.parent.testObject;if(f.__yui_wait){clearTimeout(f.__yui_wait);delete f.__yui_wait;}var l=(f._should.fail||{})[i];var d=(f._should.error||{})[i];var g=false;var j=null;try{h.apply(f);if(l){j=new YAHOO.util.ShouldFail();g=true;}else{if(d){j=new YAHOO.util.ShouldError();g=true;}}}catch(k){if(k instanceof YAHOO.util.AssertionError){if(!l){j=k;g=true;}}else{if(k instanceof YAHOO.tool.TestCase.Wait){if(YAHOO.lang.isFunction(k.segment)){if(YAHOO.lang.isNumber(k.delay)){if(typeof setTimeout!="undefined"){f.__yui_wait=setTimeout(function(){YAHOO.tool.TestRunner._resumeTest(k.segment);},k.delay);}else{throw new Error("Asynchronous tests not supported in this environment.");}}}return;}else{if(!d){j=new YAHOO.util.UnexpectedError(k);g=true;}else{if(YAHOO.lang.isString(d)){if(k.message!=d){j=new YAHOO.util.UnexpectedError(k);g=true;}}else{if(YAHOO.lang.isFunction(d)){if(!(k instanceof d)){j=new YAHOO.util.UnexpectedError(k);g=true;}}else{if(YAHOO.lang.isObject(d)){if(!(k instanceof d.constructor)||k.message!=d.message){j=new YAHOO.util.UnexpectedError(k);g=true;}}}}}}}}if(g){this.fireEvent(this.TEST_FAIL_EVENT,{testCase:f,testName:i,error:j});}else{this.fireEvent(this.TEST_PASS_EVENT,{testCase:f,testName:i});}f.tearDown();var e=(new Date())-c._start;c.parent.results[i]={result:g?"fail":"pass",message:j?j.getMessage():"Test passed",type:"test",name:i,duration:e};if(g){c.parent.results.failed++;}else{c.parent.results.passed++;}c.parent.results.total++;if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._run();},0);}else{this._run();}},_runTest:function(f){var c=f.testObject;var d=f.parent.testObject;var g=d[c];var e=(d._should.ignore||{})[c];if(e){f.parent.results[c]={result:"ignore",message:"Test ignored",type:"test",name:c};f.parent.results.ignored++;f.parent.results.total++;this.fireEvent(this.TEST_IGNORE_EVENT,{testCase:d,testName:c});if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._run();},0);}else{this._run();}}else{f._start=new Date();d.setUp();this._resumeTest(g);}},fireEvent:function(c,d){d=d||{};d.type=c;a.superclass.fireEvent.call(this,c,d);},add:function(c){this.masterSuite.add(c);},clear:function(){this.masterSuite=new YAHOO.tool.TestSuite("yuitests"+(new Date()).getTime());},resume:function(c){this._resumeTest(c||function(){});},run:function(c){var d=YAHOO.tool.TestRunner;if(!c&&this.masterSuite.items.length==1&&this.masterSuite.items[0] instanceof YAHOO.tool.TestSuite){this.masterSuite=this.masterSuite.items[0];}d._buildTestTree();d._root._start=new Date();d.fireEvent(d.BEGIN_EVENT);d._run();}});return new a();})();YAHOO.namespace("util");YAHOO.util.Assert={_formatMessage:function(b,a){var c=b;if(YAHOO.lang.isString(b)&&b.length>0){return YAHOO.lang.substitute(b,{message:a});}else{return a;}},fail:function(a){throw new YAHOO.util.AssertionError(this._formatMessage(a,"Test force-failed."));},areEqual:function(b,c,a){if(b!=c){throw new YAHOO.util.ComparisonFailure(this._formatMessage(a,"Values should be equal."),b,c);}},areNotEqual:function(a,c,b){if(a==c){throw new YAHOO.util.UnexpectedValue(this._formatMessage(b,"Values should not be equal."),a);}},areNotSame:function(a,c,b){if(a===c){throw new YAHOO.util.UnexpectedValue(this._formatMessage(b,"Values should not be the same."),a);}},areSame:function(b,c,a){if(b!==c){throw new YAHOO.util.ComparisonFailure(this._formatMessage(a,"Values should be the same."),b,c);}},isFalse:function(b,a){if(false!==b){throw new YAHOO.util.ComparisonFailure(this._formatMessage(a,"Value should be false."),false,b);}},isTrue:function(b,a){if(true!==b){throw new YAHOO.util.ComparisonFailure(this._formatMessage(a,"Value should be true."),true,b);}},isNaN:function(b,a){if(!isNaN(b)){throw new YAHOO.util.ComparisonFailure(this._formatMessage(a,"Value should be NaN."),NaN,b);}},isNotNaN:function(b,a){if(isNaN(b)){throw new YAHOO.util.UnexpectedValue(this._formatMessage(a,"Values should not be NaN."),NaN);}},isNotNull:function(b,a){if(YAHOO.lang.isNull(b)){throw new YAHOO.util.UnexpectedValue(this._formatMessage(a,"Values should not be null."),null);}},isNotUndefined:function(b,a){if(YAHOO.lang.isUndefined(b)){throw new YAHOO.util.UnexpectedValue(this._formatMessage(a,"Value should not be undefined."),undefined);}},isNull:function(b,a){if(!YAHOO.lang.isNull(b)){throw new YAHOO.util.ComparisonFailure(this._formatMessage(a,"Value should be null."),null,b);}},isUndefined:function(b,a){if(!YAHOO.lang.isUndefined(b)){throw new YAHOO.util.ComparisonFailure(this._formatMessage(a,"Value should be undefined."),undefined,b);}},isArray:function(b,a){if(!YAHOO.lang.isArray(b)){throw new YAHOO.util.UnexpectedValue(this._formatMessage(a,"Value should be an array."),b);}},isBoolean:function(b,a){if(!YAHOO.lang.isBoolean(b)){throw new YAHOO.util.UnexpectedValue(this._formatMessage(a,"Value should be a Boolean."),b);}},isFunction:function(b,a){if(!YAHOO.lang.isFunction(b)){throw new YAHOO.util.UnexpectedValue(this._formatMessage(a,"Value should be a function."),b);}},isInstanceOf:function(b,c,a){if(!(c instanceof b)){throw new YAHOO.util.ComparisonFailure(this._formatMessage(a,"Value isn't an instance of expected type."),b,c);}},isNumber:function(b,a){if(!YAHOO.lang.isNumber(b)){throw new YAHOO.util.UnexpectedValue(this._formatMessage(a,"Value should be a number."),b);}},isObject:function(b,a){if(!YAHOO.lang.isObject(b)){throw new YAHOO.util.UnexpectedValue(this._formatMessage(a,"Value should be an object."),b);}},isString:function(b,a){if(!YAHOO.lang.isString(b)){throw new YAHOO.util.UnexpectedValue(this._formatMessage(a,"Value should be a string."),b);}},isTypeOf:function(b,c,a){if(typeof c!=b){throw new YAHOO.util.ComparisonFailure(this._formatMessage(a,"Value should be of type "+b+"."),b,typeof c);}}};YAHOO.util.AssertionError=function(a){this.message=a;this.name="AssertionError";};YAHOO.lang.extend(YAHOO.util.AssertionError,Object,{getMessage:function(){return this.message;},toString:function(){return this.name+": "+this.getMessage();
+}});YAHOO.util.ComparisonFailure=function(b,a,c){YAHOO.util.AssertionError.call(this,b);this.expected=a;this.actual=c;this.name="ComparisonFailure";};YAHOO.lang.extend(YAHOO.util.ComparisonFailure,YAHOO.util.AssertionError,{getMessage:function(){return this.message+"\nExpected: "+this.expected+" ("+(typeof this.expected)+")"+"\nActual:"+this.actual+" ("+(typeof this.actual)+")";}});YAHOO.util.UnexpectedValue=function(b,a){YAHOO.util.AssertionError.call(this,b);this.unexpected=a;this.name="UnexpectedValue";};YAHOO.lang.extend(YAHOO.util.UnexpectedValue,YAHOO.util.AssertionError,{getMessage:function(){return this.message+"\nUnexpected: "+this.unexpected+" ("+(typeof this.unexpected)+") ";}});YAHOO.util.ShouldFail=function(a){YAHOO.util.AssertionError.call(this,a||"This test should fail but didn't.");this.name="ShouldFail";};YAHOO.lang.extend(YAHOO.util.ShouldFail,YAHOO.util.AssertionError);YAHOO.util.ShouldError=function(a){YAHOO.util.AssertionError.call(this,a||"This test should have thrown an error but didn't.");this.name="ShouldError";};YAHOO.lang.extend(YAHOO.util.ShouldError,YAHOO.util.AssertionError);YAHOO.util.UnexpectedError=function(a){YAHOO.util.AssertionError.call(this,"Unexpected error: "+a.message);this.cause=a;this.name="UnexpectedError";this.stack=a.stack;};YAHOO.lang.extend(YAHOO.util.UnexpectedError,YAHOO.util.AssertionError);YAHOO.util.ArrayAssert={contains:function(e,d,b){var c=false;var f=YAHOO.util.Assert;for(var a=0;a<d.length&&!c;a++){if(d[a]===e){c=true;}}if(!c){f.fail(f._formatMessage(b,"Value "+e+" ("+(typeof e)+") not found in array ["+d+"]."));}},containsItems:function(c,d,b){for(var a=0;a<c.length;a++){this.contains(c[a],d,b);}},containsMatch:function(e,d,b){if(typeof e!="function"){throw new TypeError("ArrayAssert.containsMatch(): First argument must be a function.");}var c=false;var f=YAHOO.util.Assert;for(var a=0;a<d.length&&!c;a++){if(e(d[a])){c=true;}}if(!c){f.fail(f._formatMessage(b,"No match found in array ["+d+"]."));}},doesNotContain:function(e,d,b){var c=false;var f=YAHOO.util.Assert;for(var a=0;a<d.length&&!c;a++){if(d[a]===e){c=true;}}if(c){f.fail(f._formatMessage(b,"Value found in array ["+d+"]."));}},doesNotContainItems:function(c,d,b){for(var a=0;a<c.length;a++){this.doesNotContain(c[a],d,b);}},doesNotContainMatch:function(e,d,b){if(typeof e!="function"){throw new TypeError("ArrayAssert.doesNotContainMatch(): First argument must be a function.");}var c=false;var f=YAHOO.util.Assert;for(var a=0;a<d.length&&!c;a++){if(e(d[a])){c=true;}}if(c){f.fail(f._formatMessage(b,"Value found in array ["+d+"]."));}},indexOf:function(e,d,a,c){for(var b=0;b<d.length;b++){if(d[b]===e){YAHOO.util.Assert.areEqual(a,b,c||"Value exists at index "+b+" but should be at index "+a+".");return;}}var f=YAHOO.util.Assert;f.fail(f._formatMessage(c,"Value doesn't exist in array ["+d+"]."));},itemsAreEqual:function(d,f,c){var a=Math.max(d.length,f.length||0);var e=YAHOO.util.Assert;for(var b=0;b<a;b++){e.areEqual(d[b],f[b],e._formatMessage(c,"Values in position "+b+" are not equal."));}},itemsAreEquivalent:function(e,f,b,d){if(typeof b!="function"){throw new TypeError("ArrayAssert.itemsAreEquivalent(): Third argument must be a function.");}var a=Math.max(e.length,f.length||0);for(var c=0;c<a;c++){if(!b(e[c],f[c])){throw new YAHOO.util.ComparisonFailure(YAHOO.util.Assert._formatMessage(d,"Values in position "+c+" are not equivalent."),e[c],f[c]);}}},isEmpty:function(c,a){if(c.length>0){var b=YAHOO.util.Assert;b.fail(b._formatMessage(a,"Array should be empty."));}},isNotEmpty:function(c,a){if(c.length===0){var b=YAHOO.util.Assert;b.fail(b._formatMessage(a,"Array should not be empty."));}},itemsAreSame:function(d,f,c){var a=Math.max(d.length,f.length||0);var e=YAHOO.util.Assert;for(var b=0;b<a;b++){e.areSame(d[b],f[b],e._formatMessage(c,"Values in position "+b+" are not the same."));}},lastIndexOf:function(e,d,a,c){var f=YAHOO.util.Assert;for(var b=d.length;b>=0;b--){if(d[b]===e){f.areEqual(a,b,f._formatMessage(c,"Value exists at index "+b+" but should be at index "+a+"."));return;}}f.fail(f._formatMessage(c,"Value doesn't exist in array."));}};YAHOO.namespace("util");YAHOO.util.ObjectAssert={propertiesAreEqual:function(d,g,c){var f=YAHOO.util.Assert;var b=[];for(var e in d){b.push(e);}for(var a=0;a<b.length;a++){f.isNotUndefined(g[b[a]],f._formatMessage(c,"Property '"+b[a]+"' expected."));}},hasProperty:function(a,b,c){if(!(a in b)){var d=YAHOO.util.Assert;d.fail(d._formatMessage(c,"Property '"+a+"' not found on object."));}},hasOwnProperty:function(a,b,c){if(!YAHOO.lang.hasOwnProperty(b,a)){var d=YAHOO.util.Assert;d.fail(d._formatMessage(c,"Property '"+a+"' not found on object instance."));}}};YAHOO.util.DateAssert={datesAreEqual:function(b,d,a){if(b instanceof Date&&d instanceof Date){var c=YAHOO.util.Assert;c.areEqual(b.getFullYear(),d.getFullYear(),c._formatMessage(a,"Years should be equal."));c.areEqual(b.getMonth(),d.getMonth(),c._formatMessage(a,"Months should be equal."));c.areEqual(b.getDate(),d.getDate(),c._formatMessage(a,"Day of month should be equal."));}else{throw new TypeError("DateAssert.datesAreEqual(): Expected and actual values must be Date objects.");}},timesAreEqual:function(b,d,a){if(b instanceof Date&&d instanceof Date){var c=YAHOO.util.Assert;c.areEqual(b.getHours(),d.getHours(),c._formatMessage(a,"Hours should be equal."));c.areEqual(b.getMinutes(),d.getMinutes(),c._formatMessage(a,"Minutes should be equal."));c.areEqual(b.getSeconds(),d.getSeconds(),c._formatMessage(a,"Seconds should be equal."));}else{throw new TypeError("DateAssert.timesAreEqual(): Expected and actual values must be Date objects.");}}};YAHOO.register("yuitest_core",YAHOO.tool.TestRunner,{version:"2.9.0",build:"2800"});
\ No newline at end of file

diff --git a/jsonrpc.cgi b/jsonrpc.cgi
new file mode 100755 (executable)
index 0000000..acafaa1
--- /dev/null
+++ b/jsonrpc.cgi
@@ -0,0 +1,27 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::WebService::Constants;
+BEGIN {
+    if (!Bugzilla->feature('jsonrpc')) {
+        ThrowUserError('feature_disabled', { feature => 'jsonrpc' });
+    }
+}
+use Bugzilla::WebService::Server::JSONRPC;
+
+Bugzilla->usage_mode(USAGE_MODE_JSON);
+
+local @INC = (bz_locations()->{extensionsdir}, @INC);
+my $server = new Bugzilla::WebService::Server::JSONRPC;
+$server->dispatch(WS_DISPATCH)->handle();

diff --git a/lib/CGI.pm b/lib/CGI.pm
new file mode 100644 (file)
index 0000000..df63490
--- /dev/null
+++ b/lib/CGI.pm
@@ -0,0 +1,8117 @@
+package CGI;
+require 5.008001;
+use Carp 'croak';
+
+# See the bottom of this file for the POD documentation.  Search for the
+# string '=head'.
+
+# You can run this file through either pod2man or pod2html to produce pretty
+# documentation in manual or html file format (these utilities are part of the
+# Perl 5 distribution).
+
+# Copyright 1995-1998 Lincoln D. Stein.  All rights reserved.
+# It may be used and modified freely, but I do request that this copyright
+# notice remain attached to the file.  You may modify this module as you 
+# wish, but if you redistribute a modified version, please attach a note
+# listing the modifications you have made.
+
+# The most recent version and complete docs are available at:
+#   http://search.cpan.org/dist/CGI.pm
+
+# The revision is no longer being updated since moving to git. 
+$CGI::revision = '$Id: CGI.pm,v 1.266 2009/07/30 16:32:34 lstein Exp $';
+$CGI::VERSION='3.63';
+
+# HARD-CODED LOCATION FOR FILE UPLOAD TEMPORARY FILES.
+# UNCOMMENT THIS ONLY IF YOU KNOW WHAT YOU'RE DOING.
+# $CGITempFile::TMPDIRECTORY = '/usr/tmp';
+use CGI::Util qw(rearrange rearrange_header make_attributes unescape escape expires ebcdic2ascii ascii2ebcdic);
+
+#use constant XHTML_DTD => ['-//W3C//DTD XHTML Basic 1.0//EN',
+#                           'http://www.w3.org/TR/xhtml-basic/xhtml-basic10.dtd'];
+
+use constant XHTML_DTD => ['-//W3C//DTD XHTML 1.0 Transitional//EN',
+                           'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'];
+
+{
+  local $^W = 0;
+  $TAINTED = substr("$0$^X",0,0);
+}
+
+$MOD_PERL            = 0; # no mod_perl by default
+
+#global settings
+$POST_MAX            = -1; # no limit to uploaded files
+$DISABLE_UPLOADS     = 0;
+
+@SAVED_SYMBOLS = ();
+
+
+# >>>>> Here are some globals that you might want to adjust <<<<<<
+sub initialize_globals {
+    # Set this to 1 to enable copious autoloader debugging messages
+    $AUTOLOAD_DEBUG = 0;
+
+    # Set this to 1 to generate XTML-compatible output
+    $XHTML = 1;
+
+    # Change this to the preferred DTD to print in start_html()
+    # or use default_dtd('text of DTD to use');
+    $DEFAULT_DTD = [ '-//W3C//DTD HTML 4.01 Transitional//EN',
+                    'http://www.w3.org/TR/html4/loose.dtd' ] ;
+
+    # Set this to 1 to enable NOSTICKY scripts
+    # or: 
+    #    1) use CGI '-nosticky';
+    #    2) $CGI::NOSTICKY = 1;
+    $NOSTICKY = 0;
+
+    # Set this to 1 to enable NPH scripts
+    # or: 
+    #    1) use CGI qw(-nph)
+    #    2) CGI::nph(1)
+    #    3) print header(-nph=>1)
+    $NPH = 0;
+
+    # Set this to 1 to enable debugging from @ARGV
+    # Set to 2 to enable debugging from STDIN
+    $DEBUG = 1;
+
+    # Set this to 1 to make the temporary files created
+    # during file uploads safe from prying eyes
+    # or do...
+    #    1) use CGI qw(:private_tempfiles)
+    #    2) CGI::private_tempfiles(1);
+    $PRIVATE_TEMPFILES = 0;
+
+    # Set this to 1 to generate automatic tab indexes
+    $TABINDEX = 0;
+
+    # Set this to 1 to cause files uploaded in multipart documents
+    # to be closed, instead of caching the file handle
+    # or:
+    #    1) use CGI qw(:close_upload_files)
+    #    2) $CGI::close_upload_files(1);
+    # Uploads with many files run out of file handles.
+    # Also, for performance, since the file is already on disk,
+    # it can just be renamed, instead of read and written.
+    $CLOSE_UPLOAD_FILES = 0;
+
+    # Automatically determined -- don't change
+    $EBCDIC = 0;
+
+    # Change this to 1 to suppress redundant HTTP headers
+    $HEADERS_ONCE = 0;
+
+    # separate the name=value pairs by semicolons rather than ampersands
+    $USE_PARAM_SEMICOLONS = 1;
+
+    # Do not include undefined params parsed from query string
+    # use CGI qw(-no_undef_params);
+    $NO_UNDEF_PARAMS = 0;
+
+    # return everything as utf-8
+    $PARAM_UTF8      = 0;
+
+    # Other globals that you shouldn't worry about.
+    undef $Q;
+    $BEEN_THERE = 0;
+    $DTD_PUBLIC_IDENTIFIER = "";
+    undef @QUERY_PARAM;
+    undef %EXPORT;
+    undef $QUERY_CHARSET;
+    undef %QUERY_FIELDNAMES;
+    undef %QUERY_TMPFILES;
+
+    # prevent complaints by mod_perl
+    1;
+}
+
+# ------------------ START OF THE LIBRARY ------------
+
+# make mod_perlhappy
+initialize_globals();
+
+# FIGURE OUT THE OS WE'RE RUNNING UNDER
+# Some systems support the $^O variable.  If not
+# available then require() the Config library
+unless ($OS) {
+    unless ($OS = $^O) {
+       require Config;
+       $OS = $Config::Config{'osname'};
+    }
+}
+if ($OS =~ /^MSWin/i) {
+  $OS = 'WINDOWS';
+} elsif ($OS =~ /^VMS/i) {
+  $OS = 'VMS';
+} elsif ($OS =~ /^dos/i) {
+  $OS = 'DOS';
+} elsif ($OS =~ /^MacOS/i) {
+    $OS = 'MACINTOSH';
+} elsif ($OS =~ /^os2/i) {
+    $OS = 'OS2';
+} elsif ($OS =~ /^epoc/i) {
+    $OS = 'EPOC';
+} elsif ($OS =~ /^cygwin/i) {
+    $OS = 'CYGWIN';
+} elsif ($OS =~ /^NetWare/i) {
+    $OS = 'NETWARE';
+} else {
+    $OS = 'UNIX';
+}
+
+# Some OS logic.  Binary mode enabled on DOS, NT and VMS
+$needs_binmode = $OS=~/^(WINDOWS|DOS|OS2|MSWin|CYGWIN|NETWARE)/;
+
+# This is the default class for the CGI object to use when all else fails.
+$DefaultClass = 'CGI' unless defined $CGI::DefaultClass;
+
+# This is where to look for autoloaded routines.
+$AutoloadClass = $DefaultClass unless defined $CGI::AutoloadClass;
+
+# The path separator is a slash, backslash or semicolon, depending
+# on the paltform.
+$SL = {
+     UNIX    => '/',  OS2 => '\\', EPOC      => '/', CYGWIN => '/', NETWARE => '/',
+     WINDOWS => '\\', DOS => '\\', MACINTOSH => ':', VMS    => '/'
+    }->{$OS};
+
+# This no longer seems to be necessary
+# Turn on NPH scripts by default when running under IIS server!
+# $NPH++ if defined($ENV{'SERVER_SOFTWARE'}) && $ENV{'SERVER_SOFTWARE'}=~/IIS/;
+$IIS++ if defined($ENV{'SERVER_SOFTWARE'}) && $ENV{'SERVER_SOFTWARE'}=~/IIS/;
+
+# Turn on special checking for ActiveState's PerlEx
+$PERLEX++ if defined($ENV{'GATEWAY_INTERFACE'}) && $ENV{'GATEWAY_INTERFACE'} =~ /^CGI-PerlEx/;
+
+# Turn on special checking for Doug MacEachern's modperl
+# PerlEx::DBI tries to fool DBI by setting MOD_PERL
+if (exists $ENV{MOD_PERL} && ! $PERLEX) {
+  # mod_perl handlers may run system() on scripts using CGI.pm;
+  # Make sure so we don't get fooled by inherited $ENV{MOD_PERL}
+  if (exists $ENV{MOD_PERL_API_VERSION} && $ENV{MOD_PERL_API_VERSION} == 2) {
+    $MOD_PERL = 2;
+    require Apache2::Response;
+    require Apache2::RequestRec;
+    require Apache2::RequestUtil;
+    require Apache2::RequestIO;
+    require APR::Pool;
+  } else {
+    $MOD_PERL = 1;
+    require Apache;
+  }
+}
+
+# Define the CRLF sequence.  I can't use a simple "\r\n" because the meaning
+# of "\n" is different on different OS's (sometimes it generates CRLF, sometimes LF
+# and sometimes CR).  The most popular VMS web server
+# doesn't accept CRLF -- instead it wants a LR.  EBCDIC machines don't
+# use ASCII, so \015\012 means something different.  I find this all 
+# really annoying.
+$EBCDIC = "\t" ne "\011";
+if ($OS eq 'VMS') {
+  $CRLF = "\n";
+} elsif ($EBCDIC) {
+  $CRLF= "\r\n";
+} else {
+  $CRLF = "\015\012";
+}
+
+if ($needs_binmode) {
+    $CGI::DefaultClass->binmode(\*main::STDOUT);
+    $CGI::DefaultClass->binmode(\*main::STDIN);
+    $CGI::DefaultClass->binmode(\*main::STDERR);
+}
+
+%EXPORT_TAGS = (
+               ':html2'=>['h1'..'h6',qw/p br hr ol ul li dl dt dd menu code var strong em
+                          tt u i b blockquote pre img a address cite samp dfn html head
+                          base body Link nextid title meta kbd start_html end_html
+                          input Select option comment charset escapeHTML/],
+               ':html3'=>[qw/div table caption th td TR Tr sup Sub strike applet Param nobr
+                          embed basefont style span layer ilayer font frameset frame script small big Area Map/],
+                ':html4'=>[qw/abbr acronym bdo col colgroup del fieldset iframe
+                            ins label legend noframes noscript object optgroup Q 
+                            thead tbody tfoot/], 
+               ':netscape'=>[qw/blink fontsize center/],
+               ':form'=>[qw/textfield textarea filefield password_field hidden checkbox checkbox_group 
+                         submit reset defaults radio_group popup_menu button autoEscape
+                         scrolling_list image_button start_form end_form startform endform
+                         start_multipart_form end_multipart_form isindex tmpFileName uploadInfo URL_ENCODED MULTIPART/],
+               ':cgi'=>[qw/param upload path_info path_translated request_uri url self_url script_name 
+                        cookie Dump
+                        raw_cookie request_method query_string Accept user_agent remote_host content_type
+                        remote_addr referer server_name server_software server_port server_protocol virtual_port
+                        virtual_host remote_ident auth_type http append
+                        save_parameters restore_parameters param_fetch
+                        remote_user user_name header redirect import_names put 
+                        Delete Delete_all url_param cgi_error/],
+               ':ssl' => [qw/https/],
+               ':cgi-lib' => [qw/ReadParse PrintHeader HtmlTop HtmlBot SplitParam Vars/],
+               ':html' => [qw/:html2 :html3 :html4 :netscape/],
+               ':standard' => [qw/:html2 :html3 :html4 :form :cgi/],
+               ':push' => [qw/multipart_init multipart_start multipart_end multipart_final/],
+               ':all' => [qw/:html2 :html3 :netscape :form :cgi :internal :html4/]
+               );
+
+# Custom 'can' method for both autoloaded and non-autoloaded subroutines.
+# Author: Cees Hek <cees@sitesuite.com.au>
+
+sub can {
+       my($class, $method) = @_;
+
+       # See if UNIVERSAL::can finds it.
+
+       if (my $func = $class -> SUPER::can($method) ){
+               return $func;
+       }
+
+       # Try to compile the function.
+
+       eval {
+               # _compile looks at $AUTOLOAD for the function name.
+
+               local $AUTOLOAD = join "::", $class, $method;
+               &_compile;
+       };
+
+       # Now that the function is loaded (if it exists)
+       # just use UNIVERSAL::can again to do the work.
+
+       return $class -> SUPER::can($method);
+}
+
+# to import symbols into caller
+sub import {
+    my $self = shift;
+
+    # This causes modules to clash.
+    undef %EXPORT_OK;
+    undef %EXPORT;
+
+    $self->_setup_symbols(@_);
+    my ($callpack, $callfile, $callline) = caller;
+
+    # To allow overriding, search through the packages
+    # Till we find one in which the correct subroutine is defined.
+    my @packages = ($self,@{"$self\:\:ISA"});
+    for $sym (keys %EXPORT) {
+       my $pck;
+       my $def = ${"$self\:\:AutoloadClass"} || $DefaultClass;
+       for $pck (@packages) {
+           if (defined(&{"$pck\:\:$sym"})) {
+               $def = $pck;
+               last;
+           }
+       }
+       *{"${callpack}::$sym"} = \&{"$def\:\:$sym"};
+    }
+}
+
+sub compile {
+    my $pack = shift;
+    $pack->_setup_symbols('-compile',@_);
+}
+
+sub expand_tags {
+    my($tag) = @_;
+    return ("start_$1","end_$1") if $tag=~/^(?:\*|start_|end_)(.+)/;
+    my(@r);
+    return ($tag) unless $EXPORT_TAGS{$tag};
+    for (@{$EXPORT_TAGS{$tag}}) {
+       push(@r,&expand_tags($_));
+    }
+    return @r;
+}
+
+#### Method: new
+# The new routine.  This will check the current environment
+# for an existing query string, and initialize itself, if so.
+####
+sub new {
+  my($class,@initializer) = @_;
+  my $self = {};
+
+  bless $self,ref $class || $class || $DefaultClass;
+
+  # always use a tempfile
+  $self->{'use_tempfile'} = 1;
+
+  if (ref($initializer[0])
+      && (UNIVERSAL::isa($initializer[0],'Apache')
+         ||
+         UNIVERSAL::isa($initializer[0],'Apache2::RequestRec')
+        )) {
+    $self->r(shift @initializer);
+  }
+ if (ref($initializer[0]) 
+     && (UNIVERSAL::isa($initializer[0],'CODE'))) {
+    $self->upload_hook(shift @initializer, shift @initializer);
+    $self->{'use_tempfile'} = shift @initializer if (@initializer > 0);
+  }
+  if ($MOD_PERL) {
+    if ($MOD_PERL == 1) {
+      $self->r(Apache->request) unless $self->r;
+      my $r = $self->r;
+      $r->register_cleanup(\&CGI::_reset_globals);
+      $self->_setup_symbols(@SAVED_SYMBOLS) if @SAVED_SYMBOLS;
+    }
+    else {
+      # XXX: once we have the new API
+      # will do a real PerlOptions -SetupEnv check
+      $self->r(Apache2::RequestUtil->request) unless $self->r;
+      my $r = $self->r;
+      $r->subprocess_env unless exists $ENV{REQUEST_METHOD};
+      $r->pool->cleanup_register(\&CGI::_reset_globals);
+      $self->_setup_symbols(@SAVED_SYMBOLS) if @SAVED_SYMBOLS;
+    }
+    undef $NPH;
+  }
+  $self->_reset_globals if $PERLEX;
+  $self->init(@initializer);
+  return $self;
+}
+
+# We provide a DESTROY method so that we can ensure that
+# temporary files are closed (via Fh->DESTROY) before they
+# are unlinked (via CGITempFile->DESTROY) because it is not
+# possible to unlink an open file on Win32. We explicitly
+# call DESTROY on each, rather than just undefing them and
+# letting Perl DESTROY them by garbage collection, in case the
+# user is still holding any reference to them as well.
+sub DESTROY {
+  my $self = shift;
+  if ($OS eq 'WINDOWS' || $OS eq 'VMS') {
+    for my $href (values %{$self->{'.tmpfiles'}}) {
+      $href->{hndl}->DESTROY if defined $href->{hndl};
+      $href->{name}->DESTROY if defined $href->{name};
+    }
+  }
+}
+
+sub r {
+  my $self = shift;
+  my $r = $self->{'.r'};
+  $self->{'.r'} = shift if @_;
+  $r;
+}
+
+sub upload_hook {
+  my $self;
+  if (ref $_[0] eq 'CODE') {
+    $CGI::Q = $self = $CGI::DefaultClass->new(@_);
+  } else {
+    $self = shift;
+  }
+  my ($hook,$data,$use_tempfile) = @_;
+  $self->{'.upload_hook'} = $hook;
+  $self->{'.upload_data'} = $data;
+  $self->{'use_tempfile'} = $use_tempfile if defined $use_tempfile;
+}
+
+#### Method: param
+# Returns the value(s)of a named parameter.
+# If invoked in a list context, returns the
+# entire list.  Otherwise returns the first
+# member of the list.
+# If name is not provided, return a list of all
+# the known parameters names available.
+# If more than one argument is provided, the
+# second and subsequent arguments are used to
+# set the value of the parameter.
+####
+sub param {
+    my($self,@p) = self_or_default(@_);
+    return $self->all_parameters unless @p;
+    my($name,$value,@other);
+
+    # For compatibility between old calling style and use_named_parameters() style, 
+    # we have to special case for a single parameter present.
+    if (@p > 1) {
+       ($name,$value,@other) = rearrange([NAME,[DEFAULT,VALUE,VALUES]],@p);
+       my(@values);
+
+       if (substr($p[0],0,1) eq '-') {
+           @values = defined($value) ? (ref($value) && ref($value) eq 'ARRAY' ? @{$value} : $value) : ();
+       } else {
+           for ($value,@other) {
+               push(@values,$_) if defined($_);
+           }
+       }
+       # If values is provided, then we set it.
+       if (@values or defined $value) {
+           $self->add_parameter($name);
+           $self->{param}{$name}=[@values];
+       }
+    } else {
+       $name = $p[0];
+    }
+
+    return unless defined($name) && $self->{param}{$name};
+
+    my @result = @{$self->{param}{$name}};
+
+    if ($PARAM_UTF8) {
+      eval "require Encode; 1;" unless Encode->can('decode'); # bring in these functions
+      @result = map {ref $_ ? $_ : $self->_decode_utf8($_) } @result;
+    }
+
+    return wantarray ?  @result : $result[0];
+}
+
+sub _decode_utf8 {
+    my ($self, $val) = @_;
+
+    if (Encode::is_utf8($val)) {
+        return $val;
+    }
+    else {
+        return Encode::decode(utf8 => $val);
+    }
+}
+
+sub self_or_default {
+    return @_ if defined($_[0]) && (!ref($_[0])) &&($_[0] eq 'CGI');
+    unless (defined($_[0]) && 
+           (ref($_[0]) eq 'CGI' || UNIVERSAL::isa($_[0],'CGI')) # slightly optimized for common case
+           ) {
+       $Q = $CGI::DefaultClass->new unless defined($Q);
+       unshift(@_,$Q);
+    }
+    return wantarray ? @_ : $Q;
+}
+
+sub self_or_CGI {
+    local $^W=0;                # prevent a warning
+    if (defined($_[0]) &&
+       (substr(ref($_[0]),0,3) eq 'CGI' 
+        || UNIVERSAL::isa($_[0],'CGI'))) {
+       return @_;
+    } else {
+       return ($DefaultClass,@_);
+    }
+}
+
+########################################
+# THESE METHODS ARE MORE OR LESS PRIVATE
+# GO TO THE __DATA__ SECTION TO SEE MORE
+# PUBLIC METHODS
+########################################
+
+# Initialize the query object from the environment.
+# If a parameter list is found, this object will be set
+# to a hash in which parameter names are keys
+# and the values are stored as lists
+# If a keyword list is found, this method creates a bogus
+# parameter list with the single parameter 'keywords'.
+
+sub init {
+  my $self = shift;
+  my($query_string,$meth,$content_length,$fh,@lines) = ('','','','');
+
+  my $is_xforms;
+
+  my $initializer = shift;  # for backward compatibility
+  local($/) = "\n";
+
+    # set autoescaping on by default
+    $self->{'escape'} = 1;
+
+    # if we get called more than once, we want to initialize
+    # ourselves from the original query (which may be gone
+    # if it was read from STDIN originally.)
+    if (@QUERY_PARAM && !defined($initializer)) {
+        for my $name (@QUERY_PARAM) {
+            my $val = $QUERY_PARAM{$name}; # always an arrayref;
+            $self->param('-name'=>$name,'-value'=> $val);
+            if (defined $val and ref $val eq 'ARRAY') {
+                for my $fh (grep {defined($_) && ref($_) && defined(fileno($_))} @$val) {
+                   seek($fh,0,0); # reset the filehandle.  
+                }
+
+            }
+        }
+        $self->charset($QUERY_CHARSET);
+        $self->{'.fieldnames'} = {%QUERY_FIELDNAMES};
+        $self->{'.tmpfiles'}   = {%QUERY_TMPFILES};
+        return;
+    }
+
+    $meth=$ENV{'REQUEST_METHOD'} if defined($ENV{'REQUEST_METHOD'});
+    $content_length = defined($ENV{'CONTENT_LENGTH'}) ? $ENV{'CONTENT_LENGTH'} : 0;
+
+    $fh = to_filehandle($initializer) if $initializer;
+
+    # set charset to the safe ISO-8859-1
+    $self->charset('ISO-8859-1');
+
+  METHOD: {
+
+      # avoid unreasonably large postings
+      if (($POST_MAX > 0) && ($content_length > $POST_MAX)) {
+       #discard the post, unread
+       $self->cgi_error("413 Request entity too large");
+       last METHOD;
+      }
+
+      # Process multipart postings, but only if the initializer is
+      # not defined.
+      if ($meth eq 'POST'
+         && defined($ENV{'CONTENT_TYPE'})
+         && $ENV{'CONTENT_TYPE'}=~m|^multipart/form-data|
+         && !defined($initializer)
+         ) {
+         my($boundary) = $ENV{'CONTENT_TYPE'} =~ /boundary=\"?([^\";,]+)\"?/;
+         $self->read_multipart($boundary,$content_length);
+         last METHOD;
+      } 
+
+      # Process XForms postings. We know that we have XForms in the
+      # following cases:
+      # method eq 'POST' && content-type eq 'application/xml'
+      # method eq 'POST' && content-type =~ /multipart\/related.+start=/
+      # There are more cases, actually, but for now, we don't support other
+      # methods for XForm posts.
+      # In a XForm POST, the QUERY_STRING is parsed normally.
+      # If the content-type is 'application/xml', we just set the param
+      # XForms:Model (referring to the xml syntax) param containing the
+      # unparsed XML data.
+      # In the case of multipart/related we set XForms:Model as above, but
+      # the other parts are available as uploads with the Content-ID as the
+      # the key.
+      # See the URL below for XForms specs on this issue.
+      # http://www.w3.org/TR/2006/REC-xforms-20060314/slice11.html#submit-options
+      if ($meth eq 'POST' && defined($ENV{'CONTENT_TYPE'})) {
+              if ($ENV{'CONTENT_TYPE'} eq 'application/xml') {
+                      my($param) = 'XForms:Model';
+                      my($value) = '';
+                      $self->add_parameter($param);
+                      $self->read_from_client(\$value,$content_length,0)
+                        if $content_length > 0;
+                      push (@{$self->{param}{$param}},$value);
+                      $is_xforms = 1;
+              } elsif ($ENV{'CONTENT_TYPE'} =~ /multipart\/related.+boundary=\"?([^\";,]+)\"?.+start=\"?\<?([^\"\>]+)\>?\"?/) {
+                      my($boundary,$start) = ($1,$2);
+                      my($param) = 'XForms:Model';
+                      $self->add_parameter($param);
+                      my($value) = $self->read_multipart_related($start,$boundary,$content_length,0);
+                      push (@{$self->{param}{$param}},$value);
+                      if ($MOD_PERL) {
+                              $query_string = $self->r->args;
+                      } else {
+                              $query_string = $ENV{'QUERY_STRING'} if defined $ENV{'QUERY_STRING'};
+                              $query_string ||= $ENV{'REDIRECT_QUERY_STRING'} if defined $ENV{'REDIRECT_QUERY_STRING'};
+                      }
+                      $is_xforms = 1;
+              }
+      }
+
+
+      # If initializer is defined, then read parameters
+      # from it.
+      if (!$is_xforms && defined($initializer)) {
+         if (UNIVERSAL::isa($initializer,'CGI')) {
+             $query_string = $initializer->query_string;
+             last METHOD;
+         }
+         if (ref($initializer) && ref($initializer) eq 'HASH') {
+             for (keys %$initializer) {
+                 $self->param('-name'=>$_,'-value'=>$initializer->{$_});
+             }
+             last METHOD;
+         }
+
+          if (defined($fh) && ($fh ne '')) {
+              while (my $line = <$fh>) {
+                  chomp $line;
+                  last if $line =~ /^=$/;
+                  push(@lines,$line);
+              }
+              # massage back into standard format
+              if ("@lines" =~ /=/) {
+                  $query_string=join("&",@lines);
+              } else {
+                  $query_string=join("+",@lines);
+              }
+              last METHOD;
+          }
+
+         # last chance -- treat it as a string
+         $initializer = $$initializer if ref($initializer) eq 'SCALAR';
+         $query_string = $initializer;
+
+         last METHOD;
+      }
+
+      # If method is GET, HEAD or DELETE, fetch the query from
+      # the environment.
+      if ($is_xforms || $meth=~/^(GET|HEAD|DELETE)$/) {
+         if ($MOD_PERL) {
+           $query_string = $self->r->args;
+         } else {
+             $query_string = $ENV{'QUERY_STRING'} if defined $ENV{'QUERY_STRING'};
+             $query_string ||= $ENV{'REDIRECT_QUERY_STRING'} if defined $ENV{'REDIRECT_QUERY_STRING'};
+         }
+         last METHOD;
+      }
+
+      if ($meth eq 'POST' || $meth eq 'PUT') {
+         if ( $content_length > 0 ) {
+           $self->read_from_client(\$query_string,$content_length,0);
+         }
+         # Some people want to have their cake and eat it too!
+         # Uncomment this line to have the contents of the query string
+         # APPENDED to the POST data.
+         # $query_string .= (length($query_string) ? '&' : '') . $ENV{'QUERY_STRING'} if defined $ENV{'QUERY_STRING'};
+         last METHOD;
+      }
+
+      # If $meth is not of GET, POST, PUT or HEAD, assume we're
+      #   being debugged offline.
+      # Check the command line and then the standard input for data.
+      # We use the shellwords package in order to behave the way that
+      # UN*X programmers expect.
+      if ($DEBUG)
+      {
+          my $cmdline_ret = read_from_cmdline();
+          $query_string = $cmdline_ret->{'query_string'};
+          if (defined($cmdline_ret->{'subpath'}))
+          {
+              $self->path_info($cmdline_ret->{'subpath'});
+          }
+      }
+  }
+
+# YL: Begin Change for XML handler 10/19/2001
+    if (!$is_xforms && ($meth eq 'POST' || $meth eq 'PUT')
+        && defined($ENV{'CONTENT_TYPE'})
+        && $ENV{'CONTENT_TYPE'} !~ m|^application/x-www-form-urlencoded|
+       && $ENV{'CONTENT_TYPE'} !~ m|^multipart/form-data| ) {
+           my($param) = $meth . 'DATA' ;
+           $self->add_parameter($param) ;
+           push (@{$self->{param}{$param}},$query_string);
+           undef $query_string ;
+    }
+# YL: End Change for XML handler 10/19/2001
+
+    # We now have the query string in hand.  We do slightly
+    # different things for keyword lists and parameter lists.
+    if (defined $query_string && length $query_string) {
+       if ($query_string =~ /[&=;]/) {
+           $self->parse_params($query_string);
+       } else {
+           $self->add_parameter('keywords');
+           $self->{param}{'keywords'} = [$self->parse_keywordlist($query_string)];
+       }
+    }
+
+    # Special case.  Erase everything if there is a field named
+    # .defaults.
+    if ($self->param('.defaults')) {
+      $self->delete_all();
+    }
+
+    # hash containing our defined fieldnames
+    $self->{'.fieldnames'} = {};
+    for ($self->param('.cgifields')) {
+       $self->{'.fieldnames'}->{$_}++;
+    }
+    
+    # Clear out our default submission button flag if present
+    $self->delete('.submit');
+    $self->delete('.cgifields');
+
+    $self->save_request unless defined $initializer;
+}
+
+# FUNCTIONS TO OVERRIDE:
+# Turn a string into a filehandle
+sub to_filehandle {
+    my $thingy = shift;
+    return undef unless $thingy;
+    return $thingy if UNIVERSAL::isa($thingy,'GLOB');
+    return $thingy if UNIVERSAL::isa($thingy,'FileHandle');
+    if (!ref($thingy)) {
+       my $caller = 1;
+       while (my $package = caller($caller++)) {
+           my($tmp) = $thingy=~/[\':]/ ? $thingy : "$package\:\:$thingy"; 
+           return $tmp if defined(fileno($tmp));
+       }
+    }
+    return undef;
+}
+
+# send output to the browser
+sub put {
+    my($self,@p) = self_or_default(@_);
+    $self->print(@p);
+}
+
+# print to standard output (for overriding in mod_perl)
+sub print {
+    shift;
+    CORE::print(@_);
+}
+
+# get/set last cgi_error
+sub cgi_error {
+    my ($self,$err) = self_or_default(@_);
+    $self->{'.cgi_error'} = $err if defined $err;
+    return $self->{'.cgi_error'};
+}
+
+sub save_request {
+    my($self) = @_;
+    # We're going to play with the package globals now so that if we get called
+    # again, we initialize ourselves in exactly the same way.  This allows
+    # us to have several of these objects.
+    @QUERY_PARAM = $self->param; # save list of parameters
+    for (@QUERY_PARAM) {
+      next unless defined $_;
+      $QUERY_PARAM{$_}=$self->{param}{$_};
+    }
+    $QUERY_CHARSET = $self->charset;
+    %QUERY_FIELDNAMES = %{$self->{'.fieldnames'}};
+    %QUERY_TMPFILES   = %{ $self->{'.tmpfiles'} || {} };
+}
+
+sub parse_params {
+    my($self,$tosplit) = @_;
+    my(@pairs) = split(/[&;]/,$tosplit);
+    my($param,$value);
+    for (@pairs) {
+       ($param,$value) = split('=',$_,2);
+       next unless defined $param;
+       next if $NO_UNDEF_PARAMS and not defined $value;
+       $value = '' unless defined $value;
+       $param = unescape($param);
+       $value = unescape($value);
+       $self->add_parameter($param);
+       push (@{$self->{param}{$param}},$value);
+    }
+}
+
+sub add_parameter {
+    my($self,$param)=@_;
+    return unless defined $param;
+    push (@{$self->{'.parameters'}},$param) 
+       unless defined($self->{param}{$param});
+}
+
+sub all_parameters {
+    my $self = shift;
+    return () unless defined($self) && $self->{'.parameters'};
+    return () unless @{$self->{'.parameters'}};
+    return @{$self->{'.parameters'}};
+}
+
+# put a filehandle into binary mode (DOS)
+sub binmode {
+    return unless defined($_[1]) && ref ($_[1]) && defined fileno($_[1]);
+    CORE::binmode($_[1]);
+}
+
+sub _make_tag_func {
+    my ($self,$tagname) = @_;
+    my $func = qq(
+       sub $tagname {
+         my (\$q,\$a,\@rest) = self_or_default(\@_);
+         my(\$attr) = '';
+        if (ref(\$a) && ref(\$a) eq 'HASH') {
+           my(\@attr) = make_attributes(\$a,\$q->{'escape'});
+           \$attr = " \@attr" if \@attr;
+         } else {
+           unshift \@rest,\$a if defined \$a;
+         }
+       );
+    if ($tagname=~/start_(\w+)/i) {
+       $func .= qq! return "<\L$1\E\$attr>";} !;
+    } elsif ($tagname=~/end_(\w+)/i) {
+       $func .= qq! return "<\L/$1\E>"; } !;
+    } else {
+       $func .= qq#
+           return \$XHTML ? "\L<$tagname\E\$attr />" : "\L<$tagname\E\$attr>" unless \@rest;
+           my(\$tag,\$untag) = ("\L<$tagname\E\$attr>","\L</$tagname>\E");
+           my \@result = map { "\$tag\$_\$untag" } 
+                              (ref(\$rest[0]) eq 'ARRAY') ? \@{\$rest[0]} : "\@rest";
+           return "\@result";
+            }#;
+    }
+return $func;
+}
+
+sub AUTOLOAD {
+    print STDERR "CGI::AUTOLOAD for $AUTOLOAD\n" if $CGI::AUTOLOAD_DEBUG;
+    my $func = &_compile;
+    goto &$func;
+}
+
+sub _compile {
+    my($func) = $AUTOLOAD;
+    my($pack,$func_name);
+    {
+       local($1,$2); # this fixes an obscure variable suicide problem.
+       $func=~/(.+)::([^:]+)$/;
+       ($pack,$func_name) = ($1,$2);
+       $pack=~s/::SUPER$//;    # fix another obscure problem
+       $pack = ${"$pack\:\:AutoloadClass"} || $CGI::DefaultClass
+           unless defined(${"$pack\:\:AUTOLOADED_ROUTINES"});
+
+        my($sub) = \%{"$pack\:\:SUBS"};
+        unless (%$sub) {
+          my($auto) = \${"$pack\:\:AUTOLOADED_ROUTINES"};
+          local ($@,$!);
+          eval "package $pack; $$auto";
+          croak("$AUTOLOAD: $@") if $@;
+           $$auto = '';  # Free the unneeded storage (but don't undef it!!!)
+       }
+       my($code) = $sub->{$func_name};
+
+       $code = "sub $AUTOLOAD { }" if (!$code and $func_name eq 'DESTROY');
+       if (!$code) {
+          (my $base = $func_name) =~ s/^(start_|end_)//i;
+          if ($EXPORT{':any'} || 
+              $EXPORT{'-any'} ||
+              $EXPORT{$base} || 
+              (%EXPORT_OK || grep(++$EXPORT_OK{$_},&expand_tags(':html')))
+                  && $EXPORT_OK{$base}) {
+              $code = $CGI::DefaultClass->_make_tag_func($func_name);
+          }
+       }
+       croak("Undefined subroutine $AUTOLOAD\n") unless $code;
+       local ($@,$!);
+       eval "package $pack; $code";
+       if ($@) {
+          $@ =~ s/ at .*\n//;
+          croak("$AUTOLOAD: $@");
+       }
+    }       
+    CORE::delete($sub->{$func_name});  #free storage
+    return "$pack\:\:$func_name";
+}
+
+sub _selected {
+  my $self = shift;
+  my $value = shift;
+  return '' unless $value;
+  return $XHTML ? qq(selected="selected" ) : qq(selected );
+}
+
+sub _checked {
+  my $self = shift;
+  my $value = shift;
+  return '' unless $value;
+  return $XHTML ? qq(checked="checked" ) : qq(checked );
+}
+
+sub _reset_globals { initialize_globals(); }
+
+sub _setup_symbols {
+    my $self = shift;
+    my $compile = 0;
+
+    # to avoid reexporting unwanted variables
+    undef %EXPORT;
+
+    for (@_) {
+       $HEADERS_ONCE++,         next if /^[:-]unique_headers$/;
+       $NPH++,                  next if /^[:-]nph$/;
+       $NOSTICKY++,             next if /^[:-]nosticky$/;
+       $DEBUG=0,                next if /^[:-]no_?[Dd]ebug$/;
+       $DEBUG=2,                next if /^[:-][Dd]ebug$/;
+       $USE_PARAM_SEMICOLONS++, next if /^[:-]newstyle_urls$/;
+       $PARAM_UTF8++,           next if /^[:-]utf8$/;
+       $XHTML++,                next if /^[:-]xhtml$/;
+       $XHTML=0,                next if /^[:-]no_?xhtml$/;
+       $USE_PARAM_SEMICOLONS=0, next if /^[:-]oldstyle_urls$/;
+       $PRIVATE_TEMPFILES++,    next if /^[:-]private_tempfiles$/;
+       $TABINDEX++,             next if /^[:-]tabindex$/;
+       $CLOSE_UPLOAD_FILES++,   next if /^[:-]close_upload_files$/;
+       $EXPORT{$_}++,           next if /^[:-]any$/;
+       $compile++,              next if /^[:-]compile$/;
+       $NO_UNDEF_PARAMS++,      next if /^[:-]no_undef_params$/;
+       
+       # This is probably extremely evil code -- to be deleted some day.
+       if (/^[-]autoload$/) {
+           my($pkg) = caller(1);
+           *{"${pkg}::AUTOLOAD"} = sub { 
+               my($routine) = $AUTOLOAD;
+               $routine =~ s/^.*::/CGI::/;
+               &$routine;
+           };
+           next;
+       }
+
+       for (&expand_tags($_)) {
+           tr/a-zA-Z0-9_//cd;  # don't allow weird function names
+           $EXPORT{$_}++;
+       }
+    }
+    _compile_all(keys %EXPORT) if $compile;
+    @SAVED_SYMBOLS = @_;
+}
+
+sub charset {
+  my ($self,$charset) = self_or_default(@_);
+  $self->{'.charset'} = $charset if defined $charset;
+  $self->{'.charset'};
+}
+
+sub element_id {
+  my ($self,$new_value) = self_or_default(@_);
+  $self->{'.elid'} = $new_value if defined $new_value;
+  sprintf('%010d',$self->{'.elid'}++);
+}
+
+sub element_tab {
+  my ($self,$new_value) = self_or_default(@_);
+  $self->{'.etab'} ||= 1;
+  $self->{'.etab'} = $new_value if defined $new_value;
+  my $tab = $self->{'.etab'}++;
+  return '' unless $TABINDEX or defined $new_value;
+  return qq(tabindex="$tab" );
+}
+
+###############################################################################
+################# THESE FUNCTIONS ARE AUTOLOADED ON DEMAND ####################
+###############################################################################
+$AUTOLOADED_ROUTINES = '';      # get rid of -w warning
+$AUTOLOADED_ROUTINES=<<'END_OF_AUTOLOAD';
+
+%SUBS = (
+
+'URL_ENCODED'=> <<'END_OF_FUNC',
+sub URL_ENCODED { 'application/x-www-form-urlencoded'; }
+END_OF_FUNC
+
+'MULTIPART' => <<'END_OF_FUNC',
+sub MULTIPART {  'multipart/form-data'; }
+END_OF_FUNC
+
+'SERVER_PUSH' => <<'END_OF_FUNC',
+sub SERVER_PUSH { 'multipart/x-mixed-replace;boundary="' . shift() . '"'; }
+END_OF_FUNC
+
+'new_MultipartBuffer' => <<'END_OF_FUNC',
+# Create a new multipart buffer
+sub new_MultipartBuffer {
+    my($self,$boundary,$length) = @_;
+    return MultipartBuffer->new($self,$boundary,$length);
+}
+END_OF_FUNC
+
+'read_from_client' => <<'END_OF_FUNC',
+# Read data from a file handle
+sub read_from_client {
+    my($self, $buff, $len, $offset) = @_;
+    local $^W=0;                # prevent a warning
+    return $MOD_PERL
+        ? $self->r->read($$buff, $len, $offset)
+        : read(\*STDIN, $$buff, $len, $offset);
+}
+END_OF_FUNC
+
+'delete' => <<'END_OF_FUNC',
+#### Method: delete
+# Deletes the named parameter entirely.
+####
+sub delete {
+    my($self,@p) = self_or_default(@_);
+    my(@names) = rearrange([NAME],@p);
+    my @to_delete = ref($names[0]) eq 'ARRAY' ? @$names[0] : @names;
+    my %to_delete;
+    for my $name (@to_delete)
+    {
+        CORE::delete $self->{param}{$name};
+        CORE::delete $self->{'.fieldnames'}->{$name};
+        $to_delete{$name}++;
+    }
+    @{$self->{'.parameters'}}=grep { !exists($to_delete{$_}) } $self->param();
+    return;
+}
+END_OF_FUNC
+
+#### Method: import_names
+# Import all parameters into the given namespace.
+# Assumes namespace 'Q' if not specified
+####
+'import_names' => <<'END_OF_FUNC',
+sub import_names {
+    my($self,$namespace,$delete) = self_or_default(@_);
+    $namespace = 'Q' unless defined($namespace);
+    die "Can't import names into \"main\"\n" if \%{"${namespace}::"} == \%::;
+    if ($delete || $MOD_PERL || exists $ENV{'FCGI_ROLE'}) {
+       # can anyone find an easier way to do this?
+       for (keys %{"${namespace}::"}) {
+           local *symbol = "${namespace}::${_}";
+           undef $symbol;
+           undef @symbol;
+           undef %symbol;
+       }
+    }
+    my($param,@value,$var);
+    for $param ($self->param) {
+       # protect against silly names
+       ($var = $param)=~tr/a-zA-Z0-9_/_/c;
+       $var =~ s/^(?=\d)/_/;
+       local *symbol = "${namespace}::$var";
+       @value = $self->param($param);
+       @symbol = @value;
+       $symbol = $value[0];
+    }
+}
+END_OF_FUNC
+
+#### Method: keywords
+# Keywords acts a bit differently.  Calling it in a list context
+# returns the list of keywords.  
+# Calling it in a scalar context gives you the size of the list.
+####
+'keywords' => <<'END_OF_FUNC',
+sub keywords {
+    my($self,@values) = self_or_default(@_);
+    # If values is provided, then we set it.
+    $self->{param}{'keywords'}=[@values] if @values;
+    my(@result) = defined($self->{param}{'keywords'}) ? @{$self->{param}{'keywords'}} : ();
+    @result;
+}
+END_OF_FUNC
+
+# These are some tie() interfaces for compatibility
+# with Steve Brenner's cgi-lib.pl routines
+'Vars' => <<'END_OF_FUNC',
+sub Vars {
+    my $q = shift;
+    my %in;
+    tie(%in,CGI,$q);
+    return %in if wantarray;
+    return \%in;
+}
+END_OF_FUNC
+
+# These are some tie() interfaces for compatibility
+# with Steve Brenner's cgi-lib.pl routines
+'ReadParse' => <<'END_OF_FUNC',
+sub ReadParse {
+    local(*in);
+    if (@_) {
+       *in = $_[0];
+    } else {
+       my $pkg = caller();
+       *in=*{"${pkg}::in"};
+    }
+    tie(%in,CGI);
+    return scalar(keys %in);
+}
+END_OF_FUNC
+
+'PrintHeader' => <<'END_OF_FUNC',
+sub PrintHeader {
+    my($self) = self_or_default(@_);
+    return $self->header();
+}
+END_OF_FUNC
+
+'HtmlTop' => <<'END_OF_FUNC',
+sub HtmlTop {
+    my($self,@p) = self_or_default(@_);
+    return $self->start_html(@p);
+}
+END_OF_FUNC
+
+'HtmlBot' => <<'END_OF_FUNC',
+sub HtmlBot {
+    my($self,@p) = self_or_default(@_);
+    return $self->end_html(@p);
+}
+END_OF_FUNC
+
+'SplitParam' => <<'END_OF_FUNC',
+sub SplitParam {
+    my ($param) = @_;
+    my (@params) = split ("\0", $param);
+    return (wantarray ? @params : $params[0]);
+}
+END_OF_FUNC
+
+'MethGet' => <<'END_OF_FUNC',
+sub MethGet {
+    return request_method() eq 'GET';
+}
+END_OF_FUNC
+
+'MethPost' => <<'END_OF_FUNC',
+sub MethPost {
+    return request_method() eq 'POST';
+}
+END_OF_FUNC
+
+'MethPut' => <<'END_OF_FUNC',
+sub MethPut {
+    return request_method() eq 'PUT';
+}
+END_OF_FUNC
+
+'TIEHASH' => <<'END_OF_FUNC',
+sub TIEHASH {
+    my $class = shift;
+    my $arg   = $_[0];
+    if (ref($arg) && UNIVERSAL::isa($arg,'CGI')) {
+       return $arg;
+    }
+    return $Q ||= $class->new(@_);
+}
+END_OF_FUNC
+
+'STORE' => <<'END_OF_FUNC',
+sub STORE {
+    my $self = shift;
+    my $tag  = shift;
+    my $vals = shift;
+    my @vals = index($vals,"\0")!=-1 ? split("\0",$vals) : $vals;
+    $self->param(-name=>$tag,-value=>\@vals);
+}
+END_OF_FUNC
+
+'FETCH' => <<'END_OF_FUNC',
+sub FETCH {
+    return $_[0] if $_[1] eq 'CGI';
+    return undef unless defined $_[0]->param($_[1]);
+    return join("\0",$_[0]->param($_[1]));
+}
+END_OF_FUNC
+
+'FIRSTKEY' => <<'END_OF_FUNC',
+sub FIRSTKEY {
+    $_[0]->{'.iterator'}=0;
+    $_[0]->{'.parameters'}->[$_[0]->{'.iterator'}++];
+}
+END_OF_FUNC
+
+'NEXTKEY' => <<'END_OF_FUNC',
+sub NEXTKEY {
+    $_[0]->{'.parameters'}->[$_[0]->{'.iterator'}++];
+}
+END_OF_FUNC
+
+'EXISTS' => <<'END_OF_FUNC',
+sub EXISTS {
+    exists $_[0]->{param}{$_[1]};
+}
+END_OF_FUNC
+
+'DELETE' => <<'END_OF_FUNC',
+sub DELETE {
+    $_[0]->delete($_[1]);
+}
+END_OF_FUNC
+
+'CLEAR' => <<'END_OF_FUNC',
+sub CLEAR {
+    %{$_[0]}=();
+}
+####
+END_OF_FUNC
+
+####
+# Append a new value to an existing query
+####
+'append' => <<'EOF',
+sub append {
+    my($self,@p) = self_or_default(@_);
+    my($name,$value) = rearrange([NAME,[VALUE,VALUES]],@p);
+    my(@values) = defined($value) ? (ref($value) ? @{$value} : $value) : ();
+    if (@values) {
+       $self->add_parameter($name);
+       push(@{$self->{param}{$name}},@values);
+    }
+    return $self->param($name);
+}
+EOF
+
+#### Method: delete_all
+# Delete all parameters
+####
+'delete_all' => <<'EOF',
+sub delete_all {
+    my($self) = self_or_default(@_);
+    my @param = $self->param();
+    $self->delete(@param);
+}
+EOF
+
+'Delete' => <<'EOF',
+sub Delete {
+    my($self,@p) = self_or_default(@_);
+    $self->delete(@p);
+}
+EOF
+
+'Delete_all' => <<'EOF',
+sub Delete_all {
+    my($self,@p) = self_or_default(@_);
+    $self->delete_all(@p);
+}
+EOF
+
+#### Method: autoescape
+# If you want to turn off the autoescaping features,
+# call this method with undef as the argument
+'autoEscape' => <<'END_OF_FUNC',
+sub autoEscape {
+    my($self,$escape) = self_or_default(@_);
+    my $d = $self->{'escape'};
+    $self->{'escape'} = $escape;
+    $d;
+}
+END_OF_FUNC
+
+
+#### Method: version
+# Return the current version
+####
+'version' => <<'END_OF_FUNC',
+sub version {
+    return $VERSION;
+}
+END_OF_FUNC
+
+#### Method: url_param
+# Return a parameter in the QUERY_STRING, regardless of
+# whether this was a POST or a GET
+####
+'url_param' => <<'END_OF_FUNC',
+sub url_param {
+    my ($self,@p) = self_or_default(@_);
+    my $name = shift(@p);
+    return undef unless exists($ENV{QUERY_STRING});
+    unless (exists($self->{'.url_param'})) {
+       $self->{'.url_param'}={}; # empty hash
+       if ($ENV{QUERY_STRING} =~ /=/) {
+           my(@pairs) = split(/[&;]/,$ENV{QUERY_STRING});
+           my($param,$value);
+           for (@pairs) {
+               ($param,$value) = split('=',$_,2);
+               $param = unescape($param);
+               $value = unescape($value);
+               push(@{$self->{'.url_param'}->{$param}},$value);
+           }
+       } else {
+        my @keywords = $self->parse_keywordlist($ENV{QUERY_STRING});
+           $self->{'.url_param'}{'keywords'} = \@keywords if @keywords;
+       }
+    }
+    return keys %{$self->{'.url_param'}} unless defined($name);
+    return () unless $self->{'.url_param'}->{$name};
+    return wantarray ? @{$self->{'.url_param'}->{$name}}
+                     : $self->{'.url_param'}->{$name}->[0];
+}
+END_OF_FUNC
+
+#### Method: Dump
+# Returns a string in which all the known parameter/value 
+# pairs are represented as nested lists, mainly for the purposes 
+# of debugging.
+####
+'Dump' => <<'END_OF_FUNC',
+sub Dump {
+    my($self) = self_or_default(@_);
+    my($param,$value,@result);
+    return '<ul></ul>' unless $self->param;
+    push(@result,"<ul>");
+    for $param ($self->param) {
+       my($name)=$self->_maybe_escapeHTML($param);
+       push(@result,"<li><strong>$name</strong></li>");
+       push(@result,"<ul>");
+       for $value ($self->param($param)) {
+           $value = $self->_maybe_escapeHTML($value);
+            $value =~ s/\n/<br \/>\n/g;
+           push(@result,"<li>$value</li>");
+       }
+       push(@result,"</ul>");
+    }
+    push(@result,"</ul>");
+    return join("\n",@result);
+}
+END_OF_FUNC
+
+#### Method as_string
+#
+# synonym for "dump"
+####
+'as_string' => <<'END_OF_FUNC',
+sub as_string {
+    &Dump(@_);
+}
+END_OF_FUNC
+
+#### Method: save
+# Write values out to a filehandle in such a way that they can
+# be reinitialized by the filehandle form of the new() method
+####
+'save' => <<'END_OF_FUNC',
+sub save {
+    my($self,$filehandle) = self_or_default(@_);
+    $filehandle = to_filehandle($filehandle);
+    my($param);
+    local($,) = '';  # set print field separator back to a sane value
+    local($\) = '';  # set output line separator to a sane value
+    for $param ($self->param) {
+       my($escaped_param) = escape($param);
+       my($value);
+       for $value ($self->param($param)) {
+           print $filehandle "$escaped_param=",escape("$value"),"\n"
+               if length($escaped_param) or length($value);
+       }
+    }
+    for (keys %{$self->{'.fieldnames'}}) {
+          print $filehandle ".cgifields=",escape("$_"),"\n";
+    }
+    print $filehandle "=\n";    # end of record
+}
+END_OF_FUNC
+
+
+#### Method: save_parameters
+# An alias for save() that is a better name for exportation.
+# Only intended to be used with the function (non-OO) interface.
+####
+'save_parameters' => <<'END_OF_FUNC',
+sub save_parameters {
+    my $fh = shift;
+    return save(to_filehandle($fh));
+}
+END_OF_FUNC
+
+#### Method: restore_parameters
+# A way to restore CGI parameters from an initializer.
+# Only intended to be used with the function (non-OO) interface.
+####
+'restore_parameters' => <<'END_OF_FUNC',
+sub restore_parameters {
+    $Q = $CGI::DefaultClass->new(@_);
+}
+END_OF_FUNC
+
+#### Method: multipart_init
+# Return a Content-Type: style header for server-push
+# This has to be NPH on most web servers, and it is advisable to set $| = 1
+#
+# Many thanks to Ed Jordan <ed@fidalgo.net> for this
+# contribution, updated by Andrew Benham (adsb@bigfoot.com)
+####
+'multipart_init' => <<'END_OF_FUNC',
+sub multipart_init {
+    my($self,@p) = self_or_default(@_);
+    my($boundary,@other) = rearrange_header([BOUNDARY],@p);
+    if (!$boundary) {
+        $boundary = '------- =_';
+        my @chrs = ('0'..'9', 'A'..'Z', 'a'..'z');
+        for (1..17) {
+            $boundary .= $chrs[rand(scalar @chrs)];
+        }
+    }
+
+    $self->{'separator'} = "$CRLF--$boundary$CRLF";
+    $self->{'final_separator'} = "$CRLF--$boundary--$CRLF";
+    $type = SERVER_PUSH($boundary);
+    return $self->header(
+       -nph => 0,
+       -type => $type,
+       (map { split "=", $_, 2 } @other),
+    ) . "WARNING: YOUR BROWSER DOESN'T SUPPORT THIS SERVER-PUSH TECHNOLOGY." . $self->multipart_end;
+}
+END_OF_FUNC
+
+
+#### Method: multipart_start
+# Return a Content-Type: style header for server-push, start of section
+#
+# Many thanks to Ed Jordan <ed@fidalgo.net> for this
+# contribution, updated by Andrew Benham (adsb@bigfoot.com)
+####
+'multipart_start' => <<'END_OF_FUNC',
+sub multipart_start {
+    my(@header);
+    my($self,@p) = self_or_default(@_);
+    my($type,@other) = rearrange([TYPE],@p);
+    $type = $type || 'text/html';
+    push(@header,"Content-Type: $type");
+
+    # rearrange() was designed for the HTML portion, so we
+    # need to fix it up a little.
+    for (@other) {
+        # Don't use \s because of perl bug 21951
+        next unless my($header,$value) = /([^ \r\n\t=]+)=\"?(.+?)\"?$/;
+       ($_ = $header) =~ s/^(\w)(.*)/$1 . lc ($2) . ': '.$self->unescapeHTML($value)/e;
+    }
+    push(@header,@other);
+    my $header = join($CRLF,@header)."${CRLF}${CRLF}";
+    return $header;
+}
+END_OF_FUNC
+
+
+#### Method: multipart_end
+# Return a MIME boundary separator for server-push, end of section
+#
+# Many thanks to Ed Jordan <ed@fidalgo.net> for this
+# contribution
+####
+'multipart_end' => <<'END_OF_FUNC',
+sub multipart_end {
+    my($self,@p) = self_or_default(@_);
+    return $self->{'separator'};
+}
+END_OF_FUNC
+
+
+#### Method: multipart_final
+# Return a MIME boundary separator for server-push, end of all sections
+#
+# Contributed by Andrew Benham (adsb@bigfoot.com)
+####
+'multipart_final' => <<'END_OF_FUNC',
+sub multipart_final {
+    my($self,@p) = self_or_default(@_);
+    return $self->{'final_separator'} . "WARNING: YOUR BROWSER DOESN'T SUPPORT THIS SERVER-PUSH TECHNOLOGY." . $CRLF;
+}
+END_OF_FUNC
+
+
+#### Method: header
+# Return a Content-Type: style header
+#
+####
+'header' => <<'END_OF_FUNC',
+sub header {
+    my($self,@p) = self_or_default(@_);
+    my(@header);
+
+    return "" if $self->{'.header_printed'}++ and $HEADERS_ONCE;
+
+    my($type,$status,$cookie,$target,$expires,$nph,$charset,$attachment,$p3p,@other) = 
+       rearrange([['TYPE','CONTENT_TYPE','CONTENT-TYPE'],
+                           'STATUS',['COOKIE','COOKIES'],'TARGET',
+                            'EXPIRES','NPH','CHARSET',
+                            'ATTACHMENT','P3P'],@p);
+
+    # Since $cookie and $p3p may be array references,
+    # we must stringify them before CR escaping is done.
+    my @cookie;
+    for (ref($cookie) eq 'ARRAY' ? @{$cookie} : $cookie) {
+        my $cs = UNIVERSAL::isa($_,'CGI::Cookie') ? $_->as_string : $_;
+        push(@cookie,$cs) if defined $cs and $cs ne '';
+    }
+    $p3p = join ' ',@$p3p if ref($p3p) eq 'ARRAY';
+
+    # CR escaping for values, per RFC 822
+    for my $header ($type,$status,@cookie,$target,$expires,$nph,$charset,$attachment,$p3p,@other) {
+        if (defined $header) {
+            # From RFC 822:
+            # Unfolding  is  accomplished  by regarding   CRLF   immediately
+            # followed  by  a  LWSP-char  as equivalent to the LWSP-char.
+            $header =~ s/$CRLF(\s)/$1/g;
+
+            # All other uses of newlines are invalid input. 
+            if ($header =~ m/$CRLF|\015|\012/) {
+                # shorten very long values in the diagnostic
+                $header = substr($header,0,72).'...' if (length $header > 72);
+                die "Invalid header value contains a newline not followed by whitespace: $header";
+            }
+        } 
+   }
+
+    $nph     ||= $NPH;
+
+    $type ||= 'text/html' unless defined($type);
+
+    # sets if $charset is given, gets if not
+    $charset = $self->charset( $charset );
+
+    # rearrange() was designed for the HTML portion, so we
+    # need to fix it up a little.
+    for (@other) {
+        # Don't use \s because of perl bug 21951
+        next unless my($header,$value) = /([^ \r\n\t=]+)=\"?(.+?)\"?$/s;
+        ($_ = $header) =~ s/^(\w)(.*)/"\u$1\L$2" . ': '.$self->unescapeHTML($value)/e;
+    }
+
+    $type .= "; charset=$charset"
+      if     $type ne ''
+         and $type !~ /\bcharset\b/
+         and defined $charset
+         and $charset ne '';
+
+    # Maybe future compatibility.  Maybe not.
+    my $protocol = $ENV{SERVER_PROTOCOL} || 'HTTP/1.0';
+    push(@header,$protocol . ' ' . ($status || '200 OK')) if $nph;
+    push(@header,"Server: " . &server_software()) if $nph;
+
+    push(@header,"Status: $status") if $status;
+    push(@header,"Window-Target: $target") if $target;
+    push(@header,"P3P: policyref=\"/w3c/p3p.xml\", CP=\"$p3p\"") if $p3p;
+    # push all the cookies -- there may be several
+    push(@header,map {"Set-Cookie: $_"} @cookie);
+    # if the user indicates an expiration time, then we need
+    # both an Expires and a Date header (so that the browser is
+    # uses OUR clock)
+    push(@header,"Expires: " . expires($expires,'http'))
+       if $expires;
+    push(@header,"Date: " . expires(0,'http')) if $expires || $cookie || $nph;
+    push(@header,"Pragma: no-cache") if $self->cache();
+    push(@header,"Content-Disposition: attachment; filename=\"$attachment\"") if $attachment;
+    push(@header,map {ucfirst $_} @other);
+    push(@header,"Content-Type: $type") if $type ne '';
+    my $header = join($CRLF,@header)."${CRLF}${CRLF}";
+    if (($MOD_PERL >= 1) && !$nph) {
+        $self->r->send_cgi_header($header);
+        return '';
+    }
+    return $header;
+}
+END_OF_FUNC
+
+#### Method: cache
+# Control whether header() will produce the no-cache
+# Pragma directive.
+####
+'cache' => <<'END_OF_FUNC',
+sub cache {
+    my($self,$new_value) = self_or_default(@_);
+    $new_value = '' unless $new_value;
+    if ($new_value ne '') {
+       $self->{'cache'} = $new_value;
+    }
+    return $self->{'cache'};
+}
+END_OF_FUNC
+
+
+#### Method: redirect
+# Return a Location: style header
+#
+####
+'redirect' => <<'END_OF_FUNC',
+sub redirect {
+    my($self,@p) = self_or_default(@_);
+    my($url,$target,$status,$cookie,$nph,@other) = 
+         rearrange([[LOCATION,URI,URL],TARGET,STATUS,['COOKIE','COOKIES'],NPH],@p);
+    $status = '302 Found' unless defined $status;
+    $url ||= $self->self_url;
+    my(@o);
+    for (@other) { tr/\"//d; push(@o,split("=",$_,2)); }
+    unshift(@o,
+        '-Status'  => $status,
+        '-Location'=> $url,
+        '-nph'     => $nph);
+    unshift(@o,'-Target'=>$target) if $target;
+    unshift(@o,'-Type'=>'');
+    my @unescaped;
+    unshift(@unescaped,'-Cookie'=>$cookie) if $cookie;
+    return $self->header((map {$self->unescapeHTML($_)} @o),@unescaped);
+}
+END_OF_FUNC
+
+
+#### Method: start_html
+# Canned HTML header
+#
+# Parameters:
+# $title -> (optional) The title for this HTML document (-title)
+# $author -> (optional) e-mail address of the author (-author)
+# $base -> (optional) if set to true, will enter the BASE address of this document
+#          for resolving relative references (-base) 
+# $xbase -> (optional) alternative base at some remote location (-xbase)
+# $target -> (optional) target window to load all links into (-target)
+# $script -> (option) Javascript code (-script)
+# $no_script -> (option) Javascript <noscript> tag (-noscript)
+# $meta -> (optional) Meta information tags
+# $head -> (optional) any other elements you'd like to incorporate into the <head> tag
+#           (a scalar or array ref)
+# $style -> (optional) reference to an external style sheet
+# @other -> (optional) any other named parameters you'd like to incorporate into
+#           the <body> tag.
+####
+'start_html' => <<'END_OF_FUNC',
+sub start_html {
+    my($self,@p) = &self_or_default(@_);
+    my($title,$author,$base,$xbase,$script,$noscript,
+        $target,$meta,$head,$style,$dtd,$lang,$encoding,$declare_xml,@other) = 
+       rearrange([TITLE,AUTHOR,BASE,XBASE,SCRIPT,NOSCRIPT,TARGET,
+                   META,HEAD,STYLE,DTD,LANG,ENCODING,DECLARE_XML],@p);
+
+    $self->element_id(0);
+    $self->element_tab(0);
+
+    $encoding = lc($self->charset) unless defined $encoding;
+
+    # Need to sort out the DTD before it's okay to call escapeHTML().
+    my(@result,$xml_dtd);
+    if ($dtd) {
+        if (defined(ref($dtd)) and (ref($dtd) eq 'ARRAY')) {
+            $dtd = $DEFAULT_DTD unless $dtd->[0] =~ m|^-//|;
+        } else {
+            $dtd = $DEFAULT_DTD unless $dtd =~ m|^-//|;
+        }
+    } else {
+        $dtd = $XHTML ? XHTML_DTD : $DEFAULT_DTD;
+    }
+
+    $xml_dtd++ if ref($dtd) eq 'ARRAY' && $dtd->[0] =~ /\bXHTML\b/i;
+    $xml_dtd++ if ref($dtd) eq '' && $dtd =~ /\bXHTML\b/i;
+    push @result,qq(<?xml version="1.0" encoding="$encoding"?>) if $xml_dtd && $declare_xml;
+
+    if (ref($dtd) && ref($dtd) eq 'ARRAY') {
+        push(@result,qq(<!DOCTYPE html\n\tPUBLIC "$dtd->[0]"\n\t "$dtd->[1]">));
+       $DTD_PUBLIC_IDENTIFIER = $dtd->[0];
+    } else {
+        push(@result,qq(<!DOCTYPE html\n\tPUBLIC "$dtd">));
+       $DTD_PUBLIC_IDENTIFIER = $dtd;
+    }
+
+    # Now that we know whether we're using the HTML 3.2 DTD or not, it's okay to
+    # call escapeHTML().  Strangely enough, the title needs to be escaped as
+    # HTML while the author needs to be escaped as a URL.
+    $title = $self->_maybe_escapeHTML($title || 'Untitled Document');
+    $author = $self->escape($author);
+
+    if ($DTD_PUBLIC_IDENTIFIER =~ /[^X]HTML (2\.0|3\.2|4\.01?)/i) {
+       $lang = "" unless defined $lang;
+       $XHTML = 0;
+    }
+    else {
+       $lang = 'en-US' unless defined $lang;
+    }
+
+    my $lang_bits = $lang ne '' ? qq( lang="$lang" xml:lang="$lang") : '';
+    my $meta_bits = qq(<meta http-equiv="Content-Type" content="text/html; charset=$encoding" />) 
+                    if $XHTML && $encoding && !$declare_xml;
+
+    push(@result,$XHTML ? qq(<html xmlns="http://www.w3.org/1999/xhtml"$lang_bits>\n<head>\n<title>$title</title>)
+                        : ($lang ? qq(<html lang="$lang">) : "<html>")
+                         . "<head><title>$title</title>");
+       if (defined $author) {
+    push(@result,$XHTML ? "<link rev=\"made\" href=\"mailto:$author\" />"
+                       : "<link rev=\"made\" href=\"mailto:$author\">");
+       }
+
+    if ($base || $xbase || $target) {
+       my $href = $xbase || $self->url('-path'=>1);
+       my $t = $target ? qq/ target="$target"/ : '';
+       push(@result,$XHTML ? qq(<base href="$href"$t />) : qq(<base href="$href"$t>));
+    }
+
+    if ($meta && ref($meta) && (ref($meta) eq 'HASH')) {
+       for (keys %$meta) { push(@result,$XHTML ? qq(<meta name="$_" content="$meta->{$_}" />) 
+                       : qq(<meta name="$_" content="$meta->{$_}">)); }
+    }
+
+    my $meta_bits_set = 0;
+    if( $head ) {
+        if( ref $head ) {
+            push @result, @$head;
+            $meta_bits_set = 1 if grep { /http-equiv=["']Content-Type/i }@$head;
+        }
+        else {
+            push @result, $head;
+            $meta_bits_set = 1 if $head =~ /http-equiv=["']Content-Type/i;
+        }
+    }
+
+    # handle the infrequently-used -style and -script parameters
+    push(@result,$self->_style($style))   if defined $style;
+    push(@result,$self->_script($script)) if defined $script;
+    push(@result,$meta_bits)              if defined $meta_bits and !$meta_bits_set;
+
+    # handle -noscript parameter
+    push(@result,<<END) if $noscript;
+<noscript>
+$noscript
+</noscript>
+END
+    ;
+    my($other) = @other ? " @other" : '';
+    push(@result,"</head>\n<body$other>\n");
+    return join("\n",@result);
+}
+END_OF_FUNC
+
+### Method: _style
+# internal method for generating a CSS style section
+####
+'_style' => <<'END_OF_FUNC',
+sub _style {
+    my ($self,$style) = @_;
+    my (@result);
+
+    my $type = 'text/css';
+    my $rel  = 'stylesheet';
+
+
+    my $cdata_start = $XHTML ? "\n<!--/* <![CDATA[ */" : "\n<!-- ";
+    my $cdata_end   = $XHTML ? "\n/* ]]> */-->\n" : " -->\n";
+
+    my @s = ref($style) eq 'ARRAY' ? @$style : $style;
+    my $other = '';
+
+    for my $s (@s) {
+      if (ref($s)) {
+       my($src,$code,$verbatim,$stype,$alternate,$foo,@other) =
+           rearrange([qw(SRC CODE VERBATIM TYPE ALTERNATE FOO)],
+                      ('-foo'=>'bar',
+                       ref($s) eq 'ARRAY' ? @$s : %$s));
+       my $type = defined $stype ? $stype : 'text/css';
+       my $rel  = $alternate ? 'alternate stylesheet' : 'stylesheet';
+       $other = "@other" if @other;
+
+       if (ref($src) eq "ARRAY") # Check to see if the $src variable is an array reference
+       { # If it is, push a LINK tag for each one
+           for $src (@$src)
+         {
+           push(@result,$XHTML ? qq(<link rel="$rel" type="$type" href="$src" $other/>)
+                             : qq(<link rel="$rel" type="$type" href="$src"$other>)) if $src;
+         }
+       }
+       else
+       { # Otherwise, push the single -src, if it exists.
+         push(@result,$XHTML ? qq(<link rel="$rel" type="$type" href="$src" $other/>)
+                             : qq(<link rel="$rel" type="$type" href="$src"$other>)
+              ) if $src;
+        }
+     if ($verbatim) {
+           my @v = ref($verbatim) eq 'ARRAY' ? @$verbatim : $verbatim;
+           push(@result, "<style type=\"text/css\">\n$_\n</style>") for @v;
+      }
+      my @c = ref($code) eq 'ARRAY' ? @$code : $code if $code;
+      push(@result,style({'type'=>$type},"$cdata_start\n$_\n$cdata_end")) for @c;
+
+      } else {
+           my $src = $s;
+           push(@result,$XHTML ? qq(<link rel="$rel" type="$type" href="$src" $other/>)
+                               : qq(<link rel="$rel" type="$type" href="$src"$other>));
+      }
+    }
+    @result;
+}
+END_OF_FUNC
+
+'_script' => <<'END_OF_FUNC',
+sub _script {
+    my ($self,$script) = @_;
+    my (@result);
+
+    my (@scripts) = ref($script) eq 'ARRAY' ? @$script : ($script);
+    for $script (@scripts) {
+    my($src,$code,$language,$charset);
+    if (ref($script)) { # script is a hash
+        ($src,$code,$type,$charset) =
+        rearrange(['SRC','CODE',['LANGUAGE','TYPE'],'CHARSET'],
+                 '-foo'=>'bar', # a trick to allow the '-' to be omitted
+                 ref($script) eq 'ARRAY' ? @$script : %$script);
+            $type ||= 'text/javascript';
+            unless ($type =~ m!\w+/\w+!) {
+                $type =~ s/[\d.]+$//;
+                $type = "text/$type";
+            }
+    } else {
+        ($src,$code,$type,$charset) = ('',$script, 'text/javascript', '');
+    }
+
+    my $comment = '//';  # javascript by default
+    $comment = '#' if $type=~/perl|tcl/i;
+    $comment = "'" if $type=~/vbscript/i;
+
+    my ($cdata_start,$cdata_end);
+    if ($XHTML) {
+       $cdata_start    = "$comment<![CDATA[\n";
+       $cdata_end     .= "\n$comment]]>";
+    } else {
+       $cdata_start  =  "\n<!-- Hide script\n";
+       $cdata_end    = $comment;
+       $cdata_end   .= " End script hiding -->\n";
+   }
+     my(@satts);
+     push(@satts,'src'=>$src) if $src;
+     push(@satts,'type'=>$type);
+     push(@satts,'charset'=>$charset) if ($src && $charset);
+     $code = $cdata_start . $code . $cdata_end if defined $code;
+     push(@result,$self->script({@satts},$code || ''));
+    }
+    @result;
+}
+END_OF_FUNC
+
+#### Method: end_html
+# End an HTML document.
+# Trivial method for completeness.  Just returns "</body>"
+####
+'end_html' => <<'END_OF_FUNC',
+sub end_html {
+    return "\n</body>\n</html>";
+}
+END_OF_FUNC
+
+
+################################
+# METHODS USED IN BUILDING FORMS
+################################
+
+#### Method: isindex
+# Just prints out the isindex tag.
+# Parameters:
+#  $action -> optional URL of script to run
+# Returns:
+#   A string containing a <isindex> tag
+'isindex' => <<'END_OF_FUNC',
+sub isindex {
+    my($self,@p) = self_or_default(@_);
+    my($action,@other) = rearrange([ACTION],@p);
+    $action = qq/ action="$action"/ if $action;
+    my($other) = @other ? " @other" : '';
+    return $XHTML ? "<isindex$action$other />" : "<isindex$action$other>";
+}
+END_OF_FUNC
+
+
+#### Method: startform
+# This method is DEPRECATED
+# Start a form
+# Parameters:
+#   $method -> optional submission method to use (GET or POST)
+#   $action -> optional URL of script to run
+#   $enctype ->encoding to use (URL_ENCODED or MULTIPART)
+'startform' => <<'END_OF_FUNC',
+sub startform {
+    my($self,@p) = self_or_default(@_);
+
+    my($method,$action,$enctype,@other) = 
+       rearrange([METHOD,ACTION,ENCTYPE],@p);
+
+    $method  = $self->_maybe_escapeHTML(lc($method || 'post'));
+    $enctype = $self->_maybe_escapeHTML($enctype || &URL_ENCODED);
+    if (defined $action) {
+       $action = $self->_maybe_escapeHTML($action);
+    }
+    else {
+       $action = $self->_maybe_escapeHTML($self->request_uri || $self->self_url);
+    }
+    $action = qq(action="$action");
+    my($other) = @other ? " @other" : '';
+    $self->{'.parametersToAdd'}={};
+    return qq/<form method="$method" $action enctype="$enctype"$other>/;
+}
+END_OF_FUNC
+
+#### Method: start_form
+# Start a form
+# Parameters:
+#   $method -> optional submission method to use (GET or POST)
+#   $action -> optional URL of script to run
+#   $enctype ->encoding to use (URL_ENCODED or MULTIPART)
+'start_form' => <<'END_OF_FUNC',
+sub start_form {
+    my($self,@p) = self_or_default(@_);
+
+    my($method,$action,$enctype,@other) = 
+       rearrange([METHOD,ACTION,ENCTYPE],@p);
+
+    $method  = $self->_maybe_escapeHTML(lc($method || 'post'));
+
+    if( $XHTML ){
+        $enctype = $self->_maybe_escapeHTML($enctype || &MULTIPART);
+    }else{
+        $enctype = $self->_maybe_escapeHTML($enctype || &URL_ENCODED);
+    }
+
+    if (defined $action) {
+       $action = $self->_maybe_escapeHTML($action);
+    }
+    else {
+       $action = $self->_maybe_escapeHTML($self->request_uri || $self->self_url);
+    }
+    $action = qq(action="$action");
+    my($other) = @other ? " @other" : '';
+    $self->{'.parametersToAdd'}={};
+    return qq/<form method="$method" $action enctype="$enctype"$other>/;
+}
+END_OF_FUNC
+
+#### Method: start_multipart_form
+'start_multipart_form' => <<'END_OF_FUNC',
+sub start_multipart_form {
+    my($self,@p) = self_or_default(@_);
+    if (defined($p[0]) && substr($p[0],0,1) eq '-') {
+      return $self->start_form(-enctype=>&MULTIPART,@p);
+    } else {
+       my($method,$action,@other) = 
+           rearrange([METHOD,ACTION],@p);
+       return $self->start_form($method,$action,&MULTIPART,@other);
+    }
+}
+END_OF_FUNC
+
+
+
+#### Method: end_form
+# End a form
+# Note: This repeated below under the older name.
+'end_form' => <<'END_OF_FUNC',
+sub end_form {
+    my($self,@p) = self_or_default(@_);
+    if ( $NOSTICKY ) {
+        return wantarray ? ("</form>") : "\n</form>";
+    } else {
+        if (my @fields = $self->get_fields) {
+            return wantarray ? ("<div>",@fields,"</div>","</form>")
+                             : "<div>".(join '',@fields)."</div>\n</form>";
+        } else {
+            return "</form>";
+        }
+    }
+}
+END_OF_FUNC
+
+'endform' => <<'END_OF_FUNC',
+sub endform {
+    my($self,@p) = self_or_default(@_);
+    if ( $NOSTICKY ) {
+        return wantarray ? ("</form>") : "\n</form>";
+    } else {
+        if (my @fields = $self->get_fields) {
+            return wantarray ? ("<div>",@fields,"</div>","</form>")
+                             : "<div>".(join '',@fields)."</div>\n</form>";
+        } else {
+            return "</form>";
+        }
+    }
+}
+END_OF_FUNC
+
+#### Method: end_multipart_form
+# end a multipart form
+'end_multipart_form' => <<'END_OF_FUNC',
+sub end_multipart_form {
+    &end_form;
+}
+END_OF_FUNC
+
+
+'_textfield' => <<'END_OF_FUNC',
+sub _textfield {
+    my($self,$tag,@p) = self_or_default(@_);
+    my($name,$default,$size,$maxlength,$override,$tabindex,@other) = 
+       rearrange([NAME,[DEFAULT,VALUE,VALUES],SIZE,MAXLENGTH,[OVERRIDE,FORCE],TABINDEX],@p);
+
+    my $current = $override ? $default : 
+       (defined($self->param($name)) ? $self->param($name) : $default);
+
+    $current = defined($current) ? $self->_maybe_escapeHTML($current,1) : '';
+    $name = defined($name) ? $self->_maybe_escapeHTML($name) : '';
+    my($s) = defined($size) ? qq/ size="$size"/ : '';
+    my($m) = defined($maxlength) ? qq/ maxlength="$maxlength"/ : '';
+    my($other) = @other ? " @other" : '';
+    # this entered at cristy's request to fix problems with file upload fields
+    # and WebTV -- not sure it won't break stuff
+    my($value) = $current ne '' ? qq(value="$current") : '';
+    $tabindex = $self->element_tab($tabindex);
+    return $XHTML ? qq(<input type="$tag" name="$name" $tabindex$value$s$m$other />) 
+                  : qq(<input type="$tag" name="$name" $value$s$m$other>);
+}
+END_OF_FUNC
+
+#### Method: textfield
+# Parameters:
+#   $name -> Name of the text field
+#   $default -> Optional default value of the field if not
+#                already defined.
+#   $size ->  Optional width of field in characaters.
+#   $maxlength -> Optional maximum number of characters.
+# Returns:
+#   A string containing a <input type="text"> field
+#
+'textfield' => <<'END_OF_FUNC',
+sub textfield {
+    my($self,@p) = self_or_default(@_);
+    $self->_textfield('text',@p);
+}
+END_OF_FUNC
+
+
+#### Method: filefield
+# Parameters:
+#   $name -> Name of the file upload field
+#   $size ->  Optional width of field in characaters.
+#   $maxlength -> Optional maximum number of characters.
+# Returns:
+#   A string containing a <input type="file"> field
+#
+'filefield' => <<'END_OF_FUNC',
+sub filefield {
+    my($self,@p) = self_or_default(@_);
+    $self->_textfield('file',@p);
+}
+END_OF_FUNC
+
+
+#### Method: password
+# Create a "secret password" entry field
+# Parameters:
+#   $name -> Name of the field
+#   $default -> Optional default value of the field if not
+#                already defined.
+#   $size ->  Optional width of field in characters.
+#   $maxlength -> Optional maximum characters that can be entered.
+# Returns:
+#   A string containing a <input type="password"> field
+#
+'password_field' => <<'END_OF_FUNC',
+sub password_field {
+    my ($self,@p) = self_or_default(@_);
+    $self->_textfield('password',@p);
+}
+END_OF_FUNC
+
+#### Method: textarea
+# Parameters:
+#   $name -> Name of the text field
+#   $default -> Optional default value of the field if not
+#                already defined.
+#   $rows ->  Optional number of rows in text area
+#   $columns -> Optional number of columns in text area
+# Returns:
+#   A string containing a <textarea></textarea> tag
+#
+'textarea' => <<'END_OF_FUNC',
+sub textarea {
+    my($self,@p) = self_or_default(@_);
+    my($name,$default,$rows,$cols,$override,$tabindex,@other) =
+       rearrange([NAME,[DEFAULT,VALUE],ROWS,[COLS,COLUMNS],[OVERRIDE,FORCE],TABINDEX],@p);
+
+    my($current)= $override ? $default :
+       (defined($self->param($name)) ? $self->param($name) : $default);
+
+    $name = defined($name) ? $self->_maybe_escapeHTML($name) : '';
+    $current = defined($current) ? $self->_maybe_escapeHTML($current) : '';
+    my($r) = $rows ? qq/ rows="$rows"/ : '';
+    my($c) = $cols ? qq/ cols="$cols"/ : '';
+    my($other) = @other ? " @other" : '';
+    $tabindex = $self->element_tab($tabindex);
+    return qq{<textarea name="$name" $tabindex$r$c$other>$current</textarea>};
+}
+END_OF_FUNC
+
+
+#### Method: button
+# Create a javascript button.
+# Parameters:
+#   $name ->  (optional) Name for the button. (-name)
+#   $value -> (optional) Value of the button when selected (and visible name) (-value)
+#   $onclick -> (optional) Text of the JavaScript to run when the button is
+#                clicked.
+# Returns:
+#   A string containing a <input type="button"> tag
+####
+'button' => <<'END_OF_FUNC',
+sub button {
+    my($self,@p) = self_or_default(@_);
+
+    my($label,$value,$script,$tabindex,@other) = rearrange([NAME,[VALUE,LABEL],
+                                                           [ONCLICK,SCRIPT],TABINDEX],@p);
+
+    $label=$self->_maybe_escapeHTML($label);
+    $value=$self->_maybe_escapeHTML($value,1);
+    $script=$self->_maybe_escapeHTML($script);
+
+    $script ||= '';
+
+    my($name) = '';
+    $name = qq/ name="$label"/ if $label;
+    $value = $value || $label;
+    my($val) = '';
+    $val = qq/ value="$value"/ if $value;
+    $script = qq/ onclick="$script"/ if $script;
+    my($other) = @other ? " @other" : '';
+    $tabindex = $self->element_tab($tabindex);
+    return $XHTML ? qq(<input type="button" $tabindex$name$val$script$other />)
+                  : qq(<input type="button"$name$val$script$other>);
+}
+END_OF_FUNC
+
+
+#### Method: submit
+# Create a "submit query" button.
+# Parameters:
+#   $name ->  (optional) Name for the button.
+#   $value -> (optional) Value of the button when selected (also doubles as label).
+#   $label -> (optional) Label printed on the button(also doubles as the value).
+# Returns:
+#   A string containing a <input type="submit"> tag
+####
+'submit' => <<'END_OF_FUNC',
+sub submit {
+    my($self,@p) = self_or_default(@_);
+
+    my($label,$value,$tabindex,@other) = rearrange([NAME,[VALUE,LABEL],TABINDEX],@p);
+
+    $label=$self->_maybe_escapeHTML($label);
+    $value=$self->_maybe_escapeHTML($value,1);
+
+    my $name = $NOSTICKY ? '' : 'name=".submit" ';
+    $name = qq/name="$label" / if defined($label);
+    $value = defined($value) ? $value : $label;
+    my $val = '';
+    $val = qq/value="$value" / if defined($value);
+    $tabindex = $self->element_tab($tabindex);
+    my($other) = @other ? "@other " : '';
+    return $XHTML ? qq(<input type="submit" $tabindex$name$val$other/>)
+                  : qq(<input type="submit" $name$val$other>);
+}
+END_OF_FUNC
+
+
+#### Method: reset
+# Create a "reset" button.
+# Parameters:
+#   $name -> (optional) Name for the button.
+# Returns:
+#   A string containing a <input type="reset"> tag
+####
+'reset' => <<'END_OF_FUNC',
+sub reset {
+    my($self,@p) = self_or_default(@_);
+    my($label,$value,$tabindex,@other) = rearrange(['NAME',['VALUE','LABEL'],TABINDEX],@p);
+    $label=$self->_maybe_escapeHTML($label);
+    $value=$self->_maybe_escapeHTML($value,1);
+    my ($name) = ' name=".reset"';
+    $name = qq/ name="$label"/ if defined($label);
+    $value = defined($value) ? $value : $label;
+    my($val) = '';
+    $val = qq/ value="$value"/ if defined($value);
+    my($other) = @other ? " @other" : '';
+    $tabindex = $self->element_tab($tabindex);
+    return $XHTML ? qq(<input type="reset" $tabindex$name$val$other />)
+                  : qq(<input type="reset"$name$val$other>);
+}
+END_OF_FUNC
+
+
+#### Method: defaults
+# Create a "defaults" button.
+# Parameters:
+#   $name -> (optional) Name for the button.
+# Returns:
+#   A string containing a <input type="submit" name=".defaults"> tag
+#
+# Note: this button has a special meaning to the initialization script,
+# and tells it to ERASE the current query string so that your defaults
+# are used again!
+####
+'defaults' => <<'END_OF_FUNC',
+sub defaults {
+    my($self,@p) = self_or_default(@_);
+
+    my($label,$tabindex,@other) = rearrange([[NAME,VALUE],TABINDEX],@p);
+
+    $label=$self->_maybe_escapeHTML($label,1);
+    $label = $label || "Defaults";
+    my($value) = qq/ value="$label"/;
+    my($other) = @other ? " @other" : '';
+    $tabindex = $self->element_tab($tabindex);
+    return $XHTML ? qq(<input type="submit" name=".defaults" $tabindex$value$other />)
+                  : qq/<input type="submit" NAME=".defaults"$value$other>/;
+}
+END_OF_FUNC
+
+
+#### Method: comment
+# Create an HTML <!-- comment -->
+# Parameters: a string
+'comment' => <<'END_OF_FUNC',
+sub comment {
+    my($self,@p) = self_or_CGI(@_);
+    return "<!-- @p -->";
+}
+END_OF_FUNC
+
+#### Method: checkbox
+# Create a checkbox that is not logically linked to any others.
+# The field value is "on" when the button is checked.
+# Parameters:
+#   $name -> Name of the checkbox
+#   $checked -> (optional) turned on by default if true
+#   $value -> (optional) value of the checkbox, 'on' by default
+#   $label -> (optional) a user-readable label printed next to the box.
+#             Otherwise the checkbox name is used.
+# Returns:
+#   A string containing a <input type="checkbox"> field
+####
+'checkbox' => <<'END_OF_FUNC',
+sub checkbox {
+    my($self,@p) = self_or_default(@_);
+
+    my($name,$checked,$value,$label,$labelattributes,$override,$tabindex,@other) =
+       rearrange([NAME,[CHECKED,SELECTED,ON],VALUE,LABEL,LABELATTRIBUTES,
+                   [OVERRIDE,FORCE],TABINDEX],@p);
+
+    $value = defined $value ? $value : 'on';
+
+    if (!$override && ($self->{'.fieldnames'}->{$name} || 
+                      defined $self->param($name))) {
+       $checked = grep($_ eq $value,$self->param($name)) ? $self->_checked(1) : '';
+    } else {
+       $checked = $self->_checked($checked);
+    }
+    my($the_label) = defined $label ? $label : $name;
+    $name = $self->_maybe_escapeHTML($name);
+    $value = $self->_maybe_escapeHTML($value,1);
+    $the_label = $self->_maybe_escapeHTML($the_label);
+    my($other) = @other ? "@other " : '';
+    $tabindex = $self->element_tab($tabindex);
+    $self->register_parameter($name);
+    return $XHTML ? CGI::label($labelattributes,
+                    qq{<input type="checkbox" name="$name" value="$value" $tabindex$checked$other/>$the_label})
+                  : qq{<input type="checkbox" name="$name" value="$value"$checked$other>$the_label};
+}
+END_OF_FUNC
+
+
+
+# Escape HTML
+'escapeHTML' => <<'END_OF_FUNC',
+sub escapeHTML {
+     # hack to work around  earlier hacks
+     push @_,$_[0] if @_==1 && $_[0] eq 'CGI';
+     my ($self,$toencode,$newlinestoo) = CGI::self_or_default(@_);
+     return undef unless defined($toencode);
+     $toencode =~ s{&}{&amp;}gso;
+     $toencode =~ s{<}{&lt;}gso;
+     $toencode =~ s{>}{&gt;}gso;
+     if ($DTD_PUBLIC_IDENTIFIER =~ /[^X]HTML 3\.2/i) {
+     # $quot; was accidentally omitted from the HTML 3.2 DTD -- see
+     # <http://validator.w3.org/docs/errors.html#bad-entity> /
+     # <http://lists.w3.org/Archives/Public/www-html/1997Mar/0003.html>.
+        $toencode =~ s{"}{&#34;}gso;
+     }
+     else {
+        $toencode =~ s{"}{&quot;}gso;
+     }
+
+    # Handle bug in some browsers with Latin charsets
+    if ($self->{'.charset'} 
+            && (uc($self->{'.charset'}) eq 'ISO-8859-1' 
+            || uc($self->{'.charset'}) eq 'WINDOWS-1252')) {
+                $toencode =~ s{'}{&#39;}gso;
+                $toencode =~ s{\x8b}{&#8249;}gso;
+                $toencode =~ s{\x9b}{&#8250;}gso;
+        if (defined $newlinestoo && $newlinestoo) {
+            $toencode =~ s{\012}{&#10;}gso;
+            $toencode =~ s{\015}{&#13;}gso;
+        }
+    }
+    return $toencode;
+}
+END_OF_FUNC
+
+# unescape HTML -- used internally
+'unescapeHTML' => <<'END_OF_FUNC',
+sub unescapeHTML {
+    # hack to work around  earlier hacks
+    push @_,$_[0] if @_==1 && $_[0] eq 'CGI';
+    my ($self,$string) = CGI::self_or_default(@_);
+    return undef unless defined($string);
+    my $latin = defined $self->{'.charset'} ? $self->{'.charset'} =~ /^(ISO-8859-1|WINDOWS-1252)$/i
+                                            : 1;
+    # thanks to Randal Schwartz for the correct solution to this one
+    $string=~ s[&([^\s&]*?);]{
+       local $_ = $1;
+       /^amp$/i        ? "&" :
+       /^quot$/i       ? '"' :
+        /^gt$/i                ? ">" :
+       /^lt$/i         ? "<" :
+       /^#(\d+)$/ && $latin         ? chr($1) :
+       /^#x([0-9a-f]+)$/i && $latin ? chr(hex($1)) :
+       "&$_;"
+       }gex;
+    return $string;
+}
+END_OF_FUNC
+
+# Internal procedure - don't use
+'_tableize' => <<'END_OF_FUNC',
+sub _tableize {
+    my($rows,$columns,$rowheaders,$colheaders,@elements) = @_;
+    my @rowheaders = $rowheaders ? @$rowheaders : ();
+    my @colheaders = $colheaders ? @$colheaders : ();
+    my($result);
+
+    if (defined($columns)) {
+       $rows = int(0.99 + @elements/$columns) unless defined($rows);
+    }
+    if (defined($rows)) {
+       $columns = int(0.99 + @elements/$rows) unless defined($columns);
+    }
+
+    # rearrange into a pretty table
+    $result = "<table>";
+    my($row,$column);
+    unshift(@colheaders,'') if @colheaders && @rowheaders;
+    $result .= "<tr>" if @colheaders;
+    for (@colheaders) {
+       $result .= "<th>$_</th>";
+    }
+    for ($row=0;$row<$rows;$row++) {
+       $result .= "<tr>";
+       $result .= "<th>$rowheaders[$row]</th>" if @rowheaders;
+       for ($column=0;$column<$columns;$column++) {
+           $result .= "<td>" . $elements[$column*$rows + $row] . "</td>"
+               if defined($elements[$column*$rows + $row]);
+       }
+       $result .= "</tr>";
+    }
+    $result .= "</table>";
+    return $result;
+}
+END_OF_FUNC
+
+
+#### Method: radio_group
+# Create a list of logically-linked radio buttons.
+# Parameters:
+#   $name -> Common name for all the buttons.
+#   $values -> A pointer to a regular array containing the
+#             values for each button in the group.
+#   $default -> (optional) Value of the button to turn on by default.  Pass '-'
+#               to turn _nothing_ on.
+#   $linebreak -> (optional) Set to true to place linebreaks
+#             between the buttons.
+#   $labels -> (optional)
+#             A pointer to a hash of labels to print next to each checkbox
+#             in the form $label{'value'}="Long explanatory label".
+#             Otherwise the provided values are used as the labels.
+# Returns:
+#   An ARRAY containing a series of <input type="radio"> fields
+####
+'radio_group' => <<'END_OF_FUNC',
+sub radio_group {
+    my($self,@p) = self_or_default(@_);
+   $self->_box_group('radio',@p);
+}
+END_OF_FUNC
+
+#### Method: checkbox_group
+# Create a list of logically-linked checkboxes.
+# Parameters:
+#   $name -> Common name for all the check boxes
+#   $values -> A pointer to a regular array containing the
+#             values for each checkbox in the group.
+#   $defaults -> (optional)
+#             1. If a pointer to a regular array of checkbox values,
+#             then this will be used to decide which
+#             checkboxes to turn on by default.
+#             2. If a scalar, will be assumed to hold the
+#             value of a single checkbox in the group to turn on. 
+#   $linebreak -> (optional) Set to true to place linebreaks
+#             between the buttons.
+#   $labels -> (optional)
+#             A pointer to a hash of labels to print next to each checkbox
+#             in the form $label{'value'}="Long explanatory label".
+#             Otherwise the provided values are used as the labels.
+# Returns:
+#   An ARRAY containing a series of <input type="checkbox"> fields
+####
+
+'checkbox_group' => <<'END_OF_FUNC',
+sub checkbox_group {
+    my($self,@p) = self_or_default(@_);
+   $self->_box_group('checkbox',@p);
+}
+END_OF_FUNC
+
+'_box_group' => <<'END_OF_FUNC',
+sub _box_group {
+    my $self     = shift;
+    my $box_type = shift;
+
+    my($name,$values,$defaults,$linebreak,$labels,$labelattributes,
+       $attributes,$rows,$columns,$rowheaders,$colheaders,
+       $override,$nolabels,$tabindex,$disabled,@other) =
+        rearrange([NAME,[VALUES,VALUE],[DEFAULT,DEFAULTS],LINEBREAK,LABELS,LABELATTRIBUTES,
+                       ATTRIBUTES,ROWS,[COLUMNS,COLS],[ROWHEADERS,ROWHEADER],[COLHEADERS,COLHEADER],
+                       [OVERRIDE,FORCE],NOLABELS,TABINDEX,DISABLED
+                  ],@_);
+
+
+    my($result,$checked,@elements,@values);
+
+    @values = $self->_set_values_and_labels($values,\$labels,$name);
+    my %checked = $self->previous_or_default($name,$defaults,$override);
+
+    # If no check array is specified, check the first by default
+    $checked{$values[0]}++ if $box_type eq 'radio' && !%checked;
+
+    $name=$self->_maybe_escapeHTML($name);
+
+    my %tabs = ();
+    if ($TABINDEX && $tabindex) {
+      if (!ref $tabindex) {
+          $self->element_tab($tabindex);
+      } elsif (ref $tabindex eq 'ARRAY') {
+          %tabs = map {$_=>$self->element_tab} @$tabindex;
+      } elsif (ref $tabindex eq 'HASH') {
+          %tabs = %$tabindex;
+      }
+    }
+    %tabs = map {$_=>$self->element_tab} @values unless %tabs;
+    my $other = @other ? "@other " : '';
+    my $radio_checked;
+
+    # for disabling groups of radio/checkbox buttons
+    my %disabled;
+    for (@{$disabled}) {
+       $disabled{$_}=1;
+    }
+
+    for (@values) {
+        my $disable="";
+        if ($disabled{$_}) {
+               $disable="disabled='1'";
+        }
+
+        my $checkit = $self->_checked($box_type eq 'radio' ? ($checked{$_} && !$radio_checked++)
+                                                           : $checked{$_});
+       my($break);
+       if ($linebreak) {
+          $break = $XHTML ? "<br />" : "<br>";
+       }
+       else {
+         $break = '';
+       }
+       my($label)='';
+       unless (defined($nolabels) && $nolabels) {
+           $label = $_;
+           $label = $labels->{$_} if defined($labels) && defined($labels->{$_});
+           $label = $self->_maybe_escapeHTML($label,1);
+            $label = "<span style=\"color:gray\">$label</span>" if $disabled{$_};
+       }
+        my $attribs = $self->_set_attributes($_, $attributes);
+        my $tab     = $tabs{$_};
+       $_=$self->_maybe_escapeHTML($_);
+
+        if ($XHTML) {
+           push @elements,
+              CGI::label($labelattributes,
+                   qq(<input type="$box_type" name="$name" value="$_" $checkit$other$tab$attribs$disable/>$label)).${break};
+        } else {
+            push(@elements,qq/<input type="$box_type" name="$name" value="$_" $checkit$other$tab$attribs$disable>${label}${break}/);
+        }
+    }
+    $self->register_parameter($name);
+    return wantarray ? @elements : "@elements"
+           unless defined($columns) || defined($rows);
+    return _tableize($rows,$columns,$rowheaders,$colheaders,@elements);
+}
+END_OF_FUNC
+
+
+#### Method: popup_menu
+# Create a popup menu.
+# Parameters:
+#   $name -> Name for all the menu
+#   $values -> A pointer to a regular array containing the
+#             text of each menu item.
+#   $default -> (optional) Default item to display
+#   $labels -> (optional)
+#             A pointer to a hash of labels to print next to each checkbox
+#             in the form $label{'value'}="Long explanatory label".
+#             Otherwise the provided values are used as the labels.
+# Returns:
+#   A string containing the definition of a popup menu.
+####
+'popup_menu' => <<'END_OF_FUNC',
+sub popup_menu {
+    my($self,@p) = self_or_default(@_);
+
+    my($name,$values,$default,$labels,$attributes,$override,$tabindex,@other) =
+       rearrange([NAME,[VALUES,VALUE],[DEFAULT,DEFAULTS],LABELS,
+       ATTRIBUTES,[OVERRIDE,FORCE],TABINDEX],@p);
+    my($result,%selected);
+
+    if (!$override && defined($self->param($name))) {
+       $selected{$self->param($name)}++;
+    } elsif (defined $default) {
+       %selected = map {$_=>1} ref($default) eq 'ARRAY' 
+                                ? @$default 
+                                : $default;
+    }
+    $name=$self->_maybe_escapeHTML($name);
+    my($other) = @other ? " @other" : '';
+
+    my(@values);
+    @values = $self->_set_values_and_labels($values,\$labels,$name);
+    $tabindex = $self->element_tab($tabindex);
+    $name = q{} if ! defined $name;
+    $result = qq/<select name="$name" $tabindex$other>\n/;
+    for (@values) {
+        if (/<optgroup/) {
+            for my $v (split(/\n/)) {
+                my $selectit = $XHTML ? 'selected="selected"' : 'selected';
+               for my $selected (keys %selected) {
+                   $v =~ s/(value="\Q$selected\E")/$selectit $1/;
+               }
+                $result .= "$v\n";
+            }
+        }
+        else {
+          my $attribs   = $self->_set_attributes($_, $attributes);
+         my($selectit) = $self->_selected($selected{$_});
+         my($label)    = $_;
+         $label        = $labels->{$_} if defined($labels) && defined($labels->{$_});
+         my($value)    = $self->_maybe_escapeHTML($_);
+         $label        = $self->_maybe_escapeHTML($label,1);
+          $result      .= "<option${attribs} ${selectit}value=\"$value\">$label</option>\n";
+        }
+    }
+
+    $result .= "</select>";
+    return $result;
+}
+END_OF_FUNC
+
+
+#### Method: optgroup
+# Create a optgroup.
+# Parameters:
+#   $name -> Label for the group
+#   $values -> A pointer to a regular array containing the
+#              values for each option line in the group.
+#   $labels -> (optional)
+#              A pointer to a hash of labels to print next to each item
+#              in the form $label{'value'}="Long explanatory label".
+#              Otherwise the provided values are used as the labels.
+#   $labeled -> (optional)
+#               A true value indicates the value should be used as the label attribute
+#               in the option elements.
+#               The label attribute specifies the option label presented to the user.
+#               This defaults to the content of the <option> element, but the label
+#               attribute allows authors to more easily use optgroup without sacrificing
+#               compatibility with browsers that do not support option groups.
+#   $novals -> (optional)
+#              A true value indicates to suppress the val attribute in the option elements
+# Returns:
+#   A string containing the definition of an option group.
+####
+'optgroup' => <<'END_OF_FUNC',
+sub optgroup {
+    my($self,@p) = self_or_default(@_);
+    my($name,$values,$attributes,$labeled,$noval,$labels,@other)
+        = rearrange([NAME,[VALUES,VALUE],ATTRIBUTES,LABELED,NOVALS,LABELS],@p);
+
+    my($result,@values);
+    @values = $self->_set_values_and_labels($values,\$labels,$name,$labeled,$novals);
+    my($other) = @other ? " @other" : '';
+
+    $name = $self->_maybe_escapeHTML($name) || q{};
+    $result = qq/<optgroup label="$name"$other>\n/;
+    for (@values) {
+        if (/<optgroup/) {
+            for (split(/\n/)) {
+                my $selectit = $XHTML ? 'selected="selected"' : 'selected';
+                s/(value="$selected")/$selectit $1/ if defined $selected;
+                $result .= "$_\n";
+            }
+        }
+        else {
+            my $attribs = $self->_set_attributes($_, $attributes);
+            my($label) = $_;
+            $label = $labels->{$_} if defined($labels) && defined($labels->{$_});
+            $label=$self->_maybe_escapeHTML($label);
+            my($value)=$self->_maybe_escapeHTML($_,1);
+            $result .= $labeled ? $novals ? "<option$attribs label=\"$value\">$label</option>\n"
+                                          : "<option$attribs label=\"$value\" value=\"$value\">$label</option>\n"
+                                : $novals ? "<option$attribs>$label</option>\n"
+                                          : "<option$attribs value=\"$value\">$label</option>\n";
+        }
+    }
+    $result .= "</optgroup>";
+    return $result;
+}
+END_OF_FUNC
+
+
+#### Method: scrolling_list
+# Create a scrolling list.
+# Parameters:
+#   $name -> name for the list
+#   $values -> A pointer to a regular array containing the
+#             values for each option line in the list.
+#   $defaults -> (optional)
+#             1. If a pointer to a regular array of options,
+#             then this will be used to decide which
+#             lines to turn on by default.
+#             2. Otherwise holds the value of the single line to turn on.
+#   $size -> (optional) Size of the list.
+#   $multiple -> (optional) If set, allow multiple selections.
+#   $labels -> (optional)
+#             A pointer to a hash of labels to print next to each checkbox
+#             in the form $label{'value'}="Long explanatory label".
+#             Otherwise the provided values are used as the labels.
+# Returns:
+#   A string containing the definition of a scrolling list.
+####
+'scrolling_list' => <<'END_OF_FUNC',
+sub scrolling_list {
+    my($self,@p) = self_or_default(@_);
+    my($name,$values,$defaults,$size,$multiple,$labels,$attributes,$override,$tabindex,@other)
+       = rearrange([NAME,[VALUES,VALUE],[DEFAULTS,DEFAULT],
+          SIZE,MULTIPLE,LABELS,ATTRIBUTES,[OVERRIDE,FORCE],TABINDEX],@p);
+
+    my($result,@values);
+    @values = $self->_set_values_and_labels($values,\$labels,$name);
+
+    $size = $size || scalar(@values);
+
+    my(%selected) = $self->previous_or_default($name,$defaults,$override);
+
+    my($is_multiple) = $multiple ? qq/ multiple="multiple"/ : '';
+    my($has_size) = $size ? qq/ size="$size"/: '';
+    my($other) = @other ? " @other" : '';
+
+    $name=$self->_maybe_escapeHTML($name);
+    $tabindex = $self->element_tab($tabindex);
+    $result = qq/<select name="$name" $tabindex$has_size$is_multiple$other>\n/;
+    for (@values) {
+        if (/<optgroup/) {
+            for my $v (split(/\n/)) {
+                my $selectit = $XHTML ? 'selected="selected"' : 'selected';
+               for my $selected (keys %selected) {
+                   $v =~ s/(value="$selected")/$selectit $1/;
+               }
+                $result .= "$v\n";
+            }
+        }
+        else {
+          my $attribs   = $self->_set_attributes($_, $attributes);
+         my($selectit) = $self->_selected($selected{$_});
+         my($label)    = $_;
+         $label        = $labels->{$_} if defined($labels) && defined($labels->{$_});
+         my($value)    = $self->_maybe_escapeHTML($_);
+         $label        = $self->_maybe_escapeHTML($label,1);
+          $result      .= "<option${attribs} ${selectit}value=\"$value\">$label</option>\n";
+        }
+    }
+
+    $result .= "</select>";
+    $self->register_parameter($name);
+    return $result;
+}
+END_OF_FUNC
+
+
+#### Method: hidden
+# Parameters:
+#   $name -> Name of the hidden field
+#   @default -> (optional) Initial values of field (may be an array)
+#      or
+#   $default->[initial values of field]
+# Returns:
+#   A string containing a <input type="hidden" name="name" value="value">
+####
+'hidden' => <<'END_OF_FUNC',
+sub hidden {
+    my($self,@p) = self_or_default(@_);
+
+    # this is the one place where we departed from our standard
+    # calling scheme, so we have to special-case (darn)
+    my(@result,@value);
+    my($name,$default,$override,@other) = 
+       rearrange([NAME,[DEFAULT,VALUE,VALUES],[OVERRIDE,FORCE]],@p);
+
+    my $do_override = 0;
+    if ( ref($p[0]) || substr($p[0],0,1) eq '-') {
+       @value = ref($default) ? @{$default} : $default;
+       $do_override = $override;
+    } else {
+       for ($default,$override,@other) {
+           push(@value,$_) if defined($_);
+       }
+        undef @other;
+    }
+
+    # use previous values if override is not set
+    my @prev = $self->param($name);
+    @value = @prev if !$do_override && @prev;
+
+    $name=$self->_maybe_escapeHTML($name);
+    for (@value) {
+       $_ = defined($_) ? $self->_maybe_escapeHTML($_,1) : '';
+       push @result,$XHTML ? qq(<input type="hidden" name="$name" value="$_" @other />)
+                            : qq(<input type="hidden" name="$name" value="$_" @other>);
+    }
+    return wantarray ? @result : join('',@result);
+}
+END_OF_FUNC
+
+
+#### Method: image_button
+# Parameters:
+#   $name -> Name of the button
+#   $src ->  URL of the image source
+#   $align -> Alignment style (TOP, BOTTOM or MIDDLE)
+# Returns:
+#   A string containing a <input type="image" name="name" src="url" align="alignment">
+####
+'image_button' => <<'END_OF_FUNC',
+sub image_button {
+    my($self,@p) = self_or_default(@_);
+
+    my($name,$src,$alignment,@other) =
+       rearrange([NAME,SRC,ALIGN],@p);
+
+    my($align) = $alignment ? " align=\L\"$alignment\"" : '';
+    my($other) = @other ? " @other" : '';
+    $name=$self->_maybe_escapeHTML($name);
+    return $XHTML ? qq(<input type="image" name="$name" src="$src"$align$other />)
+                  : qq/<input type="image" name="$name" src="$src"$align$other>/;
+}
+END_OF_FUNC
+
+
+#### Method: self_url
+# Returns a URL containing the current script and all its
+# param/value pairs arranged as a query.  You can use this
+# to create a link that, when selected, will reinvoke the
+# script with all its state information preserved.
+####
+'self_url' => <<'END_OF_FUNC',
+sub self_url {
+    my($self,@p) = self_or_default(@_);
+    return $self->url('-path_info'=>1,'-query'=>1,'-full'=>1,@p);
+}
+END_OF_FUNC
+
+
+# This is provided as a synonym to self_url() for people unfortunate
+# enough to have incorporated it into their programs already!
+'state' => <<'END_OF_FUNC',
+sub state {
+    &self_url;
+}
+END_OF_FUNC
+
+
+#### Method: url
+# Like self_url, but doesn't return the query string part of
+# the URL.
+####
+'url' => <<'END_OF_FUNC',
+sub url {
+    my($self,@p) = self_or_default(@_);
+    my ($relative,$absolute,$full,$path_info,$query,$base,$rewrite) = 
+       rearrange(['RELATIVE','ABSOLUTE','FULL',['PATH','PATH_INFO'],['QUERY','QUERY_STRING'],'BASE','REWRITE'],@p);
+    my $url  = '';
+    $full++      if $base || !($relative || $absolute);
+    $rewrite++   unless defined $rewrite;
+
+    my $path        =  $self->path_info;
+    my $script_name =  $self->script_name;
+    my $request_uri =  unescape($self->request_uri) || '';
+    my $query_str   =  $self->query_string;
+
+    my $rewrite_in_use = $request_uri && $request_uri !~ /^\Q$script_name/;
+
+    my $uri         =  $rewrite && $request_uri ? $request_uri : $script_name;
+    $uri            =~ s/\?.*$//s;                                # remove query string
+    $uri            =~ s/\Q$ENV{PATH_INFO}\E$// if defined $ENV{PATH_INFO};
+#    $uri            =~ s/\Q$path\E$//      if defined $path;      # remove path
+
+    if ($full) {
+        my $protocol = $self->protocol();
+        $url = "$protocol://";
+        my $vh = http('x_forwarded_host') || http('host') || '';
+            $vh =~ s/\:\d+$//;  # some clients add the port number (incorrectly). Get rid of it.
+
+        $url .= $vh || server_name();
+
+        my $port = $self->virtual_port;
+
+        # add the port to the url unless it's the protocol's default port
+        $url .= ':' . $port unless (lc($protocol) eq 'http'  && $port == 80)
+                                or (lc($protocol) eq 'https' && $port == 443);
+
+        return $url if $base;
+
+        $url .= $uri;
+    } elsif ($relative) {
+       ($url) = $uri =~ m!([^/]+)$!;
+    } elsif ($absolute) {
+       $url = $uri;
+    }
+
+    $url .= $path         if $path_info and defined $path;
+    $url .= "?$query_str" if $query     and $query_str ne '';
+    $url ||= '';
+    $url =~ s/([^a-zA-Z0-9_.%;&?\/\\:+=~-])/sprintf("%%%02X",ord($1))/eg;
+    return $url;
+}
+
+END_OF_FUNC
+
+#### Method: cookie
+# Set or read a cookie from the specified name.
+# Cookie can then be passed to header().
+# Usual rules apply to the stickiness of -value.
+#  Parameters:
+#   -name -> name for this cookie (optional)
+#   -value -> value of this cookie (scalar, array or hash) 
+#   -path -> paths for which this cookie is valid (optional)
+#   -domain -> internet domain in which this cookie is valid (optional)
+#   -secure -> if true, cookie only passed through secure channel (optional)
+#   -expires -> expiry date in format Wdy, DD-Mon-YYYY HH:MM:SS GMT (optional)
+####
+'cookie' => <<'END_OF_FUNC',
+sub cookie {
+    my($self,@p) = self_or_default(@_);
+    my($name,$value,$path,$domain,$secure,$expires,$httponly) =
+       rearrange([NAME,[VALUE,VALUES],PATH,DOMAIN,SECURE,EXPIRES,HTTPONLY],@p);
+
+    require CGI::Cookie;
+
+    # if no value is supplied, then we retrieve the
+    # value of the cookie, if any.  For efficiency, we cache the parsed
+    # cookies in our state variables.
+    unless ( defined($value) ) {
+       $self->{'.cookies'} = CGI::Cookie->fetch;
+       
+       # If no name is supplied, then retrieve the names of all our cookies.
+       return () unless $self->{'.cookies'};
+       return keys %{$self->{'.cookies'}} unless $name;
+       return () unless $self->{'.cookies'}->{$name};
+       return $self->{'.cookies'}->{$name}->value if defined($name) && $name ne '';
+    }
+
+    # If we get here, we're creating a new cookie
+    return undef unless defined($name) && $name ne ''; # this is an error
+
+    my @param;
+    push(@param,'-name'=>$name);
+    push(@param,'-value'=>$value);
+    push(@param,'-domain'=>$domain) if $domain;
+    push(@param,'-path'=>$path) if $path;
+    push(@param,'-expires'=>$expires) if $expires;
+    push(@param,'-secure'=>$secure) if $secure;
+    push(@param,'-httponly'=>$httponly) if $httponly;
+
+    return CGI::Cookie->new(@param);
+}
+END_OF_FUNC
+
+'parse_keywordlist' => <<'END_OF_FUNC',
+sub parse_keywordlist {
+    my($self,$tosplit) = @_;
+    $tosplit = unescape($tosplit); # unescape the keywords
+    $tosplit=~tr/+/ /;          # pluses to spaces
+    my(@keywords) = split(/\s+/,$tosplit);
+    return @keywords;
+}
+END_OF_FUNC
+
+'param_fetch' => <<'END_OF_FUNC',
+sub param_fetch {
+    my($self,@p) = self_or_default(@_);
+    my($name) = rearrange([NAME],@p);
+    return [] unless defined $name;
+
+    unless (exists($self->{param}{$name})) {
+       $self->add_parameter($name);
+       $self->{param}{$name} = [];
+    }
+    
+    return $self->{param}{$name};
+}
+END_OF_FUNC
+
+###############################################
+# OTHER INFORMATION PROVIDED BY THE ENVIRONMENT
+###############################################
+
+#### Method: path_info
+# Return the extra virtual path information provided
+# after the URL (if any)
+####
+'path_info' => <<'END_OF_FUNC',
+sub path_info {
+    my ($self,$info) = self_or_default(@_);
+    if (defined($info)) {
+       $info = "/$info" if $info ne '' &&  substr($info,0,1) ne '/';
+       $self->{'.path_info'} = $info;
+    } elsif (! defined($self->{'.path_info'}) ) {
+        my (undef,$path_info) = $self->_name_and_path_from_env;
+       $self->{'.path_info'} = $path_info || '';
+    }
+    return $self->{'.path_info'};
+}
+END_OF_FUNC
+
+# This function returns a potentially modified version of SCRIPT_NAME
+# and PATH_INFO. Some HTTP servers do sanitise the paths in those
+# variables. It is the case of at least Apache 2. If for instance the
+# user requests: /path/./to/script.cgi/x//y/z/../x?y, Apache will set:
+# REQUEST_URI=/path/./to/script.cgi/x//y/z/../x?y
+# SCRIPT_NAME=/path/to/env.cgi
+# PATH_INFO=/x/y/x
+#
+# This is all fine except that some bogus CGI scripts expect
+# PATH_INFO=/http://foo when the user requests
+# http://xxx/script.cgi/http://foo
+#
+# Old versions of this module used to accomodate with those scripts, so
+# this is why we do this here to keep those scripts backward compatible.
+# Basically, we accomodate with those scripts but within limits, that is
+# we only try to preserve the number of / that were provided by the user
+# if $REQUEST_URI and "$SCRIPT_NAME$PATH_INFO" only differ by the number
+# of consecutive /.
+#
+# So for instance, in: http://foo/x//y/script.cgi/a//b, we'll return a
+# script_name of /x//y/script.cgi and a path_info of /a//b, but in:
+# http://foo/./x//z/script.cgi/a/../b//c, we'll return the versions
+# possibly sanitised by the HTTP server, so in the case of Apache 2:
+# script_name == /foo/x/z/script.cgi and path_info == /b/c.
+#
+# Future versions of this module may no longer do that, so one should
+# avoid relying on the browser, proxy, server, and CGI.pm preserving the
+# number of consecutive slashes as no guarantee can be made there.
+'_name_and_path_from_env' => <<'END_OF_FUNC',
+sub _name_and_path_from_env {
+    my $self = shift;
+    my $script_name = $ENV{SCRIPT_NAME}  || '';
+    my $path_info   = $ENV{PATH_INFO}    || '';
+    my $uri         = $self->request_uri || '';
+
+    $uri =~ s/\?.*//s;
+    $uri = unescape($uri);
+
+    if ($uri ne "$script_name$path_info") {
+        my $script_name_pattern = quotemeta($script_name);
+        my $path_info_pattern = quotemeta($path_info);
+        $script_name_pattern =~ s{(?:\\/)+}{/+}g;
+        $path_info_pattern =~ s{(?:\\/)+}{/+}g;
+
+        if ($uri =~ /^($script_name_pattern)($path_info_pattern)$/s) {
+            # REQUEST_URI and SCRIPT_NAME . PATH_INFO only differ by the
+            # numer of consecutive slashes, so we can extract the info from
+            # REQUEST_URI:
+            ($script_name, $path_info) = ($1, $2);
+        }
+    }
+    return ($script_name,$path_info);
+}
+END_OF_FUNC
+
+
+#### Method: request_method
+# Returns 'POST', 'GET', 'PUT' or 'HEAD'
+####
+'request_method' => <<'END_OF_FUNC',
+sub request_method {
+    return (defined $ENV{'REQUEST_METHOD'}) ? $ENV{'REQUEST_METHOD'} : undef;
+}
+END_OF_FUNC
+
+#### Method: content_type
+# Returns the content_type string
+####
+'content_type' => <<'END_OF_FUNC',
+sub content_type {
+    return (defined $ENV{'CONTENT_TYPE'}) ? $ENV{'CONTENT_TYPE'} : undef;
+}
+END_OF_FUNC
+
+#### Method: path_translated
+# Return the physical path information provided
+# by the URL (if any)
+####
+'path_translated' => <<'END_OF_FUNC',
+sub path_translated {
+    return (defined $ENV{'PATH_TRANSLATED'}) ? $ENV{'PATH_TRANSLATED'} : undef;
+}
+END_OF_FUNC
+
+
+#### Method: request_uri
+# Return the literal request URI
+####
+'request_uri' => <<'END_OF_FUNC',
+sub request_uri {
+    return (defined $ENV{'REQUEST_URI'}) ? $ENV{'REQUEST_URI'} : undef;
+}
+END_OF_FUNC
+
+
+#### Method: query_string
+# Synthesize a query string from our current
+# parameters
+####
+'query_string' => <<'END_OF_FUNC',
+sub query_string {
+    my($self) = self_or_default(@_);
+    my($param,$value,@pairs);
+    for $param ($self->param) {
+       my($eparam) = escape($param);
+       for $value ($self->param($param)) {
+           $value = escape($value);
+            next unless defined $value;
+           push(@pairs,"$eparam=$value");
+       }
+    }
+    for (keys %{$self->{'.fieldnames'}}) {
+      push(@pairs,".cgifields=".escape("$_"));
+    }
+    return join($USE_PARAM_SEMICOLONS ? ';' : '&',@pairs);
+}
+END_OF_FUNC
+
+
+#### Method: accept
+# Without parameters, returns an array of the
+# MIME types the browser accepts.
+# With a single parameter equal to a MIME
+# type, will return undef if the browser won't
+# accept it, 1 if the browser accepts it but
+# doesn't give a preference, or a floating point
+# value between 0.0 and 1.0 if the browser
+# declares a quantitative score for it.
+# This handles MIME type globs correctly.
+####
+'Accept' => <<'END_OF_FUNC',
+sub Accept {
+    my($self,$search) = self_or_CGI(@_);
+    my(%prefs,$type,$pref,$pat);
+    
+    my(@accept) = defined $self->http('accept') 
+                ? split(',',$self->http('accept'))
+                : ();
+
+    for (@accept) {
+       ($pref) = /q=(\d\.\d+|\d+)/;
+       ($type) = m#(\S+/[^;]+)#;
+       next unless $type;
+       $prefs{$type}=$pref || 1;
+    }
+
+    return keys %prefs unless $search;
+    
+    # if a search type is provided, we may need to
+    # perform a pattern matching operation.
+    # The MIME types use a glob mechanism, which
+    # is easily translated into a perl pattern match
+
+    # First return the preference for directly supported
+    # types:
+    return $prefs{$search} if $prefs{$search};
+
+    # Didn't get it, so try pattern matching.
+    for (keys %prefs) {
+       next unless /\*/;       # not a pattern match
+       ($pat = $_) =~ s/([^\w*])/\\$1/g; # escape meta characters
+       $pat =~ s/\*/.*/g; # turn it into a pattern
+       return $prefs{$_} if $search=~/$pat/;
+    }
+}
+END_OF_FUNC
+
+
+#### Method: user_agent
+# If called with no parameters, returns the user agent.
+# If called with one parameter, does a pattern match (case
+# insensitive) on the user agent.
+####
+'user_agent' => <<'END_OF_FUNC',
+sub user_agent {
+    my($self,$match)=self_or_CGI(@_);
+    my $user_agent = $self->http('user_agent');
+    return $user_agent unless $match && $user_agent;
+    return $user_agent =~ /$match/i;
+}
+END_OF_FUNC
+
+
+#### Method: raw_cookie
+# Returns the magic cookies for the session.
+# The cookies are not parsed or altered in any way, i.e.
+# cookies are returned exactly as given in the HTTP
+# headers.  If a cookie name is given, only that cookie's
+# value is returned, otherwise the entire raw cookie
+# is returned.
+####
+'raw_cookie' => <<'END_OF_FUNC',
+sub raw_cookie {
+    my($self,$key) = self_or_CGI(@_);
+
+    require CGI::Cookie;
+
+    if (defined($key)) {
+       $self->{'.raw_cookies'} = CGI::Cookie->raw_fetch
+           unless $self->{'.raw_cookies'};
+
+       return () unless $self->{'.raw_cookies'};
+       return () unless $self->{'.raw_cookies'}->{$key};
+       return $self->{'.raw_cookies'}->{$key};
+    }
+    return $self->http('cookie') || $ENV{'COOKIE'} || '';
+}
+END_OF_FUNC
+
+#### Method: virtual_host
+# Return the name of the virtual_host, which
+# is not always the same as the server
+######
+'virtual_host' => <<'END_OF_FUNC',
+sub virtual_host {
+    my $vh = http('x_forwarded_host') || http('host') || server_name();
+    $vh =~ s/:\d+$//;          # get rid of port number
+    return $vh;
+}
+END_OF_FUNC
+
+#### Method: remote_host
+# Return the name of the remote host, or its IP
+# address if unavailable.  If this variable isn't
+# defined, it returns "localhost" for debugging
+# purposes.
+####
+'remote_host' => <<'END_OF_FUNC',
+sub remote_host {
+    return $ENV{'REMOTE_HOST'} || $ENV{'REMOTE_ADDR'} 
+    || 'localhost';
+}
+END_OF_FUNC
+
+
+#### Method: remote_addr
+# Return the IP addr of the remote host.
+####
+'remote_addr' => <<'END_OF_FUNC',
+sub remote_addr {
+    return $ENV{'REMOTE_ADDR'} || '127.0.0.1';
+}
+END_OF_FUNC
+
+
+#### Method: script_name
+# Return the partial URL to this script for
+# self-referencing scripts.  Also see
+# self_url(), which returns a URL with all state information
+# preserved.
+####
+'script_name' => <<'END_OF_FUNC',
+sub script_name {
+    my ($self,@p) = self_or_default(@_);
+    if (@p) {
+        $self->{'.script_name'} = shift @p;
+    } elsif (!exists $self->{'.script_name'}) {
+        my ($script_name,$path_info) = $self->_name_and_path_from_env();
+        $self->{'.script_name'} = $script_name;
+    }
+    return $self->{'.script_name'};
+}
+END_OF_FUNC
+
+
+#### Method: referer
+# Return the HTTP_REFERER: useful for generating
+# a GO BACK button.
+####
+'referer' => <<'END_OF_FUNC',
+sub referer {
+    my($self) = self_or_CGI(@_);
+    return $self->http('referer');
+}
+END_OF_FUNC
+
+
+#### Method: server_name
+# Return the name of the server
+####
+'server_name' => <<'END_OF_FUNC',
+sub server_name {
+    return $ENV{'SERVER_NAME'} || 'localhost';
+}
+END_OF_FUNC
+
+#### Method: server_software
+# Return the name of the server software
+####
+'server_software' => <<'END_OF_FUNC',
+sub server_software {
+    return $ENV{'SERVER_SOFTWARE'} || 'cmdline';
+}
+END_OF_FUNC
+
+#### Method: virtual_port
+# Return the server port, taking virtual hosts into account
+####
+'virtual_port' => <<'END_OF_FUNC',
+sub virtual_port {
+    my($self) = self_or_default(@_);
+    my $vh = $self->http('x_forwarded_host') || $self->http('host');
+    my $protocol = $self->protocol;
+    if ($vh) {
+        return ($vh =~ /:(\d+)$/)[0] || ($protocol eq 'https' ? 443 : 80);
+    } else {
+        return $self->server_port();
+    }
+}
+END_OF_FUNC
+
+#### Method: server_port
+# Return the tcp/ip port the server is running on
+####
+'server_port' => <<'END_OF_FUNC',
+sub server_port {
+    return $ENV{'SERVER_PORT'} || 80; # for debugging
+}
+END_OF_FUNC
+
+#### Method: server_protocol
+# Return the protocol (usually HTTP/1.0)
+####
+'server_protocol' => <<'END_OF_FUNC',
+sub server_protocol {
+    return $ENV{'SERVER_PROTOCOL'} || 'HTTP/1.0'; # for debugging
+}
+END_OF_FUNC
+
+#### Method: http
+# Return the value of an HTTP variable, or
+# the list of variables if none provided
+####
+'http' => <<'END_OF_FUNC',
+sub http {
+    my ($self,$parameter) = self_or_CGI(@_);
+    if ( defined($parameter) ) {
+        $parameter =~ tr/-a-z/_A-Z/;
+        if ( $parameter =~ /^HTTP(?:_|$)/ ) {
+            return $ENV{$parameter};
+        }
+        return $ENV{"HTTP_$parameter"};
+    }
+    return grep { /^HTTP(?:_|$)/ } keys %ENV;
+}
+END_OF_FUNC
+
+#### Method: https
+# Return the value of HTTPS, or
+# the value of an HTTPS variable, or
+# the list of variables
+####
+'https' => <<'END_OF_FUNC',
+sub https {
+    my ($self,$parameter) = self_or_CGI(@_);
+    if ( defined($parameter) ) {
+        $parameter =~ tr/-a-z/_A-Z/;
+        if ( $parameter =~ /^HTTPS(?:_|$)/ ) {
+            return $ENV{$parameter};
+        }
+        return $ENV{"HTTPS_$parameter"};
+    }
+    return wantarray
+        ? grep { /^HTTPS(?:_|$)/ } keys %ENV
+        : $ENV{'HTTPS'};
+}
+END_OF_FUNC
+
+#### Method: protocol
+# Return the protocol (http or https currently)
+####
+'protocol' => <<'END_OF_FUNC',
+sub protocol {
+    local($^W)=0;
+    my $self = shift;
+    return 'https' if uc($self->https()) eq 'ON'; 
+    return 'https' if $self->server_port == 443;
+    my $prot = $self->server_protocol;
+    my($protocol,$version) = split('/',$prot);
+    return "\L$protocol\E";
+}
+END_OF_FUNC
+
+#### Method: remote_ident
+# Return the identity of the remote user
+# (but only if his host is running identd)
+####
+'remote_ident' => <<'END_OF_FUNC',
+sub remote_ident {
+    return (defined $ENV{'REMOTE_IDENT'}) ? $ENV{'REMOTE_IDENT'} : undef;
+}
+END_OF_FUNC
+
+
+#### Method: auth_type
+# Return the type of use verification/authorization in use, if any.
+####
+'auth_type' => <<'END_OF_FUNC',
+sub auth_type {
+    return (defined $ENV{'AUTH_TYPE'}) ? $ENV{'AUTH_TYPE'} : undef;
+}
+END_OF_FUNC
+
+
+#### Method: remote_user
+# Return the authorization name used for user
+# verification.
+####
+'remote_user' => <<'END_OF_FUNC',
+sub remote_user {
+    return (defined $ENV{'REMOTE_USER'}) ? $ENV{'REMOTE_USER'} : undef;
+}
+END_OF_FUNC
+
+
+#### Method: user_name
+# Try to return the remote user's name by hook or by
+# crook
+####
+'user_name' => <<'END_OF_FUNC',
+sub user_name {
+    my ($self) = self_or_CGI(@_);
+    return $self->http('from') || $ENV{'REMOTE_IDENT'} || $ENV{'REMOTE_USER'};
+}
+END_OF_FUNC
+
+#### Method: nosticky
+# Set or return the NOSTICKY global flag
+####
+'nosticky' => <<'END_OF_FUNC',
+sub nosticky {
+    my ($self,$param) = self_or_CGI(@_);
+    $CGI::NOSTICKY = $param if defined($param);
+    return $CGI::NOSTICKY;
+}
+END_OF_FUNC
+
+#### Method: nph
+# Set or return the NPH global flag
+####
+'nph' => <<'END_OF_FUNC',
+sub nph {
+    my ($self,$param) = self_or_CGI(@_);
+    $CGI::NPH = $param if defined($param);
+    return $CGI::NPH;
+}
+END_OF_FUNC
+
+#### Method: private_tempfiles
+# Set or return the private_tempfiles global flag
+####
+'private_tempfiles' => <<'END_OF_FUNC',
+sub private_tempfiles {
+    my ($self,$param) = self_or_CGI(@_);
+    $CGI::PRIVATE_TEMPFILES = $param if defined($param);
+    return $CGI::PRIVATE_TEMPFILES;
+}
+END_OF_FUNC
+#### Method: close_upload_files
+# Set or return the close_upload_files global flag
+####
+'close_upload_files' => <<'END_OF_FUNC',
+sub close_upload_files {
+    my ($self,$param) = self_or_CGI(@_);
+    $CGI::CLOSE_UPLOAD_FILES = $param if defined($param);
+    return $CGI::CLOSE_UPLOAD_FILES;
+}
+END_OF_FUNC
+
+
+#### Method: default_dtd
+# Set or return the default_dtd global
+####
+'default_dtd' => <<'END_OF_FUNC',
+sub default_dtd {
+    my ($self,$param,$param2) = self_or_CGI(@_);
+    if (defined $param2 && defined $param) {
+        $CGI::DEFAULT_DTD = [ $param, $param2 ];
+    } elsif (defined $param) {
+        $CGI::DEFAULT_DTD = $param;
+    }
+    return $CGI::DEFAULT_DTD;
+}
+END_OF_FUNC
+
+# -------------- really private subroutines -----------------
+'_maybe_escapeHTML' => <<'END_OF_FUNC',
+sub _maybe_escapeHTML {
+    # hack to work around  earlier hacks
+    push @_,$_[0] if @_==1 && $_[0] eq 'CGI';
+    my ($self,$toencode,$newlinestoo) = CGI::self_or_default(@_);
+    return undef unless defined($toencode);
+    return $toencode if ref($self) && !$self->{'escape'};
+    return $self->escapeHTML($toencode, $newlinestoo);
+}
+END_OF_FUNC
+
+'previous_or_default' => <<'END_OF_FUNC',
+sub previous_or_default {
+    my($self,$name,$defaults,$override) = @_;
+    my(%selected);
+
+    if (!$override && ($self->{'.fieldnames'}->{$name} || 
+                      defined($self->param($name)) ) ) {
+       $selected{$_}++ for $self->param($name);
+    } elsif (defined($defaults) && ref($defaults) && 
+            (ref($defaults) eq 'ARRAY')) {
+       $selected{$_}++ for @{$defaults};
+    } else {
+       $selected{$defaults}++ if defined($defaults);
+    }
+
+    return %selected;
+}
+END_OF_FUNC
+
+'register_parameter' => <<'END_OF_FUNC',
+sub register_parameter {
+    my($self,$param) = @_;
+    $self->{'.parametersToAdd'}->{$param}++;
+}
+END_OF_FUNC
+
+'get_fields' => <<'END_OF_FUNC',
+sub get_fields {
+    my($self) = @_;
+    return $self->CGI::hidden('-name'=>'.cgifields',
+                             '-values'=>[keys %{$self->{'.parametersToAdd'}}],
+                             '-override'=>1);
+}
+END_OF_FUNC
+
+'read_from_cmdline' => <<'END_OF_FUNC',
+sub read_from_cmdline {
+    my($input,@words);
+    my($query_string);
+    my($subpath);
+    if ($DEBUG && @ARGV) {
+       @words = @ARGV;
+    } elsif ($DEBUG > 1) {
+       require Text::ParseWords;
+       print STDERR "(offline mode: enter name=value pairs on standard input; press ^D or ^Z when done)\n";
+       chomp(@lines = <STDIN>); # remove newlines
+       $input = join(" ",@lines);
+       @words = &Text::ParseWords::old_shellwords($input);    
+    }
+    for (@words) {
+       s/\\=/%3D/g;
+       s/\\&/%26/g;        
+    }
+
+    if ("@words"=~/=/) {
+       $query_string = join('&',@words);
+    } else {
+       $query_string = join('+',@words);
+    }
+    if ($query_string =~ /^(.*?)\?(.*)$/)
+    {
+        $query_string = $2;
+        $subpath = $1;
+    }
+    return { 'query_string' => $query_string, 'subpath' => $subpath };
+}
+END_OF_FUNC
+
+#####
+# subroutine: read_multipart
+#
+# Read multipart data and store it into our parameters.
+# An interesting feature is that if any of the parts is a file, we
+# create a temporary file and open up a filehandle on it so that the
+# caller can read from it if necessary.
+#####
+'read_multipart' => <<'END_OF_FUNC',
+sub read_multipart {
+    my($self,$boundary,$length) = @_;
+    my($buffer) = $self->new_MultipartBuffer($boundary,$length);
+    return unless $buffer;
+    my(%header,$body);
+    my $filenumber = 0;
+    while (!$buffer->eof) {
+       %header = $buffer->readHeader;
+
+       unless (%header) {
+           $self->cgi_error("400 Bad request (malformed multipart POST)");
+           return;
+       }
+
+       $header{'Content-Disposition'} ||= ''; # quench uninit variable warning
+
+       my($param)= $header{'Content-Disposition'}=~/[\s;]name="([^"]*)"/;
+        $param .= $TAINTED;
+
+        # See RFC 1867, 2183, 2045
+        # NB: File content will be loaded into memory should
+        # content-disposition parsing fail.
+        my ($filename) = $header{'Content-Disposition'}
+                      =~/ filename=(("[^"]*")|([a-z\d!\#'\*\+,\.^_\`\{\}\|\~]*))/i;
+
+       $filename ||= ''; # quench uninit variable warning
+
+        $filename =~ s/^"([^"]*)"$/$1/;
+       # Test for Opera's multiple upload feature
+       my($multipart) = ( defined( $header{'Content-Type'} ) &&
+               $header{'Content-Type'} =~ /multipart\/mixed/ ) ?
+               1 : 0;
+
+       # add this parameter to our list
+       $self->add_parameter($param);
+
+       # If no filename specified, then just read the data and assign it
+       # to our parameter list.
+       if ( ( !defined($filename) || $filename eq '' ) && !$multipart ) {
+           my($value) = $buffer->readBody;
+            $value .= $TAINTED;
+           push(@{$self->{param}{$param}},$value);
+           next;
+       }
+
+       my ($tmpfile,$tmp,$filehandle);
+      UPLOADS: {
+         # If we get here, then we are dealing with a potentially large
+         # uploaded form.  Save the data to a temporary file, then open
+         # the file for reading.
+
+         # skip the file if uploads disabled
+         if ($DISABLE_UPLOADS) {
+             while (defined($data = $buffer->read)) { }
+             last UPLOADS;
+         }
+
+         # set the filename to some recognizable value
+          if ( ( !defined($filename) || $filename eq '' ) && $multipart ) {
+              $filename = "multipart/mixed";
+          }
+
+         # choose a relatively unpredictable tmpfile sequence number
+          my $seqno = unpack("%16C*",join('',localtime,grep {defined $_} values %ENV));
+          for (my $cnt=10;$cnt>0;$cnt--) {
+           next unless $tmpfile = CGITempFile->new($seqno);
+           $tmp = $tmpfile->as_string;
+           last if defined($filehandle = Fh->new($filename,$tmp,$PRIVATE_TEMPFILES));
+            $seqno += int rand(100);
+          }
+          die "CGI.pm open of tmpfile $tmp/$filename failed: $!\n" unless defined $filehandle;
+         $CGI::DefaultClass->binmode($filehandle) if $CGI::needs_binmode 
+                     && defined fileno($filehandle);
+
+         # if this is an multipart/mixed attachment, save the header
+         # together with the body for later parsing with an external
+         # MIME parser module
+         if ( $multipart ) {
+             for ( keys %header ) {
+                 print $filehandle "$_: $header{$_}${CRLF}";
+             }
+             print $filehandle "${CRLF}";
+         }
+
+         my ($data);
+         local($\) = '';
+          my $totalbytes = 0;
+          while (defined($data = $buffer->read)) {
+              if (defined $self->{'.upload_hook'})
+               {
+                  $totalbytes += length($data);
+                   &{$self->{'.upload_hook'}}($filename ,$data, $totalbytes, $self->{'.upload_data'});
+              }
+              print $filehandle $data if ($self->{'use_tempfile'});
+          }
+
+         # back up to beginning of file
+         seek($filehandle,0,0);
+
+      ## Close the filehandle if requested this allows a multipart MIME
+      ## upload to contain many files, and we won't die due to too many
+      ## open file handles. The user can access the files using the hash
+      ## below.
+      close $filehandle if $CLOSE_UPLOAD_FILES;
+         $CGI::DefaultClass->binmode($filehandle) if $CGI::needs_binmode;
+
+         # Save some information about the uploaded file where we can get
+         # at it later.
+         # Use the typeglob as the key, as this is guaranteed to be
+         # unique for each filehandle.  Don't use the file descriptor as
+         # this will be re-used for each filehandle if the
+         # close_upload_files feature is used.
+         $self->{'.tmpfiles'}->{$$filehandle}= {
+              hndl => $filehandle,
+             name => $tmpfile,
+             info => {%header},
+         };
+         push(@{$self->{param}{$param}},$filehandle);
+      }
+    }
+}
+END_OF_FUNC
+
+#####
+# subroutine: read_multipart_related
+#
+# Read multipart/related data and store it into our parameters.  The
+# first parameter sets the start of the data. The part identified by
+# this Content-ID will not be stored as a file upload, but will be
+# returned by this method.  All other parts will be available as file
+# uploads accessible by their Content-ID
+#####
+'read_multipart_related' => <<'END_OF_FUNC',
+sub read_multipart_related {
+    my($self,$start,$boundary,$length) = @_;
+    my($buffer) = $self->new_MultipartBuffer($boundary,$length);
+    return unless $buffer;
+    my(%header,$body);
+    my $filenumber = 0;
+    my $returnvalue;
+    while (!$buffer->eof) {
+       %header = $buffer->readHeader;
+
+       unless (%header) {
+           $self->cgi_error("400 Bad request (malformed multipart POST)");
+           return;
+       }
+
+       my($param) = $header{'Content-ID'}=~/\<([^\>]*)\>/;
+        $param .= $TAINTED;
+
+       # If this is the start part, then just read the data and assign it
+       # to our return variable.
+       if ( $param eq $start ) {
+           $returnvalue = $buffer->readBody;
+            $returnvalue .= $TAINTED;
+           next;
+       }
+
+       # add this parameter to our list
+       $self->add_parameter($param);
+
+       my ($tmpfile,$tmp,$filehandle);
+      UPLOADS: {
+         # If we get here, then we are dealing with a potentially large
+         # uploaded form.  Save the data to a temporary file, then open
+         # the file for reading.
+
+         # skip the file if uploads disabled
+         if ($DISABLE_UPLOADS) {
+             while (defined($data = $buffer->read)) { }
+             last UPLOADS;
+         }
+
+         # choose a relatively unpredictable tmpfile sequence number
+          my $seqno = unpack("%16C*",join('',localtime,grep {defined $_} values %ENV));
+          for (my $cnt=10;$cnt>0;$cnt--) {
+           next unless $tmpfile = CGITempFile->new($seqno);
+           $tmp = $tmpfile->as_string;
+           last if defined($filehandle = Fh->new($param,$tmp,$PRIVATE_TEMPFILES));
+            $seqno += int rand(100);
+          }
+          die "CGI open of tmpfile: $!\n" unless defined $filehandle;
+         $CGI::DefaultClass->binmode($filehandle) if $CGI::needs_binmode 
+                     && defined fileno($filehandle);
+
+         my ($data);
+         local($\) = '';
+          my $totalbytes;
+          while (defined($data = $buffer->read)) {
+              if (defined $self->{'.upload_hook'})
+               {
+                  $totalbytes += length($data);
+                   &{$self->{'.upload_hook'}}($param ,$data, $totalbytes, $self->{'.upload_data'});
+              }
+              print $filehandle $data if ($self->{'use_tempfile'});
+          }
+
+         # back up to beginning of file
+         seek($filehandle,0,0);
+
+      ## Close the filehandle if requested this allows a multipart MIME
+      ## upload to contain many files, and we won't die due to too many
+      ## open file handles. The user can access the files using the hash
+      ## below.
+      close $filehandle if $CLOSE_UPLOAD_FILES;
+         $CGI::DefaultClass->binmode($filehandle) if $CGI::needs_binmode;
+
+         # Save some information about the uploaded file where we can get
+         # at it later.
+         # Use the typeglob as the key, as this is guaranteed to be
+         # unique for each filehandle.  Don't use the file descriptor as
+         # this will be re-used for each filehandle if the
+         # close_upload_files feature is used.
+         $self->{'.tmpfiles'}->{$$filehandle}= {
+              hndl => $filehandle,
+             name => $tmpfile,
+             info => {%header},
+         };
+         push(@{$self->{param}{$param}},$filehandle);
+      }
+    }
+    return $returnvalue;
+}
+END_OF_FUNC
+
+
+'upload' =><<'END_OF_FUNC',
+sub upload {
+    my($self,$param_name) = self_or_default(@_);
+    my @param = grep {ref($_) && defined(fileno($_))} $self->param($param_name);
+    return unless @param;
+    return wantarray ? @param : $param[0];
+}
+END_OF_FUNC
+
+'tmpFileName' => <<'END_OF_FUNC',
+sub tmpFileName {
+    my($self,$filename) = self_or_default(@_);
+    return $self->{'.tmpfiles'}->{$$filename}->{name} ?
+       $self->{'.tmpfiles'}->{$$filename}->{name}->as_string
+           : '';
+}
+END_OF_FUNC
+
+'uploadInfo' => <<'END_OF_FUNC',
+sub uploadInfo {
+    my($self,$filename) = self_or_default(@_);
+    return $self->{'.tmpfiles'}->{$$filename}->{info};
+}
+END_OF_FUNC
+
+# internal routine, don't use
+'_set_values_and_labels' => <<'END_OF_FUNC',
+sub _set_values_and_labels {
+    my $self = shift;
+    my ($v,$l,$n) = @_;
+    $$l = $v if ref($v) eq 'HASH' && !ref($$l);
+    return $self->param($n) if !defined($v);
+    return $v if !ref($v);
+    return ref($v) eq 'HASH' ? keys %$v : @$v;
+}
+END_OF_FUNC
+
+# internal routine, don't use
+'_set_attributes' => <<'END_OF_FUNC',
+sub _set_attributes {
+    my $self = shift;
+    my($element, $attributes) = @_;
+    return '' unless defined($attributes->{$element});
+    $attribs = ' ';
+    for my $attrib (keys %{$attributes->{$element}}) {
+        (my $clean_attrib = $attrib) =~ s/^-//;
+        $attribs .= "@{[lc($clean_attrib)]}=\"$attributes->{$element}{$attrib}\" ";
+    }
+    $attribs =~ s/ $//;
+    return $attribs;
+}
+END_OF_FUNC
+
+'_compile_all' => <<'END_OF_FUNC',
+sub _compile_all {
+    for (@_) {
+       next if defined(&$_);
+       $AUTOLOAD = "CGI::$_";
+       _compile();
+    }
+}
+END_OF_FUNC
+
+);
+END_OF_AUTOLOAD
+;
+
+#########################################################
+# Globals and stubs for other packages that we use.
+#########################################################
+
+################### Fh -- lightweight filehandle ###############
+package Fh;
+
+use overload 
+    '""'  => \&asString,
+    'cmp' => \&compare,
+    'fallback'=>1;
+
+$FH='fh00000';
+
+*Fh::AUTOLOAD = \&CGI::AUTOLOAD;
+
+sub DESTROY {
+    my $self = shift;
+    close $self;
+}
+
+$AUTOLOADED_ROUTINES = '';      # prevent -w error
+$AUTOLOADED_ROUTINES=<<'END_OF_AUTOLOAD';
+%SUBS =  (
+'asString' => <<'END_OF_FUNC',
+sub asString {
+    my $self = shift;
+    # get rid of package name
+    (my $i = $$self) =~ s/^\*(\w+::fh\d{5})+//; 
+    $i =~ s/%(..)/ chr(hex($1)) /eg;
+    return $i.$CGI::TAINTED;
+# BEGIN DEAD CODE
+# This was an extremely clever patch that allowed "use strict refs".
+# Unfortunately it relied on another bug that caused leaky file descriptors.
+# The underlying bug has been fixed, so this no longer works.  However
+# "strict refs" still works for some reason.
+#    my $self = shift;
+#    return ${*{$self}{SCALAR}};
+# END DEAD CODE
+}
+END_OF_FUNC
+
+'compare' => <<'END_OF_FUNC',
+sub compare {
+    my $self = shift;
+    my $value = shift;
+    return "$self" cmp $value;
+}
+END_OF_FUNC
+
+'new'  => <<'END_OF_FUNC',
+sub new {
+    my($pack,$name,$file,$delete) = @_;
+    _setup_symbols(@SAVED_SYMBOLS) if @SAVED_SYMBOLS;
+    require Fcntl unless defined &Fcntl::O_RDWR;
+    (my $safename = $name) =~ s/([':%])/ sprintf '%%%02X', ord $1 /eg;
+    my $fv = ++$FH . $safename;
+    my $ref = \*{"Fh::$fv"};
+
+    # Note this same regex is also used elsewhere in the same file for CGITempFile::new
+    $file =~ m!^([a-zA-Z0-9_ \'\":/.\$\\\+-]+)$! || return;
+    my $safe = $1;
+    sysopen($ref,$safe,Fcntl::O_RDWR()|Fcntl::O_CREAT()|Fcntl::O_EXCL(),0600) || return;
+    unlink($safe) if $delete;
+    CORE::delete $Fh::{$fv};
+    return bless $ref,$pack;
+}
+END_OF_FUNC
+
+'handle' => <<'END_OF_FUNC',
+sub handle {
+  my $self = shift;
+  eval "require IO::Handle" unless IO::Handle->can('new_from_fd');
+  return IO::Handle->new_from_fd(fileno $self,"<");
+}
+END_OF_FUNC
+
+);
+END_OF_AUTOLOAD
+
+######################## MultipartBuffer ####################
+package MultipartBuffer;
+
+use constant DEBUG => 0;
+
+# how many bytes to read at a time.  We use
+# a 4K buffer by default.
+$INITIAL_FILLUNIT = 1024 * 4;
+$TIMEOUT = 240*60;       # 4 hour timeout for big files
+$SPIN_LOOP_MAX = 2000;  # bug fix for some Netscape servers
+$CRLF=$CGI::CRLF;
+
+#reuse the autoload function
+*MultipartBuffer::AUTOLOAD = \&CGI::AUTOLOAD;
+
+# avoid autoloader warnings
+sub DESTROY {}
+
+###############################################################################
+################# THESE FUNCTIONS ARE AUTOLOADED ON DEMAND ####################
+###############################################################################
+$AUTOLOADED_ROUTINES = '';      # prevent -w error
+$AUTOLOADED_ROUTINES=<<'END_OF_AUTOLOAD';
+%SUBS =  (
+
+'new' => <<'END_OF_FUNC',
+sub new {
+    my($package,$interface,$boundary,$length) = @_;
+    $FILLUNIT = $INITIAL_FILLUNIT;
+    $CGI::DefaultClass->binmode($IN); # if $CGI::needs_binmode;  # just do it always
+
+    # If the user types garbage into the file upload field,
+    # then Netscape passes NOTHING to the server (not good).
+    # We may hang on this read in that case. So we implement
+    # a read timeout.  If nothing is ready to read
+    # by then, we return.
+
+    # Netscape seems to be a little bit unreliable
+    # about providing boundary strings.
+    my $boundary_read = 0;
+    if ($boundary) {
+
+       # Under the MIME spec, the boundary consists of the 
+       # characters "--" PLUS the Boundary string
+
+       # BUG: IE 3.01 on the Macintosh uses just the boundary -- not
+       # the two extra hyphens.  We do a special case here on the user-agent!!!!
+       $boundary = "--$boundary" unless CGI::user_agent('MSIE\s+3\.0[12];\s*Mac|DreamPassport');
+
+    } else { # otherwise we find it ourselves
+       my($old);
+       ($old,$/) = ($/,$CRLF); # read a CRLF-delimited line
+       $boundary = <STDIN>;      # BUG: This won't work correctly under mod_perl
+       $length -= length($boundary);
+       chomp($boundary);               # remove the CRLF
+       $/ = $old;                      # restore old line separator
+        $boundary_read++;
+    }
+
+    my $self = {LENGTH=>$length,
+               CHUNKED=>!$length,
+               BOUNDARY=>$boundary,
+               INTERFACE=>$interface,
+               BUFFER=>'',
+           };
+
+    $FILLUNIT = length($boundary)
+       if length($boundary) > $FILLUNIT;
+
+    my $retval = bless $self,ref $package || $package;
+
+    # Read the preamble and the topmost (boundary) line plus the CRLF.
+    unless ($boundary_read) {
+      while ($self->read(0)) { }
+    }
+    die "Malformed multipart POST: data truncated\n" if $self->eof;
+
+    return $retval;
+}
+END_OF_FUNC
+
+'readHeader' => <<'END_OF_FUNC',
+sub readHeader {
+    my($self) = @_;
+    my($end);
+    my($ok) = 0;
+    my($bad) = 0;
+
+    local($CRLF) = "\015\012" if $CGI::OS eq 'VMS' || $CGI::EBCDIC;
+
+    do {
+       $self->fillBuffer($FILLUNIT);
+       $ok++ if ($end = index($self->{BUFFER},"${CRLF}${CRLF}")) >= 0;
+       $ok++ if $self->{BUFFER} eq '';
+       $bad++ if !$ok && $self->{LENGTH} <= 0;
+       # this was a bad idea
+       # $FILLUNIT *= 2 if length($self->{BUFFER}) >= $FILLUNIT; 
+    } until $ok || $bad;
+    return () if $bad;
+
+    #EBCDIC NOTE: translate header into EBCDIC, but watch out for continuation lines!
+
+    my($header) = substr($self->{BUFFER},0,$end+2);
+    substr($self->{BUFFER},0,$end+4) = '';
+    my %return;
+
+    if ($CGI::EBCDIC) {
+      warn "untranslated header=$header\n" if DEBUG;
+      $header = CGI::Util::ascii2ebcdic($header);
+      warn "translated header=$header\n" if DEBUG;
+    }
+
+    # See RFC 2045 Appendix A and RFC 822 sections 3.4.8
+    #   (Folding Long Header Fields), 3.4.3 (Comments)
+    #   and 3.4.5 (Quoted-Strings).
+
+    my $token = '[-\w!\#$%&\'*+.^_\`|{}~]';
+    $header=~s/$CRLF\s+/ /og;          # merge continuation lines
+
+    while ($header=~/($token+):\s+([^$CRLF]*)/mgox) {
+        my ($field_name,$field_value) = ($1,$2);
+       $field_name =~ s/\b(\w)/uc($1)/eg; #canonicalize
+       $return{$field_name}=$field_value;
+    }
+    return %return;
+}
+END_OF_FUNC
+
+# This reads and returns the body as a single scalar value.
+'readBody' => <<'END_OF_FUNC',
+sub readBody {
+    my($self) = @_;
+    my($data);
+    my($returnval)='';
+
+    #EBCDIC NOTE: want to translate returnval into EBCDIC HERE
+
+    while (defined($data = $self->read)) {
+       $returnval .= $data;
+    }
+
+    if ($CGI::EBCDIC) {
+      warn "untranslated body=$returnval\n" if DEBUG;
+      $returnval = CGI::Util::ascii2ebcdic($returnval);
+      warn "translated body=$returnval\n"   if DEBUG;
+    }
+    return $returnval;
+}
+END_OF_FUNC
+
+# This will read $bytes or until the boundary is hit, whichever happens
+# first.  After the boundary is hit, we return undef.  The next read will
+# skip over the boundary and begin reading again;
+'read' => <<'END_OF_FUNC',
+sub read {
+    my($self,$bytes) = @_;
+
+    # default number of bytes to read
+    $bytes = $bytes || $FILLUNIT;
+
+    # Fill up our internal buffer in such a way that the boundary
+    # is never split between reads.
+    $self->fillBuffer($bytes);
+
+    my $boundary_start = $CGI::EBCDIC ? CGI::Util::ebcdic2ascii($self->{BOUNDARY})      : $self->{BOUNDARY};
+    my $boundary_end   = $CGI::EBCDIC ? CGI::Util::ebcdic2ascii($self->{BOUNDARY}.'--') : $self->{BOUNDARY}.'--';
+
+    # Find the boundary in the buffer (it may not be there).
+    my $start = index($self->{BUFFER},$boundary_start);
+
+    warn "boundary=$self->{BOUNDARY} length=$self->{LENGTH} start=$start\n" if DEBUG;
+
+    # protect against malformed multipart POST operations
+    die "Malformed multipart POST\n" unless $self->{CHUNKED} || ($start >= 0 || $self->{LENGTH} > 0);
+
+    #EBCDIC NOTE: want to translate boundary search into ASCII here.
+
+    # If the boundary begins the data, then skip past it
+    # and return undef.
+    if ($start == 0) {
+
+       # clear us out completely if we've hit the last boundary.
+       if (index($self->{BUFFER},$boundary_end)==0) {
+           $self->{BUFFER}='';
+           $self->{LENGTH}=0;
+           return undef;
+       }
+
+       # just remove the boundary.
+       substr($self->{BUFFER},0,length($boundary_start))='';
+        $self->{BUFFER} =~ s/^\012\015?//;
+       return undef;
+    }
+
+    my $bytesToReturn;
+    if ($start > 0) {           # read up to the boundary
+        $bytesToReturn = $start-2 > $bytes ? $bytes : $start;
+    } else {    # read the requested number of bytes
+       # leave enough bytes in the buffer to allow us to read
+       # the boundary.  Thanks to Kevin Hendrick for finding
+       # this one.
+       $bytesToReturn = $bytes - (length($boundary_start)+1);
+    }
+
+    my $returnval=substr($self->{BUFFER},0,$bytesToReturn);
+    substr($self->{BUFFER},0,$bytesToReturn)='';
+    
+    # If we hit the boundary, remove the CRLF from the end.
+    return ($bytesToReturn==$start)
+           ? substr($returnval,0,-2) : $returnval;
+}
+END_OF_FUNC
+
+
+# This fills up our internal buffer in such a way that the
+# boundary is never split between reads
+'fillBuffer' => <<'END_OF_FUNC',
+sub fillBuffer {
+    my($self,$bytes) = @_;
+    return unless $self->{CHUNKED} || $self->{LENGTH};
+
+    my($boundaryLength) = length($self->{BOUNDARY});
+    my($bufferLength) = length($self->{BUFFER});
+    my($bytesToRead) = $bytes - $bufferLength + $boundaryLength + 2;
+    $bytesToRead = $self->{LENGTH} if !$self->{CHUNKED} && $self->{LENGTH} < $bytesToRead;
+
+    # Try to read some data.  We may hang here if the browser is screwed up.
+    my $bytesRead = $self->{INTERFACE}->read_from_client(\$self->{BUFFER},
+                                                        $bytesToRead,
+                                                        $bufferLength);
+    warn "bytesToRead=$bytesToRead, bufferLength=$bufferLength, buffer=$self->{BUFFER}\n" if DEBUG;
+    $self->{BUFFER} = '' unless defined $self->{BUFFER};
+
+    # An apparent bug in the Apache server causes the read()
+    # to return zero bytes repeatedly without blocking if the
+    # remote user aborts during a file transfer.  I don't know how
+    # they manage this, but the workaround is to abort if we get
+    # more than SPIN_LOOP_MAX consecutive zero reads.
+    if ($bytesRead <= 0) {
+       die  "CGI.pm: Server closed socket during multipart read (client aborted?).\n"
+           if ($self->{ZERO_LOOP_COUNTER}++ >= $SPIN_LOOP_MAX);
+    } else {
+       $self->{ZERO_LOOP_COUNTER}=0;
+    }
+
+    $self->{LENGTH} -= $bytesRead if !$self->{CHUNKED} && $bytesRead;
+}
+END_OF_FUNC
+
+
+# Return true when we've finished reading
+'eof' => <<'END_OF_FUNC'
+sub eof {
+    my($self) = @_;
+    return 1 if (length($self->{BUFFER}) == 0)
+                && ($self->{LENGTH} <= 0);
+    undef;
+}
+END_OF_FUNC
+
+);
+END_OF_AUTOLOAD
+
+####################################################################################
+################################## TEMPORARY FILES #################################
+####################################################################################
+package CGITempFile;
+
+sub find_tempdir {
+  $SL = $CGI::SL;
+  $MAC = $CGI::OS eq 'MACINTOSH';
+  my ($vol) = $MAC ? MacPerl::Volumes() =~ /:(.*)/ : "";
+  unless (defined $TMPDIRECTORY) {
+    @TEMP=("${SL}usr${SL}tmp","${SL}var${SL}tmp",
+          "C:${SL}temp","${SL}tmp","${SL}temp",
+          "${vol}${SL}Temporary Items",
+           "${SL}WWW_ROOT", "${SL}SYS\$SCRATCH",
+          "C:${SL}system${SL}temp");
+    
+    if( $CGI::OS eq 'WINDOWS' ){
+         # PeterH: These evars may not exist if this is invoked within a service and untainting
+         # is in effect - with 'use warnings' the undefined array entries causes Perl to die
+         unshift(@TEMP,$ENV{TEMP}) if defined $ENV{TEMP};
+         unshift(@TEMP,$ENV{TMP}) if defined $ENV{TMP};
+         unshift(@TEMP,$ENV{WINDIR} . $SL . 'TEMP') if defined $ENV{WINDIR};
+    }
+
+    unshift(@TEMP,$ENV{'TMPDIR'}) if defined $ENV{'TMPDIR'};
+
+    # this feature was supposed to provide per-user tmpfiles, but
+    # it is problematic.
+    #    unshift(@TEMP,(getpwuid($<))[7].'/tmp') if $CGI::OS eq 'UNIX';
+    # Rob: getpwuid() is unfortunately UNIX specific. On brain dead OS'es this
+    #    : can generate a 'getpwuid() not implemented' exception, even though
+    #    : it's never called.  Found under DOS/Win with the DJGPP perl port.
+    #    : Refer to getpwuid() only at run-time if we're fortunate and have  UNIX.
+    # unshift(@TEMP,(eval {(getpwuid($>))[7]}).'/tmp') if $CGI::OS eq 'UNIX' and $> != 0;
+
+    for (@TEMP) {
+      do {$TMPDIRECTORY = $_; last} if -d $_ && -w _;
+    }
+  }
+  $TMPDIRECTORY  = $MAC ? "" : "." unless $TMPDIRECTORY;
+}
+
+find_tempdir();
+
+$MAXTRIES = 5000;
+
+# cute feature, but overload implementation broke it
+# %OVERLOAD = ('""'=>'as_string');
+*CGITempFile::AUTOLOAD = \&CGI::AUTOLOAD;
+
+sub DESTROY {
+    my($self) = @_;
+    $$self =~ m!^([a-zA-Z0-9_ \'\":/.\$\\~-]+)$! || return;
+    my $safe = $1;             # untaint operation
+    unlink $safe;              # get rid of the file
+}
+
+###############################################################################
+################# THESE FUNCTIONS ARE AUTOLOADED ON DEMAND ####################
+###############################################################################
+$AUTOLOADED_ROUTINES = '';      # prevent -w error
+$AUTOLOADED_ROUTINES=<<'END_OF_AUTOLOAD';
+%SUBS = (
+
+'new' => <<'END_OF_FUNC',
+sub new {
+    my($package,$sequence) = @_;
+    my $filename;
+    unless (-w $TMPDIRECTORY) {
+        $TMPDIRECTORY = undef;
+        find_tempdir();
+    }
+    for (my $i = 0; $i < $MAXTRIES; $i++) {
+       last if ! -f ($filename = sprintf("\%s${SL}CGItemp%d", $TMPDIRECTORY, $sequence++));
+    }
+    # check that it is a more-or-less valid filename
+    # Note this same regex is also used elsewhere in the same file for Fh::new
+    return unless $filename =~ m!^([a-zA-Z0-9_ \'\":/.\$\\\+-]+)$!;
+    # this used to untaint, now it doesn't
+    # $filename = $1;
+    return bless \$filename;
+}
+END_OF_FUNC
+
+'as_string' => <<'END_OF_FUNC'
+sub as_string {
+    my($self) = @_;
+    return $$self;
+}
+END_OF_FUNC
+
+);
+END_OF_AUTOLOAD
+
+package CGI;
+
+# We get a whole bunch of warnings about "possibly uninitialized variables"
+# when running with the -w switch.  Touch them all once to get rid of the
+# warnings.  This is ugly and I hate it.
+if ($^W) {
+    $CGI::CGI = '';
+    $CGI::CGI=<<EOF;
+    $CGI::VERSION;
+    $MultipartBuffer::SPIN_LOOP_MAX;
+    $MultipartBuffer::CRLF;
+    $MultipartBuffer::TIMEOUT;
+    $MultipartBuffer::INITIAL_FILLUNIT;
+EOF
+    ;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+CGI - Handle Common Gateway Interface requests and responses
+
+=head1 SYNOPSIS
+
+    use CGI;
+
+    my $q = CGI->new;
+
+    # Process an HTTP request
+     @values  = $q->param('form_field');
+
+     $fh      = $q->upload('file_field');
+
+     $riddle  = $query->cookie('riddle_name');
+     %answers = $query->cookie('answers');
+
+    # Prepare various HTTP responses
+    print $q->header();
+    print $q->header('application/json');
+
+       $cookie1 = $q->cookie(-name=>'riddle_name', -value=>"The Sphynx's Question");
+       $cookie2 = $q->cookie(-name=>'answers', -value=>\%answers);
+    print $q->header(
+        -type    => 'image/gif',
+        -expires => '+3d',
+        -cookie  => [$cookie1,$cookie2]
+        );
+
+   print  $q->redirect('http://somewhere.else/in/movie/land');
+
+=head1 DESCRIPTION
+
+CGI.pm is a stable, complete and mature solution for processing and preparing
+HTTP requests and responses.  Major features including processing form
+submissions, file uploads, reading and writing cookies, query string generation
+and manipulation, and processing and preparing HTTP headers. Some HTML
+generation utilities are included as well.
+
+CGI.pm performs very well in in a vanilla CGI.pm environment and also comes
+with built-in support for mod_perl and mod_perl2 as well as FastCGI.
+
+It has the benefit of having developed and refined over 10 years with input
+from dozens of contributors and being deployed on thousands of websites.
+CGI.pm has been included in the Perl distribution since Perl 5.4, and has
+become a de-facto standard.
+
+=head2 PROGRAMMING STYLE
+
+There are two styles of programming with CGI.pm, an object-oriented
+style and a function-oriented style.  In the object-oriented style you
+create one or more CGI objects and then use object methods to create
+the various elements of the page.  Each CGI object starts out with the
+list of named parameters that were passed to your CGI script by the
+server.  You can modify the objects, save them to a file or database
+and recreate them.  Because each object corresponds to the "state" of
+the CGI script, and because each object's parameter list is
+independent of the others, this allows you to save the state of the
+script and restore it later.
+
+For example, using the object oriented style, here is how you create
+a simple "Hello World" HTML page:
+
+   #!/usr/local/bin/perl -w
+   use CGI;                             # load CGI routines
+   $q = CGI->new;                        # create new CGI object
+   print $q->header,                    # create the HTTP header
+         $q->start_html('hello world'), # start the HTML
+         $q->h1('hello world'),         # level 1 header
+         $q->end_html;                  # end the HTML
+
+In the function-oriented style, there is one default CGI object that
+you rarely deal with directly.  Instead you just call functions to
+retrieve CGI parameters, create HTML tags, manage cookies, and so
+on.  This provides you with a cleaner programming interface, but
+limits you to using one CGI object at a time.  The following example
+prints the same page, but uses the function-oriented interface.
+The main differences are that we now need to import a set of functions
+into our name space (usually the "standard" functions), and we don't
+need to create the CGI object.
+
+   #!/usr/local/bin/perl
+   use CGI qw/:standard/;           # load standard CGI routines
+   print header,                    # create the HTTP header
+         start_html('hello world'), # start the HTML
+         h1('hello world'),         # level 1 header
+         end_html;                  # end the HTML
+
+The examples in this document mainly use the object-oriented style.
+See HOW TO IMPORT FUNCTIONS for important information on
+function-oriented programming in CGI.pm
+
+=head2 CALLING CGI.PM ROUTINES
+
+Most CGI.pm routines accept several arguments, sometimes as many as 20
+optional ones!  To simplify this interface, all routines use a named
+argument calling style that looks like this:
+
+   print $q->header(-type=>'image/gif',-expires=>'+3d');
+
+Each argument name is preceded by a dash.  Neither case nor order
+matters in the argument list.  -type, -Type, and -TYPE are all
+acceptable.  In fact, only the first argument needs to begin with a
+dash.  If a dash is present in the first argument, CGI.pm assumes
+dashes for the subsequent ones.
+
+Several routines are commonly called with just one argument.  In the
+case of these routines you can provide the single argument without an
+argument name.  header() happens to be one of these routines.  In this
+case, the single argument is the document type.
+
+   print $q->header('text/html');
+
+Other such routines are documented below.
+
+Sometimes named arguments expect a scalar, sometimes a reference to an
+array, and sometimes a reference to a hash.  Often, you can pass any
+type of argument and the routine will do whatever is most appropriate.
+For example, the param() routine is used to set a CGI parameter to a
+single or a multi-valued value.  The two cases are shown below:
+
+   $q->param(-name=>'veggie',-value=>'tomato');
+   $q->param(-name=>'veggie',-value=>['tomato','tomahto','potato','potahto']);
+
+A large number of routines in CGI.pm actually aren't specifically
+defined in the module, but are generated automatically as needed.
+These are the "HTML shortcuts," routines that generate HTML tags for
+use in dynamically-generated pages.  HTML tags have both attributes
+(the attribute="value" pairs within the tag itself) and contents (the
+part between the opening and closing pairs.)  To distinguish between
+attributes and contents, CGI.pm uses the convention of passing HTML
+attributes as a hash reference as the first argument, and the
+contents, if any, as any subsequent arguments.  It works out like
+this:
+
+   Code                           Generated HTML
+   ----                           --------------
+   h1()                           <h1>
+   h1('some','contents');         <h1>some contents</h1>
+   h1({-align=>left});            <h1 align="LEFT">
+   h1({-align=>left},'contents'); <h1 align="LEFT">contents</h1>
+
+HTML tags are described in more detail later.
+
+Many newcomers to CGI.pm are puzzled by the difference between the
+calling conventions for the HTML shortcuts, which require curly braces
+around the HTML tag attributes, and the calling conventions for other
+routines, which manage to generate attributes without the curly
+brackets.  Don't be confused.  As a convenience the curly braces are
+optional in all but the HTML shortcuts.  If you like, you can use
+curly braces when calling any routine that takes named arguments.  For
+example:
+
+   print $q->header( {-type=>'image/gif',-expires=>'+3d'} );
+
+If you use the B<-w> switch, you will be warned that some CGI.pm argument
+names conflict with built-in Perl functions.  The most frequent of
+these is the -values argument, used to create multi-valued menus,
+radio button clusters and the like.  To get around this warning, you
+have several choices:
+
+=over 4
+
+=item 1.
+
+Use another name for the argument, if one is available. 
+For example, -value is an alias for -values.
+
+=item 2.
+
+Change the capitalization, e.g. -Values
+
+=item 3.
+
+Put quotes around the argument name, e.g. '-values'
+
+=back
+
+Many routines will do something useful with a named argument that it
+doesn't recognize.  For example, you can produce non-standard HTTP
+header fields by providing them as named arguments:
+
+  print $q->header(-type  =>  'text/html',
+                   -cost  =>  'Three smackers',
+                   -annoyance_level => 'high',
+                   -complaints_to   => 'bit bucket');
+
+This will produce the following nonstandard HTTP header:
+
+   HTTP/1.0 200 OK
+   Cost: Three smackers
+   Annoyance-level: high
+   Complaints-to: bit bucket
+   Content-type: text/html
+
+Notice the way that underscores are translated automatically into
+hyphens.  HTML-generating routines perform a different type of
+translation. 
+
+This feature allows you to keep up with the rapidly changing HTTP and
+HTML "standards".
+
+=head2 CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
+
+     $query = CGI->new;
+
+This will parse the input (from POST, GET and DELETE methods) and store
+it into a perl5 object called $query. 
+
+Any filehandles from file uploads will have their position reset to 
+the beginning of the file. 
+
+=head2 CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
+
+     $query = CGI->new(INPUTFILE);
+
+If you provide a file handle to the new() method, it will read
+parameters from the file (or STDIN, or whatever).  The file can be in
+any of the forms describing below under debugging (i.e. a series of
+newline delimited TAG=VALUE pairs will work).  Conveniently, this type
+of file is created by the save() method (see below).  Multiple records
+can be saved and restored.
+
+Perl purists will be pleased to know that this syntax accepts
+references to file handles, or even references to filehandle globs,
+which is the "official" way to pass a filehandle:
+
+    $query = CGI->new(\*STDIN);
+
+You can also initialize the CGI object with a FileHandle or IO::File
+object.
+
+If you are using the function-oriented interface and want to
+initialize CGI state from a file handle, the way to do this is with
+B<restore_parameters()>.  This will (re)initialize the
+default CGI object from the indicated file handle.
+
+    open (IN,"test.in") || die;
+    restore_parameters(IN);
+    close IN;
+
+You can also initialize the query object from a hash
+reference:
+
+    $query = CGI->new( {'dinosaur'=>'barney',
+                      'song'=>'I love you',
+                      'friends'=>[qw/Jessica George Nancy/]}
+                   );
+
+or from a properly formatted, URL-escaped query string:
+
+    $query = CGI->new('dinosaur=barney&color=purple');
+
+or from a previously existing CGI object (currently this clones the
+parameter list, but none of the other object-specific fields, such as
+autoescaping):
+
+    $old_query = CGI->new;
+    $new_query = CGI->new($old_query);
+
+To create an empty query, initialize it from an empty string or hash:
+
+   $empty_query = CGI->new("");
+
+       -or-
+
+   $empty_query = CGI->new({});
+
+=head2 FETCHING A LIST OF KEYWORDS FROM THE QUERY:
+
+     @keywords = $query->keywords
+
+If the script was invoked as the result of an <ISINDEX> search, the
+parsed keywords can be obtained as an array using the keywords() method.
+
+=head2 FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
+
+     @names = $query->param
+
+If the script was invoked with a parameter list
+(e.g. "name1=value1&name2=value2&name3=value3"), the param() method
+will return the parameter names as a list.  If the script was invoked
+as an <ISINDEX> script and contains a string without ampersands
+(e.g. "value1+value2+value3") , there will be a single parameter named
+"keywords" containing the "+"-delimited keywords.
+
+NOTE: As of version 1.5, the array of parameter names returned will
+be in the same order as they were submitted by the browser.
+Usually this order is the same as the order in which the 
+parameters are defined in the form (however, this isn't part
+of the spec, and so isn't guaranteed).
+
+=head2 FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
+
+    @values = $query->param('foo');
+
+             -or-
+
+    $value = $query->param('foo');
+
+Pass the param() method a single argument to fetch the value of the
+named parameter. If the parameter is multivalued (e.g. from multiple
+selections in a scrolling list), you can ask to receive an array.  Otherwise
+the method will return a single value.
+
+If a value is not given in the query string, as in the queries
+"name1=&name2=", it will be returned as an empty string.
+
+
+If the parameter does not exist at all, then param() will return undef
+in a scalar context, and the empty list in a list context.
+
+
+=head2 SETTING THE VALUE(S) OF A NAMED PARAMETER:
+
+    $query->param('foo','an','array','of','values');
+
+This sets the value for the named parameter 'foo' to an array of
+values.  This is one way to change the value of a field AFTER
+the script has been invoked once before.  (Another way is with
+the -override parameter accepted by all methods that generate
+form elements.)
+
+param() also recognizes a named parameter style of calling described
+in more detail later:
+
+    $query->param(-name=>'foo',-values=>['an','array','of','values']);
+
+                             -or-
+
+    $query->param(-name=>'foo',-value=>'the value');
+
+=head2 APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
+
+   $query->append(-name=>'foo',-values=>['yet','more','values']);
+
+This adds a value or list of values to the named parameter.  The
+values are appended to the end of the parameter if it already exists.
+Otherwise the parameter is created.  Note that this method only
+recognizes the named argument calling syntax.
+
+=head2 IMPORTING ALL PARAMETERS INTO A NAMESPACE:
+
+   $query->import_names('R');
+
+This creates a series of variables in the 'R' namespace.  For example,
+$R::foo, @R:foo.  For keyword lists, a variable @R::keywords will appear.
+If no namespace is given, this method will assume 'Q'.
+WARNING:  don't import anything into 'main'; this is a major security
+risk!!!!
+
+NOTE 1: Variable names are transformed as necessary into legal Perl
+variable names.  All non-legal characters are transformed into
+underscores.  If you need to keep the original names, you should use
+the param() method instead to access CGI variables by name.
+
+NOTE 2: In older versions, this method was called B<import()>.  As of version 2.20, 
+this name has been removed completely to avoid conflict with the built-in
+Perl module B<import> operator.
+
+=head2 DELETING A PARAMETER COMPLETELY:
+
+    $query->delete('foo','bar','baz');
+
+This completely clears a list of parameters.  It sometimes useful for
+resetting parameters that you don't want passed down between script
+invocations.
+
+If you are using the function call interface, use "Delete()" instead
+to avoid conflicts with Perl's built-in delete operator.
+
+=head2 DELETING ALL PARAMETERS:
+
+   $query->delete_all();
+
+This clears the CGI object completely.  It might be useful to ensure
+that all the defaults are taken when you create a fill-out form.
+
+Use Delete_all() instead if you are using the function call interface.
+
+=head2 HANDLING NON-URLENCODED ARGUMENTS
+
+
+If POSTed data is not of type application/x-www-form-urlencoded or
+multipart/form-data, then the POSTed data will not be processed, but
+instead be returned as-is in a parameter named POSTDATA.  To retrieve
+it, use code like this:
+
+   my $data = $query->param('POSTDATA');
+
+Likewise if PUTed data can be retrieved with code like this:
+
+   my $data = $query->param('PUTDATA');
+
+(If you don't know what the preceding means, don't worry about it.  It
+only affects people trying to use CGI for XML processing and other
+specialized tasks.)
+
+
+=head2 DIRECT ACCESS TO THE PARAMETER LIST:
+
+   $q->param_fetch('address')->[1] = '1313 Mockingbird Lane';
+   unshift @{$q->param_fetch(-name=>'address')},'George Munster';
+
+If you need access to the parameter list in a way that isn't covered
+by the methods given in the previous sections, you can obtain a direct 
+reference to it by
+calling the B<param_fetch()> method with the name of the parameter.  This
+will return an array reference to the named parameter, which you then
+can manipulate in any way you like.
+
+You can also use a named argument style using the B<-name> argument.
+
+=head2 FETCHING THE PARAMETER LIST AS A HASH:
+
+    $params = $q->Vars;
+    print $params->{'address'};
+    @foo = split("\0",$params->{'foo'});
+    %params = $q->Vars;
+
+    use CGI ':cgi-lib';
+    $params = Vars;
+
+Many people want to fetch the entire parameter list as a hash in which
+the keys are the names of the CGI parameters, and the values are the
+parameters' values.  The Vars() method does this.  Called in a scalar
+context, it returns the parameter list as a tied hash reference.
+Changing a key changes the value of the parameter in the underlying
+CGI parameter list.  Called in a list context, it returns the
+parameter list as an ordinary hash.  This allows you to read the
+contents of the parameter list, but not to change it.
+
+When using this, the thing you must watch out for are multivalued CGI
+parameters.  Because a hash cannot distinguish between scalar and
+list context, multivalued parameters will be returned as a packed
+string, separated by the "\0" (null) character.  You must split this
+packed string in order to get at the individual values.  This is the
+convention introduced long ago by Steve Brenner in his cgi-lib.pl
+module for Perl version 4.
+
+If you wish to use Vars() as a function, import the I<:cgi-lib> set of
+function calls (also see the section on CGI-LIB compatibility).
+
+=head2 SAVING THE STATE OF THE SCRIPT TO A FILE:
+
+    $query->save(\*FILEHANDLE)
+
+This will write the current state of the form to the provided
+filehandle.  You can read it back in by providing a filehandle
+to the new() method.  Note that the filehandle can be a file, a pipe,
+or whatever!
+
+The format of the saved file is:
+
+       NAME1=VALUE1
+       NAME1=VALUE1'
+       NAME2=VALUE2
+       NAME3=VALUE3
+       =
+
+Both name and value are URL escaped.  Multi-valued CGI parameters are
+represented as repeated names.  A session record is delimited by a
+single = symbol.  You can write out multiple records and read them
+back in with several calls to B<new>.  You can do this across several
+sessions by opening the file in append mode, allowing you to create
+primitive guest books, or to keep a history of users' queries.  Here's
+a short example of creating multiple session records:
+
+   use CGI;
+
+   open (OUT,'>>','test.out') || die;
+   $records = 5;
+   for (0..$records) {
+       my $q = CGI->new;
+       $q->param(-name=>'counter',-value=>$_);
+       $q->save(\*OUT);
+   }
+   close OUT;
+
+   # reopen for reading
+   open (IN,'<','test.out') || die;
+   while (!eof(IN)) {
+       my $q = CGI->new(\*IN);
+       print $q->param('counter'),"\n";
+   }
+
+The file format used for save/restore is identical to that used by the
+Whitehead Genome Center's data exchange format "Boulderio", and can be
+manipulated and even databased using Boulderio utilities.  See
+
+  http://stein.cshl.org/boulder/
+
+for further details.
+
+If you wish to use this method from the function-oriented (non-OO)
+interface, the exported name for this method is B<save_parameters()>.
+
+=head2 RETRIEVING CGI ERRORS
+
+Errors can occur while processing user input, particularly when
+processing uploaded files.  When these errors occur, CGI will stop
+processing and return an empty parameter list.  You can test for
+the existence and nature of errors using the I<cgi_error()> function.
+The error messages are formatted as HTTP status codes. You can either
+incorporate the error text into an HTML page, or use it as the value
+of the HTTP status:
+
+    my $error = $q->cgi_error;
+    if ($error) {
+       print $q->header(-status=>$error),
+             $q->start_html('Problems'),
+              $q->h2('Request not processed'),
+             $q->strong($error);
+        exit 0;
+    }
+
+When using the function-oriented interface (see the next section),
+errors may only occur the first time you call I<param()>. Be ready
+for this!
+
+=head2 USING THE FUNCTION-ORIENTED INTERFACE
+
+To use the function-oriented interface, you must specify which CGI.pm
+routines or sets of routines to import into your script's namespace.
+There is a small overhead associated with this importation, but it
+isn't much.
+
+   use CGI <list of methods>;
+
+The listed methods will be imported into the current package; you can
+call them directly without creating a CGI object first.  This example
+shows how to import the B<param()> and B<header()>
+methods, and then use them directly:
+
+   use CGI 'param','header';
+   print header('text/plain');
+   $zipcode = param('zipcode');
+
+More frequently, you'll import common sets of functions by referring
+to the groups by name.  All function sets are preceded with a ":"
+character as in ":html3" (for tags defined in the HTML 3 standard).
+
+Here is a list of the function sets you can import:
+
+=over 4
+
+=item B<:cgi>
+
+Import all CGI-handling methods, such as B<param()>, B<path_info()>
+and the like.
+
+=item B<:form>
+
+Import all fill-out form generating methods, such as B<textfield()>.
+
+=item B<:html2>
+
+Import all methods that generate HTML 2.0 standard elements.
+
+=item B<:html3>
+
+Import all methods that generate HTML 3.0 elements (such as
+<table>, <super> and <sub>).
+
+=item B<:html4>
+
+Import all methods that generate HTML 4 elements (such as
+<abbrev>, <acronym> and <thead>).
+
+=item B<:netscape>
+
+Import the <blink>, <fontsize> and <center> tags. 
+
+=item B<:html>
+
+Import all HTML-generating shortcuts (i.e. 'html2', 'html3', 'html4' and 'netscape')
+
+=item B<:standard>
+
+Import "standard" features, 'html2', 'html3', 'html4', 'form' and 'cgi'.
+
+=item B<:all>
+
+Import all the available methods.  For the full list, see the CGI.pm
+code, where the variable %EXPORT_TAGS is defined.
+
+=back
+
+If you import a function name that is not part of CGI.pm, the module
+will treat it as a new HTML tag and generate the appropriate
+subroutine.  You can then use it like any other HTML tag.  This is to
+provide for the rapidly-evolving HTML "standard."  For example, say
+Microsoft comes out with a new tag called <gradient> (which causes the
+user's desktop to be flooded with a rotating gradient fill until his
+machine reboots).  You don't need to wait for a new version of CGI.pm
+to start using it immediately:
+
+   use CGI qw/:standard :html3 gradient/;
+   print gradient({-start=>'red',-end=>'blue'});
+
+Note that in the interests of execution speed CGI.pm does B<not> use
+the standard L<Exporter> syntax for specifying load symbols.  This may
+change in the future.
+
+If you import any of the state-maintaining CGI or form-generating
+methods, a default CGI object will be created and initialized
+automatically the first time you use any of the methods that require
+one to be present.  This includes B<param()>, B<textfield()>,
+B<submit()> and the like.  (If you need direct access to the CGI
+object, you can find it in the global variable B<$CGI::Q>).  By
+importing CGI.pm methods, you can create visually elegant scripts:
+
+   use CGI qw/:standard/;
+   print 
+       header,
+       start_html('Simple Script'),
+       h1('Simple Script'),
+       start_form,
+       "What's your name? ",textfield('name'),p,
+       "What's the combination?",
+       checkbox_group(-name=>'words',
+                     -values=>['eenie','meenie','minie','moe'],
+                     -defaults=>['eenie','moe']),p,
+       "What's your favorite color?",
+       popup_menu(-name=>'color',
+                 -values=>['red','green','blue','chartreuse']),p,
+       submit,
+       end_form,
+       hr,"\n";
+
+    if (param) {
+       print 
+          "Your name is ",em(param('name')),p,
+          "The keywords are: ",em(join(", ",param('words'))),p,
+          "Your favorite color is ",em(param('color')),".\n";
+    }
+    print end_html;
+
+=head2 PRAGMAS
+
+In addition to the function sets, there are a number of pragmas that
+you can import.  Pragmas, which are always preceded by a hyphen,
+change the way that CGI.pm functions in various ways.  Pragmas,
+function sets, and individual functions can all be imported in the
+same use() line.  For example, the following use statement imports the
+standard set of functions and enables debugging mode (pragma
+-debug):
+
+   use CGI qw/:standard -debug/;
+
+The current list of pragmas is as follows:
+
+=over 4
+
+=item -any
+
+When you I<use CGI -any>, then any method that the query object
+doesn't recognize will be interpreted as a new HTML tag.  This allows
+you to support the next I<ad hoc> HTML
+extension.  This lets you go wild with new and unsupported tags:
+
+   use CGI qw(-any);
+   $q=CGI->new;
+   print $q->gradient({speed=>'fast',start=>'red',end=>'blue'});
+
+Since using <cite>any</cite> causes any mistyped method name
+to be interpreted as an HTML tag, use it with care or not at
+all.
+
+=item -compile
+
+This causes the indicated autoloaded methods to be compiled up front,
+rather than deferred to later.  This is useful for scripts that run
+for an extended period of time under FastCGI or mod_perl, and for
+those destined to be crunched by Malcolm Beattie's Perl compiler.  Use
+it in conjunction with the methods or method families you plan to use.
+
+   use CGI qw(-compile :standard :html3);
+
+or even
+
+   use CGI qw(-compile :all);
+
+Note that using the -compile pragma in this way will always have
+the effect of importing the compiled functions into the current
+namespace.  If you want to compile without importing use the
+compile() method instead:
+
+   use CGI();
+   CGI->compile();
+
+This is particularly useful in a mod_perl environment, in which you
+might want to precompile all CGI routines in a startup script, and
+then import the functions individually in each mod_perl script.
+
+=item -nosticky
+
+By default the CGI module implements a state-preserving behavior
+called "sticky" fields.  The way this works is that if you are
+regenerating a form, the methods that generate the form field values
+will interrogate param() to see if similarly-named parameters are
+present in the query string. If they find a like-named parameter, they
+will use it to set their default values.
+
+Sometimes this isn't what you want.  The B<-nosticky> pragma prevents
+this behavior.  You can also selectively change the sticky behavior in
+each element that you generate.
+
+=item -tabindex
+
+Automatically add tab index attributes to each form field. With this
+option turned off, you can still add tab indexes manually by passing a
+-tabindex option to each field-generating method.
+
+=item -no_undef_params
+
+This keeps CGI.pm from including undef params in the parameter list.
+
+=item -no_xhtml
+
+By default, CGI.pm versions 2.69 and higher emit XHTML
+(http://www.w3.org/TR/xhtml1/).  The -no_xhtml pragma disables this
+feature.  Thanks to Michalis Kabrianis <kabrianis@hellug.gr> for this
+feature.
+
+If start_html()'s -dtd parameter specifies an HTML 2.0, 
+3.2, 4.0 or 4.01 DTD, 
+XHTML will automatically be disabled without needing to use this 
+pragma.
+
+=item -utf8
+
+This makes CGI.pm treat all parameters as UTF-8 strings. Use this with
+care, as it will interfere with the processing of binary uploads. It
+is better to manually select which fields are expected to return utf-8
+strings and convert them using code like this:
+
+ use Encode;
+ my $arg = decode utf8=>param('foo');
+
+=item -nph
+
+This makes CGI.pm produce a header appropriate for an NPH (no
+parsed header) script.  You may need to do other things as well
+to tell the server that the script is NPH.  See the discussion
+of NPH scripts below.
+
+=item -newstyle_urls
+
+Separate the name=value pairs in CGI parameter query strings with
+semicolons rather than ampersands.  For example:
+
+   ?name=fred;age=24;favorite_color=3
+
+Semicolon-delimited query strings are always accepted, and will be emitted by
+self_url() and query_string(). newstyle_urls became the default in version
+2.64.
+
+=item -oldstyle_urls
+
+Separate the name=value pairs in CGI parameter query strings with
+ampersands rather than semicolons.  This is no longer the default.
+
+=item -autoload
+
+This overrides the autoloader so that any function in your program
+that is not recognized is referred to CGI.pm for possible evaluation.
+This allows you to use all the CGI.pm functions without adding them to
+your symbol table, which is of concern for mod_perl users who are
+worried about memory consumption.  I<Warning:> when
+I<-autoload> is in effect, you cannot use "poetry mode"
+(functions without the parenthesis).  Use I<hr()> rather
+than I<hr>, or add something like I<use subs qw/hr p header/> 
+to the top of your script.
+
+=item -no_debug
+
+This turns off the command-line processing features.  If you want to
+run a CGI.pm script from the command line to produce HTML, and you
+don't want it to read CGI parameters from the command line or STDIN,
+then use this pragma:
+
+   use CGI qw(-no_debug :standard);
+
+=item -debug
+
+This turns on full debugging.  In addition to reading CGI arguments
+from the command-line processing, CGI.pm will pause and try to read
+arguments from STDIN, producing the message "(offline mode: enter
+name=value pairs on standard input)" features.
+
+See the section on debugging for more details.
+
+=item -private_tempfiles
+
+CGI.pm can process uploaded file. Ordinarily it spools the uploaded
+file to a temporary directory, then deletes the file when done.
+However, this opens the risk of eavesdropping as described in the file
+upload section.  Another CGI script author could peek at this data
+during the upload, even if it is confidential information. On Unix
+systems, the -private_tempfiles pragma will cause the temporary file
+to be unlinked as soon as it is opened and before any data is written
+into it, reducing, but not eliminating the risk of eavesdropping
+(there is still a potential race condition).  To make life harder for
+the attacker, the program chooses tempfile names by calculating a 32
+bit checksum of the incoming HTTP headers.
+
+To ensure that the temporary file cannot be read by other CGI scripts,
+use suEXEC or a CGI wrapper program to run your script.  The temporary
+file is created with mode 0600 (neither world nor group readable).
+
+The temporary directory is selected using the following algorithm:
+
+    1. if $CGITempFile::TMPDIRECTORY is already set, use that
+
+    2. if the environment variable TMPDIR exists, use the location
+    indicated.
+
+    3. Otherwise try the locations /usr/tmp, /var/tmp, C:\temp,
+    /tmp, /temp, ::Temporary Items, and \WWW_ROOT.
+
+Each of these locations is checked that it is a directory and is
+writable.  If not, the algorithm tries the next choice.
+
+=back
+
+=head2 SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
+
+Many of the methods generate HTML tags.  As described below, tag
+functions automatically generate both the opening and closing tags.
+For example:
+
+  print h1('Level 1 Header');
+
+produces
+
+  <h1>Level 1 Header</h1>
+
+There will be some times when you want to produce the start and end
+tags yourself.  In this case, you can use the form start_I<tag_name>
+and end_I<tag_name>, as in:
+
+  print start_h1,'Level 1 Header',end_h1;
+
+With a few exceptions (described below), start_I<tag_name> and
+end_I<tag_name> functions are not generated automatically when you
+I<use CGI>.  However, you can specify the tags you want to generate
+I<start/end> functions for by putting an asterisk in front of their
+name, or, alternatively, requesting either "start_I<tag_name>" or
+"end_I<tag_name>" in the import list.
+
+Example:
+
+  use CGI qw/:standard *table start_ul/;
+
+In this example, the following functions are generated in addition to
+the standard ones:
+
+=over 4
+
+=item 1. start_table() (generates a <table> tag)
+
+=item 2. end_table() (generates a </table> tag)
+
+=item 3. start_ul() (generates a <ul> tag)
+
+=item 4. end_ul() (generates a </ul> tag)
+
+=back
+
+=head1 GENERATING DYNAMIC DOCUMENTS
+
+Most of CGI.pm's functions deal with creating documents on the fly.
+Generally you will produce the HTTP header first, followed by the
+document itself.  CGI.pm provides functions for generating HTTP
+headers of various types as well as for generating HTML.  For creating
+GIF images, see the GD.pm module.
+
+Each of these functions produces a fragment of HTML or HTTP which you
+can print out directly so that it displays in the browser window,
+append to a string, or save to a file for later use.
+
+=head2 CREATING A STANDARD HTTP HEADER:
+
+Normally the first thing you will do in any CGI script is print out an
+HTTP header.  This tells the browser what type of document to expect,
+and gives other optional information, such as the language, expiration
+date, and whether to cache the document.  The header can also be
+manipulated for special purposes, such as server push and pay per view
+pages.
+
+       print header;
+
+            -or-
+
+       print header('image/gif');
+
+            -or-
+
+       print header('text/html','204 No response');
+
+            -or-
+
+       print header(-type=>'image/gif',
+                            -nph=>1,
+                            -status=>'402 Payment required',
+                            -expires=>'+3d',
+                            -cookie=>$cookie,
+                             -charset=>'utf-7',
+                             -attachment=>'foo.gif',
+                            -Cost=>'$2.00');
+
+header() returns the Content-type: header.  You can provide your own
+MIME type if you choose, otherwise it defaults to text/html.  An
+optional second parameter specifies the status code and a human-readable
+message.  For example, you can specify 204, "No response" to create a
+script that tells the browser to do nothing at all. Note that RFC 2616 expects
+the human-readable phase to be there as well as the numeric status code. 
+
+The last example shows the named argument style for passing arguments
+to the CGI methods using named parameters.  Recognized parameters are
+B<-type>, B<-status>, B<-expires>, and B<-cookie>.  Any other named
+parameters will be stripped of their initial hyphens and turned into
+header fields, allowing you to specify any HTTP header you desire.
+Internal underscores will be turned into hyphens:
+
+    print header(-Content_length=>3002);
+
+Most browsers will not cache the output from CGI scripts.  Every time
+the browser reloads the page, the script is invoked anew.  You can
+change this behavior with the B<-expires> parameter.  When you specify
+an absolute or relative expiration interval with this parameter, some
+browsers and proxy servers will cache the script's output until the
+indicated expiration date.  The following forms are all valid for the
+-expires field:
+
+       +30s                              30 seconds from now
+       +10m                              ten minutes from now
+       +1h                               one hour from now
+       -1d                               yesterday (i.e. "ASAP!")
+       now                               immediately
+       +3M                               in three months
+       +10y                              in ten years time
+       Thursday, 25-Apr-1999 00:40:33 GMT  at the indicated time & date
+
+The B<-cookie> parameter generates a header that tells the browser to provide
+a "magic cookie" during all subsequent transactions with your script.
+Some cookies have a special format that includes interesting attributes
+such as expiration time.  Use the cookie() method to create and retrieve
+session cookies.
+
+The B<-nph> parameter, if set to a true value, will issue the correct
+headers to work with a NPH (no-parse-header) script.  This is important
+to use with certain servers that expect all their scripts to be NPH.
+
+The B<-charset> parameter can be used to control the character set
+sent to the browser.  If not provided, defaults to ISO-8859-1.  As a
+side effect, this sets the charset() method as well.
+
+The B<-attachment> parameter can be used to turn the page into an
+attachment.  Instead of displaying the page, some browsers will prompt
+the user to save it to disk.  The value of the argument is the
+suggested name for the saved file.  In order for this to work, you may
+have to set the B<-type> to "application/octet-stream".
+
+The B<-p3p> parameter will add a P3P tag to the outgoing header.  The
+parameter can be an arrayref or a space-delimited string of P3P tags.
+For example:
+
+   print header(-p3p=>[qw(CAO DSP LAW CURa)]);
+   print header(-p3p=>'CAO DSP LAW CURa');
+
+In either case, the outgoing header will be formatted as:
+
+  P3P: policyref="/w3c/p3p.xml" cp="CAO DSP LAW CURa"
+
+CGI.pm will accept valid multi-line headers when each line is separated with a
+CRLF value ("\r\n" on most platforms) followed by at least one space. For example:
+
+    print header( -ingredients => "ham\r\n\seggs\r\n\sbacon" );
+
+Invalid multi-line header input will trigger in an exception. When multi-line headers
+are received, CGI.pm will always output them back as a single line, according to the
+folding rules of RFC 2616: the newlines will be removed, while the white space remains.
+
+=head2 GENERATING A REDIRECTION HEADER
+
+   print $q->redirect('http://somewhere.else/in/movie/land');
+
+Sometimes you don't want to produce a document yourself, but simply
+redirect the browser elsewhere, perhaps choosing a URL based on the
+time of day or the identity of the user.  
+
+The redirect() method redirects the browser to a different URL.  If
+you use redirection like this, you should B<not> print out a header as
+well.
+
+You should always use full URLs (including the http: or ftp: part) in
+redirection requests.  Relative URLs will not work correctly.
+
+You can also use named arguments:
+
+    print $q->redirect(
+        -uri=>'http://somewhere.else/in/movie/land',
+           -nph=>1,
+         -status=>'301 Moved Permanently');
+
+All names arguments recognized by header() are also recognized by
+redirect(). However, most HTTP headers, including those generated by
+-cookie and -target, are ignored by the browser.
+
+The B<-nph> parameter, if set to a true value, will issue the correct
+headers to work with a NPH (no-parse-header) script.  This is important
+to use with certain servers, such as Microsoft IIS, which
+expect all their scripts to be NPH.
+
+The B<-status> parameter will set the status of the redirect.  HTTP
+defines three different possible redirection status codes:
+
+     301 Moved Permanently
+     302 Found
+     303 See Other
+
+The default if not specified is 302, which means "moved temporarily."
+You may change the status to another status code if you wish.  Be
+advised that changing the status to anything other than 301, 302 or
+303 will probably break redirection.
+
+Note that the human-readable phrase is also expected to be present to conform
+with RFC 2616, section 6.1.
+
+=head2 CREATING THE HTML DOCUMENT HEADER
+
+   print start_html(-title=>'Secrets of the Pyramids',
+                           -author=>'fred@capricorn.org',
+                           -base=>'true',
+                           -target=>'_blank',
+                           -meta=>{'keywords'=>'pharaoh secret mummy',
+                                   'copyright'=>'copyright 1996 King Tut'},
+                           -style=>{'src'=>'/styles/style1.css'},
+                           -BGCOLOR=>'blue');
+
+The start_html() routine creates the top of the
+page, along with a lot of optional information that controls the
+page's appearance and behavior.
+
+This method returns a canned HTML header and the opening <body> tag.
+All parameters are optional.  In the named parameter form, recognized
+parameters are -title, -author, -base, -xbase, -dtd, -lang and -target
+(see below for the explanation).  Any additional parameters you
+provide, such as the unofficial BGCOLOR attribute, are added
+to the <body> tag.  Additional parameters must be proceeded by a
+hyphen.
+
+The argument B<-xbase> allows you to provide an HREF for the <base> tag
+different from the current location, as in
+
+    -xbase=>"http://home.mcom.com/"
+
+All relative links will be interpreted relative to this tag.
+
+The argument B<-target> allows you to provide a default target frame
+for all the links and fill-out forms on the page.  B<This is a
+non-standard HTTP feature which only works with some browsers!>
+
+    -target=>"answer_window"
+
+All relative links will be interpreted relative to this tag.
+You add arbitrary meta information to the header with the B<-meta>
+argument.  This argument expects a reference to a hash
+containing name/value pairs of meta information.  These will be turned
+into a series of header <meta> tags that look something like this:
+
+    <meta name="keywords" content="pharaoh secret mummy">
+    <meta name="description" content="copyright 1996 King Tut">
+
+To create an HTTP-EQUIV type of <meta> tag, use B<-head>, described
+below.
+
+The B<-style> argument is used to incorporate cascading stylesheets
+into your code.  See the section on CASCADING STYLESHEETS for more
+information.
+
+The B<-lang> argument is used to incorporate a language attribute into
+the <html> tag.  For example:
+
+    print $q->start_html(-lang=>'fr-CA');
+
+The default if not specified is "en-US" for US English, unless the 
+-dtd parameter specifies an HTML 2.0 or 3.2 DTD, in which case the
+lang attribute is left off.  You can force the lang attribute to left
+off in other cases by passing an empty string (-lang=>'').
+
+The B<-encoding> argument can be used to specify the character set for
+XHTML.  It defaults to iso-8859-1 if not specified.
+
+The B<-dtd> argument can be used to specify a public DTD identifier string. For example:
+
+    -dtd => '-//W3C//DTD HTML 4.01 Transitional//EN')
+
+Alternatively, it can take public and system DTD identifiers as an array:
+
+    dtd => [ '-//W3C//DTD HTML 4.01 Transitional//EN', 'http://www.w3.org/TR/html4/loose.dtd' ]
+
+For the public DTD identifier to be considered, it must be valid. Otherwise it
+will be replaced by the default DTD. If the public DTD contains 'XHTML', CGI.pm
+will emit XML.
+
+The B<-declare_xml> argument, when used in conjunction with XHTML,
+will put a <?xml> declaration at the top of the HTML header. The sole
+purpose of this declaration is to declare the character set
+encoding. In the absence of -declare_xml, the output HTML will contain
+a <meta> tag that specifies the encoding, allowing the HTML to pass
+most validators.  The default for -declare_xml is false.
+
+You can place other arbitrary HTML elements to the <head> section with the
+B<-head> tag.  For example, to place a <link> element in the
+head section, use this:
+
+    print start_html(-head=>Link({-rel=>'shortcut icon',
+                                 -href=>'favicon.ico'}));
+
+To incorporate multiple HTML elements into the <head> section, just pass an
+array reference:
+
+    print start_html(-head=>[ 
+                             Link({-rel=>'next',
+                                  -href=>'http://www.capricorn.com/s2.html'}),
+                            Link({-rel=>'previous',
+                                  -href=>'http://www.capricorn.com/s1.html'})
+                            ]
+                    );
+
+And here's how to create an HTTP-EQUIV <meta> tag:
+
+      print start_html(-head=>meta({-http_equiv => 'Content-Type',
+                                    -content    => 'text/html'}))
+
+
+JAVASCRIPTING: The B<-script>, B<-noScript>, B<-onLoad>,
+B<-onMouseOver>, B<-onMouseOut> and B<-onUnload> parameters are used
+to add JavaScript calls to your pages.  B<-script> should
+point to a block of text containing JavaScript function definitions.
+This block will be placed within a <script> block inside the HTML (not
+HTTP) header.  The block is placed in the header in order to give your
+page a fighting chance of having all its JavaScript functions in place
+even if the user presses the stop button before the page has loaded
+completely.  CGI.pm attempts to format the script in such a way that
+JavaScript-naive browsers will not choke on the code: unfortunately
+there are some browsers, such as Chimera for Unix, that get confused
+by it nevertheless.
+
+The B<-onLoad> and B<-onUnload> parameters point to fragments of JavaScript
+code to execute when the page is respectively opened and closed by the
+browser.  Usually these parameters are calls to functions defined in the
+B<-script> field:
+
+      $query = CGI->new;
+      print header;
+      $JSCRIPT=<<END;
+      // Ask a silly question
+      function riddle_me_this() {
+        var r = prompt("What walks on four legs in the morning, " +
+                      "two legs in the afternoon, " +
+                      "and three legs in the evening?");
+        response(r);
+      }
+      // Get a silly answer
+      function response(answer) {
+        if (answer == "man")
+           alert("Right you are!");
+        else
+           alert("Wrong!  Guess again.");
+      }
+      END
+      print start_html(-title=>'The Riddle of the Sphinx',
+                              -script=>$JSCRIPT);
+
+Use the B<-noScript> parameter to pass some HTML text that will be displayed on 
+browsers that do not have JavaScript (or browsers where JavaScript is turned
+off).
+
+The <script> tag, has several attributes including "type", "charset" and "src".
+"src" allows you to keep JavaScript code in an external file. To use these
+attributes pass a HASH reference in the B<-script> parameter containing one or
+more of -type, -src, or -code:
+
+    print $q->start_html(-title=>'The Riddle of the Sphinx',
+                        -script=>{-type=>'JAVASCRIPT',
+                                   -src=>'/javascript/sphinx.js'}
+                        );
+
+    print $q->(-title=>'The Riddle of the Sphinx',
+              -script=>{-type=>'PERLSCRIPT',
+                        -code=>'print "hello world!\n;"'}
+              );
+
+
+A final feature allows you to incorporate multiple <script> sections into the
+header.  Just pass the list of script sections as an array reference.
+this allows you to specify different source files for different dialects
+of JavaScript.  Example:
+
+     print $q->start_html(-title=>'The Riddle of the Sphinx',
+                          -script=>[
+                                    { -type => 'text/javascript',
+                                      -src      => '/javascript/utilities10.js'
+                                    },
+                                    { -type => 'text/javascript',
+                                      -src      => '/javascript/utilities11.js'
+                                    },
+                                    { -type => 'text/jscript',
+                                      -src      => '/javascript/utilities12.js'
+                                    },
+                                    { -type => 'text/ecmascript',
+                                      -src      => '/javascript/utilities219.js'
+                                    }
+                                 ]
+                             );
+
+The option "-language" is a synonym for -type, and is supported for
+backwards compatibility.
+
+The old-style positional parameters are as follows:
+
+=over 4
+
+=item B<Parameters:>
+
+=item 1.
+
+The title
+
+=item 2.
+
+The author's e-mail address (will create a <link rev="MADE"> tag if present
+
+=item 3.
+
+A 'true' flag if you want to include a <base> tag in the header.  This
+helps resolve relative addresses to absolute ones when the document is moved, 
+but makes the document hierarchy non-portable.  Use with care!
+
+=item 4, 5, 6...
+
+Any other parameters you want to include in the <body> tag.  This is a good
+place to put HTML extensions, such as colors and wallpaper patterns.
+
+=back
+
+=head2 ENDING THE HTML DOCUMENT:
+
+       print $q->end_html;
+
+This ends an HTML document by printing the </body></html> tags.
+
+=head2 CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
+
+    $myself = $q->self_url;
+    print q(<a href="$myself">I'm talking to myself.</a>);
+
+self_url() will return a URL, that, when selected, will reinvoke
+this script with all its state information intact.  This is most
+useful when you want to jump around within the document using
+internal anchors but you don't want to disrupt the current contents
+of the form(s).  Something like this will do the trick.
+
+     $myself = $q->self_url;
+     print "<a href=\"$myself#table1\">See table 1</a>";
+     print "<a href=\"$myself#table2\">See table 2</a>";
+     print "<a href=\"$myself#yourself\">See for yourself</a>";
+
+If you want more control over what's returned, using the B<url()>
+method instead.
+
+You can also retrieve the unprocessed query string with query_string():
+
+    $the_string = $q->query_string();
+
+The behavior of calling query_string is currently undefined when the HTTP method is
+something other than GET.
+
+=head2 OBTAINING THE SCRIPT'S URL
+
+    $full_url      = url();
+    $full_url      = url(-full=>1);  #alternative syntax
+    $relative_url  = url(-relative=>1);
+    $absolute_url  = url(-absolute=>1);
+    $url_with_path = url(-path_info=>1);
+    $url_with_path_and_query = url(-path_info=>1,-query=>1);
+    $netloc        = url(-base => 1);
+
+B<url()> returns the script's URL in a variety of formats.  Called
+without any arguments, it returns the full form of the URL, including
+host name and port number
+
+    http://your.host.com/path/to/script.cgi
+
+You can modify this format with the following named arguments:
+
+=over 4
+
+=item B<-absolute>
+
+If true, produce an absolute URL, e.g.
+
+    /path/to/script.cgi
+
+=item B<-relative>
+
+Produce a relative URL.  This is useful if you want to reinvoke your
+script with different parameters. For example:
+
+    script.cgi
+
+=item B<-full>
+
+Produce the full URL, exactly as if called without any arguments.
+This overrides the -relative and -absolute arguments.
+
+=item B<-path> (B<-path_info>)
+
+Append the additional path information to the URL.  This can be
+combined with B<-full>, B<-absolute> or B<-relative>.  B<-path_info>
+is provided as a synonym.
+
+=item B<-query> (B<-query_string>)
+
+Append the query string to the URL.  This can be combined with
+B<-full>, B<-absolute> or B<-relative>.  B<-query_string> is provided
+as a synonym.
+
+=item B<-base>
+
+Generate just the protocol and net location, as in http://www.foo.com:8000
+
+=item B<-rewrite>
+
+If Apache's mod_rewrite is turned on, then the script name and path
+info probably won't match the request that the user sent. Set
+-rewrite=>1 (default) to return URLs that match what the user sent
+(the original request URI). Set -rewrite=>0 to return URLs that match
+the URL after mod_rewrite's rules have run. 
+
+=back
+
+=head2 MIXING POST AND URL PARAMETERS
+
+   $color = url_param('color');
+
+It is possible for a script to receive CGI parameters in the URL as
+well as in the fill-out form by creating a form that POSTs to a URL
+containing a query string (a "?" mark followed by arguments).  The
+B<param()> method will always return the contents of the POSTed
+fill-out form, ignoring the URL's query string.  To retrieve URL
+parameters, call the B<url_param()> method.  Use it in the same way as
+B<param()>.  The main difference is that it allows you to read the
+parameters, but not set them.
+
+
+Under no circumstances will the contents of the URL query string
+interfere with similarly-named CGI parameters in POSTed forms.  If you
+try to mix a URL query string with a form submitted with the GET
+method, the results will not be what you expect.
+
+=head1 CREATING STANDARD HTML ELEMENTS:
+
+CGI.pm defines general HTML shortcut methods for many HTML tags.  HTML shortcuts are named after a single
+HTML element and return a fragment of HTML text. Example:
+
+   print $q->blockquote(
+                    "Many years ago on the island of",
+                    $q->a({href=>"http://crete.org/"},"Crete"),
+                    "there lived a Minotaur named",
+                    $q->strong("Fred."),
+                   ),
+       $q->hr;
+
+This results in the following HTML code (extra newlines have been
+added for readability):
+
+   <blockquote>
+   Many years ago on the island of
+   <a href="http://crete.org/">Crete</a> there lived
+   a minotaur named <strong>Fred.</strong> 
+   </blockquote>
+   <hr>
+
+If you find the syntax for calling the HTML shortcuts awkward, you can
+import them into your namespace and dispense with the object syntax
+completely (see the next section for more details):
+
+   use CGI ':standard';
+   print blockquote(
+      "Many years ago on the island of",
+      a({href=>"http://crete.org/"},"Crete"),
+      "there lived a minotaur named",
+      strong("Fred."),
+      ),
+      hr;
+
+=head2 PROVIDING ARGUMENTS TO HTML SHORTCUTS
+
+The HTML methods will accept zero, one or multiple arguments.  If you
+provide no arguments, you get a single tag:
+
+   print hr;   #  <hr>
+
+If you provide one or more string arguments, they are concatenated
+together with spaces and placed between opening and closing tags:
+
+   print h1("Chapter","1"); # <h1>Chapter 1</h1>"
+
+If the first argument is a hash reference, then the keys
+and values of the hash become the HTML tag's attributes:
+
+   print a({-href=>'fred.html',-target=>'_new'},
+      "Open a new frame");
+
+           <a href="fred.html",target="_new">Open a new frame</a>
+
+You may dispense with the dashes in front of the attribute names if
+you prefer:
+
+   print img {src=>'fred.gif',align=>'LEFT'};
+
+          <img align="LEFT" src="fred.gif">
+
+Sometimes an HTML tag attribute has no argument.  For example, ordered
+lists can be marked as COMPACT.  The syntax for this is an argument that
+that points to an undef string:
+
+   print ol({compact=>undef},li('one'),li('two'),li('three'));
+
+Prior to CGI.pm version 2.41, providing an empty ('') string as an
+attribute argument was the same as providing undef.  However, this has
+changed in order to accommodate those who want to create tags of the form 
+<img alt="">.  The difference is shown in these two pieces of code:
+
+   CODE                   RESULT
+   img({alt=>undef})      <img alt>
+   img({alt=>''})         <img alt="">
+
+=head2 THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
+
+One of the cool features of the HTML shortcuts is that they are
+distributive.  If you give them an argument consisting of a
+B<reference> to a list, the tag will be distributed across each
+element of the list.  For example, here's one way to make an ordered
+list:
+
+   print ul(
+             li({-type=>'disc'},['Sneezy','Doc','Sleepy','Happy'])
+           );
+
+This example will result in HTML output that looks like this:
+
+   <ul>
+     <li type="disc">Sneezy</li>
+     <li type="disc">Doc</li>
+     <li type="disc">Sleepy</li>
+     <li type="disc">Happy</li>
+   </ul>
+
+This is extremely useful for creating tables.  For example:
+
+   print table({-border=>undef},
+           caption('When Should You Eat Your Vegetables?'),
+           Tr({-align=>'CENTER',-valign=>'TOP'},
+           [
+              th(['Vegetable', 'Breakfast','Lunch','Dinner']),
+              td(['Tomatoes' , 'no', 'yes', 'yes']),
+              td(['Broccoli' , 'no', 'no',  'yes']),
+              td(['Onions'   , 'yes','yes', 'yes'])
+           ]
+           )
+        );
+
+=head2 HTML SHORTCUTS AND LIST INTERPOLATION
+
+Consider this bit of code:
+
+   print blockquote(em('Hi'),'mom!'));
+
+It will ordinarily return the string that you probably expect, namely:
+
+   <blockquote><em>Hi</em> mom!</blockquote>
+
+Note the space between the element "Hi" and the element "mom!".
+CGI.pm puts the extra space there using array interpolation, which is
+controlled by the magic $" variable.  Sometimes this extra space is
+not what you want, for example, when you are trying to align a series
+of images.  In this case, you can simply change the value of $" to an
+empty string.
+
+   {
+      local($") = '';
+      print blockquote(em('Hi'),'mom!'));
+    }
+
+I suggest you put the code in a block as shown here.  Otherwise the
+change to $" will affect all subsequent code until you explicitly
+reset it.
+
+=head2 NON-STANDARD HTML SHORTCUTS
+
+A few HTML tags don't follow the standard pattern for various
+reasons.  
+
+B<comment()> generates an HTML comment (<!-- comment -->).  Call it
+like
+
+    print comment('here is my comment');
+
+Because of conflicts with built-in Perl functions, the following functions
+begin with initial caps:
+
+    Select
+    Tr
+    Link
+    Delete
+    Accept
+    Sub
+
+In addition, start_html(), end_html(), start_form(), end_form(),
+start_multipart_form() and all the fill-out form tags are special.
+See their respective sections.
+
+=head2 AUTOESCAPING HTML
+
+By default, all HTML that is emitted by the form-generating functions
+is passed through a function called escapeHTML():
+
+=over 4
+
+=item $escaped_string = escapeHTML("unescaped string");
+
+Escape HTML formatting characters in a string.
+
+=back
+
+Provided that you have specified a character set of ISO-8859-1 (the
+default), the standard HTML escaping rules will be used.  The "<"
+character becomes "&lt;", ">" becomes "&gt;", "&" becomes "&amp;", and
+the quote character becomes "&quot;".  In addition, the hexadecimal
+0x8b and 0x9b characters, which some browsers incorrectly interpret
+as the left and right angle-bracket characters, are replaced by their
+numeric character entities ("&#8249" and "&#8250;").  If you manually change
+the charset, either by calling the charset() method explicitly or by
+passing a -charset argument to header(), then B<all> characters will
+be replaced by their numeric entities, since CGI.pm has no lookup
+table for all the possible encodings.
+
+C<escapeHTML()> expects the supplied string to be a character string. This means you
+should Encode::decode data received from "outside" and Encode::encode your
+strings before sending them back outside. If your source code UTF-8 encoded and
+you want to upgrade string literals in your source to character strings, you
+can use "use utf8". See L<perlunitut>, L<perlunifaq> and L<perlunicode> for more
+information on how Perl handles the difference between bytes and characters.
+
+The automatic escaping does not apply to other shortcuts, such as
+h1().  You should call escapeHTML() yourself on untrusted data in
+order to protect your pages against nasty tricks that people may enter
+into guestbooks, etc..  To change the character set, use charset().
+To turn autoescaping off completely, use autoEscape(0):
+
+=over 4
+
+=item $charset = charset([$charset]);
+
+Get or set the current character set.
+
+=item $flag = autoEscape([$flag]);
+
+Get or set the value of the autoescape flag.
+
+=back
+
+=head2 PRETTY-PRINTING HTML
+
+By default, all the HTML produced by these functions comes out as one
+long line without carriage returns or indentation. This is yuck, but
+it does reduce the size of the documents by 10-20%.  To get
+pretty-printed output, please use L<CGI::Pretty>, a subclass
+contributed by Brian Paulsen.
+
+=head1 CREATING FILL-OUT FORMS:
+
+I<General note>  The various form-creating methods all return strings
+to the caller, containing the tag or tags that will create the requested
+form element.  You are responsible for actually printing out these strings.
+It's set up this way so that you can place formatting tags
+around the form elements.
+
+I<Another note> The default values that you specify for the forms are only
+used the B<first> time the script is invoked (when there is no query
+string).  On subsequent invocations of the script (when there is a query
+string), the former values are used even if they are blank.  
+
+If you want to change the value of a field from its previous value, you have two
+choices:
+
+(1) call the param() method to set it.
+
+(2) use the -override (alias -force) parameter (a new feature in version 2.15).
+This forces the default value to be used, regardless of the previous value:
+
+   print textfield(-name=>'field_name',
+                          -default=>'starting value',
+                          -override=>1,
+                          -size=>50,
+                          -maxlength=>80);
+
+I<Yet another note> By default, the text and labels of form elements are
+escaped according to HTML rules.  This means that you can safely use
+"<CLICK ME>" as the label for a button.  However, it also interferes with
+your ability to incorporate special HTML character sequences, such as &Aacute;,
+into your fields.  If you wish to turn off automatic escaping, call the
+autoEscape() method with a false value immediately after creating the CGI object:
+
+   $query = CGI->new;
+   $query->autoEscape(0);
+
+Note that autoEscape() is exclusively used to effect the behavior of how some
+CGI.pm HTML generation functions handle escaping. Calling escapeHTML()
+explicitly will always escape the HTML.
+
+I<A Lurking Trap!> Some of the form-element generating methods return
+multiple tags.  In a scalar context, the tags will be concatenated
+together with spaces, or whatever is the current value of the $"
+global.  In a list context, the methods will return a list of
+elements, allowing you to modify them if you wish.  Usually you will
+not notice this behavior, but beware of this:
+
+    printf("%s\n",end_form())
+
+end_form() produces several tags, and only the first of them will be
+printed because the format only expects one value.
+
+<p>
+
+
+=head2 CREATING AN ISINDEX TAG
+
+   print isindex(-action=>$action);
+
+        -or-
+
+   print isindex($action);
+
+Prints out an <isindex> tag.  Not very exciting.  The parameter
+-action specifies the URL of the script to process the query.  The
+default is to process the query with the current script.
+
+=head2 STARTING AND ENDING A FORM
+
+    print start_form(-method=>$method,
+                   -action=>$action,
+                   -enctype=>$encoding);
+      <... various form stuff ...>
+    print end_form;
+
+       -or-
+
+    print start_form($method,$action,$encoding);
+      <... various form stuff ...>
+    print end_form;
+
+start_form() will return a <form> tag with the optional method,
+action and form encoding that you specify.  The defaults are:
+
+    method: POST
+    action: this script
+    enctype: application/x-www-form-urlencoded for non-XHTML
+             multipart/form-data for XHTML, see multipart/form-data below.
+
+end_form() returns the closing </form> tag.  
+
+Start_form()'s enctype argument tells the browser how to package the various
+fields of the form before sending the form to the server.  Two
+values are possible:
+
+B<Note:> These methods were previously named startform() and endform().
+These methods are now DEPRECATED.
+Please use start_form() and end_form() instead.
+
+=over 4
+
+=item B<application/x-www-form-urlencoded>
+
+This is the older type of encoding.  It is compatible with many CGI scripts and is
+suitable for short fields containing text data.  For your
+convenience, CGI.pm stores the name of this encoding
+type in B<&CGI::URL_ENCODED>.
+
+=item B<multipart/form-data>
+
+This is the newer type of encoding.
+It is suitable for forms that contain very large fields or that
+are intended for transferring binary data.  Most importantly,
+it enables the "file upload" feature.  For
+your convenience, CGI.pm stores the name of this encoding type
+in B<&CGI::MULTIPART>
+
+Forms that use this type of encoding are not easily interpreted
+by CGI scripts unless they use CGI.pm or another library designed
+to handle them.
+
+If XHTML is activated (the default), then forms will be automatically
+created using this type of encoding.
+
+=back
+
+The start_form() method uses the older form of encoding by
+default unless XHTML is requested.  If you want to use the
+newer form of encoding by default, you can call
+B<start_multipart_form()> instead of B<start_form()>.  The
+method B<end_multipart_form()> is an alias to B<end_form()>.
+
+JAVASCRIPTING: The B<-name> and B<-onSubmit> parameters are provided
+for use with JavaScript.  The -name parameter gives the
+form a name so that it can be identified and manipulated by
+JavaScript functions.  -onSubmit should point to a JavaScript
+function that will be executed just before the form is submitted to your
+server.  You can use this opportunity to check the contents of the form 
+for consistency and completeness.  If you find something wrong, you
+can put up an alert box or maybe fix things up yourself.  You can 
+abort the submission by returning false from this function.  
+
+Usually the bulk of JavaScript functions are defined in a <script>
+block in the HTML header and -onSubmit points to one of these function
+call.  See start_html() for details.
+
+=head2 FORM ELEMENTS
+
+After starting a form, you will typically create one or more
+textfields, popup menus, radio groups and other form elements.  Each
+of these elements takes a standard set of named arguments.  Some
+elements also have optional arguments.  The standard arguments are as
+follows:
+
+=over 4
+
+=item B<-name>
+
+The name of the field. After submission this name can be used to
+retrieve the field's value using the param() method.
+
+=item B<-value>, B<-values>
+
+The initial value of the field which will be returned to the script
+after form submission.  Some form elements, such as text fields, take
+a single scalar -value argument. Others, such as popup menus, take a
+reference to an array of values. The two arguments are synonyms.
+
+=item B<-tabindex>
+
+A numeric value that sets the order in which the form element receives
+focus when the user presses the tab key. Elements with lower values
+receive focus first.
+
+=item B<-id>
+
+A string identifier that can be used to identify this element to
+JavaScript and DHTML.
+
+=item B<-override>
+
+A boolean, which, if true, forces the element to take on the value
+specified by B<-value>, overriding the sticky behavior described
+earlier for the B<-nosticky> pragma.
+
+=item B<-onChange>, B<-onFocus>, B<-onBlur>, B<-onMouseOver>, B<-onMouseOut>, B<-onSelect>
+
+These are used to assign JavaScript event handlers. See the
+JavaScripting section for more details.
+
+=back
+
+Other common arguments are described in the next section. In addition
+to these, all attributes described in the HTML specifications are
+supported.
+
+=head2 CREATING A TEXT FIELD
+
+    print textfield(-name=>'field_name',
+                   -value=>'starting value',
+                   -size=>50,
+                   -maxlength=>80);
+       -or-
+
+    print textfield('field_name','starting value',50,80);
+
+textfield() will return a text input field. 
+
+=over 4
+
+=item B<Parameters>
+
+=item 1.
+
+The first parameter is the required name for the field (-name). 
+
+=item 2.
+
+The optional second parameter is the default starting value for the field
+contents (-value, formerly known as -default).
+
+=item 3.
+
+The optional third parameter is the size of the field in
+      characters (-size).
+
+=item 4.
+
+The optional fourth parameter is the maximum number of characters the
+      field will accept (-maxlength).
+
+=back
+
+As with all these methods, the field will be initialized with its 
+previous contents from earlier invocations of the script.
+When the form is processed, the value of the text field can be
+retrieved with:
+
+       $value = param('foo');
+
+If you want to reset it from its initial value after the script has been
+called once, you can do so like this:
+
+       param('foo',"I'm taking over this value!");
+
+=head2 CREATING A BIG TEXT FIELD
+
+   print textarea(-name=>'foo',
+                         -default=>'starting value',
+                         -rows=>10,
+                         -columns=>50);
+
+       -or
+
+   print textarea('foo','starting value',10,50);
+
+textarea() is just like textfield, but it allows you to specify
+rows and columns for a multiline text entry box.  You can provide
+a starting value for the field, which can be long and contain
+multiple lines.
+
+=head2 CREATING A PASSWORD FIELD
+
+   print password_field(-name=>'secret',
+                               -value=>'starting value',
+                               -size=>50,
+                               -maxlength=>80);
+       -or-
+
+   print password_field('secret','starting value',50,80);
+
+password_field() is identical to textfield(), except that its contents 
+will be starred out on the web page.
+
+=head2 CREATING A FILE UPLOAD FIELD
+
+    print filefield(-name=>'uploaded_file',
+                           -default=>'starting value',
+                           -size=>50,
+                           -maxlength=>80);
+       -or-
+
+    print filefield('uploaded_file','starting value',50,80);
+
+filefield() will return a file upload field.
+In order to take full advantage of this I<you must use the new 
+multipart encoding scheme> for the form.  You can do this either
+by calling B<start_form()> with an encoding type of B<&CGI::MULTIPART>,
+or by calling the new method B<start_multipart_form()> instead of
+vanilla B<start_form()>.
+
+=over 4
+
+=item B<Parameters>
+
+=item 1.
+
+The first parameter is the required name for the field (-name).  
+
+=item 2.
+
+The optional second parameter is the starting value for the field contents
+to be used as the default file name (-default).
+
+For security reasons, browsers don't pay any attention to this field,
+and so the starting value will always be blank.  Worse, the field
+loses its "sticky" behavior and forgets its previous contents.  The
+starting value field is called for in the HTML specification, however,
+and possibly some browser will eventually provide support for it.
+
+=item 3.
+
+The optional third parameter is the size of the field in
+characters (-size).
+
+=item 4.
+
+The optional fourth parameter is the maximum number of characters the
+field will accept (-maxlength).
+
+=back
+
+JAVASCRIPTING: The B<-onChange>, B<-onFocus>, B<-onBlur>,
+B<-onMouseOver>, B<-onMouseOut> and B<-onSelect> parameters are
+recognized.  See textfield() for details.
+
+=head2 PROCESSING A FILE UPLOAD FIELD
+
+=head3 Basics
+
+When the form is processed, you can retrieve an L<IO::Handle> compatible
+handle for a file upload field like this:
+
+  $lightweight_fh  = $q->upload('field_name');
+
+  # undef may be returned if it's not a valid file handle
+  if (defined $lightweight_fh) {
+    # Upgrade the handle to one compatible with IO::Handle:
+    my $io_handle = $lightweight_fh->handle;
+
+    open (OUTFILE,'>>','/usr/local/web/users/feedback');
+    while ($bytesread = $io_handle->read($buffer,1024)) {
+      print OUTFILE $buffer;
+    }
+  }
+
+In a list context, upload() will return an array of filehandles.
+This makes it possible to process forms that use the same name for
+multiple upload fields.
+
+If you want the entered file name for the file, you can just call param():
+
+  $filename = $q->param('field_name');
+
+Different browsers will return slightly different things for the
+name.  Some browsers return the filename only.  Others return the full
+path to the file, using the path conventions of the user's machine.
+Regardless, the name returned is always the name of the file on the
+I<user's> machine, and is unrelated to the name of the temporary file
+that CGI.pm creates during upload spooling (see below).
+
+When a file is uploaded the browser usually sends along some
+information along with it in the format of headers.  The information
+usually includes the MIME content type. To
+retrieve this information, call uploadInfo().  It returns a reference to
+a hash containing all the document headers.
+
+       $filename = $q->param('uploaded_file');
+       $type = $q->uploadInfo($filename)->{'Content-Type'};
+       unless ($type eq 'text/html') {
+        die "HTML FILES ONLY!";
+       }
+
+If you are using a machine that recognizes "text" and "binary" data
+modes, be sure to understand when and how to use them (see the Camel book).  
+Otherwise you may find that binary files are corrupted during file
+uploads.
+
+=head3 Accessing the temp files directly
+
+When processing an uploaded file, CGI.pm creates a temporary file on your hard
+disk and passes you a file handle to that file. After you are finished with the
+file handle, CGI.pm unlinks (deletes) the temporary file. If you need to you
+can access the temporary file directly. You can access the temp file for a file
+upload by passing the file name to the tmpFileName() method:
+
+       $filename = $query->param('uploaded_file');
+       $tmpfilename = $query->tmpFileName($filename);
+
+The temporary file will be deleted automatically when your program exits unless
+you manually rename it. On some operating systems (such as Windows NT), you
+will need to close the temporary file's filehandle before your program exits.
+Otherwise the attempt to delete the temporary file will fail.
+
+=head3 Handling interrupted file uploads
+
+There are occasionally problems involving parsing the uploaded file.
+This usually happens when the user presses "Stop" before the upload is
+finished.  In this case, CGI.pm will return undef for the name of the
+uploaded file and set I<cgi_error()> to the string "400 Bad request
+(malformed multipart POST)".  This error message is designed so that
+you can incorporate it into a status code to be sent to the browser.
+Example:
+
+   $file = $q->upload('uploaded_file');
+   if (!$file && $q->cgi_error) {
+      print $q->header(-status=>$q->cgi_error);
+      exit 0;
+   }
+
+You are free to create a custom HTML page to complain about the error,
+if you wish.
+
+=head3 Progress bars for file uploads and avoiding temp files
+
+CGI.pm gives you low-level access to file upload management through
+a file upload hook. You can use this feature to completely turn off
+the temp file storage of file uploads, or potentially write your own
+file upload progress meter.
+
+This is much like the UPLOAD_HOOK facility available in L<Apache::Request>, with
+the exception that the first argument to the callback is an L<Apache::Upload>
+object, here it's the remote filename.
+
+ $q = CGI->new(\&hook [,$data [,$use_tempfile]]);
+
+ sub hook {
+        my ($filename, $buffer, $bytes_read, $data) = @_;
+        print  "Read $bytes_read bytes of $filename\n";
+ }
+
+The C<< $data >> field is optional; it lets you pass configuration
+information (e.g. a database handle) to your hook callback.
+
+The C<< $use_tempfile >> field is a flag that lets you turn on and off
+CGI.pm's use of a temporary disk-based file during file upload. If you
+set this to a FALSE value (default true) then $q->param('uploaded_file')
+will no longer work, and the only way to get at the uploaded data is
+via the hook you provide.
+
+If using the function-oriented interface, call the CGI::upload_hook()
+method before calling param() or any other CGI functions:
+
+  CGI::upload_hook(\&hook [,$data [,$use_tempfile]]);
+
+This method is not exported by default.  You will have to import it
+explicitly if you wish to use it without the CGI:: prefix.
+
+=head3 Troubleshooting file uploads on Windows
+
+If you are using CGI.pm on a Windows platform and find that binary
+files get slightly larger when uploaded but that text files remain the
+same, then you have forgotten to activate binary mode on the output
+filehandle.  Be sure to call binmode() on any handle that you create
+to write the uploaded file to disk.
+
+=head3 Older ways to process file uploads
+
+( This section is here for completeness. if you are building a new application with CGI.pm, you can skip it. )
+
+The original way to process file uploads with CGI.pm was to use param(). The
+value it returns has a dual nature as both a file name and a lightweight
+filehandle. This dual nature is problematic if you following the recommended
+practice of having C<use strict> in your code. Perl will complain when you try
+to use a string as a filehandle.  More seriously, it is possible for the remote
+user to type garbage into the upload field, in which case what you get from
+param() is not a filehandle at all, but a string.
+
+To solve this problem the upload() method was added, which always returns a
+lightweight filehandle. This generally works well, but will have trouble
+interoperating with some other modules because the file handle is not derived
+from L<IO::Handle>. So that brings us to current recommendation given above,
+which is to call the handle() method on the file handle returned by upload().
+That upgrades the handle to an IO::Handle. It's a big win for compatibility for
+a small penalty of loading IO::Handle the first time you call it.
+
+
+=head2 CREATING A POPUP MENU
+
+   print popup_menu('menu_name',
+                           ['eenie','meenie','minie'],
+                           'meenie');
+
+      -or-
+
+   %labels = ('eenie'=>'your first choice',
+             'meenie'=>'your second choice',
+             'minie'=>'your third choice');
+   %attributes = ('eenie'=>{'class'=>'class of first choice'});
+   print popup_menu('menu_name',
+                           ['eenie','meenie','minie'],
+          'meenie',\%labels,\%attributes);
+
+       -or (named parameter style)-
+
+   print popup_menu(-name=>'menu_name',
+                           -values=>['eenie','meenie','minie'],
+                           -default=>['meenie','minie'],
+          -labels=>\%labels,
+          -attributes=>\%attributes);
+
+popup_menu() creates a menu.
+
+=over 4
+
+=item 1.
+
+The required first argument is the menu's name (-name).
+
+=item 2.
+
+The required second argument (-values) is an array B<reference>
+containing the list of menu items in the menu.  You can pass the
+method an anonymous array, as shown in the example, or a reference to
+a named array, such as "\@foo".
+
+=item 3.
+
+The optional third parameter (-default) is the name of the default
+menu choice.  If not specified, the first item will be the default.
+The values of the previous choice will be maintained across
+queries. Pass an array reference to select multiple defaults.
+
+=item 4.
+
+The optional fourth parameter (-labels) is provided for people who
+want to use different values for the user-visible label inside the
+popup menu and the value returned to your script.  It's a pointer to an
+hash relating menu values to user-visible labels.  If you
+leave this parameter blank, the menu values will be displayed by
+default.  (You can also leave a label undefined if you want to).
+
+=item 5.
+
+The optional fifth parameter (-attributes) is provided to assign
+any of the common HTML attributes to an individual menu item. It's
+a pointer to a hash relating menu values to another
+hash with the attribute's name as the key and the
+attribute's value as the value.
+
+=back
+
+When the form is processed, the selected value of the popup menu can
+be retrieved using:
+
+      $popup_menu_value = param('menu_name');
+
+=head2 CREATING AN OPTION GROUP
+
+Named parameter style
+
+  print popup_menu(-name=>'menu_name',
+                  -values=>[qw/eenie meenie minie/,
+                            optgroup(-name=>'optgroup_name',
+                                             -values => ['moe','catch'],
+                                             -attributes=>{'catch'=>{'class'=>'red'}})],
+                  -labels=>{'eenie'=>'one',
+                            'meenie'=>'two',
+                            'minie'=>'three'},
+                  -default=>'meenie');
+
+  Old style
+  print popup_menu('menu_name',
+                  ['eenie','meenie','minie',
+                   optgroup('optgroup_name', ['moe', 'catch'],
+                                   {'catch'=>{'class'=>'red'}})],'meenie',
+                  {'eenie'=>'one','meenie'=>'two','minie'=>'three'});
+
+optgroup() creates an option group within a popup menu.
+
+=over 4
+
+=item 1.
+
+The required first argument (B<-name>) is the label attribute of the
+optgroup and is B<not> inserted in the parameter list of the query.
+
+=item 2.
+
+The required second argument (B<-values>)  is an array reference
+containing the list of menu items in the menu.  You can pass the
+method an anonymous array, as shown in the example, or a reference
+to a named array, such as \@foo.  If you pass a HASH reference,
+the keys will be used for the menu values, and the values will be
+used for the menu labels (see -labels below).
+
+=item 3.
+
+The optional third parameter (B<-labels>) allows you to pass a reference
+to a hash containing user-visible labels for one or more
+of the menu items.  You can use this when you want the user to see one
+menu string, but have the browser return your program a different one.
+If you don't specify this, the value string will be used instead
+("eenie", "meenie" and "minie" in this example).  This is equivalent
+to using a hash reference for the -values parameter.
+
+=item 4.
+
+An optional fourth parameter (B<-labeled>) can be set to a true value
+and indicates that the values should be used as the label attribute
+for each option element within the optgroup.
+
+=item 5.
+
+An optional fifth parameter (-novals) can be set to a true value and
+indicates to suppress the val attribute in each option element within
+the optgroup.
+
+See the discussion on optgroup at W3C
+(http://www.w3.org/TR/REC-html40/interact/forms.html#edef-OPTGROUP)
+for details.
+
+=item 6.
+
+An optional sixth parameter (-attributes) is provided to assign
+any of the common HTML attributes to an individual menu item. It's
+a pointer to a hash relating menu values to another
+hash with the attribute's name as the key and the
+attribute's value as the value.
+
+=back
+
+=head2 CREATING A SCROLLING LIST
+
+   print scrolling_list('list_name',
+                               ['eenie','meenie','minie','moe'],
+        ['eenie','moe'],5,'true',{'moe'=>{'class'=>'red'}});
+      -or-
+
+   print scrolling_list('list_name',
+                               ['eenie','meenie','minie','moe'],
+                               ['eenie','moe'],5,'true',
+        \%labels,%attributes);
+
+       -or-
+
+   print scrolling_list(-name=>'list_name',
+                               -values=>['eenie','meenie','minie','moe'],
+                               -default=>['eenie','moe'],
+                               -size=>5,
+                               -multiple=>'true',
+        -labels=>\%labels,
+        -attributes=>\%attributes);
+
+scrolling_list() creates a scrolling list.  
+
+=over 4
+
+=item B<Parameters:>
+
+=item 1.
+
+The first and second arguments are the list name (-name) and values
+(-values).  As in the popup menu, the second argument should be an
+array reference.
+
+=item 2.
+
+The optional third argument (-default) can be either a reference to a
+list containing the values to be selected by default, or can be a
+single value to select.  If this argument is missing or undefined,
+then nothing is selected when the list first appears.  In the named
+parameter version, you can use the synonym "-defaults" for this
+parameter.
+
+=item 3.
+
+The optional fourth argument is the size of the list (-size).
+
+=item 4.
+
+The optional fifth argument can be set to true to allow multiple
+simultaneous selections (-multiple).  Otherwise only one selection
+will be allowed at a time.
+
+=item 5.
+
+The optional sixth argument is a pointer to a hash
+containing long user-visible labels for the list items (-labels).
+If not provided, the values will be displayed.
+
+=item 6.
+
+The optional sixth parameter (-attributes) is provided to assign
+any of the common HTML attributes to an individual menu item. It's
+a pointer to a hash relating menu values to another
+hash with the attribute's name as the key and the
+attribute's value as the value.
+
+When this form is processed, all selected list items will be returned as
+a list under the parameter name 'list_name'.  The values of the
+selected items can be retrieved with:
+
+      @selected = param('list_name');
+
+=back
+
+=head2 CREATING A GROUP OF RELATED CHECKBOXES
+
+   print checkbox_group(-name=>'group_name',
+                               -values=>['eenie','meenie','minie','moe'],
+                               -default=>['eenie','moe'],
+                               -linebreak=>'true',
+                                -disabled => ['moe'],
+        -labels=>\%labels,
+        -attributes=>\%attributes);
+
+   print checkbox_group('group_name',
+                               ['eenie','meenie','minie','moe'],
+        ['eenie','moe'],'true',\%labels,
+        {'moe'=>{'class'=>'red'}});
+
+   HTML3-COMPATIBLE BROWSERS ONLY:
+
+   print checkbox_group(-name=>'group_name',
+                               -values=>['eenie','meenie','minie','moe'],
+                               -rows=2,-columns=>2);
+
+
+checkbox_group() creates a list of checkboxes that are related
+by the same name.
+
+=over 4
+
+=item B<Parameters:>
+
+=item 1.
+
+The first and second arguments are the checkbox name and values,
+respectively (-name and -values).  As in the popup menu, the second
+argument should be an array reference.  These values are used for the
+user-readable labels printed next to the checkboxes as well as for the
+values passed to your script in the query string.
+
+=item 2.
+
+The optional third argument (-default) can be either a reference to a
+list containing the values to be checked by default, or can be a
+single value to checked.  If this argument is missing or undefined,
+then nothing is selected when the list first appears.
+
+=item 3.
+
+The optional fourth argument (-linebreak) can be set to true to place
+line breaks between the checkboxes so that they appear as a vertical
+list.  Otherwise, they will be strung together on a horizontal line.
+
+=back
+
+
+The optional B<-labels> argument is a pointer to a hash
+relating the checkbox values to the user-visible labels that will be
+printed next to them.  If not provided, the values will be used as the
+default.
+
+
+The optional parameters B<-rows>, and B<-columns> cause
+checkbox_group() to return an HTML3 compatible table containing the
+checkbox group formatted with the specified number of rows and
+columns.  You can provide just the -columns parameter if you wish;
+checkbox_group will calculate the correct number of rows for you.
+
+The option B<-disabled> takes an array of checkbox values and disables
+them by greying them out (this may not be supported by all browsers).
+
+The optional B<-attributes> argument is provided to assign any of the
+common HTML attributes to an individual menu item. It's a pointer to
+a hash relating menu values to another hash
+with the attribute's name as the key and the attribute's value as the
+value.
+
+The optional B<-tabindex> argument can be used to control the order in which
+radio buttons receive focus when the user presses the tab button.  If
+passed a scalar numeric value, the first element in the group will
+receive this tab index and subsequent elements will be incremented by
+one.  If given a reference to an array of radio button values, then
+the indexes will be jiggered so that the order specified in the array
+will correspond to the tab order.  You can also pass a reference to a
+hash in which the hash keys are the radio button values and the values
+are the tab indexes of each button.  Examples:
+
+  -tabindex => 100    #  this group starts at index 100 and counts up
+  -tabindex => ['moe','minie','eenie','meenie']  # tab in this order
+  -tabindex => {meenie=>100,moe=>101,minie=>102,eenie=>200} # tab in this order
+
+The optional B<-labelattributes> argument will contain attributes
+attached to the <label> element that surrounds each button.
+
+When the form is processed, all checked boxes will be returned as
+a list under the parameter name 'group_name'.  The values of the
+"on" checkboxes can be retrieved with:
+
+      @turned_on = param('group_name');
+
+The value returned by checkbox_group() is actually an array of button
+elements.  You can capture them and use them within tables, lists,
+or in other creative ways:
+
+    @h = checkbox_group(-name=>'group_name',-values=>\@values);
+    &use_in_creative_way(@h);
+
+=head2 CREATING A STANDALONE CHECKBOX
+
+    print checkbox(-name=>'checkbox_name',
+                          -checked=>1,
+                          -value=>'ON',
+                          -label=>'CLICK ME');
+
+       -or-
+
+    print checkbox('checkbox_name','checked','ON','CLICK ME');
+
+checkbox() is used to create an isolated checkbox that isn't logically
+related to any others.
+
+=over 4
+
+=item B<Parameters:>
+
+=item 1.
+
+The first parameter is the required name for the checkbox (-name).  It
+will also be used for the user-readable label printed next to the
+checkbox.
+
+=item 2.
+
+The optional second parameter (-checked) specifies that the checkbox
+is turned on by default.  Synonyms are -selected and -on.
+
+=item 3.
+
+The optional third parameter (-value) specifies the value of the
+checkbox when it is checked.  If not provided, the word "on" is
+assumed.
+
+=item 4.
+
+The optional fourth parameter (-label) is the user-readable label to
+be attached to the checkbox.  If not provided, the checkbox name is
+used.
+
+=back
+
+The value of the checkbox can be retrieved using:
+
+    $turned_on = param('checkbox_name');
+
+=head2 CREATING A RADIO BUTTON GROUP
+
+   print radio_group(-name=>'group_name',
+                            -values=>['eenie','meenie','minie'],
+                            -default=>'meenie',
+                            -linebreak=>'true',
+           -labels=>\%labels,
+           -attributes=>\%attributes);
+
+       -or-
+
+   print radio_group('group_name',['eenie','meenie','minie'],
+            'meenie','true',\%labels,\%attributes);
+
+
+   HTML3-COMPATIBLE BROWSERS ONLY:
+
+   print radio_group(-name=>'group_name',
+                            -values=>['eenie','meenie','minie','moe'],
+                            -rows=2,-columns=>2);
+
+radio_group() creates a set of logically-related radio buttons
+(turning one member of the group on turns the others off)
+
+=over 4
+
+=item B<Parameters:>
+
+=item 1.
+
+The first argument is the name of the group and is required (-name).
+
+=item 2.
+
+The second argument (-values) is the list of values for the radio
+buttons.  The values and the labels that appear on the page are
+identical.  Pass an array I<reference> in the second argument, either
+using an anonymous array, as shown, or by referencing a named array as
+in "\@foo".
+
+=item 3.
+
+The optional third parameter (-default) is the name of the default
+button to turn on. If not specified, the first item will be the
+default.  You can provide a nonexistent button name, such as "-" to
+start up with no buttons selected.
+
+=item 4.
+
+The optional fourth parameter (-linebreak) can be set to 'true' to put
+line breaks between the buttons, creating a vertical list.
+
+=item 5.
+
+The optional fifth parameter (-labels) is a pointer to an associative
+array relating the radio button values to user-visible labels to be
+used in the display.  If not provided, the values themselves are
+displayed.
+
+=back
+
+
+All modern browsers can take advantage of the optional parameters
+B<-rows>, and B<-columns>.  These parameters cause radio_group() to
+return an HTML3 compatible table containing the radio group formatted
+with the specified number of rows and columns.  You can provide just
+the -columns parameter if you wish; radio_group will calculate the
+correct number of rows for you.
+
+To include row and column headings in the returned table, you
+can use the B<-rowheaders> and B<-colheaders> parameters.  Both
+of these accept a pointer to an array of headings to use.
+The headings are just decorative.  They don't reorganize the
+interpretation of the radio buttons -- they're still a single named
+unit.
+
+The optional B<-tabindex> argument can be used to control the order in which
+radio buttons receive focus when the user presses the tab button.  If
+passed a scalar numeric value, the first element in the group will
+receive this tab index and subsequent elements will be incremented by
+one.  If given a reference to an array of radio button values, then
+the indexes will be jiggered so that the order specified in the array
+will correspond to the tab order.  You can also pass a reference to a
+hash in which the hash keys are the radio button values and the values
+are the tab indexes of each button.  Examples:
+
+  -tabindex => 100    #  this group starts at index 100 and counts up
+  -tabindex => ['moe','minie','eenie','meenie']  # tab in this order
+  -tabindex => {meenie=>100,moe=>101,minie=>102,eenie=>200} # tab in this order
+
+
+The optional B<-attributes> argument is provided to assign any of the
+common HTML attributes to an individual menu item. It's a pointer to
+a hash relating menu values to another hash
+with the attribute's name as the key and the attribute's value as the
+value.
+
+The optional B<-labelattributes> argument will contain attributes
+attached to the <label> element that surrounds each button.
+
+When the form is processed, the selected radio button can
+be retrieved using:
+
+      $which_radio_button = param('group_name');
+
+The value returned by radio_group() is actually an array of button
+elements.  You can capture them and use them within tables, lists,
+or in other creative ways:
+
+    @h = radio_group(-name=>'group_name',-values=>\@values);
+    &use_in_creative_way(@h);
+
+=head2 CREATING A SUBMIT BUTTON 
+
+   print submit(-name=>'button_name',
+                       -value=>'value');
+
+       -or-
+
+   print submit('button_name','value');
+
+submit() will create the query submission button.  Every form
+should have one of these.
+
+=over 4
+
+=item B<Parameters:>
+
+=item 1.
+
+The first argument (-name) is optional.  You can give the button a
+name if you have several submission buttons in your form and you want
+to distinguish between them.  
+
+=item 2.
+
+The second argument (-value) is also optional.  This gives the button
+a value that will be passed to your script in the query string. The
+name will also be used as the user-visible label.
+
+=item 3.
+
+You can use -label as an alias for -value.  I always get confused
+about which of -name and -value changes the user-visible label on the
+button.
+
+=back
+
+You can figure out which button was pressed by using different
+values for each one:
+
+     $which_one = param('button_name');
+
+=head2 CREATING A RESET BUTTON
+
+   print reset
+
+reset() creates the "reset" button.  Note that it restores the
+form to its value from the last time the script was called, 
+NOT necessarily to the defaults.
+
+Note that this conflicts with the Perl reset() built-in.  Use
+CORE::reset() to get the original reset function.
+
+=head2 CREATING A DEFAULT BUTTON
+
+   print defaults('button_label')
+
+defaults() creates a button that, when invoked, will cause the
+form to be completely reset to its defaults, wiping out all the
+changes the user ever made.
+
+=head2 CREATING A HIDDEN FIELD
+
+       print hidden(-name=>'hidden_name',
+                            -default=>['value1','value2'...]);
+
+               -or-
+
+       print hidden('hidden_name','value1','value2'...);
+
+hidden() produces a text field that can't be seen by the user.  It
+is useful for passing state variable information from one invocation
+of the script to the next.
+
+=over 4
+
+=item B<Parameters:>
+
+=item 1.
+
+The first argument is required and specifies the name of this
+field (-name).
+
+=item 2.  
+
+The second argument is also required and specifies its value
+(-default).  In the named parameter style of calling, you can provide
+a single value here or a reference to a whole list
+
+=back
+
+Fetch the value of a hidden field this way:
+
+     $hidden_value = param('hidden_name');
+
+Note, that just like all the other form elements, the value of a
+hidden field is "sticky".  If you want to replace a hidden field with
+some other values after the script has been called once you'll have to
+do it manually:
+
+     param('hidden_name','new','values','here');
+
+=head2 CREATING A CLICKABLE IMAGE BUTTON
+
+     print image_button(-name=>'button_name',
+                               -src=>'/source/URL',
+                               -align=>'MIDDLE');      
+
+       -or-
+
+     print image_button('button_name','/source/URL','MIDDLE');
+
+image_button() produces a clickable image.  When it's clicked on the
+position of the click is returned to your script as "button_name.x"
+and "button_name.y", where "button_name" is the name you've assigned
+to it.
+
+=over 4
+
+=item B<Parameters:>
+
+=item 1.
+
+The first argument (-name) is required and specifies the name of this
+field.
+
+=item 2.
+
+The second argument (-src) is also required and specifies the URL
+
+=item 3.
+The third option (-align, optional) is an alignment type, and may be
+TOP, BOTTOM or MIDDLE
+
+=back
+
+Fetch the value of the button this way:
+     $x = param('button_name.x');
+     $y = param('button_name.y');
+
+=head2 CREATING A JAVASCRIPT ACTION BUTTON
+
+     print button(-name=>'button_name',
+                         -value=>'user visible label',
+                         -onClick=>"do_something()");
+
+       -or-
+
+     print button('button_name',"user visible value","do_something()");
+
+button() produces an C<< <input> >> tag with C<type="button">.  When it's
+pressed the fragment of JavaScript code pointed to by the B<-onClick> parameter
+will be executed.
+
+=head1 HTTP COOKIES
+
+Browsers support a so-called "cookie" designed to help maintain state
+within a browser session.  CGI.pm has several methods that support
+cookies.
+
+A cookie is a name=value pair much like the named parameters in a CGI
+query string.  CGI scripts create one or more cookies and send
+them to the browser in the HTTP header.  The browser maintains a list
+of cookies that belong to a particular Web server, and returns them
+to the CGI script during subsequent interactions.
+
+In addition to the required name=value pair, each cookie has several
+optional attributes:
+
+=over 4
+
+=item 1. an expiration time
+
+This is a time/date string (in a special GMT format) that indicates
+when a cookie expires.  The cookie will be saved and returned to your
+script until this expiration date is reached if the user exits
+the browser and restarts it.  If an expiration date isn't specified, the cookie
+will remain active until the user quits the browser.
+
+=item 2. a domain
+
+This is a partial or complete domain name for which the cookie is 
+valid.  The browser will return the cookie to any host that matches
+the partial domain name.  For example, if you specify a domain name
+of ".capricorn.com", then the browser will return the cookie to
+Web servers running on any of the machines "www.capricorn.com", 
+"www2.capricorn.com", "feckless.capricorn.com", etc.  Domain names
+must contain at least two periods to prevent attempts to match
+on top level domains like ".edu".  If no domain is specified, then
+the browser will only return the cookie to servers on the host the
+cookie originated from.
+
+=item 3. a path
+
+If you provide a cookie path attribute, the browser will check it
+against your script's URL before returning the cookie.  For example,
+if you specify the path "/cgi-bin", then the cookie will be returned
+to each of the scripts "/cgi-bin/tally.pl", "/cgi-bin/order.pl",
+and "/cgi-bin/customer_service/complain.pl", but not to the script
+"/cgi-private/site_admin.pl".  By default, path is set to "/", which
+causes the cookie to be sent to any CGI script on your site.
+
+=item 4. a "secure" flag
+
+If the "secure" attribute is set, the cookie will only be sent to your
+script if the CGI request is occurring on a secure channel, such as SSL.
+
+=back
+
+The interface to HTTP cookies is the B<cookie()> method:
+
+    $cookie = cookie(-name=>'sessionID',
+                            -value=>'xyzzy',
+                            -expires=>'+1h',
+                            -path=>'/cgi-bin/database',
+                            -domain=>'.capricorn.org',
+                            -secure=>1);
+    print header(-cookie=>$cookie);
+
+B<cookie()> creates a new cookie.  Its parameters include:
+
+=over 4
+
+=item B<-name>
+
+The name of the cookie (required).  This can be any string at all.
+Although browsers limit their cookie names to non-whitespace
+alphanumeric characters, CGI.pm removes this restriction by escaping
+and unescaping cookies behind the scenes.
+
+=item B<-value>
+
+The value of the cookie.  This can be any scalar value,
+array reference, or even hash reference.  For example,
+you can store an entire hash into a cookie this way:
+
+       $cookie=cookie(-name=>'family information',
+                              -value=>\%childrens_ages);
+
+=item B<-path>
+
+The optional partial path for which this cookie will be valid, as described
+above.
+
+=item B<-domain>
+
+The optional partial domain for which this cookie will be valid, as described
+above.
+
+=item B<-expires>
+
+The optional expiration date for this cookie.  The format is as described 
+in the section on the B<header()> method:
+
+       "+1h"  one hour from now
+
+=item B<-secure>
+
+If set to true, this cookie will only be used within a secure
+SSL session.
+
+=back
+
+The cookie created by cookie() must be incorporated into the HTTP
+header within the string returned by the header() method:
+
+        use CGI ':standard';
+       print header(-cookie=>$my_cookie);
+
+To create multiple cookies, give header() an array reference:
+
+       $cookie1 = cookie(-name=>'riddle_name',
+                                 -value=>"The Sphynx's Question");
+       $cookie2 = cookie(-name=>'answers',
+                                 -value=>\%answers);
+       print header(-cookie=>[$cookie1,$cookie2]);
+
+To retrieve a cookie, request it by name by calling cookie() method
+without the B<-value> parameter. This example uses the object-oriented
+form:
+
+       use CGI;
+       $query = CGI->new;
+       $riddle = $query->cookie('riddle_name');
+        %answers = $query->cookie('answers');
+
+Cookies created with a single scalar value, such as the "riddle_name"
+cookie, will be returned in that form.  Cookies with array and hash
+values can also be retrieved.
+
+The cookie and CGI namespaces are separate.  If you have a parameter
+named 'answers' and a cookie named 'answers', the values retrieved by
+param() and cookie() are independent of each other.  However, it's
+simple to turn a CGI parameter into a cookie, and vice-versa:
+
+   # turn a CGI parameter into a cookie
+   $c=cookie(-name=>'answers',-value=>[param('answers')]);
+   # vice-versa
+   param(-name=>'answers',-value=>[cookie('answers')]);
+
+If you call cookie() without any parameters, it will return a list of
+the names of all cookies passed to your script:
+
+  @cookies = cookie();
+
+See the B<cookie.cgi> example script for some ideas on how to use
+cookies effectively.
+
+=head1 WORKING WITH FRAMES
+
+It's possible for CGI.pm scripts to write into several browser panels
+and windows using the HTML 4 frame mechanism.  There are three
+techniques for defining new frames programmatically:
+
+=over 4
+
+=item 1. Create a <Frameset> document
+
+After writing out the HTTP header, instead of creating a standard
+HTML document using the start_html() call, create a <frameset> 
+document that defines the frames on the page.  Specify your script(s)
+(with appropriate parameters) as the SRC for each of the frames.
+
+There is no specific support for creating <frameset> sections 
+in CGI.pm, but the HTML is very simple to write.  
+
+=item 2. Specify the destination for the document in the HTTP header
+
+You may provide a B<-target> parameter to the header() method:
+
+    print header(-target=>'ResultsWindow');
+
+This will tell the browser to load the output of your script into the
+frame named "ResultsWindow".  If a frame of that name doesn't already
+exist, the browser will pop up a new window and load your script's
+document into that.  There are a number of magic names that you can
+use for targets.  See the HTML C<< <frame> >> documentation for details.
+
+=item 3. Specify the destination for the document in the <form> tag
+
+You can specify the frame to load in the FORM tag itself.  With
+CGI.pm it looks like this:
+
+    print start_form(-target=>'ResultsWindow');
+
+When your script is reinvoked by the form, its output will be loaded
+into the frame named "ResultsWindow".  If one doesn't already exist
+a new window will be created.
+
+=back
+
+The script "frameset.cgi" in the examples directory shows one way to
+create pages in which the fill-out form and the response live in
+side-by-side frames.
+
+=head1 SUPPORT FOR JAVASCRIPT
+
+The usual way to use JavaScript is to define a set of functions in a
+<SCRIPT> block inside the HTML header and then to register event
+handlers in the various elements of the page. Events include such
+things as the mouse passing over a form element, a button being
+clicked, the contents of a text field changing, or a form being
+submitted. When an event occurs that involves an element that has
+registered an event handler, its associated JavaScript code gets
+called.
+
+The elements that can register event handlers include the <BODY> of an
+HTML document, hypertext links, all the various elements of a fill-out
+form, and the form itself. There are a large number of events, and
+each applies only to the elements for which it is relevant. Here is a
+partial list:
+
+=over 4
+
+=item B<onLoad>
+
+The browser is loading the current document. Valid in:
+
+     + The HTML <BODY> section only.
+
+=item B<onUnload>
+
+The browser is closing the current page or frame. Valid for:
+
+     + The HTML <BODY> section only.
+
+=item B<onSubmit>
+
+The user has pressed the submit button of a form. This event happens
+just before the form is submitted, and your function can return a
+value of false in order to abort the submission.  Valid for:
+
+     + Forms only.
+
+=item B<onClick>
+
+The mouse has clicked on an item in a fill-out form. Valid for:
+
+     + Buttons (including submit, reset, and image buttons)
+     + Checkboxes
+     + Radio buttons
+
+=item B<onChange>
+
+The user has changed the contents of a field. Valid for:
+
+     + Text fields
+     + Text areas
+     + Password fields
+     + File fields
+     + Popup Menus
+     + Scrolling lists
+
+=item B<onFocus>
+
+The user has selected a field to work with. Valid for:
+
+     + Text fields
+     + Text areas
+     + Password fields
+     + File fields
+     + Popup Menus
+     + Scrolling lists
+
+=item B<onBlur>
+
+The user has deselected a field (gone to work somewhere else).  Valid
+for:
+
+     + Text fields
+     + Text areas
+     + Password fields
+     + File fields
+     + Popup Menus
+     + Scrolling lists
+
+=item B<onSelect>
+
+The user has changed the part of a text field that is selected.  Valid
+for:
+
+     + Text fields
+     + Text areas
+     + Password fields
+     + File fields
+
+=item B<onMouseOver>
+
+The mouse has moved over an element.
+
+     + Text fields
+     + Text areas
+     + Password fields
+     + File fields
+     + Popup Menus
+     + Scrolling lists
+
+=item B<onMouseOut>
+
+The mouse has moved off an element.
+
+     + Text fields
+     + Text areas
+     + Password fields
+     + File fields
+     + Popup Menus
+     + Scrolling lists
+
+=back
+
+In order to register a JavaScript event handler with an HTML element,
+just use the event name as a parameter when you call the corresponding
+CGI method. For example, to have your validateAge() JavaScript code
+executed every time the textfield named "age" changes, generate the
+field like this: 
+
+ print textfield(-name=>'age',-onChange=>"validateAge(this)");
+
+This example assumes that you've already declared the validateAge()
+function by incorporating it into a <SCRIPT> block. The CGI.pm
+start_html() method provides a convenient way to create this section.
+
+Similarly, you can create a form that checks itself over for
+consistency and alerts the user if some essential value is missing by
+creating it this way: 
+  print start_form(-onSubmit=>"validateMe(this)");
+
+See the javascript.cgi script for a demonstration of how this all
+works.
+
+
+=head1 LIMITED SUPPORT FOR CASCADING STYLE SHEETS
+
+CGI.pm has limited support for HTML3's cascading style sheets (css).
+To incorporate a stylesheet into your document, pass the
+start_html() method a B<-style> parameter.  The value of this
+parameter may be a scalar, in which case it is treated as the source
+URL for the stylesheet, or it may be a hash reference.  In the latter
+case you should provide the hash with one or more of B<-src> or
+B<-code>.  B<-src> points to a URL where an externally-defined
+stylesheet can be found.  B<-code> points to a scalar value to be
+incorporated into a <style> section.  Style definitions in B<-code>
+override similarly-named ones in B<-src>, hence the name "cascading."
+
+You may also specify the type of the stylesheet by adding the optional
+B<-type> parameter to the hash pointed to by B<-style>.  If not
+specified, the style defaults to 'text/css'.
+
+To refer to a style within the body of your document, add the
+B<-class> parameter to any HTML element:
+
+    print h1({-class=>'Fancy'},'Welcome to the Party');
+
+Or define styles on the fly with the B<-style> parameter:
+
+    print h1({-style=>'Color: red;'},'Welcome to Hell');
+
+You may also use the new B<span()> element to apply a style to a
+section of text:
+
+    print span({-style=>'Color: red;'},
+              h1('Welcome to Hell'),
+              "Where did that handbasket get to?"
+              );
+
+Note that you must import the ":html3" definitions to have the
+B<span()> method available.  Here's a quick and dirty example of using
+CSS's.  See the CSS specification at
+http://www.w3.org/Style/CSS/ for more information.
+
+    use CGI qw/:standard :html3/;
+
+    #here's a stylesheet incorporated directly into the page
+    $newStyle=<<END;
+    <!-- 
+    P.Tip {
+       margin-right: 50pt;
+       margin-left: 50pt;
+        color: red;
+    }
+    P.Alert {
+       font-size: 30pt;
+        font-family: sans-serif;
+      color: red;
+    }
+    -->
+    END
+    print header();
+    print start_html( -title=>'CGI with Style',
+                     -style=>{-src=>'http://www.capricorn.com/style/st1.css',
+                              -code=>$newStyle}
+                    );
+    print h1('CGI with Style'),
+          p({-class=>'Tip'},
+           "Better read the cascading style sheet spec before playing with this!"),
+          span({-style=>'color: magenta'},
+              "Look Mom, no hands!",
+              p(),
+              "Whooo wee!"
+              );
+    print end_html;
+
+Pass an array reference to B<-code> or B<-src> in order to incorporate
+multiple stylesheets into your document.
+
+Should you wish to incorporate a verbatim stylesheet that includes
+arbitrary formatting in the header, you may pass a -verbatim tag to
+the -style hash, as follows:
+
+print start_html (-style  =>  {-verbatim => '@import url("/server-common/css/'.$cssFile.'");',
+                  -src    =>  '/server-common/css/core.css'});
+
+
+This will generate an HTML header that contains this:
+
+ <link rel="stylesheet" type="text/css"  href="/server-common/css/core.css">
+   <style type="text/css">
+   @import url("/server-common/css/main.css");
+   </style>
+
+Any additional arguments passed in the -style value will be
+incorporated into the <link> tag.  For example:
+
+ start_html(-style=>{-src=>['/styles/print.css','/styles/layout.css'],
+                         -media => 'all'});
+
+This will give:
+
+ <link rel="stylesheet" type="text/css" href="/styles/print.css" media="all"/>
+ <link rel="stylesheet" type="text/css" href="/styles/layout.css" media="all"/>
+
+<p>
+
+To make more complicated <link> tags, use the Link() function
+and pass it to start_html() in the -head argument, as in:
+
+  @h = (Link({-rel=>'stylesheet',-type=>'text/css',-src=>'/ss/ss.css',-media=>'all'}),
+        Link({-rel=>'stylesheet',-type=>'text/css',-src=>'/ss/fred.css',-media=>'paper'}));
+  print start_html({-head=>\@h})
+
+To create primary and  "alternate" stylesheet, use the B<-alternate> option:
+
+ start_html(-style=>{-src=>[
+                           {-src=>'/styles/print.css'},
+                          {-src=>'/styles/alt.css',-alternate=>1}
+                           ]
+                   });
+
+=head1 DEBUGGING
+
+If you are running the script from the command line or in the perl
+debugger, you can pass the script a list of keywords or
+parameter=value pairs on the command line or from standard input (you
+don't have to worry about tricking your script into reading from
+environment variables).  You can pass keywords like this:
+
+    your_script.pl keyword1 keyword2 keyword3
+
+or this:
+
+   your_script.pl keyword1+keyword2+keyword3
+
+or this:
+
+    your_script.pl name1=value1 name2=value2
+
+or this:
+
+    your_script.pl name1=value1&name2=value2
+
+To turn off this feature, use the -no_debug pragma.
+
+To test the POST method, you may enable full debugging with the -debug
+pragma.  This will allow you to feed newline-delimited name=value
+pairs to the script on standard input.
+
+When debugging, you can use quotes and backslashes to escape 
+characters in the familiar shell manner, letting you place
+spaces and other funny characters in your parameter=value
+pairs:
+
+   your_script.pl "name1='I am a long value'" "name2=two\ words"
+
+Finally, you can set the path info for the script by prefixing the first
+name/value parameter with the path followed by a question mark (?):
+
+    your_script.pl /your/path/here?name1=value1&name2=value2
+
+=head2 DUMPING OUT ALL THE NAME/VALUE PAIRS
+
+The Dump() method produces a string consisting of all the query's
+name/value pairs formatted nicely as a nested list.  This is useful
+for debugging purposes:
+
+    print Dump
+
+
+Produces something that looks like:
+
+    <ul>
+    <li>name1
+       <ul>
+       <li>value1
+       <li>value2
+       </ul>
+    <li>name2
+       <ul>
+       <li>value1
+       </ul>
+    </ul>
+
+As a shortcut, you can interpolate the entire CGI object into a string
+and it will be replaced with the a nice HTML dump shown above:
+
+    $query=CGI->new;
+    print "<h2>Current Values</h2> $query\n";
+
+=head1 FETCHING ENVIRONMENT VARIABLES
+
+Some of the more useful environment variables can be fetched
+through this interface.  The methods are as follows:
+
+=over 4
+
+=item B<Accept()>
+
+Return a list of MIME types that the remote browser accepts. If you
+give this method a single argument corresponding to a MIME type, as in
+Accept('text/html'), it will return a floating point value
+corresponding to the browser's preference for this type from 0.0
+(don't want) to 1.0.  Glob types (e.g. text/*) in the browser's accept
+list are handled correctly.
+
+Note that the capitalization changed between version 2.43 and 2.44 in
+order to avoid conflict with Perl's accept() function.
+
+=item B<raw_cookie()>
+
+Returns the HTTP_COOKIE variable.  Cookies have a special format, and
+this method call just returns the raw form (?cookie dough).  See
+cookie() for ways of setting and retrieving cooked cookies.
+
+Called with no parameters, raw_cookie() returns the packed cookie
+structure.  You can separate it into individual cookies by splitting
+on the character sequence "; ".  Called with the name of a cookie,
+retrieves the B<unescaped> form of the cookie.  You can use the
+regular cookie() method to get the names, or use the raw_fetch()
+method from the CGI::Cookie module.
+
+=item B<user_agent()>
+
+Returns the HTTP_USER_AGENT variable.  If you give
+this method a single argument, it will attempt to
+pattern match on it, allowing you to do something
+like user_agent(Mozilla);
+
+=item B<path_info()>
+
+Returns additional path information from the script URL.
+E.G. fetching /cgi-bin/your_script/additional/stuff will result in
+path_info() returning "/additional/stuff".
+
+NOTE: The Microsoft Internet Information Server
+is broken with respect to additional path information.  If
+you use the Perl DLL library, the IIS server will attempt to
+execute the additional path information as a Perl script.
+If you use the ordinary file associations mapping, the
+path information will be present in the environment, 
+but incorrect.  The best thing to do is to avoid using additional
+path information in CGI scripts destined for use with IIS.
+
+=item B<path_translated()>
+
+As per path_info() but returns the additional
+path information translated into a physical path, e.g.
+"/usr/local/etc/httpd/htdocs/additional/stuff".
+
+The Microsoft IIS is broken with respect to the translated
+path as well.
+
+=item B<remote_host()>
+
+Returns either the remote host name or IP address.
+if the former is unavailable.
+
+=item B<remote_addr()>
+
+Returns the remote host IP address, or 
+127.0.0.1 if the address is unavailable.
+
+=item B<script_name()>
+Return the script name as a partial URL, for self-referring
+scripts.
+
+=item B<referer()>
+
+Return the URL of the page the browser was viewing
+prior to fetching your script.  Not available for all
+browsers.
+
+=item B<auth_type ()>
+
+Return the authorization/verification method in use for this
+script, if any.
+
+=item B<server_name ()>
+
+Returns the name of the server, usually the machine's host
+name.
+
+=item B<virtual_host ()>
+
+When using virtual hosts, returns the name of the host that
+the browser attempted to contact
+
+=item B<server_port ()>
+
+Return the port that the server is listening on.
+
+=item B<virtual_port ()>
+
+Like server_port() except that it takes virtual hosts into account.
+Use this when running with virtual hosts.
+
+=item B<server_software ()>
+
+Returns the server software and version number.
+
+=item B<remote_user ()>
+
+Return the authorization/verification name used for user
+verification, if this script is protected.
+
+=item B<user_name ()>
+
+Attempt to obtain the remote user's name, using a variety of different
+techniques.  This only works with older browsers such as Mosaic.
+Newer browsers do not report the user name for privacy reasons!
+
+=item B<request_method()>
+
+Returns the method used to access your script, usually
+one of 'POST', 'GET' or 'HEAD'.
+
+=item B<content_type()>
+
+Returns the content_type of data submitted in a POST, generally 
+multipart/form-data or application/x-www-form-urlencoded
+
+=item B<http()>
+
+Called with no arguments returns the list of HTTP environment
+variables, including such things as HTTP_USER_AGENT,
+HTTP_ACCEPT_LANGUAGE, and HTTP_ACCEPT_CHARSET, corresponding to the
+like-named HTTP header fields in the request.  Called with the name of
+an HTTP header field, returns its value.  Capitalization and the use
+of hyphens versus underscores are not significant.
+
+For example, all three of these examples are equivalent:
+
+   $requested_language = http('Accept-language');
+   $requested_language = http('Accept_language');
+   $requested_language = http('HTTP_ACCEPT_LANGUAGE');
+
+=item B<https()>
+
+The same as I<http()>, but operates on the HTTPS environment variables
+present when the SSL protocol is in effect.  Can be used to determine
+whether SSL is turned on.
+
+=back
+
+=head1 USING NPH SCRIPTS
+
+NPH, or "no-parsed-header", scripts bypass the server completely by
+sending the complete HTTP header directly to the browser.  This has
+slight performance benefits, but is of most use for taking advantage
+of HTTP extensions that are not directly supported by your server,
+such as server push and PICS headers.
+
+Servers use a variety of conventions for designating CGI scripts as
+NPH.  Many Unix servers look at the beginning of the script's name for
+the prefix "nph-".  The Macintosh WebSTAR server and Microsoft's
+Internet Information Server, in contrast, try to decide whether a
+program is an NPH script by examining the first line of script output.
+
+
+CGI.pm supports NPH scripts with a special NPH mode.  When in this
+mode, CGI.pm will output the necessary extra header information when
+the header() and redirect() methods are
+called.
+
+The Microsoft Internet Information Server requires NPH mode.  As of
+version 2.30, CGI.pm will automatically detect when the script is
+running under IIS and put itself into this mode.  You do not need to
+do this manually, although it won't hurt anything if you do.  However,
+note that if you have applied Service Pack 6, much of the
+functionality of NPH scripts, including the ability to redirect while
+setting a cookie, B<do not work at all> on IIS without a special patch
+from Microsoft.  See
+http://web.archive.org/web/20010812012030/http://support.microsoft.com/support/kb/articles/Q280/3/41.ASP
+Non-Parsed Headers Stripped From CGI Applications That Have nph-
+Prefix in Name.
+
+=over 4
+
+=item In the B<use> statement 
+
+Simply add the "-nph" pragma to the list of symbols to be imported into
+your script:
+
+      use CGI qw(:standard -nph)
+
+=item By calling the B<nph()> method:
+
+Call B<nph()> with a non-zero parameter at any point after using CGI.pm in your program.
+
+      CGI->nph(1)
+
+=item By using B<-nph> parameters
+
+in the B<header()> and B<redirect()>  statements:
+
+      print header(-nph=>1);
+
+=back
+
+=head1 Server Push
+
+CGI.pm provides four simple functions for producing multipart
+documents of the type needed to implement server push.  These
+functions were graciously provided by Ed Jordan <ed@fidalgo.net>.  To
+import these into your namespace, you must import the ":push" set.
+You are also advised to put the script into NPH mode and to set $| to
+1 to avoid buffering problems.
+
+Here is a simple script that demonstrates server push:
+
+  #!/usr/local/bin/perl
+  use CGI qw/:push -nph/;
+  $| = 1;
+  print multipart_init(-boundary=>'----here we go!');
+  for (0 .. 4) {
+      print multipart_start(-type=>'text/plain'),
+            "The current time is ",scalar(localtime),"\n";
+      if ($_ < 4) {
+              print multipart_end;
+      } else {
+              print multipart_final;
+      }
+      sleep 1;
+  }
+
+This script initializes server push by calling B<multipart_init()>.
+It then enters a loop in which it begins a new multipart section by
+calling B<multipart_start()>, prints the current local time,
+and ends a multipart section with B<multipart_end()>.  It then sleeps
+a second, and begins again. On the final iteration, it ends the
+multipart section with B<multipart_final()> rather than with
+B<multipart_end()>.
+
+=over 4
+
+=item multipart_init()
+
+  multipart_init(-boundary=>$boundary);
+
+Initialize the multipart system.  The -boundary argument specifies
+what MIME boundary string to use to separate parts of the document.
+If not provided, CGI.pm chooses a reasonable boundary for you.
+
+=item multipart_start()
+
+  multipart_start(-type=>$type)
+
+Start a new part of the multipart document using the specified MIME
+type.  If not specified, text/html is assumed.
+
+=item multipart_end()
+
+  multipart_end()
+
+End a part.  You must remember to call multipart_end() once for each
+multipart_start(), except at the end of the last part of the multipart
+document when multipart_final() should be called instead of multipart_end().
+
+=item multipart_final()
+
+  multipart_final()
+
+End all parts.  You should call multipart_final() rather than
+multipart_end() at the end of the last part of the multipart document.
+
+=back
+
+Users interested in server push applications should also have a look
+at the CGI::Push module.
+
+=head1 Avoiding Denial of Service Attacks
+
+A potential problem with CGI.pm is that, by default, it attempts to
+process form POSTings no matter how large they are.  A wily hacker
+could attack your site by sending a CGI script a huge POST of many
+megabytes.  CGI.pm will attempt to read the entire POST into a
+variable, growing hugely in size until it runs out of memory.  While
+the script attempts to allocate the memory the system may slow down
+dramatically.  This is a form of denial of service attack.
+
+Another possible attack is for the remote user to force CGI.pm to
+accept a huge file upload.  CGI.pm will accept the upload and store it
+in a temporary directory even if your script doesn't expect to receive
+an uploaded file.  CGI.pm will delete the file automatically when it
+terminates, but in the meantime the remote user may have filled up the
+server's disk space, causing problems for other programs.
+
+The best way to avoid denial of service attacks is to limit the amount
+of memory, CPU time and disk space that CGI scripts can use.  Some Web
+servers come with built-in facilities to accomplish this. In other
+cases, you can use the shell I<limit> or I<ulimit>
+commands to put ceilings on CGI resource usage.
+
+
+CGI.pm also has some simple built-in protections against denial of
+service attacks, but you must activate them before you can use them.
+These take the form of two global variables in the CGI name space:
+
+=over 4
+
+=item B<$CGI::POST_MAX>
+
+If set to a non-negative integer, this variable puts a ceiling
+on the size of POSTings, in bytes.  If CGI.pm detects a POST
+that is greater than the ceiling, it will immediately exit with an error
+message.  This value will affect both ordinary POSTs and
+multipart POSTs, meaning that it limits the maximum size of file
+uploads as well.  You should set this to a reasonably high
+value, such as 1 megabyte.
+
+=item B<$CGI::DISABLE_UPLOADS>
+
+If set to a non-zero value, this will disable file uploads
+completely.  Other fill-out form values will work as usual.
+
+=back
+
+You can use these variables in either of two ways.
+
+=over 4
+
+=item B<1. On a script-by-script basis>
+
+Set the variable at the top of the script, right after the "use" statement:
+
+    use CGI qw/:standard/;
+    use CGI::Carp 'fatalsToBrowser';
+    $CGI::POST_MAX=1024 * 100;  # max 100K posts
+    $CGI::DISABLE_UPLOADS = 1;  # no uploads
+
+=item B<2. Globally for all scripts>
+
+Open up CGI.pm, find the definitions for $POST_MAX and 
+$DISABLE_UPLOADS, and set them to the desired values.  You'll 
+find them towards the top of the file in a subroutine named 
+initialize_globals().
+
+=back
+
+An attempt to send a POST larger than $POST_MAX bytes will cause
+I<param()> to return an empty CGI parameter list.  You can test for
+this event by checking I<cgi_error()>, either after you create the CGI
+object or, if you are using the function-oriented interface, call
+<param()> for the first time.  If the POST was intercepted, then
+cgi_error() will return the message "413 POST too large".
+
+This error message is actually defined by the HTTP protocol, and is
+designed to be returned to the browser as the CGI script's status
+ code.  For example:
+
+   $uploaded_file = param('upload');
+   if (!$uploaded_file && cgi_error()) {
+      print header(-status=>cgi_error());
+      exit 0;
+   }
+
+However it isn't clear that any browser currently knows what to do
+with this status code.  It might be better just to create an
+HTML page that warns the user of the problem.
+
+=head1 COMPATIBILITY WITH CGI-LIB.PL
+
+To make it easier to port existing programs that use cgi-lib.pl the
+compatibility routine "ReadParse" is provided.  Porting is simple:
+
+OLD VERSION
+
+    require "cgi-lib.pl";
+    &ReadParse;
+    print "The value of the antique is $in{antique}.\n";
+
+NEW VERSION
+
+    use CGI;
+    CGI::ReadParse();
+    print "The value of the antique is $in{antique}.\n";
+
+CGI.pm's ReadParse() routine creates a tied variable named %in,
+which can be accessed to obtain the query variables.  Like
+ReadParse, you can also provide your own variable.  Infrequently
+used features of ReadParse, such as the creation of @in and $in
+variables, are not supported.
+
+Once you use ReadParse, you can retrieve the query object itself
+this way:
+
+    $q = $in{CGI};
+    print $q->textfield(-name=>'wow',
+            -value=>'does this really work?');
+
+This allows you to start using the more interesting features
+of CGI.pm without rewriting your old scripts from scratch.
+
+An even simpler way to mix cgi-lib calls with CGI.pm calls is to import both the
+C<:cgi-lib> and C<:standard> method:
+
+ use CGI qw(:cgi-lib :standard);
+ &ReadParse;
+ print "The price of your purchase is $in{price}.\n";
+ print textfield(-name=>'price', -default=>'$1.99');
+
+=head2 Cgi-lib functions that are available in CGI.pm
+
+In compatibility mode, the following cgi-lib.pl functions are
+available for your use:
+
+ ReadParse()
+ PrintHeader()
+ HtmlTop()
+ HtmlBot()
+ SplitParam()
+ MethGet()
+ MethPost()
+
+=head2 Cgi-lib functions that are not available in CGI.pm
+
+  * Extended form of ReadParse()
+    The extended form of ReadParse() that provides for file upload
+    spooling, is not available.
+
+  * MyBaseURL()
+    This function is not available.  Use CGI.pm's url() method instead.
+
+  * MyFullURL()
+    This function is not available.  Use CGI.pm's self_url() method
+    instead.
+
+  * CgiError(), CgiDie()
+    These functions are not supported.  Look at CGI::Carp for the way I
+    prefer to handle error messages.
+
+  * PrintVariables()
+    This function is not available.  To achieve the same effect,
+       just print out the CGI object:
+
+       use CGI qw(:standard);
+       $q = CGI->new;
+       print h1("The Variables Are"),$q;
+
+  * PrintEnv()
+    This function is not available. You'll have to roll your own if you really need it.
+
+=head1 AUTHOR INFORMATION
+
+The CGI.pm distribution is copyright 1995-2007, Lincoln D. Stein. It is
+distributed under GPL and the Artistic License 2.0. It is currently
+maintained by Mark Stosberg with help from many contributors.
+
+Address bug reports and comments to: https://rt.cpan.org/Public/Dist/Display.html?Queue=CGI.pm
+When sending bug reports, please provide the version of CGI.pm, the version of
+Perl, the name and version of your Web server, and the name and version of the
+operating system you are using.  If the problem is even remotely browser
+dependent, please provide information about the affected browsers as well.
+
+=head1 CREDITS
+
+Thanks very much to:
+
+=over 4
+
+=item Matt Heffron (heffron@falstaff.css.beckman.com)
+
+=item James Taylor (james.taylor@srs.gov)
+
+=item Scott Anguish <sanguish@digifix.com>
+
+=item Mike Jewell (mlj3u@virginia.edu)
+
+=item Timothy Shimmin (tes@kbs.citri.edu.au)
+
+=item Joergen Haegg (jh@axis.se)
+
+=item Laurent Delfosse (delfosse@delfosse.com)
+
+=item Richard Resnick (applepi1@aol.com)
+
+=item Craig Bishop (csb@barwonwater.vic.gov.au)
+
+=item Tony Curtis (tc@vcpc.univie.ac.at)
+
+=item Tim Bunce (Tim.Bunce@ig.co.uk)
+
+=item Tom Christiansen (tchrist@convex.com)
+
+=item Andreas Koenig (k@franz.ww.TU-Berlin.DE)
+
+=item Tim MacKenzie (Tim.MacKenzie@fulcrum.com.au)
+
+=item Kevin B. Hendricks (kbhend@dogwood.tyler.wm.edu)
+
+=item Stephen Dahmen (joyfire@inxpress.net)
+
+=item Ed Jordan (ed@fidalgo.net)
+
+=item David Alan Pisoni (david@cnation.com)
+
+=item Doug MacEachern (dougm@opengroup.org)
+
+=item Robin Houston (robin@oneworld.org)
+
+=item ...and many many more...
+
+for suggestions and bug fixes.
+
+=back
+
+=head1 A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
+
+
+       #!/usr/local/bin/perl
+
+       use CGI ':standard';
+
+       print header;
+       print start_html("Example CGI.pm Form");
+       print "<h1> Example CGI.pm Form</h1>\n";
+        print_prompt();
+       do_work();
+       print_tail();
+       print end_html;
+
+       sub print_prompt {
+          print start_form;
+          print "<em>What's your name?</em><br>";
+          print textfield('name');
+          print checkbox('Not my real name');
+
+          print "<p><em>Where can you find English Sparrows?</em><br>";
+          print checkbox_group(
+                                -name=>'Sparrow locations',
+                                -values=>[England,France,Spain,Asia,Hoboken],
+                                -linebreak=>'yes',
+                                -defaults=>[England,Asia]);
+
+          print "<p><em>How far can they fly?</em><br>",
+               radio_group(
+                       -name=>'how far',
+                       -values=>['10 ft','1 mile','10 miles','real far'],
+                       -default=>'1 mile');
+
+          print "<p><em>What's your favorite color?</em>  ";
+          print popup_menu(-name=>'Color',
+                                   -values=>['black','brown','red','yellow'],
+                                   -default=>'red');
+
+          print hidden('Reference','Monty Python and the Holy Grail');
+
+          print "<p><em>What have you got there?</em><br>";
+          print scrolling_list(
+                        -name=>'possessions',
+                        -values=>['A Coconut','A Grail','An Icon',
+                                  'A Sword','A Ticket'],
+                        -size=>5,
+                        -multiple=>'true');
+
+          print "<p><em>Any parting comments?</em><br>";
+          print textarea(-name=>'Comments',
+                                 -rows=>10,
+                                 -columns=>50);
+
+          print "<p>",reset;
+          print submit('Action','Shout');
+          print submit('Action','Scream');
+          print end_form;
+          print "<hr>\n";
+       }
+
+       sub do_work {
+
+          print "<h2>Here are the current settings in this form</h2>";
+
+          for my $key (param) {
+             print "<strong>$key</strong> -> ";
+             my @values = param($key);
+             print join(", ",@values),"<br>\n";
+         }
+       }
+
+       sub print_tail {
+          print <<END;
+       <hr>
+       <address>Lincoln D. Stein</address><br>
+       <a href="/">Home Page</a>
+       END
+       }
+
+=head1 BUGS
+
+Please report them.
+
+=head1 SEE ALSO
+
+L<CGI::Carp> - provides a L<Carp> implementation tailored to the CGI environment.
+
+L<CGI::Fast> - supports running CGI applications under FastCGI
+
+L<CGI::Pretty> - pretty prints HTML generated by CGI.pm (with a performance penalty)
+
+=cut
+

diff --git a/lib/CGI/Apache.pm b/lib/CGI/Apache.pm
new file mode 100644 (file)
index 0000000..e055e30
--- /dev/null
+++ b/lib/CGI/Apache.pm
@@ -0,0 +1,27 @@
+package CGI::Apache;
+use CGI;
+
+$VERSION = '1.01';
+
+1;
+__END__
+
+=head1 NAME
+
+CGI::Apache - Backward compatibility module for CGI.pm
+
+=head1 SYNOPSIS
+
+Do not use this module.  It is deprecated.
+
+=head1 ABSTRACT
+
+=head1 DESCRIPTION
+
+=head1 AUTHOR INFORMATION
+
+=head1 BUGS
+
+=head1 SEE ALSO
+
+=cut

diff --git a/lib/CGI/Carp.pm b/lib/CGI/Carp.pm
new file mode 100644 (file)
index 0000000..c2145ca
--- /dev/null
+++ b/lib/CGI/Carp.pm
@@ -0,0 +1,629 @@
+package CGI::Carp;
+
+=head1 NAME
+
+B<CGI::Carp> - CGI routines for writing to the HTTPD (or other) error log
+
+=head1 SYNOPSIS
+
+    use CGI::Carp;
+
+    croak "We're outta here!";
+    confess "It was my fault: $!";
+    carp "It was your fault!";   
+    warn "I'm confused";
+    die  "I'm dying.\n";
+
+    use CGI::Carp qw(cluck);
+    cluck "I wouldn't do that if I were you";
+
+    use CGI::Carp qw(fatalsToBrowser);
+    die "Fatal error messages are now sent to browser";
+
+=head1 DESCRIPTION
+
+CGI scripts have a nasty habit of leaving warning messages in the error
+logs that are neither time stamped nor fully identified.  Tracking down
+the script that caused the error is a pain.  This fixes that.  Replace
+the usual
+
+    use Carp;
+
+with
+
+    use CGI::Carp
+
+The standard warn(), die (), croak(), confess() and carp() calls will
+be replaced with functions that write time-stamped messages to the
+HTTP server error log.
+
+For example:
+
+   [Fri Nov 17 21:40:43 1995] test.pl: I'm confused at test.pl line 3.
+   [Fri Nov 17 21:40:43 1995] test.pl: Got an error message: Permission denied.
+   [Fri Nov 17 21:40:43 1995] test.pl: I'm dying.
+
+=head1 REDIRECTING ERROR MESSAGES
+
+By default, error messages are sent to STDERR.  Most HTTPD servers
+direct STDERR to the server's error log.  Some applications may wish
+to keep private error logs, distinct from the server's error log, or
+they may wish to direct error messages to STDOUT so that the browser
+will receive them.
+
+The C<carpout()> function is provided for this purpose.  Since
+carpout() is not exported by default, you must import it explicitly by
+saying
+
+   use CGI::Carp qw(carpout);
+
+The carpout() function requires one argument, a reference to an open
+filehandle for writing errors.  It should be called in a C<BEGIN>
+block at the top of the CGI application so that compiler errors will
+be caught.  Example:
+
+   BEGIN {
+     use CGI::Carp qw(carpout);
+     open(LOG, ">>/usr/local/cgi-logs/mycgi-log") or
+       die("Unable to open mycgi-log: $!\n");
+     carpout(LOG);
+   }
+
+carpout() does not handle file locking on the log for you at this
+point.  Also, note that carpout() does not work with in-memory file
+handles, although a patch would be welcome to address that.
+
+The real STDERR is not closed -- it is moved to CGI::Carp::SAVEERR.
+Some servers, when dealing with CGI scripts, close their connection to
+the browser when the script closes STDOUT and STDERR.
+CGI::Carp::SAVEERR is there to prevent this from happening
+prematurely.
+
+You can pass filehandles to carpout() in a variety of ways.  The "correct"
+way according to Tom Christiansen is to pass a reference to a filehandle
+GLOB:
+
+    carpout(\*LOG);
+
+This looks weird to mere mortals however, so the following syntaxes are
+accepted as well:
+
+    carpout(LOG);
+    carpout(main::LOG);
+    carpout(main'LOG);
+    carpout(\LOG);
+    carpout(\'main::LOG');
+
+    ... and so on
+
+FileHandle and other objects work as well.
+
+Use of carpout() is not great for performance, so it is recommended
+for debugging purposes or for moderate-use applications.  A future
+version of this module may delay redirecting STDERR until one of the
+CGI::Carp methods is called to prevent the performance hit.
+
+=head1 MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
+
+If you want to send fatal (die, confess) errors to the browser, import
+the special "fatalsToBrowser" subroutine:
+
+    use CGI::Carp qw(fatalsToBrowser);
+    die "Bad error here";
+
+Fatal errors will now be echoed to the browser as well as to the log.
+CGI::Carp arranges to send a minimal HTTP header to the browser so
+that even errors that occur in the early compile phase will be seen.
+Nonfatal errors will still be directed to the log file only (unless
+redirected with carpout).
+
+Note that fatalsToBrowser may B<not> work well with mod_perl version 2.0
+and higher.
+
+=head2 Changing the default message
+
+By default, the software error message is followed by a note to
+contact the Webmaster by e-mail with the time and date of the error.
+If this message is not to your liking, you can change it using the
+set_message() routine.  This is not imported by default; you should
+import it on the use() line:
+
+    use CGI::Carp qw(fatalsToBrowser set_message);
+    set_message("It's not a bug, it's a feature!");
+
+You may also pass in a code reference in order to create a custom
+error message.  At run time, your code will be called with the text
+of the error message that caused the script to die.  Example:
+
+    use CGI::Carp qw(fatalsToBrowser set_message);
+    BEGIN {
+       sub handle_errors {
+          my $msg = shift;
+          print "<h1>Oh gosh</h1>";
+          print "<p>Got an error: $msg</p>";
+      }
+      set_message(\&handle_errors);
+    }
+
+In order to correctly intercept compile-time errors, you should call
+set_message() from within a BEGIN{} block.
+
+=head1 DOING MORE THAN PRINTING A MESSAGE IN THE EVENT OF PERL ERRORS
+
+If fatalsToBrowser in conjunction with set_message does not provide 
+you with all of the functionality you need, you can go one step 
+further by specifying a function to be executed any time a script
+calls "die", has a syntax error, or dies unexpectedly at runtime
+with a line like "undef->explode();". 
+
+    use CGI::Carp qw(set_die_handler);
+    BEGIN {
+       sub handle_errors {
+          my $msg = shift;
+          print "content-type: text/html\n\n";
+          print "<h1>Oh gosh</h1>";
+          print "<p>Got an error: $msg</p>";
+
+          #proceed to send an email to a system administrator,
+          #write a detailed message to the browser and/or a log,
+          #etc....
+      }
+      set_die_handler(\&handle_errors);
+    }
+
+Notice that if you use set_die_handler(), you must handle sending
+HTML headers to the browser yourself if you are printing a message.
+
+If you use set_die_handler(), you will most likely interfere with 
+the behavior of fatalsToBrowser, so you must use this or that, not 
+both. 
+
+Using set_die_handler() sets SIG{__DIE__} (as does fatalsToBrowser),
+and there is only one SIG{__DIE__}. This means that if you are 
+attempting to set SIG{__DIE__} yourself, you may interfere with 
+this module's functionality, or this module may interfere with 
+your module's functionality.
+
+=head2 SUPPRESSING PERL ERRORS APPEARING IN THE BROWSER WINDOW
+
+A problem sometimes encountered when using fatalsToBrowser is
+when a C<die()> is done inside an C<eval> body or expression.
+Even though the
+fatalsToBrower support takes precautions to avoid this,
+you still may get the error message printed to STDOUT.
+This may have some undesireable effects when the purpose of doing the
+eval is to determine which of several algorithms is to be used.
+
+By setting C<$CGI::Carp::TO_BROWSER> to 0 you can suppress printing
+the C<die> messages but without all of the complexity of using
+C<set_die_handler>.  You can localize this effect to inside C<eval>
+bodies if this is desireable: For example:
+
+ eval {
+   local $CGI::Carp::TO_BROWSER = 0;
+   die "Fatal error messages not sent browser"
+ }
+ # $@ will contain error message
+
+
+=head1 MAKING WARNINGS APPEAR AS HTML COMMENTS
+
+It is also possible to make non-fatal errors appear as HTML comments
+embedded in the output of your program.  To enable this feature,
+export the new "warningsToBrowser" subroutine.  Since sending warnings
+to the browser before the HTTP headers have been sent would cause an
+error, any warnings are stored in an internal buffer until you call
+the warningsToBrowser() subroutine with a true argument:
+
+    use CGI::Carp qw(fatalsToBrowser warningsToBrowser);
+    use CGI qw(:standard);
+    print header();
+    warningsToBrowser(1);
+
+You may also give a false argument to warningsToBrowser() to prevent
+warnings from being sent to the browser while you are printing some
+content where HTML comments are not allowed:
+
+    warningsToBrowser(0);    # disable warnings
+    print "<script type=\"text/javascript\"><!--\n";
+    print_some_javascript_code();
+    print "//--></script>\n";
+    warningsToBrowser(1);    # re-enable warnings
+
+Note: In this respect warningsToBrowser() differs fundamentally from
+fatalsToBrowser(), which you should never call yourself!
+
+=head1 OVERRIDING THE NAME OF THE PROGRAM
+
+CGI::Carp includes the name of the program that generated the error or
+warning in the messages written to the log and the browser window.
+Sometimes, Perl can get confused about what the actual name of the
+executed program was.  In these cases, you can override the program
+name that CGI::Carp will use for all messages.
+
+The quick way to do that is to tell CGI::Carp the name of the program
+in its use statement.  You can do that by adding
+"name=cgi_carp_log_name" to your "use" statement.  For example:
+
+    use CGI::Carp qw(name=cgi_carp_log_name);
+
+.  If you want to change the program name partway through the program,
+you can use the C<set_progname()> function instead.  It is not
+exported by default, you must import it explicitly by saying
+
+    use CGI::Carp qw(set_progname);
+
+Once you've done that, you can change the logged name of the program
+at any time by calling
+
+    set_progname(new_program_name);
+
+You can set the program back to the default by calling
+
+    set_progname(undef);
+
+Note that this override doesn't happen until after the program has
+compiled, so any compile-time errors will still show up with the
+non-overridden program name
+  
+=head1 CHANGE LOG
+
+3.51 Added $CGI::Carp::TO_BROWSER
+
+1.29 Patch from Peter Whaite to fix the unfixable problem of CGI::Carp
+     not behaving correctly in an eval() context.
+
+1.05 carpout() added and minor corrections by Marc Hedlund
+     <hedlund@best.com> on 11/26/95.
+
+1.06 fatalsToBrowser() no longer aborts for fatal errors within
+     eval() statements.
+
+1.08 set_message() added and carpout() expanded to allow for FileHandle
+     objects.
+
+1.09 set_message() now allows users to pass a code REFERENCE for 
+     really custom error messages.  croak and carp are now
+     exported by default.  Thanks to Gunther Birznieks for the
+     patches.
+
+1.10 Patch from Chris Dean (ctdean@cogit.com) to allow 
+     module to run correctly under mod_perl.
+
+1.11 Changed order of &gt; and &lt; escapes.
+
+1.12 Changed die() on line 217 to CORE::die to avoid B<-w> warning.
+
+1.13 Added cluck() to make the module orthogonal with Carp.
+     More mod_perl related fixes.
+
+1.20 Patch from Ilmari Karonen (perl@itz.pp.sci.fi):  Added
+     warningsToBrowser().  Replaced <CODE> tags with <PRE> in
+     fatalsToBrowser() output.
+
+1.23 ineval() now checks both $^S and inspects the message for the "eval" pattern
+     (hack alert!) in order to accommodate various combinations of Perl and
+     mod_perl.
+
+1.24 Patch from Scott Gifford (sgifford@suspectclass.com): Add support
+     for overriding program name.
+
+1.26 Replaced CORE::GLOBAL::die with the evil $SIG{__DIE__} because the
+     former isn't working in some people's hands.  There is no such thing
+     as reliable exception handling in Perl.
+
+1.27 Replaced tell STDOUT with bytes=tell STDOUT.
+
+=head1 AUTHORS
+
+Copyright 1995-2002, Lincoln D. Stein.  All rights reserved.  
+
+This library is free software; you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
+=head1 SEE ALSO
+
+L<Carp>, L<CGI::Base>, L<CGI::BasePlus>, L<CGI::Request>,
+L<CGI::MiniSvr>, L<CGI::Form>, L<CGI::Response>.
+
+=cut
+
+require 5.000;
+use Exporter;
+#use Carp;
+BEGIN { 
+  require Carp; 
+  *CORE::GLOBAL::die = \&CGI::Carp::die;
+}
+
+use File::Spec;
+
+@ISA = qw(Exporter);
+@EXPORT = qw(confess croak carp);
+@EXPORT_OK = qw(carpout fatalsToBrowser warningsToBrowser wrap set_message set_die_handler set_progname cluck ^name= die);
+
+$main::SIG{__WARN__}=\&CGI::Carp::warn;
+
+$CGI::Carp::VERSION     = '3.51';
+$CGI::Carp::CUSTOM_MSG  = undef;
+$CGI::Carp::DIE_HANDLER = undef;
+$CGI::Carp::TO_BROWSER  = 1;
+
+
+# fancy import routine detects and handles 'errorWrap' specially.
+sub import {
+    my $pkg = shift;
+    my(%routines);
+    my(@name);
+    if (@name=grep(/^name=/,@_))
+      {
+        my($n) = (split(/=/,$name[0]))[1];
+        set_progname($n);
+        @_=grep(!/^name=/,@_);
+      }
+
+    grep($routines{$_}++,@_,@EXPORT);
+    $WRAP++ if $routines{'fatalsToBrowser'} || $routines{'wrap'};
+    $WARN++ if $routines{'warningsToBrowser'};
+    my($oldlevel) = $Exporter::ExportLevel;
+    $Exporter::ExportLevel = 1;
+    Exporter::import($pkg,keys %routines);
+    $Exporter::ExportLevel = $oldlevel;
+    $main::SIG{__DIE__} =\&CGI::Carp::die if $routines{'fatalsToBrowser'};
+#    $pkg->export('CORE::GLOBAL','die');
+}
+
+# These are the originals
+sub realwarn { CORE::warn(@_); }
+sub realdie { CORE::die(@_); }
+
+sub id {
+    my $level = shift;
+    my($pack,$file,$line,$sub) = caller($level);
+    my($dev,$dirs,$id) = File::Spec->splitpath($file);
+    return ($file,$line,$id);
+}
+
+sub stamp {
+    my $time = scalar(localtime);
+    my $frame = 0;
+    my ($id,$pack,$file,$dev,$dirs);
+    if (defined($CGI::Carp::PROGNAME)) {
+        $id = $CGI::Carp::PROGNAME;
+    } else {
+        do {
+         $id = $file;
+         ($pack,$file) = caller($frame++);
+        } until !$file;
+    }
+    ($dev,$dirs,$id) = File::Spec->splitpath($id);
+    return "[$time] $id: ";
+}
+
+sub set_progname {
+    $CGI::Carp::PROGNAME = shift;
+    return $CGI::Carp::PROGNAME;
+}
+
+
+sub warn {
+    my $message = shift;
+    my($file,$line,$id) = id(1);
+    $message .= " at $file line $line.\n" unless $message=~/\n$/;
+    _warn($message) if $WARN;
+    my $stamp = stamp;
+    $message=~s/^/$stamp/gm;
+    realwarn $message;
+}
+
+sub _warn {
+    my $msg = shift;
+    if ($EMIT_WARNINGS) {
+       # We need to mangle the message a bit to make it a valid HTML
+       # comment.  This is done by substituting similar-looking ISO
+       # 8859-1 characters for <, > and -.  This is a hack.
+       $msg =~ tr/<>-/\253\273\255/;
+       chomp $msg;
+       print STDOUT "<!-- warning: $msg -->\n";
+    } else {
+       push @WARNINGS, $msg;
+    }
+}
+
+
+# The mod_perl package Apache::Registry loads CGI programs by calling
+# eval.  These evals don't count when looking at the stack backtrace.
+sub _longmess {
+    my $message = Carp::longmess();
+    $message =~ s,eval[^\n]+(ModPerl|Apache)/(?:Registry|Dispatch)\w*\.pm.*,,s
+        if exists $ENV{MOD_PERL};
+    return $message;
+}
+
+sub ineval {
+  (exists $ENV{MOD_PERL} ? 0 : $^S) || _longmess() =~ /eval [\{\']/m
+}
+
+sub die {
+    # if no argument is passed, propagate $@ like
+    # the real die
+  my ($arg,@rest) = @_ ? @_ 
+                  : $@ ? "$@\t...propagated" 
+                  :      "Died"
+                  ;
+
+  &$DIE_HANDLER($arg,@rest) if $DIE_HANDLER;
+
+  # the "$arg" is done on purpose!
+  # if called as die( $object, 'string' ),
+  # all is stringified, just like with
+  # the real 'die'
+  $arg = join '' => "$arg", @rest if @rest;
+
+  my($file,$line,$id) = id(1);
+
+  $arg .= " at $file line $line.\n" unless ref $arg or $arg=~/\n$/;
+
+  realdie $arg           if ineval();
+  &fatalsToBrowser($arg) if ($WRAP and $CGI::Carp::TO_BROWSER);
+
+  $arg=~s/^/ stamp() /gme if $arg =~ /\n$/ or not exists $ENV{MOD_PERL};
+
+  $arg .= "\n" unless $arg =~ /\n$/;
+
+  realdie $arg;
+}
+
+sub set_message {
+    $CGI::Carp::CUSTOM_MSG = shift;
+    return $CGI::Carp::CUSTOM_MSG;
+}
+
+sub set_die_handler {
+
+    my ($handler) = shift;
+    
+    #setting SIG{__DIE__} here is necessary to catch runtime
+    #errors which are not called by literally saying "die",
+    #such as the line "undef->explode();". however, doing this
+    #will interfere with fatalsToBrowser, which also sets 
+    #SIG{__DIE__} in the import() function above (or the 
+    #import() function above may interfere with this). for
+    #this reason, you should choose to either set the die
+    #handler here, or use fatalsToBrowser, not both. 
+    $main::SIG{__DIE__} = $handler;
+    
+    $CGI::Carp::DIE_HANDLER = $handler; 
+    
+    return $CGI::Carp::DIE_HANDLER;
+}
+
+sub confess { CGI::Carp::die Carp::longmess @_; }
+sub croak   { CGI::Carp::die Carp::shortmess @_; }
+sub carp    { CGI::Carp::warn Carp::shortmess @_; }
+sub cluck   { CGI::Carp::warn Carp::longmess @_; }
+
+# We have to be ready to accept a filehandle as a reference
+# or a string.
+sub carpout {
+    my($in) = @_;
+    my($no) = fileno(to_filehandle($in));
+    realdie("Invalid filehandle $in\n") unless defined $no;
+    
+    open(SAVEERR, ">&STDERR");
+    open(STDERR, ">&$no") or 
+       ( print SAVEERR "Unable to redirect STDERR: $!\n" and exit(1) );
+}
+
+sub warningsToBrowser {
+    $EMIT_WARNINGS = @_ ? shift : 1;
+    _warn(shift @WARNINGS) while $EMIT_WARNINGS and @WARNINGS;
+}
+
+# headers
+sub fatalsToBrowser {
+  my $msg = shift;
+
+  $msg = "$msg" if ref $msg;
+
+  $msg=~s/&/&amp;/g;
+  $msg=~s/>/&gt;/g;
+  $msg=~s/</&lt;/g;
+  $msg=~s/"/&quot;/g;
+
+  my($wm) = $ENV{SERVER_ADMIN} ? 
+    qq[the webmaster (<a href="mailto:$ENV{SERVER_ADMIN}">$ENV{SERVER_ADMIN}</a>)] :
+      "this site's webmaster";
+  my ($outer_message) = <<END;
+For help, please send mail to $wm, giving this error message 
+and the time and date of the error.
+END
+  ;
+  my $mod_perl = exists $ENV{MOD_PERL};
+
+  if ($CUSTOM_MSG) {
+    if (ref($CUSTOM_MSG) eq 'CODE') {
+      print STDOUT "Content-type: text/html\n\n" 
+        unless $mod_perl;
+        eval { 
+            &$CUSTOM_MSG($msg); # nicer to perl 5.003 users
+        };
+        if ($@) { print STDERR q(error while executing the error handler: $@); }
+
+      return;
+    } else {
+      $outer_message = $CUSTOM_MSG;
+    }
+  }
+
+  my $mess = <<END;
+<h1>Software error:</h1>
+<pre>$msg</pre>
+<p>
+$outer_message
+</p>
+END
+  ;
+
+  if ($mod_perl) {
+    my $r;
+    if ($ENV{MOD_PERL_API_VERSION} && $ENV{MOD_PERL_API_VERSION} == 2) {
+      $mod_perl = 2;
+      require Apache2::RequestRec;
+      require Apache2::RequestIO;
+      require Apache2::RequestUtil;
+      require APR::Pool;
+      require ModPerl::Util;
+      require Apache2::Response;
+      $r = Apache2::RequestUtil->request;
+    }
+    else {
+      $r = Apache->request;
+    }
+    # If bytes have already been sent, then
+    # we print the message out directly.
+    # Otherwise we make a custom error
+    # handler to produce the doc for us.
+    if ($r->bytes_sent) {
+      $r->print($mess);
+      $mod_perl == 2 ? ModPerl::Util::exit(0) : $r->exit;
+    } else {
+      # MSIE won't display a custom 500 response unless it is >512 bytes!
+      if ($ENV{HTTP_USER_AGENT} =~ /MSIE/) {
+        $mess = "<!-- " . (' ' x 513) . " -->\n$mess";
+      }
+      $r->custom_response(500,$mess);
+    }
+  } else {
+    my $bytes_written = eval{tell STDOUT};
+    if (defined $bytes_written && $bytes_written > 0) {
+        print STDOUT $mess;
+    }
+    else {
+        print STDOUT "Status: 500\n";
+        print STDOUT "Content-type: text/html\n\n";
+        print STDOUT $mess;
+    }
+  }
+
+  warningsToBrowser(1);    # emit warnings before dying
+}
+
+# Cut and paste from CGI.pm so that we don't have the overhead of
+# always loading the entire CGI module.
+sub to_filehandle {
+    my $thingy = shift;
+    return undef unless $thingy;
+    return $thingy if UNIVERSAL::isa($thingy,'GLOB');
+    return $thingy if UNIVERSAL::isa($thingy,'FileHandle');
+    if (!ref($thingy)) {
+       my $caller = 1;
+       while (my $package = caller($caller++)) {
+           my($tmp) = $thingy=~/[\':]/ ? $thingy : "$package\:\:$thingy"; 
+           return $tmp if defined(fileno($tmp));
+       }
+    }
+    return undef;
+}
+
+1;

diff --git a/lib/CGI/Cookie.pm b/lib/CGI/Cookie.pm
new file mode 100644 (file)
index 0000000..da916ac
--- /dev/null
+++ b/lib/CGI/Cookie.pm
@@ -0,0 +1,540 @@
+package CGI::Cookie;
+
+use strict;
+use warnings;
+
+# See the bottom of this file for the POD documentation.  Search for the
+# string '=head'.
+
+# You can run this file through either pod2man or pod2html to produce pretty
+# documentation in manual or html file format (these utilities are part of the
+# Perl 5 distribution).
+
+# Copyright 1995-1999, Lincoln D. Stein.  All rights reserved.
+# It may be used and modified freely, but I do request that this copyright
+# notice remain attached to the file.  You may modify this module as you
+# wish, but if you redistribute a modified version, please attach a note
+# listing the modifications you have made.
+
+our $VERSION='1.30';
+
+use CGI::Util qw(rearrange unescape escape);
+use overload '""' => \&as_string, 'cmp' => \&compare, 'fallback' => 1;
+
+my $PERLEX = 0;
+# Turn on special checking for ActiveState's PerlEx
+$PERLEX++ if defined($ENV{'GATEWAY_INTERFACE'}) && $ENV{'GATEWAY_INTERFACE'} =~ /^CGI-PerlEx/;
+
+# Turn on special checking for mod_perl
+# PerlEx::DBI tries to fool DBI by setting MOD_PERL
+my $MOD_PERL = 0;
+if (exists $ENV{MOD_PERL} && ! $PERLEX) {
+  if (exists $ENV{MOD_PERL_API_VERSION} && $ENV{MOD_PERL_API_VERSION} == 2) {
+      $MOD_PERL = 2;
+      require Apache2::RequestUtil;
+      require APR::Table;
+  } else {
+    $MOD_PERL = 1;
+    require Apache;
+  }
+}
+
+# fetch a list of cookies from the environment and
+# return as a hash.  the cookies are parsed as normal
+# escaped URL data.
+sub fetch {
+    my $class = shift;
+    my $raw_cookie = get_raw_cookie(@_) or return;
+    return $class->parse($raw_cookie);
+}
+
+# Fetch a list of cookies from the environment or the incoming headers and
+# return as a hash. The cookie values are not unescaped or altered in any way.
+ sub raw_fetch {
+   my $class = shift;
+   my $raw_cookie = get_raw_cookie(@_) or return;
+   my %results;
+   my($key,$value);
+   
+   my @pairs = split("[;,] ?",$raw_cookie);
+  for my $pair ( @pairs ) {
+    $pair =~ s/^\s+|\s+$//g;    # trim leading trailing whitespace
+    my ( $key, $value ) = split "=", $pair;
+
+    $value = defined $value ? $value : '';
+    $results{$key} = $value;
+  }
+  return wantarray ? %results : \%results;
+}
+
+sub get_raw_cookie {
+  my $r = shift;
+  $r ||= eval { $MOD_PERL == 2                    ? 
+                  Apache2::RequestUtil->request() :
+                  Apache->request } if $MOD_PERL;
+
+  return $r->headers_in->{'Cookie'} if $r;
+
+  die "Run $r->subprocess_env; before calling fetch()" 
+    if $MOD_PERL and !exists $ENV{REQUEST_METHOD};
+    
+  return $ENV{HTTP_COOKIE} || $ENV{COOKIE};
+}
+
+
+sub parse {
+  my ($self,$raw_cookie) = @_;
+  return wantarray ? () : {} unless $raw_cookie;
+
+  my %results;
+
+  my @pairs = split("[;,] ?",$raw_cookie);
+  for (@pairs) {
+    s/^\s+//;
+    s/\s+$//;
+
+    my($key,$value) = split("=",$_,2);
+
+    # Some foreign cookies are not in name=value format, so ignore
+    # them.
+    next if !defined($value);
+    my @values = ();
+    if ($value ne '') {
+      @values = map unescape($_),split(/[&;]/,$value.'&dmy');
+      pop @values;
+    }
+    $key = unescape($key);
+    # A bug in Netscape can cause several cookies with same name to
+    # appear.  The FIRST one in HTTP_COOKIE is the most recent version.
+    $results{$key} ||= $self->new(-name=>$key,-value=>\@values);
+  }
+  return wantarray ? %results : \%results;
+}
+
+sub new {
+  my ( $class, @params ) = @_;
+  $class = ref( $class ) || $class;
+  # Ignore mod_perl request object--compatibility with Apache::Cookie.
+  shift if ref $params[0]
+        && eval { $params[0]->isa('Apache::Request::Req') || $params[0]->isa('Apache') };
+  my ( $name, $value, $path, $domain, $secure, $expires, $max_age, $httponly )
+   = rearrange(
+    [
+      'NAME', [ 'VALUE', 'VALUES' ],
+      'PATH',   'DOMAIN',
+      'SECURE', 'EXPIRES',
+      'MAX-AGE','HTTPONLY'
+    ],
+    @params
+   );
+  return undef unless defined $name and defined $value;
+  my $self = {};
+  bless $self, $class;
+  $self->name( $name );
+  $self->value( $value );
+  $path ||= "/";
+  $self->path( $path )         if defined $path;
+  $self->domain( $domain )     if defined $domain;
+  $self->secure( $secure )     if defined $secure;
+  $self->expires( $expires )   if defined $expires;
+  $self->max_age($expires)     if defined $max_age;
+  $self->httponly( $httponly ) if defined $httponly;
+  return $self;
+}
+
+sub as_string {
+    my $self = shift;
+    return "" unless $self->name;
+
+    no warnings; # some things may be undefined, that's OK.
+
+    my $name  = escape( $self->name );
+    my $value = join "&", map { escape($_) } $self->value;
+    my @cookie = ( "$name=$value" );
+
+    push @cookie,"domain=".$self->domain   if $self->domain;
+    push @cookie,"path=".$self->path       if $self->path;
+    push @cookie,"expires=".$self->expires if $self->expires;
+    push @cookie,"max-age=".$self->max_age if $self->max_age;
+    push @cookie,"secure"                  if $self->secure;
+    push @cookie,"HttpOnly"                if $self->httponly;
+
+    return join "; ", @cookie;
+}
+
+sub compare {
+    my ( $self, $value ) = @_;
+    return "$self" cmp $value;
+}
+
+sub bake {
+  my ($self, $r) = @_;
+
+  $r ||= eval {
+      $MOD_PERL == 2
+          ? Apache2::RequestUtil->request()
+          : Apache->request
+  } if $MOD_PERL;
+  if ($r) {
+      $r->headers_out->add('Set-Cookie' => $self->as_string);
+  } else {
+      require CGI;
+      print CGI::header(-cookie => $self);
+  }
+
+}
+
+# accessors
+sub name {
+    my ( $self, $name ) = @_;
+    $self->{'name'} = $name if defined $name;
+    return $self->{'name'};
+}
+
+sub value {
+  my ( $self, $value ) = @_;
+  if ( defined $value ) {
+    my @values
+     = ref $value eq 'ARRAY' ? @$value
+     : ref $value eq 'HASH'  ? %$value
+     :                         ( $value );
+    $self->{'value'} = [@values];
+  }
+  return wantarray ? @{ $self->{'value'} } : $self->{'value'}->[0];
+}
+
+sub domain {
+    my ( $self, $domain ) = @_;
+    $self->{'domain'} = lc $domain if defined $domain;
+    return $self->{'domain'};
+}
+
+sub secure {
+    my ( $self, $secure ) = @_;
+    $self->{'secure'} = $secure if defined $secure;
+    return $self->{'secure'};
+}
+
+sub expires {
+    my ( $self, $expires ) = @_;
+    $self->{'expires'} = CGI::Util::expires($expires,'cookie') if defined $expires;
+    return $self->{'expires'};
+}
+
+sub max_age {
+    my ( $self, $max_age ) = @_;
+    $self->{'max-age'} = CGI::Util::expire_calc($max_age)-time() if defined $max_age;
+    return $self->{'max-age'};
+}
+
+sub path {
+    my ( $self, $path ) = @_;
+    $self->{'path'} = $path if defined $path;
+    return $self->{'path'};
+}
+
+
+sub httponly { # HttpOnly
+    my ( $self, $httponly ) = @_;
+    $self->{'httponly'} = $httponly if defined $httponly;
+    return $self->{'httponly'};
+}
+
+1;
+
+=head1 NAME
+
+CGI::Cookie - Interface to HTTP Cookies
+
+=head1 SYNOPSIS
+
+    use CGI qw/:standard/;
+    use CGI::Cookie;
+
+    # Create new cookies and send them
+    $cookie1 = CGI::Cookie->new(-name=>'ID',-value=>123456);
+    $cookie2 = CGI::Cookie->new(-name=>'preferences',
+                               -value=>{ font => Helvetica,
+                                         size => 12 } 
+                               );
+    print header(-cookie=>[$cookie1,$cookie2]);
+
+    # fetch existing cookies
+    %cookies = CGI::Cookie->fetch;
+    $id = $cookies{'ID'}->value;
+
+    # create cookies returned from an external source
+    %cookies = CGI::Cookie->parse($ENV{COOKIE});
+
+=head1 DESCRIPTION
+
+CGI::Cookie is an interface to HTTP/1.1 cookies, an
+innovation that allows Web servers to store persistent information on
+the browser's side of the connection.  Although CGI::Cookie is
+intended to be used in conjunction with CGI.pm (and is in fact used by
+it internally), you can use this module independently.
+
+For full information on cookies see 
+
+       http://tools.ietf.org/html/rfc2109
+       http://tools.ietf.org/html/rfc2965
+       http://tools.ietf.org/html/draft-ietf-httpstate-cookie
+
+=head1 USING CGI::Cookie
+
+CGI::Cookie is object oriented.  Each cookie object has a name and a
+value.  The name is any scalar value.  The value is any scalar or
+array value (associative arrays are also allowed).  Cookies also have
+several optional attributes, including:
+
+=over 4
+
+=item B<1. expiration date>
+
+The expiration date tells the browser how long to hang on to the
+cookie.  If the cookie specifies an expiration date in the future, the
+browser will store the cookie information in a disk file and return it
+to the server every time the user reconnects (until the expiration
+date is reached).  If the cookie species an expiration date in the
+past, the browser will remove the cookie from the disk file.  If the
+expiration date is not specified, the cookie will persist only until
+the user quits the browser.
+
+=item B<2. domain>
+
+This is a partial or complete domain name for which the cookie is 
+valid.  The browser will return the cookie to any host that matches
+the partial domain name.  For example, if you specify a domain name
+of ".capricorn.com", then the browser will return the cookie to
+Web servers running on any of the machines "www.capricorn.com", 
+"ftp.capricorn.com", "feckless.capricorn.com", etc.  Domain names
+must contain at least two periods to prevent attempts to match
+on top level domains like ".edu".  If no domain is specified, then
+the browser will only return the cookie to servers on the host the
+cookie originated from.
+
+=item B<3. path>
+
+If you provide a cookie path attribute, the browser will check it
+against your script's URL before returning the cookie.  For example,
+if you specify the path "/cgi-bin", then the cookie will be returned
+to each of the scripts "/cgi-bin/tally.pl", "/cgi-bin/order.pl", and
+"/cgi-bin/customer_service/complain.pl", but not to the script
+"/cgi-private/site_admin.pl".  By default, the path is set to "/", so
+that all scripts at your site will receive the cookie.
+
+=item B<4. secure flag>
+
+If the "secure" attribute is set, the cookie will only be sent to your
+script if the CGI request is occurring on a secure channel, such as SSL.
+
+=item B<5. httponly flag>
+
+If the "httponly" attribute is set, the cookie will only be accessible
+through HTTP Requests. This cookie will be inaccessible via JavaScript
+(to prevent XSS attacks).
+
+This feature is only supported by recent browsers like Internet Explorer
+6 Service Pack 1, Firefox 3.0 and Opera 9.5 (and later of course).
+
+See these URLs for more information:
+
+       http://msdn.microsoft.com/en-us/library/ms533046.aspx
+       http://www.owasp.org/index.php/HTTPOnly#Browsers_Supporting_HTTPOnly
+
+=back
+
+=head2 Creating New Cookies
+
+       my $c = CGI::Cookie->new(-name    =>  'foo',
+                             -value   =>  'bar',
+                             -expires =>  '+3M',
+                             -domain  =>  '.capricorn.com',
+                             -path    =>  '/cgi-bin/database',
+                             -secure  =>  1
+                           );
+
+Create cookies from scratch with the B<new> method.  The B<-name> and
+B<-value> parameters are required.  The name must be a scalar value.
+The value can be a scalar, an array reference, or a hash reference.
+(At some point in the future cookies will support one of the Perl
+object serialization protocols for full generality).
+
+B<-expires> accepts any of the relative or absolute date formats
+recognized by CGI.pm, for example "+3M" for three months in the
+future.  See CGI.pm's documentation for details.
+
+B<-max-age> accepts the same data formats as B<< -expires >>, but sets a
+relative value instead of an absolute like B<< -expires >>. This is intended to be
+more secure since a clock could be changed to fake an absolute time. In
+practice, as of 2011, C<< -max-age >> still does not enjoy the widespread support
+that C<< -expires >> has. You can set both, and browsers that support
+C<< -max-age >> should ignore the C<< Expires >> header. The drawback
+to this approach is the bit of bandwidth for sending an extra header on each cookie.
+
+B<-domain> points to a domain name or to a fully qualified host name.
+If not specified, the cookie will be returned only to the Web server
+that created it.
+
+B<-path> points to a partial URL on the current server.  The cookie
+will be returned to all URLs beginning with the specified path.  If
+not specified, it defaults to '/', which returns the cookie to all
+pages at your site.
+
+B<-secure> if set to a true value instructs the browser to return the
+cookie only when a cryptographic protocol is in use.
+
+B<-httponly> if set to a true value, the cookie will not be accessible
+via JavaScript.
+
+For compatibility with Apache::Cookie, you may optionally pass in
+a mod_perl request object as the first argument to C<new()>. It will
+simply be ignored:
+
+  my $c = CGI::Cookie->new($r,
+                          -name    =>  'foo',
+                          -value   =>  ['bar','baz']);
+
+=head2 Sending the Cookie to the Browser
+
+The simplest way to send a cookie to the browser is by calling the bake()
+method:
+
+  $c->bake;
+
+This will print the Set-Cookie HTTP header to STDOUT using CGI.pm. CGI.pm
+will be loaded for this purpose if it is not already. Otherwise CGI.pm is not
+required or used by this module.
+
+Under mod_perl, pass in an Apache request object:
+
+  $c->bake($r);
+
+If you want to set the cookie yourself, Within a CGI script you can send
+a cookie to the browser by creating one or more Set-Cookie: fields in the
+HTTP header.  Here is a typical sequence:
+
+  my $c = CGI::Cookie->new(-name    =>  'foo',
+                          -value   =>  ['bar','baz'],
+                          -expires =>  '+3M');
+
+  print "Set-Cookie: $c\n";
+  print "Content-Type: text/html\n\n";
+
+To send more than one cookie, create several Set-Cookie: fields.
+
+If you are using CGI.pm, you send cookies by providing a -cookie
+argument to the header() method:
+
+  print header(-cookie=>$c);
+
+Mod_perl users can set cookies using the request object's header_out()
+method:
+
+  $r->headers_out->set('Set-Cookie' => $c);
+
+Internally, Cookie overloads the "" operator to call its as_string()
+method when incorporated into the HTTP header.  as_string() turns the
+Cookie's internal representation into an RFC-compliant text
+representation.  You may call as_string() yourself if you prefer:
+
+  print "Set-Cookie: ",$c->as_string,"\n";
+
+=head2 Recovering Previous Cookies
+
+       %cookies = CGI::Cookie->fetch;
+
+B<fetch> returns an associative array consisting of all cookies
+returned by the browser.  The keys of the array are the cookie names.  You
+can iterate through the cookies this way:
+
+       %cookies = CGI::Cookie->fetch;
+       for (keys %cookies) {
+          do_something($cookies{$_});
+        }
+
+In a scalar context, fetch() returns a hash reference, which may be more
+efficient if you are manipulating multiple cookies.
+
+CGI.pm uses the URL escaping methods to save and restore reserved characters
+in its cookies.  If you are trying to retrieve a cookie set by a foreign server,
+this escaping method may trip you up.  Use raw_fetch() instead, which has the
+same semantics as fetch(), but performs no unescaping.
+
+You may also retrieve cookies that were stored in some external
+form using the parse() class method:
+
+       $COOKIES = `cat /usr/tmp/Cookie_stash`;
+       %cookies = CGI::Cookie->parse($COOKIES);
+
+If you are in a mod_perl environment, you can save some overhead by
+passing the request object to fetch() like this:
+
+   CGI::Cookie->fetch($r);
+
+If the value passed to parse() is undefined, an empty array will returned in list
+context, and an empty hashref will be returned in scalar context.
+
+=head2 Manipulating Cookies
+
+Cookie objects have a series of accessor methods to get and set cookie
+attributes.  Each accessor has a similar syntax.  Called without
+arguments, the accessor returns the current value of the attribute.
+Called with an argument, the accessor changes the attribute and
+returns its new value.
+
+=over 4
+
+=item B<name()>
+
+Get or set the cookie's name.  Example:
+
+       $name = $c->name;
+       $new_name = $c->name('fred');
+
+=item B<value()>
+
+Get or set the cookie's value.  Example:
+
+       $value = $c->value;
+       @new_value = $c->value(['a','b','c','d']);
+
+B<value()> is context sensitive.  In a list context it will return
+the current value of the cookie as an array.  In a scalar context it
+will return the B<first> value of a multivalued cookie.
+
+=item B<domain()>
+
+Get or set the cookie's domain.
+
+=item B<path()>
+
+Get or set the cookie's path.
+
+=item B<expires()>
+
+Get or set the cookie's expiration time.
+
+=back
+
+
+=head1 AUTHOR INFORMATION
+
+Copyright 1997-1998, Lincoln D. Stein.  All rights reserved.  
+
+This library is free software; you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
+Address bug reports and comments to: lstein@cshl.org
+
+=head1 BUGS
+
+This section intentionally left blank.
+
+=head1 SEE ALSO
+
+L<CGI::Carp>, L<CGI>
+
+L<RFC 2109|http://www.ietf.org/rfc/rfc2109.txt>, L<RFC 2695|http://www.ietf.org/rfc/rfc2965.txt>
+
+=cut

diff --git a/lib/CGI/Fast.pm b/lib/CGI/Fast.pm
new file mode 100644 (file)
index 0000000..288d854
--- /dev/null
+++ b/lib/CGI/Fast.pm
@@ -0,0 +1,220 @@
+package CGI::Fast;
+use strict;
+
+# A way to say "use warnings" that's compatible with even older perls.
+# making it local will not affect the code that loads this module
+# and since we're not in a BLOCK, warnings are enabled until the EOF
+local $^W = 1;
+
+# See the bottom of this file for the POD documentation.  Search for the
+# string '=head'.
+
+# You can run this file through either pod2man or pod2html to produce pretty
+# documentation in manual or html file format (these utilities are part of the
+# Perl 5 distribution).
+
+# Copyright 1995,1996, Lincoln D. Stein.  All rights reserved.
+# It may be used and modified freely, but I do request that this copyright
+# notice remain attached to the file.  You may modify this module as you
+# wish, but if you redistribute a modified version, please attach a note
+# listing the modifications you have made.
+
+$CGI::Fast::VERSION='1.09';
+
+use CGI;
+use FCGI;
+# use vars works like "our", but is compatible with older Perls.
+use vars qw(
+    @ISA
+    $ignore
+);
+@ISA = ('CGI');
+
+# workaround for known bug in libfcgi
+while (($ignore) = each %ENV) { }
+
+# override the initialization behavior so that
+# state is NOT maintained between invocations
+sub save_request {
+    # no-op
+}
+
+# If ENV{FCGI_SOCKET_PATH} is specified, we maintain a FCGI Request handle
+# in this package variable.
+use vars qw($Ext_Request);
+BEGIN {
+    # If ENV{FCGI_SOCKET_PATH} is given, explicitly open the socket.
+    if ($ENV{FCGI_SOCKET_PATH}) {
+        my $path    = $ENV{FCGI_SOCKET_PATH};
+        my $backlog = $ENV{FCGI_LISTEN_QUEUE} || 100;
+        my $socket  = FCGI::OpenSocket( $path, $backlog );
+        $Ext_Request = FCGI::Request( \*STDIN, \*STDOUT, \*STDERR,
+                    \%ENV, $socket, 1 );
+    }
+    else {
+        $Ext_Request = FCGI::Request();
+    }
+}
+
+sub new {
+     my ($self, $initializer, @param) = @_;
+     unless (defined $initializer) {
+         return undef unless $Ext_Request->Accept() >= 0;
+     }
+     CGI->_reset_globals;
+     $self->_setup_symbols(@CGI::SAVED_SYMBOLS) if @CGI::SAVED_SYMBOLS;
+     return $CGI::Q = $self->SUPER::new($initializer, @param);
+}
+
+1;
+
+=head1 NAME
+
+CGI::Fast - CGI Interface for Fast CGI
+
+=head1 SYNOPSIS
+
+    use CGI::Fast qw(:standard);
+    $COUNTER = 0;
+    while (new CGI::Fast) {
+       print header;
+       print start_html("Fast CGI Rocks");
+       print
+           h1("Fast CGI Rocks"),
+           "Invocation number ",b($COUNTER++),
+            " PID ",b($$),".",
+           hr;
+        print end_html;
+    }
+
+=head1 DESCRIPTION
+
+CGI::Fast is a subclass of the CGI object created by CGI.pm.  It is
+specialized to work well FCGI module, which greatly speeds up CGI
+scripts by turning them into persistently running server processes.
+Scripts that perform time-consuming initialization processes, such as
+loading large modules or opening persistent database connections, will
+see large performance improvements.
+
+=head1 OTHER PIECES OF THE PUZZLE
+
+In order to use CGI::Fast you'll need the FCGI module.  See
+http://www.cpan.org/ for details.
+
+=head1 WRITING FASTCGI PERL SCRIPTS
+
+FastCGI scripts are persistent: one or more copies of the script
+are started up when the server initializes, and stay around until
+the server exits or they die a natural death.  After performing
+whatever one-time initialization it needs, the script enters a
+loop waiting for incoming connections, processing the request, and
+waiting some more.
+
+A typical FastCGI script will look like this:
+
+    #!/usr/bin/perl
+    use CGI::Fast;
+    &do_some_initialization();
+    while ($q = new CGI::Fast) {
+       &process_request($q);
+    }
+
+Each time there's a new request, CGI::Fast returns a
+CGI object to your loop.  The rest of the time your script
+waits in the call to new().  When the server requests that
+your script be terminated, new() will return undef.  You can
+of course exit earlier if you choose.  A new version of the
+script will be respawned to take its place (this may be
+necessary in order to avoid Perl memory leaks in long-running
+scripts).
+
+CGI.pm's default CGI object mode also works.  Just modify the loop
+this way:
+
+    while (new CGI::Fast) {
+       &process_request;
+    }
+
+Calls to header(), start_form(), etc. will all operate on the
+current request.
+
+=head1 INSTALLING FASTCGI SCRIPTS
+
+See the FastCGI developer's kit documentation for full details.  On
+the Apache server, the following line must be added to srm.conf:
+
+    AddType application/x-httpd-fcgi .fcgi
+
+FastCGI scripts must end in the extension .fcgi.  For each script you
+install, you must add something like the following to srm.conf:
+
+    FastCgiServer /usr/etc/httpd/fcgi-bin/file_upload.fcgi -processes 2
+
+This instructs Apache to launch two copies of file_upload.fcgi at
+startup time.
+
+=head1 USING FASTCGI SCRIPTS AS CGI SCRIPTS
+
+Any script that works correctly as a FastCGI script will also work
+correctly when installed as a vanilla CGI script.  However it will
+not see any performance benefit.
+
+=head1 EXTERNAL FASTCGI SERVER INVOCATION
+
+FastCGI supports a TCP/IP transport mechanism which allows FastCGI scripts to run
+external to the webserver, perhaps on a remote machine.  To configure the
+webserver to connect to an external FastCGI server, you would add the following
+to your srm.conf:
+
+    FastCgiExternalServer /usr/etc/httpd/fcgi-bin/file_upload.fcgi -host sputnik:8888
+
+Two environment variables affect how the C<CGI::Fast> object is created,
+allowing C<CGI::Fast> to be used as an external FastCGI server.  (See C<FCGI>
+documentation for C<FCGI::OpenSocket> for more information.)
+
+=over
+
+=item FCGI_SOCKET_PATH
+
+The address (TCP/IP) or path (UNIX Domain) of the socket the external FastCGI
+script to which bind an listen for incoming connections from the web server.
+
+=item FCGI_LISTEN_QUEUE
+
+Maximum length of the queue of pending connections.
+
+=back
+
+For example:
+
+    #!/usr/local/bin/perl    # must be a FastCGI version of perl!
+    use CGI::Fast;
+    &do_some_initialization();
+    $ENV{FCGI_SOCKET_PATH} = "sputnik:8888";
+    $ENV{FCGI_LISTEN_QUEUE} = 100;
+    while ($q = new CGI::Fast) {
+       &process_request($q);
+    }
+
+=head1 CAVEATS
+
+I haven't tested this very much.
+
+=head1 AUTHOR INFORMATION
+
+Copyright 1996-1998, Lincoln D. Stein.  All rights reserved.
+
+This library is free software; you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
+Address bug reports and comments to: lstein@cshl.org
+
+=head1 BUGS
+
+This section intentionally left blank.
+
+=head1 SEE ALSO
+
+L<CGI::Carp>, L<CGI>
+
+=cut

diff --git a/lib/CGI/Pretty.pm b/lib/CGI/Pretty.pm
new file mode 100644 (file)
index 0000000..869fe0c
--- /dev/null
+++ b/lib/CGI/Pretty.pm
@@ -0,0 +1,312 @@
+package CGI::Pretty;
+
+# See the bottom of this file for the POD documentation.  Search for the
+# string '=head'.
+
+# You can run this file through either pod2man or pod2html to produce pretty
+# documentation in manual or html file format (these utilities are part of the
+# Perl 5 distribution).
+
+use strict;
+use CGI ();
+
+$CGI::Pretty::VERSION = '3.46';
+$CGI::DefaultClass = __PACKAGE__;
+$CGI::Pretty::AutoloadClass = 'CGI';
+@CGI::Pretty::ISA = qw( CGI );
+
+initialize_globals();
+
+sub _prettyPrint {
+    my $input = shift;
+    return if !$$input;
+    return if !$CGI::Pretty::LINEBREAK || !$CGI::Pretty::INDENT;
+
+#    print STDERR "'", $$input, "'\n";
+
+    foreach my $i ( @CGI::Pretty::AS_IS ) {
+       if ( $$input =~ m{</$i>}si ) {
+           my ( $a, $b, $c ) = $$input =~ m{(.*)(<$i[\s/>].*?</$i>)(.*)}si;
+           next if !$b;
+           $a ||= "";
+           $c ||= "";
+
+           _prettyPrint( \$a ) if $a;
+           _prettyPrint( \$c ) if $c;
+           
+           $b ||= "";
+           $$input = "$a$b$c";
+           return;
+       }
+    }
+    $$input =~ s/$CGI::Pretty::LINEBREAK/$CGI::Pretty::LINEBREAK$CGI::Pretty::INDENT/g;
+}
+
+sub comment {
+    my($self,@p) = CGI::self_or_CGI(@_);
+
+    my $s = "@p";
+    $s =~ s/$CGI::Pretty::LINEBREAK/$CGI::Pretty::LINEBREAK$CGI::Pretty::INDENT/g if $CGI::Pretty::LINEBREAK; 
+    
+    return $self->SUPER::comment( "$CGI::Pretty::LINEBREAK$CGI::Pretty::INDENT$s$CGI::Pretty::LINEBREAK" ) . $CGI::Pretty::LINEBREAK;
+}
+
+sub _make_tag_func {
+    my ($self,$tagname) = @_;
+
+    # As Lincoln as noted, the last else clause is VERY hairy, and it
+    # took me a while to figure out what I was trying to do.
+    # What it does is look for tags that shouldn't be indented (e.g. PRE)
+    # and makes sure that when we nest tags, those tags don't get
+    # indented.
+    # For an example, try print td( pre( "hello\nworld" ) );
+    # If we didn't care about stuff like that, the code would be
+    # MUCH simpler.  BTW: I won't claim to be a regular expression
+    # guru, so if anybody wants to contribute something that would
+    # be quicker, easier to read, etc, I would be more than
+    # willing to put it in - Brian
+
+    my $func = qq"
+       sub $tagname {";
+
+    $func .= q'
+            shift if $_[0] && 
+                    (ref($_[0]) &&
+                     (substr(ref($_[0]),0,3) eq "CGI" ||
+                    UNIVERSAL::isa($_[0],"CGI")));
+           my($attr) = "";
+           if (ref($_[0]) && ref($_[0]) eq "HASH") {
+               my(@attr) = make_attributes(shift()||undef,1);
+               $attr = " @attr" if @attr;
+           }';
+
+    if ($tagname=~/start_(\w+)/i) {
+       $func .= qq! 
+            return "<\L$1\E\$attr>\$CGI::Pretty::LINEBREAK";} !;
+    } elsif ($tagname=~/end_(\w+)/i) {
+       $func .= qq! 
+            return "<\L/$1\E>\$CGI::Pretty::LINEBREAK"; } !;
+    } else {
+       $func .= qq#
+           return ( \$CGI::XHTML ? "<\L$tagname\E\$attr />" : "<\L$tagname\E\$attr>" ) .
+                   \$CGI::Pretty::LINEBREAK unless \@_;
+           my(\$tag,\$untag) = ("<\L$tagname\E\$attr>","</\L$tagname>\E");
+
+            my \%ASIS = map { lc("\$_") => 1 } \@CGI::Pretty::AS_IS;
+            my \@args;
+            if ( \$CGI::Pretty::LINEBREAK || \$CGI::Pretty::INDENT ) {
+             if(ref(\$_[0]) eq 'ARRAY') {
+                 \@args = \@{\$_[0]}
+              } else {
+                  foreach (\@_) {
+                     \$args[0] .= \$_;
+                      \$args[0] .= \$CGI::Pretty::LINEBREAK if \$args[0] !~ /\$CGI::Pretty::LINEBREAK\$/ && 0;
+                      chomp \$args[0] if exists \$ASIS{ "\L$tagname\E" };
+                      
+                     \$args[0] .= \$" if \$args[0] !~ /\$CGI::Pretty::LINEBREAK\$/ && 1;
+                 }
+                  chop \$args[0] unless \$" eq "";
+             }
+            }
+            else {
+              \@args = ref(\$_[0]) eq 'ARRAY' ? \@{\$_[0]} : "\@_";
+            }
+
+            my \@result;
+            if ( exists \$ASIS{ "\L$tagname\E" } ) {
+                \@result = map { "\$tag\$_\$untag" } \@args;
+            }
+           else {
+               \@result = map { 
+                   chomp; 
+                   my \$tmp = \$_;
+                   CGI::Pretty::_prettyPrint( \\\$tmp );
+                    \$tag . \$CGI::Pretty::LINEBREAK .
+                    \$CGI::Pretty::INDENT . \$tmp . \$CGI::Pretty::LINEBREAK . 
+                    \$untag . \$CGI::Pretty::LINEBREAK
+                } \@args;
+           }
+            if (\$CGI::Pretty::LINEBREAK || \$CGI::Pretty::INDENT) {
+                return join ("", \@result);
+            } else {
+                return "\@result";
+            }
+       }#;
+    }    
+
+    return $func;
+}
+
+sub start_html {
+    return CGI::start_html( @_ ) . $CGI::Pretty::LINEBREAK;
+}
+
+sub end_html {
+    return CGI::end_html( @_ ) . $CGI::Pretty::LINEBREAK;
+}
+
+sub new {
+    my $class = shift;
+    my $this = $class->SUPER::new( @_ );
+
+    if ($CGI::MOD_PERL) {
+        if ($CGI::MOD_PERL == 1) {
+            my $r = Apache->request;
+            $r->register_cleanup(\&CGI::Pretty::_reset_globals);
+        }
+        else {
+            my $r = Apache2::RequestUtil->request;
+            $r->pool->cleanup_register(\&CGI::Pretty::_reset_globals);
+        }
+    }
+    $class->_reset_globals if $CGI::PERLEX;
+
+    return bless $this, $class;
+}
+
+sub initialize_globals {
+    # This is the string used for indentation of tags
+    $CGI::Pretty::INDENT = "\t";
+    
+    # This is the string used for seperation between tags
+    $CGI::Pretty::LINEBREAK = $/;
+
+    # These tags are not prettify'd.
+    # When this list is updated, also update the docs.
+    @CGI::Pretty::AS_IS = qw( a pre code script textarea td );
+
+    1;
+}
+sub _reset_globals { initialize_globals(); }
+
+# ugly, but quick fix
+sub import {
+    my $self = shift;
+    no strict 'refs';
+    ${ "$self\::AutoloadClass" } = 'CGI';
+
+    # This causes modules to clash.
+    undef %CGI::EXPORT;
+    undef %CGI::EXPORT;
+
+    $self->_setup_symbols(@_);
+    my ($callpack, $callfile, $callline) = caller;
+
+    # To allow overriding, search through the packages
+    # Till we find one in which the correct subroutine is defined.
+    my @packages = ($self,@{"$self\:\:ISA"});
+    foreach my $sym (keys %CGI::EXPORT) {
+       my $pck;
+       my $def = ${"$self\:\:AutoloadClass"} || $CGI::DefaultClass;
+       foreach $pck (@packages) {
+           if (defined(&{"$pck\:\:$sym"})) {
+               $def = $pck;
+               last;
+           }
+       }
+       *{"${callpack}::$sym"} = \&{"$def\:\:$sym"};
+    }
+}
+
+1;
+
+=head1 NAME
+
+CGI::Pretty - module to produce nicely formatted HTML code
+
+=head1 SYNOPSIS
+
+    use CGI::Pretty qw( :html3 );
+
+    # Print a table with a single data element
+    print table( TR( td( "foo" ) ) );
+
+=head1 DESCRIPTION
+
+CGI::Pretty is a module that derives from CGI.  It's sole function is to
+allow users of CGI to output nicely formatted HTML code.
+
+When using the CGI module, the following code:
+    print table( TR( td( "foo" ) ) );
+
+produces the following output:
+    <TABLE><TR><TD>foo</TD></TR></TABLE>
+
+If a user were to create a table consisting of many rows and many columns,
+the resultant HTML code would be quite difficult to read since it has no
+carriage returns or indentation.
+
+CGI::Pretty fixes this problem.  What it does is add a carriage
+return and indentation to the HTML code so that one can easily read
+it.
+
+    print table( TR( td( "foo" ) ) );
+
+now produces the following output:
+    <TABLE>
+       <TR>
+          <TD>foo</TD>
+       </TR>
+    </TABLE>
+
+=head2 Recommendation for when to use CGI::Pretty
+
+CGI::Pretty is far slower than using CGI.pm directly. A benchmark showed that
+it could be about 10 times slower. Adding newlines and spaces may alter the
+rendered appearance of HTML. Also, the extra newlines and spaces also make the
+file size larger, making the files take longer to download.
+
+With all those considerations, it is recommended that CGI::Pretty be used
+primarily for debugging.
+
+=head2 Tags that won't be formatted
+
+The following tags are not formatted: <a>, <pre>, <code>, <script>, <textarea>, and <td>.
+If these tags were formatted, the
+user would see the extra indentation on the web browser causing the page to
+look different than what would be expected.  If you wish to add more tags to
+the list of tags that are not to be touched, push them onto the C<@AS_IS> array:
+
+    push @CGI::Pretty::AS_IS,qw(XMP);
+
+=head2 Customizing the Indenting
+
+If you wish to have your own personal style of indenting, you can change the
+C<$INDENT> variable:
+
+    $CGI::Pretty::INDENT = "\t\t";
+
+would cause the indents to be two tabs.
+
+Similarly, if you wish to have more space between lines, you may change the
+C<$LINEBREAK> variable:
+
+    $CGI::Pretty::LINEBREAK = "\n\n";
+
+would create two carriage returns between lines.
+
+If you decide you want to use the regular CGI indenting, you can easily do 
+the following:
+
+    $CGI::Pretty::INDENT = $CGI::Pretty::LINEBREAK = "";
+
+=head1 AUTHOR
+
+Brian Paulsen <Brian@ThePaulsens.com>, with minor modifications by
+Lincoln Stein <lstein@cshl.org> for incorporation into the CGI.pm
+distribution.
+
+Copyright 1999, Brian Paulsen.  All rights reserved.
+
+This library is free software; you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
+Bug reports and comments to Brian@ThePaulsens.com.  You can also write
+to lstein@cshl.org, but this code looks pretty hairy to me and I'm not
+sure I understand it!
+
+=head1 SEE ALSO
+
+L<CGI>
+
+=cut

diff --git a/lib/CGI/Push.pm b/lib/CGI/Push.pm
new file mode 100644 (file)
index 0000000..2af7d79
--- /dev/null
+++ b/lib/CGI/Push.pm
@@ -0,0 +1,325 @@
+package CGI::Push;
+
+# See the bottom of this file for the POD documentation.  Search for the
+# string '=head'.
+
+# You can run this file through either pod2man or pod2html to produce pretty
+# documentation in manual or html file format (these utilities are part of the
+# Perl 5 distribution).
+
+# Copyright 1995-2000, Lincoln D. Stein.  All rights reserved.
+# It may be used and modified freely, but I do request that this copyright
+# notice remain attached to the file.  You may modify this module as you 
+# wish, but if you redistribute a modified version, please attach a note
+# listing the modifications you have made.
+
+# The most recent version and complete docs are available at:
+#   http://stein.cshl.org/WWW/software/CGI/
+
+$CGI::Push::VERSION='1.05';
+use CGI;
+use CGI::Util 'rearrange';
+@ISA = ('CGI');
+
+$CGI::DefaultClass = 'CGI::Push';
+$CGI::Push::AutoloadClass = 'CGI';
+
+# add do_push() and push_delay() to exported tags
+push(@{$CGI::EXPORT_TAGS{':standard'}},'do_push','push_delay');
+
+sub do_push {
+    my ($self,@p) = CGI::self_or_default(@_);
+
+    # unbuffer output
+    $| = 1;
+    srand;
+    my ($random) = sprintf("%08.0f",rand()*1E8);
+    my ($boundary) = "----=_NeXtPaRt$random";
+
+    my (@header);
+    my ($type,$callback,$delay,$last_page,$cookie,$target,$expires,$nph,@other) = rearrange([TYPE,NEXT_PAGE,DELAY,LAST_PAGE,[COOKIE,COOKIES],TARGET,EXPIRES,NPH],@p);
+    $type = 'text/html' unless $type;
+    $callback = \&simple_counter unless $callback && ref($callback) eq 'CODE';
+    $delay = 1 unless defined($delay);
+    $self->push_delay($delay);
+    $nph = 1 unless defined($nph);
+
+    my(@o);
+    foreach (@other) { push(@o,split("=")); }
+    push(@o,'-Target'=>$target) if defined($target);
+    push(@o,'-Cookie'=>$cookie) if defined($cookie);
+    push(@o,'-Type'=>"multipart/x-mixed-replace;boundary=\"$boundary\"");
+    push(@o,'-Server'=>"CGI.pm Push Module") if $nph;
+    push(@o,'-Status'=>'200 OK');
+    push(@o,'-nph'=>1) if $nph;
+    print $self->header(@o);
+
+    $boundary = "$CGI::CRLF--$boundary";
+
+    print "WARNING: YOUR BROWSER DOESN'T SUPPORT THIS SERVER-PUSH TECHNOLOGY.${boundary}$CGI::CRLF";
+
+    my (@contents) = &$callback($self,++$COUNTER);
+
+    # now we enter a little loop
+    while (1) {
+        print "Content-type: ${type}$CGI::CRLF$CGI::CRLF" unless $type =~ /^dynamic|heterogeneous$/i;
+        print @contents;
+        @contents = &$callback($self,++$COUNTER);
+        if ((@contents) && defined($contents[0])) {
+            print "${boundary}$CGI::CRLF";
+            do_sleep($self->push_delay()) if $self->push_delay();
+        } else {
+            if ($last_page && ref($last_page) eq 'CODE') {
+                print "${boundary}$CGI::CRLF";
+                do_sleep($self->push_delay()) if $self->push_delay();
+                print "Content-type: ${type}$CGI::CRLF$CGI::CRLF" unless $type =~ /^dynamic|heterogeneous$/i;
+                print  &$last_page($self,$COUNTER);
+            }
+            print "${boundary}--$CGI::CRLF";
+            last;
+        }
+    }
+    print "WARNING: YOUR BROWSER DOESN'T SUPPORT THIS SERVER-PUSH TECHNOLOGY.$CGI::CRLF";
+}
+
+sub simple_counter {
+    my ($self,$count) = @_;
+    return $self->start_html("CGI::Push Default Counter"),
+           $self->h1("CGI::Push Default Counter"),
+           "This page has been updated ",$self->strong($count)," times.",
+           $self->hr(),
+           $self->a({'-href'=>'http://www.genome.wi.mit.edu/ftp/pub/software/WWW/cgi_docs.html'},'CGI.pm home page'),
+           $self->end_html;
+}
+
+sub do_sleep {
+    my $delay = shift;
+    if ( ($delay >= 1) && ($delay!~/\./) ){
+        sleep($delay);
+    } else {
+        select(undef,undef,undef,$delay);
+    }
+}
+
+sub push_delay {
+    my ($self,$delay) = CGI::self_or_default(@_);
+    return defined($delay) ? $self->{'.delay'} = 
+        $delay : $self->{'.delay'};
+}
+
+1;
+
+=head1 NAME
+
+CGI::Push - Simple Interface to Server Push
+
+=head1 SYNOPSIS
+
+    use CGI::Push qw(:standard);
+
+    do_push(-next_page=>\&next_page,
+            -last_page=>\&last_page,
+            -delay=>0.5);
+
+    sub next_page {
+        my($q,$counter) = @_;
+        return undef if $counter >= 10;
+        return start_html('Test'),
+               h1('Visible'),"\n",
+               "This page has been called ", strong($counter)," times",
+               end_html();
+    }
+
+    sub last_page {
+        my($q,$counter) = @_;
+        return start_html('Done'),
+               h1('Finished'),
+               strong($counter - 1),' iterations.',
+               end_html;
+    }
+
+=head1 DESCRIPTION
+
+CGI::Push is a subclass of the CGI object created by CGI.pm.  It is
+specialized for server push operations, which allow you to create
+animated pages whose content changes at regular intervals.
+
+You provide CGI::Push with a pointer to a subroutine that will draw
+one page.  Every time your subroutine is called, it generates a new
+page.  The contents of the page will be transmitted to the browser
+in such a way that it will replace what was there beforehand.  The
+technique will work with HTML pages as well as with graphics files, 
+allowing you to create animated GIFs.
+
+Only Netscape Navigator supports server push.  Internet Explorer
+browsers do not.
+
+=head1 USING CGI::Push
+
+CGI::Push adds one new method to the standard CGI suite, do_push().
+When you call this method, you pass it a reference to a subroutine
+that is responsible for drawing each new page, an interval delay, and
+an optional subroutine for drawing the last page.  Other optional
+parameters include most of those recognized by the CGI header()
+method.
+
+You may call do_push() in the object oriented manner or not, as you
+prefer:
+
+    use CGI::Push;
+    $q = new CGI::Push;
+    $q->do_push(-next_page=>\&draw_a_page);
+
+        -or-
+
+    use CGI::Push qw(:standard);
+    do_push(-next_page=>\&draw_a_page);
+
+Parameters are as follows:
+
+=over 4
+
+=item -next_page
+
+    do_push(-next_page=>\&my_draw_routine);
+
+This required parameter points to a reference to a subroutine responsible for
+drawing each new page.  The subroutine should expect two parameters
+consisting of the CGI object and a counter indicating the number
+of times the subroutine has been called.  It should return the
+contents of the page as an B<array> of one or more items to print.  
+It can return a false value (or an empty array) in order to abort the
+redrawing loop and print out the final page (if any)
+
+    sub my_draw_routine {
+        my($q,$counter) = @_;
+        return undef if $counter > 100;
+        return start_html('testing'),
+               h1('testing'),
+               "This page called $counter times";
+    }
+
+You are of course free to refer to create and use global variables
+within your draw routine in order to achieve special effects.
+
+=item -last_page
+
+This optional parameter points to a reference to the subroutine
+responsible for drawing the last page of the series.  It is called
+after the -next_page routine returns a false value.  The subroutine
+itself should have exactly the same calling conventions as the
+-next_page routine.
+
+=item -type
+
+This optional parameter indicates the content type of each page.  It
+defaults to "text/html".  Normally the module assumes that each page
+is of a homogeneous MIME type.  However if you provide either of the
+magic values "heterogeneous" or "dynamic" (the latter provided for the
+convenience of those who hate long parameter names), you can specify
+the MIME type -- and other header fields -- on a per-page basis.  See 
+"heterogeneous pages" for more details.
+
+=item -delay
+
+This indicates the delay, in seconds, between frames.  Smaller delays
+refresh the page faster.  Fractional values are allowed.
+
+B<If not specified, -delay will default to 1 second>
+
+=item -cookie, -target, -expires, -nph
+
+These have the same meaning as the like-named parameters in
+CGI::header().
+
+If not specified, -nph will default to 1 (as needed for many servers, see below).
+
+=back
+
+=head2 Heterogeneous Pages
+
+Ordinarily all pages displayed by CGI::Push share a common MIME type.
+However by providing a value of "heterogeneous" or "dynamic" in the
+do_push() -type parameter, you can specify the MIME type of each page
+on a case-by-case basis.  
+
+If you use this option, you will be responsible for producing the
+HTTP header for each page.  Simply modify your draw routine to
+look like this:
+
+    sub my_draw_routine {
+        my($q,$counter) = @_;
+        return header('text/html'),   # note we're producing the header here
+               start_html('testing'),
+               h1('testing'),
+               "This page called $counter times";
+    }
+
+You can add any header fields that you like, but some (cookies and
+status fields included) may not be interpreted by the browser.  One
+interesting effect is to display a series of pages, then, after the
+last page, to redirect the browser to a new URL.  Because redirect() 
+does b<not> work, the easiest way is with a -refresh header field,
+as shown below:
+
+    sub my_draw_routine {
+        my($q,$counter) = @_;
+        return undef if $counter > 10;
+        return header('text/html'),   # note we're producing the header here
+               start_html('testing'),
+               h1('testing'),
+               "This page called $counter times";
+    }
+
+    sub my_last_page {
+        return header(-refresh=>'5; URL=http://somewhere.else/finished.html',
+                      -type=>'text/html'),
+               start_html('Moved'),
+               h1('This is the last page'),
+               'Goodbye!'
+               hr,
+               end_html; 
+    }
+
+=head2 Changing the Page Delay on the Fly
+
+If you would like to control the delay between pages on a page-by-page
+basis, call push_delay() from within your draw routine.  push_delay()
+takes a single numeric argument representing the number of seconds you
+wish to delay after the current page is displayed and before
+displaying the next one.  The delay may be fractional.  Without
+parameters, push_delay() just returns the current delay.
+
+=head1 INSTALLING CGI::Push SCRIPTS
+
+Server push scripts must be installed as no-parsed-header (NPH)
+scripts in order to work correctly on many servers.  On Unix systems,
+this is most often accomplished by prefixing the script's name with "nph-".  
+Recognition of NPH scripts happens automatically with WebSTAR and 
+Microsoft IIS.  Users of other servers should see their documentation
+for help.
+
+Apache web server from version 1.3b2 on does not need server
+push scripts installed as NPH scripts: the -nph parameter to do_push()
+may be set to a false value to disable the extra headers needed by an
+NPH script.
+
+=head1 AUTHOR INFORMATION
+
+Copyright 1995-1998, Lincoln D. Stein.  All rights reserved.  
+
+This library is free software; you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
+Address bug reports and comments to: lstein@cshl.org
+
+=head1 BUGS
+
+This section intentionally left blank.
+
+=head1 SEE ALSO
+
+L<CGI::Carp>, L<CGI>
+
+=cut
+

diff --git a/lib/CGI/Switch.pm b/lib/CGI/Switch.pm
new file mode 100644 (file)
index 0000000..a311080
--- /dev/null
+++ b/lib/CGI/Switch.pm
@@ -0,0 +1,28 @@
+package CGI::Switch;
+use CGI;
+
+$VERSION = '1.01';
+
+1;
+
+__END__
+
+=head1 NAME
+
+CGI::Switch - Backward compatibility module for defunct CGI::Switch
+
+=head1 SYNOPSIS
+
+Do not use this module.  It is deprecated.
+
+=head1 ABSTRACT
+
+=head1 DESCRIPTION
+
+=head1 AUTHOR INFORMATION
+
+=head1 BUGS
+
+=head1 SEE ALSO
+
+=cut

diff --git a/lib/CGI/Util.pm b/lib/CGI/Util.pm
new file mode 100644 (file)
index 0000000..494560e
--- /dev/null
+++ b/lib/CGI/Util.pm
@@ -0,0 +1,339 @@
+package CGI::Util;
+use base 'Exporter';
+require 5.008001;
+use strict;
+our @EXPORT_OK = qw(rearrange rearrange_header make_attributes unescape escape
+        expires ebcdic2ascii ascii2ebcdic);
+
+our $VERSION = '3.62';
+
+use constant EBCDIC => "\t" ne "\011";
+
+# This option is not documented and may change or go away.
+# The HTML spec does not require attributes to be sorted,
+# but it's useful for testing to get a predictable order back.
+our $SORT_ATTRIBUTES;
+
+# (ord('^') == 95) for codepage 1047 as on os390, vmesa
+our @A2E = (
+   0,  1,  2,  3, 55, 45, 46, 47, 22,  5, 21, 11, 12, 13, 14, 15,
+  16, 17, 18, 19, 60, 61, 50, 38, 24, 25, 63, 39, 28, 29, 30, 31,
+  64, 90,127,123, 91,108, 80,125, 77, 93, 92, 78,107, 96, 75, 97,
+ 240,241,242,243,244,245,246,247,248,249,122, 94, 76,126,110,111,
+ 124,193,194,195,196,197,198,199,200,201,209,210,211,212,213,214,
+ 215,216,217,226,227,228,229,230,231,232,233,173,224,189, 95,109,
+ 121,129,130,131,132,133,134,135,136,137,145,146,147,148,149,150,
+ 151,152,153,162,163,164,165,166,167,168,169,192, 79,208,161,  7,
+  32, 33, 34, 35, 36, 37,  6, 23, 40, 41, 42, 43, 44,  9, 10, 27,
+  48, 49, 26, 51, 52, 53, 54,  8, 56, 57, 58, 59,  4, 20, 62,255,
+  65,170, 74,177,159,178,106,181,187,180,154,138,176,202,175,188,
+ 144,143,234,250,190,160,182,179,157,218,155,139,183,184,185,171,
+ 100,101, 98,102, 99,103,158,104,116,113,114,115,120,117,118,119,
+ 172,105,237,238,235,239,236,191,128,253,254,251,252,186,174, 89,
+  68, 69, 66, 70, 67, 71,156, 72, 84, 81, 82, 83, 88, 85, 86, 87,
+ 140, 73,205,206,203,207,204,225,112,221,222,219,220,141,142,223
+     );
+our @E2A = (
+   0,  1,  2,  3,156,  9,134,127,151,141,142, 11, 12, 13, 14, 15,
+  16, 17, 18, 19,157, 10,  8,135, 24, 25,146,143, 28, 29, 30, 31,
+ 128,129,130,131,132,133, 23, 27,136,137,138,139,140,  5,  6,  7,
+ 144,145, 22,147,148,149,150,  4,152,153,154,155, 20, 21,158, 26,
+  32,160,226,228,224,225,227,229,231,241,162, 46, 60, 40, 43,124,
+  38,233,234,235,232,237,238,239,236,223, 33, 36, 42, 41, 59, 94,
+  45, 47,194,196,192,193,195,197,199,209,166, 44, 37, 95, 62, 63,
+ 248,201,202,203,200,205,206,207,204, 96, 58, 35, 64, 39, 61, 34,
+ 216, 97, 98, 99,100,101,102,103,104,105,171,187,240,253,254,177,
+ 176,106,107,108,109,110,111,112,113,114,170,186,230,184,198,164,
+ 181,126,115,116,117,118,119,120,121,122,161,191,208, 91,222,174,
+ 172,163,165,183,169,167,182,188,189,190,221,168,175, 93,180,215,
+ 123, 65, 66, 67, 68, 69, 70, 71, 72, 73,173,244,246,242,243,245,
+ 125, 74, 75, 76, 77, 78, 79, 80, 81, 82,185,251,252,249,250,255,
+  92,247, 83, 84, 85, 86, 87, 88, 89, 90,178,212,214,210,211,213,
+  48, 49, 50, 51, 52, 53, 54, 55, 56, 57,179,219,220,217,218,159
+     );
+
+if (EBCDIC && ord('^') == 106) { # as in the BS2000 posix-bc coded character set
+     $A2E[91] = 187;   $A2E[92] = 188;  $A2E[94] = 106;  $A2E[96] = 74;
+     $A2E[123] = 251;  $A2E[125] = 253; $A2E[126] = 255; $A2E[159] = 95;
+     $A2E[162] = 176;  $A2E[166] = 208; $A2E[168] = 121; $A2E[172] = 186;
+     $A2E[175] = 161;  $A2E[217] = 224; $A2E[219] = 221; $A2E[221] = 173;
+     $A2E[249] = 192;
+
+     $E2A[74] = 96;   $E2A[95] = 159;  $E2A[106] = 94;  $E2A[121] = 168;
+     $E2A[161] = 175; $E2A[173] = 221; $E2A[176] = 162; $E2A[186] = 172;
+     $E2A[187] = 91;  $E2A[188] = 92;  $E2A[192] = 249; $E2A[208] = 166;
+     $E2A[221] = 219; $E2A[224] = 217; $E2A[251] = 123; $E2A[253] = 125;
+     $E2A[255] = 126;
+   }
+elsif (EBCDIC && ord('^') == 176) { # as in codepage 037 on os400
+  $A2E[10] = 37;  $A2E[91] = 186;  $A2E[93] = 187; $A2E[94] = 176;
+  $A2E[133] = 21; $A2E[168] = 189; $A2E[172] = 95; $A2E[221] = 173;
+
+  $E2A[21] = 133; $E2A[37] = 10;  $E2A[95] = 172; $E2A[173] = 221;
+  $E2A[176] = 94; $E2A[186] = 91; $E2A[187] = 93; $E2A[189] = 168;
+}
+
+# Smart rearrangement of parameters to allow named parameter
+# calling.  We do the rearrangement if:
+# the first parameter begins with a -
+
+sub rearrange {
+    my ($order,@param) = @_;
+    my ($result, $leftover) = _rearrange_params( $order, @param );
+    push @$result, make_attributes( $leftover, defined $CGI::Q ? $CGI::Q->{escape} : 1 ) 
+    if keys %$leftover;
+    @$result;
+}
+
+sub rearrange_header {
+    my ($order,@param) = @_;
+
+    my ($result,$leftover) = _rearrange_params( $order, @param );
+    push @$result, make_attributes( $leftover, 0, 1 ) if keys %$leftover;
+
+    @$result;
+}
+
+sub _rearrange_params {
+    my($order,@param) = @_;
+    return [] unless @param;
+
+    if (ref($param[0]) eq 'HASH') {
+    @param = %{$param[0]};
+    } else {
+    return \@param 
+        unless (defined($param[0]) && substr($param[0],0,1) eq '-');
+    }
+
+    # map parameters into positional indices
+    my ($i,%pos);
+    $i = 0;
+    foreach (@$order) {
+    foreach (ref($_) eq 'ARRAY' ? @$_ : $_) { $pos{lc($_)} = $i; }
+    $i++;
+    }
+
+    my (@result,%leftover);
+    $#result = $#$order;  # preextend
+    while (@param) {
+    my $key = lc(shift(@param));
+    $key =~ s/^\-//;
+    if (exists $pos{$key}) {
+        $result[$pos{$key}] = shift(@param);
+    } else {
+        $leftover{$key} = shift(@param);
+    }
+    }
+
+    return \@result, \%leftover;
+}
+
+sub make_attributes {
+    my $attr = shift;
+    return () unless $attr && ref($attr) && ref($attr) eq 'HASH';
+    my $escape =  shift || 0;
+    my $do_not_quote = shift;
+
+    my $quote = $do_not_quote ? '' : '"';
+
+    my @attr_keys= keys %$attr;
+    if ($SORT_ATTRIBUTES) {
+        @attr_keys= sort @attr_keys;
+    }
+    my(@att);
+    foreach (@attr_keys) {
+    my($key) = $_;
+    $key=~s/^\-//;     # get rid of initial - if present
+
+    # old way: breaks EBCDIC!
+    # $key=~tr/A-Z_/a-z-/; # parameters are lower case, use dashes
+
+    ($key="\L$key") =~ tr/_/-/; # parameters are lower case, use dashes
+
+    my $value = $escape ? simple_escape($attr->{$_}) : $attr->{$_};
+    push(@att,defined($attr->{$_}) ? qq/$key=$quote$value$quote/ : qq/$key/);
+    }
+    return @att;
+}
+
+sub simple_escape {
+  return unless defined(my $toencode = shift);
+  $toencode =~ s{&}{&}gso;
+  $toencode =~ s{<}{&lt;}gso;
+  $toencode =~ s{>}{&gt;}gso;
+  $toencode =~ s{\"}{&quot;}gso;
+# Doesn't work.  Can't work.  forget it.
+#  $toencode =~ s{\x8b}{&#139;}gso;
+#  $toencode =~ s{\x9b}{&#155;}gso;
+  $toencode;
+}
+
+sub utf8_chr {
+    my $c = shift(@_);
+    my $u = chr($c);
+    utf8::encode($u); # drop utf8 flag
+    return $u;
+}
+
+# unescape URL-encoded data
+sub unescape {
+  shift() if @_ > 0 and (ref($_[0]) || (defined $_[1] && $_[0] eq $CGI::DefaultClass));
+  my $todecode = shift;
+  return undef unless defined($todecode);
+  $todecode =~ tr/+/ /;       # pluses become spaces
+    if (EBCDIC) {
+      $todecode =~ s/%([0-9a-fA-F]{2})/chr $A2E[hex($1)]/ge;
+    } else {
+    # handle surrogate pairs first -- dankogai. Ref: http://unicode.org/faq/utf_bom.html#utf16-2
+    $todecode =~ s{
+            %u([Dd][89a-bA-B][0-9a-fA-F]{2}) # hi
+                %u([Dd][c-fC-F][0-9a-fA-F]{2})   # lo
+              }{
+              utf8_chr(
+                   0x10000 
+                   + (hex($1) - 0xD800) * 0x400 
+                   + (hex($2) - 0xDC00)
+                  )
+              }gex;
+      $todecode =~ s/%(?:([0-9a-fA-F]{2})|u([0-9a-fA-F]{4}))/
+    defined($1)? chr hex($1) : utf8_chr(hex($2))/ge;
+    }
+  return $todecode;
+}
+
+# URL-encode data
+#
+# We cannot use the %u escapes, they were rejected by W3C, so the official
+# way is %XX-escaped utf-8 encoding.
+# Naturally, Unicode strings have to be converted to their utf-8 byte
+# representation. 
+# Byte strings were traditionally used directly as a sequence of octets.
+# This worked if they actually represented binary data (i.e. in CGI::Compress).
+# This also worked if these byte strings were actually utf-8 encoded; e.g.,
+# when the source file used utf-8 without the apropriate "use utf8;".
+# This fails if the byte string is actually a Latin 1 encoded string, but it
+# was always so and cannot be fixed without breaking the binary data case.
+# -- Stepan Kasal <skasal@redhat.com>
+#
+
+sub escape {
+  # If we being called in an OO-context, discard the first argument.
+  shift() if @_ > 1 and ( ref($_[0]) || (defined $_[1] && $_[0] eq $CGI::DefaultClass));
+  my $toencode = shift;
+  return undef unless defined($toencode);
+  utf8::encode($toencode) if utf8::is_utf8($toencode);
+    if (EBCDIC) {
+      $toencode=~s/([^a-zA-Z0-9_.~-])/uc sprintf("%%%02x",$E2A[ord($1)])/eg;
+    } else {
+      $toencode=~s/([^a-zA-Z0-9_.~-])/uc sprintf("%%%02x",ord($1))/eg;
+    }
+  return $toencode;
+}
+
+# This internal routine creates date strings suitable for use in
+# cookies and HTTP headers.  (They differ, unfortunately.)
+# Thanks to Mark Fisher for this.
+sub expires {
+    my($time,$format) = @_;
+    $format ||= 'http';
+
+    my(@MON)=qw/Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec/;
+    my(@WDAY) = qw/Sun Mon Tue Wed Thu Fri Sat/;
+
+    # pass through preformatted dates for the sake of expire_calc()
+    $time = expire_calc($time);
+    return $time unless $time =~ /^\d+$/;
+
+    # make HTTP/cookie date string from GMT'ed time
+    # (cookies use '-' as date separator, HTTP uses ' ')
+    my($sc) = ' ';
+    $sc = '-' if $format eq "cookie";
+    my($sec,$min,$hour,$mday,$mon,$year,$wday) = gmtime($time);
+    $year += 1900;
+    return sprintf("%s, %02d$sc%s$sc%04d %02d:%02d:%02d GMT",
+                   $WDAY[$wday],$mday,$MON[$mon],$year,$hour,$min,$sec);
+}
+
+# This internal routine creates an expires time exactly some number of
+# hours from the current time.  It incorporates modifications from 
+# Mark Fisher.
+sub expire_calc {
+    my($time) = @_;
+    my(%mult) = ('s'=>1,
+                 'm'=>60,
+                 'h'=>60*60,
+                 'd'=>60*60*24,
+                 'M'=>60*60*24*30,
+                 'y'=>60*60*24*365);
+    # format for time can be in any of the forms...
+    # "now" -- expire immediately
+    # "+180s" -- in 180 seconds
+    # "+2m" -- in 2 minutes
+    # "+12h" -- in 12 hours
+    # "+1d"  -- in 1 day
+    # "+3M"  -- in 3 months
+    # "+2y"  -- in 2 years
+    # "-3m"  -- 3 minutes ago(!)
+    # If you don't supply one of these forms, we assume you are
+    # specifying the date yourself
+    my($offset);
+    if (!$time || (lc($time) eq 'now')) {
+      $offset = 0;
+    } elsif ($time=~/^\d+/) {
+      return $time;
+    } elsif ($time=~/^([+-]?(?:\d+|\d*\.\d*))([smhdMy])/) {
+      $offset = ($mult{$2} || 1)*$1;
+    } else {
+      return $time;
+    }
+    my $cur_time = time; 
+    return ($cur_time+$offset);
+}
+
+sub ebcdic2ascii {
+  my $data = shift;
+  $data =~ s/(.)/chr $E2A[ord($1)]/ge;
+  $data;
+}
+
+sub ascii2ebcdic {
+  my $data = shift;
+  $data =~ s/(.)/chr $A2E[ord($1)]/ge;
+  $data;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+CGI::Util - Internal utilities used by CGI module
+
+=head1 SYNOPSIS
+
+none
+
+=head1 DESCRIPTION
+
+no public subroutines
+
+=head1 AUTHOR INFORMATION
+
+Copyright 1995-1998, Lincoln D. Stein.  All rights reserved.
+
+This library is free software; you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
+Address bug reports and comments to: lstein@cshl.org.  When sending
+bug reports, please provide the version of CGI.pm, the version of
+Perl, the name and version of your Web server, and the name and
+version of the operating system you are using.  If the problem is even
+remotely browser dependent, please provide information about the
+affected browsers as well.
+
+=head1 SEE ALSO
+
+L<CGI>
+
+=cut

diff --git a/lib/README b/lib/README
new file mode 100644 (file)
index 0000000..5778a9a
--- /dev/null
+++ b/lib/README
@@ -0,0 +1,4 @@
+This directory contains the Perl modules that Bugzilla requires to run.
+
+If you would rather have Bugzilla use the Perl modules installed on your
+system, you can delete everything in this directory.

diff --git a/migrate.pl b/migrate.pl
new file mode 100755 (executable)
index 0000000..de4265b
--- /dev/null
+++ b/migrate.pl
@@ -0,0 +1,96 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use File::Basename;
+BEGIN { chdir dirname($0); }
+use lib qw(. lib);
+use Bugzilla;
+use Bugzilla::Migrate;
+
+use Getopt::Long;
+use Pod::Usage;
+
+my %switch;
+GetOptions(\%switch, 'help|h|?', 'from=s', 'verbose|v+', 'dry-run');
+
+# Print the help message if that switch was selected or if --from
+# wasn't specified.
+if (!$switch{'from'} or $switch{'help'}) {
+    pod2usage({-exitval => 1});
+}
+
+my $migrator = Bugzilla::Migrate->load($switch{'from'});
+$migrator->verbose($switch{'verbose'});
+$migrator->dry_run($switch{'dry-run'});
+$migrator->check_requirements();
+$migrator->do_migration();
+
+# Even if there's an error, we want to be sure that the serial values
+# get reset properly.
+END {
+    if ($migrator and $migrator->dry_run) {
+        my $dbh = Bugzilla->dbh;
+        if ($dbh->bz_in_transaction) {
+            $dbh->bz_rollback_transaction();
+        }
+        $migrator->reset_serial_values();
+    }
+}
+
+__END__
+
+=head1 NAME
+
+migrate.pl - A script to migrate from other bug-trackers to Bugzilla.
+
+=head1 SYNOPSIS
+
+ ./migrate.pl --from=<tracker> [--verbose] [--dry-run]
+
+ Migrates from another bug-tracker to Bugzilla. If you want
+ to upgrade Bugzilla, use checksetup.pl instead.
+
+ Always test this on a backup copy of your database before
+ running it on your live Bugzilla.
+
+=head1 OPTIONS
+
+=over
+
+=item B<--from=tracker>
+
+Specifies what bug-tracker you're migrating from. To see what values
+are valid, see the contents of the F<Bugzilla/Migrate/> directory.
+
+=item B<--dry-run>
+
+Don't modify the Bugzilla database at all, just test the import.
+Note that this could cause significant slowdown and other strange effects
+on a live Bugzilla, so only use it on a test instance.
+
+=item B<--verbose>
+
+If specified, this script will output extra debugging information
+to STDERR. Specify multiple times (up to three) for more information.
+
+=back
+
+=head1 DESCRIPTION
+
+This script copies data from another bug-tracker into Bugzilla. It migrates
+users, products, and bugs from the other bug-tracker into this Bugzilla,
+without removing any of the data currently in this Bugzilla.
+
+Note that you will need enough space in your temporary directory to hold
+the size of all attachments in your current bug-tracker.
+
+You may also need to increase the number of file handles a process is allowed
+to hold open (as the migrator will create a file handle for each attachment
+in your database). On Linux and simliar systems, you can do this as root
+by typing C<ulimit -n 65535> before running your script.

diff --git a/mod_perl.pl b/mod_perl.pl
new file mode 100644 (file)
index 0000000..ae15ae5
--- /dev/null
+++ b/mod_perl.pl
@@ -0,0 +1,151 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Bugzilla::ModPerl;
+use strict;
+use warnings;
+
+# This sets up our libpath without having to specify it in the mod_perl
+# configuration.
+use File::Basename;
+use lib dirname(__FILE__);
+use Bugzilla::Constants ();
+use lib Bugzilla::Constants::bz_locations()->{'ext_libpath'};
+
+# If you have an Apache2::Status handler in your Apache configuration,
+# you need to load Apache2::Status *here*, so that any later-loaded modules
+# can report information to Apache2::Status.
+#use Apache2::Status ();
+
+# We don't want to import anything into the global scope during
+# startup, so we always specify () after using any module in this
+# file.
+
+use Apache2::Log ();
+use Apache2::ServerUtil;
+use ModPerl::RegistryLoader ();
+use File::Basename ();
+use DateTime ();
+
+# This loads most of our modules.
+use Bugzilla ();
+# Loading Bugzilla.pm doesn't load this, though, and we want it preloaded.
+use Bugzilla::BugMail ();
+use Bugzilla::CGI ();
+use Bugzilla::Extension ();
+use Bugzilla::Install::Requirements ();
+use Bugzilla::Util ();
+use Bugzilla::RNG ();
+
+# Make warnings go to the virtual host's log and not the main
+# server log.
+BEGIN { *CORE::GLOBAL::warn = \&Apache2::ServerRec::warn; }
+
+# Pre-compile the CGI.pm methods that we're going to use.
+Bugzilla::CGI->compile(qw(:cgi :push));
+
+use Apache2::SizeLimit;
+# This means that every httpd child will die after processing
+# a CGI if it is taking up more than 45MB of RAM all by itself,
+# not counting RAM it is sharing with the other httpd processes.
+Apache2::SizeLimit->set_max_unshared_size(45_000);
+
+my $cgi_path = Bugzilla::Constants::bz_locations()->{'cgi_path'};
+
+# Set up the configuration for the web server
+my $server = Apache2::ServerUtil->server;
+my $conf = <<EOT;
+# Make sure each httpd child receives a different random seed (bug 476622).
+# Bugzilla::RNG has one srand that needs to be called for
+# every process, and Perl has another. (Various Perl modules still use
+# the built-in rand(), even though we never use it in Bugzilla itself,
+# so we need to srand() both of them.)
+PerlChildInitHandler "sub { Bugzilla::RNG::srand(); srand(); }"
+<Directory "$cgi_path">
+    AddHandler perl-script .cgi
+    # No need to PerlModule these because they're already defined in mod_perl.pl
+    PerlResponseHandler Bugzilla::ModPerl::ResponseHandler
+    PerlCleanupHandler  Apache2::SizeLimit Bugzilla::ModPerl::CleanupHandler
+    PerlOptions +ParseHeaders
+    Options +ExecCGI
+    AllowOverride Limit FileInfo Indexes Options
+    DirectoryIndex index.cgi index.html
+</Directory>
+EOT
+
+$server->add_config([split("\n", $conf)]);
+
+# Pre-load all extensions
+$Bugzilla::extension_packages = Bugzilla::Extension->load_all();
+
+# Have ModPerl::RegistryLoader pre-compile all CGI scripts.
+my $rl = new ModPerl::RegistryLoader();
+# If we try to do this in "new" it fails because it looks for a 
+# Bugzilla/ModPerl/ResponseHandler.pm
+$rl->{package} = 'Bugzilla::ModPerl::ResponseHandler';
+my $feature_files = Bugzilla::Install::Requirements::map_files_to_features();
+
+# Prevent "use lib" from doing anything when the .cgi files are compiled.
+# This is important to prevent the current directory from getting into
+# @INC and messing things up. (See bug 630750.)
+no warnings 'redefine';
+local *lib::import = sub {};
+use warnings;
+
+foreach my $file (glob "$cgi_path/*.cgi") {
+    my $base_filename = File::Basename::basename($file);
+    if (my $feature = $feature_files->{$base_filename}) {
+        next if !Bugzilla->feature($feature);
+    }
+    Bugzilla::Util::trick_taint($file);
+    $rl->handler($file, $file);
+}
+
+package Bugzilla::ModPerl::ResponseHandler;
+use strict;
+use base qw(ModPerl::Registry);
+use Bugzilla;
+
+sub handler : method {
+    my $class = shift;
+
+    # $0 is broken under mod_perl before 2.0.2, so we have to set it
+    # here explicitly or init_page's shutdownhtml code won't work right.
+    $0 = $ENV{'SCRIPT_FILENAME'};
+
+    # Prevent "use lib" from modifying @INC in the case where a .cgi file
+    # is being automatically recompiled by mod_perl when Apache is
+    # running. (This happens if a file changes while Apache is already
+    # running.)
+    no warnings 'redefine';
+    local *lib::import = sub {};
+    use warnings;
+
+    Bugzilla::init_page();
+    return $class->SUPER::handler(@_);
+}
+
+
+package Bugzilla::ModPerl::CleanupHandler;
+use strict;
+use Apache2::Const -compile => qw(OK);
+
+sub handler {
+    my $r = shift;
+
+    Bugzilla::_cleanup();
+    # Sometimes mod_perl doesn't properly call DESTROY on all
+    # the objects in pnotes()
+    foreach my $key (keys %{$r->pnotes}) {
+        delete $r->pnotes->{$key};
+    }
+
+    return Apache2::Const::OK;
+}
+
+1;

diff --git a/page.cgi b/page.cgi
new file mode 100755 (executable)
index 0000000..e042f5e
--- /dev/null
+++ b/page.cgi
@@ -0,0 +1,83 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+###############################################################################
+# This CGI is a general template display engine. To display templates using it,
+# put them in the "pages" subdirectory of en/default, call them
+# "foo.<ctype>.tmpl" and use the URL page.cgi?id=foo.<ctype> , where <ctype> is
+# a content-type, e.g. html.
+###############################################################################
+
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Error;
+use Bugzilla::Hook;
+use Bugzilla::Search::Quicksearch;
+
+###############
+# Subroutines #
+###############
+
+# For quicksearch.html.
+sub quicksearch_field_names {
+    my $fields = Bugzilla::Search::Quicksearch->FIELD_MAP;
+    my %fields_reverse;
+    # Put longer names before shorter names.
+    my @nicknames = sort { length($b) <=> length($a) } (keys %$fields);
+    foreach my $nickname (@nicknames) {
+        my $db_field = $fields->{$nickname};
+        $fields_reverse{$db_field} ||= [];
+        push(@{ $fields_reverse{$db_field} }, $nickname);
+    }
+    return \%fields_reverse;
+}
+
+###############
+# Main Script #
+###############
+
+Bugzilla->login();
+
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+
+my $id = $cgi->param('id');
+if ($id) {
+    # Be careful not to allow directory traversal.
+    if ($id =~ /\.\./) {
+        # two dots in a row is bad
+        ThrowUserError("bad_page_cgi_id", { "page_id" => $id });
+    }
+    # Split into name and ctype.
+    $id =~ /^([\w\-\/\.]+)\.(\w+)$/;
+    if (!$2) {
+        # if this regexp fails to match completely, something bad came in
+        ThrowUserError("bad_page_cgi_id", { "page_id" => $id });
+    }
+
+    my %vars = ( 
+      quicksearch_field_names => \&quicksearch_field_names,
+    );
+    Bugzilla::Hook::process('page_before_template', 
+                            { page_id => $id, vars => \%vars });
+
+    my $format = $template->get_format("pages/$1", undef, $2);
+    
+    $cgi->param('id', $id);
+
+    print $cgi->header($format->{'ctype'});
+
+    $template->process("$format->{'template'}", \%vars)
+      || ThrowTemplateError($template->error());
+}
+else {
+    ThrowUserError("no_page_specified");
+}

diff --git a/post_bug.cgi b/post_bug.cgi
new file mode 100755 (executable)
index 0000000..33f5652
--- /dev/null
+++ b/post_bug.cgi
@@ -0,0 +1,225 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Attachment;
+use Bugzilla::BugMail;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Bug;
+use Bugzilla::User;
+use Bugzilla::Field;
+use Bugzilla::Hook;
+use Bugzilla::Product;
+use Bugzilla::Component;
+use Bugzilla::Keyword;
+use Bugzilla::Token;
+use Bugzilla::Flag;
+
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+my $cgi = Bugzilla->cgi;
+my $dbh = Bugzilla->dbh;
+my $template = Bugzilla->template;
+my $vars = {};
+
+######################################################################
+# Main Script
+######################################################################
+
+# redirect to enter_bug if no field is passed.
+unless ($cgi->param()) {
+    print $cgi->redirect(correct_urlbase() . 'enter_bug.cgi');
+    exit;
+}
+
+# Detect if the user already used the same form to submit a bug
+my $token = trim($cgi->param('token'));
+check_token_data($token, 'create_bug', 'index.cgi');
+
+# do a match on the fields if applicable
+Bugzilla::User::match_field ({
+    'cc'            => { 'type' => 'multi'  },
+    'assigned_to'   => { 'type' => 'single' },
+    'qa_contact'    => { 'type' => 'single' },
+});
+
+if (defined $cgi->param('maketemplate')) {
+    $vars->{'url'} = $cgi->canonicalise_query('token');
+    $vars->{'short_desc'} = $cgi->param('short_desc');
+    
+    print $cgi->header();
+    $template->process("bug/create/make-template.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+umask 0;
+
+# The format of the initial comment can be structured by adding fields to the
+# enter_bug template and then referencing them in the comment template.
+my $comment;
+my $format = $template->get_format("bug/create/comment",
+                                   scalar($cgi->param('format')), "txt");
+$template->process($format->{'template'}, $vars, \$comment)
+    || ThrowTemplateError($template->error());
+
+# Include custom fields editable on bug creation.
+my @custom_bug_fields = grep {$_->type != FIELD_TYPE_MULTI_SELECT && $_->enter_bug}
+                             Bugzilla->active_custom_fields;
+
+# Undefined custom fields are ignored to ensure they will get their default
+# value (e.g. "---" for custom single select fields).
+my @bug_fields = grep { defined $cgi->param($_->name) } @custom_bug_fields;
+@bug_fields = map { $_->name } @bug_fields;
+
+push(@bug_fields, qw(
+    product
+    component
+
+    assigned_to
+    qa_contact
+
+    alias
+    blocked
+    comment_is_private
+    bug_file_loc
+    bug_severity
+    bug_status
+    dependson
+    keywords
+    short_desc
+    op_sys
+    priority
+    rep_platform
+    version
+    target_milestone
+    status_whiteboard
+
+    estimated_time
+    deadline
+));
+my %bug_params;
+foreach my $field (@bug_fields) {
+    $bug_params{$field} = $cgi->param($field);
+}
+foreach my $field (qw(cc groups)) {
+    next if !$cgi->should_set($field);
+    $bug_params{$field} = [$cgi->param($field)];
+}
+$bug_params{'comment'} = $comment;
+
+my @multi_selects = grep {$_->type == FIELD_TYPE_MULTI_SELECT && $_->enter_bug}
+                         Bugzilla->active_custom_fields;
+
+foreach my $field (@multi_selects) {
+    next if !$cgi->should_set($field->name);
+    $bug_params{$field->name} = [$cgi->param($field->name)];
+}
+
+my $bug = Bugzilla::Bug->create(\%bug_params);
+
+# Get the bug ID back and delete the token used to create this bug.
+my $id = $bug->bug_id;
+delete_token($token);
+
+# We do this directly from the DB because $bug->creation_ts has the seconds
+# formatted out of it (which should be fixed some day).
+my $timestamp = $dbh->selectrow_array(
+    'SELECT creation_ts FROM bugs WHERE bug_id = ?', undef, $id);
+
+# Set Version cookie, but only if the user actually selected
+# a version on the page.
+if (defined $cgi->param('version')) {
+    $cgi->send_cookie(-name => "VERSION-" . $bug->product,
+                      -value => $bug->version,
+                      -expires => "Fri, 01-Jan-2038 00:00:00 GMT");
+}
+
+# We don't have to check if the user can see the bug, because a user filing
+# a bug can always see it. You can't change reporter_accessible until
+# after the bug is filed.
+
+# Add an attachment if requested.
+if (defined($cgi->upload('data')) || $cgi->param('attach_text')) {
+    $cgi->param('isprivate', $cgi->param('comment_is_private'));
+
+    # Must be called before create() as it may alter $cgi->param('ispatch').
+    my $content_type = Bugzilla::Attachment::get_content_type();
+    my $attachment;
+
+    # If the attachment cannot be successfully added to the bug,
+    # we notify the user, but we don't interrupt the bug creation process.
+    my $error_mode_cache = Bugzilla->error_mode;
+    Bugzilla->error_mode(ERROR_MODE_DIE);
+    eval {
+        $attachment = Bugzilla::Attachment->create(
+            {bug           => $bug,
+             creation_ts   => $timestamp,
+             data          => scalar $cgi->param('attach_text') || $cgi->upload('data'),
+             description   => scalar $cgi->param('description'),
+             filename      => $cgi->param('attach_text') ? "file_$id.txt" : scalar $cgi->upload('data'),
+             ispatch       => scalar $cgi->param('ispatch'),
+             isprivate     => scalar $cgi->param('isprivate'),
+             mimetype      => $content_type,
+            });
+    };
+    Bugzilla->error_mode($error_mode_cache);
+
+    if ($attachment) {
+        # Set attachment flags.
+        my ($flags, $new_flags) = Bugzilla::Flag->extract_flags_from_cgi(
+                                      $bug, $attachment, $vars, SKIP_REQUESTEE_ON_ERROR);
+        $attachment->set_flags($flags, $new_flags);
+        $attachment->update($timestamp);
+        my $comment = $bug->comments->[0];
+        $comment->set_all({ type => CMT_ATTACHMENT_CREATED, 
+                            extra_data => $attachment->id });
+        $comment->update();
+    }
+    else {
+        $vars->{'message'} = 'attachment_creation_failed';
+    }
+}
+
+# Set bug flags.
+my ($flags, $new_flags) = Bugzilla::Flag->extract_flags_from_cgi($bug, undef, $vars,
+                                                             SKIP_REQUESTEE_ON_ERROR);
+$bug->set_flags($flags, $new_flags);
+$bug->update($timestamp);
+
+$vars->{'id'} = $id;
+$vars->{'bug'} = $bug;
+
+Bugzilla::Hook::process('post_bug_after_creation', { vars => $vars });
+
+my $recipients = { changer => $user };
+my $bug_sent = Bugzilla::BugMail::Send($id, $recipients);
+$bug_sent->{type} = 'created';
+$bug_sent->{id}   = $id;
+my @all_mail_results = ($bug_sent);
+foreach my $dep (@{$bug->dependson || []}, @{$bug->blocked || []}) {
+    my $dep_sent = Bugzilla::BugMail::Send($dep, $recipients);
+    $dep_sent->{type} = 'dep';
+    $dep_sent->{id}   = $dep;
+    push(@all_mail_results, $dep_sent);
+}
+$vars->{sentmail} = \@all_mail_results;
+
+$format = $template->get_format("bug/create/created",
+                                 scalar($cgi->param('created-format')),
+                                 "html");
+print $cgi->header();
+$template->process($format->{'template'}, $vars)
+    || ThrowTemplateError($template->error());
+
+1;

diff --git a/process_bug.cgi b/process_bug.cgi
new file mode 100755 (executable)
index 0000000..79eeca4
--- /dev/null
+++ b/process_bug.cgi
@@ -0,0 +1,415 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# Implementation notes for this file:
+#
+# 1) the 'id' form parameter is validated early on, and if it is not a valid
+# bugid an error will be reported, so it is OK for later code to simply check
+# for a defined form 'id' value, and it can assume a valid bugid.
+#
+# 2) If the 'id' form parameter is not defined (after the initial validation),
+# then we are processing multiple bugs, and @idlist will contain the ids.
+#
+# 3) If we are processing just the one id, then it is stored in @idlist for
+# later processing.
+
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Bug;
+use Bugzilla::User;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Flag;
+use Bugzilla::Status;
+use Bugzilla::Token;
+
+use List::MoreUtils qw(firstidx);
+use Storable qw(dclone);
+
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+my $cgi = Bugzilla->cgi;
+my $dbh = Bugzilla->dbh;
+my $template = Bugzilla->template;
+my $vars = {};
+
+######################################################################
+# Subroutines
+######################################################################
+
+# Tells us whether or not a field should be changed by process_bug.
+sub should_set {
+    # check_defined is used for fields where there's another field
+    # whose name starts with "defined_" and then the field name--it's used
+    # to know when we did things like empty a multi-select or deselect
+    # a checkbox.
+    my ($field, $check_defined) = @_;
+    my $cgi = Bugzilla->cgi;
+    if ( defined $cgi->param($field) 
+         || ($check_defined && defined $cgi->param("defined_$field")) )
+    {
+        return 1;
+    }
+    return 0;
+}
+
+######################################################################
+# Begin Data/Security Validation
+######################################################################
+
+# Create a list of objects for all bugs being modified in this request.
+my @bug_objects;
+if (defined $cgi->param('id')) {
+  my $bug = Bugzilla::Bug->check_for_edit(scalar $cgi->param('id'));
+  $cgi->param('id', $bug->id);
+  push(@bug_objects, $bug);
+} else {
+    foreach my $i ($cgi->param()) {
+        if ($i =~ /^id_([1-9][0-9]*)/) {
+            my $id = $1;
+            push(@bug_objects, Bugzilla::Bug->check_for_edit($id));
+        }
+    }
+}
+
+# Make sure there are bugs to process.
+scalar(@bug_objects) || ThrowUserError("no_bugs_chosen", {action => 'modify'});
+
+my $first_bug = $bug_objects[0]; # Used when we're only updating a single bug.
+
+# Delete any parameter set to 'dontchange'.
+if (defined $cgi->param('dontchange')) {
+    foreach my $name ($cgi->param) {
+        next if $name eq 'dontchange'; # But don't delete dontchange itself!
+        # Skip ones we've already deleted (such as "defined_$name").
+        next if !defined $cgi->param($name);
+        if ($cgi->param($name) eq $cgi->param('dontchange')) {
+            $cgi->delete($name);
+            $cgi->delete("defined_$name");
+        }
+    }
+}
+
+# do a match on the fields if applicable
+Bugzilla::User::match_field({
+    'qa_contact'                => { 'type' => 'single' },
+    'newcc'                     => { 'type' => 'multi'  },
+    'masscc'                    => { 'type' => 'multi'  },
+    'assigned_to'               => { 'type' => 'single' },
+});
+
+print $cgi->header() unless Bugzilla->usage_mode == USAGE_MODE_EMAIL;
+
+# Check for a mid-air collision. Currently this only works when updating
+# an individual bug.
+if (defined $cgi->param('delta_ts'))
+{
+    my $delta_ts_z = datetime_from($cgi->param('delta_ts'));
+    my $first_delta_tz_z =  datetime_from($first_bug->delta_ts);
+    if ($first_delta_tz_z ne $delta_ts_z) {
+        ($vars->{'operations'}) = $first_bug->get_activity(undef, $cgi->param('delta_ts'));
+
+        ThrowCodeError('undefined_field', { field => 'longdesclength' })
+            if !defined $cgi->param('longdesclength');
+
+        my $start_at = $cgi->param('longdesclength');
+
+        # Always sort midair collision comments oldest to newest,
+        # regardless of the user's personal preference.
+        my $comments = $first_bug->comments({ order => "oldest_to_newest" });
+
+        # The token contains the old delta_ts. We need a new one.
+        $cgi->param('token', issue_hash_token([$first_bug->id, $first_bug->delta_ts]));
+
+        # Show midair if previous changes made other than CC
+        # and/or one or more comments were made
+        my $do_midair = scalar @$comments > $start_at ? 1 : 0;
+
+        if (!$do_midair) {
+            foreach my $operation (@{ $vars->{'operations'} }) {
+                foreach my $change (@{ $operation->{'changes'} }) {
+                    $do_midair = 1 if $change->{'fieldname'} ne 'cc';
+                    last;
+                }
+                last if $do_midair;
+            }
+        }
+
+        if ($do_midair) {
+            $vars->{'title_tag'} = "mid_air";
+            $vars->{'start_at'} = $start_at;
+            $vars->{'comments'} = $comments;
+            $vars->{'bug'} = $first_bug;
+
+            # Warn the user about the mid-air collision and ask them what to do.
+            $template->process("bug/process/midair.html.tmpl", $vars)
+                || ThrowTemplateError($template->error());
+            exit;
+        }
+    }
+}
+
+# We couldn't do this check earlier as we first had to validate bug IDs
+# and display the mid-air collision page if delta_ts changed.
+# If we do a mass-change, we use session tokens.
+my $token = $cgi->param('token');
+
+if ($cgi->param('id')) {
+    check_hash_token($token, [$first_bug->id, $first_bug->delta_ts]);
+}
+else {
+    check_token_data($token, 'buglist_mass_change', 'query.cgi');
+}
+
+######################################################################
+# End Data/Security Validation
+######################################################################
+
+$vars->{'title_tag'} = "bug_processed";
+
+my $action;
+if (defined $cgi->param('id')) {
+    $action = $user->setting('post_bug_submit_action');
+
+    if ($action eq 'next_bug') {
+        my $bug_list_obj = $user->recent_search_for($first_bug);
+        my @bug_list = $bug_list_obj ? @{$bug_list_obj->bug_list} : ();
+        my $cur = firstidx { $_ eq $cgi->param('id') } @bug_list;
+        if ($cur >= 0 && $cur < $#bug_list) {
+            my $next_bug_id = $bug_list[$cur + 1];
+            detaint_natural($next_bug_id);
+            if ($next_bug_id and $user->can_see_bug($next_bug_id)) {
+                # We create an object here so that $bug->send_changes can use it
+                # when displaying the header.
+                $vars->{'bug'} = new Bugzilla::Bug($next_bug_id);
+            }
+        }
+    }
+    # Include both action = 'same_bug' and 'nothing'.
+    else {
+        $vars->{'bug'} = $first_bug;
+    }
+}
+else {
+    # param('id') is not defined when changing multiple bugs at once.
+    $action = 'nothing';
+}
+
+# Component, target_milestone, and version are in here just in case
+# the 'product' field wasn't defined in the CGI. It doesn't hurt to set
+# them twice.
+my @set_fields = qw(op_sys rep_platform priority bug_severity
+                    component target_milestone version
+                    bug_file_loc status_whiteboard short_desc
+                    deadline remaining_time estimated_time
+                    work_time set_default_assignee set_default_qa_contact
+                    cclist_accessible reporter_accessible 
+                    product confirm_product_change
+                    bug_status resolution dup_id);
+push(@set_fields, 'assigned_to') if !$cgi->param('set_default_assignee');
+push(@set_fields, 'qa_contact')  if !$cgi->param('set_default_qa_contact');
+my %field_translation = (
+    bug_severity => 'severity',
+    rep_platform => 'platform',
+    short_desc   => 'summary',
+    bug_file_loc => 'url',
+    set_default_assignee   => 'reset_assigned_to',
+    set_default_qa_contact => 'reset_qa_contact',
+    confirm_product_change => 'product_change_confirmed',
+);
+
+my %set_all_fields = ( other_bugs => \@bug_objects );
+foreach my $field_name (@set_fields) {
+    if (should_set($field_name, 1)) {
+        my $param_name = $field_translation{$field_name} || $field_name;
+        $set_all_fields{$param_name} = $cgi->param($field_name);
+    }
+}
+
+if (should_set('keywords')) {
+    my $action = $cgi->param('keywordaction') || '';
+    # Backward-compatibility for Bugzilla 3.x and older.
+    $action = 'remove' if $action eq 'delete';
+    $action = 'set'    if $action eq 'makeexact';
+    $set_all_fields{keywords}->{$action} = $cgi->param('keywords');
+}
+if (should_set('comment')) {
+    $set_all_fields{comment} = {
+        body       => scalar $cgi->param('comment'),
+        is_private => scalar $cgi->param('comment_is_private'),
+    };
+}
+if (should_set('see_also')) {
+    $set_all_fields{'see_also'}->{add} = 
+        [split(/[\s,]+/, $cgi->param('see_also'))];
+}
+if (should_set('remove_see_also')) {
+    $set_all_fields{'see_also'}->{remove} = [$cgi->param('remove_see_also')];
+}
+foreach my $dep_field (qw(dependson blocked)) {
+    if (should_set($dep_field)) {
+        if (my $dep_action = $cgi->param("${dep_field}_action")) {
+            $set_all_fields{$dep_field}->{$dep_action} =
+                [split(/[\s,]+/, $cgi->param($dep_field))];
+        }
+        else {
+            $set_all_fields{$dep_field}->{set} = $cgi->param($dep_field);
+        }
+    }
+}
+# Formulate the CC data into two arrays of users involved in this CC change.
+if (defined $cgi->param('newcc')
+    or defined $cgi->param('addselfcc')
+    or defined $cgi->param('removecc')
+    or defined $cgi->param('masscc')) 
+{
+    my (@cc_add, @cc_remove);
+    # If masscc is defined, then we came from buglist and need to either add or
+    # remove cc's... otherwise, we came from show_bug and may need to do both.
+    if (defined $cgi->param('masscc')) {
+        if ($cgi->param('ccaction') eq 'add') {
+            @cc_add = $cgi->param('masscc');
+        } elsif ($cgi->param('ccaction') eq 'remove') {
+            @cc_remove = $cgi->param('masscc');
+        }
+    } else {
+        @cc_add = $cgi->param('newcc');
+        push(@cc_add, $user) if $cgi->param('addselfcc');
+
+        # We came from show_bug which uses a select box to determine what cc's
+        # need to be removed...
+        if ($cgi->param('removecc') && $cgi->param('cc')) {
+            @cc_remove = $cgi->param('cc');
+        }
+    }
+
+    $set_all_fields{cc} = { add => \@cc_add, remove => \@cc_remove };
+}
+
+# Fields that can only be set on one bug at a time.
+if (defined $cgi->param('id')) {
+    # Since aliases are unique (like bug numbers), they can only be changed
+    # for one bug at a time.
+    if (defined $cgi->param('alias')) {
+        $set_all_fields{alias} = $cgi->param('alias');
+    }
+}
+
+my %is_private;
+foreach my $field (grep(/^defined_isprivate/, $cgi->param())) {
+    $field =~ /(\d+)$/;
+    my $comment_id = $1;
+    $is_private{$comment_id} = $cgi->param("isprivate_$comment_id");
+}
+$set_all_fields{comment_is_private} = \%is_private;
+
+my @check_groups = $cgi->param('defined_groups');
+my @set_groups = $cgi->param('groups');
+my ($removed_groups) = diff_arrays(\@check_groups, \@set_groups);
+$set_all_fields{groups} = { add => \@set_groups, remove => $removed_groups };
+
+my @custom_fields = Bugzilla->active_custom_fields;
+foreach my $field (@custom_fields) {
+    my $fname = $field->name;
+    if (should_set($fname, 1)) {
+        $set_all_fields{$fname} = [$cgi->param($fname)];
+    }
+}
+
+# We are going to alter the list of removed groups, so we keep a copy here.
+my @unchecked_groups = @$removed_groups;
+foreach my $b (@bug_objects) {
+    # Don't blindly ask to remove unchecked groups available in the UI.
+    # A group can be already unchecked, and the user didn't try to remove it.
+    # In this case, we don't want remove_group() to complain.
+    my @remove_groups;
+    foreach my $g (@{$b->groups_in}) {
+        push(@remove_groups, $g->name) if grep { $_ eq $g->name } @unchecked_groups;
+    }
+    local $set_all_fields{groups}->{remove} = \@remove_groups;
+    $b->set_all(\%set_all_fields);
+}
+
+if (defined $cgi->param('id')) {
+    # Flags should be set AFTER the bug has been moved into another
+    # product/component. The structure of flags code doesn't currently
+    # allow them to be set using set_all.
+    my ($flags, $new_flags) = Bugzilla::Flag->extract_flags_from_cgi(
+        $first_bug, undef, $vars);
+    $first_bug->set_flags($flags, $new_flags);
+
+    # Tags can only be set to one bug at once.
+    if (should_set('tag')) {
+        my @new_tags = split(/[\s,]+/, $cgi->param('tag'));
+        my ($tags_removed, $tags_added) = diff_arrays($first_bug->tags, \@new_tags);
+        $first_bug->remove_tag($_) foreach @$tags_removed;
+        $first_bug->add_tag($_) foreach @$tags_added;
+    }
+}
+
+##############################
+# Do Actual Database Updates #
+##############################
+foreach my $bug (@bug_objects) {
+    my $changes = $bug->update();
+
+    if ($changes->{'bug_status'}) {
+        my $new_status = $changes->{'bug_status'}->[1];
+        # We may have zeroed the remaining time, if we moved into a closed
+        # status, so we should inform the user about that.
+        if (!is_open_state($new_status) && $changes->{'remaining_time'}) {
+            $vars->{'message'} = "remaining_time_zeroed"
+              if $user->is_timetracker;
+        }
+    }
+
+    $bug->send_changes($changes, $vars);
+}
+
+# Delete the session token used for the mass-change.
+delete_token($token) unless $cgi->param('id');
+
+if (Bugzilla->usage_mode == USAGE_MODE_EMAIL) {
+    # Do nothing.
+}
+elsif ($action eq 'next_bug' or $action eq 'same_bug') {
+    my $bug = $vars->{'bug'};
+    if ($bug and $user->can_see_bug($bug)) {
+        if ($action eq 'same_bug') {
+            # $bug->update() does not update the internal structure of
+            # the bug sufficiently to display the bug with the new values.
+            # (That is, if we just passed in the old Bug object, we'd get
+            # a lot of old values displayed.)
+            $bug = new Bugzilla::Bug($bug->id);
+            $vars->{'bug'} = $bug;
+        }
+        $vars->{'bugs'} = [$bug];
+        if ($action eq 'next_bug') {
+            $vars->{'nextbug'} = $bug->id;
+        }
+        $template->process("bug/show.html.tmpl", $vars)
+          || ThrowTemplateError($template->error());
+        exit;
+    }
+} elsif ($action ne 'nothing') {
+    ThrowCodeError("invalid_post_bug_submit_action");
+}
+
+# End the response page.
+unless (Bugzilla->usage_mode == USAGE_MODE_EMAIL) {
+    $template->process("bug/navigate.html.tmpl", $vars)
+        || ThrowTemplateError($template->error());
+    $template->process("global/footer.html.tmpl", $vars)
+        || ThrowTemplateError($template->error());
+}
+
+1;

diff --git a/query.cgi b/query.cgi
new file mode 100755 (executable)
index 0000000..080137a
--- /dev/null
+++ b/query.cgi
@@ -0,0 +1,287 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Bug;
+use Bugzilla::Constants;
+use Bugzilla::Search;
+use Bugzilla::User;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Product;
+use Bugzilla::Keyword;
+use Bugzilla::Field;
+use Bugzilla::Install::Util qw(vers_cmp);
+use Bugzilla::Token;
+
+###############
+# Subroutines #
+###############
+
+sub get_product_values {
+    my ($products, $field, $vars) = @_;
+    my @all_values = map { @{ $_->$field } } @$products;
+
+    my (@unique, %duplicates, %duplicate_count, %seen);
+    foreach my $value (@all_values) {
+        my $lc_name = lc($value->name);
+        if ($seen{$lc_name}) {
+            $duplicate_count{$seen{$lc_name}->id}++;
+            $duplicates{$value->id} = $seen{$lc_name};
+            next;
+        }
+        push(@unique, $value);
+        $seen{$lc_name} = $value;
+    }
+
+    $field =~ s/s$//;
+    if ($field eq 'version') {
+        @unique = sort { vers_cmp(lc($a->name), lc($b->name)) } @unique;
+    }
+    else {
+        @unique = sort { lc($a->name) cmp lc($b->name) } @unique;
+    }
+
+    $field = 'target_milestone' if $field eq 'milestone';
+    $vars->{duplicates}->{$field} = \%duplicates;
+    $vars->{duplicate_count}->{$field} = \%duplicate_count;
+    # "component" is a reserved word in Template Toolkit.
+    $field = 'component_' if $field eq 'component';
+    $vars->{$field} = \@unique;
+}
+
+###############
+# Main Script #
+###############
+
+my $cgi = Bugzilla->cgi;
+my $dbh = Bugzilla->dbh;
+my $template = Bugzilla->template;
+my $vars = {};
+my $buffer = $cgi->query_string();
+
+my $user = Bugzilla->login();
+my $userid = $user->id;
+
+if ($cgi->param('nukedefaultquery')) {
+    if ($userid) {
+        my $token = $cgi->param('token');
+        check_hash_token($token, ['nukedefaultquery']);
+        $dbh->do("DELETE FROM namedqueries" .
+                 " WHERE userid = ? AND name = ?", 
+                 undef, ($userid, DEFAULT_QUERY_NAME));
+    }
+    $buffer = "";
+}
+
+# We are done with changes committed to the DB.
+$dbh = Bugzilla->switch_to_shadow_db;
+
+my $userdefaultquery;
+if ($userid) {
+    $userdefaultquery = $dbh->selectrow_array(
+        "SELECT query FROM namedqueries " .
+         "WHERE userid = ? AND name = ?", 
+         undef, ($userid, DEFAULT_QUERY_NAME));
+}
+
+local our %default;
+
+# We pass the defaults as a hash of references to arrays. For those
+# Items which are single-valued, the template should only reference [0]
+# and ignore any multiple values.
+sub PrefillForm {
+    my ($buf) = @_;
+    my $cgi = Bugzilla->cgi;
+    $buf = new Bugzilla::CGI($buf);
+    my $foundone = 0;
+
+    # If there are old-style boolean charts in the URL (from an old saved
+    # search or from an old link on the web somewhere) then convert them
+    # to the new "custom search" format so that the form is populated
+    # properly.
+    my $any_boolean_charts = grep { /^field-?\d+/ } $buf->param();
+    if ($any_boolean_charts) {
+        my $search = new Bugzilla::Search(params => scalar $buf->Vars);
+        $search->boolean_charts_to_custom_search($buf);
+    }
+
+    # Query parameters that don't represent form fields on this page.
+    my @skip = qw(format query_format list_id columnlist);
+
+    # Iterate over the URL parameters
+    foreach my $name ($buf->param()) {
+        next if grep { $_ eq $name } @skip;
+        $foundone = 1;
+        my @values = $buf->param($name);
+        
+        # If the name is a single letter followed by numbers, it's part
+        # of Custom Search. We store these as an array of hashes.
+        if ($name =~ /^([[:lower:]])(\d+)$/) {
+            $default{'custom_search'}->[$2]->{$1} = $values[0];
+        }
+        # If the name ends in a number (which it does for the fields which
+        # are part of the email searching), we use the array
+        # positions to show the defaults for that number field.
+        elsif ($name =~ /^(\w+)(\d)$/) {
+            $default{$1}->[$2] = $values[0];
+        }
+        else {
+            push (@{ $default{$name} }, @values);
+        }
+    }
+
+    return $foundone;
+}
+
+if (!PrefillForm($buffer)) {
+    # Ah-hah, there was no form stuff specified.  Do it again with the
+    # default query.
+    if ($userdefaultquery) {
+        PrefillForm($userdefaultquery);
+    } else {
+        PrefillForm(Bugzilla->params->{"defaultquery"});
+    }
+}
+
+# if using groups for entry, then we don't want people to see products they 
+# don't have access to. Remove them from the list.
+my @selectable_products = sort {lc($a->name) cmp lc($b->name)} 
+                               @{$user->get_selectable_products};
+Bugzilla::Product::preload(\@selectable_products);
+$vars->{'product'} = \@selectable_products;
+
+# Create the component, version and milestone lists.
+foreach my $field (qw(components versions milestones)) {
+    get_product_values(\@selectable_products, $field, $vars);
+}
+
+# Create data structures representing each classification
+if (Bugzilla->params->{'useclassification'}) {
+    $vars->{'classification'} = $user->get_selectable_classifications;
+}
+
+my @chfields;
+
+push @chfields, "[Bug creation]";
+
+# This is what happens when you have variables whose definition depends
+# on the DB schema, and then the underlying schema changes...
+foreach my $val (editable_bug_fields()) {
+    if ($val eq 'classification_id') {
+        $val = 'classification';
+    } elsif ($val eq 'product_id') {
+        $val = 'product';
+    } elsif ($val eq 'component_id') {
+        $val = 'component';
+    }
+    push @chfields, $val;
+}
+
+if ($user->is_timetracker) {
+    push @chfields, "work_time";
+} else {
+    @chfields = grep($_ ne "deadline", @chfields);
+    @chfields = grep($_ ne "estimated_time", @chfields);
+    @chfields = grep($_ ne "remaining_time", @chfields);
+}
+@chfields = (sort(@chfields));
+$vars->{'chfield'} = \@chfields;
+$vars->{'bug_status'} = Bugzilla::Field->new({name => 'bug_status'})->legal_values;
+$vars->{'rep_platform'} = Bugzilla::Field->new({name => 'rep_platform'})->legal_values;
+$vars->{'op_sys'} = Bugzilla::Field->new({name => 'op_sys'})->legal_values;
+$vars->{'priority'} = Bugzilla::Field->new({name => 'priority'})->legal_values;
+$vars->{'bug_severity'} = Bugzilla::Field->new({name => 'bug_severity'})->legal_values;
+$vars->{'resolution'} = Bugzilla::Field->new({name => 'resolution'})->legal_values;
+
+# Boolean charts
+my @fields = @{ Bugzilla->fields({ obsolete => 0 }) };
+
+# If we're not in the time-tracking group, exclude time-tracking fields.
+if (!$user->is_timetracker) {
+    foreach my $tt_field (TIMETRACKING_FIELDS) {
+        @fields = grep($_->name ne $tt_field, @fields);
+    }
+}
+
+@fields = sort {lc($a->description) cmp lc($b->description)} @fields;
+unshift(@fields, { name => "noop", description => "---" });
+$vars->{'fields'} = \@fields;
+
+# Named queries
+if ($userid) {
+     $vars->{'namedqueries'} = $dbh->selectcol_arrayref(
+           "SELECT name FROM namedqueries " .
+            "WHERE userid = ? AND name != ? " .
+         "ORDER BY name",
+         undef, ($userid, DEFAULT_QUERY_NAME));
+}
+
+# Sort order
+my $deforder;
+my @orders = ('Bug Number', 'Importance', 'Assignee', 'Last Changed');
+
+if ($cgi->cookie('LASTORDER')) {
+    $deforder = "Reuse same sort as last time";
+    unshift(@orders, $deforder);
+}
+
+if ($cgi->param('order')) { $deforder = $cgi->param('order') }
+
+$vars->{'userdefaultquery'} = $userdefaultquery;
+$vars->{'orders'} = \@orders;
+$default{'order'} = [$deforder || 'Importance'];
+
+if (($cgi->param('query_format') || $cgi->param('format') || "")
+    eq "create-series") {
+    require Bugzilla::Chart;
+    $vars->{'category'} = Bugzilla::Chart::getVisibleSeries();
+}
+
+$vars->{'known_name'} = $cgi->param('known_name');
+$vars->{'columnlist'} = $cgi->param('columnlist');
+
+
+# Add in the defaults.
+$vars->{'default'} = \%default;
+
+$vars->{'format'} = $cgi->param('format');
+$vars->{'query_format'} = $cgi->param('query_format');
+
+# Set default page to "specific" if none provided
+if (!($cgi->param('query_format') || $cgi->param('format'))) {
+    if (defined $cgi->cookie('DEFAULTFORMAT')) {
+        $vars->{'format'} = $cgi->cookie('DEFAULTFORMAT');
+    } else {
+        $vars->{'format'} = 'specific';
+    }
+}
+
+# Set cookie to current format as default, but only if the format
+# one that we should remember.
+if (defined($vars->{'format'}) && IsValidQueryType($vars->{'format'})) {
+    $cgi->send_cookie(-name => 'DEFAULTFORMAT',
+                      -value => $vars->{'format'},
+                      -expires => "Fri, 01-Jan-2038 00:00:00 GMT");
+}
+
+# Generate and return the UI (HTML page) from the appropriate template.
+# If we submit back to ourselves (for e.g. boolean charts), we need to
+# preserve format information; hence query_format taking priority over
+# format.
+my $format = $template->get_format("search/search", 
+                                   $vars->{'query_format'} || $vars->{'format'}, 
+                                   scalar $cgi->param('ctype'));
+
+print $cgi->header($format->{'ctype'});
+
+$template->process($format->{'template'}, $vars)
+  || ThrowTemplateError($template->error());

diff --git a/quips.cgi b/quips.cgi
new file mode 100755 (executable)
index 0000000..2a77568
--- /dev/null
+++ b/quips.cgi
@@ -0,0 +1,137 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::User;
+use Bugzilla::Token;
+
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+my $cgi = Bugzilla->cgi;
+my $dbh = Bugzilla->dbh;
+my $template = Bugzilla->template;
+my $vars = {};
+
+my $action = $cgi->param('action') || "";
+my $token = $cgi->param('token');
+
+if ($action eq "show") {
+    # Read in the entire quip list
+    my $quipsref = $dbh->selectall_arrayref(
+                       "SELECT quipid, userid, quip, approved FROM quips ORDER BY quipid");
+
+    my $quips;
+    my @quipids;
+    foreach my $quipref (@$quipsref) {
+        my ($quipid, $userid, $quip, $approved) = @$quipref;
+        $quips->{$quipid} = {'userid' => $userid, 'quip' => $quip, 
+                             'approved' => $approved};
+        push(@quipids, $quipid);
+    }
+
+    my $users;
+    my $sth = $dbh->prepare("SELECT login_name FROM profiles WHERE userid = ?");
+    foreach my $quipid (@quipids) {
+        my $userid = $quips->{$quipid}{'userid'};
+        if ($userid && not defined $users->{$userid}) {
+            ($users->{$userid}) = $dbh->selectrow_array($sth, undef, $userid);
+        }
+    }
+    $vars->{'quipids'} = \@quipids;
+    $vars->{'quips'} = $quips;
+    $vars->{'users'} = $users;
+    $vars->{'show_quips'} = 1;
+}
+
+if ($action eq "add") {
+    (Bugzilla->params->{'quip_list_entry_control'} eq "closed") &&
+      ThrowUserError("no_new_quips");
+
+    check_hash_token($token, ['create-quips']);
+    # Add the quip 
+    my $approved = (Bugzilla->params->{'quip_list_entry_control'} eq "open")
+                   || $user->in_group('bz_quip_moderators') || 0;
+    my $comment = $cgi->param("quip");
+    $comment || ThrowUserError("need_quip");
+    
+    ThrowUserError("quip_too_long", { length => length($comment) }) 
+        if length($comment) > MAX_QUIP_LENGTH;
+
+    trick_taint($comment); # Used in a placeholder below
+
+    $dbh->do("INSERT INTO quips (userid, quip, approved) VALUES (?, ?, ?)",
+             undef, ($user->id, $comment, $approved));
+
+    $vars->{'added_quip'} = $comment;
+}
+
+if ($action eq 'approve') {
+    $user->in_group('bz_quip_moderators')
+      || ThrowUserError("auth_failure", {group  => "bz_quip_moderators",
+                                         action => "approve",
+                                         object => "quips"});
+
+    check_hash_token($token, ['approve-quips']);
+    # Read in the entire quip list
+    my $quipsref = $dbh->selectall_arrayref("SELECT quipid, approved FROM quips");
+    
+    my %quips;
+    foreach my $quipref (@$quipsref) {
+        my ($quipid, $approved) = @$quipref;
+        $quips{$quipid} = $approved;
+    }
+
+    my @approved;
+    my @unapproved;
+    foreach my $quipid (keys %quips) {
+        # Must check for each quipid being defined for concurrency and
+        # automated usage where only one quipid might be defined.
+        my $quip = $cgi->param("quipid_$quipid") ? 1 : 0;
+        if(defined($cgi->param("defined_quipid_$quipid"))) {
+            if($quips{$quipid} != $quip) {
+                if($quip) { 
+                    push(@approved, $quipid); 
+                } else { 
+                    push(@unapproved, $quipid); 
+                }
+            }
+        }
+    }
+    $dbh->do("UPDATE quips SET approved = 1 WHERE quipid IN (" .
+            join(",", @approved) . ")") if($#approved > -1);
+    $dbh->do("UPDATE quips SET approved = 0 WHERE quipid IN (" .
+            join(",", @unapproved) . ")") if($#unapproved > -1);
+    $vars->{ 'approved' }   = \@approved;
+    $vars->{ 'unapproved' } = \@unapproved;
+}
+
+if ($action eq "delete") {
+    $user->in_group('bz_quip_moderators')
+      || ThrowUserError("auth_failure", {group  => "bz_quip_moderators",
+                                         action => "delete",
+                                         object => "quips"});
+    my $quipid = $cgi->param("quipid");
+    detaint_natural($quipid) || ThrowUserError("need_quipid");
+    check_hash_token($token, ['quips', $quipid]);
+
+    ($vars->{'deleted_quip'}) = $dbh->selectrow_array(
+                                    "SELECT quip FROM quips WHERE quipid = ?",
+                                    undef, $quipid);
+    $dbh->do("DELETE FROM quips WHERE quipid = ?", undef, $quipid);
+}
+
+print $cgi->header();
+$template->process("list/quips.html.tmpl", $vars)
+  || ThrowTemplateError($template->error());

diff --git a/relogin.cgi b/relogin.cgi
new file mode 100755 (executable)
index 0000000..57240db
--- /dev/null
+++ b/relogin.cgi
@@ -0,0 +1,188 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Mailer;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Token;
+use Bugzilla::User;
+use Bugzilla::Util;
+use Date::Format;
+
+my $template = Bugzilla->template;
+my $cgi = Bugzilla->cgi;
+
+my $action = $cgi->param('action') || '';
+
+my $vars = {};
+my $target;
+
+if (!$action) {
+    # redirect to index.cgi if no action is defined.
+    print $cgi->redirect(correct_urlbase() . 'index.cgi');
+    exit;
+}
+# prepare-sudo: Display the sudo information & login page
+elsif ($action eq 'prepare-sudo') {
+    # We must have a logged-in user to do this
+    # That user must be in the 'bz_sudoers' group
+    my $user = Bugzilla->login(LOGIN_REQUIRED);
+    unless ($user->in_group('bz_sudoers')) {
+        ThrowUserError('auth_failure', {  group => 'bz_sudoers',
+                                         action => 'begin',
+                                         object => 'sudo_session' }
+        );
+    }
+    
+    # Do not try to start a new session if one is already in progress!
+    if (defined(Bugzilla->sudoer)) {
+        ThrowUserError('sudo_in_progress', { target => $user->login });
+    }
+
+    # Keep a temporary record of the user visiting this page
+    $vars->{'token'} = issue_session_token('sudo_prepared');
+
+    # Show the sudo page
+    $vars->{'target_login_default'} = $cgi->param('target_login');
+    $vars->{'reason_default'} = $cgi->param('reason');
+    $target = 'admin/sudo.html.tmpl';
+}
+# begin-sudo: Confirm login and start sudo session
+elsif ($action eq 'begin-sudo') {
+    # We must be sure that the user is authenticating by providing a login
+    # and password.
+    # We only need to do this for authentication methods that involve Bugzilla 
+    # directly obtaining a login (i.e. normal CGI login), as opposed to other 
+    # methods (like Environment vars login). 
+
+    # First, record if Bugzilla_login and Bugzilla_password were provided
+    my $credentials_provided;
+    if (defined($cgi->param('Bugzilla_login'))
+        && defined($cgi->param('Bugzilla_password')))
+    {
+        $credentials_provided = 1;
+    }
+    
+    # Next, log in the user
+    my $user = Bugzilla->login(LOGIN_REQUIRED);
+    
+    # At this point, the user is logged in.  However, if they used a method
+    # where they could have provided a username/password (i.e. CGI), but they 
+    # did not provide a username/password, then throw an error.
+    if ($user->authorizer->can_login && !$credentials_provided) {
+        ThrowUserError('sudo_password_required',
+                       { target_login => $cgi->param('target_login'),
+                               reason => $cgi->param('reason')});
+    }
+    
+    # The user must be in the 'bz_sudoers' group
+    unless ($user->in_group('bz_sudoers')) {
+        ThrowUserError('auth_failure', {  group => 'bz_sudoers',
+                                         action => 'begin',
+                                         object => 'sudo_session' }
+        );
+    }
+    
+    # Do not try to start a new session if one is already in progress!
+    if (defined(Bugzilla->sudoer)) {
+        ThrowUserError('sudo_in_progress', { target => $user->login });
+    }
+
+    # Did the user actually go trough the 'sudo-prepare' action?  Do some 
+    # checks on the token the action should have left.
+    my ($token_user, $token_timestamp, $token_data) =
+        Bugzilla::Token::GetTokenData($cgi->param('token'));
+    unless (defined($token_user)
+            && defined($token_data)
+            && ($token_user == $user->id)
+            && ($token_data eq 'sudo_prepared'))
+    {
+        ThrowUserError('sudo_preparation_required', 
+                       { target_login => scalar $cgi->param('target_login'),
+                               reason => scalar $cgi->param('reason')});
+    }
+    delete_token($cgi->param('token'));
+
+    # Get & verify the target user (the user who we will be impersonating)
+    my $target_user = 
+        new Bugzilla::User({ name => $cgi->param('target_login') });
+    unless (defined($target_user)
+            && $target_user->id
+            && $user->can_see_user($target_user))
+    {
+        ThrowUserError('user_match_failed',
+                       { 'name' => $cgi->param('target_login') }
+        );
+    }
+    if ($target_user->in_group('bz_sudo_protect')) {
+        ThrowUserError('sudo_protected', { login => $target_user->login });
+    }
+
+    # If we have a reason passed in, keep it under 200 characters
+    my $reason = $cgi->param('reason') || '';
+    $reason = substr($reason, 0, 200);
+    
+    # Calculate the session expiry time (T + 6 hours)
+    my $time_string = time2str('%a, %d-%b-%Y %T %Z', time + MAX_SUDO_TOKEN_AGE, 'GMT');
+
+    # For future sessions, store the unique ID of the target user
+    my $token = Bugzilla::Token::_create_token($user->id, 'sudo', $target_user->id);
+    $cgi->send_cookie('-name'    => 'sudo',
+                      '-expires' => $time_string,
+                      '-value'   => $token
+    );
+    
+    # For the present, change the values of Bugzilla::user & Bugzilla::sudoer
+    Bugzilla->sudo_request($target_user, $user);
+    
+    # NOTE: If you want to log the start of an sudo session, do it here.
+
+    # Go ahead and send out the message now
+    my $message;
+    my $mail_template = Bugzilla->template_inner($target_user->setting('lang'));
+    $mail_template->process('email/sudo.txt.tmpl', { reason => $reason }, \$message);
+    MessageToMTA($message);
+
+    $vars->{'message'} = 'sudo_started';
+    $vars->{'target'} = $target_user->login;
+    $target = 'global/message.html.tmpl';
+}
+# end-sudo: End the current sudo session (if one is in progress)
+elsif ($action eq 'end-sudo') {
+    # Regardless of our state, delete the sudo cookie if it exists
+    my $token = $cgi->cookie('sudo');
+    $cgi->remove_cookie('sudo');
+
+    # Are we in an sudo session?
+    Bugzilla->login(LOGIN_OPTIONAL);
+    my $sudoer = Bugzilla->sudoer;
+    if (defined($sudoer)) {
+        Bugzilla->sudo_request($sudoer, undef);
+    }
+    # Now that the session is over, remove the token from the DB.
+    delete_token($token);
+
+    # NOTE: If you want to log the end of an sudo session, so it here.
+    
+    $vars->{'message'} = 'sudo_ended';
+    $target = 'global/message.html.tmpl';
+}
+# No valid action found
+else {
+    Bugzilla->login(LOGIN_OPTIONAL);
+    ThrowUserError('unknown_action', {action => $action});
+}
+
+# Display the template
+print $cgi->header();
+$template->process($target, $vars)
+      || ThrowTemplateError($template->error());

diff --git a/report.cgi b/report.cgi
new file mode 100755 (executable)
index 0000000..f4f015b
--- /dev/null
+++ b/report.cgi
@@ -0,0 +1,396 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Field;
+use Bugzilla::Search;
+use Bugzilla::Report;
+use Bugzilla::Token;
+
+use List::MoreUtils qw(uniq);
+
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $vars = {};
+
+# Go straight back to query.cgi if we are adding a boolean chart.
+if (grep(/^cmd-/, $cgi->param())) {
+    my $params = $cgi->canonicalise_query("format", "ctype");
+    my $location = "query.cgi?format=" . $cgi->param('query_format') . 
+      ($params ? "&$params" : "");
+
+    print $cgi->redirect($location);
+    exit;
+}
+
+Bugzilla->login();
+my $action = $cgi->param('action') || 'menu';
+my $token  = $cgi->param('token');
+
+if ($action eq "menu") {
+    # No need to do any searching in this case, so bail out early.
+    print $cgi->header();
+    $template->process("reports/menu.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+
+}
+elsif ($action eq 'add') {
+    my $user = Bugzilla->login(LOGIN_REQUIRED);
+    check_hash_token($token, ['save_report']);
+
+    my $name = clean_text($cgi->param('name'));
+    my $query = $cgi->param('query');
+
+    if (my ($report) = grep{ lc($_->name) eq lc($name) } @{$user->reports}) {
+        $report->set_query($query);
+        $report->update;
+        $vars->{'message'} = "report_updated";
+    } else {
+        my $report = Bugzilla::Report->create({name => $name, query => $query});
+        $vars->{'message'} = "report_created";
+    }
+
+    $user->flush_reports_cache;
+
+    print $cgi->header();
+
+    $vars->{'reportname'} = $name;
+
+    $template->process("global/message.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+elsif ($action eq 'del') {
+    my $user = Bugzilla->login(LOGIN_REQUIRED);
+    my $report_id = $cgi->param('saved_report_id');
+    check_hash_token($token, ['delete_report', $report_id]);
+
+    my $report = Bugzilla::Report->check({id => $report_id});
+    $report->remove_from_db();
+
+    $user->flush_reports_cache;
+
+    print $cgi->header();
+
+    $vars->{'message'} = 'report_deleted';
+    $vars->{'reportname'} = $report->name;
+
+    $template->process("global/message.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+    exit;
+}
+
+# Sanitize the URL, to make URLs shorter.
+$cgi->clean_search_url;
+
+my $col_field = $cgi->param('x_axis_field') || '';
+my $row_field = $cgi->param('y_axis_field') || '';
+my $tbl_field = $cgi->param('z_axis_field') || '';
+
+if (!($col_field || $row_field || $tbl_field)) {
+    ThrowUserError("no_axes_defined");
+}
+
+# There is no UI for these parameters anymore,
+# but they are still here just in case.
+my $width = $cgi->param('width') || 1024;
+my $height = $cgi->param('height') || 600;
+
+(detaint_natural($width) && $width > 0)
+  || ThrowUserError("invalid_dimensions");
+$width <= 2000 || ThrowUserError("chart_too_large");
+
+(detaint_natural($height) && $height > 0)
+  || ThrowUserError("invalid_dimensions");
+$height <= 2000 || ThrowUserError("chart_too_large");
+
+my $formatparam = $cgi->param('format') || '';
+
+# These shenanigans are necessary to make sure that both vertical and 
+# horizontal 1D tables convert to the correct dimension when you ask to
+# display them as some sort of chart.
+if ($formatparam eq "table") {
+    if ($col_field && !$row_field) {    
+        # 1D *tables* should be displayed vertically (with a row_field only)
+        $row_field = $col_field;
+        $col_field = '';
+    }
+}
+else {
+    if (!Bugzilla->feature('graphical_reports')) {
+        ThrowUserError('feature_disabled', { feature => 'graphical_reports' });
+    }
+
+    if ($row_field && !$col_field) {
+        # 1D *charts* should be displayed horizontally (with an col_field only)
+        $col_field = $row_field;
+        $row_field = '';
+    }
+}
+
+# Valid bug fields that can be reported on.
+my $valid_columns = Bugzilla::Search::REPORT_COLUMNS;
+
+# Validate the values in the axis fields or throw an error.
+!$row_field 
+  || ($valid_columns->{$row_field} && trick_taint($row_field))
+  || ThrowUserError("report_axis_invalid", {fld => "x", val => $row_field});
+!$col_field 
+  || ($valid_columns->{$col_field} && trick_taint($col_field))
+  || ThrowUserError("report_axis_invalid", {fld => "y", val => $col_field});
+!$tbl_field 
+  || ($valid_columns->{$tbl_field} && trick_taint($tbl_field))
+  || ThrowUserError("report_axis_invalid", {fld => "z", val => $tbl_field});
+
+my @axis_fields = grep { $_ } ($row_field, $col_field, $tbl_field);
+
+# Clone the params, so that Bugzilla::Search can modify them
+my $params = new Bugzilla::CGI($cgi);
+my $search = new Bugzilla::Search(
+    fields => \@axis_fields, 
+    params => scalar $params->Vars,
+    allow_unlimited => 1,
+);
+
+$::SIG{TERM} = 'DEFAULT';
+$::SIG{PIPE} = 'DEFAULT';
+
+Bugzilla->switch_to_shadow_db();
+my ($results, $extra_data) = $search->data;
+
+# We have a hash of hashes for the data itself, and a hash to hold the 
+# row/col/table names.
+my %data;
+my %names;
+
+# Read the bug data and count the bugs for each possible value of row, column
+# and table.
+#
+# We detect a numerical field, and sort appropriately, if all the values are
+# numeric.
+my $col_isnumeric = 1;
+my $row_isnumeric = 1;
+my $tbl_isnumeric = 1;
+
+foreach my $result (@$results) {
+    # handle empty dimension member names
+    my $row = check_value($row_field, $result);
+    my $col = check_value($col_field, $result);
+    my $tbl = check_value($tbl_field, $result);
+
+    $data{$tbl}{$col}{$row}++;
+    $names{"col"}{$col}++;
+    $names{"row"}{$row}++;
+    $names{"tbl"}{$tbl}++;
+    
+    $col_isnumeric &&= ($col =~ /^-?\d+(\.\d+)?$/o);
+    $row_isnumeric &&= ($row =~ /^-?\d+(\.\d+)?$/o);
+    $tbl_isnumeric &&= ($tbl =~ /^-?\d+(\.\d+)?$/o);
+}
+
+my @col_names = get_names($names{"col"}, $col_isnumeric, $col_field);
+my @row_names = get_names($names{"row"}, $row_isnumeric, $row_field);
+my @tbl_names = get_names($names{"tbl"}, $tbl_isnumeric, $tbl_field);
+
+# The GD::Graph package requires a particular format of data, so once we've
+# gathered everything into the hashes and made sure we know the size of the
+# data, we reformat it into an array of arrays of arrays of data.
+push(@tbl_names, "-total-") if (scalar(@tbl_names) > 1);
+    
+my @image_data;
+foreach my $tbl (@tbl_names) {
+    my @tbl_data;
+    push(@tbl_data, \@col_names);
+    foreach my $row (@row_names) {
+        my @col_data;
+        foreach my $col (@col_names) {
+            $data{$tbl}{$col}{$row} = $data{$tbl}{$col}{$row} || 0;
+            push(@col_data, $data{$tbl}{$col}{$row});
+            if ($tbl ne "-total-") {
+                # This is a bit sneaky. We spend every loop except the last
+                # building up the -total- data, and then last time round,
+                # we process it as another tbl, and push() the total values 
+                # into the image_data array.
+                $data{"-total-"}{$col}{$row} += $data{$tbl}{$col}{$row};
+            }
+        }
+
+        push(@tbl_data, \@col_data);
+    }
+    
+    unshift(@image_data, \@tbl_data);
+}
+
+$vars->{'col_field'} = $col_field;
+$vars->{'row_field'} = $row_field;
+$vars->{'tbl_field'} = $tbl_field;
+$vars->{'time'} = localtime(time());
+
+$vars->{'col_names'} = \@col_names;
+$vars->{'row_names'} = \@row_names;
+$vars->{'tbl_names'} = \@tbl_names;
+
+# Below a certain width, we don't see any bars, so there needs to be a minimum.
+if ($formatparam eq "bar") {
+    my $min_width = (scalar(@col_names) || 1) * 20;
+
+    if (!$cgi->param('cumulate')) {
+        $min_width *= (scalar(@row_names) || 1);
+    }
+
+    $vars->{'min_width'} = $min_width;
+}
+
+$vars->{'width'} = $width;
+$vars->{'height'} = $height;
+$vars->{'queries'} = $extra_data;
+$vars->{'saved_report_id'} = $cgi->param('saved_report_id');
+
+if ($cgi->param('debug')
+    && Bugzilla->params->{debug_group}
+    && Bugzilla->user->in_group(Bugzilla->params->{debug_group})
+) {
+    $vars->{'debug'} = 1;
+}
+
+if ($action eq "wrap") {
+    # So which template are we using? If action is "wrap", we will be using
+    # no format (it gets passed through to be the format of the actual data),
+    # and either report.csv.tmpl (CSV), or report.html.tmpl (everything else).
+    # report.html.tmpl produces an HTML framework for either tables of HTML
+    # data, or images generated by calling report.cgi again with action as
+    # "plot".
+    $formatparam =~ s/[^a-zA-Z\-]//g;
+    $vars->{'format'} = $formatparam;
+    $formatparam = '';
+
+    # We need to keep track of the defined restrictions on each of the 
+    # axes, because buglistbase, below, throws them away. Without this, we
+    # get buglistlinks wrong if there is a restriction on an axis field.
+    $vars->{'col_vals'} = get_field_restrictions($col_field);
+    $vars->{'row_vals'} = get_field_restrictions($row_field);
+    $vars->{'tbl_vals'} = get_field_restrictions($tbl_field);
+
+    # We need a number of different variants of the base URL for different
+    # URLs in the HTML.
+    $vars->{'buglistbase'} = $cgi->canonicalise_query(
+                                 "x_axis_field", "y_axis_field", "z_axis_field",
+                               "ctype", "format", "query_format", @axis_fields);
+    $vars->{'imagebase'}   = $cgi->canonicalise_query( 
+                    $tbl_field, "action", "ctype", "format", "width", "height");
+    $vars->{'switchbase'}  = $cgi->canonicalise_query( 
+                "query_format", "action", "ctype", "format", "width", "height");
+    $vars->{'data'} = \%data;
+}
+elsif ($action eq "plot") {
+    # If action is "plot", we will be using a format as normal (pie, bar etc.)
+    # and a ctype as normal (currently only png.)
+    $vars->{'cumulate'} = $cgi->param('cumulate') ? 1 : 0;
+    $vars->{'x_labels_vertical'} = $cgi->param('x_labels_vertical') ? 1 : 0;
+    $vars->{'data'} = \@image_data;
+}
+else {
+    ThrowUserError('unknown_action', {action => $action});
+}
+
+my $format = $template->get_format("reports/report", $formatparam,
+                                   scalar($cgi->param('ctype')));
+
+# If we get a template or CGI error, it comes out as HTML, which isn't valid
+# PNG data, and the browser just displays a "corrupt PNG" message. So, you can
+# set debug=1 to always get an HTML content-type, and view the error.
+$format->{'ctype'} = "text/html" if $cgi->param('debug');
+
+my @time = localtime(time());
+my $date = sprintf "%04d-%02d-%02d", 1900+$time[5],$time[4]+1,$time[3];
+my $filename = "report-$date.$format->{extension}";
+print $cgi->header(-type => $format->{'ctype'},
+                   -content_disposition => "inline; filename=$filename");
+
+# Problems with this CGI are often due to malformed data. Setting debug=1
+# prints out both data structures.
+if ($cgi->param('debug')) {
+    require Data::Dumper;
+    say "<pre>data hash:";
+    say html_quote(Data::Dumper::Dumper(%data));
+    say "\ndata array:";
+    say html_quote(Data::Dumper::Dumper(@image_data)) . "\n\n</pre>";
+}
+
+# All formats point to the same section of the documentation.
+$vars->{'doc_section'} = 'reporting.html#reports';
+
+disable_utf8() if ($format->{'ctype'} =~ /^image\//);
+
+$template->process("$format->{'template'}", $vars)
+  || ThrowTemplateError($template->error());
+
+
+sub get_names {
+    my ($names, $isnumeric, $field_name) = @_;
+    my ($field, @sorted);
+    # XXX - This is a hack to handle the actual_time/work_time field,
+    # because it's named 'actual_time' in Search.pm but 'work_time' in Field.pm.
+    $_[2] = $field_name = 'work_time' if $field_name eq 'actual_time';
+
+    # _realname fields aren't real Bugzilla::Field objects, but they are a
+    # valid axis, so we don't vailidate them as Bugzilla::Field objects.
+    $field = Bugzilla::Field->check($field_name) 
+        if ($field_name && $field_name !~ /_realname$/);
+    
+    if ($field && $field->is_select) {
+        foreach my $value (@{$field->legal_values}) {
+            push(@sorted, $value->name) if $names->{$value->name};
+        }
+        unshift(@sorted, '---') if $field_name eq 'resolution';
+        @sorted = uniq @sorted;
+    }  
+    elsif ($isnumeric) {
+        # It's not a field we are preserving the order of, so sort it 
+        # numerically...
+        @sorted = sort { $a <=> $b } keys %$names;
+    }
+    else {
+        # ...or alphabetically, as appropriate.
+        @sorted = sort keys %$names;
+    }
+    
+    return @sorted;
+}
+
+sub check_value {
+    my ($field, $result) = @_;
+
+    my $value;
+    if (!defined $field) {
+        $value = '';
+    }
+    elsif ($field eq '') {
+        $value = ' ';
+    }
+    else {
+        $value = shift @$result;
+        $value = ' ' if (!defined $value || $value eq '');
+        $value = '---' if ($field eq 'resolution' && $value eq ' ');
+    }
+    return $value;
+}
+
+sub get_field_restrictions {
+    my $field = shift;
+    my $cgi = Bugzilla->cgi;
+
+    return join('&amp;', map {url_quote($field) . '=' . url_quote($_)} $cgi->param($field));
+}

diff --git a/reports.cgi b/reports.cgi
new file mode 100755 (executable)
index 0000000..a2e1e6a
--- /dev/null
+++ b/reports.cgi
@@ -0,0 +1,223 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Status;
+
+use File::Basename;
+use Digest::SHA qw(hmac_sha256_base64);
+
+# If we're using bug groups for products, we should apply those restrictions
+# to viewing reports, as well.  Time to check the login in that case.
+my $user = Bugzilla->login();
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $vars = {};
+
+if (!Bugzilla->feature('old_charts')) {
+    ThrowUserError('feature_disabled', { feature => 'old_charts' });
+}
+
+my $dir       = bz_locations()->{'datadir'} . "/mining";
+my $graph_dir = bz_locations()->{'graphsdir'};
+my $graph_url = basename($graph_dir);
+my $product_name = $cgi->param('product') || '';
+
+Bugzilla->switch_to_shadow_db();
+
+if (!$product_name) {
+    # Can we do bug charts?
+    (-d $dir && -d $graph_dir) 
+      || ThrowCodeError('chart_dir_nonexistent',
+                        {dir => $dir, graph_dir => $graph_dir});
+
+    my %default_sel = map { $_ => 1 } BUG_STATE_OPEN;
+
+    my @datasets;
+    my @data = get_data($dir);
+
+    foreach my $dataset (@data) {
+        my $datasets = {};
+        $datasets->{'value'} = $dataset;
+        $datasets->{'selected'} = $default_sel{$dataset} ? 1 : 0;
+        push(@datasets, $datasets);
+    }
+
+    # We only want those products that the user has permissions for.
+    my @myproducts = ('-All-');
+    # Extract product names from objects and add them to the list.
+    push( @myproducts, map { $_->name } @{$user->get_selectable_products} );
+
+    $vars->{'datasets'} = \@datasets;
+    $vars->{'products'} = \@myproducts;
+
+    print $cgi->header();
+}
+else {
+    # For security and correctness, validate the value of the "product" form variable.
+    # Valid values are those products for which the user has permissions which appear
+    # in the "product" drop-down menu on the report generation form.
+    my ($product) = grep { $_->name eq $product_name } @{$user->get_selectable_products};
+    ($product || $product_name eq '-All-')
+      || ThrowUserError('invalid_product_name', {product => $product_name});
+
+    # Product names can change over time. Their ID cannot; so use the ID
+    # to generate the filename.
+    my $prod_id = $product ? $product->id : 0;
+
+    # Make sure there is something to plot.
+    my @datasets = $cgi->param('datasets');
+    scalar(@datasets) || ThrowUserError('missing_datasets');
+
+    if (grep { $_ !~ /^[A-Za-z0-9:_-]+$/ } @datasets) {
+        ThrowUserError('invalid_datasets', {'datasets' => \@datasets});
+    }
+
+    # Filenames must not be guessable as they can point to products
+    # you are not allowed to see. Also, different projects can have
+    # the same product names.
+    my $project = bz_locations()->{'project'} || '';
+    my $image_file =  join(':', ($project, $prod_id, @datasets));
+    my $key = Bugzilla->localconfig->{'site_wide_secret'};
+    $image_file = hmac_sha256_base64($image_file, $key) . '.png';
+    $image_file =~ s/\+/-/g;
+    $image_file =~ s/\//_/g;
+    trick_taint($image_file);
+
+    if (! -e "$graph_dir/$image_file") {
+        generate_chart($dir, "$graph_dir/$image_file", $product, \@datasets);
+    }
+
+    $vars->{'url_image'} = "$graph_url/$image_file";
+
+    print $cgi->header(-Content_Disposition=>'inline; filename=bugzilla_report.html');
+}
+
+$template->process('reports/old-charts.html.tmpl', $vars)
+  || ThrowTemplateError($template->error());
+
+#####################
+#    Subroutines    #
+#####################
+
+sub get_data {
+    my $dir = shift;
+
+    my @datasets;
+    open(DATA, '<', "$dir/-All-")
+      || ThrowCodeError('chart_file_open_fail', {filename => "$dir/-All-"});
+
+    while (<DATA>) {
+        if (/^# fields?: (.+)\s*$/) {
+            @datasets = grep ! /date/i, (split /\|/, $1);
+            last;
+        }
+    }
+    close(DATA);
+    return @datasets;
+}
+
+sub generate_chart {
+    my ($dir, $image_file, $product, $datasets) = @_;
+    $product = $product ? $product->name : '-All-';
+    my $data_file = $product;
+    $data_file =~ s/\//-/gs;
+    $data_file = $dir . '/' . $data_file;
+
+    if (! open FILE, $data_file) {
+        if ($product eq '-All-') {
+            $product = '';
+        }
+        ThrowCodeError('chart_data_not_generated', {'product' => $product});
+    }
+
+    my @fields;
+    my @labels = qw(DATE);
+    my %datasets = map { $_ => 1 } @$datasets;
+
+    my %data = ();
+    while (<FILE>) {
+        chomp;
+        next unless $_;
+        if (/^#/) {
+            if (/^# fields?: (.*)\s*$/) {
+                @fields = split /\||\r/, $1;
+                $data{$_} ||= [] foreach @fields;
+                unless ($fields[0] =~ /date/i) {
+                    ThrowCodeError('chart_datafile_corrupt', {'file' => $data_file});
+                }
+                push @labels, grep($datasets{$_}, @fields);
+            }
+            next;
+        }
+
+        unless (@fields) {
+            ThrowCodeError('chart_datafile_corrupt', {'file' => $data_file});
+        }
+
+        my @line = split /\|/;
+        my $date = $line[0];
+        my ($yy, $mm, $dd) = $date =~ /^\d{2}(\d{2})(\d{2})(\d{2})$/;
+        push @{$data{DATE}}, "$mm/$dd/$yy";
+        
+        for my $i (1 .. $#fields) {
+            my $field = $fields[$i];
+            if (! defined $line[$i] or $line[$i] eq '') {
+                # no data point given, don't plot (this will probably
+                # generate loads of Chart::Base warnings, but that's not
+                # our fault.)
+                push @{$data{$field}}, undef;
+            }
+            else {
+                push @{$data{$field}}, $line[$i];
+            }
+        }
+    }
+    
+    shift @labels;
+
+    close FILE;
+
+    if (! @{$data{DATE}}) {
+        ThrowUserError('insufficient_data_points');
+    }
+
+    my $img = Chart::Lines->new (800, 600);
+    my $i = 0;
+
+    my $MAXTICKS = 20;      # Try not to show any more x ticks than this.
+    my $skip = 1;
+    if (@{$data{DATE}} > $MAXTICKS) {
+        $skip = int((@{$data{DATE}} + $MAXTICKS - 1) / $MAXTICKS);
+    }
+
+    my %settings =
+        (
+         "title" => "Status Counts for $product",
+         "x_label" => "Dates",
+         "y_label" => "Bug Counts",
+         "legend_labels" => \@labels,
+         "skip_x_ticks" => $skip,
+         "y_grid_lines" => "true",
+         "grey_background" => "false",
+         "colors" => {
+                      # default dataset colours are too alike
+                      dataset4 => [0, 0, 0], # black
+                     },
+        );
+    
+    $img->set (%settings);
+    $img->png($image_file, [ @data{('DATE', @labels)} ]);
+}

diff --git a/request.cgi b/request.cgi
new file mode 100755 (executable)
index 0000000..3bae8c0
--- /dev/null
+++ b/request.cgi
@@ -0,0 +1,346 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+################################################################################
+# Script Initialization
+################################################################################
+
+# Make it harder for us to do dangerous things in Perl.
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Flag;
+use Bugzilla::FlagType;
+use Bugzilla::User;
+use Bugzilla::Product;
+use Bugzilla::Component;
+
+# Make sure the user is logged in.
+my $user = Bugzilla->login();
+my $cgi = Bugzilla->cgi;
+# Force the script to run against the shadow DB. We already validated credentials.
+Bugzilla->switch_to_shadow_db;
+my $template = Bugzilla->template;
+my $action = $cgi->param('action') || '';
+
+print $cgi->header();
+
+################################################################################
+# Main Body Execution
+################################################################################
+
+my $fields;
+$fields->{'requester'}->{'type'} = 'single';
+# If the user doesn't restrict his search to requests from the wind
+# (requestee ne '-'), include the requestee for completion.
+unless (defined $cgi->param('requestee')
+        && $cgi->param('requestee') eq '-')
+{
+    $fields->{'requestee'}->{'type'} = 'single';
+}
+
+Bugzilla::User::match_field($fields);
+
+if ($action eq 'queue') {
+    queue();
+}
+else {
+    my $flagtypes = get_flag_types();
+    my @types = ('all', @$flagtypes);
+
+    my $vars = {};
+    $vars->{'types'} = \@types;
+    $vars->{'requests'} = {};
+
+    my %components;
+    foreach my $prod (@{$user->get_selectable_products}) {
+        foreach my $comp (@{$prod->components}) {
+            $components{$comp->name} = 1;
+        }
+    }
+    $vars->{'components'} = [ sort { $a cmp $b } keys %components ];
+
+    $template->process('request/queue.html.tmpl', $vars)
+      || ThrowTemplateError($template->error());
+}
+exit;
+
+################################################################################
+# Functions
+################################################################################
+
+sub queue {
+    my $cgi = Bugzilla->cgi;
+    my $dbh = Bugzilla->dbh;
+    my $template = Bugzilla->template;
+    my $user = Bugzilla->user;
+    my $userid = $user->id;
+    my $vars = {};
+
+    my $status = validateStatus($cgi->param('status'));
+    my $form_group = validateGroup($cgi->param('group'));
+
+    my $query = 
+    # Select columns describing each flag, the bug/attachment on which
+    # it has been set, who set it, and of whom they are requesting it.
+    " SELECT    flags.id, flagtypes.name,
+                flags.status,
+                flags.bug_id, bugs.short_desc,
+                products.name, components.name,
+                flags.attach_id, attachments.description,
+                requesters.realname, requesters.login_name,
+                requestees.realname, requestees.login_name, COUNT(privs.group_id),
+    " . $dbh->sql_date_format('flags.modification_date', '%Y.%m.%d %H:%i') .
+    # Use the flags and flagtypes tables for information about the flags,
+    # the bugs and attachments tables for target info, the profiles tables
+    # for setter and requestee info, the products/components tables
+    # so we can display product and component names, and the bug_group_map
+    # table to help us weed out secure bugs to which the user should not have
+    # access.
+    "
+      FROM           flags 
+           LEFT JOIN attachments
+                  ON flags.attach_id = attachments.attach_id
+          INNER JOIN flagtypes
+                  ON flags.type_id = flagtypes.id
+          INNER JOIN profiles AS requesters
+                  ON flags.setter_id = requesters.userid
+           LEFT JOIN profiles AS requestees
+                  ON flags.requestee_id  = requestees.userid
+          INNER JOIN bugs
+                  ON flags.bug_id = bugs.bug_id
+          INNER JOIN products
+                  ON bugs.product_id = products.id
+          INNER JOIN components
+                  ON bugs.component_id = components.id
+           LEFT JOIN bug_group_map AS bgmap
+                  ON bgmap.bug_id = bugs.bug_id
+                 AND bgmap.group_id NOT IN (" .
+                     $user->groups_as_string . ")
+           LEFT JOIN bug_group_map AS privs
+                  ON privs.bug_id = bugs.bug_id
+           LEFT JOIN cc AS ccmap
+                  ON ccmap.who = $userid
+                 AND ccmap.bug_id = bugs.bug_id
+    " .
+
+    # Weed out bug the user does not have access to
+    " WHERE     ((bgmap.group_id IS NULL) OR
+                 (ccmap.who IS NOT NULL AND cclist_accessible = 1) OR
+                 (bugs.reporter = $userid AND bugs.reporter_accessible = 1) OR
+                 (bugs.assigned_to = $userid) " .
+                 (Bugzilla->params->{'useqacontact'} ? "OR
+                 (bugs.qa_contact = $userid))" : ")");
+
+    unless ($user->is_insider) {
+        $query .= " AND (attachments.attach_id IS NULL
+                         OR attachments.isprivate = 0
+                         OR attachments.submitter_id = $userid)";
+    }
+
+    # Limit query to pending requests.
+    $query .= " AND flags.status = '?' " unless $status;
+
+    # The set of criteria by which we filter records to display in the queue.
+    my @criteria = ();
+
+    # A list of columns to exclude from the report because the report conditions
+    # limit the data being displayed to exact matches for those columns.
+    # In other words, if we are only displaying "pending" , we don't
+    # need to display a "status" column in the report because the value for that
+    # column will always be the same.
+    my @excluded_columns = ();
+    
+    my $do_union = $cgi->param('do_union');
+
+    # Filter requests by status: "pending", "granted", "denied", "all" 
+    # (which means any), or "fulfilled" (which means "granted" or "denied").
+    if ($status) {
+        if ($status eq "+-") {
+            push(@criteria, "flags.status IN ('+', '-')");
+            push(@excluded_columns, 'status') unless $do_union;
+        }
+        elsif ($status ne "all") {
+            push(@criteria, "flags.status = '$status'");
+            push(@excluded_columns, 'status') unless $do_union;
+        }
+    }
+    
+    # Filter results by exact email address of requester or requestee.
+    if (defined $cgi->param('requester') && $cgi->param('requester') ne "") {
+        my $requester = $dbh->quote($cgi->param('requester'));
+        trick_taint($requester); # Quoted above
+        push(@criteria, $dbh->sql_istrcmp('requesters.login_name', $requester));
+        push(@excluded_columns, 'requester') unless $do_union;
+    }
+    if (defined $cgi->param('requestee') && $cgi->param('requestee') ne "") {
+        if ($cgi->param('requestee') ne "-") {
+            my $requestee = $dbh->quote($cgi->param('requestee'));
+            trick_taint($requestee); # Quoted above
+            push(@criteria, $dbh->sql_istrcmp('requestees.login_name',
+                            $requestee));
+        }
+        else { push(@criteria, "flags.requestee_id IS NULL") }
+        push(@excluded_columns, 'requestee') unless $do_union;
+    }
+    
+    # Filter results by exact product or component.
+    if (defined $cgi->param('product') && $cgi->param('product') ne "") {
+        my $product = Bugzilla::Product->check(scalar $cgi->param('product'));
+        push(@criteria, "bugs.product_id = " . $product->id);
+        push(@excluded_columns, 'product') unless $do_union;
+        if (defined $cgi->param('component') && $cgi->param('component') ne "") {
+            my $component = Bugzilla::Component->check({ product => $product,
+                                                         name => scalar $cgi->param('component') });
+            push(@criteria, "bugs.component_id = " . $component->id);
+            push(@excluded_columns, 'component') unless $do_union;
+        }
+    }
+
+    # Filter results by flag types.
+    my $form_type = $cgi->param('type');
+    if (defined $form_type && !grep($form_type eq $_, ("", "all"))) {
+        # Check if any matching types are for attachments.  If not, don't show
+        # the attachment column in the report.
+        my $has_attachment_type =
+            Bugzilla::FlagType::count({ 'name' => $form_type,
+                                        'target_type' => 'attachment' });
+
+        if (!$has_attachment_type) { push(@excluded_columns, 'attachment') }
+
+        my $quoted_form_type = $dbh->quote($form_type);
+        trick_taint($quoted_form_type); # Already SQL quoted
+        push(@criteria, "flagtypes.name = " . $quoted_form_type);
+        push(@excluded_columns, 'type') unless $do_union;
+    }
+    
+    # Add the criteria to the query. Do a union if OR is selected.
+    # Otherwise do an intersection.
+    my $and_or = $do_union ? ' OR ' : ' AND ';
+    $query .= " AND (" . join($and_or, @criteria) . ") " if scalar(@criteria);
+    
+    # Group the records by flag ID so we don't get multiple rows of data
+    # for each flag.  This is only necessary because of the code that
+    # removes flags on bugs the user is unauthorized to access.
+    $query .= ' ' . $dbh->sql_group_by('flags.id',
+               'flagtypes.name, flags.status, flags.bug_id, bugs.short_desc,
+                products.name, components.name, flags.attach_id,
+                attachments.description, requesters.realname,
+                requesters.login_name, requestees.realname,
+                requestees.login_name, flags.modification_date,
+                cclist_accessible, bugs.reporter, bugs.reporter_accessible,
+                bugs.assigned_to');
+
+    # Group the records, in other words order them by the group column
+    # so the loop in the display template can break them up into separate
+    # tables every time the value in the group column changes.
+
+    $form_group ||= "requestee";
+    if ($form_group eq "requester") {
+        $query .= " ORDER BY requesters.realname, requesters.login_name";
+    }
+    elsif ($form_group eq "requestee") {
+        $query .= " ORDER BY requestees.realname, requestees.login_name";
+    }
+    elsif ($form_group eq "category") {
+        $query .= " ORDER BY products.name, components.name";
+    }
+    elsif ($form_group eq "type") {
+        $query .= " ORDER BY flagtypes.name";
+    }
+
+    # Order the records (within each group).
+    $query .= " , flags.modification_date";
+
+    # Pass the query to the template for use when debugging this script.
+    $vars->{'query'} = $query;
+    $vars->{'debug'} = $cgi->param('debug') ? 1 : 0;
+
+    my $results = $dbh->selectall_arrayref($query);
+    my @requests = ();
+    foreach my $result (@$results) {
+        my @data = @$result;
+        my $request = {
+          'id'              => $data[0] , 
+          'type'            => $data[1] , 
+          'status'          => $data[2] , 
+          'bug_id'          => $data[3] , 
+          'bug_summary'     => $data[4] , 
+          'category'        => "$data[5]: $data[6]" , 
+          'attach_id'       => $data[7] , 
+          'attach_summary'  => $data[8] ,
+          'requester'       => ($data[9] ? "$data[9] <$data[10]>" : $data[10]) , 
+          'requestee'       => ($data[11] ? "$data[11] <$data[12]>" : $data[12]) , 
+          'restricted'      => $data[13] ? 1 : 0,
+          'created'         => $data[14]
+        };
+        push(@requests, $request);
+    }
+
+    # Get a list of request type names to use in the filter form.
+    my @types = ("all");
+    my $flagtypes = get_flag_types();
+    push(@types, @$flagtypes);
+
+    $vars->{'excluded_columns'} = \@excluded_columns;
+    $vars->{'group_field'} = $form_group;
+    $vars->{'requests'} = \@requests;
+    $vars->{'types'} = \@types;
+
+    my %components;
+    foreach my $prod (@{$user->get_selectable_products}) {
+        foreach my $comp (@{$prod->components}) {
+            $components{$comp->name} = 1;
+        }
+    }
+    $vars->{'components'} = [ sort { $a cmp $b } keys %components ];
+
+    # Generate and return the UI (HTML page) from the appropriate template.
+    $template->process("request/queue.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+}
+
+################################################################################
+# Data Validation / Security Authorization
+################################################################################
+
+sub validateStatus {
+    my $status = shift;
+    return if !defined $status;
+
+    grep($status eq $_, qw(? +- + - all))
+      || ThrowUserError("flag_status_invalid", { status => $status });
+    trick_taint($status);
+    return $status;
+}
+
+sub validateGroup {
+    my $group = shift;
+    return if !defined $group;
+
+    grep($group eq $_, qw(requester requestee category type))
+      || ThrowUserError("request_queue_group_invalid", { group => $group });
+    trick_taint($group);
+    return $group;
+}
+
+# Returns all flag types which have at least one flag of this type.
+# If a flag type is inactive but still has flags, we want it.
+sub get_flag_types {
+    my $dbh = Bugzilla->dbh;
+    my $flag_types = $dbh->selectcol_arrayref('SELECT DISTINCT name
+                                                 FROM flagtypes
+                                                WHERE flagtypes.id IN
+                                                      (SELECT DISTINCT type_id FROM flags)
+                                             ORDER BY name');
+    return $flag_types;
+}

diff --git a/robots.txt b/robots.txt
new file mode 100644 (file)
index 0000000..0f823cb
--- /dev/null
+++ b/robots.txt
@@ -0,0 +1,3 @@
+User-agent: *
+Allow: /index.cgi
+Disallow: /

diff --git a/runtests.pl b/runtests.pl
new file mode 100755 (executable)
index 0000000..09963e8
--- /dev/null
+++ b/runtests.pl
@@ -0,0 +1,28 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# Make it harder for us to do dangerous things in Perl.
+use diagnostics;
+use strict;
+use lib qw(lib);
+
+use Test::Harness qw(&runtests $verbose);
+
+$verbose = 0;
+my $onlytest = "";
+
+foreach (@ARGV) {
+    if (/^(?:-v|--verbose)$/) {
+        $verbose = 1;
+    }
+    else {
+        $onlytest = sprintf("%0.3d",$_);
+    }
+}
+
+runtests(glob("t/$onlytest*.t"));

diff --git a/sanitycheck.cgi b/sanitycheck.cgi
new file mode 100755 (executable)
index 0000000..0e6f7cc
--- /dev/null
+++ b/sanitycheck.cgi
@@ -0,0 +1,925 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Bug;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Hook;
+use Bugzilla::Util;
+use Bugzilla::Status;
+use Bugzilla::Token;
+
+###########################################################################
+# General subs
+###########################################################################
+
+sub get_string {
+    my ($san_tag, $vars) = @_;
+    $vars->{'san_tag'} = $san_tag;
+    return get_text('sanitycheck', $vars);
+}
+
+sub Status {
+    my ($san_tag, $vars, $alert) = @_;
+    my $cgi = Bugzilla->cgi;
+    return if (!$alert && Bugzilla->usage_mode == USAGE_MODE_CMDLINE && !$cgi->param('verbose'));
+
+    if (Bugzilla->usage_mode == USAGE_MODE_CMDLINE) {
+        my $output = $cgi->param('output') || '';
+        my $linebreak = $alert ? "\nALERT: " : "\n";
+        $cgi->param('error_found', 1) if $alert;
+        $cgi->param('output', $output . $linebreak . get_string($san_tag, $vars));
+    }
+    else {
+        my $start_tag = $alert ? '<p class="alert">' : '<p>';
+        say $start_tag . get_string($san_tag, $vars) . "</p>";
+    }
+}
+
+###########################################################################
+# Start
+###########################################################################
+
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+my $cgi = Bugzilla->cgi;
+my $dbh = Bugzilla->dbh;
+# If the result of the sanity check is sent per email, then we have to
+# take the user prefs into account rather than querying the web browser.
+my $template;
+if (Bugzilla->usage_mode == USAGE_MODE_CMDLINE) {
+    $template = Bugzilla->template_inner($user->setting('lang'));
+}
+else {
+    $template = Bugzilla->template;
+
+    # Only check the token if we are running this script from the
+    # web browser and a parameter is passed to the script.
+    # XXX - Maybe these two parameters should be deleted once logged in?
+    $cgi->delete('GoAheadAndLogIn', 'Bugzilla_restrictlogin');
+    if (scalar($cgi->param())) {
+        my $token = $cgi->param('token');
+        check_hash_token($token, ['sanitycheck']);
+    }
+}
+my $vars = {};
+
+print $cgi->header() unless Bugzilla->usage_mode == USAGE_MODE_CMDLINE;
+
+# Make sure the user is authorized to access sanitycheck.cgi.
+# As this script can now alter the group_control_map table, we no longer
+# let users with editbugs privs run it anymore.
+$user->in_group("editcomponents")
+  || ThrowUserError("auth_failure", {group  => "editcomponents",
+                                     action => "run",
+                                     object => "sanity_check"});
+
+unless (Bugzilla->usage_mode == USAGE_MODE_CMDLINE) {
+    $template->process('admin/sanitycheck/list.html.tmpl', $vars)
+      || ThrowTemplateError($template->error());
+}
+
+###########################################################################
+# Create missing group_control_map entries
+###########################################################################
+
+if ($cgi->param('createmissinggroupcontrolmapentries')) {
+    Status('group_control_map_entries_creation');
+
+    my $na    = CONTROLMAPNA;
+    my $shown = CONTROLMAPSHOWN;
+    my $insertsth = $dbh->prepare(
+        qq{INSERT INTO group_control_map
+                       (group_id, product_id, membercontrol, othercontrol)
+                VALUES (?, ?, $shown, $na)});
+
+    my $updatesth = $dbh->prepare(qq{UPDATE group_control_map
+                                        SET membercontrol = $shown
+                                      WHERE group_id   = ?
+                                        AND product_id = ?});
+    my $counter = 0;
+
+    # Find all group/product combinations used for bugs but not set up
+    # correctly in group_control_map
+    my $invalid_combinations = $dbh->selectall_arrayref(
+        qq{    SELECT bugs.product_id,
+                      bgm.group_id,
+                      gcm.membercontrol,
+                      groups.name,
+                      products.name
+                 FROM bugs
+           INNER JOIN bug_group_map AS bgm
+                   ON bugs.bug_id = bgm.bug_id
+           INNER JOIN groups
+                   ON bgm.group_id = groups.id
+           INNER JOIN products
+                   ON bugs.product_id = products.id
+            LEFT JOIN group_control_map AS gcm
+                   ON bugs.product_id = gcm.product_id
+                  AND    bgm.group_id = gcm.group_id
+                WHERE COALESCE(gcm.membercontrol, $na) = $na
+          } . $dbh->sql_group_by('bugs.product_id, bgm.group_id',
+                                 'gcm.membercontrol, groups.name, products.name'));
+
+    foreach (@$invalid_combinations) {
+        my ($product_id, $group_id, $currentmembercontrol,
+            $group_name, $product_name) = @$_;
+
+        $counter++;
+        if (defined($currentmembercontrol)) {
+            Status('group_control_map_entries_update',
+                   {group_name => $group_name, product_name => $product_name});
+            $updatesth->execute($group_id, $product_id);
+        }
+        else {
+            Status('group_control_map_entries_generation',
+                   {group_name => $group_name, product_name => $product_name});
+            $insertsth->execute($group_id, $product_id);
+        }
+    }
+
+    Status('group_control_map_entries_repaired', {counter => $counter});
+}
+
+###########################################################################
+# Fix missing creation date
+###########################################################################
+
+if ($cgi->param('repair_creation_date')) {
+    Status('bug_creation_date_start');
+
+    my $bug_ids = $dbh->selectcol_arrayref('SELECT bug_id FROM bugs
+                                            WHERE creation_ts IS NULL');
+
+    my $sth_UpdateDate = $dbh->prepare('UPDATE bugs SET creation_ts = ?
+                                        WHERE bug_id = ?');
+
+    # All bugs have an entry in the 'longdescs' table when they are created,
+    # even if no comment is required.
+    my $sth_getDate = $dbh->prepare('SELECT MIN(bug_when) FROM longdescs
+                                     WHERE bug_id = ?');
+
+    foreach my $bugid (@$bug_ids) {
+        $sth_getDate->execute($bugid);
+        my $date = $sth_getDate->fetchrow_array;
+        $sth_UpdateDate->execute($date, $bugid);
+    }
+    Status('bug_creation_date_fixed', {bug_count => scalar(@$bug_ids)});
+}
+
+###########################################################################
+# Fix everconfirmed
+###########################################################################
+
+if ($cgi->param('repair_everconfirmed')) {
+    Status('everconfirmed_start');
+
+    my @confirmed_open_states = grep {$_ ne 'UNCONFIRMED'} BUG_STATE_OPEN;
+    my $confirmed_open_states = join(', ', map {$dbh->quote($_)} @confirmed_open_states);
+
+    $dbh->do("UPDATE bugs SET everconfirmed = 0 WHERE bug_status = 'UNCONFIRMED'");
+    $dbh->do("UPDATE bugs SET everconfirmed = 1 WHERE bug_status IN ($confirmed_open_states)");
+
+    Status('everconfirmed_end');
+}
+
+###########################################################################
+# Fix entries in Bugs full_text
+###########################################################################
+
+if ($cgi->param('repair_bugs_fulltext')) {
+    Status('bugs_fulltext_start');
+
+    my $bug_ids = $dbh->selectcol_arrayref('SELECT bugs.bug_id
+                                            FROM bugs
+                                            LEFT JOIN bugs_fulltext
+                                            ON bugs_fulltext.bug_id = bugs.bug_id
+                                            WHERE bugs_fulltext.bug_id IS NULL');
+
+   foreach my $bugid (@$bug_ids) {
+       Bugzilla::Bug->new($bugid)->_sync_fulltext( new_bug => 1 );
+   }
+
+   Status('bugs_fulltext_fixed', {bug_count => scalar(@$bug_ids)});
+}
+
+###########################################################################
+# Send unsent mail
+###########################################################################
+
+if ($cgi->param('rescanallBugMail')) {
+    require Bugzilla::BugMail;
+
+    Status('send_bugmail_start');
+    my $time = $dbh->sql_date_math('NOW()', '-', 30, 'MINUTE');
+
+    my $list = $dbh->selectcol_arrayref(qq{
+                                        SELECT bug_id
+                                          FROM bugs 
+                                         WHERE (lastdiffed IS NULL
+                                                OR lastdiffed < delta_ts)
+                                           AND delta_ts < $time
+                                      ORDER BY bug_id});
+
+    Status('send_bugmail_status', {bug_count => scalar(@$list)});
+
+    # We cannot simply look at the bugs_activity table to find who did the
+    # last change in a given bug, as e.g. adding a comment doesn't add any
+    # entry to this table. And some other changes may be private
+    # (such as time-related changes or private attachments or comments)
+    # and so choosing this user as being the last one having done a change
+    # for the bug may be problematic. So the best we can do at this point
+    # is to choose the currently logged in user for email notification.
+    $vars->{'changer'} = $user;
+
+    foreach my $bugid (@$list) {
+        Bugzilla::BugMail::Send($bugid, $vars);
+    }
+
+    Status('send_bugmail_end') if scalar(@$list);
+
+    unless (Bugzilla->usage_mode == USAGE_MODE_CMDLINE) {
+        $template->process('global/footer.html.tmpl', $vars)
+          || ThrowTemplateError($template->error());
+    }
+    exit;
+}
+
+###########################################################################
+# Remove all references to deleted bugs
+###########################################################################
+
+if ($cgi->param('remove_invalid_bug_references')) {
+    Status('bug_reference_deletion_start');
+
+    $dbh->bz_start_transaction();
+
+    foreach my $pair ('attachments/', 'bug_group_map/', 'bugs_activity/',
+                      'bugs_fulltext/', 'cc/',
+                      'dependencies/blocked', 'dependencies/dependson',
+                      'duplicates/dupe', 'duplicates/dupe_of',
+                      'flags/', 'keywords/', 'longdescs/') {
+
+        my ($table, $field) = split('/', $pair);
+        $field ||= "bug_id";
+
+        my $bug_ids =
+          $dbh->selectcol_arrayref("SELECT $table.$field FROM $table
+                                    LEFT JOIN bugs ON $table.$field = bugs.bug_id
+                                    WHERE bugs.bug_id IS NULL");
+
+        if (scalar(@$bug_ids)) {
+            $dbh->do("DELETE FROM $table WHERE $field IN (" . join(',', @$bug_ids) . ")");
+        }
+    }
+
+    $dbh->bz_commit_transaction();
+    Status('bug_reference_deletion_end');
+}
+
+###########################################################################
+# Remove all references to deleted attachments
+###########################################################################
+
+if ($cgi->param('remove_invalid_attach_references')) {
+    Status('attachment_reference_deletion_start');
+
+    $dbh->bz_start_transaction();
+
+    my $attach_ids =
+        $dbh->selectcol_arrayref('SELECT attach_data.id
+                                    FROM attach_data
+                               LEFT JOIN attachments
+                                      ON attachments.attach_id = attach_data.id
+                                   WHERE attachments.attach_id IS NULL');
+
+    if (scalar(@$attach_ids)) {
+        $dbh->do('DELETE FROM attach_data WHERE id IN (' .
+                 join(',', @$attach_ids) . ')');
+    }
+
+    $dbh->bz_commit_transaction();
+    Status('attachment_reference_deletion_end');
+}
+
+###########################################################################
+# Remove all references to deleted users or groups from whines
+###########################################################################
+
+if ($cgi->param('remove_old_whine_targets')) {
+    Status('whines_obsolete_target_deletion_start');
+
+    $dbh->bz_start_transaction();
+
+    foreach my $target (['groups', 'id', MAILTO_GROUP],
+                        ['profiles', 'userid', MAILTO_USER])
+    {
+        my ($table, $col, $type) = @$target;
+        my $old_ids =
+          $dbh->selectcol_arrayref("SELECT DISTINCT mailto
+                                      FROM whine_schedules
+                                 LEFT JOIN $table
+                                        ON $table.$col = whine_schedules.mailto
+                                     WHERE mailto_type = $type AND $table.$col IS NULL");
+
+        if (scalar(@$old_ids)) {
+            $dbh->do("DELETE FROM whine_schedules
+                       WHERE mailto_type = $type AND mailto IN (" .
+                       join(',', @$old_ids) . ")");
+        }
+    }
+    $dbh->bz_commit_transaction();
+    Status('whines_obsolete_target_deletion_end');
+}
+
+###########################################################################
+# Repair hook
+###########################################################################
+
+Bugzilla::Hook::process('sanitycheck_repair', { status => \&Status });
+
+###########################################################################
+# Checks
+###########################################################################
+Status('checks_start');
+
+###########################################################################
+# Perform referential (cross) checks
+###########################################################################
+
+# This checks that a simple foreign key has a valid primary key value.  NULL
+# references are acceptable and cause no problem.
+#
+# The first parameter is the primary key table name.
+# The second parameter is the primary key field name.
+# Each successive parameter represents a foreign key, it must be a list
+# reference, where the list has:
+#   the first value is the foreign key table name.
+#   the second value is the foreign key field name.
+#   the third value is optional and represents a field on the foreign key
+#     table to display when the check fails.
+#   the fourth value is optional and is a list reference to values that
+#     are excluded from checking.
+#
+# FIXME: The excluded values parameter should go away - the QA contact
+#        fields should use NULL instead - see bug #109474.
+#        The same goes for series; no bug for that yet.
+
+sub CrossCheck {
+    my $table = shift @_;
+    my $field = shift @_;
+    my $dbh = Bugzilla->dbh;
+
+    Status('cross_check_to', {table => $table, field => $field});
+
+    while (@_) {
+        my $ref = shift @_;
+        my ($refertable, $referfield, $keyname, $exceptions) = @$ref;
+
+        $exceptions ||= [];
+        my %exceptions = map { $_ => 1 } @$exceptions;
+
+        Status('cross_check_from', {table => $refertable, field => $referfield});
+
+        my $query = qq{SELECT DISTINCT $refertable.$referfield} .
+            ($keyname ? qq{, $refertable.$keyname } : q{}) .
+                     qq{ FROM $refertable
+                    LEFT JOIN $table
+                           ON $refertable.$referfield = $table.$field
+                        WHERE $table.$field IS NULL
+                          AND $refertable.$referfield IS NOT NULL};
+
+        my $sth = $dbh->prepare($query);
+        $sth->execute;
+
+        my $has_bad_references = 0;
+
+        while (my ($value, $key) = $sth->fetchrow_array) {
+            next if $exceptions{$value};
+            Status('cross_check_alert', {value => $value, table => $refertable,
+                                         field => $referfield, keyname => $keyname,
+                                         key => $key}, 'alert');
+            $has_bad_references = 1;
+        }
+        # References to non existent bugs can be safely removed, bug 288461
+        if ($table eq 'bugs' && $has_bad_references) {
+            Status('cross_check_bug_has_references');
+        }
+        # References to non existent attachments can be safely removed.
+        if ($table eq 'attachments' && $has_bad_references) {
+            Status('cross_check_attachment_has_references');
+        }
+    }
+}
+
+CrossCheck('classifications', 'id',
+           ['products', 'classification_id']);
+
+CrossCheck("keyworddefs", "id",
+           ["keywords", "keywordid"]);
+
+CrossCheck("fielddefs", "id",
+           ["bugs_activity", "fieldid"],
+           ['profiles_activity', 'fieldid']);
+
+CrossCheck("flagtypes", "id",
+           ["flags", "type_id"],
+           ["flagexclusions", "type_id"],
+           ["flaginclusions", "type_id"]);
+
+CrossCheck("bugs", "bug_id",
+           ["bugs_activity", "bug_id"],
+           ["bug_group_map", "bug_id"],
+           ["bugs_fulltext", "bug_id"],
+           ["attachments", "bug_id"],
+           ["cc", "bug_id"],
+           ["longdescs", "bug_id"],
+           ["dependencies", "blocked"],
+           ["dependencies", "dependson"],
+           ['flags', 'bug_id'],
+           ["keywords", "bug_id"],
+           ["duplicates", "dupe_of", "dupe"],
+           ["duplicates", "dupe", "dupe_of"]);
+
+CrossCheck("groups", "id",
+           ["bug_group_map", "group_id"],
+           ['category_group_map', 'group_id'],
+           ["group_group_map", "grantor_id"],
+           ["group_group_map", "member_id"],
+           ["group_control_map", "group_id"],
+           ["namedquery_group_map", "group_id"],
+           ["user_group_map", "group_id"],
+           ["flagtypes", "grant_group_id"],
+           ["flagtypes", "request_group_id"]);
+
+CrossCheck("namedqueries", "id",
+           ["namedqueries_link_in_footer", "namedquery_id"],
+           ["namedquery_group_map", "namedquery_id"],
+          );
+
+CrossCheck("profiles", "userid",
+           ['profiles_activity', 'userid'],
+           ['profiles_activity', 'who'],
+           ['email_setting', 'user_id'],
+           ['profile_setting', 'user_id'],
+           ["bugs", "reporter", "bug_id"],
+           ["bugs", "assigned_to", "bug_id"],
+           ["bugs", "qa_contact", "bug_id"],
+           ["attachments", "submitter_id", "bug_id"],
+           ['flags', 'setter_id', 'bug_id'],
+           ['flags', 'requestee_id', 'bug_id'],
+           ["bugs_activity", "who", "bug_id"],
+           ["cc", "who", "bug_id"],
+           ['quips', 'userid'],
+           ["longdescs", "who", "bug_id"],
+           ["logincookies", "userid"],
+           ["namedqueries", "userid"],
+           ["namedqueries_link_in_footer", "user_id"],
+           ['series', 'creator', 'series_id'],
+           ["watch", "watcher"],
+           ["watch", "watched"],
+           ['whine_events', 'owner_userid'],
+           ["tokens", "userid"],
+           ["user_group_map", "user_id"],
+           ["components", "initialowner", "name"],
+           ["components", "initialqacontact", "name"],
+           ["component_cc", "user_id"]);
+
+CrossCheck("products", "id",
+           ["bugs", "product_id", "bug_id"],
+           ["components", "product_id", "name"],
+           ["milestones", "product_id", "value"],
+           ["versions", "product_id", "value"],
+           ["group_control_map", "product_id"],
+           ["flaginclusions", "product_id", "type_id"],
+           ["flagexclusions", "product_id", "type_id"]);
+
+CrossCheck("components", "id",
+           ["component_cc", "component_id"],
+           ["flagexclusions", "component_id", "type_id"],
+           ["flaginclusions", "component_id", "type_id"]);
+
+# Check the former enum types -mkanat@bugzilla.org
+CrossCheck("bug_status", "value",
+            ["bugs", "bug_status", "bug_id"]);
+
+CrossCheck("resolution", "value",
+            ["bugs", "resolution", "bug_id"]);
+
+CrossCheck("bug_severity", "value",
+            ["bugs", "bug_severity", "bug_id"]);
+
+CrossCheck("op_sys", "value",
+            ["bugs", "op_sys", "bug_id"]);
+
+CrossCheck("priority", "value",
+            ["bugs", "priority", "bug_id"]);
+
+CrossCheck("rep_platform", "value",
+            ["bugs", "rep_platform", "bug_id"]);
+
+CrossCheck('series', 'series_id',
+           ['series_data', 'series_id']);
+
+CrossCheck('series_categories', 'id',
+           ['series', 'category'],
+           ["category_group_map", "category_id"],
+           ["series", "subcategory"]);
+
+CrossCheck('whine_events', 'id',
+           ['whine_queries', 'eventid'],
+           ['whine_schedules', 'eventid']);
+
+CrossCheck('attachments', 'attach_id',
+           ['attach_data', 'id'],
+           ['bugs_activity', 'attach_id']);
+
+CrossCheck('bug_status', 'id',
+           ['status_workflow', 'old_status'],
+           ['status_workflow', 'new_status']);
+
+###########################################################################
+# Perform double field referential (cross) checks
+###########################################################################
+ 
+# This checks that a compound two-field foreign key has a valid primary key
+# value.  NULL references are acceptable and cause no problem.
+#
+# The first parameter is the primary key table name.
+# The second parameter is the primary key first field name.
+# The third parameter is the primary key second field name.
+# Each successive parameter represents a foreign key, it must be a list
+# reference, where the list has:
+#   the first value is the foreign key table name
+#   the second value is the foreign key first field name.
+#   the third value is the foreign key second field name.
+#   the fourth value is optional and represents a field on the foreign key
+#     table to display when the check fails
+
+sub DoubleCrossCheck {
+    my $table = shift @_;
+    my $field1 = shift @_;
+    my $field2 = shift @_;
+    my $dbh = Bugzilla->dbh;
+
+    Status('double_cross_check_to',
+           {table => $table, field1 => $field1, field2 => $field2});
+
+    while (@_) {
+        my $ref = shift @_;
+        my ($refertable, $referfield1, $referfield2, $keyname) = @$ref;
+
+        Status('double_cross_check_from',
+               {table => $refertable, field1 => $referfield1, field2 =>$referfield2});
+
+        my $d_cross_check = $dbh->selectall_arrayref(qq{
+                        SELECT DISTINCT $refertable.$referfield1, 
+                                        $refertable.$referfield2 } .
+                       ($keyname ? qq{, $refertable.$keyname } : q{}) .
+                      qq{ FROM $refertable
+                     LEFT JOIN $table
+                            ON $refertable.$referfield1 = $table.$field1
+                           AND $refertable.$referfield2 = $table.$field2 
+                         WHERE $table.$field1 IS NULL 
+                           AND $table.$field2 IS NULL 
+                           AND $refertable.$referfield1 IS NOT NULL 
+                           AND $refertable.$referfield2 IS NOT NULL});
+
+        foreach my $check (@$d_cross_check) {
+            my ($value1, $value2, $key) = @$check;
+            Status('double_cross_check_alert',
+                   {value1 => $value1, value2 => $value2,
+                    table => $refertable,
+                    field1 => $referfield1, field2 => $referfield2,
+                    keyname => $keyname, key => $key}, 'alert');
+        }
+    }
+}
+
+DoubleCrossCheck('attachments', 'bug_id', 'attach_id',
+                 ['flags', 'bug_id', 'attach_id'],
+                 ['bugs_activity', 'bug_id', 'attach_id']);
+
+DoubleCrossCheck("components", "product_id", "id",
+                 ["bugs", "product_id", "component_id", "bug_id"],
+                 ['flagexclusions', 'product_id', 'component_id'],
+                 ['flaginclusions', 'product_id', 'component_id']);
+
+DoubleCrossCheck("versions", "product_id", "value",
+                 ["bugs", "product_id", "version", "bug_id"]);
+ 
+DoubleCrossCheck("milestones", "product_id", "value",
+                 ["bugs", "product_id", "target_milestone", "bug_id"],
+                 ["products", "id", "defaultmilestone", "name"]);
+
+###########################################################################
+# Perform login checks
+###########################################################################
+
+Status('profile_login_start');
+
+my $sth = $dbh->prepare(q{SELECT userid, login_name FROM profiles});
+$sth->execute;
+
+while (my ($id, $email) = $sth->fetchrow_array) {
+    validate_email_syntax($email)
+      || Status('profile_login_alert', {id => $id, email => $email}, 'alert');
+}
+
+###########################################################################
+# Perform keyword checks
+###########################################################################
+
+sub check_keywords {
+    my $dbh = Bugzilla->dbh;
+    my $cgi = Bugzilla->cgi;
+
+    Status('keyword_check_start');
+
+    my %keywordids;
+    my $keywords = $dbh->selectall_arrayref(q{SELECT id, name
+                                                FROM keyworddefs});
+
+    foreach (@$keywords) {
+        my ($id, $name) = @$_;
+        if ($keywordids{$id}) {
+            Status('keyword_check_alert', {id => $id}, 'alert');
+        }
+        $keywordids{$id} = 1;
+        if ($name =~ /[\s,]/) {
+            Status('keyword_check_invalid_name', {id => $id}, 'alert');
+        }
+    }
+
+    my $sth = $dbh->prepare(q{SELECT bug_id, keywordid
+                                FROM keywords
+                            ORDER BY bug_id, keywordid});
+    $sth->execute;
+    my $lastid;
+    my $lastk;
+    while (my ($id, $k) = $sth->fetchrow_array) {
+        if (!$keywordids{$k}) {
+            Status('keyword_check_invalid_id', {id => $k}, 'alert');
+        }
+        if (defined $lastid && $id eq $lastid && $k eq $lastk) {
+            Status('keyword_check_duplicated_ids', {id => $id}, 'alert');
+        }
+        $lastid = $id;
+        $lastk = $k;
+    }
+}
+
+###########################################################################
+# Check for flags being in incorrect products and components
+###########################################################################
+
+Status('flag_check_start');
+
+my $invalid_flags = $dbh->selectall_arrayref(
+       'SELECT DISTINCT flags.id, flags.bug_id, flags.attach_id
+          FROM flags
+    INNER JOIN bugs
+            ON flags.bug_id = bugs.bug_id
+     LEFT JOIN flaginclusions AS i
+            ON flags.type_id = i.type_id
+           AND (bugs.product_id = i.product_id OR i.product_id IS NULL)
+           AND (bugs.component_id = i.component_id OR i.component_id IS NULL)
+         WHERE i.type_id IS NULL');
+
+my @invalid_flags = @$invalid_flags;
+
+$invalid_flags = $dbh->selectall_arrayref(
+       'SELECT DISTINCT flags.id, flags.bug_id, flags.attach_id
+          FROM flags
+    INNER JOIN bugs
+            ON flags.bug_id = bugs.bug_id
+    INNER JOIN flagexclusions AS e
+            ON flags.type_id = e.type_id
+         WHERE (bugs.product_id = e.product_id OR e.product_id IS NULL)
+           AND (bugs.component_id = e.component_id OR e.component_id IS NULL)');
+
+push(@invalid_flags, @$invalid_flags);
+
+if (scalar(@invalid_flags)) {
+    if ($cgi->param('remove_invalid_flags')) {
+        Status('flag_deletion_start');
+        my @flag_ids = map {$_->[0]} @invalid_flags;
+        # Silently delete these flags, with no notification to requesters/setters.
+        $dbh->do('DELETE FROM flags WHERE id IN (' . join(',', @flag_ids) .')');
+        Status('flag_deletion_end');
+    }
+    else {
+        foreach my $flag (@$invalid_flags) {
+            my ($flag_id, $bug_id, $attach_id) = @$flag;
+            Status('flag_alert',
+                   {flag_id => $flag_id, attach_id => $attach_id, bug_id => $bug_id},
+                   'alert');
+        }
+        Status('flag_fix');
+    }
+}
+
+###########################################################################
+# Check for products with no component
+###########################################################################
+
+Status('product_check_start');
+
+my $products_missing_data = $dbh->selectcol_arrayref(
+      'SELECT DISTINCT products.name
+         FROM products
+    LEFT JOIN components
+           ON components.product_id = products.id
+    LEFT JOIN versions
+           ON versions.product_id = products.id
+        WHERE components.id IS NULL
+           OR versions.id IS NULL');
+
+if (scalar(@$products_missing_data)) {
+    Status('product_alert', { name => $_ }, 'alert') foreach @$products_missing_data;
+}
+
+###########################################################################
+# General bug checks
+###########################################################################
+
+sub BugCheck {
+    my ($middlesql, $errortext, $repairparam, $repairtext) = @_;
+    my $dbh = Bugzilla->dbh;
+ 
+    my $badbugs = $dbh->selectcol_arrayref(qq{SELECT DISTINCT bugs.bug_id
+                                                FROM $middlesql 
+                                            ORDER BY bugs.bug_id});
+
+    if (scalar(@$badbugs)) {
+        Status('bug_check_alert',
+               {errortext => get_string($errortext), badbugs => $badbugs},
+               'alert');
+
+        if ($repairparam) {
+            $repairtext ||= 'repair_bugs';
+            Status('bug_check_repair',
+                   {param => $repairparam, text => get_string($repairtext)});
+        }
+    }
+}
+
+Status('bug_check_creation_date');
+
+BugCheck("bugs WHERE creation_ts IS NULL", 'bug_check_creation_date_error_text',
+         'repair_creation_date', 'bug_check_creation_date_repair_text');
+
+Status('bug_check_bugs_fulltext');
+
+BugCheck("bugs LEFT JOIN bugs_fulltext ON bugs_fulltext.bug_id = bugs.bug_id " .
+         "WHERE bugs_fulltext.bug_id IS NULL", 'bug_check_bugs_fulltext_error_text',
+         'repair_bugs_fulltext', 'bug_check_bugs_fulltext_repair_text');
+
+Status('bug_check_res_dupl');
+
+BugCheck("bugs INNER JOIN duplicates ON bugs.bug_id = duplicates.dupe " .
+         "WHERE bugs.resolution != 'DUPLICATE'", 'bug_check_res_dupl_error_text');
+
+BugCheck("bugs LEFT JOIN duplicates ON bugs.bug_id = duplicates.dupe WHERE " .
+         "bugs.resolution = 'DUPLICATE' AND " .
+         "duplicates.dupe IS NULL", 'bug_check_res_dupl_error_text2');
+
+Status('bug_check_status_res');
+
+my @open_states = map($dbh->quote($_), BUG_STATE_OPEN);
+my $open_states = join(', ', @open_states);
+
+BugCheck("bugs WHERE bug_status IN ($open_states) AND resolution != ''",
+         'bug_check_status_res_error_text');
+BugCheck("bugs WHERE bug_status NOT IN ($open_states) AND resolution = ''",
+         'bug_check_status_res_error_text2');
+
+Status('bug_check_status_everconfirmed');
+
+BugCheck("bugs WHERE bug_status = 'UNCONFIRMED' AND everconfirmed = 1",
+         'bug_check_status_everconfirmed_error_text', 'repair_everconfirmed');
+
+my @confirmed_open_states = grep {$_ ne 'UNCONFIRMED'} BUG_STATE_OPEN;
+my $confirmed_open_states = join(', ', map {$dbh->quote($_)} @confirmed_open_states);
+
+BugCheck("bugs WHERE bug_status IN ($confirmed_open_states) AND everconfirmed = 0",
+         'bug_check_status_everconfirmed_error_text2', 'repair_everconfirmed');
+
+###########################################################################
+# Control Values
+###########################################################################
+
+# Checks for values that are invalid OR
+# not among the 9 valid combinations
+Status('bug_check_control_values');
+my $groups = join(", ", (CONTROLMAPNA, CONTROLMAPSHOWN, CONTROLMAPDEFAULT,
+CONTROLMAPMANDATORY));
+my $query = qq{
+     SELECT COUNT(product_id) 
+       FROM group_control_map 
+      WHERE membercontrol NOT IN( $groups )
+         OR othercontrol NOT IN( $groups )
+         OR ((membercontrol != othercontrol)
+             AND (membercontrol != } . CONTROLMAPSHOWN . q{)
+             AND ((membercontrol != } . CONTROLMAPDEFAULT . q{)
+                  OR (othercontrol = } . CONTROLMAPSHOWN . q{)))};
+
+my $entries = $dbh->selectrow_array($query);
+Status('bug_check_control_values_alert', {entries => $entries}, 'alert') if $entries;
+
+Status('bug_check_control_values_violation');
+BugCheck("bugs
+         INNER JOIN bug_group_map
+            ON bugs.bug_id = bug_group_map.bug_id
+          LEFT JOIN group_control_map
+            ON bugs.product_id = group_control_map.product_id
+           AND bug_group_map.group_id = group_control_map.group_id
+         WHERE ((group_control_map.membercontrol = " . CONTROLMAPNA . ")
+         OR (group_control_map.membercontrol IS NULL))",
+         'bug_check_control_values_error_text',
+         'createmissinggroupcontrolmapentries',
+         'bug_check_control_values_repair_text');
+
+BugCheck("bugs
+         INNER JOIN group_control_map
+            ON bugs.product_id = group_control_map.product_id
+         INNER JOIN groups
+            ON group_control_map.group_id = groups.id
+          LEFT JOIN bug_group_map
+            ON bugs.bug_id = bug_group_map.bug_id
+           AND group_control_map.group_id = bug_group_map.group_id
+         WHERE group_control_map.membercontrol = " . CONTROLMAPMANDATORY . "
+           AND bug_group_map.group_id IS NULL
+           AND groups.isactive != 0",
+         'bug_check_control_values_error_text2');
+
+###########################################################################
+# Unsent mail
+###########################################################################
+
+Status('unsent_bugmail_check');
+
+my $time = $dbh->sql_date_math('NOW()', '-', 30, 'MINUTE');
+my $badbugs = $dbh->selectcol_arrayref(qq{
+                    SELECT bug_id 
+                      FROM bugs 
+                     WHERE (lastdiffed IS NULL OR lastdiffed < delta_ts)
+                       AND delta_ts < $time
+                  ORDER BY bug_id});
+
+
+if (scalar(@$badbugs > 0)) {
+    Status('unsent_bugmail_alert', {badbugs => $badbugs}, 'alert');
+    Status('unsent_bugmail_fix');
+}
+
+###########################################################################
+# Whines
+###########################################################################
+
+Status('whines_obsolete_target_start');
+
+my $display_repair_whines_link = 0;
+foreach my $target (['groups', 'id', MAILTO_GROUP],
+                    ['profiles', 'userid', MAILTO_USER])
+{
+    my ($table, $col, $type) = @$target;
+    my $old = $dbh->selectall_arrayref("SELECT whine_schedules.id, mailto
+                                          FROM whine_schedules
+                                     LEFT JOIN $table
+                                            ON $table.$col = whine_schedules.mailto
+                                         WHERE mailto_type = $type AND $table.$col IS NULL");
+
+    if (scalar(@$old)) {
+        Status('whines_obsolete_target_alert', {schedules => $old, type => $type}, 'alert');
+        $display_repair_whines_link = 1;
+    }
+}
+Status('whines_obsolete_target_fix') if $display_repair_whines_link;
+
+###########################################################################
+# Check hook
+###########################################################################
+
+Bugzilla::Hook::process('sanitycheck_check', { status => \&Status });
+
+###########################################################################
+# End
+###########################################################################
+
+Status('checks_completed');
+
+unless (Bugzilla->usage_mode == USAGE_MODE_CMDLINE) {
+    $template->process('global/footer.html.tmpl', $vars)
+      || ThrowTemplateError($template->error());
+}

diff --git a/sanitycheck.pl b/sanitycheck.pl
new file mode 100755 (executable)
index 0000000..a360bf8
--- /dev/null
+++ b/sanitycheck.pl
@@ -0,0 +1,101 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::User;
+use Bugzilla::Mailer;
+
+use Getopt::Long;
+use Pod::Usage;
+
+my $verbose = 0; # Return all comments if true, else errors only.
+my $login = '';  # Login name of the user which is used to call sanitycheck.cgi.
+my $help = 0;    # Has user asked for help on this script?
+
+my $result = GetOptions('verbose'  => \$verbose,
+                        'login=s'  => \$login,
+                        'help|h|?' => \$help);
+
+pod2usage({-verbose => 1, -exitval => 1}) if $help;
+
+# Be sure a login name if given.
+$login || ThrowUserError('invalid_username');
+
+my $user = new Bugzilla::User({ name => $login })
+  || ThrowUserError('invalid_username', { name => $login });
+
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+
+# Authenticate using this user account.
+Bugzilla->set_user($user);
+
+# Pass this param to sanitycheck.cgi.
+$cgi->param('verbose', $verbose);
+
+require 'sanitycheck.cgi';
+
+# Now it's time to send an email to the user if there is something to notify.
+if ($cgi->param('output')) {
+    my $message;
+    my $vars = {};
+    $vars->{'addressee'} = $user->email;
+    $vars->{'output'} = $cgi->param('output');
+    $vars->{'error_found'} = $cgi->param('error_found') ? 1 : 0;
+
+    $template->process('email/sanitycheck.txt.tmpl', $vars, \$message)
+      || ThrowTemplateError($template->error());
+
+    MessageToMTA($message);
+}
+
+
+__END__
+
+=head1 NAME
+
+sanitycheck.pl - Perl script to perform a sanity check at the command line
+
+=head1 SYNOPSIS
+
+ ./sanitycheck.pl [--help]
+ ./sanitycheck.pl [--verbose] --login <user@domain.com>
+
+=head1 OPTIONS
+
+=over
+
+=item B<--help>
+
+Displays this help text
+
+=item B<--verbose>
+
+Causes this script to be more verbose in its output. Without this option,
+the script will return only errors. With the option, the script will append
+all output to the email.
+
+=item B<--login>
+
+This should be passed the email address of a user that is capable of
+running the Sanity Check process, a user with the editcomponents priv. This
+user will receive an email with the results of the script run.
+
+=back
+
+=head1 DESCRIPTION
+
+This script provides a way of running a 'Sanity Check' on the database
+via either a CLI or cron. It is equivalent to calling sanitycheck.cgi
+via a web browser.

diff --git a/search_plugin.cgi b/search_plugin.cgi
new file mode 100755 (executable)
index 0000000..3809159
--- /dev/null
+++ b/search_plugin.cgi
@@ -0,0 +1,34 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Error;
+use Bugzilla::Constants;
+
+Bugzilla->login();
+
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $vars = {};
+
+# Return the appropriate HTTP response headers.
+print $cgi->header('application/xml');
+
+# Get the contents of favicon.ico
+my $filename = bz_locations()->{'libpath'} . "/images/favicon.ico";
+if (open(IN, $filename)) {
+    local $/;
+    binmode IN;
+    $vars->{'favicon'} = <IN>;
+    close IN;
+}
+$template->process("search/search-plugin.xml.tmpl", $vars)
+  || ThrowTemplateError($template->error());

diff --git a/show_activity.cgi b/show_activity.cgi
new file mode 100755 (executable)
index 0000000..d161382
--- /dev/null
+++ b/show_activity.cgi
@@ -0,0 +1,48 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Error;
+use Bugzilla::Bug;
+
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $vars = {};
+
+###############################################################################
+# Begin Data/Security Validation
+###############################################################################
+
+# Check whether or not the user is currently logged in. 
+Bugzilla->login();
+
+# Make sure the bug ID is a positive integer representing an existing
+# bug that the user is authorized to access.
+my $id = $cgi->param('id');
+my $bug = Bugzilla::Bug->check($id);
+
+###############################################################################
+# End Data/Security Validation
+###############################################################################
+
+# Run queries against the shadow DB. In the worst case, new changes are not
+# visible immediately due to replication lag.
+Bugzilla->switch_to_shadow_db;
+
+($vars->{'operations'}, $vars->{'incomplete_data'}) = $bug->get_activity;
+
+$vars->{'bug'} = $bug;
+
+print $cgi->header();
+
+$template->process("bug/activity/show.html.tmpl", $vars)
+  || ThrowTemplateError($template->error());

diff --git a/show_bug.cgi b/show_bug.cgi
new file mode 100755 (executable)
index 0000000..846cf64
--- /dev/null
+++ b/show_bug.cgi
@@ -0,0 +1,129 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::Util;
+use Bugzilla::Bug;
+
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $vars = {};
+
+my $user = Bugzilla->login();
+
+my $format = $template->get_format("bug/show", scalar $cgi->param('format'),
+                                   scalar $cgi->param('ctype'));
+
+# Editable, 'single' HTML bugs are treated slightly specially in a few places
+my $single = !$format->{format} && $format->{extension} eq 'html';
+
+# If we don't have an ID, _AND_ we're only doing a single bug, then prompt
+if (!$cgi->param('id') && $single) {
+    print $cgi->header();
+    $template->process("bug/choose.html.tmpl", $vars) ||
+      ThrowTemplateError($template->error());
+    exit;
+}
+
+my (@bugs, @illegal_bugs);
+my %marks;
+
+# If the user isn't logged in, we use data from the shadow DB. If he plans
+# to edit the bug(s), he will have to log in first, meaning that the data
+# will be reloaded anyway, from the main DB.
+Bugzilla->switch_to_shadow_db unless $user->id;
+
+if ($single) {
+    my $id = $cgi->param('id');
+    push @bugs, Bugzilla::Bug->check($id);
+    if (defined $cgi->param('mark')) {
+        foreach my $range (split ',', $cgi->param('mark')) {
+            if ($range =~ /^(\d+)-(\d+)$/) {
+               foreach my $i ($1..$2) {
+                   $marks{$i} = 1;
+               }
+            } elsif ($range =~ /^(\d+)$/) {
+               $marks{$1} = 1;
+            }
+        }
+    }
+} else {
+    foreach my $id ($cgi->param('id')) {
+        # Be kind enough and accept URLs of the form: id=1,2,3.
+        my @ids = split(/,/, $id);
+        my @check_bugs;
+
+        foreach my $bug_id (@ids) {
+            next unless $bug_id;
+            my $bug = new Bugzilla::Bug($bug_id);
+            if (!$bug->{error}) {
+                push(@check_bugs, $bug);
+            }
+            else {
+                push(@illegal_bugs, { bug_id => trim($bug_id), error => $bug->{error} });
+            }
+        }
+
+        $user->visible_bugs(\@check_bugs);
+
+        foreach my $bug (@check_bugs) {
+            if ($user->can_see_bug($bug->id)) {
+                push(@bugs, $bug);
+            }
+            else {
+                my $error = 'NotPermitted'; # Trick to make 012throwables.t happy.
+                push(@illegal_bugs, { bug_id => $bug->id, error => $error });
+            }
+        }
+    }
+}
+
+Bugzilla::Bug->preload(\@bugs);
+
+$vars->{'bugs'} = [@bugs, @illegal_bugs];
+$vars->{'marks'} = \%marks;
+
+my @bugids = map {$_->bug_id} grep {!$_->error} @bugs;
+$vars->{'bugids'} = join(", ", @bugids);
+
+# Work out which fields we are displaying (currently XML only.)
+# If no explicit list is defined, we show all fields. We then exclude any
+# on the exclusion list. This is so you can say e.g. "Everything except 
+# attachments" without listing almost all the fields.
+my @fieldlist = (Bugzilla::Bug->fields, 'flag', 'group', 'long_desc',
+                 'attachment', 'attachmentdata', 'token');
+my %displayfields;
+
+if ($cgi->param("field")) {
+    @fieldlist = $cgi->param("field");
+}
+
+unless ($user->is_timetracker) {
+    @fieldlist = grep($_ !~ /(^deadline|_time)$/, @fieldlist);
+}
+
+foreach (@fieldlist) {
+    $displayfields{$_} = 1;
+}
+
+foreach ($cgi->param("excludefield")) {
+    $displayfields{$_} = undef;    
+}
+
+$vars->{'displayfields'} = \%displayfields;
+
+print $cgi->header($format->{'ctype'});
+
+$template->process($format->{'template'}, $vars)
+  || ThrowTemplateError($template->error());

diff --git a/showdependencygraph.cgi b/showdependencygraph.cgi
new file mode 100755 (executable)
index 0000000..8e3592f
--- /dev/null
+++ b/showdependencygraph.cgi
@@ -0,0 +1,319 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+use lib qw(. lib);
+
+use File::Temp;
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Install::Filesystem;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Bug;
+use Bugzilla::Status;
+
+my $user = Bugzilla->login();
+
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $vars = {};
+# Connect to the shadow database if this installation is using one to improve
+# performance.
+my $dbh = Bugzilla->switch_to_shadow_db();
+
+local our (%seen, %edgesdone, %bugtitles);
+
+# CreateImagemap: This sub grabs a local filename as a parameter, reads the 
+# dot-generated image map datafile residing in that file and turns it into
+# an HTML map element. THIS SUB IS ONLY USED FOR LOCAL DOT INSTALLATIONS.
+# The map datafile won't necessarily contain the bug summaries, so we'll
+# pull possible HTML titles from the %bugtitles hash (filled elsewhere
+# in the code)
+
+# The dot mapdata lines have the following format (\nsummary is optional):
+# rectangle (LEFTX,TOPY) (RIGHTX,BOTTOMY) URLBASE/show_bug.cgi?id=BUGNUM BUGNUM[\nSUMMARY]
+
+sub CreateImagemap {
+    my $mapfilename = shift;
+    my $map = "<map name=\"imagemap\">\n";
+    my $default = "";
+
+    open MAP, "<$mapfilename";
+    while(my $line = <MAP>) {
+        if($line =~ /^default ([^ ]*)(.*)$/) {
+            $default = qq{<area alt="" shape="default" href="$1">\n};
+        }
+
+        if ($line =~ /^rectangle \((.*),(.*)\) \((.*),(.*)\) (http[^ ]*) (\d+)(\\n.*)?$/) {
+            my ($leftx, $rightx, $topy, $bottomy, $url, $bugid) = ($1, $3, $2, $4, $5, $6);
+
+            # Pick up bugid from the mapdata label field. Getting the title from
+            # bugtitle hash instead of mapdata allows us to get the summary even
+            # when showsummary is off, and also gives us status and resolution.
+            my $bugtitle = html_quote(clean_text($bugtitles{$bugid}));
+            $map .= qq{<area alt="bug $bugid" name="bug$bugid" shape="rect" } .
+                    qq{title="$bugtitle" href="$url" } .
+                    qq{coords="$leftx,$topy,$rightx,$bottomy">\n};
+        }
+    }
+    close MAP;
+
+    $map .= "$default</map>";
+    return $map;
+}
+
+sub AddLink {
+    my ($blocked, $dependson, $fh) = (@_);
+    my $key = "$blocked,$dependson";
+    if (!exists $edgesdone{$key}) {
+        $edgesdone{$key} = 1;
+        print $fh "$dependson -> $blocked\n";
+        $seen{$blocked} = 1;
+        $seen{$dependson} = 1;
+    }
+}
+
+ThrowUserError("missing_bug_id") unless $cgi->param('id');
+
+# The list of valid directions. Some are not proposed in the dropdrown
+# menu despite the fact that they are valid.
+my @valid_rankdirs = ('LR', 'RL', 'TB', 'BT');
+
+my $rankdir = $cgi->param('rankdir') || 'TB';
+# Make sure the submitted 'rankdir' value is valid.
+if (!grep { $_ eq $rankdir } @valid_rankdirs) {
+    $rankdir = 'TB';
+}
+
+my $display = $cgi->param('display') || 'tree';
+my $webdotdir = bz_locations()->{'webdotdir'};
+
+my ($fh, $filename) = File::Temp::tempfile("XXXXXXXXXX",
+                                           SUFFIX => '.dot',
+                                           DIR => $webdotdir,
+                                           UNLINK => 1);
+
+chmod Bugzilla::Install::Filesystem::CGI_WRITE, $filename
+    or warn install_string('chmod_failed', { path => $filename,
+                                             error => $! });
+
+my $urlbase = correct_urlbase();
+
+print $fh "digraph G {";
+print $fh qq{
+graph [URL="${urlbase}query.cgi", rankdir=$rankdir]
+node [URL="${urlbase}show_bug.cgi?id=\\N", style=filled, color=lightgrey]
+};
+
+my %baselist;
+
+foreach my $i (split('[\s,]+', $cgi->param('id'))) {
+    my $bug = Bugzilla::Bug->check($i);
+    $baselist{$bug->id} = 1;
+}
+
+my @stack = keys(%baselist);
+
+if ($display eq 'web') {
+    my $sth = $dbh->prepare(q{SELECT blocked, dependson
+                                FROM dependencies
+                               WHERE blocked = ? OR dependson = ?});
+
+    foreach my $id (@stack) {
+        my $dependencies = $dbh->selectall_arrayref($sth, undef, ($id, $id));
+        foreach my $dependency (@$dependencies) {
+            my ($blocked, $dependson) = @$dependency;
+            if ($blocked != $id && !exists $seen{$blocked}) {
+                push @stack, $blocked;
+            }
+            if ($dependson != $id && !exists $seen{$dependson}) {
+                push @stack, $dependson;
+            }
+            AddLink($blocked, $dependson, $fh);
+        }
+    }
+}
+# This is the default: a tree instead of a spider web.
+else {
+    my @blocker_stack = @stack;
+    foreach my $id (@blocker_stack) {
+        my $blocker_ids = Bugzilla::Bug::EmitDependList('blocked', 'dependson', $id);
+        foreach my $blocker_id (@$blocker_ids) {
+            push(@blocker_stack, $blocker_id) unless $seen{$blocker_id};
+            AddLink($id, $blocker_id, $fh);
+        }
+    }
+    my @dependent_stack = @stack;
+    foreach my $id (@dependent_stack) {
+        my $dep_bug_ids = Bugzilla::Bug::EmitDependList('dependson', 'blocked', $id);
+        foreach my $dep_bug_id (@$dep_bug_ids) {
+            push(@dependent_stack, $dep_bug_id) unless $seen{$dep_bug_id};
+            AddLink($dep_bug_id, $id, $fh);
+        }
+    }
+}
+
+foreach my $k (keys(%baselist)) {
+    $seen{$k} = 1;
+}
+
+my $sth = $dbh->prepare(
+              q{SELECT bug_status, resolution, short_desc
+                  FROM bugs
+                 WHERE bugs.bug_id = ?});
+
+my @bug_ids = keys %seen;
+$user->visible_bugs(\@bug_ids);
+foreach my $k (@bug_ids) {
+    # Retrieve bug information from the database
+    my ($stat, $resolution, $summary) = $dbh->selectrow_array($sth, undef, $k);
+
+    # Resolution and summary are shown only if user can see the bug
+    if (!$user->can_see_bug($k)) {
+        $resolution = $summary = '';
+    }
+
+    $vars->{'short_desc'} = $summary if ($k eq $cgi->param('id'));
+
+    my @params;
+
+    if ($summary ne "" && $cgi->param('showsummary')) {
+        # Wide characters cause GraphViz to die.
+        if (Bugzilla->params->{'utf8'}) {
+            utf8::encode($summary) if utf8::is_utf8($summary);
+        }
+        $summary =~ s/([\\\"])/\\$1/g;
+        push(@params, qq{label="$k\\n$summary"});
+    }
+
+    if (exists $baselist{$k}) {
+        push(@params, "shape=box");
+    }
+
+    if (is_open_state($stat)) {
+        push(@params, "color=green");
+    }
+
+    if (@params) {
+        print $fh "$k [" . join(',', @params) . "]\n";
+    } else {
+        print $fh "$k\n";
+    }
+
+    # Push the bug tooltip texts into a global hash so that 
+    # CreateImagemap sub (used with local dot installations) can
+    # use them later on.
+    $bugtitles{$k} = trim("$stat $resolution");
+
+    # Show the bug summary in tooltips only if not shown on 
+    # the graph and it is non-empty (the user can see the bug)
+    if (!$cgi->param('showsummary') && $summary ne "") {
+        $bugtitles{$k} .= " - $summary";
+    }
+}
+
+
+print $fh "}\n";
+close $fh;
+
+my $webdotbase = Bugzilla->params->{'webdotbase'};
+
+if ($webdotbase =~ /^https?:/) {
+     # Remote dot server. We don't hardcode 'urlbase' here in case
+     # 'sslbase' is in use.
+     $webdotbase =~ s/%([a-z]*)%/Bugzilla->params->{$1}/eg;
+     my $url = $webdotbase . $filename;
+     $vars->{'image_url'} = $url . ".gif";
+     $vars->{'map_url'} = $url . ".map";
+} else {
+    # Local dot installation
+
+    # First, generate the png image file from the .dot source
+
+    my ($pngfh, $pngfilename) = File::Temp::tempfile("XXXXXXXXXX",
+                                                     SUFFIX => '.png',
+                                                     DIR => $webdotdir);
+
+    chmod Bugzilla::Install::Filesystem::WS_SERVE, $pngfilename
+        or warn install_string('chmod_failed', { path => $pngfilename,
+                                                 error => $! });
+
+    binmode $pngfh;
+    open(DOT, "\"$webdotbase\" -Tpng $filename|");
+    binmode DOT;
+    print $pngfh $_ while <DOT>;
+    close DOT;
+    close $pngfh;
+
+    # On Windows $pngfilename will contain \ instead of /
+    $pngfilename =~ s|\\|/|g if ON_WINDOWS;
+
+    # Under mod_perl, pngfilename will have an absolute path, and we
+    # need to make that into a relative path.
+    my $cgi_root = bz_locations()->{cgi_path};
+    $pngfilename =~ s#^\Q$cgi_root\E/?##;
+    
+    $vars->{'image_url'} = $pngfilename;
+
+    # Then, generate a imagemap datafile that contains the corner data
+    # for drawn bug objects. Pass it on to CreateImagemap that
+    # turns this monster into html.
+
+    my ($mapfh, $mapfilename) = File::Temp::tempfile("XXXXXXXXXX",
+                                                     SUFFIX => '.map',
+                                                     DIR => $webdotdir);
+
+    chmod Bugzilla::Install::Filesystem::WS_SERVE, $mapfilename
+        or warn install_string('chmod_failed', { path => $mapfilename,
+                                                 error => $! });
+
+    binmode $mapfh;
+    open(DOT, "\"$webdotbase\" -Tismap $filename|");
+    binmode DOT;
+    print $mapfh $_ while <DOT>;
+    close DOT;
+    close $mapfh;
+
+    $vars->{'image_map'} = CreateImagemap($mapfilename);
+}
+
+# Cleanup any old .dot files created from previous runs.
+my $since = time() - 24 * 60 * 60;
+# Can't use glob, since even calling that fails taint checks for perl < 5.6
+opendir(DIR, $webdotdir);
+my @files = grep { /\.dot$|\.png$|\.map$/ && -f "$webdotdir/$_" } readdir(DIR);
+closedir DIR;
+foreach my $f (@files)
+{
+    $f = "$webdotdir/$f";
+    # Here we are deleting all old files. All entries are from the
+    # $webdot directory. Since we're deleting the file (not following
+    # symlinks), this can't escape to delete anything it shouldn't
+    # (unless someone moves the location of $webdotdir, of course)
+    trick_taint($f);
+    my $mtime = (stat($f))[9];
+    if ($mtime && $mtime < $since) {
+        unlink $f;
+    }
+}
+
+# Make sure we only include valid integers (protects us from XSS attacks).
+my @bugs = grep(detaint_natural($_), split(/[\s,]+/, $cgi->param('id')));
+$vars->{'bug_id'} = join(', ', @bugs);
+$vars->{'multiple_bugs'} = ($cgi->param('id') =~ /[ ,]/);
+$vars->{'display'} = $display;
+$vars->{'rankdir'} = $rankdir;
+$vars->{'showsummary'} = $cgi->param('showsummary');
+
+# Generate and return the UI (HTML page) from the appropriate template.
+print $cgi->header();
+$template->process("bug/dependency-graph.html.tmpl", $vars)
+  || ThrowTemplateError($template->error());

diff --git a/showdependencytree.cgi b/showdependencytree.cgi
new file mode 100755 (executable)
index 0000000..6b07a9e
--- /dev/null
+++ b/showdependencytree.cgi
@@ -0,0 +1,123 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Error;
+use Bugzilla::Bug;
+
+use List::Util qw(max);
+
+my $user = Bugzilla->login();
+
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $vars = {};
+# Connect to the shadow database if this installation is using one to improve
+# performance.
+my $dbh = Bugzilla->switch_to_shadow_db();
+
+################################################################################
+# Data/Security Validation                                                     #
+################################################################################
+
+# Make sure the bug ID is a positive integer representing an existing
+# bug that the user is authorized to access.
+my $bug = Bugzilla::Bug->check(scalar $cgi->param('id'));
+my $id = $bug->id;
+
+local our $hide_resolved = $cgi->param('hide_resolved') ? 1 : 0;
+
+local our $maxdepth = $cgi->param('maxdepth') || 0;
+if ($maxdepth !~ /^\d+$/) { $maxdepth = 0 };
+
+################################################################################
+# Main Section                                                                 #
+################################################################################
+
+# Stores the greatest depth to which either tree goes.
+local our $realdepth = 0;
+
+# Generate the tree of bugs that this bug depends on and a list of IDs
+# appearing in the tree.
+my $dependson_tree = { $id => $bug };
+my $dependson_ids = {};
+GenerateTree($id, "dependson", 1, $dependson_tree, $dependson_ids);
+$vars->{'dependson_tree'} = $dependson_tree;
+$vars->{'dependson_ids'} = [keys(%$dependson_ids)];
+
+# Generate the tree of bugs that this bug blocks and a list of IDs
+# appearing in the tree.
+my $blocked_tree = { $id => $bug };
+my $blocked_ids = {};
+GenerateTree($id, "blocked", 1, $blocked_tree, $blocked_ids);
+$vars->{'blocked_tree'} = $blocked_tree;
+$vars->{'blocked_ids'} = [keys(%$blocked_ids)];
+
+$vars->{'realdepth'}      = $realdepth;
+
+$vars->{'bugid'}          = $id;
+$vars->{'maxdepth'}       = $maxdepth;
+$vars->{'hide_resolved'}  = $hide_resolved;
+
+print $cgi->header();
+$template->process("bug/dependency-tree.html.tmpl", $vars)
+  || ThrowTemplateError($template->error());
+
+################################################################################
+# Recursive Tree Generation Function                                           #
+################################################################################
+
+sub GenerateTree {
+    # Generates a dependency tree for a given bug.  Calls itself recursively
+    # to generate sub-trees for the bug's dependencies.
+    my ($bug_id, $relationship, $depth, $bugs, $ids) = @_;
+
+    my @dependencies;
+    if ($relationship eq 'dependson') {
+        @dependencies = @{$bugs->{$bug_id}->dependson};
+    }
+    else {
+        @dependencies = @{$bugs->{$bug_id}->blocked};
+    }
+
+    # Don't do anything if this bug doesn't have any dependencies.
+    return unless scalar(@dependencies);
+
+    # Record this depth in the global $realdepth variable if it's farther 
+    # than we've gone before.
+    $realdepth = max($realdepth, $depth);
+    Bugzilla->user->visible_bugs(\@dependencies); 
+    foreach my $dep_id (@dependencies) {
+        # Get this dependency's record from the database and generate
+        # its sub-tree if we haven't already done so (which happens
+        # when bugs appear in dependency trees multiple times).
+        if (!$bugs->{$dep_id}) {
+            $bugs->{$dep_id} = new Bugzilla::Bug($dep_id);
+            GenerateTree($dep_id, $relationship, $depth+1, $bugs, $ids);
+        }
+
+        # Add this dependency to the list of this bug's dependencies 
+        # if it exists, if we haven't exceeded the maximum depth the user 
+        # wants the tree to go, and if the dependency isn't resolved 
+        # (if we're ignoring resolved dependencies).
+        if (!$bugs->{$dep_id}->{'error'}
+            && Bugzilla->user->can_see_bug($dep_id)
+            && (!$maxdepth || $depth <= $maxdepth) 
+            && ($bugs->{$dep_id}->isopened || !$hide_resolved))
+        {
+            # Due to AUTOLOAD in Bug.pm, we cannot add 'dependencies'
+            # as a bug object attribute from here.
+            push(@{$bugs->{'dependencies'}->{$bug_id}}, $dep_id);
+            $ids->{$dep_id} = 1;
+        }
+    }
+}

diff --git a/skins/README b/skins/README
new file mode 100644 (file)
index 0000000..111c00f
--- /dev/null
+++ b/skins/README
@@ -0,0 +1,20 @@
+There are three directories here, standard/, custom/, and contrib/.
+
+standard/ holds the standard stylesheets. These are used no matter
+what skin the user selects. If the user selects the "Classic" skin,
+then *only* the standard/ stylesheets are used.
+
+contrib/ holds "skins" that the user can select in their preferences.
+skins are in directories, and they contain files with the same names
+as the files in skins/standard/. Simply putting a new directory
+into the contrib/ directory adds a new skin as an option in users'
+preferences.
+
+custom/ allows you to locally override the standard/ and contrib/ CSS.
+If you put files into the custom/ directory with the same names as the CSS
+files in skins/standard/, you can override the standard/ and contrib/
+CSS. For example, if you want to override some CSS in
+skins/standard/global.css, then you should create a file called "global.css"
+in custom/ and put some CSS in it. The CSS you put into files in custom/ will
+be used *in addition* to the CSS in skins/standard/ or the CSS in
+skins/contrib/. It will apply to every skin.

diff --git a/skins/contrib/Dusk/buglist.css b/skins/contrib/Dusk/buglist.css
new file mode 100644 (file)
index 0000000..a9cbfd0
--- /dev/null
+++ b/skins/contrib/Dusk/buglist.css
@@ -0,0 +1,11 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+tr.bz_bugitem:hover {
+    background-color: #ccccff;
+}

diff --git a/skins/contrib/Dusk/global.css b/skins/contrib/Dusk/global.css
new file mode 100644 (file)
index 0000000..f051a3b
--- /dev/null
+++ b/skins/contrib/Dusk/global.css
@@ -0,0 +1,239 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+body {
+    background: #c8c8c8;
+    font-family: Helvetica, Arial, Geneva;
+    padding-left: 1em;
+    padding-right: 1em;
+}
+
+/* page title */
+
+#titles {
+    border-top-left-radius: 5px;
+    border-top-right-radius: 5px;
+}
+
+#header .links, #footer {
+    background-color: #929bb1;
+    color: #ddd;
+}
+
+#header {
+    border-bottom-left-radius: 5px;
+    border-bottom-right-radius: 5px;
+    border: none;
+}
+
+#header a, #footer a {
+    color: white;
+    text-decoration: none;
+}
+#header a:hover, #footer a:hover {
+    text-decoration: underline;
+}
+
+/* body */
+
+#bugzilla-body {
+    background: #f0f0f0;
+    color: black;
+    border: 1px solid #747e93;
+    padding: 10px;
+    font-size: 10pt;
+    border-radius: 5px;
+}
+
+a {
+    color: #6070cf;
+}
+a:hover {
+    color: #8090ef;
+}
+
+hr {
+  border-color: #969696;
+  border-style: dashed;
+  border-width: 1px;
+  margin-top: 10px;
+}
+
+/* edit */
+
+#bugzilla-body th {
+    font-weight: bold;
+    vertical-align: top;
+    white-space: nowrap;
+}
+
+#bug-form td {
+    padding-top: 2px;
+}
+
+/* attachments */
+
+#attachment-list {
+    border: 2px solid #c8c8ba;
+    font-size: 9pt;
+}
+
+#attachment-list th {
+    background-color: #e6e6d8;
+    border: none;
+    border-bottom: 1px solid #c8c8ba;
+    text-align: left;
+}
+
+#attachment-list th a {
+    color: #646456;
+}
+
+#attachment-list td {
+    border: none;
+}
+
+#attachment-list-actions td {
+    border-top: 1px solid #c8c8ba;
+}
+
+/************/
+/* Comments */
+/************/
+
+#comments th {
+    font-size: 9pt;
+    font-weight: bold;
+    padding-top: 5px;
+    padding-right: 5px;
+    padding-bottom: 10px;
+    text-align: right;
+    vertical-align: top;
+    white-space: nowrap;
+}
+
+#comments td {
+    padding-top: 2px;
+}
+
+.reply-button a {
+    padding-left: 2px;
+    padding-right: 2px;
+}
+
+.bz_comment {
+    background-color: #e8e8e8;
+    margin: 1px 1px 10px 1px;
+    border-width: 1px;
+    border-style: solid;
+    border-color: #c8c8ba;
+    padding: 5px;
+    font-size: 9pt;
+}
+
+.bz_comment_head, .bz_first_comment_head {
+    margin: 0; padding: 0;
+    background-color: transparent;
+    font-weight: bold;
+}
+
+.bz_comment_user {
+    margin-left: 0;
+}
+
+.bz_comment.bz_private {
+    background-color: #f0e8e8;
+    border-color: #f8c8ba;
+}
+
+.comment_rule {
+    display: none;
+}
+
+/* footer */
+
+#footer {
+    border: 1px solid #747e93;
+    width: 100%;
+    border-radius: 5px;
+}
+
+#footer #links-actions,
+#footer #links-edit,
+#footer #links-saved,
+#footer #links-special {
+    margin-top: 2ex;
+}
+
+#footer .links {
+    border-spacing: 30px;
+    margin-bottom: 2ex;
+}
+
+.separator {
+    color: #cccccc;
+}
+
+/* tabs */
+
+.tabbed .tabbody {
+    background: #f8f8f8;
+    padding: 1em;
+    border-style: solid;
+    border-color: #000000;
+    border-width: 0 3px 3px 1px;
+}
+
+.tabs {
+    margin: 0;
+    padding: 0;
+    border-collapse: collapse;
+}
+
+.tabs td {
+    background: #c8c8c8;
+    border-width: 1px;
+}
+
+.tabs td.selected {
+    background: #f8f8f8;
+    border-width: 1px 3px 0 1px;
+}
+
+.tabs td.spacer {
+    background: transparent;
+    border-top: none;
+    border-left: none;
+    border-right: none;
+}
+
+/* other */
+
+.bz_row_odd {
+    background-color: #f0f0f0;
+}
+
+/* Rules specific for printing */
+@media print {
+    #header,
+    #footer,
+    .navigation {
+        display: none;
+    }
+
+    body {
+        background-image: none;
+        background-color: #ffffff;
+    }
+
+    #bugzilla-body {
+        border: none;
+        margin: 0;
+        padding: 0;
+    }
+}

diff --git a/skins/contrib/Dusk/index.css b/skins/contrib/Dusk/index.css
new file mode 100644 (file)
index 0000000..8ea90b5
--- /dev/null
+++ b/skins/contrib/Dusk/index.css
@@ -0,0 +1,12 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+    
+    div#page-index .outro 
+    {
+        clear:both;
+    }

diff --git a/skins/standard/IE-fixes.css b/skins/standard/IE-fixes.css
new file mode 100644 (file)
index 0000000..65f33a6
--- /dev/null
+++ b/skins/standard/IE-fixes.css
@@ -0,0 +1,58 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+.bz_comment_text, .uneditable_textarea, tbody.file pre {
+     white-space: pre;
+     word-wrap: break-word;
+}
+
+.component_table {
+    margin-top: .5em;
+}
+
+form#Create #comp_desc {
+    margin: .5em 1em;
+}
+
+#footer #useful-links li {
+    padding-bottom: 0.8ex;
+}
+
+#footer .label {
+    display: block;
+    float: left;
+    width: 8.2em;
+    padding-bottom: 0.1ex;
+}
+
+#footer #links-actions .label {
+    padding-top: 0.35em;
+}
+
+#footer .links {
+    display: inline;
+}
+
+#bug_id_container, .search_field_grid, 
+.search_email_fields, ul.bug_changes li { 
+    zoom: 1;
+    display: inline;
+}
+
+#keywords_container .yui-ac-content {
+    _height: 30em; /* ie6 */
+}
+
+.bz_short_desc_column a, .bz_short_short_desc_column a {
+    /* color:inherit */
+    color: expression(this.parentNode.currentStyle['color']);
+}
+
+#graphical_report {
+  width: auto\9; /* IE6-8 */
+}

diff --git a/skins/standard/admin.css b/skins/standard/admin.css
new file mode 100644 (file)
index 0000000..c2b822b
--- /dev/null
+++ b/skins/standard/admin.css
@@ -0,0 +1,126 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+.warningmessages, .criticalmessages {
+    background-color: white;
+    border-style: solid;
+    border-width: 1px;
+    padding: 1ex 1ex 1ex 4ex;
+    margin: 1ex;
+}
+
+.warningmessages {
+    border-color: yellow;
+}
+
+.criticalmessages {
+    border-color: red;
+}
+
+.alert {
+    color: red;
+    background-color: inherit;
+}
+
+.confirmation {
+    background-color: red;
+    padding: 3ex;
+    width: 70%;
+}
+
+p.areyoureallyreallysure {
+    color: red;
+    font-size: 120%;
+    font-weight: bold;
+}
+
+tr.param_disabled {
+    background-color: lightgrey;
+}
+
+td.admin_links {
+    width: 50%;
+    padding: 1em;
+    vertical-align: top;
+}
+
+td.admin_links dt {
+    margin-top: 1em;
+}
+
+td.admin_links dt.forbidden, td.admin_links dd.forbidden {
+    font-size: smaller;
+    font-style: italic;
+    color: #aaa;
+}
+
+td.admin_links dt.forbidden a, td.admin_links dd.forbidden a {
+    text-decoration: none;
+    color: inherit;
+    cursor: default;
+}
+
+.col-header {
+    width: 8em;
+}
+
+.checkbox-cell {
+    border: 1px black solid;
+}
+
+/* Grey-green color */
+.open-status {
+    color: #286;
+}
+
+/* Brown-red color */
+.closed-status {
+    color: #a63;
+}
+
+/* Dark green color */
+.checked {
+    background-color: #5b4;
+}
+
+/* Dark red color */
+td.forbidden {
+    background-color: #811;
+}
+
+/* Light green color */
+td.set {
+    background-color: #efe;
+}
+
+/* Light red color */
+td.unset {
+    background-color: #fee;
+}
+
+tr.highlight:hover {
+    background-color: yellow;
+}
+
+th.title {
+    font-size: larger;
+    text-align: center;
+    vertical-align: middle;
+}
+
+#edit_custom_field tr {
+    vertical-align: top;
+}
+
+#edit_custom_field th {
+    text-align: right;
+}
+
+#edit_custom_field th.narrow_label {
+    white-space: normal;
+}

diff --git a/skins/standard/attachment.css b/skins/standard/attachment.css
new file mode 100644 (file)
index 0000000..3f037c9
--- /dev/null
+++ b/skins/standard/attachment.css
@@ -0,0 +1,236 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+table.attachment_entry th {
+    text-align: right;
+    vertical-align: baseline;
+    white-space: nowrap;
+}
+
+table.attachment_entry td {
+    text-align: left;
+    vertical-align: baseline;
+    padding-bottom: 5px;
+}
+
+table#flags th,
+table#flags td {
+    text-align: left;
+    vertical-align: baseline;
+    font-size: small;
+}
+
+/* Rules used to view patches in diff mode. */
+
+.file_head {
+  font-weight: bold;
+  font-size: 1em;
+  background-color: #c3c3c3;
+  border: 1px solid black;
+}
+
+.file_head a {
+  text-decoration: none;
+  font-family: monospace;
+  font-size: 1.1em;
+}
+
+.file_collapse {
+  display: none;
+}
+
+.section_head {
+  background-color: #f0f0f0;
+  border: 1px solid black;
+  text-align: left;
+}
+
+table.file_table {
+  table-layout: fixed;
+  width: 100%;
+  empty-cells: show;
+  border-spacing: 0px;
+  border-collapse: collapse;
+  /* draw border below last open context section in listing */
+  border-bottom: 1px solid black;
+}
+
+tbody.file pre {
+  display: inline;
+  font-size: 0.9em;
+}
+
+tbody.file pre:empty {
+  display: block;
+}
+
+.changed {
+  background-color: lightblue;
+}
+
+.added {
+  background-color: lightgreen;
+}
+
+.removed {
+  background-color: #FFCC99;
+}
+
+.num {
+  background-color: #ffe9ae;
+  text-align:right;
+  padding: 0 0.3em;
+  width: 3em;
+}
+
+table.attachment_info th {
+    text-align: right;
+    vertical-align: top;
+}
+
+table.attachment_info td {
+    text-align: left;
+    vertical-align: top;
+}
+
+/* Text displayed when the attachment is not viewable by the web browser */
+#noview {
+    text-align: left;
+    vertical-align: middle;
+}
+
+#attachment_attributes div {
+    padding-bottom: 0.4em;
+}
+
+#attachment_attributes label,
+#attachment_attributes span.label,
+#attachment_actions span.label
+{
+    font-weight: bold;
+}
+
+#attachment_attributes .block {
+    display: block;
+}
+
+#smallCommentFrame, #attachment_flags {
+    float: left;
+}
+
+#smallCommentFrame {
+    margin-right: 1.5em;
+}
+
+#attachment_comments_and_flags, #attachment_actions {
+    clear: both;
+    margin-bottom: 1ex;
+}
+
+#attachment_information_read_only .title {
+    font-weight: bold;
+    font-size: 1.5em;
+    padding: 0;
+    margin: 0;
+}
+
+#attachment_information_read_only .title #bz_edit {
+    font-size: 0.7em;
+}
+
+#attachment_information_read_only .details {
+    font-size: 90%;
+}
+
+#attachment_info.read #attachment_information_edit {
+    display: none;
+}
+
+#attachment_info.edit #attachment_information_read_only {
+    display: none;  
+}
+
+#attachment_info.edit #attachment_view_window {
+    float: left;
+    width: 80%;
+}
+
+#attachment_info.edit #attachment_information_edit {
+    width: 20%;
+}
+
+#attachment_info.edit #attachment_information_edit input.text,
+#attachment_info.edit #attachment_information_edit textarea {
+    width: 90%; 
+}
+
+#attachment_isobsolete {
+    padding-right: 1em;
+}
+
+#attachment_information_edit { 
+    float: left;
+}
+
+#smallCommentFrame textarea {
+    display: block;
+}
+
+textarea.bz_private {
+    border: 1px solid #F8C8BA;
+}
+
+#update {
+    clear: both; 
+    display: block;  
+}
+
+div#update_container {
+    clear: both; 
+    padding: 1.5em 0; 
+}
+
+#attachment_flags {
+    margin-bottom: 1em;
+}
+
+#attachment_flags p {
+    padding-bottom: 0;
+    margin-bottom: 0;
+}
+
+#editFrame, #viewDiffFrame, #viewFrame {
+    height: 400px; 
+    width: 95%;
+    margin-left: 2%;
+}
+
+.viewall_frame {
+    width: 75%;
+    height: 350px;
+}
+
+.details span.bz_private{
+  border-left: 1px solid darkred;
+  padding-left: 0.5em;
+}
+
+.no_javascript .bz_hide, .no_javascript .bz_edit {
+    display: none;
+}
+
+#hidden_obsolete_message {
+   text-align: left; 
+   width: 75%; 
+   margin: 0  auto; 
+   font-weight: bold
+}
+
+#description {
+    resize: vertical;
+}

diff --git a/skins/standard/buglist.css b/skins/standard/buglist.css
new file mode 100644 (file)
index 0000000..6d23fc8
--- /dev/null
+++ b/skins/standard/buglist.css
@@ -0,0 +1,131 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+.bz_query_head {
+  text-align: center;
+}
+
+.bz_query_timestamp {
+  font-weight: bold;
+}
+
+.search_description {
+  margin: .5em 0;
+  padding: 0;
+}
+.search_description li {
+  list-style-type: none;
+  display: inline;
+  margin-right: 2em;
+}
+
+.zero_results, .zero_result_links {
+  font-size: 120%;
+  font-weight: bold;
+}
+
+.bz_buglist_header th {
+  text-align: left;
+}
+
+.bz_sort_order_primary,
+.bz_sort_order_secondary {
+    display: inline-block;
+    padding-left: .2em;
+    text-decoration: none;
+}
+.bz_sort_order_primary   { color: black; }
+.bz_sort_order_secondary { color: #777;  }
+
+
+.bz_id_column {
+}
+
+.bz_row_odd {
+    background-color: #F7F7F7;
+    color: #000000;
+}
+
+.bz_row_even {
+    background-color: #FFFFFF;
+    color: #000000;
+}
+
+/* Style bug rows according to severity. */
+.bz_blocker { color: red; font-weight: bold; }
+.bz_critical { color: red; }
+.bz_enhancement { color: #666; background-color: white; }
+
+/* Align columns in the "change multiple bugs" form to the right. */
+table#form tr th { text-align: right; }
+
+table.bz_buglist td, table.bz_buglist th { 
+}
+
+/* we use a first-child class and not the pseudo-class because IE
+ * doesn't support it :-( */
+tr.bz_secure td.first-child, a.bz_secure { 
+  background-image: url("../../images/padlock.png");
+  background-position: center left;
+  background-repeat: no-repeat;
+  background-color: inherit;
+}
+
+th.first-child, td.first-child, a.bz_secure {
+  padding-left: 20px;
+}
+
+tr.bz_secure_mode_implied td.first-child {
+}
+
+tr.bz_secure_mode_manual td.first-child {
+}
+
+td.bz_estimated_time_column,
+td.bz_remaining_time_column,
+td.bz_actual_time_column,
+td.bz_percentage_complete_column {
+    text-align: right;
+}
+
+td.bz_total_label {
+    font-weight: bold;
+}
+
+td.bz_total {
+    border-top-style: solid;
+    border-top-color: #929bb1;
+    border-top-width: 3px;
+    text-align: right;
+}
+
+#commit, #action {
+  margin-top: .25em;
+}
+
+.bz_query_debug {
+    text-align: left;
+}
+
+.bz_short_desc_column a, .bz_short_short_desc_column a {
+    color: inherit;
+}
+
+/* The "filtering" table is specific to request.cgi.
+ * Same for the "requests" class used for tables. */
+
+#filtering #requester, #filtering #requestee {
+    min-width: 8em;
+}
+
+#filtering th {
+    text-align: right;
+}
+
+table.requests th {
+    text-align: left;
+}

diff --git a/skins/standard/dependency-tree.css b/skins/standard/dependency-tree.css
new file mode 100644 (file)
index 0000000..0051fca
--- /dev/null
+++ b/skins/standard/dependency-tree.css
@@ -0,0 +1,80 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+ul.tree {
+    padding-left: 0em;
+    margin-left: 1em;
+    display: block;
+}
+
+ul.tree ul {
+    padding-top: 3px;
+    display: block;
+}
+
+ul.tree li { 
+    /* see http://www.kryogenix.org/code/browser/aqlists/ for idea */
+    padding-top: 3px; 
+    text-indent: -1.2em; 
+    padding-left: 0.5em; 
+    padding-bottom: 3px;
+    list-style-type: none;
+    background: url("dependency-tree/bug-item.png") no-repeat;
+}
+
+ul.tree li a.b {
+    padding-left: 30px; 
+    margin-right: -14px; 
+    text-decoration: none;
+}
+
+ul.tree li a.b_open {
+    background: url("dependency-tree/tree-open.png") center no-repeat;
+    cursor: pointer;
+}
+
+ul.tree li a.b_closed {
+    background: url("dependency-tree/tree-closed.png") center no-repeat;
+    cursor: pointer;
+}
+
+ul.tree a.tree_link img {
+    border: 0;
+}
+
+.summ_info {
+    /* change to inline if you would like to see the full bug details
+     * displayed in the list */
+    display: none; 
+    font-size: 75%;
+}
+
+.hint {
+    font-size: 90%;
+    margin: 0.2em;
+    padding: 0.1em;
+}
+
+.hint h3, .hint ul {
+    margin-top: 0.1em;
+    margin-bottom: 0.1em;
+}
+
+.summ A, .summ_deep A {
+    text-decoration: none;
+    color: darkblue;
+}
+
+.summ_deep {
+}
+
+.summ_h A {
+    background-color: #ffffaa;
+    color: #333;
+    font-weight: bold;
+}

diff --git a/skins/standard/dependency-tree/bug-item.png b/skins/standard/dependency-tree/bug-item.png
new file mode 100644 (file)
index 0000000..051025d
Binary files /dev/null and b/skins/standard/dependency-tree/bug-item.png differ

diff --git a/skins/standard/dependency-tree/tree-closed.png b/skins/standard/dependency-tree/tree-closed.png
new file mode 100644 (file)
index 0000000..80f1e2b
Binary files /dev/null and b/skins/standard/dependency-tree/tree-closed.png differ

diff --git a/skins/standard/dependency-tree/tree-open.png b/skins/standard/dependency-tree/tree-open.png
new file mode 100644 (file)
index 0000000..eeb3e6b
Binary files /dev/null and b/skins/standard/dependency-tree/tree-open.png differ

diff --git a/skins/standard/dependency-tree/tree.png b/skins/standard/dependency-tree/tree.png
new file mode 100644 (file)
index 0000000..884d347
Binary files /dev/null and b/skins/standard/dependency-tree/tree.png differ

diff --git a/skins/standard/duplicates.css b/skins/standard/duplicates.css
new file mode 100644 (file)
index 0000000..b531597
--- /dev/null
+++ b/skins/standard/duplicates.css
@@ -0,0 +1,37 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+#duplicates_table {
+  border-collapse: collapse;
+}
+
+#duplicates_table .resolved {
+  background-color: #d9d9d9; 
+  color: black;
+}
+
+#duplicates_table thead tr {
+  background-color: #ccc;
+  color: black;
+}
+
+#duplicates_table thead tr th {
+  vertical-align: middle;
+}
+
+#duplicates_table td, #duplicates_table th {
+  border: 1px solid black;
+  padding: .1em .25em;
+}
+
+#duplicates_table tbody td {
+  text-align: center;
+}
+#duplicates_table tbody td.short_desc {
+  text-align: left;
+}

diff --git a/skins/standard/editusers.css b/skins/standard/editusers.css
new file mode 100644 (file)
index 0000000..fb38af6
--- /dev/null
+++ b/skins/standard/editusers.css
@@ -0,0 +1,64 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+table.main {
+    border-spacing: 1em;
+}
+table.main tr {
+    vertical-align: top;
+    border-top: solid thin black;
+}
+table.main th {
+    text-align: right;
+    white-space: nowrap;
+}
+table.main th,
+table.main td {
+    padding: 0;
+}
+table.main ul {
+    list-style-type: none;
+    padding-left: 0
+}
+
+table.groups {
+    border-spacing: 1px;
+}
+table.groups tr.indirect {
+    background-color: #cccccc;
+}
+table.groups th {
+    text-align: left;
+    padding: 0 0 0 1ex;
+}
+table.groups td {
+    padding: 2px;
+}
+table.groups td.checkbox {
+    text-align: center;
+    white-space: nowrap;
+}
+
+table#user_responsibilities th {
+    text-align: center;
+    padding: 0 1em 1em;
+}
+
+table#user_responsibilities th.product {
+    text-align: left;
+    padding: 1em 0 0;
+}
+
+table#user_responsibilities td.center {
+    text-align: center;
+}
+
+.missing {
+    color: red;
+    border-color: inherit;
+}

diff --git a/skins/standard/enter_bug.css b/skins/standard/enter_bug.css
new file mode 100644 (file)
index 0000000..e0f1ab6
--- /dev/null
+++ b/skins/standard/enter_bug.css
@@ -0,0 +1,55 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+/* These are specified using the class instead of the id so that they
+   don't override the YUI CSS. */
+.enter_bug_form table {
+    border-spacing: 0;
+    border-width: 0;
+}
+.enter_bug_form td, .enter_bug_form th { padding: .25em; }
+.enter_bug_form th { text-align: right; }
+
+/* This makes the "component" column as small as possible (since it
+ * contains only fixed-width content) and the Reporter column
+ * as large as possible, which makes the form not jump around
+ * when the Component Description changes size. This works
+ * pretty well on all browsers except IE 8.
+ */
+#Create #field_container_component { width: 1px; }
+#Create #field_container_reporter  { width: 100%; }
+
+#Create .comment {
+    vertical-align: top;
+    overflow: auto;
+    color: green;
+}
+#Create #comp_desc_container td { padding: 0; }
+#Create #comp_desc { height: 11ex; }
+#Create #os_guess_note {
+    padding-top: 0;
+}
+#Create #os_guess_note div {
+    max-width: 35em;
+}
+
+/* Text inputs need to be a little shorter on enter_bug
+ * than the 100% that they are on show_bug.
+ */
+#Create .field_value .text_input { max-width: 50em; }
+
+/* The Possible Duplicates table on enter_bug. */
+#possible_duplicates th {
+    text-align: center; 
+    background: none;
+    border-collapse: collapse;
+}
+/* Make the Add Me to CC button never wrap. */
+#possible_duplicates .yui-dt-col-update_token { white-space: nowrap; }
+
+form#Create #possible_duplicates td { vertical-align: middle; }

diff --git a/skins/standard/global.css b/skins/standard/global.css
new file mode 100644 (file)
index 0000000..e829a7f
--- /dev/null
+++ b/skins/standard/global.css
@@ -0,0 +1,551 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+/* global (begin) */
+    body {
+        font-family: sans-serif;
+        color: #000;
+        background: #fff url("global/body-back.gif") repeat-x;
+    }
+    body, td, th, input {
+        font-family: Verdana, sans-serif;
+        font-size: small;
+    }
+    /* monospace is much smaller than Verdana by default, so we make it a bit bigger. */
+    pre, code, kbd {
+        font-size: medium;
+    }
+/* global (end) */
+
+/* header (begin) */
+    #header {
+        margin-bottom: 1em;
+    }
+
+    #header form, #header form input,
+    #footer form, #footer form input
+    {
+        font-size: 95%;
+        display: inline;
+    }
+
+    #header .links {
+        border-left: 1px solid #747E93;
+        border-right: 1px solid #747E93;
+        border-bottom: 1px solid #747E93;
+        border-bottom-left-radius: 5px;
+        border-bottom-right-radius: 5px;
+        padding: 0.5em;
+    }
+
+    #lang_links_container {
+        float: right;
+    }
+    #lang_links_container .links {
+        border: none;
+        padding: .5em;
+    }
+
+    .lang_current {
+        font-weight: bold;
+    }
+
+    #message {
+        border: 1px solid red;
+        margin: 0.3em 0em;
+        padding: 0.3em;
+        color: green;
+    }
+
+    form.mini_login input.bz_login  {
+        width: 10em;
+    }
+    form.mini_login input.bz_password {
+        width: 6em;
+    }
+    form.mini_login input.bz_remember {
+        margin: 0;
+    }
+    .bz_mini_login_help {
+        color: #777;
+    }
+
+/* header (end)   */
+
+/* banner (begin) */
+    #banner {
+    }
+
+/* banner (end) */
+
+/* titles (begin) */
+    #titles {
+        width: 100%;
+        background-color: #404D6C;
+        color: #fff;
+        border-top-left-radius: 5px;
+        border-top-right-radius: 5px;
+        font-size: 110%;
+        margin: 0;
+        padding: 0.5em;
+        vertical-align: bottom;
+    }
+
+    #titles a {
+        color: #fff;
+    }
+
+    #titles p {
+        margin: 0;
+        padding: 0;
+    }
+
+    #titles #title {
+        font-weight: bold;
+        white-space: nowrap;
+    }
+
+    #titles #subtitle {
+        font-weight: normal;
+        width: 100%;
+        text-align: center;
+    }
+
+    #titles #information {
+        font-weight: normal;
+        text-align: right;
+        font-size: 90%;
+        white-space: nowrap;
+    }
+
+/* titles (end) */
+
+/* footer (begin)
+ * See also the "header" section for styles that apply
+ * to both the header and footer. 
+ */
+    #footer {
+        clear: both;
+        margin-top: 1em;
+        width: 100%;
+        background: #edf2f2;
+        border-top: 1px solid #ddd;
+        border-bottom: 1px solid #ddd;
+    }
+
+    #footer #useful-links {
+        padding-left: 1ex;
+        padding-right: 1ex;
+    }
+
+    #footer ul {
+        list-style-type: none;
+    }
+    #links-saved ul {
+        display: inline;
+    }
+    #links-saved th {
+        vertical-align: top;
+    }
+
+    #footer .label {
+        white-space: nowrap;
+        vertical-align: top;
+    }
+
+    #footer .links {
+        vertical-align: top;
+    }
+/* footer (end) */
+
+/* link lists (begin) */
+    ul.links {
+        margin: 0;
+        padding: 0;
+        list-style-type: none;
+    }
+
+    ul.links li {
+        display: inline;
+        white-space: nowrap;
+    }
+/* link lists (end) */
+
+/* tabs (begin) */
+    .tabs td {
+        background: #eee;
+        text-align: center;
+        border-style: solid;
+        border-color: black;
+        border-width: 0px 0px 2px 0px;
+    }
+        
+    .tabs td.selected {
+        background: white;
+        border-width: 2px 2px 0px 2px;
+    }
+
+    .tabs td.spacer {
+        background: white;
+    }
+/* tabs (end) */
+
+/* generic (begin) */
+    a {
+        color: #039;
+    }
+
+    a:visited {
+        color: #636;
+    }
+
+    a:hover {
+        color: #333;
+    }
+
+    a:active {
+        color: #000;
+    }
+
+    .clickable_area {
+        cursor: pointer;
+    }
+
+    textarea {
+        font-family: monospace;
+    }
+/* generic (end) */
+
+/* Links that control whether or not something is visible. */
+a.controller {
+    font-size: 115%;
+}
+
+div#docslinks {
+    float: right;
+    border: 1px solid black;
+    padding: 1ex;
+    font-size: 80%;
+}
+
+#docslinks h2 {
+    margin: 0;
+}
+
+/**************************/
+/* Bug links and statuses */
+/**************************/
+
+.bz_bug_link {
+    /* Catch-all if you want common styles for all bug links */
+}
+
+.bz_bug_link .bz_status_UNCONFIRMED {
+    font-style: italic;
+}
+
+.bz_obsolete {
+    text-decoration: line-through;
+}
+.bz_inactive {
+    text-decoration: line-through;
+}
+.bz_closed,
+.bz_CLOSED td {
+    text-decoration: line-through;
+}
+.bz_private {
+    color: darkred;
+    background: #f3eeee;
+}
+.bz_disabled {
+    color: #a0a0a0;
+}
+
+/************/
+/* Comments */
+/************/
+
+.bz_comment_table td {
+    vertical-align: top;
+}
+
+.bz_comment {
+    margin-bottom: 2em;
+}
+
+/* tbody.file pre is for the Diff view of attachments. */
+.bz_comment_text, .uneditable_textarea, tbody.file pre {
+     font-family: monospace;
+     white-space: pre-wrap;
+}
+
+.bz_comment_text {
+     width: 50em;
+}
+
+.bz_comment_user, .bz_comment_time, .bz_comment_number, 
+.bz_private_checkbox, .bz_comment_actions
+{
+    margin: 0 .5em;
+}
+
+.bz_comment_actions, .bz_comment_number, .bz_private_checkbox {
+    float: right;
+}
+
+.bz_collapse_expand_comments {
+    padding: 0;
+    margin: 0 0 0 1em;
+    list-style-type: none;
+}
+.bz_collapse_expand_comments li {
+    margin-bottom: .5em;
+}
+.bz_collapse_comment {
+    text-decoration: none;
+}
+
+.bz_private_checkbox input { 
+    margin: 0;
+    vertical-align: middle;
+}
+
+.bz_comment_head, .bz_first_comment_head {
+    padding-top: .1em;
+    padding-bottom: .1em;
+    padding-left: .5em;
+    background-color: #e0e0e0;
+}
+
+.bz_comment_user_images img {
+    vertical-align: bottom;
+}
+
+.bz_comment_hilite pre {
+    background-color: lightgreen;
+    margin: 0;
+    padding: 1em 0;
+}
+
+/** End Comments **/
+
+.bz_default_hidden, .bz_tui_hidden, .bz_hidden_field, .bz_hidden_option {
+    /* We have !important because we want elements with these classes to always
+     * be hidden, even if there is some CSS that overrides it (we use these
+     * classes inside JavaScript to hide things). */
+    display: none !important;
+}
+
+.bz_comment_text span.quote {
+    color: #65379c;
+    /* Make quoted text not wrap. */
+    white-space: pre;
+}
+
+table#flags th,
+table#flags td {
+    vertical-align: middle;
+    text-align: left;
+}
+
+.flag_select {
+    min-width: 3em;
+}
+
+input.requestee {
+    width: 15em;
+}
+
+#error_msg {
+    font-size: x-large;
+}
+
+.warning {
+  color: red;
+}
+
+.throw_error {
+    background-color: #ff0000;
+    color: black;
+    font-size: 120%;
+    margin: 1em;
+    padding: 0.5em 1em;
+}
+
+dt {
+    font-weight: bold;
+}
+body > dl > dt {
+    border-top: dotted gray thin;
+}
+dl dl > dt {
+    border-top: none;
+}
+
+#admin_table th {
+    white-space: normal !important;
+}
+
+/* Arrow buttons are buttons with only ↑, ↓, ← or → on
+ * them. We want these to look a little less spidery. */
+.arrow_button {
+    font-size: 150%;
+}
+
+/* Style of the attachment table and time tracking table */
+#attachment_table {
+    border-collapse: collapse;
+    border: 1px solid #333333;
+}
+
+#attachment_table th, .bz_attach_footer, .bz_time_tracking_table th {
+    background-color: #E0E0E0;
+    color: black;
+}
+
+#attachment_table td, .bz_time_tracking_table th, .bz_time_tracking_table td {
+    border: 1px solid #333333;
+}
+
+.bz_attach_extra_info {
+    font-size: smaller;
+}
+
+.bz_attach_flags, .bz_attach_footer {
+    white-space: nowrap;
+}
+
+.bz_attach_view_hide {
+    float: right;
+    padding-left: 1em;
+}
+
+div.user_match {
+    margin-bottom: 1em;
+}
+
+.box {
+    border: 1px solid black;
+    color: black;
+    background-color: #ffc;
+    margin: 1em;
+    padding: 0.5em 1em;
+}
+
+.collapsed {
+    display: none;
+}
+
+/* Rules specific for printing */
+@media print {
+    #header, #footer {
+        display: none;
+    }
+
+    div.bz_query_buttons {
+        display: none;
+    }
+
+    body {
+        background-image: none;
+        background-color: #fff;
+    }
+}
+
+/**************/
+/* Bug Fields */
+/**************/
+
+.field_label {
+    text-align: right;
+    vertical-align: top;
+    font-weight: bold;
+}
+.field_help_link {
+    cursor: help;
+}
+.field_value, form#Create th, form#Create td {
+    vertical-align: top;
+}
+.field_value .text_input {
+  width: 100%;
+  min-width: 25em;
+}
+
+.uneditable_textarea {
+    width: 30em;
+    font-size: medium;
+}
+
+th.required:before {
+    content: "* ";
+}
+th.required:before, span.required_star {
+    color: red;
+}
+input.required, select.required, span.required_explanation {
+    background-color: #fff7cd;
+    color: #000;
+}
+
+.calendar_button {
+    background: transparent url("global/calendar.png") no-repeat;
+    width: 20px;
+    height: 20px;
+    vertical-align: middle;
+}
+.calendar_button span { display: none }
+/* These classes are set by YUI. */
+.yui-calcontainer {
+    display: none; 
+    background-color: white; 
+    padding: 10px;
+    border: 1px solid #404D6C;
+}
+
+.bug_urls {
+    margin: 0 0 1em 0;
+    padding: 0;
+    list-style-type: none;
+}
+
+/* custom styles for inline instances of autocomplete input fields */
+.yui-skin-sam .yui-ac-input { position:static !important; 
+                              vertical-align:middle !important; }
+.yui-skin-sam .yui-ac-container { left:0px !important; }
+.yui-skin-sam .yui-ac { display: inline-block; }
+#bugzilla-body .yui-ac-content {
+    max-height: 19em;
+    overflow: auto;
+    overflow-x: hidden;
+}
+
+#keywords_container {
+    padding-top: .2em;
+}
+
+
+#keywords_container .yui-ac-content {
+    margin-left: -1px;
+}
+
+/*******************/
+/* Form Validation */
+/*******************/
+
+.validation_error_text {
+    font-size: 120%;
+    color: #B70000;
+    font-weight: bold;
+}
+
+.validation_error_field, input.validation_error_field {
+    border: 2px solid #B70000;
+    background-color: #FFEBEB;
+}

diff --git a/skins/standard/global/body-back.gif b/skins/standard/global/body-back.gif
new file mode 100644 (file)
index 0000000..72a0d3e
Binary files /dev/null and b/skins/standard/global/body-back.gif differ

diff --git a/skins/standard/global/calendar.png b/skins/standard/global/calendar.png
new file mode 100644 (file)
index 0000000..0eb9ca7
Binary files /dev/null and b/skins/standard/global/calendar.png differ

diff --git a/skins/standard/global/header.png b/skins/standard/global/header.png
new file mode 100644 (file)
index 0000000..eca3f35
Binary files /dev/null and b/skins/standard/global/header.png differ

diff --git a/skins/standard/index.css b/skins/standard/index.css
new file mode 100644 (file)
index 0000000..5956920
--- /dev/null
+++ b/skins/standard/index.css
@@ -0,0 +1,135 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+/* index page (begin) */
+
+    #page-index
+    {
+        padding: 0.2em 0.2em 0.15em 0.2em;
+        max-width: 1000px;
+    }
+
+    /* By default these contain nothing, but these CSS rules make things
+       easier on customizers. */
+    .intro, .outro {
+        text-align: center;
+    }
+
+    /* Hide from NN4 */
+
+    #new_release
+    {
+        border: 2px solid red;
+        padding: 0.5em 1em;
+        margin: 1em;
+        font-weight: bold;
+    }
+
+    #new_release .notice
+    {
+        font-size: 80%;
+        font-weight: normal;
+    }
+
+    #welcome-admin a
+    {
+        font-weight: bold;
+    }
+
+    .bz_common_actions {
+        text-align: center;
+    }
+    .bz_common_actions ul {
+        list-style-type: none;
+        padding: 0;
+    }
+    .bz_common_actions ul li {
+        display: inline;
+        vertical-align: top;
+    }
+    .bz_common_actions ul li a {
+        display: inline-block;
+        height: 170px;
+        width: 145px;
+        margin: 0 2ex 2em 0;
+    }
+    .bz_common_actions ul li a span {
+        position: relative;
+        top: 90%;
+        font-weight: bold;
+    }
+    .bz_common_actions a,
+    .bz_common_actions a:visited,
+    .bz_common_actions a:hover {
+        text-decoration: none;
+    }
+    #enter_bug { background: url(index/file-a-bug.png)     no-repeat; }
+    #query     { background: url(index/search.png)  no-repeat; }
+    #account   { 
+      background: url(index/new-account.png) no-repeat; 
+      margin-right: 0;
+    }
+    
+    #quicksearchForm
+    {
+        clear: both;
+        text-align: center;
+        margin-bottom: 2em;
+    }
+    
+    #quicksearchForm #quicksearch_main
+    {
+        width: 27em;
+    }
+    
+    #quicksearchForm
+    {
+        margin: 0;
+        padding: 0;
+    }
+    
+    #page-index table{
+        border-collapse: collapse;
+        margin: auto;
+    }
+    
+    #welcome
+    {
+        font-size: x-large;
+        font-weight: bold;
+        text-align: center;
+        margin: 0 0 0.8em 0;
+        padding: 0;
+    }
+    
+    ul.additional_links 
+    {
+        list-style: none;
+        margin: 0;
+        padding: 0;
+    }
+    
+    ul#quicksearch_links{
+        margin-bottom: 1em;
+    }
+    
+    ul.additional_links li
+    {
+        display: inline;
+    }
+    
+    ul.additional_links li.bz_default_hidden
+    {
+        display: none;
+    }
+    
+    input.quicksearch_help_text
+    {
+        color: #ccc;
+    }
+/* index page (end) */

diff --git a/skins/standard/index/file-a-bug.png b/skins/standard/index/file-a-bug.png
new file mode 100644 (file)
index 0000000..cf4c941
Binary files /dev/null and b/skins/standard/index/file-a-bug.png differ

diff --git a/skins/standard/index/help.png b/skins/standard/index/help.png
new file mode 100644 (file)
index 0000000..6f9035b
Binary files /dev/null and b/skins/standard/index/help.png differ

diff --git a/skins/standard/index/new-account.png b/skins/standard/index/new-account.png
new file mode 100644 (file)
index 0000000..4ad9ff2
Binary files /dev/null and b/skins/standard/index/new-account.png differ

diff --git a/skins/standard/index/search.png b/skins/standard/index/search.png
new file mode 100644 (file)
index 0000000..8d33ebd
Binary files /dev/null and b/skins/standard/index/search.png differ

diff --git a/skins/standard/page.css b/skins/standard/page.css
new file mode 100644 (file)
index 0000000..f4037f3
--- /dev/null
+++ b/skins/standard/page.css
@@ -0,0 +1,92 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+/* This CSS is used by various informational pages in the
+   template/en/default/pages/ directory. */
+
+#bugzilla-body {
+    padding: 0 1em;
+}
+
+#bugzilla-body > * {
+    /* People have an easier time reading narrower columns of text. */
+    max-width: 45em;
+}
+
+/*****************/
+/* Release Notes */
+/*****************/
+
+.req_new {
+    color: red;
+}
+
+.req_table {
+    border-collapse: collapse;
+}
+
+.req_table td, .req_table th {
+    border: 1px solid black;
+    padding: .25em;
+}
+
+/********************/
+/* QuickSearch Help */
+/********************/
+
+.qs_help li {
+   margin-top: 1ex;
+}
+
+.qs_fields th {
+    padding: 0 .25em;
+}
+.qs_fields th.field_nickname {
+    text-align: left;
+}
+.qs_fields td {
+    padding: .25em;
+    border-top: 1px solid gray;
+}
+.qs_fields .field_name {
+    width: 10em;
+}
+
+/***************/
+/* fields.html */
+/***************/
+
+table.field_value_explanation {
+  table-layout: fixed;
+  border-collapse: collapse;
+}
+
+.field_value_explanation thead h2 {
+  margin: 0;
+}
+
+.field_value_explanation .header_row td {
+  text-align: center;
+  font-size: 120%;
+  font-weight: bold;
+}
+
+.field_value_explanation tbody td {
+  border: 1px solid black;
+  padding: 1em;
+}
+
+.field_value_explanation dt,
+.field_descriptions dt
+{
+  margin-top: 1em;
+}
+
+.field_descriptions dt {
+  font-size: 120%;
+}

diff --git a/skins/standard/params.css b/skins/standard/params.css
new file mode 100644 (file)
index 0000000..92bd6d0
--- /dev/null
+++ b/skins/standard/params.css
@@ -0,0 +1,69 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+#menu {
+  width: 10em;
+  margin-top: 1em;
+  margin-right: 0.5em;
+  border: solid thin;
+  border-spacing: 0px;
+  border-collapse: collapse;
+  text-align: center;
+  color: black;
+  background-color: #edf2f2;
+  font-weight: normal;
+}
+
+#menu a:link, #menu a:visited {
+  color: #039;
+  background-color: transparent;
+}
+
+#menu a:hover, #menu a:active {
+  color: red;
+  background-color: transparent;
+}
+
+#menu td {
+  border: solid thin;
+  padding: 0.2em 0.5em;
+}
+
+table td {
+  vertical-align: top;
+}
+
+td.selected_section {
+  color: #090;
+  background-color: white;
+}
+
+td.index {
+  color: black;
+  background-color: #edf;
+}
+
+dt {
+  font-weight: bold;
+}
+
+dd {
+  margin-bottom: 1.5em;
+}
+
+.sortlist_separator {
+    font-weight: bold;
+    font-size: 80%;
+    background-color: #dddddd;
+}
+
+.contribute {
+    border: 1px dotted black;
+    padding: .5em;
+    font-size: small;
+}

diff --git a/skins/standard/reports.css b/skins/standard/reports.css
new file mode 100644 (file)
index 0000000..97ef316
--- /dev/null
+++ b/skins/standard/reports.css
@@ -0,0 +1,104 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+/* describecomponents.cgi */
+
+#components_header_table {
+  margin-bottom: 1em;
+}
+
+.product_container {
+  width: 65%;
+}
+
+.product_name {
+  font-weight: bold;
+  font-size: 150%;
+  margin: 0;
+}
+
+.product_desc {
+  /* This is padding instead of margin because it looks better 
+   * with the scrollbar. */
+  padding: 0 2em;
+  font-style: italic;
+  max-height: 5em;
+  overflow: auto;
+}
+
+.instructions {
+  font-weight: bold;
+  font-size: 105%;
+  padding-right: 1em;
+}
+
+.components_header {
+  margin: 0;
+  font-size: 140%;
+  font-weight: bold;
+}
+
+.component_table {
+  margin-top: -1em;
+  margin-left: 2em;
+}
+
+.component_table thead th {
+  padding-right: 1em;
+  vertical-align: bottom;
+  text-align: left;
+}
+
+.component_table td {
+  border-bottom: 1px dotted gray;
+}
+
+.component_table td.component_assignee,
+.component_table td.component_qa_contact
+{
+  border: none;
+  padding-top: .5em;
+}
+
+.component_name {
+  font-size: 115%;
+  font-weight: bold;
+  padding-right: 1em;
+  vertical-align: middle;
+  min-width: 8em;
+}
+
+.component_description {
+  padding-bottom: .5em;
+  color: #333;
+}
+
+.t1 {
+  background-color: #ffffff; /* white */
+}
+
+.t2 {
+  background-color: #dfefff;  /* light blue */
+}
+
+.t3 {
+  background-color: #dddddd;  /* grey */
+}
+
+.t4 {
+  background-color: #c3d3ed; /* darker blue */
+}
+
+.ttotal, .ttotal td {
+  background-color: #cfffdf; /* light green */
+}
+
+#graphical_report {
+  max-width: 100%;
+  height: auto;
+}

diff --git a/skins/standard/search_form.css b/skins/standard/search_form.css
new file mode 100644 (file)
index 0000000..e3a2ba1
--- /dev/null
+++ b/skins/standard/search_form.css
@@ -0,0 +1,194 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+#summary_field {
+  padding: 1em;
+  margin: 1em;
+  border: 1px solid black;
+  background-color: #eee;
+  white-space: nowrap;
+}
+
+#bug_id_container { 
+  display: inline-block;
+  vertical-align: middle;
+  padding-bottom: 1ex;
+}
+
+#bug_id_container input {
+  width: 9em;
+}
+
+.container_date_from, 
+.container_date_to {
+  width: 14em;
+  padding-bottom: 1ex;
+}
+.container_date_from input,
+.container_date_to input {
+  width: 8em;
+}
+
+#bug_id_container input {
+  width: 9em;
+}
+
+#bug_id_type{
+  width: inherit;
+}
+
+.search_field_grid {
+  margin-top: 1em;
+  display: inline-block;
+}
+
+.search_field_grid .field_help_link, 
+.history_query .field_help_link 
+{
+  display: block;
+  text-align: left;
+}
+
+#chart .section_help {
+  font-size: 0.8em; 
+  font-weight: normal
+}
+
+#bug_id_container .field_help {
+  font-size: 0.75em
+}
+
+.search_field_row {
+  white-space: nowrap;
+  margin-bottom: 0.5em;
+}
+
+.search_field_row .container_date_from, .search_field_row .container_date_to {
+  display: inline;
+}
+
+#summary_field.search_field_row {
+  display: block;
+}
+
+#summary_field.search_field_row input, 
+#summary_field.search_field_row select
+{
+  display: inline;
+  padding-bottom: 0;
+  vertical-align: middle;
+}
+
+.search_field_row .field_label, #field_label_short_desc  {
+  width: 14em;
+  display: inline-block;
+  line-height: 2em;
+  margin-right: 0.8em;
+}
+
+#field_label_short_desc {
+  text-align: right;
+}
+
+#summary_field.search_field_row {
+  width: inherit;
+}
+
+#keywords_container {
+  padding-bottom: 0;
+}
+
+.search_field_grid .field_label,
+.search_field_grid .field_label
+ {
+  display: block;
+  padding-bottom: 1ex;
+}
+
+.search_field_grid select {
+  width: 17em;
+  height: 15ex;
+}
+
+.search_field_grid, .search_field_row {
+  padding-left: 1.5em;
+}
+
+.search_email_fields {
+  display: inline-block;
+  width: 14.5em;
+  padding-left: 1.5em;
+}
+
+ul.bug_changes {
+  margin: 0;
+  padding: 0;
+}
+
+ul.bug_changes li {
+  display: inline-block;
+  width: 14.5em;
+  vertical-align: top;
+  padding-left: 1.5em;
+}
+
+ul.bug_changes select {
+  width: 15em;
+}
+
+ul.bug_changes li label {
+   display: block;
+}
+
+div.bz_section_title {
+  display: block;
+  margin-top: 2em;
+  font-size: 1.2em;
+}
+
+div.bz_section_title a {
+  font-weight: bold;    
+}
+
+div.bz_section_title span {
+  font-size: 0.75em;
+  margin-left: 1em;    
+}  
+
+#summary_field label {
+  font-weight: bold;
+}
+
+#queryform, #reportform {
+  margin-bottom: 2em;
+}
+
+#knob {
+  margin-top: 2em;
+}
+
+.hide_people_filter #people_filter_section, 
+.hide_history_filter #history_filter_section, 
+.hide_detailed_information #detailed_information_section 
+{
+  display: none;
+}
+
+.arrow {
+  display: inline;
+  width: 16px;
+  height: 16px;
+}
+
+.bz_search_section, ul.bz_search_section {
+  margin-top: 1em;
+}
+
+.bz_simple_search_form th {
+  text-align: right;
+}

diff --git a/skins/standard/show_bug.css b/skins/standard/show_bug.css
new file mode 100644 (file)
index 0000000..b776b60
--- /dev/null
+++ b/skins/standard/show_bug.css
@@ -0,0 +1,126 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+.bz_alias_short_desc_container {
+    margin: 8px 0; 
+    padding: 0.3em; 
+    background-color: rgb(208, 208, 208); 
+    border-radius: 0.5em;
+    font-size: 125%; 
+    font-weight: bold;
+}
+
+.bz_bug .edit_form {
+  width: 100%;
+}
+.bz_bug .edit_form table {
+  width: 100%;
+}
+.bz_bug #alias {
+    min-width: 0;
+    width: 10em;
+}
+
+.flags_label {
+    text-align: left;
+}
+table#flags {
+    width: auto;
+}
+
+.bz_column_spacer {
+    width: 0.5em;
+}
+
+.related_actions {
+    font-size: 0.85em; 
+    float: right;
+    list-style-type: none;
+    white-space: nowrap;
+    margin: 0;
+    padding: 0;
+}
+
+.related_actions li {
+    display: inline;
+}
+
+.bz_show_bug_column {
+  vertical-align: top;
+}
+
+.bz_section_spacer {
+    height: 1em;
+}
+
+#duplicate_settings {
+    white-space: nowrap;
+}
+
+#bz_big_form_parts td {
+    vertical-align: top;
+}
+
+.bz_group_visibility_section {
+    margin-left: 1em;
+}
+
+.bz_group_visibility_section .instructions {
+    font-style: italic;
+}
+
+#bz_restrict_group_visibility_help .instructions {
+    margin-top: 0;
+}
+
+#bz_enable_role_visibility_help {
+    margin-top: 1em;
+}
+
+.bz_time_tracking_table {
+    border-collapse: collapse;
+}
+
+.bz_time_tracking_table th {
+    text-align: center;
+}
+
+.bz_time_tracking_table td {
+    text-align: center;
+}
+
+.bz_time_tracking_table th, 
+.bz_time_tracking_table td {
+    padding: 4px;
+}
+
+.bz_time_tracking_table .bz_summarize_time {
+    text-align: right;
+}
+.bz_time_tracking_table #deadline {
+    width: 7em;
+}
+
+#summary tr td { 
+    vertical-align:top;
+}
+
+#status { 
+    margin-bottom: 3ex;
+}
+
+.knob-buttons {
+    float: right;
+}
+
+.text_input, .bz_userfield, #keywords_container, #tag_container {
+    width: 100%;
+}
+.bz_bug .bz_alias_short_desc_container {
+    width: inherit;
+}

diff --git a/skins/standard/show_multiple.css b/skins/standard/show_multiple.css
new file mode 100644 (file)
index 0000000..dbfa6eb
--- /dev/null
+++ b/skins/standard/show_multiple.css
@@ -0,0 +1,60 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+hr {margin: 20px auto 40px}
+
+.bz_private { color:darkred }
+
+h1 {
+  font-size: 2em;
+  margin-bottom: 10px;
+}
+
+/* bugfields is table of all fields and values */
+.bugfields {
+  font-size: small;
+  background: #eee;
+  padding: 5px;
+  border: 1px solid silver;
+  width: 100%;
+}
+
+.bugfields tr {
+  vertical-align: top;
+}
+
+.bugfields th {
+  width: 10em;
+  text-align: left;
+  font-weight: normal;
+  line-height: 150%;
+}
+
+.bugfields td {
+  font-weight: bold;
+  line-height: 150%;
+}
+
+.bugfields .rightcell {
+  padding-left: 10px;
+}
+
+/* set line-height to normal for nested tables of bugfields table */
+.bugfields table th, .bugfields table td {
+  line-height: 100%;
+  width: auto;
+}
+
+.bugfields table.timetracking th, .bugfields table.timetracking td {
+  width: 10em;
+}
+
+.error {
+  color: red;
+  font-weight: bold;
+}

diff --git a/skins/standard/summarize-time.css b/skins/standard/summarize-time.css
new file mode 100644 (file)
index 0000000..bb42da6
--- /dev/null
+++ b/skins/standard/summarize-time.css
@@ -0,0 +1,37 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+
+td { vertical-align: top }
+
+table.zeroitems, table.realitems {
+    margin-left: 2.0em;
+    margin-top: 2px;
+    border: 1px solid black;
+    border: 1px solid black;
+}
+
+tr.section_total {
+    background: #000000;
+    color: #ffffff;
+}
+
+td.subtotal {
+    background: #B0C0D9;
+}
+
+.zeroitems .bug_header { background: #d0e0f0 }
+.zeroitems .bug_header2 { background: #f9f9f9 }
+
+/* the fixed headers -- .number uses bug_header so hack it here */
+.number .bug_header, .number .bug_header2 { background: #d0e0f0 }
+.owner_header { background: #d0e0f0 }
+
+
+/* the details headers */
+.number .owner_header, .owner .bug_header { background: #ffffff }
+.number .owner_header2, .owner .bug_header2 { background: #EFEFEF }

diff --git a/summarize_time.cgi b/summarize_time.cgi
new file mode 100755 (executable)
index 0000000..5e0df95
--- /dev/null
+++ b/summarize_time.cgi
@@ -0,0 +1,362 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+use lib qw(. lib);
+
+use Date::Parse;         # strptime
+
+use Bugzilla;
+use Bugzilla::Constants; # LOGIN_*
+use Bugzilla::Bug;       # EmitDependList
+use Bugzilla::Util;      # trim
+use Bugzilla::Error;
+
+#
+# Date handling
+#
+
+sub date_adjust_down {
+   
+    my ($year, $month, $day) = @_;
+
+    if ($day == 0) {
+        $month -= 1;
+        $day = 31;
+        # Proper day adjustment is done later.
+
+        if ($month == 0) {
+            $year -= 1;
+            $month = 12;
+        }
+    }
+
+    if (($month == 2) && ($day > 28)) {
+        if ($year % 4 == 0 && $year % 100 != 0) {
+            $day = 29;
+        } else {
+            $day = 28;
+        }
+    }
+
+    if (($month == 4 || $month == 6 || $month == 9 || $month == 11) &&
+        ($day == 31) ) 
+    {
+        $day = 30;
+    }
+    return ($year, $month, $day);
+}
+
+sub date_adjust_up {
+    my ($year, $month, $day) = @_;
+
+    if ($day > 31) {
+        $month += 1;
+        $day    = 1;
+
+        if ($month == 13) {
+            $month = 1;
+            $year += 1;
+        }
+    }
+
+    if ($month == 2 && $day > 28) {
+        if ($year % 4 != 0 || $year % 100 == 0 || $day > 29) {
+            $month = 3;
+            $day = 1;
+        }
+    }
+
+    if (($month == 4 || $month == 6 || $month == 9 || $month == 11) &&
+        ($day == 31) )
+    {
+        $month += 1; 
+        $day    = 1;
+    }
+
+    return ($year, $month, $day);
+}
+
+sub split_by_month {
+    # Takes start and end dates and splits them into a list of
+    # monthly-spaced 2-lists of dates.
+    my ($start_date, $end_date) = @_;
+
+    # We assume at this point that the dates are provided and sane
+    my (undef, undef, undef, $sd, $sm, $sy, undef) = strptime($start_date);
+    my (undef, undef, undef, $ed, $em, $ey, undef) = strptime($end_date);
+
+    # Find out how many months fit between the two dates so we know
+    # how many times we loop.
+    my $yd = $ey - $sy;
+    my $md = 12 * $yd + $em - $sm;
+    # If the end day is smaller than the start day, last interval is not a whole month.
+    if ($sd > $ed) {
+        $md -= 1;
+    }
+
+    my (@months, $sub_start, $sub_end);
+    # This +1 and +1900 are a result of strptime's bizarre semantics
+    my $year = $sy + 1900;
+    my $month = $sm + 1;
+
+    # Keep the original date, when the date will be changed in the adjust_date.
+    my $sd_tmp = $sd;
+    my $month_tmp = $month;
+    my $year_tmp = $year;
+
+    # This section handles only the whole months.
+    for (my $i=0; $i < $md; $i++) {
+        # Start of interval is adjusted up: 31.2. -> 1.3.
+        ($year_tmp, $month_tmp, $sd_tmp) = date_adjust_up($year, $month, $sd);
+        $sub_start = sprintf("%04d-%02d-%02d", $year_tmp, $month_tmp, $sd_tmp); 
+        $month += 1;
+        if ($month == 13) {
+            $month = 1;
+            $year += 1;
+        }
+        # End of interval is adjusted down: 31.2 -> 28.2.
+        ($year_tmp, $month_tmp, $sd_tmp) = date_adjust_down($year, $month, $sd - 1);
+        $sub_end = sprintf("%04d-%02d-%02d", $year_tmp, $month_tmp, $sd_tmp);
+        push @months, [$sub_start, $sub_end];
+    }
+    
+    # This section handles the last (unfinished) month. 
+    $sub_end = sprintf("%04d-%02d-%02d", $ey + 1900, $em + 1, $ed);
+    ($year_tmp, $month_tmp, $sd_tmp) = date_adjust_up($year, $month, $sd);
+    $sub_start = sprintf("%04d-%02d-%02d", $year_tmp, $month_tmp, $sd_tmp);
+    push @months, [$sub_start, $sub_end];
+
+    return @months;
+}
+
+sub sqlize_dates {
+    my ($start_date, $end_date) = @_;
+    my $date_bits = "";
+    my @date_values;
+    if ($start_date) {
+        # we've checked, trick_taint is fine
+        trick_taint($start_date);
+        $date_bits = " AND longdescs.bug_when > ?";
+        push @date_values, $start_date;
+    } 
+    if ($end_date) {
+        # we need to add one day to end_date to catch stuff done today
+        # do not forget to adjust date if it was the last day of month
+        my (undef, undef, undef, $ed, $em, $ey, undef) = strptime($end_date);
+        ($ey, $em, $ed) = date_adjust_up($ey+1900, $em+1, $ed+1);
+        $end_date = sprintf("%04d-%02d-%02d", $ey, $em, $ed);
+
+        $date_bits .= " AND longdescs.bug_when < ?"; 
+        push @date_values, $end_date;
+    }
+    return ($date_bits, \@date_values);
+}
+
+# Return all blockers of the current bug, recursively.
+sub get_blocker_ids {
+    my ($bug_id, $unique) = @_;
+    $unique ||= {$bug_id => 1};
+    my $deps = Bugzilla::Bug::EmitDependList("blocked", "dependson", $bug_id);
+    my @unseen = grep { !$unique->{$_}++ } @$deps;
+    foreach $bug_id (@unseen) {
+        get_blocker_ids($bug_id, $unique);
+    }
+    return keys %$unique;
+}
+
+# Return a hashref whose key is chosen by the user (bug ID or commenter)
+# and value is a hash of the form {bug ID, commenter, time spent}.
+# So you can either view it as the time spent by commenters on each bug
+# or the time spent in bugs by each commenter.
+sub get_list {
+    my ($bugids, $start_date, $end_date, $keyname) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    my ($date_bits, $date_values) = sqlize_dates($start_date, $end_date);
+    my $buglist = join(", ", @$bugids);
+
+    # Returns the total time worked on each bug *per developer*.
+    my $data = $dbh->selectall_arrayref(
+            qq{SELECT SUM(work_time) AS total_time, login_name, longdescs.bug_id
+                 FROM longdescs
+           INNER JOIN profiles
+                   ON longdescs.who = profiles.userid
+           INNER JOIN bugs
+                   ON bugs.bug_id = longdescs.bug_id
+                WHERE longdescs.bug_id IN ($buglist) $date_bits } .
+            $dbh->sql_group_by('longdescs.bug_id, login_name', 'longdescs.bug_when') .
+           qq{ HAVING SUM(work_time) > 0}, {Slice => {}}, @$date_values);
+
+    my %list;
+    # What this loop does is to push data having the same key in an array.
+    push(@{$list{ $_->{$keyname} }}, $_) foreach @$data;
+    return \%list;
+}
+
+# Return bugs which had no activity (a.k.a work_time = 0) during the given time range.
+sub get_inactive_bugs {
+    my ($bugids, $start_date, $end_date) = @_;
+    my $dbh = Bugzilla->dbh;
+    my ($date_bits, $date_values) = sqlize_dates($start_date, $end_date);
+    my $buglist = join(", ", @$bugids);
+
+    my $bugs = $dbh->selectcol_arrayref(
+        "SELECT bug_id
+           FROM bugs
+          WHERE bugs.bug_id IN ($buglist)
+            AND NOT EXISTS (
+                SELECT 1
+                  FROM longdescs
+                 WHERE bugs.bug_id = longdescs.bug_id
+                   AND work_time > 0 $date_bits)",
+         undef, @$date_values);
+
+    return $bugs;
+}
+
+# Return 1st day of the month of the earliest activity date for a given list of bugs.
+sub get_earliest_activity_date {
+    my ($bugids) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    my ($date) = $dbh->selectrow_array(
+        'SELECT ' . $dbh->sql_date_format('MIN(bug_when)', '%Y-%m-01')
+       . ' FROM longdescs
+          WHERE ' . $dbh->sql_in('bug_id', $bugids)
+                  . ' AND work_time > 0');
+
+    return $date;
+}
+
+#
+# Template code starts here
+#
+
+my $user = Bugzilla->login(LOGIN_REQUIRED);
+
+my $cgi = Bugzilla->cgi;
+my $template = Bugzilla->template;
+my $vars = {};
+
+Bugzilla->switch_to_shadow_db();
+
+$user->is_timetracker
+    || ThrowUserError("auth_failure", {group  => "time-tracking",
+                                       action => "access",
+                                       object => "timetracking_summaries"});
+
+my @ids = split(",", $cgi->param('id') || '');
+@ids = map { Bugzilla::Bug->check($_)->id } @ids;
+scalar(@ids) || ThrowUserError('no_bugs_chosen', {action => 'view'});
+
+my $group_by = $cgi->param('group_by') || "number";
+my $monthly = $cgi->param('monthly');
+my $detailed = $cgi->param('detailed');
+my $do_report = $cgi->param('do_report');
+my $inactive = $cgi->param('inactive');
+my $do_depends = $cgi->param('do_depends');
+my $ctype = scalar($cgi->param("ctype"));
+
+my ($start_date, $end_date);
+if ($do_report) {
+    my @bugs = @ids;
+
+    # Dependency mode requires a single bug and grabs dependents.
+    if ($do_depends) {
+        if (scalar(@bugs) != 1) {
+            ThrowCodeError("bad_arg", { argument=>"id",
+                                        function=>"summarize_time"});
+        }
+        @bugs = get_blocker_ids($bugs[0]);
+        @bugs = @{ $user->visible_bugs(\@bugs) };
+    }
+
+    $start_date = trim $cgi->param('start_date');
+    $end_date = trim $cgi->param('end_date');
+
+    foreach my $date ($start_date, $end_date) {
+        next unless $date;
+        validate_date($date)
+          || ThrowUserError('illegal_date', {date => $date, format => 'YYYY-MM-DD'});
+    }
+    # Swap dates in case the user put an end_date before the start_date
+    if ($start_date && $end_date && 
+        str2time($start_date) > str2time($end_date)) {
+        $vars->{'warn_swap_dates'} = 1;
+        ($start_date, $end_date) = ($end_date, $start_date);
+    }
+
+    # Store dates in a session cookie so re-visiting the page
+    # for other bugs keeps them around.
+    $cgi->send_cookie(-name => 'time-summary-dates',
+                      -value => join ";", ($start_date, $end_date));
+
+    my (@parts, $part_data, @part_list);
+
+    # Break dates apart into months if necessary; if not, we use the
+    # same @parts list to allow us to use a common codepath.
+    if ($monthly) {
+        # Calculate the earliest activity date if the user doesn't
+        # specify a start date.
+        if (!$start_date) {
+            $start_date = get_earliest_activity_date(\@bugs);
+        }
+        # Provide a default end date. Note that this differs in semantics
+        # from the open-ended queries we use when start/end_date aren't
+        # provided -- and clock skews will make this evident!
+        @parts = split_by_month($start_date, 
+                                $end_date || format_time(scalar localtime(time()), '%Y-%m-%d'));
+    } else {
+        @parts = ([$start_date, $end_date]);
+    }
+
+    # For each of the separate divisions, grab the relevant data.
+    my $keyname = ($group_by eq 'owner') ? 'login_name' : 'bug_id';
+    foreach my $part (@parts) {
+        my ($sub_start, $sub_end) = @$part;
+        $part_data = get_list(\@bugs, $sub_start, $sub_end, $keyname);
+        push(@part_list, $part_data);
+    }
+
+    # Do we want to see inactive bugs?
+    if ($inactive) {
+        $vars->{'null'} = get_inactive_bugs(\@bugs, $start_date, $end_date);
+    } else {
+        $vars->{'null'} = {};
+    }
+
+    # Convert bug IDs to bug objects.
+    @bugs = map {new Bugzilla::Bug($_)} @bugs;
+
+    $vars->{'part_list'} = \@part_list;
+    $vars->{'parts'} = \@parts;
+    # We pass the list of bugs as a hashref.
+    $vars->{'bugs'} = {map { $_->id => $_ } @bugs};
+}
+elsif ($cgi->cookie("time-summary-dates")) {
+    ($start_date, $end_date) = split ";", $cgi->cookie('time-summary-dates');
+}
+
+$vars->{'ids'} = \@ids;
+$vars->{'start_date'} = $start_date;
+$vars->{'end_date'} = $end_date;
+$vars->{'group_by'} = $group_by;
+$vars->{'monthly'} = $monthly;
+$vars->{'detailed'} = $detailed;
+$vars->{'inactive'} = $inactive;
+$vars->{'do_report'} = $do_report;
+$vars->{'do_depends'} = $do_depends;
+
+my $format = $template->get_format("bug/summarize-time", undef, $ctype);
+
+# Get the proper content-type
+print $cgi->header(-type=> $format->{'ctype'});
+$template->process("$format->{'template'}", $vars)
+  || ThrowTemplateError($template->error());

diff --git a/t/001compile.t b/t/001compile.t
new file mode 100644 (file)
index 0000000..a82b30a
--- /dev/null
+++ b/t/001compile.t
@@ -0,0 +1,92 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+#################
+#Bugzilla Test 1#
+###Compilation###
+
+use strict;
+use 5.008001;
+use lib qw(. lib t);
+use Config;
+use Support::Files;
+use Test::More tests => scalar(@Support::Files::testitems);
+
+BEGIN { 
+    use_ok('Bugzilla::Constants');
+    use_ok('Bugzilla::Install::Requirements');
+    use_ok('Bugzilla');
+}
+
+sub compile_file {
+    my ($file) = @_;
+
+    # Don't allow CPAN.pm to modify the global @INC, which the version
+    # shipped with Perl 5.8.8 does. (It gets loaded by 
+    # Bugzilla::Install::CPAN.)
+    local @INC = @INC;
+
+    if ($file =~ s/\.pm$//) {
+        $file =~ s{/}{::}g;
+        use_ok($file);
+        return;
+    }
+
+    open(my $fh, $file);
+    my $bang = <$fh>;
+    close $fh;
+
+    my $T = "";
+    if ($bang =~ m/#!\S*perl\s+-.*T/) {
+        $T = "T";
+    }
+
+    my $libs = '';
+    if ($ENV{PERL5LIB}) {
+       $libs = join " ", map { "-I\"$_\"" } split /$Config{path_sep}/, $ENV{PERL5LIB};
+    }
+    my $perl = qq{"$^X"};
+    my $output = `$perl $libs -wc$T $file 2>&1`;
+    chomp($output);
+    my $return_val = $?;
+    $output =~ s/^\Q$file\E syntax OK$//ms;
+    diag($output) if $output;
+    ok(!$return_val, $file) or diag('--ERROR');
+}
+
+my @testitems = @Support::Files::testitems;
+my $file_features = map_files_to_features();
+
+# Test the scripts by compiling them
+foreach my $file (@testitems) {
+    # These were already compiled, above.
+    next if ($file eq 'Bugzilla.pm' 
+             or $file eq 'Bugzilla/Constants.pm'
+             or $file eq 'Bugzilla/Install/Requirements.pm');
+    SKIP: {
+        if ($file eq 'mod_perl.pl') {
+            skip 'mod_perl.pl cannot be compiled from the command line', 1;
+        }
+        my $feature = $file_features->{$file};
+        if ($feature and !Bugzilla->feature($feature)) {
+            skip "$file: $feature not enabled", 1;
+        }
+
+        # Check that we have a DBI module to support the DB, if this 
+        # is a database module (but not Schema)
+        if ($file =~ m{Bugzilla/DB/([^/]+)\.pm$}
+            and $file ne "Bugzilla/DB/Schema.pm") 
+        {
+            my $module = lc($1);
+            my $dbd = DB_MODULE->{$module}->{dbd}->{module};
+            eval("use $dbd; 1") or skip "$file: $dbd not installed", 1;
+        }
+
+        compile_file($file);
+    }
+}      

diff --git a/t/002goodperl.t b/t/002goodperl.t
new file mode 100644 (file)
index 0000000..e691b39
--- /dev/null
+++ b/t/002goodperl.t
@@ -0,0 +1,113 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+#################
+#Bugzilla Test 2#
+####GoodPerl#####
+
+use strict;
+
+use lib 't';
+
+use Support::Files;
+
+use Test::More tests => (scalar(@Support::Files::testitems) * 3);
+
+my @testitems = @Support::Files::testitems; # get the files to test.
+
+foreach my $file (@testitems) {
+    $file =~ s/\s.*$//; # nuke everything after the first space (#comment)
+    next if (!$file); # skip null entries
+    if (! open (FILE, $file)) {
+        ok(0,"could not open $file --WARNING");
+    }
+    my $file_line1 = <FILE>;
+    close (FILE);
+
+    $file =~ m/.*\.(.*)/;
+    my $ext = $1;
+
+    if ($file_line1 !~ m/^#\!/) {
+        ok(1,"$file does not have a shebang"); 
+    } else {
+        my $flags;
+        if (!defined $ext || $ext eq "pl") {
+            # standalone programs aren't taint checked yet
+            $flags = "w";
+        } elsif ($ext eq "pm") {
+            ok(0, "$file is a module, but has a shebang");
+            next;
+        } elsif ($ext eq "cgi") {
+            # cgi files must be taint checked
+            $flags = "wT";
+        } else {
+            ok(0, "$file has shebang but unknown extension");
+            next;
+        }
+
+        if ($file_line1 =~ m#^\#\!/usr/bin/perl\s#) {
+            if ($file_line1 =~ m#\s-$flags#) {
+                ok(1,"$file uses standard perl location and -$flags");
+            } else {
+                ok(0,"$file is MISSING -$flags --WARNING");
+            }
+        } else {
+            ok(0,"$file uses non-standard perl location");
+        }
+    }
+}
+
+foreach my $file (@testitems) {
+    my $found_use_strict = 0;
+    $file =~ s/\s.*$//; # nuke everything after the first space (#comment)
+    next if (!$file); # skip null entries
+    if (! open (FILE, $file)) {
+        ok(0,"could not open $file --WARNING");
+        next;
+    }
+    while (my $file_line = <FILE>) {
+        if ($file_line =~ m/^\s*use strict/) {
+            $found_use_strict = 1;
+            last;
+        }
+    }
+    close (FILE);
+    if ($found_use_strict) {
+        ok(1,"$file uses strict");
+    } else {
+        ok(0,"$file DOES NOT use strict --WARNING");
+    }
+}
+
+# Check to see that all error messages use tags (for l10n reasons.)
+foreach my $file (@testitems) {
+    $file =~ s/\s.*$//; # nuke everything after the first space (#comment)
+    next if (!$file); # skip null entries
+    if (! open (FILE, $file)) {
+        ok(0,"could not open $file --WARNING");
+        next;
+    }
+    my $lineno = 0;
+    my $error = 0;
+    
+    while (!$error && (my $file_line = <FILE>)) {
+        $lineno++;
+        if ($file_line =~ /Throw.*Error\("(.*?)"/) {
+            if ($1 =~ /\s/) {
+                ok(0,"$file has a Throw*Error call on line $lineno 
+                      which doesn't use a tag --ERROR");
+                $error = 1;       
+            }
+        }
+    }
+    
+    ok(1,"$file uses Throw*Error calls correctly") if !$error;
+    
+    close(FILE);
+}
+exit 0;

diff --git a/t/003safesys.t b/t/003safesys.t
new file mode 100644 (file)
index 0000000..0d6a215
--- /dev/null
+++ b/t/003safesys.t
@@ -0,0 +1,51 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+#################
+#Bugzilla Test 3#
+###Safesystem####
+
+use strict;
+
+use lib 't';
+
+use Support::Files;
+
+use Test::More tests => scalar(@Support::Files::testitems);
+
+# Capture the TESTOUT from Test::More or Test::Builder for printing errors.
+# This will handle verbosity for us automatically.
+my $fh;
+{
+    local $^W = 0;  # Don't complain about non-existent filehandles
+    if (-e \*Test::More::TESTOUT) {
+        $fh = \*Test::More::TESTOUT;
+    } elsif (-e \*Test::Builder::TESTOUT) {
+        $fh = \*Test::Builder::TESTOUT;
+    } else {
+        $fh = \*STDOUT;
+    }
+}
+
+my @testitems = @Support::Files::testitems; 
+my $perlapp = "\"$^X\"";
+
+foreach my $file (@testitems) {
+    $file =~ s/\s.*$//; # nuke everything after the first space (#comment)
+    next if (!$file); # skip null entries
+    my $command = "$perlapp -c -It -MSupport::Systemexec $file 2>&1";
+    my $loginfo=`$command`;
+    if ($loginfo =~ /arguments for Support::Systemexec::(system|exec)/im) {
+        ok(0,"$file DOES NOT use proper system or exec calls");
+        print $fh $loginfo;
+    } else {
+        ok(1,"$file uses proper system and exec calls");
+    }
+}
+
+exit 0;

diff --git a/t/004template.t b/t/004template.t
new file mode 100644 (file)
index 0000000..c81bccc
--- /dev/null
+++ b/t/004template.t
@@ -0,0 +1,106 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+#################
+#Bugzilla Test 4#
+####Templates####
+
+use strict;
+
+use lib 't';
+
+use Support::Templates;
+
+# Bug 137589 - Disable command-line input of CGI.pm when testing
+use CGI qw(-no_debug);
+
+use File::Spec;
+use Template;
+use Test::More tests => ( scalar(@referenced_files) + $num_actual_files );
+
+# Capture the TESTOUT from Test::More or Test::Builder for printing errors.
+# This will handle verbosity for us automatically.
+my $fh;
+{
+    local $^W = 0;  # Don't complain about non-existent filehandles
+    if (-e \*Test::More::TESTOUT) {
+        $fh = \*Test::More::TESTOUT;
+    } elsif (-e \*Test::Builder::TESTOUT) {
+        $fh = \*Test::Builder::TESTOUT;
+    } else {
+        $fh = \*STDOUT;
+    }
+}
+
+# Check to make sure all templates that are referenced in Bugzilla
+# exist in the proper place in the English template directory.
+# All other languages may or may not include any template as Bugzilla will
+# fall back to English if necessary.
+
+foreach my $file (@referenced_files) {
+    my $path = File::Spec->catfile($english_default_include_path, $file);
+    if (-e $path) {
+        ok(1, "$path exists");
+    } else {
+        ok(0, "$path cannot be located --ERROR");
+    }
+}
+
+foreach my $include_path (@include_paths) {
+    # Processes all the templates to make sure they have good syntax
+    my $provider = Template::Provider->new(
+    {
+        INCLUDE_PATH => $include_path ,
+        # Need to define filters used in the codebase, they don't
+        # actually have to function in this test, just be defined.
+        # See Template.pm for the actual codebase definitions.
+
+        # Initialize templates (f.e. by loading plugins like Hook).
+        PRE_PROCESS => "global/variables.none.tmpl",
+
+        FILTERS =>
+        {
+            html_linebreak => sub { return $_; },
+            no_break => sub { return $_; } ,
+            js        => sub { return $_ } ,
+            base64   => sub { return $_ } ,
+            inactive => [ sub { return sub { return $_; } }, 1] ,
+            closed => [ sub { return sub { return $_; } }, 1] ,
+            obsolete => [ sub { return sub { return $_; } }, 1] ,
+            url_quote => sub { return $_ } ,
+            css_class_quote => sub { return $_ } ,
+            xml       => sub { return $_ } ,
+            quoteUrls => sub { return $_ } ,
+            bug_link => [ sub { return sub { return $_; } }, 1] ,
+            csv       => sub { return $_ } ,
+            unitconvert => sub { return $_ },
+            time      => sub { return $_ } ,
+            wrap_comment => sub { return $_ },
+            none      => sub { return $_ } ,
+            ics       => [ sub { return sub { return $_; } }, 1] ,
+        },
+    }
+    );
+
+    foreach my $file (@{$actual_files{$include_path}}) {
+        my $path = File::Spec->catfile($include_path, $file);
+
+        # These are actual files, so there's no need to check for existence.
+
+        my ($data, $err) = $provider->fetch($file);
+
+        if (!$err) {
+            ok(1, "$path syntax ok");
+        }
+        else {
+            ok(0, "$path has bad syntax --ERROR");
+            print $fh $data . "\n";
+        }
+    }
+}
+
+exit 0;

diff --git a/t/005whitespace.t b/t/005whitespace.t
new file mode 100644 (file)
index 0000000..624df69
--- /dev/null
+++ b/t/005whitespace.t
@@ -0,0 +1,64 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+#################
+#Bugzilla Test 5#
+#####no_tabs#####
+
+use strict;
+
+use lib 't';
+
+use Support::Files;
+use Support::Templates;
+
+use File::Spec;
+use Test::More tests => (  scalar(@Support::Files::testitems)
+                         + $Support::Templates::num_actual_files) * 3;
+
+my @testitems = @Support::Files::testitems;
+for my $path (@Support::Templates::include_paths) {
+   push(@testitems, map(File::Spec->catfile($path, $_),
+                        Support::Templates::find_actual_files($path)));
+}
+
+my %results;
+
+foreach my $file (@testitems) {
+    open (FILE, "$file");
+    my @contents = <FILE>;
+    if (grep /\t/, @contents) {
+        ok(0, "$file contains tabs --WARNING");
+    } else {
+        ok(1, "$file has no tabs");
+    }
+    close (FILE);
+}
+
+foreach my $file (@testitems) {
+    open (FILE, "$file");
+    my @contents = <FILE>;
+    if (grep /\r/, @contents) {
+        ok(0, "$file contains non-OS-conformant line endings --WARNING");
+    } else {
+        ok(1, "All line endings of $file are OS conformant");
+    }
+    close (FILE);
+}
+
+foreach my $file (@testitems) {
+    open (FILE, "$file");
+    my $first_line = <FILE>;
+    if ($first_line =~ /\xef\xbb\xbf/) {
+        ok(0, "$file contains Byte Order Mark --WARNING");
+    } else {
+        ok(1, "$file is free of a Byte Order Mark");
+    }
+    close (FILE);
+}
+
+exit 0;

diff --git a/t/006spellcheck.t b/t/006spellcheck.t
new file mode 100644 (file)
index 0000000..07cd3ea
--- /dev/null
+++ b/t/006spellcheck.t
@@ -0,0 +1,86 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+#################
+#Bugzilla Test 6#
+####Spelling#####
+
+use lib 't';
+use Support::Files;
+
+BEGIN { # yes the indenting is off, deal with it
+#add the words to check here:
+@evilwords = qw(
+anyways
+appearence
+arbitary
+cancelled
+critera
+databasa
+dependan
+existance
+existant
+paramater
+refered
+repsentation
+suported
+varsion
+);
+
+$testcount = scalar(@Support::Files::testitems);
+}
+
+use Test::More tests => $testcount;
+
+# Capture the TESTOUT from Test::More or Test::Builder for printing errors.
+# This will handle verbosity for us automatically.
+my $fh;
+{
+    local $^W = 0;  # Don't complain about non-existent filehandles
+    if (-e \*Test::More::TESTOUT) {
+        $fh = \*Test::More::TESTOUT;
+    } elsif (-e \*Test::Builder::TESTOUT) {
+        $fh = \*Test::Builder::TESTOUT;
+    } else {
+        $fh = \*STDOUT;
+    }
+}
+
+my @testitems = @Support::Files::testitems;
+
+# at last, here we actually run the test...
+my $evilwordsregexp = join('|', @evilwords);
+
+foreach my $file (@testitems) {
+    $file =~ s/\s.*$//; # nuke everything after the first space (#comment)
+    next if (!$file); # skip null entries
+
+    if (open (FILE, $file)) { # open the file for reading
+
+        my $found_word = '';
+
+        while (my $file_line = <FILE>) { # and go through the file line by line
+            if ($file_line =~ /($evilwordsregexp)/i) { # found an evil word
+                $found_word = $1;
+                last;
+            }
+        }
+            
+        close (FILE);
+            
+        if ($found_word) {
+            ok(0,"$file: found SPELLING ERROR $found_word --WARNING");
+        } else {
+            ok(1,"$file does not contain registered spelling errors");
+        }
+    } else {
+        ok(0,"could not open $file for spellcheck --WARNING");
+    }
+} 
+
+exit 0;

diff --git a/t/007util.t b/t/007util.t
new file mode 100644 (file)
index 0000000..a73f4df
--- /dev/null
+++ b/t/007util.t
@@ -0,0 +1,82 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+#################
+#Bugzilla Test 7#
+#####Util.pm#####
+
+use lib 't';
+use Support::Files;
+use Test::More tests => 17;
+
+BEGIN { 
+    use_ok(Bugzilla);
+    use_ok(Bugzilla::Util);
+}
+
+# We need to override user preferences so we can get an expected value when
+# Bugzilla::Util::format_time() calls ask for the 'timezone' user preference.
+Bugzilla->user->{'settings'}->{'timezone'}->{'value'} = "local";
+
+# We need to know the local timezone for the date chosen in our tests.
+# Below, tests are run against Nov. 24, 2002.
+my $tz = Bugzilla->local_timezone->short_name_for_datetime(DateTime->new(year => 2002, month => 11, day => 24));
+
+# we don't test the taint functions since that's going to take some more work.
+# XXX: test taint functions
+
+#html_quote():
+is(html_quote("<lala&@>"),"&lt;lala&amp;&#64;&gt;",'html_quote');
+
+#url_quote():
+is(url_quote("<lala&>gaa\"'[]{\\"),"%3Clala%26%3Egaa%22%27%5B%5D%7B%5C",'url_quote');
+
+#trim():
+is(trim(" fg<*\$%>+=~~ "),'fg<*$%>+=~~','trim()');
+
+#format_time();
+is(format_time("2002.11.24 00:05"), "2002-11-24 00:05 $tz",'format_time("2002.11.24 00:05") is ' . format_time("2002.11.24 00:05"));
+is(format_time("2002.11.24 00:05:56"), "2002-11-24 00:05:56 $tz",'format_time("2002.11.24 00:05:56")');
+is(format_time("2002.11.24 00:05:56", "%Y-%m-%d %R"), '2002-11-24 00:05', 'format_time("2002.11.24 00:05:56", "%Y-%m-%d %R") (with no timezone)');
+is(format_time("2002.11.24 00:05:56", "%Y-%m-%d %R %Z"), "2002-11-24 00:05 $tz", 'format_time("2002.11.24 00:05:56", "%Y-%m-%d %R %Z") (with timezone)');
+
+# email_filter
+my %email_strings = (
+    'somebody@somewhere.com' => 'somebody',
+    'Somebody <somebody@somewhere.com>' => 'Somebody <somebody>',
+    'One Person <one@person.com>, Two Person <two@person.com>' 
+        => 'One Person <one>, Two Person <two>',
+    'This string contains somebody@somewhere.com and also this@that.com'
+        => 'This string contains somebody and also this',
+);
+foreach my $input (keys %email_strings) {
+    is(Bugzilla::Util::email_filter($input), $email_strings{$input}, 
+       "email_filter('$input')");
+}
+
+# validate_email_syntax. We need to override some parameters.
+my $params = Bugzilla->params;
+$params->{emailregexp} = '.*';
+$params->{emailsuffix} = '';
+my $ascii_email = 'admin@company.com';
+# U+0430 returns the Cyrillic "а", which looks similar to the ASCII "a".
+my $utf8_email = "\N{U+0430}dmin\@company.com";
+ok(validate_email_syntax($ascii_email), 'correctly formatted ASCII-only email address is valid');
+ok(!validate_email_syntax($utf8_email), 'correctly formatted email address with non-ASCII characters is rejected');
+
+# diff_arrays():
+my @old_array = qw(alpha beta alpha gamma gamma beta alpha delta epsilon gamma);
+my @new_array = qw(alpha alpha beta gamma epsilon delta beta delta);
+# The order is not relevant when comparing both arrays for matching items,
+# i.e. (foo bar) and (bar foo) are the same arrays (same items).
+# But when returning data, we try to respect the initial order.
+# We remove the leftmost items first, and return what's left. This means:
+# Removed (in this order): gamma alpha gamma.
+# Added (in this order): delta
+my ($removed, $added) = diff_arrays(\@old_array, \@new_array);
+is_deeply($removed, [qw(gamma alpha gamma)], 'diff_array(\@old, \@new) (check removal)');
+is_deeply($added, [qw(delta)], 'diff_array(\@old, \@new) (check addition)');

diff --git a/t/008filter.t b/t/008filter.t
new file mode 100644 (file)
index 0000000..4977658
--- /dev/null
+++ b/t/008filter.t
@@ -0,0 +1,220 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+#################
+#Bugzilla Test 8#
+#####filter######
+
+# This test scans all our templates for every directive. Having eliminated
+# those which cannot possibly cause XSS problems, it then checks the rest
+# against the safe list stored in the filterexceptions.pl file. 
+
+# Sample exploit code: '>"><script>alert('Oh dear...')</script>
+
+use strict;
+use lib qw(. lib t);
+
+use vars qw(%safe);
+
+use Bugzilla::Constants;
+use Support::Templates;
+use File::Spec;
+use Test::More tests => $Support::Templates::num_actual_files;
+use Cwd;
+
+# Undefine the record separator so we can read in whole files at once
+my $oldrecsep = $/;
+my $topdir = cwd;
+$/ = undef;
+
+foreach my $path (@Support::Templates::include_paths) {
+    $path =~ s|\\|/|g if ON_WINDOWS;  # convert \ to / in path if on windows
+    $path =~ m|template/([^/]+)/([^/]+)|;
+    my $lang = $1;
+    my $flavor = $2;
+
+    chdir $topdir; # absolute path
+    my @testitems = Support::Templates::find_actual_files($path);
+    chdir $topdir; # absolute path
+    
+    next unless @testitems;
+    
+    # Some people require this, others don't. No-one knows why.
+    chdir $path; # relative path
+    
+    # We load a %safe list of acceptable exceptions.
+    if (-r "filterexceptions.pl") {
+        do "filterexceptions.pl";
+        if (ON_WINDOWS) {
+          # filterexceptions.pl uses / separated paths, while 
+          # find_actual_files returns \ separated ones on Windows.
+          # Here, we convert the filter exception hash to use \.
+          foreach my $file (keys %safe) {
+            my $orig_file = $file;
+            $file =~ s|/|\\|g;
+            if ($file ne $orig_file) {
+              $safe{$file} = $safe{$orig_file};
+              delete $safe{$orig_file};
+            }
+          }
+        }
+    }
+    
+    # We preprocess the %safe hash of lists into a hash of hashes. This allows
+    # us to flag which members were not found, and report that as a warning, 
+    # thereby keeping the lists clean.
+    foreach my $file (keys %safe) {
+        if (ref $safe{$file} eq 'ARRAY') {
+            my $list = $safe{$file};
+            $safe{$file} = {};
+            foreach my $directive (@$list) {
+                $safe{$file}{$directive} = 0;    
+            }
+        }
+    }
+
+    foreach my $file (@testitems) {
+        # There are some files we don't check, because there is no need to
+        # filter their contents due to their content-type.
+        if ($file =~ /\.(pm|txt|png)\.tmpl$/) {
+            ok(1, "($lang/$flavor) $file is filter-safe");
+            next;
+        }
+        
+        # Read the entire file into a string
+        open (FILE, "<$file") || die "Can't open $file: $!\n";    
+        my $slurp = <FILE>;
+        close (FILE);
+
+        my @unfiltered;
+
+        # /g means we execute this loop for every match
+        # /s means we ignore linefeeds in the regexp matches
+        while ($slurp =~ /\[%(?:-|\+|~|=)?(.*?)(?:-|\+|~|=)?%\]/gs) {
+            my $directive = $1;
+
+            my @lineno = ($` =~ m/\n/gs);
+            my $lineno = scalar(@lineno) + 1;
+
+            if (!directive_ok($file, $directive)) {
+
+              # This intentionally makes no effort to eliminate duplicates; to do
+              # so would merely make it more likely that the user would not 
+              # escape all instances when attempting to correct an error.
+              push(@unfiltered, "$lineno:$directive");
+            }
+        }  
+
+        my $fullpath = File::Spec->catfile($path, $file);
+        
+        if (@unfiltered) {
+            my $uflist = join("\n  ", @unfiltered);
+            ok(0, "($lang/$flavor) $fullpath has unfiltered directives:\n  $uflist\n--ERROR");
+        }
+        else {
+            # Find any members of the exclusion list which were not found
+            my @notfound;
+            foreach my $directive (keys %{$safe{$file}}) {
+                push(@notfound, $directive) if ($safe{$file}{$directive} == 0);    
+            }
+
+            if (@notfound) {
+                my $nflist = join("\n  ", @notfound);
+                ok(0, "($lang/$flavor) $fullpath - filterexceptions.pl has extra members:\n  $nflist\n" . 
+                                                                  "--WARNING");
+            }
+            else {
+                # Don't use the full path here - it's too long and unwieldy.
+                ok(1, "($lang/$flavor) $file is filter-safe");
+            }
+        }
+    }
+}
+
+sub directive_ok {
+    my ($file, $directive) = @_;
+
+    # Comments
+    return 1 if $directive =~ /^#/;        
+
+    # Remove any leading/trailing whitespace.
+    $directive =~ s/^\s*//;
+    $directive =~ s/\s*$//;
+
+    # Empty directives are ok; they are usually line break helpers
+    return 1 if $directive eq '';
+
+    # Make sure we're not looking for ./ in the $safe hash
+    $file =~ s#^\./##;
+
+    # Exclude those on the nofilter list
+    if (defined($safe{$file}{$directive})) {
+        $safe{$file}{$directive}++;
+        return 1;
+    };
+
+    # Directives
+    return 1 if $directive =~ /^(IF|END|UNLESS|FOREACH|PROCESS|INCLUDE|
+                                 BLOCK|USE|ELSE|NEXT|LAST|DEFAULT|
+                                 ELSIF|SET|SWITCH|CASE|WHILE|RETURN|STOP|
+                                 TRY|CATCH|FINAL|THROW|CLEAR|MACRO|FILTER)/x;
+
+    # ? :
+    if ($directive =~ /.+\?(.+):(.+)/) {
+        return 1 if directive_ok($file, $1) && directive_ok($file, $2);
+    }
+
+    # + - * /
+    return 1 if $directive =~ /[+\-*\/]/;
+
+    # Numbers
+    return 1 if $directive =~ /^[0-9]+$/;
+
+    # Simple assignments
+    return 1 if $directive =~ /^[\w\.\$\{\}]+\s+=\s+/;
+
+    # Conditional literals with either sort of quotes 
+    # There must be no $ in the string for it to be a literal
+    return 1 if $directive =~ /^(["'])[^\$]*[^\\]\1/;
+    return 1 if $directive =~ /^(["'])\1/;
+
+    # Special values always used for numbers
+    return 1 if $directive =~ /^[ijkn]$/;
+    return 1 if $directive =~ /^count$/;
+    
+    # Params
+    return 1 if $directive =~ /^Param\(/;
+    
+    # Hooks
+    return 1 if $directive =~ /^Hook.process\(/;
+
+    # Other functions guaranteed to return OK output
+    return 1 if $directive =~ /^(time2str|url)\(/;
+
+    # Safe Template Toolkit virtual methods
+    return 1 if $directive =~ /\.(length$|size$|push\(|unshift\(|delete\()/;
+
+    # Special Template Toolkit loop variable
+    return 1 if $directive =~ /^loop\.(index|count)$/;
+    
+    # Branding terms
+    return 1 if $directive =~ /^terms\./;
+            
+    # Things which are already filtered
+    # Note: If a single directive prints two things, and only one is 
+    # filtered, we may not catch that case.
+    return 1 if $directive =~ /FILTER\ (html|csv|js|base64|css_class_quote|ics|
+                                        quoteUrls|time|uri|xml|lower|html_light|
+                                        obsolete|inactive|closed|unitconvert|
+                                        txt|html_linebreak|none)\b/x;
+
+    return 0;
+}
+
+$/ = $oldrecsep;
+
+exit 0;

diff --git a/t/009bugwords.t b/t/009bugwords.t
new file mode 100644 (file)
index 0000000..6626265
--- /dev/null
+++ b/t/009bugwords.t
@@ -0,0 +1,86 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+#################
+#Bugzilla Test 9#
+####bugwords#####
+
+# Bugzilla has a mechanism for taking various words, including "bug", "bugs", 
+# and "a bug" and automatically replacing them in the templates with the local
+# terminology. It does this by using the 'terms' hash, so "bug" becomes 
+# "[% terms.bug %]". This test makes sure the relevant words aren't used
+# bare.
+
+use strict;
+
+use lib 't';
+
+use Support::Files;
+use Support::Templates;
+use Bugzilla::Util;
+
+use File::Spec;
+
+use Test::More tests => ($Support::Templates::num_actual_files); 
+
+# Find all the templates
+my @testitems;
+for my $path (@Support::Templates::include_paths) {
+    push(@testitems, map(File::Spec->catfile($path, $_),
+                         Support::Templates::find_actual_files($path)));
+}
+
+foreach my $file (@testitems) {
+    my @errors;
+    
+    # Read the entire file into a string
+    local $/;
+    open (FILE, "<$file") || die "Can't open $file: $!\n";    
+    my $slurp = <FILE>;
+    close (FILE);
+
+    # /g means we execute this loop for every match
+    # /s means we ignore linefeeds in the regexp matches
+    # This extracts everything which is _not_ a directive.
+    while ($slurp =~ /%\](.*?)(\[%|$)/gs) {
+        my $text = $1;
+
+        my @lineno = ($` =~ m/\n/gs);
+        my $lineno = scalar(@lineno) + 1;
+    
+        # "a bug", "bug", "bugs"
+        if (grep /(a?[\s>]bugs?[\s.:;,<])/i, $text) {
+            # Exclude variable assignment.
+            unless (grep /bugs =/, $text) {
+                push(@errors, [$lineno, $text]);
+                next;
+            }
+        }
+
+        # "Bugzilla"
+        if (grep /(?<!X\-)Bugzilla(?!_|::|-&gt|\.pm)/, $text) {
+            # Exclude JS comments, hyperlinks, USE, and variable assignment.
+            unless (grep /(\/\/.*|org.*>|api\/|USE |= )Bugzilla/, $text) {
+                push(@errors, [$lineno, $text]);
+                next;
+            }
+        }
+    }
+        
+    if (scalar(@errors)) {
+      ok(0, "$file contains invalid bare words (e.g. 'bug') --WARNING");
+      
+      foreach my $error (@errors) {
+        print "$error->[0]: $error->[1]\n";
+      }
+    } 
+    else {
+      ok(1, "$file has no invalid barewords");
+    }
+}
+
+exit 0;

diff --git a/t/010dependencies.t b/t/010dependencies.t
new file mode 100644 (file)
index 0000000..d84688a
--- /dev/null
+++ b/t/010dependencies.t
@@ -0,0 +1,108 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+##################
+#Bugzilla Test 10#
+## dependencies ##
+
+use strict;
+use lib qw(. lib t);
+
+use Support::Files;
+use Test::More qw(no_plan);
+
+my %mods;
+my %deps;
+
+use constant MODULE_REGEX => qr/
+    (?:(?:^\s*use)
+       |
+       (?:^require)
+    )\s+
+    ['"]?
+    ([\w:\.\\]+)
+/x;
+use constant BASE_REGEX => qr/^use base qw\(([^\)]+)/;
+
+# Extract all Perl modules.
+foreach my $file (@Support::Files::testitems) {
+  if ($file =~ /^(.*)\.pm$/) {
+    my $module = $1;
+    $module =~ s#/#::#g;
+    $mods{$module} = $file;
+  }
+}
+
+foreach my $module (keys %mods) {
+    my $reading = 1;
+    my @use;
+
+    open(SOURCE, $mods{$module});
+    while (my $line = <SOURCE>) {
+      last if ($line =~ /^__END__/);
+      if ($line =~ /^=cut/) {
+        $reading = 1;
+        next;
+      }
+      next unless $reading;
+      if ($line =~ /^=(head|over|item|back|pod|begin|end|for)/) {
+        $reading = 0;
+        next;
+      }
+      if ($line =~ /^package\s+([^;]);/) {
+        $module = $1;
+      }
+      elsif ($line =~ BASE_REGEX or $line =~ MODULE_REGEX) {
+        my $used_string = $1;
+        # "use base" can have multiple modules
+        my @used_array = split(/\s+/, $used_string);
+        foreach my $used (@used_array) {
+            next if $used !~ /^Bugzilla/;
+            $used =~ s#/#::#g;
+            $used =~ s#\.pm$##;
+            $used =~ s#\$module#[^:]+#;
+            $used =~ s#\${[^}]+}#[^:]+#;
+            $used =~ s#[" ]##g;
+            push(@use, grep(/^\Q$used\E$/, keys %mods));
+        }
+      }
+    }
+    close (SOURCE);
+
+    foreach my $u (@use) {
+      if (!grep {$_ eq $u} @{$deps{$module}}) {
+        push(@{$deps{$module}}, $u);
+      }
+    }
+}
+
+sub creates_loop {
+  my ($module, $used_module) = @_;
+  my @list = ($used_module);
+  my %seen;
+  while (my $next = shift @list) {
+    if ($module eq $next) {
+      ok(0, "Dependency on $used_module from $module causes loop. --ERROR");
+      return;
+    }
+    if (!$seen{$next}) {
+      push(@list, @{$deps{$next}}) if defined $deps{$next};
+    }
+    $seen{$next} = 1;
+  }
+  ok(1, "No dependency loop between $module and $used_module");
+}
+
+
+foreach my $module (keys %deps) {
+  foreach my $used_module (@{$deps{$module}}) {
+    creates_loop($module, $used_module);
+  }
+}
+
+exit 0;

diff --git a/t/011pod.t b/t/011pod.t
new file mode 100644 (file)
index 0000000..c638dbc
--- /dev/null
+++ b/t/011pod.t
@@ -0,0 +1,51 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+##################
+#Bugzilla Test 11#
+##POD validation##
+
+use strict;
+
+use lib 't';
+
+use Support::Files;
+use Pod::Checker;
+
+use Test::More tests => scalar(@Support::Files::testitems);
+
+# Capture the TESTOUT from Test::More or Test::Builder for printing errors.
+# This will handle verbosity for us automatically.
+my $fh;
+{
+    local $^W = 0;  # Don't complain about non-existent filehandles
+    if (-e \*Test::More::TESTOUT) {
+        $fh = \*Test::More::TESTOUT;
+    } elsif (-e \*Test::Builder::TESTOUT) {
+        $fh = \*Test::Builder::TESTOUT;
+    } else {
+        $fh = \*STDOUT;
+    }
+}
+
+my @testitems = @Support::Files::testitems;
+
+foreach my $file (@testitems) {
+    $file =~ s/\s.*$//; # nuke everything after the first space (#comment)
+    next if (!$file); # skip null entries
+    my $error_count = podchecker($file, $fh);
+    if ($error_count < 0) {
+        ok(1,"$file does not contain any POD");
+    } elsif ($error_count == 0) {
+        ok(1,"$file has correct POD syntax");
+    } else {
+        ok(0,"$file has incorrect POD syntax --ERROR");
+    }
+}
+
+exit 0;

diff --git a/t/012throwables.t b/t/012throwables.t
new file mode 100644 (file)
index 0000000..7600cbd
--- /dev/null
+++ b/t/012throwables.t
@@ -0,0 +1,234 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+
+##################
+#Bugzilla Test 12#
+######Errors######
+
+use strict;
+use lib qw(. lib t);
+
+use Bugzilla::Constants;
+use Bugzilla::WebService::Constants;
+
+use File::Spec;
+use Support::Files;
+use Support::Templates;
+use Test::More;
+
+my %Errors = ();
+
+# Just a workaround for template errors handling. Define it as used.
+push @{$Errors{code}{template_error}{used_in}{'Bugzilla/Error.pm'}}, 0;
+
+# Define files to test. Each file would have a list of error messages, if any.
+my %test_templates = ();
+my %test_modules = ();
+
+# Find all modules
+foreach my $module (@Support::Files::testitems) {
+    $test_modules{$module} = ();
+}
+
+# Find all error templates
+# Process all files since otherwise handling template hooks would became too
+# hairy. But let us do it only once.
+
+foreach my $include_path (@include_paths) {
+    foreach my $path (@{$actual_files{$include_path}}) {
+        my $file = File::Spec->catfile($include_path, $path);
+        $file =~ s/\s.*$//; # nuke everything after the first space
+        $file =~ s|\\|/|g if ON_WINDOWS;  # convert \ to / in path if on windows
+        $test_templates{$file} = () 
+            if $file =~ m#global/(code|user)-error\.html\.tmpl#;
+
+        # Make sure the extension is not disabled
+        if ($file =~ m#^(extensions/[^/]+/)#) {
+            $test_templates{$file} = ()
+                if ! -e "${1}disabled"
+                && $file =~ m#global/(code|user)-error-errors\.html\.tmpl#;
+        }
+    }
+}
+
+# Count the tests. The +1 is for checking the WS_ERROR_CODE errors.
+my $tests = (scalar keys %test_modules) + (scalar keys %test_templates) + 1;
+exit 0 if !$tests;
+
+# Set requested tests counter.
+plan tests => $tests;
+
+# Collect all errors defined in templates
+foreach my $file (keys %test_templates) {
+    $file =~ m|template/([^/]+).*/global/([^/]+)-error(?:-errors)?\.html\.tmpl|;
+    my $lang = $1;
+    my $errtype = $2;
+
+    if (! open (TMPL, $file)) {
+        Register(\%test_templates, $file, "could not open file --WARNING");
+        next;
+    }
+    
+    my $lineno=0;
+    while (my $line = <TMPL>) {
+        $lineno++;
+        if ($line =~ /\[%\s[A-Z]+\s*error\s*==\s*"(.+)"\s*%\]/) {
+            my $errtag = $1;
+            if ($errtag =~ /\s/) {
+                Register(\%test_templates, $file, 
+                "has an error definition \"$errtag\" at line $lineno with "
+                . "space(s) embedded --ERROR");
+            }
+            else {
+                push @{$Errors{$errtype}{$errtag}{defined_in}{$lang}{$file}}, $lineno;
+            }
+        }
+    }
+    close(TMPL);
+}
+
+# Collect all used errors from cgi/pm files
+foreach my $file (keys %test_modules) {
+    $file =~ s/\s.*$//; # nuke everything after the first space (#comment)
+    next if (!$file); # skip null entries
+    if (! open (TMPL, $file)) {
+        Register(\%test_modules, $file, "could not open file --WARNING");
+        next;
+    }
+
+    my $lineno = 0;
+    while (my $line = <TMPL>) {
+        last if $line =~ /^__END__/; # skip the POD (at least in
+                                        # Bugzilla/Error.pm)
+        $lineno++;
+        if ($line =~
+/^[^#]*\b(Throw(Code|User)Error|(user_)?error\s+=>)\s*\(?\s*["'](.*?)['"]/) {
+            my $errtype;
+            # If it's a normal ThrowCode/UserError
+            if ($2) {
+                $errtype = lc($2);
+            }
+            # If it's an AUTH_ERROR tag
+            else {
+                $errtype = $3 ? 'user' : 'code';
+            }
+            my $errtag = $4;
+            push @{$Errors{$errtype}{$errtag}{used_in}{$file}}, $lineno;
+        }
+    }
+    
+    close(TMPL);
+}
+
+# Now let us start the checks
+
+foreach my $errtype (keys %Errors) {
+    foreach my $errtag (keys %{$Errors{$errtype}}) {
+        # Check for undefined tags
+        if (!defined $Errors{$errtype}{$errtag}{defined_in}) {
+            UsedIn($errtype, $errtag, "any");
+        }
+        else {
+            # Check for all languages!!!
+            my @langs = ();
+            foreach my $lang (@languages) {
+                if (!defined $Errors{$errtype}{$errtag}{defined_in}{$lang}) {
+                    push @langs, $lang;
+                }
+            }
+            if (scalar @langs) {
+                UsedIn($errtype, $errtag, join(', ',@langs));
+            }
+            
+            # Now check for tag usage in all DEFINED languages
+            foreach my $lang (keys %{$Errors{$errtype}{$errtag}{defined_in}}) {
+                if (!defined $Errors{$errtype}{$errtag}{used_in}) {
+                    DefinedIn($errtype, $errtag, $lang);
+                }
+            }
+        }
+    }
+}
+
+# And make sure that everything defined in WS_ERROR_CODE
+# is actually a valid error.
+foreach my $err_name (keys %{WS_ERROR_CODE()}) {
+    if (!defined $Errors{'code'}{$err_name} 
+        && !defined $Errors{'user'}{$err_name})
+    {
+        Register(\%test_modules, 'WS_ERROR_CODE',
+            "Error tag '$err_name' is used in WS_ERROR_CODE in"
+            . " Bugzilla/WebService/Constants.pm"
+            . " but not defined in any template, and not used in any code.");
+    }
+}
+
+# Now report modules results
+foreach my $file (sort keys %test_modules) {
+    Report($file, @{$test_modules{$file}});
+}
+
+# And report WS_ERROR_CODE results
+Report('WS_ERROR_CODE', @{$test_modules{'WS_ERROR_CODE'}});
+
+# Now report templates results
+foreach my $file (sort keys %test_templates) {
+    Report($file, @{$test_templates{$file}});
+}
+
+sub Register {
+    my ($hash, $file, $message, $warning) = @_;
+    # If set to 1, $warning will avoid the test to fail.
+    $warning ||= 0;
+    push(@{$hash->{$file}}, {'message' => $message, 'warning' => $warning});
+}
+
+sub Report {
+    my ($file, @errors) = @_;
+    if (scalar @errors) {
+        # Do we only have warnings to report or also real errors?
+        my @real_errors = grep {$_->{'warning'} == 0} @errors;
+        # Extract error messages.
+        @errors = map {$_->{'message'}} @errors;
+        if (scalar(@real_errors)) {
+            ok(0, "$file has ". scalar(@errors) ." error(s):\n" . join("\n", @errors));
+        }
+        else {
+            ok(1, "--WARNING $file has " . scalar(@errors) .
+                  " unused error tag(s):\n" . join("\n", @errors));
+        }
+    }
+    else {
+        # This is used for both code and template files, so let's use
+        # file-independent phrase
+        ok(1, "$file uses error tags correctly");
+    }
+}
+
+sub UsedIn {
+    my ($errtype, $errtag, $lang) = @_;
+    $lang = $lang || "any";
+    foreach my $file (keys %{$Errors{$errtype}{$errtag}{used_in}}) {
+        Register(\%test_modules, $file, 
+            "$errtype error tag '$errtag' is used at line(s) (" 
+            . join (',', @{$Errors{$errtype}{$errtag}{used_in}{$file}}) 
+            . ") but not defined for language(s): $lang");
+    }
+}
+sub DefinedIn {
+    my ($errtype, $errtag, $lang) = @_;
+    foreach my $file (keys %{$Errors{$errtype}{$errtag}{defined_in}{$lang}}) {
+        Register(\%test_templates, $file, 
+            "$errtype error tag '$errtag' is defined at line(s) ("
+            . join (',', @{$Errors{$errtype}{$errtag}{defined_in}{$lang}{$file}}) 
+            . ") but is not used anywhere", 1);
+    }
+}
+
+exit 0;

diff --git a/t/Support/Files.pm b/t/Support/Files.pm
new file mode 100644 (file)
index 0000000..1a8e6ee
--- /dev/null
+++ b/t/Support/Files.pm
@@ -0,0 +1,48 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+package Support::Files;
+
+use File::Find;
+
+@additional_files = ();
+
+@files = glob('*');
+find(sub { push(@files, $File::Find::name) if $_ =~ /\.pm$/;}, 'Bugzilla');
+push(@files, 'extensions/create.pl');
+
+my @extensions = glob('extensions/*');
+foreach my $extension (@extensions) {
+    # Skip disabled extensions
+    next if -e "$extension/disabled";
+
+    find(sub { push(@files, $File::Find::name) if $_ =~ /\.pm$/;}, $extension);
+}
+
+sub isTestingFile {
+    my ($file) = @_;
+    my $exclude;
+
+    if ($file =~ /\.cgi$|\.pl$|\.pm$/) {
+        return 1;
+    }
+    my $additional;
+    foreach $additional (@additional_files) {
+        if ($file eq $additional) { return 1; }
+    }
+    return undef;
+}
+
+foreach $currentfile (@files) {
+    if (isTestingFile($currentfile)) {
+        push(@testitems,$currentfile);
+    }
+}
+
+
+1;

diff --git a/t/Support/Systemexec.pm b/t/Support/Systemexec.pm
new file mode 100644 (file)
index 0000000..620cce2
--- /dev/null
+++ b/t/Support/Systemexec.pm
@@ -0,0 +1,19 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Support::Systemexec;
+require Exporter;
+@ISA = qw(Exporter);
+@EXPORT = qw(system exec);
+@EXPORT_OK = qw();
+sub system($$@) {
+  1;
+}
+sub exec($$@) {
+  1;
+}
+1;

diff --git a/t/Support/Templates.pm b/t/Support/Templates.pm
new file mode 100644 (file)
index 0000000..a28ec87
--- /dev/null
+++ b/t/Support/Templates.pm
@@ -0,0 +1,119 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+package Support::Templates;
+
+use strict;
+
+use lib 't';
+use base qw(Exporter);
+@Support::Templates::EXPORT = 
+         qw(@languages @include_paths $english_default_include_path
+         %include_path @referenced_files %actual_files $num_actual_files);
+use vars qw(@languages @include_paths $english_default_include_path
+            %include_path @referenced_files %actual_files $num_actual_files);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Install::Util qw(template_include_path);
+use Support::Files;
+
+use File::Find;
+use File::Spec;
+
+# The available template languages
+@languages = ();
+
+# The colon separated includepath per language
+%include_path = ();
+
+# All include paths
+@include_paths = ();
+
+# English default include path
+$english_default_include_path =
+    File::Spec->catdir(bz_locations()->{'templatedir'}, 'en', 'default');
+
+# Files which are referenced in the cgi files
+@referenced_files = ();
+
+# All files sorted by include_path
+%actual_files = ();
+
+# total number of actual_files
+$num_actual_files = 0;
+
+# Set the template available languages and include paths
+@languages = @{ Bugzilla->languages };
+@include_paths = @{ template_include_path({ language => Bugzilla->languages }) };
+
+my @files;
+
+# Local subroutine used with File::Find
+sub find_templates {
+    # Prune CVS directories
+    if (-d $_ && $_ eq 'CVS') {
+        $File::Find::prune = 1;
+        return;
+    }
+
+    # Only include files ending in '.tmpl'
+    if (-f $_ && $_ =~ m/\.tmpl$/i) {
+        my $filename;
+        my $local_dir = File::Spec->abs2rel($File::Find::dir,
+                                            $File::Find::topdir);
+
+        # File::Spec 3.13 and newer return "." instead of "" if both
+        # arguments of abs2rel() are identical.
+        $local_dir = "" if ($local_dir eq ".");
+
+        if ($local_dir) {
+            $filename = File::Spec->catfile($local_dir, $_);
+        } else {
+            $filename = $_;
+        }
+
+        push(@files, $filename);
+    }
+}
+
+# Scan the given template include path for templates
+sub find_actual_files {
+  my $include_path = $_[0];
+  @files = ();
+  find(\&find_templates, $include_path);
+  return @files;
+}
+
+
+foreach my $include_path (@include_paths) {
+  $actual_files{$include_path} = [ find_actual_files($include_path) ];
+  $num_actual_files += scalar(@{$actual_files{$include_path}});
+}
+
+# Scan Bugzilla's perl code looking for templates used and put them
+# in the @referenced_files array to be used by the 004template.t test.
+my %seen;
+
+foreach my $file (@Support::Files::testitems) {
+    open (FILE, $file);
+    my @lines = <FILE>;
+    close (FILE);
+    foreach my $line (@lines) {
+        if ($line =~ m/template->process\(\"(.+?)\", .+?\)/) {
+            my $template = $1;
+            # Ignore templates with $ in the name, since they're
+            # probably vars, not real files
+            next if $template =~ m/\$/;
+            next if $seen{$template};
+            push (@referenced_files, $template);
+            $seen{$template} = 1;
+        }
+    }
+}
+
+1;

diff --git a/template/en/default/account/auth/login-small.html.tmpl b/template/en/default/account/auth/login-small.html.tmpl
new file mode 100644 (file)
index 0000000..801fef8
--- /dev/null
+++ b/template/en/default/account/auth/login-small.html.tmpl
@@ -0,0 +1,113 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# Use the current script name. If an empty name is returned,
+  # then we are accessing the home page. %]
+
+[% login_target = cgi.url("-relative" => 1, "-query" => 1) %]
+[% IF !login_target OR login_target.match("^token.cgi") %]
+ [% login_target = "index.cgi" %]
+[% END %]
+
+<li id="mini_login_container[% qs_suffix %]">
+  <span class="separator">| </span>
+  [% connector = "?" %]
+  [% IF cgi.request_method == "GET" AND cgi.query_string %]
+    [% connector = "&" %]
+  [% END %]
+  [% script_url = login_target _ connector _ "GoAheadAndLogIn=1" %]
+  <a id="login_link[% qs_suffix %]" href="[% script_url FILTER html %]"
+     onclick="return show_mini_login_form('[% qs_suffix %]')">Log In</a>
+
+  [% Hook.process('additional_methods') %]
+  
+  <form action="[% login_target FILTER html %]" method="POST" 
+        class="mini_login bz_default_hidden"
+        id="mini_login[% qs_suffix FILTER html %]"
+        onsubmit="return check_mini_login_fields( '[% qs_suffix FILTER html %]' );"
+  >
+    <input id="Bugzilla_login[% qs_suffix FILTER html %]" 
+           class="bz_login"
+           name="Bugzilla_login"
+           title="Login"
+           onfocus="mini_login_on_focus('[% qs_suffix FILTER js %]')"
+    >
+    <input class="bz_password" 
+           id="Bugzilla_password[% qs_suffix FILTER html %]" 
+           name="Bugzilla_password"
+           type="password"
+           title="Password"
+    >
+    <input class="bz_password bz_default_hidden bz_mini_login_help" type="text" 
+           id="Bugzilla_password_dummy[% qs_suffix %]" value="password"
+           title="Password"
+           onfocus="mini_login_on_focus('[% qs_suffix FILTER js %]')"
+    >
+    [% IF Param('rememberlogin') == 'defaulton' ||
+          Param('rememberlogin') == 'defaultoff' 
+    %]
+      <input type="checkbox" id="Bugzilla_remember[% qs_suffix %]" 
+             name="Bugzilla_remember" value="on" class="bz_remember"
+                 [%+ "checked" IF Param('rememberlogin') == "defaulton" %]>
+      <label for="Bugzilla_remember[% qs_suffix %]">Remember</label>
+    [% END %]
+    <input type="submit" name="GoAheadAndLogIn" value="Log in" 
+            id="log_in[% qs_suffix %]">
+    <script type="text/javascript">
+      mini_login_constants = {
+          "login" : "login",
+          "warning" : "You must set the login and password before logging in."
+      };
+      [%# We need this event to fire after autocomplete, because it does
+        # something different depending on whether or not there's already
+        # data in the login and password box.
+        # However, autocomplete happens at all sorts of different times in
+        # different browsers (before or after onDOMReady, before or after
+        # window.onload, in almost all combinations you can imagine).
+        # The only good solution I found is to time the event 200 
+        # milliseconds after window.onload for WebKit (doing it immediately 
+        # at onload works in Chrome but not in Safari, but I can't detect 
+        # them separately using YUI), and right after onDOMReady in Gecko. 
+        # The WebKit solution is also fairly guaranteed to work on any 
+        # browser (it's just strange, since the fields only populate 200 ms
+        # after the page loads), so it's the default. IE doesn't even
+        # recognize our forms as login forms, so I made it use the Gecko
+        # method also (since it's nicer visually). Opera never autocompletes
+        # forms without user interaction, so it also uses the Gecko method.
+        #%]
+      if (YAHOO.env.ua.gecko || YAHOO.env.ua.ie || YAHOO.env.ua.opera) {
+          YAHOO.util.Event.onDOMReady(function() {
+              init_mini_login_form('[% qs_suffix FILTER html %]');
+          });
+      }
+      else {
+          YAHOO.util.Event.on(window, 'load', function () {
+              window.setTimeout(function() {
+                  init_mini_login_form('[% qs_suffix FILTER html %]');
+              }, 200);
+          });
+    }
+    </script>
+    <a href="#" onclick="return hide_mini_login_form('[% qs_suffix %]')">[x]</a>
+  </form>
+</li>
+<li id="forgot_container[% qs_suffix %]">
+  <span class="separator">| </span>
+  <a id="forgot_link[% qs_suffix %]" href="[% script_url FILTER html %]#forgot"
+     onclick="return show_forgot_form('[% qs_suffix %]')">Forgot Password</a>
+  <form action="token.cgi" method="post" id="forgot_form[% qs_suffix %]"
+        class="mini_forgot bz_default_hidden">
+    <label for="login[% qs_suffix FILTER html %]">Login:</label>
+    <input type="text" name="loginname" size="20" id="login[% qs_suffix FILTER html %]">
+    <input id="forgot_button[% qs_suffix %]" value="Reset Password" 
+           type="submit">
+    <input type="hidden" name="a" value="reqpw">
+    <input type="hidden" id="token[% qs_suffix FILTER html %]" name="token" value="[% issue_hash_token(['reqpw']) FILTER html %]">
+    <a href="#" onclick="return hide_forgot_form('[% qs_suffix %]')">[x]</a>
+  </form>
+</li>

diff --git a/template/en/default/account/auth/login.html.tmpl b/template/en/default/account/auth/login.html.tmpl
new file mode 100644 (file)
index 0000000..0a8a3d3
--- /dev/null
+++ b/template/en/default/account/auth/login.html.tmpl
@@ -0,0 +1,116 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # target: string. URL to go to after login.
+  #%]
+
+[% IF !target %]
+ [% target = "index.cgi" %]
+[% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = "Log in to $terms.Bugzilla",
+  onload = "document.forms['login'].Bugzilla_login.focus()"
+%]
+
+[% USE Bugzilla %]
+
+<p>
+  [% terms.Bugzilla %] needs a legitimate login and password to continue.
+</p>
+
+<form name="login" action="[% target FILTER html %]" method="POST"
+[%- IF Bugzilla.cgi.param("data") %] enctype="multipart/form-data"[% END %]>
+  <table>
+    <tr>
+      <th align="right"><label for="Bugzilla_login">Login:</label></th>
+      <td>
+        <input size="35" id="Bugzilla_login" name="Bugzilla_login">
+        [% Param('emailsuffix') FILTER html %]
+      </td>
+    </tr>
+    <tr>
+      <th align="right"><label for="Bugzilla_password">Password:</label></th>
+      <td>
+        <input type="password" size="35" id="Bugzilla_password" name="Bugzilla_password">
+      </td>
+    </tr>
+
+    [% IF Param('rememberlogin') == 'defaulton' || 
+          Param('rememberlogin') == 'defaultoff' %]
+      <tr>
+        <th>&nbsp;</th>
+        <td>
+          <input type="checkbox" id="Bugzilla_remember" name="Bugzilla_remember" value="on"
+                 [%+ "checked" IF Param('rememberlogin') == "defaulton" %]>
+          <label for="Bugzilla_remember">Remember my Login</label>
+        </td>
+      </tr>
+    [% END %]
+
+    <tr>
+      <th>&nbsp;</th>
+      <td>
+        <input type="checkbox" id="Bugzilla_restrictlogin" name="Bugzilla_restrictlogin"
+               checked="checked">
+        <label for="Bugzilla_restrictlogin">Restrict this session to this IP address
+        (using this option improves security)</label>
+      </td>
+    </tr>
+  </table>
+
+  [% PROCESS "global/hidden-fields.html.tmpl"
+     exclude="^Bugzilla_(login|password|restrictlogin)$" %]
+
+  <input type="submit" name="GoAheadAndLogIn" value="Log in" id="log_in">
+  
+  <p>
+    (Note: you should make sure cookies are enabled for this site. 
+    Otherwise, you will be required to log in frequently.)
+  </p>
+</form>
+
+[% Hook.process('additional_methods') %]
+
+[%# Allow the user to create a new account, or request a token to change
+  # their password, assuming that our auth method allows that.
+  #%]
+
+  [% IF Param("createemailregexp") && user.authorizer.user_can_create_account %]
+    <hr>
+
+    <p>
+      If you don't have a [% terms.Bugzilla %] account, you can
+      <a href="createaccount.cgi">create a new account</a>.
+      [% IF Param("requirelogin") %]
+        A user account is required because this [% terms.Bugzilla %]
+        installation is only accessible to authenticated users.
+      [% ELSIF target.match("_bug\.cgi$") %]
+        A user account is required to file a new [% terms.bug %] or to comment
+        into existing ones so that you can be contacted if more information is
+        needed.
+      [% END %]
+    </p>
+  [% END %]
+
+  [% IF user.authorizer.can_change_password %]
+    <hr>
+
+    <form id="forgot" method="get" action="token.cgi">
+      <input type="hidden" name="a" value="reqpw">
+      If you have an account, but have forgotten your password,
+      enter your login name below and submit a request
+      to change your password.<br>
+      <input size="35" name="loginname">
+      <input type="hidden" id="token" name="token" value="[% issue_hash_token(['reqpw']) FILTER html %]">
+      <input type="submit" id="request" value="Reset Password">
+    </form>
+  [% END %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/account/cancel-token.txt.tmpl b/template/en/default/account/cancel-token.txt.tmpl
new file mode 100644 (file)
index 0000000..4d9cb9a
--- /dev/null
+++ b/template/en/default/account/cancel-token.txt.tmpl
@@ -0,0 +1,91 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+From: [% Param('mailfrom') %]
+To: [% emailaddress %]
+Subject: [% PROCESS subject %]
+X-Bugzilla-Type: admin
+
+A request was canceled from [% remoteaddress %].
+
+If you did not request this, it could be either an honest
+mistake or someone attempting to break into your [% terms.Bugzilla %] account.
+
+Take a look at the information below and forward this email
+to [% Param('maintainer') %] if you suspect foul play.
+
+            Token: [% token %]
+       Token Type: [% tokentype %]
+             User: [% emailaddress %]
+       Issue Date: [% issuedate FILTER time("%Y-%m-%d %H:%M:%S %Z", timezone) %]
+       Event Data: [% eventdata %]
+Canceled Because: [% PROCESS cancelactionmessage %]
+
+[% BLOCK subject %]
+  [% IF tokentype == 'new_account' %]
+    User account creation request canceled
+  [% ELSIF tokentype == 'password' %]
+    Password change request canceled
+  [% ELSIF tokentype == 'emailnew' OR tokentype == 'emailold' %]
+    Email change request canceled
+  [% ELSE %]
+    [% tokentype %] token canceled
+  [% END %]
+[% END %]
+
+[% BLOCK cancelactionmessage %]
+  [% IF    cancelaction == 'account_exists' %]
+    Account [% email %] already exists.
+
+  [% ELSIF cancelaction == 'email_change_canceled' %]
+    The request to change the email address for
+    the [% old_email %] account to [% new_email %] has
+    been canceled.
+
+  [% ELSIF cancelaction == 'email_change_canceled_reinstated' %]
+    The request to change the email address for your account
+    to [% new_email %] has been canceled. Your old account
+    settings have been reinstated.
+
+  [% ELSIF cancelaction == 'emailold_change_canceled' %]
+    The request to change the email address for your account
+    to [% new_email %] has been canceled.
+
+  [% ELSIF cancelaction == 'password_change_canceled' %]
+    You have requested cancellation.
+
+  [% ELSIF cancelaction == 'account_creation_canceled' %]
+    The creation of the user account [% emailaddress %]
+    has been canceled.
+
+  [% ELSIF cancelaction == 'user_logged_in' %]
+    You have logged in.
+
+  [% ELSIF cancelaction == 'wrong_token_for_changing_passwd' %]
+    You have tried to use the token to change the password.
+
+  [% ELSIF cancelaction == 'wrong_token_for_cancelling_email_change' %]
+    You have tried to use the token to cancel the email address change.
+
+  [% ELSIF cancelaction == 'wrong_token_for_confirming_email_change' %]
+    You have tried to use the token to confirm the email address change.
+
+  [% ELSIF cancelaction == 'wrong_token_for_creating_account' %]
+    You have tried to use the token to create a user account.
+
+  [% ELSE %]
+    [%# Give sensible error if the cancel-token function is used incorrectly.
+      #%]
+    You are using [% terms.Bugzilla %]'s cancel-token function incorrectly. You
+    passed in the string '[% cancelaction %]'. The correct use is to pass
+    in a tag, and define that tag in the file cancel-token.txt.tmpl.
+
+    If you are a [% terms.Bugzilla %] end-user seeing this message, please forward this
+    email to [% Param('maintainer') %].
+  [% END %]
+[% END %]

diff --git a/template/en/default/account/create.html.tmpl b/template/en/default/account/create.html.tmpl
new file mode 100644 (file)
index 0000000..bf2cf31
--- /dev/null
+++ b/template/en/default/account/create.html.tmpl
@@ -0,0 +1,75 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE
+  # none
+  # 
+  # Param("maintainer") is used to display the maintainer's email.
+  # Param("emailsuffix") is used to pre-fill the email field.
+  #%]
+
+[% title = BLOCK %]
+  Create a new [% terms.Bugzilla %] account
+[% END %]
+
+[% PROCESS global/header.html.tmpl
+           title = title
+           onload = "document.forms['account_creation_form'].login.focus();" %]
+
+<p>
+  To create a [% terms.Bugzilla %] account, all you need to do is to enter
+[% IF Param('emailsuffix') == '' %]
+  a legitimate email address.
+[% ELSE %]
+  an account name which when combined with [% Param('emailsuffix') %]
+  corresponds to an address where you receive email.
+[% END %]
+  You will receive an email at this address to confirm the creation of your
+  account. <b>You will not be able to log in until you receive the email.</b>
+  If it doesn't arrive within a reasonable amount of time, you may contact
+  the maintainer of this [% terms.Bugzilla %] installation
+  at <a href="mailto:[% Param("maintainer") %]">[% Param("maintainer") %]</a>.
+</p>
+
+<p>
+  A user account is required to report new [% terms.bugs %] or to comment into
+  existing ones, as you may be contacted for more information if needed.
+  This also lets other users clearly identify who is the author of comments
+  or changes made into [% terms.bugs %]. <b>Note that your email address will
+  <u>never</u> be displayed to logged out users. Only registered users will be
+  able to see it.</b>
+</p>
+
+[% IF Param('createemailregexp') == '.*' && Param('emailsuffix') == '' %]
+<p>
+  <b>PRIVACY NOTICE:</b> [% terms.Bugzilla %] is an open [% terms.bug %]
+  tracking system. Activity on most [% terms.bugs %], including email
+  addresses, will be visible to registered users. We <b>recommend</b> using a
+  secondary account or free web email service (such as Gmail, Yahoo,
+  Hotmail, or similar) to avoid receiving spam at your primary email address.
+</p>
+[% END %]
+
+<form id="account_creation_form" method="get" action="createaccount.cgi">
+  <table>
+    <tr>
+      <td align="right">
+        <b>Email address:</b>
+      </td>
+      <td>
+        <input size="35" id="login" name="login">
+        [% Param('emailsuffix') FILTER html %]
+      </td>
+    </tr>
+  </table>
+  <br>
+  <input type="hidden" id="token" name="token" value="[% issue_hash_token(['create_account']) FILTER html %]">
+  <input type="submit" id="send" value="Send">
+</form>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/account/created.html.tmpl b/template/en/default/account/created.html.tmpl
new file mode 100644 (file)
index 0000000..f35deca
--- /dev/null
+++ b/template/en/default/account/created.html.tmpl
@@ -0,0 +1,25 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # login: string. The user's Bugzilla login email address.
+  #%]
+
+[% title = BLOCK %]
+  Request for new user account '[% login FILTER html %]' submitted
+[% END %]
+
+[% PROCESS global/header.html.tmpl title = title %]
+
+<p>
+  A confirmation email has been sent containing a link to continue
+  creating an account. The link will expire if an account is not
+  created within [% constants.MAX_TOKEN_AGE FILTER html %] days.
+</p>
+
+[% PROCESS global/footer.html.tmpl %] 

diff --git a/template/en/default/account/email/change-new.txt.tmpl b/template/en/default/account/email/change-new.txt.tmpl
new file mode 100644 (file)
index 0000000..a6c54a7
--- /dev/null
+++ b/template/en/default/account/email/change-new.txt.tmpl
@@ -0,0 +1,27 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+From: [% Param('mailfrom') %]
+To: [% emailaddress %]
+Subject: [% terms.Bugzilla %] Change Email Address Request
+X-Bugzilla-Type: admin
+
+[%+ terms.Bugzilla %] has received a request to change the email address
+for the account [% oldemailaddress %] to your address.
+
+To confirm the change, visit the following link:
+
+[%+ urlbase %]token.cgi?t=[% token FILTER uri %]&a=cfmem
+
+If you are not the person who made this request, or you wish to cancel
+this request, visit the following link:
+
+[%+ urlbase %]token.cgi?t=[% token FILTER uri %]&a=cxlem
+
+If you do nothing, the request will lapse after [% constants.MAX_TOKEN_AGE %] days
+(on [% expiration_ts FILTER time("%B %e, %Y at %H:%M %Z") %]).

diff --git a/template/en/default/account/email/change-old.txt.tmpl b/template/en/default/account/email/change-old.txt.tmpl
new file mode 100644 (file)
index 0000000..24b90a2
--- /dev/null
+++ b/template/en/default/account/email/change-old.txt.tmpl
@@ -0,0 +1,27 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+From: [% Param('mailfrom') %]
+To: [% emailaddress %]
+Subject: [% terms.Bugzilla %] Change Email Address Request
+Importance: High
+X-MSMail-Priority: High
+X-Priority: 1
+X-Bugzilla-Type: admin
+
+[%+ terms.Bugzilla %] has received a request to change the email address
+for your account to [%+ newemailaddress %].
+
+If you are not the person who made this request, or you wish to cancel
+this request, visit the following link:
+
+[%+ urlbase %]token.cgi?t=[% token FILTER uri %]&a=cxlem
+
+If you do nothing, and [%+ newemailaddress %] confirms this request,
+the change will be made permanent after [% constants.MAX_TOKEN_AGE %] days
+(on [% expiration_ts FILTER time("%B %e, %Y at %H:%M %Z") %]).

diff --git a/template/en/default/account/email/confirm-new.html.tmpl b/template/en/default/account/email/confirm-new.html.tmpl
new file mode 100644 (file)
index 0000000..0fb9b7e
--- /dev/null
+++ b/template/en/default/account/email/confirm-new.html.tmpl
@@ -0,0 +1,72 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # token: string. The token to be used in the user account creation.
+  # email: email address of the user account.
+  # expiration_ts: expiration date of the token.
+  #%]
+
+[% title = BLOCK %]Create a new user account for '[% email FILTER html %]'[% END %]
+[% PROCESS "global/header.html.tmpl"
+           title = title
+           onload = "document.forms['confirm_account_form'].realname.focus();" %]
+
+<p>
+  To create your account, you must enter a password in the form below.
+  Your email address and Real Name (if provided) will be shown with
+  changes you make.
+</p>
+
+<form id="confirm_account_form" method="post" action="token.cgi">
+  <input type="hidden" name="t" value="[% token FILTER html %]">
+  <input type="hidden" name="a" value="confirm_new_account">
+  <table>
+    <tr>
+      <th align="right">Email Address:</th>
+      <td>[% email FILTER html %]</td>
+    </tr>
+    <tr>
+      <th align="right"><small><i>(OPTIONAL)</i></small> <label for="realname">Real Name</label>:</th>
+      <td><input type="text" id="realname" name="realname" value=""></td>
+    </tr>
+    <tr>
+      <th align="right"><label for="passwd1">Type your password</label>:</th>
+      <td>
+        <input type="password" id="passwd1" name="passwd1" value="">
+        (minimum [% constants.USER_PASSWORD_MIN_LENGTH FILTER none %] characters)
+      </td>
+    </tr>
+    <tr>
+      <th align="right"><label for="passwd2">Confirm your password</label>:</th>
+      <td><input type="password" id="passwd2" name="passwd2" value=""></td>
+    </tr>
+    <tr>
+      <th align="right">&nbsp;</th>
+      <td><input type="submit" id="confirm" value="Create"></td>
+    </tr>
+  </table>
+</form>
+
+<p>
+  This account will not be created if this form is not completed by
+  <u>[% expiration_ts FILTER time("%B %e, %Y at %H:%M %Z") %]</u>.
+</p>
+
+<p>
+  If you do not wish to create an account with this email click the
+  cancel account button below and your details will be forgotten.
+</p>
+
+<form id="cancel_account_form" method="post" action="token.cgi">
+  <input type="hidden" name="t" value="[% token FILTER html %]">
+  <input type="hidden" name="a" value="cancel_new_account">
+  <input type="submit" id="confirm" value="Cancel Account">
+</form>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/account/email/confirm.html.tmpl b/template/en/default/account/email/confirm.html.tmpl
new file mode 100644 (file)
index 0000000..5b54778
--- /dev/null
+++ b/template/en/default/account/email/confirm.html.tmpl
@@ -0,0 +1,35 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # token: string. The token to be used in this address change.
+  #%]
+  
+[% title = "Confirm Change Email" %]
+[% PROCESS global/header.html.tmpl %]
+
+<p>
+  To change your email address, please enter your current password:
+</p>
+
+<form method="post" action="token.cgi">
+  <input type="hidden" name="t" value="[% token FILTER html %]">
+  <input type="hidden" name="a" value="chgem">
+  <table>
+    <tr>
+      <th align="right">Password:</th>
+      <td><input type="password" name="password" size="36"></td>
+    </tr>
+    <tr>
+      <th align="right">&nbsp;</th>
+      <td><input type="submit" id="confirm" value="Submit"></td>
+    </tr>
+  </table>
+</form>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/account/email/request-new.txt.tmpl b/template/en/default/account/email/request-new.txt.tmpl
new file mode 100644 (file)
index 0000000..8ca0ff1
--- /dev/null
+++ b/template/en/default/account/email/request-new.txt.tmpl
@@ -0,0 +1,47 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # token: random string used to authenticate the transaction.
+  # expiration_ts: expiration date of the token.
+  # email: email address of the new account.
+  #%]
+
+From: [% Param('mailfrom') %]
+To: [% email %]
+Subject: [% terms.Bugzilla %]: confirm account creation
+X-Bugzilla-Type: admin
+
+[%+ terms.Bugzilla %] has received a request to create a user account
+using your email address ([% email %]).
+
+To continue creating an account using this email address, visit the 
+following link by [% expiration_ts FILTER time("%B %e, %Y at %H:%M %Z") %]:
+
+[%+ urlbase %]token.cgi?t=[% token FILTER uri %]&a=request_new_account
+
+If you did not receive this email before [% expiration_ts FILTER time("%B %e, %Y at %H:%M %Z") %] or
+you wish to create an account using a different email address you can begin
+again by going to:
+
+[%+ urlbase %]createaccount.cgi
+
+[% IF Param('createemailregexp') == '.*' && Param('emailsuffix') == '' %]
+PRIVACY NOTICE: [% terms.Bugzilla %] is an open [% terms.bug %] tracking system. Activity on most
+[%+ terms.bugs %], including email addresses, will be visible to the public. We recommend
+using a secondary account or free web email service (such as Gmail, Yahoo,
+Hotmail, or similar) to avoid receiving spam at your primary email address.
+[% END %]
+
+If you do not wish to create an account, or if this request was made in
+error you can do nothing or visit the following link:
+
+[%+ urlbase %]token.cgi?t=[% token FILTER uri %]&a=cancel_new_account
+
+If the above links do not work, or you have any other issues regarding
+your account, please contact administration at [% Param('maintainer') %].

diff --git a/template/en/default/account/password/forgotten-password.txt.tmpl b/template/en/default/account/password/forgotten-password.txt.tmpl
new file mode 100644 (file)
index 0000000..0c135a9
--- /dev/null
+++ b/template/en/default/account/password/forgotten-password.txt.tmpl
@@ -0,0 +1,26 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+From: [% Param('mailfrom') %]
+To: [% emailaddress %]
+Subject:  [% terms.Bugzilla %] Change Password Request
+X-Bugzilla-Type: admin
+
+You have (or someone impersonating you has) requested to change your 
+[%+ terms.Bugzilla %] password. To complete the change, visit the following link:
+
+[%+ urlbase %]token.cgi?t=[% token FILTER uri %]&a=cfmpw
+
+If you are not the person who made this request, or you wish to cancel
+this request, visit the following link:
+
+[%+ urlbase %]token.cgi?t=[% token FILTER uri %]&a=cxlpw
+
+If you do nothing, the request will lapse after [% constants.MAX_TOKEN_AGE %] days
+(on [% expiration_ts FILTER time("%B %e, %Y at %H:%M %Z", timezone) %]) or when you
+log in successfully.

diff --git a/template/en/default/account/password/set-forgotten-password.html.tmpl b/template/en/default/account/password/set-forgotten-password.html.tmpl
new file mode 100644 (file)
index 0000000..ff5114a
--- /dev/null
+++ b/template/en/default/account/password/set-forgotten-password.html.tmpl
@@ -0,0 +1,44 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% title = "Change Password" %]
+[% PROCESS global/header.html.tmpl %]
+
+<p>
+  To change your password, enter a new password twice:
+</p>
+
+<form method="post" action="token.cgi">
+  <input type="hidden" name="t" value="[% token FILTER html %]">
+  <input type="hidden" name="a" value="chgpw">
+  <table>
+    <tr>
+      <th align="right">New Password:</th>
+      <td>
+        <input type="password" name="password">
+        (minimum [% constants.USER_PASSWORD_MIN_LENGTH FILTER none %] characters)
+      </td>
+    </tr>
+    
+    <tr>
+      <th align="right">New Password Again:</th>
+      <td>
+        <input type="password" name="matchpassword">
+      </td>
+    </tr>
+    
+    <tr>
+      <th align="right">&nbsp;</th>
+      <td>
+        <input type="submit" id="update" value="Submit">
+      </td>
+    </tr>
+  </table>
+</form>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/account/prefs/account.html.tmpl b/template/en/default/account/prefs/account.html.tmpl
new file mode 100644 (file)
index 0000000..f164166
--- /dev/null
+++ b/template/en/default/account/prefs/account.html.tmpl
@@ -0,0 +1,87 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # realname: string. The user's real name, if any.
+  # login_change_date: string. The date the email change will be complete. (optional)
+  # new_login_name:    string. The user's new Bugzilla login whilst not confirmed. (optional)
+  #%]
+
+<table>
+  <tr>
+    <td colspan="3">
+      Please enter your existing password to confirm account changes.
+    </td>
+  </tr>
+  <tr>
+    <th align="right">Password:</th>
+    <td>
+      <input type="hidden" name="old_login" value="[% user.login FILTER html %]">
+      <input type="password" name="old_password">
+    </td>
+  </tr>              
+  <tr>
+    <td colspan="2"><hr></td>
+  </tr>
+  [% IF user.authorizer.can_change_password %]
+    <tr>
+      <th align="right">New password:</th>
+      <td>
+        <input type="password" name="new_password1">
+      </td>
+    </tr>              
+
+    <tr>
+      <th align="right">Confirm new password:</th>
+      <td>
+        <input type="password" name="new_password2">
+      </td>
+    </tr>              
+  [% END %]
+
+  <tr>
+    <th align="right">Your real name (optional, but encouraged):</th>
+    <td>
+      <input size="35" name="realname" value="[% realname FILTER html %]">
+    </td>
+  </tr>  
+
+  [% IF user.authorizer.can_change_email && Param('allowemailchange') %]
+    [% IF login_change_date %]
+      [% IF new_login_name %]
+        <tr>
+          <th align="right">Pending email address:</th>
+          <td>[% new_login_name FILTER html %]</td>
+        </tr>
+        <tr>
+          <th align="right">Change request expires:</th>
+          <td>[% login_change_date FILTER time %]</td>
+        </tr>
+      [% ELSE %]
+        <tr>
+          <th align="right">Confirmed email address:</th>
+          <td>[% user.login FILTER html %]</td>
+        </tr>
+        <tr>
+          <th align="right">Completion date:</th>
+          <td>[% login_change_date FILTER time %]</td>
+        </tr>
+      [% END %]
+    [% ELSE %]
+      <tr>
+        <th align="right">New email address:</th>
+        <td>
+          <input size="35" name="new_login_name">
+        </td>
+      </tr>
+    [% END %]
+  [% END %]
+
+  [% Hook.process('field') %]
+
+</table>

diff --git a/template/en/default/account/prefs/email.html.tmpl b/template/en/default/account/prefs/email.html.tmpl
new file mode 100644 (file)
index 0000000..c70b9d1
--- /dev/null
+++ b/template/en/default/account/prefs/email.html.tmpl
@@ -0,0 +1,290 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # watchedusers: string.
+  #               Comma-separated list of email addresses this user watches.
+  # watchers:     array.
+  #               Array of users watching this user's account.
+  # excludeself:  boolean.
+  #               True if user is not receiving self-generated mail.
+  # <rolename>:   Multiple hashes, one for each rolename (e.g. assignee; see
+  #               below), keyed by reasonname (e.g. comments; again, see
+  #               below). The value is a boolean - true if the user is
+  #               receiving mail for that reason when in that role.
+  #%]
+
+[%# If the user's bugmail has been disabled by admins, show a warning. %]
+[% IF user.email_disabled %]
+  <div class="warningmessages">
+    Your [% terms.bug %]mail has been disabled by the [% terms.Bugzilla %]
+    administrator.  Please contact [% Param('maintainer') %] to enable
+    [%+ terms.bug %]mails.
+  </div>
+[% END %]
+
+<p>
+  If you want to change your e-mail address <b>[% user.email FILTER html %]</b>
+  to which [% terms.Bugzilla %] sends notifications, click the "Account
+  Information" tab above.
+</p>
+
+<p>
+  If you don't like getting a notification for "trivial"
+  changes to [% terms.bugs %], you can use the settings below to
+  filter some or all notifications.
+</p>
+
+<script type="text/javascript">
+<!--
+function SetCheckboxes(setting) {
+  for (var count = 0; count < document.userprefsform.elements.length; count++) {
+    var theinput = document.userprefsform.elements[count];
+    if (theinput.type == "checkbox" && !theinput.disabled) {
+      if (theinput.name.match("neg")) {
+        theinput.checked = !setting;
+      }
+      else {
+        theinput.checked = setting;
+      }
+    }
+  }
+}
+
+document.write('<input type="button" value="Enable All Mail" onclick="SetCheckboxes(true); return false;">\n');
+document.write('<input type="button" value="Disable All Mail" onclick="SetCheckboxes(false); return false;">\n');
+// -->
+</script>
+
+<hr>
+
+<table>
+  <tr>
+    <td colspan="2">
+      <b>Global options:</b>
+    </td>
+  </tr>
+
+  <tr>
+    <td width="150"></td>
+    <td>
+      [% prefname = "email-$constants.REL_ANY-$constants.EVT_FLAG_REQUESTED" %]
+      <input type="checkbox" name="[% prefname %]" id="[% prefname %]" 
+        value="1"
+        [% " checked"
+           IF user.mail_settings.${constants.REL_ANY}.${constants.EVT_FLAG_REQUESTED} %]>
+      <label for="[% prefname %]">Email me when someone asks me to set a flag</label>
+      <br>
+    </td>
+  </tr>
+  <tr>
+    <td width="150"></td>
+    <td>
+      [% prefname = "email-$constants.REL_ANY-$constants.EVT_REQUESTED_FLAG" %]
+      <input type="checkbox" name="[% prefname %]" id="[% prefname %]" 
+        value="1"
+        [% " checked"
+           IF user.mail_settings.${constants.REL_ANY}.${constants.EVT_REQUESTED_FLAG} %]>
+      <label for="[% prefname %]">Email me when someone sets a flag I asked for</label>
+      <br>
+    </td>
+  </tr>
+[% IF user.is_global_watcher %]
+  <tr>
+    <td width="150"></td>
+    <td>
+      You are watching all [% terms.bugs %]. To be removed from this role,
+      contact
+      <a href="mailto:[% Param("maintainer") %]">[% Param("maintainer") %]</a>.
+    </td>
+  </tr>
+[% END %]
+</table>
+
+<hr>
+<b>Field/recipient specific options:</b>
+<br>
+<br>
+
+[% events = [
+    { id = constants.EVT_ADDED_REMOVED,
+      description = "I'm added to or removed from this capacity" },
+    { id = constants.EVT_BUG_CREATED,
+      description = "A new $terms.bug is created" },
+    { id = constants.EVT_OPENED_CLOSED,
+      description = "The $terms.bug is resolved or reopened" },
+    { id = constants.EVT_COMPONENT,
+      description = "The product or component changes" },
+    { id = constants.EVT_PROJ_MANAGEMENT,
+      description = "The priority, status, severity, or milestone changes" },
+    { id = constants.EVT_COMMENT,
+      description = "New comments are added" },
+    { id = constants.EVT_ATTACHMENT,
+      description = "New attachments are added" },
+    { id = constants.EVT_ATTACHMENT_DATA,
+      description = "Some attachment data changes" },
+    { id = constants.EVT_KEYWORD,
+      description = "The keywords field changes" },
+    { id = constants.EVT_CC,
+      description = "The CC field changes" },
+    { id = constants.EVT_DEPEND_BLOCK,
+      description = "The dependency tree changes" },
+    { id = constants.EVT_OTHER,
+      description = "Any field not mentioned above changes" },
+] %]
+
+[% neg_events = [
+    { id = constants.EVT_UNCONFIRMED,
+      description = "The $terms.bug is in the UNCONFIRMED state" },
+    { id = constants.EVT_CHANGED_BY_ME,
+      description = "The change was made by me" },
+] %]
+
+[% relationships = [
+    { id = constants.REL_ASSIGNEE,
+      description = "Assignee" },
+    { id = constants.REL_REPORTER,
+      description = "Reporter" },
+    { id = constants.REL_CC,
+      description = "CCed" },
+] %]
+
+[% IF Param('useqacontact') %]
+  [% relationships.push({ id = constants.REL_QA, 
+                          description = "QA Contact" }) %]
+[% END %]
+
+
+[%# This is up here so that the "relationships" hook can modify it. %]
+[% no_added_removed = [constants.REL_REPORTER] %]
+
+[% Hook.process('relationships') %]
+
+[% num_columns = relationships.size %]
+
+<table class="bz_emailprefs" border="1">
+  <tr>
+    <td colspan="[% num_columns FILTER html %]" align="center" width="50%">
+      <b>When my relationship to this [% terms.bug %] is:</b>
+    </td>
+    <td rowspan="2" width="40%">
+      <b>I want to receive mail when:</b>
+    </td>
+  </tr>
+
+  <tr>
+    [% FOREACH relationship = relationships %]
+      <th align="center" width="9%">
+        [% relationship.description FILTER html %]
+      </th>
+    [% END %]
+  </tr>
+  
+  [% FOREACH event = events %]  
+    [% count = loop.count() %]
+    <tr class="bz_row_[% count % 2 == 1 ? "odd" : "even" %]">
+      [% FOREACH relationship = relationships %]
+        <td align="center">
+          <input type="checkbox" 
+            name="email-[% relationship.id %]-[% event.id %]"
+            value="1"
+            [%# The combinations don't always make sense; disable a couple %]
+            [% IF event.id == constants.EVT_ADDED_REMOVED AND 
+                  no_added_removed.contains(relationship.id) 
+            %]
+               disabled
+            [% ELSIF user.mail_settings.${relationship.id}.${event.id} %]
+               checked
+            [% END %]>
+        </td>
+      [% END %]
+      <td>
+        [% event.description FILTER html %]
+      </td>
+    </tr>
+  [% END %]
+  
+  <tr>
+    <td colspan="[% num_columns FILTER html %]" 
+        align="center" width="50%">
+      &nbsp;
+    </td>
+    <td width="40%">
+      <b>but not when (overrides above):</b>
+    </td>
+  </tr>
+
+  [% FOREACH event = neg_events %]  
+    [% count = loop.count() %]
+    <tr class="bz_row_[% count % 2 == 1 ? "odd" : "even" %]">
+      [% FOREACH relationship = relationships %]
+        <td align="center">
+          <input type="checkbox" 
+            name="neg-email-[% relationship.id %]-[% event.id %]"
+            value="1"
+            [% " checked" IF NOT user.mail_settings.${relationship.id}.${event.id} %]>
+        </td>
+      [% END %]
+      <td>
+        [% event.description FILTER html %]
+      </td>
+    </tr>
+  [% END %]
+  
+</table>
+
+<hr>
+<b>User Watching</b>
+
+<p>
+If you watch a user, it is as if you are standing in their shoes for the 
+purposes of getting email. Email is sent or not according to <u>your</u>
+preferences for <u>their</u> relationship to the [% terms.bug %] 
+(e.g. Assignee).
+</p>
+
+<p>
+[% IF watchedusers.size %]
+You are watching everyone in the following list:
+  </p>
+  <p>
+    <select id="watched_by_you" name="watched_by_you" multiple="multiple" size="5">
+        [% FOREACH w = watchedusers %]
+           <option value="[% w FILTER html %]">[% w FILTER html %]</option>
+        [% END %]
+    </select> <br />
+    <input type="checkbox" id="remove_watched_users" name="remove_watched_users">
+    <label for="remove_watched_users">Remove selected users from my watch list</label>
+[% ELSE %]
+You are currently not watching any users.
+[% END %]
+</p>
+
+<p id="new_watched_by_you">Add users to my watch list (comma separated list):
+  [% INCLUDE global/userselect.html.tmpl
+     id => "new_watchedusers"
+     name => "new_watchedusers"
+     value => ""
+     size => 60
+     multiple => 5
+  %]
+</p>            
+
+<p id="watching_you">Users watching you:<br>
+  [% IF watchers.size %]
+    [% FOREACH watcher = watchers %]
+      [% watcher FILTER html %] <br>
+    [% END %]
+  [% ELSE %]
+    <i>No one</i>
+  [% END %]
+</p>
+
+<hr>
+
+<br>

diff --git a/template/en/default/account/prefs/permissions.html.tmpl b/template/en/default/account/prefs/permissions.html.tmpl
new file mode 100644 (file)
index 0000000..450765a
--- /dev/null
+++ b/template/en/default/account/prefs/permissions.html.tmpl
@@ -0,0 +1,79 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # has_bits: array of hashes. May be empty.
+  #           name => Names of the permissions the user has.
+  #           desc => Descriptions of the permissions the user has.
+  # set_bits: array of hashes. May be empty.
+  #           name => Names of the permissions the user can set for
+  #           other people.
+  #           desc => Descriptions of the permissions the user can set for
+  #           other people.
+  #%]
+
+<table align="center">
+  <tr>
+    <td>
+      [% IF has_bits.size %]
+        You have the following permission bits set on your account:
+        <table align="center">
+          [% FOREACH bit_description = has_bits %]
+            <tr>
+              <td>[% bit_description.name FILTER html %]</td>
+              <td>[% bit_description.desc FILTER html_light %]</td>
+            </tr>
+          [% END %]
+        </table>
+
+        [% FOREACH privs = ["editcomponents", "canconfirm", "editbugs"] %]
+          [% SET products = ${"local_$privs"} %]
+          [% IF products && products.size %]
+            <br>
+            <p>
+              You also have local '[% privs FILTER html %]' privileges
+              for the following products:
+            </p>
+            <p>
+              [% FOREACH product = products %]
+                [% product.name FILTER html %]<br>
+              [% END %]
+            </p>
+          [% END %]
+        [% END %]
+
+      [% ELSE %]
+        There are no permission bits set on your account.
+      [% END %]
+
+      [% IF user.in_group('editusers') %]
+        <br>
+        You have editusers privileges.  You can turn on and off
+        all permissions for all users.
+      [% ELSIF set_bits.size %]
+        <br>
+        And you can turn on or off the following bits for
+        <a href="editusers.cgi">other users</a>:
+          <table align="center">
+          [% FOREACH bit_description = set_bits %]
+            <tr>
+              <td>[% bit_description.name FILTER html %]</td>
+              <td>[% bit_description.desc FILTER html_light %]</td>
+            </tr>
+          [% END %]
+          </table>
+      [% END %]
+
+      [% IF user.in_group('bz_sudoers') %]
+        <br>
+        You are a member of the <b>bz_sudoers</b> group, so you can 
+        <a href="relogin.cgi?action=prepare-sudo">impersonate someone else</a>.
+      [% END %]
+    </td>
+  </tr>
+</table>

diff --git a/template/en/default/account/prefs/prefs.html.tmpl b/template/en/default/account/prefs/prefs.html.tmpl
new file mode 100644 (file)
index 0000000..4416c95
--- /dev/null
+++ b/template/en/default/account/prefs/prefs.html.tmpl
@@ -0,0 +1,102 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # tabs: List of hashes. May not be empty. Each hash has three members:
+  #   name: string. Name of the tab (used internally.)
+  #   description: string. Description of the tab (used in tab title).
+  #   saveable: boolean. True if tab has a form which can be submitted.
+  #               True if user is not receiving self-generated mail.
+  # Note: For each tab name, a template "prefs/${tab.name}.tmpl" must exist, 
+  # and its interface must be fulfilled.
+  # current_tab: A direct reference to one of the hashes in the tabs list.
+  #              This tab will be displayed.
+  # changes_saved: boolean/string. True if the CGI processed form data before 
+  #                displaying anything, and can contain an optional custom
+  #                message if required (which Perl still evaluates as True).
+  # dont_show_button: boolean. Prevent the display of the "Submit Changes" button.
+  #%]
+
+[% filtered_login = user.login FILTER html %]
+[% PROCESS global/header.html.tmpl
+   title = "User Preferences"
+   subheader = filtered_login
+   style_urls = ['skins/standard/admin.css']
+   javascript_urls = ['js/util.js', 'js/field.js']
+   doc_section = "userpreferences.html"
+   yui = ['autocomplete']
+ %]
+
+[% tabs = [{ name => "settings", label => "General Preferences",
+              link => "userprefs.cgi?tab=settings", saveable => "1" },
+            { name => "email", label => "Email Preferences", 
+              link => "userprefs.cgi?tab=email", saveable => "1" },
+            { name => "saved-searches", label => "Saved Searches", 
+              link => "userprefs.cgi?tab=saved-searches", saveable => "1" },
+            { name => "account", label => "Account Information",
+              link => "userprefs.cgi?tab=account", saveable => "1" },
+            { name => "permissions", label => "Permissions", 
+              link => "userprefs.cgi?tab=permissions", saveable => "0" } ] %]
+
+[% Hook.process('tabs') %]
+
+[% FOREACH tab IN tabs %]
+  [% IF tab.name == current_tab_name %]
+    [% current_tab = tab %]
+    [% LAST %]
+  [% END %]
+[% END %]
+
+[% WRAPPER global/tabs.html.tmpl
+   tabs        = tabs
+   current_tab = current_tab
+%]
+
+[% IF changes_saved %]
+  <div id="message">
+    The changes to your [% current_tab.label FILTER lower %] have been saved.
+
+    [% IF email_changes_saved %]
+      <p>
+        An email has been sent to both old and new email
+        addresses to confirm the change of email address.
+      </p>
+    [% END %]
+  </div>
+[% END %]
+
+<h3>[% current_tab.label %]</h3>
+
+[% IF current_tab.saveable %]
+  <form name="userprefsform" method="post" action="userprefs.cgi">
+    <input type="hidden" name="tab" value="[% current_tab.name %]">
+    <input type="hidden" name="token" value="[% token FILTER html %]">
+[% END %]
+
+[% PROCESS "account/prefs/${current_tab.name}.html.tmpl" 
+                                     IF current_tab.name.defined %]
+
+[% IF current_tab.saveable %]
+    <input type="hidden" name="dosave" value="1">
+
+    [% UNLESS dont_show_button %]
+      <table>
+        <tr>
+          <td width="150">&nbsp;</td>
+          <td>
+            <input type="submit" id="update" value="Submit Changes">
+          </td>
+        </tr>
+      </table>
+    [% END %]
+  </form>
+[% END %]
+
+[% END %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/account/prefs/saved-searches.html.tmpl b/template/en/default/account/prefs/saved-searches.html.tmpl
new file mode 100644 (file)
index 0000000..11d7ef8
--- /dev/null
+++ b/template/en/default/account/prefs/saved-searches.html.tmpl
@@ -0,0 +1,197 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # queryshare_groups: list of groups the user may share queries with
+  #                    (id, name).
+  # bless_group_ids: list of group ids the user may bless.
+  #%]
+
+[% IF user.can_bless %]
+  <script type="text/javascript"><!--
+    function update_checkbox(group) {
+      var bless_groups = [[% bless_group_ids.join(",") FILTER js %]];
+      var checkbox = document.getElementById(group.name.replace(/share_(\d+)/, "force_$1"));
+
+      if (bz_isValueInArray(bless_groups, group.value)) {
+        YAHOO.util.Dom.removeClass(checkbox.parentNode, "bz_default_hidden");
+      } else {
+        YAHOO.util.Dom.addClass(checkbox.parentNode, "bz_default_hidden");
+        checkbox.checked = false;
+      }
+    } //-->
+  </script>
+[% END %]
+
+<p>Your saved searches are as follows:</p>
+
+<blockquote>
+  <table border="1" cellpadding="3">  
+    <tr>
+      <th>
+        Search
+      </th>
+      <th>
+        Run
+      </th>
+      <th>
+        Edit
+      </th>
+      <th>
+        Forget
+      </th>
+      <th>
+        Show in
+        Footer
+      </th>
+      [% may_share = user.in_group(Param('querysharegroup')) && queryshare_groups.size %]
+      [% IF may_share %]
+        <th>
+          Share With a Group
+        </th>
+      [% END %]
+    </tr>
+    <tr>
+      <td>My [% terms.Bugs %]</td>
+      <td>
+        [% filtered_username = user.login FILTER uri %]
+        <a href="[% Param('mybugstemplate').replace('%userid%', filtered_username) %]">Run</a>
+      </td>
+      <td>
+        &nbsp;
+      </td>
+      <td>
+        &nbsp;
+      </td>
+      <td align="center">
+        <input type="checkbox" 
+               name="showmybugslink"
+               value="1"
+               [% " checked" IF user.showmybugslink %]>
+      </td>
+      [% IF may_share %]
+        <td>
+          &mdash;
+        </td>
+      [% END %]
+    </tr>
+    [% FOREACH q = user.queries %]
+      <tr>
+        <td>[% q.name FILTER html %]</td>
+        <td>
+          <a href="buglist.cgi?cmdtype=dorem&amp;remaction=run&amp;namedcmd=[% q.name FILTER uri %]
+                   [% IF q.shared_with_group.id %]&amp;sharer_id=[% user.id FILTER uri %][% END %]">Run</a>
+        </td>
+        <td>
+          <a href="query.cgi?[% q.edit_link FILTER html %]&amp;known_name=
+                   [% q.name FILTER uri %]">Edit</a>
+        </td>
+        <td>
+          [% IF q.used_in_whine %]
+            Remove from <a href="editwhines.cgi">whining</a> first
+          [% ELSE %]
+            <a href="buglist.cgi?cmdtype=dorem&amp;remaction=forget&amp;namedcmd=
+                     [% q.name FILTER uri %]&amp;token=
+                     [% issue_hash_token([q.id, q.name]) FILTER uri %]">Forget</a>
+          [% END %]
+        </td>
+        <td align="center">
+          <input type="checkbox" 
+                 name="link_in_footer_[% q.id FILTER html %]"
+                 value="1"
+                 alt="[% q.name FILTER html %]"
+                 [% " checked" IF q.link_in_footer %]>
+        </td>
+        [% IF may_share %]
+          <td>
+            <select name="share_[% q.id FILTER html %]"
+              [% IF user.can_bless %] onchange="update_checkbox(this);"[% END %]>
+              <option value="">Don't share</option>
+              [% FOREACH group = queryshare_groups %]
+                <option value="[% group.id %]"
+                        [% ' selected="selected"' 
+                           IF q.shared_with_group.id == group.id %]
+                >[% group.name FILTER html %]</option>
+              [% END %]
+            </select>
+            [% IF user.can_bless %]
+              <span [% IF !bless_group_ids.grep("^$q.shared_with_group.id\$").0
+                     %]class="bz_default_hidden"[% END %]>
+                <input type="checkbox" id="force_[% q.id FILTER html %]"
+                       name="force_[% q.id FILTER html %]" value="1">
+                <label for="force_[% q.id FILTER html %]">Add to footer</label>
+              </span>
+            [% END %]
+            [% IF q.shared_with_users %]
+              (shared with [% q.shared_with_users FILTER html %]
+              [%+ q.shared_with_users > 1 ? "users" : "user" %])
+            [% END %]
+          </td>
+        [% END %]
+      </tr>
+    [% END %]
+  </table>
+[% IF user.can_bless %]
+  <p>Note that for every search that has the "Add to footer" selected, a
+     link to the shared search is added to the footer of every user that is
+     a direct member of the group at the time you click Submit Changes.</p>
+[% END %]
+</blockquote>
+
+[% IF user.queries_available.size %]
+  <p>You may use these searches saved and shared by others:</p>
+
+  <table border="1" cellpadding="3">  
+    <tr>
+      <th>
+        Search
+      </th>
+      <th>
+        Shared By
+      </th>
+      <th>
+        Shared To
+      </th>
+      <th>
+        Run
+      </th>
+      <th>
+        Edit
+      </th>
+      <th>
+        Show in
+        Footer
+      </th>
+    </tr>
+    [% FOREACH q = user.queries_available %]
+      <tr>
+        <td>[% q.name FILTER html %]</td>
+        <td>[% q.user.identity FILTER html %]</td>
+        <td>[% q.shared_with_group.name FILTER html %]</td>
+        <td>
+          <a href="buglist.cgi?cmdtype=dorem&amp;remaction=run&amp;namedcmd=
+                   [% q.name FILTER uri %]&amp;sharer_id=
+                   [% q.user.id FILTER uri %]">Run</a>
+        </td>
+        <td>
+          <a href="query.cgi?[% q.edit_link FILTER html %]&amp;known_name=
+                   [% q.name FILTER uri %]">Edit</a>
+        </td>
+        <td align="center">
+          <input type="checkbox" 
+                 name="link_in_footer_[% q.id FILTER html %]"
+                 value="1"
+                 alt="[% q.name FILTER html %]"
+                 [% " checked" IF q.link_in_footer %]>
+        </td>
+      </tr>
+    [% END %]
+  </table>
+[% ELSE %]
+  <p>No searches are shared with you by other users.</p>
+[% END %]

diff --git a/template/en/default/account/prefs/settings.html.tmpl b/template/en/default/account/prefs/settings.html.tmpl
new file mode 100644 (file)
index 0000000..5807958
--- /dev/null
+++ b/template/en/default/account/prefs/settings.html.tmpl
@@ -0,0 +1,68 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # setting_names: an array of strings
+  # settings:      a hash of hashes, keyed by setting_name.
+  #                Each hash contains:
+  #                 is_enabled    - boolean
+  #                 default_value - string (global default for this setting)
+  #                 value         - string (user-defined preference)
+  #                 is_default    - boolean (true if user has no preference)
+  # has_settings_enabled : boolean; is true if there is at least one user pref
+  #                        enabled by the maintainer.
+  #%]
+
+[% PROCESS "global/setting-descs.none.tmpl" %]
+
+[% IF settings.size %]
+  [% UNLESS has_settings_enabled %]
+    <p class="criticalmessages">
+      All user preferences have been disabled by the
+      <a href="mailto:[% Param("maintainer") %]">maintainer</a>
+      of this installation, and so you cannot customize any.
+    </p>
+  [% END %]
+
+  <table border="0" cellpadding="8">
+    [% FOREACH name = setting_names %]
+      [% default_name = name _ '-isdefault' %]
+      [% default_val = settings.${name}.default_value %]
+      <tr>
+        <td align="right">
+          [% setting_descs.$name OR name FILTER html %]
+        </td>
+        <td>
+          [% IF settings.${name}.is_enabled %]
+            <select name="[% name FILTER html %]" id="[% name FILTER html %]">
+              <option value="[% default_name FILTER html %]"
+                [% ' selected="selected"' IF settings.${name}.is_default %]>
+                Site Default ([% setting_descs.${default_val} OR default_val FILTER html %])
+              </option>
+              [% FOREACH x = settings.${name}.legal_values %]
+                <option value="[% x FILTER html %]"
+                  [% ' selected="selected"' 
+                    IF x == settings.${name}.value
+                    AND NOT settings.${name}.is_default %]>
+                  [% setting_descs.${x} OR x FILTER html %]
+                </option>
+              [% END %]
+            </select>
+          [% ELSE %]
+            <select name="[% name FILTER html %]" id="[% name FILTER html %]" disabled="disabled">
+              <option value="[% default_name FILTER html %]">
+                Site Default ([% setting_descs.${default_val} OR default_val FILTER html %])
+              </option>
+            </select>
+          [% END %]
+        </td>
+      </tr>
+    [% END %]
+  </table>
+[% END %]
+<br>

diff --git a/template/en/default/account/profile-activity.html.tmpl b/template/en/default/account/profile-activity.html.tmpl
new file mode 100644 (file)
index 0000000..3f8030a
--- /dev/null
+++ b/template/en/default/account/profile-activity.html.tmpl
@@ -0,0 +1,73 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # otheruser: Bugzilla User Object; The user whose profile activity
+  #                                  we are viewing.
+  #
+  # listselectionvalues: selection values to recreate the current user list.
+  #
+  # profile_changes: An array of hashes containing the following fields:
+  # 
+  #   who: string; login name of who made the change
+  #   activity_when: string; when the change was made
+  #   what: string; the description of the field which was changed
+  #   removed: string; the removed value (maybe empty string)
+  #   added: string; the added value (maybe empty string)
+  #%]
+
+[% title = BLOCK %]
+  Account History for '[% otheruser.login FILTER html %]'
+[% END %]
+
+
+[% PROCESS global/header.html.tmpl
+  title = title
+%]
+
+[% PROCESS admin/users/listselectvars.html.tmpl
+  listselectionvalues = listselectionvalues
+%]
+
+[% columns =
+  [{name               => 'who'
+    heading            => 'Who'
+   }
+   {name               => 'activity_when'
+    heading            => 'When'
+   }
+   {name               => 'what'
+    heading            => 'What'
+    content_use_field  => 1
+   }
+   {name               => 'removed'
+    heading            => 'Removed'
+   }
+   {name               => 'added'
+    heading            => 'Added'
+   }
+  ]
+%]
+
+[% PROCESS admin/table.html.tmpl
+  columns = columns
+  data    = profile_changes
+%]
+
+<p><a href="editusers.cgi?action=edit&amp;userid=
+  [%- otheruser.id FILTER uri %]"
+  title="Edit user '[% otheruser.login FILTER html %]'">Edit this user</a> or
+  <a title="Search For Users" href="editusers.cgi">search for other accounts</a>
+  [% IF listselectionvalues.matchtype != 'exact' %]
+    or go <a title="Return to the user list"
+       href="editusers.cgi?action=list[% INCLUDE listselectionurlparams %]">back
+    to the user list</a>
+  [% END %]
+</p>
+
+[% PROCESS global/footer.html.tmpl %] 

diff --git a/template/en/default/admin/admin.html.tmpl b/template/en/default/admin/admin.html.tmpl
new file mode 100644 (file)
index 0000000..38194e9
--- /dev/null
+++ b/template/en/default/admin/admin.html.tmpl
@@ -0,0 +1,127 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% title = BLOCK %]
+  Administer your installation ([% terms.Bugzilla %]
+  [%+ constants.BUGZILLA_VERSION FILTER html %])
+[% END %]
+
+[% PROCESS global/header.html.tmpl title = title
+                                   style_urls = ['skins/standard/admin.css']
+                                   doc_section = "administration.html"
+%]
+
+<div>
+  This page is only accessible to empowered users. You can access administrative pages
+  from here (based on your privileges), letting you configure different aspects of
+  this installation. Note: some sections may not be accessible to you and are marked
+  using a lighter color.
+</div>
+
+<table>
+  <tr>
+    <td class="admin_links">
+      <dl>
+        [% class = user.in_group('tweakparams') ? "" : "forbidden" %]
+        <dt id="parameters" class="[% class %]"><a href="editparams.cgi">Parameters</a></dt>
+        <dd class="[% class %]">Set core parameters of the installation. That's the
+        place where you specify the URL to access this installation, determine how
+        users authenticate, choose which [% terms.bug %] fields to display, select
+        the mail transfer agent to send email notifications, choose which group of
+        users can use charts and share queries, and much more.</dd>
+
+        <dt id="preferences" class="[% class %]"><a href="editsettings.cgi">Default Preferences</a></dt>
+        <dd class="[% class %]">Set the default user preferences. These are the values
+        which will be used by default for all users. Users will be able to edit their
+        own preferences from the <a href="userprefs.cgi?tab=settings">Preferences</a>.</dd>
+
+        [% class = user.in_group('editcomponents') ? "" : "forbidden" %]
+        <dt id="sanitycheck" class="[% class %]"><a href="sanitycheck.cgi">Sanity Check</a></dt>
+        <dd class="[% class %]">Run sanity checks to locate problems in your database.
+        This may take several tens of minutes depending on the size of your installation.
+        You can also automate this check by running <tt>sanitycheck.pl</tt> from a cron job.
+        A notification will be sent per email to the specified user if errors are detected.</dd>
+
+        [% class = (user.in_group('editusers') || user.can_bless) ? "" : "forbidden" %]
+        <dt id="users" class="[% class %]"><a href="editusers.cgi">Users</a></dt>
+        <dd class="[% class %]">Create new user accounts or edit existing ones. You can
+        also add and remove users from groups (also known as "user privileges").</dd>
+
+        [% class = (Param('useclassification') && user.in_group('editclassifications')) ? "" : "forbidden" %]
+        <dt id="classifications" class="[% class %]"><a href="editclassifications.cgi">Classifications</a></dt>
+        <dd class="[% class %]">If your installation has to manage many products at once,
+        it's a good idea to group these products into distinct categories. This lets users
+        find information more easily when doing searches or when filing new [% terms.bugs %].</dd>
+
+        [% class = (user.in_group('editcomponents')
+                    || user.get_products_by_permission("editcomponents").size) ? "" : "forbidden" %]
+        <dt id="products" class="[% class %]"><a href="editproducts.cgi">Products</a></dt>
+        <dd class="[% class %]">Edit all aspects of products, including group restrictions
+        which let you define who can access [% terms.bugs %] being in these products. You
+        can also edit some specific attributes of products such as
+        <a href="editcomponents.cgi">components</a>, <a href="editversions.cgi">versions</a>
+        and <a href="editmilestones.cgi">milestones</a> directly.</dd>
+
+        [% class = (user.in_group('editcomponents')
+                   || user.get_products_by_permission('editcomponents').size) ? "" : "forbidden" %]
+        <dt id="flags" class="[% class %]"><a href="editflagtypes.cgi">Flags</a></dt>
+        <dd class="[% class %]">A flag is a custom 4-states attribute of [% terms.bugs %]
+        and/or attachments. These states are: granted, denied, requested and undefined.
+        You can set as many flags as desired per [% terms.bug %], and define which users
+        are allowed to edit them.</dd>
+
+        [% Hook.process('end_links_left') %]
+      </dl>
+    </td>
+
+    <td class="admin_links">
+      <dl>
+        [% class = user.in_group('admin') ? "" : "forbidden" %]
+        <dt id="custom_fields" class="[% class %]"><a href="editfields.cgi">Custom Fields</a></dt>
+        <dd class="[% class %]">[% terms.Bugzilla %] lets you define fields which are
+        not implemented by default, based on your local and specific requirements.
+        These fields can then be used as any other field, meaning that you can set
+        them in [% terms.bugs %] and run any search involving them.<br>
+        Before creating new fields, keep in mind that too many fields may make the user
+        interface more complex and harder to use. Be sure you have investigated other ways
+        to satisfy your needs before doing this.</dd>
+
+        <dt id="field_values" class="[% class %]"><a href="editvalues.cgi">Field Values</a></dt>
+        <dd class="[% class %]">Define legal values for fields whose values must belong
+        to some given list. This is also the place where you define legal values for some
+        types of custom fields.</dd>
+
+        <dt id="status_workflow" class="[% class %]"><a href="editworkflow.cgi">[%terms.Bug %] Status Workflow</a></dt>
+        <dd class="[% class %]">Customize your workflow and choose initial [% terms.bug %]
+        statuses available on [% terms.bug %] creation and allowed [% terms.bug %] status
+        transitions when editing existing [% terms.bugs %].</dd>
+
+        [% class = user.in_group('creategroups') ? "" : "forbidden" %]
+        <dt id="groups" class="[% class %]"><a href="editgroups.cgi">Groups</a></dt>
+        <dd class="[% class %]">Define groups which will be used in the installation.
+        They can either be used to define new user privileges or to restrict the access
+        to some [% terms.bugs %].</dd>
+
+        [% class = user.in_group('editkeywords') ? "" : "forbidden" %]
+        <dt id="keywords" class="[% class %]"><a href="editkeywords.cgi">Keywords</a></dt>
+        <dd class="[% class %]">Set keywords to be used with [% terms.bugs %]. Keywords
+        are an easy way to "tag" [% terms.bugs %] to let you find them more easily later.</dd>
+
+        [% class = user.in_group('bz_canusewhines') ? "" : "forbidden" %]
+        <dt id="whining" class="[% class %]"><a href="editwhines.cgi">Whining</a></dt>
+        <dd class="[% class %]">Set queries which will be run at some specified date
+        and time, and get the result of these queries directly per email. This is a
+        good way to create reminders and to keep track of the activity in your installation.</dd>
+
+        [% Hook.process('end_links_right') %]
+      </dl>
+    </td>
+  </tr>
+</table>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/classifications/add.html.tmpl b/template/en/default/admin/classifications/add.html.tmpl
new file mode 100644 (file)
index 0000000..d818d31
--- /dev/null
+++ b/template/en/default/admin/classifications/add.html.tmpl
@@ -0,0 +1,27 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = "Add new classification"
+%]
+
+<form method=post action="editclassifications.cgi">
+  <table border=0 cellpadding=4 cellspacing=0>
+
+    [% PROCESS "admin/classifications/edit-common.html.tmpl" %]
+
+  </table>
+  <hr>
+  <input type=submit value="Add">
+  <input type=hidden name="action" value="new">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+</FORM>
+
+[% PROCESS admin/classifications/footer.html.tmpl %] 
+
+[% PROCESS global/footer.html.tmpl %] 

diff --git a/template/en/default/admin/classifications/del.html.tmpl b/template/en/default/admin/classifications/del.html.tmpl
new file mode 100644 (file)
index 0000000..215db84
--- /dev/null
+++ b/template/en/default/admin/classifications/del.html.tmpl
@@ -0,0 +1,51 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = "Delete classification"
+%]
+
+<table border=1 cellpadding=4 cellspacing=0>
+<tr bgcolor="#6666ff">
+  <th valign="top" align="left">Part</th>
+  <th valign="top" align="left">Value</th>
+
+</tr><tr>
+  <td valign="top">Classification:</td>
+  <td valign="top">[% classification.name FILTER html %]</td>
+
+</tr><tr>
+  <td valign="top">Description:</td>
+  <td valign="top">
+    [% IF classification.description %]
+      [% classification.description FILTER html_light %]
+    [% ELSE %]
+      <font color="red">description missing</font>
+    [% END %]
+  </td>
+
+</tr><tr>
+  <td valign="top">Sortkey:</td>
+  <td valign="top">[% classification.sortkey FILTER html %]</td>
+
+</tr>
+</table>
+
+<h2>Confirmation</h2>
+
+<p>Do you really want to delete this classification?</p>
+<form method=post action="editclassifications.cgi">
+  <input type=submit value="Yes, delete">
+  <input type=hidden name="action" value="delete">
+  <input type=hidden name="classification" value="[% classification.name FILTER html %]">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+</form>
+
+[% PROCESS admin/classifications/footer.html.tmpl %] 
+
+[% PROCESS global/footer.html.tmpl %] 

diff --git a/template/en/default/admin/classifications/edit-common.html.tmpl b/template/en/default/admin/classifications/edit-common.html.tmpl
new file mode 100644 (file)
index 0000000..6f038fc
--- /dev/null
+++ b/template/en/default/admin/classifications/edit-common.html.tmpl
@@ -0,0 +1,35 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # classification: Bugzilla::Classifiation object.
+  #%]
+
+<tr>
+  <th align="right">Classification:</th>
+  <td><input size=64 maxlength=64 name="classification" 
+             value="[% classification.name FILTER html %]"></td>
+</tr>
+<tr>
+  <th align="right">Description:</th>
+  <td>
+    [% INCLUDE global/textarea.html.tmpl
+      name           = 'description'
+      minrows        = 4
+      cols           = 64
+      defaultcontent = classification.description
+    %]
+  </td>
+</tr>
+<tr>
+  <th align="right"><label for="sortkey">Sortkey:</label></th>
+  <td><input id="sortkey" size="20" maxlength="20" name="sortkey"
+             value="[%- classification.sortkey FILTER html %]"></td>
+</tr>
+
+[% Hook.process('rows') %]

diff --git a/template/en/default/admin/classifications/edit.html.tmpl b/template/en/default/admin/classifications/edit.html.tmpl
new file mode 100644 (file)
index 0000000..429eefc
--- /dev/null
+++ b/template/en/default/admin/classifications/edit.html.tmpl
@@ -0,0 +1,55 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = "Edit classification"
+%]
+
+<form method=post action="editclassifications.cgi">
+  <table  border=0 cellpadding=4 cellspacing=0>
+
+    [% PROCESS "admin/classifications/edit-common.html.tmpl" %]
+
+    <tr valign=top>
+      <th align="right">
+        <a href="editproducts.cgi?classification=[% classification.name FILTER uri %]">
+        Edit Products</a>:
+      </th>
+      <td>
+        [% IF classification.products.size > 0 %]
+          <table>
+            [% FOREACH product = classification.products %]
+              <tr>
+                <th align=right valign=top>[% product.name FILTER html %]</th>
+                <td valign=top>
+                  [% IF product.description %]
+                    [% product.description FILTER html_light %]
+                  [% ELSE %]
+                    <font color="red">description missing</font>
+                  [% END %]
+                </td>
+              </tr>
+            [% END %]
+          </table>
+        [% ELSE %]
+          <font color="red">none</font>
+        [% END %]
+      </td>
+    </tr>
+  </table>
+
+  <input type=hidden name="classificationold" 
+         value="[% classification.name FILTER html %]">
+  <input type=hidden name="action" value="update">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+  <input type=submit value="Update">
+</form>
+
+[% PROCESS admin/classifications/footer.html.tmpl %] 
+
+[% PROCESS global/footer.html.tmpl %] 

diff --git a/template/en/default/admin/classifications/footer.html.tmpl b/template/en/default/admin/classifications/footer.html.tmpl
new file mode 100644 (file)
index 0000000..39adb5c
--- /dev/null
+++ b/template/en/default/admin/classifications/footer.html.tmpl
@@ -0,0 +1,10 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+<p>Back to the <a href="./">main [% terms.bugs %] page</a>
+or <a href="editclassifications.cgi"> edit</a> more classifications.</p>

diff --git a/template/en/default/admin/classifications/reclassify.html.tmpl b/template/en/default/admin/classifications/reclassify.html.tmpl
new file mode 100644 (file)
index 0000000..13fb3a3
--- /dev/null
+++ b/template/en/default/admin/classifications/reclassify.html.tmpl
@@ -0,0 +1,77 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = "Reclassify products"
+%]
+
+<form method=post action="editclassifications.cgi">
+  <table border=0 cellpadding=4 cellspacing=0>
+    <tr>
+      <th align="right">Classification:</th>
+      <td valign="top" colspan=3>[% classification.name FILTER html %]</td>
+
+    </tr><tr>
+      <th align="right">Description:</th>
+      <td valign="top" colspan=3>
+        [% IF classification.description %]
+          [% classification.description FILTER html_light %]
+        [% ELSE %]
+          <font color="red">description missing</font>
+        [% END %]
+      </td>
+
+    </tr><tr>
+      <th align="right">Sortkey:</th>
+      <td valign="top" colspan=3>[% classification.sortkey FILTER html %]</td>
+
+    </tr><tr>
+      <th align="right">Products:</th>
+      <td valign="top">Other Classifications</td>
+      <td></td>
+      <td valign="top">This Classification</td>
+
+    </tr><tr>
+      <td></td>
+      <td valign="top">
+      <select name="prodlist" id="prodlist" multiple="multiple" size="20">
+        [% FOREACH class = classifications %]
+          [% IF class.id != classification.id %]
+            [% FOREACH product = class.products %]
+              <option value="[% product.name FILTER html %]">
+                [[% class.name FILTER html %]]&nbsp;[% product.name FILTER html %]
+              </option>
+            [% END %]
+          [% END %]
+        [% END %]
+      </select></td>
+
+      <td align="center">
+        <input type=submit value="     Add &gt;&gt;  " name="add_products"><br><br>
+        <input type=submit value="&lt;&lt; Remove" name="remove_products">
+      </td>
+
+      <td valign="middle" rowspan=2>
+        <select name="myprodlist" id="myprodlist" multiple="multiple" size="20">
+          [% FOREACH product = classification.products %]
+            <option value="[% product.name FILTER html %]">
+              [% product.name FILTER html %]
+            </option>
+          [% END %]
+      </select></td>
+    </tr>
+  </table>
+
+  <input type=hidden name="action" value="reclassify">
+  <input type=hidden name="classification" value="[% classification.name FILTER html %]">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+</form>
+
+[% PROCESS admin/classifications/footer.html.tmpl %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/classifications/select.html.tmpl b/template/en/default/admin/classifications/select.html.tmpl
new file mode 100644 (file)
index 0000000..541ded9
--- /dev/null
+++ b/template/en/default/admin/classifications/select.html.tmpl
@@ -0,0 +1,54 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = "Select classification"
+%]
+
+<table border=1 cellpadding=4 cellspacing=0>
+  <tr bgcolor="#6666ff">
+    <th align="left">Edit Classification ...</th>
+    <th align="left">Description</th>
+    <th align="left">Sortkey</th>
+    <th align="left">Products</th>
+    <th align="left">Action</th>
+  </tr>
+
+  [% FOREACH cl = classifications %]
+    <tr>
+      <td valign="top"><a href="editclassifications.cgi?action=edit&amp;classification=[% cl.name FILTER uri %]"><b>[% cl.name FILTER html %]</b></a></td>
+      <td valign="top"> 
+      [% IF cl.description %]
+        [% cl.description FILTER html_light %]
+      [% ELSE %]
+        <font color="red">none</font>
+      [% END %]
+      </td>
+      <td valign="top">[% cl.sortkey FILTER html %]</td>
+      [% IF (cl.id == 1) %]
+        <td valign="top">[% cl.product_count FILTER html %]</td>
+      [% ELSE %]
+        <td valign="top"><a href="editclassifications.cgi?action=reclassify&amp;classification=[% cl.name FILTER uri %]">reclassify ([% cl.product_count FILTER html %])</a></td>
+      [% END %]
+
+      [%# don't allow user to delete the default id. %]
+      [% IF (cl.id == 1) %]
+        <td valign="top">&nbsp;</td>
+      [% ELSE %]
+        <td valign="top"><a href="editclassifications.cgi?action=del&amp;classification=[% cl.name FILTER uri %]">delete</a></td>
+      [% END %]
+    </tr>
+  [% END %]
+
+</table>
+
+<p>
+  <a href="editclassifications.cgi?action=add">Add a new classification</a>.
+</p>
+
+[% PROCESS global/footer.html.tmpl %] 

diff --git a/template/en/default/admin/components/confirm-delete.html.tmpl b/template/en/default/admin/components/confirm-delete.html.tmpl
new file mode 100644 (file)
index 0000000..82bf018
--- /dev/null
+++ b/template/en/default/admin/components/confirm-delete.html.tmpl
@@ -0,0 +1,149 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # comp: object; Bugzilla::Component object representing the component the
+  #               user wants to delete.
+  # product: object; Bugzilla::Product object representing the product to
+  #               which the component belongs.
+  #%]
+
+[% title = BLOCK %]Delete component '[% comp.name FILTER html %]'
+from '[% product.name FILTER html %]' product
+  [% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+  style_urls = ['skins/standard/admin.css']
+%]
+
+<table border="1" cellpadding="4" cellspacing="0">
+<tr bgcolor="#6666FF">
+  <th valign="top" align="left">Field</th>
+  <th valign="top" align="left">Value</th>
+</tr>
+<tr>
+  <td valign="top">Component:</td>
+  <td valign="top">[% comp.name FILTER html %]</td>
+</tr>
+<tr>
+  <td valign="top">Component Description:</td>
+  <td valign="top">[% comp.description FILTER html_light %]</td>
+</tr>
+<tr>
+  <td valign="top">Default assignee:</td>
+  <td valign="top">[% comp.default_assignee.login FILTER html %]</td>
+  
+[% IF Param('useqacontact') %]
+</tr>
+<tr>
+  <td valign="top">Default QA contact:</td>
+  <td valign="top">[% comp.default_qa_contact.login FILTER html %]</td>
+[% END %]
+  
+</tr>
+<tr>
+  <td valign="top">Component of Product:</td>
+  <td valign="top">[% product.name FILTER html %]</td>
+
+[% IF product.description %]
+</tr>
+<tr>
+  <td valign="top">Product Description:</td>
+  <td valign="top">[% product.description FILTER html_light %]</td>
+[% END %]
+
+[% IF Param('usetargetmilestone') %]
+</tr>
+<tr>
+  <td valign="top">Product Milestone URL:</td>
+  <td valign="top">
+    <a href="[% product.milestone_url FILTER html %]">
+      [% product.milestone_url FILTER html %]
+    </a>
+  </td>
+[% END %]
+
+</tr>
+<tr>
+  <TD VALIGN="top">Open for [% terms.bugs %]:</TD>
+  <TD VALIGN="top">[% IF product.is_active && comp.isactive %]Yes[% ELSE %]No[% END %]</td>
+</tr>
+<tr>
+  <td valign="top">[% terms.Bugs %]:</td>
+  <td valign="top">
+[% IF comp.bug_count %]
+  <a title="List of [% terms.bugs %] for component '[% comp.name FILTER html %]'"
+     href="buglist.cgi?component=[% comp.name FILTER uri %]&amp;product=
+          [%- product.name FILTER uri %]">[% comp.bug_count %]</a>
+[% ELSE %]
+  None
+[% END %]
+  </td>
+</tr>
+</table>
+
+<h2>Confirmation</h2>
+  
+[% IF comp.bug_count %]
+
+  [% IF !Param("allowbugdeletion") %]
+  <p class="confirmation">
+    Sorry, there
+
+    [% IF comp.bug_count > 1 %] 
+      are [% comp.bug_count %] [%+ terms.bugs %] 
+    [% ELSE %]
+      is [% comp.bug_count %] [%+ terms.bug %] 
+    [% END %]
+
+    outstanding for this component.  You must reassign 
+
+    [% IF comp.bug_count > 1 %]
+       those [% terms.bugs %] 
+    [% ELSE %]
+       that [% terms.bug %]
+    [% END %]
+
+    to another component before you can delete this one.
+  </p>
+  [% ELSE %]
+
+    <table border="0" cellpadding="20" width="70%" bgcolor="red"><tr><td>
+
+      There [% IF comp.bug_count > 1 %] 
+        are [% comp.bug_count %] [%+ terms.bugs %] 
+      [% ELSE %]
+        is 1 [% terms.bug %]
+      [% END %]
+      entered for this component!  When you delete this
+      component, <b>ALL</b> stored [% terms.bugs %] and
+      their history will be deleted too.
+      </td></tr></table>
+
+  [% END %]
+
+[% END %]
+
+[% IF comp.bug_count == 0 || Param('allowbugdeletion') %]
+
+  <p>Do you really want to delete this component?</p>
+  
+  <form method="post" action="editcomponents.cgi">
+  <input type="submit" id="delete" value="Yes, delete">
+  <input type="hidden" name="action" value="delete">
+  <input type="hidden" name="product" value="[% product.name FILTER html %]">
+  <input type="hidden" name="component" value="[% comp.name FILTER html %]">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+  </form>
+
+[% END %]
+
+[% PROCESS admin/components/footer.html.tmpl %]
+
+[% PROCESS global/footer.html.tmpl %] 

diff --git a/template/en/default/admin/components/create.html.tmpl b/template/en/default/admin/components/create.html.tmpl
new file mode 100644 (file)
index 0000000..f281160
--- /dev/null
+++ b/template/en/default/admin/components/create.html.tmpl
@@ -0,0 +1,36 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # product: object; Bugzilla::Product object representing the product to
+  #               which the component belongs.
+  #%]
+  
+[% title = BLOCK %]Add component to the [% product.name FILTER html %] product[% END %]
+[% PROCESS global/header.html.tmpl
+  yui = [ 'autocomplete' ]
+  javascript_urls = [ "js/field.js" ]
+  title = title
+%]
+
+<form method="post" action="editcomponents.cgi">
+  <table border="0" cellpadding="4" cellspacing="0">
+
+    [% PROCESS "admin/components/edit-common.html.tmpl" %]
+    
+  </table>
+  <hr>
+  <input type="submit" id="create" value="Add">
+  <input type="hidden" name="action" value="new">
+  <input type="hidden" name='product' value="[% product.name FILTER html %]">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+</form>
+
+[% PROCESS admin/components/footer.html.tmpl %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/components/edit-common.html.tmpl b/template/en/default/admin/components/edit-common.html.tmpl
new file mode 100644 (file)
index 0000000..6ff4e07
--- /dev/null
+++ b/template/en/default/admin/components/edit-common.html.tmpl
@@ -0,0 +1,77 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # comp: object; Bugzilla::Component object.
+  #%]
+
+[%# When called from the "New Product" page, the component description field
+  # must have a name different from the product description field. %]
+[% DEFAULT desc_name = "description" %]
+
+<tr>
+  <th class="field_label"><label for="component">Component:</label></th>
+  <td><input size="64" maxlength="64" name="component" id="component"
+             value="[%- comp.name FILTER html %]"></td>
+</tr>
+<tr>
+  <th class="field_label"><label for="[% desc_name FILTER html %]">Component Description:</label></th>
+  <td>
+    [% INCLUDE global/textarea.html.tmpl
+      name           = desc_name
+      id             = desc_name
+      minrows        = 4
+      cols           = 64
+      wrap           = 'virtual'
+      defaultcontent = comp.description
+    %]
+  </td>
+</tr>
+<tr>
+  <th class="field_label"><label for="initialowner">Default Assignee:</label></th>
+  <td>
+    [% INCLUDE global/userselect.html.tmpl
+       name => "initialowner"
+       id => "initialowner"
+       value => comp.default_assignee.login
+       size => 64
+     %]
+  </td>
+</tr>
+[% IF Param('useqacontact') %]
+  <tr>
+    <th class="field_label"><label for="initialqacontact">Default QA contact:</label></th>
+    <td>
+      [% INCLUDE global/userselect.html.tmpl
+         name => "initialqacontact"
+         id => "initialqacontact"
+         value => comp.default_qa_contact.login
+         size => 64
+         emptyok => 1
+       %]
+    </td>
+  </tr>
+[% END %]
+<tr>
+  <th class="field_label"><label for="initialcc">Default CC List:</label></th>
+  <td>
+    [% INCLUDE global/userselect.html.tmpl
+       name     => "initialcc"
+       id       => "initialcc"
+       value    => initial_cc_names
+       size     => 64
+       multiple => 5
+    %]
+    <br>
+    [% IF !Param("usemenuforusers") %]
+      <em>Enter user names for the CC list as a comma-separated list.</em>
+    [% END %]
+  </td>
+</tr>
+
+[% Hook.process('rows') %]

diff --git a/template/en/default/admin/components/edit.html.tmpl b/template/en/default/admin/components/edit.html.tmpl
new file mode 100644 (file)
index 0000000..748175b
--- /dev/null
+++ b/template/en/default/admin/components/edit.html.tmpl
@@ -0,0 +1,66 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # comp: object; Bugzilla::Component object representing the component the
+  #               user wants to edit.
+  # product: object; Bugzilla::Product object representing the product to
+  #               which the component belongs.
+  #%]
+
+[% title = BLOCK %]
+  Edit component '[% comp.name FILTER html %]' of product '[% product.name FILTER html %]'
+[% END %]
+[% PROCESS global/header.html.tmpl
+  title = title
+  yui = [ 'autocomplete' ]
+  javascript_urls = [ "js/field.js" ]
+%]
+
+<form method="post" action="editcomponents.cgi">
+  <table border="0" cellpadding="4" cellspacing="0">
+
+    [% PROCESS "admin/components/edit-common.html.tmpl" %]
+
+    <tr>
+      <th class="field_label"><label for="isactive">Enabled For [% terms.Bugs %]:</label></th>
+      <td><input id="isactive" name="isactive" type="checkbox" value="1" 
+                 [% 'checked="checked"' IF comp.isactive %]></td>
+    </tr>
+    <tr>
+      <th class="field_label">[% terms.Bugs %]:</th>
+      <td>
+[% IF comp.bug_count > 0 %]
+        <a title="[% terms.Bugs %] in component '[% comp.name FILTER html %]'"
+           href="buglist.cgi?component=
+                [%- comp.name FILTER uri %]&amp;product=
+                [%- product.name FILTER uri %]">[% comp.bug_count %]</a>
+[% ELSE %]
+        None
+[% END %]
+      </td>
+    </tr>
+
+  </table>
+
+   <input type="hidden" name="action" value="update">
+   <input type="hidden" name="componentold" value="[% comp.name FILTER html %]">
+   <input type="hidden" name="product" value="[% product.name FILTER html %]">
+   <input type="hidden" name="token" value="[% token FILTER html %]">
+   <input type="submit" value="Save Changes" id="update"> or <a 
+        href="editcomponents.cgi?action=del&amp;product=
+        [%- product.name FILTER uri %]&amp;component=
+        [%- comp.name FILTER uri %]">Delete</a> this component.
+
+</form>
+
+[% PROCESS admin/components/footer.html.tmpl
+  no_edit_component_link = 1
+%]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/components/footer.html.tmpl b/template/en/default/admin/components/footer.html.tmpl
new file mode 100644 (file)
index 0000000..86d0afb
--- /dev/null
+++ b/template/en/default/admin/components/footer.html.tmpl
@@ -0,0 +1,42 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # comp: object; Bugzilla::Component object representing the component 
+  # product: object; Bugzilla::Product object representing the product to
+  #               which the component belongs.
+  #%]
+
+<hr>
+
+<p>
+Edit 
+
+[% IF comp && !no_edit_component_link %]
+  component <a 
+  title="Edit Component '[% comp.name FILTER html %]'"
+  href="editcomponents.cgi?action=edit&amp;product=
+  [%- product.name FILTER uri %]&amp;component=[% comp.name FILTER uri %]">
+   '[% comp.name FILTER html %]'</a> 
+  or edit
+[% END %]
+
+[% IF !no_edit_other_components_link %]
+other components of product <a 
+  title="Choose a component from product '[% product.name FILTER html %]' to edit"
+  href="editcomponents.cgi?product=
+  [%- product.name FILTER uri %]">'[% product.name FILTER html %]'</a>, 
+  or edit 
+[% END %]
+
+product <a 
+  title="Edit Product '[% product.name FILTER html %]'"
+  href="editproducts.cgi?action=edit&amp;product=
+  [%- product.name FILTER uri %]">'[% product.name FILTER html %]'</a>.
+
+</p>

diff --git a/template/en/default/admin/components/list.html.tmpl b/template/en/default/admin/components/list.html.tmpl
new file mode 100644 (file)
index 0000000..fc36bcd
--- /dev/null
+++ b/template/en/default/admin/components/list.html.tmpl
@@ -0,0 +1,133 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # showbugcounts: if defined, then bug counts should be included in the table
+  # product: object; Bugzilla::Product object representing the product to
+  #               which the component belongs.
+  #%]
+
+[% title = BLOCK %]Select component of product
+                   '[% product.name FILTER html %]'[% END %]
+[% PROCESS global/header.html.tmpl
+  title = title
+%]
+
+[% edit_contentlink = BLOCK %]editcomponents.cgi?action=edit&product=
+  [%- product.name FILTER uri %]&component=%%name%%[% END %]
+[% delete_contentlink = BLOCK %]editcomponents.cgi?action=del&product=
+  [%- product.name FILTER uri %]&component=%%name%%[% END %]
+[% bug_count_contentlink = BLOCK %]buglist.cgi?component=%%name%%&product=
+  [%- product.name FILTER uri %][% END %]
+
+
+[% columns = [
+     { 
+       name => "name"
+       heading => "Edit component..."
+       contentlink => edit_contentlink
+     },
+     { 
+       name => "description"
+       heading => "Description" 
+       allow_html_content => 1
+     },
+     { 
+       name => "initialowner"
+       heading => "Default Assignee"
+     },
+   ]
+%]
+
+[% IF Param('useqacontact') %]
+
+  [% columns.push({
+       name => 'initialqacontact'
+       heading => 'Default QA Contact'
+     }) %]
+
+[% END %]
+
+[% columns.push({
+     name => "initial_cc_names"
+     heading => "Default CC list"
+   },
+   {
+     name => "isactive"
+     heading => "Active"
+     yesno_field => 1
+   }) %]
+
+[% IF showbugcounts %]
+
+  [% columns.push({
+       name => 'bug_count'
+       heading => "$terms.Bugs"
+       align => "right"
+       contentlink => bug_count_contentlink
+     }) %]
+
+[% END %]
+
+[% columns.push({
+     heading => "Action"
+     content => "Delete"
+     contentlink => delete_contentlink
+   }) %]
+
+[%# Overrides the initialowner, the initialqacontact, and the initial_cc_names with right values %]
+[% overrides.initialowner = {} %]
+[% overrides.initialqacontact = {} %]
+[% overrides.initial_cc_names = {} %]
+
+[%# "component" is a reserved word in Template Toolkit. %]
+[% FOREACH my_component = product.components %]
+  [% overrides.initialowner.name.${my_component.name} = {
+       override_content => 1
+       content => my_component.default_assignee.login
+     }
+  %]
+  [% overrides.initialqacontact.name.${my_component.name} = {
+       override_content => 1
+       content => my_component.default_qa_contact.login
+     }
+  %]
+  [% SET initial_cc_list = [] %]
+  [% FOREACH cc_user = my_component.initial_cc %]
+    [% initial_cc_list.push(cc_user.login) %]
+  [% END %]
+  [% overrides.initial_cc_names.name.${my_component.name} = {
+       override_content => 1
+       content => initial_cc_list.join(', ')
+     }
+  %]
+[% END %]
+
+[% Hook.process('before_table') %]
+
+[% PROCESS admin/table.html.tmpl
+     columns = columns
+     data = product.components
+     overrides = overrides
+%]
+
+<p><a href="editcomponents.cgi?action=add&amp;product=[% product.name FILTER uri %]">Add</a>
+    a new component to product '[% product.name FILTER html %]'</p>
+
+[% IF ! showbugcounts %]
+
+  <p><a href="editcomponents.cgi?product=[% product.name FILTER uri %]&amp;showbugcounts=1">
+      Redisplay table with [% terms.bug %] counts (slower)</a></p>
+
+[% END %]
+
+[% PROCESS admin/components/footer.html.tmpl
+  no_edit_other_components_link = 1
+ %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/components/select-product.html.tmpl b/template/en/default/admin/components/select-product.html.tmpl
new file mode 100644 (file)
index 0000000..55600d9
--- /dev/null
+++ b/template/en/default/admin/components/select-product.html.tmpl
@@ -0,0 +1,54 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # products: array of product objects
+  # showbugcounts: if defined, then bug counts should be included in the table
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = "Edit components for which product?"
+%]
+
+[% columns = [
+     { 
+       name => "name"
+       heading => "Edit components of..."
+       contentlink => "editcomponents.cgi?product=%%name%%" 
+     },
+     { 
+       name => "description"
+       heading => "Description" 
+       allow_html_content => 1
+     }
+   ]
+%]
+
+[% IF showbugcounts %]
+
+  [% columns.push({
+      name => 'bug_count'
+      heading => "$terms.Bugs"
+      align => "right"
+      contentlink => "buglist.cgi?product=%%name%%"
+    })
+  %]
+
+[% END %]
+
+[% PROCESS admin/table.html.tmpl
+     columns = columns
+     data = products
+%]
+
+[% IF !showbugcounts %]
+  <p><a href="editcomponents.cgi?showbugcounts=1">
+      Redisplay table with [% terms.bug %] counts (slower)</a></p>
+[% END %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/confirm-action.html.tmpl b/template/en/default/admin/confirm-action.html.tmpl
new file mode 100644 (file)
index 0000000..e3b9ef5
--- /dev/null
+++ b/template/en/default/admin/confirm-action.html.tmpl
@@ -0,0 +1,87 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # abuser: identity of the user who created the (invalid?) token.
+  # token_action: the action the token was supposed to serve.
+  # expected_action: the action the user was going to do.
+  # script_name: the script generating this warning.
+  # alternate_script: the suggested script to redirect the user to
+  #                   if he declines submission.
+  #%]
+
+[% PROCESS global/header.html.tmpl title = "Suspicious Action"
+                                   style_urls = ['skins/standard/global.css'] %]
+
+[% IF abuser %]
+  <div class="throw_error">
+    <p>When you view an administrative form in [% terms.Bugzilla %], a token string
+    is randomly generated and stored both in the database and in the form you loaded,
+    to make sure that the requested changes are being made as a result of submitting
+    a form generated by [% terms.Bugzilla %]. Unfortunately, the token used right now
+    is incorrect, meaning that it looks like you didn't come from the right page.
+    The following token has been used :</p>
+
+    <table border="0" cellpadding="5" cellspacing="0">
+      [% IF token_action != expected_action %]
+        <tr>
+          <th>Action&nbsp;stored:</th>
+          <td>[% token_action FILTER html %]</td>
+        </tr>
+        <tr>
+          <th>&nbsp;</th>
+          <td>
+            This action doesn't match the one expected ([% expected_action FILTER html %]).
+          </td>
+        </tr>
+      [% END %]
+
+      [% IF abuser != user.identity %]
+        <tr>
+          <th>Generated&nbsp;by:</th>
+          <td>[% abuser FILTER html %]</td>
+        </tr>
+        <tr>
+          <th>&nbsp;</th>
+          <td>
+            This token has not been generated by you. It is possible that someone
+            tried to trick you!
+          </td>
+        </tr>
+      [% END %]
+    </table>
+
+    <p>Please report this problem to [%+ Param("maintainer") FILTER html %].</p>
+  </div>
+[% ELSE %]
+  <div class="throw_error">
+    It looks like you didn't come from the right page (you have no valid token for
+    the <em>[% expected_action FILTER html %]</em> action while processing the
+    '[% script_name FILTER html%]' script). The reason could be one of:<br>
+    <ul>
+      <li>You clicked the "Back" button of your web browser after having successfully
+      submitted changes, which is generally not a good idea (but harmless).</li>
+      <li>You entered the URL in the address bar of your web browser directly,
+      which should be safe.</li>
+      <li>You clicked on a URL which redirected you here <b>without your consent</b>,
+      in which case this action is much more critical.</li>
+    </ul>
+    Are you sure you want to commit these changes anyway? This may result in
+    unexpected and undesired results.
+  </div>
+
+  <form name="check" id="check" method="post" action="[% script_name FILTER html %]">
+    [% PROCESS "global/hidden-fields.html.tmpl"
+               exclude="^(Bugzilla_login|Bugzilla_password)$" %]
+    <input type="submit" id="confirm" value="Confirm Changes">
+  </form>
+  <p>Or throw away these changes and go back to <a href="[% alternate_script FILTER html %]">
+    [%- alternate_script FILTER html %]</a>.</p>
+[% END %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/custom_fields/cf-js.js.tmpl b/template/en/default/admin/custom_fields/cf-js.js.tmpl
new file mode 100644 (file)
index 0000000..bfdacb8
--- /dev/null
+++ b/template/en/default/admin/custom_fields/cf-js.js.tmpl
@@ -0,0 +1,66 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+// Disable a checkbox based on the state of another one.
+function toggleCheckbox(this_checkbox, other_checkbox_id) {
+    var other_checkbox = document.getElementById(other_checkbox_id);
+    other_checkbox.disabled = !this_checkbox.checked;
+}
+
+var select_values = new Array();
+[% USE Bugzilla %]
+[% FOREACH sel_field = Bugzilla.fields({ is_select => 1 }) %]
+  select_values[[% sel_field.id FILTER js %]] = [
+  [% FOREACH legal_value = sel_field.legal_values %]
+    [%# Prefix components with the name of their product so that admins
+        know which component we're talking about. #%]
+    [% IF sel_field.name == 'component' %]
+      [% SET value_name = display_value('product', legal_value.product.name) _ ': '
+                          _ display_value(sel_field.name, legal_value.name) %]
+    [% ELSE %]
+      [% SET value_name = display_value(sel_field.name, legal_value.name) %]
+    [% END %]
+    [[% legal_value.id FILTER js %], '[% value_name FILTER js %]'][% ',' UNLESS loop.last %]
+  [% END %]
+  ];
+[% END %]
+
+function onChangeType(type_field) {
+    var value_field = document.getElementById('value_field_id');
+    if (type_field.value == [% constants.FIELD_TYPE_SINGLE_SELECT %]
+        || type_field.value == [% constants.FIELD_TYPE_MULTI_SELECT %])
+    {
+        value_field.disabled = false;
+    }
+    else {
+        value_field.disabled = true;
+    }
+
+   var reverse_desc = document.getElementById('reverse_desc');
+   if (type_field.value == [% constants.FIELD_TYPE_BUG_ID %])
+   {
+       reverse_desc.disabled = false;
+   }
+   else {
+       reverse_desc.disabled = true;
+       reverse_desc.value = '';
+   }
+}
+
+function onChangeVisibilityField() {
+    var vis_field = document.getElementById('visibility_field_id');
+    var vis_value = document.getElementById('visibility_values');
+
+    if (vis_field.value) {
+        var values = select_values[vis_field.value];
+        bz_populateSelectFromArray(vis_value, values);
+    }
+    else {
+        bz_clearOptions(vis_value);
+    }
+}

diff --git a/template/en/default/admin/custom_fields/confirm-delete.html.tmpl b/template/en/default/admin/custom_fields/confirm-delete.html.tmpl
new file mode 100644 (file)
index 0000000..85338c0
--- /dev/null
+++ b/template/en/default/admin/custom_fields/confirm-delete.html.tmpl
@@ -0,0 +1,60 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # field: object; the field object that you are trying to delete.
+  # token: string; the delete_field token required to complete deletion.
+  #%]
+
+[% PROCESS "global/field-descs.none.tmpl" %]
+
+[% title = BLOCK %]
+  Delete the Custom Field '[% field.name FILTER html %]' ([% field.description FILTER html %])
+[% END %]
+
+[% PROCESS global/header.html.tmpl
+           title = title
+           style_urls = ['skins/standard/admin.css']
+           doc_section = "custom-fields.html#delete-custom-fields"
+%]
+
+<table border="1" cellpadding="4" cellspacing="0">
+<tr bgcolor="#6666FF">
+  <th valign="top" align="left">Field</th>
+  <th valign="top" align="left">Value</th>
+</tr>
+<tr>
+  <td valign="top">Custom Field:</td>
+  <td valign="top">[% field.name FILTER html %]</td>
+</tr>
+<tr>
+  <td valign="top">Description:</td>
+  <td valign="top">[% field.description FILTER html %]</td>
+</tr>
+<tr>
+  <td valign="top">Type:</td>
+  <td valign="top">[% field_types.${field.type} FILTER html %]</td>
+</tr>
+</table>
+
+<h2>Confirmation</h2>
+
+<p class="confirmation">
+  Are you sure you want to remove this field from the database?<br>
+  <em>This action will only be successful if the field is obsolete,
+  and has never been used in [% terms.abug FILTER html %].</em>
+</p>
+
+<a href="editfields.cgi?action=delete&amp;name=[% field.name FILTER html %]&amp;token=[% token FILTER html %]">
+  Delete field '[% field.description FILTER html %]'</a>
+
+<p>
+  <a href="editfields.cgi">Back to the list of existing custom fields</a>
+</p>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/custom_fields/create.html.tmpl b/template/en/default/admin/custom_fields/create.html.tmpl
new file mode 100644 (file)
index 0000000..fb7f06f
--- /dev/null
+++ b/template/en/default/admin/custom_fields/create.html.tmpl
@@ -0,0 +1,179 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # none
+  #%]
+
+[% PROCESS "global/field-descs.none.tmpl" %]
+
+[% javascript = BLOCK %]
+  [% INCLUDE "admin/custom_fields/cf-js.js.tmpl" %]
+[% END %]
+
+[% PROCESS global/header.html.tmpl
+           title = "Add a new Custom Field"
+           onload = "document.getElementById('new_bugmail').disabled = true;"
+           javascript_urls = [ 'js/util.js' ]
+           doc_section = "custom-fields.html#add-custom-fields"
+           style_urls = ['skins/standard/admin.css']
+%]
+
+[%# set initial editability of fields such as Reverse Relationship Description %]
+<script type="text/javascript">
+YAHOO.util.Event.onDOMReady(function() {onChangeType(document.getElementById('type'))});
+</script>
+
+<p>
+  Adding custom fields can make the interface of [% terms.Bugzilla %] very
+  complicated. Many admins who are new to [% terms.Bugzilla %] start off
+  adding many custom fields, and then their users complain that the interface
+  is "too complex". Please think carefully before adding any custom fields.
+  It may be the case that [% terms.Bugzilla %] already does what you need,
+  and you just haven't enabled the correct feature yet.
+</p>
+
+<ul>
+  <li>Custom field names must begin with "cf_" to distinguish them from
+      standard fields. If you omit "cf_" from the beginning of the name, it
+      will be added for you.</li>
+  <li>Descriptions are a very short string describing the field and will be
+      used as the label for this field in the user interface.</li>
+</ul>
+
+<form id="add_field" action="editfields.cgi" method="GET">
+  <table border="0" cellspacing="0" cellpadding="5" id="edit_custom_field">
+    <tr>
+      <th class="narrow_label"><label for="name">Name:</label></th>
+      <td>
+        <input type="text" id="name" name="name" value="cf_" size="40" maxlength="64">
+      </td>
+
+      <th>
+        <label for="enter_bug">Can be set on [% terms.bug %] creation:</label>
+      </th>
+      <td>
+        <input type="checkbox" id="enter_bug" name="enter_bug" value="1"
+               onchange="toggleCheckbox(this, 'new_bugmail');">
+      </td>
+    </tr>
+    <tr>
+      <th class="narrow_label"><label for="desc">Description:</label></th>
+      <td><input type="text" id="desc" name="desc" value="" size="40"></td>
+
+      <th>
+        <label for="new_bugmail">Displayed in [% terms.bug %]mail for new [% terms.bugs %]:</label>
+      </th>
+      <td><input type="checkbox" id="new_bugmail" name="new_bugmail" value="1"></td>
+    </tr>
+    <tr>
+      <th class="narrow_label"><label for="type">Type:</label></th>
+      <td>
+        <select id="type" name="type" onchange="onChangeType(this)">
+          [% FOREACH type = field_types.keys %]
+            [% NEXT IF type == constants.FIELD_TYPE_UNKNOWN %]
+            <option value="[% type FILTER html %]">[% field_types.$type FILTER html %]</option>
+          [% END %]
+        </select>
+      </td>
+
+      <th><label for="obsolete">Is obsolete:</label></th>
+      <td><input type="checkbox" id="obsolete" name="obsolete" value="1"></td>
+    </tr>
+    <tr>
+      <th class="narrow_label"><label for="sortkey">Sortkey:</label></th>
+      <td>
+        <input type="text" id="sortkey" name="sortkey" size="6" maxlength="6">
+      </td>
+
+      <th align="right"><label for="is_mandatory">Is mandatory:</label></th>
+      <td><input type="checkbox" id="is_mandatory" name="is_mandatory" value="1"></td>
+    </tr>
+
+    <tr>
+      <th class="narrow_label">Long Description:</th>
+      <td>
+         [% INCLUDE global/textarea.html.tmpl
+          name           = 'long_desc'
+          id             = 'long_desc'
+          minrows        = 3
+          maxrows        = 5
+          cols           = 46
+          defaultcontent = defaultcontent
+        %]
+      </td>
+      <th>
+        <label for="visibility_field_id">Field only appears when:</label>
+      </th>
+      <td>
+        <select name="visibility_field_id" id="visibility_field_id"
+                onchange="onChangeVisibilityField()">
+          <option></option>
+          [% FOREACH sel_field = Bugzilla.fields({ is_select => 1 }) %]
+            <option value="[% sel_field.id FILTER html %]">
+              [% sel_field.description FILTER html %]
+              ([% sel_field.name FILTER html %])
+            </option>
+          [% END %]
+        </select>
+        <label for="visibility_values">
+          <strong>is set to any of:</strong>
+        </label>
+        <select multiple="multiple" size="5" name="visibility_values"
+                id="visibility_values" class="field_value">
+          <option value=""></option>
+        </select>
+      </td>
+    </tr>
+
+    <tr>
+      <th class="narrow_label">
+        <label for="reverse_desc">Reverse Relationship Description:</label>
+      </th>
+      <td>
+        <input type="text" id="reverse_desc" name="reverse_desc" value="" size="40" disabled="disabled">
+        <br/>
+        Use this label for the list of [% terms.bugs %] that link to
+        [%+ terms.abug %] with this 
+        [%+ field_types.${constants.FIELD_TYPE_BUG_ID} FILTER html %]
+        field. For example, if the description is "Is a duplicate of",
+        the reverse description would be "Duplicates of this [% terms.bug %]".
+        Leave blank to disable the list for this field.
+      </td>
+      <th>
+        <label for="value_field_id">
+          Field that controls the values<br>
+          that appear in this field:
+        </label>
+      </th>
+
+      <td>
+        <select disabled="disabled" name="value_field_id" id="value_field_id">
+          <option></option>
+          [% FOREACH sel_field = Bugzilla.fields({ is_select => 1 }) %]
+            <option value="[% sel_field.id FILTER html %]">
+              [% sel_field.description FILTER html %]
+              ([% sel_field.name FILTER html %])
+            </option>
+          [% END %]
+        </select>
+      </td>
+    </tr>
+  </table>
+  <p>
+    <input type="hidden" name="action" value="new">
+    <input type="hidden" name="token" value="[% token FILTER html %]">
+    <input type="submit" id="create" value="Create">
+  </p>
+</form>
+
+<p>
+  <a href="editfields.cgi">Back to the list of existing custom fields</a>
+</p>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/custom_fields/edit.html.tmpl b/template/en/default/admin/custom_fields/edit.html.tmpl
new file mode 100644 (file)
index 0000000..a1d7393
--- /dev/null
+++ b/template/en/default/admin/custom_fields/edit.html.tmpl
@@ -0,0 +1,195 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # field: Bugzila::Field; the current field being edited
+  #%]
+
+[% PROCESS "global/field-descs.none.tmpl" %]
+
+[% title = BLOCK %]
+  Edit the Custom Field '[% field.name FILTER html %]' ([% field.description FILTER html %])
+[% END %]
+
+[% javascript = BLOCK %]
+  [% INCLUDE "admin/custom_fields/cf-js.js.tmpl" %]
+[% END %]
+
+[% PROCESS global/header.html.tmpl
+           title = title
+           onload = "toggleCheckbox(document.getElementById('enter_bug'), 'new_bugmail');"
+           javascript_urls = [ 'js/util.js' ]
+           doc_section = "custom-fields.html#edit-custom-fields"
+           style_urls = ['skins/standard/admin.css']
+%]
+
+<p>
+  Descriptions are a very short string describing the field and will be used as
+  the label for this field in the user interface.
+</p>
+
+<form id="edit_field" action="editfields.cgi" method="GET">
+  <table border="0" cellspacing="0" cellpadding="5" id="edit_custom_field">
+    <tr>
+      <th class="narrow_label">Name:</th>
+      <td>[% field.name FILTER html %]</td>
+
+      <th>
+        <label for="enter_bug">Can be set on [% terms.bug %] creation:</label>
+      </th>
+      <td><input type="checkbox" id="enter_bug" name="enter_bug" value="1"
+                 [%- " checked" IF field.enter_bug %]
+                 onchange="toggleCheckbox(this, 'new_bugmail');"></td>
+    </tr>
+    <tr>
+      <th class="narrow_label"><label for="desc">Description:</label></th>
+      <td><input type="text" id="desc" name="desc" size="40"
+                 value="[% field.description FILTER html %]"></td>
+
+      <th>
+        <label for="new_bugmail">Displayed in [% terms.bug %]mail for new [% terms.bugs %]:</label>
+      </th>
+      <td><input type="checkbox" id="new_bugmail" name="new_bugmail" value="1"
+                 [%- " checked" IF field.mailhead %]></td>
+    </tr>
+    <tr>
+      <th class="narrow_label">Type:</th>
+      <td>[% field_types.${field.type} FILTER html %]</td>
+
+      <th><label for="obsolete">Is obsolete:</label></th>
+      <td><input type="checkbox" id="obsolete" name="obsolete" value="1"
+                 [%- " checked" IF field.obsolete %]></td>
+    </tr>
+    <tr>
+      <th class="narrow_label"><label for="sortkey">Sortkey:</label></th>
+      <td>
+        <input type="text" id="sortkey" name="sortkey" size="6" maxlength="6"
+               value="[% field.sortkey FILTER html %]">
+      </td>
+      <th align="right"><label for="is_mandatory">Is mandatory:</label></th>
+      <td><input type="checkbox" id="is_mandatory" name="is_mandatory" value="1"
+                 [%- ' checked="checked"' IF field.is_mandatory %]></td>
+    </tr>
+    <tr>
+      <th class="narrow_label">Long Description:</th>
+      <td>
+        [% INCLUDE global/textarea.html.tmpl
+         name           = 'long_desc'
+         id             = 'long_desc'
+         minrows        = 3
+         maxrows        = 5
+         cols           = 46
+         defaultcontent = field.long_desc
+       %]
+      </td>
+      <th>
+        <label for="visibility_field_id">Field only appears when:</label>
+      </th>
+      <td>
+        <select name="visibility_field_id" id="visibility_field_id"
+                onchange="onChangeVisibilityField()">
+          <option></option>
+          [% FOREACH sel_field = Bugzilla.fields({ is_select => 1 }) %]
+            [% NEXT IF sel_field.id == field.id %]
+            <option value="[% sel_field.id FILTER html %]"
+             [% ' selected="selected"' 
+                IF sel_field.id == field.visibility_field.id %]>
+              [% sel_field.description FILTER html %]
+              ([% sel_field.name FILTER html %])
+            </option>
+          [% END %]
+        </select>
+        <label for="visibility_values">
+          <strong>is set to any of:</strong>
+        </label>
+        <select multiple="multiple" size="5" name="visibility_values" 
+                id="visibility_values" class="field_value">
+          [% FOREACH value = field.visibility_field.legal_values %]
+            <option value="[% value.id FILTER html %]"
+              [% " selected" IF field.visibility_values.contains(value) %]>
+              [% IF field.visibility_field.name == 'component' %]
+                [% display_value('product', value.product.name) FILTER html %]:
+              [% END %]
+              [%+ display_value(field.visibility_field.name, value.name) FILTER html %]
+            </option>
+          [% END %]   
+        </select>
+      </td>
+    </tr>
+    [% IF field.type == constants.FIELD_TYPE_BUG_ID %]
+      <tr>
+        <th class="narrow_label">
+          <label for="reverse_desc">Reverse Relationship Description:</label>
+        </th>
+        <td>
+          <input type="text" id="reverse_desc" name="reverse_desc" size="40"
+                 value="[% field.reverse_desc FILTER html %]">
+          <br/>
+          Use this label for the list of [% terms.bugs %] that link to
+          [%+ terms.abug %] with this 
+          [%+ field_types.${constants.FIELD_TYPE_BUG_ID} FILTER html %] field.
+          For example, if the description is "Is a duplicate of",
+          the reverse description would be "Duplicates of this [% terms.bug %]".
+          Leave blank to disable the list for this field.
+        </td>
+        <td colspan="2">&nbsp;</td>
+      </tr>
+    [% END %]
+    [% IF field.is_select %]
+      <tr>
+        <th>&nbsp;</th>
+        <td>
+          <a href="editvalues.cgi?field=[% field.name FILTER uri %]">Edit
+            legal values for this field</a>.
+        </td>
+
+        <th>
+          <label for="value_field_id">
+            Field that controls the values<br>
+            that appear in this field:
+          </label>
+        </th>
+
+        <td>
+          <select name="value_field_id" id="value_field_id">
+            <option></option>
+            [% FOREACH sel_field = Bugzilla.fields({ is_select => 1 }) %]
+              [% NEXT IF sel_field.id == field.id %]
+              <option value="[% sel_field.id FILTER html %]"
+               [% ' selected="selected"' 
+                  IF sel_field.id == field.value_field.id %]>
+                [% sel_field.description FILTER html %]
+                ([% sel_field.name FILTER html %])
+              </option>
+            [% END %]
+          </select>
+        </td>
+      </tr>
+    [% END %]
+  </table>
+  <br>
+  <input type="hidden" name="action" value="update">
+  <input type="hidden" name="name" value="[% field.name FILTER html %]">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+  <input type="submit" id="edit" value="Submit">
+</form>
+
+[% IF field.obsolete %]
+<p>
+  <a href="editfields.cgi?action=del&amp;name=[% field.name FILTER html %]">Remove
+    this custom field from the database.</a><br>
+  This action will only be successful if the custom field has never been used
+  in [% terms.abug %].<br>
+</p>
+[% END %]
+
+<p>
+  <a href="editfields.cgi">Back to the list of existing custom fields</a>
+</p>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/custom_fields/list.html.tmpl b/template/en/default/admin/custom_fields/list.html.tmpl
new file mode 100644 (file)
index 0000000..e6ec0c2
--- /dev/null
+++ b/template/en/default/admin/custom_fields/list.html.tmpl
@@ -0,0 +1,99 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # custom_fields: a list of Bugzilla::Field objects, representing custom fields.
+  #%]
+
+[% PROCESS "global/field-descs.none.tmpl" %]
+
+[% PROCESS global/header.html.tmpl
+  title = "Custom Fields"
+  doc_section = "custom-fields.html"
+%]
+
+[% delete_contentlink = BLOCK %]editfields.cgi?action=del&name=%%name%%[% END %]
+
+[% columns = [
+     {
+       name => "name"
+       heading => "Edit custom field..."
+       contentlink => "editfields.cgi?action=edit&name=%%name%%"
+     },
+     {
+       name => "description"
+       heading => "Description"
+     },
+     {
+       name => "sortkey"
+       heading => "Sortkey"
+     },
+     {
+       name => "type"
+       heading => "Type"
+     },
+     {
+       name => "enter_bug"
+       heading => "Editable on $terms.Bug Creation"
+     },
+     {
+       name => "mailhead"
+       heading => "In ${terms.Bug}mail on $terms.Bug Creation"
+     },
+     {
+       name => "obsolete"
+       heading => "Is Obsolete"
+     },
+     {
+       name => "is_mandatory"
+       heading => "Is Mandatory"
+     },
+     {
+       name => "action"
+       heading => "Action"
+       content => ""
+     }
+   ]
+%]
+
+[% USE Bugzilla %]
+[% custom_fields = Bugzilla.fields({ custom => 1 }) %]
+
+[%# We want to display the type name of fields, not their type ID. %]
+[% overrides.type = {} %]
+
+[% FOREACH field_type = field_types.keys %]
+  [% overrides.type.type.$field_type = {
+       override_content => 1
+       content => field_types.$field_type
+    }
+  %]
+[% END %]
+
+
+[% overrides.action.obsolete = {
+     "1" => {
+       override_content => 1
+       content => "Delete"
+       override_contentlink => 1
+       contentlink => delete_contentlink
+     }
+   }
+%] 
+
+[% PROCESS admin/table.html.tmpl
+     columns = columns
+     overrides = overrides
+     data = custom_fields
+%]
+
+<p>
+  <a href="editfields.cgi?action=add">Add a new custom field</a>
+</p>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/fieldvalues/confirm-delete.html.tmpl b/template/en/default/admin/fieldvalues/confirm-delete.html.tmpl
new file mode 100644 (file)
index 0000000..122df36
--- /dev/null
+++ b/template/en/default/admin/fieldvalues/confirm-delete.html.tmpl
@@ -0,0 +1,154 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # value: Bugzilla::Field::Choice; The field value being deleted.
+  # value_count: number; The number of values available for this field.
+  # field: object; the field the value is being deleted from.
+  #%]
+
+[% title = BLOCK %]
+  Delete Value '[% value.name FILTER html %]' from the 
+  '[% field.description FILTER html %]' ([% field.name FILTER html %]) field
+[% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+  style_urls = ['skins/standard/admin.css']
+%]
+
+<table border="1" cellpadding="4" cellspacing="0">
+<tr bgcolor="#6666FF">
+  <th valign="top" align="left">Field</th>
+  <th valign="top" align="left">Value</th>
+</tr>
+<tr>
+  <td valign="top">Field Name:</td>
+  <td valign="top">[% field.description FILTER html %]</td>
+</tr>
+<tr>
+  <td valign="top">Field Value:</td>
+  <td valign="top">[% value.name FILTER html %]</td>
+</tr>
+<tr>
+  <td valign="top">[% terms.Bugs %]:</td>
+  <td valign="top">
+[% IF value.bug_count %]
+  <a title="List of [% terms.bugs %] where '
+            [%- field.description FILTER html %]' is '
+            [%- value.name FILTER html %]'"
+     href="buglist.cgi?[% field.name FILTER uri %]=
+           [%- value.name FILTER uri %]">
+   [%- value.bug_count FILTER html %]</a>
+[% ELSE %]
+  None
+[% END %]
+  </td>
+</tr>
+</table>
+
+<h2>Confirmation</h2>
+
+[% IF value.is_default || value.bug_count || (value_count == 1)
+      || value.controls_visibility_of_fields.size
+      || value.controlled_values_array.size 
+%]
+
+  <p>Sorry, but the '[% value.name FILTER html %]' value cannot be deleted
+    from the '[% field.description FILTER html %]' field for the following 
+    reason(s):</p>
+
+  <ul class="warningmessages">
+    [% IF value.is_default %]
+      <li>'[% value.name FILTER html %]' is the default value for
+        the '[% field.description FILTER html %]' field.
+        [% IF user.in_group('tweakparams') %]
+          You first have to <a href="editparams.cgi?section=bugfields">change
+          the default value</a> for this field before you can delete
+          this value.
+        [% END %]
+      </li>
+    [% END %]
+
+    [% IF value.bug_count %]
+      <li>
+        [% IF value.bug_count > 1 %]
+          There are [% value.bug_count FILTER html %] [%+ terms.bugs %] 
+          with this field value.
+        [% ELSE %]
+          There is 1 [% terms.bug %] with this field value.
+        [% END %]
+        You must change the field value on
+          <a title="List of [% terms.bugs %] where '
+                    [%- field.description FILTER html %]' is '
+                    [%- value.name FILTER html %]'"
+             href="buglist.cgi?[% field.name FILTER uri %]=
+                   [%- value.name FILTER uri %]">
+            [% IF value.bug_count > 1 %]
+              those [% terms.bugs %] 
+            [% ELSE %]
+              that [% terms.bug %]
+            [% END %]
+          </a>
+          to another value before you can delete this value.
+      </li>
+    [% END %]
+
+    [% IF value_count == 1 %]
+      <li>'[% value.name FILTER html %]' is the last value for
+        '[%- field.description FILTER html %]', and so it cannot be deleted.
+      </li>
+    [% END %]
+
+    [% IF value.controls_visibility_of_fields.size %]
+      <li>This value controls the visibility of the following fields:<br>
+        [% FOREACH field = value.controls_visibility_of_fields %]
+          <a href="editfields.cgi?action=edit&name=
+                   [%- field.name FILTER uri %]">
+            [%- field.description FILTER html %] 
+            ([% field.name FILTER html %])</a><br>
+        [% END %]
+      </li>
+    [% END %]
+
+    [% IF value.controlled_values_array.size %]
+      <li>This value controls the visibility of the following values in
+        other fields:<br>
+       [% FOREACH field_name = value.controlled_values.keys %]
+         [% FOREACH controlled = value.controlled_values.${field_name} %]
+           <a href="editvalues.cgi?action=edit&field=
+                    [%- controlled.field.name FILTER uri %]&value=
+                    [%- controlled.name FILTER uri %]">
+             [% controlled.field.description FILTER html %]
+             ([% controlled.field.name FILTER html %]):
+             [%+ controlled.name FILTER html %]</a><br>
+         [% END %]
+       [% END %]
+      </li>
+    [% END %]
+  </ul>
+
+[% ELSE %]
+
+  <p>Do you really want to delete this value?</p>
+
+  <form method="post" action="editvalues.cgi">
+    <input type="submit" value="Yes, delete" id="delete">
+    <input type="hidden" name="action" value="delete">
+    <input type="hidden" name="field" value="[% field.name FILTER html %]">
+    <input type="hidden" name="value" value="[% value.name FILTER html %]">
+    <input type="hidden" name="token" value="[% token FILTER html %]">
+  </form>
+
+[% END %]
+
+[% PROCESS admin/fieldvalues/footer.html.tmpl
+  no_edit_link = 1
+ +%]
+
+[% PROCESS global/footer.html.tmpl %] 

diff --git a/template/en/default/admin/fieldvalues/create.html.tmpl b/template/en/default/admin/fieldvalues/create.html.tmpl
new file mode 100644 (file)
index 0000000..f9f0f7e
--- /dev/null
+++ b/template/en/default/admin/fieldvalues/create.html.tmpl
@@ -0,0 +1,92 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # field: object; the field the value is being created for
+  #%]
+  
+[% title = BLOCK %]
+  Add Value for the '[% field.description FILTER html %]' ([% field.name FILTER html %]) field
+[% END %]
+[% PROCESS global/header.html.tmpl
+  title = title
+%]
+
+<p>
+  This page allows you to add a new value for the 
+  '[% field.description FILTER html %]' field.
+</p>
+
+<form method="post" action="editvalues.cgi">
+  <table border="0" cellpadding="4" cellspacing="0">
+    <tr>
+      <th align="right"><label for="value">Value:</label></th>
+      <td>
+        <input id="value" name="value" size="30"
+               maxlength="[% constants.MAX_FIELD_VALUE_SIZE FILTER none %]">
+      </td>
+    </tr>
+    <tr>
+      <th align="right"><label for="sortkey">Sortkey:</label></th>
+      <td><input id="sortkey" name="sortkey" size="6" maxlength="6"></td>
+    </tr>
+    [% IF field.name == "bug_status" %]
+      <tr>
+        <th align="right"><label for="is_open">Status Type:</label></th>
+        <td>
+          <input type="radio" id="open_status" name="is_open" value="1" 
+                 checked="checked">
+          <label for="open_status">Open</label><br>
+          <input type="radio" id="closed_status" name="is_open" value="0">
+          <label for="closed_status">Closed (requires a Resolution)</label>
+        </td>
+      </tr>
+      <tr>
+        <th>&nbsp;</th>
+        <td>
+          Note: The open/close attribute can only be set now, when you create
+          the status. It cannot be edited later.
+        </td>
+      </tr>
+    [% END %]
+    [% IF field.value_field %]
+      <tr>
+        <th align="right">
+          <label for="visibility_value_id">Only appears when 
+           [%+ field.value_field.description FILTER html %] is set to:
+          </label>
+        </th>
+        <td>
+          <select name="visibility_value_id" id="visibility_value_id">
+            <option></option>
+            [% FOREACH field_value = field.value_field.legal_values %]
+              [% NEXT IF field_value.name == '' %]
+              <option value="[% field_value.id FILTER none %]">
+                [% IF field.value_field.name == 'component' %]
+                  [% field_value.product.name FILTER html %]:
+                [% END %]
+                [%- field_value.name FILTER html -%]
+              </option>
+            [% END %]
+          </select>
+          <small>(Leave unset to have this value always appear.)</small>
+        </td>
+      </tr>
+    [% END %]
+  </table>
+  <input type="submit" id="create" value="Add">
+  <input type="hidden" name="action" value="new">
+  <input type="hidden" name='field' value="[% field.name FILTER html %]">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+</form>
+
+[% PROCESS admin/fieldvalues/footer.html.tmpl
+    no_add_link = 1
+ %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/fieldvalues/edit.html.tmpl b/template/en/default/admin/fieldvalues/edit.html.tmpl
new file mode 100644 (file)
index 0000000..ab64185
--- /dev/null
+++ b/template/en/default/admin/fieldvalues/edit.html.tmpl
@@ -0,0 +1,105 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # value: Bugzilla::Field::Choice; The field value we are editing.
+  # field: Bugzilla::Field; The field this value belongs to.
+  #%]
+
+[% title = BLOCK %]
+  Edit Value '[% value.name FILTER html %]' for the 
+  '[% field.description FILTER html %]' ([% field.name FILTER html %]) field
+[% END %]
+[% PROCESS global/header.html.tmpl
+  title = title
+%]
+
+<form method="post" action="editvalues.cgi">
+  <table border="0" cellpadding="4" cellspacing="0">
+
+    <tr>
+      <th valign="top" align="right">
+        <label for="value_new">Field Value:</label>
+      </th>
+      <td>
+        [% IF value.is_static %]
+          <input type="hidden" name="value_new" id="value_new"
+                 value="[% value.name FILTER html %]">
+            [%- value.name FILTER html %]
+        [% ELSE %]
+          <input id="value_new" name="value_new" size="20"
+                 maxlength="[% constants.MAX_FIELD_VALUE_SIZE FILTER none %]"
+                 value="[% value.name FILTER html %]">
+        [% END %]
+      </td>
+    </tr>
+    <tr>
+      <th align="right"><label for="sortkey">Sortkey:</label></th>
+      <td><input id="sortkey" size="6" maxlength="6" name="sortkey" 
+                 value="[%- value.sortkey FILTER html %]"></td>
+    </tr>
+    [% IF field.name == "bug_status" %]
+      <tr>
+        <th align="right"><label for="is_open">Status Type:</label></th>
+        <td>[% IF value.is_open %]Open[% ELSE %]Closed[% END %]</td>
+      </tr>
+    [% END %]
+    [% IF field.value_field %]
+      <tr>
+        <th align="right">
+          <label for="visibility_value_id">Only appears when
+           [%+ field.value_field.description FILTER html %] is set to:
+          </label>
+        </th>
+        <td>
+          <select name="visibility_value_id" id="visibility_value_id">
+            <option></option>
+            [% FOREACH field_value = field.value_field.legal_values %]
+              [% NEXT IF field_value.name == '' %]
+              <option value="[% field_value.id FILTER none %]"
+               [% ' selected="selected"' 
+                  IF field_value.id == value.visibility_value.id %]>
+                [% IF field.value_field.name == 'component' %]
+                  [% field_value.product.name FILTER html %]:
+                [% END %]
+                [% field_value.name FILTER html -%]
+              </option>
+            [% END %]
+          </select>
+          <small>(Leave unset to have this value always appear.)</small>
+        </td>
+      </tr>
+    [% END %]
+    <tr>
+      <th align="right"><label for="is_active">Enabled for [% terms.bugs %]:</label></th>
+      <td><input id="is_active" name="is_active" type="checkbox" value="1" 
+           [%+ 'checked="checked"' IF value.is_active %]
+           [%+ 'disabled="disabled"' IF value.is_default OR value.is_static %]>
+           [% IF value.is_default %]
+             This value is selected as default in the parameters for this field. It cannot be disabled.
+           [% ELSIF value.is_static %]
+             This value is non-deletable and cannot be disabled.
+           [% END %]
+           [% IF !(value.is_default OR value.is_static) %]
+             <input id="defined_is_active" name="defined_is_active"
+                    type="hidden" value="1">
+           [% END %]
+      </td>
+    </tr>
+  </table>
+  <input type="hidden" name="value" value="[% value.name FILTER html %]">
+  <input type="hidden" name="action" value="update">
+  <input type="hidden" name="field" value="[% field.name FILTER html %]">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+  <input type="submit" id="update" value="Save Changes">
+</form>
+
+[% PROCESS admin/fieldvalues/footer.html.tmpl
+  no_edit_link = 1 %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/fieldvalues/footer.html.tmpl b/template/en/default/admin/fieldvalues/footer.html.tmpl
new file mode 100644 (file)
index 0000000..672e11b
--- /dev/null
+++ b/template/en/default/admin/fieldvalues/footer.html.tmpl
@@ -0,0 +1,48 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # value: string; the value being inserted/edited.
+  # field: object; the field which the value belongs/belonged to.
+  #
+  # no_XXX_link: boolean; if defined, then don't show the corresponding
+  #                       link. Supported parameters are:
+  #
+  # no_edit_link
+  # no_edit_other_link
+  # no_add_link
+  #%]
+
+<hr>
+
+<p>
+
+[% UNLESS no_add_link %]
+  <a title="Add a value for the '[% field.description FILTER html %]' field."
+     href="editvalues.cgi?action=add&amp;field=
+          [%- field.name FILTER uri %]">Add</a> a value.
+[% END %]
+
+[% IF value.defined && !no_edit_link %]
+  Edit value <a 
+  title="Edit value '[% value.name FILTER html %]' for the '
+         [%- field.name FILTER html %]' field"
+  href="editvalues.cgi?action=edit&amp;field=
+        [%- field.name FILTER uri %]&amp;value=
+        [%- value.name FILTER uri %]">
+        '[% value.name FILTER html %]'</a>.
+[% END %]
+
+[% UNLESS no_edit_other_link %]
+  Edit other values for the <a 
+  href="editvalues.cgi?field=
+        [%- field.name FILTER uri %]">'[% field.description FILTER html %]'</a> field.
+
+[% END %]
+
+</p>

diff --git a/template/en/default/admin/fieldvalues/list.html.tmpl b/template/en/default/admin/fieldvalues/list.html.tmpl
new file mode 100644 (file)
index 0000000..01c5717
--- /dev/null
+++ b/template/en/default/admin/fieldvalues/list.html.tmpl
@@ -0,0 +1,90 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # values: array of hashes having the following properties:
+  #   - name: string; The value.
+  #   - sortkey: number; The sortkey used to order the value when 
+  #              displayed to the user in a list.
+  #
+  # field: object; the field we are editing values for.
+  # static: array; list of values which cannot be renamed nor deleted.
+  #%]
+
+[% USE Bugzilla %]
+[% cgi = Bugzilla.cgi %]
+
+[% title = BLOCK %]Select value for the '[% field.description FILTER html %]'
+                   ([% field.name FILTER html %]) field[% END %]
+[% PROCESS global/header.html.tmpl
+  title = title
+%]
+
+[% edit_contentlink = BLOCK %]editvalues.cgi?action=edit&field=
+  [%- field.name FILTER uri %]&value=%%name%%[% END %]
+[% delete_contentlink = BLOCK %]editvalues.cgi?action=del&field=
+  [%- field.name FILTER uri %]&value=%%name%%[% END %]
+
+
+[% columns = [
+     { 
+       name => "name"
+       heading => "Edit field value..."
+       contentlink => edit_contentlink
+     },
+     { 
+       name => "sortkey"
+       heading => "Sortkey"
+     },
+     {
+       name => "isactive"
+       heading => "Enabled for $terms.bugs"
+       yesno_field => 1
+     },
+     {
+       name => "action"
+       heading => "Action"
+       content => "Delete"
+       contentlink => delete_contentlink
+     } ]
+%]
+
+
+[% SET overrides.action = {} %]
+[% FOREACH check_value = values %]
+  [% IF check_value.is_static %]
+    [% overrides.action.name.${check_value.name} = {
+         override_content => 1
+         content => "(Non-deletable value)"
+         override_contentlink => 1
+         contentlink => undef
+       }
+    %]
+  [% ELSIF check_value.is_default %]
+    [% overrides.action.name.${check_value.name} = {
+         override_content => 1
+         content => "(Default value)"
+         override_contentlink => 1
+         contentlink => undef
+       }
+    %]
+  [% END %]
+
+[% END %]
+
+[% PROCESS admin/table.html.tmpl
+     columns = columns
+     data = values
+     overrides = overrides
+%]
+
+[% PROCESS admin/fieldvalues/footer.html.tmpl
+  no_edit_other_link = 1
+ %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/fieldvalues/select-field.html.tmpl b/template/en/default/admin/fieldvalues/select-field.html.tmpl
new file mode 100644 (file)
index 0000000..099eeba
--- /dev/null
+++ b/template/en/default/admin/fieldvalues/select-field.html.tmpl
@@ -0,0 +1,37 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  #    fields: Array of hashes. Each hash contains only one key, "name."
+  #            The names are the same as the keys from field_descs 
+  #            (see global/field-descs.html.tmpl).
+  #%]
+
+[% USE Bugzilla %]
+[% cgi = Bugzilla.cgi %]
+
+[% PROCESS global/header.html.tmpl
+  title = "Edit values for which field?"
+%]
+
+[% columns = [
+     { 
+       name => "name"
+       heading => "Edit field values for..."
+       content_use_field = 1
+       contentlink => "editvalues.cgi?field=%%name%%"
+     }
+   ]
+%]
+
+[% PROCESS admin/table.html.tmpl
+     columns = columns
+     data = fields
+%]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/flag-type/confirm-delete.html.tmpl b/template/en/default/admin/flag-type/confirm-delete.html.tmpl
new file mode 100644 (file)
index 0000000..70f5efb
--- /dev/null
+++ b/template/en/default/admin/flag-type/confirm-delete.html.tmpl
@@ -0,0 +1,49 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% title = BLOCK %]Confirm Deletion of Flag Type '[% flag_type.name FILTER html %]'[% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+  doc_section = "flags-overview.html#flags-delete"
+%]
+
+<p>
+  [% IF flag_type.flag_count %]
+    There are [% flag_type.flag_count %] flags of type [% flag_type.name FILTER html %].
+    If you delete this type, those flags will also be deleted.
+  [% END %]
+
+  Note that instead of deleting the type you can
+   <a href="editflagtypes.cgi?action=deactivate&amp;id=[% flag_type.id %]&amp;token=
+           [%- token FILTER html %]">deactivate it</a>,
+   in which case the type [% IF flag_type.flag_count %] and its flags [% END %] will remain
+   in the database but will not appear in the [% terms.Bugzilla %] UI.
+</p>
+
+<table>
+   <tr>
+      <td colspan="2">
+         Do you really want to delete this type?
+      </td>
+   </tr>
+   <tr>
+      <td>
+         <a href="editflagtypes.cgi?action=delete&amp;id=[% flag_type.id %]&amp;token=
+                 [%- token FILTER html %]">Yes, delete
+         </a>
+      </td>
+      <td align="right">
+         <a href="editflagtypes.cgi">
+            No, don't delete
+         </a>
+      </td>
+   </tr>
+</table>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/flag-type/edit.html.tmpl b/template/en/default/admin/flag-type/edit.html.tmpl
new file mode 100644 (file)
index 0000000..b8de6c7
--- /dev/null
+++ b/template/en/default/admin/flag-type/edit.html.tmpl
@@ -0,0 +1,265 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS "global/js-products.html.tmpl" %]
+
+[% IF action == "insert" %]
+  [% title = BLOCK %]
+    Create Flag Type for [% type.target_type == "bug" ? terms.Bugs : "Attachments" %]
+    [% IF type.id %]
+      Based on [% type.name FILTER html %]
+    [% END %]
+  [% END %]
+  [% doc_section = "flags-overview.html#flags-create" %]
+[% ELSE %]
+  [% title = BLOCK %]Edit Flag Type [% type.name FILTER html %][% END %]
+  [% doc_section = "flags-overview.html#flags-edit" %]
+[% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+  style = "
+    table#form th { text-align: right; vertical-align: baseline; white-space: nowrap; }
+    table#form td { text-align: left; vertical-align: baseline; }
+  "
+  onload="var f = document.forms['flagtype_properties'];
+          selectProduct(f.product, f.component, null, null, '__Any__');"
+  javascript_urls=["js/productform.js"]
+  doc_section = doc_section
+%]
+
+<form id="flagtype_properties" method="post" action="editflagtypes.cgi">
+  <input type="hidden" name="action" value="[% action FILTER html %]">
+  <input type="hidden" name="can_fully_edit" value="[% can_fully_edit FILTER html %]">
+  <input type="hidden" name="id" value="[% type.id %]">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+  <input type="hidden" name="target_type" value="[% type.target_type FILTER html %]">
+  <input type="hidden" name="check_clusions" value="[% check_clusions FILTER none %]">
+  [% FOREACH category = inclusions.values %]
+    <input type="hidden" name="inclusions" value="[% category FILTER html %]">
+  [% END %]
+  [% FOREACH category = exclusions.values %]
+    <input type="hidden" name="exclusions" value="[% category FILTER html %]">
+  [% END %]
+
+  [%# Add a hidden button at the top of the form so that the user pressing "return"
+    # really submit the form, as expected. %]
+  <input type="submit" id="commit" value="Submit" style="display: none;">
+
+  <table id="form" cellspacing="0" cellpadding="4" border="0">
+    <tr>
+      <th>Name:</th>
+      <td>
+        a short name identifying this type.<br>
+        <input type="text" name="name" value="[% type.name FILTER html %]" size="50"
+               maxlength="50" [%- ' disabled="disabled"' UNLESS can_fully_edit %]>
+      </td>
+    </tr>
+
+    <tr>
+      <th>Description:</th>
+      <td>
+        a comprehensive description of this type.<br>
+        [% INCLUDE global/textarea.html.tmpl
+          name           = 'description'
+          minrows        = 4
+          cols           = 80
+          defaultcontent = type.description
+          disabled       = !can_fully_edit
+        %]
+      </td>
+    </tr>
+
+    <tr>
+      <th>Category:</th>
+
+      <td>
+        the products/components to which [% type.target_type == "bug" ? terms.bugs : "attachments" %]
+        must (inclusions) or must not (exclusions) belong in order for users
+        to be able to set flags of this type for them.
+        [% UNLESS can_fully_edit %]
+          <p class="warning">This flagtype also applies to some products you are not allowed
+          to edit (and so which are not displayed in the lists below). Your limited privileges
+          means you are only allowed to add and remove this flagtype to/from products you can
+          edit, but not to edit other properties of the flagtype.</p>
+        [% END %]
+        <table>
+          <tr>
+            <td style="vertical-align: top;">
+              <b>Product/Component:</b><br>
+              <select name="product" onchange="selectProduct(this, this.form.component, null, null, '__Any__');">
+                <option value="">__Any__</option>
+                [% FOREACH prod = products %]
+                  <option value="[% prod.name FILTER html %]">[% prod.name FILTER html %]</option>
+                [% END %]
+              </select><br>
+              <select name="component">
+                <option value="">__Any__</option>
+                [% FOREACH comp = components %]
+                  <option value="[% comp FILTER html %]">[% comp FILTER html %]</option>
+                [% END %]
+              </select><br>
+              <input type="submit" id="categoryAction-include" 
+                                   name="categoryAction-include" value="Include">
+              <input type="submit" id="categoryAction-exclude"
+                                   name="categoryAction-exclude" value="Exclude">
+            </td>
+            <td style="vertical-align: top;">
+              <b>Inclusions:</b><br>
+              [% PROCESS category_select name="inclusion_to_remove" categories = inclusions %]<br>
+              <input type="submit" id="categoryAction-removeInclusion" 
+                     name="categoryAction-removeInclusion" value="Remove Inclusion">
+            </td>
+            <td style="vertical-align: top;">
+              <b>Exclusions:</b><br>
+              [% PROCESS category_select name="exclusion_to_remove" categories = exclusions %]<br>
+              <input type="submit" id="categoryAction-removeExclusion" 
+                     name="categoryAction-removeExclusion" value="Remove Exclusion">
+            </td>
+          </tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr>
+      <th>Sort Key:</th>
+      <td>
+        a number between 1 and [% constants.MAX_SMALLINT FILTER none %] by which
+        this type will be sorted when displayed to users in a list; ignore if you
+        don't care what order the types appear in or if you want them to appear
+        in alphabetical order.<br>
+        <input type="text" name="sortkey" value="[% type.sortkey || 1 %]" size="5" maxlength="5"
+               [%- ' disabled="disabled"' UNLESS can_fully_edit %]>
+      </td>
+    </tr>
+
+    <tr>
+      <th>&nbsp;</th>
+      <td>
+        <input type="checkbox" id="is_active" name="is_active"
+               [%- ' disabled="disabled"' UNLESS can_fully_edit %]
+               [% " checked" IF type.is_active || !type.is_active.defined %]>
+        <label for="is_active">active (flags of this type appear in the UI and can be set)</label>
+      </td>
+    </tr>
+
+    <tr>
+      <th>&nbsp;</th>
+      <td>
+        <input type="checkbox" id="is_requestable" name="is_requestable"
+               [%- ' disabled="disabled"' UNLESS can_fully_edit %]
+               [% " checked" IF type.is_requestable || !type.is_requestable.defined %]>
+        <label for="is_requestable">requestable (users can ask for flags of this type to be set)</label>
+      </td>
+    </tr>
+
+    <tr>
+      <th>CC List:</th>
+      <td>
+        if requestable, who should get carbon copied on email notification of requests.
+        This is a comma-separated list of full e-mail addresses which do not
+        need to be [% terms.Bugzilla %] logins.
+        [% IF Param('emailsuffix') %]
+          Note that the configured emailsuffix
+          <kbd>[% Param('emailsuffix') %]</kbd> will <em>not</em> be appended
+          to these addresses, so you should add it explicitly if so desired.
+        [% END %]<br>
+        <input type="text" name="cc_list" value="[% type.cc_list FILTER html %]" size="80"
+               maxlength="200" [%- ' disabled="disabled"' UNLESS can_fully_edit %]>
+      </td>
+    </tr>
+
+    <tr>
+      <th>&nbsp;</th>
+      <td>
+        <input type="checkbox" id="is_requesteeble" name="is_requesteeble"
+               [%- ' disabled="disabled"' UNLESS can_fully_edit %]
+               [% " checked" IF type.is_requesteeble || !type.is_requesteeble.defined %]>
+        <label for="is_requesteeble">specifically requestable (users can ask specific other users
+          to set flags of this type as opposed to just asking the wind)</label>
+      </td>
+    </tr>
+
+    <tr>
+      <th>&nbsp;</th>
+      <td>
+        <input type="checkbox" id="is_multiplicable" name="is_multiplicable"
+               [%- ' disabled="disabled"' UNLESS can_fully_edit %]
+               [% " checked" IF type.is_multiplicable || !type.is_multiplicable.defined %]>
+        <label for="is_multiplicable">multiplicable (multiple flags of this type can be set on
+          the same [% type.target_type == "bug" ? terms.bug : "attachment" %])</label>
+      </td>
+    </tr>
+
+    <tr>
+      <th>Grant Group:</th>
+      <td>
+        the group allowed to grant/deny flags of this type
+        (to allow all users to grant/deny these flags, select no group).<br>
+        [% PROCESS group_select selname = "grant_group" %]
+      </td>
+    </tr>
+
+    <tr>
+      <th>Request Group:</th>
+      <td>
+        if flags of this type are requestable, the group allowed to request them
+        (to allow all users to request these flags, select no group).<br>
+        Note that the request group alone has no effect if the grant group is not defined!<br>
+        [% PROCESS group_select selname = "request_group" %]
+      </td>
+    </tr>
+
+    <tr>
+      <th>&nbsp;</th>
+      <td>
+        <input type="submit" id="save" value="[% action == "insert" ? "Create" : "Save Changes" %]">
+      </td>
+    </tr>
+
+  </table>
+
+</form>
+
+[% PROCESS global/footer.html.tmpl %]
+
+
+[%############################################################################%]
+[%# Block for SELECT fields                                                  #%]
+[%############################################################################%]
+
+[% BLOCK group_select %]
+  <select name="[% selname %]" id="[% selname %]" [%- ' disabled="disabled"' UNLESS can_fully_edit %]>
+    <option value="">(no group)</option>
+    [% group_found = 0 %]
+    [% FOREACH group = groups %]
+      <option value="[% group.name FILTER html %]"
+        [% IF type.${selname} && type.${selname}.name == group.name %]
+          [% ' selected="selected"' %]
+          [% group_found = 1 %]
+        [% END %]>
+        [%- group.name FILTER html ~%]
+      </option>
+    [% END %]
+    [% IF !group_found && type.${selname}.name %]
+      <option value="[% type.${selname}.name FILTER html %]" selected="selected">
+        [%- type.${selname}.name FILTER html ~%]
+      </option>
+    [% END %]
+  </select>
+[% END %]
+
+[% BLOCK category_select %]
+  <select name="[% name FILTER html %]" multiple="multiple" size="7">
+    [% FOREACH option = categories.keys.sort %]
+      <option value="[% categories.$option FILTER html %]">
+        [% option FILTER html %]
+      </option>
+    [% END %]
+  </select>
+[% END %]

diff --git a/template/en/default/admin/flag-type/list.html.tmpl b/template/en/default/admin/flag-type/list.html.tmpl
new file mode 100644 (file)
index 0000000..7a02938
--- /dev/null
+++ b/template/en/default/admin/flag-type/list.html.tmpl
@@ -0,0 +1,159 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS "global/js-products.html.tmpl" %]
+
+[% PROCESS global/header.html.tmpl
+  title = 'Administer Flag Types'
+  style = "
+    table#flag_types_bugs tr th,
+    table#flag_types_attachments tr th { text-align: left; }
+    .inactive { color: #787878; }
+    .multiplicable { display: block; }
+  "
+  onload="var f = document.flagtype_form; selectProduct(f.product, f.component, null, null, '__All__');"
+  javascript_urls=["js/productform.js"]
+  doc_section = "flags-overview.html#flag-types"
+%]
+
+<p>
+  Flags are markers that identify whether [% terms.abug %] or attachment has been granted
+  or denied some status.  Flags appear in the UI as a name and a status symbol
+  ("+" for granted, "-" for denied, and "?" for statuses requested by users).
+</p>
+
+<p>
+  For example, you might define a "review" status for users to request review
+  for their patches.  When a patch writer requests review, the string "review?"
+  will appear in the attachment.  When a patch reviewer reviews the patch,
+  either the string "review+" or the string "review-" will appear in the patch,
+  depending on whether the patch passed or failed review.
+</p>
+
+<p>
+  You can restrict the list of flag types to those available for a given product
+  and component. If a product is selected with no component, only flag types
+  which are available to at least one component of the product are shown.
+</p>
+
+<form id="flagtype_form" name="flagtype_form" action="editflagtypes.cgi" method="get">
+  <table>
+    <tr>
+      <th><label for="product">Product:</label></th>
+      <td>
+        <select name="product" onchange="selectProduct(this, this.form.component, null, null, '__Any__');">
+          <option value="">__Any__</option>
+          [% FOREACH prod = products %]
+            <option value="[% prod.name FILTER html %]"
+                    [% " selected" IF selected_product == prod.name %]>
+                    [% prod.name FILTER html %]</option>
+          [% END %]
+        </select>
+      </td>
+      <th><label for="component">Component:</label></th>
+      <td>
+        <select name="component">
+          <option value="">__Any__</option>
+          [% FOREACH comp = components %]
+            <option value="[% comp FILTER html %]"
+                    [% " selected" IF selected_component == comp %]>
+                    [% comp FILTER html %]</option>
+          [% END %]
+        </select>
+      </td>
+      <td>
+        <input type="checkbox" id="show_flag_counts" name="show_flag_counts" value="1"
+               [%+ 'checked="checked"' IF show_flag_counts %]>
+        <label for="show_flag_counts">Show flag counts</label>
+      </td>
+      <td><input type="submit" id="submit" value="Filter"></td>
+    </tr>
+  </table>
+</form>
+
+<h3>Flag Types for [% terms.Bugs %]</h3>
+
+[% PROCESS display_flag_types types=bug_types types_id='bugs' %]
+
+<p>
+  <a href="editflagtypes.cgi?action=enter&amp;target_type=bug">Create Flag Type for [% terms.Bugs %]</a>
+</p>
+
+<h3>Flag Types for Attachments</h3>
+
+[% PROCESS display_flag_types types=attachment_types types_id='attachments' %]
+
+<p>
+  <a href="editflagtypes.cgi?action=enter&amp;target_type=attachment">Create Flag Type For Attachments</a>
+</p>
+
+[% PROCESS global/footer.html.tmpl %]
+
+
+[% BLOCK display_flag_types %]
+  <table id="flag_types_[% types_id FILTER html %]" cellspacing="0" cellpadding="4" border="1">
+
+    <tr>
+      <th>Edit name ...</th>
+      <th>Description</th>
+      <th>Sortkey</th>
+      <th>Properties</th>
+      <th>Grant group</th>
+      <th>Request group</th>
+      [% IF show_flag_counts %]
+        <th>Flags</th>
+        [%# Note to translators: translate the strings in quotes only. %]
+        [% state_desc = {granted = 'granted' denied = 'denied' pending = 'pending'} %]
+      [% END %]
+      <th>Actions</th>
+    </tr>
+
+    [% FOREACH type = types %]
+
+      <tr class="[% IF type.is_active %]active[% ELSE %]inactive[% END %]">
+        <td><a href="editflagtypes.cgi?action=edit&amp;id=[% type.id %]">[% type.name FILTER html FILTER no_break %]</a></td>
+        <td>[% type.description FILTER html %]</td>
+        <td align="right">[% type.sortkey FILTER html %]</td>
+        <td>
+          [% IF type.is_requestable %]
+            <span class="requestable">requestable</span>
+          [% END %]
+          [% IF type.is_requestable && type.is_requesteeble %]
+            <span class="requesteeble">(specifically)</span>
+          [% END %]
+          [% IF type.is_multiplicable %]
+            <span class="multiplicable">multiplicable</span>
+          [% END %]
+        </td>
+        <td>[% IF type.grant_group %][% type.grant_group.name FILTER html %][% END %]</td>
+        <td>[% IF type.request_group %][% type.request_group.name FILTER html %][% END %]</td>
+        [% IF show_flag_counts %]
+          <td>
+            [% FOREACH state = ['granted', 'pending', 'denied'] %]
+              [% bug_list = bug_lists.${type.id}.$state || [] %]
+              [% IF bug_list.size %]
+                <a href="buglist.cgi?bug_id=[% bug_list.unique.nsort.join(",") FILTER html %]">
+                  [% bug_list.size FILTER html %] [%+ state_desc.$state FILTER html %]
+                </a>
+                <br>
+              [% ELSE %]
+                0 [% state_desc.$state FILTER html %]<br>
+              [% END %]
+            [% END %]
+          </td>
+        [% END %]
+        <td>
+          <a href="editflagtypes.cgi?action=copy&amp;id=[% type.id %]">Copy</a>
+          | <a href="editflagtypes.cgi?action=confirmdelete&amp;id=[% type.id %]">Delete</a>
+        </td>
+      </tr>
+
+    [% END %]
+
+  </table>
+[% END %]

diff --git a/template/en/default/admin/groups/confirm-remove.html.tmpl b/template/en/default/admin/groups/confirm-remove.html.tmpl
new file mode 100644 (file)
index 0000000..a9aa7e1
--- /dev/null
+++ b/template/en/default/admin/groups/confirm-remove.html.tmpl
@@ -0,0 +1,50 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # group: The Bugzilla::Group being changed.
+  # regexp: the regexp according to which the update is performed.
+  #%]
+
+[% IF regexp %]
+  [% title = "Confirm: Remove Explicit Members in the Regular Expression?" %]
+[% ELSE %]
+  [% title = "Confirm: Remove All Explicit Members?" %]
+[% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+  doc_section = "groups.html"
+%]
+
+[% IF regexp %]
+  <p>This option will remove all users from '[% group.name FILTER html %]'
+    whose login names match the regular expression:
+    '[% regexp FILTER html %]'</p>
+[% ELSE %]
+  <p>This option will remove all explicitly defined users
+    from '[% group.name FILTER html %].'</p>
+[% END %]
+  
+<p>Generally, you will only need to do this when upgrading groups
+  created with [% terms.Bugzilla %] versions 2.16 and earlier. Use
+  this option with <b>extreme care</b> and consult the documentation
+  for further information.
+</p>
+    
+<form method="post" action="editgroups.cgi">
+  <input type="hidden" name="group_id" value="[% group.id FILTER html %]">
+  <input type="hidden" name="regexp" value="[% regexp FILTER html %]">
+  <input type="hidden" name="action" value="remove_regexp">
+  
+  <input name="token" type="hidden" value="[% token FILTER html %]">
+  <input id="confirm" name="confirm" type="submit" value="Confirm">
+  <p>Or <a href="editgroups.cgi">return to the Edit Groups page</a>.</p>
+</form>
+    
+[% PROCESS global/footer.html.tmpl %] 

diff --git a/template/en/default/admin/groups/create.html.tmpl b/template/en/default/admin/groups/create.html.tmpl
new file mode 100644 (file)
index 0000000..db65629
--- /dev/null
+++ b/template/en/default/admin/groups/create.html.tmpl
@@ -0,0 +1,94 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # none
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = "Add group"
+  subheader = "This page allows you to define a new user group."
+  doc_section = "groups.html#create-groups"
+%]
+
+<form method="post" action="editgroups.cgi">
+  <table border="1" cellpadding="4" cellspacing="0"><tr>
+    <th>New Name</th>
+    <th>New Description</th>
+    <th>New User RegExp</th>
+    <th>Use For [% terms.Bugs %]</th>
+  </tr><tr>
+    <td><input size="20" name="name"></td>
+    <td><input size="40" name="desc"></td>
+    <td><input size="30" name="regexp"></td>
+    <td><input type="checkbox" name="isactive" value="1" checked></td>
+  </tr>
+  <tr>
+    <th>Icon URL:</th>
+    <td colspan="3"><input type="text" size="70" maxlength="255" id="icon_url" name="icon_url"></td>
+  </tr>
+  [% Hook.process('field') %]
+  </table>
+
+  <hr>
+
+  <input type="checkbox" id="insertnew" name="insertnew" value="1"
+    [% IF Param("makeproductgroups") %] checked[% END %]>
+  <label for="insertnew">Insert new group into all existing products.</label>
+  <p>
+  <input type="submit" id="create" value="Add">
+  <input type="hidden" name="action" value="new">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+</form>
+
+<p><b>Name</b> is what is used with the B<!-- blah -->ugzilla->user->in_group()
+function in any customized cgi files you write that use a given group.
+It can also be used by people submitting [% terms.bugs %] by email to
+limit [% terms.abug %] to a certain set of groups.</p>
+
+<p><b>Description</b> is what will be shown in the [% terms.bug %] reports
+to members of the group where they can choose whether
+the [% terms.bug %] will be restricted to others in the same group.</p>
+
+<p>The <b>Use For [% terms.Bugs %]</b> flag determines whether or not the
+group is eligible to be used for [% terms.bugs %]. If you clear this, it will
+no longer be possible for users to add [% terms.bugs %] to this group,
+although [% terms.bugs %] already in the group will remain in the group.
+Doing so is a much less drastic way to stop a group from growing
+than deleting the group would be. <b>Note: If you are creating
+a group, you probably want it to be usable for [% terms.bugs %], in which
+case you should leave this checked.</b></p>
+
+<p><b>User RegExp</b> is optional, and if filled in, will 
+automatically grant membership to this group to anyone with an 
+email address that matches this regular expression.</p>
+
+<p>
+  <b>Icon URL</b> is optional, and is the URL pointing to the icon
+  used to identify the group. It may be either a relative URL to the base URL
+  of this installation or an absolute URL. This icon will be displayed
+  in comments in [% terms.bugs %] besides the name of the author of comments.
+</p>
+
+[% IF Param("makeproductgroups") %]
+  <p>By default, the new group will be associated with existing products.
+  Unchecking the "Insert new group into all existing products" option will
+  prevent this and make the group become visible only when its controls have
+  been added to a product.</p>
+[% ELSE %]
+  <p>Checking the "Insert new group into all existing products" option will
+  make the new group be associated with existing products. Leaving it unchecked
+  will make the group become visible only when its controls have been added to
+  a product.</p>
+[% END %]
+
+<p>Back to the <a href="./">main [% terms.bugs %] page</a>
+
+or to the <a href="editgroups.cgi">group list</a>.
+
+[% PROCESS global/footer.html.tmpl %] 

diff --git a/template/en/default/admin/groups/delete.html.tmpl b/template/en/default/admin/groups/delete.html.tmpl
new file mode 100644 (file)
index 0000000..562b4cb
--- /dev/null
+++ b/template/en/default/admin/groups/delete.html.tmpl
@@ -0,0 +1,171 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # group: A Bugzilla::Group object representing the group that is
+  #        about to be deleted.
+  # shared_queries: int; The number of queries being shared with this
+  #                 group.
+  #%]
+
+
+[% PROCESS global/header.html.tmpl
+  title = "Delete group"
+  doc_section = "groups.html"
+%]
+
+<table border="1">
+  <tr>
+    <th>Id</th>
+    <th>Name</th>
+    <th>Description</th>
+  </tr>
+  <tr>
+    <td>[% group.id FILTER html %]</td>
+    <td>[% group.name FILTER html %]</td>
+    <td>[% group.description FILTER html_light %]</td>
+  </tr>
+</table>
+
+<form method="post" action="editgroups.cgi">
+  [% IF group.members_non_inherited.size %]
+    <p><b>[% group.members_non_inherited.size FILTER html %] users belong
+      directly to this group. You cannot delete this group while there are
+      users in it.</b>
+
+    <br><a href="editusers.cgi?action=list&amp;groupid=
+                 [%- group.id FILTER uri %]&amp;grouprestrict=1">Show
+    me which users</a> - <label><input type="checkbox" name="removeusers">Remove
+    all users from this group for me.</label></p>
+  [% END %]
+
+  [% IF group.granted_by_direct(constants.GROUP_MEMBERSHIP).size %]
+    <p><b>Members of this group inherit membership in the following groups:</b></p>
+    <ul>
+      [% FOREACH grantor = group.granted_by_direct(constants.GROUP_MEMBERSHIP) %]
+        <li>[% grantor.name FILTER html %]</li>
+      [% END %]
+    </ul>
+  [% END %]
+
+  [% IF group.bugs.size %]
+    <p><b>[% group.bugs.size FILTER html %] [%+ terms.bug %] reports are
+     visible only to this group. You cannot delete this group while any 
+     [%+ terms.bugs %] are using it.</b>
+
+    <br><a href="buglist.cgi?field0-0-0=bug_group&amp;type0-0-0=equals&amp;value0-0-0=
+                 [%- group.name FILTER uri %]">Show me
+    which [% terms.bugs %]</a> - 
+    <label><input type="checkbox" name="removebugs">Remove
+    all [% terms.bugs %] from this group restriction for me.</label></p>
+
+    <p><b>NOTE:</b> It's quite possible to make confidential [% terms.bugs %]
+    public by checking this box.  It is <B>strongly</B> suggested
+    that you review the [% terms.bugs %] in this group before checking
+    the box.</p>
+  [% END %]
+
+  [% IF group.products.size %]
+    <p><b>This group is tied to the following products:</b></p>
+    [% SET any_hidden = 0 %]
+    <ul>
+      [% FOREACH data = group.products %]
+
+        [% SET active = [] %]
+        [% FOREACH control = data.controls.keys.sort %]
+          [% NEXT IF !data.controls.$control %]
+          [% IF control == 'othercontrol' OR control == 'membercontrol' %]
+            [% SWITCH data.controls.$control %]
+              [% CASE constants.CONTROLMAPMANDATORY %]
+                [% SET type = "Mandatory" %]
+              [% CASE constants.CONTROLMAPSHOWN %]
+                [% SET type = "Shown" %]
+              [% CASE constants.CONTROLMAPDEFAULT %]
+                [% SET type = "Default" %]
+            [% END %]
+            [% active.push("$control: $type") %]
+          [% ELSE %]
+            [% active.push(control) %]
+          [% END %]
+        [% END %]
+
+        [% SET hidden = 0 %]
+        [% IF data.controls.othercontrol == constants.CONTROLMAPMANDATORY
+              AND data.controls.membercontrol == constants.CONTROLMAPMANDATORY
+              AND data.controls.entry 
+        %]
+          [% SET hidden = 1 %]
+        [% END %]
+
+        <li><a href="editproducts.cgi?action=editgroupcontrols&amp;product=
+                    [%- data.product.name FILTER uri %]">
+          [%- data.product.name FILTER html %]</a>
+          ([% active.join(', ') FILTER html %])
+          [% IF hidden %]
+            <strong>WARNING: This product is currently hidden.
+            Deleting this group will make this product publicly visible.
+            </strong>
+          [% END %]</li>
+      [% END %]
+    </ul>
+
+    <p><label><input type="checkbox" name="unbind">Delete this group anyway,
+      and remove these controls.</label></p>
+  [% END %]
+  
+  [% IF group.flag_types.size %]
+    <p><b>This group restricts who can make changes to flags of certain types.
+    You cannot delete this group while there are flag types using it.</b>
+
+    <br><a href="editflagtypes.cgi?action=list&amp;group=
+                 [%- group.id FILTER uri %]">Show
+    me which types</a> - 
+    <label><input type="checkbox" name="removeflags">Remove all
+    flag types from this group for me.</label></p>
+  [% END %]
+
+  [% IF shared_queries %]
+    <p>
+      <b>There
+      [% IF shared_queries > 1 %]
+        are [% shared_queries %] saved searches
+      [% ELSE %]
+        is a saved search
+      [% END %]
+      being shared with this group.</b>
+      If you delete this group,
+      [% IF shared_queries > 1 %]
+        these saved searches
+      [% ELSE %]
+        this saved search
+      [% END %]
+      will fall back to being private again.
+    </p>
+  [% END %]
+
+  <h2>Confirmation</h2>
+
+  <p>Do you really want to delete this group?</p>
+  [% IF group.users.size || group.bugs.size || group.products.size 
+        || group.flags.size
+  %]
+    <p><b>You must check all of the above boxes or correct the
+          indicated problems first before you can proceed.</b></p>
+  [% END %]
+
+  <p>
+    <input type="submit" id="delete" value="Yes, delete">
+    <input type="hidden" name="action" value="delete">
+    <input type="hidden" name="group" value="[% group.id FILTER html %]">
+    <input type="hidden" name="token" value="[% token FILTER html %]">
+  </p>
+</form>
+
+Go back to the <a href="editgroups.cgi">group list</a>.
+
+[% PROCESS global/footer.html.tmpl %] 

diff --git a/template/en/default/admin/groups/edit.html.tmpl b/template/en/default/admin/groups/edit.html.tmpl
new file mode 100644 (file)
index 0000000..2f4101a
--- /dev/null
+++ b/template/en/default/admin/groups/edit.html.tmpl
@@ -0,0 +1,233 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # group - A Bugzilla::Group representing the group being edited.
+  # *_current - Arrays of Bugzilla::Group objects that show the current
+  #             values for this group, as far as grants.
+  # *_available - Arrays of Bugzilla::Group objects that show the current 
+  #               available values for each grant.
+  #%]
+
+[% title = BLOCK %]Change Group: [% group.name FILTER html %][% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+  doc_section = "groups.html#edit-groups"
+  style = "
+    .grant_table { border-collapse: collapse; }
+    .grant_table td, .grant_table th {
+        padding-left: .5em;
+    }
+    .grant_table td.one, .grant_table th.one {
+        border-right: 1px solid black;
+        padding-right: .5em;
+    }
+  "
+%]
+
+<form method="post" action="editgroups.cgi">
+  <input type="hidden" name="action" value="postchanges">
+  <input type="hidden" name="group_id" value="[% group.id FILTER html %]">
+
+  <table border="1" cellpadding="4">
+    <tr>
+      <th>Group:</th>
+      <td>
+        [% IF group.is_bug_group %]
+          <input type="text" name="name" size="60" 
+                 value="[% group.name FILTER html %]">
+        [% ELSE %]
+          [% group.name FILTER html %]
+        [% END %]
+      </td>
+    </tr>
+
+    <tr>
+      <th>Description:</th>
+      <td>
+        [% IF group.is_bug_group %]
+          <input type="text" name="desc" size="70" 
+                 value="[% group.description FILTER html %]">
+        [% ELSE %]
+          [% group.description FILTER html %]
+        [% END %]
+      </td>
+    </tr>
+
+    <tr>
+      <th>User Regexp:</th>
+      <td>
+        <input type="text" name="regexp" size="40" 
+               value="[% group.user_regexp FILTER html %]">
+      </td>
+    </tr>
+
+    <tr>
+      <th>
+        Icon URL:
+        [% IF group.icon_url %]
+          <img src="[% group.icon_url FILTER html %]" alt="[% group.name FILTER html %]">
+        [% END %]
+      </th>
+      <td>
+        <input type="text" name="icon_url" size="70" maxlength="255"
+               value="[% group.icon_url FILTER html %]">
+      </td>
+    </tr>
+
+    [% IF group.is_bug_group %]
+      <tr>
+        <th>Use For [% terms.Bugs %]:</th>
+        <td>
+          <input type="checkbox" name="isactive" 
+                 value="1" [% 'checked="checked"' IF group.is_active %]>
+        </td>
+      </tr>
+    [% END %]
+    [% Hook.process('field') %]
+  </table>
+
+  <h4>Group Permissions</h4>
+
+  <table class="grant_table">
+    <tr>
+      <th class="one">Groups That Are a Member of This Group<br>
+        (&quot;Users in <var>X</var> are automatically in  
+         [%+ group.name FILTER html %]&quot;)</th>
+      <th>Groups That This Group Is a Member Of<br>
+        (&quot;If you are in [% group.name FILTER html %], you are 
+         automatically also in...&quot;)</th>
+    </tr>
+    <tr>
+      <td class="one">
+        [% PROCESS select_pair name = "members" size = 10
+                   items_available = members_available
+                     items_current = members_current %]
+      </td>
+  
+      <td>[% PROCESS select_pair name = "member_of" size = 10
+                     items_available = member_of_available
+                       items_current = member_of_current %]</td>
+    </tr>
+  </table>
+
+  <table class="grant_table">
+    <tr>
+      <th class="one">
+        Groups That Can Grant Membership in This Group<br>
+        (&quot;Users in <var>X</var> can add other users to 
+         [%+ group.name FILTER html %]&quot;)
+
+      </th>
+     <th>Groups That This Group Can Grant Membership In<br>
+       (&quot;Users in [% group.name FILTER html %] can add users to...&quot;)
+     </th>
+    </tr>
+    <tr>
+      <td class="one">
+        [% PROCESS select_pair name = "bless_from" size = 10
+                   items_available = bless_from_available
+                     items_current = bless_from_current %]
+      </td>
+      <td>[% PROCESS select_pair name = "bless_to" size = 10
+                     items_available = bless_to_available
+                       items_current = bless_to_current %]
+      </td>
+    </tr>
+  </table>
+
+  [% IF Param('usevisibilitygroups') %]
+    <table class="grant_table">
+      <tr>
+        <th class="one">
+          Groups That Can See This Group<br>
+          (&quot;Users in <var>X</var> can see users in
+           [%+ group.name FILTER html %]&quot;)
+        </th>
+       <th>Groups That This Group Can See<br>
+         (&quot;Users in [% group.name FILTER html %] can see users in...&quot;)
+       </th>
+      </tr>
+      <tr>
+        <td class="one">
+          [% PROCESS select_pair name = "visible_from" size = 10
+                     items_available = visible_from_available
+                       items_current = visible_from_current %]
+        </td>
+        <td>[% PROCESS select_pair name = "visible_to_me" size = 10
+                       items_available = visible_to_me_available
+                         items_current = visible_to_me_current %]
+        </td>
+      </tr>
+    </table>
+  [% END %]
+
+  <input type="submit" id="update-group" value="Update Group">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+</form>
+  
+<h4>Mass Remove</h4>
+
+<p>You can use this form to do mass-removal of users from groups.
+  This is often very useful if you upgraded from [% terms.Bugzilla %] 
+  2.16.</p>
+
+<table><tr><td>
+<form method="post" action="editgroups.cgi">
+  <fieldset>
+    <legend>Remove all explicit memberships from users whose login names
+      match the following regular expression:</legend>
+    <input type="text" size="20" name="regexp">
+    <input type="submit" id="remove-membership" value="Remove Memberships">
+
+    <p>If you leave the field blank, all explicit memberships in 
+      this group will be removed.</p>
+
+    <input type="hidden" name="action" value="confirm_remove">
+    <input type="hidden" name="group_id" value="[% group.id FILTER html %]">
+  </fieldset>
+</form>
+</td></tr></table>
+ 
+<p>Back to the <a href="editgroups.cgi">group list</a>.</p>
+
+[% PROCESS global/footer.html.tmpl %] 
+
+[% BLOCK select_pair %]
+  <table class="select_pair">
+    <tr>
+      <th><label for="[% "${name}_add" FILTER html %]">Add<br>
+        (select to add)</label></th>
+      <th><label for="[% "${name}_remove" FILTER html %]">Current<br>
+        (select to remove)</label></th>
+    </tr>
+    <tr>
+      <td>
+        <select multiple="multiple" size="[% size FILTER html %]"
+                name="[% "${name}_add" FILTER html %]"
+                id="[% "${name}_add" FILTER html %]">
+          [% FOREACH item = items_available %]
+            <option value="[% item.id FILTER html %]">
+              [% item.name FILTER html %]</option>
+          [% END %]
+        </select>
+      </td>
+      <td>
+        <select multiple="multiple" size="[% size FILTER html %]"
+                name="[% "${name}_remove" FILTER html %]"
+                id="[% "${name}_remove" FILTER html %]">
+          [% FOREACH item = items_current %]
+            <option value="[% item.id FILTER html %]">
+              [% item.name FILTER html %]</option>
+          [% END %]
+        </select>
+      </td>
+    </tr>
+  </table>
+[% END %]

diff --git a/template/en/default/admin/groups/list.html.tmpl b/template/en/default/admin/groups/list.html.tmpl
new file mode 100644 (file)
index 0000000..af7da33
--- /dev/null
+++ b/template/en/default/admin/groups/list.html.tmpl
@@ -0,0 +1,153 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # groups: array with group objects having the properties:
+  #   - id: number. The ID of the group.
+  #   - name: string. The name of the group.
+  #   - description: string. The description of the group.
+  #   - userregexp: string. The user regexp for the given group.
+  #   - isactive: boolean int. Specifies if the group is active or not.
+  #   - isbuggroup: boolean int. Specifies if it can be used for bugs.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = "Edit Groups"
+  subheader = "This lets you edit the groups available to put users in."
+  doc_section = "groups.html"
+%]
+
+[% edit_contentlink = "editgroups.cgi?action=changeform&group=%%id%%" %]
+[% del_contentlink = "editgroups.cgi?action=del&group=%%id%%" %]
+
+[% columns =
+  [{name               => 'name'
+    heading            => 'Name'
+    contentlink        => edit_contentlink
+   }
+   {name               => 'description'
+    heading            => 'Description'
+    allow_html_content => 1
+   }
+   {name               => 'userregexp'
+    heading            => 'User RegExp'
+   }
+   {name               => 'is_active_bug_group'
+    heading            => "Use For $terms.Bugs"
+    align              => 'center'
+   }
+   {name               => 'type'
+    heading            => 'Type'
+    align              => 'center'
+   }
+   {name               => 'action'
+    heading            => 'Action'
+   }
+  ]
+%]
+
+[% overrides.is_active_bug_group = {
+     'is_active_bug_group' => {
+       "0" => {
+          override_content => 1
+          content => " "
+       }
+       "1" => {
+          override_content => 1
+          content => "X"
+       }
+     }
+   }
+
+   overrides.userregexp = {
+     'userregexp' => {
+       "" => {
+         override_content => 1
+         content => " "
+       }
+     }
+   } 
+%]
+
+[% FOREACH group IN ["chartgroup", "insidergroup", "timetrackinggroup", "querysharegroup"] %]
+  [% special_group = Param(group) %]
+
+  [% IF special_group %]
+    [% overrides.action.name.$special_group = {
+         override_content => 1
+         content => "(used as the '$group')"
+       }
+    %]
+  [% END %]
+[% END %]
+
+[% overrides.action.isbuggroup = {
+     "1" => {
+         override_content => 1
+         content => "Delete"
+         override_contentlink => 1
+         contentlink => del_contentlink
+     }
+   }
+
+   overrides.type.isbuggroup = {
+     "0" => {
+         override_content => 1
+         content => "system"
+     }
+     "1" => {
+         override_content => 1
+         content => "user"
+     }
+   }
+%] 
+
+[% PROCESS admin/table.html.tmpl
+  columns = columns
+  data    = groups
+  overrides = overrides
+%]
+
+<p><a href="editgroups.cgi?action=add">Add Group</a></p>
+
+<p>
+  <b>Name</b> is what is used with the B<!-- blah -->ugzilla->user->in_group()
+function in any customized cgi files you write that use a given group.
+It can also be used by people submitting [% terms.bugs %] by email to
+limit [% terms.abug %] to a certain set of groups.
+</p>
+
+<p>
+  <b>Description</b> is what will be shown in the [% terms.bug %] reports
+to members of the group where they can choose whether the [% terms.bug %]
+will be restricted to others in the same group.
+</p>
+
+<p>
+  <b>User RegExp</b> is optional, and if filled in, will automatically
+grant membership to this group to anyone with an email address
+that matches this perl regular expression. Do not forget
+the trailing '$'.  Example '@mycompany\.com$'
+</p>
+
+<p>
+  The <b>Use For [% terms.Bugs %]</b> flag determines whether or not
+the group is eligible to be used for [% terms.bugs %]. If you remove
+this flag, it will no longer be possible for users to add [% terms.bugs %]
+to this group, although [% terms.bugs %] already in the group will remain
+in the group. Doing so is a much less drastic way to stop a group
+from growing than deleting the group as well as a way to maintain
+lists of users without cluttering the lists of groups used
+for [% terms.bug %] restrictions.
+</p>
+
+<p>
+  The <b>Type</b> field identifies system groups.
+</p>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/keywords/confirm-delete.html.tmpl b/template/en/default/admin/keywords/confirm-delete.html.tmpl
new file mode 100644 (file)
index 0000000..718a32e
--- /dev/null
+++ b/template/en/default/admin/keywords/confirm-delete.html.tmpl
@@ -0,0 +1,39 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # keyword: A Bugzilla::Keyword object.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = "Delete Keyword"
+%]
+
+<p>
+  [% IF keyword.bug_count == 1 %]
+    There is one [% terms.bug %] with this keyword set.
+  [% ELSIF keyword.bug_count > 1 %]
+    There are [% keyword.bug_count FILTER html %] [%+ terms.bugs %] with
+    this keyword set.
+  [% END %]
+  
+  Are you <b>sure</b> you want to delete
+  the <code>[% keyword.name FILTER html %]</code> keyword?
+</p>
+
+<form method="post" action="editkeywords.cgi">
+  <input type="hidden" name="id" value="[% keyword.id FILTER html %]">
+  <input type="hidden" name="action" value="delete">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+  <input type="submit" id="delete"
+         value="Yes, really delete the keyword">
+</form>
+
+<p><a href="editkeywords.cgi">Edit other keywords</a>.</p>
+
+[% PROCESS global/footer.html.tmpl %] 

diff --git a/template/en/default/admin/keywords/create.html.tmpl b/template/en/default/admin/keywords/create.html.tmpl
new file mode 100644 (file)
index 0000000..e29db40
--- /dev/null
+++ b/template/en/default/admin/keywords/create.html.tmpl
@@ -0,0 +1,45 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # none
+  #%]
+  
+[% PROCESS global/header.html.tmpl
+  title = "Add keyword"
+  subheader = "This page allows you to add a new keyword."
+%]
+
+<form method="post" action="editkeywords.cgi">
+  <table border="0" cellpadding="4" cellspacing="0">
+    <tr>
+      <th align="right">Name:</th>
+      <td><input size="64" maxlength="64" name="name" value=""></td>
+    </tr>
+    <tr>
+      <th align="right">Description:</th>
+      <td>
+        [% INCLUDE global/textarea.html.tmpl
+          name    = 'description'
+          minrows = 4
+          cols    = 64
+          wrap    = 'virtual'
+        %]
+      </td>
+    </tr>
+  </table>
+  <hr>
+  <input type="hidden" name="id" value="-1">
+  <input type="submit" id="create" value="Add">
+  <input type="hidden" name="action" value="new">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+</form>
+
+<p><a href="editkeywords.cgi">Edit other keywords</a>.</p>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/keywords/edit.html.tmpl b/template/en/default/admin/keywords/edit.html.tmpl
new file mode 100644 (file)
index 0000000..07603e1
--- /dev/null
+++ b/template/en/default/admin/keywords/edit.html.tmpl
@@ -0,0 +1,57 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # keyword: A Bugzilla::Keyword object.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = "Edit keyword"
+%]
+
+<form method="post" action="editkeywords.cgi">
+  <table border="0" cellpadding="4" cellspacing="0">
+    <tr>
+      <th align="right">Name:</th>
+      <td><input size="64" maxlength="64" name="name" 
+                 value="[% keyword.name FILTER html %]"></td>
+    </tr>
+    <tr>
+      <th align="right">Description:</th>
+      <td>
+        [% INCLUDE global/textarea.html.tmpl
+          name           = 'description'
+          minrows        = 4
+          cols           = 64
+          wrap           = 'virtual'
+          defaultcontent = keyword.description
+        %]
+      </td>
+    </tr>
+    <tr>
+      <th align="right">[% terms.Bugs %]:</th>
+      <td>
+        [% IF keyword.bug_count > 0 %]
+          <a href="buglist.cgi?keywords=[% keyword.name FILTER uri %]">
+            [% keyword.bug_count FILTER html %]</a>
+        [% ELSE %]
+          none
+        [% END %]
+      </td>
+    </tr>
+  </table>
+
+  <input type="submit" id="update" value="Save Changes">
+  <input type="hidden" name="action" value="update">
+  <input type="hidden" name="id" value="[% keyword.id FILTER html %]">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+</form>
+
+<p><a href="editkeywords.cgi">Edit other keywords</a>.</p>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/keywords/list.html.tmpl b/template/en/default/admin/keywords/list.html.tmpl
new file mode 100644 (file)
index 0000000..ea98ca7
--- /dev/null
+++ b/template/en/default/admin/keywords/list.html.tmpl
@@ -0,0 +1,54 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # keywords: array keyword objects having the properties:
+  #   - id: number. The ID of the keyword.
+  #   - name: string. The name of the keyword.
+  #   - description: string. The description of the keyword.
+  #   - bug_count: number. The number of bugs with the keyword.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = "Select keyword"
+%]
+
+[% columns = [
+     { 
+       name => "name"
+       heading => "Edit keyword..."
+       contentlink => "editkeywords.cgi?action=edit&id=%%id%%" 
+     },
+     { 
+       name => "description"
+       heading => "Description"
+       allow_html_content => 1
+     },
+     { 
+       name => "bug_count"
+       heading => "$terms.Bugs"
+       align => "right"
+       contentlink => "buglist.cgi?keywords=%%name%%"
+     },
+     { 
+       heading => "Action" 
+       content => "Delete"
+       contentlink => "editkeywords.cgi?action=del&id=%%id%%"
+     }
+   ]
+%]
+
+[% PROCESS admin/table.html.tmpl
+     columns = columns
+     data = keywords
+     footer = footer_row
+%]
+
+<p><a href="editkeywords.cgi?action=add">Add a new keyword</a></p>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/milestones/confirm-delete.html.tmpl b/template/en/default/admin/milestones/confirm-delete.html.tmpl
new file mode 100644 (file)
index 0000000..cc30f16
--- /dev/null
+++ b/template/en/default/admin/milestones/confirm-delete.html.tmpl
@@ -0,0 +1,83 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # product: object; Bugzilla::Product object representing the product to
+  #               which the milestone belongs.
+  # milestone: object; Bugzilla::Milestone object representing the
+  #                    milestone the user wants to delete.
+  #%]
+
+[% title = BLOCK %]Delete Milestone of Product '[% product.name FILTER html %]'
+  [% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+  style_urls = ['skins/standard/admin.css']
+%]
+
+<table border="1" cellpadding="4" cellspacing="0">
+<tr bgcolor="#6666FF">
+  <th valign="top" align="left">Field</th>
+  <th valign="top" align="left">Value</th>
+</tr>
+<tr>
+  <td valign="top">Milestone:</td>
+  <td valign="top">[% milestone.name FILTER html %]</td>
+</tr>
+<tr>
+  <td valign="top">Milestone of Product:</td>
+  <td valign="top">[% product.name FILTER html %]</td>
+</tr>
+<tr>
+  <td valign="top">[% terms.Bugs %]:</td>
+  <td valign="top">
+[% IF milestone.bug_count %]
+  <a title="List of [% terms.bugs %] targetted at milestone '
+           [% milestone.name FILTER html %]'"
+     href="buglist.cgi?target_milestone=[% milestone.name FILTER uri %]&amp;product=
+          [%- product.name FILTER uri %]">
+          [% milestone.bug_count FILTER none %]</a>
+[% ELSE %]
+  None
+[% END %]
+  </td>
+</tr>
+</table>
+
+<h2>Confirmation</h2>
+  
+[% IF milestone.bug_count %]
+
+  <p class="confirmation">
+    There
+    [% IF milestone.bug_count > 1 %] 
+      are [% milestone.bug_count FILTER none %] [%+ terms.bugs %] 
+    [% ELSE %]
+      is 1 [% terms.bug %]
+    [% END %]
+    entered for this milestone! When you delete this milestone,
+    <b>ALL</b> of these [% terms.bugs %] will be retargeted
+    to [% product.default_milestone FILTER html %], the default milestone for 
+    the [% product.name FILTER html %] product.
+  </p>
+[% END %]
+
+<p>Do you really want to delete this milestone?<p>
+
+<form method="post" action="editmilestones.cgi">
+  <input type="submit" id="delete" value="Yes, delete">
+  <input type="hidden" name="action" value="delete">
+  <input type="hidden" name="product" value="[% product.name FILTER html %]">
+  <input type="hidden" name="milestone" value="[% milestone.name FILTER html %]">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+</form>
+
+[% PROCESS admin/milestones/footer.html.tmpl %]
+
+[% PROCESS global/footer.html.tmpl %] 

diff --git a/template/en/default/admin/milestones/create.html.tmpl b/template/en/default/admin/milestones/create.html.tmpl
new file mode 100644 (file)
index 0000000..8006c0c
--- /dev/null
+++ b/template/en/default/admin/milestones/create.html.tmpl
@@ -0,0 +1,46 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # product: object; Bugzilla::Product object representing the product to
+  #               which the milestone belongs.
+  #%]
+  
+[% title = BLOCK %]Add Milestone to Product '[% product.name FILTER html %]'[% END %]
+[% subheader = BLOCK %]This page allows you to add a new milestone to product
+                '[% product.name FILTER html %]'.[% END %]
+[% PROCESS global/header.html.tmpl
+  title = title
+  subheader = subheader
+  onload = "document.forms['f'].milestone.focus()"
+%]
+
+<form name="f" method="post" action="editmilestones.cgi">
+  <table border="0" cellpadding="4" cellspacing="0">
+    <tr>
+      <th align="right"><label for="milestone">Milestone:</label></th>
+      <td><input id="milestone" size="64" maxlength="64" name="milestone"
+                 value=""></td>
+    </tr>
+    <tr>
+      <th align="right"><label for="sortkey">Sortkey:</label></th>
+      <td><input id="sortkey" size="20" maxlength="20" name="sortkey"
+                 value=""></td>
+    </tr>
+  </table>
+  <input type="submit" id="create" value="Add">
+  <input type="hidden" name="action" value="new">
+  <input type="hidden" name='product' value="[% product.name FILTER html %]">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+</form>
+
+[% PROCESS admin/milestones/footer.html.tmpl
+    no_add_milestone_link = 1
+ %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/milestones/edit.html.tmpl b/template/en/default/admin/milestones/edit.html.tmpl
new file mode 100644 (file)
index 0000000..759bd70
--- /dev/null
+++ b/template/en/default/admin/milestones/edit.html.tmpl
@@ -0,0 +1,53 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # product: object; Bugzilla::Product object representing the product to
+  #               which the milestone belongs.
+  # milestone: object; Bugzilla::Milestone object representing the
+  #                    milestone the user wants to edit.
+  #%]
+
+[% title = BLOCK %]Edit Milestone '[% milestone.name FILTER html %]' of product '
+                   [%- product.name FILTER html %]'[% END %]
+[% PROCESS global/header.html.tmpl
+  title = title
+  onload = "document.forms['f'].milestone.select()"
+%]
+
+<form name="f" method="post" action="editmilestones.cgi">
+  <table border="0" cellpadding="4" cellspacing="0">
+
+    <tr>
+      <th class="field_label"><label for="milestone">Milestone:</label></th>
+      <td><input id="milestone" size="64" maxlength="64" name="milestone" value="
+      [%- milestone.name FILTER html %]"></td>
+    </tr>
+    <tr>
+      <th class="field_label"><label for="sortkey">Sortkey:</label></th>
+      <td><input id="sortkey" size="20" maxlength="20" name="sortkey" value="
+      [%- milestone.sortkey FILTER html %]"></td>
+    </tr>
+    <tr>
+      <th class="field_label"><label for="isactive">Enabled For [% terms.Bugs %]:</label></th>
+      <td><input id="isactive" name="isactive" type="checkbox" value="1"
+                 [% 'checked="checked"' IF milestone.isactive %]></td>
+    </tr>
+  </table>
+
+  <input type="hidden" name="milestoneold" value="[% milestone.name FILTER html %]">
+  <input type="hidden" name="action" value="update">
+  <input type="hidden" name="product" value="[% product.name FILTER html %]">
+  <input type="submit" id="update" value="Save Changes">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+</form>
+
+[% PROCESS admin/milestones/footer.html.tmpl
+  no_edit_milestone_link = 1 %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/milestones/footer.html.tmpl b/template/en/default/admin/milestones/footer.html.tmpl
new file mode 100644 (file)
index 0000000..10c6f90
--- /dev/null
+++ b/template/en/default/admin/milestones/footer.html.tmpl
@@ -0,0 +1,55 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # product: object; Bugzilla::Product object representing the product to
+  #               which the milestone belongs.
+  #
+  # milestone: object; Bugzilla::Milestone object representing the
+  #                    milestone.
+  #
+  # no_XXX_link: boolean; if defined, then don't show the corresponding
+  #                       link. Supported parameters are:
+  #
+  # no_edit_milestone_link
+  # no_edit_other_milestones_link
+  # no_add_milestone_link
+  #%]
+
+<hr>
+
+<p>
+
+[% UNLESS no_add_milestone_link %]
+  <a title="Add a milestone to product '[% product.name FILTER html %]'"
+     href="editmilestones.cgi?action=add&amp;product=
+          [%- product.name FILTER uri %]">Add</a> a milestone. 
+[% END %]
+
+[% IF milestone.name && !no_edit_milestone_link %]
+  Edit milestone <a 
+  title="Edit Milestone '[% milestone.name FILTER html %]' of product '
+         [%- product.name FILTER html %]'"
+  href="editmilestones.cgi?action=edit&amp;product=
+        [%- product.name FILTER uri %]&amp;milestone=
+        [%- milestone.name FILTER uri %]">
+        '[% milestone.name FILTER html %]'</a>.
+[% END %]
+
+[% UNLESS no_edit_other_milestones_link %]
+  Edit other milestones of product <a 
+  href="editmilestones.cgi?product=
+        [%- product.name FILTER uri %]">'[% product.name FILTER html %]'</a>.
+
+[% END %]
+
+  Edit product <a 
+  href="editproducts.cgi?action=edit&amp;product=
+        [%- product.name FILTER uri %]">'[% product.name FILTER html %]'</a>.
+
+</p>

diff --git a/template/en/default/admin/milestones/list.html.tmpl b/template/en/default/admin/milestones/list.html.tmpl
new file mode 100644 (file)
index 0000000..1638279
--- /dev/null
+++ b/template/en/default/admin/milestones/list.html.tmpl
@@ -0,0 +1,98 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # product: object; Bugzilla::Product object representing the product to
+  #               which the milestones belongs.
+  # showbugcounts: if defined, then bug counts should be included in the table
+  #%]
+
+[% USE Bugzilla %]
+[% cgi = Bugzilla.cgi %]
+
+[% title = BLOCK %]Select milestone of product
+                   '[% product.name FILTER html %]'[% END %]
+[% PROCESS global/header.html.tmpl
+  title = title
+%]
+
+[% edit_contentlink = BLOCK %]editmilestones.cgi?action=edit&product=
+  [%- product.name FILTER uri %]&milestone=%%name%%[% END %]
+[% delete_contentlink = BLOCK %]editmilestones.cgi?action=del&product=
+  [%- product.name FILTER uri %]&milestone=%%name%%[% END %]
+[% bug_count_contentlink = BLOCK %]buglist.cgi?target_milestone=%%name%%&product=
+  [%- product.name FILTER uri %][% END %]
+
+
+[% columns = [
+     { 
+       name => "name"
+       heading => "Edit milestone..."
+       contentlink => edit_contentlink
+     },
+     { 
+       name => "sortkey"
+       heading => "Sortkey"
+     },
+     {
+       name => "isactive"
+       heading => "Active"
+       yesno_field => 1
+     }
+   ]
+%]
+
+[% IF showbugcounts %]
+
+  [% columns.push({
+       name => "bug_count"
+       heading => "$terms.Bugs"
+       align => "right"
+       contentlink => bug_count_contentlink
+     })
+  %]
+
+[% END %]
+
+[% columns.push({
+       name => "action"
+       heading => "Action"
+       content => "Delete"
+       contentlink => delete_contentlink
+     })
+%]
+
+[%# We want to override the usual 'Delete' link for the default milestone %]
+[% overrides.action.name.${product.default_milestone} = {
+     override_content => 1
+     content => "(Default milestone)"
+     override_contentlink => 1
+     contentlink => undef
+   } 
+%] 
+
+[% Hook.process('before_table') %]
+
+[% PROCESS admin/table.html.tmpl
+     columns = columns
+     data = product.milestones
+     overrides = overrides
+%]
+
+[% IF ! showbugcounts %]
+
+  <p><a href="editmilestones.cgi?product=[% product.name FILTER uri %]&amp;showbugcounts=1">
+      Redisplay table with [% terms.bug %] counts (slower)</a></p>
+
+[% END %]
+
+[% PROCESS admin/milestones/footer.html.tmpl
+  no_edit_other_milestones_link = 1
+%]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/milestones/select-product.html.tmpl b/template/en/default/admin/milestones/select-product.html.tmpl
new file mode 100644 (file)
index 0000000..18bb88c
--- /dev/null
+++ b/template/en/default/admin/milestones/select-product.html.tmpl
@@ -0,0 +1,54 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # products: array of product objects
+  # showbugcounts: if defined, then bug counts should be included in the table
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = "Edit milestones for which product?"
+%]
+
+[% columns = [
+     { 
+       name => "name"
+       heading => "Edit milestones of..."
+       contentlink => "editmilestones.cgi?product=%%name%%" 
+     },
+     { 
+       name => "description"
+       heading => "Description" 
+       allow_html_content => 1
+     }
+   ]
+%]
+
+[% IF showbugcounts %]
+
+  [% columns.push({
+      name => 'bug_count'
+      heading => "$terms.Bugs"
+      align => "right"
+      contentlink => "buglist.cgi?product=%%name%%"
+    })
+  %]
+
+[% END %]
+
+[% PROCESS admin/table.html.tmpl
+     columns = columns
+     data = products
+%]
+
+[% IF !showbugcounts %]
+  <p><a href="editmilestones.cgi?showbugcounts=1">
+      Redisplay table with [% terms.bug %] counts (slower)</a></p>
+[% END %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/params/admin.html.tmpl b/template/en/default/admin/params/admin.html.tmpl
new file mode 100644 (file)
index 0000000..c63329c
--- /dev/null
+++ b/template/en/default/admin/params/admin.html.tmpl
@@ -0,0 +1,28 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[%
+   title = "Administrative Policies"
+   desc = "Set up account policies"
+%]
+
+[% param_descs = {
+  allowbugdeletion => "The pages to edit products and components can delete all " _
+                      "associated $terms.bugs when you delete a product (or component). " _
+                      "Since that is a pretty scary idea, you have to turn on " _
+                      "this option before any such deletions will ever happen.",
+
+  allowemailchange => "Users can change their own email address through the preferences. " _
+                      "Note that the change is validated by emailing both addresses, so " _
+                      "switching this option on will not let users use an invalid address.",
+
+  allowuserdeletion => "The user editing pages are capable of letting you delete user accounts. " _
+                       "$terms.Bugzilla will issue a warning in case you'd run into inconsistencies " _
+                       "when you're about to do so, but such deletions remain kinda scary. " _
+                       "So, you have to turn on this option before any such deletions " _
+                       "will ever happen." }
+%]

diff --git a/template/en/default/admin/params/advanced.html.tmpl b/template/en/default/admin/params/advanced.html.tmpl
new file mode 100644 (file)
index 0000000..076d2dc
--- /dev/null
+++ b/template/en/default/admin/params/advanced.html.tmpl
@@ -0,0 +1,68 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% 
+   title = "Advanced"
+   desc = "Settings for advanced configurations."
+%]
+
+[% sts_desc = BLOCK %]
+  Enables the sending of the 
+  <a href="http://en.wikipedia.org/wiki/Strict_Transport_Security">Strict-Transport-Security</a>
+  header along with HTTP responses on SSL connections. This adds greater
+  security to your SSL connections by forcing the browser to always
+  access your domain over SSL and never accept an invalid certificate. 
+  However, it should only be used if you have the <code>ssl_redirect</code>
+  parameter turned on, [% terms.Bugzilla %] is the only thing running
+  on its domain (i.e., your <code>urlbase</code> is something like
+  <code>http://bugzilla.example.com/</code>), and you never plan to disable
+  the <code>ssl_redirect</code> parameter.
+  <ul>
+    <li>
+      off - Don't send the Strict-Transport-Security header with requests.
+    </li>
+    <li>
+      this_domain_only - Send the Strict-Transport-Security header with all
+      requests, but only support it for the current domain.
+    </li>
+    <li>
+      include_subdomains - Send the Strict-Transport-Security header along
+      with the <code>includeSubDomains</code> flag, which will apply the
+      security change to all subdomains. This is especially useful when
+      combined with an <code>attachment_base</code> that exists as (a)
+      subdomain(s) under the main [% terms.Bugzilla %] domain.
+    </li>
+  </ul>
+[% END %]
+
+[% param_descs = {
+  cookiedomain => 
+    "If your website is at 'www.foo.com', setting this to"
+    _ " '.foo.com' will also allow 'bar.foo.com' to access"
+    _ " $terms.Bugzilla cookies. This is useful if you have more than"
+    _ " one hostname pointing at the same web server, and you"
+    _ " want them to share the $terms.Bugzilla cookie.",
+
+  inbound_proxies =>
+    "When inbound traffic to $terms.Bugzilla goes through a proxy,"
+    _ " $terms.Bugzilla thinks that the IP address of every single"
+    _ " user is the IP address of the proxy. If you enter a comma-separated"
+    _ " list of IPs in this parameter, then $terms.Bugzilla will trust any"
+    _ " <code>X-Forwarded-For</code> header sent from those IPs,"
+    _ " and use the value of that header as the end user's IP address.",
+
+  proxy_url => 
+    "$terms.Bugzilla may have to access the web to get notifications about"
+    _ " new releases (see the <tt>upgrade_notification</tt> parameter)."
+    _ " If your $terms.Bugzilla server is behind a proxy, it may be"
+    _ " necessary to enter its URL if the web server cannot access the"
+    _ " HTTP_PROXY environment variable. If you have to authenticate,"
+    _ " use the <code>http://user:pass@proxy_url/</code> syntax.",
+
+  strict_transport_security => sts_desc,
+} %]

diff --git a/template/en/default/admin/params/attachment.html.tmpl b/template/en/default/admin/params/attachment.html.tmpl
new file mode 100644 (file)
index 0000000..6e03019
--- /dev/null
+++ b/template/en/default/admin/params/attachment.html.tmpl
@@ -0,0 +1,62 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[%
+   title = "Attachments"
+   desc = "Set up attachment options"
+%]
+
+[% param_descs = {
+  allow_attachment_display =>
+    "If this option is on, users will be able to view attachments from"
+    _ " their browser, if their browser supports the attachment's MIME type."
+    _ " If this option is off, users are forced to download attachments,"
+    _ " even if the browser is able to display them."
+    _ "<p>This is a security restriction for installations where untrusted"
+    _ " users may upload attachments that could be potentially damaging if"
+    _ " viewed directly in the browser.</p>"
+    _ "<p>It is highly recommended that you set the <tt>attachment_base</tt>"
+    _ " parameter if you turn this parameter on.",
+
+  attachment_base => 
+    "When the <tt>allow_attachment_display</tt> parameter is on, it is "
+    _ " possible for a malicious attachment to steal your cookies or"
+    _ " perform an attack on $terms.Bugzilla using your credentials."
+    _ "<p>If you would like additional security on attachments to avoid"
+    _ " this, set this parameter to an alternate URL for your $terms.Bugzilla"
+    _ " that is not the same as <tt>urlbase</tt> or <tt>sslbase</tt>."
+    _ " That is, a different domain name that resolves to this exact"
+    _ " same $terms.Bugzilla installation.</p>"
+    _ "<p>Note that if you have set the"
+    _ " <a href=\"editparams.cgi?section=advanced#cookiedomain_desc\"><tt>cookiedomain</tt>"
+    _" parameter</a>, you should set <tt>attachment_base</tt> to use a"
+    _ " domain that would <em>not</em> be matched by"
+    _ " <tt>cookiedomain</tt>.</p>"
+    _ "<p>For added security, you can insert <tt>%bugid%</tt> into the URL,"
+    _ " which will be replaced with the ID of the current $terms.bug that"
+    _ " the attachment is on, when you access an attachment. This will limit"
+    _ " attachments to accessing only other attachments on the same"
+    _ " ${terms.bug}. Remember, though, that all those possible domain names "
+    _ " (such as <tt>1234.your.domain.com</tt>) must point to this same"
+    _ " $terms.Bugzilla instance.",
+
+  allow_attachment_deletion => "If this option is on, administrators will be able to delete " _
+                               "the content of attachments.",
+
+  maxattachmentsize => "The maximum size (in kilobytes) of attachments to be stored " _
+                       "in the database. If a file larger than this size is attached " _
+                       "to ${terms.abug}, $terms.Bugzilla will look at the " _
+                       "<a href='#maxlocalattachment'><tt>maxlocalattachment</tt> parameter</a> " _
+                       "to determine if the file can be stored locally on the web server. " _
+                       "If the file size exceeds both limits, then the attachment is rejected. " _
+                       "Settings both parameters to 0 will prevent attaching files to ${terms.bugs}.",
+
+  maxlocalattachment => "The maximum size (in megabytes) of attachments to be stored " _
+                        "locally on the web server. If set to a value lower than the " _
+                        "<a href='#maxattachmentsize'><tt>maxattachmentsize</tt> parameter</a>, " _
+                        "attachments will never be kept on the local filesystem." }
+%]

diff --git a/template/en/default/admin/params/auth.html.tmpl b/template/en/default/admin/params/auth.html.tmpl
new file mode 100644 (file)
index 0000000..96aba3c
--- /dev/null
+++ b/template/en/default/admin/params/auth.html.tmpl
@@ -0,0 +1,130 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[%
+   title = "User Authentication"
+   desc = "Set up your authentication policies"
+%]
+
+[% param_descs = {
+  auth_env_id => "Environment variable used by external authentication system " _
+                 "to store a unique identifier for each user. Leave it blank " _
+                 "if there isn't one or if this method of authentication " _
+                 "is not being used.",
+
+  auth_env_email => "Environment variable used by external authentication system " _
+                    "to store each user's email address. This is a required " _
+                    "field for environmental authentication. Leave it blank " _
+                    "if you are not going to use this feature.",
+
+  auth_env_realname => "Environment variable used by external authentication system " _
+                       "to store the user's real name. Leave it blank if there " _
+                       "isn't one or if this method of authentication is not being " _
+                       "used.",
+
+  user_info_class => "Mechanism(s) to be used for gathering a user's login information.
+                      More than one may be selected. If the first one returns nothing,
+                      the second is tried, and so on.<br>
+                      The types are:
+                      <dl>
+                        <dt>CGI</dt>
+                        <dd>
+                          Asks for username and password via CGI form interface.
+                        </dd>
+                        <dt>Env</dt>
+                        <dd>
+                          Info for a pre-authenticated user is passed in system
+                          environment variables.
+                        </dd>
+                      </dl>",
+
+  user_verify_class => "Mechanism(s) to be used for verifying (authenticating) information
+                        gathered by user_info_class.
+                        More than one may be selected. If the first one cannot find the
+                        user, the second is tried, and so on.<br>
+                        The types are:
+                        <dl>
+                          <dt>DB</dt>
+                          <dd>
+                            ${terms.Bugzilla}'s built-in authentication. This is the most common
+                            choice.
+                          </dd>
+                          <dt>RADIUS</dt>
+                          <dd>
+                            RADIUS authentication using a RADIUS server.
+                            Please see the $terms.Bugzilla documentation for
+                            more information.
+                            Using this method requires
+                            <a href=\"?section=radius\">additional
+                            parameters</a> to be set.
+                          </dd>
+                          <dt>LDAP</dt>
+                          <dd>
+                            LDAP authentication using an LDAP server.
+                            Please see the $terms.Bugzilla documentation
+                            for more information. Using this method requires
+                            <a href=\"?section=ldap\">additional
+                            parameters</a> to be set.
+                          </dd>
+                        </dl>",
+
+  rememberlogin => "Controls management of session cookies
+                    <ul>
+                      <li>
+                        on - Session cookies never expire (the user has to login only
+                        once per browser).
+                      </li>
+                      <li>
+                        off - Session cookies last until the users session ends (the user
+                        will have to login in each new browser session).
+                      </li>
+                      <li>
+                        defaulton/defaultoff - Default behavior as described
+                        above, but user can choose whether $terms.Bugzilla will remember his
+                        login or not.
+                      </li>
+                    </ul>",
+
+  requirelogin => "If this option is set, all access to the system beyond the " _
+                  "front page will require a login. No anonymous users will " _
+                  "be permitted.",
+
+  emailregexp =>
+    "This defines the regular expression to use for legal email addresses. " _
+    "The default tries to match fully qualified email addresses. " _
+    "Use <tt>.*</tt> to accept any email address following the " _
+    "<a href='http://tools.ietf.org/html/rfc2822#section-3.4.1'>RFC 2822</a> " _
+    "specification. Another popular value to put here is <tt>^[^@]+$</tt>, " _
+    "which means 'local usernames, no @ allowed.'",
+
+  emailregexpdesc => "This describes in English words what kinds of legal addresses " _
+                     "are allowed by the <tt>emailregexp</tt> param.",
+
+  emailsuffix => "This is a string to append to any email addresses when actually " _
+                 "sending mail to that address. It is useful if you have changed " _
+                 "the <tt>emailregexp</tt> param to only allow local usernames, " _
+                 "but you want the mail to be delivered to username@my.local.hostname.",
+
+  createemailregexp => "This defines the (case-insensitive) regexp to use for email addresses that are " _
+                       "permitted to self-register using a 'New Account' feature. The " _
+                       "default (.*) permits any account matching the emailregexp " _
+                       "to be created. If this parameter is left blank, no users " _
+                       "will be permitted to create their own accounts and all accounts " _
+                       "will have to be created by an administrator.",
+
+  password_complexity =>
+    "Set the complexity required for passwords. In all cases must the passwords " _
+    "be at least ${constants.USER_PASSWORD_MIN_LENGTH} characters long." _
+    "<ul><li>no_constraints - No complexity required.</li>" _
+    "<li>mixed_letters - Passwords must contain at least one UPPER and one lower " _
+    "case letter.</li>" _
+    "<li>letters_numbers - Passwords must contain at least one UPPER and one " _
+    "lower case letter and a number.</li>" _
+    "<li>letters_numbers_specialchars - Passwords must contain at least one " _
+    "UPPER or one lower case letter, a number and a special character.</li></ul>"
+  }
+%]

diff --git a/template/en/default/admin/params/bugchange.html.tmpl b/template/en/default/admin/params/bugchange.html.tmpl
new file mode 100644 (file)
index 0000000..f442c59
--- /dev/null
+++ b/template/en/default/admin/params/bugchange.html.tmpl
@@ -0,0 +1,42 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[%
+   title = "$terms.Bug Change Policies"
+   desc = "Set up $terms.bug change policies"
+%]
+
+[% accept_status = display_value('bug_status', 'IN_PROGRESS') FILTER html %]
+
+[% param_descs = {
+  duplicate_or_move_bug_status => "When $terms.abug is marked as a duplicate of another one " _
+                                  "or is moved to another installation, use this $terms.bug status."
+
+  letsubmitterchoosepriority => "If this is on, then people submitting $terms.bugs can " _
+                                "choose an initial priority for that ${terms.bug}. " _
+                                "If off, then all $terms.bugs initially have the default " _
+                                "priority selected below.",
+
+  letsubmitterchoosemilestone => "If this is on, then people submitting $terms.bugs can " _
+                                 "choose the Target Milestone for that ${terms.bug}. " _
+                                 "If off, then all $terms.bugs initially have the default " _
+                                 "milestone for the product being filed in.",
+
+  musthavemilestoneonaccept => 
+    "If you are using ${field_descs.target_milestone}, do you want to require"
+    _ " that the milestone be set in order for a user to set"
+    _ "  ${terms.abug}'s status to ${accept_status}?",
+
+  commentonchange_resolution => "If this option is on, the user needs to enter a short " _
+                                "comment if the resolution of the $terms.bug changes.",
+
+  commentonduplicate => "If this option is on, the user needs to enter a short comment " _
+                        "if the $terms.bug is marked as duplicate.",
+
+  noresolveonopenblockers => "Don\'t allow $terms.bugs to be resolved as fixed " _
+                             "if they have unresolved dependencies." }
+%]

diff --git a/template/en/default/admin/params/bugfields.html.tmpl b/template/en/default/admin/params/bugfields.html.tmpl
new file mode 100644 (file)
index 0000000..07b2008
--- /dev/null
+++ b/template/en/default/admin/params/bugfields.html.tmpl
@@ -0,0 +1,45 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[%
+   title = "$terms.Bug Fields"
+   desc = "Choose fields you want to display"
+%]
+
+[% param_descs = {
+  useclassification => "If this is on, $terms.Bugzilla will associate each product with a " _
+                       "specific classification. But you must have 'editclassification' " _
+                       "permissions enabled in order to edit classifications.",
+
+  usetargetmilestone => "Do you wish to use the Target Milestone field?",
+
+  useqacontact => "Do you wish to use the QA Contact field?",
+
+  usestatuswhiteboard => "Do you wish to use the Status Whiteboard field?",
+
+  use_see_also => 
+    "Do you wish to use the See Also field? It allows you refer to"
+    _ " $terms.bugs in other installations. Even if you disable this field,"
+    _ " $terms.bug relationships (URLs) already set on $terms.bugs will"
+    _ " still appear and can be removed.",
+
+  defaultpriority => "This is the priority that newly entered $terms.bugs are set to.",
+
+  defaultseverity => "This is the severity that newly entered $terms.bugs are set to.",
+
+  defaultplatform => "This is the platform that is preselected on the $terms.bug " _
+                     "entry form.<br> " _
+                     "You can leave this empty: " _
+                     "$terms.Bugzilla will then use the platform that the browser " _
+                     "reports to be running on as the default.",
+
+  defaultopsys => "This is the operating system that is preselected on the $terms.bug " _
+                  "entry form.<br> " _
+                  "You can leave this empty: " _
+                  "$terms.Bugzilla will then use the operating system that the browser " _
+                  "reports to be running on as the default." }
+%]

diff --git a/template/en/default/admin/params/common.html.tmpl b/template/en/default/admin/params/common.html.tmpl
new file mode 100644 (file)
index 0000000..bf2675b
--- /dev/null
+++ b/template/en/default/admin/params/common.html.tmpl
@@ -0,0 +1,125 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% sortlist_separator = '---' %]
+
+<dl>
+  [% FOREACH param = panel.param_list %]
+    <dt id="[% param.name FILTER html %]_desc">[% param.name FILTER html %]</dt>
+    <dd>[% panel.param_descs.${param.name} FILTER none %]
+      <p>
+      [% IF param.type == "t" %]
+        <input type="text" size="80" name="[% param.name FILTER html %]"
+               id="[% param.name FILTER html %]" value="[% Param(param.name) FILTER html %]">
+      [% ELSIF param.type == "p" %]
+        <input type="password" size="80" name="[% param.name FILTER html %]"
+               id="[% param.name FILTER html %]" value="[% Param(param.name) FILTER html %]"
+               autocomplete="off">
+      [% ELSIF param.type == "l" %]
+        <textarea name="[% param.name FILTER html %]" id="[% param.name FILTER html %]"
+                  rows="10" cols="80">[% Param(param.name) FILTER html %]</textarea>
+      [% ELSIF param.type == "b" %]
+        <input type="radio" name="[% param.name FILTER html %]" id="[% param.name FILTER html %]-on"
+               value=1 [% "checked=\"checked\"" IF Param(param.name) %]>
+        <label for="[% param.name FILTER html %]-on">On</label>
+        <input type="radio" name="[% param.name FILTER html %]" id="[% param.name FILTER html %]-off"
+               value=0 [% "checked=\"checked\"" IF !Param(param.name) %]>
+        <label for="[% param.name FILTER html %]-off">Off</label>
+      [% ELSIF param.type == "m" %]
+        [% boxSize = 5 %]
+        [% boxSize = param.choices.size IF param.choices.size < 5 %]
+
+        <select multiple="multiple" size="[% boxSize FILTER html %]"
+                name="[% param.name FILTER html %]" id="[% param.name FILTER html %]">
+          [% FOREACH item = param.choices %]
+            <option value="[% item FILTER html %]"
+                    [% " selected=\"selected\"" IF lsearch(Param(param.name), item) != -1 %]>
+              [% item FILTER html %]
+            </option>
+          [% END %]
+        </select>
+      [% ELSIF param.type == "o" %]
+        <input id="input_[% param.name FILTER html %]" size="80"
+               name="[% param.name FILTER html %]"
+               value="[% Param(param.name) FILTER html %]"><br>
+        [% boxSize = 7 %]
+        [% boxSize = 3 + param.choices.size IF param.choices.size < 7 %]
+        [% plist = Param(param.name).split(',') %]
+
+        <table id="table_[% param.name FILTER html %]" class="bz_default_hidden">
+          <tr>
+            <td rowspan="2">
+              <select id="select_[% param.name FILTER html %]"
+                      name="select_[% param.name FILTER html %]"
+                      size="[% boxSize FILTER html %]">
+                [% FOREACH item = plist %]
+                  <option value="[% item FILTER html %]">[% item FILTER html %]</option>
+                [% END %]
+                <option class="sortlist_separator" disabled="disabled"
+                        value="[% sortlist_separator %]">active&uarr;&nbsp;&darr;inactive</option>
+                [% FOREACH item = param.choices %]
+                  [% IF lsearch(plist, item) == -1 %]
+                    <option value="[% item FILTER html %]">[% item FILTER html %]</option>
+                  [% END %]
+                [% END %]
+              </select>
+            </td>
+            <td style="vertical-align: bottom">
+              <button type="button"
+                      onClick="sortedList_moveItem('[% param.name FILTER html %]', -1, '[% sortlist_separator %]');">&uarr;</button>
+            </td>
+          </tr>
+
+          <tr>
+            <td style="vertical-align: top">
+              <button type="button"
+                      onClick="sortedList_moveItem('[% param.name FILTER html %]', +1, '[% sortlist_separator %]');">&darr;</button>
+            </td>
+          </tr>
+        </table>
+
+        <script type="text/javascript">
+            bz_toggleClass("input_[% param.name FILTER html %]", "bz_default_hidden");
+            bz_toggleClass("table_[% param.name FILTER html %]", "bz_default_hidden");
+        </script>
+      [% ELSIF param.type == "s" %]
+        <select name="[% param.name FILTER html %]" id="[% param.name FILTER html %]">
+          [% FOREACH item = param.choices %]
+            <option value="[% item FILTER html %]"
+                    [% " selected=\"selected\"" IF item == Param(param.name) %]>
+              [% IF param.name == "defaultseverity" %]
+                [% display_value("bug_severity", item) FILTER html %]
+              [% ELSIF param.name == "defaultplatform" %]
+                [% display_value("rep_platform", item) FILTER html %]
+              [% ELSIF param.name == "defaultopsys" %]
+                [% display_value("op_sys", item) FILTER html %]
+              [% ELSIF param.name == "duplicate_or_move_bug_status" %]
+                [% display_value("bug_status", item) FILTER html %]
+              [% ELSE %]
+                [% item FILTER html %]
+              [% END %]
+            </option>
+          [% END %]
+        </select>
+      [% ELSE %]
+        <font color="red">
+          Unknown param type [% param.type FILTER html %]!!!
+        </font>
+      [% END %]  
+      </p>
+      [% UNLESS param.no_reset %]
+        <p>
+          <input type="checkbox" name="reset-[% param.name FILTER html %]"
+                 id="reset-[% param.name FILTER html %]">
+          <label for="reset-[% param.name FILTER html %]">Reset</label>
+        </p>
+      [% END %]
+      <hr>
+    </dd>
+  [% END %]
+</dl>

diff --git a/template/en/default/admin/params/core.html.tmpl b/template/en/default/admin/params/core.html.tmpl
new file mode 100644 (file)
index 0000000..fd839ed
--- /dev/null
+++ b/template/en/default/admin/params/core.html.tmpl
@@ -0,0 +1,35 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% 
+   title = "Required Settings"
+   desc = "Settings that are required for proper operation of $terms.Bugzilla" 
+%]
+
+[% param_descs = {
+  urlbase => "The URL that is the common initial leading part of all $terms.Bugzilla " _
+             "URLs.",
+
+  sslbase => "The URL that is the common initial leading part of all HTTPS " _
+             "(SSL) $terms.Bugzilla URLs.",
+
+  ssl_redirect => 
+    "When this is enabled, $terms.Bugzilla will ensure that every page is"
+    _ " accessed over SSL, by redirecting any plain HTTP requests to HTTPS"
+    _ " using the <tt>sslbase</tt> parameter. Also, when this is enabled,"
+    _ " $terms.Bugzilla will send out links using <tt>sslbase</tt> in emails"
+    _ " instead of <tt>urlbase</tt>.",
+
+  cookiepath => "Path, relative to your web document root, to which to restrict " _
+                "$terms.Bugzilla cookies. Normally this is the URI portion of your URL " _
+                "base. Begin with a / (single slash mark). For instance, if " _
+                "$terms.Bugzilla serves from 'http://www.somedomain.com/bugzilla/', set " _
+                "this parameter to /bugzilla/. Setting it to / will allow " _
+                "all sites served by this web server or virtual host to read " _
+                "$terms.Bugzilla cookies.",
+} %]

diff --git a/template/en/default/admin/params/dependencygraph.html.tmpl b/template/en/default/admin/params/dependencygraph.html.tmpl
new file mode 100644 (file)
index 0000000..e8baf45
--- /dev/null
+++ b/template/en/default/admin/params/dependencygraph.html.tmpl
@@ -0,0 +1,36 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[%
+   title = "Dependency Graphs"
+   desc = "Optional setup for dependency graphing"
+%]
+
+[% param_descs = {
+  webdotbase => "It is possible to show graphs of dependent ${terms.bugs}. You may set
+                 this parameter to any of the following:
+                 <ul>
+                   <li>
+                     A complete file path to 'dot' (part of
+                     <a href=\"http://www.graphviz.org\">GraphViz</a>) will
+                     generate the graphs locally.
+                   </li>
+                   <li>
+                     A URL prefix pointing to an installation of the
+                     <a href=\"http://www.research.att.com/~north/cgi-bin/webdot.cgi\">webdot
+                     package</a> will generate the graphs remotely.
+                   </li>
+                   <li>
+                     A blank value will disable dependency graphing.
+                   </li>
+                 </ul>
+                 The default value is a publicly-accessible webdot server. If you change
+                 this value, make certain that the webdot server can read files from your
+                 webdot directory. On Apache you do this by editing the .htaccess file,
+                 for other systems the needed measures may vary. You can run <kbd>checksetup.pl</kbd>
+                 to recreate the .htaccess file if it has been lost."}
+%]

diff --git a/template/en/default/admin/params/editparams.html.tmpl b/template/en/default/admin/params/editparams.html.tmpl
new file mode 100644 (file)
index 0000000..3febbab
--- /dev/null
+++ b/template/en/default/admin/params/editparams.html.tmpl
@@ -0,0 +1,103 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% curpanel = -1 %]
+[% panels = panels.nsort('sortkey') %]
+
+[% FOREACH panel = panels %]
+  [% PROCESS "admin/params/${panel.name}.html.tmpl"
+             params = panel.param_list %]
+  [% panel.title = title %]
+  [% panel.desc = desc %]
+  [% panel.param_descs = param_descs %]
+  [% IF panel.current %][% curpanel = loop.index %][% END %]
+[% END %]
+
+[% current_panel = panels.$curpanel %]
+
+[%# We cannot call header.html.tmpl earlier as we have to know
+    which panel is active first, in order to get its title %]
+
+[% title = BLOCK %]
+  [% IF curpanel == -1 %]
+    Parameters: Index
+  [% ELSE %]
+    Configuration:
+    [%+ current_panel.title FILTER html %]
+  [% END %]
+[% END %]
+
+[% PROCESS global/header.html.tmpl
+   title = title
+   message = message
+   style_urls = ['skins/standard/params.css']
+   javascript_urls = ['js/params.js', 'js/util.js']
+   doc_section = "parameters.html"
+%]
+
+<table border="0" width="100%">
+  <tr>
+    <td>
+      [%# NAVIGATION BAR %]
+      <table id="menu">
+        <tr>
+          <td class="index">
+            <a href="editparams.cgi?section=index" title="Show all parameters">Index</a>
+          </td>
+        </tr>
+        [% FOREACH panel = panels %]
+          <tr>
+            [% IF panel.current %]
+              [% Hook.process("current_panel") %]
+              <td class="selected_section">
+                <span title="[% panel.desc FILTER html %]">[% panel.title FILTER html %]</span>
+              </td>
+            [% ELSE %]
+              <td>
+                <a href="editparams.cgi?section=[% panel.name FILTER uri %]"
+                   title="[% panel.desc FILTER html %]">[% panel.title FILTER html %]</a>
+              </td>
+            [% END %]
+          </tr>
+        [% END %]
+      </table>
+    </td>
+    <td>
+      [% IF curpanel == -1 %]
+        [% PROCESS admin/params/index.html.tmpl panels = panels %]
+      [% ELSE %]
+
+        <div class="contribute"><strong>Note:</strong>
+          B[% %]ugzilla is developed entirely by volunteers.
+          The best way to give back to the B[% %]ugzilla project is to
+          <a href="http://www.bugzilla.org/contribute/">contribute</a>
+          yourself!
+          You don't have to be a programmer to contribute, there are lots of
+          things that we need.
+        </div>
+
+        <p>
+          This lets you edit the basic operating parameters of [% terms.Bugzilla %].
+          Be careful!<br>
+          Any item you check "Reset" on will get reset to its default value.
+        </p>
+
+        [%# CONTENT PANEL %]
+        <form method="post" action="editparams.cgi">
+          [% PROCESS admin/params/common.html.tmpl panel = current_panel %]
+          <input type="hidden" name="section" value="[% current_panel.name FILTER html %]">
+          <input type="hidden" name="action" value="save">
+          <input type="hidden" name="token" value="[% token FILTER html %]">
+          <input type="submit" id="save-params" value="Save Changes">
+        </form>
+      [% END %]
+    </td>
+  </tr>
+</table>
+
+[% INCLUDE global/footer.html.tmpl %]

diff --git a/template/en/default/admin/params/general.html.tmpl b/template/en/default/admin/params/general.html.tmpl
new file mode 100644 (file)
index 0000000..daa1f35
--- /dev/null
+++ b/template/en/default/admin/params/general.html.tmpl
@@ -0,0 +1,73 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% 
+   title = "General"
+   desc = "Miscellaneous general settings that are not required." 
+%]
+
+[% param_descs = {
+  maintainer => 
+    "The email address of the person who maintains this installation "
+    _ " of ${terms.Bugzilla}.",
+
+  docs_urlbase => 
+    "The URL that is the common initial leading part of all"
+    _ " $terms.Bugzilla documentation URLs. It may be an absolute URL,"
+    _ " or a URL relative to the <tt>urlbase</tt> parameter. Leave this"
+    _ " empty to suppress links to the documentation."
+    _ "'%lang%' will be replaced by user's preferred language (if"
+    _ " documentation is available in that language).",
+
+  utf8 => 
+    "Use UTF-8 (Unicode) encoding for all text in ${terms.Bugzilla}. New"
+    _ " installations should set this to true to avoid character encoding"
+    _ " problems. <strong>Existing databases should set this to true"
+    _ " only after the data has been converted from existing legacy"
+    _ " character encodings to UTF-8, using the <kbd>contrib/recode.pl</kbd>"
+    _ " script</strong>."
+    _ " <p>Note that if you turn this parameter from &quot;off&quot; to"
+    _ " &quot;on&quot;, you must re-run <kbd>checksetup.pl</kbd> immediately"
+    _ " afterward.</p>",
+
+  shutdownhtml => 
+    "If this field is non-empty, then $terms.Bugzilla will be completely"
+    _ " disabled and this text will be displayed instead of all the"
+    _ " $terms.Bugzilla pages.",
+
+  announcehtml => 
+    "If this field is non-empty, then $terms.Bugzilla will"
+    _ " display whatever is in this field at the top of every"
+    _ " HTML page. The HTML you put in this field is not wrapped or"
+    _ " enclosed in anything. You might want to wrap it inside a"
+    _ "<tt>&lt;div&gt;</tt>. Give the div <em>id=\"message\"</em> to get"
+    _ " green text inside a red box, or <em>class=\"bz_private\"</em> for"
+    _ " dark red on a red background.  Anything defined in "
+    _ " <tt>skins/standard/global.css</tt> or <tt>skins/custom/global.css</tt>"
+    _ " will work.  To get centered text, use <em>style=\"text-align: "
+    _  " center;\"</em>.",
+
+  upgrade_notification => 
+    "$terms.Bugzilla can inform you when a new release is available."
+    _ " The notification will appear on the $terms.Bugzilla homepage,"
+    _ " for administrators only."
+    _ " <ul><li>'development_snapshot' notifies you about the development "
+    _ " snapshot that has been released.</li>"
+    _ " <li>'latest_stable_release' notifies you about the most recent"
+    _ " release available on the most recent stable branch. This branch"
+    _ " may be different from the branch your installation is based on.</li>"
+    _ " <li>'stable_branch_release' notifies you only about new releases"
+    _ " corresponding to the branch your installation is based on."
+    _ " If you are running a release candidate, you will get a notification"
+    _ " for newer release candidates too.</li>"
+    _ " <li>'disabled' will never notify you about new releases and no"
+    _ " connection will be established to a remote server.</li></ul>"
+    _ " <p>Note that if your $terms.Bugzilla server requires a proxy to"
+    _ " access the Internet, you may also need to set the <tt>proxy_url</tt>"
+    _ " parameter in the Advanced section.</p>",
+} %]

diff --git a/template/en/default/admin/params/groupsecurity.html.tmpl b/template/en/default/admin/params/groupsecurity.html.tmpl
new file mode 100644 (file)
index 0000000..7e30f07
--- /dev/null
+++ b/template/en/default/admin/params/groupsecurity.html.tmpl
@@ -0,0 +1,46 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[%
+   title = "Group Security"
+   desc = "Decide how you will use Security Groups"
+%]
+
+[% param_descs = {
+  makeproductgroups => "If this is on, $terms.Bugzilla will associate $terms.abug group " _
+                       "with each product in the database, and use it for querying ${terms.bugs}.",
+
+  chartgroup => "The name of the group of users who can use the 'New Charts' " _
+                "feature. Administrators should ensure that the public categories " _
+                "and series definitions do not divulge confidential information " _
+                "before enabling this for an untrusted population. If left blank, " _
+                "no users will be able to use New Charts.",
+
+  insidergroup => "The name of the group of users who can see/change private " _
+                  "comments and attachments.",
+
+  timetrackinggroup => "The name of the group of users who can see/change time tracking " _
+                       "information.",
+
+  querysharegroup => "The name of the group of users who can share their " _
+                     "saved searches with others.",
+
+  debug_group => "The name of the group of users who can view the actual " _
+                 "SQL query generated when viewing $terms.bug lists and reports.",
+
+  usevisibilitygroups => "Do you wish to restrict visibility of users to members of " _
+                         "specific groups?",
+  
+  strict_isolation => "Don't allow users to be assigned to, " _
+                      "be qa-contacts on, " _
+                      "be added to CC list, " _
+                      "or make or remove dependencies " _
+                      "involving any bug that is in a product on which that " _
+                      "user is forbidden to edit.", 
+
+ }
+%]

diff --git a/template/en/default/admin/params/index.html.tmpl b/template/en/default/admin/params/index.html.tmpl
new file mode 100644 (file)
index 0000000..65aa398
--- /dev/null
+++ b/template/en/default/admin/params/index.html.tmpl
@@ -0,0 +1,38 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+<p>
+  All parameters are displayed below, per section.
+  If you cannot find one from here, then the parameter does not exist.
+</p>
+
+<div align="center">
+  <table>
+    <tr>
+      <th>Parameter</th>
+      <th>Section</th>
+    </tr>
+    [% FOREACH panel = panels %]
+      [% FOREACH param = panel.param_list.sort('name') %]
+        <tr>
+          <td>
+            <a href="editparams.cgi?section=
+              [%- panel.name FILTER uri %]#[% param.name FILTER uri %]_desc">
+              [% param.name FILTER html %]</a>
+          </td>    
+          <td>
+            [% panel.title FILTER html %]
+          </td>
+        </tr>
+      [% END %]
+      <tr>
+        <td>&nbsp;</td><td>&nbsp;</td>
+      </tr>
+    [% END %]
+  </table>
+</div>

diff --git a/template/en/default/admin/params/ldap.html.tmpl b/template/en/default/admin/params/ldap.html.tmpl
new file mode 100644 (file)
index 0000000..64b3dbd
--- /dev/null
+++ b/template/en/default/admin/params/ldap.html.tmpl
@@ -0,0 +1,45 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[%
+   title = "LDAP"
+   desc = "Configure this first before choosing LDAP as an authentication method"
+%]
+
+[% param_descs = {
+  LDAPserver => "The name (and optionally port) of your LDAP server " _
+                "(e.g. ldap.company.com, or ldap.company.com:portnum). " _
+                "URI syntax can also be used, such as "_
+                "ldaps://ldap.company.com (for a secure connection) or " _
+                "ldapi://%2fvar%2flib%2fldap_sock (for a socket-based " _
+                "local connection. Multiple hostnames or URIs can be comma " _
+                "separated; each will be tried in turn until a connection is " _
+                "established.",
+
+  LDAPstarttls => "Whether to require encrypted communication once a normal " _
+                  "LDAP connection is achieved with the server.",
+
+  LDAPbinddn => "If your LDAP server requires that you use a binddn and password " _
+                "instead of binding anonymously, enter it here " _
+                "(e.g. cn=default,cn=user:password). " _
+                "Leave this empty for the normal case of an anonymous bind.",
+
+  LDAPBaseDN => "The BaseDN for authenticating users against " _
+                "(e.g. ou=People,o=Company).",
+
+  LDAPuidattribute => "The name of the attribute containing the user's login name.",
+
+  LDAPmailattribute => "The name of the attribute of a user in your " _
+                       "directory that contains the email address, to be " _
+                       "used as $terms.Bugzilla username. If this parameter " _
+                       "is empty, $terms.Bugzilla will use the LDAP username"_
+                       " as the $terms.Bugzilla username. You may also want" _
+                       " to set the \"emailsuffix\" parameter, in this case.",
+
+  LDAPfilter => "LDAP filter to AND with the <tt>LDAPuidattribute</tt> for " _
+                "filtering the list of valid users." }
+%]

diff --git a/template/en/default/admin/params/mta.html.tmpl b/template/en/default/admin/params/mta.html.tmpl
new file mode 100644 (file)
index 0000000..f491a30
--- /dev/null
+++ b/template/en/default/admin/params/mta.html.tmpl
@@ -0,0 +1,67 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[%
+   title = "Email"
+   desc = "How will outgoing mail be delivered?"
+%]
+
+[% param_descs = {
+  mail_delivery_method => "Defines how email is sent, or if it is sent at all.<br>
+                           <ul>
+                             <li>
+                               'Sendmail', 'SMTP' and 'Qmail' are all MTAs.
+                               You need to install a third-party sendmail replacement if
+                               you want to use sendmail on Windows.
+                             </li>
+                             <li>
+                               'Test' is useful for debugging: all email is stored
+                               in 'data/mailer.testfile' instead of being sent.
+                             </li>
+                             <li>
+                               'none' will completely disable email. $terms.Bugzilla continues
+                               to act as though it is sending mail, but nothing is sent or
+                               stored.
+                             </li>
+                           </ul>",
+
+  mailfrom => "The email address of the $terms.Bugzilla mail daemon.  Some email systems " _
+              "require this to be a valid email address.",
+
+  use_mailer_queue => "In a large $terms.Bugzilla installation, updating"
+    _ " $terms.bugs can be very slow, because $terms.Bugzilla sends all"
+    _ " email at once. If you enable this parameter, $terms.Bugzilla will"
+    _ " queue all mail and then send it in the background. This requires"
+    _ " that you have installed certain Perl modules (as listed by"
+    _ " <kbd>checksetup.pl</kbd> for this feature), and that you are"
+    _ " running the <code>jobqueue.pl</code> daemon (otherwise your mail"
+    _ " won't get sent). This affects all mail sent by $terms.Bugzilla,"
+    _ " not just $terms.bug updates.",
+
+  smtpserver => "The SMTP server address (if using SMTP for mail delivery).",
+
+  smtp_username => "The username to pass to the SMTP server for SMTP authentication. " _
+                   "Leave this field empty if your SMTP server doesn't require authentication.",
+
+  smtp_password => "The password to pass to the SMTP server for SMTP authentication. " _
+                   "This field has no effect if the smtp_username parameter is left empty.",
+
+  smtp_ssl => "Enable SSL support for SMTP.",
+
+  smtp_debug => "If enabled, this will print detailed information to your" _
+                " web server's error log about the communication between" _
+                " $terms.Bugzilla and your SMTP server. You can use this to" _
+                " troubleshoot email problems.",
+
+  whinedays => "The number of days that we'll let a $terms.bug sit untouched in a CONFIRMED " _
+               "state before our cronjob will whine at the owner.<br> " _
+               "Set to 0 to disable whining.",
+
+  globalwatchers => "A comma-separated list of users who should receive a " _
+                    "copy of every notification mail the system sends." }
+
+%]

diff --git a/template/en/default/admin/params/patchviewer.html.tmpl b/template/en/default/admin/params/patchviewer.html.tmpl
new file mode 100644 (file)
index 0000000..61d32a0
--- /dev/null
+++ b/template/en/default/admin/params/patchviewer.html.tmpl
@@ -0,0 +1,51 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[%
+   title = "Patch Viewer"
+   desc = "Set up third-party applications to run with PatchViewer"
+%]
+
+[% param_descs = {
+  cvsroot => "The <a href=\"http://www.cvshome.org\">CVS</a> root that most " _
+             "users of your system will be using for 'cvs diff'. Used in " _
+             "Patch Viewer ('Diff' option on patches) to figure out where " _
+             "patches are rooted even if users did the 'cvs diff' from " _
+             "different places in the directory structure. (NOTE: if your " _
+             "CVS repository is remote and requires a password, you must " _
+             "either ensure the $terms.Bugzilla user has done a 'cvs login' or " _
+             "specify the password " _
+             "<a href=\"http://www.cvshome.org/docs/manual/cvs_2.html#SEC26\">as " _
+             "part of the CVS root</a>.) Leave this blank if you have no " _
+             "CVS repository.",
+
+  cvsroot_get => "The CVS root $terms.Bugzilla will be using to get patches from. " _
+                 "Some installations may want to mirror their CVS repository on " _
+                 "the $terms.Bugzilla server or even have it on that same server, and " _
+                 "thus the repository can be the local file system (and much " _
+                 "faster). Make this the same as cvsroot if you don't " _
+                 "understand what this is (if cvsroot is blank, make this blank too).",
+
+  bonsai_url => "The URL to a <a href=\"http://www.mozilla.org/bonsai.html\">Bonsai</a> " _
+                "server containing information about your CVS repository. " _
+                "Patch Viewer will use this information to create links to " _
+                "bonsai's blame for each section of a patch (it will append " _
+                "'/cvsblame.cgi?...' to this url). Leave this blank if you " _
+                "don't understand what this is.",
+
+  lxr_url => "The URL to an <a href=\"http://sourceforge.net/projects/lxr\">LXR</a> server " _
+             "that indexes your CVS repository. Patch Viewer will use this " _
+             "information to create links to LXR for each file in a patch. " _
+             "Leave this blank if you don't understand what this is.",
+
+  lxr_root => "Some LXR installations do not index the CVS repository from the root -- " _
+              "<a href=\"http://lxr.mozilla.org/mozilla\">Mozilla's</a>, for " _
+              "example, starts indexing under <code>mozilla/</code>. This " _
+              "means URLs are relative to that extra path under the root. " _
+              "Enter this if you have a similar situation. Leave it blank " _
+              "if you don't know what this is." }
+%]

diff --git a/template/en/default/admin/params/query.html.tmpl b/template/en/default/admin/params/query.html.tmpl
new file mode 100644 (file)
index 0000000..f6cc464
--- /dev/null
+++ b/template/en/default/admin/params/query.html.tmpl
@@ -0,0 +1,64 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[%
+   title = "Query Defaults"
+   desc = "Default options for query and $terms.bug lists"
+%]
+
+[% param_descs = {
+  quip_list_entry_control => "Controls how easily users can add entries to the quip list.
+                              <ul>
+                                <li>
+                                  open - Users may freely add to the quip list, and
+                                  their entries will immediately be available for viewing.
+                                </li>
+                                <li>
+                                  moderated - quips can be entered, but need to be approved
+                                  by a moderator before they will be shown.
+                                </li>
+                                <li>
+                                  closed - no new additions to the quips list are allowed.
+                                </li>
+                              </ul>",
+
+  mostfreqthreshold => "The minimum number of duplicates $terms.abug needs to show up on the " _
+                       "<a href=\"duplicates.cgi\">most frequently reported $terms.bugs page</a>. " _
+                       "If you have a large database and this page takes a long time to " _
+                       "load, try increasing this number.",
+
+  mybugstemplate => "This is the URL to use to bring up a simple 'all of my $terms.bugs' " _
+                    "list for a user. %userid% will get replaced with the login name of a user.",
+
+  defaultquery => "This is the default query that initially comes up when you " _
+                  "access the advanced query page. It's in URL parameter " _
+                  "format, which makes it hard to read. Sorry!",
+
+  search_allow_no_criteria =>
+    "Unless the code explicitly allows all $terms.bugs to be returned, this " _
+    "parameter permits to block the execution of queries with no criteria. " _
+    "When turned off, a query must have some criteria specified to limit " _
+    "the number of $terms.bugs returned to the user. When turned on, a user " _
+    "is allowed to run a query with no criteria and get all $terms.bugs he can " _
+    "see in his list. Turning this parameter on is not recommended on large " _
+    "installations.",
+
+  default_search_limit =>
+    "By default, $terms.Bugzilla limits searches done in the web"
+    _ " interface to returning only this many results, for performance"
+    _ " reasons. (This only affects the HTML format of search results--CSV,"
+    _ " XML, and other formats are exempted.) Users can click a link on the"
+    _ " search result page to see all the results."
+    _ "<p>Usually you should not have to change this--the default value"
+    _ " should be acceptable for almost most installations.</p>",
+
+  max_search_results =>
+    "The maximum number of $terms.bugs that a search can"
+    _ " <strong>ever</strong> return. Tabular and graphical reports"
+    _ " are exempted from this limit, however.",
+
+} %]

diff --git a/template/en/default/admin/params/radius.html.tmpl b/template/en/default/admin/params/radius.html.tmpl
new file mode 100644 (file)
index 0000000..5ac291a
--- /dev/null
+++ b/template/en/default/admin/params/radius.html.tmpl
@@ -0,0 +1,43 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[%
+   title = "RADIUS"
+   desc = "Configure this first before choosing RADIUS as an authentication method"
+%]
+
+[% param_descs = {
+  RADIUS_server => "The name (and optionally port) of your RADIUS server " _
+                   "(e.g. <code>radius.company.com</code>, or " _
+                   "<code>radius.company.com:portnum</code>).<br>" _
+                   "Required only if " _
+                   "<a href=\"?section=auth#user_verify_class_desc\">the " _
+                   "<code>user_verify_class</code> parameter</a> contains " _
+                   "<code>RADIUS</code>.",
+
+  RADIUS_secret => "Your RADIUS server's secret.<br>" _
+                   "Required only if " _
+                   "<a href=\"?section=auth#user_verify_class_desc\">the " _
+                   "<code>user_verify_class</code> parameter</a> contains " _
+                   "<code>RADIUS</code>.",
+
+  RADIUS_NAS_IP => "The NAS-IP-Address attribute to be used when exchanging " _
+                   "data with your RADIUS server. " _
+                   "If unspecified, <code>127.0.0.1</code> will be used.<br>" _
+                   "Useful only if " _
+                   "<a href=\"?section=auth#user_verify_class_desc\">the " _
+                   "<code>user_verify_class</code> parameter</a> " _
+                   "contains <code>RADIUS</code>.",
+
+  RADIUS_email_suffix => "Suffix to append to a RADIUS user name to form an " _
+                         "e-mail address.<br>" _
+                         "Useful only if " _
+                         "<a href=\"?section=auth#user_verify_class_desc\">the " _
+                         "<code>user_verify_class</code> parameter</a> " _
+                         "contains <code>RADIUS</code>.",
+  }
+%]

diff --git a/template/en/default/admin/params/shadowdb.html.tmpl b/template/en/default/admin/params/shadowdb.html.tmpl
new file mode 100644 (file)
index 0000000..9f9f314
--- /dev/null
+++ b/template/en/default/admin/params/shadowdb.html.tmpl
@@ -0,0 +1,36 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[%
+   title = "Shadow Database"
+   desc = "An optional hack to increase database performance"
+%]
+
+[% param_descs = {
+  shadowdbhost => "The host the shadow database is on.",
+
+  shadowdbport => "The port the shadow database is on. Ignored if " _
+                  "<tt>shadowdbhost</tt> is blank. Note: if the host is the local " _
+                  "machine, then MySQL will ignore this setting, and you must " _
+                  "specify a socket below.",
+
+  shadowdbsock => "The socket used to connect to the shadow database, if the host " _
+                  "is the local machine. This setting is required because MySQL " _
+                  "ignores the port specified by the client and connects using " _
+                  "its compiled-in socket path (on unix machines) when connecting " _
+                  "from a client to a local server. If you leave this blank, and " _
+                  "have the database on localhost, then the <tt>shadowdbport</tt> " _
+                  "will be ignored.",
+
+  shadowdb => "If non-empty, then this is the name of another database in " _
+              "which $terms.Bugzilla will use as a read-only copy of everything. " _
+              "This is done so that long slow read-only operations can be used " _
+              "against this db, and not lock up things for everyone else. This " _
+              "database is on the <tt>shadowdbhost</tt>, and must exist. " _
+              "$terms.Bugzilla does not update it, if you use this parameter, then " _
+              "you need to set up replication for your database." }
+%]

diff --git a/template/en/default/admin/params/usermatch.html.tmpl b/template/en/default/admin/params/usermatch.html.tmpl
new file mode 100644 (file)
index 0000000..ebbc363
--- /dev/null
+++ b/template/en/default/admin/params/usermatch.html.tmpl
@@ -0,0 +1,29 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[%
+   title = "User Matching"
+   desc = "Set up your user matching policies"
+%]
+
+[% param_descs = {
+  usemenuforusers => "If this option is set, $terms.Bugzilla will offer you a list " _
+                     "to select from (instead of a text entry field) where a user " _
+                     "needs to be selected. This option should not be enabled on " _
+                     "sites where there are a large number of users.",
+
+  ajax_user_autocompletion => "If this option is set, typing characters in a certain user " _
+                              "fields will display a list of matches that can be selected from.", 
+
+  maxusermatches => "Search for no more than this many matches.<br> " _
+                    "If set to '1', no users will be displayed on ambiguous matches. " _
+                    "This is useful for user privacy purposes.<br> " _
+                    "A value of zero means no limit.",
+
+  confirmuniqueusermatch => "Whether a confirmation screen should be displayed when only " _
+                            "one user matches a search entry." }
+%]

diff --git a/template/en/default/admin/products/confirm-delete.html.tmpl b/template/en/default/admin/products/confirm-delete.html.tmpl
new file mode 100644 (file)
index 0000000..eb1094f
--- /dev/null
+++ b/template/en/default/admin/products/confirm-delete.html.tmpl
@@ -0,0 +1,259 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # product: Bugzilla::Product object; The product
+  #
+  # (classification fields available if Param('useclassification') is enabled:)
+  #
+  # classification: Bugzilla::Classification object; The classification 
+  #                                                  the product is in
+  #
+  #%]
+
+[% title = BLOCK %]Delete Product '[% product.name FILTER html %]'
+[% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+  style_urls = ['skins/standard/admin.css']
+%]
+
+<table border="1" cellpadding="4" cellspacing="0">
+  <tr bgcolor="#6666FF">
+    <th valign="top" align="left">Field</th>
+    <th valign="top" align="left">Value</th>
+  </tr>
+
+  [% IF Param('useclassification') %]
+    <tr>
+      <td>Classification:</td>
+      <td>[% classification.name FILTER html %]</td>
+    </tr>
+    <tr>
+      <td>Classification Description:</td>
+      [%# descriptions are intentionally not filtered to allow html content %]
+      <td>
+        [% IF classification.description %]
+          [% classification.description FILTER html_light %]
+        [% ELSE %]
+          <span style="color: red">missing</span>
+        [% END %]
+      </td>
+    </tr>
+  [% END %]
+
+  <tr>
+    <td valign="top">Product:</td>
+    <td valign="top">
+      <a href="editproducts.cgi?product=[% product.name FILTER uri %]">
+        [% product.name FILTER html %]
+      </a>
+    </td>
+  </tr>
+  <tr>
+    <td valign="top">Description:</td>
+    [%# descriptions are intentionally not filtered to allow html content %]
+    <td valign="top">
+      [% IF product.description %]
+        [% product.description FILTER html_light %]
+      [% ELSE %]
+        <span style="color: red">missing</span>
+      [% END %]
+    </td>
+  </tr>
+
+  [% IF Param('usetargetmilestone') %]
+    <tr>
+      <td>Milestone URL:</td>
+      <td>
+        [% IF product.milestone_url %]
+          <a href="[% product.milestone_url FILTER html %]">
+            [%- product.milestone_url FILTER html %]
+          </a>
+        [% ELSE %]
+          none
+        [% END %]
+      </td>
+    </tr>
+  [% END %]
+
+  <tr>
+    <td>Closed for [% terms.bugs %]:</td>
+    <td>
+      [% IF product.is_active %]
+        open
+      [% ELSE %]
+        closed
+      [% END %]
+    </td>
+  </tr>
+
+  <tr>
+    <td>
+      [% IF product.components.size > 0 %]
+        <a href="editcomponents.cgi?product=[% product.name FILTER uri %]"
+           title="Edit components for product '[% product.name FILTER html %]'">
+          Components:
+        </a>
+      [% ELSE %]
+        Components:
+      [% END %]
+    </td>
+    <td>
+      [% IF product.components.size > 0 %]
+        <table>
+          [% FOREACH c = product.components %]
+            <tr>
+              <th align="right">[% c.name FILTER html %]:</th>
+              [%# descriptions are intentionally not filtered to allow html content %]
+              <td>
+                [% IF c.description %]
+                  [% c.description FILTER html_light %]
+                [% ELSE %]
+                  <span style="color: red">missing</span>
+                [% END %]
+              </td>
+            </tr>
+          [% END %]
+        </table>
+      [% ELSE %]
+        none
+      [% END %]
+    </td>
+  </tr>
+
+  <tr>
+    <td>
+      [% IF product.versions.size > 0 %]
+        <a href="editversions.cgi?product=[%- product.name FILTER uri %]">
+          Versions:
+        </a>
+      [% ELSE %]
+        Versions:
+      [% END %]
+    </td>
+    <td>
+      [% IF product.versions.size > 0 %]
+        [% FOREACH v = product.versions %]
+          [% v.name FILTER html %]<br>
+        [% END %]
+      [% ELSE %]
+        none
+      [% END %]
+    </td>
+  </tr>
+
+
+  [% IF Param('usetargetmilestone') %]
+    <tr>
+      <td valign="top">
+        [% IF product.milestones.size > 0 %]
+          <a href="editmilestones.cgi?product=[%- product.name FILTER uri %]">
+            Milestones:
+          </a>
+        [% ELSE %]
+          Milestones:
+        [% END %]
+      </td>
+      <td>
+        [% IF product.milestones.size > 0 %]
+          [% FOREACH m = product.milestones %]
+            [% m.name FILTER html %]<br>
+          [% END %]
+        [% ELSE %]
+          none
+        [% END %]
+      </td>
+    </tr>
+  [% END %]
+
+  <tr>
+    <td>[% terms.Bugs %]:</td>
+    <td>
+      [% IF product.bug_count %]
+        <a href="buglist.cgi?product=[% product.name FILTER uri %]"
+           title="List of [% terms.bugs %] for product '[% product.name FILTER html %]'">
+          [% product.bug_count FILTER html %]
+        </a>
+      [% ELSE %]
+        none
+      [% END %]
+    </td>
+  </tr>
+</table>
+
+<h2>Confirmation</h2>
+
+[% IF product.bug_count %]
+
+  [% IF !Param("allowbugdeletion") %]
+
+    <p class="confirmation">Sorry, there
+
+    [% IF product.bug_count > 1 %]
+      are [% product.bug_count FILTER html %] [%+ terms.bugs %]
+    [% ELSE %]
+      is 1 [% terms.bug %]
+    [% END %]
+
+    outstanding for this product. You must reassign
+
+    [% IF product.bug_count > 1 %]
+       those [% terms.bugs %]
+    [% ELSE %]
+       that [% terms.bug %]
+    [% END %]
+
+    to another product before you can delete this one.</p>
+
+  [% ELSE %]
+
+    <table border="0" cellpadding="20" width="70%" bgcolor="red">
+      <tr>
+        <td>
+          There
+          [% IF product.bug_count > 1 %]
+            are [% product.bug_count FILTER html %] [%+ terms.bugs %]
+          [% ELSE %]
+            is 1 [% terms.bug %]
+          [% END %]
+          entered for this product!  When you delete this
+          product, <b>ALL</b> stored [% terms.bugs %] and
+          their history will be deleted, too.
+        </td>
+      </tr>
+    </table>
+
+  [% END %]
+
+[% END %]
+
+[% Hook.process("confirmation") %]
+
+[% IF product.bug_count == 0 || Param('allowbugdeletion') %]
+
+  <p>Do you really want to delete this product?</p>
+
+  <form method="post" action="editproducts.cgi">
+    <input type="checkbox" id="delete_series" name="delete_series" value=1>
+    <label for="delete_series">
+      Delete all related series (you can also delete them later, by visiting
+      the <a href="chart.cgi?category=[% product.name FILTER html %]">New Charts page</a>.)
+    </label><p>
+    <input type="submit" id="delete" value="Yes, delete">
+    <input type="hidden" name="action" value="delete">
+    <input type="hidden" name="product" value="[% product.name FILTER html %]">
+    <input type="hidden" name="token" value="[% token FILTER html %]">
+  </form>
+
+[% END %]
+
+[% PROCESS admin/products/footer.html.tmpl %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/products/create.html.tmpl b/template/en/default/admin/products/create.html.tmpl
new file mode 100644 (file)
index 0000000..6d40095
--- /dev/null
+++ b/template/en/default/admin/products/create.html.tmpl
@@ -0,0 +1,74 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # classification: Bugzilla::Classification object; If classifications
+  #                         are enabled, then this is 
+  #                         the currently selected classification
+  #
+  #%]
+
+[% title = BLOCK %]Add Product[% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+  style_urls = ['skins/standard/admin.css']
+  javascript_urls = ['js/util.js', 'js/field.js']
+  yui = [ 'autocomplete' ]
+%]
+
+[% DEFAULT
+  product.is_active = 1,
+  version = "unspecified",
+  product.defaultmilestone = constants.DEFAULT_MILESTONE
+  product.allows_unconfirmed = 1
+%]
+
+<form method="post" action="editproducts.cgi">
+  <table border="0" cellpadding="4" cellspacing="0">
+
+    [% PROCESS "admin/products/edit-common.html.tmpl" %]
+
+    <tr>
+      <th align="right">Version:</th>
+      <td><input size="20" maxlength="64" name="version" 
+                value="[% version FILTER html %]">
+      </td>
+    </tr>
+    <tr>
+      <th align="right">Create chart datasets for this product:</th>
+      <td>
+        <input type="checkbox" name="createseries" value="1" checked="checked">
+      </td>
+    </tr>
+
+    <tr>
+      <td colspan="2">&nbsp;</td>
+    </tr>
+    <tr>
+      <td colspan="2">
+        This product must have at least one component.
+        You will be able to create additional components later:
+      </td>
+    </tr>
+
+    [% PROCESS "admin/components/edit-common.html.tmpl" desc_name = "comp_desc" %]
+  </table>
+
+  <input type="submit" id="add-product" value="Add">
+  <input type="hidden" name="action" value="new">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+  <input type="hidden" name="classification"
+        value="[% classification.name FILTER html %]">
+</form>
+
+[% PROCESS "admin/products/footer.html.tmpl"
+   no_add_product_link = 1 
+   no_edit_product_link = 1 %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/products/edit-common.html.tmpl b/template/en/default/admin/products/edit-common.html.tmpl
new file mode 100644 (file)
index 0000000..2b76c44
--- /dev/null
+++ b/template/en/default/admin/products/edit-common.html.tmpl
@@ -0,0 +1,72 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # product: Bugzilla::Product object; The product
+  #
+  # classification: Bugzilla::Classifiation object; classification product is in.
+  #%]
+
+[% IF Param('useclassification') %]
+  <tr>
+    <th align="right">Classification:</th>
+    <td><b>[% classification.name FILTER html %]</b></td>
+  </tr>
+[% END %]
+    
+<tr>
+  <th align="right">Product:</th>
+  <td><input size="64" maxlength="64" name="product" 
+             value="[% product.name FILTER html %]">
+  </td>
+</tr>
+<tr>
+  <th align="right">Description:</th>
+  <td><textarea rows="4" cols="64" wrap="virtual" name="description">
+        [% product.description FILTER html %]</textarea>
+  </td>
+</tr>
+
+<tr>
+  <th align="right">Open for [% terms.bug %] entry:</th>
+  <td><input type="checkbox" name="is_active" value="1"
+       [% ' checked="checked"' IF product.is_active %]>
+  </td>
+</tr>
+<tr>
+  <th align="right">
+    <label for="allows_unconfirmed">Enable the
+      [%+ display_value('bug_status', 'UNCONFIRMED') FILTER html %] status
+      in this product:</label>
+  </th>
+  <td><input type="checkbox" id="allows_unconfirmed" name="allows_unconfirmed"
+             [% ' checked="checked"' IF product.allows_unconfirmed %]>
+  </td>
+</tr>
+
+[% IF Param('usetargetmilestone') -%]
+  <tr>
+    <th align="right">Default milestone:</th>
+    <td>
+      [% IF product.milestones.size %]
+        <select name="defaultmilestone">
+          [% FOREACH m = product.milestones %]
+            <option value="[% m.name FILTER html %]"
+                    [% " selected=\"selected\"" IF m.name == product.defaultmilestone %]>
+              [%- m.name FILTER html -%]</option>
+          [% END %]
+        </select>
+      [% ELSE %]
+        <input type="text" size="64" maxlength="64" name="defaultmilestone"
+               value="[% product.defaultmilestone FILTER html %]">
+      [% END %]
+    </td>
+  </tr>
+[% END %]
+    
+[% Hook.process('rows') %]

diff --git a/template/en/default/admin/products/edit.html.tmpl b/template/en/default/admin/products/edit.html.tmpl
new file mode 100644 (file)
index 0000000..c385301
--- /dev/null
+++ b/template/en/default/admin/products/edit.html.tmpl
@@ -0,0 +1,142 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # product: Bugzilla::Product object; The product
+  #
+  # (classification fields available if Param('useclassification') is enabled:)
+  #
+  # classification: Bugzilla::Classification object; The classification 
+  #                                                  the product is in
+  #%]
+
+[% title = BLOCK %]Edit Product '[% product.name FILTER html %]'[% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+  style_urls = ['skins/standard/admin.css']
+  javascript_urls = ['js/util.js']
+%]
+
+[% group_control = {${constants.CONTROLMAPNA}        => 'NA',
+                    ${constants.CONTROLMAPSHOWN}     => 'Shown',
+                    ${constants.CONTROLMAPDEFAULT}   => 'Default',
+                    ${constants.CONTROLMAPMANDATORY} => 'Mandatory'}
+ %]
+
+<form method="post" action="editproducts.cgi">
+  <table border="0" cellpadding="4" cellspacing="0">
+
+    [% PROCESS "admin/products/edit-common.html.tmpl" %]
+
+    <tr>
+      <th align="right" valign="top">
+        <a href="editcomponents.cgi?product=[% product.name FILTER uri %]">
+        Edit components:
+        </a>
+      </th>
+      <td>
+        [% IF product.components.size -%]
+          [% FOREACH component = product.components %]
+            <a href="editcomponents.cgi?action=edit&product=
+            [%- product.name FILTER uri %]&component=
+            [%- component.name FILTER uri %]">[% component.name FILTER html %]</a>:&nbsp;
+            [% IF component.description %]
+              [% component.description FILTER html_light %]
+            [% ELSE %]
+              <font color="red">description missing</font>
+            [% END %]
+            <br>
+          [% END %]
+        [% ELSE %]
+          <font color="red">missing</font>
+        [% END %]
+      </td>
+    </tr>
+    <tr>
+      <th align="right" valign="top">
+        <a href="editversions.cgi?product=[% product.name FILTER uri %]">Edit
+versions:</a>
+      </th>
+      <td>
+        [%- IF product.versions.size -%]
+          [% FOREACH v = product.versions %]
+            [% v.name FILTER html %]
+            <br>
+          [% END %]
+        [% ELSE %]
+          <font color="red">missing</font>
+        [% END %]
+      </td>
+    </tr>
+    [% IF Param('usetargetmilestone') %]
+      <tr>
+        <th align="right" valign="top">
+          <a href="editmilestones.cgi?product=[% product.name FILTER uri %]">
+          Edit milestones:</a>
+        </th>
+        <td>
+          [%- IF product.milestones.size -%]
+            [%- FOREACH m = product.milestones -%]
+              [% m.name FILTER html %]
+            <br>
+            [% END %]
+          [% ELSE %]
+            <font color="red">missing</font>
+          [% END %]
+        </td>
+      </tr>
+    [% END %]
+    <tr>
+      <th align="right" valign="top">
+        <a href="editproducts.cgi?action=editgroupcontrols&product=
+          [%- product.name FILTER uri %]">
+          Edit Group Access Controls:
+        </a>
+      </th>
+      <td>
+        [% IF product.group_controls.size %]
+          [% FOREACH g = product.group_controls.values.sort("name") %]
+            <b>[% g.group.name FILTER html %]:</b>&nbsp;
+            [% IF g.group.isactive %]
+              [% group_control.${g.membercontrol} FILTER html %]/
+              [% group_control.${g.othercontrol} FILTER html %]
+              [% IF g.entry %], ENTRY[% END %]
+              [% IF g.canedit %], CANEDIT[% END %]
+              [% IF g.editcomponents %], editcomponents[% END %]
+              [% IF g.canconfirm %], canconfirm[% END %]
+              [% IF g.editbugs %], editbugs[% END %]
+            [% ELSE %]
+              DISABLED
+            [% END %]
+            <br>
+          [% END %]
+        [% ELSE %]
+          no groups
+        [% END %]
+      </td>
+    </tr>
+    <tr>
+      <th align="right">[% terms.Bugs %]:</th>
+      <td><a href="buglist.cgi?product=[% product.name FILTER uri %]">
+            [% product.bug_count FILTER html %]</a></td>
+    </tr>
+  </table>
+  
+  <input type="hidden" name="product_old_name" 
+        value="[% product.name FILTER html %]">
+  <input type="hidden" name="action" value="update">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+  <input type="submit" id="update-product" value="Save Changes">
+</form>
+  
+[% PROCESS "admin/products/footer.html.tmpl"
+   no_add_product_link = 1 
+   no_edit_product_link = 1 %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/products/footer.html.tmpl b/template/en/default/admin/products/footer.html.tmpl
new file mode 100644 (file)
index 0000000..689c5c9
--- /dev/null
+++ b/template/en/default/admin/products/footer.html.tmpl
@@ -0,0 +1,79 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # product: Bugzilla::Product Object; the product
+  #
+  # classification: Bugzilla::Classification object ; If classifications
+  #                         are enabled, then this is the currently 
+  #                         selected classification
+  #
+  # no_XXX_link: boolean; if defined, then don't show the corresponding
+  #                       link. Supported parameters are:
+  #
+  # no_edit_product_link
+  # no_edit_other_products_link
+  # no_add_product_link
+  #%]
+
+[% IF Param('useclassification') && classification %]
+  [% classification_url_part = BLOCK %]&classification=
+     [%- classification.name FILTER uri %]
+  [% END %]
+  [% classification_url_part_start = BLOCK %]classification=
+     [%- classification.name FILTER uri %]
+  [% END %]
+  [% classification_text = BLOCK %] 
+    of classification '[% classification.name FILTER html %]'
+  [% END %]
+[% END %]
+
+<hr>
+
+<p>
+[% UNLESS no_add_product_link || !user.in_group("editcomponents") %]
+  <a title="Add a product"
+     href="editproducts.cgi?action=add">Add</a> a product[% -%]
+[%# Strictly speaking, we should not have to check for a
+    classification if they are enabled, but I'm just being paranoid %]
+  [% IF Param('useclassification') && classification %]
+    (<a title="Add a product to classification '
+               [%- classification.name FILTER html %]'"
+         href="editproducts.cgi?action=add
+               [%- classification_url_part %]">to
+     classification '[% classification.name FILTER html %]'</a>)
+  [% END %].
+[% END %]
+
+[% IF product && !no_edit_product_link %]
+  Edit product <a 
+  title="Edit Product '[% product.name FILTER html %]' 
+         [%- classification_text %]"
+  href="editproducts.cgi?action=edit&amp;product=[% product.name FILTER uri %]">
+        '[% product.name FILTER html %]'</a>.
+[% END %]
+
+
+[%# Edit other products (in a classification if specified): %]
+[% UNLESS no_edit_other_products_link %]
+  Edit <a 
+  href="editproducts.cgi?
+        [%- classification_url_part_start FILTER none %]">other products
+          [% classification_text %]</a>.
+
+[% END %]
+
+[% IF Param('useclassification') && classification
+      && user.in_group('editclassifications') %]
+  Edit classification <a href="editclassifications.cgi?action=edit
+    [%- classification_url_part %]">'
+    [%- classification.name FILTER html %]'</a>.
+
+[% END %]
+
+</p>

diff --git a/template/en/default/admin/products/groupcontrol/confirm-edit.html.tmpl b/template/en/default/admin/products/groupcontrol/confirm-edit.html.tmpl
new file mode 100644 (file)
index 0000000..fc3ad9b
--- /dev/null
+++ b/template/en/default/admin/products/groupcontrol/confirm-edit.html.tmpl
@@ -0,0 +1,42 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% title = BLOCK %]
+  Confirm Group Control Change for product '[%- product.name FILTER html %]'
+[% END %]
+
+[% PROCESS global/header.html.tmpl title = title %]
+[% FOREACH group = mandatory_groups %]
+<P>
+group '[% group.name FILTER html %]' impacts [% group.count %] 
+[%+ terms.bugs %] for
+which the group is newly mandatory and will be added.
+[% END %]
+
+[% FOREACH group = na_groups %]
+<P>
+group '[% group.name FILTER html %]' impacts [% group.count %]&nbsp;
+[% terms.bugs %] for which the group is no longer applicable and will
+be removed.[% END %]
+<form action="editproducts.cgi" method="post" >
+
+  [% PROCESS "global/hidden-fields.html.tmpl" exclude="^Bugzilla_(login|password)$" %]
+
+  <br>
+     Click "Continue" to proceed with the change including the changes
+     indicated above.  If you do not want these changes, use "back" to
+     return to the previous page.
+  <p>
+    <input type="hidden" name="confirmed" value="confirmed">
+    <input type="submit" id="update" value="Continue">
+  </p>
+
+</form>
+
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/products/groupcontrol/edit.html.tmpl b/template/en/default/admin/products/groupcontrol/edit.html.tmpl
new file mode 100644 (file)
index 0000000..889647e
--- /dev/null
+++ b/template/en/default/admin/products/groupcontrol/edit.html.tmpl
@@ -0,0 +1,303 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% title = BLOCK %]
+    Edit Group Controls for [% product.name FILTER html %]
+[% END %]
+[% PROCESS global/header.html.tmpl 
+   title = title 
+%]
+
+[% display_headers = 1 %]
+[% FOREACH group = product.group_controls(1).values.sort("name") %]
+  [% NEXT UNLESS group.group.isactive OR group.bug_count %]
+  [% IF display_headers %]
+    [% display_headers = 0 %]
+    <form method="post" action="editproducts.cgi">
+      <input type="hidden" name="action" value="updategroupcontrols">
+      <input type="hidden" name="product" value="[% product.name FILTER html %]">
+      <input type="hidden" name="token" value="[% token FILTER html %]">
+
+      <table id="form" cellspacing="0" cellpadding="4" border="1">
+        <tr bgcolor="#6666ff">
+          <th>Group</th>
+          <th>Entry</th>
+          <th>MemberControl</th>
+          <th>OtherControl</th>
+          <th>Canedit</th>
+          <th>editcomponents</th>
+          <th>canconfirm</th>
+          <th>editbugs</th>
+          <th>[% terms.Bugs %]</th>
+        </tr>
+  [% END %]
+  [% IF !group.group.isactive %]
+    <tr bgcolor="#bbbbbb">
+      <td>[% group.group.name FILTER html %]</td>
+      <td align="center" colspan="7">Disabled</td>
+      <td>[% group.bug_count FILTER html %]</td>
+    </tr>
+  [% ELSE %]
+    <tr>
+      <td>[% group.group.name FILTER html %]</td>
+      <td>
+        <input type=checkbox value=1 name=entry_[% group.id %]
+          [% " checked='checked'" IF group.entry %]>
+      </td>
+      <td>
+        <select name="membercontrol_[% group.id %]">
+          <option value=[% constants.CONTROLMAPNA %]
+            [% " selected='selected'" IF group.membercontrol == constants.CONTROLMAPNA %]
+            >NA
+          </option>
+          <option value=[% constants.CONTROLMAPSHOWN %]
+            [% " selected='selected'" IF group.membercontrol == constants.CONTROLMAPSHOWN %]
+            >Shown
+          </option>
+          <option value=[% constants.CONTROLMAPDEFAULT %]
+            [% " selected='selected'" IF group.membercontrol == constants.CONTROLMAPDEFAULT %]
+            >Default
+          </option>
+          <option value=[% constants.CONTROLMAPMANDATORY %]
+            [% " selected='selected'" IF group.membercontrol == constants.CONTROLMAPMANDATORY %]
+            >Mandatory
+          </option>
+        </select>
+      </td>
+      <td>
+        <select name="othercontrol_[% group.id %]">
+          <option value=[% constants.CONTROLMAPNA %]
+            [% " selected='selected'" IF group.othercontrol == constants.CONTROLMAPNA %]
+            >NA
+          </option>
+          <option value=[% constants.CONTROLMAPSHOWN %]
+            [% " selected='selected'" IF group.othercontrol == constants.CONTROLMAPSHOWN %]
+            >Shown
+          </option>
+          <option value=[% constants.CONTROLMAPDEFAULT %]
+            [% " selected='selected'" IF group.othercontrol == constants.CONTROLMAPDEFAULT %]
+            >Default
+          </option>
+          <option value=[% constants.CONTROLMAPMANDATORY %]
+            [% " selected='selected'" IF group.othercontrol == constants.CONTROLMAPMANDATORY %]
+            >Mandatory
+          </option>
+        </select>
+      </td>
+      <td>
+        <input type=checkbox value=1 name=canedit_[% group.id %]
+        [% " checked='checked'" IF group.canedit %]>
+      </td>
+      <td>
+        <input type=checkbox value=1 name=editcomponents_[% group.id %]
+        [% " checked='checked'" IF group.editcomponents %]>
+      </td>
+      <td>
+        <input type=checkbox value=1 name=canconfirm_[% group.id %]
+        [% " checked='checked'" IF group.canconfirm %]>
+      </td>
+      <td>
+        <input type=checkbox value=1 name=editbugs_[% group.id %]
+        [% " checked='checked'" IF group.editbugs %]>
+      </td>
+      <td>[% group.bug_count || 0 FILTER html %]</td>
+    </tr>
+  [% END %]
+[% END %]
+
+[% IF display_headers %]
+  <p>No groups are available for products.
+  [% IF user.in_group('creategroups') %]
+    <a href="editgroups.cgi?action=add">Create a new group</a>
+  [% END %]
+  </p>
+[% ELSE %]
+    </table>
+    <br>
+    <input type=submit name="submit" value="submit">
+  </form>
+[% END %]
+
+<p>
+These settings control the relationship of the groups to this
+product.
+</p>
+<p>
+If any group has <b>Entry</b> selected, then this product will
+restrict [% terms.bug %] entry to only those users who are members of all the
+groups with entry selected.
+</p>
+<p>
+If any group has <b>Canedit</b> selected, then this product
+will be read-only for any users who are not members of all of
+the groups with Canedit selected. ONLY users who are members of
+all the canedit groups will be able to edit. This is an additional
+restriction that further restricts what can be edited by a user.
+</p>
+<p>
+The following settings control let you choose privileges on a <b>per-product basis</b>.
+This is a convenient way to give privileges to some users for some products
+only, without having to give them global privileges which would affect all
+products:
+</p>
+<p>
+Any group having <b>editcomponents</b> selected allows users who are
+in this group to edit all aspects of this product, including components,
+milestones and versions.
+</p>
+<p>
+Any group having <b>canconfirm</b> selected allows users who are
+in this group to confirm [% terms.bugs %] in this product.
+</p>
+<p>
+Any group having <b>editbugs</b> selected allows users who are
+in this group to edit all fields of [% terms.bugs %] in this product.
+</p>
+<p>
+The <b>MemberControl</b> and <b>OtherControl</b> fields
+indicate which [% terms.bugs %] will be placed in
+this group according to the following definitions.
+</p>
+
+<table border=1>
+  <tr>
+    <th>
+      MemberControl
+    </th>
+    <th>
+      OtherControl
+    </th>
+    <th>
+      Interpretation
+    </th>
+  </tr>
+  <tr>
+    <td>
+      NA
+    </td>
+    <td>
+      NA
+    </td>
+    <td>
+      [% terms.Bugs %] in this product are never associated with this group.
+    </td>
+  </tr>
+  <tr>
+    <td>
+      Shown
+    </td>
+    <td>
+      NA
+    </td>
+    <td>
+      [% terms.Bugs %] in this product are permitted to be restricted to this
+      group.  Users who are members of this group will be able to place [% terms.bugs %] in
+      this group.
+    </td>
+  </tr>
+  <tr>
+    <td>
+      Shown
+    </td>
+    <td>
+      Shown
+    </td>
+    <td>
+      [% terms.Bugs %] in this product can be placed in this group by anyone
+      with permission to edit the [% terms.bug %] even if they are not a member
+      of this group.
+    </td>
+  </tr>
+  <tr>
+    <td>
+      Shown
+    </td>
+    <td>
+      Default
+    </td>
+    <td>
+      [% terms.Bugs %] in this product can be placed in this group by anyone
+      with permission to edit the [% terms.bug %] even if they are not a member
+      of this group. Non-members place [% terms.bugs %] in this group by default.
+    </td>
+  </tr>
+  <tr>
+    <td>
+      Shown
+    </td>
+    <td>
+      Mandatory
+    </td>
+    <td>
+      [% terms.Bugs %] in this product are permitted to be restricted to this
+      group.  Users who are members of this group will be able to place [% terms.bugs %]
+       in this group.  Non-members will be forced to restrict [% terms.bugs %] to
+       this group when they initially enter [% terms.abug %] in this product.
+    </td>
+  </tr>
+  <tr>
+    <td>
+      Default
+    </td>
+    <td>
+      NA
+    </td>
+    <td>
+      [% terms.Bugs %] in this product are permitted to be restricted to this
+      group and are placed in this group by default.  Users who are members of this
+      group will be able to place [% terms.bugs %] in this group.
+    </td>
+  </tr>
+  <tr>
+    <td>
+      Default
+    </td>
+    <td>
+      Default
+    </td>
+    <td>
+      [% terms.Bugs %] in this product are permitted to be restricted to this
+      group and are placed in this group by default.  Users who are members of this group
+      will be able to place [% terms.bugs %] in this group.  Non-members will be
+      able to restrict [% terms.bugs %] to this group on entry and will do so by default.
+    </td>
+  </tr>
+  <tr>
+    <td>
+      Default
+    </td>
+    <td>
+      Mandatory
+    </td>
+    <td>
+      [% terms.Bugs %] in this product are permitted to be restricted to this
+      group and are placed in this group by default.  Users who are members of this group
+      will be able to place [% terms.bugs %] in this group. Non-members will be forced
+      to place [% terms.bugs %] in this group on entry.
+    </td>
+  </tr>
+  <tr>
+    <td>
+      Mandatory
+    </td>
+    <td>
+      Mandatory
+    </td>
+    <td>
+      [% terms.Bugs %] in this product are required to be restricted to this
+      group.  Users are not given any option.
+    </td>
+  </tr>
+</table>
+<p>
+Please note that the above table delineates the only allowable combinations
+for the <b>MemberControl</b> and <b>OtherControl</b> field settings.
+Attempting to submit a combination not listed there (e.g. Mandatory/NA,
+Default/Shown, etc.) will produce an error message.
+</p>
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/products/groupcontrol/updated.html.tmpl b/template/en/default/admin/products/groupcontrol/updated.html.tmpl
new file mode 100644 (file)
index 0000000..5ee066c
--- /dev/null
+++ b/template/en/default/admin/products/groupcontrol/updated.html.tmpl
@@ -0,0 +1,42 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # product: Bugzilla::Product object; the product.
+  # changes: Hashref with changes made to the product group controls.
+  #%]
+
+[% title = BLOCK %]
+    Update group access controls for [% product.name FILTER html %]
+[% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+%]
+<p>
+[% IF changes._group_controls.now_na.size %]
+  [% FOREACH g = changes._group_controls.now_na %]
+    Removing [% terms.bugs %] from group '[% g.name FILTER html %]' which
+    no longer applies to this product<p>
+    [% g.bug_count FILTER html %] [%+ terms.bugs %] removed<p>
+  [% END %]
+[% END %]
+
+[% IF changes._group_controls.now_mandatory.size %]
+  [% FOREACH g = changes._group_controls.now_mandatory %]
+    Adding [% terms.bugs %] to group '[% g.name FILTER html %]' which is 
+    mandatory for this product<p>
+    [% g.bug_count FILTER html %] [%+ terms.bugs %] added<p>
+  [% END %]
+[% END %]
+
+Group control updates done<p>
+
+[% PROCESS admin/products/footer.html.tmpl %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/products/list-classifications.html.tmpl b/template/en/default/admin/products/list-classifications.html.tmpl
new file mode 100644 (file)
index 0000000..ea32a00
--- /dev/null
+++ b/template/en/default/admin/products/list-classifications.html.tmpl
@@ -0,0 +1,58 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # classifications: array of hashes having the following properties:
+  #   - name: string; The name of the classification
+  #   - description: string; The classification description (html allowed)
+  #   - product_count: number; The number of products in this classification
+  #
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = "Select Classification"
+%]
+
+[% columns = [
+     { 
+       name => "name"
+       heading => "Edit products of..."
+       contentlink => 'editproducts.cgi?classification=%%name%%'
+     },
+     { 
+       name => "description"
+       heading => "Description"
+       allow_html_content => 1
+     },
+     { 
+       name => "product_count"
+       align => "right"
+       heading => "Product Count"
+     }
+   ]
+%]
+
+[% IF user.in_group('editcomponents') %]
+  [% columns.push({
+       heading => "Action..."
+       content => "Add product"
+       contentlink => 'editproducts.cgi?action=add&classification=%%name%%' })
+  %]
+[% END %]
+
+[% Hook.process('before_table') %]
+
+[% PROCESS admin/table.html.tmpl
+     columns = columns
+     data = classifications
+%]
+
+[%# No need for the standard edit products footer, as we have an 'add'
+    link in the table %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/products/list.html.tmpl b/template/en/default/admin/products/list.html.tmpl
new file mode 100644 (file)
index 0000000..a5126af
--- /dev/null
+++ b/template/en/default/admin/products/list.html.tmpl
@@ -0,0 +1,86 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # products: array of Bugzilla::Product objects 
+  #
+  # classification: Bugzilla::Classification object; If classifications
+  #                         are enabled, then this is 
+  #                         the currently selected classification
+  # showbugcounts: boolean; true if bug counts should be included in the table
+  #%]
+
+[% IF classification %]
+  [% classification_url_part = BLOCK %]&classification=
+    [%- classification.name FILTER uri %]
+  [%- END %]
+  [% classification_title = BLOCK %] 
+    in classification '[% classification.name FILTER html %]'
+  [% END %]
+[% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = "Select product $classification_title"
+%]
+
+[% columns = [
+     { 
+       name => "name"
+       heading => "Edit product..."
+       contentlink => 'editproducts.cgi?action=edit&product=%%name%%'
+     },
+     { 
+       name => "description"
+       heading => "Description"
+       allow_html_content => 1
+     },
+     { 
+       name => "is_active"
+       heading => "Open For New $terms.Bugs"
+       yesno_field => 1
+     },
+] %]
+
+[% IF showbugcounts %]
+
+  [% columns.push({
+       name => "bug_count"
+       heading => "$terms.Bug Count"
+       align => 'right'
+       contentlink => 'buglist.cgi?product=%%name%%'
+     })
+  %]
+
+[% END %]
+
+[% columns.push({
+       heading => "Action"
+       content => "Delete"
+       contentlink => 'editproducts.cgi?action=del&product=%%name%%'
+     })
+%]
+
+[% Hook.process('before_table') %]
+
+[% PROCESS admin/table.html.tmpl
+     columns = columns
+     data = products
+%]
+
+[% IF !showbugcounts %]
+
+  <p><a href="editproducts.cgi?showbugcounts=1[% classification_url_part %]">
+      Redisplay table with [% terms.bug %] counts (slower)</a></p>
+
+[% END %]
+
+[% PROCESS admin/products/footer.html.tmpl
+    no_edit_other_products_link = 1
+ %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/products/updated.html.tmpl b/template/en/default/admin/products/updated.html.tmpl
new file mode 100644 (file)
index 0000000..4d22801
--- /dev/null
+++ b/template/en/default/admin/products/updated.html.tmpl
@@ -0,0 +1,90 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # product : Bugzilla::Product Object; new product.
+  # classification: Bugzilla::Classification Object; The product classification (may be empty or missing)
+  # changes: hashref with all changes made to the product. Each key is an edited field,
+  #          and its value is an arrayref of the form [old values, new values].
+  #%]
+
+[% IF classification %]
+  [% classification_text = BLOCK %]
+    of classification '[% classification.name FILTER html %]'
+  [% END %]
+[% END %]
+
+[% title = BLOCK %]Updating Product '[% product.name FILTER html %]' 
+                   [% classification_text FILTER none %][% END %]
+[% PROCESS global/header.html.tmpl
+  title = title
+  style_urls = ['skins/standard/admin.css']
+%]
+
+[% IF changes.name.defined %]
+  <p>
+  Updated product name from '[% changes.name.0 FILTER html %]' to
+  '<a href="editproducts.cgi?action=edit&amp;product=
+  [%- product.name FILTER uri %]">[% product.name FILTER html %]</a>'.
+  </p>
+[% END %]
+
+
+[% IF changes.description.defined %]
+  <p>
+    Updated description to:
+  </p>
+  <p style="margin: 1em 3em 1em 3em">[% product.description FILTER html_light %]</p>
+[% END %]
+
+[% IF changes.isactive.defined %]
+  <p>
+  Product is now
+  [% IF product.is_active %]
+    open for
+  [% ELSE %]
+    closed to 
+  [% END %]
+  new [% terms.bugs %].
+  </p>
+[% END %]
+
+[% IF changes.defaultmilestone.defined %]
+  <p>
+  Updated default milestone from '[% changes.defaultmilestone.0 FILTER html %]' to
+  '[% product.default_milestone FILTER html %]'.
+  </p>
+[% END %]
+
+[% IF changes.allows_unconfirmed.defined %]
+  <p>
+  [% IF product.allows_unconfirmed %]
+    The product now allows the 
+    [%+ display_value('bug_status', 'UNCONFIRMED') FILTER html %] status.
+  [% ELSE %]
+    The product no longer allows the 
+    [%+ display_value('bug_status', 'UNCONFIRMED') FILTER html %] status.
+    Note that any 
+    <a href="buglist.cgi?product=
+            [%- product.name FILTER uri %]&amp;bug_status=UNCONFIRMED"> 
+    [%- terms.bugs %] that currently have the 
+    [%+ display_value('bug_status', 'UNCONFIRMED') FILTER html %] status</a>
+    will remain in that status until they are edited.
+  [% END %]
+  </p>
+[% END %]
+
+[% Hook.process('changes') %]
+
+[% IF !changes.keys.size %]
+  <p>Nothing changed for product '[% product.name FILTER html %]'.</p>
+[% END %]
+
+[% PROCESS admin/products/footer.html.tmpl %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/sanitycheck/list.html.tmpl b/template/en/default/admin/sanitycheck/list.html.tmpl
new file mode 100644 (file)
index 0000000..6814662
--- /dev/null
+++ b/template/en/default/admin/sanitycheck/list.html.tmpl
@@ -0,0 +1,26 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS global/header.html.tmpl title = "Sanity Check"
+                                   style_urls = ['skins/standard/admin.css'] %]
+
+<div>
+  <p>
+    [% terms.Bugzilla %] is checking the referential integrity of your database.
+    This may take several minutes to complete.
+  </p>
+
+  <p>
+    Errors, if any, will be <span class="alert">emphasized like this</span>.
+    Depending on the errors found, some links will be displayed allowing you
+    to easily fix them. Fixing these errors will automatically run this script
+    again (so be aware that it may take an even longer time than the first run).
+  </p>
+</div>
+
+<hr>

diff --git a/template/en/default/admin/sanitycheck/messages.html.tmpl b/template/en/default/admin/sanitycheck/messages.html.tmpl
new file mode 100644 (file)
index 0000000..bb5ca06
--- /dev/null
+++ b/template/en/default/admin/sanitycheck/messages.html.tmpl
@@ -0,0 +1,312 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% san_message = BLOCK %]
+  [% IF san_tag == "checks_start" %]
+    OK, now running sanity checks.
+
+  [% ELSIF san_tag == "checks_completed" %]
+    Sanity check completed.
+
+  [% ELSIF san_tag == "attachment_reference_deletion_start" %]
+    OK, now removing all references to deleted attachments.
+
+  [% ELSIF san_tag == "attachment_reference_deletion_end" %]
+    All references to deleted attachments have been removed.
+
+  [% ELSIF san_tag == "bug_check_alert" %]
+    [% errortext FILTER html %]: [% INCLUDE bug_list badbugs = badbugs %]
+
+  [% ELSIF san_tag == "bug_check_repair" %]
+    <a href="sanitycheck.cgi?[% param FILTER uri %]=1&amp;token=
+       [%- issue_hash_token(['sanitycheck']) FILTER uri %]">[% text FILTER html %]</a>.
+
+  [% ELSIF san_tag == "bug_check_creation_date" %]
+    Checking for [% terms.bugs %] with no creation date (which makes them invisible).
+
+  [% ELSIF san_tag == "bug_check_creation_date_error_text" %]
+    [% terms.Bugs %] with no creation date
+
+  [% ELSIF san_tag == "bug_check_creation_date_repair_text" %]
+    Repair missing creation date for these [% terms.bugs %]
+
+  [% ELSIF san_tag == "bug_check_bugs_fulltext" %]
+    Checking for [% terms.bugs %] with no entry for full text searching.
+
+  [% ELSIF san_tag == "bug_check_bugs_fulltext_error_text" %]
+    [% terms.Bugs %] with no entry for full text searching
+
+  [% ELSIF san_tag == "bug_check_bugs_fulltext_repair_text" %]
+    Repair missing full text search entries for these [% terms.bugs %]
+
+  [% ELSIF san_tag == "bug_check_res_dupl" %]
+    Checking resolution/duplicates
+
+  [% ELSIF san_tag == "bug_check_res_dupl_error_text" %]
+    [% terms.Bugs %] found on duplicates table that are not marked duplicate
+
+  [% ELSIF san_tag == "bug_check_res_dupl_error_text2" %]
+    [% terms.Bugs %] found marked resolved duplicate and not on duplicates table
+
+  [% ELSIF san_tag == "bug_check_status_res" %]
+    Checking statuses/resolutions
+
+  [% ELSIF san_tag == "bug_check_status_res_error_text" %]
+    [% terms.Bugs %] with open status and a resolution
+
+  [% ELSIF san_tag == "bug_check_status_res_error_text2" %]
+    [% terms.Bugs %] with non-open status and no resolution
+
+  [% ELSIF san_tag == "bug_check_status_everconfirmed" %]
+    Checking statuses/everconfirmed
+
+  [% ELSIF san_tag == "bug_check_status_everconfirmed_error_text" %]
+    [% terms.Bugs %] that are UNCONFIRMED but have everconfirmed set
+
+  [% ELSIF san_tag == "bug_check_status_everconfirmed_error_text2" %]
+    [% terms.Bugs %] with confirmed status but don't have everconfirmed set
+
+  [% ELSIF san_tag == "bug_check_control_values" %]
+    Checking for bad values in group_control_map
+
+  [% ELSIF san_tag == "bug_check_control_values_alert" %]
+    Found [% entries FILTER html %] bad group_control_map entries
+
+  [% ELSIF san_tag == "bug_check_control_values_violation" %]
+    Checking for [% terms.bugs %] with groups violating their product's group controls
+
+  [% ELSIF san_tag == "bug_check_control_values_error_text" %]
+    Have groups not permitted for their products
+
+  [% ELSIF san_tag == "bug_check_control_values_repair_text" %]
+    Permit the missing groups for the affected products
+    (set member control to <code>SHOWN</code>)
+
+  [% ELSIF san_tag == "bug_check_control_values_error_text2" %]
+    Are missing groups required for their products
+
+  [% ELSIF san_tag == "bug_creation_date_start" %]
+    OK, now fixing missing [% terms.bug %] creation dates.
+
+  [% ELSIF san_tag == "bug_creation_date_fixed" %]
+    [% bug_count FILTER html %] [%+ terms.bugs %] have been fixed.
+
+  [% ELSIF san_tag == "bugs_fulltext_start" %]
+    OK, now fixing [% terms.bug %] entries for full text searching.
+
+  [% ELSIF san_tag == "bugs_fulltext_fixed" %]
+    [% bug_count FILTER html %] [%+ terms.bugs %] have been fixed.
+
+  [% ELSIF san_tag == "bug_reference_deletion_start" %]
+    OK, now removing all references to deleted [% terms.bugs %].
+
+  [% ELSIF san_tag == "bug_reference_deletion_end" %]
+    All references to deleted [% terms.bugs %] have been removed.
+
+  [% ELSIF san_tag == "cross_check_to" %]
+    Checking references to [% table FILTER html %].[% field FILTER html %]...
+
+  [% ELSIF san_tag == "cross_check_from" %]
+    ... from [% table FILTER html %].[% field FILTER html %].
+
+  [% ELSIF san_tag == "cross_check_alert" %]
+    Bad value '[% value FILTER html %]' found in
+    [%+ table FILTER html %].[% field FILTER html %]
+    [% IF keyname %]
+      [% IF keyname == "bug_id" %]
+        ([% PROCESS bug_link bug_id = key %])
+      [% ELSE %]
+        ([% keyname FILTER html %] == '[% key FILTER html %]')
+      [% END %]
+    [% END %]
+
+  [% ELSIF san_tag == "cross_check_attachment_has_references" %]
+    <a href="sanitycheck.cgi?remove_invalid_attach_references=1&amp;token=
+       [%- issue_hash_token(['sanitycheck']) FILTER uri %]">Remove
+    invalid references to non existent attachments.</a>
+
+  [% ELSIF san_tag == "cross_check_bug_has_references" %]
+    <a href="sanitycheck.cgi?remove_invalid_bug_references=1&amp;token=
+       [%- issue_hash_token(['sanitycheck']) FILTER uri %]">Remove
+    invalid references to non existent [% terms.bugs %].</a>
+
+  [% ELSIF san_tag == "double_cross_check_to" %]
+    Checking references to [% table FILTER html %].[% field1 FILTER html %] /
+    [%+ table FILTER html %].[% field2 FILTER html %]...
+
+  [% ELSIF san_tag == "double_cross_check_from" %]
+    ... from [% table FILTER html %].[% field1 FILTER html %] /
+    [%+ table FILTER html %].[% field2 FILTER html %].
+
+  [% ELSIF san_tag == "double_cross_check_alert" %]
+    Bad values '[% value1 FILTER html %]', '[% value2 FILTER html %]' found
+    in [% table FILTER html %].[% field1 FILTER html %] /
+    [%+ table FILTER html %].[% field2 FILTER html %].
+    [% IF keyname %]
+      [% IF keyname == "bug_id" %]
+        ([% PROCESS bug_link bug_id = key %])
+      [% ELSE %]
+        ([% keyname FILTER html %] == '[% key FILTER html %]')
+      [% END %]
+    [% END %]
+
+  [% ELSIF san_tag == "everconfirmed_start" %]
+    OK, now fixing everconfirmed.
+
+  [% ELSIF san_tag == "everconfirmed_end" %]
+    everconfirmed fixed.
+
+  [% ELSIF san_tag == "flag_check_start" %]
+    Checking for flags being in the wrong product/component.
+
+  [% ELSIF san_tag == "flag_deletion_start" %]
+    OK, now deleting invalid flags.
+
+  [% ELSIF san_tag == "flag_deletion_end" %]
+    Invalid flags deleted.
+
+  [% ELSIF san_tag == "flag_alert" %]
+    Invalid flag [% flag_id FILTER html %] for
+    [% IF attach_id %]
+      attachment [% attach_id FILTER html %] in
+    [% END %]
+    [%+ PROCESS bug_link bug_id = bug_id %].
+
+  [% ELSIF san_tag == "flag_fix" %]
+    <a href="sanitycheck.cgi?remove_invalid_flags=1&amp;token=
+       [%- issue_hash_token(['sanitycheck']) FILTER uri %]">Click
+    here to delete invalid flags</a>
+
+  [% ELSIF san_tag == "group_control_map_entries_creation" %]
+    OK, now creating <code>SHOWN</code> member control entries
+    for product/group combinations lacking one.
+
+  [% ELSIF san_tag == "group_control_map_entries_update" %]
+    Updating <code>NA/<em>xxx</em></code> group control setting
+    for group <em>[% group_name FILTER html %]</em> to
+    <code>SHOWN/<em>xxx</em></code> in product
+    <em>[% product_name FILTER html %]</em>.
+
+  [% ELSIF san_tag == "group_control_map_entries_generation" %]
+    Generating <code>SHOWN/NA</code> group control setting
+    for group <em>[% group_name FILTER html %]</em> in product
+    <em>[% product_name FILTER html %]</em>.
+
+  [% ELSIF san_tag == "group_control_map_entries_repaired" %]
+    Repaired [% counter FILTER html %] defective group control settings.
+
+  [% ELSIF san_tag == "keyword_check_start" %]
+    Checking keywords table.
+
+  [% ELSIF san_tag == "keyword_check_alert" %]
+    Duplicate entry in keyworddefs for id [% id FILTER html %].
+
+  [% ELSIF san_tag == "keyword_check_invalid_name" %]
+    Bogus name in keyworddefs for id [% id FILTER html %].
+
+  [% ELSIF san_tag == "keyword_check_invalid_id" %]
+    Bogus keywordids [% id FILTER html %] found in keywords table.
+
+  [% ELSIF san_tag == "keyword_check_duplicated_ids" %]
+    Duplicate keyword IDs found in [% PROCESS bug_link bug_id = id %].
+
+  [% ELSIF san_tag == "profile_login_start" %]
+    Checking profile logins.
+
+  [% ELSIF san_tag == "product_alert" %]
+    Product <a href="editproducts.cgi?product=[% name FILTER html%]">
+    [%- name FILTER html %]</a> has no components or no versions.
+
+  [% ELSIF san_tag == "product_check_start" %]
+    Checking products with no components or versions.
+
+  [% ELSIF san_tag == "profile_login_alert" %]
+    Bad profile email address, id=[% id FILTER html %],
+    &lt;[% email FILTER html %]&gt;.
+
+  [% ELSIF san_tag == "repair_bugs" %]
+    Repair these [% terms.bugs %].
+
+  [% ELSIF san_tag == "send_bugmail_start" %]
+    OK, now attempting to send unsent mail.
+
+  [% ELSIF san_tag == "send_bugmail_status" %]
+    [% bug_count FILTER html %] [%+ terms.bugs %] found with
+    possibly unsent mail.
+
+  [% ELSIF san_tag == "send_bugmail_end" %]
+    Unsent mail has been sent.
+
+  [% ELSIF san_tag == "unsent_bugmail_check" %]
+    Checking for unsent mail
+
+  [% ELSIF san_tag == "unsent_bugmail_alert" %]
+    [% terms.Bugs %] that have changes but no mail sent for at least
+    half an hour: [% INCLUDE bug_list badbugs = badbugs %]
+
+  [% ELSIF san_tag == "unsent_bugmail_fix" %]
+    <a href="sanitycheck.cgi?rescanallBugMail=1&amp;token=
+       [%- issue_hash_token(['sanitycheck']) FILTER uri %]">Send these mails</a>.
+
+  [% ELSIF san_tag == "whines_obsolete_target_deletion_start" %]
+    OK, now removing non-existent users/groups from whines.
+
+  [% ELSIF san_tag == "whines_obsolete_target_deletion_end" %]
+    Non-existent users/groups have been removed from whines.
+
+  [% ELSIF san_tag == "whines_obsolete_target_start" %]
+    Checking for whines with non-existent users/groups.
+
+  [% ELSIF san_tag == "whines_obsolete_target_alert" %]
+    [% FOREACH schedule = schedules %]
+      Non-existent [% (type == constants.MAILTO_USER) ? "user" : "group" FILTER html %]
+      [%+ schedule.1 FILTER html %] for whine schedule [% schedule.0 FILTER html %]<br>
+    [% END %]
+
+  [% ELSIF san_tag == "whines_obsolete_target_fix" %]
+    <a href="sanitycheck.cgi?remove_old_whine_targets=1&amp;token=
+       [%- issue_hash_token(['sanitycheck']) FILTER uri %]">Click here to
+    remove old users/groups</a>
+
+  [% ELSE %]
+    [% message = Hook.process("statuses") %]
+
+    [% IF message %]
+      [% message FILTER none %]
+    [% ELSE %]
+      The status message string <code>[% san_tag FILTER html %]</code>
+      was not found. Please send email to [% Param("maintainer") %] describing
+      the steps taken to obtain this message.
+    [% END %]
+
+  [% END %]
+[% END %]
+
+[% USE Bugzilla %]
+[% IF Bugzilla.usage_mode == constants.USAGE_MODE_CMDLINE %]
+  [% san_message FILTER none %]
+[% ELSE %]
+  [%# Avoid the txt filter in message.txt.tmpl. %]
+  [% san_message FILTER html %]
+[% END %]
+
+[% BLOCK bug_list %]
+  [% FOREACH bug_id = badbugs %]
+    [%# Do not use FILTER bug_link() here, because bug_link() calls get_text()
+     # which itself calls this template again, generating a recursion error.
+     # I doubt having a tooltip with the bug status and summary is so
+     # important here anyway, as you can click the "(as buglist)" link. %]
+    <a href="show_bug.cgi?id=[% bug_id FILTER uri %]">[% bug_id FILTER html %]</a>
+    [% ", " IF !loop.last %]
+  [% END %]
+  (<a href="buglist.cgi?bug_id=[% badbugs.join(",") FILTER uri %]">as [% terms.bug %] list</a>).
+[% END %]
+
+[% BLOCK bug_link %]
+  <a href="show_bug.cgi?id=[% bug_id FILTER uri %]">[% terms.bug %] [%+ bug_id FILTER html %]</a>
+[% END %]

diff --git a/template/en/default/admin/settings/edit.html.tmpl b/template/en/default/admin/settings/edit.html.tmpl
new file mode 100644 (file)
index 0000000..411c527
--- /dev/null
+++ b/template/en/default/admin/settings/edit.html.tmpl
@@ -0,0 +1,93 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # settings:      a hash of hashes, keyed by setting name.
+  #                Each hash contains:
+  #                 is_enabled    - boolean
+  #                 default_value - string (global default for this setting)
+  #                 value         - string (user-defined preference)
+  #                 is_default    - boolean (true if user has no preference)
+  #%]
+
+[% PROCESS global/header.html.tmpl
+   title = "Default Preferences"
+ %]
+
+[% PROCESS "global/setting-descs.none.tmpl" %]
+
+<p>
+This lets you edit the default preferences values.
+</p>
+<p>
+The Default Value displayed for each preference will apply to all users who
+do not choose their own value, and to anyone who is not logged in.
+</p>
+<p>
+The 'Enabled' checkbox controls whether or not this preference is available
+to users.<br>
+If it is checked, users will see this preference on their User Preferences page,
+and will be allowed to choose their own value if they desire.<br>
+If it is not checked, this preference will not appear on the User Preference
+page, and the Default Value will automatically apply to everyone.
+</p>
+<hr>
+
+[% IF settings.size %]
+    <form name="adminsettingform" method="post" action="editsettings.cgi">
+      <table border="1" cellpadding="4">
+      <tr>
+        <th>Preference Text</th>
+        <th>Default Value</th>
+        <th>Enabled</th>
+      </tr>
+
+      [% FOREACH name = settings.keys %]
+          [% checkbox_name = name _ '-enabled' %]
+          <tr>
+            <td align="right">
+              [% setting_descs.$name OR name FILTER html %]
+            </td>
+            <td>
+              <select name="[% name FILTER html %]" id="[% name FILTER html %]">
+                [% FOREACH x = settings.${name}.legal_values %]
+                    <option value="[% x FILTER html %]"
+                      [% " selected=\"selected\"" IF x == settings.${name}.default_value %]>
+                      [% setting_descs.${x} OR x FILTER html %]
+                    </option>
+                [% END %]
+              </select>
+            </td>
+            <td align="center">
+              <input type="checkbox"
+                name="[% checkbox_name FILTER html %]"
+                id="[% checkbox_name FILTER html %]"
+                [% " checked=\"checked\"" IF settings.${name}.is_enabled %]>
+              <br>
+            </td>
+          </tr>
+      [% END %]
+      </table>
+
+    <input type="hidden" name="action" value="update">
+    <input type="hidden" name="token" value="[% token FILTER html %]">
+    <table>
+      <tr>
+        <td width="150"></td>
+        <td>
+          <input type="submit" id="update" value="Submit Changes">
+        </td>
+      </tr>
+    </table>
+  
+  </form>
+[% ELSE %]
+  There are no preferences to edit.
+[% END %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/sudo.html.tmpl b/template/en/default/admin/sudo.html.tmpl
new file mode 100644 (file)
index 0000000..bacffae
--- /dev/null
+++ b/template/en/default/admin/sudo.html.tmpl
@@ -0,0 +1,90 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+   title = "Begin sudo session"
+   style_urls = ['skins/standard/admin.css']
+   doc_section = "useradmin.html#impersonatingusers"
+ %]
+ 
+[% DEFAULT target_login = "" %]
+
+<p>
+  The <b>sudo</b> feature of [% terms.Bugzilla %] allows you to impersonate a 
+  user for a short time  While an sudo session is in progress, every action you 
+  perform will be taking place as if you had logged in as the user whom will be 
+  impersonating.
+</p>
+
+<p class="areyoureallyreallysure">
+  This is a very powerful feature; you should be very careful while using it.  
+  Your actions may be logged more carefully than normal.
+</p>
+
+<form action="relogin.cgi" method="POST">
+  <p>
+    To begin, 
+    [% IF Param('usemenuforusers') %]
+      select 
+    [% ELSE %]
+      enter the login of 
+    [% END %]
+    <label for="target_login">the <u>u</u>ser to impersonate</label>:
+    [% INCLUDE global/userselect.html.tmpl
+       id => "target_login"
+       name => "target_login"
+       value => target_login_default
+       accesskey => "u"
+       size => 30
+    %]
+  </p>
+  
+  [% IF !Param('usemenuforusers') %]
+    <p>
+      The username must be entered exactly.  No matching will be performed.
+    </p>
+  [% END %]
+  
+  <p>
+    Next, please take a moment to explain <label for="reason">why you are doing
+    this:<br>
+    <input type="text" id="reason" name="reason" size="80" maxlength="200"
+           value="[% reason_default FILTER html %]">
+  </p>
+  
+  <p>
+    The message you enter here will be sent to the impersonated user by email.
+    You may leave this empty if you wish, but they will still know that you 
+    are impersonating them.
+  </p>
+  
+  [% IF user.authorizer.can_login %]
+    <p>
+      Finally, enter <label for="Bugzilla_password">your [% terms.Bugzilla %]
+      password</label>:
+      <input type="hidden" name="Bugzilla_login" value="
+      [%- user.login FILTER html %]">
+      <input type="password" id="Bugzilla_password" name="Bugzilla_password" size="20">
+      <br>
+      This is done for two reasons.  First of all, it is done to reduce 
+      the chances of someone doing large amounts of damage using your 
+      already-logged-in account.  Second, it is there to force you to take the 
+      time to consider if you really need to use this feature.
+    </p>
+  [% END %]
+  
+  <p>
+    Click the button to begin the session:
+    <input type="submit" id="begin_sudo" value="Begin Session">
+    <input type="hidden" name="action" value="begin-sudo">
+    <input type="hidden" name="token" value="[% token FILTER html %]">
+  </p>
+
+</form>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/table.html.tmpl b/template/en/default/admin/table.html.tmpl
new file mode 100644 (file)
index 0000000..80f6417
--- /dev/null
+++ b/template/en/default/admin/table.html.tmpl
@@ -0,0 +1,164 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  #
+  # columns: 
+  #   array of hashes representing the columns in the table. 
+  #   Each hash contains data for a single column. Hash keys:
+  #     name: Name of the field in the data param
+  #     heading: The text to print at the header cell
+  #     contentlink: URI to which the content of a data cell shall be linked to.
+  #                  Expressions of format %%xxx%% are replaced with value
+  #                  with the key xxx in data hash of the current row.
+  #     content: If specified, the content of this variable is used
+  #              instead of the data pulled from the current row. 
+  #              NOTE: This value is only partially HTML filtered!
+  #     content_use_field: If defined and true, then each value in the 
+  #                        column corresponds with a key in the
+  #                        field_descs field, and that value from the 
+  #                        field_descs hash will be used instead of "content."
+  #                        See fieldvalues/select-field for an example of use.
+  #                        This content WILL be HTML-filtered in this case.
+  #     align: left/center/right. Controls the horizontal alignment of the
+  #            text in the column.
+  #     allow_html_content: if defined, then this column allows some html content
+  #                         and so it will be only partially filtered.
+  #     yesno_field: Turn the data from 0/!0 into Yes/No
+  #
+  # data:
+  #   array of hashes representing the data for the table.
+  #   Each hash contains data for a single row of data. The
+  #   keys are column names from columns subhashes name field.
+  #
+  # overrides:
+  # Example:
+  #     overrides {                           # first hash
+  #       column_name_to_be_overwriten => {   # second hash
+  #         name_of_row_to_match_against => { # third hash
+  #           value_to_match_against => {     # fourth hash
+  #             content => "some contents"
+  #             override_content => 1
+  #           }
+  #         }
+  #       }
+  #     }
+  #
+  #   Provides a method for overriding individual table cells. This is a hash
+  #   (1), whose key is the column name, so the column must be named for
+  #   one of it's cells to be overwritten. The hash value is another hash
+  #   (2). The keys of that second hash are the name of the row to match
+  #   against. The second hash then again points to another hash. Within this
+  #   third hash (3), the keys represent values to match against. The item
+  #   contains a fourth hash (4) specifying overridden values.
+  #   
+  #   Each column value mentioned in the 'columns' documentation above
+  #   can be overwritten (apart from name and heading). To override a
+  #   table-cell value 'xxx', specify a new 'xxx' value, and specify a
+  #   'override_xxx' value as well. See
+  #   admin/milestones/list.html.tmpl for example
+  #
+  #%]
+
+[%###################  TABLE HEADER   ######################%]
+
+<table id="admin_table" border="1" cellpadding="4" cellspacing="0">
+  <tr bgcolor="#6666FF">
+    [% FOREACH c = columns %]
+      [%# Default to align left for headers %]
+      <th align="[% (c.align || 'left') FILTER html %]">
+        [% c.heading FILTER html %]
+      </th>
+    [% END %]
+  </tr>
+
+
+[%###################  TABLE CONTENT  ######################%]
+
+[% FOREACH row = data %]
+
+  <tr>
+    [% FOREACH c = columns %]
+
+      [%# Copy to local variables, as we may update these %]
+      [% contentlink = c.contentlink
+         content = c.content
+         content_use_field = c.content_use_field
+         align = c.align
+         class = c.class
+         allow_html_content = c.allow_html_content
+         yesno_field = c.yesno_field
+       %]
+
+      [%# Get any specific "important" overrides for this c.name and row.name ? %]
+      [% SET important = overrides.${c.name}.name.${row.name} %]
+
+      [% IF important %]
+
+          [% FOREACH key IN important.keys %]
+             [% SET ${key} = important.${key} %]
+          [% END %]
+
+      [% ELSE %]
+
+          [%# Are there any specific overrides for this column? %]
+          [% FOREACH match_field = overrides.${c.name}.keys %]
+     
+              [% override = overrides.${c.name}.${match_field}.${row.$match_field} %]
+              [% NEXT UNLESS override %]
+
+              [% FOREACH key IN override.keys %]
+                  [% SET ${key} = override.${key} %]
+              [% END %]
+
+              [% LAST %]
+
+          [% END %]
+      [% END %]
+
+      <td [% IF align %] align="[% align FILTER html %]" [% END %]
+          [% IF class %] class="[% class FILTER html %]" [% END %]>
+
+        [% IF contentlink %]
+          [% FOREACH m = contentlink.match('%%(.+?)%%', 1) %]
+            [% replacement_value = FILTER uri; row.$m; END %]
+            [% contentlink = contentlink.replace("%%$m%%", replacement_value) %]
+          [% END %]
+          <a href="[% contentlink %]">
+        [% END %]
+
+        [% IF content_use_field %]
+          [% colname = row.${c.name} %]
+          [% field_descs.${colname} FILTER html %]
+        [% ELSIF content %]
+          [% content FILTER html_light %]
+        [% ELSIF yesno_field %]
+          [% row.${c.name} ? "Yes" : "No" %]
+        [% ELSIF allow_html_content %]
+          [% row.${c.name} FILTER html_light %]
+        [% ELSE %]
+          [% row.${c.name} FILTER html %]
+        [% END %]
+
+        [% IF contentlink %]
+          </a>
+        [% END %]
+         
+      </td>
+    [% END %]
+  </tr>
+[% END %]
+
+[% IF data.size == 0 %]
+  <tr><td colspan="[% columns.size %]" align="center"><i>&lt;none&gt;</i></td></tr>
+[% END %]
+
+
+[%###################  TABLE FOOTER   ######################%]
+
+</table>

diff --git a/template/en/default/admin/users/confirm-delete.html.tmpl b/template/en/default/admin/users/confirm-delete.html.tmpl
new file mode 100644 (file)
index 0000000..73a72d0
--- /dev/null
+++ b/template/en/default/admin/users/confirm-delete.html.tmpl
@@ -0,0 +1,471 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  #
+  # listselectionvalues:      selection values to recreate the current user
+  #                           list.
+  # editusers:                is viewing user member of editusers?
+  # otheruser:                Bugzilla::User object of the viewed user.
+  # reporter:                 number of bugs reported by the user
+  # assignee_or_qa:           number of bugs the user is either the assignee
+  #                           or the QA contact
+  # bugs_activity:            number of bugs the viewed user has activity
+  #                           entries on
+  # cc                        number of bugs the viewed user is cc list member
+  #                           of
+  # flags.requestee:          number of flags the viewed user is being asked for
+  # flags.setter:             number of flags the viewed user has set
+  # longdescs:                number of bug comments the viewed user has written
+  # namedqueries:             number of named queries the user has created
+  # namedquery_group_map:     number of named queries the user has shared
+  # profiles_activity:        number of changes made to other users' profiles
+  # series:                   number of series the viewed user has created
+  # watch.watched:            number of users the viewed user is being watched
+  #                           by
+  # watch.watcher:            number of users the viewed user is watching
+  # whine_events:             number of whine events the viewed user has created
+  # whine_schedules:          number of whine schedules the viewed user has
+  #                           created
+  #%]
+
+[% title = BLOCK %]Confirm deletion of user [% otheruser.login FILTER html %][% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+  style_urls = ['skins/standard/admin.css',
+                'skins/standard/editusers.css']
+  doc_section = "useradmin.html#user-account-deletion"
+%]
+
+[% PROCESS admin/users/listselectvars.html.tmpl
+  listselectionvalues = listselectionvalues
+%]
+
+<table class="main">
+  <tr>
+    <th>Login name:</th>
+    <td>[% otheruser.login FILTER html %]</td>
+  </tr>
+  <tr>
+    <th>Real name:</th>
+    <td>[% otheruser.name FILTER html %]</td>
+  </tr>
+  <tr>
+    <th>Group set:</th>
+    <td>
+      [% IF otheruser.groups.size %]
+        <ul>
+          [% FOREACH group = otheruser.groups %]
+            <li>[% group.name FILTER html %]</li>
+          [% END %]
+        </ul>
+      [% ELSE %]
+        None
+      [% END %]
+    </td>
+  </tr>
+  [% IF otheruser.product_responsibilities.size %]
+    <tr>
+      <th>Product responsibilities:</th>
+      <td>
+        [% PROCESS admin/users/responsibilities.html.tmpl otheruser = otheruser %]
+      </td>
+    </tr>
+  [% END %]
+</table>
+
+[% IF otheruser.product_responsibilities.size %]
+  <p>
+    You can't delete this user at this time because
+    [%+ otheruser.login FILTER html %] has got responsibilities for at least
+    one product.
+  </p>
+  <p>
+    [% IF user.in_group("editcomponents", component.product_id) %]
+      Change this by clicking the product editing links above,
+    [% ELSE %]
+      For now, you can
+    [% END %]
+[% ELSE %]
+  [% accept_deletion = 1 %]
+
+  [% IF attachments || reporter || bugs_activity || flags.setter || longdescs || profiles_activity %]
+    <div class="criticalmessages">
+      <p>The following deletions are <b>unsafe</b> and would generate referential
+      integrity inconsistencies!</p>
+
+      <ul>
+        [% IF attachments %]
+          <li>
+            [% otheruser.login FILTER html %]
+            <a href="buglist.cgi?field0-0-0=attachments.submitter&type0-0-0=equals&value0-0-0=
+               [%- otheruser.login FILTER uri %]">has submitted
+            [% IF attachments == 1 %]
+              one attachment
+            [% ELSE %]
+              [%+ attachments %] attachments
+            [% END %]</a>.
+            If you delete the user account, the database records will be
+            inconsistent, resulting in
+            [% IF attachments == 1 %]
+              this attachment
+            [% ELSE %]
+              these attachments
+            [% END %]
+            not appearing in [% terms.bugs %] any more.
+          </li>
+        [% END %]
+        [% IF reporter %]
+          <li>
+            [% otheruser.login FILTER html %]
+            <a href="buglist.cgi?emailreporter1=1&amp;emailtype1=exact&amp;email1=
+               [%- otheruser.login FILTER uri %]">has reported
+            [% IF reporter == 1 %]
+              one [% terms.bug %]
+            [% ELSE %]
+              [%+ reporter %] [%+ terms.bugs %]
+            [% END %]</a>.
+            If you delete the user account, the database records will be
+            inconsistent, resulting in
+            [% IF reporter == 1 %]
+              this [% terms.bug %]
+            [% ELSE %]
+              these [% terms.bugs %]
+            [% END %]
+            not appearing in [% terms.bug %] lists any more.
+          </li>
+        [% END %]
+        [% IF bugs_activity %]
+          <li>
+            [% otheruser.login FILTER html %] has made
+            [% IF bugs_activity == 1 %]
+              a change on [% terms.abug %]
+            [% ELSE %]
+              changes on [% terms.bugs %]
+            [% END %].
+            If you delete the user account, the [% terms.bugs %] activity table in
+            the database will be inconsistent, resulting in
+            [% IF bugs_activity == 1 %]
+              this change
+            [% ELSE %]
+              these changes
+            [% END %]
+            not showing up in [% terms.bug %] activity logs any more.
+          </li>
+        [% END %]
+        [% IF flags.setter %]
+          <li>
+            [% otheruser.login FILTER html %] has
+            <a href="buglist.cgi?field0-0-0=setters.login_name&amp;type0-0-0=equals&amp;value0-0-0=
+               [%- otheruser.login FILTER uri %]">set
+            or requested
+            [% IF flags.setter == 1 %]
+              a flag
+            [% ELSE %]
+              [%+ flags.setter %] flags
+            [% END %]</a>.
+            If you delete the user account, the flags table in the database
+            will be inconsistent, resulting in
+            [% IF flags.setter == 1 %]
+              this flag
+            [% ELSE %]
+              these flags
+            [% END %]
+            not displaying correctly any more.
+          </li>
+        [% END %]
+        [% IF longdescs %]
+          <li>
+            [% otheruser.login FILTER html %] has
+            <a href="buglist.cgi?emaillongdesc1=1&amp;emailtype1=exact&amp;email1=
+               [%- otheruser.login FILTER uri %]">commented
+            [% IF longdescs == 1 %]
+              once on [% terms.abug %]
+            [% ELSE %]
+              [%+ longdescs %] times on [% terms.bugs %]
+            [% END %]</a>.
+            If you delete the user account, the comments table in the database
+            will be inconsistent, resulting in
+            [% IF longdescs == 1 %]
+              this comment
+            [% ELSE %]
+              these comments
+            [% END %]
+            not being visible any more.
+          </li>
+        [% END %]
+        [% IF profiles_activity %]
+          <li>
+            [% otheruser.login FILTER html %] has made
+            [% IF bugs_activity == 1 %]
+              a change on a other user's profile
+            [% ELSE %]
+              changes on other users' profiles
+            [% END %].
+            If you delete the user account, the user profiles activity table in
+            the database will be inconsistent.
+          </li>
+        [% END %]
+      </ul>
+    </div>
+    [% accept_deletion = 0 %]
+  [% END %]
+
+  [% IF assignee_or_qa || cc || component_cc || email_setting || flags.requestee ||
+        namedqueries || profile_setting || quips || series || watch.watched ||
+        watch.watcher || whine_events || whine_schedules || otheruser.has_audit_entries ||
+        other_safe %]
+    <div class="warningmessages">
+      <p>The following deletions are <b>safe</b> and will not generate
+      referential integrity inconsistencies.</p>
+
+      <ul>
+        [% IF assignee_or_qa %]
+          <li>
+            [% otheruser.login FILTER html %]
+            <a href="buglist.cgi?emailassigned_to1=1&amp;emailqa_contact1=1&amp;emailtype1=exact&amp;email1=
+               [%- otheruser.login FILTER uri %]">is
+            the assignee or the QA contact of
+            [% IF assignee_or_qa == 1 %]
+              one [% terms.bug %]
+            [% ELSE %]
+              [%+ assignee_or_qa %] [%+ terms.bugs %]
+            [% END %]</a>.
+            If you delete the user account, these roles will fall back to
+            the default assignee or default QA contact.
+          </li>
+        [% END %]
+        [% IF cc %]
+          <li>
+            [% otheruser.login FILTER html %]
+            <a href="buglist.cgi?emailcc1=1&amp;emailtype1=exact&amp;email1=
+               [%- otheruser.login FILTER uri %]">is
+            on the CC list of
+            [% IF cc == 1 %]
+              [%+ terms.abug %]
+            [% ELSE %]
+              [%+ cc %] [%+ terms.bugs %]
+            [% END %]</a>.
+            If you delete the user account, it will be removed from these CC lists.
+          </li>
+        [% END %]
+        [% IF component_cc %]
+          <li>
+            [% otheruser.login FILTER html %] is on the default CC list of
+            [% IF component_cc == 1 %]
+              one component
+            [% ELSE %]
+              [%+ component_cc %] components
+            [% END %].
+            If you delete the user account, it will be removed from these CC lists.
+          </li>
+        [% END %]
+        [% IF email_setting %]
+          <li>
+            The user's e-mail settings will be deleted along with the user
+            account.
+          </li>
+        [% END %]
+        [% IF flags.requestee %]
+          <li>
+            [% otheruser.login FILTER html %] has been
+            <a href="buglist.cgi?field0-0-0=requestees.login_name&amp;type0-0-0=equals&amp;value0-0-0=
+               [%- otheruser.login FILTER uri %]">asked
+            to set
+            [% IF flags.requestee == 1 %]
+              a flag
+            [% ELSE %]
+              [% flags.requestee %] flags
+            [% END %]</a>.
+            If you delete the user account,
+            [% IF flags.requestee == 1 %]
+              this flag
+            [% ELSE %]
+              these flags
+            [% END %]
+            will change to be unspecifically requested.
+          </li>
+        [% END %]
+        [% IF namedqueries %]
+          <li>
+            [% otheruser.login FILTER html %] has
+            [% IF namedqueries == 1 %]
+              a [% 'shared' IF namedquery_group_map %] named search
+            [% ELSE %]
+              [%+ namedqueries FILTER html %] named searches
+            [% END %].
+            [% IF namedqueries == 1 %]
+              This named search
+            [% ELSE %]
+              These named searches
+            [% END %]
+            will be deleted along with the user account.
+            [% IF namedquery_group_map %]
+              [% IF namedqueries > 1 %]
+                Of these,
+                [% IF namedquery_group_map > 1 %]
+                  [%+ namedquery_group_map FILTER html %] are
+                [% ELSE %]
+                  one is
+                [% END %]
+                shared.
+              [% END %]
+              Other users will not be able to use
+              [% IF namedquery_group_map > 1 %]
+                these shared named searches
+              [% ELSE %]
+                this shared named search
+              [% END %]
+              any more.
+            [% END %]
+          </li>
+        [% END %]
+        [% IF profile_setting %]
+          <li>
+            The user's preference settings will be deleted along with the user
+            account.
+          </li>
+        [% END %]
+        [% IF series %]
+          <li>
+            [% otheruser.login FILTER html %] has created
+            [% IF series == 1 %]
+              a series
+            [% ELSE %]
+              [%+ series %] series
+            [% END %].
+            [% IF series == 1 %]
+              This series
+            [% ELSE %]
+              These series
+            [% END %]
+            will be deleted along with the user account.
+          </li>
+        [% END %]
+        [% IF quips %]
+          <li>
+            [% otheruser.login FILTER html %] has submitted
+            [% IF quips == 1 %]
+              a quip
+            [% ELSE %]
+              [%+ quips %] quips
+            [% END %].
+            If you delete the user account,
+            [% IF quips == 1 %]
+              this quip
+            [% ELSE %]
+              these quips
+            [% END %]
+            will have no author anymore, but will remain available.
+          </li>
+        [% END %]
+        [% IF watch.watched || watch.watcher %]
+          <li>
+            [% otheruser.login FILTER html %]
+            [% IF watch.watched %]
+              is being watched by
+              [% IF watch.watched == 1 %]
+                a user
+              [% ELSE %]
+                [%+ watch.watched %] users
+              [% END %]
+            [% END %]
+            [% IF watch.watcher %]
+              [%+ 'and' IF watch.watched %]
+              watches
+              [% IF watch.watcher == 1 %]
+                a user
+              [% ELSE %]
+                [%+ watch.watcher %] users
+              [% END %]
+            [% END %].
+            [% IF watch.watched + watch.watcher == 1 %]
+              This watching
+            [% ELSE %]
+              These watchings
+            [% END %]
+            will cease along with the deletion of the user account.
+          </li>
+        [% END %]
+        [% IF whine_events %]
+          <li>
+            [% otheruser.login FILTER html %] has scheduled
+            [% IF whine_events == 1 %]
+              a whine
+            [% ELSE %]
+              [%+ whine_events %] whines
+            [% END %].
+            [% IF whine_events == 1 %]
+              This whine
+            [% ELSE %]
+              These whines
+            [% END %]
+            will be deleted along with the user account.
+          </li>
+        [% END %]
+        [% IF whine_schedules %]
+          <li>
+            [% otheruser.login FILTER html %] is on the receiving end of
+            [% IF whine_schedules == 1 %]
+              a whine
+            [% ELSE %]
+              [%+ whine_schedules %] whines
+            [% END %].
+            The corresponding schedules will be deleted along with the user account,
+            but the whines themselves will be left unaltered.
+          </li>
+        [% END %]
+        [% IF otheruser.has_audit_entries %]
+          <li>
+            The user has performed audited administrative tasks
+            that are logged in the database.
+            If you delete this user account, the audit log entries
+            will no longer be indentifiable.
+          </li>
+        [% END %]
+        [% Hook.process('warn_safe') %]
+      </ul>
+    </div>
+
+    [% IF accept_deletion %]
+      <p class="areyoureallyreallysure">
+        Please be aware of the consequences of this before continuing.
+      </p>
+      <p>Do you really want to delete this user account?</p>
+
+      <form method="post" action="editusers.cgi">
+        <p>
+          <input type="submit" id="delete" value="Yes, delete"/>
+          <input type="hidden" name="action" value="delete" />
+          <input type="hidden" name="userid" value="[% otheruser.id %]" />
+          <input type="hidden" name="token" value="[% token FILTER html %]">
+          [% INCLUDE listselectionhiddenfields %]
+        </p>
+      </form>
+      <p>If you do not want to delete the user account at this time,
+    [% ELSE %]
+      <p><b>You cannot delete this user account</b> due to unsafe actions reported above. You can
+    [% END %]
+
+  [% END %]
+[% END %]
+
+  <a href="editusers.cgi?action=edit&amp;userid=[% otheruser.id %]
+           [% INCLUDE listselectionurlparams %]">edit the user</a>,
+  go
+ <a href="editusers.cgi?action=list[% INCLUDE listselectionurlparams %]">back
+  to the user list</a>,
+  [% IF editusers %]
+    <a href="editusers.cgi?action=add[% INCLUDE listselectionurlparams %]">add
+    a new user</a>,
+  [% END %]
+  or <a href="editusers.cgi">find other users</a>.
+</p>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/users/create.html.tmpl b/template/en/default/admin/users/create.html.tmpl
new file mode 100644 (file)
index 0000000..354ba5f
--- /dev/null
+++ b/template/en/default/admin/users/create.html.tmpl
@@ -0,0 +1,51 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  #
+  # listselectionvalues: selection values to recreate the current user list.
+  # editusers:           is viewing user member of editusers?
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = "Add user"
+  style_urls = ['skins/standard/editusers.css']
+  onload = "document.forms['f'].login.focus()"
+  doc_section = "useradmin.html#createnewusers"
+%]
+
+[% PROCESS admin/users/listselectvars.html.tmpl
+  listselectionvalues = listselectionvalues
+%]
+
+<form name="f" method="post" action="editusers.cgi">
+<table class="main">
+  [% PROCESS admin/users/userdata.html.tmpl
+    editform  = 0
+    editusers = editusers
+    otheruser = []
+  %]
+</table>
+<p>
+  <input type="submit" id="add" value="Add"/>
+  <input type="hidden" name="action" value="new" />
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+  [% INCLUDE listselectionhiddenfields %]
+</p>
+</form>
+
+<p>
+  You can also <a href="editusers.cgi">find a user</a>
+  [% IF listselectionvalues %],
+    or
+    <a href="editusers.cgi?action=list[% INCLUDE listselectionurlparams %]">go
+    back to the user list</a>
+  [% END %].
+</p>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/users/edit.html.tmpl b/template/en/default/admin/users/edit.html.tmpl
new file mode 100644 (file)
index 0000000..b75f840
--- /dev/null
+++ b/template/en/default/admin/users/edit.html.tmpl
@@ -0,0 +1,173 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  #
+  # message:             message tag specifying a global/messages.html.tmpl
+  #                      message
+  # listselectionvalues: selection values to recreate the current user list.
+  # editusers:           is viewing user member of editusers?
+  # otheruser:           Bugzilla::User object of viewed user.
+  # groups:              array of group information (name, grant type,
+  #                      canbless) for viewed user.
+  #%]
+
+[% title = BLOCK %]Edit user [% otheruser.identity FILTER html %][% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+  message = message
+  style_urls = ['skins/standard/admin.css', 'skins/standard/editusers.css']
+  doc_section = "useradmin.html#modifyusers"
+  javascript_urls = [ 'js/field.js' ]
+%]
+
+[% PROCESS admin/users/listselectvars.html.tmpl
+  listselectionvalues = listselectionvalues
+%]
+
+<form method="post" action="editusers.cgi">
+<table class="main">
+  [% PROCESS admin/users/userdata.html.tmpl
+    editform  = 1
+    editusers = editusers
+    otheruser = otheruser
+  %]
+  [% IF groups.size %]
+    <tr>
+      <th>Group access:</th>
+      <td>
+        <table class="groups">
+          <tr>
+            [% IF editusers %]
+              <th colspan="3">
+                Can turn these bits on for other users
+              </th>
+            [% END %]
+          </tr>
+          <tr>
+            [% IF editusers %]
+              <td style="text-align: center; font-weight: bold">|</td>
+            [% END %]
+            <th colspan="2">User is a member of these groups</th>
+          </tr>
+          [% FOREACH group = groups %]
+            [% perms = permissions.${group.id} %]
+            <tr class="[% 'in' IF perms.regexpmember || perms.derivedmember %]direct">
+              [% IF editusers %]
+                <td class="checkbox">
+                  [% '[' IF perms.indirectbless %]
+                  [% %]<input type="checkbox"
+                              name="bless_[% group.id %]"
+                              value="1"
+                              [% ' checked="checked"' IF perms.directbless %] />
+                  [% ']' IF perms.indirectbless %]</td>
+              [% END %]
+              <td class="checkbox">
+                [% '[' IF perms.derivedmember %]
+                [% '*' IF perms.regexpmember %]
+                [%%]<input type="checkbox"
+                           id="group_[% group.id %]"
+                           name="group_[% group.id %]"
+                           value="1"
+                           [% ' checked="checked"' IF perms.directmember %] />
+                [% '*' IF perms.regexpmember %]
+                [% ']' IF perms.derivedmember %]</td>
+              <td class="groupname">
+                <label for="group_[% group.id %]">
+                  <strong>[% group.name FILTER html %]:</strong>
+                  [%+ group.description FILTER html_light %]
+                </label>
+              </td>
+            </tr>
+          [% END %]
+        </table>
+      </td>
+    </tr>
+  [% END %]
+
+  <tr>
+    <th>Product responsibilities:</th>
+    <td>
+      [% IF otheruser.product_responsibilities.size %]
+        [% PROCESS admin/users/responsibilities.html.tmpl otheruser = otheruser %]
+      [% ELSE %]
+        <em>none</em>
+      [% END %]
+    </td>
+  </tr>
+
+  <tr>
+    <th>Last Login:</th>
+    <td>
+      [% IF otheruser.last_seen_date %]
+        [% otheruser.last_seen_date FILTER html %]
+      [% ELSE %]
+        <em>never</em>
+      [% END %]
+    </td>
+  </tr>
+</table>
+
+<p>
+  <input type="submit" id="update" value="Save Changes" />
+  <input type="hidden" name="userid" value="[% otheruser.id %]" />
+  <input type="hidden" name="action" value="update" />
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+  [% INCLUDE listselectionhiddenfields %]
+
+  or <a href="editusers.cgi?action=activity&amp;userid=[% otheruser.id %]"
+        title="View Account History for '
+        [%- otheruser.login FILTER html %]'">View Account History</a>
+</p>
+</form>
+<p>
+  User is a member of any groups shown with a check or grey bar.
+  A grey bar indicates indirect membership, either derived from other
+  groups (marked with square brackets) or via regular expression
+  (marked with '*').
+</p>
+[% IF editusers %]
+  <p>
+    Square brackets around the bless checkbox indicate the ability
+    to bless users (grant them membership in the group) as a result
+    of membership in another group.
+  </p>
+[% END %]
+
+[% IF Param('allowuserdeletion') && editusers %]
+  <form method="post" action="editusers.cgi">
+  <p>
+    <input type="submit" id="delete" value="Delete User" />
+    <input type="hidden" name="action" value="del" />
+    <input type="hidden" name="userid" value="[% otheruser.id %]" />
+    [% INCLUDE listselectionhiddenfields %]
+  </p>
+  </form>
+[% END %]
+
+<p>
+  You can also
+  [% IF editusers %]
+    <a href="editusers.cgi?action=add[% INCLUDE listselectionurlparams %]">add
+    a new user</a>
+    [% IF listselectionvalues %],
+    [% END %]
+  [% END %]
+  [% IF listselectionvalues.matchtype != 'exact' %]
+    go
+    <a href="editusers.cgi?action=list[% INCLUDE listselectionurlparams %]">back
+    to the user list</a>,
+  [% END %]
+  [% IF editusers OR listselectionvalues %]
+    or
+  [% END %]
+  <a href="editusers.cgi">find other users</a>.
+</p>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/users/list.html.tmpl b/template/en/default/admin/users/list.html.tmpl
new file mode 100644 (file)
index 0000000..ff23b77
--- /dev/null
+++ b/template/en/default/admin/users/list.html.tmpl
@@ -0,0 +1,111 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  #
+  # listselectionvalues: selection values to recreate the current user list.
+  # editusers:           is viewing user member of editusers?
+  # users:               list of user information (id, login_name, realname,
+  #                      disabledtext).
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = "Select user"
+  style_urls = ['skins/standard/editusers.css']
+  doc_section = "useradmin.html"
+%]
+
+[% PROCESS admin/users/listselectvars.html.tmpl
+  listselectionvalues = listselectionvalues
+%]
+
+[% listselectionurlparams = INCLUDE listselectionurlparams %]
+
+[% columns =
+  [{name               => 'login_name'
+    heading            => 'Edit user...'
+    contentlink        => 'editusers.cgi?action=edit&userid=%%userid%%' _
+                          listselectionurlparams
+   }
+   {name               => 'realname'
+    heading            => 'Real name'
+   }
+   {name               => 'last_seen_date'
+    heading            => 'Last Login'
+   }
+   {heading            => 'Account History'
+    content            => 'View'
+    contentlink        => 'editusers.cgi?action=activity' _
+                                  '&userid=%%userid%%' _
+                                  listselectionurlparams
+   }
+  ]
+%]
+
+[% IF Param('allowuserdeletion') && editusers %]
+  [% columns.push({heading     => 'Action'
+                   content     => 'Delete'
+                   contentlink => 'editusers.cgi?action=del' _
+                                  '&userid=%%userid%%' _
+                                  listselectionurlparams
+                  }
+                 )
+  %]
+[% END %]
+
+[%# Disabled users are crossed out. Missing realnames are noticed in red. %]
+[% overrides.login_name = {} %]
+[% overrides.realname = {} %]
+
+[% FOREACH thisuser = users %]
+  [% IF !thisuser.realname %]
+    [%# We cannot pass one class now and one class later. %]
+    [% SET classes = (thisuser.is_enabled ? "missing" : "bz_inactive missing") %]
+    [% overrides.realname.login_name.${thisuser.login_name} = {
+           content          => "missing"
+           override_content => 1
+           class            => "$classes"
+           override_class   => 1
+       }
+    %]
+  [% ELSIF !thisuser.is_enabled %]
+    [% overrides.realname.login_name.${thisuser.login_name} = {
+           class          => "bz_inactive"
+           override_class => 1
+       }
+    %]
+  [% END %]
+
+  [% IF !thisuser.is_enabled %]
+    [% overrides.login_name.login_name.${thisuser.login_name} = {
+           class          => "bz_inactive"
+           override_class => 1
+       }
+    %]
+  [% END %]
+[% END %]
+
+<p>[% users.size %] user[% "s" UNLESS users.size == 1 %] found.</p>
+
+[% PROCESS admin/table.html.tmpl
+  columns = columns
+  data    = users
+  overrides = overrides
+%]
+
+<p>
+  If you do not wish to modify a user account at this time, you can
+  <a href="editusers.cgi">find other users</a>
+  [% IF editusers %]
+    or
+    <a href="editusers.cgi?action=add[% INCLUDE listselectionurlparams %]">add
+    a new user</a>
+  [% END %].
+</p>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/users/listselectvars.html.tmpl b/template/en/default/admin/users/listselectvars.html.tmpl
new file mode 100644 (file)
index 0000000..bd03113
--- /dev/null
+++ b/template/en/default/admin/users/listselectvars.html.tmpl
@@ -0,0 +1,26 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  #
+  # listselectionvalues: selection values to recreate the current user list.
+  #%]
+
+[% BLOCK listselectionurlparams %]
+  [% FOREACH field = listselectionvalues.keys %]&
+    [% field FILTER uri %]=
+    [% listselectionvalues.$field FILTER uri %]
+  [% END %]
+[% END %]
+
+[% BLOCK listselectionhiddenfields %]
+  [% FOREACH field = listselectionvalues.keys %]
+    <input type="hidden" name="[% field FILTER html %]"
+           value="[% listselectionvalues.$field FILTER html %]" />
+  [% END %]
+[% END %]

diff --git a/template/en/default/admin/users/responsibilities.html.tmpl b/template/en/default/admin/users/responsibilities.html.tmpl
new file mode 100644 (file)
index 0000000..9e6e48c
--- /dev/null
+++ b/template/en/default/admin/users/responsibilities.html.tmpl
@@ -0,0 +1,57 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% hidden_products = 0 %]
+<table id="user_responsibilities" border="0">
+  [% FOREACH item = otheruser.product_responsibilities %]
+    [% IF !user.can_see_product(item.product.name) %]
+      [% hidden_products = 1 %]
+      [% NEXT %]
+    [% END %]
+    <tbody>
+    <tr>
+      <th colspan="3" class="product">Product: [% item.product.name FILTER html %]</th>
+    </tr>
+    <tr>
+      <th>Component</th>
+      <th>Default Assignee</th>
+      <th>Default QA Contact</th>
+      <th>Default CC</th>
+    </tr>
+    [% FOREACH component = item.components %]
+      <tr>
+        <td>
+          [% IF user.in_group("editcomponents", component.product_id) %]
+            <a href="editcomponents.cgi?action=edit&amp;product=
+                     [% item.product.name FILTER uri %]&amp;component=
+                     [% component.name FILTER uri %]">
+          [% END %]
+          [% component.name FILTER html %]
+          [% IF user.in_group("editcomponents", component.product_id) %]
+            </a>
+          [% END %]
+        </td>
+        [% FOREACH responsibility = ['default_assignee', 'default_qa_contact'] %]
+          <td class="center">
+            [% component.$responsibility.id == otheruser.id ? "X" : "&nbsp;" %]
+          </td>
+        [% END %]
+        <td class="center">
+          [% component.initial_cc.contains(otheruser) ? "X" : "&nbsp;" %]
+        </td>
+      </tr>
+    [% END %]
+    </tbody>
+  [% END %]
+</table>
+
+[% IF hidden_products %]
+  <p class="criticalmessages">The user is involved in at least one product which you cannot
+  see (and so is not listed above). You have to ask an administrator with enough
+  privileges to edit this user's roles for these products.</p>
+[% END %]

diff --git a/template/en/default/admin/users/search.html.tmpl b/template/en/default/admin/users/search.html.tmpl
new file mode 100644 (file)
index 0000000..c66af4c
--- /dev/null
+++ b/template/en/default/admin/users/search.html.tmpl
@@ -0,0 +1,79 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  #
+  # editusers:          is viewing user member of editusers?
+  # restrictablegroups: list of groups visible to the user:
+  #                     id: group id
+  #                     name: group name
+  #%]
+ 
+
+[% PROCESS global/header.html.tmpl
+  title = "Search users"
+  style_urls = ['skins/standard/editusers.css']
+  onload = "document.forms['f'].matchstr.focus()"
+  doc_section = "useradmin.html#user-account-search"
+%]
+
+[% PROCESS admin/users/listselectvars.html.tmpl
+  listselectionvalues = listselectionvalues
+%]
+
+<form name="f" method="get" action="editusers.cgi">
+<input type="hidden" name="action" value="list" />
+<p><label for="matchvalue">List users with</label>
+<select id="matchvalue" name="matchvalue">
+  <option value="login_name">login name</option>
+  <option value="realname">real name</option>
+  <option value="userid">user id</option>
+</select>
+<label for="matchstr">matching</label>
+<input size="32" name="matchstr" id="matchstr" />
+<select name="matchtype">
+  <option value="substr" selected="selected">case-insensitive substring</option>
+  <option value="regexp">case-insensitive regexp</option>
+  <option value="notregexp">not (case-insensitive regexp)</option>
+  <option value="exact">exact (find this user)</option>
+</select>
+<input type="submit" id="search" value="Search" /></p>
+
+[% IF restrictablegroups.size %]
+  <p><input type="checkbox" name="grouprestrict" value="1" id="grouprestrict" />
+  <label for="grouprestrict">Restrict to users belonging to group</label>
+  <select name="groupid"
+          onchange="document.forms['f'].grouprestrict.checked=true">
+    [% FOREACH group = restrictablegroups %]
+      <option value="[% group.id FILTER html %]">[% group.name FILTER html %]</option>
+    [% END %]
+  </select></p>
+[% END %]
+
+<p>
+  <input type="checkbox" name="enabled_only" value="1" id="enabled_only"
+         checked="checked">
+  <label for="enabled_only">Enabled user accounts only</label>
+</p>
+
+[% Hook.process('end') %]
+
+</form>
+
+[% IF editusers %]
+  <p>
+    You can also <a href="editusers.cgi?action=add">add a new user</a>
+    [%- IF listselectionvalues %],
+      or
+      <a href="editusers.cgi?action=list[% INCLUDE listselectionurlparams %]">show
+      the user list again</a>
+    [%- END %].
+  </p>
+[% END %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/users/userdata.html.tmpl b/template/en/default/admin/users/userdata.html.tmpl
new file mode 100644 (file)
index 0000000..ae952d1
--- /dev/null
+++ b/template/en/default/admin/users/userdata.html.tmpl
@@ -0,0 +1,109 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  #
+  # editform:  is this an edit form? (It's a create form otherwise)
+  # editusers: is viewing user member of editusers?
+  # otheruser: Bugzilla::User object of user to edit
+  #%]
+
+<script type="text/javascript">
+  var disable_mail_manually_set = [% (otheruser.email_disabled ? 1 : 0) FILTER js %];
+</script>
+
+<tr>
+  <th><label for="login">Login name:</label></th>
+  <td>
+    [% IF editusers %]
+      <input size="64" maxlength="255" name="login" 
+             id="login" value="[% otheruser.login FILTER html %]" />
+      [% IF editform %]
+        [% IF !otheruser.in_group('bz_sudo_protect') %]
+          <br />
+          <a href="relogin.cgi?action=prepare-sudo&amp;target_login=
+          [%- otheruser.login FILTER uri %]">Impersonate this user</a>
+        [% END %]
+      [% END %]
+    [% ELSE %]
+      [% otheruser.login FILTER html %]
+    [% END %]
+  </td>
+</tr>
+[% IF default_authorizer.extern_id_used %]
+  <tr>
+    <th><label for="extern_id">External Login ID:</label></th>
+    <td>
+      [% IF editusers %]
+        <input size="64" maxlength="64" name="extern_id"
+               id="extern_id" value="[% otheruser.extern_id FILTER html %]">
+      [% ELSE %]
+        [% otheruser.extern_id FILTER html %]
+      [% END %]
+    </td>
+  </tr>
+[% END %]
+<tr>
+  <th><label for="name">Real name:</label></th>
+  <td>
+    [% IF editusers %]
+      <input size="64" maxlength="255" name="name"
+             autocomplete="off"
+             id="name" value="[% otheruser.name FILTER html %]" />
+    [% ELSE %]
+      [% otheruser.name FILTER html %]
+    [% END %]
+  </td>
+</tr>
+
+[%# XXX This condition (can_change_password) will cause a problem
+  # if we ever have a login system that can create accounts through
+  # createaccount.cgi but can't change passwords.
+  #%]
+  
+[% IF editusers %]
+  [% IF user.authorizer.can_change_password %]
+  <tr>
+    <th><label for="password">Password:</label></th>
+    <td>
+      <input type="password" size="16" name="password" id="password"
+             value="" autocomplete="off" />
+      [% IF editform %]<br />
+        (Enter new password to change.)
+      [% END %]
+    </td>
+  </tr>
+  [% END %]
+  <tr>
+    <th><label for="disable_mail">[% terms.Bug %]mail Disabled:</label></th>
+    <td>
+      <input type="checkbox" name="disable_mail" id="disable_mail" value="1" 
+             [% IF otheruser.email_disabled %] checked="checked" [% END %] 
+             onchange="disable_mail_manually_set=1;">
+      (This affects [% terms.bug %]mail and whinemail, not password-reset or other 
+      non-[% terms.bug %]-related emails)
+    </td>
+  </tr>
+  <tr>
+    <th><label for="disabledtext">Disable text:</label></th>
+    <td>
+      [% INCLUDE global/textarea.html.tmpl
+         name           = 'disabledtext'
+         id             = 'disabledtext'
+         minrows        = 2
+         maxrows        = 10
+         defaultrows    = 10
+         cols           = 60
+         defaultcontent = otheruser.disabledtext
+         onchange       = "userDisabledTextOnChange(this);"
+       %]<br>
+      (If non-empty, then it will not be possible to log in using this account,
+      and this text should explain why.)
+    </td>
+  </tr>
+[% END %]

diff --git a/template/en/default/admin/versions/confirm-delete.html.tmpl b/template/en/default/admin/versions/confirm-delete.html.tmpl
new file mode 100644 (file)
index 0000000..e6f3922
--- /dev/null
+++ b/template/en/default/admin/versions/confirm-delete.html.tmpl
@@ -0,0 +1,89 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # product: object; Bugzilla::Product object representing the product to
+  #               which the version belongs.
+  # version: object; Bugzilla::Version object representing the
+  #                    version the user wants to delete.
+  #%]
+
+[% title = BLOCK %]Delete Version of Product '[% product.name FILTER html %]'
+  [% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+  style_urls = ['skins/standard/admin.css']
+%]
+
+<table border="1" cellpadding="4" cellspacing="0">
+<tr bgcolor="#6666FF">
+  <th valign="top" align="left">Field</th>
+  <th valign="top" align="left">Value</th>
+</tr>
+<tr>
+  <td valign="top">Version:</td>
+  <td valign="top">[% version.name FILTER html %]</td>
+</tr>
+<tr>
+  <td valign="top">Version of Product:</td>
+  <td valign="top">[% product.name FILTER html %]</td>
+</tr>
+<tr>
+  <td valign="top">[% terms.Bugs %]:</td>
+  <td valign="top">
+[% IF version.bug_count %]
+  <a title="List of [% terms.bugs %] targetted at version '
+           [%- version.name FILTER html %]'"
+     href="buglist.cgi?version=[% version.name FILTER uri %]&amp;product=
+          [%- product.name FILTER uri %]">
+          [%- version.bug_count FILTER none %]</a>
+[% ELSE %]
+  None
+[% END %]
+  </td>
+</tr>
+</table>
+
+<h2>Confirmation</h2>
+
+[% IF version.bug_count %]
+  <p class="confirmation">
+  Sorry, there
+  [% IF version.bug_count > 1 %] 
+    are [% version.bug_count FILTER none %] outstanding [% terms.bugs %]
+  [% ELSE %]
+    is [% version.bug_count FILTER none %] outstanding [% terms.bug %]
+  [% END %]
+
+  for this version. You must move
+
+  [% IF version.bug_count > 1 %]
+     those [% terms.bugs %] 
+  [% ELSE %]
+     that [% terms.bug %]
+  [% END %]
+  to another version before this version can be deleted.
+  </p>
+[% ELSE %]
+
+  <p>Do you really want to delete this version?</p>
+  
+  <form method="post" action="editversions.cgi">
+    <input type="submit" id="delete" value="Yes, delete">
+    <input type="hidden" name="action" value="delete">
+    <input type="hidden" name="product" value="[% product.name FILTER html %]">
+    <input type="hidden" name="version" value="[% version.name FILTER html %]">
+    <input type="hidden" name="token" value="[% token FILTER html %]">
+  </form>
+
+[% END %]
+
+[% PROCESS admin/versions/footer.html.tmpl %]
+
+[% PROCESS global/footer.html.tmpl %] 

diff --git a/template/en/default/admin/versions/create.html.tmpl b/template/en/default/admin/versions/create.html.tmpl
new file mode 100644 (file)
index 0000000..af72582
--- /dev/null
+++ b/template/en/default/admin/versions/create.html.tmpl
@@ -0,0 +1,40 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # product: object; Bugzilla::Product object representing the product to
+  #               which the version is being created for
+  #%]
+  
+[% title = BLOCK %]Add Version to Product '[% product.name FILTER html %]'[% END %]
+[% subheader = BLOCK %]This page allows you to add a new version to product
+                '[% product.name FILTER html %]'.[% END %]
+[% PROCESS global/header.html.tmpl
+  title = title
+  subheader = subheader
+%]
+
+<form method="post" action="editversions.cgi">
+  <table border="0" cellpadding="4" cellspacing="0">
+    <tr>
+      <th align="right"><label for="version">Version:</label></th>
+      <td><input id="version" size="64" maxlength="64" name="version"
+                 value=""></td>
+    </tr>
+  </table>
+  <input type="submit" id="create" value="Add">
+  <input type="hidden" name="action" value="new">
+  <input type="hidden" name='product' value="[% product.name FILTER html %]">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+</form>
+
+[% PROCESS admin/versions/footer.html.tmpl
+    no_add_version_link = 1
+ %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/versions/edit.html.tmpl b/template/en/default/admin/versions/edit.html.tmpl
new file mode 100644 (file)
index 0000000..195a94c
--- /dev/null
+++ b/template/en/default/admin/versions/edit.html.tmpl
@@ -0,0 +1,47 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # product: object; Bugzilla::Product object representing the product to
+  #               which the version belongs.
+  # version: object; Bugzilla::Version object representing the
+  #                    version the user wants to edit.
+  #%]
+
+[% title = BLOCK %]Edit Version '[% version.name FILTER html %]' of product '
+                   [%- product.name FILTER html %]'[% END %]
+[% PROCESS global/header.html.tmpl
+  title = title
+%]
+
+<form method="post" action="editversions.cgi">
+  <table border="0" cellpadding="4" cellspacing="0">
+
+    <tr>
+      <th class="field_label"><label for="version">Version:</label></th>
+      <td><input id="version" size="64" maxlength="64" name="version" value="
+      [%- version.name FILTER html %]"></td>
+    </tr>
+    <tr>
+      <th class="field_label"><label for="isactive">Enabled For [% terms.Bugs %]:</label></th>
+      <td><input id="isactive" name="isactive" type="checkbox" value="1"
+                 [% 'checked="checked"' IF version.isactive %]></td>
+    </tr>
+  </table>
+
+  <input type="hidden" name="versionold" value="[% version.name FILTER html %]">
+  <input type="hidden" name="action" value="update">
+  <input type="hidden" name="product" value="[% product.name FILTER html %]">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+  <input type="submit" id="update" value="Save Changes">
+</form>
+
+[% PROCESS admin/versions/footer.html.tmpl
+  no_edit_version_link = 1 %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/versions/footer.html.tmpl b/template/en/default/admin/versions/footer.html.tmpl
new file mode 100644 (file)
index 0000000..0af63a8
--- /dev/null
+++ b/template/en/default/admin/versions/footer.html.tmpl
@@ -0,0 +1,53 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # product: object; Bugzilla::Product object representing the product to
+  #               which the version belongs.
+  # version: object; Bugzilla::Version object representing the version
+  #
+  # no_XXX_link: boolean; if defined, then don't show the corresponding
+  #                       link. Supported parameters are:
+  #
+  # no_edit_version_link
+  # no_edit_other_versions_link
+  # no_add_version_link
+  #%]
+
+<hr>
+
+<p>
+
+[% UNLESS no_add_version_link %]
+  <a title="Add a version to product '[% product.name FILTER html %]'"
+     href="editversions.cgi?action=add&amp;product=
+          [%- product.name FILTER uri %]">Add</a> a version. 
+[% END %]
+
+[% IF version.name && !no_edit_version_link %]
+  Edit version <a 
+  title="Edit Version '[% version.name FILTER html %]' of product '
+         [%- product.name FILTER html %]'"
+  href="editversions.cgi?action=edit&amp;product=
+        [%- product.name FILTER uri %]&amp;version=
+        [%- version.name FILTER uri %]">
+        '[% version.name FILTER html %]'</a>.
+[% END %]
+
+[% UNLESS no_edit_other_versions_link %]
+  Edit other versions of product <a 
+  href="editversions.cgi?product=
+        [%- product.name FILTER uri %]">'[% product.name FILTER html %]'</a>.
+
+[% END %]
+
+  Edit product <a 
+  href="editproducts.cgi?action=edit&amp;product=
+        [%- product.name FILTER uri %]">'[% product.name FILTER html %]'</a>.
+
+</p>

diff --git a/template/en/default/admin/versions/list.html.tmpl b/template/en/default/admin/versions/list.html.tmpl
new file mode 100644 (file)
index 0000000..1cf3e86
--- /dev/null
+++ b/template/en/default/admin/versions/list.html.tmpl
@@ -0,0 +1,79 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # product: object; Bugzilla::Product object representing the product to
+  #               which the versions belongs.
+  #%]
+
+[% title = BLOCK %]Select version of product
+                   '[% product.name FILTER html %]'[% END %]
+[% PROCESS global/header.html.tmpl
+  title = title
+%]
+
+[% edit_contentlink = BLOCK %]editversions.cgi?action=edit&product=
+  [%- product.name FILTER uri %]&version=%%name%%[% END %]
+[% delete_contentlink = BLOCK %]editversions.cgi?action=del&product=
+  [%- product.name FILTER uri %]&version=%%name%%[% END %]
+[% bug_count_contentlink = BLOCK %]buglist.cgi?version=%%name%%&product=
+  [%- product.name FILTER uri %][% END %]
+
+
+[% columns = [
+     { 
+       name => "name"
+       heading => "Edit version..."
+       contentlink => edit_contentlink
+     },
+     {
+       name => "isactive"
+       heading => "Active"
+       yesno_field => 1
+     }
+   ]
+%]
+
+[% IF showbugcounts %]
+
+  [% columns.push({
+       name => "bug_count"
+       heading => "$terms.Bugs"
+       align => "right"
+       contentlink => bug_count_contentlink
+     })
+  %]
+
+[% END %]
+
+[% columns.push({
+       heading => "Action"
+       content => "Delete"
+       contentlink => delete_contentlink
+     })
+%]
+
+[% Hook.process('before_table') %]
+
+[% PROCESS admin/table.html.tmpl
+     columns = columns
+     data = product.versions
+%]
+
+[% IF ! showbugcounts %]
+
+  <p><a href="editversions.cgi?product=[% product.name FILTER uri %]&amp;showbugcounts=1">
+      Redisplay table with [% terms.bug %] counts (slower)</a></p>
+
+[% END %]
+
+[% PROCESS admin/versions/footer.html.tmpl
+  no_edit_other_versions_link = 1
+ %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/versions/select-product.html.tmpl b/template/en/default/admin/versions/select-product.html.tmpl
new file mode 100644 (file)
index 0000000..e40e408
--- /dev/null
+++ b/template/en/default/admin/versions/select-product.html.tmpl
@@ -0,0 +1,54 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # products: array of product objects
+  # showbugcounts: if defined, then bug counts should be included in the table
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = "Edit versions for which product?"
+%]
+
+[% columns = [
+     { 
+       name => "name"
+       heading => "Edit versions of..."
+       contentlink => "editversions.cgi?product=%%name%%" 
+     },
+     { 
+       name => "description"
+       heading => "Description" 
+       allow_html_content => 1
+     }
+   ]
+%]
+
+[% IF showbugcounts %]
+
+  [% columns.push({
+      name => 'bug_count'
+      heading => "$terms.Bugs"
+      align => "right"
+      contentlink => "buglist.cgi?product=%%name%%"
+    })
+  %]
+
+[% END %]
+
+[% PROCESS admin/table.html.tmpl
+     columns = columns
+     data = products
+%]
+
+[% IF !showbugcounts %]
+  <p><a href="editversions.cgi?showbugcounts=1">
+      Redisplay table with [% terms.bug %] counts (slower)</a></p>
+[% END %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/admin/workflow/comment.html.tmpl b/template/en/default/admin/workflow/comment.html.tmpl
new file mode 100644 (file)
index 0000000..b5907d1
--- /dev/null
+++ b/template/en/default/admin/workflow/comment.html.tmpl
@@ -0,0 +1,82 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% INCLUDE global/header.html.tmpl
+   title = "Comments Required on Status Transitions"
+   style_urls = ['skins/standard/admin.css']
+%]
+
+<script type="text/javascript">
+<!--
+  function toggle_cell(cell) {
+    if (cell.checked)
+      cell.parentNode.className = "checkbox-cell checked";
+    else
+      cell.parentNode.className = "checkbox-cell";
+  }
+//-->
+</script>
+
+<p>
+  This page allows you to define which status transitions require a comment
+  by the user doing the change.
+</p>
+
+<form id="workflow_form" method="POST" action="editworkflow.cgi">
+<table>
+  <tr>
+    <th colspan="2">&nbsp;</th>
+    <th colspan="[% statuses.size FILTER html %]" class="title">To</th>
+  </tr>
+
+  <tr>
+    <th rowspan="[% statuses.size + 2 FILTER html %]" class="title">From</th>
+    <th>&nbsp;</th>
+    [% FOREACH status = statuses %]
+      <th class="col-header[% status.is_open ? " open-status" : " closed-status" %]">
+        [% display_value("bug_status", status.name) FILTER html %]
+      </th>
+    [% END %]
+  </tr>
+
+  [%# This defines the entry point in the workflow %]
+  [% p = [{id => 0, name => "{Start}", is_open => 1}] %]
+  [% FOREACH status = p.merge(statuses) %]
+    <tr class="highlight">
+      <th align="right" class="[% status.is_open ? "open-status" : "closed-status" %]">
+        [% display_value("bug_status", status.name) FILTER html %]
+      </th>
+
+      [% FOREACH new_status = statuses %]
+        [% IF workflow.${status.id}.${new_status.id}.defined %]
+          <td align="center" class="checkbox-cell
+              [% " checked" IF workflow.${status.id}.${new_status.id} %]"
+              title="From [% status.name FILTER html %] to [% new_status.name FILTER html %]">
+            <input type="checkbox" name="c_[% status.id %]_[% new_status.id %]"
+                   id="c_[% status.id %]_[% new_status.id %]" onclick="toggle_cell(this)"
+              [% " checked='checked'" IF workflow.${status.id}.${new_status.id} %]>
+          </td>
+        [% ELSE %]
+          <td class="checkbox-cell forbidden">&nbsp;</td>
+        [% END %]
+      [% END %]
+    </tr>
+  [% END %]
+</table>
+
+<p align="center">
+  <input type="hidden" name="action" value="update_comment">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+  <input type="submit" id="update_comment" value="Commit Changes"> -
+  <a href="editworkflow.cgi?action=edit_comment">Cancel Changes</a> -
+  <a href="editworkflow.cgi">View Current Workflow</a>
+</p>
+
+</form>
+
+[% INCLUDE global/footer.html.tmpl %]

diff --git a/template/en/default/admin/workflow/edit.html.tmpl b/template/en/default/admin/workflow/edit.html.tmpl
new file mode 100644 (file)
index 0000000..403405b
--- /dev/null
+++ b/template/en/default/admin/workflow/edit.html.tmpl
@@ -0,0 +1,100 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% INCLUDE global/header.html.tmpl
+   title = "Edit Workflow"
+   style_urls = ['skins/standard/admin.css']
+%]
+
+<script type="text/javascript">
+<!--
+  function toggle_cell(cell) {
+    if (cell.checked)
+      cell.parentNode.className = "checkbox-cell checked";
+    else
+      cell.parentNode.className = "checkbox-cell";
+  }
+//-->
+</script>
+
+<p>
+  This page allows you to define which status transitions are valid in your workflow.
+  For compatibility with older versions of [% terms.Bugzilla %], reopening [% terms.abug %]
+  will only display either [% display_value("bug_status", "UNCONFIRMED") FILTER html %] or
+  [%+ display_value("bug_status", "REOPENED") FILTER html %] (if allowed by your workflow) but not
+  both. The decision depends on whether the [% terms.bug %] has ever been confirmed or not.
+  So it is a good idea to allow both transitions and let [% terms.Bugzilla %] select the
+  correct one.
+</p>
+
+<form id="workflow_form" method="POST" action="editworkflow.cgi">
+<table>
+  <tr>
+    <th colspan="2">&nbsp;</th>
+    <th colspan="[% statuses.size FILTER html %]" class="title">To</th>
+  </tr>
+
+  <tr>
+    <th rowspan="[% statuses.size + 2 FILTER html %]" class="title">From</th>
+    <th>&nbsp;</th>
+    [% FOREACH status = statuses %]
+      <th class="col-header[% status.is_open ? " open-status" : " closed-status" %]">
+        [% display_value("bug_status", status.name) FILTER html %]
+      </th>
+    [% END %]
+  </tr>
+
+  [%# This defines the entry point in the workflow %]
+  [% p = [{id => 0, name => "{Start}", is_open => 1}] %]
+  [% FOREACH status = p.merge(statuses) %]
+    <tr class="highlight">
+      <th align="right" class="[% status.is_open ? "open-status" : "closed-status" %]">
+        [% display_value("bug_status", status.name) FILTER html %]
+      </th>
+
+      [% FOREACH new_status = statuses %]
+        [% IF status.id != new_status.id %]
+          [% checked = workflow.${status.id}.${new_status.id}.defined ? 1 : 0 %]
+          [% mandatory = (status.id && new_status.name == Param("duplicate_or_move_bug_status")) ? 1 : 0 %]
+          <td align="center" class="checkbox-cell[% " checked" IF checked || mandatory %]"
+              title="From [% status.name FILTER html %] to [% new_status.name FILTER html %]">
+            <input type="checkbox" name="w_[% status.id %]_[% new_status.id %]"
+                   id="w_[% status.id %]_[% new_status.id %]" onclick="toggle_cell(this)"
+                   [%+ "checked='checked'" IF checked || mandatory %]
+                   [%+ "disabled='disabled'" IF mandatory %]>
+          </td>
+        [% ELSE %]
+          <td class="checkbox-cell forbidden">&nbsp;</td>
+        [% END %]
+      [% END %]
+    </tr>
+  [% END %]
+</table>
+
+<p>
+  When [% terms.abug %] is marked as a duplicate of another one or is moved
+  to another installation, the [% terms.bug %] status is automatically set to
+  <b>[% display_value("bug_status", Param("duplicate_or_move_bug_status")) FILTER html %]</b>. All transitions to
+  this [% terms.bug %] status must then be valid (this is the reason why you cannot edit
+  them above).<br>
+  Note: you can change this setting by visiting the
+  <a href="editparams.cgi?section=bugchange#duplicate_or_move_bug_status">Parameters</a>
+  page and editing the <i>duplicate_or_move_bug_status</i> parameter.
+</p>
+
+<p align="center">
+  <input type="hidden" name="action" value="update">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+  <input type="submit" id="update_workflow" value="Commit Changes"> -
+  <a href="editworkflow.cgi">Cancel Changes</a> -
+  <a href="editworkflow.cgi?action=edit_comment">View Comments Required on Status Transitions</a>
+</p>
+
+</form>
+
+[% INCLUDE global/footer.html.tmpl %]

diff --git a/template/en/default/attachment/choose.html.tmpl b/template/en/default/attachment/choose.html.tmpl
new file mode 100644 (file)
index 0000000..c6b94d7
--- /dev/null
+++ b/template/en/default/attachment/choose.html.tmpl
@@ -0,0 +1,29 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+   title = "Locate attachment",
+   onload = "document.forms['choose-id'].id.focus()"
+ %]
+
+<form name="choose-id" method="get" action="attachment.cgi">
+  <p>Access an attachment by entering its ID into the form below:</p>
+  <p>Attachment ID: <input name="id" size="6">
+  <button name="action" value="edit" id="edit">Details</button>
+  <button name="action" value="view" id="view">View</button>
+  </p>
+</form>
+
+<form method="get" action="show_bug.cgi">
+  <p>Or, access it from the list of attachments in its associated [% terms.bug %] report:</p>
+  <p>[% terms.Bug %] ID: <input name="id" size="6">
+  <input type="submit" name="action" value="View" id="action">
+  </p>
+</form>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/attachment/confirm-delete.html.tmpl b/template/en/default/attachment/confirm-delete.html.tmpl
new file mode 100644 (file)
index 0000000..4557af6
--- /dev/null
+++ b/template/en/default/attachment/confirm-delete.html.tmpl
@@ -0,0 +1,83 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # a: attachment object; attachment the user wants to delete.
+  # token: string; The token used to identify the session.
+  #%]
+
+[% title = BLOCK %]
+  Delete Attachment [% a.id FILTER html %] of [% terms.Bug %] [%+ a.bug_id FILTER html %]
+[% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+  doc_section = "attachments.html"
+%]
+
+<table border="1" cellpadding="4" cellspacing="0">
+  <tr bgcolor="#6666FF">
+    <th valign="top" align="left">Field</th>
+    <th valign="top" align="left">Value</th>
+  </tr>
+  <tr>
+    <td valign="top">Attachment ID:</td>
+    <td valign="top">
+      <a href="attachment.cgi?id=[% a.id FILTER html %]">[% a.id FILTER html %]</a>
+    </td>
+  </tr>
+  <tr>
+    <td valign="top">File name:</td>
+    <td valign="top">[% a.filename FILTER html %]</td>
+  </tr>
+  <tr>
+    <td valign="top">Description:</td>
+    <td valign="top">[% a.description FILTER html %]</td>
+  </tr>
+  <tr>
+    <td valign="top">Contained in [% terms.Bug %]:</td>
+    <td valign="top">[% a.bug_id FILTER bug_link(a.bug_id) FILTER none %]</td>
+  </tr>
+  <tr>
+    <td valign="top">Creator:</td>
+    <td valign="top">[% a.attacher.identity FILTER html %]</td>
+  </tr>
+  <tr>
+    <td valign="top">Creation Date:</td>
+    <td valign="top">[% a.attached FILTER time %]</td>
+  </tr>
+</table>
+
+<h2>Confirmation</h2>
+
+<table border="0" cellpadding="20" width="70%" bgcolor="red">
+  <tr>
+    <td>
+      The content of this attachment will be deleted in an <b>irreversible</b> way.
+    </td>
+  </tr>
+</table>
+
+<p>Do you really want to delete this attachment?</p>
+
+<form action="attachment.cgi" method="POST">
+  <label for="reason">Reason of the deletion:</label>
+  <input type="text" id="reason" name="reason" value="" size="80" maxlength="200">
+  <br>
+  <input type="submit" value="Yes, delete" id="delete">
+  <input type="hidden" name="action" value="delete">
+  <input type="hidden" name="id" value="[% a.id FILTER html %]">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+</form>
+
+<p>
+  No, cancel this deletion and return to
+  [%+ "$terms.bug " _ a.bug_id FILTER bug_link(a.bug_id) FILTER none %].
+</p>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/attachment/create.html.tmpl b/template/en/default/attachment/create.html.tmpl
new file mode 100644 (file)
index 0000000..8f5477e
--- /dev/null
+++ b/template/en/default/attachment/create.html.tmpl
@@ -0,0 +1,133 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# Define strings that will serve as the title and header of this page %]
+[% title = BLOCK %]Create New Attachment for [% terms.Bug %] #[% bug.bug_id %][% END %]
+[% header = BLOCK %]Create New Attachment for
+  [%+ "$terms.Bug $bug.bug_id" FILTER bug_link(bug) FILTER none %][% END %]
+[% subheader = BLOCK %][% bug.short_desc FILTER html %][% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+  header = header
+  subheader = subheader
+  style_urls = [ 'skins/standard/attachment.css' ]
+  yui = [ 'autocomplete' ]
+  javascript_urls = [ "js/attachment.js", 'js/field.js', "js/util.js", "js/TUI.js" ]
+  doc_section = "attachments.html"
+%]
+
+<script type="text/javascript">
+<!--
+TUI_hide_default('attachment_text_field');
+-->
+</script>
+
+<form name="entryform" method="post" action="attachment.cgi"
+      enctype="multipart/form-data"
+      onsubmit="return validateAttachmentForm(this)">
+  <input type="hidden" name="bugid" value="[% bug.bug_id %]">
+  <input type="hidden" name="action" value="insert">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+
+  <table class="attachment_entry">
+    [% PROCESS attachment/createformcontents.html.tmpl %]
+
+    [%# Additional fields for attachments on existing bugs: %]
+    [% IF attachments.size %]
+      <tr>
+        <th>Obsoletes:</th>
+        <td>
+          <em>(optional) Check each existing attachment made obsolete by your new attachment.</em><br>
+          [% FOREACH attachment = attachments %]
+            <input type="checkbox" id="[% attachment.id %]"
+                 name="obsolete" value="[% attachment.id %]">
+            <a href="attachment.cgi?id=[% attachment.id %]&amp;action=edit">[% attachment.id %]: [% attachment.description FILTER html %]</a><br>
+          [% END %]
+        </td>
+      </tr>
+    [% END %]
+
+    [% IF (user.id != bug.assigned_to.id) AND user.in_group("editbugs", bug.product_id) %]
+      <tr>
+        <th>Reassignment:</th>
+        <td>
+          <em>If you want to assign this [% terms.bug %] to yourself,
+              check the box below.</em><br>
+          <input type="checkbox" id="takebug" name="takebug" value="1">
+          <label for="takebug">take [% terms.bug %]</label>
+          [% bug_statuses = [] %]
+          [% FOREACH bug_status = bug.status.can_change_to %]
+            [% NEXT IF bug_status.name == "UNCONFIRMED" 
+                       && !bug.product_obj.allows_unconfirmed %]
+            [% bug_statuses.push(bug_status) IF bug_status.is_open %]
+          [% END %]
+          [% IF bug_statuses.size %]
+            <label for="takebug">and set the [% terms.bug %] status to</label>
+            <select id="bug_status" name="bug_status">
+              <option value="[% bug.status.name FILTER html %]">[% display_value("bug_status", bug.status.name) FILTER html %] (current)</option>
+              [% FOREACH bug_status = bug_statuses %]
+                [% NEXT IF bug_status.id == bug.status.id %]
+                <option value="[% bug_status.name FILTER html %]">[% display_value("bug_status", bug_status.name) FILTER html %]</option>
+              [% END %]
+            </select>
+          [% END %]
+        </td>
+      </tr>
+    [% END %]
+    <tr>
+      <th><label for="comment">Comment:</label></th>
+      <td>
+        <em>(optional) Add a comment about this attachment to the [% terms.bug %].</em><br>
+        [% INCLUDE global/textarea.html.tmpl
+          name    = 'comment'
+          id      = 'comment'
+          minrows = 6
+          maxrows = 15
+          cols    = constants.COMMENT_COLS
+          wrap    = 'soft'
+        %]
+        [% IF NOT bug.cc || NOT bug.cc.contains(user.login) %]
+          <br>
+          <input type="checkbox" id="addselfcc" name="addselfcc"
+            [%~ ' checked="checked"'
+                IF user.settings.state_addselfcc.value == 'always'
+                   || (!bug.user.has_any_role
+                       && user.settings.state_addselfcc.value == 'cc_unless_role') %]>
+          <label for="addselfcc">Add me to CC list</label>
+        [% END %]
+      </td>
+    </tr>
+    [% IF user.is_insider %]
+      <tr>
+        <th>Privacy:</th>
+        <td>
+          <input type="checkbox" name="isprivate" id="isprivate"
+          value="1" onClick="updateCommentPrivacy(this)">
+          <label for="isprivate">
+            Make attachment and comment private (visible only to members of
+            the <strong>[% Param('insidergroup') FILTER html %]</strong>
+            group)
+          </label>
+        </td>
+      </tr>
+    [% END %]
+
+    [% Hook.process('form_before_submit') %]
+
+    <tr>
+      <th>&nbsp;</th>
+      <td><input type="submit" id="create" value="Submit"></td>
+    </tr>
+  </table>
+
+</form>
+
+[% Hook.process('end') %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/attachment/created.html.tmpl b/template/en/default/attachment/created.html.tmpl
new file mode 100644 (file)
index 0000000..cbfd260
--- /dev/null
+++ b/template/en/default/attachment/created.html.tmpl
@@ -0,0 +1,54 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # attachment: object of the attachment just created.
+  # contenttypemethod: string. How we got the content type of the attachment.
+  #  Possible values: autodetect, list, manual.
+  #%]
+
+[% bug = bugs.0 %]
+[% PROCESS "bug/show-header.html.tmpl" %]
+[% PROCESS global/header.html.tmpl
+  title = "Attachment $attachment.id added to $terms.Bug $attachment.bug_id"
+%]
+
+<dl>
+  <dt>
+    <a title="[% attachment.description FILTER html %]"
+       href="attachment.cgi?id=[% attachment.id %]&amp;action=edit">Attachment #[% attachment.id %]</a>
+    to [% "$terms.bug $attachment.bug_id" FILTER bug_link(attachment.bug_id) FILTER none %] created
+  </dt>
+  <dd>
+    [% PROCESS "bug/process/bugmail.html.tmpl" mailing_bugid = attachment.bug_id %]
+    [% IF convertedbmp %]
+      <p>
+        <b>Note:</b> [% terms.Bugzilla %] automatically converted your BMP image file to a
+        compressed PNG format.
+      </p>
+    [% END %]
+    [% IF contenttypemethod == 'autodetect' %]
+      <p>
+        <b>Note:</b> [% terms.Bugzilla %] automatically detected the content type
+        <em>[% attachment.contenttype FILTER html %]</em> for this attachment.  If this is
+        incorrect, correct the value by editing the attachment's
+        <a href="attachment.cgi?id=[% attachment.id %]&amp;action=edit">details</a>.
+      </p>
+    [% END %]
+
+    [%# Links to more information about the changed bug. %]
+    [% Hook.process("links") %]
+  </dd>
+</dl>
+
+<p>
+<a href="attachment.cgi?bugid=[% attachment.bug_id %]&amp;action=enter">Create
+ Another Attachment to [% terms.Bug %] [%+ attachment.bug_id %]</a>
+</p>
+
+[% PROCESS bug/show.html.tmpl %]

diff --git a/template/en/default/attachment/createformcontents.html.tmpl b/template/en/default/attachment/createformcontents.html.tmpl
new file mode 100644 (file)
index 0000000..48e4f4a
--- /dev/null
+++ b/template/en/default/attachment/createformcontents.html.tmpl
@@ -0,0 +1,98 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% max_local = Param('maxlocalattachment') * 1024 %]
+[% max_limit = Param('maxattachmentsize')> max_local ? Param('maxattachmentsize') : max_local %]
+<tr class="attachment_data">
+  <th><label for="data">File</label>:</th>
+  <td>
+    <em>Enter the path to the file on your computer</em> (or
+    <a id="attachment_data_controller" href="javascript:TUI_toggle_class('attachment_text_field');
+                                             javascript:TUI_toggle_class('attachment_data')"
+    >paste text as attachment</a>).<br>
+    <input type="file" id="data" name="data" size="50" onchange="DataFieldHandler()">
+    <br><em>(File size limit: [% max_limit FILTER html %] KB)</em>
+  </td>
+</tr>
+<tr class="attachment_text_field">
+  <th><label for="attach_text">File</label>:</th>
+  <td>
+    <em>Paste the text to be added as an attachment</em> (or
+    <a id="attachment_text_field_controller" href="javascript:TUI_toggle_class('attachment_text_field');
+                                                   javascript:TUI_toggle_class('attachment_data')"
+    >attach a file</a>).<br>
+    <textarea id="attach_text" name="attach_text" cols="80" rows="15"
+              onkeyup="TextFieldHandler()" onblur="TextFieldHandler()"></textarea>
+  </td>
+</tr>
+<tr>
+  <th class="required"><label for="description">Description</label>:</th>
+  <td>
+    <em>Describe the attachment briefly.</em><br>
+    <input type="text" id="description" name="description" class="required"
+           size="60" maxlength="200">
+  </td>
+</tr>
+<tr[% ' class="expert_fields"' UNLESS bug.id %]>
+  <th>Content Type:</th>
+  <td>
+    <em>If the attachment is a patch, check the box below.</em><br>
+    <input type="checkbox" id="ispatch" name="ispatch" value="1"
+           onchange="setContentTypeDisabledState(this.form);">
+    <label for="ispatch">patch</label><br><br>
+    [%# Reset this whenever the page loads so that the JS state is up to date %]
+    <script type="text/javascript">
+      YAHOO.util.Event.onDOMReady(function() {
+          bz_fireEvent(document.getElementById('ispatch'), 'change');
+      });
+    </script>
+
+    <em>Otherwise, choose a method for determining the content type.</em><br>
+    <input type="radio" id="autodetect"
+           name="contenttypemethod" value="autodetect" checked="checked">
+      <label for="autodetect">auto-detect</label><br>
+    <input type="radio" id="list"
+           name="contenttypemethod" value="list">
+      <label for="list">select from list</label>:
+      <select name="contenttypeselection" id="contenttypeselection"
+              onchange="this.form.contenttypemethod[1].checked = true;">
+        [% PROCESS content_types %]
+      </select><br>
+    <input type="radio" id="manual"
+                 name="contenttypemethod" value="manual">
+      <label for="manual">enter manually</label>:
+      <input type="text" name="contenttypeentry" id="contenttypeentry"
+             size="30" maxlength="200"
+             onchange="if (this.value) this.form.contenttypemethod[2].checked = true;">
+  </td>
+</tr>
+<tr[% ' class="expert_fields"' UNLESS bug.id %]>
+  <td> </td>
+  <td>
+    [% IF flag_types && flag_types.size > 0 %]
+      [% PROCESS "flag/list.html.tmpl" %]<br>
+    [% END %]
+  </td>
+</tr>
+
+[% BLOCK content_types %]
+  [% mimetypes = [{type => "text/plain", desc => "plain text"},
+                  {type => "text/html",  desc => "HTML source"},
+                  {type => "application/xml", desc => "XML source"},
+                  {type => "image/gif",  desc => "GIF image"},
+                  {type => "image/jpeg", desc => "JPEG image"},
+                  {type => "image/png",  desc => "PNG image"},
+                  {type => "application/pdf", desc => "PDF document"},
+                  {type => "application/octet-stream", desc => "binary file"}]
+  %]
+  [% Hook.process("mimetypes", "attachment/createformcontents.html.tmpl") %]
+
+  [% FOREACH m = mimetypes %]
+    <option value="[% m.type FILTER html %]">[% m.desc FILTER html %] ([% m.type FILTER html %])</option>
+  [% END %]
+[% END %]

diff --git a/template/en/default/attachment/delete_reason.txt.tmpl b/template/en/default/attachment/delete_reason.txt.tmpl
new file mode 100644 (file)
index 0000000..1631555
--- /dev/null
+++ b/template/en/default/attachment/delete_reason.txt.tmpl
@@ -0,0 +1,18 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # attachment: object of the attachment the user wants to delete.
+  # reason: string; The reason provided by the user.
+  #%]
+
+The content of attachment [% attachment.id %] has been deleted
+[%~ IF reason %] for the following reason:
+
+[%+ reason %]
+[% END %]

diff --git a/template/en/default/attachment/diff-file.html.tmpl b/template/en/default/attachment/diff-file.html.tmpl
new file mode 100644 (file)
index 0000000..815b6de
--- /dev/null
+++ b/template/en/default/attachment/diff-file.html.tmpl
@@ -0,0 +1,164 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# This line is really long for a reason: to get rid of any possible textnodes
+  # between the elements.  This is necessary because DOM parent-child-sibling
+  # relations can change and screw up the javascript for restoring, collapsing
+  # and expanding.  Do not change without testing all three of those.
+  # Also, the first empty row is required because 'table-layout: fixed' only
+  # considers the first row to determine column widths. If a colspan is found,
+  # it then share the width equally among all columns, which we don't want.
+  #%]
+<table class="file_table"><thead><tr><td class="num"></td><td></td><td class="num"></td><td></td></tr><tr><td class="file_head" colspan="4"><a href="#" onclick="return twisty_click(this)">[% collapsed ? '(+)' : '(-)' %]</a><input type="checkbox" name="[% file.filename FILTER html %]"[% collapsed ? '' : ' checked' %] style="display: none">
+  [% IF lxr_prefix && !file.is_add %]
+    <a href="[% lxr_prefix %]">[% file.filename FILTER html %]</a>
+  [% ELSE %]
+    [% file.filename FILTER html %]
+  [% END %]
+  [% IF file.plus_lines %]
+    [% IF file.minus_lines %]
+      (-[% file.minus_lines %]&nbsp;/&nbsp;+[% file.plus_lines %]&nbsp;lines)
+    [% ELSE %]
+      (+[% file.plus_lines %]&nbsp;lines)
+    [% END %]
+  [% ELSE %]
+    [% IF file.minus_lines %]
+      (-[% file.minus_lines %]&nbsp;lines)
+    [% END %]
+  [% END %]
+</td></tr></thead><tbody class="[% collapsed ? 'file_collapse' : 'file' %]">
+<script type="text/javascript">
+incremental_restore()
+</script>
+
+[% section_num = 0 %]
+[% FOREACH section = sections %]
+  [% section_num = section_num + 1 %]
+  <tr><th colspan="4" class="section_head">
+    <table id="[% file.filename FILTER html %]_sec[% section_num %]" cellpadding="0" cellspacing="0">
+    <tr><th width="95%" align="left">
+  [% IF file.is_add %]
+    Added
+  [% ELSIF file.is_remove %]
+    [% IF bonsai_prefix %]
+      <a href="[% bonsai_prefix %]">Removed</a>
+    [% ELSE %]
+      Removed
+    [% END %]
+  [% ELSE %]
+    [% IF bonsai_prefix %]
+      <a href="[% bonsai_prefix %]#[% section.old_start %]">
+    [% END %]
+    [% IF section.old_lines > 1 %]
+      &nbsp;Lines&nbsp;[% section.old_start %]-[% section.old_start + 
+                                             section.old_lines - 1 %]
+    [% ELSE %]
+      Line&nbsp;[% section.old_start %]
+    [% END %]
+    [% IF bonsai_prefix %]
+      </a>
+    [% END %]
+    &nbsp;&nbsp;[% section.func_info FILTER html IF section.func_info %]
+  [% END %] 
+    </th><th>
+  <a href="#[% file.filename FILTER html %]_sec[% section_num %]">Link&nbsp;Here</a>&nbsp;
+    </th></tr></table>
+  </th></tr>
+  [% current_line_old = section.old_start %]
+  [% current_line_new = section.new_start %]
+  [% FOREACH group = section.groups %]
+    [% IF group.context %]
+      [% FOREACH line = group.context %]
+        <tr>
+          <td class="num">[% current_line_old %]</td>
+          <td><pre>[% line FILTER html %]</pre></td>
+          <td class="num">[% current_line_new %]</td>
+          <td><pre>[% line FILTER html %]</pre></td>
+        </tr>
+        [% current_line_old = current_line_old + 1 %]
+        [% current_line_new = current_line_new + 1 %]
+      [% END %]
+    [% END %]
+    [% IF group.plus.size %]
+      [% IF group.minus.size %]
+        [% i = 0 %]
+        [% WHILE (i < group.plus.size || i < group.minus.size) %]
+          [%# WHILE cannot loop more than 1000 times by default, so we break it every 500 times. %]
+          [% currentloop = 0 %]
+          [% WHILE currentloop < 500 && (i < group.plus.size || i < group.minus.size) %]
+            <tr>
+            [% IF i < group.minus.size %]
+              <td class="num">[% current_line_old + i %]</td>
+              <td class="changed"><pre>[% group.minus.$i FILTER html %]</pre></td>
+            [% ELSIF i == group.minus.size %]
+              [% rowspan = group.plus.size - group.minus.size %]
+              <td class="num"[% IF rowspan > 1 %] rowspan="[% rowspan FILTER none %]"[% END %]></td>
+              <td class="changed"[% IF rowspan > 1 %] rowspan="[% rowspan FILTER none %]"[% END %]></td>
+            [% END %]
+
+            [% IF i < group.plus.size %]
+              <td class="num">[% current_line_new + i %]</td>
+              <td class="changed"><pre>[% group.plus.$i FILTER html %]</pre></td>
+            [% ELSIF i == group.plus.size %]
+              [% rowspan = group.minus.size - group.plus.size %]
+              <td class="num"[% IF rowspan > 1 %] rowspan="[% rowspan FILTER none %]"[% END %]></td>
+              <td class="changed"[% IF rowspan > 1 %] rowspan="[% rowspan FILTER none %]"[% END %]></td>
+            [% END %]
+            </tr>
+            [% currentloop = currentloop + 1 %]
+            [% i = i + 1 %]
+          [% END %]
+        [% END %]
+        [% current_line_old = current_line_old + group.minus.size %]
+        [% current_line_new = current_line_new + group.plus.size %]
+      [% ELSE %]
+        [% FOREACH line = group.plus %]
+          [% IF file.is_add %]
+            <tr>
+              <td class="num">[% current_line_new %]</td>
+              <td class="added" colspan="3"><pre>[% line FILTER html %]</pre></td>
+            </tr>
+          [% ELSE %]
+            <tr>
+            [% IF loop.first %]
+              <td class="num"[% IF group.plus.size > 1 %] rowspan="[% group.plus.size %]"[% END %]></td>
+              <td[% IF group.plus.size > 1 %] rowspan="[% group.plus.size %]"[% END %]></td>
+            [% END %]
+              <td class="num">[% current_line_new %]</td>
+              <td class="added"><pre>[% line FILTER html %]</pre></td>
+            </tr>
+          [% END %]
+          [% current_line_new = current_line_new + 1 %]
+        [% END %]
+      [% END %]
+    [% ELSE %]
+      [% IF group.minus.size %]
+        [% FOREACH line = group.minus %]
+          [% IF file.is_remove %]
+            <tr>
+              <td class="num">[% current_line_old %]</td>
+              <td class="removed" colspan="3"><pre>[% line FILTER html %]</pre></td>
+            </tr>
+          [% ELSE %]
+            <tr>
+              <td class="num">[% current_line_old %]</td>
+              <td class="removed"><pre>[% line FILTER html %]</pre></td>
+            [% IF loop.first %]
+              <td class="num"[% IF group.minus.size > 1 %] rowspan="[% group.minus.size %]"[% END %]></td>
+              <td[% IF group.minus.size > 1 %] rowspan="[% group.minus.size %]"[% END %]></td>
+            [% END %]
+            </tr>
+          [% END %]
+          [% current_line_old = current_line_old + 1 %]
+        [% END %]
+      [% END %]
+    [% END %]
+  [% END %]
+[% END %]
+
+</table>

diff --git a/template/en/default/attachment/diff-footer.html.tmpl b/template/en/default/attachment/diff-footer.html.tmpl
new file mode 100644 (file)
index 0000000..0e95423
--- /dev/null
+++ b/template/en/default/attachment/diff-footer.html.tmpl
@@ -0,0 +1,21 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+</form>
+
+[% IF headers %]
+
+  <br>
+  <span>Return to [% "$terms.bug $bugid" FILTER bug_link(bugid) FILTER none %]</span>
+
+  [% PROCESS global/footer.html.tmpl %]
+ 
+[% ELSE %]
+</body>
+</html>
+[% END %]

diff --git a/template/en/default/attachment/diff-header.html.tmpl b/template/en/default/attachment/diff-header.html.tmpl
new file mode 100644 (file)
index 0000000..ed4d44e
--- /dev/null
+++ b/template/en/default/attachment/diff-header.html.tmpl
@@ -0,0 +1,139 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# Define strings that will serve as the title and header of this page %]
+
+[% title = BLOCK %]
+  [% IF attachid %]
+Attachment #[% attachid %] for [% terms.bug %] #[% bugid %]
+  [% ELSE %]
+Interdiff of #[% oldid %] and #[% newid %] for [% terms.bug %] #[% bugid %]
+  [% END %]
+[% END %]
+
+[% onload = 'restore_all(); document.checkboxform.restore_indicator.checked = true' %]
+
+[% BLOCK viewurl %]attachment.cgi?id=[% id %][% END %]
+[% BLOCK editurl %][% PROCESS viewurl %]&action=edit[% END %]
+[% BLOCK diffurl %][% PROCESS viewurl %]&action=diff[% END %]
+
+[% IF headers %]
+  [% header = BLOCK %]
+    [% IF attachid %]
+      Attachment #[% attachid %]: [% description FILTER html %]
+    [% ELSE %]
+      Diff Between 
+       #[% oldid %]: <a href="[% PROCESS diffurl id=oldid %]">[% old_desc FILTER html %]</a>
+      and 
+       #[% newid %]: <a href="[% PROCESS diffurl id=newid %]">[% new_desc FILTER html %]</a>
+    [% END %]
+    for <a href="show_bug.cgi?id=[% bugid %]">[% terms.bug %] #[% bugid %]</a>
+  [% END %]
+  [% subheader = BLOCK %]
+    [% bugsummary FILTER html %]
+  [% END %]
+  [% PROCESS global/header.html.tmpl doc_section = "attachments.html#patchviewer"
+                                     javascript_urls = "js/attachment.js"
+                                     style_urls = ['skins/standard/attachment.css'] %]
+[% ELSE %]
+  <html>
+  <head>
+  <link href="[% 'skins/standard/attachment.css' FILTER mtime %]" 
+        rel="stylesheet" type="text/css">
+  <script src="[% 'js/attachment.js' FILTER mtime %]" 
+          type="text/javascript"></script>
+  </head>
+  <body onload="[% onload FILTER html %]">
+[% END %]
+  
+[%# If we have attachid, we are in diff, otherwise we're in interdiff %]
+[% IF attachid %]
+  [%# HEADER %]
+  [% IF headers %]
+    <a href="[% PROCESS viewurl id=attachid %]">View</a>
+    | <a href="[% PROCESS editurl id=attachid %]">Details</a>
+    | <a href="[% PROCESS diffurl id=attachid %]&amp;context=[% context FILTER uri %]&amp;collapsed=[% collapsed FILTER uri %]&amp;headers=[% headers FILTER uri %]&amp;format=raw">Raw&nbsp;Unified</a>
+    | Return to [% "$terms.bug $bugid" FILTER bug_link(bugid) FILTER none %]
+  [% END %]
+  [% IF other_patches.size > 0 %]
+    [% IF headers %] |[%END%]
+    Differences between
+    <form style="display: inline" action="attachment.cgi">
+      <select name="oldid">
+      [% FOREACH patch = other_patches %]
+        <option value="[% patch.id %]"
+        [% IF patch.selected %] selected[% END %]
+        >[% patch.desc FILTER html %]</option>
+      [% END %]
+      </select>
+      and this patch
+      <input type="submit" id="diff" value="Diff">
+      <input type="hidden" name="action" value="interdiff">
+      <input type="hidden" name="newid" value="[% attachid %]">
+      <input type="hidden" name="headers" value="[% headers FILTER html %]">
+    </form>
+  [% END %]
+  <br>
+[% ELSE %]
+  [% IF headers %]
+    <a href="attachment.cgi?oldid=[% oldid %]&amp;newid=[% newid %]&amp;action=interdiff&amp;format=raw">Raw Unified</a>
+    | Return to [% "$terms.bug $bugid" FILTER bug_link(bugid) FILTER none %]
+    |
+  [% END %]
+[% END %]
+  
+[%# Collapse / Expand %]
+<a href="#"
+   onmouseover="lastStatus = window.status; window.status='Collapse All'; return true"
+   onmouseout="window.status = lastStatus; return true"
+   onclick="return collapse_all()">Collapse All</a> | 
+<a href="#"
+   onmouseover="lastStatus = window.status; window.status='Expand All'; return true"
+   onmouseout="window.status = lastStatus; return true"
+   onclick="return expand_all()">Expand All</a>
+
+[% IF do_context %]
+  [%# only happens for normal viewing, not interdiff %]
+  | <span style='font-weight: bold'>Context:</span>
+  [% IF context == "patch" %]
+    (<strong>Patch</strong> / 
+  [% ELSE %]
+    (<a href="[% PROCESS diffurl id=attachid %]&amp;headers=[% headers FILTER uri %]">Patch</a> / 
+  [% END %]
+  [% IF context == "file" %]
+    <strong>File</strong> /
+  [% ELSE %]
+    <a href="[% PROCESS diffurl id=attachid %]&amp;headers=[% headers FILTER uri %]&amp;context=file">File</a> / 
+  [% END %]
+
+  [% IF context == "patch" || context == "file" %]
+    [% context = 3 %]
+  [% END %]
+  [%# textbox for context %]
+  <form style="display: inline" action="attachment.cgi"><input type="hidden" name="action" value="diff"><input type="hidden" name="id" value="[% attachid %]"><input type="hidden" name="collapsed" value="[% collapsed FILTER html %]"><input type="hidden" name="headers" value="[% headers FILTER html %]"><input type="text" name="context" value="[% context FILTER html %]" size="3"></form>)
+[% END %]
+
+[% IF warning %]
+<h2 class="warning">Warning: 
+  [% IF warning == "interdiff1" %]
+  this difference between two patches may show things in the wrong places due
+  to a limitation in [% terms.Bugzilla %] when comparing patches with different
+  sets of files.
+  [% END %]
+  [% IF warning == "interdiff2" %]
+  this difference between two patches may be inaccurate due to a limitation in
+  [%+ terms.Bugzilla %] when comparing patches made against different revisions.
+  [% END %]
+</h2>
+[% ELSE %]
+    <br><br>
+[% END %]
+ 
+[%# Restore Stuff %]
+<form name="checkboxform" action="attachment.cgi">
+<input type="checkbox" name="restore_indicator" style="display: none">

diff --git a/template/en/default/attachment/edit.html.tmpl b/template/en/default/attachment/edit.html.tmpl
new file mode 100644 (file)
index 0000000..67dcabd
--- /dev/null
+++ b/template/en/default/attachment/edit.html.tmpl
@@ -0,0 +1,331 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# Define strings that will serve as the title and header of this page %]
+[% title = BLOCK %]
+  Attachment [% attachment.id %] Details for [% terms.Bug %] [%+ attachment.bug_id %]
+[% END %]
+[% header = BLOCK %]
+  Attachment [% attachment.id %] Details for
+  [%+ "$terms.Bug ${attachment.bug_id}" FILTER bug_link(attachment.bug_id) FILTER none %]
+[% END %]
+[% subheader = BLOCK %][% attachment.bug.short_desc FILTER html %][% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+  header = header
+  subheader = subheader
+  doc_section = "attachments.html"
+  javascript_urls = ['js/attachment.js', 'js/field.js']
+  style_urls = ['skins/standard/attachment.css']
+  yui = [ 'autocomplete' ]
+  bodyclasses = "no_javascript"
+%]
+
+[%# No need to display the Diff button and iframe if the attachment is not a patch. %]
+[% use_patchviewer = (feature_enabled('patch_viewer') && attachment.ispatch) %]
+[% can_edit = attachment.validate_can_edit %]
+[% editable_or_hide = can_edit ? "" : " bz_hidden_option" %]
+
+<form method="post" action="attachment.cgi" onsubmit="normalizeComments();">
+  <input type="hidden" name="id" value="[% attachment.id %]">
+  <input type="hidden" name="action" value="update">
+  <input type="hidden" name="contenttypemethod" value="manual">
+  <input type="hidden" name="delta_ts" value="[% attachment.modification_time FILTER html %]">
+  [% IF user.id %]
+    <input type="hidden" name="token" value="[% issue_hash_token([attachment.id, attachment.modification_time]) FILTER html %]">
+  [% END %]
+
+  <div id="attachment_info" class="attachment_info [% IF can_edit %] edit[% ELSE %] read[% END%]">
+    <div id="attachment_attributes">
+      <div id="attachment_information_read_only" class="[% "bz_private" IF attachment.isprivate %]">
+        <div class="title">
+          [% "[patch]" IF attachment.ispatch%] 
+          <span class="[% "bz_obsolete" IF attachment.isobsolete %]" title="[% "obsolete" IF attachment.isobsolete %]">              
+            [% attachment.description FILTER html %]
+          </span>
+          [% IF can_edit %]
+            <span class="bz_edit">(<a href="javascript:toggle_attachment_details_visibility()">edit details</a>)</span>
+          [% END %]
+        </div>
+        <div class="details">
+          [% attachment.filename FILTER html %] ([% attachment.contenttype FILTER html %]),
+          [% IF attachment.datasize %]
+            [%+ attachment.datasize FILTER unitconvert %]
+          [% ELSE %]
+            <em>deleted</em>
+          [% END %], created by [%+ INCLUDE global/user.html.tmpl who = attachment.attacher %] on [%+ attachment.attached FILTER time %]
+          [% IF attachment.isprivate %];
+            <span class="bz_private">only visible to <strong>[% Param('insidergroup') FILTER html %]</strong> members</span>
+          [% END %]
+        </div>
+      </div>
+      <div id="attachment_information_edit">
+        <span class="bz_hide">
+          (<a href="javascript:toggle_attachment_details_visibility();">hide</a>)
+        </span>
+        <div id="attachment_description">
+          <label for="description">Description:</label>&nbsp;
+          [% INCLUDE global/textarea.html.tmpl
+            id             = 'description'
+            name           = 'description'
+            minrows        = 3
+            cols           = 25
+            wrap           = 'soft'
+            classes        = 'block' _ editable_or_hide
+            defaultcontent = attachment.description
+          %]          
+        </div>
+
+          <div id="attachment_filename">
+            <label for="filename">Filename:</label>
+            <input type="text" size="20"  class="text block[% editable_or_hide %]"
+                   id="filename" name="filename"
+                   value="[% attachment.filename FILTER html %]">     
+          </div>
+
+          <div id="attachment_mimetype">
+            <label for="contenttypeentry">MIME Type:</label>
+            <input type="text" size="20" class="text block[% editable_or_hide %]"
+                   id="contenttypeentry" name="contenttypeentry"
+                   value="[% attachment.contenttype FILTER html %]">                   
+          </div>
+          
+          <div id="attachment_creator">
+            <span class="label">Creator:</span>
+            [%+ INCLUDE global/user.html.tmpl who = attachment.attacher %]
+          </div>
+
+          <div id="attachment_created">
+            <span class="label">Created:</span>
+            [%+ attachment.attached FILTER time %]
+          </div>
+
+          <div id="attachment_size">
+            <span class="label">Size:</span>
+            [% IF attachment.datasize %]
+              [%+ attachment.datasize FILTER unitconvert %]
+            [% ELSE %]
+              <em>deleted</em>
+            [% END %]
+          </div>
+
+          <div id="attachment_ispatch">
+            <input type="checkbox" id="ispatch" name="ispatch" value="1"
+                   [%+ 'checked="checked"' IF attachment.ispatch %]>
+                   <label for="ispatch">patch</label>
+          </div>
+
+        <div class="readonly">
+          <div class="checkboxes">
+            <div id="attachment_isobsolete">
+              <input type="checkbox" id="isobsolete" name="isobsolete" value="1"                     
+                     [%+ 'checked="checked"' IF attachment.isobsolete %]>
+                <label for="isobsolete">obsolete</label>
+            </div>
+
+            [% IF user.is_insider %]
+              <div id="attachment_isprivate">
+                <input type="checkbox" id="isprivate" name="isprivate" value="1"
+                       [%+ 'checked="checked"' IF attachment.isprivate %]>
+                [% IF can_edit %]
+                  <label for="isprivate">private (only visible to
+                    <strong>[% Param('insidergroup') FILTER html %]</strong>)
+                  </label>
+                [% ELSE %]
+                  <span class="label">Is Private:</span>
+                  [%+ attachment.isprivate ? "yes" : "no" %]
+                [% END %]
+              </div>
+            [% END %]
+          </div>
+        </div>                    
+      </div>
+
+      <div id="attachment_view_window">
+        [% IF !attachment.datasize %]
+          <div><b>The content of this attachment has been deleted.</b></div>
+        [% ELSIF !Param("allow_attachment_display") %]
+          <div id="view_disabled">
+            <p><b>
+              The attachment is not viewable in your browser due to security
+              restrictions enabled by your [% terms.Bugzilla %] administrator.
+            </b></p>
+            <p><b>
+              In order to view the attachment, you first have to
+              <a href="attachment.cgi?id=[% attachment.id %]">download it</a>.
+            </b></p>
+          </div>
+        [% ELSIF attachment.is_viewable %]
+          <div>
+            [% INCLUDE global/textarea.html.tmpl
+              id      = 'editFrame'
+              name    = 'comment'
+              classes   = 'bz_default_hidden'
+              minrows = 10
+              cols    = 80
+              wrap    = 'soft'
+              disabled = 'disabled'
+              defaultcontent = (attachment.contenttype.match('^text\/')) ?
+                                 attachment.data.replace('(.*\n|.+)', '>$1') : undef
+            %]
+            [% IF attachment.contenttype == 'text/plain' AND is_safe_url(attachment.data) %]
+              <p>
+                <a href="[% attachment.data FILTER html %]">
+                  [% IF attachment.datasize < 120 %]
+                    [% attachment.data FILTER html %]
+                  [% ELSE %]
+                    [% attachment.data FILTER truncate(80) FILTER html %]
+                    ...
+                    [% attachment.data.match('.*(.{20})$').0 FILTER html %]
+                  [% END %]
+                </a>
+              </p>
+            [% ELSIF attachment.contenttype == "text/html" %]
+              [%# For security reasons (clickjacking, embedded scripts), we never
+                # render HTML pages from here. The source code is displayed instead. %]
+              [% INCLUDE global/textarea.html.tmpl
+                 id      = 'viewFrame'
+                 minrows = 10
+                 cols    = 80
+                 defaultcontent = attachment.data
+                 readonly = 'readonly'
+              %]
+            [% ELSE %]
+              <iframe id="viewFrame" src="attachment.cgi?id=[% attachment.id %]">
+                <b>You cannot view the attachment while viewing its details because your browser does not support IFRAMEs.
+                <a href="attachment.cgi?id=[% attachment.id %]">View the attachment on a separate page</a>.</b>
+              </iframe>
+            [% END %]
+            <script type="text/javascript">
+              <!--
+              var patchviewerinstalled = 0;
+              var attachment_id = [% attachment.id %];
+              if (typeof document.getElementById == "function") {
+                [% IF use_patchviewer %]
+                  var patchviewerinstalled = 1;
+                  document.write('<iframe id="viewDiffFrame" class="bz_default_hidden"><\/iframe>');
+                [% END %]
+                [% IF user.id %]
+                  document.write('<button type="button" id="editButton" onclick="editAsComment(patchviewerinstalled);">Edit Attachment As Comment<\/button>');
+                  document.write('<button type="button" id="undoEditButton" onclick="undoEditAsComment(patchviewerinstalled);" class="bz_default_hidden">Undo Edit As Comment<\/button>');
+                  document.write('<button type="button" id="redoEditButton" onclick="redoEditAsComment(patchviewerinstalled);" class="bz_default_hidden">Redo Edit As Comment<\/button>');
+                  var editFrame = document.getElementById('editFrame');
+                  if (editFrame) {
+                    editFrame.disabled = false;
+                  }
+                [% END %]
+                [% IF use_patchviewer %]
+                  document.write('<button type="button" id="viewDiffButton" onclick="viewDiff(attachment_id, patchviewerinstalled);">View Attachment As Diff<\/button>');
+                [% END %]
+                document.write('<button type="button" id="viewRawButton" onclick="viewRaw(patchviewerinstalled);" class="bz_default_hidden">View Attachment As Raw<\/button>');
+              }
+              //-->
+            </script>
+          </div>
+        [% ELSE %]
+          <div id="noview">
+            <p><b>
+              Attachment is not viewable in your browser because its MIME type 
+              ([% attachment.contenttype FILTER html %]) is not one that your browser is 
+              able to display.
+            </b></p>
+            <p><b>
+              <a href="attachment.cgi?id=[% attachment.id %]">Download the attachment</a>.
+            </b></p>
+          </div>
+        [% END %]
+      </div>
+      <div id="attachment_comments_and_flags">
+        [% IF user.id %]
+          <div id="smallCommentFrame" >
+            <label for="comment">Comment (on the [% terms.bug %]):</label>
+            [% classNames = 'block' %]
+            [% classNames = "$classes bz_private" IF attachment.isprivate %]
+            [% INCLUDE global/textarea.html.tmpl
+              id      = 'comment'
+              name    = 'comment'
+              minrows = 10
+              cols    = 80
+              wrap    = 'soft'
+              classes = classNames
+            %]
+            [% IF NOT attachment.bug.cc || NOT attachment.bug.cc.contains(user.login) %]
+              <input type="checkbox" id="addselfcc" name="addselfcc"
+                [%~ ' checked="checked"'
+                    IF user.settings.state_addselfcc.value == 'always'
+                       || (!attachment.bug.user.has_any_role
+                           && user.settings.state_addselfcc.value == 'cc_unless_role') %]>
+              <label for="addselfcc">Add me to CC list</label>
+            [% END %]
+          </div>
+        [% END %]
+        <div id="attachment_flags">
+          [% IF attachment.flag_types.size > 0 %]
+              [% PROCESS "flag/list.html.tmpl" flag_types = attachment.flag_types
+                                               read_only_flags = !can_edit
+              %]
+     
+          [% END %]
+        </div>
+
+        [% Hook.process('form_before_submit') %]
+
+        [% IF user.id %]       
+          <div id="update_container">
+            <input type="submit" value="Submit" id="update">
+          </div>
+        [% END %]        
+      </div>        
+    </div>
+  </div>
+</form>
+
+<div id="attachment_actions">
+  <span class="label">Actions:</span>
+  <a href="attachment.cgi?id=[% attachment.id %]">View</a>
+  [% IF use_patchviewer %]
+    | <a href="attachment.cgi?id=[% attachment.id %]&amp;action=diff">Diff</a>
+  [% END %]
+  [% IF Param("allow_attachment_deletion")
+        && user.in_group('admin')
+        && attachment.datasize > 0 %]
+    | <a href="attachment.cgi?id=[% attachment.id %]&amp;action=delete">Delete</a>
+  [% END %]
+  [% Hook.process('action') %]
+</div>
+
+<div id="attachment_list">
+  Attachments on [% "$terms.bug ${attachment.bug_id}" FILTER bug_link(attachment.bug_id) FILTER none %]:
+  [% FOREACH a = attachments %]
+    [% IF a.isobsolete %]
+      <span class="bz_obsolete">
+    [% END %]
+    [% IF a.id == attachment.id %]
+      [%+ a.id FILTER html %]
+    [% ELSE %]
+      <a href="attachment.cgi?id=[% a.id FILTER uri %]&amp;action=edit"
+         title="[% a.description FILTER html %]">[% a.id FILTER html %]</a>
+    [% END %]
+    [% IF a.isobsolete %]
+      </span>
+    [% END %]
+    [% " |" UNLESS loop.last() %]
+  [% END %]
+</div>
+[% IF can_edit %]
+  <script type="text/javascript">
+    <!--
+      YAHOO.util.Dom.removeClass( document.body, "no_javascript" );
+      toggle_attachment_details_visibility( );
+    -->
+  </script>
+[% END %]
+[% Hook.process('end') %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/attachment/list.html.tmpl b/template/en/default/attachment/list.html.tmpl
new file mode 100644 (file)
index 0000000..e30492c
--- /dev/null
+++ b/template/en/default/attachment/list.html.tmpl
@@ -0,0 +1,165 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% RETURN UNLESS attachments.size || Param("maxattachmentsize") || Param("maxlocalattachment") %]
+
+<script type="text/javascript">
+<!--
+function toggle_display(link) {
+    var table = document.getElementById("attachment_table");
+    var view_all = document.getElementById("view_all");
+    var hide_obsolete_url_parameter = "&hide_obsolete=1";
+    // Store current height for scrolling later
+    var originalHeight = table.offsetHeight;
+    var rows = YAHOO.util.Dom.getElementsByClassName(
+        'bz_tr_obsolete', 'tr', table);
+
+    for (var i = 0; i < rows.length; i++) {
+        bz_toggleClass(rows[i], 'bz_default_hidden');
+    }
+
+    if (YAHOO.util.Dom.hasClass(rows[0], 'bz_default_hidden')) {
+        link.innerHTML = "Show Obsolete";
+        view_all.href = view_all.href + hide_obsolete_url_parameter 
+    }
+    else {
+        link.innerHTML = "Hide Obsolete";
+        view_all.href = view_all.href.replace(hide_obsolete_url_parameter,"");
+    }
+
+    var newHeight = table.offsetHeight;
+    // This scrolling makes the window appear to not move at all.
+    window.scrollBy(0, newHeight - originalHeight);
+
+    return false;
+}
+//-->
+</script>
+
+<br>
+<table id="attachment_table" cellspacing="0" cellpadding="4">
+  <tr id="a0">
+    <th colspan="[% show_attachment_flags ? 3 : 2 %]" align="left">
+      Attachments
+    </th>
+  </tr>
+
+  [% count = 0 %]
+  [% obsolete_attachments = 0 %]
+  [% user_cache = template_cache.users %]
+
+  [% FOREACH attachment = attachments %]
+    [% count = count + 1 %]
+    [% IF !attachment.isprivate || user.is_insider || attachment.attacher.id == user.id %]
+      [% IF attachment.isobsolete %]
+        [% obsolete_attachments = obsolete_attachments + 1 %]
+      [% END %]
+      <tr id="a[% count %]" class="[% "bz_contenttype_" _ attachment.contenttype
+                     FILTER css_class_quote %]
+                 [% " bz_patch" IF attachment.ispatch %]
+                 [% " bz_private" IF attachment.isprivate %]
+                 [% " bz_tr_obsolete bz_default_hidden" 
+                     IF attachment.isobsolete %]">
+        <td valign="top">
+          [% IF attachment.datasize %]
+            <a href="attachment.cgi?id=[% attachment.id %]"
+               title="View the content of the attachment">
+          [% END %]
+          <b>[% attachment.description FILTER html FILTER obsolete(attachment.isobsolete) %]</b>
+          [% "</a>" IF attachment.datasize %]
+
+          <span class="bz_attach_extra_info">
+            [% IF attachment.datasize %]
+              ([% attachment.datasize FILTER unitconvert %],
+              [% IF attachment.ispatch %]
+                patch)
+              [% ELSE %]
+                [%+ attachment.contenttype FILTER html %])
+              [% END %]
+            [% ELSE %]
+              (<em>deleted</em>)
+            [% END %]
+
+            <br>
+            <a href="#attach_[% attachment.id %]"
+               title="Go to the comment associated with the attachment">
+              [%- attachment.attached FILTER time %]</a>,
+
+            [%# No need to recreate the exact same template if we already have it. %]
+            [% attacher_id = attachment.attacher.id %]
+            [% UNLESS user_cache.$attacher_id %]
+              [% user_cache.$attacher_id = BLOCK %]
+                [% INCLUDE global/user.html.tmpl who = attachment.attacher %]
+              [% END %]
+            [% END %]
+            [% user_cache.$attacher_id FILTER none %]
+          </span>
+        </td>
+
+        [% IF show_attachment_flags %]
+          <td class="bz_attach_flags" valign="top">
+            [% IF attachment.flags.size == 0 %]
+              <i>no flags</i>
+            [% ELSE %]
+              [% FOREACH flag = attachment.flags %]
+                [% IF user.id %]
+                  <span title="[% flag.setter.identity FILTER html %]">[% flag.setter.nick FILTER html %]</span>:
+                [% ELSIF flag.setter.name %]
+                  <span title="[% flag.setter.name FILTER html %]">[% flag.setter.nick FILTER html %]</span>:
+                [% ELSE %]
+                  [% flag.setter.nick FILTER html %]:
+                [% END %]
+                [%+ flag.type.name FILTER html FILTER no_break %][% flag.status %]
+                [%+ IF flag.status == "?" && flag.requestee %]
+                  [% IF user.id %]
+                    (<span title="[% flag.requestee.identity FILTER html %]">[% flag.requestee.nick FILTER html %]</span>)
+                  [% ELSIF flag.requestee.name %]
+                    (<span title="[% flag.requestee.name FILTER html %]">[% flag.requestee.nick FILTER html %]</span>)
+                  [% ELSE %]
+                    ([% flag.requestee.nick FILTER html %])
+                  [% END %]
+                [% END %]<br>
+              [% END %]
+            [% END %]
+          </td>
+        [% END %]
+
+        <td valign="top">
+          <a href="attachment.cgi?id=[% attachment.id %]&amp;action=edit">Details</a>
+          [% IF attachment.ispatch && feature_enabled('patch_viewer') %]
+            | <a href="attachment.cgi?id=[% attachment.id %]&amp;action=diff">Diff</a>
+          [% END %]
+          [% Hook.process("action") %]
+        </td>
+      </tr>
+    [% END %]
+  [% END %]
+
+  <tr class="bz_attach_footer">
+    <td colspan="[% show_attachment_flags ? 3 : 2 %]">
+      [% IF attachments.size %]
+        <span class="bz_attach_view_hide">
+          [% IF obsolete_attachments %]
+            <a href="#a0" onclick="return toggle_display(this);">Show
+              Obsolete</a> ([% obsolete_attachments %])
+          [% END %]
+          [% IF Param("allow_attachment_display") %]
+            <a id="view_all" href="attachment.cgi?bugid=
+                  [%- bugid %]&amp;action=viewall
+                  [%- "&amp;hide_obsolete=1" IF obsolete_attachments %]">View All</a>
+          [% END %]
+        </span>
+      [% END %]
+      [% IF Param("maxattachmentsize") || Param("maxlocalattachment") %]
+        <a href="attachment.cgi?bugid=[% bugid %]&amp;action=enter">Add an attachment</a>
+        (proposed patch, testcase, etc.)
+      [% END %]
+    </td>
+  </tr>
+</table>
+<br>

diff --git a/template/en/default/attachment/midair.html.tmpl b/template/en/default/attachment/midair.html.tmpl
new file mode 100644 (file)
index 0000000..68db5d9
--- /dev/null
+++ b/template/en/default/attachment/midair.html.tmpl
@@ -0,0 +1,64 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # operations: array; bug activity since the user last displayed the attachment form,
+  #   used by bug/activity/table.html.tmpl to display recent changes that will
+  #   be overwritten if the user submits these changes.  See that template
+  #   for further documentation.
+  # attachment: object; the attachment being changed.
+  #%]
+
+[%# The global Bugzilla->cgi object is used to obtain form variable values. %]
+[% USE Bugzilla %]
+[% cgi = Bugzilla.cgi %]
+
+[% PROCESS global/header.html.tmpl title = "Mid-air collision!" %]
+
+<h1>Mid-air collision detected!</h1>
+
+<p>
+  Someone else has made changes to
+  <a href="attachment.cgi?id=[% attachment.id %]&amp;action=edit">attachment [% attachment.id %]</a>
+  of [% "$terms.bug $attachment.bug_id" FILTER bug_link(attachment.bug_id) FILTER none %]
+  at the same time you were trying to. The changes made were:
+</p>
+
+<p>
+  [% PROCESS "bug/activity/table.html.tmpl" incomplete_data=0 %]
+</p>
+
+[% IF cgi.param("comment") %]
+<p>
+  Your comment was:<br>
+  <blockquote><pre class="bz_comment_text">
+    [% cgi.param("comment") FILTER html %]
+  </pre></blockquote>
+</p>
+[% END %]
+
+<p>
+You have the following choices:
+</p>
+
+<ul>
+  <li>
+    <form method="post" action="attachment.cgi">
+      [% PROCESS "global/hidden-fields.html.tmpl" exclude="^Bugzilla_(login|password)$" %]
+      <input type="submit" id="process" value="Submit my changes anyway">
+        This will cause all of the above changes to be overwritten.
+    </form>
+  </li>
+  <li>
+    Throw away my changes, and
+    <a href="attachment.cgi?id=[% attachment.id %]&amp;action=edit">revisit
+    attachment [% attachment.id %]</a>
+  </li>
+</ul>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/attachment/show-multiple.html.tmpl b/template/en/default/attachment/show-multiple.html.tmpl
new file mode 100644 (file)
index 0000000..8791e0d
--- /dev/null
+++ b/template/en/default/attachment/show-multiple.html.tmpl
@@ -0,0 +1,106 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% filtered_summary = bugsummary FILTER html %]
+[% header = BLOCK %]View All Attachments for
+  [%+ "$terms.Bug $bug.id" FILTER bug_link(bug) FILTER none %][% END %]
+
+[% title = BLOCK %]
+  View All Attachments for [% terms.Bug %] [%+ bug.bug_id FILTER html %]
+[% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+  header = header
+  subheader = filtered_summary
+  style_urls = ['skins/standard/attachment.css']
+%]
+[% IF hide_obsolete %]
+  <div id="hidden_obsolete_message">
+    Obsolete attachments are hidden. To view all attachments (including obsolete) 
+    <a href="attachment.cgi?bugid=[% bug.id FILTER html %]&amp;action=viewall">click here</a>.
+  </div>
+[% END %]
+<br>
+
+[% FOREACH a = attachments %]
+
+  <div align="center">
+  <table class="attachment_info" cellspacing="0" cellpadding="4" border="1" width="75%">
+    <tr>
+      <td valign="top" bgcolor="#cccccc" colspan="6">
+        <big><b>Attachment #[% a.id %]</b></big>
+      </td>
+    </tr>
+    <tr>
+      <td valign="top">
+        [% a.description FILTER html FILTER obsolete(a.isobsolete) %]
+      </td>
+
+      <td valign="top">
+        [% IF a.ispatch %]
+          <i>patch</i>
+        [% ELSE %]
+          [% a.contenttype FILTER html %]
+        [% END %]
+      </td>
+
+      <td valign="top">[% a.attached FILTER time %]</td>
+      <td valign="top">[% a.datasize FILTER unitconvert %]</td>
+
+      <td valign="top">
+        [% IF a.flags.size == 0 %]
+          <i>no flags</i>
+        [% ELSE %]
+          [% FOREACH flag = a.flags %]
+            [% flag.setter.nick FILTER html %]:
+            [%+ flag.type.name FILTER html %][% flag.status %]
+            [% IF flag.status == "?" && flag.requestee %]
+              ([% flag.requestee.nick FILTER html %])
+            [% END %]
+            [% ", " IF !loop.last %]
+          [% END %]
+        [% END %]
+      </td>
+
+      <td valign="top">
+        <a href="attachment.cgi?id=[% a.id %]&amp;action=edit">Details</a>
+      </td>
+    </tr>
+  </table>
+
+  [% IF a.is_viewable %]
+    [% IF a.contenttype == "text/html" %]
+      [%# For security reasons (clickjacking, embedded scripts), we never
+        # render HTML pages from here. The source code is displayed instead. %]
+      [% INCLUDE global/textarea.html.tmpl
+         minrows = 10
+         cols    = 80
+         defaultcontent = a.data
+         readonly = 'readonly'
+         classes = 'viewall_frame'
+      %]
+    [% ELSE %]
+      <iframe src="attachment.cgi?id=[% a.id %]" class="viewall_frame">
+        <b>You cannot view the attachment on this page because your browser does not support IFRAMEs.
+        <a href="attachment.cgi?id=[% a.id %]">View the attachment on a separate page</a>.</b>
+      </iframe>
+    [% END %]
+  [% ELSE %]
+    <p><b>
+      Attachment cannot be viewed because its MIME type is not text/*, image/*, or application/vnd.mozilla.*.
+      <a href="attachment.cgi?id=[% a.id %]">Download the attachment instead</a>.
+    </b></p>
+  [% END %]
+  </div>
+
+  <br><br>
+
+[% END %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/attachment/updated.html.tmpl b/template/en/default/attachment/updated.html.tmpl
new file mode 100644 (file)
index 0000000..af1cbcd
--- /dev/null
+++ b/template/en/default/attachment/updated.html.tmpl
@@ -0,0 +1,32 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # attachment: object of the attachment we just attached.
+  #%]
+
+[% bug = bugs.0 %]
+
+[% PROCESS "bug/show-header.html.tmpl" %]
+[% PROCESS global/header.html.tmpl
+  title = "Changes Submitted to Attachment $attachment.id of $terms.Bug $attachment.bug_id"
+%]
+
+<dl>
+  <dt>Changes to
+    <a href="attachment.cgi?id=[% attachment.id %]&amp;action=edit">attachment [% attachment.id %]</a>
+    of [% "$terms.bug $attachment.bug_id" FILTER bug_link(attachment.bug_id) FILTER none %] submitted
+  </dt>
+  <dd>
+    [% PROCESS "bug/process/bugmail.html.tmpl" mailing_bugid = attachment.bug_id %]
+    [%# Links to more information about the changed bug. %]
+    [% Hook.process("links") %]
+  </dd>
+</dl>
+
+[% PROCESS bug/show.html.tmpl %]

diff --git a/template/en/default/bug/activity/show.html.tmpl b/template/en/default/bug/activity/show.html.tmpl
new file mode 100644 (file)
index 0000000..a442abd
--- /dev/null
+++ b/template/en/default/bug/activity/show.html.tmpl
@@ -0,0 +1,35 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # bug: object. The bug whose activity is being displayed.
+  # operations: array of hashes, see activity/table.html.tmpl.
+  #
+  # This template also needs to be called with the interface to the
+  # activity/table.html.tmpl template fulfilled.
+  #%]
+
+[% filtered_desc = bug.short_desc FILTER html %]
+[% PROCESS global/header.html.tmpl
+  title = "Changes made to $terms.bug $bug.bug_id"
+  header = "Activity log for $terms.bug $bug.bug_id: $filtered_desc"
+ %]
+
+<p>
+  [% "Back to $terms.bug $bug.bug_id" FILTER bug_link(bug) FILTER none %]
+</p>
+
+[% PROCESS bug/activity/table.html.tmpl %]
+
+[% IF operations.size > 0 %]
+  <p>
+    [% "Back to $terms.bug $bug.bug_id" FILTER bug_link(bug) FILTER none %]
+  </p>
+[% END %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/bug/activity/table.html.tmpl b/template/en/default/bug/activity/table.html.tmpl
new file mode 100644 (file)
index 0000000..253d161
--- /dev/null
+++ b/template/en/default/bug/activity/table.html.tmpl
@@ -0,0 +1,103 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # operations: array of hashes. May be empty. Each has has three members:
+  #   who: string. who performed the operation
+  #   when: string. when they performed it
+  #   changes: hash. Details of what they changed. This hash has three
+  #            compulsory and one optional member:
+  #     field: string. The name of the field
+  #     removed: string. What was removed from the field
+  #     added: string. What was added to the field
+  #     attach_id: integer. If the change was adding an attachment, its id.
+  # incomplete_data: boolean. True if some of the data is incomplete (because
+  #                  it was affected by an old Bugzilla bug.)
+  #%]
+
+[% PROCESS bug/time.html.tmpl %]
+
+[% IF incomplete_data %]
+  <p>
+    There used to be an issue in <a href="http://www.bugzilla.org/">Bugzilla</a>
+    which caused activity data to be lost if there were a large number of cc's
+    or dependencies.  That has been fixed, but some data was already lost in
+    your activity table that could not be regenerated.  The changes that the
+    script could not reliably determine are prefixed by '?'.
+  </p>
+[% END %]
+
+[% IF operations.size > 0 %]
+  <table border cellpadding="4">
+    <tr>
+      <th>Who</th>
+      <th>When</th>
+      <th>What</th>
+      <th>Removed</th>
+      <th>Added</th>
+    </tr>
+
+    [% FOREACH operation = operations %]
+      <tr>
+        <td rowspan="[% operation.changes.size %]" valign="top">
+          [% operation.who FILTER email FILTER html %]
+        </td>
+        <td rowspan="[% operation.changes.size %]" valign="top">
+          [% operation.when FILTER time %]
+        </td>
+        [% FOREACH change = operation.changes %]
+          [% "</tr><tr>" IF loop.index > 0 %]
+            <td>
+              [% IF change.attachid %]
+                <a href="attachment.cgi?id=[% change.attachid %]">
+                Attachment #[% change.attachid %]</a>
+              [% END %]
+              [% IF change.comment.defined %]
+                 [% comment_desc = field_descs.${change.fieldname} %]
+                 [% comment_num = "Comment $change.comment.count" FILTER bug_link(bug.bug_id, comment_num => change.comment.count) %]
+                 [% comment_desc.replace('^(Comment )?', "$comment_num ") FILTER none %]
+              [% ELSE %]
+                [%+ field_descs.${change.fieldname} FILTER html %]
+              [% END %]
+            </td>
+            [% PROCESS change_column change_type = change.removed %]
+            [% PROCESS change_column change_type = change.added %]
+        [% END %]
+      </tr>
+    [% END %]
+  </table>
+[% ELSE %]
+  <p>
+    No changes have been made to this [% terms.bug %] yet.
+  </p>
+[% END %]
+
+[% BLOCK change_column %]
+  <td>
+    [% IF change_type.defined %]
+      [% IF change.fieldname == 'estimated_time' ||
+            change.fieldname == 'remaining_time' ||
+            change.fieldname == 'work_time' %]
+        [% PROCESS formattimeunit time_unit=change_type %]
+      [% ELSIF change.fieldname == 'blocked' ||
+               change.fieldname == 'dependson' %]
+        [% change_type FILTER bug_list_link FILTER none %]
+      [% ELSIF change.fieldname == 'assigned_to' ||
+               change.fieldname == 'reporter' ||
+               change.fieldname == 'qa_contact' ||
+               change.fieldname == 'cc' ||
+               change.fieldname == 'flagtypes.name' %]
+        [% display_value(change.fieldname, change_type) FILTER email FILTER html %]
+      [% ELSE %]
+        [% display_value(change.fieldname, change_type) FILTER html %]
+      [% END %]
+    [% ELSE %]
+      &nbsp;
+    [% END %]
+  </td>
+[% END %]

diff --git a/template/en/default/bug/choose.html.tmpl b/template/en/default/bug/choose.html.tmpl
new file mode 100644 (file)
index 0000000..e2289c4
--- /dev/null
+++ b/template/en/default/bug/choose.html.tmpl
@@ -0,0 +1,21 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+   title = "Search by $terms.bug number"
+ %]
+
+<form method="get" action="show_bug.cgi">
+  <p>
+    You may find a single [% terms.bug %] by entering its [% terms.bug %] id here:
+    <input name="id" size="6">
+    <input type="submit" id="show" value="Show Me This [% terms.Bug %]">
+  </p>
+</form>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/bug/comments.html.tmpl b/template/en/default/bug/comments.html.tmpl
new file mode 100644 (file)
index 0000000..61d1c67
--- /dev/null
+++ b/template/en/default/bug/comments.html.tmpl
@@ -0,0 +1,196 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS bug/time.html.tmpl %]
+
+<script src="[% 'js/comments.js' FILTER mtime %]" type="text/javascript">
+</script>
+
+<script type="text/javascript">
+<!--
+  /* Adds the reply text to the `comment' textarea */
+  function replyToComment(id, real_id, name) {
+      var prefix = "(In reply to " + name + " from comment #" + id + ")\n";
+      var replytext = "";
+      [% IF user.settings.quote_replies.value == 'quoted_reply' %]
+        /* pre id="comment_name_N" */
+        var text_elem = document.getElementById('comment_text_'+id);
+        var text = getText(text_elem);
+        replytext = prefix + wrapReplyText(text);
+      [% ELSIF user.settings.quote_replies.value == 'simple_reply' %]
+        replytext = prefix;
+      [% END %]
+
+      [% IF user.is_insider %]
+        if (document.getElementById('isprivate_' + real_id).checked) {
+            document.getElementById('newcommentprivacy').checked = 'checked';
+            updateCommentTagControl(document.getElementById('newcommentprivacy'), 'comment'); 
+        }
+      [% END %]
+
+      /* <textarea id="comment"> */
+      var textarea = document.getElementById('comment');
+      if (textarea.value != replytext) {
+          textarea.value += replytext;
+      }
+
+      textarea.focus();
+  } 
+//-->
+</script>
+
+[% DEFAULT start_at = 0 mode = "show" %]
+[% sort_order = user.settings.comment_sort_order.value %]
+[% user_cache = template_cache.users %]
+
+[%# NOTE: (start_at > 0) means we came here from a midair collision,
+  #       in which case we don't care what the user's preference is.
+ %]
+[% IF (start_at > 0) %]
+    [% sort_order = "oldest_to_newest" %]
+[% END %]
+
+<!-- This auto-sizes the comments and positions the collapse/expand links 
+     to the right. -->
+<table class="bz_comment_table" cellpadding="0" cellspacing="0"><tr>
+<td>
+
+[% FOREACH comment = comments %]
+  [% IF comment.count >= start_at %]
+    [% PROCESS a_comment %]
+  [% END %]
+[% END %]
+
+[% IF mode == "edit" && user.id
+      && user.settings.comment_box_position.value == "before_comments" %]
+  <div class="bz_add_comment">
+    <a href="#" 
+       onclick="return goto_add_comments();">
+       Add Comment</a>
+  </div>
+[% END %]
+
+[%# Note: this template is used in multiple places; if you use this hook,
+  # make sure you are aware of this fact.
+  #%]  
+[% Hook.process("aftercomments") %]
+
+</td>
+<td>
+  [% IF mode == "edit" %]
+    <ul class="bz_collapse_expand_comments">
+      <li><a href="#" onclick="toggle_all_comments('collapse'); 
+                               return false;">Collapse All Comments</a></li>
+      <li><a href="#" onclick="toggle_all_comments('expand');
+                               return false;">Expand All Comments</a></li>
+      [% IF user.settings.comment_box_position.value == "after_comments" && user.id %]
+        <li class="bz_add_comment"><a href="#" 
+            onclick="return goto_add_comments('bug_status_bottom');">
+            Add Comment</a></li>
+      [% END %]                               
+    </ul>
+  [% END %]
+</td>
+</tr></table>
+
+[%############################################################################%]
+[%# Block for individual comments                                            #%]
+[%############################################################################%]
+
+[% BLOCK a_comment %]
+  [% RETURN IF comment.is_private AND NOT (user.is_insider || user.id == comment.author.id) %]
+  [% comment_text = comment.body_full %]
+  [% RETURN IF comment_text == '' AND (comment.work_time - 0) != 0 AND !user.is_timetracker %]
+
+    <div id="c[% comment.count %]" class="bz_comment[% " bz_private" IF comment.is_private %]
+                [% " bz_comment_hilite" IF marks.${comment.count} %]
+                [% " bz_first_comment" IF comment.count == 0 %]">
+      [% IF comment.count == 0 %]
+        [% class_name = "bz_first_comment_head" %]
+        [% comment_label = "Description" %]
+      [% ELSE %]
+        [% class_name = "bz_comment_head" %]
+        [% comment_label = "Comment " _ comment.count %]
+      [% END %]
+
+      <div class="[% class_name FILTER html %]">
+
+        [% IF mode == "edit" %]
+          <span class="bz_comment_actions">
+            [% IF bug.check_can_change_field('longdesc', 0, 1) %]
+              [<a class="bz_reply_link" href="#add_comment"
+                [% IF user.settings.quote_replies.value != 'off' %]
+                  onclick="replyToComment('[% comment.count %]', '[% comment.id %]', '[% comment.author.name || comment.author.nick FILTER html FILTER js %]'); return false;"
+                [% END %]
+              >reply</a>]
+            [% END %]
+            <script type="text/javascript"><!--
+              addCollapseLink([% comment.count %], 'Toggle comment display'); // -->
+            </script>
+          </span>
+        [% END %]
+
+        [% IF mode == "edit" && user.is_insider && bug.check_can_change_field('longdesc', 0, 1) %]
+          <div class="bz_private_checkbox">
+            <input type="hidden" value="1"
+                   name="defined_isprivate_[% comment.id %]">
+            <input type="checkbox"
+                   name="isprivate_[% comment.id %]" value="1"
+                   id="isprivate_[% comment.id %]"
+                   onClick="updateCommentPrivacy(this, [% comment.count %])"
+                   [% " checked=\"checked\"" IF comment.is_private %]>
+            <label for="isprivate_[% comment.id %]">Private</label>
+          </div>
+        [% END %]
+
+        <span class="bz_comment_number">
+          <a 
+             href="show_bug.cgi?id=[% bug.bug_id %]#c[% comment.count %]">
+            [%- comment_label FILTER html %]</a>
+        </span>
+
+        <span class="bz_comment_user">
+          [%# No need to recreate the exact same template if we already have it. %]
+          [% commenter_id = comment.author.id %]
+          [% UNLESS user_cache.$commenter_id %]
+            [% user_cache.$commenter_id = BLOCK %]
+              [% INCLUDE global/user.html.tmpl who = comment.author %]
+            [% END %]
+          [% END %]
+          [% user_cache.$commenter_id FILTER none %]
+        </span>
+
+        <span class="bz_comment_user_images">
+          [% FOREACH group = comment.author.groups_with_icon %]
+            <img src="[% group.icon_url FILTER html %]"
+                 alt="[% group.name FILTER html %]"
+                 title="[% group.name FILTER html %] - [% group.description FILTER html %]">
+          [% END %]
+        </span>
+
+        <span class="bz_comment_time">
+          [%+ comment.creation_ts FILTER time %]
+        </span>
+      </div>
+
+      [% IF user.is_timetracker &&
+            (comment.work_time > 0 || comment.work_time < 0) %]
+         <br>
+         Additional hours worked: 
+         [% PROCESS formattimeunit time_unit=comment.work_time %]
+      [% END %]
+
+[%# Don't indent the <pre> block, since then the spaces are displayed in the
+  # generated HTML
+  #%]
+<pre class="bz_comment_text" 
+     [% ' id="comment_text_' _ comment.count _ '"' IF mode == "edit" %]>
+  [%- comment_text FILTER quoteUrls(bug, comment) -%]
+</pre>
+    </div>
+[% END %]

diff --git a/template/en/default/bug/create/comment-guided.txt.tmpl b/template/en/default/bug/create/comment-guided.txt.tmpl
new file mode 100644 (file)
index 0000000..e85a364
--- /dev/null
+++ b/template/en/default/bug/create/comment-guided.txt.tmpl
@@ -0,0 +1,34 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[% USE Bugzilla %]
+[% cgi = Bugzilla.cgi %]
+User-Agent:       [%+ cgi.user_agent() %]
+Build Identifier: [%+ cgi.param("buildid") %]
+
+[%+ cgi.param("comment") IF cgi.param("comment") %]
+
+[%+ IF cgi.param("reproducible") != "Choose one..." -%]
+Reproducible: [%+ cgi.param("reproducible") %]
+[% END %]
+
+[% IF !(cgi.param("reproduce_steps").match('^1\.\s*2\.\s*3\.\s*$') || cgi.param("reproduce_steps").match('^\s*$')) %]
+Steps to Reproduce:
+[%+ cgi.param("reproduce_steps") %]
+[% END %]
+
+[% IF cgi.param("actual_results") -%]
+Actual Results:  
+[%+ cgi.param("actual_results") %]
+[% END %]
+
+[% IF cgi.param("expected_results") %]
+Expected Results:  
+[%+ cgi.param("expected_results") %]
+[% END %]
+
+[%+ cgi.param("additional_info") %]

diff --git a/template/en/default/bug/create/comment.txt.tmpl b/template/en/default/bug/create/comment.txt.tmpl
new file mode 100644 (file)
index 0000000..4cd78dd
--- /dev/null
+++ b/template/en/default/bug/create/comment.txt.tmpl
@@ -0,0 +1,12 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[% USE Bugzilla %]
+[% Hook.process("form") %]
+
+
+[% Bugzilla.cgi.param("comment") %]

diff --git a/template/en/default/bug/create/create-guided.html.tmpl b/template/en/default/bug/create/create-guided.html.tmpl
new file mode 100644 (file)
index 0000000..68bb95b
--- /dev/null
+++ b/template/en/default/bug/create/create-guided.html.tmpl
@@ -0,0 +1,509 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # This template has the same interface as create.html.tmpl
+  #%]
+
+[% USE Bugzilla %]
+[% cgi = Bugzilla.cgi %]
+
+[% PROCESS global/header.html.tmpl
+   title = "Enter $terms.ABug"
+   onload = "PutDescription()"
+   style = "#somebugs { width: 100%; height: 500px }"
+ %]
+
+[% style = "" %]
+
+<p>
+  <font color="red">
+    This is a template used on mozilla.org.  This template, and the
+    comment-guided.txt.tmpl template that formats the data submitted via 
+    the form in this template, are included as a demo of what it's
+    possible to do with custom templates in general, and custom [% terms.bug %]
+    entry templates in particular. As much of the text will not apply, 
+    you should alter it 
+    if you want to use this form on your [% terms.Bugzilla %] installation.
+  </font>
+</p>
+
+[% tablecolour = "#FFFFCC" %]
+
+[%# This script displays the descriptions for selected components. %]
+<script type="text/javascript">
+var descriptions = [
+[% FOREACH c = product.components %]
+  '[% c.description FILTER js %]',
+[% END %]
+];
+
+function PutDescription() {
+    if ((document.getElementById) && (document.body.innerHTML)) {
+        var componentIndex = document.getElementById('component').selectedIndex;
+        if (componentIndex != -1) {
+            var description = document.getElementById('description');
+            description.innerHTML = descriptions[componentIndex];
+        }
+    }
+}
+</script>
+
+<h3 id="step1">Step 1 of 3 - has your [% terms.bug %] already been reported?</h3>
+
+<p>
+  <font color="red">Please don't skip this step - half of all 
+  [% terms.bugs %] filed are
+  reported already.</font>
+    Check the two lists of frequently-reported [% terms.bugs %]:
+</p>
+
+[%# Include other products if sensible %]
+[% IF product.name == "Firefox" %]
+  [% productstring = "product=Mozilla%20Application%20Suite&amp;product=Firefox" %]
+[% ELSIF product.name == "Thunderbird" %]
+  [% productstring = "product=Mozilla%20Application%20Suite&amp;product=Thunderbird" %]
+[% ELSE %]
+  [% productstring = BLOCK %]product=[% product.name FILTER uri %][% END %]
+[% END %]
+
+<p>
+    <a href="duplicates.cgi?[% productstring %]&amp;format=simple" target="somebugs">All-time Top 100</a> (loaded initially) |
+    <a href="duplicates.cgi?[% productstring %]&amp;format=simple&amp;sortby=delta&amp;reverse=1&amp;maxrows=100&amp;changedsince=14" target="somebugs">Hot in the last two weeks</a>  
+</p>
+
+<iframe name="somebugs" id="somebugs"
+  style="border: 2px black solid"
+  src="duplicates.cgi?[% productstring %]&amp;format=simple">
+</iframe>
+
+<p>
+    If your [% terms.bug %] isn't there, search [% terms.Bugzilla %] by entering
+    a few key words having to do with your [% terms.bug %] in this box.
+    For example: <tt><b>pop3 mail</b></tt> or <tt><b>copy paste</b></tt>.
+    The results will appear above.
+  </p>
+
+[%# All bugs opened inside the past six months %]
+  <form action="buglist.cgi" method="get" target="somebugs">
+    <input type="hidden" name="format" value="simple">
+    <input type="hidden" name="order" value="relevance desc">
+    <input type="hidden" name="bug_status" value="__all__">
+    <input type="hidden" name="product" value="[% product.name FILTER html %]">
+    [% IF product.name == "Firefox" OR 
+          product.name == "Thunderbird" OR 
+          product.name == "Mozilla Application Suite" OR
+          product.name == "Camino" %]
+      <input type="hidden" name="product" value="Core">
+      <input type="hidden" name="product" value="Toolkit">
+      <input type="hidden" name="product" value="PSM">
+      <input type="hidden" name="product" value="NSPR">
+      <input type="hidden" name="product" value="NSS">
+    [% END %]      
+    <input type="hidden" name="chfieldfrom" value="-6m">
+    <input type="hidden" name="chfieldto" value="Now">
+    <input type="hidden" name="chfield" value="[Bug creation]">
+    <input type="text" name="content" size="40">
+    <input type="submit" id="search" value="Search">
+  </form>
+
+<p>
+  Look through the search results. If you get the
+  <tt><b>[% terms.zeroSearchResults %]</b></tt> message, [% terms.Bugzilla %]
+  found no [% terms.bugs %] that
+  match. Check for typing mistakes, or try fewer or different keywords.
+  If you find [% terms.abug %] that looks the same as yours, please add
+  any useful extra information you have to it, rather than opening a new one.
+</p>
+
+
+<h3 id="step2">Step 2 of 3 - give information</h3>
+
+<p>
+  If you've tried a few searches and your [% terms.bug %] really isn't in 
+  there, tell us all about it.
+</p>
+
+<form method="post" action="post_bug.cgi">
+  <input type="hidden" name="format" value="guided">
+  <input type="hidden" name="assigned_to" value="">
+  <input type="hidden" name="priority"
+         value="[% default.priority FILTER html %]">
+  <input type="hidden" name="version"
+         value="[% default.version FILTER html %]">
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+
+<table valign="top" cellpadding="5" cellspacing="5" border="0">
+
+  <tr bgcolor="[% tablecolour %]">
+    <td align="right" valign="top">
+      <b>Product</b>
+    </td>
+    <td valign="top">
+      <input type="hidden" name="product" value="[% product.name FILTER html %]">
+      [% product.name FILTER html %]
+    </td>
+  </tr>
+
+  <tr>
+    <td align="right" valign="top">
+      <b>Component</b>
+    </td>
+    <td valign="top">
+      <table border="0" cellpadding="0" cellspacing="0">
+        <tr>
+          <td valign="top">
+            <select name="component" id="component"
+                    size="5" onchange="PutDescription()">
+              [% IF NOT default.component_ %]
+                [%# Various b.m.o. products have a "General" component,
+                    which is a useful default. %]
+                [% default.component_ = "General" %]
+              [% END %]
+              [% FOREACH c = product.components %]
+                <option value="[% c.name FILTER html %]"
+                  [% " selected=\"selected\"" IF c.name == default.component_ %]>
+                  [% c.name FILTER html %]
+                </option>
+              [% END %]
+            </select>
+          </td>
+          <td valign="top" width="100%">
+              <div id="description" style="color: green; margin-left: 10px;
+                                           height: 5em; overflow: auto;">
+                <script type="text/javascript">
+                  if ((document.getElementById) && (document.body.innerHTML)) {
+                    document.write("\
+                    Select a component to see its description here.");
+                  }
+                </script>
+              </div>
+          </td>
+        </tr>
+      </table>
+      
+      <p>
+        The area where the problem occurs.
+        To pick the right component, you could use the same one as
+        similar [% terms.bugs %] you found in your search, or read the full list of
+        <a target="_blank" href="describecomponents.cgi?product=
+            [% product.name FILTER uri %]">component
+        descriptions</a> (opens in new window) if you need more help.
+      </p>
+    </td>
+  </tr>
+
+  [%# We override rep_platform and op_sys for simplicity. The values chosen
+      are based on which are most common in the b.m.o database %]
+  [% rep_platform = [ "PC", "Macintosh", "All", "Other" ] %]
+
+  <tr bgcolor="[% tablecolour %]">
+    <td align="right" valign="top">
+      <b>[% field_descs.rep_platform FILTER html %]</b>
+    </td>
+    <td valign="top">
+      [% PROCESS select sel = 'rep_platform' %]
+    </td>
+  </tr>
+
+  [% op_sys = [ "Windows 2000", "Windows XP", "Windows Vista", "Windows 7",
+                "Mac OS X", "Linux", "All", "Other" ] %]
+
+  <tr>
+    <td align="right" valign="top">
+      <b>Operating System</b>
+    </td>
+    <td valign="top">
+      [% PROCESS select sel = 'op_sys' %]
+    </td>
+  </tr>
+
+  [% IF product.name.match("Firefox|Camino|Mozilla Application Suite") %]
+    [% matches = cgi.user_agent('Gecko/(\d+)') %]
+    [% buildid = cgi.user_agent() IF matches %]
+  [% END %]
+  
+  [%# Accept URL parameter build ID for non-browser products %]
+  [% IF cgi.param("buildid") %]
+    [% buildid = cgi.param("buildid") %]
+  [% END %]
+
+  <tr bgcolor="[% tablecolour %]">
+    <td align="right" valign="top">
+      <b>Build Identifier</b>
+    </td>
+    <td valign="top">
+      <input type="text" size="80" name="buildid" value="[% buildid FILTER html %]">
+      <p>
+        This should identify the exact version of the product you were using.  
+        If the above field is blank or you know it is incorrect, copy the 
+        version text from the product's Help | 
+        About menu (for browsers this will begin with "Mozilla/5.0...").  
+        If the product won't start, instead paste the complete URL you downloaded 
+        it from.
+      </p>
+    </td>
+  </tr>
+
+  <tr>
+    <td align="right" valign="top">
+      <b>URL</b>
+    </td>
+    <td valign="top">
+      <input type="text" size="80" name="bug_file_loc" value="http://">
+      <p>
+        URL that demonstrates the problem you are seeing (optional).<br>
+        <b>IMPORTANT</b>: if the problem is with a broken web page, you need
+        to report it
+        <a href="https://bugzilla.mozilla.org/page.cgi?id=broken-website.html">a different way</a>.
+      </p>
+   </td>
+  </tr>
+
+  <tr bgcolor="[% tablecolour %]">
+    <td align="right" valign="top">
+      <b>Summary</b>
+    </td>
+    <td valign="top">
+      <input type="text" size="80" name="short_desc" id="short_desc" 
+             maxlength="255" spellcheck="true">
+      <p>
+        A sentence which summarises the problem.
+        Please be descriptive and use lots of keywords.
+      </p>
+      <p>
+        <tt>
+          <font color="#990000">Bad example</font>: mail crashed
+        </tt>
+        <br>
+        <tt>
+          <font color="#009900">Good example</font>:
+          crash if I close the mail window while checking for new POP mail
+        </tt>
+      </p>
+    </td>
+  </tr>
+
+  <tr>
+    <td align="right" valign="top">
+      <b>Details</b>
+    </td>
+    <td valign="top">
+      [% INCLUDE global/textarea.html.tmpl
+        name    = 'comment'
+        minrows = 6
+        cols    = constants.COMMENT_COLS
+      %]
+      <p>
+        Expand on the Summary. Please be
+        as specific as possible about what is wrong.
+      </p>
+      <p>
+        <tt>
+          <font color="#990000">Bad example</font>: Mozilla crashed.
+          You suck!
+        </tt>
+        <br>
+        <tt>
+          <font color="#009900">Good example</font>: After a crash which
+          happened when I was sorting in the Bookmark Manager,<br> all of my
+          top-level bookmark folders beginning with the letters Q to Z are 
+          no longer present.
+        </tt>
+      </p>
+    </td>
+  </tr>
+
+  <tr bgcolor="[% tablecolour %]">
+    <td align="right" valign="top">
+      <b>Reproducibility</b>
+    </td>
+    <td valign="top">
+      <select name="reproducible">
+        <option name="AlwaysReproducible" value="Always">
+          Happens every time.
+        </option>
+        <option name="Sometimes" value="Sometimes">
+          Happens sometimes, but not always.
+        </option>
+        <option name="DidntTry" value="Didn't try">
+          Haven't tried to reproduce it.
+        </option>
+        <option name="NotReproducible" value="Couldn't Reproduce">
+          Tried, but couldn't reproduce it.
+        </option>
+      </select>
+    </td>
+  </tr>
+
+  <tr>
+    <td align="right" valign="top">
+      <b>Steps to Reproduce</b>
+    </td>
+    <td valign="top">
+      [% INCLUDE global/textarea.html.tmpl
+        name           = 'reproduce_steps'
+        minrows        = 4
+        cols           = constants.COMMENT_COLS
+        defaultcontent = "1.\n2.\n3."
+      %]
+      <p>
+        Describe how to reproduce the problem, step by
+        step. Include any special setup steps.
+      </p>
+    </td>
+  </tr>
+
+  <tr bgcolor="[% tablecolour %]">
+    <td valign="top" align="right">
+      <b>Actual Results</b>
+    </td>
+    <td valign="top">
+      [% INCLUDE global/textarea.html.tmpl
+        name    = 'actual_results'
+        minrows = 4
+        cols    = constants.COMMENT_COLS
+      %]
+      <p>
+        What happened after you performed the steps above?
+      </p>
+    </td>
+  </tr>
+
+  <tr>
+    <td valign="top" align="right">
+      <b>Expected Results</b>
+    </td>
+    <td valign="top">
+      [% INCLUDE global/textarea.html.tmpl
+        name    = 'expected_results'
+        minrows = 4
+        cols    = constants.COMMENT_COLS
+      %]
+      <p>
+        What should the software have done instead?
+      </p>
+    </td>
+  </tr>
+
+  <tr bgcolor="[% tablecolour %]">
+    <td valign="top" align="right">
+      <b>Additional Information</b>
+    </td>
+    <td valign="top">
+      [% INCLUDE global/textarea.html.tmpl
+        name    = 'additional_info'
+        minrows = 8
+        cols    = constants.COMMENT_COLS
+      %]
+      <p>
+        Add any additional information you feel may be
+        relevant to this [% terms.bug %], such as the <b>theme</b> you were
+        using (does the [% terms.bug %] still occur
+        with the default theme?), a 
+        <b><a href="http://kb.mozillazine.org/Quality_Feedback_Agent">Talkback crash ID</a></b>, or special
+        information about <b>your computer's configuration</b>. Any information
+        longer than a few lines, such as a <b>stack trace</b> or <b>HTML
+        testcase</b>, should be added
+        using the "Add an Attachment" link on the [% terms.bug %], after
+        it is filed. If you believe that it's relevant, please also include
+        your build configuration, obtained by typing <tt>about:buildconfig</tt>
+        into your URL bar.
+        <br>
+        <br>
+        If you are reporting a crash, note the module in
+        which the software crashed (e.g., <tt>Application Violation in
+        gkhtml.dll</tt>).
+      </p>
+    </td>
+  </tr>
+
+  <tr>
+    <td valign="top" align="right">
+      <b>[% field_descs.bug_severity FILTER html %]</b>
+    </td>
+    <td valign="top">
+      <select name="bug_severity">
+        <option name="critical" value="critical">
+          Critical: The software crashes, hangs, or causes you to
+          lose data.
+        </option>
+        <option name="major" value="major">
+          Major: A major feature is broken.
+        </option>
+        <option name="normal" value="normal" selected="selected">
+          Normal: It's [% terms.abug %] that should be fixed.
+        </option>
+        <option name="minor" value="minor">
+          Minor: Minor loss of function, and there's an easy workaround.
+        </option>
+        <option name="trivial" value="trivial">
+          Trivial: A cosmetic problem, such as a misspelled word or
+          misaligned text.
+        </option>
+        <option name="enhancement" value="enhancement">
+          Enhancement: Request for new feature or enhancement.
+        </option>
+      </select>
+      <p>
+        Say how serious the problem is, or if your [% terms.bug %] is a 
+        request for a new feature.
+      </p>
+    </td>
+  </tr>
+
+  [% Hook.process('form') %]
+</table>
+
+
+<h3 id="step3">Step 3 of 3 - submit the [% terms.bug %] report</h3>
+
+<p>
+  <input type="submit" id="report" value="    Submit [% terms.Bug %] Report    "
+   onclick="if (this.form.comment.value == '')
+   { alert('Please enter some details about this [% terms.bug %].');
+     this.form.comment.focus();
+     return false; } return true;">
+</p>
+
+<p>
+  That's it! Thanks very much. You'll be notified by email about any
+  progress that is made on fixing your [% terms.bug %]. 
+
+<p>  
+  Please be warned
+  that we get a lot of [% terms.bug %] reports filed - it may take quite a 
+  while to get around to yours. You can help the process by making sure your 
+  [%+ terms.bug %] is
+  complete and easy to understand, and by quickly replying to any questions
+  which may arrive by email.
+</p>
+
+    </form>
+
+[% PROCESS global/footer.html.tmpl %]
+
+[%############################################################################%]
+[%# Block for SELECT fields                                                  #%]
+[%############################################################################%]
+
+[% BLOCK select %]
+  <select name="[% sel %]">
+    [%- IF default.$sel %]
+      <option value="[% default.$sel FILTER html %]" selected="selected">
+        [% default.$sel FILTER html -%]
+      </option>
+    [% END %]
+    [%- FOREACH x = $sel %]
+      [% NEXT IF x == default.$sel %]
+      <option value="[% x FILTER html %]">
+        [% x FILTER html -%]
+      </option>
+    [%- END %]
+  </select>
+[% END %]

diff --git a/template/en/default/bug/create/create.html.tmpl b/template/en/default/bug/create/create.html.tmpl
new file mode 100644 (file)
index 0000000..f2a49ab
--- /dev/null
+++ b/template/en/default/bug/create/create.html.tmpl
@@ -0,0 +1,723 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% title = BLOCK %]Enter [% terms.Bug %]: [% product.name FILTER html %][% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+  yui = [ 'autocomplete', 'calendar', 'datatable', 'button' ]
+  style_urls = [ 'skins/standard/attachment.css',
+                 'skins/standard/enter_bug.css' ]
+  javascript_urls = [ "js/attachment.js", "js/util.js",
+                      "js/field.js", "js/TUI.js", "js/bug.js" ]
+  onload = "set_assign_to(); hideElementById('attachment_true');
+            showElementById('attachment_false'); showElementById('btn_no_attachment');"
+%]
+
+<script type="text/javascript">
+<!--
+
+var initialowners = new Array([% product.components.size %]);
+var last_initialowner;
+var initialccs = new Array([% product.components.size %]);
+var components = new Array([% product.components.size %]);
+var comp_desc = new Array([% product.components.size %]);
+var flags = new Array([% product.components.size %]);
+[% IF Param("useqacontact") %]
+    var initialqacontacts = new Array([% product.components.size %]);
+    var last_initialqacontact;
+[% END %]
+[% count = 0 %]
+[%- FOREACH c = product.components %]
+    [% NEXT IF NOT c.is_active %]
+    components[[% count %]] = "[% c.name FILTER js %]";
+    comp_desc[[% count %]] = "[% c.description FILTER html_light FILTER js %]";
+    initialowners[[% count %]] = "[% c.default_assignee.login FILTER js %]";
+    [% flag_list = [] %]
+    [% FOREACH f = c.flag_types.bug %]
+      [% NEXT UNLESS f.is_active %]
+      [% flag_list.push(f.id) %]
+    [% END %]
+    [% FOREACH f = c.flag_types.attachment %]
+      [% NEXT UNLESS f.is_active %]
+      [% flag_list.push(f.id) %]
+    [% END %]
+    flags[[% count %]] = [[% flag_list.join(",") FILTER js %]];
+    [% IF Param("useqacontact") %]
+        initialqacontacts[[% count %]] = "[% c.default_qa_contact.login FILTER js %]";
+    [% END %]
+
+    [% SET initial_cc_list = [] %]
+    [% FOREACH cc_user = c.initial_cc %]
+      [% initial_cc_list.push(cc_user.login) %]
+    [% END %]
+    initialccs[[% count %]] = "[% initial_cc_list.join(', ') FILTER js %]";
+
+    [% count = count + 1 %]
+[%- END %]
+
+function set_assign_to() {
+    // Based on the selected component, fill the "Assign To:" field
+    // with the default component owner, and the "QA Contact:" field
+    // with the default QA Contact. It also selectively enables flags.
+    var form = document.Create;
+    var assigned_to = form.assigned_to.value;
+
+[% IF Param("useqacontact") %]
+    var qa_contact = form.qa_contact.value;
+[% END %]
+
+    var index = -1;
+    if (form.component.type == 'select-one') {
+        index = form.component.selectedIndex;
+    } else if (form.component.type == 'hidden') {
+        // Assume there is only one component in the list
+        index = 0;
+    }
+    if (index != -1) {
+        var owner = initialowners[index];
+        var component = components[index];
+        if (assigned_to == last_initialowner
+            || assigned_to == owner
+            || assigned_to == '') {
+            form.assigned_to.value = owner;
+            last_initialowner = owner;
+        }
+
+        document.getElementById('initial_cc').innerHTML = initialccs[index];
+        document.getElementById('comp_desc').innerHTML = comp_desc[index];
+
+        [% IF Param("useqacontact") %]
+            var contact = initialqacontacts[index];
+            if (qa_contact == last_initialqacontact
+                || qa_contact == contact
+                || qa_contact == '') {
+                  form.qa_contact.value = contact;
+                  last_initialqacontact = contact;
+            }
+        [% END %]
+
+        // We show or hide the available flags depending on the selected component.
+        var flag_rows = YAHOO.util.Dom.getElementsByClassName('bz_flag_type', 'tbody');
+        for (var i = 0; i < flag_rows.length; i++) {
+            // Each flag table row should have one flag form select element
+            // We get the flag type id from the id attribute of the select.
+            var flag_select = YAHOO.util.Dom.getElementsByClassName('flag_select', 
+                                                                    'select', 
+                                                                    flag_rows[i])[0];
+            var type_id = flag_select.id.split('-')[1];
+            var can_set = flag_select.options.length > 1 ? 1 : 0;
+            var show = 0;
+            // Loop through the allowed flag ids for the selected component
+            // and if we match, then show the row, otherwise hide the row.
+            for (var j = 0; j < flags[index].length; j++) {
+                if (flags[index][j] == type_id) {
+                    show = 1;
+                    break;
+                }
+            }
+            if (show && can_set) {
+                flag_select.disabled = false;
+                YAHOO.util.Dom.removeClass(flag_rows[i], 'bz_default_hidden');
+            } else {
+                flag_select.disabled = true;
+                YAHOO.util.Dom.addClass(flag_rows[i], 'bz_default_hidden');
+            }
+        }
+    }
+}
+
+var status_comment_required = new Array();
+[% FOREACH status = bug_status %]
+  status_comment_required['[% status.name FILTER js %]'] = 
+    [% status.comment_required_on_change_from() ? 'true' : 'false' %]
+[% END %]
+
+TUI_alternates['expert_fields'] = 'Show Advanced Fields';
+// Hide the Advanced Fields by default, unless the user has a cookie
+// that specifies otherwise.
+TUI_hide_default('expert_fields');
+// Also hide the "Paste text as attachment" textarea by default.
+TUI_hide_default('attachment_text_field');
+-->
+</script>
+
+<form name="Create" id="Create" method="post" action="post_bug.cgi"
+      class="enter_bug_form" enctype="multipart/form-data"
+      onsubmit="return validateEnterBug(this)">
+<input type="hidden" name="product" value="[% product.name FILTER html %]">
+<input type="hidden" name="token" value="[% token FILTER html %]">
+
+<table>
+<tbody>
+  <tr>
+    <td colspan="4">
+    [%# Migration note: The following file corresponds to the old Param
+      # 'entryheaderhtml'
+      #%]
+    [% PROCESS 'bug/create/user-message.html.tmpl' %]
+    </td>
+  </tr>
+
+  <tr>
+    <td colspan="2">
+      <a id="expert_fields_controller" class="controller bz_default_hidden"
+         href="javascript:TUI_toggle_class('expert_fields')">Hide
+        Advanced Fields</a>
+      [%# Show the link if the browser supports JS %]
+      <script type="text/javascript">
+        YAHOO.util.Dom.removeClass('expert_fields_controller', 
+                                   'bz_default_hidden');
+      </script>
+    </td>
+    <td colspan="2">
+      (<span class="required_star">*</span> =
+      <span class="required_explanation">Required Field</span>)
+   </td>
+  </tr>
+
+  <tr>
+    [% INCLUDE bug/field.html.tmpl
+      bug = default, field = bug_fields.product, editable = 0,
+      value = product.name %]
+    [% INCLUDE bug/field.html.tmpl
+      bug = default, field = bug_fields.reporter, editable = 0,
+      value = user.login %]
+  </tr>
+
+  [%# We can't use the select block in these two cases for various reasons. %]
+  <tr>
+    [% component_desc_url = BLOCK -%]
+      describecomponents.cgi?product=[% product.name FILTER uri %]
+    [% END %]
+    [% INCLUDE "bug/field-label.html.tmpl"
+      field = bug_fields.component editable = 1
+      desc_url = component_desc_url
+    %]      
+    <td id="field_container_component">
+      <select name="component" id="component" onchange="set_assign_to();"
+              size="7" aria-required="true" class="required">
+        [%# Build the lists of assignees and QA contacts if "usemenuforusers" is enabled. %]
+        [% IF Param("usemenuforusers") %]
+          [% assignees_list = user.get_userlist.clone %]
+          [% qa_contacts_list = user.get_userlist.clone %]
+        [% END %]
+
+        [%- FOREACH c = product.components %]
+          [% NEXT IF NOT c.is_active %]
+          <option value="[% c.name FILTER html %]"
+                  id="v[% c.id FILTER html %]_component"
+            [% IF c.name == default.component_ %]
+              [%# This is for bug/field.html.tmpl, for visibility-related
+                # controls. %]
+              [% default.component_id = c.id %]
+              selected="selected"
+            [% END %]>
+            [% c.name FILTER html -%]
+          </option>
+          [% IF Param("usemenuforusers") %]
+            [% INCLUDE build_userlist default_user = c.default_assignee,
+                                      userlist = assignees_list %]
+            [% INCLUDE build_userlist default_user = c.default_qa_contact,
+                                      userlist = qa_contacts_list %]
+          [% END %]
+        [%- END %]
+      </select>
+
+      <script type="text/javascript">
+       <!--
+         [%+ INCLUDE "bug/field-events.js.tmpl" 
+                     field = bug_fields.component, product = product %]
+       //-->
+       </script>
+    </td>
+
+    <td colspan="2" id="comp_desc_container">
+      [%# Enclose the fieldset in a nested table so that its width changes based
+        # on the length on the component description. %]
+      <table>
+        <tr>
+          <td>
+            <fieldset>
+              <legend>Component Description</legend>
+              <div id="comp_desc" class="comment">Select a component to read its description.</div>
+            </fieldset>
+          </td>
+        </tr>
+      </table>
+    </td>
+  </tr>
+
+  <tr>
+    [% INCLUDE "bug/field-label.html.tmpl"
+      field = bug_fields.version editable = 1 rowspan = 3 
+    %]
+    <td rowspan="3">
+      <select name="version" id="version" size="5">
+        [%- FOREACH v = version %]
+          [% NEXT IF NOT v.is_active %]
+          <option value="[% v.name FILTER html %]"
+            [% ' selected="selected"' IF v.name == default.version %]>[% v.name FILTER html -%]
+          </option>
+        [%- END %]
+      </select>
+    </td>
+
+    [% INCLUDE bug/field.html.tmpl
+      bug = default, field = bug_fields.bug_severity, editable = 1, 
+      value = default.bug_severity %]
+  </tr>
+
+  <tr>
+    [% INCLUDE bug/field.html.tmpl
+      bug = default, field = bug_fields.rep_platform, editable = 1,
+      value = default.rep_platform %]
+  </tr>
+
+  <tr>
+    [% INCLUDE bug/field.html.tmpl 
+       bug = default, field = bug_fields.op_sys, editable = 1, 
+       value = default.op_sys %]
+  </tr>
+  [% IF (!Param('defaultplatform') || !Param('defaultopsys')) && !cloned_bug_id %]
+    <tr>
+      <th colspan="3">&nbsp;</th>
+      <td id="os_guess_note" class="comment">
+        <div>We've made a guess at your
+        [% IF Param('defaultplatform') %]
+          operating system. Please check it
+        [% ELSIF Param('defaultopsys') %]
+          platform. Please check it
+        [% ELSE %]
+          operating system and platform. Please check them
+        [% END %]
+        and make any corrections if necessary.</div>
+      </td>
+    </tr>
+  [% END %]
+</tbody>
+
+<tbody class="expert_fields">
+  <tr>
+    [% IF Param('usetargetmilestone') && Param('letsubmitterchoosemilestone') %]
+      [% INCLUDE select field = bug_fields.target_milestone %]
+    [% ELSE %]
+      <td colspan="2">&nbsp;</td>
+    [% END %]
+
+    [% IF Param('letsubmitterchoosepriority') %]
+      [% INCLUDE bug/field.html.tmpl
+        bug = default, field = bug_fields.priority, editable = 1, 
+        value = default.priority %]
+    [% ELSE %]
+      <td colspan="2">&nbsp;</td>
+    [% END %]
+  </tr>
+</tbody>
+
+<tbody class="expert_fields">
+  <tr>
+    <td colspan="4">&nbsp;</td>
+  </tr>
+
+  <tr>
+    [% INCLUDE bug/field.html.tmpl
+      bug = default, field = bug_fields.bug_status,
+      editable = (bug_status.size > 1), value = default.bug_status
+      override_legal_values = bug_status %]
+
+    <td>&nbsp;</td>
+    [%# Calculate the number of rows we can use for flags %]
+    [% num_rows = 7 + (Param("useqacontact") ? 1 : 0) +
+                      (user.is_timetracker ? 3 : 0)
+    %]
+
+    <td rowspan="[% num_rows FILTER html %]">
+      [% IF product.flag_types.bug.size > 0 %]
+        [% display_flag_headers = 0 %]
+        [% any_flags_requesteeble = 0 %]
+
+        [% FOREACH flag_type = product.flag_types.bug %]
+          [% NEXT UNLESS flag_type.is_active %]
+          [% display_flag_headers = 1 %]
+          [% SET any_flags_requesteeble = 1 IF flag_type.is_requestable && flag_type.is_requesteeble %]
+        [% END %]
+
+        [% IF display_flag_headers %]
+          [% PROCESS "flag/list.html.tmpl" flag_types = product.flag_types.bug
+                                           any_flags_requesteeble = any_flags_requesteeble
+                                           flag_table_id = "bug_flags"
+          %]
+        [% END %]
+      [% END %]
+    </td>
+  </tr>
+
+  <tr>
+    [% INCLUDE "bug/field-label.html.tmpl"
+      field = bug_fields.assigned_to editable = 1
+    %]
+    <td colspan="2">
+      [% INCLUDE global/userselect.html.tmpl
+         id => "assigned_to"
+         name => "assigned_to"
+         value => assigned_to
+         disabled => assigned_to_disabled
+         size => 30
+         emptyok => 1
+         custom_userlist => assignees_list
+       %]
+      <noscript>(Leave blank to assign to component's default assignee)</noscript>
+    </td>
+  </tr>
+  
+[% IF Param("useqacontact") %]
+    <tr>
+      [% INCLUDE "bug/field-label.html.tmpl"
+        field = bug_fields.qa_contact editable = 1
+      %]
+      <td colspan="2">
+      [% INCLUDE global/userselect.html.tmpl
+         id => "qa_contact"
+         name => "qa_contact"
+         value => qa_contact
+         disabled => qa_contact_disabled
+         size => 30
+         emptyok => 1
+         custom_userlist => qa_contacts_list
+       %]
+        <noscript>(Leave blank to assign to default qa contact)</noscript>
+      </td>
+    </tr>
+[% END %]
+
+  <tr>
+    [% INCLUDE "bug/field-label.html.tmpl"
+      field = bug_fields.cc editable = 1 
+    %]
+    <td colspan="2">
+      [% INCLUDE global/userselect.html.tmpl
+         id => "cc"
+         name => "cc"
+         value => cc
+         disabled => cc_disabled
+         size => 30
+         multiple => 5
+       %]
+    </td>
+  </tr>
+
+  <tr>
+    <th>Default [% field_descs.cc FILTER html %]:</th>
+    <td colspan="2">
+      <div id="initial_cc">
+      </div>
+   </td>
+  </tr>
+  
+  <tr>
+    <td colspan="3">&nbsp;</td>
+  </tr>
+
+[% IF user.is_timetracker %]
+  <tr>
+    [% INCLUDE "bug/field-label.html.tmpl"
+      field = bug_fields.estimated_time editable = 1
+    %]
+    <td colspan="2">
+      <input name="estimated_time" size="6" maxlength="6" value="[% estimated_time FILTER html %]">
+    </td>
+  </tr>
+  <tr>
+    [% INCLUDE bug/field.html.tmpl
+      bug = default, field = bug_fields.deadline, value = deadline,
+      editable = 1, value_span = 2 %] 
+  </tr>
+
+  <tr>
+    <td colspan="3">&nbsp;</td>
+  </tr>
+[% END %]
+
+  <tr>
+    [% INCLUDE "bug/field-label.html.tmpl"
+      field = bug_fields.alias editable = 1
+    %]
+    <td colspan="2">
+      <input name="alias" size="20" value="[% alias FILTER html %]">
+    </td>
+  </tr>
+
+  <tr>
+    [% INCLUDE "bug/field-label.html.tmpl"
+      field = bug_fields.bug_file_loc editable = 1
+    %]
+    <td colspan="2" class="field_value">
+      <input name="bug_file_loc" id="bug_file_loc" class="text_input"
+             size="40" value="[% bug_file_loc FILTER html %]">
+    </td>
+  </tr>
+</tbody>
+
+<tbody>
+  [% USE Bugzilla %]
+
+  [% FOREACH field = Bugzilla.active_custom_fields %]
+    [% NEXT UNLESS field.enter_bug %]
+    [% SET value = ${field.name}.defined ? ${field.name} : "" %]
+    <tr [% 'class="expert_fields"' IF !field.is_mandatory %]>
+      [% INCLUDE bug/field.html.tmpl 
+        bug = default, field = field, value = value, editable = 1, 
+        value_span = 3 %]
+    </tr>
+  [% END %]
+</tbody>
+
+<tbody>
+
+  <tr>
+    [% INCLUDE "bug/field-label.html.tmpl"
+      field = bug_fields.short_desc editable = 1
+    %]
+    <td colspan="3" class="field_value">
+      <input name="short_desc" size="70" value="[% short_desc FILTER html %]"
+             maxlength="255" spellcheck="true" aria-required="true"
+             class="required text_input" id="short_desc">
+    </td>
+  </tr>
+
+  [% IF feature_enabled('jsonrpc') AND !cloned_bug_id %]
+    <tr id="possible_duplicates_container" class="bz_default_hidden">
+      <th>Possible<br>Duplicates:</th>
+      <td colspan="3">
+        <div id="possible_duplicates"></div>
+        <script type="text/javascript">
+          var dt_columns = [ 
+              { key: "id", label: "[% field_descs.bug_id FILTER js %]",
+                formatter: YAHOO.bugzilla.dupTable.formatBugLink },
+              { key: "summary", 
+                label: "[% field_descs.short_desc FILTER js %]",
+                formatter: "text" },
+              { key: "status",
+                label: "[% field_descs.bug_status FILTER js %]",
+                formatter: YAHOO.bugzilla.dupTable.formatStatus },
+              { key: "update_token", label: '',
+                formatter: YAHOO.bugzilla.dupTable.formatCcButton }
+          ];
+          YAHOO.bugzilla.dupTable.addCcMessage = "Add Me to the CC List";
+          YAHOO.bugzilla.dupTable.init({
+            container: 'possible_duplicates',
+            columns: dt_columns,
+            product_name: '[% product.name FILTER js %]',
+            summary_field: 'short_desc',
+            options: {
+              MSG_LOADING: 'Searching for possible duplicates...',
+              MSG_EMPTY:   'No possible duplicates found.',
+              SUMMARY:     'Possible Duplicates'
+            }
+          });
+        </script>
+      </td>
+    </tr>
+  [% END %]
+
+  <tr>
+    <th>Description:</th>
+    <td colspan="3">
+
+      [% defaultcontent = BLOCK %]
+        [% IF cloned_bug_id %]
++++ This [% terms.bug %] was initially created as a clone of [% terms.Bug %] #[% cloned_bug_id %] +++
+
+
+        [% END %]
+        [%-# We are within a BLOCK. The comment will be correctly HTML-escaped
+          # by global/textarea.html.tmpl. So we must not escape the comment here. %]
+        [% comment FILTER none %]
+      [%- END %]
+      [% INCLUDE global/textarea.html.tmpl
+         name           = 'comment'
+         id             = 'comment'
+         minrows        = 10
+         maxrows        = 25
+         cols           = constants.COMMENT_COLS
+         defaultcontent = defaultcontent
+       %]
+      <br>
+    </td>
+  </tr>
+
+  [% IF user.is_insider %]
+    <tr class="expert_fields">
+      <th>&nbsp;</th>
+      <td colspan="3">
+        &nbsp;&nbsp;
+        <input type="checkbox" id="comment_is_private" name="comment_is_private"
+          [% ' checked="checked"' IF comment_is_private %]
+               onClick="updateCommentTagControl(this, 'comment')">
+        <label for="comment_is_private">
+          Make description and any new attachment private (visible only to members 
+          of the <strong>[% Param('insidergroup') FILTER html %]</strong> group)
+        </label>
+      </td>
+    </tr>
+  [% END %]
+
+  [% IF Param("maxattachmentsize") || Param("maxlocalattachment") %]
+  <tr>
+    <th>Attachment:</th>
+    <td colspan="3">
+      <div id="attachment_false" class="bz_default_hidden">
+        <input type="button" value="Add an attachment" onClick="handleWantsAttachment(true)">
+      </div>
+
+      <div id="attachment_true">
+        <input type="button" id="btn_no_attachment" value="Don't add an attachment"
+               class="bz_default_hidden"  onClick="handleWantsAttachment(false)">
+        <fieldset>
+          <legend>Add an attachment</legend>
+          <table class="attachment_entry">
+            [% PROCESS attachment/createformcontents.html.tmpl
+                       flag_types = product.flag_types.attachment
+                       any_flags_requesteeble = 1
+                       flag_table_id ="attachment_flags" %]
+          </table>
+        </fieldset>
+      </div>
+    </td>
+  </tr>
+  [% END %]
+</tbody>
+
+<tbody class="expert_fields">
+  [% IF user.in_group('editbugs', product.id) %]
+    [% IF use_keywords %]
+      <tr>
+        [% INCLUDE bug/field.html.tmpl
+           bug = default, field = bug_fields.keywords, editable = 1,
+           value = keywords, possible_values = all_keywords,
+           desc_url = "describekeywords.cgi", value_span = 2
+        %]
+      </tr>
+    [% END %]
+
+    <tr>
+      [% INCLUDE "bug/field-label.html.tmpl"
+        field = bug_fields.dependson editable = 1
+      %]
+      <td colspan="3">
+        <input name="dependson" accesskey="d" value="[% dependson FILTER html %]">
+      </td>
+    </tr>
+    <tr>
+      [% INCLUDE "bug/field-label.html.tmpl"
+        field = bug_fields.blocked editable = 1
+      %]
+      <td colspan="3">
+        <input name="blocked" accesskey="b" value="[% blocked FILTER html %]">
+      </td>
+    </tr>
+  [% END %]
+</tbody>
+
+<tbody class="expert_fields">
+  [% IF product.groups_available.size %]
+  <tr>
+    <th>&nbsp;</th>
+    <td colspan="3">
+      <br>
+        <strong>
+          Only users in all of the selected groups can view this 
+          [%+ terms.bug %]:
+        </strong>
+      <br>
+      <font size="-1">
+        (Leave all boxes unchecked to make this a public [% terms.bug %].)
+      </font>
+      <br>
+      <br>
+
+      <!-- Checkboxes -->
+      <input type="hidden" name="defined_groups" value="1">
+      [% FOREACH group = product.groups_available %]
+        <input type="checkbox" id="group_[% group.id FILTER html %]"
+               name="groups" value="[% group.name FILTER html %]"
+               [% ' checked="checked"' IF default.groups.contains(group.name)
+                                          OR group.is_default %]>
+        <label for="group_[% group.id FILTER html %]">
+          [%- group.description FILTER html_light %]</label><br>
+      [% END %]
+    </td>
+  </tr>
+  [% END %]
+</tbody>
+
+<tbody>
+  [%# Form controls for entering additional data about the bug being created. %]
+  [% Hook.process("form") %]
+
+  <tr>
+    <th>&nbsp;</th>
+    <td colspan="3">
+      <input type="submit" id="commit" value="Submit [% terms.Bug %]">
+      &nbsp;&nbsp;&nbsp;&nbsp;
+      <input type="submit" name="maketemplate" id="maketemplate"
+             value="Remember values as bookmarkable template"
+             onclick="bz_no_validate_enter_bug=true" class="expert_fields">
+    </td>
+  </tr>
+</tbody>
+  </table>
+  <input type="hidden" name="form_name" value="enter_bug">
+</form>
+
+[%# Links or content with more information about the bug being created. %]
+[% Hook.process("end") %]
+
+[% PROCESS global/footer.html.tmpl %]
+
+[%############################################################################%]
+[%# Block for SELECT fields                                                  #%]
+[%############################################################################%]
+
+[% BLOCK select %]
+
+  [% INCLUDE "bug/field-label.html.tmpl"
+    field = field editable = 1
+  %]
+  <td>
+    <select name="[% field.name FILTER html %]" 
+            id="[% field.name FILTER html %]">
+    [%- FOREACH x = ${field.name} %]
+      [% NEXT IF NOT x.is_active %]
+      <option value="[% x.name FILTER html %]"
+        [% " selected=\"selected\"" IF x.name == default.${field.name} %]>
+        [% display_value(field.name, x.name) FILTER html %]
+      </option>
+    [% END %]
+    </select>
+  </td>
+[% END %]
+
+[% BLOCK build_userlist %]
+  [% user_found = 0 %]
+  [% default_login = default_user.login %]
+  [% RETURN UNLESS default_login %]
+
+  [% FOREACH user = userlist %]
+    [% IF user.login == default_login %]
+      [% user_found = 1 %]
+      [% LAST %]
+    [% END %]
+  [% END %]
+
+  [% userlist.push({login    => default_login,
+                    identity => default_user.identity,
+                    visible  => 1})
+     UNLESS user_found %]
+[% END %]

diff --git a/template/en/default/bug/create/created.html.tmpl b/template/en/default/bug/create/created.html.tmpl
new file mode 100644 (file)
index 0000000..ea227b3
--- /dev/null
+++ b/template/en/default/bug/create/created.html.tmpl
@@ -0,0 +1,47 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # id: number; the ID of the bug that was created.
+  # sentmail: array of hash; bugs for which BugMail should be sent, contains:
+  #     type: string; type of change for this bug, either 'created' if this bug
+  #         was created or 'dep' if it was added as a dependent/blocker
+  #     id: integer; the ID of the bug
+  # bug: object; Bugzilla::Bug object of the bug that was created (used in
+  #     template bug/edit.html.tmpl
+  #%]
+
+[% PROCESS "bug/show-header.html.tmpl" %]
+[% PROCESS global/header.html.tmpl
+  title = "$terms.Bug $id Submitted – $filtered_desc"
+  header = "$terms.Bug $id Submitted"
+%]
+
+[% header_done = 1 %]
+
+[% FOREACH item = sentmail %]
+  [% PROCESS bug/process/results.html.tmpl
+     type = item.type
+     id = item.id
+     sent_bugmail = item
+   %]
+[% END %]
+
+<br>
+
+<hr>
+
+[% PROCESS bug/edit.html.tmpl %]
+
+<hr>
+
+[% PROCESS bug/navigate.html.tmpl bottom_navigator => 1 %]
+
+<br>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/bug/create/make-template.html.tmpl b/template/en/default/bug/create/make-template.html.tmpl
new file mode 100644 (file)
index 0000000..4b1b0c0
--- /dev/null
+++ b/template/en/default/bug/create/make-template.html.tmpl
@@ -0,0 +1,31 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # url: URL to a pre-filled bug entry form.
+  # short_desc: Bug summary as entered in the form.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = "Bookmarks are your friend"
+  header = "Template constructed"
+%]
+
+<p>
+  You can bookmark this link:
+  &ldquo;<a href="enter_bug.cgi?[% url FILTER html %]">
+  [% IF short_desc %]
+    [% short_desc FILTER html %]
+  [% ELSE %]
+    [% terms.Bug %] entry template
+  [% END %]</a>&rdquo;.
+  This bookmark will bring up the <em>Enter [% terms.Bug %]</em> page with the
+  fields initialized as you've requested.
+</p>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/bug/create/user-message.html.tmpl b/template/en/default/bug/create/user-message.html.tmpl
new file mode 100644 (file)
index 0000000..197cf1a
--- /dev/null
+++ b/template/en/default/bug/create/user-message.html.tmpl
@@ -0,0 +1,22 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# Migration note: this file corresponds to the old Param
+  # 'entryheaderhtml'
+  #%]
+
+[%# You can make the output of this template product-specific by using
+  # Template Toolkit IF statements.  The current product name is stored in
+  # the 'product' variable.
+  #%]
+
+Before reporting [% terms.abug %], please read the 
+<a href="page.cgi?id=bug-writing.html">
+[% terms.bug %] writing guidelines</a>, please look at the list of
+<a href="duplicates.cgi">most frequently reported [% terms.bugs %]</a>, and please
+<a href="query.cgi">search</a> for the [% terms.bug %].

diff --git a/template/en/default/bug/dependency-graph.html.tmpl b/template/en/default/bug/dependency-graph.html.tmpl
new file mode 100644 (file)
index 0000000..153cebd
--- /dev/null
+++ b/template/en/default/bug/dependency-graph.html.tmpl
@@ -0,0 +1,89 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # bug_id: integer. The number of the bug(s).
+  # multiple_bugs: boolean. True if bug_id contains > 1 bug number.
+  # showsummary: boolean. True if we are showing bug summaries.
+  # rankdir: string. "TB" if we are ranking top-to-bottom,
+                     "LR" if left-to-right.
+  # image_url: string. The URL of the graphic showing the dependencies.
+  # map_url: string. The URL of the map file for the image.  (Optional)
+  # image_map: string. The image map for the graphic showing the
+                       dependencies. (Optional)
+  #%]
+
+[% title = "Dependency Graph"
+   header = title
+ %]
+
+[% IF NOT multiple_bugs %]
+  [% filtered_desc = short_desc FILTER html %]
+  [% title = "$title for $terms.bug $bug_id"
+     header = "$header for $terms.bug <a href=\"show_bug.cgi?id=$bug_id\">$bug_id</a>"
+     subheader = filtered_desc
+   %]
+[% END %]
+
+[% PROCESS global/header.html.tmpl %]
+
+[% image_map %]
+
+<p>
+  Green circles represent open [% terms.bugs %].
+</p>
+
+[% IF image_map %]
+  <img src="[% image_url %]" alt="Dependency graph" usemap="#imagemap">
+[% ELSE %]
+  <a href="[% map_url %]">
+    <img src="[% image_url %]" alt="Dependency graph" ismap="ismap">
+  </a>
+[% END %]
+
+<hr>
+
+<form action="showdependencygraph.cgi" method="GET">
+  <table>
+    <tr>
+      <th align="left"><label for="id">[% terms.Bug %] numbers</label>:</th>
+      <td><input id="id" name="id" value="[% bug_id %]"></td>
+      <td>
+        <input type="checkbox" id="showsummary" name="showsummary" [% " checked" IF showsummary %]>
+        <label for="showsummary">Show the summaries of all displayed [% terms.bugs %]</label>
+      </td>
+    </tr>
+
+    <tr>
+      <th align="left"><label for="display">Display:</label></th>
+      <td colspan="2">
+        <select id="display" name="display">
+          <option value="tree"[% 'selected="selected"' IF (!display || display == "tree") %]>
+            Restrict to [% terms.bugs %] having a direct relationship with entered [% terms.bugs %]</option>
+          <option value="web" [% 'selected="selected"' IF display == "web" %]>
+            Show all [% terms.bugs %] having any relationship with entered [% terms.bugs %]</option>
+        </select>
+      </td>
+    </tr>
+
+    <tr>
+      <th align="left"><label for="rankdir">Orientation:</label></th>
+      <td colspan="2">
+        <select id="rankdir" name="rankdir">
+          <option value="TB"[% " selected" IF rankdir == "TB" %]>Top to bottom</option>
+          <option value="BT"[% " selected" IF rankdir == "BT" %]>Bottom to top</option>
+          <option value="LR"[% " selected" IF rankdir == "LR" %]>Left to right</option>
+          <option value="RL"[% " selected" IF rankdir == "RL" %]>Right to left</option>
+        </select>
+      </td>
+    </tr>
+  </table>
+  <input type="submit" id="change" value="Change Parameters">
+</form>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/bug/dependency-tree.html.tmpl b/template/en/default/bug/dependency-tree.html.tmpl
new file mode 100644 (file)
index 0000000..a4bb0e6
--- /dev/null
+++ b/template/en/default/bug/dependency-tree.html.tmpl
@@ -0,0 +1,265 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% filtered_desc = blocked_tree.$bugid.short_desc FILTER html %]
+[% PROCESS global/header.html.tmpl
+   title           = "Dependency tree for $terms.Bug $bugid"
+   header          = "Dependency tree for 
+                      <a href=\"show_bug.cgi?id=$bugid\">$terms.Bug $bugid</a>"
+   javascript_urls = ["js/expanding-tree.js"]
+   style_urls      = ["skins/standard/dependency-tree.css"]
+   subheader      = filtered_desc
+   doc_section = "hintsandtips.html#dependencytree"
+%]
+
+[% PROCESS depthControlToolbar %]
+  
+[% INCLUDE tree_section ids=dependson_ids type=1 %]
+ 
+[% INCLUDE tree_section ids=blocked_ids type=2 %] 
+
+[% PROCESS depthControlToolbar %]
+
+[% PROCESS global/footer.html.tmpl %]
+
+[%###########################################################################%]
+[%# Tree-drawing blocks                                                     #%]
+[%###########################################################################%]
+
+[% BLOCK tree_section %]
+  [%# INTERFACE
+    #   - ids: a list of bug IDs to be displayed as children
+    #   - type: the type of tree. 1 = depends on, 2 = blockeds
+    # GLOBALS
+    #   - seen: Maintains a global hash of bugs that have been displayed
+    #%]
+  [% global.seen = {} %]
+  [%# Display the tree of bugs that this bug depends on. %]
+  <h3>
+    <a href="show_bug.cgi?id=[% bugid %]">[% terms.Bug %] [%+ bugid %]</a> 
+    [% IF type == 1 %]
+        [% tree_name = "dependson_tree" %]
+        [% IF ids.size %]
+            depends on 
+        [% ELSE %]
+            does not depend on any [% 'open ' IF hide_resolved %][% terms.bugs %].
+        [% END %]
+    [% ELSIF type == 2 %]
+        [% tree_name = "blocked_tree" %]
+        [% IF ids.size %] 
+            blocks 
+        [% ELSE %]
+            does not block any [% 'open ' IF hide_resolved %][% terms.bugs %].
+        [% END %]
+    [% END %]
+    [% IF ids.size %]
+        [%+ (ids.size == 1) ? "one" : ids.size %]
+        [%+ IF hide_resolved %]open[% END %]
+        [%+ (ids.size == 1) ? terms.bug : terms.bugs %]:
+    [% END %] 
+  </h3>
+  [% IF ids.size %]
+    [%# 27 chars is the length of buglist.cgi?tweak=&bug_id=" %]
+    [% use_post = (ids.join(",").length > constants.CGI_URI_LIMIT - 27 ) ? 1 : 0 %]
+    [% IF use_post %]
+      <form action="buglist.cgi" method="post">
+      <input type="hidden" name="bug_id" value="[% ids.join(",") %]">
+    [% END %]
+
+    [% IF maxdepth -%]Up to [% maxdepth %] level[% "s" IF maxdepth > 1 %] deep | [% END -%]
+    [% IF use_post %]
+      <button>view as [% terms.bug %] list</button>
+      [% IF user.in_group('editbugs') && ids.size > 1 %]
+        | <button type="submit" name="tweak" value="1">change several</button>
+      [% END %]
+      </form>
+    [% ELSE %]
+      <a href="buglist.cgi?bug_id=[% ids.join(",") %]">view as [% terms.bug %] list</a>
+      [% IF user.in_group('editbugs') && ids.size > 1 %]
+        | <a href="buglist.cgi?bug_id=[% ids.join(",") %]&amp;tweak=1">change several</a>
+      [% END %]
+    [% END %]
+
+    <ul class="tree">
+      [% INCLUDE display_tree tree=$tree_name %]
+    </ul>
+  [% END %]
+[% END %]
+
+
+[% BLOCK display_tree %]
+  [%# INTERFACE
+    #   - bugid: the ID of the bug being displayed
+    #   - tree: a hash of bug objects and of bug dependencies
+    #%]
+  [% bug = tree.$bugid %]
+  <li>
+    [%- INCLUDE bullet bugid=bugid tree=tree -%]
+    <span class="summ[% "_deep" IF tree.dependencies.$bugid.size %]" 
+          id="[% bugid FILTER html %]" 
+          [% IF global.seen.$bugid %]
+            onMouseover="duplicatedover('[% bugid FILTER html %]')"
+            onMouseout="duplicatedout('[% bugid FILTER html %]')"
+          [% END %]>
+      [%- INCLUDE buglink bug=bug bugid=bugid %]
+    </span>
+    [% IF global.seen.$bugid %]
+      <b><a title="Already displayed above; click to locate"
+            onclick="duplicated('[% bugid FILTER html %]')"
+            href="#b[% bugid %]">(*)</a></b>
+    [% ELSIF tree.dependencies.$bugid.size %]
+      <ul>
+        [% FOREACH depid = tree.dependencies.$bugid %]
+          [% INCLUDE display_tree bugid=depid %]
+        [% END %]
+      </ul>
+    [% END %]
+  </li>
+  [% global.seen.$bugid = 1 %]
+[% END %]
+
+[% BLOCK bullet %]
+  [% IF tree.dependencies.$bugid.size && ! global.seen.$bugid %]
+    [% extra_class = " b_open" %]
+    [% extra_args = 'onclick="return doToggle(this, event)"' %] 
+  [% END %]
+  <a id="b[% bugid %]" 
+     class="b [%+ extra_class FILTER none %]"
+     title="Click to expand or contract this portion of the tree. Hold down the Ctrl key while clicking to expand or contract all subtrees."
+     [% extra_args FILTER none %]>&nbsp;&nbsp;</a>
+[% END %]
+
+[% BLOCK buglink %]
+  [% isclosed = !bug.isopened %]
+  [% FILTER closed(isclosed) -%]
+    <a title="[% INCLUDE buginfo bug=bug %]"
+       href="show_bug.cgi?id=[% bugid %]">
+      <b>[%- bugid %]:</b>
+      <span class="summ_text">[%+ bug.short_desc FILTER html %]</span>
+      <span class="summ_info">[[% INCLUDE buginfo %]]</span>
+    </a>
+    <a href="showdependencytree.cgi?id=[% bugid FILTER uri %]"
+       class="tree_link">
+      <img src="skins/standard/dependency-tree/tree.png"
+           title="See dependency tree for [% terms.bug %] [%+ bugid FILTER html %]">
+    </a>
+  [% END %]
+[% END %]
+
+[% BLOCK buginfo %]
+  [% display_value("bug_status", bug.bug_status) FILTER html -%] [%+ display_value("resolution", bug.resolution) FILTER html %];
+  [%-%] assigned to [% bug.assigned_to.login FILTER email FILTER html %]
+  [%-%][% "; Target: " _ bug.target_milestone IF bug.target_milestone %]
+[% END %]
+
+[%###########################################################################%]
+[%# Block for depth control toolbar                                         #%]
+[%###########################################################################%]
+
+[% BLOCK depthControlToolbar %]
+ <table cellpadding="3" border="0" cellspacing="0" bgcolor="#e0e0e0">
+   <tr>
+   [%# Hide/show resolved button
+       Swaps text depending on the state of hide_resolved %]
+   <td align="center">
+   <form method="get" action="showdependencytree.cgi"
+           style="display: inline; margin: 0px;">
+     <input name="id" type="hidden" value="[% bugid %]">
+     [% IF maxdepth %]
+       <input name="maxdepth" type="hidden" value="[% maxdepth %]">
+     [% END %]
+     <input type="hidden" name="hide_resolved" value="[% hide_resolved ? 0 : 1 %]">
+     <input type="submit" id="toggle_visibility"
+            value="[% IF hide_resolved %]Show[% ELSE %]Hide[% END %] Resolved">
+   </form>
+   </td>
+
+   <td>
+     Max Depth:
+   </td>
+
+   <td>
+     &nbsp;
+   </td>
+
+   <td>
+   <form method="get" action="showdependencytree.cgi"
+         style="display: inline; margin: 0px;">
+     [%# set to one form %]
+     <input type="submit" id="change_maxdepth"
+       value="&nbsp;1&nbsp;" 
+       [% "disabled" IF realdepth < 2 || maxdepth == 1 %]>
+     <input name="id" type="hidden" value="[% bugid %]">
+     <input name="maxdepth" type="hidden" value="1">
+     <input name="hide_resolved" type="hidden" value="[% hide_resolved %]">
+   </form>
+   </td>
+
+   <td>
+   <form method="get" action="showdependencytree.cgi"
+         style="display: inline; margin: 0px;">
+     [%# Minus one form
+         Allow subtracting only when realdepth and maxdepth > 1 %]
+     <input name="id" type="hidden" value="[% bugid %]">
+     <input name="maxdepth" type="hidden" value="[%
+         maxdepth == 1 ? 1
+                       : ( maxdepth ? maxdepth - 1 : realdepth - 1 )
+     %]">
+     <input name="hide_resolved" type="hidden" value="[% hide_resolved %]">
+     <input type="submit" id="decrease_depth" value="&nbsp;&lt;&nbsp;"
+       [% "disabled" IF realdepth < 2 || ( maxdepth && maxdepth < 2 ) %]>
+   </form>
+   </td>
+
+   <td>
+   <form method="get" action="showdependencytree.cgi"
+         style="display: inline; margin: 0px;">
+     [%# Limit entry form: the button cannot do anything when total depth
+         is less than two, so disable it %]
+     <input name="maxdepth" size="4" maxlength="4" value="[%
+         maxdepth > 0 && maxdepth <= realdepth ? maxdepth : ""
+     %]">
+     <input name="id" type="hidden" value="[% bugid %]">
+     <input name="hide_resolved" type="hidden" value="[% hide_resolved %]">
+     <noscript>
+       <input type="submit" id="change_depth" value="Change"
+              [% "disabled" IF realdepth < 2 %]>
+     </noscript>
+   </form>
+   </td>
+
+   <td>
+   <form method="get" action="showdependencytree.cgi"
+         style="display: inline; margin: 0px;">
+     [%# plus one form
+         Disable button if total depth < 2, or if depth set to unlimited %]
+     <input name="id" type="hidden" value="[% bugid %]">
+     [% IF maxdepth %]
+       <input name="maxdepth" type="hidden" value="[% maxdepth + 1 %]">
+     [% END %]
+     <input name="hide_resolved" type="hidden" value="[% hide_resolved %]">
+     <input type="submit" id="increase_depth" value="&nbsp;&gt;&nbsp;" 
+        [% "disabled" IF realdepth < 2 || !maxdepth || maxdepth >= realdepth %]>
+   </form>
+   </td>
+
+   <td>
+   <form method="get" action="showdependencytree.cgi"
+         style="display: inline; margin: 0px;">
+     [%# Unlimited button %]
+     <input name="id" type="hidden" value="[% bugid %]">
+     <input name="hide_resolved" type="hidden" value="[% hide_resolved %]">
+     <input type="submit" id="remove_limit"
+       value="&nbsp;Unlimited&nbsp;"
+       [% "disabled" IF maxdepth == 0 || maxdepth == realdepth %]>
+   </form>
+   </td>
+ </tr>
+</table>
+
+[% END %]

diff --git a/template/en/default/bug/edit.html.tmpl b/template/en/default/bug/edit.html.tmpl
new file mode 100644 (file)
index 0000000..be7e2f0
--- /dev/null
+++ b/template/en/default/bug/edit.html.tmpl
@@ -0,0 +1,1173 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS bug/time.html.tmpl %]
+
+<script type="text/javascript">
+<!--
+[% IF user.is_timetracker %]
+  var fRemainingTime = [% bug.remaining_time %]; // holds the original value
+  function adjustRemainingTime() {
+      // subtracts time spent from remaining time
+      var new_time;
+
+      // prevent negative values if work_time > fRemainingTime
+      new_time =
+          Math.max(fRemainingTime - document.changeform.work_time.value, 0.0);
+      // get upto 2 decimal places
+      document.changeform.remaining_time.value =
+          Math.round(new_time * 100)/100;
+  }
+
+  function updateRemainingTime() {
+      // if the remaining time is changed manually, update fRemainingTime
+      fRemainingTime = document.changeform.remaining_time.value;
+  }
+[% END %]
+
+[% IF user.id %]
+  /* Index all classifications so we can keep track of the classification
+   * for the selected product, which could control field visibility.
+   */
+  var all_classifications = new Array([% bug.choices.product.size %]);
+  [%- FOREACH product = bug.choices.product %]
+      all_classifications['[% product.name FILTER js %]'] = '
+          [%- product.classification.name FILTER js %]';
+  [%- END %]
+[% END %]
+//-->
+</script>
+
+<form name="changeform" id="changeform" method="post" action="process_bug.cgi">
+
+  <input type="hidden" name="delta_ts" value="[% bug.delta_ts %]">
+  <input type="hidden" name="longdesclength" value="[% bug.comments.size %]">
+  <input type="hidden" name="id" value="[% bug.bug_id %]">
+  <input type="hidden" name="token" value="[% issue_hash_token([bug.id, bug.delta_ts]) FILTER html %]">
+
+  [% PROCESS section_title %]
+  <table class="edit_form">
+    <tr>
+      [%# 1st Column %]
+      <td id="bz_show_bug_column_1" class="bz_show_bug_column">     
+        <table>
+          [%# *** ID, product, component, status, resolution, Hardware, and  OS *** %]
+          [% PROCESS section_status %]
+          
+          [% PROCESS section_spacer %]
+          
+          [% PROCESS section_details1 %]
+          
+          [% PROCESS section_spacer %]
+          
+          [%# *** severity, priority, version and milestone *** %]
+          [% PROCESS section_details2 %]            
+          
+          [%# *** assigned to and qa contact *** %]
+          [% PROCESS section_people %]
+          
+          [% PROCESS section_spacer %]
+          
+          [% PROCESS section_url_keyword_whiteboard %]
+          
+          [% PROCESS section_spacer %]
+
+          [%# *** Dependencies and duplicates *** %]
+          [% PROCESS section_duplicates %]
+
+          [% PROCESS section_dependson_blocks %]
+          
+        </table>
+      </td>
+      <td>
+        <div class="bz_column_spacer">&nbsp;</div>
+      </td>
+      [%# 2nd Column %]
+      <td id="bz_show_bug_column_2" class="bz_show_bug_column">
+        <table cellpadding="3" cellspacing="1">
+        [%# *** Reported and modified dates *** %]
+         [% PROCESS section_dates %]
+         
+         [% PROCESS section_cclist %]
+         
+         [% PROCESS section_spacer %]
+
+         [% PROCESS section_see_also %] 
+         
+         [% PROCESS section_customfields %]
+         
+         [% PROCESS section_spacer %]
+         
+         [% Hook.process("after_custom_fields") %]
+                
+         [% PROCESS section_flags %]
+
+        </table>
+      </td>
+    </tr>
+    <tr>
+      <td colspan="3">
+          <hr id="bz_top_half_spacer">
+      </td>
+    </tr>
+  </table>
+
+  <table id="bz_big_form_parts" cellspacing="0" cellpadding="0"><tr>
+  <td>
+    [% IF user.is_timetracker %]
+      [% PROCESS section_timetracking %]
+    [% END %]
+
+    [%# *** Attachments *** %]
+
+    [% PROCESS attachment/list.html.tmpl
+               attachments = bug.attachments
+               bugid       = bug.bug_id
+               num_attachment_flag_types = bug.num_attachment_flag_types
+               show_attachment_flags = bug.show_attachment_flags
+    %]
+
+    [% IF user.settings.comment_box_position.value == 'before_comments' %]
+      [% PROCESS comment_box %]
+    [% END %]
+  </td>
+  <td>
+    [% PROCESS section_restrict_visibility %]
+  </td>
+  </tr></table>
+
+  [%# *** Additional Comments *** %]
+  <div id="comments">
+    [% PROCESS bug/comments.html.tmpl
+      comments = bug.comments
+      mode = user.id ? "edit" : "show"
+    %]
+  </div>
+
+  [% IF user.settings.comment_box_position.value == 'after_comments' %]
+    <hr>
+    [% PROCESS comment_box %]
+  [% END %]        
+
+</form>
+
+[%############################################################################%]
+[%# Block for the Title (alias and short desc)                               #%]
+[%############################################################################%]
+
+[% BLOCK section_title %]
+  [%# That's the main table, which contains all editable fields. %]
+  <div class="bz_alias_short_desc_container edit_form">
+      [% PROCESS commit_button id="_top"%]
+     <a href="show_bug.cgi?id=[% bug.bug_id %]">
+        [%-# %]<b>[% terms.Bug %]&nbsp;[% bug.bug_id FILTER html %]</b>
+     [%-# %]</a> -<span id="summary_alias_container" class="bz_default_hidden"> 
+      [% IF bug.alias != "" %]
+        (<span id="alias_nonedit_display">[% bug.alias FILTER html %]</span>) 
+      [% END %]
+      <span id="short_desc_nonedit_display">[% bug.short_desc FILTER quoteUrls(bug) %]</span>
+      [% IF bug.check_can_change_field('short_desc', 0, 1) || 
+            bug.check_can_change_field('alias', 0, 1)  %]
+        <small class="editme">(<a href="#" id="editme_action">edit</a>)</small>
+      [% END %]
+     </span>
+  
+       
+    <div id="summary_alias_input">
+      <table id="summary"> 
+        <tr>
+          [% IF bug.check_can_change_field('alias', 0, 1) %]      
+            [% INCLUDE "bug/field-label.html.tmpl"
+               field = bug_fields.alias
+               editable = 1
+            %]
+            <td>
+          [% ELSIF bug.alias %]
+            <td colspan="2">(
+          [% ELSE %]
+            <td colspan="2">
+          [% END %]
+          [% PROCESS input inputname => "alias" 
+                     size => "20" 
+                     maxlength => "20"  
+                     no_td => 1 
+                     %][% ")" IF NOT bug.check_can_change_field('alias', 0, 1) 
+                                  && bug.alias %]
+          </td>
+        </tr>
+        [%# *** Summary *** %]
+        <tr>
+          [% INCLUDE "bug/field-label.html.tmpl"
+            field = bug_fields.short_desc
+            editable = 1
+            accesskey = "s"
+          %]
+          <td>
+            [% PROCESS input inputname => "short_desc" size => "80" colspan => 2
+                             maxlength => 255 spellcheck => "true" no_td => 1 %]
+          </td>
+        </tr>
+      </table>
+    </div>
+  </div>
+  <script type="text/javascript">
+    hideAliasAndSummary('[% bug.short_desc FILTER js %]', '[% bug.alias FILTER js %]');
+  </script>
+[% END %]
+
+[%############################################################################%]
+[%# Block for the first table in the "Details" section                       #%]
+[%############################################################################%]
+
+[% BLOCK section_details1 %]
+
+    [%#############%]
+    [%#  PRODUCT  #%]
+    [%#############%]
+    <tr>
+       [% INCLUDE bug/field.html.tmpl
+            bug = bug, field = bug_fields.product,
+            override_legal_values = bug.choices.product
+            desc_url = 'describecomponents.cgi', value = bug.product
+            editable = bug.check_can_change_field('product', 0, 1) %]
+    </tr>
+
+    [%# Classification is here so that it can be used in value controllers
+      # and visibility controllers. It comes after product because
+      # it uses some javascript that depends on the existence of the
+      # product field.
+      #%]
+    <tr class="bz_default_hidden">
+       [% INCLUDE bug/field.html.tmpl
+            bug = bug field = bug_fields.classification
+            override_legal_values = bug.choices.classification
+            value = bug.classification
+            editable = bug.check_can_change_field('product', 0, 1) %]
+    </tr>
+    [%###############%]    
+    [%#  Component  #%]
+    [%###############%]
+    <tr>
+      [% INCLUDE bug/field.html.tmpl
+          bug = bug, field = bug_fields.component, value = bug.component
+          override_legal_values = bug.choices.component
+          desc_url = "describecomponents.cgi?product=$bug.product"
+          editable = bug.check_can_change_field('component', 0, 1)
+      %]
+    </tr>
+    <tr>
+      [% INCLUDE "bug/field-label.html.tmpl"
+        field = bug_fields.version editable = 1 %]
+        
+      [% PROCESS select selname => "version" %]
+    </tr>
+    [%############%]    
+    [%# PLATFORM #%]
+    [%############%]    
+    <tr>
+      [% INCLUDE "bug/field-label.html.tmpl"
+        field = bug_fields.
+        rep_platform editable = 1
+        accesskey = "h"
+      %]
+      <td class="field_value">
+       [% INCLUDE bug/field.html.tmpl
+            bug = bug, field = bug_fields.rep_platform,
+            no_tds = 1, value = bug.rep_platform
+            editable = bug.check_can_change_field('rep_platform', 0, 1) %]
+       [%+ INCLUDE bug/field.html.tmpl 
+            bug = bug, field = bug_fields.op_sys, 
+            no_tds = 1, value = bug.op_sys
+            editable = bug.check_can_change_field('op_sys', 0, 1) %]
+      </td>
+    </tr>
+
+
+
+[% END %]
+
+[%############################################################################%]
+[%# Block for the status section                                             #%]
+[%############################################################################%]
+
+[% BLOCK section_status %]
+  <tr>
+    <th class="field_label">
+      <a href="page.cgi?id=fields.html#status">Status</a>:
+    </th>
+    <td id="bz_field_status">
+      <span id="static_bug_status">
+        [% display_value("bug_status", bug.bug_status) FILTER html %]
+        [% IF bug.resolution %]
+          [%+ display_value("resolution", bug.resolution) FILTER html %]
+          [% IF bug.dup_id %]
+            of [% "${terms.bug} ${bug.dup_id}" FILTER bug_link(bug.dup_id) FILTER none %]
+          [% END %]
+        [% END %]
+        [% IF bug.user.canedit || bug.user.isreporter %]
+          (<a href="#add_comment" 
+              onclick="window.setTimeout(function() { document.getElementById('bug_status').focus(); }, 10)">edit</a>)
+        [% END %]
+      </span>
+    </td>
+  </tr>
+[% END %]
+
+[%############################################################################%]
+[%# Block for the second table in the "Details" section                      #%]
+[%############################################################################%]
+
+[% BLOCK section_details2 %]
+
+ [%###############################################################%]
+ [%# Importance (priority and severity) #%]
+ [%###############################################################%]
+    <tr>
+      <th class="field_label">
+        <label for="priority" accesskey="i">
+          <a href="page.cgi?id=fields.html#importance"><u>I</u>mportance</a></label>:
+      </th>
+      <td>
+       [% INCLUDE bug/field.html.tmpl
+            bug = bug, field = bug_fields.priority,
+            no_tds = 1, value = bug.priority
+            editable = bug.check_can_change_field('priority', 0, 1) %]
+       [%+ INCLUDE bug/field.html.tmpl
+            bug = bug, field = bug_fields.bug_severity,
+            no_tds = 1, value = bug.bug_severity
+            editable = bug.check_can_change_field('bug_severity', 0, 1) %]
+        [% Hook.process('after_importance', 'bug/edit.html.tmpl') %]
+      </td>
+    </tr>
+
+    [% IF Param("usetargetmilestone") && bug.target_milestone %]
+      <tr>
+        <th class="field_label">
+          <label for="target_milestone">
+            <a href="page.cgi?id=fields.html#target_milestone">
+            Target&nbsp;Milestone</a></label>:
+        </th>
+        [% PROCESS select selname = "target_milestone" %]
+      </tr>
+    [% END %]
+  
+[% END %]
+
+[%############################################################################%]
+[%# Block for the table in the "People" section                              #%]
+[%############################################################################%]
+
+[% BLOCK section_people %]
+
+    <tr>
+      <th class="field_label">
+        <a href="page.cgi?id=fields.html#assigned_to">Assigned To</a>:
+      </th>
+      <td>
+        [% IF bug.check_can_change_field("assigned_to", 0, 1) %]
+          <div id="bz_assignee_edit_container" class="bz_default_hidden">
+            <span>
+              [% INCLUDE global/user.html.tmpl who = bug.assigned_to %]
+              (<a href="#" id="bz_assignee_edit_action">edit</a>)
+              [% IF bug.assigned_to.id != user.id %]
+                (<a title="Reassign to yourself" 
+                    href="#" id="bz_assignee_take_action">take</a>)
+              [% END %]
+            </span>
+          </div>
+          <div id="bz_assignee_input">
+            [% INCLUDE global/userselect.html.tmpl
+                 id => "assigned_to"
+                 name => "assigned_to"
+                 value => bug.assigned_to.login
+                 classes => ["bz_userfield"]
+                 size => 30
+            %]
+            <br>
+            <input type="checkbox" id="set_default_assignee" name="set_default_assignee" value="1">
+            <label id="set_default_assignee_label" for="set_default_assignee">Reset Assignee to default</label>
+          </div>
+          <script type="text/javascript">
+           hideEditableField('bz_assignee_edit_container', 
+                             'bz_assignee_input', 
+                             'bz_assignee_edit_action', 
+                             'assigned_to', 
+                             '[% bug.assigned_to.login FILTER js %]' );
+           hideEditableField('bz_assignee_edit_container',
+                             'bz_assignee_input',
+                             'bz_assignee_take_action',
+                             'assigned_to',
+                             '[% bug.assigned_to.login FILTER js %]',
+                             '[% user.login FILTER js %]' );
+           initDefaultCheckbox('assignee');                  
+          </script>
+        [% ELSE %]
+          [% INCLUDE global/user.html.tmpl who = bug.assigned_to %]
+        [% END %]
+      </td>
+    </tr>
+
+    [% IF Param('useqacontact') %]
+    <tr>
+      [% INCLUDE "bug/field-label.html.tmpl"
+        field = bug_fields.qa_contact
+        editable = 1
+        accesskey = "q"
+      %]
+      <td>
+        [% IF bug.check_can_change_field("qa_contact", 0, 1) %]
+          <div id="bz_qa_contact_edit_container" class="bz_default_hidden">
+            <span>
+              [% INCLUDE global/user.html.tmpl who = bug.qa_contact %]
+              (<a href="#" id="bz_qa_contact_edit_action">edit</a>)
+              [% IF bug.qa_contact.id != user.id %]
+                (<a title="Change QA contact to yourself" 
+                    href="#" id="bz_qa_contact_take_action">take</a>)
+              [% END %]
+            </span>
+          </div>
+          <div id="bz_qa_contact_input">
+            [% INCLUDE global/userselect.html.tmpl
+               id      => "qa_contact"
+               name    => "qa_contact"
+               value   => bug.qa_contact.login
+               size    => 30
+               classes => ["bz_userfield"]
+               emptyok => 1
+            %]
+            <br>
+            <input type="checkbox" id="set_default_qa_contact" name="set_default_qa_contact" value="1">
+            <label for="set_default_qa_contact" id="set_default_qa_contact_label">Reset QA Contact to default</label>
+          </div>
+          <script type="text/javascript">
+            hideEditableField('bz_qa_contact_edit_container', 
+                              'bz_qa_contact_input', 
+                              'bz_qa_contact_edit_action', 
+                              'qa_contact', 
+                              '[% bug.qa_contact.login FILTER js %]');
+            hideEditableField('bz_qa_contact_edit_container', 
+                              'bz_qa_contact_input', 
+                              'bz_qa_contact_take_action', 
+                              'qa_contact', 
+                              '[% bug.qa_contact.login FILTER js %]',
+                              '[% user.login FILTER js %]');
+            initDefaultCheckbox('qa_contact');
+          </script>
+        [% ELSE %]
+          [% INCLUDE global/user.html.tmpl who = bug.qa_contact %]
+        [% END %]
+      </td>
+    </tr>
+    [% END %]
+    <script type="text/javascript">
+      assignToDefaultOnChange(['product', 'component'],
+        '[% bug.component_obj.default_assignee.login FILTER js %]',
+        '[% bug.component_obj.default_qa_contact.login FILTER js %]');
+    </script>
+[% END %]
+
+[%############################################################################%]
+[%# Block for URL Keyword and Whiteboard                                     #%]
+[%############################################################################%]
+[% BLOCK section_url_keyword_whiteboard %]
+  <tr>
+    [% INCLUDE "bug/field-label.html.tmpl"
+      field = bug_fields.bug_file_loc
+      editable = 1
+      accesskey = "u"
+    %]
+    <td>
+      [% IF bug.check_can_change_field("bug_file_loc", 0, 1) %]
+        <span id="bz_url_edit_container" class="bz_default_hidden"> 
+        [% IF is_safe_url(bug.bug_file_loc) %]
+           <a href="[% bug.bug_file_loc FILTER html %]" target="_blank"
+              title="[% bug.bug_file_loc FILTER html %]">
+             [% bug.bug_file_loc FILTER truncate(40) FILTER html %]</a>
+        [% ELSE %]
+          [% bug.bug_file_loc FILTER html %]
+        [% END %]
+        (<a href="#" id="bz_url_edit_action">edit</a>)</span>
+      [% END %]
+      <span id="bz_url_input_area">
+        [% url_output =  PROCESS input no_td=1 inputname => "bug_file_loc" size => "40" colspan => 2 %]
+        [% IF NOT bug.check_can_change_field("bug_file_loc", 0, 1)
+              AND is_safe_url(bug.bug_file_loc) %]
+          <a href="[% bug.bug_file_loc FILTER html %]">[% url_output FILTER none %]</a>
+        [% ELSE %]
+          [% url_output FILTER none %]
+        [% END %]
+      </span>
+      [% IF bug.check_can_change_field("bug_file_loc", 0, 1) %]
+        <script type="text/javascript">
+          hideEditableField('bz_url_edit_container', 
+                            'bz_url_input_area', 
+                            'bz_url_edit_action', 
+                            'bug_file_loc', 
+                            "[% bug.bug_file_loc FILTER js %]");
+        </script>
+      [% END %]
+    </td>
+  </tr>
+  
+  [% IF Param('usestatuswhiteboard') %]
+    <tr>
+      [% INCLUDE "bug/field-label.html.tmpl"
+        field = bug_fields.status_whiteboard
+        editable = 1
+        accesskey = "w"
+      %]
+      [% PROCESS input inputname => "status_whiteboard" size => "40" colspan => 2 %]
+    </tr>
+  [% END %]
+  
+  [% IF use_keywords %]
+    <tr>
+      <th class="field_label">
+        <label for="keywords" accesskey="k">
+          <a href="describekeywords.cgi"><u>K</u>eywords</a></label>:
+      </th>
+      <td class="field_value" colspan="2">
+        [% INCLUDE bug/field.html.tmpl
+           bug = bug, field = bug_fields.keywords, value = bug.keywords
+           editable = bug.check_can_change_field("keywords", 0, 1),
+           no_tds = 1, possible_values = all_keywords
+        %]
+      </td>
+    </tr>
+  [% END %]
+
+  [% IF user.id %]
+    <tr>
+      [% INCLUDE bug/field.html.tmpl
+         bug = bug, field = bug_fields.tag, value = bug.tags.join(", "),
+         editable = 1, possible_values = user.tags.keys
+      %]
+    </tr>
+  [% END %]
+[% END %]
+
+[%############################################################################%]
+[%# Block for Duplicates                                                     #%]
+[%############################################################################%]
+
+[% BLOCK section_duplicates %]
+  [% RETURN UNLESS bug.duplicates.size %]
+  <tr>
+    <th class="field_label">
+      <label for="duplicates">Duplicates</label>:
+    </th>
+    <td class="field_value" colspan="2">
+      <span id="duplicates">
+        [% FOREACH dupe = bug.duplicates %]
+          [% dupe.id FILTER bug_link(dupe, use_alias => 1) FILTER none %][% " " %]
+        [% END %]
+      </span>
+      (<a href="buglist.cgi?bug_id=[% bug.duplicate_ids.join(",") FILTER html %]">
+       [%-%]view as [% terms.bug %] list</a>)
+    </td>
+  </tr>
+[% END %]
+
+[%############################################################################%]
+[%# Block for Depends On / Blocks                                            #%]
+[%############################################################################%]
+
+[% BLOCK section_dependson_blocks %]
+  <tr>
+    [% INCLUDE dependencies 
+         field = bug_fields.dependson deps = bug.depends_on_obj %]
+  </tr>
+  
+  <tr>
+    [% INCLUDE dependencies 
+         field = bug_fields.blocked deps = bug.blocks_obj %]
+  </tr>
+  
+  <tr>
+    <th>&nbsp;</th>
+  
+    <td colspan="2" align="left" id="show_dependency_tree_or_graph">
+      Show dependency <a href="showdependencytree.cgi?id=[% bug.bug_id %]&amp;hide_resolved=1">tree</a>
+  
+      [% IF Param('webdotbase') %]
+        /&nbsp;<a href="showdependencygraph.cgi?id=[% bug.bug_id %]">graph</a>
+      [% END %]
+    </td>
+  </tr>
+[% END %]
+
+
+[%############################################################################%]
+[%# Block for Restricting Visibility                                         #%]
+[%############################################################################%]
+
+[% BLOCK section_restrict_visibility %]
+  [% RETURN UNLESS bug.groups.size %]
+
+  <div class="bz_group_visibility_section">
+    [% inallgroups = 1 %]
+    [% inagroup = 0 %]
+    [% emitted_description = 0 %]
+
+    [% FOREACH group = bug.groups %]
+      [% SET inallgroups = 0 IF NOT group.ingroup %]
+      [% SET inagroup = 1 IF group.ison %]
+
+      [% NEXT IF group.mandatory %]
+
+      [% IF NOT emitted_description %]
+        [% emitted_description = 1 %]
+          <div id="bz_restrict_group_visibility_help">
+            <b>Only users in all of the selected groups can view this 
+              [%+ terms.bug %]:</b>
+             <p class="instructions">
+               Unchecking all boxes makes this a more public [% terms.bug %].
+             </p>
+          </div>
+      [% END %]
+
+      [% IF group.ingroup %]
+        <input type="hidden" name="defined_groups" 
+               value="[% group.name FILTER html %]">
+      [% END %]
+
+      <input type="checkbox" value="[% group.name FILTER html %]"
+             name="groups" id="group_[% group.bit %]"
+             [% ' checked="checked"' IF group.ison %]
+             [% ' disabled="disabled"' IF NOT group.ingroup %]>
+      <label for="group_[% group.bit %]">
+      [%- group.description FILTER html_light %]</label>
+      <br>
+    [% END %]
+
+    [% IF emitted_description %]
+      [% IF NOT inallgroups %]
+        <p class="instructions">Only members of a group can change the 
+          visibility of [% terms.abug %] for that group.</p>
+      [% END %]
+    [% END %]
+
+    [% IF inagroup %]
+      <div id="bz_enable_role_visibility_help">
+        <b>Users in the roles selected below can always view 
+          this [% terms.bug %]:</b>
+      </div>
+      <div id="bz_enable_role_visibility">
+        <div>
+          [% user_can_edit_accessible = 
+            bug.check_can_change_field("reporter_accessible", 0, 1) 
+          %]
+          [% IF user_can_edit_accessible %]
+            <input type="hidden" name="defined_reporter_accessible" value="1">
+          [% END %]
+          <input type="checkbox" value="1"
+                 name="reporter_accessible" id="reporter_accessible"
+                 [% " checked" IF bug.reporter_accessible %]
+                 [% " disabled=\"disabled\"" UNLESS user_can_edit_accessible %]>
+          <label for="reporter_accessible">Reporter</label>
+        </div>
+        <div>
+          [% user_can_edit_accessible = 
+            bug.check_can_change_field("cclist_accessible", 0, 1) 
+          %]
+          [% IF user_can_edit_accessible %]
+            <input type="hidden" name="defined_cclist_accessible" value="1">
+          [% END %]
+          <input type="checkbox" value="1"
+                 name="cclist_accessible" id="cclist_accessible"
+                 [% " checked" IF bug.cclist_accessible %]
+                 [% " disabled=\"disabled\"" UNLESS user_can_edit_accessible %]>
+          <label for="cclist_accessible">CC List</label>
+        </div>
+        <p class="instructions">
+          The assignee
+          [% IF (Param('useqacontact')) %]
+             and QA contact
+          [% END %]
+          can always see [% terms.abug %], and this section does not
+          take effect unless the [% terms.bug %] is restricted to at
+          least one group.
+        </p>
+      </div>
+    [% END %]
+  </div> [%# bz_group_visibility_section %]
+[% END %]
+
+[%############################################################################%]
+[%# Block for Dates                                                          #%]
+[%############################################################################%]
+
+[% BLOCK section_dates %]
+  <tr>
+    <th class="field_label">
+      Reported:
+    </th>
+    <td>
+     [% bug.creation_ts FILTER time %] by [% INCLUDE global/user.html.tmpl who = bug.reporter %]
+    </td>
+  </tr>
+  
+  <tr>
+    <th class="field_label">
+      Modified:
+    </th>
+    <td>
+      [% bug.delta_ts FILTER time FILTER replace(':\d\d$', '') FILTER replace(':\d\d ', ' ')%] 
+      (<a href="show_activity.cgi?id=[% bug.bug_id %]">[%# terms.Bug %]History</a>)
+    </td>
+  
+  </tr>
+[% END %]
+
+[%############################################################################%]
+[%# Block for CC LIST                                                        #%]
+[%############################################################################%]
+[% BLOCK section_cclist %]
+    <tr>
+      <th class="field_label">
+        <label for="newcc" accesskey="a">CC List:</label>
+      </th>
+      <td>
+        [% IF user.id %]
+          [% IF NOT bug.cc || NOT bug.cc.contains(user.login) %]
+            <input type="checkbox" id="addselfcc" name="addselfcc"
+              [% " checked=\"checked\""
+                   IF user.settings.state_addselfcc.value == 'always'
+                      || (!bug.user.has_any_role
+                          && user.settings.state_addselfcc.value == 'cc_unless_role') %]>
+            <label for="addselfcc">Add me to CC list</label>
+            <br> 
+          [% END %]
+        [% END %]
+        [% bug.cc.size || 0  FILTER html %] 
+        [% IF bug.cc.size == 1 %]
+          user
+        [% ELSE %]
+          users
+        [% END %]
+        [% IF user.id %]
+          [% IF bug.cc.contains( user.email ) %]
+            including you
+          [% END %]
+        [% END %]
+        [% IF user.id || bug.cc.size %]
+          <span id="cc_edit_area_showhide_container" class="bz_default_hidden">
+            (<a href="#" id="cc_edit_area_showhide">[% IF user.id %]edit[% ELSE %]show[% END %]</a>)
+          </span>
+        [% END %]
+        <div id="cc_edit_area">
+          <br>
+          [% IF user.id %]
+            <div>
+              <div><label for="cc"><b>Add</b></label></div>
+              [% INCLUDE global/userselect.html.tmpl
+                  id => "newcc"
+                  name => "newcc"
+                  value => ""
+                  size => 30
+                  classes => ["bz_userfield"]
+                  multiple => 5
+                %]
+            </div>
+          [% END %]
+          [% IF bug.cc %]
+            <select id="cc" multiple="multiple" size="5"
+              [% IF bug.user.canedit %]name="cc"[% END %]>
+              [% FOREACH c = bug.cc %]
+                <option value="[% c FILTER email FILTER html %]">
+                  [% c FILTER email FILTER html %]</option>
+              [% END %]
+            </select>
+            [% IF user.id && !bug.user.canedit %]
+              <input type="hidden" name="cc" value="[% user.login FILTER email FILTER html %]">
+            [% END %]
+            [% IF user.id AND (bug.user.canedit OR bug.cc.contains(user.login)) %]
+              <br>
+              <input type="checkbox" id="removecc" name="removecc">
+              <label for="removecc">
+                [% IF bug.user.canedit %]
+                  Remove selected CCs
+                [% ELSE %]
+                  Remove me from the CC list
+                [% END %]
+              </label>
+              <br>
+            [% END %]
+          [% END %]
+        </div>
+        [% IF user.id || bug.cc.size %]
+          <script type="text/javascript">
+            hideEditableField( 'cc_edit_area_showhide_container', 
+                               'cc_edit_area', 
+                               'cc_edit_area_showhide', 
+                               '', 
+                               '');  
+          </script>
+        [% END %]
+      </td>
+    </tr>
+[% END %]
+
+[%############################################################################%]
+[%# Block for See Also                                                       #%]
+[%############################################################################%]
+[% BLOCK section_see_also %]
+  [% IF Param('use_see_also') || bug.see_also.size %]
+    <tr>
+      [% INCLUDE bug/field.html.tmpl 
+           field    = bug_fields.see_also
+           value    = bug.see_also
+           editable = bug.check_can_change_field('see_also', 0, 1)
+      %]
+    </tr>
+  [% END %]
+[% END %]
+
+[%############################################################################%]
+[%# Block for FLAGS                                                          #%]
+[%############################################################################%]
+
+[% BLOCK section_flags %]
+  [%# *** Flags *** %]
+  [% show_bug_flags = 0 %]
+  [% bug_flags_set = 0 %]
+  [% show_more_flags = 0 %]
+  [% FOREACH type = bug.flag_types %]
+    [% IF type.flags.size || (user.id && type.is_active && user.can_request_flag(type)) %]
+      [% show_bug_flags = 1 %]
+    [% END %]
+    [% IF user.id && type.is_active && (!type.flags.size || type.is_multiplicable) %]
+      [% show_more_flags = 1 %]
+    [% END %]
+    [% IF type.flags.size %]
+      [% bug_flags_set = 1 %]
+    [% END %]
+    [% LAST IF show_bug_flags && show_more_flags && bug_flags_set %]
+  [% END %]
+  [% IF show_bug_flags %]
+    <tr>
+      <th class="field_label flags_label">
+        <label>Flags:</label>
+      </th>
+      <td></td>
+    </tr>
+    <tr>
+      <td colspan="2">
+        [% IF bug.flag_types.size %]
+          [% PROCESS "flag/list.html.tmpl" flag_no_header = 1
+                                           flag_types = bug.flag_types
+                                           any_flags_requesteeble = bug.any_flags_requesteeble %]
+        [% END %]
+        [% IF show_more_flags %]
+          <span id="bz_flags_more_container" class="bz_default_hidden">
+            [% IF !bug_flags_set %]<em>None yet set</em>[% END %]
+            (<a href="#" id="bz_flags_more_action">[% IF !bug_flags_set %]set[% ELSE %]more[% END %] flags</a>)
+          </span>
+          <script type="text/javascript">
+            YAHOO.util.Dom.removeClass('bz_flags_more_container', 'bz_default_hidden');
+            var table = YAHOO.util.Dom.get("flags");
+            var rows = YAHOO.util.Dom.getElementsByClassName('bz_flag_type', 'tbody', table);
+            for (var i = 0; i < rows.length; i++) {
+                YAHOO.util.Dom.addClass(rows[i], 'bz_default_hidden');
+            }
+            YAHOO.util.Event.addListener('bz_flags_more_action', 'click', function (e) {
+                YAHOO.util.Dom.addClass('bz_flags_more_container', 'bz_default_hidden');
+                for (var i = 0; i < rows.length; i++) {
+                    YAHOO.util.Dom.removeClass(rows[i], 'bz_default_hidden');
+                }
+                YAHOO.util.Event.preventDefault(e);
+            }); 
+          </script>
+        [% END %]
+      </td>
+    </tr>
+  [% END %]
+[% END %]
+
+[%############################################################################%]
+[%# Block for Custom Fields                                                  #%]
+[%############################################################################%]
+
+[% BLOCK section_customfields %]
+[%# *** Custom Fields *** %]
+  [% USE Bugzilla %]
+  [% FOREACH field = Bugzilla.active_custom_fields %]
+    <tr>
+      [% PROCESS bug/field.html.tmpl value = bug.${field.name}
+                                     editable = bug.check_can_change_field(field.name, 0, 1)
+                                     value_span = 2 %]
+    </tr>
+    [% IF extra_field_item %]
+      <tr>
+        <th class="field_label">[% extra_field_item.header FILTER none %]</th>
+        <td>[% extra_field_item.data FILTER none %]</td>
+      </tr>
+    [% END %]
+  [% END %]
+[% END %]
+
+[%############################################################################%]
+[%# Block for Section Spacer                                                 #%]
+[%############################################################################%]
+
+[% BLOCK section_spacer %]
+  <tr>
+    <td colspan="2" class="bz_section_spacer"></td>
+  </tr>
+[% END %]
+
+
+
+
+[%############################################################################%]
+[%# Block for dependencies                                                   #%]
+[%############################################################################%]
+
+[% BLOCK dependencies %]
+
+  [% INCLUDE "bug/field-label.html.tmpl" %]
+
+  <td>
+    <span id="[% field.name FILTER html %]_input_area">
+      [% IF bug.check_can_change_field(field.name, 0, 1) %]
+        <input name="[% field.name FILTER html %]" 
+               id="[% field.name FILTER html %]" class="text_input"
+               value="[% bug.${field.name}.join(', ') FILTER html %]">
+      [% END %]
+    </span>
+    
+    [% FOREACH dep_bug = deps %]
+      [% dep_bug.id FILTER bug_link(dep_bug, use_alias => 1)
+                    FILTER none %][% " " %]
+    [% END %]
+    [% IF bug.check_can_change_field(field.name, 0, 1) %]
+      <span id="[% field.name FILTER html %]_edit_container" 
+            class="edit_me bz_default_hidden">
+        (<a href="#" id="[% field.name FILTER html %]_edit_action">edit</a>)
+      </span>
+      <script type="text/javascript">
+        hideEditableField('[% field.name FILTER js %]_edit_container', 
+                          '[% field.name FILTER js %]_input_area', 
+                          '[% field.name FILTER js %]_edit_action', 
+                          '[% field.name FILTER js %]', 
+                          '[% bug.${field.name}.join(', ') FILTER js %]');
+      </script>
+    [% END %]
+  </td>
+  
+[% END %]
+
+[%############################################################################%]
+[%# Block for Time Tracking Group                                            #%]
+[%############################################################################%]
+
+[% BLOCK section_timetracking %]
+  <table class="bz_time_tracking_table">
+    <tr>
+      [% INCLUDE "bug/field-label.html.tmpl"
+         field = bug_fields.estimated_time, editable = 1
+      %]
+      <th>
+        Current Est.:
+      </th>
+      [% INCLUDE "bug/field-label.html.tmpl"
+         field = bug_fields.work_time, editable = 1
+      %]
+      [% INCLUDE "bug/field-label.html.tmpl"
+         field = bug_fields.remaining_time, editable = 1
+      %]
+      [% INCLUDE "bug/field-label.html.tmpl"
+         field = bug_fields.percentage_complete, editable = 1
+      %]
+      <th>
+        Gain:
+      </th>
+      [% INCLUDE "bug/field-label.html.tmpl"
+         field = bug_fields.deadline, editable = 1
+      %]
+    </tr>
+    <tr>
+      <td>
+        <input name="estimated_time" id="estimated_time"
+               value="[% PROCESS formattimeunit
+                                 time_unit=bug.estimated_time %]"
+               size="6" maxlength="6">
+      </td>
+      <td>
+        [% PROCESS formattimeunit
+                   time_unit=(bug.actual_time + bug.remaining_time) %]
+      </td>
+      <td>
+        [% PROCESS formattimeunit time_unit=bug.actual_time %] +
+        <input name="work_time" id="work_time"
+               value="0" size="3" maxlength="6"
+               onchange="adjustRemainingTime();">
+      </td>
+      <td>
+        <input name="remaining_time" id="remaining_time"
+               value="[% PROCESS formattimeunit
+                                 time_unit=bug.remaining_time %]"
+               size="6" maxlength="6" onchange="updateRemainingTime();">
+      </td>
+      <td>
+        [% PROCESS calculatepercentage act=bug.actual_time
+                                       rem=bug.remaining_time %]
+      </td>
+      <td>
+        [% PROCESS formattimeunit time_unit=bug.estimated_time - (bug.actual_time + bug.remaining_time) %]
+      </td>
+       <td>
+         [% INCLUDE bug/field.html.tmpl
+           field = bug_fields.deadline, value = bug.deadline, no_tds = 1
+           editable = bug.check_can_change_field('deadline', 0, 1) %]
+      </td>        
+    </tr>
+    <tr>
+      <td colspan="7" class="bz_summarize_time">
+        <a href="summarize_time.cgi?id=[% bug.bug_id %]&amp;do_depends=1">
+        Summarize time (including time for [% terms.bugs %]
+        blocking this [% terms.bug %])</a>
+      </td>
+    </tr>
+  </table> 
+[% END %]
+
+[%############################################################################%]
+[%# Block for the Additional Comments box                                    #%]
+[%############################################################################%]
+
+[% BLOCK comment_box %]
+  <div id="add_comment" class="bz_section_additional_comments">
+    [% IF user.id %]
+      <label for="comment" accesskey="c"><b>Additional 
+        <u>C</u>omments</b></label>:
+
+      [% IF user.is_insider && bug.check_can_change_field('longdesc', 0, 1) %]
+        <input type="checkbox" name="comment_is_private" value="1"
+               id="newcommentprivacy"
+               onClick="updateCommentTagControl(this, 'comment')">
+        <label for="newcommentprivacy">
+          Make comment private (visible only to members of the
+          <strong>[% Param('insidergroup') FILTER html %]</strong> group)
+        </label>
+      [% END %]
+
+      <!-- This table keeps the submit button aligned with the box. -->
+      <table><tr><td>
+        [% IF bug.check_can_change_field('longdesc', 0, 1) %]
+          [% INCLUDE global/textarea.html.tmpl
+                     name      = 'comment'
+                     id        = 'comment'
+                     minrows   = 10
+                     maxrows   = 25
+                     cols      = constants.COMMENT_COLS
+          %]
+          [% Hook.process("after_comment_textarea", 'bug/edit.html.tmpl') %]
+        [% ELSE %]
+          You are not allowed to make an additional comment on this [% terms.bug %].
+        [% END %]
+        <br>
+        [% PROCESS commit_button id=""%]
+
+        <table id="bug_status_bottom"
+               class="status" cellspacing="0" cellpadding="0">
+          <tr>
+            <th class="field_label">
+              <a href="page.cgi?id=fields.html#status">Status</a>:
+            </th>
+            <td>
+              [% PROCESS bug/knob.html.tmpl %]
+            </td>
+          </tr>
+        </table>
+      </td></tr></table>
+
+    [%# For logged-out users %]
+    [% ELSE %]
+      <table>
+        <tr>
+          <td>
+            <fieldset>
+              <legend>Note</legend>
+              You need to
+              <a href="show_bug.cgi?id=
+                      [%- bug.bug_id %]&amp;GoAheadAndLogIn=1">log in</a>
+              before you can comment on or make changes to this [% terms.bug %].
+            </fieldset>
+          </td>
+        </tr> 
+      </table>
+    [% END %]
+  </div>
+[% END %]
+
+[%############################################################################%]
+[%# Block for SELECT fields                                                  #%]
+[%############################################################################%]
+
+[% BLOCK select %]
+  <td>
+    [% IF bug.check_can_change_field(selname, 0, 1) 
+          AND bug.choices.${selname}.size > 1 %]
+      <input type="hidden" id="[% selname %]_dirty">
+      <select id="[% selname %]" name="[% selname %]">
+        [% FOREACH x = bug.choices.${selname} %]
+          [% NEXT IF NOT x.is_active AND x.name != bug.${selname} %]
+          <option value="[% x.name FILTER html %]"
+            [% " selected" IF x.name == bug.${selname} %]>
+            [%- x.name FILTER html %]
+          </option>
+        [% END %]
+      </select>
+    [% ELSE %]
+      [% bug.${selname} FILTER html %]
+    [% END %]
+  </td>
+[% END %]
+
+[%############################################################################%]
+[%# Block for INPUT fields                                                   #%]
+[%############################################################################%]
+
+[% BLOCK input %]
+  [% IF no_td != 1 %]
+  <td[% " colspan=\"$colspan\"" IF colspan %]>
+  [% END %]
+    [% val = value ? value : bug.$inputname %]
+    [% IF bug.check_can_change_field(inputname, 0, 1) %]
+       <input id="[% inputname %]" name="[% inputname %]" class="text_input"
+              value="[% val FILTER html %]"[% " size=\"$size\"" IF size %]
+              [% " maxlength=\"$maxlength\"" IF maxlength %]
+              [% " spellcheck=\"$spellcheck\"" IF spellcheck %]>
+    [% ELSE %]
+      [% IF size && val.length > size %]
+        <span title="[% val FILTER html %]">
+          [% val FILTER truncate(size) FILTER html %]
+        </span>
+      [% ELSE %]
+        [% val FILTER html %]
+      [% END %]
+    [% END %]
+  [% IF no_td != 1 %]  
+  </td>
+  [% END %]
+  [% no_td = 0 %]
+  [% maxlength = 0 %]
+  [% colspan = 0 %]
+  [% size = 0 %]
+  [% value = undef %]
+  [% spellcheck = undef %]
+[% END %]
+[% BLOCK commit_button %]
+  [% IF user.id %]
+    <div class="knob-buttons">
+      <input type="submit" value="Save Changes" 
+             id="commit[% id FILTER css_class_quote %]">
+    </div>
+  [% END %]
+[% END %]

diff --git a/template/en/default/bug/field-events.js.tmpl b/template/en/default/bug/field-events.js.tmpl
new file mode 100644 (file)
index 0000000..8ec51a4
--- /dev/null
+++ b/template/en/default/bug/field-events.js.tmpl
@@ -0,0 +1,59 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  #   field: a Bugzilla::Field object
+  #   product: (optional) a Bugzilla::Product object. When specified,
+  #            components are restricted to this product.
+  #%]
+
+[% FOREACH controlled_field = field.controls_visibility_of %]
+  [% vis_names = [] %]
+  [% FOREACH visibility_value = controlled_field.visibility_values %]
+    [%# Exclude non-enterable products and components outside the current product. %]
+    [% NEXT IF field.name == "product"
+               && visibility_value.id != product.id
+               && !user.can_enter_product(visibility_value) %]
+    [% NEXT IF field.name == "component" && visibility_value.product_id != product.id %]
+    [% vis_names.push(visibility_value.name) %]
+  [% END %]
+
+  [% NEXT UNLESS vis_names.size %]
+
+  showFieldWhen('[% controlled_field.name FILTER js %]',
+                '[% field.name FILTER js %]', [
+                [%~ FOREACH vis_name = vis_names ~%]
+                  '[% vis_name FILTER js %]'[% "," UNLESS loop.last %]
+                [%~ END ~%]
+  ]);
+[% END %]
+
+[% legal_values = [] %]
+[% IF field.name == "component" AND product %]
+  [% legal_values = product.components %]
+[% ELSE %]
+  [% legal_values = field.legal_values %]
+[% END %]
+
+[% FOREACH legal_value = legal_values %]
+  [% FOREACH controlled_field = legal_value.controlled_values.keys %]
+    [% SET cont_ids = [] %]
+    [% FOREACH val = legal_value.controlled_values.$controlled_field %]
+      [% NEXT IF !val.is_active %]
+      [% cont_ids.push(val.id) %]
+    [% END %]
+    [% NEXT IF !cont_ids.size %]
+    showValueWhen('[% controlled_field FILTER js %]',
+                  [[% cont_ids.join(',') FILTER js %]],
+                  '[% field.name FILTER js %]',
+                  [% legal_value.id FILTER js %]);
+  [% END %]
+[% END %]
+[% IF field.name == 'classification' %]
+  YAHOO.util.Event.on('product', 'change', setClassification);
+[% END %]

diff --git a/template/en/default/bug/field-help.none.tmpl b/template/en/default/bug/field-help.none.tmpl
new file mode 100644 (file)
index 0000000..238f01d
--- /dev/null
+++ b/template/en/default/bug/field-help.none.tmpl
@@ -0,0 +1,239 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# This file describes both bug fields and search fields.
+  # As calling this template once per label is very expensive,
+  # it is called only by Template.pm. %]
+
+[% RETURN UNLESS in_template_var %]
+
+[% vars.help_html = {
+
+# Note that all these keys here are in alphabetical order, though
+# search-specific fields are at the bottom.
+
+##############
+# Bug Fields #
+##############
+
+alias =>
+  "A short, unique name assigned to $terms.abug in order to assist with
+   looking it up and referring to it in other places in ${terms.Bugzilla}.",
+
+assigned_to =>
+  "The person in charge of resolving the ${terms.bug}.",
+
+blocked =>
+  "This $terms.bug must be resolved before the $terms.bugs listed in this
+   field can be resolved.",
+
+bug_file_loc =>
+  "$terms.Bugs can have a URL associated with them - for example, a"
+  _ " pointer to a web site where the problem is seen.",
+
+bug_id =>
+  "The numeric id of $terms.abug, unique within this entire installation"
+  _ " of ${terms.Bugzilla}.",
+
+bug_severity =>
+  "How severe the $terms.bug is, or whether it's an enhancement.",
+
+bug_status =>
+  "$terms.Abug may be in any of a number of states.",
+
+cc =>
+  "Users who may not have a direct role to play on this $terms.bug, but who
+   are interested in its progress.",
+
+classification => 
+  "$terms.Bugs are categorised into Classifications, Products and"
+  _ " Components. classifications is the top-level categorisation.",   
+
+component => 
+  "Components are second-level categories; each belongs to a"
+  _ " particular Product. Select a Product to narrow down this list.",
+
+creation_ts =>
+  "When the $terms.bug was filed.",
+
+deadline =>
+  "The date that this $terms.bug must be resolved by, entered in YYYY-MM-DD
+   format.",
+
+delta_ts =>
+  "When this $terms.bug was last updated.",
+
+dependson =>
+  "The $terms.bugs listed here must be resolved before this $terms.bug
+   can be resolved.",
+
+estimated_time =>
+  "The amount of time that has been estimated it will take to resolve
+   this ${terms.bug}.",
+
+keywords =>
+   "You can add keywords from a defined list to $terms.bugs, in order"
+   _ " to easily identify and group them.",
+
+longdesc =>
+  "$terms.Bugs have comments added to them by $terms.Bugzilla users."
+  _ " You can search for some text in those comments.",
+
+op_sys =>
+  "The operating system the $terms.bug was observed on.",
+
+percentage_complete =>
+  "How close to 100% done this $terms.bug is, by comparing its
+   $vars.field_descs.work_time to its ${vars.field_descs.estimated_time}.",
+
+priority =>
+  "Engineers prioritize their $terms.bugs using this field.",
+
+# Note that this has extra text added below if useclassification is on.
+product =>
+  "$terms.Bugs are categorised into Products and Components.",
+
+qa_contact =>
+  "The person responsible for confirming this $terms.bug if it is"
+  _ " unconfirmed, and for verifying the fix once the $terms.bug"
+  _ " has been resolved.",
+
+remaining_time =>
+  "The number of hours of work left on this $terms.bug, calculated by
+   subtracting the $vars.field_descs.work_time from the 
+   ${vars.field_descs.estimated_time}.",
+
+rep_platform => 
+  "The hardware platform the $terms.bug was observed on.",
+
+reporter =>
+  "The person who filed this ${terms.bug}.",
+
+resolution =>
+  "If $terms.abug is in a resolved state, then one of these reasons"
+  _ " will be given for its resolution.",
+
+see_also =>
+  "This allows you to refer to $terms.bugs in other installations.
+   You can enter a URL to $terms.abug in the 'Add $terms.Bug URLs'
+   field to note that that $terms.bug is related to this one. You can
+   enter multiple URLs at once by separating them with a comma.
+
+   <p>You should normally use this field to refer to $terms.bugs in
+     <em>other</em> installations. For $terms.bugs in this
+     installation, it is better to use the $vars.field_descs.dependson and 
+     $vars.field_descs.blocked fields.</p>",
+
+short_desc =>
+  "The $terms.bug summary is a short sentence which succinctly"
+  _ " describes what the $terms.bug is about.",
+
+status_whiteboard =>
+  "Each $terms.bug has a free-form single line text entry box for"
+  _ " adding tags and status information.",
+
+tag =>
+  "Unlike ${vars.field_descs.keywords} which are global and visible by
+   all users, ${vars.field_descs.tag} are personal and can only be
+   viewed and edited by their author.
+   Editing them won't send any notification to other users. Use them
+   to tag and keep track of ${terms.bugs}.",
+
+target_milestone =>
+   "The $vars.field_descs.target_milestone field is used to define when the"
+   _ " engineer the $terms.bug is assigned to expects to fix it.",
+
+version =>
+  "The version field defines the version of the software the"
+  _ " $terms.bug was found in.",
+
+votes =>
+  "Some $terms.bugs can be voted for, and you can limit your search to"
+  _ " $terms.bugs with more than a certain number of votes.",
+
+work_time =>
+  "The total amount of time spent on this $terms.bug so far.",
+
+##########################
+# Search-specific fields #
+##########################
+
+chfield =>
+  "You can search for specific types of change - this field defines"
+  _" which field you are interested in changes for.",
+
+# Duplicated to chfieldto below, also.
+chfieldfrom =>
+  "Specify the start and end dates either in YYYY-MM-DD format
+   optionally followed by HH:mm, in 24 hour clock), or in relative
+   dates such as 1h, 2d, 3w, 4m, 5y, which respectively mean one hour,
+   two days, three weeks, four months, or five years ago. 0d is last
+   midnight, and 0h, 0w, 0m, 0y is the beginning of this hour, week,
+   month, or year.",
+
+chfieldvalue =>
+  "The value the field defined above changed to during that time.",
+
+content =>
+  "This is a field available in searches that does a Google-like
+   'full-text' search on the $vars.field_descs.short_desc and
+   $vars.field_descs.longdesc fields.",
+
+# Duplicated to email2 below, also.
+email1 =>
+  "Every $terms.bug has people associated with it in different"
+  _ " roles. Here, you can search on what people are in what role.",
+
+} %]
+
+[% vars.help_html.email2 = vars.help_html.email1 %]
+[% vars.help_html.chfieldto = vars.help_html.chfieldfrom %]
+[% vars.help_html.deadlinefrom = vars.help_html.deadline %]
+[% vars.help_html.deadlineto = vars.help_html.deadline %]
+
+[% help_all_note = BLOCK %]
+  <strong>Note:</strong> When searching, selecting the option "All"
+  only finds [% terms.bugs %] whose value for this field is literally
+  the word "All".
+[% END %]
+[% FOREACH all_field = ['op_sys', 'rep_platform'] %]
+  [% vars.help_html.$all_field = vars.help_html.$all_field _ ' ' _ help_all_note %]
+[% END %]
+
+[% IF Param('useclassification') %]
+  [% vars.help_html.product = vars.help_html.product 
+      _ " Select a Classification to narrow down this list." %]
+[% END %]
+
+[% FOREACH help_field = bug_fields.keys %]
+
+  [%# Add help for custom fields. %]
+  [% IF !vars.help_html.${help_field}.defined %]
+    [% IF bug_fields.${help_field}.long_desc %]
+      [% vars.help_html.${help_field} = bug_fields.${help_field}.long_desc %]
+    [% ELSE %]
+      [% SET field_type = bug_fields.${help_field}.type %]
+      [% field_type_desc = BLOCK -%]
+        [% field_types.$field_type FILTER html %]
+      [%- END %]
+      [% vars.help_html.${help_field} = 
+        "A custom $field_type_desc field in this installation"
+        _ " of ${terms.Bugzilla}." %]
+    [% END %]
+  [% END %]
+
+  [%# Add help for the search types, for query.cgi. %]
+  [% type_desc = BLOCK %]
+    The type of [% vars.field_descs.${help_field} FILTER html %] search you 
+    would like.
+  [% END %]
+  [% SET type_name = help_field _ '_type' %]
+  [% vars.help_html.$type_name = type_desc %]
+[% END %]
+
+[% Hook.process("end") %]

diff --git a/template/en/default/bug/field-label.html.tmpl b/template/en/default/bug/field-label.html.tmpl
new file mode 100644 (file)
index 0000000..95ac28a
--- /dev/null
+++ b/template/en/default/bug/field-label.html.tmpl
@@ -0,0 +1,41 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  #   field: a Bugzilla::Field object
+  #   desc_url: An alternate link to help for the field.
+  #   hidden: True if the field label should start hidden.
+  #   rowspan: a "rowspan" value for the label's <th>.
+  #   tag_name: the tag to use to surround the label
+  #   accesskey: access key for the label
+  #%]
+
+[% DEFAULT tag_name = "th" %]
+<[% tag_name FILTER html %] class="field_label [% ' bz_hidden_field' IF hidden %]
+           [%- ' required' IF field.is_mandatory && NOT bug.id %]"
+    id="field_label_[% field.name FILTER html %]"
+    [% IF rowspan %] rowspan="[% rowspan FILTER html %]"[% END %]>
+
+  [% IF editable %]
+    <label for="[% field.name FILTER html %]"[% IF accesskey %] accesskey="[% accesskey FILTER html %]"[% END %]>
+  [% END %]
+
+  <a 
+    [% IF help_html.${field.name}.defined %]
+      title="[% help_html.${field.name} FILTER txt FILTER collapse FILTER html %]"
+      class="field_help_link"
+    [% END %]
+    [% IF desc_url %]
+      href="[% desc_url FILTER html %]"
+    [% ELSE %]
+      href="page.cgi?id=fields.html#[% field.name FILTER uri %]"
+    [% END %]
+  >[%- field_descs.${field.name} FILTER html %]:</a>
+
+  [% '</label>' IF editable %]
+</[% tag_name FILTER html %]>

diff --git a/template/en/default/bug/field.html.tmpl b/template/en/default/bug/field.html.tmpl
new file mode 100644 (file)
index 0000000..e05bced
--- /dev/null
+++ b/template/en/default/bug/field.html.tmpl
@@ -0,0 +1,242 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  #   field: a Bugzilla::Field object
+  #   value: The value of the field for this bug.
+  #   override_legal_values (optional): The list of legal values, for select fields.
+  #   editable: Whether the field should be displayed as an editable
+  #             <input> or as just the plain text of its value.
+  #   allow_dont_change: display the --do_not_change-- option for select fields.
+  #   value_span: A colspan for the table cell containing
+  #               the field value.
+  #   no_tds: boolean; if true, don't display the label <th> or the 
+  #           wrapping <td> for the field.
+  #   bug (optional): The current Bugzilla::Bug being displayed, or a hash 
+  #                   with default field values being displayed on a page.
+  #%]
+
+[% IF NOT no_tds %]
+  [% field_hidden = 0 %]
+  [% IF bug AND !field.is_visible_on_bug(bug) %]
+    [% field_hidden = 1 %]
+  [% END %]
+
+  [% INCLUDE "bug/field-label.html.tmpl" hidden = field_hidden %]
+  <td class="field_value [% ' bz_hidden_field' IF field_hidden %]"
+      id="field_container_[% field.name FILTER html %]" 
+      [% " colspan=\"$value_span\"" FILTER none IF value_span %]>
+[% END %]
+[% Hook.process('start_field_column') %]
+[% IF editable %]
+  [% SWITCH field.type %]
+    [% CASE constants.FIELD_TYPE_FREETEXT %]
+        <input id="[% field.name FILTER html %]" class="text_input"
+               name="[% field.name FILTER html %]"
+               value="[% value FILTER html %]" size="40"
+               maxlength="[% constants.MAX_FREETEXT_LENGTH FILTER none %]"
+               [% ' aria-required="true"' IF field.is_mandatory %]>
+    [% CASE constants.FIELD_TYPE_DATETIME %]
+      <input name="[% field.name FILTER html %]" size="20"
+             id="[% field.name FILTER html %]"
+             value="[% value FILTER html %]"
+             [% ' aria-required="true"' IF field.is_mandatory %]
+             onchange="updateCalendarFromField(this)">
+      <button type="button" class="calendar_button"
+              id="button_calendar_[% field.name FILTER html %]"
+              onclick="showCalendar('[% field.name FILTER js %]')">
+        <span>Calendar</span>
+      </button>
+
+      <div id="con_calendar_[% field.name FILTER html %]"></div>
+
+      <script type="text/javascript">
+        <!--
+          [%+ PROCESS "global/calendar.js.tmpl" id = field.name %]
+        //--></script>
+    [% CASE constants.FIELD_TYPE_BUG_ID %]
+        <span id="[% field.name FILTER html %]_input_area">
+          <input name="[% field.name FILTER html %]" id="[% field.name FILTER html %]"
+                 value="[% value FILTER html %]" size="7"
+                 [% ' aria-required="true"' IF field.is_mandatory %]>
+
+        </span>
+
+        [% IF value %]  
+          [% value FILTER bug_link(value, use_alias => 1) FILTER none %]
+        [% END %]
+        <span id="[% field.name FILTER html %]_edit_container" class="edit_me bz_default_hidden">
+          (<a href="#" id="[% field.name FILTER html %]_edit_action">edit</a>)
+        </span>
+        <script type="text/javascript">
+        hideEditableField('[% field.name FILTER js %]_edit_container',
+                          '[% field.name FILTER js %]_input_area',
+                          '[% field.name FILTER js %]_edit_action',
+                          '[% field.name FILTER js %]',
+                          "[% value FILTER js %]");
+        </script>
+    [% CASE [ constants.FIELD_TYPE_SINGLE_SELECT 
+              constants.FIELD_TYPE_MULTI_SELECT ] %]
+        <input type="hidden" id="[% field.name FILTER html %]_dirty">
+        <select id="[% field.name FILTER html %]" 
+                name="[% field.name FILTER html %]" 
+                [% IF field.type == constants.FIELD_TYPE_MULTI_SELECT %]
+                    [% SET field_size = 5 %]
+                    [% IF field.legal_values.size < 5 %]
+                        [% SET field_size = field.legal_values.size %]
+                    [% END %]
+                    size="[% field_size FILTER html %]" multiple="multiple"
+                    [% ' aria-required="true"' IF field.is_mandatory %]
+                [% END %]
+                >
+          [% IF allow_dont_change %]
+            <option value="[% dontchange FILTER html %]"
+                   [% ' selected="selected"' IF value == dontchange %]>
+              [% dontchange FILTER html %]
+            </option>
+          [% END %]
+          [% IF override_legal_values %]
+            [% legal_values = override_legal_values %]
+          [% ELSE %]
+            [% legal_values = field.legal_values %]
+          [% END %]
+          [% FOREACH legal_value = legal_values %]
+            [% NEXT IF NOT legal_value.is_active AND NOT value.contains(legal_value.name).size %]
+            <option value="[% legal_value.name FILTER html %]"
+                    id="v[% legal_value.id FILTER html %]_
+                        [%- field.name FILTER html %]"
+              [%# We always show selected values, even if they should be
+                # hidden %]
+              [% IF value.contains(legal_value.name).size %]
+                selected="selected"
+              [% ELSIF bug AND !legal_value.is_visible_on_bug(bug) %]
+                class="bz_hidden_option" disabled="disabled"
+              [% END %]>
+              [%- display_value(field.name, legal_value.name) FILTER html ~%]
+            </option>
+          [% END %]
+        </select>
+        [%# When you pass an empty multi-select in the web interface,
+          # it doesn't appear at all in the CGI object. Instead of
+          # forcing all users of process_bug to always specify every
+          # multi-select, we have this field defined if the multi-select
+          # field is defined, and then if this is passed but the multi-select
+          # isn't, we know that the multi-select was emptied.
+        %]
+        [% IF field.type == constants.FIELD_TYPE_MULTI_SELECT %]
+          <input type="hidden" name="defined_[% field.name FILTER html %]">
+        [% END %]
+
+        <script type="text/javascript">
+        <!--
+          initHidingOptionsForIE('[% field.name FILTER js %]');
+          [%+ INCLUDE "bug/field-events.js.tmpl"
+                      field = field, product = bug.product_obj %]
+        //-->
+        </script>
+
+     [% CASE constants.FIELD_TYPE_TEXTAREA %]
+       [% INCLUDE global/textarea.html.tmpl
+           id = field.name name = field.name minrows = 4 maxrows = 8
+           cols = 60 defaultcontent = value mandatory = field.is_mandatory %]
+     [% CASE constants.FIELD_TYPE_BUG_URLS %]
+       [% '<ul class="bug_urls">' IF value.size %]
+       [% FOREACH bug_url = value %]
+         <li>
+           [% PROCESS bug_url_link bug_url = bug_url %]
+           <label><input type="checkbox" value="[% bug_url.name FILTER html %]"
+                         name="remove_[% field.name FILTER html %]">
+             Remove</label>
+         </li>
+       [% END %]
+       [% '</ul>' IF value.size %]
+
+       [% IF Param('use_see_also') %]
+         <span id="container_showhide_[% field.name FILTER html %]"
+               class="bz_default_hidden">
+           (<a href="#" id="showhide_[% field.name FILTER html %]">add</a>)
+         </span>
+         <div id="container_[% field.name FILTER html %]">
+           <label for="[% field.name FILTER html %]">
+             <strong>Add [% terms.Bug %] URLs:</strong>
+           </label><br>
+           <input type="text" id="[% field.name FILTER html %]" size="40"
+                  class="text_input" name="[% field.name FILTER html %]">
+         </div>
+         <script type="text/javascript">
+             setupEditLink('[% field.name FILTER js %]');
+         </script>
+       [% END %]
+     [% CASE constants.FIELD_TYPE_KEYWORDS %]
+       <div id="[% field.name FILTER html %]_container">
+         <input type="text" id="[% field.name FILTER html %]" size="40"
+                class="text_input" name="[% field.name FILTER html %]"
+                value="[% value FILTER html %]">
+         <div id="[% field.name FILTER html %]_autocomplete"></div>
+       </div>
+       <script type="text/javascript" defer="defer">
+         if (typeof YAHOO.bugzilla.field_array === "undefined")
+           YAHOO.bugzilla.field_array = [];
+         YAHOO.bugzilla.field_array["[% field.name FILTER js %]"] = [
+           [%- FOREACH val = possible_values %]
+             [%-# %]"[% val FILTER js %]"
+             [%- "," IF NOT loop.last %][% END %]];
+         YAHOO.bugzilla.fieldAutocomplete.init('[% field.name FILTER js %]',
+                                               '[% field.name FILTER js %]_autocomplete');
+       </script>
+  [% END %]
+[% ELSE %]
+  [% SWITCH field.type %]
+    [% CASE constants.FIELD_TYPE_TEXTAREA %]
+      <div class="uneditable_textarea">[% value FILTER html %]</div>
+    [% CASE constants.FIELD_TYPE_BUG_ID %]
+      [% IF value %]  
+          [% value FILTER bug_link(value, use_alias => 1) FILTER none %]
+      [% END %]
+    [% CASE [ constants.FIELD_TYPE_SINGLE_SELECT 
+              constants.FIELD_TYPE_MULTI_SELECT ] %]
+      [% FOREACH val = value %]
+        [% display_value(field.name, val) FILTER html %]
+        [% ', ' UNLESS loop.last() %]
+      [% END %]
+    [% CASE constants.FIELD_TYPE_BUG_URLS %]
+      [% '<ul class="bug_urls">' IF value.size %]
+        [% FOREACH bug_url = value %]
+          <li>
+            [% PROCESS bug_url_link bug_url = bug_url %]
+          </li>
+        [% END %]
+      [% '</ul>' IF value.size %]
+    [% CASE %]
+      [% value.join(', ') FILTER html %]
+  [% END %]
+[% END %]
+[% Hook.process('end_field_column') %]
+[% '</td>' IF NOT no_tds %]
+
+[%# for reverse relationships, we show this pseudo-field after the main field %]
+[% IF bug.id && field.is_relationship %]
+    [% extra_field_item = {} %]
+    [% extra_field_item.header = field.reverse_desc _ ":" FILTER html %]
+    [% extra_field_item.data = BLOCK %]
+        [% FOREACH depbug = bug.related_bugs(field) %]
+            [% depbug.id FILTER bug_link(depbug, use_alias => 1) FILTER none %][% " " %]
+        [% END %]
+    [% END %]
+[% ELSE %]
+    [% extra_field_item = '' %]
+[% END %]
+
+[% BLOCK bug_url_link %]
+  [% IF bug_url.isa('Bugzilla::BugUrl::Bugzilla::Local') %]
+    [% bug_url.target_bug_id FILTER bug_link(bug_url.target_bug_id, use_alias => 1) FILTER none %]
+  [% ELSE %]
+    <a href="[% bug_url.name FILTER html %]">
+      [% bug_url.name FILTER html %]</a>
+  [% END %]
+[% END %]

diff --git a/template/en/default/bug/format_comment.txt.tmpl b/template/en/default/bug/format_comment.txt.tmpl
new file mode 100644 (file)
index 0000000..b8d6742
--- /dev/null
+++ b/template/en/default/bug/format_comment.txt.tmpl
@@ -0,0 +1,48 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# NOTE: Everywhere you use this template, you must call 
+  # "FILTER remove('^X')" on the result. This is unfortunately the only way
+  # to preserve leading whitespace in comments.
+  #%]
+
+[%# INTERFACE:
+  #   comment: A Bugzilla::Comment object.
+  #   is_bugmail: boolean; True if this comment is going into a plain-text
+  #               bugmail.
+  #%]
+
+[%# Please don't use field-descs here. It can slow down Bugzilla. %]
+
+[% SET comment_body = comment.body %]
+
+[% IF comment.type == constants.CMT_DUPE_OF %]
+X[% comment_body %]
+
+*** This [% terms.bug %] has been marked as a duplicate of [% terms.bug %] [%+ comment.extra_data %] ***
+[% ELSIF comment.type == constants.CMT_HAS_DUPE %]
+*** [% terms.Bug %] [%+ comment.extra_data %] has been marked as a duplicate of this [% terms.bug %]. ***
+[% ELSIF comment.type == constants.CMT_ATTACHMENT_CREATED %]
+Created attachment [% comment.extra_data %]
+[% IF is_bugmail %]
+  --> [% urlbase _ "attachment.cgi?id=" _ comment.extra_data _ "&action=edit" %]
+[% END %]
+[%+ comment.attachment.description %]
+
+[%+ comment.body %]
+[% ELSIF comment.type == constants.CMT_ATTACHMENT_UPDATED %]
+Comment on attachment [% comment.extra_data %]
+[% IF is_bugmail %]
+  --> [% urlbase _ "attachment.cgi?id=" _ comment.extra_data %]
+[% END %]
+[%+ comment.attachment.description %]
+
+[%+ comment.body %]
+[% ELSE %]
+X[% Hook.process('type') %]
+[% END %]

diff --git a/template/en/default/bug/knob.html.tmpl b/template/en/default/bug/knob.html.tmpl
new file mode 100644 (file)
index 0000000..7046472
--- /dev/null
+++ b/template/en/default/bug/knob.html.tmpl
@@ -0,0 +1,84 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+<div id="status">
+  [% PROCESS bug/field.html.tmpl
+      no_tds = 1
+      field  = bug_fields.bug_status
+      value  = bug.bug_status
+      override_legal_values = bug.choices.bug_status
+      editable = bug.choices.bug_status.size > 1
+  %]
+
+  [% IF bug.resolution 
+        OR bug.check_can_change_field('resolution', bug.resolution, 1)
+  %]
+    <noscript><br>resolved&nbsp;as&nbsp;</noscript>
+  [% END %]
+
+  <span id="resolution_settings">
+  [% PROCESS bug/field.html.tmpl
+      no_tds = 1
+      field  = bug_fields.resolution
+      value  = bug.resolution
+      override_legal_values = bug.choices.resolution
+      editable = bug.check_can_change_field('resolution', bug.resolution, 1)
+  %]
+  </span>
+
+  [% IF bug.check_can_change_field('dup_id', 0, 1) %]
+    <noscript><br> duplicate</noscript>
+    <span id="duplicate_settings">of
+      <span id="dup_id_container" class="bz_default_hidden">
+        [% "${terms.bug} ${bug.dup_id}" FILTER bug_link(bug.dup_id) FILTER none %]
+        (<a href="#" id="dup_id_edit_action">edit</a>)
+      </span
+      ><input id="dup_id" name="dup_id" size="6"
+              value="[% bug.dup_id FILTER html %]">
+    </span>
+    [% IF bug.dup_id %]
+        <noscript>[% bug.dup_id FILTER bug_link(bug.dup_id) FILTER none %]</noscript>
+    [% END %]
+    <div id="dup_id_discoverable" class="bz_default_hidden">
+      <a href="#" id="dup_id_discoverable_action">Mark as Duplicate</a>
+    </div>
+  [% ELSIF bug.dup_id %]
+    <noscript><br> duplicate</noscript>
+    <span id="duplicate_display">of 
+      [% "${terms.bug} ${bug.dup_id}" FILTER bug_link(bug.dup_id) FILTER none %]</span>
+  [% END %]
+</div>
+
+<script type="text/javascript">
+  var close_status_array = [
+    [% FOREACH status = bug.choices.bug_status %]
+      [% NEXT IF status.is_open %]
+      '[% status.name FILTER js %]'[% ',' UNLESS loop.last %]
+    [% END %]
+  ];
+  YAHOO.util.Dom.removeClass('dup_id_discoverable', 'bz_default_hidden');
+  hideEditableField( "dup_id_container", "dup_id", 'dup_id_edit_action',
+                     'dup_id', '[% bug.dup_id FILTER js %]' )
+  showHideStatusItems( "",  ['[% "is_duplicate" IF bug.dup_id %]',
+                             '[% bug.bug_status FILTER js %]']);
+  YAHOO.util.Event.addListener( 'bug_status', "change", showHideStatusItems,
+                                ['[% "is_duplicate" IF bug.dup_id %]',
+                                 '[% bug.bug_status FILTER js %]']);
+  YAHOO.util.Event.addListener( 'resolution', "change", showDuplicateItem);
+  YAHOO.util.Event.addListener( 'dup_id_discoverable_action',
+                                'click',
+                                setResolutionToDuplicate,
+                                '[% Param('duplicate_or_move_bug_status')
+                                                                FILTER js %]');
+  YAHOO.util.Event.addListener( window, 'load',  showHideStatusItems,
+                              ['[% "is_duplicate" IF bug.dup_id %]',
+                               '[% bug.bug_status FILTER js %]'] );
+
+  [% INCLUDE "bug/field-events.js.tmpl" field = select_fields.bug_status %]
+  [% INCLUDE "bug/field-events.js.tmpl" field = select_fields.resolution %]
+</script>

diff --git a/template/en/default/bug/link.html.tmpl b/template/en/default/bug/link.html.tmpl
new file mode 100644 (file)
index 0000000..40031e1
--- /dev/null
+++ b/template/en/default/bug/link.html.tmpl
@@ -0,0 +1,51 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  #   bug: a Bugzilla::Bug object
+  #   link_text: the text that we're highlighting.
+  #   use_alias: boolean; If true, we display the bug's alias as the link
+  #              text instead of link_text.
+  #   comment_num: If defined, make this a link to that comment on the bug.
+  #   full_url: boolean; If true, generate links that include the full
+  #             urlbase. (This is for emails, mostly.)
+  #%]
+
+[% IF !bug %]
+  <missing>
+  [% RETURN %]
+[% END %]
+
+[%# We use "FILTER none" here because link_title is filtered down below. %]
+[% link_title = BLOCK %]
+  [% display_value('bug_status', bug.bug_status) FILTER none %]
+  [% IF bug.resolution %]
+    [%+ display_value('resolution', bug.resolution) FILTER none %]
+  [% END %]
+[% END %]
+
+[% IF user.can_see_bug(bug) %]
+  [% link_title = link_title _ ' - ' _ bug.short_desc %]
+
+  [% IF use_alias && bug.alias %]
+    [% link_text = bug.alias %]
+  [% END %]
+[% END %]
+
+[% SET anchor = '' %]
+[% IF comment_num.defined %]
+  [% anchor = "#c$comment_num" %]
+[% END %]
+
+<a class="bz_bug_link 
+          bz_status_[% bug.bug_status FILTER css_class_quote %] 
+          [% ' bz_closed' IF !bug.isopened %]"
+   title="[% link_title FILTER collapse FILTER html %]"
+   href="[% urlbase FILTER html IF full_url %]show_bug.cgi?id=
+         [%~ bug.id FILTER uri %][% anchor FILTER html %]">
+  [%~ link_text FILTER html %]</a>

diff --git a/template/en/default/bug/navigate.html.tmpl b/template/en/default/bug/navigate.html.tmpl
new file mode 100644 (file)
index 0000000..22d8c47
--- /dev/null
+++ b/template/en/default/bug/navigate.html.tmpl
@@ -0,0 +1,73 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% RETURN IF !bug %]
+
+[% IF bottom_navigator == 1 %]
+  <ul class="related_actions">
+    <li><a href="show_bug.cgi?format=multiple&amp;id=
+                [% bug.bug_id FILTER uri %]">Format For Printing</a></li>
+    <li>&nbsp;-&nbsp;<a href="show_bug.cgi?ctype=xml&amp;id=
+                        [% bug.bug_id  FILTER uri %]">XML</a></li>
+    <li>&nbsp;-&nbsp;<a href="enter_bug.cgi?cloned_bug_id=
+                        [% bug.bug_id  FILTER uri %]">Clone This 
+                        [% terms.Bug %]</a></li>
+    [%# Links to more things users can do with this bug. %]
+    [% Hook.process("links") %]
+    <li>&nbsp;-&nbsp;<a href="#">Top of page </a></li>
+    </ul>
+[% END %]        
+
+
+<div class="navigation">
+[% SET my_search = user.recent_search_for(bug) %]
+[% IF my_search %]
+  [% SET last_bug_list = my_search.bug_list %]
+  [% SET this_bug_idx = lsearch(last_bug_list, bug.id) %]
+  <b>[% terms.Bug %] List:</b>
+
+  ([% this_bug_idx + 1 %] of [% last_bug_list.size %])
+
+  <a href="show_bug.cgi?id=
+           [%- last_bug_list.first FILTER uri %]&amp;list_id=
+           [%- my_search.id FILTER uri %]">First</a>
+  <a href="show_bug.cgi?id=
+           [%- last_bug_list.last FILTER uri %]&amp;list_id=
+           [%- my_search.id FILTER uri %]">Last</a>
+
+  [% IF this_bug_idx > 0 %]
+    [% prev_bug = this_bug_idx - 1 %]
+    <a href="show_bug.cgi?id=
+             [%- last_bug_list.$prev_bug FILTER uri %]&amp;list_id=
+             [%- my_search.id FILTER uri %]">Prev</a>
+  [% ELSE %]
+    <i><font color="#777777">Prev</font></i>
+  [% END %]
+
+  [% IF this_bug_idx + 1 < last_bug_list.size %]
+    [% next_bug = this_bug_idx + 1 %]
+    <a href="show_bug.cgi?id=
+             [%- last_bug_list.$next_bug FILTER uri %]&amp;list_id=
+             [%- my_search.id FILTER uri %]">Next</a>
+  [% ELSE %]
+    <i><font color="#777777">Next</font></i>
+  [% END %]
+
+  &nbsp;&nbsp;<a href="buglist.cgi?regetlastlist=
+              [%- my_search.id FILTER uri %]">Show last search results</a>
+[% ELSE %]
+  [%# With no list, don't show link to search results %]
+  <i><font color="#777777">First</font></i>
+  <i><font color="#777777">Last</font></i>
+  <i><font color="#777777">Prev</font></i>
+  <i><font color="#777777">Next</font></i>
+  &nbsp;&nbsp;
+  <i><font color="#777777">This [% terms.bug %] is not in your last
+    search results.</font></i>
+[% END %]
+</div>

diff --git a/template/en/default/bug/process/bugmail.html.tmpl b/template/en/default/bug/process/bugmail.html.tmpl
new file mode 100644 (file)
index 0000000..b1c38da
--- /dev/null
+++ b/template/en/default/bug/process/bugmail.html.tmpl
@@ -0,0 +1,45 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # mailing_bugid: The bug ID that email is being sent for.
+  # sent_bugmail: The results of Bugzilla::BugMail::Send().
+  #%]
+
+<dl>
+[% PROCESS emails
+   description = "Email sent to"
+   names = sent_bugmail.sent
+%]
+
+[% PROCESS emails
+   description = "Excluding"
+   names = sent_bugmail.excluded
+%]
+</dl>
+
+[%############################################################################%]
+[%# Block for a set of email addresses                                       #%]
+[%############################################################################%]
+
+[% BLOCK emails %]
+  <dt>[% description FILTER html %]:</dt>
+  <dd>
+  [% IF user.can_see_bug(mailing_bugid) %]
+    [% IF names.size > 0 %]
+      [%+ FOREACH name = names %]
+        <code>[% name FILTER html %]</code>[% ", " UNLESS loop.last() %]
+      [% END %]
+    [% ELSE %]
+      no one
+    [% END %]
+  [% ELSE %]
+    (list of e-mails not available)
+  [% END %]
+  </dd>
+[% END %]

diff --git a/template/en/default/bug/process/confirm-duplicate.html.tmpl b/template/en/default/bug/process/confirm-duplicate.html.tmpl
new file mode 100644 (file)
index 0000000..da1580e
--- /dev/null
+++ b/template/en/default/bug/process/confirm-duplicate.html.tmpl
@@ -0,0 +1,62 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # original_bug_id: number; the bug number for the bug
+  #   against which a bug is being duped
+  # duplicate_bug_id: number; the bug number for the bug
+  #   being duped
+  # cclist_accessible: boolean; whether or not users on the cc: list
+  #   of the original bug can access that bug.
+  #%]
+
+[% PROCESS global/header.html.tmpl title="Duplicate Warning" %]
+[% orig_bug = "$terms.bug $original_bug_id"
+     FILTER bug_link(original_bug_id) %]
+
+<p>
+  When marking [% terms.abug %] as a duplicate, the reporter of the duplicate
+  is normally added to the CC list of the original. The permissions
+  on [% orig_bug FILTER none %] (the original) are currently set
+  such that the reporter would not normally be able to see it.
+</p>
+
+<p>
+  <b>Adding the reporter to the CC list of [% orig_bug FILTER none %]
+  [% IF cclist_accessible %]
+    will immediately
+  [% ELSE %]
+    might, in the future,
+  [% END %]
+  allow him/her access to view this [% terms.bug %].</b>
+  Do you wish to do this?
+</p>
+
+<form method="post" action="process_bug.cgi">
+
+[% PROCESS "global/hidden-fields.html.tmpl" exclude="^Bugzilla_(login|password)$" %]
+
+<p>
+  <input type="radio" name="confirm_add_duplicate" value="1">
+    Yes, add the reporter to CC list on [% orig_bug FILTER none %]
+</p>
+<p>
+  <input type="radio" name="confirm_add_duplicate" value="0" checked="checked">
+    No, do not add the reporter to CC list on [% orig_bug FILTER none %]
+</p>
+<p>
+  [% "Throw away my changes, and revisit $terms.bug $duplicate_bug_id"
+     FILTER bug_link(duplicate_bug_id) FILTER none %]
+</p>
+<p>
+  <input type="submit" id="process" value="Submit">
+</p>
+
+</form>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/bug/process/header.html.tmpl b/template/en/default/bug/process/header.html.tmpl
new file mode 100644 (file)
index 0000000..f7f61a7
--- /dev/null
+++ b/template/en/default/bug/process/header.html.tmpl
@@ -0,0 +1,32 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # As global/header.html.tmpl.
+  #%]
+
+[% USE Bugzilla %]
+
+[% PROCESS "bug/show-header.html.tmpl" %]
+
+[% IF    title_tag == "bug_processed" %]
+  [% title = BLOCK %]
+    [% IF Bugzilla.cgi.param('id') %]
+      [% terms.Bug %] [%+ id FILTER html %]
+    [% ELSE %]
+      [% terms.Bugs %]
+    [% END %]
+    processed
+  [% END %]
+[% ELSIF title_tag == "mid_air" %]
+  [% title = "Mid-air collision!" %]
+[% END %]
+
+[% Hook.process('title') %]
+
+[% PROCESS global/header.html.tmpl %]

diff --git a/template/en/default/bug/process/midair.html.tmpl b/template/en/default/bug/process/midair.html.tmpl
new file mode 100644 (file)
index 0000000..684b996
--- /dev/null
+++ b/template/en/default/bug/process/midair.html.tmpl
@@ -0,0 +1,97 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # operations: array; bug activity since the user last displayed the bug form,
+  #   used by bug/activity/table.html.tmpl to display recent changes that will
+  #   be overwritten if the user submits these changes.  See that template
+  #   for further documentation.
+  # start_at: number; the comment at which show/comments.tmpl should begin
+  #   displaying comments, either the index of the last comment (if the user
+  #   entered a comment along with their change) or a number less than that
+  #   (if they didn't), in which case no comments are displayed.
+  # comments: array; all the comments on the bug.
+  # bug: Bugzilla::Bug; the bug being changed.
+  #%]
+
+[%# The global Bugzilla->cgi object is used to obtain form variable values. %]
+[% USE Bugzilla %]
+[% cgi = Bugzilla.cgi %]
+
+[% UNLESS header_done %]
+  [% PROCESS bug/process/header.html.tmpl %]
+[% END %]
+
+<h1>Mid-air collision detected!</h1>
+
+<p>
+  Someone else has made changes to
+  [%+ "$terms.bug $bug.id" FILTER bug_link(bug) FILTER none %]
+  at the same time you were trying to.
+  The changes made were:
+</p>
+
+<p>
+  [% PROCESS "bug/activity/table.html.tmpl" incomplete_data=0 %]
+</p>
+
+[% IF comments.size > start_at %]
+<p>
+  Added the comment(s):
+  <blockquote>
+    [% PROCESS "bug/comments.html.tmpl" %]
+  </blockquote>
+</p>
+[% END %]
+
+[% IF cgi.param("comment") %]
+<p>
+  Your comment was:<br>
+  <blockquote><pre class="bz_comment_text">
+    [% cgi.param("comment") FILTER html %]
+  </pre></blockquote>
+</p>
+[% END %]
+
+<p>
+You have the following choices:
+</p>
+
+<ul>
+  <li>
+    <form method="post" action="process_bug.cgi">
+      <input type="hidden" name="delta_ts" 
+             value="[% bug.delta_ts FILTER html %]">
+      [% PROCESS "global/hidden-fields.html.tmpl" 
+          exclude="^Bugzilla_login|Bugzilla_password|delta_ts$" %]
+      <input type="submit" id="process" value="Submit my changes anyway">
+        This will cause all of the above changes to be overwritten
+        [% ", except for the added comment(s)" IF comments.size > start_at %].
+    </form>
+  </li>
+  [% IF cgi.param("comment") %]
+    <li>
+      <form method="post" action="process_bug.cgi">
+        <input type="hidden" name="id" value="[% cgi.param("id") FILTER html %]">
+        <input type="hidden" name="delta_ts" value="[% bug.delta_ts FILTER html %]">
+        <input type="hidden" name="comment" value="[% cgi.param("comment") FILTER html %]">
+        <input type="hidden" name="comment_is_private"
+               value="[% cgi.param("comment_is_private") FILTER html %]">
+        <input type="hidden" name="longdesclength" value="[% bug.comments.size %]">
+        <input type="hidden" name="token" value="[% cgi.param("token") FILTER html %]">
+        <input type="submit" id="process_comment" value="Submit only my new comment">
+      </form>
+    </li>
+  [% END %]
+  <li>
+    Throw away my changes, and
+    [%+ "revisit $terms.bug $bug.id" FILTER bug_link(bug) FILTER none %]
+  </li>
+</ul>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/bug/process/results.html.tmpl b/template/en/default/bug/process/results.html.tmpl
new file mode 100644 (file)
index 0000000..cdebfed
--- /dev/null
+++ b/template/en/default/bug/process/results.html.tmpl
@@ -0,0 +1,45 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # id: number; the ID of the bug that was changed/checked.
+  #
+  # type: string; the type of change/check that was made: "bug" when a bug
+  #   is changed, "dupe" when a duplication notation is added to a bug,
+  #   and "dep" when a bug is checked for changes to its dependencies.
+  #%]
+
+[% UNLESS header_done %]
+  [% PROCESS bug/process/header.html.tmpl %]
+[% END %]
+
+[% DEFAULT type="bug" %]
+
+[% Link = BLOCK %][% "$terms.Bug $id" FILTER bug_link(id) %][% END %]
+[% link = BLOCK %][% "$terms.bug $id" FILTER bug_link(id) %][% END %]
+
+[%
+  title = {
+    'bug' => "Changes submitted for $link" ,
+    'dupe' => "Duplicate notation added to $link" ,
+    'dep' => "Checking for dependency changes on $link" ,
+    'created' => "$Link has been added to the database" ,
+    'move' => "$Link has been moved to another database" ,
+  }
+%]
+
+[% Hook.process('title') %]
+
+<dl>
+  <dt>[% title.$type %]</dt>
+  <dd>
+    [% PROCESS "bug/process/bugmail.html.tmpl" mailing_bugid = id %]
+    [%# Links to more information about the changed bug. %]
+    [% Hook.process("links") %]
+  </dd>
+</dl>

diff --git a/template/en/default/bug/process/verify-new-product.html.tmpl b/template/en/default/bug/process/verify-new-product.html.tmpl
new file mode 100644 (file)
index 0000000..77471cb
--- /dev/null
+++ b/template/en/default/bug/process/verify-new-product.html.tmpl
@@ -0,0 +1,191 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # product: object; the new product.
+  # versions: array; versions for the new product.
+  # components: array; components for the new product.
+  # milestones: array; milestones for the new product.
+  # defaults: hash; keys are names of fields, values are defaults for
+  #   those fields
+  #
+  # verify_bug_groups: If groups need to be confirmed in addition to fields.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = 'Verify New Product Details...' %]
+
+<form action="process_bug.cgi" method="post">
+
+[% SET exclude_items = ['version', 'component', 'target_milestone'] %]
+[% IF verify_bug_groups %]
+  [% exclude_items.push('groups', 'defined_groups') %]
+[% END %]
+[% Hook.process('exclude') %]
+
+[% PROCESS "global/hidden-fields.html.tmpl"
+     exclude = '^' _ exclude_items.join('|') _ '$' %]
+
+<input type="hidden" name="confirm_product_change" value="1">
+    
+[%# Verify the version, component, and target milestone fields. %]
+<h3>Verify Version, Component
+  [%- ", Target Milestone" 
+      IF Param("usetargetmilestone")
+         && bug.check_can_change_field('target_milestone', 0, 1) %]</h3>
+
+<p>
+[% IF Param("usetargetmilestone") 
+   && bug.check_can_change_field('target_milestone', 0, 1) 
+%]
+  You are moving the [% terms.bug %](s) to the product 
+  <b>[% product.name FILTER html %]</b>,
+  and the version, component, and/or target milestone fields are no longer
+  correct.  Please set the correct version, component, and target milestone now:
+[% ELSE %]
+  You are moving the [% terms.bug %](s) to the product 
+  <b>[% product.name FILTER html %]</b>,
+  and the version and component fields are no longer correct.
+  Please set the correct version and component now:
+[% END %]
+</p>
+
+<table>
+  <tr>
+    <td>
+      <b>Version:</b><br>
+      [% IF versions.size == 1 %]
+        [% SET default_version = versions.0 %]
+      [% ELSE %]
+        [% SET default_version = defaults.version %]
+      [% END %]
+      [% PROCESS "global/select-menu.html.tmpl" 
+                 name="version"
+                 options=versions
+                 default=default_version
+                 size=10 %]
+    </td>
+    <td>
+      <b>Component:</b><br>
+      [% IF components.size == 1 %]
+        [% SET default_component = components.0 %]
+      [% ELSE %]
+        [% SET default_component = defaults.component %]
+      [% END %]
+      [% PROCESS "global/select-menu.html.tmpl"
+                 name="component"
+                 options=components
+                 default=default_component
+                 size=10 %]
+    </td>
+    [% IF Param("usetargetmilestone") 
+          && bug.check_can_change_field('target_milestone', 0, 1) 
+    %]
+      <td>
+        <b>Target Milestone:</b><br>
+      [% PROCESS "global/select-menu.html.tmpl"
+                 name="target_milestone"
+                 options=milestones
+                 default=defaults.milestone
+                 size=10 %]
+      </td>
+    [% END %]
+    [% Hook.process('field') %]
+  </tr>
+</table>
+
+[% IF verify_bug_groups %]
+  [% mandatory_groups = [] %]
+  [% optional_groups = [] %]
+
+  [% FOREACH gid = product.group_controls.keys %]
+    [% group = product.group_controls.$gid %]
+    [% NEXT UNLESS group.group.is_active %]
+
+    [% IF group.membercontrol == constants.CONTROLMAPMANDATORY
+          || (group.othercontrol ==  constants.CONTROLMAPMANDATORY && !user.in_group(group.group.name)) %]
+      [% mandatory_groups.push(group) %]
+    [% ELSIF (group.membercontrol != constants.CONTROLMAPNA && user.in_group(group.group.name))
+              || group.othercontrol != constants.CONTROLMAPNA %]
+      [% optional_groups.push(group) %]
+    [% END %]
+  [% END %]
+  
+  [% IF old_groups.size || optional_groups.size || mandatory_groups.size %]
+    <h3>Verify [% terms.Bug %] Group</h3>
+  [% END %]
+  
+  [% IF old_groups.size %]
+    <p>These groups are not legal for the '[% product.name FILTER html %]'
+    product or you are not allowed to restrict [% terms.bugs %] to these groups.
+    [%+ terms.Bugs %] will no longer be restricted to these groups and may become
+    public if no other group applies:<br>
+    [% FOREACH group = old_groups %]
+      <input type="checkbox" id="group_[% group.id FILTER html %]"
+             name="groups" disabled="disabled" value="[% group.name FILTER html %]">
+      <label for="group_[% group.id FILTER html %]">
+        [% group.name FILTER html %]: [% group.description FILTER html %]
+      </label>
+      <br>
+    [% END %]
+    </p>
+  [% END %]
+
+
+  [% IF optional_groups.size %]
+    <p>These groups are optional. You can decide to restrict [% terms.bugs %] to
+    one or more of the following groups:<br>
+    [% FOREACH group = optional_groups %]
+      <input type="hidden" name="defined_groups"
+             value="[% group.group.name FILTER html %]">
+      <input type="checkbox" id="group_[% group.group.id FILTER html %]"
+             name="groups"
+             [% ' checked="checked"' IF ((group.membercontrol == constants.CONTROLMAPDEFAULT && user.in_group(group.group.name))
+                 || (group.othercontrol == constants.CONTROLMAPDEFAULT && !user.in_group(group.group.name))
+                 || cgi.param("groups").contains(group.group.name)) %]
+             value="[% group.group.name FILTER html %]">
+      <label for="group_[% group.group.id FILTER html %]">
+        [% group.group.name FILTER html %]: [% group.group.description FILTER html %]
+      </label>
+      <br>
+    [% END %]
+    </p>
+  [% END %]
+
+  [% IF mandatory_groups.size %]
+    <p>These groups are mandatory and [% terms.bugs %] will be automatically
+    restricted to these groups:<br>
+    [% FOREACH group = mandatory_groups %]
+      <input type="checkbox" id="group_[% group.group.id FILTER html %]"
+              checked="checked" disabled="disabled"
+             name="groups" value="[% group.group.name FILTER html %]">
+      <label for="group_[% group.group.id FILTER html %]">
+        [% group.group.name FILTER html %]: [% group.group.description FILTER html %]
+      </label>
+      <br>
+    [% END %]
+    </p>
+  [% END %]
+[% END %]
+
+<input type="submit" id="change_product" value="Commit">
+
+</form>
+<hr>
+
+[%# If 'id' is defined, then we are editing a single bug.
+  # Else we are editing several bugs at once. %]
+
+[% IF cgi.param('id') AND cgi.param('id').match('^\d+$') %]
+  [% id = cgi.param('id') %]
+  Cancel and Return to [% "$terms.bug $id" FILTER bug_link(id) FILTER none %]
+[% ELSE %]
+  Cancel and Return to <a href="buglist.cgi?regetlastlist=1">the last search results</a>
+[% END %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/bug/show-header.html.tmpl b/template/en/default/bug/show-header.html.tmpl
new file mode 100644 (file)
index 0000000..a1eebe0
--- /dev/null
+++ b/template/en/default/bug/show-header.html.tmpl
@@ -0,0 +1,58 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# This template should be called with PROCESS before processing
+  # "global/header.html.tmpl" in any template that is going to load the
+  # bug form. It expects only a "bug" object, and can even manage to get
+  # along without that. Some of these variables are just defaults that will
+  # be overridden by the calling templates.
+  #%]
+
+[% filtered_desc = bug.short_desc FILTER html %]
+[% subheader = filtered_desc %]
+[% filtered_timestamp = bug.delta_ts FILTER time %]
+[% title = "$terms.Bug $bug.bug_id – $filtered_desc" %]
+[% yui = ['autocomplete', 'calendar'] %]
+[% javascript_urls = [ "js/util.js", "js/field.js" ] %]
+[% IF bug.defined %]
+  [% header = "$terms.Bug $bug.bug_id" %]
+  [% header_addl_info = "Last modified: $filtered_timestamp" %]
+  [% unfiltered_title = "$terms.Bug $bug.bug_id – $bug.short_desc" %]
+  [% javascript =  BLOCK %]
+    if (history && history.replaceState) {
+      if(!document.location.href.match(/show_bug\.cgi/)) {
+        history.replaceState( null, 
+                             "[% unfiltered_title FILTER js %]",  
+                             "show_bug.cgi?id=[% bug.bug_id FILTER js %]" );
+        document.title = "[% unfiltered_title FILTER js %]";
+      }
+      if (document.location.href.match(/show_bug\.cgi\?.*list_id=/)) {
+        var href = document.location.href;
+        href = href.replace(/[\?&]+list_id=(\d+|cookie)/, '');
+        history.replaceState(null, "[% unfiltered_title FILTER js %]", href);
+      }
+    }
+    YAHOO.util.Event.onDOMReady(function() {
+      initDirtyFieldTracking();
+    });
+    [% javascript FILTER none %]
+  [% END %]
+[% END %]
+[% style_urls = [ "skins/standard/show_bug.css" ] %]
+[% doc_section = "bug_page.html" %]
+[% bodyclasses = ['bz_bug',
+                  "bz_status_$bug.bug_status",
+                  "bz_product_$bug.product",
+                  "bz_component_$bug.component",
+                  "bz_bug_$bug.bug_id",
+                  ] %]
+[% FOREACH group = bug.groups_in %]
+  [% bodyclasses.push("bz_group_$group.name") %]
+[% END %]
+
+[% Hook.process('end') %]

diff --git a/template/en/default/bug/show-multiple.html.tmpl b/template/en/default/bug/show-multiple.html.tmpl
new file mode 100644 (file)
index 0000000..7207e8c
--- /dev/null
+++ b/template/en/default/bug/show-multiple.html.tmpl
@@ -0,0 +1,366 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = "Full Text $terms.Bug Listing"
+  h1 = ""
+  style_urls = ["skins/standard/show_multiple.css",
+                "skins/standard/buglist.css"]
+  doc_section = "bug_page.html"
+%]
+[% PROCESS bug/time.html.tmpl %]
+[% IF bugs.first %]
+  [% ids = [] %]
+  [% FOREACH bug = bugs %]
+    [% PROCESS bug_display %]
+    [% ids.push(bug.bug_id) UNLESS bug.error %]
+  [% END %]
+  [% IF ids.size > 1 %]
+    <div class="bz_query_buttons">
+      <form method="post" action="buglist.cgi">
+        <input type="hidden" name="bug_id" value="[% ids.join(",") FILTER html %]">
+        <input type="submit" id="short_format" value="Short Format">
+      </form>
+    </div>
+  [% END %]
+[% ELSE %]
+  <p>
+    You'd have more luck if you gave me some [% terms.bug %] numbers.
+  </p>
+[% END %]
+
+
+[% PROCESS global/footer.html.tmpl %]
+
+
+[%###########################################################################%]
+[%# Block for an individual bug                                             #%]
+[%###########################################################################%]
+
+[% BLOCK bug_display %]
+  <h1>
+    [% terms.Bug %] 
+    <a href="show_bug.cgi?id=[% bug.bug_id FILTER html %]">[% bug.bug_id FILTER html %]</a>
+    [% IF bug.alias AND NOT bug.error %]
+      (<a href="show_bug.cgi?id=[% bug.alias FILTER uri %]">
+        [% bug.alias FILTER html %]</a>)
+    [% END %]
+  </h1>
+
+  <table class="bugfields">
+  [% IF bug.error %]
+    <tr>
+      <td class="error">
+        [% IF bug.error == "InvalidBugId" %]
+          '[%+ bug.bug_id FILTER html %]' is not a valid [% terms.bug %] number
+          nor a known [% terms.bug %] alias.
+        [% ELSIF bug.error == "NotPermitted" %]
+          You are not allowed to view this [% terms.bug %].
+        [% ELSIF bug.error == "NotFound" %]
+          This [% terms.bug %] cannot be found.
+        [% ELSE %]
+          [%+ bug.error FILTER html %]
+        [% END %]
+      </td>
+    </tr>
+  [% ELSE %]
+    [%# The rightcell block (also called by the row block) automatically shows
+      # the fields from rightcells %]
+    [% rightcells = ['reporter', 'assigned_to'] %]
+    [% IF Param('useqacontact') %]
+      [% rightcells.push('qa_contact') %]
+    [% END %]
+    [% rightcells.push('') %]
+    [% IF bug.cc %]
+      [% rightcells.push('cc') %]
+    [% END %]
+    [% IF bug.keywords %]
+      [% rightcells.push('keywords') %]
+    [% END %]
+
+    [%# Determine if the bug has a flag %]
+    [% FOREACH type = bug.flag_types %]
+      [% IF type.flags.size %]
+        [% rightcells.push('flags') %]
+        [% LAST %]
+      [% END %]
+    [% END %]
+
+    [% PROCESS row cell = "short_desc" fullrow = 1 %]
+
+    <tr>
+      <th>[% field_descs.product FILTER html %]:</th>
+      <td>
+        [% IF Param("useclassification") && bug.classification_id != 1 %]
+          [[% bug.classification FILTER html %]]&nbsp;
+        [% END %]
+        [% bug.product FILTER html %]
+      </td>
+
+      [% PROCESS rightcell %]
+    </tr>
+
+    [% PROCESS row cell = "component" %]
+
+    <tr>
+      <th>[% field_descs.bug_status  FILTER html %]:</th>
+      <td>
+        [% display_value("bug_status", bug.bug_status) FILTER html %]
+        [%+ display_value("resolution", bug.resolution) FILTER html %]
+      </td>
+
+      [% PROCESS rightcell %]
+    </tr>
+
+    <tr>
+      <th>[% field_descs.bug_severity FILTER html %]:</th>
+      <td class="bz_[% bug.bug_severity FILTER css_class_quote -%]">
+        [% display_value("bug_severity", bug.bug_severity) FILTER html %]
+      </td>
+
+      [% PROCESS rightcell %]
+    </tr>
+
+    <tr>
+      <th>[% field_descs.priority FILTER html %]:</th>
+      <td class="bz_[% bug.priority FILTER css_class_quote -%]">
+        [% bug.priority FILTER html %]
+      </td>
+
+      [% PROCESS rightcell %]
+    </tr>
+
+    [% PROCESS row cell = "version" %]
+    [% PROCESS row cell = "target_milestone"  IF Param('usetargetmilestone') %]
+    [% PROCESS row cell = "rep_platform" %]
+    [% PROCESS row cell = "op_sys"  %]
+
+    [% IF bug.bug_file_loc %]
+      <tr>
+        <th>[% field_descs.bug_file_loc FILTER html %]:</th>
+        <td colspan="3">
+          [% IF is_safe_url(bug.bug_file_loc) %]
+            <a href="[% bug.bug_file_loc FILTER html %]">
+                     [% bug.bug_file_loc FILTER html %]</a>
+          [% ELSE %]
+            [% bug.bug_file_loc FILTER html %]
+          [% END %]
+        </td>
+      </tr>
+    [% END %]
+
+    [% IF bug.see_also.size %]
+      <tr>
+        <th>[% field_descs.see_also FILTER html %]:</th>
+        <td colspan="3">
+          [% FOREACH see_also = bug.see_also %]
+            <a href="[% see_also.name FILTER html %]">[% see_also.name FILTER html %]</a>
+            [% "<br>" IF not loop.last() %]
+          [% END %]
+        </td>
+      </tr>
+    [% END %]
+
+    [% IF Param("usestatuswhiteboard") %]
+      [% PROCESS row cell = "status_whiteboard" fullrow = 1 %]
+    [% END %]
+
+    [% USE Bugzilla %]
+    [% field_counter = 0 %]
+    [% FOREACH field = Bugzilla.active_custom_fields %]
+        [% field_counter = field_counter + 1 %]
+        [%# Odd-numbered fields get an opening <tr> %]
+        [% '<tr>' IF field_counter % 2 %]
+        [% PROCESS bug/field.html.tmpl value=bug.${field.name} editable=0 %]
+        [%# Even-numbered fields get a closing <tr> %]
+        [% '</tr>' IF !(field_counter % 2) %]
+        [% IF extra_field_item %]
+          [% field_counter = field_counter + 1 %]
+          [% '<tr>' IF field_counter % 2 %]
+          <th>[% extra_field_item.header FILTER none %]</th>
+          <td>[% extra_field_item.data FILTER none %]</td>
+          [% '</tr>' IF !(field_counter % 2) %]
+        [% END %]
+    [% END %]
+    [%# And we have to finish the row if we ended on an odd number. %]
+    [% '<th></th><td></td></tr>' IF field_counter % 2 %]
+
+    [% IF (bug.dependson.size || bug.blocked.size) %]
+      [% PROCESS dependencies name = "dependson" %]
+      [% PROCESS dependencies name = "blocked"  %]
+    [% END %]
+
+    [% IF user.is_timetracker %]
+      <tr>
+        <th>Time tracking:</th>
+        <td colspan="3">
+          <table class="timetracking">
+            <tr>
+              <th>[% field_descs.estimated_time FILTER html %]</th>
+              <th>[% field_descs.actual_time FILTER html %]</th>
+              <th>[% field_descs.work_time FILTER html %]</th>
+              <th>[% field_descs.remaining_time FILTER html %]</th>
+              <th>[% field_descs.percentage_complete FILTER html %]</th>
+              <th>Gain</th>
+            </tr>
+            <tr>
+              <td>
+                [% PROCESS formattimeunit time_unit = bug.estimated_time %]
+              </td>
+              <td>
+                [% PROCESS formattimeunit
+                           time_unit=(bug.remaining_time + bug.actual_time) %]
+              </td>
+              <td>[% PROCESS formattimeunit time_unit = bug.actual_time %]</td>
+              <td>
+                [% PROCESS formattimeunit time_unit = bug.remaining_time %]
+              </td>
+              <td>
+                [% PROCESS calculatepercentage act = bug.actual_time
+                                               rem = bug.remaining_time %]
+              </td>
+              <td>
+                [% PROCESS formattimeunit
+                     time_unit=bug.estimated_time - 
+                               (bug.actual_time + bug.remaining_time) %]
+              </td>
+            </tr>
+          </table>
+        </td>
+      </tr>
+      [% PROCESS row cell="deadline" %]
+    [% END %]
+
+    [% IF bug.attachments.size %]
+      <tr>
+        <th>Attachments:</th>
+        <td colspan="3">
+          [% IF bug.show_attachment_flags %]
+            <table>
+              <tr>
+                <th>Description</th>
+                <th>Flags</th>
+              </tr>
+              [% FOREACH attachment = bug.attachments %]
+                <tr>
+                  <td>
+                    <a href="attachment.cgi?id=[% attachment.id %]">
+                      [% attachment.description FILTER html %]
+                    </a>[% "<br>" IF not loop.last() %]
+                  </td>
+                  <td>
+                    [% IF attachment.flags.size == 0 %]
+                      <i>none</i>
+                    [% ELSE %]
+                      [% FOREACH flag = attachment.flags %]
+                        [% flag.setter.nick FILTER html %]:
+                        [%+ flag.type.name FILTER html FILTER no_break %][% flag.status %]
+                        [% IF flag.status == "?" && flag.requestee %]
+                          ([% flag.requestee.nick FILTER html %])
+                        [% END %][% ", " IF not loop.last() %]
+                      [% END %]
+                    [% END %]
+                  </td>
+                </tr>
+              [% END %]
+            </table>
+          [% ELSE %]
+            [% FOREACH attachment = bug.attachments %]
+              <a href="attachment.cgi?id=[% attachment.id %]">
+                [% attachment.description FILTER html %]
+              </a>[% "<br>" IF not loop.last() %]
+            [% END %]
+          [% END %]
+        </td>
+      </tr>
+    [% END %]
+  [% END %]
+  
+  [% Hook.process("last_row", "bug/show-multiple.html.tmpl") %]
+   
+  </table>
+
+
+  <br>
+
+  [% PROCESS bug/comments.html.tmpl
+     comments = bug.comments %]
+
+[% END %]
+
+
+[%###########################################################################%]
+[%# Block for standard table rows                                           #%]
+[%###########################################################################%]
+
+[% BLOCK row %]
+  <tr>
+    <th>[% field_descs.${cell} FILTER html %]:</th>
+    <td[% " colspan=3" IF fullrow %]>[% display_value(cell, bug.${cell}) FILTER html %]</td>
+    [% PROCESS rightcell IF !fullrow %]
+  </tr>
+  [% fullrow = 0 %]
+[% END %]
+
+
+[%############################################################################%]
+[%# Block for dependencies                                                   #%]
+[%############################################################################%]
+
+[% BLOCK dependencies %]
+  <tr>
+    <th>[% terms.Bug %] [%+ field_descs.${name} FILTER html %]:</th>
+    <td>
+      [% FOREACH depbug = bug.${name} %]
+        [% depbug FILTER bug_link(depbug) FILTER none %][% ", " IF not loop.last() %]
+      [% END %]
+    </td>
+
+    [% PROCESS rightcell %]
+  </tr>
+[% END %]
+
+[%############################################################################%]
+[%# Block for cells shown right of the table                                 #%]
+[%############################################################################%]
+
+[% BLOCK rightcell %]
+  [% IF rightcells %]
+    [% name = rightcells.shift %]
+    [% IF name == "cc" %]
+      <th class="rightcell">[% field_descs.cc FILTER html %]:</th>
+      <td>
+        [% FOREACH c = bug.cc %]
+          [% c FILTER email FILTER html %][% ", " IF not loop.last() %]
+        [% END %]
+    [% ELSIF name == "reporter" || name == "assigned_to" 
+             || name == "qa_contact" %]
+      <th class="rightcell">[% field_descs.${name} FILTER html %]:</th>
+      <td>[% bug.${name}.identity FILTER email FILTER html %]</td>
+    [% ELSIF name == "flags" %]
+        <th class="rightcell">Flags:</th>
+        <td>
+          [% FOREACH type = bug.flag_types %]
+            [% FOREACH flag = type.flags %]
+                [% flag.setter.nick FILTER html %]:
+                [%+ flag.type.name FILTER html FILTER no_break %][% flag.status %]
+                [%+ IF flag.status == "?" && flag.requestee %]
+                  ([% flag.requestee.nick FILTER html %])
+                [% END %]<br>
+            [% END %]
+          [% END %]
+        </td>
+    [% ELSIF name != "" %]
+      <th class="rightcell">[% field_descs.${name} FILTER html %]:</th>
+      <td>[% display_value(name, bug.${name}) FILTER html %]</td>
+    [% ELSE %]
+      <td>&nbsp;</td>
+      <td>&nbsp;</td>
+    [% END %]
+  [% END %]
+[% END %]

diff --git a/template/en/default/bug/show.html.tmpl b/template/en/default/bug/show.html.tmpl
new file mode 100644 (file)
index 0000000..b890511
--- /dev/null
+++ b/template/en/default/bug/show.html.tmpl
@@ -0,0 +1,36 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# This script/template only handles one bug #%]
+[% bug = bugs.0 %]
+
+[% IF !header_done %]
+  [% PROCESS "bug/show-header.html.tmpl" %]
+  [% PROCESS global/header.html.tmpl %]
+[% END %]
+
+[% IF nextbug %]
+  <hr>
+  <p>
+    The next [% terms.bug %] in your list is [% terms.bug %]
+    <a href="show_bug.cgi?id=[% bug.bug_id %]">[% bug.bug_id %]</a>:
+  </p>
+  <hr>
+[% END %]
+
+[% PROCESS bug/navigate.html.tmpl %]
+
+[% PROCESS bug/edit.html.tmpl %]
+
+<hr>
+
+[% PROCESS bug/navigate.html.tmpl bottom_navigator => 1%]
+
+<br>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/bug/show.xml.tmpl b/template/en/default/bug/show.xml.tmpl
new file mode 100644 (file)
index 0000000..1d376f8
--- /dev/null
+++ b/template/en/default/bug/show.xml.tmpl
@@ -0,0 +1,161 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[% PROCESS bug/time.html.tmpl %]
+[% USE Bugzilla %]
+[% cgi = Bugzilla.cgi %]
+<?xml version="1.0" [% IF Param('utf8') %]encoding="UTF-8" [% END %]standalone="yes" ?>
+<!DOCTYPE bugzilla [% IF cgi.param('dtd') %][[% PROCESS pages/bugzilla.dtd.tmpl %]][% ELSE %]SYSTEM "[% urlbase FILTER xml %]page.cgi?id=bugzilla.dtd"[% END %]>
+
+<bugzilla version="[% constants.BUGZILLA_VERSION %]"
+          urlbase="[% urlbase FILTER xml %]"
+          [%# Note that the maintainer's email is not filtered, 
+            # intentionally. Even logged-out users should be able
+            # to see that, since it will be in error messages anyway. 
+          %]
+          maintainer="[% Param('maintainer') FILTER xml %]"
+[% IF user.id %]
+          exporter="[% user.email FILTER email FILTER xml %]"
+[% END %]
+>
+
+[% FOREACH bug = bugs %]
+  [% IF bug.error %]
+    <bug error="[% bug.error FILTER xml %]">
+      <bug_id>[% bug.bug_id FILTER xml %]</bug_id>
+    </bug>
+  [% ELSE %]
+    <bug>
+      [% FOREACH field = bug.fields %]
+        [% IF displayfields.$field %]
+          [%+ PROCESS bug_field %]
+        [% END %]
+      [% END %]
+
+      [%# This is here so automated clients can still use process_bug.cgi %]
+      [% IF displayfields.token && user.id %]
+          <token>[% issue_hash_token([bug.id, bug.delta_ts]) FILTER xml %]</token>
+      [% END %]
+
+      [%# Now handle 'special' fields #%]
+      [% IF displayfields.group %]
+        [% FOREACH g = bug.groups %]
+          [% NEXT UNLESS g.ison %]
+          <group id="[% g.bit FILTER xml %]">[% g.name FILTER xml %]</group>
+        [% END %]
+      [% END %]
+
+      [%# Bug Flags %]
+      [% PROCESS section_flags obj => bug %]
+
+      [% IF displayfields.long_desc %]
+          [% sort_order = user.settings.comment_sort_order.value %]
+          <comment_sort_order>[% sort_order FILTER xml %]</comment_sort_order>  
+          
+        [% FOREACH c = bug.comments %]
+          [% PROCESS a_comment %]
+        [% END %]
+      [% END %]
+      
+      [% IF displayfields.attachment %]
+        [% FOREACH a = bug.attachments %]
+          [% NEXT IF a.isprivate && !user.is_insider %]
+          <attachment
+              isobsolete="[% a.isobsolete FILTER xml %]"
+              ispatch="[% a.ispatch FILTER xml %]"
+              isprivate="[% a.isprivate FILTER xml %]"
+          >
+            <attachid>[% a.id %]</attachid>
+            <date>[% a.attached FILTER time("%Y-%m-%d %T %z") FILTER xml %]</date>
+            <delta_ts>[% a.modification_time FILTER time("%Y-%m-%d %T %z") FILTER xml %]</delta_ts>
+            <desc>[% a.description FILTER xml %]</desc>
+            <filename>[% a.filename FILTER xml %]</filename>
+            <type>[% a.contenttype FILTER xml %]</type>
+            <size>[% a.datasize FILTER xml %]</size>
+            <attacher[% IF a.attacher.name != '' %] name="[% a.attacher.name FILTER xml %]"[% END -%]>
+            [% a.attacher.email FILTER email FILTER xml %]</attacher>
+            [%# This is here so automated clients can still use attachment.cgi %]
+            [% IF displayfields.token && user.id %]
+              <token>[% issue_hash_token([a.id, a.modification_time]) FILTER xml %]</token>
+            [% END %]
+            [% IF displayfields.attachmentdata %]
+              <data encoding="base64">[% a.data FILTER base64 %]</data>
+            [% END %]
+
+            [% PROCESS section_flags obj => a %]
+          </attachment>
+        [% END %]
+      [% END %]
+      
+      [% Hook.process("bug_end") %]
+
+    </bug>
+  [% END %]
+[% END %]
+
+</bugzilla>
+
+[% BLOCK bug_field %]
+  [% field_values = bug.$field %]
+  [%# Work around TT bug https://rt.cpan.org/Public/Bug/Display.html?id=9802 %]
+  [% IF bug.$field.size == 1 %]
+    [% field_values = [bug.$field.first] %]
+  [% END %]
+
+  [% FOREACH val = field_values %]
+    [%# We need to handle some fields differently. This should become
+      # nicer once we have custfields, and a type attribute for the fields
+      #%]
+    [% name = '' %]
+    [% IF field == 'reporter' OR field == 'assigned_to' OR
+          field == 'qa_contact' %]
+      [% name = val.name %]
+      [% val = val.email FILTER email %]
+    [% ELSIF field == 'cc' %]
+        [% val = val FILTER email %]
+    [% ELSIF field == 'creation_ts' OR field == 'delta_ts' %]
+      [% val = val FILTER time("%Y-%m-%d %T %z") %]
+    [% ELSIF field == "see_also" %]
+      [% val = val.name %]
+    [% END %]
+    <[% field %][% IF name != '' %] name="[% name FILTER xml %]"[% END -%]>
+      [%- val FILTER xml %]</[% field %]>
+  [% END %]
+[% END %]
+
+[% BLOCK section_flags %]
+  [% RETURN UNLESS displayfields.flag %]
+  
+  [% FOREACH flag = obj.flags %]
+    <flag name="[% flag.type.name FILTER xml %]"
+          id="[% flag.id FILTER xml %]"
+          type_id="[% flag.type_id FILTER xml %]"
+          status="[% flag.status FILTER xml %]"
+          setter="[% flag.setter.email FILTER email FILTER xml %]"
+      [% IF flag.status == "?" && flag.requestee %]
+          requestee="[% flag.requestee.email FILTER email FILTER xml %]"
+      [% END %]
+    />
+  [% END %]
+[% END %]
+
+[% BLOCK a_comment %]
+  [% RETURN IF c.is_private && !user.is_insider %]
+  <long_desc isprivate="[% c.is_private FILTER xml %]" >
+    <commentid>[% c.id FILTER xml %]</commentid>
+    <comment_count>[% c.count FILTER xml %]</comment_count>
+    [% IF c.is_about_attachment %]
+      <attachid>[% c.extra_data FILTER xml %]</attachid>
+    [% END %]
+    <who name="[% c.author.name FILTER xml %]">[% c.author.email FILTER email FILTER xml %]</who>
+    <bug_when>[% c.creation_ts FILTER time("%Y-%m-%d %T %z") FILTER xml %]</bug_when>
+    [% IF user.is_timetracker && (c.work_time - 0 != 0) %]
+      <work_time>[% PROCESS formattimeunit time_unit = c.work_time FILTER xml %]</work_time>
+    [% END %]
+    <thetext>[% c.body_full FILTER xml %]</thetext>
+  </long_desc>
+[% END %]

diff --git a/template/en/default/bug/summarize-time.html.tmpl b/template/en/default/bug/summarize-time.html.tmpl
new file mode 100644 (file)
index 0000000..932a6e3
--- /dev/null
+++ b/template/en/default/bug/summarize-time.html.tmpl
@@ -0,0 +1,341 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% title = "Time Summary " %]
+[% IF do_depends %]
+    [% title = title _ "for " %]
+    [% header = "$terms.Bug $ids.0" FILTER bug_link(ids.0) FILTER none %]
+    [% header = title _ header _ " (and $terms.bugs blocking it)" %]
+    [% title = title _ "$terms.Bug $ids.0" %]
+[% ELSE %]
+    [% title = title _ "($ids.size $terms.bugs selected)" %]
+    [% header = title %]
+[% END %]
+
+[% PROCESS global/header.html.tmpl 
+    title = title 
+    header = header 
+    style_urls = ["skins/standard/summarize-time.css"]
+    doc_section = "timetracking.html"
+    yui = ['calendar']
+    javascript_urls = [ "js/util.js", "js/field.js" ]
+    %]
+
+[% INCLUDE query_form %]
+
+[% IF do_report %]
+
+  [% global.grand_total = 0 global.estimated = 0 global.remaining = 0 %]
+
+  [% FOREACH workdata = part_list %]
+    [%# parts contains date ranges (from, to). %]
+    [% part = parts.shift %]
+    <div align="right">
+      <h4 style="padding-right: 2em; margin: 0;">
+        [% IF part.0 or part.1 %]
+          [% part.0 OR "Up" FILTER html %] to [% part.1 OR "now" FILTER html %]
+        [% ELSE %]
+          Full summary (no period specified)
+        [% END %]
+      </h4>
+    </div>
+    [% IF group_by == "number" %]
+      [% INCLUDE number_report %]
+    [% ELSE %]
+      [% INCLUDE owner_report %]
+    [% END %]
+  [% END %]
+
+  [% IF detailed %]
+    <h4 style="margin: 0">
+      Total of [% global.remaining FILTER format("%.2f") %]h remains from
+      original estimate of [% global.estimated FILTER format("%.2f") %]h
+      [% IF global.deadline %]
+        (deadline [% global.deadline FILTER html %])
+      [% END %]
+    </h4>
+  [% END %]
+
+  [% IF monthly %]
+    <h4 style="margin: 0">Total of [% global.grand_total FILTER format("%.2f") %] hours worked</h4>
+    <hr noshade size="1">
+  [% END %]
+
+  [% IF null.size > 0 %]
+    [% INCLUDE inactive_report %]
+    <h4 style="margin: 0">Total of [% null.size %] inactive [% terms.bugs %]</h4>
+  [% END %]
+
+[% END %]
+
+[% PROCESS global/footer.html.tmpl %]
+
+[%#
+  #
+  # Developer reporting
+  #
+  #%]
+
+[% BLOCK owner_report %]
+    [% global.total = 0 global.bug_count = {} global.owner_count = {} %]
+    <table cellpadding="4" cellspacing="0" width="90%" class="realitems owner">
+        [% FOREACH owner = workdata.keys.sort %]
+            [% INCLUDE do_one_owner owner=owner ownerdata=workdata.$owner
+                                    detailed=detailed %]
+        [% END %]
+
+    [% additional = "$global.owner_count.size developers @
+                     $global.bug_count.size $terms.bugs" %] 
+    [% INCLUDE section_total colspan=3 additional=additional %]
+    </table>
+[% END %]
+
+[% BLOCK do_one_owner %]
+    [% global.owner_count.$owner = 1 %]
+    <tr><td colspan="5" class="owner_header">
+        <b>[% owner FILTER html %]</b>
+    </td></tr>
+    [% col = 0 subtotal = 0%]
+    [% FOREACH bugdata=ownerdata.nsort("bug_id") %]
+        [% bug_id = bugdata.bug_id %]
+        [% INCLUDE calc_bug_total id=bug_id %]
+        [% global.bug_count.$bug_id = 1 %]
+        [% IF detailed %]
+            [% INCLUDE bug_header cid=col id=bug_id bugdata=bugdata extra=1 %]
+            [% col = col + 1 %]
+        [% END %]
+        [% subtotal = subtotal + bugdata.total_time %]
+    [% END %]
+    <tr>
+      <td colspan="4" align="right"><b>Total</b>:</td>
+      <td align="right" class="subtotal" width="100">
+        <b>[% subtotal FILTER format("%.2f") %]</b></td>
+        [% global.total = global.total + subtotal %]
+    </tr>
+[% END %]
+
+[%#
+  #
+  # Bug Number reporting
+  #
+  #%]
+
+[% BLOCK number_report %]
+    [% global.total = 0 global.owner_count = {} global.bug_count = {} %]
+
+    <table cellpadding="4" cellspacing="0" width="90%" class="realitems number">
+    [% FOREACH bug = workdata.keys.nsort %]
+        [% INCLUDE do_one_bug id=bug bugdata=workdata.$bug
+                              detailed=detailed %]
+    [% END %]
+
+    [% additional = "$global.bug_count.size $terms.bugs &
+                     $global.owner_count.size developers" %]
+    [% INCLUDE section_total additional=additional colspan=2 %]
+    </table>
+[% END %]
+
+[% BLOCK do_one_bug %]
+    [% subtotal = 0.00 cid = 0 %]
+    [% INCLUDE calc_bug_total id=id %]
+    [% global.bug_count.$id = 1 %]
+    [% INCLUDE bug_header id=id %]
+
+    [% FOREACH owner = bugdata.sort("login_name") %]
+        [% work_time = owner.total_time %]
+        [% subtotal = subtotal + work_time %]
+        [% login_name = owner.login_name %]
+        [% global.owner_count.$login_name = 1 %]
+        [% IF detailed %] 
+            [% cid = cid + 1 %]
+            <tr class="owner_header[% 2 FILTER none IF cid % 2 %]">
+                <td>&nbsp;</td>
+                <td colspan="2"><b>[% login_name FILTER html %]</b></td>
+                <td align="right">
+                [% work_time FILTER format("%.2f") %]</td>
+            </tr>
+        [% END %]
+    [% END %]
+    <tr>
+      <td colspan="2">&nbsp;</td>
+      <td align="right">
+      <b>Total</b>:
+      </td>
+      <td align="right" class="subtotal" width="100">
+        <b>[% subtotal FILTER format("%.2f") %]</b>
+      </td>
+    </tr>
+    [% global.total = global.total + subtotal %]
+[% END %]
+
+[% BLOCK bug_header %]
+    <tr class="bug_header[% '2' IF cid % 2 %]">
+        <td width="80" valign="top">
+          <b>[% "$terms.Bug $id" FILTER bug_link(id) FILTER none %]</b>
+        </td>
+        <td width="100"><b>[% display_value("bug_status", bugs.$id.bug_status) FILTER html %]</b></td>
+        <td colspan="2">[% bugs.$id.short_desc FILTER html %]</td>
+        [% IF extra %]
+          <td align="right" valign="top">[% bugdata.total_time FILTER html %]</td>
+        [% END %]
+    </tr>
+    [% IF detailed %]
+      <tr class="bug_header[% '2' IF cid % 2 %]">
+        <td>&nbsp;</td>
+        <td colspan="3">
+          <table width="100%" cellpadding="0" cellspacing="0">
+            <tr>
+              <td width="33%">
+                Estimated: [% bugs.$id.estimated_time FILTER format("%.2f") %]h
+              </td>
+              <td width="33%">
+                Remaining: [% bugs.$id.remaining_time FILTER format("%.2f") %]h
+              </td>
+              <td width="33%">
+                Deadline: [% bugs.$id.deadline || "<b>Not set</b>" %]
+              </td>
+            </tr>
+          </table>
+        </td>
+        [% IF extra %]
+          <td>&nbsp;</td>
+        [% END %]
+      </tr>
+   [% END %]
+[% END %]
+
+[% BLOCK calc_bug_total %]
+  [% IF !global.bug_count.$id %]
+    [% global.estimated = global.estimated + bugs.$id.estimated_time %]
+    [% global.remaining = global.remaining + bugs.$id.remaining_time %]
+    [% IF !global.deadline || bugs.$id.deadline &&
+          global.deadline.replace("-", "") < bugs.$id.deadline.replace("-", "") %]
+      [% SET global.deadline = bugs.$id.deadline %]
+    [% END %]
+  [% END %]
+[% END %]
+
+[% BLOCK inactive_report %]
+    <h3>Inactive [% terms.bugs %]</h3>
+    <table cellpadding="4" cellspacing="0" width="90%" class="zeroitems">
+    [% cid = 0 %]
+    [% FOREACH bug_id = null.nsort %]
+        [% INCLUDE bug_header id=bug_id cid=cid %]
+        [% cid = cid + 1 %]
+    [% END %]
+    </table>
+[% END %]
+
+
+[% BLOCK section_total %]
+  [% IF global.total > 0 %]
+    <tr class="section_total">
+      <td><b>Totals</b></td>
+      <td colspan="[% colspan FILTER html %]" align="right"><b>[% additional FILTER html %]</b></td>
+      <td align="right"><b>[% global.total FILTER format("%.2f") %]</b></td>
+    </tr>
+  [% ELSE %]
+    <tr>
+      <td>No time allocated during the specified period.</td>
+    </tr>
+  [% END %]
+  [% global.grand_total = global.grand_total + global.total %]
+[% END %]
+
+[%#
+  #
+  # The query form
+  #
+  #%]
+
+[% BLOCK query_form %]
+<hr noshade size=1>
+<form method="post" name="summary" style="display: inline" action="summarize_time.cgi">
+<input type="hidden" name="do_depends" value="[% do_depends FILTER html %]">
+<input type="hidden" name="id" value="[% ids.join(",") FILTER html %]">
+<input type="hidden" name="do_report" value="1">
+
+[% IF warn_swap_dates %]
+    <h4 style="border: 1px solid red; margin: 1em; padding: 0.5em">The
+    end date specified occurs before the start date, which doesn't
+    make sense; the dates below have therefore been swapped.</h4>
+[% END %]
+
+<table>
+<tr>
+<td align="right">
+  <b><label accesskey="s" 
+             for="start_date">Period <u>s</u>tarting</label></b>: 
+</td><td colspan="3">
+  <input type="text" id="start_date" name="start_date" size="11"
+         align="right" value="[% start_date FILTER html %]" maxlength="10"
+         onchange="updateCalendarFromField(this)">
+  <button type="button" class="calendar_button"
+    id="button_calendar_start_date"
+    onclick="showCalendar('start_date')"><span>Calendar</span>
+  </button>
+  <div id="con_calendar_start_date"></div>
+  &nbsp;
+  <b>and <label accesskey="e" for="end_date"><u>e</u>nding</label></b>: 
+  <input type="text" name="end_date" size="11" id="end_date"
+         align="right" value ="[% end_date FILTER html %]" maxlength="10"
+         onchange="updateCalendarFromField(this)">
+  <button type="button" class="calendar_button"
+    id="button_calendar_end_date"
+    onclick="showCalendar('end_date')"><span>Calendar</span>
+  </button>
+  <div id="con_calendar_end_date"></div>
+</td><td align="right">
+  <input type="submit" id="summarize" value="Summarize">
+</td></tr>
+<tr>
+<td>&nbsp;</td><td colspan="4">
+  <small>(Dates are optional, and in YYYY-MM-DD format)</small>
+</td>
+<tr><td align="right">
+  <b>Group by</b>:
+</td><td colspan="2">
+  <input type="radio" name="group_by" id="number" value="number" [%+
+    'checked="checked"' IF group_by == "number"
+  %]><label 
+  for="number" accesskey="n">[% terms.Bug %] <u>N</u>umber</label>
+  <input type="radio" name="group_by" id="owner" value="owner" [%+
+    'checked="checked"' IF group_by == "owner"
+  %]><label 
+  for="owner" accesskey="d"><u>D</u>eveloper</label>
+</td><td colspan="2">
+  <label for="ctype"><b>Format</b></label>: <select name="ctype" id="ctype">
+    <option value="html">HTML Report</option>
+  </select>
+</td></tr><tr>
+<td>&nbsp;</td><td colspan="4">
+  <input type="checkbox" name="monthly" [% 'checked="checked"' IF
+      monthly %] id="monthly">
+  <label for="monthly" accesskey="m">Split by <u>m</u>onth</label>
+  [%# XXX: allow splitting by other intervals %]
+  &nbsp;
+  <input type="checkbox" name="detailed" [% 'checked="checked"' IF
+      detailed %] id="detailed">
+  <label for="detailed" accesskey="t">De<u>t</u>ailed summaries</label>
+  &nbsp;
+  <input type="checkbox" name="inactive" [% 'checked="checked"' IF
+      inactive %] id="inactive">
+  <label for="inactive" accesskey="i">Also show <u>i</u>nactive
+  [%+ terms.bugs %]</label>
+</td>
+</tr></table>
+
+</form>
+<script type="text/javascript">
+  <!--
+    [%+ PROCESS "global/calendar.js.tmpl" id = 'start_date' %]
+    [% PROCESS "global/calendar.js.tmpl" id = 'end_date' %]
+    document.forms['summary'].start_date.focus();
+  //--></script>
+<hr noshade size=1>
+[% END %]

diff --git a/template/en/default/bug/time.html.tmpl b/template/en/default/bug/time.html.tmpl
new file mode 100644 (file)
index 0000000..370aad6
--- /dev/null
+++ b/template/en/default/bug/time.html.tmpl
@@ -0,0 +1,34 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+                                      
+[% BLOCK formattimeunit %]
+  [%# INTERFACE:
+    # time_unit:  the number converting, converts to 2 decimal places
+    #             unless the last character is a 0, then it truncates to 
+    #             1 decimal place
+    #%]
+  [% time_unit = time_unit FILTER format('%.2f') %]
+  [% IF time_unit.match('0\Z') %]
+    [% time_unit FILTER format('%.1f') %]
+  [% ELSE %]
+    [% time_unit FILTER format('%.2f') %]
+  [% END %]
+[% END %]
+
+[% BLOCK calculatepercentage %]
+  [%# INTERFACE:
+    # act:   actual time  
+    # rem:   remaining time
+    # %]
+  [% IF (act + rem) > 0 %]
+    [% (act / (act + rem)) * 100 
+       FILTER format("%d") %]
+  [% ELSE %]
+    0
+  [% END %]
+[% END %]

diff --git a/template/en/default/config.js.tmpl b/template/en/default/config.js.tmpl
new file mode 100644 (file)
index 0000000..0399f8b
--- /dev/null
+++ b/template/en/default/config.js.tmpl
@@ -0,0 +1,137 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+//
+// This file contains installation specific values for third-party clients.
+//
+// Note: this interface is experimental and under development.
+// We may and probably will make breaking changes to it in the future.
+
+// the global bugzilla url
+var installation = {
+  base_url        : '[% urlbase FILTER js %]',
+  install_version : '[% constants.BUGZILLA_VERSION FILTER js %]',
+  maintainer      : '[% Param('maintainer') FILTER js %]'
+};
+
+
+// Status and Resolution
+// =====================
+var status        = [ [% FOREACH x = status %]'[% x FILTER js %]', [% END %] ];
+var status_open   = [ [% FOREACH x = open_status %]'[% x FILTER js %]', [% END %] ];
+var status_closed = [ [% FOREACH x = closed_status %]'[% x FILTER js %]', [% END %] ];
+var resolution    = [ [% FOREACH x = resolution %]'[% x FILTER js %]', [% END %] ];
+
+
+// Keywords
+// ========
+
+var keyword       = [ [% FOREACH k = keywords %]'[% k.name FILTER js %]', [% END %] ];
+var keyword_descs = [
+[% FOREACH k = keywords %]
+  {
+    name:        '[% k.name FILTER js %]',
+    description: '[% k.description FILTER js %]',
+  },
+[% END %]
+];
+
+// Platforms
+// =========
+
+var platform      = [ [% FOREACH x = platform %]'[% x FILTER js %]', [% END %] ];
+
+
+// Severities
+// ==========
+
+var severity      = [ [% FOREACH x = severity %]'[% x FILTER js %]', [% END %] ];
+
+
+// Custom Fields
+// =============
+
+[% FOREACH cf = custom_fields %]
+var [% cf.name FILTER js %] = [ [% FOREACH x = cf.legal_values %]'[% x.name FILTER js %]', [% END %] ];
+[% END %]
+
+
+// Products and Components
+// =======================
+//
+// It is not necessary to list all products and components here.
+// Instead, you can define a "blacklist" for some commonly used words
+// or word fragments that occur in a product or component name
+// but should _not_ trigger product/component search.
+
+
+// A list of all products and their components, versions, and target milestones:
+  
+var component = new Object();
+var version = new Object();
+var target_milestone = new Object();
+
+[% FOREACH p = products %]
+  component['[% p.name FILTER js %]'] = [ [% FOREACH x = p.components %]'[% x.name FILTER js %]', [% END %] ];
+  version['[% p.name FILTER js %]'] = [ [% FOREACH x = p.versions %]'[% x.name FILTER js %]', [% END %] ];
+  target_milestone['[% p.name FILTER js %]'] = [ [% FOREACH x = p.milestones %]'[% x.name FILTER js %]', [% END %] ];
+[% END %]
+
+// Product and Component Exceptions
+// ================================
+//
+// A blacklist for some commonly used words or word fragments 
+// that occur in a product or component name but should *not*
+// trigger product/component search in QuickSearch.
+
+var product_exceptions = new Array(
+  // Example:
+  //"row"   // [Browser]
+  //        //   ^^^
+  //,"new"  // [MailNews]
+  //        //      ^^^
+);
+
+var component_exceptions = new Array(
+  // Example:
+  //"hang"  // [mozilla.org] Bugzilla: Component/Keyword Changes
+  //        //                                            ^^^^
+);
+
+// Queryable Fields
+// ================
+[% PROCESS "global/field-descs.none.tmpl" %]
+var field = [
+[% FOREACH x = field %]
+  { name:        '[% x.name FILTER js %]', 
+    description: '[% (field_descs.${x.name} OR x.description) FILTER js %]',
+    [%-# These values are meaningful for custom fields only. %]
+    [% IF x.custom %]
+    type:        '[% x.type FILTER js %]',
+    type_desc:   '[% field_types.${x.type} FILTER js %]',
+    enter_bug:   '[% x.enter_bug FILTER js %]',
+    [% END %]
+  },
+[% END %]
+];
+
+// Deprecated Variables
+// ====================
+//
+// Other names for various variables.  These are deprecated
+// and could go away at any time.  Use them at your own risk!
+
+var bugzilla = installation.base_url;
+var statuses = status;
+var statuses_resolved = status_closed;
+var resolutions = resolution;
+var keywords = keyword;
+var platforms = platform;
+var severities = severity;
+var cpts = component;
+var vers = version;
+var tms = target_milestone;

diff --git a/template/en/default/config.rdf.tmpl b/template/en/default/config.rdf.tmpl
new file mode 100644 (file)
index 0000000..b14d0d0
--- /dev/null
+++ b/template/en/default/config.rdf.tmpl
@@ -0,0 +1,288 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# The url to the installation is going to be displayed many times.
+  # So we cache it here for better performance.
+ %]
+[% escaped_urlbase = BLOCK %][% urlbase FILTER xml %][% END %]
+<?xml version="1.0"[% IF Param('utf8') %] encoding="UTF-8"[% END %]?>
+<!-- Note: this interface is experimental and under development.
+   - We may and probably will make breaking changes to it in the future. -->
+
+<RDF xmlns="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+     xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+     xmlns:bz="http://www.bugzilla.org/rdf#">
+
+<bz:installation rdf:about="[% escaped_urlbase %]">
+  <bz:install_version>[% constants.BUGZILLA_VERSION FILTER html %]</bz:install_version>
+  <bz:maintainer>[% Param('maintainer') FILTER html %]</bz:maintainer>
+
+  <bz:status>
+    <Seq>
+      [% FOREACH item = status %]
+        <li>[% item FILTER html %]</li>
+      [% END %]
+    </Seq>
+  </bz:status>
+
+  <bz:status_open>
+    <Seq>
+      [% FOREACH item = open_status %]
+        <li>[% item FILTER html %]</li>
+      [% END %]
+    </Seq>
+  </bz:status_open>
+
+  <bz:status_closed>
+    <Seq>
+      [% FOREACH item = closed_status %]
+        <li>[% item FILTER html %]</li>
+      [% END %]
+    </Seq>
+  </bz:status_closed>
+
+  <bz:resolution>
+    <Seq>
+      [% FOREACH item = resolution %]
+        <li>[% item FILTER html %]</li>
+      [% END %]
+    </Seq>
+  </bz:resolution>
+
+  <bz:keywords>
+    <Seq>
+      [% FOREACH keyword = keywords %]
+        <li>
+          <bz:keyword rdf:about="[% escaped_urlbase %]keyword.cgi?name=[% keyword.name FILTER uri %]">
+            <bz:name>[% keyword.name FILTER html %]</bz:name>
+            <bz:description>[% keyword.description FILTER html %]</bz:description>
+          </bz:keyword>
+        </li>
+      [% END %]
+    </Seq>
+  </bz:keywords>
+
+  <bz:platform>
+    <Seq>
+      [% FOREACH item = platform %]
+        <li>[% item FILTER html %]</li>
+      [% END %]
+    </Seq>
+  </bz:platform>
+
+  <bz:op_sys>
+    <Seq>
+      [% FOREACH item = op_sys %]
+        <li>[% item FILTER html %]</li>
+      [% END %]
+    </Seq>
+  </bz:op_sys>
+
+  <bz:priority>
+    <Seq>
+      [% FOREACH item = priority %]
+        <li>[% item FILTER html %]</li>
+      [% END %]
+    </Seq>
+  </bz:priority>
+
+  <bz:severity>
+    <Seq>
+      [% FOREACH item = severity %]
+        <li>[% item FILTER html %]</li>
+      [% END %]
+    </Seq>
+  </bz:severity>
+
+[% FOREACH cf = custom_fields %]
+  <bz:[% cf.name FILTER html %]>
+    <Seq>
+      [% FOREACH item = cf.legal_values %]
+        <li>[% item.name FILTER html %]</li>
+      [% END %]
+    </Seq>
+  </bz:[% cf.name FILTER html %]>
+
+[% END %]
+
+[% IF Param('useclassification') %]
+  <bz:classifications>
+    <Seq>
+      [% FOREACH classification = classifications %]
+      <li>
+        <bz:classification rdf:about="[% escaped_urlbase %]classification.cgi?name=
+          [% classification.name FILTER uri %]">
+          <bz:name>[% classification.name FILTER html %]</bz:name>
+          <bz:description>[% classification.description FILTER html %]</bz:description>
+          <bz:sortkey>[% classification.sortkey FILTER html %]</bz:sortkey>
+        </bz:classification>
+      </li>
+      [% END %]
+    </Seq>
+  </bz:classifications>
+[% END %]
+
+  <bz:products>
+    <Seq>
+      [% FOREACH product = products %]
+        <li>
+          <bz:product rdf:about="[% escaped_urlbase %]product.cgi?name=[% product.name FILTER uri %]">
+            <bz:name>[% product.name FILTER html %]</bz:name>
+            <bz:allows_unconfirmed>[% product.allows_unconfirmed FILTER html %]</bz:allows_unconfirmed>
+            [% IF Param('useclassification') %]
+              <bz:classification>[% class_names.${product.classification_id}.name FILTER html %]</bz:classification>
+            [% END %]
+            <bz:components>
+              <Seq>
+                [% FOREACH component = product.components %]
+                  <li resource="[% escaped_urlbase %]component.cgi?name=[% component.name FILTER uri
+                      %]&amp;product=[% product.name FILTER uri %]"/>
+                [% END %]
+              </Seq>
+            </bz:components>
+
+            <bz:versions>
+              <Seq>
+                [% FOREACH version = product.versions %]
+                  <li resource="[% escaped_urlbase %]version.cgi?name=[% version.name FILTER uri
+                      %]&amp;product=[% product.name FILTER uri %]"/>
+                [% END %]
+              </Seq>
+            </bz:versions>
+
+            [% IF Param('usetargetmilestone') %]
+              <bz:target_milestones>
+                <Seq>
+                  [% FOREACH milestone = product.milestones %]
+                    <li resource="[% escaped_urlbase %]milestone.cgi?name=[% milestone.name FILTER uri
+                        %]&amp;product=[% product.name FILTER uri %]"/>
+                  [% END %]
+                </Seq>
+              </bz:target_milestones>
+            [% END %]
+
+          </bz:product>
+        </li>
+      [% END %]
+    </Seq>
+  </bz:products>
+
+  [% all_visible_flag_types = {} %]
+  <bz:components>
+    <Seq>
+      [% FOREACH product = products %]
+        [% FOREACH component = product.components %]
+          <li>
+            <bz:component rdf:about="[% escaped_urlbase %]component.cgi?name=[% component.name FILTER uri
+                          %]&amp;product=[% product.name FILTER uri %]">
+              <bz:name>[% component.name FILTER html %]</bz:name>
+              <bz:is_active>[% component.is_active FILTER html %]</bz:is_active>
+              [% IF show_flags %]
+                <bz:flag_types>
+                  <Seq>
+                    [% flag_types = component.flag_types.bug.merge(component.flag_types.attachment) %]
+                    [% FOREACH flag_type = flag_types %]
+                      [% NEXT UNLESS flag_type.is_active %]
+                      [% all_visible_flag_types.${flag_type.id} = flag_type %]
+                      <li resource="[% escaped_urlbase %]flag.cgi?id=[% flag_type.id FILTER uri
+                          %]&amp;name=[% flag_type.name FILTER uri %]" />
+                    [% END %]
+                  </Seq>
+                </bz:flag_types>
+              [% END %]
+            </bz:component>
+          </li>
+        [% END %]
+      [% END %]
+    </Seq>
+  </bz:components>
+
+  <bz:versions>
+    <Seq>
+      [% FOREACH product = products %]
+        [% FOREACH version = product.versions %]
+          <li>
+            <bz:version rdf:about="[% escaped_urlbase %]version.cgi?name=[% version.name FILTER uri
+                        %]&amp;product=[% product.name FILTER uri %]">
+              <bz:name>[% version.name FILTER html %]</bz:name>
+              <bz:is_active>[% version.is_active FILTER html %]</bz:is_active>
+            </bz:version>
+          </li>
+        [% END %]
+      [% END %]
+    </Seq>
+  </bz:versions>
+
+  [% IF Param('usetargetmilestone') %]
+    <bz:target_milestones>
+      <Seq>
+        [% FOREACH product = products %]
+          [% FOREACH milestone = product.milestones %]
+            <li>
+              <bz:target_milestone rdf:about="[% escaped_urlbase %]milestone.cgi?name=[% milestone.name FILTER uri
+                                   %]&amp;product=[% product.name FILTER uri %]">
+                <bz:name>[% milestone.name FILTER html %]</bz:name>
+                <bz:is_active>[% milestone.is_active FILTER html %]</bz:is_active>
+              </bz:target_milestone>
+            </li>
+          [% END %]
+        [% END %]
+      </Seq>
+    </bz:target_milestones>
+  [% END %]
+
+  [% IF show_flags %]
+    <bz:flag_types>
+      <Seq>
+        [% FOREACH flag_type = all_visible_flag_types.values.sort('name') %]
+          <li>
+            <bz:flag_type rdf:about="[% escaped_urlbase %]flag.cgi?id=[% flag_type.id FILTER uri
+                          %]&amp;name=[% flag_type.name FILTER uri %]">
+              <bz:id>[% flag_type.id FILTER html %]</bz:id>
+              <bz:name>[% flag_type.name FILTER html %]</bz:name>
+              <bz:description>[% flag_type.description FILTER html %]</bz:description>
+              <bz:type>[% flag_type.target_type FILTER html %]</bz:type>
+              <bz:requestable>[% flag_type.is_requestable FILTER html %]</bz:requestable>
+              <bz:specifically_requestable>[% flag_type.is_requesteeble FILTER html %]</bz:specifically_requestable>
+              <bz:multiplicable>[% flag_type.is_multiplicable FILTER html %]</bz:multiplicable>
+              [% IF user.in_group("editcomponents") %]
+                <bz:grant_group>[% flag_type.grant_group.name FILTER html %]</bz:grant_group>
+                <bz:request_group>[% flag_type.request_group.name FILTER html %]</bz:request_group>
+              [% END %]
+            </bz:flag_type>
+          </li>
+        [% END %]
+      </Seq>
+    </bz:flag_types>
+  [% END %]
+
+  <bz:fields>
+    <Seq>
+      [% PROCESS "global/field-descs.none.tmpl" %]
+      [% FOREACH item = field %]
+        <li>
+          <bz:field rdf:about="[% escaped_urlbase %]field.cgi?name=[% item.name FILTER uri %]">
+            <bz:name>[% item.name FILTER html %]</bz:name>
+            <bz:description>[% (field_descs.${item.name} OR item.description) FILTER html %]</bz:description>
+            [%-# These values are meaningful for custom fields only. %]
+            [% IF item.custom %]
+              <bz:type>[% item.type FILTER html %]</bz:type>
+              <bz:type_desc>[% field_types.${item.type} FILTER html %]</bz:type_desc>
+              <bz:enter_bug>[% item.enter_bug FILTER html %]</bz:enter_bug>
+            [% END %]
+            [% IF item.is_active.defined %]
+              <bz:is_active>[% item.is_active FILTER html %]</bz:is_active>
+            [% END %]
+          </bz:field>
+        </li>
+      [% END %]
+    </Seq>
+  </bz:fields>
+</bz:installation>
+
+</RDF>

diff --git a/template/en/default/email/bugmail-common.txt.tmpl b/template/en/default/email/bugmail-common.txt.tmpl
new file mode 100644 (file)
index 0000000..5d35359
--- /dev/null
+++ b/template/en/default/email/bugmail-common.txt.tmpl
@@ -0,0 +1,25 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+  
+[% field_label = field_descs.${change.field_name} %]
+[% old_value = display_value(change.field_name, change.old) %]
+[% new_value = display_value(change.field_name, change.new) %]
+
+[% IF change.field_name == "estimated_time" || change.field_name == "remaining_time" %]
+  [% old_value = old_value FILTER format('%.2f') %]
+  [% new_value = new_value FILTER format('%.2f') %]
+[% END %]
+
+[% IF change.attach_id %]
+  [% field_label = field_label.replace('^(Attachment )?', "Attachment #${change.attach_id} ") %]
+[% END %]
+
+[% IF change.field_name == 'longdescs.isprivate' %]
+  [% field_label = field_label.replace('^(Comment )?', "Comment #${change.num} ") %]
+[% END %]
+  

diff --git a/template/en/default/email/bugmail-header.txt.tmpl b/template/en/default/email/bugmail-header.txt.tmpl
new file mode 100644 (file)
index 0000000..c754f6a
--- /dev/null
+++ b/template/en/default/email/bugmail-header.txt.tmpl
@@ -0,0 +1,36 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+  
+[% PROCESS "global/reason-descs.none.tmpl" %]
+[% isnew = bug.lastdiffed ? 0 : 1 %]
+[% show_new = isnew
+              && (to_user.settings.bugmail_new_prefix.value == 'on') %]
+
+From: [% Param('mailfrom') %]
+To: [% to_user.email %]
+Subject: [[% terms.Bug %] [%+ bug.id %]] [% 'New: ' IF show_new %][%+ bug.short_desc %]
+Date: [% date %]
+X-Bugzilla-Reason: [% reasonsheader %]
+X-Bugzilla-Type: [% isnew ? 'new' : 'changed' %]
+X-Bugzilla-Watch-Reason: [% reasonswatchheader %]
+[% IF Param('useclassification') %]
+X-Bugzilla-Classification: [% bug.classification %]
+[% END %]
+X-Bugzilla-Product: [% bug.product %]
+X-Bugzilla-Component: [% bug.component %]
+X-Bugzilla-Version: [% bug.version %]
+X-Bugzilla-Keywords: [% bug.keywords %]
+X-Bugzilla-Severity: [% bug.bug_severity %]
+X-Bugzilla-Who: [% changer.login %]
+X-Bugzilla-Status: [% bug.bug_status %]
+X-Bugzilla-Priority: [% bug.priority %]
+X-Bugzilla-Assigned-To: [% bug.assigned_to.login %]
+X-Bugzilla-Target-Milestone: [% bug.target_milestone %]
+X-Bugzilla-Flags:[% FOREACH flag = bug.flags %] [%+ flag.name %][% flag.status %][% END %]
+X-Bugzilla-Changed-Fields: [% changedfields.join(" ") %]
+[%+ threadingmarker %]

diff --git a/template/en/default/email/bugmail.html.tmpl b/template/en/default/email/bugmail.html.tmpl
new file mode 100644 (file)
index 0000000..5d31d27
--- /dev/null
+++ b/template/en/default/email/bugmail.html.tmpl
@@ -0,0 +1,119 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+  
+[% PROCESS "global/reason-descs.none.tmpl" %]
+
+[% isnew = bug.lastdiffed ? 0 : 1 %]
+<html>
+    <head>
+      <base href="[% urlbase FILTER html %]" />
+    </head>
+    <body>
+      [% Hook.process('start') %]
+      [% PROCESS generate_diffs %]
+      <p>
+      [% FOREACH comment = new_comments.reverse %]
+        <div>
+          [% IF comment.count %]
+            <b>[% "Comment # ${comment.count}" FILTER bug_link(bug,
+              {comment_num => comment.count, full_url => 1, user => to_user}) FILTER none %]
+              on [% "$terms.bug $bug.id" FILTER bug_link(bug, { full_url => 1, user => to_user }) FILTER none %]
+              from [% INCLUDE global/user.html.tmpl who = comment.author %]</b>
+          [% END %]
+        <pre>[% comment.body_full({ wrap => 1 }) FILTER quoteUrls(bug, comment, to_user) %]</pre>
+        </div>
+      [% END %]
+      </p>
+      <hr>
+      <span>You are receiving this mail because:</span>
+      
+      <ul>
+      [% FOREACH reason = reasons %]
+        [%  IF reason_descs.$reason  %]
+          <li>[% reason_descs.$reason FILTER html %]</li>
+        [% END %]
+      [% END %]
+      [% FOREACH reason = reasons_watch %]
+        [% IF watch_reason_descs.$reason %]
+          <li>[% watch_reason_descs.$reason FILTER html %]</li>
+        [% END %]
+      [% END %]
+      </ul>
+    </body>
+</html>
+
+[% BLOCK generate_diffs %]
+  [% SET in_table = 0 %]
+  [% last_changer = 0 %]
+    [% FOREACH change = diffs %]
+      [% IF !isnew && changer.id != last_changer %]
+        [% last_changer = changer.id %]
+        [% IF in_table == 1 %]
+          </table>
+          [% SET in_table = 0 %]
+        [% END %]
+        [% IF change.blocker %]
+              [% "${terms.Bug} ${bug.id}" FILTER bug_link(bug, {full_url => 1, user => to_user}) FILTER none %]
+              depends on
+              [%+ "${terms.bug} ${change.blocker.id}"
+                  FILTER bug_link(change.blocker, {full_url => 1, user => to_user}) FILTER none %],
+              which changed state.
+        [% ELSE %]
+              [% INCLUDE global/user.html.tmpl who = change.who %] changed
+              [%+ "${terms.bug} ${bug.id}" FILTER bug_link(bug, {full_url => 1, user => to_user}) FILTER none %]
+        [% END %]
+          <br>
+          [% IF in_table == 0 %]
+             <table border="1" cellspacing="0" cellpadding="8">
+             [% SET in_table = 1 %]
+          [% END %]
+          <tr>
+            <th>What</th>
+            <th>Removed</th>
+            <th>Added</th>
+          </tr>
+      [% END %]
+
+      [% PROCESS "email/bugmail-common.txt.tmpl" %]
+      [% IF in_table == 0 %]
+         <table border="1" cellspacing="0" cellpadding="8">
+         [% SET in_table = 1 %]
+      [% END %]
+      [% IF isnew %]
+        <tr>
+          <th>[% field_label FILTER html %]</th>
+          <td>
+            [% IF change.field_name == "bug_id" %]
+              [% new_value FILTER bug_link(bug, {full_url => 1, user => to_user}) FILTER none %]
+            [% ELSE %]
+              [% new_value FILTER html %]
+            [% END %]
+          </td>
+        </tr>
+      [% ELSE %]
+         <tr>
+           <td style="text-align:right;">[% field_label FILTER html %]</td>
+           <td>
+             [% IF old_value %]
+               [% old_value FILTER html %]
+             [% ELSE %]
+               &nbsp;
+             [% END%]
+           </td>
+           <td>
+             [% IF new_value %]
+               [% new_value FILTER html %]
+             [% ELSE %]
+               &nbsp;
+             [% END%]
+           </td>
+         </tr>
+      [% END %]
+    [% END %]
+  [% '</table>' IF in_table %]
+[% END %]

diff --git a/template/en/default/email/bugmail.txt.tmpl b/template/en/default/email/bugmail.txt.tmpl
new file mode 100644 (file)
index 0000000..92c9a33
--- /dev/null
+++ b/template/en/default/email/bugmail.txt.tmpl
@@ -0,0 +1,63 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS "global/reason-descs.none.tmpl" %]
+
+[% isnew = bug.lastdiffed ? 0 : 1 %]
+
+[% Hook.process('start') %]
+
+[%+ PROCESS generate_diffs -%]
+
+[% FOREACH comment = new_comments %]
+
+[%- IF comment.count %]
+--- Comment #[% comment.count %] from [% comment.author.identity %] ---
+[% END %]
+[%+ comment.body_full({ is_bugmail => 1, wrap => 1 }) %]
+[% END %]
+
+-- [%# Protect the trailing space of the signature marker %]
+You are receiving this mail because:
+[% SET reason_lines = [] %]
+[% FOREACH reason = reasons %]
+  [% reason_lines.push(reason_descs.$reason) IF reason_descs.$reason %]
+[% END %]
+[% FOREACH reason = reasons_watch %]
+  [% reason_lines.push(watch_reason_descs.$reason)
+       IF watch_reason_descs.$reason %]
+[% END %]
+[%+ reason_lines.join("\n") %]
+
+[% BLOCK generate_diffs %]
+  [% urlbase %]show_bug.cgi?id=[% bug.id %]
+
+[%+ last_changer = 0 %]
+  [% FOREACH change = diffs %]
+    [% IF !isnew && changer.id != last_changer %]
+      [% last_changer = changer.id %]
+      [% IF change.blocker %]
+        [% terms.Bug %] [%+ bug.id %] depends on [% terms.bug %] [%+ change.blocker.id %], which changed state.
+
+[%+ terms.Bug %] [%+ change.blocker.id %] Summary: [% change.blocker.short_desc %]
+[%+ urlbase %]show_bug.cgi?id=[% change.blocker.id %]
+      [% ELSE %]
+        [%~ changer.identity %] changed:
+      [% END %]
+
+           What    |Removed                     |Added
+----------------------------------------------------------------------------
+[%+ END %][%# End of IF. This indentation is intentional! ~%]
+    [% PROCESS "email/bugmail-common.txt.tmpl"%]
+    [%~ IF isnew %]
+      [% format_columns(2, field_label _ ":", new_value) -%]
+    [% ELSE %]
+      [% format_columns(3, field_label, old_value, new_value) -%]
+    [% END %]
+  [% END -%]
+[% END %]

diff --git a/template/en/default/email/flagmail.txt.tmpl b/template/en/default/email/flagmail.txt.tmpl
new file mode 100644 (file)
index 0000000..cdda8d6
--- /dev/null
+++ b/template/en/default/email/flagmail.txt.tmpl
@@ -0,0 +1,74 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% bugidsummary = bug.bug_id _ ': ' _ bug.short_desc %]
+[% attidsummary = attachment.id _ ': ' _ attachment.description %]
+[% flagtype_name = flag ? flag.type.name : old_flag.type.name %]
+[% statuses = { '+' => "granted" , '-' => 'denied' , 'X' => "canceled" ,
+                '?' => "asked" } %]
+
+[% to_identity = "" %]
+[% on_behalf_of = 0 %]
+[% action = flag.status || 'X' %]
+
+[% IF flag && flag.status == '?' %]
+  [% subject_status = "requested" %]
+  [% IF flag.setter_id == user.id %]
+    [% to_identity = flag.requestee.identity _ " for" %]
+  [% ELSE %]
+    [% on_behalf_of = 1 %]
+    [% IF flag.requestee %][% to_identity = " to " _ flag.requestee.identity %][% END %]
+  [% END %]
+[% ELSE %]
+  [% IF old_flag && old_flag.status == '?' %]
+    [% to_identity = old_flag.setter.identity _ "'s request for" %]
+  [% END %]
+  [% subject_status = statuses.$action %]
+[% END %]
+From: [% Param('mailfrom') %]
+To: [% to %]
+Subject: [% flagtype_name %] [%+ subject_status %]: [[% terms.Bug %] [%+ bug.bug_id %]] [% bug.short_desc %]
+[%- IF attachment %] :
+  [Attachment [% attachment.id %]] [% attachment.description FILTER clean_text %][% END %]
+Date: [% date %]
+X-Bugzilla-Type: request
+[%+ threadingmarker %]
+
+[%+ USE wrap -%]
+[%- FILTER bullet = wrap(80) -%]
+
+[% IF on_behalf_of %]
+[% user.identity %] has reassigned [% flag.setter.identity %]'s request for [% flagtype_name %]
+[% to_identity %]:
+[% ELSE %]
+[% user.identity %] has [% statuses.$action %] [%+ to_identity %] [%+ flagtype_name %]:
+[% END %]
+
+[% terms.Bug %] [%+ bugidsummary %]
+[% END %]
+[%+ urlbase %]show_bug.cgi?id=[% bug.bug_id %]
+[% IF attachment %]
+
+[% FILTER bullet = wrap(80) %]
+Attachment [% attidsummary %]
+[%- END %]
+[%+ urlbase %]attachment.cgi?id=[% attachment.id %]&action=edit
+[%- END %]
+
+[%- Hook.process('after_summary') -%]
+
+[%- FILTER bullet = wrap(80) %]
+
+[% USE Bugzilla %]
+[%-# .defined is necessary to avoid a taint issue in Perl < 5.10.1, see bug 509794. %]
+[% IF Bugzilla.cgi.param("comment").defined && Bugzilla.cgi.param("comment").length > 0 %]
+------- Additional Comments from [% user.identity %]
+[%+ Bugzilla.cgi.param("comment") %]
+[% END %]
+
+[%- END %]

diff --git a/template/en/default/email/lockout.txt.tmpl b/template/en/default/email/lockout.txt.tmpl
new file mode 100644 (file)
index 0000000..51153ea
--- /dev/null
+++ b/template/en/default/email/lockout.txt.tmpl
@@ -0,0 +1,25 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+From: [% Param('mailfrom') %]
+To: [% Param('maintainer') %]
+Subject: [[% terms.Bugzilla %]] Account Lock-Out: [% locked_user.login %] ([% address %])
+X-Bugzilla-Type: admin
+
+The address [% address %] failed too many login attempts (
+[%- constants.MAX_LOGIN_ATTEMPTS +%]) for
+the account [% locked_user.login %]. 
+
+The login attempts occurred at these times:
+
+[% FOREACH login = attempts %]
+  [%+ login.login_time FILTER time %]
+[% END %]
+
+This IP will be able to log in again using this account at
+[%+ unlock_at FILTER time %].

diff --git a/template/en/default/email/sanitycheck.txt.tmpl b/template/en/default/email/sanitycheck.txt.tmpl
new file mode 100644 (file)
index 0000000..797e4f1
--- /dev/null
+++ b/template/en/default/email/sanitycheck.txt.tmpl
@@ -0,0 +1,23 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+From: [% Param('mailfrom') %]
+To: [% addressee %]
+Subject: [[% terms.Bugzilla %]] Sanity Check Results
+X-Bugzilla-Type: sanitycheck
+
+[%+ urlbase %]sanitycheck.cgi
+
+Below can you read the sanity check results.
+[% IF error_found %]
+Some errors have been found.
+[% ELSE %]
+No errors have been found.
+[% END %]
+
+[% output %]

diff --git a/template/en/default/email/sudo.txt.tmpl b/template/en/default/email/sudo.txt.tmpl
new file mode 100644 (file)
index 0000000..d0845e3
--- /dev/null
+++ b/template/en/default/email/sudo.txt.tmpl
@@ -0,0 +1,29 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+Content-Type: text/plain
+From: [% Param('mailfrom') %]
+To: [% user.email %]
+Subject: [[% terms.Bugzilla %]] Your account [% user.login -%]
+ is being impersonated
+X-Bugzilla-Type: admin
+
+    [%+ sudoer.identity %] has used the 'sudo' feature to access 
+[%+ terms.Bugzilla %] using your account.
+
+[% IF reason %]
+    [%+ sudoer.identity %] provided the following reason for doing this:
+
+[% reason FILTER wrap_comment %]
+[% ELSE %]
+    [%+ sudoer.identity %] did not provide a reason for doing this.
+[% END %]
+
+    If you feel that this action was inappropriate, please contact 
+[%+ Param("maintainer") %].  For more information on this feature, 
+visit <[% urlbase %]page.cgi?id=sudo.html>.

diff --git a/template/en/default/email/whine.txt.tmpl b/template/en/default/email/whine.txt.tmpl
new file mode 100644 (file)
index 0000000..106a94a
--- /dev/null
+++ b/template/en/default/email/whine.txt.tmpl
@@ -0,0 +1,51 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+From: [% Param("mailfrom") %]
+To: [% email %][% Param("emailsuffix") %]
+Subject: Your [% terms.Bugzilla %] [%+ terms.bug %] list needs attention.
+X-Bugzilla-Type: whine
+
+[This e-mail has been automatically generated.]
+
+You have one or more [% terms.bugs %] assigned to you in the [% terms.Bugzilla %] 
+[% terms.bug %] tracking system ([% urlbase %]) that require
+attention.
+
+All of these [% terms.bugs %] are in the [% display_value("bug_status", "CONFIRMED") %]
+state, and have not been touched in [% Param("whinedays") %] days or more.
+You need to take a look at them, and decide on an initial action.
+
+Generally, this means one of three things:
+
+(1) You decide this [% terms.bug %] is really quick to deal with (like, it's [% display_value("resolution", "INVALID") %]),
+    and so you get rid of it immediately.
+(2) You decide the [% terms.bug %] doesn't belong to you, and you reassign it to
+    someone else. (Hint: if you don't know who to reassign it to, make
+    sure that the Component field seems reasonable, and then use the
+    "Reset Assignee to default" option.)
+(3) You decide the [% terms.bug %] belongs to you, but you can't solve it this moment.
+    Accept the [% terms.bug %] by setting the status to [% display_value("bug_status", "IN_PROGRESS") %].
+
+To get a list of all [% display_value("bug_status", "CONFIRMED") %] [%+ terms.bugs %], you can use this URL (bookmark
+it if you like!):
+
+ [% urlbase %]buglist.cgi?bug_status=CONFIRMED&assigned_to=[% email %]
+
+Or, you can use the general query page, at 
+[%+ urlbase %]query.cgi
+
+Appended below are the individual URLs to get to all of your [% display_value("bug_status", "CONFIRMED") %] [%+ terms.bugs %]
+that haven't been touched for [% Param("whinedays") %] days or more.
+
+You will get this message once a day until you've dealt with these [% terms.bugs %]!
+
+[% FOREACH bug = bugs %]
+ [%+ bug.summary %]
+    -> [% urlbase %]show_bug.cgi?id=[% bug.id %]
+[% END %]

diff --git a/template/en/default/extensions/config.pm.tmpl b/template/en/default/extensions/config.pm.tmpl
new file mode 100644 (file)
index 0000000..cb71957
--- /dev/null
+++ b/template/en/default/extensions/config.pm.tmpl
@@ -0,0 +1,26 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # name: string; The name of the extension.
+  #%]
+
+[% PROCESS extensions/license.txt.tmpl %]
+
+package B[% %]ugzilla::Extension::[% name %];
+use strict;
+
+use constant NAME => '[% name %]';
+
+use constant REQUIRED_MODULES => [
+];
+
+use constant OPTIONAL_MODULES => [
+];
+
+__PACKAGE__->NAME;

diff --git a/template/en/default/extensions/extension.pm.tmpl b/template/en/default/extensions/extension.pm.tmpl
new file mode 100644 (file)
index 0000000..206ea88
--- /dev/null
+++ b/template/en/default/extensions/extension.pm.tmpl
@@ -0,0 +1,31 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # name: string; The name of the extension.
+  #%]
+
+[% PROCESS extensions/license.txt.tmpl %]
+
+package B[% %]ugzilla::Extension::[% name %];
+use strict;
+use base qw(B[% %]ugzilla::Extension);
+
+# This code for this is in [% path %]/lib/Util.pm
+use B[% %]ugzilla::Extension::[% name %]::Util;
+
+our $VERSION = '0.01';
+
+# See the documentation of B[% %]ugzilla::Hook ("perldoc B[% %]ugzilla::Hook" 
+# in the bugzilla directory) for a list of all available hooks.
+sub install_update_db {
+    my ($self, $args) = @_;
+
+}
+
+__PACKAGE__->NAME;

diff --git a/template/en/default/extensions/hook-readme.txt.tmpl b/template/en/default/extensions/hook-readme.txt.tmpl
new file mode 100644 (file)
index 0000000..63e09e4
--- /dev/null
+++ b/template/en/default/extensions/hook-readme.txt.tmpl
@@ -0,0 +1,13 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+Template hooks go in this directory. Template hooks are called in normal
+[%+ terms.Bugzilla %] templates like [[% '%' %] Hook.process('some-hook') %].
+More information about them can be found in the documentation of 
+B[% %]ugzilla::Extension. (Do "perldoc B[% %]ugzilla::Extension" from the main
+[%+ terms.Bugzilla %] directory to see that documentation.)

diff --git a/template/en/default/extensions/license.txt.tmpl b/template/en/default/extensions/license.txt.tmpl
new file mode 100644 (file)
index 0000000..6acde01
--- /dev/null
+++ b/template/en/default/extensions/license.txt.tmpl
@@ -0,0 +1,18 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # name: string; The name of the extension.
+  #%]
+
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.

diff --git a/template/en/default/extensions/name-readme.txt.tmpl b/template/en/default/extensions/name-readme.txt.tmpl
new file mode 100644 (file)
index 0000000..5403bab
--- /dev/null
+++ b/template/en/default/extensions/name-readme.txt.tmpl
@@ -0,0 +1,24 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+Normal templates go in this directory. You can load them in your
+code like this:
+
+use B[% %]ugzilla::Error;
+my $template = B[% %]ugzilla->template;
+$template->process('[% name FILTER lower %]/some-template.html.tmpl')
+  or ThrowTemplateError($template->error());
+
+That would be how to load a file called some-template.html.tmpl that
+was in this directory.
+
+Note that you have to be careful that the full path of your template
+never conflicts with a template that exists in [% terms.Bugzilla %] or in 
+another extension, or your template might override that template. That's why
+we created this directory called '[% name FILTER lower %]' for you, so you
+can put your templates in here to help avoid conflicts.

diff --git a/template/en/default/extensions/util.pm.tmpl b/template/en/default/extensions/util.pm.tmpl
new file mode 100644 (file)
index 0000000..6c9fe37
--- /dev/null
+++ b/template/en/default/extensions/util.pm.tmpl
@@ -0,0 +1,27 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # name: string; The name of the extension.
+  #%]
+
+[% PROCESS extensions/license.txt.tmpl %]
+
+package B[% %]ugzilla::Extension::[% name %]::Util;
+use strict;
+use base qw(Exporter);
+our @EXPORT = qw(
+    
+);
+
+# This file can be loaded by your extension via 
+# "use B[% %]ugzilla::Extension::[% name %]::Util". You can put functions
+# used by your extension in here. (Make sure you also list them in
+# @EXPORT.)
+
+1;

diff --git a/template/en/default/extensions/web-readme.txt.tmpl b/template/en/default/extensions/web-readme.txt.tmpl
new file mode 100644 (file)
index 0000000..41dcd8e
--- /dev/null
+++ b/template/en/default/extensions/web-readme.txt.tmpl
@@ -0,0 +1,15 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+Web-accessible files, like JavaScript, CSS, and images go in this
+directory. You can reference them directly in your HTML. For example,
+if you have a file called "style.css" and your extension is called
+"Foo", you would put it in "extensions/Foo/web/style.css", and then
+you could link to it in HTML like:
+
+<link href="extensions/Foo/web/style.css" rel="stylesheet" type="text/css">

diff --git a/template/en/default/filterexceptions.pl b/template/en/default/filterexceptions.pl
new file mode 100644 (file)
index 0000000..b0cb1ba
--- /dev/null
+++ b/template/en/default/filterexceptions.pl
@@ -0,0 +1,470 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# Important! The following classes of directives are excluded in the test,
+# and so do not need to be added here. Doing so will cause warnings.
+# See 008filter.t for more details.
+#
+# Comments                        - [%#...
+# Directives                      - [% IF|ELSE|UNLESS|FOREACH...
+# Assignments                     - [% foo = ...
+# Simple literals                 - [% " selected" ...
+# Values always used for numbers  - [% (i|j|k|n|count) %]
+# Params                          - [% Param(...
+# Safe functions                  - [% (time2str)...
+# Safe vmethods                   - [% foo.size %] [% foo.length %]
+#                                   [% foo.push() %]
+# TT loop variables               - [% loop.count %]
+# Already-filtered stuff          - [% wibble FILTER html %]
+#   where the filter is one of html|csv|js|quoteUrls|time|uri|xml|none
+
+%::safe = (
+
+'whine/schedule.html.tmpl' => [
+  'event.key',
+  'query.id',
+  'query.sort',
+  'schedule.id',
+  'option.0',
+  'option.1',
+],
+
+'whine/mail.html.tmpl' => [
+  'bug.bug_id',
+],
+
+'flag/list.html.tmpl' => [
+  'flag.status', 
+  'type.id', 
+],
+
+'search/form.html.tmpl' => [
+  'qv.name',
+  'qv.description',
+],
+
+'search/search-specific.html.tmpl' => [
+  'status.name',
+],
+
+'search/tabs.html.tmpl' => [
+  'content',
+],
+
+'request/queue.html.tmpl' => [
+  'column_headers.$group_field', 
+  'column_headers.$column', 
+  'request.status', 
+  'request.bug_id', 
+  'request.attach_id', 
+],
+
+'reports/keywords.html.tmpl' => [
+  'keyword.bug_count', 
+],
+
+'reports/report-table.csv.tmpl' => [
+  'data.$tbl.$col.$row',
+  'colsepchar',
+],
+
+'reports/report-table.html.tmpl' => [
+  '"&$col_vals" IF col_vals', 
+  '"&$row_vals" IF row_vals', 
+  'classes.$row_idx.$col_idx', 
+  'urlbase', 
+  'data.$tbl.$col.$row', 
+  'row_total',
+  'col_totals.$col',
+  'grand_total', 
+],
+
+'reports/report.html.tmpl' => [
+  'width', 
+  'height', 
+  'imageurl', 
+  'formaturl', 
+  'other_format.name', 
+  'switchbase',
+  'cumulate',
+],
+
+'reports/chart.html.tmpl' => [
+  'width', 
+  'height', 
+  'imageurl', 
+  'sizeurl', 
+  'height + 100', 
+  'height - 100', 
+  'width + 100', 
+  'width - 100', 
+],
+
+'reports/series-common.html.tmpl' => [
+  'sel.name', 
+  '"onchange=\"$sel.onchange\"" IF sel.onchange', 
+],
+
+'reports/chart.csv.tmpl' => [
+  'data.$j.$i', 
+  'colsepchar',
+],
+
+'reports/create-chart.html.tmpl' => [
+  'series.series_id', 
+  'newidx',
+],
+
+'reports/edit-series.html.tmpl' => [
+  'default.series_id', 
+],
+
+'list/edit-multiple.html.tmpl' => [
+  'group.id', 
+  'menuname',
+],
+
+'list/list.rdf.tmpl' => [
+  'template_version', 
+  'bug.bug_id', 
+  'column', 
+],
+
+'list/table.html.tmpl' => [
+  'tableheader',
+  'bug.bug_id', 
+],
+
+'list/list.csv.tmpl' => [
+  'bug.bug_id', 
+  'colsepchar',
+],
+
+'list/list.js.tmpl' => [
+  'bug.bug_id', 
+],
+
+'global/choose-product.html.tmpl' => [
+  'target',
+],
+
+# You are not permitted to add any values here. Everything in this file should 
+# be filtered unless there's an extremely good reason why not, in which case,
+# use the "none" dummy filter.
+'global/code-error.html.tmpl' => [
+],
+ 
+'global/header.html.tmpl' => [
+  'javascript', 
+  'style', 
+  'onload',
+  'title',
+  '" – $header" IF header',
+  'subheader',
+  'header_addl_info', 
+  'message', 
+],
+
+'global/messages.html.tmpl' => [
+  'message_tag', 
+  'series.frequency * 2',
+],
+
+'global/select-menu.html.tmpl' => [
+  'options', 
+  'size', 
+],
+
+'global/tabs.html.tmpl' => [
+  'content', 
+],
+
+# You are not permitted to add any values here. Everything in this file should 
+# be filtered unless there's an extremely good reason why not, in which case,
+# use the "none" dummy filter.
+'global/user-error.html.tmpl' => [
+],
+
+'global/confirm-user-match.html.tmpl' => [
+  'script',
+],
+
+'global/site-navigation.html.tmpl' => [
+  'bug.bug_id', 
+],
+
+'bug/comments.html.tmpl' => [
+  'comment.id',
+  'comment.count',
+  'bug.bug_id',
+],
+
+'bug/dependency-graph.html.tmpl' => [
+  'image_map', # We need to continue to make sure this is safe in the CGI
+  'image_url', 
+  'map_url', 
+  'bug_id', 
+],
+
+'bug/dependency-tree.html.tmpl' => [
+  'bugid', 
+  'maxdepth', 
+  'hide_resolved', 
+  'ids.join(",")',
+  'maxdepth + 1', 
+  'maxdepth > 0 && maxdepth <= realdepth ? maxdepth : ""',
+  'maxdepth == 1 ? 1
+                       : ( maxdepth ? maxdepth - 1 : realdepth - 1 )',
+],
+
+'bug/edit.html.tmpl' => [
+  'bug.remaining_time', 
+  'bug.delta_ts', 
+  'bug.bug_id', 
+  'group.bit', 
+  'selname',
+  'inputname',
+  '" colspan=\"$colspan\"" IF colspan',
+  '" size=\"$size\"" IF size',
+  '" maxlength=\"$maxlength\"" IF maxlength',
+  '" spellcheck=\"$spellcheck\"" IF spellcheck',
+],
+
+'bug/show-multiple.html.tmpl' => [
+  'attachment.id', 
+  'flag.status',
+],
+
+'bug/show.html.tmpl' => [
+  'bug.bug_id',
+],
+
+'bug/show.xml.tmpl' => [
+  'constants.BUGZILLA_VERSION', 
+  'a.id', 
+  'field', 
+],
+
+'bug/summarize-time.html.tmpl' => [
+  'global.grand_total FILTER format("%.2f")',
+  'subtotal FILTER format("%.2f")',
+  'work_time FILTER format("%.2f")',
+  'global.total FILTER format("%.2f")',
+  'global.remaining FILTER format("%.2f")',
+  'global.estimated FILTER format("%.2f")',
+  'bugs.$id.remaining_time FILTER format("%.2f")',
+  'bugs.$id.estimated_time FILTER format("%.2f")',
+],
+
+
+'bug/time.html.tmpl' => [
+  'time_unit FILTER format(\'%.1f\')', 
+  'time_unit FILTER format(\'%.2f\')', 
+  '(act / (act + rem)) * 100 
+       FILTER format("%d")', 
+],
+
+'bug/process/results.html.tmpl' => [
+  'title.$type', 
+  '"$terms.Bug $id" FILTER bug_link(id)',
+  '"$terms.bug $id" FILTER bug_link(id)',
+],
+
+'bug/create/create.html.tmpl' => [
+  'cloned_bug_id',
+],
+
+'bug/create/create-guided.html.tmpl' => [
+  'tablecolour',
+  'sel',
+  'productstring', 
+],
+
+'bug/activity/table.html.tmpl' => [
+  'change.attachid', 
+],
+
+'attachment/create.html.tmpl' => [
+  'bug.bug_id',
+  'attachment.id', 
+],
+
+'attachment/created.html.tmpl' => [
+  'attachment.id',
+  'attachment.bug_id',
+],
+
+'attachment/edit.html.tmpl' => [
+  'attachment.id', 
+  'attachment.bug_id', 
+  'editable_or_hide',
+],
+
+'attachment/list.html.tmpl' => [
+  'attachment.id', 
+  'flag.status',
+  'bugid',
+  'obsolete_attachments',
+],
+
+'attachment/midair.html.tmpl' => [
+  'attachment.id',
+],
+
+'attachment/show-multiple.html.tmpl' => [
+  'a.id',
+  'flag.status'
+],
+
+'attachment/updated.html.tmpl' => [
+  'attachment.id',
+],
+
+'attachment/diff-header.html.tmpl' => [
+  'attachid',
+  'id',
+  'bugid',
+  'oldid',
+  'newid',
+  'patch.id',
+],
+
+'attachment/diff-file.html.tmpl' => [
+  'lxr_prefix',
+  'file.minus_lines',
+  'file.plus_lines',
+  'bonsai_prefix',
+  'section.old_start',
+  'section_num',
+  'current_line_old',
+  'current_line_new',
+],
+
+'admin/admin.html.tmpl' => [
+  'class'
+],
+
+'admin/table.html.tmpl' => [
+  'contentlink'
+],
+
+'admin/custom_fields/cf-js.js.tmpl' => [
+  'constants.FIELD_TYPE_SINGLE_SELECT',
+  'constants.FIELD_TYPE_MULTI_SELECT',
+  'constants.FIELD_TYPE_BUG_ID',
+],
+
+'admin/params/common.html.tmpl' => [
+  'sortlist_separator', 
+],
+
+'admin/products/groupcontrol/confirm-edit.html.tmpl' => [
+  'group.count', 
+],
+
+'admin/products/groupcontrol/edit.html.tmpl' => [
+  'group.id',
+  'constants.CONTROLMAPNA', 
+  'constants.CONTROLMAPSHOWN',
+  'constants.CONTROLMAPDEFAULT',
+  'constants.CONTROLMAPMANDATORY',
+],
+
+'admin/products/list.html.tmpl' => [
+  'classification_url_part', 
+],
+
+'admin/products/footer.html.tmpl' => [
+  'classification_url_part', 
+  'classification_text', 
+],
+
+'admin/flag-type/confirm-delete.html.tmpl' => [
+  'flag_type.flag_count',
+  'flag_type.id', 
+],
+
+'admin/flag-type/edit.html.tmpl' => [
+  'type.id', 
+  'type.sortkey || 1',
+  'selname',
+],
+
+'admin/flag-type/list.html.tmpl' => [
+  'type.id', 
+],
+
+
+'admin/components/confirm-delete.html.tmpl' => [
+  'comp.bug_count'
+],
+
+'admin/groups/delete.html.tmpl' => [
+  'shared_queries'
+],
+
+'admin/users/confirm-delete.html.tmpl' => [
+  'attachments',
+  'reporter',
+  'assignee_or_qa',
+  'cc',
+  'component_cc',
+  'flags.requestee',
+  'flags.setter',
+  'longdescs',
+  'quips',
+  'series',
+  'watch.watched',
+  'watch.watcher',
+  'whine_events',
+  'whine_schedules',
+  'otheruser.id'
+],
+
+'admin/users/edit.html.tmpl' => [
+  'otheruser.id',
+  'group.id',
+],
+
+'admin/components/edit.html.tmpl' => [
+  'comp.bug_count'
+],
+
+'admin/workflow/edit.html.tmpl' => [
+  'status.id',
+  'new_status.id',
+],
+
+'admin/workflow/comment.html.tmpl' => [
+  'status.id',
+  'new_status.id',
+],
+
+'account/auth/login-small.html.tmpl' => [
+  'qs_suffix',
+],
+
+'account/prefs/email.html.tmpl' => [
+  'relationship.id',
+  'event.id',
+  'prefname',
+],
+
+'account/prefs/prefs.html.tmpl' => [
+  'current_tab.label',
+  'current_tab.name',
+],
+
+'account/prefs/saved-searches.html.tmpl' => [
+  'group.id',
+],
+
+'config.rdf.tmpl' => [
+  'escaped_urlbase',
+],
+
+);

diff --git a/template/en/default/flag/list.html.tmpl b/template/en/default/flag/list.html.tmpl
new file mode 100644 (file)
index 0000000..4d7eefb
--- /dev/null
+++ b/template/en/default/flag/list.html.tmpl
@@ -0,0 +1,167 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% IF user.id && !read_only_flags && (!bug || bug.check_can_change_field('flagtypes.name', 0, 1)) %]
+
+[%# We list flags by looping twice over the flag types relevant for the bug.
+  # In the first loop, we display existing flags and then, for active types,
+  # we display UI for adding new flags.  In the second loop, we display UI 
+  # for adding additional new flags for those types for which a flag already
+  # exists but which are multiplicable (can have multiple flags of the type
+  # on a single bug/attachment).
+  #%]
+
+[% DEFAULT flag_table_id = "flags" %]
+
+<script src="[% 'js/flag.js' FILTER mtime %]" type="text/javascript"></script>
+
+<table id="[% flag_table_id FILTER html %]">
+  [% UNLESS flag_no_header %]
+    <tr>
+      <th colspan="3">
+        Flags:
+      </th>
+      [% IF any_flags_requesteeble %]
+        <th>
+          Requestee:
+        </th>
+      [% END %]
+    </tr>
+  [% END %]
+
+  [%# Step 1: Display every flag type (except inactive types with no flags). %]
+  [% FOREACH type = flag_types -%]
+
+    [%-# Step 1a: Display existing flag(s). %]
+    [% FOREACH flag = type.flags %]
+      [% PROCESS flag_row flag = flag type = type %]
+    [% END -%]
+    [% SET flag = "" %]
+
+    [%-# Step 1b: Display UI for setting flag. %]
+    [% IF (!type.flags || type.flags.size == 0) && type.is_active %]
+      [% PROCESS flag_row type = type %]
+    [% END %]
+  [% END %]
+
+  [%# Step 2: Display flag type again (if type is multiplicable). %]
+  [% FOREACH type = flag_types %]
+    [% NEXT UNLESS type.flags && type.flags.size > 0 && type.is_multiplicable && type.is_active %]
+    [% IF !separator_displayed %]
+      <tbody class="bz_flag_type">
+        <tr><td colspan="3"><hr></td></tr>
+      </tbody>
+      [% separator_displayed = 1 %]
+    [% END %]
+    [% PROCESS flag_row type = type addl_text = "addl." %]
+  [% END %]
+</table>
+
+[% ELSE %]
+  [%# The user is logged out. Display flags as read-only. %]
+  [% header_displayed = 0 %]
+  [% FOREACH type = flag_types %]
+    [% FOREACH flag = type.flags %]
+      [% IF !flag_no_header AND !header_displayed %]
+        <p><b>Flags:</b></p>
+        [% header_displayed = 1 %]
+      [% END %]
+      [% IF flag.setter.name %]
+        <span title="[% flag.setter.name FILTER html %]">[% flag.setter.nick FILTER html %]</span>:
+      [% ELSE %]
+        [% flag.setter.nick FILTER html %]:
+      [% END %]
+      [%+ type.name FILTER html FILTER no_break %][% flag.status %]
+      [% IF flag.requestee %]
+        [% IF flag.requestee.name %]
+          (<span title="[% flag.requestee.name FILTER html %]">[% flag.requestee.nick FILTER html %]</span>)
+        [% ELSE %]
+          ([% flag.requestee.nick FILTER html %])
+        [% END %]
+      [% END %]<br>
+    [% END %]
+  [% END %]
+[% END %]
+
+[%# Display a table row for flags %]
+
+[% BLOCK flag_row %]
+  [% RETURN IF !flag && !((type.is_requestable && user.can_request_flag(type)) || user.can_set_flag(type)) %]
+  [% SET fid = flag ? "flag-$flag.id" : "flag_type-$type.id" %]
+  <tbody[% ' class="bz_flag_type"' IF !flag %]>
+    <tr>
+      <td>
+        [% IF flag %]
+          <span title="[% flag.setter.identity FILTER html %]">[% flag.setter.nick FILTER html %]</span>:
+        [% ELSE %]
+          [% addl_text FILTER html %]
+        [% END %]
+      </td>
+      <td>
+        <label title="[% type.description FILTER html %]" for="[% fid FILTER html %]">
+          [%- type.name FILTER html FILTER no_break -%]</label>
+      </td>
+      <td>
+        <input type="hidden" id="[% fid FILTER html %]_dirty">
+        <select id="[% fid FILTER html %]" name="[% fid FILTER html %]"
+                title="[% type.description FILTER html %]"
+                onchange="toggleRequesteeField(this);"
+                class="flag_select flag_type-[% type.id %]">
+        [%# Only display statuses the user is allowed to set. %]
+        [% IF !flag || user.can_request_flag(type) || flag.setter_id == user.id %]
+          <option value="X"></option>
+        [% END %]
+        [% IF type.is_active %]
+          [% IF (type.is_requestable && user.can_request_flag(type)) || (flag && flag.status == "?") %]
+            <option value="?" [% "selected" IF flag && flag.status == "?" %]>?</option>
+          [% END %]
+          [% IF user.can_set_flag(type) || (flag && flag.status == "+") %]
+            <option value="+" [% "selected" IF flag && flag.status == "+" %]>+</option>
+          [% END %]
+          [% IF user.can_set_flag(type) || (flag && flag.status == "-") %]
+            <option value="-" [% "selected" IF flag && flag.status == "-" %]>-</option>
+          [% END %]
+        [% ELSE %]
+          <option value="[% flag.status %]" selected="selected">[% flag.status %]</option>
+        [% END %]
+        </select>
+      </td>
+      [% IF any_flags_requesteeble %]
+        <td>
+          [% IF (type.is_active && type.is_requestable && type.is_requesteeble) || (flag && flag.requestee) %]
+            <span style="white-space: nowrap;">
+              [% SET grant_list = [] %]
+              [% IF Param('usemenuforusers') %]
+                [% grant_list = type.grant_list %]
+                [% IF flag && !(type.is_active && type.is_requestable && type.is_requesteeble) %]
+                  [%# We are here only because there was already a requestee. In this case,
+                      the only valid action is to remove the requestee or leave it alone;
+                      nothing else. %]
+                  [% grant_list = [flag.requestee] %]
+                [% END %]
+              [% END %]
+              [% SET flag_name = flag ? "requestee-$flag.id" : "requestee_type-$type.id" %]
+              [% SET flag_requestee = (flag && flag.requestee) ? flag.requestee.login : '' %]
+              [% SET flag_multiple = flag ? 0 : type.is_multiplicable * 3 %]
+              [% SET flag_empty_ok = flag ? 1 : !type.is_multiplicable %]
+              [% INCLUDE global/userselect.html.tmpl
+                         name     => flag_name
+                         id       => flag_name
+                         value    => flag_requestee
+                         multiple => flag_multiple
+                         emptyok  => flag_empty_ok
+                         classes  => ["requestee"]
+                         custom_userlist => grant_list
+              %]
+            </span>
+          [% END %]
+        </td>
+      [% END %]
+    </tr>
+  </tbody>
+[% END %]

diff --git a/template/en/default/global/banner.html.tmpl b/template/en/default/global/banner.html.tmpl
new file mode 100644 (file)
index 0000000..37ec8c0
--- /dev/null
+++ b/template/en/default/global/banner.html.tmpl
@@ -0,0 +1,12 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# Migration note: this file corresponds to the old Param 'bannerhtml' %]
+
+  <div id="banner">
+  </div>

diff --git a/template/en/default/global/calendar.js.tmpl b/template/en/default/global/calendar.js.tmpl
new file mode 100644 (file)
index 0000000..26f3fa0
--- /dev/null
+++ b/template/en/default/global/calendar.js.tmpl
@@ -0,0 +1,33 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # id: The id of the input field the calendar widget is to be assigned to.
+  #%]
+
+[%# This template exists because createCalendar accepts additional parameters
+  # which allow for localization. Please see the YUI documentation at
+  # http://developer.yahoo.com/yui/calendar/#internationalization for details.
+  # As an example, here's what you'd specify as additional parameters to
+  # localize for German calendars; replace the ellipsis ("...") by the original
+  # parameter (we cannot put it into the example because it'd break this
+  # template comment):
+  #
+  #   createCalendar(...
+  #                  /* The weekday the week begins on; 0 is Sunday,
+  #                   * 1 is Monday and so on: */
+  #                  1,
+  #                  /* Months, full names; first must be January: */
+  #                  ['Januar',    'Februar',   'März',      'April',
+  #                   'Mai',       'Juni',      'Juli',      'August',
+  #                   'September', 'Oktober',   'November',  'Dezember'],
+  #                  /* Weekdays, two-letter abbreviations; first must be
+  #                   * Sunday: */
+  #                  ['So', 'Mo', 'Di', 'Mi', 'Do', 'Fr', 'Sa']);
+  #%]
+createCalendar('[% id FILTER js %]');

diff --git a/template/en/default/global/choose-classification.html.tmpl b/template/en/default/global/choose-classification.html.tmpl
new file mode 100644 (file)
index 0000000..76789a2
--- /dev/null
+++ b/template/en/default/global/choose-classification.html.tmpl
@@ -0,0 +1,54 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # classifications: an array of classification objects containing
+  #                  at least one product accessible by the user.
+  #%]
+
+[% IF target == "enter_bug.cgi" %]
+  [% title = "Select Classification" %]
+  [% subheader = "Please select the classification." %]
+[% END %]
+
+[% DEFAULT title = "Choose the classification" %]
+[% PROCESS global/header.html.tmpl %]
+
+<table>
+  <tr>
+    <th align="right">
+      <a href="[% target FILTER uri %]?classification=__all
+            [% IF cloned_bug_id %]&amp;cloned_bug_id=[% cloned_bug_id FILTER uri %][% END -%] 
+            [%- IF format %]&amp;format=[% format FILTER uri %][% END %]">
+      All</a>:
+    </th>
+
+    <td valign="top">&nbsp;Show all products</td>
+  </tr>
+  <tr>
+    <th colspan="2">&nbsp;</th>
+  </tr>
+
+[% FOREACH class = classifications %]
+  <tr>
+    <th align="right">
+      <a href="[% target FILTER uri %]?classification=[% class.name FILTER uri -%]
+            [%- IF cloned_bug_id %]&amp;cloned_bug_id=[% cloned_bug_id FILTER uri %][% END -%] 
+            [%- IF format %]&amp;format=[% format FILTER uri %][% END %]">
+      [% class.name FILTER html %]</a>:
+    </th>
+
+    [% IF class.description %]
+      <td valign="top">&nbsp;[% class.description FILTER html_light %]</td>
+    [% END %]
+  </tr>
+[% END %]
+
+</table>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/global/choose-product.html.tmpl b/template/en/default/global/choose-product.html.tmpl
new file mode 100644 (file)
index 0000000..dfa0b00
--- /dev/null
+++ b/template/en/default/global/choose-product.html.tmpl
@@ -0,0 +1,61 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # classifications: array of hashes, with an 'object' key representing a
+  #                  classification object and 'products' the list of
+  #                  product objects the user can enter bugs into.
+  # target:   the script that displays this template.
+  # cloned_bug_id: ID of the bug being cloned.
+  # format:   the desired format to display the target.
+  #%]
+
+[% IF target == "enter_bug.cgi" %]
+  [% title = "Enter $terms.Bug" %]
+  [% h2 = BLOCK %]First, you must pick a product on which to enter [% terms.abug %]: [% END %]
+[% ELSIF target == "describecomponents.cgi" %]
+  [% title = "Browse" %]
+  [% h2 = "Select a product category to browse:" %]
+[% END %]
+
+[% DEFAULT title = "Choose a Product" %]
+[% PROCESS global/header.html.tmpl %]
+
+<h2>[% h2 FILTER html %]</h2>
+
+<table>
+
+[% FOREACH c = classifications %]
+  [% IF c.object %]
+    <tr>
+      <th colspan="2" align="left">[% c.object.name FILTER html %]:
+      [%+ c.object.description FILTER html_light %]</th>
+    </tr>
+  [% END %]
+
+  [% FOREACH p = c.products %]
+    <tr>
+      <th align="right" valign="top">
+        <a href="[% target %]?product=[% p.name FILTER uri -%]
+              [%- IF cloned_bug_id %]&amp;cloned_bug_id=[% cloned_bug_id FILTER uri %][% END -%] 
+              [%- IF format %]&amp;format=[% format FILTER uri %][% END %]">
+        [% p.name FILTER html FILTER no_break %]</a>:&nbsp;
+      </th>
+
+      <td valign="top">[% p.description FILTER html_light %]</td>
+    </tr>
+  [% END %]
+
+  <tr>
+    <th colspan="2">&nbsp;</th>
+  </tr>
+[% END %]
+
+</table>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/global/code-error.html.tmpl b/template/en/default/global/code-error.html.tmpl
new file mode 100644 (file)
index 0000000..65a484b
--- /dev/null
+++ b/template/en/default/global/code-error.html.tmpl
@@ -0,0 +1,460 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # header_done: boolean. True if the header has already been printed.
+  # error: string. The tag of the error.
+  # variables: hash. Useful data about the problem. The keys are the variable
+  #  names, and the values the variable values.
+  #%]
+
+[%# This is a list of all the possible code errors. Please keep them in
+  # alphabetical order by error tag, and leave a blank line between errors.
+  #
+  # Note that you must explicitly filter every single template variable
+  # in this file; if you do not wish to change it, use the "none" filter.
+  #%]
+
+[% DEFAULT title = "Internal Error" %]
+
+[% error_message = BLOCK %]
+  [% IF error == "auth_invalid_email" %]
+    [% title = "Invalid Email Address" %]
+    We received an email address (<b>[% addr FILTER html %]</b>)
+    that didn't pass our syntax checking for a legal email address,
+    when trying to create or update your account.
+    [% IF default %]
+      A legal address must contain exactly one '@',
+      and at least one '.' after the @.
+    [% ELSE %]
+      [%+ Param('emailregexpdesc') FILTER html_light %]
+    [% END %]
+    It also must not contain any illegal characters.
+
+  [% ELSIF error == "authres_unhandled" %]
+    The result value of [% value FILTER html %] was not handled by
+    the login code.
+
+  [% ELSIF error == "bad_arg" %]
+    Bad argument <code>[% argument FILTER html %]</code> sent to
+    <code>[% function FILTER html %]</code> function.
+
+  [% ELSIF error == "bug_error" %]
+    Trying to retrieve [% terms.bug %] [%+ bug.bug_id FILTER html %] returned 
+    the error [% bug.error FILTER html %].
+    
+  [% ELSIF error == "chart_data_not_generated" %]
+    [% admindocslinks = {'extraconfig.html' => 'Setting up Charting'} %]
+    [% IF product %]
+      Charts for the <em>[% product FILTER html %]</em> product are not
+      available yet because no charting data has been collected for it since it
+      was created.
+    [% ELSE %]
+      No charting data has been collected yet.
+    [% END %]
+    Please wait a day and try again.
+    If you're seeing this message after a day, then you should contact
+    <a href="mailto:[% Param('maintainer') %]">[% Param('maintainer') %]</a>
+    and reference this error.
+
+  [% ELSIF error == "chart_datafile_corrupt" %]
+    The chart data file [% file FILTER html %] is corrupt.
+        
+  [% ELSIF error == "chart_dir_nonexistent" %]
+    One of the directories <tt>[% dir FILTER html %]</tt> and 
+    <tt>[% graph_dir FILTER html %]</tt> does not exist.
+  
+  [% ELSIF error == "chart_file_open_fail" %]
+    Unable to open the chart datafile <tt>[% filename FILTER html %]</tt>.
+ 
+  [% ELSIF error == "column_alter_nonexistent_fk" %]
+    You attempted to modify the foreign key for 
+    [%+ table FILTER html %].[% column FILTER html %], but there is
+    no foreign key on that column.
+ 
+  [% ELSIF error == "column_not_null_without_default" %]
+    Failed adding the column [% name FILTER html %]:
+    You cannot add a NOT NULL column with no default to an existing table
+    unless you specify something for the <code>$init_value</code> argument.
+
+  [% ELSIF error == "column_not_null_no_default_alter" %]
+    You cannot alter the [% name FILTER html %] column to be NOT NULL 
+    without specifying a default or something for $set_nulls_to, because
+    there are NULL values currently in it.
+
+  [% ELSIF error == "comment_extra_data_not_allowed" %]
+    You tried to set the <code>extra_data</code> field to 
+    '[% extra_data FILTER html %]' but comments of type [% type FILTER html %]
+    do not accept an <code>extra_data</code> argument.
+
+  [% ELSIF error == "comment_extra_data_required" %]
+    Comments of type [% type FILTER html %] require an <code>extra_data</code>
+    argument to be set.
+
+  [% ELSIF error == "comment_extra_data_not_numeric" %]
+    You tried to set the <code>extra_data</code> field to
+    '[% extra_data FILTER html %]' but comments of type [% type FILTER html %]
+    require a numeric <code>extra_data</code> argument.
+
+  [% ELSIF error == "comment_type_invalid" %]
+    '[% type FILTER html %]' is not a valid comment type.
+
+  [% ELSIF error == "db_rename_conflict" %]
+    Name conflict: Cannot rename [% old FILTER html %] to
+    [%+ new FILTER html %] because [% new FILTER html %] already exists.
+
+  [% ELSIF error == "cookies_need_value" %]
+    Every cookie must have a value.
+
+  [% ELSIF error == "env_no_email" %]
+    [% terms.Bugzilla %] did not receive an email address from the 
+    environment.
+    [% IF Param("auth_env_email") %]
+      This means that the '[% Param("auth_env_email") FILTER html %]'
+      environment variable was empty or did not exist.
+    [% ELSE %]
+      You need to set the "auth_env_email" parameter to the name of
+      the environment variable that will contain the user's email
+      address.
+    [% END %]
+
+  [% ELSIF error == "extension_must_be_subclass" %]
+    <code>[% package FILTER html %]</code> from 
+    <code>[% filename FILTER html %]</code> is not a subclass of
+    <code>[% class FILTER html %]</code>.
+
+  [% ELSIF error == "extension_must_return_name" %]
+    <code>[% extension FILTER html %]</code> returned
+    <code>[% returned FILTER html %]</code>, which is not a valid name
+    for an extension. Extensions must return their name, not <code>1</code>
+    or a number. See the documentation of
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/Extension.html">Bugzilla::Extension</a>
+    for details.
+
+  [% ELSIF error == "extension_no_name" %]
+    We did not find a <code>NAME</code> method in 
+    <code>[% package FILTER html %]</code> (loaded from
+    <code>[% filename FILTER html %]</code>). This means that
+    the extension has one or more of the following problems:
+
+    <ul>
+      <li><code>[% filename FILTER html %]</code> did not define a
+        <code>[% package FILTER html %]</code> package.</li>
+      <li><code>[% package FILTER html %]</code> did not define a
+        <code>NAME</code> method (or the <code>NAME</code> method
+        returned an empty string).</li>
+    </ul>
+
+  [% ELSIF error == "extern_id_conflict" %]
+    The external ID '[% extern_id FILTER html %]' already exists
+    in the database for '[% username FILTER html %]', but your
+    account source says that '[% extern_user FILTER html %]' has that ID.
+
+  [% ELSIF error == "field_choice_must_use_type" %]
+    When you call a class method on <code>Bugzilla::Field::Choice</code>,
+    you must call <code>Bugzilla::Field::Choice-&gt;type('some_field')</code>
+    to generate the right class (you can't call class methods directly
+    on Bugzilla::Field::Choice).
+
+  [% ELSIF error == "field_not_custom" %]
+    '[% field.description FILTER html %]' ([% field.name FILTER html %])
+    is not a custom field.
+
+  [% ELSIF error == "field_type_not_specified" %]
+    [% title = "Field Type Not Specified" %]
+    You must specify a type when creating a custom field.
+
+  [% ELSIF error == "illegal_field" %]
+    A legal [% field FILTER html %] was not set.
+
+  [% ELSIF error == "invalid_customfield_type" %]
+    [% title = "Invalid Field Type" %]
+    The type <em>[% type FILTER html %]</em> is not a valid field type.
+
+  [% ELSIF error == "invalid_feature" %]
+    [% title = "Invalid Feature Name" %]
+    [% feature FILTER html %] is not a valid feature name. See
+    <code>OPTIONAL_MODULES</code> in 
+    <code>Bugzilla::Install::Requirements</code> for valid names.
+
+  [% ELSIF error == "invalid_flag_association" %]
+    [% title = "Invalid Flag Association" %]
+    Some flags do not belong to
+    [% IF attach_id %]
+      attachment [% attach_id FILTER html %].
+    [% ELSE %]
+      [%+ terms.bug %] [%+ bug_id FILTER html %].
+    [% END %]
+
+  [% ELSIF error == "invalid_series_id" %]
+    [% title = "Invalid Series" %]
+    The series_id [% series_id FILTER html %] is not valid. It may be that
+    this series has been deleted.
+
+  [% ELSIF error == "invalid_timestamp" %]
+    The entered timestamp <code>[% timestamp FILTER html %]</code> could not
+    be parsed into a valid date and time.
+
+  [% ELSIF error == "invalid_webservergroup" %]
+    There is no such group: [% group FILTER html %]. Check your $webservergroup
+    setting in [% constants.bz_locations.localconfig FILTER html %].
+
+  [% ELSIF error == "flag_unexpected_object" %]
+    [% title = "Object Not Recognized" %]
+    Flags cannot be set for objects of type [% caller FILTER html %].
+    They can only be set for [% terms.bugs %] and attachments.
+
+  [% ELSIF error == "flag_type_inactive" %]
+    [% title = "Inactive Flag Type" %]
+    The flag type [% type FILTER html %] is inactive and cannot be used
+    to create new flags.
+
+  [% ELSIF error == "flag_type_target_type_invalid" %]
+    The target type was neither <em>[% terms.bug %]</em> nor <em>attachment</em>
+    but rather <em>[% target_type FILTER html %]</em>.
+  
+  [% ELSIF error == "invalid_field_name" %]
+    Can't use [% field FILTER html %] as a field name.
+
+  [% ELSIF error == "jobqueue_insert_failed" %]
+   [% title = "Job Queue Failure" %]
+    Inserting a <code>[% job FILTER html %]</code> job into the Job 
+    Queue failed with the following error: [% errmsg FILTER html %]
+
+  [% ELSIF error == "jobqueue_no_job_mapping" %]
+    <code>Bugzilla::JobQueue</code> has not been configured to handle
+    the job "[% job FILTER html %]".  You need to add this job type
+    to the <code>JOB_MAP</code> constant in <code>Bugzilla::JobQueue</code>,
+    perhaps by using the 'job_map' hook.
+
+  [% ELSIF error == "ldap_bind_failed" %]
+    Failed to bind to the LDAP server. The error message was: 
+    <code>[% errstr FILTER html %]</code>
+
+  [% ELSIF error == "ldap_cannot_retreive_attr" %]
+    The specified LDAP attribute [% attr FILTER html %] was not found.
+
+  [% ELSIF error == "ldap_connect_failed" %]
+    Could not connect to the LDAP server(s) <code>[% server FILTER html %]</code>.
+
+  [% ELSIF error == "ldap_start_tls_failed" %]
+    Could not start TLS with LDAP server: <code>[% error FILTER html %]</code>.
+
+  [% ELSIF error == "ldap_search_error" %]
+    An error occurred while trying to search LDAP for 
+    &quot;[% username FILTER html %]&quot;: 
+    [% IF errstr %]
+      <code>[% errstr FILTER html %]</code>
+    [% ELSE %]
+      Unable to find user in LDAP
+    [% END %]
+
+  [% ELSIF error == "ldap_server_not_defined" %]
+    The LDAP server for authentication has not been defined.
+
+  [% ELSIF error == "mail_send_error" %]
+    There was an error sending mail from '[% mail.header('From') FILTER html %]'
+    to '[% mail.header('To') FILTER html %]':
+    [%+ msg FILTER html %]
+
+  [% ELSIF error == "missing_series_id" %]
+    Having inserted a series into the database, no series_id was returned for
+    it. Series: [% series.category FILTER html %] / 
+    [%+ series.subcategory FILTER html %] / 
+    [%+ series.name FILTER html %].
+
+  [% ELSIF error == "object_dep_sort_loop" %]
+    There is a loop in VALIDATOR_DEPENDENCIES involving
+    '[%+ field FILTER html %]'. Here are the fields we considered:
+    [%+ considered.join(', ') FILTER html %].
+
+  [% ELSIF error == "param_invalid" %]
+    [% title = "Invalid Parameter" %]
+    <code>[% param FILTER html %]</code> is not a valid parameter
+    for the [% function FILTER html %] function.
+
+  [% ELSIF error == "param_must_be_numeric" %]
+    [% title = "Invalid Parameter" %]
+    Invalid parameter <code>[% param FILTER html %]</code> passed to 
+    <code>[% function FILTER html %]</code>: It must be numeric.
+
+  [% ELSIF error == "param_required" %]
+    [% title = "Missing Parameter" %]
+    The function <code>[% function FILTER html %]</code> requires
+    a <code>[% param FILTER html %]</code> argument, and that
+    argument was not set.
+
+  [% ELSIF error == "params_required" %]
+    [% title = "Missing Parameter" %]
+    The function <code>[% function FILTER html %]</code> requires
+    that you set one of the following parameters:
+    <code>[% params.join(', ') FILTER html %]</code>
+
+  [% ELSIF error == "product_empty_group_controls" %]
+    [% title = "Missing Group Controls" %]
+    New settings must be defined to edit group controls for
+    the [% group.name FILTER html %] group.
+
+  [% ELSIF error == "product_illegal_group_control" %]
+    [% title = "Illegal Group Control" %]
+    '[% value FILTER html %]' is not a legal value for
+    the '[% field FILTER html %]' field.
+
+  [% ELSIF error == "protection_violation" %]
+    The function <code>[% function FILTER html %]</code> was called
+
+    [% IF argument %]
+        with the argument <code>[% argument FILTER html %]</code>
+    [% END %]
+
+    from
+   
+    [% IF caller %]
+        <code>[%+ caller FILTER html %]</code>, which is
+    [% END %]
+
+    outside the package. This function may only be called from
+    a subclass of <code>[% superclass FILTER html %]</code>.
+
+  [% ELSIF error == "radius_preparation_error" %]
+    An error occurred while preparing for a RADIUS authentication request:
+    <code>[% errstr FILTER html %]</code>.
+
+  [% ELSIF error == "search_cp_without_op" %]
+    Search argument f[% id FILTER html %] is "CP" but there is no
+    matching "OP" before it.
+
+  [% ELSIF error == "search_invalid_joiner" %]
+    '[% joiner FILTER html %]' is not a valid joiner for a search.
+
+  [% ELSIF error == "setting_info_invalid" %]
+    To create a new setting, you must supply a setting name, a list of 
+    value/sortindex pairs, and the default value.
+
+  [% ELSIF error == "setting_name_invalid" %]
+    The setting name <em>[% name FILTER html %]</em> is not a valid
+    option. Setting names must begin with a letter, and contain only
+    letters, digits, or the symbols '_', '-', '.', or ':'.
+
+  [% ELSIF error == "setting_subclass_invalid" %]
+    There is no such Setting subclass as
+    <code>[% subclass FILTER html %]</code>.
+
+  [% ELSIF error == "setting_value_invalid" %]
+    The value "<code>[% value FILTER html %]</code>" is not in the list of
+    legal values for the <em>[% name FILTER html %]</em> setting.
+
+  [% ELSIF error == "token_generation_error" %]
+    Something is seriously wrong with the token generation system.
+
+  [% ELSIF error == "template_error" %]
+    [% template_error_msg FILTER html %]
+
+  [% ELSIF error == "template_invalid" %]
+    Template with invalid file name found in hook call: [% name FILTER html %].
+
+  [% ELSIF error == "unable_to_retrieve_password" %]
+     I was unable to retrieve your old password from the database.
+
+  [% ELSIF error == "undefined_field" %]
+    Form field [% field FILTER html %] was not defined.
+    
+  [% ELSIF error == "unknown_method" %]
+    The requested method '[% method FILTER html %]' was not found.
+
+  [% ELSIF error == "usage_mode_invalid" %]
+    '[% invalid_usage_mode FILTER html %]' is not a valid usage mode.
+
+  [% ELSIF error == "must_be_patch" %]
+    [% title = "Attachment Must Be Patch" %]
+    Attachment #[% attach_id FILTER html %] must be a patch.
+
+  [% ELSIF error == "not_in_transaction" %]
+    Attempted to end transaction without starting one first.
+
+  [% ELSIF error == "invalid_post_bug_submit_action" %]
+    Invalid setting for post_bug_submit_action
+
+  [% ELSIF error == "search_field_operator_unsupported" %]
+    [% terms.Bugzilla %] does not support the search type
+    "[% operator FILTER html %]".
+
+  [% ELSE %]
+    [%# Try to find hooked error messages %]
+    [% error_message = Hook.process("errors") %]
+    [% IF NOT error_message %]
+      [% title = "Internal error" %]
+      An internal error has occurred, but [% terms.Bugzilla %] doesn't know
+      what <code>[% error FILTER html %]</code> means.
+
+      If you are a [% terms.Bugzilla %] end-user seeing this message, please save
+      this page and send it to [% Param('maintainer') %].
+    [% ELSE %]
+      [% error_message FILTER none %]
+    [% END %]
+  [% END %]
+[% END %]
+
+[%# We only want HTML error messages for ERROR_MODE_WEBPAGE %]
+[% USE Bugzilla %]
+[% IF Bugzilla.error_mode != constants.ERROR_MODE_WEBPAGE %]
+  [% IF Bugzilla.usage_mode == constants.USAGE_MODE_BROWSER %]
+    [% error_message FILTER none %]
+  [% ELSE %]
+    [% error_message FILTER txt %]
+  [% END %]
+  [% RETURN %]
+[% END %]
+
+[% UNLESS header_done %]
+  [% PROCESS global/header.html.tmpl %]
+[% END %]
+
+[% PROCESS global/docslinks.html.tmpl
+   docslinks      = docslinks
+   admindocslinks = admindocslinks
+%]
+
+<p>
+  An unexpected error occurred. This could be a temporary problem, or some code
+  is behaving incorrectly. If this problem persists, please email this page
+  to <a href="mailto:[% Param("maintainer") %]">[% Param("maintainer") %]</a>
+  with details of what you were doing at the time this message appeared.
+</p>
+
+<tt>
+  <script type="text/javascript"> <!--
+    document.write("<p>URL: " + 
+                    document.location.href.replace(/&/g,"&amp;")
+                                          .replace(/</g,"&lt;")
+                                          .replace(/>/g,"&gt;") + "</p>");
+  // -->
+  </script>
+</tt>
+
+<table cellpadding="20">
+  <tr>
+    <td id="error_msg" class="throw_error">
+      [% error_message FILTER none %]
+    </td>
+  </tr>
+</table>
+
+<p>Traceback:</p>
+<pre>[% traceback FILTER html %]</pre>
+
+[% IF variables %]
+  <pre>
+Variables:
+  [% FOREACH key = variables.keys %]
+    [%+ key FILTER html %]: [%+ variables.$key FILTER html %]
+  [% END %]
+  </pre>
+[% END %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/global/common-links.html.tmpl b/template/en/default/global/common-links.html.tmpl
new file mode 100644 (file)
index 0000000..800fd59
--- /dev/null
+++ b/template/en/default/global/common-links.html.tmpl
@@ -0,0 +1,111 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% DEFAULT qs_suffix = "" %]
+[% USE Bugzilla %]
+
+<ul class="links">
+  <li><a href="./">Home</a></li>
+  <li><span class="separator">| </span><a href="enter_bug.cgi">New</a></li>
+  <li><span class="separator">| </span><a href="describecomponents.cgi">Browse</a></li>
+  <li><span class="separator">| </span><a href="query.cgi">Search</a></li>
+
+  <li class="form">
+    <span class="separator">| </span>
+    <form action="buglist.cgi" method="get"
+        onsubmit="if (this.quicksearch.value == '')
+                  { alert('Please enter one or more search terms first.');
+                    return false; } return true;">
+    <input type="hidden" id="no_redirect[% qs_suffix FILTER html %]" name="no_redirect" value="0">
+    <script type="text/javascript">
+      if (history && history.replaceState) {
+        var no_redirect = document.getElementById("no_redirect[% qs_suffix FILTER js %]");
+        no_redirect.value = 1;
+      }
+    </script>
+    <input class="txt" type="text" id="quicksearch[% qs_suffix FILTER html %]" name="quicksearch" 
+           title="Quick Search" value="[% quicksearch FILTER html %]">
+    <input class="btn" type="submit" value="Search" 
+           id="find[% qs_suffix FILTER html %]">
+    [%-# Work around FF bug: keep this on one line %]</form>
+  <a href="page.cgi?id=quicksearch.html" title="Quicksearch Help">[?]</a></li>
+
+  <li><span class="separator">| </span><a href="report.cgi">Reports</a></li>
+
+  <li>
+    [% IF Param('shutdownhtml') || Bugzilla.has_flags %]
+      <span class="separator">| </span>
+      [% IF user.id %]
+        <a href="request.cgi?requester=[% user.login FILTER uri %]&amp;requestee=
+                 [% user.login FILTER uri %]&amp;do_union=1&amp;group=type&amp;action=queue">My Requests</a>
+      [% ELSE %]
+        <a href="request.cgi">Requests</a>
+      [% END %]
+    [% END %]
+  [%-# Work around FF bug: keep this on one line %]</li>
+
+  [% IF user.login %]
+    <li><span class="separator">| </span><a href="userprefs.cgi">Preferences</a></li>
+    [% IF user.in_group('tweakparams') || user.in_group('editusers') || user.can_bless
+          || (Param('useclassification') && user.in_group('editclassifications'))
+          || user.in_group('editcomponents') || user.in_group('admin') || user.in_group('creategroups')
+          || user.in_group('editkeywords') || user.in_group('bz_canusewhines')
+          || user.get_products_by_permission("editcomponents").size %]
+      <li><span class="separator">| </span><a href="admin.cgi">Administration</a></li>
+    [% END %]
+
+    [% PROCESS link_to_documentation %]
+
+    <li>
+      <span class="separator">| </span>
+      [% IF user.authorizer.can_logout %]
+        <a href="index.cgi?logout=1">Log&nbsp;out</a>
+      [% ELSE %]
+        Logged&nbsp;in&nbsp;as
+      [% END %]
+      [% IF sudoer %]
+        [%+ sudoer.login FILTER html %] (<b>impersonating
+        [%+ user.login FILTER html %]</b>
+        <a href="relogin.cgi?action=end-sudo">end session</a>)
+      [% ELSE %]
+        [%+ user.login FILTER html %]
+      [% END %]
+    [%-# Work around FF bug: keep this on one line %]</li>
+  [% ELSE %]
+  
+    [% PROCESS link_to_documentation %]
+    
+    [% IF Param('createemailregexp')
+          && user.authorizer.user_can_create_account %]
+      <li id="new_account_container[% qs_suffix FILTER html %]">
+        <span class="separator">| </span>
+        <a href="createaccount.cgi">New&nbsp;Account</a>
+      </li>
+    [% END %]
+
+    [%# Only display one login form when we're on a LOGIN_REQUIRED page. That
+      # way, we're guaranteed that the user will use the form that has 
+      # hidden_fields in it (the center form) instead of this one. Also, it's
+      # less confusing to have one form (as opposed to  three) when you're 
+      # required to log in.
+      #%]
+    [% IF user.authorizer.can_login && !Bugzilla.page_requires_login %]
+      [% PROCESS "account/auth/login-small.html.tmpl" %]
+    [% END %]
+  [% END %]
+</ul>
+
+[% Hook.process("link-row") %]
+[% BLOCK link_to_documentation %]
+    [% IF doc_section && Param('docs_urlbase') %]
+      <li>
+        <span class="separator">| </span>
+        <a href="[% docs_urlbase _ doc_section FILTER html %]" target="_blank">Help</a>
+      </li>
+    [% END %]
+[% END %]

diff --git a/template/en/default/global/confirm-action.html.tmpl b/template/en/default/global/confirm-action.html.tmpl
new file mode 100644 (file)
index 0000000..9d89d8c
--- /dev/null
+++ b/template/en/default/global/confirm-action.html.tmpl
@@ -0,0 +1,53 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # script_name: the script generating this warning.
+  # token: a valid token for the current action.
+  # reason: reason of the failure.
+  #%]
+
+[% PROCESS global/header.html.tmpl title = "Suspicious Action"
+                                   style_urls = ['skins/standard/global.css'] %]
+
+<div class="throw_error">
+<!--reason=[%reason FILTER html %]-->
+  [% IF reason == "expired_token" %]
+    Your changes have been rejected because you exceeded the time limit
+    of [% constants.MAX_TOKEN_AGE FILTER html %] days before submitting your
+    changes to [% script_name FILTER html %]. Your page may have been displayed
+    for too long, or old changes have been resubmitted by accident.
+
+  [% ELSIF reason == "missing_token" %]
+    It looks like you didn't come from the right page.
+    One reason could be that you entered the URL in the address bar of your
+    web browser directly, which should be safe. Another reason could be that
+    you clicked on a URL which redirected you here <b>without your consent</b>.
+
+  [% ELSIF reason == "invalid_token" %]
+    You submitted changes to [% script_name FILTER html %] with an invalid
+    token, which may indicate that someone tried to abuse you, for instance
+    by making you click on a URL which redirected you here <b>without your
+    consent</b>.
+  [% END %]
+  <p>
+    Are you sure you want to commit these changes?
+  </p>
+</div>
+
+<form name="check" id="check" method="post" action="[% script_name FILTER html %]">
+  [% PROCESS "global/hidden-fields.html.tmpl"
+             exclude="^(Bugzilla_login|Bugzilla_password|token)$" %]
+  <input type="hidden" name="token" value="[% token FILTER html %]">
+  <input type="submit" id="confirm" value="Yes, Confirm Changes">
+</form>
+
+<p><a href="index.cgi">No, throw away these changes</a> (you will be redirected
+to the home page).</p>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/global/confirm-user-match.html.tmpl b/template/en/default/global/confirm-user-match.html.tmpl
new file mode 100644 (file)
index 0000000..c31567a
--- /dev/null
+++ b/template/en/default/global/confirm-user-match.html.tmpl
@@ -0,0 +1,191 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # fields: hash/record; the fields being matched, each of which has:
+  #     type: single|multi: whether or not the user can select multiple matches
+  #     flag_type: for flag requestee fields, the type of flag being requested
+  # matches: hash; Hierarchical.  The levels go like this:
+  #     field_name {
+  #         pattern_text {
+  #             'users'  = @user_list           (user objects)
+  #             'status' = success|fail|trunc   (result of search.
+  #                             'trunc' (truncated) means max was reached)
+  #         }
+  #     }
+  # script: string; The name of the calling script, used to create a
+  #     self-referential URL
+  #%]
+
+[%# This lists fields which use the user auto-completion feature and which
+  # are not listed in field_descs. %]
+[% field_labels = { # Used by editcomponents.cgi
+                    "initialcc"               => "Default CC List",
+                    "initialowner"            => "Default Assignee",
+                    "initialqacontact"        => "Default QA Contact",
+                    # Used by process_bug.cgi
+                    "masscc"                  => "CC List",
+                    # Used by request.cgi
+                    "requester"               => "Requester",
+                    "requestee"               => "Requestee",
+                    # Used by userprefs.cgi
+                    "new_watchedusers"        => "Watch List",
+
+   }
+%]
+[% IF matchsuccess == 1 %]
+  [% PROCESS global/header.html.tmpl title="Confirm Match" %]
+
+  [% USE Bugzilla %]
+
+  <form method="post" 
+  [% IF script -%]
+    action="[% script %]"
+  [%- END -%]
+  [% IF Bugzilla.cgi.param("data") %]
+    enctype="multipart/form-data"
+  [% END %]
+  >
+
+  <p>
+    [% IF matchmultiple %]
+      [% terms.Bugzilla %] cannot make a conclusive match for one or more
+      of the names and/or email addresses you entered on the previous page.
+      <br>Please examine the lists of potential matches below and select the
+      ones you want,
+    [% ELSE %]
+      [% terms.Bugzilla %] is configured to require verification whenever
+      you enter a name or partial email address.
+      <br>Below are the names/addresses you entered and the matched accounts.
+      Please confirm that they are correct,
+    [% END %]
+    or go back to the previous page to revise the names you entered.
+  </p>
+[% ELSE %]
+  [% PROCESS global/header.html.tmpl title="Match Failed" %]
+  <p>
+    [% terms.Bugzilla %] was unable to make any match at all for one or more of
+    the names and/or email addresses you entered on the previous page.
+    [% IF !user.id %]
+      <b>Note: You are currently logged out. Only exact matches against e-mail
+      addresses will be performed.</b>
+    [% END %]
+  </p>
+  <p>Please go back and try other names or email addresses.</p>
+[% END %]
+
+  <table border="0">
+    <tr>
+      <td colspan="2">
+        <hr width="100%" size="1">
+      </td>
+    </tr>
+
+  [%# this is messy to allow later expansion %]
+
+  [% FOREACH field = matches %]
+    <tr>
+      <td align="left" valign="top">
+        [% PROCESS field_names field_name=field.key %]:
+      </td>
+      <td align="left" valign="top">
+          [% FOREACH query = field.value %]
+            <div class="user_match">
+              <b>[% query.key FILTER html %]</b>
+            [% IF query.value.users.size %]
+                [% IF query.value.users.size > 1 %]
+                  [% IF query.value.status == 'fail' %]
+                    <font color="#FF0000">
+                      matches multiple users.
+                    </font>
+                    Please go back and try again with a more specific
+                    name/address.
+                  [% ELSE %]
+                    [% IF query.value.status == 'trunc' %]
+                      matched
+                      more than the maximum
+                      of [% query.value.users.size %] users:<br>
+                    [% ELSE %]
+                      matched:<br>
+                    [% END %]
+                    <select name="[% field.key FILTER html %]"
+                     id="[% field.key FILTER html %]"
+                      [% IF fields.${field.key}.type == 'multi' %]
+                        multiple="multiple"
+                        [% IF query.value.users.size > 5 %]
+                         size="5"
+                        [% ELSE %]
+                         size="[% query.value.users.size %]"
+                        [% END %]
+                      [% END %]
+                    >
+                      [% FOREACH match = query.value.users %]
+                        <option value="[% match.login FILTER html %]">
+                         [%- match.identity FILTER html -%]
+                        </option>
+                      [% END %]
+                    </select>
+                  [% END %]
+                [% ELSE %]
+                  matched
+                  <b>[% query.value.users.0.identity FILTER html %]</b>
+                [% END %]
+            [% ELSE %]
+                [% IF query.key.length < 3 %]
+                  <font color="#FF0000">was too short for substring match
+                  (minimum 3 characters)</font>
+                [% ELSE %]
+                  <font color="#FF0000">did not match anything</font>
+                [% END %]
+            [% END %]
+            </div>
+        [% END %]
+      </td>
+    </tr>
+    <tr>
+      <td colspan="2">
+        <hr width="100%" size="1">
+      </td>
+    </tr>
+  [% END %]
+
+  </table>
+
+[% IF matchsuccess == 1 %]
+
+  [% SET exclude_these = ['Bugzilla_login', 'Bugzilla_password'] %]
+  [% FOREACH key IN matches.keys %]
+    [% exclude_these.push(key) IF cgi.param(key) == '' %]
+  [% END %]
+  [% SET exclude = '^' _ exclude_these.join('|') _ '$' %]
+  [% PROCESS "global/hidden-fields.html.tmpl" exclude = exclude %]
+
+  <p>
+    <input type="submit" id="continue" value="Continue">
+  </p>
+
+  </form>
+
+[% END %]
+
+[% PROCESS global/footer.html.tmpl %]
+
+
+[% BLOCK field_names %]
+
+  [% IF field_descs.$field_name %]
+    [% field_descs.$field_name FILTER html %]
+  [% ELSIF field_labels.$field_name %]
+    [% field_labels.$field_name FILTER html %]
+  [% ELSIF field_name.match("^requestee") %]
+    [% fields.${field_name}.flag_type.name FILTER html %] requestee
+  [% ELSE %]
+    [% field_name FILTER html %]
+  [% END %]
+
+[% END %]

diff --git a/template/en/default/global/docslinks.html.tmpl b/template/en/default/global/docslinks.html.tmpl
new file mode 100644 (file)
index 0000000..c2cc830
--- /dev/null
+++ b/template/en/default/global/docslinks.html.tmpl
@@ -0,0 +1,45 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # docslinks: hash. Hash keys will be used as text of the documentation links,
+  #            hash values will be used as links to the document, relative to
+  #            the main Bugzilla documentation directory.
+  #            Example: If you want a 'FAQ' link to point to, the "faq-general"
+  #            named anchor on faq.html, assign
+  #               { 'FAQ' => "faq.html#faq-general" }
+  #            to docslinks.
+  #            You may only link to sections by their given ID; it is not allowed
+  #            to link to a section which is not given an ID (thus getting
+  #            assigned an automatically generated ID). Otherwise, the link
+  #            would break on a recompilation of the documentation.
+  # admindocslinks: hash. Same as docslinks, but will only be displayed to
+  #                 members of the admin group.
+  #%]
+
+[% IF Param('docs_urlbase') &&
+      docslinks.keys.size || (admindocslinks.keys.size && user.in_group('admin')) %]
+  <div id="docslinks">
+    <h2>Related documentation</h2>
+    <ul>
+      [% IF user.in_group('admin') %]
+        [% PROCESS docslinkslist docstype = admindocslinks %]
+      [% END %]
+      [% PROCESS docslinkslist docstype = docslinks %]
+    </ul>
+  </div>
+[% END %]
+
+[% BLOCK docslinkslist %]
+  [% FOREACH docslink = docstype.keys %]
+    <li>
+      <a href="[% docs_urlbase FILTER html %]
+               [% docslink FILTER none %]">[% docstype.$docslink FILTER html %]</a>
+    </li>
+  [% END %]
+[% END %]

diff --git a/template/en/default/global/field-descs.none.tmpl b/template/en/default/global/field-descs.none.tmpl
new file mode 100644 (file)
index 0000000..f1e0747
--- /dev/null
+++ b/template/en/default/global/field-descs.none.tmpl
@@ -0,0 +1,142 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# Remember to PROCESS rather than INCLUDE this template. %]
+
+[% SET search_descs = {
+  "noop"           => "---",
+  "equals"         => "is equal to",
+  "notequals"      => "is not equal to",
+  "anyexact"       => "is equal to any of the strings",
+  "substring"      => "contains the string",
+  "casesubstring"  => "contains the string (exact case)",
+  "notsubstring"   => "does not contain the string",
+  "anywordssubstr" => "contains any of the strings",
+  "allwordssubstr" => "contains all of the strings",
+  "nowordssubstr"  => "contains none of the strings",
+  "regexp"         => "matches regular expression",
+  "notregexp"      => "does not match regular expression",
+  "lessthan"       => "is less than",
+  "lessthaneq"     => "is less than or equal to",
+  "greaterthan"    => "is greater than",
+  "greaterthaneq"  => "is greater than or equal to",
+  "anywords"       => "contains any of the words",
+  "allwords"       => "contains all of the words",
+  "nowords"        => "contains none of the words",
+  "changedbefore"  => "changed before",
+  "changedafter"   => "changed after",
+  "changedfrom"    => "changed from",
+  "changedto"      => "changed to",
+  "changedby"      => "changed by",
+  "matches"        => "matches",
+  "notmatches"      => "does not match",
+} %]
+
+[% field_types = { ${constants.FIELD_TYPE_UNKNOWN}       => "Unknown Type",
+                   ${constants.FIELD_TYPE_FREETEXT}      => "Free Text",
+                   ${constants.FIELD_TYPE_SINGLE_SELECT} => "Drop Down",
+                   ${constants.FIELD_TYPE_MULTI_SELECT}  => "Multiple-Selection Box",
+                   ${constants.FIELD_TYPE_TEXTAREA}      => "Large Text Box",
+                   ${constants.FIELD_TYPE_DATETIME}      => "Date/Time",
+                   ${constants.FIELD_TYPE_BUG_ID}        => "$terms.Bug ID",
+                } %]
+
+[% IF in_template_var %]
+  [% PROCESS "global/value-descs.none.tmpl" %]
+  [% SET vars.value_descs = value_descs %]
+  [% SET vars.terms = terms %]
+
+  [%# field_descs is loaded as a global template variable and cached
+    # across all templates--see VARIABLES in Bugzilla/Template.pm.
+    #%]
+  [% vars.field_descs = {
+    "[Bug creation]"          => "[$terms.Bug creation]",
+     "actual_time"             => "Actual Hours",
+     "alias"                   => "Alias",
+     "assigned_to"             => "Assignee",
+     "assigned_to_realname"    => "Assignee Real Name",
+     "attach_data.thedata"     => "Attachment data",
+     "attachments.description" => "Attachment description",
+     "attachments.filename"    => "Attachment filename",
+     "attachments.mimetype"    => "Attachment mime type",
+     "attachments.ispatch"     => "Attachment is patch",
+     "attachments.isobsolete"  => "Attachment is obsolete",
+     "attachments.isprivate"   => "Attachment is private",
+     "attachments.submitter"   => "Attachment creator",
+     "blocked"                 => "Blocks",
+     "bug_file_loc"            => "URL",
+     "bug_group"               => "Group",
+     "bug_id"                  => "$terms.Bug ID",
+     "bug_severity"            => "Severity",
+     "bug_status"              => "Status",
+     "changeddate"             => "Changed",
+     "cc"                      => "CC",
+     "classification"          => "Classification",
+     "cclist_accessible"       => "CC list accessible",
+     "commenter"               => "Commenter",
+     "component_id"            => "Component ID",
+     "component"               => "Component",
+     "content"                 => "Content",
+     "creation_ts"             => "Creation date",
+     "days_elapsed"            => "Days since $terms.bug changed",
+     "deadline"                => "Deadline",
+     "delta_ts"                => "Changed",
+     "dependson"               => "Depends on",
+     "dup_id"                  => "Duplicate",
+     "estimated_time"          => "Orig. Est.",
+     "everconfirmed"           => "Ever confirmed",
+     "flagtypes.name"          => "Flags",
+     "keywords"                => "Keywords",
+     "longdesc"                => "Comment",
+     "longdescs.count"         => "Number of Comments",
+     "longdescs.isprivate"     => "Comment is private",
+     "newcc"                   => "CC",
+     "op_sys"                  => "OS",
+     "opendate"                => "Opened",
+     "owner_idle_time"         => "Time Since Assignee Touched",
+     "percentage_complete"     => "%Complete",
+     "priority"                => "Priority",
+     "product_id"              => "Product ID",
+     "product"                 => "Product",
+     "qa_contact"              => "QA Contact",
+     "qa_contact_realname"     => "QA Contact Real Name",
+     "remaining_time"          => "Hours Left",
+     "rep_platform"            => "Hardware",
+     "reporter"                => "Reporter",
+     "reporter_accessible"     => "Reporter accessible",
+     "reporter_realname"       => "Reporter Real Name",
+     "requestees.login_name"   => "Flag Requestee",
+     "resolution"              => "Resolution",
+     "see_also"                => "See Also",
+     "setters.login_name"      => "Flag Setter",
+     "setting"                 => "Setting",
+     "settings"                => "Settings",
+     "short_desc"              => "Summary",
+     "short_short_desc"        => "Summary",
+     "status_whiteboard"       => "Whiteboard",
+     "tag"                     => "Tags",
+     "target_milestone"        => "Target Milestone",
+     "version"                 => "Version",
+     "work_time"               => "Hours Worked",
+  } %]
+
+  [%# Also include any custom fields or fields which don't have a
+      Description here, by copying their Description from the
+      database. If you want to override this for your language
+      or your installation, just use a hook. %]
+  [% UNLESS Param('shutdownhtml') %]
+    [% FOREACH bz_field = bug_fields.values %]
+      [% SET vars.field_descs.${bz_field.name} = bz_field.description
+         IF !vars.field_descs.${bz_field.name}.defined %]
+    [% END %]
+  [% END %]
+
+  [% PROCESS "bug/field-help.none.tmpl" %]
+[% END %]
+
+[% Hook.process("end") %]

diff --git a/template/en/default/global/footer.html.tmpl b/template/en/default/global/footer.html.tmpl
new file mode 100644 (file)
index 0000000..e161a06
--- /dev/null
+++ b/template/en/default/global/footer.html.tmpl
@@ -0,0 +1,36 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # This template has no interface. However, you must fulfill the interface to
+  # global/useful-links.html.tmpl.
+  #%]
+
+  [% Hook.process('main-end') %]
+</div>
+
+[%# Migration note: below this point, this file corresponds to the old Param
+  # 'footerhtml'
+  #%]
+
+<div id="footer">
+  <div class="intro">[% Hook.process('intro') %]</div>
+
+[%# Migration note: the old param 'blurbhtml' goes here %]
+
+[%# Migration note: useful-links.html.tmpl corresponds to %commandmenu% %]
+
+           [% PROCESS "global/useful-links.html.tmpl" %]
+
+  <div class="outro">[% Hook.process('outro') %]</div>
+</div>
+
+[% Hook.process("end") %]
+
+</body>
+</html>

diff --git a/template/en/default/global/header.html.tmpl b/template/en/default/global/header.html.tmpl
new file mode 100644 (file)
index 0000000..dceb44d
--- /dev/null
+++ b/template/en/default/global/header.html.tmpl
@@ -0,0 +1,313 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # (All the below interface elements are optional.)
+  # title: string. Page title.
+  # header: string. Main page header.
+  # subheader: string. Page subheader.
+  # header_addl_info: string. Additional header information.
+  # bodyclasses: array of extra CSS classes for the <body>
+  # onload: string. JavaScript code to run when the page finishes loading.
+  # javascript: string. Javascript to go in the header.
+  # javascript_urls: list. List of URLs to Javascript.
+  # style: string. CSS style.
+  # style_urls: list. List of URLs to CSS style sheets.
+  # message: string. A message to display to the user. May contain HTML.
+  # atomlink: Atom link URL, May contain HTML
+  #%]
+
+[% IF message %]
+  [% PROCESS global/messages.html.tmpl %]
+[% END %]
+
+[% DEFAULT
+  subheader = ""
+  header_addl_info = ""
+  onload = ""
+  style_urls = []
+  yui = []
+%]
+
+[% SET yui_css = {
+  autocomplete => 1,
+  calendar     => 1,
+  datatable    => 1,
+  button       => 1,
+} %]
+
+[%# Note: This is simple dependency resolution--you can't have dependencies
+  # that depend on each other. You have to specify all of a module's deps,
+  # if that module is going to be specified in "yui".
+  #%]
+[% SET yui_deps = {
+  autocomplete => ['json', 'connection', 'datasource'],
+  datatable    => ['json', 'connection', 'datasource', 'element'],
+} %]
+
+[%# When using certain YUI modules, we need to process certain
+  # extra JS templates.
+  #%]
+[% SET yui_templates = {
+  datatable => ['global/value-descs.js.tmpl'],
+} %]
+
+[%# These are JS URLs that are *always* on the page and come before
+  # every other JS URL.
+  #%]
+[% SET starting_js_urls = [
+    "js/yui/yahoo-dom-event/yahoo-dom-event.js",
+    "js/yui/cookie/cookie-min.js",
+] %]
+
+
+[%# We should be able to set the default value of the header variable
+  # to the value of the title variable using the DEFAULT directive,
+  # but that doesn't work if a caller sets header to the empty string
+  # to avoid header inheriting the value of title, since DEFAULT
+  # mistakenly treats empty strings as undefined and gives header the
+  # value of title anyway.  To get around that problem we explicitly
+  # set header's default value here only if it is undefined. %]
+[% IF !header.defined %][% header = title %][% END %]
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+                      "http://www.w3.org/TR/html4/loose.dtd">
+<html lang="en">
+  <head>
+    [% Hook.process("start") %]
+    <title>[% title %]</title>
+
+    [% IF Param('utf8') %]
+      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+    [% END %]
+
+[%# Migration note: contents of the old Param 'headerhtml' would go here %]
+
+    [% PROCESS "global/site-navigation.html.tmpl" %]
+
+    [% PROCESS 'global/setting-descs.none.tmpl' %]
+
+    [% SET yui = yui_resolve_deps(yui, yui_deps) %]
+    [% SET css_sets = css_files(style_urls, yui, yui_css) %]
+
+    [%# CSS cascade, parts 1 & 2: YUI & Standard Bugzilla stylesheet set (persistent).
+      # Always present. %]
+    <link href="[% 'skins/standard/global.css' FILTER mtime FILTER html %]"
+          rel="alternate stylesheet" 
+          title="[% setting_descs.standard FILTER html %]">
+    [% FOREACH style_url = css_sets.standard %]
+      [% PROCESS format_css_link css_set_name = 'standard' %]
+    [% END %]
+
+    [%# CSS cascade, part 3: Third-party stylesheet set, per user prefs. %]
+    [% FOREACH style_url = css_sets.skin %]
+      [% PROCESS format_css_link css_set_name = user.settings.skin.value %]
+    [% END %]
+
+    [%# CSS cascade, part 4: page-specific styles. %]
+    [% IF style %]
+      <style type="text/css">
+        [% style %]
+      </style>
+    [% END %]
+
+    [%# CSS cascade, part 5: Custom Bugzilla stylesheet set (persistent).
+      # Always present. Site administrators may override all other style
+      # definitions, including skins, using custom stylesheets.
+      #%]
+    [% FOREACH style_url = css_sets.custom %]
+      [% PROCESS format_css_link css_set_name = 'standard' %]
+    [% END %]
+
+    [%# YUI Scripts %]
+    [% FOREACH yui_name = yui %]
+      [% starting_js_urls.push("js/yui/$yui_name/${yui_name}-min.js") %]
+    [% END %]
+    [% starting_js_urls.push('js/global.js') %]
+
+    [% FOREACH javascript_url = starting_js_urls %]
+      [% PROCESS format_js_link %]
+    [% END %]
+
+    <script type="text/javascript">
+    <!--
+        YAHOO.namespace('bugzilla');
+        YAHOO.util.Event.addListener = function (el, sType, fn, obj, overrideContext) {
+               if ( ("onpagehide" in window || YAHOO.env.ua.gecko) && sType === "unload") { sType = "pagehide"; };
+               var capture = ((sType == "focusin" || sType == "focusout") && !YAHOO.env.ua.ie) ? true : false;
+               return this._addListener(el, this._getType(sType), fn, obj, overrideContext, capture);
+         };
+        if ( "onpagehide" in window || YAHOO.env.ua.gecko) {
+            YAHOO.util.Event._simpleRemove(window, "unload", 
+                                           YAHOO.util.Event._unload);
+        }
+        [%# The language selector needs javascript to set its cookie,
+          # so it is hidden in HTML/CSS by the "bz_default_hidden" class.
+          # If the browser can run javascript, it will then "unhide"
+          # the language selector using the following code.
+          #%]
+        function unhide_language_selector() { 
+            YAHOO.util.Dom.removeClass(
+                'lang_links_container', 'bz_default_hidden'
+            ); 
+        } 
+        YAHOO.util.Event.onDOMReady(unhide_language_selector);
+
+        [%# Make some Bugzilla information available to all scripts. 
+          # We don't import every parameter and constant because we
+          # don't want to add a lot of uncached JS to every page. 
+          #%]
+        var BUGZILLA = {
+            param: {
+                cookiepath: '[% Param('cookiepath') FILTER js %]',
+                maxusermatches: [% Param('maxusermatches') FILTER js %]
+            },
+            constant: {
+                COMMENT_COLS: [% constants.COMMENT_COLS FILTER js %]
+            },
+            string: {
+                [%# Please keep these in alphabetical order. %]
+
+                attach_desc_required:
+                    'You must enter a Description for this attachment.',
+                component_required:
+                    'You must select a Component for this [% terms.bug %].',
+                description_required:
+                    'You must enter a Description for this [% terms.bug %].',
+                short_desc_required:
+                    'You must enter a Summary for this [% terms.bug %].',
+                version_required:
+                    'You must select a Version for this [% terms.bug %].'
+            }
+        };
+
+        [% FOREACH yui_name = yui %]
+          [% FOREACH yui_template = yui_templates.$yui_name %]
+            [% INCLUDE $yui_template %]
+          [% END %]
+        [% END %]
+        [% IF javascript %]
+          [% javascript %]
+        [% END %]
+    // -->
+    </script>
+
+    [% FOREACH javascript_url = javascript_urls %]
+      [% PROCESS format_js_link %]
+    [% END %]
+
+    [%# this puts the live bookmark up on firefox for the Atom feed %]
+    [% IF atomlink %]
+       <link rel="alternate" 
+             type="application/atom+xml" title="Atom feed" 
+             href="[% atomlink FILTER html %]">
+    [% END %]
+
+    [%# Required for the 'Autodiscovery' feature in Firefox 2 and IE 7. %]
+    <link rel="search" type="application/opensearchdescription+xml"
+                       title="[% terms.Bugzilla %]" href="./search_plugin.cgi">
+    <link rel="shortcut icon" href="images/favicon.ico" >
+    [% Hook.process("additional_header") %]
+  </head>
+
+[%# Migration note: contents of the old Param 'bodyhtml' go in the body tag,
+  # but set the onload attribute in the DEFAULT directive above.
+  #%]
+
+  <body onload="[% onload %]"
+        class="[% urlbase.replace('^https?://','').replace('/$','').replace('[-~@:/.]+','-') FILTER css_class_quote %]
+               [% FOREACH class = bodyclasses %]
+                 [% ' ' %][% class FILTER css_class_quote %]
+               [% END %] yui-skin-sam">
+
+[%# Migration note: the following file corresponds to the old Param
+  # 'bannerhtml'
+  #%]
+
+<div id="header">
+
+[% INCLUDE global/banner.html.tmpl %]
+
+<table border="0" cellspacing="0" cellpadding="0" id="titles">
+<tr>
+    <td id="title">
+      <p>[% terms.Bugzilla %]
+      [% " &ndash; $header" IF header %]</p>
+    </td>
+
+  [% IF subheader %]
+    <td id="subtitle">
+      <p class="subheader">[% subheader %]</p>
+    </td>
+  [% END %]
+
+  [% IF header_addl_info %]
+    <td id="information">
+      <p class="header_addl_info">[% header_addl_info %]</p>
+    </td>
+  [% END %]
+</tr>
+</table>
+
+<table id="lang_links_container" cellpadding="0" cellspacing="0"
+       class="bz_default_hidden"><tr><td>
+[% IF Bugzilla.languages.size > 1 %]
+  <ul class="links">
+  [% FOREACH lang = Bugzilla.languages.sort %]
+    <li>[% IF NOT loop.first %]<span class="separator"> | </span>[% END %]
+    [% IF lang == current_language %]
+      <span class="lang_current">[% lang FILTER html FILTER upper %]</span>
+    [% ELSE %]
+      <a href="#" onclick="set_language('[% lang FILTER none %]');">
+       [%- lang FILTER html FILTER upper %]</a>
+    [% END %]
+    </li>
+  [% END %]
+  </ul>
+[% END %]
+</td></tr></table>
+
+[% PROCESS "global/common-links.html.tmpl" qs_suffix = "_top" %]
+</div> [%# header %]
+
+<div id="bugzilla-body">
+
+[% IF Param('announcehtml') %]
+[% Param('announcehtml') FILTER none %]
+[% END %]
+
+[% IF message %]
+  <div id="message">[% message %]</div>
+[% END %]
+
+[% BLOCK format_css_link %]
+  [% IF style_url.match('/IE-fixes\.css') %]
+    <!--[if lte IE 7]>
+      [%# Internet Explorer treats [if IE] HTML comments as uncommented.
+        # We use it to import CSS fixes so that Bugzilla looks decent on IE 7
+        # and below.
+        #%]
+  [% END %]
+
+  [% IF css_set_name == 'standard' %]
+    [% SET css_title_link = '' %]
+  [% ELSE %]
+    [% css_title_link = BLOCK ~%]
+      title="[% setting_descs.${user.settings.skin.value} || user.settings.skin.value FILTER html %]"
+    [% END %]
+  [% END %]
+
+  <link href="[% style_url FILTER html %]" rel="stylesheet"
+        type="text/css" [% css_title_link FILTER none %]>
+
+  [% '<![endif]-->' IF style_url.match('/IE-fixes\.css') %]
+[% END %]
+
+[% BLOCK format_js_link %]
+  <script type="text/javascript" src="[% javascript_url FILTER mtime FILTER html %]"></script>
+[% END %]

diff --git a/template/en/default/global/hidden-fields.html.tmpl b/template/en/default/global/hidden-fields.html.tmpl
new file mode 100644 (file)
index 0000000..88d2673
--- /dev/null
+++ b/template/en/default/global/hidden-fields.html.tmpl
@@ -0,0 +1,46 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # exclude: string; a regular expression matching fields to exclude
+  #   from the list of hidden fields generated by this template
+  #%]
+
+[%# The global Bugzilla->cgi object is used to obtain form variable values. %]
+[% USE Bugzilla %]
+[% cgi = Bugzilla.cgi %]
+
+[%# Generate hidden form fields for non-excluded fields. %]
+[% FOREACH field = cgi.param() %]
+  [% NEXT IF exclude && field.search(exclude) %]
+  [%# The '.slice(0)' bit is here to force the 'param(field)' to be evaluated
+      in a list context, so we can avoid extra code checking for single valued or
+      empty fields %]
+  [% IF field == "data" && cgi.param("data") %]
+    <div class="box">
+      <p>
+        We were unable to store the file you uploaded because of incomplete information
+        in the form you just submitted. Because we are unable to retain the file between
+        form submissions, you must re-attach the file in addition to completing the
+        remaining missing information above.
+      </p>
+      <p>
+        Please re-attach the file <b>[% cgi.param(field) FILTER html %]</b> in
+        the field below:
+      </p>
+      <p>
+        <input type="file" id="data" name="data" size="50">
+      </p>
+    </div>
+  [% ELSE %]
+    [% FOREACH mvalue = cgi.param(field).slice(0) %]
+      <input type="hidden" name="[% field FILTER html %]"
+             value="[% mvalue FILTER html_linebreak %]">
+    [% END %]
+  [% END %]
+[% END %]

diff --git a/template/en/default/global/js-products.html.tmpl b/template/en/default/global/js-products.html.tmpl
new file mode 100644 (file)
index 0000000..e40a3e3
--- /dev/null
+++ b/template/en/default/global/js-products.html.tmpl
@@ -0,0 +1,21 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# The javascript block gets used in header.html.tmpl. %]
+[% javascript = BLOCK %]
+  var useclassification = false; // No classification level in use
+  var first_load = true; // Is this the first time we load the page?
+  var last_sel = []; // Caches last selection
+  var cpts = new Array();
+  [% n = 1 %]
+  [% FOREACH prod = products %]
+    cpts['[% n %]'] = [
+      [%- FOREACH comp = prod.components %]'[% comp.name FILTER js %]'[% ", " UNLESS loop.last %] [%- END -%] ];
+    [% n = n+1 %]
+  [% END %]
+[% END %]

diff --git a/template/en/default/global/message.html.tmpl b/template/en/default/global/message.html.tmpl
new file mode 100644 (file)
index 0000000..949fc1e
--- /dev/null
+++ b/template/en/default/global/message.html.tmpl
@@ -0,0 +1,28 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # url: string. An optional URL to go to.
+  # link: string. The link text for that URL.
+  #%]
+
+[% DEFAULT title = "$terms.Bugzilla Message" %]
+
+[% PROCESS global/header.html.tmpl %]
+
+[%# The "header" template automatically displays a message if it finds one.
+    Note that the global messages list is in messages.html.tmpl. %]
+
+[%# Display a URL if the calling script or message block has included one. %]
+[% IF url && link %]
+  <p>
+    <a href="[% url FILTER html %]">[% link FILTER html %]</a>
+  </p>
+[% END %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/global/message.txt.tmpl b/template/en/default/global/message.txt.tmpl
new file mode 100644 (file)
index 0000000..44694ee
--- /dev/null
+++ b/template/en/default/global/message.txt.tmpl
@@ -0,0 +1,12 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# Yes, this may show some HTML. But it's the best we
+  # can do at the moment. %]
+[% PROCESS global/messages.html.tmpl %]
+[% message FILTER txt %]

diff --git a/template/en/default/global/messages.html.tmpl b/template/en/default/global/messages.html.tmpl
new file mode 100644 (file)
index 0000000..95b74f1
--- /dev/null
+++ b/template/en/default/global/messages.html.tmpl
@@ -0,0 +1,929 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# This is a list of all the possible messages. Please keep them in
+  # alphabetical order by message tag, and leave a blank line between messages.
+  #%]
+
+[% message_tag = message %]
+
+[% message = BLOCK %]
+  [% IF    message_tag == "account_created" %]
+    The user account [% otheruser.login FILTER html %] has been created
+    successfully.
+    [% IF groups.size %]
+      You may want to edit the group settings now, using the form below.
+    [% END %]
+
+  [% ELSIF message_tag == "account_creation_canceled" %]
+    [% title = "User Account Creation Canceled" %]
+    The creation of the user account [% account FILTER html %] has been
+    canceled.
+
+  [% ELSIF message_tag == "account_updated" %]
+    [% IF changed_fields.size
+          + groups_added_to.size + groups_removed_from.size
+          + groups_granted_rights_to_bless.size + groups_denied_rights_to_bless.size %]
+      [% title = "User $loginold updated" %]
+      The following changes have been made to the user account
+      [%+ loginold FILTER html %]:
+      <ul>
+        [% FOREACH field = changed_fields %]
+          <li>
+            [% IF    field == 'login_name' %]
+              The login is now [% otheruser.login FILTER html %].
+            [% ELSIF field == 'realname' %]
+              The real name has been updated.
+            [% ELSIF field == 'cryptpassword' %]
+              A new password has been set.
+            [% ELSIF field == 'disabledtext' %]
+              The "login disabled" text has been modified.
+            [% ELSIF field == 'is_enabled' %]
+              Logging in with this user account has been [% otheruser.is_enabled ? 'enabled' : 'disabled' %].
+            [% ELSIF field == 'extern_id' %]
+              The user's External Login ID has been modified.
+            [% ELSIF field == 'disable_mail' %]
+              [% IF otheruser.email_disabled %]
+                [% terms.Bug %]mail has been disabled.
+              [% ELSE %]
+                [% terms.Bug %]mail has been enabled.
+              [% END %]
+            [% END %]
+          </li>
+        [% END %]
+        [% IF groups_added_to.size %]
+          <li>
+            The account has been added to the
+            [%+ groups_added_to.join(', ') FILTER html %]
+            group[% 's' IF groups_added_to.size > 1 %].
+          </li>
+        [% END %]
+        [% IF groups_removed_from.size %]
+          <li>
+            The account has been removed from the
+            [%+ groups_removed_from.join(', ') FILTER html %]
+            group[% 's' IF groups_removed_from.size > 1 %].
+          </li>
+        [% END %]
+        [% IF groups_granted_rights_to_bless.size %]
+          <li>
+            The account has been granted rights to bless the
+            [%+ groups_granted_rights_to_bless.join(', ') FILTER html %]
+            group[% 's' IF groups_granted_rights_to_bless.size > 1 %].
+          </li>
+        [% END %]
+        [% IF groups_denied_rights_to_bless.size %]
+          <li>
+            The account has been denied rights to bless the
+            [%+ groups_denied_rights_to_bless.join(', ') FILTER html %]
+            group[% 's' IF groups_denied_rights_to_bless.size > 1 %].
+          </li>
+        [% END %]
+      </ul>
+    [% ELSE %]
+      [% title = "User $otheruser.login not changed" %]
+      You didn't request any changes to the user's account
+      [%+ otheruser.login FILTER html %].
+    [% END %]
+
+  [% ELSIF message_tag == "account_deleted" %]
+    [% title = "User $otheruser.login deleted" %]
+    The user account [% otheruser.login FILTER html %] has been deleted
+    successfully.
+
+  [% ELSIF message_tag == "account_disabled" %]
+    Logging in with this user account [% account FILTER html %] is disabled, so
+    you cannot change its password.
+
+  [% ELSIF message_tag == "attachment_creation_failed" %]
+    The [% terms.bug %] was created successfully, but attachment creation
+    failed.
+    Please add your attachment by clicking the "Add an Attachment" link
+    below.
+
+  [% ELSIF message_tag == "bug_group_description" %]
+    Access to [% terms.bugs %] in the [% product.name FILTER html %] product
+
+  [% ELSIF message_tag == "buglist_adding_field" %]
+    [% title = "Adding field to search page..." %]
+    [% link  = "Click here if the page does not redisplay automatically." %]
+
+  [% ELSIF message_tag == "buglist_updated_named_query" %]
+    [% title = "Search updated" %]
+    Your search named <code><a 
+     href="buglist.cgi?cmdtype=runnamed&amp;namedcmd=[% queryname FILTER uri %]"
+    >[% queryname FILTER html %]</a></code> has been updated.
+
+  [% ELSIF message_tag == "buglist_new_default_query" %]
+    OK, you now have a new default search.  You may
+    also bookmark the result of any individual search.
+
+  [% ELSIF message_tag == "buglist_new_named_query" %]
+    [% title = "Search created" %]
+    OK, you have a new search named <code><a
+     href="buglist.cgi?cmdtype=runnamed&amp;namedcmd=[% queryname FILTER uri %]"
+    >[% queryname FILTER html %]</a></code>.
+
+  [% ELSIF message_tag == "buglist_query_gone" %]
+    [% title = "Search is gone" %]
+    [% link  = "Un-forget the search" %]
+    OK, the <b>[% namedcmd FILTER html %]</b> search is gone.
+
+  [% ELSIF message_tag == "buglist_sorted_by_relevance" %]
+    [% terms.Bugs %] on this list are sorted by relevance, with the most
+    relevant [% terms.bugs %] at the top.
+
+  [% ELSIF message_tag == "change_columns" %]
+    [% title = "Change columns" %]
+    Resubmitting your search with new columns...
+    Click <a href="[% redirect_url FILTER html %]">here</a>
+    if the page does not automatically refresh.
+
+  [% ELSIF message_tag == "classification_created" %]
+    [% title = "New Classification Created" %]
+    The <em>[% classification.name FILTER html %]</em> classification has been created.
+
+  [% ELSIF message_tag == "classification_deleted" %]
+    [% title = "Classification Deleted" %]
+    The <em>[% classification.name FILTER html %]</em> classification has been deleted.
+
+  [% ELSIF message_tag == "classification_updated" %]
+    [% title = "Classification Updated" %]
+    [% IF changes.keys.size %]
+      Changes to the <em>[% classification.name FILTER html %]</em> classification
+      have been saved:
+      <ul>
+        [% IF changes.name.defined %]
+          <li>Name updated to '[% classification.name FILTER html %]'</li>
+        [% END %]
+        [% IF changes.description.defined %]
+          [% IF classification.description %]
+            <li>Description updated to '[% classification.description FILTER html %]'</li>
+          [% ELSE %]
+            <li>Description removed</li>
+          [% END %]
+        [% END %]
+        [% IF changes.sortkey.defined %]
+          <li>Sortkey updated to '[% classification.sortkey FILTER html %]'</li>
+        [% END %]
+        [% Hook.process('classification_updated_fields') %]
+      </ul>
+    [% ELSE %]
+      No changes made to <em>[% classification.name FILTER html %]</em>.
+    [% END %]
+
+  [% ELSIF message_tag == "component_created" %]
+    [% title = "Component Created" %]
+    The component <em>[% comp.name FILTER html %]</em> has been created.
+
+  [% ELSIF message_tag == "component_deleted" %]
+    [% title = "Component Deleted" %]
+    The component <em>[% comp.name FILTER html %]</em> has been deleted.
+    [% IF comp.bug_count %]
+      All [% terms.bugs %] being in this component and all references
+      to them have also been deleted.
+    [% END %]
+
+  [% ELSIF message_tag == "component_updated" %]
+    [% title = "Component Updated" %]
+    [% IF changes.keys.size %]
+      Changes to the component <em>[% comp.name FILTER html %]</em> have been saved:
+      <ul>
+      [% IF changes.name.defined %]
+        <li>Name updated to '[% comp.name FILTER html %]'</li>
+      [% END %]
+      [% IF changes.description.defined %]
+        <li>Description updated to '[% comp.description FILTER html_light %]'</li>
+      [% END %]
+      [% IF changes.initialowner.defined %]
+        <li>Default assignee updated to '[% comp.default_assignee.login FILTER html %]'</li>
+      [% END %]
+      [% IF changes.initialqacontact.defined %]
+        [% IF comp.default_qa_contact %]
+          <li>Default QA contact updated to '[% comp.default_qa_contact.login FILTER html %]'</li>
+        [% ELSE %]
+          <li>Default QA contact deleted</li>
+        [% END %]
+      [% END %]
+      [% IF changes.cc_list.defined %]
+        [% IF comp.initial_cc.size %]
+          [% cc_list = [] %]
+          [% FOREACH cc_user = comp.initial_cc %]
+            [% cc_list.push(cc_user.login) %]
+          [% END %]
+          <li>Default CC list updated to [% cc_list.join(", ") FILTER html %]</li>
+        [% ELSE %]
+          <li>Default CC list deleted</li>
+        [% END %]
+      [% END %]
+      [% IF changes.isactive.defined %]
+        <li>[% comp.is_active ? "Enabled" : "Disabled" %] for [% terms.bugs %]</li>
+      [% END %]
+      [% Hook.process('component_updated_fields') %]
+      </ul>
+    [% ELSE %]
+      No changes made to <em>[% comp.name FILTER html %]</em>.
+    [% END %]
+
+  [% ELSIF message_tag == "custom_field_created" %]
+    [% title = "Custom Field Created" %]
+    The new custom field '[% field.name FILTER html %]' has been
+    successfully created.
+
+  [% ELSIF message_tag == "custom_field_deleted" %]
+    [% title = "Custom Field Deleted" %]
+    The custom field '[% field.name FILTER html %]' has been
+    successfully deleted.
+
+  [% ELSIF message_tag == "custom_field_updated" %]
+    [% title = "Custom Field Updated" %]
+    Properties of the '[% field.name FILTER html %]' field have been
+    successfully updated.
+
+  [% ELSIF message_tag == "default_settings_updated" %]
+    [% IF changes_saved %]
+      Changes to default preferences have been saved.
+    [% ELSE %]
+      No changes made.
+    [% END %]
+
+  [% ELSIF message_tag == "emailold_change_canceled" %]
+    [% title = "Cancel Request to Change Email Address" %]
+    The request to change the email address for your account to
+    [%+ new_email FILTER html %] has been canceled.
+
+  [% ELSIF message_tag == "email_change_canceled" %]
+    [% title = "Cancel Request to Change Email Address" %]
+    The request to change the email address for the
+    account [%+ old_email FILTER html %] to
+    [%+ new_email FILTER html %] has been canceled.
+
+  [% ELSIF message_tag == "email_change_canceled_reinstated" %]
+    [% title = "Cancel Request to Change Email Address" %]
+    The request to change the email address for the
+    account [%+ old_email FILTER html %] to 
+    [%+ new_email FILTER html %] has been canceled.
+    Your old account settings have been reinstated.
+
+  [% ELSIF message_tag == "extension_created" %]
+    An extension named [% name FILTER html %] has been created
+    in [% path FILTER html %].
+
+  [% ELSIF message_tag == "field_value_created" %]
+    [% title = "New Field Value Created" %]
+    The value <em>[% value.name FILTER html %]</em> has been added as a 
+    valid choice for the <em>[% field.description FILTER html %]</em>
+    (<em>[% field.name FILTER html %]</em>) field.
+    [% IF field.name == "bug_status" %]
+      You should now visit the <a href="editworkflow.cgi">status workflow 
+      page</a> to include your new [% terms.bug %] status.
+    [% END %]
+
+  [% ELSIF message_tag == "field_value_deleted" %]
+    [% title = "Field Value Deleted" %]
+    The value <em>[% value.name FILTER html %]</em> of the
+    <em>[% field.description FILTER html %]</em>
+    (<em>[% field.name FILTER html %]</em>) field has been deleted.
+
+  [% ELSIF message_tag == "field_value_updated" %]
+    [% title = "Field Value Updated" %]
+    [% IF changes.keys.size %]
+      The <em>[% value_old FILTER html %]</em> value of the
+      <em>[% field.description FILTER html %]</em>
+      (<em>[% field.name FILTER html %]</em>) field has been changed:
+      <ul>
+        [% IF changes.value %]
+          <li>Field value updated to 
+            <em>[% changes.value.1 FILTER html %]</em>.
+            [% IF value.is_default %]
+              (Note that this value is the default for this field. All
+              references to the default value will now point to this new value.)
+            [% END %]
+          </li>
+        [% END %]
+        [% IF changes.sortkey %]
+          <li>Sortkey updated to 
+            <em>[% changes.sortkey.1 FILTER html %]</em>.</li>
+        [% END %]
+        [% IF changes.visibility_value_id %]
+          [% IF value.visibility_value.defined %]
+            <li>It only appears when 
+              [%+ value.field.value_field.description FILTER html %] is set to
+              '[%+ value.visibility_value.name FILTER html %]'.</li>
+          [% ELSE %]
+            <li>It now always appears, no matter what 
+              [%+ value.field.value_field.description FILTER html %] is set to.
+            </li>
+          [% END %]
+        [% END %]
+      </ul>
+    [% ELSE %]
+      No changes made to the field value <em>[% value_old FILTER html %]</em>.
+    [% END %]
+
+  [% ELSIF message_tag == "flag_cleared" %]
+    Some flags didn't apply in the new product/component
+    and have been cleared.
+
+  [% ELSIF message_tag == "flag_creation_failed" %]
+    [% title = "Flag Creation Failure" %]
+    An error occured while validating flags:
+    [%+ flag_creation_error FILTER none %]
+
+  [% ELSIF message_tag == "get_field_desc" %]
+    [% field_descs.$field_name FILTER html %]
+
+  [% ELSIF message_tag == "get_resolution" %]
+    [% display_value("resolution", resolution) FILTER html %]
+
+  [% ELSIF message_tag == "get_status" %]
+    [% display_value("bug_status", status) FILTER html %]
+
+  [% ELSIF message_tag == "group_created" %]
+    [% title = "New Group Created" %]
+    The group <em>[% group.name FILTER html %]</em> has been created.
+
+  [% ELSIF message_tag == "group_deleted" %]
+    [% title = "Group Deleted" %]
+    The group <em>[% name FILTER html %]</em> has been deleted.
+
+  [% ELSIF message_tag == "group_membership_removed" %]
+    [% title = "Group Membership Removed" %]
+    [% IF users.size %]
+      Explicit membership to the <em>[% group FILTER html %]</em> group removed
+      [% IF regexp %] for users matching '[% regexp FILTER html %]'[% END %]:
+      [% FOREACH user = users %]
+        [%+ user.login FILTER html %]
+      [% END %]
+    [% ELSE %]
+      No users are being affected by your action.
+    [% END %]
+
+  [% ELSIF message_tag == "group_updated" %]
+    [% IF changes.keys.size %]
+      The following changes have been made to the '[% group.name FILTER html %]'
+      group:
+      <ul>
+      [% FOREACH field = changes.keys.sort %]
+        [% SWITCH field %]
+          [% CASE 'name' %]
+            <li>The name was changed to '[% changes.name.1 FILTER html %]'</li>
+          [% CASE 'description' %]
+            <li>The description was updated.</li>
+          [% CASE 'userregexp' %]
+            <li>The regular expression was updated.</li>
+          [% CASE 'isactive' %]
+            [% IF changes.isactive.1 %]
+              <li>The group will now be used for [% terms.bugs %].</li>
+            [% ELSE %]
+              <li>The group will no longer be used for [% terms.bugs %].</li>
+            [% END %]
+          [% CASE 'icon_url' %]
+            <li>The group icon URL has been updated.</li>
+          [% CASE 'members_add' %]
+            <li>The following groups are now members of this group:
+              [%+ changes.members_add.join(', ') FILTER html %]</li>
+          [% CASE 'members_remove' %]
+            <li>The following groups are no longer members of this group:
+              [%+ changes.members_remove.join(', ') FILTER html %]</li>
+          [% CASE 'member_of_add' %]
+            <li>This group is now a member of the following groups:
+              [%+ changes.member_of_add.join(', ') FILTER html %]</li>
+          [% CASE 'member_of_remove' %]
+            <li>This group is no longer a member of the following groups:
+              [%+ changes.member_of_remove.join(', ') FILTER html %]</li>
+          [% CASE 'bless_from_add' %]
+            <li>The following groups may now add users to this group:
+              [%+ changes.bless_from_add.join(', ') FILTER html %]</li>
+          [% CASE 'bless_from_remove' %]
+            <li>The following groups may no longer add users to this group:
+              [%+ changes.bless_from_remove.join(', ') FILTER html %]</li>
+          [% CASE 'bless_to_add' %]
+            <li>This group may now add users to the following groups:
+              [%+ changes.bless_to_add.join(', ') FILTER html %]</li>
+          [% CASE 'bless_to_remove' %]
+            <li>This group may no longer add users to the following groups:
+              [%+ changes.bless_to_remove.join(', ') FILTER html %]</li>
+          [% CASE 'visible_from_add' %]
+            <li>The following groups can now see users in this group:
+              [%+ changes.visible_from_add.join(', ') FILTER html %]</li>
+          [% CASE 'visible_from_remove' %]
+            <li>The following groups may no longer see users in this group:
+              [%+ changes.visible_from_remove.join(', ') FILTER html %]</li>
+          [% CASE 'visible_to_me_add' %]
+            <li>This group may now see users in the following groups:
+              [%+ changes.visible_to_me_add.join(', ') FILTER html %]</li>
+          [% CASE 'visible_to_me_remove' %]
+            <li>This group may no longer see users in the following groups:
+              [%+ changes.visible_to_me_remove.join(', ') FILTER html %]</li>
+          [% CASE %]
+            [% Hook.process('group_updated_fields') %]
+        [% END %]
+      [% END %]
+      </ul>
+    [% ELSE %]
+      You didn't request any change for the '[% group.name FILTER html %]'
+      group.
+    [% END %]
+
+  [% ELSIF message_tag == "invalid_column_name" %]
+    The custom sort order specified contains one or more invalid
+    column names: <em>[% invalid_fragments.join(', ') FILTER html %]</em>.
+    They have been removed from the sort list.
+
+  [% ELSIF message_tag == "job_queue_depth" %]
+    [% count FILTER html %] jobs in the queue.
+
+  [% ELSIF message_tag == "keyword_created" %]
+    [% title = "New Keyword Created" %]
+    The keyword <em>[% name FILTER html %]</em> has been created.
+
+  [% ELSIF message_tag == "keyword_deleted" %]
+    [% title = "Keyword Deleted" %]
+    The <em>[% keyword.name FILTER html %]</em> keyword has been deleted.
+
+  [% ELSIF message_tag == "keyword_updated" %]
+    [% title = "Keyword Updated" %]
+    [% IF changes.keys.size %]
+      Changes to the <em>[% keyword.name FILTER html %]</em> keyword have
+      been saved:
+      <ul>
+        [% IF changes.name.defined %]
+          <li>Keyword renamed to <em>[% keyword.name FILTER html %]</em>.</li>
+        [% END %]
+        [% IF changes.description.defined %]
+          <li>Description updated to <em>[% keyword.description FILTER html %]</em></li>
+        [% END %]
+      </ul>
+    [% ELSE %]
+      No changes made.
+    [% END %]
+
+  [% ELSIF message_tag == "logged_out" %]
+    [% title = "Logged Out" %]
+    [% url = "index.cgi?GoAheadAndLogIn=1" %]
+    [% link = "Log in again." %]
+    <b>You logged out successfully</b>.
+    The cookie that was remembering your login is now gone. You will be
+    prompted for a login the next time it is required.
+
+  [% ELSIF message_tag == "login_changed" %]
+    [% title = "$terms.Bugzilla Login Changed" %]
+    Your [% terms.Bugzilla %] login has been changed.
+
+  [% ELSIF message_tag == "migrate_component_created" %]
+    Component created: [% comp.name FILTER html %]
+    (in [% product.name FILTER html %])
+
+  [% ELSIF message_tag == "migrate_creating_bugs" %]
+    Creating [% terms.bugs %]...
+
+  [% ELSIF message_tag == "migrate_field_created" %]
+    New custom field: [% field.description FILTER html %]
+    ([% field.name FILTER html %])
+
+  [% ELSIF message_tag == "migrate_product_created" %]
+    Product created: [% created.name FILTER html %]
+
+  [% ELSIF message_tag == "migrate_reading_bugs" %]
+    Reading [% terms.bugs %]...
+
+  [% ELSIF message_tag == "migrate_reading_products" %]
+    Reading products...
+
+  [% ELSIF message_tag == "migrate_reading_users" %]
+    Reading users...
+
+  [% ELSIF message_tag == "migrate_translating_bugs" %]
+    Converting [% terms.bug %] values to be appropriate for 
+    [%+ terms.Bugzilla %]...
+
+  [% ELSIF message_tag == "migrate_user_created" %]
+    User created: [% created.email FILTER html %]
+    [% IF password %] Password: [% password FILTER html %][% END %]
+
+  [% ELSIF message_tag == "migrate_value_created" %]
+    [% IF product.defined %]
+      [% product.name FILTER html %]
+    [% END %]
+    [%+ field_descs.${field.name} FILTER html %] value
+    created: [% value FILTER html %]
+
+  [% ELSIF message_tag == "milestone_created" %]
+    [% title = "Milestone Created" %]
+    The milestone <em>[% milestone.name FILTER html %]</em> has been created.
+
+  [% ELSIF message_tag == "milestone_deleted" %]
+    [% title = "Milestone Deleted" %]
+    The milestone <em>[% milestone.name FILTER html %]</em> has been deleted.
+    [% IF milestone.bug_count %]
+      [%+ terms.Bugs %] targetted to this milestone have been retargetted to
+      the default milestone <em>[% product.default_milestone FILTER html %]</em>.
+    [% END %]
+
+  [% ELSIF message_tag == "milestone_updated" %]
+    [% title = "Milestone Updated" %]
+    [% IF changes.size %]
+      Changes to the milestone <em>[% milestone.name FILTER html %]</em>
+      have been saved:
+      <ul>
+        [% IF changes.value.defined %]
+          <li>Milestone name updated to <em>[% milestone.name FILTER html %]</em></li>
+        [% END %]
+        [% IF changes.sortkey.defined %]
+          <li>Sortkey updated to <em>[% milestone.sortkey FILTER html %]</em>
+        [% END %]
+        [% IF changes.isactive.defined %]
+          <li>[% milestone.is_active ? "Enabled" : "Disabled" %] for [% terms.bugs %]</li>
+        [% END %]
+      </ul>
+    [% ELSE %]
+      No changes made to milestone <em>[% milestone.name FILTER html %]</em>.
+    [% END %]
+
+  [% ELSIF message_tag == "parameters_updated" %]
+    [% title = "Parameters Updated" %]
+    [% IF param_changed.size > 0 %]
+      [% FOREACH param = param_changed %]
+        Changed <em>[% param FILTER html %]</em><br>
+        [% IF param == 'utf8' && Param('utf8') %]
+          <strong>You must now re-run <kbd>checksetup.pl</kbd>.</strong><br>
+        [% END %]
+      [% END %]
+    [% ELSE %]
+      No changes made.
+    [% END %]
+
+    [% IF shutdown_is_active == 1 %]
+      <hr>
+      [% terms.Bugzilla %] has now been shut down. To re-enable the system,
+      clear the <em>shutdownhtml</em> field.
+    [% END%]
+
+  [% ELSIF message_tag == "password_change_canceled" %]
+    [% title = "Cancel Request to Change Password" %]
+    Your request has been canceled.
+
+  [% ELSIF message_tag == "password_change_request" %]
+    [% title = "Request to Change Password" %]
+    A token for changing your password has been emailed to you.
+    Follow the instructions in that email to change your password.
+
+  [% ELSIF message_tag == "password_changed" %]
+    [% title = "Password Changed" %]
+    Your password has been changed.
+
+  [% ELSIF message_tag == "flag_type_created" %]
+    [% title = BLOCK %]Flag Type '[% name FILTER html %]' Created[% END %]
+    The flag type <em>[% name FILTER html %]</em> has been created.
+
+  [% ELSIF message_tag == "flag_type_updated" %]
+    [% title = BLOCK %]Flag Type '[% flagtype.name FILTER html %]' Updated[% END %]
+    [% IF changes.size %]
+      Changes to the flag type <em>[% flagtype.name FILTER html %]</em>
+      have been saved:
+      <ul>
+        [% IF changes.is_active.defined %]
+          <li>Flag type is now [% flagtype.is_active ? "active" : "inactive" %]</li>
+        [% END %]
+        [% IF changes.name.defined %]
+          <li>Flag type renamed to <em>[% flagtype.name FILTER html %]</em></li>
+        [% END %]
+        [% IF changes.description.defined %]
+          <li>Description updated to <em>[% flagtype.description FILTER html %]</em></li>
+        [% END %]
+        [% IF changes.cc_list.defined %]
+          [% IF flagtype.cc_list %]
+            <li>CC list updated to <em>[% flagtype.cc_list FILTER html %]</em></li>
+          [% ELSE %]
+            <li>CC list is now empty</li>
+          [% END %]
+        [% END %]
+        [% IF changes.sortkey.defined %]
+          <li>Sortkey updated to <em>[% flagtype.sortkey FILTER html %]</em></li>
+        [% END %]
+        [% IF changes.is_requestable.defined %]
+          <li>Flag type is [% "no longer" UNLESS flagtype.is_requestable %] requestable</li>
+        [% END %]
+        [% IF changes.is_requesteeble.defined AND flagtype.is_requestable %]
+          <li>
+            Flag type is [% "no longer" UNLESS flagtype.is_requesteeble %]
+            specifically requestable
+          </li>
+        [% END %]
+        [% IF changes.is_multiplicable.defined %]
+          <li>Flag type is [% "no longer" UNLESS flagtype.is_multiplicable %] multiplicable</li>
+        [% END %]
+        [% IF changes.grant_group_id.defined %]
+          [% IF flagtype.grant_group_id %]
+            <li>Grant group updated to <em>[% flagtype.grant_group.name FILTER html %]</em></li>
+          [% ELSE %]
+            <li>Grant group deleted</li>
+          [% END %]
+        [% END %]
+        [% IF changes.request_group_id.defined %]
+          [% IF flagtype.request_group_id %]
+            <li>Request group updated to <em>[% flagtype.request_group.name FILTER html %]</em></li>
+          [% ELSE %]
+            <li>Request group deleted</li>
+          [% END %]
+        [% END %]
+        [% IF changes.inclusions.defined || changes.exclusions.defined %]
+          <li>The inclusions and exclusions lists have been updated</li>
+        [% END %]
+     </ul>
+    [% ELSE %]
+      No changes made to flag type <em>[% flagtype.name FILTER html %]</em>.
+    [% END %]
+
+  [% ELSIF message_tag == "flag_type_deleted" %]
+    [% title = BLOCK %]Flag Type '[% name FILTER html %]' Deleted[% END %]
+    The flag type <em>[% name FILTER html %]</em> has been deleted.
+
+  [% ELSIF message_tag == "flag_type_deactivated" %]
+    [% title = BLOCK %]Flag Type '[% flag_type.name FILTER html %]' Deactivated[% END %]
+    The flag type <em>[% flag_type.name FILTER html %]</em> has been deactivated.
+
+  [% ELSIF message_tag == "install_admin_get_email" %]
+    Enter the e-mail address of the administrator:
+
+  [% ELSIF message_tag == "install_admin_get_name" %]
+    Enter the real name of the administrator:
+
+  [% ELSIF message_tag == "install_admin_get_password" %]
+    Enter a password for the administrator account:
+
+  [% ELSIF message_tag == "install_admin_created" %]
+    [% user.login FILTER html %] is now set up as an administrator.
+
+  [% ELSIF message_tag == "install_admin_setup" %]
+    Looks like we don't have an administrator set up yet.
+    Either this is your first time using [% terms.Bugzilla %], or your
+    administrator's privileges might have accidentally been deleted.
+
+  [% ELSIF message_tag == "install_column_add" %]
+    Adding new column '[% column FILTER html %]' to the '[% table FILTER html %]' table...
+
+  [% ELSIF message_tag == "install_column_drop" %]
+    Deleting the '[% column FILTER html %]' column from the '[% table FILTER html %]' table...
+
+  [% ELSIF message_tag == "install_column_rename" %]
+    Renaming column '[% old FILTER html %]' to '[% new FILTER html %]'...
+
+  [% ELSIF message_tag == "install_confirm_password" %]
+    Please retype the password to verify:
+
+  [% ELSIF message_tag == "install_default_classification" %]
+    Creating default classification '[% name FILTER html %]'...
+
+  [% ELSIF message_tag == "install_default_product" %]
+    Creating initial dummy product '[% name FILTER html %]'...
+
+  [% ELSIF message_tag == "install_file_perms_fix" %]
+    Fixing file permissions...
+
+  [% ELSIF message_tag == "install_fk_add" %]
+    Adding foreign key: [% table FILTER html %].[% column FILTER html %] -&gt; [% fk.TABLE FILTER html %].[% fk.COLUMN FILTER html %]...
+
+  [% ELSIF message_tag == "install_fk_drop" %]
+    Dropping foreign key: [% table FILTER html %].[% column FILTER html %] -&gt; [% fk.TABLE FILTER html %].[% fk.COLUMN FILTER html %]...
+
+  [% ELSIF message_tag == "install_fk_invalid" %]
+    ERROR: There are invalid values for the [% column FILTER html %] column in the [% table FILTER html %]
+    table. (These values do not exist in the [% foreign_table FILTER html %] table, in the 
+    [%+ foreign_column FILTER html %] column.)
+
+    Before continuing with checksetup, you will need to fix these values,
+    either by deleting these rows from the database, or changing the values
+    of [% column FILTER html %] in [% table FILTER html %] to point to valid values in [% foreign_table FILTER html %].[% foreign_column FILTER html %].
+
+    The bad values from the [% table FILTER html %].[% column FILTER html %] column are:
+    [%+ values.join(', ') FILTER html %]
+
+  [% ELSIF message_tag == "install_fk_invalid_fixed" %]
+    WARNING: There were invalid values in [% table FILTER html %].[% column FILTER html %]
+    that have been [% IF action == 'delete' %]deleted[% ELSE %]set to NULL[% END %]:
+    [%+ values.join(', ') FILTER html %]
+
+  [% ELSIF message_tag == "install_fk_setup" %]
+    Setting up foreign keys...
+
+  [% ELSIF message_tag == "install_group_create" %]
+    Creating group [% name FILTER html %]...
+
+  [% ELSIF message_tag == "install_groups_setup" %]
+    Creating default groups...
+
+  [% ELSIF message_tag == "install_setting_new" %]
+    Adding a new user setting called '[% name FILTER html %]'
+
+  [% ELSIF message_tag == "install_setting_setup" %]
+    Setting up user preferences...
+
+  [% ELSIF message_tag == "install_success" %]
+    checksetup.pl complete.
+
+  [% ELSIF message_tag == "install_table_drop" %]
+    Dropping the '[% name FILTER html %]' table...
+
+  [% ELSIF message_tag == "install_table_rename" %]
+    Renaming the '[% old FILTER html %]' table to '[% new FILTER html %]'...
+
+  [% ELSIF message_tag == "install_urlbase_default" %]
+    Now that you have installed [% terms.Bugzilla %], you should visit the
+    'Parameters' page (linked in the footer of the Administrator
+    account) to ensure it is set up as you wish - this includes
+    setting the 'urlbase' option to the correct URL.
+
+  [% ELSIF message_tag == "install_reset_password" %]
+    Enter a new password for [% user.login FILTER html %]:
+
+  [% ELSIF message_tag == "install_reset_password_done" %]
+    New password set.
+
+  [% ELSIF message_tag == "install_webservergroup_empty" %]
+    ****************************************************************************
+    WARNING! You have not entered a value for the "webservergroup" parameter
+    in localconfig. This means that certain files and directories which need
+    to be editable by both you and the web server must be world writable, and
+    other files (including the localconfig file which stores your database
+    password) must be world readable. This means that _anyone_ who can obtain
+    local access to this machine can do whatever they want to your 
+    [%+ terms.Bugzilla %] installation, and is probably also able to run 
+    arbitrary Perl code as the user that the web server runs as.
+
+    You really, really, really need to change this setting.
+    ****************************************************************************
+
+  [% ELSIF message_tag == "install_webservergroup_not_in" %]
+    Warning: you have entered a value for the "webservergroup" parameter in
+    localconfig, but you are not either a) running this script as [% constants.ROOT_USER FILTER html %]; 
+    or b) a member of this group. This can cause permissions problems and 
+    decreased security.  If you experience problems running [% terms.Bugzilla %]
+    scripts, log in as [% constants.ROOT_USER FILTER html %] and re-run this script, become a 
+    member of the group, or remove the value of the "webservergroup" parameter.
+
+  [% ELSIF message_tag == "install_webservergroup_windows" %]
+    Warning: You have set webservergroup in [% constants.bz_locations.localconfig FILTER html %]
+    Please understand that this does not bring you any security when
+    running under Windows.
+    Verify that the file permissions in your [% terms.Bugzilla %] directory are
+    suitable for your system. Avoid unnecessary write access.
+
+  [% ELSIF message_tag == "install_workflow_init" %]
+    Setting up the default status workflow...
+
+  [% ELSIF message_tag == "product_created" %]
+    [% title = "Product Created" %]
+    The product <em>[% product.name FILTER html %]</em> has been created.
+
+  [% ELSIF message_tag == "product_deleted" %]
+    [% title = "Product Deleted" %]
+    The product <em>[% product.name FILTER html %]</em> and all its versions,
+    components, milestones and group controls have been deleted.
+    [% IF product.bug_count %]
+      All [% terms.bugs %] being in this product and all references
+      to them have also been deleted.
+    [% END %]
+
+  [% ELSIF message_tag == "product_invalid" %]
+    [% title = "$terms.Bugzilla Component Descriptions" %]
+    The product <em>[% product FILTER html %]</em> does not exist
+    or you don't have access to it. The following is a list of the
+    products you can choose from.
+
+  [% ELSIF message_tag == "report_created" %]
+    OK, you have a new saved report named <em>[% reportname FILTER html %]</em>.
+
+  [% ELSIF message_tag == "report_deleted" %]
+    OK, the <em>[% reportname FILTER html %]</em> report is gone.
+
+  [% ELSIF message_tag == "report_updated" %]
+    The saved report <em>[% reportname FILTER html %]</em> has been updated.
+
+  [% ELSIF message_tag == "remaining_time_zeroed" %]
+    The [% field_descs.remaining_time FILTER html %] field has been 
+    set to zero automatically as part of closing this [% terms.bug %]
+    or moving it from one closed state to another.
+
+  [% ELSIF message_tag == "sanitycheck" %]
+    [%# We use this way to call sanitycheck-specific messages so that
+      # we can still use get_text(). %]
+    [% PROCESS "admin/sanitycheck/messages.html.tmpl" %]
+
+  [% ELSIF message_tag == "series_all_open" %]
+    All Open
+
+  [% ELSIF message_tag == "series_all_closed" %]
+    All Closed
+
+  [% ELSIF message_tag == "series_subcategory" %]
+    -All-
+
+  [% ELSIF message_tag == "sudo_started" %]
+    [% title = "Sudo session started" %]
+      The sudo session has been started.  For the next 6 hours, or until you 
+      end the session, everything you do you do as the user you are 
+      impersonating ([% target FILTER html %]).
+  
+  [% ELSIF message_tag == "sudo_ended" %]
+    [% title = "Sudo session complete" %]
+      Your sudo session has ended. All future actions will be attributed
+      to your own account.
+
+  [% ELSIF message_tag == "series_created" %]
+    [% title = "Series Created" %]
+      The series <em>[% series.category FILTER html %] /
+      [%+ series.subcategory FILTER html %] / 
+      [%+ series.name FILTER html %]</em>
+      has been created. Note that you may need to wait up to 
+      [%+ series.frequency * 2 %] days before there will be enough data for a
+      chart of this series to be produced.
+
+  [% ELSIF message_tag == "series_deleted" %]
+    [% title = "Series Deleted" %]
+    The series <em>[% series.category FILTER html %] /
+      [%+ series.subcategory FILTER html %] /
+      [%+ series.name FILTER html %]</em>
+      has been deleted.
+
+  [% ELSIF message_tag == "shutdown" %]
+    [% title = "$terms.Bugzilla is Down" %]
+    [% Param("shutdownhtml") %]
+    [% IF userid %]
+      <p>For security reasons, you have been logged out automatically.
+      The cookie that was remembering your login is now gone.
+    [% END %]
+
+  [% ELSIF message_tag == "term" %]
+    [% terms.$term FILTER html %]
+
+  [% ELSIF message_tag == "unexpected_flag_types" %]
+    Some flags could not be set. Please check your changes.
+
+  [% ELSIF message_tag == "user_match_failed" %]
+    You entered a username that did not match any known 
+    [% terms.Bugzilla %] users, so we have instead left
+    the [% match_field FILTER html %] field blank.
+
+  [% ELSIF message_tag == "user_match_multiple" %]
+    You entered a username that matched more than one
+    user, so we have instead left the [% match_field FILTER html %]
+    field blank.
+
+  [% ELSIF message_tag == "version_created" %]
+    [% title = "Version Created" %]
+    The version <em>[% version.name FILTER html %]</em> of product
+    <em>[% product.name FILTER html %]</em> has been created.
+
+  [% ELSIF message_tag == "version_deleted" %]
+    [% title = "Version Deleted" %]
+    The version <em>[% version.name FILTER html %]</em> of product
+    <em>[% product.name FILTER html %]</em> has been deleted.
+
+  [% ELSIF message_tag == "version_updated" %]
+    [% title = "Version Updated" %]
+    [% IF changes.size %]
+      Changes to the version <em>[% version.name FILTER html %]</em>
+      have been saved:
+      <ul>
+        [% IF changes.value.defined %]
+          <li>Version renamed to <em>[% version.name FILTER html %]</em></li>
+        [% END %]
+        [% IF changes.isactive.defined %]
+          <li>[% version.is_active ? "Enabled" : "Disabled" %] for [% terms.bugs %]</li>
+        [% END %]
+      </ul>
+    [% ELSE %]
+      No changes made to version <em>[% version.name FILTER html %]</em>.
+    [% END %]
+
+  [% ELSIF message_tag == "whine_query_failed" %]
+    The query '[% query_name FILTER html %]' from [% author.login FILTER html %]
+    failed: [% reason FILTER html %]
+
+  [% ELSIF message_tag == "workflow_updated" %]
+    The workflow has been updated.
+  [% END %]
+[% END %]
+
+[% IF !message %]
+  [% message = Hook.process('messages') %]
+[% END %]
+
+[%# Give sensible error if the message function is used incorrectly. #%]
+[% IF !message %]
+  [% message = BLOCK %]
+    You are using [% terms.Bugzilla %]'s messaging functions incorrectly. You
+    passed in the string '[% message_tag %]'. The correct use is to pass
+    in a tag, and define that tag in the file messages.html.tmpl.<br>
+    <br>
+    If you are a [% terms.Bugzilla %] end-user seeing this message, please
+    save this page and send it to [% Param('maintainer') %].
+  [% END %]
+[% END %]

diff --git a/template/en/default/global/reason-descs.none.tmpl b/template/en/default/global/reason-descs.none.tmpl
new file mode 100644 (file)
index 0000000..ca26b1c
--- /dev/null
+++ b/template/en/default/global/reason-descs.none.tmpl
@@ -0,0 +1,28 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% SET reason_descs = {
+  ${constants.REL_ASSIGNEE} => "You are the assignee for the ${terms.bug}.",
+  ${constants.REL_REPORTER} => "You reported the ${terms.bug}.",
+  ${constants.REL_QA}       => "You are the QA Contact for the ${terms.bug}.",
+  ${constants.REL_CC}       => "You are on the CC list for the ${terms.bug}.",
+  ${constants.REL_GLOBAL_WATCHER} => "You are watching all $terms.bug changes.",
+} %]
+
+[% SET watch_reason_descs => {
+  ${constants.REL_ASSIGNEE} =>
+    "You are watching the assignee of the ${terms.bug}.",
+  ${constants.REL_REPORTER} =>
+    "You are watching the reporter of the ${terms.bug}.",
+  ${constants.REL_QA}       =>
+    "You are watching the QA Contact of the ${terms.bug}.",
+  ${constants.REL_CC}       =>
+    "You are watching someone on the CC list of the ${terms.bug}.",
+} %]
+
+[% Hook.process('end') %]

diff --git a/template/en/default/global/select-menu.html.tmpl b/template/en/default/global/select-menu.html.tmpl
new file mode 100644 (file)
index 0000000..e9f56b7
--- /dev/null
+++ b/template/en/default/global/select-menu.html.tmpl
@@ -0,0 +1,52 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # name: string; the name of the menu.
+  #
+  # multiple: boolean; whether or not the menu is multi-select
+  #
+  # size: integer; the number of items to display at once
+  # 
+  # options: array or hash; the items with which to populate the array.
+  #   If a hash is passed, the hash keys become the names displayed
+  #   to the user while the hash values become the value of the item.
+  # 
+  # default: string; the item selected in the menu by default.
+  # 
+  # onchange: code; JavaScript to be run when the user changes the value
+  #   selected in the menu.
+  #%]
+ 
+[%# Get the scalar representation of the options reference, 
+  # which looks like "ARRAY(0xA352BA3F)" or "HASH(0xA352BA3F)",
+  # so we can figure out whether it is a reference to an array
+  # or a hash.
+  #%]
+[% options_type = BLOCK %][% options %][% END %]
+
+<select name="[% name FILTER html %]" 
+        [% IF onchange %]onchange="[% onchange FILTER html %]"[% END %]
+        [% IF multiple %] multiple [% END %]
+        [% IF size %] size="[% size %]" [% END %]>
+  [% IF options_type.search("ARRAY") %]
+    [% FOREACH value = options %]
+      <option value="[% value FILTER html %]"
+              [% " selected" IF value == default %]>
+        [% value FILTER html %]
+      </option>
+    [% END %]
+  [% ELSIF options_type.search("HASH") %]
+    [% FOREACH option = options %]
+      <option value="[% option.value FILTER html %]" 
+              [% " selected" IF option.value == default %]>
+        [% option.key FILTER html %]
+      </option>
+    [% END %]
+  [% END %]
+</select>

diff --git a/template/en/default/global/setting-descs.none.tmpl b/template/en/default/global/setting-descs.none.tmpl
new file mode 100644 (file)
index 0000000..d200683
--- /dev/null
+++ b/template/en/default/global/setting-descs.none.tmpl
@@ -0,0 +1,49 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# Remember to PROCESS rather than INCLUDE this template. %]
+
+[% setting_descs = { 
+   "comment_sort_order"               => "When viewing $terms.abug, show comments in this order",
+   "csv_colsepchar"                   => "Field separator character for CSV files",
+   "display_quips"                    => "Show a quip at the top of each $terms.bug list",
+   "zoom_textareas"                   => "Zoom textareas large when in use (requires JavaScript)",
+   "newest_to_oldest"                 => "Newest to Oldest",
+   "newest_to_oldest_desc_first"      => "Newest to Oldest, but keep Description at the top",
+   "off"                              => "Off",
+   "oldest_to_newest"                 => "Oldest to Newest",
+   "on"                               => "On",
+   "post_bug_submit_action"           => "After changing $terms.abug",
+   "next_bug"                         => "Show next $terms.bug in my list",
+   "same_bug"                         => "Show the updated $terms.bug",
+   "standard"                         => "Classic",
+   "skin"                             => "$terms.Bugzilla's general appearance (skin)",
+   "nothing"                          => "Do Nothing",
+   "state_addselfcc"                  => "Automatically add me to the CC list of $terms.bugs I change",
+   "always"                           => "Always",
+   "never"                            => "Never",
+   "cc_unless_role"                   => "Only if I have no role on them",
+   "lang"                             => "Language used in email",
+   "quote_replies"                    => "Quote the associated comment when you click on its reply link",
+   "quoted_reply"                     => "Quote the full comment",
+   "simple_reply"                     => "Reference the comment number only",
+   "comment_box_position"             => "Position of the Additional Comments box",
+   "before_comments"                  => "Before other comments",
+   "after_comments"                   => "After other comments",
+   "timezone"                         => "Timezone used to display dates and times",
+   "local"                            => "Same as the server",
+   "quicksearch_fulltext"             => "Include comments when performing quick searches (slower)",
+   "email_format"                     => "Preferred email format",
+   "html"                             => "HTML",
+   "text_only"                        => "Text Only",
+   "requestee_cc"                     => "Automatically add me to the CC list of $terms.bugs I am requested to review",
+   "bugmail_new_prefix"               => "Add 'New:' to subject line of email sent when a new $terms.bug is filed",
+                   } 
+%]
+
+[% Hook.process('settings') %]

diff --git a/template/en/default/global/site-navigation.html.tmpl b/template/en/default/global/site-navigation.html.tmpl
new file mode 100644 (file)
index 0000000..5c68ad7
--- /dev/null
+++ b/template/en/default/global/site-navigation.html.tmpl
@@ -0,0 +1,75 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # bug.bug_id: integer. Number of current bug (for navigation purposes)
+  #%]
+
+[% USE Bugzilla %]
+[% cgi = Bugzilla.cgi %]
+
+[% IF NOT (cgi.user_agent("MSIE [1-6]") OR cgi.user_agent("Mozilla/4")) %]
+  <link rel="Top" href="[% urlbase FILTER html %]">
+
+  [%# *** Attachment *** %]
+  [% IF attachment && attachment.bug_id %]
+    <link rel="Up" href="show_bug.cgi?id=[% attachment.bug_id FILTER none %]">
+  [% END %]
+
+
+  [%# *** Dependencies, Activity, Print-version *** %]
+  [% IF bug %]
+    <link rel="Show" title="Dependency Tree"
+          href="showdependencytree.cgi?id=[% bug.bug_id %]&amp;hide_resolved=1">
+    [% IF Param('webdotbase') %]
+      <link rel="Show" title="Dependency Graph"
+            href="showdependencygraph.cgi?id=[% bug.bug_id %]">
+    [% END %]
+
+      <link rel="Show" title="[% terms.Bug %] Activity"
+            href="show_activity.cgi?id=[% bug.bug_id %]">
+      <link rel="Show" title="Printer-Friendly Version"
+            href="show_bug.cgi?format=multiple&amp;id=[% bug.bug_id %]">
+  [% END %]
+
+
+  [%# *** Saved Searches *** %]
+  [% IF user.showmybugslink %]
+    [% user_login = user.login FILTER uri %]
+    <link rel="Saved&nbsp;Searches" title="My [% terms.Bugs %]"
+          href="[% Param('mybugstemplate').replace('%userid%', user_login) %]">
+  [% END %]
+
+  [% FOREACH q = user.queries_subscribed %]
+    <link rel="Saved&nbsp;Search"
+          title="[% q.name FILTER html %] ([% q.user.login FILTER html %])"
+          href="buglist.cgi?cmdtype=dorem&amp;remaction=run&amp;namedcmd=
+                 [% q.name FILTER uri %]&amp;sharer_id=
+                 [% q.user.id FILTER uri %]">
+  [% END %]
+
+  [%# *** Bugzilla Administration Tools *** %]
+  [% IF user.login %] 
+    [% '<link rel="Administration" title="Parameters"    
+              href="editparams.cgi">' IF user.in_group('tweakparams') %]
+    [% '<link rel="Administration" title="Users"    
+              href="editusers.cgi">' IF user.in_group('editusers') %]
+    [% '<link rel="Administration" title="Products" href="editproducts.cgi">'
+       IF user.in_group('editcomponents') || user.get_products_by_permission("editcomponents").size %]
+    [% '<link rel="Administration" title="Flag Types"   
+              href="editflagtypes.cgi">' IF user.in_group('editcomponents') %]
+    [% '<link rel="Administration" title="Groups"        
+              href="editgroups.cgi">' IF user.in_group('creategroups') %]
+    [% '<link rel="Administration" title="Keywords"      
+              href="editkeywords.cgi">' IF user.in_group('editkeywords') %]
+    [% '<link rel="Administration" title="Whining"       
+              href="editwhines.cgi">' IF user.in_group('bz_canusewhines') %]
+    [% '<link rel="Administration" title="Sanity Check"  
+              href="sanitycheck.cgi">' IF user.in_group('editcomponents') %]
+  [% END %]  
+[% END %]

diff --git a/template/en/default/global/tabs.html.tmpl b/template/en/default/global/tabs.html.tmpl
new file mode 100644 (file)
index 0000000..4540668
--- /dev/null
+++ b/template/en/default/global/tabs.html.tmpl
@@ -0,0 +1,42 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # tabs: List of hashes. Must have at least one item.  Each hash has:
+  #   name: string. Name of the tab.
+  #   link: string. relative URL to the tab's resource on this installation.
+  #   label: string. text displayed in the tab.
+  # current_tab_name: string. name of the currently selected tab
+  #%]
+
+<div class="tabbed">
+  <table class="tabs" cellspacing="0" cellpadding="10" border="0" width="100%">
+    <tr>
+      <td class="spacer">&nbsp;</td>
+
+      [% FOREACH tab = tabs %]
+        [% IF tab.name == current_tab_name %]
+          <td id="tab_[% tab.name FILTER html %]" class="selected">
+            [% tab.label FILTER html %]</td>
+        [% ELSE %]
+          <td id="tab_[% tab.name FILTER html %]" class="clickable_area"
+              onClick="document.location='[% tab.link FILTER html %]'">
+            <a href="[% tab.link FILTER html %]">[% tab.label FILTER html %]</a>
+          </td>
+        [% END %]
+      [% END %]
+
+      <td class="spacer">&nbsp;</td>
+    </tr>
+  </table>
+
+  <div class="tabbody">
+    [% content %]
+  </div>
+
+</div>

diff --git a/template/en/default/global/textarea.html.tmpl b/template/en/default/global/textarea.html.tmpl
new file mode 100644 (file)
index 0000000..216f2dd
--- /dev/null
+++ b/template/en/default/global/textarea.html.tmpl
@@ -0,0 +1,55 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  #
+  # id:             (optional) The "id"-attribute of the textarea.
+  # name:           (optional) The "name"-attribute of the textarea.
+  # accesskey:      (optional) The "accesskey"-attribute of the textarea.
+  # style:          (optional) The "style"-attribute of the textarea.
+  # classes:        (optional) The "class"-attribute of the textarea.
+  # wrap:           (deprecated; optional) The "wrap"-attribute of the textarea.
+  # disabled:       (optional) Disable the textarea.
+  # readonly:       (optional) Prevent the textarea from being edited.
+  # minrows:        (required) Number of rows the textarea shall have initially
+  #                 and when not having focus.
+  # maxrows:        (optional) Number of rows the textarea shall have if
+  #                 maximized (which happens on getting focus). If not given,
+  #                 the textarea doesn't maximize when getting focus.
+  # defaultrows:    (optional) Number of rows the textarea shall have if
+  #                 the zoom_textareas user preference if off. If not given,
+  #                 minrows will be used.
+  # cols:           (required) Number of columns the textarea shall have.
+  # defaultcontent: (optional) Default content for the textarea.
+  # mandatory:      (optional) Boolean specifying whether or not the textarea
+  #                 is mandatory.
+  #%]
+
+<textarea [% IF name %]name="[% name FILTER html %]"[% END %]
+          [% IF id %] id="[% id FILTER html %]"[% END %]
+          [% IF accesskey %] accesskey="[% accesskey FILTER html %]"[% END %]
+          [% IF style %] style="[% style FILTER html %]"[% END %]
+          [% IF classes %] class="[% classes FILTER html %]"[% END %]
+          [% IF wrap %] wrap="[% wrap FILTER html %]"[% END %]
+          [% IF disabled %] disabled="disabled"[% END %]
+          [% IF readonly %] readonly="readonly"[% END %]
+          [% IF defaultrows && user.settings.zoom_textareas.value == 'off' %]
+            rows="[% defaultrows FILTER html %]"
+          [% ELSE %]
+            rows="[% minrows FILTER html %]"
+          [% END %]
+          cols="[% cols FILTER html %]"
+          [% IF maxrows && user.settings.zoom_textareas.value == 'on' %]
+            onFocus="this.rows=[% maxrows FILTER html %]"
+          [% END %]
+          [% IF mandatory %]
+            aria-required="true"
+          [% END %]
+          [% IF onchange %]
+            onchange="[% onchange FILTER html %]"
+          [% END %]>[% defaultcontent FILTER html %]</textarea>

diff --git a/template/en/default/global/useful-links.html.tmpl b/template/en/default/global/useful-links.html.tmpl
new file mode 100644 (file)
index 0000000..5959ab6
--- /dev/null
+++ b/template/en/default/global/useful-links.html.tmpl
@@ -0,0 +1,74 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# Migration note: this whole file corresponds to the old %commandmenu% 
+    substitution param in 'footerhtml' %]
+
+<ul id="useful-links">
+  <li id="links-actions">
+      [% PROCESS "global/common-links.html.tmpl" qs_suffix = "_bottom" %]
+  </li>
+
+  [%# Saved searches %]
+    
+  [% IF user.showmybugslink OR user.queries.size 
+        OR user.queries_subscribed.size 
+  %]
+    [% print_pipe = 0 %]
+    <li id="links-saved">
+      <ul class="links">
+        [% IF user.showmybugslink %]
+          [% filtered_username = user.login FILTER uri %]
+          <li><a href="[% Param('mybugstemplate').replace('%userid%', filtered_username) %]">My [% terms.Bugs %]</a></li>
+          [% print_pipe = 1 %]
+        [% END %]
+
+        [% FOREACH q = user.queries %]
+          [% IF q.link_in_footer %]
+            <li>[% '<span class="separator">| </span>' IF print_pipe %]
+            <a href="buglist.cgi?cmdtype=runnamed&amp;namedcmd=[% q.name FILTER uri %]">[% q.name FILTER html %]</a></li>
+            [% print_pipe = 1 %]
+          [% END %]
+        [% END %]
+        [% new_line = print_pipe %]
+        [% print_pipe = 0 %]
+        [% FOREACH q = user.queries_subscribed %]
+          [% IF new_line %]
+            <br>
+            [% new_line = 0 %]
+          [% END %]
+          <li>
+            [% '<span class="separator">| </span>' IF print_pipe %]
+            <a href="buglist.cgi?cmdtype=dorem&amp;remaction=run&amp;namedcmd=
+                     [% q.name FILTER uri %]&amp;sharer_id=
+                     [% q.user.id FILTER uri %]"
+               class="shared"
+               title="Shared by [% q.user.identity FILTER html %]"
+               >[% q.name FILTER html FILTER no_break %]</a></li>
+          [% print_pipe = 1 %]
+        [% END %]
+      </ul>
+    </li>
+  [% END %]
+
+  [% IF user.reports.size %]
+    <li id="reports-saved">
+      <ul class="links">
+        [% FOREACH r = user.reports %]
+          <li>[% '<span class="separator">| </span>' IF print_pipe %]
+          <a href="report.cgi?[% r.query FILTER html %]&amp;saved_report_id=
+                  [%~ r.id FILTER uri %]">[% r.name FILTER html %]</a></li>
+          [% print_pipe = 1 %]
+        [% END %]
+      </ul>
+    </li>
+  [% END %]
+
+  [%# Sections of links to more things users can do on this installation. %]
+  [% Hook.process("end") %]
+</ul>

diff --git a/template/en/default/global/user-error.html.tmpl b/template/en/default/global/user-error.html.tmpl
new file mode 100644 (file)
index 0000000..30ca3e8
--- /dev/null
+++ b/template/en/default/global/user-error.html.tmpl
@@ -0,0 +1,1954 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # header_done: boolean. True if the Bugzilla header has already been printed.
+  # error: string. The tag of the error, or the error message to be displayed
+  # (deprecated). May contain HTML if it's an error message.
+  #%]
+
+[%# This is a list of all the possible user errors. Please keep them in
+  # alphabetical order by error tag, and leave a blank line between errors.
+  #
+  # Note that you must explicitly filter every single template variable
+  # in this file; if you do not wish to change it, use the "none" filter.
+  #
+  # Extension- or custom-specific error handling  can be easily added 
+  # via hooks: just place additional code into
+  # template/en/hook/global/user-error-errors.html.tmpl
+  # Note: be aware of uniqueness of error string parameter value, since
+  # nobody can guarantee the hook files processing order in the future.
+  #%]
+
+[% PROCESS "global/field-descs.none.tmpl" %]
+
+[% DEFAULT title = "Error" %]
+
+[% error_message = BLOCK %]
+  [% IF    error == "account_creation_disabled" %]
+    [% title = "Account Creation Disabled" %]
+    User account creation has been disabled.
+    <hr>
+    New accounts must be created by an administrator. The
+    maintainer is [% Param("maintainer") %].
+
+  [% ELSIF error == "account_creation_restricted" %]
+    [% title = "Account Creation Restricted" %]
+    User account creation has been restricted.
+    <hr>
+    Contact your administrator or the maintainer
+    ([% Param("maintainer") %]) for information about
+    creating an account.
+
+  [% ELSIF error == "account_disabled" %]
+    [% title = "Account Disabled" %]
+    [% disabled_reason FILTER none %]
+    <hr>
+    If you believe your account should be restored, please
+    send email to [% Param("maintainer") %] explaining why.
+
+  [% ELSIF error == "account_exists" %]
+    [% title = "Account Already Exists" %]
+    There is already an account with
+    [% IF email %]
+      the login name [% email FILTER html %].
+    [% ELSE %]
+      that login name.
+    [% END %]
+
+  [% ELSIF error == "account_locked" %]
+    [% title = "Account Locked" %]
+    Your IP ([% ip_addr FILTER html %]) has been locked out of this
+    account until [% unlock_at FILTER time %], as you have
+    exceeded the maximum number of login attempts.
+
+  [% ELSIF error == "alias_has_comma_or_space" %]
+    [% title = "Invalid Characters In Alias" %]
+    The alias you entered, <em>[% alias FILTER html %]</em>,
+    contains one or more commas or spaces.  Aliases cannot contain
+    commas or spaces because those characters are used to separate
+    aliases from each other in lists.  Please choose an alias
+    that does not contain commas and spaces.
+
+  [% ELSIF error == "alias_in_use" %]
+    [% title = "Alias In Use" %]
+    [% IF user.can_see_bug(bug_id) %]
+      [% terms.Bug %] [%+ bug_id FILTER bug_link(bug_id) FILTER none %]
+    [% ELSE %]
+      Another [% terms.bug %]
+    [% END %]
+    has already taken the alias <em>[% alias FILTER html %]</em>.
+    Please choose another alias.
+
+  [% ELSIF error == "alias_is_numeric" %]
+    [% title = "Alias Is Numeric" %]
+    You tried to give this [% terms.bug %] the alias <em>[% alias FILTER html %]</em>,
+    but aliases cannot be merely numbers, since they could
+    then be confused with [% terms.bug %] IDs.  Please choose an
+    alias containing at least one letter.
+
+  [% ELSIF error == "alias_too_long" %]
+    [% title = "Alias Too Long" %]
+    [% terms.Bug %] aliases cannot be longer than 20 characters.
+    Please choose a shorter alias.
+
+  [% ELSIF error == "attachment_bug_id_mismatch" %]
+    [% title = "Invalid Attachments" %]
+    You tried to perform an action on attachments from different [% terms.bugs %].
+    This operation requires all attachments to be from the same [% terms.bug %].
+
+  [% ELSIF error == "auth_cant_create_account" %]
+    [% title = "Can't create accounts" %]
+    This site is using an authentication scheme which does not permit
+    account creation. Please contact an administrator to get a new account
+    created.
+
+  [% ELSIF error == "auth_failure" %]
+    [% title = "Authorization Required" %]
+    [% admindocslinks = {'groups.html' => 'Group Security'} %]
+    Sorry,
+    [% IF group %]
+      you aren't a member of the '[% group FILTER html %]' group,
+    [% END %]
+
+    [% IF reason %]
+      [% IF group %] and [% END %]
+      [% IF reason == "cant_bless" %]
+        you don't have permissions to add or remove people from a group,
+      [% ELSIF reason == "not_visible" %]
+        there are visibility restrictions on certain user groups,
+      [% END %]
+    [% END %]
+
+    [% IF group || reason %] and so [% END %] you are not authorized to
+    [% IF action == "access" %]
+      access
+    [% ELSIF action == "add" %]
+      add new
+    [% ELSIF action == "begin" %]
+      begin
+    [% ELSIF action == "modify" %]
+      modify
+    [% ELSIF action == "delete" %]
+      delete
+    [% ELSIF action == "edit" %]
+      add, modify or delete
+    [% ELSIF action == "run" %]
+      run
+    [% ELSIF action == "schedule" %]
+      schedule
+    [% ELSIF action == "search" %]
+      search
+    [% ELSIF action == "use" %]
+      use
+    [% ELSIF action == "approve" %]
+      approve
+    [% ELSE %]
+      [%+ Hook.process('auth_failure_action') %]
+    [% END %]
+
+    [% IF object == "administrative_pages" %]
+      administrative pages
+    [% ELSIF object == "attachment" %]
+      [% IF attach_id %]
+        attachment #[% attach_id FILTER html %]
+      [% ELSE %]
+        this attachment
+      [% END %]
+    [% ELSIF object == "bugs" %]
+      [%+ terms.bugs %]
+    [% ELSIF object == "bug_fields" %]
+      the [% field_descs.$field FILTER html %] field
+    [% ELSIF object == "charts" %]
+      the "New Charts" feature
+    [% ELSIF object == "classifications" %]
+      classifications
+    [% ELSIF object == "components" %]
+      components
+    [% ELSIF object == "custom_fields" %]
+      custom fields
+    [% ELSIF object == "field_values" %]
+      field values
+    [% ELSIF object == "flagtypes" %]
+      flag types
+    [% ELSIF object == "group_access" %]
+      group access
+    [% ELSIF object == "groups" %]
+      groups
+    [% ELSIF object == "keywords" %]
+      keywords
+    [% ELSIF object == "milestones" %]
+      milestones
+    [% ELSIF object == "multiple_bugs" %]
+      multiple [% terms.bugs %] at once
+    [% ELSIF object == "parameters" %]
+      parameters
+    [% ELSIF object == "products" %]
+      products
+    [% ELSIF object == "quips" %]
+      quips
+    [% ELSIF object == "reports" %]
+      whine reports
+    [% ELSIF object == "sanity_check" %]
+      a sanity check
+    [% ELSIF object == "settings" %]
+      settings
+    [% ELSIF object == "sudo_session" %]
+      a sudo session
+    [% ELSIF object == "timetracking_summaries" %]
+      time-tracking summary reports
+    [% ELSIF object == "user" %]  
+      the user [% IF userid %] with ID '[% userid FILTER html %]'
+      [% ELSE %]you specified [% END %]
+    [% ELSIF object == "users" %]
+      users
+    [% ELSIF object == "versions" %]
+      versions
+    [% ELSIF object == "workflow" %]
+      the workflow
+    [% ELSE %]
+      [%+ Hook.process('auth_failure_object') %]
+    [% END %].
+
+    [% Hook.process("auth_failure") %]
+
+  [% ELSIF error == "attachment_deletion_disabled" %]
+    [% title = "Attachment Deletion Disabled" %]
+    Attachment deletion is disabled on this installation.
+
+  [% ELSIF error == "attachment_removed" %]
+    [% title = "Attachment Removed" %]
+    The attachment you are attempting to access has been removed.
+
+  [% ELSIF error == "bad_page_cgi_id" %]
+    [% title = "Invalid Page ID" %]
+    The ID <code>[% page_id FILTER html %]</code> is not a
+    valid page identifier.
+
+  [% ELSIF error == "bug_access_denied" %]
+    [% title = "Access Denied" %]
+    [% admindocslinks = {'groups.html' => 'Group Security'} %]
+    You are not authorized to access [% terms.bug %] #[% bug_id FILTER html %].
+
+  [% ELSIF error == "bug_access_query" %]
+    [% title = "Access Denied" %]
+    [% docslinks = {'myaccount.html' => 'Creating an account'} %]
+    You are not authorized to access [% terms.bug %] #[% bug_id FILTER html %].
+    To see this [% terms.bug %], you must
+    first <a href="show_bug.cgi?id=
+                   [% bug_id FILTER uri %]&amp;GoAheadAndLogIn=1">log
+    in to an account</a> with the appropriate permissions.
+
+  [% ELSIF error == "bug_url_invalid" %]
+    [% title = "Invalid $terms.Bug URL" %]
+    <code>[% url FILTER html %]</code> is not a valid URL to [% terms.abug %].
+    [% IF reason == 'http' %]
+      URLs must start with "http" or "https".
+    [% ELSIF reason == 'path_only' %]
+      You must specify a full URL.
+    [% ELSIF reason == 'id' %]
+      There is no valid [% terms.bug %] id in that URL.
+    [% ELSE %]
+      [%+ field_descs.see_also FILTER html %] URLs should point to one of:
+      <ul>
+        <li><code>show_bug.cgi</code> in a [% terms.Bugzilla %]
+          installation.</li>
+        <li>A b[% %]ug on launchpad.net</li>
+        <li>An issue on code.google.com.</li>
+        <li>A b[% %]ug on b[% %]ugs.debian.org.</li>
+        <li>An issue in a JIRA installation.</li>
+        <li>A ticket in a Trac installation.</li>
+        <li>A b[% %]ug in a MantisBT installation.</li>
+        <li>A b[% %]ug on sourceforge.net.</li>
+        <li>An issue on github.com.</li>
+        [% Hook.process('bug_url_invalid_tracker') %]
+      </ul>
+    [% END %]
+
+  [% ELSIF error == "bug_url_too_long" %]
+    [% title = "Invalid $terms.Bug URL" %]
+    [% terms.Bug %] URLs cannot be longer than 
+    [%+ constants.MAX_BUG_URL_LENGTH FILTER none %] characters long.
+    <code>[% url FILTER html %]</code> is too long.
+
+  [% ELSIF error == "buglist_parameters_required" %]
+    [% title = "Parameters Required" %]
+    [% docslinks = {'query.html' => "Searching for $terms.bugs",
+                    'query.html#list' => "$terms.Bug lists"} %]
+    You may not search, or create saved searches, without any search terms.
+
+  [% ELSIF error == "cc_remove_denied" %]
+    [% title = "Change Denied" %]
+    You do not have permission to remove other people from the CC list.
+
+  [% ELSIF error == "chart_too_large" %]
+    [% title = "Chart Too Large" %]
+    Sorry, but 2000 x 2000 is the maximum size for a chart.
+
+  [% ELSIF error == "comment_id_invalid" %]
+    [% id FILTER html %] is not a valid comment id.
+
+  [% ELSIF error == "comment_invalid_isprivate" %]
+    You tried to modify the privacy of comment id [% id FILTER html %],
+    but that is not a valid comment on this [% terms.bug %].
+
+  [% ELSIF error == "comment_is_private" %]
+    Comment id [% id FILTER html %] is private.
+
+  [% ELSIF error == "comment_required" %]
+    [% title = "Comment Required" %]
+    You have to specify a
+    [% IF old.defined && new.defined %]
+      <b>comment</b> when changing the [% field_descs.$field FILTER html %]
+      of [% terms.abug %] from [% (old || "(empty)") FILTER html %]
+      to [% (new || "(empty)") FILTER html %].
+    [% ELSIF new %]
+      description for this [% terms.bug %].
+    [% ELSE %]
+      <b>comment</b> on this change.
+    [% END %]
+
+  [% ELSIF error == "comment_too_long" %]
+    [% title = "Comment Too Long" %]
+    Comments cannot be longer than 
+    [%+ constants.MAX_COMMENT_LENGTH FILTER html %] characters.
+
+  [% ELSIF error == "auth_classification_not_enabled" %]
+    [% title = "Classification Not Enabled" %]
+    Sorry, classification is not enabled.
+
+  [% ELSIF error == "classification_name_too_long" %]
+    [% title = "Classification Name Too Long" %]
+    The name of a classification is limited to [% constants.MAX_CLASSIFICATION_SIZE FILTER html %]
+    characters. '[% name FILTER html %]' is too long ([% name.length %] characters).
+
+[% ELSIF error == "classification_not_specified" %]
+    [% title = "You Must Supply A Classification Name" %]
+    You must enter a classification name.
+
+  [% ELSIF error == "classification_already_exists" %]
+    [% title = "Classification Already Exists" %]
+    A classification with the name '[% name FILTER html %]' already exists.
+
+  [% ELSIF error == "classification_invalid_sortkey" %]
+    [% title = "Invalid Sortkey for Classification" %]
+    The sortkey '[% sortkey FILTER html %]' is invalid. It must be an
+    integer between 0 and [% constants.MAX_SMALLINT FILTER html %].
+
+  [% ELSIF error == "classification_not_deletable" %]
+    [% title = "Default Classification Cannot Be Deleted" %]
+    You cannot delete the default classification
+
+  [% ELSIF error == "classification_has_products" %]
+     Sorry, there are products for this classification. You
+     must reassign those products to another classification before you
+     can delete this one.
+
+  [% ELSIF error == "component_already_exists" %]
+    [% title = "Component Already Exists" %]
+    The <em>[% product.name FILTER html %]</em> product already has
+    a component named <em>[% name FILTER html %]</em>.
+
+  [% ELSIF error == "component_blank_description" %]
+    [% title = "Blank Component Description Not Allowed" %]
+    You must enter a non-blank description for this component.
+
+  [% ELSIF error == "component_blank_name" %]
+    [% title = "Blank Component Name Not Allowed" %]
+    You must enter a name for this new component.
+
+  [% ELSIF error == "component_has_bugs" %]
+    [% title = BLOCK %]Component has [% terms.Bugs %][% END %]
+    There are [% nb FILTER html %] [%+ terms.bugs %] entered for this component!
+    You must reassign those [% terms.bugs %] to another component before you
+    can delete this one.
+
+  [% ELSIF error == "component_is_last" %]
+    [% title = BLOCK %]Last Component in this Product[% END %]
+    '[% comp.name FILTER html %]' is the last component of the
+    '[% comp.product.name FILTER html %]' product. You cannot delete it.
+
+  [% ELSIF error == "component_name_too_long" %]
+    [% title = "Component Name Is Too Long" %]
+    The name of a component is limited to [% constants.MAX_COMPONENT_SIZE FILTER html %]
+    characters. '[% name FILTER html %]' is too long ([% name.length %] characters).
+
+  [% ELSIF error == "component_need_initialowner" %]
+    [% title = "Component Requires Default Assignee" %]
+    A default assignee is required for this component.
+
+  [% ELSIF error == "customfield_nonexistent" %]
+    [% title = "Unknown Custom Field" %]
+    There is no custom field with the name '[% name FILTER html %]'.
+
+  [% ELSIF error == "customfield_not_obsolete" %]
+    [% title = "Custom Field Not Obsolete" %]
+    The custom field '[% name FILTER html %]' is not obsolete.
+    Please obsolete a custom field before attempting to delete it.
+
+  [% ELSIF error == "customfield_has_activity" %]
+    [% title = "Custom Field Has Activity" %]
+    The custom field '[% name FILTER html %]' cannot be deleted because
+    it has recorded activity.
+
+  [% ELSIF error == "customfield_has_contents" %]
+    [% title = "Custom Field Has Contents" %]
+    The custom field '[% name FILTER html %]' cannot be deleted because
+    at least one [% terms.bug %] has a non empty value for this field.
+
+  [% ELSIF error == "dependency_loop_multi" %]
+    [% title = "Dependency Loop Detected" %]
+    The following [% terms.bug %](s) would appear on both the "depends on"
+    and "blocks" parts of the dependency tree if these changes
+    are committed:
+    [% FOREACH dep = deps %]
+      [%+ dep FILTER bug_link(dep) FILTER none %]
+    [% END %].
+    This would create a circular dependency, which is not allowed.
+
+  [% ELSIF error == "dependency_loop_single" %]
+    [% title = "Dependency Loop Detected" %]
+    You can't make [% terms.abug %] block itself or depend on itself.
+
+  [% ELSIF error == "dupe_id_required" %]
+    [% title = "Duplicate $terms.Bug Id Required" %]
+    You must specify [% terms.abug %] id to mark this [% terms.bug %]
+    as a duplicate of.
+
+  [% ELSIF error == "dupe_not_allowed" %]
+    [% title = "Cannot mark $terms.bugs as duplicates" %]
+    You cannot mark [% terms.bugs %] as duplicates when
+    changing several [% terms.bugs %] at once.
+
+  [% ELSIF error == "dupe_loop_detected" %]
+    [% title = "Loop detected among duplicates" %]
+    You cannot mark [% terms.bug %] [%+ bug_id FILTER html %] as
+    a duplicate of
+    [% IF dupe_of == bug_id %]
+      itself
+    [% ELSE %]
+      [%+ terms.bug %] [%+ dupe_of FILTER html %], because it
+      would create a duplicate loop
+    [% END %].
+
+  [% ELSIF error == "email_change_in_progress" %]
+    [% title = "Email Change Already In Progress" %]
+    Email change already in progress; please check your email.
+
+  [% ELSIF error == "email_no_body" %]
+    Your message did not contain any text, as far as we could tell.
+
+  [% ELSIF error == "empty_group_description" %]
+    [% title = "The group description cannot be empty" %]
+    You must enter a description for the group.
+
+  [% ELSIF error == "empty_group_name" %]
+    [% title = "The group name cannot be empty" %]
+    You must enter a name for the group.
+  
+  [% ELSIF error == "entry_access_denied" %]
+    [% title = "Permission Denied" %]
+    [% admindocslinks = {'groups.html' => 'Group Security'} %]
+    Sorry, either the product <em>[% product FILTER html %]</em>
+    does not exist or you aren't authorized to
+    enter [% terms.abug %] into it.
+
+  [% ELSIF error == "extension_create_no_name" %]
+    You must specify a name for your extension, as an argument to this script.
+
+  [% ELSIF error == "extension_disabled" %]
+    [% title = "Extension Disabled" %]
+    You cannot access this page because the extension '[% name FILTER html %]'
+    is disabled.
+
+  [% ELSIF error == "extension_first_letter_caps" %]
+    The first letter of your extension's name must be a capital letter.
+    (You specified '[% name FILTER html %]'.)
+
+  [% ELSIF error == "feature_disabled" %]
+    The [% install_string("feature_$feature") FILTER html %] feature is not
+    available in this [% terms.Bugzilla %].
+    [% IF user.in_group('admin') %]
+      If you would like to enable this feature, please run
+      <kbd>checksetup.pl</kbd> to see how to install the necessary
+      requirements for this feature.
+    [% END %]
+
+  [% ELSIF error == "field_already_exists" %]
+    [% title = "Field Already Exists" %]
+    The field '[% field.name FILTER html %]'     
+    ([% field.description FILTER html %]) already exists. Please
+    choose another name.
+
+  [% ELSIF error == "field_cant_control_self" %]
+    [% title = "Field Can't Control Itself" %]
+    The [% field.description FILTER html %] field can't be set to control 
+    itself.
+
+  [% ELSIF error == "field_control_must_be_select" %]
+    [% title = "Invalid Field Type Selected" %]
+    Only drop-down and multi-select fields can be used to control
+    the visibility/values of other fields. [% field.description FILTER html %]
+    is not the right type of field.
+
+  [% ELSIF error == "field_invalid_name" %]
+    [% title = "Invalid Field Name" %]
+    '[% name FILTER html %]' is not a valid name for a field.
+    A name may contain only letters, numbers, and the underscore character.
+
+  [% ELSIF error == "field_invalid_sortkey" %]
+    [% title = "Invalid Sortkey for Field" %]
+    The sortkey [% sortkey FILTER html %] that you have provided for
+    this field is not a valid positive integer.
+
+  [% ELSIF error == "field_missing_description" %]
+    [% title = "Missing Description for Field" %]
+    You must enter a description for this field.
+
+  [% ELSIF error == "field_long_desc_too_long" %]
+    [% title = "Long Description for Field too long" %]
+    The long description you have provided for this field is longer than 
+    [% constants.MAX_FIELD_LONG_DESC_LENGTH FILTER html %] characters.
+
+  [% ELSIF error == "field_missing_name" %]
+    [% title = "Missing Name for Field" %]
+    You must enter a name for this field.
+
+  [% ELSIF error == "field_value_control_select_only" %]
+    [% title = "Invalid Value Control Field" %]
+    Only Drop-Down or Multi-Select fields can have a field that
+    controls their values.
+
+  [% ELSIF error == "field_visibility_values_must_be_selected" %]
+    [% title = "Missing visibility field values" %]
+    At least one value must be selected for the visibility field
+    '[% field.name FILTER html %]'.
+
+  [% ELSIF error == "fieldname_invalid" %]
+    [% title = "Specified Field Does Not Exist" %]
+    The field '[% field.name FILTER html %]' does not exist or 
+    cannot be edited with this interface.
+
+  [% ELSIF error == "fieldvalue_already_exists" %]
+    [% title = "Field Value Already Exists" %]
+    The value '[% value.name FILTER html %]' already exists for the
+    [%+ field.description FILTER html %] field.
+
+  [% ELSIF error == "fieldvalue_is_controller" %]
+    [% title = "Value Controls Other Fields" %]
+    You cannot delete the [% value.field.description FILTER html %]
+    '[% value.name FILTER html %]' because
+    [% IF fields.size %]
+      it controls the visibility of the following fields:
+      [%+ fields.join(', ') FILTER html %].
+    [% END %]
+    [% ' Also, ' IF fields.size AND vals.size %]
+    [% IF vals.size %]
+      it controls the visibility of the following field values:
+      <ul>
+        [% FOREACH field_name = vals.keys %]
+          [% FOREACH val = vals.${field_name} %]
+            <li>[% val.field.name FILTER html %]:
+              '[% val.name FILTER html %]'</li>
+          [% END %]
+        [% END %]
+      </ul>
+    [% END %]
+
+  [% ELSIF error == "fieldvalue_is_default" %]
+    [% title = "Specified Field Value Is Default" %]
+    '[% value.name FILTER html %]' is the default value for
+    the '[% field.description FILTER html %]' field and cannot be deleted
+    or disabled.
+    [% IF user.in_group('tweakparams') %]
+      You have to <a href="editparams.cgi?section=bugfields#
+      [%- param_name FILTER uri %]">change</a> the default value first.
+    [% END %]
+
+  [% ELSIF error == "fieldvalue_name_too_long" %]
+    [% title = "Field Value Is Too Long" %]
+    The value of a field is limited to 
+    [%+ constants.FIELD_VALUE_MAX_SIZE FILTER none %] characters. 
+    '[% value FILTER html %]' is too long ([% value.length %] characters).
+
+  [% ELSIF error == "fieldvalue_not_editable" %]
+    [% title = "Field Value Not Editable" %]
+    The value '[% old_value.name FILTER html %]' cannot be renamed because
+    it plays some special role for the '[% field.description FILTER html %]'
+    field.
+
+  [% ELSIF error == "fieldvalue_not_deletable" %]
+    [% title = "Field Value Not Deletable" %]
+    The value '[% value.name FILTER html %]' cannot be removed or
+    disabled, because it plays some special role for the 
+    '[% field.description FILTER html %]' field.
+
+  [% ELSIF error == "fieldvalue_reserved_word" %]
+    [% title = "Reserved Word Not Allowed" %]
+    You cannot use the value '[% value FILTER html %]' for the
+    '[% field.description FILTER html %]' field. This value is used internally.
+    Please choose another one.
+
+  [% ELSIF error == "fieldvalue_sortkey_invalid" %]
+    [% title = "Invalid Field Value Sortkey" %]
+    The sortkey '[% sortkey FILTER html %]' for the
+    [%+ field.description FILTER html %] field must be an integer
+    between 0 and [% constants.MAX_SMALLINT FILTER none %].
+
+  [% ELSIF error == "fieldvalue_still_has_bugs" %]
+    [% title = "You Cannot Delete This Field Value" %]
+    You cannot delete the value '[% value.name FILTER html %]' from the 
+    [%+ field.description FILTER html %] field, because there are still
+    [%+ value.bug_count FILTER html %] [%+ terms.bugs %] using it.
+
+  [% ELSIF error == "fieldvalue_undefined" %]
+    [% title = "Undefined Value Not Allowed" %]
+    You must specify a value.
+
+  [% ELSIF error == "file_not_specified" %]
+    [% title = "No File Specified" %]
+    You did not specify a file to attach.
+
+  [% ELSIF error == "filename_not_specified" %]
+    [% title = "No Filename Specified" %]
+    You must specify a filename for this attachment.
+
+  [% ELSIF error == "file_too_large" %]
+    [% title = "File Too Large" %]
+    [%# Convert maxlocalattachment from Mb to Kb %]
+    [% max_local = Param('maxlocalattachment') * 1024 %]
+    [% max_limit = [Param('maxattachmentsize'), max_local] %]
+    The file you are trying to attach is [% filesize FILTER html %] 
+    kilobytes (KB) in size. Attachments cannot be more than
+    [%# Hack to get the max value between both limits %]
+    [%+ max_limit.nsort.last FILTER html %] KB. <br>
+    We recommend that you store your attachment elsewhere
+    and then paste the URL to this file on the attachment
+    creation page in the appropriate text field.
+    <br>Alternately, if your attachment is an image, you could convert
+    it to a compressible format like JPG or PNG and try again.
+
+  [% ELSIF error == "flag_requestee_disabled" %]
+    [% title = "Flag not Requestable from Specific Person" %]
+    You can't ask a specific person for <em>[% type.name FILTER html %]</em>.
+
+  [% ELSIF error == "flag_requestee_needs_privs" %]
+    [% title = "Flag Requestee Needs Privileges" %]
+    [% requestee.identity FILTER html %] does not have permission to set the
+    <em>[% flagtype.name FILTER html %]</em> flag. Please select a user who is
+    a member of the <em>[% flagtype.grant_group.name FILTER html %]</em> group.
+
+  [% ELSIF error == "flag_requestee_unauthorized" %]
+    [% title = "Flag Requestee Not Authorized" %]
+    [% admindocslinks = {'flags-overview.html#flags-admin'  => 'Administering Flags',
+                         'groups.html' => 'Group Security'} %]
+    [% docslinks = {'flags-overview.html' => 'An overview on Flags',
+                    'flags.html' => 'Using Flags'} %]
+
+    You asked [% requestee.identity FILTER html %]
+    for <code>[% flag_type.name FILTER html %]</code> on [% terms.bug %] 
+    [%+ bug_id FILTER html -%]
+    [% IF attach_id && attach_id > 0 %], attachment [% attach_id FILTER html %][% END %],
+    but that [% terms.bug %] has been restricted to users in certain groups, 
+    and the user you asked isn't in all the groups to which 
+    the [% terms.bug %] has been restricted.
+    Please choose someone else to ask, or make the [% terms.bug %] accessible
+    to users on its CC: list and add that user to the list.
+
+  [% ELSIF error == "flag_requestee_unauthorized_attachment" %]
+    [% title = "Flag Requestee Not Authorized" %]
+    [% admindocslinks = {'flags-overview.html#flags-admin'  => 'Administering Flags',
+                         'groups.html' => 'Group Security'} %]
+    [% docslinks = {'flags-overview.html' => 'An overview on Flags',
+                    'flags.html' => 'Using Flags'} %]
+
+    You asked [% requestee.identity FILTER html %]
+    for <code>[% flag_type.name FILTER html %]</code> on 
+    [%+ terms.bug %] [%+ bug_id FILTER html %],
+    attachment [% attach_id FILTER html %], but that attachment
+    is restricted to users in the [% Param("insidergroup") FILTER html %] group,
+    and the user you asked isn't in that group.  Please choose someone else
+    to ask, or ask an administrator to add the user to the group.
+
+  [% ELSIF error == "flag_status_invalid" %]
+    [% title = "Flag Status Invalid" %]
+    The flag status <em>[% status FILTER html %]</em>
+    [% IF id %]
+      for flag ID #[% id FILTER html %]
+    [% END %]
+    is invalid.
+
+  [% ELSIF error == "flag_type_cannot_deactivate" %]
+    [% title = "Cannot Deactivate Flag Type" %]
+    Sorry, but the flag type '[% flagtype.name FILTER html %]' also applies to some
+    products you cannot see, and so you are not allowed to deactivate it.
+
+  [% ELSIF error == "flag_type_cannot_delete" %]
+    [% title = "Flag Type Deletion Not Allowed" %]
+    Sorry, but the flag type '[% flagtype.name FILTER html %]' also applies to some
+    products you cannot see, and so you are not allowed to delete it.
+
+  [% ELSIF error == "flag_type_cc_list_invalid" %]
+    [% title = "Flag Type CC List Invalid" %]
+    [% admindocslinks = {'flags-overview.html#flags-admin'  => 'Administering Flags'} %]
+    The CC list [% cc_list FILTER html %] must be less than 200 characters long.
+
+  [% ELSIF error == "flag_type_component_without_product" %]
+    [% title = "Product Missing" %]
+    A component was selected without a product being selected.
+
+  [% ELSIF error == "flag_type_description_invalid" %]
+    [% title = "Flag Type Description Invalid" %]
+    [% admindocslinks = {'flags-overview.html#flags-admin'  => 'Administering Flags'} %]
+    You must enter a description for this flag type.
+
+  [% ELSIF error == "flag_type_name_invalid" %]
+    [% title = "Flag Type Name Invalid" %]
+    [% admindocslinks = {'flags-overview.html#flags-admin'  => 'Administering Flags'} %]
+    The name <em>[% name FILTER html %]</em> must be 1-50 characters long
+    and must not contain any spaces or commas.
+
+  [% ELSIF error == "flag_type_not_editable" %]
+    [% title = "Flag Type Not Editable" %]
+    You are not allowed to edit properties of the '[% flagtype.name FILTER html %]'
+    flag type, because this flag type is not available for the products you can administer.
+
+  [% ELSIF error == "flag_type_not_multiplicable" %]
+    [% docslinks = {'flags-overview.html' => 'An overview on Flags',
+                    'flags.html' => 'Using Flags'} %]
+    You cannot have several <em>[% type.name FILTER html %]</em> flags
+    for this [% IF attachment %] attachment [% ELSE %] [%+ terms.bug %] [% END %].
+
+  [% ELSIF error == "flag_update_denied" %]
+    [% title = "Flag Modification Denied" %]
+    [% admindocslinks = {'flags-overview.html#flags-admin'  => 'Administering Flags',
+                         'groups.html' => 'Group Security'} %]
+    [% docslinks = {'flags-overview.html' => 'An overview on Flags',
+                    'flags.html' => 'Using Flags'} %]
+    You tried to [% IF status == "+" %] grant [% ELSIF status == "-" %] deny
+    [% ELSIF status == "X" %] clear [% ELSE %] request [% END %]
+    <code>[% name FILTER html %]
+          [% IF status == "X" %][% old_status FILTER html %][% END %]</code>.
+
+    Only a user with the required permissions may make this change.
+
+  [% ELSIF error == "format_not_found" %]
+    [% title = "Format Not Found" %]
+    The requested format <em>[% format FILTER html %]</em> does not exist with
+    a content type of <em>[% ctype FILTER html %]</em>.
+    [% IF invalid %]
+      Both parameters must contain letters and hyphens only.
+    [% END %]
+
+  [% ELSIF error == "flag_type_sortkey_invalid" %]
+    [% title = "Flag Type Sort Key Invalid" %]
+    The sort key <em>[% sortkey FILTER html %]</em> must be an integer
+    between 0 and [% constants.MAX_SMALLINT FILTER none %].
+
+  [% ELSIF error == "freetext_too_long" %]
+    [% title = "Text Too Long" %]
+    The text you entered in the [% field_descs.$field FILTER html %]
+    field is too long ([% text.length FILTER html %] characters,
+    above the maximum length allowed of
+    [%+ constants.MAX_FREETEXT_LENGTH FILTER none %] characters).
+
+  [% ELSIF error == "group_cannot_delete" %]
+    [% title = "Cannot Delete Group" %]
+    The <em>[% group.name FILTER html %]</em> group cannot be deleted because
+    there are
+    <a href="editgroups.cgi?action=del&amp;group=
+             [%- group.id FILTER uri %]">records</a>
+    in the database which refer to it. All references to this group must
+    be removed before you can remove it.
+
+  [% ELSIF error == "group_exists" %]
+    [% title = "The group already exists" %]
+    The group [% name FILTER html %] already exists.
+
+  [% ELSIF error == "group_has_special_role" %]
+    [% title = "Group not deletable" %]
+    [% IF groups.size == 1 %]
+      [% attr = "it" %]
+      [% param = "parameter" %]
+    [% ELSE %]
+      [% attr = "them" %]
+      [% param = "parameters" %]
+    [% END %]
+    The group '[% name FILTER html %]' is used by the
+    '[% groups.join("' and '") FILTER html %]' [% param FILTER html %].
+    In order to delete this group, you first have to change the
+    [%+ param FILTER html %] to make [% attr FILTER html %] point to another group.
+
+
+  [% ELSIF error == "group_invalid_removal" %]
+    You tried to remove [% terms.bug %] [%+ bug_id FILTER html %]
+    from the '[% name FILTER html %]' group, but either this group does not exist,
+    or you are not allowed to remove [% terms.bugs %] from this group in the
+    '[% product FILTER html %]' product.
+
+  [% ELSIF error == "group_restriction_not_allowed" %]
+    [% title = "Group Restriction Not Allowed" %]
+    You tried to restrict [% bug_id ? "$terms.bug $bug_id" : terms.abug FILTER html %]
+    to the '[% name FILTER html %]' group, but either this group does not exist,
+    or you are not allowed to restrict [% terms.bugs %] to this group in the
+    '[% product FILTER html %]' product.
+
+  [% ELSIF error == "group_not_specified" %]
+    [% title = "Group not specified" %]
+    No group was specified.
+
+  [% ELSIF error == "group_not_visible" %]
+    [% title = "Group Not Allowed" %]
+    You are not allowed to see members of the [% group.name FILTER html %]
+    group.
+
+  [% ELSIF error == "system_group_not_deletable" %]
+    [% title = "System Groups not deletable" %]
+    <em>[% name FILTER html %]</em> is a system group.
+    This group cannot be deleted.
+
+  [% ELSIF error == "illegal_attachment_edit" %]
+    [% title = "Unauthorized Action" %]
+    You are not authorized to edit attachment [% attach_id FILTER html %].
+
+  [% ELSIF error == "illegal_attachment_edit_bug" %]
+    [% title = "Unauthorized Action" %]
+    You are not authorized to edit attachments on [% terms.bug %] 
+    [%+ bug_id FILTER html %].
+         
+  [% ELSIF error == "illegal_bug_status_transition" %]
+    [% title = "Illegal $terms.Bug Status Change" %]
+    [% IF old.defined %]
+      You are not allowed to change the [% terms.bug %] status from
+      [%+ old.name FILTER html %] to [% new.name FILTER html %].
+    [% ELSE %]
+      You are not allowed to file new [% terms.bugs %] with the
+      [%+ new.name FILTER html %] status. 
+    [% END %]
+
+  [% ELSIF error == "illegal_change" %]
+    [% title = "Not allowed" %]
+    You tried to change the
+    <strong>[% field_descs.$field FILTER html %]</strong> field 
+    [% IF oldvalue.defined %]
+      from <em>[% oldvalue.join(', ') FILTER html %]</em>
+    [% END %]
+    [% IF newvalue.defined %]
+      to <em>[% newvalue.join(', ') FILTER html %]</em>
+    [% END %]
+    , but only
+    [% IF privs < constants.PRIVILEGES_REQUIRED_EMPOWERED %]
+      the assignee
+      [% IF privs < constants.PRIVILEGES_REQUIRED_ASSIGNEE %] or reporter [% END %]
+      of the [% terms.bug %], or
+    [% END %]
+    a user with the required permissions may change that field.
+
+  [% ELSIF error == "illegal_change_deps" %]
+    [% title = "Not allowed" %]
+    You tried to change the 
+    <strong>[% field_descs.$field FILTER html %]</strong> field 
+    but only a user allowed to edit 
+    both related [% terms.bugs %] may change that field.
+
+  [% ELSIF error == "illegal_date" %]
+    [% title = "Illegal Date" %]
+    '<tt>[% date FILTER html %]</tt>' is not a legal date.
+    [% IF format %]
+      Please use the format '<tt>[% format FILTER html %]</tt>'.
+    [% END %]
+    
+  [% ELSIF error == "illegal_email_address" %]
+    [% title = "Invalid Email Address" %]
+    The e-mail address you entered (<b>[% addr FILTER html %]</b>) 
+    didn't pass our syntax checking for a legal email address.
+    [% IF default %]
+      A legal address must contain exactly one '@',
+      and at least one '.' after the @.
+    [% ELSE %]
+      [%+ Param('emailregexpdesc') FILTER html_light %]
+    [% END %]
+    It also must not contain any illegal characters.
+
+  [% ELSIF error == "illegal_frequency" %]
+    [% title = "Too Frequent" %]
+    Unless you are an administrator, you may not create series which are 
+    run more often than once every [% minimum FILTER html %] days.
+    
+  [% ELSIF error == "illegal_group_control_combination" %]
+    [% title = "Your Group Control Combination Is Illegal" %]
+    [% admindocslinks = {'groups.html' => 'Assigning Group Controls to Products'} %]
+    Your group control combination for group &quot;
+    [% groupname FILTER html %]&quot; is illegal.
+
+  [% ELSIF error == "illegal_query_name" %]
+    [% title = "Illegal Search Name" %]
+    The name of your search cannot contain any of the following characters: 
+    &lt;, &gt;, &amp;.
+
+  [% ELSIF error == "illegal_series_creation" %]
+    [% admindocslinks = {'groups.html' => 'Group security'} %]
+    [% docslinks = {'reporting.html' => 'Reporting'} %]
+    You are not authorized to create series.
+        
+  [% ELSIF error == "illegal_series_edit" %]
+    [% admindocslinks = {'groups.html' => 'Group security'} %]
+    [% docslinks = {'reporting.html' => 'Reporting'} %]
+    You are not authorized to edit this series. To do this, you must either
+    be its creator, or an administrator.
+
+  [% ELSIF error == "illegal_time" %]
+    [% title = "Illegal Time" %]
+    '<tt>[% time FILTER html %]</tt>' is not a legal time.
+    [% IF format %]
+      Please use the format '<tt>[% format FILTER html %]</tt>'.
+    [% END %]
+
+  [% ELSIF error == "illegal_regexp" %]
+    [% title = "Illegal Regular Expression" %]
+    The regular expression you provided [% value FILTER html %] is not valid.
+    The error was: [% dberror FILTER html %].
+        
+  [% ELSIF error == "insufficient_data_points" %]
+    [% docslinks = {'reporting.html' => 'Reporting'} %]
+    We don't have enough data points to make a graph (yet).
+        
+  [% ELSIF error == "invalid_attach_id" %]
+    [% title = "Invalid Attachment ID" %]
+    The attachment id [% attach_id FILTER html %] is invalid.
+
+  [% ELSIF error == "bug_id_does_not_exist" %]
+    [% title = BLOCK %]Invalid [% terms.Bug %] ID[% END %]
+    [% terms.Bug %] #[% bug_id FILTER html %] does not exist.
+    
+  [% ELSIF error == "improper_bug_id_field_value" %]
+    [% title = BLOCK %]
+      [% IF bug_id %]Invalid [% ELSE %]Missing [% END %] [% terms.Bug %] ID
+    [% END %]
+    [% IF bug_id %]
+      '[% bug_id FILTER html %]' is not a valid [% terms.bug %] number
+      nor an alias to [% terms.abug %].
+    [% ELSE %]
+      [% IF field %]
+        The '[% field_descs.$field FILTER html %]' field
+        cannot be empty.
+      [% END %]
+      You must enter a valid [% terms.bug %] number!
+    [% END %]
+
+  [% ELSIF error == "invalid_changedsince" %]
+    [% title = "Invalid 'Changed Since'" %]
+    The 'changed since' value, '[% changedsince FILTER html %]', must be an
+    integer >= 0.
+
+  [% ELSIF error == "invalid_content_type" %]
+    [% title = "Invalid Content-Type" %]
+    The content type <em>[% contenttype FILTER html %]</em> is invalid.
+    Valid types must be of the form <em>foo/bar</em> where <em>foo</em>
+    is one of <em>[% constants.LEGAL_CONTENT_TYPES.join(', ') FILTER html %]</em>
+    and <em>bar</em> must not contain any special characters (such as "=", "?", ...).
+
+  [% ELSIF error == "invalid_context" %]
+    [% title = "Invalid Context" %]
+    The context [% context FILTER html %] is invalid (must be a number,
+    "file" or "patch").
+
+  [% ELSIF error == "invalid_datasets" %]
+    [% title = "Invalid Datasets" %]
+    Invalid datasets <em>[% datasets.join(":") FILTER html %]</em>. Only digits,
+    letters and colons are allowed.
+
+  [% ELSIF error == "invalid_dimensions" %]
+    [% title = "Invalid Dimensions" %]
+    The width or height specified is not a positive integer.
+
+  [% ELSIF error == "invalid_format" %]
+    [% title = "Invalid Format" %]
+    The format "[% format FILTER html %]" is invalid (must be one of
+    [% FOREACH my_format = formats %]
+      "[% my_format FILTER html %]"
+    [% END %]
+    ).
+
+  [% ELSIF error == "invalid_group_ID" %]
+    [% title = "Invalid group ID" %]
+    The group you specified doesn't exist.
+
+  [% ELSIF error == "invalid_group_name" %]
+    [% title = "Invalid group name" %]
+    The group you specified, [% name FILTER html %], is not valid here.
+
+  [% ELSIF error == "invalid_keyword_id" %]
+    The keyword ID <em>[% id FILTER html %]</em> couldn't be found.
+
+  [% ELSIF error == "invalid_maxrows" %]
+    [% title = "Invalid Max Rows" %]
+    The maximum number of rows, '[% maxrows FILTER html %]', must be
+    a positive integer.
+
+  [% ELSIF error == "invalid_parameter" %]
+    [% title = "Invalid Parameter" %]
+    The new value for [% name FILTER html %] is invalid: [% err FILTER html %].
+
+  [% ELSIF error == "invalid_product_name" %]
+    [% title = "Invalid Product Name" %]
+    The product name '[% product FILTER html %]' is invalid or does not exist.
+
+  [% ELSIF error == "invalid_regexp" %]
+    [% title = "Invalid regular expression" %]
+    The regular expression you entered is invalid.
+
+  [% ELSIF error == "invalid_user" %]
+    [% title = "Invalid User" %]
+    There is no user account
+    [% IF user_id %]
+      with ID <em>[% user_id FILTER html %]</em>.
+    [% ELSIF user_login %]
+      with login name <em>[% user_login FILTER html %]</em>.
+    [% ELSE %]
+      given.
+    [% END %]
+
+  [% ELSIF error == "invalid_user_group" %]
+    [% title = "Invalid User Group" %]
+    [% IF users.size > 1 %] Users [% ELSE %] User [% END %]
+    '[% users.join(', ') FILTER html %]'
+    [% IF users.size > 1 %] are [% ELSE %] is [% END %]
+    not able to edit the
+    [% IF product %]
+      '[% product FILTER html %]'
+    [% END %]
+    [%+ field_descs.product FILTER html %]
+    [% IF bug_id %]
+      for [% terms.bug %] '[% bug_id FILTER html %]'.
+    [% ELSIF new %]
+      and may not be included on a new [% terms.bug %].
+    [% ELSE %]
+      for at least one [% terms.bug %] being changed.
+    [% END %]
+
+  [% ELSIF error == "invalid_username" %]
+    [% title = "Invalid Username" %]
+    The name <tt>[% name FILTER html %]</tt> is not a valid username.  
+    Either you misspelled it, or the person has not
+    registered for a [% terms.Bugzilla %] account.
+
+  [% ELSIF error == "invalid_username_or_password" %]
+    [% title = "Invalid Username Or Password" %]
+    The username or password you entered is not valid.
+    [%# People get two login attempts before being warned about
+      # being locked out.
+      #%]
+    [% IF remaining <=  2 %]
+      If you do not enter the correct password after 
+      [%+ remaining FILTER html %] more attempt(s), you will be
+      locked out of this account for 
+      [%+ constants.LOGIN_LOCKOUT_INTERVAL FILTER html %] minutes.
+      To avoid being locked out, you can reset your password using
+      the "Forgot Password" link.
+    [% END %]
+
+  [% ELSIF error == "json_rpc_get_method_required" %]
+    When using JSON-RPC over GET, you must specify a 'method'
+    parameter. See the documentation at
+    [%+ docs_urlbase FILTER html %]api/Bugzilla/WebService/Server/JSONRPC.html
+
+  [% ELSIF error == "json_rpc_illegal_content_type" %]
+    When using JSON-RPC over POST, you cannot send data as
+    [%+ content_type FILTER html %]. Only application/json and
+    application/json-rpc are allowed.
+
+  [% ELSIF error == "json_rpc_invalid_params" %]
+    Could not parse the 'params' argument as valid JSON.
+    Error: [% err_msg FILTER html %]
+    Value: [% params FILTER html %]
+
+  [% ELSIF error == "json_rpc_invalid_callback" %]
+    You cannot use '[% callback FILTER html %]' as your 'callback' parameter.
+    For security reasons, only letters, numbers, and the following
+    characters are allowed in the 'callback' parameter: <code>[]._</code>
+
+  [% ELSIF error == "json_rpc_post_only" %]
+    For security reasons, you must use HTTP POST to call the
+    '[% method FILTER html %]' method.
+
+  [% ELSIF error == "keyword_already_exists" %]
+    [% title = "Keyword Already Exists" %]
+    A keyword with the name [% name FILTER html %] already exists.
+
+  [% ELSIF error == "keyword_blank_description" %]
+    [% title = "Blank Keyword Description Not Allowed" %]
+    You must enter a non-blank description for the keyword.
+     
+  [% ELSIF error == "keyword_blank_name" %]
+    [% title = "Blank Keyword Name Not Allowed" %]
+    You must enter a non-blank name for the keyword.
+     
+  [% ELSIF error == "keyword_invalid_name" %]
+    [% title = "Invalid Keyword Name" %]
+    You may not use commas or whitespace in a keyword name.
+     
+  [% ELSIF error == "login_needed_for_password_change" %]
+    [% title = "Login Name Required" %]
+    You must enter a login name when requesting to change your password.
+
+  [% ELSIF error == "login_required_for_pronoun" %]
+    [% title = "Login Name Required" %]
+    You can't use %user% without being logged in, because %user% refers
+    to your login name, which we don't know.
+
+  [% ELSIF error == "login_required" %]
+    [%# Used for non-web-based LOGIN_REQUIRED situations. %]
+    You must log in before using this part of [% terms.Bugzilla %].
+
+  [% ELSIF error == "migrate_config_created" %]
+    The file <kbd>[% file FILTER html %]</kbd> contains configuration
+    variables that must be set before continuing with the migration.
+
+  [% ELSIF error == "migrate_from_invalid" %]
+    '[% from FILTER html %]' is not a valid type of [% terms.bug %]-tracker
+    to migrate from. See the contents of the <kbd>B[% %]ugzilla/Migrate/</kbd>
+    directory for a list of valid [% terms.bug %]-trackers.
+
+  [% ELSIF error == "milestone_already_exists" %]
+    [% title = "Milestone Already Exists" %]
+    [% admindocslinks = {'products.html' => 'Administering products',
+                         'milestones.html' => 'About Milestones'} %]
+    The milestone '[% name FILTER html %]' already exists for product '
+    [%- product FILTER html %]'.
+
+  [% ELSIF error == "milestone_blank_name" %]
+    [% title = "Blank Milestone Name Not Allowed" %]
+    You must enter a name for this milestone.
+
+  [% ELSIF error == "milestone_is_default" %]
+    [% title = "Default milestone not deletable" %]
+    [% admindocslinks = {'products.html' => 'Administering products',
+                         'milestones.html' => 'About Milestones'} %]
+    Sorry, but [% milestone.name FILTER html %] is the default milestone
+    for the '[% milestone.product.name FILTER html %]' product, and so
+    it cannot be deleted.
+
+  [% ELSIF error == "milestone_name_too_long" %]
+    [% title = "Milestone Name Is Too Long" %]
+    The name of a milestone is limited to [% constants.MAX_MILESTONE_SIZE FILTER html %]
+    characters. '[% name FILTER html %]' is too long ([% name.length %] characters).
+
+  [% ELSIF error == "milestone_required" %]
+    [% title = "Milestone Required" %]
+    You must select a target milestone for [% terms.bug %]
+    [%+ bug.id FILTER html %]
+    if you are going to accept it.  Part of accepting 
+    [%+ terms.abug %] is giving an estimate of when it will be fixed.
+
+  [% ELSIF error == "milestone_sortkey_invalid" %]
+    [% title = "Invalid Milestone Sortkey" %]
+    The sortkey '[% sortkey FILTER html %]' is not in the range
+    [%+ constants.MIN_SMALLINT FILTER html %] &le; sortkey &le;
+    [%+ constants.MAX_SMALLINT FILTER html %].
+
+  [% ELSIF error == "misarranged_dates" %]
+    [% title = "Misarranged Dates" %]
+    Your start date ([% datefrom FILTER html %]) is after 
+    your end date ([% dateto FILTER html %]).
+
+  [% ELSIF error == "mismatched_bug_ids_on_obsolete" %]
+    Attachment [% attach_id FILTER html %] is attached to another [% terms.bug %],
+    but you tried to flag it as obsolete while creating a new attachment to
+    [%+ terms.bug %] [%+ my_bug_id FILTER html %].
+
+  [% ELSIF error == "missing_attachment_description" %]
+    [% title = "Missing Attachment Description" %]
+    You must enter a description for the attachment.
+
+  [% ELSIF error == "missing_bug_id" %]
+    [% title = "Missing $terms.Bug ID" %]
+    No [% terms.bug %] ID was given.
+
+  [% ELSIF error == "missing_category" %]
+    [% title = "Missing Category" %]
+    You did not specify a category for this series.
+
+  [% ELSIF error == "missing_component" %]
+    [% title = "Missing Component" %]
+    [% admindocslinks = {'products.html'   => 'Administering products',
+                         'components.html' => 'Creating a component'} %]
+    Sorry, the product <em>[% product.name FILTER html %]</em>
+    has to have at least one active component in order for you to
+    enter [% terms.abug %] into it.<br>
+    [% IF user.in_group("editcomponents", product.id) %]
+      <a href="editcomponents.cgi?action=add&amp;product=[% product.name FILTER uri %]">Create
+      a new component</a>.
+    [% ELSE %]
+      Please contact [% Param("maintainer") %] and ask them
+      to add a component to this product.
+    [% END %]
+
+  [% ELSIF error == "missing_content_type" %]
+    [% title = "Missing Content-Type" %]
+     You asked [% terms.Bugzilla %] to auto-detect the content type, but
+     your browser did not specify a content type when uploading the file, 
+     so you must enter a content type manually.
+
+  [% ELSIF error == "missing_cookie" %]
+    [% title = "Missing Cookie" %]
+    Sorry, I seem to have lost the cookie that recorded
+    the results of your last search. I'm afraid you will have to start
+    again from the <a href="query.cgi">search page</a>.
+          
+  [% ELSIF error == "missing_datasets" %]
+    [% title = "No Datasets Selected" %]
+    [% docslinks = {'reporting.html' => 'Reporting'} %]
+    You must specify one or more datasets to plot.
+    
+  [% ELSIF error == "missing_frequency" %]
+    [% title = "Missing Frequency" %]
+    [% docslinks = {'reporting.html' => 'Reporting'} %]
+    You did not specify a valid frequency for this series.
+                
+  [% ELSIF error == "missing_name" %]
+    [% title = "Missing Name" %]
+    [% docslinks = {'reporting.html' => 'Reporting'} %]
+    You did not specify a name for this series.
+                
+  [% ELSIF error == "missing_query" %]
+    [% title = "Missing Search" %]
+    [% docslinks = {'query.html' => "Searching for $terms.bugs",
+                    'query.html#list' => "$terms.Bug lists"} %]
+    The search named <em>[% name FILTER html %]</em>
+    [% IF sharer_id && sharer_id != user.id %]
+      has not been made visible to you.
+    [% ELSE %]
+      does not exist.
+    [% END %]
+
+  [% ELSIF error == "need_quipid" %]
+    [% title = "Missing Quip ID" %]
+    A valid quip ID is needed.
+
+  [% ELSIF error == "missing_resolution" %]
+    [% title = "Resolution Required" %]
+    A valid resolution is required to mark [% terms.bugs %] as
+    [%+ status FILTER upper FILTER html %].
+
+  [% ELSIF error == "missing_subcategory" %]
+    [% title = "Missing Subcategory" %]
+    You did not specify a subcategory for this series.
+                
+  [% ELSIF error == "missing_version" %]
+    [% title = "Missing Version" %]
+    [% admindocslinks = {'versions.html' => 'Defining versions'} %]
+    Sorry, the product <em>[% product.name FILTER html %]</em>
+    has to have at least one active version in order for you to
+    enter [% terms.abug %] into it.<br>
+    [% IF user.in_group("editcomponents", product.id) %]
+      <a href="editversions.cgi?action=add&amp;product=[% product.name FILTER uri %]">Create
+      a new version</a>.
+    [% ELSE %]
+      Please contact [% Param("maintainer") %] and ask them
+      to add a version to this product.
+    [% END %]
+
+  [% ELSIF error == "multiple_alias_not_allowed" %]
+    You cannot set aliases when modifying multiple [% terms.bugs %]
+    at once.
+
+  [% ELSIF error == "need_quip" %]
+    [% title = "Quip Required" %]
+    [% docslinks = {'quips.html' => 'About quips'} %]
+    Please enter a quip in the text field.
+
+  [% ELSIF error == "new_password_missing" %]
+    [% title = "New Password Missing" %]
+    You must enter a new password.
+
+  [% ELSIF error == "no_axes_defined" %]
+    [% title = "No Axes Defined" %]
+    [% docslinks = {'reporting.html' => 'Reporting'} %]
+    You didn't define any axes to plot.
+
+  [% ELSIF error == "no_bugs_chosen" %]
+    [% title = BLOCK %]No [% terms.Bugs %] Selected[% END %]
+    You apparently didn't choose any [% terms.bugs %]
+    [% IF action == "modify" %]
+      to modify.
+    [% ELSIF action == "view" %]
+      to view.
+    [% END %]
+
+  [% ELSIF error == "no_tag_to_edit" %]
+    [% title = "No Tag Selected" %]
+    You tried to create or remove a tag with no name.
+
+  [% ELSIF error == "no_initial_bug_status" %]
+    [% title = "No Initial $terms.Bug Status" %]
+    No [% terms.bug %] status is available on [% terms.bug %] creation.
+    Please report the problem to [% Param("maintainer") %].
+
+  [% ELSIF error == "no_new_quips" %]
+    [% title = "No New Quips" %]
+    [% admindocslinks = {'quips.html' => 'Controlling quip usage'} %]
+    This site does not permit the addition of new quips.
+
+  [% ELSIF error == "no_page_specified" %]
+    [% title = "No Page Specified" %]
+    You did not specify the id of a page to display.
+
+  [% ELSIF error == "no_products" %]
+    [% title = "No Products" %]
+    [% admindocslinks = {'products.html'   => 'Setting up a product',
+                         'components.html' => 'Adding components to products',
+                         'groups.html'     => 'Groups security'} %]
+    Either no products have been defined to enter [% terms.bugs %] against or you have not
+    been given access to any.
+
+  [% ELSIF error == "number_not_numeric" %]
+    [% title = "Numeric Value Required" %]
+    The value '[% num FILTER html %]' in the 
+    <em>[% field_descs.$field FILTER html %]</em> field 
+    is not a numeric value.
+
+  [% ELSIF error == "number_too_large" %]
+    [% title = "Number Too Large" %]
+    The value '[% num FILTER html %]' in the 
+    <em>[% field_descs.$field FILTER html %]</em> field 
+    is more than the maximum allowable value of '[% max_num FILTER html %]'.
+
+  [% ELSIF error == "number_too_small" %]
+    [% title = "Number Too Small" %]
+    The value '[% num FILTER html %]' 
+    in the <em>[% field_descs.$field FILTER html %]</em> field 
+    is less than the minimum allowable value of '[% min_num FILTER html %]'.
+
+  [% ELSIF error == "object_not_specified" %]
+    [% type = BLOCK %][% INCLUDE object_name class = class %][% END %]
+    [% title = BLOCK %][% type FILTER ucfirst FILTER html %] Not 
+    Specified[% END %]
+    You must select/enter a [% type FILTER html %].
+
+  [% ELSIF error == "object_does_not_exist" %]
+    [% type = BLOCK %][% INCLUDE object_name class = class %][% END %]
+    [% title = BLOCK %]Invalid [% type FILTER ucfirst FILTER html %][% END %]
+    There is no [% type FILTER html %] 
+    [% IF id.defined %]
+      with the id '[% id FILTER html %]'
+    [% ELSE %]
+      named '[% name FILTER html %]'
+    [% END %]
+    [% IF product.defined %]
+      in the '[% product.name FILTER html %]' product
+    [% END %].
+    [% IF class == "Bugzilla::User" %]
+      Either you mis-typed the name or that user has not yet registered
+      for a [% terms.Bugzilla %] account.
+    [% ELSIF class == "Bugzilla::Keyword" %]
+      The legal keyword names are <a href="describekeywords.cgi">listed
+      here</a>.
+    [% END %]
+
+  [% ELSIF error == "old_password_incorrect" %]
+    [% title = "Incorrect Password" %]
+    You did not enter your current password correctly.
+
+  [% ELSIF error == "old_password_required" %]
+    [% title = "Old Password Required" %]
+    You must enter your old password to change your email address.
+
+  [% ELSIF error == "password_change_requests_not_allowed" %]
+    [% title = "Password Change Requests Not Allowed" %]
+    The system is not configured to allow password change requests.
+
+  [% ELSIF error == "passwords_dont_match" %]
+    [% title = "Passwords Don't Match" %]
+    The two passwords you entered did not match.
+
+  [% ELSIF error == "password_current_too_short" %]
+    [% title = "New Password Required" %]
+    Your password is currently less than
+    [%+ constants.USER_PASSWORD_MIN_LENGTH FILTER html %] characters long,
+    which is the new minimum length required for passwords.
+    You must <a href="token.cgi?a=reqpw&amp;loginname=[% locked_user.email FILTER uri %]">
+    request a new password</a> in order to log in again.
+
+  [% ELSIF error == "password_too_short" %]
+    [% title = "Password Too Short" %]
+    The password must be at least
+    [%+ constants.USER_PASSWORD_MIN_LENGTH FILTER html %] characters long.
+
+  [% ELSIF error == "password_not_complex" %]
+     [% title = "Password Fails Requirements" %]
+     [% passregex = Param('password_complexity') %]
+     The password must contain at least one:
+     <ul>
+       [% IF passregex.search('letters') %]
+         <li>UPPERCASE letter</li>
+         <li>lowercase letter</li>
+       [% END %]
+       [% IF passregex.search('numbers') %]
+         <li>digit</li>
+       [% END %]
+       [% IF passregex.search('specialchars') %]
+         <li>special character</li>
+       [% END %]
+     </ul>
+
+  [% ELSIF error == "product_access_denied" %]
+    [% title = "Product Access Denied" %]
+    Either the product 
+    [%+ IF id.defined %]
+      with the id [% id FILTER html %]
+    [% ELSE %]
+      '[% name FILTER html %]'
+    [% END %]
+    does not exist or you don't have access to it.
+
+  [% ELSIF error == "product_illegal_group" %]
+    [% title = "Illegal Group" %]
+    [% group.name FILTER html %] is not an active [% terms.bug %] group
+    and so you cannot edit group controls for it.
+
+  [% ELSIF error == "product_name_already_in_use" %]
+    [% title = "Product name already exists" %]
+    [% admindocslinks = {'products.html' => 'Administering products'} %]
+    The product name '[% product FILTER html %]' already exists.
+  
+  [% ELSIF error == "product_name_diff_in_case" %]
+    [% title = "Product name differs only in case" %]
+    [% admindocslinks = {'products.html' => 'Administering products'} %]
+    The product name '[% product FILTER html %]' differs from existing 
+    product '[% existing_product FILTER html %]' only in case.
+
+  [% ELSIF error == "product_name_too_long" %]
+    [% title = "Product name too long" %]
+    The name of a product is limited to [% constants.MAX_PRODUCT_SIZE FILTER html %]
+    characters. '[% name FILTER html %]' is too long ([% name.length %] characters).
+
+  [% ELSIF error == "product_must_define_defaultmilestone" %]
+    [% title = "Must define new default milestone" %]
+    [% admindocslinks = {'products.html' => 'Administering products',
+                         'milestones.html' => 'About Milestones'} %]
+    You must <a href="editmilestones.cgi?action=add&amp;product=[% product FILTER uri %]">
+    create the milestone '[% milestone FILTER html %]'</a> before
+    it can be made the default milestone for product '[% product FILTER html %]'.
+
+  [% ELSIF error == "product_admin_denied" %]
+    [% title = "Product Access Denied" %]
+    You are not allowed to edit properties of product '[% product FILTER html %]'.
+
+  [% ELSIF error == "product_blank_name" %]
+    [% title = "Blank Product Name Not Allowed" %]
+    [% admindocslinks = {'products.html' => 'Administering products'} %]
+    You must enter a name for the product.
+  
+  [% ELSIF error == "product_disabled" %]
+    [% title = BLOCK %]Product closed for [% terms.Bug %] Entry[% END %]
+    [% admindocslinks = {'products.html' => 'Administering products'} %]
+    Sorry, entering [% terms.abug %] into the
+    product <em>[% product.name FILTER html %]</em> has been disabled.
+
+  [% ELSIF error == "product_edit_denied" %]
+    [% title = "Product Edit Access Denied" %]
+    [% admindocslinks = {'products.html' => 'Administering products',
+                         'groups.html'   => 'Group security'} %]
+    You are not permitted to edit [% terms.bugs %] in product 
+    [%+ product FILTER html %].
+
+  [% ELSIF error == "product_has_bugs" %]
+    [% title = BLOCK %]Product has [% terms.Bugs %][% END %]
+    [% admindocslinks = {'products.html' => 'Administering products'} %]
+    There are [% nb FILTER html %] [%+ terms.bugs %] entered for this product!
+    You must move those [% terms.bugs %] to another product before you
+    can delete this one.
+
+  [% ELSIF error == "product_must_have_description" %]
+    [% title = "Product needs Description" %]
+    [% admindocslinks = {'products.html' => 'Administering products'} %]
+    You must enter a description for this product.
+
+  [% ELSIF error == "product_must_have_version" %]
+    [% title = "Product needs Version" %]
+    [% admindocslinks = {'products.html' => 'Administering products',
+                         'versions.html' => 'Administering versions'} %]
+    You must enter a valid version to create a new product.
+
+  [% ELSIF error == "product_unknown_component" %]
+    [% title = "Unknown Component" %]
+    Product '[% product FILTER html %]' has no component
+    [% IF comp_id %]
+      with ID [% comp_id FILTER html %].
+    [% ELSE %]
+      named '[% comp FILTER html %]'.
+    [% END %]
+
+  [% ELSIF error == "query_name_missing" %]
+    [% title = "No Search Name Specified" %]
+    [% docslinks = {'query.html#list' => "$terms.Bug lists"} %]
+    You must enter a name for your search.
+
+  [% ELSIF error == "query_name_too_long" %]
+    [% title = "Query Name Too Long" %]
+    The name of the query must be less than [% constants.MAX_LEN_QUERY_NAME FILTER html %]
+    characters long.
+
+  [% ELSIF error == "quicksearch_invalid_query" %]
+    [% title = "Invalid Query" %]
+    Your query is invalid.
+    [% IF operators %]
+      The [% operators.shift FILTER html %] operator cannot be followed by
+      [%+ operators.shift FILTER html %].
+    [% ELSE %]
+      A query cannot start with AND or OR, nor can it end with AND, OR or NOT.
+      They are reserved operators and must be quoted if you want to look for
+      these strings.
+    [% END %]
+
+  [% ELSIF error == "quicksearch_unbalanced_quotes" %]
+    [% title = "Badly Formatted Query" %]
+    [% terms.Bugzilla %] is unable to parse your query correctly:
+    <em>[% string FILTER html %]</em>.<br>
+    If you use quotes to enclose strings, make sure both quotes are present.
+    If you really want to look for a quote in a string, type \" instead of ".
+    For instance, <em>"I'm so \"special\", really"</em> (with quotes) will be
+    interpreted as <em>I'm so "special", really</em>.
+
+  [% ELSIF error == "quicksearch_unknown_field" %]
+    [% title = "QuickSearch Error" %]
+    There is a problem with your search:
+    [% FOREACH field = unknown %]
+      <p><code>[% field FILTER html %]</code> is not a valid field name.</p>
+    [% END %]
+    [% FOREACH field = ambiguous.keys %]
+      <p><code>[% field FILTER html %]</code> matches more than one field:
+        [%+ ambiguous.${field}.join(', ') FILTER html %]</p>
+    [% END %]
+
+    [% IF unknown.size %]
+      <p>The legal field names are 
+        <a href="page.cgi?id=quicksearch.html#fields">listed here</a>.</p>
+    [% END %]
+
+  [% ELSIF error == "quip_too_long" %]
+    [% title = "Quip Too Long" %]
+    You entered a quip with a length of [% length FILTER none %] characters, 
+    but the maximum allowed length is [% constants.MAX_QUIP_LENGTH FILTER none %] 
+    characters.
+
+  [% ELSIF error == "reassign_to_empty" %]
+    [% title = "Illegal Reassignment" %]
+    To reassign [% terms.abug %], you must provide an address for
+    the new assignee.
+
+  [% ELSIF error == "report_axis_invalid" %]
+    [% title = "Invalid Axis" %]
+    <em>[% val FILTER html %]</em> is not a valid value for
+    [%+ IF    fld == "x" %]the horizontal axis
+    [%+ ELSIF fld == "y" %]the vertical axis
+    [%+ ELSIF fld == "z" %]the multiple tables/images
+    [%+ ELSE %]a report axis[% END %] field.
+
+  [% ELSIF error == "report_name_missing" %]
+    [% title = "No Report Name Specified" %]
+    You must enter a name for your report.
+
+  [% ELSIF error == "report_access_denied" %]
+    [% title = "Report Access Denied" %]
+    You cannot access this report.
+
+  [% ELSIF error == "require_component" %]
+    [% title = "Component Needed" %]
+    To file this [% terms.bug %], you must first choose a component.
+    If necessary, just guess.
+
+  [% ELSIF error == "relationship_loop_single" %]
+    [% title = "Relationship Loop Detected" %]
+    [% field_descs.$field_name FILTER html %]
+    for [% terms.bug %] [%+ bug_id FILTER html %]
+    has a circular dependency on [% terms.bug %] [%+ dep_id FILTER html %].
+
+  [% ELSIF error == "request_queue_group_invalid" %]
+    The group field <em>[% group FILTER html %]</em> is invalid.
+
+  [% ELSIF error == "require_new_password" %]
+    [% title = "New Password Needed" %]
+    You cannot change your password without choosing a new one.
+
+  [% ELSIF error == "required_field" %]
+    [% title = "Field Must Be Set" %]
+    A value must be set for the '[% field_descs.${field.name} FILTER html %]'
+    field.
+
+  [% ELSIF error == "require_summary" %]
+    [% title = "Summary Needed" %]
+    You must enter a summary for this [% terms.bug %].
+
+  [% ELSIF error == "resolution_cant_clear" %]
+    [% terms.Bug %] [%+ bug_id FILTER bug_link(bug_id) FILTER none %] is 
+    closed, so you cannot clear its resolution.
+
+  [% ELSIF error == "resolution_not_allowed" %]
+    [% title = "Resolution Not Allowed" %]
+    You cannot set a resolution for open [% terms.bugs %].
+
+  [% ELSIF error == "saved_search_used_by_whines" %]
+    [% title = "Saved Search In Use" %]
+    [% docslinks = {'whining.html' => 'About Whining'} %]
+    The saved search <em>[% search_name FILTER html %]</em> is being used 
+    by <a href="editwhines.cgi">Whining events</a> with the following subjects:
+    [%+ subjects FILTER html %]
+
+  [% ELSIF error == "search_content_without_matches" %]
+    [% title = "Illegal Search" %]
+    The "content" field can only be used with "matches" search 
+    and the "matches" search can only be used with the "content"
+    field.
+
+  [% ELSIF error == "search_grouped_field_invalid" %]
+    [% terms.Bugzilla %] does not support using the 
+    "[%+ field_descs.$field FILTER html %]" ([% field FILTER html %])
+    field with grouped search conditions.
+
+  [% ELSIF error == "search_grouped_invalid_nesting" %]
+    You cannot nest clauses within grouped search conditions.
+
+  [% ELSIF error == "search_grouped_field_mismatch" %]
+    All conditions under a groups search must use the same field.
+
+  [% ELSIF error == "search_field_operator_invalid" %]
+    [% terms.Bugzilla %] does not support using the 
+    "[%+ field_descs.$field FILTER html %]" ([% field FILTER html %])
+    field with the "[% search_descs.$operator FILTER html %]" 
+    ([% operator FILTER html %]) search type.
+
+  [% ELSIF error == "see_also_self_reference" %]
+    You cannot put this [% terms.bug %] into its own
+    [%+ field_descs.see_also FILTER html %] field.
+
+  [% ELSIF error == "series_already_exists" %]
+    [% title = "Series Already Exists" %]
+    [% docslinks = {'reporting.html' => 'Reporting'} %]
+      A series named <em>[% series.category FILTER html %] /
+      [%+ series.subcategory FILTER html %] / 
+      [%+ series.name FILTER html %]</em>
+      already exists.
+    
+  [% ELSIF error == "still_unresolved_bugs" %]
+    [% title = "Unresolved Dependencies" %]
+    [% IF bug_id %]
+      [% terms.Bug %] [%+ bug_id FILTER bug_link(bug_id) FILTER none %]
+    [% ELSE %]
+       This [% terms.bug %]
+    [% END %]
+    has [% dep_count FILTER none %] unresolved
+    [% IF dep_count == 1 %]
+      dependency
+    [% ELSE %]
+      dependencies
+    [% END %].
+    They must either be resolved or removed from the
+    "[% field_descs.dependson FILTER html %]" field before you can resolve
+    this [% terms.bug %] as [% display_value("resolution", "FIXED") FILTER html %].
+
+  [% ELSIF error == "sudo_invalid_cookie" %]
+    [% title = "Invalid Sudo Cookie" %]
+    Your sudo cookie is invalid. Either it expired or you didn't start
+    a sudo session correctly. Refresh the page or load another page
+    to continue what you are doing as yourself.
+
+  [% ELSIF error == "sudo_illegal_action" %]
+    [% title = "Impersonation Not Authorized" %]
+    [% IF NOT sudoer.in_group("bz_sudoers") %]
+      You are not allowed to impersonate users.
+    [% ELSIF target_user AND target_user.in_group("bz_sudo_protect") %]
+      You are not allowed to impersonate [% target_user.identity FILTER html %].
+    [% ELSE %]
+      The user you tried to impersonate doesn't exist.
+    [% END %]
+
+  [% ELSIF error == "sudo_in_progress" %]
+    [% title = "Session In Progress" %]
+    A sudo session (impersonating [% target FILTER html %]) is in progress.  
+    End that session (using the link in the footer) before starting a new one.
+
+  [% ELSIF error == "sudo_password_required" %]
+    [% title = "Password Required" %]
+    Your [% terms.Bugzilla %] password is required to begin a sudo 
+    session. Please <a href="relogin.cgi?action=prepare-sudo&amp;target_login=
+    [%- target_login FILTER uri %]&amp;reason=
+    [%- reason FILTER uri %]">go back</a> and enter your password.
+    
+  [% ELSIF error == "sudo_preparation_required" %]
+    [% title = "Preparation Required" %]
+    You may not start a sudo session directly.  Please
+    <a href="relogin.cgi?action=prepare-sudo&amp;target_login=
+    [%- target_login FILTER uri %]&amp;reason=
+    [%- reason FILTER uri %]">start your session normally</a>.
+
+  [% ELSIF error == "sudo_protected" %]
+    [% title = "User Protected" %]
+    The user [% login FILTER html %] may not be impersonated by sudoers.
+
+  [% ELSIF error == "tag_name_too_long" %]
+    [% title = "Tag Name Too Long" %]
+    The tag name must be less than [% constants.MAX_LEN_QUERY_NAME FILTER html %]
+    characters long.
+
+  [% ELSIF error == "token_does_not_exist" %]
+    [% title = "Token Does Not Exist" %]
+    The token you submitted does not exist, has expired, or has
+    been canceled.
+
+  [% ELSIF error == "too_soon_for_new_token" %]
+    [% title = "Too Soon For New Token" %]
+    You have requested
+    [% IF type == "password" %]
+      a password
+    [% ELSIF type == "account" %]
+      an account
+    [% END %]
+    token too recently to request another. 
+    Please wait [% constants.ACCOUNT_CHANGE_INTERVAL FILTER html %] minutes
+    then try again.
+
+  [% ELSIF error == "unknown_action" %]
+    [% IF action %]
+       Unknown action [% action FILTER html %]!
+    [% ELSE %]
+       I could not figure out what you wanted to do.
+    [% END %]
+
+  [% ELSIF error == "unknown_tab" %]
+    [% title = "Unknown Tab" %]
+    <code>[% current_tab_name FILTER html %]</code> is not a legal tab name.
+
+  [% ELSIF error == "value_inactive" %]
+    [% title = "Value is Not Active" %]
+    [% type = BLOCK %][% INCLUDE object_name class = class %][% END %]
+    The [% type FILTER html %] value '[% value FILTER html %]' is not active.
+
+  [% ELSIF error == "version_already_exists" %]
+    [% title = "Version Already Exists" %]
+    [% admindocslinks = {'versions.html' => 'Administering versions'} %]
+    The version '[% name FILTER html %]' already exists for product '
+    [%- product FILTER html %]'.
+
+  [% ELSIF error == "version_blank_name" %]
+    [% title = "Blank Version Name Not Allowed" %]
+    You must enter a name for this version.
+
+  [% ELSIF error == "version_has_bugs" %]
+    [% title = BLOCK %]Version has [% terms.Bugs %][% END %]
+    There are [% nb FILTER html %] [%+ terms.bugs %] associated with this
+    version! You must reassign those [% terms.bugs %] to another version
+    before you can delete this one.
+
+  [% ELSIF error == "version_is_last" %]
+    [% title = BLOCK %]Last Version in this Product[% END %]
+    '[% version.name FILTER html %]' is the last version of the
+    '[% version.product.name FILTER html %]' product. You cannot delete it.
+
+  [% ELSIF error == "users_deletion_disabled" %]
+    [% title = "Deletion not activated" %]
+    [% admindocslinks = {'useradmin.html' => 'User administration'} %]
+    Sorry, the deletion of user accounts is not allowed.
+
+  [% ELSIF error == "user_has_responsibility" %]
+    [% title = "Can't Delete User Account" %]
+    [% admindocslinks = {'useradmin.html' => 'User administration'} %]
+    The user you want to delete is set up as the default [% terms.bug %]
+    assignee
+    [% IF Param('useqacontact') %]
+      or QA contact
+    [% END %]
+    for at least one component.
+    For this reason, you cannot delete the account at this time.
+
+  [% ELSIF error == "user_access_by_id_denied" %]
+    [% title = "User Access By Id Denied" %]
+    Logged-out users cannot use the "ids" argument to this function
+    to access any user information.
+
+  [% ELSIF error == "user_access_by_match_denied" %]
+    [% title = "User-Matching Denied" %]
+    Logged-out users cannot use the "match" argument to this function
+    to access any user information.
+
+  [% ELSIF error == "user_login_required" %]
+    [% title = "Login Name Required" %]
+    [% admindocslinks = {'useradmin.html' => 'User administration'} %]
+    You must enter a login name for the new user.
+
+  [% ELSIF error == "user_match_failed" %]
+    [% title = "Match Failed" %]
+    <tt>[% name FILTER html %]</tt> does not exist or you are not allowed 
+    to see that user.
+
+  [% ELSIF error == "user_match_too_many" %]
+    [% title = "No Conclusive Match" %]
+    [% terms.Bugzilla %] cannot make a conclusive match for one or more
+    of the names and/or email addresses you entered for
+    the [% fields.join(', ') FILTER html %] field(s).
+
+  [% ELSIF error == "user_not_insider" %]
+    [% title = "User Not In Insidergroup" %]
+    Sorry, but you are not allowed to (un)mark comments or attachments
+    as private.
+
+  [% ELSIF error == "wrong_token_for_cancelling_email_change" %]
+    [% title = "Wrong Token" %]
+    That token cannot be used to cancel an email address change.
+
+  [% ELSIF error == "wrong_token_for_changing_passwd" %]
+    [% title = "Wrong Token" %]
+    That token cannot be used to change your password.
+
+  [% ELSIF error == "wrong_token_for_confirming_email_change" %]
+    [% title = "Wrong Token" %]
+    That token cannot be used to change your email address.
+
+  [% ELSIF error == "wrong_token_for_creating_account" %]
+    [% title = "Wrong Token" %]
+    That token cannot be used to create a user account.
+
+  [% ELSIF error == "xmlrpc_invalid_value" %]
+    "[% value FILTER html %]" is not a valid value for a
+    &lt;[% type FILTER html %]&gt; field. (See the XML-RPC specification
+    for details.)
+
+  [% ELSIF error == "xmlrpc_illegal_content_type" %]
+    When using XML-RPC, you cannot send data as
+    [%+ content_type FILTER html %]. Allowed content types 
+    are [% constants.XMLRPC_CONTENT_TYPE_WHITELIST.join(', ') FILTER html %].
+
+  [% ELSIF error == "zero_length_file" %]
+    [% title = "File Is Empty" %]
+    The file you are trying to attach is empty, does not exist, or you don't
+    have permission to read it.
+
+  [% ELSIF error == "illegal_user_id" %]
+    [% title = "Illegal User ID" %]
+    User ID '[% userid FILTER html %]' is not valid integer.
+
+  [% ELSIF error == "extern_id_exists" %]
+    [% title = "Account Already Exists" %]
+    There is already an account
+    [% IF existing_login_name %]
+      ([% existing_login_name FILTER html %])
+    [% END %]
+    with the External Login ID "[% extern_id FILTER html %]".
+
+  [% ELSE %]
+
+    [%# Try to find hooked error messages %]
+    [% error_message = Hook.process("errors") %]
+
+    [% IF not error_message %]
+      [% title = "Error string not found" %]
+      The user error string <code>[% error FILTER html %]</code> was not found.
+      Please send email to [% Param("maintainer") %] describing the steps taken
+      to obtain this message.
+    [% ELSE %]
+      [% error_message FILTER none %]
+    [% END %]
+  [% END %]
+[% END %]
+
+[%# We only want HTML error messages for ERROR_MODE_WEBPAGE %]
+[% USE Bugzilla %]
+[% IF Bugzilla.error_mode != constants.ERROR_MODE_WEBPAGE %]
+  [% IF Bugzilla.usage_mode == constants.USAGE_MODE_BROWSER %]
+    [% error_message FILTER none %]
+  [% ELSE %]
+    [% error_message FILTER txt %]
+  [% END %]
+  [% RETURN %]
+[% END %]
+
+[% UNLESS header_done %]
+  [% PROCESS global/header.html.tmpl %]
+[% END %]
+
+[% PROCESS global/docslinks.html.tmpl
+   docslinks      = docslinks
+   admindocslinks = admindocslinks
+%]
+
+<table cellpadding="20">
+  <tr>
+    <td id="error_msg" class="throw_error">
+      [% error_message FILTER none %]
+    </td>
+  </tr>
+</table>
+
+<p>
+  Please press <b>Back</b> and try again.
+</p>
+
+[%# If a saved search fails, people want the ability to edit or delete it. 
+  # This is the best way of getting information about that possible saved
+  # search from any error call location. %]
+
+[% namedcmd = Bugzilla.cgi.param("namedcmd") %]
+[% sharer_id = Bugzilla.cgi.param("sharer_id") %]
+[% IF namedcmd AND error != "missing_query" 
+               AND error != "saved_search_used_by_whines"
+               AND !sharer_id %]
+  <p>  
+    Alternatively, you can    
+    <a href="buglist.cgi?cmdtype=dorem&amp;remaction=forget&amp;namedcmd=
+                  [% namedcmd FILTER uri %]">forget</a>
+                  
+    [% FOREACH q = Bugzilla.user.queries %]
+      [% IF q.name == namedcmd %]
+        or <a href="query.cgi?[% q.url FILTER html %]">edit</a>
+      [% END %]
+    [% END %]
+    
+    the saved search '[% namedcmd FILTER html %]'.
+  </p>
+[% END %]            
+
+[% PROCESS global/footer.html.tmpl %]
+
+[% BLOCK object_name %]
+  [% IF class == "Bugzilla::Attachment" %]
+    attachment
+  [% ELSIF class == "Bugzilla::User" %]
+    user
+  [% ELSIF class == "Bugzilla::Classification" %]
+    classification
+  [% ELSIF class == "Bugzilla::Product" %]
+    product
+  [% ELSIF class == "Bugzilla::Component" %]
+    component
+  [% ELSIF class == "Bugzilla::Version" %]
+    version
+  [% ELSIF class == "Bugzilla::Milestone" %]
+    milestone
+  [% ELSIF class == "Bugzilla::Status" %]
+    status
+  [% ELSIF class == "Bugzilla::Flag" %]
+    flag
+  [% ELSIF class == "Bugzilla::FlagType" %]
+    flagtype
+  [% ELSIF class == "Bugzilla::Field" %]
+    field
+  [% ELSIF class == "Bugzilla::Group" %]
+    group
+  [% ELSIF class == "Bugzilla::Keyword" %]
+    keyword
+  [% ELSIF class == "Bugzilla::Search::Recent" %]
+    recent search
+  [% ELSIF class == "Bugzilla::Search::Saved" %]
+    saved search
+  [% ELSIF ( matches = class.match('^Bugzilla::Field::Choice::(.+)') ) %]
+    [% SET field_name = matches.0 %]
+    [% field_descs.$field_name FILTER html %]
+  [% END %]
+  [% Hook.process('end_object_name', 'global/user-error.html.tmpl') %]
+[% END %]

diff --git a/template/en/default/global/user.html.tmpl b/template/en/default/global/user.html.tmpl
new file mode 100644 (file)
index 0000000..7050c6d
--- /dev/null
+++ b/template/en/default/global/user.html.tmpl
@@ -0,0 +1,26 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # who: A Bugzilla::User object that we are going to represent.
+  #%]
+
+<span class="vcard">
+  [% FILTER collapse %]
+    [% IF user.id %]
+      <a class="email" href="mailto:[% who.email FILTER html %]"
+         title="[% who.identity FILTER html %]">
+    [%- END -%]
+    [% IF who.name %]
+       <span class="fn">[% who.name FILTER html %]</span>
+    [% ELSE %]
+      [% who.login FILTER email FILTER html %]
+    [% END %]
+    [% '</a>' IF user.id %]
+  [% END %]
+</span>

diff --git a/template/en/default/global/userselect.html.tmpl b/template/en/default/global/userselect.html.tmpl
new file mode 100644 (file)
index 0000000..828c4bb
--- /dev/null
+++ b/template/en/default/global/userselect.html.tmpl
@@ -0,0 +1,99 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # name: mandatory; field name
+  # id: optional; field id
+  # value: optional; default field value/selection
+  # classes: optional; an array of classes to be added
+  # onchange: optional; onchange attribute value
+  # disabled: optional; if true, the field is disabled
+  # accesskey: optional, input only; accesskey attribute value
+  # size: optional, input only; size attribute value
+  # emptyok: optional, select only; if true, prepend menu option for "" to start of select
+  # hyphenok: optional, select only; if true, prepend menu option for "-" to start of select
+  # multiple: optional, do multiselect box, value is size (height) of box
+  # custom_userlist: optional, specify a limited list of users to use
+  # field_title: optional, extra information to display as a tooltip
+  #%]
+
+[% IF Param("usemenuforusers") %]
+<select name="[% name FILTER html %]"
+  [% IF id %] id="[% id FILTER html %]" [% END %]
+  [% IF classes %] class="[% classes.join(' ') FILTER html %]" [% END %]
+  [% IF onchange %] onchange="[% onchange FILTER html %]" [% END %]
+  [% IF disabled %] disabled="[% disabled FILTER html %]" [% END %]
+  [% IF accesskey %] accesskey="[% accesskey FILTER html %]" [% END %]
+  [% IF multiple %] multiple="multiple" size="[% multiple FILTER html %]" [% END %]
+  [% IF field_title %] title="[% field_title FILTER html %]" [% END %]
+>
+  [% IF emptyok %]
+    <option value=""></option>
+  [% END %]
+  [% IF hyphenok %]
+    <option value="-">-</option>
+  [% END %]
+
+  [% UNLESS custom_userlist %]
+    [% custom_userlist = user.get_userlist %]
+  [% END %]
+
+  [% SET selected = {} %]
+  [% IF value.defined %]
+    [% FOREACH selected_value IN value.split(', ') %]
+      [% SET selected.$selected_value = 1 %]
+    [% END %]
+  [% END %]
+
+  [% FOREACH tmpuser = custom_userlist %]
+    [% IF tmpuser.visible OR selected.${tmpuser.login} == 1 %]
+      <option value="[% tmpuser.login FILTER html %]"
+        [% IF selected.${tmpuser.login} == 1 %]
+          selected="selected"
+          [%# A user account appears only once. Remove it from the list, so that
+            # we know if there are some selected accounts which have not been listed. %]
+          [% selected.delete(tmpuser.login) %]
+        [% END %]
+      >[% tmpuser.identity FILTER html %]</option>
+    [% END %]
+  [% END %]
+
+  [%# If the list is not empty, this means some accounts have not been mentioned yet. %]
+  [% FOREACH selected_user = selected.keys %]
+    <option value="[% selected_user FILTER html %]" selected="selected">[% selected_user FILTER html %]</option>
+  [% END %]
+</select>
+[% ELSE %]
+  [% IF feature_enabled('jsonrpc') && Param('ajax_user_autocompletion') && id %]
+    <div id="[% id FILTER html %]_autocomplete" 
+         [% IF classes %] class="[% classes.join(' ') FILTER html %]" [% END %]>
+  [% END %]  
+  <input
+    name="[% name FILTER html %]"
+    value="[% value FILTER html %]"
+    [% IF classes %] class="[% classes.join(' ') FILTER html %]" [% END %]
+    [% IF onchange %] onchange="[% onchange FILTER html %]" [% END %]
+    [% IF disabled %] disabled="[% disabled FILTER html %]" [% END %]
+    [% IF accesskey %] accesskey="[% accesskey FILTER html %]" [% END %]
+    [% IF field_title %] title="[% field_title FILTER html %]" [% END %]
+    [% IF size %] size="[% size FILTER html %]" [% END %]
+    [% IF id %] id="[% id FILTER html %]" [% END %]
+  >
+  [% IF feature_enabled('jsonrpc') && Param('ajax_user_autocompletion') && id %]
+    <div id="[% id FILTER html %]_autocomplete_container"></div>
+    </div>  
+    <script type="text/javascript">
+      if( typeof(YAHOO.bugzilla.userAutocomplete) !== 'undefined' 
+          && YAHOO.bugzilla.userAutocomplete != null){
+        YAHOO.bugzilla.userAutocomplete.init( "[% id FILTER js %]", 
+                    "[% id FILTER js %]_autocomplete_container"
+                    [% IF multiple %], true[% END%]);        
+      }
+    </script>
+  [% END %]
+[% END %]

diff --git a/template/en/default/global/value-descs.js.tmpl b/template/en/default/global/value-descs.js.tmpl
new file mode 100644 (file)
index 0000000..7e79d10
--- /dev/null
+++ b/template/en/default/global/value-descs.js.tmpl
@@ -0,0 +1,21 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS "global/value-descs.none.tmpl" %]
+
+BUGZILLA.value_descs = {
+  [% FOREACH vd_field = value_descs.keys %]
+    [% vd_field FILTER js %]: {
+      [% FOREACH vd_value = value_descs.${vd_field}.keys %]
+        '[% vd_value FILTER js %]':
+        '[% value_descs.${vd_field}.${vd_value} FILTER js %]'
+        [%~ ',' UNLESS loop.last %]
+      [% END %]
+    }[% ',' UNLESS loop.last %]
+  [% END %]
+};

diff --git a/template/en/default/global/value-descs.none.tmpl b/template/en/default/global/value-descs.none.tmpl
new file mode 100644 (file)
index 0000000..a6aa814
--- /dev/null
+++ b/template/en/default/global/value-descs.none.tmpl
@@ -0,0 +1,24 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# You can use this hash to localize (translate) the values displayed
+  # for drop-down and multiple-select fields. Lines starting with "#"
+  # are comments.
+  #%]
+[% value_descs = {
+  "bug_status" => {
+    # "UNCONFIRMED" => "UNCO",
+    # "CONFIRMED"   => "ITSABUG",
+  },
+
+  "resolution" => {
+    ""        => "---",
+    # "FIXED"      => "NO LONGER AN ISSUE",
+    # "WORKSFORME" => "NOTMYPROBLEM!",
+  },
+} %]

diff --git a/template/en/default/global/variables.none.tmpl b/template/en/default/global/variables.none.tmpl
new file mode 100644 (file)
index 0000000..9e411e3
--- /dev/null
+++ b/template/en/default/global/variables.none.tmpl
@@ -0,0 +1,33 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# This is a list of terms that may be changed to "brand" the Bugzilla 
+  # instance (for example, referring to "bugs" as "issues".) When used, these
+  # strings are used in several different types of content, and are not  
+  # protected with Template-Toolkit FILTERs. Consequently, no special 
+  # characters are allowed.
+  #
+  # Remember to PROCESS rather than INCLUDE this template. 
+  #%]
+
+[% terms = {
+  "bug" => "bug",
+  "Bug" => "Bug",
+  "abug" => "a bug",
+  "Abug" => "A bug",
+  "aBug" => "a Bug",
+  "ABug" => "A Bug",
+  "bugs" => "bugs",
+  "Bugs" => "Bugs",
+  "zeroSearchResults" => "Zarro Boogs found",
+  "Bugzilla" => "Bugzilla"
+  }
+%]
+
+[% USE Hook %]
+[% Hook.process("end") %]

diff --git a/template/en/default/index.html.tmpl b/template/en/default/index.html.tmpl
new file mode 100644 (file)
index 0000000..b47b912
--- /dev/null
+++ b/template/en/default/index.html.tmpl
@@ -0,0 +1,173 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # release: a hash containing data about new releases, if any.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+   title = "$terms.Bugzilla Main Page"
+   header = "Main Page" 
+   header_addl_info = "version $constants.BUGZILLA_VERSION"
+   style_urls = [ 'skins/standard/index.css' ]
+%]
+
+
+<script type="text/javascript">
+<!--
+function onLoadActions() {
+  quicksearchHelpText('quicksearch_main', 'show');
+  if( window.external.AddSearchProvider ){
+    YAHOO.util.Dom.removeClass('quicksearch_plugin', 'bz_default_hidden');
+  }
+  document.getElementById('quicksearch_top').focus();
+}
+var quicksearch_message = "Enter [% terms.abug %] # or some search terms";
+
+function checkQuicksearch( form ) {
+  if (form.quicksearch.value == '' || form.quicksearch.value == quicksearch_message ) { 
+    alert('Please enter one or more search terms first.');
+    return false; 
+  }
+  return true;         
+}
+
+function quicksearchHelpText(el_id, action){
+  var el = document.getElementById(el_id);
+  if ( action == "show") {
+    if( el.value == "" ) {
+      el.value = quicksearch_message
+      YAHOO.util.Dom.addClass(el, "quicksearch_help_text");
+    }
+  } else {
+    if( el.value == quicksearch_message ) {
+      el.value = "";
+      YAHOO.util.Dom.removeClass(el, "quicksearch_help_text");
+    }
+  }
+}
+YAHOO.util.Event.onDOMReady(onLoadActions);
+//-->
+</script>
+
+[% IF release %]
+  <div id="new_release">
+    [% IF release.data %]
+      [% IF release.deprecated %]
+        <p>[% terms.Bugzilla %] [%+ release.deprecated FILTER html %] is no longer
+        supported. You are highly encouraged to upgrade in order to keep your
+        system secure.</p>
+      [% END %]
+
+      <p>A new [% terms.Bugzilla %] version ([% release.data.latest_ver FILTER html %])
+      is available at
+      <a href="[% release.data.url FILTER html %]">[% release.data.url FILTER html %]</a>.<br>
+      Release date: [% release.data.date FILTER html %]</p>
+
+      <p class="notice">This message is only shown to logged in users with admin privs.
+      You can configure this notification from the
+      <a href="editparams.cgi?section=general#upgrade_notification_desc">Parameters</a> page.</p>
+    [% ELSIF release.error == "cannot_download" %]
+      <p>The remote file <a href="[% constants.REMOTE_FILE FILTER html %]">
+      [%~ constants.REMOTE_FILE FILTER html %]</a> cannot be downloaded
+      (reason: [% release.reason FILTER html %]).<br>
+      Either the remote server is temporarily unavailable, or your web server cannot access
+      the web. If you are behind a proxy, set the
+      <a href="editparams.cgi?section=advanced#proxy_url_desc">proxy_url</a> parameter correctly.</p>
+    [% ELSIF release.error == "no_write" %]
+      <p>The local XML file '[% constants.LOCAL_FILE FILTER html %]' cannot be created
+      (reason: [% release.reason FILTER html %]).<br>
+      Please make sure the web server can write into this directory.
+    [% ELSIF release.error == "no_update" %]
+      <p>The local XML file '[% constants.LOCAL_FILE FILTER html %]' cannot be updated.
+      Please make sure the web server can edit this file.</p>
+    [% ELSIF release.error == "no_access" %]
+      <p>The local XML file '[% constants.LOCAL_FILE FILTER html %]' cannot be read.
+      Please make sure this file has the correct rights set on it.</p>
+    [% ELSIF release.error == "corrupted" %]
+      <p>The local XML file '[% constants.LOCAL_FILE FILTER html %]' has an invalid XML format.
+      Please delete it and try accessing this page again.</p>
+    [% ELSIF release.error == "unknown_parameter" %]
+      <p>'[% Param("upgrade_notification") FILTER html %]' is not a valid notification
+      parameter. Please check this parameter in the
+      <a href="editparams.cgi?section=general#upgrade_notification_desc">Parameters</a> page.</p>
+    [% END %]
+  </div>
+[% END %]
+
+<div id="page-index">
+  <table>
+    <tr>
+      <td>
+        <h1 id="welcome"> Welcome to [% terms.Bugzilla %]</h1>
+        <div class="intro">[% Hook.process('intro') %]</div>
+
+        <div class="bz_common_actions">
+          <ul>
+            <li>
+              <a id="enter_bug" href="enter_bug.cgi"><span>File
+              [%= terms.aBug %]</span></a>
+            </li>
+            <li>
+              <a id="query" href="query.cgi"><span>Search</span></a>
+            </li>
+            <li>
+              <a id="account"
+                 [% IF user.id %]
+                   href="userprefs.cgi"><span>User Preferences</span></a>
+                 [% ELSIF Param('createemailregexp')
+                          && user.authorizer.user_can_create_account 
+                 %]
+                   href="createaccount.cgi"><span>Open a New Account</span></a>
+                 [% ELSE %]
+                   href="?GoAheadAndLogIn=1"><span>Log In</span></a>
+                 [% END %]
+            </li>
+          </ul>
+        </div>
+
+        <form id="quicksearchForm" name="quicksearchForm" action="buglist.cgi"
+              onsubmit="return checkQuicksearch(this);">
+          <div>
+            <input id="quicksearch_main" type="text" name="quicksearch"
+              title="Quick Search" 
+              onfocus="quicksearchHelpText(this.id, 'hide');"
+              onblur="quicksearchHelpText(this.id, 'show');"
+            >
+            <input id="find" type="submit" value="Quick Search">
+            <ul class="additional_links" id="quicksearch_links">
+              <li>
+                <a href="page.cgi?id=quicksearch.html">Quick Search help</a>
+              </li>
+              <li class="bz_default_hidden" id="quicksearch_plugin">
+                |
+                <a href="javascript:window.external.AddSearchProvider('[% urlbase FILTER html %]search_plugin.cgi')">
+                 Install the Quick Search plugin
+                </a>
+              </li>
+            </ul>
+            <ul class="additional_links">
+              <li>
+                <a href="[% docs_urlbase FILTER html %]using.html">
+                  [%- terms.Bugzilla %] User's Guide</a>
+              </li>
+              <li>
+                |
+                <a href="page.cgi?id=release-notes.html">Release Notes</a>
+              </li>
+              [% Hook.process('additional_links') %]
+            </ul>
+          </div>
+        </form>
+        <div class="outro">[% Hook.process('outro') %]</div>
+      </td>
+    </tr>
+  </table>
+</div>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/list/change-columns.html.tmpl b/template/en/default/list/change-columns.html.tmpl
new file mode 100644 (file)
index 0000000..17d711e
--- /dev/null
+++ b/template/en/default/list/change-columns.html.tmpl
@@ -0,0 +1,131 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+  title = "Change Columns"
+  javascript_urls = "js/change-columns.js"
+  onload = "initChangeColumns()"
+%]
+
+<p>
+  Select the columns you wish to appear in your [% terms.bug %] lists. Note that
+  this feature requires cookies to work.
+</p>
+
+[% field_descs.short_short_desc     = "Summary (first 60 characters)" %]
+[% field_descs.short_desc           = "Summary (Full)" %]
+[% field_descs.assigned_to_realname = "$field_descs.assigned_to Real Name" %]
+[% field_descs.reporter_realname    = "$field_descs.reporter Real Name" %]
+[% field_descs.qa_contact_realname  = "$field_descs.qa_contact Real Name" %]
+
+[%# Create a mapping of field descriptions to field names, so that
+  # the "Available Columns" list can be sorted alphabetically by
+  # field description.
+  #%]
+[% SET available_columns = {} %]
+[% FOREACH column = columns.keys %]
+  [% NEXT IF collist.contains(column) %]
+  [%# We lowecase the keys so that the sort happens case-insensitively. %]
+  [% SET column_desc = field_descs.$column || column FILTER lower %]
+  [% available_columns.$column_desc = column %]
+[% END %]
+
+<form name="changecolumns" action="colchange.cgi" onsubmit="change_submit();">
+  <input type="hidden" name="rememberedquery" value="[% buffer FILTER html %]">
+    <table>
+      <tr>
+        <th><div id="avail_header" class="bz_default_hidden">Available Columns</div></th>
+        <th></th>
+        <th colspan="2">Selected Columns</th>
+      </tr>
+      <tr>
+        <td>
+          <select name="available_columns" id="available_columns" 
+                  size="15" multiple="multiple" onchange="updateView();"
+                  class="bz_default_hidden"> 
+          </select>
+        </td>
+        <td>
+          <button type="button" id="select_button" name="select"
+                  class="bz_default_hidden arrow_button"
+                  onclick="move_select()">&rarr;</button>
+          <br><br>
+          <button type="button" id="deselect_button" name="deselect"
+                  class="bz_default_hidden arrow_button"
+                  onclick="move_deselect()">&larr;</button>
+        </td>
+        <td>
+          <select name="selected_columns" id="selected_columns" 
+                  size="15" multiple="multiple" onchange="updateView();">
+            [% FOREACH column = collist %]
+                <option value="[% column FILTER html %]" selected="selected">
+                [% (field_descs.${column} || column) FILTER html %]
+              </option>
+            [% END %]
+            [% FOREACH key = available_columns.keys.sort %]
+              [% SET column = available_columns.$key %]
+              <option value="[% column FILTER html %]">
+                [%# Don't display the lower-cased column description,
+                  # display the correct-case one. %]
+                [% (field_descs.$column || column) FILTER html %]
+              </option>
+            [% END %]
+          </select>
+        </td>
+        <td>
+          <button type="button" id="up_button" name="up"
+                  class="bz_default_hidden arrow_button"
+                  onclick="move_up()">&uarr;</button>
+          <br><br>
+          <button type="button" id="down_button" name="down"
+                  class="bz_default_hidden arrow_button"
+                  onclick="move_down()">&darr;</button>
+        </td>
+      </tr>
+    </table>
+
+  <p>
+    <input id="nosplitheader" type="radio" name="splitheader" value="0"
+      [%+ "checked='checked'" IF NOT splitheader %]>
+    <label for="nosplitheader">
+      Normal headers (prettier)
+    </label>
+    <br>
+
+    <input id="splitheader" type="radio" name="splitheader" value="1"
+      [%+ "checked='checked'" IF splitheader %]>
+    <label for="splitheader">
+      Stagger headers (often makes list more compact)
+    </label>
+  </p>
+
+  [% IF saved_search %]
+    <p>
+      <input type="hidden" name="saved_search"
+             value="[% saved_search.id FILTER html%]" >
+      <input type="hidden" name="token"
+             value="[% issue_hash_token([saved_search.id, saved_search.name]) FILTER html %]">
+      <input type="checkbox" id="save_columns_for_search" checked="checked" 
+             name="save_columns_for_search" value="1">
+      <label for="save_columns_for_search">Save this column list only 
+        for search '[% saved_search.name FILTER html %]'</label>
+    </p>
+  [% ELSE %]
+    <input type="hidden" name="token"
+           value="[% issue_hash_token(['default-list']) FILTER html %]">
+  [% END %]
+
+  <p>
+    <input type="submit" id="change" value="Change Columns">
+  </p>
+
+  <input type="submit" id="resetit" name="resetit" 
+         value="Reset to [% terms.Bugzilla %] default">
+</form>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/list/edit-multiple.html.tmpl b/template/en/default/list/edit-multiple.html.tmpl
new file mode 100644 (file)
index 0000000..962f36f
--- /dev/null
+++ b/template/en/default/list/edit-multiple.html.tmpl
@@ -0,0 +1,429 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% dontchange = "--do_not_change--" %]
+<input type="hidden" name="dontchange" value="[% dontchange FILTER html %]">
+<input type="hidden" name="token" value="[% token FILTER html %]">
+
+<script type="text/javascript">
+  function SetCheckboxes(value) {
+      var elements = document.forms.changeform.getElementsByTagName('input'),
+          numelements = elements.length,
+          item, i;
+      for (i = 0; i < numelements; i++) {
+          item = elements[i];
+          if (item.type === 'checkbox' && item.name.match(/^id_/)) {
+            item.checked = value;
+          }
+      }
+  }
+  document.write(' <input type="button" name="uncheck_all" value="Uncheck All" onclick="SetCheckboxes(false);">');
+  document.write(' <input type="button" name="check_all" value="Check All" onclick="SetCheckboxes(true);">');
+</script>
+
+<hr>
+
+<p style="font-size:smaller">
+ To change multiple [% terms.bugs %]:</p>
+<ol style="font-size:smaller">
+  <li>Check the [% terms.bugs %] you want to change above.</li>
+  <li>Make your changes in the form fields below.  If the change
+   you are making requires an explanation, include it in
+   the comments box.</li>
+  <li>Click the <em>Commit</em> button.</li>
+</ol>
+
+<table id="form">
+  <tr>
+
+    <th><label for="product">Product:</label></th>
+    <td>
+      [% PROCESS selectmenu menuname = "product"
+                            menuitems = products
+                            property = "name" %]
+    </td>
+
+    <th><label for="version">Version:</label></th>
+    <td>
+      [% PROCESS selectmenu menuname = "version"
+                            menuitems = versions
+                            property = "" %]
+    </td>
+
+  </tr>
+  <tr>
+
+    <th><label for="component">Component:</label></th>
+    <td>
+      [% PROCESS selectmenu menuname = "component"
+                            menuitems = components %]
+    </td>
+
+    <th>
+      <label for="priority">
+        <a href="page.cgi?id=fields.html#priority">Priority</a>:
+      </label>
+    </th>
+    <td>
+      [% PROCESS selectmenu menuname = "priority"
+                            menuitems = priorities %]
+    </td>
+
+  </tr>
+  <tr>
+
+    <th>
+      <label for="rep_platform">
+        <a href="page.cgi?id=fields.html#rep_platform">
+          [% field_descs.rep_platform FILTER html %]</a>:
+      </label>
+    </th>
+    <td>
+      [% PROCESS selectmenu menuname = "rep_platform"
+                            menuitems = platforms %]
+    </td>
+
+    <th>
+      <label for="bug_severity">
+        <a href="page.cgi?id=fields.html#bug_severity">
+          [% field_descs.bug_severity FILTER html %]</a>:
+      </label>
+    </th>
+    <td>
+      [% PROCESS selectmenu menuname = "bug_severity"
+                            menuitems = severities %]
+    </td>
+
+  </tr>
+
+  <tr>
+    <th>
+      <label for="op_sys">
+        <a href="page.cgi?id=fields.html#op_sys">[% field_descs.op_sys FILTER html %]</a>:
+      </label>
+    </th>
+    <td [% " colspan=\"3\"" IF !Param("usetargetmilestone") %]>
+      [% PROCESS selectmenu menuname = "op_sys"
+                            menuitems = op_sys %]
+    </td>
+
+    [% IF Param("usetargetmilestone") %]
+      <th><label for="target_milestone">Target Milestone:</label></th>
+      <td>
+        [% PROCESS selectmenu menuname = "target_milestone"
+                              menuitems = targetmilestones %]
+      </td>
+    [% END %]
+  </tr>
+  
+  <tr>
+    <th><label for="bug_status">Status:</label></th>
+    <td colspan="3">[% PROCESS status_section %]</td>
+  </tr>
+  [% IF user.is_timetracker %]
+    <tr>
+      [% INCLUDE "bug/field-label.html.tmpl"
+         field = bug_fields.estimated_time, editable = 1
+      %]
+      <td>
+        <input id="estimated_time"
+               name="estimated_time"
+               value="[% dontchange FILTER html %]"
+               size="6">
+      </td>
+      [% PROCESS bug/field.html.tmpl 
+          field = bug_fields.deadline, value = dontchange
+          editable = 1, allow_dont_change = 1 %]
+    </tr>
+    <tr>
+      [% INCLUDE "bug/field-label.html.tmpl"
+         field = bug_fields.remaining_time, editable = 1
+      %]
+      <td>
+        <input id="remaining_time"
+               name="remaining_time"
+               value="[% dontchange FILTER html %]"
+               size="6">
+      </td>
+      <th>&nbsp;</th>
+      <td>&nbsp;</td>
+    </tr>
+  [% END %]
+
+  <tr>
+    <th><label for="assigned_to">Assignee:</label></th>
+    <td colspan="3">
+      [% INCLUDE global/userselect.html.tmpl
+           id => "assigned_to"
+           name => "assigned_to"
+           value => dontchange
+           size => 40
+      %]
+      <input type="checkbox" id="set_default_assignee" name="set_default_assignee" value="1">
+      <label for="set_default_assignee">Reset Assignee to default</label>
+    </td>
+  </tr>
+
+  [% IF Param("useqacontact") %]
+    <tr>
+      <th><label for="qa_contact">QA Contact:</label></th>
+      <td colspan="3">
+        [% INCLUDE global/userselect.html.tmpl
+             id => "qa_contact"
+             name => "qa_contact"
+             value => dontchange
+             size => 40
+        %]
+        <input type="checkbox" id="set_default_qa_contact" name="set_default_qa_contact" value="1">
+        <label for="set_default_qa_contact">Reset QA Contact to default</label>
+      </td>
+    </tr>
+  [% END %]
+
+  <tr>
+
+    <th><label for="masscc">CC List:</label></th>
+    <td colspan="3">
+      [% INCLUDE global/userselect.html.tmpl
+           id => "masscc"
+           name => "masscc"
+           value => ""
+           size => 40
+           multiple => 5
+      %]
+      <select name="ccaction">
+        <option value="add">Add these to the CC List</option>
+        <option value="remove">Remove these from the CC List</option>
+      </select>
+    </td>
+
+  </tr>
+
+  [% IF use_keywords %]
+    <tr>
+
+      [% INCLUDE "bug/field-label.html.tmpl"
+         field = bug_fields.keywords, editable = 1
+         desc_url = "describekeywords.cgi"
+      %]
+      <td colspan="3">
+        [% INCLUDE bug/field.html.tmpl
+           field = bug_fields.keywords, editable = 1, value = keywords
+           no_tds = 1
+        %]
+        <select name="keywordaction">
+          <option value="add">Add these keywords</option>
+          <option value="remove">Delete these keywords</option>
+          <option value="set">Make the keywords be exactly this list</option>
+        </select>
+      </td>
+
+    </tr>
+  [% END %]
+
+  <tr>
+    <th>
+      <label for="dependson">
+          Depends On:
+      </label>
+    </th>
+    <td colspan="3">
+      <input id="dependson" name="dependson" size="40">
+      <select name="dependson_action">
+          <option value="add">Add these IDs</option>
+          <option value="remove">Delete these IDs</option>
+      </select>
+    </td>
+  </tr>
+
+  <tr>
+    <th>
+      <label for="blocked">
+          Blocks:
+      </label>
+    </th>
+    <td colspan="3">
+      <input id="blocked" name="blocked" size="40">
+      <select name="blocked_action">
+          <option value="add">Add these IDs</option>
+          <option value="remove">Delete these IDs</option>
+      </select>
+    </td>
+  </tr>
+
+  [% IF Param('usestatuswhiteboard') %]
+    <tr>
+      <td align="right">
+        <b>Status Whiteboard:</b>
+      </td>
+      <td colspan="7">
+        <input name="status_whiteboard" 
+               value="[% dontchange FILTER html %]" size="60">
+      </td>
+    </tr>
+  [% END %]
+
+  [% USE Bugzilla %]
+  [%# Show all legal values and all fields, ignoring visibility controls. %]
+  [% bug = 0 %]
+  [% FOREACH field = Bugzilla.active_custom_fields %]
+    <tr>
+      [% PROCESS bug/field.html.tmpl value = dontchange
+                                     editable = 1
+                                     allow_dont_change = 1 %]
+    </tr>
+  [% END %]
+
+  [% Hook.process("after_custom_fields") %]
+
+</table>
+
+<b><label for="comment">Additional Comments:</label></b>
+[% IF user.is_insider %]
+  <input type="checkbox" name="comment_is_private" value="1"
+         id="newcommentprivacy"
+         onClick="updateCommentTagControl(this, form)"/>
+   <label for="newcommentprivacy">
+     Make comment private (visible only to members of the
+     <strong>[% Param('insidergroup') FILTER html %]</strong> group)
+   </label>
+[% END %]
+<br>
+[% INCLUDE global/textarea.html.tmpl
+  name    = 'comment'
+  id      = 'comment'
+  minrows = 5
+  maxrows = 25
+  cols    = constants.COMMENT_COLS
+%]<br>
+
+[% Hook.process('before_groups') %]
+
+[% IF groups.size > 0 %]
+
+  <script type="text/javascript">
+    function turn_off(myself, id) {
+        var other_checkbox = document.getElementById(id);
+        if (myself.checked && other_checkbox) {
+            other_checkbox.checked = false;
+        }
+    }
+  </script>
+
+  <b>Groups:</b><br>
+  <table border="1">
+    <tr>
+      <th>Remove<br>[% terms.bugs %]<br>from this<br>group</th>
+      <th>Add<br>[% terms.bugs %]<br>to this<br>group</th>
+      <th>Group Name:</th>
+    </tr>
+
+    [% FOREACH group = groups %]
+    <tr>
+      <td align="center">
+        <input type="checkbox" name="defined_groups" 
+               id="defined_group_[% group.id %]"
+               value="[% group.name FILTER html %]"
+               onchange="turn_off(this, 'group_[% group.id %]')">
+      </td>
+      [% IF group.is_active %]
+        <td align="center">
+          <input type="checkbox" name="groups" 
+                 id="group_[% group.id FILTER html %]"
+                 value="[% group.name FILTER html %]"
+                 onchange="turn_off(this, 'defined_group_[% group.id %]')">
+        </td>
+      [% ELSE %]
+        <td>&nbsp;</td>
+        [% foundinactive = 1 %]
+      [% END %]
+
+      <td>
+        [% SET inactive = !group.is_active %]
+        [% group.description FILTER html_light FILTER inactive(inactive) %]
+      </td>
+
+    </tr>
+    [% END %]
+
+  </table>
+
+  [% IF foundinactive %]
+    <p style="font-size:smaller">(Note: [% terms.Bugs %] may not be added to [% FILTER inactive %]inactive
+    groups[% END %], only removed.)</p>
+  [% END %]
+
+[% END %]
+
+[%+ Hook.process('after_groups') %]
+
+<input type="submit" id="commit" value="Commit">
+
+[%############################################################################%]
+[%# Select Menu Block                                                        #%]
+[%############################################################################%]
+
+[% BLOCK selectmenu %]
+  <select id="[% menuname %]" name="[% menuname %]">
+    <option value="[% dontchange FILTER html %]" selected="selected">
+      [% dontchange FILTER html %]
+    </option>
+    [% FOREACH menuitem = menuitems %]
+      [% IF property %][% menuitem = menuitem.$property %][% END %]
+      <option value="[% menuitem FILTER html %]">[% display_value(menuname, menuitem) FILTER html %]</option>
+    [% END %]
+  </select>
+[% END %]
+
+[%############################################################################%]
+[%# Status Block                                                             #%]
+[%############################################################################%]
+
+[% BLOCK status_section %]
+  [% all_open_bugs = !current_bug_statuses.containsany(closedstates) %]
+  [% all_closed_bugs = !current_bug_statuses.containsany(openstates) %]
+  [% closed_status_array = [] %]
+  
+  <select name="bug_status" id="bug_status"> 
+    <option value="[% dontchange FILTER html %]" selected="selected">[% dontchange FILTER html %]</option>
+  
+    [% FOREACH bug_status = new_bug_statuses %]
+      <option value="[% bug_status.name FILTER html %]">
+        [% display_value("bug_status", bug_status.name) FILTER html %]
+      </option>
+      [% IF !bug_status.is_open %]
+        [% filtered_status =  bug_status.name FILTER js %]
+        [% closed_status_array.push( filtered_status ) %]
+      [% END %]
+    [% END %]
+  
+  [%# If all the bugs being changed are closed, allow the user to change their resolution. %]
+  [% IF all_closed_bugs %]
+    [% filtered_status = dontchange FILTER js %]
+    [% closed_status_array.push( filtered_status ) %]
+  [% END %]
+  </select>
+  
+  <span id="resolution_settings">
+  <select id="resolution" name="resolution">
+      <option value="[% dontchange FILTER html %]" selected >[% dontchange FILTER html %]</option>
+    [% FOREACH r = resolutions %]
+      [% NEXT IF !r %]
+      [% NEXT IF r == "DUPLICATE" || r == "MOVED" %]
+      <option value="[% r FILTER html %]">[% display_value("resolution", r) FILTER html %]</option>
+    [% END %]
+  </select>
+  </span>
+
+  <script type="text/javascript">
+  var close_status_array = new Array("[% closed_status_array.join('", "') FILTER none %]");
+    YAHOO.util.Event.addListener('bug_status', "change", showHideStatusItems, '[% "is_duplicate" IF bug.dup_id %]');
+    YAHOO.util.Event.onDOMReady( showHideStatusItems );
+  </script>
+
+[% END %]

diff --git a/template/en/default/list/list-simple.html.tmpl b/template/en/default/list/list-simple.html.tmpl
new file mode 100644 (file)
index 0000000..24e2bcf
--- /dev/null
+++ b/template/en/default/list/list-simple.html.tmpl
@@ -0,0 +1,32 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # title: string. The title for this page. (optional)
+  #%]
+
+[% DEFAULT title = "$terms.Bug List" %]
+
+<html>
+
+  <head>
+    <title>[% title FILTER html %]</title>
+    <base href="[% urlbase FILTER html %]">
+    <link href="[% 'skins/standard/buglist.css' FILTER mtime %]" 
+          rel="stylesheet" type="text/css">
+  </head>
+
+  <body>
+    [% IF bugs.size == 0 %]
+      <h3>[% terms.zeroSearchResults %].</h3>
+    [% ELSE %]
+      [% PROCESS list/table.html.tmpl %]
+    [% END %]
+  </body>
+
+</html>

diff --git a/template/en/default/list/list.atom.tmpl b/template/en/default/list/list.atom.tmpl
new file mode 100644 (file)
index 0000000..fddbbd7
--- /dev/null
+++ b/template/en/default/list/list.atom.tmpl
@@ -0,0 +1,82 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% DEFAULT title = "$terms.Bugzilla $terms.Bugs" %]
+
+<?xml version="1.0"[% IF Param('utf8') %] encoding="UTF-8"[% END %]?>
+<feed xmlns="http://www.w3.org/2005/Atom">
+  <title>[% title FILTER xml %]</title>
+  <link rel="alternate" type="text/html"
+        href="[% urlbase FILTER html %]buglist.cgi?
+        [%- urlquerypart.replace('ctype=atom[&]?','') FILTER xml %]"/>
+  <link rel="self" type="application/atom+xml"
+        href="[% urlbase FILTER html %]buglist.cgi?
+        [%- urlquerypart FILTER xml %]"/>
+  <updated>[% bugs.sort('changedtime').last.changedtime FILTER time("%Y-%m-%dT%H:%M:%SZ", "UTC")
+    FILTER xml %]</updated>
+  <id>[% urlbase FILTER html %]buglist.cgi?[% urlquerypart FILTER xml %]</id>
+
+  [% FOREACH bug = bugs %]
+  <entry>
+    <title>[% "@" IF bug.secure_mode %][[% terms.Bug %] [%+ bug.bug_id FILTER xml %]] [% bug.short_desc FILTER xml %]</title>
+    <link rel="alternate" type="text/html"
+          href="[% urlbase FILTER html %]show_bug.cgi?id=
+          [%- bug.bug_id FILTER xml %]"/>
+    <id>[% urlbase FILTER xml %]show_bug.cgi?id=[% bug.bug_id FILTER xml %]</id>
+    <author>
+      <name>[% bug.reporter_realname ? bug.reporter_realname : bug.reporter FILTER xml %]</name>
+    </author>
+    <updated>[% bug.changedtime FILTER time("%Y-%m-%dT%H:%M:%SZ", "UTC") FILTER xml %]</updated>
+    <summary type="html">
+      [%# Filter out the entire block, so that we don't need to escape the html code out %]
+      [% FILTER xml %]
+      <table>
+      <tr>
+        <th>Field</th><th>Value</th>
+      </tr><tr class="bz_feed_product">
+        <td>[% columns.product.title FILTER html %]</td>
+        <td>[% bug.product FILTER html %]</td>
+      </tr><tr class="bz_feed_component">
+        <td>[% columns.component.title FILTER html %]</td>
+        <td>[% bug.component FILTER html %]</td>
+      </tr><tr class="bz_feed_assignee">
+        <td>[% columns.assigned_to_realname.title FILTER html %]</td>
+        <td>[% bug.assigned_to_realname ? bug.assigned_to_realname : bug.assigned_to FILTER html %]</td>
+      </tr><tr class="bz_feed_reporter">
+        <td>[% columns.reporter_realname.title FILTER html %]</td>
+        <td>[% bug.reporter_realname ? bug.reporter_realname : bug.reporter FILTER html %]</td>
+      </tr><tr class="bz_feed_bug_status">
+        <td>[% columns.bug_status.title FILTER html %]</td>
+        <td>[% display_value("bug_status", bug.bug_status) FILTER html %]</td>
+      </tr><tr class="bz_feed_resolution">
+        <td>[% columns.resolution.title FILTER html %] </td>
+        <td>[% display_value("resolution", bug.resolution) FILTER html %]</td>
+      </tr><tr class="bz_feed_priority">
+        <td>[% columns.priority.title FILTER html %]</td>
+        <td>[% display_value("priority", bug.priority) FILTER html %]</td>
+      </tr><tr class="bz_feed_severity">
+        <td>[% columns.bug_severity.title FILTER html %] </td>
+        <td>[% display_value("bug_severity", bug.bug_severity) FILTER html %]</td>
+      [% IF Param("usetargetmilestone") %]
+      </tr><tr class="bz_feed_target_milestone">
+        <td>[% columns.target_milestone.title FILTER html %]</td>
+        <td>[% bug.target_milestone FILTER html %]</td>
+      [% END %]
+      </tr><tr class="bz_feed_creation_date">
+        <td>[% columns.opendate.title FILTER html %]</td>
+        <td>[% bug.opendate FILTER html %]</td>
+      </tr><tr class="bz_feed_changed_date">
+        <td>[% columns.changeddate.title FILTER html %]</td>
+        <td>[% bug.changeddate FILTER html -%]</td>
+      </tr>
+      </table>
+      [% END %]
+    </summary>
+  </entry>
+  [% END %]
+</feed>

diff --git a/template/en/default/list/list.csv.tmpl b/template/en/default/list/list.csv.tmpl
new file mode 100644 (file)
index 0000000..31c5d8d
--- /dev/null
+++ b/template/en/default/list/list.csv.tmpl
@@ -0,0 +1,38 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% colsepchar = user.settings.csv_colsepchar.value %]
+
+[% IF human %]
+  [% field_descs.bug_id FILTER csv %]
+  [% FOREACH column = displaycolumns %]
+    [% colsepchar %][% field_descs.$column FILTER csv %]
+  [% END %]
+[% ELSE %]
+  bug_id
+  [% FOREACH column = displaycolumns %]
+    [% colsepchar %][% column FILTER csv %]
+  [% END %]
+[% END %]
+
+[% FOREACH bug = bugs %]
+  [% bug.bug_id %]
+    [% FOREACH column = displaycolumns %]
+      [% colsepchar %]
+      [% IF column == "opendate" OR column == "changeddate" %]
+        [% rawcolumn = column.replace("date", "time") %]
+        [% bug.$column = bug.$rawcolumn FILTER time("%Y-%m-%d %H:%M:%S") %]
+      [% ELSIF column == 'bug_status' %]
+        [% bug.$column = display_value("bug_status", bug.$column) %]
+      [% ELSIF column == 'resolution' %]
+        [%- bug.$column = display_value("resolution", bug.$column) %]
+      [% END %]
+      [% bug.$column FILTER csv %]
+    [% END %]
+
+[% END %]

diff --git a/template/en/default/list/list.html.tmpl b/template/en/default/list/list.html.tmpl
new file mode 100644 (file)
index 0000000..dcc140c
--- /dev/null
+++ b/template/en/default/list/list.html.tmpl
@@ -0,0 +1,340 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # searchtype: string. Type of search - either "series", "saved" or undef.
+  # ...
+  # defaultsavename: string. The default name for saving the query.
+  #%]
+
+[%############################################################################%]
+[%# Template Initialization                                                  #%]
+[%############################################################################%]
+
+[% PROCESS "global/field-descs.none.tmpl" %]
+
+[% USE Bugzilla %]
+[% cgi = Bugzilla.cgi %]
+
+[% unfiltered_title = "$terms.Bug List" %]
+[% IF searchname || defaultsavename %]
+  [% unfiltered_title = unfiltered_title _ ": " _ (searchname OR defaultsavename) %]
+[% END %]
+[% title = unfiltered_title FILTER html %]
+
+[% qorder = order FILTER uri IF order %]
+
+[% javascript =  BLOCK %]
+  [% new_url = cgi.self_url %]
+  [% IF quicksearch %]
+    [% new_url = BLOCK ~%]
+      buglist.cgi?quicksearch=[% quicksearch FILTER uri %]
+      [%~ IF cgi.param('list_id') ~%]
+        &list_id=[% cgi.param('list_id') FILTER uri %]
+      [%~ END %]
+    [% END %]
+  [% ELSIF cgi.param('token') != '' %]
+    [% new_url = 'buglist.cgi?'
+                 _ cgi.canonicalise_query('token', 'cmdtype', 'remtype') %]
+  [% END %]
+
+  if (history && history.replaceState) {
+    history.replaceState(null, "[% unfiltered_title FILTER js %]",
+                         "[% new_url FILTER js %]");
+    document.title = "[% unfiltered_title FILTER js %]";
+  }
+  [% javascript FILTER none %]
+[% END %]
+
+[%############################################################################%]
+[%# Page Header                                                              #%]
+[%############################################################################%]
+
+[% PROCESS global/header.html.tmpl
+  title = title
+  style = style
+  atomlink = "buglist.cgi?$urlquerypart&title=$title&ctype=atom" 
+  yui = [ 'autocomplete', 'calendar' ]
+  javascript_urls = [ "js/util.js", "js/field.js", "js/TUI.js" ]
+  style_urls = [ "skins/standard/buglist.css" ]
+  doc_section = "query.html#list"
+%]
+
+<div class="bz_query_head">
+  <span class="bz_query_timestamp">
+    [% currenttime FILTER time('%a %b %e %Y %T %Z') FILTER html %]<br>
+  </span>
+
+  [% IF debug %]
+    <div class="bz_query_debug">
+      <p>Total execution time: [% query_time FILTER html %] seconds</p>
+      [% FOREACH query = queries %]
+        <p>[% query.sql FILTER html %]</p>
+        <p>Execution time: [% query.time FILTER html %] seconds</p>
+        [% IF query.explain %]
+          <pre>[% query.explain FILTER html %]</pre>
+        [% END %]
+      [% END %]
+    </div>
+  [% END %]
+
+  [% IF user.settings.display_quips.value == 'on' %]
+    [% DEFAULT quip = "$terms.Bugzilla would like to put a random quip here, but no one has entered any." %]
+    <span class="bz_quip">
+      <a href="quips.cgi"><em>[% quip FILTER html %]</em></a>
+    </span>
+  [% END %]
+
+</div>
+
+[% IF toolong %]
+  <h2 class="bz_smallminded">
+    This list is too long for [% terms.Bugzilla %]'s little mind; the
+    Next/Prev/First/Last buttons won't appear on individual [% terms.bugs %].
+  </h2>
+[% END %]
+
+[% SET shown_types = [
+  'notequals', 'regexp', 'notregexp', 'lessthan', 'lessthaneq', 
+  'greaterthan', 'greaterthaneq', 'changedbefore', 'changedafter', 
+  'changedfrom', 'changedto', 'changedby', 'notsubstring', 'nowords',
+  'nowordssubstr', 'notmatches',
+] %]
+<a id="search_description_controller" class="bz_default_hidden"
+   href="javascript:TUI_toggle_class('search_description')">Hide Search Description</a>
+[%# Show the link if the browser supports JS %]
+<script type="text/javascript">
+  TUI_alternates['search_description'] = 'Show Search Description';
+  YAHOO.util.Dom.removeClass('search_description_controller', 
+                             'bz_default_hidden');
+</script>
+
+<ul class="search_description">
+[% FOREACH desc_item = search_description %]
+  <li>
+    <strong>[% field_descs.${desc_item.field} FILTER html %]:</strong>
+    [% IF shown_types.contains(desc_item.type) || debug %]
+      ([% search_descs.${desc_item.type} FILTER html %])
+    [% END %]
+    [% FOREACH val IN desc_item.value.split(',') %]
+      [%+ display_value(desc_item.field, val) FILTER html %][% ',' UNLESS loop.last %]
+    [% END %]
+    [% IF debug %]
+      (<code>[% desc_item.term FILTER html %]</code>)
+   [% END %]
+  </li>
+[% END %]
+</ul>
+
+<hr>
+
+[%############################################################################%]
+[%# Preceding Status Line                                                    #%]
+[%############################################################################%]
+
+[% IF bugs.size > 9 %]
+  [% PROCESS num_results %]
+[% END %]
+
+[%############################################################################%]
+[%# Start of Change Form                                                     #%]
+[%############################################################################%]
+
+[% IF dotweak %]
+  <form name="changeform" method="post" action="process_bug.cgi">
+[% END %]
+
+[%############################################################################%]
+[%# Bug Table                                                                #%]
+[%############################################################################%]
+
+[% PROCESS list/table.html.tmpl %]
+
+[%############################################################################%]
+[%# Succeeding Status Line                                                   #%]
+[%############################################################################%]
+
+[% PROCESS num_results %]
+
+[% IF bugs.size == 0 %]
+  <ul class="zero_result_links">
+    <li>[% PROCESS enter_bug_link %]</li>
+    [% IF one_product.defined %]
+      <li><a href="enter_bug.cgi">File a new [% terms.bug %] in a
+        different product</a></li>
+    [% END %]
+    <li><a href="[% PROCESS edit_search_url %]">Edit this search</a></li>
+    <li><a href="query.cgi">Start a new search</a></li>
+  </ul>
+[% END %]
+
+<br>
+
+[%############################################################################%]
+[%# Rest of Change Form                                                      #%]
+[%############################################################################%]
+
+[% IF dotweak %]
+  [% PROCESS "list/edit-multiple.html.tmpl" %]
+  </form>
+  <hr>
+[% END %]
+
+[%############################################################################%]
+[%# Navigation Bar                                                           #%]
+[%############################################################################%]
+
+<table>
+  <tr>
+    [% IF bugs.size > 0 %]
+      <td valign="middle" class="bz_query_buttons">
+        <form method="post" action="show_bug.cgi">
+          [% id = buglist.join(",") %]
+          <input type="hidden" name="id" value="[% id FILTER html %]">
+          <input type="hidden" name="format" value="multiple">
+          <input type="submit" id="long_format" value="Long Format">
+        </form>
+        <form method="post" action="show_bug.cgi">
+            <input type="hidden" name="ctype" value="xml">
+          [% FOREACH id = buglist %]
+            <input type="hidden" name="id" value="[% id FILTER html %]">
+          [% END %]
+            <input type="hidden" name="excludefield" value="attachmentdata">
+            <input type="submit" value="XML" id="xml">
+        </form>
+
+        [% IF user.is_timetracker %]
+          <form method="post" action="summarize_time.cgi">
+            <input type="hidden" name="id" value="[% buglist_joined FILTER html %]">
+            <input type="submit" id="timesummary" value="Time Summary">
+          </form>
+          [% IF time_summary_limited %]
+            <small>
+              Time Summary will only include the [% terms.bugs %] shown above. In order to
+              to see a time summary for all [% terms.bugs %] found by the search, you can 
+              <a href="buglist.cgi?[% urlquerypart FILTER html %]
+                       [%- "&order=$qorder" FILTER html IF order %]&limit=0">
+                Show all search results</a>.</small>
+          [% END %]
+        [% END %]
+      </td>
+      
+      <td>&nbsp;</td>
+      
+      <td valign="middle" class="bz_query_links">
+        <a href="buglist.cgi?
+        [% urlquerypart FILTER html %]&amp;ctype=csv&amp;human=1">CSV</a> |
+        <a href="buglist.cgi?
+        [% urlquerypart FILTER html %]&amp;title=
+        [%- title FILTER html %]&amp;ctype=atom">Feed</a> |
+        <a href="buglist.cgi?
+        [% urlquerypart FILTER html %]&amp;ctype=ics">iCalendar</a> |
+        <a href="colchange.cgi?
+        [% urlquerypart FILTER html %]&amp;query_based_on=
+          [% defaultsavename OR searchname FILTER uri %]">Change&nbsp;Columns</a> |
+
+        [% IF bugs.size > 1 && caneditbugs && !dotweak %]
+          <a href="buglist.cgi?[% urlquerypart FILTER html %]
+            [%- "&order=$qorder" FILTER html IF order %]&amp;tweak=1"
+            >Change&nbsp;Several&nbsp;[% terms.Bugs %]&nbsp;at&nbsp;Once</a>
+          |
+        [% END %]
+
+        [% IF bugowners && user.id %]
+          <a href="mailto:
+            [% bugowners FILTER html %]">Send&nbsp;Mail&nbsp;to&nbsp;[% terms.Bug %]&nbsp;Assignees</a> |
+        [% END %]
+
+        [%# Links to more things users can do with this bug list. %]
+        [% Hook.process("links") %]
+      </td>
+    [% END %]
+    
+    <td valign="middle" class="bz_query_edit">
+      <a href="[% PROCESS edit_search_url %]">Edit&nbsp;Search</a>
+    </td>
+      
+    [% IF searchtype == "saved" %]
+      <td valign="middle" nowrap="nowrap" class="bz_query_forget">
+        |
+        <a href="buglist.cgi?cmdtype=dorem&amp;remaction=forget&amp;namedcmd=
+                [% searchname FILTER uri %]&amp;token=
+                [% issue_hash_token([search_id, searchname]) FILTER uri %]">
+          Forget&nbsp;Search&nbsp;'[% searchname FILTER html %]'</a>
+      </td>
+    [% ELSE %]
+      <td>&nbsp;</td>
+      
+      <td valign="middle" class="bz_query_remember">
+        <form method="get" action="buglist.cgi">
+          <input type="submit" id="remember" value="Remember search"> as 
+          <input type="hidden" name="newquery" 
+                 value="[% urlquerypart FILTER html %][% "&order=$qorder" FILTER html IF order %]">
+          <input type="hidden" name="cmdtype" value="doit">
+          <input type="hidden" name="remtype" value="asnamed">
+          <input type="hidden" name="token" value="[% issue_hash_token(['savedsearch']) FILTER html %]">
+          <input type="text" id="save_newqueryname" name="newqueryname" size="20"
+                 title="New query name" value="[% defaultsavename FILTER html %]"> 
+        </form> 
+      </td>
+    [% END %]  
+  </tr>
+</table>
+
+[% IF one_product.defined && bugs.size %]
+  <p class="bz_query_single_product">
+    [% PROCESS enter_bug_link %]
+  </p>
+[% END %]
+
+[%############################################################################%]
+[%# Page Footer                                                              #%]
+[%############################################################################%]
+
+[% PROCESS global/footer.html.tmpl %]
+
+[%##########%]
+[%# Blocks #%]
+[%##########%]
+
+[% BLOCK edit_search_url %]
+  [% editqueryname = searchname OR defaultsavename OR '' %]
+  query.cgi?[% urlquerypart FILTER html %]
+    [%- IF editqueryname != '' %]&amp;known_name=
+      [%- editqueryname FILTER uri %]
+    [% END %]
+[% END %]
+
+[% BLOCK enter_bug_link %]
+  <a href="enter_bug.cgi
+           [%- IF one_product.defined %]?product=
+             [%- one_product.name FILTER uri %][% END %]">File
+    a new [% terms.bug %]
+   [% IF one_product.defined %]
+     in the "[% one_product.name FILTER html %]" product
+   [% END %]</a>
+[% END %]
+
+[% BLOCK num_results %]
+  <span class="bz_result_count">
+    [% IF bugs.size == 0 %]
+      <span class="zero_results">[% terms.zeroSearchResults %].</span>
+    [% ELSIF default_limited AND bugs.size >= Param('default_search_limit') %]
+      This result was limited to [% Param('default_search_limit') FILTER html %]
+      [%+ terms.bugs %].
+      <a href="buglist.cgi?[% urlquerypart FILTER html %]
+              [%- "&order=$qorder" FILTER html IF order %]&limit=0">See
+        all search results for this query</a>.
+      [% time_summary_limited = 1 %]
+    [% ELSIF bugs.size == 1 %]
+      One [% terms.bug %] found.
+    [% ELSE %]
+      [% bugs.size %] [%+ terms.bugs %] found.
+    [% END %]
+  </span>
+[% END %]

diff --git a/template/en/default/list/list.ics.tmpl b/template/en/default/list/list.ics.tmpl
new file mode 100644 (file)
index 0000000..4295b46
--- /dev/null
+++ b/template/en/default/list/list.ics.tmpl
@@ -0,0 +1,90 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+BEGIN:VCALENDAR
+CALSCALE:GREGORIAN
+[%+ PROCESS ics_prodid +%]
+VERSION:2.0
+[% FOREACH bug = bugs %]
+BEGIN:VTODO
+[%+ PROCESS ics_dtstart +%]
+[%+ PROCESS ics_summary +%]
+[%+ PROCESS ics_uid base_url=urlbase bug_id=bug.bug_id +%]
+[%+ PROCESS ics_url base_url=urlbase bug_id=bug.bug_id +%]
+[%+ PROCESS ics_status bug_status = bug.bug_status +%]
+[%+ PROCESS ics_dtstamp +%]
+[%+ ics_priorities.${bug.priority} FILTER ics('PRIORITY') +%]
+[% IF bug.changeddate %]
+[%+ bug.changedtime FILTER time("%Y%m%dT%H%M%SZ", "UTC") FILTER ics('LAST-MODIFIED') +%]
+[% END %]
+[% IF bug.percentage_complete %]
+[%+ bug.percentage_complete FILTER format('%d') FILTER ics('PERCENT-COMPLETE') +%]
+[% END %]
+[% IF bug.product %]
+[%+ bug.product FILTER ics('X-BUGZILLA-PRODUCT') +%]
+[% END %]
+[% IF bug.component %]
+[%+ bug.component FILTER ics('X-BUGZILLA-COMPONENT') +%]
+[% END %]
+[% IF bug.version %]
+[%+ bug.version FILTER ics('X-BUGZILLA-VERSION') +%]
+[% END %]
+[% IF bug.keywords %]
+[%+ bug.keywords FILTER ics('X-BUGZILLA-KEYWORDS') +%]
+[% END %]
+END:VTODO
+[% END %]
+END:VCALENDAR
+
+[% BLOCK ics_prodid %]
+  [% "-//Mozilla/Bugzilla $constants.BUGZILLA_VERSION//EN" FILTER ics('PRODID') %]
+[% END %]
+
+[% BLOCK ics_uid %]
+  [% "${bug_id}@${base_url}" FILTER uri FILTER ics('UID') %]
+[% END %]
+
+[% BLOCK ics_url %]
+  [% "${base_url}show_bug.cgi?id=${bug_id}" FILTER uri FILTER ics('URL;VALUE=URI') %]
+[% END %]
+
+[% BLOCK ics_dtstart %]
+  [% bug.opentime FILTER time("%Y%m%dT%H%M%SZ", "UTC") FILTER ics('DTSTART') %]
+[% END %]
+
+[% BLOCK ics_dtstamp %]
+  [% currenttime FILTER time("%Y%m%dT%H%M%SZ", "UTC") FILTER ics('DTSTAMP') %]
+[% END %]
+
+[% BLOCK ics_status %]
+  [% status = "" %]
+  [% FOREACH state = closedstates %]
+    [% IF bug_status == state %]
+      [% status = 'COMPLETED' %]
+      [% LAST %]
+    [% END %]
+  [% END %]
+  [% IF NOT status %]
+    [% IF bug_status == 'IN_PROGRESS' || bug_status == 'ASSIGNED' %]
+      [% status = 'IN-PROGRESS' %]
+    [% ELSE %]
+      [% status = 'NEEDS-ACTION' %]
+    [% END %]
+  [% END %]
+  [% status FILTER ics('STATUS') %]
+[% END %]
+
+[% BLOCK ics_summary %]
+  [% IF bug.short_desc %]
+    [% summary = bug.short_desc %]
+  [% ELSIF bug.short_short_desc %]
+    [% summary = bug.short_short_desc %]
+  [% ELSE %]
+    [% summary = "$terms.Bug $bug.bug_id" %]
+  [% END %]
+  [% summary FILTER ics('SUMMARY') %]
+[% END %]

diff --git a/template/en/default/list/list.rdf.tmpl b/template/en/default/list/list.rdf.tmpl
new file mode 100644 (file)
index 0000000..00eca0e
--- /dev/null
+++ b/template/en/default/list/list.rdf.tmpl
@@ -0,0 +1,44 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+<?xml version="1.0"[% IF Param('utf8') %] encoding="UTF-8"[% END %]?>
+<!-- [% template_version %] -->
+<RDF xmlns="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+     xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+     xmlns:bz="http://www.bugzilla.org/rdf#"
+     xmlns:nc="http://home.netscape.com/NC-rdf#">
+
+<bz:result rdf:about="[% urlbase FILTER xml %]buglist.cgi?[% urlquerypart FILTER html %]">
+  <bz:installation rdf:resource="[% urlbase FILTER xml %]" />
+  <bz:query_timestamp>[% currenttime FILTER time('%Y-%m-%d %T %Z') FILTER html %]</bz:query_timestamp>
+  <bz:bugs>
+    <Seq>
+    [% FOREACH bug = bugs %]
+      <li>
+        
+        <bz:bug rdf:about="[% urlbase FILTER xml %]show_bug.cgi?id=[% bug.bug_id %]">
+          
+          <bz:id nc:parseType="Integer">[% bug.bug_id %]</bz:id>
+        
+        [% FOREACH column = displaycolumns %]
+          <bz:[% column %]>[% bug.$column FILTER html %]</bz:[% column %]>
+        [% END %]
+        
+        </bz:bug>
+      
+      </li>
+
+    [% END %]
+
+    </Seq>
+
+  </bz:bugs>
+
+</bz:result>
+
+</RDF>

diff --git a/template/en/default/list/quips.html.tmpl b/template/en/default/list/quips.html.tmpl
new file mode 100644 (file)
index 0000000..31e766a
--- /dev/null
+++ b/template/en/default/list/quips.html.tmpl
@@ -0,0 +1,159 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # added_quip: string. Defined if the CGI added a quip data before
+  #                displaying anything; if defined, its value is that quip.
+  # show_quips: boolean. True if we are showing the entire quip list.
+  # quips: list of strings. Defined if and only if show_quips is true.
+  #                List of all quips.
+  #%]
+
+[% PROCESS global/header.html.tmpl
+           title = "$terms.Bugzilla Quip System"
+           header = "Add your own clever headline"
+ %]
+
+[% IF added_quip %]
+  <p>
+    <font color="red">
+      Your quip '<tt>[% added_quip FILTER html %]</tt>' has been added.
+      [% IF Param("quip_list_entry_control") == "moderated" AND !user.in_group('bz_quip_moderators') %]
+        It will be used as soon as it gets approved.
+      [% END %]
+    </font>
+  </p>
+[% END %]
+
+[% IF deleted_quip %]
+  <p>
+    <font color="red">
+      The quip '<tt>[% deleted_quip FILTER html %]</tt>' has been deleted.
+    </font>
+  </p>
+[% END %]
+
+[% IF approved or unapproved %]
+  <p>[% approved.size %] quips approved and [% unapproved.size %] quips unapproved</p>
+[% END %]
+
+
+<p>
+  [% terms.Bugzilla %] will pick a random quip for the headline on each 
+  [% terms.bug %] list.
+</p>
+
+[% IF Param("quip_list_entry_control") != "closed" %]
+  <p>
+    You can extend the quip list. Type in something clever or funny or boring
+    (but not obscene or offensive, please) and bonk on the button.
+    [% IF Param("quip_list_entry_control") == "moderated" AND !user.in_group('bz_quip_moderators') %]
+      Note that your quip has to be approved before it is used.
+    [% END %]
+  </p>
+
+  <form method="post" action="quips.cgi">
+    <input type="hidden" name="action" value="add">
+    <input type="hidden" name="token"
+           value="[% issue_hash_token(['create-quips']) FILTER html %]">
+    <input size="80" name="quip" maxlength="512">
+    <p>
+      <input type="submit" id="add" value="Add This Quip">
+    </p>
+  </form>
+[% ELSE %]
+  <p>No new entries may be submitted at this time.
+  </p>
+[% END %]
+
+[% IF show_quips %]
+  [% IF !user.in_group('bz_quip_moderators') %]
+    <h2>
+      Existing quips:
+    </h2>
+    <ul>
+      [% FOREACH quipid = quipids %]
+        [% NEXT IF NOT quips.$quipid.approved %]
+        <li>[% quips.$quipid.quip FILTER html %]</li>
+      [% END %]
+    </ul>
+  [% ELSE %]
+    <h2>Edit existing quips:</h2>
+    <p>
+      <strong>Note:</strong> Only approved quips will be shown.
+      If the parameter 'quip_list_entry_control' is set to <q>open</q>, 
+      entered quips are automatically approved.
+    </p>
+    <form name="editform" method="post" action="quips.cgi">
+      <input type="hidden" name="action" value="approve">
+      <input type="hidden" name="token"
+             value="[% issue_hash_token(['approve-quips']) FILTER html %]">
+      <table border="1">
+        <thead><tr>
+          <th>Quip</th>
+          <th>Author</th>
+          <th>Action</th>
+          <th>Approved</th>
+        </tr></thead><tbody>
+        [% FOREACH quipid = quipids %]
+          <tr>
+            <td>[% quips.$quipid.quip FILTER html %]</td>
+            <td>
+              [% userid = quips.$quipid.userid  %]
+              [% users.$userid FILTER html      %]
+              [% "Unknown" IF NOT users.$userid %]
+            </td>
+            <td>
+              <a href="quips.cgi?action=delete&amp;quipid=[% quipid FILTER uri %]&amp;token=
+                 [%- issue_hash_token(['quips', quipid]) FILTER uri %]">
+                Delete
+              </a>
+            </td>
+            <td>
+              <input type="hidden" name="defined_quipid_[% quipid FILTER html %]"
+                     id="defined_quipid_[% quipid FILTER html %]"
+                     value="1">
+              <input type="checkbox" name="quipid_[% quipid FILTER html %]"
+                     id="quipid_[% quipid FILTER html %]"
+                     [%- ' checked="checked"' IF quips.$quipid.approved %]>
+            </td>
+          </tr>
+        [% END %]
+        </tbody>
+      </table>
+      <script type="text/javascript"><!--
+        var numelements = document.forms.editform.elements.length;
+        function SetCheckboxes(value) {
+          var item;
+          for (var i=0 ; i<numelements ; i++) {
+            item = document.forms.editform.elements[i];
+            item.checked = value;
+          }
+        }
+        document.write(' <input type="button" name="uncheck_all" '
+                      +'value="Uncheck All" onclick="SetCheckboxes(false);">');
+        document.write(' <input type="button" name="check_all" '
+                      +'value="Check All" onclick="SetCheckboxes(true);">');
+        //--></script>
+
+      <input type="submit" id="update" value="Save Changes">
+    </form>
+    <br>
+  [% END %]
+[% ELSE %]
+  <p>
+    Those who like their wisdom in large doses can
+    <a href="quips.cgi?action=show">view
+    [% IF user.in_group('bz_quip_moderators') %]
+      and edit
+    [% END %]
+    the whole quip list</a>.
+  </p>
+[% END %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/list/server-push.html.tmpl b/template/en/default/list/server-push.html.tmpl
new file mode 100644 (file)
index 0000000..c4a3a84
--- /dev/null
+++ b/template/en/default/list/server-push.html.tmpl
@@ -0,0 +1,30 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # debug: boolean. True if we want the search displayed while we wait.
+  # query: string. The SQL query which makes the buglist.
+  #%]
+
+<html>
+  <head>
+    <title>[% terms.Bugzilla %] is pondering your search</title>
+    <link href="[% 'skins/standard/global.css' FILTER mtime %]"
+          rel="stylesheet" type="text/css">
+  </head>
+  <body>
+    <h1 style="margin-top: 20%; text-align: center; font-size: xx-large;">Please stand by ...</h1>
+
+    [% IF debug %]
+      <p>[% query FILTER html %]</p>
+      [% IF query_explain.defined %]
+        <pre>[% query_explain FILTER html %]</pre>
+      [% END %]
+    [% END %]
+  </body>
+</html>

diff --git a/template/en/default/list/table.html.tmpl b/template/en/default/list/table.html.tmpl
new file mode 100644 (file)
index 0000000..96f4ea3
--- /dev/null
+++ b/template/en/default/list/table.html.tmpl
@@ -0,0 +1,250 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%############################################################################%]
+[%# Initialization                                                           #%]
+[%############################################################################%]
+
+[%# Don't display the table or do any processing if there are no bugs 
+  # to display %]
+[% RETURN IF !bugs.size %]
+
+[%# Columns whose titles or values should be abbreviated to make the list
+  # more compact.  For columns whose titles should be abbreviated,
+  # the shortened title is included.  For columns whose values should be
+  # abbreviated, a maximum length is provided along with the ellipsis that
+  # should be added to an abbreviated value, if any.
+  # wrap is set if a column's contents should be allowed to be word-wrapped
+  # by the browser.
+  #%]
+
+[% field_descs.short_short_desc     = field_descs.short_desc  %]
+[% field_descs.assigned_to_realname = field_descs.assigned_to %]
+[% field_descs.reporter_realname    = field_descs.reporter    %]
+[% field_descs.qa_contact_realname  = field_descs.qa_contact  %]
+
+[% abbrev = 
+  {
+    "bug_severity"         => { maxlength => 3 , title => "Sev" } , 
+    "priority"             => { maxlength => 7 , title => "Pri" } , 
+    "rep_platform"         => { maxlength => 3 , title => "HW" } , 
+    "bug_status"           => { maxlength => 4 } , 
+    "assigned_to"          => { maxlength => 30 , ellipsis => "..." } , 
+    "assigned_to_realname" => { maxlength => 20 , ellipsis => "..." } , 
+    "reporter"             => { maxlength => 30 , ellipsis => "..." } , 
+    "reporter_realname"    => { maxlength => 20 , ellipsis => "..." } , 
+    "qa_contact"           => { maxlength => 30 , ellipsis => "..." , title => "QAContact" } , 
+    "qa_contact_realname"  => { maxlength => 20 , ellipsis => "..." , title => "QAContact" } , 
+    "resolution"        => { maxlength => 4 } , 
+    "short_desc"        => { wrap => 1 } ,
+    "short_short_desc"  => { maxlength => 60 , ellipsis => "..." , wrap => 1 } ,
+    "status_whiteboard" => { title => "Whiteboard" , wrap => 1 } , 
+    "keywords"          => { wrap => 1 } ,
+    "flagtypes.name"    => { wrap => 1 } ,
+    "component"         => { maxlength => 8 , title => "Comp" } , 
+    "product"           => { maxlength => 8 } , 
+    "version"           => { maxlength => 5 , title => "Vers" } , 
+    "op_sys"            => { maxlength => 4 } , 
+    "bug_file_loc"      => { maxlength => 30 } , 
+    "target_milestone"  => { title => "TargetM" } , 
+    "longdescs.count"   => { title => "# Comments" },
+    "percentage_complete" => { format_value => "%d %%" } , 
+  }
+%]
+
+[% PROCESS bug/time.html.tmpl %]
+
+[% Hook.process("before_table") %]
+
+[%############################################################################%]
+[%# Table Header                                                             #%]
+[%############################################################################%]
+
+[% tableheader = BLOCK %]
+  <table class="bz_buglist" cellspacing="0" cellpadding="4" width="100%">
+    <tr class="bz_buglist_header bz_first_buglist_header">
+      [% IF dotweak %]
+      <th>&nbsp;</th>
+      [% END %]
+      <th colspan="[% splitheader ? 2 : 1 %]" class="first-child">
+        <a href="buglist.cgi?
+                  [% urlquerypart FILTER html %]&amp;order=
+                  [% PROCESS new_order id='bug_id' %]
+                  [%-#%]&amp;query_based_on=
+                  [% defaultsavename OR searchname FILTER uri %]">ID
+          [% PROCESS order_arrow id='bug_id' ~%]
+        </a>
+      </th>
+
+      [% IF splitheader %]
+
+        [% FOREACH id = displaycolumns %]
+          [% NEXT UNLESS loop.count() % 2 == 0 %]
+          [% column = columns.$id %]
+          [% PROCESS columnheader %]
+        [% END %]
+
+        </tr><tr class="bz_buglist_header">
+        [% IF dotweak %]
+          <th>&nbsp;</th>
+        [% END %]
+        <th>&nbsp;</th>
+
+        [% FOREACH id = displaycolumns %]
+          [% NEXT IF loop.count() % 2 == 0 %]
+          [% column = columns.$id %]
+          [% PROCESS columnheader %]
+        [% END %]
+
+      [% ELSE %]
+
+        [% FOREACH id = displaycolumns %]
+          [% column = columns.$id %]
+          [% PROCESS columnheader %]
+        [% END %]
+
+      [% END %]
+
+    </tr>
+[% END %]
+
+[% BLOCK columnheader %]
+  <th colspan="[% splitheader ? 2 : 1 %]">
+    <a href="buglist.cgi?[% urlquerypart FILTER html %]&amp;order=
+      [% PROCESS new_order %]
+      [%-#%]&amp;query_based_on=
+      [% defaultsavename OR searchname FILTER uri %]">
+        [%- abbrev.$id.title || field_descs.$id || column.title FILTER html -%]
+        [% PROCESS order_arrow ~%]
+    </a>
+  </th>
+[% END %]
+
+[% BLOCK new_order %]
+  [% desc = '' %]
+  [% IF (om = order.match("\\b$id( DESC)?")) %]
+    [% desc = ' DESC' IF NOT om.0 %]
+  [% END %]
+  [% id _ desc FILTER uri %]
+  [% IF id != 'bug_id' AND order %]
+    [% ',' _ order.remove("\\b$id( DESC)?(,\\s*|\$)") FILTER uri %]
+  [% END %]
+[% END %]
+
+[% BLOCK order_arrow %]
+  [% IF order.match("^$id DESC") %]
+    <span class="bz_sort_order_primary">&#x25BC;</span>
+  [% ELSIF order.match("^$id(,\\s*|\$)") %]
+    <span class="bz_sort_order_primary">&#x25B2;</span>
+  [% ELSIF order.match("\\b$id DESC") %]
+    <span class="bz_sort_order_secondary">&#x25BC;</span>
+  [% ELSIF order.match("\\b$id(,\\s*|\$)") %]
+    <span class="bz_sort_order_secondary">&#x25B2;</span>
+  [% END %]
+[% END %]
+
+[%############################################################################%]
+[%# Bug Table                                                                #%]
+[%############################################################################%]
+
+[% tableheader %]
+
+[% FOREACH bug = bugs %]
+  [% count = loop.count() %]
+
+  <tr id="b[% bug.bug_id %]" class="bz_bugitem
+             bz_[% bug.bug_severity FILTER css_class_quote -%]
+             bz_[% bug.priority FILTER css_class_quote -%]
+             bz_[% bug.bug_status FILTER css_class_quote -%]
+             [%+ "bz_$bug.resolution" FILTER css_class_quote IF bug.resolution -%]
+             [%+ "bz_secure" IF bug.secure_mode -%]
+             [%+ "bz_secure_mode_$bug.secure_mode" FILTER css_class_quote IF bug.secure_mode -%]
+             [%+ count % 2 == 1 ? "bz_row_odd" : "bz_row_even" -%]
+             ">
+
+    [% IF dotweak %]
+    <td class="bz_checkbox_column">
+      <input type="checkbox" name="id_[% bug.bug_id %]">
+    </td>
+    [% END %]
+    <td class="first-child bz_id_column">
+      <a href="show_bug.cgi?id=[% bug.bug_id %]">[% bug.bug_id %]</a>
+      <span style="display: none">[%+ '[SEC]' IF bug.secure_mode %]</span>
+    </td>
+
+    [% FOREACH column = displaycolumns %]
+    <td [% 'style="white-space: nowrap"' IF NOT abbrev.$column.wrap %]
+        class="bz_[% column FILTER css_class_quote %]_column">
+      [% IF abbrev.$column.maxlength %]
+        <span title="[%- display_value(column, bug.$column) FILTER html %]">
+      [% END %]
+      [% IF abbrev.$column.format_value %] 
+        [%- bug.$column FILTER format(abbrev.$column.format_value) FILTER html -%] 
+      [% ELSIF column == 'actual_time' ||
+               column == 'remaining_time' ||
+               column == 'estimated_time' %]
+        [% PROCESS formattimeunit time_unit=bug.$column %] 
+      [%# Display the login name of the user if their real name is empty. %]
+      [% ELSIF column.match('_realname$') && bug.$column == '' %]
+        [% SET login_column = column.remove('_realname$') %]
+        [% bug.${login_column}.truncate(abbrev.$column.maxlength, 
+                                        abbrev.$column.ellipsis) FILTER html %]
+      [% ELSIF column == 'short_desc' || column == "short_short_desc" %]
+        <a href="show_bug.cgi?id=[% bug.bug_id FILTER html %]">
+          [%- bug.$column.truncate(abbrev.$column.maxlength, abbrev.$column.ellipsis) FILTER html -%]
+        </a>
+      [% ELSE %]
+        [%- display_value(column, bug.$column).truncate(abbrev.$column.maxlength, abbrev.$column.ellipsis) FILTER html -%]
+      [% END %]
+      [% IF abbrev.$column.maxlength %]
+        </span>
+      [% END %]
+    </td>
+    [% END %]
+
+  </tr>
+
+  [% IF loop.last() && time_info.time_present == 1 %]
+    [% PROCESS time_summary_line %]
+  [% END %]
+
+[% END %]
+
+</table>
+
+[% BLOCK time_summary_line %]
+  <tr class="bz_time_summary_line">
+    [% columns_to_span = 1 %]  [%# bugID %]
+    [% IF dotweak %]
+      [% columns_to_span = columns_to_span + 1 %]
+    [% END %]
+    [% FOREACH column = displaycolumns %]
+      [% IF column == 'actual_time' ||
+            column == 'remaining_time' ||
+            column == 'estimated_time' ||
+            column == 'percentage_complete' %]
+        [% IF columns_to_span > 0 %]
+          <td class="bz_total bz_total_label" colspan="
+              [%- columns_to_span FILTER html %]"><b>Totals</b></td>
+          [% columns_to_span = 0 %]
+        [% END %]
+        [% IF column == 'percentage_complete' %]
+          <td class="bz_total">[% time_info.percentage_complete
+              FILTER format(abbrev.$column.format_value) FILTER html %]</td>
+        [% ELSE %]
+          <td class="bz_total">
+            [%- PROCESS formattimeunit time_unit=time_info.$column %]</td>
+        [% END %]
+      [% ELSIF columns_to_span == 0 %] [%# A column following the first total %]
+        <td class="bz_total">&nbsp;</td>
+      [% ELSE %] [%# We haven't gotten to a time column yet, keep computing span %]
+        [% columns_to_span = columns_to_span + 1 %]
+      [% END %]
+    [% END %]
+  </tr>
+[% END %]

diff --git a/template/en/default/pages/bug-writing.html.tmpl b/template/en/default/pages/bug-writing.html.tmpl
new file mode 100644 (file)
index 0000000..1fc097e
--- /dev/null
+++ b/template/en/default/pages/bug-writing.html.tmpl
@@ -0,0 +1,162 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% INCLUDE global/header.html.tmpl title = "$terms.Bug Writing Guidelines" %]
+
+  <p>Effective [% terms.bug %] reports are the most likely to be fixed. 
+  These guidelines explain how to write such reports.
+
+<h3>Principles</h3>
+
+  <ul>
+    <li>Be precise</li>
+    <li>Be clear - explain it so others can reproduce the [% terms.bug %]</li>
+    <li>One [% terms.bug %] per report</li>
+    <li>No [% terms.bug %] is too trivial to report - 
+    small [% terms.bugs %] may hide big [% terms.bugs %]</li>
+    <li>Clearly separate fact from speculation</li>
+  </ul>
+
+<h3>Preliminaries</h3>
+
+<ol>
+  <li>Reproduce your [% terms.bug %] using a recent build of the
+  software, to see whether it has already been fixed.
+  </li>
+
+  <li><a href="query.cgi?format=specific">Search</a> 
+  [% terms.Bugzilla %], to see whether your [% terms.bug %] has
+  already been reported.</li>
+</ol>
+
+<h3>Reporting a New [% terms.Bug %]</h3>
+
+<p>If you have reproduced the [% terms.bug %] in a recent build and 
+no-one else appears to have reported it, then:</p>
+
+<ol>
+ <li>Choose 
+ "<a href="enter_bug.cgi">Enter a new [% terms.bug %]</a>"</li>
+ <li>Select the product in which you've found the [% terms.bug %]</li>
+ <li>Fill out the form. Here is some help understanding it:</li>
+</ol>
+
+  <blockquote>
+    <p><b>Component:</b> In which sub-part of the software does it 
+          exist?<br>
+    This field is required.
+    Click the word "Component" to see a description of each 
+    component. If none seems appropriate, look for a "General" component.</p>
+
+    <p><b>[% field_descs.op_sys FILTER html %]:</b> On which operating system (OS) did you find 
+          it?
+    (e.g. Linux, Windows XP, Mac OS X.)<br>
+    If you know the [% terms.bug %] happens on more than one type of 
+    operating system, choose <em>[% display_value("op_sys", "All") FILTER html %]</em>. 
+    If your [% field_descs.op_sys FILTER html %] isn't listed, choose 
+    <em>[% display_value("op_sys", "Other") FILTER html %]</em>.</p>
+
+    <p><b>Summary:</b> How would you describe the [% terms.bug %], in 
+    approximately 60 or fewer characters?<br>
+     A good summary should <b>quickly and uniquely identify [% terms.abug %]
+    report</b>. It should explain the problem, not your suggested solution.<br>
+    <ul>
+     <li>Good: "<tt>Cancelling a File Copy dialog crashes 
+     File Manager</tt>"</li>
+     <li>Bad: "<tt>Software crashes</tt>"</li>
+     <li>Bad: "<tt>Browser should work with my web site</tt>"</li>
+    </ul>
+    
+    <b>Description:</b>
+    The details of your problem report, including:</p>
+
+    <blockquote>
+      <p><b>Overview:</b> More detailed restatement of
+      summary.</p>
+
+      <blockquote>
+<pre>
+Drag-selecting any page crashes Mac builds in the NSGetFactory function.
+</pre>
+      </blockquote>
+
+      <p><b>Steps to Reproduce:</b> Minimized, easy-to-follow steps that
+      will trigger the [% terms.bug %]. Include any special setup steps.</p>
+
+      <blockquote>
+<pre>
+1) View any web page. (I used the default sample page, 
+resource:/res/samples/test0.html)
+
+2) Drag-select the page. (Specifically, while holding down 
+the mouse button, drag the mouse pointer downwards from any 
+point in the browser's content region to the bottom of the 
+browser's content region.)
+</pre>
+      </blockquote>
+
+      <p><b>Actual Results:</b> What the application did after performing
+      the above steps.</p>
+
+      <blockquote>
+<pre>
+The application crashed.
+</pre>
+      </blockquote>
+
+      <p><b>Expected Results:</b> What the application should have done,
+      were the [% terms.bug %] not present.</p>
+
+      <blockquote>
+<pre>
+The window should scroll downwards. Scrolled content should be selected. 
+(Or, at least, the application should not crash.)
+</pre>
+      </blockquote>
+
+      <p><b>Build Date &amp; [% field_descs.rep_platform FILTER html %]:</b>
+      Date and [% field_descs.rep_platform FILTER lower FILTER html %] of the build
+      in which you first encountered the [% terms.bug %].</p>
+
+      <blockquote>
+<pre>
+Build 2006-08-10 on Mac OS 10.4.3
+</pre>
+      </blockquote>
+
+      <p><b>Additional Builds and Platforms:</b> Whether or not 
+      the [% terms.bug %] takes place on other platforms (or browsers, 
+      if applicable).</p>
+
+      <blockquote>
+<pre>
+Doesn't Occur On Build 2006-08-10 on Windows XP Home (Service Pack 2)
+</pre>
+      </blockquote>
+
+      <p><b>Additional Information:</b> Any other useful information.
+      <br><br>For crashing [% terms.bugs %]:</p>
+
+      <ul>
+        <li><b>Windows:</b> Note the type of the crash, and the module that the
+        application crashed in (e.g. access violation in apprunner.exe).</li>
+
+        <li><b>Mac OS X:</b> Attach the "Crash Reporter" log that appears
+        upon crash.
+        Only include the section directly below the crashing thread, usually 
+        titled "Thread 0 Crashed". Please do not paste the entire log!</li>
+      </ul>
+    </blockquote>
+
+  <p>Double-check your report for errors and omissions, then press "Commit".
+  Your [% terms.bug %] report will now be in 
+  the [% terms.Bugzilla %] database.<br>
+  </p>
+</blockquote>
+
+[% INCLUDE global/footer.html.tmpl %]

diff --git a/template/en/default/pages/bugzilla.dtd.tmpl b/template/en/default/pages/bugzilla.dtd.tmpl
new file mode 100644 (file)
index 0000000..ee4492c
--- /dev/null
+++ b/template/en/default/pages/bugzilla.dtd.tmpl
@@ -0,0 +1,162 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+[% USE Bugzilla %]
+<!ELEMENT [% "bugzilla" %] (bug+)>
+<!ATTLIST [% "bugzilla" %] 
+          version CDATA #REQUIRED
+          urlbase CDATA #REQUIRED
+          maintainer CDATA #REQUIRED
+          exporter CDATA #IMPLIED
+>
+<!ELEMENT [% "bug" %] (bug_id, 
+               (alias?, 
+                creation_ts, 
+                short_desc, 
+                delta_ts, 
+                reporter_accessible, 
+                cclist_accessible, 
+                classification_id, 
+                classification, 
+                product, 
+                component, 
+                version, 
+                rep_platform, 
+                op_sys, 
+                bug_status, 
+                resolution?, 
+                dup_id?, 
+                see_also*, 
+                bug_file_loc?, 
+                status_whiteboard?, 
+                keywords*, 
+                priority, 
+                bug_severity, 
+                target_milestone?, 
+                dependson*, 
+                blocked*, 
+                everconfirmed, 
+                reporter, 
+                assigned_to, 
+                cc*, 
+                (estimated_time, 
+                 remaining_time, 
+                 actual_time, 
+                 deadline?)?, 
+                qa_contact?,
+[% FOREACH field = Bugzilla.active_custom_fields %]
+                [%+ field.name FILTER xml -%]
+                [%- IF field.type == constants.FIELD_TYPE_MULTI_SELECT %]*[% ELSE %]?[% END %], 
+[% END %]
+                votes?, 
+                token?, 
+                group*, 
+                flag*, 
+                comment_sort_order*,
+                long_desc*, 
+                attachment*)?)>
+<!ATTLIST [% "bug" %]
+          error (NotFound | NotPermitted | InvalidBugId) #IMPLIED
+>
+<!ELEMENT bug_id (#PCDATA)>
+<!ELEMENT alias (#PCDATA)>
+<!ELEMENT reporter_accessible (#PCDATA)>
+<!ELEMENT cclist_accessible (#PCDATA)>
+<!ELEMENT exporter (#PCDATA)>
+<!ELEMENT urlbase (#PCDATA)>
+<!ELEMENT bug_status (#PCDATA)>
+<!ELEMENT classification_id (#PCDATA)>
+<!ELEMENT classification (#PCDATA)>
+<!ELEMENT product (#PCDATA)>
+<!ELEMENT priority (#PCDATA)>
+<!ELEMENT version (#PCDATA)>
+<!ELEMENT rep_platform (#PCDATA)>
+<!ELEMENT assigned_to (#PCDATA)>
+<!ATTLIST assigned_to 
+          name CDATA #REQUIRED
+>
+<!ELEMENT delta_ts (#PCDATA)>
+<!ELEMENT component (#PCDATA)>
+<!ELEMENT reporter (#PCDATA)>
+<!ATTLIST reporter
+          name CDATA #REQUIRED
+>
+<!ELEMENT target_milestone (#PCDATA)>
+<!ELEMENT bug_severity (#PCDATA)>
+<!ELEMENT creation_ts (#PCDATA)>
+<!ELEMENT qa_contact (#PCDATA)>
+<!ATTLIST qa_contact
+          name CDATA #REQUIRED
+>
+<!ELEMENT status_whiteboard (#PCDATA)>
+<!ELEMENT op_sys (#PCDATA)>
+<!ELEMENT resolution (#PCDATA)>
+<!ELEMENT dup_id (#PCDATA)>
+<!ELEMENT bug_file_loc (#PCDATA)>
+<!ELEMENT short_desc (#PCDATA)>
+<!ELEMENT keywords (#PCDATA)>
+<!ELEMENT dependson (#PCDATA)>
+<!ELEMENT blocked (#PCDATA)>
+<!ELEMENT everconfirmed (#PCDATA)>
+<!ELEMENT cc (#PCDATA)>
+<!ELEMENT see_also (#PCDATA)>
+<!ELEMENT votes (#PCDATA)>
+<!ELEMENT token (#PCDATA)>
+<!ELEMENT group (#PCDATA)>
+<!ATTLIST group
+          id CDATA #REQUIRED
+>
+<!ELEMENT estimated_time (#PCDATA)>
+<!ELEMENT remaining_time (#PCDATA)>
+<!ELEMENT actual_time (#PCDATA)>
+<!ELEMENT deadline (#PCDATA)>
+[% FOREACH field = Bugzilla.active_custom_fields %]
+<!ELEMENT [% field.name FILTER xml %] (#PCDATA)>
+[% END %]
+<!ELEMENT comment_sort_order (#PCDATA)>
+<!ELEMENT long_desc (commentid, comment_count, attachid?, who, bug_when, work_time?, thetext)>
+<!ATTLIST long_desc
+          isprivate (0|1) #REQUIRED
+>
+<!ELEMENT commentid (#PCDATA)>
+<!ELEMENT comment_count (#PCDATA)>
+<!ELEMENT who (#PCDATA)>
+<!ATTLIST who
+          name CDATA #REQUIRED
+>
+<!ELEMENT bug_when (#PCDATA)>
+<!ELEMENT work_time (#PCDATA)>
+<!ELEMENT thetext (#PCDATA)>
+<!ELEMENT attachment (attachid, date, delta_ts, desc, filename, type, size, attacher, token?, data?, flag*)>
+<!ATTLIST attachment
+          isobsolete (0|1) #REQUIRED
+          ispatch (0|1) #REQUIRED
+          isprivate (0|1) #REQUIRED
+>
+<!ELEMENT attacher (#PCDATA)>
+<!ATTLIST attacher
+          name CDATA #REQUIRED
+>
+<!ELEMENT attachid (#PCDATA)>
+<!ELEMENT date (#PCDATA)>
+<!ELEMENT desc (#PCDATA)>
+<!ELEMENT filename (#PCDATA)>
+<!ELEMENT type (#PCDATA)>
+<!ELEMENT size (#PCDATA)>
+<!ELEMENT data (#PCDATA)>
+<!ATTLIST data
+          encoding (base64) #IMPLIED
+>
+<!ELEMENT flag EMPTY>
+<!ATTLIST flag
+          name CDATA #REQUIRED
+          id CDATA #REQUIRED
+          type_id CDATA #REQUIRED 
+          status CDATA #REQUIRED
+          setter CDATA #REQUIRED
+          requestee CDATA #IMPLIED
+>

diff --git a/template/en/default/pages/fields.html.tmpl b/template/en/default/pages/fields.html.tmpl
new file mode 100644 (file)
index 0000000..7412829
--- /dev/null
+++ b/template/en/default/pages/fields.html.tmpl
@@ -0,0 +1,222 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS global/header.html.tmpl 
+  title = "$terms.Bug Fields" 
+  style_urls = ['skins/standard/page.css']
+%]
+
+<p>This page describes the various fields that you see 
+  on [% terms.abug %].</p>
+
+<table class="field_value_explanation">
+  <thead>
+  <tr>
+    <td id="bug_status">
+      <h2>[% field_descs.bug_status FILTER upper FILTER html %]</h2>
+    </td>
+
+    <td id="resolution">
+      <h2>[% field_descs.resolution FILTER upper FILTER html %]</h2>
+    </td>
+  </tr>
+
+  <tr>
+    <td>The [% field_descs.bug_status FILTER html %] field indicates the 
+      current state of a [% terms.bug %]. Only certain status transitions
+      are allowed.</td>
+
+    <td>The [% field_descs.resolution FILTER html %] field indicates what
+      happened to this [%+ terms.bug %].</td>
+  </tr>
+  </thead>
+
+  <tbody>
+  <tr class="header_row">
+    <td colspan="2">Open [% terms.Bugs %]</td>
+  </tr>
+  <tr>
+    <td>
+      <dl>
+        <dt class="unconfirmed">
+          [% display_value("bug_status", "UNCONFIRMED") FILTER html %]
+        </dt>
+        <dd class="unconfirmed">
+          This [% terms.bug %] has recently been added to the database. 
+          Nobody has confirmed that this [% terms.bug %] is valid. Users
+          who have the "canconfirm" permission set may confirm
+          this [% terms.bug %], changing its state to 
+          <b>[% display_value("bug_status", "CONFIRMED") FILTER html %]</b>. 
+          Or, it may be directly resolved and marked
+          <b>[% display_value("bug_status", "RESOLVED") FILTER html %]</b>.
+        </dd>
+
+        <dt class="confirmed">
+          [% display_value("bug_status", "CONFIRMED") FILTER html %]
+        </dt>
+        <dd class="confirmed">
+          This [% terms.bug %] is valid and has recently been filed.
+          [%+ terms.Bugs %] in this state become 
+          <b>[% display_value("bug_status", "IN_PROGRESS") FILTER html %]</b>
+          when somebody is working on them, or become resolved and marked
+          <b>[% display_value("bug_status", "RESOLVED") FILTER html %]</b>.
+        </dd>
+
+        <dt class="in_progress">
+          [% display_value("bug_status", "IN_PROGRESS") FILTER html %]
+        </dt>
+        <dd class="in_progress">
+          This [% terms.bug %] is not yet resolved, but is assigned to the
+          proper person who is working on the [% terms.bug %]. From here,
+          [%+ terms.bugs %] can be given to another person and become
+          <b>[% display_value("bug_status", "CONFIRMED") FILTER html %]</b>, or
+          resolved and become 
+          <b>[% display_value("bug_status", "RESOLVED") FILTER html %]</b>.
+        </dd>
+        
+        [% Hook.process('open-status') %]
+      </dl>
+    </td>
+
+    <td>
+      No resolution yet. All [% terms.bugs %] which are in one of
+      these "open" states have no resolution set.
+    </td>
+  </tr>
+
+  <tr class="header_row">
+    <td colspan="2">Closed [% terms.Bugs %]</td>
+  </tr>
+
+  <tr>
+    <td>
+      <dl>
+        <dt class="resolved">
+          [% display_value("bug_status", "RESOLVED") FILTER html %]
+        </dt>
+        <dd class="resolved">
+          A resolution has been performed, and it is awaiting verification by
+          QA. From here [% terms.bugs %] are either reopened and given some
+          open status, or are verified by QA and marked
+          <b>[% display_value("bug_status", "VERIFIED") FILTER html %]</b>.
+        </dd>
+
+        <dt class="verified">
+          [% display_value("bug_status", "VERIFIED") FILTER html %]
+        </dt>
+        <dd class="verified">
+          QA has looked at the [% terms.bug %] and the resolution and
+          agrees that the appropriate resolution has been taken. This is
+          the final status for [% terms.bugs %].
+        </dd>
+        
+        [% Hook.process('closed-status') %]
+      </dl>
+    </td>
+
+    <td>
+      <dl>
+        <dt class="fixed">
+          [% display_value("resolution", "FIXED") FILTER html %]
+        </dt>
+        <dd class="fixed">
+          A fix for this [% terms.bug %] is checked into the tree and 
+          tested.
+        </dd>
+
+        <dt class="invalid">
+          [% display_value("resolution", "INVALID") FILTER html %]
+        </dt>
+        <dd class="invalid">
+          The problem described is not [% terms.abug %].
+        </dd>
+
+        <dt class="wontfix">
+          [% display_value("resolution", "WONTFIX") FILTER html %]
+        </dt>
+        <dd class="wontfix">
+          The problem described is [% terms.abug %] which will never be 
+          fixed.
+        </dd>
+
+        <dt class="duplicate">
+         [% display_value("resolution", "DUPLICATE") FILTER html %]
+        </dt>
+        <dd class="duplicate">
+          The problem is a duplicate of an existing [% terms.bug %].
+          When [% terms.abug %] is marked as a
+          <b>[% display_value("resolution", "DUPLICATE") FILTER html %]</b>,
+          you will see which [% terms.bug %] it is a duplicate of,
+          next to the resolution.
+        </dd>
+
+        <dt class="worksforme">
+          [% display_value("resolution", "WORKSFORME") FILTER html %]
+        </dt>
+        <dd class="worksforme">
+          All attempts at reproducing this [% terms.bug %] were futile, 
+          and reading the code produces no clues as to why the described
+          behavior would occur. If more information appears later,
+          the [% terms.bug %] can be reopened.
+        </dd>
+        
+        [% Hook.process('resolution') %]
+      </dl>
+    </td>
+  </tr>
+  </tbody>
+</table>
+
+<h2>Other Fields</h2>
+
+[% SET field_help_map = {} %]
+[% FOREACH field = bug_fields.keys %]
+  [% SET field_desc = field_descs.$field %]
+  [% field_help_map.$field_desc = { help  => help_html.$field, 
+                                    field => field } %]
+[% END %]
+
+[%# These are fields that don't need to be documented, either because
+  # they have docs somewhere else in the UI, or they don't show up on bugs. 
+  # %]
+[% SET skip_fields = [ 
+  'days_elapsed', 
+  'everconfirmed',
+  'reporter_accessible',
+  'cclist_accessible',
+  'bug_group',
+  'commenter',
+  'owner_idle_time',
+  'bug_status',
+  'resolution',
+] %]
+
+<dl class="field_descriptions">
+[% FOREACH field_desc = field_help_map.keys.sort %]
+  [% SET field = field_help_map.${field_desc}.field %]
+  [% SET field_object = bug_fields.$field %]
+
+  [% NEXT IF field_object.obsolete %]
+  [% NEXT IF !user.is_timetracker AND field_object.is_timetracking %]
+
+  [% NEXT IF field == 'status_whiteboard' AND !Param('usestatuswhiteboard') %]
+  [% NEXT IF field == 'target_milestone' AND !Param('usetargetmilestone') %]
+
+  [%# For now we don't have help for attachment fields and so on. %]
+  [% NEXT IF field.match('\.') %]
+
+  [% NEXT IF skip_fields.contains(field) %]
+
+  <dt id="[% field FILTER html %]">[% field_desc FILTER html %]</dt>
+    <dd>
+      [% field_help_map.${field_desc}.help FILTER html_light %]
+    </dd>
+[% END %]
+</dl>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/pages/linked.html.tmpl b/template/en/default/pages/linked.html.tmpl
new file mode 100644 (file)
index 0000000..92d0f59
--- /dev/null
+++ b/template/en/default/pages/linked.html.tmpl
@@ -0,0 +1,42 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% INCLUDE global/header.html.tmpl title = "Your Linkified Text" %]
+[% USE Bugzilla %]
+[% cgi = Bugzilla.cgi %]
+
+<p>
+  Copy and paste the text below:
+</p>
+
+<hr>
+
+<p>
+<pre class="bz_comment_text">
+[%- cgi.param("text") FILTER quoteUrls FILTER html -%]
+</pre>
+</p>
+
+<hr>
+
+<p>
+  If you place it in <tt>&lt;pre&gt;</tt> tags, 
+  the text will end up looking like this:
+</p>
+
+<hr>
+
+<p>
+<pre class="bz_comment_text">
+[%- cgi.param("text") FILTER quoteUrls -%]
+</pre>
+</p>
+
+<hr>
+
+[% INCLUDE global/footer.html.tmpl %]

diff --git a/template/en/default/pages/linkify.html.tmpl b/template/en/default/pages/linkify.html.tmpl
new file mode 100644 (file)
index 0000000..e02ca8d
--- /dev/null
+++ b/template/en/default/pages/linkify.html.tmpl
@@ -0,0 +1,28 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% INCLUDE global/header.html.tmpl title = "Linkify Text" %]
+
+<p>
+  If you enter some text, this form will return it marked up like a
+  standard [% terms.Bugzilla %] comment. That is, valid [% terms.bug %] numbers,
+  URLs, email addresses and so on will be replaced with appropriate HTML links.
+</p>
+
+<form action="page.cgi" method="post">
+  [% INCLUDE global/textarea.html.tmpl
+    name    = 'text'
+    minrows = 20
+    cols    = constants.COMMENT_COLS
+  %]
+  <br>
+  <input type="hidden" name="id" value="linked.html">
+  <input type="submit" id="linkify" value="Linkify">
+</form>
+
+[% INCLUDE global/footer.html.tmpl %]

diff --git a/template/en/default/pages/quicksearch.html.tmpl b/template/en/default/pages/quicksearch.html.tmpl
new file mode 100644 (file)
index 0000000..f3794e1
--- /dev/null
+++ b/template/en/default/pages/quicksearch.html.tmpl
@@ -0,0 +1,325 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% INCLUDE global/header.html.tmpl
+   title  = "$terms.Bugzilla QuickSearch",
+   style_urls = ['skins/standard/page.css']         
+   onload = 'document.forms[\'f\'].quicksearch.focus()'
+ %]
+
+[% USE Bugzilla %]
+
+<p><label for="quicksearch">Type in one or more words (or pieces of words)
+  to search for:</label></p>
+
+<form name="f" action="buglist.cgi" method="get"
+      onsubmit="if (this.quicksearch.value == '')
+                { alert('Please enter one or more search terms first.');
+                  return false; } return true;">
+  <input type="text" size="40" name="quicksearch" id="quicksearch">
+  <input type="submit" value="Search" id="find">
+</form>
+
+<ul>
+  <li><a href="#basics">The Basics</a></li>
+  <li><a href="#basic_examples">Examples of Simple Queries</a></li>
+  <li><a href="#fields">Fields You Can Search On</a></li>
+  <li><a href="#advanced_features">Advanced Features</a></li>
+  <li><a href="#shortcuts">Advanced Shortcuts</a></li>
+  <li><a href="#advanced_examples">Examples of Complex Queries</a></li>
+</ul>
+
+<h2 id="basics">The Basics</h2>
+
+<ul class="qs_help">
+  <li>If you just put a word or series of words in the search box, 
+    [%+ terms.Bugzilla %] will search the 
+    [%+ field_descs.product FILTER html %],
+    [%+ field_descs.component FILTER html %], 
+    [%+ IF use_keywords %][%+ field_descs.keywords FILTER html %],[% END %]
+    [%+ field_descs.alias FILTER html %],
+    [%+ field_descs.short_desc FILTER html %], 
+    [%+ IF Param('usestatuswhiteboard') %][% field_descs.status_whiteboard FILTER html %],[% END %]
+    and [% field_descs.longdesc FILTER html %] fields for your word or words.</li>
+
+  <li>Typing just a <strong>number</strong> in the search box will take
+    you directly to the [% terms.bug %] with that ID. Also, just typing the
+    <strong>alias</strong> of [% terms.abug %] will take you to that [% terms.bug %].
+  </li>
+
+  <li>Adding more terms <strong>narrows down</strong> the search, it does not
+     expand it. (In other words, [% terms.Bugzilla %] searches for 
+     [%+ terms.bugs %] that match <em>all</em> your criteria, not
+     [%+ terms.bugs %] that match <em>any</em> of your criteria.)</li>
+
+  <li>Searching is <strong>case-insensitive</strong>. So <kbd>table</kbd>,
+    <kbd>Table</kbd>, and <kbd>TABLE</kbd> are all the same.</li>
+
+  <li>[% terms.Bugzilla %] does not just search for the exact word you put in,
+    but also for any word that <strong>contains</strong> that word.
+    So, for example, searching for "cat" would also find [% terms.bugs %]
+    that contain it as part of other words&mdash;for example, [% terms.abug %]
+    mentioning "<strong>cat</strong>ch" or "certifi<strong>cat</strong>e". It
+    will not find partial words in the [% field_descs.longdesc FILTER html %]
+    or [% field_descs.keywords FILTER html %] fields,
+    though&mdash;only full words are matched, there.</li>
+
+  <li>By default, only <strong>open</strong> [% terms.bugs %] are
+    searched. If you want to know how to also search closed [% terms.bugs %],
+    see the <a href="#shortcuts">Advanced Shortcuts</a> section.</li>
+
+  <li>If you want to search <strong>specific fields</strong>, you do it like
+    <kbd>field:value</kbd>, where <kbd>field</kbd> is one of the 
+    <a href="#fields">field names</a> lower down in this
+    document and <kbd>value</kbd> is the value you want to search for
+    in that field. If you put commas in the <kbd>value</kbd>, then it is
+    interpreted as a list of values, and [% terms.bugs %] that match
+    <em>any</em> of those values will be searched for.</li>
+</ul>
+
+<h2 id="basic_examples">Examples of Simple Queries</h2>
+
+<p>Here are some examples of how to write some simple queries.
+  <a href="#advanced_examples">Examples for more complex queries</a> can be
+  found lower in this page.</p>
+
+<ul class="qs_help">
+  <li>All open [% terms.bugs %] where userA@company.com is in the CC list
+    (no need to mention open [% terms.bugs %], this is the default):<br>
+    <kbd>cc:userA@company.com</kbd></li>
+  <li>All unconfirmed [% terms.bugs %] in product productA (putting the
+    [%+ terms.bug %] status at the first position make it being automagically
+    considered as [% terms.abug %] status):<br>
+    <kbd>UNCONFIRMED product:productA</kbd>
+  <li>All open and closed [% terms.bugs %] reported by userB@company.com
+    (we must specify ALL as the first word, else only open [% terms.bugs %]
+    are taken into account):<br>
+    <kbd>ALL reporter:userB@company.com</kbd>
+  <li>All open [% terms.bugs %] with severity blocker or critical with the
+    target milestone set to 2.5:<br>
+    <kbd>severity:blocker,critical milestone:2.5</kbd>
+  <li>All open [% terms.bugs %] in the component Research & Development
+    with priority P1 or P2 (we must use quotes for the component as its name
+    contains whitespaces):<br>
+    <kbd>component:"Research & Development" priority:P1,P2</kbd></li>
+</ul>
+
+<h2 id="fields">Fields You Can Search On</h2>
+
+<p>You can specify any of these fields like <kbd>field:value</kbd>
+  in the search box, to search on them. You can also abbreviate
+  the field name, as long as your abbreviation matches only one field name.
+  So, for example, searching on <kbd>stat:VERIFIED</kbd> will find all
+  [%+ terms.bugs %] in the <kbd>VERIFIED</kbd> status. Some fields have
+  multiple names, and you can use any of those names to search for them.</p>
+
+[% IF Bugzilla.active_custom_fields.size %]
+  [% SET first_field = Bugzilla.active_custom_fields.0 %]
+  <p>For custom fields, they can be used and abbreviated
+    based on the part of their name <em>after</em> the <kbd>cf_</kbd>
+    if you'd like, in addition to their standard name starting with
+    <kbd>cf_</kbd>. So for example, 
+    <kbd>[% first_field.name FILTER html %]</kbd> can be
+    referred to as 
+    <kbd>[% first_field.name.replace('^cf_') FILTER html %]</kbd>,
+    also. However, if this causes a conflict between the standard
+    [%+ terms.Bugzilla %] field names and the custom field names, the
+    standard field names always take precedence.</p>
+[% END %]
+
+[% SET field_table = {} %]
+[% FOREACH field = quicksearch_field_names.keys %]
+  [% description = field_descs.$field %]
+  [% field_table.$description = quicksearch_field_names.${field} %]
+[% END %]
+
+
+<table cellspacing="0" cellpadding="0" border="0" class="qs_fields">
+  <thead>
+    <tr>
+      <th class="field_name">Field</th>
+      <th class="field_nickname">Field Name(s) For Search</th>
+    </tr>
+  </thead>
+  <tbody>
+    [% FOREACH desc = field_table.keys.sort %]
+      <tr>
+        <td class="field_name">[% desc FILTER html %]</td>
+        <td class="field_nickname">
+          [% FOREACH nickname = field_table.$desc %]
+            <kbd>[% nickname FILTER html %]</kbd>
+            [% ",&nbsp; " UNLESS loop.last %]
+          [% END %]
+      </tr>
+    [% END %]
+  </tbody>
+</table>
+
+<h2 id="advanced_features">Advanced Features</h2>
+
+<ul class="qs_help">
+  <li>If you want to search for a <strong>phrase</strong> or something that
+    contains spaces, commas, colons or quotes, you must put it in quotes, like:
+    <kbd>"yes, this is a phrase"</kbd>. You must also use quotes to search for
+    characters that would otherwise be interpreted specially by quicksearch.
+    For example, <kbd>"this|that"</kbd> would search for the literal string
+    <em>this|that</em> and would not be parsed as <kbd>"this OR that"</kbd>.
+    Also, <kbd>"-field:value"</kbd> would search for the literal phrase
+    <em>-field:value</em> and would not be parsed as
+    <kbd>"NOT field:value"</kbd>.</li>
+
+  <li>You can use <strong>AND</strong>, <strong>NOT</strong>,
+    and <strong>OR</strong> in searches. 
+
+    You can also use <kbd>-</kbd> to mean "NOT", and <kbd>|</kbd> to mean "OR".
+    There is no special character for "AND", because by default any search
+    terms that are separated by a space are joined by an "AND".
+    Examples:
+    <ul>
+      <li>
+        <strong>NOT</strong>:<br>
+        Use <kbd><strong>-</strong><em>summary:foo</em></kbd> to exclude 
+        [%+ terms.bugs %] with <kbd>foo</kbd> in the summary.<br>
+        <kbd><em>NOT summary:foo</em></kbd> would have the same effect.
+      </li>
+      <li>
+        <strong>AND</strong>:<br>
+        <kbd><em>foo bar</em></kbd> searches for [% terms.bugs %] that contains
+        both <kbd>foo</kbd> and <kbd>bar</kbd>.<br>
+        <kbd><em>foo AND bar</em></kbd> would have the same effect.
+      </li>
+      <li>
+        <strong>OR</strong>:<br>
+        <kbd><em>foo<strong>|</strong>bar</em></kbd> would search
+        for [% terms.bugs %] that contain <kbd>foo</kbd> OR <kbd>bar</kbd>.<br>
+        <kbd><em>foo OR bar</em></kbd> would have the same effect.<br>
+      </li>
+    </ul>
+
+    <p>You cannot use | nor OR to enumerate possible values for a given field.
+      You must use commas instead. So <kbd>field:value1,value2</kbd> does what
+      you expect, but <kbd>field:value1|value2</kbd> would be treated as
+      <kbd>field:value1 OR value2</kbd>, which means value2 is not bound to
+      the given field.</p>
+
+    <p>OR has higher precedence than AND; AND is the top level operation.
+      For example:</p>
+    <p>Searching for <em><kbd>url|location bar|field -focus</kbd></em> means
+      (<kbd>url</kbd> OR <kbd>location</kbd>) AND (<kbd>bar</kbd> OR 
+      <kbd>field</kbd>) AND (NOT <kbd>focus</kbd>)</p>
+  </li>
+</ul>
+
+<h2 id="shortcuts">Advanced Shortcuts</h2>
+
+<p>In addition to using <a href="#fields">field names</a> to search
+  specific fields, there are certain characters or words that you can
+  use as a "shortcut" for searching certain fields:</p>
+
+<table cellspacing="0" cellpadding="0" border="0" class="qs_fields">
+  <thead>
+    <tr>
+      <th class="field_name">Field</th>
+      <th class="field_nickname">Shortcut(s)</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td class="field_name">[% field_descs.bug_status FILTER html %]</td>
+      <td class="field_nickname">
+        Make the <strong>first word</strong> of your search the name of any
+        status, or even an abbreviation of any status, and [% terms.bugs %]
+        in that status will be searched. <strong><kbd>ALL</kbd></strong>
+        is a special shortcut that means "all statuses".
+        <strong><kbd>OPEN</kbd></strong> is a special shortcut that means
+        "all open statuses".
+      </td>
+    </tr>
+    <tr>
+      <td class="field_name">[% field_descs.resolution FILTER html %]</td>
+      <td class="field_nickname">
+        Make the <strong>first word</strong> of your search the name of any
+        resolution, or even an abbreviation of any resolution, and 
+        [%+ terms.bugs %] with that resolution will be searched. For example,
+        making <kbd>FIX</kbd> the first word of your search will find all
+        [%+ terms.bugs %] with a resolution of <kbd>FIXED</kbd> .
+    </tr>
+    <tr>
+      <td class="field_name">[% field_descs.priority FILTER html %]</td>
+      <td class="field_nickname">"<strong>P1</strong>" (as a word anywhere in
+        the search) means "find [% terms.bugs %] with the highest priority. 
+        "P2" means the second-highest priority, and so on.
+        <p>Searching for "<strong>P1-3</strong>" will find [% terms.bugs %] in
+        any of the three highest priorities, and so on.</p>
+      </td>
+    </tr>
+    <tr>
+      <td class="field_name">[% field_descs.assigned_to FILTER html %]</td>
+      <td class="field_nickname"><strong>@</strong><em>value</em></td>
+    </tr>
+    <tr>
+      <td class="field_name">[% field_descs.product FILTER html %] or
+        [%+ field_descs.component FILTER html %]</td>
+      <td class="field_nickname"><strong>:</strong><em>value</em></td>
+    </tr>
+    [% IF use_keywords %]
+      <tr>
+        <td class="field_name">[% field_descs.keywords FILTER html %]</td>
+        <td class="field_nickname"><strong>!</strong><em>value</em></td>
+      </tr>
+    [% END %]
+    <tr>
+      [% SET key = "flagtypes.name" %]
+      <td class="field_name">[% field_descs.$key FILTER html %]</td>
+      <td class="field_nickname">
+        <em>flag</em><strong>?</strong><em>requestee</em>
+      </td>
+    </tr>
+    <tr>
+      <td class="field_name">[% field_descs.longdesc FILTER html %]
+        or [% field_descs.short_desc FILTER html %]</td>
+      <td class="field_nickname">
+        <strong>#</strong><em>value</em>
+      </td>
+    </tr>
+    [% IF Param('usestatuswhiteboard') %]
+      <tr>
+        <td class="field_name">[% field_descs.short_desc FILTER html %]
+          or [% field_descs.status_whiteboard FILTER html %]</td>
+        <td class="field_nickname"><strong>[</strong><em>value</em></td>
+      </tr>
+    [% END %]
+  </tbody>
+</table>
+
+<h2 id="advanced_examples">Examples of Complex Queries</h2>
+
+<p>It is pretty easy to write rather complex queries without too much effort.
+  For very complex queries, you have to use the
+  <a href="query.cgi?format=advanced">Advanced Search</a> form.</p>
+
+<ul class="qs_help">
+  <li>All [% terms.bugs %] reported by userA@company.com or assigned to him
+    (the initial @ is a shortcut for the assignee, see the
+    <a href="#shortcuts">Advanced Shortcuts</a> section above):<br>
+    <kbd>ALL @userA@company.com OR reporter:userA@company.com</kbd></li>
+  <li>All open [% terms.bugs %] in product productA with either severity
+    blocker, critical or major, or with priority P1, or with the blocker+
+    flag set, and which are neither assigned to userB@company.com nor to
+    userC@company.com (we make the assumption that there are only two users
+    matching userB and userC, else we would write the whole login name):<br>
+    <kbd>:productA sev:blocker,critical,major OR pri:P1 OR flag:blocker+ -assign:userB,userC</kbd></li>
+  <li>All FIXED [% terms.bugs %] with the blocker+ flag set, but without
+    the approval+ nor approval? flags set:<br>
+    <kbd>FIXED flag:blocker+ -flag:approval+ -flag:approval?</kbd></li>
+  <li>[% terms.Bugs %] with <em>That's a "unusual" issue</em> in the
+    [%+ terms.bug %] summary (double quotes are escaped using <em>\"</em>):<br>
+    <kbd>summary:"That's a \"unusual\" issue"</kbd></li>
+</ul>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/pages/release-notes.html.tmpl b/template/en/default/pages/release-notes.html.tmpl
new file mode 100644 (file)
index 0000000..6fc7ddb
--- /dev/null
+++ b/template/en/default/pages/release-notes.html.tmpl
@@ -0,0 +1,2225 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% SET title = "$terms.Bugzilla 4.4 Release Notes" %]
+[% INCLUDE global/header.html.tmpl 
+  title = title
+  style_urls = ['skins/standard/page.css'] 
+%]
+
+<h1>[% title FILTER html %]</h1>
+
+<ul class="bz_toc">
+  <li><a href="#v44_introduction">Introduction</a></li>
+  <!-- li><a href="#v44_point">Updates in this 4.4.x Release</a></li -->
+  <li><a href="#v44_req">Minimum Requirements</a></li>
+  <li><a href="#v44_feat">New Features and Improvements</a></li>
+  <li><a href="#v44_issues">Outstanding Issues</a></li>
+  <li><a href="#v44_upgrading">Notes On Upgrading From a Previous Version</a></li>
+  <li><a href="#v44_code_changes">Code Changes Which May Affect
+    Customizations and Extensions</a></li>
+  <li><a href="#v44_previous">Release Notes for Previous Versions</a></li>
+</ul>
+
+<h2 id="v44_introduction">Introduction</h2>
+
+<p>Welcome to [% terms.Bugzilla %] 4.4! It has been over a year since we
+  released [% terms.Bugzilla %] 4.2 on February 2012, and this new major
+  release comes with several new features and improvements. This release
+  contains major improvements to WebServices, which were our main target in
+  this release, a rewritten tagging system, a real MIME type auto-detection for
+  attachments, improved support for Oracle, performance improvements and lots
+  of other enhancements.</p>
+
+<p>If you're upgrading, make sure to read <a href="#v44_upgrading">Notes On
+  Upgrading From a Previous Version</a>. If you are upgrading from a release
+  before 4.2, make sure to read the release notes for all the
+  <a href="#v44_previous">previous versions</a> in between your version and
+  this one, <strong>particularly the Upgrading section of each version's
+  release notes</strong>.</p>
+
+<!-- h2 id="v44_point">Updates in this 4.4.x Release</h2 -->
+
+
+<h2 id="v44_req">Minimum Requirements</h2>
+
+<p>Any requirements that are new since 4.2 will look like
+  <span class="req_new">this</span>.</p>
+
+<ul>
+  <li><a href="#v44_req_perl">Perl</a></li>
+  <li><a href="#v44_req_mysql">For MySQL Users</a></li>
+  <li><a href="#v44_req_pg">For PostgreSQL Users</a></li>
+  <li><a href="#v44_req_oracle">For Oracle Users</a></li>
+  <li><a href="#v44_req_sqlite">For SQLite Users</a></li>
+  <li><a href="#v44_req_modules">Required Perl Modules</a></li>
+  <li><a href="#v44_req_optional_mod">Optional Perl Modules</a></li>
+  <li><a href="#v44_req_apache">Optional Apache Modules</a></li>
+</ul>
+
+<h3 id="v44_req_perl">Perl</h3>
+
+<p>Perl v5.8.1</p>
+
+<p><strong>IMPORTANT:</strong> This is the last major release to support
+  Perl 5.8.x! The next major release, [% terms.Bugzilla %] 5.0, will require
+  Perl 5.10.1 as a minimum.</p>
+
+[% INCLUDE db_req db='mysql' %]
+
+[% INCLUDE db_req db='pg' dbd_new => 1 %]
+
+[% INCLUDE db_req db='oracle' %]
+
+[% INCLUDE db_req db='sqlite' %]
+
+<h3 id="v44_req_modules">Required Perl Modules</h3>
+
+[% INCLUDE req_table reqs = REQUIRED_MODULES
+                     updated = ['TimeDate', 'DBI', 'Email-Send', 'List-MoreUtils'] %]
+
+<h3 id="v44_req_optional_mod">Optional Perl Modules</h3>
+
+<p>The following perl modules, if installed, enable various
+  features of [% terms.Bugzilla %]:</p>
+
+[% INCLUDE req_table reqs = OPTIONAL_MODULES
+                     new  = ['Net-SMTP-SSL', 'HTML-FormatText-WithLinks',
+                             'File-MimeInfo', 'IO-stringy']
+                     include_feature = 1 %]
+
+<h3 id="v44_req_apache">Optional Apache Modules</h3>
+
+<p>If you are using Apache as your webserver, [% terms.Bugzilla %] can
+  take advantage of some Apache features if you have the below Apache
+  modules installed and enabled. Currently,
+  <a href="#v40_feat_js_css_update">certain [% terms.Bugzilla %] features</a>
+  are enabled only if you have all of the following modules installed
+  and enabled:</p>
+
+<ul>
+  <li>mod_headers</li>
+  <li>mod_expires</li>
+  <li>mod_env</li>
+</ul>
+
+<p>On most systems (but not on Windows), <kbd>checksetup.pl</kbd> is able to
+  tell whether or not you have these modules installed, and it will tell
+  you.</p>
+
+
+<h2 id="v44_feat">New Features and Improvements</h2>
+
+<ul>
+  <li><a href="#v44_feat_search">Allow Multiple Search Criteria to Match one Field</a></li>
+  <li><a href="#v44_feat_search_perf">Improved Performance for Searches</a></li>
+  <li><a href="#v44_feat_bug_tags">Overhaul of the Tagging System</a></li>
+  <li><a href="#v44_feat_mimetype_autodetect">Auto-Detection of the Attachment MIME Type</a></li>
+  <li><a href="#v44_feat_saved_reports">Saving Tabular and Graphical Reports</a></li>
+  <li><a href="#v44_feat_whining">Custom Columns in Whine Emails</a></li>
+  <li><a href="#v44_feat_webservices">Improved WebServices</a></li>
+  <li><a href="#v44_feat_apache_config">New Apache Configuration</a></li>
+  <li><a href="#v44_feat_other">Other Enhancements and Changes</a></li>
+</ul>
+
+<h3 id="v44_feat_search">Allow Multiple Search Criteria to Match one Field</h3>
+
+<p>
+  In the "Advanced Search" page, it is now possible to build queries using
+  multiple custom search criteria against the same field. In [% terms.Bugzilla %]
+  4.2 and older, queries of the form
+  <br><br>
+  <kbd>"Status changed to VERIFIED" AND "Status changed by foo@bar.com"</kbd>
+  <br><br>
+  were returning all [% terms.bugs %] which had their status changed to VERIFIED
+  by some user and which were edited by foo@bar.com once, but both actions could
+  be independent. In [% terms.Bugzilla %] 4.4, you can now decide if both
+  criteria must match the exact same action or not, i.e. if you want
+  [%+ terms.bugs %] whose status has been set to VERIFIED by foo@bar.com himself.
+  In the same way, queries of the form
+  <br><br>
+  <kbd>"Flags changed to approval+" AND "Flags changed by foo@bar.com"</kbd>
+  <br><br>
+  can now return [% terms.bugs %] for which the approval flag has been set to
+  "+" by foo@bar.com himself. In previous versions, both actions were treated
+  independently and [% terms.bugs %] for which foo@bar.com set the approval flag
+  to "?" and which is then set to "+" by someone else were also returned.
+</p>
+<p>
+  This new feature gives you the ability to build more accurate queries and to
+  get more relevant results.
+</p>
+
+<h3 id="v44_feat_search_perf">Improved Performance for Searches</h3>
+
+<p>
+  The search system got a performance boost which in some cases decreases the
+  time spent to run queries from several minutes to a few seconds only.
+  The more complex your queries are, the more visible the performance win
+  should be.
+</p>
+
+<h3 id="v44_feat_bug_tags">Overhaul of the Tagging System</h3>
+
+<p>
+  The old tagging system which was in the footer of all pages had severe design
+  and usability limitations and has been replaced by a shiny new one which lets
+  you tag [% terms.bugs %] from the [% terms.bug %] report directly. Tags now
+  mostly work like keywords, but with two major differences. First of all, they
+  are personal, meaning that tags you set on [% terms.bugs %] are only visible
+  by you, and nobody else is notified nor can see which tags you set. This
+  behavior is the same as the old tagging system and so this feature didn't
+  change. The second major difference is that the list of available tags is
+  unlimited and is in no way hardcoded by administrators. You can type either
+  a new tag of your choice, or you can select one from an auto-generated list
+  of tags which you already used in other [% terms.bugs %]. Again, this feature
+  was already present in the old tagging system, but its usability has been
+  greatly improved. In particular, this means that tags are now displayed in
+  [%+ terms.bug %] reports directly, so that you immediately know which tags
+  you already set for that [% terms.bug %]. This feature is new in this release.
+</p>
+<p>
+  Another new feature is that your personal tags can now be listed in buglists.
+  They can also be used as search criteria in your queries. If you decide to
+  share a saved search which uses tags as criteria, this will work too! Note
+  that when you add a new tag, no saved search based on this tag is created
+  anymore, as you can easily create it yourself if you really need it.
+</p>
+<p>
+  The tags set with the old tagging system are automatically migrated to the
+  new system.
+</p>
+
+<h3 id="v44_feat_mimetype_autodetect">Auto-Detection of the Attachment MIME Type</h3>
+
+<p>
+  When a user uploads a new attachment and lets the "Content Type" field set to
+  "auto-detect", [% terms.Bugzilla %] now does its own MIME type detection
+  if the web browser tells him that the attachment is of type
+  "application/octet-stream", in an attempt to make a better guess than the web
+  browser. In all other cases, [% terms.Bugzilla %] still trusts what the browser
+  tells him.
+</p>
+<p>
+  Check the <a href="#v44_req_optional_mod">list of optional Perl modules</a> to
+  know which modules to install in order to enable MIME type sniffing.
+</p>
+
+<h3 id="v44_feat_saved_reports">Saving Tabular and Graphical Reports</h3>
+
+<p>
+  It is now possible to save tabular and graphical reports in the same way as
+  you save searches. Saved reports will appear in the footer of pages, below
+  saved searches.
+</p>
+<p>
+  Unlike saved searches, it is not yet possible to share saved reports with
+  other users.
+</p>
+
+<h3 id="v44_feat_whining">Custom Columns in Whine Emails</h3>
+
+<p>
+  The list of columns to display in buglists contained in emails sent by the
+  whining system on a regular basis is no longer hardcoded. If the saved
+  search used for whining emails contains a list of columns, these columns are
+  used to be displayed in the emails. If no custom list is found, the default
+  column list is used instead.
+</p>
+<p>
+  This means that depending on the kind of email notifications you want, you
+  can fully customize data to return, on a per saved search basis!
+</p>
+
+<h3 id="v44_feat_webservices">Improved WebServices</h3>
+
+<p>
+  This release got major improvements in its WebServices interface. Many new
+  methods have been implemented to let third-party applications interact with
+  [%+ terms.Bugzilla %] even more closely. For instance, it is now possible to
+  know what parameters are set to using <kbd>B[%%]ugzilla.parameters</kbd>.
+  It is now also possible to update tags, products, groups or user accounts
+  using our API.
+<p>
+<p>
+  Several existing methods have also been improved to return data which
+  weren't available till now, such as [% terms.bug %] and attachment flags
+  using <kbd>B[%%]ug.get</kbd>, <kbd>B[%%]ug.attachments</kbd> or
+  <kbd>Product.get</kbd>. Users can also get their saved searches and reports
+  using <kbd>User.get</kbd>; and much more, see the
+  <a href="#v44_feat_webservices_details">detailed list</a> below.
+</p>
+
+<h3 id="v44_feat_apache_config">New Apache Configuration</h3>
+
+<p>
+  For improved security, [% terms.Bugzilla %] now prevents directory browsing
+  by default. If you run [% terms.Bugzilla %] under Apache (as most people do),
+  you most likely require a <strong>new Apache configuration</strong> for this
+  version of [% terms.Bugzilla %]. See the
+  <a href="#v44_upgrading">Notes On Upgrading From a Previous Version</a>
+  section for details.
+</p>
+
+<h3 id="v44_feat_other">Other Enhancements and Changes</h3>
+
+<h4>Enhancements for Users</h4>
+
+<ul>
+  <li><strong>[% terms.Bugs %]:</strong> It is now possible to add yourself to
+    the CC list when uploading an attachment and when editing an existing one.</li>
+  <li><strong>[% terms.Bugs %]:</strong> There is a new user preference to be
+    automatically added to the CC list of [% terms.bugs %] for which a flag
+    request is addressed to you (the flag has you as the requestee).</li>
+  <li><strong>[% terms.Bugs %]:</strong> Changes to the CC list no longer
+    causes midair collisions.</li>
+  <li><strong>[% terms.Bugs %]:</strong> There is now a <em>(take)</em> link
+    besides the QA Contact field to easily set yourself as QA contact.</li>
+  <li><strong>[% terms.Bugs %]:</strong> [% terms.Bugs %] are no longer
+    reassigned to the default assignee when moving the [% terms.bug %] into
+    another product or component if the current assignee is not the default
+    one. Same goes for the QA contact.</li>
+  <li><strong>[% terms.Bugs %]:</strong> When reporting a new [% terms.bug %],
+    flags which are not available for the selected component and those which
+    the reporter cannot edit are now hidden instead of being disabled. For
+    existing [% terms.bugs %], unset flags are also hidden by default. Clicking
+    the <em>(set flags)</em> or <em>(more flags)</em> link will make them
+    appear.</li>
+  <li><strong>[% terms.Bugs %]:</strong> When viewing [% terms.abug %], the list
+    of duplicated [% terms.bugs %] is now listed near the top of the page.</li>
+  <li><strong>[% terms.Bugs %]:</strong> Private comments now always remain
+    visible to their author. Previously, the author of a comment couldn't see
+    it anymore if the comment was marked private and the author isn't in the
+    insider group.</li>
+  <li><strong>[% terms.Bugs %]:</strong> The See Also field now supports URLs
+    pointing to GitHub by default. If the new MoreBugUrl extension included in
+    this release is enabled, then you can also add URLs pointing to:
+    b[%%]ugs.php.net, RT, appspot.com (Rietveld), Review Board, and
+    getsatisfaction.com.</li>
+  <li><strong>Searches:</strong> The alias of [% terms.bugs %] you cannot see
+    are no longer resolved to their [% terms.bug %] ID, meaning that it is no
+    longer possible to connect an alias with its ID unless you can see the
+    [%+ terms.bug %].</li>
+  <li><strong>Searches:</strong> Custom multi-select fields are now available
+    in the "Search By Change History" section of the query page.</li>
+  <li><strong>Searches:</strong> The <em>changed by</em> operator in boolean
+    charts now accepts pronouns.</li>
+  <li><strong>Searches:</strong> The requester and requestee fields in boolean
+    charts now accept pronouns.</li>
+  <li><strong>Searches:</strong> It is now possible to hide the description of
+    queries appearing at the top of buglists.</li>
+  <li><strong>Requests:</strong> The "My Requests" page now displays an AND/OR
+    radio button to define the interaction between the requester and requestee
+    fields.</li>
+  <li><strong>Email Notifications:</strong> There is a new user preference to
+    not prepend "New:" to the subject of [% terms.bug %]mails when reporting
+    a new [% terms.bug %]. Some email clients couldn't thread emails correctly
+    due to this.</li>
+  <li><strong>Email Notifications:</strong> There is a new email event to get
+    notifications when the product or component of [% terms.abug %] changes.</li>
+  <li><strong>Email Notifications:</strong> All [% terms.bug %]mails now have
+    a <em>X-Bugzilla-Flags</em> email header, listing currently set flags.</li>
+  <li><strong>Email Notifications:</strong> All [% terms.bug %]mails now have
+    a <em>X-Bugzilla-Version</em> email header with the current product
+    version.</li>
+  <li><strong>Whining:</strong> The sort order of the saved search is used to
+    sort [% terms.bugs %] in the emails.</li>
+  <li><strong>User Accounts:</strong> To confirm an email address change, the
+    password is now requested instead of the old email address.</li>
+  <li><strong>Graphical Reports:</strong> The size of graphical reports is now
+    set dynamically to fit within the window of the web browser.
+    The Taller/Thinner/Fatter/Shorter links are now gone.</li>
+  <li><strong>Incoming Emails:</strong> <kbd>email_in.pl</kbd> now accepts
+    HTML-only emails to create and edit [% terms.bugs %] by email.</li>
+  <li><strong>Incoming Emails:</strong> When creating a new [% terms.bug %],
+    <kbd>email_in.pl</kbd> will look at the <em>Importance</em> and
+    <em>X-Priority</em> email headers to increase or decrease the initial
+    priority of the [% terms.bug %], unless the priority is already explicitly
+    set in the email itself.</li>
+  <li><strong>Skins:</strong> [% terms.Bugzilla %] no longer fetches all skins
+    available when viewing a page. It only loads the skin selected by the user
+    in his preferences, which results in less requests to the server.</li>
+</ul>
+
+<h4>Enhancements for Administrators and Developers</h4>
+
+<ul>
+  <li><strong>License:</strong> The [% terms.Bugzilla %] code is now released
+    under the MPL 2.0 license (previously was MPL 1.1).</li>
+  <li><strong>Installation:</strong> On mod_perl, templates now remain in
+    memory for one hour, which can cause an increase in memory requirements.
+    This also means that it can take up to one hour before changes in templates
+    become active (unless you restart Apache).</li>
+  <li><strong>Installation:</strong> Running
+    <kbd>checksetup.pl --make-admin=foo@bar.com</kbd> now automatically
+    re-enables the user account if it was disabled.</li>
+  <li><strong>Configuration:</strong> A new parameter <em>smtp_ssl</em> can be
+    turned on to enable SSL connections to the SMTP server to send email
+    notifications.</li>
+  <li><strong>Administration:</strong> Custom fields now have a new <em>Long
+    description</em> attribute to better describe what the custom field is
+    about. This description then appears as a tooltip when hovering the custom
+    field in [% terms.bug %] reports.</li>
+  <li><strong>Administration:</strong> When creating a new product, the form
+    lets you add a component at the same time.</li>
+  <li><strong>Administration:</strong> When viewing a user account in
+    <kbd>editusers.cgi</kbd>, the date of the last login is displayed. Users
+    who did not log in since you upgraded to 4.4 will have this field empty.</li>
+  <li><strong>Administration:</strong> It is now possible to exclude disabled
+    user accounts when running a query in <kbd>editusers.cgi</kbd>.</li>
+  <li><strong>Administration:</strong> The default CC list is now also displayed
+    when listing components in <kbd>editcomponents.cgi</kbd>.</li>
+  <li><strong>Administration:</strong> Target milestones can now be 64 characters
+    long, for consistency with versions (previously was limited to 20 characters
+    only).</li>
+  <li><strong>Administration:</strong> The result code returned by
+    <kbd>contrib/bugzilla-queue.rhel</kbd> when it's not running is now 2
+    instead of 0.</li>
+  <li><strong>Database:</strong> Support for MySQL 5.6 has been added.</li>
+  <li><strong>Database:</strong> Support for Oracle has been greatly improved.</li>
+  <li><strong>Security:</strong> For improved security, the
+    "X-Content-Type-Options:&nbsp;nosniff" and "X-XSS-Protection:&nbsp;block"
+    headers are now sent with every response.</li>
+  <li><strong>Security:</strong> Tokens are now generated using HMAC SHA-256
+    instead of MD5.</li>
+  <li><strong>Documentation:</strong> The documentation is now generated with
+    <kbd>xmlto</kbd> and <kbd>dblatex</kbd> instead of <kbd>jade</kbd>.</li>
+</ul>
+
+<h4 id="v44_feat_webservices_details">WebService Changes</h4>
+
+<ul>
+  <li>Several new methods have been added: <kbd>B[%%]ug.update_tags</kbd>,
+    <kbd>B[%%]ugzilla.parameters</kbd>, <kbd>B[%%]ugzilla.last_audit_time</kbd>,
+    <kbd>Classification.get</kbd>, <kbd>Group.update</kbd>,
+    <kbd>Product.update</kbd>, <kbd>User.update</kbd>.</li>
+  <li><kbd>B[%%]ug.add_attachment</kbd> now only returns the ID of the newly
+    created attachments instead of all the attachment data.</li>
+  <li><kbd>B[%%]ug.attachments</kbd> now also returns the <kbd>size</kbd> field
+    containing the size of the attachment.</li>
+  <li><kbd>B[%%]ug.attachments</kbd> and <kbd>B[%%]ug.get</kbd> now return
+    data about flags.</li>
+  <li><kbd>B[%%]ug.comments</kbd> now also returns <kbd>creation_time</kbd>
+    which is exactly the same as <kbd>time</kbd>, but is provided for
+    consistency with <kbd>B[%%]ug.get</kbd> and <kbd>B[%%]ug.attachments</kbd>.
+    The <kbd>time</kbd> field may be deprecated and removed in a future release,
+    so you should use <kbd>creation_time</kbd> instead.</li>
+  <li><kbd>B[%%]ug.comments</kbd> now also returns the <kbd>count</kbd> field
+    containing the comment ID relative to the [% terms.bug %] it belongs to.
+    This is the same comment ID as the one you can see in [% terms.bug %]
+    reports.</li>
+  <li>It is now possible to create new [% terms.bugs %] with a closed status with
+    <kbd>B[%%]ug.create</kbd>.</li>
+  <li>The <kbd>bug_status</kbd> field returned by <kbd>B[%%]ug.fields</kbd> now
+    also includes [% terms.bug %] statuses available on [% terms.bug %] creation.</li>
+  <li><kbd>B[%%]ug.fields</kbd> now also returns keyword descriptions, not only
+    their names.</li>
+  <li><kbd>B[%%]ug.fields</kbd> now also returns the <kbd>is_active</kbd> field
+    for product-specific fields.</li>
+  <li>For users in the timetracking group, <kbd>B[%%]ug.get</kbd> now also
+    returns the <kbd>actual_time</kbd> field with the total number of hours
+    spent in the [% terms.bug %].</li>
+  <li>Field names returned in the <kbd>field_name</kbd> field of the
+    <kbd>B[%%]ug.history</kbd> method have changed to be consistent with other
+    methods.</li>
+  <li>The <kbd>B[%%]ug.search</kbd> method was returning all visible [% terms.bugs %]
+    when called with no arguments, ignoring the <kbd>max_search_results</kbd>
+    and <kbd>search_allow_no_criteria</kbd> parameters. This has been fixed.</li>
+  <li><kbd>Product.get</kbd> now also returns the <kbd>flag_types</kbd> field
+    containing all the relevant data for attachment and [% terms.bug %] flag types.</li>
+  <li><kbd>Product.get</kbd> now throws an error if neither <kbd>ids</kbd> nor
+    <kbd>names</kbd> is passed to the method.</li>
+  <li>When requesting data for your own account using <kbd>User.get</kbd>,
+    this method now returns two additional fields: <kbd>saved_searches</kbd>
+    and <kbd>saved_reports</kbd> containing all your saved searches and
+    graphical and tabular reports.</li>
+  <li><kbd>User.get</kbd> now also returns the <kbd>groups</kbd> field
+    containing the list of groups the user belongs to. The list is filtered
+    based on your privileges.</li>
+</ul>
+
+
+<h2 id="v44_issues">Outstanding Issues</h2>
+
+<ul>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=89822">
+    [%- terms.Bug %] 89822</a>: When changing multiple [% terms.bugs %] at
+    the same time, there is no "mid-air collision" protection.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=276230">
+    [%- terms.Bug %] 276230</a>: The support for restricting access to
+    particular Categories of New Charts is not complete. You should treat the
+    <em>chartgroup</em> parameter as the only access mechanism available.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=584742">
+    [%- terms.Bug %] 584742</a>: When viewing [% terms.abug %], WebKit-based
+    browsers can automatically reset a field's selected value when the field
+    has disabled values.</li>
+</ul>
+
+
+<h2 id="v44_upgrading">Notes On Upgrading From a Previous Version</h2>
+
+<h3>IMPORTANT: Apache Configuration Change</h3>
+
+<p>
+  For improved security, [% terms.Bugzilla %] now prevents directory browsing
+  by default. In order to do that, the root <kbd>bugzilla/.htaccess</kbd> file
+  now contains the <kbd>Options -Indexes</kbd> directive. By default, this
+  directive is not allowed in <kbd>.htaccess</kbd> and so you must configure
+  Apache to allow it. To do that, add <kbd>Options</kbd> to the
+  <kbd>AllowOverride</kbd> directive in <kbd>httpd.conf</kbd>. This means you
+  should now have something like this:
+  <p>
+    <kbd>AllowOverride Limit FileInfo Indexes Options</kbd>
+  </p>
+  Check the
+  <a href="http://www.bugzilla.org/docs/4.4/en/html/configuration.html#http-apache">documentation</a>
+  for more information about how to configure Apache.
+</p>
+
+<h2 id="v44_code_changes">Code Changes Which May Affect Customizations and Extensions</h2>
+
+<ul>
+  <li>The <em>usebugaliases</em> parameter has been removed. Aliases are now
+    always available.</li>
+  <li>There is a new code hook <kbd>admin_editusers_action</kbd> to alter the
+    way <kbd>editusers.cgi</kbd> works.</li>
+  <li>There is a new code hook <kbd>buglist_column_joins</kbd> to alter the way
+    tables and columns are joined in queries. In combination with the
+    <kbd>buglist_columns</kbd> hook, this permits to customize the list of
+    columns to display in buglists.</li>
+  <li>There is a new code hook <kbd>bug_start_of_update</kbd> which is called
+    after <kbd>object_end_of_update</kbd> but before <kbd>bug_end_of_update</kbd>
+    for a better control on how to update [% terms.bugs %].</li>
+  <li>There is a new code hook <kbd>bug_url_sub_classes</kbd> to support
+    additional URLs in the See Also field.</li>
+  <li>There is a new code hook <kbd>error_catch</kbd> to catch errors thrown
+    by [% terms.Bugzilla %] and to take the appropriate actions.</li>
+  <li>There is a new code hook <kbd>path_info_whitelist</kbd> to whitelist
+    scripts which should still get the Path-Info information from URLs. By
+    default, Path-Info is now removed before being passed to CGI scripts.</li>
+  <li>It is now illegal to have a product with no components and no versions.
+    Trying to delete the last component or version of a product is now
+    rejected.</li>
+  <li>Trying to set the component, target milestone or version of [% terms.abug %]
+    to a disabled value is no longer accepted. The change will be rejected.</li>
+  <li>The comment box now checks the returned value of check_can_change_field()
+    to determine if it should be displayed or not. This means its visibility
+    can now be controlled by the <kbd>bug_check_can_change_field</kbd> hook.</li>
+  <li>Flags now checks the returned value of check_can_change_field() to
+    determine if they should appear as editable or not. This means their
+    visibility can now be controlled by the <kbd>bug_check_can_change_field</kbd>
+    hook.</li>
+  <li>Quips can no longer exceed 512 characters. Existing quips longer than
+    that are automatically truncated when upgrading.</li>
+  <li>The static <kbd>bugzilla.dtd</kbd> file has been replaced by a dynamic
+    one to take custom fields into account. The old
+    <em>&lt;urlbase&gt;/bugzilla.dtd</em> URL is now
+    <em>&lt;urlbase&gt;/page.cgi?id=bugzilla.dtd</em>.</li>
+  <li>There is a new extension located at <kbd>extensions/MoreBugUrl/</kbd>
+    which permits to add new classes of URLs in the See Also field. It uses
+    the <kbd>bug_url_sub_classes</kbd> hook mentioned above.</li>
+  <li>There is a new <kbd>B[%%]ugzilla->process_cache</kbd> method to store
+    data which should remain available for the lifetime of the worker process,
+    on mod_perl. On mod_cgi, it behaves the same way as
+    <kbd>B[%%]ugzilla->request_cache</kbd>.</li>
+  <li>In the RDF output of <kbd>config.cgi</kbd>, URIs used to identify
+    versions and target milestones have been changed to be unique across
+    products.</li>
+  <li>The RDF output of <kbd>config.cgi</kbd> now also returns data about
+    classifications.</li>
+  <li>It is now legal to call <kbd>B[%%]ugzilla::Version->check({ id => $id })</kbd>
+    and <kbd>B[%%]ugzilla::Milestone->check({ id => $id })</kbd> to validate
+    and get an object using its ID.</li>
+  <li>Rows in the <kbd>dependencies</kbd>, <kbd>flaginclusions</kbd> and
+    <kbd>flagexclusions</kbd> DB tables are now enforced to be unique.</li>
+  <li>The <kbd>b[%%]ugs_activity</kbd> and <kbd>profiles_activity</kbd> DB
+    tables now have an auto-incremented primary key named <kbd>id</kbd>.</li>
+  <li>A custom <kbd>B[%%]ugzilla.pm</kbd> module has been added into
+    <kbd>contrib/</kbd> to help packagers to package B[%%]ugzilla in their
+    Linux distros.</li>
+</ul>
+
+
+<h1 id="v44_previous">[% terms.Bugzilla %] 4.2 Release Notes</h1>
+
+<ul class="bz_toc">
+  <li><a href="#v42_introduction">Introduction</a></li>
+  <li><a href="#v42_point">Updates in this 4.2.x Release</a></li>
+  <li><a href="#v42_req">Minimum Requirements</a></li>
+  <li><a href="#v42_feat">New Features and Improvements</a></li>
+  <li><a href="#v42_issues">Outstanding Issues</a></li>
+  <li><a href="#v42_code_changes">Code Changes Which May Affect
+    Customizations and Extensions</a></li>
+  <li><a href="#v42_previous">Release Notes for Previous Versions</a></li>
+</ul>
+
+<h2 id="v42_introduction">Introduction</h2>
+
+<p>Welcome to [% terms.Bugzilla %] 4.2! It has been almost a year since we
+  released [% terms.Bugzilla %] 4.0 on February 2011, and this new major
+  release comes with several new features and improvements. This release
+  contains major improvements to search, support for SQLite, improved
+  WebServices, and lots of other enhancements.</p>
+
+<p>If you are upgrading from a release before 4.0, make sure to read the
+  release notes for all the <a href="#v42_previous">previous versions</a>
+  in between your version and this one, <strong>particularly the Upgrading
+  section of each version's release notes</strong>.</p>
+
+<h2 id="v42_point">Updates in this 4.2.x Release</h2>
+
+<h3>4.2.3</h3>
+
+<p>This release fixes two security issues. See the
+  <a href="http://www.bugzilla.org/security/3.6.10/">Security Advisory</a>
+  for details.</p>
+
+<p>In addition, the following important fixes/changes have been made in this
+  release:</p>
+
+<ul>
+  <li>Attaching a file to [% terms.abug %] was broken due to a change in
+    Perl 5.16.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=771100">[% terms.Bug %] 771100</a>)</li>
+  <li>A regression in [% terms.Bugzilla %] 4.2.2 made Oracle crash when
+    displaying a buglist.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=780028">[% terms.Bug %] 780028</a>)</li>
+  <li>It was possible to search on history for comments and attachments you
+    cannot see (though these private comments and attachments are never disclosed).
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=779709">[% terms.Bug %] 779709</a>)</li>
+  <li>PostgreSQL databases could be created with the wrong encoding despite
+    the utf8 parameter being enabled.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=783786">[% terms.Bug %] 783786</a>)</li>
+  <li>Scheduled whines could be sent at the wrong time on Oracle.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=559539">[% terms.Bug %] 559539</a>)</li>
+  <li>Tokens are no longer included in saved queries.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=772953">[% terms.Bug %] 772953</a>)</li>
+  <li>An admin could unintentionally break the display of buglists if a custom
+    field description contains a &lt; or &gt; character, because these characters
+    were not filtered.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=785917">[% terms.Bug %] 785917</a>)</li>
+  <li>Adding or removing a DB column in Oracle didn't handle SERIAL columns
+    correctly.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=731156">[% terms.Bug %] 731156</a>)</li>
+  <li>A minor CSRF vulnerability in token.cgi allowed possible unauthorized
+    password reset e-mail requests.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=706271">[% terms.Bug %] 706271</a>)</li>
+</ul>
+
+<h3>4.2.2</h3>
+
+<p>This release fixes two security issues. See the
+  <a href="http://www.bugzilla.org/security/3.6.9/">Security Advisory</a>
+  for details.</p>
+
+<p>In addition, the following important fixes/changes have been made in this
+  release:</p>
+
+<ul>
+  <li>A regression introduced in [% terms.Bugzilla %] 4.0 caused some login
+    names to be ignored when entered in the CC list of [% terms.bugs %].
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=756314">[% terms.Bug %] 756314</a>)</li>
+  <li>Some queries could trigger an invalid SQL query if strings entered by
+    the user contained leading or trailing whitespaces.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=760075">[% terms.Bug %] 760075</a>)</li>
+  <li>The auto-completion form for keywords no longer automatically selects
+    the first keyword in the list when the field is empty.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=764517">[% terms.Bug %] 764517</a>)</li>
+  <li>A regression in [% terms.Bugzilla %] 4.2 prevented classifications
+    from being used in graphical and tabular reports in the "Multiple Tables"
+    field.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=753688">[% terms.Bug %] 753688</a>)</li>
+  <li>Attachments created by the <kbd>email_in.pl</kbd> script were associated
+    to the wrong comment.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=762785">[% terms.Bug %] 762785</a>)</li>
+  <li>Very long dependency lists can now be viewed correctly.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=762783">[% terms.Bug %] 762783</a>)</li>
+  <li>Keywords are now correctly escaped in the auto-completion form to prevent
+    any XSS abuse.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=754561">[% terms.Bug %] 754561</a>)</li>
+  <li>A regression introduced in [% terms.Bugzilla %] 4.0rc2 when fixing
+    CVE-2011-0046 caused the "Un-forget the search" link to not work correctly
+    anymore when restoring a deleted saved search, because this link was
+    lacking a valid token.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=768870">[% terms.Bug %] 768870</a>)</li>
+  <li>Two minor CSRF vulnerabilities have been fixed which could let an attacker
+    alter your default search criteria in the Advanced Search page.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=754672">[% terms.Bugs %] 754672</a>
+    and <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=754673">754673</a>)</li>
+</ul>
+
+<h3>4.2.1</h3>
+
+<p>This release fixes one security issue. See the
+  <a href="http://www.bugzilla.org/security/3.6.8/">Security Advisory</a>
+  for details.</p>
+
+<p>In addition, the following important fixes/changes have been made in this
+  release:</p>
+
+<ul>
+  <li>Due to a regression introduced when fixing CVE-2012-0453, if an XML-RPC
+    client sets the charset as part of its Content-Type header, we were
+    incorrectly rejecting the request. The header is now correctly parsed.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=731219">[% terms.Bug %] 731219</a>)</li>
+  <li>Email notifications about status changes in blockers were incorrectly
+    formatted. Several pieces of text were missing in the emails.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=731586">[% terms.Bug %] 731586</a>)</li>
+  <li>Many [% terms.bugs %] related to the searching system have been fixed.
+    (<a href="https://bugzilla.mozilla.org/buglist.cgi?bug_id=58179,715270,730984,731163,737436">
+    [% terms.Bugs %] 58179, 715270, 730984, 731163 and 737436</a>)</li>
+  <li>When using the QuickSearch box, complex queries are now parsed correctly.
+    It also behaves correctly with non-ASCII characters (such as é, ä, ü, etc.).
+    (<a href="https://bugzilla.mozilla.org/buglist.cgi?bug_id=554819,663377,730207">
+    [% terms.Bugs %] 554819, 663377 and 730207</a>)</li>
+  <li>The 'take' link besides the assignee field now works correctly when
+    the <kbd>usemenuforusers</kbd> parameter is turned on.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=734997">[% terms.Bug %] 734997</a>)</li>
+  <li>URLs in the 'Total' row at the bottom of tabular reports were broken
+    when JavaScript was enabled and a user field was used for the vertical
+    axis.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=731323">[% terms.Bug %] 731323</a>)</li>
+  <li>Some performance problems have been fixed for installations with many
+    products, components or versions.
+    (<a href="https://bugzilla.mozilla.org/buglist.cgi?bug_id=695514,731055">
+    [% terms.Bugs %] 695514 and 731055</a>)</li>
+  <li>A new hook named <kbd>buglist_column_joins</kbd> has been added to let
+    extensions alter the <kbd>Bugzilla::Search::COLUMN_JOINS</kbd> hash.
+    Now more fields can be displayed as columns in buglists, in combination
+    with the already existing <kbd>buglist_columns</kbd> hook.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=743991">[% terms.Bug %] 743991</a>)</li>
+  <li>A new hook named <kbd>admin_editusers_action</kbd> has been added to let
+    extensions alter the behavior of <kbd>editusers.cgi</kbd>. This lets you add
+    new features to this script very easily.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=730794">[% terms.Bug %] 730794</a>)</li>
+</ul>
+
+<h2 id="v42_req">Minimum Requirements</h2>
+
+<p>Any requirements that are new since 4.0.2 will look like
+  <span class="req_new">this</span>.</p>
+
+<ul>
+  <li><a href="#v42_req_perl">Perl</a></li>
+  <li><a href="#v42_req_mysql">For MySQL Users</a></li>
+  <li><a href="#v42_req_pg">For PostgreSQL Users</a></li>
+  <li><a href="#v42_req_oracle">For Oracle Users</a></li>
+  <li><a href="#v42_req_sqlite">For SQLite Users</a></li>
+  <li><a href="#v42_req_modules">Required Perl Modules</a></li>
+  <li><a href="#v42_req_optional_mod">Optional Perl Modules</a></li>
+  <li><a href="#v42_req_apache">Optional Apache Modules</a></li>
+</ul>
+
+<h3 id="v42_req_perl">Perl</h3>
+
+<p>Perl v5.8.1</p>
+
+<h3 id="v42_req_mysql">For MySQL Users</h3>
+
+<ul>
+  <li>MySQL <span class="req_new">v5.0.15</span></li>
+  <li><strong>perl module:</strong> DBD::mysql <span class="req_new">v4.001</span></li>
+</ul>
+
+<h3 id="v42_req_pg">For PostgreSQL Users</h3>
+
+<ul>
+  <li>PostgreSQL <span class="req_new">v8.03.0000</span></li>
+  <li><strong>perl module:</strong> DBD::Pg v1.45</li>
+</ul>
+
+<h3 id="v42_req_oracle">For Oracle Users</h3>
+
+<ul>
+  <li>Oracle v10.02.0</li>
+  <li><strong>perl module:</strong> DBD::Oracle v1.19</li>
+</ul>
+
+<h3 id="v42_req_sqlite">For SQLite Users</h3>
+
+<ul>
+  <li>SQLite v3.6.22</li>
+  <li><strong>perl module:</strong> DBD::SQLite v1.29</li>
+</ul>
+
+<h3 id="v42_req_modules">Required Perl Modules</h3>
+
+
+<table class="req_table" border="0" cellpadding="0" cellspacing="0">
+  <tbody>
+      <tr>
+        <th>Module</th>
+        <th>Version</th>
+      </tr>
+      <tr>
+        <td>CGI</td>
+        <td>3.51</td>
+      </tr>
+      <tr>
+        <td>Digest::SHA</td>
+        <td>(Any)</td>
+      </tr>
+      <tr>
+        <td>Date::Format</td>
+        <td>2.21</td>
+      </tr>
+      <tr>
+        <td>DateTime</td>
+        <td>0.28</td>
+      </tr>
+      <tr>
+        <td>DateTime::TimeZone</td>
+        <td>0.71</td>
+      </tr>
+      <tr>
+        <td>DBI</td>
+        <td>1.614</td>
+      </tr>
+      <tr>
+        <td>Template</td>
+        <td>2.22</td>
+      </tr>
+      <tr>
+        <td>Email::Send</td>
+        <td>2.00</td>
+      </tr>
+      <tr>
+        <td>Email::MIME</td>
+        <td>1.904</td>
+      </tr>
+      <tr>
+        <td>URI</td>
+        <td class="req_new">1.37</td>
+      </tr>
+      <tr>
+        <td>List::MoreUtils</td>
+        <td>0.22</td>
+      </tr>
+      <tr>
+        <td class="req_new">Math::Random::ISAAC</td>
+        <td class="req_new">1.0.1</td>
+      </tr>
+  </tbody>
+</table>
+
+<h3 id="v42_req_optional_mod">Optional Perl Modules</h3>
+
+<p>The following perl modules, if installed, enable various
+  features of [% terms.Bugzilla %]:</p>
+
+
+<table class="req_table" border="0" cellpadding="0" cellspacing="0">
+  <tbody>
+      <tr>
+        <th>Module</th>
+        <th>Version</th>
+        <th>Enables Feature</th>
+      </tr>
+      <tr>
+        <td>GD</td>
+        <td>1.20</td>
+        <td>Graphical Reports, New Charts, Old Charts</td>
+      </tr>
+      <tr>
+        <td>Chart::Lines</td>
+        <td>2.1</td>
+        <td>New Charts, Old Charts</td>
+      </tr>
+      <tr>
+        <td>Template::Plugin::GD::Image</td>
+        <td>(Any)</td>
+        <td>Graphical Reports</td>
+      </tr>
+      <tr>
+        <td>GD::Text</td>
+        <td>(Any)</td>
+        <td>Graphical Reports</td>
+      </tr>
+      <tr>
+        <td>GD::Graph</td>
+        <td>(Any)</td>
+        <td>Graphical Reports</td>
+      </tr>
+      <tr>
+        <td>MIME::Parser</td>
+        <td>5.406</td>
+        <td>Move [% terms.Bugs %] Between Installations</td>
+      </tr>
+      <tr>
+        <td>LWP::UserAgent</td>
+        <td>(Any)</td>
+        <td>Automatic Update Notifications</td>
+      </tr>
+      <tr>
+        <td>XML::Twig</td>
+        <td>(Any)</td>
+        <td>Move [% terms.Bugs %] Between Installations, Automatic Update Notifications</td>
+      </tr>
+      <tr>
+        <td>PatchReader</td>
+        <td class="req_new">0.9.6</td>
+        <td>Patch Viewer</td>
+      </tr>
+      <tr>
+        <td>Net::LDAP</td>
+        <td>(Any)</td>
+        <td>LDAP Authentication</td>
+      </tr>
+      <tr>
+        <td>Authen::SASL</td>
+        <td>(Any)</td>
+        <td>SMTP Authentication</td>
+      </tr>
+      <tr>
+        <td>Authen::Radius</td>
+        <td>(Any)</td>
+        <td>RADIUS Authentication</td>
+      </tr>
+      <tr>
+        <td>SOAP::Lite</td>
+        <td>0.712</td>
+        <td>XML-RPC Interface</td>
+      </tr>
+      <tr>
+        <td>JSON::RPC</td>
+        <td>(Any)</td>
+        <td>JSON-RPC Interface</td>
+      </tr>
+      <tr>
+        <td>JSON::XS</td>
+        <td>2.0</td>
+        <td>Make JSON-RPC Faster</td>
+      </tr>
+      <tr>
+        <td>Test::Taint</td>
+        <td>(Any)</td>
+        <td>JSON-RPC Interface, XML-RPC Interface</td>
+      </tr>
+      <tr>
+        <td>HTML::Parser</td>
+        <td>3.67</td>
+        <td>More HTML in Product/Group Descriptions</td>
+      </tr>
+      <tr>
+        <td>HTML::Scrubber</td>
+        <td>(Any)</td>
+        <td>More HTML in Product/Group Descriptions</td>
+      </tr>
+      <tr>
+        <td class="req_new">Encode</td>
+        <td class="req_new">2.21</td>
+        <td>Automatic charset detection for text attachments</td>
+      </tr>
+      <tr>
+        <td class="req_new">Encode::Detect</td>
+        <td class="req_new">(Any)</td>
+        <td>Automatic charset detection for text attachments</td>
+      </tr>
+      <tr>
+        <td>Email::MIME::Attachment::Stripper</td>
+        <td>(Any)</td>
+        <td>Inbound Email</td>
+      </tr>
+      <tr>
+        <td>Email::Reply</td>
+        <td>(Any)</td>
+        <td>Inbound Email</td>
+      </tr>
+      <tr>
+        <td>TheSchwartz</td>
+        <td>(Any)</td>
+        <td>Mail Queueing</td>
+      </tr>
+      <tr>
+        <td>Daemon::Generic</td>
+        <td>(Any)</td>
+        <td>Mail Queueing</td>
+      </tr>
+      <tr>
+        <td>mod_perl2</td>
+        <td>1.999022</td>
+        <td>mod_perl</td>
+      </tr>
+      <tr>
+        <td>Apache2::SizeLimit</td>
+        <td class="req_new">0.96</td>
+        <td>mod_perl</td>
+      </tr>
+  </tbody>
+</table>
+
+<h3 id="v42_req_apache">Optional Apache Modules</h3>
+
+<p>If you are using Apache as your webserver, [% terms.Bugzilla %] can
+  take advantage of some Apache features if you have the below Apache
+  modules installed and enabled. Currently,
+  <a href="#v40_feat_js_css_update">certain [% terms.Bugzilla %] features</a>
+  are enabled only if you have all of the following modules installed
+  and enabled:</p>
+
+<ul>
+  <li>mod_headers</li>
+  <li>mod_expires</li>
+  <li>mod_env</li>
+</ul>
+
+<p>On most systems (but not on Windows), <kbd>checksetup.pl</kbd> is able to
+  tell whether or not you have these modules installed, and it will tell
+  you.</p>
+
+
+<h2 id="v42_feat">New Features and Improvements</h2>
+
+<ul>
+  <li><a href="#v42_feat_sqlite">Experimental SQLite Support</a></li>
+  <li><a href="#v42_feat_attach">Creating an Attachment by Pasting Text Into
+    a Text Field</a></li>
+  <li><a href="#v42_feat_email">HTML [% terms.Bug %]mail</a></li>
+  <li><a href="#v42_feat_search">Improved Searching System</a></li>
+  <li><a href="#v42_feat_product">Disabling Old Components, Versions and Milestones</a></li>
+  <li><a href="#v42_feat_custom">Displaying a Custom Field Value Based on Multiple
+    Values of Another Field</a></li>
+  <li><a href="#v42_feat_audit">Auditing of All Changes Within [% terms.Bugzilla %]</a></li>
+  <li><a href="#v42_feat_wai">Accessibility Improvements</a></li>
+  <li><a href="#v42_feat_other">Other Enhancements and Changes</a></li>
+</ul>
+
+<h3 id="v42_feat_sqlite">Experimental SQLite Support</h3>
+
+<p>SQLite is now supported by [% terms.Bugzilla %] and becomes the 4th supported
+  database besides MySQL, PostgreSQL and Oracle. SQLite support must be considered
+  as experimental, at least till the next major release.</p>
+
+<p>Note that use of SQLite is only recommended for small installations. Larger
+  installations should use MySQL, PostgreSQL, or Oracle.</p>
+
+<h3 id="v42_feat_attach">Creating an Attachment by Pasting Text Into a Text Field</h3>
+
+<p>You can now create a new attachment simply by pasting some text into a text
+  field, in addition to the normal upload process for attachments.</p>
+
+<h3 id="v42_feat_email">HTML [% terms.Bug %]mail</h3>
+
+<p>By default, [% terms.bug %]mails (email notifications about changes to
+  [%+ terms.bugs %]) are now sent in an HTML format that is more readable than
+  the old text format. Those who prefer the old text format can still choose it
+  in their Preferences, however.</p>
+
+<h3 id="v42_feat_search">Improved Searching System</h3>
+
+<p>The Custom Search section in the Advanced Search page has been redesigned
+  to work in a more sensible way. Complex queries are easier to build and have
+  more sensible results, as they are built using a more intuitive logic.
+  Some very complicated queries are still impossible to generate, though.
+  Things should improve in future releases.</p>
+
+<h3 id="v42_feat_product">Disabling Old Components, Versions and Milestones</h3>
+
+<p>Older components, versions and milestones can now be disabled. [% terms.Bugs %]
+  already using them are not affected, but these values will no longer be
+  available for new [% terms.bugs %].</p>
+
+<h3 id="v42_feat_custom">Displaying a Custom Field Value Based on Multiple Values
+  of Another Field</h3>
+
+<p>A custom field can now be displayed based on multiple values of another field.
+  (For example, one custom field could now appear in multiple products.)
+  Previously, you could only display a custom field based on a single value of
+  another field.</p>
+
+<h3 id="v42_feat_audit">Auditing of All Changes Within [% terms.Bugzilla %]</h3>
+
+<p>Most changes made through the admin interface are now logged to the database,
+  in the <kbd>audit_log</kbd> table. There is no UI to access this table yet,
+  but developers are free to create their own tools to track changes made into
+  their installation. This is only a first step, and improvements are expected
+  in future releases.</p>
+
+<h3 id="v42_feat_wai">Accessibility Improvements</h3>
+
+<p>A project has started thanks to Francisco Donalisio from IBM to make
+  [%+ terms.Bugzilla %] compliant with the W3C Web Accessibility Initiative
+  standards. A lot more work still needs to be done, but we expect a much
+  better compatibility for the next major release.</p>
+
+<h3 id="v42_feat_other">Other Enhancements and Changes</h3>
+
+<h4>Enhancements for Users</h4>
+
+<ul>
+  <li><strong>[% terms.Bugs %]:</strong> Users without editbugs privileges can
+    no longer remove other users from the CC list of [% terms.bugs %].</li>
+  <li><strong>[% terms.Bugs %]:</strong> Local [% terms.bug %] IDs are now valid
+    in the See Also field. Adding such an ID will also add a reciprocal link in
+    the other [% terms.bug %].</li>
+  <li><strong>[% terms.Bugs %]:</strong> After editing [% terms.abug %] or an
+    attachment, the URL is automatically changed to <kbd>show_bug.cgi</kbd>
+    instead of <kbd>post_bug.cgi</kbd>, <kbd>process_bug.cgi</kbd> or
+    <kbd>attachment.cgi</kbd> so that reloading the page (for instance when
+    restarting the web browser) displays the right page. This feature is supported
+    by Firefox, Chrome and Safari, but not by Internet Explorer 9.</li>
+  <li><strong>[% terms.Bugs %]:</strong> Inactive accounts are no longer
+    displayed in user fields when user-autocompletion is enabled.</li>
+  <li><strong>[% terms.Bugs %]:</strong> User-autocompletion is now much faster
+    on installations with many user accounts.</li>
+  <li><strong>[% terms.Bugs %]:</strong> The See Also field now accepts URLs
+    pointing to MantisBT, Trac, JIRA and the sourceforge.net b[%%]ug trackers.</li>
+  <li><strong>[% terms.Bugs %]:</strong> Displaying [% terms.abug %] with many
+    dependencies is now much faster.</li>
+  <li><strong>Attachments:</strong> The encoding of text files can be automatically
+    detected when uploading them as attachments.</li>
+  <li><strong>Attachments:</strong> Clickjacking could possibly occur in an attachment 
+    Details page if a user attached a specially formatted HTML file. To fix this 
+    potential problem, the Details page always displays the HTML source instead and 
+    users can see rendered page by clicking on View.</li>
+  <li><strong>Flags:</strong> Changing the requestee of a flag no longer changes
+    the requester.</li>
+  <li><strong>Reports:</strong> If JavaScript is enabled in your web browser,
+    tabular reports are now sortable based on any displayed column.</li>
+  <li><strong>Dependency graphs:</strong> The <em>Show every [% terms.bug %] in
+    the system with dependencies</em> option has been removed.</li>
+  <li><strong>Searches:</strong> The columns displayed by default in
+    [%+ terms.bug %]lists have changed. These columns are now displayed by default
+    unless otherwise specified:<br>
+    <kbd>product | component | assignee | [% terms.bug %] status | resolution |
+    [%+ terms.bug %] summary | last change date</kbd><br>
+    This means that the priority, severity and operating system columns are no
+    longer displayed by default.</li>
+  <li><strong>Searches:</strong> [% terms.Bug %]lists will now only display the
+    first 500 [% terms.bugs %] by default. It is still possible to display the
+    whole list, though.</li>
+  <li><strong>Searches:</strong> When using relative dates and times, <kbd>-1w</kbd>
+    is now a synonym for <kbd>-7d</kbd> and means exactly 7 days. Previously,
+    <kbd>-1w</kbd> meant the beginning of the week, which was confusing some users.
+    The same confusion existed for <kbd>-1d</kbd> which was different from
+    <kbd>-24h</kbd>, and for <kbd>-1m</kbd> which was different from <kbd>-30d</kbd>.
+    Now if you really want the beginning of the day, week or month, you must use
+    <kbd>-1ds</kbd>, <kbd>-1ws</kbd>, and <kbd>-1ms</kbd> respectively, where
+    "s" means "start of". This change will affect existing saved searches using
+    relative dates.</li>
+  <li><strong>Searches:</strong> A new <em>Include fulltext when performing quick
+    searches</em> user preference has been added which permits users to include
+    or exclude comments when using quicksearches.</li>
+  <li><strong>Searches:</strong> It is now possible to query for [% terms.bugs %]
+    based on personal tags in the Custom Search section in the Advanced Search
+    page.</li>
+  <li><strong>Email notifications: </strong> The date and time of comments are no
+    longer displayed in the comment header in [% terms.bug%]mails. This information
+    is already available in the email header itself.</li>
+</ul>
+
+<h4>Enhancements for Administrators and Developers</h4>
+
+<ul>
+  <li><strong>Installation:</strong> <kbd>checksetup.pl</kbd> is now much quieter
+    when creating a new database.</li>
+  <li><strong>Security:</strong> [% terms.Bugzilla %] 4.0 is using
+    <kbd>Math::Random::Secure</kbd> to generate cryptographically secure
+    pseudorandom numbers, but it appeared that installing this Perl module from
+    CPAN caused a lot of trouble for some people due to its numerous dependencies.
+    So the RNG code has been rewritten to only depend on <kbd>Math::Random::ISAAC</kbd>,
+    which was already in use in previous versions of [% terms.Bugzilla %].</li>
+  <li><strong>Security:</strong> <kbd>X-Frame-Options = SAMEORIGIN</kbd> is now
+    passed to all page headers (except when viewing attachments, as they can be
+    on a different host) to protect users from framing and subsequent possible
+    clickjacking problems.</li>
+  <li><strong>Configuration:</strong> A new parameter <em>password_complexity</em>
+    has been added (default: no_constraints) which allows admins to force users
+    to use passwords with a higher complexity, such as a combination of uppercase
+    and lowercase letters, numbers and special characters, or a subset of them.</li>
+  <li><strong>Configuration:</strong> A new parameter <em>search_allow_no_criteria</em>
+    has been added (default: on) which allows admins to forbid queries with no
+    criteria. This is particularly useful for large installations with several
+    tens of thousands [% terms.bugs %] where returning all [% terms.bugs %]
+    doesn't make sense and would have a performance impact on the database.</li>
+  <li><strong>Configuration:</strong> A new parameter <em>default_search_limit</em>
+    has been added (default: 500) which limits the number of [% terms.bugs %]
+    displayed by default in a [% terms.bug%]list. The user can ask to see a larger
+    list, though.</li>
+  <li><strong>Configuration:</strong> A new parameter <em>max_search_results</em>
+    has been added (default: 10000) which limits the number of [% terms.bugs %]
+    a user can request at once in a [% terms.bug%]list. This is a hard limit and
+    a user cannot bypass this value.</li>
+  <li><strong>Configuration:</strong> A new parameter <em>ajax_user_autocompletion</em>
+    has been added (default: on) to allow administrators to disable auto-completion
+    when typing characters in user fields. This parameter should only be disabled
+    if your installation is unable to support the load generated by this feature.</li>
+  <li><strong>Configuration:</strong> The <em>config_modify_panels</em> hook now
+    lets you add additional parameters to existing parameters panels.</li>
+  <li><strong>Flags:</strong> Users with local editcomponents privileges can now
+    edit flag types for products they can administer.</li>
+  <li><strong>Quips:</strong> A new system group <em>bz_quip_moderators</em> has
+    been created to moderate quips. Till now, you had to be in the <em>admin</em>
+    group to do that.</li>
+  <li><kbd>importxml.pl</kbd> now inserts each comment separately into the imported
+    [%+ terms.bug %] instead of concatenating them all into a single comment.</li>
+  <li><kbd>email_in.pl</kbd> now ignores auto-submitted incoming emails (for
+    instance, all these "out of office" emails).</li>
+  <li>New code hooks: email_in_before_parse, email_in_after_parse,
+    install_filesystem, install_update_db_fielddefs, job_map, object_end_of_create,
+    quicksearch_map, user_preferences.</li>
+</ul>
+
+<h4>WebService Changes</h4>
+
+<ul>
+  <li>Two new methods have been added: <kbd>Product.create</kbd> and
+    <kbd>Group.create</kbd>.</li>
+  <li><kbd>B[%%]ug.update</kbd> no longer throws an error when passing an empty
+    string to <kbd>see_also</kbd>. It now simply ignores this empty value.</li>
+  <li><kbd>Product.get</kbd> now also returns data about the classification it
+    belongs to as well as its components, milestones and versions. It also
+    returns the <kbd>default_milestone</kbd> and <kbd>has_unconfirmed</kbd>
+    attributes.</li>
+  <li>In <kbd>B[%%]ug.fields</kbd>, the <kbd>sortkey</kbd> attribute used in
+    <kbd>values</kbd> has been renamed to <kbd>sort_key</kbd>.</li>
+  <li>In <kbd>B[%%]ug.attachments</kbd> and <kbd>B[%%]ug.add_attachment</kbd>,
+    the <kbd>is_url</kbd> attribute no longer exists.</li>
+</ul>
+
+
+<h2 id="v42_issues">Outstanding Issues</h2>
+
+<ul>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=89822">
+    [%- terms.Bug %] 89822</a>: When changing multiple [% terms.bugs %] at
+    the same time, there is no "mid-air collision" protection.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=276230">
+    [%- terms.Bug %] 276230</a>: The support for restricting access to
+    particular Categories of New Charts is not complete. You should treat the
+    <em>chartgroup</em> parameter as the only access mechanism available.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=584742">
+    [%- terms.Bug %] 584742</a>: When viewing [% terms.abug %], WebKit-based
+    browsers can automatically reset a field's selected value when the field
+    has disabled values.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=780053">
+    [%- terms.Bug %] 780053</a>: Oracle crashes when listing keywords, tags
+    or flags in buglists.</li>
+</ul>
+
+
+<h2 id="v42_code_changes">Code Changes Which May Affect Customizations and Extensions</h2>
+
+<ul>
+  <li>The <kbd>email/newchangedmail.txt.tmpl</kbd> template is now fully templatized,
+    meaning that the diff table displaying changes in [% terms.bug %] fields is
+    now generated in the template itself. This means [% terms.bug %]mails are now
+    fully localizable.</li>
+  <li>The bugmail_recipients hook has been modified to pass <kbd>diffs</kbd> with
+    changes made to the [% terms.bug %] as well as <kbd>users</kbd> including
+    recipients of the email notification.</li>
+  <li>YUI has been upgraded to 2.9.0.</li>
+  <li>Due to the major code refactor of <kbd>B[%%]ugzilla/Search.pm</kbd>, any
+    customization made against this file will probably need to be rewritten.</li>
+  <li>The [% terms.Bugzilla %]-specific <kbd>url_quote</kbd> filter used in templates
+    has been removed and replaced by the <kbd>uri</kbd> filter from Template::Toolkit
+    as they are now similar.</li>
+  <li><kbd>long_list.cgi</kbd>, <kbd>showattachment.cgi</kbd> and <kbd>xml.cgi</kbd>
+    have been removed from the codebase. As <a href="#v40_code_changes">announced</a>
+    in the release notes of [% terms.Bugzilla %] 4.0, these scripts were deprecated
+    since [% terms.Bugzilla %] 2.19.</li>
+  <li><kbd>sidebar.cgi</kbd> has been removed, because Gecko-based browsers no
+    longer support remote XUL, and its popularity is very low.</li>
+  <li><kbd>contrib/yp_nomail.sh</kbd> has been removed. This script is no longer
+    useful since [% terms.Bugzilla %] 3.0.</li>
+  <li><kbd>contrib/bugzilla_ldapsync.rb</kbd> has been removed. This script didn't
+    work for a long time.</li>
+</ul>
+
+
+<h1 id="v42_previous">[% terms.Bugzilla %] 4.0 Release Notes</h1>
+
+<ul class="bz_toc">
+  <li><a href="#v40_introduction">Introduction</a></li>
+  <li><a href="#v40_point">Updates in this 4.0.x Release</a></li>
+  <li><a href="#v40_req">Minimum Requirements</a></li>
+  <li><a href="#v40_feat">New Features and Improvements</a></li>
+  <li><a href="#v40_issues">Outstanding Issues</a></li>
+  <li><a href="#v40_upgrading">Notes On Upgrading From a Previous Version</a></li>
+  <li><a href="#v40_code_changes">Code Changes Which May Affect 
+    Customizations and Extensions</a></li>
+  <li><a href="#v40_previous">Release Notes for Previous Versions</a></li>
+</ul>
+
+<h2 id="v40_introduction">Introduction</h2>
+
+<p>This is [% terms.Bugzilla %] 4.0! Since 3.6 (our previous major
+  release) we've come a long way, and we've come even further compared to
+  3.0 in 2007! Since [% terms.Bugzilla %] 3.0, almost every major user
+  interface in [% terms.Bugzilla %] has been redesigned, the WebServices have
+  evolved enormously, there's a great new Extensions system, and there
+  are hundreds of other new features. With the major redesigns that come
+  particularly in this release compared to 3.6, we felt that it was time to
+  call this release 4.0.</p>
+
+<p>It's not just major WebService and UI enhancements that are new in
+  [%+ terms.Bugzilla %] 4.0&mdash;there are many other exciting new features,
+  including automatic duplicate detection, enhanced custom field
+  functionality, autocomplete for users, search improvements, and much
+  more. Overall, 4.0 is far and away the best version of [% terms.Bugzilla %]
+  we've ever released.</p>
+
+<p>If you're upgrading, make sure to read <a href="#v40_upgrading">Notes
+  On Upgrading From a Previous Version</a>. If you are upgrading from a release
+  before 3.6, make sure to read the release notes for all the 
+  <a href="#v40_previous">previous versions</a> in between your version
+  and this one, <strong>particularly the Upgrading section of each
+  version's release notes</strong>.</p>
+
+<p>We would like to thank
+  <a href="http://www.itasoftware.com/">ITA Software</a>,
+  the <a href="http://www.ibm.com/linux/ltc/">IBM Linux Technology Center</a>,
+  and <a href="http://www.redhat.com/">Red Hat</a> for funding the development
+  of certain features and improvements in this release of
+  [%+ terms.Bugzilla %].</p>
+
+<h2 id="v40_point">Updates in this 4.0.x Release</h2>
+
+<h3>4.0.2</h3>
+
+<p>This release fixes several security issues. See the
+  <a href="http://www.bugzilla.org/security/3.4.11/">Security Advisory</a>
+  for details.</p>
+
+<p>In addition, the following important fixes/changes have been made in this
+  release:</p>
+
+<ul>
+  <li>The <kbd>B[% %]ug.create</kbd> WebService method now throws an error if you
+    pass a group name which doesn't exist. In [% terms.Bugzilla %] 4.0 and 4.0.1,
+    this group name was silently ignored, leaving your [% terms.bug %] unsecure
+    if no other group applied.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=653341">[% terms.Bug %] 653341</a>)</li>
+  <li>Moving several [% terms.bugs %] at once into another product displayed the
+    same confirmation page again and again, and changes were never committed
+    (regressed in 4.0).
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=663208">[% terms.Bug %] 663208</a>)</li>
+  <li>Marking [% terms.abug %] as a duplicate now works in Internet Explorer 9.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=656769">[% terms.Bug %] 656769</a>)</li>
+  <li><kbd>importxml.pl</kbd> no longer crashes when importing keywords (regressed
+    in 4.0).
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=657707">[% terms.Bug %] 657707</a>)</li>
+  <li>Data entered while reporting a new [% terms.bug %] could be lost if you had
+    to click the "Back" button of your web browser.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=652427">[% terms.Bug %] 652427</a>)</li>
+  <li>WebServices methods will return undefined [% terms.bug %] fields as undefined
+    instead of as an empty string. This change is consistent with how
+    [%+ terms.Bugzilla %] 4.2 behaves.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=657561">[% terms.Bug %] 657561</a>)</li>
+  <li>The XML-RPC interface now works with SOAP::Lite 0.711 and 0.712 under mod_perl.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=600810">[% terms.Bug %] 600810</a>)</li>
+  <li>LWP 6.00 and newer require Perl 5.8.8 and above. When installing this module
+    using <kbd>install-module.pl</kbd> on a Perl installation older than 5.8.8,
+    LWP 5.837 will be installed instead.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=655912">[% terms.Bug %] 655912</a>)</li>
+  <li>Viewing [% terms.abug %] report should be significantly faster when your
+    installation has many custom fields.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=634812">[% terms.Bug %] 634812</a>)</li>
+</ul>
+
+<h3>4.0.1</h3>
+
+<ul>
+  <li>During installation, the CPAN module Math::Random::Secure would
+    sometimes fail to install properly and give an error about
+    <kbd>Math::Random::Secure::irand</kbd>. Now, when using
+    <kbd>install-module.pl</kbd> to install Math::Random::Secure, this
+    will no longer happen. If you are currently experiencing this b[% %]ug
+    and it prevented you from installing 4.0, remove Math::Random::Secure
+    from your <kbd>lib/</kbd> directory, like:
+    <p><kbd>rm -rf lib/Math/Random/Secure*</kbd></p>
+    <p>(<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=646578">[% terms.Bug %] 646578</a>)</p></li>
+  <li>The "Remember values as bookmarkable template" button on the
+    [%+ terms.bug %] entry page will now work even when some required fields
+    are empty. 
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=640719">[% terms.Bug %] 640719</a>)</li>
+  <li>Email notifications about dependencies and flags had the wrong
+    timestamp.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=643910">[% terms.Bug %] 643910</a>
+    and  (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=652165">[% terms.Bug %] 652165</a>)</li>
+  <li>You can now select "UTC" as a valid timezone in General Preferences.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=646209">[% terms.Bug %] 646209</a>)</li>
+  <li>Automatic duplicate detection now works on PostgreSQL (although
+    it is not as high-quality as on other DB platforms). 
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=634144">[% terms.Bug %] 634144</a>)</li>
+   <li>Autcomplete for users now works even if you are using the
+     "emailsuffix" option.
+     (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=641519">[% terms.Bug %] 641519</a>)</li>
+   <li>Javascript errors during series creation in New Charts have been
+     fixed.
+     (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=644285">[% terms.Bug %] 644285</a>)</li>
+    <li>The "Show Votes" page now works, for installations using the Voting
+      extension.
+      (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=652381">[% terms.Bug %] 652381</a>)</li> 
+</ul>
+
+<h2 id="v40_req">Minimum Requirements</h2>
+
+<p>Any requirements that are new since 3.6.3 will look like
+  <span class="req_new">this</span>.</p>
+
+<ul>
+  <li><a href="#v40_req_perl">Perl</a></li>
+  <li><a href="#v40_req_mysql">For MySQL Users</a></li>
+  <li><a href="#v40_req_pg">For PostgreSQL Users</a></li>
+  <li><a href="#v40_req_oracle">For Oracle Users</a></li>
+  <li><a href="#v40_req_modules">Required Perl Modules</a></li>
+  <li><a href="#v40_req_optional_mod">Optional Perl Modules</a></li>
+  <li><a href="#v40_req_apache">Optional Apache Modules</a></li>
+</ul>
+
+<h3 id="v40_req_perl">Perl</h3>
+
+<p>Perl v5.8.1</p>
+<h3 id="v40_req_mysql">For MySQL Users</h3>
+
+  <ul>
+    <li>MySQL v4.1.2</li>
+    <li><strong>perl module:</strong> DBD::mysql v4.00</li>
+  </ul>
+
+<h3 id="v40_req_pg">For PostgreSQL Users</h3>
+
+  <ul>
+    <li>PostgreSQL v8.00.0000</li>
+    <li><strong>perl module:</strong> DBD::Pg v1.45</li>
+  </ul>
+
+<h3 id="v40_req_oracle">For Oracle Users</h3>
+
+  <ul>
+    <li>Oracle v10.02.0</li>
+    <li><strong>perl module:</strong> DBD::Oracle v1.19</li>
+  </ul>
+
+<h3 id="v40_req_modules">Required Perl Modules</h3>
+
+  <table cellspacing="0" cellpadding="0" border="0" class="req_table">
+    <tbody>
+      <tr>
+        <th>Module</th><th>Version</th>
+      </tr>
+      <tr>
+        <td>CGI</td>
+        <td class="req_new">3.51</td>
+      </tr>
+      <tr>
+        <td>Digest::SHA</td>
+        <td>(Any)</td>
+      </tr>
+      <tr>
+        <td>Date::Format</td>
+        <td>2.21</td>
+      </tr>
+      <tr>
+        <td>DateTime</td>
+        <td>0.28</td>
+      </tr>
+      <tr>
+        <td>DateTime::TimeZone</td>
+        <td>0.71</td>
+      </tr>
+      <tr>
+        <td>DBI</td>
+        <td>1.41</td>
+      </tr>
+      <tr>
+        <td>Template</td>
+        <td>2.22</td>
+      </tr>
+      <tr>
+        <td>Email::Send</td>
+        <td>2.00</td>
+      </tr>
+
+      <tr>
+        <td>Email::MIME</td>
+        <td class="req_new">1.904</td>
+      </tr>
+      <tr>
+        <td>URI</td>
+        <td>(Any)</td>
+      </tr>
+      <tr>
+        <td class="req_new">List::MoreUtils</td>
+        <td class="req_new">0.22</td>
+      </tr>
+    </tbody>
+  </table>
+
+<h3 id="v40_req_optional_mod">Optional Perl Modules</h3>
+
+<p>The following perl modules, if installed, enable various
+  features of [% terms.Bugzilla %]:</p>
+
+  <table cellspacing="0" cellpadding="0" border="0" class="req_table">
+    <tbody>
+      <tr>
+        <th>Module</th><th>Version</th><th>Enables Feature</th>
+      </tr>
+      <tr>
+        <td>GD</td>
+        <td>1.20</td>
+        <td>Graphical Reports, New Charts, Old Charts</td>
+      </tr>
+      <tr>
+        <td>Chart::Lines</td>
+        <td>2.1</td>
+        <td>New Charts, Old Charts</td>
+      </tr>
+      <tr>
+        <td>Template::Plugin::GD::Image</td>
+        <td>(Any)</td>
+        <td>Graphical Reports</td>
+      </tr>
+      <tr>
+        <td>GD::Text</td>
+        <td>(Any)</td>
+        <td>Graphical Reports</td>
+      </tr>
+      <tr>
+        <td>GD::Graph</td>
+        <td>(Any)</td>
+        <td>Graphical Reports</td>
+      </tr>
+      <tr>
+        <td>MIME::Parser</td>
+        <td>5.406</td>
+        <td>Move [% terms.Bugs %] Between Installations</td>
+      </tr>
+      <tr>
+        <td>LWP::UserAgent</td>
+        <td>(Any)</td>
+        <td>Automatic Update Notifications</td>
+      </tr>
+      <tr>
+        <td>XML::Twig</td>
+        <td>(Any)</td>
+        <td>Move [% terms.Bugs %] Between Installations, Automatic Update
+          Notifications</td>
+      </tr>
+      <tr>
+        <td>PatchReader</td>
+        <td>0.9.4</td>
+        <td>Patch Viewer</td>
+      </tr>
+      <tr>
+        <td>Net::LDAP</td>
+        <td>(Any)</td>
+        <td>LDAP Authentication</td>
+      </tr>
+      <tr>
+        <td>Authen::SASL</td>
+        <td>(Any)</td>
+        <td>SMTP Authentication</td>
+      </tr>
+      <tr>
+        <td>Authen::Radius</td>
+        <td>(Any)</td>
+        <td>RADIUS Authentication</td>
+      </tr>
+      <tr>
+        <td>SOAP::Lite</td>
+        <td class="req_new">0.712</td>
+        <td>XML-RPC Interface</td>
+      </tr>
+      <tr>
+        <td>JSON::RPC</td>
+        <td>(Any)</td>
+        <td>JSON-RPC Interface</td>
+      </tr>
+      <tr>
+        <td class="req_new">JSON::XS</td>
+        <td class="req_new">2.0</td>
+        <td>Make JSON-RPC Faster</td>
+      </tr>
+      <tr>
+        <td>Test::Taint</td>
+        <td>(Any)</td>
+        <td>JSON-RPC Interface, XML-RPC Interface</td>
+      </tr>
+      <tr>
+        <td>HTML::Parser</td>
+        <td>3.40</td>
+        <td>More HTML in Product/Group Descriptions</td>
+      </tr>
+      <tr>
+        <td>HTML::Scrubber</td>
+        <td>(Any)</td>
+        <td>More HTML in Product/Group Descriptions</td>
+      </tr>
+      <tr>
+        <td>Email::MIME::Attachment::Stripper</td>
+        <td>(Any)</td>
+        <td>Inbound Email</td>
+      </tr>
+      <tr>
+        <td>Email::Reply</td>
+        <td>(Any)</td>
+        <td>Inbound Email</td>
+      </tr>
+      <tr>
+        <td>TheSchwartz</td>
+        <td>(Any)</td>
+        <td>Mail Queueing</td>
+      </tr>
+      <tr>
+        <td>Daemon::Generic</td>
+        <td>(Any)</td>
+        <td>Mail Queueing</td>
+      </tr>
+      <tr>
+        <td>mod_perl2</td>
+        <td>1.999022</td>
+        <td>mod_perl</td>
+      </tr>
+      <tr>
+        <td>Apache2::SizeLimit</td>
+        <td class="req_new">0.93</td>
+        <td>mod_perl</td>
+      </tr>
+      <tr>
+        <td class="req_new">Math::Random::Secure</td>
+        <td class="req_new">0.05</td>
+        <td>Improve cookie and token security</td>
+      </tr>
+    </tbody>
+  </table>
+
+<h3 id="v40_req_apache">Optional Apache Modules</h3>
+
+<p>If you are using Apache as your webserver, [% terms.Bugzilla %] can
+  now take advantage of some Apache features if you have the below Apache
+  modules installed and enabled. Currently,
+  <a href="#v40_feat_js_css_update">certain [% terms.Bugzilla %] features</a>
+  are enabled only if you have all of the following modules installed
+  and enabled:</p>
+
+<ul>
+  <li>mod_headers</li>
+  <li>mod_expires</li>
+  <li>mod_env</li>
+</ul>
+
+<p>On most systems (but not on Windows), <kbd>checksetup.pl</kbd> is able to
+  tell whether or not you have these modules installed, and it will tell
+  you.</p>
+
+<h2 id="v40_feat">New Features and Improvements</h2>
+
+<ul>
+  <li><a href="#v40_feat_dup">Automatic Duplicate Detection When Filing
+    [%+ terms.Bugs %]</a></li>
+  <li><a href="#v40_feat_search_ui">New Advanced Search UI</a></li>
+  <li><a href="#v40_feat_attach_ui">New Attachment Details UI</a></li>
+  <li><a href="#v40_feat_autocomplete">Autocomplete for Users and
+    Keywords</a></li>
+  <li><a href="#v40_feat_ui">General Usability Improvements</a></li>
+  <li><a href="#v40_feat_workflow">New Default Status Workflow</a></li>
+  <li><a href="#v40_feat_lists">"Last Search" Now Remembers Multiple
+    Searches</a></li>
+  <li><a href="#v40_feat_jsonp">Cross-Domain WebServices with JSONP</a></li>
+  <li><a href="#v40_feat_ws">Major WebService Enhancements</a></li>
+  <li><a href="#v40_feat_mandatory">Mandatory Custom Fields</a></li>
+  <li><a href="#v40_feat_vot_ext">Voting Is Now An Extension</a></li>
+  <li><a href="#v40_feat_js_css_update">Users Get New CSS and Javascript
+    Automatically</a></li>
+  <li><a href="#v40_feat_hooks">Many New Hooks</a></li>
+  <li><a href="#v40_feat_apache_config">New Apache Configuration</a></li>
+  <li><a href="#v40_feat_other">Other Enhancements and Changes</a></li>
+</ul>
+
+<h3 id="v40_feat_dup">Automatic Duplicate Detection When Filing
+  [%+ terms.Bugs %]</h3>
+
+<p>When filing [% terms.abug %], as soon as you start typing in the summary
+  field, [% terms.Bugzilla %] will suggest possible duplicates of the
+  [%+ terms.bug %] you are filing.</p>
+
+<p>In order for this feature to work, all pre-requisites for JSON-RPC
+  support must be installed on your [% terms.Bugzilla %]. It will be
+  much faster on installations that run under mod_perl than it will
+  be on other installations.</p>
+
+<h3 id="v40_feat_search_ui">New Advanced Search UI</h3>
+
+<p>Thanks to the UI work of <a href="http://guy-pyrzak.blogspot.com/">Guy
+  Pyrzak</a>, the Advanced Search UI has been completely redesigned.
+  It is now much simpler, and far more approachable for new users, while
+  still retaining all of the features that power users are used to.</p>
+
+<h3 id="v40_feat_attach_ui">New Attachment Details UI</h3>
+
+<p>The UI used for editing attachment details has been completely
+  redesigned, allowing for a normally-size comment box to be used
+  when commenting on attachments, and allowing nearly the entire screen
+  width to be used when doing code reviews or editing an attachment as
+  a comment.</p>
+
+<p>Thanks to <a href="http://guy-pyrzak.blogspot.com/">Guy Pyrzak</a> for
+  his excellent work on this UI redesign.</p>
+
+<h3 id="v40_feat_autocomplete">Autocomplete for Users and Keywords</h3>
+
+<p>Once you type at least three characters in any field that can contain a user
+  (including the [% field_descs.cc FILTER html %],
+  [%+ field_descs.qa_contact FILTER html %], or
+  [%+ field_descs.assigned_to FILTER html %] fields), a list will appear
+  containing all of the users whose real names or usernames match what you are
+  typing. Your [% terms.Bugzilla %] must have all of the optional Perl
+  modules required for JSON-RPC support installed, though, in order for
+  this feature to work. Also, this feature will be <strong>much</strong>
+  faster on installations that run under mod_perl than it will be on
+  other installations.</p>
+
+<p>There is also a similar autocomplete for the Keywords field. The
+  Keywords autocomplete does not require JSON-RPC.</p>
+
+<h3 id="v40_feat_ui">General Usability Improvements</h3>
+
+<p>In addition to the enhancements listed above, there have been
+  <strong>many</strong> improvements made across the [% terms.Bugzilla %]
+  user interface. For a list of specific enhancements that were significant,
+  see the <a href="#v40_feat_other">Other Enhancements and Changes</a>
+  section.</p>
+
+<h3 id="v40_feat_workflow">New Default Status Workflow</h3>
+
+<p>For new installations of [% terms.Bugzilla %], the default set of
+  statuses will now be:</p>
+
+<ul>
+  <li>UNCONFIRMED</li>
+  <li>CONFIRMED</li>
+  <li>IN_PROGRESS</li>
+  <li>RESOLVED</li>
+  <li>VERIFIED</li>
+</ul>
+
+<p>And the UNCONFIRMED status will be enabled by default in all products.</p>
+
+<p>On upgrade, existing installations will not be affected--you will retain
+  your existing status workflow. However, we strongly recommend that you
+  update your existing workflow to the new one, using a special tool
+  we've included, <kbd>contrib/convert-workflow.pl</kbd>, which you
+  can run after you use <kbd>checksetup.pl</kbd> to upgrade. The
+  <kbd>whineatnews.pl</kbd> and <kbd>bugzilla-submit</kbd> scripts
+  will probably not work properly if you continue to use the old workflow
+  (though most other parts of [% terms.Bugzilla %] will still function
+  normally).</p>
+
+<p>For more information about the workflow and our rationale for changing
+  it, see the
+  <a href="http://bugzillaupdate.wordpress.com/2010/07/06/bugzilla-4-0-has-a-new-default-status-workflow/">blog
+  post about it</a> and the
+  <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=486292">[% terms.bug %]
+  where the change was made</a>.</p>
+
+<h3 id="v40_feat_lists">"Last Search" Now Remembers Multiple Searches</h3>
+
+<p>At the top of every [% terms.bug %] in [% terms.Bugzilla %], there are
+  links that look like: "First", "Last", "Prev", "Next", and
+  "Show last search results". In earlier versions of [% terms.Bugzilla %],
+  if you did two separate searches in separate windows, these links would
+  only work for the <em>last</em> search you did. Now, [% terms.Bugzilla %]
+  will "remember" which search result you came from and give you the right
+  "last search results" or "next [% terms.bug %]" from <em>that</em> list,
+  instead of always using your most recent search.</p>
+
+<p>There are still some situations where [% terms.Bugzilla %] will have to
+  "guess" which search you are trying to navigate through, but it does its
+  best to get it right.</p>
+
+<h3 id="v40_feat_jsonp">Cross-Domain WebServices with JSONP</h3>
+
+<p>[% terms.Bugzilla %] now supports making WebService calls from
+  another domain, inside of a web browser, thanks to support for
+  <a href="http://bob.pythonmac.org/archives/2005/12/05/remote-json-jsonp/">JSONP</a>.
+  This will allow for web "mash-ups" to use [% terms.Bugzilla %] data.
+  When using JSONP, you may only call functions that <em>get</em> data, 
+  you may not call functions that <em>change</em> data.</p>
+
+<p>For more details, see the
+  <a href="[% docs_urlbase FILTER html %]api/Bugzilla/WebService/Server/JSONRPC.html#JSONP">JSONP
+  section</a> of the JSON-RPC WebService documentation.</p>
+
+<h3 id="v40_feat_ws">Major WebService Enhancements</h3>
+
+<p>The WebService has been expanded considerably. The WebService should now be
+  able to do everything with [% terms.bugs %] that you can do via the
+  web interface, including updating [% terms.bugs %], adding attachments,
+  and getting attachment data. For specifics, see the
+  <a href="#v40_feat_ws_changes">WebService Changes</a> section of these
+  release notes.</p>
+
+<h3 id="v40_feat_mandatory">Mandatory Custom Fields</h3>
+
+<p>You can now specify that certain custom fields are "mandatory",
+  meaning that they must have a value when [% terms.abug %] is filed,
+  and they can never be empty after that.</p>
+
+<h3 id="v40_feat_vot_ext">Voting Is Now An Extension</h3>
+
+<p>All of the code for voting in [% terms.Bugzilla %] has been moved
+  into an extension, called "Voting", in the <kbd>extensions/Voting/</kbd>
+  directory. To enable it, you must remove the <kbd>disabled</kbd> file
+  from that directory, and run <kbd>checksetup.pl</kbd>.</p>
+
+<p>In a future version of [% terms.Bugzilla %], the Voting extension will
+  be moved outside of the [% terms.Bugzilla %] core code, so we are looking
+  for somebody who has an interest in the Voting system and would like to
+  maintain it as a separate extension. There are many enhancement requests
+  that have been made against the Voting system, and the best way for those
+  to get addressed is for somebody to step up and offer to maintain the
+  system outside of [% terms.Bugzilla %]'s core code.</p>
+
+<h3 id="v40_feat_js_css_update">Users Get New CSS and Javascript
+  Automatically</h3>
+  
+<p>In past versions of [% terms.Bugzilla %], if you changed
+  [%+ terms.Bugzilla %]'s CSS or Javascript files, then every user of
+  [%+ terms.Bugzilla %] would have to clear their cache in order to get
+  the updated files. Now, if you are using Apache as your webserver and
+  you have the <a href="#v40_req_apache">optional Apache modules</a>
+  installed and enabled, users will automatically get every new version of
+  [%+ terms.Bugzilla %]'s Javascript and CSS without having to clear
+  their caches.</p>
+
+<p>This feature also gives a slight performance speedup to
+  [%+ terms.Bugzilla %] in some cases, and so we recommend that all
+  administrators install and enable the optional Apache modules if possible.</p>
+
+<h3 id="v40_feat_hooks">Many New Hooks</h3>
+
+<p>Many new code hooks have been added for use by Extensions,
+  in [% terms.Bugzilla %] 4.0. Now Extensions can access and modify
+  nearly every part of [% terms.Bugzilla %].</p>
+
+<h3 id="v40_feat_apache_config">New Apache Configuration</h3>
+
+<p>If you run [% terms.Bugzilla %] under Apache (as most people do),
+  you most likely require a <strong>new Apache configuration</strong> 
+  for this version of [% terms.Bugzilla %]. See the 
+  <a href="#v40_upgrading">Notes On Upgrading From a Previous Version</a>
+  section for details.</p>
+
+<h3 id="v40_feat_other">Other Enhancements and Changes</h3>
+
+<h4>Enhancements for Users</h4>
+
+<ul>
+  <li>Now, everywhere in [% terms.Bugzilla %] where you can enter a date,
+    there is a Calendar widget where you can select the date on a
+    calendar.</li>
+  <li>The big icons on the front page have been replaced with much nicer
+    icons, thanks to Jon Pink of <a href="http://www.jpink.co.uk/">J.&nbsp;Pink&nbsp;Design</a>!</li>
+  <li><strong>[% terms.Bugs %]:</strong> When filing [% terms.bugs %],
+    you will now be warned if you forgot to fill in any mandatory fields,
+    <em>before</em> the page is submitted.</li>
+  <li><strong>[% terms.Bugs %]:</strong> When filing [% terms.abug %],
+    you can hover your mouse over any of the field labels on the page
+    to get a brief description of what that field is and what its purpose
+    is.</li>
+  <li><strong>[% terms.Bugs %]:</strong> When adding Hours Worked to [% terms.abug %],
+    you are no longer required to comment.</li>
+  <li><strong>[% terms.Bugs %]:</strong> There is now a user preference
+    for whether the comment box appears above or below the existing
+    comments.</li>
+  <li><strong>[% terms.Bugs %]:</strong> [% terms.Bugzilla %] will now
+    send an email for every comment that you mark or un-mark as being
+    private. (Previous versions of [% terms.Bugzilla %] did not send emails
+    to users about this change.) The state of comments being made private
+    is also now stored in [% terms.abug %]'s history.</li>
+  <li><strong>[% terms.Bugs %]:</strong> The box to "Add [% terms.Bug %] URLs"
+    in the See Also field is now hidden behind an "(add)" link that you
+    have to click to see the box.</li>
+  
+  <li><strong>Searches:</strong> You can now properly search for field values
+    that have commas in their name, when using the Advanced Search form.</li>
+  <li><strong>Searches:</strong> The "URL" field can now be shown as a column
+    in search results.</li>
+  <li><strong>Searches:</strong> When viewing a search result, you can now
+    click on the Summary of the [% terms.bug %] in order to go to the
+    [%+ terms.bug %]-view page, in addition to being able to click on the
+    [%+ terms.bug %] ID.</li>
+  <li><strong>Searches:</strong> When doing a search using the "quicksearch"
+    box in the header or footer, the box will still contain what you searched
+    for when viewing the search results page.</li>
+  <li><strong>Searches:</strong> Multi-select custom fields can now be
+    shown as columns in the search results.</li>
+  <li><strong>Searches:</strong> When using the Boolean Charts (now called
+    "Custom Search"), if you specify both a criterion for an attachment
+    and a criteron for a flag, then only [% terms.bugs %] that have
+    attachments with that flag will be found.</li>
+  <li><strong>Searches:</strong> If you hover your mouse over the field labels
+    on the Advanced Search page, you will get a description of what that
+    field is.</li>
+  <li><strong>Searches:</strong> When searching via a saved search, if you
+    accidentally click on "Forget Search", there is a link to undo it.</li>
+  <li><strong>Searches:</strong> When using the Boolean Charts (now called
+    "Custom Search"), you can search for values "greater than or equal to"
+    or "less than or equal to" some value.</li>
+  
+  <li><strong>Flags:</strong> If you hover your mouse over the name of
+    a flag setter when viewing [% terms.abug %], you can see that
+    flag setter's full name and complete username.</li>
+  <li><strong>Flags:</strong> When setting a flag on [% terms.abug %],
+    the box for entering a requestee does not appear until you set the flag
+    to "?", now.</li>
+  <li><strong>Flags:</strong> On the "My Requests" page, [% terms.bugs %]
+    that are restricted to certain groups now properly have the "padlock"
+    icon shown next to them to indicate that they may contain confidential
+    information.</li>
+  
+  <li>When using the Reports interface, you can now choose many more fields
+    as the X, Y, or Z axis of a report, including custom fields.</li>
+  <li>[% terms.Bugzilla %] now prevents
+    Internet Explorer 8 and later from attempting to render
+    <kbd>text/plain</kbd> attachments as HTML.</li>
+  <li>If you receive a Whine mail that is empty, there will now be a brief
+    message explaining that your search found no results.</li>
+  <li>The <a href="page.cgi?id=fields.html">Field Help Page</a> now
+    contains a description of every single field that can be on
+    [%+ terms.abug %] in [% terms.Bugzilla %].</li>
+</ul>
+
+<h4>Enhancements for Administrators and Developers</h4>
+
+<ul>
+  <li>The system for moving [% terms.bugs %] between installations has been
+    moved into an extension called <kbd>OldBugMove</kbd>. This system was used
+    by very few [% terms.Bugzilla %] installations--if you aren't certain
+    whether or not you are using it, you're not using it. To enable the system,
+    you have to remove the file <kbd>extensions/OldBugMove/disabled</kbd>
+    and then run <kbd>checksetup.pl</kbd>. In a future version of [% terms.Bugzilla %],
+    this extension may be moved outside of the core [% terms.Bugzilla %] code,
+    so if you are interested in maintaining it, please let us know.</li>
+  <li><strong>Custom Fields: </strong> "[% terms.Bug %] ID" custom fields can
+    now represent relationships between [% terms.bugs %], similarly to how the
+    [%+ field_descs.blocked FILTER html %] and
+    [%+ field_descs.dependson FILTER html %] fields work now.</li>
+  <li><strong>Custom Fields:</strong> You can now restrict the visibility
+    of custom fields and their values to a specific Component or
+    Classification.</li>
+  <li>The "keyword cache" has been removed. When you edit keywords, you no
+    longer will have to "rebuild the keyword cache" after you are done.</li>
+  <li>Running <kbd>./collectstats.pl --regenerate</kbd> will now take
+    minutes or hours, instead of days.</li>
+  <li>When using <kbd>email_in.pl</kbd>, there are two new switches,
+    <kbd>--default</kbd> and <kbd>--override</kbd>, which allow you to
+    specify certain default values or override specified values for
+    <kbd>@field</kbd> values sent in emails. (This also allows you to specify
+    defaults for everything so that people do not have to specify any field
+    values when filing [% terms.abug %] via email.)</li>
+  <li><strong>Installation:</strong> If you are using a localized version of
+    [%+ terms.Bugzilla %] and your terminal does not understand Unicode,
+    <kbd>checksetup.pl</kbd> will now attempt to output its messages in your
+    terminal's character set.</li>
+  <li><strong>Installation:</strong> [% terms.Bugzilla %] no longer needs empty
+    "placeholder" CSS in the <kbd>skins/custom</kbd> directory and other
+    directories. When you update, <kbd>checksetup.pl</kbd> will remove these.
+    This also significantly reduces the number of HTTP requests required to
+    load a page for the first time in [% terms.Bugzilla %].</li>
+  <li><strong>Installation:</strong> For Windows users, [% terms.Bugzilla %]
+    now supports Strawberry Perl fully.</li>
+  <li><strong>Installation:</strong> Now, whenever <kbd>checksetup.pl</kbd>
+    throws an error, it will be printed in the color red, to make it
+    obvious that something is wrong.</li>
+  <li><strong>Installation:</strong> Some actions of <kbd>checksetup.pl</kbd> were
+    silent, in the past. Now, <kbd>checksetup.pl</kbd> will print a message for
+    almost anything it does.</li>
+  <li><strong>Installation:</strong> The process of adding foreign keys
+    to a table is now much faster. This will particularly improve the speed
+    of upgrading from [% terms.Bugzilla %] 3.4 or earlier.</li>
+  <li>If you are using <kbd>jobqueue.pl</kbd> and email gets heavily delayed
+    for some reason, those emails will now have a Date header reflecting the
+    time they were <em>supposed</em> to be sent, instead of when they actually
+    <em>were</em> sent.</li>
+  <li><kbd>./jobqueue.pl install</kbd> now works on SuSE Linux.</li>
+  <li>[% terms.Bugzilla %] now runs much better in Apache's suexec mode
+    than it used to. As part of this, <kbd>checksetup.pl</kbd> sets
+    much stricter permissions on all the files in [% terms.Bugzilla %]
+    than it used to. In particular, any files that [% terms.Bugzilla %]
+    does not know about will not be readable by the webserver.</li>
+  <li>The <kbd>sendmailnow</kbd> parameter has been removed, as it was
+    not necessary for any modern version of Sendmail or other Mail Transfer
+    Agent.</li>
+  <li>When editing a user via the Users administration panel, you can now
+    see if they are a Default CC on any component.</li>
+  <li>For new installations of [% terms.Bugzilla %], all users will be
+    able to see and use the Whining system by default.</li>
+  <li>When you are using SSL with [% terms.Bugzilla %], you can now
+    turn on the <kbd>strict_transport_security</kbd> parameter to
+    send the
+    <a href="https://developer.mozilla.org/en/Security/HTTP_Strict_Transport_Security">Strict-Transport-Security</a>
+    header with every HTTPS connection, for additional security.</li>
+  <li>New code hooks (see their documentation in
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/Hook.html">Bugzilla::Hook</a>):
+    bug_check_can_change_field, search_operator_field_override,
+    bugmail_relationships, object_columns, object_update_columns,
+    and object_validators. The colchange_columns hook has been removed,
+    as it is no longer necessary (buglist_columns will be used for data
+    about which columns can be on the [% terms.bug %] list).</li>
+  <li>When [% terms.Bugzilla %] throws certain types of errors, it will
+    now include a "traceback" of where exactly the error occurred in the
+    code, to help administrators and developers debug problems.</li>
+  <li>There is now a test, <kbd>xt/search.t</kbd>, that assures that all
+    of the functionality of <kbd>Bugzilla::Search</kbd> is working properly.
+    If you customize the search functionality of [% terms.Bugzilla %],
+    you may wish to run this test to assure that your changes are correct.
+    You can see more information about running this test by doing
+    <kbd>perldoc xt/search.t</kbd> at the command line.</li>
+  <li>[% terms.Bugzilla %] now sends the
+    <a href="https://developer.mozilla.org/en/the_x-frame-options_response_header"><code>X-Frame-Options: SAMEORIGIN</code></a> header
+    with every page request in order to prevent "clickjacking" attacks. Note
+    that this prevents other domains from displaying [% terms.Bugzilla %]
+    in an HTML frame.</li> 
+</ul>
+
+<h4 id="v40_feat_ws_changes">WebService Changes</h4>
+
+<ul>
+  <li>You can now call some JSON-RPC methods using HTTP GET, in addition to
+    using HTTP POST. See the 
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/WebService/Server/JSONRPC.html#Connecting_via_GET">JSON-RPC
+    documentation</a> for details.</li>
+  <li>You can now update existing [% terms.bugs %] using the
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/WebService/Bug.html#update">B[% %]ug.update</a>
+    function.</li>
+  <li>You can now add attachments to [% terms.bugs %] using the
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/WebService/Bug.html#add_attachment">B[% %]ug.add_attachment</a>
+    function.</li>
+  <li>The <kbd>B[% %]ug.get</kbd> function now returns all of [% terms.abug %]'s
+    information other than comments and attachments.</li>
+  <li><kbd>B[% %]ug.get</kbd> no longer returns the <kbd>internals</kbd> hash.</li>
+  <li>The <kbd>B[% %]ug.attachments</kbd> function now also returns attachment
+    data.</li>
+  <li>The following functions now support the <kbd>include_fields</kbd>
+    and <kbd>exclude_fields</kbd> arguments: <kbd>B[% %]ug.get</kbd>,
+    <kbd>B[% %]ug.search</kbd>, and <kbd>B[% %]ug.attachments</kbd>. Also,
+    server-side performance of the WebService is actually increased when
+    using these arguments, now, as [% terms.Bugzilla %] will no longer
+    get data from the database for fields you haven't asked for.</li>
+  <li>You can now mark the initial description of [% terms.abug %] as
+    private when filing [% terms.abug %] via the <kbd>B[% %]ug.create</kbd>
+    function.</li>
+  <li>You can now specify groups to put [% terms.abug %] in, in the
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/WebService/Bug.html#create">B[% %]ug.create</a>
+    function. (This also means that you can specify groups when filing
+    [%+ terms.abug %] via email_in.pl.)</li>
+  <li>The <kbd>User.get</kbd> function now accepts <kbd>groups</kbd>
+    and <kbd>group_ids</kbd> arguments, to limit the returned values to
+    only users in the specified groups.</li>
+  <li>There is a new, undocumented B[% %]ug.possible_duplicates
+    function that helps implement the automatic duplicate detection
+    system. Because this function is not documented, its API may change
+    between releases of [% terms.Bugzilla %].</li>
+  <li>You can no longer search using the <kbd>votes</kbd> argument in
+    <kbd>B[% %]ug.search</kbd>.</li>
+  <li><kbd>B[% %]ug.attachments</kbd> now returns the attachment's description
+    using the name "summary" instead of the name "description", to be
+    consistent with the fact that [% terms.bug %] summaries are called
+    "summary". The value is still <em>also</em> returned as "description",
+    for backwards compatibility, but this backwards compatibility will go
+    away in [% terms.Bugzilla %] 5.0.</li>
+  <li>In the return values of various <kbd>B[% %]ug</kbd> functions, the author
+    of comments, [% terms.bugs %], and attachments is now called "creator",
+    instead of sometimes being called "reporter", "author", or "attacher".
+    The old names are retained for backwards-compatibility, and will stay
+    around until [% terms.Bugzilla %] 5.0.</li>
+</ul>
+
+<h2 id="v40_issues">Outstanding Issues</h2>
+
+<ul>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=423439">
+    [%- terms.Bug %] 423439</a>: Tabs in comments will be converted
+    to four spaces, due to a b<!-- -->ug in Perl as of Perl 5.8.8.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=89822">
+    [%- terms.Bug %] 89822</a>: When changing multiple [% terms.bugs %] at 
+    the same time, there is no "mid-air collision" protection.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=276230">
+    [%- terms.Bug %] 276230</a>: The support for restricting access to 
+    particular Categories of New Charts is not complete. You should treat 
+    the 'chartgroup' Param as the only access mechanism available.<br>
+    However, charts migrated from Old Charts will be restricted to 
+    the groups that are marked MANDATORY for the corresponding Product.
+    There is currently no way to change this restriction, and the 
+    groupings will not be updated if the group configuration
+    for the Product changes.</li>
+</ul>
+
+<h2 id="v40_upgrading">Notes On Upgrading From a Previous Version</h2>
+
+<h3>IMPORTANT: Apache Configuration Change</h3>
+
+<h4>mod_cgi</h4>
+
+<p>If you run [% terms.Bugzilla %] under mod_cgi (this is the most common
+  configuration, involving a &lt;Directory&gt; block in your Apache config
+  file), you will need to update the configuration of Apache for 
+  [%+ terms.Bugzilla %]. In particular, this line in the [% terms.Bugzilla %]
+  <kbd>&lt;Directory&gt;</kbd> block:</p>
+
+<blockquote><code>AllowOverride Limit</code></blockquote>
+
+<p>needs to become:</p>
+
+<blockquote><code>AllowOverride Limit FileInfo Indexes</code></blockquote>
+ 
+<p>For full details on how to configure Apache for [% terms.Bugzilla %],
+  see the
+  <a href="[% docs_urlbase FILTER html %]configuration.html#http-apache">Configuration</a>
+  section of the [% terms.Bugzilla %] Guide.</p>
+
+<h4>mod_perl</h4>
+
+<p>If your [% terms.Bugzilla %] runs under mod_perl, the required Apache
+  configuration is now simpler. The line that used to look like:</p>
+
+<blockquote><code>PerlSwitches -w -T -I/var/www/html/bugzilla 
+    -I/var/www/html/bugzilla/lib</code></blockquote>
+
+<p>Now should be only:</p>
+
+<blockquote><code>PerlSwitches -w -T</code></blockquote>
+
+<p>The <code>PerlConfigRequire</code> line should stay the same, however.</p>
+
+<h3>New .htaccess file</h3>
+
+<p>In previous versions of [% terms.Bugzilla %], there was a file
+  in [% terms.Bugzilla %]'s root directory called ".htaccess" that was
+  generated by <kbd>checksetup.pl</kbd>. This file is now shipped with
+  [%+ terms.Bugzilla %] instead of being generated during installation.</p>
+
+<p>If you update via CVS or bzr, you will get a message that your existing
+  .htaccess file conflicts with the new one. You must
+  <strong>remove your existing .htaccess file</strong> and use the new one
+  instead. Continuing to use your old .htaccess file will cause certain new
+  features of [% terms.Bugzilla %] to not work properly, and may also lead
+  to security issues for your system in the future.</p>
+
+<h2 id="v40_code_changes">Code Changes Which May Affect Customizations and
+  Extensions</h2>
+
+<ul>
+  <li>In Extensions, if you want to serve files to the user via the web,
+    they must now be in a <kbd>web/</kbd> subdirectory of your Extension.
+    (For example, <kbd>extensions/Foo/web/</kbd>). <kbd>checksetup.pl</kbd>
+    sets permissions on extensions much more strictly now, and files in
+    other locations (such as your base <kbd>extensions/Foo/</kbd> directory)
+    will no longer be available to [% terms.Bugzilla %] users via the web
+    under certain configurations.</li>
+  <li>Previous versions of [% terms.Bugzilla %] used to allow putting a
+    single file into the "skins" directory and having that be an entire
+    skin. That is no longer allowed, and on upgrade, <kbd>checksetup.pl</kbd>
+    will convert any such skins into a directory with a single
+    <kbd>global.css</kbd> file in them.</li>
+  <li>When updating [% terms.bugs %], you should now use
+    <code>$bug-&gt;set_all</code> instead of using the individual
+    <kbd>set_</kbd> methods. In particular, <kbd>set_all</kbd> is now the
+    <em>only</em> way to set the product of [% terms.abug %]. See
+    <kbd>process_bug.cgi</kbd> for an example of how <kbd>set_all</kbd>
+    should be used.</li>
+  <li>You should not insert &lt;script&gt; tags and &lt;link&gt; CSS tags
+    into HTML anymore, in Extensions or in your customizations. Instead,
+    you should push new values into the <kbd>style_urls</kbd> or
+    <kbd>javascript_urls</kbd> parameters. If you have to insert manual
+    tags for some reason, be sure to call "FILTER mtime" on the URL. (Search
+    for other uses of "FILTER mtime" in the templates to see how it is
+    used.)</li>
+  <li>When calling <kbd>Bugzilla::BugMail::Send</kbd>, the "changer"
+    argument must now be a <kbd>Bugzilla::User</kbd> object, not just
+    a login name. The "owner" and "qacontact" arguments are still
+    just login names.</li>
+  <li>When creating a new subclass of Bugzilla::Object, you should no
+    longer use <kbd>UPDATE_VALIDATORS</kbd>. Also, in most cases you will
+    no longer need to override <kbd>run_create_validators</kbd>. Instead,
+    there is a new constant called
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/Object.html#VALIDATOR_DEPENDENCIES">VALIDATOR_DEPENDENCIES</a>,
+    that specifies that certain fields have to be validated before other fields.
+    Then, all validators receive each already-validated value in a hash
+    as their fourth argument, so each validator can know the other values
+    that were passed in, while an object is being created. For an example of
+    how to use <kbd>VALIDATOR_DEPENDENCIES</kbd>, see
+    <kbd>Bugzilla/Field.pm</kbd>.</li>
+  <li>In previous versions of [% terms.Bugzilla %], you had to call
+    <code>Bugzilla-&gt;template_inner("")</code> after any time
+    that you called <kbd>template_inner</kbd> for a specific language.
+    It is no longer necessary to do this second <kbd>template_inner</kbd>
+    call.</li>
+  <li><kbd>post_bug.cgi</kbd> and <kbd>Bugzilla::Bug-&gt;create</kbd> now take
+    the <em>names</em> of groups instead of group ids.</li>
+  <li>Bugzilla::Bugmail now uses Bugzilla::Bug objects internally instead of
+    a lot of direct SQL.</li>
+  <li>For sending changes about [% terms.bugs %], there is now a method
+    called <kbd>send_changes</kbd> that you can call on Bugzilla::Bug
+    objects. For an example of its use, see <kbd>process_bug.cgi</kbd>.</li>
+  <li>The <kbd>Bugzilla::Search</kbd> class has been refactored, and should
+    now be easier to customize.</li>
+  <li>The <kbd>Bugzilla::Util::lsearch</kbd> function is gone. Use
+    <kbd>firstidx</kbd> from <kbd>List::MoreUtils</kbd>, instead.</li>
+  <li>[% terms.Bugzilla %] now includes YUI 2.8.2.</li>
+  <li><kbd>long_list.cgi</kbd>, <kbd>showattachment.cgi</kbd> and
+    <kbd>xml.cgi</kbd> are deprecated scripts which are no longer actively
+    used since [% terms.Bugzilla %] 2.19. These scripts will be removed in
+    [%+ terms.Bugzilla %] 4.2.</li>
+</ul>
+
+<h2 id="v40_previous">Release Notes For Previous Versions</h2>
+
+<p><a href="page.cgi?id=release-notes3.html">Release Notes for
+  [%+ terms.Bugzilla %] 3.x and Earlier</a></p>
+
+[% INCLUDE global/footer.html.tmpl %]
+
+[% BLOCK db_req %]
+  [% SET m = DB_MODULE.$db %]
+  <h3 id="v40_req_[% db FILTER html %]">For [% m.name FILTER html %] Users</h3>
+
+  <ul>
+    <li>[% m.name FILTER html %]
+       [%+ '<span class="req_new">' IF db_new %]v[% m.db_version FILTER html %]
+       [% '</span>' IF db_new %]
+       </li>
+    <li><strong>perl module:</strong>
+      [%+ m.dbd.module FILTER html %] 
+      [% '<span class="req_new">' IF dbd_new %]v[% m.dbd.version FILTER html %]
+      [% '</span>' IF dbd_new %]</li>
+  </ul>
+[% END %]
+
+
+[% BLOCK req_table %]
+  <table class="req_table" border="0" cellspacing="0" cellpadding="0">
+    <tr>
+      <th>Module</th> <th>Version</th>
+      [% IF include_feature %]
+        <th>Enables Feature</th>
+      [% END %]
+    </tr>
+    [% FOREACH req = reqs %]
+      <tr>
+        <td [% ' class="req_new"' IF new.contains(req.package) %]>
+          [%- req.module FILTER html %]</td> 
+        <td [% ' class="req_new"' IF updated.contains(req.package) 
+                                     OR new.contains(req.package) %]>
+          [%- IF req.version == 0 %]
+            (Any)
+          [% ELSE %]
+            [%- req.version FILTER html %]
+          [% END %]
+        </td>
+        [% IF include_feature %] 
+          <td>[% req.feature.join(', ') FILTER html %]</td>
+        [% END %]
+      </tr>
+    [% END %]
+</table>
+[% END %]

diff --git a/template/en/default/pages/release-notes3.html.tmpl b/template/en/default/pages/release-notes3.html.tmpl
new file mode 100644 (file)
index 0000000..8d6ada5
--- /dev/null
+++ b/template/en/default/pages/release-notes3.html.tmpl
@@ -0,0 +1,3474 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% SET title = "$terms.Bugzilla 3.6 Release Notes" %]
+[% INCLUDE global/header.html.tmpl
+  title = title
+  style_urls = ['skins/standard/page.css']
+%]
+
+<h3>Release Notes For Newer Versions</h3>
+
+<p>Release notes for versions of [% terms.Bugzilla %] of the 4.x series are
+  available <a href="page.cgi?id=release-notes.html">here</a>.</p>
+
+<h1>[% title FILTER html %]</h1>
+
+<ul class="bz_toc">
+  <li><a href="#v36_introduction">Introduction</a></li>
+  <li><a href="#v36_point">Updates in this 3.6.x Release</a></li>
+  <li><a href="#v36_req">Minimum Requirements</a></li>
+  <li><a href="#v36_feat">New Features and Improvements</a></li>
+  <li><a href="#v36_issues">Outstanding Issues</a></li>
+  <li><a href="#v36_upgrading">Notes On Upgrading From a Previous Version</a></li>
+  <li><a href="#v36_code_changes">Code Changes Which May Affect 
+    Customizations</a></li>
+  <li><a href="#v36_previous">Release Notes for Previous Versions</a></li>
+</ul>
+
+<h2 id="v36_introduction">Introduction</h2>
+
+<p>Welcome to [% terms.Bugzilla %] 3.6! The focus of the 3.6 release is
+  on improving usability and "polishing up" all our features (by adding
+  some pieces that were "missing" or always wanted), although we
+  also have a few great new features for you, as well!</p>
+
+<p>If you're upgrading, make sure to read <a href="#v36_upgrading">Notes
+  On Upgrading From a Previous Version</a>. If you are upgrading from a release
+  before 3.4, make sure to read the release notes for all the 
+  <a href="#v36_previous">previous versions</a> in between your version
+  and this one, <strong>particularly the Upgrading section of each
+  version's release notes</strong>.</p>
+
+<p>We would like to thank <a href="http://www.canonical.com/">Canonical
+  Ltd.</a>, <a href="http://www.itasoftware.com/">ITA Software</a>,
+  the <a href="http://www.ibm.com/linux/ltc/">IBM Linux Technology Center</a>,
+  <a href="http://www.redhat.com/">Red Hat</a>, and 
+  <a href="http://www.novell.com/">Novell</a> for funding the development
+  of various features and improvements in this release of
+  [%+ terms.Bugzilla %].</p>
+
+<h2 id="v36_point">Updates in this 3.6.x Release</h2>
+
+<h3>3.6.2</h3>
+
+<p>This release fixes various security issues. See the
+  <a href="http://www.bugzilla.org/security/3.2.7/">Security Advisory</a>
+  for details.</p>
+
+<p>In addition, the following important fixes/changes have been made in
+  this release:</p>
+
+<ul>
+  <li>[% terms.Bugzilla %] installations running on older versions of IIS
+    will no longer experience the "Undef to trick_taint" errors that would
+    sometimes occur.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=521416">[% terms.Bug %] 521416</a>)
+  </li>
+  <li>Email notifications were missing the dates that comments were made.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=578003">[% terms.Bug %] 578003</a>)
+  </li>
+  <li>Putting a phrase in quotes in the Quicksearch box now works properly,
+    again.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=578494">[% terms.Bug %] 578494</a>
+    and <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=553884">[% terms.Bug %] 553884</a>)
+  </li>
+  <li>Quicksearch was usually (incorrectly) being limited to 200 results.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=581622">[% terms.Bug %] 581622</a>)
+  </li>
+  <li>On Windows, <kbd>install-module.pl</kbd> can now properly install
+    DateTime and certain other Perl modules that didn't install properly
+    before.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=576105">[% terms.Bug %] 576105</a>)
+  </li>
+  <li>Searching "keywords" for "contains none of the words" or "does not
+    match regular expression" now works properly.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=562014">[% terms.Bug %] 562014</a>)
+  </li>
+  <li>Doing <kbd>collectstats.pl --regenerate</kbd> now works on installations
+    using PostgreSQL.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=577058">[% terms.Bug %] 577058</a>)
+  </li>
+  <li>The "Field Values" administrative control panel was sometimes denying
+    admins the ability to delete field values when there was no reason
+    to deny the deletion.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=577054">[% terms.Bug %] 577054</a>)
+  </li>
+  <li>Eliminate the "uninitialized value" warnings that would happen when
+    editing a product's components.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=576911">[% terms.Bug %] 576911</a>)
+  </li>
+  <li>The updating of bugs_fulltext that happens during 
+    <kbd>checksetup.pl</kbd> for upgrades to 3.6 should now be MUCH faster.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=577754">[% terms.Bug %] 577754</a>)
+  </li>
+  <li><kbd>email_in.pl</kbd> was not allowing the setting of time-tracking
+    fields via inbound emails.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=583622">[% terms.Bug %] 583622</a>)
+  </li>
+</ul>
+
+<h3>3.6.1</h3>
+
+<p>This release fixes two security issues. See the
+  <a href="http://www.bugzilla.org/security/3.2.6/">Security Advisory</a>
+  for details.</p>
+
+<p>In addition, the following important fixes/changes have been made in
+  this release:</p>
+
+<ul>
+  <li>Using the "Change Columns" page would sometimes result in a
+    plain-text page instead of HTML.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=376044">[% terms.Bug %] 376044</a>)
+  </li>
+  <li>Extensions that have only templates and no code are now working.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=562551">[% terms.Bug %] 562551</a>)
+  </li>
+  <li><kbd>install-module.pl</kbd> has been fixed so that it installs
+    modules properly on both new and old versions of Perl.
+     (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=560318">[% terms.Bug %] 560318</a>
+     and <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=560330">[% terms.Bug %] 560330</a>)
+  </li>
+  <li>It is now possible to upgrade from 3.4 to 3.6 when using Oracle.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=561379">[% terms.Bug %] 561379</a>)
+  </li>
+  <li>Editing a field value's name (using the Field Values admin control
+    panel) wasn't working if the value was set as the default for that
+    field.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=561296">[% terms.Bug %] 561296</a>)
+  </li>
+  <li>If you had the <kbd>noresolveonopenblockers</kbd> parameter set,
+    [%+ terms.bugs %] couldn't be edited at all if they were marked FIXED
+    and had any open blockers. (The parameter is only supposed to prevent
+    <em>changing</em> [% terms.bugs %] to FIXED, not modifying already-FIXED
+    [%+ terms.bugs %].)
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=565314">[% terms.Bug %] 565314</a>)
+  </li>
+  <li>Some minor issues with Perl 5.12 were fixed (mostly warnings that Perl
+    5.12 was throwing). [% terms.Bugzilla %] now supports Perl 5.12.</li>
+</ul>
+
+<h2 id="v36_req">Minimum Requirements</h2>
+
+<p>Any requirements that are new since 3.4.5 will look like
+  <span class="req_new">this</span>.</p>
+
+<ul>
+  <li><a href="#v36_req_perl">Perl</a></li>
+  <li><a href="#v36_req_mysql">For MySQL Users</a></li>
+  <li><a href="#v36_req_pg">For PostgreSQL Users</a></li>
+  <li><a href="#v36_req_oracle">For Oracle Users</a></li>
+  <li><a href="#v36_req_modules">Required Perl Modules</a></li>
+  <li><a href="#v36_req_optional_mod">Optional Perl Modules</a></li>
+</ul>
+
+<h3 id="v36_req_perl">Perl</h3> 
+ 
+<p>Perl v5.8.1</p>
+
+<h3 id="v36_req_mysql">For MySQL Users</h3> 
+ 
+  <ul> 
+    <li>MySQL
+       v4.1.2
+       </li> 
+    <li><strong>perl module:</strong> 
+      DBD::mysql v4.00</li> 
+  </ul>
+  
+<h3 id="v36_req_pg">For PostgreSQL Users</h3> 
+ 
+  <ul> 
+    <li>PostgreSQL
+       v8.00.0000
+       </li> 
+    <li><strong>perl module:</strong> 
+      DBD::Pg v1.45</li> 
+  </ul> 
+<h3 id="v36_req_oracle">For Oracle Users</h3> 
+ 
+  <ul> 
+    <li>Oracle
+       v10.02.0
+       </li> 
+    <li><strong>perl module:</strong> 
+      DBD::Oracle v1.19</li> 
+  </ul> 
+ 
+<h3 id="v36_req_modules">Required Perl Modules</h3>
+
+<table class="req_table" border="0" cellspacing="0" cellpadding="0"> 
+    <tr> 
+      <th>Module</th> <th>Version</th> 
+    </tr> 
+      <tr> 
+        <td >CGI</td> 
+        <td >3.21
+        </td> 
+      </tr> 
+      <tr> 
+        <td >Digest::SHA</td> 
+        <td > 
+            (Any)
+        </td> 
+      </tr> 
+      <tr> 
+        <td >Date::Format</td> 
+        <td >2.21
+        </td> 
+      </tr> 
+      <tr> 
+        <td >DateTime</td> 
+        <td >0.28
+        </td> 
+      </tr> 
+      <tr> 
+        <td >DateTime::TimeZone</td> 
+        <td >0.71
+        </td> 
+      </tr> 
+      <tr> 
+        <td >DBI</td> 
+        <td >1.41
+        </td> 
+      </tr> 
+      <tr> 
+        <td >Template</td> 
+        <td >2.22
+        </td> 
+      </tr> 
+      <tr> 
+        <td >Email::Send</td> 
+        <td >2.00
+        </td> 
+      </tr> 
+      <tr> 
+        <td >Email::MIME</td> 
+        <td >1.861
+        </td> 
+      </tr> 
+      <tr> 
+        <td >Email::MIME::Encodings</td> 
+        <td >1.313
+        </td> 
+      </tr> 
+      <tr> 
+        <td >Email::MIME::Modifier</td> 
+        <td >1.442
+        </td> 
+      </tr> 
+      <tr> 
+        <td >URI</td> 
+        <td > 
+            (Any)
+        </td> 
+      </tr> 
+</table> 
+ 
+<h3 id="v36_req_optional_mod">Optional Perl Modules</h3> 
+ 
+<p>The following perl modules, if installed, enable various
+  features of [% terms.Bugzilla %]:</p>
+
+<table class="req_table" border="0" cellspacing="0" cellpadding="0"> 
+    <tr> 
+      <th>Module</th> <th>Version</th> 
+        <th>Enables Feature</th> 
+    </tr> 
+      <tr> 
+        <td >GD</td> 
+        <td >1.20
+        </td> 
+          <td>Graphical Reports, New Charts, Old Charts</td> 
+      </tr> 
+      <tr> 
+        <td >Chart::Lines</td> 
+        <td  class="req_new">2.1
+        </td> 
+          <td>New Charts, Old Charts</td> 
+      </tr> 
+      <tr> 
+        <td >Template::Plugin::GD::Image</td> 
+        <td > 
+            (Any)
+        </td> 
+          <td>Graphical Reports</td> 
+      </tr> 
+      <tr> 
+        <td >GD::Text</td> 
+        <td > 
+            (Any)
+        </td> 
+          <td>Graphical Reports</td> 
+      </tr> 
+      <tr> 
+        <td >GD::Graph</td> 
+        <td > 
+            (Any)
+        </td> 
+          <td>Graphical Reports</td> 
+      </tr> 
+      <tr> 
+        <td >XML::Twig</td> 
+        <td > 
+            (Any)
+        </td> 
+          <td>Move [% terms.Bugs %] Between Installations,
+          Automatic Update Notifications</td> 
+      </tr> 
+      <tr> 
+        <td >MIME::Parser</td> 
+        <td >5.406
+        </td> 
+          <td>Move [% terms.Bugs %] Between Installations</td> 
+      </tr> 
+      <tr> 
+        <td >LWP::UserAgent</td> 
+        <td > 
+            (Any)
+        </td> 
+          <td>Automatic Update Notifications</td> 
+      </tr> 
+      <tr> 
+        <td >PatchReader</td> 
+        <td >0.9.4
+        </td> 
+          <td>Patch Viewer</td> 
+      </tr> 
+      <tr> 
+        <td >Net::LDAP</td> 
+        <td > 
+            (Any)
+        </td> 
+          <td>LDAP Authentication</td> 
+      </tr> 
+      <tr> 
+        <td >Authen::SASL</td> 
+        <td > 
+            (Any)
+        </td> 
+          <td>SMTP Authentication</td> 
+      </tr> 
+      <tr> 
+        <td >Authen::Radius</td> 
+        <td > 
+            (Any)
+        </td> 
+          <td>RADIUS Authentication</td> 
+      </tr> 
+      <tr> 
+        <td >SOAP::Lite</td> 
+        <td >0.710.06
+        </td> 
+          <td>XML-RPC Interface</td> 
+      </tr> 
+      <tr> 
+        <td  class="req_new">JSON::RPC</td> 
+        <td  class="req_new"> 
+            (Any)
+        </td> 
+          <td>JSON-RPC Interface</td> 
+      </tr> 
+      <tr> 
+        <td  class="req_new">Test::Taint</td> 
+        <td  class="req_new"> 
+            (Any)
+        </td> 
+          <td>JSON-RPC Interface, XML-RPC Interface</td> 
+      </tr> 
+      <tr> 
+        <td >HTML::Parser</td> 
+        <td >3.40
+        </td> 
+          <td>More HTML in Product/Group Descriptions</td> 
+      </tr> 
+      <tr> 
+        <td >HTML::Scrubber</td> 
+        <td > 
+            (Any)
+        </td> 
+          <td>More HTML in Product/Group Descriptions</td> 
+      </tr> 
+      <tr> 
+        <td >Email::MIME::Attachment::Stripper</td> 
+        <td > 
+            (Any)
+        </td> 
+          <td>Inbound Email</td> 
+      </tr> 
+      <tr> 
+        <td >Email::Reply</td> 
+        <td > 
+            (Any)
+        </td> 
+          <td>Inbound Email</td> 
+      </tr> 
+      <tr> 
+        <td >TheSchwartz</td> 
+        <td > 
+            (Any)
+        </td> 
+          <td>Mail Queueing</td> 
+      </tr> 
+      <tr> 
+        <td >Daemon::Generic</td> 
+        <td > 
+            (Any)
+        </td> 
+          <td>Mail Queueing</td> 
+      </tr> 
+      <tr> 
+        <td >mod_perl2</td> 
+        <td >1.999022
+        </td> 
+          <td>mod_perl</td> 
+      </tr> 
+</table> 
+
+<h2 id="v36_feat">New Features and Improvements</h2>
+
+<ul>
+  <li><a href="#v36_feat_usability">General Usability Improvements</a></li>
+  <li><a href="#v36_feat_extensions">New Extensions System</a></li>  
+  <li><a href="#v36_feat_qs">Improved Quicksearch</a></li>
+  <li><a href="#v36_feat_browse">Simple "Browse" Interface</a></li>
+  <li><a href="#v36_feat_suexec">SUExec Support</a></li>
+  <li><a href="#v36_feat_mpwindows">Experimental mod_perl Support on Windows</a></li>
+  <li><a href="#v36_email_attachments">Send Attachments by Email</a></li>
+  <li><a href="#v36_feat_jsonrpc">JSON-RPC Interface</a></li>
+  <li><a href="#v36_feat_migrate">Migration From Other [% terms.Bug %]-Trackers</a></li>
+  <li><a href="#v36_feat_other">Other Enhancements and Changes</a></li>
+</ul>
+
+<h3 id="v36_feat_usability">General Usability Improvements</h3>
+
+<p>A <a href="https://wiki.mozilla.org/Bugzilla:CMU_HCI_Research_2008">scientific
+  usability study</a> was done on [% terms.Bugzilla %] by researchers
+  from Carnegie-Mellon University. As a result of this study,
+  <a href="https://bugzilla.mozilla.org/showdependencytree.cgi?id=490786&amp;hide_resolved=0">several
+  usability issues</a> were prioritized to be fixed, based on specific data
+  from the study.</p>
+
+<p>As a result, you will see many small improvements in [% terms.Bugzilla %]'s
+  usability, such as using Javascript to validate certain forms before
+  they are submitted, standardizing the words that we use in the user interface,
+  being clearer about what [% terms.Bugzilla %] needs from the user,
+  and other changes, all of which are also listed individually in this New
+  Features section.</p>
+
+<p>Work continues on improving usability for the next release of
+  [%+ terms.Bugzilla %], but the results of the research have already
+  had an impact on this 3.6 release.</p>
+
+<h3 id="v36_feat_extensions">New Extensions System</h3>
+
+<p>[% terms.Bugzilla %] has a brand-new Extensions system. The system is
+  consistent, fast, and
+  <a href="[% docs_urlbase FILTER html %]api/Bugzilla/Extension.html">fully
+  documented</a>. It makes it possible to easily extend [% terms.Bugzilla %]'s
+  code and user interface to add new features or change existing features.
+  There's even
+  <a href="[% docs_urlbase FILTER html %]api/extensions/create.html">a
+  script</a> that will create the basic layout of an extension for you, to
+  help you get started. For more information about the new system, see the
+  <a href="[% docs_urlbase FILTER html %]api/Bugzilla/Extension.html">Extensions
+  documentation</a>.</p>
+
+<p>If you had written any extensions using [% terms.Bugzilla %]'s previous
+  extensions system, there is
+  <a href="[% docs_urlbase FILTER html %]api/contrib/extension-convert.html">a
+  script to help convert old extensions into the new format</a>.</p>
+
+<h3 id="v36_feat_qs">Improved Quicksearch</h3>
+
+<p>The "quicksearch" box that appears on the front page of
+  [%+ terms.Bugzilla %] and in the header/footer of every page
+  is now simplified and made more powerful. There is a
+  <kbd>[?]</kbd> link next to the box that will take you to
+  the simplified <a href="page.cgi?id=quicksearch.html">Quicksearch Help</a>,
+  which describes every single feature of the system in a simple layout,
+  including new features such as the ability to use partial field names
+  when searching.</p>
+
+<p>Quicksearch should also be much faster than it was before, particularly
+  on large installations.</p>
+
+<p>Note that in order to implement the new quicksearch, certain old
+  and rarely-used features had to be removed:
+
+<ul>
+  <li><b>+</b> as a prefix to mean "search additional resolutions", and
+    <b>+</b> as a prefix to mean "search just the summary". You can
+    instead use <kbd>summary:</kbd> to explicitly search summaries.</li>
+  <li>Searching the [% field_descs.bug_severity FILTER html %] field if you
+    type something that matches the first few characters of a [% 
+    field_descs.bug_severity FILTER html %]. You can explicitly
+    search the [% field_descs.bug_severity FILTER html %] field if you want to
+    find [% terms.bugs %] by [% field_descs.bug_severity FILTER html %].</li>
+  <li>Searching the Priority field if you typed something that exactly
+    matched the name of a priority. You can explicitly search the
+    Priority field if you want to find [% terms.bugs %] by priority.</li>
+  <li>Searching the [% field_descs.rep_platform FILTER html %] and OS fields
+    if you typed in one of a certain hard-coded list of strings (like "pc",
+    "windows", etc.). You can explicitly search these fields, instead, if you want
+    to find [% terms.bugs %] with a specific [% field_descs.rep_platform
+    FILTER html %] or OS set.</li>
+</ul>
+
+<h3 id="v36_feat_browse">Simple "Browse" Interface</h3>
+
+<p>There is now a "Browse" link in the header of each [% terms.Bugzilla %]
+  page that presents a very basic interface that allows users to simply
+  browse through all open [% terms.bugs %] in particular components.</p>
+
+<h3 id="v36_feat_suexec">SUExec Support</h3>
+
+<p>[% terms.Bugzilla %] can now be run in Apache's "SUExec" mode,
+  which is what control panel software like cPanel and Plesk use
+  (so [% terms.Bugzilla %] should now be much easier to install
+  on shared hosting). SUExec support shows up as an option
+  in the <kbd>localconfig</kbd> file during installation.</p>
+
+<h3 id="v36_feat_mpwindows">Experimental mod_perl Support on Windows</h3>
+
+<p>There is now experimental support for running [% terms.Bugzilla %]
+  under mod_perl on Windows, for a significant performance enhancement
+  (in exchange for using more memory).</p>
+
+<h3 id="v36_email_attachments">Send Attachments by Email</h3>
+
+<p>The <a href="[% docs_urlbase FILTER html %]api/email_in.html">email_in</a>
+  script now supports attaching multiple attachments to [% terms.abug %]
+  by email, both when filing and when updating [% terms.abug %].</p>
+
+<h3 id="v36_feat_jsonrpc">JSON-RPC Interface</h3>
+
+<p>[% terms.Bugzilla %] now has support for the
+  <a href="http://json-rpc.org/">JSON-RPC</a> WebServices protocol via
+  <a href="[% docs_urlbase FILTER html %]api/Bugzilla/WebService/Server/JSONRPC.html">jsonrpc.cgi</a>.
+  The JSON-RPC interface is experimental in this release--if you want any
+  fundamental changes in how it works,
+  <a href="http://www.bugzilla.org/developers/reporting_bugs.html">let us
+  know</a>, for the next release of [% terms.Bugzilla %].</p>
+
+<h3 id="v36_feat_migrate">Migration From Other [% terms.Bug %]-Trackers</h3>
+
+<p>[% terms.Bugzilla %] 3.6 comes with a new script,
+  <a href="[% docs_urlbase FILTER html %]api/migrate.html">migrate.pl</a>,
+  which allows migration from other [% terms.bug %]-tracking systems.
+  Among the various features of the migration system are:</p>
+
+<ul>
+  <li>It is non-destructive--you can migrate into an existing
+    [%+ terms.Bugzilla %] installation without destroying any data
+    in the installation.</li>
+  <li>It has a "dry-run" mode so you can test your migration
+    before actually running it.</li>
+  <li>It is relatively easy to write new migrators for new systems,
+    if you know Perl. The basic migration framework does most of the work
+    for you, you just have to provide it with the data from your
+    [%+ terms.bug %]-tracker. See the
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/Migrate.html">Bugzilla::Migrate</a>
+    documentation and see our current migrator,
+    <kbd>Bugzilla/Migrate/GNATS.pm</kbd> for information on how to make your
+    own migrator.</li>
+</ul>
+
+<p>The first migrator that has been implemented is for the GNATS
+  [%+ terms.bug %]-tracking system. We'd love to see migrators for
+  other systems! If you want to contribute a new migrator, see our
+  <a href="http://wiki.mozilla.org/Bugzilla:Developers">development
+  process</a> for details on how to get code into [% terms.Bugzilla %].</p>
+
+<p>Thanks to <a href="http://lambdares.com/">Lambda Research</a> for
+  funding the initial development of this feature.</p>
+
+<h3 id="v36_feat_other">Other Enhancements and Changes</h3>
+
+<h4>Enhancements for Users</h4>
+
+<ul>
+  <li><b>[% terms.Bug %] Filing:</b> When filing [% terms.abug %],
+    [%+ terms.Bugzilla %] now visually indicates which fields are
+    mandatory.</li>
+  <li><b>[% terms.Bug %] Filing:</b> "Bookmarkable templates" now
+    support the "alias" and "estimated hours" fields.</li>
+  
+  <li><b>[% terms.Bug %] Editing:</b> In previous versions of
+    [%+ terms.Bugzilla %], if you added a private comment to [% terms.abug %],
+    then <em>none</em> of the changes that you made at that time were
+    sent to users who couldn't see the private comment. Now, for users
+    who can't see private comments, public changes are sent, but the private
+    comment is excluded from their email notification.</li>
+  <li><b>[% terms.Bug %] Editing:</b> The controls for groups now
+    appear to the right of the attachment and time-tracking tables,
+    when editing [% terms.abug %].</li>
+  <li><b>[% terms.Bug %] Editing:</b> The "Collapse All Comments"
+    and "Expand All Comments" links now appear to the right of the
+    comment list instead of above it.</li>
+  <li><b>[% terms.Bug %] Editing:</b> The See Also field now supports
+    URLs for Google Code Issues and the Debian B[% %]ug-Tracking System.</li>
+  <li><b>[% terms.Bug %] Editing:</b> There have been significant performance
+    improvements in <kbd>show_bug.cgi</kbd> (the script that displays the
+    [% terms.bug %]-editing form), particularly for [% terms.bugs %] that
+    have lots of comments or attachments.</li>
+
+  <li><b>Attachments:</b> The "Details" page of an attachment
+    now displays itself as uneditable if you can't edit the fields
+    there.</li>
+  <li><b>Attachments:</b> We now make sure that there is
+    a Description specified for an attachment, using JavaScript, before
+    the form is submitted.</li>
+  <li><b>Attachments:</b> There is now a link back to the [% terms.bug %]
+    at the bottom of the "Details" page for an attachment.</li>
+  <li><b>Attachments:</b> When you click on an "attachment 12345" link
+    in a comment, if the attachment is a patch, you will now see the
+    formatted "Diff" view instead of the raw patch.</li>
+  <li><b>Attachments</b>: For text attachments, we now let the browser 
+    auto-detect the character encoding, instead of forcing the browser to
+    always assume the attachment is in UTF-8.</li>
+  
+  <li><b>Search:</b> You can now display [% terms.bug %] flags as a column
+    in search results.</li>
+  <li><b>Search:</b> When viewing search results, you can see which columns are
+    being sorted on, and which direction the sort is on, as indicated
+    by arrows next to the column headers.</li>
+  <li><b>Search:</b> You can now search the Deadline field using relative
+    dates (like "1d", "2w", etc.).</li>
+  <li><b>Search:</b> The iCalendar format of search results now includes
+    a PRIORITY field.</li>
+  <li><b>Search:</b> It is no longer an error to enter an invalid search
+    order in a search URL--[% terms.Bugzilla %] will simply warn you that
+    some of your order options are invalid.</li>
+  <li><b>Search:</b> When there are no search results, some helpful
+    links are displayed, offering actions you might want to take.</li>
+  <li><b>Search:</b> For those who like to make their own
+    <kbd>buglist.cgi</kbd> URLs (and for people working on customizations),
+    <kbd>buglist.cgi</kbd> now accepts nearly every valid field in
+    [%+ terms.Bugzilla %] as a direct URL parameter, like
+    <kbd>&amp;field=value</kbd>.</li>
+  
+  <li><b>Requests:</b> When viewing the "My Requests" page, you can now
+    see the lists as a normal search result by clicking a link at the
+    bottom of each table.</li>
+  <li><b>Requests:</b> When viewing the "My Requests" page, if you are
+    using Classifications, the Product drop-down will be grouped by
+    Classification.</li>
+
+  <li><b>Inbound Email:</b> When filing [% terms.abug %] by email, if the
+    product that you are filing the [% terms.bug %] into has some groups
+    set as Default for you, the [% terms.bug %] will now be placed into those
+    groups automatically.</li>
+  <li><b>Inbound Email:</b> The field names that can be used when creating
+    [%+ terms.bugs %] by email now exactly matches the set of valid parameters
+    to the
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/WebService/Bug.html#create">B[% %]ug.create
+    WebService function</a>. You can still use most of the old field names
+    that 3.4 and earlier used for inbound emails, though, for
+    backwards-compatibility.</li>
+
+  <li>If there are multiple languages available for your
+    [%+ terms.Bugzilla %], you can now select what language you want
+    [%+ terms.Bugzilla %] displayed in using links at the top of every
+    page.</li>
+  <li>When creating a new account, you will be automatically logged in
+    after setting your password.</li>
+  <li>There is no longer a maximum password length for accounts.</li>
+  <li>In the Dusk skin, it's now easier to see links.</li>
+  <li>In the Whining system, you can now choose to receive emails even
+    if there are no [% terms.bugs %] that match your searches.</li>
+  <li>The arrows in dependency graphs now point the other way, so that
+    [%+ terms.bugs %] point at their dependencies.</li>
+  
+  <li><b>New Charts:</b> You can now convert an existing Saved Search
+    into a data series for New Charts.</li>
+  <li><b>New Charts:</b> There is now an interface that allows you to
+    delete data series.</li>
+  <li><b>New Charts:</b> When deleting a product, you now have the option
+    to delete the data series that are associated with that product.</li>
+</ul>
+
+<h4>Enhancements for Administrators and Developers</h4>
+
+<ul>
+  <li>Depending on how your workflow is set up, it is now possible to
+    have both UNCONFIRMED and REOPENED show up as status choices for
+    a closed [% terms.bug %]. If you only want one or the other to
+    show up, you should edit your status workflow appropriately
+    (possibly by removing or disabling the REOPENED status).</li>
+  <li>You can now "disable" field values so that they don't show
+    up as choices on [% terms.abug %] unless they are already set as
+    the value for that [% terms.bug %]. This doesn't work for the
+    per-product field values (component, target_milestone, and version)
+    yet, though.</li>
+  <li>Users are now locked out of their accounts for 30 minutes after
+    trying five bad passwords in a row during login. Every time a
+    user is locked out like this, the user in the "maintainer" parameter
+    will get an email.</li>
+  <li>The minimum length allowed for a password is now 6 characters.</li>
+  <li>The <kbd>UNCONFIRMED</kbd> status being enabled in a product
+    is now unrelated to the voting parameters. Instead, there is a checkbox
+    to enable the <kbd>UNCONFIRMED</kbd> status in a product.</li>
+  <li>Information about duplicates is now stored in the database instead
+    of being stored in the <kbd>data/</kbd> directory. On large installations
+    this could save several hundred megabytes of disk space.</li>
+
+  <li><b>Installation:</b> When installing [% terms.Bugzilla %], the
+    "maintainer" parameter will be automatically set to the administrator
+    that was created by <kbd>checksetup.pl</kbd>.</li>
+  <li><b>Installation:</b> <kbd>checksetup.pl</kbd> now prints out
+    certain errors in a special color so that you know that something
+    needs to be done.</li>
+  <li><b>Installation:</b> <kbd>checksetup.pl</kbd> is now <em>much</em>
+    faster at upgrading installations, particularly older installations.
+    Also, it's been made faster to run for the case where it's not
+    doing an upgrade.</li>
+  <li><b>Installation:</b> If you install [% terms.Bugzilla %] using the
+    tarball, the <kbd>CGI.pm</kbd> module from CPAN is now included in
+    the <kbd>lib/</kbd> dir. If you would rather use the CGI.pm from your
+    global Perl installation, you can delete <kbd>CGI.pm</kbd> and the
+    <kbd>CGI</kbd> directory from the <kbd>lib/</kbd> directory.</li>
+  
+  <li>When editing a group, you can now specify that members of a group
+    are allowed to grant others membership in that group itself.</li>
+  <li>The ability to compress BMP attachments to PNGs is now an Extension.
+    To enable the feature, remove the file
+    <kbd>extensions/BmpConvert/disabled</kbd> and then run <kbd>checksetup.pl</kbd>.</li>
+  <li>The default list of values for the Priority field are now clear English
+    words instead of P1, P2, etc.</li>
+  <li>There is now a system in place so that all field values can be
+    localized. See the <kbd>value_descs</kbd> variable in
+    <kbd>template/en/default/global/field-descs.none.tmpl</kbd>.</li>
+  <li><kbd>config.cgi</kbd> now returns an ETag header and understands
+    the If-None-Match header in HTTP requests.</li>
+  <li>The XML format of <kbd>show_bug.cgi</kbd> now returns more information:
+    the numeric id of each comment, whether an attachment is a URL,
+    the modification time of an attachment, the numeric id of a flag,
+    and the numeric id of a flag's type.</li>
+  
+  <li><b>Parameters:</b> Parameters that aren't actually required are no longer
+    in the "Required" section of the Parameters page. Instead, some are in the
+    new "General" section, and some are in the new "Advanced" section.</li>
+  <li><b>Parameters:</b> The old <kbd>ssl</kbd> parameter has been
+    changed to <kbd>ssl_redirect</kbd>, and can only be turned "on" or "off".
+    If "on", then all users will be forcibly redirected to SSL whenever
+    they access [% terms.Bugzilla %]. When the parameter is off,
+    no SSL-related redirects will occur (even if the user directly
+    accesses [% terms.Bugzilla %] via SSL, they will <em>not</em> be
+    redirected to a non-SSL page).</li>
+  <li><b>Parameters:</b> In the Advanced parameters, there is a new parameter,
+    <kbd>inbound_proxies</kbd>. If your [% terms.Bugzilla %] is behind a
+    proxy, you should set this parameter to the IP address of that proxy.
+    Then, [% terms.Bugzilla %] will "believe" any "X-Forwarded-For"
+    header sent from that proxy, and correctly use the X-Forwarded-For
+    as the end user's IP, instead of believing that all traffic is coming
+    from the proxy.</li>
+    
+  <li><b>Removed Parameter:</b> The <kbd>loginnetmask</kbd> parameter has
+    been removed. Since [% terms.Bugzilla %] sends secure cookies, it's no
+    longer necessary to always restrict logins to a specific IP or block
+    of addresses.</li>
+  <li><b>Removed Parameter:</b> The <kbd>quicksearch_comment_cutoff</kbd>
+    parameter is gone. Quicksearch now always searches comments; however, it
+    uses a much faster algorithm to do it.</li>
+  <li><b>Removed Parameter:</b> The <kbd>usermatchmode</kbd> parameter has
+    been removed. User-matching is now <em>always</em> done.</li>
+  <li><b>Removed Parameter:</b> The <kbd>useentrygroupdefault</kbd> parameter
+    has been removed. [% terms.Bugzilla %] now always behaves as though
+    that parameter were off.</li>
+  <li>The <kbd>t/001compile.t</kbd> test should now always pass, no matter
+    what configuration of optional modules you do or don't have installed.</li>
+  <li>New script: <kbd>contrib/console.pl</kbd>, which allows you to have
+    a "command line" into [% terms.Bugzilla %] by inputting Perl code
+    or using a few custom commands.</li>
+</ul>
+
+<h4>WebService Changes</h4>
+
+<ul>
+  <li>The WebService now returns all dates and times in the UTC timezone.
+    <kbd>B[% %]ugzilla.time</kbd> now acts as though the [% terms.Bugzilla %]
+    server were in the UTC timezone, always. If you want to write clients
+    that are compatible across all [% terms.Bugzilla %] versions,
+    check the timezone from <kbd>B[% %]ugzilla.timezone</kbd> or
+    <kbd>B[% %]ugzilla.time</kbd>, and always input times in that timezone
+    and expect times to be returned in that format.</li>
+  <li>You can now log in by passing <kbd>Bugzilla_login</kbd> and
+    <kbd>Bugzilla_password</kbd> as arguments to any WebService function.
+    See the
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/WebService.html#LOGGING_IN">Bugzilla::WebService</a>
+    documentation for details.</li>
+  <li>New Method:
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/WebService/Bug.html#attachments">B[% %]ug.attachments</a>
+    which allows getting information about attachments.</li>
+  <li>New Method:
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/WebService/Bug.html#fields">B[% %]ug.fields</a>,
+    which gets information about all the fields that [% terms.abug %] can have
+    in [% terms.Bugzilla %], include custom fields and legal values for
+    all fields. The <kbd>B[% %]ug.legal_values</kbd> method is now deprecated.</li>
+  <li>In the <kbd>B[% %]ug.add_comment</kbd> method, the "private" parameter
+    has been renamed to "is_private" (for consistency with other methods).
+    You can still use "private", though, for backwards-compatibility.</li>
+  <li>The WebService now has Perl's "taint mode" turned on. This means that
+    it validates all data passed in before sending it to the database.
+    Also, all parameter names are validated, and if you pass in a parameter
+    whose name contains anything other than letters, numbers, or underscores,
+    that parameter will be ignored. Mostly this just affects
+    customizers--[% terms.Bugzilla %]'s WebService is not functionally
+    affected by these changes.</li>
+  <li>In previous versions of [% terms.Bugzilla %], error messages were
+    sent word-wrapped to the client, from the WebService. Error messages
+    are now sent as one unbroken line.</li>
+</ul>
+
+<h2 id="v36_issues">Outstanding Issues</h2>
+
+<ul>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=423439">
+    [%- terms.Bug %] 423439</a>: Tabs in comments will be converted
+    to four spaces, due to a b<!-- -->ug in Perl as of Perl 5.8.8.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=69621">
+    [%- terms.Bug %] 69621</a>: If you rename or remove a keyword that is
+    in use on [% terms.bugs %], you will need to rebuild the "keyword cache"
+    by running <a href="sanitycheck.cgi">sanitycheck.cgi</a> and choosing 
+    the option to rebuild the cache when it asks. Otherwise keywords may 
+    not show up properly in search results.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=89822">
+    [%- terms.Bug %] 89822</a>: When changing multiple [% terms.bugs %] at 
+    the same time, there is no "mid-air collision" protection.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=276230">
+    [%- terms.Bug %] 276230</a>: The support for restricting access to 
+    particular Categories of New Charts is not complete. You should treat 
+    the 'chartgroup' Param as the only access mechanism available.<br>
+    However, charts migrated from Old Charts will be restricted to 
+    the groups that are marked MANDATORY for the corresponding Product.
+    There is currently no way to change this restriction, and the 
+    groupings will not be updated if the group configuration
+    for the Product changes.</li>
+</ul>
+
+<h2 id="v36_upgrading">Notes On Upgrading From a Previous Version</h2>
+
+<p>When upgrading to 3.6, <kbd>checksetup.pl</kbd> will create foreign keys
+  for many columns in the database. Before doing this, it will check the
+  database for consistency. If there are an unresolvable consistency
+  problems, it will tell you what table and column in the database contain
+  the bad values, and which values are bad. If you don't know what else to do,
+  you can always delete the database records which contain the bad values by
+  logging in to your database and running the following command:</p>
+
+<p><code>DELETE FROM <var>table</var> WHERE <var>column</var> IN 
+  (<var>1, 2, 3, 4</var>)</code></p>
+
+<p>Just replace "table" and "column" with the name of the table 
+  and column that <kbd>checksetup.pl</kbd> mentions, and "1, 2, 3, 4"
+  with the invalid values that <kbd>checksetup.pl</kbd> prints out.</p>
+
+<p>Remember that you should always back up your database before doing
+  an upgrade.</p>
+
+<h2 id="v36_code_changes">Code Changes Which May Affect Customizations</h2>
+
+<ul>
+  <li>There is no longer a SendBugMail method in the templates, and bugmail
+    is no longer sent by processing a template. Instead, it is sent
+    by using <kbd>Bugzilla::BugMail::Send</kbd>.</li>
+  <li>Comments are now represented as a
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/Comment.html">Bugzilla::Comment</a>
+    object instead of just being hashes.</li>
+  <li>In previous versions of [% terms.Bugzilla %], the template for displaying
+    [%+ terms.abug %] required a lot of extra variables that are now global
+    template variables instead.</li>
+  <li>You can now check if optional modules are installed by using
+    <kbd>Bugzilla-&gt;feature</kbd> in Perl code or
+    <kbd>feature_enabled</kbd> in template code.</li>
+  <li>All of the various template header information required to display
+    the [% terms.bug %] form is now in one template,
+    <kbd>template/en/default/bug/show-header.html.tmpl</kbd>.</li>
+  <li>You should now use <kbd>display_value</kbd> instead of
+    <kbd>get_status</kbd> or <kbd>get_resolution</kbd> in templates.
+    <kbd>display_value</kbd> should be used anywhere that a
+    &lt;select&gt;-type field has its values displayed.</li>
+</ul>
+
+
+<h1 id="v36_previous">[% terms.Bugzilla %] 3.4 Release Notes</h1>
+
+<ul class="bz_toc">
+  <li><a href="#v34_introduction">Introduction</a></li>
+  <li><a href="#v34_point">Updates in this 3.4.x Release</a></li>
+  <li><a href="#v34_req">Minimum Requirements</a></li>
+  <li><a href="#v34_feat">New Features and Improvements</a></li>
+  <li><a href="#v34_issues">Outstanding Issues</a></li>
+  <li><a href="#v34_upgrading">Notes On Upgrading From a Previous Version</a></li>
+  <li><a href="#v34_code_changes">Code Changes Which May Affect 
+    Customizations</a></li>
+  <li><a href="#v34_previous">Release Notes for Previous Versions</a></li>
+</ul>
+
+<h2 id="v34_introduction">Introduction</h2>
+
+<p>This is [% terms.Bugzilla %] 3.4! [% terms.Bugzilla %] 3.4 brings a lot
+  of great enhancements for [% terms.Bugzilla %] over previous versions,
+  with various improvements to the user interface, lots of interesting new
+  features, and many long-standing requests finally being addressed.</p>
+
+<p>If you're upgrading, make sure to read <a href="#v34_upgrading">Notes
+  On Upgrading From a Previous Version</a>. If you are upgrading from a release
+  before 3.2, make sure to read the release notes for all the 
+  <a href="#v34_previous">previous versions</a> in between your version
+  and this one, <strong>particularly the Upgrading section of each
+  version's release notes</strong>.</p>
+
+<p>We would like to thank <a href="http://www.canonical.com/">Canonical
+  Ltd.</a> for funding development of one new feature, and NASA for funding
+  development of several new features through the
+  <a href="http://www.sjsufoundation.org/">San Jose State University
+  Foundation</a>.</p>
+
+<h2 id="v34_point">Updates In This 3.4.x Release</h2>
+
+<h3>3.4.6</h3>
+
+<ul>
+  <li>When doing a search that involves "not equals" or "does not contain the
+    string" or similar "negative" search types, the search description that
+    appears at the top of the resulting [% terms.bug %] list will indicate
+    that the search was of that type.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=474738">[% terms.Bug %] 474738</a>)
+  </li>
+  <li>In Internet Explorer, users couldn't easily mark a RESOLVED DUPLICATE
+    [%+ terms.bug %] as REOPENED, due to a JavaScript error.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=546719">[% terms.Bug %] 546719</a>)
+  </li>
+  <li>If you use a "bookmarkable template" to pre-fill forms on
+    the [% terms.bug %]-filing page, and you have custom fields
+    that are only supposed to appear (or only supposed to have certain
+    values) based on the values of other fields, those custom fields will
+    now work properly.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=538211">[% terms.Bug %] 538211</a>)
+  </li>
+  <li>If you have a custom field that's only supposed to appear when
+    a [% terms.bug %]'s resolution is FIXED, it will now behave properly
+    on the [% terms.bug %]-editing form when a user sets the [% terms.bug %]'s
+    status to RESOLVED.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=520993">[% terms.Bug %] 520993</a>)
+  </li>
+  <li>If you are logged-out and using <kbd>request.cgi</kbd>, the Requester
+    and Requestee fields no longer respect the <kbd>usermatching</kbd>
+    parameter--they always require full usernames.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=533018">[% terms.Bug %] 533018</a>)
+  </li>
+  <li>If you tried to do a search with too many terms (resulting in a URL
+    that was longer than about 7000 characters), Apache would return a 
+    500 error instead of your search results.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=513989">[% terms.Bug %] 513989</a>)
+  </li>
+  <li>[% terms.Bugzilla %] would sometimes lose fields from your sort order
+    when you added new fields to your sort order.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=470214">[% terms.Bug %] 470214</a>)
+  </li>
+  <li>The Atom format of search results would sometimes be missing the
+    Reporter or Assignee field for some [% terms.bugs %].
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=537834">[% terms.Bug %] 537834</a>)
+  </li>
+</ul>
+
+<h3>3.4.5</h3>
+
+<p>This release contains fixes for multiple security issues. See the
+  <a href="http://www.bugzilla.org/security/3.0.10/">Security Advisory</a>
+  for details.</p>
+
+<p>In addition, the following important fixes/changes have been made in
+  this release:</p>
+
+<ul>
+  <li>Whining was failing if jobqueue.pl was enabled.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=530270">[% terms.Bug %] 530270</a>)
+  </li>
+  <li>The Assignee field was empty in Whine mails.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=511216">[% terms.Bug %] 511216</a>)
+  </li>
+  <li>Administrators can now successfully create user accounts using 
+    editusers.cgi when using the "Env" authentication method.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=483987">[% terms.Bug %] 483987</a>)
+  </li>
+  <li>[% terms.Bug %]mail now uses the timezone of the recipient of the email,
+    when displaying the time a comment was made, instead of the timezone of the
+    person who made the change.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=534587">[% terms.Bug %] 534587</a>)
+  </li>
+  <li>"[% terms.bug %] 1234" in comments sometimes would not become a link if
+    word-wrapping happened between "[% terms.bug %]" and the number.
+   (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=514703">[% terms.Bug %] 514703</a>)
+  </li>
+  <li>Running <kbd>checksetup.pl</kbd> on Windows will no longer pop up an error box
+    about OCI.dll.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=480968">[% terms.Bug %] 480968</a>)
+  </li>
+</ul>
+
+<h3>3.4.4</h3>
+
+<p>This release contains a fix for a security issue. See the
+  <a href="http://www.bugzilla.org/security/3.4.3/">Security Advisory</a>
+  for details.</p>
+
+<p>Additionally, this release fixes a few minor [% terms.bugs %].</p>
+
+<h3>3.4.3</h3>
+
+<ul>
+  <li>[% terms.Bugzilla %] installations running under mod_perl were leaking
+    about 512K of RAM per page load.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=517793">[% terms.Bug %] 517793</a>)
+  </li>
+  <li>Attachments with Unicode characters in their names were being downloaded
+    with mangled names. 
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=328628">[% terms.Bug %] 328628</a>)
+  </li>
+  <li>Creating custom fields with Unicode in their database column name
+    is now no longer allowed, as it would break [% terms.Bugzilla %]. If you
+    created such a custom field, you should delete it by first marking it 
+    obsolete and then clicking "Delete" in the custom field list, using
+    <a href="editfields.cgi">editfields.cgi</a>.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=525025">[% terms.Bug %] 525025</a>)
+  </li>
+  <li>Clicking "submit only my comment" on the "mid-air collisions" page
+    was leading to a "Suspicious Action" warning.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=514378">[% terms.Bug %] 514378</a>)
+  </li>
+  <li>The XML format of [% terms.abug %] accidentally contained the
+    word-wrapped content of comments instead of the unwrapped content.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=509152">[% terms.Bug %] 509152</a>)
+  </li>
+  <li>You can now do <kbd>./install-module.pl --shell</kbd> to get a CPAN
+    shell using the configuration of 
+    <a href="[% docs_urlbase FILTER html %]api/install-module.html">install-module.pl</a>,
+    which allows you to do more advanced Perl module installation tasks.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=445875">[% terms.Bug %] 445875</a>)
+  </li>
+</ul>
+
+<h3>3.4.2</h3>
+
+<p>This release contains fixes for multiple security issues, one of which
+  is highly critical. See the 
+  <a href="http://www.bugzilla.org/security/3.0.8/">Security Advisory</a>
+  for details.</p>
+
+<p>In addition, the following important fixes/changes have been made in
+  this release:</p>
+
+<ul>
+  <li>Upgrades from older releases were sometimes failing during UTF-8 
+    conversion with a foreign key error. 
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=508181">[% terms.Bug %] 508181</a>)
+  </li>
+  <li>Sorting [% terms.bug %] lists on certain fields would result in an error.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=510944">[% terms.Bug %] 510944</a>)
+  </li>
+  <li>[% terms.Bug %] update emails had two or three blank lines at the top
+    and between the various sections of the email. There is now only one
+    blank line in each of those places, making these emails more compact.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=73330">[% terms.Bug %] 73330</a>)
+  </li>
+  <li>[% terms.Bug %] email notifications for new [% terms.bugs %] incorrectly
+    had a line saying that the description was "Comment 0".
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=510798">[% terms.Bug %] 510798</a>)
+  </li>
+  <li>Running <kbd>./collectstats.pl --regenerate</kbd> is now much faster,
+    on the order of 20x or 100x faster.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=286625">[% terms.Bug %] 286625</a>)
+  </li>
+  <li>For users of RHEL, CentOS, Fedora, etc. jobqueue.pl can now automatically
+    be installed as a daemon by running <kbd>./jobqueue.pl install</kbd>
+    as root. 
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=475403">[% terms.Bug %] 475403</a>)
+  </li>
+  <li>XML-RPC interface responses had an incorrect Content-Length header
+    and would sometimes be truncated, if they contained certain UTF-8
+    characters.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=486306">[% terms.Bug %] 486306</a>)
+  </li>
+  <li>Users who didn't have access to the time-tracking fields would get an
+    empty [% terms.bug %] update email when the time-tracking fields were
+    changed.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=509035">[% terms.Bug %] 509035</a>)
+  </li>
+  <li>In the New Charts, non-public series now no longer show up as selectable
+    if you cannot access them.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=389396">[% terms.Bug %] 389396</a>)
+  </li>
+</ul>
+
+<h3>3.4.1</h3>
+
+<p>This release contains an important security fix. See the
+  <a href="http://www.bugzilla.org/security/3.4/">Security Advisory</a>
+  for details.</p>
+
+<h2 id="v34_req">Minimum Requirements</h2>
+
+<p>Any requirements that are new since 3.2.3 will look like
+  <span class="req_new">this</span>.</p>
+
+<ul>
+  <li><a href="#v34_req_perl">Perl</a></li>
+  <li><a href="#v34_req_mysql">For MySQL Users</a></li>
+  <li><a href="#v34_req_pg">For PostgreSQL Users</a></li>
+  <li><a href="#v34_req_oracle">For Oracle Users</a></li>
+  <li><a href="#v34_req_modules">Required Perl Modules</a></li>
+  <li><a href="#v34_req_optional_mod">Optional Perl Modules</a></li>
+</ul>
+
+<h3 id="v34_req_perl">Perl</h3>
+
+<p>Perl v5.8.1</p>
+
+<h3 id="v34_req_mysql">For MySQL Users</h3> 
+ 
+<ul> 
+  <li>MySQL v4.1.2</li> 
+  <li><strong>perl module:</strong> DBD::mysql v4.00</li> 
+</ul>
+
+<h3 id="v34_req_pg">For PostgreSQL Users</h3> 
+ 
+<ul> 
+  <li>PostgreSQL v8.00.0000</li>
+  <li><strong>perl module:</strong> DBD::Pg v1.45</li>
+</ul>
+
+<h3 id="v34_req_oracle">For Oracle Users</h3>
+ 
+<ul> 
+  <li>Oracle v10.02.0</li>
+  <li><strong>perl module:</strong> DBD::Oracle v1.19</li>
+</ul> 
+ 
+<h3 id="v34_req_modules">Required Perl Modules</h3>
+
+<table class="req_table" border="0" cellspacing="0" cellpadding="0"> 
+  <tr> 
+    <th>Module</th> <th>Version</th> 
+  </tr> 
+  <tr> 
+    <td>CGI</td> 
+    <td>3.21</td> 
+  </tr> 
+  <tr> 
+    <td class="req_new">Digest::SHA</td> 
+    <td class="req_new"> (Any)</td> 
+  </tr> 
+  <tr> 
+    <td>Date::Format</td> 
+    <td>2.21</td> 
+  </tr> 
+  <tr> 
+    <td class="req_new">DateTime</td> 
+    <td class="req_new">0.28</td> 
+  </tr> 
+  <tr> 
+    <td class="req_new">DateTime::TimeZone</td> 
+    <td class="req_new">0.71</td> 
+  </tr> 
+  <tr> 
+    <td>DBI</td> 
+    <td>1.41</td> 
+  </tr> 
+  <tr> 
+    <td>Template</td> 
+    <td class="req_new">2.22</td> 
+  </tr>
+  <tr>
+    <td>Email::Send</td> 
+    <td>2.00</td> 
+  </tr> 
+  <tr> 
+    <td>Email::MIME</td> 
+    <td>1.861</td> 
+  </tr> 
+  <tr> 
+    <td>Email::MIME::Encodings</td> 
+    <td>1.313</td> 
+  </tr> 
+  <tr> 
+    <td>Email::MIME::Modifier</td> 
+    <td>1.442</td> 
+  </tr> 
+  <tr> 
+    <td class="req_new">URI</td> 
+    <td class="req_new">(Any)</td> 
+  </tr> 
+</table> 
+ 
+<h3 id="v34_req_optional_mod">Optional Perl Modules</h3> 
+ 
+<p>The following perl modules, if installed, enable various
+  features of [% terms.Bugzilla %]:</p>
+
+<table class="req_table" border="0" cellspacing="0" cellpadding="0"> 
+  <tr> 
+    <th>Module</th>
+    <th>Version</th> 
+    <th>Enables Feature</th> 
+  </tr> 
+  <tr> 
+    <td>LWP::UserAgent</td> 
+    <td>(Any)</td> 
+    <td>Automatic Update Notifications</td> 
+  </tr> 
+  <tr> 
+    <td>Template::Plugin::GD::Image</td> 
+    <td>(Any)</td> 
+    <td>Graphical Reports</td> 
+  </tr> 
+  <tr> 
+    <td>GD::Text</td> 
+    <td>(Any)</td> 
+    <td>Graphical Reports</td> 
+  </tr> 
+  <tr> 
+    <td>GD::Graph</td> 
+    <td>(Any)</td> 
+    <td>Graphical Reports</td> 
+  </tr> 
+  <tr> 
+    <td>GD</td> 
+    <td>1.20</td> 
+    <td>Graphical Reports, New Charts, Old Charts</td> 
+  </tr> 
+  <tr> 
+    <td>Email::MIME::Attachment::Stripper</td> 
+    <td>(Any)</td> 
+    <td>Inbound Email</td> 
+  </tr> 
+  <tr> 
+    <td>Email::Reply</td> 
+    <td>(Any)</td> 
+    <td>Inbound Email</td> 
+  </tr> 
+  <tr> 
+    <td>Net::LDAP</td> 
+    <td>(Any)</td> 
+    <td>LDAP Authentication</td> 
+  </tr> 
+  <tr> 
+    <td class="req_new">TheSchwartz</td> 
+    <td class="req_new">(Any)</td> 
+    <td>Mail Queueing</td> 
+  </tr> 
+  <tr> 
+    <td class="req_new">Daemon::Generic</td> 
+    <td class="req_new">(Any)</td> 
+    <td>Mail Queueing</td> 
+  </tr> 
+  <tr> 
+    <td>HTML::Parser</td> 
+    <td>3.40</td> 
+    <td>More HTML in Product/Group Descriptions</td> 
+  </tr> 
+  <tr> 
+    <td>HTML::Scrubber</td> 
+    <td>(Any)</td> 
+    <td>More HTML in Product/Group Descriptions</td> 
+  </tr> 
+  <tr> 
+    <td>XML::Twig</td> 
+    <td>(Any)</td> 
+    <td>Move [% terms.Bugs %] Between Installations</td> 
+  </tr> 
+  <tr> 
+    <td>MIME::Parser</td> 
+    <td>5.406</td> 
+    <td>Move [% terms.Bugs %] Between Installations</td> 
+  </tr> 
+  <tr> 
+    <td>Chart::Base</td> 
+    <td>1.0</td> 
+    <td>New Charts, Old Charts</td> 
+  </tr> 
+  <tr> 
+    <td>Image::Magick</td> 
+    <td>(Any)</td> 
+    <td>Optionally Convert BMP Attachments to PNGs</td> 
+  </tr> 
+  <tr> 
+    <td>PatchReader</td> 
+    <td>0.9.4</td> 
+    <td>Patch Viewer</td> 
+  </tr> 
+  <tr> 
+    <td>Authen::Radius</td> 
+    <td>(Any)</td> 
+    <td>RADIUS Authentication</td> 
+  </tr> 
+  <tr> 
+    <td>Authen::SASL</td> 
+    <td>(Any)</td> 
+    <td>SMTP Authentication</td> 
+  </tr> 
+  <tr> 
+    <td>SOAP::Lite</td> 
+    <td>0.710.06</td> 
+    <td>XML-RPC Interface</td> 
+  </tr> 
+  <tr> 
+    <td>mod_perl2</td> 
+    <td>1.999022</td> 
+    <td>mod_perl</td> 
+  </tr> 
+</table> 
+
+<h2 id="v34_feat">New Features and Improvements</h2>
+
+<ul>
+  <li><a href="#v34_feat_enter">Simple [% terms.Bug %] Filing</a></li>
+  <li><a href="#v34_feat_index">New Home Page</a></li>
+  <li><a href="#v34_feat_spam">Email Addresses Hidden From Logged-Out 
+    Users</a></li>
+  <li><a href="#v34_feat_urls">Shorter Search URLs</a></li>
+  <li><a href="#v34_feat_async">Asynchronous Email Sending</a></li>
+  <li><a href="#v34_feat_tz">Dates and Times Displayed In User's Time
+    Zone</a></li>
+  <li><a href="#v34_feat_vis">Custom Fields That Only Appear When
+    Another Field Has a Particular Value</a></li>
+  <li><a href="#v34_feat_vals">Custom Fields Whose List of Values
+    Change Depending on the Value of Another Field</a></li>
+  <li><a href="#v34_feat_bugid">New Custom Field Type: 
+    [%+ terms.Bug %] ID</a></li>
+  <li><a href="#v34_feat_see">"See Also" Field</a></li>
+  <li><a href="#v34_feat_cols">Re-order Columns in Search Results</a></li>
+  <li><a href="#v34_feat_desc">Search Descriptions</a></li>
+  <li><a href="#v34_feat_other">Other Enhancements and Changes</a></li>
+</ul>
+
+<h3 id="v34_feat_enter">Simple [% terms.Bug %] Filing</h3>
+
+<p>When entering a new [% terms.bug %], the vast majority of fields are
+  now hidden by default, which enormously simplifies the bug-filing form. 
+  You can click "Show Advanced Fields" to show all the fields, if you want
+  them. [%+ terms.Bugzilla %] remembers whether you last used the "Advanced"
+  or "Simple" version of the [% terms.bug %]-entry form, and will display the
+  same version to you again next time you file [% terms.abug %].</p>
+
+<h3 id="v34_feat_index">New Home Page</h3>
+
+<p>[% terms.Bugzilla %]'s front page has been redesigned to be better at
+  guiding new users into the activities that they most commonly want to
+  do. Further enhancements to the home page are coming in future versions
+  of [% terms.Bugzilla %].</p>
+
+<h3 id="v34_feat_spam">Email Addresses Hidden From Logged-Out Users</h3>
+
+<p>To help prevent spam to [% terms.Bugzilla %] users, all email addresses
+  stored in [% terms.Bugzilla %] are now displayed only if you are logged in.
+  If you are logged out, only the part before the "@" of the email address is
+  displayed. This includes [% terms.bug %] lists, viewing [% terms.bugs %], the
+  XML format of [% terms.abug %], and any other place in the web interface that
+  an email address could appear.</p>
+
+<p>Email addresses are not filtered out of [% terms.bug %] comments.
+  The WebService still returns full email addresses, even if you are logged
+  out.</p>
+
+<h3 id="v34_feat_urls">Shorter Search URLs</h3>
+
+<p>When submitting a search, all the unused fields are now stripped from
+  the URL, so search URLs are much more meaningful, and much shorter.</p>
+
+<h3 id="v34_feat_async">Asynchronous Email Sending</h3>
+
+<p>The largest performance problem in former versions of [% terms.Bugzilla %]
+  was that when updating [% terms.bugs %], email would be sent immediately
+  to every user who needed to be notified, and <kbd>process_bug.cgi</kbd>
+  would wait for the emails to be sent before continuing.</p>
+
+<p>Now [% terms.Bugzilla %] is capable of queueing emails to be sent
+  while [% terms.abug %] is being updated, and sending them in the
+  background. This requires the administrator to run a daemon
+  that comes with [% terms.Bugzilla %], named
+  <a href="[% docs_urlbase FILTER html %]api/jobqueue.html">jobqueue.pl</a>,
+  and to enable the <a href="editparams.cgi?section=mta#use_mailer_queue">
+  use_mailer_queue</a> parameter.</p>
+
+<p>Using the background email-sending daemon instead of sending mail directly
+  should result in a very large speed-up for updating [% terms.bugs %],
+  particularly on larger installations.</p>
+
+<h3 id="v34_feat_tz">Dates and Times Displayed In User's Time Zone</h3>
+
+<p>Users can now select what time zone they are in and [% terms.Bugzilla %]
+  will adjust displayed times to be correct for their time zone. However,
+  times the user inputs are unfortunately still in [% terms.Bugzilla %]'s
+  time zone.</p>
+
+<h3 id="v34_feat_vis">Custom Fields That Only Appear When Another Field
+    Has a Particular Value</h3>
+
+<p>When creating a new custom field (or updating the definition of
+  an existing custom field), you can now say that "this field only
+  appears when field X has value Y". (In the future, you will be able
+  to select multiple values for "Y", so a field will appear when any
+  one of those values is selected.)</p>
+
+<p>This feature only hides fields--it doesn't make their values go away.
+  So [% terms.bugs %] will still show up in searches for that field's
+  value, but the field won't appear in the user interface.</p>
+
+<p>This is a good way of making Product-specific fields.</p>
+
+<h3 id="v34_feat_vals">Custom Fields Whose List of Values Change
+    Depending on the Value of Another Field</h3>
+
+<p>When creating a drop-down or multiple-selection custom field, you can
+  now specify that another field "controls the values" of this field.
+  Then, when adding values to this field, you can say that a particular
+  value only appears when the other field is set to a particular
+  value.</p>
+
+<p>Here's an example: Let's say that we create a field called "Colors",
+  and we make the Product field "control the values" for Colors. Then we
+  add Blue, Red, Black, and Yellow as legal values for the "Colors" field.
+  Now we can say that "Blue" and "Red" only appear as valid choices in 
+  Product A, "Yellow" only appears in Product B, but "Black" <em>always</em>
+  appears.</p>
+
+<p>One thing to note is that this feature only controls what values appear in
+  the <em>user interface</em>. [% terms.Bugzilla %] itself will still accept
+  any combination of values as valid, in the backend.</p>
+
+<h3 id="v34_feat_bugid">New Custom Field Type: [% terms.Bug %] ID</h3>
+
+<p>You can now create a custom field that holds a reference to a single
+  valid [% terms.bug %] ID. In the future this will be enhanced to allow
+  [%+ terms.bugs %] to refer to each other via this field.</p>
+
+<h3 id="v34_feat_see">"See Also" Field</h3>
+
+<p>We have added a new standard field called "See Also" to 
+  [%+ terms.Bugzilla %]. In this field, you can put URLs to multiple 
+  [%+ terms.bugs %] in any [% terms.Bugzilla %] installation, to indicate
+  that those [% terms.bugs %] are related to this one. It also supports
+  adding URLs to [% terms.bugs %] in 
+  <a href="http://launchpad.net/">Launchpad</a>.</p>
+
+<p>Right now, the field just validates the URLs and then displays them, but
+  in the future, it will grab information from the other installation about
+  the [% terms.bug %] and display it here, and possibly even update the
+  other installation.</p>
+
+<p>If your installation does not need this field, you can hide it by disabling
+  the <a href="editparams.cgi?section=bugfields#use_see_also">use_see_also
+  parameter</a>.</p>
+
+<h3 id="v34_feat_cols">Re-order Columns in Search Results</h3>
+
+<p>There is a new interface for choosing what columns appear in search
+  results, which allows you to change the order in which columns appear
+  from left to right when viewing the [% terms.bug %] list.</p>
+
+<h3 id="v34_feat_desc">Search Descriptions</h3>
+
+<p>When displaying search results, [% terms.Bugzilla %] will now show
+  a brief description of what you searched for, at the top of the
+  [%+ terms.bug %] list.</p>
+
+<h3 id="v34_feat_other">Other Enhancements and Changes</h3>
+
+<h4>Enhancements for Users</h4>
+
+<ul>
+  <li>You can now log in from every page, using the login form that appears
+    in the header or footer when you click "Log In".</li>
+  <li>When viewing [% terms.abug %], obsolete attachments are now
+    hidden from the attachment list by default. You can show them
+    by clicking "Show Obsolete" at the bottom of the attachment list.</li>
+  <li>In the Email Preferences, you can now choose to get email when
+    a new [% terms.bug %] report is filed and you have a particular 
+    role on it.</li>
+  <li>When resolving a mid-air collision, you can now choose to submit
+    only your comment.</li>
+  <li>You can now set the Blocks and Depends On field on the "Change
+    Several [% terms.Bugs %] At Once" page.</li>
+  <li>If your installation uses the "insidergroup" feature, you can now add
+    private comments on the "Change Several [% terms.Bugs %] At Once" 
+    page.</li>
+  <li>When viewing a search result, you can now hover over any abbreviated
+    field to see its full value.</li>
+  <li>When logging out, users are now redirected to the main page of
+    [%+ terms.Bugzilla %] instead of an empty page.</li>
+  <li>When editing [% terms.abug %], text fields (except the comment box) now
+    grow longer when you widen your browser window.</li>
+  <li>When viewing [% terms.abug %], the Depends On and Blocks list will
+    display [% terms.abug %]'s alias if it has one, instead of its id.
+    Also, closed [% terms.bugs %] will be sorted to the end of the list.</li>
+
+  <li>If you use the time-tracking features of [% terms.Bugzilla %], and
+    you enable the time-tracking related columns in a search result,
+    then you will see a summary of the time-tracking data at the
+    bottom of the search result.</li>
+  <li>For users of time-tracking, the <kbd>summarize_time.cgi</kbd> page
+    now contains more data.</li>
+
+  <li>When viewing an attachment's details page while you are logged-out,
+    flags are no longer shown as editable.</li>
+  <li>Cloning [% terms.abug %] will now retain the "Blocks" and "Depends On"
+    fields from the [% terms.bug %] being cloned.</li>
+  <li>[% terms.Bug %]mail for new [% terms.bugs %] will now indicate
+    what security groups the [% terms.bug %] has been restricted to.</li>
+  <li>You can now use any custom drop-down field as an axis for a tabular
+    or graphical report.</li>
+  <li>The <kbd>X-Bugzilla-Type</kbd> header in emails sent by 
+    [%+ terms.Bugzilla %] is now "new" for [% terms.bug %]mail sent for
+    newly-filed [% terms.bugs %], and "changed" for emails having to do
+    with updated [% terms.bugs %].</li>
+  <li>Mails sent by the "Whining" system now contain the header
+    <kbd>X-Bugzilla-Type: whine</kbd>.</li>
+  <li>[% terms.bug %]mail now contains a X-Bugzilla-URL header to uniquely
+    identify which [% terms.Bugzilla %] installation the email came from.</li>
+  <li>If you input an invalid regular expression anywhere in
+    [%+ terms.Bugzilla %], it will now tell you explicitly instead of failing
+    cryptically.</li>
+  <li>The <kbd>duplicates.xul</kbd> page (which wasn't used by very many
+    people) is now gone.</li>
+</ul>
+
+<h4>Enhancements for Administrators and Developers</h4>
+
+<ul>
+  <li>[% terms.Bugzilla %] now uses the SHA-256 algorithm (a variant of 
+    SHA-2) to encrypt passwords in the database, instead of using Unix's
+    "crypt" function. This allows passwords longer than eight characters
+    to actually be effective. Each user's password will be converted to
+    SHA-256 the first time they log in after you upgrade to 
+    [%+ terms.Bugzilla %] 3.4 or later.</li>
+  <li>If you are using database replication with [% terms.Bugzilla %],
+    many more scripts now take advantage of the read-only slave (the 
+    "shadowdb"). It may be safe to open up <kbd>show_bug.cgi</kbd>
+    to search-engine indexing by editing your <kbd>robots.txt</kbd> file,
+    now, if your [% terms.Bugzilla %] is on fast-enough hardware.</li>
+  <li>The database now uses foreign keys to enforce the validity of
+    relationships between tables. Not every single table has all its 
+    foreign keys yet, but most do.</li>
+  <li>Various parameters have been removed, in an effort to de-clutter
+    the parameter interface and simplify [% terms.Bugzilla %]'s code.
+    The parameters that were removed were: timezone, supportwatchers,
+    maxpatchsize, commentonclearresolution, commentonreassignbycomponent,
+    showallproducts. They have all been replaced with sensible default
+    behaviors. (For example, user watching is now always enabled.)</li>
+  <li>When adding <code>&amp;debug=1</code> to the end of a 
+    <kbd>buglist.cgi</kbd> URL, [% terms.Bugzilla %] will now also do an
+    EXPLAIN on the query, to help debug performance issues.</li>
+  <li>When editing flag types in the administrative interface, you can now
+    see how many flags of each type have been set.</li>
+</ul>
+
+<h4>WebService Changes</h4>
+
+<ul>
+  <li>Various functions have been added to the WebService:
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/WebService/Bug.html#history">B[% %]ug.history</a>,
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/WebService/Bug.html#search">B[% %]ug.search</a>,
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/WebService/Bug.html#comments">B[% %]ug.comments</a>,
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/WebService/Bug.html#update_see_also">B[% %]ug.update_see_also</a>,
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/WebService/User.html#get">User.get</a>,
+    and <a href="[% docs_urlbase FILTER html %]api/Bugzilla/WebService/Bugzilla.html#time">B[% %]ugzilla.time</a>
+    (<kbd>B[% %]ugzilla.timezone</kbd> is now deprecated).
+  </li>
+  <li>For network efficiency, you can now limit which fields are returned 
+    from certain WebService functions, like <kbd>User.get</kbd>.</li>
+  <li>There is now a "permissive" argument for the <kbd>B[% %]ug.get</kbd>
+    WebService function, which causes it not to throw an error when you
+    ask for [% terms.bugs %] you can't see.</li>
+
+  <li>The <kbd>B[% %]ug.get</kbd> method now returns many more fields.</li>
+  <li>The <kbd>B[% %]ug.add_comment</kbd> method now returns the ID of the comment
+    that was just added.</li>
+  <li>The <kbd>B[% %]ug.add_comment</kbd> method will now throw an error if you
+    try to add a private comment but do not have the correct permissions.
+    (In previous versions, it would just silently ignore the <kbd>private</kbd>
+    argument if you didn't have the correct permissions.)</li>
+  <li>Many WebService function parameters now take individual values in
+    addition to arrays.</li>
+  <li>The WebService now validates input types--it makes sure that dates
+    are in the right format, that ints are actually ints, etc. It will throw
+    an error if you send it invalid data. It also accepts empty ints, doubles,
+    and dateTimes, and translates them to <kbd>undef</kbd>.</li>
+</ul>
+
+<h2 id="v34_issues">Outstanding Issues</h2>
+
+<ul>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=423439">
+    [%- terms.Bug %] 423439</a>: Tabs in comments will be converted
+    to four spaces, due to a b<!-- -->ug in Perl as of Perl 5.8.8.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=69621">
+    [%- terms.Bug %] 69621</a>: If you rename or remove a keyword that is
+    in use on [% terms.bugs %], you will need to rebuild the "keyword cache"
+    by running <a href="sanitycheck.cgi">sanitycheck.cgi</a> and choosing 
+    the option to rebuild the cache when it asks. Otherwise keywords may 
+    not show up properly in search results.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=89822">
+    [%- terms.Bug %] 89822</a>: When changing multiple [% terms.bugs %] at 
+    the same time, there is no "mid-air collision" protection.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=276230">
+    [%- terms.Bug %] 276230</a>: The support for restricting access to 
+    particular Categories of New Charts is not complete. You should treat 
+    the 'chartgroup' Param as the only access mechanism available.<br>
+    However, charts migrated from Old Charts will be restricted to 
+    the groups that are marked MANDATORY for the corresponding Product.
+    There is currently no way to change this restriction, and the 
+    groupings will not be updated if the group configuration
+    for the Product changes.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=370370">
+    [%- terms.Bug %] 370370</a>: mod_perl support is currently not
+    working on Windows machines.</li>
+</ul>
+
+<h2 id="v34_upgrading">Notes On Upgrading From a Previous Version</h2>
+
+<p>When upgrading to 3.4, <kbd>checksetup.pl</kbd> will create foreign keys
+  for many columns in the database. Before doing this, it will check the
+  database for consistency. If there are an unresolvable consistency
+  problems, it will tell you what table and column in the database contain
+  the bad values, and which values are bad. If you don't know what else to do,
+  you can always delete the database records which contain the bad values by
+  logging in to your database and running the following command:</p>
+
+<p><code>DELETE FROM <var>table</var> WHERE <var>column</var> IN 
+  (<var>1, 2, 3, 4</var>)</code></p>
+
+<p>Just replace "table" and "column" with the name of the table 
+  and column that <kbd>checksetup.pl</kbd> mentions, and "1, 2, 3, 4"
+  with the invalid values that <kbd>checksetup.pl</kbd> prints out.</p>
+
+<p>Remember that you should always back up your database before doing
+  an upgrade.</p>
+
+<h2 id="v34_code_changes">Code Changes Which May Affect Customizations</h2>
+
+<ul>
+  <li><kbd>checksetup.pl</kbd> now re-writes the <kbd>localconfig</kbd>
+    file every time it runs, keeping the current values set (if there
+    are any), but moving any unexpected variables into a file called
+    <kbd>localconfig.old</kbd>. If you want to continue having custom
+    varibles in <kbd>localconfig</kbd>, you will have to add them to
+    the <code>LOCALCONFIG_VARS</code> constant in 
+    <kbd>Bugzilla::Install::Localconfig</kbd>.</li>
+  <li><kbd>Bugzilla::Object-&gt;update()</kbd> now returns something different
+    in list context than it does in scalar context.</li>
+  <li><kbd>Bugzilla::Object-&gt;check()</kbd> now can take object
+    ids in addition to names. Just pass in <code>{ id =&gt; $some_value
+    }</code>.</li>
+  <li>Instead of being defined in <kbd>buglist.cgi</kbd>, columns for
+    search results are now defined in a subroutine called <code>COLUMNS</code>
+    in <kbd>Bugzilla::Search</kbd>. The data now mostly comes from the
+    <kbd>fielddefs</kbd> table in the database. Search.pm now takes a list
+    of column names from fielddefs for its <kbd>fields</kbd> argument instead 
+    of literal SQL columns.</li>
+  <li><kbd>Bugzilla::Field-&gt;legal_values</kbd> now returns an array of
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/Field/Choice.html">Bugzilla::Field::Choice</a>
+    objects instead of an array of strings. Bugzilla::Field::Choice will be used
+    in more places, in the future.</li>
+  <li>We now use <kbd>Bugzilla::Bug-&gt;check()</kbd> instead of 
+    <kbd>ValidateBugId</kbd>.</li>
+  <li>The <kbd>groups</kbd> and <kbd>bless_groups</kbd> methods in 
+    <kbd>Bugzilla::User</kbd> now return an arrayref of 
+    <kbd>Bugzilla::Group</kbd> objects instead of a hashref with
+    group ids and group names.</li>
+  <li>Standard [% terms.Bugzilla %] drop-down fields now have their type
+    set to <kbd>FIELD_TYPE_SINGLE_SELECT</kbd> in the fielddefs table.</li>
+  <li><kbd>Bugzilla-&gt;usage_mode</kbd> now defaults to 
+    <kbd>USAGE_MODE_CMDLINE</kbd> if we are not running inside a web
+    server.</li>
+  <li>We no longer delete environment variables like <kbd>$ENV{PATH}</kbd>
+    automatically unless we're actually running in taint mode.</li>
+  <li>We are now using YUI 2.6.0.</li>
+  <li>In <a href="config.cgi?ctype=rdf">the RDF format of config.cgi</a>,
+    the "resource" attribute for flags now contains "flag.cgi" instead
+    of "flags.cgi".</li>
+</ul>
+
+
+
+
+
+
+
+<h1 id="v34_previous">[% terms.Bugzilla %] 3.2 Release Notes</h1>
+
+<h2>Table of Contents</h2>
+
+<ul class="bz_toc">
+  <li><a href="#v32_introduction">Introduction</a></li>
+  <li><a href="#v32_point">Updates In This 3.2.x Release</a></li>
+  <li><a href="#v32_security">Security Fixes In This 3.2.x Release</a></li>
+  <li><a href="#v32_req">Minimum Requirements</a></li>
+  <li><a href="#v32_feat">New Features and Improvements</a></li>
+  <li><a href="#v32_issues">Outstanding Issues</a></li>
+  <li><a href="#v32_upgrading">How to Upgrade From An Older Version</a></li>
+  <li><a href="#v32_code_changes">Code Changes Which May Affect 
+    Customizations</a></li>
+  <li><a href="#v32_previous">Release Notes for Previous Versions</a></li>
+</ul>
+
+<h2 id="v32_introduction">Introduction</h2>
+
+<p>Welcome to [% terms.Bugzilla %] 3.2! This is our first major feature
+  release since [% terms.Bugzilla %] 3.0, and it brings a lot of great
+  improvements and polish to the [% terms.Bugzilla %] experience.</p>
+
+<p>If you're upgrading, make sure to read <a href="#v32_upgrading">How to
+  Upgrade From An Older Version</a>. If you are upgrading from a release
+  before 3.0, make sure to read the release notes for all the 
+  <a href="#v32_previous">previous versions</a> in between your version
+  and this one, <strong>particularly the "Notes For Upgraders" section of each
+  version's release notes</strong>.</p>
+
+<h2 id="v32_point">Updates in this 3.2.x Release</h2>
+
+<p>This section describes what's changed in the most recent b<!-- -->ug-fix
+  releases of [% terms.Bugzilla %] after 3.2. We only list the
+  most important fixes in each release. If you want a detailed list of
+  <em>everything</em> that's changed in each version, you should use our
+  <a href="http://www.bugzilla.org/status/changes.html">Change Log 
+  Page</a>.</p>
+
+<h3>3.2.3</h3>
+
+<ul>
+  <li>[% terms.Bugzilla %] is now compatible with MySQL 5.1.x versions 5.1.31
+    and greater.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=480001">[% terms.Bug %] 480001</a>)</li>
+  <li>On Windows, [% terms.Bugzilla %] sometimes would send mangled emails 
+    (that would often fail to send).
+  (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=467920">[% terms.Bug %] 467920</a>)</li>
+  <li><code>recode.pl</code> would sometimes crash when trying to convert
+    databases from older versions of [% terms.Bugzilla %].
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=431201">[% terms.Bug %] 431201</a>)</li>
+  <li>Running a saved search with Unicode characters in its name would
+    cause [% terms.Bugzilla %] to crash.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=477513">[% terms.Bug %] 477513</a>)</li>
+  <li>[% terms.Bugzilla %] clients like Mylyn can now update [% terms.bugs %]
+    again (the [% terms.bug %] XML format now contains a "token" element that
+    can be used when updating [% terms.abug %]).
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=476678">[% terms.Bug %] 476678</a>)</li>
+  <li>For installations using the <code>shadowdb</code> parameter, 
+    [%+ terms.Bugzilla %] was accidentally writing to the "tokens" table
+    in the shadow database (instead of the master database) when using the
+    "Change Several [% terms.Bugs %] at Once" page.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=476943">[% terms.Bug  %] 476943</a>)</li>
+</ul>
+
+<p>This release also contains a security fix. See the
+  <a href="#v32_security">Security Fixes Section</a> for details.</p>
+
+<h3>3.2.2</h3>
+
+<p>This release fixes one security issue that is critical for installations
+  running 3.2.1 under mod_perl. See the 
+  <a href="http://www.bugzilla.org/security/3.0.7/">Security Advisory</a>
+  for details.</p>
+
+<h3>3.2.1</h3>
+
+<ul>
+  <li>Attachments, charts, and graphs would sometimes be garbled on Windows.
+  (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=464992">[% terms.Bug %] 464992</a>)</li>
+
+  <li>Saving changes to parameters would sometimes fail silently (particularly
+    on Windows when the web server didn't have the right permissions to
+    update the <code>params</code> file). [% terms.Bugzilla %] will now
+    throw an error in this case, telling you what is wrong.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=347707">[% terms.Bug %] 347707</a>)</li>
+
+  <li>If you were using the <code>usemenuforusers</code> parameter,
+    and [% terms.abug %] was assigned to (or had a QA Contact of) a disabled
+    user, that field would be reset to the first user in the list when
+    updating [% terms.abug %].
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=465589">[% terms.Bug %] 465589</a>)</li>
+
+  <li>If you were using the <code>PROJECT</code> environment variable
+    to have multiple [% terms.Bugzilla %] installations using one codebase,
+    project-specific templates were being ignored. 
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=467324">[% terms.Bug %] 467324</a>)</li>
+
+  <li>Some versions of the SOAP::Lite Perl module had a b[% %]ug that caused
+    [%+ terms.Bugzilla %]'s XML-RPC service to break. 
+    <kbd>checksetup.pl</kbd> now checks for these bad versions and 
+    will reject them.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=468009">[% terms.Bug %] 468009</a>)</li>
+
+  <li>The font sizes in various places were too small, when using the
+    Classic skin.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=469136">[% terms.Bug %] 469136</a>)</li>
+</ul>
+
+<h2 id="v32_security">Security Fixes In This 3.2.x Release</h2>
+
+<h3>3.2.3</h3>
+
+<p>This release fixes one security issue related to attachments. See the
+  <a href="http://www.bugzilla.org/security/3.2.2/">Security Advisory</a>
+  for details.</p>
+
+<h3>3.2.2</h3>
+
+<p>This release fixes one security issue that is critical for installations
+  running 3.2.1 under mod_perl. See the 
+  <a href="http://www.bugzilla.org/security/3.0.7/">Security Advisory</a> 
+  for details.</p>
+
+<h3>3.2.1</h3>
+
+<p>This release contains several security fixes. One fix may break any
+  automated scripts you have that are loading <kbd>process_bug.cgi</kbd>
+  directly. We recommend that you read the entire 
+  <a href="http://www.bugzilla.org/security/2.22.6/">Security Advisory</a>
+  for this release.</p>
+
+<h2 id="v32_req">Minimum Requirements</h2>
+
+<p>Any requirements that are new since 3.0.5 will look like
+  <span class="req_new">this</span>.</p>
+
+<ul>
+  <li><a href="#v32_req_perl">Perl</a></li>
+  <li><a href="#v32_req_mysql">For MySQL Users</a></li>
+  <li><a href="#v32_req_pg">For PostgreSQL Users</a></li>
+  <li><a href="#v32_req_oracle">For Oracle Users</a></li>
+  <li><a href="#v32_req_modules">Required Perl Modules</a></li>
+  <li><a href="#v32_req_optional_mod">Optional Perl
+    Modules</a></li>
+</ul>
+
+<h3 id="v32_req_perl">Perl</h3>
+
+<p>Perl <span class="req_new">v<strong>5.8.1</strong></span></p>
+
+<h3 id="v32_req_mysql">For MySQL Users</h3>
+
+<ul>
+  <li>MySQL v4.1.2</li>
+    <li><strong>perl module:</strong>
+      DBD::mysql <span class="req_new">v4.00</span></li>
+</ul>
+
+<h3 id="v32_req_pg">For PostgreSQL Users</h3>
+
+<ul>
+  <li>PostgreSQL v8.00.0000</li>
+  <li><strong>perl module:</strong> DBD::Pg v1.45</li>
+</ul>
+
+<h3 id="v32_req_oracle">Email Addresses Hidden From Logged-Out Users
+    For Oracle Users</h3>
+
+<ul>
+  <li>Oracle v10.02.0</li>
+  <li><strong>perl module:</strong> DBD::Oracle v1.19</li>
+</ul>
+
+<h3 id="v32_req_modules">Required Perl Modules</h3>
+
+<table class="req_table" border="0" cellpadding="0" cellspacing="0">
+<tr> <th>Module</th>       <th>Version</th> </tr>
+<tr> <td>CGI</td>          <td class="req_new">3.21 (on Perl 5.8.x) 
+                             or 3.33 (on Perl 5.10.x)</td> </tr>
+<tr> <td>Date::Format</td> <td>2.21</td> </tr>
+<tr> <td>File::Spec</td>   <td>0.84</td> </tr>
+<tr> <td>DBI</td>          <td>1.41</td> </tr>
+<tr> <td>Template</td>     <td class="req_new">2.15</td> </tr>
+<tr> <td>Email::Send</td>  <td>2.00</td> </tr>
+<tr> <td>Email::MIME</td>  <td class="req_new">1.861</td> </tr>
+<tr> 
+  <td class="req_new">Email::MIME::Encodings</td> 
+  <td class="req_new">1.313</td>
+</tr>
+<tr>
+  <td>Email::MIME::Modifier</td> 
+  <td class="req_new">1.442</td>
+</tr>
+</table>
+
+<h3 id="v32_req_optional_mod">Optional Perl Modules</h3>
+
+<p>The following perl modules, if installed, enable various
+  features of [% terms.Bugzilla %]:</p>
+
+<table class="req_table" border="0" cellpadding="0" cellspacing="0">
+<tr> 
+  <th>Module</th>
+  <th>Version</th>
+  <th>Enables Feature</th>
+</tr>
+<tr>
+  <td>LWP::UserAgent</td>
+  <td>(Any)</td>
+  <td>Automatic Update Notifications</td>
+</tr>
+<tr>
+  <td>Template::Plugin::GD::Image</td> 
+  <td>(Any)</td> 
+  <td>Graphical Reports</td>
+</tr>
+<tr>
+  <td>GD::Text</td> 
+  <td>(Any)</td> 
+  <td>Graphical Reports</td>
+</tr>
+<tr>
+  <td>GD::Graph</td> 
+  <td>(Any)</td> 
+  <td>Graphical Reports</td>
+</tr>
+<tr>
+  <td>GD</td> 
+  <td>1.20</td> 
+  <td>Graphical Reports, New Charts, Old Charts</td>
+</tr>
+<tr>
+  <td>Email::MIME::Attachment::Stripper</td> 
+  <td>(Any)</td> 
+  <td>Inbound Email</td>
+</tr>
+<tr>
+  <td>Email::Reply</td> 
+  <td>(Any)</td> 
+  <td>Inbound Email</td>
+</tr>
+<tr>
+  <td>Net::LDAP</td> 
+  <td>(Any)</td> 
+  <td>LDAP Authentication</td>
+</tr>
+<tr>
+  <td>HTML::Parser</td> 
+  <td>3.40</td> 
+  <td>More HTML in Product/Group Descriptions</td>
+</tr>
+<tr>
+  <td>HTML::Scrubber</td> 
+  <td>(Any)</td> 
+  <td>More HTML in Product/Group Descriptions</td>
+</tr>
+<tr>
+  <td>XML::Twig</td> 
+  <td>(Any)</td> 
+  <td>Move [% terms.Bugs %] Between Installations</td>
+</tr>
+<tr>
+  <td>MIME::Parser</td> 
+  <td>5.406</td> 
+  <td>Move [% terms.Bugs %] Between Installations</td>
+</tr>
+<tr>
+  <td>Chart::Base</td> 
+  <td>1.0</td> 
+  <td>New Charts, Old Charts</td>
+</tr>
+<tr>
+  <td>Image::Magick</td> 
+  <td>(Any)</td> 
+  <td>Optionally Convert BMP Attachments to PNGs</td>
+</tr>
+<tr>
+  <td>PatchReader</td> 
+  <td>0.9.4</td> 
+  <td>Patch Viewer</td>
+</tr>
+<tr>
+  <td class="req_new">Authen::Radius</td> 
+  <td class="req_new">(Any)</td> 
+  <td>RADIUS Authentication</td>
+</tr>
+<tr>
+  <td class="req_new">Authen::SASL</td> 
+  <td class="req_new">(Any)</td> 
+  <td>SMTP Authentication</td>
+</tr>
+<tr>
+  <td>SOAP::Lite</td> 
+  <td>(Any)</td> 
+  <td>XML-RPC Interface</td>
+</tr>
+<tr>
+  <td>mod_perl2</td> 
+  <td>1.999022</td> 
+  <td>mod_perl</td>
+</tr>
+</table>
+
+<h2 id="v32_feat">New Features and Improvements</h2>
+
+<ul>
+  <li><a href="#v32_feat_ui">Major UI Improvements</a></li>
+  <li><a href="#v32_feat_skin">New Default Skin: Dusk</a></li>
+  <li><a href="#v32_feat_status">Custom Status Workflow</a></li>
+  <li><a href="#v32_feat_fields">New Custom Field Types</a></li>
+  <li><a href="#v32_feat_install">Easier Installation</a></li>
+  <li><a href="#v32_feat_oracle">Experimental Oracle Support</a></li>
+  <li><a href="#v32_feat_utf8">Improved UTF-8 Support</a></li>
+  <li><a href="#v32_feat_grcons">Group Icons</a></li>
+  <li><a href="#v32_feat_other">Other Enhancements and Changes</a></li>
+</ul>
+
+<h3 id="v32_feat_ui">Major UI Improvements</h3>
+
+<p>[% terms.Bugzilla %] 3.2 has had some UI assistance from the NASA
+  Human-Computer Interaction department and the new 
+  <a href="http://wiki.mozilla.org/Bugzilla:UE">[% terms.Bugzilla %]
+  User Interface Team</a>.</p>
+
+<p>In particular, you will notice a massively redesigned [% terms.bug %]
+  editing form, in addition to our <a href="#v32_feat_skin">new skin</a>.</p>
+
+<h3 id="v32_feat_skin">New Default Skin: Dusk</h3>
+
+<p>[% terms.Bugzilla %] 3.2 now ships with a skin called "Dusk" that is
+  a bit more colorful than old default "Classic" skin.</p>
+
+<p>Upgrading installations will still default to the "Classic" 
+  skin--administrators can change the default in the Default Preferences
+  control panel. Users can also choose to use the old skin in their
+  Preferences (or using the View :: Page Style menu in Firefox).</p>
+
+<p>The changes that [% terms.Bugzilla %] required for Dusk made
+  [%+ terms.Bugzilla %] much easier to skin. See the
+  <a href="http://wiki.mozilla.org/Bugzilla:Addons#Skins">Addons page</a>
+  for additional skins, or try making your own!</p>
+
+<h3 id="v32_feat_status">Custom Status Workflow</h3>
+
+<p>You can now customize the list of statuses in [% terms.Bugzilla %],
+  and transitions between them.</p>
+
+<p>You can also specify that a comment must be made on certain transitions.</p>
+
+<h3 id="v32_feat_fields">New Custom Field Types</h3>
+
+<p>[% terms.Bugzilla %] 3.2 has support for three new types of
+  custom fields:</p>
+
+<ul>
+  <li>Large Text: Adds a multi-line textbox to your [% terms.bugs %].</li>
+  <li>Multiple Selection Box: Adds a box that allows you to choose
+    multiple items from a list.</li>
+  <li>Date/Time: Displays a date and time, along with a JavaScript
+    calendar popup to make picking a date easier.</li>
+</ul>
+
+<h3 id="v32_feat_install">Easier Installation</h3>
+
+<p>[% terms.Bugzilla %] now comes with a script called 
+  <kbd>install-module.pl</kbd> that can automatically download
+  and install all of the required Perl modules for [% terms.Bugzilla %].
+  It stores them in a directory inside your [% terms.Bugzilla %]
+  installation, so you can use it even if you don't have administrator-level
+  access to your machine, and without modifying your main Perl install.</p>
+
+<p><kbd>checksetup.pl</kbd> will print out instructions for using
+  <kbd>install-module.pl</kbd>, or you can read its
+  <a href="[% docs_urlbase FILTER html %]api/install-module.html">documentation</a>.</p>
+
+<h3 id="v32_feat_oracle">Experimental Oracle Support</h3>
+
+<p>[% terms.Bugzilla %] 3.2 contains experimental support for using 
+  Oracle as its database. Some features of [% terms.Bugzilla %] are known 
+  to be broken on Oracle, but hopefully will be working by our next major
+  release.</p>
+
+<p>The [% terms.Bugzilla %] Project, as an open-source project, of course
+  does not recommend the use of proprietary database solutions. However,
+  if your organization requires that you use Oracle, this will allow
+  you to use [% terms.Bugzilla %]!</p>
+
+<p>The [% terms.Bugzilla %] Project thanks Oracle Corp. for their extensive
+  development contributions to [% terms.Bugzilla %] which allowed this to 
+  happen!</p>
+
+<h3 id="v32_feat_utf8">Improved UTF-8 Support</h3>
+
+<p>[% terms.Bugzilla %] 3.2 now has advanced UTF-8 support in its code,
+  including correct handling for truncating and wrapping multi-byte
+  languages. Major issues with multi-byte or unusual languages
+  are now resolved, and [% terms.Bugzilla %] should now be usable
+  by users in every country with little (or at least much less)
+  customization.</p>
+
+<h3 id="v32_feat_grcons">Group Icons</h3>
+
+<p>Administrators can now specify that users who are in certain groups
+  should have an icon appear next to their name whenever they comment.
+  This is particularly useful for distinguishing developers from 
+  [%+ terms.bug %] reporters.</p>
+
+<h3 id="v32_feat_other">Other Enhancements and Changes</h3>
+
+<p>These are either minor enhancements, or enhancements that have
+  very short descriptions. Some of these are very useful, though!</p>
+
+<h4>Enhancements For Users</h4>
+
+<ul>
+  <li><strong>[% terms.Bugs %]</strong>: You can now reassign
+    [%+ terms.abug %] at the same time as you are changing its status.</li>
+  <li><strong>[% terms.Bugs %]</strong>: When entering [% terms.abug %], 
+    you will now see the description of a component when you select it.</li>
+  <li><strong>[% terms.Bugs %]</strong>: The [% terms.bug %] view now 
+    contains some <a href="http://microformats.org/about/">Microformats</a>,
+    most notably for users' names and email addresses.</li>
+  <li><strong>[% terms.Bugs %]</strong>: You can now remove a QA Contact
+    from [% terms.abug %] simply by clearing the QA Contact field.</li>
+  <li><strong>[% terms.Bugs %]</strong>: There is now a user preference 
+    that will allow you to exclude the quoted text when replying 
+    to comments.</li>
+  <li><strong>[% terms.Bugs %]</strong>: You can now expand or collapse
+    individual comments in the [% terms.bug %] view.</li>
+
+  <li><strong>Attachments</strong>: There is now "mid-air collision" 
+      protection when editing attachments.</li>
+  <li><strong>Attachments</strong>: Patches in the Diff Viewer now show 
+    line numbers (<a href="https://bugzilla.mozilla.org/attachment.cgi?id=327546">Example</a>).</li>
+  <li><strong>Attachments</strong>: After creating or updating an attachment,
+    you will be immediately shown the [% terms.bug %] that the attachment
+    is on.</li>
+
+  <li><strong>Search</strong>: You can now reverse the sort of 
+    [%+ terms.abug %] list by clicking on a column header again.</li>
+  <li><strong>Search</strong>: Atom feeds of [% terms.bug %] lists now
+    contain more fields.</li>
+  <li><strong>Search</strong>: QuickSearch now supports searching flags
+    and groups. It also now includes the OS field in the list of fields
+    it searches by default.</li>
+  <li><strong>Search</strong>: "Help" text can now appear on query.cgi 
+    for Internet Explorer and other non-Firefox browsers. (It always
+    could appear for Firefox.)</li>
+
+  <li>[% terms.Bugzilla %] now ships with an icon that will show
+    up next to the URL in most browsers. If you want to replace it,
+    it's in <kbd>images/favicon.ico</kbd>.</li>
+
+  <li>You can now set the Deadline when using "Change Several 
+    [%+ terms.Bugs %] At Once"</li>
+  <li><strong>Saved Searches</strong> now save their column list, so if 
+    you customize the list of columns and save your search, it will 
+    always contain those columns.</li>
+  <li><strong>Saved Searches</strong>: When you share a search, you can
+    now see how many users have subscribed to it, on 
+    <kbd>userprefs.cgi</kbd>.</li>
+  <li><strong>Saved Searches</strong>: You can now see what group a 
+    shared search was shared to, on the list of available shared searches
+    in <kbd>userprefs.cgi</kbd>.</li>
+  <li><strong>Flags</strong>: If your installation uses drop-down user 
+    lists, the flag requestee box will now contain only users who are 
+    actually allowed to take requests.</li>
+  <li><strong>Flags</strong>: If somebody makes a request to you, and you
+    change the requestee to somebody else, the requester is no longer set
+    to you. In other words, you can "redirect" requests and maintain the
+    original requester.</li>
+  <li><strong>Flags</strong>: Emails about flags now will thread properly
+    in email clients to be a part of [% terms.abug %]'s thread.</li>
+  <li>When using <kbd>email_in.pl</kbd>, you can now add users to the CC
+    list by just using <kbd>@cc</kbd> as the field name.</li>
+  <li>Many pages (particularly administrative pages) now contain links to
+    the relevant section of the [% terms.Bugzilla %] Guide, so you can read 
+    the documentation for that page.</li>
+  <li>Dependency Graphs should render more quickly, as they now (by default)
+    only include the same [% terms.bugs %] that you'd see in the dependency
+    tree.</li>
+</ul>
+
+<h4>Enhancements For Administrators</h4>
+
+<ul>
+  <li><strong>Admin UI</strong>: Instead of having the Administration 
+    Control Panel links in the footer, there is now just one link called 
+   "Administration" that takes you to a page that links to all the
+    administrative controls for [% terms.Bugzilla %].</li>
+  <li><strong>Admin UI</strong>: Administrative pages no longer display
+    confirmation pages, instead they redirect you to some useful page 
+    and display a message about what changed.</li>
+  <li><strong>Admin UI</strong>: The interface for editing group 
+     inheritance in <kbd>editgroups.cgi</kbd> is much clearer now.</li>
+  <li><strong>Admin UI</strong>: When editing a user, you can now see 
+    all the components where that user is the Default Assignee or Default
+    QA Contact.</li>
+
+  <li><strong>Email</strong>: For installations that use SMTP to send 
+    mail (as opposed to Sendmail), [%+ terms.Bugzilla %] now supports
+    SMTP Authentication, so that it can log in to your mail server 
+    before sending messages.</li>
+  <li><strong>Email</strong>: Using the "Test" mail delivery method now
+     creates a valid mbox file to make testing easier.</li>
+
+  <li><strong>Authentication</strong>: [% terms.Bugzilla %] now correctly 
+    handles LDAP records which contain multiple email addresses. (The first
+    email address in the list that is a valid [% terms.Bugzilla %] account 
+    will be used, or if this is a new user, the first email address in 
+    the list will be used.)</li>
+  <li><strong>Authentication</strong>: [% terms.Bugzilla %] can now take 
+    a list of LDAP servers to try in order until it gets a successful
+    connection.</li>
+  <li><strong>Authentication</strong>: [% terms.Bugzilla %] now supports 
+    RADIUS authentication.</li>
+
+  <li><strong>Security</strong>: The login cookie is now created as 
+    "HTTPOnly" so that it can't be read by possibly malicious scripts. 
+    Also, if SSL is enabled on your installation, the login cookie is
+    now only sent over SSL connections.</li>
+  <li><strong>Security</strong>: The <code>ssl</code> parameter now protects
+    every page a logged-in user accesses, when set to "authenticated sessions."
+    Also, SSL is now enforced appropriately in the WebServices interface when
+    the parameter is set.</li>
+
+  <li><strong>Database</strong>: [% terms.Bugzilla %] now uses transactions in 
+    the database instead of table locks. This should generally improve
+    performance with many concurrent users. It also means if there is
+    an unexpected error in the middle of a page, all database changes made
+    during that page will be rolled back.</li>
+  <li><strong>Database</strong>: You no longer have to set 
+    <code>max_packet_size</code> in MySQL to add large attachments. However,
+    you may need to set it manually if you restore a mysqldump into your
+    database.</li>
+
+  <li>New WebService functions:
+    <a href="[% docs_urlbase FILTER html %]api/Bugzilla/WebService/Bug.html">B<!-- -->ug.add_comment</a>
+    and <a href="[% docs_urlbase FILTER html %]api/Bugzilla/WebService/Bugzilla.html">Bugzilla.extensions</a>.</li>
+
+  <li>You can now delete custom fields, but only if they have never been
+    set on any [% terms.bug %].</li>
+  <li>There is now a <kbd>--reset-password</kbd> argument to 
+    <kbd>checksetup.pl</kbd> that allows you to reset a user's password
+    from the command line.</li>
+  <li>There is now a script called <kbd>sanitycheck.pl</kbd> that you can
+    run from the command line. It works just like <kbd>sanitycheck.cgi</kbd>.
+    By default, it only outputs anything if there's an error, so it's
+    ideal for administrators who want to run it nightly in a cron job.</li>
+  <li>The <kbd>strict_isolation</kbd> parameter now prevents you from setting
+    users who cannot see [% terms.abug %] as a CC, Assignee, or QA
+    Contact. Previously it only prevented you from adding users who
+    could not <em>edit</em> the [% terms.bug %].</li>
+  <li>Extensions can now add their own headers to the HTML &lt;head&gt;
+    for things like custom CSS and so on.</li>
+  <li><kbd>sanitycheck.cgi</kbd> has been templatized, meaning that the
+    entire [% terms.Bugzilla %] UI is now contained in templates.</li>
+  <li>When setting the <kbd>sslbase</kbd> parameter, you can now specify
+    a port number in the URL.</li>
+  <li>When importing [% terms.bugs %] using <kbd>importxml.pl</kbd>,
+    attachments will have their actual creator set as their creator,
+    instead of the person who exported the [% terms.bug %] from the other
+    system.</li>
+  <li>The voting system is off by default in new installs. This is to
+    prepare for the fact that it will be moved into an extension at
+    some point in the future.</li>
+  <li>The <code>shutdownhtml</code> parameter now works even when 
+    [%+ terms.Bugzilla %]'s database server is down.</li>
+</ul>
+
+<h3>Enhancements for Localizers (or Localized Installations)</h3>
+
+<ul>
+  <li>The documentation can now be localized--in other words, you can have
+    documentation installed for multiple languages at once and
+    [%+ terms.Bugzilla %] will link to the correct language in its internal
+    documentation links.</li>
+  <li>[% terms.Bugzilla %] no longer uses the <kbd>languages</kbd> parameter.
+    Instead it reads the <kbd>template/</kbd> directory to see which
+    languages are available.</li>
+  <li>Some of the messages printed by <kbd>checksetup.pl</kbd> can now
+    be localized. See <kbd>template/en/default/setup/strings.txt.pl</kbd>.
+</ul>
+
+<h2 id="v32_issues">Outstanding Issues</h2>
+
+<ul>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=423439">
+    [%- terms.Bug %] 423439</a>: Tabs in comments will be converted
+    to four spaces, due to a b<!-- -->ug in Perl as of Perl 5.8.8.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=69621">
+    [%- terms.Bug %] 69621</a>: If you rename or remove a keyword that is
+    in use on [% terms.bugs %], you will need to rebuild the "keyword cache"
+    by running <a href="sanitycheck.cgi">sanitycheck.cgi</a> and choosing 
+    the option to rebuild the cache when it asks. Otherwise keywords may 
+    not show up properly in search results.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=89822">
+    [%- terms.Bug %] 89822</a>: When changing multiple [% terms.bugs %] at 
+    the same time, there is no "mid-air collision" protection.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=276230">
+    [%- terms.Bug %] 276230</a>: The support for restricting access to 
+    particular Categories of New Charts is not complete. You should treat 
+    the 'chartgroup' Param as the only access mechanism available.<br>
+    However, charts migrated from Old Charts will be restricted to 
+    the groups that are marked MANDATORY for the corresponding Product.
+    There is currently no way to change this restriction, and the 
+    groupings will not be updated if the group configuration
+    for the Product changes.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=370370">
+    [%- terms.Bug %] 370370</a>: mod_perl support is currently not
+    working on Windows machines.</li>
+</ul>
+
+<h2 id="v32_upgrading">How to Upgrade From An Older Version</h2>
+
+<h3 id="v32_upgrading_notes">Notes For Upgraders</h3>
+
+<ul>
+  <li>If you upgrade by CVS, the <kbd>extensions</kbd> and 
+    <kbd>skins/contrib</kbd> directories are now in CVS instead of
+    being created by <kbd>checksetup.pl</kbd> If you do a <kbd>cvs update</kbd>
+    from 3.0, you will be told that your directories are "in the way" and
+    you should delete (or move) them and then do <kbd>cvs update</kbd>
+    again. Also, the <kbd>docs</kbd> directory has been restructured
+    and after you <kbd>cvs update</kbd> you can delete the <kbd>docs/html</kbd>,
+    <kbd>docs/pdf</kbd>, <kbd>docs/txt</kbd>, and <kbd>docs/xml</kbd>
+    directories.</li>
+  <li>If you are using MySQL, you should know that [% terms.Bugzilla %]
+    now uses InnoDB for all tables. <kbd>checksetup.pl</kbd> will convert
+    your tables automatically, but if you have InnoDB disabled,
+    the upgrade will not be able to complete (and <kbd>checksetup.pl</kbd>
+    will tell you so).</li>
+
+  <li><strong>You should also read the 
+    <a href="#v30_upgrading_notes">[% terms.Bugzilla %] 3.0 Notes For Upgraders
+    section</a> of the 
+    <a href="#v32_previous">previous release notes</a> if you are upgrading
+    from a version before 3.0.</strong></li>
+</ul>
+
+<h3>Steps For Upgrading</h3>
+
+<p>Once you have read the notes above, see the
+  <a href="[% docs_urlbase FILTER html %]upgrade.html">Upgrading 
+  documentation</a> for instructions on how to upgrade.</p>
+
+<h2 id="v32_code_changes">Code Changes Which May Affect Customizations</h2>
+
+<ul>
+  <li><a href="#v32_code_hooks">More Hooks!</a></li>
+  <li><a href="#v32_code_search">Search.pm Rearchitecture</a></li>
+  <li><a href="#v32_code_lib">lib Directory</a></li>
+  <li><a href="#v32_code_other">Other Changes</a></li>
+</ul>
+
+<h3 id="v32_code_hooks">More Hooks!</h3>
+
+<p>There are more code hooks in 3.2 than there were in 3.0. See the
+  documentation of <a href="[% docs_urlbase FILTER html %]api/Bugzilla/Hook.html">Bugzilla::Hook</a>
+  for more details.</p>
+
+<h3 id="v32_code_search">Search.pm Rearchitecture</h3>
+
+<p><kbd>Bugzilla/Search.pm</kbd> has been heavily modified, to be much
+  easier to read and use. It contains mostly the same code as it did in
+  3.0, but it has been moved around and reorganized significantly.</p>
+
+<h3 id="v32_code_lib">lib Directory</h3>
+
+<p>As part of implementing <a href="#v32_feat_install">install-module.pl</a>,
+  [%+ terms.Bugzilla %] was given a local <kbd>lib</kbd> directory which
+  it searches for modules, in addition to the standard system path.</p>
+
+<p>This means that all [% terms.Bugzilla %] scripts now start with
+  <code>use lib qw(. lib);</code> as one of the first lines.</p>
+
+<h3 id="v32_code_other">Other Changes</h3>
+
+<ul>
+  <li>You should now be using <code>get_status('NEW')</code> instead of
+    <code>status_descs.NEW</code> in templates.</li>
+  <li>The <code>[&#37;# version = 1.0 &#37;]</code> comment at the top of every
+    template file has been removed.</li>
+</ul>
+
+<h1 id="v32_previous">[% terms.Bugzilla %] 3.0.x Release Notes</h1>
+
+<h2>Table of Contents</h2>
+
+<ul class="bz_toc">
+  <li><a href="#v30_introduction">Introduction</a></li>
+  <li><a href="#v30_point">Updates In This 3.0.x Release</a></li>
+  <li><a href="#v30_req">Minimum Requirements</a></li>
+  <li><a href="#v30_feat">New Features and Improvements</a></li>
+  <li><a href="#v30_issues">Outstanding Issues</a></li>
+  <li><a href="#v30_security">Security Fixes In This Release</a></li>
+  <li><a href="#v30_upgrading">How to Upgrade From An Older Version</a></li>
+  <li><a href="#v30_code_changes">Code Changes Which May Affect 
+    Customizations</a></li>
+  <li><a href="#v30_previous">Release Notes for Previous Versions</a></li>
+</ul>
+
+<h2 id="v30_introduction">Introduction</h2>
+
+<p>Welcome to [% terms.Bugzilla %] 3.0! It's been over eight years since
+  we released [% terms.Bugzilla %] 2.0, and everything has changed since
+  then. Even just since our previous release, [% terms.Bugzilla %] 2.22,
+  we've added a <em>lot</em> of new features. So enjoy the release, we're
+  happy to bring it to you.</p>
+
+<p>If you're upgrading, make sure to read <a href="#v30_upgrading">How to
+  Upgrade From An Older Version</a>. If you are upgrading from a release
+  before 2.22, make sure to read the release notes for all the 
+  <a href="#v30_previous">previous versions</a> in between your version 
+  and this one.</p>
+
+<h2 id="v30_point">Updates in this 3.0.x Release</h2>
+
+<p>This section describes what's changed in the most recent b<!-- -->ug-fix
+  releases of [% terms.Bugzilla %] after 3.0. We only list the
+  most important fixes in each release. If you want a detailed list of
+  <em>everything</em> that's changed in each version, you should use our
+  <a href="http://www.bugzilla.org/status/changes.html">Change Log Page</a>.</p>
+
+<h3>3.0.6</h3>
+
+<ul>
+  <li>Before 3.0.6, unexpected fatal WebService errors would result in
+    a <code>faultCode</code> that was a string instead of a number.
+   (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=446327">[% terms.Bug %] 446327</a>)</li>
+  <li>If you created a product or component with the same name as one you
+    previously deleted, it would fail with an error about the series table.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=247936">[% terms.Bug %] 247936</a>)</li>
+</ul>
+
+<p>See also the <a href="#v30_security">Security Advisory</a> section for
+  information about a security issue fixed in this release.</p>
+
+<h3>3.0.5</h3>
+
+<ul>
+  <li>If you don't have permission to set a flag, it will now appear
+    unchangeable in the UI.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=433851">[% terms.Bug %] 433851</a>)</li>
+  <li>If you were running mod_perl, [% terms.Bugzilla %] was not correctly
+    closing its connections to the database since 3.0.3, and so sometimes
+    the DB would run out of connections.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=441592">[% terms.Bug %] 441592</a>)</li>
+  <li>The installation script is now clear about exactly which 
+    <code>Email::</code> modules are required in Perl, thus avoiding the
+    problem where emails show up with a body like 
+    <samp>SCALAR(0xBF126795)</samp>.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=441541">[% terms.Bug %] 441541</a>)</li>
+  <li><a href="[% docs_urlbase FILTER html %]api/email_in.html">email_in.pl</a>
+    is no longer case-sensitive for values of <kbd>@product</kbd>.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=365697">[% terms.Bug %] 365697</a>)</li>
+</ul>
+
+<p>See also the <a href="#v30_security">Security Advisory</a> section for
+  information about security issues fixed in this release.</p>
+
+<h3>3.0.4</h3>
+
+<ul>
+  <li>[% terms.Bugzilla %] administrators were not being correctly notified
+    about new releases.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=414726">[% terms.Bug %] 414726</a>)</li>
+
+  <li>There could be extra whitespace in email subject lines.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=411544">[% terms.Bug %] 411544</a>)</li>
+
+  <li>The priority, severity, OS, and platform fields were always required by
+    the <kbd>B<!-- -->ug.create</kbd> WebService function, even if they had
+    defaults specified.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=384009">[% terms.Bug %] 384009</a>)</li>
+
+  <li>Better threading of [% terms.bug %]mail in some email clients.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=376453">[% terms.Bug %] 376453</a>)</li>
+
+  <li>There were many fixes to the Inbound Email Interface 
+    (<kbd>email_in.pl</kbd>).
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=92274">[% terms.Bug %] 92274</a>,
+     <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=377025">[% terms.Bug %] 377025</a>,
+     <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=412943">[% terms.Bug %] 412943</a>,
+     <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=413672">[% terms.Bug %] 413672</a>, and
+     <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=431721">[% terms.Bug %] 431721</a>)</li>
+
+  <li><kbd>checksetup.pl</kbd> now handles UTF-8 conversion more reliably during upgrades.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=374951">[% terms.Bug %] 374951</a>)</li>
+
+  <li>Comments written in CJK languages are now correctly word-wrapped.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=388723">[% terms.Bug %] 388723</a>)</li>
+
+  <li>All emails will now be sent in the correct language, when the user
+    has chosen a language for emails.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=405946">[% terms.Bug %] 405946</a>)
+
+  <li>On Windows, temporary files created when uploading attachments are now
+    correctly deleted when the upload is complete.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=414002">[% terms.Bug %] 414002</a>)</li>
+
+  <li><kbd>checksetup.pl</kbd> now prints correct installation instructions
+    for Windows users using Perl 5.10.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=414430">[% terms.Bug %] 414430</a>)
+</ul>
+
+<p>See also the <a href="#v30_security">Security Advisory</a> section for
+  information about security issues fixed in this release.</p>
+
+<h3>3.0.3</h3>
+
+<ul>
+  <li>mod_perl no longer compiles [% terms.Bugzilla %]'s code for each Apache
+    process individually. It now compiles code only once and shares it among
+    each Apache process. This greatly improves performance and highly 
+    decreases the memory footprint.
+   (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=398241">[% terms.Bug %] 398241</a>)</li>
+
+  <li>You can now search for '---' (without quotes) in versions and milestones.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=362436">[% terms.Bug %] 362436</a>)</li>
+
+  <li>[% terms.Bugzilla %] should no longer break lines unnecessarily in 
+    email subjects. This was causing trouble with some email clients.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=374424">[% terms.Bug %] 374424</a>)</li>
+
+  <li>If you had selected "I'm added to or removed from this capacity" option
+    for the "CC" role in your email preferences, you wouldn't get mail when
+    more than one person was added to the CC list at once.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=394796">[% terms.Bug %] 394796</a>)</li>
+
+  <li>Deleting a user account no longer deletes whines from another user who
+    has the deleted account as addressee. The schedule is simply removed, 
+    but the whine itself is left intact.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=395924">[% terms.Bug %] 395924</a>)</li>
+
+  <li><kbd>contrib/merge-users.pl</kbd> now correctly merges all required
+    fields when merging two user accounts.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=400160">[% terms.Bug %] 400160</a>)</li>
+
+  <li>[% terms.Bugzilla %] no longer requires Apache::DBI to run under 
+    mod_perl. It caused troubles such as lost connections with the DB and
+    didn't give any important performance gain.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=408766">[% terms.Bug %] 408766</a>)</li>
+</ul>
+
+<h3>3.0.2</h3>
+
+<ul>
+  <li>[% terms.Bugzilla %] should now work on Perl 5.9.5 (and thus the
+    upcoming Perl 5.10.0).
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=390442">[% terms.Bug %] 390442</a>)</li>
+</ul>
+
+<p>See also the <a href="#v30_security">Security Advisory</a> section for
+  information about an important security issue fixed in this release.</p>
+
+<h3>3.0.1</h3>
+
+<ul>
+  <li>For users of Firefox 2, the <code>show_bug.cgi</code> user interface
+    should no longer "collapse" after you modify [% terms.abug %].
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=370739">[% terms.Bug %] 370739</a>)</li>
+  <li>If you can bless a group, and you share a saved search with that
+    group, it will no longer automatically appear in all of that group's
+    footers unless you specifically request that it automatically appear
+    in their footers.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=365890">[% terms.Bug %] 365890</a>)</li>
+  <li>There is now a parameter to allow users to perform searches without
+    any search terms. (In other words, to search for just a Product
+    and Status on the Simple Search page.) The parameter is called
+    <code>specific_search_allow_empty_words</code>.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=385910">[% terms.Bug %] 385910</a>)</li>
+  <li>If you attach a file that has a MIME-type of <code>text/x-patch</code>
+    or <code>text/x-diff</code>, it will automatically be treated as a 
+    patch by [% terms.Bugzilla %].
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=365756">[% terms.Bug %] 365756</a>)</li>
+  <li>Dependency Graphs now work correctly on all mod_perl installations.
+    There should now be no remaining signficant problems with running
+    [%+ terms.Bugzilla %] under mod_perl.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=370398">[% terms.Bug %] 370398</a>)</li>
+  <li>If moving [% terms.abug %] between products would remove groups
+    from the [% terms.bug %], you are now warned.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=303183">[% terms.Bug %] 303183</a>)</li>
+  <li>On IIS, whenever [% terms.Bugzilla %] threw a warning, it would
+    actually appear on the web page. Now warnings are suppressed,
+    unless you have a file in the <code>data</code> directory called
+    <code>errorlog</code>, in which case warnings will be printed there.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=390148">[% terms.Bug %] 390148</a>)</li>
+  <li>If you used <kbd>email_in.pl</kbd> to edit [% terms.abug %] that was
+    protected by groups, all of the groups would be cleared.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=385453">[% terms.Bug %] 385453</a>)</li>
+  <li>PostgreSQL users: New Charts were failing to collect data over time.
+    They will now start collecting data correctly.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=257351">[% terms.Bug %] 257351</a>)</li>
+  <li>Some flag mails didn't specify who the requestee was. 
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=379787">[% terms.Bug %] 379787</a>)</li>
+  <li>Instead of throwing real errors, <kbd>collectstats.pl</kbd> would
+    just say that it couldn't find <code>ThrowUserError</code>.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=380709">[% terms.Bug %] 380709</a>)</li>
+  <li>Logging into [% terms.Bugzilla %] from the home page works again
+    with IIS5. 
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=364008">[% terms.Bug %] 364008</a>)</li>
+  <li>If you were using SMTP for sending email, sometimes emails would
+    be missing the <code>Date</code> header.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=304999">[% terms.Bug %] 304999</a>).</li>
+  <li>In the XML-RPC WebService, <code>B<!-- -->ug.legal_values</code> now
+    correctly returns values for custom fields if you request values 
+    for custom fields.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=381737">[% terms.Bug %] 381737</a>)</li>
+  <li>The "[% terms.Bug %]-Writing Guidelines" page has been shortened
+    and re-written.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=378590">[% terms.Bug %] 378590</a>)</li>
+  <li>If your <code>urlbase</code> parameter included a port number,
+    like <code>www.domain.com:8080</code>, SMTP might have failed.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=384501">[% terms.Bug %] 384501</a>)</li>
+  <li>For SMTP users, there is a new parameter, <code>smtp_debug</code>.
+    Turning on this parameter will log the full information about
+    every SMTP session to your web server's error log, to help with
+    debugging issues with SMTP.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=384497">[% terms.Bug %] 384497</a>)</li>
+  <li>If you are a "global watcher" (you get all mails from every 
+    [%+ terms.bug %]), you can now see that in your Email Preferences.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=365302">[% terms.Bug %] 365302</a>)</li>
+  <li>The Status and Resolution of [% terms.bugs %] are now correctly
+    localized in CSV search results.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=389517">[% terms.Bug %] 389517</a>)</li>
+  <li>The "Subject" line of an email was being mangled if it contained
+    non-Latin characters.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=387860">[% terms.Bug %] 387860</a>)</li>
+  <li>Editing the "languages" parameter using <kbd>editparams.cgi</kbd> would
+    sometimes fail, causing [% terms.Bugzilla %] to throw an error.
+    (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=335354">[% terms.Bug %] 335354</a>)</li>
+</ul>
+
+<h2 id="v30_req">Minimum Requirements</h2>
+
+<p>Any requirements that are new since 2.22 will look like
+  <span class="req_new">this</span>.</p>
+
+<ul>
+  <li><a href="#v30_req_perl">Perl</a></li>
+  <li><a href="#v30_req_mysql">For MySQL Users</a></li>
+  <li><a href="#v30_req_pg">For PostgreSQL Users</a></li>
+  <li><a href="#v30_req_modules">Required Perl Modules</a></li>
+  <li><a href="#v30_req_optional_mod">Optional Perl
+    Modules</a></li>
+</ul>
+
+
+<h3 id="v30_req_perl">Perl</h3>
+
+<ul>
+  <li>Perl <span class="req_new">v<strong>5.8.0</strong></span> (non-Windows 
+    platforms)</li>
+  <li>Perl v<strong>5.8.1</strong> (Windows platforms)</li>
+</ul>
+
+<h3 id="v30_req_mysql">For MySQL Users</h3>
+
+<ul>
+  <li>MySQL <span class="req_new">v4.1.2</span></li>
+  <li><strong>perl module:</strong> DBD::mysql v2.9003</li>
+</ul>
+
+<h3 id="v30_req_pg">For PostgreSQL Users</h3>
+
+<ul>
+  <li>PostgreSQL v8.00.0000</li>
+  <li><strong>perl module:</strong> DBD::Pg v1.45</li>
+</ul>
+
+<h3 id="v30_req_modules">Required Perl Modules</h3>
+
+<table class="req_table" border="0" cellspacing="0" cellpadding="0">
+  <tr>
+    <th>Module</th> <th>Version</th>
+  </tr>
+    <tr><td>CGI</td> <td>2.93</td>
+  </tr>
+  <tr>
+    <td>Date::Format</td> <td>2.21</td>
+  </tr>
+  <tr>
+    <td>DBI</td> 
+    <td class="req_new">1.41</td>
+  </tr>
+  <tr>
+    <td>File::Spec</td> <td>0.84</td>
+  </tr>
+  <tr>
+    <td>Template</td> <td>2.12</td>
+  </tr>
+  <tr>
+    <td class="req_new">Email::Send</td> 
+    <td class="req_new">2.00</td>
+  </tr>
+  <tr>
+    <td>Email::MIME</td> 
+    <td>1.861</td>
+  </tr>
+  <tr>
+    <td class="req_new">Email::MIME::Modifier</td> 
+    <td class="req_new">1.442</td>
+  </tr>
+</table>
+
+<h3 id="v30_req_optional_mod">Optional Perl Modules</h3>
+
+<p>The following perl modules, if installed, enable various
+  features of [% terms.Bugzilla %]:</p>
+
+<table class="req_table" border="0" cellspacing="0" cellpadding="0">
+  <tr>
+    <th>Module</th> <th>Version</th>
+    <th>Enables Feature</th>
+  </tr>
+   <tr>
+     <td class="req_new">LWP::UserAgent</td> 
+     <td class="req_new">(Any)</td> 
+     <td>Automatic Update Notifications</td>
+  </tr>
+  <tr>
+    <td>Template::Plugin::GD::Image</td> 
+    <td>(Any)</td> 
+    <td>Graphical Reports</td>
+  </tr>
+  <tr>
+    <td>GD::Graph</td> 
+    <td>(Any)</td> 
+    <td>Graphical Reports</td>
+  </tr>
+  <tr>
+    <td>GD::Text</td> 
+    <td>(Any)</td> 
+    <td>Graphical Reports</td>
+  </tr>
+  <tr>
+    <td>GD</td> 
+    <td>1.20</td> 
+    <td>Graphical Reports, New Charts, Old Charts</td>
+  </tr>
+  <tr>
+    <td class="req_new">Email::MIME::Attachment::Stripper</td> 
+    <td class="req_new">(Any)</td> 
+    <td>Inbound Email</td>
+  </tr>
+  <tr>
+    <td class="req_new">Email::Reply</td> 
+    <td class="req_new">(Any)</td> 
+    <td>Inbound Email</td>
+  </tr>
+  <tr>
+    <td>Net::LDAP</td> 
+    <td>(Any)</td> 
+    <td>LDAP Authentication</td>
+  </tr>
+  <tr>
+    <td>HTML::Parser</td> 
+    <td>3.40</td> 
+    <td>More HTML in Product/Group Descriptions</td>
+  </tr>
+  <tr>
+    <td>HTML::Scrubber</td> 
+    <td>(Any)</td> 
+    <td>More HTML in Product/Group Descriptions</td>
+  </tr>
+  <tr>
+    <td>XML::Twig</td> 
+    <td>(Any)</td> 
+    <td>Move [% terms.Bugs %] Between Installations</td>
+  </tr>
+  <tr>
+    <td>MIME::Parser</td> 
+    <td>5.406</td> 
+    <td>Move [% terms.Bugs %] Between Installations</td>
+  </tr>
+  <tr>
+    <td>Chart::Base</td> 
+    <td>1.0</td> 
+    <td>New Charts, Old Charts</td>
+  </tr>
+  <tr>
+    <td>Image::Magick</td> 
+    <td>(Any)</td> 
+    <td>Optionally Convert BMP Attachments to PNGs</td>
+  </tr>
+  <tr>
+    <td>PatchReader</td> 
+    <td>0.9.4</td> 
+    <td>Patch Viewer</td>
+  </tr>
+  <tr>
+    <td class="req_new">SOAP::Lite</td> 
+    <td class="req_new">(Any)</td> 
+    <td>XML-RPC Interface</td>
+  </tr>
+  <tr>
+    <td class="req_new">mod_perl2</td> 
+    <td class="req_new">1.999022</td> 
+    <td>mod_perl</td>
+  </tr>
+  <tr>
+    <td> CGI</td> 
+    <td>3.11</td> 
+    <td>mod_perl</td>
+  </tr>
+</table>
+
+<h2 id="v30_feat">New Features and Improvements</h2>
+
+<ul>
+  <li><a href="#v30_feat_cf">Custom Fields</a></li>
+  <li><a href="#v30_feat_mp">mod_perl Support</a></li>
+  <li><a href="#v30_feat_sq">Shared Saved Searches</a></li>
+  <li>
+    <a href="#v30_feat_afn">Attachments and Flags on New [% terms.Bugs %]</a>
+  </li>
+  <li><a href="#v30_feat_cr">Custom Resolutions</a></li>
+  <li><a href="#v30_feat_ppp">Per-Product Permissions</a></li>
+  <li><a href="#v30_feat_ui">User Interface Improvements</a></li>
+  <li><a href="#v30_feat_xml">XML-RPC Interface</a></li>
+  <li><a href="#v30_feat_skin">Skins</a></li>
+  <li><a href="#v30_feat_sbu">Unchangeable Fields Appear 
+    Unchangeable</a></li>
+  <li><a href="#v30_feat_et">All Emails in Templates</a></li>
+  <li><a href="#v30_feat_df">No More Double-Filed [% terms.Bugs %]</a></li>
+  <li><a href="#v30_feat_cc">Default CC List for Components</a></li>
+  <li><a href="#v30_feat_emi">File/Modify [% terms.Bugs %] By Email</a></li>
+  <li><a href="#v30_feat_gw">Users Who Get All [% terms.Bug %] 
+    Notifications</a></li>
+  <li><a href="#v30_feat_utf8">Improved UTF-8 Support</a></li>
+  <li><a href="#v30_feat_upda">Automatic Update Notification</a></li>
+  <li><a href="#v30_feat_welc">Welcome Page for New Installs</a></li>
+  <li><a href="#v30_feat_other">Other Enhancements and Changes</a></li>
+</ul>
+
+<h3 id="v30_feat_cf">Custom Fields</h3>
+
+<p>[% terms.Bugzilla %] now includes very basic support for custom fields.</p>
+
+<p>Users in the <kbd>admin</kbd> group can add plain-text or drop-down
+  custom fields. You can edit the values available for drop-down fields
+  using the &quot;Field Values&quot; control panel.</p>
+
+<p>Don't add too many custom fields! It can make [% terms.Bugzilla %]
+  very difficult to use. Try your best to get along with the default
+  fields, and then if you find that you can't live without custom fields
+  after a few weeks of using [% terms.Bugzilla %], only then should you
+  start your custom fields.</p>
+
+<h3 id="v30_feat_mp">mod_perl Support</h3>
+
+<p>[% terms.Bugzilla %] 3.0 supports mod_perl, which allows for extremely
+  enhanced page-load performance. mod_perl trades memory usage for performance,
+  allowing near-instantaneous page loads, but using much more memory.</p>
+
+<p>If you want to enable mod_perl for your [% terms.Bugzilla %], we recommend
+  a minimum of 1.5GB of RAM, and for a site with heavy traffic, 4GB to 8GB.</p>
+
+<p>If performance isn't that critical on your installation, you don't
+  have the memory, or you are running some other web server than
+  Apache, [% terms.Bugzilla %] still runs perfectly as a normal CGI
+  application, as well.</p>
+
+<h3 id="v30_feat_sq">Shared Saved Searches</h3>
+
+<p>Users can now choose to &quot;share&quot; their saved searches
+  with a certain group. That group will then be able to 
+  &quot;subscribe&quot; to those searches, and have them appear
+  in their footer.</p>
+
+<p>If the sharer can &quot;bless&quot; the group he's sharing to,
+  (that is, if he can add users to that group), it's considered
+  that he's a manager of that group, and his queries show up
+  automatically in that group's footer (although they can
+  unsubscribe from any particular search, if they want.)</p>
+
+<p>In order to allow a user to share their queries, they also
+  have to be a member of the group specified in the 
+  <code>querysharegroup</code> parameter.</p>
+
+<p>Users can control their shared and subscribed queries from
+  the &quot;Preferences&quot; screen.</p>
+
+<h3 id="v30_feat_afn">Attachments and Flags on New [% terms.Bugs %]</h3>
+
+<p>You can now add an attachment while you are filing a new 
+  [%+ terms.bug %].</p>
+
+<p>You can also set flags on the [% terms.bug %] and on attachments, while
+  filing a new [% terms.bug %].</p>
+
+<h3 id="v30_feat_cr">Custom Resolutions</h3>
+
+<p>You can now customize the list of resolutions available
+  in [% terms.Bugzilla %], including renaming the default resolutions.</p>
+
+<p>The resolutions <code>FIXED</code>, <code>DUPLICATE</code>
+  and <code>MOVED</code> have a special meaning to [% terms.Bugzilla %],
+  though, and cannot be renamed or deleted.</p>
+
+<h3 id="v30_feat_ppp">Per-Product Permissions</h3>
+
+<p>You can now grant users <kbd>editbugs</kbd> and <kbd>canconfirm</kbd>
+  for only certain products. You can also grant users <kbd>editcomponents</kbd>
+  on a product, which means they will be able to edit that product
+  including adding/removing components and other product-specific
+  controls.</p>
+
+<h3 id="v30_feat_ui">User Interface Improvements</h3>
+
+<p>There has been some work on the user interface for [% terms.Bugzilla %] 3.0,
+  including:</p>
+
+<ul>
+  <li>There is now navigation and a search box a the <em>top</em> of
+    each page, in addition to the bar at the bottom of the page.</li>
+  <li>A re-designed &quot;Format for Printing&quot; page for 
+    [%+ terms.bugs %].</li>
+  <li>The layout of <kbd>show_bug.cgi</kbd> (the [% terms.bug %] editing 
+    page) has been changed, and the attachment table has been redesigned.</li>
+</ul>
+
+<h3 id="v30_feat_xml">XML-RPC Interface</h3>
+
+<p>[% terms.Bugzilla %] now has a Web Services interface using the XML-RPC
+  protocol. It can be accessed by external applications by going
+  to the <kbd>xmlrpc.cgi</kbd> on your installation.</p>
+
+<p>Documentation can be found in the 
+  <a href="[% docs_urlbase FILTER html %]api/">[% terms.Bugzilla %] 
+  API Docs</a>, in the various <kbd>Bugzilla::WebService</kbd> modules.</p>
+
+<h3 id="v30_feat_skin">Skins</h3>
+
+<p>[% terms.Bugzilla %] can have multiple &quot;skins&quot; installed,
+  and users can pick between them. To write a skin, you just have to
+  write several CSS files. See the <a href="[% docs_urlbase FILTER html %]cust-skins.html">Custom
+  Skins Documentation</a> for more details.</p>
+
+<p>We currently don't have any alternate skins shipping with
+  [%+ terms.Bugzilla %]. If you write an alternate skin, please
+  let us know!</p>
+
+<h3 id="v30_feat_sbu">Unchangeable Fields Appear Unchangeable</h3>
+
+<p>As long as you are logged in, when viewing [% terms.abug %], if you 
+  cannot change a field, it will not look like you can change it. That 
+  is, the value will just appear as plain text.</p>
+
+<h3 id="v30_feat_et">All Emails in Templates</h3>
+
+<p>All outbound emails are now controlled by the templating system.
+  What used to be the <code>passwordmail</code>, <code>whinemail</code>,
+  <code>newchangedmail</code> and <code>voteremovedmail</code>
+  parameters are now all templates in the <kbd>template/</kbd> directory.</p>
+
+<p>This means that it's now much easier to customize your outbound
+  emails, and it's also possible for localizers to have more
+  localized emails as part of their language packs, if they want.</p>
+
+<p>We also added a <code>mailfrom</code> parameter to let you set
+  who shows up in the <code>From</code> field on all emails that
+  [%+ terms.Bugzilla %] sends.</p>
+
+<h3 id="v30_feat_df">No More Double-Filed [% terms.Bugs %]</h3>
+
+<p>Users of [% terms.Bugzilla %] will sometimes accidentally submit 
+  [%+ terms.abug %] twice, either by going back in their web browser, 
+  or just by refreshing a page. In the past, this could file the same 
+  [%+ terms.bug %] twice (or even three times) in a row, irritating 
+  developers and confusing users.</p>
+
+<p>Now, if you try to submit [% terms.abug %] twice from the same screen 
+  (by going back or by refreshing the page), [% terms.Bugzilla %] will warn 
+  you about what you're doing, before it actually submits the duplicate
+  [%+ terms.bug %].</p>
+
+<h3 id="v30_feat_cc">Default CC List for Components</h3>
+
+<p>You can specify a list of users who will <em>always</em> be added to
+  the CC list of new [% terms.bugs %] in a component.</p>
+
+<h3 id="v30_feat_emi">File/Modify [% terms.Bugs %] By Email</h3>
+
+<p>You can now file or modify [% terms.bugs %] via email. Previous versions
+  of [% terms.Bugzilla %] included this feature only as an
+  unsupported add-on, but it is now an official interface to
+  [%+ terms.Bugzilla %].</p>
+
+<p>For more details see the <a href="[% docs_urlbase FILTER html %]api/email_in.html">documentation
+  for email_in.pl</a>.</p>
+
+<h3 id="v30_feat_gw">Users Who Get All [% terms.Bug %] Notifications</h3>
+
+<p>There is now a parameter called <kbd>globalwatchers</kbd>. This
+  is a comma-separated list of [% terms.Bugzilla %] users who will
+  get all [% terms.bug %] notifications generated by [% terms.Bugzilla %].</p>
+
+<p>Group controls still apply, though, so users who can't see [% terms.abug %]
+  still won't get notifications about that [% terms.bug %].</p>
+
+<h3 id="v30_feat_utf8">Improved UTF-8 Support</h3>
+
+<p>[% terms.Bugzilla %] users running MySQL should now have excellent
+  UTF-8 support if they turn on the <kbd>utf8</kbd> parameter. (New
+  installs have this parameter on by default.) [% terms.Bugzilla %]
+  now correctly supports searching and sorting in non-English languages,
+  including multi-bytes languages such as Chinese.</p>
+
+<h3 id="v30_feat_upda">Automatic Update Notification</h3>
+
+<p>If you belong to the <kbd>admin</kbd> group, you will be notified
+  when you log in if there is a new release of [% terms.Bugzilla %]
+  available to download.</p>
+
+<p>You can control these notifications by changing the 
+  <kbd>upgrade_notification</kbd> parameter.</p>
+
+<p>If your [% terms.Bugzilla %] installation is on a machine that needs to go
+  through a proxy to access the web, you may also have to set the
+  <kbd>proxy_url</kbd> parameter.</p>
+
+<h3 id="v30_feat_welc">Welcome Page for New Installs</h3>
+
+<p>When you log in for the first time on a brand-new [% terms.Bugzilla %]
+  installation, you will be presented with a page that describes
+  where you should go from here, and what parameters you should set.</p>
+
+<h3 id="v30_feat_qs">QuickSearch Plugin for IE7 and Firefox 2</h3>
+
+<p>Firefox 2 users and Internet Explorer 7 users will be presented
+  with the option to add [% terms.Bugzilla %] to their search bar.
+  This uses the 
+  <a href="page.cgi?id=quicksearch.html">QuickSearch syntax</a>.</p>
+
+<h3 id="v30_feat_other">Other Enhancements and Changes</h3>
+
+<p>These are either minor enhancements, or enhancements that have
+  very short descriptions. Some of these are very useful, though!</p>
+
+<h4>Enhancements That Affect [% terms.Bugzilla %] Users</h4>
+
+<ul>
+  <li>In comments, quoted text (lines that start with <kbd>&gt;</kbd>)
+    will be a different color from normal text.</li>
+  <li>There is now a user preference that will add you to the CC list
+    of any [% terms.bug %] you modify. Note that it's <strong>on</strong> 
+    by default.</li>
+  <li>[% terms.Bugs %] can now be filed with an initial state of 
+    <kbd>ASSIGNED</kbd>, if you are in the <kbd>editbugs</kbd> group.</li>
+  <li>By default, comment fields will zoom large when you are typing in them,
+    and become small when you move out of them. You can disable this
+    in your user preferences.</li>
+  <li>You can hide obsolete attachments on [% terms.abug %] by clicking
+    &quot;Hide Obsolete&quot; at the bottom of the attachment table.</li>
+  <li>If [% terms.abug %] has flags set, and you move it to a different 
+    product that has flags with the same name, the flags will be 
+    preserved.</li>
+  <li>You now can't request a flag to be set by somebody who can't set it
+    ([% terms.Bugzilla %] will throw an error if you try).</li>
+  <li>Many new headers have been added to outbound [% terms.Bugzilla %]
+    [%+ terms.bug %] emails: <code>X-Bugzilla-Status</code>,
+    <code>X-Bugzilla-Priority</code>, <code>X-Bugzilla-Assigned-To</code>,
+    <code>X-Bugzilla-Target-Milestone</code>, and 
+    <code>X-Bugzilla-Changed-Fields</code>, <code>X-Bugzilla-Who</code>.
+    You can look at an email to get an idea of what they contain.</li>
+  <li>In addition to the old <code>X-Bugzilla-Reason</code> email header
+    which tells you why you got an email, if you got an email because
+    you were watching somebody, there is now an 
+    <code>X-Bugzilla-Watch-Reason</code> header that tells you who you
+    were watching and what role they had.</li>
+  <li>If you hover your mouse over a full URL (like 
+    <code>http://bugs.mycompany.com/show_bug.cgi?id=1212</code>) that 
+    links to [% terms.abug %], you will see the title of the 
+    [%+ terms.bug %]. Of course, this only works for [% terms.bugs %] in your
+    [%+ terms.Bugzilla %] installation.</li>
+  <li>If your installation has user watching enabled, you will now see
+    the users that you can remove from your watch-list as a multi-select
+    box, much like the current CC list. (Previously it was just a text
+    box.)</li>
+  <li>When a user creates their own account in [% terms.Bugzilla %], the 
+    account is now not actually created until they verify their email
+    address by clicking on a link that is emailed to them.</li>
+  <li>You can change [% terms.abug %]'s resolution without reopening it.</li>
+  <li>When you view the dependency tree on [% terms.abug %], resolved 
+    [%+ terms.bugs %] will be hidden by default. (In previous versions,
+    resolved [% terms.bugs %] were shown by default.)</li>
+  <li>When viewing [% terms.bug %] activity, fields that hold [% terms.bug %] 
+    numbers (such as &quot;Blocks&quot;) will have the [% terms.bug %] numbers
+    displayed as links to those [% terms.bugs %].</li>
+  <li>When viewing the &quot;Keywords&quot; field in [% terms.abug %] list,
+    it will be sorted alphabetically, so you can sanely sort a list on
+    that field.</li>
+  <li>In most places, the Version field is now sorted using a version-sort
+    (so 1.10 is greater than 1.2) instead of an alphabetical sort.</li>
+  <li>Options for flags will only appear if you can set them. So, for
+    example, if you can't grant <kbd>+</kbd> on a flag, that option
+    won't appear for you.</li>
+  <li>You can limit the product-related output of <kbd>config.cgi</kbd>
+    by specifying a <kbd>product=</kbd> URL argument, containing the name
+    of a product. You can specify the argument more than once for multiple
+    products.</li>
+  <li>You can now search the boolean charts on whether or not a comment
+    is private.</li>
+</ul>
+
+<h4>Enhancements For Administrators</h4>
+
+<ul>
+  <li>Administrators can now delete attachments, making them disappear
+    entirely from [% terms.Bugzilla %].</li>
+  <li><kbd>sanitycheck.cgi</kbd> can now only be accessed by users
+    in the <kbd>editcomponents</kbd> group.</li>
+  <li>The &quot;Field Values&quot; control panel can now only be accessed
+    by users in the <kbd>admin</kbd> group. (Previously it was accessible
+    to anybody in the <kbd>editcomponents</kbd> group.)</li>
+  <li>There is a new parameter <kbd>announcehtml</kbd>, that will allow
+    you to enter some HTML that will be displayed at the top of every
+    page, as an announcement.</li>
+  <li>The <kbd>loginnetmask</kbd> parameter now defaults to 0 for new
+    installations, meaning that as long as somebody has the right
+    login cookie, they can log in from any IP address. This makes
+    life a lot easier for dial-up users or other users whose IP
+    changes a lot. This could be done because the login cookie is now
+    very random, and thus secure.</li>
+  <li>Classifications now have sortkeys, so they can be sorted in an
+    order that isn't alphabetical.</li>
+  <li>Authentication now supports LDAP over SSL (LDAPS) or TLS (using
+    the STARTLS command) in addition to plain LDAP.</li>
+  <li>LDAP users can have their LDAP username be their email address,
+    instead of having the LDAP <kbd>mail</kbd> attribute be their
+    email address. You may wish to set the <kbd>emailsuffix</kbd>
+    parameter if you do this.</li>
+  <li>Administrators can now see what has changed in a user account,
+    when using the &quot;Users&quot; control panel.</li>
+  <li><code>REMIND</code> and <code>LATER</code> are no longer part
+    of the default list of resolutions. Upgrading installations will
+    not be affected--they will still have these resolutions.</li>
+  <li><kbd>editbugs</kbd> is now the default for the <kbd>timetrackinggroup</kbd>
+    parameter, meaning that time-tracking will be on by default in a new
+    installation.</li>
+</ul>
+
+<h2 id="v30_issues">Outstanding Issues</h2>
+
+<ul>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=69621">
+    [%- terms.Bug %] 69621</a>: If you rename or remove a keyword that is
+    in use on [% terms.bugs %], you will need to rebuild the "keyword cache"
+    by running <a href="sanitycheck.cgi">sanitycheck.cgi</a> and choosing 
+    the option to rebuild the cache when it asks. Otherwise keywords may 
+    not show up properly in search results.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=99215">
+    [%- terms.Bug %] 99215</a>: Flags are not protected by "mid-air 
+    collision" detection. Nor are any attachment changes.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=89822">
+    [%- terms.Bug %] 89822</a>: When changing multiple [% terms.bugs %] at 
+    the same time, there is no "mid-air collision" protection.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=276230">
+    [%- terms.Bug %] 276230</a>: The support for restricting access to 
+    particular Categories of New Charts is not complete. You should treat 
+    the 'chartgroup' Param as the only access mechanism available.<br>
+    However, charts migrated from Old Charts will be restricted to 
+    the groups that are marked MANDATORY for the corresponding Product.
+    There is currently no way to change this restriction, and the 
+    groupings will not be updated if the group configuration
+    for the Product changes.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=370370">
+    [%- terms.Bug %] 370370</a>: mod_perl support is currently not
+    working on Windows machines.</li>
+  <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=361149">
+    [%- terms.Bug %] 361149</a>: If you are using Perl 5.8.0, you may
+    get a lot of warnings in your Apache error_log about "deprecated
+    pseudo-hashes." These are harmless--they are a b[%# fool test %]ug in 
+    Perl 5.8.0. Perl 5.8.1 and later do not have this problem.</li>
+  <li>[% terms.Bugzilla %] 3.0rc1 allowed custom field column names in 
+    the database to be mixed-case. [% terms.Bugzilla %] 3.0 only allows
+    lowercase column names. It will fix any column names that you have
+    made mixed-case, but if you have custom fields that previously were
+    mixed-case in any Saved Search, you will have to re-create that Saved
+    Search yourself.</li>
+</ul>
+
+<h2 id="v30_security">Security Updates in This Release</h2>
+
+<h3>3.0.6</h3>
+
+<p>[% terms.Bugzilla %] contains a minor security fix. For details, see the
+  <a href="http://www.bugzilla.org/security/2.20.6/">Security Advisory</a>.</p>
+
+<h3>3.0.5</h3>
+
+<p>[% terms.Bugzilla %] contains one security fix for 
+  <a href="[% docs_urlbase FILTER html %]api/importxml.html">importxml.pl</a>.
+  For details, see the 
+  <a href="http://www.bugzilla.org/security/2.22.4/">Security Advisory</a>.</p>
+
+<h3>3.0.4</h3>
+
+<p>[% terms.Bugzilla %] 3.0.4 contains three security fixes.
+  For details, see the
+  <a href="http://www.bugzilla.org/security/2.20.5/">Security Advisory</a>.</p>
+
+<h3>3.0.3</h3>
+
+<p>No security fixes in this release.</p>
+
+<h3>3.0.2</h3>
+
+<p>[% terms.Bugzilla %] 3.0.1 had an important security fix that is
+  critical for public installations with "requirelogin" turned on.
+  For details, see the
+  <a href="http://www.bugzilla.org/security/3.0.1/">Security Advisory</a></p>
+
+<h3>3.0.1</h3>
+
+<p>[% terms.Bugzilla %] 3.0 had three security issues that have been
+  fixed in this release: one minor information leak, one hole only
+  exploitable by an admin or using <code>email_in.pl</code>, and one in an
+  uncommonly-used template. For details, see the 
+  <a href="http://www.bugzilla.org/security/2.20.4/">Security Advisory</a>.</p>
+
+<h2 id="v30_upgrading">How to Upgrade From An Older Version</h2>
+
+<h3 id="v30_upgrading_notes">Notes For Upgraders</h3>
+
+<ul>
+  <li>If you upgrade by CVS, there are several .cvsignore files
+    that are now in CVS instead of being locally created by 
+    <kbd>checksetup.pl</kbd>. This means that you will have to
+    delete those files when CVS tells you there's a conflict, and
+    then run <kbd>cvs update</kbd> again.</li>
+  <li>In this version of [% terms.Bugzilla %], the Summary field
+    is now limited to 255 characters. When you upgrade, any Summary
+    longer than that will be truncated, and the old summary will be
+    preserved in a comment.</li>
+  <li>If you have the <kbd>utf8</kbd> parameter turned on, at some
+    point you will have to convert your database. <kbd>checksetup.pl</kbd>
+    will tell you when this is, and it will give you certain instructions
+    at that time, that you have to follow before you can complete
+    the upgrade. Don't do the conversion yourself manually--follow
+    the instructions of <kbd>checksetup.pl</kbd>.</li>
+  <li>If you ever ran 2.23.3, 2.23.4, or 3.0rc1, you will have to run
+    <kbd>./collectstats.pl --regenerate</kbd> at the command line, because
+    the data for your Old Charts is corrupted. This can take several days,
+    so you may only want to run it if you use Old Charts.</li>
+  <li>You should also read the Outstanding Issues sections of
+    <a href="#v30_previous">older release notes</a> if you are upgrading
+    from a version lower than 2.22.</li>
+</ul>
+
+<h3>Steps For Upgrading</h3>
+
+<p>Once you have read the notes above, see the 
+  <a href="[% docs_urlbase FILTER html %]upgrade.html">Upgrading 
+  documentation</a> for instructions on how to upgrade.</p>
+
+<h2 id="v30_code_changes">Code Changes Which May Affect Customizations</h2>
+
+<ul>
+  <li><a href="#v30_code_loc"><strong>Packagers:</strong> Location
+    Variables Have Moved</a></li>
+  <li><a href="#v30_code_hooks">Hooks!</a></li>
+  <li><a href="#v30_code_api">API Documentation</a></li>
+  <li><a href="#v30_code_globals">Elimination of globals.pl</a></li>
+  <li><a href="#v30_code_scope">Cleaned Up Variable Scoping Issues</a></li>
+  <li><a href="#v30_code_sql">No More SendSQL</a></li>
+  <li><a href="#v30_code_auth">Auth Re-write</a></li>
+  <li><a href="#v30_code_obj">Bugzilla::Object</a></li>
+  <li><a href="#v30_code_req">Bugzilla-&gt;request_cache</a></li>
+  <li><a href="#v30_code_other">Other Changes</a></li>
+</ul>
+
+<h3 id="v30_code_loc"><strong>Packagers:</strong> Location Variables
+    Have Moved</h3>
+
+<p>In previous versions of [% terms.Bugzilla %], <kbd>Bugzilla::Config</kbd>
+  held all the paths for different things, such as the path to localconfig
+  and the path to the <kbd>data/</kbd> directory.</p>
+
+<p>Now, all of this data is stored in a subroutine,
+  <kbd>Bugzilla::Constants::bz_locations</kbd>.</p>
+
+<p>Also, note that for mod_perl, <kbd>bz_locations</kbd> must return
+  <em>absolute</em> (not relative) paths. There is already code in that
+  subroutine to help you with this.</p>
+
+<h3 id="v30_code_hooks">Hooks!</h3>
+
+<p>[% terms.Bugzilla %] now supports a code hook mechanism. See the 
+  documentation for 
+  <a href="[% docs_urlbase FILTER html %]api/Bugzilla/Hook.html">Bugzilla::Hook</a>
+  for more details.</p>
+
+<p>This gives [% terms.Bugzilla %] very advanced plugin support. You can
+  hook templates, hook code, add new parameters, and use the XML-RPC
+  interface. So we'd like to see some [% terms.Bugzilla %] plugins
+  written! Let us know on the <a href="http://bugzilla.org/cgi-bin/mj_wwwusr?func=lists-long-full&amp;extra=developers">developers&#64;bugzilla.org</a>
+  mailing list if you write a plugin.</p>
+
+<p>If you need more hooks, please 
+  <a href="http://www.bugzilla.org/developers/reporting_bugs.html">File a b<!-- -->ug</a>!</p>
+
+<h3 id="v30_code_api">API Documentation</h3>
+
+<p>[% terms.Bugzilla %] now ships with all of its perldoc built
+  as HTML. Go ahead and read the
+  <a href="[% docs_urlbase FILTER html %]api/">API Documentation</a>
+  for all of the [% terms.Bugzilla %] modules now! Even scripts like
+  <kbd>checksetup.pl</kbd> have HTML documentation.</p>
+
+<h3 id="v30_code_globals">Elimination of globals.pl</h3>
+
+<p>The old file <kbd>globals.pl</kbd> has been eliminated.
+  Its code is now in various modules. Each function went to the module
+  that was appropriate for it.</p>
+
+<p>Usually we filed [% terms.abug %] in 
+  <a href="https://bugzilla.mozilla.org">bugzilla.mozilla.org</a> for
+  each function we moved. You can search there for the old name of
+  the function, and that should get you the information about what
+  it's called now and where it lives.</p>
+
+<h3 id="v30_code_scope">Cleaned Up Variable Scoping Issues</h3>
+
+<p>In normal perl, you can have code like this:</p>
+<pre>my $var = 0;
+sub y { $var++ }</pre>
+
+<p>However, under mod_perl that doesn't work. So variables are no
+  longer &quot;shared&quot; with subroutines--instead all variables
+  that a subroutine needs must be declared inside the subroutine itself.</p>
+
+<h3 id="v30_code_sql">No More SendSQL</h3>
+
+<p>The old <kbd>SendSQL</kbd> function and all of its companions are
+  <strong>gone</strong>. Instead, we now use DBI for all database
+  interaction.</p>
+
+<p>For more information about how to use 
+  <a href="http://search.cpan.org/perldoc?DBI">DBI</a> with 
+  [%+ terms.Bugzilla %], see the 
+  <a href="http://www.bugzilla.org/docs/developer.html#sql-sendreceive">Developer's
+  Guide Section About DBI</a></p>
+
+<h3 id="v30_code_auth">Auth Re-write</h3>
+
+<p>The <kbd>Bugzilla::Auth</kbd> family of modules have been completely
+  re-written. For details on how the new structure of authentication,
+  read the 
+  <a href="[% docs_urlbase FILTER html %]api/Bugzilla/Auth.html">Bugzilla::Auth
+  API docs</a>.</p>
+
+<p>It should be very easy to write new authentication plugins, now.</p>
+
+<h3 id="v30_code_obj">Bugzilla::Object</h3>
+
+<p>There is a new base class for most of our objects, 
+  <a href="[% docs_urlbase FILTER html %]api/Bugzilla/Object.html">Bugzilla::Object</a>.
+  It makes it really easy to create new objects based on things that are 
+  in the database.</p>
+
+<h3 id="v30_code_req">Bugzilla-&gt;request-cache</h3>
+
+<p><kbd>Bugzilla.pm</kbd> used to cache things like the database
+  connection in package-global variables (like <kbd>$_dbh</kbd>).
+  That doesn't work in mod_perl, so instead now there's a hash
+  that can be accessed through <code>Bugzilla-&gt;request_cache</code>
+  to store things for the rest of the current page request.</p>
+
+<p>You shouldn't access <code>Bugzilla-&gt;request_cache</code> directly,
+  but you should use it inside of <kbd>Bugzilla.pm</kbd> if you modify
+  that. The only time you should be accessing it directly is if you need
+  to reset one of the caches. Hash keys are always named after the function
+  that they cache, so to reset the template object, you'd do:
+  <code>delete Bugzilla-&gt;request_cache-&gt;{template};</code>.</p>
+
+<h3 id="v30_code_other">Other Changes</h3>
+
+<ul>
+  <li><kbd>checksetup.pl</kbd> has been completely re-written, and most
+    of its code moved into modules in the <kbd>Bugzilla::Install</kbd>
+    namespace. See the
+    <a href="[% docs_urlbase FILTER html %]api/checksetup.html">checksetup
+    documentation</a> and <a href="https://bugzilla.mozilla.org/showdependencytree.cgi?id=277502&amp;hide_resolved=0">[% terms.Bugzilla %]
+   [%+ terms.bug %] 277502</a> for details.</li>
+  <li>Instead of <kbd>UserInGroup()</kbd>, all of [% terms.Bugzilla %] now 
+    uses <kbd>Bugzilla-&gt;user-&gt;in_group</kbd></li>
+  <li>mod_perl doesn't like dependency loops in modules, so we now have
+    a test for that detects dependency loops in modules when you run
+   <kbd>runtests.pl</kbd>.</li>
+  <li><kbd>globals.pl</kbd> used to modify the environment variables,
+    like <kbd>PATH</kbd>. That now happens in <kbd>Bugzilla.pm</kbd>.</li>
+  <li>Templates can now link to the documentation more easily.
+    See the <kbd>global/code-error.html.tmpl</kbd> and
+    <kbd>global/user-error.html.tmpl</kbd> templates for examples.
+    (Search for &quot;docslinks.&quot;)</li>
+  <li>Parameters are accessed through <kbd>Bugzilla-&gt;params</kbd>
+    instead of using the <kbd>Param()</kbd> function, now.</li>
+  <li>The variables from the <kbd>localconfig</kbd> file are accessed
+    through the <code>Bugzilla-&gt;localconfig</code> hash instead of through
+    <kbd>Bugzilla::Config</kbd>.</li>
+  <li><kbd>Bugzilla::BugMail::MessageToMTA()</kbd> has moved into its
+    own module, along with other mail-handling code, called
+    <kbd>Bugzilla::Mailer</kbd></li>
+  <li>The <kbd>CheckCanChangeField()</kbd> subroutine in 
+    <kbd>process_bug.cgi</kbd> has been moved to <kbd>Bugzilla::Bug</kbd>,
+    and is now a method of [% terms.abug %] object.</li>
+  <li>The code that used to be in the <kbd>global/banner.html.tmpl</kbd>
+    template is now in <kbd>global/header.html.tmpl</kbd>. The banner
+    still exists, but the file is empty.</li>
+</ul>
+
+<h2 id="v30_previous">Release Notes For Previous Versions</h2>
+
+<p>Release notes for versions of [% terms.Bugzilla %] for versions
+  prior to 3.0 are only available in text format: 
+  <a href="[% docs_urlbase FILTER remove('html/$') FILTER html %]rel_notes.txt">Release Notes for [% terms.Bugzilla %] 2.22
+  and Earlier</a>.</p>
+
+[% INCLUDE global/footer.html.tmpl %]
+
+[% BLOCK db_req %]
+  [% SET m = DB_MODULE.$db %]
+  <h3 id="v40_req_[% db FILTER html %]">For [% m.name FILTER html %] Users</h3>
+
+  <ul>
+    <li>[% m.name FILTER html %]
+       [%+ '<span class="req_new">' IF db_new %]v[% m.db_version FILTER html %]
+       [% '</span>' IF db_new %]
+       </li>
+    <li><strong>perl module:</strong>
+      [%+ m.dbd.module FILTER html %] 
+      [% '<span class="req_new">' IF dbd_new %]v[% m.dbd.version FILTER html %]
+      [% '</span>' IF dbd_new %]</li>
+  </ul>
+[% END %]
+
+
+[% BLOCK req_table %]
+  <table class="req_table" border="0" cellspacing="0" cellpadding="0">
+    <tr>
+      <th>Module</th> <th>Version</th>
+      [% IF include_feature %]
+        <th>Enables Feature</th>
+      [% END %]
+    </tr>
+    [% FOREACH req = reqs %]
+      <tr>
+        <td [% ' class="req_new"' IF new.contains(req.package) %]>
+          [%- req.module FILTER html %]</td> 
+        <td [% ' class="req_new"' IF updated.contains(req.package) 
+                                     OR new.contains(req.package) %]>
+          [%- IF req.version == 0 %]
+            (Any)
+          [% ELSE %]
+            [%- req.version FILTER html %]
+          [% END %]
+        </td>
+        [% IF include_feature %] 
+          <td>[% req.feature.join(', ') FILTER html %]</td>
+        [% END %]
+      </tr>
+    [% END %]
+</table>
+[% END %]

diff --git a/template/en/default/pages/sudo.html.tmpl b/template/en/default/pages/sudo.html.tmpl
new file mode 100644 (file)
index 0000000..2e90358
--- /dev/null
+++ b/template/en/default/pages/sudo.html.tmpl
@@ -0,0 +1,55 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% INCLUDE global/header.html.tmpl title = "sudo: User Impersonation" %]
+
+<p>
+  [%+ terms.Bugzilla %] includes the ability to have one user impersonate 
+another, in something called a <i>sudo session</i>, so long as the person 
+doing the impersonating has the appropriate privileges.
+</p>
+
+<p>
+  While a session is in progress, [% terms.Bugzilla %] will act as if the 
+  impersonated user is doing everything.  This is especially useful for testing,
+  and for doing critical work when the impersonated user is unavailable.  The 
+  impersonated user will receive an email from [% terms.Bugzilla %] when the 
+  session begins; they will not be told anything else.
+</p>
+
+<p>
+  To use this feature, you must be a member of the appropriate group.  The group 
+  includes all administrators by default.  Other users, and members of other 
+  groups, can be given access to this feature on a case-by-case basis.  To 
+  request access, contact the maintainer of this installation: 
+  <a href="mailto:[% Param("maintainer") %]">
+  [%- Param("maintainer") %]</a>.
+</p>
+
+<p>
+  If you would like to be protected from impersonation, you should contact the 
+  maintainer of this installation to see if that is possible.  People with 
+  access to this feature are protected automatically.
+</p>
+
+<p id="message">
+  [% IF user.in_group('bz_sudoers') %]
+    You are a member of the <b>bz_sudoers</b> group.  You may use this 
+    feature to impersonate others.
+  [% ELSE %]
+    You are not a member of an appropriate group.  You may not use this 
+    feature.
+  [% END %]
+  [% IF user.in_group('bz_sudo_protect') %]
+    <br>
+    You are a member of the <b>bz_sudo_protect</b> group.  Other people will 
+    not be able to use this feature to impersonate you.
+  [% END %]
+</p>
+
+[% INCLUDE global/footer.html.tmpl %]

diff --git a/template/en/default/request/queue.html.tmpl b/template/en/default/request/queue.html.tmpl
new file mode 100644 (file)
index 0000000..3d853c1
--- /dev/null
+++ b/template/en/default/request/queue.html.tmpl
@@ -0,0 +1,265 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% USE Bugzilla %]
+[% cgi = Bugzilla.cgi %]
+
+[% PROCESS global/header.html.tmpl
+  title="Request Queue"
+  onload="var f = document.request_form; selectProduct(f.product, f.component, null, null, 'Any');"
+  javascript_urls=["js/productform.js", "js/field.js"]
+  style_urls = ['skins/standard/buglist.css']
+  yui = ['autocomplete']
+%]
+
+<script type="text/javascript">
+  var useclassification = false; // No classification level in use
+  var first_load = true; // Is this the first time we load the page?
+  var last_sel = []; // Caches last selection
+  var cpts = new Array();
+  [% n = 1 %]
+  [% IF Param('useclassification') %]
+    [% FOREACH clas = user.get_selectable_classifications %]
+      [% FOREACH prod = user.get_selectable_products(clas.id) %]
+        [%+ PROCESS js_comp %]
+      [% END %]
+    [% END %]
+  [% ELSE %]
+    [% FOREACH prod = user.get_selectable_products %]
+      [%+ PROCESS js_comp %]
+    [% END %]
+  [% END %]
+</script>
+
+[% BLOCK js_comp %]
+  cpts['[% n %]'] = [
+    [%- FOREACH comp = prod.components %]'[% comp.name FILTER js %]'[% ", " UNLESS loop.last %] [%- END -%]];
+  [% n = n+1 %]
+[% END %]
+
+<p>
+When you are logged in, only requests made by you or addressed to you
+are shown by default.  You can change the criteria using the form below.
+When you are logged out, all pending requests that are not restricted
+to some group are shown by default.
+</p>
+
+<form id="request_form" name="request_form" action="request.cgi" method="get">
+  <input type="hidden" name="action" value="queue">
+
+  <table id="filtering">
+    <tr>
+      <th>Requester:</th>
+      <td>
+        [% INCLUDE global/userselect.html.tmpl
+           id => "requester"
+           name => "requester"
+           value => cgi.param('requester')
+           size => 20
+           emptyok => 1
+           field_title => "Requester's email address"
+        %]
+      </td>
+      <th>Product:</th>
+      <td>
+        <select name="product" onchange="selectProduct(this, this.form.component, null, null, 'Any');">
+          <option value="">Any</option>
+          [% IF Param('useclassification') %]
+            [% FOREACH c = user.get_selectable_classifications %]
+              <optgroup label="[% c.name FILTER html %]">
+                [% FOREACH p = user.get_selectable_products(c.id) %]
+                  <option value="[% p.name FILTER html %]"
+                    [% " selected" IF cgi.param('product') == p.name %]>
+                    [% p.name FILTER html %]
+                  </option>
+                [% END %]
+              </optgroup>
+            [% END %]
+          [% ELSE %]
+            [% FOREACH p = user.get_selectable_products %]
+              <option value="[% p.name FILTER html %]"
+                [% " selected" IF cgi.param('product') == p.name %]>
+                [% p.name FILTER html %]
+              </option>
+            [% END %]
+          [% END %]
+        </select>
+      </td>
+      <th>Flag:</th>
+      <td>
+        [% PROCESS "global/select-menu.html.tmpl"
+                    name="type"
+                    options=types
+                    default=cgi.param('type') %]
+      </td>
+
+      [%# We could let people see a "queue" of non-pending requests. %]
+      <!--
+      <th>Status:</th>
+      <td>
+        [%# PROCESS "global/select-menu.html.tmpl"
+                    name="status"
+                    options=["all", "?", "+-", "+", "-"]
+                    default=cgi.param('status') %]
+      </td>
+      -->
+
+    </tr>
+    <tr>
+      <th>Requestee:</th>
+      <td>
+        [% INCLUDE global/userselect.html.tmpl
+           id => "requestee"
+           name => "requestee"
+           value => cgi.param('requestee')
+           size => 20
+           emptyok => 1
+           hyphenok => 1
+           field_title => "Requestee's email address or \"-\" (hyphen) for requests with no requestee"
+        %]
+      </td>
+      <th>Component:</th>
+      <td>
+        <select name="component">
+          <option value="">Any</option>
+          [% FOREACH comp = components %]
+            <option value="[% comp FILTER html %]" [% "selected" IF cgi.param('component') == comp %]>
+              [% comp FILTER html %]</option>
+          [% END %]
+        </select>
+      </td>
+      <th>Group By:</th>
+      <td>
+        [% groups = {
+            "Requester" => 'requester' ,
+            "Requestee" => 'requestee',
+            "Flag" => 'type' ,
+            "Product/Component" => 'category'
+          } %]
+        [% PROCESS "global/select-menu.html.tmpl" name="group" options=groups default=cgi.param('group') %]
+      </td>
+    </tr>
+    <tr>
+      <th></th>
+      <td>
+        <label><input type="radio" name="do_union" value="0" 
+            [% 'checked="checked"' IF !cgi.param('do_union') %]>AND *</label>
+        <label><input type="radio" name="do_union" value="1" 
+            [% 'checked="checked"' IF cgi.param('do_union') %]>OR *</label>
+      </td>
+      <td colspan="3"></td>
+      <td><input type="submit" id="filter" value="Filter"></td>
+    </tr>
+  </table>
+
+  <p>(* The logical conjunction/disjunction between the requester 
+          and the requestee)</p>
+</form>
+
+[% column_headers = {
+      "type"       => "Flag" ,
+      "status"     => "Status" ,
+      "bug"        => "$terms.Bug" ,
+      "attachment" => "Attachment" ,
+      "requester"  => "Requester" ,
+      "requestee"  => "Requestee" ,
+      "created"    => "Created" ,
+      "category"   => "Product/Component"    } %]
+
+[% DEFAULT display_columns = ["requester", "requestee", "type", "bug", "attachment", "created"]
+           group_field     = "Requestee"
+           group_value     = ""
+%]
+
+[% IF debug %]
+  <p>[% query FILTER html %]</p>
+[% END %]
+
+[% IF requests.size == 0 %]
+  <p>
+    No requests.
+  </p>
+[% ELSE %]
+  [% FOREACH request = requests %]
+    [% IF request.$group_field != group_value || loop.first %]
+      [% group_value = request.$group_field %]
+      [% PROCESS display_buglist UNLESS loop.first %]
+      [% PROCESS start_new_table %]
+    [% END %]
+    [% buglist.${request.bug_id} = 1 %]
+    <tr>
+      [% FOREACH column = display_columns %]
+        [% NEXT IF column == group_field || excluded_columns.contains(column) %]
+        <td>
+          [% PROCESS "display_$column" %]
+          [% Hook.process('after_column') %]
+        </td>
+      [% END %]
+    </tr>
+  [% END %]
+  [% PROCESS display_buglist %]
+[% END %]
+
+[% PROCESS global/footer.html.tmpl %]
+
+[% BLOCK start_new_table %]
+  [% buglist = {} %]
+
+  <h3>[% column_headers.$group_field %]: 
+    [%+ (request.$group_field || "None") FILTER email FILTER html %]</h3>
+  <table class="requests" cellspacing="0" cellpadding="4" border="1">
+    <tr>
+      [% FOREACH column = display_columns %]
+        [% NEXT IF column == group_field || excluded_columns.contains(column) %]
+        <th>[% column_headers.$column %]</th>
+      [% END %]
+    </tr>
+[% END %]
+
+[% BLOCK display_type %]
+  [% request.type FILTER html %]
+[% END %]
+
+[% BLOCK display_status %]
+  [% request.status %]
+[% END %]
+
+[% BLOCK display_bug %]
+  <a href="show_bug.cgi?id=[% request.bug_id %]"
+     [%- ' class="bz_secure"' IF request.restricted %]>
+    [% request.bug_id %]: [%+ request.bug_summary FILTER html %]</a>
+[% END %]
+
+[% BLOCK display_attachment %]
+  [% IF request.attach_id %]
+    <a href="attachment.cgi?id=[% request.attach_id %]&amp;action=edit">
+      [% request.attach_id %]: [%+ request.attach_summary FILTER html %]</a>
+  [% ELSE %]
+    N/A
+  [% END %]
+[% END %]
+
+[% BLOCK display_requestee %]
+  [% request.requestee FILTER email FILTER html %]
+[% END %]
+
+[% BLOCK display_requester %]
+  [% request.requester FILTER email FILTER html %]
+[% END %]
+
+[% BLOCK display_created %]
+  [% request.created FILTER time %]
+[% END %]
+
+[% BLOCK display_buglist %]
+  </table>
+  [% NEXT UNLESS buglist.keys.size %]
+  <a href="buglist.cgi?bug_id=
+           [%- buglist.keys.nsort.join(",") FILTER html %]">(view as
+  [%+ terms.bug %] list)</a>
+[% END %]

diff --git a/template/en/default/search/boolean-charts.html.tmpl b/template/en/default/search/boolean-charts.html.tmpl
new file mode 100644 (file)
index 0000000..508e11c
--- /dev/null
+++ b/template/en/default/search/boolean-charts.html.tmpl
@@ -0,0 +1,185 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% types = [
+  "noop",
+  "equals",
+  "notequals",
+  "anyexact",
+  "substring",
+  "casesubstring",
+  "notsubstring",
+  "anywordssubstr",
+  "allwordssubstr",
+  "nowordssubstr",
+  "regexp",
+  "notregexp",
+  "lessthan",
+  "lessthaneq",
+  "greaterthan",
+  "greaterthaneq",
+  "anywords",
+  "allwords",
+  "nowords",
+  "changedbefore",
+  "changedafter",
+  "changedfrom",
+  "changedto",
+  "changedby",
+  "matches",
+  "notmatches",
+] %]
+
+<div class="bz_section_title" id="custom_search_filter">
+  <div id="custom_search_query_controller" class="arrow">&#9660;</div>
+  <a id="chart" href="javascript:TUI_toggle_class('custom_search_query')" >
+    Custom Search</a> <span class="section_help">Didn't find what 
+      you're looking for above? This area allows for ANDs, ORs, 
+      and other more complex searches.</span>
+</div>
+<div id="custom_search_filter_section" 
+     class="bz_search_section custom_search_query">
+  [% SET indent_level = 0 %]
+  [% SET cond_num = 0 %]
+  [% FOREACH condition = default.custom_search %]
+    [% SET cond_num = loop.count - 1 %]
+    [% PROCESS one_condition with_buttons = 0 %]
+  [% END %]
+  [% PROCESS one_condition
+    with_buttons = 1
+    condition = { f => 'noop' }
+    cond_num = cond_num + 1 %]
+  <script type="text/javascript">
+    TUI_alternates['custom_search_query'] = '&#9658;';
+    TUI_hide_default('custom_search_query');
+    TUI_alternates['custom_search_advanced'] = "Show Advanced Features";
+    TUI_hide_default('custom_search_advanced');
+  </script>
+  <script type="text/javascript" src="[% 'js/custom-search.js' FILTER mtime %]"></script>
+  <script type="text/javascript">
+    redirect_html4_browsers();
+    [%# These are alternative labels for the AND and OR options in and_all_select %]
+    var cs_and_label = 'Match ALL of the following:';
+    var cs_or_label  = 'Match ANY of the following:';
+    cs_reconfigure('custom_search_last_row');
+  </script>
+  <script type="text/javascript" src="[% 'js/history.js/native.history.js' FILTER mtime %]"></script>
+</div>
+
+
+[% BLOCK one_condition %]
+  [%# Skip any conditions that don't have a field defined. %]
+  [% RETURN IF !condition.f %]
+  
+  [% IF !top_level_any_shown %]
+    [% INCLUDE any_all_select
+      name = "j_top" selected = default.j_top.0
+      with_advanced_link = 1 %]
+    [% top_level_any_shown = 1 %]
+  [% END %]
+
+  [% IF condition.f == "CP" %]
+    [% indent_level = indent_level - 1 %]
+  [% END %]
+
+  <div class="custom_search_condition"
+       [% ' style="margin-left: ' _ (indent_level * 2) _ 'em"' IF indent_level %]
+       [% ' id="custom_search_last_row"' IF with_buttons %]>
+    
+    [% IF previous_condition.f == "OP" %]
+      [% INCLUDE any_all_select
+        name = "j" _ (cond_num - 1) 
+        selected = previous_condition.j %]
+    [% END %]
+
+    [% IF with_buttons %]
+      <button id="op_button" type="button" class="custom_search_advanced"
+              title="Start a new group of criteria, including this row"
+              onclick="custom_search_open_paren()">(</button>
+    [% END %]
+
+    [% UNLESS condition.f == "CP" %]
+      [%# This only gets hidden via custom_search_advanced if it isn't set. %]
+      <span id="custom_search_not_container_[% cond_num FILTER html %]"
+            class="custom_search_not_container
+                   [%- ' custom_search_advanced' UNLESS condition.n %]"
+            title="Search for the opposite of the criteria here">
+        <input type="checkbox" id="n[% cond_num FILTER html %]"
+               class="custom_search_form_field"
+               name="n[% cond_num FILTER html %]" value="1"
+               onclick="custom_search_not_changed([% cond_num FILTER js %])"
+               [% ' checked="checked"' IF condition.n %]>
+        <label for="n[% cond_num FILTER html %]">Not</label>
+      </span>
+    [% END %]
+
+    [% IF condition.f == "OP" %]
+      <input type="hidden" name="f[% cond_num FILTER html %]"
+             id="f[% cond_num FILTER html %]" value="OP">
+      (
+      [% indent_level = indent_level + 1 %]
+    [% ELSIF condition.f == "CP" %]
+      <input type="hidden" name="f[% cond_num FILTER html %]"
+             id="f[% cond_num FILTER html %]" value="CP">
+      )
+    [% ELSE %]
+      <select name="f[% cond_num FILTER html %]" title="Field"
+              id="f[% cond_num FILTER html %]"
+              onchange="fix_query_string(this)"
+              class="custom_search_form_field">
+        [% FOREACH field = fields %]
+          <option value="[% field.name FILTER html %]"
+                  [%~ ' selected="selected"' IF field.name == condition.f %]>
+            [% field_descs.${field.name} || field.description FILTER html %]
+          </option>
+        [% END %]
+      </select>
+    
+      [% INCLUDE "search/type-select.html.tmpl"
+         name = "o${cond_num}", class = "custom_search_form_field"
+         types = types, selected = condition.o %]
+    
+      <input name="v[% cond_num FILTER html %]" title="Value"
+             class="custom_search_form_field"
+             onchange="fix_query_string(this)"
+             value="[% condition.v FILTER html %]">
+    [% END %]
+    
+    [% IF with_buttons %]
+      <button class="custom_search_add_button" type="button"
+              id="add_button" title="Add a new row"
+              onclick="custom_search_new_row()">+</button>
+      <span id="cp_container" [% ' class="bz_default_hidden"' IF !indent_level %]>
+        <button id="cp_button" type="button"
+                title="End this group of criteria"
+                onclick="custom_search_close_paren()">)</button>
+      </span>
+    [% END %]
+  </div>
+  
+  [% previous_condition = condition %]
+[% END %]
+
+[% BLOCK any_all_select %]
+  <div class="any_all_select">
+    <select name="[% name FILTER html %]" id="[% name FILTER html %]"
+            onchange="fix_query_string(this)">
+      <option value="AND">Match ALL of the following separately:</option>
+      <option value="OR" [% ' selected="selected"' IF selected == "OR" %]>
+        Match ANY of the following separately:</option>
+      <option value="AND_G" [% ' selected' IF selected == "AND_G" %]>
+        Match ALL of the following against the same field:</option>
+    </select>
+    [% IF with_advanced_link %]
+      <a id="custom_search_advanced_controller"
+         href="javascript:TUI_toggle_class('custom_search_advanced')">
+        Hide Advanced Features
+      </a>
+    [% END %]
+  </div>
+[% END %]

diff --git a/template/en/default/search/field.html.tmpl b/template/en/default/search/field.html.tmpl
new file mode 100644 (file)
index 0000000..ab73808
--- /dev/null
+++ b/template/en/default/search/field.html.tmpl
@@ -0,0 +1,184 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+  
+[% SWITCH field.type %]
+  [% CASE [ constants.FIELD_TYPE_FREETEXT,
+            constants.FIELD_TYPE_TEXTAREA, 
+            constants.FIELD_TYPE_UNKNOWN ] %]
+    [% INCLUDE "bug/field-label.html.tmpl"
+      field = field
+      tag_name = "span"
+      editable = 1
+    %]
+    [% INCLUDE "search/type-select.html.tmpl"
+       name = field.name _ "_type",
+       types = types, 
+       selected = type_selected
+    %]    
+    <input name="[% field.name FILTER html %]" 
+           id="[% field.name FILTER html %]" size="40"
+           [% IF onchange %] onchange="[% onchange FILTER html %]"[% END %]
+           value="[% value FILTER html %]">              
+  [% CASE constants.FIELD_TYPE_KEYWORDS %]
+    [% INCLUDE "bug/field-label.html.tmpl"
+      field = field
+      tag_name = "span"
+      editable = 1
+    %]
+    [% INCLUDE "search/type-select.html.tmpl"
+       name = field.name _ "_type",
+       types = types, 
+       selected = type_selected
+    %]
+    <div id="[% field.name FILTER html %]_container">
+       <input name="[% field.name FILTER html %]" 
+              id="[% field.name FILTER html %]" size="40"
+              [% IF onchange %] onchange="[% onchange FILTER html %]"[% END %]
+              value="[% value FILTER html %]">
+       <div id="[% field.name FILTER html %]_autocomplete"></div>
+    </div>
+    <script type="text/javascript" defer="defer">
+      if (typeof YAHOO.bugzilla.field_array === "undefined")
+        YAHOO.bugzilla.field_array = [];
+      YAHOO.bugzilla.field_array["[% field.name FILTER js %]"] = [
+        [%- FOREACH val = possible_values %]
+          [%-# %]"[% val FILTER js %]"
+          [%- "," IF NOT loop.last %][% END %]];
+      YAHOO.bugzilla.fieldAutocomplete.init('[% field.name FILTER js %]',
+                                            '[% field.name FILTER js %]_autocomplete');
+    </script>
+  [% CASE constants.FIELD_TYPE_DATETIME %]
+    [% INCLUDE "bug/field-label.html.tmpl"
+      field = field
+      tag_name = "span"
+      editable = 1
+    %]
+    from <input name="[% field.name FILTER html %]from" 
+                id="[% field.name FILTER html %]" 
+                size="10" maxlength="10"
+                value="[% value.0 FILTER html %]" 
+                onchange="updateCalendarFromField(this);[% onchange FILTER html %]">
+         <button type="button" class="calendar_button"
+                        id="button_calendar_[% field.name FILTER html %]"
+                        onclick="showCalendar('[% field.name FILTER js %]')">
+           <span>Calendar</span>
+         </button>
+         <span id="con_calendar_[% field.name FILTER html %]"></span>               
+    to <input name="[% field.name FILTER html %]to" 
+              id="[% field.name FILTER html %]to" size="10" maxlength="10"
+              value="[% value.1 FILTER html %]" 
+              onchange="updateCalendarFromField(this);[% onchange FILTER html %]">
+       <button type="button" class="calendar_button"
+                      id="button_calendar_[% field.name FILTER html %]to"
+                      onclick="showCalendar('[% field.name FILTER js %]to')">
+         <span>Calendar</span>
+       </button>
+    <small>(YYYY-MM-DD or relative dates)</small>
+    
+    <span id="con_calendar_[% field.name FILTER html %]to"></span>
+    <script type="text/javascript">
+      <!--
+        [%+ PROCESS "global/calendar.js.tmpl" id = field.name %]
+        [% PROCESS "global/calendar.js.tmpl" id = field.name _ 'to' %]
+      //--></script>
+  [% CASE [ constants.FIELD_TYPE_SINGLE_SELECT, 
+            constants.FIELD_TYPE_MULTI_SELECT ] %]
+    <div id="container_[% field.name FILTER html %]" class="search_field_grid">      
+      [% INCLUDE "bug/field-label.html.tmpl"
+        field = field
+        editable = 1
+        tag_name = "span"
+      %]
+      <select name="[% field.name FILTER html%]" 
+              id="[% field.name FILTER html %]" 
+        [% IF onchange %] onchange="[% onchange FILTER html %]"[% END %]
+        multiple="multiple" size="7">
+        [% legal_values = ${field.name} %]
+        [% IF field.name == "component" %]
+          [% legal_values = ${"component_"} %]
+        [% END %]
+        [% FOREACH current_value = legal_values %]
+          [% SET v = current_value.name OR '---' -%]
+          [% SET display = display_value(field.name, current_value.name) %]
+          <option [% IF v != display %]value="[% v FILTER html %]"[% END ~%]
+            id="v[% current_value.id FILTER html %]_[% field.name FILTER html %]"
+            [% ' selected="selected"' IF value.contains( v ) %]>
+            [%~ display FILTER html ~%]
+          </option>
+        [% END %]
+      </select>
+    </div>
+
+    [% IF value_controllers.${field.name}.defined %]
+      <script type="text/javascript"><!--
+        [%+ FILTER collapse %]
+          [% FOREACH accessor = value_controllers.${field.name}.keys %]
+            [% PROCESS controller_js %]
+          [% END %]
+        [%~ END ~%]
+      // --></script>
+    [% END %]
+    [% IF duplicates.${field.name}.keys.size %]
+      [% SET field_dups = duplicates.${field.name} %]
+      [% SET dup_counts = duplicate_count.${field.name} %]
+      <script type="text/javascript">
+       [%+ FILTER collapse %]
+          bz_option_duplicates['[% field.name FILTER js %]'] = {
+            [% FOREACH dup = field_dups.keys %]
+              [% dup FILTER js %]:[% field_dups.$dup.id FILTER js %]
+              [%~ ',' UNLESS loop.last %]
+            [% END ~%]
+          };
+          bz_option_duplicate_count['[% field.name FILTER js %]'] = {
+            [% FOREACH dup_target = dup_counts.keys %]
+              [% dup_target FILTER js %]:[% dup_counts.$dup_target FILTER js %]
+              [%~ ',' UNLESS loop.last %]
+            [% END %]
+          };
+        [% END %]
+      </script>
+    [% END %]
+
+  [% END %]
+[%# END OF SWITCH %]
+
+[% BLOCK controller_js %]
+  [%# If there are selected values already, we need to fire the
+    # "change" event once the page has loaded, so we can set all
+    # the values in all the other <select>s properly.
+    #%]
+  YAHOO.util.Event.onDOMReady(function() {
+      var field = document.getElementById('[% field.name FILTER js %]');
+      if (field.selectedIndex != -1) bz_fireEvent(field, 'change');
+  });
+
+  [% SET sub_field = value_controllers.${field.name}.$accessor %]
+  [% SET prod_per_class = {} %]
+  [% IF field.name == "classification" %]
+    [% FOREACH p = product %]
+      [% prod_per_class.${p.classification_id}.${p.id} = 1 %]
+    [% END %]
+  [% END %]
+
+  [% FOREACH legal_value = legal_values %]
+    [% SET controlled_ids = [] %]
+    [% IF field.name == "classification" %]
+      [% controlled_ids = prod_per_class.${legal_value.id}.keys %]
+    [% ELSE %]
+      [% FOREACH sub_value = legal_value.$accessor %]
+        [% controlled_ids.push(sub_value.id) %]
+      [% END %]
+    [% END %]
+    [% NEXT IF !controlled_ids.size %]
+      showValueWhen('[% sub_field.name FILTER js %]',
+                    [[% controlled_ids.join(',') FILTER js %]],
+                    '[% field.name FILTER js %]',
+                    [% legal_value.id FILTER js %],
+                    true);
+  [% END %]
+[% END %]

diff --git a/template/en/default/search/form.html.tmpl b/template/en/default/search/form.html.tmpl
new file mode 100644 (file)
index 0000000..8cfb12a
--- /dev/null
+++ b/template/en/default/search/form.html.tmpl
@@ -0,0 +1,341 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS "global/field-descs.none.tmpl" %]
+
+<input type="hidden" id="no_redirect" name="no_redirect" value="0">
+<script type="text/javascript">
+  if (history && history.replaceState) {
+    var no_redirect = document.getElementById("no_redirect");
+    no_redirect.value = 1;
+  }
+
+// Hide the Advanced Fields by default, unless the user has a cookie
+// that specifies otherwise.
+// &#9656; and &#9662; are both utf8 escaped characters for right 
+//    and down facing arrows respectivly.
+TUI_alternates['history_query'] = '&#9658;';
+TUI_alternates['people_query'] = '&#9658;';
+TUI_alternates['information_query'] = '&#9658;';
+
+TUI_hide_default('history_query');
+TUI_hide_default('people_query');
+TUI_hide_default('information_query');
+</script>
+
+[% query_types = [
+  "allwordssubstr",
+  "anywordssubstr",
+  "substring",
+  "casesubstring",
+  "allwords",
+  "anywords",
+  "regexp",
+  "notregexp",
+] %]
+
+[%# If we resubmit to ourselves, we need to know if we are using a format. %]
+[% thisformat = query_format != '' ? query_format : format %]
+<input type="hidden" name="query_format" value="[% thisformat FILTER html %]">
+
+[%# *** Summary *** %]
+
+  <div class="search_field_row" id="summary_field">
+      [% INCLUDE "search/field.html.tmpl"
+         field = bug_fields.short_desc
+         types = query_types
+         value = default.short_desc.0
+         type_selected = default.short_desc_type.0 
+         accesskey = "s"
+         %]
+      <script type="text/javascript"> <!--
+          document.getElementById('short_desc').focus();
+      // -->
+      </script>
+
+      [% IF button_name %]
+        <input type="submit" id="[% button_name FILTER css_class_quote %]_top"
+               value="[% button_name FILTER html %]">
+      [% END %]
+  </div>
+
+[%# *** Classification Product Component *** %]
+
+[% value_controllers = {
+    'classification' => { 'products' => bug_fields.product },
+    'product' => { 'components' => bug_fields.component,
+                   'versions'   => bug_fields.version,
+                   'milestones' => bug_fields.target_milestone },
+} %]
+
+[% Hook.process('before_selects_top') %]
+[% IF Param('useclassification') %]
+  [% INCLUDE "search/field.html.tmpl"
+        field => bug_fields.classification
+        accesskey => "c"
+        value => default.classification
+  %]
+[% END %]
+
+[% INCLUDE "search/field.html.tmpl" 
+      field => bug_fields.product
+      accesskey => "p"
+      value => default.product
+%]
+[% INCLUDE "search/field.html.tmpl" 
+      field => bug_fields.component
+      accesskey => "m"
+      value => default.component
+%]
+[% INCLUDE "search/field.html.tmpl" 
+      field => bug_fields.bug_status
+      accesskey => "a"
+      value => default.bug_status
+%]
+[% INCLUDE "search/field.html.tmpl" 
+      field => bug_fields.resolution
+      accesskey => "r" 
+      value => default.resolution
+%]
+
+[% Hook.process('after_selects_top') %]
+
+<div id="detailed_information" class="bz_section_title">
+  <div id="information_query_controller" class="arrow">&#9660;</div>
+  <a href="javascript:TUI_toggle_class('information_query')">
+    Detailed [% terms.Bug %] Information
+  </a>
+  <span class="section_help">Narrow results by the following fields: 
+    [%+ field_descs.longdesc FILTER html %]s, [%+ field_descs.bug_file_loc FILTER html %], 
+    [% IF Param('usestatuswhiteboard') %] [%+ field_descs.status_whiteboard FILTER html %], [%+ END %]
+    [% IF use_keywords %] [%+ field_descs.keywords FILTER html %], [%+ END %]
+    [% IF user.is_timetracker %] [%+ field_descs.deadline FILTER html %], [%+ END %]
+    [% terms.Bug %] Numbers, [%+ field_descs.version FILTER html %], 
+    [% IF Param('usetargetmilestone') %] [%+ field_descs.target_milestone FILTER html %], [%+ END %]
+    [% field_descs.bug_severity FILTER html %], [%+ field_descs.priority FILTER html %], [%+ field_descs.rep_platform FILTER html %], 
+    [%+ field_descs.op_sys FILTER html %]
+  </span>
+</div>
+[%# *** Comment URL Whiteboard Keywords *** %]
+<div id="detailed_information_section" class="bz_search_section information_query">
+  [% SET freetext_fields = [
+    { field => bug_fields.longdesc, accesskey => 'c' },
+    { field => bug_fields.bug_file_loc, accesskey => 'u' },
+    { field => bug_fields.status_whiteboard, accesskey => 'w' },
+    { field => bug_fields.keywords, accesskey => 'k', 
+      qtypes => ['allwords', 'anywords', 'nowords', 'regexp', 'notregexp'] }   
+  ] %]
+  [% Hook.process('before_freetext_fields') %]
+  
+  [%# loop through a bunch of free text fields and print out their text stuff %]
+  [% FOREACH field_container = freetext_fields %]
+    [% NEXT IF field_container.field.name == 'status_whiteboard' 
+               AND NOT Param('usestatuswhiteboard') 
+    %]
+    [% NEXT IF field_container.field.name == 'keywords' 
+               AND NOT use_keywords
+    %]
+    <div class="search_field_row">
+      [% type = field_container.field.name _ "_type" %]
+      [% possible_values = field_container.field.name == 'keywords' ? all_keywords : [] %]
+      [% INCLUDE "search/field.html.tmpl" 
+          field => field_container.field
+          types => field_container.qtypes || query_types
+          accesskey => field_container.accesskey
+          value => default.${field_container.field.name}.0
+          type_selected => default.$type.0
+      %]
+    </div>
+  [% END %]
+
+  [%# Deadline %]
+  [% IF user.is_timetracker %]
+    <div class="search_field_row">
+        [% INCLUDE "search/field.html.tmpl" 
+                    field = bug_fields.deadline 
+                    accesskey = "l"
+                    value = [ default.deadlinefrom.0, default.deadlineto.0  ]
+        %]
+    </div>
+  [% END %]
+
+  <div class="search_field_row">
+    <span class="field_label"><label for="bug_id">[% terms.Bugs %] numbered</label></span>
+    <div id="bug_id_container" >
+      <input type="text" name="bug_id" id="bug_id"
+           value="[% default.bug_id.0 FILTER html %]" size="20">
+           <div class="field_help">(comma-separated list)</div>
+    </div>
+    should be 
+    <select name="bug_id_type" id="bug_id_type">
+      <option value="anyexact"[% " selected" IF default.bug_id_type.0 == "anyexact" %]>only included in</option>
+      <option value="nowords"[% " selected" IF default.bug_id_type.0 == "nowords" %]>excluded from</option>
+    </select> the results
+  </div>
+
+  [% Hook.process('after_freetext_fields') %]
+  
+  [%# *** Status Resolution Severity Priority Hardware OS *** %]
+  <div>
+    [% Hook.process('before_selects_bottom') %]
+    [% fake_version_field = { name => bug_fields.version.name,
+                              type => constants.FIELD_TYPE_SINGLE_SELECT }%]
+    [% INCLUDE "search/field.html.tmpl" 
+          field => fake_version_field
+          value => default.version
+    %]                              
+    [% IF Param('usetargetmilestone') %]
+        [% fake_target_milestone_field = { name => bug_fields.target_milestone.name , 
+                                           type => constants.FIELD_TYPE_SINGLE_SELECT } %]
+        [% INCLUDE "search/field.html.tmpl" 
+              field => fake_target_milestone_field
+              value => default.target_milestone
+        %]
+    [% END %]
+    [% INCLUDE "search/field.html.tmpl" 
+          field => bug_fields.bug_severity
+          accesskey=> "v" 
+          value => default.bug_severity
+    %]
+    [% INCLUDE "search/field.html.tmpl" 
+         field => bug_fields.priority
+         accesskey => "i"
+         value => default.priority
+    %]    
+    [% INCLUDE "search/field.html.tmpl" 
+        field => bug_fields.rep_platform 
+        accesskey =>"h"
+        value => default.rep_platform
+    %]               
+    [% INCLUDE "search/field.html.tmpl" 
+        field => bug_fields.op_sys 
+        accesskey =>"o"
+        value => default.op_sys
+    %]               
+    [% Hook.process('after_selects_bottom') %]
+  </div>
+</div>
+[%# *** Email Numbering *** %]
+  <div class="bz_section_title" id="people_filter">
+    <div id="people_query_controller" class="arrow">&#9660;</div>
+    <a href="javascript:TUI_toggle_class('people_query')">Search By People</a>
+    <span>Narrow results to a role (i.e. [% field_descs.assigned_to FILTER html %],
+      [%+ field_descs.reporter FILTER html %], [% field_descs.commenter FILTER html %],
+      etc.) a person has on [% terms.abug %]
+    </span>
+  </div>
+  <div id="people_filter_section" class="bz_search_section people_query">
+  [% FOREACH n = [1, 2, 3] %]
+    <div class="search_email_fields">
+      Any of:
+      [% PROCESS role_types field = { count => n, name => "emailassigned_to",
+                  label=> "the ${terms.Bug} ${field_descs.assigned_to}" } %]
+      [% PROCESS role_types field = { count => n, name => "emailreporter",
+                  label=> "the ${field_descs.reporter}" } %]    
+      [% IF Param('useqacontact') %]
+          [% PROCESS role_types field = { count => n, name => "emailqa_contact", 
+                  label=> "the ${field_descs.qa_contact}" } %]
+      [% END %]
+      [% PROCESS role_types field = { count => n, name => "emailcc", 
+                  label=> "a ${field_descs.cc} list member" } %]
+      [% PROCESS role_types field = { count => n, name => "emaillongdesc", 
+                  label=> " a ${field_descs.commenter}" } %]
+      <select name="emailtype[% n %]">
+      [% FOREACH qv = [
+        { name => "substring", description => "contains" },
+        { name => "notsubstring", description => "doesn't contain" },
+        { name => "exact", description => "is" },
+        { name => "notequals", description => "is not" },
+        { name => "regexp", description => "matches regexp" },
+        { name => "notregexp", description => "doesn't match regexp" } ] %]
+        <option value="[% qv.name %]"
+          [% " selected" IF default.emailtype.$n == qv.name %]>[% qv.description %]</option>
+      [% END %]
+      </select>
+      [% IF feature_enabled('jsonrpc') && Param('ajax_user_autocompletion') %]
+        <div id="email[% n %]_autocomplete">
+      [% END %]
+      <input name="email[% n %]" class="email" id="email[% n %]" 
+             value="[% default.email.$n FILTER html %]">
+      [% IF feature_enabled('jsonrpc') && Param('ajax_user_autocompletion') %]
+        <div id="email[% n %]_autocomplete_container"></div>
+        </div>
+        <script type="text/javascript">
+          YAHOO.bugzilla.userAutocomplete.init( "email[% n %]", 
+                    "email[% n %]_autocomplete_container");
+        </script>
+      [% END %]
+    </div>
+  [% END %]
+   [% Hook.process('email_numbering_end') %]
+   </div>
+[%# *** Bug Changes *** %]
+<div class="bz_section_title" id="history_filter">
+  <div id="history_query_controller" class="arrow">&#9660;</div>
+  <a href="javascript:TUI_toggle_class('history_query')" >Search By Change History</a>
+  <span>Narrow results to how fields have changed during a specific time period</span>
+</div>
+<ul class="bug_changes bz_search_section history_query" id="history_filter_section" >
+  <li>
+    <label for="chfield">where ANY of the fields:</label>
+    [%# Create array, so we can sort it by description #%]
+    [% chfields = [] %]
+    [% FOREACH field = chfield %]
+      [% chfields.push({value => field, desc => (field_descs.$field || field) }) %]
+    [% END %]
+    <select name="chfield" id="chfield" multiple="multiple" size="4">
+    [% FOREACH field = chfields.sort('desc') %]
+      <option value="[% field.value FILTER html %]"
+        [% " selected" IF default.chfield.contains(field.value) %]>
+        [% field.desc FILTER html %]</option>
+    [% END %]
+    </select>
+  </li>
+  <li>
+    <label for="chfieldvalue">[% search_descs.changedto FILTER html %]:</label>
+    <input name="chfieldvalue" id="chfieldvalue"
+           size="20" value="[% default.chfieldvalue.0 FILTER html %]">
+  </li>
+  <li>
+    <label for="chfieldfrom">between:</label>
+    <input name="chfieldfrom" id="chfieldfrom" size="10" 
+           value="[% default.chfieldfrom.0 FILTER html %]" onchange="updateCalendarFromField(this)"> 
+           <button type="button" class="calendar_button"
+                          id="button_calendar_chfieldfrom"
+                          onclick="showCalendar('chfieldfrom')"><span>Calendar</span></button>
+           and 
+           <div id="con_calendar_chfieldfrom"></div>
+          <input name="chfieldto" size="10" id="chfieldto" 
+                 value="[% default.chfieldto.0 || "Now" FILTER html %]" 
+                 onchange="updateCalendarFromField(this)">
+          <button type="button" class="calendar_button"
+                         id="button_calendar_chfieldto"
+                         onclick="showCalendar('chfieldto')"><span>Calendar</span></button>
+          <div id="con_calendar_chfieldto"></div>
+    (YYYY-MM-DD or relative dates)
+    <script type="text/javascript">
+      <!--
+        [%+ PROCESS "global/calendar.js.tmpl" id = 'chfieldfrom' %]
+        [% PROCESS "global/calendar.js.tmpl" id = 'chfieldto' %]
+      //--></script>
+  </li>    
+</ul>
+
+[%############################################################################%]
+[%# Block for email role type use to select which email to search through    #%]
+[%############################################################################%]
+[% BLOCK role_types %]
+  <div class="role_type">
+    <input type="checkbox" name="[% field.name _ field.count FILTER html %]"
+           id="[% field.name _ field.count FILTER html %]" value="1"
+           [% " checked" IF default.${field.name}.${field.count} %]>
+    <label for="[% field.name _ field.count FILTER html%]">
+      [% field.label FILTER html%]
+    </label>
+  </div>
+[% END %]

diff --git a/template/en/default/search/knob.html.tmpl b/template/en/default/search/knob.html.tmpl
new file mode 100644 (file)
index 0000000..e9e3daa
--- /dev/null
+++ b/template/en/default/search/knob.html.tmpl
@@ -0,0 +1,74 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # (incomplete!)
+  # ...
+  # known_name: string. Possibly known stored name for the query being 
+  #                     edited. This value is just passed through in a
+  #                     hidden field.
+  #%]
+
+[%# This is not necessary for English templates, but useful for localizers. %]
+[% ordersdesc = {
+   "Reuse same sort as last time" => "Reuse same sort as last time",
+   "Bug Number"   => "$terms.Bug Number",
+   "Importance"   => "Importance",
+   "Assignee"     => "Assignee",
+   "Last Changed" => "Last Changed" } %]
+
+<input type="hidden" name="cmdtype" value="doit">
+[% IF user.id %]
+  <input type="hidden" name="token" value="[% issue_hash_token(['searchknob']) FILTER html %]">
+[% END %]
+
+<p>
+  <label for="order">Sort results by</label>:
+  <select name="order" id="order">
+  [% FOREACH order = orders %]
+    <option value="[% order FILTER html %]"
+      [% " selected" IF default.order.0 == order %]>
+         [% ordersdesc.$order FILTER html %]</option>
+  [% END %]
+  </select>
+</p>
+
+<p>  
+  <input type="submit" id="[% button_name FILTER html %]"
+         value="[% button_name FILTER html %]">
+  [% IF known_name %]
+    [%# We store known_name in case the user adds a boolean chart. %]
+    <input type="hidden" name="known_name" value="[% known_name FILTER html %]">
+
+    [%# The name of the existing query will be passed to buglist.cgi. %]
+    <input type="hidden" name="query_based_on" value="[% known_name FILTER html %]">
+  [% END %]
+  [%# Preserve any custom column list that might be set. %]
+  [% IF columnlist %]
+    <input type="hidden" name="columnlist" value="[% columnlist FILTER html %]">
+  [% END %]
+</p>
+
+[% IF user.id %]
+  <p>
+    &nbsp;&nbsp;&nbsp;
+    <input type="checkbox" id="remasdefault"
+           name="remtype" value="asdefault">
+    <label for="remasdefault">
+      and remember these as my default search options
+    </label>
+  </p>
+[% END %]
+        
+[% IF userdefaultquery %]
+  <p>
+    <a href="query.cgi?nukedefaultquery=1&amp;token=
+       [%- issue_hash_token(['nukedefaultquery']) FILTER uri %]">
+      Set my default search back to the system default</a>.
+  </p>
+[% END %]

diff --git a/template/en/default/search/search-advanced.html.tmpl b/template/en/default/search/search-advanced.html.tmpl
new file mode 100644 (file)
index 0000000..2bff834
--- /dev/null
+++ b/template/en/default/search/search-advanced.html.tmpl
@@ -0,0 +1,55 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # This template has no interface. However, to use it, you need to fulfill
+  # the interfaces of search/form.html.tmpl, search/knob.html.tmpl and
+  # search/boolean-charts.html.tmpl.
+  #%]
+
+[% USE Bugzilla %]
+[% cgi = Bugzilla.cgi %]
+
+[% javascript = BLOCK %]
+function remove_token() {
+  if (queryform.token) {
+    var asDefault = document.getElementById('remasdefault');
+    queryform.token.disabled = !asDefault.checked;
+  }
+}
+[% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = "Search for $terms.bugs"
+  yui = [ 'autocomplete', 'calendar' ]
+  javascript = javascript
+  javascript_urls = [ "js/util.js", "js/TUI.js", "js/field.js"]
+  style_urls = [ "skins/standard/search_form.css" ]
+  doc_section = "query.html"
+%]
+
+[% WRAPPER search/tabs.html.tmpl %]
+
+[% button_name = "Search" %]
+
+<p id="search_help">Hover your mouse over each field label to get help for that field.</p>
+
+<form method="post" action="buglist.cgi" name="queryform" id="queryform"
+      onsubmit="remove_token()">
+
+[% PROCESS search/form.html.tmpl %]
+
+[% PROCESS "search/boolean-charts.html.tmpl" %]
+
+[% PROCESS search/knob.html.tmpl %]
+
+</form>
+
+[% END %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/search/search-create-series.html.tmpl b/template/en/default/search/search-create-series.html.tmpl
new file mode 100644 (file)
index 0000000..d2f8f7d
--- /dev/null
+++ b/template/en/default/search/search-create-series.html.tmpl
@@ -0,0 +1,57 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # This template has no interface. However, to use it, you need to fulfill
+  # the interfaces of search/form.html.tmpl, reports/series.html.tmpl and
+  # search/boolean-charts.html.tmpl.
+  #%]
+
+[% js_data = BLOCK %]
+    var queryform = "chartform";
+[% END %]
+
+[% PROCESS global/header.html.tmpl 
+  title = "Create New Data Set"
+  onload = "doOnSelectProduct(0);"
+  yui = [ 'autocomplete', 'calendar' ]
+  javascript = js_data 
+  javascript_urls = [ "js/util.js", "js/TUI.js", "js/field.js" ]
+  style_urls = [ "skins/standard/search_form.css" ]
+  doc_section = "reporting.html#charts-new-series"
+%]
+
+<form method="get" action="chart.cgi" name="chartform">
+  
+[% PROCESS search/form.html.tmpl %]
+
+<p>
+  <input type="submit" id="action-search" name="action-search" value="Run Search">
+  to see which [% terms.bugs %] would be included in this data set.
+</p>
+    
+<h3>Data Set Parameters</h3>
+      
+[% PROCESS reports/series.html.tmpl 
+   button_name = "Create Data Set" %]
+  <input type="hidden" name="action" value="create">
+  <input type="hidden" name="token" value="[% issue_hash_token(['create-series']) FILTER html %]">
+
+<script type="text/javascript">
+  document.chartform.category[0].selected = true;
+  catSelected();
+  checkNewState();
+</script>
+      
+<hr>
+
+[% PROCESS "search/boolean-charts.html.tmpl" %]
+
+</form>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/search/search-plugin.xml.tmpl b/template/en/default/search/search-plugin.xml.tmpl
new file mode 100644 (file)
index 0000000..27f5b77
--- /dev/null
+++ b/template/en/default/search/search-plugin.xml.tmpl
@@ -0,0 +1,19 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+<?xml version="1.0" encoding="UTF-8"?>
+<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/">
+<ShortName>[% terms.Bugzilla %]</ShortName>
+<Description>[% terms.Bugzilla %] Quick Search</Description>
+<InputEncoding>UTF-8</InputEncoding>
+[% IF favicon %]
+  <Image width="16" height="16">data:image/x-icon;base64,[% favicon FILTER base64 %]</Image>
+[% ELSE %]
+  <Image width="16" height="16">data:image/x-icon;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAIAAACQkWg2AAAABGdBTUEAAK%2FINwWK6QAAABl0RVh0U29mdHdhcmUAQWRvYmUgSW1hZ2VSZWFkeXHJZTwAAALBSURBVHjaYnxckcEAA3%2F%2B%2FT%2F17LUcH%2Fevf%2F8U%2BHmYGBkZMABAALEgc%2B68%2F3T227cf2tJKKhJLt59n%2FfmbnYnZV1KEhYkJrgYggBghNrz78fPIi3d8uvKBIdb%2FOaWPnzitLc97%2Bc5rFXnhnVO3%2BslLwjUABBDIhnsfPl%2Fj53VO91FX4Gfgkjxw%2Fd%2F6Q49%2FWStqyAj%2B%2B88gZqn%2B9u5rYU52iAaAAGL69%2F%2F%2F2d9%2FYiMclGT4fv76%2BZ9DbO%2FeA39%2BfJHVcvj5l%2Bnh03e%2FWThOvnwLtwEgAAAxAM7%2FBPj8%2FRYkHQYHAf3%2F%2Fv%2F%2B%2Fv8BAVNTUPX18yorLNHE2S8mB%2FT2%2Bq7a4dvu8iUSDgAAAAKICRgUv3%2F8ZGKGeIvpz6eXBvq61lZWLMwMv%2F5zMP7%2FqSAjVFyZ%2FNvZftuT10DnAAQAMQDO%2FwQIBAPz5Or6%2Ff0CBQEAAgT99ubq38z2%2BwT18%2FAM%2F%2BkNDAv6%2FQMCAA1GVVrhMze5h4kCCORpkd9%2F3n74KiHO%2B%2BffX8b%2Ff7m%2BXWP985%2Bf5R%2BPLNdfoK%2F%2F%2Ffv39%2BePj2%2FkZYR0fe0BAgikQZGX%2B9b9FzLS%2FH%2F%2B%2FGVgYGRlZWNlA7nv7z9QuDP8%2B8nw%2FRXjn68Mv4Gu%2FAwQQCCni3FxPLn7nIGZGegfNhYmNjYWZnBMASOakZER6Eumf9%2FYGT4y%2FHx%2F%2BfBFgAAC2cDGzPT99WeGvwzvv%2Fx89vrr%2F39%2FJER4pcT5Gf4z%2FP37D2jtj9%2B%2FL918fmzrKSsWNoAAgiaN%2Fz9%2Fff%2F6S4CP8%2BWbz9vWHfv54aukpAAz0Og%2Ff%2F7%2F%2Bs36668cO3ugED9QJUAAQTUArf7%2F8x87D9vRjcejhPiZhAUYcACAAGI5%2FOHH9ddvXzAxmjz%2B8P8lw4fXn5l4eRlwA4AAYmaTkBFg%2FKvJwfbkwZuXN57y%2Fv%2F34stXGR4uRmxpGwgAAgwA4%2FkfrfCWvLQAAAAASUVORK5CYII%3D</Image>
+[% END %]
+<Url type="text/html" method="GET" template="[% urlbase FILTER xml %]buglist.cgi?quicksearch={searchTerms}"/>
+</OpenSearchDescription>

diff --git a/template/en/default/search/search-report-graph.html.tmpl b/template/en/default/search/search-report-graph.html.tmpl
new file mode 100644 (file)
index 0000000..698132e
--- /dev/null
+++ b/template/en/default/search/search-report-graph.html.tmpl
@@ -0,0 +1,128 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # This template has no interface. However, to use it, you need to fulfill
+  # the interfaces of the templates it contains.
+  #%]
+
+[% js_data = BLOCK %]
+var queryform = "reportform"
+[% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = "Generate Graphical Report"
+  onload = "doOnSelectProduct(0); chartTypeChanged()"
+  yui = [ 'autocomplete', 'calendar' ]
+  javascript = js_data
+  javascript_urls = [ "js/util.js", "js/TUI.js", "js/field.js" ]
+  style_urls = [ "skins/standard/search_form.css" ]
+  doc_section = "reporting.html#reports"
+%]
+
+[% PROCESS "search/search-report-select.html.tmpl" %]
+
+<p>
+  Choose one or more fields as your axes, and then refine your set of 
+  [% terms.bugs %] using the rest of the form.
+</p>
+
+<script type="text/javascript"><!--
+  [%# The Y-axis fields are not used for pie charts %]
+  function chartTypeChanged() {
+    // format[2] is the pie chart radio button
+    if (document.reportform.format[2].checked == true) {
+      document.reportform.y_axis_field.disabled = true;
+      document.reportform.cumulate[0].disabled = true;
+      document.reportform.cumulate[1].disabled = true;
+    } else {
+      document.reportform.y_axis_field.disabled = false;
+      document.reportform.cumulate[0].disabled = false;
+      document.reportform.cumulate[1].disabled = false;
+    }
+  }
+// -->
+</script>
+
+[% button_name = "Generate Report" %]
+
+<form method="get" action="report.cgi" name="reportform" id="reportform">
+
+<table align="center">
+  <tr>
+    <td valign="middle">
+      <b>Vertical Axis:</b><br>
+      <noscript><small>(not for pie charts)</small><br></noscript>
+      [% PROCESS select name = 'y_axis_field' %]<br>
+      <br>
+        <b>Plot Data Sets:</b><br>
+        <input type="radio" name="cumulate" value="0"
+        [% " checked" IF default.cumulate.0 != "1" %]>
+        Individually<br>
+        <input type="radio" name="cumulate" value="1"
+        [% " checked" IF default.cumulate.0 == "1" %]>
+        Stacked
+    </td>
+    <td width="150" height="150">
+      <table border="1" width="100%" height="100%">
+        <tr>
+          <td align="center" valign="middle">
+            <b>Multiple Images:</b><br>
+            [% PROCESS select name = 'z_axis_field' %]
+          </td>
+        </tr>
+      </table>
+    </td>
+    <td rowspan="2">
+      <b>Format:</b><br>
+      [% chart_formats = [
+        { name => "line", description => "Line Graph" },
+        { name => "bar",  description => "Bar Chart" },
+        { name => "pie",  description => "Pie Chart" } ] %]
+      [% default.chart_format.0 = default.chart_format.0 || "bar" %]
+
+      [% FOREACH chart_format = chart_formats %]
+        <input type="radio" name="format"
+               value="[% chart_format.name FILTER html %]"
+               onchange="chartTypeChanged()"
+          [% " checked" IF default.chart_format.0 == chart_format.name %]>
+          [% chart_format.description FILTER html %]<br>
+      [% END %]
+    </td>
+  </tr>
+
+  <tr>
+    <td>
+    </td>
+    <td align="left">
+      <b>Horizontal Axis:</b>
+      [% PROCESS select name = 'x_axis_field' %]<br>
+      <label for="x_labels_vertical"><b>Vertical labels:</b></label>
+      <input type="checkbox" name="x_labels_vertical" id="x_labels_vertical"
+             value="1"
+         [% " checked" IF default.x_labels_vertical.0 == "1" %]>
+     </td>
+    <td>
+    </td>
+  </tr>
+</table>
+
+<hr>
+
+[% PROCESS search/form.html.tmpl %]
+
+[% PROCESS "search/boolean-charts.html.tmpl" %]
+
+  <div id="knob">
+    <input type="submit" id="[% button_name FILTER css_class_quote %]"
+           value="[% button_name FILTER html %]">
+    <input type="hidden" name="action" value="wrap">
+  </div>
+</form>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/search/search-report-select.html.tmpl b/template/en/default/search/search-report-select.html.tmpl
new file mode 100644 (file)
index 0000000..93b4c44
--- /dev/null
+++ b/template/en/default/search/search-report-select.html.tmpl
@@ -0,0 +1,29 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # name: string. The name of the select block to output.
+  # default.$name.0: string. The default value for the block, if any.
+  #%]
+
+[% BLOCK select %]
+  [% Hook.process('rep_fields', 'search/search-report-select.html.tmpl') %]
+
+  <select name="[% name FILTER html %]">
+    <option value="">&lt;none&gt;</option>
+    
+    [% FOREACH field = report_columns.keys.sort %]
+      [% NEXT IF field == "classification" AND !Param('useclassification') %]
+      [% NEXT IF field == "target_milestone" AND !Param('usetargetmilestone') %]
+      [% NEXT IF field == "qa_contact" AND !Param('useqacontact') %]
+      <option value="[% field FILTER html %]" 
+        [% " selected" IF default.$name.0 == field %]>
+        [% field_descs.$field || field FILTER html %]</option>
+    [% END %]
+  </select>
+[% END %]

diff --git a/template/en/default/search/search-report-table.html.tmpl b/template/en/default/search/search-report-table.html.tmpl
new file mode 100644 (file)
index 0000000..7e0a002
--- /dev/null
+++ b/template/en/default/search/search-report-table.html.tmpl
@@ -0,0 +1,81 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # This template has no interface. However, to use it, you need to fulfill
+  # the interfaces of the templates it contains.
+  #%]
+
+[% js_data = BLOCK %]
+var queryform = "reportform"
+[% END %]
+
+[% PROCESS global/header.html.tmpl
+  title = "Generate Tabular Report"
+  onload = "doOnSelectProduct(0)"
+  yui = [ 'autocomplete', 'calendar' ]
+  javascript = js_data
+  javascript_urls = [ "js/util.js", "js/TUI.js", "js/field.js" ]
+  style_urls = [ "skins/standard/search_form.css" ]
+  doc_section = "reporting.html#reports"
+%]
+
+[% PROCESS "search/search-report-select.html.tmpl" %]
+
+<p>
+  Choose one or more fields as your axes, and then refine your set of 
+  [% terms.bugs %] using the rest of the form.
+</p>
+
+[% button_name = "Generate Report" %]
+
+<form method="get" action="report.cgi" name="reportform" id="reportform">
+
+<table align="center">
+  <tr>
+    <td>
+    </td>
+    <td align="center">
+      <b>Horizontal Axis:</b>
+      [% PROCESS select name = 'x_axis_field' %]
+    </td>
+  </tr>
+
+  <tr>
+    <td valign="middle" align="center">
+      <b>Vertical Axis:</b><br>
+      [% PROCESS select name = 'y_axis_field' %]
+    </td>
+    <td width="150" height="150">
+      <table border="1" width="100%">
+        <tr>
+          <td align="center" valign="middle" height="150">
+            <b>Multiple Tables:</b><br>
+            [% PROCESS select name = 'z_axis_field' %]
+          </td>
+        </tr>
+      </table>
+    </td>
+  </tr>
+</table>
+
+<hr>
+
+  [% PROCESS search/form.html.tmpl %]
+
+  [% PROCESS "search/boolean-charts.html.tmpl" %]
+
+  <div id="knob">
+    <input type="submit" id="[% button_name FILTER css_class_quote %]"
+         value="[% button_name FILTER html %]">
+    <input type="hidden" name="format" value="table">
+    <input type="hidden" name="action" value="wrap">
+  </div>
+</form>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/search/search-specific.html.tmpl b/template/en/default/search/search-specific.html.tmpl
new file mode 100644 (file)
index 0000000..1093f70
--- /dev/null
+++ b/template/en/default/search/search-specific.html.tmpl
@@ -0,0 +1,122 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS global/header.html.tmpl 
+  title = "Simple Search"
+  style_urls = [ "skins/standard/search_form.css" ]
+%]
+
+[% WRAPPER search/tabs.html.tmpl %]
+
+<p>
+Find a specific [% terms.bug %] by entering words that describe it.  
+[% terms.Bugzilla %] will search [% terms.bug %] descriptions and comments
+for those words and return a list of matching [% terms.bugs %] sorted
+by relevance.
+</p>
+
+<p>
+For example, if the [% terms.bug %] you are looking for is a browser crash when you go to a secure web site with an embedded Flash animation, you might search
+for "crash secure SSL flash".
+</p>
+
+<form name="queryform" method="get" action="buglist.cgi">
+<input type="hidden" name="query_format" value="specific">
+<input type="hidden" name="order" value="relevance desc">
+<input type="hidden" id="no_redirect" name="no_redirect" value="0">
+<script type="text/javascript">
+  if (history && history.replaceState) {
+    var no_redirect = document.getElementById("no_redirect");
+    no_redirect.value = 1;
+  }
+</script>
+
+<table summary="Search fields" class="bz_simple_search_form">
+  <tr>
+    <th>
+      <label for="bug_status">[% field_descs.bug_status FILTER html %]:</label>
+    </th>
+    <td>
+      <select name="bug_status" id="bug_status">
+        [% statuses = [ { name = 'open', label = "Open" },
+                        { name = 'closed', label = "Closed" },
+                        { name = 'all', label = "All" } ] %]
+        [% FOREACH status = statuses %]
+            <option value="__[% status.name %]__" 
+                  [% " selected" IF default.bug_status.0 == "__${status.name}__" %]>
+            [% status.label FILTER html %]
+          </option>
+        [% END %]
+      </select>
+    </td>
+  </tr>
+  <tr>
+    <th>
+      <label for="product">[% field_descs.product FILTER html %]:</label>
+    </th>
+    <td>
+      <select name="product" id="product">
+        <option value="">All</option>
+        [% IF Param('useclassification') %]
+          [% FOREACH c = classification %]
+            <optgroup label="[% c.name FILTER html %]">
+            [% FOREACH p = user.get_selectable_products(c.id) %]
+              [% IF p.components.size %]
+                <option value="[% p.name FILTER html %]"
+                  [% " selected" IF default.product.contains(p.name) %]>
+                  [% p.name FILTER html %]
+                </option>
+              [% END %]
+            [% END %]
+            </optgroup>
+          [% END %]
+        [% ELSE %]
+          [% FOREACH p = product %]
+            <option value="[% p.name FILTER html %]"
+              [% " selected" IF default.product.contains(p.name) %]>
+              [% p.name FILTER html %]
+            </option>
+          [% END %]
+        [% END %]
+      </select>
+    </td>
+  </tr>
+  <tr>
+    <th>
+      <label for="content">Words:</label>
+    </th>
+    <td>
+      <input name="content" size="40" id="content"
+             value="[% default.content.0 FILTER html %]">
+      <script type="text/javascript"> <!--
+          document.forms['queryform'].content.focus(); 
+      // -->
+      </script>
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td>
+    
+      [% IF Param('search_allow_no_criteria') %]
+        <input type="submit" id="search" value="Search">
+      [% ELSE %]
+        <input type="submit" id="search" value="Search"
+             onclick="if (this.form.content.value == '')
+                      {alert('The Words field cannot be empty. You have to ' +
+                             'enter at least one word in your search criteria.');
+                       return false;} return true;">
+      [% END %]
+    </td>
+  </tr>
+</table>
+</form>
+
+[% END %]
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/search/tabs.html.tmpl b/template/en/default/search/tabs.html.tmpl
new file mode 100644 (file)
index 0000000..f7703fd
--- /dev/null
+++ b/template/en/default/search/tabs.html.tmpl
@@ -0,0 +1,23 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # This template has no interface.
+  #%]
+
+[% WRAPPER global/tabs.html.tmpl
+     tabs = [ { name => 'specific', label => "Simple Search",
+                link => "query.cgi?format=specific" },
+              { name => 'advanced', label => "Advanced Search",
+                link => "query.cgi?format=advanced" } ]
+     current_tab_name = query_format || format || "advanced"
+%]
+
+[% content %]
+
+[% END %]

diff --git a/template/en/default/search/type-select.html.tmpl b/template/en/default/search/type-select.html.tmpl
new file mode 100644 (file)
index 0000000..b4affbb
--- /dev/null
+++ b/template/en/default/search/type-select.html.tmpl
@@ -0,0 +1,18 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[% PROCESS "global/field-descs.none.tmpl" %]
+  
+<select name="[% name FILTER html %]" title="Search type"
+        class="[% class FILTER css_class_quote %]">
+  [% FOREACH type = types %]
+    <option value="[% type FILTER html %]"
+            [%- ' selected="selected"' IF type == selected %]>
+        [%- search_descs.$type FILTER html %]</option>
+  [% END %]
+</select>

diff --git a/template/en/default/setup/strings.txt.pl b/template/en/default/setup/strings.txt.pl
new file mode 100644 (file)
index 0000000..d134ef4
--- /dev/null
+++ b/template/en/default/setup/strings.txt.pl
@@ -0,0 +1,417 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# This file contains a single hash named %strings, which is used by the
+# installation code to display strings before Template-Toolkit can safely
+# be loaded.
+#
+# Each string supports a very simple substitution system, where you can
+# have variables named like ##this## and they'll be replaced by the string
+# variable with that name.
+#
+# Please keep the strings in alphabetical order by their name.
+
+%strings = (
+    any  => 'any',
+    apachectl_failed => <<END,
+WARNING: We could not check the configuration of Apache. This sometimes
+happens when you are not running checksetup.pl as ##root##. To see the
+problem we ran into, run: ##command##
+END
+    bad_executable => 'not a valid executable: ##bin##',
+    blacklisted => '(blacklisted)',
+    bz_schema_exists_before_220 => <<'END',
+You are upgrading from a version before 2.20, but the bz_schema table
+already exists. This means that you restored a mysqldump into the Bugzilla
+database without first dropping the already-existing Bugzilla database,
+at some point. Whenever you restore a Bugzilla database backup, you must
+always drop the entire database first.
+
+Please drop your Bugzilla database and restore it from a backup that does
+not contain the bz_schema table. If for some reason you cannot do this, you
+can connect to your MySQL database and drop the bz_schema table, as a last
+resort.
+END
+    checking_for => 'Checking for',
+    checking_dbd      => 'Checking available perl DBD modules...',
+    checking_optional => 'The following Perl modules are optional:',
+    checking_modules  => 'Checking perl modules...',
+    chmod_failed      => '##path##: Failed to change permissions: ##error##',
+    chown_failed      => '##path##: Failed to change ownership: ##error##',
+    commands_dbd      => <<EOT,
+YOU MUST RUN ONE OF THE FOLLOWING COMMANDS (depending on which database
+you use):
+EOT
+    commands_optional => 'COMMANDS TO INSTALL OPTIONAL MODULES:',
+    commands_required => <<EOT,
+COMMANDS TO INSTALL REQUIRED MODULES (You *must* run all these commands
+and then re-run checksetup.pl):
+EOT
+    continue_without_answers => <<'END',
+Re-run checksetup.pl in interactive mode (without an 'answers' file)
+to continue.
+END
+    cpan_bugzilla_home => 
+        "WARNING: Using the Bugzilla directory as the CPAN home.",
+    db_enum_setup  => "Setting up choices for standard drop-down fields:",
+    db_schema_init => "Initializing bz_schema...",
+    db_table_new   => "Adding new table ##table##...",
+    db_table_setup => "Creating tables...",
+    done => 'done.',
+    enter_or_ctrl_c => "Press Enter to continue or Ctrl-C to exit...",
+    error_localconfig_read => <<'END',
+An error has occurred while reading the ##localconfig## file.  The text of
+the error message is:
+
+##error##
+
+Please fix the error in the localconfig file. Alternately, rename your
+localconfig file and re-run checksetup.pl to have it create a new
+localconfig file:
+
+  $ mv -f localconfig localconfig.old
+  $ ./checksetup.pl
+END
+    extension_must_return_name => <<END,
+##file## returned ##returned##, which is not a valid name for an extension.
+Extensions must return their name, not <code>1</code> or a number. See
+the documentation of Bugzilla::Extension for details.
+END
+    feature_auth_ldap         => 'LDAP Authentication',
+    feature_auth_radius       => 'RADIUS Authentication',
+    feature_graphical_reports => 'Graphical Reports',
+    feature_html_desc         => 'More HTML in Product/Group Descriptions',
+    feature_inbound_email     => 'Inbound Email',
+    feature_jobqueue          => 'Mail Queueing',
+    feature_jsonrpc           => 'JSON-RPC Interface',
+    feature_jsonrpc_faster    => 'Make JSON-RPC Faster',
+    feature_new_charts        => 'New Charts',
+    feature_old_charts        => 'Old Charts',
+    feature_mod_perl          => 'mod_perl',
+    feature_moving            => 'Move Bugs Between Installations',
+    feature_patch_viewer      => 'Patch Viewer',
+    feature_smtp_auth         => 'SMTP Authentication',
+    feature_smtp_ssl          => 'SSL Support for SMTP',
+    feature_updates           => 'Automatic Update Notifications',
+    feature_xmlrpc            => 'XML-RPC Interface',
+    feature_detect_charset    => 'Automatic charset detection for text attachments',
+    feature_typesniffer       => 'Sniff MIME type of attachments',
+
+    file_remove => 'Removing ##name##...',
+    file_rename => 'Renaming ##from## to ##to##...',
+    header => "* This is Bugzilla ##bz_ver## on perl ##perl_ver##\n"
+            . "* Running on ##os_name## ##os_ver##",
+    install_all => <<EOT,
+
+To attempt an automatic install of every required and optional module
+with one command, do:
+
+  ##perl## install-module.pl --all
+
+EOT
+    install_data_too_long => <<EOT,
+WARNING: Some of the data in the ##table##.##column## column is longer than
+its new length limit of ##max_length## characters. The data that needs to be
+fixed is printed below with the value of the ##id_column## column first and
+then the value of the ##column## column that needs to be fixed:
+
+EOT
+    install_module => 'Installing ##module## version ##version##...',
+    installation_failed => '*** Installation aborted. Read the messages above. ***',
+    install_no_compiler => <<END,
+ERROR: Using install-module.pl requires that you install a compiler, such as
+gcc.
+END
+    install_no_make => <<END,
+ERROR: Using install-module.pl requires that you install "make".
+END
+    lc_new_vars => <<'END',
+This version of Bugzilla contains some variables that you may want to
+change and adapt to your local settings. The following variables are
+new to ##localconfig## since you last ran checksetup.pl:
+
+##new_vars##
+
+Please edit the file ##localconfig## and then re-run checksetup.pl
+to complete your installation.
+END
+    lc_old_vars => <<'END',
+The following variables are no longer used in ##localconfig##, and
+have been moved to ##old_file##: ##vars##
+END
+    localconfig_create_htaccess => <<'END',
+If you are using Apache as your web server, Bugzilla can create .htaccess
+files for you, which will keep this file (localconfig) and other
+confidential files from being read over the web.
+
+If this is set to 1, checksetup.pl will create .htaccess files if 
+they don't exist.
+
+If this is set to 0, checksetup.pl will not create .htaccess files.
+END
+    localconfig_cvsbin => <<'END',
+If you want to use the CVS integration of the Patch Viewer, please specify
+the full path to the "cvs" executable here.
+END
+    localconfig_db_check => <<'END',
+Should checksetup.pl try to verify that your database setup is correct?
+With some combinations of database servers/Perl modules/moonphase this
+doesn't work, and so you can try setting this to 0 to make checksetup.pl
+run.
+END
+    localconfig_db_driver => <<'END',
+What SQL database to use. Default is mysql. List of supported databases
+can be obtained by listing Bugzilla/DB directory - every module corresponds
+to one supported database and the name of the module (before ".pm")
+corresponds to a valid value for this variable.
+END
+    localconfig_db_host => <<'END',
+The DNS name or IP address of the host that the database server runs on.
+END
+    localconfig_db_name => <<'END',
+The name of the database. For Oracle, this is the database's SID. For
+SQLite, this is a name (or path) for the DB file.
+END
+    localconfig_db_pass => <<'END',
+Enter your database password here. It's normally advisable to specify
+a password for your bugzilla database user.
+If you use apostrophe (') or a backslash (\) in your password, you'll
+need to escape it by preceding it with a '\' character. (\') or (\)
+(It is far simpler to just not use those characters.)
+END
+    localconfig_db_port => <<'END',
+Sometimes the database server is running on a non-standard port. If that's
+the case for your database server, set this to the port number that your
+database server is running on. Setting this to 0 means "use the default
+port for my database server."
+END
+    localconfig_db_sock => <<'END',
+MySQL Only: Enter a path to the unix socket for MySQL. If this is
+blank, then MySQL's compiled-in default will be used. You probably
+want that.
+END
+    localconfig_db_user => "Who we connect to the database as.",
+    localconfig_diffpath => <<'END',
+For the "Difference Between Two Patches" feature to work, we need to know
+what directory the "diff" bin is in. (You only need to set this if you
+are using that feature of the Patch Viewer.)
+END
+    localconfig_index_html => <<'END',
+Most web servers will allow you to use index.cgi as a directory
+index, and many come preconfigured that way, but if yours doesn't
+then you'll need an index.html file that provides redirection
+to index.cgi. Setting $index_html to 1 below will allow
+checksetup.pl to create an index.html for you if it doesn't exist.
+NOTE: checksetup.pl will not replace an existing file, so if you
+      wish to have checksetup.pl create one for you, you must
+      make sure that index.html doesn't already exist.
+END
+    localconfig_interdiffbin => <<'END',
+If you want to use the "Difference Between Two Patches" feature of the
+Patch Viewer, please specify the full path to the "interdiff" executable
+here.
+END
+    localconfig_site_wide_secret => <<'END',
+This secret key is used by your installation for the creation and
+validation of encrypted tokens. These tokens are used to implement
+security features in Bugzilla, to protect against certain types of attacks.
+A random string is generated by default. It's very important that this key
+is kept secret. It also must be very long.
+END
+    localconfig_use_suexec => <<'END',
+Set this to 1 if Bugzilla runs in an Apache SuexecUserGroup environment.
+
+If your web server runs control panel software (cPanel, Plesk or similar),
+or if your Bugzilla is to run in a shared hosting environment, then you are
+almost certainly in an Apache SuexecUserGroup environment.
+
+If this is a Windows box, ignore this setting, as it does nothing.
+
+If set to 0, checksetup.pl will set file permissions appropriately for
+a normal webserver environment.
+
+If set to 1, checksetup.pl will set file permissions so that Bugzilla
+works in a SuexecUserGroup environment. 
+END
+    localconfig_webservergroup => <<'END',
+The name of the group that your web server runs as. On Red Hat
+distributions, this is usually "apache". On Debian/Ubuntu, it is 
+usually "www-data".
+
+If you have use_suexec turned on below, then this is instead the name
+of the group that your web server switches to to run cgi files.
+
+If this is a Windows machine, ignore this setting, as it does nothing.
+
+If you do not have access to the group your scripts will run under,
+set this to "". If you do set this to "", then your Bugzilla installation
+will be _VERY_ insecure, because some files will be world readable/writable,
+and so anyone who can get local access to your machine can do whatever they
+want. You should only have this set to "" if this is a testing installation
+and you cannot set this up any other way. YOU HAVE BEEN WARNED!
+
+If you set this to anything other than "", you will need to run checksetup.pl
+as ##root## or as a user who is a member of the specified group.
+END
+    max_allowed_packet => <<EOT,
+WARNING: You need to set the max_allowed_packet parameter in your MySQL
+configuration to at least ##needed##. Currently it is set to ##current##.
+You can set this parameter in the [mysqld] section of your MySQL
+configuration file.
+EOT
+    min_version_required => "Minimum version required: ",
+
+# Note: When translating these "modules" messages, don't change the formatting
+# if possible, because there is hardcoded formatting in 
+# Bugzilla::Install::Requirements to match the box formatting.
+    modules_message_apache => <<END,
+***********************************************************************
+* APACHE MODULES                                                      *
+***********************************************************************
+* Normally, when Bugzilla is upgraded, all Bugzilla users have to     *
+* clear their browser cache or Bugzilla will break. If you enable     *
+* certain modules in your Apache configuration (usually called        *
+* httpd.conf or apache2.conf) then your users will not have to clear  *
+* their caches when you upgrade Bugzilla. The modules you need to     *
+* enable are:                                                         *
+*                                                                     *
+END
+    modules_message_db => <<EOT,
+***********************************************************************
+* DATABASE ACCESS                                                     *
+***********************************************************************
+* In order to access your database, Bugzilla requires that the        *
+* correct "DBD" module be installed for the database that you are     *
+* running. See below for the correct command to run to install the    *
+* appropriate module for your database.                               *
+EOT
+    modules_message_optional => <<EOT,
+***********************************************************************
+* OPTIONAL MODULES                                                    *
+***********************************************************************
+* Certain Perl modules are not required by Bugzilla, but by           *
+* installing the latest version you gain access to additional         *
+* features.                                                           *
+*                                                                     *
+* The optional modules you do not have installed are listed below,    *
+* with the name of the feature they enable. Below that table are the  *
+* commands to install each module.                                    *
+EOT
+    modules_message_required => <<EOT,
+***********************************************************************
+* REQUIRED MODULES                                                    *
+***********************************************************************
+* Bugzilla requires you to install some Perl modules which are either *
+* missing from your system, or the version on your system is too old. *
+* See below for commands to install these modules.                    *
+EOT
+
+    module_found => "found v##ver##",
+    module_not_found => "not found",
+    module_ok => 'ok',
+    module_unknown_version => "found unknown version",
+    no_such_module => "There is no Perl module on CPAN named ##module##.",
+    mysql_innodb_disabled => <<'END',
+InnoDB is disabled in your MySQL installation.
+Bugzilla requires InnoDB to be enabled.
+Please enable it and then re-run checksetup.pl.
+END
+    mysql_index_renaming => <<'END',
+We are about to rename old indexes. The estimated time to complete
+renaming is ##minutes## minutes. You cannot interrupt this action once
+it has begun. If you would like to cancel, press Ctrl-C now...
+(Waiting 45 seconds...)
+END
+    mysql_utf8_conversion => <<'END',
+WARNING: We are about to convert your table storage format to UTF-8. This
+         allows Bugzilla to correctly store and sort international characters.
+         However, if you have any non-UTF-8 data in your database,
+         it ***WILL BE DELETED*** by this process. So, before
+         you continue with checksetup.pl, if you have any non-UTF-8
+         data (or even if you're not sure) you should press Ctrl-C now
+         to interrupt checksetup.pl, and run contrib/recode.pl to make all
+         the data in your database into UTF-8. You should also back up your
+         database before continuing. This will affect every single table
+         in the database, even non-Bugzilla tables.
+
+         If you ever used a version of Bugzilla before 2.22, we STRONGLY
+         recommend that you stop checksetup.pl NOW and run contrib/recode.pl.
+END
+    no_checksetup_from_cgi => <<END,
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+          "http://www.w3.org/TR/html4/strict.dtd">
+<html>
+  <head>
+    <title>checksetup.pl cannot run from a web browser</title>
+  </head>
+
+  <body>
+    <h1>checksetup.pl cannot run from a web browser</h1>
+    <p>
+      You <b>must not</b> execute this script from your web browser.
+      To install or upgrade Bugzilla, run this script from
+      the command-line (e.g. <tt>bash</tt> or <tt>ssh</tt> on Linux
+      or <tt>cmd.exe</tt> on Windows), and follow instructions given there.
+    </p>
+
+    <p>
+      For more information on how to install Bugzilla, please
+      <a href="http://www.bugzilla.org/docs/">read the documentation</a>
+      available on the official Bugzilla website.
+    </p>
+  </body>
+</html>
+END
+    patchutils_missing => <<'END',
+OPTIONAL NOTE: If you want to be able to use the 'difference between two
+patches' feature of Bugzilla (which requires the PatchReader Perl module
+as well), you should install patchutils from:
+
+    http://cyberelk.net/tim/patchutils/
+END
+    template_precompile   => "Precompiling templates...",
+    template_removal_failed => <<END,
+WARNING: The directory '##template_cache##' could not be removed.
+         It has been moved into '##deleteme##', which should be
+         deleted manually to conserve disk space.
+END
+    template_removing_dir => "Removing existing compiled templates...",
+    update_cf_invalid_name => 
+        "Removing custom field '##field##', because it has an invalid name...",
+    update_flags_bad_name => <<'END',
+"##flag##" is not a valid name for a flag. Rename it to not have any spaces
+or commas.
+END
+    update_nomail_bad => <<'END',
+WARNING: The following users were listed in ##data##/nomail, but do
+not have an account here. The unmatched entries have been moved to 
+##data##/nomail.bad:
+END
+    update_summary_truncate_comment => 
+        "The original value of the Summary field was longer than 255"
+        . " characters, and so it was truncated during an upgrade."
+        . " The original summary was:\n\n##summary##",
+    update_summary_truncated => <<'END',
+WARNING: Some of your bugs had summaries longer than 255 characters.
+They have had their original summary copied into a comment, and then
+the summary was truncated to 255 characters. The affected bug numbers were:
+END
+    update_quips => <<'END',
+Quips are now stored in the database, rather than in an external file.
+The quips previously stored in ##data##/comments have been copied into
+the database, and that file has been renamed to ##data##/comments.bak
+You may delete the renamed file once you have confirmed that all your
+quips were moved successfully.
+END
+    update_queries_to_tags => "Populating the new 'tag' table:",
+    webdot_bad_htaccess => <<END,
+WARNING: Dependency graph images are not accessible.
+Delete ##dir##/.htaccess and re-run checksetup.pl.
+END
+);
+
+1;

diff --git a/template/en/default/welcome-admin.html.tmpl b/template/en/default/welcome-admin.html.tmpl
new file mode 100644 (file)
index 0000000..0f7626c
--- /dev/null
+++ b/template/en/default/welcome-admin.html.tmpl
@@ -0,0 +1,77 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # none
+  #%]
+
+[% title = BLOCK %]Welcome to [% terms.Bugzilla %][% END %]
+
+[% PROCESS global/header.html.tmpl
+   title = title
+   header_addl_info = "version $constants.BUGZILLA_VERSION"
+   style_urls = [ 'skins/standard/index.css' ]
+%]
+
+<div id="welcome-admin">
+  <p>Welcome, [% user.identity FILTER html %].</p>
+
+  <p>You are seeing this page because some of the core parameters have not been set up yet.
+  The goal of this page is to inform you about the last steps required to set up
+  your installation correctly.</p>
+
+  <p>As an administrator, you have access to all administrative pages, accessible from
+  the <a href="admin.cgi">Administration</a> link visible at the bottom of this page.
+  This link will always be visible, on all pages. From there, you must visit at least
+  the <a href="editparams.cgi">Parameters</a> page, from where you can set all important
+  parameters for this installation; among others:</p>
+
+  <ul>
+    <li><a href="editparams.cgi?section=core#urlbase_desc">urlbase</a>, which is the URL
+    pointing to this installation and which will be used in emails (which is also the
+    reason you see this page: as long as this parameter is not set, you will see this
+    page again and again).</li>
+
+    <li><a href="editparams.cgi?section=core#cookiepath_desc">cookiepath</a> is important
+    for your browser to manage your cookies correctly.</li>
+
+    <li><a href="editparams.cgi?section=general#maintainer_desc">maintainer</a>,
+      the person responsible for this installation if something is
+      running wrongly.</li>
+  </ul>
+
+  <p>Also important are the following parameters:</p>
+
+  <ul>
+    <li><a href="editparams.cgi?section=auth#requirelogin_desc">requirelogin</a>, if turned
+    on, will protect your installation from users having no account on this installation.
+    In other words, users who are not explicitly authenticated with a valid account
+    cannot see any data. This is what you want if you want to keep your data private.</li>
+
+    <li><a href="editparams.cgi?section=auth#createemailregexp_desc">createemailregexp</a>
+    defines which users are allowed to create an account on this installation. If set
+    to ".*" (the default), everybody is free to create his own account. If set to
+    "@mycompany.com$", only users having an account @mycompany.com will be allowed to
+    create an account. If left blank, users will not be able to create accounts themselves;
+    only an administrator will be able to create one for them. If you want a private
+    installation, you must absolutely set this parameter to something different from
+    the default.</li>
+
+    <li><a href="editparams.cgi?section=mta#mail_delivery_method_desc">mail_delivery_method</a>
+    defines the method used to send emails, such as sendmail or SMTP. You have to set
+    it correctly to send emails.</li>
+  </ul>
+
+  <p>
+    After having set up all this, we recommend looking at [% terms.Bugzilla %]'s other
+    parameters as well at some time so that you understand what they do and whether you
+    want to modify their settings for your installation.
+  </p>
+</div>
+
+[% PROCESS global/footer.html.tmpl %]

diff --git a/template/en/default/whine/mail.html.tmpl b/template/en/default/whine/mail.html.tmpl
new file mode 100644 (file)
index 0000000..b581d68
--- /dev/null
+++ b/template/en/default/whine/mail.html.tmpl
@@ -0,0 +1,80 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # subject: subject line of message
+  # body: message body, shown before the query tables
+  # queries: array of hashes containing:
+  #     bugs: array containing hashes of fieldnames->values for each bug
+  #     title: the title given in the whine scheduling mechanism
+  #     name: the name of the query
+  #     columnlist: array of fieldnames to display in the mail
+  # author: user object for the person who scheduled this whine
+  # recipient: user object for the intended recipient of the message
+  #%]
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+  <head>
+    <title>
+      [[% terms.Bugzilla %]] [% subject FILTER html %]
+    </title>
+  </head>
+  <body bgcolor="#FFFFFF">
+
+    <pre>
+      [% body FILTER html %]
+    </pre>
+
+    <p align="left">
+      [% IF author.login == recipient.login %]
+        <a href="[%+ urlbase FILTER html %]editwhines.cgi">Click
+            here to edit your whine schedule</a>
+      [% ELSE %]
+        This search was scheduled by [% author.login FILTER html %].
+      [% END %]
+    </p>
+
+[% IF queries.size %]
+  [% FOREACH query=queries %]
+
+    <h2>[%+ query.title FILTER html %] ([% query.bugs.size %] [%+ terms.bugs %])</h2>
+
+    <table width="100%">
+      <tr>
+        <th align="left">ID</th>
+        [% FOREACH col = query.columnlist %]
+          [% NEXT IF col == 'bug_id' %]
+          <th align="left">[% field_descs.$col FILTER html %]</th>
+        [% END %]
+      </tr>
+
+      [% FOREACH bug=query.bugs %]
+        <tr>
+          <td align="left"><a href="[%+ urlbase FILTER html %]show_bug.cgi?id=
+              [%- bug.bug_id %]">[% bug.bug_id %]</a></td>
+          [% FOREACH col = query.columnlist %]
+            [% NEXT IF col == 'bug_id' %]
+            <td align="left">[% display_value(col, bug.$col) FILTER html %]</td>
+          [% END %]
+        </tr>
+      [% END %]
+    </table>
+
+    [% IF author.login == recipient.login %]
+      <p align="left">
+        <a href="[% urlbase FILTER html %]buglist.cgi?cmdtype=runnamed&amp;namedcmd=[% query.name FILTER uri %]">View as [% terms.bug %] list</a>
+      </p>
+    [% END %]
+  [% END %]
+[% ELSE %]
+
+  <h3>No [% terms.bugs %] were found that matched the search criteria.</h3>
+[% END %]
+  </body>
+</html>

diff --git a/template/en/default/whine/mail.txt.tmpl b/template/en/default/whine/mail.txt.tmpl
new file mode 100644 (file)
index 0000000..845869d
--- /dev/null
+++ b/template/en/default/whine/mail.txt.tmpl
@@ -0,0 +1,61 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # subject: subject line of message
+  # body: message body, shown before the query tables
+  # queries: array of hashes containing:
+  #     bugs: array containing hashes of fieldnames->values for each bug
+  #     title: the title given in the whine scheduling mechanism
+  #     name: the name of the query
+  #     columnlist: array of fieldnames to display in the mail
+  # author: user object for the person who scheduled this whine
+  # recipient: user object for the intended recipient of the message
+  #%]
+
+[% body %]
+
+[% IF author.login == recipient.login %]
+  To edit your whine schedule, visit the following URL:
+  [%+ urlbase %]editwhines.cgi
+[% ELSE %]
+  This search was scheduled by [% author.login %].
+[% END %]
+
+[% IF queries.size %]
+  [% FOREACH query=queries %]
+
+[%+ query.title +%] ([% query.bugs.size %] [%+ terms.bugs %])
+[%+ "-" FILTER repeat(query.title.length) %]
+
+  [% FOREACH bug=query.bugs %]
+  [% terms.Bug +%] [%+ bug.bug_id %]:
+  [%+ urlbase %]show_bug.cgi?id=[% bug.bug_id +%]
+  [% largest_title = 0 %]
+  [% FOREACH col = query.columnlist %]
+    [% NEXT IF col == 'bug_id' %]
+    [% IF field_descs.${col}.length > largest_title %]
+      [% largest_title = field_descs.${col}.length %]
+    [% END %]
+  [% END %]
+  [% FOREACH col = query.columnlist %]
+    [% NEXT IF col == 'bug_id' %]
+  [%+ " " FILTER repeat(largest_title - field_descs.${col}.length) %]
+  [% field_descs.$col %]: [% display_value($col, bug.$col) %]
+  [% END %]
+
+  [% END %]
+
+  [% IF author.login == recipient.login %]
+View as [% terms.bug %] list: [% urlbase %]buglist.cgi?cmdtype=runnamed&namedcmd=[% query.name FILTER uri %]
+  [% END %]
+  [% END %]
+[% ELSE %]
+
+  No [% terms.bugs %] were found that matched the search criteria.
+[% END %]

diff --git a/template/en/default/whine/multipart-mime.txt.tmpl b/template/en/default/whine/multipart-mime.txt.tmpl
new file mode 100644 (file)
index 0000000..d28f4ce
--- /dev/null
+++ b/template/en/default/whine/multipart-mime.txt.tmpl
@@ -0,0 +1,39 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # subject: subject line of message
+  # alternatives: array of hashes containing:
+  #     type: MIME type
+  #     content: verbatim content
+  # boundary: a string that has been generated to be a unique boundary
+  # recipient: user object for the intended recipient of the message
+  # from: Bugzilla system email address
+  #%]
+
+From: [% from %]
+To: [% recipient.email %]
+Subject: [[% terms.Bugzilla %]] [% subject %]
+MIME-Version: 1.0
+Content-Type: multipart/alternative; boundary="[% boundary %]"
+X-Bugzilla-Type: whine
+
+
+This is a MIME multipart message.  It is possible that your mail program
+doesn't quite handle these properly.  Some or all of the information in this
+message may be unreadable.
+
+
+[% FOREACH part=alternatives %]
+
+--[% boundary %]
+Content-type: [% part.type +%]
+
+[%+ part.content %]
+[%+ END %]
+--[% boundary %]--

diff --git a/template/en/default/whine/schedule.html.tmpl b/template/en/default/whine/schedule.html.tmpl
new file mode 100644 (file)
index 0000000..dd58fc5
--- /dev/null
+++ b/template/en/default/whine/schedule.html.tmpl
@@ -0,0 +1,432 @@
+[%# This Source Code Form is subject to the terms of the Mozilla Public
+  # License, v. 2.0. If a copy of the MPL was not distributed with this
+  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  #
+  # This Source Code Form is "Incompatible With Secondary Licenses", as
+  # defined by the Mozilla Public License, v. 2.0.
+  #%]
+
+[%# INTERFACE:
+  # events: hash, keyed by event_id number.  Values are anonymous hashes of:
+  #     schedule: array of hashes containing schedule info:
+  #         day:    value in day column
+  #         time:   value selected in time column
+  #         mailto_type: 0=user 1=group
+  #         mailto: recipient's id (profile or group)
+  #     queries:  as with schedule, an anonymous array containing hashes of:
+  #         name:  the named query's name
+  #         title: title to be displayed on the results
+  #         sort:  integer that sets execution order on named queries
+  #%]
+
+[% title = "Set up whining" %]
+[% PROCESS global/header.html.tmpl
+  title = title
+  style_urls = ['skins/standard/admin.css']
+  doc_section = "whining.html"
+%]
+
+<p>
+  "Whining" is when [% terms.Bugzilla %] executes a saved query at a regular interval
+  and sends the resulting list of [% terms.bugs %] via email.
+</p>
+
+<p>
+  To set up a new whine event, click "Add a new event."  Enter a subject line
+  for the message that will be sent, along with a block of text that will
+  accompany the [% terms.bug %] list in the body of the message.
+</p>
+
+<p>
+  Schedules are added to an event by clicking on "Add a new schedule."  A schedule
+  consists of a day, a time of day or interval of times
+  (e.g., every 15 minutes), and a target email address that may or may not be
+  alterable, depending on your privileges.  Events may have more than one schedule
+  in order to run at multiple times or for different users.
+</p>
+
+<p>
+  Searches come from saved searches, which are created by executing a <a
+  href="query.cgi">search</a>, then telling [% terms.Bugzilla %] to remember
+  the search under a particular name.  Add a query by clicking "Add a new
+  query", and select the desired saved search name under "Search" and add a
+  title for the [% terms.bug %] table.  The optional number entered under
+  "Sort" will determine the execution order (lowest to highest) if multiple
+  queries are listed.  If you check "One message per [% terms.bug %]," each [%
+  terms.bug %] that matches the search will be sent in its own email message.
+</p>
+
+<p>
+  All times are server local time ([% local_timezone FILTER html %]).
+</p>
+
+<form method="post" action="editwhines.cgi">
+[%# This hidden submit button must be here to set default behavior when
+    the user presses return on a form input field #%]
+<input type="submit" value="Update / Commit" name="commit"
+       style="display: none;" id="commit">
+<input type="hidden" name="update" value="1">
+<input type="hidden" name="token" value="[% token FILTER html %]">
+
+[% FOREACH event = events %]
+
+<table cellspacing="2" cellpadding="2" style="border: 1px solid;">
+  <tr>
+    <th align="left">
+      Event:
+    </th>
+    <td align="right" colspan="2">
+      <input type="submit" value="Remove Event"
+             name="remove_event_[% event.key %]"
+             id="remove_event_[% event.key %]">
+    </td>
+  </tr>
+
+  <tr>
+    <td valign="top" align="right">
+      Email subject line:
+    </td>
+    <td colspan="2">
+      <input type="text" name="event_[% event.key %]_subject"
+             size="60" maxlength="128" value="
+             [%- event.value.subject FILTER html %]">
+    </td>
+  </tr>
+
+  <tr>
+    <td valign="top" align="right">
+      Descriptive text sent within whine message:
+    </td>
+    <td colspan="2">
+      [% INCLUDE global/textarea.html.tmpl
+         name           = "event_${event.key}_body"
+         minrows        = 3
+         maxrows        = 10
+         defaultrows    = 5
+         cols           = 80
+         defaultcontent = event.value.body
+       %]
+    </td>
+  </tr>
+
+  <tr>
+    <td valign="top" align="right">
+      Send a message even if there are no [% terms.bugs %] in the search result:
+    </td>
+    <td colspan="2">
+      <input type="checkbox" name="event_[% event.key %]_mailifnobugs"
+        [%- IF event.value.mailifnobugs == 1 %] checked [% END %]>
+    </td>
+  </tr>
+
+  [% IF event.value.schedule.size == 0 %]
+
+    <tr>
+      <td valign="top" align="right">
+        Schedule:
+      </td>
+      <td class="unset" colspan="2">
+        Not scheduled to run<br>
+        <input type="submit" value="Add a new schedule"
+               name="add_schedule_[% event.key %]"
+               id="add_schedule_[% event.key %]">
+      </td>
+    </tr>
+
+  [% ELSE %]
+
+    <tr>
+      <td valign="top" align="right">
+        Schedule:
+      </td>
+      <td class="set" colspan="2">
+
+        <table>
+          <tr>
+            <th>
+              Interval
+            </th>
+            <th>
+              [% IF mail_others %]
+                Mail to
+              [% END %]
+            </th>
+            <th>
+            </th>
+          </tr>
+          [% FOREACH schedule = event.value.schedule %]
+            <tr>
+              <td align="left">
+
+                [%# these hidden fields allow us to compare old values instead
+                    of reading the database to tell if a field has changed %]
+
+                <input type="hidden" value="[% schedule.day FILTER html %]"
+                       name="orig_day_[% schedule.id %]">
+                <input type="hidden" value="[% schedule.time FILTER html %]"
+                       name="orig_time_[% schedule.id %]">
+                [% PROCESS day_field val=schedule.day %]
+                [% PROCESS time_field val=schedule.time %]
+              </td>
+              <td align="left">
+                [% IF mail_others %]
+                  <input type="hidden" name="orig_mailto_type_[% schedule.id %]"
+                         value="[% schedule.mailto_type FILTER html %]">
+                  <select name="mailto_type_[% schedule.id %]">
+                    <option value="0" [% IF schedule.mailto_type == 0 %]
+                                        selected
+                                      [% END %]>User</option>
+                    <option value="1" [% IF schedule.mailto_type == 1 %]
+                                        selected
+                                      [% END %]>Group</option>
+                  </select>
+                  <input type="hidden" name="orig_mailto_[% schedule.id %]"
+                         value="[% schedule.mailto FILTER html %]">
+                  <input type="text" name="mailto_[% schedule.id %]"
+                         value="[% schedule.mailto FILTER html %]" size="30">
+                [% END %]
+              </td>
+              <td align="left">
+                <input type="submit" value="Remove"
+                       name="remove_schedule_[% schedule.id %]"
+                       id="remove_schedule_[% schedule.id %]">
+              </td>
+            </tr>
+          [% END %]
+
+          <tr>
+            <td colspan="3">
+              <input type="submit" value="Add a new schedule"
+                     name="add_schedule_[% event.key %]"
+                     id="add_schedule_[% event.key %]">
+            </td>
+          </tr>
+        </table>
+
+      </td>
+    </tr>
+
+  [% END %]
+
+  [% IF event.value.queries.size == 0 %]
+
+    <tr>
+      <td valign="top" align="right">
+        Searches:
+      </td>
+      <td align="left">
+        No searches <br>
+        <input type="submit" value="Add a new query"
+               name="add_query_[% event.key %]"
+               id="add_query_[% event.key %]">
+      </td>
+      <td align="right" valign="bottom">
+        <input type="submit" value="Update / Commit" name="commit" id="update">
+      </td>
+    </tr>
+
+  [% ELSE %]
+
+    <tr>
+      <td valign="top" align="right">
+        Searches:
+      </td>
+      <td align="left" colspan="2">
+
+        <table>
+          <tr>
+            <th>Sort</th>
+            <th>Search</th>
+            <th>Title</th>
+            <th></th>
+            <th></th>
+          </tr>
+
+          [% FOREACH query = event.value.queries %]
+
+            <tr>
+              <td align="left">
+                <input type="text" name="query_sort_[% query.id %]"
+                       size="3" value="[% query.sort %]">
+                <input type="hidden" value="[% query.sort %]"
+                       name="orig_query_sort_[% query.id %]">
+              </td>
+              <td align="left">
+                <input type="hidden" value="[% query.name FILTER html %]"
+                       name="orig_query_name_[% query.id %]">
+                [% PROCESS query_field thisquery=query.name %]
+              </td>
+              <td align="left">
+                <input type="hidden" value="[% query.title FILTER html %]"
+                       name="orig_query_title_[% query.id %]">
+                <input type="text" name="query_title_[% query.id %]"
+                       size="50" value="[% query.title FILTER html %]"
+                       maxlength="64">
+              </td>
+              <td align="left">
+                <input type="hidden" value="[% query.onemailperbug FILTER html %]"
+                       name="orig_query_onemailperbug_[% query.id %]">
+                <input type="checkbox" [% IF query.onemailperbug == 1 %] checked [% END %]
+                       id="query_onemailperbug_[% query.id %]"
+                       name="query_onemailperbug_[% query.id %]">
+                <label for="query_onemailperbug_[% query.id %]">One message per [% terms.bug %]</label>
+              </td>
+              <td align="right">
+                <input type="submit" value="Remove"
+                       name="remove_query_[% query.id %]"
+                       id="remove_query_[% query.id %]">
+              </td>
+            </tr>
+
+          [% END %]
+
+          <tr>
+            <td colspan="3">
+              <input type="submit" value="Add a new query"
+                     name="add_query_[% event.key %]"
+                     id="add_query_[% event.key %]">
+            </td>
+            <td align="right" colspan="2">
+              <input type="submit" value="Update / Commit" name="commit" id="update">
+            </td>
+          </tr>
+        </table>
+
+      </td>
+    </tr>
+
+  [% END %]
+
+</table>
+
+[% END %]
+
+<p align="left">
+  <input type="submit" value="Add a new event" name="add_event" id="add_event">
+</p>
+
+</form>
+
+[% PROCESS global/footer.html.tmpl %]
+
+[% BLOCK query_field +%]
+
+  [% IF available_queries.size > 0 %]
+
+    <select name="query_name_[% query.id %]">
+      [% FOREACH q = available_queries %]
+        <option [% "selected" IF q == thisquery %] value="[% q FILTER html %]">
+            [% q FILTER html %]
+        </option>
+      [% END %]
+    </select>
+
+  [% ELSE %]
+    Please visit the <a href="query.cgi">Search</a> page and save a query
+  [% END %]
+
+[%+ END %]
+
+[% BLOCK day_field +%]
+  <select name="day_[% schedule.id %]">
+      [%
+        options = [
+            ['All',  'Each day',                 ],
+            ['MF',   'Monday through Friday',    ],
+            ['Sun',  'Sunday',                   ],
+            ['Mon',  'Monday',                   ],
+            ['Tue',  'Tuesday',                  ],
+            ['Wed',  'Wednesday',                ],
+            ['Thu',  'Thursday',                 ],
+            ['Fri',  'Friday',                   ],
+            ['Sat',  'Saturday',                 ],
+            ['1',    'On the 1st of the month',  ],
+            ['2',    'On the 2nd of the month',  ],
+            ['3',    'On the 3rd of the month',  ],
+            ['4',    'On the 4th of the month',  ],
+            ['5',    'On the 5th of the month',  ],
+            ['6',    'On the 6th of the month',  ],
+            ['7',    'On the 7th of the month',  ],
+            ['8',    'On the 8th of the month',  ],
+            ['9',    'On the 9th of the month',  ],
+            ['10',   'On the 10th of the month', ],
+            ['11',   'On the 11th of the month', ],
+            ['12',   'On the 12th of the month', ],
+            ['13',   'On the 13th of the month', ],
+            ['14',   'On the 14th of the month', ],
+            ['15',   'On the 15th of the month', ],
+            ['16',   'On the 16th of the month', ],
+            ['17',   'On the 17th of the month', ],
+            ['18',   'On the 18th of the month', ],
+            ['19',   'On the 19th of the month', ],
+            ['20',   'On the 20th of the month', ],
+            ['21',   'On the 21st of the month', ],
+            ['22',   'On the 22nd of the month', ],
+            ['23',   'On the 23rd of the month', ],
+            ['24',   'On the 24th of the month', ],
+            ['25',   'On the 25th of the month', ],
+            ['26',   'On the 26th of the month', ],
+            ['27',   'On the 27th of the month', ],
+            ['28',   'On the 28th of the month', ],
+            ['29',   'On the 29th of the month', ],
+            ['30',   'On the 30th of the month', ],
+            ['31',   'On the 31st of the month', ],
+            ['last', 'Last day of the month',    ],
+        ]
+      %]
+
+      [% FOREACH option = options %]
+        <option value="[% option.0 %]" 
+                [%- IF val == option.0 +%] selected[% END %]>
+                [%- option.1 -%]
+        </option>
+      [% END %]
+
+  </select>
+[%+ END %]
+
+[% BLOCK time_field +%]
+<select name="time_[% schedule.id %]">
+
+  [%
+    options = [
+        [ '0',     'at midnight',      ],
+        [ '1',     'at 01:00',         ],
+        [ '2',     'at 02:00',         ],
+        [ '3',     'at 03:00',         ],
+        [ '4',     'at 04:00',         ],
+        [ '5',     'at 05:00',         ],
+        [ '6',     'at 06:00',         ],
+        [ '7',     'at 07:00',         ],
+        [ '8',     'at 08:00',         ],
+        [ '9',     'at 09:00',         ],
+        [ '10',    'at 10:00',         ],
+        [ '11',    'at 11:00',         ],
+        [ '12',    'at 12:00',         ],
+        [ '13',    'at 13:00',         ],
+        [ '14',    'at 14:00',         ],
+        [ '15',    'at 15:00',         ],
+        [ '16',    'at 16:00',         ],
+        [ '17',    'at 17:00',         ],
+        [ '18',    'at 18:00',         ],
+        [ '19',    'at 19:00',         ],
+        [ '20',    'at 20:00',         ],
+        [ '21',    'at 21:00',         ],
+        [ '22',    'at 22:00',         ],
+        [ '23',    'at 23:00',         ],
+        [ '60min', 'every hour',       ],
+        [ '30min', 'every 30 minutes', ],
+        [ '15min', 'every 15 minutes', ],
+    ]
+  %]
+
+      [% FOREACH option = options %]
+        <option value="[% option.0 %]" 
+                [%- IF val == option.0 +%] selected[% END %]>
+                [%- option.1 -%]
+        </option>
+      [% END %]
+
+</select>
+
+[%+ END %]

diff --git a/testagent.cgi b/testagent.cgi
new file mode 100755 (executable)
index 0000000..3480f87
--- /dev/null
+++ b/testagent.cgi
@@ -0,0 +1,16 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# This script is used by servertest.pl to confirm that cgi scripts
+# are being run instead of shown. This script does not rely on database access
+# or correct params.
+
+use strict;
+print "content-type:text/plain\n\n";
+print "OK " . ($::ENV{MOD_PERL} || "mod_cgi") . "\n";
+exit;

diff --git a/testserver.pl b/testserver.pl
new file mode 100755 (executable)
index 0000000..d296b73
--- /dev/null
+++ b/testserver.pl
@@ -0,0 +1,282 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# testserver.pl is invoked with the baseurl of the Bugzilla installation
+# as its only argument.  It attempts to troubleshoot as many installation
+# issues as possible.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+
+use Socket;
+
+my $datadir = bz_locations()->{'datadir'};
+
+eval "require LWP; require LWP::UserAgent;";
+my $lwp = $@ ? 0 : 1;
+
+if ((@ARGV != 1) || ($ARGV[0] !~ /^https?:/i))
+{
+    say "Usage: $0 <URL to this Bugzilla installation>";
+    say "e.g.:  $0 http://www.mycompany.com/bugzilla";
+    exit(1);
+}
+
+
+# Try to determine the GID used by the web server.
+my @pscmds = ('ps -eo comm,gid', 'ps -acxo command,gid', 'ps -acxo command,rgid');
+my $sgid = 0;
+if (!ON_WINDOWS) {
+    foreach my $pscmd (@pscmds) {
+        open PH, "$pscmd 2>/dev/null |";
+        while (my $line = <PH>) {
+            if ($line =~ /^(?:\S*\/)?(?:httpd|apache)2?\s+(\d+)$/) {
+                $sgid = $1 if $1 > $sgid;
+            }
+        }
+        close(PH);
+    }
+}
+
+# Determine the numeric GID of $webservergroup
+my $webgroupnum = 0;
+my $webservergroup = Bugzilla->localconfig->{webservergroup};
+if ($webservergroup =~ /^(\d+)$/) {
+    $webgroupnum = $1;
+}
+else {
+    eval { $webgroupnum = (getgrnam $webservergroup) || 0; };
+}
+
+# Check $webservergroup against the server's GID
+if ($sgid > 0) {
+    if ($webservergroup eq "") {
+        say 
+"WARNING \$webservergroup is set to an empty string.
+That is a very insecure practice. Please refer to the
+Bugzilla documentation.";
+    }
+    elsif ($webgroupnum == $sgid || Bugzilla->localconfig->{use_suexec}) {
+        say "TEST-OK Webserver is running under group id in \$webservergroup.";
+    }
+    else {
+        say 
+"TEST-WARNING Webserver is running under group id not matching \$webservergroup.
+This if the tests below fail, this is probably the problem.
+Please refer to the web server configuration section of the Bugzilla guide. 
+If you are using virtual hosts or suexec, this warning may not apply.";
+    }
+}
+elsif (!ON_WINDOWS) {
+   say
+"TEST-WARNING Failed to find the GID for the 'httpd' process, unable
+to validate webservergroup.";
+}
+
+
+# Try to fetch a static file (padlock.png)
+$ARGV[0] =~ s/\/$//;
+my $url = $ARGV[0] . "/images/padlock.png";
+if (fetch($url)) {
+    say "TEST-OK Got padlock picture.";
+} else {
+    say 
+"TEST-FAILED Fetch of images/padlock.png failed
+Your web server could not fetch $url.
+Check your web server configuration and try again.";
+    exit(1);
+}
+
+# Try to execute a cgi script
+my $response = clean_text(fetch($ARGV[0] . "/testagent.cgi"));
+if ($response =~ /^OK (.*)$/) {
+    say "TEST-OK Webserver is executing CGIs via $1.";
+} elsif ($response =~ /^#!/) {
+    say
+"TEST-FAILED Webserver is fetching rather than executing CGI files.
+Check the AddHandler statement in your httpd.conf file.";
+    exit(1);
+} else {
+    say "TEST-FAILED Webserver is not executing CGI files.";
+}
+
+# Make sure that the web server is honoring .htaccess files
+my $localconfig = bz_locations()->{'localconfig'};
+$localconfig =~ s~^\./~~;
+$url = $ARGV[0] . "/$localconfig";
+$response = fetch($url);
+if ($response) {
+    say
+"TEST-FAILED Webserver is permitting fetch of $url.
+This is a serious security problem.
+Check your web server configuration.";
+    exit(1);
+} else {
+    say "TEST-OK Webserver is preventing fetch of $url.";
+}
+
+# Test chart generation
+eval 'use GD';
+if ($@ eq '') {
+    undef $/;
+
+    # Ensure major versions of GD and libgd match
+    # Windows's GD module include libgd.dll, guaranteed to match
+    if (!ON_WINDOWS) {
+        my $gdlib = `gdlib-config --version 2>&1` || "";
+        $gdlib =~ s/\n$//;
+        if (!$gdlib) {
+            say "TEST-WARNING Failed to run gdlib-config; can't compare " .
+                  "GD versions.";
+        }
+        else {
+            my $gd = $GD::VERSION;
+    
+            my $verstring = "GD version $gd, libgd version $gdlib";
+    
+            $gdlib =~ s/^([^\.]+)\..*/$1/;
+            $gd =~ s/^([^\.]+)\..*/$1/;
+    
+            if ($gdlib == $gd) {
+                say "TEST-OK $verstring; Major versions match.";
+            } else {
+                say "TEST-FAILED $verstring; Major versions do not match.";
+            }
+        }
+    }
+
+    # Test GD
+    eval {
+        my $image = new GD::Image(100, 100);
+        my $black = $image->colorAllocate(0, 0, 0);
+        my $white = $image->colorAllocate(255, 255, 255);
+        my $red = $image->colorAllocate(255, 0, 0);
+        my $blue = $image->colorAllocate(0, 0, 255);
+        $image->transparent($white);
+        $image->rectangle(0, 0, 99, 99, $black);
+        $image->arc(50, 50, 95, 75, 0, 360, $blue);
+        $image->fill(50, 50, $red);
+
+        if ($image->can('png')) {
+            create_file("$datadir/testgd-local.png", $image->png);
+            check_image("$datadir/testgd-local.png", 'GD');
+        } else {
+            say "TEST-FAILED GD doesn't support PNG generation.";
+        }
+    };
+    if ($@ ne '') {
+        say "TEST-FAILED GD returned: $@";
+    }
+
+    # Test Chart
+    eval 'use Chart::Lines';
+    if ($@) {
+        say "TEST-FAILED Chart::Lines is not installed.";
+    } else {
+        eval {
+            my $chart = Chart::Lines->new(400, 400);
+
+            $chart->add_pt('foo', 30, 25);
+            $chart->add_pt('bar', 16, 32);
+
+            $chart->png("$datadir/testchart-local.png");
+            check_image("$datadir/testchart-local.png", "Chart");
+        };
+        if ($@ ne '') {
+            say "TEST-FAILED Chart returned: $@";
+        }
+    }
+
+    eval 'use Template::Plugin::GD::Image';
+    if ($@) {
+        say "TEST-FAILED Template::Plugin::GD is not installed.";
+    }
+    else {
+        say "TEST-OK Template::Plugin::GD is installed.";
+    }
+}
+
+sub fetch {
+    my $url = shift;
+    my $rtn;
+    if ($lwp) {
+        my $req = HTTP::Request->new(GET => $url);
+        my $ua = LWP::UserAgent->new;
+        my $res = $ua->request($req);
+        $rtn = ($res->is_success ? $res->content : undef);
+    } elsif ($url =~ /^https:/i) {
+        die("You need LWP installed to use https with testserver.pl");
+    } else {
+        my($host, $port, $file) = ('', 80, '');
+        if ($url =~ m#^http://([^:]+):(\d+)(/.*)#i) {
+            ($host, $port, $file) = ($1, $2, $3);
+        } elsif ($url =~ m#^http://([^/]+)(/.*)#i) {
+            ($host, $file) = ($1, $2);
+        } else {
+            die("Cannot parse url");
+        }
+
+        my $proto = getprotobyname('tcp');
+        socket(SOCK, PF_INET, SOCK_STREAM, $proto);
+        my $sin = sockaddr_in($port, inet_aton($host));
+        if (connect(SOCK, $sin)) {
+            binmode SOCK;
+            select((select(SOCK), $| = 1)[0]);
+
+            # get content
+            print SOCK "GET $file HTTP/1.0\015\012host: $host:$port\015\012\015\012";
+            my $header = '';
+            while (defined(my $line = <SOCK>)) {
+                last if $line eq "\015\012";
+                $header .= $line;
+            }
+            my $content = '';
+            while (defined(my $line = <SOCK>)) {
+                $content .= $line;
+            }
+
+            my ($status) = $header =~ m#^HTTP/\d+\.\d+ (\d+)#;
+            $rtn = (($status =~ /^2\d\d/) ? $content : undef);
+        }
+    }
+    return($rtn);
+}
+
+sub check_image {
+    my ($local_file, $library) = @_;
+    my $filedata = read_file($local_file);
+    if ($filedata =~ /^\x89\x50\x4E\x47\x0D\x0A\x1A\x0A/) {
+        say "TEST-OK $library library generated a good PNG image.";
+        unlink $local_file;
+    } else {
+        say "TEST-WARNING $library library did not generate a good PNG.";
+    }
+}
+
+sub create_file {
+    my ($filename, $content) = @_;
+    open(FH, ">$filename")
+        or die "Failed to create $filename: $!\n";
+    binmode FH;
+    print FH $content;
+    close FH;
+}
+
+sub read_file {
+    my ($filename) = @_;
+    open(FH, $filename)
+        or die "Failed to open $filename: $!\n";
+    binmode FH;
+    my $content = <FH>;
+    close FH;
+    return $content;
+}

diff --git a/token.cgi b/token.cgi
new file mode 100755 (executable)
index 0000000..62f1f51
--- /dev/null
+++ b/token.cgi
@@ -0,0 +1,340 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::Token;
+use Bugzilla::User;
+
+use Date::Format;
+use Date::Parse;
+
+local our $cgi = Bugzilla->cgi;
+local our $template = Bugzilla->template;
+local our $vars = {};
+
+my $action = $cgi->param('a');
+my $token = $cgi->param('t');
+
+Bugzilla->login(LOGIN_OPTIONAL);
+
+# Throw an error if the form does not contain an "action" field specifying
+# what the user wants to do.
+$action || ThrowUserError('unknown_action');
+
+Bugzilla::Token::CleanTokenTable();
+my ($user_id, $date, $data, $tokentype) = Bugzilla::Token::GetTokenData($token);
+
+# Requesting a new password is the single action which doesn't require a token.
+# XXX Ideally, these checks should be done inside the subroutines themselves.
+unless ($action eq 'reqpw') {
+    $tokentype || ThrowUserError("token_does_not_exist");
+
+    # Make sure the token is the correct type for the action being taken.
+    # The { user_error => 'wrong_token_for_*' } trick is to make 012throwables.t happy.
+    my $error = {};
+    if (grep($action eq $_ , qw(cfmpw cxlpw chgpw)) && $tokentype ne 'password') {
+        $error = { user_error => 'wrong_token_for_changing_passwd' };
+    }
+    elsif ($action eq 'cxlem'
+           && ($tokentype ne 'emailold' && $tokentype ne 'emailnew'))
+    {
+        $error = { user_error => 'wrong_token_for_cancelling_email_change' };
+    }
+    elsif (grep($action eq $_ , qw(cfmem chgem)) && $tokentype ne 'emailnew') {
+        $error = { user_error => 'wrong_token_for_confirming_email_change' };
+    }
+    elsif ($action =~ /^(request|confirm|cancel)_new_account$/
+           && $tokentype ne 'account')
+    {
+        $error = { user_error => 'wrong_token_for_creating_account' };
+    }
+
+    if (my $user_error = $error->{user_error}) {
+        Bugzilla::Token::Cancel($token, $user_error);
+        ThrowUserError($user_error);
+    }
+}
+
+if ($action eq 'reqpw') {
+    requestChangePassword();
+}
+elsif ($action eq 'cfmpw') {
+    confirmChangePassword($token);
+}
+elsif ($action eq 'cxlpw') {
+    cancelChangePassword($token);
+}
+elsif ($action eq 'chgpw') {
+    changePassword($user_id, $token);
+}
+elsif ($action eq 'cfmem') {
+    confirmChangeEmail($token);
+}
+elsif ($action eq 'cxlem') {
+    cancelChangeEmail($user_id, $data, $tokentype, $token);
+}
+elsif ($action eq 'chgem') {
+    changeEmail($user_id, $data, $token);
+}
+elsif ($action eq 'request_new_account') {
+    request_create_account($date, $data, $token);
+}
+elsif ($action eq 'confirm_new_account') {
+    confirm_create_account($data, $token);
+}
+elsif ($action eq 'cancel_new_account') {
+    cancel_create_account($data, $token);
+}
+else {
+    ThrowUserError('unknown_action', {action => $action});
+}
+
+exit;
+
+################################################################################
+# Functions
+################################################################################
+
+# If the user is requesting a password change, make sure they submitted
+# their login name and it exists in the database, and that the DB module is in
+# the list of allowed verification methods.
+sub requestChangePassword {
+    # check verification methods
+    Bugzilla->user->authorizer->can_change_password
+      || ThrowUserError("password_change_requests_not_allowed");
+
+    # Check the hash token to make sure this user actually submitted
+    # the forgotten password form.
+    my $token = $cgi->param('token');
+    check_hash_token($token, ['reqpw']);
+
+    my $login_name = $cgi->param('loginname')
+      or ThrowUserError("login_needed_for_password_change");
+
+    check_email_syntax($login_name);
+    my $user = Bugzilla::User->check($login_name);
+
+    # Make sure the user account is active.
+    if (!$user->is_enabled) {
+        ThrowUserError('account_disabled',
+                       {disabled_reason => get_text('account_disabled', {account => $login_name})});
+    }
+
+    Bugzilla::Token::IssuePasswordToken($user);
+
+    $vars->{'message'} = "password_change_request";
+
+    print $cgi->header();
+    $template->process("global/message.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+}
+
+sub confirmChangePassword {
+    my $token = shift;
+    $vars->{'token'} = $token;
+
+    print $cgi->header();
+    $template->process("account/password/set-forgotten-password.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+}
+
+sub cancelChangePassword {
+    my $token = shift;
+    $vars->{'message'} = "password_change_canceled";
+    Bugzilla::Token::Cancel($token, $vars->{'message'});
+
+    print $cgi->header();
+    $template->process("global/message.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+}
+
+# If the user is changing their password, make sure they submitted a new
+# password and that the new password is valid.
+sub changePassword {
+    my ($user_id, $token) = @_;
+
+    my $password = $cgi->param('password');
+    (defined $password && defined $cgi->param('matchpassword'))
+      || ThrowUserError("require_new_password");
+
+    validate_password($password, $cgi->param('matchpassword'));
+    # Make sure that these never show up in the UI under any circumstances.
+    $cgi->delete('password', 'matchpassword');
+
+    my $user = Bugzilla::User->check({ id => $user_id });
+    $user->set_password($password);
+    $user->update();
+    delete_token($token);
+
+    Bugzilla->logout_user_by_id($user_id);
+
+    $vars->{'message'} = "password_changed";
+
+    print $cgi->header();
+    $template->process("global/message.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+}
+
+sub confirmChangeEmail {
+    my $token = shift;
+    $vars->{'token'} = $token;
+
+    print $cgi->header();
+    $template->process("account/email/confirm.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+}
+
+sub changeEmail {
+    my ($userid, $eventdata, $token) = @_;
+    my $dbh = Bugzilla->dbh;
+    my ($old_email, $new_email) = split(/:/,$eventdata);
+
+    $dbh->bz_start_transaction();
+    
+    my $user = Bugzilla::User->check({ id => $userid });
+    my $realpassword = $user->cryptpassword;
+    my $cgipassword  = $cgi->param('password');
+
+    # Make sure the user who wants to change the email address
+    # is the real account owner.
+    if (bz_crypt($cgipassword, $realpassword) ne $realpassword) {
+        ThrowUserError("old_password_incorrect");
+    }
+
+    # The new email address should be available as this was 
+    # confirmed initially so cancel token if it is not still available
+    if (! is_available_username($new_email,$old_email)) {
+        $vars->{'email'} = $new_email; # Needed for Bugzilla::Token::Cancel's mail
+        Bugzilla::Token::Cancel($token, "account_exists", $vars);
+        ThrowUserError("account_exists", { email => $new_email } );
+    } 
+
+    # Update the user's login name in the profiles table.
+    $user->set_login($new_email);
+    $user->update({ keep_session => 1, keep_tokens => 1 });
+    delete_token($token);
+    $dbh->do(q{DELETE FROM tokens WHERE userid = ?
+               AND tokentype = 'emailnew'}, undef, $userid);
+
+    $dbh->bz_commit_transaction();
+
+    # Return HTTP response headers.
+    print $cgi->header();
+
+    # Let the user know their email address has been changed.
+    $vars->{'message'} = "login_changed";
+
+    $template->process("global/message.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+}
+
+sub cancelChangeEmail {
+    my ($userid, $eventdata, $tokentype, $token) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    $dbh->bz_start_transaction();
+
+    my ($old_email, $new_email) = split(/:/,$eventdata);
+
+    if ($tokentype eq "emailold") {
+        $vars->{'message'} = "emailold_change_canceled";
+        my $user = Bugzilla::User->check({ id => $userid });
+
+        # check to see if it has been altered
+        if ($user->login ne $old_email) {
+            $user->set_login($old_email);
+            $user->update({ keep_session => 1 });
+
+            $vars->{'message'} = "email_change_canceled_reinstated";
+        } 
+    } 
+    else {
+        $vars->{'message'} = 'email_change_canceled'
+     }
+
+    $vars->{'old_email'} = $old_email;
+    $vars->{'new_email'} = $new_email;
+    Bugzilla::Token::Cancel($token, $vars->{'message'}, $vars);
+
+    $dbh->do(q{DELETE FROM tokens WHERE userid = ?
+               AND tokentype = 'emailold' OR tokentype = 'emailnew'},
+             undef, $userid);
+
+    $dbh->bz_commit_transaction();
+
+    # Return HTTP response headers.
+    print $cgi->header();
+
+    $template->process("global/message.html.tmpl", $vars)
+      || ThrowTemplateError($template->error());
+}
+
+sub request_create_account {
+    my ($date, $login_name, $token) = @_;
+
+    Bugzilla->user->check_account_creation_enabled;
+
+    $vars->{'token'} = $token;
+    $vars->{'email'} = $login_name . Bugzilla->params->{'emailsuffix'};
+    $vars->{'expiration_ts'} = ctime(str2time($date) + MAX_TOKEN_AGE * 86400);
+
+    print $cgi->header();
+    $template->process('account/email/confirm-new.html.tmpl', $vars)
+      || ThrowTemplateError($template->error());
+}
+
+sub confirm_create_account {
+    my ($login_name, $token) = @_;
+
+    Bugzilla->user->check_account_creation_enabled;
+
+    my $password = $cgi->param('passwd1') || '';
+    validate_password($password, $cgi->param('passwd2') || '');
+    # Make sure that these never show up anywhere in the UI.
+    $cgi->delete('passwd1', 'passwd2');
+
+    my $otheruser = Bugzilla::User->create({
+        login_name => $login_name, 
+        realname   => $cgi->param('realname'), 
+        cryptpassword => $password});
+
+    # Now delete this token.
+    delete_token($token);
+
+    # Let the user know that his user account has been successfully created.
+    $vars->{'message'} = 'account_created';
+    $vars->{'otheruser'} = $otheruser;
+
+    # Log in the new user using credentials he just gave.
+    $cgi->param('Bugzilla_login', $otheruser->login);
+    $cgi->param('Bugzilla_password', $password);
+    Bugzilla->login(LOGIN_OPTIONAL);
+
+    print $cgi->header();
+
+    $template->process('index.html.tmpl', $vars)
+      || ThrowTemplateError($template->error());
+}
+
+sub cancel_create_account {
+    my ($login_name, $token) = @_;
+
+    $vars->{'message'} = 'account_creation_canceled';
+    $vars->{'account'} = $login_name;
+    Bugzilla::Token::Cancel($token, $vars->{'message'});
+
+    print $cgi->header();
+    $template->process('global/message.html.tmpl', $vars)
+      || ThrowTemplateError($template->error());
+}

diff --git a/userprefs.cgi b/userprefs.cgi
new file mode 100755 (executable)
index 0000000..1b63474
--- /dev/null
+++ b/userprefs.cgi
@@ -0,0 +1,544 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::BugMail;
+use Bugzilla::Constants;
+use Bugzilla::Search;
+use Bugzilla::Util;
+use Bugzilla::Error;
+use Bugzilla::User;
+use Bugzilla::Token;
+
+my $template = Bugzilla->template;
+local our $vars = {};
+
+###############################################################################
+# Each panel has two functions - panel Foo has a DoFoo, to get the data 
+# necessary for displaying the panel, and a SaveFoo, to save the panel's 
+# contents from the form data (if appropriate). 
+# SaveFoo may be called before DoFoo.    
+###############################################################################
+sub DoAccount {
+    my $dbh = Bugzilla->dbh;
+    my $user = Bugzilla->user;
+
+    $vars->{'realname'} = $user->name;
+
+    if (Bugzilla->params->{'allowemailchange'}
+        && $user->authorizer->can_change_email)
+    {
+       # First delete old tokens.
+       Bugzilla::Token::CleanTokenTable();
+
+        my @token = $dbh->selectrow_array(
+            "SELECT tokentype, " .
+                    $dbh->sql_date_math('issuedate', '+', MAX_TOKEN_AGE, 'DAY')
+                    . ", eventdata
+               FROM tokens
+              WHERE userid = ?
+                AND tokentype LIKE 'email%'
+           ORDER BY tokentype ASC " . $dbh->sql_limit(1), undef, $user->id);
+        if (scalar(@token) > 0) {
+            my ($tokentype, $change_date, $eventdata) = @token;
+            $vars->{'login_change_date'} = $change_date;
+
+            if($tokentype eq 'emailnew') {
+                my ($oldemail,$newemail) = split(/:/,$eventdata);
+                $vars->{'new_login_name'} = $newemail;
+            }
+        }
+    }
+}
+
+sub SaveAccount {
+    my $cgi = Bugzilla->cgi;
+    my $dbh = Bugzilla->dbh;
+    
+    $dbh->bz_start_transaction;
+
+    my $user = Bugzilla->user;
+
+    my $oldpassword = $cgi->param('old_password');
+    my $pwd1 = $cgi->param('new_password1');
+    my $pwd2 = $cgi->param('new_password2');
+    my $new_login_name = trim($cgi->param('new_login_name'));
+
+    if ($user->authorizer->can_change_password
+        && ($oldpassword ne "" || $pwd1 ne "" || $pwd2 ne ""))
+    {
+        my $oldcryptedpwd = $user->cryptpassword;
+        $oldcryptedpwd || ThrowCodeError("unable_to_retrieve_password");
+
+        if (bz_crypt($oldpassword, $oldcryptedpwd) ne $oldcryptedpwd) {
+            ThrowUserError("old_password_incorrect");
+        }
+
+        if ($pwd1 ne "" || $pwd2 ne "") {
+            $pwd1 || ThrowUserError("new_password_missing");
+            validate_password($pwd1, $pwd2);
+
+            if ($oldpassword ne $pwd1) {
+                $user->set_password($pwd1);
+                # Invalidate all logins except for the current one
+                Bugzilla->logout(LOGOUT_KEEP_CURRENT);
+            }
+        }
+    }
+
+    if ($user->authorizer->can_change_email
+        && Bugzilla->params->{"allowemailchange"}
+        && $new_login_name)
+    {
+        if ($user->login ne $new_login_name) {
+            $oldpassword || ThrowUserError("old_password_required");
+
+            # Block multiple email changes for the same user.
+            if (Bugzilla::Token::HasEmailChangeToken($user->id)) {
+                ThrowUserError("email_change_in_progress");
+            }
+
+            # Before changing an email address, confirm one does not exist.
+            check_email_syntax($new_login_name);
+            is_available_username($new_login_name)
+              || ThrowUserError("account_exists", {email => $new_login_name});
+
+            Bugzilla::Token::IssueEmailChangeToken($user, $new_login_name);
+
+            $vars->{'email_changes_saved'} = 1;
+        }
+    }
+
+    $user->set_name($cgi->param('realname'));
+    $user->update({ keep_session => 1, keep_tokens => 1 });
+    $dbh->bz_commit_transaction;
+}
+
+
+sub DoSettings {
+    my $user = Bugzilla->user;
+
+    my $settings = $user->settings;
+    $vars->{'settings'} = $settings;
+
+    my @setting_list = keys %$settings;
+    $vars->{'setting_names'} = \@setting_list;
+
+    $vars->{'has_settings_enabled'} = 0;
+    # Is there at least one user setting enabled?
+    foreach my $setting_name (@setting_list) {
+        if ($settings->{"$setting_name"}->{'is_enabled'}) {
+            $vars->{'has_settings_enabled'} = 1;
+            last;
+        }
+    }
+    $vars->{'dont_show_button'} = !$vars->{'has_settings_enabled'};
+}
+
+sub SaveSettings {
+    my $cgi = Bugzilla->cgi;
+    my $user = Bugzilla->user;
+
+    my $settings = $user->settings;
+    my @setting_list = keys %$settings;
+
+    foreach my $name (@setting_list) {
+        next if ! ($settings->{$name}->{'is_enabled'});
+        my $value = $cgi->param($name);
+        next unless defined $value;
+        my $setting = new Bugzilla::User::Setting($name);
+
+        if ($value eq "${name}-isdefault" ) {
+            if (! $settings->{$name}->{'is_default'}) {
+                $settings->{$name}->reset_to_default;
+            }
+        }
+        else {
+            $setting->validate_value($value);
+            $settings->{$name}->set($value);
+        }
+    }
+    $vars->{'settings'} = $user->settings(1);
+}
+
+sub DoEmail {
+    my $dbh = Bugzilla->dbh;
+    my $user = Bugzilla->user;
+    
+    ###########################################################################
+    # User watching
+    ###########################################################################
+    my $watched_ref = $dbh->selectcol_arrayref(
+        "SELECT profiles.login_name FROM watch INNER JOIN profiles" .
+        " ON watch.watched = profiles.userid" .
+        " WHERE watcher = ?" .
+        " ORDER BY profiles.login_name",
+        undef, $user->id);
+    $vars->{'watchedusers'} = $watched_ref;
+
+    my $watcher_ids = $dbh->selectcol_arrayref(
+        "SELECT watcher FROM watch WHERE watched = ?",
+        undef, $user->id);
+
+    my @watchers;
+    foreach my $watcher_id (@$watcher_ids) {
+        my $watcher = new Bugzilla::User($watcher_id);
+        push(@watchers, Bugzilla::User::identity($watcher));
+    }
+
+    @watchers = sort { lc($a) cmp lc($b) } @watchers;
+    $vars->{'watchers'} = \@watchers;
+}
+
+sub SaveEmail {
+    my $dbh = Bugzilla->dbh;
+    my $cgi = Bugzilla->cgi;
+    my $user = Bugzilla->user;
+
+    Bugzilla::User::match_field({ 'new_watchedusers' => {'type' => 'multi'} });
+
+    ###########################################################################
+    # Role-based preferences
+    ###########################################################################
+    $dbh->bz_start_transaction();
+
+    my $sth_insert = $dbh->prepare('INSERT INTO email_setting
+                                    (user_id, relationship, event) VALUES (?, ?, ?)');
+
+    my $sth_delete = $dbh->prepare('DELETE FROM email_setting
+                                    WHERE user_id = ? AND relationship = ? AND event = ?');
+    # Load current email preferences into memory before updating them.
+    my $settings = $user->mail_settings;
+
+    # Update the table - first, with normal events in the
+    # relationship/event matrix.
+    my %relationships = Bugzilla::BugMail::relationships();
+    foreach my $rel (keys %relationships) {
+        next if ($rel == REL_QA && !Bugzilla->params->{'useqacontact'});
+        # Positive events: a ticked box means "send me mail."
+        foreach my $event (POS_EVENTS) {
+            my $is_set = $cgi->param("email-$rel-$event");
+            if ($is_set xor $settings->{$rel}{$event}) {
+                if ($is_set) {
+                    $sth_insert->execute($user->id, $rel, $event);
+                }
+                else {
+                    $sth_delete->execute($user->id, $rel, $event);
+                }
+            }
+        }
+        
+        # Negative events: a ticked box means "don't send me mail."
+        foreach my $event (NEG_EVENTS) {
+            my $is_set = $cgi->param("neg-email-$rel-$event");
+            if (!$is_set xor $settings->{$rel}{$event}) {
+                if (!$is_set) {
+                    $sth_insert->execute($user->id, $rel, $event);
+                }
+                else {
+                    $sth_delete->execute($user->id, $rel, $event);
+                }
+            }
+        }
+    }
+
+    # Global positive events: a ticked box means "send me mail."
+    foreach my $event (GLOBAL_EVENTS) {
+        my $is_set = $cgi->param("email-" . REL_ANY . "-$event");
+        if ($is_set xor $settings->{+REL_ANY}{$event}) {
+            if ($is_set) {
+                $sth_insert->execute($user->id, REL_ANY, $event);
+            }
+            else {
+                $sth_delete->execute($user->id, REL_ANY, $event);
+            }
+        }
+    }
+
+    $dbh->bz_commit_transaction();
+
+    # We have to clear the cache about email preferences.
+    delete $user->{'mail_settings'};
+
+    ###########################################################################
+    # User watching
+    ###########################################################################
+    if (defined $cgi->param('new_watchedusers')
+        || defined $cgi->param('remove_watched_users'))
+    {
+        $dbh->bz_start_transaction();
+
+        # Use this to protect error messages on duplicate submissions
+        my $old_watch_ids =
+            $dbh->selectcol_arrayref("SELECT watched FROM watch"
+                                   . " WHERE watcher = ?", undef, $user->id);
+
+        # The new information given to us by the user.
+        my $new_watched_users = join(',', $cgi->param('new_watchedusers')) || '';
+        my @new_watch_names = split(/[,\s]+/, $new_watched_users);
+        my %new_watch_ids;
+
+        foreach my $username (@new_watch_names) {
+            my $watched_userid = login_to_id(trim($username), THROW_ERROR);
+            $new_watch_ids{$watched_userid} = 1;
+        }
+
+        # Add people who were added.
+        my $insert_sth = $dbh->prepare('INSERT INTO watch (watched, watcher)'
+                                     . ' VALUES (?, ?)');
+        foreach my $add_me (keys(%new_watch_ids)) {
+            next if grep($_ == $add_me, @$old_watch_ids);
+            $insert_sth->execute($add_me, $user->id);
+        }
+
+        if (defined $cgi->param('remove_watched_users')) {
+            my @removed = $cgi->param('watched_by_you');
+            # Remove people who were removed.
+            my $delete_sth = $dbh->prepare('DELETE FROM watch WHERE watched = ?'
+                                         . ' AND watcher = ?');
+            
+            my %remove_watch_ids;
+            foreach my $username (@removed) {
+                my $watched_userid = login_to_id(trim($username), THROW_ERROR);
+                $remove_watch_ids{$watched_userid} = 1;
+            }
+            foreach my $remove_me (keys(%remove_watch_ids)) {
+                $delete_sth->execute($remove_me, $user->id);
+            }
+        }
+
+        $dbh->bz_commit_transaction();
+    }
+}
+
+
+sub DoPermissions {
+    my $dbh = Bugzilla->dbh;
+    my $user = Bugzilla->user;
+    my (@has_bits, @set_bits);
+    
+    my $groups = $dbh->selectall_arrayref(
+               "SELECT DISTINCT name, description FROM groups WHERE id IN (" . 
+               $user->groups_as_string . ") ORDER BY name");
+    foreach my $group (@$groups) {
+        my ($nam, $desc) = @$group;
+        push(@has_bits, {"desc" => $desc, "name" => $nam});
+    }
+    $groups = $dbh->selectall_arrayref('SELECT DISTINCT id, name, description
+                                          FROM groups
+                                         ORDER BY name');
+    foreach my $group (@$groups) {
+        my ($group_id, $nam, $desc) = @$group;
+        if ($user->can_bless($group_id)) {
+            push(@set_bits, {"desc" => $desc, "name" => $nam});
+        }
+    }
+
+    # If the user has product specific privileges, inform him about that.
+    foreach my $privs (PER_PRODUCT_PRIVILEGES) {
+        next if $user->in_group($privs);
+        $vars->{"local_$privs"} = $user->get_products_by_permission($privs);
+    }
+
+    $vars->{'has_bits'} = \@has_bits;
+    $vars->{'set_bits'} = \@set_bits;    
+}
+
+# No SavePermissions() because this panel has no changeable fields.
+
+
+sub DoSavedSearches {
+    my $dbh = Bugzilla->dbh;
+    my $user = Bugzilla->user;
+
+    if ($user->queryshare_groups_as_string) {
+        $vars->{'queryshare_groups'} =
+            Bugzilla::Group->new_from_list($user->queryshare_groups);
+    }
+    $vars->{'bless_group_ids'} = [map { $_->id } @{$user->bless_groups}];
+}
+
+sub SaveSavedSearches {
+    my $cgi = Bugzilla->cgi;
+    my $dbh = Bugzilla->dbh;
+    my $user = Bugzilla->user;
+
+    # We'll need this in a loop, so do the call once.
+    my $user_id = $user->id;
+
+    my $sth_insert_nl = $dbh->prepare('INSERT INTO namedqueries_link_in_footer
+                                       (namedquery_id, user_id)
+                                       VALUES (?, ?)');
+    my $sth_delete_nl = $dbh->prepare('DELETE FROM namedqueries_link_in_footer
+                                             WHERE namedquery_id = ?
+                                               AND user_id = ?');
+    my $sth_insert_ngm = $dbh->prepare('INSERT INTO namedquery_group_map
+                                        (namedquery_id, group_id)
+                                        VALUES (?, ?)');
+    my $sth_update_ngm = $dbh->prepare('UPDATE namedquery_group_map
+                                           SET group_id = ?
+                                         WHERE namedquery_id = ?');
+    my $sth_delete_ngm = $dbh->prepare('DELETE FROM namedquery_group_map
+                                              WHERE namedquery_id = ?');
+
+    # Update namedqueries_link_in_footer for this user.
+    foreach my $q (@{$user->queries}, @{$user->queries_available}) {
+        if (defined $cgi->param("link_in_footer_" . $q->id)) {
+            $sth_insert_nl->execute($q->id, $user_id) if !$q->link_in_footer;
+        }
+        else {
+            $sth_delete_nl->execute($q->id, $user_id) if $q->link_in_footer;
+        }
+    }
+
+    # For user's own queries, update namedquery_group_map.
+    foreach my $q (@{$user->queries}) {
+        my $group_id;
+
+        if ($user->in_group(Bugzilla->params->{'querysharegroup'})) {
+            $group_id = $cgi->param("share_" . $q->id) || '';
+        }
+
+        if ($group_id) {
+            # Don't allow the user to share queries with groups he's not
+            # allowed to.
+            next unless grep($_ eq $group_id, @{$user->queryshare_groups});
+
+            # $group_id is now definitely a valid ID of a group the
+            # user can share queries with, so we can trick_taint.
+            detaint_natural($group_id);
+            if ($q->shared_with_group) {
+                $sth_update_ngm->execute($group_id, $q->id);
+            }
+            else {
+                $sth_insert_ngm->execute($q->id, $group_id);
+            }
+
+            # If we're sharing our query with a group we can bless, we 
+            # have the ability to add link to our search to the footer of
+            # direct group members automatically.
+            if ($user->can_bless($group_id) && $cgi->param('force_' . $q->id)) {
+                my $group = new Bugzilla::Group($group_id);
+                my $members = $group->members_non_inherited;
+                foreach my $member (@$members) {
+                    next if $member->id == $user->id;
+                    $sth_insert_nl->execute($q->id, $member->id)
+                        if !$q->link_in_footer($member);
+                }
+            }
+        }
+        else {
+            # They have unshared that query.
+            if ($q->shared_with_group) {
+                $sth_delete_ngm->execute($q->id);
+            }
+
+            # Don't remove namedqueries_link_in_footer entries for users
+            # subscribing to the shared query. The idea is that they will
+            # probably want to be subscribers again should the sharing
+            # user choose to share the query again.
+        }
+    }
+
+    $user->flush_queries_cache;
+    
+    # Update profiles.mybugslink.
+    my $showmybugslink = defined($cgi->param("showmybugslink")) ? 1 : 0;
+    $dbh->do("UPDATE profiles SET mybugslink = ? WHERE userid = ?",
+             undef, ($showmybugslink, $user->id));    
+    $user->{'showmybugslink'} = $showmybugslink;
+}
+
+
+###############################################################################
+# Live code (not subroutine definitions) starts here
+###############################################################################
+
+my $cgi = Bugzilla->cgi;
+
+# Delete credentials before logging in in case we are in a sudo session.
+$cgi->delete('Bugzilla_login', 'Bugzilla_password') if ($cgi->cookie('sudo'));
+$cgi->delete('GoAheadAndLogIn');
+
+# First try to get credentials from cookies.
+my $user = Bugzilla->login(LOGIN_OPTIONAL);
+
+if (!$user->id) {
+    # Use credentials given in the form if login cookies are not available.
+    $cgi->param('Bugzilla_login', $cgi->param('old_login'));
+    $cgi->param('Bugzilla_password', $cgi->param('old_password'));
+}
+Bugzilla->login(LOGIN_REQUIRED);
+
+my $save_changes = $cgi->param('dosave');
+$vars->{'changes_saved'} = $save_changes;
+
+my $current_tab_name = $cgi->param('tab') || "settings";
+
+# The SWITCH below makes sure that this is valid
+trick_taint($current_tab_name);
+
+$vars->{'current_tab_name'} = $current_tab_name;
+
+my $token = $cgi->param('token');
+check_token_data($token, 'edit_user_prefs') if $save_changes;
+
+# Do any saving, and then display the current tab.
+SWITCH: for ($current_tab_name) {
+
+    # Extensions must set it to 1 to confirm the tab is valid.
+    my $handled = 0;
+    Bugzilla::Hook::process('user_preferences',
+                            { 'vars'       => $vars,
+                              save_changes => $save_changes,
+                              current_tab  => $current_tab_name,
+                              handled      => \$handled });
+    last SWITCH if $handled;
+
+    /^account$/ && do {
+        SaveAccount() if $save_changes;
+        DoAccount();
+        last SWITCH;
+    };
+    /^settings$/ && do {
+        SaveSettings() if $save_changes;
+        DoSettings();
+        last SWITCH;
+    };
+    /^email$/ && do {
+        SaveEmail() if $save_changes;
+        DoEmail();
+        last SWITCH;
+    };
+    /^permissions$/ && do {
+        DoPermissions();
+        last SWITCH;
+    };
+    /^saved-searches$/ && do {
+        SaveSavedSearches() if $save_changes;
+        DoSavedSearches();
+        last SWITCH;
+    };
+
+    ThrowUserError("unknown_tab",
+                   { current_tab_name => $current_tab_name });
+}
+
+delete_token($token) if $save_changes;
+if ($current_tab_name ne 'permissions') {
+    $vars->{'token'} = issue_session_token('edit_user_prefs');
+}
+
+# Generate and return the UI (HTML page) from the appropriate template.
+print $cgi->header();
+$template->process("account/prefs/prefs.html.tmpl", $vars)
+  || ThrowTemplateError($template->error());

diff --git a/votes.cgi b/votes.cgi
new file mode 100755 (executable)
index 0000000..246ab4c
--- /dev/null
+++ b/votes.cgi
@@ -0,0 +1,36 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# This script remains as a backwards-compatibility URL for before
+# the time that Voting was an extension.
+
+use strict;
+use lib qw(. lib);
+use Bugzilla;
+use Bugzilla::Error;
+
+my $is_enabled = grep { $_->NAME eq 'Voting' } @{ Bugzilla->extensions };
+$is_enabled || ThrowUserError('extension_disabled', { name => 'Voting' });
+
+my $cgi = Bugzilla->cgi;
+my $action = $cgi->param('action') || 'show_user';
+
+if ($action eq "show_bug") {
+    $cgi->delete('action');
+    $cgi->param('id', 'voting/bug.html');
+} 
+elsif ($action eq "show_user" or $action eq 'vote') {
+    $cgi->delete('action') unless $action eq 'vote';
+    $cgi->param('id', 'voting/user.html');
+}
+else {
+    ThrowUserError('unknown_action', {action => $action});
+}
+
+print $cgi->redirect('page.cgi?' . $cgi->query_string);
+exit;

diff --git a/whine.pl b/whine.pl
new file mode 100755 (executable)
index 0000000..0a0f6a1
--- /dev/null
+++ b/whine.pl
@@ -0,0 +1,694 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+################################################################################
+# Script Initialization
+################################################################################
+
+use strict;
+
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Search;
+use Bugzilla::User;
+use Bugzilla::Mailer;
+use Bugzilla::Util;
+use Bugzilla::Group;
+
+# create some handles that we'll need
+my $template = Bugzilla->template;
+my $dbh      = Bugzilla->dbh;
+my $sth;
+
+# @seen_schedules is a list of all of the schedules that have already been
+# touched by reset_timer.  If reset_timer sees a schedule more than once, it
+# sets it to NULL so it won't come up again until the next execution of
+# whine.pl
+my @seen_schedules = ();
+
+# These statement handles should live outside of their functions in order to
+# allow the database to keep their SQL compiled.
+my $sth_run_queries =
+    $dbh->prepare("SELECT " .
+                  "query_name, title, onemailperbug " .
+                  "FROM whine_queries " .
+                  "WHERE eventid=? " .
+                  "ORDER BY sortkey");
+my $sth_get_query =
+    $dbh->prepare("SELECT query FROM namedqueries " .
+                  "WHERE userid = ? AND name = ?");
+
+# get the event that's scheduled with the lowest run_next value
+my $sth_next_scheduled_event = $dbh->prepare(
+    "SELECT " .
+    " whine_schedules.eventid, " .
+    " whine_events.owner_userid, " .
+    " whine_events.subject, " .
+    " whine_events.body, " .
+    " whine_events.mailifnobugs " .
+    "FROM whine_schedules " .
+    "LEFT JOIN whine_events " .
+    " ON whine_events.id = whine_schedules.eventid " .
+    "WHERE run_next <= NOW() " .
+    "ORDER BY run_next " .
+    $dbh->sql_limit(1)
+);
+
+# get all pending schedules matching an eventid
+my $sth_schedules_by_event = $dbh->prepare(
+    "SELECT id, mailto_type, mailto " .
+    "FROM whine_schedules " .
+    "WHERE eventid=? AND run_next <= NOW()"
+);
+
+
+################################################################################
+# Main Body Execution
+################################################################################
+
+# This script needs to check through the database for schedules that have
+# run_next set to NULL, which means that schedule is new or has been altered.
+# It then sets it to run immediately if the schedule entry has it running at
+# an interval like every hour, otherwise to the appropriate day and time.
+
+# After that, it looks over each user to see if they have schedules that need
+# running, then runs those and generates the email messages.
+
+# Send whines from the address in the 'mailfrom' Parameter so that all
+# Bugzilla-originated mail appears to come from a single address.
+my $fromaddress = Bugzilla->params->{'mailfrom'};
+
+# get the current date and time
+my ($now_sec, $now_minute, $now_hour, $now_day, $now_month, $now_year, 
+    $now_weekday) = localtime;
+# Convert year to two digits
+$now_year = sprintf("%02d", $now_year % 100);
+# Convert the month to January being "1" instead of January being "0".
+$now_month++;
+
+my @daysinmonth = qw(0 31 28 31 30 31 30 31 31 30 31 30 31);
+# Alter February in case of a leap year.  This simple way to do it only
+# applies if you won't be looking at February of next year, which whining
+# doesn't need to do.
+if (($now_year % 4 == 0) &&
+    (($now_year % 100 != 0) || ($now_year % 400 == 0))) {
+    $daysinmonth[2] = 29;
+}
+
+# run_day can contain either a calendar day (1, 2, 3...), a day of the week
+# (Mon, Tue, Wed...), a range of days (All, MF), or 'last' for the last day of
+# the month.
+#
+# run_time can contain either an hour (0, 1, 2...) or an interval
+# (60min, 30min, 15min).
+#
+# We go over each uninitialized schedule record and use its settings to
+# determine what the next time it runs should be
+my $sched_h = $dbh->prepare("SELECT id, run_day, run_time " .
+                            "FROM whine_schedules " .
+                            "WHERE run_next IS NULL" );
+$sched_h->execute();
+while (my ($schedule_id, $day, $time) = $sched_h->fetchrow_array) {
+    # fill in some defaults in case they're blank
+    $day  ||= '0';
+    $time ||= '0';
+
+    # If this schedule is supposed to run today, we see if it's supposed to be
+    # run at a particular hour.  If so, we set it for that hour, and if not,
+    # it runs at an interval over the course of a day, which means we should
+    # set it to run immediately.
+    if (&check_today($day)) {
+        # Values that are not entirely numeric are intervals, like "30min"
+        if ($time !~ /^\d+$/) {
+            # set it to now
+            $sth = $dbh->prepare( "UPDATE whine_schedules " .
+                                  "SET run_next=NOW() " .
+                                  "WHERE id=?");
+            $sth->execute($schedule_id);
+        }
+        # A time greater than now means it still has to run today
+        elsif ($time >= $now_hour) {
+            # set it to today + number of hours
+            $sth = $dbh->prepare(
+                "UPDATE whine_schedules " .
+                   "SET run_next = " .
+                        $dbh->sql_date_math('CURRENT_DATE', '+', '?', 'HOUR') .
+                " WHERE id = ?");
+            $sth->execute($time, $schedule_id);
+        }
+        # the target time is less than the current time
+        else { # set it for the next applicable day
+            $day = &get_next_date($day);
+            my $run_next = $dbh->sql_date_math('(' 
+                . $dbh->sql_date_math('CURRENT_DATE', '+', '?', 'DAY')
+                . ')', '+', '?', 'HOUR');
+            $sth = $dbh->prepare("UPDATE whine_schedules " .
+                                    "SET run_next = $run_next
+                                   WHERE id = ?");
+            $sth->execute($day, $time, $schedule_id);
+        }
+
+    }
+    # If the schedule is not supposed to run today, we set it to run on the
+    # appropriate date and time
+    else {
+        my $target_date = &get_next_date($day);
+        # If configured for a particular time, set it to that, otherwise
+        # midnight
+        my $target_time = ($time =~ /^\d+$/) ? $time : 0;
+
+       my $run_next = $dbh->sql_date_math('(' 
+            . $dbh->sql_date_math('CURRENT_DATE', '+', '?', 'DAY') 
+            . ')', '+', '?', 'HOUR');
+        $sth = $dbh->prepare("UPDATE whine_schedules " .
+                                "SET run_next = $run_next
+                               WHERE id = ?");
+        $sth->execute($target_date, $target_time, $schedule_id);
+    }
+}
+$sched_h->finish();
+
+# get_next_event
+#
+# This function will:
+#   1. Lock whine_schedules
+#   2. Grab the most overdue pending schedules on the same event that must run
+#   3. Update those schedules' run_next value
+#   4. Unlock the table
+#   5. Return an event hashref
+#
+# The event hashref consists of:
+#   eventid - ID of the event 
+#   author  - user object for the event's creator
+#   users   - array of user objects for recipients
+#   subject - Subject line for the email
+#   body    - the text inserted above the bug lists
+#   mailifnobugs - send message even if there are no query or query results
+
+sub get_next_event {
+    my $event = {};
+
+    # Loop until there's something to return
+    until (scalar keys %{$event}) {
+
+        $dbh->bz_start_transaction();
+
+        # Get the event ID for the first pending schedule
+        $sth_next_scheduled_event->execute;
+        my $fetched = $sth_next_scheduled_event->fetch;
+        $sth_next_scheduled_event->finish;
+        return undef unless $fetched;
+        my ($eventid, $owner_id, $subject, $body, $mailifnobugs) = @{$fetched};
+
+        my $owner = Bugzilla::User->new($owner_id);
+
+        my $whineatothers = $owner->in_group('bz_canusewhineatothers');
+
+        my %user_objects;   # Used for keeping track of who has been added
+
+        # Get all schedules that match that event ID and are pending
+        $sth_schedules_by_event->execute($eventid);
+
+        # Add the users from those schedules to the list
+        while (my $row = $sth_schedules_by_event->fetch) {
+            my ($sid, $mailto_type, $mailto) = @{$row};
+
+            # Only bother doing any work if this user has whine permission
+            if ($owner->in_group('bz_canusewhines')) {
+
+                if ($mailto_type == MAILTO_USER) {
+                    if (not defined $user_objects{$mailto}) {
+                        if ($mailto == $owner_id) {
+                            $user_objects{$mailto} = $owner;
+                        }
+                        elsif ($whineatothers) {
+                            $user_objects{$mailto} = Bugzilla::User->new($mailto);
+                        }
+                    }
+                }
+                elsif ($mailto_type == MAILTO_GROUP) {
+                    my $sth = $dbh->prepare("SELECT name FROM groups " .
+                                            "WHERE id=?");
+                    $sth->execute($mailto);
+                    my $groupname = $sth->fetch->[0];
+                    my $group_id = Bugzilla::Group::ValidateGroupName(
+                        $groupname, $owner);
+                    if ($group_id) {
+                        my $glist = join(',',
+                            @{Bugzilla::Group->flatten_group_membership(
+                            $group_id)});
+                        $sth = $dbh->prepare("SELECT user_id FROM " .
+                                             "user_group_map " .
+                                             "WHERE group_id IN ($glist)");
+                        $sth->execute();
+                        for my $row (@{$sth->fetchall_arrayref}) {
+                            if (not defined $user_objects{$row->[0]}) {
+                                $user_objects{$row->[0]} =
+                                    Bugzilla::User->new($row->[0]);
+                            }
+                        }
+                    }
+                }
+
+            }
+
+            reset_timer($sid);
+        }
+
+        $dbh->bz_commit_transaction();
+
+        # Only set $event if the user is allowed to do whining
+        if ($owner->in_group('bz_canusewhines')) {
+            my @users = values %user_objects;
+            $event = {
+                    'eventid' => $eventid,
+                    'author'  => $owner,
+                    'mailto'  => \@users,
+                    'subject' => $subject,
+                    'body'    => $body,
+                    'mailifnobugs' => $mailifnobugs,
+            };
+        }
+    }
+    return $event;
+}
+
+# Run the queries for each event
+#
+# $event:
+#   eventid (the database ID for this event)
+#   author  (user object for who created the event)
+#   mailto  (array of user objects for mail targets)
+#   subject (subject line for message)
+#   body    (text blurb at top of message)
+#   mailifnobugs (send message even if there are no query or query results)
+while (my $event = get_next_event) {
+
+    my $eventid = $event->{'eventid'};
+
+    # We loop for each target user because some of the queries will be using
+    # subjective pronouns
+    $dbh = Bugzilla->switch_to_shadow_db();
+    for my $target (@{$event->{'mailto'}}) {
+        my $args = {
+            'subject'     => $event->{'subject'},
+            'body'        => $event->{'body'},
+            'eventid'     => $event->{'eventid'},
+            'author'      => $event->{'author'},
+            'recipient'   => $target,
+            'from'        => $fromaddress,
+        };
+
+        # run the queries for this schedule
+        my $queries = run_queries($args);
+
+        # If mailifnobugs is false, make sure there is something to output
+        if (!$event->{'mailifnobugs'}) {
+            my $there_are_bugs = 0;
+            for my $query (@{$queries}) {
+                $there_are_bugs = 1 if scalar @{$query->{'bugs'}};
+            }
+            next unless $there_are_bugs;
+        }
+
+        $args->{'queries'} = $queries;
+
+        mail($args);
+    }
+    $dbh = Bugzilla->switch_to_main_db();
+}
+
+################################################################################
+# Functions
+################################################################################
+
+# The mail and run_queries functions use an anonymous hash ($args) for their
+# arguments, which are then passed to the templates.
+#
+# When run_queries is run, $args contains the following fields:
+#  - body           Message body defined in event
+#  - from           Bugzilla system email address
+#  - queries        array of hashes containing:
+#          - bugs:  array of hashes mapping fieldnames to values for this bug
+#          - title: text title given to this query in the whine event
+#          - columnlist: array of fieldnames to display in the mail
+#          - name:  text name of this query
+#  - schedule_id    integer id of the schedule being run
+#  - subject        Subject line for the message
+#  - recipient      user object for the recipient
+#  - author         user object of the person who created the whine event
+#
+# In addition, mail adds two more fields to $args:
+#  - alternatives   array of hashes defining mime multipart types and contents
+#  - boundary       a MIME boundary generated using the process id and time
+#
+sub mail {
+    my $args = shift;
+    my $addressee = $args->{recipient};
+    # Don't send mail to someone whose bugmail notification is disabled.
+    return if $addressee->email_disabled;
+
+    my $template = Bugzilla->template_inner($addressee->setting('lang'));
+    my $msg = ''; # it's a temporary variable to hold the template output
+    $args->{'alternatives'} ||= [];
+
+    # put together the different multipart mime segments
+
+    $template->process("whine/mail.txt.tmpl", $args, \$msg)
+        or die($template->error());
+    push @{$args->{'alternatives'}},
+        {
+            'content' => $msg,
+            'type'    => 'text/plain',
+        };
+    $msg = '';
+
+    $template->process("whine/mail.html.tmpl", $args, \$msg)
+        or die($template->error());
+    push @{$args->{'alternatives'}},
+        {
+            'content' => $msg,
+            'type'    => 'text/html',
+        };
+    $msg = '';
+
+    # now produce a ready-to-mail mime-encoded message
+
+    $args->{'boundary'} = "----------" . $$ . "--" . time() . "-----";
+
+    $template->process("whine/multipart-mime.txt.tmpl", $args, \$msg)
+        or die($template->error());
+
+    MessageToMTA($msg);
+
+    delete $args->{'boundary'};
+    delete $args->{'alternatives'};
+
+}
+
+# run_queries runs all of the queries associated with a schedule ID, adding
+# the results to $args or mailing off the template if a query wants individual
+# messages for each bug
+sub run_queries {
+    my $args = shift;
+
+    my $return_queries = [];
+
+    $sth_run_queries->execute($args->{'eventid'});
+    my @queries = ();
+    for (@{$sth_run_queries->fetchall_arrayref}) {
+        push(@queries,
+            {
+              'name'          => $_->[0],
+              'title'         => $_->[1],
+              'onemailperbug' => $_->[2],
+              'columnlist'    => [],
+              'bugs'          => [],
+            }
+        );
+    }
+
+    foreach my $thisquery (@queries) {
+        next unless $thisquery->{'name'};   # named query is blank
+
+        my $savedquery = get_query($thisquery->{'name'}, $args->{'author'});
+        next unless $savedquery;    # silently ignore missing queries
+
+        # Execute the saved query
+        my @searchfields = qw(
+            bug_id
+            bug_severity
+            priority
+            rep_platform
+            assigned_to
+            bug_status
+            resolution
+            short_desc
+        );
+        # A new Bugzilla::CGI object needs to be created to allow
+        # Bugzilla::Search to execute a saved query.  It's exceedingly weird,
+        # but that's how it works.
+        my $searchparams = new Bugzilla::CGI($savedquery);
+
+        # Use the columnlist for the saved query, if it exists, and make
+        # sure bug_id is always in the list.
+        if (my $columnlist = $searchparams->param('columnlist')) {
+            @searchfields = split(/[\s,]+/, $columnlist);
+            unshift(@searchfields, 'bug_id') unless grep { $_ eq 'bug_id' } @searchfields;
+        }
+        push @{$thisquery->{'columnlist'}}, @searchfields;
+
+        my @orderstrings = split(/,\s*/, $searchparams->param('order') || '');
+        my $search = new Bugzilla::Search(
+            'fields' => \@searchfields,
+            'params' => scalar $searchparams->Vars,
+            'user'   => $args->{'recipient'}, # the search runs as the recipient
+            'order'  => \@orderstrings
+        );
+        # If a query fails for whatever reason, it shouldn't kill the script.
+        my $data = eval { $search->data };
+        if ($@) {
+            print STDERR get_text('whine_query_failed', { query_name => $thisquery->{'name'},
+                                                          author => $args->{'author'},
+                                                          reason => $@ }) . "\n";
+            next;
+        }
+
+        foreach my $row (@$data) {
+            my $bug = {};
+            for my $field (@searchfields) {
+                my $fieldname = $field;
+                $fieldname =~ s/^bugs\.//;  # No need for bugs.whatever
+                $bug->{$fieldname} = shift @$row;
+            }
+
+            if ($thisquery->{'onemailperbug'}) {
+                $args->{'queries'} = [
+                    {
+                        'name' => $thisquery->{'name'},
+                        'title' => $thisquery->{'title'},
+                        'columnlist' => $thisquery->{'columnlist'},
+                        'bugs' => [ $bug ],
+                    },
+                ];
+                mail($args);
+                delete $args->{'queries'};
+            }
+            else {  # It belongs in one message with any other lists
+                push @{$thisquery->{'bugs'}}, $bug;
+            }
+        }
+        if (!$thisquery->{'onemailperbug'} && @{$thisquery->{'bugs'}}) {
+            push @{$return_queries}, $thisquery;
+        }
+    }
+
+    return $return_queries;
+}
+
+# get_query gets the namedquery.  It's similar to LookupNamedQuery (in
+# buglist.cgi), but doesn't care if a query name really exists or not, since
+# individual named queries might go away without the whine_queries that point
+# to them being removed.
+sub get_query {
+    my ($name, $user) = @_;
+    my $qname = $name;
+    $sth_get_query->execute($user->id, $qname);
+    my $fetched = $sth_get_query->fetch;
+    $sth_get_query->finish;
+    return $fetched ? $fetched->[0] : '';
+}
+
+# check_today gets a run day from the schedule and sees if it matches today
+# a run day value can contain any of:
+#   - a three-letter day of the week
+#   - a number for a day of the month
+#   - 'last' for the last day of the month
+#   - 'All' for every day
+#   - 'MF' for every weekday
+
+sub check_today {
+    my $run_day  = shift;
+
+    if (($run_day eq 'MF')
+     && ($now_weekday > 0)
+     && ($now_weekday < 6)) {
+        return 1;
+    }
+    elsif (
+         length($run_day) == 3 &&
+         index("SunMonTueWedThuFriSat", $run_day)/3 == $now_weekday) {
+        return 1;
+    }
+    elsif  (($run_day eq 'All')
+         || (($run_day eq 'last')  &&
+             ($now_day == $daysinmonth[$now_month] ))
+         || ($run_day eq $now_day)) {
+        return 1;
+    }
+    return 0;
+}
+
+# reset_timer sets the next time a whine is supposed to run, assuming it just
+# ran moments ago.  Its only parameter is a schedule ID.
+#
+# reset_timer does not lock the whine_schedules table.  Anything that calls it
+# should do that itself.
+sub reset_timer {
+    my $schedule_id = shift;
+
+    # Schedules may not be executed more than once for each invocation of
+    # whine.pl -- there are legitimate circumstances that can cause this, like
+    # a set of whines that take a very long time to execute, so it's done
+    # quietly.
+    if (grep($_ == $schedule_id, @seen_schedules)) {
+        null_schedule($schedule_id);
+        return;
+    }
+    push @seen_schedules, $schedule_id;
+
+    $sth = $dbh->prepare( "SELECT run_day, run_time FROM whine_schedules " .
+                          "WHERE id=?" );
+    $sth->execute($schedule_id);
+    my ($run_day, $run_time) = $sth->fetchrow_array;
+
+    # It may happen that the run_time field is NULL or blank due to
+    # a bug in editwhines.cgi when this field was initially 0.
+    $run_time ||= 0;
+
+    my $run_today = 0;
+    my $minute_offset = 0;
+
+    # If the schedule is to run today, and it runs many times per day,
+    # it shall be set to run immediately.
+    $run_today = &check_today($run_day);
+    if (($run_today) && ($run_time !~ /^\d+$/)) {
+        # The default of 60 catches any bad value
+        my $minute_interval = 60;
+        if ($run_time =~ /^(\d+)min$/i) {
+            $minute_interval = $1;
+        }
+
+        # set the minute offset to the next interval point
+        $minute_offset = $minute_interval - ($now_minute % $minute_interval);
+    }
+    elsif (($run_today) && ($run_time > $now_hour)) {
+        # timed event for later today
+        # (This should only happen if, for example, an 11pm scheduled event
+        #  didn't happen until after midnight)
+        $minute_offset = (60 * ($run_time - $now_hour)) - $now_minute;
+    }
+    else {
+        # it's not something that runs later today.
+        $minute_offset = 0;
+
+        # Set the target time if it's a specific hour
+        my $target_time = ($run_time =~ /^\d+$/) ? $run_time : 0;
+
+        my $nextdate = &get_next_date($run_day);
+        my $run_next = $dbh->sql_date_math('('
+            . $dbh->sql_date_math('CURRENT_DATE', '+', '?', 'DAY')
+            . ')', '+', '?', 'HOUR');
+        $sth = $dbh->prepare("UPDATE whine_schedules " .
+                                "SET run_next = $run_next
+                               WHERE id = ?");
+        $sth->execute($nextdate, $target_time, $schedule_id);
+        return;
+    }
+
+    if ($minute_offset > 0) {
+        # Scheduling is done in terms of whole minutes.
+        
+        my $next_run = $dbh->selectrow_array(
+            'SELECT ' . $dbh->sql_date_math('NOW()', '+', '?', 'MINUTE'),
+            undef, $minute_offset);
+        $next_run = format_time($next_run, "%Y-%m-%d %R");
+
+        $sth = $dbh->prepare("UPDATE whine_schedules " .
+                             "SET run_next = ? WHERE id = ?");
+        $sth->execute($next_run, $schedule_id);
+    } else {
+        # The minute offset is zero or less, which is not supposed to happen.
+        # complain to STDERR
+        null_schedule($schedule_id);
+        print STDERR "Error: bad minute_offset for schedule ID $schedule_id\n";
+    }
+}
+
+# null_schedule is used to safeguard against infinite loops.  Schedules with
+# run_next set to NULL will not be available to get_next_event until they are
+# rescheduled, which only happens when whine.pl starts.
+sub null_schedule {
+    my $schedule_id = shift;
+    $sth = $dbh->prepare("UPDATE whine_schedules " .
+                         "SET run_next = NULL " .
+                         "WHERE id=?");
+    $sth->execute($schedule_id);
+}
+
+# get_next_date determines the difference in days between now and the next
+# time a schedule should run, excluding today
+#
+# It takes a run_day argument (see check_today, above, for an explanation),
+# and returns an integer, representing a number of days.
+sub get_next_date {
+    my $day = shift;
+
+    my $add_days = 0;
+
+    if ($day eq 'All') {
+        $add_days = 1;
+    }
+    elsif ($day eq 'last') {
+        # next_date should contain the last day of this month, or next month
+        # if it's today
+        if ($daysinmonth[$now_month] == $now_day) {
+            my $month = $now_month + 1;
+            $month = 1 if $month > 12;
+            $add_days = $daysinmonth[$month] + 1;
+        }
+        else {
+            $add_days = $daysinmonth[$now_month] - $now_day;
+        }
+    }
+    elsif ($day eq 'MF') { # any day Monday through Friday
+        if ($now_weekday < 5) { # Sun-Thurs
+            $add_days = 1;
+        }
+        elsif ($now_weekday == 5) { # Friday
+            $add_days = 3;
+        }
+        else { # it's 6, Saturday
+            $add_days = 2;
+        }
+    }
+    elsif ($day !~ /^\d+$/) { # A specific day of the week
+        # The default is used if there is a bad value in the database, in
+        # which case we mark it to a less-popular day (Sunday)
+        my $day_num = 0;
+
+        if (length($day) == 3) {
+            $day_num = (index("SunMonTueWedThuFriSat", $day)/3) or 0;
+        }
+
+        $add_days = $day_num - $now_weekday;
+        if ($add_days <= 0) { # it's next week
+            $add_days += 7;
+        }
+    }
+    else { # it's a number, so we set it for that calendar day
+        $add_days = $day - $now_day;
+        # If it's already beyond that day this month, set it to the next one
+        if ($add_days <= 0) {
+            $add_days += $daysinmonth[$now_month];
+        }
+    }
+    return $add_days;
+}

diff --git a/whineatnews.pl b/whineatnews.pl
new file mode 100755 (executable)
index 0000000..4a5c967
--- /dev/null
+++ b/whineatnews.pl
@@ -0,0 +1,82 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+# This is a script suitable for running once a day from a cron job.  It 
+# looks at all the bugs, and sends whiny mail to anyone who has a bug 
+# assigned to them that has status CONFIRMED, NEW, or REOPENED that has not
+# been touched for more than the number of days specified in the whinedays
+# param. (We have NEW and REOPENED in there to keep compatibility with old
+# Bugzillas.)
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Mailer;
+use Bugzilla::Util;
+use Bugzilla::User;
+
+# Whining is disabled if whinedays is zero
+exit unless Bugzilla->params->{'whinedays'} >= 1;
+
+my $dbh = Bugzilla->dbh;
+my $query = q{SELECT bug_id, short_desc, login_name
+                FROM bugs
+          INNER JOIN profiles
+                  ON userid = assigned_to
+               WHERE bug_status IN (?,?,?)
+                 AND disable_mail = 0
+                 AND } . $dbh->sql_to_days('NOW()') . " - " .
+                       $dbh->sql_to_days('delta_ts') . " > " .
+                       Bugzilla->params->{'whinedays'} .
+          " ORDER BY bug_id";
+
+my %bugs;
+my %desc;
+
+my $slt_bugs = $dbh->selectall_arrayref($query, undef, 'CONFIRMED', 'NEW',
+                                                       'REOPENED');
+
+foreach my $bug (@$slt_bugs) {
+    my ($id, $desc, $email) = @$bug;
+    if (!defined $bugs{$email}) {
+        $bugs{$email} = [];
+    }
+    if (!defined $desc{$email}) {
+        $desc{$email} = [];
+    }
+    push @{$bugs{$email}}, $id;
+    push @{$desc{$email}}, $desc;
+}
+
+
+foreach my $email (sort (keys %bugs)) {
+    my $user = new Bugzilla::User({name => $email});
+    next if $user->email_disabled;
+
+    my $vars = {'email' => $email};
+
+    my @bugs = ();
+    foreach my $i (@{$bugs{$email}}) {
+        my $bug = {};
+        $bug->{'summary'} = shift(@{$desc{$email}});
+        $bug->{'id'} = $i;
+        push @bugs, $bug;
+    }
+    $vars->{'bugs'} = \@bugs;
+
+    my $msg;
+    my $template = Bugzilla->template_inner($user->setting('lang'));
+    $template->process("email/whine.txt.tmpl", $vars, \$msg)
+      or die($template->error());
+
+    MessageToMTA($msg);
+
+    say "$email      " . join(" ", @{$bugs{$email}});
+}

diff --git a/xmlrpc.cgi b/xmlrpc.cgi
new file mode 100755 (executable)
index 0000000..64197a8
--- /dev/null
+++ b/xmlrpc.cgi
@@ -0,0 +1,39 @@
+#!/usr/bin/perl -wT
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+use strict;
+use lib qw(. lib);
+
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Error;
+use Bugzilla::WebService::Constants;
+BEGIN {
+    if (!Bugzilla->feature('xmlrpc')) {
+        ThrowUserError('feature_disabled', { feature => 'xmlrpc' });
+    }
+}
+use Bugzilla::WebService::Server::XMLRPC;
+
+Bugzilla->usage_mode(USAGE_MODE_XMLRPC);
+
+# Fix the error code that SOAP::Lite uses for Perl errors.
+local $SOAP::Constants::FAULT_SERVER;
+$SOAP::Constants::FAULT_SERVER = ERROR_UNKNOWN_FATAL;
+# The line above is used, this one is ignored, but SOAP::Lite
+# might start using this constant (the correct one) for XML-RPC someday.
+local $XMLRPC::Constants::FAULT_SERVER;
+$XMLRPC::Constants::FAULT_SERVER = ERROR_UNKNOWN_FATAL;
+
+local @INC = (bz_locations()->{extensionsdir}, @INC);
+my $server = new Bugzilla::WebService::Server::XMLRPC;
+# We use a sub for on_action because that gets us the info about what 
+# class is being called. Note that this is a hack--this is technically 
+# for setting SOAPAction, which isn't used by XML-RPC.
+$server->on_action(sub { $server->handle_login(WS_DISPATCH, @_) })
+       ->handle();

diff --git a/xt/README b/xt/README
new file mode 100644 (file)
index 0000000..22f9f17
--- /dev/null
+++ b/xt/README
@@ -0,0 +1,18 @@
+The tests in this directory require a working database, as opposed
+to the tests in t/, which simply test the code without a working
+installation.
+
+Some of the tests may modify your current working installation, even
+if only temporarily. To run the tests that modify your database,
+set the environment variable BZ_WRITE_TESTS to 1.
+
+Some tests also take additional, optional arguments. You can pass arguments
+to tests like:
+
+  prove xt/search.t :: --long --operators=equals,notequals
+
+Note the "::"--that is necessary to note that the arguments are going to
+the test, not to "prove".
+
+See the perldoc of the individual tests to see what options they support,
+or do "perl xt/search.t --help".

diff --git a/xt/lib/Bugzilla/Test/Search.pm b/xt/lib/Bugzilla/Test/Search.pm
new file mode 100644 (file)
index 0000000..ca3bba5
--- /dev/null
+++ b/xt/lib/Bugzilla/Test/Search.pm
@@ -0,0 +1,987 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# This module tests Bugzilla/Search.pm. It uses various constants
+# that are in Bugzilla::Test::Search::Constants, in xt/lib/.
+#
+# It does this by:
+# 1) Creating a bunch of field values. Each field value is
+#    randomly named and fully unique.
+# 2) Creating a bunch of bugs that use those unique field
+#    values. Each bug has different characteristics--see
+#    the comment above the NUM_BUGS constant for a description
+#    of each bug.
+# 3) Running searches using the combination of every search operator against
+#    every field. The tests that we run are described by the TESTS constant.
+#    Some of the operator/field combinations are known to be broken--
+#    these are listed in the KNOWN_BROKEN constant.
+# 4) For each search, we make sure that certain bugs are contained in
+#    the search, and certain other bugs are not contained in the search.
+#    The code for the operator/field tests is mostly in
+#    Bugzilla::Test::Search::FieldTest.
+# 5) After testing each operator/field combination's functionality, we
+#    do additional tests to make sure that there are no SQL injections
+#    possible via any operator/field combination. The code for the
+#    SQL Injection tests is in Bugzilla::Test::Search::InjectionTest.
+#
+# Generally, the only way that you should modify the behavior of this
+# script is by modifying the constants.
+
+package Bugzilla::Test::Search;
+
+use strict;
+use warnings;
+use Bugzilla::Attachment;
+use Bugzilla::Bug ();
+use Bugzilla::Constants;
+use Bugzilla::Field;
+use Bugzilla::Field::Choice;
+use Bugzilla::FlagType;
+use Bugzilla::Group;
+use Bugzilla::Install ();
+use Bugzilla::Test::Search::Constants;
+use Bugzilla::Test::Search::CustomTest;
+use Bugzilla::Test::Search::FieldTestNormal;
+use Bugzilla::Test::Search::OperatorTest;
+use Bugzilla::User ();
+use Bugzilla::Util qw(generate_random_password);
+
+use Carp;
+use DateTime;
+use Scalar::Util qw(blessed);
+
+###############
+# Constructor #
+###############
+
+sub new {
+    my ($class, $options) = @_;
+    return bless { options => $options }, $class;
+}
+
+#############
+# Accessors #
+#############
+
+sub options { return $_[0]->{options} }
+sub option { return $_[0]->{options}->{$_[1]} }
+
+sub num_tests {
+    my ($self) = @_;
+    my @top_operators = $self->top_level_operators;
+    my @all_operators = $self->all_operators;
+    my $top_operator_tests = $self->_total_operator_tests(\@top_operators);
+    my $all_operator_tests = $self->_total_operator_tests(\@all_operators);
+
+    my @fields = $self->all_fields;
+
+    # Basically, we run TESTS_PER_RUN tests for each field/operator combination.
+    my $top_combinations = $top_operator_tests * scalar(@fields);
+    my $all_combinations = $all_operator_tests * scalar(@fields);
+    # But we also have ORs, for which we run combinations^2 tests.
+    my $join_tests = $self->option('long')
+                     ? ($top_combinations * $all_combinations) : 0;
+    # And AND tests, which means we run 2x $join_tests;
+    $join_tests = $join_tests * 2;
+    # Also, because of NOT tests and Normal tests, we run 3x $top_combinations.
+    my $basic_tests = $top_combinations * 3;
+    my $operator_field_tests = ($basic_tests + $join_tests) * TESTS_PER_RUN;
+
+    # Then we test each field/operator combination for SQL injection.
+    my @injection_values = INJECTION_TESTS;
+    my $sql_injection_tests = scalar(@fields) * scalar(@top_operators)
+                              * scalar(@injection_values) * NUM_SEARCH_TESTS;
+
+    # This @{ [] } thing is the only reasonable way to get a count out of a
+    # constant array.
+    my $special_tests = scalar(@{ [SPECIAL_PARAM_TESTS, CUSTOM_SEARCH_TESTS] }) 
+                        * TESTS_PER_RUN;
+    
+    return $operator_field_tests + $sql_injection_tests + $special_tests;
+}
+
+sub _total_operator_tests {
+    my ($self, $operators) = @_;
+    
+    # Some operators have more than one test. Find those ones and add
+    # them to the total operator tests
+    my $extra_operator_tests;
+    foreach my $operator (@$operators) {
+        my $tests = TESTS->{$operator};
+        next if !$tests;
+        my $extra_num = scalar(@$tests) - 1;
+        $extra_operator_tests += $extra_num;
+    }
+    return scalar(@$operators) + $extra_operator_tests;
+    
+}
+
+sub all_operators {
+    my ($self) = @_;
+    if (not $self->{all_operators}) {
+        
+        my @operators;
+        if (my $limit_operators = $self->option('operators')) {
+            @operators = split(',', $limit_operators);
+        }
+        else {
+            @operators = sort (keys %{ Bugzilla::Search::OPERATORS() });
+        }
+        # "substr" is just a backwards-compatibility operator, same as "substring".
+        @operators = grep { $_ ne 'substr' } @operators;
+        $self->{all_operators} = \@operators;
+    }
+    return @{ $self->{all_operators} };
+}
+
+sub all_fields {
+    my $self = shift;
+    if (not $self->{all_fields}) {
+        $self->_create_custom_fields();
+        my @fields = @{ Bugzilla->fields };
+        @fields = sort { $a->name cmp $b->name } @fields;
+        $self->{all_fields} = \@fields;
+    }
+    return @{ $self->{all_fields} };
+}
+
+sub top_level_operators {
+    my ($self) = @_;
+    if (!$self->{top_level_operators}) {
+        my @operators;
+        my $limit_top = $self->option('top-operators');
+        if ($limit_top) {
+            @operators = split(',', $limit_top);
+        }
+        else {
+            @operators = $self->all_operators;
+        }
+        $self->{top_level_operators} = \@operators;
+    }
+    return @{ $self->{top_level_operators} };
+}
+
+sub text_fields {
+    my ($self) = @_;
+    my @text_fields = grep { $_->type == FIELD_TYPE_TEXTAREA
+                             or $_->type == FIELD_TYPE_FREETEXT } $self->all_fields;
+    @text_fields = map { $_->name } @text_fields;
+    push(@text_fields, qw(short_desc status_whiteboard bug_file_loc see_also));
+    return @text_fields;
+}
+
+sub bugs {
+    my $self = shift;
+    $self->{bugs} ||= [map { $self->_create_one_bug($_) } (1..NUM_BUGS)];
+    return @{ $self->{bugs} };
+}
+
+# Get a numbered bug.
+sub bug {
+    my ($self, $number) = @_;
+    return ($self->bugs)[$number - 1];
+}
+
+sub admin {
+    my $self = shift;
+    if (!$self->{admin_user}) {
+        my $admin = create_user("admin");
+        Bugzilla::Install::make_admin($admin);
+        $self->{admin_user} = $admin;
+    }
+    # We send back a fresh object every time, to make sure that group
+    # memberships are always up-to-date.
+    return new Bugzilla::User($self->{admin_user}->id);
+}
+
+sub nobody {
+    my $self = shift;
+    $self->{nobody} ||= Bugzilla::Group->create({ name => "nobody-" . random(),
+        description => "Nobody", isbuggroup => 1 });
+    return $self->{nobody};
+}
+sub everybody {
+    my ($self) = @_;
+    $self->{everybody} ||= create_group('To The Limit');
+    return $self->{everybody};
+}
+
+sub bug_create_value {
+    my ($self, $number, $field) = @_;
+    $field = $field->name if blessed($field);
+    if ($number == 6 and $field ne 'alias') {
+        $number = 1;
+    }
+    my $extra_values = $self->_extra_bug_create_values->{$number};
+    if (exists $extra_values->{$field}) {
+        return $extra_values->{$field};
+    }
+    return $self->_bug_create_values->{$number}->{$field};
+}
+sub bug_update_value {
+    my ($self, $number, $field) = @_;
+    $field = $field->name if blessed($field);
+    if ($number == 6 and $field ne 'alias') {
+        $number = 1;
+    }
+    return $self->_bug_update_values->{$number}->{$field};
+}
+
+# Values used to create the bugs.
+sub _bug_create_values {
+    my $self = shift;
+    return $self->{bug_create_values} if $self->{bug_create_values};
+    my %values;
+    foreach my $number (1..NUM_BUGS) {
+        $values{$number} = $self->_create_field_values($number, 'for create');
+    }
+    $self->{bug_create_values} = \%values;
+    return $self->{bug_create_values};
+}
+# Values as they existed on the bug, at creation time. Used by the
+# changedfrom tests.
+sub _extra_bug_create_values {
+    my $self = shift;
+    $self->{extra_bug_create_values} ||= { map { $_ => {} } (1..NUM_BUGS) };
+    return $self->{extra_bug_create_values};
+}
+
+# Values used to update the bugs after they are created.
+sub _bug_update_values {
+    my $self = shift;
+    return $self->{bug_update_values} if $self->{bug_update_values};
+    my %values;
+    foreach my $number (1..NUM_BUGS) {
+        $values{$number} = $self->_create_field_values($number);
+    }
+    $self->{bug_update_values} = \%values;
+    return $self->{bug_update_values};
+}
+
+##############################
+# General Helper Subroutines #
+##############################
+
+sub random {
+    $_[0] ||= FIELD_SIZE;
+    generate_random_password(@_);
+}
+
+# We need to use a custom timestamp for each create() and update(),
+# because the database returns the same value for LOCALTIMESTAMP(0)
+# for the entire transaction, and we need each created bug to have
+# its own creation_ts and delta_ts.
+sub timestamp {
+    my ($day, $second) = @_;
+    return DateTime->new(
+        year   => 2037,
+        month  => 1,
+        day    => $day,
+        hour   => 12,
+        minute => $second,
+        second => 0,
+        # We make it floating because the timezone doesn't matter for our uses,
+        # and we want totally consistent behavior across all possible machines.
+        time_zone => 'floating',
+    );
+}
+
+sub create_keyword {
+    my ($number) = @_;
+    return Bugzilla::Keyword->create({
+        name => "$number-keyword-" . random(),
+        description => "Keyword $number" });
+}
+
+sub create_user {
+    my ($prefix) = @_;
+    my $user_name = $prefix . '-' . random(15) . "@" . random(12)
+                    . "." . random(3);
+    my $user_realname = $prefix . '-' . random();
+    my $user = Bugzilla::User->create({
+        login_name => $user_name,
+        realname   => $user_realname,
+        cryptpassword => '*',
+    });
+    return $user;
+}
+
+sub create_group {
+    my ($prefix) = @_;
+    return Bugzilla::Group->create({
+        name => "$prefix-group-" . random(), description => "Everybody $prefix",
+        userregexp => '.*', isbuggroup => 1 });
+}
+
+sub create_legal_value {
+    my ($field, $number) = @_;
+    my $type = Bugzilla::Field::Choice->type($field);
+    my $field_name = $field->name;
+    return $type->create({ value => "$number-$field_name-" . random(),
+                           is_open => 0 });
+}
+
+#########################
+# Custom Field Creation #
+#########################
+
+sub _create_custom_fields {
+    my ($self) = @_;
+    return if !$self->option('add-custom-fields');
+    
+    while (my ($type, $name) = each %{ CUSTOM_FIELDS() }) {
+        my $exists = new Bugzilla::Field({ name => $name });
+        next if $exists;
+        Bugzilla::Field->create({
+            name => $name,
+            type => $type,
+            description => "Search Test Field $name",
+            enter_bug => 1,
+            custom => 1,
+            buglist => 1,
+            is_mandatory => 0,
+        });
+    }
+}
+
+########################
+# Field Value Creation #
+########################
+
+sub _create_field_values {
+    my ($self, $number, $for_create) = @_;
+    my $dbh = Bugzilla->dbh;
+    
+    Bugzilla->set_user($self->admin);
+
+    my @selects = grep { $_->is_select } $self->all_fields;
+    my %values;
+    foreach my $field (@selects) {
+        next if $field->is_abnormal;
+        $values{$field->name} = create_legal_value($field, $number)->name;
+    }
+
+    my $group = create_group($number);
+    $values{groups} = [$group->name];
+
+    $values{'keywords'} = create_keyword($number)->name;
+
+    foreach my $field (qw(assigned_to qa_contact reporter cc)) {
+        $values{$field} = create_user("$number-$field")->login;
+    }
+
+    my $classification = Bugzilla::Classification->create(
+        { name => "$number-classification-" . random() });
+    $classification = $classification->name;
+
+    my $version = "$number-version-" . random();
+    my $milestone = "$number-tm-" . random(15);
+    my $product = Bugzilla::Product->create({
+        name => "$number-product-" . random(),
+        description => 'Created by t/search.t',
+        defaultmilestone => $milestone,
+        classification => $classification,
+        version => $version,
+        allows_unconfirmed => 1,
+    });
+    foreach my $item ($group, $self->nobody) {
+        $product->set_group_controls($item,
+            { membercontrol => CONTROLMAPSHOWN,
+              othercontrol => CONTROLMAPNA });
+    }
+    # $product->update() is called lower down.
+    my $component = Bugzilla::Component->create({
+        product => $product, name => "$number-component-" . random(),
+        initialowner => create_user("$number-defaultowner")->login,
+        initialqacontact => create_user("$number-defaultqa")->login,
+        initial_cc => [create_user("$number-initcc")->login],
+        description => "Component $number" });
+    
+    $values{'product'} = $product->name;
+    $values{'component'} = $component->name;
+    $values{'target_milestone'} = $milestone;
+    $values{'version'} = $version;
+
+    foreach my $field ($self->text_fields) {
+        # We don't add a - after $field for the text fields, because
+        # if we do, fulltext searching for short_desc pulls out
+        # "short_desc" as a word and matches it in every bug.
+        my $value = "$number-$field" . random();
+        if ($field eq 'bug_file_loc' or $field eq 'see_also') {
+            $value = "http://$value-" . random(3)
+                     . "/show_bug.cgi?id=$number";
+        }
+        $values{$field} = $value;
+    }
+    $values{'tag'} = ["$number-tag-" . random()];
+    
+    my @date_fields = grep { $_->type == FIELD_TYPE_DATETIME } $self->all_fields;
+    foreach my $field (@date_fields) {
+        # We use 03 as the month because that differs from our creation_ts,
+        # delta_ts, and deadline. (It's nice to have recognizable values
+        # for each field when debugging.)
+        my $second = $for_create ? $number : $number + 1;
+        $values{$field->name} = "2037-03-0$number 12:34:0$second";
+    }
+
+    $values{alias} = "$number-alias-" . random(12);
+
+    # Prefixing the original comment with "description" makes the
+    # lesserthan and greaterthan tests behave predictably.
+    my $comm_prefix = $for_create ? "description-" : '';
+    $values{comment} = "$comm_prefix$number-comment-" . random()
+                               . ' ' . random();
+
+    my @flags;
+    my $setter = create_user("$number-setters.login_name");
+    my $requestee = create_user("$number-requestees.login_name");
+    $values{set_flags} = _create_flags($number, $setter, $requestee);
+
+    my $month = $for_create ? "12" : "02";
+    $values{'deadline'} = "2037-$month-0$number";
+    my $estimate_times = $for_create ? 10 : 1;
+    $values{estimated_time} = $estimate_times * $number;
+
+    $values{attachment} = _get_attach_values($number, $for_create);
+
+    # Some things only happen on the first bug.
+    if ($number == 1) {
+        # We use 6 as the prefix for the extra values, because bug 6's values
+        # don't otherwise get used (since bug 6 is created as a clone of
+        # bug 1). This also makes sure that our greaterthan/lessthan
+        # tests work properly.
+        my $extra_group = create_group(6);
+        $product->set_group_controls($extra_group,
+            { membercontrol => CONTROLMAPSHOWN,
+              othercontrol => CONTROLMAPNA });
+        $values{groups} = [$values{groups}->[0], $extra_group->name];
+        my $extra_keyword = create_keyword(6);
+        $values{keywords} = [$values{keywords}, $extra_keyword->name];
+        my $extra_cc = create_user("6-cc");
+        $values{cc} = [$values{cc}, $extra_cc->login];
+        my @multi_selects = grep { $_->type == FIELD_TYPE_MULTI_SELECT }
+                                 $self->all_fields;
+        foreach my $field (@multi_selects) {
+            my $new_value = create_legal_value($field, 6);
+            my $name = $field->name;
+            $values{$name} = [$values{$name}, $new_value->name];
+        }
+        push(@{ $values{'tag'} }, "6-tag-" . random());
+    }
+
+    # On bug 5, any field that *can* be left empty, *is* left empty.
+    if ($number == 5) {
+        my @set_fields = grep { $_->type == FIELD_TYPE_SINGLE_SELECT }
+                         $self->all_fields;
+        @set_fields = map { $_->name } @set_fields;
+        push(@set_fields, qw(short_desc version reporter));
+        foreach my $key (keys %values) {
+            delete $values{$key} unless grep { $_ eq $key } @set_fields;
+        }
+    }
+
+    $product->update();
+
+    return \%values;
+}
+
+# Flags
+sub _create_flags {
+    my ($number, $setter, $requestee) = @_;
+
+    my $flagtypes = _create_flagtypes($number);
+
+    my %flags;
+    foreach my $type (qw(a b)) {
+        $flags{$type} = _get_flag_values(@_, $flagtypes->{$type});
+    }
+    return \%flags;
+}
+
+sub _create_flagtypes {
+    my ($number) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $name = "$number-flag-" . random();
+    my $desc = "FlagType $number";
+
+    my %flagtypes; 
+    foreach my $target (qw(a b)) {
+         $dbh->do("INSERT INTO flagtypes
+                  (name, description, target_type, is_requestable, 
+                   is_requesteeble, is_multiplicable, cc_list)
+                   VALUES (?,?,?,1,1,1,'')",
+                   undef, $name, $desc, $target);
+         my $id = $dbh->bz_last_key('flagtypes', 'id');
+         $dbh->do('INSERT INTO flaginclusions (type_id) VALUES (?)',
+                  undef, $id);
+         my $flagtype = new Bugzilla::FlagType($id);
+         $flagtypes{$target} = $flagtype;
+    }
+    return \%flagtypes;
+}
+
+sub _get_flag_values {
+    my ($number, $setter, $requestee, $flagtype) = @_;
+
+    my @set_flags;
+    if ($number <= 2) {
+        foreach my $value (qw(? - + ?)) {
+            my $flag = { type_id => $flagtype->id, status => $value,
+                         setter => $setter, flagtype => $flagtype };
+            push(@set_flags, $flag);
+        }
+        $set_flags[0]->{requestee} = $requestee->login;
+    }
+    else {
+        @set_flags = ({ type_id => $flagtype->id, status => '+',
+                        setter => $setter, flagtype => $flagtype });
+    }
+    return \@set_flags;
+}
+
+# Attachments
+sub _get_attach_values {
+    my ($number, $for_create) = @_;
+
+    my $boolean = $number == 1 ? 1 : 0;
+    if ($for_create) {
+        $boolean = !$boolean ? 1 : 0;
+    }
+    my $ispatch = $for_create ? 'ispatch' : 'is_patch';
+    my $isobsolete = $for_create ? 'isobsolete' : 'is_obsolete';
+    my $isprivate = $for_create ? 'isprivate' : 'is_private';
+    my $mimetype = $for_create ? 'mimetype' : 'content_type';
+
+    my %values = (
+        description => "$number-attach_desc-" . random(),
+        filename => "$number-filename-" . random(),
+        $ispatch => $boolean,
+        $isobsolete => $boolean,
+        $isprivate => $boolean,
+        $mimetype => "text/x-$number-" . random(),
+    );
+    if ($for_create) {
+        $values{data} = "$number-data-" . random() . random();
+    }
+    return \%values;
+}
+
+################
+# Bug Creation #
+################
+
+sub _create_one_bug {
+    my ($self, $number) = @_;
+    my $dbh = Bugzilla->dbh;
+    
+    # We need bug 6 to have a unique alias that is not a clone of bug 1's,
+    # so we get the alias separately from the other parameters.
+    my $alias = $self->bug_create_value($number, 'alias');
+    my $update_alias = $self->bug_update_value($number, 'alias');
+    
+    # Otherwise, make bug 6 a clone of bug 1.
+    my $real_number = $number;
+    $number = 1 if $number == 6;
+    
+    my $reporter = $self->bug_create_value($number, 'reporter');
+    Bugzilla->set_user(Bugzilla::User->check($reporter));
+    
+    # We create the bug with one set of values, and then we change it
+    # to have different values.
+    my %params = %{ $self->_bug_create_values->{$number} };
+    $params{alias} = $alias;
+    
+    # There are some things in bug_create_values that shouldn't go into
+    # create().
+    delete @params{qw(attachment set_flags tag)};
+    
+    my ($status, $resolution, $see_also) = 
+        delete @params{qw(bug_status resolution see_also)};
+    # All the bugs are created with everconfirmed = 0.
+    $params{bug_status} = 'UNCONFIRMED';
+    my $bug = Bugzilla::Bug->create(\%params);
+    
+    # These are necessary for the changedfrom tests.
+    my $extra_values = $self->_extra_bug_create_values->{$number};
+    foreach my $field (qw(comments remaining_time percentage_complete
+                         keyword_objects everconfirmed dependson blocked
+                         groups_in classification actual_time))
+    {
+        $extra_values->{$field} = $bug->$field;
+    }
+    $extra_values->{reporter_accessible} = $number == 1 ? 0 : 1;
+    $extra_values->{cclist_accessible}   = $number == 1 ? 0 : 1;
+    
+    if ($number == 5) {
+        # Bypass Bugzilla::Bug--we don't want any changes in bugs_activity
+        # for bug 5.
+        $dbh->do('UPDATE bugs SET qa_contact = NULL, reporter_accessible = 0,
+                                  cclist_accessible = 0 WHERE bug_id = ?',
+                 undef, $bug->id);
+        $dbh->do('DELETE FROM cc WHERE bug_id = ?', undef, $bug->id);
+        my $ts = '1970-01-01 00:00:00';
+        $dbh->do('UPDATE bugs SET creation_ts = ?, delta_ts = ?
+                   WHERE bug_id = ?', undef, $ts, $ts, $bug->id);
+        $dbh->do('UPDATE longdescs SET bug_when = ? WHERE bug_id = ?',
+                 undef, $ts, $bug->id);
+        $bug->{creation_ts} = $ts;
+        $extra_values->{see_also} = [];
+    }
+    else {
+        # Manually set the creation_ts so that each bug has a different one.
+        #
+        # Also, manually update the resolution and bug_status, because
+        # we want to see both of them change in bugs_activity, so we
+        # have to start with values for both (and as of the time when I'm
+        # writing this test, Bug->create doesn't support setting resolution).
+        #
+        # Same for see_also.
+        my $timestamp = timestamp($number, $number - 1);
+        my $creation_ts = $timestamp->ymd . ' ' . $timestamp->hms;
+        $bug->{creation_ts} = $creation_ts;
+        $dbh->do('UPDATE longdescs SET bug_when = ? WHERE bug_id = ?',
+                 undef, $creation_ts, $bug->id);
+        $dbh->do('UPDATE bugs SET creation_ts = ?, bug_status = ?,
+                  resolution = ? WHERE bug_id = ?',
+                 undef, $creation_ts, $status, $resolution, $bug->id);
+        $dbh->do('INSERT INTO bug_see_also (bug_id, value, class) VALUES (?,?,?)',
+                 undef, $bug->id, $see_also, 'Bugzilla::BugUrl::Bugzilla');
+        $extra_values->{see_also} = $bug->see_also;
+
+        # All the tags must be created as the admin user, so that the
+        # admin user can find them, later.
+        my $original_user = Bugzilla->user;
+        Bugzilla->set_user($self->admin);
+        my $tags = $self->bug_create_value($number, 'tag');
+        $bug->add_tag($_) foreach @$tags;
+        $extra_values->{tags} = $tags;
+        Bugzilla->set_user($original_user);
+
+        if ($number == 1) {
+            # Bug 1 needs to start off with reporter_accessible and
+            # cclist_accessible being 0, so that when we change them to 1,
+            # that change shows up in bugs_activity.
+            $dbh->do('UPDATE bugs SET reporter_accessible = 0,
+                      cclist_accessible = 0 WHERE bug_id = ?',
+                      undef, $bug->id);
+            # Bug 1 gets three comments, so that longdescs.count matches it
+            # uniquely. The third comment is added in the middle, so that the
+            # last comment contains all of the important data, like work_time.
+            $bug->add_comment("1-comment-" . random(100));
+        }
+        
+        my %update_params = %{ $self->_bug_update_values->{$number} };
+        my %reverse_map = reverse %{ Bugzilla::Bug->FIELD_MAP };
+        foreach my $db_name (keys %reverse_map) {
+            next if $db_name eq 'comment';
+            next if $db_name eq 'status_whiteboard';
+            if (exists $update_params{$db_name}) {
+                my $update_name = $reverse_map{$db_name};
+                $update_params{$update_name} = delete $update_params{$db_name};
+            }
+        }
+        
+        my ($new_status, $new_res) = 
+            delete @update_params{qw(status resolution)};
+        # Bypass the status workflow.
+        $bug->{bug_status} = $new_status;
+        $bug->{resolution} = $new_res;
+        $bug->{everconfirmed} = 1 if $number == 1;
+        
+        # add/remove/set fields.
+        $update_params{keywords} = { set => $update_params{keywords} };
+        $update_params{groups} = { add => $update_params{groups},
+                                   remove => $bug->groups_in };
+        my @cc_remove = map { $_->login } @{ $bug->cc_users };
+        my $cc_new = $update_params{cc};
+        my @cc_add = ref($cc_new) ? @$cc_new : ($cc_new);
+        # We make the admin an explicit CC on bug 1 (but not on bug 6), so
+        # that we can test the %user% pronoun properly.
+        if ($real_number == 1) {
+            push(@cc_add, $self->admin->login);
+        }
+        $update_params{cc} = { add => \@cc_add, remove => \@cc_remove };
+        my $see_also_remove = $bug->see_also;
+        my $see_also_add = [$update_params{see_also}];
+        $update_params{see_also} = { add => $see_also_add, 
+                                     remove => $see_also_remove };
+        $update_params{comment} = { body => $update_params{comment} };
+        $update_params{work_time} = $number;
+        # Setting work_time kills the remaining_time, so we need to
+        # preserve that. We add 8 because that produces an integer
+        # percentage_complete for bug 1, which is necessary for
+        # accurate "equals"-type searching.
+        $update_params{remaining_time} = $number + 8;
+        $update_params{reporter_accessible} = $number == 1 ? 1 : 0;
+        $update_params{cclist_accessible} = $number == 1 ? 1 : 0;
+        $update_params{alias} = $update_alias;
+
+        $bug->set_all(\%update_params);
+        my $flags = $self->bug_create_value($number, 'set_flags')->{b};
+        $bug->set_flags([], $flags);
+        $timestamp->set(second => $number);
+        $bug->update($timestamp->ymd . ' ' . $timestamp->hms);
+        $extra_values->{flags} = $bug->flags;
+        
+        # It's not generally safe to do update() multiple times on
+        # the same Bug object.
+        $bug = new Bugzilla::Bug($bug->id);
+        my $update_flags = $self->bug_update_value($number, 'set_flags')->{b};
+        $_->{status} = 'X' foreach @{ $bug->flags };
+        $bug->set_flags($bug->flags, $update_flags);
+        if ($number == 1) {
+            my $comment_id = $bug->comments->[-1]->id;
+            $bug->set_comment_is_private({ $comment_id => 1 });
+        }
+        $bug->update($bug->delta_ts);
+        
+        my $attach_create = $self->bug_create_value($number, 'attachment');
+        my $attachment = Bugzilla::Attachment->create({
+            bug => $bug,
+            creation_ts => $creation_ts,
+            %$attach_create });
+        # Store for the changedfrom tests.
+        $extra_values->{attachments} = 
+            [new Bugzilla::Attachment($attachment->id)];
+        
+        my $attach_update = $self->bug_update_value($number, 'attachment');
+        $attachment->set_all($attach_update);
+        # In order to keep the mimetype on the ispatch attachment,
+        # we need to bypass the validator.
+        $attachment->{mimetype} = $attach_update->{content_type};
+        my $attach_flags = $self->bug_update_value($number, 'set_flags')->{a};
+        $attachment->set_flags([], $attach_flags);
+        $attachment->update($bug->delta_ts);
+    }
+    
+    # Values for changedfrom.
+    $extra_values->{creation_ts} = $bug->creation_ts;
+    $extra_values->{delta_ts}    = $bug->creation_ts;
+    
+    return new Bugzilla::Bug($bug->id);
+}
+
+###################################
+# Test::Builder Memory Efficiency #
+###################################
+
+# Test::Builder stores information for each test run, but Test::Harness
+# and TAP::Harness don't actually need this information. When we run 60
+# million tests, the history eats up all our memory. (After about
+# 1 million tests, memory usage is around 1 GB.)
+#
+# The only part of the history that Test::More actually *uses* is the "ok"
+# field, which we store more efficiently, in an array, and then we re-populate
+# the Test_Results in Test::Builder at the end of the test.
+sub clean_test_history {
+    my ($self) = @_;
+    return if !$self->option('long');
+    my $builder = Test::More->builder;
+    my $current_test = $builder->current_test;
+
+    # I don't use details() because I don't want to copy the array.
+    my $results = $builder->{Test_Results};
+    my $check_test = $current_test - 1;
+    while (my $result = $results->[$check_test]) {
+        last if !$result;
+        $self->test_success($check_test, $result->{ok});
+        $check_test--;
+    }
+
+    # Truncate the test history array, but retain the current test number.
+    $builder->{Test_Results} = [];
+    $builder->{Curr_Test} = $current_test;
+}
+
+sub test_success {
+    my ($self, $index, $status) = @_;
+    $self->{test_success}->[$index] = $status;
+    return $self->{test_success};
+}
+
+sub repopulate_test_results {
+    my ($self) = @_;
+    return if !$self->option('long');
+    $self->clean_test_history();
+    # We create only two hashes, for memory efficiency.
+    my %ok = ( ok => 1 );
+    my %not_ok = ( ok => 0 );
+    my @results;
+    foreach my $success (@{ $self->{test_success} }) {
+        push(@results, $success ? \%ok : \%not_ok);
+    }
+    my $builder = Test::More->builder;
+    $builder->{Test_Results} = \@results;
+}
+
+##########
+# Caches #
+##########
+
+# When doing AND and OR tests, we essentially test the same field/operator
+# combinations over and over. So, if we're going to be running those tests,
+# we cache the translated_value of the FieldTests globally so that we don't
+# have to re-run the value-translation code every time (which can be pretty
+# slow).
+sub value_translation_cache {
+    my ($self, $field_test, $value) = @_;
+    return if !$self->option('long');
+    my $test_name = $field_test->name;
+    if (@_ == 3) {
+        $self->{value_translation_cache}->{$test_name} = $value;
+    }
+    return $self->{value_translation_cache}->{$test_name};
+}
+
+# When doing AND/OR tests, the value for transformed_value_was_equal
+# (see Bugzilla::Test::Search::FieldTest) won't be recalculated
+# if we pull our values from the value_translation_cache. So we need
+# to also cache the values for transformed_value_was_equal.
+sub was_equal_cache {
+    my ($self, $field_test, $number, $value) = @_;
+    return if !$self->option('long');
+    my $test_name = $field_test->name;
+    if (@_ == 4) {
+        $self->{tvwe_cache}->{$test_name}->{$number} = $value;
+    }
+    return $self->{tvwe_cache}->{$test_name}->{$number};
+}
+
+#############
+# Main Test #
+#############
+
+sub run {
+    my ($self) = @_;
+    my $dbh = Bugzilla->dbh;
+
+    # We want backtraces on any "die" message or any warning.
+    # Otherwise it's hard to trace errors inside of Bugzilla::Search from
+    # reading automated test run results.
+    local $SIG{__WARN__} = \&Carp::cluck;
+    local $SIG{__DIE__}  = \&Carp::confess;
+
+    $dbh->bz_start_transaction();
+    
+    # Some parameters need to be set in order for the tests to function
+    # properly.
+    my $everybody = $self->everybody;
+    my $params = Bugzilla->params;
+    local $params->{'useclassification'} = 1;
+    local $params->{'useqacontact'} = 1;
+    local $params->{'usetargetmilestone'} = 1;
+    local $params->{'mail_delivery_method'} = 'None';
+    local $params->{'timetrackinggroup'} = $everybody->name;
+    local $params->{'insidergroup'} = $everybody->name;
+
+    $self->_setup_bugs();
+    
+    # Even though _setup_bugs set us as an admin, we want to be sure at
+    # this point that we have an admin with refreshed group memberships.
+    Bugzilla->set_user($self->admin);
+    foreach my $test (CUSTOM_SEARCH_TESTS) {
+        my $custom_test = new Bugzilla::Test::Search::CustomTest($test, $self);
+        $custom_test->run();
+    }
+    foreach my $test (SPECIAL_PARAM_TESTS) {
+        my $operator_test =
+            new Bugzilla::Test::Search::OperatorTest($test->{operator}, $self);
+        my $field = Bugzilla::Field->check($test->{field});
+        my $special_test = new Bugzilla::Test::Search::FieldTestNormal(
+            $operator_test, $field, $test);
+        $special_test->run();
+    }
+    foreach my $operator ($self->top_level_operators) {
+        my $operator_test =
+            new Bugzilla::Test::Search::OperatorTest($operator, $self);
+        $operator_test->run();
+    }
+
+    # Rollbacks won't get rid of bugs_fulltext entries, so we do that ourselves.
+    my @bug_ids = map { $_->id } $self->bugs;
+    my $bug_id_string = join(',', @bug_ids);
+    $dbh->do("DELETE FROM bugs_fulltext WHERE bug_id IN ($bug_id_string)");
+    $dbh->bz_rollback_transaction();
+    $self->repopulate_test_results();
+}
+
+# This makes a few changes to the bugs after they're created--changes
+# that can only be done after all the bugs have been created.
+sub _setup_bugs {
+    my ($self) = @_;
+    $self->_setup_dependencies();
+    $self->_set_bug_id_fields();
+    $self->_protect_bug_6();
+}
+sub _setup_dependencies {
+    my ($self) = @_;
+    my $dbh = Bugzilla->dbh;
+    
+    # Set up depedency relationships between the bugs.
+    # Bug 1 + 6 depend on bug 2 and block bug 3.
+    my $bug2 = $self->bug(2);
+    my $bug3 = $self->bug(3);
+    foreach my $number (1,6) {
+        my $bug = $self->bug($number);
+        my @original_delta = ($bug2->delta_ts, $bug3->delta_ts);
+        Bugzilla->set_user($bug->reporter);
+        $bug->set_dependencies([$bug2->id], [$bug3->id]);
+        $bug->update($bug->delta_ts);
+        # Setting dependencies changed the delta_ts on bug2 and bug3, so
+        # re-set them back to what they were before. However, we leave
+        # the correct update times in bugs_activity, so that the changed*
+        # searches still work right.
+        my $set_delta = $dbh->prepare(
+            'UPDATE bugs SET delta_ts = ? WHERE bug_id = ?');
+        foreach my $row ([$original_delta[0], $bug2->id], 
+                         [$original_delta[1], $bug3->id])
+        {
+            $set_delta->execute(@$row);
+        }
+    }
+}
+
+sub _set_bug_id_fields {
+    my ($self) = @_;
+    # BUG_ID fields couldn't be set before, because before we create bug 1,
+    # we don't necessarily have any valid bug ids.)
+    my @bug_id_fields = grep { $_->type == FIELD_TYPE_BUG_ID }
+                             $self->all_fields;
+    foreach my $number (1..NUM_BUGS) {
+        my $bug = $self->bug($number);
+        $number = 1 if $number == 6;
+        next if $number == 5;
+        my $other_bug = $self->bug($number + 1);
+        Bugzilla->set_user($bug->reporter);
+        foreach my $field (@bug_id_fields) {
+            $bug->set_custom_field($field, $other_bug->id);
+            $bug->update($bug->delta_ts);
+        }
+    }
+}
+
+sub _protect_bug_6 {
+    my ($self) = @_;
+    my $dbh = Bugzilla->dbh;
+    
+    Bugzilla->set_user($self->admin);
+    
+    # Put bug6 in the nobody group.
+    my $nobody = $self->nobody;
+    # We pull it newly from the DB to be sure it's safe to call update()
+    # on.
+    my $bug6 = new Bugzilla::Bug($self->bug(6)->id);
+    $bug6->add_group($nobody);
+    $bug6->update($bug6->delta_ts);
+    
+    # Remove the admin (and everybody else) from the $nobody group.
+    $dbh->do('DELETE FROM group_group_map 
+               WHERE grantor_id = ? OR member_id = ?', undef,
+             $nobody->id, $nobody->id);
+}
+
+1;

diff --git a/xt/lib/Bugzilla/Test/Search/AndTest.pm b/xt/lib/Bugzilla/Test/Search/AndTest.pm
new file mode 100644 (file)
index 0000000..ac41712
--- /dev/null
+++ b/xt/lib/Bugzilla/Test/Search/AndTest.pm
@@ -0,0 +1,52 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# This test combines two field/operator combinations using AND in
+# a single boolean chart.
+package Bugzilla::Test::Search::AndTest;
+use base qw(Bugzilla::Test::Search::OrTest);
+
+use Bugzilla::Test::Search::Constants;
+use List::MoreUtils qw(all);
+
+use constant type => 'AND';
+
+#############
+# Accessors #
+#############
+
+# In an AND test, bugs ARE supposed to be contained only if they are contained
+# by ALL tests.
+sub bug_is_contained {
+    my ($self, $number) = @_;
+    return all { $_->bug_is_contained($number) } $self->field_tests;
+}
+
+sub _bug_will_actually_be_contained {
+    my ($self, $number) = @_;
+    return all { $_->will_actually_contain_bug($number) } $self->field_tests;
+}
+
+##############################
+# Bugzilla::Search arguments #
+##############################
+
+sub search_params {
+    my ($self) = @_;
+    my @all_params = map { $_->search_params } $self->field_tests;
+    my %params;
+    my $chart = 0;
+    foreach my $item (@all_params) {
+        $params{"field0-$chart-0"} = $item->{'field0-0-0'};
+        $params{"type0-$chart-0"}  = $item->{'type0-0-0'};
+        $params{"value0-$chart-0"} = $item->{'value0-0-0'};
+        $chart++;
+    }
+    return \%params;
+}
+
+1;

diff --git a/xt/lib/Bugzilla/Test/Search/Constants.pm b/xt/lib/Bugzilla/Test/Search/Constants.pm
new file mode 100644 (file)
index 0000000..9d62abb
--- /dev/null
+++ b/xt/lib/Bugzilla/Test/Search/Constants.pm
@@ -0,0 +1,1198 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+
+# These are constants used by Bugzilla::Test::Search.
+# See the comment at the top of that package for a general overview
+# of how the search test works, and how the constants are used.
+# More detailed information on each constant is available in the comments
+# in this file.
+package Bugzilla::Test::Search::Constants;
+use base qw(Exporter);
+use Bugzilla::Constants;
+use Bugzilla::Util qw(generate_random_password);
+
+our @EXPORT = qw(
+    ATTACHMENT_FIELDS
+    BROKEN_NOT
+    COLUMN_TRANSLATION
+    COMMENT_FIELDS
+    CUSTOM_FIELDS
+    CUSTOM_SEARCH_TESTS
+    FIELD_SIZE
+    FIELD_SUBSTR_SIZE
+    FLAG_FIELDS
+    INJECTION_BROKEN_FIELD
+    INJECTION_BROKEN_OPERATOR
+    INJECTION_TESTS
+    KNOWN_BROKEN
+    NUM_BUGS
+    NUM_SEARCH_TESTS
+    SKIP_FIELDS
+    SPECIAL_PARAM_TESTS
+    SUBSTR_NO_FIELD_ADD
+    SUBSTR_SIZE
+    TESTS
+    TESTS_PER_RUN
+    USER_FIELDS
+);
+
+# Bug 1 is designed to be found by all the "equals" tests. It has
+# multiple values for several fields where other fields only have
+# one value.
+#
+# Bug 2 and 3 have a dependency relationship with Bug 1,
+# but show up in "not equals" tests. We do use bug 2 in multiple-value
+# tests.
+#
+# Bug 4 should never show up in any equals test, and has no relationship
+# with any other bug. However, it does have all its fields set.
+#
+# Bug 5 only has values set for mandatory fields, to expose problems
+# that happen with "not equals" tests failing to catch bugs that don't
+# have a value set at all.
+#
+# Bug 6 is a clone of Bug 1, but is in a group that the searcher isn't
+# in.
+use constant NUM_BUGS => 6;
+
+# How many tests there are for each operator/field combination other
+# than the "contains" tests.
+use constant NUM_SEARCH_TESTS => 3;
+# This is how many tests get run for each field/operator.
+use constant TESTS_PER_RUN => NUM_SEARCH_TESTS + NUM_BUGS;
+
+# This is how many random characters we generate for most fields' names.
+# (Some fields can't be this long, though, so they have custom lengths
+# in Bugzilla::Test::Search).
+use constant FIELD_SIZE => 30;
+
+# These are the custom fields that are created if the BZ_MODIFY_DATABASE_TESTS
+# environment variable is set.
+use constant CUSTOM_FIELDS => {
+    FIELD_TYPE_FREETEXT,  'cf_freetext',
+    FIELD_TYPE_SINGLE_SELECT, 'cf_single_select',
+    FIELD_TYPE_MULTI_SELECT, 'cf_multi_select',
+    FIELD_TYPE_TEXTAREA, 'cf_textarea',
+    FIELD_TYPE_DATETIME, 'cf_datetime',
+    FIELD_TYPE_BUG_ID, 'cf_bugid',
+};
+
+# This translates fielddefs names into Search column names.
+use constant COLUMN_TRANSLATION => {
+    creation_ts => 'opendate',
+    delta_ts    => 'changeddate',
+    work_time => 'actual_time',
+};
+
+# Make comment field names to their Bugzilla::Comment accessor.
+use constant COMMENT_FIELDS => {
+    longdesc  => 'body',
+    commenter => 'author',
+    'longdescs.isprivate' => 'is_private',
+};
+
+# Same as above, for Bugzilla::Attachment.
+use constant ATTACHMENT_FIELDS => {
+    mimetype => 'contenttype',
+    submitter => 'attacher',
+    thedata   => 'data',
+};
+
+# Same, for Bugzilla::Flag.
+use constant FLAG_FIELDS => {
+    'flagtypes.name' => 'name',
+    'setters.login_name' => 'setter',
+    'requestees.login_name' => 'requestee',
+};
+
+# These are fields that we don't test. Test::More will mark these
+# "TODO & SKIP", and not run tests for them at all.
+#
+# We don't support days_elapsed or owner_idle_time yet.
+use constant SKIP_FIELDS => qw(
+    owner_idle_time
+    days_elapsed
+);
+
+# All the fields that represent users.
+use constant USER_FIELDS => qw(
+    assigned_to
+    cc
+    reporter
+    qa_contact
+    commenter
+    attachments.submitter
+    setters.login_name
+    requestees.login_name
+);
+
+# For the "substr"-type searches, how short of a substring should
+# we use? The goal is to be shorter than the full string, but
+# long enough to still be globally unique.
+use constant SUBSTR_SIZE => 20;
+# However, for some fields, we use a different size.
+use constant FIELD_SUBSTR_SIZE => {
+    alias => 11,
+    # Just the month and day.
+    deadline => -5,
+    creation_ts => -8,
+    delta_ts => -8,
+    percentage_complete => 1,
+    work_time => 3,
+    remaining_time => 3,
+    target_milestone => 15,
+    longdesc => 25,
+    # Just the hour and minute.
+    FIELD_TYPE_DATETIME, -5,
+};
+
+# For most fields, we add the length of the name of the field plus
+# the SUBSTR_SIZE specified above to determine how large of a substring
+# we're going to use. However, for some fields, it doesn't make sense to
+# add in their field name this way.
+use constant SUBSTR_NO_FIELD_ADD => FIELD_TYPE_DATETIME, qw(
+    target_milestone remaining_time percentage_complete work_time
+    attachments.mimetype attachments.submitter attachments.filename
+    attachments.description flagtypes.name
+);
+
+################
+# Known Broken #
+################
+
+# See the KNOWN_BROKEN constant for a general description of these
+# "_BROKEN" constants.
+
+# Shared between greaterthan and greaterthaneq.
+#
+# As with other fields, longdescs greaterthan matches if any comment
+# matches (which might be OK).
+#
+# Same for keywords, and cc. Logically, all of these might
+# be OK, but it makes the operation not the logical reverse of
+# lessthaneq. What we're really saying here by marking these broken
+# is that there ought to be some way of searching "all ccs" vs "any cc"
+# (and same for the other fields).
+use constant GREATERTHAN_BROKEN => (
+    cc        => { contains => [1] },
+);
+
+# allwords and allwordssubstr have these broken tests in common.
+use constant ALLWORDS_BROKEN => (
+    # allwordssubstr on cc fields matches against a single cc,
+    # instead of matching against all ccs on a bug.
+    cc        => { contains => [1] },
+    # bug 828344 changed how these searches operate to revert back to the 4.0
+    # behavour, so these tests need to be updated (bug 849117).
+    'flagtypes.name' => { contains => [1] },
+    longdesc         => { contains => [1] },
+);
+
+# Fields that don't generally work at all with changed* searches, but
+# probably should.
+use constant CHANGED_BROKEN => (
+    classification => { contains => [1] },
+    commenter => { contains => [1] },
+    percentage_complete     => { contains => [1] },
+    'requestees.login_name' => { contains => [1] },
+    'setters.login_name'    => { contains => [1] },
+    delta_ts                => { contains => [1] },
+);
+
+# These are additional broken tests that changedfrom and changedto
+# have in common.
+use constant CHANGED_VALUE_BROKEN => (
+    bug_group        => { contains => [1] },
+    cc               => { contains => [1] },
+    estimated_time   => { contains => [1] },
+    'flagtypes.name' => { contains => [1] },
+    keywords  => { contains => [1] },
+    'longdescs.count' => { search => 1 },
+    FIELD_TYPE_MULTI_SELECT, { contains => [1] },
+);
+
+
+# Any test listed in KNOWN_BROKEN gets marked TODO by Test::More
+# (using some complex code in Bugzilla::Test::Seach::FieldTest).
+# This means that if you run the test under "prove -v", these tests will
+# still show up as "not ok", but the test suite results won't show them
+# as a failure.
+#
+# This constant contains operators as keys, which point to hashes. The hashes
+# have field names as keys. Each field name points to a hash describing
+# how that field/operator combination is broken. The "contains"
+# array specifies that that particular "contains" test is expected
+# to fail. If "search" is set to 1, then we expect the creation of the
+# Bugzilla::Search object to fail.
+#
+# To allow handling custom fields, you can also use the field type as a key
+# instead of the field name. Specifying explicit field names always overrides
+# specifying a field type.
+#
+# Sometimes the operators have multiple tests, and one of them works
+# while the other fails. In this case, we have a special override for
+# "operator-value", which uniquely identifies tests.
+use constant KNOWN_BROKEN => {
+    greaterthan   => { GREATERTHAN_BROKEN },
+    greaterthaneq => { GREATERTHAN_BROKEN },
+
+    'allwordssubstr-<1>' => { ALLWORDS_BROKEN },
+    'allwords-<1>' => {
+        ALLWORDS_BROKEN,
+    },
+    'anywords-<1>' => {
+        'flagtypes.name' => { contains => [1,2,3,4,5] },
+    },
+    'anywords-<1> <2>' => {
+        'flagtypes.name' => { contains => [3,4,5] },
+    },
+    'anywordssubstr-<1> <2>' => {
+        'flagtypes.name' => { contains => [3,4,5] },
+    },
+
+    # setters.login_name and requestees.login name aren't tracked individually
+    # in bugs_activity, so can't be searched using this method.
+    #
+    # percentage_complete isn't tracked in bugs_activity (and it would be
+    # really hard to track). However, it adds a 0=0 term instead of using
+    # the changed* charts or simply denying them.
+    #
+    # delta_ts changedbefore/after should probably search for bugs based
+    # on their delta_ts.
+    #
+    # creation_ts changedbefore/after should search for bug creation dates.
+    #
+    # The commenter field changedbefore/after should search for comment
+    # creation dates.
+    #
+    # classification isn't being tracked properly in bugs_activity, I think.
+    #
+    # attach_data.thedata should search when attachments were created and
+    # who they were created by.
+    'changedbefore' => {
+        CHANGED_BROKEN,
+        'attach_data.thedata' => { contains => [1] },
+    },
+    'changedafter' => {
+        'attach_data.thedata' => { contains => [2,3,4] },
+        classification => { contains => [2,3,4] },
+        commenter   => { contains => [2,3,4] },
+        delta_ts    => { contains => [2,3,4] },
+        percentage_complete => { contains => [2,3,4] },
+        'requestees.login_name' => { contains => [2,3,4] },
+        'setters.login_name'    => { contains => [2,3,4] },
+    },
+    changedfrom => {
+        CHANGED_BROKEN,
+        CHANGED_VALUE_BROKEN,
+        # All fields should have a way to search for "changing
+        # from a blank value" probably.
+        blocked   => { contains => [3,4,5], no_criteria => 1 },
+        dependson => { contains => [2,4,5], no_criteria => 1 },
+        work_time => { contains => [1] },
+        FIELD_TYPE_BUG_ID, { contains => [5], no_criteria => 1 },
+    },
+    # changeto doesn't find remaining_time changes (possibly due to us not
+    # tracking that data properly).
+    #
+    # multi-valued fields are stored as comma-separated strings, so you
+    # can't do changedfrom/to on them.
+    #
+    # Perhaps commenter can either tell you who the last commenter was,
+    # or if somebody commented at a given time (combined with other
+    # charts).
+    #
+    # longdesc changedto/from doesn't do anything; maybe it should.
+    # Same for attach_data.thedata.
+    changedto => {
+        CHANGED_BROKEN,
+        CHANGED_VALUE_BROKEN,
+        'attach_data.thedata' => { contains => [1] },
+        longdesc         => { contains => [1] },
+        remaining_time   => { contains => [1] },
+    },
+    changedby => {
+        CHANGED_BROKEN,
+        # This should probably search the attacher or anybody who changed
+        # anything about an attachment at all.
+        'attach_data.thedata' => { contains => [1] },
+        # This should probably search the reporter.
+        creation_ts => { contains => [1] },
+    },
+    notequals => {
+        'flagtypes.name' => { contains => [1, 5] },
+        longdesc         => { contains => [1] },
+    },
+    notregexp => {
+        'flagtypes.name' => { contains => [1, 5] },
+        longdesc         => { contains => [1] },
+    },
+    notsubstring => {
+        'flagtypes.name' => { contains => [5] },
+        longdesc         => { contains => [1] },
+    },
+    nowords => {
+        'flagtypes.name' => { contains => [1, 5] },
+    },
+    nowordssubstr => {
+        'flagtypes.name' => { contains => [5] },
+    },
+};
+
+###################
+# Broken NotTests #
+###################
+
+# Common BROKEN_NOT values for the changed* fields.
+use constant CHANGED_BROKEN_NOT => (
+    "attach_data.thedata"   => { contains => [1] },
+    "classification"        => { contains => [1] },
+    "commenter"             => { contains => [1] },
+    "delta_ts"              => { contains => [1] },
+    percentage_complete     => { contains => [1] },
+    "requestees.login_name" => { contains => [1] },
+    "setters.login_name"    => { contains => [1] },
+);
+
+# For changedfrom and changedto.
+use constant CHANGED_FROM_TO_BROKEN_NOT => (
+    'longdescs.count' => { search => 1 },
+    "bug_group" => { contains => [1] },
+    "cc" => { contains => [1] },
+    "estimated_time" => { contains => [1] },
+    "flagtypes.name" => { contains => [1] },
+    "keywords" => { contains => [1] },    
+    FIELD_TYPE_MULTI_SELECT, { contains => [1] },
+);
+
+# These are field/operator combinations that are broken when run under NOT().
+use constant BROKEN_NOT => {
+    allwords => {
+        cc               => { contains => [1] },
+        'flagtypes.name' => { contains => [1, 5] },
+        longdesc         => { contains => [1] },
+    },
+    'allwords-<1> <2>' => {
+        cc => { },
+    },
+    allwordssubstr => {
+        cc               => { contains => [1] },
+        'flagtypes.name' => { contains => [5, 6] },
+        longdesc         => { contains => [1] },
+    },
+    'allwordssubstr-<1>,<2>' => {
+        cc               => { },
+        longdesc         => { contains => [1] },
+    },
+    anyexact => {
+        'flagtypes.name' => { contains => [1, 2, 5] },
+    },
+    'anywords-<1>' => {
+        'flagtypes.name' => { contains => [1, 2, 3, 4, 5] },
+    },
+    'anywords-<1> <2>' => {
+        'flagtypes.name' => { contains => [3, 4, 5] },
+    },
+    anywordssubstr => {
+        'flagtypes.name' => { contains => [5] },
+    },
+    'anywordssubstr-<1> <2>' => {
+        'flagtypes.name' => { contains => [3,4,5] },
+    },
+    casesubstring => {
+        'flagtypes.name' => { contains => [5] },
+    },
+    changedafter => {
+        "attach_data.thedata"   => { contains => [2, 3, 4] },
+        "classification"        => { contains => [2, 3, 4] },
+        "commenter"             => { contains => [2, 3, 4] },
+        percentage_complete     => { contains => [2, 3, 4] },
+        "delta_ts"              => { contains => [2, 3, 4] },
+        "requestees.login_name" => { contains => [2, 3, 4] },
+        "setters.login_name"    => { contains => [2, 3, 4] },
+    },
+    changedbefore => {
+        CHANGED_BROKEN_NOT,
+    },
+    changedby => {
+        CHANGED_BROKEN_NOT,
+        creation_ts => { contains => [1] },
+        work_time   => { contains => [1] },
+    },
+    changedfrom => {
+        CHANGED_BROKEN_NOT,
+        CHANGED_FROM_TO_BROKEN_NOT,
+        'attach_data.thedata' => { },
+        blocked         => { contains => [1, 2] },
+        dependson       => { contains => [1, 3] },
+        work_time       => { contains => [1] },
+        FIELD_TYPE_BUG_ID, { contains => [1 .. 4] },
+    },
+    changedto => {
+        CHANGED_BROKEN_NOT,
+        CHANGED_FROM_TO_BROKEN_NOT,
+        longdesc => { contains => [1] },
+        "remaining_time" => { contains => [1] },
+    },
+    greaterthan => {
+        cc               => { contains => [1] },
+        'flagtypes.name' => { contains => [5] },
+    },
+    greaterthaneq => {
+        cc               => { contains => [1] },
+        'flagtypes.name' => { contains => [2, 5] },
+    },
+    equals => {
+        'flagtypes.name' => { contains => [1, 5] },
+    },
+    notequals => {
+        longdesc         => { contains => [1] },
+    },
+    notregexp => {
+        longdesc         => { contains => [1] },
+    },
+    notsubstring => {
+        longdesc         => { contains => [1] },
+    },
+    'nowords-<1>' => {
+        'flagtypes.name' => { contains => [5] },
+    },
+    'nowordssubstr-<1>' => {
+        'flagtypes.name' => { contains => [5] },
+    },
+    lessthan => {
+        'flagtypes.name' => { contains => [5] },
+    },
+    lessthaneq => {
+        'flagtypes.name' => { contains => [1, 5] },
+    },
+    regexp => {
+        'flagtypes.name' => { contains => [1, 5] },
+        longdesc         => { contains => [1] },
+    },
+    substring => {
+        'flagtypes.name' => { contains => [5] },
+        longdesc         => { contains => [1] },
+    },
+};
+
+#############
+# Overrides #
+#############
+
+# These overrides are used in the TESTS constant, below.
+
+# Regex tests need unique test values for certain fields.
+use constant REGEX_OVERRIDE => {
+    'attachments.mimetype'  => { value => '^text/x-1-' },
+    bug_file_loc => { value => '^http://1-' },
+    see_also  => { value => '^http://1-' },
+    blocked   => { value => '^<1>$' },
+    dependson => { value => '^<1>$' },
+    bug_id    => { value => '^<1>$' },
+    'attachments.isobsolete' => { value => '^1'},
+    'attachments.ispatch'    => { value => '^1'},
+    'attachments.isprivate'  => { value => '^1' },
+    cclist_accessible        => { value => '^1' },
+    reporter_accessible      => { value => '^1' },
+    everconfirmed            => { value => '^1' },
+    'longdescs.count'        => { value => '^3' },
+    'longdescs.isprivate'    => { value => '^1' },
+    creation_ts => { value => '^2037-01-01' },
+    delta_ts    => { value => '^2037-01-01' },
+    deadline    => { value => '^2037-02-01' },
+    estimated_time => { value => '^1.0' },
+    remaining_time => { value => '^9.0' },
+    work_time      => { value => '^1.0' },
+    longdesc       => { value => '^1-' },
+    percentage_complete => { value => '^10' },
+    FIELD_TYPE_BUG_ID, { value => '^<1>$' },
+    FIELD_TYPE_DATETIME, { value => '^2037-03-01' }
+};
+
+# Common overrides between lessthan and lessthaneq.
+use constant LESSTHAN_OVERRIDE => (
+    alias             => { contains => [1,5] },
+    estimated_time    => { contains => [1,5] },
+    qa_contact        => { contains => [1,5] },
+    resolution        => { contains => [1,5] },
+    status_whiteboard => { contains => [1,5] },
+    FIELD_TYPE_TEXTAREA, { contains => [1,5] },
+    FIELD_TYPE_FREETEXT, { contains => [1,5] },
+);
+
+# The mandatorily-set fields have values higher than <1>,
+# so bug 5 shows up.
+use constant GREATERTHAN_OVERRIDE => (
+    classification => { contains => [2,3,4,5] },
+    assigned_to  => { contains => [2,3,4,5] },
+    bug_id       => { contains => [2,3,4,5] },
+    bug_group    => { contains => [1,2,3,4] },
+    bug_severity => { contains => [2,3,4,5] },
+    bug_status   => { contains => [2,3,4,5] },
+    component    => { contains => [2,3,4,5] },
+    commenter    => { contains => [2,3,4,5] },
+    # keywords matches if *any* keyword matches
+    keywords     => { contains => [1,2,3,4] },
+    longdesc     => { contains => [1,2,3,4] },
+    op_sys       => { contains => [2,3,4,5] },
+    priority     => { contains => [2,3,4,5] },
+    product      => { contains => [2,3,4,5] },
+    reporter     => { contains => [2,3,4,5] },
+    rep_platform => { contains => [2,3,4,5] },
+    short_desc   => { contains => [2,3,4,5] },
+    version      => { contains => [2,3,4,5] },
+    tag          => { contains => [1,2,3,4] },
+    target_milestone => { contains => [2,3,4,5] },
+    # Bug 2 is the only bug besides 1 that has a Requestee set.
+    'requestees.login_name'  => { contains => [2] },
+    FIELD_TYPE_SINGLE_SELECT, { contains => [2,3,4,5] },
+    # Override SINGLE_SELECT for resolution.
+    resolution => { contains => [2,3,4] },
+    # MULTI_SELECTs match if *any* value matches
+    FIELD_TYPE_MULTI_SELECT, { contains => [1,2,3,4] },
+);
+
+# For all positive multi-value types.
+use constant MULTI_BOOLEAN_OVERRIDE => (
+    'attachments.ispatch'    => { value => '1,1', contains => [1] },
+    'attachments.isobsolete' => { value => '1,1', contains => [1] },
+    'attachments.isprivate'  => { value => '1,1', contains => [1] },
+    cclist_accessible        => { value => '1,1', contains => [1] },
+    reporter_accessible      => { value => '1,1', contains => [1] },
+    'longdescs.isprivate'    => { value => '1,1', contains => [1] },
+    everconfirmed            => { value => '1,1', contains => [1] },
+);
+
+# Same as above, for negative multi-value types.
+use constant NEGATIVE_MULTI_BOOLEAN_OVERRIDE => (
+    'attachments.ispatch'    => { value => '1,1', contains => [2,3,4,5] },
+    'attachments.isobsolete' => { value => '1,1', contains => [2,3,4,5] },
+    'attachments.isprivate'  => { value => '1,1', contains => [2,3,4,5] },
+    cclist_accessible        => { value => '1,1', contains => [2,3,4,5] },
+    reporter_accessible      => { value => '1,1', contains => [2,3,4,5] },
+    'longdescs.isprivate'    => { value => '1,1', contains => [2,3,4,5] },
+    everconfirmed            => { value => '1,1', contains => [2,3,4,5] },
+);
+
+# For anyexact and anywordssubstr
+use constant ANY_OVERRIDE => (
+    'longdescs.count' => { contains => [1,2,3,4] },
+    'work_time' => { value => '1.0,2.0' },
+    dependson => { value => '<1>,<3>', contains => [1,3] },
+    MULTI_BOOLEAN_OVERRIDE,
+);
+
+# For all the changed* searches. The ones that have empty contains
+# are fields that never change in value, or will never be rationally
+# tracked in bugs_activity.
+use constant CHANGED_OVERRIDE => (
+    'attachments.submitter' => { contains => [] },
+    bug_id    => { contains => [] },
+    reporter  => { contains => [] },
+    tag       => { contains => [] },
+);
+
+#########
+# Tests #
+#########
+
+# The basic format of this is a hashref, where the keys are operators,
+# and each operator has an arrayref of tests that it runs. The tests
+# are hashrefs, with the following possible keys:
+#
+# contains: This is a list of bug numbers that the search is expected
+#           to contain. (This is bug numbers, like 1,2,3, not the bug
+#           ids. For a description of each bug number, see NUM_BUGS.)
+#           Any bug not listed in "contains" must *not* show up in the
+#           search result.
+# value: The value that you're searching for. There are certain special
+#        codes that will be replaced with bug values when the tests are
+#        run. In these examples below, "#" indicates a bug number:
+#
+#        <#> - The field value for this bug.
+#
+#              For any operator that has the string "word" in it, this is
+#              *all* the values for the current field from the numbered bug,
+#              joined by a space.
+#
+#              If the operator has the string "substr" in it, then we
+#              take a substring of the value (for single-value searches)
+#              or we take a substring of each value and join them (for
+#              multi-value "word" searches). The length of the substring
+#              is determined by the SUBSTR_SIZE constants above.)
+#
+#              For other operators, this just becomes the first value from
+#              the field for the numbered bug.
+#
+#              So, if we were running the "equals" test and checking the
+#              cc field, <1> would become the login name of the first cc on
+#              Bug 1. If we did an "anywords" search test, it would become
+#              a space-separated string of the login names of all the ccs
+#              on Bug 1. If we did an "anywordssubstr" search test, it would
+#              become a space-separated string of the first few characters
+#              of each CC's login name on Bug 1.
+#              
+#        <#-id> - The bug id of the numbered bug.
+#        <#-reporter> - The login name of the numbered bug's reporter.
+#        <#-delta> - The delta_ts of the numbered bug.
+#
+# escape: If true, we will call quotemeta() on the value immediately
+#         before passing it to Search.pm.
+#
+# transform: A function to call on any field value before inserting
+#            it for a <#> replacement. The transformation function
+#            gets all of the bug's values for the field as its arguments.
+# if_equal: This allows you to override "contains" for the case where
+#           the transformed value (from calling the "transform" function)
+#           is equal to the original value.
+#
+# override: This allows you to override "contains" and "values" for
+#           certain fields.
+use constant TESTS => {
+    equals => [
+        { contains => [1], value => '<1>' },
+    ],
+    notequals => [
+        { contains => [2,3,4,5], value => '<1>' },
+    ],
+    substring => [
+        { contains => [1], value => '<1>',
+          override => {
+              percentage_complete => { contains => [1,2,3] },
+          }
+        },
+    ],
+    casesubstring => [
+        { contains => [1], value => '<1>',
+          override => {
+              percentage_complete => { contains => [1,2,3] },
+          }
+        },
+        { contains => [], value => '<1>', transform => sub { lc($_[0]) },
+          extra_name => 'lc', if_equal => { contains => [1] },
+          override => {
+              percentage_complete => { contains => [1,2,3] },
+          }
+        },
+    ],
+    notsubstring => [
+        { contains => [2,3,4,5], value => '<1>',
+          override => {
+              percentage_complete => { contains => [4,5] },
+          },
+        }
+    ],
+    regexp => [
+        { contains => [1], value => '<1>', escape => 1,
+          override => {
+              percentage_complete => { value => '^10' },
+          }
+        },
+        { contains => [1], value => '^1-', override => REGEX_OVERRIDE },
+    ],
+    notregexp => [
+        { contains => [2,3,4,5], value => '<1>', escape => 1,
+          override => {
+              percentage_complete => { value => '^10' },
+          }
+        },
+        { contains => [2,3,4,5], value => '^1-', override => REGEX_OVERRIDE },
+    ],
+    lessthan => [
+        { contains => [1], value => 2, 
+          override => {
+              # A lot of these contain bug 5 because an empty value is validly
+              # less than the specified value.
+              bug_file_loc => { value => 'http://2-', contains => [1,5] },
+              see_also     => { value => 'http://2-' },
+              'attachments.mimetype' => { value => 'text/x-2-' },
+              blocked   => { value => '<4-id>', contains => [1,2] },
+              dependson => { value => '<3-id>', contains => [1,3] },
+              bug_id    => { value => '<2-id>' },
+              'attachments.isprivate'  => { value => 1, contains => [2,3,4] },
+              'attachments.isobsolete' => { value => 1, contains => [2,3,4] },
+              'attachments.ispatch'    => { value => 1, contains => [2,3,4] },
+              cclist_accessible        => { value => 1, contains => [2,3,4,5] },
+              reporter_accessible      => { value => 1, contains => [2,3,4,5] },
+              'longdescs.count'        => { value => 3, contains => [2,3,4,5] },
+              'longdescs.isprivate'    => { value => 1, contains => [1,2,3,4,5] },
+              everconfirmed            => { value => 1, contains => [2,3,4,5] },
+              creation_ts => { value => '2037-01-02', contains => [1,5] },
+              delta_ts    => { value => '2037-01-02', contains => [1,5] },
+              deadline    => { value => '2037-02-02', contains => [1,5] },
+              remaining_time => { value => 10, contains => [1,5] },
+              percentage_complete => { value => 11, contains => [1,5] },
+              longdesc => { value => '2-', contains => [1,5] },
+              work_time => { value => 1, contains => [5] },
+              FIELD_TYPE_BUG_ID, { value => '<2>', contains => [1,5] },
+              FIELD_TYPE_DATETIME, { value => '2037-03-02', contains => [1,5] },
+              LESSTHAN_OVERRIDE,
+          }
+        },
+    ],
+    lessthaneq => [
+        { contains => [1], value => '<1>',
+          override => {
+              'attachments.isobsolete' => { value => 0, contains => [2,3,4] },
+              'attachments.ispatch'    => { value => 0, contains => [2,3,4] },
+              'attachments.isprivate'  => { value => 0, contains => [2,3,4] },
+              cclist_accessible        => { value => 0, contains => [2,3,4,5] },
+              reporter_accessible      => { value => 0, contains => [2,3,4,5] },
+              'longdescs.count'        => { value => 2, contains => [2,3,4,5] },
+              'longdescs.isprivate'    => { value => -1, contains => [] },
+              everconfirmed            => { value => 0, contains => [2,3,4,5] },
+              bug_file_loc   => { contains => [1,5] },
+              blocked        => { contains => [1,2] },
+              deadline       => { contains => [1,5] },
+              dependson      => { contains => [1,3] },
+              creation_ts    => { contains => [1,5] },
+              delta_ts       => { contains => [1,5] },
+              remaining_time => { contains => [1,5] },
+              longdesc       => { contains => [1,5] },
+              percentage_complete => { contains => [1,5] },
+              work_time => { value => 1, contains => [1,5] },
+              FIELD_TYPE_BUG_ID, { contains => [1,5] },
+              FIELD_TYPE_DATETIME, { contains => [1,5] },
+              LESSTHAN_OVERRIDE,
+          },
+        },
+    ],
+    greaterthan => [
+        { contains => [2,3,4], value => '<1>',
+          override => {
+              dependson => { contains => [3] },
+              blocked   => { contains => [2] },
+              'attachments.ispatch'    => { value => 0, contains => [1] },
+              'attachments.isobsolete' => { value => 0, contains => [1] },
+              'attachments.isprivate'  => { value => 0, contains => [1] },
+              cclist_accessible        => { value => 0, contains => [1] },
+              reporter_accessible      => { value => 0, contains => [1] },
+              'longdescs.count'        => { value => 2, contains => [1] },
+              'longdescs.isprivate'    => { value => 0, contains => [1] },
+              everconfirmed            => { value => 0, contains => [1] },
+              'flagtypes.name'         => { value => 2, contains => [2,3,4] },
+              GREATERTHAN_OVERRIDE,
+          },
+        },
+    ],
+    greaterthaneq => [
+        { contains => [2,3,4], value => '<2>',
+          override => {
+              'attachments.ispatch'    => { value => 1, contains => [1] },
+              'attachments.isobsolete' => { value => 1, contains => [1] },
+              'attachments.isprivate'  => { value => 1, contains => [1] },
+              cclist_accessible        => { value => 1, contains => [1] },
+              reporter_accessible      => { value => 1, contains => [1] },
+              'longdescs.count'        => { value => 3, contains => [1] },
+              'longdescs.isprivate'    => { value => 1, contains => [1] },
+              everconfirmed            => { value => 1, contains => [1] },
+              dependson => { value => '<3>', contains => [1,3] },
+              blocked   => { contains => [1,2] },
+              GREATERTHAN_OVERRIDE,
+          }
+        },
+    ],
+    matches => [
+        { contains => [1], value => '<1>' },
+    ],
+    notmatches => [
+        { contains => [2,3,4,5], value => '<1>' },
+    ],
+    anyexact => [
+        { contains => [1,2], value => '<1>, <2>', 
+          override => { ANY_OVERRIDE } },
+    ],
+    anywordssubstr => [
+        { contains => [1,2], value => '<1> <2>', 
+          override => {
+              ANY_OVERRIDE,
+              percentage_complete => { contains => [1,2,3] },
+          }
+        },
+    ],
+    allwordssubstr => [
+        { contains => [1], value => '<1>',
+          override => {
+              MULTI_BOOLEAN_OVERRIDE,
+              # We search just the number "1" for percentage_complete,
+              # which matches a lot of bugs.
+              percentage_complete => { contains => [1,2,3] },
+          },
+        },
+        { contains => [], value => '<1>,<2>',
+          override => {
+              dependson => { value => '<1-id> <3-id>', contains => [] },
+              # bug 3 has the value "21" here, so matches "2,1"
+              percentage_complete => { value => '<2>,<3>', contains => [3] },
+              # 1 0 matches bug 1, which has both public and private comments.
+             'longdescs.isprivate' => { contains => [1] },              
+          }
+        },
+    ],
+    nowordssubstr => [
+        { contains => [2,3,4,5], value => '<1>',
+          override => {
+              # longdescs.isprivate translates to "1 0", so no bugs should
+              # show up.
+              'longdescs.isprivate' => { contains => [] },
+              percentage_complete => { contains => [4,5] },
+              work_time => { contains => [2,3,4,5] },
+          }
+        },
+    ],
+    anywords => [
+        { contains => [1], value => '<1>',
+          override => {
+              MULTI_BOOLEAN_OVERRIDE,
+          }
+        },
+        { contains => [1,2], value => '<1> <2>',
+          override => {
+              MULTI_BOOLEAN_OVERRIDE,
+              dependson => { value => '<1> <3>', contains => [1,3] },
+              'longdescs.count' => { contains => [1,2,3,4] },              
+          },
+        },
+    ],
+    allwords => [
+        { contains => [1], value => '<1>',
+          override => { MULTI_BOOLEAN_OVERRIDE } },
+        { contains => [], value => '<1> <2>',
+          override => {
+            dependson => { contains => [], value => '<2-id> <3-id>' },
+            # 1 0 matches bug 1, which has both public and private comments.
+            'longdescs.isprivate' => { contains => [1] },
+          }
+        },
+    ],
+    nowords => [
+        { contains => [2,3,4,5], value => '<1>',
+          override => {
+              # longdescs.isprivate translates to "1 0", so no bugs should
+              # show up.
+              'longdescs.isprivate' => { contains => [] },
+              work_time => { contains => [2,3,4,5] },
+          }
+        },
+    ],
+
+    changedbefore => [
+        { contains => [1], value => '<1-delta>',
+          override => {
+              CHANGED_OVERRIDE,
+              creation_ts => { contains => [1,5] },
+              blocked   => { contains => [1,2] },
+              dependson => { contains => [1,3] },
+              longdesc => { contains => [1,5] },
+              'longdescs.count' => { contains => [1,5] },
+          }
+        },
+    ],
+    changedafter => [
+        { contains => [2,3,4], value => '<2-delta>',
+          override => { 
+              CHANGED_OVERRIDE,
+              creation_ts => { contains => [3,4] },
+              # We only change this for one bug, and it doesn't match.
+              'longdescs.isprivate' => { contains => [] },
+              # Same for everconfirmed.
+              'everconfirmed' => { contains => [] },
+              # For blocked and dependson, they have the delta_ts of bug1
+              # in the bugs_activity table, so they won't ever match.
+              blocked   => { contains => [] },
+              dependson => { contains => [] },
+          }
+        },
+    ],
+    changedfrom => [
+        { contains => [1], value => '<1>',
+          override => {
+              CHANGED_OVERRIDE,
+              # The test never changes an already-set dependency field, but
+              # we *can* attempt to test searching against an empty value,
+              # which should get us some bugs.
+              blocked   => { value => '', contains => [1,2] },
+              dependson => { value => '', contains => [1,3] },
+              FIELD_TYPE_BUG_ID, { value => '', contains => [1,2,3,4] },
+              # longdesc changedfrom doesn't make any sense.
+              longdesc => { contains => [] },
+              # Nor does creation_ts changedfrom.
+              creation_ts => { contains => [] },
+              'attach_data.thedata' => { contains => [] },
+              bug_id => { value => '<1-id>', contains => [] },
+          },
+        },
+    ],
+    changedto => [
+        { contains => [1], value => '<1>',
+          override => {
+              CHANGED_OVERRIDE,
+              # I can't imagine any use for creation_ts changedto.
+              creation_ts => { contains => [] },
+          }
+        },
+    ],
+    changedby => [
+        { contains => [1], value => '<1-reporter>',
+          override => {
+              CHANGED_OVERRIDE,
+              blocked   => { contains => [1,2] },
+              dependson => { contains => [1,3] },
+          },
+        },
+    ],
+};
+
+# Fields that do not behave as we expect, for InjectionTest.
+# search => 1 means the Bugzilla::Search creation fails.
+# sql_error is a regex that specifies a SQL error that's OK for us to throw.
+# operator_ok overrides the "brokenness" of certain operators, so that they
+# are always OK for that field/operator combination.
+use constant INJECTION_BROKEN_FIELD => {
+    # Pg can't run injection tests against integer or date fields. See bug 577557.
+    'attachments.isobsolete' => { db_skip => ['Pg'] },
+    'attachments.ispatch'    => { db_skip => ['Pg'] },
+    'attachments.isprivate'  => { db_skip => ['Pg'] },
+    blocked                  => { db_skip => ['Pg'] },
+    bug_id                   => { db_skip => ['Pg'] },
+    cclist_accessible        => { db_skip => ['Pg'] },
+    creation_ts              => { db_skip => ['Pg'] },
+    days_elapsed             => { db_skip => ['Pg'] },
+    dependson                => { db_skip => ['Pg'] },
+    deadline                 => { db_skip => ['Pg'] },
+    delta_ts                 => { db_skip => ['Pg'] },
+    estimated_time           => { db_skip => ['Pg'] },
+    everconfirmed            => { db_skip => ['Pg'] },
+    'longdescs.isprivate'    => { db_skip => ['Pg'] },
+    percentage_complete      => { db_skip => ['Pg'] },
+    remaining_time           => { db_skip => ['Pg'] },
+    reporter_accessible      => { db_skip => ['Pg'] },
+    work_time                => { db_skip => ['Pg'] },
+    FIELD_TYPE_BUG_ID,          { db_skip => ['Pg'] },
+    FIELD_TYPE_DATETIME,        { db_skip => ['Pg'] },
+    owner_idle_time => { search => 1 },
+    'longdescs.count' => {
+        search => 1,
+        db_skip => ['Pg'],
+        operator_ok => [qw(allwords allwordssubstr anywordssubstr casesubstring
+                           changedbefore changedafter greaterthan greaterthaneq
+                           lessthan lessthaneq notregexp notsubstring
+                           nowordssubstr regexp substring anywords
+                           notequals nowords equals anyexact)],
+    },
+};
+
+# Operators that do not behave as we expect, for InjectionTest.
+# search => 1 means the Bugzilla::Search creation fails, but
+# field_ok contains fields that it does actually succeed for.
+use constant INJECTION_BROKEN_OPERATOR => {
+    changedafter  => { search => 1, field_ok => ['creation_ts'] },
+    changedbefore => { search => 1, field_ok => ['creation_ts'] },
+    changedby     => { search => 1 },
+};
+
+# Tests run by Bugzilla::Test::Search::InjectionTest.
+# We have to make sure the values are all one word or they'll be split
+# up by the multi-word tests.
+use constant INJECTION_TESTS => (
+    { value => ';SEMICOLON_TEST' },
+    { value => '--COMMENT_TEST'  },
+    { value => "'QUOTE_TEST" },
+    { value => "';QUOTE_SEMICOLON_TEST" },
+    { value => '/*STAR_COMMENT_TEST' }
+);
+
+#################
+# Special Tests #
+#################
+
+use constant SPECIAL_PARAM_TESTS => (
+    { field => 'bug_status', operator => 'anyexact', value => '__open__',
+      contains => [5] },
+    { field => 'bug_status', operator => 'anyexact', value => '__closed__',
+      contains => [1,2,3,4] },
+    { field => 'bug_status', operator => 'anyexact', value => '__all__',
+      contains => [1,2,3,4,5] },
+    
+    { field => 'resolution', operator => 'anyexact', value => '---',
+      contains => [5] },
+    
+    # email* query parameters.
+    { field => 'assigned_to', operator => 'anyexact',
+      value => '<1>, <2-reporter>', contains => [1,2],
+      extra_params => { emailreporter1 => 1 } },
+    { field => 'assigned_to', operator => 'equals',
+      value => '<1>', extra_name => 'email2', contains => [],
+      extra_params => {
+          email2 => generate_random_password(100), emaillongdesc2 => 1,
+      },
+    },
+    
+    # standard pronouns
+    { field => 'assigned_to', operator => 'equals', value => '%assignee%',
+      contains => [1,2,3,4,5] },
+    { field => 'reporter', operator => 'equals', value => '%reporter%',
+      contains => [1,2,3,4,5] },
+    { field => 'qa_contact', operator => 'equals', value => '%qacontact%',
+      contains => [1,2,3,4,5] },
+    { field => 'cc', operator => 'equals', value => '%user%',
+      contains => [1] },
+    # group pronouns
+    { field => 'reporter', operator => 'equals',
+      value => '%group.<1-bug_group>%', contains => [1,2,3,4,5] },
+    { field => 'assigned_to', operator => 'equals',
+      value => '%group.<1-bug_group>%', contains => [1,2,3,4,5] },
+    { field => 'qa_contact', operator => 'equals',
+      value => '%group.<1-bug_group>%', contains => [1,2,3,4] },
+    { field => 'cc', operator => 'equals',
+      value => '%group.<1-bug_group>%', contains => [1,2,3,4] },
+    { field => 'commenter', operator => 'equals',
+      value => '%group.<1-bug_group>%', contains => [1,2,3,4,5] },
+);
+
+use constant CUSTOM_SEARCH_TESTS => (
+    { name => 'OP without CP', contains => [1],
+      params => [
+          { f => 'OP' },
+          { f => 'bug_id', o => 'equals', v => '<1>' },
+      ]
+    },
+
+    { name => 'Empty OP/CP pair before criteria', contains => [1],
+      params => [
+          { f => 'OP' }, { f => 'CP' },
+          { f => 'bug_id', o => 'equals', v => '<1>' },
+      ]
+    },
+
+    { name => 'Empty OP/CP pair after criteria', contains => [1],
+      params => [
+          { f => 'bug_id', o => 'equals', v => '<1>' },
+          { f => 'OP' }, { f => 'CP' },
+      ]
+    },
+
+    { name  => 'empty OP/CP mid criteria', contains => [1],
+      columns => ['assigned_to'],
+      params => [
+          { f => 'bug_id', o => 'equals', v => '<1>' },
+          { f => 'OP' }, { f => 'CP' },
+          { f => 'assigned_to', o => 'substr', v => '@' },
+      ]
+    },
+
+    { name  => 'bug_id = 1 AND assigned_to contains @', contains => [1],
+      columns => ['assigned_to'],
+      params => [
+          { f => 'bug_id',      o => 'equals', v => '<1>' },
+          { f => 'assigned_to', o => 'substr', v => '@' },
+      ]
+    },
+
+    { name  => 'NOT(bug_id = 1) AND NOT(assigned_to = 2)',
+      contains => [3,4,5],
+      columns => ['assigned_to'],
+      params => [
+          { n => 1, f => 'bug_id',      o => 'equals', v => '<1>' },
+          { n => 1, f => 'assigned_to', o => 'equals', v => '<2>' },
+      ]
+    },
+
+    { name  => 'bug_id = 1 OR assigned_to = 2', contains => [1,2],
+      columns => ['assigned_to'], top_params => { j_top => 'OR' },
+      params => [
+          { f => 'bug_id',      o => 'equals', v => '<1>' },
+          { f => 'assigned_to', o => 'equals', v => '<2>' },
+      ]
+    },
+
+    { name => 'NOT(bug_id = 1 AND assigned_to = 1)', contains => [2,3,4,5],
+      columns => ['assigned_to'],
+      params => [
+          { f => 'OP', n => 1 },
+            { f => 'bug_id',      o => 'equals', v => '<1>' },
+            { f => 'assigned_to', o => 'equals', v => '<1>' },
+          { f => 'CP' },
+      ]
+    },
+
+
+    { name  => '(bug_id = 1 AND assigned_to contains @) '
+               . ' OR (bug_id = 2 AND assigned_to contains @)',
+      contains => [1,2], columns => ['assigned_to'],
+      top_params => { j_top => 'OR' },
+      params => [
+          { f => 'OP' },
+            { f => 'bug_id',      o => 'equals', v => '<1>' },
+            { f => 'assigned_to', o => 'substr', v => '@' },
+          { f => 'CP' },
+          { f => 'OP' },
+            { f => 'bug_id',      o => 'equals', v => '<2>' },
+            { f => 'assigned_to', o => 'substr', v => '@' },
+          { f => 'CP' },
+      ]
+    },
+
+    { name  => '(bug_id = 1 OR assigned_to = 2) '
+               . ' AND (bug_id = 2 OR assigned_to = 1)',
+      contains => [1,2], columns => ['assigned_to'],
+      params => [
+          { f => 'OP', j => 'OR' },
+            { f => 'bug_id',      o => 'equals', v => '<1>' },
+            { f => 'assigned_to', o => 'equals', v => '<2>' },
+          { f => 'CP' },
+          { f => 'OP', j => 'OR' },
+            { f => 'bug_id',      o => 'equals', v => '<2>' },
+            { f => 'assigned_to', o => 'equals', v => '<1>' },
+          { f => 'CP' },
+      ]
+    },
+
+    { name  => 'bug_id = 3 OR ( (bug_id = 1 OR assigned_to = 2) '
+               . ' AND (bug_id = 2 OR assigned_to = 1) )',
+      contains => [1,2,3], columns => ['assigned_to'],
+      top_params => { j_top => 'OR' },
+      params => [
+          { f => 'bug_id', o => 'equals', v => '<3>' },
+          { f => 'OP' },
+            { f => 'OP', j => 'OR' },
+              { f => 'bug_id',      o => 'equals', v => '<1>' },
+              { f => 'assigned_to', o => 'equals', v => '<2>' },
+            { f => 'CP' },
+            { f => 'OP', j => 'OR' },
+              { f => 'bug_id',      o => 'equals', v => '<2>' },
+              { f => 'assigned_to', o => 'equals', v => '<1>' },
+            { f => 'CP' },
+          { f => 'CP' },
+      ]
+    },
+
+    { name  => 'bug_id = 3 OR ( (bug_id = 1 OR assigned_to = 2) '
+               . ' AND (bug_id = 2 OR assigned_to = 1) ) OR bug_id = 4',
+      contains => [1,2,3,4], columns => ['assigned_to'],
+      top_params => { j_top => 'OR' },
+      params => [
+          { f => 'bug_id', o => 'equals', v => '<3>' },
+          { f => 'OP' },
+            { f => 'OP', j => 'OR' },
+              { f => 'bug_id',      o => 'equals', v => '<1>' },
+              { f => 'assigned_to', o => 'equals', v => '<2>' },
+            { f => 'CP' },
+            { f => 'OP', j => 'OR' },
+              { f => 'bug_id',      o => 'equals', v => '<2>' },
+              { f => 'assigned_to', o => 'equals', v => '<1>' },
+            { f => 'CP' },
+          { f => 'CP' },
+          { f => 'bug_id', o => 'equals', v => '<4>' },
+      ]
+    },
+
+);
+
+1;

diff --git a/xt/lib/Bugzilla/Test/Search/CustomTest.pm b/xt/lib/Bugzilla/Test/Search/CustomTest.pm
new file mode 100644 (file)
index 0000000..15e302c
--- /dev/null
+++ b/xt/lib/Bugzilla/Test/Search/CustomTest.pm
@@ -0,0 +1,101 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# This module represents a test with custom URL parameters.
+# Tests like this are specified in CUSTOM_SEARCH_TESTS in
+# Bugzilla::Test::Search::Constants.
+package Bugzilla::Test::Search::CustomTest;
+use base qw(Bugzilla::Test::Search::FieldTest);
+use strict;
+use warnings;
+
+use Bugzilla::Test::Search::FieldTest;
+use Bugzilla::Test::Search::OperatorTest;
+
+use Storable qw(dclone);
+
+###############
+# Constructor #
+###############
+
+sub new {
+  my ($class, $test, $search_test) = @_;
+  bless { raw_test => dclone($test), search_test => $search_test }, $class;
+}
+
+#############
+# Accessors #
+#############
+
+sub search_test { return $_[0]->{search_test} }
+sub name { return 'Custom: ' . $_[0]->test->{name} }
+sub test { return $_[0]->{raw_test} }
+
+sub operator_test { die "unimplemented" }
+sub field_object { die "unimplemented" }
+sub main_value { die "unimplenmented" }
+sub test_value { die "unimplemented" }
+# Custom tests don't use transforms.
+sub transformed_value_was_equal { 0 }
+sub debug_value {
+    my ($self) = @_;
+    my $string = '';
+    my $params = $self->search_params;
+    foreach my $param (keys %$params) {
+        $string .= $param . "=" . $params->{$param} . '&';
+    }
+    chop($string);
+    return $string;
+}
+
+# The tests we know are broken for this operator/field combination.
+sub _known_broken { return {} }
+sub contains_known_broken { return undef }
+sub search_known_broken { return undef }
+sub field_not_yet_implemented { return undef }
+sub invalid_field_operator_combination { return undef }
+
+#########################################
+# Accessors: Bugzilla::Search Arguments #
+#########################################
+
+# Converts the f, o, v rows into f0, o0, v0, etc. and translates
+# the values appropriately.
+sub search_params {
+    my ($self) = @_;
+
+    my %params = %{ $self->test->{top_params} || {} };
+    my $counter = 0;
+    foreach my $row (@{ $self->test->{params} }) {
+        $row->{v} = $self->translate_value($row) if exists $row->{v};
+        foreach my $key (keys %$row) {
+            $params{"${key}$counter"} = $row->{$key};
+        }
+        $counter++;
+    }
+
+    return \%params;
+}
+
+sub translate_value {
+    my ($self, $row) = @_;
+    my $as_test = { field => $row->{f}, operator => $row->{o},
+                    value => $row->{v} };
+    my $operator_test = new Bugzilla::Test::Search::OperatorTest($row->{o},
+        $self->search_test);
+    my $field = Bugzilla::Field->check($row->{f});
+    my $field_test = new Bugzilla::Test::Search::FieldTest($operator_test,
+      $field, $as_test);
+    return $field_test->translated_value;
+}
+
+sub search_columns {
+    my ($self) = @_;
+    return ['bug_id', @{ $self->test->{columns} || [] }];
+}
+
+1;

diff --git a/xt/lib/Bugzilla/Test/Search/FieldTest.pm b/xt/lib/Bugzilla/Test/Search/FieldTest.pm
new file mode 100644 (file)
index 0000000..5e86d92
--- /dev/null
+++ b/xt/lib/Bugzilla/Test/Search/FieldTest.pm
@@ -0,0 +1,617 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# This module represents the tests that get run on a single
+# operator/field combination for Bugzilla::Test::Search.
+# This is where all the actual testing happens.
+package Bugzilla::Test::Search::FieldTest;
+
+use strict;
+use warnings;
+use Bugzilla::Search;
+use Bugzilla::Test::Search::Constants;
+use Bugzilla::Util qw(trim);
+
+use Data::Dumper;
+use Scalar::Util qw(blessed);
+use Test::More;
+use Test::Exception;
+
+###############
+# Constructor #
+###############
+
+sub new {
+    my ($class, $operator_test, $field, $test) = @_;
+    return bless { operator_test => $operator_test,
+                   field_object => $field,
+                   raw_test     => $test }, $class;
+}
+
+#############
+# Accessors #
+#############
+
+sub num_tests { return TESTS_PER_RUN }
+
+# The Bugzilla::Test::Search::OperatorTest that this is a child of.
+sub operator_test { return $_[0]->{operator_test} }
+# The Bugzilla::Field being tested.
+sub field_object { return $_[0]->{field_object} }
+# The name of the field being tested, which we need much more often
+# than we need the object.
+sub field {
+    my ($self) = @_;
+    $self->{field_name} ||= $self->field_object->name;
+    return $self->{field_name};
+}
+# The Bugzilla::Test::Search object that this is a child of.
+sub search_test { return $_[0]->operator_test->search_test }
+# The operator being tested
+sub operator { return $_[0]->operator_test->operator }
+# The bugs currently being tested by Bugzilla::Test::Search.
+sub bugs { return $_[0]->search_test->bugs }
+sub bug {
+    my $self = shift;
+    return $self->search_test->bug(@_);
+}
+sub number {
+    my ($self, $id) = @_;
+    foreach my $number (1..NUM_BUGS) {
+        return $number if $self->search_test->bug($number)->id == $id;
+    }
+    return 0;
+}
+
+# The name displayed for this test by Test::More. Used in test descriptions.
+sub name {
+    my ($self) = @_;
+    my $field = $self->field;
+    my $operator = $self->operator;
+    my $value = $self->main_value;
+    
+    my $name = "$field-$operator-$value";
+    if (my $extra_name = $self->test->{extra_name}) {
+        $name .= "-$extra_name";
+    }
+    return $name;
+}
+
+# The appropriate value from the TESTS constant for this test, taking
+# into account overrides.
+sub test {
+    my $self = shift;
+    return $self->{test} if $self->{test};
+    
+    my %test = %{ $self->{raw_test} };
+    
+    # We have field name overrides...
+    my $override = $test{override}->{$self->field};
+    # And also field type overrides.
+    if (!$override) {
+        $override = $test{override}->{$self->field_object->type} || {};
+    }
+    
+    foreach my $key (%$override) {
+        $test{$key} = $override->{$key};
+    }
+    
+    $self->{test} = \%test;
+    return $self->{test};
+}
+
+# All the values for all the bugs for this field.
+sub _field_values {
+    my ($self) = @_;
+    return $self->{field_values} if $self->{field_values};
+    
+    my %field_values;
+    foreach my $number (1..NUM_BUGS) {
+        $field_values{$number} = $self->_field_values_for_bug($number);
+    }
+    $self->{field_values} = \%field_values;
+    return $self->{field_values};
+}
+# The values for this field for the numbered bug.
+sub bug_values {
+    my ($self, $number) = @_;
+    return @{ $self->_field_values->{$number} };
+}
+
+# The untranslated, non-overriden value--used in the name of the test
+# and other places.
+sub main_value { return $_[0]->{raw_test}->{value} }
+# The untranslated test value, taking into account overrides.
+sub test_value { return $_[0]->test->{value} };
+# The value translated appropriately for passing to Bugzilla::Search.
+sub translated_value {
+    my $self = shift;
+    if (!exists $self->{translated_value}) {
+        my $value = $self->search_test->value_translation_cache($self);
+        if (!defined $value) {
+            $value = $self->_translate_value();
+            $self->search_test->value_translation_cache($self, $value);
+        }
+        $self->{translated_value} = $value;
+    }
+    return $self->{translated_value};
+}
+# Used in failure diagnostic messages.
+sub debug_fail {
+    my ($self, $number, $results, $sql) = @_;
+    my @expected = @{ $self->test->{contains} };
+    my @results = sort
+                  map { $self->number($_) }
+                  map { $_->[0] }
+                  @$results;
+    return
+        "   Value: '" . $self->translated_value . "'\n" .
+        "Expected: [" . join(',', @expected) . "]\n" .
+        " Results: [" . join(',', @results) . "]\n" .
+        trim($sql) . "\n";
+}
+
+# True for a bug if we ran the "transform" function on it and the
+# result was equal to its first value.
+sub transformed_value_was_equal {
+    my ($self, $number, $value) = @_;
+    if (@_ > 2) {
+        $self->{transformed_value_was_equal}->{$number} = $value;
+        $self->search_test->was_equal_cache($self, $number, $value);
+    }
+    my $cached = $self->search_test->was_equal_cache($self, $number);
+    return $cached if defined $cached;
+    return $self->{transformed_value_was_equal}->{$number};
+}
+
+# True if this test is supposed to contain the numbered bug.
+sub bug_is_contained {
+    my ($self, $number) = @_;
+    my $contains = $self->test->{contains};
+    if ($self->transformed_value_was_equal($number)
+        and !$self->test->{override}->{$self->field}->{contains})
+    {
+        $contains = $self->test->{if_equal}->{contains};
+    }
+    return grep($_ == $number, @$contains) ? 1 : 0;
+}
+
+###################################################
+# Accessors: Ways of doing SKIP and TODO on tests #
+###################################################
+
+# The tests we know are broken for this operator/field combination.
+sub _known_broken {
+    my ($self, $constant, $skip_pg_check) = @_;
+
+    $constant ||= KNOWN_BROKEN;
+    my $field = $self->field;
+    my $type = $self->field_object->type;
+    my $operator = $self->operator;
+    my $value = $self->main_value;
+    my $value_name = "$operator-$value";
+    if (my $extra_name = $self->test->{extra_name}) {
+        $value_name .= "-$extra_name";
+    }
+
+    my $value_broken = $constant->{$value_name}->{$field};
+    $value_broken ||= $constant->{$value_name}->{$type};
+    return $value_broken if $value_broken;
+    my $operator_broken = $constant->{$operator}->{$field};
+    $operator_broken ||= $constant->{$operator}->{$type};
+    return $operator_broken if $operator_broken;
+    return {};
+}
+
+# True if the "contains" search for the numbered bug is broken.
+# That is, either the result is supposed to contain it and doesn't,
+# or the result is not supposed to contain it and does.
+sub contains_known_broken {
+    my ($self, $number) = @_;
+    my $field = $self->field;
+    my $operator = $self->operator;
+
+    my $contains_broken = $self->_known_broken->{contains} || [];
+    if (grep($_ == $number, @$contains_broken)) {
+        return "$field $operator contains $number is known to be broken";
+    }
+    return undef;
+}
+
+# Used by subclasses. Checks both bug_is_contained and contains_known_broken
+# to tell you whether or not the bug will *actually* be found by the test.
+sub will_actually_contain_bug {
+    my ($self, $number) = @_;
+    my $is_contained = $self->bug_is_contained($number) ? 1 : 0;
+    my $is_broken = $self->contains_known_broken($number) ? 1 : 0;
+
+    # If the test is supposed to contain the bug and *isn't* broken,
+    # then the test will contain the bug.
+    return 1 if ($is_contained and !$is_broken);
+    # If this test is *not* supposed to contain the bug, but that test is
+    # broken, then this test *will* contain the bug.
+    return 1 if (!$is_contained and $is_broken);
+
+    return 0;
+}
+
+# Returns a string if creating a Bugzilla::Search object throws an error,
+# with this field/operator/value combination.
+sub search_known_broken {
+    my ($self) = @_;
+    my $field = $self->field;
+    my $operator = $self->operator;
+    if ($self->_known_broken->{search}) {
+        return "Bugzilla::Search for $field $operator is known to be broken";
+    }
+    return undef;
+}
+    
+# Returns a string if we haven't yet implemented the tests for this field,
+# but we plan to in the future.
+sub field_not_yet_implemented {
+    my ($self) = @_;
+    my $skip_this_field = grep { $_ eq $self->field } SKIP_FIELDS;
+    if ($skip_this_field) {
+        my $field = $self->field;
+        return "$field testing not yet implemented";
+    }
+    return undef;
+}
+
+# Returns a message if this field/operator combination can't ever be run.
+# At no time in the future will this field/operator combination ever work.
+sub invalid_field_operator_combination {
+    my ($self) = @_;
+    my $field = $self->field;
+    my $operator = $self->operator;
+    
+    if ($field eq 'content' && $operator !~ /matches/) {
+        return "content field does not support $operator";
+    }
+    elsif ($operator =~ /matches/ && $field ne 'content') {
+        return "matches operator does not support fields other than content";
+    }
+    return undef;
+}
+
+# True if this field is broken in an OR combination.
+sub join_broken {
+    my ($self, $or_broken_map) = @_;
+    my $or_broken = $or_broken_map->{$self->field . '-' . $self->operator};
+    if (!$or_broken) {
+        # See if this is a comment field, and in that case, if there's
+        # a generic entry for all comment fields.
+        my $is_comment_field = COMMENT_FIELDS->{$self->field};
+        if ($is_comment_field) {
+            $or_broken = $or_broken_map->{'longdescs.-' . $self->operator};
+        }
+    }
+    return $or_broken;
+}
+
+#########################################
+# Accessors: Bugzilla::Search Arguments #
+#########################################
+
+# The data that will get passed to Bugzilla::Search as its arguments.
+sub search_params {
+    my ($self) = @_;
+    return $self->{search_params} if $self->{search_params};
+
+    my %params = (
+        "field0-0-0" => $self->field,
+        "type0-0-0"  => $self->operator,
+        "value0-0-0"  => $self->translated_value,
+    );
+    
+    $self->{search_params} = \%params;
+    return $self->{search_params};
+}
+
+sub search_columns {
+    my ($self) = @_;
+    my $field = $self->field;
+    my @search_fields = qw(bug_id);
+    if ($self->field_object->buglist) {
+        my $col_name = COLUMN_TRANSLATION->{$field} || $field;
+        push(@search_fields, $col_name);
+    }
+    return \@search_fields;
+}
+
+
+################
+# Field Values #
+################
+
+sub _field_values_for_bug {
+    my ($self, $number) = @_;
+    my $field = $self->field;
+
+    my @values;
+
+    if ($field =~ /^attach.+\.(.+)$/ ) {
+        my $attach_field = $1;
+        $attach_field = ATTACHMENT_FIELDS->{$attach_field} || $attach_field;
+        @values = $self->_values_for($number, 'attachments', $attach_field);
+    }
+    elsif (my $flag_field = FLAG_FIELDS->{$field}) {
+        @values = $self->_values_for($number, 'flags', $flag_field);
+    }
+    elsif (my $translation = COMMENT_FIELDS->{$field}) {
+        @values = $self->_values_for($number, 'comments', $translation);
+        # We want the last value to come first, so that single-value
+        # searches use the last comment.
+        @values = reverse @values;
+    }
+    elsif ($field eq 'longdescs.count') {
+        @values = scalar(@{ $self->bug($number)->comments });
+    }
+    elsif ($field eq 'work_time') {
+        @values = $self->_values_for($number, 'actual_time');
+    }
+    elsif ($field eq 'bug_group') {
+        @values = $self->_values_for($number, 'groups_in', 'name');
+    }
+    elsif ($field eq 'keywords') {
+        @values = $self->_values_for($number, 'keyword_objects', 'name'); 
+    }
+    elsif ($field eq 'content') {
+        @values = $self->_values_for($number, 'short_desc');
+    }
+    elsif ($field eq 'see_also') {
+        @values = $self->_values_for($number, 'see_also', 'name');
+    }
+    elsif ($field eq 'tag') {
+        @values = $self->_values_for($number, 'tags');
+    }
+    # Bugzilla::Bug truncates creation_ts, but we need the full value
+    # from the database. This has no special value for changedfrom,
+    # because it never changes.
+    elsif ($field eq 'creation_ts') {
+        my $bug = $self->bug($number);
+        my $creation_ts = Bugzilla->dbh->selectrow_array(
+            'SELECT creation_ts FROM bugs WHERE bug_id = ?',
+            undef, $bug->id);
+        @values = ($creation_ts);
+    }
+    else {
+        @values = $self->_values_for($number, $field);
+    }
+
+    # We convert user objects to their login name, here, all in one
+    # block for simplicity.
+    if (grep { $_ eq $field } USER_FIELDS) {
+        # requestees.login_name is empty for most bugs (but checking
+        # blessed(undef) handles that.
+        # Values that come from %original_values aren't User objects.
+        @values = map { blessed($_) ? $_->login : $_ } @values;
+        @values = grep { defined $_ } @values;
+    }
+    
+    return \@values;
+}
+
+sub _values_for {
+    my ($self, $number, $bug_field, $item_field) = @_;
+
+    my $item;
+    if ($self->operator eq 'changedfrom') {
+        $item = $self->search_test->bug_create_value($number, $bug_field);
+    }
+    else {
+        my $bug = $self->bug($number);
+        $item = $bug->$bug_field;
+    }
+
+    if ($item_field) {
+        if ($bug_field eq 'flags' and $item_field eq 'name') {
+            return (map { $_->name . $_->status } @$item);
+        }
+        return (map { $self->_get_item($_, $item_field) } @$item);
+    }
+
+    return @$item if ref($item) eq 'ARRAY';
+    return $item if defined $item;
+    return ();
+}
+
+sub _get_item {
+    my ($self, $from, $field) = @_;
+    if (blessed($from)) {
+        return $from->$field;
+    }
+    return $from->{$field};
+}
+
+#####################
+# Value Translation #
+#####################
+
+# This function translates the "value" specified in TESTS into an actual
+# search value to pass to Search.pm. This means that we get the value
+# from the current bug (or, in the case of changedfrom, from %original_values)
+# and then we insert it as required into the "value" from TESTS. (For example,
+# <1> becomes the value for the field from bug 1.)
+sub _translate_value {
+    my $self = shift;
+    my $value = $self->test_value;
+    foreach my $number (1..NUM_BUGS) {
+        $value = $self->_translate_value_for_bug($number, $value);
+    }
+    # Sanity check to make sure that none of the <> stuff was left in.
+    if ($value =~ /<\d/) {
+        die $self->name . ": value untranslated: $value\n";
+    }
+    return $value;
+}
+
+sub _translate_value_for_bug {
+    my ($self, $number, $value) = @_;
+    
+    my $bug = $self->bug($number);
+    
+    my $bug_id = $bug->id;
+    $value =~ s/<$number-id>/$bug_id/g;
+    my $bug_delta = $bug->delta_ts;
+    $value =~ s/<$number-delta>/$bug_delta/g;
+    my $reporter = $bug->reporter->login;
+    $value =~ s/<$number-reporter>/$reporter/g;
+    if ($value =~ /<$number-bug_group>/) {
+        my @bug_groups = map { $_->name } @{ $bug->groups_in };
+        @bug_groups = grep { $_ =~ /^\d+-group-/ } @bug_groups;
+        my $group = $bug_groups[0];
+        $value =~ s/<$number-bug_group>/$group/g;
+    }
+    
+    my @bug_values = $self->bug_values($number);    
+    return $value if !@bug_values;
+    
+    if ($self->operator =~ /substr/) {
+        @bug_values = map { $self->_substr_value($_) } @bug_values;
+    }
+
+    my $string_value = $bug_values[0];
+    if ($self->operator =~ /word/) {
+        $string_value = join(' ', @bug_values);
+    }
+    if (my $func = $self->test->{transform}) {
+        my $transformed = $func->(@bug_values);
+        my $is_equal = $transformed eq $bug_values[0] ? 1 : 0;
+        $self->transformed_value_was_equal($number, $is_equal);
+        $string_value = $transformed;
+    }
+
+    if ($self->test->{escape}) {
+        $string_value = quotemeta($string_value);
+    }
+    $value =~ s/<$number>/$string_value/g;
+    
+    return $value;
+}
+
+sub _substr_value {
+    my ($self, $value) = @_;
+    my $field = $self->field;
+    my $type  = $self->field_object->type;
+    my $substr_size = SUBSTR_SIZE;
+    if (exists FIELD_SUBSTR_SIZE->{$field}) {
+        $substr_size = FIELD_SUBSTR_SIZE->{$field};
+    }
+    elsif (exists FIELD_SUBSTR_SIZE->{$type}) {
+        $substr_size = FIELD_SUBSTR_SIZE->{$type};
+    }
+    if ($substr_size > 0) {
+        # The field name is included in every field value, and if it's
+        # long, it might take up the whole substring, and we don't want that.
+        if (!grep { $_ eq $field or $_ eq $type } SUBSTR_NO_FIELD_ADD) {
+            $substr_size += length($field);
+        }
+        my $string = substr($value, 0, $substr_size);
+        return $string;
+    }
+    return substr($value, $substr_size);
+}
+
+#####################
+# Main Test Methods #
+#####################
+
+sub run {
+    my ($self) = @_;
+    
+    my $invalid_combination = $self->invalid_field_operator_combination;
+    my $field_not_implemented = $self->field_not_yet_implemented;
+
+    SKIP: {    
+        skip($invalid_combination, $self->num_tests) if $invalid_combination;
+        TODO: {
+            todo_skip ($field_not_implemented, $self->num_tests) if $field_not_implemented;
+            $self->do_tests();
+        }
+    }
+}
+
+sub do_tests {
+    my ($self) = @_;
+    my $name = $self->name;
+
+    my $search_broken = $self->search_known_broken;
+    
+    my $search = $self->_test_search_object_creation();
+
+    my $sql;
+    TODO: {
+        local $TODO = $search_broken if $search_broken;
+        lives_ok { $sql = $search->_sql } "$name: generate SQL";
+    }
+    
+    my $results;
+    SKIP: {
+        skip "Can't run SQL without any SQL", 1 if !defined $sql;
+        $results = $self->_test_sql($search);
+    }
+
+    $self->_test_content($results, $sql);
+}
+
+sub _test_search_object_creation {
+    my ($self) = @_;
+    my $name = $self->name;
+    my @args = (fields => $self->search_columns, params => $self->search_params);
+    my $search;
+    lives_ok { $search = new Bugzilla::Search(@args) }
+             "$name: create search object";
+    return $search;
+}
+
+sub _test_sql {
+    my ($self, $search) = @_;
+    my $name = $self->name;
+    my $results;
+    lives_ok { $results = $search->data } "$name: Run SQL Query"
+        or diag($search->_sql);
+    return $results;
+}
+
+sub _test_content {
+    my ($self, $results, $sql) = @_;
+
+    SKIP: {
+        skip "Without results we can't test them", NUM_BUGS if !$results;
+        foreach my $number (1..NUM_BUGS) {
+            $self->_test_content_for_bug($number, $results, $sql);
+        }
+    }
+}
+
+sub _test_content_for_bug {
+    my ($self, $number, $results, $sql) = @_;
+    my $name = $self->name;
+    
+    my $contains_known_broken = $self->contains_known_broken($number);
+    
+    my %result_ids = map { $_->[0] => 1 } @$results;
+    my $bug_id = $self->bug($number)->id;
+    
+    TODO: {
+        local $TODO = $contains_known_broken if $contains_known_broken;
+        if ($self->bug_is_contained($number)) {
+            ok($result_ids{$bug_id},
+               "$name: contains bug $number ($bug_id)")
+                or diag $self->debug_fail($number, $results, $sql);
+        }
+        else {
+            ok(!$result_ids{$bug_id},
+               "$name: does not contain bug $number ($bug_id)")
+                or diag $self->debug_fail($number, $results, $sql);
+        }
+    }
+}
+
+1;

diff --git a/xt/lib/Bugzilla/Test/Search/FieldTestNormal.pm b/xt/lib/Bugzilla/Test/Search/FieldTestNormal.pm
new file mode 100644 (file)
index 0000000..4147c24
--- /dev/null
+++ b/xt/lib/Bugzilla/Test/Search/FieldTestNormal.pm
@@ -0,0 +1,104 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# This is the same as a FieldTest, except that it uses normal URL
+# parameters instead of Boolean Charts.
+package Bugzilla::Test::Search::FieldTestNormal;
+use strict;
+use warnings;
+use base qw(Bugzilla::Test::Search::FieldTest);
+
+use Scalar::Util qw(blessed);
+
+use constant CH_OPERATOR => {
+    changedafter  => 'chfieldfrom',
+    changedbefore => 'chfieldto',
+    changedto     => 'chfieldvalue',
+};
+
+use constant EMAIL_FIELDS => qw(assigned_to qa_contact cc reporter commenter);
+
+# Normally, we just clone a FieldTest because that's the best for performance,
+# overall--that way we don't have to translate the value again. However,
+# sometimes (like in Bugzilla::Test::Search's direct code) we just want
+# to create a FieldTestNormal.
+sub new {
+    my $class = shift;
+    my ($first_arg) = @_;
+    if (blessed $first_arg
+        and $first_arg->isa('Bugzilla::Test::Search::FieldTest'))
+    {
+        my $self = { %$first_arg };
+        return bless $self, $class;
+    }
+    return $class->SUPER::new(@_);
+}
+
+sub name {
+    my $self = shift;
+    my $name = $self->SUPER::name(@_);
+    return "$name (Normal Params)";
+}
+
+sub search_columns {
+    my $self = shift;
+    my $field = $self->field;
+    # For the assigned_to, qa_contact, and reporter fields, have the
+    # "Normal Params" test check that the _realname columns work
+    # all by themselves.
+    if (grep($_ eq $field, EMAIL_FIELDS) && $self->field_object->buglist) {
+        return ['bug_id', "${field}_realname"]
+    }
+    return $self->SUPER::search_columns(@_);
+}
+
+sub search_params {
+    my ($self) = @_;
+    my $field = $self->field;
+    my $operator = $self->operator;
+    my $value = $self->translated_value;
+    if ($operator eq 'anyexact') {
+        $value = [split ',', $value];
+    }
+    
+    if (my $ch_param = CH_OPERATOR->{$operator}) {
+        if ($field eq 'creation_ts') {
+            $field = '[Bug creation]';
+        }
+        return { chfield => $field, $ch_param => $value };
+    }
+    
+    if ($field eq 'delta_ts' and $operator eq 'greaterthaneq') {
+        return { chfieldfrom => $value };
+    }
+    if ($field eq 'delta_ts' and $operator eq 'lessthaneq') {
+        return { chfieldto => $value };
+    }
+    
+    if ($field eq 'deadline' and $operator eq 'greaterthaneq') {
+        return { deadlinefrom => $value };
+    }
+    if ($field eq 'deadline' and $operator eq 'lessthaneq') {
+        return { deadlineto => $value };
+    }
+    
+    if (grep { $_ eq $field } EMAIL_FIELDS) {
+        $field = 'longdesc' if $field eq 'commenter';
+        return {
+            email1           => $value,
+            "email${field}1" => 1,
+            emailtype1       => $operator,
+            # Used to do extra tests on special sorts of email* combinations.
+            %{ $self->test->{extra_params} || {} },
+        };
+    }
+
+    $field =~ s/\./_/g;
+    return { $field => $value, "${field}_type" => $operator };
+}
+
+1;

diff --git a/xt/lib/Bugzilla/Test/Search/InjectionTest.pm b/xt/lib/Bugzilla/Test/Search/InjectionTest.pm
new file mode 100644 (file)
index 0000000..86dff3e
--- /dev/null
+++ b/xt/lib/Bugzilla/Test/Search/InjectionTest.pm
@@ -0,0 +1,77 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# This module represents the SQL Injection tests that get run on a single
+# operator/field combination for Bugzilla::Test::Search.
+package Bugzilla::Test::Search::InjectionTest;
+use base qw(Bugzilla::Test::Search::FieldTest);
+
+use strict;
+use warnings;
+use Bugzilla::Test::Search::Constants;
+use Test::Exception;
+
+sub num_tests { return NUM_SEARCH_TESTS }
+
+sub _known_broken {
+    my ($self) = @_;
+    my $operator_broken = INJECTION_BROKEN_OPERATOR->{$self->operator};
+    # We don't want to auto-vivify $operator_broken and thus make it true.
+    my @field_ok = $operator_broken ? @{ $operator_broken->{field_ok} || [] }
+                                    : ();
+    $operator_broken = undef if grep { $_ eq $self->field } @field_ok;
+
+    my $field_broken = INJECTION_BROKEN_FIELD->{$self->field}
+                       || INJECTION_BROKEN_FIELD->{$self->field_object->type};
+    # We don't want to auto-vivify $field_broken and thus make it true.
+    my @operator_ok = $field_broken ? @{ $field_broken->{operator_ok} || [] }
+                                    : ();
+    $field_broken = undef if grep { $_ eq $self->operator } @operator_ok;
+
+    return $operator_broken || $field_broken || {};
+}
+
+sub sql_error_ok { return $_[0]->_known_broken->{sql_error} }
+
+# Injection tests only skip fields on certain dbs.
+sub field_not_yet_implemented {
+    my ($self) = @_;
+    # We use the constant directly because we don't want operator_ok
+    # or field_ok to stop us.
+    my $broken = INJECTION_BROKEN_FIELD->{$self->field}
+                 || INJECTION_BROKEN_FIELD->{$self->field_object->type};
+    my $skip_for_dbs = $broken->{db_skip};
+    return undef if !$skip_for_dbs;
+    my $dbh = Bugzilla->dbh;
+    if (my ($skip) = grep { $dbh->isa("Bugzilla::DB::$_") } @$skip_for_dbs) {
+        my $field = $self->field;
+        return "$field injection testing is not supported with $skip";
+    }
+    return undef;
+}
+# Injection tests don't do translation.
+sub translated_value { $_[0]->test_value }
+
+sub name { return "injection-" . $_[0]->SUPER::name; }
+
+# Injection tests don't check content.
+sub _test_content {}
+
+sub _test_sql {
+    my $self = shift;
+    my ($sql) = @_;
+    my $dbh = Bugzilla->dbh;
+    my $name = $self->name;
+    if (my $error_ok = $self->sql_error_ok) {
+        throws_ok { $dbh->selectall_arrayref($sql) } $error_ok,
+                  "$name: SQL query dies, as we expect";
+        return;
+    }
+    return $self->SUPER::_test_sql(@_);
+}
+
+1;

diff --git a/xt/lib/Bugzilla/Test/Search/NotTest.pm b/xt/lib/Bugzilla/Test/Search/NotTest.pm
new file mode 100644 (file)
index 0000000..def4f9a
--- /dev/null
+++ b/xt/lib/Bugzilla/Test/Search/NotTest.pm
@@ -0,0 +1,61 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# This module runs tests just like a normal FieldTest, AndTest,
+# or OrTest, but in a NOT chart instead of a normal chart.
+#
+# Logically this should be a mixin of some sort so that we can apply
+# it to OrTest and AndTest, but without Moose there isn't much of an
+# easy way to do that.
+package Bugzilla::Test::Search::NotTest;
+use base qw(Bugzilla::Test::Search::FieldTest);
+use strict;
+use warnings;
+use Bugzilla::Test::Search::Constants;
+
+# We just clone a FieldTest because that's the best for performance,
+# overall--that way we don't have to translate the value again.
+sub new {
+    my ($class, $field_test) = @_;
+    my $self = { %$field_test };
+    return bless $self, $class;
+}
+
+#############
+# Accessors #
+#############
+
+sub name {
+    my ($self) = @_;
+    return "NOT(" . $self->SUPER::name . ")";
+}
+
+# True if this test is supposed to contain the numbered bug. Reversed for
+# NOT tests.
+sub bug_is_contained {
+    my $self = shift;
+    my ($number) = @_;
+    # No search ever returns bug 6, because it's protected by security groups
+    # that the searcher isn't a member of.
+    return 0 if $number == 6;
+    return $self->SUPER::bug_is_contained(@_) ? 0 : 1;
+}
+
+# NOT tests have their own constant for tracking broken-ness.
+sub _known_broken {
+    my ($self) = @_;
+    return $self->SUPER::_known_broken(BROKEN_NOT, 'skip pg check');
+}
+
+sub search_params {
+    my ($self) = @_;
+    my %params = %{ $self->SUPER::search_params() };
+    $params{negate0} = 1;
+    return \%params;
+}
+
+1;

diff --git a/xt/lib/Bugzilla/Test/Search/OperatorTest.pm b/xt/lib/Bugzilla/Test/Search/OperatorTest.pm
new file mode 100644 (file)
index 0000000..5ab502d
--- /dev/null
+++ b/xt/lib/Bugzilla/Test/Search/OperatorTest.pm
@@ -0,0 +1,103 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# This module represents the tests that get run on a single operator
+# from the TESTS constant in Bugzilla::Search::Test::Constants.
+package Bugzilla::Test::Search::OperatorTest;
+
+use strict;
+use warnings;
+use Bugzilla::Test::Search::Constants;
+use Bugzilla::Test::Search::FieldTest;
+use Bugzilla::Test::Search::FieldTestNormal;
+use Bugzilla::Test::Search::InjectionTest;
+use Bugzilla::Test::Search::OrTest;
+use Bugzilla::Test::Search::AndTest;
+use Bugzilla::Test::Search::NotTest;
+
+###############
+# Constructor #
+###############
+
+sub new {
+    my ($invocant, $operator, $search_test) = @_;
+    $search_test ||= $invocant->search_test;
+    my $class = ref($invocant) || $invocant;
+    return bless { search_test => $search_test, operator => $operator }, $class;
+}
+
+#############
+# Accessors #
+#############
+
+# The Bugzilla::Test::Search object that this is a child of.
+sub search_test { return $_[0]->{search_test} }
+# The operator being tested
+sub operator { return $_[0]->{operator} }
+# The tests that we're going to run on this operator.
+sub tests { return @{ TESTS->{$_[0]->operator } } }
+# The fields we're going to test for this operator.
+sub test_fields { return $_[0]->search_test->all_fields }
+
+sub run {
+    my ($self) = @_;
+
+    foreach my $field ($self->test_fields) {
+        foreach my $test ($self->tests) {
+            my $field_test =
+                new Bugzilla::Test::Search::FieldTest($self, $field, $test);
+            $field_test->run();
+            my $normal_test =
+                new Bugzilla::Test::Search::FieldTestNormal($field_test);
+            $normal_test->run();
+            my $not_test = new Bugzilla::Test::Search::NotTest($field_test);
+            $not_test->run();
+            
+            next if !$self->search_test->option('long');
+
+            # Run the OR tests. This tests every other operator (including
+            # this operator itself) in combination with every other field,
+            # in an OR with this operator and field.
+            foreach my $other_operator ($self->search_test->all_operators) {
+                $self->run_join_tests($field_test, $other_operator);
+            }
+        }
+        foreach my $test (INJECTION_TESTS) {
+            my $injection_test =
+                new Bugzilla::Test::Search::InjectionTest($self, $field, $test);
+            $injection_test->run();
+        }
+    }
+}
+
+sub run_join_tests {
+    my ($self, $field_test, $other_operator) = @_;
+
+    my $other_operator_test = $self->new($other_operator);
+    foreach my $other_test ($other_operator_test->tests) {
+        foreach my $other_field ($self->test_fields) {
+            $self->_run_one_join_test($field_test, $other_operator_test,
+                                      $other_field, $other_test);
+            $self->search_test->clean_test_history();
+        }
+    }
+}
+
+sub _run_one_join_test {
+    my ($self, $field_test, $other_operator_test, $other_field, $other_test) = @_;
+    my $other_field_test =
+        new Bugzilla::Test::Search::FieldTest($other_operator_test,
+                                              $other_field, $other_test);
+    my $or_test = new Bugzilla::Test::Search::OrTest($field_test,
+                                                     $other_field_test);
+    $or_test->run();
+    my $and_test = new Bugzilla::Test::Search::AndTest($field_test,
+                                                       $other_field_test);
+    $and_test->run();
+}
+
+1;

diff --git a/xt/lib/Bugzilla/Test/Search/OrTest.pm b/xt/lib/Bugzilla/Test/Search/OrTest.pm
new file mode 100644 (file)
index 0000000..d460e44
--- /dev/null
+++ b/xt/lib/Bugzilla/Test/Search/OrTest.pm
@@ -0,0 +1,141 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# This test combines two field/operator combinations using OR in
+# a single boolean chart.
+package Bugzilla::Test::Search::OrTest;
+use base qw(Bugzilla::Test::Search::FieldTest);
+
+use Bugzilla::Test::Search::Constants;
+use List::MoreUtils qw(all any uniq);
+
+use constant type => 'OR';
+
+###############
+# Constructor #
+###############
+
+sub new {
+    my $class = shift;
+    my $self = { field_tests => [@_] };
+    return bless $self, $class;
+}
+
+#############
+# Accessors #
+#############
+
+sub field_tests { return @{ $_[0]->{field_tests} } }
+sub search_test { ($_[0]->field_tests)[0]->search_test }
+
+sub name {
+    my ($self) = @_;
+    my @names = map { $_->name } $self->field_tests;
+    return join('-' . $self->type . '-', @names);
+}
+
+# In an OR test, bugs ARE supposed to be contained if they are contained
+# by ANY test.
+sub bug_is_contained {
+    my ($self, $number) = @_;
+    return any { $_->bug_is_contained($number) } $self->field_tests;
+}
+
+# Needed only for failure messages
+sub debug_value {
+    my ($self) = @_;
+    my @values = map { $_->field . ' ' . $_->debug_value } $self->field_tests;
+    return join(' ' . $self->type . ' ', @values);
+}
+
+########################
+# SKIP & TODO Messages #
+########################
+
+sub field_not_yet_implemented {
+    my ($self) = @_;
+    return $self->_join_messages('field_not_yet_implemented');
+}
+sub invalid_field_operator_combination {
+    my ($self) = @_;
+    return $self->_join_messages('invalid_field_operator_combination');
+}
+sub search_known_broken {
+    my ($self) = @_;
+    return $self->_join_messages('search_known_broken');    
+}
+
+sub _join_messages {
+    my ($self, $message_method) = @_;
+    my @messages = map { $_->$message_method } $self->field_tests;
+    @messages = grep { $_ } @messages;
+    return join(' AND ', @messages);
+}
+
+sub _bug_will_actually_be_contained {
+    my ($self, $number) = @_;
+
+    foreach my $test ($self->field_tests) {
+        # Some tests are broken in such a way that they actually
+        # generate no criteria in the SQL. In this case, the only way
+        # the test contains the bug is if *another* test contains it.
+        next if $test->_known_broken->{no_criteria};
+        return 1 if $test->will_actually_contain_bug($number);
+    }
+    return 0;
+}
+
+sub contains_known_broken {
+    my ($self, $number) = @_;
+
+    if ( ( $self->bug_is_contained($number)
+           and !$self->_bug_will_actually_be_contained($number) )
+        or ( !$self->bug_is_contained($number)
+             and $self->_bug_will_actually_be_contained($number) ) )
+    {
+        my @messages = map { $_->contains_known_broken($number) } 
+                           $self->field_tests;
+        @messages = grep { $_ } @messages;
+        # Sometimes, with things that break because of no_criteria, there won't
+        # be anything in @messages even though we need to print out a message.
+        if (!@messages) {
+            my @no_criteria = grep { $_->_known_broken->{no_criteria} }
+                                   $self->field_tests;
+            @messages = map { "No criteria generated by " . $_->name }
+                            @no_criteria;
+        }
+        die "broken test with no message" if !@messages;
+        return join(' AND ', @messages);
+    }
+    return undef;
+}
+
+##############################
+# Bugzilla::Search arguments #
+##############################
+
+sub search_columns {
+    my ($self) = @_;
+    my @columns = map { @{ $_->search_columns } } $self->field_tests;
+    return [uniq @columns];
+}
+
+sub search_params {
+    my ($self) = @_;
+    my @all_params = map { $_->search_params } $self->field_tests;
+    my %params;
+    my $chart = 0;
+    foreach my $item (@all_params) {
+        $params{"field0-0-$chart"} = $item->{'field0-0-0'};
+        $params{"type0-0-$chart"}  = $item->{'type0-0-0'};
+        $params{"value0-0-$chart"} = $item->{'value0-0-0'};
+        $chart++;
+    }
+    return \%params;
+}
+
+1;

diff --git a/xt/search.t b/xt/search.t
new file mode 100644 (file)
index 0000000..81f2f33
--- /dev/null
+++ b/xt/search.t
@@ -0,0 +1,82 @@
+#!/usr/bin/perl -w
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This Source Code Form is "Incompatible With Secondary Licenses", as
+# defined by the Mozilla Public License, v. 2.0.
+
+# For a description of this test, see Bugzilla::Test::Search
+# in xt/lib/.
+
+use strict;
+use warnings;
+use lib qw(. xt/lib lib);
+use Bugzilla;
+use Bugzilla::Constants;
+use Bugzilla::Test::Search;
+use Getopt::Long;
+use Pod::Usage;
+
+use Test::More;
+
+my %switches;
+GetOptions(\%switches, 'operators=s', 'top-operators=s', 'long',
+                       'add-custom-fields', 'help|h') || die $@;
+
+pod2usage(verbose => 1) if $switches{'help'};
+
+plan skip_all => "BZ_WRITE_TESTS environment variable not set"
+  if !$ENV{BZ_WRITE_TESTS};
+
+Bugzilla->usage_mode(USAGE_MODE_TEST);
+
+my $test = new Bugzilla::Test::Search(\%switches);
+plan tests => $test->num_tests;
+$test->run();
+
+__END__
+
+=head1 NAME
+
+search.t - Test L<Bugzilla::Search>
+
+=head1 DESCRIPTION
+
+This test tests L<Bugzilla::Search>.
+
+Note that users may be prevented from writing new bugs, products, components,
+etc. to your database while this test is running.
+
+=head1 OPTIONS
+
+=over
+
+=item --long
+
+Run AND and OR tests in addition to normal tests. Specifying
+--long without also specifying L</--top-operators> is likely to
+run your system out of memory.
+
+=item --add-custom-fields
+
+This adds every type of custom field to the database, so that they can
+all be tested. Note that this B<CANNOT BE REVERSED>, so do not use this
+switch on a production installation.
+
+=item --operators=a,b,c
+
+Limit the test to testing only the listed operators.
+
+=item --top-operators=a,b,c
+
+Limit the top-level tested operators to the following list. This
+means that for normal tests, only the listed operators will be tested.
+However, for OR and AND tests, all other operators will be tested
+along with the operators you listed.
+
+=item --help
+
+Display this help.
+
+=back